Interstage Application Server ディレクトリサービス運用ガイド

9.1.1 C APIの概要

• クライアントAPIの位置付け

  　クライアントAPIライブラリの位置付けは、以下のようになっています。

• Interstage ディレクトリサービスへのアクセス

  　LDAPを利用するアプリケーションプログラムは、以下の4つの手順でInterstage ディレクトリサービスにアクセスすることができます。

  1. セションのオープン/初期化
     　Interstage ディレクトリサービスとのセションをオープンします。この時、セションを識別するためのセションハンドルが通知されます。また、セションに対するオプションの設定を行うことができます。
  2. ユーザ認証
     　Interstage ディレクトリサービスに対して認証を要求します。LDAP V3プロトコルを使用する場合は、ユーザ認証を省略することができます。ユーザ認証を省略した場合、Interstage ディレクトリサービスに対する要求は、アノニマス(匿名ユーザ)でのアクセスとして処理されます。
  3. LDAP操作の実行
     　Interstage ディレクトリサービスに対して、ディレクトリツリー内のエントリに対する操作（追加/検索/比較/属性値変更/名前変更/削除）を要求します。
  4. セションのクローズ
     　Interstage ディレクトリサービスとのコネクションを切断し、セションをクローズします。

  マルチスレッド環境での使用

　複数のスレッドがInterstage ディレクトリサービスと通信する場合は、各スレッドが各々セションをオープンする必要があります。

 

• 同期型関数と非同期型関数

  　ユーザ認証、およびLDAP操作の関数には、同期型と非同期型があります。

  • 同期型関数
    　同期型の関数は、処理結果を受信してから呼び出し元に復帰します。この時、受信した処理の結果が通知されます。
  • 非同期型関数
    　非同期型の関数では、Interstage ディレクトリサービスへの要求送信が完了した時点で呼び出し元に復帰します。この時、開始された処理のメッセージIDを通知します。
    非同期型関数の場合、関数から復帰した時点では処理が完了していません。メッセージIDを指定して、処理結果を受信することが必要です。非同期型関数の処理結果を受信することについては、“result情報の操作”を参照してください。

  　同期型と非同期型の違いを、以下に示します。

  項目	タイプ
  	同期型関数	非同期型関数
  復帰のタイミング	すべての処理が完了すると復帰	Interstage ディレクトリサービスへの送信が完了すると復帰
  処理結果の通知	呼び出し元に復帰した際に通知	result情報の受信処理で通知
  処理結果の受信処理	不要	必要
  呼び出し元プログラムの処理	簡単	複雑
  処理の効率	低い	高い(注)

  注)呼び出し元プログラムは、LDAPの処理が完了するまでの間に、他の処理を行うことができます。