此版本仍在开发中，尚未被视为稳定版本。对于最新的稳定版本，请使用 Spring LDAP 3.2.8！spring-doc.cn

添加缺少的重载 API 方法

本节介绍如何添加您自己的重载 API 方法以实现新功能。spring-doc.cn

实现自定义搜索方法

LdapTemplate包含 中最常见操作的多个重载版本。但是，我们没有为每个方法签名提供替代方案，主要是因为它们太多了。但是，我们提供了一种方法可以调用您想要的任何方法，并且仍然可以获得它提供的好处。DirContextDirContextLdapTemplatespring-doc.cn

假设你想调用以下方法：DirContextspring-doc.cn

NamingEnumeration search(Name name, String filterExpr, Object[] filterArgs, SearchControls ctls)

中没有相应的重载方法。解决此问题的方法是使用自定义实现，如下所示：LdapTemplateSearchExecutorspring-doc.cn

public interface SearchExecutor {
   public NamingEnumeration executeSearch(DirContext ctx) throws NamingException;
}

在自定义执行程序中，您可以访问对象，该对象可用于调用所需的方法。然后，您可以提供负责映射属性和收集结果的处理程序。例如，您可以使用 的可用实现之一，它将映射的结果收集到内部列表中。为了实际执行搜索，您需要调用 中的方法，该方法将 executor 和 handler 作为参数。最后，您需要返回处理程序收集的任何内容。以下示例显示了如何执行所有这些操作：DirContextCollectingNameClassPairCallbackHandlersearchLdapTemplatespring-doc.cn

示例 1.使用 和 的自定义搜索方法SearchExecutorAttributesMapper
public class PersonRepoImpl implements PersonRepo {
   ...
   public List search(final Name base, final String filter, final String[] params,
         final SearchControls ctls) {
      SearchExecutor executor = new SearchExecutor() {
         public NamingEnumeration executeSearch(DirContext ctx) {
            return ctx.search(base, filter, params, ctls);
         }
      };

      CollectingNameClassPairCallbackHandler handler =
         new AttributesMapperCallbackHandler(new PersonAttributesMapper());

      ldapTemplate.search(executor, handler);
      return handler.getList();
   }
}

如果您更喜欢 the 而不是 ，以下示例显示了它的外观：ContextMapperAttributesMapperspring-doc.cn

示例 2.使用 和 的自定义搜索方法SearchExecutorContextMapper
public class PersonRepoImpl implements PersonRepo {
   ...
   public List search(final Name base, final String filter, final String[] params,
         final SearchControls ctls) {
      SearchExecutor executor = new SearchExecutor() {
         public NamingEnumeration executeSearch(DirContext ctx) {
            return ctx.search(base, filter, params, ctls);
         }
      };

      CollectingNameClassPairCallbackHandler handler =
         new ContextMapperCallbackHandler(new PersonContextMapper());

      ldapTemplate.search(executor, handler);
      return handler.getList();
   }
}
使用 时，必须确保已在实例上调用。ContextMapperCallbackHandlersetReturningObjFlag(true)SearchControls

实现其他自定义上下文方法

与自定义方法相同，您实际上可以使用 ，调用 中的任何方法，如下所示：searchDirContextContextExecutorspring-doc.cn

public interface ContextExecutor {
   public Object executeWithContext(DirContext ctx) throws NamingException;
}

实施自定义时，您可以选择使用 或 方法。假设你想调用以下方法：ContextExecutorexecuteReadOnly()executeReadWrite()spring-doc.cn

Object lookupLink(Name name)

该方法在 中可用，但在 中没有匹配的方法。它是一个查找方法，因此它应该是只读的。我们可以按如下方式实现它：DirContextLdapTemplatespring-doc.cn

例 3.使用DirContextContextExecutor
public class PersonRepoImpl implements PersonRepo {
   ...
   public Object lookupLink(final Name name) {
      ContextExecutor executor = new ContextExecutor() {
         public Object executeWithContext(DirContext ctx) {
            return ctx.lookupLink(name);
         }
      };

      return ldapTemplate.executeReadOnly(executor);
   }
}

以同样的方式，您可以使用 该方法执行读写操作。executeReadWrite()spring-doc.cn