class.h revision 94f7b49578b6aaa80de8ffed230648d601393905
1/* 2 * Copyright (C) 2011 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17#ifndef ART_RUNTIME_MIRROR_CLASS_H_ 18#define ART_RUNTIME_MIRROR_CLASS_H_ 19 20#include "dex_file.h" 21#include "gc_root.h" 22#include "gc/allocator_type.h" 23#include "invoke_type.h" 24#include "modifiers.h" 25#include "object.h" 26#include "object_array.h" 27#include "object_callbacks.h" 28#include "primitive.h" 29#include "read_barrier_option.h" 30 31/* 32 * A magic value for refOffsets. Ignore the bits and walk the super 33 * chain when this is the value. 34 * [This is an unlikely "natural" value, since it would be 30 non-ref instance 35 * fields followed by 2 ref instance fields.] 36 */ 37#define CLASS_WALK_SUPER 3U 38#define CLASS_BITS_PER_WORD (sizeof(uint32_t) * 8) 39#define CLASS_OFFSET_ALIGNMENT 4 40#define CLASS_HIGH_BIT (1U << (CLASS_BITS_PER_WORD - 1)) 41/* 42 * Given an offset, return the bit number which would encode that offset. 43 * Local use only. 44 */ 45#define _CLASS_BIT_NUMBER_FROM_OFFSET(byteOffset) \ 46 ((unsigned int)(byteOffset) / \ 47 CLASS_OFFSET_ALIGNMENT) 48/* 49 * Is the given offset too large to be encoded? 50 */ 51#define CLASS_CAN_ENCODE_OFFSET(byteOffset) \ 52 (_CLASS_BIT_NUMBER_FROM_OFFSET(byteOffset) < CLASS_BITS_PER_WORD) 53/* 54 * Return a single bit, encoding the offset. 55 * Undefined if the offset is too large, as defined above. 56 */ 57#define CLASS_BIT_FROM_OFFSET(byteOffset) \ 58 (CLASS_HIGH_BIT >> _CLASS_BIT_NUMBER_FROM_OFFSET(byteOffset)) 59/* 60 * Return an offset, given a bit number as returned from CLZ. 61 */ 62#define CLASS_OFFSET_FROM_CLZ(rshift) \ 63 MemberOffset((static_cast<int>(rshift) * CLASS_OFFSET_ALIGNMENT)) 64 65namespace art { 66 67struct ClassOffsets; 68class Signature; 69class StringPiece; 70 71namespace mirror { 72 73class ArtField; 74class ArtMethod; 75class ClassLoader; 76class DexCache; 77class IfTable; 78 79// C++ mirror of java.lang.Class 80class MANAGED Class FINAL : public Object { 81 public: 82 // Interface method table size. Increasing this value reduces the chance of two interface methods 83 // colliding in the interface method table but increases the size of classes that implement 84 // (non-marker) interfaces. 85 static constexpr size_t kImtSize = 64; 86 87 // imtable entry embedded in class object. 88 struct MANAGED ImTableEntry { 89 HeapReference<ArtMethod> method; 90 }; 91 92 // vtable entry embedded in class object. 93 struct MANAGED VTableEntry { 94 HeapReference<ArtMethod> method; 95 }; 96 97 // Class Status 98 // 99 // kStatusNotReady: If a Class cannot be found in the class table by 100 // FindClass, it allocates an new one with AllocClass in the 101 // kStatusNotReady and calls LoadClass. Note if it does find a 102 // class, it may not be kStatusResolved and it will try to push it 103 // forward toward kStatusResolved. 104 // 105 // kStatusIdx: LoadClass populates with Class with information from 106 // the DexFile, moving the status to kStatusIdx, indicating that the 107 // Class value in super_class_ has not been populated. The new Class 108 // can then be inserted into the classes table. 109 // 110 // kStatusLoaded: After taking a lock on Class, the ClassLinker will 111 // attempt to move a kStatusIdx class forward to kStatusLoaded by 112 // using ResolveClass to initialize the super_class_ and ensuring the 113 // interfaces are resolved. 114 // 115 // kStatusResolving: Class is just cloned with the right size from 116 // temporary class that's acting as a placeholder for linking. The old 117 // class will be retired. New class is set to this status first before 118 // moving on to being resolved. 119 // 120 // kStatusResolved: Still holding the lock on Class, the ClassLinker 121 // shows linking is complete and fields of the Class populated by making 122 // it kStatusResolved. Java allows circularities of the form where a super 123 // class has a field that is of the type of the sub class. We need to be able 124 // to fully resolve super classes while resolving types for fields. 125 // 126 // kStatusRetryVerificationAtRuntime: The verifier sets a class to 127 // this state if it encounters a soft failure at compile time. This 128 // often happens when there are unresolved classes in other dex 129 // files, and this status marks a class as needing to be verified 130 // again at runtime. 131 // 132 // TODO: Explain the other states 133 enum Status { 134 kStatusRetired = -2, 135 kStatusError = -1, 136 kStatusNotReady = 0, 137 kStatusIdx = 1, // Loaded, DEX idx in super_class_type_idx_ and interfaces_type_idx_. 138 kStatusLoaded = 2, // DEX idx values resolved. 139 kStatusResolving = 3, // Just cloned from temporary class object. 140 kStatusResolved = 4, // Part of linking. 141 kStatusVerifying = 5, // In the process of being verified. 142 kStatusRetryVerificationAtRuntime = 6, // Compile time verification failed, retry at runtime. 143 kStatusVerifyingAtRuntime = 7, // Retrying verification at runtime. 144 kStatusVerified = 8, // Logically part of linking; done pre-init. 145 kStatusInitializing = 9, // Class init in progress. 146 kStatusInitialized = 10, // Ready to go. 147 kStatusMax = 11, 148 }; 149 150 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 151 Status GetStatus() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 152 COMPILE_ASSERT(sizeof(Status) == sizeof(uint32_t), size_of_status_not_uint32); 153 return static_cast<Status>( 154 GetField32Volatile<kVerifyFlags>(OFFSET_OF_OBJECT_MEMBER(Class, status_))); 155 } 156 157 void SetStatus(Status new_status, Thread* self) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 158 159 static MemberOffset StatusOffset() { 160 return OFFSET_OF_OBJECT_MEMBER(Class, status_); 161 } 162 163 // Returns true if the class has been retired. 164 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 165 bool IsRetired() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 166 return GetStatus<kVerifyFlags>() == kStatusRetired; 167 } 168 169 // Returns true if the class has failed to link. 170 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 171 bool IsErroneous() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 172 return GetStatus<kVerifyFlags>() == kStatusError; 173 } 174 175 // Returns true if the class has been loaded. 176 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 177 bool IsIdxLoaded() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 178 return GetStatus<kVerifyFlags>() >= kStatusIdx; 179 } 180 181 // Returns true if the class has been loaded. 182 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 183 bool IsLoaded() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 184 return GetStatus<kVerifyFlags>() >= kStatusLoaded; 185 } 186 187 // Returns true if the class has been linked. 188 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 189 bool IsResolved() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 190 return GetStatus<kVerifyFlags>() >= kStatusResolved; 191 } 192 193 // Returns true if the class was compile-time verified. 194 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 195 bool IsCompileTimeVerified() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 196 return GetStatus<kVerifyFlags>() >= kStatusRetryVerificationAtRuntime; 197 } 198 199 // Returns true if the class has been verified. 200 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 201 bool IsVerified() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 202 return GetStatus<kVerifyFlags>() >= kStatusVerified; 203 } 204 205 // Returns true if the class is initializing. 206 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 207 bool IsInitializing() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 208 return GetStatus<kVerifyFlags>() >= kStatusInitializing; 209 } 210 211 // Returns true if the class is initialized. 212 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 213 bool IsInitialized() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 214 return GetStatus<kVerifyFlags>() == kStatusInitialized; 215 } 216 217 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 218 uint32_t GetAccessFlags() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 219 220 void SetAccessFlags(uint32_t new_access_flags) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 221 // Not called within a transaction. 222 SetField32<false>(OFFSET_OF_OBJECT_MEMBER(Class, access_flags_), new_access_flags); 223 } 224 225 // Returns true if the class is an interface. 226 bool IsInterface() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 227 return (GetAccessFlags() & kAccInterface) != 0; 228 } 229 230 // Returns true if the class is declared public. 231 bool IsPublic() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 232 return (GetAccessFlags() & kAccPublic) != 0; 233 } 234 235 // Returns true if the class is declared final. 236 bool IsFinal() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 237 return (GetAccessFlags() & kAccFinal) != 0; 238 } 239 240 bool IsFinalizable() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 241 return (GetAccessFlags() & kAccClassIsFinalizable) != 0; 242 } 243 244 void SetFinalizable() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 245 uint32_t flags = GetField32(OFFSET_OF_OBJECT_MEMBER(Class, access_flags_)); 246 SetAccessFlags(flags | kAccClassIsFinalizable); 247 } 248 249 // Returns true if the class is abstract. 250 bool IsAbstract() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 251 return (GetAccessFlags() & kAccAbstract) != 0; 252 } 253 254 // Returns true if the class is an annotation. 255 bool IsAnnotation() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 256 return (GetAccessFlags() & kAccAnnotation) != 0; 257 } 258 259 // Returns true if the class is synthetic. 260 bool IsSynthetic() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 261 return (GetAccessFlags() & kAccSynthetic) != 0; 262 } 263 264 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 265 bool IsTypeOfReferenceClass() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 266 return (GetAccessFlags<kVerifyFlags>() & kAccClassIsReference) != 0; 267 } 268 269 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 270 bool IsWeakReferenceClass() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 271 return (GetAccessFlags<kVerifyFlags>() & kAccClassIsWeakReference) != 0; 272 } 273 274 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 275 bool IsSoftReferenceClass() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 276 return (GetAccessFlags<kVerifyFlags>() & kAccReferenceFlagsMask) == kAccClassIsReference; 277 } 278 279 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 280 bool IsFinalizerReferenceClass() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 281 return (GetAccessFlags<kVerifyFlags>() & kAccClassIsFinalizerReference) != 0; 282 } 283 284 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 285 bool IsPhantomReferenceClass() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 286 return (GetAccessFlags<kVerifyFlags>() & kAccClassIsPhantomReference) != 0; 287 } 288 289 // Can references of this type be assigned to by things of another type? For non-array types 290 // this is a matter of whether sub-classes may exist - which they can't if the type is final. 291 // For array classes, where all the classes are final due to there being no sub-classes, an 292 // Object[] may be assigned to by a String[] but a String[] may not be assigned to by other 293 // types as the component is final. 294 bool CannotBeAssignedFromOtherTypes() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 295 if (!IsArrayClass()) { 296 return IsFinal(); 297 } else { 298 Class* component = GetComponentType(); 299 if (component->IsPrimitive()) { 300 return true; 301 } else { 302 return component->CannotBeAssignedFromOtherTypes(); 303 } 304 } 305 } 306 307 // Returns true if this class is the placeholder and should retire and 308 // be replaced with a class with the right size for embedded imt/vtable. 309 bool IsTemp() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 310 Status s = GetStatus(); 311 return s < Status::kStatusResolving && ShouldHaveEmbeddedImtAndVTable(); 312 } 313 314 String* GetName() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); // Returns the cached name. 315 void SetName(String* name) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); // Sets the cached name. 316 // Computes the name, then sets the cached value. 317 static String* ComputeName(Handle<Class> h_this) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 318 319 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 320 bool IsProxyClass() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 321 // Read access flags without using getter as whether something is a proxy can be check in 322 // any loaded state 323 // TODO: switch to a check if the super class is java.lang.reflect.Proxy? 324 uint32_t access_flags = GetField32<kVerifyFlags>(OFFSET_OF_OBJECT_MEMBER(Class, access_flags_)); 325 return (access_flags & kAccClassIsProxy) != 0; 326 } 327 328 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 329 Primitive::Type GetPrimitiveType() ALWAYS_INLINE SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 330 331 void SetPrimitiveType(Primitive::Type new_type) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 332 DCHECK_EQ(sizeof(Primitive::Type), sizeof(int32_t)); 333 SetField32<false>(OFFSET_OF_OBJECT_MEMBER(Class, primitive_type_), new_type); 334 } 335 336 // Returns true if the class is a primitive type. 337 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 338 bool IsPrimitive() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 339 return GetPrimitiveType<kVerifyFlags>() != Primitive::kPrimNot; 340 } 341 342 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 343 bool IsPrimitiveBoolean() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 344 return GetPrimitiveType<kVerifyFlags>() == Primitive::kPrimBoolean; 345 } 346 347 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 348 bool IsPrimitiveByte() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 349 return GetPrimitiveType<kVerifyFlags>() == Primitive::kPrimByte; 350 } 351 352 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 353 bool IsPrimitiveChar() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 354 return GetPrimitiveType<kVerifyFlags>() == Primitive::kPrimChar; 355 } 356 357 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 358 bool IsPrimitiveShort() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 359 return GetPrimitiveType<kVerifyFlags>() == Primitive::kPrimShort; 360 } 361 362 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 363 bool IsPrimitiveInt() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 364 return GetPrimitiveType() == Primitive::kPrimInt; 365 } 366 367 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 368 bool IsPrimitiveLong() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 369 return GetPrimitiveType<kVerifyFlags>() == Primitive::kPrimLong; 370 } 371 372 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 373 bool IsPrimitiveFloat() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 374 return GetPrimitiveType<kVerifyFlags>() == Primitive::kPrimFloat; 375 } 376 377 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 378 bool IsPrimitiveDouble() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 379 return GetPrimitiveType<kVerifyFlags>() == Primitive::kPrimDouble; 380 } 381 382 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 383 bool IsPrimitiveVoid() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 384 return GetPrimitiveType<kVerifyFlags>() == Primitive::kPrimVoid; 385 } 386 387 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 388 bool IsPrimitiveArray() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 389 return IsArrayClass<kVerifyFlags>() && 390 GetComponentType<static_cast<VerifyObjectFlags>(kVerifyFlags & ~kVerifyThis)>()-> 391 IsPrimitive(); 392 } 393 394 // Depth of class from java.lang.Object 395 uint32_t Depth() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 396 uint32_t depth = 0; 397 for (Class* klass = this; klass->GetSuperClass() != NULL; klass = klass->GetSuperClass()) { 398 depth++; 399 } 400 return depth; 401 } 402 403 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags, 404 ReadBarrierOption kReadBarrierOption = kWithReadBarrier> 405 bool IsArrayClass() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 406 return GetComponentType<kVerifyFlags, kReadBarrierOption>() != NULL; 407 } 408 409 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags, 410 ReadBarrierOption kReadBarrierOption = kWithReadBarrier> 411 bool IsClassClass() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 412 413 bool IsStringClass() const SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 414 415 bool IsThrowableClass() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 416 417 template<ReadBarrierOption kReadBarrierOption = kWithReadBarrier> 418 bool IsArtFieldClass() const SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 419 420 template<ReadBarrierOption kReadBarrierOption = kWithReadBarrier> 421 bool IsArtMethodClass() const SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 422 423 template<ReadBarrierOption kReadBarrierOption = kWithReadBarrier> 424 bool IsReferenceClass() const SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 425 426 static MemberOffset ComponentTypeOffset() { 427 return OFFSET_OF_OBJECT_MEMBER(Class, component_type_); 428 } 429 430 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags, 431 ReadBarrierOption kReadBarrierOption = kWithReadBarrier> 432 Class* GetComponentType() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 433 return GetFieldObject<Class, kVerifyFlags, kReadBarrierOption>(ComponentTypeOffset()); 434 } 435 436 void SetComponentType(Class* new_component_type) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 437 DCHECK(GetComponentType() == NULL); 438 DCHECK(new_component_type != NULL); 439 // Component type is invariant: use non-transactional mode without check. 440 SetFieldObject<false, false>(ComponentTypeOffset(), new_component_type); 441 } 442 443 template<ReadBarrierOption kReadBarrierOption = kWithReadBarrier> 444 size_t GetComponentSize() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 445 return Primitive::ComponentSize( 446 GetComponentType<kDefaultVerifyFlags, kReadBarrierOption>()->GetPrimitiveType()); 447 } 448 449 bool IsObjectClass() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 450 return !IsPrimitive() && GetSuperClass() == NULL; 451 } 452 bool IsInstantiable() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 453 return (!IsPrimitive() && !IsInterface() && !IsAbstract()) || ((IsAbstract()) && IsArrayClass()); 454 } 455 456 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 457 bool IsObjectArrayClass() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 458 return GetComponentType<kVerifyFlags>() != nullptr && !GetComponentType<kVerifyFlags>()->IsPrimitive(); 459 } 460 461 // Creates a raw object instance but does not invoke the default constructor. 462 template<bool kIsInstrumented, bool kCheckAddFinalizer = true> 463 ALWAYS_INLINE Object* Alloc(Thread* self, gc::AllocatorType allocator_type) 464 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 465 466 Object* AllocObject(Thread* self) 467 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 468 Object* AllocNonMovableObject(Thread* self) 469 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 470 471 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags, 472 ReadBarrierOption kReadBarrierOption = kWithReadBarrier> 473 bool IsVariableSize() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 474 // Classes and arrays vary in size, and so the object_size_ field cannot 475 // be used to Get their instance size 476 return IsClassClass<kVerifyFlags, kReadBarrierOption>() || 477 IsArrayClass<kVerifyFlags, kReadBarrierOption>(); 478 } 479 480 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags, 481 ReadBarrierOption kReadBarrierOption = kWithReadBarrier> 482 uint32_t SizeOf() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 483 return GetField32<kVerifyFlags>(OFFSET_OF_OBJECT_MEMBER(Class, class_size_)); 484 } 485 486 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 487 uint32_t GetClassSize() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 488 return GetField32<kVerifyFlags>(OFFSET_OF_OBJECT_MEMBER(Class, class_size_)); 489 } 490 491 void SetClassSize(uint32_t new_class_size) 492 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 493 494 // Compute how many bytes would be used a class with the given elements. 495 static uint32_t ComputeClassSize(bool has_embedded_tables, 496 uint32_t num_vtable_entries, 497 uint32_t num_32bit_static_fields, 498 uint32_t num_64bit_static_fields, 499 uint32_t num_ref_static_fields); 500 501 // The size of java.lang.Class.class. 502 static uint32_t ClassClassSize() { 503 // The number of vtable entries in java.lang.Class. 504 uint32_t vtable_entries = Object::kVTableLength + 64; 505 return ComputeClassSize(true, vtable_entries, 0, 1, 0); 506 } 507 508 // The size of a java.lang.Class representing a primitive such as int.class. 509 static uint32_t PrimitiveClassSize() { 510 return ComputeClassSize(false, 0, 0, 0, 0); 511 } 512 513 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags, 514 ReadBarrierOption kReadBarrierOption = kWithReadBarrier> 515 uint32_t GetObjectSize() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 516 517 void SetObjectSize(uint32_t new_object_size) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 518 DCHECK(!IsVariableSize()); 519 // Not called within a transaction. 520 return SetField32<false>(OFFSET_OF_OBJECT_MEMBER(Class, object_size_), new_object_size); 521 } 522 523 // Returns true if this class is in the same packages as that class. 524 bool IsInSamePackage(Class* that) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 525 526 static bool IsInSamePackage(const StringPiece& descriptor1, const StringPiece& descriptor2); 527 528 // Returns true if this class can access that class. 529 bool CanAccess(Class* that) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 530 return that->IsPublic() || this->IsInSamePackage(that); 531 } 532 533 // Can this class access a member in the provided class with the provided member access flags? 534 // Note that access to the class isn't checked in case the declaring class is protected and the 535 // method has been exposed by a public sub-class 536 bool CanAccessMember(Class* access_to, uint32_t member_flags) 537 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 538 // Classes can access all of their own members 539 if (this == access_to) { 540 return true; 541 } 542 // Public members are trivially accessible 543 if (member_flags & kAccPublic) { 544 return true; 545 } 546 // Private members are trivially not accessible 547 if (member_flags & kAccPrivate) { 548 return false; 549 } 550 // Check for protected access from a sub-class, which may or may not be in the same package. 551 if (member_flags & kAccProtected) { 552 if (this->IsSubClass(access_to)) { 553 return true; 554 } 555 } 556 // Allow protected access from other classes in the same package. 557 return this->IsInSamePackage(access_to); 558 } 559 560 // Can this class access a resolved field? 561 // Note that access to field's class is checked and this may require looking up the class 562 // referenced by the FieldId in the DexFile in case the declaring class is inaccessible. 563 bool CanAccessResolvedField(Class* access_to, ArtField* field, 564 DexCache* dex_cache, uint32_t field_idx) 565 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 566 bool CheckResolvedFieldAccess(Class* access_to, ArtField* field, 567 uint32_t field_idx) 568 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 569 570 // Can this class access a resolved method? 571 // Note that access to methods's class is checked and this may require looking up the class 572 // referenced by the MethodId in the DexFile in case the declaring class is inaccessible. 573 bool CanAccessResolvedMethod(Class* access_to, ArtMethod* resolved_method, 574 DexCache* dex_cache, uint32_t method_idx) 575 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 576 template <InvokeType throw_invoke_type> 577 bool CheckResolvedMethodAccess(Class* access_to, ArtMethod* resolved_method, 578 uint32_t method_idx) 579 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 580 581 bool IsSubClass(Class* klass) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 582 583 // Can src be assigned to this class? For example, String can be assigned to Object (by an 584 // upcast), however, an Object cannot be assigned to a String as a potentially exception throwing 585 // downcast would be necessary. Similarly for interfaces, a class that implements (or an interface 586 // that extends) another can be assigned to its parent, but not vice-versa. All Classes may assign 587 // to themselves. Classes for primitive types may not assign to each other. 588 inline bool IsAssignableFrom(Class* src) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 589 DCHECK(src != NULL); 590 if (this == src) { 591 // Can always assign to things of the same type. 592 return true; 593 } else if (IsObjectClass()) { 594 // Can assign any reference to java.lang.Object. 595 return !src->IsPrimitive(); 596 } else if (IsInterface()) { 597 return src->Implements(this); 598 } else if (src->IsArrayClass()) { 599 return IsAssignableFromArray(src); 600 } else { 601 return !src->IsInterface() && src->IsSubClass(this); 602 } 603 } 604 605 Class* GetSuperClass() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 606 607 void SetSuperClass(Class *new_super_class) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 608 // Super class is assigned once, except during class linker initialization. 609 Class* old_super_class = GetFieldObject<Class>(OFFSET_OF_OBJECT_MEMBER(Class, super_class_)); 610 DCHECK(old_super_class == nullptr || old_super_class == new_super_class); 611 DCHECK(new_super_class != nullptr); 612 SetFieldObject<false>(OFFSET_OF_OBJECT_MEMBER(Class, super_class_), new_super_class); 613 } 614 615 bool HasSuperClass() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 616 return GetSuperClass() != NULL; 617 } 618 619 static MemberOffset SuperClassOffset() { 620 return MemberOffset(OFFSETOF_MEMBER(Class, super_class_)); 621 } 622 623 ClassLoader* GetClassLoader() ALWAYS_INLINE SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 624 625 void SetClassLoader(ClassLoader* new_cl) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 626 627 static MemberOffset DexCacheOffset() { 628 return MemberOffset(OFFSETOF_MEMBER(Class, dex_cache_)); 629 } 630 631 enum { 632 kDumpClassFullDetail = 1, 633 kDumpClassClassLoader = (1 << 1), 634 kDumpClassInitialized = (1 << 2), 635 }; 636 637 void DumpClass(std::ostream& os, int flags) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 638 639 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 640 DexCache* GetDexCache() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 641 642 void SetDexCache(DexCache* new_dex_cache) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 643 644 ObjectArray<ArtMethod>* GetDirectMethods() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 645 646 void SetDirectMethods(ObjectArray<ArtMethod>* new_direct_methods) 647 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 648 649 ArtMethod* GetDirectMethod(int32_t i) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 650 651 void SetDirectMethod(uint32_t i, ArtMethod* f) // TODO: uint16_t 652 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 653 654 // Returns the number of static, private, and constructor methods. 655 uint32_t NumDirectMethods() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 656 657 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 658 ObjectArray<ArtMethod>* GetVirtualMethods() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 659 660 void SetVirtualMethods(ObjectArray<ArtMethod>* new_virtual_methods) 661 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 662 663 // Returns the number of non-inherited virtual methods. 664 uint32_t NumVirtualMethods() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 665 666 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 667 ArtMethod* GetVirtualMethod(uint32_t i) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 668 669 ArtMethod* GetVirtualMethodDuringLinking(uint32_t i) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 670 671 void SetVirtualMethod(uint32_t i, ArtMethod* f) // TODO: uint16_t 672 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 673 674 ObjectArray<ArtMethod>* GetVTable() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 675 676 ObjectArray<ArtMethod>* GetVTableDuringLinking() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 677 678 void SetVTable(ObjectArray<ArtMethod>* new_vtable) 679 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 680 681 static MemberOffset VTableOffset() { 682 return OFFSET_OF_OBJECT_MEMBER(Class, vtable_); 683 } 684 685 void SetImTable(ObjectArray<ArtMethod>* new_imtable) 686 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 687 688 static MemberOffset ImTableOffset() { 689 return OFFSET_OF_OBJECT_MEMBER(Class, imtable_); 690 } 691 692 static MemberOffset EmbeddedImTableOffset() { 693 return MemberOffset(sizeof(Class)); 694 } 695 696 static MemberOffset EmbeddedVTableLengthOffset() { 697 return MemberOffset(sizeof(Class) + kImtSize * sizeof(mirror::Class::ImTableEntry)); 698 } 699 700 static MemberOffset EmbeddedVTableOffset() { 701 return MemberOffset(sizeof(Class) + kImtSize * sizeof(mirror::Class::ImTableEntry) + sizeof(int32_t)); 702 } 703 704 bool ShouldHaveEmbeddedImtAndVTable() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 705 return IsInstantiable(); 706 } 707 708 bool HasVTable() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 709 710 ArtMethod* GetEmbeddedImTableEntry(uint32_t i) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 711 712 void SetEmbeddedImTableEntry(uint32_t i, ArtMethod* method) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 713 714 int32_t GetVTableLength() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 715 716 ArtMethod* GetVTableEntry(uint32_t i) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 717 718 int32_t GetEmbeddedVTableLength() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 719 720 void SetEmbeddedVTableLength(int32_t len) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 721 722 ArtMethod* GetEmbeddedVTableEntry(uint32_t i) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 723 724 void SetEmbeddedVTableEntry(uint32_t i, ArtMethod* method) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 725 726 void PopulateEmbeddedImtAndVTable() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 727 728 // Given a method implemented by this class but potentially from a super class, return the 729 // specific implementation method for this class. 730 ArtMethod* FindVirtualMethodForVirtual(ArtMethod* method) 731 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 732 733 // Given a method implemented by this class' super class, return the specific implementation 734 // method for this class. 735 ArtMethod* FindVirtualMethodForSuper(ArtMethod* method) 736 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 737 738 // Given a method implemented by this class, but potentially from a 739 // super class or interface, return the specific implementation 740 // method for this class. 741 ArtMethod* FindVirtualMethodForInterface(ArtMethod* method) 742 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) ALWAYS_INLINE; 743 744 ArtMethod* FindVirtualMethodForVirtualOrInterface(ArtMethod* method) 745 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 746 747 ArtMethod* FindInterfaceMethod(const StringPiece& name, const StringPiece& signature) 748 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 749 750 ArtMethod* FindInterfaceMethod(const StringPiece& name, const Signature& signature) 751 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 752 753 ArtMethod* FindInterfaceMethod(const DexCache* dex_cache, uint32_t dex_method_idx) 754 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 755 756 ArtMethod* FindDeclaredDirectMethod(const StringPiece& name, const StringPiece& signature) 757 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 758 759 ArtMethod* FindDeclaredDirectMethod(const StringPiece& name, const Signature& signature) 760 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 761 762 ArtMethod* FindDeclaredDirectMethod(const DexCache* dex_cache, uint32_t dex_method_idx) 763 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 764 765 ArtMethod* FindDirectMethod(const StringPiece& name, const StringPiece& signature) 766 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 767 768 ArtMethod* FindDirectMethod(const StringPiece& name, const Signature& signature) 769 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 770 771 ArtMethod* FindDirectMethod(const DexCache* dex_cache, uint32_t dex_method_idx) 772 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 773 774 ArtMethod* FindDeclaredVirtualMethod(const StringPiece& name, const StringPiece& signature) 775 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 776 777 ArtMethod* FindDeclaredVirtualMethod(const StringPiece& name, const Signature& signature) 778 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 779 780 ArtMethod* FindDeclaredVirtualMethod(const DexCache* dex_cache, uint32_t dex_method_idx) 781 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 782 783 ArtMethod* FindVirtualMethod(const StringPiece& name, const StringPiece& signature) 784 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 785 786 ArtMethod* FindVirtualMethod(const StringPiece& name, const Signature& signature) 787 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 788 789 ArtMethod* FindVirtualMethod(const DexCache* dex_cache, uint32_t dex_method_idx) 790 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 791 792 ArtMethod* FindClassInitializer() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 793 794 int32_t GetIfTableCount() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 795 796 IfTable* GetIfTable() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 797 798 void SetIfTable(IfTable* new_iftable) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 799 800 // Get instance fields of the class (See also GetSFields). 801 ObjectArray<ArtField>* GetIFields() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 802 803 void SetIFields(ObjectArray<ArtField>* new_ifields) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 804 805 uint32_t NumInstanceFields() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 806 807 ArtField* GetInstanceField(uint32_t i) // TODO: uint16_t 808 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 809 810 void SetInstanceField(uint32_t i, ArtField* f) // TODO: uint16_t 811 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 812 813 // Returns the number of instance fields containing reference types. 814 uint32_t NumReferenceInstanceFields() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 815 DCHECK(IsResolved() || IsErroneous()); 816 return GetField32(OFFSET_OF_OBJECT_MEMBER(Class, num_reference_instance_fields_)); 817 } 818 819 uint32_t NumReferenceInstanceFieldsDuringLinking() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 820 DCHECK(IsLoaded() || IsErroneous()); 821 return GetField32(OFFSET_OF_OBJECT_MEMBER(Class, num_reference_instance_fields_)); 822 } 823 824 void SetNumReferenceInstanceFields(uint32_t new_num) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 825 // Not called within a transaction. 826 SetField32<false>(OFFSET_OF_OBJECT_MEMBER(Class, num_reference_instance_fields_), new_num); 827 } 828 829 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 830 uint32_t GetReferenceInstanceOffsets() ALWAYS_INLINE SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 831 832 void SetReferenceInstanceOffsets(uint32_t new_reference_offsets) 833 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 834 835 // Returns the number of static fields containing reference types. 836 uint32_t NumReferenceStaticFields() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 837 DCHECK(IsResolved() || IsErroneous()); 838 return GetField32(OFFSET_OF_OBJECT_MEMBER(Class, num_reference_static_fields_)); 839 } 840 841 uint32_t NumReferenceStaticFieldsDuringLinking() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 842 DCHECK(IsLoaded() || IsErroneous() || IsRetired()); 843 return GetField32(OFFSET_OF_OBJECT_MEMBER(Class, num_reference_static_fields_)); 844 } 845 846 void SetNumReferenceStaticFields(uint32_t new_num) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 847 // Not called within a transaction. 848 SetField32<false>(OFFSET_OF_OBJECT_MEMBER(Class, num_reference_static_fields_), new_num); 849 } 850 851 // Gets the static fields of the class. 852 ObjectArray<ArtField>* GetSFields() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 853 854 void SetSFields(ObjectArray<ArtField>* new_sfields) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 855 856 uint32_t NumStaticFields() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 857 858 // TODO: uint16_t 859 ArtField* GetStaticField(uint32_t i) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 860 861 // TODO: uint16_t 862 void SetStaticField(uint32_t i, ArtField* f) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 863 864 template<VerifyObjectFlags kVerifyFlags = kDefaultVerifyFlags> 865 uint32_t GetReferenceStaticOffsets() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 866 return GetField32<kVerifyFlags>(OFFSET_OF_OBJECT_MEMBER(Class, reference_static_offsets_)); 867 } 868 869 void SetReferenceStaticOffsets(uint32_t new_reference_offsets) 870 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 871 872 // Find a static or instance field using the JLS resolution order 873 static ArtField* FindField(Thread* self, Handle<Class> klass, const StringPiece& name, 874 const StringPiece& type) 875 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 876 877 // Finds the given instance field in this class or a superclass. 878 ArtField* FindInstanceField(const StringPiece& name, const StringPiece& type) 879 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 880 881 // Finds the given instance field in this class or a superclass, only searches classes that 882 // have the same dex cache. 883 ArtField* FindInstanceField(const DexCache* dex_cache, uint32_t dex_field_idx) 884 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 885 886 ArtField* FindDeclaredInstanceField(const StringPiece& name, const StringPiece& type) 887 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 888 889 ArtField* FindDeclaredInstanceField(const DexCache* dex_cache, uint32_t dex_field_idx) 890 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 891 892 // Finds the given static field in this class or a superclass. 893 static ArtField* FindStaticField(Thread* self, Handle<Class> klass, const StringPiece& name, 894 const StringPiece& type) 895 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 896 897 // Finds the given static field in this class or superclass, only searches classes that 898 // have the same dex cache. 899 static ArtField* FindStaticField(Thread* self, Handle<Class> klass, const DexCache* dex_cache, 900 uint32_t dex_field_idx) 901 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 902 903 ArtField* FindDeclaredStaticField(const StringPiece& name, const StringPiece& type) 904 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 905 906 ArtField* FindDeclaredStaticField(const DexCache* dex_cache, uint32_t dex_field_idx) 907 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 908 909 pid_t GetClinitThreadId() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 910 DCHECK(IsIdxLoaded() || IsErroneous()); 911 return GetField32(OFFSET_OF_OBJECT_MEMBER(Class, clinit_thread_id_)); 912 } 913 914 void SetClinitThreadId(pid_t new_clinit_thread_id) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 915 916 Class* GetVerifyErrorClass() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 917 // DCHECK(IsErroneous()); 918 return GetFieldObject<Class>(OFFSET_OF_OBJECT_MEMBER(Class, verify_error_class_)); 919 } 920 921 uint16_t GetDexClassDefIndex() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 922 return GetField32(OFFSET_OF_OBJECT_MEMBER(Class, dex_class_def_idx_)); 923 } 924 925 void SetDexClassDefIndex(uint16_t class_def_idx) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 926 // Not called within a transaction. 927 SetField32<false>(OFFSET_OF_OBJECT_MEMBER(Class, dex_class_def_idx_), class_def_idx); 928 } 929 930 uint16_t GetDexTypeIndex() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 931 return GetField32(OFFSET_OF_OBJECT_MEMBER(Class, dex_type_idx_)); 932 } 933 934 void SetDexTypeIndex(uint16_t type_idx) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 935 // Not called within a transaction. 936 SetField32<false>(OFFSET_OF_OBJECT_MEMBER(Class, dex_type_idx_), type_idx); 937 } 938 939 static Class* GetJavaLangClass() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) { 940 DCHECK(!java_lang_Class_.IsNull()); 941 return java_lang_Class_.Read(); 942 } 943 944 // Can't call this SetClass or else gets called instead of Object::SetClass in places. 945 static void SetClassClass(Class* java_lang_Class) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 946 static void ResetClass(); 947 static void VisitRoots(RootCallback* callback, void* arg) 948 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 949 950 // When class is verified, set the kAccPreverified flag on each method. 951 void SetPreverifiedFlagOnAllMethods() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 952 953 template <bool kVisitClass, typename Visitor> 954 void VisitReferences(mirror::Class* klass, const Visitor& visitor) 955 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 956 957 // Visit references within the embedded tables of the class. 958 // TODO: remove NO_THREAD_SAFETY_ANALYSIS when annotalysis handles visitors better. 959 template<typename Visitor> 960 void VisitEmbeddedImtAndVTable(const Visitor& visitor) NO_THREAD_SAFETY_ANALYSIS; 961 962 std::string GetDescriptor() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 963 964 bool DescriptorEquals(const char* match) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 965 966 std::string GetArrayDescriptor() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 967 968 const DexFile::ClassDef* GetClassDef() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 969 970 uint32_t NumDirectInterfaces() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 971 972 uint16_t GetDirectInterfaceTypeIdx(uint32_t idx) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 973 974 static mirror::Class* GetDirectInterface(Thread* self, Handle<mirror::Class> klass, uint32_t idx) 975 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 976 977 const char* GetSourceFile() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 978 979 std::string GetLocation() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 980 981 const DexFile& GetDexFile() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 982 983 const DexFile::TypeList* GetInterfaceTypeList() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 984 985 // Asserts we are initialized or initializing in the given thread. 986 void AssertInitializedOrInitializingInThread(Thread* self) 987 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 988 989 Class* CopyOf(Thread* self, int32_t new_length) 990 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 991 992 // For proxy class only. 993 ObjectArray<Class>* GetInterfaces() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 994 995 // For proxy class only. 996 ObjectArray<ObjectArray<Class>>* GetThrows() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 997 998 // For reference class only. 999 MemberOffset GetDisableIntrinsicFlagOffset() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 1000 MemberOffset GetSlowPathFlagOffset() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 1001 bool GetSlowPathEnabled() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 1002 void SetSlowPath(bool enabled) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 1003 1004 // Used to initialize a class in the allocation code path to ensure it is guarded by a StoreStore 1005 // fence. 1006 class InitializeClassVisitor { 1007 public: 1008 explicit InitializeClassVisitor(uint32_t class_size) : class_size_(class_size) { 1009 } 1010 1011 void operator()(mirror::Object* obj, size_t usable_size) const 1012 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 1013 1014 private: 1015 const uint32_t class_size_; 1016 1017 DISALLOW_COPY_AND_ASSIGN(InitializeClassVisitor); 1018 }; 1019 1020 private: 1021 void SetVerifyErrorClass(Class* klass) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 1022 1023 template <bool throw_on_failure, bool use_referrers_cache> 1024 bool ResolvedFieldAccessTest(Class* access_to, ArtField* field, 1025 uint32_t field_idx, DexCache* dex_cache) 1026 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 1027 template <bool throw_on_failure, bool use_referrers_cache, InvokeType throw_invoke_type> 1028 bool ResolvedMethodAccessTest(Class* access_to, ArtMethod* resolved_method, 1029 uint32_t method_idx, DexCache* dex_cache) 1030 SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 1031 1032 bool Implements(Class* klass) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 1033 bool IsArrayAssignableFromArray(Class* klass) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 1034 bool IsAssignableFromArray(Class* klass) SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 1035 1036 void CheckObjectAlloc() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 1037 1038 ObjectArray<ArtMethod>* GetImTable() SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); 1039 1040 // defining class loader, or NULL for the "bootstrap" system loader 1041 HeapReference<ClassLoader> class_loader_; 1042 1043 // For array classes, the component class object for instanceof/checkcast 1044 // (for String[][][], this will be String[][]). NULL for non-array classes. 1045 HeapReference<Class> component_type_; 1046 1047 // DexCache of resolved constant pool entries (will be NULL for classes generated by the 1048 // runtime such as arrays and primitive classes). 1049 HeapReference<DexCache> dex_cache_; 1050 1051 // static, private, and <init> methods 1052 HeapReference<ObjectArray<ArtMethod>> direct_methods_; 1053 1054 // instance fields 1055 // 1056 // These describe the layout of the contents of an Object. 1057 // Note that only the fields directly declared by this class are 1058 // listed in ifields; fields declared by a superclass are listed in 1059 // the superclass's Class.ifields. 1060 // 1061 // All instance fields that refer to objects are guaranteed to be at 1062 // the beginning of the field list. num_reference_instance_fields_ 1063 // specifies the number of reference fields. 1064 HeapReference<ObjectArray<ArtField>> ifields_; 1065 1066 // The interface table (iftable_) contains pairs of a interface class and an array of the 1067 // interface methods. There is one pair per interface supported by this class. That means one 1068 // pair for each interface we support directly, indirectly via superclass, or indirectly via a 1069 // superinterface. This will be null if neither we nor our superclass implement any interfaces. 1070 // 1071 // Why we need this: given "class Foo implements Face", declare "Face faceObj = new Foo()". 1072 // Invoke faceObj.blah(), where "blah" is part of the Face interface. We can't easily use a 1073 // single vtable. 1074 // 1075 // For every interface a concrete class implements, we create an array of the concrete vtable_ 1076 // methods for the methods in the interface. 1077 HeapReference<IfTable> iftable_; 1078 1079 // Interface method table (imt), for quick "invoke-interface". 1080 HeapReference<ObjectArray<ArtMethod>> imtable_; 1081 1082 // Descriptor for the class such as "java.lang.Class" or "[C". Lazily initialized by ComputeName 1083 HeapReference<String> name_; 1084 1085 // Static fields 1086 HeapReference<ObjectArray<ArtField>> sfields_; 1087 1088 // The superclass, or NULL if this is java.lang.Object, an interface or primitive type. 1089 HeapReference<Class> super_class_; 1090 1091 // If class verify fails, we must return same error on subsequent tries. 1092 HeapReference<Class> verify_error_class_; 1093 1094 // Virtual methods defined in this class; invoked through vtable. 1095 HeapReference<ObjectArray<ArtMethod>> virtual_methods_; 1096 1097 // Virtual method table (vtable), for use by "invoke-virtual". The vtable from the superclass is 1098 // copied in, and virtual methods from our class either replace those from the super or are 1099 // appended. For abstract classes, methods may be created in the vtable that aren't in 1100 // virtual_ methods_ for miranda methods. 1101 HeapReference<ObjectArray<ArtMethod>> vtable_; 1102 1103 // Access flags; low 16 bits are defined by VM spec. 1104 uint32_t access_flags_; 1105 1106 // Total size of the Class instance; used when allocating storage on gc heap. 1107 // See also object_size_. 1108 uint32_t class_size_; 1109 1110 // Tid used to check for recursive <clinit> invocation. 1111 pid_t clinit_thread_id_; 1112 1113 // ClassDef index in dex file, -1 if no class definition such as an array. 1114 // TODO: really 16bits 1115 int32_t dex_class_def_idx_; 1116 1117 // Type index in dex file. 1118 // TODO: really 16bits 1119 int32_t dex_type_idx_; 1120 1121 // Number of instance fields that are object refs. 1122 uint32_t num_reference_instance_fields_; 1123 1124 // Number of static fields that are object refs, 1125 uint32_t num_reference_static_fields_; 1126 1127 // Total object size; used when allocating storage on gc heap. 1128 // (For interfaces and abstract classes this will be zero.) 1129 // See also class_size_. 1130 uint32_t object_size_; 1131 1132 // Primitive type value, or Primitive::kPrimNot (0); set for generated primitive classes. 1133 Primitive::Type primitive_type_; 1134 1135 // Bitmap of offsets of ifields. 1136 uint32_t reference_instance_offsets_; 1137 1138 // Bitmap of offsets of sfields. 1139 uint32_t reference_static_offsets_; 1140 1141 // State of class initialization. 1142 Status status_; 1143 1144 // TODO: ? 1145 // initiating class loader list 1146 // NOTE: for classes with low serialNumber, these are unused, and the 1147 // values are kept in a table in gDvm. 1148 // InitiatingLoaderList initiating_loader_list_; 1149 1150 // The following data exist in real class objects. 1151 // Embedded Imtable, for class object that's not an interface, fixed size. 1152 ImTableEntry embedded_imtable_[0]; 1153 // Embedded Vtable, for class object that's not an interface, variable size. 1154 VTableEntry embedded_vtable_[0]; 1155 // Static fields, variable size. 1156 uint32_t fields_[0]; 1157 1158 // java.lang.Class 1159 static GcRoot<Class> java_lang_Class_; 1160 1161 friend struct art::ClassOffsets; // for verifying offset information 1162 DISALLOW_IMPLICIT_CONSTRUCTORS(Class); 1163}; 1164 1165std::ostream& operator<<(std::ostream& os, const Class::Status& rhs); 1166 1167} // namespace mirror 1168} // namespace art 1169 1170#endif // ART_RUNTIME_MIRROR_CLASS_H_ 1171