このバージョンはまだ開発中であり、まだ安定しているとは見なされていません。最新の安定バージョンについては、Spring LDAP 4.1.1 を使用してください!

Spring LDAP リポジトリ

Spring LDAP には Spring Data リポジトリのサポートが組み込まれています。基本的な機能と設定については、こちらで説明しています。Spring LDAP リポジトリを使用する際は、以下の点に注意してください。

  • XML 設定で <ldap:repositories> 要素を使用するか、設定クラスに @EnableLdapRepositories アノテーションを使用することで、Spring LDAP リポジトリを有効にできます。

  • 自動生成されたリポジトリに LdapQuery パラメーターのサポートを含めるには、インターフェースで CrudRepository ではなく LdapRepository を継承します。

  • すべての Spring LDAP リポジトリは、オブジェクトディレクトリマッピング (ODM) に従って、ODM アノテーションでアノテーションが付けられたエンティティと連携する必要があります。

  • ODM で管理されるすべてのクラスは識別名を ID として持つ必要があるため、すべての Spring LDAP リポジトリでは ID 型パラメーターを javax.naming.Name に設定する必要があります。組み込みの LdapRepository は、管理対象エンティティクラスという 1 つの型パラメーターのみを受け取り、ID はデフォルトで javax.naming.Name になります。

  • LDAP プロトコルの特性上、Spring LDAP リポジトリではページングとソートはサポートされていません。

QueryDSL のサポート

Spring LDAP には基本的な QueryDSL サポートが含まれています。このサポートには以下の内容が含まれます。

  • Spring LDAP ODM アノテーションに基づいて QueryDSL クラスを生成するためのアノテーションプロセッサー、LdapAnnotationProcessor。ODM アノテーションの詳細については、オブジェクトディレクトリマッピング (ODM) を参照してください。

  • コードで QueryDSL クエリを作成および実行するための QueryDslLdapQuery と呼ばれるクエリ実装。

  • QueryDSL 述語の Spring Data リポジトリサポート。QueryDslPredicateExecutor には、適切なパラメーターを持つ追加のメソッドが多数含まれています。このインターフェースを LdapRepository と共に拡張して、このサポートをリポジトリに組み込むことができます。