JNI之一：基础 && JAVA调用win dll实例

       JNI是Java Native Interface的缩写，译为Java本地接口。它允许Java代码和其他语言编写的代码进行交互。在android中提供JNI的方式，让Java程序可以调用C语言程序。android中很多Java类都具有native接口，这些接口由本地实现，然后注册到系统中。以下这个图可以很好的说明问题：    


        android主要的JNI代码放在以下的路径中：frameworks/base/core/jni/，这个路径中的内容被编译成库libandroid_runtime.so，这是个普通的动态库，被放置在目标系统的/system/lib目录下。此外，android还有其他的JNI库。JNI中的各个文件，实际上就是普通的C++源文件；在android中实现的JNI库，需要连接动态库libnativehelper.so。

（1）以Android源码根目录/frameworks/base/services/jni/目录下有一个onload.cpp文件。onload.cpp文件上部分为注册函数的声明，下部分为注册函数，只有通过这些注册函数，上层才有可能调用注册的JNI方法。这些注册函数是由同目录下的其他.cpp文件中实现，如register_android_server_VibratorService这个函数是在com_android_server_VibratorService.cpp文件中实现的。注册代码如下：

int register_android_server_VibratorService(JNIEnv *env)
{
return jniRegisterNativeMethods(env, "com/android/server/VibratorService",
method_table, NELEM(method_table));
}

其中jniRegisterNativeMethods为注册JNI方法函数，此函数的第二个参数对应着java类即VibratorService.java的文件名（即VibratorService.java (frameworks\base\services\java\com\android\server) ），第三个参数为注册的方法表：

static JNINativeMethod method_table[] = {
{ "vibratorExists", "()Z", (void*)vibratorExists },
{ "vibratorOn", "(J)V", (void*)vibratorOn },
{ "vibratorOff", "()V", (void*)vibratorOff }
};

这里定义的三个函数就可以直接在VibratorService.java中被调用，只不过在该文件头部要以native申明函数。这三个函数的实现是在Vibrator.c (hardware\libhardware_legacy\vibrator)中，不同的JNI函数实现方法和地方是不同的。

（2）方法列表说明，static const JNINativeMethod method_table[]方法列表的原型如下：

typedef struct {
const char* name;
const char* signature;
void* fnPtr;
} JNINativeMethod;

 Andorid使用了一种Java 和 C 函数的映射表数组，并在其中描述了函数的参数和返回值。第一个变量name是Java中函数的名字；第二个变量signature，用字符串描述了函数的参数和返回值；第三个变量fnPtr是函数指针，指向C函数。其中比较难以理解的是第二个参数，例如：()Z  (J)V  ()V。实际上这些字符是与函数的参数类型一一对应的，"()" 中的字符表示参数，后面的则代表返回值。例如()V 就表示void Func()，(II)V 表示void Func(int, int)，具体的每一个字符的对应关系如下：

字符   Java类型      C类型

V      void              void

Z       jboolean     boolean

I        jint                int

J       jlong            long

D      jdouble       double

F      jfloat            float

B      jbyte            byte

C      jchar           char

S      jshort          short

数组则以"["开始，用两个字符表示

[I       jintArray      int[]

[F     jfloatArray    float[]

[B     jbyteArray    byte[]

[C    jcharArray    char[]

[S    jshortArray   short[]

[D    jdoubleArray double[]

[J     jlongArray     long[]

[Z    jbooleanArray boolean[]

如果JAVA类位于一个嵌入类，则用$作为类名间的分隔符，比如："android/os/FileObserver$ObserverThread"

===========================================================================================================

        下面举一个实例，运行Java程序直接调用WINDOWS的对话框：

（1）新建一个TestNew.java文件，输入以下内容：

public class TestNew {
public static native void hello(String msg);
static{
System.loadLibrary("TestNew");
}
/**
* @param args
*/
public static void main(String[] args) {
// TODO Auto-generated method stub
hello("hello,kitty!");
}
}

        在配置好java的环境变量C:\Program Files\Java\jdk1.6.0_13\bin之后，用javac TestNew.java命令就生成了TestNew.class文件。

（2）在命令行中用javah TestNew，在class文件的基础上生成TestNew.h（就是jni代理stub的接口），内容如下：

/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class TestNew */

#ifndef _Included_TestNew
#define _Included_TestNew
#ifdef __cplusplus
extern "C" {
#endif
/*
* Class:     TestNew
* Method:    hello
* Signature: (Ljava/lang/String;)V
*/
JNIEXPORT void JNICALL Java_TestNew_hello
(JNIEnv *, jclass, jstring);

#ifdef __cplusplus
}
#endif
#endif

（3）在VC 6.0中新建一个win32 Dynamic-Link Library项目，项目名是TestNew。DLL类型选择a simple dll project，之后打开项目所在的文件目录，把步骤（2）生成的TestNew.h拷贝到此目录。点击左边中间的FileView，切换到文件浏览模式，在Header Files上点击右键，选择Add
Files to Folder…。选择TestNew.h文件，点击OK。

      打开StdAfx.h文件，再最后面添加几行语句，#include <jni.h>，#include "TestNew.h"，加完如下：

#include <windows.h>
#include <jni.h>
#include "TestNew.h"

       打开TestNew.cpp，在最后面添加一段代码：

JNIEXPORT void JNICALL Java_TestNew_hello(JNIEnv * env, jclass obj, jstring jMsg)
{
const char *strMsgPtr = env->GetStringUTFChars( jMsg , 0);
MessageBox( 0, strMsgPtr,"Message box from VC++ ", 0 );
env->ReleaseStringUTFChars( jMsg, strMsgPtr);
}

（4）在VC的菜单上选择Tools-Options…，打开选项对话框。在Directories文件夹，添加上jdk所在文件夹下的include和include\win32文件夹。



点击VC上的菜单项Build-Build All，生成TestNew.dll。

（5）将VC项目Debug文件夹中的TestNew.dll复制到TestNew.class所在的文件夹下。在命令行下输入java TestNew，弹出MessageBox对话框。调用win32
api成功。如下：



参考原文：http://www.cnblogs.com/mandroid/archive/2011/06/15/2081093.html

参考原文：http://www.iteye.com/topic/304594#814127

参考原文：http://blog.csdn.net/flydream0/article/details/7088514