当使用到JNI的时候,基本可以肯定Java的平台移植性注定减弱,接下来记录一次使用Java JNI开发的经历。


    关于Java JNI的相关资料参见:

    http://docs.oracle.com/javase/8/docs/technotes/guides/jni/spec/intro.html


    下面是使用JNI常见三种场景:

    1.在Java应用中标准Java类库不支持平台相关的特性

    2.已经存在用其它语言写好的类库,希望通过Java JNI类访问

    3.需要使用低级语言(如汇编)来实现时效性要求很高的一小部分代码


    这次使用JNI属于第2中场景,由于加解密库使用C来实现的,而在Java应用中使用到其加密后的密文数据,所以解密部分需要此库。


    在1和3这两种场景下使用JNI做法相对容易一些,通常先定义好本地方法,然后通过javah生成头文件,接着用其它语言(如C)来实现相应的功能,而2中场景则需要做一些简单的适配,因为类库已经存在,而在Java中定义好的本地方法并不能直接对应类库的具体实现,所以得通过调用已存在的类库中的方法来实现本地方法。


    在开始之前有一个坑先看看:

    

    本地编译好的动态库头信息:

[ enc]$ readelf -a libfdsi.so 
ELF Header:
  Magic:   7f 45 4c 46 02 01 01 00 00 00 00 00 00 00 00 00 
  Class:                             ELF64
  Data:                              2's complement, little endian *******
  Version:                           1 (current)
  OS/ABI:                            UNIX - System V
  ABI Version:                       0
  Type:                              DYN (Shared object file)
  Machine:                           Advanced Micro Devices X86-64

    

    提供方静态库信息:

 

ELF Header:
  Magic:   7f 45 4c 46 02 02 01 00 00 00 00 00 00 00 00 00 
  Class:                             ELF64
  Data:                              2's complement, big endian
  Version:                           1 (current)
  OS/ABI:                            UNIX - System V
  ABI Version:                       0
  Type:                              REL (Relocatable file)
  Machine:                           PowerPC64


   通过对比应该很清楚了,数据存储模式不同。这里需要明确的是环境一致性很重要。


   接下来来从头到尾实现一个Java调用C的一个解密方法。


  1.定义Java的本地方法(DataDecryt.java)

    

package com.cto;

public class DataDecrypt{

    native public static String decrypt(String data);

}


  2.通过javah命令生成头文件(dd.h)

./javah -classpath . -jni -o dd.h com.cto.DataDecrypt

 

/* DO NOT EDIT THIS FILE - it is machine generated */
#include 
/* Header for class com_cto_DataDecrypt */

#ifndef _Included_com_cto_DataDecrypt
#define _Included_com_cto_DataDecrypt
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     com_cto_DataDecrypt
 * Method:    decrypt
 * Signature: (Ljava/lang/String;)Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_com_cto_DataDecrypt_decrypt
  (JNIEnv *, jclass, jstring);

#ifdef __cplusplus
}
#endif
#endif


  3.定义使用静态库中的方法的头文件(dec.h)

#ifndef __DEC__
#define _DEC__

#ifdef __cplusplus
extern "C"{
#endif

  int ts_comm_dec(const char* in , int inlen, char* out, int* outlen);

#ifdef __cplusplus
}
#endif
#endif

    ts_comm_dec方法即为已经实现了的解密方法。


 4.创建实现dd.h头文件方法的cto.c文件,cto.c中将调用ts_common_dec方法

 

#include 
#include 
#include "dec.h"
#include "dd.h"

//about JNI http://doc.oracle.com/javase/1.5.0/docs/guide/jni/spec/functions.html
JNIEXPORT jstring JNICALL Java_com_cto_DataDecrypt_decrypt
  (JNIEnv *env, jclass jc, jstring data){

  char out_str[48];

  const char *enc_str = (*env)->GetStringUTFChars(env, data, 0);
  const jsize  enc_len = (*env)->GetStringUTFLength(env, data);

  int  out_len = sizeof(out_str);

  ts_comm_dec(enc_str, enc_len, out_str, &out_len);

  jstring plain_text = (*env)->NewStringUTF(env, out_str);

  (*env)->ReleaseStringUTFChars(env, data, enc_str);

  return plain_text;
}


 5.编写测试用例(TestDataDecrypt.java)

   这里加载的类库cto即为libcto.so。关于动态库静态库命名规则可百度之。

package com.cto;
import com.cto.DataDecrypt;

public class TestDataDecrypt{

    static {
         System.loadLibrary("cto");
    }

    public static void main(String [] args){
        String plainText= DataDecrypt.decrypt(args[0]);

        System.out.println(plainText);
        System.out.println("解密之后的长度是:"+plainText.length());
    }
}


 6.编译动态库

 

gcc cto.c -shared -fPIC -lstdc++  -I~/soft/jdk1.6.0_45/include -I~/soft/jdk1.6.0_45/include/linux -I~/native/enc  libtsbase.a  -o libcto.so


 7.运行测试


./java -cp . -Djava.library.path=. com.cto.TestDataDecrypt Qt96BsMOKGjZ0oiqqhRqcA==               
13********1
解密之后的长度是:11

  解密后的结果和预期一致。


8.需要注意的事项

  命令:javac java javah是同一版本,有时候可能系统中有多个版本的JDK

  权限:从其它地方复制的文件,需要确认读写执行权限

  其它:即便按照文中方法来,同样会遇到各种各样的问题,需要多多查看和发现