• Spring LDAP的使用


    LDAP入门http://www.jianshu.com/p/7e4d99f6baaf

    • Spring LDAP,是Spring的一个组件,实现对LDAP的操作。

    • 在编程操作MySQL时,我们除了用JDBC,可能都会选用一些框架,比如JbdcTemplate。

    • JdbcTemplate的实现是通过传入sql语句和RowMapper,query返回目标列表,或是传入sql和参数,执行update方法。JdbcTemplate的优点是简化了与数据库连接的代码,以及避免了一些常见的错误。

    • 同样的,Spring LDAP框架也提供了类似的特性——LdapTemplate。

    • 优点都是相通的,Spring LdapTemplate的优点是简化了与LDAP交互的代码。

    • 按之前Spring配置JavaBean的方式,在xml文件配置LdapTemplate及其属性值即可,本文将演示使用Springboot 用Java代码的方式定义LdapTemplate,完成Spring ldap连接数据库服务及进行相关操作。

    下面是使用Spring-ldap的依赖
    <!-- spring ldapTemplate操作 -->
            <dependency>
                <groupId>com.sun</groupId>
                <artifactId>ldapbp</artifactId>
                <version>1.0</version>
            </dependency>
            <dependency>
                <groupId>org.springframework.ldap</groupId>
                <artifactId>spring-ldap-core</artifactId>
                <version>2.3.2.RELEASE</version>
            </dependency>
    
    • 先介绍一些Spring-ldap,因为网上有很多教程,在给出的工程依赖中有用spring-ldap的,也有spring-ldap-core的,而且还有版本问题。笔者使用目前最新的spring-ldap-2.3.2.RELEASE。推荐直接使用,这个最新版本。

    • spring-ldap框架,是Spring集成ldap操作的总和,包含spring-ldap-core,spring-ldap-core-tiger,spring-ldap-ldif-core,spring-ldap-odm等jar,而通常我们在工程中只需要引入spring-ldap-core即可,它提供了绝大部分功能。而且截至目前,spring-ldap的<version>2.3.2.RELEASE</version>不在maven的中央仓库,不好获取。但spring-ldap-core在。

    • 另外,Spring LDAP 2.0对jdk版本要求是1.6,并且开始支持ODM,并后来引入Spring ldap pool连接池。

    • 据本人尝试,这些版本之间,变化差异很大。在新版本中可能有些关键的核心类,都会被移动到不同的package下;一些老版本完成的愚钝功能,可能在新版本中有了更好的实现或支持,所以在新版本中,一些“愚钝”实现可能会被移除。

    • 比如LdapTemplate,原先在org.springframework.ldap包,在最新版本被移至core包。在spring-ldap-core的<version>2.0.2.RELEASE</version>版本中支持类似于JPA方式的LdapRepository,但在2.3.2最新版本中,完全被移除,但是新版本增强的LdapTemplate,使得LdapTemplate功能更强大,可以完全替代LdapRepository。

    下面是用Java代码的方式定义LdapTemplate,完成用Spring ldap连接LDAP服务器
    import com.cvte.csb.sim.ldap.constants.LdapConstans;
    import org.springframework.beans.factory.annotation.Value;
    import org.springframework.boot.context.properties.ConfigurationProperties;
    import org.springframework.context.annotation.Bean;
    import org.springframework.context.annotation.Configuration;
    import org.springframework.context.annotation.PropertySource;
    import org.springframework.ldap.core.ContextSource;
    import org.springframework.ldap.core.LdapTemplate;
    import org.springframework.ldap.core.support.LdapContextSource;
    import org.springframework.ldap.pool.factory.PoolingContextSource;
    import org.springframework.ldap.pool.validation.DefaultDirContextValidator;
    import org.springframework.ldap.transaction.compensating.manager.TransactionAwareContextSourceProxy;
    import java.util.HashMap;
    import java.util.Map;
    
    /**
     * LDAP 的自动配置类
     *
     * 完成连接 及LdapTemplate生成
     */
    @Configuration
    public class LdapConfiguration {
    
        private LdapTemplate ldapTemplate;
    
        @Bean
        public LdapContextSource contextSource() {
            LdapContextSource contextSource = new LdapContextSource();
            Map<String, Object> config = new HashMap();
    
            contextSource.setUrl(LdapConstans.LDAP_URL);
            contextSource.setBase(LdapConstans.BASE_DC);
            contextSource.setUserDn(LdapConstans.USER_NAME);
            contextSource.setPassword(LdapConstans.PASS_WORD);
    
            //  解决 乱码 的关键一句
            config.put("java.naming.ldap.attributes.binary", "objectGUID");
    
            contextSource.setPooled(true);
            contextSource.setBaseEnvironmentProperties(config);
            return contextSource;
        }
     
        @Bean
        public LdapTemplate ldapTemplate() {
            if (null == ldapTemplate)
                ldapTemplate = new LdapTemplate(contextSource());
            return ldapTemplate;
        }
    
    }
    
    • 完成LdapTemplate的bean定义,是最关键的一步。因为后续的操作,对于LDAP目录树的CRUD操作,全都靠它完成。
    • 通过上面的代码,在IOC容器完成bean的定义,我们在外部就可以注入使用LdapTemplate了。
    下面给出用LdapTemplate完成CRUD功能:
    import com.cvte.csb.sim.ldap.attribute.LdapDeptAttributeMapper;
    import com.cvte.csb.sim.ldap.attribute.LdapUserAttributeMapper;
    import com.cvte.csb.sim.ldap.module.dto.LdapUser;
    import org.junit.Assert;
    import org.junit.Test;
    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.ldap.core.DirContextAdapter;
    import org.springframework.ldap.core.DistinguishedName;
    import org.springframework.ldap.core.LdapTemplate;
    import org.springframework.ldap.filter.AndFilter;
    import org.springframework.ldap.filter.EqualsFilter;
    import java.util.List;
    
    public class ConfigTest extends BaseTest {
        @Autowired
        private LdapTemplate ldapTemplate;
    
        /**
         * 获取所有 内部人员
         * ou=Internal,ou=People
         */
        @Test
        public void listUsers(){
            AndFilter filter = new AndFilter();
            filter.and(new EqualsFilter("objectClass", "person"));
    
            //查询所有内部人员
            List<LdapUser> users = ldapTemplate.search("ou=Internal,ou=People", filter.encode(), new LdapUserAttributeMapper());
            for (LdapUser user: users ) {
                System.out.println(user);
            }
    
    //        Assert.assertEquals(3056, users.size());
        }
    
        /**
         * 根据uid 查找单个人员
         */
        @Test
        public void findUser(){
    
            //uid=00012047,ou=Internal,ou=People,o=cvte.com,o=isp
            DirContextAdapter obj = (DirContextAdapter) ldapTemplate.lookup("uid=00012047,ou=Internal,ou=People");//BASE_DC 不用填
            System.out.println(obj);
        }
    
        /**
         * 根据部门编号o,查找部门
         */
        @Test
        public void findDept(){
            //o=598b09cb12ab4364864d8ac73ecee00d,ou=Organizations,ou=People,o=cvte.com,o=isp
            DirContextAdapter obj = (DirContextAdapter) ldapTemplate.lookup("o=598b09cb12ab4364864d8ac73ecee00d,ou=Organizations");//BASE_DC 不用填
            System.out.println(obj);
        }
    
        @Test
        public void listDepts(){
            AndFilter filter = new AndFilter();
            filter.and(new EqualsFilter("objectClass", "organization"));
            //search是根据过滤条件进行查询,第一个参数是父节点的dn,可以为空,不为空时查询效率更高
            List depts = ldapTemplate.search("", filter.encode(), new LdapDeptAttributeMapper());
            System.out.println(depts.size());
    //        Assert.assertEquals(3056, depts.size());
        }
    }
    
    • 在ldap中,有两个"查询"概念,search和lookup。search是ldaptemplate对每一个entry进行查询,lookup是通过DN直接找到某个条目。
    • 在Ldap中,新增与删除叫做绑定bind和解绑unBind。这些方法LdapTemplate全部提供,并且还提供各种条件过滤等方法,不如findAll(),list()等。

    我们注意到,findAll(),list()肯定是返回一个java.util.List<T>,包括,

    //查询所有内部人员
    List<LdapUser> users = ldapTemplate.search("ou=Internal,ou=People", filter.encode(), new LdapUserAttributeMapper());
    

    也是返回列表,列表里装的是查询出来的结果。但是上一篇文章用JNDI方式查询出来的是
    Attributes attrs = ctx.getAttributes("uid=00012047,ou=Internal,ou=People");//获取到一个人员
    Spring-ldap是基于JNDI实现的封装,那是哪里实现的把Attributes转成我们需要的Java Bean对象呢?
    答案在new LdapUserAttributeMapper(),这个接口实现了查询结果到对象的转化。

    import com.cvte.csb.sim.ldap.module.dto.LdapUser;
    import org.springframework.ldap.core.AttributesMapper;
    import javax.naming.NamingException;
    import javax.naming.directory.Attributes;
    
    /**
     * 将ldap返回的结果,转成指定对象
     */
    public class LdapUserAttributeMapper implements AttributesMapper {
    
        /**
         * 将单个Attributes转成单个对象
         * @param attrs
         * @return
         * @throws NamingException
         */
        public Object mapFromAttributes(Attributes attrs) throws NamingException {
            LdapUser user  = new LdapUser();
    
            if(attrs.get("uid") != null){
                user.setUsername( attrs.get("uid").get().toString());
            }
            if(attrs.get("cn") != null){
                user.setUserCn( attrs.get("cn").get().toString());
            }
            if(attrs.get("mobile") != null){
                user.setMobile( attrs.get("mobile").get().toString());
            }
            if(attrs.get("mail") != null){
                user.setMail( attrs.get("mail").get().toString());
            }
            if(attrs.get("employeeNumber") != null){
                user.setUserNumber( attrs.get("employeeNumber").get().toString());
            }
    
            if(attrs.get("type") != null){
                user.setUserType( attrs.get("type").get().toString());
            }
            if(attrs.get("py") != null){
                user.setPinyin(attrs.get("py").get().toString());
            }
            if(attrs.get("alias") != null){
                user.setAlias(attrs.get("alias").get().toString());
            }
            if(attrs.get("departmentNumber") != null){
                user.setDeptId(attrs.get("departmentNumber").get().toString());
            }
            if(attrs.get("departmentName") != null){
                user.setDeptName(attrs.get("departmentName").get().toString());
            }
            if(attrs.get("jobname") != null){
                user.setPositionName(attrs.get("jobname").get().toString());
            }
            if(attrs.get("modifyTimestamp") != null){
                user.setModifyTimestamp(attrs.get("modifyTimestamp").get().toString());
            }
            return user;
        }
    }
    

    可以看到转化的过程非常繁琐,无非就是拿JNDI查询到的Attributes,不停的获取属性值,再设置到Java对象中;attrs.get("uid").get().toString()然后set。

    那好了,在每次查询的时候,要查询到多少列,在这个AttributesMapper转化方法中就要写多少个,判断及赋值。而且,如果因为业务不同,要查询不同的列,那AttributesMapper接口的实现必须重新写。那有没有支持复用的方式呢?答案是肯定的。下节分享spring ldap ODM , Object-Directory Mapping。

    spring-ldap-2.3.2.RELEASE所有jar包下载
    http://download.csdn.net/download/ljheee/10150501

    Spring-ldap最新版官方文档:
    https://docs.spring.io/spring-ldap/docs/2.3.2.RELEASE/reference/

  • 相关阅读:
    南阳oj 814 又见拦截导弹
    南阳 zb的生日和邮票分你一般(01背包思路)
    导弹拦截(最长下降子序列)变形
    控件绝对定位函数
    小玩意
    java获取本机所有可用字体
    按键监听类KeyListener及适配器改良方案
    编译php-memcached扩展
    Memcached安装,启动,连接
    Apache配置虚拟主机
  • 原文地址:https://www.cnblogs.com/twodog/p/12137997.html
Copyright © 2020-2023  润新知