Ldap api介绍

最新推荐文章于 2023-04-14 10:55:40 发布
最新推荐文章于 2023-04-14 10:55:40 发布
阅读量736 收藏 1
点赞数
分类专栏： 协议 文章标签： api attributes string null credentials filter

从JDK5.0开始，对LDAP协议的数据访问操作就被集成在javax的扩展API包中，并随同JDK一并发布，这一章节，我们主要介绍API包中的类信息。
javax.naming.directory 包的结构


常用API解析

javax.naming.directory.InitialDirContext，初始化目录服务上下文类
该类是LDAP数据内容的操作工具类，通过该类可以执行绑定LDAP服务器、新增LDAP条目、获取条目实例、修改条目属性、删除条目和根据条件搜索条目等操作。常用方法说明如下：

初始化LDAP 目录服务上下文(相当于使用JDBC打开一个数据库链接)

  • InitialDirContext(Hashtable<?,?> environment)


绑定/创建LDAP条目对象（相当于新增一个LDAP条目数据 bind(Name

  • name, Object obj, Attributes attrs)
  • bind(String name, Object obj, Attributes attrs)
  • createSubcontext(Name name, Attributes attrs)
  • createSubcontext(String name, Attributes attrs)


获取条目实例（属性集）

  • getAttributes(Name name)
  • getAttributes(Name name, String[] attrIds)
  • getAttributes(String name)
  • getAttributes(String name, String[] attrIds)


修改条目属性

  • modifyAttributes(Name name, int mod_op, Attributes attrs)
  • modifyAttributes(Name name, ModificationItem[] mods)
  • modifyAttributes(String name, int mod_op, Attributes attrs)
  • modifyAttributes(String name, ModificationItem[] mods)


删除条目

  • destroySubcontext(Name name)
  • destroySubcontext(String name)


根据属性集搜索条目

  • search(Name name, Attributes matchingAttributes)
  • search(Name name, Attributes matchingAttributes, String[] attributesToReturn)
  • search(String name, Attributes matchingAttributes)
  • search(String name, Attributes matchingAttributes, String[] attributesToReturn)


根据过滤器搜索条目

  • search(Name name, String filterExpr, Object[] filterArgs, SearchControls cons)
  • search(Name name, String filter, SearchControls cons)
  • search(String name, String filterExpr, Object[] filterArgs, SearchControls cons)
  • search(String name, String filter, SearchControls cons)



javax.naming.directory.BasicAttribute，LDAP基本属性对象
该类用来表示LDAP条目中的单个属性对象。在目录服务中，每个属性名称是可以对应多个的属性值的。

构建属性对象

  • BasicAttribute(String id)
  • BasicAttribute(String id, boolean ordered)
  • BasicAttribute(String id, Object value)
  • BasicAttribute(String id, Object value, boolean ordered)


添加属性值

  • add(int ix, Object attrVal)，添加属性值到多值属性的指定位置
  • add(Object attrVal) ， 追加属性值到多值属性尾部


判断属性值是否包含

  • contains(Object attrVal) ， 多值属性中有一个值是匹配的，返回true


获取属性值

  • get()，取得属性值中的一个
  • get(int ix)，从多值属性中的指定位置取值


获取属性ID

  • getID()，属性的ID就是属性名


删除属性值

  • remove(int ix)，删除指定位置的属性值
  • remove(Object attrval)，删除指定的属性值



javax.naming.directory.BasicAttributes，LDAP实体的属性集
该类表示一个LDAP条目绑定的属性集合，在绝大多数情况下，一个LDAP条目存在多个属性。

构造属性集

  • BasicAttributes()
  • BasicAttributes(boolean ignoreCase)，属性ID是否大小写敏感，建议不要使用敏感
  • BasicAttributes(String attrID, Object val)
  • BasicAttributes(String attrID, Object val, boolean ignoreCase)


获取属性集中的单个属性对象

  • get(String attrID)


获取全部属性的枚举

  • getAll()


获取全部属性的ID枚举

  • getIDs()


添加新属性

  • put(Attribute attr)
  • put(String attrID, Object val)


移除指定属性

  • remove(String attrID)



javax.naming.directory.SearchControls , LDAP目录服务搜索控制对象
该类负责控制LDAP搜索行为的范围、设定返回结果数上限，搜索耗时上限，指定结果所包括的属性集等。

设定搜索行为的范围

  • setSearchScope(int scope)


设定返回结果数上限

  • setCountLimit(long limit)


设定搜索耗时上限

  • setTimeLimit(int ms) ， 以毫秒为单位


指定结果所包括的属性集

  • setReturningAttributes(String[] attrs)



javax.naming.directory.SearchResult ， 表示.search() 方法的返回结果集中的一项。
SearchResult类是对LDAP条目属性集的封装。在search()操作中可能返回完整的条目属性，也可能是条目属性的一部分。

获取SearchResult封装的条目属性

  • getAttributes()



以上只列举了LDAP操作API的常用部分，更多更详细的描述，请参考 Sun Java6.0 API DOC。

LDAP操作代码样例
在这个章节中，我们将结合LDAP操作的代码实例了解API使用。

初始化LDAP 目录服务上下文
该例子中，我们使用uid=linly,ou=People,dc=jsoso,dc=net这个账号，链接位于本机8389端口的LDAP服务器（ldap://localhost:8389），认证方式采用simple类型，即用户名/密码方式。

Java代码
  1. private   static   void  initialContext()  throws  NamingException{  
  2.     if (singleton ==  null ){  
  3.         singleton = new  LDAPConnection();  
  4.         /*  
  5.          * 在实际编码中，这些环境变量应尽可能通过配置文件读取  
  6.          */   
  7.         //LDAP服务地址   
  8.         singleton.sLDAP_URL = "ldap://localhost:8389" ;   
  9.         //管理员账号   
  10.         singleton.sMANAGER_DN = "uid=linly,ou=People,dc=jsoso,dc=net" ;  
  11.         //管理员密码   
  12.         singleton.sMANAGER_PASSWORD = "coffee" ;  
  13.         //认证类型   
  14.         singleton.sAUTH_TYPE = "simple" ;  
  15.         //JNDI Context工厂类   
  16.         singleton.sCONTEXT_FACTORY = "com.sun.jndi.ldap.LdapCtxFactory" ;   
  17.           
  18.         singleton.envProps.setProperty(Context.INITIAL_CONTEXT_FACTORY, singleton.sCONTEXT_FACTORY);  
  19.         singleton.envProps.setProperty(Context.PROVIDER_URL, singleton.sLDAP_URL);  
  20.         singleton.envProps.setProperty(Context.SECURITY_AUTHENTICATION, singleton.sAUTH_TYPE);  
  21.         singleton.envProps.setProperty(Context.SECURITY_PRINCIPAL, singleton.sMANAGER_DN);  
  22.         singleton.envProps.setProperty(Context.SECURITY_CREDENTIALS, singleton.sMANAGER_PASSWORD);  
  23.         /*  
  24.          * 绑定ldap服务器  
  25.          */   
  26.         singleton.dirCtx = new  InitialDirContext(singleton.envProps);  
  27.     }  
  28. }  
[java] view plain copy print ?
  1. private static void initialContext() throws NamingException{  
  2.     if(singleton == null){  
  3.         singleton = new LDAPConnection();  
  4.         /* 
  5.          * 在实际编码中，这些环境变量应尽可能通过配置文件读取 
  6.          */  
  7.         //LDAP服务地址   
  8.         singleton.sLDAP_URL = "ldap://localhost:8389";   
  9.         //管理员账号   
  10.         singleton.sMANAGER_DN = "uid=linly,ou=People,dc=jsoso,dc=net";  
  11.         //管理员密码   
  12.         singleton.sMANAGER_PASSWORD = "coffee";  
  13.         //认证类型   
  14.         singleton.sAUTH_TYPE = "simple";  
  15.         //JNDI Context工厂类   
  16.         singleton.sCONTEXT_FACTORY = "com.sun.jndi.ldap.LdapCtxFactory";   
  17.           
  18.         singleton.envProps.setProperty(Context.INITIAL_CONTEXT_FACTORY, singleton.sCONTEXT_FACTORY);  
  19.         singleton.envProps.setProperty(Context.PROVIDER_URL, singleton.sLDAP_URL);  
  20.         singleton.envProps.setProperty(Context.SECURITY_AUTHENTICATION, singleton.sAUTH_TYPE);  
  21.         singleton.envProps.setProperty(Context.SECURITY_PRINCIPAL, singleton.sMANAGER_DN);  
  22.         singleton.envProps.setProperty(Context.SECURITY_CREDENTIALS, singleton.sMANAGER_PASSWORD);  
  23.         /* 
  24.          * 绑定ldap服务器 
  25.          */  
  26.         singleton.dirCtx = new InitialDirContext(singleton.envProps);  
  27.     }  
  28. }  
	private static void initialContext() throws NamingException{
		if(singleton == null){
			singleton = new LDAPConnection();
			/*
			 * 在实际编码中，这些环境变量应尽可能通过配置文件读取
			 */
			//LDAP服务地址
			singleton.sLDAP_URL = "ldap://localhost:8389"; 
			//管理员账号
			singleton.sMANAGER_DN = "uid=linly,ou=People,dc=jsoso,dc=net";
			//管理员密码
			singleton.sMANAGER_PASSWORD = "coffee";
			//认证类型
			singleton.sAUTH_TYPE = "simple";
			//JNDI Context工厂类
			singleton.sCONTEXT_FACTORY = "com.sun.jndi.ldap.LdapCtxFactory"; 
			
			singleton.envProps.setProperty(Context.INITIAL_CONTEXT_FACTORY, singleton.sCONTEXT_FACTORY);
			singleton.envProps.setProperty(Context.PROVIDER_URL, singleton.sLDAP_URL);
			singleton.envProps.setProperty(Context.SECURITY_AUTHENTICATION, singleton.sAUTH_TYPE);
			singleton.envProps.setProperty(Context.SECURITY_PRINCIPAL, singleton.sMANAGER_DN);
			singleton.envProps.setProperty(Context.SECURITY_CREDENTIALS, singleton.sMANAGER_PASSWORD);
			/*
			 * 绑定ldap服务器
			 */
			singleton.dirCtx = new InitialDirContext(singleton.envProps);
		}
	}


通过一个Hashtable或者Properties对象为LDAP的Context设置参数，而后初始化InitialDirContext，即可绑定LDAP服务。这相当于JDBC中获取数据库的Connection对象。

绑定/创建LDAP条目对象
用户可以使用bind方法创建新的LDAP条目，下面的代码创建一个DN："ou=Employee , dc=jsoso ,dc=net"的OrganizationUnit类LDAP条目如下:

Java代码
  1. public   boolean  createOrganizationUnit(){  
  2.     String ldapGroupDN = "ou=Employee , dc=jsoso ,dc=net" ;  
  3.     try  {  
  4.         /*  
  5.          * 查找是否已经存在指定的OU条目  
  6.          * 如果存在，则打印OU条目的属性信息  
  7.          * 如果不存在，则程序会抛出NamingException异常，进入异常处理  
  8.          */   
  9.         Attributes attrs = dirContext.getAttributes(ldapGroupDN);  
  10.         System.out.println("Find the group , attributes list :" );  
  11.         NamingEnumeration<String>  nEnum = attrs.getIDs();              
  12.         for ( ; nEnum.hasMore() ; ){  
  13.             String attrID = nEnum.next();  
  14.             Attribute attr = (Attribute)attrs.get(attrID);  
  15.             System.out.println(attr.toString());  
  16.         }             
  17.         return   false ;  
  18.     } catch  (NamingException e) {  
  19.         /*  
  20.          * 没有找到对应的Group条目，新增Group条目  
  21.          */   
  22.         //创建objectclass属性   
  23.         Attribute objclass = new  BasicAttribute( "objectclass" );  
  24.         objclass.add("top" );  
  25.         objclass.add("organizationalunit" );   
  26.         //创建cn属性   
  27.         Attribute cn = new  BasicAttribute( "ou" ,  "Employee" );   
  28.         //创建Attributes，并添加objectclass和cn属性   
  29.         Attributes attrs = new  BasicAttributes();   
  30.         attrs.put(objclass);   
  31.         attrs.put(cn);   
  32.         //将属性绑定到新的条目上，创建该条目   
  33.         try  {  
  34.             dirContext.bind(ldapGroupDN, null , attrs);  
  35.             System.out.println("Group created successful" );  
  36.             return   true ;  
  37.         } catch  (NamingException e1) {  
  38.             e1.printStackTrace();  
  39.         }             
  40.     }  
  41.     return   false ;  
  42. }  
[java] view plain copy print ?
  1. public boolean createOrganizationUnit(){  
  2.     String ldapGroupDN = "ou=Employee , dc=jsoso ,dc=net";  
  3.     try {  
  4.         /* 
  5.          * 查找是否已经存在指定的OU条目 
  6.          * 如果存在，则打印OU条目的属性信息 
  7.          * 如果不存在，则程序会抛出NamingException异常，进入异常处理 
  8.          */  
  9.         Attributes attrs = dirContext.getAttributes(ldapGroupDN);  
  10.         System.out.println("Find the group , attributes list :");  
  11.         NamingEnumeration<String>  nEnum = attrs.getIDs();              
  12.         for( ; nEnum.hasMore() ; ){  
  13.             String attrID = nEnum.next();  
  14.             Attribute attr = (Attribute)attrs.get(attrID);  
  15.             System.out.println(attr.toString());  
  16.         }             
  17.         return false;  
  18.     } catch (NamingException e) {  
  19.         /* 
  20.          * 没有找到对应的Group条目，新增Group条目 
  21.          */  
  22.         //创建objectclass属性   
  23.         Attribute objclass = new BasicAttribute("objectclass");  
  24.         objclass.add("top");  
  25.         objclass.add("organizationalunit");   
  26.         //创建cn属性   
  27.         Attribute cn = new BasicAttribute("ou", "Employee");   
  28.         //创建Attributes，并添加objectclass和cn属性   
  29.         Attributes attrs = new BasicAttributes();   
  30.         attrs.put(objclass);   
  31.         attrs.put(cn);   
  32.         //将属性绑定到新的条目上，创建该条目   
  33.         try {  
  34.             dirContext.bind(ldapGroupDN, null, attrs);  
  35.             System.out.println("Group created successful");  
  36.             return true;  
  37.         } catch (NamingException e1) {  
  38.             e1.printStackTrace();  
  39.         }             
  40.     }  
  41.     return false;  
  42. }  
	public boolean createOrganizationUnit(){
		String ldapGroupDN = "ou=Employee , dc=jsoso ,dc=net";
		try {
			/*
			 * 查找是否已经存在指定的OU条目
			 * 如果存在，则打印OU条目的属性信息
			 * 如果不存在，则程序会抛出NamingException异常，进入异常处理
			 */
			Attributes attrs = dirContext.getAttributes(ldapGroupDN);
			System.out.println("Find the group , attributes list :");
			NamingEnumeration<String>  nEnum = attrs.getIDs();			
			for( ; nEnum.hasMore() ; ){
				String attrID = nEnum.next();
				Attribute attr = (Attribute)attrs.get(attrID);
				System.out.println(attr.toString());
			}			
			return false;
		} catch (NamingException e) {
			/*
			 * 没有找到对应的Group条目，新增Group条目
			 */
			//创建objectclass属性
			Attribute objclass = new BasicAttribute("objectclass");
			objclass.add("top");
			objclass.add("organizationalunit"); 
			//创建cn属性
			Attribute cn = new BasicAttribute("ou", "Employee"); 
			//创建Attributes，并添加objectclass和cn属性
			Attributes attrs = new BasicAttributes(); 
			attrs.put(objclass); 
			attrs.put(cn); 
			//将属性绑定到新的条目上，创建该条目
			try {
				dirContext.bind(ldapGroupDN, null, attrs);
				System.out.println("Group created successful");
				return true;
			} catch (NamingException e1) {
				e1.printStackTrace();
			} 			
		}
		return false;
	}


或者使用createSubcontext方法创建亦可，以下例子我们新增一个inetorgperson类的LDAP条目：

Java代码
  1. /**  
  2.  * 创建LDAP用户条目  
  3.  * @param user   
  4.  * @return  
  5.  */   
  6. public   boolean  createUser(LDAPUser user){  
  7.     if (user ==  null ){  
  8.         return   false ;  
  9.     }  
  10.       
  11.     if (user.getUserID() ==  null  || user.getUserID().length() ==  0    
  12.             || user.getFirstName() == null  || user.getFirstName().length() ==  0   
  13.             || user.getLastName() == null  || user.getLastName().length() ==  0   
  14.             || user.getCommomName() == null  || user.getCommomName().length() ==  0 ){  
  15.         return   false ;  
  16.     }  
  17.   
  18.     //判断用户条目是否已经存在   
  19.     if (isUserexist(user.getDistinguishedName())){  
  20.         return   true ;  
  21.     }  
  22.   
  23.     /*  
  24.      * 新建条目属性集  
  25.      */   
  26.     Attributes attrs = new  BasicAttributes();   
  27.     setBasicAttribute(attrs , "objectclass"  ,  "top,person,organizationalPerson,inetorgperson" );  
  28.     setBasicAttribute(attrs , "cn"  , user.getCommomName());  
  29.     setBasicAttribute(attrs , "givenname"  , user.getFirstName());  
  30.     setBasicAttribute(attrs , "sn"  , user.getLastName());  
  31.     setBasicAttribute(attrs , "uid"  , user.getUserID());  
  32.     setBasicAttribute(attrs , "userpassword"  , user.getPassword());  
  33.   
  34.     //添加用户条目节点    
  35.     try  {  
  36.         dirContext.createSubcontext(user.getDistinguishedName(), attrs);  
  37.         System.out.println("Add User("  + user.getDistinguishedName() +  ") ok." );   
  38.         return   true ;  
  39.     } catch  (NamingException e) {  
  40.         e.printStackTrace();  
  41.     }   
  42.     return   false ;  
  43. }  
[java] view plain copy print ?
  1. /** 
  2.  * 创建LDAP用户条目 
  3.  * @param user  
  4.  * @return 
  5.  */  
  6. public boolean createUser(LDAPUser user){  
  7.     if(user == null){  
  8.         return false;  
  9.     }  
  10.       
  11.     if(user.getUserID() == null || user.getUserID().length() == 0   
  12.             || user.getFirstName() == null || user.getFirstName().length() == 0  
  13.             || user.getLastName() == null || user.getLastName().length() == 0  
  14.             || user.getCommomName() == null || user.getCommomName().length() == 0){  
  15.         return false;  
  16.     }  
  17.   
  18.     //判断用户条目是否已经存在   
  19.     if(isUserexist(user.getDistinguishedName())){  
  20.         return true;  
  21.     }  
  22.   
  23.     /* 
  24.      * 新建条目属性集 
  25.      */  
  26.     Attributes attrs = new BasicAttributes();   
  27.     setBasicAttribute(attrs , "objectclass" , "top,person,organizationalPerson,inetorgperson");  
  28.     setBasicAttribute(attrs , "cn" , user.getCommomName());  
  29.     setBasicAttribute(attrs , "givenname" , user.getFirstName());  
  30.     setBasicAttribute(attrs , "sn" , user.getLastName());  
  31.     setBasicAttribute(attrs , "uid" , user.getUserID());  
  32.     setBasicAttribute(attrs , "userpassword" , user.getPassword());  
  33.   
  34.     //添加用户条目节点    
  35.     try {  
  36.         dirContext.createSubcontext(user.getDistinguishedName(), attrs);  
  37.         System.out.println("Add User(" + user.getDistinguishedName() + ") ok.");   
  38.         return true;  
  39.     } catch (NamingException e) {  
  40.         e.printStackTrace();  
  41.     }   
  42.     return false;  
  43. }  
	/**
	 * 创建LDAP用户条目
	 * @param user 
	 * @return
	 */
	public boolean createUser(LDAPUser user){
		if(user == null){
			return false;
		}
		
		if(user.getUserID() == null || user.getUserID().length() == 0 
				|| user.getFirstName() == null || user.getFirstName().length() == 0
				|| user.getLastName() == null || user.getLastName().length() == 0
				|| user.getCommomName() == null || user.getCommomName().length() == 0){
			return false;
		}

		//判断用户条目是否已经存在
		if(isUserexist(user.getDistinguishedName())){
			return true;
		}

		/*
		 * 新建条目属性集
		 */
		Attributes attrs = new BasicAttributes(); 
		setBasicAttribute(attrs , "objectclass" , "top,person,organizationalPerson,inetorgperson");
		setBasicAttribute(attrs , "cn" , user.getCommomName());
		setBasicAttribute(attrs , "givenname" , user.getFirstName());
		setBasicAttribute(attrs , "sn" , user.getLastName());
		setBasicAttribute(attrs , "uid" , user.getUserID());
		setBasicAttribute(attrs , "userpassword" , user.getPassword());

		//添加用户条目节点 
		try {
			dirContext.createSubcontext(user.getDistinguishedName(), attrs);
			System.out.println("Add User(" + user.getDistinguishedName() + ") ok."); 
			return true;
		} catch (NamingException e) {
			e.printStackTrace();
		} 
		return false;
	}



获取条目属性
下面一段代码获取entryDN参数指定条目中的属性集合，并打印到控制台

Java代码
  1. /**  
  2.  * 获取一个指定的LDAP Entry  
  3.  * @param entryDN  
  4.  */   
  5. public   void  find(String entryDN){  
  6.     try  {   
  7.         Attributes attrs = dirContext.getAttributes(entryDN);   
  8.         if  (attrs !=  null ) {  
  9.             NamingEnumeration<String>  nEnum = attrs.getIDs();  
  10.             for ( ; nEnum.hasMore() ; ){  
  11.                 String attrID = nEnum.next();  
  12.                 Attribute attr = (Attribute)attrs.get(attrID);  
  13.                 System.out.println(attr.toString());  
  14.             }  
  15.             System.out.println();  
  16.         }else {   
  17.             System.out.println("No found binding." );  
  18.         }   
  19.     }catch (NamingException ne) {   
  20.         ne.printStackTrace();  
  21.     }   
  22. }  
[java] view plain copy print ?
  1. /** 
  2.  * 获取一个指定的LDAP Entry 
  3.  * @param entryDN 
  4.  */  
  5. public void find(String entryDN){  
  6.     try {   
  7.         Attributes attrs = dirContext.getAttributes(entryDN);   
  8.         if (attrs != null) {  
  9.             NamingEnumeration<String>  nEnum = attrs.getIDs();  
  10.             for( ; nEnum.hasMore() ; ){  
  11.                 String attrID = nEnum.next();  
  12.                 Attribute attr = (Attribute)attrs.get(attrID);  
  13.                 System.out.println(attr.toString());  
  14.             }  
  15.             System.out.println();  
  16.         }else{   
  17.             System.out.println("No found binding.");  
  18.         }   
  19.     }catch(NamingException ne) {   
  20.         ne.printStackTrace();  
  21.     }   
  22. }  
	/**
	 * 获取一个指定的LDAP Entry
	 * @param entryDN
	 */
	public void find(String entryDN){
		try { 
			Attributes attrs = dirContext.getAttributes(entryDN); 
			if (attrs != null) {
				NamingEnumeration<String>  nEnum = attrs.getIDs();
				for( ; nEnum.hasMore() ; ){
					String attrID = nEnum.next();
					Attribute attr = (Attribute)attrs.get(attrID);
					System.out.println(attr.toString());
				}
				System.out.println();
			}else{ 
				System.out.println("No found binding.");
			} 
		}catch(NamingException ne) { 
			ne.printStackTrace();
		} 
	}



修改条目属性
修改DN=user.getDistinguishedName()的条目中的cn、givenname、sn和userpassword四个属性值。
（注：参数DirContext.REPLACE_ATTRIBUTE有另外两个常量：DirContext.ADD_ATTRIBUTE；DirContext.REMOVE_ATTRIBUTE，分别表示新增属性和删除属性。）

Java代码
  1. /**  
  2.  * 修改用户信息  
  3.  * @param user  
  4.  * @return  
  5.  * @throws Exception  
  6.  */    
  7. public   boolean  modifyUser(LDAPUser user)  throws  Exception {   
  8.     //用户对象为空    
  9.     if  (user ==  null ) {   
  10.         throw   new  Exception( "No user information!n" );   
  11.     }  
  12.   
  13.     //检查uid    
  14.     String userDN = user.getDistinguishedName();   
  15.     if  (userDN ==  null  && userDN.length() ==  0 ) {   
  16.         throw   new  NamingException( "No userDN you specify!n" );   
  17.     }   
  18.   
  19.     //判断用户条目是否已经存在   
  20.     if (!isUserexist(userDN)){  
  21.         return   false ;  
  22.     }  
  23.       
  24.     //设置属性    
  25.     Attributes attrs = new  BasicAttributes();   
  26.     setBasicAttribute(attrs, "cn" , user.getCommomName());   
  27.     setBasicAttribute(attrs, "givenname" , user.getFirstName());   
  28.     setBasicAttribute(attrs, "sn" , user.getLastName());   
  29.     setBasicAttribute(attrs, "userpassword" , user.getPassword());     
  30.     //修改属性    
  31.     try {  
  32.         dirContext.modifyAttributes(user.getDistinguishedName(),DirContext.REPLACE_ATTRIBUTE, attrs);   
  33.         System.out.println("User("  + user.getDistinguishedName() +  ") information modified.n" );  
  34.         return   true ;  
  35.     }catch (NamingException ne){  
  36.         ne.printStackTrace();  
  37.     }  
  38.     return   false ;  
  39. }  
[java] view plain copy print ?
  1. /** 
  2.  * 修改用户信息 
  3.  * @param user 
  4.  * @return 
  5.  * @throws Exception 
  6.  */   
  7. public boolean modifyUser(LDAPUser user) throws Exception {   
  8.     //用户对象为空    
  9.     if (user == null) {   
  10.         throw new Exception("No user information!n");   
  11.     }  
  12.   
  13.     //检查uid    
  14.     String userDN = user.getDistinguishedName();   
  15.     if (userDN == null && userDN.length() == 0) {   
  16.         throw new NamingException("No userDN you specify!n");   
  17.     }   
  18.   
  19.     //判断用户条目是否已经存在   
  20.     if(!isUserexist(userDN)){  
  21.         return false;  
  22.     }  
  23.       
  24.     //设置属性    
  25.     Attributes attrs = new BasicAttributes();   
  26.     setBasicAttribute(attrs, "cn", user.getCommomName());   
  27.     setBasicAttribute(attrs, "givenname", user.getFirstName());   
  28.     setBasicAttribute(attrs, "sn", user.getLastName());   
  29.     setBasicAttribute(attrs, "userpassword", user.getPassword());     
  30.     //修改属性    
  31.     try{  
  32.         dirContext.modifyAttributes(user.getDistinguishedName(),DirContext.REPLACE_ATTRIBUTE, attrs);   
  33.         System.out.println("User(" + user.getDistinguishedName() + ") information modified.n");  
  34.         return true;  
  35.     }catch(NamingException ne){  
  36.         ne.printStackTrace();  
  37.     }  
  38.     return false;  
  39. }  
	/**
	 * 修改用户信息
	 * @param user
	 * @return
	 * @throws Exception
	 */	
	public boolean modifyUser(LDAPUser user) throws Exception { 
		//用户对象为空 
		if (user == null) { 
			throw new Exception("No user information!n"); 
		}
	
		//检查uid 
		String userDN = user.getDistinguishedName(); 
		if (userDN == null && userDN.length() == 0) { 
			throw new NamingException("No userDN you specify!n"); 
		} 

		//判断用户条目是否已经存在
		if(!isUserexist(userDN)){
			return false;
		}
		
		//设置属性 
		Attributes attrs = new BasicAttributes(); 
		setBasicAttribute(attrs, "cn", user.getCommomName()); 
		setBasicAttribute(attrs, "givenname", user.getFirstName()); 
		setBasicAttribute(attrs, "sn", user.getLastName()); 
		setBasicAttribute(attrs, "userpassword", user.getPassword()); 	
		//修改属性 
		try{
			dirContext.modifyAttributes(user.getDistinguishedName(),DirContext.REPLACE_ATTRIBUTE, attrs); 
			System.out.println("User(" + user.getDistinguishedName() + ") information modified.n");
			return true;
		}catch(NamingException ne){
			ne.printStackTrace();
		}
		return false;
	}



删除条目
删除DN= userDN条目

Java代码
  1. /**  
  2.  * 删除用户  
  3.  * @param userDN  
  4.  * @return  
  5.  */   
  6. public   boolean  deleteUser(String userDN) {   
  7.     if (!isUserexist(userDN)) {   
  8.         return   true ;  
  9.     }   
  10.     try  {  
  11.         dirContext.destroySubcontext(userDN);  
  12.         System.out.println("User( "  + userDN +  ") deleted.n" );   
  13.         return   true ;  
  14.     } catch  (NamingException e) {  
  15.         e.printStackTrace();  
  16.     }   
  17.     return   false ;         
  18. }  
[java] view plain copy print ?
  1. /** 
  2.  * 删除用户 
  3.  * @param userDN 
  4.  * @return 
  5.  */  
  6. public boolean deleteUser(String userDN) {   
  7.     if(!isUserexist(userDN)) {   
  8.         return true;  
  9.     }   
  10.     try {  
  11.         dirContext.destroySubcontext(userDN);  
  12.         System.out.println("User( " + userDN + ") deleted.n");   
  13.         return true;  
  14.     } catch (NamingException e) {  
  15.         e.printStackTrace();  
  16.     }   
  17.     return false;         
  18. }  
	/**
	 * 删除用户
	 * @param userDN
	 * @return
	 */
	public boolean deleteUser(String userDN) { 
		if(!isUserexist(userDN)) { 
			return true;
		} 
		try {
			dirContext.destroySubcontext(userDN);
			System.out.println("User( " + userDN + ") deleted.n"); 
			return true;
		} catch (NamingException e) {
			e.printStackTrace();
		} 
		return false;		
	}



根据属性集搜索条目
根据属性集matchingAttributes中的匹配值，在上下文DN= "ou=People,dc=jsoso ,dc=net"中搜索它的所有子树中的匹配条目。
（注：SearchControls的SCOPE参数详见SearchControls SCOPE补充说明）

Java代码
  1.           /**  
  2.  * 通过属性搜索LDAP范例   
  3.  * @return  
  4.  */   
  5. public   void  searchByAttribute(Attributes matchingAttributes){  
  6.      String baseDN = "ou=People,dc=jsoso ,dc=net" ;  
  7.      SearchControls cons = new  SearchControls();  
  8.      cons.setSearchScope(SearchControls.SUBTREE_SCOPE);  
  9.      try  {  
  10.         Name baseName = new  LdapName(baseDN);  
  11.         NamingEnumeration<SearchResult> ne = dirContext.search(baseName, matchingAttributes);  
  12.         SearchResult entry = null ;  
  13.         for (;ne.hasMore();){  
  14.             entry = ne.next();  
  15.             showEntry(entry);  
  16.         }                     
  17.     } catch  (NamingException e) {  
  18.         e.printStackTrace();  
  19.     }  
  20. }  
[java] view plain copy print ?
  1.          /** 
  2.  * 通过属性搜索LDAP范例  
  3.  * @return 
  4.  */  
  5. public void searchByAttribute(Attributes matchingAttributes){  
  6.      String baseDN = "ou=People,dc=jsoso ,dc=net";  
  7.      SearchControls cons = new SearchControls();  
  8.      cons.setSearchScope(SearchControls.SUBTREE_SCOPE);  
  9.      try {  
  10.         Name baseName = new LdapName(baseDN);  
  11.         NamingEnumeration<SearchResult> ne = dirContext.search(baseName, matchingAttributes);  
  12.         SearchResult entry = null;  
  13.         for(;ne.hasMore();){  
  14.             entry = ne.next();  
  15.             showEntry(entry);  
  16.         }                     
  17.     } catch (NamingException e) {  
  18.         e.printStackTrace();  
  19.     }  
  20. }  
          /**
	 * 通过属性搜索LDAP范例 
	 * @return
	 */
	public void searchByAttribute(Attributes matchingAttributes){
		 String baseDN = "ou=People,dc=jsoso ,dc=net";
		 SearchControls cons = new SearchControls();
		 cons.setSearchScope(SearchControls.SUBTREE_SCOPE);
		 try {
			Name baseName = new LdapName(baseDN);
			NamingEnumeration<SearchResult> ne = dirContext.search(baseName, matchingAttributes);
			SearchResult entry = null;
			for(;ne.hasMore();){
				entry = ne.next();
				showEntry(entry);
			}					
		} catch (NamingException e) {
			e.printStackTrace();
		}
	}



根据过滤器搜索条目
根据过滤器条件，在上下文DN = "ou=People,dc=jsoso ,dc=net"中，搜索它的所有子树中的匹配条目。
（注：过滤器filter的相关语法详见LDAP filter语法补充说明）

Java代码
  1. /**  
  2.  * 通过过滤器搜索LDAP范例   
  3.  * @return  
  4.  */   
  5. public   void  searchByFilter(String filter){  
  6.      String baseDN = "ou=People,dc=jsoso ,dc=net" ;         
  7.      SearchControls cons = new  SearchControls();  
  8.      cons.setSearchScope(SearchControls.SUBTREE_SCOPE);  
  9.      try  {  
  10.         NamingEnumeration<SearchResult> ne = dirContext.search(baseDN, filter , cons);  
  11.         SearchResult entry = null ;  
  12.         for (;ne.hasMore();){  
  13.             entry = ne.next();  
  14.             showEntry(entry);  
  15.         }                     
  16.     } catch  (NamingException e) {  
  17.         e.printStackTrace();  
  18.     }  
  19. }  
[java] view plain copy print ?
  1. /** 
  2.  * 通过过滤器搜索LDAP范例  
  3.  * @return 
  4.  */  
  5. public void searchByFilter(String filter){  
  6.      String baseDN = "ou=People,dc=jsoso ,dc=net";         
  7.      SearchControls cons = new SearchControls();  
  8.      cons.setSearchScope(SearchControls.SUBTREE_SCOPE);  
  9.      try {  
  10.         NamingEnumeration<SearchResult> ne = dirContext.search(baseDN, filter , cons);  
  11.         SearchResult entry = null;  
  12.         for(;ne.hasMore();){  
  13.             entry = ne.next();  
  14.             showEntry(entry);  
  15.         }                     
  16.     } catch (NamingException e) {  
  17.         e.printStackTrace();  
  18.     }  
  19. }  
	/**
	 * 通过过滤器搜索LDAP范例 
	 * @return
	 */
	public void searchByFilter(String filter){
		 String baseDN = "ou=People,dc=jsoso ,dc=net";		 
		 SearchControls cons = new SearchControls();
		 cons.setSearchScope(SearchControls.SUBTREE_SCOPE);
		 try {
			NamingEnumeration<SearchResult> ne = dirContext.search(baseDN, filter , cons);
			SearchResult entry = null;
			for(;ne.hasMore();){
				entry = ne.next();
				showEntry(entry);
			}					
		} catch (NamingException e) {
			e.printStackTrace();
		}
	}



相关补充

javax.naming.Name对象说明
在API中，我们常常见到对LDAP上下文条目有两种参数形式，一种是大家都熟悉的String参数，如： String baseDN = "ou=People,dc=jsoso ,dc=net";
另一种是使用javax.naming.Name类型的参数，那么Name类和String有什么区别呢？
简单的说，Name是对String类DN的封装，它把一个完整的DN字窜分解成了RDN的list。这个list的顺序刚好和String相反。就拿"ou=People,dc=jsoso ,dc=net"为例，Name中的RDN顺序是[0]=net，[1]=jsoso，[2]=People。这样做的好处是更方便对Name进行操作，比如取其前缀或者后缀。

SearchControls SCOPE补充说明


LDAP filter语法补充说明
filter的运算符

filter布尔运算符


搜索过滤器示例

  • 下列过滤器将搜索包含一个或多个 manager 属性值的条目。这也称为存在搜索： manager=*
  • 下列过滤器将搜索包含通用名 Ray Kultgen 的条目。这也称为等价搜索：cn=Ray Kultgen
  • 下列过滤器返回所有不包含通用名 Ray Kultgen 的条目：(!(cn=Ray Kultgen))
  • 下列过滤器返回的所有条目中都有包含子字符串 X.500 的说明属性：description=*X.500*
  • 下列过滤器返回所有组织单元为 Marketing 且说明字段中不包含子字符串 X.500 的条目： (&(ou=Marketing)(!(description=*X.500*)))
  • 下列过滤器返回所有组织单元为 Marketing 且 manager 为 Julie Fulmer 或 Cindy Zwaska 的条目： (&(ou=Marketing)(|(manager=cn=Julie Fulmer,ou=Marketing,dc=siroe,dc=com)(manager=cn=Cindy Zwaska,ou=Marketing,dc=siroe,dc=com)))
  • 下列过滤器返回所有不代表人员的条目： (!(objectClass=person))
  • 下列过滤器返回所有不代表人员且通用名近似于 printer3b 的条目：(&(!(objectClass=person))(cn~=printer3b))
kongls08
关注
  • 0
    点赞
  • 踩
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
LDAP API 文档
10-24
LDAP API 文档 SUN Sun Directory Server_LDAP LDAP的英文全称是Lightweight Directory Access Protocol，一般都简称为LDAP。它是基于X.500标准的，但是简单多了并且可以根据需要定制。与X.500不同，LDAP支持TCP/IP，这对访问Internet是必须的。LDAP的核心规范在RFC中都有定义，所有与LDAP相关的RFC都可以在LDAPman RFC网页中找到
Spring LDAP API（Spring LDAP 开发文档）.CHM
08-31
Spring LDAP。 官网 Spring LDAP API。 Spring LDAP 开发文档。
LDAP 开发 API
04-05
LDAP API开发帮助手册； 基于LDAP V3协议对目录（LDAP）进行开发管理，包括对象管理、Schema管理、权限等信息内容的开发管理
Ldap 之API 简单运用
Stay Focused And Work Hard !!!
08-03 5638
直接上代码package com.bms.service.ldapimpl;import java.util.ArrayList; import java.util.List;import org.jboss.logging.Logger;import com.bms.service.LdapApi; import com.bms.utils.PropertyUtil; import com.unb
LDAP API For Python 应用实例
老实人的博客
04-16 1039
LDAP API For Python 应用实例 前言 公司内部通过 LDAP 统一管理所有平台用户，并且使用LDAP 目录服务器接入 Linux 服务器实现Linux 用户管理，但是日常管理如：添加用户、删除用户、修改用户属性、新增用户属性等操作，实现方法目前有 2 种，第一种：登陆LDAP Server 端服务器通过*.ldif 文件对 LDAP 进行操作，第二种：通过 ldapphpadmin web 平台进行操作，两种方式都需要首先登陆到平台（Linux 服务器或者 web），再通过手动的方式进行编
Ldap Api
TechChan的专栏
03-31 8264
Java6.0 API for LDAP概述 从JDK5.0开始，对LDAP协议的数据访问操作就被集成在javax的扩展API包中，并随同JDK一并发布，这一章节，我们主要介绍API包中的类信息。 javax.naming.directory 包的结构 常用API解析 javax.naming.directory.InitialDirContext，初始化目录服务上下文类 该类是LDAP数据内容的
Java LDAP操作
qq_31473465的博客
07-01 1005
命名和目录操作 您可以使用JNDI执行以下操作：读取操作和更新命名空间的操作。本节介绍这两个操作： l查询对象 l列出上下文内容 l添加、覆盖和移除绑定 l重命名对象 l创建和销毁子上下文 配置 在命名和目录服务中执行操作之前，需要得到初始化上下文――命名空间的开始点。因为命名和目录服务的所有...
DirContext初始化过程分析
cjのice_bear
04-12 5339
这篇博文的原因主要是因为犯了一个很愚蠢的错误，在实例化DirContext的时候报了AuthenticationException，错误码为49，我很疑惑，同样的方式通过ldapBrowser可以连接，在JNDI却不能连接了，同样尝试了Java的Apache Directory Studio插件也是不能连接，但是匿名连接却连接得上。基于这个原因便开始了探究初始化过程的分析，不过最后的结论却是——只是
LDAP 应用程序接口
01-16
LDAP 应用程序接口:介绍了LDAP API使用的一般知识。
Spring Data LDAP API（Spring Data LDAP 开发文档）.CHM
08-31
Spring Data LDAP API。 Spring Data LDAP 开发文档。 官网 Spring Data LDAP API。
LDAP API doc
07-26
LDAP API documentation detail LDAP APIs
LDAP API
linnet2000的专栏
07-05 5556
LDAP  API 介绍这篇文档定义了 LDAP API （C语言版）。它使用方便，功能强大，大致内容有以下几个方面：简单浏览LDAP模型应用程序怎样使用API去获取LDAP信息详细介绍API 调用函数举例使用API 及部分样本代码      下面我们分别介绍。简单浏览LDAP模型       LDAP 是以client-server 模型为基础的，在此模型中，客户机可以建立与LDAP服务器的连接
OPENLDAP API 编程简述
bytxl的专栏
07-29 4274
http://www.lisdn.com/html/03/n-11703.html 一、 LDAP模型概览：   1、 LDAP的数据存储在众多的Entry（条目）里；   2、 LDAP中所有的Entry以树型结构组织在一起；   3、 Entry由唯一的DN(Distinguished Name)标识和定位，DN就是树上到该Entry的路       径标识；   4、 Entry
Python-ldap的API使用
Samooyou的博客
04-14 660
这个示例连接到一个 LDAP 服务器，使用管理员凭据进行身份验证，然后搜索具有特定电子邮件地址的用户。它检索用户的 uid，名字，姓氏和电子邮件，并将它们打印到控制台上。最后，它关闭了 LDAP 连接。你可以根据需要修改搜索过滤器，搜索基础和属性列表。
LDAP介绍
oakscut的专栏
09-23 1089
1. LDAP能做什么大多数的LDAP服务器都为读密集型的操作进行专门的优化。因此，当从LDAP服务器中读取数据的时候会比从专门为OLTP优化的关系型数据库 中读取数据快一个数量级。也是因为专门为读的性能进行优化，大多数的LDAP目录服务器并不适合存储需要需要经常改变的数据。它主要面向数据的查询服务 （查询和修改操作比一般是大于10:1），不提供事务的回滚（rollback）机制，它的数据
ldap相关总结
weixin_42594382的博客
11-15 866
LDAP( Lightweight Directory Access Protocol) 轻量目录访问协议，LDAP目录以树状的层次结构来存储数据。 相关术语：DN :Distinguished Name区分名，一条记录的唯一标识（路径） CN：Common Name 登陆名，最长80个字符。 OU：Organization Unit为组织单元，最多可以有四级，每级最长32个字符，可以...
UPS、蓄电池、空开、电缆配置计算方法.pptx
最新发布
04-27
5G通信行业、网络优化、通信工程建设资料
java ldap 客户端
06-02
Java提供了一些原生的LDAP客户端API，可以用于开发LDAP客户端。以下是一些常用的Java LDAP客户端API： 1. JNDI（Java Naming and Directory Interface）：Java命名和目录接口，是Java平台的一个标准API，提供了访问...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值