SpringLDAP-Reference（中文文档）(四)
第四章 添加missing API方法重载
?
4.1自定义查询方法
尽管在LdapTemplate中有很多的DirContext重载方法，但它不可能对每个方法都这样做，因为方法太多了，但是我们提供一种方法使用LdapTemplate来得到你想要的conetxt
比如说你要调用如下的context方法
?NamingEnumerationsearch(Namename,StringfilterExpr,Object[]filterArgs,SearchControlsctls)
在LdapTemplate中没有合适的重载方法，我们可以用自定义的SearchExecutor实现
?publicinterfaceSearchExecutor{
??publicNamingEnumerationexecuteSearch(DirContextctx)throwsNamingException;
?}
?
?在你自己定义的执行程序（executor）中,你可以连接DirContext，调用你想要的方法，然后你需要提供一个处理程序来处理返回结果。你可以使用现有的
?CollectingNameClassPairCallbackHandler,收集到一个内部集合中，为了执行搜索，在LdapTemplate中需要一个执行程序和处理程序（an executor and a handler）
?最后，返回你想要的结果集合
?
?例4.1 使用SearchExecutor和AttributesMapper执行自定义查询
?
??packagecom.example.dao;
??publicclassPersonDaoImplimplementsPersonDao{
??...
??publicListsearch(finalNamebase,finalStringfilter,finalString[]params,
??finalSearchControlsctls){
??SearchExecutorexecutor=newSearchExecutor(){
??publicNamingEnumerationexecuteSearch(DirContextctx){
??returnctx.search(base,filter,params,ctls);
??}
??};
??CollectingNameClassPairCallbackHandlerhandler=
??newAttributesMapperCallbackHandler(newPersonAttributesMapper());
??ldapTemplate.search(executor,handler);
??returnhandler.getList();
??}
??}
??
??如果你更喜欢用ContextMapper生成AttributesMapper,可以这样
??
??例4.2 使用 SearchExecutor and ContextMapper的查询方法
??packagecom.example.dao;
??publicclassPersonDaoImplimplementsPersonDao{
??...
??publicListsearch(finalNamebase,finalStringfilter,finalString[]params,
??finalSearchControlsctls){
??SearchExecutorexecutor=newSearchExecutor(){
??publicNamingEnumerationexecuteSearch(DirContextctx){
??returnctx.search(base,filter,params,ctls);
??}
??};
??CollectingNameClassPairCallbackHandlerhandler=
??newContextMapperCallbackHandler(newPersonContextMapper());
??ldapTemplate.search(executor,handler);
??returnhandler.getList();
??}
??}
??
??注意
??
??当我们使用ContextMapperCallbackHandler时，必须在SearchControls中setReturningObjFlag(true)
??
??4.2 实现其它自定义的Context Methods
??
??同自定义查询方法一样，你可以在Dircontext中使用ContextExecutor
??
???publicinterfaceContextExecutor{
???publicObjectexecuteWithContext(DirContextctx)throwsNamingException;
???}
???
???当实现一个自定义的ContextExecutor时，??executeReadOnly() 或者executeReadWrite()，比如我们要调用此方法
???
???Object lookupLink(Namename)
???
???在现有DirContext中，没有相对应的LdapTemplate方法，它是个查询方法，所以是只读的，我们可以这样实现它：
???
???例4.3 使用ContextExecutor的自定义DirContext
???
???packagecom.example.dao;
???publicclassPersonDaoImplimplementsPersonDao{
???...
???publicObjectlookupLink(finalNamename){
???ContextExecutorexecutor=newContextExecutor(){
???publicObjectexecuteWithContext(DirContextctx){
???returnctx.lookupLink(name);
???}
???};
???returnldapTemplate.executeReadOnly(executor);
???}
???}
???
???同样的操作你可以使用 executeReadWrite（） 来执行
