JNDI的学习与使用
JNDI(Java Naming and Directory Interface,Java命名和目录接口)是一组在Java应用中访问命名和目录服务的API。命名服务将名称和对象联系起来,使得我们可以用名称访问对象。这是比较专业的解释。
我们一般是在数据源这块使用JNDI,有些服务器(例如Tomcat)中自带数据库连接池,我们可以通过JNDI服务去这个连接池中找到对应的数据源Connection。所以我的一个比较狭隘的理解是:服务器在初始化Connection之后,就会放在默认的连接池中,因为可能会有多个数据源,所以就需要有一个名称去对应,而JNDI正是去做这项工作。
需要理解的是JNDI与JDBC类似,都是制定了一套标准,而不是具体的实现。
JNDI配置(局部配置)
局部配置只针对当前项目有效。在项目的META-INF 下建立context.xml (这是固定名称) 。在这个XML中配置数据库连接的四大参数,连接池的配置(不指定具体配置也会有默认值),JNDI的名称等属性
<?xml version="1.0" encoding="UTF-8"?> <Context> <!-- - name:表示以后要查找的名称。通过此名称可以找到DataSource,此名称任意更换,但是程序中最终要查找的就是此名称,为了不与其他的名称混淆,所以使用jdbc/oracle,现在配置的是一个jdbc的关于oracle的命名服务。 - auth:由容器进行授权及管理,指的用户名和密码是否可以在容器上生效 - type:此名称所代表的类型,现在为javax.sql.DataSource - maxActive:表示一个数据库在此服务器上所能打开的最大连接数 Tomcat8.0及以上版本使用maxTotal - maxIdle:表示一个数据库在此服务器上维持的最大空闲连接 - maxWait:最大等待时间。10000毫秒 设置为-1表示无限等待 Tomcat8.0及以上版本使用DBCP2 部署这些服务器需要使用maxWaitMillis - username:数据库连接的用户名 - password:数据库连接的密码 - driverClassName:数据库连接的驱动程序 - url:数据库连接的地址 - initialSize:初始化连接数 --> <Resource name="jndi/oracle" auth="Container" type="javax.sql.DataSource" driverClassName="oracle.jdbc.driver.OracleDriver" url="jdbc:oracle:thin:@localhost:1521:Orcl" username="scott" password="tiger" maxActive="20" maxIdle="5" maxWait="10000" initialSize="10"/> </Context>
如果有多个数据源的需求,配置多个Resource 标签即可,根据name区分。
在未使用其他数据库连接池的情况下,会默认使用Servlet容器自带的数据源(Tomcat自带的是DBCP数据源,毕竟是Apache一家的产品,可以在Tomcat-安装目录/lib 下找到这个jar),但是需要注意的是Tomcat版本之间有些许差异:Tomcat7使用的是DBCP,Tomcat8及以上版本使用的是DBCP2,这两个DBCP的一些连接池配置项名称有些许不同,需要使用对应的名称,否则该项的自定义配置不会生效,而是使用默认配置。DBCP全部的配置可以看这里: DBCP官方文档
测试JNDI是否生效
这里使用Servlet只是为了方便测试(因为JDNI需要依赖Servlet容器,并且容器需要开启),最主要的操作就是通过JNDI获得Connection
import java.io.IOException; import java.sql.Connection; import java.sql.SQLException; import javax.naming.Context; import javax.naming.InitialContext; import javax.naming.NamingException; import javax.servlet.ServletException; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import javax.sql.DataSource; public class JNDITest extends HttpServlet { @Override protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { Context ctx; DataSource ds = null; try { ctx = new InitialContext(); //java:comp/env/ 是固定写法 后面的名字是在context.xml中配置的 ds = (DataSource) ctx.lookup("java:comp/env/jndi/oracle"); Connection conn = null; try { conn = ds.getConnection(); System.out.println(conn.getClass()); System.out.println(conn.isClosed()); } catch (SQLException e) { e.printStackTrace(); }finally { try { conn.close(); } catch (SQLException e) { e.printStackTrace(); } } } catch (NamingException e) { e.printStackTrace(); } } @Override protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { this.doGet(req, resp); } }
<servlet> <servlet-name>JNDITest</servlet-name> <servlet-class>JNDITest</servlet-class> </servlet> <servlet-mapping> <servlet-name>JNDITest</servlet-name> <url-pattern>/JNDITest</url-pattern> </servlet-mapping>
Servlet的配置没什么可说的,主要在意的使用 javax.naming.Context 并根据JNDI名lookup一个DataSource,还有就是注意这个JNDI的名称写法,是有要求的
JNDI配置(全局配置)
全局配置是配置在Tomcat的配置上的,所有部署在这台Tocmat上的项目,在未使用其他数据库连接池的情况下,会默认使用这个配置。在tomcat-安装目录\conf\server.xml 文件中有一个GlobalNamingResources 标签,在它下面配置 Resource 标签, 具体的配置项和在context.xml 中配置类似,这种全局配置应该使用的并不过吧...