GNU header update.
[cacao.git] / src / vm / loader.h
index 06213ca23560b8f56f15d0a5311823849f89f5a2..6909bdae4656d4c424acfa7260d0077197655099 100644 (file)
@@ -1,9 +1,9 @@
-/* loader.c - class loader header
+/* vm/loader.h - class loader header
 
-   Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003
-   R. Grafl, A. Krall, C. Kruegel, C. Oates, R. Obermaisser,
-   M. Probst, S. Ring, E. Steiner, C. Thalinger, D. Thuernbeck,
-   P. Tomsich, J. Wenninger
+   Copyright (C) 1996-2005 R. Grafl, A. Krall, C. Kruegel, C. Oates,
+   R. Obermaisser, M. Platter, M. Probst, S. Ring, E. Steiner,
+   C. Thalinger, D. Thuernbeck, P. Tomsich, C. Ullrich, J. Wenninger,
+   Institut f. Computersprachen - TU Wien
 
    This file is part of CACAO.
 
 
    Authors: Reinhard Grafl
 
-   $Id: loader.h 593 2003-11-09 19:50:55Z twisti $
-
+   $Id: loader.h 1735 2004-12-07 14:33:27Z twisti $
 */
 
 
 #ifndef _LOADER_H
 #define _LOADER_H
 
-/************************* program switches ***********************************/
+#include <stdio.h>
+
+#if defined(USE_ZLIB)
+# include "vm/unzip.h"
+#endif
+
+
+/* datastruture from a classfile */
+
+typedef struct classbuffer {
+       classinfo *class;                   /* pointer to classinfo structure     */
+       u1 *data;                           /* pointer to byte code               */
+       s4 size;                            /* size of the byte code              */
+       u1 *pos;                            /* current read position              */
+} classbuffer;
+
+
+/* export variables */
+
+#ifdef USE_THREADS
+extern int blockInts;
+#endif
+
+
+/* references to some system classes ******************************************/
+
+extern classinfo *class_java_lang_Object;
+extern classinfo *class_java_lang_String;
+extern classinfo *class_java_lang_Cloneable;
+extern classinfo *class_java_io_Serializable;
+extern utf *utf_fillInStackTrace_name;
+extern utf *utf_fillInStackTrace_desc;
+
+/* pseudo classes for the type checker ****************************************/
 
-extern bool loadverbose;         /* Print debug messages during loading */
-extern bool linkverbose;
-extern bool initverbose;         /* Log class initialization */ 
-extern bool makeinitializations; /* Initialize classes automatically */
+/*
+ * pseudo_class_Arraystub
+ *     (extends Object implements Cloneable, java.io.Serializable)
+ *
+ *     If two arrays of incompatible component types are merged,
+ *     the resulting reference has no accessible components.
+ *     The result does, however, implement the interfaces Cloneable
+ *     and java.io.Serializable. This pseudo class is used internally
+ *     to represent such results. (They are *not* considered arrays!)
+ *
+ * pseudo_class_Null
+ *
+ *     This pseudo class is used internally to represent the
+ *     null type.
+ *
+ * pseudo_class_New
+ *
+ *     This pseudo class is used internally to represent the
+ *     the 'uninitialized object' type.
+ */
 
-extern bool getloadingtime;
-extern long int loadingtime;     /* CPU time for class loading */
+extern classinfo *pseudo_class_Arraystub;
+extern classinfo *pseudo_class_Null;
+extern classinfo *pseudo_class_New;
+extern vftbl_t *pseudo_class_Arraystub_vftbl;
 
-extern list unlinkedclasses;     /* List containing all unlinked classes */
-extern list linkedclasses;       /* List containing all linked classes */
+extern utf *array_packagename;
 
 
 /************************ prototypes ******************************************/
@@ -54,16 +103,12 @@ extern list linkedclasses;       /* List containing all linked classes */
 void loader_init();
 
 void suck_init(char *cpath);
+void create_all_classes();
+void suck_stop(classbuffer *cb);
 
 /* free resources */
 void loader_close();
 
-/* load a class and all referenced classes */
-classinfo *loader_load(utf *topname);
-
-/* initializes all loaded classes */
-void loader_initclasses();
-
 void loader_compute_subclasses();
 
 /* retrieve constantpool element */
@@ -72,12 +117,19 @@ voidptr class_getconstant(classinfo *class, u4 pos, u4 ctype);
 /* determine type of a constantpool element */
 u4 class_constanttype(classinfo *class, u4 pos);
 
+s4 class_findmethodIndex(classinfo *c, utf *name, utf *desc);
+
 /* search class for a field */
 fieldinfo *class_findfield(classinfo *c, utf *name, utf *desc);
+fieldinfo *class_resolvefield(classinfo *c, utf *name, utf *desc, classinfo *referer, bool except);
 
 /* search for a method with a specified name and descriptor */
 methodinfo *class_findmethod(classinfo *c, utf *name, utf *desc);
+methodinfo *class_fetchmethod(classinfo *c, utf *name, utf *desc);
+methodinfo *class_findmethod_w(classinfo *c, utf *name, utf *desc, char*);
 methodinfo *class_resolvemethod(classinfo *c, utf *name, utf *dest);
+methodinfo *class_resolveclassmethod(classinfo *c, utf *name, utf *dest, classinfo *referer, bool except);
+methodinfo *class_resolveinterfacemethod(classinfo *c, utf *name, utf *dest, classinfo *referer, bool except);
 
 /* search for a method with specified name and arguments (returntype ignored) */
 methodinfo *class_findmethod_approx(classinfo *c, utf *name, utf *desc);
@@ -86,30 +138,82 @@ methodinfo *class_resolvemethod_approx(classinfo *c, utf *name, utf *dest);
 bool class_issubclass(classinfo *sub, classinfo *super);
 
 /* call initializer of class */
-void class_init(classinfo *c);
+classinfo *class_init(classinfo *c);
 
 void class_showconstanti(classinfo *c, int ii);
 
 /* debug purposes */
-void class_showconstantpool(classinfo *c);
 void class_showmethods(classinfo *c);
-
-classinfo *loader_load(utf *topname);
-
-/* set buffer for reading classdata */
-void classload_buffer(u1 *buf,int len);
-
-/* create class representing specific arraytype */
-classinfo *create_array_class(utf *u);
-
-/* create the arraydescriptor for the arraytype specified by the utf-string */
-constant_arraydescriptor * buildarraydescriptor(char *utf, u4 namelen);
-
-void class_link(classinfo *c);
+void class_showconstantpool(classinfo *c);
+void print_arraydescriptor(FILE *file, arraydescriptor *desc);
+
+/* return the primitive class inidicated by the given signature character */
+classinfo *class_primitive_from_sig(char sig);
+
+
+/* return the class indicated by the given descriptor */
+/* (see loader.c for documentation) */
+#define CLASSLOAD_NEW           0      /* default */
+#define CLASSLOAD_LOAD          0x0001
+#define CLASSLOAD_SKIP          0x0002
+#define CLASSLOAD_PANIC         0      /* default */
+#define CLASSLOAD_NOPANIC       0x0010
+#define CLASSLOAD_PRIMITIVE     0      /* default */
+#define CLASSLOAD_NULLPRIMITIVE 0x0020
+#define CLASSLOAD_VOID          0      /* default */
+#define CLASSLOAD_NOVOID        0x0040
+#define CLASSLOAD_NOCHECKEND    0      /* default */
+#define CLASSLOAD_CHECKEND      0x1000
+
+classinfo *class_from_descriptor(char *utf_ptr,char *end_ptr,char **next,int mode);
+int type_from_descriptor(classinfo **cls,char *utf_ptr,char *end_ptr,char **next,int mode);
+
+/* (used by class_new, don't use directly) */
+void class_new_array(classinfo *c);
+
+#define LAZYLOADING(class) { \
+        if (!class->loaded) \
+            if (!class_load(class)) \
+                return 0; \
+        if (!class->linked) \
+            if (!class_link(class)) \
+                return 0; }
+
+
+classinfo *class_load(classinfo *c);
+classinfo *class_load_intern(classbuffer *cb);
+classinfo *class_link(classinfo *c);
+void class_free(classinfo *c);
 
 void field_display(fieldinfo *f);
 
 void method_display(methodinfo *m);
+void method_display_w_class(methodinfo *m);
+
+utf* clinit_desc();
+utf* clinit_name();
+
+
+/******************************** CLASSPATH handling *******************/
+#define CLASSPATH_MAXFILENAME 1000                /* maximum length of a filename           */
+#define CLASSPATH_PATH 0
+#define CLASSPATH_ARCHIVE 1
+
+typedef union classpath_info {
+       struct {
+               s4                    type;
+               union classpath_info *next;
+               char                 *path;
+               s4                    pathlen;
+       } filepath;
+#if defined(USE_ZLIB)
+       struct {
+               s4                    type;
+               union classpath_info *next;
+               unzFile               uf;
+       } archive;
+#endif 
+} classpath_info;
 
 #endif /* _LOADER_H */