本篇结构:
- 简介
- 必备软件
- 使用示例
一、简介
javacpp 是一种替换 JNI、JNA 的开源技术。它提供了在 Java 中高效访问本地 C++ 的方法。JavaCPP 提供了一系列的 Annotation 将 Java 代码映射到C++代码,并使用一个可执行的 jar 包将 C++ 代码转化为可以从JVM内调用的动态链接库文件。
github地址是:https://github.com/bytedeco/javacpp。
二、必备软件
为了正常使用javacpp,需要安装下列软件:
- An implementation of Java SE 7 or newer:
- OpenJDK http://openjdk.java.net/install/ or
- Oracle JDK http://www.oracle.com/technetwork/java/javase/downloads/ or
- IBM JDK http://www.ibm.com/developerworks/java/jdk/
- A C++ compiler, out of which these have been tested:
- GNU C/C++ Compiler (Linux, etc.) http://gcc.gnu.org/
- For Windows x86 and x64 http://mingw-w64.org/
- GNU C/C++ Compiler (Linux, etc.) http://gcc.gnu.org/
- LLVM Clang (Mac OS X, etc.) http://clang.llvm.org/
- Microsoft C/C++ Compiler, part of Visual Studio https://www.visualstudio.com/
- Walkthrough: Compiling a Native C++ Program on the Command Line
三、使用示例
为了调用本地方法,JavaCPP 生成了对应的 JNI 代码,并且把这些代码输入到 C++编译器,用来构建本地库。使用了 Annotations 特性的 Java 代码在运行时会自动调用 Loader.load() 方法从 Java 资源里载入本地库,这里指的资源是工程构建过程中配置好的。
在一个目录下面,新建一个 NativeLibrary.h 文件,定义了一个 c++ 类:
#include <string>
namespace NativeLibrary {
class NativeClass {
public:
const std::string& get_property() { return property; }
void set_property(const std::string& property) { this->property = property; }
std::string property;
};
}
为了完成javaCPP工作,在同目录下定义一个java类如下:
import org.bytedeco.javacpp.*;
import org.bytedeco.javacpp.annotation.*;
@Platform(include="NativeLibrary.h")
@Namespace("NativeLibrary")
public class NativeLibrary {
public static class NativeClass extends Pointer {
static { Loader.load(); }
public NativeClass() { allocate(); }
private native void allocate();
// to call the getter and setter functions
public native @StdString String get_property(); public native void set_property(String property);
// to access the member variable directly
public native @StdString String property(); public native void property(String property);
}
public static void main(String[] args) {
// Pointer objects allocated in Java get deallocated once they become unreachable,
// but C++ destructors can still be called in a timely fashion with Pointer.deallocate()
NativeClass l = new NativeClass();
l.set_property("Hello World!");
System.out.println(l.property());
}
}
当然需要将相应的jar包放到目录中。
然后执行:
javac -cp javacpp.jar NativeLibrary.java // 编译
java -jar javacpp.jar NativeLibrary // 使用一个可执行的 jar 包将 C++ 代码转化为可以从JVM内调用的动态链接库文件,因为我是在linux下执行,所以生成一个linux-x86_64目录,目录下一个libjniNativeLibrary.so文件
java -cp javacpp.jar NativeLibrary // 运行打印Hello World!