关于JNDI那点事

一、JNDI是什么？

JNDI--Java 命名和目录接口（Java Naming and Directory Interface），是一组在Java应用中访问命名和目录服务的API。

二、JNDI好处

解耦：通过注册、查找JNDI服务，可以直接使用服务，而无需关心服务提供者，这样程序不至于与访问的资源耦合！

JNDI优点 写道

JNDI优点 
　　包含了大量的命名和目录服务，使用通用接口来访问不同种类的服务； 　　可以同时连接到多个命名或目录服务上； 　　建立起逻辑关联，允许把名称同Java对象或资源关联起来，而不必知道对象或资源的物理ID。 　　JNDI程序包： 　　javax.naming：命名操作； 　　javax.naming.directory：目录操作； 　　javax.naming.event：在命名目录服务器中请求事件通知； 　　javax.naming.ldap：提供LDAP支持； 　　javax.naming.spi：允许动态插入不同实现。 　　利用JNDI的命名与服务功能来满足企业级APIs对命名与服务的访问，诸如EJBs、JMS、JDBC 2.0以及IIOP上的RMI通过JNDI来使用CORBA的命名服务。

三、JNDI架构与原理

相比较架构与原理，更关注与使用，故略！

四、JNDI使用

在J2EE容器（如weblogic、websphere、jboss等）中使用：

在weblogic环境下查找tuxedo 连接

1. //在weblogic环境查找tuxedo连接
2. Context ctx = new InitialContext();
3. TuxedoConnectionFactory tuxedoFactory = (TuxedoConnectionFactory) ctx.lookup("tuxedo.services.TuxedoConnection");

在web容器查找数据源

1. Context ctx=new InitialContext();
2. DataSource ds=(Datasource)ctx.lookup("java:comp/env/jdbc/mydatasource");

重点关注Context ctx = new InitialContext()，上面的代码在容器下能够很好的工作，尤其是查找数据源的代码，无论是在tomcat，还是在weblogic、jboss，但如果脱离了容器，我们将得到异常“NoInitialContextException”，这是为什么呢？

原因很简单，就是不存在相关的context，其本质是JNDI的服务提供者环境，即谁将提供此环境！

为了能够使上面的代码工作，我们需要使用带参的构造子InitialContext(Hashtable)，指定JNDI服务提供者环境信息，以weblogic环境为例：

1. Hashtable env = new Hashtable();
2. env.put(Context.INITIAL_CONTEXT_FACTORY, "weblogic.jndi.WLInitialContextFactory");
3. env.put(Context.PROVIDER_URL,"t3://localhost:7001");
4. InitialContext ctx = new InitialContext(env);

但上面的代码不适合WebSphere、jboss等环境，原因在于所需环境信息不同，那么，Context ctx = new InitialContext()是如何做到在各个j2ee容器下有效地呢？原因在于这个默认的构造子是从System.properties读取

相关的环境信息的，由此不难猜出在各种J2EE容器下，如weblogic、jboss，它们都自己为自己设置了相应的信息！下面是一个关于System.properties设置JNDI服务环境的例子：

1. System.setProperty(Context.INITIAL_CONTEXT_FACTORY, "weblogic.jndi.WLInitialContextFactory");
2. System.setProperty(Context.PROVIDER_URL, "t3://localhost:7001");
3. InitialContext ctx = new InitialContext();

较为详细点的信息可以参看这里！

五、借助Spring完成JNDI查找

对于手头的weblogic，给出常用的两个查找例子，做个备忘吧！

查找tuxedo connnection：

1. <bean id="tuxedoConnFactory" class="org.springframework.jndi.JndiObjectFactoryBean">
2. <property name="jndiName">
3. <value>tuxedo/services/TuxedoConnection</value>
4. </property>
5. <property name="resourceRef">
6. <value>false</value>
7. </property>
8. <property name="jndiEnvironment">
9. <props>
10. <!-- The value of Context.PROVIDER_URL -->
11. <prop key="java.naming.provider.url">t3://localhost:7001</prop>
12. <prop key="java.naming.factory.initial">weblogic.jndi.WLInitialContextFactory</prop>
13. </props>
14. </property>
15. </bean>

查找DataSource：

1. <bean id="tuxedoConnFactory" class="org.springframework.jndi.JndiObjectFactoryBean">
2. <property name="jndiName">
3. <value>java:comp/env/jdbc/myDatasource</value>
4. </property>
5. </bean>

更多关于spring jndi配置参看这里，下面是其摘录：

Spring中对于JNDI的访问，提供了便捷的方法，在Spring的org.springframework.jndi包中包含了所有的类。其中提供了一下核心类：

（1）JndiTemplate：它是这个包的核心类，用来简化对JNDI的操作。它提供了对于lookup、bind方法。同时，允许JndiCallback接口的实现在其提供的JNDI上下文中执行任何操作。

使用JndiTemplate实现InitialContext环境变量的配置

<bean id="queueTarget" class="org.springframework.jndi.JndiObjectTargetSource">

<property name="jndiName">

<value>queue/testQueue</value>

</property>

<property name="jndiTemplate">

<ref local="jndiTemplate"/>

</property>

</bean>

<bean id="jndiTemplate" class="org.springframework.jndi.JndiTemplate">

<property name="environment">

<props>

<prop key="java.naming.factory.initial">org.jnp.interfaces.NamingContextFactory</prop>

<prop key="java.naming.provider.url">jnp://localhost:1099</prop>

<prop key="java.naming.factory.url.pkgs">org.jboss.naming:org.jnp.interfaces</prop>

</props>

</property>

</bean>

（2）JndiObjectTargetSource

使用JndiObjectTargetSource，例如

<bean id="queueTarget" class="org.springframework.jndi.JndiObjectTargetSource">

<property name="jndiName">

<value>queue/testQueue</value>

</property>

</bean>

（3）JndiObjectFactoryBean：

使用JndiObjectFactoryBean，例如

<bean id="dataSource" class="org.springframework.jndi.JndiObjectFactoryBean">

<property name="jndiName">

<value>java:/MySqlDS</value>

</property>

</bean>

总结（事例）：

数据源的配置：

（1）配置可以访问到同一应用服务器的jndi数据源

<bean id="dataSource" class="org.springframework.jndi.JndiObjectFactoryBean">

<property name="jndiName">

<value>jdbc/cqccms</value>

</property>

</bean>

（2）配置能访问远程jndi数据源

<bean id="dataSource" class="org.springframework.jndi.JndiObjectFactoryBean">

<property name="jndiName">

<value>jdbc/cqccms</value>

</property>

<property name="jndiEnvironment">

<props>

<prop key="java.naming.factory.initial">

weblogic.jndi.WLInitialContextFactory

</prop>

<prop key="java.naming.provider.url">t3://172.16.101.42:7001</prop>

<prop key="java.naming.security.principal">weblogic</prop>

<prop key="java.naming.security.credentials">weblogic</prop>

</props>

</property>

</bean>

事务的配置：

不过事务对象远程访问好像没那么顺利，同理查看org.springframework.transaction.jta.JtaTransactionManager类，没有发现上述方法，不过看到了setJndiTemplate()方法，也不错现配置一个jndiTemplate,如下：

<bean id="jndiTemplate" class="org.springframework.jndi.JndiTemplate" singleton="true"

lazy-init="default" autowire="default" dependency-check="default">

<property name="environment">

<props>

<prop key="java.naming.factory.initial">

weblogic.jndi.WLInitialContextFactory

</prop>

<prop key="java.naming.provider.url">t3://172.16.101.42:7001</prop>

<prop key="java.naming.security.principal">weblogic</prop>

<prop key="java.naming.security.credentials">weblogic</prop>

</props>

</property>

</bean>

然后在配置一下transactionManager,如下

<bean id="transactionManager" class="org.springframework.transaction.jta.JtaTransactionManager" singleton="true"

lazy-init="default" autowire="default" dependency-check="default">

<property name="jndiTemplate">

<ref local="jndiTemplate" />

</property>

<property name="userTransactionName">

<value>weblogic/transaction/UserTransaction</value>

</property>

</bean>

不过JtaTransactionManager默认找jndi name为UserTransaction的jta对象，在同一应用服务器上可以，远程访问不到，后直接查看weblogic的jndi树找到这个jndi名weblogic/transaction/UserTransaction，配置上测试果然成功。