1 /*
2  * Copyright (C) 2011 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 #ifndef ART_RUNTIME_MIRROR_THROWABLE_H_
18 #define ART_RUNTIME_MIRROR_THROWABLE_H_
19 
20 #include "gc_root.h"
21 #include "object.h"
22 #include "object_callbacks.h"
23 #include "string.h"
24 
25 namespace art {
26 
27 struct ThrowableOffsets;
28 
29 namespace mirror {
30 
31 // C++ mirror of java.lang.Throwable
32 class MANAGED Throwable : public Object {
33  public:
34   void SetDetailMessage(String* new_detail_message) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
35 
GetDetailMessage()36   String* GetDetailMessage() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) {
37     return GetFieldObject<String>(OFFSET_OF_OBJECT_MEMBER(Throwable, detail_message_));
38   }
39 
40   std::string Dump() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
41 
42   // This is a runtime version of initCause, you shouldn't use it if initCause may have been
43   // overridden. Also it asserts rather than throwing exceptions. Currently this is only used
44   // in cases like the verifier where the checks cannot fail and initCause isn't overridden.
45   void SetCause(Throwable* cause) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
46   void SetStackState(Object* state) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
47   bool IsCheckedException() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
48 
GetJavaLangThrowable()49   static Class* GetJavaLangThrowable() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) {
50     DCHECK(!java_lang_Throwable_.IsNull());
51     return java_lang_Throwable_.Read();
52   }
53 
54   static void SetClass(Class* java_lang_Throwable);
55   static void ResetClass();
56   static void VisitRoots(RootCallback* callback, void* arg)
57       SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
58 
59  private:
GetStackState()60   Object* GetStackState() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) {
61     return GetFieldObjectVolatile<Object>(OFFSET_OF_OBJECT_MEMBER(Throwable, stack_state_));
62   }
GetStackTrace()63   Object* GetStackTrace() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) {
64     return GetFieldObjectVolatile<Object>(OFFSET_OF_OBJECT_MEMBER(Throwable, stack_trace_));
65   }
66 
67   // Field order required by test "ValidateFieldOrderOfJavaCppUnionClasses".
68   HeapReference<Throwable> cause_;
69   HeapReference<String> detail_message_;
70   HeapReference<Object> stack_state_;  // Note this is Java volatile:
71   HeapReference<Object> stack_trace_;
72   HeapReference<Object> suppressed_exceptions_;
73 
74   static GcRoot<Class> java_lang_Throwable_;
75 
76   friend struct art::ThrowableOffsets;  // for verifying offset information
77   DISALLOW_IMPLICIT_CONSTRUCTORS(Throwable);
78 };
79 
80 }  // namespace mirror
81 }  // namespace art
82 
83 #endif  // ART_RUNTIME_MIRROR_THROWABLE_H_
84