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），即表示最后一批结果已返回。