JNDI学习总结(一)——JNDI数据源的配置
一、数据源的由来
在Java开发中,使用JDBC操作数据库的四个步骤如下:
②连接数据库(Connection con = DriverManager.getConnection();)
③操作数据库(PreparedStatement stat = con.prepareStatement(sql);stat.executeQuery();)
④关闭数据库,释放连接(con.close();)
也就是说,所有的用户都需要经过此四步进行操作,但是这四步之中有三步(①加载数据库驱动程序、②连接数据库、④关闭数据库,释放连接)对所有人都是一样的,而所有人只有在操作数据库上是不一样,那么这就造成了性能的损耗。
那么最好的做法是,准备出一个空间,此空间里专门保存着全部的数据库连接,以后用户用数据库操作的时候不用再重新加载驱动、连接数据库之类的,而直接从此空间中取走连接,关闭的时候直接把连接放回到此空间之中。
那么此空间就可以称为连接池(保存所有的数据库连接),但是如果要想实现此空间的话,则必须有一个问题要考虑?
1、 如果没有任何一个用户使用连接,那么那么应该维持一定数量的连接,等待用户使用。
2、 如果连接已经满了,则必须打开新的连接,供更多用户使用。
3、 如果一个服务器就只能有100个连接,那么如果有第101个人过来呢?应该等待其他用户释放连接
4、 如果一个用户等待时间太长了,则应该告诉用户,操作是失败的。
如果直接用程序实现以上功能,则会比较麻烦,所以在Tomcat 4.1.27之后,在服务器上就直接增加了数据源的配置选项,直接在服务器上配置好数据源连接池即可。在J2EE服务器上保存着一个数据库的多个连接。每一个连接通过DataSource可以找到。DataSource被绑定在了JNDI树上(为每一个DataSource提供一个名字)客户端通过名称找到在JNDI树上绑定的DataSource,再由DataSource找到一个连接。如下图所示:
二、JNDI+Tomcat配置数据源的两种方式
2.1、全局jndi配置
此种配置需要在server.xml中配置数据源,具体的配置步骤如下:
1、在tomcat服务器的lib目录下加入数据库连接的驱动jar包
2、修改tomcat服务器的conf目录下server.xml配置文件
打开server.xml配置文件,可以看到里面自带的一个全局JNDI配置,如下图所示:
编辑server.xml文件,添加全局JNDI数据源配置,配置如下:
<!-- Global JNDI resources Documentation at /docs/jndi-resources-howto.html --> <GlobalNamingResources> <!-- Editable user database that can also be used by UserDatabaseRealm to authenticate users --> <Resource name="UserDatabase" auth="Container" type="org.apache.catalina.UserDatabase" description="User database that can be updated and saved" factory="org.apache.catalina.users.MemoryUserDatabaseFactory" pathname="conf/tomcat-users.xml" /> <!-- |- name:表示以后要查找的名称。通过此名称可以找到DataSource,此名称任意更换,但是程序中最终要查找的就是此名称, 为了不与其他的名称混淆,所以使用jdbc/oracle,现在配置的是一个jdbc的关于oracle的命名服务。 |- auth:由容器进行授权及管理,指的用户名和密码是否可以在容器上生效 |- type:此名称所代表的类型,现在为javax.sql.DataSource |- maxActive:表示一个数据库在此服务器上所能打开的最大连接数 |- maxIdle:表示一个数据库在此服务器上维持的最小连接数 |- maxWait:最大等待时间。10000毫秒 |- username:数据库连接的用户名 |- password:数据库连接的密码 |- driverClassName:数据库连接的驱动程序 |- url:数据库连接的地址 --> <!--配置Oracle数据库的JNDI数据源--> <Resource name="jdbc/oracle" auth="Container" type="javax.sql.DataSource" maxActive="100" maxIdle="30" maxWait="10000" username="lead_oams" password="p" driverClassName="oracle.jdbc.driver.OracleDriver" url="jdbc:oracle:thin:@192.168.1.229:1521:lead"/> <!--配置MySQL数据库的JNDI数据源--> <Resource name="jdbc/mysql" auth="Container" type="javax.sql.DataSource" maxActive="100" maxIdle="30" maxWait="10000" username="root" password="root" driverClassName="com.mysql.jdbc.Driver" url="jdbc:mysql://192.168.1.144:3306/leadtest?useUnicode=true&characterEncoding=utf-8"/> <!--配置SQLServer数据库的JNDI数据源--> <Resource name="jdbc/sqlserver" auth="Container" type="javax.sql.DataSource" maxActive="100" maxIdle="30" maxWait="10000" username="sa" password="[email protected]" driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver" url="jdbc:sqlserver://192.168.1.51:1433;DatabaseName=demo"/> </GlobalNamingResources>
经过以上的两个步骤,全局JNDI数据源就配置好了,在上述的server.xml文件中,分别配置了Oracle、MySQL、SQLServer这三种数据库的全局JNDI数据源。
2.2、全局jndi数据源测试
1、创建一个JNDI测试项目JNDITest,在web.xml中添加JNDI配置的资源引用
web.xml的配置如下:
<?xml version="1.0" encoding="UTF-8"?> <web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"> <welcome-file-list> <welcome-file>index.jsp</welcome-file> </welcome-file-list> <!-- JNDI配置的资源引用: • res-ref-name:表示引用资源的名称 • res-type:此资源对应的类型为javax.sql.DataSource • res-auth:容器授权管理 --> <!--Oracle数据库JNDI数据源引用 --> <resource-ref> <description>Oracle DB Connection</description> <res-ref-name>oracleDataSource</res-ref-name> <res-type>javax.sql.DataSource</res-type> <res-auth>Container</res-auth> </resource-ref> <!--MySQL数据库JNDI数据源引用 --> <resource-ref> <description>MySQL DB Connection</description> <res-ref-name>mysqlDataSource</res-ref-name> <res-type>javax.sql.DataSource</res-type> <res-auth>Container</res-auth> </resource-ref> <!--SQLServer数据库JNDI数据源引用 --> <resource-ref> <description>SQLServer DB Connection</description> <res-ref-name>sqlserverDataSource</res-ref-name> <res-type>javax.sql.DataSource</res-type> <res-auth>Container</res-auth> </resource-ref> </web-app>
2、映射JNDITest项目的虚拟目录
在tomcat的/conf/Catalina/localhost下(没有目录就新建)创建一个xml文件,文件名必须和项目名相同,测试JNDI数据源的web项目的项目名称是:JNDITest,所以xml文件的命名就叫JNDITest.xml,如下图所示:
编辑JNDITest.xml,配置如下:
<?xml version="1.0" encoding="UTF-8"?> <!-- jndi配置方法(tomcat): 将此文件放置在tomcat/conf/Catalina/localhost下(没有目录就新建) --> <!--映射JNDITest项目的虚拟目录--> <Context docBase="D:/MyEclipse8.5/workspace/JNDITest/WebRoot" debug="0" reloadable="false"> <!--引用Oracle数据库的JNDI数据源--> <ResourceLink name="oracleDataSource" global="jdbc/oracle" type="javax.sql.DataSource"/> <!--引用mysql数据库的JNDI数据源--> <ResourceLink name="mysqlDataSource" global="jdbc/mysql" type="javax.sql.DataSource"/> <!--引用sqlserver数据库的JNDI数据源--> <ResourceLink name="sqlserverDataSource" global="jdbc/sqlserver" type="javax.sql.DataSource"/> </Context>
3、测试从JNDI数据源获取数据库连接
配置完数据源连接池之后,就可以按照以下的步骤进行访问:
• 通过JNDI名称找到DataSource
• 通过DataSource取得一个连接
• 操作数据库
• 关闭数据库,关闭的时候是将连接放回到连接池之中
jsp测试页面代码如下:
<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> <%@ page import="java.sql.*,javax.sql.*,javax.naming.*" %> <!DOCTYPE HTML> <html> <head> <title>JNDI数据源测试</title> </head> <body> <% Connection connOracle = null; try { //1、初始化名称查找上下文 Context ctx = new InitialContext(); //InitialContext ctx = new InitialContext();亦可 //2、通过JNDI名称找到DataSource,对名称进行定位java:comp/env是必须加的,后面跟的是DataSource名 /* DataSource名在web.xml文件中的<res-ref-name>oracleDataSource</res-ref-name>进行了配置 <!--Oracle数据库JNDI数据源引用 --> <resource-ref> <description>Oracle DB Connection</description> <res-ref-name>oracleDataSource</res-ref-name> <res-type>javax.sql.DataSource</res-type> <res-auth>Container</res-auth> </resource-ref> */ DataSource ds = (DataSource)ctx.lookup("java:comp/env/oracleDataSource"); //3、通过DataSource取得一个连接 connOracle = ds.getConnection(); out.println("Oracle Connection pool connected !!"); //4、操作数据库 } catch (NamingException e) { System.out.println(e.getMessage()); } catch (SQLException e) { e.printStackTrace(); } finally { //5、关闭数据库,关闭的时候是将连接放回到连接池之中 connOracle.close(); } %> <hr/> <% Connection connMySQL = null; try { //1、初始化名称查找上下文 Context ctx = new InitialContext(); //InitialContext ctx = new InitialContext();亦可 //2、通过JNDI名称找到DataSource,对名称进行定位java:comp/env是必须加的,后面跟的是DataSource名 /* DataSource名在web.xml文件中的<res-ref-name>mysqlDataSource</res-ref-name>进行了配置 <!--MySQL数据库JNDI数据源引用 --> <resource-ref> <description>MySQL DB Connection</description> <res-ref-name>mysqlDataSource</res-ref-name> <res-type>javax.sql.DataSource</res-type> <res-auth>Container</res-auth> </resource-ref> */ DataSource ds = (DataSource)ctx.lookup("java:comp/env/mysqlDataSource"); //3、通过DataSource取得一个连接 connMySQL = ds.getConnection(); out.println("MySQL Connection pool connected !!"); //4、操作数据库 } catch (NamingException e) { System.out.println(e.getMessage()); } catch (SQLException e) { e.printStackTrace(); } finally { //5、关闭数据库,关闭的时候是将连接放回到连接池之中 connMySQL.close(); } %> <hr/> <% Connection connSQLServer = null; try { //1、初始化名称查找上下文 Context ctx = new InitialContext(); //InitialContext ctx = new InitialContext();亦可 //2、通过JNDI名称找到DataSource,对名称进行定位java:comp/env是必须加的,后面的是DataSource名 /* DataSource名在web.xml文件中的<res-ref-name>sqlserverDataSource</res-ref-name>进行了配置 <!--SQLServer数据库JNDI数据源引用 --> <resource-ref> <description>SQLServer DB Connection</description> <res-ref-name>sqlserverDataSource</res-ref-name> <res-type>javax.sql.DataSource</res-type> <res-auth>Container</res-auth> </resource-ref> */ DataSource ds = (DataSource)ctx.lookup("java:comp/env/sqlserverDataSource"); //3、通过DataSource取得一个连接 connSQLServer = ds.getConnection(); out.println("SQLServer Connection pool connected !!"); //4、操作数据库 } catch (NamingException e) { System.out.println(e.getMessage()); } catch (SQLException e) { e.printStackTrace(); } finally { //5、关闭数据库,关闭的时候是将连接放回到连接池之中 connSQLServer.close(); } %> </body> </html>
运行结果如下:
除了可以在Jsp页面中编写java代码测试JNDI数据源连接之外,还有一种比较简单的方式就是使用JSTL标签库提供的sql标签进行测试,测试代码如下:
<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> <%--引入JSTL标签库 --%> <%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%> <%@ taglib uri="http://java.sun.com/jsp/jstl/sql" prefix="sql"%> <!DOCTYPE HTML> <html> <head> <title>JNDI数据源连接测试</title> </head> <body> <h3>Oracle JNDI数据源测试</h3> <%--使用sql:query标签发送SQL语句去数据库查询数据,查询的结果集保存到rs变量当中,dataSource属性指明使用的数据源--%> <sql:query var="rs" dataSource="oracleDataSource"> <%--Oracle JNDI数据源测试 SQL--%> SELECT * FROM LEAD_OAMS_DBSOURCES </sql:query> <%--使用c:forEach标签遍历查询结果集rs中的每一行--%> <c:forEach var="row" items="${rs.rows}"> <%--${row.字段名}获取字段的值--%> ${row.RESOURCEID}---${row.DBSOURCE_NAME}---${row.DBSOURCE_TYPE}<br/> </c:forEach> <hr/> <h3>MySQL JNDI数据源测试</h3> <%--使用sql:query标签发送SQL语句去数据库查询数据,查询的结果集保存到rs变量当中,dataSource属性指明使用的数据源--%> <sql:query var="rs" dataSource="mysqlDataSource"> <%--MySQL JNDI数据源测试 SQL--%> select * from ld_user </sql:query> <%--使用c:forEach标签遍历查询结果集rs中的每一行--%> <c:forEach var="row" items="${rs.rows}"> <%--${row.字段名}获取字段的值--%> ${row.id}---${row.username}---${row.password}<br/> </c:forEach> <hr/> <h3>SQLServer JNDI数据源测试</h3> <%--使用sql:query标签发送SQL语句去数据库查询数据,查询的结果集保存到rs变量当中,dataSource属性指明使用的数据源--%> <sql:query var="rs" dataSource="sqlserverDataSource"> <%--SQLServer JNDI数据源测试 SQL--%> select * from t_demo </sql:query> <%--使用c:forEach标签遍历查询结果集rs中的每一行--%> <c:forEach var="row" items="${rs.rows}"> <%--${row.字段名}获取字段的值--%> ${row.id}---${row.time}<br/> </c:forEach> </body> </html>
运行结果如下:
2.3、非全局jndi配置
非全局JNDI数据源是针对某一个Web项目配置的数据源,具体的配置步骤如下:
1、在tomcat服务器的lib目录下加入数据库连接的驱动jar包
2、针对具体的web项目映射虚拟目录,然后在虚拟目录映射的配置文件中配置JNDI数据源
还是以上面的JNDITest项目为例子进行说明
在tomcat目录下的/conf/Catalina/localhost目录下创建一个JNDITest.xml文件,如下图所示:
编辑JNDITest.xml文件,添加对JNDITest项目的虚拟目录的映射和JNDI数据源的配置
<?xml version="1.0" encoding="UTF-8"?> <!-- jndi配置方法(tomcat): 将此文件放置在tomcat/conf/Catalina/localhost下(没有目录就新建) --> <Context docBase="D:/MyEclipse8.5/workspace/JNDITest/WebRoot" debug="0" reloadable="false"> <!-- |- name:表示以后要查找的名称。通过此名称可以找到DataSource,此名称任意更换,但是程序中最终要查找的就是此名称, 为了不与其他的名称混淆,所以使用jdbc/oracle,现在配置的是一个jdbc的关于oracle的命名服务。 |- auth:由容器进行授权及管理,指的用户名和密码是否可以在容器上生效 |- type:此名称所代表的类型,现在为javax.sql.DataSource |- maxActive:表示一个数据库在此服务器上所能打开的最大连接数 |- maxIdle:表示一个数据库在此服务器上维持的最小连接数 |- maxWait:最大等待时间。10000毫秒 |- username:数据库连接的用户名 |- password:数据库连接的密码 |- driverClassName:数据库连接的驱动程序 |- url:数据库连接的地址 --> <!--配置Oracle数据库的JNDI数据源--> <Resource name="oracleDataSource" auth="Container" type="javax.sql.DataSource" maxActive="100" maxIdle="30" maxWait="10000" username="lead_oams" password="p" driverClassName="oracle.jdbc.driver.OracleDriver" url="jdbc:oracle:thin:@192.168.1.229:1521:lead"/> <!--配置MySQL数据库的JNDI数据源--> <Resource name="mysqlDataSource" auth="Container" type="javax.sql.DataSource" maxActive="100" maxIdle="30" maxWait="10000" username="root" password="root" driverClassName="com.mysql.jdbc.Driver" url="jdbc:mysql://192.168.1.144:3306/leadtest?useUnicode=true&characterEncoding=utf-8"/> <!--配置SQLServer数据库的JNDI数据源--> <Resource name="sqlserverDataSource" auth="Container" type="javax.sql.DataSource" maxActive="100" maxIdle="30" maxWait="10000" username="sa" password="[email protected]" driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver" url="jdbc:sqlserver://192.168.1.51:1433;DatabaseName=demo"/> </Context>
3、在web项目的web.xml文件中引用配置好的JNDI数据源
<!-- JNDI配置的资源引用: • res-ref-name:表示引用资源的名称 • res-type:此资源对应的类型为javax.sql.DataSource • res-auth:容器授权管理 --> <!--Oracle数据库JNDI数据源引用 --> <resource-ref> <description>Oracle DB Connection</description> <res-ref-name>oracleDataSource</res-ref-name> <res-type>javax.sql.DataSource</res-type> <res-auth>Container</res-auth> </resource-ref> <!--MySQL数据库JNDI数据源引用 --> <resource-ref> <description>MySQL DB Connection</description> <res-ref-name>mysqlDataSource</res-ref-name> <res-type>javax.sql.DataSource</res-type> <res-auth>Container</res-auth> </resource-ref> <!--SQLServer数据库JNDI数据源引用 --> <resource-ref> <description>SQLServer DB Connection</description> <res-ref-name>sqlserverDataSource</res-ref-name> <res-type>javax.sql.DataSource</res-type> <res-auth>Container</res-auth> </resource-ref>
经过以上3个步骤,针对具体web项目配置的JNDI数据源就算是配置好了。具体的测试和上述测试全局JNDI数据源的方式是一样的!
原创文章,作者:ItWorker,如若转载,请注明出处:https://blog.ytso.com/tech/pnotes/19486.html