對 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 出的產品，信賴度還是值得相信的。