Merge to subtype-trunk (manually: src/vm/linker.hpp, src/vm/vftbl.hpp)
[cacao.git] / src / vm / class.cpp
1 /* src/vm/class.cpp - class related functions
2
3    Copyright (C) 1996-2005, 2006, 2007, 2008
4    CACAOVM - Verein zur Foerderung der freien virtuellen Maschine CACAO
5
6    This file is part of CACAO.
7
8    This program is free software; you can redistribute it and/or
9    modify it under the terms of the GNU General Public License as
10    published by the Free Software Foundation; either version 2, or (at
11    your option) any later version.
12
13    This program is distributed in the hope that it will be useful, but
14    WITHOUT ANY WARRANTY; without even the implied warranty of
15    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
16    General Public License for more details.
17
18    You should have received a copy of the GNU General Public License
19    along with this program; if not, write to the Free Software
20    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
21    02110-1301, USA.
22
23 */
24
25
26 #include "config.h"
27
28 #include <assert.h>
29 #include <stdio.h>
30 #include <stdlib.h>
31 #include <string.h>
32
33 #include "vm/types.h"
34
35 #include "arch.h"
36
37 #include "mm/memory.h"
38
39 #include "native/llni.h"
40
41 #include "threads/lock.hpp"
42 #include "threads/mutex.hpp"
43
44 #include "toolbox/logging.h"
45
46 #include "vm/array.hpp"
47 #include "vm/jit/builtin.hpp"
48 #include "vm/class.hpp"
49 #include "vm/classcache.hpp"
50 #include "vm/exceptions.hpp"
51 #include "vm/global.h"
52 #include "vm/globals.hpp"
53 #include "vm/javaobjects.hpp"
54 #include "vm/linker.hpp"
55 #include "vm/loader.hpp"
56 #include "vm/options.h"
57 #include "vm/resolve.hpp"
58
59 #if defined(ENABLE_STATISTICS)
60 # include "vm/statistics.h"
61 #endif
62
63 #include "vm/suck.hpp"
64 #include "vm/utf8.h"
65
66 #include "vm/jit/asmpart.h"
67
68
69 /* class_set_packagename *******************************************************
70
71    Derive the package name from the class name and store it in the
72    struct.
73
74    An internal package name consists of the package name plus the
75    trailing '/', e.g. "java/lang/".
76
77    For classes in the unnamed package, the package name is set to
78    NULL.
79
80 *******************************************************************************/
81
82 void class_set_packagename(classinfo *c)
83 {
84         char *p;
85         char *start;
86
87         p     = UTF_END(c->name) - 1;
88         start = c->name->text;
89
90         if (c->name->text[0] == '[') {
91                 /* Set packagename of arrays to the element's package. */
92
93                 for (; *start == '['; start++);
94
95                 /* Skip the 'L' in arrays of references. */
96
97                 if (*start == 'L')
98                         start++;
99         }
100
101         /* Search for last '/'. */
102
103         for (; (p > start) && (*p != '/'); --p);
104
105         /* If we found a '/' we set the package name plus the trailing
106            '/'.  Otherwise we set the packagename to NULL. */
107
108         if (p > start)
109                 c->packagename = utf_new(start, p - start + 1);
110         else
111                 c->packagename = NULL;
112 }
113
114
115 /* class_create_classinfo ******************************************************
116
117    Create a new classinfo struct. The class name is set to the given utf *,
118    most other fields are initialized to zero.
119
120    Note: classname may be NULL. In this case a not-yet-named classinfo is
121          created. The name must be filled in later and class_set_packagename
122                  must be called after that.
123
124 *******************************************************************************/
125
126 classinfo *class_create_classinfo(utf *classname)
127 {
128         classinfo *c;
129
130 #if defined(ENABLE_STATISTICS)
131         if (opt_stat)
132                 size_classinfo += sizeof(classinfo);
133 #endif
134
135         /* we use a safe name for temporarily unnamed classes */
136
137         if (classname == NULL)
138                 classname = utf_not_named_yet;
139
140 #if !defined(NDEBUG)
141         if (initverbose)
142                 log_message_utf("Creating class: ", classname);
143 #endif
144
145 #if !defined(ENABLE_GC_BOEHM)
146         c = (classinfo *) heap_alloc_uncollectable(sizeof(classinfo));
147         /*c = NEW(classinfo);
148         MZERO(c, classinfo, 1);*/
149 #else
150         c = GCNEW_UNCOLLECTABLE(classinfo, 1);
151         /* GCNEW_UNCOLLECTABLE clears the allocated memory */
152 #endif
153
154         c->name = classname;
155
156         /* Set the header.vftbl of all loaded classes to the one of
157        java.lang.Class, so Java code can use a class as object. */
158
159         if (class_java_lang_Class != NULL)
160                 if (class_java_lang_Class->vftbl != NULL)
161                         c->object.header.vftbl = class_java_lang_Class->vftbl;
162
163 #if defined(ENABLE_JAVASE)
164         /* check if the class is a reference class and flag it */
165
166         if (classname == utf_java_lang_ref_SoftReference) {
167                 c->flags |= ACC_CLASS_REFERENCE_SOFT;
168         }
169         else if (classname == utf_java_lang_ref_WeakReference) {
170                 c->flags |= ACC_CLASS_REFERENCE_WEAK;
171         }
172         else if (classname == utf_java_lang_ref_PhantomReference) {
173                 c->flags |= ACC_CLASS_REFERENCE_PHANTOM;
174         }
175 #endif
176
177         if (classname != utf_not_named_yet)
178                 class_set_packagename(c);
179
180         c->object.header.lockword.init();
181
182         return c;
183 }
184
185
186 /* class_postset_header_vftbl **************************************************
187
188    Set the header.vftbl of all classes created before java.lang.Class
189    was linked.  This is necessary that Java code can use a class as
190    object.
191
192 *******************************************************************************/
193
194 void class_postset_header_vftbl(void)
195 {
196         classinfo *c;
197         u4 slot;
198         classcache_name_entry *nmen;
199         classcache_class_entry *clsen;
200
201         assert(class_java_lang_Class);
202
203         for (slot = 0; slot < hashtable_classcache.size; slot++) {
204                 nmen = (classcache_name_entry *) hashtable_classcache.ptr[slot];
205
206                 for (; nmen; nmen = nmen->hashlink) {
207                         /* iterate over all class entries */
208
209                         for (clsen = nmen->classes; clsen; clsen = clsen->next) {
210                                 c = clsen->classobj;
211
212                                 /* now set the the vftbl */
213
214                                 if (c->object.header.vftbl == NULL)
215                                         c->object.header.vftbl = class_java_lang_Class->vftbl;
216                         }
217                 }
218         }
219 }
220
221 /* class_define ****************************************************************
222
223    Calls the loader and defines a class in the VM.
224
225 *******************************************************************************/
226
227 classinfo *class_define(utf *name, classloader_t *cl, int32_t length, uint8_t *data, java_handle_t *pd)
228 {
229         classinfo   *c;
230         classinfo   *r;
231         classbuffer *cb;
232
233         if (name != NULL) {
234                 /* check if this class has already been defined */
235
236                 c = classcache_lookup_defined_or_initiated(cl, name);
237
238                 if (c != NULL) {
239                         exceptions_throw_linkageerror("duplicate class definition: ", c);
240                         return NULL;
241                 }
242         } 
243
244         /* create a new classinfo struct */
245
246         c = class_create_classinfo(name);
247
248 #if defined(ENABLE_STATISTICS)
249         /* measure time */
250
251         if (opt_getloadingtime)
252                 loadingtime_start();
253 #endif
254
255         /* build a classbuffer with the given data */
256
257         cb = NEW(classbuffer);
258
259         cb->clazz = c;
260         cb->size  = length;
261         cb->data  = data;
262         cb->pos   = cb->data;
263
264         /* preset the defining classloader */
265
266         c->classloader = cl;
267
268         /* load the class from this buffer */
269
270         r = load_class_from_classbuffer(cb);
271
272         /* free memory */
273
274         FREE(cb, classbuffer);
275
276 #if defined(ENABLE_STATISTICS)
277         /* measure time */
278
279         if (opt_getloadingtime)
280                 loadingtime_stop();
281 #endif
282
283         if (r == NULL) {
284                 /* If return value is NULL, we had a problem and the class is
285                    not loaded.  Now free the allocated memory, otherwise we
286                    could run into a DOS. */
287
288                 class_free(c);
289
290                 return NULL;
291         }
292
293 #if defined(ENABLE_JAVASE)
294 # if defined(WITH_JAVA_RUNTIME_LIBRARY_OPENJDK)
295         /* Store the protection domain. */
296
297         c->protectiondomain = pd;
298 # endif
299 #endif
300
301         /* Store the newly defined class in the class cache. This call
302            also checks whether a class of the same name has already been
303            defined by the same defining loader, and if so, replaces the
304            newly created class by the one defined earlier. */
305
306         /* Important: The classinfo given to classcache_store must be
307                       fully prepared because another thread may return
308                       this pointer after the lookup at to top of this
309                       function directly after the class cache lock has
310                       been released. */
311
312         c = classcache_store(cl, c, true);
313
314         return c;
315 }
316
317
318 /* class_load_attribute_sourcefile *********************************************
319
320    SourceFile_attribute {
321        u2 attribute_name_index;
322        u4 attribute_length;
323            u2 sourcefile_index;
324    }
325
326 *******************************************************************************/
327
328 static bool class_load_attribute_sourcefile(classbuffer *cb)
329 {
330         classinfo *c;
331         u4         attribute_length;
332         u2         sourcefile_index;
333         utf       *sourcefile;
334
335         /* get classinfo */
336
337         c = cb->clazz;
338
339         /* check buffer size */
340
341         if (!suck_check_classbuffer_size(cb, 4 + 2))
342                 return false;
343
344         /* check attribute length */
345
346         attribute_length = suck_u4(cb);
347
348         if (attribute_length != 2) {
349                 exceptions_throw_classformaterror(c, "Wrong size for VALUE attribute");
350                 return false;
351         }
352
353         /* there can be no more than one SourceFile attribute */
354
355         if (c->sourcefile != NULL) {
356                 exceptions_throw_classformaterror(c, "Multiple SourceFile attributes");
357                 return false;
358         }
359
360         /* get sourcefile */
361
362         sourcefile_index = suck_u2(cb);
363         sourcefile = (utf*) class_getconstant(c, sourcefile_index, CONSTANT_Utf8);
364
365         if (sourcefile == NULL)
366                 return false;
367
368         /* store sourcefile */
369
370         c->sourcefile = sourcefile;
371
372         return true;
373 }
374
375
376 /* class_load_attribute_enclosingmethod ****************************************
377
378    EnclosingMethod_attribute {
379        u2 attribute_name_index;
380        u4 attribute_length;
381            u2 class_index;
382            u2 method_index;
383    }
384
385 *******************************************************************************/
386
387 #if defined(ENABLE_JAVASE)
388 static bool class_load_attribute_enclosingmethod(classbuffer *cb)
389 {
390         classinfo             *c;
391         u4                     attribute_length;
392         u2                     class_index;
393         u2                     method_index;
394         classref_or_classinfo  cr;
395         constant_nameandtype  *cn;
396
397         /* get classinfo */
398
399         c = cb->clazz;
400
401         /* check buffer size */
402
403         if (!suck_check_classbuffer_size(cb, 4 + 2 + 2))
404                 return false;
405
406         /* check attribute length */
407
408         attribute_length = suck_u4(cb);
409
410         if (attribute_length != 4) {
411                 exceptions_throw_classformaterror(c, "Wrong size for VALUE attribute");
412                 return false;
413         }
414
415         /* there can be no more than one EnclosingMethod attribute */
416
417         if (c->enclosingmethod != NULL) {
418                 exceptions_throw_classformaterror(c, "Multiple EnclosingMethod attributes");
419                 return false;
420         }
421
422         /* get class index */
423
424         class_index = suck_u2(cb);
425         cr.ref = (constant_classref*) innerclass_getconstant(c, class_index, CONSTANT_Class);
426
427         /* get method index */
428
429         method_index = suck_u2(cb);
430         cn = (constant_nameandtype*) innerclass_getconstant(c, method_index, CONSTANT_NameAndType);
431
432         /* store info in classinfo */
433
434         c->enclosingclass.any = cr.any;
435         c->enclosingmethod    = cn;
436
437         return true;
438 }
439 #endif /* defined(ENABLE_JAVASE) */
440
441
442 /* class_load_attributes *******************************************************
443
444    Read attributes from ClassFile.
445
446    attribute_info {
447        u2 attribute_name_index;
448        u4 attribute_length;
449        u1 info[attribute_length];
450    }
451
452    InnerClasses_attribute {
453        u2 attribute_name_index;
454        u4 attribute_length;
455    }
456
457 *******************************************************************************/
458
459 bool class_load_attributes(classbuffer *cb)
460 {
461         classinfo             *c;
462         uint16_t               attributes_count;
463         uint16_t               attribute_name_index;
464         utf                   *attribute_name;
465         innerclassinfo        *info;
466         classref_or_classinfo  inner;
467         classref_or_classinfo  outer;
468         utf                   *name;
469         uint16_t               flags;
470         int                    i, j;
471
472         c = cb->clazz;
473
474         /* get attributes count */
475
476         if (!suck_check_classbuffer_size(cb, 2))
477                 return false;
478
479         attributes_count = suck_u2(cb);
480
481         for (i = 0; i < attributes_count; i++) {
482                 /* get attribute name */
483
484                 if (!suck_check_classbuffer_size(cb, 2))
485                         return false;
486
487                 attribute_name_index = suck_u2(cb);
488                 attribute_name =
489                         (utf*) class_getconstant(c, attribute_name_index, CONSTANT_Utf8);
490
491                 if (attribute_name == NULL)
492                         return false;
493
494                 if (attribute_name == utf_InnerClasses) {
495                         /* InnerClasses */
496
497                         if (c->innerclass != NULL) {
498                                 exceptions_throw_classformaterror(c, "Multiple InnerClasses attributes");
499                                 return false;
500                         }
501                                 
502                         if (!suck_check_classbuffer_size(cb, 4 + 2))
503                                 return false;
504
505                         /* skip attribute length */
506                         suck_u4(cb);
507
508                         /* number of records */
509                         c->innerclasscount = suck_u2(cb);
510
511                         if (!suck_check_classbuffer_size(cb, (2 + 2 + 2 + 2) * c->innerclasscount))
512                                 return false;
513
514                         /* allocate memory for innerclass structure */
515                         c->innerclass = MNEW(innerclassinfo, c->innerclasscount);
516
517                         for (j = 0; j < c->innerclasscount; j++) {
518                                 /* The innerclass structure contains a class with an encoded
519                                    name, its defining scope, its simple name and a bitmask of
520                                    the access flags. */
521                                                                 
522                                 info = c->innerclass + j;
523
524                                 inner.ref = (constant_classref*) innerclass_getconstant(c, suck_u2(cb), CONSTANT_Class);
525                                 outer.ref = (constant_classref*) innerclass_getconstant(c, suck_u2(cb), CONSTANT_Class);
526                                 name      = (utf*) innerclass_getconstant(c, suck_u2(cb), CONSTANT_Utf8);
527                                 flags     = suck_u2(cb);
528
529                                 /* If the current inner-class is the currently loaded
530                                    class check for some special flags. */
531
532                                 if (inner.ref->name == c->name) {
533                                         /* If an inner-class is not a member, its
534                                            outer-class is NULL. */
535
536                                         if (outer.ref != NULL) {
537                                                 c->flags |= ACC_CLASS_MEMBER;
538
539                                                 /* A member class doesn't have an
540                                                    EnclosingMethod attribute, so set the
541                                                    enclosing-class to be the same as the
542                                                    declaring-class. */
543
544                                                 c->declaringclass = outer;
545                                                 c->enclosingclass = outer;
546                                         }
547
548                                         /* If an inner-class is anonymous, its name is
549                                            NULL. */
550
551                                         if (name == NULL)
552                                                 c->flags |= ACC_CLASS_ANONYMOUS;
553                                 }
554
555                                 info->inner_class = inner;
556                                 info->outer_class = outer;
557                                 info->name        = name;
558                                 info->flags       = flags;
559                         }
560                 }
561                 else if (attribute_name == utf_SourceFile) {
562                         /* SourceFile */
563
564                         if (!class_load_attribute_sourcefile(cb))
565                                 return false;
566                 }
567 #if defined(ENABLE_JAVASE)
568                 else if (attribute_name == utf_EnclosingMethod) {
569                         /* EnclosingMethod */
570
571                         if (!class_load_attribute_enclosingmethod(cb))
572                                 return false;
573                 }
574                 else if (attribute_name == utf_Signature) {
575                         /* Signature */
576
577                         if (!loader_load_attribute_signature(cb, &(c->signature)))
578                                 return false;
579                 }
580 #endif
581
582 #if defined(ENABLE_ANNOTATIONS)
583                 else if (attribute_name == utf_RuntimeVisibleAnnotations) {
584                         /* RuntimeVisibleAnnotations */
585                         if (!annotation_load_class_attribute_runtimevisibleannotations(cb))
586                                 return false;
587                 }
588                 else if (attribute_name == utf_RuntimeInvisibleAnnotations) {
589                         /* RuntimeInvisibleAnnotations */
590                         if (!annotation_load_class_attribute_runtimeinvisibleannotations(cb))
591                                 return false;
592                 }
593 #endif
594
595                 else {
596                         /* unknown attribute */
597
598                         if (!loader_skip_attribute_body(cb))
599                                 return false;
600                 }
601         }
602
603         return true;
604 }
605
606
607 /* class_freepool **************************************************************
608
609         Frees all resources used by this classes Constant Pool.
610
611 *******************************************************************************/
612
613 static void class_freecpool(classinfo *c)
614 {
615         u4 idx;
616         u4 tag;
617         void* info;
618         
619         if (c->cptags && c->cpinfos) {
620                 for (idx = 0; idx < c->cpcount; idx++) {
621                         tag = c->cptags[idx];
622                         info = c->cpinfos[idx];
623                 
624                         if (info != NULL) {
625                                 switch (tag) {
626                                 case CONSTANT_Fieldref:
627                                 case CONSTANT_Methodref:
628                                 case CONSTANT_InterfaceMethodref:
629                                         FREE(info, constant_FMIref);
630                                         break;
631                                 case CONSTANT_Integer:
632                                         FREE(info, constant_integer);
633                                         break;
634                                 case CONSTANT_Float:
635                                         FREE(info, constant_float);
636                                         break;
637                                 case CONSTANT_Long:
638                                         FREE(info, constant_long);
639                                         break;
640                                 case CONSTANT_Double:
641                                         FREE(info, constant_double);
642                                         break;
643                                 case CONSTANT_NameAndType:
644                                         FREE(info, constant_nameandtype);
645                                         break;
646                                 }
647                         }
648                 }
649         }
650
651         if (c->cptags)
652                 MFREE(c->cptags, u1, c->cpcount);
653
654         if (c->cpinfos)
655                 MFREE(c->cpinfos, void*, c->cpcount);
656 }
657
658
659 /* class_getconstant ***********************************************************
660
661    Retrieves the value at position 'pos' of the constantpool of a
662    class. If the type of the value is other than 'ctype', an error is
663    thrown.
664
665 *******************************************************************************/
666
667 void* class_getconstant(classinfo *c, u4 pos, u4 ctype)
668 {
669         /* check index and type of constantpool entry */
670         /* (pos == 0 is caught by type comparison) */
671
672         if ((pos >= c->cpcount) || (c->cptags[pos] != ctype)) {
673                 exceptions_throw_classformaterror(c, "Illegal constant pool index");
674                 return NULL;
675         }
676
677         return c->cpinfos[pos];
678 }
679
680
681 /* innerclass_getconstant ******************************************************
682
683    Like class_getconstant, but if cptags is ZERO, null is returned.
684         
685 *******************************************************************************/
686
687 void* innerclass_getconstant(classinfo *c, u4 pos, u4 ctype)
688 {
689         /* invalid position in constantpool */
690
691         if (pos >= c->cpcount) {
692                 exceptions_throw_classformaterror(c, "Illegal constant pool index");
693                 return NULL;
694         }
695
696         /* constantpool entry of type 0 */      
697
698         if (c->cptags[pos] == 0)
699                 return NULL;
700
701         /* check type of constantpool entry */
702
703         if (c->cptags[pos] != ctype) {
704                 exceptions_throw_classformaterror(c, "Illegal constant pool index");
705                 return NULL;
706         }
707                 
708         return c->cpinfos[pos];
709 }
710
711
712 /* class_free ******************************************************************
713
714    Frees all resources used by the class.
715
716 *******************************************************************************/
717
718 void class_free(classinfo *c)
719 {
720         s4 i;
721         vftbl_t *v;
722
723         class_freecpool(c);
724
725         if (c->interfaces != NULL)
726                 MFREE(c->interfaces, classinfo*, c->interfacescount);
727
728         if (c->fields) {
729                 for (i = 0; i < c->fieldscount; i++)
730                         field_free(&(c->fields[i]));
731                 MFREE(c->fields, fieldinfo, c->fieldscount);
732         }
733         
734         if (c->methods) {
735                 for (i = 0; i < c->methodscount; i++)
736                         method_free(&(c->methods[i]));
737                 MFREE(c->methods, methodinfo, c->methodscount);
738         }
739
740         if ((v = c->vftbl) != NULL) {
741                 if (v->arraydesc)
742                         mem_free(v->arraydesc,sizeof(arraydescriptor));
743                 
744                 for (i = 0; i < v->interfacetablelength; i++) {
745                         MFREE(v->interfacetable[-i], methodptr, v->interfacevftbllength[i]);
746                 }
747                 MFREE(v->interfacevftbllength, s4, v->interfacetablelength);
748
749                 i = sizeof(vftbl_t) + sizeof(methodptr) * (v->vftbllength - 1) +
750                     sizeof(methodptr*) * (v->interfacetablelength -
751                                          (v->interfacetablelength > 0));
752                 v = (vftbl_t*) (((methodptr*) v) -
753                                                 (v->interfacetablelength - 1) * (v->interfacetablelength > 1));
754                 mem_free(v, i);
755         }
756
757         if (c->innerclass)
758                 MFREE(c->innerclass, innerclassinfo, c->innerclasscount);
759
760         /*      if (c->classvftbl)
761                 mem_free(c->header.vftbl, sizeof(vftbl) + sizeof(methodptr)*(c->vftbl->vftbllength-1)); */
762         
763 /*      GCFREE(c); */
764 }
765
766
767 /* get_array_class *************************************************************
768
769    Returns the array class with the given name for the given
770    classloader, or NULL if an exception occurred.
771
772    Note: This function does eager loading. 
773
774 *******************************************************************************/
775
776 static classinfo *get_array_class(utf *name,classloader_t *initloader,
777                                                                                         classloader_t *defloader,bool link)
778 {
779         classinfo *c;
780         
781         /* lookup this class in the classcache */
782         c = classcache_lookup(initloader,name);
783         if (!c)
784                 c = classcache_lookup_defined(defloader,name);
785
786         if (!c) {
787                 /* we have to create it */
788                 c = class_create_classinfo(name);
789                 c = load_newly_created_array(c,initloader);
790                 if (c == NULL)
791                         return NULL;
792         }
793
794         assert(c);
795         assert(c->state & CLASS_LOADED);
796         assert(c->classloader == defloader);
797
798         if (link && !(c->state & CLASS_LINKED))
799                 if (!link_class(c))
800                         return NULL;
801
802         assert(!link || (c->state & CLASS_LINKED));
803
804         return c;
805 }
806
807
808 /* class_array_of **************************************************************
809
810    Returns an array class with the given component class. The array
811    class is dynamically created if neccessary.
812
813 *******************************************************************************/
814
815 classinfo *class_array_of(classinfo *component, bool link)
816 {
817         classloader_t     *cl;
818     s4                 namelen;
819     char              *namebuf;
820         utf               *u;
821         classinfo         *c;
822
823         cl = component->classloader;
824
825     /* Assemble the array class name */
826     namelen = component->name->blength;
827     
828     if (component->name->text[0] == '[') {
829         /* the component is itself an array */
830         namebuf = MNEW(char, namelen + 1);
831         namebuf[0] = '[';
832         MCOPY(namebuf + 1, component->name->text, char, namelen);
833         namelen++;
834     }
835         else {
836         /* the component is a non-array class */
837         namebuf = MNEW(char, namelen + 3);
838         namebuf[0] = '[';
839         namebuf[1] = 'L';
840         MCOPY(namebuf + 2, component->name->text, char, namelen);
841         namebuf[2 + namelen] = ';';
842         namelen += 3;
843     }
844
845         u = utf_new(namebuf, namelen);
846
847         MFREE(namebuf, char, namelen);
848
849         c = get_array_class(u, cl, cl, link);
850
851         return c;
852 }
853
854
855 /* class_multiarray_of *********************************************************
856
857    Returns an array class with the given dimension and element class.
858    The array class is dynamically created if neccessary.
859
860 *******************************************************************************/
861
862 classinfo *class_multiarray_of(s4 dim, classinfo *element, bool link)
863 {
864     s4 namelen;
865     char *namebuf;
866         classinfo *c;
867
868         if (dim < 1) {
869                 log_text("Invalid array dimension requested");
870                 assert(0);
871         }
872
873     /* Assemble the array class name */
874     namelen = element->name->blength;
875     
876     if (element->name->text[0] == '[') {
877         /* the element is itself an array */
878         namebuf = MNEW(char, namelen + dim);
879         memcpy(namebuf + dim, element->name->text, namelen);
880         namelen += dim;
881     }
882     else {
883         /* the element is a non-array class */
884         namebuf = MNEW(char, namelen + 2 + dim);
885         namebuf[dim] = 'L';
886         memcpy(namebuf + dim + 1, element->name->text, namelen);
887         namelen += (2 + dim);
888         namebuf[namelen - 1] = ';';
889     }
890         memset(namebuf, '[', dim);
891
892         utf* u = utf_new(namebuf, namelen);
893
894         MFREE(namebuf, char, namelen);
895
896         c = get_array_class(u,
897                                                 element->classloader,
898                                                 element->classloader,
899                                                 link);
900
901         return c;
902 }
903
904
905 /* class_lookup_classref *******************************************************
906
907    Looks up the constant_classref for a given classname in the classref
908    tables of a class.
909
910    IN:
911        cls..............the class containing the reference
912            name.............the name of the class refered to
913
914     RETURN VALUE:
915            a pointer to a constant_classref, or 
916            NULL if the reference was not found
917    
918 *******************************************************************************/
919
920 constant_classref *class_lookup_classref(classinfo *cls, utf *name)
921 {
922         constant_classref *ref;
923         extra_classref *xref;
924         int count;
925
926         assert(cls);
927         assert(name);
928         assert(!cls->classrefcount || cls->classrefs);
929         
930         /* first search the main classref table */
931         count = cls->classrefcount;
932         ref = cls->classrefs;
933         for (; count; --count, ++ref)
934                 if (ref->name == name)
935                         return ref;
936
937         /* next try the list of extra classrefs */
938         for (xref = cls->extclassrefs; xref; xref = xref->next) {
939                 if (xref->classref.name == name)
940                         return &(xref->classref);
941         }
942
943         /* not found */
944         return NULL;
945 }
946
947
948 /* class_get_classref **********************************************************
949
950    Returns the constant_classref for a given classname.
951
952    IN:
953        cls..............the class containing the reference
954            name.............the name of the class refered to
955
956    RETURN VALUE:
957        a pointer to a constant_classref (never NULL)
958
959    NOTE:
960        The given name is not checked for validity!
961    
962 *******************************************************************************/
963
964 constant_classref *class_get_classref(classinfo *cls, utf *name)
965 {
966         constant_classref *ref;
967         extra_classref *xref;
968
969         assert(cls);
970         assert(name);
971
972         ref = class_lookup_classref(cls,name);
973         if (ref)
974                 return ref;
975
976         xref = NEW(extra_classref);
977         CLASSREF_INIT(xref->classref,cls,name);
978
979         xref->next = cls->extclassrefs;
980         cls->extclassrefs = xref;
981
982         return &(xref->classref);
983 }
984
985
986 /* class_get_self_classref *****************************************************
987
988    Returns the constant_classref to the class itself.
989
990    IN:
991        cls..............the class containing the reference
992
993    RETURN VALUE:
994        a pointer to a constant_classref (never NULL)
995
996 *******************************************************************************/
997
998 constant_classref *class_get_self_classref(classinfo *cls)
999 {
1000         /* XXX this should be done in a faster way. Maybe always make */
1001         /* the classref of index 0 a self reference.                  */
1002         return class_get_classref(cls,cls->name);
1003 }
1004
1005 /* class_get_classref_multiarray_of ********************************************
1006
1007    Returns an array type reference with the given dimension and element class
1008    reference.
1009
1010    IN:
1011        dim..............the requested dimension
1012                             dim must be in [1;255]. This is NOT checked!
1013            ref..............the component class reference
1014
1015    RETURN VALUE:
1016        a pointer to the class reference for the array type
1017
1018    NOTE:
1019        The referer of `ref` is used as the referer for the new classref.
1020
1021 *******************************************************************************/
1022
1023 constant_classref *class_get_classref_multiarray_of(s4 dim, constant_classref *ref)
1024 {
1025     s4 namelen;
1026     char *namebuf;
1027         constant_classref *cr;
1028
1029         assert(ref);
1030         assert(dim >= 1 && dim <= 255);
1031
1032     /* Assemble the array class name */
1033     namelen = ref->name->blength;
1034     
1035     if (ref->name->text[0] == '[') {
1036         /* the element is itself an array */
1037         namebuf = MNEW(char, namelen + dim);
1038         memcpy(namebuf + dim, ref->name->text, namelen);
1039         namelen += dim;
1040     }
1041     else {
1042         /* the element is a non-array class */
1043         namebuf = MNEW(char, namelen + 2 + dim);
1044         namebuf[dim] = 'L';
1045         memcpy(namebuf + dim + 1, ref->name->text, namelen);
1046         namelen += (2 + dim);
1047         namebuf[namelen - 1] = ';';
1048     }
1049         memset(namebuf, '[', dim);
1050
1051         utf* u = utf_new(namebuf, namelen);
1052
1053         MFREE(namebuf, char, namelen);
1054
1055     cr = class_get_classref(ref->referer, u);
1056
1057         return cr;
1058 }
1059
1060
1061 /* class_get_classref_component_of *********************************************
1062
1063    Returns the component classref of a given array type reference
1064
1065    IN:
1066        ref..............the array type reference
1067
1068    RETURN VALUE:
1069        a reference to the component class, or
1070            NULL if `ref` is not an object array type reference
1071
1072    NOTE:
1073        The referer of `ref` is used as the referer for the new classref.
1074
1075 *******************************************************************************/
1076
1077 constant_classref *class_get_classref_component_of(constant_classref *ref)
1078 {
1079         s4 namelen;
1080         char *name;
1081         
1082         assert(ref);
1083
1084         name = ref->name->text;
1085         if (*name++ != '[')
1086                 return NULL;
1087         
1088         namelen = ref->name->blength - 1;
1089         if (*name == 'L') {
1090                 name++;
1091                 namelen -= 2;
1092         }
1093         else if (*name != '[') {
1094                 return NULL;
1095         }
1096
1097     return class_get_classref(ref->referer, utf_new(name, namelen));
1098 }
1099
1100
1101 /* class_findmethod ************************************************************
1102         
1103    Searches a 'classinfo' structure for a method having the given name
1104    and descriptor. If descriptor is NULL, it is ignored.
1105
1106 *******************************************************************************/
1107
1108 methodinfo *class_findmethod(classinfo *c, utf *name, utf *desc)
1109 {
1110         methodinfo *m;
1111         s4          i;
1112
1113         for (i = 0; i < c->methodscount; i++) {
1114                 m = &(c->methods[i]);
1115
1116                 if ((m->name == name) && ((desc == NULL) || (m->descriptor == desc)))
1117                         return m;
1118         }
1119
1120         return NULL;
1121 }
1122
1123
1124 /* class_resolvemethod *********************************************************
1125         
1126    Searches a class and it's super classes for a method.
1127
1128    Superinterfaces are *not* searched.
1129
1130 *******************************************************************************/
1131
1132 methodinfo *class_resolvemethod(classinfo *c, utf *name, utf *desc)
1133 {
1134         methodinfo *m;
1135
1136         while (c) {
1137                 m = class_findmethod(c, name, desc);
1138
1139                 if (m)
1140                         return m;
1141
1142                 /* JVM Specification bug: 
1143
1144                    It is important NOT to resolve special <init> and <clinit>
1145                    methods to super classes or interfaces; yet, this is not
1146                    explicited in the specification.  Section 5.4.3.3 should be
1147                    updated appropriately.  */
1148
1149                 if (name == utf_init || name == utf_clinit)
1150                         return NULL;
1151
1152                 c = c->super;
1153         }
1154
1155         return NULL;
1156 }
1157
1158
1159 /* class_resolveinterfacemethod_intern *****************************************
1160
1161    Internally used helper function. Do not use this directly.
1162
1163 *******************************************************************************/
1164
1165 static methodinfo *class_resolveinterfacemethod_intern(classinfo *c,
1166                                                                                                            utf *name, utf *desc)
1167 {
1168         methodinfo *m;
1169         s4          i;
1170
1171         /* try to find the method in the class */
1172
1173         m = class_findmethod(c, name, desc);
1174
1175         if (m != NULL)
1176                 return m;
1177
1178         /* No method found?  Try the super interfaces. */
1179
1180         for (i = 0; i < c->interfacescount; i++) {
1181                 m = class_resolveinterfacemethod_intern(c->interfaces[i], name, desc);
1182
1183                 if (m != NULL)
1184                         return m;
1185         }
1186
1187         /* no method found */
1188
1189         return NULL;
1190 }
1191
1192
1193 /* class_resolveclassmethod ****************************************************
1194         
1195    Resolves a reference from REFERER to a method with NAME and DESC in
1196    class C.
1197
1198    If the method cannot be resolved the return value is NULL. If
1199    EXCEPT is true *exceptionptr is set, too.
1200
1201 *******************************************************************************/
1202
1203 methodinfo *class_resolveclassmethod(classinfo *c, utf *name, utf *desc,
1204                                                                          classinfo *referer, bool throwexception)
1205 {
1206         classinfo  *cls;
1207         methodinfo *m;
1208         s4          i;
1209
1210 /*      if (c->flags & ACC_INTERFACE) { */
1211 /*              if (throwexception) */
1212 /*                      *exceptionptr = */
1213 /*                              new_exception(string_java_lang_IncompatibleClassChangeError); */
1214 /*              return NULL; */
1215 /*      } */
1216
1217         /* try class c and its superclasses */
1218
1219         cls = c;
1220
1221         m = class_resolvemethod(cls, name, desc);
1222
1223         if (m != NULL)
1224                 goto found;
1225
1226         /* Try the super interfaces. */
1227
1228         for (i = 0; i < c->interfacescount; i++) {
1229                 m = class_resolveinterfacemethod_intern(c->interfaces[i], name, desc);
1230
1231                 if (m != NULL)
1232                         goto found;
1233         }
1234         
1235         if (throwexception)
1236                 exceptions_throw_nosuchmethoderror(c, name, desc);
1237
1238         return NULL;
1239
1240  found:
1241         if ((m->flags & ACC_ABSTRACT) && !(c->flags & ACC_ABSTRACT)) {
1242                 if (throwexception)
1243                         exceptions_throw_abstractmethoderror();
1244
1245                 return NULL;
1246         }
1247
1248         /* XXX check access rights */
1249
1250         return m;
1251 }
1252
1253
1254 /* class_resolveinterfacemethod ************************************************
1255
1256    Resolves a reference from REFERER to a method with NAME and DESC in
1257    interface C.
1258
1259    If the method cannot be resolved the return value is NULL. If
1260    EXCEPT is true *exceptionptr is set, too.
1261
1262 *******************************************************************************/
1263
1264 methodinfo *class_resolveinterfacemethod(classinfo *c, utf *name, utf *desc,
1265                                                                                  classinfo *referer, bool throwexception)
1266 {
1267         methodinfo *mi;
1268
1269         if (!(c->flags & ACC_INTERFACE)) {
1270                 if (throwexception)
1271                         exceptions_throw_incompatibleclasschangeerror(c, "Not an interface");
1272
1273                 return NULL;
1274         }
1275
1276         mi = class_resolveinterfacemethod_intern(c, name, desc);
1277
1278         if (mi != NULL)
1279                 return mi;
1280
1281         /* try class java.lang.Object */
1282
1283         mi = class_findmethod(class_java_lang_Object, name, desc);
1284
1285         if (mi != NULL)
1286                 return mi;
1287
1288         if (throwexception)
1289                 exceptions_throw_nosuchmethoderror(c, name, desc);
1290
1291         return NULL;
1292 }
1293
1294
1295 /* class_findfield *************************************************************
1296         
1297    Searches for field with specified name and type in a classinfo
1298    structure. If no such field is found NULL is returned.
1299
1300 *******************************************************************************/
1301
1302 fieldinfo *class_findfield(classinfo *c, utf *name, utf *desc)
1303 {
1304         s4 i;
1305
1306         for (i = 0; i < c->fieldscount; i++)
1307                 if ((c->fields[i].name == name) && (c->fields[i].descriptor == desc))
1308                         return &(c->fields[i]);
1309
1310         if (c->super != NULL)
1311                 return class_findfield(c->super, name, desc);
1312
1313         return NULL;
1314 }
1315
1316
1317 /* class_findfield_approx ******************************************************
1318         
1319    Searches in 'classinfo'-structure for a field with the specified
1320    name.
1321
1322 *******************************************************************************/
1323  
1324 fieldinfo *class_findfield_by_name(classinfo* c, utf* name)
1325 {
1326         for (int32_t i = 0; i < c->fieldscount; i++) {
1327                 fieldinfo* f = &(c->fields[i]);
1328
1329                 if (f->name == name)
1330                         return f;
1331         }
1332
1333         // Field not found.
1334         exceptions_throw_nosuchfielderror(c, name);
1335         return NULL;
1336 }
1337
1338
1339 /****************** Function: class_resolvefield_int ***************************
1340
1341     This is an internally used helper function. Do not use this directly.
1342
1343         Tries to resolve a field having the given name and type.
1344     If the field cannot be resolved, NULL is returned.
1345
1346 *******************************************************************************/
1347
1348 static fieldinfo *class_resolvefield_int(classinfo *c, utf *name, utf *desc)
1349 {
1350         fieldinfo *fi;
1351         s4         i;
1352
1353         /* search for field in class c */
1354
1355         for (i = 0; i < c->fieldscount; i++) { 
1356                 if ((c->fields[i].name == name) && (c->fields[i].descriptor == desc)) {
1357                         return &(c->fields[i]);
1358                 }
1359     }
1360
1361         /* Try super interfaces recursively. */
1362
1363         for (i = 0; i < c->interfacescount; i++) {
1364                 fi = class_resolvefield_int(c->interfaces[i], name, desc);
1365
1366                 if (fi != NULL)
1367                         return fi;
1368         }
1369
1370         /* Try super class. */
1371
1372         if (c->super != NULL)
1373                 return class_resolvefield_int(c->super, name, desc);
1374
1375         /* not found */
1376
1377         return NULL;
1378 }
1379
1380
1381 /********************* Function: class_resolvefield ***************************
1382         
1383         Resolves a reference from REFERER to a field with NAME and DESC in class C.
1384
1385     If the field cannot be resolved, an exception is thrown and the
1386     return value is NULL.
1387
1388 *******************************************************************************/
1389
1390 fieldinfo *class_resolvefield(classinfo *c, utf *name, utf *desc, classinfo *referer)
1391 {
1392         fieldinfo *fi;
1393
1394         fi = class_resolvefield_int(c, name, desc);
1395
1396         if (!fi) {
1397                 exceptions_throw_nosuchfielderror(c, name);
1398                 return NULL;
1399         }
1400
1401         /* XXX check access rights */
1402
1403         return fi;
1404 }
1405
1406
1407 /* class_issubclass ************************************************************
1408
1409    Checks if sub is a descendant of super.
1410         
1411 *******************************************************************************/
1412
1413 bool class_issubclass(classinfo *sub, classinfo *super)
1414 {
1415         classinfo *c;
1416
1417         c = sub;
1418
1419         for (;;) {
1420                 /* We reached java/lang/Object and did not find the requested
1421                    super class. */
1422
1423                 if (c == NULL)
1424                         return false;
1425
1426                 /* We found the requested super class. */
1427
1428                 if (c == super)
1429                         return true;
1430
1431                 c = c->super;
1432         }
1433 }
1434
1435
1436 /* class_isanysubclass *********************************************************
1437
1438    Checks a subclass relation between two classes. Implemented
1439    interfaces are interpreted as super classes.
1440
1441    Return value: 1 ... sub is subclass of super
1442                  0 ... otherwise
1443
1444 *******************************************************************************/
1445
1446 bool class_isanysubclass(classinfo *sub, classinfo *super)
1447 {
1448         uint32_t diffval;
1449         bool     result;
1450
1451         /* This is the trivial case. */
1452
1453         if (sub == super)
1454                 return true;
1455
1456         /* Primitive classes are only subclasses of themselves. */
1457
1458         if (class_is_primitive(sub) || class_is_primitive(super))
1459                 return false;
1460
1461         /* Check for interfaces. */
1462
1463         if (super->flags & ACC_INTERFACE) {
1464                 result = (sub->vftbl->interfacetablelength > super->index) &&
1465                         (sub->vftbl->interfacetable[-super->index] != NULL);
1466         }
1467         else {
1468                 /* java.lang.Object is the only super class of any
1469                    interface. */
1470
1471                 if (sub->flags & ACC_INTERFACE)
1472                         return (super == class_java_lang_Object);
1473
1474 #if USES_NEW_SUBTYPE
1475                 result = fast_subtype_check(sub->vftbl, super->vftbl);
1476 #else
1477                 LOCK_CLASSRENUMBER_LOCK;
1478
1479                 diffval = sub->vftbl->baseval - super->vftbl->baseval;
1480                 result  = diffval <= (uint32_t) super->vftbl->diffval;
1481
1482                 UNLOCK_CLASSRENUMBER_LOCK;
1483 #endif
1484         }
1485
1486         return result;
1487 }
1488
1489
1490 /* class_is_assignable_from ****************************************************
1491
1492    Return whether an instance of the "from" class parameter would be
1493    an instance of this class "to" as well.
1494
1495    ARGUMENTS:
1496        to ..... class
1497            from ... class
1498
1499    RETURN:
1500        true .... is assignable
1501            false ... is not assignable
1502
1503 *******************************************************************************/
1504
1505 bool class_is_assignable_from(classinfo *to, classinfo *from)
1506 {
1507         if (!(to->state & CLASS_LINKED))
1508                 if (!link_class(to))
1509                         return false;
1510
1511         if (!(from->state & CLASS_LINKED))
1512                 if (!link_class(from))
1513                         return false;
1514
1515         return class_isanysubclass(from, to);
1516 }
1517
1518
1519 /* class_is_instance ***********************************************************
1520
1521    Return if the given Java object is an instance of the given class.
1522
1523    ARGUMENTS:
1524        c ... class
1525            h ... Java object
1526
1527    RETURN:
1528        true .... is instance
1529            false ... is not instance
1530
1531 *******************************************************************************/
1532
1533 bool class_is_instance(classinfo *c, java_handle_t *h)
1534 {
1535         if (!(c->state & CLASS_LINKED))
1536                 if (!link_class(c))
1537                         return false;
1538
1539         return builtin_instanceof(h, c);
1540 }
1541
1542
1543 /* class_get_componenttype *****************************************************
1544
1545    Return the component class of the given class.  If the given class
1546    is not an array, return NULL.
1547
1548 *******************************************************************************/
1549
1550 classinfo *class_get_componenttype(classinfo *c)
1551 {
1552         classinfo       *component;
1553         arraydescriptor *ad;
1554         
1555         /* XXX maybe we could find a way to do this without linking. */
1556         /* This way should be safe and easy, however.                */
1557
1558         if (!(c->state & CLASS_LINKED))
1559                 if (!link_class(c))
1560                         return NULL;
1561
1562         ad = c->vftbl->arraydesc;
1563         
1564         if (ad == NULL)
1565                 return NULL;
1566         
1567         if (ad->arraytype == ARRAYTYPE_OBJECT)
1568                 component = ad->componentvftbl->clazz;
1569         else
1570                 component = Primitive::get_class_by_type(ad->arraytype);
1571                 
1572         return component;
1573 }
1574
1575
1576 /* class_get_declaredclasses ***************************************************
1577
1578    Return an array of declared classes of the given class.
1579
1580 *******************************************************************************/
1581
1582 java_handle_objectarray_t *class_get_declaredclasses(classinfo *c, bool publicOnly)
1583 {
1584         classref_or_classinfo  inner;
1585         classref_or_classinfo  outer;
1586         utf                   *outername;
1587         int                    declaredclasscount;  /* number of declared classes */
1588         int                    pos;                     /* current declared class */
1589         java_handle_objectarray_t *oa;               /* array of declared classes */
1590         int                    i;
1591         classinfo             *ic;
1592
1593         declaredclasscount = 0;
1594
1595         if (!class_is_primitive(c) && !class_is_array(c)) {
1596                 /* Determine number of declared classes. */
1597
1598                 for (i = 0; i < c->innerclasscount; i++) {
1599                         /* Get outer-class.  If the inner-class is not a member
1600                            class, the outer-class is NULL. */
1601
1602                         outer = c->innerclass[i].outer_class;
1603
1604                         if (outer.any == NULL)
1605                                 continue;
1606
1607                         /* Check if outer-class is a classref or a real class and
1608                get the class name from the structure. */
1609
1610                         outername = IS_CLASSREF(outer) ? outer.ref->name : outer.cls->name;
1611
1612                         /* Outer class is this class. */
1613
1614                         if ((outername == c->name) &&
1615                                 ((publicOnly == 0) || (c->innerclass[i].flags & ACC_PUBLIC)))
1616                                 declaredclasscount++;
1617                 }
1618         }
1619
1620         /* Allocate Class[] and check for OOM. */
1621
1622         oa = builtin_anewarray(declaredclasscount, class_java_lang_Class);
1623
1624         if (oa == NULL)
1625                 return NULL;
1626
1627         for (i = 0, pos = 0; i < c->innerclasscount; i++) {
1628                 inner = c->innerclass[i].inner_class;
1629                 outer = c->innerclass[i].outer_class;
1630
1631                 /* Get outer-class.  If the inner-class is not a member class,
1632                    the outer-class is NULL. */
1633
1634                 if (outer.any == NULL)
1635                         continue;
1636
1637                 /* Check if outer_class is a classref or a real class and get
1638                    the class name from the structure. */
1639
1640                 outername = IS_CLASSREF(outer) ? outer.ref->name : outer.cls->name;
1641
1642                 /* Outer class is this class. */
1643
1644                 if ((outername == c->name) &&
1645                         ((publicOnly == 0) || (c->innerclass[i].flags & ACC_PUBLIC))) {
1646
1647                         ic = resolve_classref_or_classinfo_eager(inner, false);
1648
1649                         if (ic == NULL)
1650                                 return NULL;
1651
1652                         if (!(ic->state & CLASS_LINKED))
1653                                 if (!link_class(ic))
1654                                         return NULL;
1655
1656                         LLNI_array_direct(oa, pos++) = (java_object_t *) ic;
1657                 }
1658         }
1659
1660         return oa;
1661 }
1662
1663
1664 /**
1665  * Return an array of declared constructors of the given class.
1666  *
1667  * @param c          class to get the constructors of
1668  * @param publicOnly show only public fields
1669  *
1670  * @return array of java.lang.reflect.Constructor
1671  */
1672 #if defined(ENABLE_JAVASE)
1673 java_handle_objectarray_t *class_get_declaredconstructors(classinfo *c, bool publicOnly)
1674 {
1675         methodinfo*                m;
1676         java_handle_objectarray_t* oa;
1677         int                        count;
1678         int                        index;
1679         int                        i;
1680
1681         /* Determine number of constructors. */
1682
1683         count = 0;
1684
1685         for (i = 0; i < c->methodscount; i++) {
1686                 m = &(c->methods[i]);
1687
1688                 if (((m->flags & ACC_PUBLIC) || (publicOnly == 0)) &&
1689                         (m->name == utf_init))
1690                         count++;
1691         }
1692
1693         /* Create array of constructors. */
1694
1695         oa = builtin_anewarray(count, class_java_lang_reflect_Constructor);
1696
1697         if (oa == NULL)
1698                 return NULL;
1699
1700         /* Get the constructors and store them in the array. */
1701
1702         for (i = 0, index = 0; i < c->methodscount; i++) {
1703                 m = &(c->methods[i]);
1704
1705                 if (((m->flags & ACC_PUBLIC) || (publicOnly == 0)) &&
1706                         (m->name == utf_init)) {
1707                         // Create a java.lang.reflect.Constructor object.
1708
1709                         java_lang_reflect_Constructor rc(m);
1710
1711                         /* Store object into array. */
1712
1713                         array_objectarray_element_set(oa, index, rc.get_handle());
1714                         index++;
1715                 }
1716         }
1717
1718         return oa;
1719 }
1720 #endif
1721
1722
1723 /* class_get_declaredfields ****************************************************
1724
1725    Return an array of declared fields of the given class.
1726
1727    ARGUMENTS:
1728        c ............ class to get the fields of
1729            publicOnly ... show only public fields
1730
1731    RETURN:
1732        array of java.lang.reflect.Field
1733
1734 *******************************************************************************/
1735
1736 #if defined(ENABLE_JAVASE)
1737 java_handle_objectarray_t *class_get_declaredfields(classinfo *c, bool publicOnly)
1738 {
1739         java_handle_objectarray_t *oa;
1740         fieldinfo                 *f;
1741         int                        count;
1742         int                        index;
1743         int                        i;
1744
1745         /* Determine number of fields. */
1746
1747         count = 0;
1748
1749         for (i = 0; i < c->fieldscount; i++)
1750                 if ((c->fields[i].flags & ACC_PUBLIC) || (publicOnly == 0))
1751                         count++;
1752
1753         /* Create array of fields. */
1754
1755         oa = builtin_anewarray(count, class_java_lang_reflect_Field);
1756
1757         if (oa == NULL)
1758                 return NULL;
1759
1760         /* Get the fields and store them in the array. */
1761
1762         for (i = 0, index = 0; i < c->fieldscount; i++) {
1763                 f = &(c->fields[i]);
1764
1765                 if ((f->flags & ACC_PUBLIC) || (publicOnly == 0)) {
1766                         // Create a java.lang.reflect.Field object.
1767
1768                         java_lang_reflect_Field rf(f);
1769
1770                         /* Store object into array. */
1771
1772                         array_objectarray_element_set(oa, index, rf.get_handle());
1773                         index++;
1774                 }
1775         }
1776
1777         return oa;
1778 }
1779 #endif
1780
1781
1782 /* class_get_declaredmethods ***************************************************
1783
1784    Return an array of declared methods of the given class.
1785
1786    ARGUMENTS:
1787        c ............ class to get the methods of
1788            publicOnly ... show only public methods
1789
1790    RETURN:
1791        array of java.lang.reflect.Method
1792
1793 *******************************************************************************/
1794
1795 #if defined(ENABLE_JAVASE)
1796 java_handle_objectarray_t *class_get_declaredmethods(classinfo *c, bool publicOnly)
1797 {
1798         java_handle_objectarray_t *oa;         /* result: array of Method-objects */
1799         methodinfo                *m;     /* the current method to be represented */
1800         int                        count;
1801         int                        index;
1802         int                        i;
1803
1804         /* JOWENN: array classes do not declare methods according to mauve
1805            test.  It should be considered, if we should return to my old
1806            clone method overriding instead of declaring it as a member
1807            function. */
1808
1809         if (class_is_array(c))
1810                 return builtin_anewarray(0, class_java_lang_reflect_Method);
1811
1812         /* Determine number of methods. */
1813
1814         count = 0;
1815
1816         for (i = 0; i < c->methodscount; i++) {
1817                 m = &(c->methods[i]);
1818
1819                 if (((m->flags & ACC_PUBLIC) || (publicOnly == false)) &&
1820                         ((m->name != utf_init) && (m->name != utf_clinit)) &&
1821                         !(m->flags & ACC_MIRANDA))
1822                         count++;
1823         }
1824
1825         /* Create array of methods. */
1826
1827         oa = builtin_anewarray(count, class_java_lang_reflect_Method);
1828
1829         if (oa == NULL)
1830                 return NULL;
1831
1832         /* Get the methods and store them in the array. */
1833
1834         for (i = 0, index = 0; i < c->methodscount; i++) {
1835                 m = &(c->methods[i]);
1836
1837                 if (((m->flags & ACC_PUBLIC) || (publicOnly == false)) && 
1838                         ((m->name != utf_init) && (m->name != utf_clinit)) &&
1839                         !(m->flags & ACC_MIRANDA)) {
1840                         // Create java.lang.reflect.Method object.
1841
1842                         java_lang_reflect_Method rm(m);
1843
1844                         /* Store object into array. */
1845
1846                         array_objectarray_element_set(oa, index, rm.get_handle());
1847                         index++;
1848                 }
1849         }
1850
1851         return oa;
1852 }
1853 #endif
1854
1855
1856 /* class_get_declaringclass ****************************************************
1857
1858    If the class or interface given is a member of another class,
1859    return the declaring class.  For array and primitive classes return
1860    NULL.
1861
1862 *******************************************************************************/
1863
1864 classinfo *class_get_declaringclass(classinfo *c)
1865 {
1866         classref_or_classinfo  cr;
1867         classinfo             *dc;
1868
1869         /* Get declaring class. */
1870
1871         cr = c->declaringclass;
1872
1873         if (cr.any == NULL)
1874                 return NULL;
1875
1876         /* Resolve the class if necessary. */
1877
1878         if (IS_CLASSREF(cr)) {
1879 /*              dc = resolve_classref_eager(cr.ref); */
1880                 dc = resolve_classref_or_classinfo_eager(cr, true);
1881
1882                 if (dc == NULL)
1883                         return NULL;
1884
1885                 /* Store the resolved class in the class structure. */
1886
1887                 cr.cls = dc;
1888         }
1889
1890         dc = cr.cls;
1891
1892         return dc;
1893 }
1894
1895
1896 /* class_get_enclosingclass ****************************************************
1897
1898    Return the enclosing class for the given class.
1899
1900 *******************************************************************************/
1901
1902 classinfo *class_get_enclosingclass(classinfo *c)
1903 {
1904         classref_or_classinfo  cr;
1905         classinfo             *ec;
1906
1907         /* Get enclosing class. */
1908
1909         cr = c->enclosingclass;
1910
1911         if (cr.any == NULL)
1912                 return NULL;
1913
1914         /* Resolve the class if necessary. */
1915
1916         if (IS_CLASSREF(cr)) {
1917 /*              ec = resolve_classref_eager(cr.ref); */
1918                 ec = resolve_classref_or_classinfo_eager(cr, true);
1919
1920                 if (ec == NULL)
1921                         return NULL;
1922
1923                 /* Store the resolved class in the class structure. */
1924
1925                 cr.cls = ec;
1926         }
1927
1928         ec = cr.cls;
1929
1930         return ec;
1931 }
1932
1933
1934 /**
1935  * Return the enclosing constructor as java.lang.reflect.Constructor
1936  * object for the given class.
1937  *
1938  * @param c class to return the enclosing constructor for
1939  *
1940  * @return java.lang.reflect.Constructor object of the enclosing
1941  * constructor
1942  */
1943 #if defined(ENABLE_JAVASE)
1944 java_handle_t* class_get_enclosingconstructor(classinfo *c)
1945 {
1946         methodinfo*    m;
1947
1948         m = class_get_enclosingmethod_raw(c);
1949
1950         if (m == NULL)
1951                 return NULL;
1952
1953         /* Check for <init>. */
1954
1955         if (m->name != utf_init)
1956                 return NULL;
1957
1958         // Create a java.lang.reflect.Constructor object.
1959
1960         java_lang_reflect_Constructor rc(m);
1961
1962         return rc.get_handle();
1963 }
1964 #endif
1965
1966
1967 /* class_get_enclosingmethod ***************************************************
1968
1969    Return the enclosing method for the given class.
1970
1971    IN:
1972        c ... class to return the enclosing method for
1973
1974    RETURN:
1975        methodinfo of the enclosing method
1976
1977 *******************************************************************************/
1978
1979 methodinfo *class_get_enclosingmethod_raw(classinfo *c)
1980 {
1981         constant_nameandtype *cn;
1982         classinfo            *ec;
1983         methodinfo           *m;
1984
1985         /* get enclosing class and method */
1986
1987         ec = class_get_enclosingclass(c);
1988         cn = c->enclosingmethod;
1989
1990         /* check for enclosing class and method */
1991
1992         if (ec == NULL)
1993                 return NULL;
1994
1995         if (cn == NULL)
1996                 return NULL;
1997
1998         /* find method in enclosing class */
1999
2000         m = class_findmethod(ec, cn->name, cn->descriptor);
2001
2002         if (m == NULL) {
2003                 exceptions_throw_internalerror("Enclosing method doesn't exist");
2004                 return NULL;
2005         }
2006
2007         return m;
2008 }
2009
2010
2011 /**
2012  * Return the enclosing method as java.lang.reflect.Method object for
2013  * the given class.
2014  *
2015  * @param c class to return the enclosing method for
2016  *
2017  * @return java.lang.reflect.Method object of the enclosing method
2018  */
2019 #if defined(ENABLE_JAVASE)
2020 java_handle_t* class_get_enclosingmethod(classinfo *c)
2021 {
2022         methodinfo*    m;
2023
2024         m = class_get_enclosingmethod_raw(c);
2025
2026         if (m == NULL)
2027                 return NULL;
2028
2029         /* check for <init> */
2030
2031         if (m->name == utf_init)
2032                 return NULL;
2033
2034         // Create a java.lang.reflect.Method object.
2035
2036         java_lang_reflect_Method rm(m);
2037
2038         return rm.get_handle();
2039 }
2040 #endif
2041
2042
2043 /* class_get_interfaces ********************************************************
2044
2045    Return an array of interfaces of the given class.
2046
2047 *******************************************************************************/
2048
2049 java_handle_objectarray_t *class_get_interfaces(classinfo *c)
2050 {
2051         classinfo                 *ic;
2052         java_handle_objectarray_t *oa;
2053         u4                         i;
2054
2055         if (!(c->state & CLASS_LINKED))
2056                 if (!link_class(c))
2057                         return NULL;
2058
2059         oa = builtin_anewarray(c->interfacescount, class_java_lang_Class);
2060
2061         if (oa == NULL)
2062                 return NULL;
2063
2064         for (i = 0; i < c->interfacescount; i++) {
2065                 ic = c->interfaces[i];
2066
2067                 LLNI_array_direct(oa, i) = (java_object_t *) ic;
2068         }
2069
2070         return oa;
2071 }
2072
2073
2074 /* class_get_annotations *******************************************************
2075
2076    Get the unparsed declared annotations in a byte array
2077    of the given class.
2078
2079    IN:
2080        c........the class of which the annotations should be returned
2081
2082    RETURN VALUE:
2083        The unparsed declared annotations in a byte array
2084        (or NULL if there aren't any).
2085
2086 *******************************************************************************/
2087
2088 java_handle_bytearray_t *class_get_annotations(classinfo *c)
2089 {
2090 #if defined(ENABLE_ANNOTATIONS)
2091         java_handle_t *annotations; /* unparsed annotations */
2092
2093         LLNI_classinfo_field_get(c, annotations, annotations);
2094
2095         return (java_handle_bytearray_t*)annotations;
2096 #else
2097         return NULL;
2098 #endif
2099 }
2100
2101
2102 /* class_get_modifiers *********************************************************
2103
2104    Get the modifier flags of the given class.
2105
2106    IN:
2107        c....the class of which the modifier flags should be returned
2108            ignoreInnerClassesAttrib
2109    RETURN VALUE:
2110        modifier flags
2111
2112 *******************************************************************************/
2113
2114 int32_t class_get_modifiers(classinfo *c, bool ignoreInnerClassesAttrib)
2115 {
2116         classref_or_classinfo  inner;
2117         classref_or_classinfo  outer;
2118         utf                   *innername;
2119         int                    i;
2120
2121         if (!ignoreInnerClassesAttrib && (c->innerclasscount != 0)) {
2122                 /* search for passed class as inner class */
2123
2124                 for (i = 0; i < c->innerclasscount; i++) {
2125                         inner = c->innerclass[i].inner_class;
2126                         outer = c->innerclass[i].outer_class;
2127
2128                         /* Check if inner is a classref or a real class and get
2129                the name of the structure */
2130
2131                         innername = IS_CLASSREF(inner) ? inner.ref->name : inner.cls->name;
2132
2133                         /* innerclass is this class */
2134
2135                         if (innername == c->name) {
2136                                 /* has the class actually an outer class? */
2137
2138                                 if (outer.any)
2139                                         /* return flags got from the outer class file */
2140                                         return c->innerclass[i].flags & ACC_CLASS_REFLECT_MASK;
2141                                 else
2142                                         return c->flags & ACC_CLASS_REFLECT_MASK;
2143                         }
2144                 }
2145         }
2146
2147         /* passed class is no inner class or it was not requested */
2148
2149         return c->flags & ACC_CLASS_REFLECT_MASK;
2150 }
2151
2152
2153 /* class_get_signature *********************************************************
2154
2155    Return the signature of the given class.  For array and primitive
2156    classes return NULL.
2157
2158 *******************************************************************************/
2159
2160 #if defined(ENABLE_JAVASE)
2161 utf *class_get_signature(classinfo *c)
2162 {
2163         /* For array and primitive classes return NULL. */
2164
2165         if (class_is_array(c) || class_is_primitive(c))
2166                 return NULL;
2167
2168         return c->signature;
2169 }
2170 #endif
2171
2172
2173 /* class_printflags ************************************************************
2174
2175    Prints flags of a class.
2176
2177 *******************************************************************************/
2178
2179 #if !defined(NDEBUG)
2180 void class_printflags(classinfo *c)
2181 {
2182         if (c == NULL) {
2183                 printf("NULL");
2184                 return;
2185         }
2186
2187         if (c->flags & ACC_PUBLIC)       printf(" PUBLIC");
2188         if (c->flags & ACC_PRIVATE)      printf(" PRIVATE");
2189         if (c->flags & ACC_PROTECTED)    printf(" PROTECTED");
2190         if (c->flags & ACC_STATIC)       printf(" STATIC");
2191         if (c->flags & ACC_FINAL)        printf(" FINAL");
2192         if (c->flags & ACC_SYNCHRONIZED) printf(" SYNCHRONIZED");
2193         if (c->flags & ACC_VOLATILE)     printf(" VOLATILE");
2194         if (c->flags & ACC_TRANSIENT)    printf(" TRANSIENT");
2195         if (c->flags & ACC_NATIVE)       printf(" NATIVE");
2196         if (c->flags & ACC_INTERFACE)    printf(" INTERFACE");
2197         if (c->flags & ACC_ABSTRACT)     printf(" ABSTRACT");
2198 }
2199 #endif
2200
2201
2202 /* class_print *****************************************************************
2203
2204    Prints classname plus flags.
2205
2206 *******************************************************************************/
2207
2208 #if !defined(NDEBUG)
2209 void class_print(classinfo *c)
2210 {
2211         if (c == NULL) {
2212                 printf("NULL");
2213                 return;
2214         }
2215
2216         utf_display_printable_ascii(c->name);
2217         class_printflags(c);
2218 }
2219 #endif
2220
2221
2222 /* class_classref_print ********************************************************
2223
2224    Prints classname plus referer class.
2225
2226 *******************************************************************************/
2227
2228 #if !defined(NDEBUG)
2229 void class_classref_print(constant_classref *cr)
2230 {
2231         if (cr == NULL) {
2232                 printf("NULL");
2233                 return;
2234         }
2235
2236         utf_display_printable_ascii(cr->name);
2237         printf("(ref.by ");
2238         if (cr->referer)
2239                 class_print(cr->referer);
2240         else
2241                 printf("NULL");
2242         printf(")");
2243 }
2244 #endif
2245
2246
2247 /* class_println ***************************************************************
2248
2249    Prints classname plus flags and new line.
2250
2251 *******************************************************************************/
2252
2253 #if !defined(NDEBUG)
2254 void class_println(classinfo *c)
2255 {
2256         class_print(c);
2257         printf("\n");
2258 }
2259 #endif
2260
2261
2262 /* class_classref_println ******************************************************
2263
2264    Prints classname plus referer class and new line.
2265
2266 *******************************************************************************/
2267
2268 #if !defined(NDEBUG)
2269 void class_classref_println(constant_classref *cr)
2270 {
2271         class_classref_print(cr);
2272         printf("\n");
2273 }
2274 #endif
2275
2276
2277 /* class_classref_or_classinfo_print *******************************************
2278
2279    Prints classname plus referer class.
2280
2281 *******************************************************************************/
2282
2283 #if !defined(NDEBUG)
2284 void class_classref_or_classinfo_print(classref_or_classinfo c)
2285 {
2286         if (c.any == NULL) {
2287                 printf("(classref_or_classinfo) NULL");
2288                 return;
2289         }
2290         if (IS_CLASSREF(c))
2291                 class_classref_print(c.ref);
2292         else
2293                 class_print(c.cls);
2294 }
2295 #endif
2296
2297
2298 /* class_classref_or_classinfo_println *****************************************
2299
2300    Prints classname plus referer class and a newline.
2301
2302 *******************************************************************************/
2303
2304 #if !defined(NDEBUG)
2305 void class_classref_or_classinfo_println(classref_or_classinfo c)
2306 {
2307         class_classref_or_classinfo_print(c);
2308         printf("\n");
2309 }
2310 #endif
2311
2312
2313 /* class_showconstantpool ******************************************************
2314
2315    Dump the constant pool of the given class to stdout.
2316
2317 *******************************************************************************/
2318
2319 #if !defined(NDEBUG)
2320 void class_showconstantpool (classinfo *c) 
2321 {
2322         u4 i;
2323         void* e;
2324
2325         printf ("---- dump of constant pool ----\n");
2326
2327         for (i=0; i<c->cpcount; i++) {
2328                 printf ("#%d:  ", (int) i);
2329                 
2330                 e = c -> cpinfos [i];
2331                 if (e) {
2332                         
2333                         switch (c -> cptags [i]) {
2334                         case CONSTANT_Class:
2335                                 printf ("Classreference -> ");
2336                                 utf_display_printable_ascii ( ((constant_classref*)e) -> name );
2337                                 break;
2338                         case CONSTANT_Fieldref:
2339                                 printf ("Fieldref -> ");
2340                                 field_fieldref_print((constant_FMIref *) e);
2341                                 break;
2342                         case CONSTANT_Methodref:
2343                                 printf ("Methodref -> ");
2344                                 method_methodref_print((constant_FMIref *) e);
2345                                 break;
2346                         case CONSTANT_InterfaceMethodref:
2347                                 printf ("InterfaceMethod -> ");
2348                                 method_methodref_print((constant_FMIref *) e);
2349                                 break;
2350                         case CONSTANT_String:
2351                                 printf ("String -> ");
2352                                 utf_display_printable_ascii ((utf*) e);
2353                                 break;
2354                         case CONSTANT_Integer:
2355                                 printf ("Integer -> %d", (int) ( ((constant_integer*)e) -> value) );
2356                                 break;
2357                         case CONSTANT_Float:
2358                                 printf ("Float -> %f", ((constant_float*)e) -> value);
2359                                 break;
2360                         case CONSTANT_Double:
2361                                 printf ("Double -> %f", ((constant_double*)e) -> value);
2362                                 break;
2363                         case CONSTANT_Long:
2364                                 printf ("Long -> %ld", (long int) ((constant_long*)e) -> value);
2365                                 break;
2366                         case CONSTANT_NameAndType:
2367                                 {
2368                                         constant_nameandtype *cnt = (constant_nameandtype *) e;
2369                                         printf ("NameAndType: ");
2370                                         utf_display_printable_ascii (cnt->name);
2371                                         printf (" ");
2372                                         utf_display_printable_ascii (cnt->descriptor);
2373                                 }
2374                                 break;
2375                         case CONSTANT_Utf8:
2376                                 printf ("Utf8 -> ");
2377                                 utf_display_printable_ascii ((utf*) e);
2378                                 break;
2379                         default: 
2380                                 log_text("Invalid type of ConstantPool-Entry");
2381                                 assert(0);
2382                         }
2383                 }
2384
2385                 printf ("\n");
2386         }
2387 }
2388 #endif /* !defined(NDEBUG) */
2389
2390
2391 /* class_showmethods ***********************************************************
2392
2393    Dump info about the fields and methods of the given class to stdout.
2394
2395 *******************************************************************************/
2396
2397 #if !defined(NDEBUG)
2398 void class_showmethods (classinfo *c)
2399 {
2400         s4 i;
2401         
2402         printf("--------- Fields and Methods ----------------\n");
2403         printf("Flags: ");
2404         class_printflags(c);
2405         printf("\n");
2406
2407         printf("This: ");
2408         utf_display_printable_ascii(c->name);
2409         printf("\n");
2410
2411         if (c->super) {
2412                 printf("Super: ");
2413                 utf_display_printable_ascii(c->super->name);
2414                 printf ("\n");
2415         }
2416
2417         printf("Index: %d\n", c->index);
2418         
2419         printf("Interfaces:\n");        
2420         for (i = 0; i < c->interfacescount; i++) {
2421                 printf("   ");
2422                 utf_display_printable_ascii(c->interfaces[i]->name);
2423                 printf (" (%d)\n", c->interfaces[i]->index);
2424         }
2425
2426         printf("Fields:\n");
2427         for (i = 0; i < c->fieldscount; i++)
2428                 field_println(&(c->fields[i]));
2429
2430         printf("Methods:\n");
2431         for (i = 0; i < c->methodscount; i++) {
2432                 methodinfo *m = &(c->methods[i]);
2433
2434                 if (!(m->flags & ACC_STATIC))
2435                         printf("vftblindex: %d   ", m->vftblindex);
2436
2437                 method_println(m);
2438         }
2439
2440         printf ("Virtual function table:\n");
2441         for (i = 0; i < c->vftbl->vftbllength; i++)
2442                 printf ("entry: %d,  %ld\n", i, (long int) (c->vftbl->table[i]));
2443 }
2444 #endif /* !defined(NDEBUG) */
2445
2446
2447 /*
2448  * These are local overrides for various environment variables in Emacs.
2449  * Please do not remove this and leave it at the end of the file, where
2450  * Emacs will automagically detect them.
2451  * ---------------------------------------------------------------------
2452  * Local variables:
2453  * mode: c
2454  * indent-tabs-mode: t
2455  * c-basic-offset: 4
2456  * tab-width: 4
2457  * End:
2458  * vim:noexpandtab:sw=4:ts=4:
2459  */