JNI实战

引子

对于刚入门的Android开发者来讲，JNI是较难掌握的。JNI有一层神秘面纱，让人敬而远之。须要同时掌握C/C++语言与Android应用开发技术也提升了进入门槛。
让咱们揭开面纱，由浅入深地学习JNI技术。

JNI是什么

JNI是Java Native Interface的缩写，直译成中文就是Java本地接口。JNI并非Android特有的技术。在Android以前就在Java中获得普遍应用。Java能作到平台无关是由于运行在虚拟机上，而不一样虚拟机在各自平台的实现，大多采用C/C++语言。经过JNI技术，Java代码能够调用C/C++的函数，反过来，C/C++也能够调用Java层的函数。JNI是沟通Java世界与Native世界的桥梁。
<!--more-->

JNI与Android

JNI在Android开发中占有重要地位。
你们都知道Android系统的四层结构。

1. 最底层是Linux内核层。

2. 第二层Native层包括了运行时库和其余动态库，好比OpenGL ES，WebKit库等，都是用C或C++写的。

3. 再上一层系统框架层是使用Java写的，它与Native层的交互，就大量使用了JNI技术，好比文件操做和socket操做等。

4. 在最上层应用层，NDK开发组件使得开发者可使用C++来编写核心算法，提升性能和代码复用性。应用须要使用到Android平台特性的地方，经过JNI来与Java层沟通，调用Android系统库提供的、Java语言编写的API，好比播放音乐视频，获取用户地理位置信息或者发送短信。

咱们用JNI来作什么

目前，市面上大部分手机游戏因为性能和跨平台的考虑，核心部分使用C/C++语言编写。并且，开发过程当中或多或少会使用到开源库或游戏引擎，包括渲染引擎，物理引擎和音乐音效引擎等，它们大都使用C/C++编写。在制做Android平台的版本时，前端与手机特性相关的功能使用Java语音编写。两部分交互时须要使用JNI技术。

JNI开发流程

这里介绍咱们平时经常使用的，在C++部分调用Java方法的场景。假设咱们的游戏须要获取用户当前的地理位置信息，用来匹配附近玩家。获取地理位置信息须要从Android的LocationManager中获取，匹配工做在C++代码中完成。

直接上代码

MainActivity.java

package com.samxu.hello_jni;
public class MainActivity extends Activity {
    public LocationUtil locationUtil;
    public LocationManager mLocationManager;
    public Button button1;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        // Get a reference to the LocationManager object.
        mLocationManager = (LocationManager) getSystemService(Context.LOCATION_SERVICE);
        locationUtil = new LocationUtil();
        locationUtil.mLocationManager = mLocationManager;

        //调用Native方法stringFromJNI()
        Log.v("hello_jni", stringFromJNI());

        button1 = (Button) findViewById(R.id.button1);
        button1.setOnClickListener(new OnClickListener() {
            @Override
            public void onClick(View v) {
                //调用Native方法callSetupFromJNI()
                Log.v("hello_jni", callSetupFromJNI());
            }
         });
    }
    public native String stringFromJNI();
    public native String callSetupFromJNI();

    static {
        System.loadLibrary("hellojni"); //加载JNI库
    }
}

LocationUtil.java

package com.samhxu.hello_jni;

public class LocationUtil {
    public LocationManager mLocationManager;
    private Location mLocation;

    public void setup() {
        Log.v("hello_jni", "initial setup");
        //init location
        mLocation = requestUpdatesFromProvider(LocationManager.GPS_PROVIDER);
    }
    public String getLocation() {
        return mLocation.getLatitude() + "," + mLocation.getLongitude();
    }
    private final LocationListener listener = new LocationListener() {
        @Override
        public void onLocationChanged(Location location) {
            // A new location update is received.  Do something useful with it.  Update the UI with 
            // the location update.
            mLocation = location;
        }
        //.......other override methods omitted
    };

    private Location requestUpdatesFromProvider(final String provider) {
        Location location = null;
        if (mLocationManager.isProviderEnabled(provider)) {
            mLocationManager.requestLocationUpdates(provider, TEN_SECONDS, TEN_METERS, listener);
            location = mLocationManager.getLastKnownLocation(provider);
        } else {
            //Toast.makeText(this, errorResId, Toast.LENGTH_LONG).show();
        }
        return location;
    }
}

hello_jni.c

#include <string.h>
#include <jni.h>

jmethodID g_setupID = 0;
jfieldID g_locationUtilID = 0;
jobject g_locationUtil = 0;
jmethodID g_getLocaitonID = 0;

jstring Java_com_samhxu_hello_1jni_MainActivity_stringFromJNI( JNIEnv* env, jobject thiz ){
    jclass clazz = (*env)->FindClass(env, "com/samhxu/hello_jni/LocationUtil");
    //jobject locationUtil = getInstance(env, clazz);
    g_setupID = (*env)->GetMethodID(env, clazz, "setup", "()V");
    g_getLocaitonID = (*env)->GetMethodID(env,clazz, "getLocation", "()Ljava/lang/String;");
    jclass mainClazz = (*env)->FindClass(env, "com/samhxu/hello_jni/MainActivity");
    g_locationUtilID = (*env)->GetFieldID(env, mainClazz, "locationUtil", "Lcom/samhxu/hello_jni/LocationUtil;");
    jobject _locationUtil = (*env)->GetObjectField(env,thiz, g_locationUtilID);
    g_locationUtil = (*env)->NewGlobalRef(env, _locationUtil);

    (*env)->CallVoidMethod(env, g_locationUtil, g_setupID );

    return (*env)->NewStringUTF(env, "Hello from JNI !");
}

jstring Java_com_samhxu_hello_1jni_MainActivity_callSetupFromJNI( JNIEnv* env, jobject thiz ){
    jstring location = (jstring) (*env)->CallObjectMethod(env, g_locationUtil, g_getLocaitonID, NULL);
    return location;
}

Android.mk

#LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE    := hellojni
LOCAL_SRC_FILES := src/hello_jni.c
include $(BUILD_SHARED_LIBRARY)

代码分析

项目怎样搭建起来，网上有不少资料，就再也不赘述。咱们只分析上述代码的要点。

Java代码中，System.loadLibrary("hellojni");加载了JNI库。System.loadLibrary("libname")用来加载Android.mk中定义的Module库名。public native String stringFromJNI();声明了native函数，native关键字表示函数由JNI层来实现。
C代码中，实现了两个native函数。对于函数命名规则，咱们采用了较为简单的静态注册法，即Java_PackageName_ClassName_MethodName,这样Java就能找到对应的native方法，并创建对应关系。在两个JNI方法中，参数列表都包含了JNIEnv*和jobject，返回值都为jstring。JNIEnv是JNI环境指针，后面会有详细表述。jobject是Java层调用方的对象类型，thiz表示由哪一个对象来调用该函数。返回值类型jstring表示在Java层是String类型。数据类型的对应关系，可见下一小节。

JNI数据类型

Java中的数据类型和JNI的数据类型存在一种对应关系。JNI的数据类型在jni.h中能够找到定义。
下面的表能够归纳：

Java类型	本地类型	JNI中定义的别名
int	long	jint
long	_int64	jlong
byte	signed char	jbyte
boolean	unsigned char	jboolean
char	unsigned short	jchar
short	short	jshort
float	float	jfloat
double	double	jdouble
Object	_jobject*	jobject

<<图>>

JNIEnv介绍

JNIEnv能够说是JNI中的主角。JNIEnv是与线程相关的表明JNI环境的结构体。每一个线程都有一份JNIEnv。在使用时，应稍加注意线程一致性。本文不详细展开。
JNIEnv提供了一系列JNI系统函数，能够用来调用Java函数或者操做jobject对象等。操做jobject对象，实质上就是操做该对象的成员变量和成员方法。
JNIEnv获取对象的成员变量和成员方法的两个函数：
jfieldID GetFieldID(jclass clazz, const char* name, const char* sig);
jmethodID GetMethodID(jclass clazz, const char* name, const char* sig);
有了成员变量的句柄，咱们就能够对成员变量进行get和set操做。
NativeType Get<type>Field(JNIEnv* env, jobject obj, jfieldID fieldID);
void Set<type>Field(JNIEnv* env, jobject obj, jfieldID fieldID, NativeType value);
有了成员方法的句柄，咱们能够进行函数调用。
NativeType Call<type>Method(JNIEnv* env, jobject obj, jmethodID methodID, … );
对于静态方法，则使用CallStatic<type>Method系列方法。
NativeType CallStatic<type>Method(JNIEnv* env, jobject obj, jmethodID methodID, … );

jstring使用

stringFromJNI方法的最后一行，return (*env)->NewStringUTF(env, "Hello from JNI")用来返回一个C的字符串。
JNI中的jstring对应Java的String。而在C/C++中的string是另外一种类型。二者的构成方式和属性彻底不一样。JNIEnv的NewStringUTF方法会把native的一个UTF-8字符串转换而获得一个jstring对象。这样就能够被Java层识别了。

JNI类型签名

看到前面的GetMethodID的最后一个参数，表示方法的参数和返回值。必定以为这种表现形式奇怪吧。实际上是根据转换规则来构成的。

基础类型的JNI描述符

JNI字段描述符	java编程语言
Z	boolean
B	byte
C	char
S	short
I	int
J	long
F	float
D	double

一个引用类型的签名，例如java.lang.String，由L字母开头，而且以分号结束，包名”java.lang.String“中的”.“被”/“替换。因此java.lang.String被表示为：”Ljava/lang/String;"
下表提供了一个关于如何格式话方法描述符的完整的描述：

方法描述符	java语言类型
"()Ljava/lang/String"	String f();
"(ILjava/lang/Class)J"	long f(int i, Class c);
"([B)v"	void f(byte[ ] bytes);

括号中的表示参数列表，括号后跟着返回值类型。

引用与资源回收

咱们知道Java中建立的对象会由垃圾回收器来回收和释放对象。
·jobject g_locationUtil·是一个引用对象，在声明的scope结束时会被释放。stringFromJNI方法中g_locationUtil = (*env)->NewGlobalRef(env, _locationUtil)就是来解决这个问题的。这样，在callSetupFromJni方法中使用g_locationUtil的时候，就不会有问题。

小结

本文结合Android开发中使用JNI的实际问题，主要介绍了JNI的相关内容。想要全面了解JNI的知识，还须要认真阅读JDK文档中关于< < Java Native Interface Specification > >部分和Android开发文档中NDK开发部分，并结合大量实际使用。