Struts HOW-TO 系列 之数据库访问

　　访问一个数据库
　　在一个其于Struts的应用系统的设计过程中，最好能在web/表示层（presentation layer）和你的商务逻辑类（包含所有数据访问操作的层）的中间，定义一个Action类，作为小型的适配器（thin adapter）。
　　
　　所以，你可以先定义一些商务API（business API），这些API就是简单的Java类。你可以传递一些参数给这些对象，并从这些对象返回一个Java Bean或者Java Bean的集合。这个Action类负责调用这些对象，并把它们返回的值传递给web/表示层。
　　
　　通常，你可以为每一个你需要调用的商务方法/商务类API创建一个Action类。理想情况下，所有的数据库访问代码都被封装进了这些商务API类里，所以Struts并不知道你正在使用的持久层（persistent layer）（甚至都不知道你使用了持久层）。它只需要传递一个主键（Key）或者一个查询参数，然后处理返回的结果bean或者bean集合。这样，你就可以在其他的应用环境里复用这些商务API类，你还可以对这些独立于Struts或HTTP环境的商务API进行单体测试。
　　
　　开始的时候，最简单的方法就是设计一个1:1的方案，为你的每一个商务API入口（entry-point）定义一个Action类。当你的经验丰富了以后，你也可以使用DispatchAction组合这些Action类。你甚至可以定义一个简单的"框架"Action，用来调用所有的这些商务类。你可以在contrib目录里找到Scaffold设计的ProcessAction，这是一个"框架"Action的完整实现。使用这种方案可以使用更少的Action类，但你必须对Struts和MVC框架的底层实现有较深的理解。不要害怕在开始的时候定义过多的Action，Struts的配置方案可以给予你充分的自由在以后重构你的设计，因为你可以灵活的改变你的Action类，而不会对应用程序造成影响。
　　
　　在理想情况下，商务逻辑层（business logic layer）应该封装所有的数据访问细节，包括数据库连接的获得。但是，一些应用程序的设计要求调用者可以从一个DataSource对象来获得数据库连接。遇到这种情况时，Struts DataSource管理器可以使你在需要的时候配置这些DataSource资源。
　　
　　Struts DataSource管理器在Struts配置文件（Struts-config.xml）里定义。这个管理器可以用来分发和配置任何实现了javax.sql.DataSource接口的数据库连接池（connection pool）。如果你的DBMS或者容器内置了符合这些要求的连接池，你可以优先选用它。
　　
　　Jakarta的公共连接池实现 - BasicDataSource
　　如果你的手头没有连接池的本地（native）实现，你可以使用Jakarta提供的公共连接池实现[org.apache.commons.dbcp.BasicDataSource]，它可以和DataSource管理器"合作"的很好。另外，Struts还在它的util包里包含了一个GenericDataSource类，这也是一个连接池实现。但是这只是一个非常简单的实现方案，不推荐使用，因为它可能在Struts的以后版本中被BasicDataSource或其它的数据源实现替换掉。
　　
　　下面是一段Struts-config.xml配置文件中的数据源配置（使用GenericDataSource数据源实现），你可以更改相应的设置以适合你自己的系统。
　　
　　<!-- configuration for GenericDataSource wrapper -->
　　<data-sources>
　　<data-source>
　　<set-property
　　property="autoCommit"
　　value="false"/>
　　<set-property
　　property="description"
　　value="Example Data Source Configuration"/>
　　<set-property
　　property="driverClass"
　　value="org.postgresql.Driver"/>
　　<set-property
　　property="maxCount"
　　value="4"/>
　　<set-property
　　property="minCount"
　　value="2"/>
　　<set-property
　　property="password"
　　value="mypassword"/>
　　<set-property
　　property="url"
　　value="jdbc:postgresql://localhost/mydatabase"/>
　　<set-property
　　property="user"
　　value="myusername"/>
　　</data-source>
　　</data-sources>
　　
　　使用BasicDataSource数据源实现的配置方案如下：
　　<data-sources>
　　<!-- configuration for commons BasicDataSource -->
　　<data-source type="org.apache.commons.dbcp.BasicDataSource">
　　<set-property
　　property="driverClassName"
　　value="org.postgresql.Driver" />
　　<set-property
　　property="url"
　　value="jdbc:postgresql://localhost/mydatabase" />
　　<set-property
　　property="username"
　　value="me" />
　　<set-property
　　property="password"
　　value="test" />
　　<set-property
　　property="maxActive"
　　value="10" />
　　<set-property
　　property="maxWait"
　　value="5000" />
　　<set-property
　　property="defaultAutoCommit"
　　value="false" />
　　<set-property
　　property="defaultReadOnly"
　　value="false" />
　　<set-property
　　property="validationQuery"
　　value="SELECT COUNT(*) FROM market" />
　　</data-source>
　　</data-sources>
　　
　　注意，你可以在你的应用系统中定义不止一个数据源，你可以根据需要定义多个数据源，并为它们分别起一个逻辑名（logical name）。这样做可以给你的应用系统提供更好的安全性和可测量性（scalability），你还可以定义一个专用于测试的数据源。
　　
　　配置好DataSource以后，你就可以在你的应用系统中使用这些数据源了。下面这段代码演示了怎样在Action类的execute方法中通过这些数据源来生成数据库连接。
　　
　　public ActionForward execute(
　　ActionMapping mapping,
　　ActionForm form,
　　HttpServletRequest request,
　　HttpServletResponse response)
　　throws Exception
　　{
　　DataSource dataSource;
　　Connection cnn;
　　
　　try
　　{
　　dataSource = getDataSource(request);
　　cnn = dataSource.getConnection();
　　// 数据连接已经建立了，你可以做你想做的事情了
　　}
　　catch (SQLException e)
　　{
　　getServlet().log("处理数据库连接", e);
　　}
　　finally
　　{
　　// 在finally块里包含这些代码
　　// 用以保证连接最后会被关闭
　　try
　　{
　　cnn.close();
　　}
　　catch (SQLException e)
　　{
　　getServlet().log("关闭数据库连接", e);
　　}
　　}
　　}
　　
　　注意：如果你使用公共的BasicDataSource，你提供给pingQuery属性的查询语句（如果你设置了话）必须至少要能返回一行记录。
　　
　　例子：SELECT COUNT(*) FROM VALIDTABLE
　　
　　你可以把VALIDTABLE替换成你的数据库中包含的任何有效的表。
　　
　　使用多个数据源
　　如果你需要在模块（Module）中使用多于一个的数据源，你可以在配置文件的<data-source>元素里包含一个key属性。
　　
　　<data-source>
　　<data-source key="A" type="org.apache.commons.dbcp.BasicDataSource">
　　…属性配置略, 同上…
　　</data-source>
　　<data-source key="B" type="org.apache.commons.dbcp.BasicDataSource">
　　…属性配置略, 同上…
　　</data-source>
　　</data-source>
　　
　　你代码里，你可以通过这些key获得不同的数据源。代码如下：
　　
　　…
　　try
　　{
　　dataSourceA = getDataSource(request, "A");
　　dataSourceB = getDataSource(request, "B");
　　…
　　
　　你可以根据需要为每一个模块设置多个数据源。但同一模块里每个数据源的key属性必须唯一，因为Struts模块系统是以每一个模块为单位管理命名空间的。