JNI简介与核心概念
java native interface (jni) 是java平台的一个标准，它允许java代码与其他语言（特别是c/c++）编写的应用程序和库进行交互。通过jni，java虚拟机（jvm）能够调用原生方法，原生方法也能调用java方法，从而实现java应用程序对底层系统功能或现有原生库的访问。
JNI的核心在于定义了一套规范，包括数据类型映射、函数命名约定以及一套用于在原生代码中操作Java对象和调用Java方法的API。为了实现这种互操作性，JNI要求原生方法遵循特定的函数签名和命名规则。
JNI头文件的错误认知与正确生成方式
在JNI开发中，一个常见的误解是试图直接将现有的C语言头文件（如本例中提供的BITMAP.h）适配为JNI头文件。然而，这种做法是错误的，因为JNI头文件具有其特定的结构和宏定义，这些是手动修改难以正确实现和维护的。
例如，提供的BITMAP.h文件定义了一个BITMAP结构体和一系列操作该结构体的函数，如create、close、drawLn等。这些函数签名是标准的C语言风格，不包含任何JNI特有的宏（如JNIEXPORT, JNICALL）或类型（如JNIEnv*, jobject）。因此，这个文件不是一个有效的JNI头文件，不能直接用于JNI开发。
正确的JNI头文件生成流程如下：
-
定义Java native 方法： 首先，在Java类中声明一个或多个native方法。这些方法没有方法体，由native关键字修饰，表示它们的实现将由原生代码提供。
// BitmapProcessor.java public class BitmapProcessor { static { // 加载包含原生实现的共享库 System.loadLibrary("bitmapnative"); } // 声明一个native方法，用于创建位图 public native long nativeCreateBitmap(int width, int height); // 声明一个native方法，用于绘制线条 public native void nativeDrawLine(long bitmapPtr, int x1, int y1, int x2, int y2); // 声明一个native方法，用于关闭位图 public native void nativeCloseBitmap(long bitmapPtr); // 假设这里还有其他Java业务逻辑 }在上述示例中，我们定义了三个native方法。注意，long bitmapPtr在这里被用作一个占位符，用于在Java和C之间传递BITMAP结构体的内存地址（指针）。
-
编译Java类并生成JNI头文件： 使用javac命令的-h选项来编译包含native方法的Java类，并自动生成对应的C/C++头文件。
# 假设BitmapProcessor.java在当前目录 javac -h . BitmapProcessor.java
执行此命令后，javac会在当前目录（或指定的目录）下生成一个名为BitmapProcessor.h的头文件。如果BitmapProcessor在一个包中（例如com.example.jni），那么生成的头文件将位于com/example/jni/BitmapProcessor.h。
-
生成的JNI头文件示例： 自动生成的头文件将包含JNI特有的宏和类型，以及遵循JNI命名约定（Java_包名_类名_方法名）的函数声明。
/* DO NOT EDIT THIS FILE - it is machine generated */ #include
/* Header for class BitmapProcessor */ #ifndef _Included_BitmapProcessor #define _Included_BitmapProcessor #ifdef __cplusplus extern "C" { #endif /* * Class: BitmapProcessor * Method: nativeCreateBitmap * Signature: (II)J */ JNIEXPORT jlong JNICALL Java_BitmapProcessor_nativeCreateBitmap (JNIEnv *, jobject, jint, jint); /* * Class: BitmapProcessor * Method: nativeDrawLine * Signature: (JIIII)V */ JNIEXPORT void JNICALL Java_BitmapProcessor_nativeDrawLine (JNIEnv *, jobject, jlong, jint, jint, jint, jint); /* * Class: BitmapProcessor * Method: nativeCloseBitmap * Signature: (J)V */ JNIEXPORT void JNICALL Java_BitmapProcessor_nativeCloseBitmap (JNIEnv *, jobject, jlong); #ifdef __cplusplus } #endif #endif 这个头文件才是JNI开发中需要的。它包含了JNIEnv*（指向JNI环境的指针）、jobject（Java对象引用）以及Java基本类型对应的JNI类型（如jint对应Java的int，jlong对应Java的long）。
实现JNI原生方法与集成现有C代码
有了生成的JNI头文件后，接下来就可以编写C/C++源文件来实现这些原生方法。在这个实现文件中，我们需要包含生成的JNI头文件，并根据其声明来实现函数。
对于本例中已有的BITMAP.h和.ec文件，正确的做法是：在JNI的C/C++实现文件中，包含由javac -h生成的JNI头文件，同时包含原有的BITMAP.h。然后，在JNI原生方法的实现中，调用BITMAP.h中声明的函数。
// bitmapnative.c (JNI原生实现文件) #include "BitmapProcessor.h" // 包含由javac生成的JNI头文件 #include "BITMAP.h" // 包含原有的C头文件 #include// 用于示例输出 // 实现nativeCreateBitmap方法 JNIEXPORT jlong JNICALL Java_BitmapProcessor_nativeCreateBitmap (JNIEnv *env, jobject obj, jint width, jint height) { printf("C: Creating bitmap with width=%d, height=%d\n", width, height); struct BITMAP *pbmp = create(width, height); // 调用原有的C函数 if (pbmp == NULL) { // 抛出Java异常，如果需要 return 0; } return (jlong)pbmp; // 将C指针转换为jlong返回给Java } // 实现nativeDrawLine方法 JNIEXPORT void JNICALL Java_BitmapProcessor_nativeDrawLine (JNIEnv *env, jobject obj, jlong bitmapPtr, jint x1, jint y1, jint x2, jint y2) { struct BITMAP *pbmp = (struct BITMAP *)bitmapPtr; // 将jlong转换回C指针 if (pbmp != NULL) { printf("C: Drawing line on bitmap %p from (%d,%d) to (%d,%d)\n", pbmp, x1, y1, x2, y2); drawLn(pbmp, x1, y1, x2, y2); // 调用原有的C函数 } else { fprintf(stderr, "C: Error: bitmapPtr is NULL in nativeDrawLine\n"); } } // 实现nativeCloseBitmap方法 JNIEXPORT void JNICALL Java_BitmapProcessor_nativeCloseBitmap (JNIEnv *env, jobject obj, jlong bitmapPtr) { struct BITMAP *pbmp = (struct BITMAP *)bitmapPtr; if (pbmp != NULL) { printf("C: Closing bitmap %p\n", pbmp); close(pbmp); // 调用原有的C函数 } else { fprintf(stderr, "C: Error: bitmapPtr is NULL in nativeCloseBitmap\n"); } }
将bitmapnative.c文件（以及编译后的.ec文件）编译成一个共享库（例如Windows上的.dll，Linux/macOS上的.so/.dylib），然后Java程序就可以通过System.loadLibrary("bitmapnative")来加载并调用这些原生方法了。
总结与注意事项
- JNI头文件是生成的，不是手写的： 始终通过javac -h命令从Java native方法定义中生成JNI头文件。这是确保JNI接口正确性和兼容性的唯一官方途径。
- JNI作为适配层： JNI原生实现文件充当Java和现有C/C++代码之间的适配层。它接收来自Java的调用，将参数转换为C/C++类型，调用底层的C/C++函数，然后将结果（如果需要）转换回Java类型返回。
- 内存管理： 在JNI中，原生代码负责管理其自身分配的内存。如果原生代码创建了资源（如本例中的BITMAP结构体），并且其生命周期需要跨越Java方法调用，则通常会将指向这些资源的指针以jlong的形式返回给Java，由Java代码在适当的时机（例如通过另一个native方法）通知原生代码释放这些资源。
- 错误处理： 原生代码中发生的错误应适当地处理，例如通过JNI API向Java层抛出异常，或者返回错误码。
- 其他Java原生技术： 除了JNI，还有Java Native Access (JNA) 和 Java Bridging (BridJ) 等库，它们提供了更高级别的抽象，允许Java直接调用原生库中的函数，而无需编写JNI C/C++代码。这些技术在某些场景下可以简化开发，但JNI仍然是Java官方提供的标准原生接口。对于需要极致性能控制或与现有C/C++代码深度集成时，JNI是首选。
