CoralCpp

Call Java from C++ and C++ from Java with a variety of old and new projects like JNI, JNA, JNR, FFM, JExtract, BridJ, GraalVM, JNI-Bind, etc.

This project is intended to be used as a quick reference on how to get going with Java and C++ integration, from both sides. It is a step-by-step guide, in the form of shell scripts (for Linux and MacOS) to compile and run the C++ and Java examples, so you don't have to guess anything. Just see "Hello World!" popping up in your terminal to celebrate! 🍾 🎉 🎊

Feel free to use our official Docker image for Linux/arm64 available on DockerHub

MacOS

$ uname -a; sw_vers | grep ProductVersion; arch
Darwin MacBook-Air.local 22.6.0 Darwin Kernel Version 22.6.0: Wed Jul  5 22:17:35 PDT 2023; root:xnu-8796.141.3~6/RELEASE_ARM64_T8112 arm64
ProductVersion:		13.5.2
arm64

$ java -version
java version "23.0.1" 2024-10-15
Java(TM) SE Runtime Environment Oracle GraalVM 23.0.1+11.1 (build 23.0.1+11-jvmci-b01)
Java HotSpot(TM) 64-Bit Server VM Oracle GraalVM 23.0.1+11.1 (build 23.0.1+11-jvmci-b01, mixed mode, sharing)

$ clang++ --version
Homebrew clang version 18.1.8
Target: arm64-apple-darwin22.6.0
Thread model: posix
InstalledDir: /opt/homebrew/opt/llvm@18/bin

$ native-image --version
native-image 23.0.1 2024-10-15
GraalVM Runtime Environment Oracle GraalVM 23.0.1+11.1 (build 23.0.1+11-jvmci-b01)
Substrate VM Oracle GraalVM 23.0.1+11.1 (build 23.0.1+11, serial gc, compressed references)

$ jextract --version
jextract 22
JDK version 22+35-2369
LibClang version clang version 13.0.0

Linux

$ (uname -a; cat /etc/issue; arch) | grep -v '^$'
Linux 2d4c02259081 4.15.0-188-generic #199-Ubuntu SMP Wed Jun 15 20:42:56 UTC 2022 x86_64 x86_64 x86_64 GNU/Linux
Ubuntu 22.04.5 LTS \n \l
x86_64

$ java -version
java version "23.0.1" 2024-10-15
Java(TM) SE Runtime Environment Oracle GraalVM 23.0.1+11.1 (build 23.0.1+11-jvmci-b01)
Java HotSpot(TM) 64-Bit Server VM Oracle GraalVM 23.0.1+11.1 (build 23.0.1+11-jvmci-b01, mixed mode, sharing)

$ clang++ --version
Ubuntu clang version 18.1.8 (++20240731024944+3b5b5c1ec4a3-1~exp1~20240731145000.144)
Target: x86_64-pc-linux-gnu
Thread model: posix
InstalledDir: /usr/bin

$ native-image --version
native-image 23.0.1 2024-10-15
GraalVM Runtime Environment Oracle GraalVM 23.0.1+11.1 (build 23.0.1+11-jvmci-b01)
Substrate VM Oracle GraalVM 23.0.1+11.1 (build 23.0.1+11, serial gc, compressed references)

$ jextract --version
jextract 22
JDK version 22+35-2369
LibClang version clang version 13.0.0

Java calling C++

JNI

• Check the Java code
• Check the C++ code

MacOS

• Compile the Java code
• Compile the C++ code
• Run the Java code

# For Mac
$ ./bin/mac/jni/all.sh 2 Awesome
Hello CoralBlocks from JNI! => Awesome
Hello CoralBlocks from JNI! => Awesome

Linux

• Compile the Java code
• Compile the C++ code
• Run the Java code

# For Linux
$ ./bin/linux/jni/all.sh 2 Awesome
Hello CoralBlocks from JNI! => Awesome
Hello CoralBlocks from JNI! => Awesome

JNA

• Check the Java code
• Check the C++ code

MacOS

• Compile the Java code
• Compile the C++ code
• Run the Java code

# For Mac
$ ./bin/mac/jna/all.sh 2 Awesome
Hello CoralBlocks from JNA! => Awesome
Hello CoralBlocks from JNA! => Awesome

Linux

• Compile the Java code
• Compile the C++ code
• Run the Java code

# For Linux
$ ./bin/linux/jna/all.sh 2 Awesome
Hello CoralBlocks from JNA! => Awesome
Hello CoralBlocks from JNA! => Awesome

JNR

• Check the Java code
• Check the C++ code

MacOS

• Compile the Java code
• Compile the C++ code
• Run the Java code

# For Mac
$ ./bin/mac/jnr/all.sh 2 Awesome
Hello CoralBlocks from JNR! => Awesome
Hello CoralBlocks from JNR! => Awesome

Linux

• Compile the Java code
• Compile the C++ code
• Run the Java code

# For Linux
$ ./bin/linux/jnr/all.sh 2 Awesome
Hello CoralBlocks from JNR! => Awesome
Hello CoralBlocks from JNR! => Awesome

FFM

• Check the Java code
• Check the C++ code

MacOS

• Compile the Java code
• Compile the C++ code
• Run the Java code

# For Mac
$ ./bin/mac/ffm/all.sh 2 Awesome
Hello CoralBlocks from FFM! => Awesome
Hello CoralBlocks from FFM! => Awesome

Linux

• Compile the Java code
• Compile the C++ code
• Run the Java code

# For Linux
$ ./bin/linux/ffm/all.sh 2 Awesome
Hello CoralBlocks from FFM! => Awesome
Hello CoralBlocks from FFM! => Awesome

JExtract

• Check the Java code
• Check the C++ header
• Check the C++ code

MacOS

• Compile the C++ code
• Generate the Java code
• Compile the Java code
• Run the Java code

# For Mac
$ ./bin/mac/ffm_jextract/all.sh 2 Awesome
Hello CoralBlocks from JExtract! => Awesome
Hello CoralBlocks from JExtract! => Awesome

Linux

• Compile the C++ code
• Generate the Java code
• Compile the Java code
• Run the Java code

# For Linux
$ ./bin/linux/ffm_jextract/all.sh 2 Awesome
Hello CoralBlocks from JExtract! => Awesome
Hello CoralBlocks from JExtract! => Awesome

BridJ

• Check the Java code
• Check the C++ code

MacOS

• Compile the Java code
• Compile the C++ code
• Run the Java code

# For Mac
$ ./bin/mac/bridj/all.sh 2 Awesome
Hello CoralBlocks from BridJ! => Awesome
Hello CoralBlocks from BridJ! => Awesome

Linux

• Compile the Java code
• Compile the C++ code
• Run the Java code

# For Linux
$ ./bin/linux/bridj/all.sh 2 Awesome
Hello CoralBlocks from BridJ! => Awesome
Hello CoralBlocks from BridJ! => Awesome

C++ calling Java

JNI

• Check the Java code
• Check the C++ code

MacOS

• Compile the Java code
• Compile the C++ code
• Run the C++ code

# For Mac
$ ./bin/mac/jni_jvm/all.sh 2 Awesome
Hello CoralBlocks from JNI-JVM! => Awesome
Hello CoralBlocks from JNI-JVM! => Awesome

Linux

• Compile the Java code
• Compile the C++ code
• Run the C++ code

# For Linux
$ ./bin/linux/jni_jvm/all.sh 2 Awesome
Hello CoralBlocks from JNI-JVM! => Awesome
Hello CoralBlocks from JNI-JVM! => Awesome

GraalVM

• Check the Java code
• Check the C++ code

MacOS

• Compile the Java code
• Generate the native image
• Compile the C++ code
• Run the C++ code

# For Mac
$ ./bin/mac/graal/all.sh 2 Awesome
Hello CoralBlocks from GraalVM Native-Image! => Awesome
Hello CoralBlocks from GraalVM Native-Image! => Awesome

Linux

• Compile the Java code
• Generate the native image
• Compile the C++ code
• Run the C++ code

# For Linux
$ ./bin/linux/graal/all.sh 2 Awesome
Hello CoralBlocks from GraalVM Native-Image! => Awesome
Hello CoralBlocks from GraalVM Native-Image! => Awesome

C++ calling Java which calls back C++

JNI

• Check the Java code
• Check the C++ code that calls Java
• Check the C++ code that receives the callbacks from Java
• Check the C++ code header file for the C++ code above

MacOS

• Compile the Java code
• Compile the C++ code
• Run the C++ code

# For Mac
$ ./bin/mac/jni_callback/all.sh 2
Received callback from Java: 1683119040946
Received callback from Java: 1683119040947
Join returned, exiting C++ code...

Linux

• Compile the Java code
• Compile the C++ code
• Run the C++ code

# For Linux
$ ./bin/linux/jni_callback/all.sh 2
Received callback from Java: 1683119062956
Received callback from Java: 1683119062957
Join returned, exiting C++ code...

Java calling C++ which calls Java

JNI-BIND

• Check the Java code
• Check the C++ code

MacOS

• Compile the Java code
• Compile the C++ code
• Run the Java code

# For Mac
$ ./bin/mac/jni_bind/all.sh 2 Awesome
Hello CoralBlocks from JNI-Bind! => Awesome
Hello CoralBlocks from JNI-Bind! => Awesome

Linux

NOTE: For Linux make sure you have libc++-dev and libc++abi-dev installed.

    sudo apt-get install libc++-dev libc++abi-dev

• Compile the Java code
• Compile the C++ code
• Run the Java code

# For Linux
$ ./bin/linux/jni_bind/all.sh 2 Awesome
Hello CoralBlocks from JNI-Bind! => Awesome
Hello CoralBlocks from JNI-Bind! => Awesome

Pure JNI x JNI-Bind

Pure JNI:

jclass helloWorldClass = env->FindClass("com/coralblocks/coralcpp/jni_bind/HelloWorld");
jmethodID helloWorldConstructor = env->GetMethodID(helloWorldClass, "<init>", "()V");
jobject helloWorldObj = env->NewObject(helloWorldClass, helloWorldConstructor);
jmethodID sayHelloMethod = env->GetMethodID(helloWorldClass, "sayHello", "(ILjava/lang/String;)V");
env->CallVoidMethod(helloWorldObj, sayHelloMethod, x, msg);

JNI-Bind:

static constexpr jni::Class kClass {
    "com/coralblocks/coralcpp/jni_bind/HelloWorld",
    jni::Method {
        "sayHello",
        jni::Return < void > {},
        jni::Params < jint , jstring> {}
    }
};

jni::LocalObject < kClass > helloWorld {}; // Constructs new instance.
helloWorld("sayHello", x, msg);