语言的黏合剂-Swig

类别:编程语言 点击:0 评论:0 推荐:

什么是SWIG?

 

SWIG,即简化封装和接口生成器(Simplified Wrapper and Interface Generator),按照其创建者的说法,是“一种把用C、C++以及Objective-C所写的程序连接到各种高级编程语言的软件开发工具”。UNIX、Windows以及Macintosh系统都支持SWIG。

 

对Java程序员来说,SWIG是把C/C++代码嵌入到Java脚本的理想工具。SWIG理解C/C++申明,因此它可以解析C/C++头文件并产生Java模型并对其进行编码,编译之后,你就可以在Java中使用。

 

SWIG实际上一个“接口文件”作为输入,但它是用带有若干(可选)指示的标准C/C++头定义所组成的。实际上,如果代码相当干净,你就可以使用头文件本身。所产生的代码是完整的(也就是说,没有残留什么东西让你必须填写),而且代码由Java模型和C实现文件组成的,它只需要编译即可。

 

SWIG支持的语言

 

SWIG支持的语言非常的广泛,几乎支持目前所有流行的语言,目前支持C/C++转换的语言有Java/C#/PHP/Python/Perl/Perl5/Ruby/Ocaml/Tcl/Chicken。对各种语言的具体使用方法可以参考使用手册。

 

下面以Java为例描述使用SWIG将C++程序集成的过程。(具体的过程SWIG手册中都有详细的描述)。

 

下载安装SWIG

 

从官方网站或者开源项目中下载最新的SWIG程序,解压到本地目录。

 

安装JDK和添加JNI包

 

从sun的官方网站下载最新的Java JDK和JNI开发包。

 

使用VS6.0进行SWIG配置

l          打开一个新的工程并且通过向导建立一个DLL工程。

l          向工程中增加一个SWIG的接口文件(一般以.i结尾,例如example.i),以及SWIG将生成的封装文件(ie.example_wrap.c)。注意如果是使用C++为封装的文件example_wrap.cxx选择不同的后缀,不用担心封装文件没有存在-vs会自动更新。

l          选择SWIG接口文件(example.i),按右健,在弹出的菜单中选择”settings”选项。

l          在Description中输入”SWIG”。

l          在Commands文本框中输入:

 echo In order to function correctly, please ensure the following environment variables are correctly set:

echo JAVA_INCLUDE: %JAVA_INCLUDE%

echo JAVA_BIN: %JAVA_BIN%

echo SWIG: %SWIG%

echo on

%SWIG%\swig.exe -c++ -java $(InputPath)”。

其中%SWIG%是在环境变量中定义的swig.exe的文件目录。

l          在Outputs文本框中输入:

$(InputName)_wrap.cxx,表示根据SWIG接口文件(example.i)生成相应的C++封装文件,这里生成的封装文件名为:example_wrap.cxx。

l          接着选中整个工程然后选中C/C++属性页,选择”Category”的Preprocessor项。在”Addition include directories”中输入包含Java和Jni头文件的目录,JAVA_INCLUDE,JAVA_INCLUDE\win32。

l          而后选择Link属性页,选择”Category”的”General”项。在out put file name中设置输出DLL文件的名称。

l          最后在选择Post-build step属性页,在Post-build command(s)中添加通过javac编译java文件的命令: %JAVA_BIN%\javac *.java。

l          至此整个设置过程已经完成,需要说明的是,生成的JNI函数接口定义是由SWIG接口文件(example.i)和方法名称一起定义的,在接口文件中由模块名称:%module example,和C++的方法名称共同组成。比如在C++中有方法Start(),那么此时在Jni中是这样描述的Java_exampleJNI_Start(),如果接口文件定义该成%module example_test那么在JNI中的函数接口定义也变为Java_example_testJNI_Start()。同时JNI函数接口的定义也要求调用的Java程序的包结构与之对应。

l          编译运行。

 

SWIG资源

 

官方网站: http://www.swig.org

开源项目: http://sourceforge.net/projects/swig/

本文地址:http://com.8s8s.com/it/it28831.htm