JavaJNI调用的完全手册.doc

JNI调用的注意事项2JNI系统一些细节点总结3Java和C之间互相传递字符串7Java和C互操作的异常问题处理9Java与CC+之间通过JNI传递中文字符串9Java: JNI完全手册17JNI使用技巧点滴（二）23JNI部分24Tomcat+jsp+javaBean的例子26JNI调用固有方法30Java基础知识JNI入门介绍（下）32Java调用本地方法(JNI浅谈)38使用JNI的步骤44JAVA与C+:关于JNI中文字符串操作问题总结47Windows 平台上实现 Java 本地方法实用的示例、步骤和准则51例解 VC+ 6.0 实现 JNI58JNI中文处理问题小结63jni的中文字符串处理72JNI中jstring类型与c语言中的字符串的转换74jstring和char*之间的转换方法76用Delphi开发JNI(Java Native Interface)应用(一)77java通过JNI与delphi交互80使用JNI技术实现JAVA程序调用dll83HP-UX下使用JNI访问标准C+程序89JNI调用的注意事项JNI的简单教程网上很多，看看就能够明白，照着操作也基本能够做下来。但是因为大多的教程写的都不够详细，在照着操作时候可能会遇到几个小问题，故开篇时在这里简单总结一下。1. 在C语言环境中编译代码，出现编译错误，类型为找不到jni.h文件。解决方法：在jdk中寻找到jni.h和jni_md.h文件，将这两个文件拷贝到C语言编译器的include目录中。具体的目录可能会跟编译器有关。比如Dev C+中，将其直接拷贝到include目录下即可。2. 在C语言环境中编译代码，出现编译错误，类型为参数错误。解决方法：不能简单的把生成的.h文件中的方法名直接拷贝到.c文件中去，需要加入具体的参数。例如JNIEXPORT void JNICALL Java_testdll (JNIEnv *, jclass, jint)应该更改为JNIEXPORT void JNICALL Java_testdll (JNIEnv * para1, jclass, jint para2)。3. 在Java中调用JNI时候，java.lang.UnsatisfiedLinkError错误发生。解决方法：生成的dll文件放错了位置，所以不能加载dll文件。试试将dll文件放在与class文件同一目录，再试试放在package的根目录。1、建的dll工程里一定要是.c文件。2、一定要是release编译的dll文件，不要用debug生成的。3、javah 时使用完整包名.类名 (重要！)编译举例：调用JNI的Java源文件FpMatch.java 。package com.until.tc;public class FpMatch public static native int FpMatch_TESO(String szReg, String szVer, int nLevel);public FpMatch() /* 载入动态库 */static try System.loadLibrary(FpMatch_TESO_JNI); catch (Exception e) e.printStackTrace();编译说明：javac -d ./ FpMatch.java -d ./ 参数会在当前目录下，依次建立package指定的目录，并把FpMatch.class放在package指定路径下，为下一步的javah做准备。javah -d ./ com.until.tc.FpMatch 增加-d参数才可以生成正确的.h文件。这样JNI调用函数名里才包括了package的路径。JNI系统一些细节点总结一系统环境 2二JNI的简要使用例子 2三JNI调用中考虑的问题 3四JNI中对JAVA传入数据的处理 5五JAVA调用本地接口后的数据处理问题 5六JAVA中的一些小东西 5一系统环境linux操作系统kernel2.4.2，安装j2sdk1.4.0二JNI的简要使用例子下面是一个简单的例子实现打印一句话的功能，但是用的c的printf最终实现。一般提供给java的jni接口包括一个so文件（封装了c函数的实现）和一个java文件（需要调用path的类）。1 JNI的目的是使java方法中能够调用c实现的一些函数，比如以下的java类，就需要调用一个本地函数testjni（一般声明为private native类型），首先需要创建文件weiqiong.java，内容如下：class weiqiongstaticSystem.loadLibrary(testjni);/载入静态库，test函数在其中实现private native void testjni(); /声明本地调用public void test()testjni();public static void main(String args)weiqiong haha = new weiqiong();haha.test();2然后执行javac weiqiong.java，如果没有报错，会生成一个weiqiong.class。3然后执行javah weiqiong，会生成一个文件weiqiong.h文件，其中有一个函数的声明如下：JNIEXPORT void JNICALL Java_weiqiong_testjni(JNIEnv *, jobject);4创建文件testjni.c将上面那个函数实现，内容如下：#include #include JNIEXPORT void JNICALL Java_weiqiong_testjni(JNIEnv *env, jobject obj)printf(haha-go into c!n);5为了生成.so文件，创建makefile文件如下：libtestjni.so:testjni.o makefilegcc -Wall -rdynamic -shared -o libtestjni.so testjni.otestjni.o:testjni.c weiqiong.hgcc -Wall -c testjni.c -I./ -I/usr/java/j2sdk1.4.0/include -I/usr/java/j2sdk1.4.0/include/linuxcl:rm -rf *.o *.so注意：gcc前面是tab空，j2sdk的目录根据自己装的j2sdk的具体版本来写，生成的so文件的名字必须是loadLibrary的参数名前加“lib”。6export LD_LIBRARY_PATH=.，由此设置library路径为当前目录，这样java文件才能找到so文件。一般的做法是将so文件copy到本机的LD_LIBRARY_PATH目录下。7执行java weiqiong，打印出结果：“haha-go into c!”三JNI调用中考虑的问题在首次使用JNI的时候有些疑问，后来在使用中一一解决，下面就是这些问题的备忘：1。 java和c是如何互通的？其实不能互通的原因主要是数据类型的问题，jni解决了这个问题，例如那个c文件中的jstring数据类型就是java传入的String对象，经过jni函数的转化就能成为c的char*。对应数据类型关系如下表：Java 类型 本地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 位void void N/AJNI 还包含了很多对应于不同 Java 对象的引用类型如下图：2。 如何将java传入的String参数转换为c的char*，然后使用?java 传入的String参数，在c文件中被jni转换为jstring的数据类型，在c文件中声明char* test，然后test = (char*)(*env)-GetStringUTFChars(env, jstring, NULL);注意：test使用完后，通知虚拟机平台相关代码无需再访问：(*env)-ReleaseStringUTFChars(env, jstring, test);3. 将c中获取的一个char*的buffer传递给java？这个char*如果是一般的字符串的话，作为string传回去就可以了。如果是含有 的buffer，最好作为bytearray传出，因为可以制定copy的length，如果copy到string，可能到 就截断了。有两种方式传递得到的数据：一种是在jni中直接new一个byte数组，然后调用函数(*env)-SetByteArrayRegion(env, bytearray, 0, len, buffer);将buffer的值copy到bytearray中，函数直接return bytearray就可以了。一种是return错误号，数据作为参数传出，但是java的基本数据类型是传值，对象是传递的引用，所以将这个需要传出的byte数组用某个类包一下，如下：class RetObjpublic byte bytearray;这个对象作为函数的参数retobj传出，通过如下函数将retobj中的byte数组赋值便于传出。代码如下：jclass cls;jfieldID fid;jbyteArray bytearray;bytearray = (*env)-NewByteArray(env,len);(*env)-SetByteArrayRegion(env, bytearray, 0, len, buffer);cls = (*env)-GetObjectClass(env, retobj);fid = (*env)-GetFieldID(env, cls, retbytes, B);(*env)-SetObjectField(env, retobj, fid, bytearray);4。 不知道占用多少空间的buffer，如何传递出去呢？在jni的c文件中new出空间，传递出去。java的数据不初始化，指向传递出去的空间即可。四JNI中对JAVA传入数据的处理1 如果传入的是bytearray的话，作如下处理得到buffer：char *tmpdata = (char*)(*env)-GetByteArrayElements(env, bytearray, NULL);(*env)-ReleaseByteArrayElements(env, bytearray, tmpdata, 0);五JAVA调用本地接口后的数据处理问题1 java得到的数据是String的话，直接处理就可以了。2 得到的如果是bytearray的话，作如下处理：DataInputStream in = new DataInputStream(new ByteArrayInputStream(bytearray);byte byte1 = new byte36;in.read(byte1,0,36);String string = new String(byte1);System.out.println(读出的第一个字段为：+string);六JAVA中的一些小东西1JAVA中常用数据类型转换函数string-byteByte static byte parseByte(String s)byte-stringByte static String toString(byte b)char-stringCharacter static String to String (char c)string-ShortShort static Short parseShort(String s)Short-StringShort static String toString(Short s)String-IntegerInteger static int parseInt(String s)Integer-StringInteger static String tostring(int i)String-LongLong static long parseLong(String s)Long-StringLong static String toString(Long i)String-FloatFloat static float parseFloat(String s)Float-StringFloat static String toString(float f)String-DoubleDouble static double parseDouble(String s)Double-StringDouble static String toString(Double d)2 类的数据类型转换/转换string为intpublic static int stringToInt(String intstr)Integer integer;integer = Integer.valueOf(intstr);return Value();/转换int为stringpublic static String intToString(int value)Integer integer = new Integer(value);return integer.toString();/转换string为floatpublic static float stringToFloat(String floatstr)Float floatee;floatee = Float.valueOf(floatstr);return floatee.floatValue();/转换float为stringpublic static String floatToString(float value)Float floatee = new Float(value);return floatee.toString();/change the string type to the sqlDate typepublic static java.sql.Date stringToDate(String dateStr)return java.sql.Date.valueOf(dateStr);/change the sqlDate type to the string typepublic static String dateToString(java.sql.Date datee)return datee.toString();Java和C之间互相传递字符串Pass a string to/from Java to/from C To Java from C (as seen from the previous How-to) : #include JavaHowTo.h JNIEXPORT jstring JNICALL Java_JavaHowTo_sayHello (JNIEnv *env, jobject obj) return env-NewStringUTF(Hello world); From Java to C : Suppose we have a Java Class public class MyClass public String sayHello() return Hello world From Java; then from C, we want to call the Java sayHello() method which returns a String : JNIEXPORT void JNICALL Java_JavaHowTo_sayHello (JNIEnv *env, jobject obj) const char *str; jclass myclass_class =(jclass) env-NewGlobalRef (env-FindClass (MyClass); / we need the MyClass constructor jmethodID constructorID = env-GetMethodID (myclass_class, , ()V); / and the sayHello() method jmethodID methodID = env-GetMethodID (myclass_class, sayHello, ()Ljava/lang/String;); / instanciate a MyClass object jobject myclass_object = env-NewObject (myclass_class, constructorID); / call the sayHello() method jstring s = (jstring) env-CallObjectMethod (myclass_object, methodID); / convert the Java String to use it in C str = env-GetStringUTFChars(s, 0); printf(%s , str); env-ReleaseStringUTFChars(s, str); The Java JNI wrapper would be class JavaHowTo public native void sayHello(); static System.loadLibrary(javahowto); And finally, to use it public class JNIJavaHowTo public static void main(String args) JavaHowTo jht = new JavaHowTo(); jht.sayHello(); Java和C互操作的异常问题处理Java中需要调用C代码，C代码中反过来又会操作Java中的对象，这就需要在C代码中处理Java操作可能出现的异常。如果不进行处理，一旦发生异常，C代码部分就会直接退出，同时抛给调用它的Java代码一个莫名其妙的错误（可能是一个没有任何意义的Exception）直接看这个错误是无法分析真正的错误原因的。所以C代码中必须要处理这些异常，要么将其抛出，要么忽略掉。下面是专用的JNI函数，可以对异常进行处理。Throw()：丢弃一个现有的异常对象；在固有方法中用于重新丢弃一个异常。ThrowNew()：生成一个新的异常对象，并将其丢弃。ExceptionOccurred()：判断一个异常是否已被丢弃，但尚未清除。ExceptionDescribe()：打印一个异常和堆栈跟踪信息。ExceptionClear()：清除一个待决的异常。FatalError()：造成一个严重错误，不返回。在所有这些函数中，最不能忽视的就是ExceptionOccurred()和ExceptionClear()。大多数JNI函数都能产生异常，而且没有象在Java的try块内的那种语言特性可供利用。所以在每一次JNI函数调用之后，都必须调用ExceptionOccurred()，了解异常是否已被丢弃。若侦测到一个异常，可选择对其加以控制（可能时还要重新丢弃它）。然而，必须确保异常最终被清除。这可以在自己的函数中用ExceptionClear()来实现；若异常被重新丢弃，也可能在其他某些函数中进行。举个最简单的例子，如果调用Java中的方法后出现异常，忽略。jobject objectAttr = (*env)-CallObjectMethod(env, objectDocument, createAttributeMid, stoJstring(env, ABC);/ deal with exceptionexc = (*env)-ExceptionOccurred(env);if(exc) (*env)-ExceptionClear(env); doSomething(); Java与CC+之间通过JNI传递中文字符串Java与C之间通过JNI传递中文字符串简介 本文提供一个具体的实例,说明Java和C之间通过JNI传递含有中文字符串的参数,解决中文乱码问题（双字节或多字节乱码）。本文给出具体的源代码，对源代码进行了解释，C部分提供了 C和C+两种方式实现的完整代码。并且所有代码均在实验环境下测试通过。本文读者须对Java和C(或C+)有一定的基础知识。实验环境Windows XP （或Windows2000）j2sdk1.4.2/j2re1.4.2Microsoft VisualC+6.0安装好j2sdk后需要设置环境变量 CLASSPATH=.;C:j2sdk1.4.2bin;C:j2sdk1.4.2libdt.jar;C:j2sdk1.4.2libtools.jar;C:j2sdk1.4.2libhtmlconverter.jar（j2sdk安装在c:j2sdk1.4.2目录下）源代码及代码说明Java代码：/* javactransfer.java* By dpwu* e-mail：dpwu_*/public class javactransferpublic String hypotenuse(String send_buf,String recv_buf,int errno) return hypotenuse0(send_buf,recv_buf,errno);private native Stringhypotenuse0(String send_buf,String recv_buf,int errno);static System.loadLibrary(javactransfer);/调用dllpublic static void main( String args ) javactransfer obj= new javactransfer(); System.out.println(); System.out.println(); System.out.println( begin!); System.out.println(); System.out.println(); String javasend=发送中文chinese!; System.out.println( java send:+javasend+);String javarecv=obj.hypotenuse(teststr,javasend,1);/javasend传含有中文字符串给C/javarecv接受C含有中的文字符串 System.out.println( java recv:+javarecv+); System.out.println(); System.out.println(); System.out.println( end!); C实现代码为：/* javactransfer.c* By dpwu* e-mail：dpwu_*/#include #include javactransfer.h/通过javah jni javactransfer 生成#include #include stdlib.h#include string.hchar* jstringToWindows( JNIEnv *env, jstring jstr );jstring WindowsTojstring( JNIEnv* env, char* str );JNIEXPORT jstring JNICALL Java_javactransfer_hypotenuse0(JNIEnv *env,jobject obj,jstring send_buf,jstring recv_buf,jint errno)char * Buf_Return;Buf_Return=(char*)malloc(1024); const char * recvtest = jstringToWindows( env, recv_buf );/*上句recvtest接收Java传过来的中文字符串正确,如果改为下句,则出现乱码:const char * recvtest = (*env)-GetStringUTFChars( env,recv_buf,0);*/printf( crecv:%sn , recvtest);sprintf(Buf_Return,接收中文chinese!);printf( nnn c send :%sn , Buf_Return); recv_buf = WindowsTojstring(env ,Buf_Return);/*上句recv_buf传windows本地C中含有中文字符串给Java正确;如果改为下句出现乱码:recv_buf = (*env)-NewStringUTF( env, Buf_Return );*/return recv_buf;char* jstringToWindows( JNIEnv*env, jstring jstr )int length = (*env)-GetStringLength(env,jstr );const jchar* jcstr = (*env)-GetStringChars(env,jstr, 0 );char* rtn = (char*)malloc( length*2+1 );int size = 0;size = WideCharToMultiByte( CP_ACP, 0, (LPCWSTR)jcstr, length, rtn,(length*2+1), NULL, NULL );if( size ReleaseStringChars(env,jstr, jcstr );rtnsize = 0;return rtn;jstring WindowsTojstring( JNIEnv* env, char* str )jstring rtn = 0;int slen = strlen(str);unsigned short* buffer = 0;if( slen = 0 ) rtn = (*env)-NewStringUTF(env,str ); else int length = MultiByteToWideChar( CP_ACP, 0, (LPCSTR)str, slen, NULL, 0 ); buffer = malloc( length*2 + 1 ); if( MultiByteToWideChar( CP_ACP, 0, (LPCSTR)str, slen, (LPWSTR)buffer, length ) 0 ) rtn = (*env)-NewString( env, (jchar*)buffer, length );if( buffer )free( buffer );return rtn;若javactransfer.java,javactransfer.c均放在d:javac目录下，然后执行(此处图片不能上传）javac javactransfer.java :编译java源代码;javah jni javactransfer :生成头文件;cl -Ic:j2sdk1.4.2include -Ic:j2sdk1.4.2includewin32-LD javactransfer.c -Fejavactransfer.dll通过Microsoft Visual C+将C源代码生成dll文件，供java调用。执行结果如下：（此处图片不能上传）执行键入：java javactranfer C+实现代码为:/* javactransfer.cpp* By dpwu* e-mail：dpwu_*/#include #include javactransfer.h/通过javah jni javactransfer 生成#include #include stdlib.h#include string.hchar* jstringToWindows( JNIEnv *env, jstring jstr );jstring WindowsTojstring( JNIEnv* env, char* str );JNIEXPORT jstring JNICALL Java_javactransfer_hypotenuse0(JNIEnv *env,jobject obj,jstring send_buf,jstring recv_buf,jint _tperrno)char * Buf_Return;Buf_Return=(char*)malloc(1024); const char * ctest = jstringToWindows( env, recv_buf );/*如果把上句改为下句，C接收Java字符串时将出现乱码：const char *ctest = (env)-GetStringUTFChars(recv_buf , 0);*/printf( crecv:%sn , ctest);sprintf(Buf_Return,接收中文chinese!);printf( nnn c send :%sn , Buf_Return); recv_buf = WindowsTojstring(env ,Buf_Return);/*上句执行正确,如果把上句换成下句,Java在接收C字符串时出现乱码recv_buf = (env)-NewStringUTF(Buf_Return);*/return recv_buf;char* jstringToWindows( JNIEnv*env, jstring jstr )int length = (env)-GetStringLength(jstr );const jchar* jcstr = (env)-GetStringChars(jstr, 0 );char* rtn = (char*)malloc( length*2+1 );int size = 0;size = WideCharToMultiByte( CP_ACP, 0, (LPCWSTR)jcstr, length, rtn,(length*2+1), NULL, NULL );if( size ReleaseStringChars(jstr, jcstr );rtnsize = 0;return rtn;jstring WindowsTojstring( JNIEnv* env, char* str )jstring rtn = 0;int slen = strlen(str);unsigned short * buffer = 0;if( slen = 0 ) rtn = (env)-NewStringUTF(str ); else int length = MultiByteToWideChar( CP_ACP, 0, (LPCSTR)str, slen, NULL, 0 ); buffer = (unsigned short *)malloc( length*