ナマズのブログ

SWIG を使って libnmz の様々な言語用のバインディングを作成してみましょう。

今回は Windows 環境で Java から libnmz の nmz_get_version を呼び出すことを考えます。

モジュール名は前回と同じ Sample とします。 SWIG 用インターフェイスファイルを Sample.i という名前で作成します。 中身は前回と全く同じです。

%module Sample
%{
#include "namazu/libnamazu.h"
%}
char *nmz_get_version();

swig コマンドを使ってラッパ用コードを生成します。 今回は Java 用ですので引数に -java を指定します。

C:\> swig -java Sample.i

実行すると Java 用の Sample_wrap.c と Sample.java, SampleJNI.java が生成されます。 (JNI を用いて C ライブラリを呼び出します。)

javac で Sample.java, SampleJNI.java をコンパイルします。

C:\> javac Sample.java SampleJNI.java

Sample.class, SampleJNI.class が生成されます。

コマンドラインでコンパイルを行うため vsvars32.bat を実行します。

C:\> "\Program Files\Microsoft Visual Studio 8\VC\bin\vsvars32.bat"

次に Sample_wrap.c をコンパイルします。 (ここでは J2sdk1.4.2_17 での例をしめします。)

C:\> cl /LD Sample_wrap.c /I c:\j2sdk1.4.2_17\include 
    /I c:\j2sdk1.4.2_17\include\win32 /I c:\namazu\include 
    /link /OUT:Sample.dll C:\namazu\lib\nmz.lib

Java バインディングの Sample モジュール(Sample ライブラリ)が作成されました。

インストールして使うこともできますが、ここではカレントディレクトリに生成したライブラリをそのまま使ってみましょう。

Sample ライブラリを呼び出す Java プログラム を main.java という名前で作成します。

public class main {
  static {
    try {
        System.loadLibrary("Sample");
    } catch (UnsatisfiedLinkError e) {
      System.err.println("Native code library failed to load. See 
          the chapter on Dynamic Linking Problems in the SWIG Java 
          documentation for help.\n" + e);
      System.exit(1);
    }
  }

  public static void main(String argv[])
  {
    // Print out the value of some enums
    System.out.println(Sample.nmz_get_version());
  }
}

このプログラムは nmz_get_version の値を表示するだけの単純なプログラムです。コンパイルして main.class を生成します。

C:\> javac main.java

実行すると、Namazu のバージョンが表示されます。 カレントディレクトリにある Sample ライブラリを利用するため、引数でパスを指定しています。

C:\> java -Djava.library.path=. -cp . main
2.0.18

非常に簡単な例ですが、SWIG を使って libnmz(nmz.dll) を Java から利用する方法をしめしました。 モジュールの生成方法は各言語ごとに異なりますが、 Perl の時に使ったものと同じインタフェースファイルから作成できることが分かったかと思います。 他の言語でも同じように利用することができますので、いろいろと工夫してみてください。

[お断り]

• SWIG Version 1.3.36 を使用しました。
• java version "1.4.2_17" を使用しました。
• Namazu 2.0.18 を使用しました。(libnmz2.0.18.003-win32.zip に含まれる nmz.dll を使用)
• Microsoft Visual C++ 2005 SP1 を使用しました。
• libnmz は GPL ライセンスです。libnmz を動的であれ、静的であれリンクして使用するプログラムは GPL ライセンスと矛盾しないライセンスである必要があります。
• SWIG を用いて作成した Sample モジュールは libnmz をリンクしますので、GPL ラインセンスとして公開します。
• Sample モジュールは GPL ライセンスですので、Sample モジュールを利用するプログラムは GPL ライセンスと矛盾しないライセンスでなければなりません。ご注意ください。