cocos2d-x中使用JNI的调用JAVA方法

用cocos2d-x发布Android项目时，都应该知道要用JAVA与C/C++进行交互时会涉及到JNI的操作（Java Native Interface）。JNI是JAVA的一个通用接口，旨在本地化语言（如C\C++）与JAVA语言进行交互，在交互过程成中，JAVA调用的是已编译好的本地化语言的二进制代码（如Windows下的dll，Linux下的so文件），所以在交叉编译时看到Eclipse的控制台输出

[armeabi] SharedLibrary : libcocos2dcpp.so

[armeabi] Install : libcocos2dcpp.so => libs/armeabi/libcocos2dcpp.so

时即可认为cocos2d-x项目在Android平台编译成功，其原理就是生成这个二进制文件（动态连接库）与Android的本地语言———JAVA进行交互，而交互的过程需要一个中间的桥梁，这个桥梁就是JNI。

那么接下来就记录下如何在cocos2d-x中用C++中使用JNI调用Java语言的中的成员方法或静态方法。

在cocos2d-x中有个已封装好的用于方便操作操作JNI的类——JniHelper，主要通过以下两个函数来获取JAVA类的信息。

static bool getStaticMethodInfo(JniMethodInfo &methodinfo, const char *className, const char *methodName, const char *paramCode);
static bool getMethodInfo(JniMethodInfo &methodinfo, const char *className, const char *methodName, const char *paramCode);

顾名思义，第一个函数是获取静态方法的信息，第二个是获取成员方法的信息。其参数都是一致的分别是

methodinfo：JniMethodInfo类的引用

className：类的路径（即包名加类名）

methodName：方法名

paramCode：方法的参数类型和返回值类型

其中的第四个参数的编写规则大致如下：

(参数类型...)返回值类型。

编写规则可以参照oracle的官方文档 http://docs.oracle.com/javase/7/docs/technotes/guides/jni/spec/types.html
在c++数据类型映射到java数据类型时已以下的一个联合体方式来定义

typedef union jvalue {
jboolean z;
jbyte    b;
jchar    c;
jshort   s;
jint     i;
jlong    j;
jfloat   f;
jdouble  d;
jobject  l;
} jvalue;

可以看到，这个union包含了映射JAVA的8个原声数据类型和一个自定义类型，这样就囊括了JAVA所有的数据类型的映射。

而且，JAVA VM（JAVA虚拟机）还定义了一下的签名来表明JAVA的数据类型

Z boolean

B byte

C char

S shot

I int

J long

F float

D double

L fully-qualified-class; fully-qualified-class（注意分号）

[type type[]

(arg-types)ret-type method type

举个例子来说

如果想调用一下的一个JAVA方法

long f(int n, String s, int[] arr);

那么第四个参数（paramCode）可以写为

(ILjava/lang/String;[I)J

当然，上面的命名规则也可以通过JAVA反编译来获取。



从上图就可以看出一个类的所有方法签名，由此也解释了JAVA虚拟机在解析JAVA字节码时就是通过上面的方法签名来找到相应的方法入口地址。

接下来来测试通过JniHelper来帮助实现c++调用一个带有参数和返回值的静态JAVA方法的过程

1. 创建一个新的cocos2d-x项目，然后拿到Eclipse上去编译。编译完成后编辑入口类，加入我们要测试的JAVA代码

package com.cocos2dx.TestJNI;

import org.cocos2dx.lib.Cocos2dxActivity;
import org.cocos2dx.lib.Cocos2dxGLSurfaceView;

import android.os.Bundle;

public class TestJNI extends Cocos2dxActivity{

protected void onCreate(Bundle savedInstanceState){
super.onCreate(savedInstanceState);
}

public Cocos2dxGLSurfaceView onCreateView() {
Cocos2dxGLSurfaceView glSurfaceView = new Cocos2dxGLSurfaceView(this);
// TestJNI should create stencil buffer
glSurfaceView.setEGLConfigChooser(5, 6, 5, 0, 16, 8);

return glSurfaceView;
}

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

/////////////////////////加入JAVA测试代码/////////////////////////
public static String staticMethod(int i, String str, double d) {
return "i: " + i + ", str: " + str + ", d: " + d;
}
}

2. 修改HelloWorldScene.cpp，加入jni的调用代码

#include "HelloWorldScene.h"
#if (CC_TARGET_PLATFORM == CC_PLATFORM_ANDROID)
#include <jni.h>
#include "platform/android/jni/JniHelper.h"
#endif
USING_NS_CC;

CCScene* HelloWorld::scene() {
CCScene *scene = CCScene::create();
HelloWorld *layer = HelloWorld::create();
scene->addChild(layer);
return scene;
}

bool HelloWorld::init() {
if (!CCLayer::init()) {
return false;
}
#if (CC_TARGET_PLATFORM == CC_PLATFORM_ANDROID)
JniMethodInfo methodInfo;
//判断方法是否存在
bool isExist = JniHelper::getStaticMethodInfo(methodInfo, "com/cocos2dx/TestJNI/TestJNI", "staticMethod", "(ILjava/lang/String;D)Ljava/lang/String;");
if(isExist) {
jint i = 0;
jdouble d = 1.22;
jstring str = methodInfo.env->NewStringUTF("Test Static Method");//创建
jstring s = (jstring)methodInfo.env->CallStaticObjectMethod(methodInfo.classID, methodInfo.methodID, i, str, d);//调用Java方法
const char* c = methodInfo.env->GetStringUTFChars(s, 0);//将jstring转成字符指针
//把返回的字符串显示在屏幕中
CCLabelTTF* ttf = CCLabelTTF::create(c, "Arial", 30);
ttf->setPosition(ccp(300, 160));
this->addChild(ttf);
//释放内存
methodInfo.env->ReleaseStringUTFChars(s, c);
methodInfo.env->DeleteLocalRef(str);
}else {
CCLog("share error");
}
#endif
return true;
}

运行结果就可以看到调用成功：