JDBC数据源 使用JNDI连接池实现数据库的连接

时间:2022-10-08 11:08:26

0.引言

许多Web应用程序需要通过JDBC驱动程序访问数据库,以支持该应用程序所需的功能。Java EE平台规范要求Java EE应用程序服务器为此目的提供一个DataSource实现(即,用于JDBC连接的连接池)。Tomcat提供了完全相同的支持,因此使用此服务在Tomcat上开发的基于数据库的应用程序将在任何Java EE服务器上保持不变。

有关JDBC的信息,请参考以下内容:

 - Tomcat中的默认数据源支持基于Commons 项目中的DBCP连接池 。然而,也可以使用实现任何其他连接池,通过编写自己的自定义资源工厂,描述 如下javax.sql.DataSource

1.安装JDBC驱动程序

使用JDBC数据源 JNDI资源工厂要求您为Tomcat内部类和Web应用程序提供适当的JDBC驱动程序。这很容易通过将驱动程序的JAR文件安装到 WEB-INF/lib目录中来完成,这使得驱动程序既可用于资源工厂,也可用于您的应用程序。

2.声明您的资源要求

接下来,修改Web应用程序部署描述符(/WEB-INF/web.xml)以声明JNDI名称,您将在其中查找预配置的数据源。按照惯例,所有这样的名字都应该解析为jdbc子上下文(相对于作为java:comp/env所有提供的资源工厂的根的标准命名上下文来说,典型的web.xml入口可能是这样的:

<!--官网配置内容-->

<resource-ref>
<description>
Resource reference to a factory for java.sql.Connection
instances that may be used for talking to a particular
database that is configured in the <Context>
configuration for the web application.
</description>
<res-ref-name>
jdbc/EmployeeDB
</res-ref-name>
<res-type>
javax.sql.DataSource
</res-type>
<res-auth>
Container
</res-auth>
</resource-ref> <!--下面是我自己MySQL的配置内容-->
<resource-ref>
<description>
使用DataSource为jdbc/news创建新的数据源
</description>
<res-ref-name>
jdbc/news
</res-ref-name>
<res-type>
javax.sql.DataSource
</res-type>
<res-auth>
Container
</res-auth>
</resource-ref>

警告 - 请确保您遵守DTD为Web应用程序部署描述符所需的元素排序!有关详细信息,请参阅 Servlet规范

3.编写你的应用程序使用这个资源

此资源引用的典型用法可能如下所示:

//获取Context实例
Context initCtx = new InitialContext();
Context envCtx = (Context) initCtx.lookup("java:comp/env/jdbn/news"); //java:comp/env/名后加上你自己的命名

DataSource ds = (DataSource) envCtx.lookup("jdbc/EmployeeDB"); //这样直接就可以获得了数据库连接了 
Connection conn = ds.getConnection(); ... use this connection to access the database ... conn.close();

请注意,应用程序使用在Web应用程序部署描述符中声明的相同的资源引用名称。这与<Context>Web应用程序的元素中配置的资源工厂相匹配, 如下所述。

4.配置Tomcat的资源工厂

要配置Tomcat的资源工厂,请将这样的元素添加到<Context>Web应用程序的 元素中。

<!--官网配置内容-->

<Context ...>
...
<Resource name="jdbc/EmployeeDB"
auth="Container"
type="javax.sql.DataSource"
username="dbusername"
password="dbpassword"
driverClassName="org.hsql.jdbcDriver"
url="jdbc:HypersonicSQL:database"
maxActive="8"
maxIdle="4"/>
...
</Context> <!--下面是我自己的MySQL配置内容-->
<Resource name="jdbc/news"
      auth="Container"
      type="javax.sql.DataSource"
      username="root"
      password="1992121niu"
      driverClassName="com.mysql.jdbc.Driver"
      url="jdbc:mysql://localhost:3306/news"
      maxActive="100"
      maxIdle="30"
      maxWaite="10000"/>

请注意,资源名称(此处jdbc/EmployeeDB)必须与Web应用程序部署描述符中指定的值相匹配。

此示例假定您正在使用HypersonicSQL(我使用的是MySQL数据库)数据库JDBC驱动程序。自定义driverClassName和 driverName参数以匹配您的实际数据库的JDBC驱动程序和连接URL。

Tomcat标准数据源资源工厂(org.apache.tomcat.dbcp.dbcp.BasicDataSourceFactory)的配置属性如下所示:

  • driverClassName - 要使用的JDBC驱动程序的完全限定Java类名称。

  • username - 要传递给我们的JDBC驱动程序的数据库用户名。

  • password - 数据库密码被传递给我们的JDBC驱动程序。

  • url - 要传递给我们的JDBC驱动程序的连接URL。(为了向后兼容,该属性driverName 也被认可。)

  • initialSize - 池初始化期间将在池中创建的初始连接数。默认值:0

  • maxActive - 可同时从该池中分配的最大连接数。默认:8

  • minIdle - 同时在此池中闲置的最少连接数。默认值:0

  • maxIdle - 可同时在此池中闲置的最大连接数。默认:8

  • maxWait - 池在抛出异常之前等待的最大毫秒数(当没有可用的连接时)。默认值:-1(无限)

一些额外的属性处理连接验证:

  • validationQuery - SQL查询,可以在池返回到应用程序之前用于验证连接。如果指定,这个查询必须是一个返回至少一行的SQL SELECT语句。

  • validationQueryTimeout - 验证查询返回的超时秒数。默认值:-1(无限)

  • testOnBorrow - true或false:每次从池中借用验证查询是否验证连接。默认值:true

  • testOnReturn - true或false:是否每次将连接返回到池时使用验证查询验证连接。默认:false

可选的evictor线程负责通过移除任何长时间处于空闲状态的连接来缩小池。退伍军人不尊重minIdle。请注意,如果您只希望池根据配置的maxIdle属性收缩,则不需要激活evictor线程。

evictor在默认情况下是禁用的,可以使用以下属性进行配置:

  • timeBetweenEvictionRunsMillis - 逐出器连续运行之间的毫秒数。默认值:-1(禁用)

  • numTestsPerEvictionRun - 在逐出器的每次运行期间将由检出器检查空闲的连接数。默认:3

  • minEvictableIdleTimeMillis - 以秒为单位的空闲时间,在该时间之后,可以通过逐出器从池中删除连接。默认值:30 * 60 * 1000(30分钟)

  • testWhileIdle - true或者false:连接是否应该由evictor线程在池中闲置时使用验证查询进行验证。默认:false

另一个可选功能是删除废弃的连接。如果应用程序长时间未将其返回到池,则称该连接被放弃。游泳池可以自动关闭此类连接并将其从游泳池中移除。这是泄露连接的应用程序的解决方法。

放弃功能默认是禁用的,可以使用以下属性进行配置:

  • removeAbandoned - true或false:是否从池中删除放弃的连接。默认:false

  • removeAbandonedTimeout - 假定借用连接被放弃的秒数。默认值:300

  • logAbandoned - true或false:是否为放弃语句或连接的应用程序代码记录堆栈跟踪。这增加了严重的开销。默认:false

最后有各种属性可以进一步调整池的行为:

  • defaultAutoCommit - true或false:由此池创建的连接的默认自动提交状态。默认值:true

  • defaultReadOnly - true或false:由此池创建的连接的默认只读状态。默认:false

  • defaultTransactionIsolation - 这设置默认事务隔离级别。可以是一个 NONEREAD_COMMITTED, READ_UNCOMMITTEDREPEATABLE_READSERIALIZABLE。默认:没有默认设置

  • poolPreparedStatements - true或false:是否要池PreparedStatements和CallableStatements。默认:false

  • maxOpenPreparedStatements - 可以从语句池同时分配的最大打开语句数。默认值:-1(无限制)

  • defaultCatalog - 默认目录的名称。默认:未设置

  • connectionInitSqls - 在创建连接后运行一次SQL语句。用分号(;)分隔多个语句。默认:没有语句

  • connectionProperties - 传递给驱动程序以创建连接的驱动程序特定属性的列表。每个属性都给定为name=value,多个属性用分号(;)分隔。默认值:没有属性

  • accessToUnderlyingConnectionAllowed - true或false:是否允许访问基础连接。默认:false

*Myeclipes下使用

  在myeclipes下使用可以不用配置web.xml直接将context.xml放入WebRoot的META-INF文件即可

  如图:

JDBC数据源  使用JNDI连接池实现数据库的连接