Jetspeed调试环境搭建及学习指引

APS基于Jetspeed 2.2.0改造而来。欲更好的改造，首先得了解Jetspeed的功能、架构设计和代码。由于Jetspeed的代码比较分散，因此本文特地理出了Jetspeed的相关学习资料和学习方向、学习思路。

Jetspeed学习方向和思路
1）安装Jetspeed。
下载的Jetspeed的最新版本为2.2.1，相比2.2.0有了较大的变化，我们推荐下载2.2.0，下载地址为： http://labs.renren.com/apache-mirror/portals/jetspeed-2/binaries/

2）学习Jetspeed的用户手册、管理手册、部署手册、开发手册
管理手册 http://portals.apache.org/jetspeed-2/adminguide/index.html
用户手册 http://portals.apache.org/jetspeed-2/devguide/usersguide/index.html

3)下载Jetspeed的源码并进行调试，通过调试了解Jetspeed的架构和源码。
3.1)Jetspeed的源码包下载地址： http://apache.etoak.com//portals/jetspeed-2/sources/

3.2)简单介绍一下如何调试：

由于Jetspeed安装后的包实际上是定制过的tomcat服务器，所以首先将jetspeed以debug模式启动。
接着jetspeed的源码包是一个maven工程，通过 "mvn eclipse:eclipse"将其变成eclipse工程后导入到eclipse中。
使用eclipse的远程调试功能连接上jetspeed的服务器，然后就可以使用调试功能了。

set JPDA_ADDRESS=8000
set JPDA_TRANSPORT=dt_socket
set JPDA_SUSPEND=y  
catalina.bat jpda start

然后在Eclipse Debug配置下的Remote Java Application 下配置IP：Port & Project 即可。

或者把 startup.bat 文件中的 call "%EXECUTABLE%" start %CMD_LINE_ARGS% 修改为：

set JPDA_TRANSPORT=dt_socket
set JPDA_ADDRESS=8000
set JPDA_SUSPEND=y 

call "%EXECUTABLE%" jpda start %CMD_LINE_ARGS%

然后双击 startup.bat 即可监听连接。


3.2）中的具体操作步骤将在另外文章中解释【待完成】。这里的代码调试是指为了方便走查代码，了解jetspeed原有的设计思路和实现等。你需要配合jetspeed的文档结合代码一起学习。更多的Jetspeed相关的设计文档在下一章说明。

4)Jetspeed原来的内容聚合机制，主要讲到了同步和异步两种渲染Portlet的方式。 http://portals.apache.org/jetspeed-2/guides/guide-aggregation.html
【未完待续】




Jetspeed的安装：

首先配置ant。将apache-ant-1.7.0-bin解压到某个路径,假设为D:\apache-ant-1.7.0 。然后配置系统变量，有三处：
JAVA_HOME, 值为所安装JDK的文件夹路径，如本机的设置：
JAVA_HOME = C:\Program Files\Java\jdk1.5.0_02
ANT_HOME, 就是ant所在文件夹路径，如：
ANT_HOME = D:\apache-ant-1.7.0
其次将maven-2.0.5-bin解压到某个路径,假设为D:\maven-2.0.5 。
再来配置系统变量：
PATH, 在此变量上添加ant的bin文件夹路径：
PATH = %PATH%;D:\apache-ant-1.7.0\bin;D:\maven-2.0.5\bin;

4、测试
在命令提示符下输入：
C：\〉 ant
输出 Buildfile:build.xml does not exist!
Build failed
表示配置成功！
C: \〉mvn --version
输出 Maven version： 2.0.5
成功！
5、完成上面两步后，可以正式开始安装Jetspeed了。
一般来说，jar文件默认是用rar打开的，所以，最方便的办法是进入命令行模式：
d:\downloads\〉java -jar Jetspeed-2.1-demo-installer.jar进行安装。
文档提示，安装文件不要放于带有汉字的路径下，否则ant将不能识别，安装就不能进行了。
6、（选择安装自带derby数据库的跳过）成功启动安装后会提示输入数据库信息，根据自身的数据库以及JDBC版本与驱动填写:
Database type： mysql
Username: root
Password: test
JDBC connection string：jdbc:mysql://localhost:3306/jetspeed
JDBC driver name ：com.mysql.jdbc.Driver
The location of a valid JDBC driver
JDBC驱动，我用的是mysql-connector-java-5.0.5
上面是我本机的输入信息，其中jetspeed就是原来在mysql中创建的空数据库。
安装成功后打开Jetspeed文件夹中的bin文件夹就能找到Tomcat的启动文件。双击startup.bat启动Tomcat，等候N秒，打开浏览器，输入： http://localhost:8080/jetspeed
呵呵，出现portal界面了吧，经典的guess number等portlet都在上面，如果要编程的话，懒惰的方法就是在demo的基础上修改一把，就可以了^_^