jetspeed 1.4 二次开发入门 （by quqi99)
Portlet
应用开发
一、
什么是portal
Portal
是一种基于web的应用，通常用来提供个性化、单点登陆、内容集合、信息系统表现层。其中，内容集合指把不同源头的内容整合成一个网页。Portal可提供高级的个性化功能，可以让用户定制自己需要的内容。这样的portal页面对不同的用户有不同的portlet集合。
Portal
页面结构如下所示：
上图所示的portal页面有四个portlet窗口。通过个性化定制，用户可以改变自己的portal页面中portlet的布局，还可以向自己的portal页面中增加portlet或将portlet从中移除。
二、
portal
工作流程概述
Portal
页面的生成：
Portal
页面请求过程：①用户使用浏览器访问
portal
页面。②收到请求后portal服务器根据用户的个性化信息确定需要的portlet，③然后通过portlet容器调用这些portlet。④Portal服务器用portlet生成的网页片段建立portal页面，⑤发送给用户。（其中角色参考上图）
三、
部署ASOPortal
a.
安装MySQL数据库。将MySQL压缩包解压缩到硬盘，进入bin目录，运行winmysqladmin.exe，任务栏中出现绿灯说明MySQL服务已启动。
b.
安装JDK和tomcat服务器。
c.
将ASOPortal压缩包解压到tomcat的webapps/asop目录中，将WEB-INF/src/sql/asop.sql复制到MySQL的bin目录下，用命令行方式进入该目录执行“mysql-uroot<asop.sql”。
d.
启动tomcat，浏览http://localhost:8080/asop/config，在数据库配置页面中修改Url为jdbc:mysql://localhost/asop?useUnicode=true&characterEncoding=UTF-8。浏览http://localhost:8080/manager/html，在Applications栏目中找到asop，点击它右面的Reload链接重新启动该应用以使新配置生效。看到Message栏中出现“OK - Reloaded application at context path /asop”表示成功。
e.
浏览http://localhost:8080/asop/进入ASOPortal系统。
四、
portlet
应用基础
ASOPortal
系统portlet执行机制：（参考第七部分例程）
a.
渲染（render）请求和
操作
（action）请求：渲染请求会使portlet显示最初的默认页面。当显示一个portal页面时portal服务器触发该页面中所有portlet的渲染请求。当在portal页面的某个portlet中提交表单或点击
操作
请求链接时，portal服务器会触发该portlet的
操作
请求，并触发同一portal页面中其它portlet的渲染请求。
|
客户端
|
|
Portal
服务器
|
|
Portlet
容器
|
|
Action
|
|
Jsp
|
|
request
|
|
setAttribute
|
|
getAttribute
|
|
.xreg文件
|
b.
收到渲染请求，portlet容器根据.xreg文件中的portlet注册信息找到被请求的portlet的Action类，调用它的buildNormalContext方法，之后重定向到注册信息中指定的模板（jsp）。
c.
收到
操作
请求，portlet容器根据名为js_peid和eventSubmit_doXxxx的请求参数调用相应portlet的Action类的doXxxx方法， setTemplate方法指定重定向去的模板（jsp）。js_peid请求参数在后面介绍。
d.
注意：①在buildNormalContext方法和doXxxx方法中均可用request对象的setAttribute方法将动态内容保存到request对象中，在之后的jsp模板中用request对象的getAttribute方法取得该动态内容并显示
。②若未在Action的doXxxx方法中调用setTemplate，则方法完成后重定向去该portlet上一次使用的模板。
编写ASOPortal系统的portlet应用建议步骤：①编写Jsp页面，
②编写Action类和相关的实体类和DAO，③注册到.xreg文件中。
Jsp
模板文件要放在WEB-INF/template-asop/jsp/portlet/html目录下，这是由配置文件TurbineResources.properties中的
services.JspService.templates=/WEB-INF/templates-asop/jsp
和JetspeedResource.properties中的
services.TemplateLocator.templateRoot=/WEB-INF/templates-asop
决定的。（TurbineResources.properties和JetspeedResource.properties在WEB-INF/conf下）
用于portlet的jsp中使用asop标签<template:dynamicUri/>来生成portlet请求URL。在提交请求时需要包含js_peid参数。（参见第七部分例程）
应用的Action类统一放到com.aerostrong.asop.portal.portlet.act
ions
包中为每个应用建立的子包里，这是由TurbineResource.properties中的module.packages=com.aerostrong.asop.portal.portlet 决定的。Action的方法中对request的操作（如getAttribute、setAttribute等）需要首先取得request对象，方法是调用作为参数传入的RunData实例的getRequest方法；对request参数的取得可使用RunData实例的getParameters().getXXX()方法，其中getXXX可以是getString、getInt、getDate等方法。（参见第七部分例程）
.xreg
文件的名称理论上可以随意，为方便管理我们统一使用appName-portlet.xreg，其中appName为应用系统的名称。.xreg文件是xml格式的，注册portlet的方法就是给其中的registry元素增加一个portlet-entry字元素，具体参见第七部分例程。.xreg文件需要用UTF-8字符集保存。
五、
最简单的开发环境
ASOPortal
系统现已配有Ant构建文件WEB-INF/build.xml，可使用EditPlus、UltraEdit等文本编辑器编写Action类和jsp页面，修改xreg文件，之后用命令提示符模式在asop的WEB-INF目录下执行ant命令来编译。可用的命令有ant——只编译更新过的类，ant clean——清除所有已编译的文件，ant all——清除已编译的文件并全部重新编译。
使用该方法需要安装配置Ant编译工具。方法是解压缩Ant到硬盘上，设置环境变量ANT_HOME为Ant解压缩出来的目录，添加%ANT_HOME%/bin到PATH环境变量中。
.xreg
文件修改或类编译后都需要重新启动应用才会生效。可通过访问http://localhost:8080/manager/html，点击Applications栏目中asop右边的Reload来重启应用。
六、
配置JBuilder开发环境
习惯使用Jbuilder环境开发的同志可参考以下步骤设置Jbuilder。
a.
在Jbuilder中点击菜单中的File->New->Project for Existing Code。
b.
将Directry设置为asop的WEB-INF目录，name设为ASOPortal，点击Next进入下一步。
c.
设置Output path为asop的WEB-INF/classes，Backup path和Working path不作要求；下面的source页中default设为WEB-INF/src/java；Required Libraries页中点击Add，在新弹出的窗口中点击New，在新弹出的窗口中设置Name为ASOPortal，点击Add，选中asop的WEB-INF/lib和WEB-INF/buildlib目录下的所有jar点击OK，选中ASOPortal点击OK。点击finish完成。
d.
开发时使用Jbuilder编写Action类，用自己习惯的工具编写jsp页面并保存到前面介绍的文件夹中，手动修改.xreg文件。.xreg文件修改或类编译后需要重新启动应用才会生效。可通过访问http://localhost:8080/manager/html，点击Applications栏目中asop右边的Reload来重启应用。
七、
例程
WEB-INF/conf/AppDemo-portlet.xreg
（必须用UTF-8字符集保存）
|
<?xml version="1.0" encoding="UTF-8"?>
<registry>
<portlet-entry name="AppDemo" hidden="false"
type="instance" parent="JSP" application="false">
<meta-info>
<title>
简单应用</title>
<description>
应用portlet示例</description>
</meta-info>
<classname>org.apache.jetspeed.portal.portlets.JspPortlet</classname>
<parameter name="template" value="appdemo/appDemo.jsp"
hidden="true" cachedOnName="true" cachedOnValue="true"/>
<parameter name="action" value="appdemo.AppDemoAction"
hidden="true" cachedOnName="true" cachedOnValue="true"/>
<media-type ref="html"/>
<url cachedOnURL="true"/>
<category group="Jetspeed">测试
</category>
</portlet-entry>
<portlet-entry>
……
</portlet-entry>
</registry>
|
WEB-INF/template-asop/jsp/portlets/html/appdemo/appDemo.jsp
|
<%@ page contentType="text/html; charset=GB18030" %>
<%@ taglib uri="http://www.aerostrongsoft.com.cn/asop/portal/tags-template" prefix="template" %>
<%@ taglib uri="http://java.sun.com/jstl/core" prefix="c" %>
<%@ taglib uri="http://java.sun.com/jstl/fmt" prefix="fmt" %>
今天是：
<fmt:formatDate dateStyle="FULL" value="${today}"><br>
<form action="
<template:dynamicUri/>" method="post">
<input type="hidden" name="js_peid" value="<c:out value='${js_peid}'>"/>
您的姓名：
<input type="text" name="user_name"/>
<input type="submit" name="
eventSubmit_doWelcome" value="提交
"/>
</form>
|
WEB-INF/src/java/com/aerostrong/asop/portal/portlet/actions/demo/AppDemoAction.java
|
package com.aerostrong.asop.portal.portlet.actions.appdemo;
import org.apache.jetspeed.modules.actions.portlets.JspPortletAction;
import org.apache.jetspeed.portal.Portlet;
import org.apache.turbine.util.RunData;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
public class AppDemoAction
extends JspPortletAction {
private static Log log = LogFactory.getLog(AppDemoAction.class);
protected void buildNormalContext(Portlet portlet, RunData runData) {
log.trace("in");
runData.getRequest().setAttribute("today", new java.util.Date());
}
public void doWelcome(RunData runData, Portlet portlet) {
log.trace("in");
String name = runData.getParameters().getString("user_name");
runData.getRequest().setAttribute("userName", name);
setTemplate(runData, "appdemo/appDemoWelcome.jsp");
}
}
|
WEB-INF/template-asop/jsp/portlets/html/appdemo/appDemoWelcome.jsp
|
<%@ page contentType="text/html;charset=GB18030" %>
<%@ taglib uri="
http://www.aerostrongsoft.com.cn/asop/portal/tags-template" prefix="template" %>
<%@ taglib uri="http://java.sun.com/jstl/core" prefix="c" %>
欢迎您，
<c:out value="${userName}"/><br>
<a href="<template:dynamicUri/>
?js_peid=<c:out value='${js_peid}'/>">返回
</a>
|
WEB-INF/conf/TurbineResources.properties
|
services.JspService.templates =/WEB-INF/templates-asop/jsp
module.packages=com.aerostrong.asop.portal.portlet
|
WEB-INF/conf/JetspeedResources.properties
|
services.TemplateLocator.templateRoot=/WEB-INF/templates-asop
|