JNI技术实践（1） Java调用C/C++代码

一.概述

JVM封装了各种操作系统实际的差异性的同时，提供了JNI技术,它是一种双向的接口，使得开发者可以通过Java代码调用到各种native的库，反之亦然。所以JNI(Java Native Interface)能作为Java语言的一部分，她能够作为粘合剂将Java应用和其他本地应用(C/C++,Delphi)集合在一起.

下图就很好的描述了JNI在Java应用中的地位和角色:

 

作为一个双向的接口，JNI能支持两种native代码:native libraries 和native applications.

(1)你能使用JNI去写一些native methods去允许Java Applications能呼叫native libraries中的函数,native methods的具体实现是可能C,C++或者Delphi

(2)JNI也支持嵌入一个JVM实现到一个本地应用程序中去，去执行那些用Java语言编写的的模块.比如，一个C++编写的浏览器利用内嵌的JVM去执行下载到本地的applet.

 

实现”JNI-Java invoke Native Library”的一般步骤如下：

1) 完成Java代码，编写好Java调用类

2)编译你的Java类

3)用javah生成编译好的class文件对应的C/C++  函数的头文件

4) 实现头文件中的函数原型,编写native代码

5) 将native代码编译打包成DLL库(win32)或共享库(Linux)

6)将你的Java代码跑起来

 

二.开发例子总结

开发环境：Windows xp sp3+VC2005+Java 6u7

1.编写Java代码：

注意：

（1）调用本地代码的java方法，要设置成native的。

（2）要使用System的LoadLibrary方法去加载包含本地方法实现的库

代码如下：

package com.jni.test.basic.helloworld;

public class TestHelloWorld {

static {

        System.loadLibrary("TestHelloWorld");
    }

public static native void sayHelloToWorld(String msg);

public static void main(String[] args) {

        sayHelloToWorld("Hello,World!");

    }

}

2.编译生成的class文件:TestHelloWorld.class

3.在命令行下使用javah TestHelloWorld,生成头文件com_jni_test_basic_helloworld_TestHelloWorld.h

命令如下:javah com.jni.test.basic.helloworld.TestHelloWorld

4.在VC2005中新建一个项目，项目类型为DLL,点击OK.

将刚才我们的生成的头文件com_jni_test_basic_helloworld_TestHelloWorld.h拷到VC项目下，并且在项目中导入到Header Files里面。

打开StdAfx.h文件，在最后面添加:

#include <jni.h>
#include "com_jni_test_basic_helloworld_TestHelloWorld.h"

 

打开TestHelloWorld.cpp,在添加一下native代码:
#include"stdafx.h"
#include<time.h>
#include<iostream>
using namespace std;
JNIEXPORT void JNICALL Java_com_jni_test_basic_helloworld_TestHelloWorld_sayHelloToWorld
(JNIEnv* env, jclass method, jstring param){

     const char*pt = env->GetStringUTFChars(param, 0);
     cout<<pt<<" called by Java Native Interface"<<endl;

}

GetStringUTFChars是jre中提供的jni方法，用来得到java string的字符串。

 

5.对项目进行一次构建Build All.

如果出现错误:fatal error C1083: Cannot open include file: 'jni.h': No such file or directory

解决方法:

将以下文件：\jdk\include\jni.h
\jdk\include\win32\jawt_md.h
\jdk\include\win32\jni_md.h
放到VC200的安装目录下的\VC\include目录中

将项目中生成的dll文件 TestHelloWorld.dll 复制到java.library.path中的一个，如jre/bin 目录下.

6.运行Java代码,结果如下:

如图我们就可以看到，本地代码 Java_com_jni_test_basic_helloworld_TestHelloWorld_sayHelloToWorld 是真的被调用了.

 

附件:

Java代码-Eclipse Project

 

C++代码-VC2005 Project

 

 

参考资料:

(1)《The Java Native Interface Programmer’s Guide and Specification》

(2)《Java Native Interface 6.0 Specification》

(3)《FAQ Java(TM) 2 SDK v1.2 and JNI》