+
jParser
++ A Java code-generation library that bridges C/C++ native code to JVM platforms — desktop, mobile, and web. +
+ - -[](https://central.sonatype.com/artifact/com.github.xpenatan.jParser/jParser-core) -[](https://central.sonatype.com/service/rest/repository/browse/maven-snapshots/com/github/xpenatan/jParser/) +
+ 
+ 
+
-Here is a list of all IDLBase methods: -* **static [ClassName].native_new()**: Creates a new empty instance without any associated native data. -* **static [ClassName].NULL**: Returns a NULL instance. Every method parameter must not be null. Use this when a native methods needs a null parameter. -* **dispose()**: Deletes the native instance, but only if you own it. -* **isDisposed()**: Checks whether the native instance has been disposed. -* **native_setVoid(...)**: Sets an integer or long memory address. In TeaVM, the long is cast to an integer. -* **native_reset()**: Resets the Java instance to its default state, removing any associated native data. -* **native_takeOwnership()**: Takes ownership of the native data, enabling dispose() to delete the object. -* **native_releaseOwnership()**: Releases ownership of the native data, preventing dispose() from deleting the object. -* **native_hasOwnership()**: Checks whether you own the native instance. -* **native_copy(...)**: Copies the memory address and all other native data from another Java instance to this Java instance. +## Code Block Convention -The **native** method keyword is primarily used to avoid conflicts with C/C++ methods. +In `lib-base` Java source files, native code is embedded via annotated comment blocks. jParser reads these blocks and generates the appropriate code for each target. -## Libraries using jParser:
-- [jWebGPU](https://github.com/xpenatan/jWebGPU)¹ -- [xImGui](https://github.com/xpenatan/xImGui)¹ -- [xJolt](https://github.com/xpenatan/xJolt)¹ -- [xLua](https://github.com/xpenatan/XLua)¹ -- [xBullet](https://github.com/xpenatan/xBullet)¹ -- [gdx-box2d](https://github.com/xpenatan/gdx-box2d)² -- [gdx-physx](https://github.com/xpenatan/gdx-physx)² +```java +public class MyLib extends IDLBase { -¹: The focus is on maintaining this project.
-²: This project is currently inactive and may only be used to test the generator. + // JNI native code block — compiled into C++ for desktop & mobile + /*[-JNI;-NATIVE] + MyType* obj = (MyType*)this_addr; + return obj->getValue(); + */ + private static native int internal_native_getValue(long this_addr); -## Requirements: -#### [Mingw64](https://github.com/niXman/mingw-builds-binaries/releases) or [Visual Studio C++](https://visualstudio.microsoft.com/vs/community/) -#### [Emscripten](https://emscripten.org/) -For Windows builds using WindowsMSVCTarget, ensure `vcvarsall.bat` is accessible via the system PATH. It is typically located in `C:\Program Files\Microsoft Visual Studio\[Year]\[Edition]\VC\Auxiliary\Build\`. + // TeaVM replacement — generates @JSBody-annotated method for web + /*[-TEAVM;-REPLACE] + @org.teavm.jso.JSBody(params = {"this_addr"}, + script = "var jsObj = [MODULE].wrapPointer(this_addr, [MODULE].MyType);" + + "return jsObj.getValue();") + private static native int internal_native_getValue(int this_addr); + */ +} +``` + +### Available Commands + +| Command | Description | +|---|---| +| `-NATIVE` | Inline C/C++ code compiled for the target | +| `-ADD` | Adds code to the generated output | +| `-ADD_RAW` | Adds raw code without processing | +| `-REMOVE` | Removes code from the generated output | +| `-REPLACE` | Replaces the following method with the block content | +| `-REPLACE_BLOCK` | Replaces the following code block | +| `-IDL_SKIP` | Placed on a class comment to skip IDL generation for that class | + +## WebIDL Bindings + +To reduce the effort of manually porting each method, jParser supports **Emscripten WebIDL**. Define a `.idl` file and jParser automatically generates binding code for all targets. + +```idl +interface NormalClass { + void NormalClass(); + long addIntValue(long value1, long value2); + static long subIntValue(long value1, long value2); + attribute long intValue; + attribute float floatValue; +}; +``` + +This generates fully working Java classes with native bindings for JNI, FFM, and TeaVM — no manual glue code required. + +### WebIDL Notes + +- **IDL helper classes** (`IDLInt`, `IDLIntArray`, etc.) let you pass primitive pointers to C++. They work across Emscripten, desktop, and mobile. +- **C++ enums** are converted into Java enums, each carrying the integer value from native code. +- **`[Value]` methods** return a cached copy of the object. The cache is overwritten on each call — do not retain references. +- **`[NoDelete]` classes** should not have `dispose()` called. All other classes require explicit disposal. + +## IDLBase API + +Every native class extends `IDLBase`, which provides common memory-management functionality. + +> **Important:** jParser does not automatically dispose C++ objects. You must call `dispose()` when you're done with an object to free native memory. Only objects you create or explicitly own require disposal. Creating and disposing native objects is expensive — avoid doing it every frame. + +| Method | Description | +|---|---| +| `ClassName.native_new()` | Creates an empty instance without native data | +| `ClassName.NULL` | Returns a NULL instance — use instead of Java `null` for native parameters | +| `dispose()` | Deletes the native instance (only if owned) | +| `isDisposed()` | Checks whether the native instance has been disposed | +| `native_setVoid(...)` | Sets an integer or long memory address | +| `native_reset()` | Resets the instance to default state | +| `native_takeOwnership()` | Takes ownership, enabling `dispose()` to delete the object | +| `native_releaseOwnership()` | Releases ownership, preventing `dispose()` from deleting | +| `native_hasOwnership()` | Checks whether you own the native instance | +| `native_copy(...)` | Copies memory address and native data from another instance | + +> The `native_` prefix is used to avoid naming conflicts with C/C++ methods. + +## Requirements + +| Requirement | Purpose | +|---|---| +| **JDK 11+** | Building jParser tool modules | +| **JDK 22+** (25 recommended) | FFM modules and FFM-based apps | +| [MinGW64](https://github.com/niXman/mingw-builds-binaries/releases) or [Visual Studio C++](https://visualstudio.microsoft.com/vs/community/) | Windows native builds | +| GCC / G++ | Linux native builds | +| Xcode CLI tools | macOS native builds | +| [Emscripten SDK](https://emscripten.org/) | Web builds (JS/WASM) | + +> **Windows (MSVC):** Ensure `vcvarsall.bat` is on your system `PATH`. It is typically located at: +> `C:\Program Files\Microsoft Visual Studio\[Year]\[Edition]\VC\Auxiliary\Build\` + +## Getting Started + +For a complete working example, refer to the [`examples/TestLib`](examples/TestLib) module. + +### Module Layout + +jParser projects follow a strict `-base / -build / -core / -teavm` convention: + +| Module Suffix | Purpose | +|---|---| +| `lib-base` | Hand-written Java source with embedded native code blocks | +| `lib-build` | Build entry point — configures IDL, targets, runs generation + compilation | +| `lib-core` | **Generated** JNI Java output _(do not hand-edit)_ | +| `lib-teavm` | **Generated** TeaVM Java output _(do not hand-edit)_ | +| `lib-desktop-ffm` | **Generated** FFM Java output _(do not hand-edit)_ | +| `lib-desktop-jni` | Bundles JNI-compiled native libraries into a JAR | +| `lib-android` | Android-specific packaging | + +### Build Example: TestLib + +```bash +# 1. Build idl-helper (required once) +./gradlew :idl-helper:idl-helper-build:idl_helper_build_project_jni_windows64 + +# 2. Generate code + compile native library +./gradlew :examples:TestLib:lib:lib-build:TestLib_build_project_jni_windows64 + +# 3. Run the desktop app +./gradlew :examples:TestLib:app:desktop-jni:TestLib_run_app_desktop +``` + +> Replace `windows64` with `linux64`, `mac64`, or `macArm` for other platforms. +> Replace `jni` with `ffm` for Foreign Function & Memory API targets. + +## Libraries Using jParser + +| Library | Description | Status | +|---|---|---| +| [jWebGPU](https://github.com/xpenatan/jWebGPU) | WebGPU bindings for Java | Active | +| [xImGui](https://github.com/xpenatan/xImGui) | Dear ImGui bindings for Java | Active | +| [xJolt](https://github.com/xpenatan/xJolt) | Jolt Physics bindings for Java | Active | +| [xLua](https://github.com/xpenatan/XLua) | Lua bindings for Java | Active | +| [xBullet](https://github.com/xpenatan/xBullet) | Bullet Physics bindings for Java | Active | +| [gdx-box2d](https://github.com/xpenatan/gdx-box2d) | Box2D bindings for libGDX | Inactive | +| [gdx-physx](https://github.com/xpenatan/gdx-physx) | PhysX bindings for libGDX | Inactive | + +## License + +jParser is licensed under the [Apache License 2.0](LICENSE). diff --git a/buildSrc/src/main/kotlin/LibExt.kt b/buildSrc/src/main/kotlin/LibExt.kt index 57c0c260..fe8231ca 100644 --- a/buildSrc/src/main/kotlin/LibExt.kt +++ b/buildSrc/src/main/kotlin/LibExt.kt @@ -12,17 +12,18 @@ object LibExt { const val java8Target = "1.8" const val java11Target = "11" + const val java24Target = "24" // Lib Dependencies const val jniGenVersion = "2.5.1" - const val teaVMVersion = "0.13.0" + const val teaVMVersion = "0.13.1" const val javaparserVersion = "3.26.1" const val jMultiplatform = "0.1.3" // Example Dependencies const val exampleUseRepoLibs = false const val gdxVersion = "1.14.0" - const val gdxTeaVMVersion = "1.4.0" + const val gdxTeaVMVersion = "1.5.4" const val jUnitVersion = "4.13.2" } diff --git a/buildSrc/src/main/kotlin/publish.gradle.kts b/buildSrc/src/main/kotlin/publish.gradle.kts index fa09c4dc..463785d6 100644 --- a/buildSrc/src/main/kotlin/publish.gradle.kts +++ b/buildSrc/src/main/kotlin/publish.gradle.kts @@ -10,12 +10,14 @@ var libProjects = mutableSetOf( project(":jParser:jParser-idl"), project(":jParser:jParser-cpp"), project(":jParser:jParser-teavm"), + project(":jParser:jParser-ffm"), project(":idl:idl-core"), project(":idl:idl-teavm"), project(":idl-helper:idl-helper-base"), project(":idl-helper:idl-helper-core"), project(":idl-helper:idl-helper-teavm"), - project(":idl-helper:idl-helper-desktop"), + project(":idl-helper:idl-helper-desktop-jni"), + project(":idl-helper:idl-helper-desktop-ffm"), project(":idl-helper:idl-helper-android"), project(":loader:loader-core"), project(":loader:loader-teavm"), diff --git a/examples/SharedLib/app/android/build.gradle.kts b/examples/SharedLib/app/android/build.gradle.kts index a2af8456..ac5ffbd5 100644 --- a/examples/SharedLib/app/android/build.gradle.kts +++ b/examples/SharedLib/app/android/build.gradle.kts @@ -43,7 +43,9 @@ dependencies { natives("com.badlogicgames.gdx:gdx-platform:${LibExt.gdxVersion}:natives-x86") implementation(project(":examples:SharedLib:app:core")) + api(project(":examples:SharedLib:libA:lib-core")) api(project(":examples:SharedLib:libA:lib-android")) + api(project(":examples:SharedLib:libB:lib-core")) api(project(":examples:SharedLib:libB:lib-android")) api(project(":idl-helper:idl-helper-android")) } diff --git a/examples/SharedLib/app/core/build.gradle.kts b/examples/SharedLib/app/core/build.gradle.kts index d0c13e5a..36fcb787 100644 --- a/examples/SharedLib/app/core/build.gradle.kts +++ b/examples/SharedLib/app/core/build.gradle.kts @@ -8,14 +8,17 @@ java { } dependencies { - implementation(project(":examples:SharedLib:libA:lib-core")) - implementation(project(":examples:SharedLib:libB:lib-core")) + // compileOnly: app/core compiles against lib-core's API, but does NOT + // propagate it transitively. Each platform module (desktop-jni, desktop-ffm, + // android, teavm) provides the actual native bridge implementation. + compileOnly(project(":examples:SharedLib:libA:lib-core")) + compileOnly(project(":examples:SharedLib:libB:lib-core")) implementation("com.badlogicgames.gdx:gdx:${LibExt.gdxVersion}") - testImplementation(project(":examples:SharedLib:libA:lib-desktop")) - testImplementation(project(":examples:SharedLib:libB:lib-desktop")) - testImplementation(project(":idl-helper:idl-helper-desktop")) + testImplementation(project(":examples:SharedLib:libA:lib-desktop-jni")) + testImplementation(project(":examples:SharedLib:libB:lib-desktop-jni")) + testImplementation(project(":idl-helper:idl-helper-desktop-jni")) testImplementation("junit:junit:${LibExt.jUnitVersion}") } diff --git a/examples/SharedLib/app/desktop/build.gradle.kts b/examples/SharedLib/app/desktop-ffm/build.gradle.kts similarity index 81% rename from examples/SharedLib/app/desktop/build.gradle.kts rename to examples/SharedLib/app/desktop-ffm/build.gradle.kts index d234ee39..57e17e6c 100644 --- a/examples/SharedLib/app/desktop/build.gradle.kts +++ b/examples/SharedLib/app/desktop-ffm/build.gradle.kts @@ -11,9 +11,8 @@ java { dependencies { implementation(project(":examples:SharedLib:app:core")) - implementation(project(":examples:SharedLib:libA:lib-desktop")) - implementation(project(":examples:SharedLib:libB:lib-desktop")) - implementation(project(":idl-helper:idl-helper-desktop")) + implementation(project(":examples:SharedLib:libA:lib-desktop-ffm")) + implementation(project(":examples:SharedLib:libB:lib-desktop-ffm")) implementation("com.badlogicgames.gdx:gdx-platform:${LibExt.gdxVersion}:natives-desktop") implementation("com.badlogicgames.gdx:gdx-backend-lwjgl3:${LibExt.gdxVersion}") @@ -21,10 +20,15 @@ dependencies { tasks.register
+ * Each benchmark measures the cost of crossing the Java → native boundary for + * different parameter types. The native work is intentionally trivial so the + * measurement isolates bridge overhead, not native computation. + *
+ * Results are printed to stdout. Run this on desktop with either lib-core (JNI)
+ * or lib-ffm (FFM) on the classpath to compare. On TeaVM the iteration count
+ * is reduced automatically.
+ */
+public class NativeBridgeBenchmark {
+
+ // ---------------------------------------------------------------------------
+ // Configuration
+ // ---------------------------------------------------------------------------
+
+ /** Number of warm-up iterations (allows JIT to stabilise). */
+ private static final int WARMUP_ITERATIONS = 2;
+ /** Number of timed iterations whose median is reported. */
+ private static final int TIMED_ITERATIONS = 3;
+
+ /** Calls per timed iteration – adjusted for TeaVM. */
+ private static long CALLS_PER_ITERATION = 1_000_000L;
+
+ // Reusable native objects – allocated once to avoid measuring allocation.
+ private static TestMethodClass methodObj;
+ private static TestObjectClass objectA;
+ private static TestObjectClass objectB;
+ private static TestAttributeClass attrObj;
+ private static TestBufferManualClass bufferObj;
+ private static IDLIntArray intArray;
+ private static ByteBuffer byteBuffer;
+
+ /** Collected results for CSV export. */
+ private static final ArrayList
+ * Usage: {@code java NativeBridgeBenchmarkCompare
+ * Each frame executes a fixed number of native calls for the current scenario,
+ * then returns to let GDX render. A state machine cycles through all scenarios,
+ * measuring average and minimum FPS for each.
+ *
+ * This complements {@link NativeBridgeBenchmark} which measures raw throughput
+ * in a tight loop. The FPS benchmark shows real-world frame rate impact.
+ */
+public class NativeBridgeFpsBenchmark {
+
+ // ---------------------------------------------------------------------------
+ // Configuration
+ // ---------------------------------------------------------------------------
+
+ /** Native calls executed per frame for every scenario. */
+ private static final int CALLS_PER_FRAME = 50_000;
+ /** Seconds to warm up before measuring (lets JIT stabilise). */
+ private static final float WARMUP_SECONDS = 2f;
+ /** Seconds to measure FPS after warm-up. */
+ private static final float MEASURE_SECONDS = 5f;
+
+ // ---------------------------------------------------------------------------
+ // State machine
+ // ---------------------------------------------------------------------------
+
+ private enum State { IDLE, WARMUP, MEASURE, NEXT, DONE }
+
+ private State state = State.IDLE;
+ private float elapsed;
+ private int frameCount;
+ private float minFrameTime; // worst (longest) frame during measurement
+ private int scenarioIndex;
+
+ // Reusable native objects
+ private TestMethodClass methodObj;
+ private TestObjectClass objectA;
+ private TestObjectClass objectB;
+ private TestAttributeClass attrObj;
+ private TestBufferManualClass bufferObj;
+ private IDLIntArray intArray;
+ private ByteBuffer byteBuffer;
+
+ // Scenario definitions
+ private String[] labels;
+ private Runnable[] workloads;
+
+ // Collected results
+ private final ArrayList
+ * Usage: {@code java NativeBridgeFpsBenchmarkCompare For each native method, generates:
+ *
+ *
+ */
+public class FFMCodeParser extends IDLDefaultCodeParser {
+
+ private static final String HEADER_CMD = "FFM";
+
+ // Same template tags as CppCodeParser (the C++ code is largely the same)
+ protected static final String TEMPLATE_TAG_TYPE = "[TYPE]";
+ protected static final String TEMPLATE_TAG_METHOD = "[METHOD]";
+ protected static final String TEMPLATE_TAG_OPERATOR = "[OPERATOR]";
+ protected static final String TEMPLATE_TAG_ATTRIBUTE = "[ATTRIBUTE]";
+ protected static final String TEMPLATE_TAG_ENUM = "[ENUM]";
+ protected static final String TEMPLATE_TAG_ATTRIBUTE_TYPE = "[ATTRIBUTE_TYPE]";
+ protected static final String TEMPLATE_TAG_RETURN_TYPE = "[RETURN_TYPE]";
+ protected static final String TEMPLATE_TAG_CONST = "[CONST]";
+ protected static final String TEMPLATE_TAG_COPY_TYPE = "[COPY_TYPE]";
+ protected static final String TEMPLATE_TAG_COPY_PARAM = "[COPY_PARAM]";
+ protected static final String TEMPLATE_TAG_CONSTRUCTOR = "[CONSTRUCTOR]";
+ protected static final String TEMPLATE_TAG_CAST = "[CAST]";
+
+ // C++ templates — identical to CppCodeParser but with int64_t casts instead of jlong
+ protected static final String GET_CONSTRUCTOR_OBJ_POINTER_TEMPLATE =
+ "\nreturn (int64_t)new [CONSTRUCTOR];\n";
+
+ protected static final String METHOD_DELETE_OBJ_POINTER_TEMPLATE =
+ "\n[TYPE]* nativeObject = ([TYPE]*)this_addr;\n" +
+ "delete nativeObject;\n";
+
+ // --- Attribute templates (int64_t instead of jlong, int32_t instead of jint) ---
+
+ protected static final String ATTRIBUTE_SET_PRIMITIVE_STATIC_TEMPLATE =
+ "\n[TYPE]::[ATTRIBUTE] = [ATTRIBUTE];\n";
+
+ protected static final String ATTRIBUTE_ARRAY_SET_PRIMITIVE_STATIC_TEMPLATE =
+ "\n[TYPE]::[ATTRIBUTE][index] = [ATTRIBUTE];\n";
+
+ protected static final String ATTRIBUTE_SET_PRIMITIVE_TEMPLATE =
+ "\n[TYPE]* nativeObject = ([TYPE]*)this_addr;\n" +
+ "nativeObject->[ATTRIBUTE] = [CAST][ATTRIBUTE];\n";
+
+ protected static final String ATTRIBUTE_ARRAY_SET_PRIMITIVE_TEMPLATE =
+ "\n[TYPE]* nativeObject = ([TYPE]*)this_addr;\n" +
+ "nativeObject->[ATTRIBUTE][index] = [CAST][ATTRIBUTE];\n";
+
+ protected static final String ATTRIBUTE_SET_OBJECT_POINTER_STATIC_TEMPLATE =
+ "\n[TYPE]::[ATTRIBUTE] = ([ATTRIBUTE_TYPE]*)[ATTRIBUTE]_addr;\n";
+
+ protected static final String ATTRIBUTE_ARRAY_SET_OBJECT_POINTER_STATIC_TEMPLATE =
+ "\n[TYPE]::[ATTRIBUTE][index] = ([ATTRIBUTE_TYPE]*)[ATTRIBUTE]_addr;\n";
+
+ protected static final String ATTRIBUTE_SET_OBJECT_POINTER_TEMPLATE =
+ "\n[TYPE]* nativeObject = ([TYPE]*)this_addr;\n" +
+ "nativeObject->[ATTRIBUTE] = ([ATTRIBUTE_TYPE]*)[ATTRIBUTE]_addr;\n";
+
+ protected static final String ATTRIBUTE_ARRAY_SET_OBJECT_POINTER_TEMPLATE =
+ "\n[TYPE]* nativeObject = ([TYPE]*)this_addr;\n" +
+ "nativeObject->[ATTRIBUTE][index] = ([ATTRIBUTE_TYPE]*)[ATTRIBUTE]_addr;\n";
+
+ protected static final String ATTRIBUTE_SET_OBJECT_VALUE_STATIC_TEMPLATE =
+ "\n[TYPE]::[ATTRIBUTE] = *(([ATTRIBUTE_TYPE]*)[ATTRIBUTE]_addr);\n";
+
+ protected static final String ATTRIBUTE_ARRAY_SET_OBJECT_VALUE_STATIC_TEMPLATE =
+ "\n[TYPE]::[ATTRIBUTE][index] = *(([ATTRIBUTE_TYPE]*)[ATTRIBUTE]_addr);\n";
+
+ protected static final String ATTRIBUTE_SET_OBJECT_VALUE_TEMPLATE =
+ "\n[TYPE]* nativeObject = ([TYPE]*)this_addr;\n" +
+ "nativeObject->[ATTRIBUTE] = *(([ATTRIBUTE_TYPE]*)[ATTRIBUTE]_addr);\n";
+
+ protected static final String ATTRIBUTE_ARRAY_SET_OBJECT_VALUE_TEMPLATE =
+ "\n[TYPE]* nativeObject = ([TYPE]*)this_addr;\n" +
+ "nativeObject->[ATTRIBUTE][index] = *(([ATTRIBUTE_TYPE]*)[ATTRIBUTE]_addr);\n";
+
+ protected static final String ATTRIBUTE_GET_OBJECT_VALUE_STATIC_TEMPLATE =
+ "\nreturn (int64_t)&[TYPE]::[ATTRIBUTE];\n";
+
+ protected static final String ATTRIBUTE_ARRAY_GET_OBJECT_VALUE_STATIC_TEMPLATE =
+ "\nreturn (int64_t)&[TYPE]::[ATTRIBUTE][index];\n";
+
+ protected static final String ATTRIBUTE_GET_OBJECT_VALUE_TEMPLATE =
+ "\n[TYPE]* nativeObject = ([TYPE]*)this_addr;\n" +
+ "return (int64_t)&nativeObject->[ATTRIBUTE];\n";
+
+ protected static final String ATTRIBUTE_ARRAY_GET_OBJECT_VALUE_TEMPLATE =
+ "\n[TYPE]* nativeObject = ([TYPE]*)this_addr;\n" +
+ "return (int64_t)&nativeObject->[ATTRIBUTE][index];\n";
+
+ protected static final String ATTRIBUTE_GET_OBJECT_POINTER_STATIC_TEMPLATE =
+ "\nreturn (int64_t)[TYPE]::[ATTRIBUTE];\n";
+
+ protected static final String ATTRIBUTE_ARRAY_GET_OBJECT_POINTER_STATIC_TEMPLATE =
+ "\nreturn (int64_t)([TYPE]::[ATTRIBUTE][index]);\n";
+
+ protected static final String ATTRIBUTE_GET_OBJECT_POINTER_TEMPLATE =
+ "\n[TYPE]* nativeObject = ([TYPE]*)this_addr;\n" +
+ "[CONST][ATTRIBUTE_TYPE]* attr = nativeObject->[ATTRIBUTE];\n" +
+ "return (int64_t)attr;\n";
+
+ protected static final String ATTRIBUTE_ARRAY_GET_OBJECT_POINTER_TEMPLATE =
+ "\n[TYPE]* nativeObject = ([TYPE]*)this_addr;\n" +
+ "[CONST][ATTRIBUTE_TYPE]* attr = (nativeObject->[ATTRIBUTE][index]);\n" +
+ "return (int64_t)attr;\n";
+
+ protected static final String ATTRIBUTE_GET_PRIMITIVE_STATIC_TEMPLATE =
+ "\nreturn [TYPE]::[ATTRIBUTE];\n";
+
+ protected static final String ATTRIBUTE_ARRAY_GET_PRIMITIVE_STATIC_TEMPLATE =
+ "\nreturn [TYPE]::[ATTRIBUTE][index];\n";
+
+ protected static final String ATTRIBUTE_GET_PRIMITIVE_TEMPLATE =
+ "\n[TYPE]* nativeObject = ([TYPE]*)this_addr;\n" +
+ "return [CAST]nativeObject->[ATTRIBUTE];\n";
+
+ protected static final String ATTRIBUTE_ARRAY_GET_PRIMITIVE_TEMPLATE =
+ "\n[TYPE]* nativeObject = ([TYPE]*)this_addr;\n" +
+ "return [CAST]nativeObject->[ATTRIBUTE][index];\n";
+
+ // --- Method templates ---
+
+ protected static final String METHOD_GET_OBJ_VALUE_TEMPLATE =
+ "\n[TYPE]* nativeObject = ([TYPE]*)this_addr;\n" +
+ "static [COPY_TYPE] [COPY_PARAM];\n" +
+ "[COPY_PARAM] = nativeObject->[METHOD];\n" +
+ "return (int64_t)&[COPY_PARAM];";
+
+ protected static final String METHOD_GET_OBJ_VALUE_ARITHMETIC_OPERATOR_TEMPLATE =
+ "\n[TYPE]* nativeObject = ([TYPE]*)this_addr;\n" +
+ "static [COPY_TYPE] [COPY_PARAM];\n" +
+ "[COPY_PARAM] = [OPERATOR];\n" +
+ "return (int64_t)&[COPY_PARAM];";
+
+ protected static final String METHOD_GET_OBJ_VALUE_STATIC_TEMPLATE =
+ "\nstatic [COPY_TYPE] [COPY_PARAM];\n" +
+ "[COPY_PARAM] = [TYPE]::[METHOD];\n" +
+ "return (int64_t)&[COPY_PARAM];";
+
+ protected static final String METHOD_CALL_VOID_STATIC_TEMPLATE =
+ "\n[TYPE]::[METHOD];\n";
+
+ protected static final String METHOD_CALL_VOID_TEMPLATE =
+ "\n[TYPE]* nativeObject = ([TYPE]*)this_addr;\n" +
+ "nativeObject->[METHOD];\n";
+
+ protected static final String METHOD_GET_OBJ_POINTER_STATIC_TEMPLATE =
+ "\nreturn (int64_t)[TYPE]::[METHOD];\n";
+
+ protected static final String METHOD_GET_OBJ_POINTER_TEMPLATE =
+ "\n[TYPE]* nativeObject = ([TYPE]*)this_addr;\n" +
+ "[CONST][RETURN_TYPE]* obj = nativeObject->[METHOD];\n" +
+ "return (int64_t)obj;\n";
+
+ protected static final String METHOD_GET_OBJ_POINTER_OPERATOR_TEMPLATE =
+ "\n[TYPE]* nativeObject = ([TYPE]*)this_addr;\n" +
+ "[CONST][RETURN_TYPE]* obj = [OPERATOR];\n" +
+ "return (int64_t)obj;\n";
+
+ protected static final String METHOD_GET_REF_OBJ_POINTER_STATIC_TEMPLATE =
+ "\nreturn (int64_t)&[TYPE]::[METHOD];\n";
+
+ protected static final String METHOD_GET_REF_OBJ_POINTER_TEMPLATE =
+ "\n[TYPE]* nativeObject = ([TYPE]*)this_addr;\n" +
+ "return (int64_t)&nativeObject->[METHOD];\n";
+
+ protected static final String METHOD_GET_REF_OBJ_POINTER_OPERATOR_TEMPLATE =
+ "\n[TYPE]* nativeObject = ([TYPE]*)this_addr;\n" +
+ "return (int64_t)&[OPERATOR];\n";
+
+ protected static final String METHOD_GET_PRIMITIVE_STATIC_TEMPLATE =
+ "\nreturn [CAST][TYPE]::[METHOD];\n";
+
+ protected static final String METHOD_GET_PRIMITIVE_TEMPLATE =
+ "\n[TYPE]* nativeObject = ([TYPE]*)this_addr;\n" +
+ "return [CAST]nativeObject->[METHOD];\n";
+
+ protected static final String METHOD_GET_PRIMITIVE_OPERATOR_TEMPLATE =
+ "\n[TYPE]* nativeObject = ([TYPE]*)this_addr;\n" +
+ "return ([OPERATOR]);";
+
+ protected static final String ENUM_GET_INT_TEMPLATE =
+ "\nreturn (int64_t)[ENUM];\n";
+
+ private final FFMNativeCodeGenerator cppGenerator;
+ private final FFMMethodHandleRegistry registry = new FFMMethodHandleRegistry();
+
+ public FFMCodeParser(FFMNativeCodeGenerator cppGenerator, String cppDir) {
+ this(cppGenerator, null, "", cppDir);
+ }
+
+ public FFMCodeParser(FFMNativeCodeGenerator cppGenerator, IDLReader idlReader, String basePackage, String cppDir) {
+ super(basePackage, HEADER_CMD, idlReader, cppDir);
+ this.cppGenerator = cppGenerator;
+ }
+
+ // ==================== IDL Generation Hooks ====================
+
+ @Override
+ public void onIDLConstructorGenerated(JParser jParser, IDLConstructor idlConstructor,
+ ClassOrInterfaceDeclaration classDeclaration,
+ ConstructorDeclaration constructorDeclaration,
+ MethodDeclaration nativeMethodDeclaration) {
+ IDLClass idlClass = idlConstructor.idlClass;
+ String classTypeName = idlClass.getCPPName();
+
+ NodeList