系统:CentOS 6.6
步骤:
1、安装swig
直接 yum -y install swig即可
安装java和c++编译环境,略过
我直接 yum -y install java,发现系统已自带java
2、准备源文件和接口文件
在运行SWIG之前,首先要准备好C/C++程序的源文件(example.c),并编写接口文件(example.i)。这里采用一个简单的例子,要封装的是一个叫做example的模块。
我们要导出Example.c文件中所有变量和函数中。如下所示。
<span style="font-size:14px;">/* Example.c */ #include <stdio.h> int integer = 100; int add(int a, int b) { return a + b; } char* getString() { return "Some string"; } void printLine(const char* str) { printf("%s\n", str); }</span>
新建一个文件Example.i,输入以下内容:
<span style="font-size:14px;">%module Example %{ extern int integer; extern int add(int a, int b); extern char* getString(); extern void printLine(const char* str); %} extern int integer; extern int add(int a, int b); extern char* getString(); extern void printLine(const char* str); </span>
Example.i中%module后面是库的名称,%{和%}中的内容是要加入到生成文件中的内容,通常是函数和变量的定义和要包含的头文件,作用是让生成的源文件爱女能够通过编译。之后的内容是正常的C函数和变量的定义,与正常C语言的语法相同。
3、使用SWIG生成Java类文件
现在运行命令
swig -java example.i
默认将生成 example_wrap.c, example.java, exampleJNI.java三个文件。
然后用以下命令编译共享库文件。
gcc -c -fPIC example.c example_wrap.c -I/usr/lib/jvm/java-1.6.0-openjdk-1.6.0.35/include -I/usr/lib/jvm/java-1.6.0-openjdk-1.6.0.35/include/linux
gcc -shared -o libExample.so example.o example_wrap.o
默认将生成 libExample.so
注意编译时要包含Java本地接口头文件jni.h所在的目录,这个文件的位置在不同系统中不同,编译时需要加入。
4、测试程序
现在就已经可以使用SWIG生成的类文件 example.java和相应的JNI文件 exampleJNI.java来调用库函数了。新建一个文件Main.java来测试一下。
public class Main{ public static void main(String args[]){ System.loadLibrary("Example"); System.out.println("getInteger(): " + Example.getInteger()); Example.setInteger(100); System.out.println(Example.getInteger()); System.out.println("1 + 2 = " + Example.add(1, 2)); System.out.println("getString(): " + Example.getString()); Example.printLine("printString()"); } }
编译之前把 libExample.so 放到系统库包含目录/lib或者/usr/lib下,
即执行 cp libExample.so /usr/lib(也可以把libExample.so加到/etc/ld.so.conf,执行ldconfig)
编译运行:
javac Main.java
java Main
输出结果如下所示:
getInteger(): 100
100
1 + 2 = 3
getString(): Some string
printString()
5、总结
SWIG的功能很强大,可以支持很多语言。这里只测试了Java语言的封装,对于其他语言,方法也比较类似,只是在编译的时候需要包含相应的本地库头文件,如Python中的Python.h,Java中的jni.h。另外,这里演示的只是最简单的接口文件的编写,实际上,接口文件可以有更多的选项,这些在SWIG的文档中有更详细的说明。C语言的封装相对比较简单,对于C++这样的面向对象的语言,接口文件的编写略微复杂,但是也比较容易掌握。当然,在调用这些本地接口的时候还有一个问题,就是安全性。在设计接口的时候也要充分意识到安全性问题,防止指针错误和内存泄漏等。虽然SWIG已经能够很好地处理指针,但有的时候还需要自己去实现指针的封装。