cocoon系列——开发一个Web站点

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

一、配置DB连接

1.1、web.xml

<init-param>

  <param-name>extra-classpath</param-name>

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

</init-param>

或者直接将jdbc驱动扔到tomcat的common\lib中

   <init-param>

               <param-name>load-class</param-name>

               <param-value>

                     com.mysql.jdbc.Driver

               </param-value>

    </init-param>

1.2、cocoon.xconf中加：

<datasources>

……

<jdbc logger="core.datasources.personnel" name="ldodds">

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

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

      <user>root</user>

      <password>bibi</password>

</jdbc>

……

</datasources>

二、ESQL 逻辑表

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

2.1、esql:connection

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

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

<esql:connection>

 <esql:execute-query>

 <esql:pool>myPoolName</esql:pool>

  ...

 </esql:execute-query>

</esql:connection>

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

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

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

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

2.2、esql:execute-query

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

2.3、esql:query

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

<esql:query>

 select cat_id, name from category

 order by cat_id

</esql:query>

2.4、esql:row-results

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

<esql:results>

  <esql:row-results>

   <category>

    <esql:get-columns/>

   </category>

  </esql:row-results>

</esql:results>

产生下列输出：

<categories>

  <category>

   <CAT_ID>1</CAT_ID><NAME>Blues</NAME>

  </category>

  ...more results...

</categories>

2.5、读方法（getter） 元素

<esql:results>

  <esql:row-results>

   <category>

    ...xsp:attribute elements as before...

   <xsp:logic>

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

   {

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

   }

   else

   {

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

   }

   </xsp:logic>

  </category>

 </esql:row-results>

</esql:results>

2.6、其它数据操作元素

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

2.7、处理空结果和错误

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

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

...

  <esql:results><results/></esql:results>

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

...

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

...

 <esql:error-results>

  <error>

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

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

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

  </error>

 </esql:error-results>

...

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

2.8、将参数传递给查询

<esql:query>

select * from album

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

</esql:query>

2.9、嵌套查询

<esql:connection>

 <esql:execute-query>

   <esql:query/>

   <esql:results>

   <!-- results from query

   one -->

    <esql:execute-query>

     <esql:query/>

     <esql:results>

     <!-- results from query

     two -->

     </esql:results>

    </esql:execute-query>

   </esql:results>

 </esql:execute-query>

</esql:connection>

内部查询引入了一段新 ESQL 语法：

<esql:query>

 select alb_id as id, title, artist,

 num_tracks as tracks

 from album

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

</esql:query>

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

2.10、分组数据

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

<esql:row-results>

 <esql:group group-on="cat_id">

   <category>

   <!-- process category data -->

   <albums>

    <esql:member>

     <album>

     <!-- process album data -->

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

     </album>

    </esql:member>

   </albums>

  </category>

 </esql:group>

</esql:row-results>

三、表单验证

3.1描述表单

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

<root>

<!-- field definitions -->

<parameter name="id" type="long" 

 min="1" max="99999" nullable="no"/>

<parameter name="cat" type="long" 

 min="1" max="999" nullable="no"/>

<parameter name="title" type="string" 

 max-len="100" nullable="no"/>

<parameter name="artist" type="string" 

 max-len="100" nullable="no"/>

<parameter name="tracks" type="long" 

 max="99" nullable="no"/>

<constraint-set 

 name="insert-album">

<validate name="id"/>

<validate name="cat"/>

<validate name="title"/>

<validate name="artist"/>

<validate name="tracks"/>

</constraint-set>

</root>

说明：首先，忽略了文档的根元素，因此它可以具有任何名称。第二，文档被分成了两部分：许多字段定义后跟约束集。

每个字段定义都描述了用户提交的参数。参数都必须有唯一的 name 属性。字段还必须有类型，类型可以是下列之一：long、double 或 string。每个字段接下来可以定义许多指定为附加属性的验证规则：

• nullable — 标识字段是否可为空
• default — 如果没有为字段提供值，则标识字段的缺省值
• min 和 max — 表示最小和最大值
• min-len 和 max-len — 表示最小和最大长度
• matches-regex — 定义一个必须正确匹配参数值的 POSIX 正则表达式；这允许更丰富的内容验证，例如电子邮件地址格式

约束集描述了预定义字段的组合，对这些字段进行验证将一遍完成，如下面所描述。约束集中的 validate 元素支持两种附加属性：

• equals-to — 定义参数必须匹配的固定字符串
• equals-to-param — 定义另一个应该具有相同值的参数的名称，该参数可以完成一些功能，例如检查用户是否在一个验证新密码的表单上两次都输入了相同的密码。

3.2、验证字段

3.2.1站点地图中对它加以声明

同任何其它 Cocoon 2 组件一样，在可以使用 Form Validator Action 以前，必须首先在站点地图中对它加以声明：

<map:components>

...

<map:actions>

<map:action name="form-validator"

src="org.apache.cocoon.acting.FormValidatorAction"/>

</map:actions>

...

</map:components>

3.2.2向 Cocoon 2 管道添加操作

<map:match pattern="form/insert-album">

<map:act type="form-validator">

<map:parameter name="descriptor"

value="context://insert-album.xml"/>

<map:parameter name="validate-set"

value="insert-album"/>

<!-- if success -->

...

</map:act>

<!-- if fail -->

...

</map:match>

如果验证成功，则处理 map:act 元素内的其它管道组件。就是在这里调用 insert-album.xsp，XSP 页面以插入已知有效的数据。

如果验证不成功，则只执行 map:act 元素后面的组件。这样，Actions 的行为类似于“if”语句：如果它们成功地执行了它们的处理，那么将执行嵌套在它们之内的管道组件块；否则，就跳过该块。

3.2.3、使用 Form Validator 逻辑表

您只可以将 Form Validator 逻辑表同 Form Validator Action 一起使用。该逻辑表通常在 XSP 页面内使用，如果表单未能被验证，就执行该页面。操作将其结果的详细分解作为 HTTP 请求参数存储。这一逻辑表为解释这些结果提供了一个简单的基于标记的 API。

这一逻辑表的名称空间是 http://apache.org/xsp/form-validator/2.0。

下列来自逻辑表的每一元素都接受 name 属性，该属性表示正在测试验证状态的字段的名称。

• formval:is-ok — 返回一个指示字段验证是否成功的布尔值
• formval:is-null — 在字段本不该为空时表示该字段为空
• formval:is-toosmall — 表示字段长度比 min-len 短或值比 min 小
• formval:is-toolarge — 表示字段长度比 max-len 长或值比 max 大
• formval:is-nomatch — 表示字段未能匹配所配置的正则表达式

Q : org.apache.avalon.framework.configuration.ConfigurationException: No default  type exists for 'pipeline' at file:/C:/code/tech/web/sitemap.xmap………

A: The samples sitemaps are sub sitemaps and inherit the pipelines  configuration form the root sitemap. Their you will find a map:pipes  with a default type configured.

Q: Caused by: org.xml.sax.SAXParseException: The reference to entity "password" must end with the ';' delimiter.

A: “ jdbc:mysql://192.168.0.1:3306/school?useUnicode=true&characterEncoding=GB2312 “ 中的"&"必须用它的转义字符&amp;

Q: Communication  failure  during  handshake.  Is  there  a  server  running  on  localhost:3306?  

A: 尝试下一个新版本的驱动:http://dev.mysql.com/downloads/  
Class.forName("org.gjt.mm.mysql.Driver")  可以尝试换成  
Class.forName("com.mysql.jdbc.Driver")

PS: 晕菜，被这个问题搞了两个小时。在这之前mysql和jdbc连接一直是可以用的，不过前几天升级了一下mysql，但版本差别不大，版本号前面都有一个5。另外因为是第一次在cocoon配置，以为是配置文件搞错了，就在那里瞎折腾。到最后，才决定要看看究竟是不是mysql的JDBC驱动版本引起的，就写了一个简单的JSP测试页，结果竟然连接不成功，出现如上提示