Need help with hawtjni?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

fusesource
131 Stars 56 Forks Apache License 2.0 291 Commits 18 Opened issues

Description

A JNI code generator based on the JNI generator used by the eclipse SWT project

Services available

!
?

Need anything else?

Contributors list

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.

Maven Central

Features

  • jni code generated from annotations on your java code
  • maven integration

Synopsis

There are many open source JNI code generators available, but if you're 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.

More Docs:

http://fusesource.github.io/hawtjni/documentation/developer-guide.html

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.