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

第二章 基本操作

在这个例子中，我们将使用AttributesMapper轻松的将person类型的对象属性返回。
例2.1 AttributesMapper 返回一个单一属性
packagecom.example.dao;
publicclassPersonDaoImplimplementsPersonDao{
privateLdapTemplateldapTemplate;
publicvoidsetLdapTemplate(LdapTemplateldapTemplate){
this.ldapTemplate=ldapTemplate;
}
publicListgetAllPersonNames(){
returnldapTemplate.search(
"","(objectclass=person)",
newAttributesMapper(){
publicObjectmapFromAttributes(Attributesattrs)
throwsNamingException{
returnattrs.get("cn").get();
}
});
}
}
AttributesMapper的具体实现是从Attributes中得到想要的属性并返回，在内部，LdapTemplate遍历所有条目，给予AttributesMapper每个项（entry）,并汇集结果放在一个集合中，然后向查询方法返回集合。

例2.2 AttributesMapper 返回一个person对象

packagecom.example.dao;
publicclassPersonDaoImplimplementsPersonDao{
privateLdapTemplateldapTemplate;
...
privateclassPersonAttributesMapperimplementsAttributesMapper{
publicObjectmapFromAttributes(Attributesattrs)throwsNamingException{
Personperson=newPerson();
person.setFullName((String)attrs.get("cn").get());
person.setLastName((String)attrs.get("sn").get());
person.setDescription((String)attrs.get("description").get());
returnperson;
}
}
publicListgetAllPersons(){
returnldapTemplate.search("","(objectclass=person)", newPersonAttributesMapper());
}
}

如果你有一个DN直接标识一个条目，你可以直接找到它，而不需要去检索。这就是所谓的java ldap查找方式。下面示例展示了如何查找结果封装在一个person对象中

例2.3 查找结果封装在一个person对象中

packagecom.example.dao;
publicclassPersonDaoImplimplementsPersonDao{
privateLdapTemplateldapTemplate;
...
publicPersonfindPerson(Stringdn){
return(Person)ldapTemplate.lookup(dn,newPersonAttributesMapper());
}
}

我们将根据指定的dn查找到我们想要的属性放在AttributesMapper中，在这种情况下，封装在person对象中

2.2构建动态过滤器

我们可以构建一个动态过滤器用于搜索中，使用的是org.springframework.ldap.filter包。比方说，我们希望下面的过滤器(&(objectclass=person)(sn=?))，其中的？替换成我们的参数值lastname,下面的代码告诉你我们是如何做到的：

例2.4 构建动态过滤器
packagecom.example.dao;
publicclassPersonDaoImplimplementsPersonDao{
privateLdapTemplateldapTemplate;
...
publicListgetPersonNamesByLastName(StringlastName){
AndFilterfilter=newAndFilter();
filter.and(newEqualsFilter("objectclass","person"));
filter.and(newEqualsFilter("sn",lastName));
returnldapTemplate.search(
"", filter.encode(),
newAttributesMapper(){
publicObjectmapFromAttributes(Attributesattrs)
throwsNamingException{
returnattrs.get("cn").get();
}
});
}
}

要使用通配符查询，可以用WhitespaceWildcardsFilter

例2.5 构建通配符查询过滤器
AndFilterfilter=newAndFilter();
filter.and(newEqualsFilter("objectclass","person"));
filter.and(newWhitespaceWildcardsFilter("cn",cn));

注意：
除了简化过滤器，过滤器本身也应该适当屏蔽一些不安全字符，这样是为了避免ldap注入，有些人可能利用这些字符注入ldap进行一些非法操作。

2.3建立一个动态可识别的名称

标准名称接口只是一个通用名称，它只是一个序列的基本组成部分，该名称接口还提供了关于序列的操作。例如 add和remove.LdapTemplate提供了一个name的接口实现，DistinguishedName，使用它可以轻松的建立一个可识别的名称。 特别是考虑到复杂性和编码问题，这将有助于防止恶意代码注入到你的ldap中进行操作
下面的例子说明了如何利用DistinguishedName来构建一个动态可识别名称

例 2.6 建立一个动态可识别的名称
packagecom.example.dao;
importorg.springframework.ldap.core.support.DistinguishedName;
importjavax.naming.Name;
publicclassPersonDaoImplimplementsPersonDao{
publicstaticfinalStringBASE_DN="dc=example,dc=com";
...
protectedNamebuildDn(Personp){
DistinguishedNamedn=newDistinguishedName(BASE_DN);
dn.add("c",p.getCountry());
dn.add("ou",p.getCompany());
dn.add("cn",p.getFullname());
returndn;
}
}

设想一个人有如下属性：

country Sweden
company SomeCompany
fullname SomePerson

以上的代码将会返回如下的可识别名称
cn=SomePerson,ou=SomeCompany,c=Sweden,dc=example,dc=com

在Java5中有一个名称接口的实现Ldap Name，如果你使用Java5，你可以很好的使用LdapName，当然你也可以继续使用DistinguishedName

2.4绑定与反绑定
在JavaLdap中插入数据称为绑定，为了做到这一点，有一个准确可识别的名称，唯一的标识是插入条目所必须的，下面的代码展示了如何用LdapTemplate绑定一条数据

例2.7 向条目上绑定属性

packagecom.example.dao;
publicclassPersonDaoImplimplementsPersonDao{
privateLdapTemplateldapTemplate;
...
publicvoidcreate(Personp){
Namedn=buildDn(p);
ldapTemplate.bind(dn,null,buildAttributes(p));
}
privateAttributesbuildAttributes(Personp){
Attributesattrs=newBasicAttributes();
BasicAttributeocattr=newBasicAttribute("objectclass");
ocattr.add("top");
ocattr.add("person");
attrs.put(ocattr);
attrs.put("cn","SomePerson");
attrs.put("sn","Person");
returnattrs;
}
}

属性的绑定的代码虽然比较枯燥和冗长，但是我们也有更简便的操作方式，这将是我们在第3章中所介绍的，用DirContextAdapter访问属性和操作

2.4.2 反绑定数据

删除数据在JavaLdap中我们称为反绑定，一个唯一的标识（DN）是识别条目所必须的，正如数据绑定一样。下面的示例演示了如何用LdapTemplate来反绑定数据

例2.8 反绑定数据

packagecom.example.dao;
publicclassPersonDaoImplimplementsPersonDao{
privateLdapTemplateldapTemplate;
...
publicvoiddelete(Personp){
Namedn=buildDn(p);
ldapTemplate.unbind(dn);
}
}

2.5 修改
在JavaLdap中修改数据有两种方法，用rebind和modifyAttrbutes

2.5.1 用rebind修改

用rebind去修改数据非常粗糙，它基本上就是拆散后再绑定，它看起来像这样

例2.9 用rebind修改
packagecom.example.dao;
publicclassPersonDaoImplimplementsPersonDao{
privateLdapTemplateldapTemplate;
...
publicvoidupdate(Personp){
Namedn=buildDn(p);
ldapTemplate.rebind(dn,null,buildAttributes(p));
}
}

2.5.2 用ModifyAttrbutes修改

如果只是修改属性，那么应该用ModifyAttrbutes，它用一个数组作为参数。

例2.10 用ModifyAttrbutes修改

packagecom.example.dao;
publicclassPersonDaoImplimplementsPersonDao{
privateLdapTemplateldapTemplate;
...
publicvoidupdateDescription(Personp){
Namedn=buildDn(p);
Attributeattr=newBasicAttribute("description",p.getDescription())
ModificationItemitem=newModificationItem(DirContext.REPLACE_ATTRIBUTE,attr);
ldapTemplate.modifyAttributes(dn,newModificationItem[]{item});
}
}

构建属性和修改条目是一项工作量很大的工作，但是当你看到第三章 ，使用DirContextAdapter简便访问属性和操作，这一切将变得很简单

2.6 示例应用

最好的做法是查看Sping Ldap的示例包。包说明如下：

1.spring-ldap-person-该示例展示了大部分功能
2.spring-ldap-article-该示例展示了关于SpringLdap如何写入到java.net的article