本章的内容是JNI(Java Native Interface)，即从Java中访问本地方法（其他语言）。
1、当需要在Java中嵌入其他语言编写的代码，如C时，后者称为本地代码。
2、一般来说，Java虽然在单纯运算方面效率慢于C等，但这往往不是性能瓶颈。例如密码运算在某C/S中占用的时间为10%，网络、I/O速度占90%，用C比Java快两倍，则speedup只有1+0.1*2=1.2，只提升了20%（阿姆达尔定律）。
3、当然，如果项目是遗留的，之前已经有了大量，无法被迁移的C++代码时，也只能使用JNI了。
4、Java平台提供了用于和本地C代码进行交互，称为Java本地接口(JNI)。注意：JNI不支持Java类与C++类之间的任何映射！即使你用C++编写代码，也只能使用它的C子集！
5、下面是一个很俗的例子，你已经猜到了。。。Hello JNI。。。
(1) 在Java中先定义好需要JNI的函数，使用关键词native，这里的static是无所谓的，只是这个例子偷懒而已。
public class JNITest {
public static native void Hello();
}
(2)然后需要根据上述的.java文件生成.h文件，规则很复杂哦~
(a)函数名规则：包名_类名_函数名
(b)如果有重载，需要加__然后编号
(c) 如果有非UTF-8字符，还需要用xxxx代替。
好吧，不会有人这么自虐的，Java为我们提供了自动生成.h头的方法，两步搞定：
javac ./JNITest.java javah JNITest
然后就多出这么一个文件：JNITest.h
/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class JNITest */
#ifndef _Included_JNITest
#define _Included_JNITest
#ifdef __cplusplus
extern "C" {
#endif
/*
* Class: JNITest
* Method: Hello
* Signature: ()V
*/
JNIEXPORT void JNICALL Java_JNITest_Hello
(JNIEnv *, jclass);
#ifdef __cplusplus
}
#endif
#endif
(3)然后，我们就可以用这个头文件做为函数原型，编写.c了~
#include "JNITest.h"
#include <stdio.h>
JNIEXPORT void JNICALL Java_JNITest_Hello
(JNIEnv * env, jclass cl) {
printf("Hello, JNI!!\n");
}
(4)编译.so，注意要include两个目录，还要注意生成的so的文件名 lib类名.so
gcc -I/usr/lib/jvm/java-6-sun/include/ -I/usr/lib/jvm/java-6-sun/include/linux/ -fPIC -shared -o libJNITest.so ./JNITest.c
(5)最后在Java代码中，还要加入LoadLibrary：
public class JNITest {
public static native void Hello();
static {
System.loadLibrary("JNITest");
}
public static void main(String[] args) {
Hello();
}
}
(6)运行的时候，需要：
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:.
或者：
java -Djava.library.path=. JNITest
我比较喜欢后面这种方法，恩。
至此，就结束了这个恶俗的例子。。
结果是：
liheyuan@liheyuan-desktop:src$ java -Djava.library.path=. JNITest Hello, JNI!!
6、由于Java中类型的长度是定的，int就是4字节,long就是8字节，但是C可不是啊亲。。于是，一些映射类型出现了：
jint：4字节，jlong：8字节，jfloat：4字节，jdouble：8字节。
jboolean：1字节，jbyte：1字节，jchar：2字节，jshort：2字节。
7、下面的例子是Java调用C实现加法，主要是演示参数传递。
Java的代码：
public class JNITest {
public static native double Add(int a, double b);
static {
System.loadLibrary("JNITest");
}
public static void main(String[] args) {
System.out.println(Add(10, 2.5));
}
}
.c的代码：
#include "JNITest.h"
//#include <stdio.h>
JNIEXPORT jdouble JNICALL Java_JNITest_Add
(JNIEnv * env, jclass cls, jint a, jdouble b) {
jdouble res = a + b;
return res;
}
8、JNI中访问字符串略麻烦，下面是一个向Java返回字符串的例子：
JNIExport jstring JNICALL Java_JniTest_GeString(JNIEnv* env, jclass cl) {
jstring jstr;
char greeting[] = "Hello, JNI!\n";
jstr = (*env)->NewStringUTF(env, greeting);
return jstr;
}
上面这个env是函数指针，不是对象哦！
9、如果要反着来，即从C中访问Java的String，需要用GetStringUTFChars或者ReleaseStringUTFChars。
10、虽然C不是OO的，但也可以在JNI代码中访问Java的对象(和之中的实例域)，这时就不能用static修饰父了。
11、对象在JNI代码中是jobject类型。
接口封装的比较复杂，步骤是：
(1) GetObjectClass 这只是一个临时引用，旨在方法返回前有效，因此不能直接在class中赋值！它不会返回给Java的。
(2) GetFieldID，这时要指定上面获得的obj、域名、域的数据类型缩写(如Double是D)
(3) GetXXXField() XXX是域类型
(4) SetXXXField() XXX是域类型
12、如果不想每次执行时都调用一次GetObjectClass，可以用NewGlobalRef锁定对象，但还需要DeleteGlobalRef来释放对象。
13、下面是访问对象的实例域的例子：
Java还算正常，只不过JNI函数头不再是static的了。
public class JNITest {
public JNITest(double salary) {
this.salary = salary;
}
public native void raiseSalary(double precent);
public String toString() {
return "Salary: " + Double.toString(salary);
}
private double salary;
static {
System.loadLibrary("JNITest");
}
public static void main(String[] args) {
JNITest jt = new JNITest(2700.0F);
System.out.println(jt);
// Call JNI to raise salary
jt.raiseSalary(5.00F);
System.out.println(jt);
}
}
C的代码要注意：GetObjectClass获得的cls，只是为了获得FieldID，而SetXXXField和GetXXXField都是在obj上操作的，要分清楚！
#include "JNITest.h"
JNIEXPORT void JNICALL Java_JNITest_raiseSalary
(JNIEnv * env, jobject this_obj, jdouble precent) {
// Get Object
jclass cls = (*env)->GetObjectClass(env, this_obj);
// Get FieldID
jfieldID id_salary = (*env)->GetFieldID(env, cls, "salary", "D");
// Get Field
jdouble salary = (*env)->GetDoubleField(env, this_obj, id_salary);
printf("%lf\n", salary);
// Raise salary
salary *= (1+precent/100);
// Set Field
(*env)->SetDoubleField(env, this_obj, id_salary, salary);
}
再来看一下头问件：
/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class JNITest */
#ifndef _Included_JNITest
#define _Included_JNITest
#ifdef __cplusplus
extern "C" {
#endif
/*
* Class: JNITest
* Method: raiseSalary
* Signature: (D)V
*/
JNIEXPORT void JNICALL Java_JNITest_raiseSalary
(JNIEnv *, jobject, jdouble);
#ifdef __cplusplus
}
#endif
#endif
14、访问静态域与上面类似，区别是：
(1)需要用GetStaticFieldID、GetStaticXXXField、SetStaticXXXField等函数。
(2)找class的时候，必须用FindClass，而不是GetObjectClass
15、上面的使用GetFieldID的时候，需要一些代码，例如float是D。
byte B
char C
double D
float F
int I
long J(诡异啊)
short S
void V
boolean Z
数组 [
16、可以使用javap产生函数签名，这实际是写入到了字节码（Java虚拟机来读）的：
javap -s -private JNITest
Compiled from "JNITest.java"
public class JNITest extends java.lang.Object{
private double salary;
Signature: D
public JNITest(double);
Signature: (D)V
public native void raiseSalary(double);
Signature: (D)V
public java.lang.String toString();
Signature: ()Ljava/lang/String;
public static void main(java.lang.String[]);
Signature: ([Ljava/lang/String;)V
static {};
Signature: ()V
}
17、也可以从本地代码中调用Java中的方法！
18、从JNI代码中调用本地代码的步骤：
(1)GetObjectClass
(2)mid = GetMedhodID
(3)CallXXXMethod(mid) 这里的XXX是函数的返回类型！
18、调用静态方法的区别：GetStaticMethodID, CallStaticXXMethod
19、JNI代码中，可以用newObject来构造新的Java对象，并指定方法名为<init>的构造函数。
20、从JNI代码中调用变参数的函数，用CallNonVirtualXXXMethod，带有V的版本是变参数的。
21、JNI代码中可以访问Java的数组，GetArrayLength、GetObjectArray、SetObjectArrayElement。
22、C语言中是没有异常处理的，很可能发生越界等错误，但这些在Java中是会抛出异常的。我们需要在JNI代码中用NewObject来创建Throwable子类的对象。或者调用ExceptionOccured来抛出异常。
23、如果需要清空异常，用ExceptionClear来关闭异常
24、可以在JNI代码中创建虚拟机。JNI_CreateJavaVM。
本章完。