blob: b68aef9c7f974dec17210a1a110f04e9d98afbc3 [file] [log] [blame]
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001/*
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
Brian Carlstromfc0e3212013-07-17 14:40:12 -070017#ifndef ART_RUNTIME_MIRROR_OBJECT_H_
18#define ART_RUNTIME_MIRROR_OBJECT_H_
Ian Rogers2dd0e2c2013-01-24 12:42:14 -080019
Ian Rogersef7d42f2014-01-06 12:55:46 -080020#include "object_reference.h"
Ian Rogers2dd0e2c2013-01-24 12:42:14 -080021#include "offsets.h"
Mathieu Chartier4e305412014-02-19 10:54:44 -080022#include "verify_object.h"
Ian Rogers2dd0e2c2013-01-24 12:42:14 -080023
24namespace art {
25
26class ImageWriter;
Ian Rogersd9c4fc92013-10-01 19:45:43 -070027class LockWord;
Ian Rogersb0fa5dc2014-04-28 16:47:08 -070028class Monitor;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -080029struct ObjectOffsets;
30class Thread;
Ian Rogersb0fa5dc2014-04-28 16:47:08 -070031class VoidFunctor;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -080032
33namespace mirror {
34
Brian Carlstromea46f952013-07-30 01:26:50 -070035class ArtField;
36class ArtMethod;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -080037class Array;
38class Class;
Mathieu Chartier8fa2dad2014-03-13 12:22:56 -070039class FinalizerReference;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -080040template<class T> class ObjectArray;
41template<class T> class PrimitiveArray;
42typedef PrimitiveArray<uint8_t> BooleanArray;
43typedef PrimitiveArray<int8_t> ByteArray;
44typedef PrimitiveArray<uint16_t> CharArray;
45typedef PrimitiveArray<double> DoubleArray;
46typedef PrimitiveArray<float> FloatArray;
47typedef PrimitiveArray<int32_t> IntArray;
48typedef PrimitiveArray<int64_t> LongArray;
49typedef PrimitiveArray<int16_t> ShortArray;
Mathieu Chartier8fa2dad2014-03-13 12:22:56 -070050class Reference;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -080051class String;
52class Throwable;
53
Ian Rogers2dd0e2c2013-01-24 12:42:14 -080054// Fields within mirror objects aren't accessed directly so that the appropriate amount of
55// handshaking is done with GC (for example, read and write barriers). This macro is used to
56// compute an offset for the Set/Get methods defined in Object that can safely access fields.
57#define OFFSET_OF_OBJECT_MEMBER(type, field) \
58 MemberOffset(OFFSETOF_MEMBER(type, field))
59
Mathieu Chartier4e305412014-02-19 10:54:44 -080060// Checks that we don't do field assignments which violate the typing system.
61static constexpr bool kCheckFieldAssignments = false;
Ian Rogers04d7aa92013-03-16 14:29:17 -070062
Ian Rogers2dd0e2c2013-01-24 12:42:14 -080063// C++ mirror of java.lang.Object
Ian Rogers719d1a32014-03-06 12:13:39 -080064class MANAGED LOCKABLE Object {
Ian Rogers2dd0e2c2013-01-24 12:42:14 -080065 public:
Mingyao Yang98d1cc82014-05-15 17:02:16 -070066 // The number of vtable entries in java.lang.Object.
67 static constexpr size_t kVTableLength = 11;
68
69 // The size of the java.lang.Class representing a java.lang.Object.
70 static uint32_t ClassSize();
71
72 // Size of an instance of java.lang.Object.
73 static constexpr uint32_t InstanceSize() {
74 return sizeof(Object);
75 }
76
Ian Rogers2dd0e2c2013-01-24 12:42:14 -080077 static MemberOffset ClassOffset() {
78 return OFFSET_OF_OBJECT_MEMBER(Object, klass_);
79 }
80
Hiroshi Yamauchi6e83c172014-05-01 21:25:41 -070081 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags,
82 ReadBarrierOption kReadBarrierOption = kWithReadBarrier>
Mingyao Yang98d1cc82014-05-15 17:02:16 -070083 ALWAYS_INLINE Class* GetClass() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -080084
Mathieu Chartier4e305412014-02-19 10:54:44 -080085 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Ian Rogersef7d42f2014-01-06 12:55:46 -080086 void SetClass(Class* new_klass) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -080087
Hiroshi Yamauchi624468c2014-03-31 15:14:47 -070088 Object* GetReadBarrierPointer() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Hiroshi Yamauchi9103c862014-04-22 13:51:07 -070089 void SetReadBarrierPointer(Object* rb_ptr) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
90 bool AtomicSetReadBarrierPointer(Object* expected_rb_ptr, Object* rb_ptr)
91 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Hiroshi Yamauchi624468c2014-03-31 15:14:47 -070092 void AssertReadBarrierPointer() const SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Hiroshi Yamauchi9d04a202014-01-31 13:35:49 -080093
Jeff Haoa3faaf42013-09-03 19:07:00 -070094 // The verifier treats all interfaces as java.lang.Object and relies on runtime checks in
95 // invoke-interface to detect incompatible interface types.
Mathieu Chartier4e305412014-02-19 10:54:44 -080096 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Ian Rogersef7d42f2014-01-06 12:55:46 -080097 bool VerifierInstanceOf(Class* klass) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Mathieu Chartier4e305412014-02-19 10:54:44 -080098 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Ian Rogersef7d42f2014-01-06 12:55:46 -080099 bool InstanceOf(Class* klass) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800100
Hiroshi Yamauchi6e83c172014-05-01 21:25:41 -0700101 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags,
102 ReadBarrierOption kReadBarrierOption = kWithReadBarrier>
Ian Rogersef7d42f2014-01-06 12:55:46 -0800103 size_t SizeOf() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800104
105 Object* Clone(Thread* self) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
106
Mathieu Chartierad2541a2013-10-25 10:05:23 -0700107 int32_t IdentityHashCode() const SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800108
109 static MemberOffset MonitorOffset() {
110 return OFFSET_OF_OBJECT_MEMBER(Object, monitor_);
111 }
112
Hans Boehmd8434432014-07-11 09:56:07 -0700113 // As_volatile can be false if the mutators are suspended. This is an optimization since it
Mathieu Chartier4d7f61d2014-04-17 14:43:39 -0700114 // avoids the barriers.
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700115 LockWord GetLockWord(bool as_volatile) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
116 void SetLockWord(LockWord new_val, bool as_volatile) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers228602f2014-07-10 02:07:54 -0700117 bool CasLockWordWeakSequentiallyConsistent(LockWord old_val, LockWord new_val)
118 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Hans Boehmd8434432014-07-11 09:56:07 -0700119 bool CasLockWordWeakRelaxed(LockWord old_val, LockWord new_val)
120 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogersd9c4fc92013-10-01 19:45:43 -0700121 uint32_t GetLockOwnerThreadId();
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800122
Mathieu Chartiere7e8a5f2014-02-14 16:59:41 -0800123 mirror::Object* MonitorEnter(Thread* self) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_)
Ian Rogers719d1a32014-03-06 12:13:39 -0800124 EXCLUSIVE_LOCK_FUNCTION();
Ian Rogers05f30572013-02-20 12:13:11 -0800125 bool MonitorExit(Thread* self) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_)
Ian Rogers719d1a32014-03-06 12:13:39 -0800126 UNLOCK_FUNCTION();
Ian Rogers05f30572013-02-20 12:13:11 -0800127 void Notify(Thread* self) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers05f30572013-02-20 12:13:11 -0800128 void NotifyAll(Thread* self) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers05f30572013-02-20 12:13:11 -0800129 void Wait(Thread* self) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers05f30572013-02-20 12:13:11 -0800130 void Wait(Thread* self, int64_t timeout, int32_t nanos) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800131
Hiroshi Yamauchi6e83c172014-05-01 21:25:41 -0700132 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags,
133 ReadBarrierOption kReadBarrierOption = kWithReadBarrier>
Ian Rogersef7d42f2014-01-06 12:55:46 -0800134 bool IsClass() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Hiroshi Yamauchi6e83c172014-05-01 21:25:41 -0700135 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags,
136 ReadBarrierOption kReadBarrierOption = kWithReadBarrier>
Ian Rogersef7d42f2014-01-06 12:55:46 -0800137 Class* AsClass() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800138
Mathieu Chartier4e305412014-02-19 10:54:44 -0800139 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Ian Rogersef7d42f2014-01-06 12:55:46 -0800140 bool IsObjectArray() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Mathieu Chartier4e305412014-02-19 10:54:44 -0800141 template<class T, VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Ian Rogersef7d42f2014-01-06 12:55:46 -0800142 ObjectArray<T>* AsObjectArray() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800143
Hiroshi Yamauchi6e83c172014-05-01 21:25:41 -0700144 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags,
145 ReadBarrierOption kReadBarrierOption = kWithReadBarrier>
Ian Rogersef7d42f2014-01-06 12:55:46 -0800146 bool IsArrayInstance() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Hiroshi Yamauchi6e83c172014-05-01 21:25:41 -0700147 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags,
148 ReadBarrierOption kReadBarrierOption = kWithReadBarrier>
Ian Rogersef7d42f2014-01-06 12:55:46 -0800149 Array* AsArray() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800150
Mathieu Chartier4e305412014-02-19 10:54:44 -0800151 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Ian Rogersef7d42f2014-01-06 12:55:46 -0800152 BooleanArray* AsBooleanArray() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Mathieu Chartier4e305412014-02-19 10:54:44 -0800153 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Ian Rogersef7d42f2014-01-06 12:55:46 -0800154 ByteArray* AsByteArray() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Mathieu Chartier4e305412014-02-19 10:54:44 -0800155 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Ian Rogersef7d42f2014-01-06 12:55:46 -0800156 ByteArray* AsByteSizedArray() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800157
Mathieu Chartier4e305412014-02-19 10:54:44 -0800158 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Ian Rogersef7d42f2014-01-06 12:55:46 -0800159 CharArray* AsCharArray() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Mathieu Chartier4e305412014-02-19 10:54:44 -0800160 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Ian Rogersef7d42f2014-01-06 12:55:46 -0800161 ShortArray* AsShortArray() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Mathieu Chartier4e305412014-02-19 10:54:44 -0800162 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Ian Rogersef7d42f2014-01-06 12:55:46 -0800163 ShortArray* AsShortSizedArray() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800164
Mathieu Chartier4e305412014-02-19 10:54:44 -0800165 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Ian Rogersef7d42f2014-01-06 12:55:46 -0800166 IntArray* AsIntArray() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Mathieu Chartier4e305412014-02-19 10:54:44 -0800167 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Ian Rogersef7d42f2014-01-06 12:55:46 -0800168 LongArray* AsLongArray() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800169
Mathieu Chartier4e305412014-02-19 10:54:44 -0800170 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Sebastien Hertzd2fe10a2014-01-15 10:20:56 +0100171 FloatArray* AsFloatArray() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Mathieu Chartier4e305412014-02-19 10:54:44 -0800172 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Sebastien Hertzd2fe10a2014-01-15 10:20:56 +0100173 DoubleArray* AsDoubleArray() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
174
Mathieu Chartier4e305412014-02-19 10:54:44 -0800175 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Ian Rogersef7d42f2014-01-06 12:55:46 -0800176 String* AsString() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800177
Mathieu Chartier4e305412014-02-19 10:54:44 -0800178 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800179 Throwable* AsThrowable() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
180
Hiroshi Yamauchi6e83c172014-05-01 21:25:41 -0700181 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags,
182 ReadBarrierOption kReadBarrierOption = kWithReadBarrier>
Ian Rogersef7d42f2014-01-06 12:55:46 -0800183 bool IsArtMethod() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Mathieu Chartier4e305412014-02-19 10:54:44 -0800184 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Ian Rogersef7d42f2014-01-06 12:55:46 -0800185 ArtMethod* AsArtMethod() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800186
Hiroshi Yamauchi6e83c172014-05-01 21:25:41 -0700187 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags,
188 ReadBarrierOption kReadBarrierOption = kWithReadBarrier>
Ian Rogersef7d42f2014-01-06 12:55:46 -0800189 bool IsArtField() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Mathieu Chartier4e305412014-02-19 10:54:44 -0800190 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Brian Carlstromea46f952013-07-30 01:26:50 -0700191 ArtField* AsArtField() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800192
Mathieu Chartier4e305412014-02-19 10:54:44 -0800193 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Ian Rogersef7d42f2014-01-06 12:55:46 -0800194 bool IsReferenceInstance() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Mathieu Chartier4e305412014-02-19 10:54:44 -0800195 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Mathieu Chartier8fa2dad2014-03-13 12:22:56 -0700196 Reference* AsReference() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
197 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Ian Rogersef7d42f2014-01-06 12:55:46 -0800198 bool IsWeakReferenceInstance() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Mathieu Chartier4e305412014-02-19 10:54:44 -0800199 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Ian Rogersef7d42f2014-01-06 12:55:46 -0800200 bool IsSoftReferenceInstance() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Mathieu Chartier4e305412014-02-19 10:54:44 -0800201 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Ian Rogersef7d42f2014-01-06 12:55:46 -0800202 bool IsFinalizerReferenceInstance() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Mathieu Chartier4e305412014-02-19 10:54:44 -0800203 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Mathieu Chartier8fa2dad2014-03-13 12:22:56 -0700204 FinalizerReference* AsFinalizerReference() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
205 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Ian Rogersef7d42f2014-01-06 12:55:46 -0800206 bool IsPhantomReferenceInstance() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800207
Ian Rogersef7d42f2014-01-06 12:55:46 -0800208 // Accessor for Java type fields.
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700209 template<class T, VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags,
Hiroshi Yamauchi6e83c172014-05-01 21:25:41 -0700210 ReadBarrierOption kReadBarrierOption = kWithReadBarrier, bool kIsVolatile = false>
Mingyao Yang98d1cc82014-05-15 17:02:16 -0700211 ALWAYS_INLINE T* GetFieldObject(MemberOffset field_offset)
Ian Rogersef7d42f2014-01-06 12:55:46 -0800212 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700213
214 template<class T, VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags,
Hiroshi Yamauchi6e83c172014-05-01 21:25:41 -0700215 ReadBarrierOption kReadBarrierOption = kWithReadBarrier>
Mingyao Yang98d1cc82014-05-15 17:02:16 -0700216 ALWAYS_INLINE T* GetFieldObjectVolatile(MemberOffset field_offset)
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700217 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
218
219 template<bool kTransactionActive, bool kCheckTransaction = true,
220 VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags, bool kIsVolatile = false>
Mingyao Yang98d1cc82014-05-15 17:02:16 -0700221 ALWAYS_INLINE void SetFieldObjectWithoutWriteBarrier(MemberOffset field_offset, Object* new_value)
222 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700223
224 template<bool kTransactionActive, bool kCheckTransaction = true,
225 VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags, bool kIsVolatile = false>
Mingyao Yang98d1cc82014-05-15 17:02:16 -0700226 ALWAYS_INLINE void SetFieldObject(MemberOffset field_offset, Object* new_value)
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700227 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
228
Mathieu Chartier4e305412014-02-19 10:54:44 -0800229 template<bool kTransactionActive, bool kCheckTransaction = true,
230 VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Mingyao Yang98d1cc82014-05-15 17:02:16 -0700231 ALWAYS_INLINE void SetFieldObjectVolatile(MemberOffset field_offset, Object* new_value)
Ian Rogersef7d42f2014-01-06 12:55:46 -0800232 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700233
Mathieu Chartier4e305412014-02-19 10:54:44 -0800234 template<bool kTransactionActive, bool kCheckTransaction = true,
235 VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Ian Rogers228602f2014-07-10 02:07:54 -0700236 bool CasFieldWeakSequentiallyConsistentObject(MemberOffset field_offset, Object* old_value,
237 Object* new_value)
Ian Rogersef7d42f2014-01-06 12:55:46 -0800238 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800239
Hans Boehmd8434432014-07-11 09:56:07 -0700240 template<bool kTransactionActive, bool kCheckTransaction = true,
241 VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
242 bool CasFieldStrongSequentiallyConsistentObject(MemberOffset field_offset, Object* old_value,
243 Object* new_value)
244 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
245
Mathieu Chartier4e305412014-02-19 10:54:44 -0800246 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
247 HeapReference<Object>* GetFieldObjectReferenceAddr(MemberOffset field_offset);
Mathieu Chartier11409ae2013-09-23 11:49:36 -0700248
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700249 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags, bool kIsVolatile = false>
Fred Shih37f05ef2014-07-16 18:38:08 -0700250 ALWAYS_INLINE uint8_t GetFieldBoolean(MemberOffset field_offset)
251 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
252
253 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags, bool kIsVolatile = false>
254 ALWAYS_INLINE int8_t GetFieldByte(MemberOffset field_offset)
255 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
256
257 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
258 ALWAYS_INLINE uint8_t GetFieldBooleanVolatile(MemberOffset field_offset)
259 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
260
261 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
262 ALWAYS_INLINE int8_t GetFieldByteVolatile(MemberOffset field_offset)
263 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
264
265 template<bool kTransactionActive, bool kCheckTransaction = true,
266 VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags, bool kIsVolatile = false>
267 ALWAYS_INLINE void SetFieldBoolean(MemberOffset field_offset, uint8_t new_value)
268 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
269
270 template<bool kTransactionActive, bool kCheckTransaction = true,
271 VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags, bool kIsVolatile = false>
272 ALWAYS_INLINE void SetFieldByte(MemberOffset field_offset, int8_t new_value)
273 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
274
275 template<bool kTransactionActive, bool kCheckTransaction = true,
276 VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
277 ALWAYS_INLINE void SetFieldBooleanVolatile(MemberOffset field_offset, uint8_t new_value)
278 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
279
280 template<bool kTransactionActive, bool kCheckTransaction = true,
281 VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
282 ALWAYS_INLINE void SetFieldByteVolatile(MemberOffset field_offset, int8_t new_value)
283 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
284
285 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags, bool kIsVolatile = false>
286 ALWAYS_INLINE uint16_t GetFieldChar(MemberOffset field_offset)
287 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
288
289 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags, bool kIsVolatile = false>
290 ALWAYS_INLINE int16_t GetFieldShort(MemberOffset field_offset)
291 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
292
293 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
294 ALWAYS_INLINE uint16_t GetFieldCharVolatile(MemberOffset field_offset)
295 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
296
297 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
298 ALWAYS_INLINE int16_t GetFieldShortVolatile(MemberOffset field_offset)
299 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
300
301 template<bool kTransactionActive, bool kCheckTransaction = true,
302 VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags, bool kIsVolatile = false>
303 ALWAYS_INLINE void SetFieldChar(MemberOffset field_offset, uint16_t new_value)
304 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
305
306 template<bool kTransactionActive, bool kCheckTransaction = true,
307 VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags, bool kIsVolatile = false>
308 ALWAYS_INLINE void SetFieldShort(MemberOffset field_offset, int16_t new_value)
309 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
310
311 template<bool kTransactionActive, bool kCheckTransaction = true,
312 VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
313 ALWAYS_INLINE void SetFieldCharVolatile(MemberOffset field_offset, uint16_t new_value)
314 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
315
316 template<bool kTransactionActive, bool kCheckTransaction = true,
317 VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
318 ALWAYS_INLINE void SetFieldShortVolatile(MemberOffset field_offset, int16_t new_value)
319 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
320
321 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags, bool kIsVolatile = false>
Mingyao Yang98d1cc82014-05-15 17:02:16 -0700322 ALWAYS_INLINE int32_t GetField32(MemberOffset field_offset)
Ian Rogersef7d42f2014-01-06 12:55:46 -0800323 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogersd9c4fc92013-10-01 19:45:43 -0700324
Mathieu Chartier4e305412014-02-19 10:54:44 -0800325 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Mingyao Yang98d1cc82014-05-15 17:02:16 -0700326 ALWAYS_INLINE int32_t GetField32Volatile(MemberOffset field_offset)
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700327 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
328
329 template<bool kTransactionActive, bool kCheckTransaction = true,
330 VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags, bool kIsVolatile = false>
Mingyao Yang98d1cc82014-05-15 17:02:16 -0700331 ALWAYS_INLINE void SetField32(MemberOffset field_offset, int32_t new_value)
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700332 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
333
Mathieu Chartier4e305412014-02-19 10:54:44 -0800334 template<bool kTransactionActive, bool kCheckTransaction = true,
335 VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Mingyao Yang98d1cc82014-05-15 17:02:16 -0700336 ALWAYS_INLINE void SetField32Volatile(MemberOffset field_offset, int32_t new_value)
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700337 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
338
339 template<bool kTransactionActive, bool kCheckTransaction = true,
340 VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Mingyao Yang98d1cc82014-05-15 17:02:16 -0700341 ALWAYS_INLINE bool CasFieldWeakSequentiallyConsistent32(MemberOffset field_offset,
342 int32_t old_value, int32_t new_value)
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700343 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
344
Hans Boehmd8434432014-07-11 09:56:07 -0700345 template<bool kTransactionActive, bool kCheckTransaction = true,
346 VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
347 bool CasFieldWeakRelaxed32(MemberOffset field_offset, int32_t old_value,
348 int32_t new_value) ALWAYS_INLINE
349 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
350
351 template<bool kTransactionActive, bool kCheckTransaction = true,
352 VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
353 bool CasFieldStrongSequentiallyConsistent32(MemberOffset field_offset, int32_t old_value,
354 int32_t new_value) ALWAYS_INLINE
355 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
356
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700357 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags, bool kIsVolatile = false>
Mingyao Yang98d1cc82014-05-15 17:02:16 -0700358 ALWAYS_INLINE int64_t GetField64(MemberOffset field_offset)
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700359 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
360
361 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Mingyao Yang98d1cc82014-05-15 17:02:16 -0700362 ALWAYS_INLINE int64_t GetField64Volatile(MemberOffset field_offset)
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700363 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
364
365 template<bool kTransactionActive, bool kCheckTransaction = true,
366 VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags, bool kIsVolatile = false>
Mingyao Yang98d1cc82014-05-15 17:02:16 -0700367 ALWAYS_INLINE void SetField64(MemberOffset field_offset, int64_t new_value)
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700368 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
369
370 template<bool kTransactionActive, bool kCheckTransaction = true,
371 VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Mingyao Yang98d1cc82014-05-15 17:02:16 -0700372 ALWAYS_INLINE void SetField64Volatile(MemberOffset field_offset, int64_t new_value)
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700373 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800374
Mathieu Chartier4e305412014-02-19 10:54:44 -0800375 template<bool kTransactionActive, bool kCheckTransaction = true,
376 VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Ian Rogers228602f2014-07-10 02:07:54 -0700377 bool CasFieldWeakSequentiallyConsistent64(MemberOffset field_offset, int64_t old_value,
378 int64_t new_value)
Ian Rogersef7d42f2014-01-06 12:55:46 -0800379 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800380
Mathieu Chartier4e305412014-02-19 10:54:44 -0800381 template<bool kTransactionActive, bool kCheckTransaction = true,
Hans Boehmd8434432014-07-11 09:56:07 -0700382 VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
383 bool CasFieldStrongSequentiallyConsistent64(MemberOffset field_offset, int64_t old_value,
384 int64_t new_value)
385 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
386
387 template<bool kTransactionActive, bool kCheckTransaction = true,
Mathieu Chartier4e305412014-02-19 10:54:44 -0800388 VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags, typename T>
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700389 void SetFieldPtr(MemberOffset field_offset, T new_value)
390 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) {
Ian Rogersef7d42f2014-01-06 12:55:46 -0800391#ifndef __LP64__
Mathieu Chartier4e305412014-02-19 10:54:44 -0800392 SetField32<kTransactionActive, kCheckTransaction, kVerifyFlags>(
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700393 field_offset, reinterpret_cast<int32_t>(new_value));
Ian Rogersef7d42f2014-01-06 12:55:46 -0800394#else
Mathieu Chartier4e305412014-02-19 10:54:44 -0800395 SetField64<kTransactionActive, kCheckTransaction, kVerifyFlags>(
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700396 field_offset, reinterpret_cast<int64_t>(new_value));
Ian Rogersef7d42f2014-01-06 12:55:46 -0800397#endif
Mathieu Chartierc528dba2013-11-26 12:00:11 -0800398 }
399
Mathieu Chartier407f7022014-02-18 14:37:05 -0800400 // TODO fix thread safety analysis broken by the use of template. This should be
401 // SHARED_LOCKS_REQUIRED(Locks::mutator_lock_).
402 template <const bool kVisitClass, VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags,
403 typename Visitor, typename JavaLangRefVisitor = VoidFunctor>
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700404 void VisitReferences(const Visitor& visitor, const JavaLangRefVisitor& ref_visitor)
Mathieu Chartier407f7022014-02-18 14:37:05 -0800405 NO_THREAD_SAFETY_ANALYSIS;
406
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800407 protected:
408 // Accessors for non-Java type fields
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700409 template<class T, VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags, bool kIsVolatile = false>
410 T GetFieldPtr(MemberOffset field_offset)
411 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) {
Ian Rogersef7d42f2014-01-06 12:55:46 -0800412#ifndef __LP64__
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700413 return reinterpret_cast<T>(GetField32<kVerifyFlags, kIsVolatile>(field_offset));
Ian Rogersef7d42f2014-01-06 12:55:46 -0800414#else
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700415 return reinterpret_cast<T>(GetField64<kVerifyFlags, kIsVolatile>(field_offset));
Ian Rogersef7d42f2014-01-06 12:55:46 -0800416#endif
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800417 }
418
Mathieu Chartier407f7022014-02-18 14:37:05 -0800419 // TODO: Fixme when anotatalysis works with visitors.
420 template<bool kVisitClass, bool kIsStatic, typename Visitor>
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700421 void VisitFieldsReferences(uint32_t ref_offsets, const Visitor& visitor) HOT_ATTR
Mathieu Chartier407f7022014-02-18 14:37:05 -0800422 NO_THREAD_SAFETY_ANALYSIS;
423 template<bool kVisitClass, typename Visitor>
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700424 void VisitInstanceFieldsReferences(mirror::Class* klass, const Visitor& visitor) HOT_ATTR
Mathieu Chartier407f7022014-02-18 14:37:05 -0800425 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
426 template<bool kVisitClass, typename Visitor>
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700427 void VisitStaticFieldsReferences(mirror::Class* klass, const Visitor& visitor) HOT_ATTR
Mathieu Chartier407f7022014-02-18 14:37:05 -0800428 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
429
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800430 private:
Fred Shih37f05ef2014-07-16 18:38:08 -0700431 template<typename kSize, bool kIsVolatile>
432 ALWAYS_INLINE void SetField(MemberOffset field_offset, kSize new_value)
433 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
434 template<typename kSize, bool kIsVolatile>
435 ALWAYS_INLINE kSize GetField(MemberOffset field_offset)
436 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
437
Ian Rogers04d7aa92013-03-16 14:29:17 -0700438 // Verify the type correctness of stores to fields.
Mathieu Chartier61c5ebc2014-06-05 17:42:53 -0700439 // TODO: This can cause thread suspension and isn't moving GC safe.
Ian Rogersef7d42f2014-01-06 12:55:46 -0800440 void CheckFieldAssignmentImpl(MemberOffset field_offset, Object* new_value)
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800441 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
Ian Rogersef7d42f2014-01-06 12:55:46 -0800442 void CheckFieldAssignment(MemberOffset field_offset, Object* new_value)
Ian Rogers04d7aa92013-03-16 14:29:17 -0700443 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) {
444 if (kCheckFieldAssignments) {
445 CheckFieldAssignmentImpl(field_offset, new_value);
446 }
447 }
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800448
Mathieu Chartierad2541a2013-10-25 10:05:23 -0700449 // Generate an identity hash code.
Mathieu Chartier4e6a31e2013-10-31 10:35:05 -0700450 static int32_t GenerateIdentityHashCode();
Mathieu Chartierad2541a2013-10-25 10:05:23 -0700451
Hiroshi Yamauchi0fbd6e62014-07-17 16:16:31 -0700452 // A utility function that copies an object in a read barrier and
453 // write barrier-aware way. This is internally used by Clone() and
454 // Class::CopyOf().
455 static Object* CopyObject(Thread* self, mirror::Object* dest, mirror::Object* src,
456 size_t num_bytes)
457 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
458
Ian Rogersef7d42f2014-01-06 12:55:46 -0800459 // The Class representing the type of the object.
460 HeapReference<Class> klass_;
461 // Monitor and hash code information.
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800462 uint32_t monitor_;
463
Hiroshi Yamauchi624468c2014-03-31 15:14:47 -0700464#ifdef USE_BAKER_OR_BROOKS_READ_BARRIER
465 // Note names use a 'x' prefix and the x_rb_ptr_ is of type int
Hiroshi Yamauchi9d04a202014-01-31 13:35:49 -0800466 // instead of Object to go with the alphabetical/by-type field order
467 // on the Java side.
Hiroshi Yamauchi624468c2014-03-31 15:14:47 -0700468 uint32_t x_rb_ptr_; // For the Baker or Brooks pointer.
469 uint32_t x_xpadding_; // For 8-byte alignment. TODO: get rid of this.
Hiroshi Yamauchi9d04a202014-01-31 13:35:49 -0800470#endif
471
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800472 friend class art::ImageWriter;
Mathieu Chartierad2541a2013-10-25 10:05:23 -0700473 friend class art::Monitor;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800474 friend struct art::ObjectOffsets; // for verifying offset information
Hiroshi Yamauchi0fbd6e62014-07-17 16:16:31 -0700475 friend class CopyObjectVisitor; // for CopyObject().
476 friend class CopyClassVisitor; // for CopyObject().
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800477 DISALLOW_IMPLICIT_CONSTRUCTORS(Object);
478};
479
480} // namespace mirror
481} // namespace art
482
Brian Carlstromfc0e3212013-07-17 14:40:12 -0700483#endif // ART_RUNTIME_MIRROR_OBJECT_H_