blob: 886f586704f8c150bf4d960fb148a0a7235c426d [file] [log] [blame]
Elliott Hughes418d20f2011-09-22 14:00:39 -07001/*
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 */
Carl Shapiro0e5d75d2011-07-06 18:28:37 -070016
Brian Carlstromfc0e3212013-07-17 14:40:12 -070017#ifndef ART_RUNTIME_CLASS_LINKER_H_
18#define ART_RUNTIME_CLASS_LINKER_H_
Carl Shapiro0e5d75d2011-07-06 18:28:37 -070019
Mathieu Chartierc5dd3192015-12-09 16:38:30 -080020#include <set>
Ian Rogers6d4d9fc2011-11-30 16:24:48 -080021#include <string>
Alex Lighteb7c1442015-08-31 13:17:42 -070022#include <unordered_map>
Mathieu Chartierc5dd3192015-12-09 16:38:30 -080023#include <unordered_set>
Carl Shapiro0e5d75d2011-07-06 18:28:37 -070024#include <utility>
25#include <vector>
26
Mathieu Chartierbad02672014-08-25 13:08:22 -070027#include "base/allocator.h"
Mathieu Chartierc2e20622014-11-03 11:41:47 -080028#include "base/hash_set.h"
Elliott Hughes76160052012-12-12 16:31:20 -080029#include "base/macros.h"
Elliott Hughes76b61672012-12-12 17:47:30 -080030#include "base/mutex.h"
Mathieu Chartiercc5ebdf2015-07-27 11:19:43 -070031#include "class_table.h"
Mathieu Chartierc5dd3192015-12-09 16:38:30 -080032#include "dex_cache_resolved_classes.h"
Brian Carlstrom7e49dca2011-07-22 18:07:34 -070033#include "dex_file.h"
Hiroshi Yamauchi94f7b492014-07-22 18:08:23 -070034#include "gc_root.h"
Mathieu Chartier590fee92013-09-13 13:46:47 -070035#include "jni.h"
Brian Carlstrom58ae9412011-10-04 00:56:06 -070036#include "oat_file.h"
Mathieu Chartier83c8ee02014-01-28 14:50:23 -080037#include "object_callbacks.h"
Carl Shapiro0e5d75d2011-07-06 18:28:37 -070038
39namespace art {
Mingyao Yang98d1cc82014-05-15 17:02:16 -070040
Ian Rogers1d54e732013-05-02 21:10:01 -070041namespace gc {
42namespace space {
43 class ImageSpace;
44} // namespace space
45} // namespace gc
Ian Rogers2dd0e2c2013-01-24 12:42:14 -080046namespace mirror {
Ian Rogers33e95662013-05-20 20:29:14 -070047 class ClassLoader;
48 class DexCache;
Mathieu Chartiere401d142015-04-22 13:56:20 -070049 class DexCachePointerArray;
Ian Rogers33e95662013-05-20 20:29:14 -070050 class DexCacheTest_Open_Test;
51 class IfTable;
52 template<class T> class ObjectArray;
53 class StackTraceElement;
54} // namespace mirror
Ian Rogers1d54e732013-05-02 21:10:01 -070055
Andreas Gampe5a4b8a22014-09-11 08:30:08 -070056template<class T> class Handle;
Hiroshi Yamauchi679b1cf2015-05-21 12:05:27 -070057template<class T> class MutableHandle;
Elliott Hughescf4c6c42011-09-01 15:16:42 -070058class InternTable;
Mathieu Chartierc528dba2013-11-26 12:00:11 -080059template<class T> class ObjectLock;
Andreas Gampe7ba64962014-10-23 11:37:40 -070060class Runtime;
Mathieu Chartier2b7c4d12014-05-19 10:52:16 -070061class ScopedObjectAccessAlreadyRunnable;
Mathieu Chartier2d2621a2014-10-23 16:48:06 -070062template<size_t kNumReferences> class PACKED(4) StackHandleScope;
Elliott Hughescf4c6c42011-09-01 15:16:42 -070063
Mathieu Chartier893263b2014-03-04 11:07:42 -080064enum VisitRootFlags : uint8_t;
65
Mathieu Chartier1aa8ec22016-02-01 10:34:47 -080066class ClassVisitor {
67 public:
68 virtual ~ClassVisitor() {}
69 // Return true to continue visiting.
70 virtual bool operator()(mirror::Class* klass) = 0;
71};
72
Mathieu Chartier9b1c71e2015-09-02 18:51:54 -070073class ClassLoaderVisitor {
74 public:
75 virtual ~ClassLoaderVisitor() {}
76 virtual void Visit(mirror::ClassLoader* class_loader)
77 SHARED_REQUIRES(Locks::classlinker_classes_lock_, Locks::mutator_lock_) = 0;
78};
79
Carl Shapiro0e5d75d2011-07-06 18:28:37 -070080class ClassLinker {
81 public:
Ian Rogers6f3dbba2014-10-14 17:41:57 -070082 // Well known mirror::Class roots accessed via GetClassRoot.
83 enum ClassRoot {
84 kJavaLangClass,
85 kJavaLangObject,
86 kClassArrayClass,
87 kObjectArrayClass,
88 kJavaLangString,
89 kJavaLangDexCache,
90 kJavaLangRefReference,
Mathieu Chartierfc58af42015-04-16 18:00:39 -070091 kJavaLangReflectConstructor,
Mathieu Chartierdaaf3262015-03-24 13:30:28 -070092 kJavaLangReflectField,
Mathieu Chartierfc58af42015-04-16 18:00:39 -070093 kJavaLangReflectMethod,
Ian Rogers6f3dbba2014-10-14 17:41:57 -070094 kJavaLangReflectProxy,
95 kJavaLangStringArrayClass,
Mathieu Chartierfc58af42015-04-16 18:00:39 -070096 kJavaLangReflectConstructorArrayClass,
Mathieu Chartierdaaf3262015-03-24 13:30:28 -070097 kJavaLangReflectFieldArrayClass,
Mathieu Chartierfc58af42015-04-16 18:00:39 -070098 kJavaLangReflectMethodArrayClass,
Ian Rogers6f3dbba2014-10-14 17:41:57 -070099 kJavaLangClassLoader,
100 kJavaLangThrowable,
101 kJavaLangClassNotFoundException,
102 kJavaLangStackTraceElement,
103 kPrimitiveBoolean,
104 kPrimitiveByte,
105 kPrimitiveChar,
106 kPrimitiveDouble,
107 kPrimitiveFloat,
108 kPrimitiveInt,
109 kPrimitiveLong,
110 kPrimitiveShort,
111 kPrimitiveVoid,
112 kBooleanArrayClass,
113 kByteArrayClass,
114 kCharArrayClass,
115 kDoubleArrayClass,
116 kFloatArrayClass,
117 kIntArrayClass,
118 kLongArrayClass,
119 kShortArrayClass,
120 kJavaLangStackTraceElementArrayClass,
121 kClassRootsMax,
122 };
123
Mathieu Chartier590fee92013-09-13 13:46:47 -0700124 explicit ClassLinker(InternTable* intern_table);
Brian Carlstrom9ea1cb12011-08-24 23:18:18 -0700125 ~ClassLinker();
Carl Shapiro565f5072011-07-10 13:39:43 -0700126
Alex Light64ad14d2014-08-19 14:23:13 -0700127 // Initialize class linker by bootstraping from dex files.
Andreas Gampe3db9c5d2015-11-17 11:52:46 -0800128 bool InitWithoutImage(std::vector<std::unique_ptr<const DexFile>> boot_class_path,
129 std::string* error_msg)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700130 SHARED_REQUIRES(Locks::mutator_lock_)
131 REQUIRES(!dex_lock_);
Mathieu Chartier590fee92013-09-13 13:46:47 -0700132
Mathieu Chartierfbc31082016-01-24 11:59:56 -0800133 // Initialize class linker from one or more boot images.
134 bool InitFromBootImage(std::string* error_msg)
Andreas Gampe3db9c5d2015-11-17 11:52:46 -0800135 SHARED_REQUIRES(Locks::mutator_lock_)
136 REQUIRES(!dex_lock_);
Mathieu Chartier590fee92013-09-13 13:46:47 -0700137
Mathieu Chartierfbc31082016-01-24 11:59:56 -0800138 // Add an image space to the class linker, may fix up classloader fields and dex cache fields.
139 // The dex files that were newly opened for the space are placed in the out argument
140 // out_dex_files. Returns true if the operation succeeded.
141 // The space must be already added to the heap before calling AddImageSpace since we need to
142 // properly handle read barriers and object marking.
143 bool AddImageSpace(gc::space::ImageSpace* space,
144 Handle<mirror::ClassLoader> class_loader,
145 jobjectArray dex_elements,
146 const char* dex_location,
147 std::vector<std::unique_ptr<const DexFile>>* out_dex_files,
148 std::string* error_msg)
149 REQUIRES(!dex_lock_)
150 SHARED_REQUIRES(Locks::mutator_lock_);
151
Mathieu Chartier0b4cbd02016-03-08 16:49:58 -0800152 bool OpenImageDexFiles(gc::space::ImageSpace* space,
153 std::vector<std::unique_ptr<const DexFile>>* out_dex_files,
154 std::string* error_msg)
155 REQUIRES(!dex_lock_)
156 SHARED_REQUIRES(Locks::mutator_lock_);
157
Elliott Hughes64bf5a32011-09-20 14:43:12 -0700158 // Finds a class by its descriptor, loading it if necessary.
Brian Carlstrom74eb46a2011-08-02 20:10:14 -0700159 // If class_loader is null, searches boot_class_path_.
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700160 mirror::Class* FindClass(Thread* self,
161 const char* descriptor,
Andreas Gampe5a4b8a22014-09-11 08:30:08 -0700162 Handle<mirror::ClassLoader> class_loader)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700163 SHARED_REQUIRES(Locks::mutator_lock_)
164 REQUIRES(!dex_lock_);
Brian Carlstromaded5f72011-10-07 17:15:04 -0700165
Andreas Gampef865ea92015-04-13 22:14:19 -0700166 // Finds a class in the path class loader, loading it if necessary without using JNI. Hash
167 // function is supposed to be ComputeModifiedUtf8Hash(descriptor). Returns true if the
168 // class-loader chain could be handled, false otherwise, i.e., a non-supported class-loader
169 // was encountered while walking the parent chain (currently only BootClassLoader and
170 // PathClassLoader are supported).
171 bool FindClassInPathClassLoader(ScopedObjectAccessAlreadyRunnable& soa,
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700172 Thread* self,
173 const char* descriptor,
174 size_t hash,
Andreas Gampef865ea92015-04-13 22:14:19 -0700175 Handle<mirror::ClassLoader> class_loader,
Igor Murashkinb1d8c312015-08-04 11:18:43 -0700176 mirror::Class** result)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700177 SHARED_REQUIRES(Locks::mutator_lock_)
178 REQUIRES(!dex_lock_);
Mathieu Chartierab0ed822014-09-11 14:21:41 -0700179
Ian Rogers98379392014-02-24 16:53:16 -0800180 // Finds a class by its descriptor using the "system" class loader, ie by searching the
181 // boot_class_path_.
182 mirror::Class* FindSystemClass(Thread* self, const char* descriptor)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700183 SHARED_REQUIRES(Locks::mutator_lock_)
184 REQUIRES(!dex_lock_);
Ian Rogers98379392014-02-24 16:53:16 -0800185
186 // Finds the array class given for the element class.
Igor Murashkinb1d8c312015-08-04 11:18:43 -0700187 mirror::Class* FindArrayClass(Thread* self, mirror::Class** element_class)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700188 SHARED_REQUIRES(Locks::mutator_lock_)
189 REQUIRES(!dex_lock_);
Brian Carlstromaded5f72011-10-07 17:15:04 -0700190
Ian Rogers63557452014-06-04 16:57:15 -0700191 // Returns true if the class linker is initialized.
Ian Rogers7b078e82014-09-10 14:44:24 -0700192 bool IsInitialized() const {
193 return init_done_;
194 }
Mathieu Chartier590fee92013-09-13 13:46:47 -0700195
Brian Carlstromaded5f72011-10-07 17:15:04 -0700196 // Define a new a class based on a ClassDef from a DexFile
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700197 mirror::Class* DefineClass(Thread* self,
198 const char* descriptor,
199 size_t hash,
Andreas Gampe5a4b8a22014-09-11 08:30:08 -0700200 Handle<mirror::ClassLoader> class_loader,
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700201 const DexFile& dex_file,
202 const DexFile::ClassDef& dex_class_def)
203 SHARED_REQUIRES(Locks::mutator_lock_)
204 REQUIRES(!dex_lock_);
Elliott Hughes64bf5a32011-09-20 14:43:12 -0700205
Mathieu Chartier2cebb242015-04-21 16:50:40 -0700206 // Finds a class by its descriptor, returning null if it isn't wasn't loaded
Elliott Hughes64bf5a32011-09-20 14:43:12 -0700207 // by the given 'class_loader'.
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700208 mirror::Class* LookupClass(Thread* self,
209 const char* descriptor,
210 size_t hash,
Igor Murashkinb1d8c312015-08-04 11:18:43 -0700211 mirror::ClassLoader* class_loader)
Mathieu Chartier90443472015-07-16 20:32:27 -0700212 REQUIRES(!Locks::classlinker_classes_lock_)
213 SHARED_REQUIRES(Locks::mutator_lock_);
Carl Shapiro0e5d75d2011-07-06 18:28:37 -0700214
Elliott Hughes6fa602d2011-12-02 17:54:25 -0800215 // Finds all the classes with the given descriptor, regardless of ClassLoader.
Igor Murashkinb1d8c312015-08-04 11:18:43 -0700216 void LookupClasses(const char* descriptor, std::vector<mirror::Class*>& classes)
Mathieu Chartier90443472015-07-16 20:32:27 -0700217 REQUIRES(!Locks::classlinker_classes_lock_)
218 SHARED_REQUIRES(Locks::mutator_lock_);
Elliott Hughes6fa602d2011-12-02 17:54:25 -0800219
Mathieu Chartier90443472015-07-16 20:32:27 -0700220 mirror::Class* FindPrimitiveClass(char type) SHARED_REQUIRES(Locks::mutator_lock_);
Elliott Hughesd8ddfd52011-08-15 14:32:53 -0700221
Brian Carlstromae826982011-11-09 01:33:42 -0800222 // General class unloading is not supported, this is used to prune
223 // unwanted classes during image writing.
Igor Murashkinb1d8c312015-08-04 11:18:43 -0700224 bool RemoveClass(const char* descriptor, mirror::ClassLoader* class_loader)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700225 REQUIRES(!Locks::classlinker_classes_lock_)
226 SHARED_REQUIRES(Locks::mutator_lock_);
Brian Carlstromae826982011-11-09 01:33:42 -0800227
Ian Rogers7dfb28c2013-08-22 08:18:36 -0700228 void DumpAllClasses(int flags)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700229 REQUIRES(!Locks::classlinker_classes_lock_)
230 SHARED_REQUIRES(Locks::mutator_lock_);
Elliott Hughes9d5ccec2011-09-19 13:19:50 -0700231
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700232 void DumpForSigQuit(std::ostream& os) REQUIRES(!Locks::classlinker_classes_lock_);
Elliott Hughescac6cc72011-11-03 20:31:21 -0700233
Ian Rogers7dfb28c2013-08-22 08:18:36 -0700234 size_t NumLoadedClasses()
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700235 REQUIRES(!Locks::classlinker_classes_lock_)
236 SHARED_REQUIRES(Locks::mutator_lock_);
Elliott Hughese27955c2011-08-26 15:21:24 -0700237
Brian Carlstromb63ec392011-08-27 17:38:27 -0700238 // Resolve a String with the given index from the DexFile, storing the
Brian Carlstromaded5f72011-10-07 17:15:04 -0700239 // result in the DexCache. The referrer is used to identify the
240 // target DexCache and ClassLoader to use for resolution.
Mathieu Chartiere401d142015-04-22 13:56:20 -0700241 mirror::String* ResolveString(uint32_t string_idx, ArtMethod* referrer)
Mathieu Chartier90443472015-07-16 20:32:27 -0700242 SHARED_REQUIRES(Locks::mutator_lock_);
Brian Carlstromaded5f72011-10-07 17:15:04 -0700243
244 // Resolve a String with the given index from the DexFile, storing the
Brian Carlstrom9ea1cb12011-08-24 23:18:18 -0700245 // result in the DexCache.
Igor Murashkinb1d8c312015-08-04 11:18:43 -0700246 mirror::String* ResolveString(const DexFile& dex_file, uint32_t string_idx,
Andreas Gampe5a4b8a22014-09-11 08:30:08 -0700247 Handle<mirror::DexCache> dex_cache)
Mathieu Chartier90443472015-07-16 20:32:27 -0700248 SHARED_REQUIRES(Locks::mutator_lock_);
Brian Carlstrom9ea1cb12011-08-24 23:18:18 -0700249
Brian Carlstromb63ec392011-08-27 17:38:27 -0700250 // Resolve a Type with the given index from the DexFile, storing the
Brian Carlstrom9ea1cb12011-08-24 23:18:18 -0700251 // result in the DexCache. The referrer is used to identity the
252 // target DexCache and ClassLoader to use for resolution.
Igor Murashkinb1d8c312015-08-04 11:18:43 -0700253 mirror::Class* ResolveType(const DexFile& dex_file, uint16_t type_idx, mirror::Class* referrer)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700254 SHARED_REQUIRES(Locks::mutator_lock_)
255 REQUIRES(!dex_lock_, !Roles::uninterruptible_);
Brian Carlstrom9ea1cb12011-08-24 23:18:18 -0700256
Brian Carlstromb63ec392011-08-27 17:38:27 -0700257 // Resolve a Type with the given index from the DexFile, storing the
Ian Rogers0cfe1fb2011-08-26 03:29:44 -0700258 // result in the DexCache. The referrer is used to identify the
Brian Carlstromb63ec392011-08-27 17:38:27 -0700259 // target DexCache and ClassLoader to use for resolution.
Igor Murashkinb1d8c312015-08-04 11:18:43 -0700260 mirror::Class* ResolveType(uint16_t type_idx, ArtMethod* referrer)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700261 SHARED_REQUIRES(Locks::mutator_lock_)
262 REQUIRES(!dex_lock_, !Roles::uninterruptible_);
Ian Rogers0cfe1fb2011-08-26 03:29:44 -0700263
Igor Murashkinb1d8c312015-08-04 11:18:43 -0700264 mirror::Class* ResolveType(uint16_t type_idx, ArtField* referrer)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700265 SHARED_REQUIRES(Locks::mutator_lock_)
266 REQUIRES(!dex_lock_, !Roles::uninterruptible_);
Brian Carlstromb63ec392011-08-27 17:38:27 -0700267
Brian Carlstrom9ea1cb12011-08-24 23:18:18 -0700268 // Resolve a type with the given ID from the DexFile, storing the
269 // result in DexCache. The ClassLoader is used to search for the
270 // type, since it may be referenced from but not contained within
271 // the given DexFile.
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700272 mirror::Class* ResolveType(const DexFile& dex_file,
273 uint16_t type_idx,
Andreas Gampe5a4b8a22014-09-11 08:30:08 -0700274 Handle<mirror::DexCache> dex_cache,
275 Handle<mirror::ClassLoader> class_loader)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700276 SHARED_REQUIRES(Locks::mutator_lock_)
277 REQUIRES(!dex_lock_, !Roles::uninterruptible_);
Brian Carlstrom9ea1cb12011-08-24 23:18:18 -0700278
Andreas Gampe42ef8ab2015-12-03 17:27:32 -0800279 // Determine whether a dex cache result should be trusted, or an IncompatibleClassChangeError
280 // check should be performed even after a hit.
281 enum ResolveMode { // private.
282 kNoICCECheckForCache,
283 kForceICCECheck
284 };
285
Brian Carlstrom9ea1cb12011-08-24 23:18:18 -0700286 // Resolve a method with a given ID from the DexFile, storing the
287 // result in DexCache. The ClassLinker and ClassLoader are used as
288 // in ResolveType. What is unique is the method type argument which
289 // is used to determine if this method is a direct, static, or
290 // virtual method.
Andreas Gampe42ef8ab2015-12-03 17:27:32 -0800291 template <ResolveMode kResolveMode>
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700292 ArtMethod* ResolveMethod(const DexFile& dex_file,
293 uint32_t method_idx,
Mathieu Chartiere401d142015-04-22 13:56:20 -0700294 Handle<mirror::DexCache> dex_cache,
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700295 Handle<mirror::ClassLoader> class_loader,
296 ArtMethod* referrer,
Mathieu Chartiere401d142015-04-22 13:56:20 -0700297 InvokeType type)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700298 SHARED_REQUIRES(Locks::mutator_lock_)
299 REQUIRES(!dex_lock_, !Roles::uninterruptible_);
Brian Carlstrom9ea1cb12011-08-24 23:18:18 -0700300
Mathieu Chartiere401d142015-04-22 13:56:20 -0700301 ArtMethod* GetResolvedMethod(uint32_t method_idx, ArtMethod* referrer)
Mathieu Chartier90443472015-07-16 20:32:27 -0700302 SHARED_REQUIRES(Locks::mutator_lock_);
Alex Lightfedd91d2016-01-07 14:49:16 -0800303
304 // This returns the class referred to by GetMethodId(method_idx).class_idx_. This might be
305 // different then the declaring class of the resolved method due to copied
306 // miranda/default/conflict methods.
307 mirror::Class* ResolveReferencedClassOfMethod(Thread* self,
308 uint32_t method_idx,
309 ArtMethod* referrer)
310 SHARED_REQUIRES(Locks::mutator_lock_)
311 REQUIRES(!dex_lock_, !Roles::uninterruptible_);
Andreas Gampe42ef8ab2015-12-03 17:27:32 -0800312 template <ResolveMode kResolveMode>
Mathieu Chartiere401d142015-04-22 13:56:20 -0700313 ArtMethod* ResolveMethod(Thread* self, uint32_t method_idx, ArtMethod* referrer, InvokeType type)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700314 SHARED_REQUIRES(Locks::mutator_lock_)
315 REQUIRES(!dex_lock_, !Roles::uninterruptible_);
Jeff Hao0042c6d2015-07-29 20:14:10 -0700316 ArtMethod* ResolveMethodWithoutInvokeType(const DexFile& dex_file,
317 uint32_t method_idx,
318 Handle<mirror::DexCache> dex_cache,
319 Handle<mirror::ClassLoader> class_loader)
320 SHARED_REQUIRES(Locks::mutator_lock_)
321 REQUIRES(!dex_lock_, !Roles::uninterruptible_);
Brian Carlstrom16192862011-09-12 17:50:06 -0700322
Mathieu Chartierc7853442015-03-27 14:35:38 -0700323 ArtField* GetResolvedField(uint32_t field_idx, mirror::Class* field_declaring_class)
Mathieu Chartier90443472015-07-16 20:32:27 -0700324 SHARED_REQUIRES(Locks::mutator_lock_);
Mathieu Chartierc7853442015-03-27 14:35:38 -0700325 ArtField* GetResolvedField(uint32_t field_idx, mirror::DexCache* dex_cache)
Mathieu Chartier90443472015-07-16 20:32:27 -0700326 SHARED_REQUIRES(Locks::mutator_lock_);
Mathieu Chartiere401d142015-04-22 13:56:20 -0700327 ArtField* ResolveField(uint32_t field_idx, ArtMethod* referrer, bool is_static)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700328 SHARED_REQUIRES(Locks::mutator_lock_)
329 REQUIRES(!dex_lock_, !Roles::uninterruptible_);
Brian Carlstromb9edb842011-08-28 16:31:06 -0700330
Brian Carlstrom16192862011-09-12 17:50:06 -0700331 // Resolve a field with a given ID from the DexFile, storing the
Brian Carlstrom9ea1cb12011-08-24 23:18:18 -0700332 // result in DexCache. The ClassLinker and ClassLoader are used as
333 // in ResolveType. What is unique is the is_static argument which is
334 // used to determine if we are resolving a static or non-static
335 // field.
Igor Murashkinb1d8c312015-08-04 11:18:43 -0700336 ArtField* ResolveField(const DexFile& dex_file, uint32_t field_idx,
Mathieu Chartier90443472015-07-16 20:32:27 -0700337 Handle<mirror::DexCache> dex_cache,
Igor Murashkinb1d8c312015-08-04 11:18:43 -0700338 Handle<mirror::ClassLoader> class_loader, bool is_static)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700339 SHARED_REQUIRES(Locks::mutator_lock_)
340 REQUIRES(!dex_lock_, !Roles::uninterruptible_);
Brian Carlstrom9ea1cb12011-08-24 23:18:18 -0700341
Ian Rogersb067ac22011-12-13 18:05:09 -0800342 // Resolve a field with a given ID from the DexFile, storing the
343 // result in DexCache. The ClassLinker and ClassLoader are used as
344 // in ResolveType. No is_static argument is provided so that Java
345 // field resolution semantics are followed.
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700346 ArtField* ResolveFieldJLS(const DexFile& dex_file,
347 uint32_t field_idx,
Mathieu Chartiere401d142015-04-22 13:56:20 -0700348 Handle<mirror::DexCache> dex_cache,
349 Handle<mirror::ClassLoader> class_loader)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700350 SHARED_REQUIRES(Locks::mutator_lock_)
351 REQUIRES(!dex_lock_, !Roles::uninterruptible_);
Ian Rogersb067ac22011-12-13 18:05:09 -0800352
Ian Rogersad25ac52011-10-04 19:13:33 -0700353 // Get shorty from method index without resolution. Used to do handlerization.
Mathieu Chartiere401d142015-04-22 13:56:20 -0700354 const char* MethodShorty(uint32_t method_idx, ArtMethod* referrer, uint32_t* length)
Mathieu Chartier90443472015-07-16 20:32:27 -0700355 SHARED_REQUIRES(Locks::mutator_lock_);
Ian Rogersad25ac52011-10-04 19:13:33 -0700356
Elliott Hughesf4c21c92011-08-19 17:31:31 -0700357 // Returns true on success, false if there's an exception pending.
Brian Carlstrom25c33252011-09-18 15:58:35 -0700358 // can_run_clinit=false allows the compiler to attempt to init a class,
359 // given the restriction that no <clinit> execution is possible.
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700360 bool EnsureInitialized(Thread* self,
361 Handle<mirror::Class> c,
362 bool can_init_fields,
Ian Rogers7b078e82014-09-10 14:44:24 -0700363 bool can_init_parents)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700364 SHARED_REQUIRES(Locks::mutator_lock_)
365 REQUIRES(!dex_lock_, !Roles::uninterruptible_);
Carl Shapiro0e5d75d2011-07-06 18:28:37 -0700366
Elliott Hughes2a20cfd2011-09-23 19:30:41 -0700367 // Initializes classes that have instances in the image but that have
368 // <clinit> methods so they could not be initialized by the compiler.
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700369 void RunRootClinits()
370 SHARED_REQUIRES(Locks::mutator_lock_)
Mathieu Chartier4e2cb092015-07-22 16:17:51 -0700371 REQUIRES(!dex_lock_, !Roles::uninterruptible_);
Elliott Hughes2a20cfd2011-09-23 19:30:41 -0700372
Mathieu Chartierd57d4542015-10-14 10:55:30 -0700373 mirror::DexCache* RegisterDexFile(const DexFile& dex_file, LinearAlloc* linear_alloc)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700374 REQUIRES(!dex_lock_)
375 SHARED_REQUIRES(Locks::mutator_lock_);
Andreas Gampe5a4b8a22014-09-11 08:30:08 -0700376 void RegisterDexFile(const DexFile& dex_file, Handle<mirror::DexCache> dex_cache)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700377 REQUIRES(!dex_lock_)
378 SHARED_REQUIRES(Locks::mutator_lock_);
Carl Shapiro0e5d75d2011-07-06 18:28:37 -0700379
Brian Carlstrom8a487412011-08-29 20:08:52 -0700380 const std::vector<const DexFile*>& GetBootClassPath() {
381 return boot_class_path_;
382 }
383
Mathieu Chartiere0671ce2015-07-28 17:23:28 -0700384 void VisitClasses(ClassVisitor* visitor)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700385 REQUIRES(!Locks::classlinker_classes_lock_)
386 SHARED_REQUIRES(Locks::mutator_lock_);
Ian Rogersdbf3be02014-08-29 15:40:08 -0700387
388 // Less efficient variant of VisitClasses that copies the class_table_ into secondary storage
389 // so that it can visit individual classes without holding the doesn't hold the
390 // Locks::classlinker_classes_lock_. As the Locks::classlinker_classes_lock_ isn't held this code
391 // can race with insertion and deletion of classes while the visitor is being called.
Mathieu Chartiere0671ce2015-07-28 17:23:28 -0700392 void VisitClassesWithoutClassesLock(ClassVisitor* visitor)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700393 SHARED_REQUIRES(Locks::mutator_lock_)
394 REQUIRES(!dex_lock_);
Elliott Hughesa2155262011-11-16 16:26:58 -0800395
Mathieu Chartierbb87e0f2015-04-03 11:21:55 -0700396 void VisitClassRoots(RootVisitor* visitor, VisitRootFlags flags)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700397 REQUIRES(!Locks::classlinker_classes_lock_)
398 SHARED_REQUIRES(Locks::mutator_lock_);
Mathieu Chartierbb87e0f2015-04-03 11:21:55 -0700399 void VisitRoots(RootVisitor* visitor, VisitRootFlags flags)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700400 REQUIRES(!dex_lock_)
401 SHARED_REQUIRES(Locks::mutator_lock_);
Brian Carlstrom75cb3b42011-07-28 02:13:36 -0700402
Mathieu Chartier673ed3d2015-08-28 14:56:43 -0700403 mirror::DexCache* FindDexCache(Thread* self,
404 const DexFile& dex_file,
405 bool allow_failure = false)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700406 REQUIRES(!dex_lock_)
407 SHARED_REQUIRES(Locks::mutator_lock_);
Mathieu Chartiere401d142015-04-22 13:56:20 -0700408 void FixupDexCaches(ArtMethod* resolution_method)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700409 REQUIRES(!dex_lock_)
410 SHARED_REQUIRES(Locks::mutator_lock_);
Brian Carlstrom1d9f52b2011-10-13 10:50:45 -0700411
Ian Rogersc0542af2014-09-03 16:16:56 -0700412 // Allocate an instance of a java.lang.Object.
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700413 mirror::Object* AllocObject(Thread* self)
414 SHARED_REQUIRES(Locks::mutator_lock_)
Mathieu Chartier4e2cb092015-07-22 16:17:51 -0700415 REQUIRES(!Roles::uninterruptible_);
Ian Rogersc0542af2014-09-03 16:16:56 -0700416
Elliott Hughes418d20f2011-09-22 14:00:39 -0700417 // TODO: replace this with multiple methods that allocate the correct managed type.
Shih-wei Liao44175362011-08-28 16:59:17 -0700418 template <class T>
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800419 mirror::ObjectArray<T>* AllocObjectArray(Thread* self, size_t length)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700420 SHARED_REQUIRES(Locks::mutator_lock_)
421 REQUIRES(!Roles::uninterruptible_);
Shih-wei Liao55df06b2011-08-26 14:39:27 -0700422
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800423 mirror::ObjectArray<mirror::Class>* AllocClassArray(Thread* self, size_t length)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700424 SHARED_REQUIRES(Locks::mutator_lock_)
425 REQUIRES(!Roles::uninterruptible_);
jeffhao98eacac2011-09-14 16:11:53 -0700426
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800427 mirror::ObjectArray<mirror::String>* AllocStringArray(Thread* self, size_t length)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700428 SHARED_REQUIRES(Locks::mutator_lock_)
429 REQUIRES(!Roles::uninterruptible_);
Mathieu Chartier4e2cb092015-07-22 16:17:51 -0700430
Mathieu Chartier951ec2c2015-09-22 08:50:05 -0700431 LengthPrefixedArray<ArtField>* AllocArtFieldArray(Thread* self,
432 LinearAlloc* allocator,
433 size_t length);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800434
Mathieu Chartier951ec2c2015-09-22 08:50:05 -0700435 LengthPrefixedArray<ArtMethod>* AllocArtMethodArray(Thread* self,
436 LinearAlloc* allocator,
437 size_t length);
Mathieu Chartiere401d142015-04-22 13:56:20 -0700438
439 mirror::PointerArray* AllocPointerArray(Thread* self, size_t length)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700440 SHARED_REQUIRES(Locks::mutator_lock_)
441 REQUIRES(!Roles::uninterruptible_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800442
443 mirror::IfTable* AllocIfTable(Thread* self, size_t ifcount)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700444 SHARED_REQUIRES(Locks::mutator_lock_)
445 REQUIRES(!Roles::uninterruptible_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800446
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700447 mirror::ObjectArray<mirror::StackTraceElement>* AllocStackTraceElementArray(Thread* self,
448 size_t length)
449 SHARED_REQUIRES(Locks::mutator_lock_)
450 REQUIRES(!Roles::uninterruptible_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800451
Andreas Gampe7fe30232016-03-25 16:58:00 -0700452 void VerifyClass(Thread* self,
453 Handle<mirror::Class> klass,
454 LogSeverity log_level = LogSeverity::NONE)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700455 SHARED_REQUIRES(Locks::mutator_lock_)
456 REQUIRES(!dex_lock_);
457 bool VerifyClassUsingOatFile(const DexFile& dex_file,
458 mirror::Class* klass,
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800459 mirror::Class::Status& oat_file_class_status)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700460 SHARED_REQUIRES(Locks::mutator_lock_)
461 REQUIRES(!dex_lock_);
Alex Light5a559862016-01-29 12:24:48 -0800462 void ResolveClassExceptionHandlerTypes(Handle<mirror::Class> klass)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700463 SHARED_REQUIRES(Locks::mutator_lock_)
464 REQUIRES(!dex_lock_);
Alex Light5a559862016-01-29 12:24:48 -0800465 void ResolveMethodExceptionHandlerTypes(ArtMethod* klass)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700466 SHARED_REQUIRES(Locks::mutator_lock_)
467 REQUIRES(!dex_lock_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800468
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700469 mirror::Class* CreateProxyClass(ScopedObjectAccessAlreadyRunnable& soa,
470 jstring name,
471 jobjectArray interfaces,
472 jobject loader,
473 jobjectArray methods,
Mathieu Chartier2b7c4d12014-05-19 10:52:16 -0700474 jobjectArray throws)
Mathieu Chartier90443472015-07-16 20:32:27 -0700475 SHARED_REQUIRES(Locks::mutator_lock_);
Nicolas Geoffray3a090922015-11-24 09:17:30 +0000476 std::string GetDescriptorForProxy(mirror::Class* proxy_class)
Mathieu Chartier90443472015-07-16 20:32:27 -0700477 SHARED_REQUIRES(Locks::mutator_lock_);
Igor Murashkinb1d8c312015-08-04 11:18:43 -0700478 ArtMethod* FindMethodForProxy(mirror::Class* proxy_class, ArtMethod* proxy_method)
Mathieu Chartier90443472015-07-16 20:32:27 -0700479 REQUIRES(!dex_lock_)
480 SHARED_REQUIRES(Locks::mutator_lock_);
Jesse Wilson95caa792011-10-12 18:14:17 -0400481
Ian Rogers19846512012-02-24 11:42:47 -0800482 // Get the oat code for a method when its class isn't yet initialized
Mathieu Chartiere401d142015-04-22 13:56:20 -0700483 const void* GetQuickOatCodeFor(ArtMethod* method)
Mathieu Chartier90443472015-07-16 20:32:27 -0700484 SHARED_REQUIRES(Locks::mutator_lock_);
Ian Rogers19846512012-02-24 11:42:47 -0800485
Hiroshi Yamauchi9bdec882014-08-15 17:11:12 -0700486 // Get compiled code for a method, return null if no code
487 // exists. This is unlike Get..OatCodeFor which will return a bridge
488 // or interpreter entrypoint.
Mathieu Chartiere401d142015-04-22 13:56:20 -0700489 const void* GetOatMethodQuickCodeFor(ArtMethod* method)
Mathieu Chartier90443472015-07-16 20:32:27 -0700490 SHARED_REQUIRES(Locks::mutator_lock_);
Hiroshi Yamauchi9bdec882014-08-15 17:11:12 -0700491
Igor Murashkinb1d8c312015-08-04 11:18:43 -0700492 const OatFile::OatMethod FindOatMethodFor(ArtMethod* method, bool* found)
Mathieu Chartier90443472015-07-16 20:32:27 -0700493 SHARED_REQUIRES(Locks::mutator_lock_);
Nicolas Geoffray9523a3e2015-07-17 11:51:28 +0000494
Brian Carlstrom7934ac22013-07-26 10:54:15 -0700495 pid_t GetClassesLockOwner(); // For SignalCatcher.
496 pid_t GetDexLockOwner(); // For SignalCatcher.
Brian Carlstrom24a3c2e2011-10-17 18:07:52 -0700497
Mathieu Chartier90443472015-07-16 20:32:27 -0700498 mirror::Class* GetClassRoot(ClassRoot class_root) SHARED_REQUIRES(Locks::mutator_lock_);
Jeff Hao0aba0ba2013-06-03 14:49:28 -0700499
Ian Rogers6f3dbba2014-10-14 17:41:57 -0700500 static const char* GetClassRootDescriptor(ClassRoot class_root);
Andreas Gampe2da88232014-02-27 12:26:20 -0800501
Ian Rogers6f3dbba2014-10-14 17:41:57 -0700502 // Is the given entry point quick code to run the resolution stub?
503 bool IsQuickResolutionStub(const void* entry_point) const;
Jeff Hao88474b42013-10-23 16:24:40 -0700504
Ian Rogers6f3dbba2014-10-14 17:41:57 -0700505 // Is the given entry point quick code to bridge into the interpreter?
506 bool IsQuickToInterpreterBridge(const void* entry_point) const;
507
508 // Is the given entry point quick code to run the generic JNI stub?
509 bool IsQuickGenericJniStub(const void* entry_point) const;
Vladimir Marko8a630572014-04-09 18:45:35 +0100510
Jeff Hao88474b42013-10-23 16:24:40 -0700511 InternTable* GetInternTable() const {
512 return intern_table_;
513 }
514
Ian Rogers6f3dbba2014-10-14 17:41:57 -0700515 // Set the entrypoints up for method to the given code.
Mathieu Chartiere401d142015-04-22 13:56:20 -0700516 void SetEntryPointsToCompiledCode(ArtMethod* method, const void* method_code) const
Mathieu Chartier90443472015-07-16 20:32:27 -0700517 SHARED_REQUIRES(Locks::mutator_lock_);
Ian Rogers6f3dbba2014-10-14 17:41:57 -0700518
519 // Set the entrypoints up for method to the enter the interpreter.
Mathieu Chartiere401d142015-04-22 13:56:20 -0700520 void SetEntryPointsToInterpreter(ArtMethod* method) const
Mathieu Chartier90443472015-07-16 20:32:27 -0700521 SHARED_REQUIRES(Locks::mutator_lock_);
Ian Rogers6f3dbba2014-10-14 17:41:57 -0700522
Mathieu Chartier2cebb242015-04-21 16:50:40 -0700523 // Attempts to insert a class into a class table. Returns null if
Ian Rogers848871b2013-08-05 10:56:33 -0700524 // the class was inserted, otherwise returns an existing class with
525 // the same descriptor and ClassLoader.
Ian Rogers7dfb28c2013-08-22 08:18:36 -0700526 mirror::Class* InsertClass(const char* descriptor, mirror::Class* klass, size_t hash)
Mathieu Chartier90443472015-07-16 20:32:27 -0700527 REQUIRES(!Locks::classlinker_classes_lock_)
528 SHARED_REQUIRES(Locks::mutator_lock_);
Ian Rogers848871b2013-08-05 10:56:33 -0700529
Mathieu Chartier90443472015-07-16 20:32:27 -0700530 mirror::ObjectArray<mirror::Class>* GetClassRoots() SHARED_REQUIRES(Locks::mutator_lock_) {
Hiroshi Yamauchi94f7b492014-07-22 18:08:23 -0700531 mirror::ObjectArray<mirror::Class>* class_roots = class_roots_.Read();
Mathieu Chartier2cebb242015-04-21 16:50:40 -0700532 DCHECK(class_roots != nullptr);
Mingyao Yang98d1cc82014-05-15 17:02:16 -0700533 return class_roots;
534 }
535
Mathieu Chartier073b16c2015-11-10 14:13:23 -0800536 // Move all of the boot image classes into the class table for faster lookups.
537 void AddBootImageClassesToClassTable()
Mathieu Chartier90443472015-07-16 20:32:27 -0700538 REQUIRES(!Locks::classlinker_classes_lock_)
539 SHARED_REQUIRES(Locks::mutator_lock_);
Mathieu Chartier073b16c2015-11-10 14:13:23 -0800540
541 // Add image classes to the class table.
Jeff Haodcdc85b2015-12-04 14:06:18 -0800542 void AddImageClassesToClassTable(std::vector<gc::space::ImageSpace*> image_spaces,
Mathieu Chartier073b16c2015-11-10 14:13:23 -0800543 mirror::ClassLoader* class_loader)
544 REQUIRES(!Locks::classlinker_classes_lock_)
545 SHARED_REQUIRES(Locks::mutator_lock_);
546
Mathieu Chartierc2e20622014-11-03 11:41:47 -0800547 // Move the class table to the pre-zygote table to reduce memory usage. This works by ensuring
548 // that no more classes are ever added to the pre zygote table which makes it that the pages
549 // always remain shared dirty instead of private dirty.
550 void MoveClassTableToPreZygote()
Mathieu Chartier90443472015-07-16 20:32:27 -0700551 REQUIRES(!Locks::classlinker_classes_lock_)
552 SHARED_REQUIRES(Locks::mutator_lock_);
Mathieu Chartierc2e20622014-11-03 11:41:47 -0800553
Andreas Gampe81c6f8d2015-03-25 17:19:53 -0700554 // Creates a GlobalRef PathClassLoader that can be used to load classes from the given dex files.
555 // Note: the objects are not completely set up. Do not use this outside of tests and the compiler.
Mathieu Chartier966878d2016-01-14 14:33:29 -0800556 jobject CreatePathClassLoader(Thread* self, std::vector<const DexFile*>& dex_files)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700557 SHARED_REQUIRES(Locks::mutator_lock_)
558 REQUIRES(!dex_lock_);
Andreas Gampe81c6f8d2015-03-25 17:19:53 -0700559
Mathieu Chartiere401d142015-04-22 13:56:20 -0700560 size_t GetImagePointerSize() const {
561 DCHECK(ValidPointerSize(image_pointer_size_)) << image_pointer_size_;
562 return image_pointer_size_;
563 }
564
565 // Used by image writer for checking.
566 bool ClassInClassTable(mirror::Class* klass)
Mathieu Chartier673ed3d2015-08-28 14:56:43 -0700567 REQUIRES(Locks::classlinker_classes_lock_)
Mathieu Chartier90443472015-07-16 20:32:27 -0700568 SHARED_REQUIRES(Locks::mutator_lock_);
Mathieu Chartiera89d7ed2014-12-05 10:57:13 -0800569
Nicolas Geoffray796d6302016-03-13 22:22:31 +0000570 ArtMethod* CreateRuntimeMethod(LinearAlloc* linear_alloc);
Mathieu Chartiere401d142015-04-22 13:56:20 -0700571
Andreas Gampe8ac75952015-06-02 21:01:45 -0700572 // Clear the ArrayClass cache. This is necessary when cleaning up for the image, as the cache
573 // entries are roots, but potentially not image classes.
Mathieu Chartier90443472015-07-16 20:32:27 -0700574 void DropFindArrayClassCache() SHARED_REQUIRES(Locks::mutator_lock_);
Andreas Gampe8ac75952015-06-02 21:01:45 -0700575
Mathieu Chartier951ec2c2015-09-22 08:50:05 -0700576 // Clean up class loaders, this needs to happen after JNI weak globals are cleared.
577 void CleanupClassLoaders()
Mathieu Chartier00310e02015-10-17 12:46:42 -0700578 REQUIRES(!Locks::classlinker_classes_lock_)
579 SHARED_REQUIRES(Locks::mutator_lock_);
Mathieu Chartier951ec2c2015-09-22 08:50:05 -0700580
Mathieu Chartier32cc9ee2015-10-15 09:19:15 -0700581 // Unlike GetOrCreateAllocatorForClassLoader, GetAllocatorForClassLoader asserts that the
582 // allocator for this class loader is already created.
Mathieu Chartier5b830502016-03-02 10:30:23 -0800583 LinearAlloc* GetAllocatorForClassLoader(mirror::ClassLoader* class_loader)
Nicolas Geoffray7de5dfe2015-09-22 09:48:02 +0000584 SHARED_REQUIRES(Locks::mutator_lock_);
Mathieu Chartier951ec2c2015-09-22 08:50:05 -0700585
Mathieu Chartierd57d4542015-10-14 10:55:30 -0700586 // Return the linear alloc for a class loader if it is already allocated, otherwise allocate and
587 // set it. TODO: Consider using a lock other than classlinker_classes_lock_.
Mathieu Chartier5b830502016-03-02 10:30:23 -0800588 LinearAlloc* GetOrCreateAllocatorForClassLoader(mirror::ClassLoader* class_loader)
Mathieu Chartier00310e02015-10-17 12:46:42 -0700589 REQUIRES(!Locks::classlinker_classes_lock_)
590 SHARED_REQUIRES(Locks::mutator_lock_);
591
592 void InsertDexFileInToClassLoader(mirror::Object* dex_file, mirror::ClassLoader* class_loader)
593 REQUIRES(!Locks::classlinker_classes_lock_)
594 SHARED_REQUIRES(Locks::mutator_lock_);
Mathieu Chartierd57d4542015-10-14 10:55:30 -0700595
Tamas Berghammerdd5e5e92016-02-12 16:29:00 +0000596 static bool ShouldUseInterpreterEntrypoint(ArtMethod* method, const void* quick_code)
597 SHARED_REQUIRES(Locks::mutator_lock_);
598
Mathieu Chartierc5dd3192015-12-09 16:38:30 -0800599 std::set<DexCacheResolvedClasses> GetResolvedClasses(bool ignore_boot_classes)
600 REQUIRES(!dex_lock_);
601
602 std::unordered_set<std::string> GetClassDescriptorsForProfileKeys(
603 const std::set<DexCacheResolvedClasses>& classes)
604 REQUIRES(!dex_lock_);
605
Hiroshi Yamauchi04302db2015-11-11 23:45:34 -0800606 struct DexCacheData {
607 // Weak root to the DexCache. Note: Do not decode this unnecessarily or else class unloading may
608 // not work properly.
609 jweak weak_root;
610 // The following two fields are caches to the DexCache's fields and here to avoid unnecessary
611 // jweak decode that triggers read barriers (and mark them alive unnecessarily and mess with
612 // class unloading.)
613 const DexFile* dex_file;
614 GcRoot<mirror::Class>* resolved_types;
615 };
616
Mathieu Chartier951ec2c2015-09-22 08:50:05 -0700617 private:
618 struct ClassLoaderData {
Mathieu Chartierc3fcd412015-09-25 16:54:59 -0700619 jweak weak_root; // Weak root to enable class unloading.
Mathieu Chartier951ec2c2015-09-22 08:50:05 -0700620 ClassTable* class_table;
621 LinearAlloc* allocator;
622 };
623
Alex Lightf1f10492015-10-07 16:08:36 -0700624 // Ensures that the supertype of 'klass' ('supertype') is verified. Returns false and throws
625 // appropriate exceptions if verification failed hard. Returns true for successful verification or
626 // soft-failures.
627 bool AttemptSupertypeVerification(Thread* self,
628 Handle<mirror::Class> klass,
629 Handle<mirror::Class> supertype)
630 REQUIRES(!dex_lock_)
631 SHARED_REQUIRES(Locks::mutator_lock_);
632
Nicolas Geoffray1dad3f62015-10-23 14:59:54 +0100633 static void DeleteClassLoader(Thread* self, const ClassLoaderData& data)
634 REQUIRES(Locks::classlinker_classes_lock_)
635 SHARED_REQUIRES(Locks::mutator_lock_);
636
Mathieu Chartier9b1c71e2015-09-02 18:51:54 -0700637 void VisitClassLoaders(ClassLoaderVisitor* visitor) const
638 SHARED_REQUIRES(Locks::classlinker_classes_lock_, Locks::mutator_lock_);
639
Mathieu Chartiere0671ce2015-07-28 17:23:28 -0700640 void VisitClassesInternal(ClassVisitor* visitor)
Mathieu Chartier9b1c71e2015-09-02 18:51:54 -0700641 SHARED_REQUIRES(Locks::classlinker_classes_lock_, Locks::mutator_lock_);
Mathieu Chartiercc5ebdf2015-07-27 11:19:43 -0700642
643 // Returns the number of zygote and image classes.
Mathieu Chartier6b069532015-08-05 15:08:12 -0700644 size_t NumZygoteClasses() const
645 REQUIRES(Locks::classlinker_classes_lock_)
646 SHARED_REQUIRES(Locks::mutator_lock_);
Mathieu Chartiercc5ebdf2015-07-27 11:19:43 -0700647
648 // Returns the number of non zygote nor image classes.
Mathieu Chartier6b069532015-08-05 15:08:12 -0700649 size_t NumNonZygoteClasses() const
650 REQUIRES(Locks::classlinker_classes_lock_)
651 SHARED_REQUIRES(Locks::mutator_lock_);
Mathieu Chartiercc5ebdf2015-07-27 11:19:43 -0700652
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700653 void FinishInit(Thread* self)
Mathieu Chartiera808bac2015-11-05 16:33:15 -0800654 SHARED_REQUIRES(Locks::mutator_lock_)
Mathieu Chartier4e2cb092015-07-22 16:17:51 -0700655 REQUIRES(!dex_lock_, !Roles::uninterruptible_);
Brian Carlstroma663ea52011-08-19 23:33:41 -0700656
Brian Carlstrom75cb3b42011-07-28 02:13:36 -0700657 // For early bootstrapping by Init
Ian Rogers6fac4472014-02-25 17:01:10 -0800658 mirror::Class* AllocClass(Thread* self, mirror::Class* java_lang_Class, uint32_t class_size)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700659 SHARED_REQUIRES(Locks::mutator_lock_)
660 REQUIRES(!Roles::uninterruptible_);
Brian Carlstrom75cb3b42011-07-28 02:13:36 -0700661
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800662 // Alloc* convenience functions to avoid needing to pass in mirror::Class*
Brian Carlstrom75cb3b42011-07-28 02:13:36 -0700663 // values that are known to the ClassLinker such as
664 // kObjectArrayClass and kJavaLangString etc.
Ian Rogers6fac4472014-02-25 17:01:10 -0800665 mirror::Class* AllocClass(Thread* self, uint32_t class_size)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700666 SHARED_REQUIRES(Locks::mutator_lock_)
667 REQUIRES(!Roles::uninterruptible_);
Mathieu Chartierd57d4542015-10-14 10:55:30 -0700668 mirror::DexCache* AllocDexCache(Thread* self,
669 const DexFile& dex_file,
670 LinearAlloc* linear_alloc)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700671 SHARED_REQUIRES(Locks::mutator_lock_)
672 REQUIRES(!Roles::uninterruptible_);
Ian Rogersbdb03912011-09-14 00:55:44 -0700673
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800674 mirror::Class* CreatePrimitiveClass(Thread* self, Primitive::Type type)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700675 SHARED_REQUIRES(Locks::mutator_lock_)
676 REQUIRES(!Roles::uninterruptible_);
Ian Rogers2dd0e2c2013-01-24 12:42:14 -0800677 mirror::Class* InitializePrimitiveClass(mirror::Class* primitive_class, Primitive::Type type)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700678 SHARED_REQUIRES(Locks::mutator_lock_)
679 REQUIRES(!Roles::uninterruptible_);
Brian Carlstroma331b3c2011-07-18 17:47:56 -0700680
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700681 mirror::Class* CreateArrayClass(Thread* self,
682 const char* descriptor,
683 size_t hash,
Andreas Gampe5a4b8a22014-09-11 08:30:08 -0700684 Handle<mirror::ClassLoader> class_loader)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700685 SHARED_REQUIRES(Locks::mutator_lock_)
686 REQUIRES(!dex_lock_, !Roles::uninterruptible_);
Brian Carlstroma331b3c2011-07-18 17:47:56 -0700687
Ian Rogers7b078e82014-09-10 14:44:24 -0700688 void AppendToBootClassPath(Thread* self, const DexFile& dex_file)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700689 SHARED_REQUIRES(Locks::mutator_lock_)
690 REQUIRES(!dex_lock_);
Andreas Gampe5a4b8a22014-09-11 08:30:08 -0700691 void AppendToBootClassPath(const DexFile& dex_file, Handle<mirror::DexCache> dex_cache)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700692 SHARED_REQUIRES(Locks::mutator_lock_)
693 REQUIRES(!dex_lock_);
Brian Carlstrom578bbdc2011-07-21 14:07:47 -0700694
Mingyao Yang98d1cc82014-05-15 17:02:16 -0700695 // Precomputes size needed for Class, in the case of a non-temporary class this size must be
696 // sufficient to hold all static fields.
697 uint32_t SizeOfClassWithoutEmbeddedTables(const DexFile& dex_file,
698 const DexFile::ClassDef& dex_class_def);
Brian Carlstrom4873d462011-08-21 15:23:39 -0700699
Mathieu Chartierc7853442015-03-27 14:35:38 -0700700 // Setup the classloader, class def index, type idx so that we can insert this class in the class
701 // table.
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700702 void SetupClass(const DexFile& dex_file,
703 const DexFile::ClassDef& dex_class_def,
704 Handle<mirror::Class> klass,
705 mirror::ClassLoader* class_loader)
Mathieu Chartier90443472015-07-16 20:32:27 -0700706 SHARED_REQUIRES(Locks::mutator_lock_);
Mathieu Chartierc7853442015-03-27 14:35:38 -0700707
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700708 void LoadClass(Thread* self,
709 const DexFile& dex_file,
710 const DexFile::ClassDef& dex_class_def,
Mathieu Chartierc7853442015-03-27 14:35:38 -0700711 Handle<mirror::Class> klass)
Mathieu Chartier90443472015-07-16 20:32:27 -0700712 SHARED_REQUIRES(Locks::mutator_lock_);
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700713 void LoadClassMembers(Thread* self,
714 const DexFile& dex_file,
715 const uint8_t* class_data,
716 Handle<mirror::Class> klass,
717 const OatFile::OatClass* oat_class)
Mathieu Chartier90443472015-07-16 20:32:27 -0700718 SHARED_REQUIRES(Locks::mutator_lock_);
Brian Carlstrom578bbdc2011-07-21 14:07:47 -0700719
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700720 void LoadField(const ClassDataItemIterator& it, Handle<mirror::Class> klass, ArtField* dst)
Mathieu Chartier90443472015-07-16 20:32:27 -0700721 SHARED_REQUIRES(Locks::mutator_lock_);
Brian Carlstrom578bbdc2011-07-21 14:07:47 -0700722
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700723 void LoadMethod(Thread* self,
724 const DexFile& dex_file,
725 const ClassDataItemIterator& it,
Igor Murashkinb1d8c312015-08-04 11:18:43 -0700726 Handle<mirror::Class> klass, ArtMethod* dst)
Mathieu Chartier90443472015-07-16 20:32:27 -0700727 SHARED_REQUIRES(Locks::mutator_lock_);
Brian Carlstrom934486c2011-07-12 23:42:50 -0700728
Mathieu Chartier90443472015-07-16 20:32:27 -0700729 void FixupStaticTrampolines(mirror::Class* klass) SHARED_REQUIRES(Locks::mutator_lock_);
Ian Rogers19846512012-02-24 11:42:47 -0800730
Ian Rogers97b52f82014-08-14 11:34:07 -0700731 // Finds the associated oat class for a dex_file and descriptor. Returns an invalid OatClass on
732 // error and sets found to false.
Igor Murashkinb1d8c312015-08-04 11:18:43 -0700733 OatFile::OatClass FindOatClass(const DexFile& dex_file, uint16_t class_def_idx, bool* found)
Mathieu Chartier90443472015-07-16 20:32:27 -0700734 SHARED_REQUIRES(Locks::mutator_lock_);
Ian Rogers19846512012-02-24 11:42:47 -0800735
Andreas Gampe5a4b8a22014-09-11 08:30:08 -0700736 void RegisterDexFileLocked(const DexFile& dex_file, Handle<mirror::DexCache> dex_cache)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700737 REQUIRES(dex_lock_)
738 SHARED_REQUIRES(Locks::mutator_lock_);
739 mirror::DexCache* FindDexCacheLocked(Thread* self, const DexFile& dex_file, bool allow_failure)
Mathieu Chartier673ed3d2015-08-28 14:56:43 -0700740 REQUIRES(dex_lock_)
741 SHARED_REQUIRES(Locks::mutator_lock_);
Brian Carlstromaded5f72011-10-07 17:15:04 -0700742
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700743 bool InitializeClass(Thread* self,
744 Handle<mirror::Class> klass,
745 bool can_run_clinit,
Mathieu Chartierc528dba2013-11-26 12:00:11 -0800746 bool can_init_parents)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700747 SHARED_REQUIRES(Locks::mutator_lock_)
748 REQUIRES(!dex_lock_);
Alex Lighteb7c1442015-08-31 13:17:42 -0700749 bool InitializeDefaultInterfaceRecursive(Thread* self,
750 Handle<mirror::Class> klass,
751 bool can_run_clinit,
752 bool can_init_parents)
753 REQUIRES(!dex_lock_)
754 SHARED_REQUIRES(Locks::mutator_lock_);
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700755 bool WaitForInitializeClass(Handle<mirror::Class> klass,
756 Thread* self,
Igor Murashkinb1d8c312015-08-04 11:18:43 -0700757 ObjectLock<mirror::Class>& lock);
Andreas Gampe5a4b8a22014-09-11 08:30:08 -0700758 bool ValidateSuperClassDescriptors(Handle<mirror::Class> klass)
Mathieu Chartier90443472015-07-16 20:32:27 -0700759 SHARED_REQUIRES(Locks::mutator_lock_);
Carl Shapiro0e5d75d2011-07-06 18:28:37 -0700760
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700761 bool IsSameDescriptorInDifferentClassContexts(Thread* self,
762 const char* descriptor,
Andreas Gampe5a4b8a22014-09-11 08:30:08 -0700763 Handle<mirror::ClassLoader> class_loader1,
764 Handle<mirror::ClassLoader> class_loader2)
Mathieu Chartier90443472015-07-16 20:32:27 -0700765 SHARED_REQUIRES(Locks::mutator_lock_);
Carl Shapiro0e5d75d2011-07-06 18:28:37 -0700766
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700767 bool IsSameMethodSignatureInDifferentClassContexts(Thread* self,
768 ArtMethod* method,
769 mirror::Class* klass1,
770 mirror::Class* klass2)
Mathieu Chartier90443472015-07-16 20:32:27 -0700771 SHARED_REQUIRES(Locks::mutator_lock_);
Carl Shapiro0e5d75d2011-07-06 18:28:37 -0700772
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700773 bool LinkClass(Thread* self,
774 const char* descriptor,
775 Handle<mirror::Class> klass,
Andreas Gampe5a4b8a22014-09-11 08:30:08 -0700776 Handle<mirror::ObjectArray<mirror::Class>> interfaces,
Igor Murashkinb1d8c312015-08-04 11:18:43 -0700777 MutableHandle<mirror::Class>* h_new_class_out)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700778 SHARED_REQUIRES(Locks::mutator_lock_)
779 REQUIRES(!Locks::classlinker_classes_lock_);
Carl Shapiro0e5d75d2011-07-06 18:28:37 -0700780
Andreas Gampe5a4b8a22014-09-11 08:30:08 -0700781 bool LinkSuperClass(Handle<mirror::Class> klass)
Mathieu Chartier90443472015-07-16 20:32:27 -0700782 SHARED_REQUIRES(Locks::mutator_lock_);
Carl Shapiro0e5d75d2011-07-06 18:28:37 -0700783
Andreas Gampe5a4b8a22014-09-11 08:30:08 -0700784 bool LoadSuperAndInterfaces(Handle<mirror::Class> klass, const DexFile& dex_file)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700785 SHARED_REQUIRES(Locks::mutator_lock_)
786 REQUIRES(!dex_lock_);
Carl Shapiro0e5d75d2011-07-06 18:28:37 -0700787
Mathieu Chartiercc5ebdf2015-07-27 11:19:43 -0700788 bool LinkMethods(Thread* self,
789 Handle<mirror::Class> klass,
Mathieu Chartier2d2621a2014-10-23 16:48:06 -0700790 Handle<mirror::ObjectArray<mirror::Class>> interfaces,
Igor Murashkinb1d8c312015-08-04 11:18:43 -0700791 ArtMethod** out_imt)
Mathieu Chartier90443472015-07-16 20:32:27 -0700792 SHARED_REQUIRES(Locks::mutator_lock_);
Carl Shapiro0e5d75d2011-07-06 18:28:37 -0700793
Alex Light9139e002015-10-09 15:59:48 -0700794 // Does anything needed to make sure that the compiler will not generate a direct invoke to this
795 // method. Should only be called on non-invokable methods.
796 void EnsureThrowsInvocationError(ArtMethod* method)
797 SHARED_REQUIRES(Locks::mutator_lock_);
798
799 // A wrapper class representing the result of a method translation used for linking methods and
800 // updating superclass default methods. For each method in a classes vtable there are 4 states it
801 // could be in:
802 // 1) No translation is necessary. In this case there is no MethodTranslation object for it. This
803 // is the standard case and is true when the method is not overridable by a default method,
804 // the class defines a concrete implementation of the method, the default method implementation
805 // remains the same, or an abstract method stayed abstract.
806 // 2) The method must be translated to a different default method. We note this with
807 // CreateTranslatedMethod.
808 // 3) The method must be replaced with a conflict method. This happens when a superclass
809 // implements an interface with a default method and this class implements an unrelated
810 // interface that also defines that default method. We note this with CreateConflictingMethod.
811 // 4) The method must be replaced with an abstract miranda method. This happens when a superclass
812 // implements an interface with a default method and this class implements a subinterface of
813 // the superclass's interface which declares the default method abstract. We note this with
814 // CreateAbstractMethod.
815 //
816 // When a method translation is unnecessary (case #1), we don't put it into the
817 // default_translation maps. So an instance of MethodTranslation must be in one of #2-#4.
818 class MethodTranslation {
819 public:
820 // This slot must become a default conflict method.
821 static MethodTranslation CreateConflictingMethod() {
822 return MethodTranslation(Type::kConflict, /*translation*/nullptr);
823 }
824
825 // This slot must become an abstract method.
826 static MethodTranslation CreateAbstractMethod() {
827 return MethodTranslation(Type::kAbstract, /*translation*/nullptr);
828 }
829
830 // Use the given method as the current value for this vtable slot during translation.
831 static MethodTranslation CreateTranslatedMethod(ArtMethod* new_method) {
832 return MethodTranslation(Type::kTranslation, new_method);
833 }
834
835 // Returns true if this is a method that must become a conflict method.
836 bool IsInConflict() const {
837 return type_ == Type::kConflict;
838 }
839
840 // Returns true if this is a method that must become an abstract method.
841 bool IsAbstract() const {
842 return type_ == Type::kAbstract;
843 }
844
845 // Returns true if this is a method that must become a different method.
846 bool IsTranslation() const {
847 return type_ == Type::kTranslation;
848 }
849
850 // Get the translated version of this method.
851 ArtMethod* GetTranslation() const {
852 DCHECK(IsTranslation());
853 DCHECK(translation_ != nullptr);
854 return translation_;
855 }
856
857 private:
858 enum class Type {
859 kTranslation,
860 kConflict,
861 kAbstract,
862 };
863
864 MethodTranslation(Type type, ArtMethod* translation)
865 : translation_(translation), type_(type) {}
866
867 ArtMethod* const translation_;
868 const Type type_;
869 };
870
Alex Lighteb7c1442015-08-31 13:17:42 -0700871 // Links the virtual methods for the given class and records any default methods that will need to
872 // be updated later.
873 //
874 // Arguments:
875 // * self - The current thread.
876 // * klass - class, whose vtable will be filled in.
877 // * default_translations - Vtable index to new method map.
878 // Any vtable entries that need to be updated with new default methods
879 // are stored into the default_translations map. The default_translations
880 // map is keyed on the vtable index that needs to be updated. We use this
881 // map because if we override a default method with another default
882 // method we need to update the vtable to point to the new method.
883 // Unfortunately since we copy the ArtMethod* we cannot just do a simple
884 // scan, we therefore store the vtable index's that might need to be
885 // updated with the method they will turn into.
886 // TODO This whole default_translations thing is very dirty. There should be a better way.
Alex Light9139e002015-10-09 15:59:48 -0700887 bool LinkVirtualMethods(
888 Thread* self,
889 Handle<mirror::Class> klass,
890 /*out*/std::unordered_map<size_t, MethodTranslation>* default_translations)
Mathieu Chartier90443472015-07-16 20:32:27 -0700891 SHARED_REQUIRES(Locks::mutator_lock_);
Carl Shapiro0e5d75d2011-07-06 18:28:37 -0700892
Alex Lighteb7c1442015-08-31 13:17:42 -0700893 // Sets up the interface lookup table (IFTable) in the correct order to allow searching for
894 // default methods.
895 bool SetupInterfaceLookupTable(Thread* self,
896 Handle<mirror::Class> klass,
897 Handle<mirror::ObjectArray<mirror::Class>> interfaces)
898 SHARED_REQUIRES(Locks::mutator_lock_);
899
Alex Light9139e002015-10-09 15:59:48 -0700900
901 enum class DefaultMethodSearchResult {
902 kDefaultFound,
903 kAbstractFound,
904 kDefaultConflict
905 };
906
Alex Lighteb7c1442015-08-31 13:17:42 -0700907 // Find the default method implementation for 'interface_method' in 'klass', if one exists.
908 //
909 // Arguments:
910 // * self - The current thread.
911 // * target_method - The method we are trying to find a default implementation for.
912 // * klass - The class we are searching for a definition of target_method.
913 // * out_default_method - The pointer we will store the found default method to on success.
Alex Lighteb7c1442015-08-31 13:17:42 -0700914 //
915 // Return value:
Alex Light9139e002015-10-09 15:59:48 -0700916 // * kDefaultFound - There were no conflicting method implementations found in the class while
917 // searching for target_method. The default method implementation is stored into
918 // out_default_method.
919 // * kAbstractFound - There were no conflicting method implementations found in the class while
920 // searching for target_method but no default implementation was found either.
921 // out_default_method is set to null and the method should be considered not
922 // implemented.
923 // * kDefaultConflict - Conflicting method implementations were found when searching for
924 // target_method. The value of *out_default_method is null.
925 DefaultMethodSearchResult FindDefaultMethodImplementation(
926 Thread* self,
927 ArtMethod* target_method,
928 Handle<mirror::Class> klass,
929 /*out*/ArtMethod** out_default_method) const
Alex Lighteb7c1442015-08-31 13:17:42 -0700930 SHARED_REQUIRES(Locks::mutator_lock_);
931
932 // Sets the imt entries and fixes up the vtable for the given class by linking all the interface
933 // methods. See LinkVirtualMethods for an explanation of what default_translations is.
Alex Light9139e002015-10-09 15:59:48 -0700934 bool LinkInterfaceMethods(
935 Thread* self,
936 Handle<mirror::Class> klass,
937 const std::unordered_map<size_t, MethodTranslation>& default_translations,
938 ArtMethod** out_imt)
Mathieu Chartier90443472015-07-16 20:32:27 -0700939 SHARED_REQUIRES(Locks::mutator_lock_);
Carl Shapiro0e5d75d2011-07-06 18:28:37 -0700940
Igor Murashkinb1d8c312015-08-04 11:18:43 -0700941 bool LinkStaticFields(Thread* self, Handle<mirror::Class> klass, size_t* class_size)
Mathieu Chartier90443472015-07-16 20:32:27 -0700942 SHARED_REQUIRES(Locks::mutator_lock_);
Andreas Gampe5a4b8a22014-09-11 08:30:08 -0700943 bool LinkInstanceFields(Thread* self, Handle<mirror::Class> klass)
Mathieu Chartier90443472015-07-16 20:32:27 -0700944 SHARED_REQUIRES(Locks::mutator_lock_);
Igor Murashkinb1d8c312015-08-04 11:18:43 -0700945 bool LinkFields(Thread* self, Handle<mirror::Class> klass, bool is_static, size_t* class_size)
Mathieu Chartier90443472015-07-16 20:32:27 -0700946 SHARED_REQUIRES(Locks::mutator_lock_);
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700947 void LinkCode(ArtMethod* method,
948 const OatFile::OatClass* oat_class,
Ian Rogers6a3c1fc2014-10-31 00:33:20 -0700949 uint32_t class_def_method_index)
Mathieu Chartier90443472015-07-16 20:32:27 -0700950 SHARED_REQUIRES(Locks::mutator_lock_);
Andreas Gampe5a4b8a22014-09-11 08:30:08 -0700951 void CreateReferenceInstanceOffsets(Handle<mirror::Class> klass)
Mathieu Chartier90443472015-07-16 20:32:27 -0700952 SHARED_REQUIRES(Locks::mutator_lock_);
Carl Shapiro0e5d75d2011-07-06 18:28:37 -0700953
Mathieu Chartiere401d142015-04-22 13:56:20 -0700954 void CheckProxyConstructor(ArtMethod* constructor) const
Mathieu Chartier90443472015-07-16 20:32:27 -0700955 SHARED_REQUIRES(Locks::mutator_lock_);
Mathieu Chartiere401d142015-04-22 13:56:20 -0700956 void CheckProxyMethod(ArtMethod* method, ArtMethod* prototype) const
Mathieu Chartier90443472015-07-16 20:32:27 -0700957 SHARED_REQUIRES(Locks::mutator_lock_);
Mathieu Chartiere401d142015-04-22 13:56:20 -0700958
Brian Carlstrom58ae9412011-10-04 00:56:06 -0700959 // For use by ImageWriter to find DexCaches for its roots
Hiroshi Yamauchie9e3e692014-06-24 14:31:37 -0700960 ReaderWriterMutex* DexLock()
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700961 SHARED_REQUIRES(Locks::mutator_lock_)
962 LOCK_RETURNED(dex_lock_) {
Hiroshi Yamauchie9e3e692014-06-24 14:31:37 -0700963 return &dex_lock_;
Brian Carlstrom58ae9412011-10-04 00:56:06 -0700964 }
Mathieu Chartier90443472015-07-16 20:32:27 -0700965 size_t GetDexCacheCount() SHARED_REQUIRES(Locks::mutator_lock_, dex_lock_) {
Hiroshi Yamauchie9e3e692014-06-24 14:31:37 -0700966 return dex_caches_.size();
967 }
Hiroshi Yamauchi04302db2015-11-11 23:45:34 -0800968 const std::list<DexCacheData>& GetDexCachesData()
969 SHARED_REQUIRES(Locks::mutator_lock_, dex_lock_) {
Mathieu Chartier673ed3d2015-08-28 14:56:43 -0700970 return dex_caches_;
971 }
Brian Carlstrom58ae9412011-10-04 00:56:06 -0700972
Mathieu Chartiere401d142015-04-22 13:56:20 -0700973 void CreateProxyConstructor(Handle<mirror::Class> klass, ArtMethod* out)
Mathieu Chartier90443472015-07-16 20:32:27 -0700974 SHARED_REQUIRES(Locks::mutator_lock_);
Mathieu Chartiere401d142015-04-22 13:56:20 -0700975 void CreateProxyMethod(Handle<mirror::Class> klass, ArtMethod* prototype, ArtMethod* out)
Mathieu Chartier90443472015-07-16 20:32:27 -0700976 SHARED_REQUIRES(Locks::mutator_lock_);
Jesse Wilson95caa792011-10-12 18:14:17 -0400977
Igor Murashkindf707e42016-02-02 16:56:50 -0800978 // Ensures that methods have the kAccSkipAccessChecks bit set. We use the
979 // kAccVerificationAttempted bit on the class access flags to determine whether this has been done
980 // before.
981 void EnsureSkipAccessChecksMethods(Handle<mirror::Class> c)
Mathieu Chartier90443472015-07-16 20:32:27 -0700982 SHARED_REQUIRES(Locks::mutator_lock_);
Andreas Gampe48498592014-09-10 19:48:05 -0700983
Mathieu Chartier073b16c2015-11-10 14:13:23 -0800984 mirror::Class* LookupClassFromBootImage(const char* descriptor)
Mathieu Chartier90443472015-07-16 20:32:27 -0700985 SHARED_REQUIRES(Locks::mutator_lock_);
Ian Rogersdbf3be02014-08-29 15:40:08 -0700986
Mathieu Chartier5b830502016-03-02 10:30:23 -0800987 // Register a class loader and create its class table and allocator. Should not be called if
988 // these are already created.
989 void RegisterClassLoader(mirror::ClassLoader* class_loader)
990 SHARED_REQUIRES(Locks::mutator_lock_)
991 REQUIRES(Locks::classlinker_classes_lock_);
992
Mathieu Chartiercc5ebdf2015-07-27 11:19:43 -0700993 // Returns null if not found.
994 ClassTable* ClassTableForClassLoader(mirror::ClassLoader* class_loader)
995 SHARED_REQUIRES(Locks::mutator_lock_, Locks::classlinker_classes_lock_);
Mathieu Chartier5b830502016-03-02 10:30:23 -0800996
Nicolas Geoffray3a090922015-11-24 09:17:30 +0000997 // Insert a new class table if not found.
Mathieu Chartiercc5ebdf2015-07-27 11:19:43 -0700998 ClassTable* InsertClassTableForClassLoader(mirror::ClassLoader* class_loader)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -0700999 SHARED_REQUIRES(Locks::mutator_lock_)
1000 REQUIRES(Locks::classlinker_classes_lock_);
Mathieu Chartiercc5ebdf2015-07-27 11:19:43 -07001001
Ian Rogersdbf3be02014-08-29 15:40:08 -07001002 // EnsureResolved is called to make sure that a class in the class_table_ has been resolved
1003 // before returning it to the caller. Its the responsibility of the thread that placed the class
1004 // in the table to make it resolved. The thread doing resolution must notify on the class' lock
1005 // when resolution has occurred. This happens in mirror::Class::SetStatus. As resolution may
1006 // retire a class, the version of the class in the table is returned and this may differ from
1007 // the class passed in.
1008 mirror::Class* EnsureResolved(Thread* self, const char* descriptor, mirror::Class* klass)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -07001009 WARN_UNUSED
1010 SHARED_REQUIRES(Locks::mutator_lock_)
1011 REQUIRES(!dex_lock_);
Ian Rogersdbf3be02014-08-29 15:40:08 -07001012
1013 void FixupTemporaryDeclaringClass(mirror::Class* temp_class, mirror::Class* new_class)
Mathieu Chartier90443472015-07-16 20:32:27 -07001014 SHARED_REQUIRES(Locks::mutator_lock_);
Ian Rogersdbf3be02014-08-29 15:40:08 -07001015
Ian Rogers6f3dbba2014-10-14 17:41:57 -07001016 void SetClassRoot(ClassRoot class_root, mirror::Class* klass)
Mathieu Chartier90443472015-07-16 20:32:27 -07001017 SHARED_REQUIRES(Locks::mutator_lock_);
Ian Rogers6f3dbba2014-10-14 17:41:57 -07001018
1019 // Return the quick generic JNI stub for testing.
1020 const void* GetRuntimeQuickGenericJniStub() const;
1021
Andreas Gampebfdcdc12015-04-22 18:10:36 -07001022 // Throw the class initialization failure recorded when first trying to initialize the given
1023 // class.
Andreas Gampecb086952015-11-02 16:20:00 -08001024 void ThrowEarlierClassFailure(mirror::Class* c, bool wrap_in_no_class_def = false)
Mathieu Chartierc77f3ab2015-09-03 19:41:50 -07001025 SHARED_REQUIRES(Locks::mutator_lock_)
Mathieu Chartier90443472015-07-16 20:32:27 -07001026 REQUIRES(!dex_lock_);
Andreas Gampebfdcdc12015-04-22 18:10:36 -07001027
Mathieu Chartiere401d142015-04-22 13:56:20 -07001028 bool CanWeInitializeClass(mirror::Class* klass, bool can_init_statics, bool can_init_parents)
Mathieu Chartier90443472015-07-16 20:32:27 -07001029 SHARED_REQUIRES(Locks::mutator_lock_);
Mathieu Chartiere401d142015-04-22 13:56:20 -07001030
Alex Lighte64300b2015-12-15 15:02:47 -08001031 void UpdateClassMethods(mirror::Class* klass,
1032 LengthPrefixedArray<ArtMethod>* new_methods)
Mathieu Chartier54d220e2015-07-30 16:20:06 -07001033 SHARED_REQUIRES(Locks::mutator_lock_)
1034 REQUIRES(!Locks::classlinker_classes_lock_);
Mathieu Chartiere401d142015-04-22 13:56:20 -07001035
Mathieu Chartier69731002016-03-02 16:08:31 -08001036 // new_class_set is the set of classes that were read from the class table section in the image.
1037 // If there was no class table section, it is null.
Mathieu Chartier1aa8ec22016-02-01 10:34:47 -08001038 bool UpdateAppImageClassLoadersAndDexCaches(
Mathieu Chartierfbc31082016-01-24 11:59:56 -08001039 gc::space::ImageSpace* space,
1040 Handle<mirror::ClassLoader> class_loader,
1041 Handle<mirror::ObjectArray<mirror::DexCache>> dex_caches,
Mathieu Chartier69731002016-03-02 16:08:31 -08001042 ClassTable::ClassSet* new_class_set,
Mathieu Chartier1aa8ec22016-02-01 10:34:47 -08001043 bool* out_forward_dex_cache_array,
1044 std::string* out_error_msg)
Mathieu Chartierfbc31082016-01-24 11:59:56 -08001045 REQUIRES(!dex_lock_)
1046 SHARED_REQUIRES(Locks::mutator_lock_);
1047
Andreas Gampe7ba5a672016-02-04 21:45:01 -08001048 // Check that c1 == FindSystemClass(self, descriptor). Abort with class dumps otherwise.
1049 void CheckSystemClass(Thread* self, Handle<mirror::Class> c1, const char* descriptor)
1050 REQUIRES(!dex_lock_)
1051 SHARED_REQUIRES(Locks::mutator_lock_);
1052
Brian Carlstrom4a96b602011-07-26 16:40:23 -07001053 std::vector<const DexFile*> boot_class_path_;
Mathieu Chartierfbc31082016-01-24 11:59:56 -08001054 std::vector<std::unique_ptr<const DexFile>> boot_dex_files_;
Brian Carlstrom578bbdc2011-07-21 14:07:47 -07001055
Ian Rogers1bf8d4d2013-05-30 00:18:49 -07001056 mutable ReaderWriterMutex dex_lock_ DEFAULT_MUTEX_ACQUIRED_AFTER;
Hiroshi Yamauchi04302db2015-11-11 23:45:34 -08001057 // JNI weak globals and side data to allow dex caches to get unloaded. We lazily delete weak
1058 // globals when we register new dex files.
1059 std::list<DexCacheData> dex_caches_ GUARDED_BY(dex_lock_);
Brian Carlstrom47d237a2011-10-18 15:08:33 -07001060
Mathieu Chartier9b1c71e2015-09-02 18:51:54 -07001061 // This contains the class loaders which have class tables. It is populated by
Mathieu Chartier951ec2c2015-09-22 08:50:05 -07001062 // InsertClassTableForClassLoader.
1063 std::list<ClassLoaderData> class_loaders_
Mathieu Chartier6b069532015-08-05 15:08:12 -07001064 GUARDED_BY(Locks::classlinker_classes_lock_);
1065
1066 // Boot class path table. Since the class loader for this is null.
1067 ClassTable boot_class_table_ GUARDED_BY(Locks::classlinker_classes_lock_);
Carl Shapiro0e5d75d2011-07-06 18:28:37 -07001068
Mathieu Chartiercc5ebdf2015-07-27 11:19:43 -07001069 // New class roots, only used by CMS since the GC needs to mark these in the pause.
1070 std::vector<GcRoot<mirror::Class>> new_class_roots_ GUARDED_BY(Locks::classlinker_classes_lock_);
Elliott Hughesf8349362012-06-18 15:00:06 -07001071
Mathieu Chartier073b16c2015-11-10 14:13:23 -08001072 // Do we need to search dex caches to find boot image classes?
1073 bool dex_cache_boot_image_class_lookup_required_;
Ian Rogers7dfb28c2013-08-22 08:18:36 -07001074 // Number of times we've searched dex caches for a class. After a certain number of misses we move
1075 // the classes into the class_table_ to avoid dex cache based searches.
Ian Rogers68b56852014-08-29 20:19:11 -07001076 Atomic<uint32_t> failed_dex_cache_class_lookups_;
Ian Rogers7dfb28c2013-08-22 08:18:36 -07001077
Ian Rogers6f3dbba2014-10-14 17:41:57 -07001078 // Well known mirror::Class roots.
Hiroshi Yamauchi94f7b492014-07-22 18:08:23 -07001079 GcRoot<mirror::ObjectArray<mirror::Class>> class_roots_;
Brian Carlstrom913af1b2011-07-23 21:41:13 -07001080
Ian Rogers98379392014-02-24 16:53:16 -08001081 // The interface table used by all arrays.
Hiroshi Yamauchi94f7b492014-07-22 18:08:23 -07001082 GcRoot<mirror::IfTable> array_iftable_;
Carl Shapiro565f5072011-07-10 13:39:43 -07001083
Ian Rogers98379392014-02-24 16:53:16 -08001084 // A cache of the last FindArrayClass results. The cache serves to avoid creating array class
1085 // descriptors for the sake of performing FindClass.
1086 static constexpr size_t kFindArrayCacheSize = 16;
Hiroshi Yamauchi94f7b492014-07-22 18:08:23 -07001087 GcRoot<mirror::Class> find_array_class_cache_[kFindArrayCacheSize];
Ian Rogers98379392014-02-24 16:53:16 -08001088 size_t find_array_class_cache_next_victim_;
1089
Brian Carlstrom75cb3b42011-07-28 02:13:36 -07001090 bool init_done_;
Mathieu Chartier893263b2014-03-04 11:07:42 -08001091 bool log_new_class_table_roots_ GUARDED_BY(Locks::classlinker_classes_lock_);
Brian Carlstrom75cb3b42011-07-28 02:13:36 -07001092
Elliott Hughescf4c6c42011-09-01 15:16:42 -07001093 InternTable* intern_table_;
1094
Mingyao Yang98d1cc82014-05-15 17:02:16 -07001095 // Trampolines within the image the bounce to runtime entrypoints. Done so that there is a single
1096 // patch point within the image. TODO: make these proper relocations.
Jeff Hao0aba0ba2013-06-03 14:49:28 -07001097 const void* quick_resolution_trampoline_;
Jeff Hao88474b42013-10-23 16:24:40 -07001098 const void* quick_imt_conflict_trampoline_;
Andreas Gampe2da88232014-02-27 12:26:20 -08001099 const void* quick_generic_jni_trampoline_;
Vladimir Marko8a630572014-04-09 18:45:35 +01001100 const void* quick_to_interpreter_bridge_trampoline_;
Jeff Hao0aba0ba2013-06-03 14:49:28 -07001101
Mathieu Chartier2d721012014-11-10 11:08:06 -08001102 // Image pointer size.
1103 size_t image_pointer_size_;
1104
Mathieu Chartierf9c6fc62015-10-07 11:44:05 -07001105 friend class ImageDumper; // for DexLock
Brian Carlstrom34f426c2011-10-04 12:58:02 -07001106 friend class ImageWriter; // for GetClassRoots
Ian Rogers6f3dbba2014-10-14 17:41:57 -07001107 friend class JniCompilerTest; // for GetRuntimeQuickGenericJniStub
Andreas Gampe5f4a09a2015-09-28 13:16:33 -07001108 friend class JniInternalTest; // for GetRuntimeQuickGenericJniStub
Mathieu Chartier76172162016-01-26 14:54:06 -08001109 ART_FRIEND_TEST(ClassLinkerTest, RegisterDexFileName); // for DexLock, and RegisterDexFileLocked
Ian Rogers6f3dbba2014-10-14 17:41:57 -07001110 ART_FRIEND_TEST(mirror::DexCacheTest, Open); // for AllocDexCache
Carl Shapiro0e5d75d2011-07-06 18:28:37 -07001111 DISALLOW_COPY_AND_ASSIGN(ClassLinker);
1112};
1113
1114} // namespace art
1115
Brian Carlstromfc0e3212013-07-17 14:40:12 -07001116#endif // ART_RUNTIME_CLASS_LINKER_H_