* Updated header: Added 2006. Changed address of FSF. Changed email
[cacao.git] / src / native / native.h
1 /* src/native/native.h - table of native functions
2
3    Copyright (C) 1996-2005, 2006 R. Grafl, A. Krall, C. Kruegel,
4    C. Oates, R. Obermaisser, M. Platter, M. Probst, S. Ring,
5    E. Steiner, C. Thalinger, D. Thuernbeck, P. Tomsich, C. Ullrich,
6    J. Wenninger, Institut f. Computersprachen - TU Wien
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., 51 Franklin Street, Fifth Floor, Boston, MA
23    02110-1301, USA.
24
25    Contact: cacao@cacaojvm.org
26
27    Authors: Reinhard Grafl
28
29    Changes: Christian Thalinger
30
31    $Id: native.h 4357 2006-01-22 23:33:38Z twisti $
32
33 */
34
35
36 #ifndef _NATIVE_H
37 #define _NATIVE_H
38
39 #include "config.h"
40
41 #if !defined(ENABLE_STATICVM)
42 # include <ltdl.h>
43 #endif
44
45 #include "vm/class.h"
46 #include "vm/global.h"
47 #include "vm/method.h"
48 #include "vm/utf8.h"
49 #include "native/jni.h"
50 #include "native/include/java_lang_String.h"
51 #include "native/include/java_lang_ClassLoader.h"
52 #include "native/include/java_lang_Throwable.h"
53
54
55 /* table for locating native methods */
56
57 typedef struct nativeref nativeref;
58 typedef struct nativecompref nativecompref;
59
60
61 #if !defined(ENABLE_STATICVM)
62 typedef struct hashtable_library_loader_entry hashtable_library_loader_entry;
63 typedef struct hashtable_library_name_entry hashtable_library_name_entry;
64
65
66 /* hashtable_library_loader_entry *********************************************/
67
68 struct hashtable_library_loader_entry {
69         java_objectheader              *loader;  /* class loader                  */
70         hashtable_library_name_entry   *namelink;/* libs loaded by this loader    */
71         hashtable_library_loader_entry *hashlink;/* link for external chaining    */
72 };
73
74
75 /* hashtable_library_name_entry ***********************************************/
76
77 struct hashtable_library_name_entry {
78         utf                          *name;      /* library name                  */
79         lt_dlhandle                   handle;    /* libtool library handle        */
80         hashtable_library_name_entry *hashlink;  /* link for external chaining    */
81 };
82 #endif
83
84
85 struct nativeref {
86         char       *classname;
87         char       *methodname;
88         char       *descriptor;
89         bool        isstatic;
90         functionptr func;
91 };
92
93 /* table for fast string comparison */
94
95 struct nativecompref {
96         utf        *classname;
97         utf        *methodname;
98         utf        *descriptor;
99         bool        isstatic;
100         functionptr func;
101 };
102
103
104 /* initialize native subsystem */
105 bool native_init(void);
106
107 #if defined(ENABLE_STATICVM)
108
109 /* find native function */
110 functionptr native_findfunction(utf *cname, utf *mname, utf *desc,
111                                                                 bool isstatic);
112
113 #else /* defined(ENABLE_STATICVM) */
114
115 /* add a library to the library hash */
116 void native_hashtable_library_add(utf *filename, java_objectheader *loader,
117                                                                   lt_dlhandle handle);
118
119 /* find a library entry in the library hash */
120 hashtable_library_name_entry *native_hashtable_library_find(utf *filename,
121                                                                                                                         java_objectheader *loader);
122
123 /* resolve native function */
124 functionptr native_resolve_function(methodinfo *m);
125
126 #endif /* defined(ENABLE_STATICVM) */
127
128 /* create new object on the heap and call the initializer */
129 java_objectheader *native_new_and_init(classinfo *c);
130
131 /* create new object on the heap and call the initializer 
132    mainly used for exceptions with a message */
133 java_objectheader *native_new_and_init_string(classinfo *c, java_lang_String *s);
134
135 /* create new object on the heap and call the initializer 
136    mainly used for exceptions with an index */
137 java_objectheader *native_new_and_init_int(classinfo *c, s4 i);
138
139 /* create new object on the heap and call the initializer 
140    mainly used for exceptions with cause */
141 java_objectheader *native_new_and_init_throwable(classinfo *c, java_lang_Throwable *t);
142
143 java_objectarray *native_get_parametertypes(methodinfo *m);
144 java_objectarray *native_get_exceptiontypes(methodinfo *m);
145 classinfo *native_get_returntype(methodinfo *m);
146
147 #endif /* _NATIVE_H */
148
149
150 /*
151  * These are local overrides for various environment variables in Emacs.
152  * Please do not remove this and leave it at the end of the file, where
153  * Emacs will automagically detect them.
154  * ---------------------------------------------------------------------
155  * Local variables:
156  * mode: c
157  * indent-tabs-mode: t
158  * c-basic-offset: 4
159  * tab-width: 4
160  * End:
161  */