blob: d35d526dab35caa558b8d2f7ea05efa869542444 [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_CLASS_H_
18#define ART_RUNTIME_MIRROR_CLASS_H_
Ian Rogers2dd0e2c2013-01-24 12:42:14 -080019
Andreas Gampe3b7dc352017-06-06 20:02:03 -070020#include "base/bit_utils.h"
Vladimir Marko2c64a832018-01-04 11:31:56 +000021#include "base/casts.h"
Andreas Gampe542451c2016-07-26 09:02:02 -070022#include "base/enums.h"
David Sehrc431b9d2018-03-02 12:01:51 -080023#include "base/stride_iterator.h"
Andreas Gampe8cf9cb32017-07-19 09:28:38 -070024#include "class_flags.h"
Andreas Gampeee5303f2017-08-31 15:34:42 -070025#include "class_status.h"
David Sehr9e734c72018-01-04 17:56:19 -080026#include "dex/dex_file_types.h"
David Sehr8c0961f2018-01-23 16:11:38 -080027#include "dex/modifiers.h"
David Sehr67bf42e2018-02-26 16:43:04 -080028#include "dex/primitive.h"
Ian Rogersb0fa5dc2014-04-28 16:47:08 -070029#include "gc/allocator_type.h"
Ian Rogers2dd0e2c2013-01-24 12:42:14 -080030#include "object.h"
Mingyao Yang98d1cc82014-05-15 17:02:16 -070031#include "object_array.h"
Hiroshi Yamauchi94f7b492014-07-22 18:08:23 -070032#include "read_barrier_option.h"
Ian Rogers2dd0e2c2013-01-24 12:42:14 -080033
Ian Rogers2dd0e2c2013-01-24 12:42:14 -080034namespace art {
35
Andreas Gampe62629592019-01-03 16:08:31 -080036namespace dex {
37struct ClassDef;
38class TypeList;
39} // namespace dex
40
Mathieu Chartierc7853442015-03-27 14:35:38 -070041class ArtField;
Mathieu Chartiere401d142015-04-22 13:56:20 -070042class ArtMethod;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -080043struct ClassOffsets;
Andreas Gampe3f1dcd32018-12-28 09:39:56 -080044class DexFile;
Andreas Gampe5a4b8a22014-09-11 08:30:08 -070045template<class T> class Handle;
Andreas Gampe62629592019-01-03 16:08:31 -080046class ImTable;
Andreas Gampe04c6ab92017-06-08 21:49:14 -070047enum InvokeType : uint32_t;
Andreas Gampe436896c2019-01-02 15:06:53 -080048template <typename Iter> class IterationRange;
Mathieu Chartier54d220e2015-07-30 16:20:06 -070049template<typename T> class LengthPrefixedArray;
Alex Lighte64300b2015-12-15 15:02:47 -080050template<typename T> class ArraySlice;
Ian Rogersd91d6d62013-09-25 20:26:14 -070051class Signature;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -080052class StringPiece;
Mathieu Chartier2d2621a2014-10-23 16:48:06 -070053template<size_t kNumReferences> class PACKED(4) StackHandleScope;
Andreas Gampe49b74a82019-01-07 10:19:49 -080054class Thread;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -080055
56namespace mirror {
57
Alex Lightd6251582016-10-31 11:12:30 -070058class ClassExt;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -080059class ClassLoader;
Mathieu Chartierfc58af42015-04-16 18:00:39 -070060class Constructor;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -080061class DexCache;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -080062class IfTable;
Andreas Gampebc4d2182016-02-22 10:03:12 -080063class Method;
Narayan Kamathc38a6f82016-09-29 17:07:20 +010064template <typename T> struct PACKED(8) DexCachePair;
Christina Wadsworthbf44e0e2016-08-18 10:37:42 -070065
Mathieu Chartier28bd2e42016-10-04 13:54:57 -070066using StringDexCachePair = DexCachePair<String>;
Narayan Kamathc38a6f82016-09-29 17:07:20 +010067using StringDexCacheType = std::atomic<StringDexCachePair>;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -080068
Ian Rogers2dd0e2c2013-01-24 12:42:14 -080069// C++ mirror of java.lang.Class
Roland Levillainbbc6e7e2018-08-24 16:58:47 +010070class MANAGED Class final : public Object {
Ian Rogers2dd0e2c2013-01-24 12:42:14 -080071 public:
Ian Rogerscdc1aaf2014-10-09 13:21:38 -070072 // A magic value for reference_instance_offsets_. Ignore the bits and walk the super chain when
73 // this is the value.
74 // [This is an unlikely "natural" value, since it would be 30 non-ref instance fields followed by
75 // 2 ref instance fields.]
76 static constexpr uint32_t kClassWalkSuper = 0xC0000000;
77
Mathieu Chartier8261d022016-08-08 09:41:04 -070078 // Shift primitive type by kPrimitiveTypeSizeShiftShift to get the component type size shift
79 // Used for computing array size as follows:
80 // array_bytes = header_size + (elements << (primitive_type >> kPrimitiveTypeSizeShiftShift))
81 static constexpr uint32_t kPrimitiveTypeSizeShiftShift = 16;
82 static constexpr uint32_t kPrimitiveTypeMask = (1u << kPrimitiveTypeSizeShiftShift) - 1;
83
Mathieu Chartier4e305412014-02-19 10:54:44 -080084 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Vladimir Marko2c64a832018-01-04 11:31:56 +000085 ClassStatus GetStatus() REQUIRES_SHARED(Locks::mutator_lock_) {
Igor Murashkin86083f72017-10-27 10:59:04 -070086 // Avoid including "subtype_check_bits_and_status.h" to get the field.
Vladimir Marko305c38b2018-02-14 11:50:07 +000087 // The ClassStatus is always in the 4 most-significant bits of status_.
Vladimir Marko2c64a832018-01-04 11:31:56 +000088 return enum_cast<ClassStatus>(
Vladimir Markodc682aa2018-01-04 18:42:57 +000089 static_cast<uint32_t>(GetField32Volatile<kVerifyFlags>(StatusOffset())) >> (32 - 4));
Ian Rogers2dd0e2c2013-01-24 12:42:14 -080090 }
91
Hiroshi Yamauchi5b783e62015-03-18 17:20:11 -070092 // This is static because 'this' may be moved by GC.
Vladimir Marko2c64a832018-01-04 11:31:56 +000093 static void SetStatus(Handle<Class> h_this, ClassStatus new_status, Thread* self)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -070094 REQUIRES_SHARED(Locks::mutator_lock_) REQUIRES(!Roles::uninterruptible_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -080095
David Srbecky56de89a2018-10-01 15:32:20 +010096 static constexpr MemberOffset StatusOffset() {
Igor Murashkin86083f72017-10-27 10:59:04 -070097 return MemberOffset(OFFSET_OF_OBJECT_MEMBER(Class, status_));
Ian Rogers5ddb4102014-01-07 08:58:46 -080098 }
99
Mingyao Yang98d1cc82014-05-15 17:02:16 -0700100 // Returns true if the class has been retired.
101 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700102 bool IsRetired() REQUIRES_SHARED(Locks::mutator_lock_) {
Vladimir Marko2c64a832018-01-04 11:31:56 +0000103 return GetStatus<kVerifyFlags>() == ClassStatus::kRetired;
Mingyao Yang98d1cc82014-05-15 17:02:16 -0700104 }
105
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800106 // Returns true if the class has failed to link.
Mathieu Chartier4e305412014-02-19 10:54:44 -0800107 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Vladimir Marko72ab6842017-01-20 19:32:50 +0000108 bool IsErroneousUnresolved() REQUIRES_SHARED(Locks::mutator_lock_) {
Vladimir Marko2c64a832018-01-04 11:31:56 +0000109 return GetStatus<kVerifyFlags>() == ClassStatus::kErrorUnresolved;
Vladimir Marko72ab6842017-01-20 19:32:50 +0000110 }
111
112 // Returns true if the class has failed to initialize.
113 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
114 bool IsErroneousResolved() REQUIRES_SHARED(Locks::mutator_lock_) {
Vladimir Marko2c64a832018-01-04 11:31:56 +0000115 return GetStatus<kVerifyFlags>() == ClassStatus::kErrorResolved;
Vladimir Marko72ab6842017-01-20 19:32:50 +0000116 }
117
118 // Returns true if the class status indicets that the class has failed to link or initialize.
Vladimir Marko2c64a832018-01-04 11:31:56 +0000119 static bool IsErroneous(ClassStatus status) {
120 return status == ClassStatus::kErrorUnresolved || status == ClassStatus::kErrorResolved;
Vladimir Marko72ab6842017-01-20 19:32:50 +0000121 }
122
123 // Returns true if the class has failed to link or initialize.
124 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700125 bool IsErroneous() REQUIRES_SHARED(Locks::mutator_lock_) {
Vladimir Marko72ab6842017-01-20 19:32:50 +0000126 return IsErroneous(GetStatus<kVerifyFlags>());
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800127 }
128
129 // Returns true if the class has been loaded.
Mathieu Chartier4e305412014-02-19 10:54:44 -0800130 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700131 bool IsIdxLoaded() REQUIRES_SHARED(Locks::mutator_lock_) {
Vladimir Marko2c64a832018-01-04 11:31:56 +0000132 return GetStatus<kVerifyFlags>() >= ClassStatus::kIdx;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800133 }
134
135 // Returns true if the class has been loaded.
Mathieu Chartier4e305412014-02-19 10:54:44 -0800136 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700137 bool IsLoaded() REQUIRES_SHARED(Locks::mutator_lock_) {
Vladimir Marko2c64a832018-01-04 11:31:56 +0000138 return GetStatus<kVerifyFlags>() >= ClassStatus::kLoaded;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800139 }
140
141 // Returns true if the class has been linked.
Mathieu Chartier4e305412014-02-19 10:54:44 -0800142 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700143 bool IsResolved() REQUIRES_SHARED(Locks::mutator_lock_) {
Vladimir Marko2c64a832018-01-04 11:31:56 +0000144 ClassStatus status = GetStatus<kVerifyFlags>();
145 return status >= ClassStatus::kResolved || status == ClassStatus::kErrorResolved;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800146 }
147
Nicolas Geoffray7cc3ae52017-03-07 14:33:37 +0000148 // Returns true if the class should be verified at runtime.
Mathieu Chartier4e305412014-02-19 10:54:44 -0800149 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Nicolas Geoffray7cc3ae52017-03-07 14:33:37 +0000150 bool ShouldVerifyAtRuntime() REQUIRES_SHARED(Locks::mutator_lock_) {
Vladimir Marko2c64a832018-01-04 11:31:56 +0000151 return GetStatus<kVerifyFlags>() == ClassStatus::kRetryVerificationAtRuntime;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800152 }
153
154 // Returns true if the class has been verified.
Mathieu Chartier4e305412014-02-19 10:54:44 -0800155 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700156 bool IsVerified() REQUIRES_SHARED(Locks::mutator_lock_) {
Vladimir Marko2c64a832018-01-04 11:31:56 +0000157 return GetStatus<kVerifyFlags>() >= ClassStatus::kVerified;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800158 }
159
160 // Returns true if the class is initializing.
Mathieu Chartier4e305412014-02-19 10:54:44 -0800161 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700162 bool IsInitializing() REQUIRES_SHARED(Locks::mutator_lock_) {
Vladimir Marko2c64a832018-01-04 11:31:56 +0000163 return GetStatus<kVerifyFlags>() >= ClassStatus::kInitializing;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800164 }
165
166 // Returns true if the class is initialized.
Mathieu Chartier4e305412014-02-19 10:54:44 -0800167 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700168 bool IsInitialized() REQUIRES_SHARED(Locks::mutator_lock_) {
Vladimir Marko2c64a832018-01-04 11:31:56 +0000169 return GetStatus<kVerifyFlags>() == ClassStatus::kInitialized;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800170 }
171
Mathieu Chartier4e305412014-02-19 10:54:44 -0800172 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampe90b936d2017-01-31 08:58:55 -0800173 ALWAYS_INLINE uint32_t GetAccessFlags() REQUIRES_SHARED(Locks::mutator_lock_) {
174 if (kIsDebugBuild) {
175 GetAccessFlagsDCheck<kVerifyFlags>();
176 }
177 return GetField32<kVerifyFlags>(AccessFlagsOffset());
178 }
179
David Srbecky56de89a2018-10-01 15:32:20 +0100180 static constexpr MemberOffset AccessFlagsOffset() {
Hiroshi Yamauchie01a5202015-03-19 12:35:04 -0700181 return OFFSET_OF_OBJECT_MEMBER(Class, access_flags_);
182 }
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800183
Mathieu Chartier52a7f5c2015-08-18 18:35:52 -0700184 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700185 ALWAYS_INLINE uint32_t GetClassFlags() REQUIRES_SHARED(Locks::mutator_lock_) {
Mathieu Chartier52a7f5c2015-08-18 18:35:52 -0700186 return GetField32<kVerifyFlags>(OFFSET_OF_OBJECT_MEMBER(Class, class_flags_));
187 }
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700188 void SetClassFlags(uint32_t new_flags) REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartier52a7f5c2015-08-18 18:35:52 -0700189
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700190 void SetAccessFlags(uint32_t new_access_flags) REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800191
Orion Hodson58143d22018-02-20 08:44:20 +0000192 // Returns true if the class is an enum.
193 ALWAYS_INLINE bool IsEnum() REQUIRES_SHARED(Locks::mutator_lock_) {
194 return (GetAccessFlags() & kAccEnum) != 0;
195 }
196
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800197 // Returns true if the class is an interface.
Vladimir Marko98db89c2018-09-07 11:45:46 +0100198 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700199 ALWAYS_INLINE bool IsInterface() REQUIRES_SHARED(Locks::mutator_lock_) {
Vladimir Marko98db89c2018-09-07 11:45:46 +0100200 return (GetAccessFlags<kVerifyFlags>() & kAccInterface) != 0;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800201 }
202
203 // Returns true if the class is declared public.
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700204 ALWAYS_INLINE bool IsPublic() REQUIRES_SHARED(Locks::mutator_lock_) {
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800205 return (GetAccessFlags() & kAccPublic) != 0;
206 }
207
208 // Returns true if the class is declared final.
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700209 ALWAYS_INLINE bool IsFinal() REQUIRES_SHARED(Locks::mutator_lock_) {
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800210 return (GetAccessFlags() & kAccFinal) != 0;
211 }
212
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700213 ALWAYS_INLINE bool IsFinalizable() REQUIRES_SHARED(Locks::mutator_lock_) {
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800214 return (GetAccessFlags() & kAccClassIsFinalizable) != 0;
215 }
216
David Brazdil59a49a62018-05-09 10:58:27 +0100217 ALWAYS_INLINE bool ShouldSkipHiddenApiChecks() REQUIRES_SHARED(Locks::mutator_lock_) {
David Brazdil85865692018-10-30 17:26:20 +0000218 return (GetAccessFlags() & kAccSkipHiddenapiChecks) != 0;
David Brazdil59a49a62018-05-09 10:58:27 +0100219 }
220
221 ALWAYS_INLINE void SetSkipHiddenApiChecks() REQUIRES_SHARED(Locks::mutator_lock_) {
222 uint32_t flags = GetAccessFlags();
David Brazdil85865692018-10-30 17:26:20 +0000223 SetAccessFlags(flags | kAccSkipHiddenapiChecks);
David Brazdil59a49a62018-05-09 10:58:27 +0100224 }
225
Andreas Gampe49b74a82019-01-07 10:19:49 -0800226 ALWAYS_INLINE void SetRecursivelyInitialized() REQUIRES_SHARED(Locks::mutator_lock_);
Alex Lighteb7c1442015-08-31 13:17:42 -0700227
Andreas Gampe49b74a82019-01-07 10:19:49 -0800228 ALWAYS_INLINE void SetHasDefaultMethods() REQUIRES_SHARED(Locks::mutator_lock_);
Alex Lighteb7c1442015-08-31 13:17:42 -0700229
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700230 ALWAYS_INLINE void SetFinalizable() REQUIRES_SHARED(Locks::mutator_lock_) {
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700231 uint32_t flags = GetField32(OFFSET_OF_OBJECT_MEMBER(Class, access_flags_));
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800232 SetAccessFlags(flags | kAccClassIsFinalizable);
233 }
234
Vladimir Marko98db89c2018-09-07 11:45:46 +0100235 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700236 ALWAYS_INLINE bool IsStringClass() REQUIRES_SHARED(Locks::mutator_lock_) {
Vladimir Marko98db89c2018-09-07 11:45:46 +0100237 return (GetClassFlags<kVerifyFlags>() & kClassFlagString) != 0;
Jeff Hao848f70a2014-01-15 13:49:50 -0800238 }
239
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700240 ALWAYS_INLINE void SetStringClass() REQUIRES_SHARED(Locks::mutator_lock_) {
Mathieu Chartier66c2d2d2015-08-25 14:32:32 -0700241 SetClassFlags(kClassFlagString | kClassFlagNoReferenceFields);
Jeff Hao848f70a2014-01-15 13:49:50 -0800242 }
243
Vladimir Marko98db89c2018-09-07 11:45:46 +0100244 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700245 ALWAYS_INLINE bool IsClassLoaderClass() REQUIRES_SHARED(Locks::mutator_lock_) {
Vladimir Marko98db89c2018-09-07 11:45:46 +0100246 return GetClassFlags<kVerifyFlags>() == kClassFlagClassLoader;
Mathieu Chartiere4275c02015-08-06 15:34:15 -0700247 }
248
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700249 ALWAYS_INLINE void SetClassLoaderClass() REQUIRES_SHARED(Locks::mutator_lock_) {
Mathieu Chartier66c2d2d2015-08-25 14:32:32 -0700250 SetClassFlags(kClassFlagClassLoader);
Mathieu Chartiere4275c02015-08-06 15:34:15 -0700251 }
252
Vladimir Marko98db89c2018-09-07 11:45:46 +0100253 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700254 ALWAYS_INLINE bool IsDexCacheClass() REQUIRES_SHARED(Locks::mutator_lock_) {
Vladimir Marko98db89c2018-09-07 11:45:46 +0100255 return (GetClassFlags<kVerifyFlags>() & kClassFlagDexCache) != 0;
Vladimir Marko05792b92015-08-03 11:56:49 +0100256 }
257
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700258 ALWAYS_INLINE void SetDexCacheClass() REQUIRES_SHARED(Locks::mutator_lock_) {
Vladimir Marko05792b92015-08-03 11:56:49 +0100259 SetClassFlags(GetClassFlags() | kClassFlagDexCache);
260 }
261
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800262 // Returns true if the class is abstract.
Vladimir Marko98db89c2018-09-07 11:45:46 +0100263 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700264 ALWAYS_INLINE bool IsAbstract() REQUIRES_SHARED(Locks::mutator_lock_) {
Vladimir Marko98db89c2018-09-07 11:45:46 +0100265 return (GetAccessFlags<kVerifyFlags>() & kAccAbstract) != 0;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800266 }
267
268 // Returns true if the class is an annotation.
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700269 ALWAYS_INLINE bool IsAnnotation() REQUIRES_SHARED(Locks::mutator_lock_) {
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800270 return (GetAccessFlags() & kAccAnnotation) != 0;
271 }
272
273 // Returns true if the class is synthetic.
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700274 ALWAYS_INLINE bool IsSynthetic() REQUIRES_SHARED(Locks::mutator_lock_) {
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800275 return (GetAccessFlags() & kAccSynthetic) != 0;
276 }
277
Igor Murashkin8d1da852016-02-04 11:01:21 -0800278 // Return whether the class had run the verifier at least once.
Igor Murashkindf707e42016-02-02 16:56:50 -0800279 // This does not necessarily mean that access checks are avoidable,
280 // since the class methods might still need to be run with access checks.
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700281 bool WasVerificationAttempted() REQUIRES_SHARED(Locks::mutator_lock_) {
Vladimir Markob0a6aee2017-10-27 10:34:04 +0100282 return (GetAccessFlags() & kAccVerificationAttempted) != 0;
Ian Rogers7b078e82014-09-10 14:44:24 -0700283 }
284
Igor Murashkindf707e42016-02-02 16:56:50 -0800285 // Mark the class as having gone through a verification attempt.
286 // Mutually exclusive from whether or not each method is allowed to skip access checks.
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700287 void SetVerificationAttempted() REQUIRES_SHARED(Locks::mutator_lock_) {
Ian Rogers7b078e82014-09-10 14:44:24 -0700288 uint32_t flags = GetField32(OFFSET_OF_OBJECT_MEMBER(Class, access_flags_));
Mathieu Chartier085a0722016-04-01 17:33:31 -0700289 if ((flags & kAccVerificationAttempted) == 0) {
290 SetAccessFlags(flags | kAccVerificationAttempted);
291 }
Ian Rogers7b078e82014-09-10 14:44:24 -0700292 }
293
Mathieu Chartier4e305412014-02-19 10:54:44 -0800294 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700295 bool IsTypeOfReferenceClass() REQUIRES_SHARED(Locks::mutator_lock_) {
Mathieu Chartier52a7f5c2015-08-18 18:35:52 -0700296 return (GetClassFlags<kVerifyFlags>() & kClassFlagReference) != 0;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800297 }
298
Mathieu Chartier4e305412014-02-19 10:54:44 -0800299 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700300 bool IsWeakReferenceClass() REQUIRES_SHARED(Locks::mutator_lock_) {
Mathieu Chartier66c2d2d2015-08-25 14:32:32 -0700301 return GetClassFlags<kVerifyFlags>() == kClassFlagWeakReference;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800302 }
303
Mathieu Chartier4e305412014-02-19 10:54:44 -0800304 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700305 bool IsSoftReferenceClass() REQUIRES_SHARED(Locks::mutator_lock_) {
Mathieu Chartier66c2d2d2015-08-25 14:32:32 -0700306 return GetClassFlags<kVerifyFlags>() == kClassFlagSoftReference;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800307 }
308
Mathieu Chartier4e305412014-02-19 10:54:44 -0800309 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700310 bool IsFinalizerReferenceClass() REQUIRES_SHARED(Locks::mutator_lock_) {
Mathieu Chartier66c2d2d2015-08-25 14:32:32 -0700311 return GetClassFlags<kVerifyFlags>() == kClassFlagFinalizerReference;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800312 }
313
Mathieu Chartier4e305412014-02-19 10:54:44 -0800314 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700315 bool IsPhantomReferenceClass() REQUIRES_SHARED(Locks::mutator_lock_) {
Mathieu Chartier66c2d2d2015-08-25 14:32:32 -0700316 return GetClassFlags<kVerifyFlags>() == kClassFlagPhantomReference;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800317 }
318
Ian Rogers04f94f42013-06-10 15:09:26 -0700319 // Can references of this type be assigned to by things of another type? For non-array types
320 // this is a matter of whether sub-classes may exist - which they can't if the type is final.
321 // For array classes, where all the classes are final due to there being no sub-classes, an
322 // Object[] may be assigned to by a String[] but a String[] may not be assigned to by other
323 // types as the component is final.
Mathieu Chartier28bd2e42016-10-04 13:54:57 -0700324 bool CannotBeAssignedFromOtherTypes() REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800325
Mingyao Yang98d1cc82014-05-15 17:02:16 -0700326 // Returns true if this class is the placeholder and should retire and
327 // be replaced with a class with the right size for embedded imt/vtable.
Vladimir Marko98db89c2018-09-07 11:45:46 +0100328 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700329 bool IsTemp() REQUIRES_SHARED(Locks::mutator_lock_) {
Vladimir Marko98db89c2018-09-07 11:45:46 +0100330 ClassStatus s = GetStatus<kVerifyFlags>();
Vladimir Marko2c64a832018-01-04 11:31:56 +0000331 return s < ClassStatus::kResolving &&
332 s != ClassStatus::kErrorResolved &&
Vladimir Marko98db89c2018-09-07 11:45:46 +0100333 ShouldHaveEmbeddedVTable<kVerifyFlags>();
Mingyao Yang98d1cc82014-05-15 17:02:16 -0700334 }
335
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700336 String* GetName() REQUIRES_SHARED(Locks::mutator_lock_); // Returns the cached name.
Mathieu Chartier1a5337f2016-10-13 13:48:23 -0700337 void SetName(ObjPtr<String> name) REQUIRES_SHARED(Locks::mutator_lock_); // Sets the cached name.
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800338 // Computes the name, then sets the cached value.
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700339 static String* ComputeName(Handle<Class> h_this) REQUIRES_SHARED(Locks::mutator_lock_)
Mathieu Chartiered8990a2015-07-23 14:11:16 -0700340 REQUIRES(!Roles::uninterruptible_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800341
Mathieu Chartierc2f4d022014-03-03 16:11:42 -0800342 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700343 bool IsProxyClass() REQUIRES_SHARED(Locks::mutator_lock_) {
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800344 // Read access flags without using getter as whether something is a proxy can be check in
345 // any loaded state
346 // TODO: switch to a check if the super class is java.lang.reflect.Proxy?
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700347 uint32_t access_flags = GetField32<kVerifyFlags>(OFFSET_OF_OBJECT_MEMBER(Class, access_flags_));
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800348 return (access_flags & kAccClassIsProxy) != 0;
349 }
350
David Srbecky56de89a2018-10-01 15:32:20 +0100351 static constexpr MemberOffset PrimitiveTypeOffset() {
Nicolas Geoffray85c7bab2015-09-18 13:40:46 +0000352 return OFFSET_OF_OBJECT_MEMBER(Class, primitive_type_);
353 }
354
Mathieu Chartier4e305412014-02-19 10:54:44 -0800355 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700356 Primitive::Type GetPrimitiveType() ALWAYS_INLINE REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800357
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700358 void SetPrimitiveType(Primitive::Type new_type) REQUIRES_SHARED(Locks::mutator_lock_) {
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800359 DCHECK_EQ(sizeof(Primitive::Type), sizeof(int32_t));
Mathieu Chartier8261d022016-08-08 09:41:04 -0700360 uint32_t v32 = static_cast<uint32_t>(new_type);
361 DCHECK_EQ(v32 & kPrimitiveTypeMask, v32) << "upper 16 bits aren't zero";
Hiroshi Yamauchif0edfc32014-09-25 11:46:46 -0700362 // Store the component size shift in the upper 16 bits.
Mathieu Chartier8261d022016-08-08 09:41:04 -0700363 v32 |= Primitive::ComponentSizeShift(new_type) << kPrimitiveTypeSizeShiftShift;
Chang Xing6d3e7682017-07-11 10:31:29 -0700364 SetField32Transaction(OFFSET_OF_OBJECT_MEMBER(Class, primitive_type_), v32);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800365 }
366
Hiroshi Yamauchif0edfc32014-09-25 11:46:46 -0700367 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700368 size_t GetPrimitiveTypeSizeShift() ALWAYS_INLINE REQUIRES_SHARED(Locks::mutator_lock_);
Hiroshi Yamauchif0edfc32014-09-25 11:46:46 -0700369
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800370 // Returns true if the class is a primitive type.
Mathieu Chartier4e305412014-02-19 10:54:44 -0800371 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700372 bool IsPrimitive() REQUIRES_SHARED(Locks::mutator_lock_) {
Mathieu Chartier4e305412014-02-19 10:54:44 -0800373 return GetPrimitiveType<kVerifyFlags>() != Primitive::kPrimNot;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800374 }
375
Mathieu Chartier4e305412014-02-19 10:54:44 -0800376 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700377 bool IsPrimitiveBoolean() REQUIRES_SHARED(Locks::mutator_lock_) {
Mathieu Chartier4e305412014-02-19 10:54:44 -0800378 return GetPrimitiveType<kVerifyFlags>() == Primitive::kPrimBoolean;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800379 }
380
Mathieu Chartier4e305412014-02-19 10:54:44 -0800381 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700382 bool IsPrimitiveByte() REQUIRES_SHARED(Locks::mutator_lock_) {
Mathieu Chartier4e305412014-02-19 10:54:44 -0800383 return GetPrimitiveType<kVerifyFlags>() == Primitive::kPrimByte;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800384 }
385
Mathieu Chartier4e305412014-02-19 10:54:44 -0800386 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700387 bool IsPrimitiveChar() REQUIRES_SHARED(Locks::mutator_lock_) {
Mathieu Chartier4e305412014-02-19 10:54:44 -0800388 return GetPrimitiveType<kVerifyFlags>() == Primitive::kPrimChar;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800389 }
390
Mathieu Chartier4e305412014-02-19 10:54:44 -0800391 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700392 bool IsPrimitiveShort() REQUIRES_SHARED(Locks::mutator_lock_) {
Mathieu Chartier4e305412014-02-19 10:54:44 -0800393 return GetPrimitiveType<kVerifyFlags>() == Primitive::kPrimShort;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800394 }
395
Mathieu Chartier4e305412014-02-19 10:54:44 -0800396 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700397 bool IsPrimitiveInt() REQUIRES_SHARED(Locks::mutator_lock_) {
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800398 return GetPrimitiveType() == Primitive::kPrimInt;
399 }
400
Mathieu Chartier4e305412014-02-19 10:54:44 -0800401 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700402 bool IsPrimitiveLong() REQUIRES_SHARED(Locks::mutator_lock_) {
Mathieu Chartier4e305412014-02-19 10:54:44 -0800403 return GetPrimitiveType<kVerifyFlags>() == Primitive::kPrimLong;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800404 }
405
Mathieu Chartier4e305412014-02-19 10:54:44 -0800406 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700407 bool IsPrimitiveFloat() REQUIRES_SHARED(Locks::mutator_lock_) {
Mathieu Chartier4e305412014-02-19 10:54:44 -0800408 return GetPrimitiveType<kVerifyFlags>() == Primitive::kPrimFloat;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800409 }
410
Mathieu Chartier4e305412014-02-19 10:54:44 -0800411 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700412 bool IsPrimitiveDouble() REQUIRES_SHARED(Locks::mutator_lock_) {
Mathieu Chartier4e305412014-02-19 10:54:44 -0800413 return GetPrimitiveType<kVerifyFlags>() == Primitive::kPrimDouble;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800414 }
415
Mathieu Chartier4e305412014-02-19 10:54:44 -0800416 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700417 bool IsPrimitiveVoid() REQUIRES_SHARED(Locks::mutator_lock_) {
Mathieu Chartier4e305412014-02-19 10:54:44 -0800418 return GetPrimitiveType<kVerifyFlags>() == Primitive::kPrimVoid;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800419 }
420
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800421 // Depth of class from java.lang.Object
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700422 uint32_t Depth() REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800423
Vladimir Marko98db89c2018-09-07 11:45:46 +0100424 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700425 bool IsArrayClass() REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800426
Mathieu Chartierd7a7f2f2018-09-07 11:57:18 -0700427 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700428 bool IsClassClass() REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800429
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700430 bool IsThrowableClass() REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800431
David Srbecky56de89a2018-10-01 15:32:20 +0100432 static constexpr MemberOffset ComponentTypeOffset() {
Ian Rogersa9a82542013-10-04 11:17:26 -0700433 return OFFSET_OF_OBJECT_MEMBER(Class, component_type_);
434 }
435
Hiroshi Yamauchi6e83c172014-05-01 21:25:41 -0700436 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags,
437 ReadBarrierOption kReadBarrierOption = kWithReadBarrier>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700438 Class* GetComponentType() REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800439
Mathieu Chartier28bd2e42016-10-04 13:54:57 -0700440 void SetComponentType(ObjPtr<Class> new_component_type) REQUIRES_SHARED(Locks::mutator_lock_) {
Mathieu Chartier2cebb242015-04-21 16:50:40 -0700441 DCHECK(GetComponentType() == nullptr);
442 DCHECK(new_component_type != nullptr);
Sebastien Hertzee1d79a2014-02-21 15:46:30 +0100443 // Component type is invariant: use non-transactional mode without check.
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700444 SetFieldObject<false, false>(ComponentTypeOffset(), new_component_type);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800445 }
446
Hiroshi Yamauchi6e83c172014-05-01 21:25:41 -0700447 template<ReadBarrierOption kReadBarrierOption = kWithReadBarrier>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700448 size_t GetComponentSize() REQUIRES_SHARED(Locks::mutator_lock_) {
Mathieu Chartier5ffa0782016-07-27 10:45:47 -0700449 return 1U << GetComponentSizeShift<kReadBarrierOption>();
Hiroshi Yamauchif0edfc32014-09-25 11:46:46 -0700450 }
451
452 template<ReadBarrierOption kReadBarrierOption = kWithReadBarrier>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700453 size_t GetComponentSizeShift() REQUIRES_SHARED(Locks::mutator_lock_) {
Hiroshi Yamauchif0edfc32014-09-25 11:46:46 -0700454 return GetComponentType<kDefaultVerifyFlags, kReadBarrierOption>()->GetPrimitiveTypeSizeShift();
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800455 }
456
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700457 bool IsObjectClass() REQUIRES_SHARED(Locks::mutator_lock_) {
Vladimir Markodbcb48f2018-11-12 11:47:04 +0000458 // No read barrier is needed for comparing with null.
459 return !IsPrimitive() && GetSuperClass<kDefaultVerifyFlags, kWithoutReadBarrier>() == nullptr;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800460 }
Ian Rogers68d8b422014-07-17 11:09:10 -0700461
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700462 bool IsInstantiableNonArray() REQUIRES_SHARED(Locks::mutator_lock_) {
Ian Rogers68d8b422014-07-17 11:09:10 -0700463 return !IsPrimitive() && !IsInterface() && !IsAbstract() && !IsArrayClass();
464 }
465
Vladimir Marko98db89c2018-09-07 11:45:46 +0100466 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700467 bool IsInstantiable() REQUIRES_SHARED(Locks::mutator_lock_) {
Vladimir Marko98db89c2018-09-07 11:45:46 +0100468 return (!IsPrimitive<kVerifyFlags>() &&
469 !IsInterface<kVerifyFlags>() &&
470 !IsAbstract<kVerifyFlags>()) ||
471 (IsAbstract<kVerifyFlags>() && IsArrayClass<kVerifyFlags>());
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800472 }
473
Vladimir Marko98db89c2018-09-07 11:45:46 +0100474 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampec6ea7d02017-02-01 16:46:28 -0800475 ALWAYS_INLINE bool IsObjectArrayClass() REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartiere401d142015-04-22 13:56:20 -0700476
Vladimir Markodbcb48f2018-11-12 11:47:04 +0000477 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
478 bool IsPrimitiveArray() REQUIRES_SHARED(Locks::mutator_lock_);
479
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800480 // Creates a raw object instance but does not invoke the default constructor.
Mathieu Chartier8668c3c2014-04-24 16:48:11 -0700481 template<bool kIsInstrumented, bool kCheckAddFinalizer = true>
Mathieu Chartier28bd2e42016-10-04 13:54:57 -0700482 ALWAYS_INLINE ObjPtr<Object> Alloc(Thread* self, gc::AllocatorType allocator_type)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700483 REQUIRES_SHARED(Locks::mutator_lock_) REQUIRES(!Roles::uninterruptible_);
Hiroshi Yamauchi3b4c1892013-09-12 21:33:12 -0700484
Mathieu Chartier28bd2e42016-10-04 13:54:57 -0700485 ObjPtr<Object> AllocObject(Thread* self)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700486 REQUIRES_SHARED(Locks::mutator_lock_) REQUIRES(!Roles::uninterruptible_);
Mathieu Chartier28bd2e42016-10-04 13:54:57 -0700487 ObjPtr<Object> AllocNonMovableObject(Thread* self)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700488 REQUIRES_SHARED(Locks::mutator_lock_) REQUIRES(!Roles::uninterruptible_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800489
Vladimir Marko98db89c2018-09-07 11:45:46 +0100490 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampec6ea7d02017-02-01 16:46:28 -0800491 ALWAYS_INLINE bool IsVariableSize() REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800492
Hiroshi Yamauchi6e83c172014-05-01 21:25:41 -0700493 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags,
494 ReadBarrierOption kReadBarrierOption = kWithReadBarrier>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700495 uint32_t SizeOf() REQUIRES_SHARED(Locks::mutator_lock_) {
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700496 return GetField32<kVerifyFlags>(OFFSET_OF_OBJECT_MEMBER(Class, class_size_));
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800497 }
498
Mathieu Chartier4e305412014-02-19 10:54:44 -0800499 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700500 uint32_t GetClassSize() REQUIRES_SHARED(Locks::mutator_lock_) {
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700501 return GetField32<kVerifyFlags>(OFFSET_OF_OBJECT_MEMBER(Class, class_size_));
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800502 }
503
Ian Rogersef7d42f2014-01-06 12:55:46 -0800504 void SetClassSize(uint32_t new_class_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700505 REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800506
Mingyao Yang98d1cc82014-05-15 17:02:16 -0700507 // Compute how many bytes would be used a class with the given elements.
Artem Udovichenkoa62cb9b2016-06-30 09:18:25 +0000508 static uint32_t ComputeClassSize(bool has_embedded_vtable,
Mingyao Yang98d1cc82014-05-15 17:02:16 -0700509 uint32_t num_vtable_entries,
Fred Shih37f05ef2014-07-16 18:38:08 -0700510 uint32_t num_8bit_static_fields,
511 uint32_t num_16bit_static_fields,
Mingyao Yang98d1cc82014-05-15 17:02:16 -0700512 uint32_t num_32bit_static_fields,
513 uint32_t num_64bit_static_fields,
Mathieu Chartiere401d142015-04-22 13:56:20 -0700514 uint32_t num_ref_static_fields,
Andreas Gampe542451c2016-07-26 09:02:02 -0700515 PointerSize pointer_size);
Mingyao Yang98d1cc82014-05-15 17:02:16 -0700516
517 // The size of java.lang.Class.class.
Andreas Gampe542451c2016-07-26 09:02:02 -0700518 static uint32_t ClassClassSize(PointerSize pointer_size) {
Mingyao Yang98d1cc82014-05-15 17:02:16 -0700519 // The number of vtable entries in java.lang.Class.
Narayan Kamath6b2dc312017-03-14 13:26:12 +0000520 uint32_t vtable_entries = Object::kVTableLength + 67;
Yi Kongff633e22015-11-06 13:33:22 +0000521 return ComputeClassSize(true, vtable_entries, 0, 0, 4, 1, 0, pointer_size);
Mingyao Yang98d1cc82014-05-15 17:02:16 -0700522 }
523
524 // The size of a java.lang.Class representing a primitive such as int.class.
Andreas Gampe542451c2016-07-26 09:02:02 -0700525 static uint32_t PrimitiveClassSize(PointerSize pointer_size) {
Mathieu Chartiere401d142015-04-22 13:56:20 -0700526 return ComputeClassSize(false, 0, 0, 0, 0, 0, 0, pointer_size);
Mingyao Yang98d1cc82014-05-15 17:02:16 -0700527 }
528
Vladimir Marko98db89c2018-09-07 11:45:46 +0100529 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700530 uint32_t GetObjectSize() REQUIRES_SHARED(Locks::mutator_lock_);
David Srbecky56de89a2018-10-01 15:32:20 +0100531 static constexpr MemberOffset ObjectSizeOffset() {
Hiroshi Yamauchie01a5202015-03-19 12:35:04 -0700532 return OFFSET_OF_OBJECT_MEMBER(Class, object_size_);
533 }
David Srbecky56de89a2018-10-01 15:32:20 +0100534 static constexpr MemberOffset ObjectSizeAllocFastPathOffset() {
Mathieu Chartier93bbee02016-08-31 09:38:40 -0700535 return OFFSET_OF_OBJECT_MEMBER(Class, object_size_alloc_fast_path_);
536 }
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800537
Andreas Gampec6ea7d02017-02-01 16:46:28 -0800538 ALWAYS_INLINE void SetObjectSize(uint32_t new_object_size) REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800539
Mathieu Chartier93bbee02016-08-31 09:38:40 -0700540 void SetObjectSizeAllocFastPath(uint32_t new_object_size) REQUIRES_SHARED(Locks::mutator_lock_);
541
Vladimir Marko98db89c2018-09-07 11:45:46 +0100542 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Mathieu Chartier161db1d2016-09-01 14:06:54 -0700543 uint32_t GetObjectSizeAllocFastPath() REQUIRES_SHARED(Locks::mutator_lock_);
544
Mathieu Chartier2d721012014-11-10 11:08:06 -0800545 void SetObjectSizeWithoutChecks(uint32_t new_object_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700546 REQUIRES_SHARED(Locks::mutator_lock_) {
Mathieu Chartier2d721012014-11-10 11:08:06 -0800547 // Not called within a transaction.
548 return SetField32<false, false, kVerifyNone>(
549 OFFSET_OF_OBJECT_MEMBER(Class, object_size_), new_object_size);
550 }
551
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800552 // Returns true if this class is in the same packages as that class.
Mathieu Chartier3398c782016-09-30 10:27:43 -0700553 bool IsInSamePackage(ObjPtr<Class> that) REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800554
555 static bool IsInSamePackage(const StringPiece& descriptor1, const StringPiece& descriptor2);
556
557 // Returns true if this class can access that class.
Mathieu Chartier3398c782016-09-30 10:27:43 -0700558 bool CanAccess(ObjPtr<Class> that) REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800559
560 // Can this class access a member in the provided class with the provided member access flags?
561 // Note that access to the class isn't checked in case the declaring class is protected and the
562 // method has been exposed by a public sub-class
Mathieu Chartier3398c782016-09-30 10:27:43 -0700563 bool CanAccessMember(ObjPtr<Class> access_to, uint32_t member_flags)
564 REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800565
Vladimir Marko23a28212014-01-09 19:24:37 +0000566 // Can this class access a resolved field?
567 // Note that access to field's class is checked and this may require looking up the class
568 // referenced by the FieldId in the DexFile in case the declaring class is inaccessible.
Mathieu Chartier3398c782016-09-30 10:27:43 -0700569 bool CanAccessResolvedField(ObjPtr<Class> access_to,
570 ArtField* field,
571 ObjPtr<DexCache> dex_cache,
572 uint32_t field_idx)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700573 REQUIRES_SHARED(Locks::mutator_lock_);
Vladimir Markof79aa7f2017-07-04 16:58:55 +0100574 bool CheckResolvedFieldAccess(ObjPtr<Class> access_to,
575 ArtField* field,
576 ObjPtr<DexCache> dex_cache,
577 uint32_t field_idx)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700578 REQUIRES_SHARED(Locks::mutator_lock_);
Vladimir Marko23a28212014-01-09 19:24:37 +0000579
580 // Can this class access a resolved method?
581 // Note that access to methods's class is checked and this may require looking up the class
582 // referenced by the MethodId in the DexFile in case the declaring class is inaccessible.
Mathieu Chartier28bd2e42016-10-04 13:54:57 -0700583 bool CanAccessResolvedMethod(ObjPtr<Class> access_to,
584 ArtMethod* resolved_method,
585 ObjPtr<DexCache> dex_cache,
586 uint32_t method_idx)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700587 REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartier28bd2e42016-10-04 13:54:57 -0700588 bool CheckResolvedMethodAccess(ObjPtr<Class> access_to,
589 ArtMethod* resolved_method,
Vladimir Markof79aa7f2017-07-04 16:58:55 +0100590 ObjPtr<DexCache> dex_cache,
591 uint32_t method_idx,
592 InvokeType throw_invoke_type)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700593 REQUIRES_SHARED(Locks::mutator_lock_);
Vladimir Marko23a28212014-01-09 19:24:37 +0000594
Mathieu Chartier3398c782016-09-30 10:27:43 -0700595 bool IsSubClass(ObjPtr<Class> klass) REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800596
597 // Can src be assigned to this class? For example, String can be assigned to Object (by an
598 // upcast), however, an Object cannot be assigned to a String as a potentially exception throwing
599 // downcast would be necessary. Similarly for interfaces, a class that implements (or an interface
600 // that extends) another can be assigned to its parent, but not vice-versa. All Classes may assign
601 // to themselves. Classes for primitive types may not assign to each other.
Mathieu Chartier3398c782016-09-30 10:27:43 -0700602 ALWAYS_INLINE bool IsAssignableFrom(ObjPtr<Class> src) REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800603
Mathieu Chartierfbc31082016-01-24 11:59:56 -0800604 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags,
605 ReadBarrierOption kReadBarrierOption = kWithReadBarrier>
Andreas Gampe98104992018-10-16 12:49:47 -0700606 ALWAYS_INLINE ObjPtr<Class> GetSuperClass() REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800607
Calin Juravle52503d82015-11-11 16:58:31 +0000608 // Get first common super class. It will never return null.
609 // `This` and `klass` must be classes.
Mathieu Chartier28bd2e42016-10-04 13:54:57 -0700610 ObjPtr<Class> GetCommonSuperClass(Handle<Class> klass) REQUIRES_SHARED(Locks::mutator_lock_);
Calin Juravle52503d82015-11-11 16:58:31 +0000611
Roland Levillain8ca4e4e2017-02-03 15:12:38 +0000612 void SetSuperClass(ObjPtr<Class> new_super_class) REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800613
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700614 bool HasSuperClass() REQUIRES_SHARED(Locks::mutator_lock_) {
Vladimir Markodbcb48f2018-11-12 11:47:04 +0000615 // No read barrier is needed for comparing with null.
616 return GetSuperClass<kDefaultVerifyFlags, kWithoutReadBarrier>() != nullptr;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800617 }
618
David Srbecky56de89a2018-10-01 15:32:20 +0100619 static constexpr MemberOffset SuperClassOffset() {
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800620 return MemberOffset(OFFSETOF_MEMBER(Class, super_class_));
621 }
622
Nicolas Geoffraye51ca8b2016-11-22 14:49:31 +0000623 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags,
624 ReadBarrierOption kReadBarrierOption = kWithReadBarrier>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700625 ClassLoader* GetClassLoader() ALWAYS_INLINE REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800626
Mathieu Chartierbc1e0fa2018-11-14 16:18:18 -0800627 template <bool kCheckTransaction = true>
Mathieu Chartier28bd2e42016-10-04 13:54:57 -0700628 void SetClassLoader(ObjPtr<ClassLoader> new_cl) REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800629
David Srbecky56de89a2018-10-01 15:32:20 +0100630 static constexpr MemberOffset DexCacheOffset() {
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800631 return MemberOffset(OFFSETOF_MEMBER(Class, dex_cache_));
632 }
633
David Srbecky56de89a2018-10-01 15:32:20 +0100634 static constexpr MemberOffset IfTableOffset() {
Mathieu Chartier2ecfd272016-11-01 10:10:05 -0700635 return MemberOffset(OFFSETOF_MEMBER(Class, iftable_));
636 }
637
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800638 enum {
639 kDumpClassFullDetail = 1,
640 kDumpClassClassLoader = (1 << 1),
641 kDumpClassInitialized = (1 << 2),
642 };
643
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700644 void DumpClass(std::ostream& os, int flags) REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800645
Mathieu Chartier137cdfa2017-01-26 14:03:11 -0800646 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags,
647 ReadBarrierOption kReadBarrierOption = kWithReadBarrier>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700648 DexCache* GetDexCache() REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800649
Mathieu Chartier91a6dc42014-12-01 10:31:15 -0800650 // Also updates the dex_cache_strings_ variable from new_dex_cache.
Mathieu Chartier28bd2e42016-10-04 13:54:57 -0700651 void SetDexCache(ObjPtr<DexCache> new_dex_cache) REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800652
Vladimir Marko9ac77492017-06-14 18:07:03 +0100653 ALWAYS_INLINE ArraySlice<ArtMethod> GetDirectMethods(PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700654 REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800655
Alex Lighte64300b2015-12-15 15:02:47 -0800656 ALWAYS_INLINE LengthPrefixedArray<ArtMethod>* GetMethodsPtr()
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700657 REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartiere401d142015-04-22 13:56:20 -0700658
David Srbecky56de89a2018-10-01 15:32:20 +0100659 static constexpr MemberOffset MethodsOffset() {
David Srbecky9b3607d2016-01-14 18:15:54 +0000660 return MemberOffset(OFFSETOF_MEMBER(Class, methods_));
661 }
662
Vladimir Marko9ac77492017-06-14 18:07:03 +0100663 ALWAYS_INLINE ArraySlice<ArtMethod> GetMethods(PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700664 REQUIRES_SHARED(Locks::mutator_lock_);
Alex Lighte64300b2015-12-15 15:02:47 -0800665
666 void SetMethodsPtr(LengthPrefixedArray<ArtMethod>* new_methods,
667 uint32_t num_direct,
668 uint32_t num_virtual)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700669 REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartiere401d142015-04-22 13:56:20 -0700670 // Used by image writer.
Alex Lighte64300b2015-12-15 15:02:47 -0800671 void SetMethodsPtrUnchecked(LengthPrefixedArray<ArtMethod>* new_methods,
672 uint32_t num_direct,
673 uint32_t num_virtual)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700674 REQUIRES_SHARED(Locks::mutator_lock_);
Alex Lighte64300b2015-12-15 15:02:47 -0800675
676 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampe542451c2016-07-26 09:02:02 -0700677 ALWAYS_INLINE ArraySlice<ArtMethod> GetDirectMethodsSlice(PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700678 REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartiere401d142015-04-22 13:56:20 -0700679
Andreas Gampe542451c2016-07-26 09:02:02 -0700680 ALWAYS_INLINE ArtMethod* GetDirectMethod(size_t i, PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700681 REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartiere401d142015-04-22 13:56:20 -0700682
683 // Use only when we are allocating populating the method arrays.
Andreas Gampe542451c2016-07-26 09:02:02 -0700684 ALWAYS_INLINE ArtMethod* GetDirectMethodUnchecked(size_t i, PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700685 REQUIRES_SHARED(Locks::mutator_lock_);
Andreas Gampe542451c2016-07-26 09:02:02 -0700686 ALWAYS_INLINE ArtMethod* GetVirtualMethodUnchecked(size_t i, PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700687 REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartiere401d142015-04-22 13:56:20 -0700688
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800689 // Returns the number of static, private, and constructor methods.
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700690 ALWAYS_INLINE uint32_t NumDirectMethods() REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800691
Mathieu Chartier4e305412014-02-19 10:54:44 -0800692 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampe542451c2016-07-26 09:02:02 -0700693 ALWAYS_INLINE ArraySlice<ArtMethod> GetMethodsSlice(PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700694 REQUIRES_SHARED(Locks::mutator_lock_);
Alex Lighte64300b2015-12-15 15:02:47 -0800695
696 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampe542451c2016-07-26 09:02:02 -0700697 ALWAYS_INLINE ArraySlice<ArtMethod> GetDeclaredMethodsSlice(PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700698 REQUIRES_SHARED(Locks::mutator_lock_);
Alex Lighte64300b2015-12-15 15:02:47 -0800699
Vladimir Marko9ac77492017-06-14 18:07:03 +0100700 ALWAYS_INLINE ArraySlice<ArtMethod> GetDeclaredMethods(
Andreas Gampe542451c2016-07-26 09:02:02 -0700701 PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700702 REQUIRES_SHARED(Locks::mutator_lock_);
Alex Lighte64300b2015-12-15 15:02:47 -0800703
Andreas Gampe542451c2016-07-26 09:02:02 -0700704 template <PointerSize kPointerSize, bool kTransactionActive>
Mathieu Chartier28bd2e42016-10-04 13:54:57 -0700705 static ObjPtr<Method> GetDeclaredMethodInternal(Thread* self,
706 ObjPtr<Class> klass,
707 ObjPtr<String> name,
708 ObjPtr<ObjectArray<Class>> args)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700709 REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartier28bd2e42016-10-04 13:54:57 -0700710
Andreas Gampe542451c2016-07-26 09:02:02 -0700711 template <PointerSize kPointerSize, bool kTransactionActive>
Mathieu Chartier28bd2e42016-10-04 13:54:57 -0700712 static ObjPtr<Constructor> GetDeclaredConstructorInternal(Thread* self,
713 ObjPtr<Class> klass,
714 ObjPtr<ObjectArray<Class>> args)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700715 REQUIRES_SHARED(Locks::mutator_lock_);
Andreas Gampebc4d2182016-02-22 10:03:12 -0800716
Alex Lighte64300b2015-12-15 15:02:47 -0800717 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampe542451c2016-07-26 09:02:02 -0700718 ALWAYS_INLINE ArraySlice<ArtMethod> GetDeclaredVirtualMethodsSlice(PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700719 REQUIRES_SHARED(Locks::mutator_lock_);
Alex Lighte64300b2015-12-15 15:02:47 -0800720
Vladimir Marko9ac77492017-06-14 18:07:03 +0100721 ALWAYS_INLINE ArraySlice<ArtMethod> GetDeclaredVirtualMethods(
Andreas Gampe542451c2016-07-26 09:02:02 -0700722 PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700723 REQUIRES_SHARED(Locks::mutator_lock_);
Alex Lighte64300b2015-12-15 15:02:47 -0800724
725 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampe542451c2016-07-26 09:02:02 -0700726 ALWAYS_INLINE ArraySlice<ArtMethod> GetCopiedMethodsSlice(PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700727 REQUIRES_SHARED(Locks::mutator_lock_);
Alex Lighte64300b2015-12-15 15:02:47 -0800728
Vladimir Marko9ac77492017-06-14 18:07:03 +0100729 ALWAYS_INLINE ArraySlice<ArtMethod> GetCopiedMethods(PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700730 REQUIRES_SHARED(Locks::mutator_lock_);
Alex Lighte64300b2015-12-15 15:02:47 -0800731
732 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampe542451c2016-07-26 09:02:02 -0700733 ALWAYS_INLINE ArraySlice<ArtMethod> GetVirtualMethodsSlice(PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700734 REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartiere401d142015-04-22 13:56:20 -0700735
Vladimir Marko9ac77492017-06-14 18:07:03 +0100736 ALWAYS_INLINE ArraySlice<ArtMethod> GetVirtualMethods(
Andreas Gampe542451c2016-07-26 09:02:02 -0700737 PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700738 REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartiere401d142015-04-22 13:56:20 -0700739
Alex Lighte64300b2015-12-15 15:02:47 -0800740 // Returns the number of non-inherited virtual methods (sum of declared and copied methods).
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700741 ALWAYS_INLINE uint32_t NumVirtualMethods() REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800742
Alex Lighte64300b2015-12-15 15:02:47 -0800743 // Returns the number of copied virtual methods.
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700744 ALWAYS_INLINE uint32_t NumCopiedVirtualMethods() REQUIRES_SHARED(Locks::mutator_lock_);
Alex Lighte64300b2015-12-15 15:02:47 -0800745
746 // Returns the number of declared virtual methods.
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700747 ALWAYS_INLINE uint32_t NumDeclaredVirtualMethods() REQUIRES_SHARED(Locks::mutator_lock_);
Alex Lighte64300b2015-12-15 15:02:47 -0800748
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700749 ALWAYS_INLINE uint32_t NumMethods() REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartier2466d622017-09-26 13:52:26 -0700750 static ALWAYS_INLINE uint32_t NumMethods(LengthPrefixedArray<ArtMethod>* methods)
751 REQUIRES_SHARED(Locks::mutator_lock_);
Alex Lighte64300b2015-12-15 15:02:47 -0800752
Mathieu Chartier4e305412014-02-19 10:54:44 -0800753 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampe542451c2016-07-26 09:02:02 -0700754 ArtMethod* GetVirtualMethod(size_t i, PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700755 REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800756
Andreas Gampe542451c2016-07-26 09:02:02 -0700757 ArtMethod* GetVirtualMethodDuringLinking(size_t i, PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700758 REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800759
Mathieu Chartierfbc31082016-01-24 11:59:56 -0800760 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags,
761 ReadBarrierOption kReadBarrierOption = kWithReadBarrier>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700762 ALWAYS_INLINE PointerArray* GetVTable() REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartiere401d142015-04-22 13:56:20 -0700763
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700764 ALWAYS_INLINE PointerArray* GetVTableDuringLinking() REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartiere401d142015-04-22 13:56:20 -0700765
Vladimir Markobcf17522018-06-01 13:14:32 +0100766 void SetVTable(ObjPtr<PointerArray> new_vtable) REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800767
David Srbecky56de89a2018-10-01 15:32:20 +0100768 static constexpr MemberOffset VTableOffset() {
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800769 return OFFSET_OF_OBJECT_MEMBER(Class, vtable_);
770 }
771
David Srbecky56de89a2018-10-01 15:32:20 +0100772 static constexpr MemberOffset EmbeddedVTableLengthOffset() {
Mathieu Chartiere401d142015-04-22 13:56:20 -0700773 return MemberOffset(sizeof(Class));
Mingyao Yang2cdbad72014-07-16 10:44:41 -0700774 }
775
David Srbecky56de89a2018-10-01 15:32:20 +0100776 static constexpr MemberOffset ImtPtrOffset(PointerSize pointer_size) {
Artem Udovichenkoa62cb9b2016-06-30 09:18:25 +0000777 return MemberOffset(
Andreas Gampe542451c2016-07-26 09:02:02 -0700778 RoundUp(EmbeddedVTableLengthOffset().Uint32Value() + sizeof(uint32_t),
779 static_cast<size_t>(pointer_size)));
Artem Udovichenkoa62cb9b2016-06-30 09:18:25 +0000780 }
781
Vladimir Marko98db89c2018-09-07 11:45:46 +0100782 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700783 bool ShouldHaveImt() REQUIRES_SHARED(Locks::mutator_lock_) {
Vladimir Marko98db89c2018-09-07 11:45:46 +0100784 return ShouldHaveEmbeddedVTable<kVerifyFlags>();
Artem Udovichenkoa62cb9b2016-06-30 09:18:25 +0000785 }
786
Vladimir Marko98db89c2018-09-07 11:45:46 +0100787 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700788 bool ShouldHaveEmbeddedVTable() REQUIRES_SHARED(Locks::mutator_lock_) {
Vladimir Marko98db89c2018-09-07 11:45:46 +0100789 return IsInstantiable<kVerifyFlags>();
Mingyao Yang98d1cc82014-05-15 17:02:16 -0700790 }
791
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700792 bool HasVTable() REQUIRES_SHARED(Locks::mutator_lock_);
Mingyao Yang2cdbad72014-07-16 10:44:41 -0700793
Andreas Gampe542451c2016-07-26 09:02:02 -0700794 static MemberOffset EmbeddedVTableEntryOffset(uint32_t i, PointerSize pointer_size);
Mathieu Chartiere401d142015-04-22 13:56:20 -0700795
Vladimir Markodbcb48f2018-11-12 11:47:04 +0000796 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700797 int32_t GetVTableLength() REQUIRES_SHARED(Locks::mutator_lock_);
Mingyao Yang2cdbad72014-07-16 10:44:41 -0700798
Alexey Grebenkinbe4c2bd2018-02-01 19:09:59 +0300799 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags,
800 ReadBarrierOption kReadBarrierOption = kWithReadBarrier>
Andreas Gampe542451c2016-07-26 09:02:02 -0700801 ArtMethod* GetVTableEntry(uint32_t i, PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700802 REQUIRES_SHARED(Locks::mutator_lock_);
Mingyao Yang2cdbad72014-07-16 10:44:41 -0700803
Vladimir Marko98db89c2018-09-07 11:45:46 +0100804 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700805 int32_t GetEmbeddedVTableLength() REQUIRES_SHARED(Locks::mutator_lock_);
Mingyao Yang2cdbad72014-07-16 10:44:41 -0700806
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700807 void SetEmbeddedVTableLength(int32_t len) REQUIRES_SHARED(Locks::mutator_lock_);
Mingyao Yang2cdbad72014-07-16 10:44:41 -0700808
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700809 ImTable* GetImt(PointerSize pointer_size) REQUIRES_SHARED(Locks::mutator_lock_);
Artem Udovichenkoa62cb9b2016-06-30 09:18:25 +0000810
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700811 void SetImt(ImTable* imt, PointerSize pointer_size) REQUIRES_SHARED(Locks::mutator_lock_);
Artem Udovichenkoa62cb9b2016-06-30 09:18:25 +0000812
Andreas Gampe542451c2016-07-26 09:02:02 -0700813 ArtMethod* GetEmbeddedVTableEntry(uint32_t i, PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700814 REQUIRES_SHARED(Locks::mutator_lock_);
Mingyao Yang2cdbad72014-07-16 10:44:41 -0700815
Andreas Gampe542451c2016-07-26 09:02:02 -0700816 void SetEmbeddedVTableEntry(uint32_t i, ArtMethod* method, PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700817 REQUIRES_SHARED(Locks::mutator_lock_);
Mingyao Yang98d1cc82014-05-15 17:02:16 -0700818
Andreas Gampe542451c2016-07-26 09:02:02 -0700819 inline void SetEmbeddedVTableEntryUnchecked(uint32_t i,
820 ArtMethod* method,
821 PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700822 REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartiere401d142015-04-22 13:56:20 -0700823
Andreas Gampe542451c2016-07-26 09:02:02 -0700824 void PopulateEmbeddedVTable(PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700825 REQUIRES_SHARED(Locks::mutator_lock_);
Mingyao Yang98d1cc82014-05-15 17:02:16 -0700826
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800827 // Given a method implemented by this class but potentially from a super class, return the
828 // specific implementation method for this class.
Andreas Gampe542451c2016-07-26 09:02:02 -0700829 ArtMethod* FindVirtualMethodForVirtual(ArtMethod* method, PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700830 REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800831
832 // Given a method implemented by this class' super class, return the specific implementation
833 // method for this class.
Andreas Gampe542451c2016-07-26 09:02:02 -0700834 ArtMethod* FindVirtualMethodForSuper(ArtMethod* method, PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700835 REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800836
Alex Light705ad492015-09-21 11:36:30 -0700837 // Given a method from some implementor of this interface, return the specific implementation
838 // method for this class.
Andreas Gampe542451c2016-07-26 09:02:02 -0700839 ArtMethod* FindVirtualMethodForInterfaceSuper(ArtMethod* method, PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700840 REQUIRES_SHARED(Locks::mutator_lock_);
Alex Light705ad492015-09-21 11:36:30 -0700841
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800842 // Given a method implemented by this class, but potentially from a
843 // super class or interface, return the specific implementation
844 // method for this class.
Andreas Gampe542451c2016-07-26 09:02:02 -0700845 ArtMethod* FindVirtualMethodForInterface(ArtMethod* method, PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700846 REQUIRES_SHARED(Locks::mutator_lock_) ALWAYS_INLINE;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800847
Andreas Gampe542451c2016-07-26 09:02:02 -0700848 ArtMethod* FindVirtualMethodForVirtualOrInterface(ArtMethod* method, PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700849 REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogersd91d6d62013-09-25 20:26:14 -0700850
Vladimir Markoba118822017-06-12 15:41:56 +0100851 // Find a method with the given name and signature in an interface class.
852 //
853 // Search for the method declared in the class, then search for a method declared in any
854 // superinterface, then search the superclass java.lang.Object (implicitly declared methods
855 // in an interface without superinterfaces, see JLS 9.2, can be inherited, see JLS 9.4.1).
856 // TODO: Implement search for a unique maximally-specific non-abstract superinterface method.
857
Mathieu Chartier28bd2e42016-10-04 13:54:57 -0700858 ArtMethod* FindInterfaceMethod(const StringPiece& name,
859 const StringPiece& signature,
Andreas Gampe542451c2016-07-26 09:02:02 -0700860 PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700861 REQUIRES_SHARED(Locks::mutator_lock_);
Brian Carlstrom004644f2014-06-18 08:34:01 -0700862
Mathieu Chartier28bd2e42016-10-04 13:54:57 -0700863 ArtMethod* FindInterfaceMethod(const StringPiece& name,
864 const Signature& signature,
Andreas Gampe542451c2016-07-26 09:02:02 -0700865 PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700866 REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800867
Mathieu Chartier28bd2e42016-10-04 13:54:57 -0700868 ArtMethod* FindInterfaceMethod(ObjPtr<DexCache> dex_cache,
869 uint32_t dex_method_idx,
Andreas Gampe542451c2016-07-26 09:02:02 -0700870 PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700871 REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800872
Vladimir Markoba118822017-06-12 15:41:56 +0100873 // Find a method with the given name and signature in a non-interface class.
874 //
875 // Search for the method in the class, following the JLS rules which conflict with the RI
876 // in some cases. The JLS says that inherited methods are searched (JLS 15.12.2.1) and
877 // these can come from a superclass or a superinterface (JLS 8.4.8). We perform the
878 // following search:
879 // 1. Search the methods declared directly in the class. If we find a method with the
880 // given name and signature, return that method.
881 // 2. Search the methods declared in superclasses until we find a method with the given
882 // signature or complete the search in java.lang.Object. If we find a method with the
883 // given name and signature, check if it's been inherited by the class where we're
884 // performing the lookup (qualifying type). If it's inherited, return it. Otherwise,
885 // just remember the method and its declaring class and proceed to step 3.
886 // 3. Search "copied" methods (containing methods inherited from interfaces) in the class
887 // and its superclass chain. If we found a method in step 2 (which was not inherited,
888 // otherwise we would not be performing step 3), end the search when we reach its
889 // declaring class, otherwise search the entire superclass chain. If we find a method
890 // with the given name and signature, return that method.
891 // 4. Return the method found in step 2 if any (not inherited), or null.
892 //
893 // It's the responsibility of the caller to throw exceptions if the returned method (or null)
894 // does not satisfy the request. Special consideration should be given to the case where this
895 // function returns a method that's not inherited (found in step 2, returned in step 4).
896
897 ArtMethod* FindClassMethod(const StringPiece& name,
898 const StringPiece& signature,
899 PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700900 REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800901
Vladimir Markoba118822017-06-12 15:41:56 +0100902 ArtMethod* FindClassMethod(const StringPiece& name,
903 const Signature& signature,
904 PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700905 REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogersd91d6d62013-09-25 20:26:14 -0700906
Vladimir Markoba118822017-06-12 15:41:56 +0100907 ArtMethod* FindClassMethod(ObjPtr<DexCache> dex_cache,
908 uint32_t dex_method_idx,
909 PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700910 REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800911
Vladimir Markoba118822017-06-12 15:41:56 +0100912 ArtMethod* FindConstructor(const StringPiece& signature, PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700913 REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogersd91d6d62013-09-25 20:26:14 -0700914
Roland Levillaind32ead22018-05-30 17:38:21 +0100915 ArtMethod* FindDeclaredVirtualMethodByName(const StringPiece& name, PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700916 REQUIRES_SHARED(Locks::mutator_lock_);
Jeff Hao13e748b2015-08-25 20:44:19 +0000917
Roland Levillaind32ead22018-05-30 17:38:21 +0100918 ArtMethod* FindDeclaredDirectMethodByName(const StringPiece& name, PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700919 REQUIRES_SHARED(Locks::mutator_lock_);
Nicolas Geoffraya42363f2015-12-17 14:57:09 +0000920
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700921 ArtMethod* FindClassInitializer(PointerSize pointer_size) REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogersd91d6d62013-09-25 20:26:14 -0700922
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700923 bool HasDefaultMethods() REQUIRES_SHARED(Locks::mutator_lock_) {
Alex Lighteb7c1442015-08-31 13:17:42 -0700924 return (GetAccessFlags() & kAccHasDefaultMethod) != 0;
925 }
926
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700927 bool HasBeenRecursivelyInitialized() REQUIRES_SHARED(Locks::mutator_lock_) {
Alex Lighteb7c1442015-08-31 13:17:42 -0700928 return (GetAccessFlags() & kAccRecursivelyInitialized) != 0;
929 }
930
Vladimir Markodbcb48f2018-11-12 11:47:04 +0000931 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700932 ALWAYS_INLINE int32_t GetIfTableCount() REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800933
Mathieu Chartierfbc31082016-01-24 11:59:56 -0800934 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags,
935 ReadBarrierOption kReadBarrierOption = kWithReadBarrier>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700936 ALWAYS_INLINE IfTable* GetIfTable() REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800937
Mathieu Chartier28bd2e42016-10-04 13:54:57 -0700938 ALWAYS_INLINE void SetIfTable(ObjPtr<IfTable> new_iftable)
939 REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800940
941 // Get instance fields of the class (See also GetSFields).
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700942 LengthPrefixedArray<ArtField>* GetIFieldsPtr() REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800943
Mathieu Chartier54d220e2015-07-30 16:20:06 -0700944 ALWAYS_INLINE IterationRange<StrideIterator<ArtField>> GetIFields()
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700945 REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartier54d220e2015-07-30 16:20:06 -0700946
947 void SetIFieldsPtr(LengthPrefixedArray<ArtField>* new_ifields)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700948 REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800949
Mathieu Chartierc7853442015-03-27 14:35:38 -0700950 // Unchecked edition has no verification flags.
Mathieu Chartier54d220e2015-07-30 16:20:06 -0700951 void SetIFieldsPtrUnchecked(LengthPrefixedArray<ArtField>* new_sfields)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700952 REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800953
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700954 uint32_t NumInstanceFields() REQUIRES_SHARED(Locks::mutator_lock_);
955 ArtField* GetInstanceField(uint32_t i) REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800956
Mathieu Chartier66c2d2d2015-08-25 14:32:32 -0700957 // Returns the number of instance fields containing reference types. Does not count fields in any
958 // super classes.
Vladimir Marko98db89c2018-09-07 11:45:46 +0100959 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700960 uint32_t NumReferenceInstanceFields() REQUIRES_SHARED(Locks::mutator_lock_) {
Vladimir Marko98db89c2018-09-07 11:45:46 +0100961 DCHECK(IsResolved<kVerifyFlags>());
962 return GetField32<kVerifyFlags>(OFFSET_OF_OBJECT_MEMBER(Class, num_reference_instance_fields_));
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800963 }
964
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700965 uint32_t NumReferenceInstanceFieldsDuringLinking() REQUIRES_SHARED(Locks::mutator_lock_) {
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800966 DCHECK(IsLoaded() || IsErroneous());
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700967 return GetField32(OFFSET_OF_OBJECT_MEMBER(Class, num_reference_instance_fields_));
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800968 }
969
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700970 void SetNumReferenceInstanceFields(uint32_t new_num) REQUIRES_SHARED(Locks::mutator_lock_) {
Sebastien Hertzd2fe10a2014-01-15 10:20:56 +0100971 // Not called within a transaction.
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700972 SetField32<false>(OFFSET_OF_OBJECT_MEMBER(Class, num_reference_instance_fields_), new_num);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800973 }
974
Mathieu Chartier4e305412014-02-19 10:54:44 -0800975 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700976 uint32_t GetReferenceInstanceOffsets() ALWAYS_INLINE REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800977
978 void SetReferenceInstanceOffsets(uint32_t new_reference_offsets)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700979 REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800980
Vladimir Marko76649e82014-11-10 18:32:59 +0000981 // Get the offset of the first reference instance field. Other reference instance fields follow.
Hiroshi Yamauchi5496f692016-02-17 13:29:59 -0800982 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags,
983 ReadBarrierOption kReadBarrierOption = kWithReadBarrier>
Mathieu Chartiere401d142015-04-22 13:56:20 -0700984 MemberOffset GetFirstReferenceInstanceFieldOffset()
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700985 REQUIRES_SHARED(Locks::mutator_lock_);
Vladimir Marko76649e82014-11-10 18:32:59 +0000986
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800987 // Returns the number of static fields containing reference types.
Vladimir Marko98db89c2018-09-07 11:45:46 +0100988 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700989 uint32_t NumReferenceStaticFields() REQUIRES_SHARED(Locks::mutator_lock_) {
Vladimir Marko98db89c2018-09-07 11:45:46 +0100990 DCHECK(IsResolved<kVerifyFlags>());
991 return GetField32<kVerifyFlags>(OFFSET_OF_OBJECT_MEMBER(Class, num_reference_static_fields_));
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800992 }
993
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700994 uint32_t NumReferenceStaticFieldsDuringLinking() REQUIRES_SHARED(Locks::mutator_lock_) {
Mingyao Yang98d1cc82014-05-15 17:02:16 -0700995 DCHECK(IsLoaded() || IsErroneous() || IsRetired());
Ian Rogersb0fa5dc2014-04-28 16:47:08 -0700996 return GetField32(OFFSET_OF_OBJECT_MEMBER(Class, num_reference_static_fields_));
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800997 }
998
Andreas Gampebdf7f1c2016-08-30 16:38:47 -0700999 void SetNumReferenceStaticFields(uint32_t new_num) REQUIRES_SHARED(Locks::mutator_lock_) {
Sebastien Hertzd2fe10a2014-01-15 10:20:56 +01001000 // Not called within a transaction.
Ian Rogersb0fa5dc2014-04-28 16:47:08 -07001001 SetField32<false>(OFFSET_OF_OBJECT_MEMBER(Class, num_reference_static_fields_), new_num);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001002 }
1003
Vladimir Marko76649e82014-11-10 18:32:59 +00001004 // Get the offset of the first reference static field. Other reference static fields follow.
Vladimir Marko98db89c2018-09-07 11:45:46 +01001005 template <VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags>
Andreas Gampe542451c2016-07-26 09:02:02 -07001006 MemberOffset GetFirstReferenceStaticFieldOffset(PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001007 REQUIRES_SHARED(Locks::mutator_lock_);
Vladimir Marko76649e82014-11-10 18:32:59 +00001008
1009 // Get the offset of the first reference static field. Other reference static fields follow.
Andreas Gampe542451c2016-07-26 09:02:02 -07001010 MemberOffset GetFirstReferenceStaticFieldOffsetDuringLinking(PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001011 REQUIRES_SHARED(Locks::mutator_lock_);
Vladimir Marko76649e82014-11-10 18:32:59 +00001012
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001013 // Gets the static fields of the class.
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001014 LengthPrefixedArray<ArtField>* GetSFieldsPtr() REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartier54d220e2015-07-30 16:20:06 -07001015 ALWAYS_INLINE IterationRange<StrideIterator<ArtField>> GetSFields()
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001016 REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001017
Mathieu Chartier54d220e2015-07-30 16:20:06 -07001018 void SetSFieldsPtr(LengthPrefixedArray<ArtField>* new_sfields)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001019 REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001020
Mathieu Chartierc7853442015-03-27 14:35:38 -07001021 // Unchecked edition has no verification flags.
Mathieu Chartier54d220e2015-07-30 16:20:06 -07001022 void SetSFieldsPtrUnchecked(LengthPrefixedArray<ArtField>* new_sfields)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001023 REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartierc7853442015-03-27 14:35:38 -07001024
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001025 uint32_t NumStaticFields() REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001026
Ian Rogersef7d42f2014-01-06 12:55:46 -08001027 // TODO: uint16_t
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001028 ArtField* GetStaticField(uint32_t i) REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001029
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001030 // Find a static or instance field using the JLS resolution order
Vladimir Marko19a4d372016-12-08 14:41:46 +00001031 static ArtField* FindField(Thread* self,
1032 ObjPtr<Class> klass,
1033 const StringPiece& name,
Mathieu Chartierf8322842014-05-16 10:59:25 -07001034 const StringPiece& type)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001035 REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001036
1037 // Finds the given instance field in this class or a superclass.
Brian Carlstromea46f952013-07-30 01:26:50 -07001038 ArtField* FindInstanceField(const StringPiece& name, const StringPiece& type)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001039 REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001040
1041 // Finds the given instance field in this class or a superclass, only searches classes that
1042 // have the same dex cache.
Mathieu Chartier28bd2e42016-10-04 13:54:57 -07001043 ArtField* FindInstanceField(ObjPtr<DexCache> dex_cache, uint32_t dex_field_idx)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001044 REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001045
Brian Carlstromea46f952013-07-30 01:26:50 -07001046 ArtField* FindDeclaredInstanceField(const StringPiece& name, const StringPiece& type)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001047 REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001048
Mathieu Chartier28bd2e42016-10-04 13:54:57 -07001049 ArtField* FindDeclaredInstanceField(ObjPtr<DexCache> dex_cache, uint32_t dex_field_idx)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001050 REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001051
1052 // Finds the given static field in this class or a superclass.
Mathieu Chartier28bd2e42016-10-04 13:54:57 -07001053 static ArtField* FindStaticField(Thread* self,
Vladimir Marko19a4d372016-12-08 14:41:46 +00001054 ObjPtr<Class> klass,
Mathieu Chartier28bd2e42016-10-04 13:54:57 -07001055 const StringPiece& name,
Mathieu Chartierf8322842014-05-16 10:59:25 -07001056 const StringPiece& type)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001057 REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001058
1059 // Finds the given static field in this class or superclass, only searches classes that
1060 // have the same dex cache.
Vladimir Markobb268b12016-06-30 15:52:56 +01001061 static ArtField* FindStaticField(Thread* self,
Mathieu Chartier28bd2e42016-10-04 13:54:57 -07001062 ObjPtr<Class> klass,
1063 ObjPtr<DexCache> dex_cache,
Mathieu Chartierf8322842014-05-16 10:59:25 -07001064 uint32_t dex_field_idx)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001065 REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001066
Brian Carlstromea46f952013-07-30 01:26:50 -07001067 ArtField* FindDeclaredStaticField(const StringPiece& name, const StringPiece& type)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001068 REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001069
Mathieu Chartier28bd2e42016-10-04 13:54:57 -07001070 ArtField* FindDeclaredStaticField(ObjPtr<DexCache> dex_cache, uint32_t dex_field_idx)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001071 REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001072
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001073 pid_t GetClinitThreadId() REQUIRES_SHARED(Locks::mutator_lock_) {
David Sehr709b0702016-10-13 09:12:37 -07001074 DCHECK(IsIdxLoaded() || IsErroneous()) << PrettyClass();
Ian Rogersb0fa5dc2014-04-28 16:47:08 -07001075 return GetField32(OFFSET_OF_OBJECT_MEMBER(Class, clinit_thread_id_));
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001076 }
1077
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001078 void SetClinitThreadId(pid_t new_clinit_thread_id) REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001079
Alex Light4f2e9572017-03-16 13:13:31 -07001080 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags,
1081 ReadBarrierOption kReadBarrierOption = kWithReadBarrier>
Alex Lightd6251582016-10-31 11:12:30 -07001082 ClassExt* GetExtData() REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001083
Alex Light0273ad12016-11-02 11:19:31 -07001084 // Returns the ExtData for this class, allocating one if necessary. This should be the only way
1085 // to force ext_data_ to be set. No functions are available for changing an already set ext_data_
1086 // since doing so is not allowed.
1087 ClassExt* EnsureExtDataPresent(Thread* self)
1088 REQUIRES_SHARED(Locks::mutator_lock_) REQUIRES(!Roles::uninterruptible_);
1089
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001090 uint16_t GetDexClassDefIndex() REQUIRES_SHARED(Locks::mutator_lock_) {
Ian Rogersb0fa5dc2014-04-28 16:47:08 -07001091 return GetField32(OFFSET_OF_OBJECT_MEMBER(Class, dex_class_def_idx_));
Ian Rogers8b2c0b92013-09-19 02:56:49 -07001092 }
1093
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001094 void SetDexClassDefIndex(uint16_t class_def_idx) REQUIRES_SHARED(Locks::mutator_lock_) {
Chang Xing6d3e7682017-07-11 10:31:29 -07001095 SetField32Transaction(OFFSET_OF_OBJECT_MEMBER(Class, dex_class_def_idx_), class_def_idx);
Ian Rogers8b2c0b92013-09-19 02:56:49 -07001096 }
1097
Andreas Gampea5b09a62016-11-17 15:21:22 -08001098 dex::TypeIndex GetDexTypeIndex() REQUIRES_SHARED(Locks::mutator_lock_) {
1099 return dex::TypeIndex(
1100 static_cast<uint16_t>(GetField32(OFFSET_OF_OBJECT_MEMBER(Class, dex_type_idx_))));
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001101 }
1102
Andreas Gampea5b09a62016-11-17 15:21:22 -08001103 void SetDexTypeIndex(dex::TypeIndex type_idx) REQUIRES_SHARED(Locks::mutator_lock_) {
Chang Xing6d3e7682017-07-11 10:31:29 -07001104 SetField32Transaction(OFFSET_OF_OBJECT_MEMBER(Class, dex_type_idx_), type_idx.index_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001105 }
1106
Andreas Gampea5b09a62016-11-17 15:21:22 -08001107 dex::TypeIndex FindTypeIndexInOtherDexFile(const DexFile& dex_file)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001108 REQUIRES_SHARED(Locks::mutator_lock_);
Nicolas Geoffraye4084a52016-02-18 14:43:42 +00001109
Mathieu Chartiere401d142015-04-22 13:56:20 -07001110 // Visit native roots visits roots which are keyed off the native pointers such as ArtFields and
1111 // ArtMethods.
Hiroshi Yamauchi7a62e672016-06-10 17:22:48 -07001112 template<ReadBarrierOption kReadBarrierOption = kWithReadBarrier, class Visitor>
Andreas Gampe542451c2016-07-26 09:02:02 -07001113 void VisitNativeRoots(Visitor& visitor, PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001114 REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartierc7853442015-03-27 14:35:38 -07001115
Vladimir Marko7287c4d2018-02-15 10:41:07 +00001116 // Get one of the primitive classes.
1117 static ObjPtr<mirror::Class> GetPrimitiveClass(ObjPtr<mirror::String> name)
1118 REQUIRES_SHARED(Locks::mutator_lock_);
1119
Igor Murashkindf707e42016-02-02 16:56:50 -08001120 // When class is verified, set the kAccSkipAccessChecks flag on each method.
Andreas Gampe542451c2016-07-26 09:02:02 -07001121 void SetSkipAccessChecksFlagOnAllMethods(PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001122 REQUIRES_SHARED(Locks::mutator_lock_);
Sebastien Hertz233ea8e2013-06-06 11:57:09 +02001123
Ian Rogers1ff3c982014-08-12 02:30:58 -07001124 // Get the descriptor of the class. In a few cases a std::string is required, rather than
1125 // always create one the storage argument is populated and its internal c_str() returned. We do
1126 // this to avoid memory allocation in the common case.
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001127 const char* GetDescriptor(std::string* storage) REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers1ff3c982014-08-12 02:30:58 -07001128
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001129 const char* GetArrayDescriptor(std::string* storage) REQUIRES_SHARED(Locks::mutator_lock_);
Mingyao Yang98d1cc82014-05-15 17:02:16 -07001130
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001131 bool DescriptorEquals(const char* match) REQUIRES_SHARED(Locks::mutator_lock_);
Mingyao Yang98d1cc82014-05-15 17:02:16 -07001132
Andreas Gampe3f1dcd32018-12-28 09:39:56 -08001133 const dex::ClassDef* GetClassDef() REQUIRES_SHARED(Locks::mutator_lock_);
Mingyao Yang98d1cc82014-05-15 17:02:16 -07001134
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001135 ALWAYS_INLINE uint32_t NumDirectInterfaces() REQUIRES_SHARED(Locks::mutator_lock_);
Mingyao Yang98d1cc82014-05-15 17:02:16 -07001136
Andreas Gampea5b09a62016-11-17 15:21:22 -08001137 dex::TypeIndex GetDirectInterfaceTypeIdx(uint32_t idx) REQUIRES_SHARED(Locks::mutator_lock_);
Mingyao Yang98d1cc82014-05-15 17:02:16 -07001138
Vladimir Marko19a4d372016-12-08 14:41:46 +00001139 // Get the direct interface of the `klass` at index `idx` if resolved, otherwise return null.
1140 // If the caller expects the interface to be resolved, for example for a resolved `klass`,
1141 // that assumption should be checked by `DCHECK(result != nullptr)`.
1142 static ObjPtr<Class> GetDirectInterface(Thread* self, ObjPtr<Class> klass, uint32_t idx)
1143 REQUIRES_SHARED(Locks::mutator_lock_);
1144
1145 // Resolve and get the direct interface of the `klass` at index `idx`.
1146 // Returns null with a pending exception if the resolution fails.
1147 static ObjPtr<Class> ResolveDirectInterface(Thread* self, Handle<Class> klass, uint32_t idx)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001148 REQUIRES_SHARED(Locks::mutator_lock_);
Mingyao Yang98d1cc82014-05-15 17:02:16 -07001149
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001150 const char* GetSourceFile() REQUIRES_SHARED(Locks::mutator_lock_);
Mingyao Yang98d1cc82014-05-15 17:02:16 -07001151
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001152 std::string GetLocation() REQUIRES_SHARED(Locks::mutator_lock_);
Mingyao Yang98d1cc82014-05-15 17:02:16 -07001153
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001154 const DexFile& GetDexFile() REQUIRES_SHARED(Locks::mutator_lock_);
Mingyao Yang98d1cc82014-05-15 17:02:16 -07001155
Andreas Gampe3f1dcd32018-12-28 09:39:56 -08001156 const dex::TypeList* GetInterfaceTypeList() REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartierf8322842014-05-16 10:59:25 -07001157
Sebastien Hertz4e99b3d2014-06-24 14:35:40 +02001158 // Asserts we are initialized or initializing in the given thread.
1159 void AssertInitializedOrInitializingInThread(Thread* self)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001160 REQUIRES_SHARED(Locks::mutator_lock_);
Sebastien Hertz4e99b3d2014-06-24 14:35:40 +02001161
Roland Levillaind32ead22018-05-30 17:38:21 +01001162 Class* CopyOf(Thread* self, int32_t new_length, ImTable* imt, PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001163 REQUIRES_SHARED(Locks::mutator_lock_) REQUIRES(!Roles::uninterruptible_);
Mingyao Yang98d1cc82014-05-15 17:02:16 -07001164
Nicolas Geoffraya7a47592015-11-24 09:17:30 +00001165 // For proxy class only.
Narayan Kamath6b2dc312017-03-14 13:26:12 +00001166 ObjectArray<Class>* GetProxyInterfaces() REQUIRES_SHARED(Locks::mutator_lock_);
Mingyao Yang98d1cc82014-05-15 17:02:16 -07001167
Nicolas Geoffraya7a47592015-11-24 09:17:30 +00001168 // For proxy class only.
Narayan Kamath6b2dc312017-03-14 13:26:12 +00001169 ObjectArray<ObjectArray<Class>>* GetProxyThrows() REQUIRES_SHARED(Locks::mutator_lock_);
Mingyao Yang98d1cc82014-05-15 17:02:16 -07001170
Mathieu Chartierfc58af42015-04-16 18:00:39 -07001171 // May cause thread suspension due to EqualParameters.
Mathieu Chartier28bd2e42016-10-04 13:54:57 -07001172 ArtMethod* GetDeclaredConstructor(Thread* self,
1173 Handle<ObjectArray<Class>> args,
1174 PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001175 REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartierfc58af42015-04-16 18:00:39 -07001176
Andreas Gampe715fdc22016-04-18 17:07:30 -07001177 static int32_t GetInnerClassFlags(Handle<Class> h_this, int32_t default_value)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001178 REQUIRES_SHARED(Locks::mutator_lock_);
Andreas Gampe715fdc22016-04-18 17:07:30 -07001179
Mingyao Yang98d1cc82014-05-15 17:02:16 -07001180 // Used to initialize a class in the allocation code path to ensure it is guarded by a StoreStore
1181 // fence.
1182 class InitializeClassVisitor {
1183 public:
1184 explicit InitializeClassVisitor(uint32_t class_size) : class_size_(class_size) {
1185 }
1186
Mathieu Chartier28bd2e42016-10-04 13:54:57 -07001187 void operator()(ObjPtr<Object> obj, size_t usable_size) const
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001188 REQUIRES_SHARED(Locks::mutator_lock_);
Mingyao Yang98d1cc82014-05-15 17:02:16 -07001189
1190 private:
1191 const uint32_t class_size_;
1192
1193 DISALLOW_COPY_AND_ASSIGN(InitializeClassVisitor);
1194 };
1195
Sebastien Hertz6963e442014-11-26 22:11:27 +01001196 // Returns true if the class loader is null, ie the class loader is the boot strap class loader.
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001197 bool IsBootStrapClassLoaded() REQUIRES_SHARED(Locks::mutator_lock_) {
Vladimir Markodbcb48f2018-11-12 11:47:04 +00001198 // No read barrier is needed for comparing with null.
1199 return GetClassLoader<kDefaultVerifyFlags, kWithoutReadBarrier>() == nullptr;
Sebastien Hertz6963e442014-11-26 22:11:27 +01001200 }
1201
Andreas Gampe542451c2016-07-26 09:02:02 -07001202 static size_t ImTableEntrySize(PointerSize pointer_size) {
1203 return static_cast<size_t>(pointer_size);
Mathieu Chartiere401d142015-04-22 13:56:20 -07001204 }
1205
Andreas Gampe542451c2016-07-26 09:02:02 -07001206 static size_t VTableEntrySize(PointerSize pointer_size) {
1207 return static_cast<size_t>(pointer_size);
Mathieu Chartiere401d142015-04-22 13:56:20 -07001208 }
1209
Andreas Gampe542451c2016-07-26 09:02:02 -07001210 ALWAYS_INLINE ArraySlice<ArtMethod> GetDirectMethodsSliceUnchecked(PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001211 REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartiere401d142015-04-22 13:56:20 -07001212
Andreas Gampe542451c2016-07-26 09:02:02 -07001213 ALWAYS_INLINE ArraySlice<ArtMethod> GetVirtualMethodsSliceUnchecked(PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001214 REQUIRES_SHARED(Locks::mutator_lock_);
Alex Lighte64300b2015-12-15 15:02:47 -08001215
Andreas Gampe542451c2016-07-26 09:02:02 -07001216 ALWAYS_INLINE ArraySlice<ArtMethod> GetDeclaredMethodsSliceUnchecked(PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001217 REQUIRES_SHARED(Locks::mutator_lock_);
Alex Lighte64300b2015-12-15 15:02:47 -08001218
Andreas Gampe542451c2016-07-26 09:02:02 -07001219 ALWAYS_INLINE ArraySlice<ArtMethod> GetDeclaredVirtualMethodsSliceUnchecked(
1220 PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001221 REQUIRES_SHARED(Locks::mutator_lock_);
Alex Lighte64300b2015-12-15 15:02:47 -08001222
Andreas Gampe542451c2016-07-26 09:02:02 -07001223 ALWAYS_INLINE ArraySlice<ArtMethod> GetCopiedMethodsSliceUnchecked(PointerSize pointer_size)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001224 REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartiere401d142015-04-22 13:56:20 -07001225
David Sehr709b0702016-10-13 09:12:37 -07001226 static std::string PrettyDescriptor(ObjPtr<mirror::Class> klass)
1227 REQUIRES_SHARED(Locks::mutator_lock_);
1228 std::string PrettyDescriptor()
1229 REQUIRES_SHARED(Locks::mutator_lock_);
1230 // Returns a human-readable form of the name of the given class.
1231 // Given String.class, the output would be "java.lang.Class<java.lang.String>".
1232 static std::string PrettyClass(ObjPtr<mirror::Class> c)
1233 REQUIRES_SHARED(Locks::mutator_lock_);
1234 std::string PrettyClass()
1235 REQUIRES_SHARED(Locks::mutator_lock_);
1236 // Returns a human-readable form of the name of the given class with its class loader.
1237 static std::string PrettyClassAndClassLoader(ObjPtr<mirror::Class> c)
1238 REQUIRES_SHARED(Locks::mutator_lock_);
1239 std::string PrettyClassAndClassLoader()
1240 REQUIRES_SHARED(Locks::mutator_lock_);
1241
Mathieu Chartier4b00d342015-11-13 10:42:08 -08001242 // Fix up all of the native pointers in the class by running them through the visitor. Only sets
1243 // the corresponding entry in dest if visitor(obj) != obj to prevent dirty memory. Dest should be
Mathieu Chartierfbc31082016-01-24 11:59:56 -08001244 // initialized to a copy of *this to prevent issues. Does not visit the ArtMethod and ArtField
1245 // roots.
Vladimir Marko924ad502018-09-19 09:48:04 +01001246 template <VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags, typename Visitor>
Mathieu Chartier28bd2e42016-10-04 13:54:57 -07001247 void FixupNativePointers(Class* dest, PointerSize pointer_size, const Visitor& visitor)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001248 REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartier4b00d342015-11-13 10:42:08 -08001249
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001250 private:
Vladimir Marko924ad502018-09-19 09:48:04 +01001251 template <typename T, VerifyObjectFlags kVerifyFlags, typename Visitor>
1252 void FixupNativePointer(
1253 Class* dest, PointerSize pointer_size, const Visitor& visitor, MemberOffset member_offset)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001254 REQUIRES_SHARED(Locks::mutator_lock_);
Alex Lighte64300b2015-12-15 15:02:47 -08001255
Mathieu Chartier2466d622017-09-26 13:52:26 -07001256 ALWAYS_INLINE static ArraySlice<ArtMethod> GetMethodsSliceRangeUnchecked(
1257 LengthPrefixedArray<ArtMethod>* methods,
1258 PointerSize pointer_size,
1259 uint32_t start_offset,
1260 uint32_t end_offset)
Vladimir Marko9ac77492017-06-14 18:07:03 +01001261 REQUIRES_SHARED(Locks::mutator_lock_);
1262
Vladimir Markof79aa7f2017-07-04 16:58:55 +01001263 template <bool throw_on_failure>
Mathieu Chartierb8901302016-09-30 10:27:43 -07001264 bool ResolvedFieldAccessTest(ObjPtr<Class> access_to,
Mathieu Chartier3398c782016-09-30 10:27:43 -07001265 ArtField* field,
Vladimir Markof79aa7f2017-07-04 16:58:55 +01001266 ObjPtr<DexCache> dex_cache,
1267 uint32_t field_idx)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001268 REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartierb8901302016-09-30 10:27:43 -07001269
Vladimir Markof79aa7f2017-07-04 16:58:55 +01001270 template <bool throw_on_failure>
Mathieu Chartierb8901302016-09-30 10:27:43 -07001271 bool ResolvedMethodAccessTest(ObjPtr<Class> access_to,
1272 ArtMethod* resolved_method,
Vladimir Markof79aa7f2017-07-04 16:58:55 +01001273 ObjPtr<DexCache> dex_cache,
Mathieu Chartierb8901302016-09-30 10:27:43 -07001274 uint32_t method_idx,
Vladimir Markof79aa7f2017-07-04 16:58:55 +01001275 InvokeType throw_invoke_type)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001276 REQUIRES_SHARED(Locks::mutator_lock_);
Vladimir Marko89786432014-01-31 15:03:55 +00001277
Mathieu Chartier28bd2e42016-10-04 13:54:57 -07001278 bool Implements(ObjPtr<Class> klass) REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartier3398c782016-09-30 10:27:43 -07001279 bool IsArrayAssignableFromArray(ObjPtr<Class> klass) REQUIRES_SHARED(Locks::mutator_lock_);
1280 bool IsAssignableFromArray(ObjPtr<Class> klass) REQUIRES_SHARED(Locks::mutator_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001281
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001282 void CheckObjectAlloc() REQUIRES_SHARED(Locks::mutator_lock_);
Hiroshi Yamauchi3b4c1892013-09-12 21:33:12 -07001283
Mathieu Chartierc7853442015-03-27 14:35:38 -07001284 // Unchecked editions is for root visiting.
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001285 LengthPrefixedArray<ArtField>* GetSFieldsPtrUnchecked() REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartier54d220e2015-07-30 16:20:06 -07001286 IterationRange<StrideIterator<ArtField>> GetSFieldsUnchecked()
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001287 REQUIRES_SHARED(Locks::mutator_lock_);
1288 LengthPrefixedArray<ArtField>* GetIFieldsPtrUnchecked() REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartier54d220e2015-07-30 16:20:06 -07001289 IterationRange<StrideIterator<ArtField>> GetIFieldsUnchecked()
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001290 REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartierc7853442015-03-27 14:35:38 -07001291
Alex Lighte64300b2015-12-15 15:02:47 -08001292 // The index in the methods_ array where the first declared virtual method is.
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001293 ALWAYS_INLINE uint32_t GetVirtualMethodsStartOffset() REQUIRES_SHARED(Locks::mutator_lock_);
Alex Lighte64300b2015-12-15 15:02:47 -08001294
1295 // The index in the methods_ array where the first direct method is.
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001296 ALWAYS_INLINE uint32_t GetDirectMethodsStartOffset() REQUIRES_SHARED(Locks::mutator_lock_);
Alex Lighte64300b2015-12-15 15:02:47 -08001297
1298 // The index in the methods_ array where the first copied method is.
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001299 ALWAYS_INLINE uint32_t GetCopiedMethodsStartOffset() REQUIRES_SHARED(Locks::mutator_lock_);
Alex Lighte64300b2015-12-15 15:02:47 -08001300
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001301 bool ProxyDescriptorEquals(const char* match) REQUIRES_SHARED(Locks::mutator_lock_);
Vladimir Marko3481ba22015-04-13 12:22:36 +01001302
Andreas Gampe90b936d2017-01-31 08:58:55 -08001303 template<VerifyObjectFlags kVerifyFlags>
1304 void GetAccessFlagsDCheck() REQUIRES_SHARED(Locks::mutator_lock_);
1305
Andreas Gampe62f6e902018-10-11 18:58:50 -07001306 void SetAccessFlagsDCheck(uint32_t new_access_flags) REQUIRES_SHARED(Locks::mutator_lock_);
1307
Roland Levillain0d5a2812015-11-13 10:07:31 +00001308 // Check that the pointer size matches the one in the class linker.
Andreas Gampe542451c2016-07-26 09:02:02 -07001309 ALWAYS_INLINE static void CheckPointerSize(PointerSize pointer_size);
1310
1311 static MemberOffset EmbeddedVTableOffset(PointerSize pointer_size);
Mathieu Chartierfbc31082016-01-24 11:59:56 -08001312 template <bool kVisitNativeRoots,
1313 VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags,
1314 ReadBarrierOption kReadBarrierOption = kWithReadBarrier,
1315 typename Visitor>
Mathieu Chartier28bd2e42016-10-04 13:54:57 -07001316 void VisitReferences(ObjPtr<Class> klass, const Visitor& visitor)
Andreas Gampebdf7f1c2016-08-30 16:38:47 -07001317 REQUIRES_SHARED(Locks::mutator_lock_);
Mathieu Chartier059ef3d2015-08-18 13:54:21 -07001318
Alex Lighte64300b2015-12-15 15:02:47 -08001319 // 'Class' Object Fields
1320 // Order governed by java field ordering. See art::ClassLinker::LinkFields.
1321
Mathieu Chartier2cebb242015-04-21 16:50:40 -07001322 // Defining class loader, or null for the "bootstrap" system loader.
Ian Rogersef7d42f2014-01-06 12:55:46 -08001323 HeapReference<ClassLoader> class_loader_;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001324
1325 // For array classes, the component class object for instanceof/checkcast
Mathieu Chartier2cebb242015-04-21 16:50:40 -07001326 // (for String[][][], this will be String[][]). null for non-array classes.
Ian Rogersef7d42f2014-01-06 12:55:46 -08001327 HeapReference<Class> component_type_;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001328
Mathieu Chartier2cebb242015-04-21 16:50:40 -07001329 // DexCache of resolved constant pool entries (will be null for classes generated by the
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001330 // runtime such as arrays and primitive classes).
Ian Rogersef7d42f2014-01-06 12:55:46 -08001331 HeapReference<DexCache> dex_cache_;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001332
Alex Lightd6251582016-10-31 11:12:30 -07001333 // Extraneous class data that is not always needed. This field is allocated lazily and may
1334 // only be set with 'this' locked. This is synchronized on 'this'.
1335 // TODO(allight) We should probably synchronize it on something external or handle allocation in
1336 // some other (safe) way to prevent possible deadlocks.
1337 HeapReference<ClassExt> ext_data_;
1338
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001339 // The interface table (iftable_) contains pairs of a interface class and an array of the
1340 // interface methods. There is one pair per interface supported by this class. That means one
1341 // pair for each interface we support directly, indirectly via superclass, or indirectly via a
1342 // superinterface. This will be null if neither we nor our superclass implement any interfaces.
1343 //
1344 // Why we need this: given "class Foo implements Face", declare "Face faceObj = new Foo()".
1345 // Invoke faceObj.blah(), where "blah" is part of the Face interface. We can't easily use a
1346 // single vtable.
1347 //
1348 // For every interface a concrete class implements, we create an array of the concrete vtable_
1349 // methods for the methods in the interface.
Ian Rogersef7d42f2014-01-06 12:55:46 -08001350 HeapReference<IfTable> iftable_;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001351
Ian Rogersef7d42f2014-01-06 12:55:46 -08001352 // Descriptor for the class such as "java.lang.Class" or "[C". Lazily initialized by ComputeName
1353 HeapReference<String> name_;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001354
Brian Carlstrom08ac9222015-05-22 13:43:00 -07001355 // The superclass, or null if this is java.lang.Object or a primitive type.
1356 //
1357 // Note that interfaces have java.lang.Object as their
1358 // superclass. This doesn't match the expectations in JNI
1359 // GetSuperClass or java.lang.Class.getSuperClass() which need to
1360 // check for interfaces and return null.
Ian Rogersef7d42f2014-01-06 12:55:46 -08001361 HeapReference<Class> super_class_;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001362
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001363 // Virtual method table (vtable), for use by "invoke-virtual". The vtable from the superclass is
1364 // copied in, and virtual methods from our class either replace those from the super or are
1365 // appended. For abstract classes, methods may be created in the vtable that aren't in
1366 // virtual_ methods_ for miranda methods.
Mathieu Chartiere401d142015-04-22 13:56:20 -07001367 HeapReference<PointerArray> vtable_;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001368
Mathieu Chartierc7853442015-03-27 14:35:38 -07001369 // instance fields
1370 //
1371 // These describe the layout of the contents of an Object.
1372 // Note that only the fields directly declared by this class are
1373 // listed in ifields; fields declared by a superclass are listed in
1374 // the superclass's Class.ifields.
1375 //
Mathieu Chartierc0fe56a2015-08-11 13:01:23 -07001376 // ArtFields are allocated as a length prefixed ArtField array, and not an array of pointers to
1377 // ArtFields.
Mathieu Chartierc7853442015-03-27 14:35:38 -07001378 uint64_t ifields_;
1379
Alex Lighte64300b2015-12-15 15:02:47 -08001380 // Pointer to an ArtMethod length-prefixed array. All the methods where this class is the place
1381 // where they are logically defined. This includes all private, static, final and virtual methods
1382 // as well as inherited default methods and miranda methods.
1383 //
1384 // The slice methods_ [0, virtual_methods_offset_) are the direct (static, private, init) methods
1385 // declared by this class.
1386 //
1387 // The slice methods_ [virtual_methods_offset_, copied_methods_offset_) are the virtual methods
1388 // declared by this class.
1389 //
1390 // The slice methods_ [copied_methods_offset_, |methods_|) are the methods that are copied from
1391 // interfaces such as miranda or default methods. These are copied for resolution purposes as this
1392 // class is where they are (logically) declared as far as the virtual dispatch is concerned.
David Srbecky9b3607d2016-01-14 18:15:54 +00001393 //
1394 // Note that this field is used by the native debugger as the unique identifier for the type.
Alex Lighte64300b2015-12-15 15:02:47 -08001395 uint64_t methods_;
1396
Mathieu Chartier54d220e2015-07-30 16:20:06 -07001397 // Static fields length-prefixed array.
Mathieu Chartierc7853442015-03-27 14:35:38 -07001398 uint64_t sfields_;
1399
Neil Fuller3d0aa882016-08-16 19:53:07 +01001400 // Access flags; low 16 bits are defined by VM spec.
1401 uint32_t access_flags_;
1402
Mathieu Chartier52a7f5c2015-08-18 18:35:52 -07001403 // Class flags to help speed up visiting object references.
1404 uint32_t class_flags_;
1405
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001406 // Total size of the Class instance; used when allocating storage on gc heap.
1407 // See also object_size_.
Ian Rogersef7d42f2014-01-06 12:55:46 -08001408 uint32_t class_size_;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001409
Ian Rogers8b2c0b92013-09-19 02:56:49 -07001410 // Tid used to check for recursive <clinit> invocation.
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001411 pid_t clinit_thread_id_;
Roland Levillain66c74592018-10-03 19:12:45 +01001412 static_assert(sizeof(pid_t) == sizeof(int32_t), "java.lang.Class.clinitThreadId size check");
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001413
Ian Rogers8b2c0b92013-09-19 02:56:49 -07001414 // ClassDef index in dex file, -1 if no class definition such as an array.
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001415 // TODO: really 16bits
Ian Rogers8b2c0b92013-09-19 02:56:49 -07001416 int32_t dex_class_def_idx_;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001417
Ian Rogers8b2c0b92013-09-19 02:56:49 -07001418 // Type index in dex file.
1419 // TODO: really 16bits
1420 int32_t dex_type_idx_;
1421
1422 // Number of instance fields that are object refs.
Ian Rogersef7d42f2014-01-06 12:55:46 -08001423 uint32_t num_reference_instance_fields_;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001424
Ian Rogers8b2c0b92013-09-19 02:56:49 -07001425 // Number of static fields that are object refs,
Ian Rogersef7d42f2014-01-06 12:55:46 -08001426 uint32_t num_reference_static_fields_;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001427
1428 // Total object size; used when allocating storage on gc heap.
1429 // (For interfaces and abstract classes this will be zero.)
1430 // See also class_size_.
Ian Rogersef7d42f2014-01-06 12:55:46 -08001431 uint32_t object_size_;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001432
Mathieu Chartier161db1d2016-09-01 14:06:54 -07001433 // Aligned object size for allocation fast path. The value is max uint32_t if the object is
Mathieu Chartier93bbee02016-08-31 09:38:40 -07001434 // uninitialized or finalizable. Not currently used for variable sized objects.
1435 uint32_t object_size_alloc_fast_path_;
1436
Hiroshi Yamauchif0edfc32014-09-25 11:46:46 -07001437 // The lower 16 bits contains a Primitive::Type value. The upper 16
1438 // bits contains the size shift of the primitive type.
1439 uint32_t primitive_type_;
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001440
1441 // Bitmap of offsets of ifields.
1442 uint32_t reference_instance_offsets_;
1443
Igor Murashkin86083f72017-10-27 10:59:04 -07001444 // See the real definition in subtype_check_bits_and_status.h
1445 // typeof(status_) is actually SubtypeCheckBitsAndStatus.
1446 uint32_t status_;
Igor Murashkincf83aaa2017-09-08 03:21:54 +00001447
Alex Lighte64300b2015-12-15 15:02:47 -08001448 // The offset of the first virtual method that is copied from an interface. This includes miranda,
1449 // default, and default-conflict methods. Having a hard limit of ((2 << 16) - 1) for methods
1450 // defined on a single class is well established in Java so we will use only uint16_t's here.
1451 uint16_t copied_methods_offset_;
1452
1453 // The offset of the first declared virtual methods in the methods_ array.
1454 uint16_t virtual_methods_offset_;
1455
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001456 // TODO: ?
1457 // initiating class loader list
1458 // NOTE: for classes with low serialNumber, these are unused, and the
1459 // values are kept in a table in gDvm.
1460 // InitiatingLoaderList initiating_loader_list_;
1461
Mingyao Yang98d1cc82014-05-15 17:02:16 -07001462 // The following data exist in real class objects.
1463 // Embedded Imtable, for class object that's not an interface, fixed size.
Ian Rogers03b6eaf2014-10-28 09:34:57 -07001464 // ImTableEntry embedded_imtable_[0];
Mingyao Yang98d1cc82014-05-15 17:02:16 -07001465 // Embedded Vtable, for class object that's not an interface, variable size.
Ian Rogers03b6eaf2014-10-28 09:34:57 -07001466 // VTableEntry embedded_vtable_[0];
Mingyao Yang98d1cc82014-05-15 17:02:16 -07001467 // Static fields, variable size.
Ian Rogers03b6eaf2014-10-28 09:34:57 -07001468 // uint32_t fields_[0];
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001469
Mathieu Chartier279ac5c2016-09-08 17:34:25 -07001470 ART_FRIEND_TEST(DexCacheTest, TestResolvedFieldAccess); // For ResolvedFieldAccessTest
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001471 friend struct art::ClassOffsets; // for verifying offset information
Mathieu Chartier059ef3d2015-08-18 13:54:21 -07001472 friend class Object; // For VisitReferences
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001473 DISALLOW_IMPLICIT_CONSTRUCTORS(Class);
1474};
1475
Ian Rogers2dd0e2c2013-01-24 12:42:14 -08001476} // namespace mirror
1477} // namespace art
1478
Brian Carlstromfc0e3212013-07-17 14:40:12 -07001479#endif // ART_RUNTIME_MIRROR_CLASS_H_