インターフェース LdapOperations

すべての既知の実装クラス:
LdapTemplate

public interface LdapOperations
LDAP 操作の基本セットを指定するインターフェース。LdapTemplate によって実装されていますが、テスト容易性を高めるためにこのインターフェースを使用すると便利なオプションになる場合があります。
  • メソッドの詳細

    • search

      特定の SearchExecutor およびコンテキストプロセッサーを使用して検索を実行します。このメソッドは、特に必要な場合にのみ使用してください。ほとんどの場合、適切な引数を指定してこのメソッドを呼び出すオーバーロードされた便利なメソッドがあります。このメソッドはすべての接続機能を処理します。読み取り専用コンテキストを取得します。NamingEnumeration をループし、コンテキストと列挙を閉じます。実際の検索は SearchExecutor に委譲され、見つかった NameClassPair はそれぞれ CallbackHandler に渡されます。検出された NamingException は LdapUtils.convertLdapException(javax.naming.NamingException) を使用して変換されます。
      パラメーター:
      se - 実際の検索の実行に使用する SearchExecutor
      handler - 見つかった各エントリが渡される NameClassPairCallbackHandler
      processor - DirContextProcessor はカスタムの前処理および後処理用です。
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからないと解釈されます。
    • search

      特定の SearchExecutor を使用して検索を実行します。このメソッドは、特に必要な場合にのみ使用してください。ほとんどの場合、適切な引数を指定してこのメソッドを呼び出すオーバーロードされた便利なメソッドがあります。このメソッドはすべての接続機能を処理します。読み取り専用コンテキストを取得します。NamingEnumeration をループし、コンテキストと列挙を閉じます。実際の検索は SearchExecutor に委譲され、見つかった NameClassPair はそれぞれ CallbackHandler に渡されます。検出された NamingException は LdapUtils.convertLdapException(javax.naming.NamingException) を使用して変換されます。
      パラメーター:
      se - 実際の検索の実行に使用する SearchExecutor
      handler - 見つかった各エントリが渡される NameClassPairCallbackHandler
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからないと解釈されます。
      関連事項:
    • executeReadOnly

      <T> T executeReadOnly(ContextExecutor<T> ce) throws NamingException
      読み取り専用コンテキストで操作 (または一連の操作) を実行します。このメソッドは、DirContext を取得し、例外を変換し、その後コンテキストを閉じるという接続機能作業を処理します。このメソッドは検索を目的としたものではありません。これには、search(SearchExecutor, NameClassPairCallbackHandler) またはオーバーロードされた検索メソッドのいずれかを使用します。
      パラメーター:
      ce - DirContext 上の実際の操作が委譲される ContextExecutor
      戻り値:
      ContextExecutor の動作結果です。
      例外:
      NamingException - 操作の結果 NamingException が発生した場合。
      関連事項:
    • executeReadWrite

      <T> T executeReadWrite(ContextExecutor<T> ce) throws NamingException
      読み取り / 書き込みコンテキストで操作 (または一連の操作) を実行します。このメソッドは、DirContext を取得し、例外を変換し、その後コンテキストを閉じるという接続機能作業を処理します。このメソッドは、このインターフェースに使用する適切なメソッドがない、非常に特殊なケースのみを対象としています。
      パラメーター:
      ce - DirContext 上の実際の操作が委譲される ContextExecutor
      戻り値:
      ContextExecutor の動作結果です。
      例外:
      NamingException - 操作の結果 NamingException が発生した場合。
      関連事項:
    • search

      void search(NameSE base, StringSE filter, SearchControlsSE controls, NameClassPairCallbackHandler handler) throws NamingException
      指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult は、指定された NameClassPairCallbackHandler に提供されます。指定された SearchControls で指定された SearchScope が検索に使用されます。ContextMapper を使用している場合は、SearchControls で returningObjFlag を true に設定する必要があることに注意してください。
      パラメーター:
      base - 検索を開始するベース DN。
      filter - 検索で使用するフィルター。
      controls - 検索で使用する SearchControls
      handler - SearchResult を供給する NameClassPairCallbackHandler
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • search

      void search(StringSE base, StringSE filter, SearchControlsSE controls, NameClassPairCallbackHandler handler) throws NamingException
      提供されたフィルターに一致するすべてのオブジェクトを検索します。詳細については、search(Name, String, SearchControls, NameClassPairCallbackHandler) を参照してください。
      パラメーター:
      base - 検索を開始するベース DN。
      filter - 検索で使用するフィルター。
      controls - 検索で使用する SearchControls
      handler - SearchResult を供給する NameClassPairCallbackHandler
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • search

      void search(NameSE base, StringSE filter, SearchControlsSE controls, NameClassPairCallbackHandler handler, DirContextProcessor processor) throws NamingException
      指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult は、指定された NameClassPairCallbackHandler に提供されます。指定された SearchControls で指定された SearchScope が検索に使用されます。ContextMapper を使用している場合は、SearchControls で returningObjFlag を true に設定する必要があることに注意してください。指定された DirContextProcessor は、検索の前後に呼び出されます。
      パラメーター:
      base - 検索を開始するベース DN。
      filter - 検索で使用するフィルター。
      controls - 検索で使用する SearchControls
      handler - SearchResult を供給する NameClassPairCallbackHandler
      processor - 検索の前後に使用する DirContextProcessor
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • search

      <T> ListSE<T> search(StringSE base, StringSE filter, SearchControlsSE controls, AttributesMapper<T> mapper, DirContextProcessor processor) throws NamingException
      指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult の属性は、指定された AttributesMapper に提供されます。提供された SearchControls で指定された SearchScope が検索に使用されます。指定された DirContextProcessor は、検索の前後に呼び出されます。
      パラメーター:
      base - 検索を開始するベース DN。
      filter - 検索で使用するフィルター。
      controls - 検索で使用する SearchControls
      mapper - 各エントリの変換に使用する AttributesMapper
      processor - 検索の前後に使用する DirContextProcessor
      戻り値:
      AttributesMapper から受信したすべてのエントリを含む List
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • search

      <T> ListSE<T> search(NameSE base, StringSE filter, SearchControlsSE controls, AttributesMapper<T> mapper, DirContextProcessor processor) throws NamingException
      指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult の属性は、指定された AttributesMapper に提供されます。提供された SearchControls で指定された SearchScope が検索に使用されます。指定された DirContextProcessor は、検索の前後に呼び出されます。
      パラメーター:
      base - 検索を開始するベース DN。
      filter - 検索で使用するフィルター。
      controls - 検索で使用する SearchControls
      mapper - 各エントリの変換に使用する AttributesMapper
      processor - 検索の前後に使用する DirContextProcessor
      戻り値:
      AttributesMapper から受信したすべてのエントリを含む List
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • search

      <T> ListSE<T> search(StringSE base, StringSE filter, SearchControlsSE controls, ContextMapper<T> mapper, DirContextProcessor processor) throws NamingException
      指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult で返されたオブジェクトは、指定された ContextMapper に提供されます。提供された SearchControls で指定された SearchScope が検索に使用されます。指定された DirContextProcessor は、検索の前後に呼び出されます。
      パラメーター:
      base - 検索を開始するベース DN。
      filter - 検索で使用するフィルター。
      controls - 検索で使用する SearchControlsSearchControls に returnObjFlag が設定されていない場合、このメソッドは ContextMapper が動作するために必要なため、自動的に設定します。
      mapper - 各エントリの変換に使用する ContextMapper
      processor - 検索の前後に使用する DirContextProcessor
      戻り値:
      ContextMapper から受信したすべてのエントリを含む List
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • search

      <T> ListSE<T> search(NameSE base, StringSE filter, SearchControlsSE controls, ContextMapper<T> mapper, DirContextProcessor processor) throws NamingException
      指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult で返されたオブジェクトは、指定された ContextMapper に提供されます。提供された SearchControls で指定された SearchScope が検索に使用されます。指定された DirContextProcessor は、検索の前後に呼び出されます。
      パラメーター:
      base - 検索を開始するベース DN。
      filter - 検索で使用するフィルター。
      controls - 検索で使用する SearchControlsSearchControls に returnObjFlag が設定されていない場合、このメソッドは ContextMapper が動作するために必要なため、自動的に設定します。
      mapper - 各エントリの変換に使用する ContextMapper
      processor - 検索の前後に使用する DirContextProcessor
      戻り値:
      ContextMapper から受信したすべてのエントリを含む List
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • search

      void search(StringSE base, StringSE filter, SearchControlsSE controls, NameClassPairCallbackHandler handler, DirContextProcessor processor) throws NamingException
      提供されたフィルターに一致するすべてのオブジェクトを検索します。詳細については、search(Name, String, SearchControls, NameClassPairCallbackHandler, DirContextProcessor) を参照してください。
      パラメーター:
      base - 検索を開始するベース DN。
      filter - 検索で使用するフィルター。
      controls - 検索で使用する SearchControls
      handler - SearchResults を供給する NameClassPairCallbackHandler
      processor - 検索の前後に使用する DirContextProcessor
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • search

      void search(NameSE base, StringSE filter, int searchScope, boolean returningObjFlag, NameClassPairCallbackHandler handler) throws NamingException
      提供されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult は、指定された NameClassPairCallbackHandler に供給されます。指定された値を検索範囲に使用し、オブジェクトフラグを返します。
      パラメーター:
      base - 検索を開始するベース DN。
      filter - 検索で使用するフィルター。
      searchScope - SearchControls で設定する検索範囲。
      returningObjFlag - バインドされたオブジェクトを検索結果で返すかどうか。ContextMapper を使用する場合は、true に設定する必要があります。
      handler - SearchResults を供給する NameClassPairCallbackHandler
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • search

      void search(StringSE base, StringSE filter, int searchScope, boolean returningObjFlag, NameClassPairCallbackHandler handler) throws NamingException
      提供されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult は、指定された NameClassPairCallbackHandler に供給されます。指定された値を検索範囲に使用し、オブジェクトフラグを返します。
      パラメーター:
      base - 検索を開始するベース DN。
      filter - 検索で使用するフィルター。
      searchScope - SearchControls で設定する検索範囲。
      returningObjFlag - バインドされたオブジェクトを検索結果で返すかどうか。ContextMapper を使用する場合は、true に設定する必要があります。
      handler - SearchResults を供給する NameClassPairCallbackHandler
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • search

      void search(NameSE base, StringSE filter, NameClassPairCallbackHandler handler) throws NamingException
      指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult は指定された NameClassPairCallbackHandler に提供されます。デフォルトの検索範囲 ( SearchControls.SUBTREE_SCOPE) が使用され、returnObjects フラグは false に設定されます。
      パラメーター:
      base - 検索を開始するベース DN。
      filter - 検索で使用するフィルター。
      handler - SearchResults を供給する NameClassPairCallbackHandler
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • search

      void search(StringSE base, StringSE filter, NameClassPairCallbackHandler handler) throws NamingException
      指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult は指定された NameClassPairCallbackHandler に提供されます。デフォルトの検索範囲 ( SearchControls.SUBTREE_SCOPE) が使用され、returnObjects フラグは false に設定されます。
      パラメーター:
      base - 検索を開始するベース DN。
      filter - 検索で使用するフィルター。
      handler - SearchResults を供給する NameClassPairCallbackHandler
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • search

      <T> ListSE<T> search(NameSE base, StringSE filter, int searchScope, StringSE[] attrs, AttributesMapper<T> mapper) throws NamingException
      指定されたフィルターに一致するすべてのオブジェクトを検索します。指定された属性名と一致する属性のみを返します。各 SearchResult の属性は、指定された AttributesMapper に提供されます。
      パラメーター:
      base - 検索を開始するベース DN。
      filter - 検索で使用するフィルター。
      searchScope - SearchControls で設定する検索範囲。
      attrs - 返す属性。null はすべての属性を返すことを意味します。
      mapper - 各エントリの変換に使用する AttributesMapper
      戻り値:
      AttributesMapper から受信したすべてのエントリを含む List
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • search

      <T> ListSE<T> search(StringSE base, StringSE filter, int searchScope, StringSE[] attrs, AttributesMapper<T> mapper) throws NamingException
      指定されたフィルターに一致するすべてのオブジェクトを検索します。指定された属性名と一致する属性のみを返します。各 SearchResult の属性は、指定された AttributesMapper に提供されます。
      パラメーター:
      base - 検索を開始するベース DN。
      filter - 検索で使用するフィルター。
      searchScope - SearchControls で設定する検索範囲。
      attrs - 返す属性。null はすべての属性を返すことを意味します。
      mapper - 各エントリの変換に使用する AttributesMapper
      戻り値:
      AttributesMapper から受信したすべてのエントリを含む List
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • search

      <T> ListSE<T> search(NameSE base, StringSE filter, int searchScope, AttributesMapper<T> mapper) throws NamingException
      指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult の属性は、指定された AttributesMapper に提供されます。
      パラメーター:
      base - 検索を開始するベース DN。
      filter - 検索で使用するフィルター。
      searchScope - SearchControls で設定する検索範囲。
      mapper - 各エントリの変換に使用する AttributesMapper
      戻り値:
      AttributesMapper から受信したすべてのエントリを含む List
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • search

      <T> ListSE<T> search(StringSE base, StringSE filter, int searchScope, AttributesMapper<T> mapper) throws NamingException
      指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult の属性は、指定された AttributesMapper に提供されます。
      パラメーター:
      base - 検索を開始するベース DN。
      filter - 検索で使用するフィルター。
      searchScope - SearchControls で設定する検索範囲。
      mapper - 各エントリの変換に使用する AttributesMapper
      戻り値:
      AttributesMapper から受信したすべてのエントリを含む List
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • search

      <T> ListSE<T> search(NameSE base, StringSE filter, AttributesMapper<T> mapper) throws NamingException
      指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult の属性は、指定された AttributesMapper に提供されます。デフォルトの検索範囲が使用されます。
      パラメーター:
      base - 検索を開始するベース DN。
      filter - 検索で使用するフィルター。
      mapper - 各エントリの変換に使用する AttributesMapper
      戻り値:
      AttributesMapper から受信したすべてのエントリを含む List
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • search

      <T> ListSE<T> search(StringSE base, StringSE filter, AttributesMapper<T> mapper) throws NamingException
      指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult の属性は、指定された AttributesMapper に提供されます。デフォルトの検索範囲が使用されます。
      パラメーター:
      base - 検索を開始するベース DN。
      filter - 検索で使用するフィルター。
      mapper - 各エントリの変換に使用する AttributesMapper
      戻り値:
      AttributesMapper から受信したすべてのエントリを含む List
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • search

      <T> ListSE<T> search(NameSE base, StringSE filter, int searchScope, StringSE[] attrs, ContextMapper<T> mapper) throws NamingException
      指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult で返される Object は、指定された ContextMapper に提供されます。指定された属性のみを返します。
      パラメーター:
      base - 検索を開始するベース DN。
      filter - 検索で使用するフィルター。
      searchScope - SearchControls で設定する検索範囲。
      attrs - 返される属性。null はすべての属性を意味します。
      mapper - 各エントリの変換に使用する ContextMapper
      戻り値:
      ContextMapper から受信したすべてのエントリを含む List
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • search

      <T> ListSE<T> search(StringSE base, StringSE filter, int searchScope, StringSE[] attrs, ContextMapper<T> mapper) throws NamingException
      指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult で返される Object は、指定された ContextMapper に提供されます。指定された属性のみを返します。
      パラメーター:
      base - 検索を開始するベース DN。
      filter - 検索で使用するフィルター。
      searchScope - SearchControls で設定する検索範囲。
      attrs - 返される属性。null はすべての属性を意味します。
      mapper - 各エントリの変換に使用する ContextMapper
      戻り値:
      ContextMapper から受信したすべてのエントリを含む List
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • search

      <T> ListSE<T> search(NameSE base, StringSE filter, int searchScope, ContextMapper<T> mapper) throws NamingException
      指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult で返される Object は、指定された ContextMapper に提供されます。
      パラメーター:
      base - 検索を開始するベース DN。
      filter - 検索で使用するフィルター。
      searchScope - SearchControls で設定する検索範囲。
      mapper - 各エントリの変換に使用する ContextMapper
      戻り値:
      ContextMapper から受信したすべてのエントリを含む List
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • search

      <T> ListSE<T> search(StringSE base, StringSE filter, int searchScope, ContextMapper<T> mapper) throws NamingException
      指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult で返される Object は、指定された ContextMapper に提供されます。
      パラメーター:
      base - 検索を開始するベース DN。
      filter - 検索で使用するフィルター。
      searchScope - SearchControls で設定する検索範囲。
      mapper - 各エントリの変換に使用する ContextMapper
      戻り値:
      ContextMapper から受信したすべてのエントリを含む List
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • search

      <T> ListSE<T> search(NameSE base, StringSE filter, ContextMapper<T> mapper) throws NamingException
      指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult で返される Object は、指定された ContextMapper に提供されます。デフォルトの検索範囲 (SearchControls.SUBTREE_SCOPE) が使用されます。
      パラメーター:
      base - 検索を開始するベース DN。
      filter - 検索で使用するフィルター。
      mapper - 各エントリの変換に使用する ContextMapper
      戻り値:
      ContextMapper から受信したすべてのエントリを含む List
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • search

      <T> ListSE<T> search(StringSE base, StringSE filter, ContextMapper<T> mapper) throws NamingException
      指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult で返される Object は、指定された ContextMapper に提供されます。デフォルトの検索範囲 (SearchControls.SUBTREE_SCOPE) が使用されます。
      パラメーター:
      base - 検索を開始するベース DN。
      filter - 検索で使用するフィルター。
      mapper - 各エントリの変換に使用する ContextMapper
      戻り値:
      ContextMapper から受信したすべてのエントリを含む List
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • search

      <T> ListSE<T> search(StringSE base, StringSE filter, SearchControlsSE controls, ContextMapper<T> mapper) throws NamingException
      指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult で返される Object は、指定された ContextMapper に提供されます。デフォルトの検索範囲 (SearchControls.SUBTREE_SCOPE) が使用されます。
      パラメーター:
      base - 検索を開始するベース DN。
      filter - 検索で使用するフィルター。
      mapper - 各エントリの変換に使用する ContextMapper
      戻り値:
      ContextMapper から受信したすべてのエントリを含む List
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • search

      <T> ListSE<T> search(NameSE base, StringSE filter, SearchControlsSE controls, ContextMapper<T> mapper) throws NamingException
      指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult で返されたオブジェクトは、指定された ContextMapper に提供されます。
      パラメーター:
      base - 検索を開始するベース DN。
      filter - 検索で使用するフィルター。
      controls - 検索で使用する SearchControlsSearchControls に returnObjFlag が設定されていない場合、このメソッドは ContextMapper が動作するために必要なため、自動的に設定します。
      mapper - 各エントリの変換に使用する ContextMapper
      戻り値:
      ContextMapper から受信したすべてのエントリを含む List
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • search

      <T> ListSE<T> search(StringSE base, StringSE filter, SearchControlsSE controls, AttributesMapper<T> mapper) throws NamingException
      指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult で返される属性は、指定された AttributesMapper に提供されます。
      パラメーター:
      base - 検索を開始するベース DN。
      filter - 検索で使用するフィルター。
      controls - 検索で使用する SearchControls
      mapper - 各エントリの変換に使用する AttributesMapper
      戻り値:
      ContextMapper から受信したすべてのエントリを含む List
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • search

      <T> ListSE<T> search(NameSE base, StringSE filter, SearchControlsSE controls, AttributesMapper<T> mapper) throws NamingException
      指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult で返される属性は、指定された AttributesMapper に提供されます。
      パラメーター:
      base - 検索を開始するベース DN。
      filter - 検索で使用するフィルター。
      controls - 検索で使用する SearchControls
      mapper - 各エントリの変換に使用する AttributesMapper
      戻り値:
      ContextMapper から受信したすべてのエントリを含む List
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • list

      void list(StringSE base, NameClassPairCallbackHandler handler) throws NamingException
      指定された base の子の非再帰リストを実行します。結果として得られる各 NameClassPair は、指定された NameClassPairCallbackHandler に提供されます。
      パラメーター:
      base - リストを実行するベース DN。
      handler - NameClassPairCallbackHandler は各 NameClassPairSE に供給されます。
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • list

      void list(NameSE base, NameClassPairCallbackHandler handler) throws NamingException
      指定された base の子の非再帰リストを実行します。結果として得られる各 NameClassPair は、指定された NameClassPairCallbackHandler に提供されます。
      パラメーター:
      base - リストを実行するベース DN。
      handler - NameClassPairCallbackHandler は各 NameClassPairSE に供給されます。
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • list

      <T> ListSE<T> list(StringSE base, NameClassPairMapper<T> mapper) throws NamingException
      指定された base の子の非再帰リストを実行します。見つかったすべての NameClassPair オブジェクトを指定された NameClassPairMapper に渡し、すべての戻り値を List として返します。
      パラメーター:
      base - リストを実行するベース DN。
      mapper - NameClassPairMapper は各 NameClassPairSE に供給されます。
      戻り値:
      マッパーから返されたオブジェクトを含む List
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • list

      <T> ListSE<T> list(NameSE base, NameClassPairMapper<T> mapper) throws NamingException
      指定された base の子の非再帰リストを実行します。見つかったすべての NameClassPair オブジェクトを指定された NameClassPairMapper に渡し、すべての戻り値を List として返します。
      パラメーター:
      base - リストを実行するベース DN。
      mapper - NameClassPairMapper は各 NameClassPairSE に供給されます。
      戻り値:
      マッパーから返されたオブジェクトを含む List
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • list

      指定された base の子の非再帰的なリストを実行します。
      パラメーター:
      base - リストを実行するベース DN。
      戻り値:
      base にバインドされているすべてのコンテキストの名前を含むリスト。
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • list

      ListSE<StringSE> list(NameSE base) throws NamingException
      指定された base の子の非再帰的なリストを実行します。
      パラメーター:
      base - リストを実行するベース DN。
      戻り値:
      base にバインドされているすべてのコンテキストの名前を含むリスト。
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • listBindings

      void listBindings(StringSE base, NameClassPairCallbackHandler handler) throws NamingException
      指定された base の子の非再帰リストを実行します。結果として得られる各 Binding は、指定された NameClassPairCallbackHandler に提供されます。
      パラメーター:
      base - リストを実行するベース DN。
      handler - NameClassPairCallbackHandler は各 BindingSE に供給されます。
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • listBindings

      void listBindings(NameSE base, NameClassPairCallbackHandler handler) throws NamingException
      指定された base の子の非再帰リストを実行します。結果として得られる各 Binding は、指定された NameClassPairCallbackHandler に提供されます。
      パラメーター:
      base - リストを実行するベース DN。
      handler - NameClassPairCallbackHandler は各 BindingSE に供給されます。
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • listBindings

      <T> ListSE<T> listBindings(StringSE base, NameClassPairMapper<T> mapper) throws NamingException
      指定された base の子の非再帰リストを実行します。見つかったすべての Binding オブジェクトを指定された NameClassPairMapper に渡し、すべての戻り値を List として返します。
      パラメーター:
      base - リストを実行するベース DN。
      mapper - NameClassPairMapper は各 BindingSE に供給されます。
      戻り値:
      マッパーから返されたオブジェクトを含む List
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • listBindings

      <T> ListSE<T> listBindings(NameSE base, NameClassPairMapper<T> mapper) throws NamingException
      指定された base の子の非再帰リストを実行します。見つかったすべての Binding オブジェクトを指定された NameClassPairMapper に渡し、すべての戻り値を List として返します。
      パラメーター:
      base - リストを実行するベース DN。
      mapper - NameClassPairMapper は各 BindingSE に供給されます。
      戻り値:
      マッパーから返されたオブジェクトを含む List
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • listBindings

      ListSE<StringSE> listBindings(StringSE base) throws NamingException
      指定された base の子の非再帰的なリストを実行します。
      パラメーター:
      base - リストを実行するベース DN。
      戻り値:
      base にバインドされたすべてのコンテキストの名前を含む List
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • listBindings

      ListSE<StringSE> listBindings(NameSE base) throws NamingException
      指定された base の子の非再帰的なリストを実行します。
      パラメーター:
      base - リストを実行するベース DN。
      戻り値:
      base にバインドされたすべてのコンテキストの名前を含む List
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • listBindings

      <T> ListSE<T> listBindings(StringSE base, ContextMapper<T> mapper) throws NamingException
      指定された base の子の非再帰リストを実行します。各 BindingSE で返されるオブジェクトは、指定された ContextMapper に提供されます。
      パラメーター:
      base - リストを実行するベース DN。
      mapper - 見つかったオブジェクトのマッピングに使用する ContextMapper
      戻り値:
      ContextMapper から受信したすべてのエントリを含む List
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • listBindings

      <T> ListSE<T> listBindings(NameSE base, ContextMapper<T> mapper) throws NamingException
      指定された base の子の非再帰リストを実行します。各 BindingSE で返されるオブジェクトは、指定された ContextMapper に提供されます。
      パラメーター:
      base - リストを実行するベース DN。
      mapper - 見つかったオブジェクトのマッピングに使用する ContextMapper
      戻り値:
      ContextMapper から受信したすべてのエントリを含む List
      例外:
      NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。
    • lookup

      ObjectSE lookup(NameSE dn) throws NamingException
      指定された DN を検索し、見つかったオブジェクトを返します。DirObjectFactory が ContextSource で変更されていない限り、これは通常 DirContextAdapter になります。
      パラメーター:
      dn - 検索するオブジェクトの識別名。
      戻り値:
      見つかったオブジェクト (通常は DirContextAdapter インスタンス)。
      例外:
      NamingException - エラーが発生した場合。
      関連事項:
    • lookup

      ObjectSE lookup(StringSE dn) throws NamingException
      指定された DN を検索し、見つかったオブジェクトを返します。DirObjectFactory が ContextSource で変更されていない限り、これは通常 DirContextAdapter になります。
      パラメーター:
      dn - 検索するオブジェクトの識別名。
      戻り値:
      見つかったオブジェクト (通常は DirContextAdapter インスタンス)。
      例外:
      NamingException - エラーが発生した場合。
      関連事項:
    • lookup

      <T> T lookup(NameSE dn, AttributesMapper<T> mapper) throws NamingException
      指定された DN の属性を取得し、自動的に AttributesMapper に渡す便利なメソッド。
      パラメーター:
      dn - 検索する識別名。
      mapper - 見つかったオブジェクトのマッピングに使用する AttributesMapper
      戻り値:
      マッパーから返されたオブジェクト。
      例外:
      NamingException - エラーが発生した場合。
    • lookup

      <T> T lookup(StringSE dn, AttributesMapper<T> mapper) throws NamingException
      指定された DN の属性を取得し、自動的に AttributesMapper に渡す便利なメソッド。
      パラメーター:
      dn - 検索する識別名。
      mapper - 見つかったオブジェクトのマッピングに使用する AttributesMapper
      戻り値:
      マッパーから返されたオブジェクト。
      例外:
      NamingException - エラーが発生した場合。
    • lookup

      <T> T lookup(NameSE dn, ContextMapper<T> mapper) throws NamingException
      指定された DN をルックアップし、見つかったオブジェクトを自動的に ContextMapper に渡す便利なメソッド。
      パラメーター:
      dn - 検索する識別名。
      mapper - 見つかったオブジェクトのマッピングに使用する ContextMapper
      戻り値:
      マッパーから返されたオブジェクト。
      例外:
      NamingException - エラーが発生した場合。
    • lookup

      <T> T lookup(StringSE dn, ContextMapper<T> mapper) throws NamingException
      指定された DN をルックアップし、見つかったオブジェクトを自動的に ContextMapper に渡す便利なメソッド。
      パラメーター:
      dn - 検索する識別名。
      mapper - 見つかったオブジェクトのマッピングに使用する ContextMapper
      戻り値:
      マッパーから返されたオブジェクト。
      例外:
      NamingException - エラーが発生した場合。
    • lookup

      <T> T lookup(NameSE dn, StringSE[] attributes, AttributesMapper<T> mapper) throws NamingException
      指定された DN の指定された属性を取得し、AttributesMapper に自動的に渡す簡易メソッド。
      パラメーター:
      dn - 検索する識別名。
      attributes - マッパーに渡す属性の名前。
      mapper - 見つかったオブジェクトのマッピングに使用する AttributesMapper
      戻り値:
      マッパーから返されたオブジェクト。
      例外:
      NamingException - エラーが発生した場合。
    • lookup

      <T> T lookup(StringSE dn, StringSE[] attributes, AttributesMapper<T> mapper) throws NamingException
      指定された DN の指定された属性を取得し、AttributesMapper に自動的に渡す簡易メソッド。
      パラメーター:
      dn - 検索する識別名。
      attributes - マッパーに渡す属性の名前。
      mapper - 見つかったオブジェクトのマッピングに使用する AttributesMapper
      戻り値:
      マッパーから返されたオブジェクト。
      例外:
      NamingException - エラーが発生した場合。
    • lookup

      <T> T lookup(NameSE dn, StringSE[] attributes, ContextMapper<T> mapper) throws NamingException
      指定された DN の指定された属性を取得し、自動的に ContextMapper に渡す簡易メソッド。
      パラメーター:
      dn - 検索する識別名。
      attributes - マッパーに渡す属性の名前。
      mapper - 見つかったオブジェクトのマッピングに使用する ContextMapper
      戻り値:
      マッパーから返されたオブジェクト。
      例外:
      NamingException - エラーが発生した場合。
    • lookup

      <T> T lookup(StringSE dn, StringSE[] attributes, ContextMapper<T> mapper) throws NamingException
      指定された DN の指定された属性を取得し、自動的に ContextMapper に渡す簡易メソッド。
      パラメーター:
      dn - 検索する識別名。
      attributes - マッパーに渡す属性の名前。
      mapper - 見つかったオブジェクトのマッピングに使用する ContextMapper
      戻り値:
      マッパーから返されたオブジェクト。
      例外:
      NamingException - エラーが発生した場合。
    • modifyAttributes

      void modifyAttributes(NameSE dn, ModificationItemSE[] mods) throws NamingException
      提供された ModificationItems を使用して LDAP ツリーのエントリを変更します。
      パラメーター:
      dn - 変更するノードの識別名。
      mods - 実行する変更。
      例外:
      NamingException - エラーが発生した場合。
      関連事項:
    • modifyAttributes

      void modifyAttributes(StringSE dn, ModificationItemSE[] mods) throws NamingException
      提供された ModificationItems を使用して LDAP ツリーのエントリを変更します。
      パラメーター:
      dn - 変更するノードの識別名。
      mods - 実行する変更。
      例外:
      NamingException - エラーが発生した場合。
      関連事項:
    • bind

      void bind(NameSE dn, ObjectSE obj, AttributesSE attributes) throws NamingException
      LDAP ツリーにエントリを作成します。エントリの作成に使用される属性は、obj パラメーターまたは attributes パラメーター (あるいはその両方) から取得されます。これらのパラメーターの 1 つは null である可能性がありますが、両方を指定することはできません。
      パラメーター:
      dn - オブジェクトと属性をバインドする識別名。
      obj - バインドするオブジェクトは null である可能性があります。通常は DirContext 実装です。
      attributes - バインドする属性は null である可能性があります。
      例外:
      NamingException - エラーが発生した場合。
      関連事項:
    • bind

      void bind(StringSE dn, ObjectSE obj, AttributesSE attributes) throws NamingException
      LDAP ツリーにエントリを作成します。エントリの作成に使用される属性は、obj パラメーターまたは attributes パラメーター (あるいはその両方) から取得されます。これらのパラメーターの 1 つは null である可能性がありますが、両方を指定することはできません。
      パラメーター:
      dn - オブジェクトと属性をバインドする識別名。
      obj - バインドするオブジェクトは null である可能性があります。通常は DirContext 実装です。
      attributes - バインドする属性は null である可能性があります。
      例外:
      NamingException - エラーが発生した場合。
      関連事項:
    • unbind

      void unbind(NameSE dn) throws NamingException
      LDAP ツリーからエントリを削除します。エントリには子が含まれていてはなりません。エントリに子孫がある可能性があると思われる場合は、代わりに unbind(Name, boolean) を使用してください。
      パラメーター:
      dn - 削除するエントリの識別名。
      例外:
      NamingException - エラーが発生した場合。
    • unbind

      void unbind(StringSE dn) throws NamingException
      LDAP ツリーからエントリを削除します。エントリには子が含まれていてはなりません。エントリに子孫がある可能性があると思われる場合は、代わりに unbind(Name, boolean) を使用してください。
      パラメーター:
      dn - バインドを解除する識別名。
      例外:
      NamingException - エラーが発生した場合。
    • unbind

      void unbind(NameSE dn, boolean recursive) throws NamingException
      LDAP ツリーからエントリを削除します。オプションで、プロセス内のすべての子孫を削除します。
      パラメーター:
      dn - バインドを解除する識別名。
      recursive - すべてのサブコンテキストもバインド解除するかどうか。このパラメーターが false で、エントリに子がある場合、操作は失敗します。
      例外:
      NamingException - エラーが発生した場合。
    • unbind

      void unbind(StringSE dn, boolean recursive) throws NamingException
      LDAP ツリーからエントリを削除します。オプションで、プロセス内のすべての子孫を削除します。
      パラメーター:
      dn - バインドを解除する識別名。
      recursive - すべてのサブコンテキストもバインド解除するかどうか。このパラメーターが false で、エントリに子がある場合、操作は失敗します。
      例外:
      NamingException - エラーが発生した場合。
    • rebind

      void rebind(NameSE dn, ObjectSE obj, AttributesSE attributes) throws NamingException
      エントリを削除し、新しいエントリと置き換えます。エントリの作成に使用される属性は、obj パラメーターまたは attributes パラメーター (あるいはその両方) から取得されます。これらのパラメーターの 1 つは null である可能性がありますが、両方を指定することはできません。このメソッドは、指定されたコンテキストがすでに存在していることを前提としています。存在しない場合は失敗します。
      パラメーター:
      dn - 再バインドする識別名。
      obj - DN にバインドするオブジェクトは null である可能性があります。通常は DirContext 実装です。
      attributes - バインドする属性は null である可能性があります。
      例外:
      NamingException - エラーが発生した場合。
      関連事項:
    • rebind

      void rebind(StringSE dn, ObjectSE obj, AttributesSE attributes) throws NamingException
      エントリを削除し、新しいエントリと置き換えます。エントリの作成に使用される属性は、obj パラメーターまたは attributes パラメーター (あるいはその両方) から取得されます。これらのパラメーターの 1 つは null である可能性がありますが、両方を指定することはできません。このメソッドは、指定されたコンテキストがすでに存在していることを前提としています。存在しない場合は失敗します。
      パラメーター:
      dn - 再バインドする識別名。
      obj - DN にバインドするオブジェクトは null である可能性があります。通常は DirContext 実装です。
      attributes - バインドする属性は null である可能性があります。
      例外:
      NamingException - エラーが発生した場合。
      関連事項:
    • rename

      void rename(NameSE oldDn, NameSE newDn) throws NamingException
      LDAP ツリー内のエントリを新しい場所に移動します。
      パラメーター:
      oldDn - 移動するエントリの識別名。null または空にすることはできません。
      newDn - エントリの移動先の識別名。null または空にすることはできません。
      例外:
      ContextNotEmptyException - newDn がすでにバインドされている場合
      NamingException - 他のエラーが発生した場合。
    • rename

      void rename(StringSE oldDn, StringSE newDn) throws NamingException
      LDAP ツリー内のエントリを新しい場所に移動します。
      パラメーター:
      oldDn - 移動するエントリの識別名。null または空にすることはできません。
      newDn - エントリの移動先の識別名。null または空にすることはできません。
      例外:
      ContextNotEmptyException - newDn がすでにバインドされている場合
      NamingException - 他のエラーが発生した場合。
    • lookupContext

      提供された DN をルックアップし、自動的に DirContextOperations にキャストする便利なメソッド。
      パラメーター:
      dn - 検索するオブジェクトの識別名。
      戻り値:
      見つかったオブジェクト。DirContextOperations にキャストされます。
      例外:
      ClassCastExceptionSE - 代替 DirObjectFactory が ContextSource に登録されている場合、返されるオブジェクトの実際のクラスは DirContextOperations 以外になります。
      NamingException - 他のエラーが発生した場合。
      導入:
      1.2
      関連事項:
    • lookupContext

      提供された DN をルックアップし、自動的に DirContextOperations にキャストする便利なメソッド。
      パラメーター:
      dn - 検索するオブジェクトの識別名。
      戻り値:
      見つかったオブジェクト。DirContextOperations にキャストされます。
      例外:
      ClassCastExceptionSE - 代替 DirObjectFactory が ContextSource に登録されている場合、返されるオブジェクトの実際のクラスは DirContextOperations 以外になります。
      NamingException - 他のエラーが発生した場合。
      導入:
      1.2
      関連事項:
    • modifyAttributes

      void modifyAttributes(DirContextOperations ctx) throws IllegalStateExceptionSE, NamingException
      指定された DirContextOperations インスタンスによって参照されるエントリの属性を変更します。更新する DN は DirContextOperations インスタンスの DN となり、ModificationItem 配列は AttributeModificationsAware.getModificationItems() への呼び出しを使用して DirContextOperations インスタンスから取得されます。 注意 : 提供されたインスタンスは適切に初期化されている必要があります。これは、lookup 操作から受信していない場合は、DN を初期化し、更新モード ( DirContextAdapter.setUpdateMode(boolean) ) にする必要があることを意味します。

      このメソッドの一般的な使用例は次のとおりです。

       public void update(Person person) {
              DirContextOperations ctx = ldapOperations.lookupContext(person.getDn());
      
              ctx.setAttributeValue("description", person.getDescription());
              ctx.setAttributeValue("telephoneNumber", person.getPhone());
              // More modifications here
      
              ldapOperations.modifyAttributes(ctx);
       }
       
      パラメーター:
      ctx - 更新で使用する DirContextOperations インスタンス。
      例外:
      IllegalStateExceptionSE - 指定されたインスタンスが更新モードではないか、適切に初期化されていない場合。
      NamingException - 他のエラーが発生した場合。
      導入:
      1.2
      関連事項:
    • bind

      void bind(DirContextOperations ctx)
      ツリー内の指定されたコンテキストにデータをバインドします。ctx で指定されたすべての属性は、ctx で設定された DN にバインドされます。

      例:

       DirContextOperations ctx = new DirContextAdapter(dn);
       ctx.setAttributeValue("cn", "john doe");
       ctx.setAttributeValue("description", "some description");
       //More initialization here.
      
       ldapTemplate.bind(ctx);
       
      パラメーター:
      ctx - バインドするコンテキスト
      例外:
      IllegalStateExceptionSE - DN が設定されていない場合、またはインスタンスが更新モードの場合。
      導入:
      1.3
    • rebind

      void rebind(DirContextOperations ctx)
      エントリを削除し、新しいエントリと置き換えます。エントリの作成に使用される属性は、ctx パラメーターから取得されます。このメソッドは、指定されたコンテキストがすでに存在していることを前提としています。存在しない場合は失敗します。エントリは ctx に設定された DN にバインドされます。

      例:

       DirContextOperations ctx = new DirContextAdapter(dn);
       ctx.setAttributeValue("cn", "john doe");
       ctx.setAttributeValue("description", "some description");
       //More initialization here.
      
       ldapTemplate.rebind(ctx);
       
      パラメーター:
      ctx - 再バインドするコンテキスト
      例外:
      IllegalStateExceptionSE - DN が設定されていない場合、またはインスタンスが更新モードの場合。
      導入:
      1.3
    • authenticate

      @DeprecatedSE boolean authenticate(NameSE base, StringSE filter, StringSE password)
      単純な LDAP ' バインド ' 認証を実行するユーティリティメソッド。LDAP エントリを検索し、指定されたベース DN とフィルターを使用して認証します。見つかったエントリの DN をパスワードとともに ContextSource.getContext(String, String) への入力として使用し、エントリを認証します。

      例:

       AndFilter filter = new AndFilter();
       filter.and("objectclass", "person").and("uid", userId);
       boolean authenticated = ldapTemplate.authenticate(LdapUtils.emptyLdapName(), filter.toString(), password);
       
      パラメーター:
      base - 検索のベースとして使用する DN。
      filter - 検索フィルター - 一意の結果が得られる必要があります。
      password - 認証に使用するパスワード。
      戻り値:
      認証が成功した場合は true、そうでない場合は false
      導入:
      1.3
    • authenticate

      @DeprecatedSE boolean authenticate(StringSE base, StringSE filter, StringSE password)
      単純な LDAP ' バインド ' 認証を実行するユーティリティメソッド。LDAP エントリを検索し、指定されたベース DN とフィルターを使用して認証します。見つかったエントリの DN をパスワードとともに ContextSource.getContext(String, String) への入力として使用し、エントリを認証します。

      例:

       AndFilter filter = new AndFilter();
       filter.and("objectclass", "person").and("uid", userId);
       boolean authenticated = ldapTemplate.authenticate(LdapUtils.emptyLdapName(), filter.toString(), password);
       
      パラメーター:
      base - 検索のベースとして使用する DN。
      filter - 検索フィルター - 一意の結果が得られる必要があります。
      password - 認証に使用するパスワード。
      戻り値:
      認証が成功した場合は true、そうでない場合は false
      導入:
      1.3
    • authenticate

      @DeprecatedSE boolean authenticate(NameSE base, StringSE filter, StringSE password, AuthenticatedLdapEntryContextCallback callback)
      単純な LDAP ' バインド ' 認証を実行するユーティリティメソッド。LDAP エントリを検索し、指定されたベース DN とフィルターを使用して認証します。見つかったエントリの DN をパスワードとともに ContextSource.getContext(String, String) への入力として使用し、エントリを認証します。結果の DirContext インスタンスは、認証された DirContext に対して追加の LDAP 操作を実行するために、提供された AuthenticatedLdapEntryContextCallback への入力として使用されます。
      パラメーター:
      base - 検索のベースとして使用する DN。
      filter - 検索フィルター - 一意の結果が得られる必要があります。
      password - 認証に使用するパスワード。
      callback - 見つかったユーザーで認証された DirContext で操作を実行するために、そのコールバックが呼び出されます。
      戻り値:
      認証が成功した場合は true、そうでない場合は false
      導入:
      1.3
      関連事項:
    • authenticate

      @DeprecatedSE boolean authenticate(StringSE base, StringSE filter, StringSE password, AuthenticatedLdapEntryContextCallback callback)
      単純な LDAP ' バインド ' 認証を実行するユーティリティメソッド。LDAP エントリを検索し、指定されたベース DN とフィルターを使用して認証します。見つかったエントリの DN をパスワードとともに ContextSource.getContext(String, String) への入力として使用し、エントリを認証します。結果の DirContext インスタンスは、認証された DirContext に対して追加の LDAP 操作を実行するために、提供された AuthenticatedLdapEntryContextCallback への入力として使用されます。
      パラメーター:
      base - 検索のベースとして使用する DN。
      filter - 検索フィルター - 一意の結果が得られる必要があります。
      password - 認証に使用するパスワード。
      callback - 見つかったユーザーで認証された DirContext で操作を実行するために、そのコールバックが呼び出されます。
      戻り値:
      認証が成功した場合は true、そうでない場合は false
      導入:
      1.3
      関連事項:
    • authenticate

      @DeprecatedSE boolean authenticate(NameSE base, StringSE filter, StringSE password, AuthenticatedLdapEntryContextCallback callback, AuthenticationErrorCallback errorCallback)
      単純な LDAP ' バインド ' 認証を実行するユーティリティメソッド。LDAP エントリを検索し、指定されたベース DN とフィルターを使用して認証します。見つかったエントリの DN をパスワードとともに ContextSource.getContext(String, String) への入力として使用し、エントリを認証します。結果の DirContext インスタンスは、認証された DirContext に対して追加の LDAP 操作を実行するために、提供された AuthenticatedLdapEntryContextCallback への入力として使用されます。例外がキャッチされた場合、同じ例外が指定された AuthenticationErrorCallback に渡されます。これにより、呼び出し元は、たとえば後の処理のために例外を収集するコールバックを提供できるようになります。
      パラメーター:
      base - 検索のベースとして使用する DN。
      filter - 検索フィルター - 一意の結果が得られる必要があります。
      password - 認証に使用するパスワード。
      callback - 見つかったユーザーで認証された DirContext で操作を実行するために呼び出されるコールバック。
      errorCallback - 例外がキャッチされた場合に呼び出されるコールバック。
      戻り値:
      認証が成功した場合は true、そうでない場合は false
      導入:
      1.3.1
      関連事項:
    • authenticate

      @DeprecatedSE boolean authenticate(StringSE base, StringSE filter, StringSE password, AuthenticatedLdapEntryContextCallback callback, AuthenticationErrorCallback errorCallback)
      単純な LDAP ' バインド ' 認証を実行するユーティリティメソッド。LDAP エントリを検索し、指定されたベース DN とフィルターを使用して認証します。見つかったエントリの DN をパスワードとともに ContextSource.getContext(String, String) への入力として使用し、エントリを認証します。結果の DirContext インスタンスは、認証された DirContext に対して追加の LDAP 操作を実行するために、提供された AuthenticatedLdapEntryContextCallback への入力として使用されます。例外がキャッチされた場合、同じ例外が指定された AuthenticationErrorCallback に渡されます。これにより、呼び出し元は、たとえば後の処理のために例外を収集するコールバックを提供できるようになります。
      パラメーター:
      base - 検索のベースとして使用する DN。
      filter - 検索フィルター - 一意の結果が得られる必要があります。
      password - 認証に使用するパスワード。
      callback - 見つかったユーザーで認証された DirContext で操作を実行するために呼び出されるコールバック。
      errorCallback - 例外がキャッチされた場合に呼び出されるコールバック。
      戻り値:
      認証が成功した場合は true、そうでない場合は false
      導入:
      1.3.1
      関連事項:
    • authenticate

      @DeprecatedSE boolean authenticate(NameSE base, StringSE filter, StringSE password, AuthenticationErrorCallback errorCallback)
      単純な LDAP ' バインド ' 認証を実行するユーティリティメソッド。LDAP エントリを検索し、指定されたベース DN とフィルターを使用して認証します。見つかったエントリの DN をパスワードとともに ContextSource.getContext(String, String) への入力として使用し、エントリを認証します。例外がキャッチされた場合、同じ例外が指定された AuthenticationErrorCallback に渡されます。これにより、呼び出し元は、たとえば後の処理のために例外を収集するコールバックを提供できるようになります。
      パラメーター:
      base - 検索のベースとして使用する DN。
      filter - 検索フィルター - 一意の結果が得られる必要があります。
      password - 認証に使用するパスワード。
      errorCallback - 例外がキャッチされた場合に呼び出されるコールバック。
      戻り値:
      認証が成功した場合は true、そうでない場合は false
      導入:
      1.3.1
      関連事項:
    • authenticate

      @DeprecatedSE boolean authenticate(StringSE base, StringSE filter, StringSE password, AuthenticationErrorCallback errorCallback)
      単純な LDAP ' バインド ' 認証を実行するユーティリティメソッド。LDAP エントリを検索し、指定されたベース DN とフィルターを使用して認証します。見つかったエントリの DN をパスワードとともに ContextSource.getContext(String, String) への入力として使用し、エントリを認証します。例外がキャッチされた場合、同じ例外が指定された AuthenticationErrorCallback に渡されます。これにより、呼び出し元は、たとえば後の処理のために例外を収集するコールバックを提供できるようになります。
      パラメーター:
      base - 検索のベースとして使用する DN。
      filter - 検索フィルター - 一意の結果が得られる必要があります。
      password - 認証に使用するパスワード。
      errorCallback - 例外がキャッチされた場合に呼び出されるコールバック。
      戻り値:
      認証が成功した場合は true、そうでない場合は false
      例外:
      org.springframework.dao.IncorrectResultSizeDataAccessException - 複数のユーザーが見つかった場合
      導入:
      1.3.1
    • authenticate

      <T> T authenticate(LdapQuery query, StringSE password, AuthenticatedLdapEntryContextMapper<T> mapper)
      単純な LDAP ' バインド ' 認証を実行するユーティリティメソッド。提供された LdapQuery を使用して認証する LDAP エントリを検索します。見つかったエントリの DN をパスワードとともに ContextSource.getContext(String, String) への入力として使用し、エントリを認証します。

      注意 : このメソッドは、発生した例外が処理のためにコールバックに提供されるのではなくスローされるという点で、古い認証メソッドとは異なります。

      パラメーター:
      query - 検索の詳細を指定する LdapQuery。
      password - 認証に使用するパスワード。
      mapper - 見つかったユーザーで認証された DirContext で操作を実行するために呼び出されるコールバック。それ以外の場合は false
      戻り値:
      コールバックからの結果。
      例外:
      org.springframework.dao.IncorrectResultSizeDataAccessException - 複数のユーザーが見つかった場合
      org.springframework.dao.EmptyResultDataAccessException - ユーザーが 1 人だけ見つかった場合
      NamingException - 認証で何か問題が発生した場合。
      導入:
      2.0
      関連事項:
    • authenticate

      void authenticate(LdapQuery query, StringSE password)
      単純な LDAP ' バインド ' 認証を実行するユーティリティメソッド。LDAP エントリを検索し、指定されたベース DN とフィルターを使用して認証します。見つかったエントリの DN をパスワードとともに ContextSource.getContext(String, String) への入力として使用し、エントリを認証します。例外がキャッチされた場合、同じ例外が指定された AuthenticationErrorCallback に渡されます。これにより、呼び出し元は、たとえば後の処理のために例外を収集するコールバックを提供できるようになります。

      注意 : このメソッドは、発生した例外が処理のためにコールバックに提供されるのではなくスローされるという点で、古い認証メソッドとは異なります。

      パラメーター:
      query - 検索の詳細を指定する LdapQuery。
      password - 認証に使用するパスワード。それ以外の場合は false
      例外:
      org.springframework.dao.IncorrectResultSizeDataAccessException - 複数のユーザーが見つかった場合
      org.springframework.dao.EmptyResultDataAccessException - ユーザーが 1 人だけ見つかった場合
      NamingException - 認証で何か問題が発生した場合。
      導入:
      2.0
      関連事項:
    • searchForObject

      <T> T searchForObject(NameSE base, StringSE filter, ContextMapper<T> mapper)
      指定された検索条件に一致する一意のエントリの検索を実行し、見つかったオブジェクトを返します。エントリが見つからない場合、または一致するエントリが複数ある場合は、IncorrectResultSizeDataAccessException がスローされます。
      パラメーター:
      base - 検索のベースとして使用する DN。
      filter - 検索フィルター。
      mapper - 検索に使用するマッパー。
      戻り値:
      マッパーによって返され、検索条件に一致する単一のオブジェクト。
      例外:
      org.springframework.dao.IncorrectResultSizeDataAccessException - 結果が 1 つの一意のエントリではない場合
      導入:
      1.3
    • searchForObject

      <T> T searchForObject(NameSE base, StringSE filter, SearchControlsSE searchControls, ContextMapper<T> mapper)
      指定された検索条件に一致する一意のエントリの検索を実行し、見つかったオブジェクトを返します。エントリが見つからない場合、または一致するエントリが複数ある場合は、IncorrectResultSizeDataAccessException がスローされます。
      パラメーター:
      base - 検索のベースとして使用する DN。
      filter - 検索フィルター。
      searchControls - 検索に使用する searchControls。
      mapper - 検索に使用するマッパー。
      戻り値:
      マッパーによって返され、検索条件に一致する単一のオブジェクト。
      例外:
      org.springframework.dao.IncorrectResultSizeDataAccessException - 結果が 1 つの一意のエントリではない場合
      導入:
      2.0
    • searchForObject

      <T> T searchForObject(StringSE base, StringSE filter, SearchControlsSE searchControls, ContextMapper<T> mapper)
      指定された検索条件に一致する一意のエントリの検索を実行し、見つかったオブジェクトを返します。エントリが見つからない場合、または一致するエントリが複数ある場合は、IncorrectResultSizeDataAccessException がスローされます。
      パラメーター:
      base - 検索のベースとして使用する DN。
      filter - 検索フィルター。
      searchControls - 検索に使用する searchControls。
      mapper - 検索に使用するマッパー。
      戻り値:
      マッパーによって返され、検索条件に一致する単一のオブジェクト。
      例外:
      org.springframework.dao.IncorrectResultSizeDataAccessException - 結果が 1 つの一意のエントリではない場合
      導入:
      2.0
    • searchForObject

      <T> T searchForObject(StringSE base, StringSE filter, ContextMapper<T> mapper)
      指定された検索条件に一致する一意のエントリの検索を実行し、見つかったオブジェクトを返します。エントリが見つからない場合、または一致するエントリが複数ある場合は、IncorrectResultSizeDataAccessException がスローされます。
      パラメーター:
      base - 検索のベースとして使用する DN。
      filter - 検索フィルター。
      mapper - 検索に使用するマッパー。
      戻り値:
      マッパーによって返され、検索条件に一致する単一のオブジェクト。
      例外:
      org.springframework.dao.IncorrectResultSizeDataAccessException - 結果が 1 つの一意のエントリではない場合
      導入:
      1.3
    • search

      void search(LdapQuery query, NameClassPairCallbackHandler callbackHandler)
      指定した LdapQuery からパラメーターを使用して検索を実行します。見つかったすべてのオブジェクトは、処理のために NameClassPairCallbackHandler に提供されます。
      パラメーター:
      query - LDAP クエリの仕様。
      callbackHandler - 見つかったすべてのエントリを提供する NameClassPairCallbackHandler
      例外:
      NamingException - エラーが発生した場合。
      導入:
      2.0
      関連事項:
    • search

      <T> ListSE<T> search(LdapQuery query, ContextMapper<T> mapper)
      指定した LdapQuery からパラメーターを使用して検索を実行します。見つかったすべてのオブジェクトは処理のために ContextMapper に提供され、返されたすべてのオブジェクトは返されるリストに収集されます。
      パラメーター:
      query - LDAP クエリの仕様。
      mapper - 見つかったすべてのエントリを提供する ContextMapper
      戻り値:
      ContextMapper から受信したすべてのエントリを含む List
      例外:
      NamingException - エラーが発生した場合。
      導入:
      2.0
      関連事項:
    • search

      <T> ListSE<T> search(LdapQuery query, AttributesMapper<T> mapper)
      指定した LdapQuery からパラメーターを使用して検索を実行します。見つかったエントリの属性は処理のために AttributesMapper に提供され、返されたすべてのオブジェクトは返されるリストに収集されます。
      パラメーター:
      query - LDAP クエリの仕様。
      mapper - 見つかったすべての属性を提供する Attributes
      戻り値:
      Attributes から受信したすべてのエントリを含む List
      例外:
      NamingException - エラーが発生した場合。
      導入:
      2.0
      関連事項:
    • searchForContext

      DirContextOperations searchForContext(LdapQuery query)
      指定された LDAP クエリに一致する一意のエントリの検索を実行し、見つかったエントリを DirContextOperation インスタンスとして返します。エントリが見つからない場合、または一致するエントリが複数ある場合は、IncorrectResultSizeDataAccessException がスローされます。
      パラメーター:
      query - LDAP クエリの仕様。
      戻り値:
      DirContextOperations インスタンスとしてクエリに一致する単一のエントリ。
      例外:
      org.springframework.dao.IncorrectResultSizeDataAccessException - 結果が 1 つの一意のエントリではない場合
      導入:
      2.0
      関連事項:
    • searchForObject

      <T> T searchForObject(LdapQuery query, ContextMapper<T> mapper)
      指定された LDAP クエリに一致する一意のエントリの検索を実行し、見つかったオブジェクトを返します。エントリが見つからない場合、または一致するエントリが複数ある場合は、IncorrectResultSizeDataAccessException がスローされます。
      パラメーター:
      query - LDAP クエリの仕様。
      戻り値:
      マッパーによって返され、検索条件に一致する単一のオブジェクト。
      例外:
      org.springframework.dao.IncorrectResultSizeDataAccessException - 結果が 1 つの一意のエントリではない場合
      導入:
      2.0
      関連事項:
    • searchForStream

      <T> StreamSE<T> searchForStream(LdapQuery query, AttributesMapper<T> mapper)
      指定した LdapQuery からパラメーターを使用して検索を実行します。見つかったエントリの属性は処理のために AttributesMapper に提供され、返されたすべてのオブジェクトは返されるリストに収集されます。
      パラメーター:
      query - LDAP クエリの仕様。
      mapper - 見つかったすべての属性を提供する Attributes
      戻り値:
      Attributes から受信したすべてのエントリの Stream
      例外:
      NamingException - エラーが発生した場合。
      導入:
      3.0
      関連事項:
    • searchForStream

      <T> StreamSE<T> searchForStream(LdapQuery query, ContextMapper<T> mapper)
      指定した LdapQuery からパラメーターを使用して検索を実行します。見つかったすべてのオブジェクトは処理のために ContextMapper に提供され、返されたすべてのオブジェクトは返されるリストに収集されます。
      パラメーター:
      query - LDAP クエリの仕様。
      mapper - 見つかったすべてのエントリを提供する ContextMapper
      戻り値:
      ContextMapper から受信したすべてのエントリの Stream
      例外:
      NamingException - エラーが発生した場合。
      導入:
      3.0
      関連事項:
    • findByDn

      <T> T findByDn(NameSE dn, ClassSE<T> clazz)
      LDAP ディレクトリから名前付きエントリを読み取ります。参照されるクラスには、Entry および関連するアノテーションを使用して指定されたオブジェクトとディレクトリのマッピングメタデータが必要です。
      型パラメーター:
      T - 返す Java の型
      パラメーター:
      dn - LDAP ディレクトリから読み取るエントリの識別名。
      clazz - 返す Java の型
      戻り値:
      ディレクトリから読み取られたエントリ
      例外:
      NamingException - エラー時。
      導入:
      2.0
    • create

      void create(ObjectSE entry)
      LDAP ディレクトリに指定されたエントリを作成します。参照されるクラスには、Entry および関連するアノテーションを使用して指定されたオブジェクトとディレクトリのマッピングメタデータが必要です。Id のアノテーションが付けられたフィールドがオブジェクトに設定されている場合、これが新しいエントリの識別名として使用されます。明示的な DN が指定されていない場合は、DnAttribute のアノテーションが付けられたフィールドから名前を計算しようとします。ID を計算できる場合、指定されたオブジェクトに ID が設定されます。
      パラメーター:
      entry - 作成するエントリは、null であってはならず、ディレクトリにすでに存在していてもなりません。
      例外:
      NamingException - エラー時。
      IllegalArgumentExceptionSE - エントリが null の場合、または識別名の決定に失敗した場合。
      導入:
      2.0
    • update

      void update(ObjectSE entry)
      LDAP ディレクトリ内の指定されたエントリを更新します。参照されるクラスには、Entry および関連するアノテーションを使用して指定されたオブジェクトとディレクトリのマッピングメタデータが必要です。識別名が明示的に指定されていない場合 (つまり、Id のアノテーションが付けられたフィールドが null の場合)、DnAttribute のアノテーションが付けられたフィールドから名前を計算しようとします。Id フィールドと計算された DN が異なる場合、エントリは移動されます (つまり、unbind(javax.naming.Name) の後に bind(DirContextOperations) が続きます)。そうでない場合は、エントリの現在のデータがディレクトリから読み取られ、結果の ModificationItems を使用して modifyAttributes(DirContextOperations) 操作が実行されます。ディレクトリ内の現在の状態と比較したエントリの変更からエントリの ID が変更された場合、つまり、最初から指定されていなかった場合、変更されたと計算された場合、新しい値が設定されます。提供されたオブジェクト内。
      パラメーター:
      entry - 更新するエントリ。ディレクトリにすでに存在している必要があります。
      例外:
      NamingException - エラー時。
      IllegalArgumentExceptionSE - エントリが null の場合、または識別名の決定に失敗した場合。
      導入:
      2.0
    • delete

      void delete(ObjectSE entry)
      LDAP ディレクトリからエントリを削除します。参照されるクラスには、Entry および関連するアノテーションを使用して指定されたオブジェクトとディレクトリのマッピングメタデータが必要です。Id のアノテーションが付けられたフィールドがオブジェクトに設定されている場合、これが新しいエントリの識別名として使用されます。明示的な DN が指定されていない場合は、DnAttribute のアノテーションが付けられたフィールドから名前を計算しようとします。
      パラメーター:
      entry - 削除するエントリは、ディレクトリにすでに存在している必要があります。
      例外:
      NamingException - エラー時。
      IllegalArgumentExceptionSE - エントリが null の場合、または識別名の決定に失敗した場合。
      導入:
      2.0
    • findAll

      <T> ListSE<T> findAll(ClassSE<T> clazz)
      LDAP ディレクトリ内の特定の型のすべてのエントリを検索します。参照されるクラスには、Entry および関連するアノテーションを使用して指定されたオブジェクトとディレクトリのマッピングメタデータが必要です。
      型パラメーター:
      T - 返す Java の型
      パラメーター:
      clazz - 返す Java の型
      戻り値:
      指定された Java クラスによって表される型のすべてのエントリ
      例外:
      NamingException - エラー時。
      導入:
      2.0
    • findAll

      <T> ListSE<T> findAll(NameSE base, SearchControlsSE searchControls, ClassSE<T> clazz)
      LDAP ディレクトリ内の特定の型のすべてのエントリを検索します。参照されるクラスには、Entry および関連するアノテーションを使用して指定されたオブジェクトとディレクトリのマッピングメタデータが必要です。
      型パラメーター:
      T - 返す Java の型
      パラメーター:
      base - 検索を開始するサブツリーのルート。
      searchControls - 検索の検索コントロール。「返された属性」パラメーターは、返されたエントリに入力される属性に影響を与える可能性があるため、通常は改ざんしないでください。
      clazz - 返す Java の型
      戻り値:
      指定された Java クラスによって表される型のすべてのエントリ
      例外:
      NamingException - エラー時。
      導入:
      2.0
    • find

      <T> ListSE<T> find(NameSE base, Filter filter, SearchControlsSE searchControls, ClassSE<T> clazz)
      指定されたフィルターに一致する、指定された型の LDAP ディレクトリ内のすべてのエントリを検索します。参照されるクラスには、Entry および関連するアノテーションを使用して指定されたオブジェクトとディレクトリのマッピングメタデータが必要です。
      型パラメーター:
      T - 返す Java の型
      パラメーター:
      base - 検索を開始するサブツリーのルート。
      filter - 検索フィルター。
      searchControls - 検索の検索コントロール。「返された属性」パラメーターは、返されたエントリに入力される属性に影響を与える可能性があるため、通常は改ざんしないでください。
      clazz - 返す Java の型
      戻り値:
      指定された Java クラスによって表される型のすべてのエントリ
      例外:
      NamingException - エラー時。
      導入:
      2.0
    • find

      <T> ListSE<T> find(LdapQuery query, ClassSE<T> clazz)
      LDAP ディレクトリ内のエントリを検索します。参照されるクラスには、Entry および関連するアノテーションを使用して指定されたオブジェクトとディレクトリのマッピングメタデータが必要です。

      クエリ検索フィルターに一致し、指定された Java クラスによって表されるエントリのみが返されます。

      型パラメーター:
      T - 返す Java の型
      パラメーター:
      query - LDAP クエリ仕様
      clazz - 返す Java の型
      戻り値:
      一致するすべてのエントリ。
      例外:
      NamingException - エラー時。
      導入:
      2.0
      関連事項:
    • findOne

      <T> T findOne(LdapQuery query, ClassSE<T> clazz)
      ディレクトリツリー内で指定された LdapQuery に一致するオブジェクトを検索します。一致するものが 1 つだけ見つかることを期待します。参照されるクラスには、Entry および関連するアノテーションを使用して指定されたオブジェクトとディレクトリのマッピングメタデータが必要です。
      型パラメーター:
      T - 返す Java の型
      パラメーター:
      query - LDAP クエリ仕様
      clazz - 返す Java の型
      戻り値:
      検索仕様に一致する単一のエントリ。
      例外:
      NamingException - LDAP エラーの場合。
      org.springframework.dao.EmptyResultDataAccessException - 一致するエントリが見つからない場合
      org.springframework.dao.IncorrectResultSizeDataAccessException - 一致するエントリが複数見つかった場合
      導入:
      2.0
    • findForStream

      <T> StreamSE<T> findForStream(LdapQuery query, ClassSE<T> clazz)
      LDAP ディレクトリ内のエントリを検索します。参照されるクラスには、Entry および関連するアノテーションを使用して指定されたオブジェクトとディレクトリのマッピングメタデータが必要です。

      クエリ検索フィルターに一致し、指定された Java クラスによって表されるエントリのみが返されます。

      型パラメーター:
      T - 返す Java の型
      パラメーター:
      query - LDAP クエリ仕様
      clazz - 返す Java の型
      戻り値:
      一致するすべてのエントリ。
      例外:
      NamingException - エラー時。
      導入:
      3.0
      関連事項:
    • getObjectDirectoryMapper

      ObjectDirectoryMapper getObjectDirectoryMapper()
      構成された ObjectDirectoryMapper を取得します。内部使用用。
      戻り値:
      構成された ObjectDirectoryMapper。
      導入:
      2.0