blob: 01c10518643ca984dd577fbebf5ee7ce1727602c [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
17#ifndef ART_SRC_CLASS_LINKER_H_
18#define ART_SRC_CLASS_LINKER_H_
19
Ian Rogers6d4d9fc2011-11-30 16:24:48 -080020#include <string>
Carl Shapiro0e5d75d2011-07-06 18:28:37 -070021#include <utility>
22#include <vector>
23
Ian Rogerscaab8c42011-10-12 12:11:18 -070024#include "dex_cache.h"
Brian Carlstrom7e49dca2011-07-22 18:07:34 -070025#include "dex_file.h"
Elliott Hughese5448b52012-01-18 16:44:06 -080026#include "gtest/gtest.h"
Brian Carlstrom7e93b502011-08-04 14:16:22 -070027#include "heap.h"
Brian Carlstrom7e93b502011-08-04 14:16:22 -070028#include "macros.h"
Elliott Hughes8daa0922011-09-11 13:46:25 -070029#include "mutex.h"
Brian Carlstrom58ae9412011-10-04 00:56:06 -070030#include "oat_file.h"
Brian Carlstrom578bbdc2011-07-21 14:07:47 -070031#include "object.h"
Elliott Hughesa0e18062012-04-13 15:59:59 -070032#include "safe_map.h"
Brian Carlstrom40381fb2011-10-19 14:13:40 -070033#include "stack_indirect_reference_table.h"
Carl Shapiro0e5d75d2011-07-06 18:28:37 -070034
35namespace art {
36
Elliott Hughescf4c6c42011-09-01 15:16:42 -070037class ClassLoader;
Ian Rogers30fab402012-01-23 15:43:46 -080038class ImageSpace;
Elliott Hughescf4c6c42011-09-01 15:16:42 -070039class InternTable;
Brian Carlstromd1422f82011-09-28 11:37:09 -070040class ObjectLock;
Elliott Hughescf4c6c42011-09-01 15:16:42 -070041
Elliott Hughesa2155262011-11-16 16:26:58 -080042typedef bool (ClassVisitor)(Class* c, void* arg);
43
Carl Shapiro0e5d75d2011-07-06 18:28:37 -070044class ClassLinker {
45 public:
Brian Carlstrom58ae9412011-10-04 00:56:06 -070046 // Creates the class linker by boot strapping from dex files.
Brian Carlstroma004aa92012-02-08 18:05:09 -080047 static ClassLinker* CreateFromCompiler(const std::vector<const DexFile*>& boot_class_path,
48 InternTable* intern_table);
Brian Carlstrom58ae9412011-10-04 00:56:06 -070049
Brian Carlstroma004aa92012-02-08 18:05:09 -080050 // Creates the class linker from an image.
51 static ClassLinker* CreateFromImage(InternTable* intern_table);
Carl Shapiro61e019d2011-07-14 16:53:09 -070052
Brian Carlstrom9ea1cb12011-08-24 23:18:18 -070053 ~ClassLinker();
Carl Shapiro565f5072011-07-10 13:39:43 -070054
Elliott Hughes64bf5a32011-09-20 14:43:12 -070055 // Finds a class by its descriptor, loading it if necessary.
Brian Carlstrom74eb46a2011-08-02 20:10:14 -070056 // If class_loader is null, searches boot_class_path_.
Elliott Hughesc3b77c72011-12-15 20:56:48 -080057 Class* FindClass(const char* descriptor, const ClassLoader* class_loader);
Brian Carlstromaded5f72011-10-07 17:15:04 -070058
Elliott Hughesdb7d5e92011-12-16 18:47:37 -080059 Class* FindSystemClass(const char* descriptor);
Brian Carlstromaded5f72011-10-07 17:15:04 -070060
61 // Define a new a class based on a ClassDef from a DexFile
Elliott Hughesc3b77c72011-12-15 20:56:48 -080062 Class* DefineClass(const StringPiece& descriptor, const ClassLoader* class_loader,
Brian Carlstromaded5f72011-10-07 17:15:04 -070063 const DexFile& dex_file, const DexFile::ClassDef& dex_class_def);
Elliott Hughes64bf5a32011-09-20 14:43:12 -070064
65 // Finds a class by its descriptor, returning NULL if it isn't wasn't loaded
66 // by the given 'class_loader'.
Elliott Hughesc3b77c72011-12-15 20:56:48 -080067 Class* LookupClass(const char* descriptor, const ClassLoader* class_loader);
Carl Shapiro0e5d75d2011-07-06 18:28:37 -070068
Elliott Hughes6fa602d2011-12-02 17:54:25 -080069 // Finds all the classes with the given descriptor, regardless of ClassLoader.
Elliott Hughesc3b77c72011-12-15 20:56:48 -080070 void LookupClasses(const char* descriptor, std::vector<Class*>& classes);
Elliott Hughes6fa602d2011-12-02 17:54:25 -080071
Elliott Hughesd8ddfd52011-08-15 14:32:53 -070072 Class* FindPrimitiveClass(char type);
73
Brian Carlstromae826982011-11-09 01:33:42 -080074 // General class unloading is not supported, this is used to prune
75 // unwanted classes during image writing.
Elliott Hughesc3b77c72011-12-15 20:56:48 -080076 bool RemoveClass(const char* descriptor, const ClassLoader* class_loader);
Brian Carlstromae826982011-11-09 01:33:42 -080077
Elliott Hughes9d5ccec2011-09-19 13:19:50 -070078 void DumpAllClasses(int flags) const;
79
Elliott Hughescac6cc72011-11-03 20:31:21 -070080 void DumpForSigQuit(std::ostream& os) const;
81
Elliott Hughese27955c2011-08-26 15:21:24 -070082 size_t NumLoadedClasses() const;
83
Brian Carlstromb63ec392011-08-27 17:38:27 -070084 // Resolve a String with the given index from the DexFile, storing the
Brian Carlstromaded5f72011-10-07 17:15:04 -070085 // result in the DexCache. The referrer is used to identify the
86 // target DexCache and ClassLoader to use for resolution.
87 String* ResolveString(uint32_t string_idx, const Method* referrer) {
Ian Rogerscaab8c42011-10-12 12:11:18 -070088 String* resolved_string = referrer->GetDexCacheStrings()->Get(string_idx);
89 if (UNLIKELY(resolved_string == NULL)) {
90 Class* declaring_class = referrer->GetDeclaringClass();
91 DexCache* dex_cache = declaring_class->GetDexCache();
92 const DexFile& dex_file = FindDexFile(dex_cache);
93 resolved_string = ResolveString(dex_file, string_idx, dex_cache);
94 }
95 return resolved_string;
Brian Carlstromaded5f72011-10-07 17:15:04 -070096 }
97
98 // Resolve a String with the given index from the DexFile, storing the
Brian Carlstrom9ea1cb12011-08-24 23:18:18 -070099 // result in the DexCache.
Ian Rogers0cfe1fb2011-08-26 03:29:44 -0700100 String* ResolveString(const DexFile& dex_file, uint32_t string_idx, DexCache* dex_cache);
Brian Carlstrom9ea1cb12011-08-24 23:18:18 -0700101
Brian Carlstromb63ec392011-08-27 17:38:27 -0700102 // Resolve a Type with the given index from the DexFile, storing the
Brian Carlstrom9ea1cb12011-08-24 23:18:18 -0700103 // result in the DexCache. The referrer is used to identity the
104 // target DexCache and ClassLoader to use for resolution.
105 Class* ResolveType(const DexFile& dex_file,
Ian Rogers6d4d9fc2011-11-30 16:24:48 -0800106 uint16_t type_idx,
Brian Carlstrom9ea1cb12011-08-24 23:18:18 -0700107 const Class* referrer) {
108 return ResolveType(dex_file,
109 type_idx,
110 referrer->GetDexCache(),
111 referrer->GetClassLoader());
112 }
113
Brian Carlstromb63ec392011-08-27 17:38:27 -0700114 // Resolve a Type with the given index from the DexFile, storing the
Ian Rogers0cfe1fb2011-08-26 03:29:44 -0700115 // result in the DexCache. The referrer is used to identify the
Brian Carlstromb63ec392011-08-27 17:38:27 -0700116 // target DexCache and ClassLoader to use for resolution.
Ian Rogers6d4d9fc2011-11-30 16:24:48 -0800117 Class* ResolveType(uint16_t type_idx, const Method* referrer) {
Ian Rogerscaab8c42011-10-12 12:11:18 -0700118 Class* resolved_type = referrer->GetDexCacheResolvedTypes()->Get(type_idx);
119 if (UNLIKELY(resolved_type == NULL)) {
120 Class* declaring_class = referrer->GetDeclaringClass();
121 DexCache* dex_cache = declaring_class->GetDexCache();
122 const ClassLoader* class_loader = declaring_class->GetClassLoader();
123 const DexFile& dex_file = FindDexFile(dex_cache);
124 resolved_type = ResolveType(dex_file, type_idx, dex_cache, class_loader);
125 }
126 return resolved_type;
Ian Rogers0cfe1fb2011-08-26 03:29:44 -0700127 }
128
Ian Rogers6d4d9fc2011-11-30 16:24:48 -0800129 Class* ResolveType(uint16_t type_idx, const Field* referrer) {
Ian Rogers0cfe1fb2011-08-26 03:29:44 -0700130 Class* declaring_class = referrer->GetDeclaringClass();
131 DexCache* dex_cache = declaring_class->GetDexCache();
Ian Rogerscaab8c42011-10-12 12:11:18 -0700132 Class* resolved_type = dex_cache->GetResolvedType(type_idx);
133 if (UNLIKELY(resolved_type == NULL)) {
134 const ClassLoader* class_loader = declaring_class->GetClassLoader();
135 const DexFile& dex_file = FindDexFile(dex_cache);
136 resolved_type = ResolveType(dex_file, type_idx, dex_cache, class_loader);
137 }
138 return resolved_type;
Brian Carlstromb63ec392011-08-27 17:38:27 -0700139 }
140
Brian Carlstrom9ea1cb12011-08-24 23:18:18 -0700141 // Resolve a type with the given ID from the DexFile, storing the
142 // result in DexCache. The ClassLoader is used to search for the
143 // type, since it may be referenced from but not contained within
144 // the given DexFile.
145 Class* ResolveType(const DexFile& dex_file,
Ian Rogers6d4d9fc2011-11-30 16:24:48 -0800146 uint16_t type_idx,
Brian Carlstrom9ea1cb12011-08-24 23:18:18 -0700147 DexCache* dex_cache,
148 const ClassLoader* class_loader);
149
150 // Resolve a method with a given ID from the DexFile, storing the
151 // result in DexCache. The ClassLinker and ClassLoader are used as
152 // in ResolveType. What is unique is the method type argument which
153 // is used to determine if this method is a direct, static, or
154 // virtual method.
155 Method* ResolveMethod(const DexFile& dex_file,
156 uint32_t method_idx,
157 DexCache* dex_cache,
158 const ClassLoader* class_loader,
Brian Carlstrom20cfffa2011-08-26 02:31:27 -0700159 bool is_direct);
Brian Carlstrom9ea1cb12011-08-24 23:18:18 -0700160
Brian Carlstrom16192862011-09-12 17:50:06 -0700161 Method* ResolveMethod(uint32_t method_idx, const Method* referrer, bool is_direct) {
Ian Rogers19846512012-02-24 11:42:47 -0800162 Method* resolved_method = referrer->GetDexCacheResolvedMethods()->Get(method_idx);
163 if (UNLIKELY(resolved_method == NULL || resolved_method->IsRuntimeMethod())) {
164 Class* declaring_class = referrer->GetDeclaringClass();
165 DexCache* dex_cache = declaring_class->GetDexCache();
Ian Rogerscaab8c42011-10-12 12:11:18 -0700166 const ClassLoader* class_loader = declaring_class->GetClassLoader();
167 const DexFile& dex_file = FindDexFile(dex_cache);
168 resolved_method = ResolveMethod(dex_file, method_idx, dex_cache, class_loader, is_direct);
169 }
170 return resolved_method;
Brian Carlstrom16192862011-09-12 17:50:06 -0700171 }
172
Brian Carlstrom845490b2011-09-19 15:56:53 -0700173 Field* ResolveField(uint32_t field_idx, const Method* referrer, bool is_static) {
Ian Rogersb5d6a492012-02-14 04:00:51 -0800174 Field* resolved_field =
175 referrer->GetDeclaringClass()->GetDexCache()->GetResolvedField(field_idx);
Ian Rogerscaab8c42011-10-12 12:11:18 -0700176 if (UNLIKELY(resolved_field == NULL)) {
Ian Rogersb5d6a492012-02-14 04:00:51 -0800177 Class* declaring_class = referrer->GetDeclaringClass();
178 DexCache* dex_cache = declaring_class->GetDexCache();
Ian Rogerscaab8c42011-10-12 12:11:18 -0700179 const ClassLoader* class_loader = declaring_class->GetClassLoader();
180 const DexFile& dex_file = FindDexFile(dex_cache);
181 resolved_field = ResolveField(dex_file, field_idx, dex_cache, class_loader, is_static);
182 }
183 return resolved_field;
Brian Carlstromb9edb842011-08-28 16:31:06 -0700184 }
185
Brian Carlstrom16192862011-09-12 17:50:06 -0700186 // Resolve a field with a given ID from the DexFile, storing the
Brian Carlstrom9ea1cb12011-08-24 23:18:18 -0700187 // result in DexCache. The ClassLinker and ClassLoader are used as
188 // in ResolveType. What is unique is the is_static argument which is
189 // used to determine if we are resolving a static or non-static
190 // field.
191 Field* ResolveField(const DexFile& dex_file,
192 uint32_t field_idx,
193 DexCache* dex_cache,
194 const ClassLoader* class_loader,
195 bool is_static);
196
Ian Rogersb067ac22011-12-13 18:05:09 -0800197 // Resolve a field with a given ID from the DexFile, storing the
198 // result in DexCache. The ClassLinker and ClassLoader are used as
199 // in ResolveType. No is_static argument is provided so that Java
200 // field resolution semantics are followed.
201 Field* ResolveFieldJLS(const DexFile& dex_file,
202 uint32_t field_idx,
203 DexCache* dex_cache,
204 const ClassLoader* class_loader);
205
Ian Rogersad25ac52011-10-04 19:13:33 -0700206 // Get shorty from method index without resolution. Used to do handlerization.
Ian Rogers19846512012-02-24 11:42:47 -0800207 const char* MethodShorty(uint32_t method_idx, Method* referrer, uint32_t* length);
Ian Rogersad25ac52011-10-04 19:13:33 -0700208
Elliott Hughesf4c21c92011-08-19 17:31:31 -0700209 // Returns true on success, false if there's an exception pending.
Brian Carlstrom25c33252011-09-18 15:58:35 -0700210 // can_run_clinit=false allows the compiler to attempt to init a class,
211 // given the restriction that no <clinit> execution is possible.
Ian Rogers0045a292012-03-31 21:08:41 -0700212 bool EnsureInitialized(Class* c, bool can_run_clinit, bool can_init_fields);
Carl Shapiro0e5d75d2011-07-06 18:28:37 -0700213
Elliott Hughes2a20cfd2011-09-23 19:30:41 -0700214 // Initializes classes that have instances in the image but that have
215 // <clinit> methods so they could not be initialized by the compiler.
216 void RunRootClinits();
217
Brian Carlstrom9ea1cb12011-08-24 23:18:18 -0700218 void RegisterDexFile(const DexFile& dex_file);
Brian Carlstrom40381fb2011-10-19 14:13:40 -0700219 void RegisterDexFile(const DexFile& dex_file, SirtRef<DexCache>& dex_cache);
Carl Shapiro0e5d75d2011-07-06 18:28:37 -0700220
Brian Carlstrom866c8622012-01-06 16:35:13 -0800221 void RegisterOatFile(const OatFile& oat_file);
222
Brian Carlstrom8a487412011-08-29 20:08:52 -0700223 const std::vector<const DexFile*>& GetBootClassPath() {
224 return boot_class_path_;
225 }
226
Elliott Hughesa2155262011-11-16 16:26:58 -0800227 void VisitClasses(ClassVisitor* visitor, void* arg) const;
228
Elliott Hughes410c0c82011-09-01 17:58:25 -0700229 void VisitRoots(Heap::RootVisitor* visitor, void* arg) const;
Brian Carlstrom75cb3b42011-07-28 02:13:36 -0700230
buzbeec143c552011-08-20 17:38:58 -0700231 const DexFile& FindDexFile(const DexCache* dex_cache) const;
Brian Carlstrom9ea1cb12011-08-24 23:18:18 -0700232 DexCache* FindDexCache(const DexFile& dex_file) const;
Brian Carlstromaded5f72011-10-07 17:15:04 -0700233 bool IsDexFileRegistered(const DexFile& dex_file) const;
Ian Rogers19846512012-02-24 11:42:47 -0800234 void FixupDexCaches(Method* resolution_method) const;
Brian Carlstrom1d9f52b2011-10-13 10:50:45 -0700235
jeffhao262bf462011-10-20 18:36:32 -0700236 // Generate an oat file from a dex file
Brian Carlstromd601af82012-01-06 10:15:19 -0800237 bool GenerateOatFile(const std::string& dex_filename,
238 int oat_fd,
239 const std::string& oat_cache_filename);
jeffhao262bf462011-10-20 18:36:32 -0700240
Brian Carlstromae826982011-11-09 01:33:42 -0800241 const OatFile* FindOatFileFromOatLocation(const std::string& location);
buzbeec143c552011-08-20 17:38:58 -0700242
Brian Carlstrom5b332c82012-02-01 15:02:31 -0800243 // Finds the oat file for a dex location, generating the oat file if
244 // it is missing or out of date. Returns the DexFile from within the
245 // created oat file.
246 const DexFile* FindOrCreateOatFileForDexLocation(const std::string& dex_location,
247 const std::string& oat_location);
248 // Find a DexFile within an OatFile given a DexFile location. Note
249 // that this returns null if the location checksum of the DexFile
250 // does not match the OatFile.
251 const DexFile* FindDexFileInOatFileFromDexLocation(const std::string& location);
252
jeffhaof6174e82012-01-31 16:14:17 -0800253
Elliott Hughes418d20f2011-09-22 14:00:39 -0700254 // TODO: replace this with multiple methods that allocate the correct managed type.
Shih-wei Liao44175362011-08-28 16:59:17 -0700255 template <class T>
256 ObjectArray<T>* AllocObjectArray(size_t length) {
257 return ObjectArray<T>::Alloc(GetClassRoot(kObjectArrayClass), length);
258 }
259
Elliott Hughes418d20f2011-09-22 14:00:39 -0700260 ObjectArray<Class>* AllocClassArray(size_t length) {
261 return ObjectArray<Class>::Alloc(GetClassRoot(kClassArrayClass), length);
262 }
263
Shih-wei Liao55df06b2011-08-26 14:39:27 -0700264 ObjectArray<StackTraceElement>* AllocStackTraceElementArray(size_t length);
265
jeffhao98eacac2011-09-14 16:11:53 -0700266 void VerifyClass(Class* klass);
Elliott Hughes634eb2e2012-03-22 16:06:28 -0700267 bool VerifyClassUsingOatFile(const DexFile& dex_file, Class* klass,
268 Class::Status& oat_file_class_status);
Brian Carlstrome7d856b2012-01-11 18:10:55 -0800269 void ResolveClassExceptionHandlerTypes(const DexFile& dex_file, Class* klass);
270 void ResolveMethodExceptionHandlerTypes(const DexFile& dex_file, Method* klass);
jeffhao98eacac2011-09-14 16:11:53 -0700271
Jesse Wilson95caa792011-10-12 18:14:17 -0400272 Class* CreateProxyClass(String* name, ObjectArray<Class>* interfaces, ClassLoader* loader,
Ian Rogers6d4d9fc2011-11-30 16:24:48 -0800273 ObjectArray<Method>* methods, ObjectArray<ObjectArray<Class> >* throws);
274 std::string GetDescriptorForProxy(const Class* proxy_class);
Ian Rogers16f93672012-02-14 12:29:06 -0800275 Method* FindMethodForProxy(const Class* proxy_class, const Method* proxy_method);
Jesse Wilson95caa792011-10-12 18:14:17 -0400276
Ian Rogers19846512012-02-24 11:42:47 -0800277 // Get the oat code for a method when its class isn't yet initialized
278 const void* GetOatCodeFor(const Method* method);
279
TDYa12785321912012-04-01 15:24:56 -0700280 void LinkOatCodeFor(Method* method);
281
Logan Chien0c717dd2012-03-28 18:31:07 +0800282 // Relocate the OatFiles (ELF images)
283 void RelocateExecutable();
284
Brian Carlstrom47d237a2011-10-18 15:08:33 -0700285 pid_t GetClassesLockOwner(); // For SignalCatcher.
286 pid_t GetDexLockOwner(); // For SignalCatcher.
Brian Carlstrom24a3c2e2011-10-17 18:07:52 -0700287
Carl Shapiro0e5d75d2011-07-06 18:28:37 -0700288 private:
Elliott Hughes4dd9b4d2011-12-12 18:29:24 -0800289 explicit ClassLinker(InternTable*);
Carl Shapiro61e019d2011-07-14 16:53:09 -0700290
TDYa12785321912012-04-01 15:24:56 -0700291 const OatFile::OatMethod GetOatMethodFor(const Method* method);
292
Brian Carlstrom58ae9412011-10-04 00:56:06 -0700293 // Initialize class linker by bootstraping from dex files
Brian Carlstroma004aa92012-02-08 18:05:09 -0800294 void InitFromCompiler(const std::vector<const DexFile*>& boot_class_path);
Carl Shapiro61e019d2011-07-14 16:53:09 -0700295
Brian Carlstrom58ae9412011-10-04 00:56:06 -0700296 // Initialize class linker from one or more images.
297 void InitFromImage();
Ian Rogers30fab402012-01-23 15:43:46 -0800298 OatFile* OpenOat(const ImageSpace* space);
Brian Carlstrom78128a62011-09-15 17:21:19 -0700299 static void InitFromImageCallback(Object* obj, void* arg);
Brian Carlstromc74255f2011-09-11 22:47:39 -0700300 struct InitFromImageCallbackState;
Brian Carlstroma663ea52011-08-19 23:33:41 -0700301
302 void FinishInit();
303
Brian Carlstrom75cb3b42011-07-28 02:13:36 -0700304 // For early bootstrapping by Init
Brian Carlstrom4873d462011-08-21 15:23:39 -0700305 Class* AllocClass(Class* java_lang_Class, size_t class_size);
Brian Carlstrom75cb3b42011-07-28 02:13:36 -0700306
307 // Alloc* convenience functions to avoid needing to pass in Class*
308 // values that are known to the ClassLinker such as
309 // kObjectArrayClass and kJavaLangString etc.
Brian Carlstrom4873d462011-08-21 15:23:39 -0700310 Class* AllocClass(size_t class_size);
Brian Carlstrom9ea1cb12011-08-24 23:18:18 -0700311 DexCache* AllocDexCache(const DexFile& dex_file);
Jesse Wilson35baaab2011-08-10 16:18:03 -0400312 Field* AllocField();
Ian Rogersbdb03912011-09-14 00:55:44 -0700313
Brian Carlstrom75cb3b42011-07-28 02:13:36 -0700314 Method* AllocMethod();
Ian Rogersbdb03912011-09-14 00:55:44 -0700315
Brian Carlstrom4b620ff2011-09-11 01:11:01 -0700316 InterfaceEntry* AllocInterfaceEntry(Class* interface);
Brian Carlstrom75cb3b42011-07-28 02:13:36 -0700317
Brian Carlstrom6b4ef022011-10-23 14:59:04 -0700318 Class* CreatePrimitiveClass(const char* descriptor, Primitive::Type type) {
Brian Carlstrom5b8e4c82011-09-18 01:38:59 -0700319 return InitializePrimitiveClass(AllocClass(sizeof(Class)), descriptor, type);
320 }
321 Class* InitializePrimitiveClass(Class* primitive_class,
322 const char* descriptor,
Brian Carlstrom6b4ef022011-10-23 14:59:04 -0700323 Primitive::Type type);
Brian Carlstrom5b8e4c82011-09-18 01:38:59 -0700324
Brian Carlstroma331b3c2011-07-18 17:47:56 -0700325
Elliott Hughesc3b77c72011-12-15 20:56:48 -0800326 Class* CreateArrayClass(const std::string& descriptor, const ClassLoader* class_loader);
Brian Carlstroma331b3c2011-07-18 17:47:56 -0700327
Brian Carlstrom9ea1cb12011-08-24 23:18:18 -0700328 void AppendToBootClassPath(const DexFile& dex_file);
Brian Carlstrom40381fb2011-10-19 14:13:40 -0700329 void AppendToBootClassPath(const DexFile& dex_file, SirtRef<DexCache>& dex_cache);
Brian Carlstrom578bbdc2011-07-21 14:07:47 -0700330
Elliott Hughes5fe594f2011-09-08 12:33:17 -0700331 void ConstructFieldMap(const DexFile& dex_file, const DexFile::ClassDef& dex_class_def,
Elliott Hughesa0e18062012-04-13 15:59:59 -0700332 Class* c, SafeMap<uint32_t, Field*>& field_map);
Elliott Hughes5fe594f2011-09-08 12:33:17 -0700333
Brian Carlstrom4873d462011-08-21 15:23:39 -0700334 size_t SizeOfClass(const DexFile& dex_file,
335 const DexFile::ClassDef& dex_class_def);
336
Brian Carlstromf615a612011-07-23 12:50:34 -0700337 void LoadClass(const DexFile& dex_file,
338 const DexFile::ClassDef& dex_class_def,
Brian Carlstrom40381fb2011-10-19 14:13:40 -0700339 SirtRef<Class>& klass,
Brian Carlstrom9ea1cb12011-08-24 23:18:18 -0700340 const ClassLoader* class_loader);
Brian Carlstrom578bbdc2011-07-21 14:07:47 -0700341
Ian Rogers0571d352011-11-03 19:51:38 -0700342 void LoadField(const DexFile& dex_file, const ClassDataItemIterator& it, SirtRef<Class>& klass,
Brian Carlstrom40381fb2011-10-19 14:13:40 -0700343 SirtRef<Field>& dst);
Brian Carlstrom578bbdc2011-07-21 14:07:47 -0700344
Ian Rogers0571d352011-11-03 19:51:38 -0700345 void LoadMethod(const DexFile& dex_file, const ClassDataItemIterator& dex_method,
346 SirtRef<Class>& klass, SirtRef<Method>& dst);
Brian Carlstrom934486c2011-07-12 23:42:50 -0700347
Ian Rogers19846512012-02-24 11:42:47 -0800348 void FixupStaticTrampolines(Class* klass);
349
350 // Finds the associated oat class for a dex_file and descriptor
351 const OatFile::OatClass* GetOatClass(const DexFile& dex_file, const char* descriptor);
352
Brian Carlstrom07bb8552012-01-18 22:10:50 -0800353 // Attempts to insert a class into a class table. Returns NULL if
354 // the class was inserted, otherwise returns an existing class with
355 // the same descriptor and ClassLoader.
356 Class* InsertClass(const StringPiece& descriptor, Class* klass, bool image_class);
Brian Carlstromaded5f72011-10-07 17:15:04 -0700357
Elliott Hughesf8349362012-06-18 15:00:06 -0700358 void RegisterDexFileLocked(const DexFile& dex_file, SirtRef<DexCache>& dex_cache) EXCLUSIVE_LOCKS_REQUIRED(dex_lock_);
359 bool IsDexFileRegisteredLocked(const DexFile& dex_file) const EXCLUSIVE_LOCKS_REQUIRED(dex_lock_);
360 void RegisterOatFileLocked(const OatFile& oat_file) EXCLUSIVE_LOCKS_REQUIRED(dex_lock_);
Brian Carlstromaded5f72011-10-07 17:15:04 -0700361
Ian Rogers0045a292012-03-31 21:08:41 -0700362 bool InitializeClass(Class* klass, bool can_run_clinit, bool can_init_statics);
Brian Carlstromd1422f82011-09-28 11:37:09 -0700363 bool WaitForInitializeClass(Class* klass, Thread* self, ObjectLock& lock);
Carl Shapiro0e5d75d2011-07-06 18:28:37 -0700364 bool ValidateSuperClassDescriptors(const Class* klass);
Ian Rogers0045a292012-03-31 21:08:41 -0700365 bool InitializeSuperClass(Class* klass, bool can_run_clinit, bool can_init_fields);
366 // Initialize static fields, returns true if fields were initialized.
367 bool InitializeStaticFields(Class* klass);
Carl Shapiro0e5d75d2011-07-06 18:28:37 -0700368
Ian Rogers595799e2012-01-11 17:32:51 -0800369 bool IsSameDescriptorInDifferentClassContexts(const char* descriptor,
370 const Class* klass1,
371 const Class* klass2);
Carl Shapiro0e5d75d2011-07-06 18:28:37 -0700372
Ian Rogers595799e2012-01-11 17:32:51 -0800373 bool IsSameMethodSignatureInDifferentClassContexts(const Method* descriptor,
374 const Class* klass1,
375 const Class* klass2);
Carl Shapiro0e5d75d2011-07-06 18:28:37 -0700376
Ian Rogersc2b44472011-12-14 21:17:17 -0800377 bool LinkClass(SirtRef<Class>& klass, ObjectArray<Class>* interfaces);
Carl Shapiro0e5d75d2011-07-06 18:28:37 -0700378
Brian Carlstrom40381fb2011-10-19 14:13:40 -0700379 bool LinkSuperClass(SirtRef<Class>& klass);
Carl Shapiro0e5d75d2011-07-06 18:28:37 -0700380
Brian Carlstrom40381fb2011-10-19 14:13:40 -0700381 bool LoadSuperAndInterfaces(SirtRef<Class>& klass, const DexFile& dex_file);
Carl Shapiro0e5d75d2011-07-06 18:28:37 -0700382
Ian Rogers6d4d9fc2011-11-30 16:24:48 -0800383 bool LinkMethods(SirtRef<Class>& klass, ObjectArray<Class>* interfaces);
Carl Shapiro0e5d75d2011-07-06 18:28:37 -0700384
Brian Carlstrom40381fb2011-10-19 14:13:40 -0700385 bool LinkVirtualMethods(SirtRef<Class>& klass);
Carl Shapiro0e5d75d2011-07-06 18:28:37 -0700386
Ian Rogers6d4d9fc2011-11-30 16:24:48 -0800387 bool LinkInterfaceMethods(SirtRef<Class>& klass, ObjectArray<Class>* interfaces);
Carl Shapiro0e5d75d2011-07-06 18:28:37 -0700388
Brian Carlstrom40381fb2011-10-19 14:13:40 -0700389 bool LinkStaticFields(SirtRef<Class>& klass);
390 bool LinkInstanceFields(SirtRef<Class>& klass);
391 bool LinkFields(SirtRef<Class>& klass, bool is_static);
Ian Rogers0cfe1fb2011-08-26 03:29:44 -0700392
Carl Shapiro0e5d75d2011-07-06 18:28:37 -0700393
Brian Carlstrom40381fb2011-10-19 14:13:40 -0700394 void CreateReferenceInstanceOffsets(SirtRef<Class>& klass);
395 void CreateReferenceStaticOffsets(SirtRef<Class>& klass);
396 void CreateReferenceOffsets(SirtRef<Class>& klass, bool is_static,
Ian Rogers0cfe1fb2011-08-26 03:29:44 -0700397 uint32_t reference_offsets);
Carl Shapiro0e5d75d2011-07-06 18:28:37 -0700398
Brian Carlstrom58ae9412011-10-04 00:56:06 -0700399 // For use by ImageWriter to find DexCaches for its roots
400 const std::vector<DexCache*>& GetDexCaches() {
401 return dex_caches_;
402 }
403
Brian Carlstromae826982011-11-09 01:33:42 -0800404 const OatFile* FindOpenedOatFileForDexFile(const DexFile& dex_file);
Brian Carlstroma004aa92012-02-08 18:05:09 -0800405 const OatFile* FindOpenedOatFileFromDexLocation(const std::string& dex_location);
Brian Carlstromae826982011-11-09 01:33:42 -0800406 const OatFile* FindOpenedOatFileFromOatLocation(const std::string& oat_location);
Brian Carlstrom46b8a622012-06-19 23:13:22 -0700407 const DexFile* VerifyOatFileChecksums(const OatFile* oat_file,
408 const std::string& dex_location,
409 uint32_t dex_location_checksum)
410 EXCLUSIVE_LOCKS_REQUIRED(dex_lock_);
Brian Carlstromfad71432011-10-16 20:25:10 -0700411
Ian Rogers6d4d9fc2011-11-30 16:24:48 -0800412 Method* CreateProxyConstructor(SirtRef<Class>& klass, Class* proxy_class);
413 Method* CreateProxyMethod(SirtRef<Class>& klass, SirtRef<Method>& prototype);
Jesse Wilson95caa792011-10-12 18:14:17 -0400414
Brian Carlstrom4a96b602011-07-26 16:40:23 -0700415 std::vector<const DexFile*> boot_class_path_;
Brian Carlstrom578bbdc2011-07-21 14:07:47 -0700416
Brian Carlstrom47d237a2011-10-18 15:08:33 -0700417 mutable Mutex dex_lock_;
Elliott Hughesf8349362012-06-18 15:00:06 -0700418 std::vector<const DexFile*> dex_files_ GUARDED_BY(dex_lock_);
419 std::vector<DexCache*> dex_caches_ GUARDED_BY(dex_lock_);
420 std::vector<const OatFile*> oat_files_ GUARDED_BY(dex_lock_);
Brian Carlstrom47d237a2011-10-18 15:08:33 -0700421
Carl Shapiro0e5d75d2011-07-06 18:28:37 -0700422
Brian Carlstromaded5f72011-10-07 17:15:04 -0700423 // multimap from a string hash code of a class descriptor to
Brian Carlstrom9cff8e12011-08-18 16:47:29 -0700424 // Class* instances. Results should be compared for a matching
425 // Class::descriptor_ and Class::class_loader_.
Brian Carlstrom47d237a2011-10-18 15:08:33 -0700426 mutable Mutex classes_lock_;
Elliott Hughesf8349362012-06-18 15:00:06 -0700427 typedef std::multimap<size_t, Class*> Table;
428 Table image_classes_ GUARDED_BY(classes_lock_);
429 Table classes_ GUARDED_BY(classes_lock_);
430
431 Class* LookupClassLocked(const char* descriptor, const ClassLoader* class_loader,
432 size_t hash, const Table& classes) EXCLUSIVE_LOCKS_REQUIRED(classes_lock_);
Carl Shapiro0e5d75d2011-07-06 18:28:37 -0700433
Brian Carlstroma663ea52011-08-19 23:33:41 -0700434 // indexes into class_roots_.
435 // needs to be kept in sync with class_roots_descriptors_.
Brian Carlstrom74eb46a2011-08-02 20:10:14 -0700436 enum ClassRoot {
Brian Carlstrom75cb3b42011-07-28 02:13:36 -0700437 kJavaLangClass,
438 kJavaLangObject,
Elliott Hughes418d20f2011-09-22 14:00:39 -0700439 kClassArrayClass,
Brian Carlstrom74eb46a2011-08-02 20:10:14 -0700440 kObjectArrayClass,
441 kJavaLangString,
Elliott Hughesbf61ba32011-10-11 10:53:09 -0700442 kJavaLangRefReference,
Elliott Hughes80609252011-09-23 17:24:51 -0700443 kJavaLangReflectConstructor,
Brian Carlstrom75cb3b42011-07-28 02:13:36 -0700444 kJavaLangReflectField,
445 kJavaLangReflectMethod,
Ian Rogers466bb252011-10-14 03:29:56 -0700446 kJavaLangReflectProxy,
Brian Carlstrom74eb46a2011-08-02 20:10:14 -0700447 kJavaLangClassLoader,
448 kDalvikSystemBaseDexClassLoader,
449 kDalvikSystemPathClassLoader,
Ian Rogers5167c972012-02-03 10:41:20 -0800450 kJavaLangThrowable,
jeffhao8cd6dda2012-02-22 10:15:34 -0800451 kJavaLangClassNotFoundException,
Shih-wei Liao55df06b2011-08-26 14:39:27 -0700452 kJavaLangStackTraceElement,
Brian Carlstrom75cb3b42011-07-28 02:13:36 -0700453 kPrimitiveBoolean,
Brian Carlstrom75cb3b42011-07-28 02:13:36 -0700454 kPrimitiveByte,
Elliott Hughesd8ddfd52011-08-15 14:32:53 -0700455 kPrimitiveChar,
456 kPrimitiveDouble,
457 kPrimitiveFloat,
Brian Carlstrom75cb3b42011-07-28 02:13:36 -0700458 kPrimitiveInt,
459 kPrimitiveLong,
Elliott Hughesd8ddfd52011-08-15 14:32:53 -0700460 kPrimitiveShort,
Brian Carlstrom75cb3b42011-07-28 02:13:36 -0700461 kPrimitiveVoid,
Elliott Hughesd8ddfd52011-08-15 14:32:53 -0700462 kBooleanArrayClass,
463 kByteArrayClass,
464 kCharArrayClass,
465 kDoubleArrayClass,
466 kFloatArrayClass,
467 kIntArrayClass,
468 kLongArrayClass,
469 kShortArrayClass,
Shih-wei Liao55df06b2011-08-26 14:39:27 -0700470 kJavaLangStackTraceElementArrayClass,
Brian Carlstrom75cb3b42011-07-28 02:13:36 -0700471 kClassRootsMax,
472 };
473 ObjectArray<Class>* class_roots_;
Brian Carlstrom913af1b2011-07-23 21:41:13 -0700474
Brian Carlstrom74eb46a2011-08-02 20:10:14 -0700475 Class* GetClassRoot(ClassRoot class_root) {
Brian Carlstroma663ea52011-08-19 23:33:41 -0700476 DCHECK(class_roots_ != NULL);
Brian Carlstrom74eb46a2011-08-02 20:10:14 -0700477 Class* klass = class_roots_->Get(class_root);
478 DCHECK(klass != NULL);
479 return klass;
480 }
481
Ian Rogers6d4d9fc2011-11-30 16:24:48 -0800482 void SetClassRoot(ClassRoot class_root, Class* klass);
Brian Carlstroma663ea52011-08-19 23:33:41 -0700483
Brian Carlstrom34f426c2011-10-04 12:58:02 -0700484 ObjectArray<Class>* GetClassRoots() {
485 DCHECK(class_roots_ != NULL);
486 return class_roots_;
487 }
488
Elliott Hughes418d20f2011-09-22 14:00:39 -0700489 static const char* class_roots_descriptors_[];
Brian Carlstroma663ea52011-08-19 23:33:41 -0700490
491 const char* GetClassRootDescriptor(ClassRoot class_root) {
492 const char* descriptor = class_roots_descriptors_[class_root];
493 CHECK(descriptor != NULL);
494 return descriptor;
495 }
496
Brian Carlstrom4b620ff2011-09-11 01:11:01 -0700497 ObjectArray<InterfaceEntry>* array_iftable_;
Carl Shapiro565f5072011-07-10 13:39:43 -0700498
Brian Carlstrom75cb3b42011-07-28 02:13:36 -0700499 bool init_done_;
500
Elliott Hughescf4c6c42011-09-01 15:16:42 -0700501 InternTable* intern_table_;
502
Brian Carlstromf734cf52011-08-17 16:28:14 -0700503 friend class CommonTest;
Brian Carlstrom34f426c2011-10-04 12:58:02 -0700504 friend class ImageWriter; // for GetClassRoots
Brian Carlstromae826982011-11-09 01:33:42 -0800505 friend class ObjectTest;
Ian Rogers6d4d9fc2011-11-30 16:24:48 -0800506 FRIEND_TEST(ClassLinkerTest, ClassRootDescriptors);
Brian Carlstromae826982011-11-09 01:33:42 -0800507 FRIEND_TEST(DexCacheTest, Open);
508 FRIEND_TEST(ExceptionTest, FindExceptionHandler);
509 FRIEND_TEST(ObjectTest, AllocObjectArray);
Carl Shapiro0e5d75d2011-07-06 18:28:37 -0700510 DISALLOW_COPY_AND_ASSIGN(ClassLinker);
511};
512
513} // namespace art
514
515#endif // ART_SRC_CLASS_LINKER_H_