モジュール java.naming
パッケージ javax.naming.event

インタフェースEventDirContext

すべてのスーパー・インタフェース:
Context, DirContext, EventContext
public interface EventDirContext extends EventContext, DirContext
ディレクトリ・コンテキストに指定されたオブジェクトが変更されたときにトリガーされたイベントの通知を受け取る、リスナーの登録に関するメソッドを含みます。

このインタフェースにあるメソッドは、RFC 2254の検索フィルタによるオブジェクトの識別をサポートしています。

検索フィルタを使用すると、登録時に存在しないオブジェクトで配信対象を登録し、後でオブジェクトを作成してフィルタを満たすことが可能になります。 ただし、サービス・プロバイダや使用するプロトコル/サービスによってはサポート内容に制限がある場合があります。 この方法でサポートできないフィルタをコール元が発行した場合、addNamingListener()はInvalidSearchFilterExceptionをスローします。

イベント・ソースとイベント・ターゲットの説明、およびこのインタフェースのメソッドにも適用可能なリスナーの登録/登録解除に関する情報は、EventContextを参照してください。 スレッド問題の詳細は、パッケージの説明を参照してください。

任意のメソッドにパラメータとして渡されたSearchControlsまたは配列オブジェクトは、コール元によって所有されます。 サービス・プロバイダはオブジェクトを変更せず、そのオブジェクトに対する参照も保持しません。

導入されたバージョン:
1.3

  • メソッドの詳細

    • addNamingListener

      void addNamingListener(Name target, String filter, SearchControls ctls, NamingListener l) throws NamingException
      ターゲットで指定されたオブジェクトの検索フィルタfilterで識別されるオブジェクトが変更されたときに起動されるネーミング・イベントを受信するためのリスナーを追加します。

      検索コントロールctlsのスコープ、returningObjフラグおよびreturningAttributesフラグは、リスナーが対象とするオブジェクトの選択を制御し、最終的なNamingEventオブジェクトで返される情報を決定するために使用されます。 返されるリクエストされた情報は、NamingEventオブジェクトに存在しないか、サービス・プロバイダまたはサービスによって取得できなかった場合、存在しない可能性があります。

      パラメータ:
      target - このコンテキストを基準にして解決されたオブジェクトのnull以外の名前。
      filter - null以外の文字列フィルタ(RFC2254を参照)。
      ctls - nullの可能性がある検索コントロール。 nullの場合、デフォルトの検索コントロールが使用される。
      l - null以外のリスナー。
      例外:
      NamingException - リスナーの追加中に問題が検出された場合。
      関連項目:

    • addNamingListener

      void addNamingListener(String target, String filter, SearchControls ctls, NamingListener l) throws NamingException
      文字列ターゲット名で指定されたオブジェクトの検索フィルタfilterで識別されるオブジェクトが変更されたときに起動されるネーミング・イベントを受信するためのリスナーを追加します。 このメソッドの動作の詳細は、Nameを受け入れるオーバーロードを参照してください。
      パラメータ:
      target - このコンテキストを基準にして解決されたオブジェクトのnull以外の文字列名。
      filter - null以外の文字列フィルタ(RFC2254を参照)。
      ctls - nullの可能性がある検索コントロール。 nullの場合、デフォルトの検索コントロールが使用される。
      l - null以外のリスナー。
      例外:
      NamingException - リスナーの追加中に問題が検出された場合。
      関連項目:

    • addNamingListener

      void addNamingListener(Name target, String filter, Object[] filterArgs, SearchControls ctls, NamingListener l) throws NamingException
      検索フィルタfilterで識別されるオブジェクトおよびターゲットで指定されたオブジェクトのフィルタ引数が変更された場合に起動されるネーミング・イベントを受信するリスナーを追加します。 検索コントロールctlsのスコープ、returningObjフラグおよびreturningAttributesフラグは、リスナーが対象とするオブジェクトの選択を制御し、最終的なNamingEventオブジェクトで返される情報を決定するために使用されます。 返されるリクエストされた情報は、NamingEventオブジェクトに存在しないか、サービス・プロバイダまたはサービスによって取得できなかった場合、存在しない可能性があります。
      パラメータ:
      target - このコンテキストを基準にして解決されたオブジェクトのnull以外の名前。
      filter - null以外の文字列フィルタ(RFC2254を参照)。
      filterArgs - フィルタに対する引数のnullの可能性がある配列。
      ctls - nullの可能性がある検索コントロール。 nullの場合、デフォルトの検索コントロールが使用される。
      l - null以外のリスナー。
      例外:
      NamingException - リスナーの追加中に問題が検出された場合。
      関連項目:

    • addNamingListener

      void addNamingListener(String target, String filter, Object[] filterArgs, SearchControls ctls, NamingListener l) throws NamingException
      検索フィルタfilterで識別されるオブジェクトおよび文字列ターゲット名で指定されたオブジェクトのフィルタ引数が変更された場合に起動されるネーミング・イベントを受信するリスナーを追加します。 このメソッドの動作の詳細は、Nameを受け入れるオーバーロードを参照してください。
      パラメータ:
      target - このコンテキストを基準にして解決されたオブジェクトのnull以外の文字列名。
      filter - null以外の文字列フィルタ(RFC2254を参照)。
      filterArgs - フィルタに対する引数のnullの可能性がある配列。
      ctls - nullの可能性がある検索コントロール。 nullの場合、デフォルトの検索コントロールが使用される。
      l - null以外のリスナー。
      例外:
      NamingException - リスナーの追加中に問題が検出された場合。
      関連項目: