1 /* 2 * Copyright (C) 2016 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_EMULATED_STACK_FRAME_H_ 18 #define ART_RUNTIME_MIRROR_EMULATED_STACK_FRAME_H_ 19 20 #include "base/utils.h" 21 #include "dex/dex_instruction.h" 22 #include "method_type.h" 23 #include "object.h" 24 #include "stack.h" 25 #include "string.h" 26 27 namespace art { 28 29 struct EmulatedStackFrameOffsets; 30 31 namespace mirror { 32 33 // C++ mirror of dalvik.system.EmulatedStackFrame 34 class MANAGED EmulatedStackFrame : public Object { 35 public: 36 // Creates an emulated stack frame whose type is |frame_type| from 37 // a shadow frame. 38 static mirror::EmulatedStackFrame* CreateFromShadowFrameAndArgs( 39 Thread* self, 40 Handle<mirror::MethodType> args_type, 41 Handle<mirror::MethodType> frame_type, 42 const ShadowFrame& caller_frame, 43 const InstructionOperands* const operands) REQUIRES_SHARED(Locks::mutator_lock_); 44 45 // Writes the contents of this emulated stack frame to the |callee_frame| 46 // whose type is |callee_type|, starting at |first_dest_reg|. 47 bool WriteToShadowFrame( 48 Thread* self, 49 Handle<mirror::MethodType> callee_type, 50 const uint32_t first_dest_reg, 51 ShadowFrame* callee_frame) REQUIRES_SHARED(Locks::mutator_lock_); 52 53 // Sets |value| to the return value written to this emulated stack frame (if any). 54 void GetReturnValue(Thread* self, JValue* value) REQUIRES_SHARED(Locks::mutator_lock_); 55 56 // Sets the return value slot of this emulated stack frame to |value|. 57 void SetReturnValue(Thread* self, const JValue& value) REQUIRES_SHARED(Locks::mutator_lock_); 58 GetType()59 mirror::MethodType* GetType() REQUIRES_SHARED(Locks::mutator_lock_) { 60 return GetFieldObject<MethodType>(OFFSET_OF_OBJECT_MEMBER(EmulatedStackFrame, type_)); 61 } 62 GetReceiver()63 mirror::Object* GetReceiver() REQUIRES_SHARED(Locks::mutator_lock_) { 64 return GetReferences()->Get(0); 65 } 66 67 static void SetClass(Class* klass) REQUIRES_SHARED(Locks::mutator_lock_); 68 static void ResetClass() REQUIRES_SHARED(Locks::mutator_lock_); 69 static void VisitRoots(RootVisitor* visitor) REQUIRES_SHARED(Locks::mutator_lock_); 70 71 private: StaticClass()72 static mirror::Class* StaticClass() REQUIRES_SHARED(Locks::mutator_lock_) { 73 return static_class_.Read(); 74 } 75 GetReferences()76 mirror::ObjectArray<mirror::Object>* GetReferences() REQUIRES_SHARED(Locks::mutator_lock_) { 77 return GetFieldObject<mirror::ObjectArray<mirror::Object>>( 78 OFFSET_OF_OBJECT_MEMBER(EmulatedStackFrame, references_)); 79 } 80 GetStackFrame()81 mirror::ByteArray* GetStackFrame() REQUIRES_SHARED(Locks::mutator_lock_) { 82 return GetFieldObject<mirror::ByteArray>( 83 OFFSET_OF_OBJECT_MEMBER(EmulatedStackFrame, stack_frame_)); 84 } 85 CallsiteTypeOffset()86 static MemberOffset CallsiteTypeOffset() { 87 return MemberOffset(OFFSETOF_MEMBER(EmulatedStackFrame, callsite_type_)); 88 } 89 TypeOffset()90 static MemberOffset TypeOffset() { 91 return MemberOffset(OFFSETOF_MEMBER(EmulatedStackFrame, type_)); 92 } 93 ReferencesOffset()94 static MemberOffset ReferencesOffset() { 95 return MemberOffset(OFFSETOF_MEMBER(EmulatedStackFrame, references_)); 96 } 97 StackFrameOffset()98 static MemberOffset StackFrameOffset() { 99 return MemberOffset(OFFSETOF_MEMBER(EmulatedStackFrame, stack_frame_)); 100 } 101 102 HeapReference<mirror::MethodType> callsite_type_; 103 HeapReference<mirror::ObjectArray<mirror::Object>> references_; 104 HeapReference<mirror::ByteArray> stack_frame_; 105 HeapReference<mirror::MethodType> type_; 106 107 static GcRoot<mirror::Class> static_class_; // dalvik.system.EmulatedStackFrame.class 108 109 friend struct art::EmulatedStackFrameOffsets; // for verifying offset information 110 DISALLOW_IMPLICIT_CONSTRUCTORS(EmulatedStackFrame); 111 }; 112 113 } // namespace mirror 114 } // namespace art 115 116 #endif // ART_RUNTIME_MIRROR_EMULATED_STACK_FRAME_H_ 117