SpringLDAP-Reference（中文文档）(五)

第五章 DirContext配制

5.1 自定义DirContext 前后处理
某些情况下，在搜索前后要调用DirContext进行操作，进行这种操作的接口为DirContextProcessor

publicinterfaceDirContextProcessor{
publicvoidpreProcess(DirContextctx)throwsNamingException;
publicvoidpostProcess(DirContextctx)throwsNamingException;
}
LdapTemplate有一个查询方法提供了DirContextProcessor

publicvoidsearch(SearchExecutorse,NameClassPairCallbackHandlerhandler,
DirContextProcessorprocessor)throwsDataAccessException;

在查询之前，前处理方法提供了一个DirContextProcessor的实例 ，当查询完成并处理后，调用后处理方法，这对于用户在查询中调用DirContext，查询完成后检查
DirContext非常有用。例如在处理请求和响应控制

也有一些并不需要自定义SearchExecutor的方法：

publicvoidsearch(Namebase,Stringfilter,
SearchControlscontrols,NameClassPairCallbackHandlerhandler,DirContextProcessorprocessor)
publicvoidsearch(Stringbase,Stringfilter,
SearchControlscontrols,NameClassPairCallbackHandlerhandler,DirContextProcessorprocessor)
publicvoidsearch(Namebase,Stringfilter,
SearchControlscontrols,AttributesMappermapper,DirContextProcessorprocessor)
publicvoidsearch(Stringbase,Stringfilter,
SearchControlscontrols,AttributesMappermapper,DirContextProcessorprocessor)
publicvoidsearch(Namebase,Stringfilter,
SearchControlscontrols,ContextMappermapper,DirContextProcessorprocessor)
publicvoidsearch(Stringbase,Stringfilter,
SearchControlscontrols,ContextMappermapper,DirContextProcessorprocessor)

5.2 实现一个请求控制的DirContextProcessor
LDAPv3标准使用控制器来发送和接收数据来影响一些预定义行为，为了简化一个请求控制DirContextProcessor的实现，spring ldap提供了一基类
AbstractRequestControlDirContextProcessor，这个方法来处理LdapContext的当前请求，控制方法调用一个模板创建的请求，并添加到Ldapcontext中，你要做的是在类中实现createRequestControl,和postProcess方法来实现查询后你要完成的操作。
publicabstractclassAbstractRequestControlDirContextProcessorimplements
DirContextProcessor{
publicvoidpreProcess(DirContextctx)throwsNamingException{
...
}
publicabstractControlcreateRequestControl();
}
一个典型的DirContextProcessor，类似如下代码：

例5.1 一个请求控制的实现
packagecom.example.control;
publicclassMyCoolRequestControlextendsAbstractRequestControlDirContextProcessor{
privatestaticfinalbooleanCRITICAL_CONTROL=true;
privateMyCoolCookiecookie;
...
publicMyCoolCookiegetCookie(){
returncookie;
}
publicControlcreateRequestControl(){
returnnewSomeCoolControl(cookie.getCookie(),CRITICAL_CONTROL);
}
publicvoidpostProcess(DirContextctx)throwsNamingException{
LdapContextldapContext=(LdapContext)ctx;
Control[]responseControls=ldapContext.getResponseControls();
for(inti=0;i<responseControls.length;i++){
if(responseControls[i]instanceofSomeCoolResponseControl){
SomeCoolResponseControlcontrol=(SomeCoolResponseControl)responseControls[i];
this.cookie=newMyCoolCookie(control.getCookie());
}
}
}
}

注意：
当前使用Controls时，一定要使用LdapContextSource，这个接口是特定的用来使用LdapContext代替DirContext的，如果一个AbstractRequestControlDirContextProcessor子类调用的不是一个LdapContext参数，它将抛出异常IllegalArgumentException

5.3 查询结果分页

某些查询可能返回大量结果集。当我们没有简便的方法去筛选出较小的数据量时，它将方便的让服务器返回一定数量结果集，这称为分页搜索。结果的每一页和上下页链接将被显示出来，如果没有这个功能，客户端需手动限制结果页或检索整个结果集截取一部分，前者比较麻烦，后者比较消耗内存。

许多Ldap服务器都支持PagedResultsControl，它发送请求，服务器返回搜索结果特定页，用户控制返回页进度（Rate），简单称为进度搜索，但是用户必须保持跟踪调用中的会话，使服务器知道上一次搜索结果页及从哪开始搜索。SpringLdap提供了使用LdapContext对搜索结果前后处理的分页方法，这在前面有讨论。它通过两个类
PagedResultsRequestControl和PagedResultsCookie，PagedResultsRequestControl类建立了一个PagedResultsControl来请求页面大小，并放入LdapContext中，搜索完成后，从PagedResultsResponseControl中得到两部分信息，预计总结果大小及cookie。cookie是一个字节数组，包含了通过PagedResultsControl下一次调用服务器时所需的信息，为了更好的存储这些信息，ldap提供了包装类PagedResultsCookie.

下面的例子展示了如何分页搜索。
例5.2 使用PagedResultsRequestControl返回分页结果

publicPagedResultgetAllPersons(PagedResultsCookiecookie){
PagedResultsRequestControlcontrol=newPagedResultsRequestControl(PAGE_SIZE,cookie);
SearchControlssearchControls=newSearchControls();
searchControls.setSearchScope(SearchControls.SUBTREE_SCOPE);
Listpersons=ldapTemplate.search("","objectclass=person",searchControls,control);
returnnewPagedResult(persons,control.getCookie());
}

第一次调用此方法，cookie参数将为NULL，但在随后的每一次调用时都要提供上次的PagedResult包装的cookie信息，当 Cookie无效时
（pagedResult.getCookie().getCookie() returns null），即表示最后一批结果已返回。