DIIOPの動作確認用サンプルコード

　テンプレートのデザイン変えてみました。こだわりはないのですが、どうしても2カラムのものに変えたかったので。。やっぱり3カラムだと横幅の狭さが読んでて気になります。。

昨日も書いたとおり、今日はDIIOPのサンプルコードと簡単な動かし方です。
本格的な開発ではEclipseのようなGUIの開発環境があると便利ですが、ちょっとDIIOPの動きを知りたいだけであれば、JDKを使って手でコードを書いたほうが楽なのではないかな、と個人的には思います。

■　準備
　ノーツデータベースを作ったらいきなり使えるわけではないのでクライアントとサーバーについて以下の準備だけは最低限必要なのでお願いします。

1)　DIIOPタスクの稼動
　ドミノサーバーはDIIOPタスクとHTTPタスクを稼動しておいてください。
必要に応じて、Load DIIOP コマンドで起動してもよいですし、Notes.ini のServerTasks行に加えておいても構いません。あとDIIOPはインターネットパスワードでつなぐので、接続するNotesユーザーにはインターネットパスワードを設定しておく必要があります。

2) JDKの導入
　接続を行うクライアント環境ではJDKを導入しておく必要があります。
コンパイルの必要があるため、JREだけではなく、JDKを導入しておく必要があります。

JDKはどこのものでもいいのですが、一応SunのJDKダウンロードサイトと、IBMのJDKダウンロードサイトのリンクをつけておきます。
IBM JDK Download
SUN JDK Download

今回のサンプルくらいではJDKのバージョンはそれほどこだわる事は無いのですが、Notes 8でも 1.5.0 なので、ちゃんとした開発を行う際には最新のJava 6 ではなく Lotus Notes/Dominoの JRE のバージョンにあわせてください。
　現在利用しているNotes のJREのバージョンが知りたい場合にはNotesのJVMディレクトリの下にあるbin\java.exeを使用して確認をする事が出来ます。

C:\lotus\notes\jvm\bin>java -fullversion
java 完全バージョン "J2RE 1.5.0 IBM Windows 32 build pwi32devifx-20071025 (SR6b)"

3) NCSO.jarのコピー
　Notesクライアントの入っている環境下であれば直接そこをサーチパスに指定すればよいので問題ないのですが、本来リモートアクセスの Java アプリケーション（DIIOPを使用した接続を行うもの）ではNotesクライアントが導入されていない端末で接続を行うことが前提なので、その場合にはNCSO.jarを事前に端末上にコピーしておく必要があります。
NCSO.jarは <データディレクトリ>\domino\java にあります。


■　サンプルコード

サンプルデータベースを用意するのも面倒だと思うので、サーバー上のNames.nsf につないでサーバー名とデータベースタイトルだけを出力するものです。

NABTest.java (青字は適当に変えて下さい。)

import lotus.domino.* ;

public class NABTest 
{
	static String host = "xxxx.xxx.com" ; // server address
	static String cName = "notes admin" ; //username
	static String dbname = "names.nsf"; // database (e.g. mail\\hnagashi.nsf)
	static String password = "password" ;  // internet password

  public static void main(String args[]){
     try{
	  Session s = NotesFactory.createSession(host,cName,password) ;
	  Database db = s.getDatabase("", dbname );
	if(!db.isOpen()){
		db.open();
	}
	  String title = db.getTitle();
	  String uname = s.getUserName();
	  
	  System.out.println("UserName： " + uname );
	  System.out.println("ServerName： " + db.getServer());
	  System.out.println("Title： " + title);

        }catch(NotesException ne){
	  System.out.println(ne.id + ne.text);
	  ne.printStackTrace() ;
	}catch (Exception e){e.printStackTrace() ;}
  }
}

■　コンパイルと実行
　恐らく初めてDIIOPアプリケーションを作るときに一番緊張するのはコンパイル作業ではないでしょうか。言葉で説明すれば、「NCSO.jarをクラスパスに指定してコンパイルして下さい」と言うだけの話なのですが毎回混乱するので僕は以下のようなバッチファイルを用意しています。
（以下、作業ディレクトリをC:\MyJava としています。）

Compile.bat （青字は編集してください。）
set Java_HOME=C:\SUN\Java\jdk1.6.0_06\bin
set PATH=%Java_HOME%;%PATH%
set CLASSPATH=C:\lotus\notes\data\domino\java\NCSO.jar;C:\myjava
javac -target 1.5 NABTest.java

Java_HOME： JDKのbinディレクトリへのパス
CLASSPATH： NCSO.jarへのパスとNABTest.javaを置いているディレクトリ
8.xのJREはjava 1.5なので -target を1.5にしていますが、7.xのNCSO.jarなどを使っているのであれば1.4などにしましょう。
　僕の環境ではNotesクライアントが入っているのでNCSO.jarのパスがいかにも、と言うところになっていますが、これもどこに置いても構いません。ClassNotFoundException になるのはほとんどの場合NCSO.jarへのパスが通っていない場合です。CLASSPATHが色々通り過ぎていると逆に変なjarファイルを見てエラーになってしまう事もあるのでこのバッチの例のように新たにセットしてしまった方が簡単な気がします。

僕は実行のコマンドも考えるの面倒なので以下のような一行のバッチファイルを作っています。
こっちはJava_HOMEへのパスが通っていることが前提なので、そうでない場合は上の例を参考にパスを加えて下さい。

run.bat
java -cp c:\MyJava;c:\lotus\notes\data\domino\java\NCSO.jar NABTest

■　実行結果

C:\MyJava>run
C:\MyJava>java -cp c:\MyJava;D:\lotus\notes\data\domino\java\NCSO.jar NABTest
UserName： CN=notes admin/O=LTS
ServerName： CN=ｘｘｘｘ/O=LTS
Title： LTS's Directory

コマンドプロンプトからcompile.batとrun.batを実行して、ユーザー名、サーバー名、データベース名（Names.nsf）のタイトルが表示できたら成功です。
　DIIOPの最大のメリットは、NCSO.jarさえあればクライアント環境が無くてもNotesデータベースにアクセスできる事なのですが、何となく概要がつかめたのではないでしょうか。

　僕はこういうコードをHello World　みたいな感じで使ってDIIOP環境がセットアップできた事を確認するのに使っています。

　こういう安っぽいコードはなかなかTechnoteとして公開することも難しいし、上級者にはあまり役に立たない情報なのではないかと思うのですが、このような場所で共有してDIIOPやNotes Javaクラスの勉強の入り口になる事が出来たら幸いです。