对 Cocoon 的认识和初步理解(飞刀和雨)：

 

目标 ，了解 cocoon 的框架结构，验证其功能及作用。是否符合手机平台的运作，具有的优势及其不足。

 

Cocoon 的基础知识 ，（网上资料） cocoon 是一个 XML 发布的框架，它允许你定义 xml 文档和文档的转化，并最终生成你所选择的表示形式， 例如 html, pdf, svg 等等。

XSP 是 Cocoon 的实现方式， XSP 引擎产生的 XML 文档可以适应于各种变化的状况。另外最重要的是可以实现 静态内容， 表现形式，程序逻辑 的清晰分离 。而且， XSP 是 java 和 XML 结合的框架。

 

步骤 对于 Cocoon 的安装，感觉并不像其他开源的软件那么省事，首先要从 Jakatar 网页上下载 src 码，建议在下载源码之前先看下 doc. 我是在拿到 src 后居然找不到 doc 里提到的 helloworld, 用 ant 进行编译后才看到里面有个 samples 目录。把 webapp 目录倒入自己建的项目中，这里我起的项目名字叫 cocoon. 经过 jsp-server 的自动编译，生成代码后在 url 里打入　 http://localhost:8080/cocoon/samples/ 　可以看到 cocoon 自带的例子。

 

对于 java 的版本， cocoon 在文档里提到，最好使用１ .4 的，对于１ . ５以上的 , 　 apache 只是用了个可能有争议来敷衍了一下我们，所以在开发的时候，应当建议使用 1.4JDK ，以免碰到无法解释的问题。而且，用下来，我觉得文档不是很完整，我这边 CocoonInAction 只能看到前几页，后面的就打不开了，不知道是不是本来就是这样的。

 

对于 cocoon 里的例子，看上去非常的简单

但重起后会出现以下的问题：特别的怪异

Message: The repository home at

F:\eclipse-SDK-3.1.1-win32\eclipse\workspace\cocoon\samples\blocks\jcr\repotest appears to be in use. If you are sure it's not in use please delete the file at

F:\eclipse-SDK-3.1.1-win32\eclipse\workspace\cocoon\samples\blocks\jcr\repotest\.lock. Probably the repository was not shutdown properly.

Description: org.apache.avalon.framework.configuration.ConfigurationException: Cannot access configuration information at jndi:/localhost/cocoon/WEB-INF/cocoon.xconf:2150:106

Sender: org.apache.cocoon.servlet.CocoonServlet

Source: Cocoon Servlet

这里得去查下，为何有这样的问题出现。（估计是这个 0 字节的 lock 文件用来锁定用户的操作，每次必删）

 

 

在对 Cocoon 进行调试的时候，要注意有些类包并没有带上 source code, 所以想要调试源代码的兄弟们只能边猜边调拉 .^-^ 这些文件包为： components, ojb, faces, forums.

 

下面让我们对 cocoon 的功能进行验证一下。

1.       Cocoon 自带的例子： Samples/hello-world

简单的形式在 Samples.xml 中体现

<samples name="Hello, World!">

  <group name="About">

   <note>All examples on this page have been created using a single data source, hello.xml file.

   </note>

   <sample name="XML" href="hello.xml">

    Hello world XML document.

   </sample>

  </group>

</samples>

通过这样标准的 xml 文件，最终解析成需要的输出 html,  注意到上面的一个链接，试着打开下 hello.xml, 更简单的结构，

<page>

 <title>Hello</title>

 <content>

  <para>This is my first Cocoon page!</para>

 </content>

</page>

从输出可以看出这是标准的页面格式

也同时证明了 Cocoon 可以支持多种格式的内容。比如， xml, html,xhtml,wml,chtml 等等。

 

2 ．下面开始一个独立的项目。就以 hello 为例。

首先新建一个 web 项目 , 并建一个文件 hello.xsp.

<?xml version="1.0" encoding="iso-8859-1"?>

<?cocoon-process type="xsp"?>

    <xsp:page language="java" xmlns:xsp="http://apache.org/xsp">

       <xsp:logic>

       String Hello="Hello,Cocoon!";

       </xsp:logic>

       <page>

           <xsp:expr>Hello</xsp:expr>

       </page>

</xsp:page>

然后建一个转换文件在 hello.xsl

<? xml version = " 1.0 " encoding = "iso-8859-1" ?>

< xsl : stylesheet version = " 1.0 " xmlns : xsl = " http : // www.w3.org /1999/XSL/transform " >

< xsl : template match = " / " >

< html >

    < body bgcolor = "#ffcccc" >

       < p allign = "center" >< br />< br />< b >

       < font size = "5" color = "navy" >

           < xsl : value-of select = " page " />

       </ font ></ b ></ p >

    </ body >

</ html >

</ xsl : template >

</ xsl : stylesheet >

当然这些还是不够的，于是，补上一个 map 文件， hello.xmap 主要就是定义一下源码的位置和引用的位子。这个 xmap 的作用非常重要，这是整个项目中连接 pipline 的数据都定义在这个文件里，

因为在配置   cocoon 上遇到了点障碍，耽搁了一段时间，可能这些也是些刚接触的人会碰到的问题，因此这里把这些都做些详细的介绍下。

Web.xml 里有必须带如下的设置：

 

<web-app>

  <servlet>

    <servlet-name>Cocoon</servlet-name>

    <display-name>Cocoon</display-name>

    <servlet-class>org.apache.cocoon.servlet.CocoonServlet</servlet-class>

    <init-param>

      <param-name>init-classloader</param-name>

      <param-value>false</param-value>

    </init-param>

    <init-param>

      <param-name>force-property</param-name>

      <param-value>        org.apache.commons.logging.Log=org.apache.commons.logging.impl.LogKitLogger

     </param-value>

    </init-param>

    <init-param>

      <param-name>configurations</param-name>

      <param-value>/WEB-INF/cocoon.xconf</param-value>

    </init-param>

    <init-param>

      <param-name>logkit-config</param-name>

      <param-value>/WEB-INF/logkit.xconf</param-value>

    </init-param>

    <init-param>

      <param-name>servlet-logger</param-name>

      <param-value>access</param-value>

    </init-param>

    <init-param>

      <param-name>cocoon-logger</param-name>

      <param-value>core</param-value>

    </init-param>

    <init-param>

      <param-name>log-level</param-name>

      <param-value>WARN</param-value>

    </init-param>

    <init-param>

      <param-name>forbidden-deprecation-level</param-name>

      <param-value>ERROR</param-value>

    </init-param>

    <init-param>

      <param-name>allow-reload</param-name>

      <param-value>no</param-value>

    </init-param>

    <init-param>

      <param-name>enable-uploads</param-name>

      <param-value>true</param-value>

    </init-param>

    <init-param>

      <param-name>overwrite-uploads</param-name>

      <param-value>rename</param-value>

    </init-param>

    <init-param>

      <param-name>manage-exceptions</param-name>

      <param-value>true</param-value>

    </init-param>

    <init-param>

      <param-name>enable-instrumentation</param-name>

      <param-value>false</param-value>

    </init-param>

    <init-param>

      <param-name>instrumentation-config</param-name>

      <param-value>/WEB-INF/instrumentation.xconf</param-value>

    </init-param>

    <init-param>

      <param-name>container-encoding</param-name>

      <param-value>ISO-8859-1</param-value>

    </init-param>

    <init-param>

      <param-name>form-encoding</param-name>

      <param-value>ISO-8859-1</param-value>

    </init-param>

    <load-on-startup>1</load-on-startup>

  </servlet>

    <servlet>

        <servlet-name>webdav</servlet-name>

        <display-name>Slide DAV Server</display-name>

         <servlet-name>Xindice</servlet-name>

    <display-name>Xindice XML-RPC Server</display-name>

 <servlet-class>org.apache.xindice.server.XindiceServlet</servlet-class>

    <init-param>

      <param-name>xindice.configuration</param-name>

      <param-value>WEB-INF/xindice.xml</param-value>

    </init-param>

    <load-on-startup>1</load-on-startup>

  </servlet>

  <servlet-mapping>

    <servlet-name>Cocoon</servlet-name>

    <url-pattern>/</url-pattern>

  </servlet-mapping>

  <servlet-mapping>

    <servlet-name>Cocoon</servlet-name>

    <url-pattern>*.jsp</url-pattern>

  </servlet-mapping>

  <servlet-mapping>

    <servlet-name>Cocoon</servlet-name>

    <url-pattern>*.html</url-pattern>

  </servlet-mapping>

  <mime-mapping>

    <extension>css</extension>

    <mime-type>text/css</mime-type>

  </mime-mapping>

  <mime-mapping>

    <extension>xml</extension>

    <mime-type>text/xml</mime-type>

  </mime-mapping>

  <mime-mapping>

    <extension>xsl</extension>

    <mime-type>text/xml</mime-type>

  </mime-mapping>

  <mime-mapping>

    <extension>xconf</extension>

    <mime-type>text/xml</mime-type>

  </mime-mapping>

  <mime-mapping>

    <extension>xmap</extension>

    <mime-type>text/xml</mime-type>

  </mime-mapping>

  <mime-mapping>

    <extension>ent</extension>

    <mime-type>text/plain</mime-type>

  </mime-mapping>

  <mime-mapping>

    <extension>grm</extension>

    <mime-type>text/plain</mime-type>

  </mime-mapping>

</ web-app >

 

这些都是 web.xml 里面配置 cocoon 参数所必需的。参考 lenya 后发现其 web.xml ，及其相关的 xconf 文件都是原版照用 cocoon ，因此在改造其功能用于手机平台，大可直接使用其上述列出的参数。这样不容易出现奇怪的问题。

 

2 对于 xmap 文件的编写，即 xsp 的语法。对于一个熟悉 jsp 的程序员来说，应该不是一个很困难的问题，具体如下。

<xsp:page>  XSP 文档的根元素

<xsp:expr>  类似于 <%= ... %> 表达式语法

<xsp:logic>  类似于 <% ... %> 表达式语法

<xsp:include> 类似于 <%@page include ... %> 表达式语法

<xsp:structure> 把许多 include 联系在一起

<xsp:element> 生成动态元素

<xsp:attribute> 生成动态属性

<xsp:comment> 注释 <!-- ...-->

<xsp:pi> 创建处理创建动态元素或属性

因此 xsp 相对不会那么复杂，但是对于其上面那么多参数配置，弄清楚每一个参数的作用，到的确是很费力的一件事情。

 

总的来说， cocoon 提供了一个多展现层的工具，这对于我们来说，是个很好的东西，对于 wap ， jsp 的共存的设备， cocoon 可以方便的实现一套程序，多个转换。但其弱点在于参考资料不多，不详细，碰到问题常常无法查到问题所在，但对于开源软件的龙头 apache 出的产品，信赖度还是值得相信的。