Java 之 JNDI

从一个例子来理解 JNDI

要了解JNDI的作用,我们可以从“如果不用JNDI我们怎样做?用了JNDI后我们又将怎样做?”这个问题来探讨。

没有JNDI的做法

程序员开发时,要开发访问 MySQL 的应用,于是将一个对 MySQL JDBC 驱动程序类的引用进行了编码,并通过使用适当的 JDBC URL 连接到数据库。代码如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
Connection conn=null; 
try {
Class.forName("com.mysql.jdbc.Driver", true, Thread.currentThread().getContextClassLoader());
conn=DriverManager.getConnection("jdbc:mysql://MyDBServer?user=xxx&password=xxx");
......
conn.close();
} catch(Exception e) {
e.printStackTrace();
} finally {
if(conn!=null) {
try {
conn.close();
} catch(SQLException e) {}
}
}

这是传统的做法。这种做法一般在小规模的开发过程中不会产生问题,只要程序员熟悉 Java 语言、了解 JDBC 技术和 MySQL,可以很快开发出相应的应用程序。

没有JNDI的做法存在的问题:

  1. 数据库服务器名称 MyDBServer、用户名和口令都可能需要改变,由此引发 JDBC URL 需要修改;
  2. 数据库可能改用别的产品,如改用 DB2 或者 Oracle,引发 JDBC 驱动程序包和类名需要修改;
  3. 随着实际使用终端的增加,原配置的连接池参数可能需要调整;

解决办法:

程序员应该不需要关心“具体的数据库后台是什么?JDBC 驱动程序是什么?JDBC URL 格式是什么?访问数据库的用户名和口令是什么?”等等这些问题,程序员编写的程序应该没有对 JDBC 驱动程序的引用,没有服务器名称,没有用户名称或口令 —— 甚至没有数据库池或连接管理。而是把这些问题交给 J2EE 容器来配置和管理,程序员只需要对这些配置和管理进行引用即可。

由此,就有了JNDI。

用了 JNDI 之后的做法

首先,在在 J2EE 容器中配置 JNDI 参数,定义一个数据源,也就是 JDBC 引用参数,给这个数据源设置一个名称;然后,在程序中,通过数据源名称引用数据源从而访问后台数据库。

具体操作如下(以JBoss为例):

1、配置数据源

在 JBoss 的 /examples/jca 文件夹下面,有很多不同数据库引用的数据源定义模板。将其中的 mysql-ds.xml 文件 Copy 到你使用的服务器下,如 /server/default/deploy。

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
<?xml version="1.0" encoding="UTF-8"?>
<datasources>
<local-tx-datasource>
<jndi-name>MySqlDS</jndi-name>
<connection-url>jdbc:mysql://localhost:3306/lw</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>

这里,定义了一个名为 MySqlDS 的数据源,其参数包括JDBC的URL,驱动类名,用户名及密码等。

2、在程序中引用数据源:

Java code

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
Connection conn=null; 
try {
Context ctx = new InitialContext();
Object datasourceRef = ctx.lookup("java:MySqlDS");
//引用数据源
DataSource ds = (Datasource) datasourceRef;
conn = ds.getConnection();
......
c.close();
} catch(Exception e) {
e.printStackTrace();
} finally {
if(conn!=null) {
try {
conn.close();
} catch(SQLException e) {}
}
}

直接使用 JDBC 或者通过 JNDI 引用数据源的编程代码量相差无几,但是现在的程序可以不用关心具体JDBC参数了。

在系统部署后,如果数据库的相关参数变更,只需要重新配置 mysql-ds.xml 修改其中的JDBC参数,只要保证数据源的名称不变,那么程序源代码就无需修改。

由此可见,JNDI 避免了程序与数据库之间的紧耦合,使应用更加易于配置、易于部署。

总结

J2EE 规范要求所有 J2EE 容器都要提供 JNDI 规范的实现。JNDI 在 J2EE 中的角色就是“交换机” —— J2EE 组件在运行时间接地查找其他组件、资源或服务的通用机制。在多数情况下,提供 JNDI 供应者的容器可以充当有限的数据存储,这样管理员就可以设置应用程序的执行属性,并让其他应用程序引用这些属性(Java 管理扩展(Java Management Extensions,JMX)也可以用作这个目的)。JNDI 在 J2EE 应用程序中的主要角色就是提供间接层,这样组件就可以发现所需要的资源,而不用了解这些间接性。

在 J2EE 中,JNDI 是把 J2EE 应用程序合在一起的粘合剂,JNDI 提供的间接寻址允许跨企业交付可伸缩的、功能强大且很灵活的应用程序。这是 J2EE 的承诺,而且经过一些计划和预先考虑,这个承诺是完全可以实现的。

说白了就是把资源取个名字,再根据名字来找资源。

JNDI(Java Naming and Directory Interface,Java 命名与目录接口)

JNDI(Java Naming and Directory Interface,Java 命名与目录接口)是 Java 提供的一种用于访问命名和目录服务的 API。它允许开发人员 在 Java 应用程序中使用统一的方式来访问各种命名和目录服务,包括 LDAP(轻量级目录访问协议)、CORBA(公共对象请求代理体系结构)和 RMI(远程方法调用)等。

想象一下,你去一个大图书馆找一本书。你可能会去图书管理员那里,告诉他们书的名字,然后他们会帮助你找到这本书。JNDI 就类似于这个图书管理员。

在 Java 程序中,你可能需要连接到数据库、消息队列或其他资源,像连接图书馆的书籍一样。当你需要数据库连接时,你只需告诉JNDI 数据库的名字和连接信息,它将会帮助你获取一个连接。当你需要发送消息到某个队列时,也只需告诉 JNDI 队列的名字和相关信息,它将会帮助你发送消息到正确的队列。

通过JNDI,开发人员可以直接通过名称来访问和操作资源,而不需要关心底层服务的具体实现细节。JNDI 提供了一组用于查找、绑定、解绑、删除等操作的 API,使开发人员可以轻松地管理命名和目录服务,并将其集成到 Java 应用程序中。

JNDI 中的命名(Naming),就是将 Java 对象以某个名称的形式绑定(binding)到一个容器环境(Context)中,以后调用容器环境(Context)的查找(lookup)方法又可以查找出某个名称所绑定的 Java 对象。

JNDI 中的目录(Directory)与文件系统中的目录概念有很大的不同,JNDI 中的目录(Directory)是指将一个对象的所有属性信息保存到一个容器环境中。JNDI 的目录(Directory)原理与 JNDI 的命名(Naming)原理非常相似,主要的区别在于目录容器环境中保存的是对象的属性信息,而不是对象本身,所以,目录提供的是对属性的各种操作。

Reference


Java 之 JNDI
https://flepeng.github.io/021-Java-Java-之-JNDI/
作者
Lepeng
发布于
2021年5月14日
许可协议