JNDI数据源的配置详解

JNDI数据源的配置

一、数据源的由来

在Java开发中，使用JDBC操作数据库的四个步骤如下：

①加载数据库驱动程序(Class.forName("数据库驱动类");)

②连接数据库(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找到一个连接。如下图所示：

那么在以后的操作中，除了数据库的连接方式不一样之外，其他的所有操作都一样，只是关闭的时候不是彻底地关闭数据库，而是把数据库的连接放回到连接池中去。

如果要想使用数据源的配置，则必须配置虚拟目录，因为此配置是在虚拟目录之上起作用的。需要注意的是，如果要想完成以上的功能，在Tomcat服务器上一定要有各个数据库的驱动程序。

二、JNDI+Tomcat配置数据源的两种方式

2.1、全局jndi配置

此种配置需要在server.xml中配置数据源，具体的配置步骤如下：

1、在tomcat服务器的lib目录下加入数据库连接的驱动jar包

2、修改tomcat服务器的conf目录下server.xml配置文件

打开server.xml配置文件，可以看到里面自带的一个全局JNDI配置，如下图所示：

编辑server.xml文件，添加全局JNDI数据源配置，配置如下：

1

4

5

8

9type="https://www.360docs.net/doc/ac13980205.html,erDatabase"

10description="User database that can be updated and saved"

11factory="https://www.360docs.net/doc/ac13980205.html,ers.MemoryUserDatabaseFactory"

12pathname="conf/tomcat-users.xml"/>

13

26

27

28name="jdbc/oracle"

29auth="Container"

30type="javax.sql.DataSource"

31maxActive="100"

32maxIdle="30"

33maxWait="10000"

34username="lead_oams"

35password="p"

36driverClassName="oracle.jdbc.driver.OracleDriver"

37url="jdbc:oracle:thin:@192.168.1.229:1521:lead"/>

38

39

40

41name="jdbc/mysql"

42auth="Container"

43type="javax.sql.DataSource"

44maxActive="100"

45maxIdle="30"

46maxWait="10000"

47username="root"

48password="root"

49driverClassName="com.mysql.jdbc.Driver"

50url="jdbc:mysql://192.168.1.144:3306/leadtest?useUnicode=true&characterEncoding=utf-8"/> 51

52

53

54name="jdbc/sqlserver"

55auth="Container"

56type="javax.sql.DataSource"

57maxActive="100"

58maxIdle="30"

59maxWait="10000"

60username="sa"

61password="p@ssw0rd"

62driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver"

63url="jdbc:sqlserver://192.168.1.51:1433;DatabaseName=demo"/>

64

65

经过以上的两个步骤，全局JNDI数据源就配置好了，在上述的server.xml文件中，分别配置了Oracle、MySQL、SQLServer这三种数据库的全局JNDI数据源。

2.2、全局jndi数据源测试

1、创建一个JNDI测试项目JNDITest，在web.xml中添加JNDI配置的资源引用

web.xml的配置如下：

1

2

3xmlns="https://www.360docs.net/doc/ac13980205.html,/xml/ns/javaee"

4xmlns:xsi="https://www.360docs.net/doc/ac13980205.html,/2001/XMLSchema-instance"

5xsi:schemaLocation="https://www.360docs.net/doc/ac13980205.html,/xml/ns/javaee

6https://www.360docs.net/doc/ac13980205.html,/xml/ns/javaee/web-app_2_5.xsd">

7

8index.jsp

9

10

11

17

18

19Oracle DB Connection

20oracleDataSource

21javax.sql.DataSource

22Container

23

24

25

26

27MySQL DB Connection

28mysqlDataSource

29javax.sql.DataSource

30Container

31

32

33

34

35SQLServer DB Connection

36sqlserverDataSource

37javax.sql.DataSource

38Container

39

40

41

2、映射JNDITest项目的虚拟目录

在tomcat的\conf\Catalina\localhost下（没有目录就新建）创建一个xml文件，文件名必须和项目名相同，测试JNDI 数据源的web项目的项目名称是：JNDITest，所以xml文件的命名就叫JNDITest.xml

编辑JNDITest.xml，配置如下：

1

2

6

7

8

9

10

11

12

13 14

3、测试从JNDI数据源获取数据库连接

配置完数据源连接池之后，就可以按照以下的步骤进行访问：

? 初始化名称查找上下文

?通过JNDI名称找到DataSource

? 通过DataSource取得一个连接

? 操作数据库

? 关闭数据库，关闭的时候是将连接放回到连接池之中

jsp测试页面代码如下：

1 <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>

2 <%@ page import="java.sql.*,javax.sql.*,javax.naming.*" %>

3

4

5

6

7

8

9

10

11<%

12Connection connOracle = null;

13try {

14//1、初始化名称查找上下文

15Context ctx = new InitialContext();

16//InitialContext ctx = new InitialContext();亦可

17//2、通过JNDI名称找到DataSource,对名称进行定位java:comp/env是必须加的,后面跟的是DataSource名

18/*

19DataSource名在web.xml文件中的oracleDataSource进行了配置

20

21

22Oracle DB Connection

23oracleDataSource

24javax.sql.DataSource

25Container

26

27*/

28DataSource ds = (DataSource)ctx.lookup("java:comp/env/oracleDataSource");

29//3、通过DataSource取得一个连接

30connOracle = ds.getConnection();

31out.println("Oracle Connection pool connected !!");

32//4、操作数据库

33} catch (NamingException e) {

34System.out.println(e.getMessage());

35} catch (SQLException e) {

36 e.printStackTrace();

37} finally {

38//5、关闭数据库，关闭的时候是将连接放回到连接池之中

39connOracle.close();

40}

41%>

42

---

43<%

44Connection connMySQL = null;

45try {

46//1、初始化名称查找上下文

47Context ctx = new InitialContext();

48//InitialContext ctx = new InitialContext();亦可

49//2、通过JNDI名称找到DataSource,对名称进行定位java:comp/env是必须加的,后面跟的是DataSource名

50/*

51DataSource名在web.xml文件中的mysqlDataSource进行了配置

52

53

54MySQL DB Connection

55mysqlDataSource

56javax.sql.DataSource

57Container

58

59*/

60DataSource ds = (DataSource)ctx.lookup("java:comp/env/mysqlDataSource");

61//3、通过DataSource取得一个连接

62connMySQL = ds.getConnection();

63out.println("MySQL Connection pool connected !!");

64//4、操作数据库

65} catch (NamingException e) {

66System.out.println(e.getMessage());

67} catch (SQLException e) {

68 e.printStackTrace();

69} finally {

70//5、关闭数据库，关闭的时候是将连接放回到连接池之中

71connMySQL.close();

72}

73%>

74

---

75<%

76Connection connSQLServer = null;

77try {

78//1、初始化名称查找上下文

79Context ctx = new InitialContext();

80//InitialContext ctx = new InitialContext();亦可

81//2、通过JNDI名称找到DataSource,对名称进行定位java:comp/env是必须加的,后面的是DataSource名

82/*

83DataSource名在web.xml文件中的sqlserverDataSource进行了配置

84

85

86SQLServer DB Connection

87sqlserverDataSource

88javax.sql.DataSource

89Container

90

91*/

92DataSource ds = (DataSource)ctx.lookup("java:comp/env/sqlserverDataSource");

93//3、通过DataSource取得一个连接

94connSQLServer = ds.getConnection();

95out.println("SQLServer Connection pool connected !!");

96//4、操作数据库

97} catch (NamingException e) {

98System.out.println(e.getMessage());

99} catch (SQLException e) {

100 e.printStackTrace();

101} finally {

102//5、关闭数据库，关闭的时候是将连接放回到连接池之中

103connSQLServer.close();

104}

105%>

106

107

运行结果如下：

除了可以在Jsp页面中编写java代码测试JNDI数据源连接之外，还有一种比较简单的方式就是使用JSTL标签库提供的sql标签进行测试，测试代码如下：

1 <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>

2 <%--引入JSTL标签库--%>

3 <%@ taglib uri="https://www.360docs.net/doc/ac13980205.html,/jsp/jstl/core" prefix="c"%>

4 <%@ taglib uri="https://www.360docs.net/doc/ac13980205.html,/jsp/jstl/sql" prefix="sql"%>

5

6

7

8

9

10

11

12

Oracle JNDI数据源测试

13<%--使用sql:query标签发送SQL语句去数据库查询数据，查询的结果集保存到rs变量当中，dataSource 属性指明使用的数据源--%>

14

15<%--Oracle JNDI数据源测试SQL--%>

16SELECT * FROM LEAD_OAMS_DBSOURCES

17

18<%--使用c:forEach标签遍历查询结果集rs中的每一行--%>

19

20<%--${row.字段名}获取字段的值--%>

21${row.RESOURCEID}---${row.DBSOURCE_NAME}---${row.DBSOURCE_TYPE}

22

23

---

24

MySQL JNDI数据源测试

25<%--使用sql:query标签发送SQL语句去数据库查询数据，查询的结果集保存到rs变量当中，dataSource属性指明使用的数据源--%>

26

27<%--MySQL JNDI数据源测试SQL--%>

28select * from ld_user

29

30<%--使用c:forEach标签遍历查询结果集rs中的每一行--%>

31

32<%--${row.字段名}获取字段的值--%>

33${row.id}---${https://www.360docs.net/doc/ac13980205.html,ername}---${row.password}

34

35

---

36

SQLServer JNDI数据源测试

37<%--使用sql:query标签发送SQL语句去数据库查询数据，查询的结果集保存到rs变量当中，dataSource属性指明使用的数据源--%>

38

39<%--SQLServer JNDI数据源测试SQL--%>

40select * from t_demo

41

42<%--使用c:forEach标签遍历查询结果集rs中的每一行--%>

43

44<%--${row.字段名}获取字段的值--%>

45${row.id}---${row.time}

46

47

48

运行结果如下：

2.3、非全局jndi配置

非全局JNDI数据源是针对某一个Web项目配置的数据源，具体的配置步骤如下：

1、在tomcat服务器的lib目录下加入数据库连接的驱动jar包

2、针对具体的web项目映射虚拟目录，然后在虚拟目录映射的配置文件中配置JNDI数据源

还是以上面的JNDITest项目为例子进行说明

在tomcat目录下的\conf\Catalina\localhost目录下创建一个JNDITest.xml文件

编辑JNDITest.xml文件，添加对JNDITest项目的虚拟目录的映射和JNDI数据源的配置

1

2

6

7 8

9|- name：表示以后要查找的名称。通过此名称可以找到DataSource，此名称任意更换，但是程序中最终要查找的就是此名称，

10为了不与其他的名称混淆，所以使用jdbc/oracle，现在配置的是一个jdbc的关于oracle的命名服务。11|- auth：由容器进行授权及管理，指的用户名和密码是否可以在容器上生效

12|- type：此名称所代表的类型，现在为javax.sql.DataSource

13|- maxActive：表示一个数据库在此服务器上所能打开的最大连接数

14|- maxIdle：表示一个数据库在此服务器上维持的最小连接数

15|- maxWait：最大等待时间。10000毫秒

16|- username：数据库连接的用户名

17|- password：数据库连接的密码

18|- driverClassName：数据库连接的驱动程序

19|- url：数据库连接的地址

20-->

21

22

23name="oracleDataSource"

24auth="Container"

25type="javax.sql.DataSource"

26maxActive="100"

27maxIdle="30"

28maxWait="10000"

29username="lead_oams"

30password="p"

31driverClassName="oracle.jdbc.driver.OracleDriver"

32url="jdbc:oracle:thin:@192.168.1.229:1521:lead"/>

33

34

35

36name="mysqlDataSource"

37auth="Container"

38type="javax.sql.DataSource"

39maxActive="100"

40maxIdle="30"

41maxWait="10000"

42username="root"

43password="root"

44driverClassName="com.mysql.jdbc.Driver"

45url="jdbc:mysql://192.168.1.144:3306/leadtest?useUnicode=true&characterEncoding=utf-8"/> 46

47

48

49name="sqlserverDataSource"

50auth="Container"

51type="javax.sql.DataSource"

52maxActive="100"

53maxIdle="30"

54maxWait="10000"

55username="sa"

56password="p@ssw0rd"

57driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver" 58url="jdbc:sqlserver://192.168.1.51:1433;DatabaseName=demo"/> 59

3、在web项目的web.xml文件中引用配置好的JNDI数据源

1

7

8

9Oracle DB Connection

10oracleDataSource

11javax.sql.DataSource

12Container

13

14

15

16

17MySQL DB Connection

18mysqlDataSource

19javax.sql.DataSource

20Container

21

22

23

24

25SQLServer DB Connection

26sqlserverDataSource

27javax.sql.DataSource

28Container

29

经过以上3个步骤，针对具体web项目配置的JNDI数据源就算是配置好了。具体的测试和上述测试全局JNDI数据源的方式是一样的。

本文作者：xdp-gacl