JNI Introduce

References:
http://blog.csdn.net/banketree/article/details/40535325
百度百科：http://baike.baidu.com/link?url=G_C-p8YK5fnYffQFRure1sr80yBHmmP5VMMyKbGPzWiGWhKldWXfoLaQKEwJcS-vP_i9dLg79rSrni69wJ_ima
百度文库：http://wenku.baidu.com/link?url=09Ca0f6iD-jgb4c1m5Uao8bL_z_vYVGs39k7cE5NZwACaVYNpOZJH7NoHloAh0sABFU9j_haF0erMBPKs6VfXQNJ7EI92AETUomwvWvylXK

http://wenku.baidu.com/view/107c3d37b90d6c85ec3ac671.html?re=view

1. JNI Introduce
   –>你可以使用JNI来实现“本地方法”（native methods），并在JAVA程序中调用它们。
   –>JNI支持一个“调用接口”（invocation interface），它允许你把一个JVM嵌入到本地程序中。本地程序可以链接一个实现了JVM的本地库，然后使用“调用接口”执行JAVA语言编写的软件模块。
2. JNIEnv && JavaVM
   –>JavaVM : JavaVM 是 Java虚拟机在 JNI 层的代表, JNI 全局只有一个
   –>JNIEnv : JavaVM 在线程中的代表, 每个线程都有一个, JNI 中可能有很多个 JNIEnv;
   
3. JNI_OnLoad()与JNI_OnUnload()
   当Android的VM(Virtual Machine)执行到System.loadLibrary()函数时，首先会去执行C组件里的JNI_OnLoad()函数。它的用途有二：
   (1)告诉VM此C组件使用那一个JNI版本。如果你的.so档没有提供JNI_OnLoad()函数，VM会默认该.so档是使用最老的JNI 1.1版本。由于新版的JNI做了许多扩充，如果需要使用JNI的新版功能，例如JNI 1.4的java.nio.ByteBuffer,就必须藉由JNI_OnLoad()函数来告知VM。
   (2)由于VM执行到System.loadLibrary()函数时，就会立即先呼叫JNI_OnLoad()，所以C组件的开发者可以藉由JNI_OnLoad()来进行C组件内的初期值之设定(Initialization) 。
4. JNI 调用示例：
   http://www.cnblogs.com/bastard/archive/2012/05/19/2508913.html
5. JNI AttacheThread示例：
   http://www.2cto.com/kf/201203/123575.html
   修改MyThreadActivity.java文件，实现按钮的监听，在里面调用JNI中的函数来启动JNI中的线程，比较简单，如下：

 1 package com.nan.thread;
 2
 3 import android.app.Activity;
 4 import android.os.Bundle;
 5 import android.util.Log;
 6 import android.view.View;
 7 import android.widget.Button;
 8
 9 public class MyThreadActivity extends Activity
10 {
11     private Button mButton = null;
12    
13     /** Called when the activity is first created. */
14     @Override
15     public void onCreate(Bundle savedInstanceState)
16     {
17         super.onCreate(savedInstanceState);
18         setContentView(R.layout.main);
19        
20         mButton = (Button)this.findViewById(R.id.button);
21         //按钮监听
22         mButton.setOnClickListener(new View.OnClickListener()
23         {
24            
25             @Override
26             public void onClick(View v)
27             {
28                 // TODO Auto-generated method stub
29                 //调用JNI中的函数来启动JNI中的线程
30                 mainThread();
31                
32             }
33         });
34         //初始化JNI环境
35         setJNIEnv();
36     }
37         
38     //由JNI中的线程回调
39     private static void fromJNI(int i)
40     {
41         Log.v("Java------>", ""+i);
42     }
43    
44     //本地方法
45     private native void mainThread();
46     private native void setJNIEnv();
47    
48     static
49     {
50         //加载动态库
51         System.loadLibrary("JNIThreads");
52     }
53
54 }

编写JNI_Thread.c文件，在mainThread()函数里启动5个子线程，在子线程函数里回调java中的静态方法fromJNI()来输出当前子线程是第几个被启动的线程。完整的内容如下：

 1 #include<stdio.h>
 2 #include<stdlib.h>
 3 #include<unistd.h>
 4 #include<pthread.h>
 5
 6 #include<jni.h>
 7 #include<android/log.h>
 8
 9 #define LOGI(...) ((void)__android_log_print(ANDROID_LOG_INFO, "native-activity", __VA_ARGS__))
10 #define LOGW(...) ((void)__android_log_print(ANDROID_LOG_WARN, "native-activity", __VA_ARGS__))
11 #define LOGE(...) ((void)__android_log_print(ANDROID_LOG_ERROR, "native-activity", __VA_ARGS__))
12
13 //线程数
14 #define NUMTHREADS 5
15
16 //全局变量
17 JavaVM *g_jvm = NULL;
18 jobject g_obj = NULL;
19
20
21 void *thread_fun(void* arg)
22 {
23     JNIEnv *env;
24     jclass cls;
25     jmethodID mid;
26
27     //Attach主线程
28     if((*g_jvm)->AttachCurrentThread(g_jvm, &env, NULL) != JNI_OK)
29     {
30         LOGE("%s: AttachCurrentThread() failed", __FUNCTION__);
31         return NULL;
32     }
33     //找到对应的类
34     cls = (*env)->GetObjectClass(env,g_obj);
35     if(cls == NULL)
36     {
37         LOGE("FindClass() Error.....");
38         goto error;
39     }
40     //再获得类中的方法
41     mid = (*env)->GetStaticMethodID(env, cls, "fromJNI", "(I)V");
42     if (mid == NULL)
43     {
44         LOGE("GetMethodID() Error.....");
45         goto error; 
46     }
47     //最后调用java中的静态方法
48         (*env)->CallStaticVoidMethod(env, cls, mid ,(int)arg);
49    
50
51 error:   
52     //Detach主线程
53     if((*g_jvm)->DetachCurrentThread(g_jvm) != JNI_OK)
54     {
55         LOGE("%s: DetachCurrentThread() failed", __FUNCTION__);
56     }
57    
58
59     pthread_exit(0);
60 }
61
62 //由java调用以创建子线程
63 JNIEXPORT void Java_com_nan_thread_MyThreadActivity_mainThread( JNIEnv* env, jobject obj)
64 {
65     int i;
66     pthread_t pt[NUMTHREADS];
67    
68     for (i = 0; i < NUMTHREADS; i++)
69         //创建子线程
70         pthread_create(&pt[i], NULL, &thread_fun, (void *)i);
71 }
72
73
74 //由java调用来建立JNI环境
75 JNIEXPORT void Java_com_nan_thread_MyThreadActivity_setJNIEnv( JNIEnv* env, jobject obj)
76 {
77     //保存全局JVM以便在子线程中使用
78     (*env)->GetJavaVM(env,&g_jvm);
79     //不能直接赋值(g_obj = obj)
80     g_obj = (*env)->NewGlobalRef(env,obj);
81 }
82
83
84 //当动态库被加载时这个函数被系统调用
85 JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM *vm, void *reserved)
86 {
87     JNIEnv* env = NULL;
88     jint result = -1;   
89
90     //获取JNI版本
91     if ((*vm)->GetEnv(vm, (void**)&env, JNI_VERSION_1_4) != JNI_OK)
92     {
93         LOGE("GetEnv failed!");
94             return result;
95     }
96
97     return JNI_VERSION_1_4;
98 }

Android.mk

1 LOCAL_PATH := $(call my-dir)
 2
 3 include $(CLEAR_VARS)
 4
 5 LOCAL_MODULE    := JNIThreads
 6 LOCAL_SRC_FILES := JNI_Threads.c
 7
 8 LOCAL_LDLIBS    := -llog
 9
10 include $(BUILD_SHARED_LIBRARY)