1 // natClassLoader.cc - Implementation of java.lang.ClassLoader native methods.
3 /* Copyright (C) 1999, 2000, 2001, 2002, 2003 Free Software Foundation
5 This file is part of libgcj.
7 This software is copyrighted work licensed under the terms of the
8 Libgcj License. Please consult the file "LIBGCJ_LICENSE" for
11 /* Author: Kresten Krab Thorup <krab@gnu.org> */
21 #include <java-threads.h>
22 #include <java-interp.h>
24 #include <java/lang/Character.h>
25 #include <java/lang/Thread.h>
26 #include <java/lang/ClassLoader.h>
27 #include <gnu/gcj/runtime/VMClassLoader.h>
28 #include <java/lang/InternalError.h>
29 #include <java/lang/IllegalAccessError.h>
30 #include <java/lang/LinkageError.h>
31 #include <java/lang/ClassFormatError.h>
32 #include <java/lang/NoClassDefFoundError.h>
33 #include <java/lang/ClassNotFoundException.h>
34 #include <java/lang/ClassCircularityError.h>
35 #include <java/lang/IncompatibleClassChangeError.h>
36 #include <java/lang/VirtualMachineError.h>
37 #include <java/lang/VMClassLoader.h>
38 #include <java/lang/reflect/Modifier.h>
39 #include <java/lang/Runtime.h>
40 #include <java/lang/StringBuffer.h>
41 #include <java/io/Serializable.h>
42 #include <java/lang/Cloneable.h>
44 /////////// java.lang.ClassLoader native methods ////////////
47 java::lang::VMClassLoader::defineClass (java::lang::ClassLoader
*loader
,
52 java::security::ProtectionDomain
*pd
)
56 klass
= (jclass
) JvAllocObject (&java::lang::Class::class$
,
57 sizeof (_Jv_InterpClass
));
59 // Synchronize on the class, so that it is not attempted initialized
60 // until we're done loading.
61 JvSynchronize
sync (klass
);
63 // Record the defining loader. For the system class loader, we
65 if (loader
!= java::lang::ClassLoader::getSystemClassLoader())
66 klass
->loader
= loader
;
70 _Jv_Utf8Const
*name2
= _Jv_makeUtf8Const (name
);
72 if (! _Jv_VerifyClassName (name2
))
73 throw new java::lang::ClassFormatError
74 (JvNewStringLatin1 ("erroneous class name"));
81 _Jv_DefineClass (klass
, data
, offset
, length
);
83 catch (java::lang::Throwable
*ex
)
85 klass
->state
= JV_STATE_ERROR
;
88 _Jv_UnregisterClass (klass
);
90 // If EX is not a ClassNotFoundException, that's ok, because we
91 // account for the possibility in defineClass().
95 klass
->protectionDomain
= pd
;
97 // if everything proceeded sucessfully, we're loaded.
98 JvAssert (klass
->state
== JV_STATE_LOADED
);
108 // Finish linking a class. Only called from ClassLoader::resolveClass.
110 java::lang::VMClassLoader::linkClass0 (java::lang::Class
*klass
)
112 _Jv_WaitForState (klass
, JV_STATE_LINKED
);
116 java::lang::VMClassLoader::markClassErrorState0 (java::lang::Class
*klass
)
118 klass
->state
= JV_STATE_ERROR
;
122 java::lang::ClassLoader
*
123 java::lang::VMClassLoader::getSystemClassLoaderInternal()
125 _Jv_InitClass (&gnu::gcj::runtime::VMClassLoader::class$
);
126 return gnu::gcj::runtime::VMClassLoader::instance
;
130 java::lang::VMClassLoader::getPrimitiveClass (jchar type
)
133 sig
[0] = (char) type
;
135 return _Jv_FindClassFromSignature (sig
, NULL
);
139 java::lang::VMClassLoader::loadClass(jstring name
, jboolean resolve
)
141 _Jv_Utf8Const
*utf
= _Jv_makeUtf8Const (name
);
142 // FIXME: we culd make _Jv_FindClassFromSignature a template.
143 jclass klass
= _Jv_FindClassInCache (utf
, NULL
);
144 if (klass
&& resolve
)
145 _Jv_InitClass (klass
);
150 _Jv_WaitForState (jclass klass
, int state
)
152 if (klass
->state
>= state
)
155 _Jv_MonitorEnter (klass
) ;
157 if (state
== JV_STATE_LINKED
)
159 // Must call _Jv_PrepareCompiledClass while holding the class
162 if (_Jv_IsInterpretedClass (klass
))
163 _Jv_PrepareClass (klass
);
165 _Jv_PrepareCompiledClass (klass
);
166 _Jv_MonitorExit (klass
);
170 java::lang::Thread
*self
= java::lang::Thread::currentThread();
172 // this is similar to the strategy for class initialization.
173 // if we already hold the lock, just leave.
174 while (klass
->state
<= state
176 && klass
->thread
!= self
)
179 _Jv_MonitorExit (klass
);
181 if (klass
->state
== JV_STATE_ERROR
)
182 throw new java::lang::LinkageError
;
185 typedef unsigned int uaddr
__attribute__ ((mode (pointer
)));
187 /** This function does class-preparation for compiled classes.
188 NOTE: It contains replicated functionality from
189 _Jv_ResolvePoolEntry, and this is intentional, since that function
190 lives in resolve.cc which is entirely conditionally compiled.
193 _Jv_PrepareCompiledClass (jclass klass
)
195 if (klass
->state
>= JV_STATE_LINKED
)
198 // Short-circuit, so that mutually dependent classes are ok.
199 klass
->state
= JV_STATE_LINKED
;
201 _Jv_Constants
*pool
= &klass
->constants
;
203 // Resolve class constants first, since other constant pool
204 // entries may rely on these.
205 for (int index
= 1; index
< pool
->size
; ++index
)
207 if (pool
->tags
[index
] == JV_CONSTANT_Class
)
209 _Jv_Utf8Const
*name
= pool
->data
[index
].utf8
;
212 if (name
->data
[0] == '[')
213 found
= _Jv_FindClassFromSignature (&name
->data
[0],
216 found
= _Jv_FindClass (name
, klass
->loader
);
220 jstring str
= _Jv_NewStringUTF (name
->data
);
221 throw new java::lang::NoClassDefFoundError (str
);
224 pool
->data
[index
].clazz
= found
;
225 pool
->tags
[index
] |= JV_CONSTANT_ResolvedFlag
;
229 // If superclass looks like a constant pool entry,
231 if ((uaddr
) klass
->superclass
< pool
->size
)
232 klass
->superclass
= pool
->data
[(int) klass
->superclass
].clazz
;
234 // Likewise for interfaces.
235 for (int i
= 0; i
< klass
->interface_count
; i
++)
236 if ((uaddr
) klass
->interfaces
[i
] < pool
->size
)
237 klass
->interfaces
[i
] = pool
->data
[(int) klass
->interfaces
[i
]].clazz
;
239 // Resolve the remaining constant pool entries.
240 for (int index
= 1; index
< pool
->size
; ++index
)
242 if (pool
->tags
[index
] == JV_CONSTANT_String
)
246 str
= _Jv_NewStringUtf8Const (pool
->data
[index
].utf8
);
247 pool
->data
[index
].o
= str
;
248 pool
->tags
[index
] |= JV_CONSTANT_ResolvedFlag
;
253 // FIXME: although the comment up top says that this function is
254 // only called for compiled classes, it is actually called for every
256 if (! _Jv_IsInterpretedClass (klass
))
258 #endif /* INTERPRETER */
259 jfieldID f
= JvGetFirstStaticField (klass
);
260 for (int n
= JvNumStaticFields (klass
); n
> 0; --n
)
262 int mod
= f
->getModifiers ();
263 // If we have a static String field with a non-null initial
264 // value, we know it points to a Utf8Const.
265 _Jv_ResolveField(f
, klass
->loader
);
266 if (f
->getClass () == &java::lang::String::class$
267 && java::lang::reflect::Modifier::isStatic (mod
))
269 jstring
*strp
= (jstring
*) f
->u
.addr
;
271 *strp
= _Jv_NewStringUtf8Const ((_Jv_Utf8Const
*) *strp
);
273 f
= f
->getNextField ();
277 #endif /* INTERPRETER */
281 _Jv_PushClass (klass
);
286 // A single class can have many "initiating" class loaders,
287 // and a single "defining" class loader. The Defining
288 // class loader is what is returned from Class.getClassLoader()
289 // and is used when loading dependent classes during resolution.
290 // The set of initiating class loaders are used to ensure
291 // safety of linking, and is maintained in the hash table
292 // "initiated_classes". A defining classloader is by definition also
293 // initiating, so we only store classes in this table if they have more
294 // than one class loader associated.
298 // Size of local hash table.
299 #define HASH_LEN 1013
301 // Hash function for Utf8Consts.
302 #define HASH_UTF(Utf) (((Utf)->hash) % HASH_LEN)
304 struct _Jv_LoaderInfo
306 _Jv_LoaderInfo
*next
;
307 java::lang::Class
*klass
;
308 java::lang::ClassLoader
*loader
;
311 static _Jv_LoaderInfo
*initiated_classes
[HASH_LEN
];
312 static jclass loaded_classes
[HASH_LEN
];
314 // This is the root of a linked list of classes
319 _Jv_FindClassInCache (_Jv_Utf8Const
*name
, java::lang::ClassLoader
*loader
)
321 JvSynchronize
sync (&java::lang::Class::class$
);
322 jint hash
= HASH_UTF (name
);
324 if (loader
&& loader
== java::lang::ClassLoader::getSystemClassLoader())
327 // first, if LOADER is a defining loader, then it is also initiating
329 for (klass
= loaded_classes
[hash
]; klass
; klass
= klass
->next
)
331 if (loader
== klass
->loader
&& _Jv_equalUtf8Consts (name
, klass
->name
))
335 // otherwise, it may be that the class in question was defined
336 // by some other loader, but that the loading was initiated by
337 // the loader in question.
340 _Jv_LoaderInfo
*info
;
341 for (info
= initiated_classes
[hash
]; info
; info
= info
->next
)
343 if (loader
== info
->loader
344 && _Jv_equalUtf8Consts (name
, info
->klass
->name
))
356 _Jv_UnregisterClass (jclass the_class
)
358 JvSynchronize
sync (&java::lang::Class::class$
);
359 jint hash
= HASH_UTF(the_class
->name
);
361 jclass
*klass
= &(loaded_classes
[hash
]);
362 for ( ; *klass
; klass
= &((*klass
)->next
))
364 if (*klass
== the_class
)
366 *klass
= (*klass
)->next
;
371 _Jv_LoaderInfo
**info
= &(initiated_classes
[hash
]);
372 for ( ; ; info
= &((*info
)->next
))
374 while (*info
&& (*info
)->klass
== the_class
)
376 _Jv_LoaderInfo
*old
= *info
;
377 *info
= (*info
)->next
;
387 _Jv_RegisterInitiatingLoader (jclass klass
, java::lang::ClassLoader
*loader
)
389 if (loader
&& loader
== java::lang::ClassLoader::getSystemClassLoader())
392 // This information can't be visible to the GC.
394 = (_Jv_LoaderInfo
*) _Jv_Malloc (sizeof(_Jv_LoaderInfo
));
395 jint hash
= HASH_UTF(klass
->name
);
397 JvSynchronize
sync (&java::lang::Class::class$
);
398 info
->loader
= loader
;
400 info
->next
= initiated_classes
[hash
];
401 initiated_classes
[hash
] = info
;
404 // This function is called many times during startup, before main() is
405 // run. At that point in time we know for certain we are running
406 // single-threaded, so we don't need to lock when adding classes to the
407 // class chain. At all other times, the caller should synchronize on
410 _Jv_RegisterClasses (jclass
*classes
)
412 for (; *classes
; ++classes
)
414 jclass klass
= *classes
;
416 (*_Jv_RegisterClassHook
) (klass
);
418 // registering a compiled class causes
419 // it to be immediately "prepared".
420 if (klass
->state
== JV_STATE_NOTHING
)
421 klass
->state
= JV_STATE_COMPILED
;
426 _Jv_RegisterClassHookDefault (jclass klass
)
428 jint hash
= HASH_UTF (klass
->name
);
430 jclass check_class
= loaded_classes
[hash
];
432 // If the class is already registered, don't re-register it.
433 while (check_class
!= NULL
)
435 if (check_class
== klass
)
437 // If you get this, it means you have the same class in two
438 // different libraries.
439 #define TEXT "Duplicate class registration: "
440 // We size-limit MESSAGE so that you can't trash the stack.
442 strcpy (message
, TEXT
);
443 strncpy (message
+ sizeof (TEXT
) - 1, klass
->name
->data
,
444 sizeof (message
) - sizeof (TEXT
));
445 message
[sizeof (message
) - 1] = '\0';
446 if (! gcj::runtimeInitialized
)
450 java::lang::String
*str
= JvNewStringLatin1 (message
);
451 throw new java::lang::VirtualMachineError (str
);
455 check_class
= check_class
->next
;
458 klass
->next
= loaded_classes
[hash
];
459 loaded_classes
[hash
] = klass
;
462 // A pointer to a function that actually registers a class.
463 // Normally _Jv_RegisterClassHookDefault, but could be some other function
464 // that registers the class in e.g. a ClassLoader-local table.
465 // Should synchronize on Class:class$ while setting/restore this variable.
467 void (*_Jv_RegisterClassHook
) (jclass cl
) = _Jv_RegisterClassHookDefault
;
470 _Jv_RegisterClass (jclass klass
)
475 _Jv_RegisterClasses (classes
);
479 _Jv_FindClass (_Jv_Utf8Const
*name
, java::lang::ClassLoader
*loader
)
481 jclass klass
= _Jv_FindClassInCache (name
, loader
);
485 jstring sname
= _Jv_NewStringUTF (name
->data
);
487 java::lang::ClassLoader
*sys
488 = java::lang::ClassLoader::getSystemClassLoader ();
492 // Load using a user-defined loader, jvmspec 5.3.2
493 klass
= loader
->loadClass(sname
, false);
495 // If "loader" delegated the loadClass operation to another
496 // loader, explicitly register that it is also an initiating
497 // loader of the given class.
498 java::lang::ClassLoader
*delegate
= (loader
== sys
501 if (klass
&& klass
->getClassLoaderInternal () != delegate
)
502 _Jv_RegisterInitiatingLoader (klass
, loader
);
506 // Load using the bootstrap loader jvmspec 5.3.1.
507 klass
= sys
->loadClass (sname
, false);
509 // Register that we're an initiating loader.
511 _Jv_RegisterInitiatingLoader (klass
, 0);
516 // we need classes to be in the hash while
517 // we're loading, so that they can refer to themselves.
518 _Jv_WaitForState (klass
, JV_STATE_LOADED
);
525 _Jv_NewClass (_Jv_Utf8Const
*name
, jclass superclass
,
526 java::lang::ClassLoader
*loader
)
528 jclass ret
= (jclass
) JvAllocObject (&java::lang::Class::class$
);
530 ret
->superclass
= superclass
;
531 ret
->loader
= loader
;
533 _Jv_RegisterClass (ret
);
538 static _Jv_IDispatchTable
*array_idt
= NULL
;
539 static jshort array_depth
= 0;
540 static jclass
*array_ancestors
= NULL
;
542 // Create a class representing an array of ELEMENT and store a pointer to it
543 // in element->arrayclass. LOADER is the ClassLoader which _initiated_ the
544 // instantiation of this array. ARRAY_VTABLE is the vtable to use for the new
545 // array class. This parameter is optional.
547 _Jv_NewArrayClass (jclass element
, java::lang::ClassLoader
*loader
,
548 _Jv_VTable
*array_vtable
)
550 JvSynchronize
sync (element
);
552 _Jv_Utf8Const
*array_name
;
555 if (element
->arrayclass
)
558 if (element
->isPrimitive())
560 if (element
== JvPrimClass (void))
561 throw new java::lang::ClassNotFoundException ();
565 len
= element
->name
->length
+ 5;
570 signature
[index
++] = '[';
571 // Compute name of array class.
572 if (element
->isPrimitive())
574 signature
[index
++] = (char) element
->method_count
;
578 size_t length
= element
->name
->length
;
579 const char *const name
= element
->name
->data
;
581 signature
[index
++] = 'L';
582 memcpy (&signature
[index
], name
, length
);
585 signature
[index
++] = ';';
587 array_name
= _Jv_makeUtf8Const (signature
, index
);
590 // Create new array class.
591 jclass array_class
= _Jv_NewClass (array_name
, &java::lang::Object::class$
,
594 // Note that `vtable_method_count' doesn't include the initial
596 JvAssert (java::lang::Object::class$
.vtable_method_count
597 == NUM_OBJECT_METHODS
);
598 int dm_count
= java::lang::Object::class$
.vtable_method_count
;
600 // Create a new vtable by copying Object's vtable.
603 vtable
= array_vtable
;
605 vtable
= _Jv_VTable::new_vtable (dm_count
);
606 vtable
->clas
= array_class
;
607 vtable
->gc_descr
= java::lang::Object::class$
.vtable
->gc_descr
;
608 for (int i
= 0; i
< dm_count
; ++i
)
609 vtable
->set_method (i
, java::lang::Object::class$
.vtable
->get_method (i
));
611 array_class
->vtable
= vtable
;
612 array_class
->vtable_method_count
613 = java::lang::Object::class$
.vtable_method_count
;
615 // Stash the pointer to the element type.
616 array_class
->methods
= (_Jv_Method
*) element
;
618 // Register our interfaces.
619 static jclass interfaces
[] =
621 &java::lang::Cloneable::class$
,
622 &java::io::Serializable::class$
624 array_class
->interfaces
= interfaces
;
625 array_class
->interface_count
= sizeof interfaces
/ sizeof interfaces
[0];
627 // Since all array classes have the same interface dispatch table, we can
628 // cache one and reuse it. It is not necessary to synchronize this.
631 _Jv_PrepareConstantTimeTables (array_class
);
632 array_idt
= array_class
->idt
;
633 array_depth
= array_class
->depth
;
634 array_ancestors
= array_class
->ancestors
;
638 array_class
->idt
= array_idt
;
639 array_class
->depth
= array_depth
;
640 array_class
->ancestors
= array_ancestors
;
643 using namespace java::lang::reflect
;
645 // Array classes are "abstract final"...
646 _Jv_ushort accflags
= Modifier::FINAL
| Modifier::ABSTRACT
;
647 // ... and inherit accessibility from element type, per vmspec 5.3.3.2
648 accflags
|= (element
->accflags
& Modifier::PUBLIC
);
649 accflags
|= (element
->accflags
& Modifier::PROTECTED
);
650 accflags
|= (element
->accflags
& Modifier::PRIVATE
);
651 array_class
->accflags
= accflags
;
654 // An array class has no visible instance fields. "length" is invisible to
657 // say this class is initialized and ready to go!
658 array_class
->state
= JV_STATE_DONE
;
660 // vmspec, section 5.3.3 describes this
661 if (element
->loader
!= loader
)
662 _Jv_RegisterInitiatingLoader (array_class
, loader
);
664 element
->arrayclass
= array_class
;
667 static jclass stack_head
;
669 // These two functions form a stack of classes. When a class is loaded
670 // it is pushed onto the stack by the class loader; this is so that
671 // StackTrace can quickly determine which classes have been loaded.
676 JvSynchronize
sync (&java::lang::Class::class$
);
679 jclass tmp
= stack_head
;
680 stack_head
= tmp
->chain
;
687 _Jv_PushClass (jclass k
)
689 JvSynchronize
sync (&java::lang::Class::class$
);
690 jclass tmp
= stack_head
;