mirror of
https://github.com/hexedtech/codemp.git
synced 2024-11-22 23:34:49 +01:00
20 lines
1.7 KiB
Markdown
20 lines
1.7 KiB
Markdown
# Java bindings
|
|
`codemp`'s Java bindings are implemented using the [JNI](https://docs.oracle.com/javase/8/docs/technotes/guides/jni/).
|
|
|
|
On the Rust side, all Java-related code is gated behind the `java` feature, and is implemented using[`jni-rs`](https://github.com/jni-rs/jni-rs).
|
|
Unlike other supported languages, Java is statically typed and requires knowing all foreign function types at compile time.
|
|
This means that, to use `codemp` from Java, all functions which will be used must be declared (as `native`), making using our Java binding without extra glue extremely tedious.
|
|
|
|
We provide glue code also on the Java side, wrapping all native calls and defining classes to hold `codemp` types.
|
|
|
|
## Building
|
|
This is a [Gradle](https://gradle.org/) project: building requires having both Gradle and Cargo installed, as well as the JDK (any non-abandoned version).
|
|
Once you have all the requirements, building is as simple as running `gradle build`: the output is going to be a JAR under `build/libs`, which you can import into your classpath with your IDE of choice.
|
|
|
|
## Development
|
|
The Java bindings have no known major quirk. However, here are a list of facts that are useful to know when developing with these:
|
|
|
|
* Memory management is entirely delegated to the JVM's garbage collector.
|
|
* A more elegant solution than `Object.finalize()`, who is deprecated in newer Java versions, may be coming eventually.
|
|
* Exceptions coming from the native side have generally been made checked to imitate Rust's philosophy with `Result`.
|
|
* `JNIException`s are however unchecked: there is nothing you can do to recover from them, as they usually represent a severe error in the glue code. If they arise, it's probably a bug.
|