InfoDirectory使用手引書

6.4.2 サンプルプログラムの実施手順

　サンプルプログラムのコンパイルから実行までの手順について説明します。

1. サンプルプログラム格納ディレクトリ配下のすべてのファイルを作業ディレクトリにコピーします。
2. 接続するInfoDirectoryサーバの環境に合わせて、サンプルソース上でパラメタ値を変更します。該当するパラメタについては、以下のパラメタ一覧を参照してください。
3. 次のコンパイル例を参考に、サンプルプログラムをコンパイルしてください。コンパイル実行後、.classファイルが作成されることを確認してください。

   コンパイル例

   　javac Search.java

   ※）コンパイル後に、「Search.class」ファイルが作成されます。

4. 次の実行例のように、サンプルプログラムを実行します。

   実行例

   　java Search

[表: パラメタ一覧]

サンプルソース	パラメタ	概要	備考
共通パラメタ	ldapurl	接続するInfoDirectoryサーバ情報	“ldap://ホスト名:ポート番号”の形式で指定してください。
	binddn	BINDするためのDN
	password	BINDするためのパスワード
	sslenvfile	SSL環境ファイルのパス
	ssllogdir	SSLログファイルのパス
AddEntry.java	add_dn	追加するエントリのDN
	orig	追加する属性情報 （BasicAttributesオブジェクト）	追加する属性(BasicAttributeオブジェクト)を設定します。
DelEntry.java	del_dn	削除するエントリのDN
Modattrs.java	mod_dn	変更するエントリのDN
	mods	変更する属性情報 （ModificationItemオブジェクト配列）	変更する属性（ModificationItemオブジェクト）を設定します。
Search.java	s_base	サーチベース
	filter	検索フィルタ
PagedSearch.java	pageSize	ページングのサイズ	サンプル実行時にコマンドの第1パラメタに指定してください。
	s_base	サーチベース
	filter	検索フィルタ
	return_attr	返却属性
SortedList.java	attrID	ソートするキー	サンプル実行時にコマンドの第1パラメタに属性名を指定してください。
	s_base	サーチベース
	filter	検索フィルタ

【コンパイル上の注意点】

　コンパイル時／実行時には、次のアーカイを使用するJDK配下の「jre\lib\ext」配下においてください。

• ldapbp.jar
• fjssl.jar
• sslcall2.dll
• FjCrypt.dll

　コンパイル時／実行時には、次のアーカイを使用するJDK配下の「jre/lib/ext」配下においてください。

• ldapbp.jar
• fjssl.jar
• libsslcall2.so
• libFjCrypt.so

【JNDIアプリケーション作成時の注意事項】

　以下の場合、InitialDirContextのclose()メソッドを実行しても即時UNBINDは送出されません。

• 検索結果をすべて取り出していない場合
• 検索結果を破棄していない場合

　この場合、以下のタイミングでコネクションが破棄されるまで、クライアントおよびサーバ間でコネクションが累積します。以下のタイミングでは実際にはUNBINDではなくDISCONNECTが送出されます。

• アプリケーションの終了時にJVMが呼び出すfinalize()の契機
• 検索結果の変数の参照が無効になりJVMのガベージコレクションが実行される契機

　サーブレットでJNDIを動作させる場合や、コネクションの生成/破棄を繰り返すプログラムでは、LDAPサーバに繋がらないといった問題を引き起こす可能性があります。
　コネクションが累積しないようにするためには、以下のいずれかの方法で検索結果をクリアし、確実にUNBINDが送出されるようにしてください。

• 検索結果をすべて取り出す

  DirContext ctx = new InitialDirContext(env);
  NamingEnumeration results = ctx.search("c=jp", "cn=taro", constraints);
  while (results != null && results.hasMore()){
  　　SearchResult sr = (SearchResult)results.next();
  }
  　

• 検索結果を破棄する

  DirContext ctx = new InitialDirContext(env);
  NamingEnumeration results = ctx.search("c=jp", "cn=taro", constraints);
  results.close();