SWIG封装C代码
? 注意到.i接口文件中定義的組件僅僅是為了SWIG來(lái)讓java可以訪問(wèn)。他們并不會(huì)包含在產(chǎn)生的文件中，除非他們也被定義插入預(yù)處理定義中。
? ?全局變量：
? ? swig支持全局變量。SWIG產(chǎn)生getter和setter方法在模塊類(lèi)中來(lái)提供獲得本地全局的變量。為了讓全局變量被Java獲得，增加它到接口文件。
? ??%module Unix
? ? . . .
? ? /* Global counter. */
? ?extern int value；
? ?. . .
? ?public static void setCounter(int value) {
? UnixJNI.counter_set(value);
? }
? public static int getCounter() {
? return UnixJNI.counter_get();
? ?}
?}
常量的定義：
常量被定義在接口文件，通過(guò)#define或者%constant預(yù)處理命令
? ? %module Unix
? ? . . .
? ?/* Constant using define directive. */
? ?#define MAX_WIDTH 640
? /* Constant using %constant directive. */
? %constant int MAX_HEIGHT = 320;
SWIG產(chǎn)生一個(gè)Java接口命名為<module>Contant,和常量被展示作為靜態(tài)常量變量在這個(gè)接口中：
??public interface UnixConstants {
? ? ? ? public final static int MAX_WIDTH = UnixJNI.MAX_WIDTH_get();
? ? ? ? public final static int MAX_HEIGHT = UnixJNI.MAX_HEIGHT_get();
? }
默認(rèn)Swig產(chǎn)生運(yùn)行時(shí)常量。通過(guò)JNI函數(shù)調(diào)用本地代碼來(lái)初始化這些常量。這可以被改變通過(guò)使用這%javaconst預(yù)處理在接口文件，如下：
??%module Unix
? . . .
?/* Constant using define directive. */
?%javaconst(1);
?#define MAX_WIDTH 640
?/* Constant using %constant directive. */
?%javaconst(0);
?%constant int MAX_HEIGHT = 320;
這個(gè)預(yù)處理指令命令SWIG來(lái)產(chǎn)生編譯時(shí)常量對(duì)于Max_WIDTH和一個(gè)運(yùn)行時(shí)常量對(duì)于Max_Height.這個(gè)Java接口如下：
? ?package com.apress.swig;
? ?public interface UnixConstants {
? ?public final static int MAX_WIDTH = 640;
? ?public final static int MAX_HEIGHT = UnixJNI.MAX_HEIGHT_get();
? ?}
只讀變量：
? ?SWIG提供這個(gè)%immutable預(yù)處理指令來(lái)標(biāo)記一個(gè)只讀變量，如下：
? ?%module Unix
? ?. . .
? /* Enable the read-only mode. */
? %immutable;
? /* Read-only variable. */
? extern int readOnly;
? /* Disable the read-only mode. */
? %mutable;
Setter Method Is Not Generated for the Read-only Variable
. . .
public static int getReadOnly() {
return UnixJNI.readOnly_get();
}
public static void setReadWrite(int value) {
UnixJNI.readWrite_set(value);
}
public static int getReadWrite() {
return UnixJNI.readWrite_get();
}
}
枚舉類(lèi)型：
? SWIG能夠處理命名的和匿名的枚舉變量。產(chǎn)生枚舉變量有四種不同的方式：
匿名：
匿名枚舉被定義在接口文件，如下：
%module Unix
. . .
/* Anonymous enumeration. */
? enum { ONE = 1, TWO = 2, THREE, FOUR };
?Swig在產(chǎn)生靜態(tài)變量的<Module>Constants的Java接口對(duì)于每個(gè)enumeration，如下。想常量一樣也產(chǎn)生運(yùn)行時(shí)枚舉常量。這個(gè)%javaconst預(yù)處理也能夠產(chǎn)生編譯時(shí)枚舉常量。
? ?package com.apress.swig;
? ?public interface UnixConstants {
? ? ? . . .
? ? ? public final static int ONE = UnixJNI.ONE_get();
? ? ? public final static int TWO = UnixJNI.TWO_get();
? ? ? public final static int THREE = UnixJNI.THREE_get();
? ? ? public final static int FOUR = UnixJNI.FOUR_get();
? ?}
類(lèi)型安全：
?不像匿名的枚舉常量，他們?cè)贘ava中作為類(lèi)型安全的枚舉常量。
?%module Unix
?. . .
?/* Named enumeration. */
?enum Numbers { ONE = 1, TWO = 2, THREE, FOUR };
?SWIG定義了一個(gè)帶有枚舉的名字的單獨(dú)類(lèi)和枚舉值被展示為一個(gè)不變的靜態(tài)的成員屬性，如下：
? ?package com.apress.swig;
? ?public final class Numbers {
? ?public final static Numbers ONE = new Numbers("ONE", UnixJNI.ONE_get());
? ?public final static Numbers TWO = new Numbers("TWO", UnixJNI.TWO_get());
? ?public final static Numbers THREE = new Numbers("THREE");
? ?public final static Numbers FOUR = new Numbers("FOUR");
? ?. . .
? /* Helper methods. */
? . . .
}
enumtypeunsafe.swg的擴(kuò)展名：
? %include "enumtypeunsafe.swg"
? /* Named enumeration. */
? enum Numbers { ONE = 1, TWO = 2, THREE, FOUR };
產(chǎn)生的對(duì)于枚舉類(lèi)型的Java類(lèi)如下。這種類(lèi)型的枚舉能夠用作switch語(yǔ)句，因?yàn)樗麄兪腔诔Ａ康摹?/span>
package com.apress.swig;
public final class Numbers {
public final static int ONE = UnixJNI.ONE_get();
public final static int TWO = UnixJNI.TWO_get();
public final static int THREE = UnixJNI.THREE_get();
public final static int FOUR = UnixJNI.FOUR_get();
}
Java的枚舉類(lèi)型：
對(duì)于Java的枚舉類(lèi)型，也能夠展示個(gè)Java。這種類(lèi)型的枚舉也是類(lèi)型檢查的，和他們能夠用在switch語(yǔ)句中。命名的枚舉變量能夠標(biāo)記為Java枚舉通過(guò)包含enums.swg的擴(kuò)展，如下：
%module Unix
. . .
/* Java enumeration. */
%include "enums.swg"
/* Named enumeration. */
enum Numbers { ONE = 1, TWO = 2, THREE, FOUR };
package com.apress.swig;
public enum Numbers {
ONE(UnixJNI.ONE_get()),
TWO(UnixJNI.TWO_get()),
THREE,
FOUR;
. . .
/* Helper methods. */
. . .
}
結(jié)構(gòu)體：
? 結(jié)構(gòu)體也被SWIG支持，和他們被定義在接口文件，如下：
?%module Unix
?. . .
?/* Point structure. */
struct Point {
int x;
int y;
};
他們能夠通過(guò)getter和setter對(duì)于成員變量來(lái)封裝，如下：
package com.apress.swig;
public class Point {
private long swigCPtr;
protected boolean swigCMemOwn;
protected Point(long cPtr, boolean cMemoryOwn) {
swigCMemOwn = cMemoryOwn;
swigCPtr = cPtr;
}
protected static long getCPtr(Point obj) {
return (obj == null) ? 0 : obj.swigCPtr;
}
protected void finalize() {
delete();
}
public synchronized void delete() {
if (swigCPtr ! = 0) {
if (swigCMemOwn) {
swigCMemOwn = false;
UnixJNI.delete_Point(swigCPtr);
}
swigCPtr = 0;
}
}
public void setX(int value) {
UnixJNI.Point_x_set(swigCPtr, this, value);
}
public int getX() {
return UnixJNI.Point_x_get(swigCPtr, this);
}
public void setY(int value) {
UnixJNI.Point_y_set(swigCPtr, this, value);
}
public int getY() {
return UnixJNI.Point_y_get(swigCPtr, this);
}
public Point() {
this(UnixJNI.new_Point(), true);
}
}
總結(jié)
