JNDI 配置:JBoss + MySQL

一、JNDI 名词解释

    JNDI 是Java 命名和目录接口(Java Naming and Directory Interface,JNDI)的简称.从一开始就一直是 Java 2 平台企业版(JEE)的核心技术之一。在JMS,JMail,JDBC,EJB等技术中,就大量应用的这种技术。

命名服务:它提供了为给定的数据集创建一个标准名字的能力。它允许把名称同Java对象或资源关联起来,而不必指出对象或资源的物理ID。基本的名字操作包含在Context接口中。

目录服务:目录服务是一种特殊类型的数据库,与SQL Server、Access、Oracle等关系数据库管理系统相反,构造目录服务的目的是为了处理基于行为的事务,并且使用一种关系信息模型。基本的目录服务操作包含在DirContext接口中。

JNDI 的架构与实现
 
JNDI 的服务提供者

    一个服务提供者就是一组Java类的集合,它支持开发者同目录服务进行通信,其方式类似于JDBC驱动程序与数据库之间的通信方式。能够用于JNDI的服务提供者必须实现Context接口或Context的扩展接口Directory- Context。

    在使用JNDI时,读者只需要了解JNDI,而服务提供者才关注实际的网络协议、编码/解码值等细节。

    当下载SDK软件开发包时,同时就下载了Sun公司的一些现有的服务提供者。这些服务提供者包括LDAP、NIS、COS(CORBA对象服务)、RMI注册及文件系统的提供者。如:hashtableObj.put(Context.INITIAL_CONTEXT_FACTORY,"com.sun.jndi.ldap.ldapCtx- Fatory")就是表示使用Sun LDAP服务提供者。当然如果要使用IBM服务提供者时就可以用com.ibm.jndi.LDAPCtxFatory来代替com.sun.jndi.ldap.ldapCtxFatory。

JNDI 的包

JNDI 包含5个包

    ·    javax.naming:主要用于命名操作,它包含了命名服务的类和接口,该包定义了Context接口和InitialContext类;

    ·    javax.naming.directory:主要用于目录操作,它定义了DirContext接口和InitialDir- Context类;

    ·    javax.naming.event:在命名目录服务器中请求事件通知;

    ·    javax.naming.ldap:提供LDAP支持;

    ·    javax.naming.spi:允许动态插入不同实现,为不同命名目录服务供应商的开发人员提供开发和实现的途径,以便应用程序通过JNDI可以访问相关服务。

常用的 JNDI 操作

常用的JNDI操作如下:

 void bind(String sName,Object object),绑定:把名称同对象关联的过程。

 void rebind(String sName,Object object),重新绑定:用来把对象同一个已经存在的名称重新绑定。一般使用rebind()而不使用bind(),因为当有重名的时候rebind()不会出现异常,而bind()会报异常。

 void unbind(String sName),释放:用来把对象从目录中释放出来。

 void lookup(String sName,Object object),查找:返回目录总的一个对象。

 void rename(String sOldName,String sNewName),重命名:用来修改对象名称绑定的名称。

 NamingEnumeration listBindings(String sName),清单:返回绑定在特定上下文中指定属性名对象的清单列表,它返回名字、类和对象本身,它用于那些需要对

具体使用情况如下:

//得到初始目录环境的一个引用

Context cntxt = new InitialContext();

//返回绑定在特定上下文中指定属性名对象的清单列表

NamingEnumeration namEnumList = ctxt.listBinding("cntxtName");

//循环列出所有名字、类和对象

while ( namEnumList.hasMore() )  {

    Binding bnd = (Binding) namEnumList.next();

    String sObjName = bnd.getName();

    String sClassName = bnd.getClassName();

    //得到对象

    SomeObject objLocal = (SomeObject) bnd.getObject();

}

NamingEnumeration list(String sName)与listBindings(String sName)相似,只是它只返回一系列名字/类映射,它主要是用于上下文浏览应用。

 二、JNDI 配置

 配置 JNDI 资源

复制 JBoss 文档的数据库引用的数据源定义模板到 JBoss 服务器。 $DOC_HOME/docs/examples/jca/mysql-ds.xml ---> $Server_HOME/server/default/deploy.

修改 mysql-ds.xml 文件的内容,使之能通过JDBC正确访问你的MySQL数据库,如下:

<?xml version="1.0" encoding="UTF-8"?>
<datasources>
<local-tx-datasource>
    <jndi-name>MySqlDS</jndi-name>
    <connection-url>jdbc:mysql://localhost:3306/demo</connection-url>
    <driver-class>com.mysql.jdbc.Driver</driver-class>
    <user-name>root</user-name>
    <password>rootpassword</password>
<exception-sorter-class-name>org.jboss.resource.adapter.jdbc.vendor.MySQLExceptionSorter</exception-sorter-class-name>
    <metadata>
       <type-mapping>mySQL</type-mapping>
    </metadata>
</local-tx-datasource>
</datasources>

配置 JNDI 资源引用

为了让 JNDI 解析 java:comp/env/jdbc/mydatasource 引用,必须把 <resource-ref> 标签插入 web.xml 文件(Web 应用程序的部署描述符)

<resource-ref>: 资源引用,一般声明管理资源,如数据库驱动程序、JavaMail 会话、自定义类工厂等。
<resource-env-ref>: 资源环境引用,在Servlet 2.4里用来简化设置不需认证信息的资源环境,一般声明与资源相关的被管理对象,如环境参数、resource-ref变量。

<resource-ref>
   <res-ref-name>jdbc/mydatasource</res-ref-name>
   <jndi-name>java:MySqlDS</jndi-name>  // 指向真实的 JNDI name
   <res-type>javax.sql.DataSource</res-type>
   <res-auth>Container</res-auth>
</resource-ref>

<resource-ref> 入口告诉 servlet 容器,部署人员要在 组件命名上下文(component naming context) 中设置一个叫做 jdbc/mydatasource的资源。组件命名上下文由前缀 java:comp/env/ 表示,所以完全限定的本地资源名称是: java:comp/env/jdbc/mydatasource.

使用 JNDI 得到数据源

Connection conn=null;
try {
  Context ctx=new InitialContext();
  Object datasourceRef=ctx.lookup("java:comp/env/jdbc/mydatasource");
  DataSource ds=(Datasource)datasourceRef;
  Connection c=ds.getConnection();
  /* use the connection */
  c.close();
} 
catch(Exception e) {
  e.printStackTrace();
} 
finally {
  if(conn!=null) {
    try {
      conn.close();
    } catch(SQLException e) { }
  }
}

外部资源链接:

JNDI 在 J2EE 中的角色

详解JNDI的lookup资源引用java:/comp/env  

tomcat下jndi的三种配置方式

Apache Tomcat 5.5 Servlet/JSP 容器

resource-ref和resource-env-ref

原文地址:https://www.cnblogs.com/tannerBG/p/3950865.html