cocoon系列——开发一个简单的Web流程

cocoon系列——开发一个Web站点<!----><o:p></o:p>

 <o:p></o:p>

Cocoon 2 引入了这些数据库集成功能，但它并没有被设计成完整的 Java 应用程序服务器框架。Cocoon 2 不与基于 J2EE 体系结构的服务器竞争，因为它没有提供同等级别的资源和事务管理、负载均衡和部署选项。Cocoon 2 最适合于少量复杂业务逻辑和处理主要用于内容生成的应用程序。然而，您仍然可以和 EJB 服务器一起使用 Cocoon 2。Cocoon 2 可以轻易地充当替换表示层，而更常用的 Java Servlet 和 Java Server Pages 则要逊色得多。简而言之，Cocoon 2 旨在通过从少量的功能提供最大的灵活性来满足 80/20 规则。<o:p></o:p>

 <o:p></o:p>

一、配置DB连接

1.1、web.xml<o:p></o:p>

<init-param><o:p></o:p>

  <param-name>extra-classpath</param-name><o:p></o:p>

  <param-value>WEB-INF/extra-classes1:/ABSOLUTE-PATH-TO-ARCHIVE</param-value><o:p></o:p>

</init-param><o:p></o:p>

或者直接将jdbc驱动扔到tomcat的common\lib中<o:p></o:p>

   <init-param> <o:p></o:p>

               <param-name>load-class</param-name><o:p></o:p>

               <param-value><o:p></o:p>

                     com.mysql.jdbc.Driver<o:p></o:p>

               </param-value><o:p></o:p>

    </init-param><o:p></o:p>

1.2、cocoon.xconf中加：

<datasources><o:p></o:p>

……<o:p></o:p>

<jdbc logger="core.datasources.personnel" name="ldodds"><o:p></o:p>

      <pool-controller max="10" min="5"/><o:p></o:p>

      <dburl>jdbc:mysql://localhost:3306/new_db?autoReconnect=true</dburl><o:p></o:p>

      <user>root</user><o:p></o:p>

      <password>bibi</password><o:p></o:p>

</jdbc><o:p></o:p>

……<o:p></o:p>

</datasources><o:p></o:p>

 <o:p></o:p>

二、ESQL 逻辑表<o:p></o:p>

ESQL 逻辑表是标准 JDBC API 上较“瘦”的一层，它定义了许多映射到特定 JDBC 功能的标记。因此，逻辑表是一种为应用程序生成 JDBC 代码的简单方法。使用 ESQL 逻辑表时，必须使用许多常用结构化元素。其中每个元素都从 JDBC API 中等价的对象中派生出它的功能。在所有情况下，您都可以将 ESQL 标记同那些由 XSP 页面直接输出的用户定义标记混合在一起。您也可以使用 XSP 标记和来自其它逻辑表的标记，来定义所需的额外处理。唯一真正的限制是要确保 XSP 页面保持格式良好。<o:p></o:p>

2.1、esql:connection<o:p></o:p>

esql:connection 等价于 JDBC Connection。正如所有 JDBC 操作最终都派生自特殊的数据库连接一样，必需将每个 ESQL 元素都适当地嵌套在 esql:connection 元素内。在单个 XSP 页面内具有多个连接元素是可能的，这样就允许单个页面同多个数据源交互。连接元素还必须包含定义如何创建数据库连接的其它元素（例如，esql:pool）。<o:p></o:p>

第一种方法是简单地引用以前定义的连接池，使用 esql:pool 元素实现这一点：<o:p></o:p>

<esql:connection><o:p></o:p>

 <esql:execute-query><o:p></o:p>

 <esql:pool>myPoolName</esql:pool><o:p></o:p>

  ...<o:p></o:p>

 </esql:execute-query><o:p></o:p>

</esql:connection><o:p></o:p>

第二种方法是直接在 esql:connection 元素内定义连接参数。使用下列元素来实现这一点：<o:p></o:p>

• esql:dburl — JDBC 连接字符串 <o:p></o:p>
• esql:username — 连接到数据库的用户名 <o:p></o:p>
• esql:password — 以上用户名的密码 <o:p></o:p>
• esql:driver — JDBC 驱动程序 <o:p></o:p>
• esql:autocommit — 指出应当自动提交 JDBC 连接 <o:p></o:p>

后一种方法的优点在于可以动态生成连接详细信息 — 例如，从当前会话检索用户名和密码。虽然这样做提供了极大程度的灵活性，但是也丧失了通过使用数据库池让 Cocoon 管理连接的性能优点。<o:p></o:p>

因此，除非需要这一动态行为，否则就建议使用 esql:pool 元素定义连接。<o:p></o:p>

2.2、esql:execute-query<o:p></o:p>

esql:execute-query 元素等价于 JDBC PreparedStatement 对象。它定义如何在给定数据库连接内执行个别查询以及应该如何处理这些查询的结果。嵌套个别 esql:execute-query 元素以创建嵌套的数据库查询是可接受的。<o:p></o:p>

2.3、esql:query<o:p></o:p>

esql:query 元素含有将要使用这一连接执行的 SQL 查询（SELECT、INSERT、UPDATE 或 DELETE）。对查询结果的处理取决于执行的查询类型。对 SELECT 语句的处理定义在 esql:results 元素内，而 INSERT、UPDATE 和 DELETE 的结果则在 esql:update-results 元素内处理。<o:p></o:p>

<esql:query><o:p></o:p>

 select cat_id, name from category<o:p></o:p>

 order by cat_id<o:p></o:p>

</esql:query><o:p></o:p>

2.4、esql:row-results<o:p></o:p>

使用 esql:row-results 元素来定义如何处理查询结果中的每一行，该元素是 esql:results 的子元素。该元素的内容被转换成由查询生成的 JDBC ResultSet 中的每一行都执行的代码。<o:p></o:p>

<esql:results><o:p></o:p>

  <esql:row-results><o:p></o:p>

   <category><o:p></o:p>

    <esql:get-columns/><o:p></o:p>

   </category><o:p></o:p>

  </esql:row-results><o:p></o:p>

</esql:results><o:p></o:p>

产生下列输出：<o:p></o:p>

<categories><o:p></o:p>

  <category><o:p></o:p>

   <CAT_ID>1</CAT_ID><NAME>Blues</NAME><o:p></o:p>

  </category><o:p></o:p>

  ...more results...<o:p></o:p>

</categories><o:p></o:p>

2.5、读方法（getter） 元素

<esql:results><o:p></o:p>

  <esql:row-results><o:p></o:p>

   <category><o:p></o:p>

    ...xsp:attribute elements as before...<o:p></o:p>

   <xsp:logic><o:p></o:p>

   if (<esql:get-int column="cat_id"/> % 2 == 0)<o:p></o:p>

   {<o:p></o:p>

   <xsp:attribute name="rowtype">even</xsp:attribute><o:p></o:p>

   }<o:p></o:p>

   else<o:p></o:p>

   {<o:p></o:p>

   <xsp:attribute name="rowtype">odd</xsp:attribute><o:p></o:p>

   }<o:p></o:p>

   </xsp:logic><o:p></o:p>

  </category><o:p></o:p>

 </esql:row-results><o:p></o:p>

</esql:results><o:p></o:p>

 <o:p></o:p>

2.6、其它数据操作元素

• esql:get-column-count — 返回结果中列的数目。请在需要按顺序处理列的地方使用该元素来建立循环。 <o:p></o:p>
• esql:get-metadata — 返回对 ResultSetMetadata 的引用。 <o:p></o:p>
• esql:get-resultset — 返回对 JDBC ResultSet 的引用以供直接操作。 <o:p></o:p>
• esql:get-row-position — 获取结果中当前行的位置。请使用该元素来提供表的行数等功能。 <o:p></o:p>
• esql:get-column-name — 获取当前列的名称，必须用该列的位置来引用该列。在按顺序处理结果集中的列时，请使用该元素。 <o:p></o:p>
• esql:is-null — 测试给定列是否具有 NULL 值。 <o:p></o:p>
• esql:get-xml — 添加由 JDBC ResultSet 提供的功能。检索指定列的值并将其作为 XML 解析。在解析之前，可以有选择地将列的值封装在另一个元素（由 root 属性指定）中。在原始 XML 数据存放在数据库中时，请使用该元素。<o:p></o:p>

2.7、处理空结果和错误<o:p></o:p>

前面的这些示例假定查询总是成功完成并且总是返回结果。显然，事情并不总是这样的：有些查询可能不返回数据，也可能发生数据库错误（例如，由于连接故障）。ESQL 逻辑表提供允许您处理这些情形的标记。<o:p></o:p>

如果查询不返回结果，那么可以通过使用 esql:no-rows 元素来采取行动。<o:p></o:p>

...<o:p></o:p>

  <esql:results><results/></esql:results><o:p></o:p>

  <esql:no-results><no-results/></esql:no-results><o:p></o:p>

...<o:p></o:p>

esql:error-results 元素为处理 SQLException 提供了一个钩接（hook），该异常是在处理查询结果期间生成的。<o:p></o:p>

 <o:p></o:p>

...<o:p></o:p>

 <esql:error-results><o:p></o:p>

  <error><o:p></o:p>

   <message><esql:get-message/></message><o:p></o:p>

   <trace><esql:get-stacktrace/></trace><o:p></o:p>

   <string><esql:to-string/></string><o:p></o:p>

  </error><o:p></o:p>

 </esql:error-results><o:p></o:p>

...<o:p></o:p>

将处理结果时发生的异常情形同创建数据库连接或查询包含语法错误时发生的异常情形区分开来非常重要。这些更严重的错误并不传递给 XSP 页面，而是由 Cocoon 2 自身处理。<o:p></o:p>

2.8、将参数传递给查询

<esql:query><o:p></o:p>

select * from album<o:p></o:p>

where cat_id = <xsp-request:get-parameter name="id"/><o:p></o:p>

</esql:query><o:p></o:p>

 <o:p></o:p>

2.9、嵌套查询

<esql:connection><o:p></o:p>

 <esql:execute-query><o:p></o:p>

   <esql:query/><o:p></o:p>

   <esql:results><o:p></o:p>

   <!-- results from query<o:p></o:p>

   one --><o:p></o:p>

    <esql:execute-query><o:p></o:p>

     <esql:query/><o:p></o:p>

     <esql:results><o:p></o:p>

     <!-- results from query<o:p></o:p>

     two --><o:p></o:p>

     </esql:results><o:p></o:p>

    </esql:execute-query><o:p></o:p>

   </esql:results><o:p></o:p>

 </esql:execute-query><o:p></o:p>

</esql:connection><o:p></o:p>

内部查询引入了一段新 ESQL 语法：<o:p></o:p>

 <o:p></o:p>

<esql:query><o:p></o:p>

 select alb_id as id, title, artist,<o:p></o:p>

 num_tracks as tracks<o:p></o:p>

 from album<o:p></o:p>

 where cat_id = <esql:get-int column="cat_id" ancestor="1"/><o:p></o:p>

</esql:query><o:p></o:p>

 <o:p></o:p>

在查询的 WHERE 子句中，esql:get-int 元素用于检索外部查询的当前类别值。新的 ancestor 元素指示从哪个外面查询检索该值 — 例如同第一个 esql:execute-query ancestor 元素相关联的结果。<o:p></o:p>

 <o:p></o:p>

2.10、分组数据

esql:group 和 esql:member 元素可以利用表连接结果中的这些模式来将相关记录整理在一起。esql:group 元素具有 group-on 属性。该属性标识结果中可以用来区别外部元素（换句话就是类别）的列。元素的内容定义将对每个不同类别采用的处理，而不是定义对结果的每一行的处理。esql:member 元素定义对共享由 group-on 属性定义的公共列的每一行的处理。这里，该元素含有建立每个专辑的 XML 结构所需的处理，最终的 XML 结构与嵌套查询版本生成的结构相同。<o:p></o:p>

<esql:row-results><o:p></o:p>

 <esql:group group-on="cat_id"><o:p></o:p>

   <category><o:p></o:p>

   <!-- process category data --><o:p></o:p>

   <albums><o:p></o:p>

    <esql:member><o:p></o:p>

     <album><o:p></o:p>

     <!-- process album data --><o:p></o:p>

     <id><esql:get-string column="alb_id"/></id><o:p></o:p>

     </album><o:p></o:p>

    </esql:member><o:p></o:p>

   </albums><o:p></o:p>

  </category><o:p></o:p>

 </esql:group><o:p></o:p>

</esql:row-results><o:p></o:p>

 <o:p></o:p>

三、表单验证

3.1描述表单

下面的示例演示了用于描述表单字段、由 Form Validator Action 所支持的 XML 格式的基本语法。<o:p></o:p>

<root><o:p></o:p>

<!-- field definitions --><o:p></o:p>

<parameter name="id" type="long" <o:p></o:p>

 min="1" max="99999" nullable="no"/><o:p></o:p>

<parameter name="cat" type="long" <o:p></o:p>

 min="1" max="999" nullable="no"/><o:p></o:p>

<parameter name="title" type="string" <o:p></o:p>

 max-len="100" nullable="no"/><o:p></o:p>

<parameter name="artist" type="string" <o:p></o:p>

 max-len="100" nullable="no"/><o:p></o:p>

<parameter name="tracks" type="long" <o:p></o:p>

 max="99" nullable="no"/><o:p></o:p>

 <o:p></o:p>

<constraint-set <o:p></o:p>

 name="insert-album"><o:p></o:p>

<validate name="id"/><o:p></o:p>

<validate name="cat"/><o:p></o:p>

<validate name="title"/><o:p></o:p>

<validate name="artist"/><o:p></o:p>