native关键字仅作声明标记,告知jvm该方法实现在本地库中;真正调用由jvm通过jni加载libxxx.so/xxx.dll并绑定符合java_com_pkg_class_method命名规范的c函数完成。

Java 中的 native 关键字本身不执行任何调用,它只是一个声明标记——告诉 JVM:“这个方法的实现不在 Java 里,去动态库中找”。真正完成调用的是 JVM 在运行时通过 JNI(Java Native Interface)机制,加载并绑定对应 C/C++ 函数的过程。
native 方法怎么声明和准备
在 Java 类中用 native 修饰方法,不写大括号,以分号结尾;同时必须通过 System.loadLibrary("xxx") 加载同名动态库(如 libxxx.so 或 xxx.dll):
- 类名、方法名、包路径共同决定底层函数名,例如
com.example.Calc.add()对应 C 函数名Java_com_example_Calc_add - 用
javac -h . YourClass.java生成标准头文件(含正确函数签名和 JNI 类型,如jint、jstring) - 静态代码块中调用
loadLibrary,确保类初始化时库已就绪
C 端函数怎么写才被 JVM 找到
JVM 不靠函数名“匹配”,而是靠严格命名 + 符号导出 + 动态库加载路径三者协同。C 实现必须满足:
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 函数名完全符合 JNI 命名规范(包名中点号换成下划线,类名/方法名首字母大写)
- 参数列表第一项是
JNIEnv*,第二项是jobject(非 static 方法)或jclass(static 方法),后续才是 Java 方法的原始参数 - 包含
<jni.h></jni.h>头文件,并链接 JDK 提供的 JNI 接口
动态库怎么编译和加载
生成的 C 文件要编译成平台对应的动态链接库,且名称必须与 loadLibrary 参数一致:
- Linux:用
gcc -shared -fPIC -I$JAVA_HOME/include -I$JAVA_HOME/include/linux xxx.c -o libxxx.so - Windows:用 MSVC 或 MinGW 编译为
xxx.dll,注意位数(32/64)与 JVM 一致 - 运行时确保库在系统路径(
LD_LIBRARY_PATH/PATH)或使用System.load("/absolute/path/xxx.so")指定全路径
调用过程中关键注意事项
看似简单的一次 obj.method(),背后涉及跨语言边界的数据转换与生命周期管理:
-
jstring不能直接当 C 字符串用,需调用(*env)->GetStringUTFChars(env, jstr, NULL)转换,用完必须ReleaseStringUTFChars - 本地代码抛异常不能用 C 的
assert或exit,要用(*env)->ThrowNew(env, cls, msg),然后立即 return - 避免在 native 方法中长期持有
jobject引用,如需跨调用保存,应转为全局引用NewGlobalRef
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










