Jakarta Tomcat5.0+Apache Cocoon2.1.3开发初步指南一--安装篇
Author：Junnef Jin
Date： 2003/11/25
E_mail：junnef21@sohu.com
最近在学XML，而说起XML在java中的实际应用，就不能不提到COCOON，在国外已经有了很多使用COCOON1做得网站，而且非常成功。COCOON之于XML就象STRUTS之于JSP一样，随着XML的流行，并将也会成为热门的开发框架。不过国内基于COCOON的中文资料相当的少，所以在学习中也遇到了不少困难，特别是在开始的时候。这里是我的一些经验，写出来，希望对大家能够有所帮助，能有更多的人来共同学习应用COCOON。
开发环境， win2000；开发工具，任意文本编辑器，这里用XMLSpy 2004专业版+EditPlus2.11。
开发前的准备工作：
1、 下载Aapache Cocoon2.1.3的安装文件
下载网址：http://cocoon.apache.org/mirror.cgi，这里我们下载source包，就是名称中带有src标志的那个包，自己编译产生部署文件。
2、下载Jakarta Tomcat5.0的安装文件
下载网址：http://jakarta.apache.org/site/binindex.cgi，当前用的是5.0版本，使用5.1.4版本也没有太大的差别，不会影响下面的过程。
3、下载jsdk1.4.2版本
下载网址：http://java.sun.com/downloads/，也可以下载最新的版本，只要你的机器上编译和运行时环境(jre)都是一个jsdk版本的就行了。
在tomcat下配置cocoon2：
4、 安装jsdk1.4.2
这里我们安装至c:\j2sdk目录下，并设置环境变量JAVA_HOME=c:\j2sdk，在CLASSPATH中加入c:\j2sdk\tool.jar，在PATH中加入c:\j2sdk\bin。
5、 安装Jakarta Tomcat5.0
这里我们安装至c:\tomcat50目录下，并设置环境变量CATALINA_HOME=c:\tomcat50。
6、 装Apache Cocoon
将Apache Cocoon2.1.3的压缩包，解压到c:\下，重命名为cocoon，我们这里假定COCOON2_HOME=c:\cocoon。
7、 建Apache Cocoon 2 的web服务包（以前版本生成的cocoon.war包）
打开命令行窗口，进入COCOON2_HOME目录，运行如下命令：
build.bat –Dinclude.webapp.libs=yes webapp
注：此处可能会出现错误，可能会说找不到某些包，这时你可以把他们设置进classpath中试一试，如果缺少某些包，你又找不到可以去google搜一下，到相应的网站下载。
最后将出现：
BUILD SUCCESSFUL
Total time: 6 minutes 22 seconds
表示编译成功。在COCOON2_HOME\build\cocoon-2.1.3目录下可以找到cocoon.jar和另外两个jar文件，cocoon.jar中封装了cocoon2的基本库文件。
此时，我们会找不到cocoon.war包，而在COCOON2_HOME\build\文件夹下有一个文件夹webapp，这个文件夹中所放的就是以前cocoon.war包中的所有文件。确保tomcat服务关闭，将webapp文件夹拷贝至CATALINA_HOME\webapps下，并重命名为cocoon，启动tomcat服务器。
8、 测试服务是否可以运行
打开IE浏览器，并输入http://localhost:8080/cocoon/，第一次运行将会比较慢，因为tomcat需要对一些文件进行处理，以后会比较快。
如果可以正常运行，则显示如下页面：
看到上面的画面表示安装成功，我们可以点击sample链接，学习cocoon给我们提供的一些例程，可以给我们一个很直观的印象，对cocoon的强大功能也可以有一个初步的认识，那个hello world例程特别值得研究，那个例程是一个用cocoon开发很典型的开发架构模式。
注：这是可能有版本冲突，特别是直接装cocoon.war包时，如你以前装有的例如xalan等的版本与当前版本不同等等，，这时就要卸载以前的版本；如果你下载的是二进制的包，就是已经有了cocoon.war包，不是你当前编译的，如果你当前的jsdk与发行编译时的jdk版本不同，可能你在后面部署这个包后，也不能正常运行，所以强烈建议下载source版本，用当前机器所配置的jdk编译。
如果你可以看到页面，在如下的地址，你可以看到Cocoon所用到的工具包列表：http://localhost:8080/cocoon/docs/installing/jars.html
未完待续。
