LdapQuery:高级构建查询
LDAP查询生成器参数
该类LdapQueryBuilder及其关联的类旨在支持可以提供给LDAP搜索的所有参数。支持以下参数:
base - 指定搜索应在其中开始的LDAP树中的根DN。searchScope - 指定搜索应该遍历的LDAP树的深度。attributes - 指定要从搜索中返回的属性。默认是全部。countLimit - 指定从搜索返回的最大条目数。timeLimit - 指定搜索可能需要的最长时间。Search filter - 我们正在查找的条目必须符合的条件。
通过LdapQueryBuilder调用query方法创建一个LdapQueryBuilder。它的目的是作为流畅的构建器API,其中首先定义基本参数,然后是过滤器规范调用。一旦过滤器条件已经开始被调用where方法定义LdapQueryBuilder,稍后尝试呼叫例如base将被拒绝。基本搜索参数是可选的,但至少需要一个过滤器规范调用。
使用objectclass person搜索所有条目
ldapTemplate.search(
query().where("objectclass").is("person"),
new PersonAttributesMapper());
使用objectclass person和cn = John Doe搜索所有条目
ldapTemplate.search(
query().where("objectclass").is("person")
.and("cn").is("John Doe"),
new PersonAttributesMapper());
使用在dc = 261consulting,dc = com处开始的objectclass人员搜索所有条目
ldapTemplate.search(
query().base("dc=261consulting,dc=com")
.where("objectclass").is("person"),
new PersonAttributesMapper());
搜索具有开始于dc = 261consulting,dc = com的objectclass人员的所有条目,仅返回cn属性
ldapTemplate.search(
query().base("dc=261consulting,dc=com")
.attributes("cn")
.where("objectclass").is("person"),
new PersonAttributesMapper());
//或用标准搜索
ldapTemplate.search(
query().where("objectclass").is("person"),
.and(query().where("cn").is("Doe").or("cn").is("Doo));
new PersonAttributesMapper());
过滤标准
is - 指定等于条件(=)。gte - 指定一个大于或等于条件(> =)。lte - 指定小于或等于条件(<=)。like- 指定查询中可以包含通配符的“like”条件,例如,where("cn").like("J*hn Doe")将导致整个过滤器(cn=J*hn Doe)。whitespaceWildcardsLike- 指定一个条件,用通配符替换所有的空白,例如where("cn").whitespaceWildcardsLike("John Doe")将导致过滤器。(cn=John*Doe)isPresent- 指定检查是否存在属性的条件,例如where("cn").isPresent()将导致过滤器(cn=*)。not- 指定当前条件应否定,例如where("sn").not().is("Doe)将导致过滤器(!(sn=Doe))
硬编码过滤器
有时你会想要指定一个硬编码过滤器作为输入LdapQuery。LdapQueryBuilder有两种方法可用于此目的:
filter(String hardcodedFilter) - 使用指定的字符串作为过滤器。请注意,指定的输入字符串不会以任何方式被触及,这意味着如果您要从用户输入构建过滤器,则此方法不是特别适合。filter(String filterFormat, String… params)- 使用指定的字符串作为输入MessageFormat,正确编码参数并将其插入到过滤器字符串中的指定位置。
注意:您不能将硬编码过滤器方法与上述where方法混合; 它是一个或另一个。这意味着如果你使用过滤器指定了一个过滤器,filter()如果你尝试where之后再调用,你会得到一个异常。