* Merged twisti branch to default. This merge introduces C++ wrapper
[cacao.git] / src / native / llni.h
index af6a2b16f42c9e54908a1aa0cb4b4808826ce024..043d82964baa26a3bcd6e12dc88b8e9857ab4735 100644 (file)
@@ -1,9 +1,7 @@
 /* src/native/llni.h - low level native interfarce (LLNI)
 
-   Copyright (C) 2007 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
+   Copyright (C) 2007, 2008
+   CACAOVM - Verein zur Foerderung der freien virtuellen Maschine CACAO
 
    This file is part of CACAO.
 
 #ifndef _LLNI_H
 #define _LLNI_H
 
+#ifdef __cplusplus
+extern "C" {
+#endif
+
 #include "config.h"
 
+/* forward defines ************************************************************/
+
+/* LLNI wrapping / unwrapping macros *******************************************
+
+   ATTENTION: Only use these macros inside a LLNI critical section!
+   Once the ciritical section ends, all pointers onto the GC heap
+   retrieved through these macros are void!
+
+*******************************************************************************/
+
+#if defined(ENABLE_HANDLES)
+# define LLNI_WRAP(obj)      ((obj) == NULL ? NULL : localref_add(obj))
+# define LLNI_UNWRAP(hdl)    ((hdl) == NULL ? NULL : (hdl)->heap_object)
+# define LLNI_QUICKWRAP(obj) ((obj) == NULL ? NULL : &(obj))
+# define LLNI_DIRECT(hdl)    ((hdl)->heap_object)
+#else
+# define LLNI_WRAP(obj)      (obj)
+# define LLNI_UNWRAP(hdl)    (hdl)
+# define LLNI_QUICKWRAP(obj) (obj)
+# define LLNI_DIRECT(hdl)    (hdl)
+#endif
+
+
 #include "native/localref.h"
 
+#include "threads/thread.hpp"
 
-/* LLNI macros *****************************************************************
 
-   The following macros should be used whenever a Java Object is
-   accessed in native code without the use of an JNI function.
+#define LLNI_class_get(obj, variable) \
+       (variable) = LLNI_field_direct((java_handle_t *) obj, vftbl->clazz)
 
-   LLNI_field_set_val, LLNI_field_get_val:
-     Deal with primitive values like integer and float values. Do
-     not use these macros to access pointers or references!
 
-   LLNI_field_set_ref, LLNI_field_get_ref:
-     Deal with references to other objects.
+/* LLNI_equals ****************************************************************
+   Test if two java_handle_t* point to the same java_object_t*.
 
-   LLNI_field_set_cls, LLNI_field_get_cls:
-     Deal with references to Java Classes which are internally
-     represented by classinfo or java_lang_Class.
+******************************************************************************/
 
-*******************************************************************************/
+#define LLNI_equals(obj1, obj2, result) \
+       LLNI_CRITICAL_START; \
+       (result) = LLNI_UNWRAP(obj1) == LLNI_UNWRAP(obj2); \
+       LLNI_CRITICAL_END
+       
 
-#define LLNI_field_set_val(obj, field, value) \
-       LLNI_field_direct(obj, field) = (value)
+/* LLNI_classinfo_field_get ***************************************************
+   Get a field from classinfo that is a java object.
 
-#define LLNI_field_set_ref(obj, field, reference) \
-       LLNI_field_direct(obj, field) = LLNI_DIRECT(reference)
+******************************************************************************/
 
-#define LLNI_field_set_cls(obj, field, value) \
-       LLNI_field_direct(obj, field) = (java_lang_Class *) (value)
+#define LLNI_classinfo_field_get(cls, field, variable) \
+       LLNI_CRITICAL_START; \
+       (variable) = LLNI_WRAP((cls)->field); \
+       LLNI_CRITICAL_END
 
-#define LLNI_field_get_val(obj, field, variable) \
-       (variable) = LLNI_field_direct(obj, field)
 
-#define LLNI_field_get_ref(obj, field, variable) \
-       (variable) = LLNI_WRAP(LLNI_field_direct(obj, field))
+/* LLNI_classinfo_field_set ***************************************************
+   Set a field from classinfo that is a java object.
 
-#define LLNI_field_get_cls(obj, field, variable) \
-       (variable) = (classinfo *) LLNI_field_direct(obj, field)
+******************************************************************************/
 
-#define LLNI_class_get(obj, variable) \
-       (variable) = LLNI_field_direct((java_handle_t *) obj, vftbl->class)
+#define LLNI_classinfo_field_set(cls, field, variable) \
+       LLNI_CRITICAL_START; \
+       (cls)->field = LLNI_UNWRAP(variable); \
+       LLNI_CRITICAL_END
 
 
 /* LLNI classinfo wrapping / unwrapping macros *********************************
 *******************************************************************************/
 
 #define LLNI_classinfo_wrap(classinfo) \
-       ((java_lang_Class *) LLNI_WRAP(classinfo))
+       ((java_handle_t*) LLNI_WRAP(classinfo))
 
 #define LLNI_classinfo_unwrap(clazz) \
        ((classinfo *) LLNI_UNWRAP((java_handle_t *) (clazz)))
 #define LLNI_array_size(arr)          (LLNI_DIRECT((java_handle_objectarray_t *) (arr))->header.size)
 
 
-/* XXX document me */
-
-#define LLNI_objectarray_element_set(arr, index, reference) \
-       LLNI_array_direct(arr, index) = LLNI_DIRECT(reference)
-
-#define LLNI_objectarray_element_get(arr, index, variable) \
-       (variable) = LLNI_WRAP(LLNI_array_direct(arr, index))
-
-
-/* LLNI wrapping / unwrapping macros *******************************************
-
-   ATTENTION: Only use these macros inside a LLNI critical section!
-   Once the ciritical section ends, all pointers onto the GC heap
-   retrieved through these macros are void!
-
-*******************************************************************************/
-
-#if defined(ENABLE_HANDLES)
-# define LLNI_WRAP(obj)   ((obj) == NULL ? NULL : localref_add(obj))
-# define LLNI_UNWRAP(hdl) ((hdl) == NULL ? NULL : (hdl)->heap_object)
-# define LLNI_DIRECT(obj) ((obj)->heap_object)
-#else
-# define LLNI_WRAP(obj)   ((java_handle_t *) obj)
-# define LLNI_UNWRAP(hdl) ((java_object_t *) hdl)
-# define LLNI_DIRECT(obj) (obj)
-#endif
-
-
 /* LLNI critical sections ******************************************************
 
    These macros handle the LLNI critical sections. While a critical
 *******************************************************************************/
 
 #if defined(ENABLE_THREADS) && defined(ENABLE_GC_CACAO)
-void llni_critical_start(void);
-void llni_critical_end(void);
-# define LLNI_CRITICAL_START llni_critical_start()
-# define LLNI_CRITICAL_END   llni_critical_end()
+# define LLNI_CRITICAL_START           llni_critical_start()
+# define LLNI_CRITICAL_END             llni_critical_end()
+# define LLNI_CRITICAL_START_THREAD(t) llni_critical_start_thread(t)
+# define LLNI_CRITICAL_END_THREAD(t)   llni_critical_end_thread(t)
 #else
 # define LLNI_CRITICAL_START
 # define LLNI_CRITICAL_END
+# define LLNI_CRITICAL_START_THREAD(t)
+# define LLNI_CRITICAL_END_THREAD(t)
 #endif
 
+void llni_critical_start();
+void llni_critical_end();
+void llni_critical_start_thread(threadobject *t);
+void llni_critical_end_thread(threadobject *t);
+
+#ifdef __cplusplus
+}
+#endif
 
 #endif /* _LLNI_H */