Jan 8, 2003

          onlsbc1, Red Hat Linux 8.0 のシステムでのJNIの実行
           ---  ネイティブコードでのcatchおよびthrowのやり方 #7
            ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
                  (http://www-online.kek.jp/~inoue/para-CAMAC/
                                   Work/SBC-Java9.html)



                        高エネルギー加速器研究機構
                            素粒子原子核研究所
                         物理、オンライングループ
                                井上 栄二



	目的

	    SBC、PCM-9370にインストールしてある Red Hat Linux 8.0 のシステム上で
	  JNIを使って catchおよび throwのやり方を確認をする。


	(1). 構成
	(2). コンパイル
	(3). 実行

  --------------------------------------------------------------------


 (1). 構成

	テストに使用するマシンは onlsbc1 である。 このマシンはアドバンテク社の
	SBC、PCM-9370である。 動作している OSはRed Hat Linux 8.0 で、Javaの
	バージョンは1.4.1_01 である。 最終的にはコンパクトフラッシュ上に構成した
	Linuxシステムで実行できることを目指すのであるが、ソフトウェアの開発段階
	では 2.5" IDE ハードディスク上に構成したLinuxシステムを使ってテストを
	行うことにする。


 (2). コンパイル

   (2-1). Javaのチェック
[inoue@onlsbc1 inoue]$ java -version
java version "1.4.1_01"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.1_01-b01)
Java HotSpot(TM) Client VM (build 1.4.1_01-b01, mixed mode)
[inoue@onlsbc1 inoue]$


   (2-2).  実行環境

[inoue@onlsbc1 inoue]$ env
MANPATH=:/usr/java/man
HOSTNAME=onlsbc1.kek.jp
PVM_RSH=/usr/bin/rsh
TERM=vt100
SHELL=/bin/bash
JLESSCHARSET=japanese
HISTSIZE=1000
SSH_CLIENT=130.87.153.9 33055 22
QTDIR=/usr/lib/qt3-gcc3.2
SSH_TTY=/dev/pts/1
USER=inoue
LS_COLORS=no=00:fi=00:di=01;34:ln=01;36:pi=40;33:so=01;35:bd=40;33;01:cd=40;33;0
1:or=01;05;37;41:mi=01;05;37;41:ex=01;32:*.cmd=01;32:*.exe=01;32:*.com=01;32:*.b
tm=01;32:*.bat=01;32:*.sh=01;32:*.csh=01;32:*.tar=01;31:*.tgz=01;31:*.arj=01;31:
*.taz=01;31:*.lzh=01;31:*.zip=01;31:*.z=01;31:*.Z=01;31:*.gz=01;31:*.bz2=01;31:*
.bz=01;31:*.tz=01;31:*.rpm=01;31:*.cpio=01;31:*.jpg=01;35:*.gif=01;35:*.bmp=01;3
5:*.xbm=01;35:*.xpm=01;35:*.png=01;35:*.tif=01;35:
PVM_ROOT=/usr/share/pvm3
MAIL=/var/spool/mail/inoue
PATH=/usr/kerberos/bin:/usr/local/bin:/bin:/usr/bin:/usr/X11R6/bin:/usr/java/bin
:/home/inoue/bin
INPUTRC=/etc/inputrc
PWD=/home/inoue
LANG=ja_JP.eucJP
LAMHELPFILE=/etc/lam/lam-helpfile
SSH_ASKPASS=/usr/libexec/openssh/gnome-ssh-askpass
SHLVL=1
HOME=/home/inoue
XPVM_ROOT=/usr/share/pvm3/xpvm
LOGNAME=inoue
LESSOPEN=|/usr/bin/lesspipe.sh %s
G_BROKEN_FILENAMES=1
_=/bin/env
[inoue@onlsbc1 inoue]$


   (2-3).  Javaコードを書く

        この実行で使用するソースコードは、以下のURLから入手した。
	http://java.sun.com/j2se/1.4/ja/docs/ja/guide/jni/index.html

[inoue@onlsbc1 CatchThrow]$ pwd
/home/inoue/JNI/CatchThrow
[inoue@onlsbc1 CatchThrow]$ ls -l
合計 8
-rw-rw-r--    1 inoue    inoue         882  1月  8 15:39 CatchThrow.c
-rw-rw-r--    1 inoue    inoue         474  1月  8 15:38 CatchThrow.java
[inoue@onlsbc1 CatchThrow]$ cat CatchThrow.java
class CatchThrow {
  private native void catchThrow() throws IllegalArgumentException;
  private void callback() throws NullPointerException {
    throw new NullPointerException("thrown in CatchThrow.callback");
  }
  public static void main(String args[]) {
    CatchThrow c = new CatchThrow();
    try {
      c.catchThrow();
    } catch (Exception e) {
      System.out.println("In Java:\n  " + e);
    }
  }
  static {
    System.loadLibrary("MyImpOfCatchThrow");
  }
}
[inoue@onlsbc1 CatchThrow]$


   (2-4).  Javaコードをコンパイルする

[inoue@onlsbc1 CatchThrow]$ ls -l
合計 8
-rw-rw-r--    1 inoue    inoue         882  1月  8 15:39 CatchThrow.c
-rw-rw-r--    1 inoue    inoue         474  1月  8 15:38 CatchThrow.java
[inoue@onlsbc1 CatchThrow]$ javac CatchThrow.java
[inoue@onlsbc1 CatchThrow]$ ls -l
合計 12
-rw-rw-r--    1 inoue    inoue         882  1月  8 15:39 CatchThrow.c
-rw-rw-r--    1 inoue    inoue        1065  1月  8 15:42 CatchThrow.class
-rw-rw-r--    1 inoue    inoue         474  1月  8 15:38 CatchThrow.java
[inoue@onlsbc1 CatchThrow]$


   (2-5).  .hファイルの生成

        C++言語のヘッダーファイルは、以下のようにjavahというコマンドで生成
        できる。 オプションには-jniを指定し、引数には項目(2-4)でコンパイルした
        クラスの拡張子を除いたものを指定する。

[inoue@onlsbc1 CatchThrow]$ javah -jni CatchThrow
[inoue@onlsbc1 CatchThrow]$ ls -l
合計 16
-rw-rw-r--    1 inoue    inoue         882  1月  8 15:39 CatchThrow.c
-rw-rw-r--    1 inoue    inoue        1065  1月  8 15:42 CatchThrow.class
-rw-rw-r--    1 inoue    inoue         387  1月  8 15:44 CatchThrow.h
-rw-rw-r--    1 inoue    inoue         474  1月  8 15:38 CatchThrow.java
[inoue@onlsbc1 CatchThrow]$ cat CatchThrow.h
/* DO NOT EDIT THIS FILE - it is machine generated */

#include <jni.h>
/* Header for class CatchThrow */

#ifndef _Included_CatchThrow
#define _Included_CatchThrow
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     CatchThrow
 * Method:    catchThrow
 * Signature: ()V
 */
JNIEXPORT void JNICALL Java_CatchThrow_catchThrow
  (JNIEnv *, jobject);

#ifdef __cplusplus
}
#endif
#endif
[inoue@onlsbc1 CatchThrow]$


   (2-6).  C言語のソースファイルの作成

[inoue@onlsbc1 CatchThrow]$ cat CatchThrow.c

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

JNIEXPORT void JNICALL
Java_CatchThrow_catchThrow(JNIEnv *env, jobject obj)
{
  jclass cls = (*env)->GetObjectClass(env, obj);
  jmethodID mid = (*env)->GetMethodID(env, cls, "callback", "()V");
  jthrowable exc;
  if (mid == 0) {
    return;
  }
  (*env)->CallVoidMethod(env, obj, mid);
  exc = (*env)->ExceptionOccurred(env);
  if (exc) {
    /* We don't do much with the exception, except that we print a
       debug message using ExceptionDescribe, clear it, and throw
       a new exception. */
    jclass newExcCls;

    (*env)->ExceptionDescribe(env);
    (*env)->ExceptionClear(env);

    newExcCls = (*env)->FindClass(env, "java/lang/IllegalArgumentException");
    if (newExcCls == 0) { /* Unable to find the new exception class, give up. */
      return;
    }
    (*env)->ThrowNew(env, newExcCls, "thrown from C code");
  }
}
[inoue@onlsbc1 CatchThrow]$


   (2-7).  C言語のソースファイルをコンパイルしてシェアード・ライブラリを作成

[inoue@onlsbc1 CatchThrow]$ pwd
/home/inoue/JNI/CatchThrow
[inoue@onlsbc1 CatchThrow]$ ls -l
合計 16
-rw-rw-r--    1 inoue    inoue         882  1月  8 15:39 CatchThrow.c
-rw-rw-r--    1 inoue    inoue        1065  1月  8 15:42 CatchThrow.class
-rw-rw-r--    1 inoue    inoue         387  1月  8 15:44 CatchThrow.h
-rw-rw-r--    1 inoue    inoue         474  1月  8 15:38 CatchThrow.java
[inoue@onlsbc1 CatchThrow]$ gcc -shared -I/usr/java/include -I/usr/java/include/
linux CatchThrow.c -o libMyImpOfCatchThrow.so
[inoue@onlsbc1 CatchThrow]$ ls -l
合計 24
-rw-rw-r--    1 inoue    inoue         882  1月  8 15:39 CatchThrow.c
-rw-rw-r--    1 inoue    inoue        1065  1月  8 15:42 CatchThrow.class
-rw-rw-r--    1 inoue    inoue         387  1月  8 15:44 CatchThrow.h
-rw-rw-r--    1 inoue    inoue         474  1月  8 15:38 CatchThrow.java
-rwxrwxr-x    1 inoue    inoue        5870  1月  8 15:50 libMyImpOfCatchThrow.so
[inoue@onlsbc1 CatchThrow]$


 (3). 実行

[inoue@onlsbc1 CatchThrow]$ export LD_LIBRARY_PATH=.:$LD_LIBRARY_PATH
[inoue@onlsbc1 CatchThrow]$ java CatchThrow
Exception in thread "main" java.lang.NullPointerException: thrown in CatchThrow.
callback
        at CatchThrow.callback(CatchThrow.java:4)
        at CatchThrow.catchThrow(Native Method)
        at CatchThrow.main(CatchThrow.java:9)
In Java:
  java.lang.IllegalArgumentException: thrown from C code
[inoue@onlsbc1 CatchThrow]$

	ok.  JNIを使ってのcatchおよび throwは正常に実行できた。

---xxxx