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! :champagne: :tada: :confetti_ball:

<pre> Feel free to use our official <a href="https://hub.docker.com/r/coralblocks/coralcpp">Docker image</a> for Linux/arm64 available on DockerHub </pre>

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! => Awesom