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環境ファイルのパス	jndi1.2のサンプルプログラムのみ有効です。jndi1.1のサンプルプログラムについては、ソース上のJNDI環境プロパティを変更してください。
	ssllogdir	SSLログファイルのパス	jndi1.2のサンプルプログラムのみ有効です。jndi1.1のサンプルプログラムについては、ソース上のJNDI環境プロパティを変更してください。
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	検索フィルタ

　※ jndi1.2のサンプルプログラムにのみ存在します。

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

jndi1.1.x

CLASSPATHオプションでJNDIのクラスパスを指定する必要があります。

コンパイル例

　javac -classpath C:\Program Files\ID\Dir\sdk\JAVA\lib\jndi.zip Search.java

　javac -classpath /opt/FJSVidsdk/JAVA/lib/jndi.zip Search.java

jndi1.2.x

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

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

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

　JDK1.2.2でコンパイルするときは、以下のアーカイブも同様の場所においてください。JNK1.3.1でコンパイルするときは、以下のアーカイブは不要です。

• jndi.jar
• jaas.jar
• ldap.jar
• providerutil.jar

■【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();