Safety first.
[cacao.git] / native.h
1 /* native.h - table of native functions
2
3    Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003
4    R. Grafl, A. Krall, C. Kruegel, C. Oates, R. Obermaisser,
5    M. Probst, S. Ring, E. Steiner, C. Thalinger, D. Thuernbeck,
6    P. Tomsich, J. Wenninger
7
8    This file is part of CACAO.
9
10    This program is free software; you can redistribute it and/or
11    modify it under the terms of the GNU General Public License as
12    published by the Free Software Foundation; either version 2, or (at
13    your option) any later version.
14
15    This program is distributed in the hope that it will be useful, but
16    WITHOUT ANY WARRANTY; without even the implied warranty of
17    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
18    General Public License for more details.
19
20    You should have received a copy of the GNU General Public License
21    along with this program; if not, write to the Free Software
22    Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
23    02111-1307, USA.
24
25    Contact: cacao@complang.tuwien.ac.at
26
27    Authors: Reinhard Grafl
28
29    $Id: native.h 862 2004-01-06 23:42:01Z stefan $
30
31 */
32
33
34 #ifndef _NATIVE_H
35 #define _NATIVE_H
36
37
38 #include "jni.h"
39 #include "nat/java_lang_String.h"
40
41
42 /* searchpath for classfiles */
43 extern char *classpath;
44
45 extern classinfo *class_java_lang_Class;
46 extern classinfo *class_java_lang_VMClass;
47 extern methodinfo *method_vmclass_init;
48 /* extern classinfo *class_java_lang_Cloneable=0; */ /* now in global.h */
49 extern classinfo *class_java_lang_CloneNotSupportedException;
50 extern classinfo *class_java_lang_System;
51 extern classinfo *class_java_lang_ClassLoader;
52 extern classinfo *class_java_lang_NoClassDefFoundError;
53 extern classinfo *class_java_lang_ClassNotFoundException;
54 extern classinfo *class_java_lang_LinkageError;
55 extern classinfo *class_java_lang_InstantiationException;
56 extern classinfo *class_java_lang_NoSuchMethodError;   
57 extern classinfo *class_java_lang_NoSuchFieldError;
58 extern classinfo *class_java_lang_ClassFormatError;
59 extern classinfo *class_java_lang_IllegalArgumentException;
60 extern classinfo *class_java_lang_ArrayIndexOutOfBoundsException;
61 extern classinfo *class_java_lang_NoSuchFieldException;
62 extern classinfo *class_java_io_SyncFailedException;
63 extern classinfo *class_java_io_IOException;
64 extern classinfo *class_java_io_FileNotFoundException;
65 extern classinfo *class_java_io_UnixFileSystem;
66 extern classinfo *class_java_security_PrivilegedActionException;
67 extern classinfo *class_java_net_UnknownHostException;
68 extern classinfo *class_java_net_SocketException;
69 extern classinfo *class_java_lang_NoSuchMethodException;
70 extern classinfo *class_java_lang_Double;
71 extern classinfo *class_java_lang_Float;
72 extern classinfo *class_java_lang_Long;
73 extern classinfo *class_java_lang_Byte;
74 extern classinfo *class_java_lang_Short;
75 extern classinfo *class_java_lang_Boolean;
76 extern classinfo *class_java_lang_Void;
77 extern classinfo *class_java_lang_Character;
78 extern classinfo *class_java_lang_Integer;
79
80 /* the system classloader object */
81 extern struct java_lang_ClassLoader *SystemClassLoader;
82
83 /* for raising exceptions from native methods */
84 /* extern java_objectheader* exceptionptr; */
85
86 /* javastring-hashtable */
87 extern hashtable string_hash; 
88
89
90 /* throw classnotfoundexcetion with detail message */
91 void throw_noclassdeffounderror_message(utf* classname);
92
93 /* throw linkageerror with detail message */
94 void throw_linkageerror_message(utf* classname);
95
96 void use_class_as_object(classinfo *c);
97
98 /* load classes required for native methods */
99 void native_loadclasses();
100
101 /* set searchpath for classfiles */
102 void native_setclasspath(char *path);
103
104 /* find native function */
105 functionptr native_findfunction(utf *cname, utf *mname, 
106                                                                 utf *desc, bool isstatic);
107
108 /* creates a new object of type java/lang/String from a utf-text */
109 /*  java_objectheader *javastring_new(utf *text); */
110 java_lang_String *javastring_new(utf *text);
111
112 /* creates a new object of type java/lang/String from a c-string */
113 /*  java_objectheader *javastring_new_char(char *text); */
114 java_lang_String *javastring_new_char(char *text);
115
116 /* make c-string from a javastring (debugging) */
117 char *javastring_tochar(java_objectheader *s);
118
119 /* create new object on the heap and call the initializer */
120 java_objectheader *native_new_and_init(classinfo *c);
121
122 /* 
123    create new object on the heap and call the initializer 
124    mainly used for exceptions with a message
125 */
126 java_objectheader *native_new_and_init_string(classinfo *c, java_lang_String *s);
127
128 /* add property to system-property vector */
129 void attach_property(char *name, char *value);
130
131 /* correct vftbl-entries of javastring-hash */
132 void stringtable_update();
133
134
135 /* make utf symbol from javastring */
136 utf *javastring_toutf(struct java_lang_String *string, bool isclassname);
137
138 /* make utf symbol from u2 array */
139 utf *utf_new_u2(u2 *unicodedata, u4 unicodelength, bool isclassname);
140
141 /* determine utf length in bytes of a u2 array */
142 u4 u2_utflength(u2 *text, u4 u2_length);
143
144 /* create systemclassloader object and initialize its instance fields  */
145 void init_systemclassloader();
146
147 /* search 'classinfo'-structure for a field with the specified name */
148 fieldinfo *class_findfield_approx(classinfo *c, utf *name);
149 s4 class_findfield_index_approx(classinfo *c, utf *name);
150
151 /* creates a new javastring with the text of the utf-symbol */
152 java_objectheader *literalstring_new(utf *u);
153
154 /* creates a new javastring with the text of the u2-array */
155 java_objectheader *literalstring_u2(java_chararray *a, u4 length, bool copymode);
156
157 /* dispose a javastring */
158 void literalstring_free(java_objectheader*);
159
160 void systemclassloader_addlibname(java_objectheader *o);
161 void systemclassloader_addlibrary(java_objectheader *o);
162
163 void copy_vftbl(vftbl **dest, vftbl *src);
164
165 utf *create_methodsig(java_objectarray* types, char *retType);
166 classinfo *get_type(char **utf_ptr,char *desc_end, bool skip);
167 java_objectarray* get_parametertypes(methodinfo *m);
168 java_objectarray* get_exceptiontypes(methodinfo *m);
169 classinfo *get_returntype(methodinfo *m);
170
171 #endif /* _NATIVE_H */
172
173
174 /*
175  * These are local overrides for various environment variables in Emacs.
176  * Please do not remove this and leave it at the end of the file, where
177  * Emacs will automagically detect them.
178  * ---------------------------------------------------------------------
179  * Local variables:
180  * mode: c
181  * indent-tabs-mode: t
182  * c-basic-offset: 4
183  * tab-width: 4
184  * End:
185  */