HawtJNI
Description
HawtJNI is a code generator that produces the JNI code needed to implement java native methods. It is based on the jnigen code generator that is part of the SWT Tools project which is used to generate all the JNI code which powers the eclipse platform.
Features
- jni code generated from annotations on your java code
- maven integration
Synopsis
There are many open source JNI code generators available, but if your performance sensitive, the code generator used by the eclipse SWT project is by far the best option. The biggest problem is that it was not developed to be reused by other projects. It was tightly coupled to producing the SWT jni libraries and it could only be run within the eclipse platform.
HawtJNI takes that code generator and makes it more generally accessible to any project.
Example Usage
Your JNI methods must be defined as static native methods in a class annotated with @JniClass
. The following example will expose the C open
function as a java
method:
@JniClass
public class Platform {
public static native long open (String file, int flags, int mode);
}
You will also need to tell the JVM to load the native library when your class is loaded. You can do this using the standard System.loadLibrary
method:
@JniClass
public class Platform {
static {
System.loadLibrary("hawtjni-example");
}
public static native long open (String file, int flags, int mode);
}
If you want to bundle the native library in as a resource of your jar, so that
it can be automatically unpacked if it cannot be be found in your java
library path. Then a better option is to use the Library
helper class
that HawtJNI provides:
@JniClass
public class Platform {
private static Library library = new Library("hawtjni-example", 1, 0, 0);
static {
library.load();
}
public static native long open (String file, int flags, int mode);
}
To generate the JNI code, first compile your annotated class, then use the
hawtjni-generate.jar
runnable jar as follows:
java -jar hawtjni-generate.jar -o target/native target/classes
The above example expects your compiled java classes to be in the target/classes
directory. The generated JNI classes will be placed in the target/native
directory.
Readme TODO
- Need to explain/show examples of struct handling
- Need to explain/show examples of 32/64 bit variable types
- Show the maven plugin
- Show the OSX cocoa native code generation tool