JNDI全攻略

名词解释
    jndi是Java 命名和目录接口(Java Naming and Directory Interface,JNDI)的简称.从一开始就一直是 Java 2 平台企业版(JEE)的核心技术之一。在JMS,JMail,JDBC,EJB等技术中,就大量应用的这种技术。
    
为什么会有jndi
    jndi诞生的理由似乎很简单。随着分布式应用的发展,远程访问对象访问成为常用的方法。虽然说通过 Socket等编程手段仍然可实现远程通信,但按照模式的理论来说,仍是有其局限性的。RMI技术,RMI-IIOP技术的产生,使远程对象的查找成为了技术焦点。JNDI技术就应运而生。JNDI技术产生后,就可方便的查找远程或是本地对象。
 
JNDI的架构与实现


JNDI的架构与JDBC的架构非常类似.JNDI架构提供了一组标准命名系统的API,这些API在JDK1.3之前是作为一个单独的扩展包jndi.jar(通过这个地址下载),这个基础API构建在与SPI之上。这个API提供如下五个包
在应用程序中,我们实际上只使到用以上几个包的中类.具体调用类及通信过程对用户来说是透明的.
JNDI API提供了访问不同JNDI服务的一个标准的统一的实现,其具体实现可由不同的 Service Provider 来完成。前面讲的为第一层JNDI API层.
 
最下层为JNDI SPI API及其具体实现。
 

图中所列的一些SPI可从http://java.sun.com/products/jndi/downloads/index.html下载.


包括了几个增强和下面的命名/目录服务提供者:
  • LDAP(Lightweight Directory Access Protocol)服务提供者
  • CORBA COS(Common Object Request Broker Architecture Common Object Services)命名服务提供者 
  • RMI(Java Remote Method Invocation)注册服务提供者
  • DNS(Domain Name System)服务提供者.
  • FSSP(File System Service Provider)文件系统服务提供者
  • 其它服务提供者
 
中间层为命名管理层。其功能应该由JNDI SPI来完成。上层为JNDI API,这个API包在Java 2 SDK 1.3及以上的版本中已经包括。
 
前面讲解的只是作为应用程序客户端的架构实现,其服务端是由SPI对应的公司/厂商来实现的,我们只需将服务端的相关参数传给JNDI API就可以了,具体调用过程由SPI来完成.
 
 
JNDI工作原理
 

下面通过一个示例程序来说明JNDI工作原理(代码为自解释).

/*
    * Created on 2005-3-4
    *
    * To change the template for this generated file go to
    * Window>Preferences>Java>Code Generation>Code and Comments
    */
    package com.sily.jndi;
    import java.io.FileInputStream;
    import java.util.Properties;
    import javax.naming.Context;
    import javax.naming.InitialContext;
    /**
    * @author shizy
    *
    * To change the template for this generated type comment go to
    * Window>Preferences>Java>Code Generation>Code and Comments
    */
    public class TestJbossJNDI {
    /**
    *
    */
    public TestJbossJNDI() {
    super();
    // TODO Auto-generated constructor stub
    }
    public static void main(String[] args) { try {
    Properties env = new Properties();
    //载入jboss的SPI相关参数,包括初始上下文工厂,服务URL,等等
    env.load(new FileInputStream("jbossJndi.properties"));
    env.list(System.out);
    //通过JNDI api 初始化上下文
    InitialContext ctx = new javax.naming.InitialContext(env);
    System.out.println("Got context");
    //create a subContext
    ctx.createSubcontext("/sylilzy");
    ctx.createSubcontext("sylilzy/sily");
    //rebind a object
    ctx.rebind("sylilzy/sily/a", "I am sily a!");
    ctx.rebind("sylilzy/sily/b", "I am sily b!");
    //lookup context
    Context ctx1=(Context)ctx.lookup("sylilzy");
    Context ctx2=(Context)ctx1.lookup("/sylilzy/sily");
    ctx2.bind("/sylilzy/g", "this is g");
    //lookup binded object
    Object o;
    o=ctx1.lookup("sily/a");
    System.out.println("get object from jndi:"+o);
    //rename the object
    ctx2.rename("/sylilzy/g", "g1");
    o=ctx2.lookup("g1");
    System.out.println("get object from jndi:"+o);
    } catch (Exception e) {
    e.printStackTrace();
    }
    }
    }

结果输出如下:
-- listing properties --
java.naming.factory.initial=org.jnp.interfaces.NamingContextFactory
java.naming.provider.url=jnp://localhost:1099
java.naming.factory.url.pkgs=org.jboss.naming:org.jnp.interfaces
Got context
get object from jndi:I am sily a!
get object from jndi:this is g

程序中jbossJndi.properties文件的内容为:信息
java.naming.factory.initial=org.jnp.interfaces.NamingContextFactory
java.naming.factory.url.pkgs=org.jboss.naming:org.jnp.interfaces
java.naming.provider.url=jnp://localhost:1099

注意:要正确运行示例程序,请启动jboss,并将jboss的jbossall-client.jar文件放入classpath中。
 
上述示例程序在jboss服务器的jndi树上建立了几个上下文,并bind了几对象,大家可通过附录中的代码或其它工具查看
查看结果为:
-----------------------------
/sylilzy/sily
-----------------------------
/sylilzy/sily/b:I am sily b!
/sylilzy/sily/a:I am sily a!
/sylilzy/sily/g1:this is g
-----------------------------
-----------------------------
上述程序中,我们的代码只涉及到了jndi API,其它细节如初始化jboss jndi的初始上下文,建立网络连接,与服务器通信,对我们来说都是透明的,另外,我们将jboss jndi的spi包中的类名作为参数传入了程序中,要访问一个远程对象,我们所做的就这么多。
 
下面,再提供一个例子,与上例不同,我们不需要 jboss,我们使用sun的FSSP(File System Service Provider)文件系统服务提供者.注意在这个例子中要使用到前面所说的File System Service Provider for the Java Naming and Directory InterfaceTM (JNDI)相关类(下载)。

public class JndiTest {
	public JndiTest() {
		super();
	}

	public static void main(String[] args) {
		try {
			Properties env = new Properties();
			env.put(Context.INITIAL_CONTEXT_FACTORY, "com.sun.jndi.fscontext.RefFSContextFactory");
			env.put(Context.PROVIDER_URL, "file:///d:/works");
			Context ctx = new InitialContext(env);
			ctx.createSubcontext("/sylilzy");
			ctx.createSubcontext("sylilzy/aaa");

			NamingEnumeration list = ctx.list("/");
			while (list.hasMore()) {
				NameClassPair nc = (NameClassPair) list.next();
				System.out.println(nc);
			}

		} catch (Exception e) {
			e.printStackTrace();
		}
	}
}

这个例子较简单,运行后,它会列出d:/works/下所有的文件和目录,另外你会发现有一个新目录被创建了.本例不同于上例,它并不需要服务端,因为它访问的是文件系统.有关帮助可查阅包内的相关文档。
 

通过对比这两个例子,应该JNDI的工作原理有了一个大致的了解。
总结:
jndi技术体现了分布式应用的优点,同进它的 产生也为分布式对象提供了统一的访问接口。由于篇幅所限,对目录的操作本文未作介绍,其它内容将在接下来的系列中讨论。要对JNDI技术作全面的了解,请 参阅参考资料.要对于JNDI技术深入学习,仍有许多地方值得进一步了解,例如EJB容器所使用的JNDI所提供的对象就有 Local和Remote之分,对于Local Object,对于不同的JVM是不可访问的;对于远程对象的访问,还涉及到Java安全机制。
 
附录:
查看jboss jndi内容的代码:
//----------------------------------------
/*
    * Created on 2005-3-4
    *
    * To change the template for this generated file go to
    * Window>Preferences>Java>Code Generation>Code and Comments
    */
    package com.sily.jndi;
    import java.io.FileInputStream;
    import java.util.Properties;
    import javax.naming.*;
    import javax.naming.Context;
    import javax.naming.InitialContext;
    /**
    * @author shizy
    *
    * To change the template for this generated type comment go to
    * Window>Preferences>Java>Code Generation>Code and Comments
    */
    public class ListJbossJndi {
    /**
    *
    */
    public ListJbossJndi() {
      super();
      // TODO Auto-generated constructor stub
     }
     public static void main(String[] args) {
      try {
       Properties env = new Properties();
       env.load(new FileInputStream("jbossJndi.properties"));
       //env.list(System.out);
       Context ctx = new InitialContext(env);
       listCtx(ctx.lookup("sylilzy"));
      }
      catch (Exception e) {
       e.printStackTrace();
      }
     }
     static void listCtx(Object o){
      if(!(o instanceof Context))log(":"+o);
      else {
       log("\n-----------------------------");
      try {
       Context ctx=(Context)o;
       //log(ctx.getNameInNamespace()+"/:");
       NamingEnumeration list=ctx.listBindings("");
       while(list.hasMore()){
        Binding bind=(Binding)list.next();
        log("\n/"+ctx.getNameInNamespace()+"/"+bind.getName());
        listCtx(bind.getObject());
       }
       log("\n-----------------------------");
      }
      catch (NamingException e) {
       // TODO Auto-generated catch block
       e.printStackTrace();
      }
     }
     }
     static void log(Object o){
      System.out.print(o);
     }
    }



摘要:本文详细介绍了JNDI的目录相关内容,并以DNS Service Provider为例进行了示例代码的演示.本文为系列文章的第二篇,JNDI的基础内容请见本系列的第一篇

总述:

目录(Directory)可看作是对命名(Naming)的一个扩充,一个目录对象不仅像命名一样,而且还提供的对属性(Attributes)的操作.由API文档可知,javax.naming.directory.DirContext 类扩展自Context接口,同样,javax.naming.directory.InitialDirContext也扩展自 javax.naming.InitialContext,由此也可看出目录操作完全支持命名操作。下面给出一个DNS Service Provider例子以演示有关目录的一些操作:

public class TestDNSJndi { 
    public static void main(String[] args) throws Exception { 
        Properties env = new Properties(); 
        env.put(Context.INITIAL_CONTEXT_FACTORY, "com.sun.jndi.dns.DnsContextFactory"); 
        //此IP一定要为要访问的DNS服务器的IP,可通过网络设置查看 
        env.put(Context.PROVIDER_URL, "dns://192.168.0.250"); 
        
        DirContext initContext = new InitialDirContext(env); 
        System.out.println("a:" + initContext); 
        
        DirContext sinaContext = (DirContext) initContext.lookup("www.sina.com"); 
        System.out.println("b:" + sinaContext); 
        printAttributes("c:", sinaContext.getAttributes("")); 
        //从ctx.getAttributes("www.sina.com")与ctx1.getAttributes("")结果一样 
        printAttributes("d:", initContext.getAttributes("www.sina.com")); 
        
        Attributes attrs1 = initContext.getAttributes("www.sina.com", new String[] { "a" }); 
        Attributes attrs2 = initContext.getAttributes("www.163.com", new String[] { "a" }); 
        Attributes attrs3 = sinaContext.getAttributes("", new String[] { "a" }); 
        Attributes attrs4 = initContext.getAttributes("www.baidu.com", new String[] { "a" }); 
        printAttributes("新浪:", attrs1); 
        printAttributes("网易:", attrs2); 
        printAttributes("新浪:", attrs3); 
        printAttributes("百度:", attrs4); 
         
        System.out.println("nameParse:"+sinaContext.getNameInNamespace()); 
        //list,此方法会导致程序lock [gq:实际能运行,计算时间比较长]
        listEnumation("list:",initContext.list("")); 
        
        
        //----------------------search 
        Attributes matchAttrs = new BasicAttributes(true); 
        matchAttrs.put(new BasicAttribute("a", "61.172.201.13")); 
        NamingEnumeration answer = sinaContext.search("www.sina.com", matchAttrs); 
        printNamingEnumeration("search :", answer); 
    } 

    public static void printAttributes(String tag, Attributes attres) throws Exception { 
        for (NamingEnumeration ae = attres.getAll(); ae.hasMore();) { 
            Attribute attr = (Attribute) ae.next(); 
            System.out.println(tag + "-----------------------------------------------\n" 
                            + "attrID: " + attr.getID()); 
            
            /* Print each value */ 
            NamingEnumeration names = attr.getAll();
            while( names.hasMore() ){
            	System.out.println( "value: " + names.next() );
            }
        } 
    } 

    public static void listEnumation(String tag, NamingEnumeration name)throws Exception { 
        for (; name.hasMore();) { 
            NameClassPair nameClass = (NameClassPair) name.next(); 
            System.out.println(tag 
                            + "-----------------------------------------------\nattribute: " 
                            + nameClass.getName() + ":" 
                            + nameClass.getClassName()); 
        } 
    } 

    public static void printNamingEnumeration(String tag, NamingEnumeration e)throws Exception { 
        for (; e.hasMore();) { 
            Attribute attr = (Attribute) e.next(); 
            System.out.println(tag 
                            + "-----------------------------------------------\nattribute: " 
                            + attr.getID()); 
            NamingEnumeration names = attr.getAll();
            while( names.hasMore() ){
            	System.out.println( "value: " + names.next() );
            }
        } 
    } 
} 

上例一个可能运行结果如下:

a:javax.naming.directory.InitialDirContext@5ac072
b:com.sun.jndi.dns.DnsContext@14ed9ff
c:-----------------------------------------------
attrID: CNAME
value: us.sina.com.cn.
d:-----------------------------------------------
attrID: CNAME
value: us.sina.com.cn.
新浪:-----------------------------------------------
attrID: A
value: 202.108.33.60
网易:-----------------------------------------------
attrID: A
value: 210.51.213.180
新浪:-----------------------------------------------
attrID: A
value: 202.108.33.60
百度:-----------------------------------------------
attrID: A
value: 61.135.169.125
value: 61.135.169.105
nameParse:www.sina.com.
list:-----------------------------------------------
attribute: xn--o3cw4h:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: xn--lgbbat1ad8j:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: xn--80akhbyknj4f:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: xn--xkc2dl3a5ee0h:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: xn--11b5bs3a9aj6g:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: xn--wgbh1c:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: coop:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: ws:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: mil:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: wf:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: xn--mgbayh7gpa:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: va:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: xn--45brj9c:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: uz:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: uy:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: xn--hlcj6aya9esc7a:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: gg:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: xn--mgberp4a5d4ar:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: gf:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: ge:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: gd:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: xn--p1ai:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: gb:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: ga:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: xn--mgbc0a9azcg:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: xn--hgbk6aj7f53bba:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: xn--kgbechtv:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: xn--kprw13d:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: fr:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: fo:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: fm:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: xn--g6w251d:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: zw:javax.naming.directory.DirContext
list:-----------------------------------------------
attribute: asia:javax.naming.directory.DirContext
list:-----------------------------------------------
......
attribute: xn--clchc0ea0b2g2a9gcd:javax.naming.directory.DirContext
Exception in thread "main" javax.naming.OperationNotSupportedException
	at com.sun.jndi.dns.DnsContext.c_search(DnsContext.java:448)
	at com.sun.jndi.toolkit.ctx.ComponentDirContext.p_search(ComponentDirContext.java:344)
	at com.sun.jndi.toolkit.ctx.PartialCompositeDirContext.search(PartialCompositeDirContext.java:299)
	at com.sun.jndi.toolkit.ctx.PartialCompositeDirContext.search(PartialCompositeDirContext.java:281)
	at com.sun.jndi.toolkit.ctx.PartialCompositeDirContext.search(PartialCompositeDirContext.java:265)
	at xx.TestDNSJndi.main(TestDNSJndi.java:66)

示例分析:
通过分析代码,我们可以看出我们从DNS服务器获取了指定域名的IP地址,而且可以看出www.sina.com有多个IP.
另外,可以看出从ctx.getAttributes("www.sina.com")得到的结果与ctx1.getAttributes("")结果一样,这便是目录操作的两种模式,这两种模式取得的结果是一样的,这点可以参考API文档(http://java.sun.com/j2se/1.5.0/docs/api/javax/naming/directory/DirContext.html):
There are two basic models of what attributes should be associated with. First, attributes may be directly associated with a DirContext object. In this model, an attribute operation on the named object is roughly...

另外,还有一点需要注意,从ctx.getAttributes()方法返回的Attributes中包含多个Attribute,每个Attribute包含多个values,其它详细内容请参考API文档
最后,代码
NamingEnumeration answer = ctx1.search("www.sina.com", matchAttrs);试图对ctx1进行属性查找,但是抛出了异常,查看 DNS Service Provider 的文档可知,DNS Service Provider 没有提供对search方法的支持,大家可用其它的SP来测试此方法,如LDAP SP

总结:

此例只是简单地演示的JNDI的目录操作,对于目录操作的其它高级主题如Search,Search Scope,Count Limit,Composite Names 等没有详细介绍,请参考其它相关文档.




评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值