JAVA通过JNI调用C语言库

重点内容##1.前言

• JDK版本1.8.0
• 操作系统 ubuntu 16.04.4
• 目标实现JAVA调用C语言库

root@msos:/root# java -version
openjdk version "1.8.0_151"
OpenJDK Runtime Environment (build 1.8.0_151-8u151-b12-0ubuntu0.16.04.2-b12)
OpenJDK 64-Bit Server VM (build 25.151-b12, mixed mode)

##2.JNI层说明
###2.1.C语言的JNI封装例程

/*
注意：
    <1>加密狗检测间隔时间为30秒;
    <2>将授权状态将实时打印到/tmp/msauthentstatus文件;
*/
#define MSAUTHENTJNI_C
#include <stdlib.h> 
#include <stdio.h>
#include <string.h> 
#include <unistd.h>
#include <libmscommon/mscommon.h>
#include <libmslog/mslog.h>
#include "msauthent.h" 
#include "jni.h"

#define FLAG  "msauthentjni"
/*库初始化分配资源,一个项目中只需要调用一次即可。*/
 JNIEXPORT void JNICALL Java_jniTest_msauthentjni_init( JNIEnv * env,jobject thiz,jint logopt, jstring pauthent_product_jni) 
 {
	ms_string pauthent_product= (*env)->GetStringUTFChars(env, pauthent_product_jni, ms_null);
	if(pauthent_product == ms_null)  {
		return;  
	}  
	msauthent_oneapi_init(logopt,pauthent_product);
	(*env)->ReleaseStringUTFChars(env, pauthent_product_jni, pauthent_product);
}
/*获取当前授权是否匹配当前产品，是则返回真。*/
JNIEXPORT jint JNICALL Java_jniTest_msauthentjni_isproduct(JNIEnv *env, jobject obj, jstring pnamejni)  
{
	ms_string pname= (*env)->GetStringUTFChars(env, pnamejni, ms_null);
	if(pname == ms_null)  {
		return ms_false;  
	}  
	ms_bool isproduct=msauthent_oneapi_isproduct(pname);
	(*env)->ReleaseStringUTFChars(env, pnamejni, pname);
	return isproduct;
	
}  
//获取授权连接数。当授权无效或超时时，返回默认值2
 JNIEXPORT jboolean JNICALL Java_jniTest_msauthentjni_getconnect( JNIEnv * env,jobject thiz,jint debug) 
 {
	int connect=msauthent_oneapi_getconnect(debug);
	return  connect;
}
//获取授权总天数，目前仅用于显示
 JNIEXPORT jint JNICALL Java_jniTest_msauthentjni_getvaliddays( JNIEnv * env,jobject thiz,jint debug) 
 {
	int validdays=msauthent_oneapi_getvaliddays(debug);
	return  validdays;
}
//获取授权剩余时间，单位小时，目前仅用于显示
 JNIEXPORT jint JNICALL Java_jniTest_msauthentjni_getreshours( JNIEnv * env,jobject thiz,jint debug) 
 {
	int reshours=msauthent_oneapi_getreshours(debug);
	return  reshours;
}
//库注销释放资源,一个项目中只需要调用一次
 JNIEXPORT void JNICALL Java_jniTest_msauthentjni_deinit( JNIEnv * env,jobject thiz) 
 {
	msauthent_oneapi_deinit();
}

#undef MSAUTHENTJNI_C

###2.2.编译命令

gcc  src/msauthentjni.c  -DOS_LINUX_X64 -Isrc `pkg-config --cflags libmslog` `pkg-config --cflags libmscommon` `pkg-config --cflags libmstool` `pkg-config --libs libmslog` `pkg-config --libs libmscommon` `pkg-config --libs libmstool` -shared -fPIC -I/usr/lib/jdk/jdk1.8.0_161/include -I/usr/lib/jdk/jdk1.8.0_161/include/linux  `pkg-config --libs libmsauthent` `pkg-config --cflags libmsauthent`  -o out/lib/libmsauthentjni.so 

###2.3.格式类型说明

• JNI函数固定格式

  JNIEXPORT  返回值类型   JNICALL java_package_class_nativeapi( JNIEnv * env,jobject thiz,其他参数) ;
  

• java_package_class_nativeapi的格式

  “Java_jniTest_msauthentjni_init”中package为jniTest，class为msauthentjni，而nativeapi为init，即这个函数只能被包名为jniTest中的msauthentjni（class）调用，且函数名为init;（类似的还有Java_jniTest_msauthentjni_getconnect，Java_jniTest_msauthentjni_deinit）
  

• ( JNIEnv * env,jobject thiz,其他参数)的格式：前两个参数必须存在，需要传递的其他参数可扩展;

• JNI类型映射不做过多的描述，只列举几个常用的

   Java		JNI 			C/C++	                               
   boolean     jboolean      	8位整型                           
   byte		jbyte			带符号的8位整型  
   char		jchar			无符号的16位整型                   
   short		jshort			带符号的16位整型             
   int  		jint  			带符号的32位整型               
   long		jlong			带符号的64位整型
   float		jfloat			32位浮点型      
   double		jdouble			64位浮点型 
   String      jstring			字符串对象                               
  

###2.4.特别注意

• 如果传入的参数是jstring类型，必须要进行转换，转换代码参考函数Java_jniTest_msauthentjni_getconnect中的product_num;
• 如果返回值是jstring类型，需要调用(*env)->NewStringUTF(env,tmpstr)进行转换;
• 如果希望传递object，那么可以借助jobject thiz这个参数，这里不再详解;

##3.JAVA层说明
###3.1.JAVA语言调用的JNI例程

package jniTest;

public class msauthentjni {
	static {
		System.loadLibrary( "msauthentjni" );
		
	}


	public static native void  init( int logopt,String authent_product); 
	public static native boolean   isproduct(String name);
	public static native int   getconnect(int debug);
	public static native int   getvaliddays(int debug);
	public static native int   getreshours(int debug);
	public static native void  deinit(); 
	public static void main(String[] args) {
		// TODO Auto-generated method stub
		init(52,"msdx_edu");	//一个项目中只能调用一次

		boolean isproduct=isproduct("MS-DXEDU");
		if(true==isproduct) {
			System.out.print("------------right product\r\n");
			int validdays=getvaliddays(0);
			int reshours=getreshours(0);
			int connect=getconnect(0);
			System.out.print("------------connect:"+connect+",validdays:"+validdays+",reshours:"+reshours+"\r\n");
		}else {
			System.out.print("------------Unknow product\r\n");
		}
		deinit();	//一个项目中只能调用一次
	}
}

###3.2.说明

• 库的加载使用System.loadLibrary( “msauthentjni” )，只需要加载最直接的库即可;
• 对于nativeapi为init的调用，完全吻合2.3所述
  ##4. 错误列表
  ###4. 1.环境错误，错误信息如下

`Exception in thread "main" java.lang.UnsatisfiedLinkError: no msauthentjni in java.library.path`
	at java.lang.ClassLoader.loadLibrary(ClassLoader.java:1867)
	at java.lang.Runtime.loadLibrary0(Runtime.java:870)
	at java.lang.System.loadLibrary(System.java:1122)
	`at jniTest.msauthentjni.<clinit>(msauthentjni.java:5)`

问题原因：libmsauthentjni.so库不在ECLIPSE的标准库路进下;
解决方法：将libmsauthentjni.so的库路径（我的是/usr/local/lib/）加入到环境变量LD_LIBRARY_PATH，然后再其中ECLIPSE程序。

`export LD_LIBRARY_PATH=.:$LD_LIBRARY_PATH:/usr/local/lib/`

###4. 2.JNI函数名错误，错误信息如下

`Exception in thread "main" java.lang.UnsatisfiedLinkError: jniTest.msauthentjni.init(I)V
	at jniTest.msauthentjni.init(Native Method)
	at jniTest.msauthentjni.main(msauthentjni.java:15)`

问题原因：jni函数名中的包名或者CLASS和调用的不匹配，详细见本文2.3描述;
解决方法：修改jni函数名中的包名或者CLASS