1338 lines
60 KiB
C++
1338 lines
60 KiB
C++
/*
|
|
* Copyright (C) 2011 The Android Open Source Project
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
#ifndef ART_RUNTIME_CLASS_LINKER_H_
|
|
#define ART_RUNTIME_CLASS_LINKER_H_
|
|
|
|
#include <set>
|
|
#include <string>
|
|
#include <unordered_map>
|
|
#include <unordered_set>
|
|
#include <utility>
|
|
#include <vector>
|
|
|
|
#include "base/enums.h"
|
|
#include "base/macros.h"
|
|
#include "base/mutex.h"
|
|
#include "dex_cache_resolved_classes.h"
|
|
#include "dex_file.h"
|
|
#include "dex_file_types.h"
|
|
#include "gc_root.h"
|
|
#include "handle.h"
|
|
#include "jni.h"
|
|
#include "mirror/class.h"
|
|
#include "verifier/verifier_enums.h"
|
|
|
|
namespace art {
|
|
|
|
namespace gc {
|
|
namespace space {
|
|
class ImageSpace;
|
|
} // namespace space
|
|
} // namespace gc
|
|
namespace mirror {
|
|
class ClassLoader;
|
|
class DexCache;
|
|
class DexCachePointerArray;
|
|
class DexCacheMethodHandlesTest_Open_Test;
|
|
class DexCacheTest_Open_Test;
|
|
class IfTable;
|
|
class MethodHandle;
|
|
class MethodHandlesLookup;
|
|
class MethodType;
|
|
template<class T> class ObjectArray;
|
|
class StackTraceElement;
|
|
template <typename T> struct NativeDexCachePair;
|
|
using MethodDexCachePair = NativeDexCachePair<ArtMethod>;
|
|
using MethodDexCacheType = std::atomic<MethodDexCachePair>;
|
|
} // namespace mirror
|
|
|
|
class ClassHierarchyAnalysis;
|
|
class ClassTable;
|
|
template<class T> class Handle;
|
|
class ImtConflictTable;
|
|
template<typename T> class LengthPrefixedArray;
|
|
template<class T> class MutableHandle;
|
|
class InternTable;
|
|
class LinearAlloc;
|
|
class OatFile;
|
|
template<class T> class ObjectLock;
|
|
class Runtime;
|
|
class ScopedObjectAccessAlreadyRunnable;
|
|
template<size_t kNumReferences> class PACKED(4) StackHandleScope;
|
|
|
|
enum VisitRootFlags : uint8_t;
|
|
|
|
class ClassVisitor {
|
|
public:
|
|
virtual ~ClassVisitor() {}
|
|
// Return true to continue visiting.
|
|
virtual bool operator()(ObjPtr<mirror::Class> klass) = 0;
|
|
};
|
|
|
|
class ClassLoaderVisitor {
|
|
public:
|
|
virtual ~ClassLoaderVisitor() {}
|
|
virtual void Visit(ObjPtr<mirror::ClassLoader> class_loader)
|
|
REQUIRES_SHARED(Locks::classlinker_classes_lock_, Locks::mutator_lock_) = 0;
|
|
};
|
|
|
|
class ClassLinker {
|
|
public:
|
|
// Well known mirror::Class roots accessed via GetClassRoot.
|
|
enum ClassRoot {
|
|
kJavaLangClass,
|
|
kJavaLangObject,
|
|
kClassArrayClass,
|
|
kObjectArrayClass,
|
|
kJavaLangString,
|
|
kJavaLangDexCache,
|
|
kJavaLangRefReference,
|
|
kJavaLangReflectConstructor,
|
|
kJavaLangReflectField,
|
|
kJavaLangReflectMethod,
|
|
kJavaLangReflectProxy,
|
|
kJavaLangStringArrayClass,
|
|
kJavaLangReflectConstructorArrayClass,
|
|
kJavaLangReflectFieldArrayClass,
|
|
kJavaLangReflectMethodArrayClass,
|
|
kJavaLangInvokeCallSite,
|
|
kJavaLangInvokeMethodHandleImpl,
|
|
kJavaLangInvokeMethodHandlesLookup,
|
|
kJavaLangInvokeMethodType,
|
|
kJavaLangClassLoader,
|
|
kJavaLangThrowable,
|
|
kJavaLangClassNotFoundException,
|
|
kJavaLangStackTraceElement,
|
|
kDalvikSystemEmulatedStackFrame,
|
|
kPrimitiveBoolean,
|
|
kPrimitiveByte,
|
|
kPrimitiveChar,
|
|
kPrimitiveDouble,
|
|
kPrimitiveFloat,
|
|
kPrimitiveInt,
|
|
kPrimitiveLong,
|
|
kPrimitiveShort,
|
|
kPrimitiveVoid,
|
|
kBooleanArrayClass,
|
|
kByteArrayClass,
|
|
kCharArrayClass,
|
|
kDoubleArrayClass,
|
|
kFloatArrayClass,
|
|
kIntArrayClass,
|
|
kLongArrayClass,
|
|
kShortArrayClass,
|
|
kJavaLangStackTraceElementArrayClass,
|
|
kDalvikSystemClassExt,
|
|
kClassRootsMax,
|
|
};
|
|
|
|
explicit ClassLinker(InternTable* intern_table);
|
|
virtual ~ClassLinker();
|
|
|
|
// Initialize class linker by bootstraping from dex files.
|
|
bool InitWithoutImage(std::vector<std::unique_ptr<const DexFile>> boot_class_path,
|
|
std::string* error_msg)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_);
|
|
|
|
// Initialize class linker from one or more boot images.
|
|
bool InitFromBootImage(std::string* error_msg)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_);
|
|
|
|
// Add an image space to the class linker, may fix up classloader fields and dex cache fields.
|
|
// The dex files that were newly opened for the space are placed in the out argument
|
|
// out_dex_files. Returns true if the operation succeeded.
|
|
// The space must be already added to the heap before calling AddImageSpace since we need to
|
|
// properly handle read barriers and object marking.
|
|
bool AddImageSpace(gc::space::ImageSpace* space,
|
|
Handle<mirror::ClassLoader> class_loader,
|
|
jobjectArray dex_elements,
|
|
const char* dex_location,
|
|
std::vector<std::unique_ptr<const DexFile>>* out_dex_files,
|
|
std::string* error_msg)
|
|
REQUIRES(!Locks::dex_lock_)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
bool OpenImageDexFiles(gc::space::ImageSpace* space,
|
|
std::vector<std::unique_ptr<const DexFile>>* out_dex_files,
|
|
std::string* error_msg)
|
|
REQUIRES(!Locks::dex_lock_)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Finds a class by its descriptor, loading it if necessary.
|
|
// If class_loader is null, searches boot_class_path_.
|
|
mirror::Class* FindClass(Thread* self,
|
|
const char* descriptor,
|
|
Handle<mirror::ClassLoader> class_loader)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_);
|
|
|
|
// Finds a class by its descriptor using the "system" class loader, ie by searching the
|
|
// boot_class_path_.
|
|
mirror::Class* FindSystemClass(Thread* self, const char* descriptor)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_) {
|
|
return FindClass(self, descriptor, ScopedNullHandle<mirror::ClassLoader>());
|
|
}
|
|
|
|
// Finds the array class given for the element class.
|
|
mirror::Class* FindArrayClass(Thread* self, ObjPtr<mirror::Class>* element_class)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_);
|
|
|
|
// Returns true if the class linker is initialized.
|
|
bool IsInitialized() const {
|
|
return init_done_;
|
|
}
|
|
|
|
// Define a new a class based on a ClassDef from a DexFile
|
|
mirror::Class* DefineClass(Thread* self,
|
|
const char* descriptor,
|
|
size_t hash,
|
|
Handle<mirror::ClassLoader> class_loader,
|
|
const DexFile& dex_file,
|
|
const DexFile::ClassDef& dex_class_def)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_);
|
|
|
|
// Finds a class by its descriptor, returning null if it isn't wasn't loaded
|
|
// by the given 'class_loader'.
|
|
mirror::Class* LookupClass(Thread* self,
|
|
const char* descriptor,
|
|
ObjPtr<mirror::ClassLoader> class_loader)
|
|
REQUIRES(!Locks::classlinker_classes_lock_)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Finds all the classes with the given descriptor, regardless of ClassLoader.
|
|
void LookupClasses(const char* descriptor, std::vector<ObjPtr<mirror::Class>>& classes)
|
|
REQUIRES(!Locks::classlinker_classes_lock_)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
mirror::Class* FindPrimitiveClass(char type) REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
void DumpForSigQuit(std::ostream& os) REQUIRES(!Locks::classlinker_classes_lock_);
|
|
|
|
size_t NumLoadedClasses()
|
|
REQUIRES(!Locks::classlinker_classes_lock_)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Resolve a String with the given index from the DexFile, storing the
|
|
// result in the DexCache.
|
|
mirror::String* ResolveString(const DexFile& dex_file,
|
|
dex::StringIndex string_idx,
|
|
Handle<mirror::DexCache> dex_cache)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Find a String with the given index from the DexFile, storing the
|
|
// result in the DexCache if found. Return null if not found.
|
|
mirror::String* LookupString(const DexFile& dex_file,
|
|
dex::StringIndex string_idx,
|
|
ObjPtr<mirror::DexCache> dex_cache)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Resolve a Type with the given index from the DexFile, storing the
|
|
// result in the DexCache. The referrer is used to identify the
|
|
// target DexCache and ClassLoader to use for resolution.
|
|
mirror::Class* ResolveType(const DexFile& dex_file,
|
|
dex::TypeIndex type_idx,
|
|
ObjPtr<mirror::Class> referrer)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_, !Roles::uninterruptible_);
|
|
|
|
// Resolve a Type with the given index from the DexFile, storing the
|
|
// result in the DexCache. The referrer is used to identify the
|
|
// target DexCache and ClassLoader to use for resolution.
|
|
mirror::Class* ResolveType(dex::TypeIndex type_idx, ArtMethod* referrer)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_, !Roles::uninterruptible_);
|
|
|
|
// Look up a resolved type with the given ID from the DexFile. The ClassLoader is used to search
|
|
// for the type, since it may be referenced from but not contained within the given DexFile.
|
|
ObjPtr<mirror::Class> LookupResolvedType(const DexFile& dex_file,
|
|
dex::TypeIndex type_idx,
|
|
ObjPtr<mirror::DexCache> dex_cache,
|
|
ObjPtr<mirror::ClassLoader> class_loader)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
static ObjPtr<mirror::Class> LookupResolvedType(dex::TypeIndex type_idx,
|
|
ObjPtr<mirror::DexCache> dex_cache,
|
|
ObjPtr<mirror::ClassLoader> class_loader)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Resolve a type with the given ID from the DexFile, storing the
|
|
// result in DexCache. The ClassLoader is used to search for the
|
|
// type, since it may be referenced from but not contained within
|
|
// the given DexFile.
|
|
mirror::Class* ResolveType(const DexFile& dex_file,
|
|
dex::TypeIndex type_idx,
|
|
Handle<mirror::DexCache> dex_cache,
|
|
Handle<mirror::ClassLoader> class_loader)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_, !Roles::uninterruptible_);
|
|
|
|
// Determine whether a dex cache result should be trusted, or an IncompatibleClassChangeError
|
|
// check and IllegalAccessError check should be performed even after a hit.
|
|
enum class ResolveMode { // private.
|
|
kNoChecks,
|
|
kCheckICCEAndIAE
|
|
};
|
|
|
|
// Look up a previously resolved method with the given index.
|
|
ArtMethod* LookupResolvedMethod(uint32_t method_idx,
|
|
ObjPtr<mirror::DexCache> dex_cache,
|
|
ObjPtr<mirror::ClassLoader> class_loader)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Resolve a method with a given ID from the DexFile, storing the
|
|
// result in DexCache. The ClassLinker and ClassLoader are used as
|
|
// in ResolveType. What is unique is the method type argument which
|
|
// is used to determine if this method is a direct, static, or
|
|
// virtual method.
|
|
template <ResolveMode kResolveMode>
|
|
ArtMethod* ResolveMethod(const DexFile& dex_file,
|
|
uint32_t method_idx,
|
|
Handle<mirror::DexCache> dex_cache,
|
|
Handle<mirror::ClassLoader> class_loader,
|
|
ArtMethod* referrer,
|
|
InvokeType type)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_, !Roles::uninterruptible_);
|
|
|
|
template <InvokeType type, ResolveMode kResolveMode>
|
|
ArtMethod* GetResolvedMethod(uint32_t method_idx, ArtMethod* referrer)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
template <ResolveMode kResolveMode>
|
|
ArtMethod* ResolveMethod(Thread* self, uint32_t method_idx, ArtMethod* referrer, InvokeType type)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_, !Roles::uninterruptible_);
|
|
ArtMethod* ResolveMethodWithoutInvokeType(const DexFile& dex_file,
|
|
uint32_t method_idx,
|
|
Handle<mirror::DexCache> dex_cache,
|
|
Handle<mirror::ClassLoader> class_loader)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_, !Roles::uninterruptible_);
|
|
|
|
ArtField* LookupResolvedField(uint32_t field_idx, ArtMethod* referrer, bool is_static)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
ArtField* ResolveField(uint32_t field_idx, ArtMethod* referrer, bool is_static)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_, !Roles::uninterruptible_);
|
|
|
|
// Resolve a field with a given ID from the DexFile, storing the
|
|
// result in DexCache. The ClassLinker and ClassLoader are used as
|
|
// in ResolveType. What is unique is the is_static argument which is
|
|
// used to determine if we are resolving a static or non-static
|
|
// field.
|
|
ArtField* ResolveField(const DexFile& dex_file, uint32_t field_idx,
|
|
Handle<mirror::DexCache> dex_cache,
|
|
Handle<mirror::ClassLoader> class_loader, bool is_static)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_, !Roles::uninterruptible_);
|
|
|
|
// Resolve a field with a given ID from the DexFile, storing the
|
|
// result in DexCache. The ClassLinker and ClassLoader are used as
|
|
// in ResolveType. No is_static argument is provided so that Java
|
|
// field resolution semantics are followed.
|
|
ArtField* ResolveFieldJLS(const DexFile& dex_file,
|
|
uint32_t field_idx,
|
|
Handle<mirror::DexCache> dex_cache,
|
|
Handle<mirror::ClassLoader> class_loader)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_, !Roles::uninterruptible_);
|
|
|
|
// Resolve a method type with a given ID from the DexFile, storing
|
|
// the result in the DexCache.
|
|
mirror::MethodType* ResolveMethodType(const DexFile& dex_file,
|
|
uint32_t proto_idx,
|
|
Handle<mirror::DexCache> dex_cache,
|
|
Handle<mirror::ClassLoader> class_loader)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_, !Roles::uninterruptible_);
|
|
|
|
// Resolve a method handle with a given ID from the DexFile. The
|
|
// result is not cached in the DexCache as the instance will only be
|
|
// used once in most circumstances.
|
|
mirror::MethodHandle* ResolveMethodHandle(uint32_t method_handle_idx, ArtMethod* referrer)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Returns true on success, false if there's an exception pending.
|
|
// can_run_clinit=false allows the compiler to attempt to init a class,
|
|
// given the restriction that no <clinit> execution is possible.
|
|
bool EnsureInitialized(Thread* self,
|
|
Handle<mirror::Class> c,
|
|
bool can_init_fields,
|
|
bool can_init_parents)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_, !Roles::uninterruptible_);
|
|
|
|
// Initializes classes that have instances in the image but that have
|
|
// <clinit> methods so they could not be initialized by the compiler.
|
|
void RunRootClinits()
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_, !Roles::uninterruptible_);
|
|
|
|
// Directly register an already existing dex cache. RegisterDexFile should be preferred since that
|
|
// reduplicates DexCaches when possible. The DexCache given to this function must already be fully
|
|
// initialized and not already registered.
|
|
void RegisterExistingDexCache(ObjPtr<mirror::DexCache> cache,
|
|
ObjPtr<mirror::ClassLoader> class_loader)
|
|
REQUIRES(!Locks::dex_lock_)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
ObjPtr<mirror::DexCache> RegisterDexFile(const DexFile& dex_file,
|
|
ObjPtr<mirror::ClassLoader> class_loader)
|
|
REQUIRES(!Locks::dex_lock_)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
void RegisterBootClassPathDexFile(const DexFile& dex_file, ObjPtr<mirror::DexCache> dex_cache)
|
|
REQUIRES(!Locks::dex_lock_)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
const std::vector<const DexFile*>& GetBootClassPath() {
|
|
return boot_class_path_;
|
|
}
|
|
|
|
void VisitClasses(ClassVisitor* visitor)
|
|
REQUIRES(!Locks::classlinker_classes_lock_)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Less efficient variant of VisitClasses that copies the class_table_ into secondary storage
|
|
// so that it can visit individual classes without holding the doesn't hold the
|
|
// Locks::classlinker_classes_lock_. As the Locks::classlinker_classes_lock_ isn't held this code
|
|
// can race with insertion and deletion of classes while the visitor is being called.
|
|
void VisitClassesWithoutClassesLock(ClassVisitor* visitor)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_);
|
|
|
|
void VisitClassRoots(RootVisitor* visitor, VisitRootFlags flags)
|
|
REQUIRES(!Locks::classlinker_classes_lock_, !Locks::trace_lock_)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
void VisitRoots(RootVisitor* visitor, VisitRootFlags flags)
|
|
REQUIRES(!Locks::dex_lock_, !Locks::classlinker_classes_lock_, !Locks::trace_lock_)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
bool IsDexFileRegistered(Thread* self, const DexFile& dex_file)
|
|
REQUIRES(!Locks::dex_lock_)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
ObjPtr<mirror::DexCache> FindDexCache(Thread* self, const DexFile& dex_file)
|
|
REQUIRES(!Locks::dex_lock_)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
ClassTable* FindClassTable(Thread* self, ObjPtr<mirror::DexCache> dex_cache)
|
|
REQUIRES(!Locks::dex_lock_)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
LengthPrefixedArray<ArtField>* AllocArtFieldArray(Thread* self,
|
|
LinearAlloc* allocator,
|
|
size_t length);
|
|
|
|
LengthPrefixedArray<ArtMethod>* AllocArtMethodArray(Thread* self,
|
|
LinearAlloc* allocator,
|
|
size_t length);
|
|
|
|
mirror::PointerArray* AllocPointerArray(Thread* self, size_t length)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Roles::uninterruptible_);
|
|
|
|
mirror::IfTable* AllocIfTable(Thread* self, size_t ifcount)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Roles::uninterruptible_);
|
|
|
|
mirror::ObjectArray<mirror::StackTraceElement>* AllocStackTraceElementArray(Thread* self,
|
|
size_t length)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Roles::uninterruptible_);
|
|
|
|
verifier::FailureKind VerifyClass(
|
|
Thread* self,
|
|
Handle<mirror::Class> klass,
|
|
verifier::HardFailLogMode log_level = verifier::HardFailLogMode::kLogNone)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_);
|
|
bool VerifyClassUsingOatFile(const DexFile& dex_file,
|
|
ObjPtr<mirror::Class> klass,
|
|
mirror::Class::Status& oat_file_class_status)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_);
|
|
void ResolveClassExceptionHandlerTypes(Handle<mirror::Class> klass)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_);
|
|
void ResolveMethodExceptionHandlerTypes(ArtMethod* klass)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_);
|
|
|
|
mirror::Class* CreateProxyClass(ScopedObjectAccessAlreadyRunnable& soa,
|
|
jstring name,
|
|
jobjectArray interfaces,
|
|
jobject loader,
|
|
jobjectArray methods,
|
|
jobjectArray throws)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
std::string GetDescriptorForProxy(ObjPtr<mirror::Class> proxy_class)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
ArtMethod* FindMethodForProxy(ArtMethod* proxy_method)
|
|
REQUIRES(!Locks::dex_lock_)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Get the oat code for a method when its class isn't yet initialized.
|
|
const void* GetQuickOatCodeFor(ArtMethod* method)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
pid_t GetClassesLockOwner(); // For SignalCatcher.
|
|
pid_t GetDexLockOwner(); // For SignalCatcher.
|
|
|
|
mirror::Class* GetClassRoot(ClassRoot class_root) REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
static const char* GetClassRootDescriptor(ClassRoot class_root);
|
|
|
|
// Is the given entry point quick code to run the resolution stub?
|
|
bool IsQuickResolutionStub(const void* entry_point) const;
|
|
|
|
// Is the given entry point quick code to bridge into the interpreter?
|
|
bool IsQuickToInterpreterBridge(const void* entry_point) const;
|
|
|
|
// Is the given entry point quick code to run the generic JNI stub?
|
|
bool IsQuickGenericJniStub(const void* entry_point) const;
|
|
|
|
// Is the given entry point the JNI dlsym lookup stub?
|
|
bool IsJniDlsymLookupStub(const void* entry_point) const;
|
|
|
|
const void* GetQuickToInterpreterBridgeTrampoline() const {
|
|
return quick_to_interpreter_bridge_trampoline_;
|
|
}
|
|
|
|
InternTable* GetInternTable() const {
|
|
return intern_table_;
|
|
}
|
|
|
|
// Set the entrypoints up for method to the given code.
|
|
void SetEntryPointsToCompiledCode(ArtMethod* method, const void* method_code) const
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Set the entrypoints up for method to the enter the interpreter.
|
|
void SetEntryPointsToInterpreter(ArtMethod* method) const
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Set the entrypoints up for an obsolete method.
|
|
void SetEntryPointsForObsoleteMethod(ArtMethod* method) const
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Attempts to insert a class into a class table. Returns null if
|
|
// the class was inserted, otherwise returns an existing class with
|
|
// the same descriptor and ClassLoader.
|
|
mirror::Class* InsertClass(const char* descriptor, ObjPtr<mirror::Class> klass, size_t hash)
|
|
REQUIRES(!Locks::classlinker_classes_lock_)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Add an oat file with .bss GC roots to be visited again at the end of GC
|
|
// for collector types that need it.
|
|
void WriteBarrierForBootOatFileBssRoots(const OatFile* oat_file)
|
|
REQUIRES(!Locks::classlinker_classes_lock_)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
mirror::ObjectArray<mirror::Class>* GetClassRoots() REQUIRES_SHARED(Locks::mutator_lock_) {
|
|
mirror::ObjectArray<mirror::Class>* class_roots = class_roots_.Read();
|
|
DCHECK(class_roots != nullptr);
|
|
return class_roots;
|
|
}
|
|
|
|
// Move the class table to the pre-zygote table to reduce memory usage. This works by ensuring
|
|
// that no more classes are ever added to the pre zygote table which makes it that the pages
|
|
// always remain shared dirty instead of private dirty.
|
|
void MoveClassTableToPreZygote()
|
|
REQUIRES(!Locks::classlinker_classes_lock_)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Creates a GlobalRef PathClassLoader or DelegateLastClassLoader (specified by loader_class)
|
|
// that can be used to load classes from the given dex files. The parent of the class loader
|
|
// will be set to `parent_loader`. If `parent_loader` is null the parent will be
|
|
// the boot class loader.
|
|
// If class_loader points to a different class than PathClassLoader or DelegateLastClassLoader
|
|
// this method will abort.
|
|
// Note: the objects are not completely set up. Do not use this outside of tests and the compiler.
|
|
jobject CreateWellKnownClassLoader(Thread* self,
|
|
const std::vector<const DexFile*>& dex_files,
|
|
jclass loader_class,
|
|
jobject parent_loader)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_);
|
|
|
|
// Calls CreateWellKnownClassLoader(self,
|
|
// dex_files,
|
|
// WellKnownClasses::dalvik_system_PathClassLoader,
|
|
// nullptr)
|
|
jobject CreatePathClassLoader(Thread* self, const std::vector<const DexFile*>& dex_files)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_);
|
|
|
|
PointerSize GetImagePointerSize() const {
|
|
return image_pointer_size_;
|
|
}
|
|
|
|
// Used by image writer for checking.
|
|
bool ClassInClassTable(ObjPtr<mirror::Class> klass)
|
|
REQUIRES(Locks::classlinker_classes_lock_)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Clear the ArrayClass cache. This is necessary when cleaning up for the image, as the cache
|
|
// entries are roots, but potentially not image classes.
|
|
void DropFindArrayClassCache() REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Clean up class loaders, this needs to happen after JNI weak globals are cleared.
|
|
void CleanupClassLoaders()
|
|
REQUIRES(!Locks::classlinker_classes_lock_)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Unlike GetOrCreateAllocatorForClassLoader, GetAllocatorForClassLoader asserts that the
|
|
// allocator for this class loader is already created.
|
|
LinearAlloc* GetAllocatorForClassLoader(ObjPtr<mirror::ClassLoader> class_loader)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Return the linear alloc for a class loader if it is already allocated, otherwise allocate and
|
|
// set it. TODO: Consider using a lock other than classlinker_classes_lock_.
|
|
LinearAlloc* GetOrCreateAllocatorForClassLoader(ObjPtr<mirror::ClassLoader> class_loader)
|
|
REQUIRES(!Locks::classlinker_classes_lock_)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// May be called with null class_loader due to legacy code. b/27954959
|
|
void InsertDexFileInToClassLoader(ObjPtr<mirror::Object> dex_file,
|
|
ObjPtr<mirror::ClassLoader> class_loader)
|
|
REQUIRES(!Locks::classlinker_classes_lock_)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
static bool ShouldUseInterpreterEntrypoint(ArtMethod* method, const void* quick_code)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
std::set<DexCacheResolvedClasses> GetResolvedClasses(bool ignore_boot_classes)
|
|
REQUIRES(!Locks::dex_lock_);
|
|
|
|
static bool IsBootClassLoader(ScopedObjectAccessAlreadyRunnable& soa,
|
|
ObjPtr<mirror::ClassLoader> class_loader)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
ArtMethod* AddMethodToConflictTable(ObjPtr<mirror::Class> klass,
|
|
ArtMethod* conflict_method,
|
|
ArtMethod* interface_method,
|
|
ArtMethod* method,
|
|
bool force_new_conflict_method)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Create a conflict table with a specified capacity.
|
|
ImtConflictTable* CreateImtConflictTable(size_t count, LinearAlloc* linear_alloc);
|
|
|
|
// Static version for when the class linker is not yet created.
|
|
static ImtConflictTable* CreateImtConflictTable(size_t count,
|
|
LinearAlloc* linear_alloc,
|
|
PointerSize pointer_size);
|
|
|
|
|
|
// Create the IMT and conflict tables for a class.
|
|
void FillIMTAndConflictTables(ObjPtr<mirror::Class> klass) REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Visit all of the class tables. This is used by dex2oat to allow pruning dex caches.
|
|
template <class Visitor>
|
|
void VisitClassTables(const Visitor& visitor)
|
|
REQUIRES(!Locks::classlinker_classes_lock_)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Throw the class initialization failure recorded when first trying to initialize the given
|
|
// class.
|
|
void ThrowEarlierClassFailure(ObjPtr<mirror::Class> c, bool wrap_in_no_class_def = false)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_);
|
|
|
|
// Get the actual holding class for a copied method. Pretty slow, don't call often.
|
|
mirror::Class* GetHoldingClassOfCopiedMethod(ArtMethod* method)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Returns null if not found.
|
|
// This returns a pointer to the class-table, without requiring any locking - including the
|
|
// boot class-table. It is the caller's responsibility to access this under lock, if required.
|
|
ClassTable* ClassTableForClassLoader(ObjPtr<mirror::ClassLoader> class_loader)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
NO_THREAD_SAFETY_ANALYSIS;
|
|
|
|
void AppendToBootClassPath(Thread* self, const DexFile& dex_file)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_);
|
|
|
|
// Visit all of the class loaders in the class linker.
|
|
void VisitClassLoaders(ClassLoaderVisitor* visitor) const
|
|
REQUIRES_SHARED(Locks::classlinker_classes_lock_, Locks::mutator_lock_);
|
|
|
|
// Checks that a class and its superclass from another class loader have the same virtual methods.
|
|
bool ValidateSuperClassDescriptors(Handle<mirror::Class> klass)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
ClassHierarchyAnalysis* GetClassHierarchyAnalysis() {
|
|
return cha_.get();
|
|
}
|
|
|
|
struct DexCacheData {
|
|
// Construct an invalid data object.
|
|
DexCacheData()
|
|
: weak_root(nullptr),
|
|
dex_file(nullptr),
|
|
resolved_methods(nullptr),
|
|
class_table(nullptr) { }
|
|
|
|
// Check if the data is valid.
|
|
bool IsValid() const {
|
|
return dex_file != nullptr;
|
|
}
|
|
|
|
// Weak root to the DexCache. Note: Do not decode this unnecessarily or else class unloading may
|
|
// not work properly.
|
|
jweak weak_root;
|
|
// The following two fields are caches to the DexCache's fields and here to avoid unnecessary
|
|
// jweak decode that triggers read barriers (and mark them alive unnecessarily and mess with
|
|
// class unloading.)
|
|
const DexFile* dex_file;
|
|
mirror::MethodDexCacheType* resolved_methods;
|
|
// Identify the associated class loader's class table. This is used to make sure that
|
|
// the Java call to native DexCache.setResolvedType() inserts the resolved type in that
|
|
// class table. It is also used to make sure we don't register the same dex cache with
|
|
// multiple class loaders.
|
|
ClassTable* class_table;
|
|
};
|
|
|
|
protected:
|
|
virtual bool InitializeClass(Thread* self,
|
|
Handle<mirror::Class> klass,
|
|
bool can_run_clinit,
|
|
bool can_init_parents)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_);
|
|
|
|
virtual verifier::FailureKind PerformClassVerification(Thread* self,
|
|
Handle<mirror::Class> klass,
|
|
verifier::HardFailLogMode log_level,
|
|
std::string* error_msg)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
private:
|
|
class LinkInterfaceMethodsHelper;
|
|
|
|
struct ClassLoaderData {
|
|
jweak weak_root; // Weak root to enable class unloading.
|
|
ClassTable* class_table;
|
|
LinearAlloc* allocator;
|
|
};
|
|
|
|
// Ensures that the supertype of 'klass' ('supertype') is verified. Returns false and throws
|
|
// appropriate exceptions if verification failed hard. Returns true for successful verification or
|
|
// soft-failures.
|
|
bool AttemptSupertypeVerification(Thread* self,
|
|
Handle<mirror::Class> klass,
|
|
Handle<mirror::Class> supertype)
|
|
REQUIRES(!Locks::dex_lock_)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
void DeleteClassLoader(Thread* self, const ClassLoaderData& data)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
void VisitClassesInternal(ClassVisitor* visitor)
|
|
REQUIRES_SHARED(Locks::classlinker_classes_lock_, Locks::mutator_lock_);
|
|
|
|
// Returns the number of zygote and image classes.
|
|
size_t NumZygoteClasses() const
|
|
REQUIRES(Locks::classlinker_classes_lock_)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Returns the number of non zygote nor image classes.
|
|
size_t NumNonZygoteClasses() const
|
|
REQUIRES(Locks::classlinker_classes_lock_)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
void FinishInit(Thread* self)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_, !Roles::uninterruptible_);
|
|
|
|
// For early bootstrapping by Init
|
|
mirror::Class* AllocClass(Thread* self,
|
|
ObjPtr<mirror::Class> java_lang_Class,
|
|
uint32_t class_size)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Roles::uninterruptible_);
|
|
|
|
// Alloc* convenience functions to avoid needing to pass in mirror::Class*
|
|
// values that are known to the ClassLinker such as
|
|
// kObjectArrayClass and kJavaLangString etc.
|
|
mirror::Class* AllocClass(Thread* self, uint32_t class_size)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Roles::uninterruptible_);
|
|
|
|
mirror::DexCache* AllocDexCache(ObjPtr<mirror::String>* out_location,
|
|
Thread* self,
|
|
const DexFile& dex_file)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Roles::uninterruptible_);
|
|
|
|
// Used for tests and AppendToBootClassPath.
|
|
mirror::DexCache* AllocAndInitializeDexCache(Thread* self,
|
|
const DexFile& dex_file,
|
|
LinearAlloc* linear_alloc)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_)
|
|
REQUIRES(!Roles::uninterruptible_);
|
|
|
|
mirror::Class* CreatePrimitiveClass(Thread* self, Primitive::Type type)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Roles::uninterruptible_);
|
|
mirror::Class* InitializePrimitiveClass(ObjPtr<mirror::Class> primitive_class,
|
|
Primitive::Type type)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Roles::uninterruptible_);
|
|
|
|
mirror::Class* CreateArrayClass(Thread* self,
|
|
const char* descriptor,
|
|
size_t hash,
|
|
Handle<mirror::ClassLoader> class_loader)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_, !Roles::uninterruptible_);
|
|
|
|
void AppendToBootClassPath(const DexFile& dex_file, ObjPtr<mirror::DexCache> dex_cache)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_);
|
|
|
|
// Precomputes size needed for Class, in the case of a non-temporary class this size must be
|
|
// sufficient to hold all static fields.
|
|
uint32_t SizeOfClassWithoutEmbeddedTables(const DexFile& dex_file,
|
|
const DexFile::ClassDef& dex_class_def);
|
|
|
|
// Setup the classloader, class def index, type idx so that we can insert this class in the class
|
|
// table.
|
|
void SetupClass(const DexFile& dex_file,
|
|
const DexFile::ClassDef& dex_class_def,
|
|
Handle<mirror::Class> klass,
|
|
ObjPtr<mirror::ClassLoader> class_loader)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
void LoadClass(Thread* self,
|
|
const DexFile& dex_file,
|
|
const DexFile::ClassDef& dex_class_def,
|
|
Handle<mirror::Class> klass)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
void LoadClassMembers(Thread* self,
|
|
const DexFile& dex_file,
|
|
const uint8_t* class_data,
|
|
Handle<mirror::Class> klass)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
void LoadField(const ClassDataItemIterator& it, Handle<mirror::Class> klass, ArtField* dst)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
void LoadMethod(const DexFile& dex_file,
|
|
const ClassDataItemIterator& it,
|
|
Handle<mirror::Class> klass, ArtMethod* dst)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
void FixupStaticTrampolines(ObjPtr<mirror::Class> klass) REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Finds a class in a Path- or DexClassLoader, loading it if necessary without using JNI. Hash
|
|
// function is supposed to be ComputeModifiedUtf8Hash(descriptor). Returns true if the
|
|
// class-loader chain could be handled, false otherwise, i.e., a non-supported class-loader
|
|
// was encountered while walking the parent chain (currently only BootClassLoader and
|
|
// PathClassLoader are supported).
|
|
bool FindClassInBaseDexClassLoader(ScopedObjectAccessAlreadyRunnable& soa,
|
|
Thread* self,
|
|
const char* descriptor,
|
|
size_t hash,
|
|
Handle<mirror::ClassLoader> class_loader,
|
|
ObjPtr<mirror::Class>* result)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_);
|
|
|
|
// Finds the class in the classpath of the given class loader. It only searches the class loader
|
|
// dex files and does not recurse into its parent.
|
|
// The method checks that the provided class loader is either a PathClassLoader or a
|
|
// DexClassLoader.
|
|
// If the class is found the method returns the resolved class. Otherwise it returns null.
|
|
ObjPtr<mirror::Class> FindClassInBaseDexClassLoaderClassPath(
|
|
ScopedObjectAccessAlreadyRunnable& soa,
|
|
const char* descriptor,
|
|
size_t hash,
|
|
Handle<mirror::ClassLoader> class_loader)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_);
|
|
|
|
// Finds the class in the boot class loader.
|
|
// If the class is found the method returns the resolved class. Otherwise it returns null.
|
|
ObjPtr<mirror::Class> FindClassInBootClassLoaderClassPath(Thread* self,
|
|
const char* descriptor,
|
|
size_t hash)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_);
|
|
|
|
// Finds a class by its descriptor, returning NULL if it isn't wasn't loaded
|
|
// by the given 'class_loader'. Uses the provided hash for the descriptor.
|
|
mirror::Class* LookupClass(Thread* self,
|
|
const char* descriptor,
|
|
size_t hash,
|
|
ObjPtr<mirror::ClassLoader> class_loader)
|
|
REQUIRES(!Locks::classlinker_classes_lock_)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Find a field by its field index.
|
|
ArtField* LookupResolvedField(uint32_t field_idx,
|
|
ObjPtr<mirror::DexCache> dex_cache,
|
|
ObjPtr<mirror::ClassLoader> class_loader,
|
|
bool is_static)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
void RegisterDexFileLocked(const DexFile& dex_file,
|
|
ObjPtr<mirror::DexCache> dex_cache,
|
|
ObjPtr<mirror::ClassLoader> class_loader)
|
|
REQUIRES(Locks::dex_lock_)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
DexCacheData FindDexCacheDataLocked(const DexFile& dex_file)
|
|
REQUIRES(Locks::dex_lock_)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
static ObjPtr<mirror::DexCache> DecodeDexCache(Thread* self, const DexCacheData& data)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
// Called to ensure that the dex cache has been registered with the same class loader.
|
|
// If yes, returns the dex cache, otherwise throws InternalError and returns null.
|
|
ObjPtr<mirror::DexCache> EnsureSameClassLoader(Thread* self,
|
|
ObjPtr<mirror::DexCache> dex_cache,
|
|
const DexCacheData& data,
|
|
ObjPtr<mirror::ClassLoader> class_loader)
|
|
REQUIRES(!Locks::dex_lock_)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
bool InitializeDefaultInterfaceRecursive(Thread* self,
|
|
Handle<mirror::Class> klass,
|
|
bool can_run_clinit,
|
|
bool can_init_parents)
|
|
REQUIRES(!Locks::dex_lock_)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
bool WaitForInitializeClass(Handle<mirror::Class> klass,
|
|
Thread* self,
|
|
ObjectLock<mirror::Class>& lock);
|
|
|
|
bool IsSameDescriptorInDifferentClassContexts(Thread* self,
|
|
const char* descriptor,
|
|
Handle<mirror::ClassLoader> class_loader1,
|
|
Handle<mirror::ClassLoader> class_loader2)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
bool IsSameMethodSignatureInDifferentClassContexts(Thread* self,
|
|
ArtMethod* method,
|
|
ObjPtr<mirror::Class> klass1,
|
|
ObjPtr<mirror::Class> klass2)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
bool LinkClass(Thread* self,
|
|
const char* descriptor,
|
|
Handle<mirror::Class> klass,
|
|
Handle<mirror::ObjectArray<mirror::Class>> interfaces,
|
|
MutableHandle<mirror::Class>* h_new_class_out)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::classlinker_classes_lock_);
|
|
|
|
bool LinkSuperClass(Handle<mirror::Class> klass)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
bool LoadSuperAndInterfaces(Handle<mirror::Class> klass, const DexFile& dex_file)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_);
|
|
|
|
bool LinkMethods(Thread* self,
|
|
Handle<mirror::Class> klass,
|
|
Handle<mirror::ObjectArray<mirror::Class>> interfaces,
|
|
bool* out_new_conflict,
|
|
ArtMethod** out_imt)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
mirror::MethodHandle* ResolveMethodHandleForField(Thread* self,
|
|
const DexFile::MethodHandleItem& method_handle,
|
|
ArtMethod* referrer)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
mirror::MethodHandle* ResolveMethodHandleForMethod(Thread* self,
|
|
const DexFile* const dex_file,
|
|
const DexFile::MethodHandleItem& method_handle,
|
|
ArtMethod* referrer)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// A wrapper class representing the result of a method translation used for linking methods and
|
|
// updating superclass default methods. For each method in a classes vtable there are 4 states it
|
|
// could be in:
|
|
// 1) No translation is necessary. In this case there is no MethodTranslation object for it. This
|
|
// is the standard case and is true when the method is not overridable by a default method,
|
|
// the class defines a concrete implementation of the method, the default method implementation
|
|
// remains the same, or an abstract method stayed abstract.
|
|
// 2) The method must be translated to a different default method. We note this with
|
|
// CreateTranslatedMethod.
|
|
// 3) The method must be replaced with a conflict method. This happens when a superclass
|
|
// implements an interface with a default method and this class implements an unrelated
|
|
// interface that also defines that default method. We note this with CreateConflictingMethod.
|
|
// 4) The method must be replaced with an abstract miranda method. This happens when a superclass
|
|
// implements an interface with a default method and this class implements a subinterface of
|
|
// the superclass's interface which declares the default method abstract. We note this with
|
|
// CreateAbstractMethod.
|
|
//
|
|
// When a method translation is unnecessary (case #1), we don't put it into the
|
|
// default_translation maps. So an instance of MethodTranslation must be in one of #2-#4.
|
|
class MethodTranslation {
|
|
public:
|
|
// This slot must become a default conflict method.
|
|
static MethodTranslation CreateConflictingMethod() {
|
|
return MethodTranslation(Type::kConflict, /*translation*/nullptr);
|
|
}
|
|
|
|
// This slot must become an abstract method.
|
|
static MethodTranslation CreateAbstractMethod() {
|
|
return MethodTranslation(Type::kAbstract, /*translation*/nullptr);
|
|
}
|
|
|
|
// Use the given method as the current value for this vtable slot during translation.
|
|
static MethodTranslation CreateTranslatedMethod(ArtMethod* new_method) {
|
|
return MethodTranslation(Type::kTranslation, new_method);
|
|
}
|
|
|
|
// Returns true if this is a method that must become a conflict method.
|
|
bool IsInConflict() const {
|
|
return type_ == Type::kConflict;
|
|
}
|
|
|
|
// Returns true if this is a method that must become an abstract method.
|
|
bool IsAbstract() const {
|
|
return type_ == Type::kAbstract;
|
|
}
|
|
|
|
// Returns true if this is a method that must become a different method.
|
|
bool IsTranslation() const {
|
|
return type_ == Type::kTranslation;
|
|
}
|
|
|
|
// Get the translated version of this method.
|
|
ArtMethod* GetTranslation() const {
|
|
DCHECK(IsTranslation());
|
|
DCHECK(translation_ != nullptr);
|
|
return translation_;
|
|
}
|
|
|
|
private:
|
|
enum class Type {
|
|
kTranslation,
|
|
kConflict,
|
|
kAbstract,
|
|
};
|
|
|
|
MethodTranslation(Type type, ArtMethod* translation)
|
|
: translation_(translation), type_(type) {}
|
|
|
|
ArtMethod* const translation_;
|
|
const Type type_;
|
|
};
|
|
|
|
// Links the virtual methods for the given class and records any default methods that will need to
|
|
// be updated later.
|
|
//
|
|
// Arguments:
|
|
// * self - The current thread.
|
|
// * klass - class, whose vtable will be filled in.
|
|
// * default_translations - Vtable index to new method map.
|
|
// Any vtable entries that need to be updated with new default methods
|
|
// are stored into the default_translations map. The default_translations
|
|
// map is keyed on the vtable index that needs to be updated. We use this
|
|
// map because if we override a default method with another default
|
|
// method we need to update the vtable to point to the new method.
|
|
// Unfortunately since we copy the ArtMethod* we cannot just do a simple
|
|
// scan, we therefore store the vtable index's that might need to be
|
|
// updated with the method they will turn into.
|
|
// TODO This whole default_translations thing is very dirty. There should be a better way.
|
|
bool LinkVirtualMethods(
|
|
Thread* self,
|
|
Handle<mirror::Class> klass,
|
|
/*out*/std::unordered_map<size_t, MethodTranslation>* default_translations)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Sets up the interface lookup table (IFTable) in the correct order to allow searching for
|
|
// default methods.
|
|
bool SetupInterfaceLookupTable(Thread* self,
|
|
Handle<mirror::Class> klass,
|
|
Handle<mirror::ObjectArray<mirror::Class>> interfaces)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
|
|
enum class DefaultMethodSearchResult {
|
|
kDefaultFound,
|
|
kAbstractFound,
|
|
kDefaultConflict
|
|
};
|
|
|
|
// Find the default method implementation for 'interface_method' in 'klass', if one exists.
|
|
//
|
|
// Arguments:
|
|
// * self - The current thread.
|
|
// * target_method - The method we are trying to find a default implementation for.
|
|
// * klass - The class we are searching for a definition of target_method.
|
|
// * out_default_method - The pointer we will store the found default method to on success.
|
|
//
|
|
// Return value:
|
|
// * kDefaultFound - There were no conflicting method implementations found in the class while
|
|
// searching for target_method. The default method implementation is stored into
|
|
// out_default_method.
|
|
// * kAbstractFound - There were no conflicting method implementations found in the class while
|
|
// searching for target_method but no default implementation was found either.
|
|
// out_default_method is set to null and the method should be considered not
|
|
// implemented.
|
|
// * kDefaultConflict - Conflicting method implementations were found when searching for
|
|
// target_method. The value of *out_default_method is null.
|
|
DefaultMethodSearchResult FindDefaultMethodImplementation(
|
|
Thread* self,
|
|
ArtMethod* target_method,
|
|
Handle<mirror::Class> klass,
|
|
/*out*/ArtMethod** out_default_method) const
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Sets the imt entries and fixes up the vtable for the given class by linking all the interface
|
|
// methods. See LinkVirtualMethods for an explanation of what default_translations is.
|
|
bool LinkInterfaceMethods(
|
|
Thread* self,
|
|
Handle<mirror::Class> klass,
|
|
const std::unordered_map<size_t, MethodTranslation>& default_translations,
|
|
bool* out_new_conflict,
|
|
ArtMethod** out_imt)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
bool LinkStaticFields(Thread* self, Handle<mirror::Class> klass, size_t* class_size)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
bool LinkInstanceFields(Thread* self, Handle<mirror::Class> klass)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
bool LinkFields(Thread* self, Handle<mirror::Class> klass, bool is_static, size_t* class_size)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
void CreateReferenceInstanceOffsets(Handle<mirror::Class> klass)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
void CheckProxyConstructor(ArtMethod* constructor) const
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
void CheckProxyMethod(ArtMethod* method, ArtMethod* prototype) const
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
size_t GetDexCacheCount() REQUIRES_SHARED(Locks::mutator_lock_, Locks::dex_lock_) {
|
|
return dex_caches_.size();
|
|
}
|
|
const std::list<DexCacheData>& GetDexCachesData()
|
|
REQUIRES_SHARED(Locks::mutator_lock_, Locks::dex_lock_) {
|
|
return dex_caches_;
|
|
}
|
|
|
|
void CreateProxyConstructor(Handle<mirror::Class> klass, ArtMethod* out)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
void CreateProxyMethod(Handle<mirror::Class> klass, ArtMethod* prototype, ArtMethod* out)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Register a class loader and create its class table and allocator. Should not be called if
|
|
// these are already created.
|
|
void RegisterClassLoader(ObjPtr<mirror::ClassLoader> class_loader)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(Locks::classlinker_classes_lock_);
|
|
|
|
// Insert a new class table if not found.
|
|
ClassTable* InsertClassTableForClassLoader(ObjPtr<mirror::ClassLoader> class_loader)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(Locks::classlinker_classes_lock_);
|
|
|
|
// EnsureResolved is called to make sure that a class in the class_table_ has been resolved
|
|
// before returning it to the caller. Its the responsibility of the thread that placed the class
|
|
// in the table to make it resolved. The thread doing resolution must notify on the class' lock
|
|
// when resolution has occurred. This happens in mirror::Class::SetStatus. As resolution may
|
|
// retire a class, the version of the class in the table is returned and this may differ from
|
|
// the class passed in.
|
|
mirror::Class* EnsureResolved(Thread* self, const char* descriptor, ObjPtr<mirror::Class> klass)
|
|
WARN_UNUSED
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::dex_lock_);
|
|
|
|
void FixupTemporaryDeclaringClass(ObjPtr<mirror::Class> temp_class,
|
|
ObjPtr<mirror::Class> new_class)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
void SetClassRoot(ClassRoot class_root, ObjPtr<mirror::Class> klass)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Return the quick generic JNI stub for testing.
|
|
const void* GetRuntimeQuickGenericJniStub() const;
|
|
|
|
bool CanWeInitializeClass(ObjPtr<mirror::Class> klass,
|
|
bool can_init_statics,
|
|
bool can_init_parents)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
void UpdateClassMethods(ObjPtr<mirror::Class> klass,
|
|
LengthPrefixedArray<ArtMethod>* new_methods)
|
|
REQUIRES_SHARED(Locks::mutator_lock_)
|
|
REQUIRES(!Locks::classlinker_classes_lock_);
|
|
|
|
// Check that c1 == FindSystemClass(self, descriptor). Abort with class dumps otherwise.
|
|
void CheckSystemClass(Thread* self, Handle<mirror::Class> c1, const char* descriptor)
|
|
REQUIRES(!Locks::dex_lock_)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Allocate method arrays for interfaces.
|
|
bool AllocateIfTableMethodArrays(Thread* self,
|
|
Handle<mirror::Class> klass,
|
|
Handle<mirror::IfTable> iftable)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Sets imt_ref appropriately for LinkInterfaceMethods.
|
|
// If there is no method in the imt location of imt_ref it will store the given method there.
|
|
// Otherwise it will set the conflict method which will figure out which method to use during
|
|
// runtime.
|
|
void SetIMTRef(ArtMethod* unimplemented_method,
|
|
ArtMethod* imt_conflict_method,
|
|
ArtMethod* current_method,
|
|
/*out*/bool* new_conflict,
|
|
/*out*/ArtMethod** imt_ref) REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
void FillIMTFromIfTable(ObjPtr<mirror::IfTable> if_table,
|
|
ArtMethod* unimplemented_method,
|
|
ArtMethod* imt_conflict_method,
|
|
ObjPtr<mirror::Class> klass,
|
|
bool create_conflict_tables,
|
|
bool ignore_copied_methods,
|
|
/*out*/bool* new_conflict,
|
|
/*out*/ArtMethod** imt) REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
void FillImtFromSuperClass(Handle<mirror::Class> klass,
|
|
ArtMethod* unimplemented_method,
|
|
ArtMethod* imt_conflict_method,
|
|
bool* new_conflict,
|
|
ArtMethod** imt) REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
// Check invoke type against the referenced class. Throws IncompatibleClassChangeError
|
|
// (if `kThrowOnError`) and returns true on mismatch (kInterface on a non-interface class,
|
|
// kVirtual on interface, kDefault on interface for dex files not supporting default methods),
|
|
// otherwise returns false.
|
|
template <bool kThrowOnError, typename ClassGetter>
|
|
static bool CheckInvokeClassMismatch(ObjPtr<mirror::DexCache> dex_cache,
|
|
InvokeType type,
|
|
ClassGetter class_getter)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
// Helper that feeds the above function with `ClassGetter` doing `LookupResolvedType()`.
|
|
template <bool kThrow>
|
|
bool CheckInvokeClassMismatch(ObjPtr<mirror::DexCache> dex_cache,
|
|
InvokeType type,
|
|
uint32_t method_idx,
|
|
ObjPtr<mirror::ClassLoader> class_loader)
|
|
REQUIRES_SHARED(Locks::mutator_lock_);
|
|
|
|
std::vector<const DexFile*> boot_class_path_;
|
|
std::vector<std::unique_ptr<const DexFile>> boot_dex_files_;
|
|
|
|
// JNI weak globals and side data to allow dex caches to get unloaded. We lazily delete weak
|
|
// globals when we register new dex files.
|
|
std::list<DexCacheData> dex_caches_ GUARDED_BY(Locks::dex_lock_);
|
|
|
|
// This contains the class loaders which have class tables. It is populated by
|
|
// InsertClassTableForClassLoader.
|
|
std::list<ClassLoaderData> class_loaders_
|
|
GUARDED_BY(Locks::classlinker_classes_lock_);
|
|
|
|
// Boot class path table. Since the class loader for this is null.
|
|
std::unique_ptr<ClassTable> boot_class_table_ GUARDED_BY(Locks::classlinker_classes_lock_);
|
|
|
|
// New class roots, only used by CMS since the GC needs to mark these in the pause.
|
|
std::vector<GcRoot<mirror::Class>> new_class_roots_ GUARDED_BY(Locks::classlinker_classes_lock_);
|
|
|
|
// Boot image oat files with new .bss GC roots to be visited in the pause by CMS.
|
|
std::vector<const OatFile*> new_bss_roots_boot_oat_files_
|
|
GUARDED_BY(Locks::classlinker_classes_lock_);
|
|
|
|
// Number of times we've searched dex caches for a class. After a certain number of misses we move
|
|
// the classes into the class_table_ to avoid dex cache based searches.
|
|
Atomic<uint32_t> failed_dex_cache_class_lookups_;
|
|
|
|
// Well known mirror::Class roots.
|
|
GcRoot<mirror::ObjectArray<mirror::Class>> class_roots_;
|
|
|
|
// The interface table used by all arrays.
|
|
GcRoot<mirror::IfTable> array_iftable_;
|
|
|
|
// A cache of the last FindArrayClass results. The cache serves to avoid creating array class
|
|
// descriptors for the sake of performing FindClass.
|
|
static constexpr size_t kFindArrayCacheSize = 16;
|
|
GcRoot<mirror::Class> find_array_class_cache_[kFindArrayCacheSize];
|
|
size_t find_array_class_cache_next_victim_;
|
|
|
|
bool init_done_;
|
|
bool log_new_roots_ GUARDED_BY(Locks::classlinker_classes_lock_);
|
|
|
|
InternTable* intern_table_;
|
|
|
|
// Trampolines within the image the bounce to runtime entrypoints. Done so that there is a single
|
|
// patch point within the image. TODO: make these proper relocations.
|
|
const void* quick_resolution_trampoline_;
|
|
const void* quick_imt_conflict_trampoline_;
|
|
const void* quick_generic_jni_trampoline_;
|
|
const void* quick_to_interpreter_bridge_trampoline_;
|
|
|
|
// Image pointer size.
|
|
PointerSize image_pointer_size_;
|
|
|
|
std::unique_ptr<ClassHierarchyAnalysis> cha_;
|
|
|
|
class FindVirtualMethodHolderVisitor;
|
|
|
|
friend class AppImageClassLoadersAndDexCachesHelper;
|
|
friend struct CompilationHelper; // For Compile in ImageTest.
|
|
friend class ImageDumper; // for DexLock
|
|
friend class ImageWriter; // for GetClassRoots
|
|
friend class JniCompilerTest; // for GetRuntimeQuickGenericJniStub
|
|
friend class JniInternalTest; // for GetRuntimeQuickGenericJniStub
|
|
friend class VMClassLoader; // for LookupClass and FindClassInBaseDexClassLoader.
|
|
ART_FRIEND_TEST(ClassLinkerTest, RegisterDexFileName); // for DexLock, and RegisterDexFileLocked
|
|
ART_FRIEND_TEST(mirror::DexCacheMethodHandlesTest, Open); // for AllocDexCache
|
|
ART_FRIEND_TEST(mirror::DexCacheTest, Open); // for AllocDexCache
|
|
DISALLOW_COPY_AND_ASSIGN(ClassLinker);
|
|
};
|
|
|
|
class ClassLoadCallback {
|
|
public:
|
|
virtual ~ClassLoadCallback() {}
|
|
|
|
// If set we will replace initial_class_def & initial_dex_file with the final versions. The
|
|
// callback author is responsible for ensuring these are allocated in such a way they can be
|
|
// cleaned up if another transformation occurs. Note that both must be set or null/unchanged on
|
|
// return.
|
|
// Note: the class may be temporary, in which case a following ClassPrepare event will be a
|
|
// different object. It is the listener's responsibility to handle this.
|
|
// Note: This callback is rarely useful so a default implementation has been given that does
|
|
// nothing.
|
|
virtual void ClassPreDefine(const char* descriptor ATTRIBUTE_UNUSED,
|
|
Handle<mirror::Class> klass ATTRIBUTE_UNUSED,
|
|
Handle<mirror::ClassLoader> class_loader ATTRIBUTE_UNUSED,
|
|
const DexFile& initial_dex_file ATTRIBUTE_UNUSED,
|
|
const DexFile::ClassDef& initial_class_def ATTRIBUTE_UNUSED,
|
|
/*out*/DexFile const** final_dex_file ATTRIBUTE_UNUSED,
|
|
/*out*/DexFile::ClassDef const** final_class_def ATTRIBUTE_UNUSED)
|
|
REQUIRES_SHARED(Locks::mutator_lock_) {}
|
|
|
|
// A class has been loaded.
|
|
// Note: the class may be temporary, in which case a following ClassPrepare event will be a
|
|
// different object. It is the listener's responsibility to handle this.
|
|
virtual void ClassLoad(Handle<mirror::Class> klass) REQUIRES_SHARED(Locks::mutator_lock_) = 0;
|
|
|
|
// A class has been prepared, i.e., resolved. As the ClassLoad event might have been for a
|
|
// temporary class, provide both the former and the current class.
|
|
virtual void ClassPrepare(Handle<mirror::Class> temp_klass,
|
|
Handle<mirror::Class> klass) REQUIRES_SHARED(Locks::mutator_lock_) = 0;
|
|
};
|
|
|
|
} // namespace art
|
|
|
|
#endif // ART_RUNTIME_CLASS_LINKER_H_
|