モジュール 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 - リスナーの追加中に問題が検出された場合。
      関連項目: