クラス LdapTemplate

メソッドの詳細

• setContextSource

  public void setContextSource(ContextSource contextSource)

  ContextSource をセット。デフォルトのコンストラクターが使用されたときに、このメソッドを呼び出します。

  パラメーター:

  contextSource - ContextSource。

• getObjectDirectoryMapper

  public ObjectDirectoryMapper getObjectDirectoryMapper()

  構成された ObjectDirectoryMapper を取得します。内部使用用。

  次で指定:

  インターフェース LdapOperations の getObjectDirectoryMapper 

  戻り値:

  構成された ObjectDirectoryMapper。

• setObjectDirectoryMapper

  public void setObjectDirectoryMapper(ObjectDirectoryMapper odm)

  使用する ObjectDirectoryMapper インスタンスを設定します。

  パラメーター:

  odm - 使用する ObejctDirectoryMapper。

  導入:

  2.0

• getContextSource

  public ContextSource getContextSource()

  ContextSource を入手。

  戻り値:

  ContextSource。

• setIgnoreNameNotFoundException

  public void setIgnoreNameNotFoundException(boolean ignore)

  検索で NameNotFoundException を無視するかどうかを指定します。以前のバージョンでは、検索ベースが見つからないために発生した NameNotFoundException は確認なしで無視されていました。デフォルトの動作は、これをエラーとして扱い (当然のことですが)、例外を変換して再スローするようになりました。以前の動作に戻す機能は引き続き存在します。唯一の違いは、インシデントが確認なしで無視されるのではなく、警告としてログに記録されることです。

  パラメーター:

  ignore - 検索で NameNotFoundException を無視する必要がある場合は true、それ以外の場合は false。デフォルトは false です。

  導入:

  1.3

• setIgnorePartialResultException

  public void setIgnorePartialResultException(boolean ignore)

  PartialResultException を検索で無視するかどうかを指定します。通常、AD サーバーには紹介に関する問題があります。通常、紹介は自動的に行われるはずですが、これは AD サーバーでは機能しないようです。この問題は、サーバーが紹介に遭遇したときに PartialResultException がスローされることで明らかになります。このプロパティを true に設定すると、PartialResultException が無視され、検索メソッドが正常に返されるため、この問題を回避できます。このパラメーターのデフォルト値は false です。

  パラメーター:

  ignore - 検索で PartialResultException を無視する必要がある場合は true、それ以外の場合は false。デフォルトは false です。

• setIgnoreSizeLimitExceededException

  public void setIgnoreSizeLimitExceededException(boolean ignore)

  検索で SizeLimitExceededException を無視するかどうかを指定します。これは通常、検索コントロールでカウント制限を指定する場合に必要なものです。

  パラメーター:

  ignore - 検索で SizeLimitExceededException を無視する必要がある場合は true、それ以外の場合は false。デフォルトは true です。

  導入:

  2.0

• setDefaultSearchScope

  public void setDefaultSearchScope(int defaultSearchScope)

  明示的に指定しない場合は、検索で使用するデフォルトのスコープを設定します。デフォルトは SearchControls.SUBTREE_SCOPESE です。

  パラメーター:

  defaultSearchScope - 検索で使用するデフォルトの検索範囲。SearchControls.OBJECT_SCOPESE、SearchControls.ONELEVEL_SCOPESE、または SearchControls.SUBTREE_SCOPESE のいずれか

  導入:

  2.0

• setDefaultTimeLimit

  public void setDefaultTimeLimit(int defaultTimeLimit)

  明示的に指定されていない場合に、検索で使用されるデフォルトの時間制限を設定します。デフォルトは 0 で、時間制限がないことを示します。

  パラメーター:

  defaultTimeLimit - 検索で使用するデフォルトの制限時間。

  導入:

  2.0

• setDefaultCountLimit

  public void setDefaultCountLimit(int defaultCountLimit)

  明示的に指定されていない場合に検索で使用されるデフォルトのカウント制限を設定します。デフォルトは 0 で、カウント制限がないことを示します。

  パラメーター:

  defaultCountLimit - 検索で使用するデフォルトのカウント制限。

  導入:

  2.0

• search

  public void search(NameSE base, StringSE filter, int searchScope, boolean returningObjFlag, NameClassPairCallbackHandler handler)

  提供されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult は、指定された NameClassPairCallbackHandler に供給されます。指定された値を検索範囲に使用し、オブジェクトフラグを返します。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  base - 検索を開始するベース DN。

  filter - 検索で使用するフィルター。

  searchScope - SearchControls で設定する検索範囲。

  returningObjFlag - バインドされたオブジェクトを検索結果で返すかどうか。ContextMapper を使用する場合は、true に設定する必要があります。

  handler - SearchResults を供給する NameClassPairCallbackHandler。

• search

  public void search(StringSE base, StringSE filter, int searchScope, boolean returningObjFlag, NameClassPairCallbackHandler handler)

  提供されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult は、指定された NameClassPairCallbackHandler に供給されます。指定された値を検索範囲に使用し、オブジェクトフラグを返します。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  base - 検索を開始するベース DN。

  filter - 検索で使用するフィルター。

  searchScope - SearchControls で設定する検索範囲。

  returningObjFlag - バインドされたオブジェクトを検索結果で返すかどうか。ContextMapper を使用する場合は、true に設定する必要があります。

  handler - SearchResults を供給する NameClassPairCallbackHandler。

• search

  public void search(NameSE base, StringSE filter, SearchControlsSE controls, NameClassPairCallbackHandler handler)

  指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult は、指定された NameClassPairCallbackHandler に提供されます。指定された SearchControls で指定された SearchScope が検索に使用されます。ContextMapper を使用している場合は、SearchControls で returningObjFlag を true に設定する必要があることに注意してください。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  base - 検索を開始するベース DN。

  filter - 検索で使用するフィルター。

  controls - 検索で使用する SearchControls。

  handler - SearchResult を供給する NameClassPairCallbackHandler。

• search

  public void search(StringSE base, StringSE filter, SearchControlsSE controls, NameClassPairCallbackHandler handler)

  提供されたフィルターに一致するすべてのオブジェクトを検索します。詳細については、LdapOperations.search(Name, String, SearchControls, NameClassPairCallbackHandler) を参照してください。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  base - 検索を開始するベース DN。

  filter - 検索で使用するフィルター。

  controls - 検索で使用する SearchControls。

  handler - SearchResult を供給する NameClassPairCallbackHandler。

• search

  public void search(NameSE base, StringSE filter, SearchControlsSE controls, NameClassPairCallbackHandler handler, DirContextProcessor processor)

  指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult は、指定された NameClassPairCallbackHandler に提供されます。指定された SearchControls で指定された SearchScope が検索に使用されます。ContextMapper を使用している場合は、SearchControls で returningObjFlag を true に設定する必要があることに注意してください。指定された DirContextProcessor は、検索の前後に呼び出されます。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  base - 検索を開始するベース DN。

  filter - 検索で使用するフィルター。

  controls - 検索で使用する SearchControls。

  handler - SearchResult を供給する NameClassPairCallbackHandler。

  processor - 検索の前後に使用する DirContextProcessor。

• search

  public void search(StringSE base, StringSE filter, SearchControlsSE controls, NameClassPairCallbackHandler handler, DirContextProcessor processor)

  提供されたフィルターに一致するすべてのオブジェクトを検索します。詳細については、LdapOperations.search(Name, String, SearchControls, NameClassPairCallbackHandler, DirContextProcessor) を参照してください。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  base - 検索を開始するベース DN。

  filter - 検索で使用するフィルター。

  controls - 検索で使用する SearchControls。

  handler - SearchResults を供給する NameClassPairCallbackHandler。

  processor - 検索の前後に使用する DirContextProcessor。

• search

  public void search(SearchExecutor se, NameClassPairCallbackHandler handler, DirContextProcessor processor)

  search()、list()、listBindings() などの検索操作を実行します。この方法はすべての接続機能を処理します。読み取り専用コンテキストを取得します。NamingEnumeration をループし、コンテキストと列挙を閉じます。また、検索の前後に、それぞれ提供された DirContextProcessor を呼び出します。これにより、ページングされた結果や他の検索コントロールを処理する場合など、カスタムの前処理と後処理が可能になります。

  実際のリストは SearchExecutor に委譲され、各 NameClassPairSE (これは NameClassPair またはそのサブクラスである可能性があります) が CallbackHandler に渡されます。NamingException が見つかった場合は、NamingExceptionTranslator を使用して変換されます。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  se - 実際のリストを実行するために使用する SearchExecutor。

  handler - 見つかった各エントリが渡される NameClassPairCallbackHandler。

  processor - DirContextProcessor はカスタムの前処理および後処理用です。null であってはなりません。カスタム処理を行わない場合は、例を使用してください。search(SearchExecutor, NameClassPairCallbackHandler)。

  例外:

  NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。

• search

  public void search(SearchExecutor se, NameClassPairCallbackHandler handler)

  search()、list()、listBindings() などの検索操作を実行します。この方法はすべての接続機能を処理します。読み取り専用コンテキストを取得します。NamingEnumeration をループし、コンテキストと列挙を閉じます。

  実際のリストは SearchExecutor に委譲され、各 NameClassPairSE (これは NameClassPair またはそのサブクラスである可能性があります) が CallbackHandler に渡されます。NamingException が見つかった場合は、NamingExceptionTranslator を使用して変換されます。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  se - 実際のリストを実行するために使用する SearchExecutor。

  handler - 見つかった各エントリが渡される NameClassPairCallbackHandler。

  例外:

  NamingException - エラーが発生した場合。NameNotFoundException は無視されることに注意してください。代わりに、これはエントリが見つからなかったと解釈されます。

  関連事項:

  • LdapOperations.search(Name, String, AttributesMapper)
  • LdapOperations.search(Name, String, ContextMapper)

• search

  public void search(NameSE base, StringSE filter, NameClassPairCallbackHandler handler)

  指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult は指定された NameClassPairCallbackHandler に提供されます。デフォルトの検索範囲 ( SearchControls.SUBTREE_SCOPE) が使用され、returnObjects フラグは false に設定されます。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  base - 検索を開始するベース DN。

  filter - 検索で使用するフィルター。

  handler - SearchResults を供給する NameClassPairCallbackHandler。

• search

  public void search(StringSE base, StringSE filter, NameClassPairCallbackHandler handler)

  指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult は指定された NameClassPairCallbackHandler に提供されます。デフォルトの検索範囲 ( SearchControls.SUBTREE_SCOPE) が使用され、returnObjects フラグは false に設定されます。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  base - 検索を開始するベース DN。

  filter - 検索で使用するフィルター。

  handler - SearchResults を供給する NameClassPairCallbackHandler。

• search

  public <T> ListSE<T> search(NameSE base, StringSE filter, int searchScope, StringSE[] attrs, AttributesMapper<T> mapper)

  指定されたフィルターに一致するすべてのオブジェクトを検索します。指定された属性名と一致する属性のみを返します。各 SearchResult の属性は、指定された AttributesMapper に提供されます。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  base - 検索を開始するベース DN。

  filter - 検索で使用するフィルター。

  searchScope - SearchControls で設定する検索範囲。

  attrs - 返す属性。null はすべての属性を返すことを意味します。

  mapper - 各エントリの変換に使用する AttributesMapper。

  戻り値:

  AttributesMapper から受信したすべてのエントリを含む List。

• search

  public <T> ListSE<T> search(StringSE base, StringSE filter, int searchScope, StringSE[] attrs, AttributesMapper<T> mapper)

  指定されたフィルターに一致するすべてのオブジェクトを検索します。指定された属性名と一致する属性のみを返します。各 SearchResult の属性は、指定された AttributesMapper に提供されます。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  base - 検索を開始するベース DN。

  filter - 検索で使用するフィルター。

  searchScope - SearchControls で設定する検索範囲。

  attrs - 返す属性。null はすべての属性を返すことを意味します。

  mapper - 各エントリの変換に使用する AttributesMapper。

  戻り値:

  AttributesMapper から受信したすべてのエントリを含む List。

• search

  public <T> ListSE<T> search(NameSE base, StringSE filter, int searchScope, AttributesMapper<T> mapper)

  指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult の属性は、指定された AttributesMapper に提供されます。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  base - 検索を開始するベース DN。

  filter - 検索で使用するフィルター。

  searchScope - SearchControls で設定する検索範囲。

  mapper - 各エントリの変換に使用する AttributesMapper。

  戻り値:

  AttributesMapper から受信したすべてのエントリを含む List。

• search

  public <T> ListSE<T> search(StringSE base, StringSE filter, int searchScope, AttributesMapper<T> mapper)

  指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult の属性は、指定された AttributesMapper に提供されます。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  base - 検索を開始するベース DN。

  filter - 検索で使用するフィルター。

  searchScope - SearchControls で設定する検索範囲。

  mapper - 各エントリの変換に使用する AttributesMapper。

  戻り値:

  AttributesMapper から受信したすべてのエントリを含む List。

• search

  public <T> ListSE<T> search(NameSE base, StringSE filter, AttributesMapper<T> mapper)

  指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult の属性は、指定された AttributesMapper に提供されます。デフォルトの検索範囲が使用されます。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  base - 検索を開始するベース DN。

  filter - 検索で使用するフィルター。

  mapper - 各エントリの変換に使用する AttributesMapper。

  戻り値:

  AttributesMapper から受信したすべてのエントリを含む List。

• search

  public <T> ListSE<T> search(StringSE base, StringSE filter, AttributesMapper<T> mapper)

  指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult の属性は、指定された AttributesMapper に提供されます。デフォルトの検索範囲が使用されます。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  base - 検索を開始するベース DN。

  filter - 検索で使用するフィルター。

  mapper - 各エントリの変換に使用する AttributesMapper。

  戻り値:

  AttributesMapper から受信したすべてのエントリを含む List。

• search

  public <T> ListSE<T> search(NameSE base, StringSE filter, int searchScope, StringSE[] attrs, ContextMapper<T> mapper)

  指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult で返される Object は、指定された ContextMapper に提供されます。指定された属性のみを返します。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  base - 検索を開始するベース DN。

  filter - 検索で使用するフィルター。

  searchScope - SearchControls で設定する検索範囲。

  attrs - 返される属性。null はすべての属性を意味します。

  mapper - 各エントリの変換に使用する ContextMapper。

  戻り値:

  ContextMapper から受信したすべてのエントリを含む List。

• search

  public <T> ListSE<T> search(StringSE base, StringSE filter, int searchScope, StringSE[] attrs, ContextMapper<T> mapper)

  指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult で返される Object は、指定された ContextMapper に提供されます。指定された属性のみを返します。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  base - 検索を開始するベース DN。

  filter - 検索で使用するフィルター。

  searchScope - SearchControls で設定する検索範囲。

  attrs - 返される属性。null はすべての属性を意味します。

  mapper - 各エントリの変換に使用する ContextMapper。

  戻り値:

  ContextMapper から受信したすべてのエントリを含む List。

• search

  public <T> ListSE<T> search(NameSE base, StringSE filter, int searchScope, ContextMapper<T> mapper)

  指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult で返される Object は、指定された ContextMapper に提供されます。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  base - 検索を開始するベース DN。

  filter - 検索で使用するフィルター。

  searchScope - SearchControls で設定する検索範囲。

  mapper - 各エントリの変換に使用する ContextMapper。

  戻り値:

  ContextMapper から受信したすべてのエントリを含む List。

• search

  public <T> ListSE<T> search(StringSE base, StringSE filter, int searchScope, ContextMapper<T> mapper)

  指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult で返される Object は、指定された ContextMapper に提供されます。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  base - 検索を開始するベース DN。

  filter - 検索で使用するフィルター。

  searchScope - SearchControls で設定する検索範囲。

  mapper - 各エントリの変換に使用する ContextMapper。

  戻り値:

  ContextMapper から受信したすべてのエントリを含む List。

• search

  public <T> ListSE<T> search(NameSE base, StringSE filter, ContextMapper<T> mapper)

  指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult で返される Object は、指定された ContextMapper に提供されます。デフォルトの検索範囲 (SearchControls.SUBTREE_SCOPE) が使用されます。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  base - 検索を開始するベース DN。

  filter - 検索で使用するフィルター。

  mapper - 各エントリの変換に使用する ContextMapper。

  戻り値:

  ContextMapper から受信したすべてのエントリを含む List。

• search

  public <T> ListSE<T> search(StringSE base, StringSE filter, ContextMapper<T> mapper)

  指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult で返される Object は、指定された ContextMapper に提供されます。デフォルトの検索範囲 (SearchControls.SUBTREE_SCOPE) が使用されます。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  base - 検索を開始するベース DN。

  filter - 検索で使用するフィルター。

  mapper - 各エントリの変換に使用する ContextMapper。

  戻り値:

  ContextMapper から受信したすべてのエントリを含む List。

• search

  public <T> ListSE<T> search(StringSE base, StringSE filter, SearchControlsSE controls, ContextMapper<T> mapper)

  指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult で返される Object は、指定された ContextMapper に提供されます。デフォルトの検索範囲 (SearchControls.SUBTREE_SCOPE) が使用されます。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  base - 検索を開始するベース DN。

  filter - 検索で使用するフィルター。

  mapper - 各エントリの変換に使用する ContextMapper。

  戻り値:

  ContextMapper から受信したすべてのエントリを含む List。

• search

  public <T> ListSE<T> search(NameSE base, StringSE filter, SearchControlsSE controls, ContextMapper<T> mapper)

  指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult で返されたオブジェクトは、指定された ContextMapper に提供されます。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  base - 検索を開始するベース DN。

  filter - 検索で使用するフィルター。

  controls - 検索で使用する SearchControls。SearchControls に returnObjFlag が設定されていない場合、このメソッドは ContextMapper が動作するために必要なため、自動的に設定します。

  mapper - 各エントリの変換に使用する ContextMapper。

  戻り値:

  ContextMapper から受信したすべてのエントリを含む List。

• search

  public <T> ListSE<T> search(NameSE base, StringSE filter, SearchControlsSE controls, AttributesMapper<T> mapper)

  指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult で返される属性は、指定された AttributesMapper に提供されます。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  base - 検索を開始するベース DN。

  filter - 検索で使用するフィルター。

  controls - 検索で使用する SearchControls。

  mapper - 各エントリの変換に使用する AttributesMapper。

  戻り値:

  ContextMapper から受信したすべてのエントリを含む List。

• search

  public <T> ListSE<T> search(StringSE base, StringSE filter, SearchControlsSE controls, AttributesMapper<T> mapper)

  指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult で返される属性は、指定された AttributesMapper に提供されます。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  base - 検索を開始するベース DN。

  filter - 検索で使用するフィルター。

  controls - 検索で使用する SearchControls。

  mapper - 各エントリの変換に使用する AttributesMapper。

  戻り値:

  ContextMapper から受信したすべてのエントリを含む List。

• search

  public <T> ListSE<T> search(StringSE base, StringSE filter, SearchControlsSE controls, AttributesMapper<T> mapper, DirContextProcessor processor)

  指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult の属性は、指定された AttributesMapper に提供されます。提供された SearchControls で指定された SearchScope が検索に使用されます。指定された DirContextProcessor は、検索の前後に呼び出されます。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  base - 検索を開始するベース DN。

  filter - 検索で使用するフィルター。

  controls - 検索で使用する SearchControls。

  mapper - 各エントリの変換に使用する AttributesMapper。

  processor - 検索の前後に使用する DirContextProcessor。

  戻り値:

  AttributesMapper から受信したすべてのエントリを含む List。

• search

  public <T> ListSE<T> search(NameSE base, StringSE filter, SearchControlsSE controls, AttributesMapper<T> mapper, DirContextProcessor processor)

  指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult の属性は、指定された AttributesMapper に提供されます。提供された SearchControls で指定された SearchScope が検索に使用されます。指定された DirContextProcessor は、検索の前後に呼び出されます。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  base - 検索を開始するベース DN。

  filter - 検索で使用するフィルター。

  controls - 検索で使用する SearchControls。

  mapper - 各エントリの変換に使用する AttributesMapper。

  processor - 検索の前後に使用する DirContextProcessor。

  戻り値:

  AttributesMapper から受信したすべてのエントリを含む List。

• search

  public <T> ListSE<T> search(StringSE base, StringSE filter, SearchControlsSE controls, ContextMapper<T> mapper, DirContextProcessor processor)

  指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult で返されたオブジェクトは、指定された ContextMapper に提供されます。提供された SearchControls で指定された SearchScope が検索に使用されます。指定された DirContextProcessor は、検索の前後に呼び出されます。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  base - 検索を開始するベース DN。

  filter - 検索で使用するフィルター。

  controls - 検索で使用する SearchControls。SearchControls に returnObjFlag が設定されていない場合、このメソッドは ContextMapper が動作するために必要なため、自動的に設定します。

  mapper - 各エントリの変換に使用する ContextMapper。

  processor - 検索の前後に使用する DirContextProcessor。

  戻り値:

  ContextMapper から受信したすべてのエントリを含む List。

• search

  public <T> ListSE<T> search(NameSE base, StringSE filter, SearchControlsSE controls, ContextMapper<T> mapper, DirContextProcessor processor)

  指定されたフィルターに一致するすべてのオブジェクトを検索します。各 SearchResult で返されたオブジェクトは、指定された ContextMapper に提供されます。提供された SearchControls で指定された SearchScope が検索に使用されます。指定された DirContextProcessor は、検索の前後に呼び出されます。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  base - 検索を開始するベース DN。

  filter - 検索で使用するフィルター。

  controls - 検索で使用する SearchControls。SearchControls に returnObjFlag が設定されていない場合、このメソッドは ContextMapper が動作するために必要なため、自動的に設定します。

  mapper - 各エントリの変換に使用する ContextMapper。

  processor - 検索の前後に使用する DirContextProcessor。

  戻り値:

  ContextMapper から受信したすべてのエントリを含む List。

• list

  public void list(StringSE base, NameClassPairCallbackHandler handler)

  指定された base の子の非再帰リストを実行します。結果として得られる各 NameClassPair は、指定された NameClassPairCallbackHandler に提供されます。

  次で指定:

  インターフェース LdapOperations の list 

  パラメーター:

  base - リストを実行するベース DN。

  handler - NameClassPairCallbackHandler は各 NameClassPairSE に供給されます。

• list

  public void list(NameSE base, NameClassPairCallbackHandler handler)

  指定された base の子の非再帰リストを実行します。結果として得られる各 NameClassPair は、指定された NameClassPairCallbackHandler に提供されます。

  次で指定:

  インターフェース LdapOperations の list 

  パラメーター:

  base - リストを実行するベース DN。

  handler - NameClassPairCallbackHandler は各 NameClassPairSE に供給されます。

• list

  public <T> ListSE<T> list(StringSE base, NameClassPairMapper<T> mapper)

  指定された base の子の非再帰リストを実行します。見つかったすべての NameClassPair オブジェクトを指定された NameClassPairMapper に渡し、すべての戻り値を List として返します。

  次で指定:

  インターフェース LdapOperations の list 

  パラメーター:

  base - リストを実行するベース DN。

  mapper - NameClassPairMapper は各 NameClassPairSE に供給されます。

  戻り値:

  マッパーから返されたオブジェクトを含む List。

• list

  public <T> ListSE<T> list(NameSE base, NameClassPairMapper<T> mapper)

  指定された base の子の非再帰リストを実行します。見つかったすべての NameClassPair オブジェクトを指定された NameClassPairMapper に渡し、すべての戻り値を List として返します。

  次で指定:

  インターフェース LdapOperations の list 

  パラメーター:

  base - リストを実行するベース DN。

  mapper - NameClassPairMapper は各 NameClassPairSE に供給されます。

  戻り値:

  マッパーから返されたオブジェクトを含む List。

• list

  public ListSE<StringSE> list(NameSE base)

  指定された base の子の非再帰的なリストを実行します。

  次で指定:

  インターフェース LdapOperations の list 

  パラメーター:

  base - リストを実行するベース DN。

  戻り値:

  base にバインドされているすべてのコンテキストの名前を含むリスト。

• list

  public ListSE<StringSE> list(StringSE base)

  指定された base の子の非再帰的なリストを実行します。

  次で指定:

  インターフェース LdapOperations の list 

  パラメーター:

  base - リストを実行するベース DN。

  戻り値:

  base にバインドされているすべてのコンテキストの名前を含むリスト。

• listBindings

  public void listBindings(StringSE base, NameClassPairCallbackHandler handler)

  指定された base の子の非再帰リストを実行します。結果として得られる各 Binding は、指定された NameClassPairCallbackHandler に提供されます。

  次で指定:

  インターフェース LdapOperations の listBindings 

  パラメーター:

  base - リストを実行するベース DN。

  handler - NameClassPairCallbackHandler は各 BindingSE に供給されます。

• listBindings

  public void listBindings(NameSE base, NameClassPairCallbackHandler handler)

  指定された base の子の非再帰リストを実行します。結果として得られる各 Binding は、指定された NameClassPairCallbackHandler に提供されます。

  次で指定:

  インターフェース LdapOperations の listBindings 

  パラメーター:

  base - リストを実行するベース DN。

  handler - NameClassPairCallbackHandler は各 BindingSE に供給されます。

• listBindings

  public <T> ListSE<T> listBindings(StringSE base, NameClassPairMapper<T> mapper)

  指定された base の子の非再帰リストを実行します。見つかったすべての Binding オブジェクトを指定された NameClassPairMapper に渡し、すべての戻り値を List として返します。

  次で指定:

  インターフェース LdapOperations の listBindings 

  パラメーター:

  base - リストを実行するベース DN。

  mapper - NameClassPairMapper は各 BindingSE に供給されます。

  戻り値:

  マッパーから返されたオブジェクトを含む List。

• listBindings

  public <T> ListSE<T> listBindings(NameSE base, NameClassPairMapper<T> mapper)

  指定された base の子の非再帰リストを実行します。見つかったすべての Binding オブジェクトを指定された NameClassPairMapper に渡し、すべての戻り値を List として返します。

  次で指定:

  インターフェース LdapOperations の listBindings 

  パラメーター:

  base - リストを実行するベース DN。

  mapper - NameClassPairMapper は各 BindingSE に供給されます。

  戻り値:

  マッパーから返されたオブジェクトを含む List。

• listBindings

  public ListSE<StringSE> listBindings(StringSE base)

  指定された base の子の非再帰的なリストを実行します。

  次で指定:

  インターフェース LdapOperations の listBindings 

  パラメーター:

  base - リストを実行するベース DN。

  戻り値:

  base にバインドされたすべてのコンテキストの名前を含む List。

• listBindings

  public ListSE<StringSE> listBindings(NameSE base)

  指定された base の子の非再帰的なリストを実行します。

  次で指定:

  インターフェース LdapOperations の listBindings 

  パラメーター:

  base - リストを実行するベース DN。

  戻り値:

  base にバインドされたすべてのコンテキストの名前を含む List。

• listBindings

  public <T> ListSE<T> listBindings(StringSE base, ContextMapper<T> mapper)

  指定された base の子の非再帰リストを実行します。各 BindingSE で返されるオブジェクトは、指定された ContextMapper に提供されます。

  次で指定:

  インターフェース LdapOperations の listBindings 

  パラメーター:

  base - リストを実行するベース DN。

  mapper - 見つかったオブジェクトのマッピングに使用する ContextMapper。

  戻り値:

  ContextMapper から受信したすべてのエントリを含む List。

• listBindings

  public <T> ListSE<T> listBindings(NameSE base, ContextMapper<T> mapper)

  指定された base の子の非再帰リストを実行します。各 BindingSE で返されるオブジェクトは、指定された ContextMapper に提供されます。

  次で指定:

  インターフェース LdapOperations の listBindings 

  パラメーター:

  base - リストを実行するベース DN。

  mapper - 見つかったオブジェクトのマッピングに使用する ContextMapper。

  戻り値:

  ContextMapper から受信したすべてのエントリを含む List。

• executeReadOnly

  public <T> T executeReadOnly(ContextExecutor<T> ce)

  読み取り専用コンテキストで操作 (または一連の操作) を実行します。このメソッドは、DirContext を取得し、例外を変換し、その後コンテキストを閉じるという接続機能作業を処理します。このメソッドは検索を目的としたものではありません。これには、LdapOperations.search(SearchExecutor, NameClassPairCallbackHandler) またはオーバーロードされた検索メソッドのいずれかを使用します。

  次で指定:

  インターフェース LdapOperations の executeReadOnly 

  パラメーター:

  ce - DirContext 上の実際の操作が委譲される ContextExecutor。

  戻り値:

  ContextExecutor の動作結果です。

  関連事項:

  • LdapOperations.search(SearchExecutor, NameClassPairCallbackHandler)
  • LdapOperations.search(Name, String, AttributesMapper)
  • LdapOperations.search(Name, String, ContextMapper)

• executeReadWrite

  public <T> T executeReadWrite(ContextExecutor<T> ce)

  読み取り / 書き込みコンテキストで操作 (または一連の操作) を実行します。このメソッドは、DirContext を取得し、例外を変換し、その後コンテキストを閉じるという接続機能作業を処理します。このメソッドは、このインターフェースに使用する適切なメソッドがない、非常に特殊なケースのみを対象としています。

  次で指定:

  インターフェース LdapOperations の executeReadWrite 

  パラメーター:

  ce - DirContext 上の実際の操作が委譲される ContextExecutor。

  戻り値:

  ContextExecutor の動作結果です。

  関連事項:

  • LdapOperations.bind(Name, Object, Attributes)
  • LdapOperations.unbind(Name)
  • LdapOperations.rebind(Name, Object, Attributes)
  • LdapOperations.rename(Name, Name)
  • LdapOperations.modifyAttributes(Name, ModificationItem[])

• lookup

  public ObjectSE lookup(NameSE dn)

  指定された DN を検索し、見つかったオブジェクトを返します。DirObjectFactory が ContextSource で変更されていない限り、これは通常 DirContextAdapter になります。

  次で指定:

  インターフェース LdapOperations の lookup 

  パラメーター:

  dn - 検索するオブジェクトの識別名。

  戻り値:

  見つかったオブジェクト (通常は DirContextAdapter インスタンス)。

  関連事項:

  • LdapOperations.lookupContext(Name)
  • AbstractContextSource.setDirObjectFactory(Class)

• lookup

  public ObjectSE lookup(StringSE dn)

  指定された DN を検索し、見つかったオブジェクトを返します。DirObjectFactory が ContextSource で変更されていない限り、これは通常 DirContextAdapter になります。

  次で指定:

  インターフェース LdapOperations の lookup 

  パラメーター:

  dn - 検索するオブジェクトの識別名。

  戻り値:

  見つかったオブジェクト (通常は DirContextAdapter インスタンス)。

  関連事項:

  • LdapOperations.lookupContext(String)
  • AbstractContextSource.setDirObjectFactory(Class)

• lookup

  public <T> T lookup(NameSE dn, AttributesMapper<T> mapper)

  指定された DN の属性を取得し、自動的に AttributesMapper に渡す便利なメソッド。

  次で指定:

  インターフェース LdapOperations の lookup 

  パラメーター:

  dn - 検索する識別名。

  mapper - 見つかったオブジェクトのマッピングに使用する AttributesMapper。

  戻り値:

  マッパーから返されたオブジェクト。

• lookup

  public <T> T lookup(StringSE dn, AttributesMapper<T> mapper)

  指定された DN の属性を取得し、自動的に AttributesMapper に渡す便利なメソッド。

  次で指定:

  インターフェース LdapOperations の lookup 

  パラメーター:

  dn - 検索する識別名。

  mapper - 見つかったオブジェクトのマッピングに使用する AttributesMapper。

  戻り値:

  マッパーから返されたオブジェクト。

• lookup

  public <T> T lookup(NameSE dn, ContextMapper<T> mapper)

  指定された DN をルックアップし、見つかったオブジェクトを自動的に ContextMapper に渡す便利なメソッド。

  次で指定:

  インターフェース LdapOperations の lookup 

  パラメーター:

  dn - 検索する識別名。

  mapper - 見つかったオブジェクトのマッピングに使用する ContextMapper。

  戻り値:

  マッパーから返されたオブジェクト。

• lookup

  public <T> T lookup(StringSE dn, ContextMapper<T> mapper)

  指定された DN をルックアップし、見つかったオブジェクトを自動的に ContextMapper に渡す便利なメソッド。

  次で指定:

  インターフェース LdapOperations の lookup 

  パラメーター:

  dn - 検索する識別名。

  mapper - 見つかったオブジェクトのマッピングに使用する ContextMapper。

  戻り値:

  マッパーから返されたオブジェクト。

• lookup

  public <T> T lookup(NameSE dn, StringSE[] attributes, AttributesMapper<T> mapper)

  指定された DN の指定された属性を取得し、AttributesMapper に自動的に渡す簡易メソッド。

  次で指定:

  インターフェース LdapOperations の lookup 

  パラメーター:

  dn - 検索する識別名。

  attributes - マッパーに渡す属性の名前。

  mapper - 見つかったオブジェクトのマッピングに使用する AttributesMapper。

  戻り値:

  マッパーから返されたオブジェクト。

• lookup

  public <T> T lookup(StringSE dn, StringSE[] attributes, AttributesMapper<T> mapper)

  指定された DN の指定された属性を取得し、AttributesMapper に自動的に渡す簡易メソッド。

  次で指定:

  インターフェース LdapOperations の lookup 

  パラメーター:

  dn - 検索する識別名。

  attributes - マッパーに渡す属性の名前。

  mapper - 見つかったオブジェクトのマッピングに使用する AttributesMapper。

  戻り値:

  マッパーから返されたオブジェクト。

• lookup

  public <T> T lookup(NameSE dn, StringSE[] attributes, ContextMapper<T> mapper)

  指定された DN の指定された属性を取得し、自動的に ContextMapper に渡す簡易メソッド。

  次で指定:

  インターフェース LdapOperations の lookup 

  パラメーター:

  dn - 検索する識別名。

  attributes - マッパーに渡す属性の名前。

  mapper - 見つかったオブジェクトのマッピングに使用する ContextMapper。

  戻り値:

  マッパーから返されたオブジェクト。

• lookup

  public <T> T lookup(StringSE dn, StringSE[] attributes, ContextMapper<T> mapper)

  指定された DN の指定された属性を取得し、自動的に ContextMapper に渡す簡易メソッド。

  次で指定:

  インターフェース LdapOperations の lookup 

  パラメーター:

  dn - 検索する識別名。

  attributes - マッパーに渡す属性の名前。

  mapper - 見つかったオブジェクトのマッピングに使用する ContextMapper。

  戻り値:

  マッパーから返されたオブジェクト。

• modifyAttributes

  public void modifyAttributes(NameSE dn, ModificationItemSE[] mods)

  提供された ModificationItems を使用して LDAP ツリーのエントリを変更します。

  次で指定:

  インターフェース LdapOperations の modifyAttributes 

  パラメーター:

  dn - 変更するノードの識別名。

  mods - 実行する変更。

  関連事項:

  • LdapOperations.modifyAttributes(DirContextOperations)

• modifyAttributes

  public void modifyAttributes(StringSE dn, ModificationItemSE[] mods)

  提供された ModificationItems を使用して LDAP ツリーのエントリを変更します。

  次で指定:

  インターフェース LdapOperations の modifyAttributes 

  パラメーター:

  dn - 変更するノードの識別名。

  mods - 実行する変更。

  関連事項:

  • LdapOperations.modifyAttributes(DirContextOperations)

• bind

  public void bind(NameSE dn, ObjectSE obj, AttributesSE attributes)

  LDAP ツリーにエントリを作成します。エントリの作成に使用される属性は、obj パラメーターまたは attributes パラメーター (あるいはその両方) から取得されます。これらのパラメーターの 1 つは null である可能性がありますが、両方を指定することはできません。

  次で指定:

  インターフェース LdapOperations の bind 

  パラメーター:

  dn - オブジェクトと属性をバインドする識別名。

  obj - バインドするオブジェクトは null である可能性があります。通常は DirContext 実装です。

  attributes - バインドする属性は null である可能性があります。

  関連事項:

  • DirContextAdapter

• bind

  public void bind(StringSE dn, ObjectSE obj, AttributesSE attributes)

  LDAP ツリーにエントリを作成します。エントリの作成に使用される属性は、obj パラメーターまたは attributes パラメーター (あるいはその両方) から取得されます。これらのパラメーターの 1 つは null である可能性がありますが、両方を指定することはできません。

  次で指定:

  インターフェース LdapOperations の bind 

  パラメーター:

  dn - オブジェクトと属性をバインドする識別名。

  obj - バインドするオブジェクトは null である可能性があります。通常は DirContext 実装です。

  attributes - バインドする属性は null である可能性があります。

  関連事項:

  • DirContextAdapter

• unbind

  public void unbind(NameSE dn)

  LDAP ツリーからエントリを削除します。エントリには子が含まれていてはなりません。エントリに子孫がある可能性があると思われる場合は、代わりに LdapOperations.unbind(Name, boolean) を使用してください。

  次で指定:

  インターフェース LdapOperations の unbind 

  パラメーター:

  dn - 削除するエントリの識別名。

• unbind

  public void unbind(StringSE dn)

  LDAP ツリーからエントリを削除します。エントリには子が含まれていてはなりません。エントリに子孫がある可能性があると思われる場合は、代わりに LdapOperations.unbind(Name, boolean) を使用してください。

  次で指定:

  インターフェース LdapOperations の unbind 

  パラメーター:

  dn - バインドを解除する識別名。

• unbind

  public void unbind(NameSE dn, boolean recursive)

  LDAP ツリーからエントリを削除します。オプションで、プロセス内のすべての子孫を削除します。

  次で指定:

  インターフェース LdapOperations の unbind 

  パラメーター:

  dn - バインドを解除する識別名。

  recursive - すべてのサブコンテキストもバインド解除するかどうか。このパラメーターが false で、エントリに子がある場合、操作は失敗します。

• unbind

  public void unbind(StringSE dn, boolean recursive)

  LDAP ツリーからエントリを削除します。オプションで、プロセス内のすべての子孫を削除します。

  次で指定:

  インターフェース LdapOperations の unbind 

  パラメーター:

  dn - バインドを解除する識別名。

  recursive - すべてのサブコンテキストもバインド解除するかどうか。このパラメーターが false で、エントリに子がある場合、操作は失敗します。

• deleteRecursively

  protected void deleteRecursively(DirContextSE ctx, NameSE name)

  現在のものを含むすべてのサブコンテキストを再帰的に削除します。

  パラメーター:

  ctx - 削除に使用するコンテキスト。

  name - 再帰的に削除する開始点。

  例外:

  NamingException - エラーが発生した場合

• rebind

  public void rebind(NameSE dn, ObjectSE obj, AttributesSE attributes)

  エントリを削除し、新しいエントリと置き換えます。エントリの作成に使用される属性は、obj パラメーターまたは attributes パラメーター (あるいはその両方) から取得されます。これらのパラメーターの 1 つは null である可能性がありますが、両方を指定することはできません。このメソッドは、指定されたコンテキストがすでに存在していることを前提としています。存在しない場合は失敗します。

  次で指定:

  インターフェース LdapOperations の rebind 

  パラメーター:

  dn - 再バインドする識別名。

  obj - DN にバインドするオブジェクトは null である可能性があります。通常は DirContext 実装です。

  attributes - バインドする属性は null である可能性があります。

  関連事項:

  • DirContextAdapter

• rebind

  public void rebind(StringSE dn, ObjectSE obj, AttributesSE attributes)

  エントリを削除し、新しいエントリと置き換えます。エントリの作成に使用される属性は、obj パラメーターまたは attributes パラメーター (あるいはその両方) から取得されます。これらのパラメーターの 1 つは null である可能性がありますが、両方を指定することはできません。このメソッドは、指定されたコンテキストがすでに存在していることを前提としています。存在しない場合は失敗します。

  次で指定:

  インターフェース LdapOperations の rebind 

  パラメーター:

  dn - 再バインドする識別名。

  obj - DN にバインドするオブジェクトは null である可能性があります。通常は DirContext 実装です。

  attributes - バインドする属性は null である可能性があります。

  関連事項:

  • DirContextAdapter

• rename

  public void rename(NameSE oldDn, NameSE newDn)

  LDAP ツリー内のエントリを新しい場所に移動します。

  次で指定:

  インターフェース LdapOperations の rename 

  パラメーター:

  oldDn - 移動するエントリの識別名。null または空にすることはできません。

  newDn - エントリの移動先の識別名。null または空にすることはできません。

• rename

  public void rename(StringSE oldDn, StringSE newDn)

  LDAP ツリー内のエントリを新しい場所に移動します。

  次で指定:

  インターフェース LdapOperations の rename 

  パラメーター:

  oldDn - 移動するエントリの識別名。null または空にすることはできません。

  newDn - エントリの移動先の識別名。null または空にすることはできません。

• afterPropertiesSet

  public void afterPropertiesSet() throws ExceptionSE

  次で指定:

  インターフェース org.springframework.beans.factory.InitializingBean の afterPropertiesSet 

  例外:

  ExceptionSE

• lookupContext

  public DirContextOperations lookupContext(NameSE dn)

  提供された DN をルックアップし、自動的に DirContextOperations にキャストする便利なメソッド。

  次で指定:

  インターフェース LdapOperations の lookupContext 

  パラメーター:

  dn - 検索するオブジェクトの識別名。

  戻り値:

  見つかったオブジェクト。DirContextOperations にキャストされます。

  関連事項:

  • LdapOperations.lookup(Name)
  • LdapOperations.modifyAttributes(DirContextOperations)

• lookupContext

  public DirContextOperations lookupContext(StringSE dn)

  提供された DN をルックアップし、自動的に DirContextOperations にキャストする便利なメソッド。

  次で指定:

  インターフェース LdapOperations の lookupContext 

  パラメーター:

  dn - 検索するオブジェクトの識別名。

  戻り値:

  見つかったオブジェクト。DirContextOperations にキャストされます。

  関連事項:

  • LdapOperations.lookup(String)
  • LdapOperations.modifyAttributes(DirContextOperations)

• modifyAttributes

  public void modifyAttributes(DirContextOperations ctx)

  指定された 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);
   }
   

  次で指定:

  インターフェース LdapOperations の modifyAttributes 

  パラメーター:

  ctx - 更新で使用する DirContextOperations インスタンス。

  関連事項:

  • LdapOperations.lookupContext(Name)
  • DirContextAdapter

• bind

  public 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);
   

  次で指定:

  インターフェース LdapOperations の bind 

  パラメーター:

  ctx - バインドするコンテキスト

• rebind

  public 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);
   

  次で指定:

  インターフェース LdapOperations の rebind 

  パラメーター:

  ctx - 再バインドするコンテキスト

• authenticate

  public 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);
   

  次で指定:

  インターフェース LdapOperations の authenticate 

  パラメーター:

  base - 検索のベースとして使用する DN。

  filter - 検索フィルター - 一意の結果が得られる必要があります。

  password - 認証に使用するパスワード。

  戻り値:

  認証が成功した場合は true、そうでない場合は false。

• authenticate

  public 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);
   

  次で指定:

  インターフェース LdapOperations の authenticate 

  パラメーター:

  base - 検索のベースとして使用する DN。

  filter - 検索フィルター - 一意の結果が得られる必要があります。

  password - 認証に使用するパスワード。

  戻り値:

  認証が成功した場合は true、そうでない場合は false。

• authenticate

  public boolean authenticate(StringSE base, StringSE filter, StringSE password, AuthenticatedLdapEntryContextCallback callback)

  単純な LDAP ' バインド ' 認証を実行するユーティリティメソッド。LDAP エントリを検索し、指定されたベース DN とフィルターを使用して認証します。見つかったエントリの DN をパスワードとともに ContextSource.getContext(String, String) への入力として使用し、エントリを認証します。結果の DirContext インスタンスは、認証された DirContext に対して追加の LDAP 操作を実行するために、提供された AuthenticatedLdapEntryContextCallback への入力として使用されます。

  次で指定:

  インターフェース LdapOperations の authenticate 

  パラメーター:

  base - 検索のベースとして使用する DN。

  filter - 検索フィルター - 一意の結果が得られる必要があります。

  password - 認証に使用するパスワード。

  callback - 見つかったユーザーで認証された DirContext で操作を実行するために、そのコールバックが呼び出されます。

  戻り値:

  認証が成功した場合は true、そうでない場合は false。

  関連事項:

  • LdapOperations.authenticate(String, String, String)

• authenticate

  public boolean authenticate(NameSE base, StringSE filter, StringSE password, AuthenticatedLdapEntryContextCallback callback)

  単純な LDAP ' バインド ' 認証を実行するユーティリティメソッド。LDAP エントリを検索し、指定されたベース DN とフィルターを使用して認証します。見つかったエントリの DN をパスワードとともに ContextSource.getContext(String, String) への入力として使用し、エントリを認証します。結果の DirContext インスタンスは、認証された DirContext に対して追加の LDAP 操作を実行するために、提供された AuthenticatedLdapEntryContextCallback への入力として使用されます。

  次で指定:

  インターフェース LdapOperations の authenticate 

  パラメーター:

  base - 検索のベースとして使用する DN。

  filter - 検索フィルター - 一意の結果が得られる必要があります。

  password - 認証に使用するパスワード。

  callback - 見つかったユーザーで認証された DirContext で操作を実行するために、そのコールバックが呼び出されます。

  戻り値:

  認証が成功した場合は true、そうでない場合は false。

  関連事項:

  • LdapOperations.authenticate(Name, String, String)

• authenticate

  public boolean authenticate(StringSE base, StringSE filter, StringSE password, AuthenticationErrorCallback errorCallback)

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

  次で指定:

  インターフェース LdapOperations の authenticate 

  パラメーター:

  base - 検索のベースとして使用する DN。

  filter - 検索フィルター - 一意の結果が得られる必要があります。

  password - 認証に使用するパスワード。

  errorCallback - 例外がキャッチされた場合に呼び出されるコールバック。

  戻り値:

  認証が成功した場合は true、そうでない場合は false。

• authenticate

  public boolean authenticate(NameSE base, StringSE filter, StringSE password, AuthenticationErrorCallback errorCallback)

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

  次で指定:

  インターフェース LdapOperations の authenticate 

  パラメーター:

  base - 検索のベースとして使用する DN。

  filter - 検索フィルター - 一意の結果が得られる必要があります。

  password - 認証に使用するパスワード。

  errorCallback - 例外がキャッチされた場合に呼び出されるコールバック。

  戻り値:

  認証が成功した場合は true、そうでない場合は false。

  関連事項:

  • LdapOperations.authenticate(Name, String, String, AuthenticatedLdapEntryContextCallback, AuthenticationErrorCallback)

• authenticate

  public 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 に渡されます。これにより、呼び出し元は、たとえば後の処理のために例外を収集するコールバックを提供できるようになります。

  次で指定:

  インターフェース LdapOperations の authenticate 

  パラメーター:

  base - 検索のベースとして使用する DN。

  filter - 検索フィルター - 一意の結果が得られる必要があります。

  password - 認証に使用するパスワード。

  callback - 見つかったユーザーで認証された DirContext で操作を実行するために呼び出されるコールバック。

  errorCallback - 例外がキャッチされた場合に呼び出されるコールバック。

  戻り値:

  認証が成功した場合は true、そうでない場合は false。

  関連事項:

  • LdapOperations.authenticate(String, String, String, AuthenticatedLdapEntryContextCallback)

• authenticate

  public 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 に渡されます。これにより、呼び出し元は、たとえば後の処理のために例外を収集するコールバックを提供できるようになります。

  次で指定:

  インターフェース LdapOperations の authenticate 

  パラメーター:

  base - 検索のベースとして使用する DN。

  filter - 検索フィルター - 一意の結果が得られる必要があります。

  password - 認証に使用するパスワード。

  callback - 見つかったユーザーで認証された DirContext で操作を実行するために呼び出されるコールバック。

  errorCallback - 例外がキャッチされた場合に呼び出されるコールバック。

  戻り値:

  認証が成功した場合は true、そうでない場合は false。

  関連事項:

  • LdapOperations.authenticate(Name, String, String, AuthenticatedLdapEntryContextCallback)

• authenticate

  public <T> T authenticate(LdapQuery query, StringSE password, AuthenticatedLdapEntryContextMapper<T> mapper)

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

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

  次で指定:

  インターフェース LdapOperations の authenticate 

  パラメーター:

  query - 検索の詳細を指定する LdapQuery。

  password - 認証に使用するパスワード。

  mapper - 見つかったユーザーで認証された DirContext で操作を実行するために呼び出されるコールバック。それ以外の場合は false。

  戻り値:

  コールバックからの結果。

  関連事項:

  • LdapQueryBuilder

• authenticate

  public void authenticate(LdapQuery query, StringSE password)

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

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

  次で指定:

  インターフェース LdapOperations の authenticate 

  パラメーター:

  query - 検索の詳細を指定する LdapQuery。

  password - 認証に使用するパスワード。それ以外の場合は false。

  関連事項:

  • LdapQueryBuilder

• searchForObject

  public <T> T searchForObject(NameSE base, StringSE filter, ContextMapper<T> mapper)

  指定された検索条件に一致する一意のエントリの検索を実行し、見つかったオブジェクトを返します。エントリが見つからない場合、または一致するエントリが複数ある場合は、IncorrectResultSizeDataAccessException がスローされます。

  次で指定:

  インターフェース LdapOperations の searchForObject 

  パラメーター:

  base - 検索のベースとして使用する DN。

  filter - 検索フィルター。

  mapper - 検索に使用するマッパー。

  戻り値:

  マッパーによって返され、検索条件に一致する単一のオブジェクト。

• searchForObject

  public <T> T searchForObject(StringSE base, StringSE filter, ContextMapper<T> mapper)

  指定された検索条件に一致する一意のエントリの検索を実行し、見つかったオブジェクトを返します。エントリが見つからない場合、または一致するエントリが複数ある場合は、IncorrectResultSizeDataAccessException がスローされます。

  次で指定:

  インターフェース LdapOperations の searchForObject 

  パラメーター:

  base - 検索のベースとして使用する DN。

  filter - 検索フィルター。

  mapper - 検索に使用するマッパー。

  戻り値:

  マッパーによって返され、検索条件に一致する単一のオブジェクト。

• searchForObject

  public <T> T searchForObject(NameSE base, StringSE filter, SearchControlsSE searchControls, ContextMapper<T> mapper)

  指定された検索条件に一致する一意のエントリの検索を実行し、見つかったオブジェクトを返します。エントリが見つからない場合、または一致するエントリが複数ある場合は、IncorrectResultSizeDataAccessException がスローされます。

  次で指定:

  インターフェース LdapOperations の searchForObject 

  パラメーター:

  base - 検索のベースとして使用する DN。

  filter - 検索フィルター。

  searchControls - 検索に使用する searchControls。

  mapper - 検索に使用するマッパー。

  戻り値:

  マッパーによって返され、検索条件に一致する単一のオブジェクト。

• searchForObject

  public <T> T searchForObject(StringSE base, StringSE filter, SearchControlsSE searchControls, ContextMapper<T> mapper)

  指定された検索条件に一致する一意のエントリの検索を実行し、見つかったオブジェクトを返します。エントリが見つからない場合、または一致するエントリが複数ある場合は、IncorrectResultSizeDataAccessException がスローされます。

  次で指定:

  インターフェース LdapOperations の searchForObject 

  パラメーター:

  base - 検索のベースとして使用する DN。

  filter - 検索フィルター。

  searchControls - 検索に使用する searchControls。

  mapper - 検索に使用するマッパー。

  戻り値:

  マッパーによって返され、検索条件に一致する単一のオブジェクト。

• search

  public void search(LdapQuery query, NameClassPairCallbackHandler callbackHandler)

  指定した LdapQuery からパラメーターを使用して検索を実行します。見つかったすべてのオブジェクトは、処理のために NameClassPairCallbackHandler に提供されます。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  query - LDAP クエリの仕様。

  callbackHandler - 見つかったすべてのエントリを提供する NameClassPairCallbackHandler。

  関連事項:

  • LdapQueryBuilder
  • CountNameClassPairCallbackHandler

• search

  public <T> ListSE<T> search(LdapQuery query, ContextMapper<T> mapper)

  指定した LdapQuery からパラメーターを使用して検索を実行します。見つかったすべてのオブジェクトは処理のために ContextMapper に提供され、返されたすべてのオブジェクトは返されるリストに収集されます。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  query - LDAP クエリの仕様。

  mapper - 見つかったすべてのエントリを提供する ContextMapper。

  戻り値:

  ContextMapper から受信したすべてのエントリを含む List。

  関連事項:

  • LdapQueryBuilder

• search

  public <T> ListSE<T> search(LdapQuery query, AttributesMapper<T> mapper)

  指定した LdapQuery からパラメーターを使用して検索を実行します。見つかったエントリの属性は処理のために AttributesMapper に提供され、返されたすべてのオブジェクトは返されるリストに収集されます。

  次で指定:

  インターフェース LdapOperations の search 

  パラメーター:

  query - LDAP クエリの仕様。

  mapper - 見つかったすべての属性を提供する Attributes。

  戻り値:

  Attributes から受信したすべてのエントリを含む List。

  関連事項:

  • LdapQueryBuilder

• searchForContext

  public DirContextOperations searchForContext(LdapQuery query)

  指定された LDAP クエリに一致する一意のエントリの検索を実行し、見つかったエントリを DirContextOperation インスタンスとして返します。エントリが見つからない場合、または一致するエントリが複数ある場合は、IncorrectResultSizeDataAccessException がスローされます。

  次で指定:

  インターフェース LdapOperations の searchForContext 

  パラメーター:

  query - LDAP クエリの仕様。

  戻り値:

  DirContextOperations インスタンスとしてクエリに一致する単一のエントリ。

  関連事項:

  • LdapQueryBuilder

• searchForObject

  public <T> T searchForObject(LdapQuery query, ContextMapper<T> mapper)

  指定された LDAP クエリに一致する一意のエントリの検索を実行し、見つかったオブジェクトを返します。エントリが見つからない場合、または一致するエントリが複数ある場合は、IncorrectResultSizeDataAccessException がスローされます。

  次で指定:

  インターフェース LdapOperations の searchForObject 

  パラメーター:

  query - LDAP クエリの仕様。

  戻り値:

  マッパーによって返され、検索条件に一致する単一のオブジェクト。

  関連事項:

  • LdapQueryBuilder

• searchForStream

  public <T> StreamSE<T> searchForStream(LdapQuery query, AttributesMapper<T> attributesMapper)

  指定した LdapQuery からパラメーターを使用して検索を実行します。見つかったエントリの属性は処理のために AttributesMapper に提供され、返されたすべてのオブジェクトは返されるリストに収集されます。

  次で指定:

  インターフェース LdapOperations の searchForStream 

  パラメーター:

  query - LDAP クエリの仕様。

  attributesMapper - 見つかったすべての属性を提供する Attributes。

  戻り値:

  Attributes から受信したすべてのエントリの Stream。

  関連事項:

  • LdapQueryBuilder

• searchForStream

  public <T> StreamSE<T> searchForStream(LdapQuery query, ContextMapper<T> mapper)

  指定した LdapQuery からパラメーターを使用して検索を実行します。見つかったすべてのオブジェクトは処理のために ContextMapper に提供され、返されたすべてのオブジェクトは返されるリストに収集されます。

  次で指定:

  インターフェース LdapOperations の searchForStream 

  パラメーター:

  query - LDAP クエリの仕様。

  mapper - 見つかったすべてのエントリを提供する ContextMapper。

  戻り値:

  ContextMapper から受信したすべてのエントリの Stream。

  関連事項:

  • LdapQueryBuilder

• findByDn

  public <T> T findByDn(NameSE dn, ClassSE<T> clazz)

  LDAP ディレクトリから名前付きエントリを読み取ります。参照されるクラスには、Entry および関連するアノテーションを使用して指定されたオブジェクトとディレクトリのマッピングメタデータが必要です。

  次で指定:

  インターフェース LdapOperations の findByDn 

  型パラメーター:

  T - 返す Java の型

  パラメーター:

  dn - LDAP ディレクトリから読み取るエントリの識別名。

  clazz - 返す Java の型

  戻り値:

  ディレクトリから読み取られたエントリ

• create

  public void create(ObjectSE entry)

  LDAP ディレクトリに指定されたエントリを作成します。参照されるクラスには、Entry および関連するアノテーションを使用して指定されたオブジェクトとディレクトリのマッピングメタデータが必要です。Id のアノテーションが付けられたフィールドがオブジェクトに設定されている場合、これが新しいエントリの識別名として使用されます。明示的な DN が指定されていない場合は、DnAttribute のアノテーションが付けられたフィールドから名前を計算しようとします。ID を計算できる場合、指定されたオブジェクトに ID が設定されます。

  次で指定:

  インターフェース LdapOperations の create 

  パラメーター:

  entry - 作成するエントリは、null であってはならず、ディレクトリにすでに存在していてもなりません。

• update

  public void update(ObjectSE entry)

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

  次で指定:

  インターフェース LdapOperations の update 

  パラメーター:

  entry - 更新するエントリ。ディレクトリにすでに存在している必要があります。

• delete

  public void delete(ObjectSE entry)

  LDAP ディレクトリからエントリを削除します。参照されるクラスには、Entry および関連するアノテーションを使用して指定されたオブジェクトとディレクトリのマッピングメタデータが必要です。Id のアノテーションが付けられたフィールドがオブジェクトに設定されている場合、これが新しいエントリの識別名として使用されます。明示的な DN が指定されていない場合は、DnAttribute のアノテーションが付けられたフィールドから名前を計算しようとします。

  次で指定:

  インターフェース LdapOperations の delete 

  パラメーター:

  entry - 削除するエントリは、ディレクトリにすでに存在している必要があります。

• findAll

  public <T> ListSE<T> findAll(NameSE base, SearchControlsSE searchControls, ClassSE<T> clazz)

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

  次で指定:

  インターフェース LdapOperations の findAll 

  型パラメーター:

  T - 返す Java の型

  パラメーター:

  base - 検索を開始するサブツリーのルート。

  searchControls - 検索の検索コントロール。「返された属性」パラメーターは、返されたエントリに入力される属性に影響を与える可能性があるため、通常は改ざんしないでください。

  clazz - 返す Java の型

  戻り値:

  指定された Java クラスによって表される型のすべてのエントリ

• findAll

  public <T> ListSE<T> findAll(ClassSE<T> clazz)

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

  次で指定:

  インターフェース LdapOperations の findAll 

  型パラメーター:

  T - 返す Java の型

  パラメーター:

  clazz - 返す Java の型

  戻り値:

  指定された Java クラスによって表される型のすべてのエントリ

• find

  public <T> ListSE<T> find(NameSE base, Filter filter, SearchControlsSE searchControls, ClassSE<T> clazz)

  指定されたフィルターに一致する、指定された型の LDAP ディレクトリ内のすべてのエントリを検索します。参照されるクラスには、Entry および関連するアノテーションを使用して指定されたオブジェクトとディレクトリのマッピングメタデータが必要です。

  次で指定:

  インターフェース LdapOperations の find 

  型パラメーター:

  T - 返す Java の型

  パラメーター:

  base - 検索を開始するサブツリーのルート。

  filter - 検索フィルター。

  searchControls - 検索の検索コントロール。「返された属性」パラメーターは、返されたエントリに入力される属性に影響を与える可能性があるため、通常は改ざんしないでください。

  clazz - 返す Java の型

  戻り値:

  指定された Java クラスによって表される型のすべてのエントリ

• find

  public <T> ListSE<T> find(LdapQuery query, ClassSE<T> clazz)

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

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

  次で指定:

  インターフェース LdapOperations の find 

  型パラメーター:

  T - 返す Java の型

  パラメーター:

  query - LDAP クエリ仕様

  clazz - 返す Java の型

  戻り値:

  一致するすべてのエントリ。

  関連事項:

  • LdapQueryBuilder

• findOne

  public <T> T findOne(LdapQuery query, ClassSE<T> clazz)

  ディレクトリツリー内で指定された LdapQuery に一致するオブジェクトを検索します。一致するものが 1 つだけ見つかることを期待します。参照されるクラスには、Entry および関連するアノテーションを使用して指定されたオブジェクトとディレクトリのマッピングメタデータが必要です。

  次で指定:

  インターフェース LdapOperations の findOne 

  型パラメーター:

  T - 返す Java の型

  パラメーター:

  query - LDAP クエリ仕様

  clazz - 返す Java の型

  戻り値:

  検索仕様に一致する単一のエントリ。

• findForStream

  public <T> StreamSE<T> findForStream(LdapQuery query, ClassSE<T> clazz)

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

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

  次で指定:

  インターフェース LdapOperations の findForStream 

  型パラメーター:

  T - 返す Java の型

  パラメーター:

  query - LDAP クエリ仕様

  clazz - 返す Java の型

  戻り値:

  一致するすべてのエントリ。

  関連事項:

  • LdapQueryBuilder