在RAD7中开发JSR168 Portlet （一）

本教程介绍Rational Application Developer 7中JSR168 Portlet的开发，以两个例子说明JSR168 Portlet开发的基本内容和步骤，所实现Portlet的功能与文章《在Rational Application Developer中开发简单Portlet》一致。

IBM要放弃自己那套Portlet开发API的意思已经很明显了，在RAD7中这些API已经被打上波浪线，标识成“不建议使用类型”，deprecated了。RSA7中更直接，直接在类名上划黑线，明确告诉你最好不要在用了，呵呵

开发环境：WinXP+SP2，RAD 7.0.0.3
测试环境：Win2003+SP2，WebSphere Portal6

示例1：在Portlet编辑页面中添加用户登录界面，在视图页面中显示用户名和密码。
1． 启动RAD。
2． 新建Portlet项目。
选择“文件－》新建－》Portlet项目”。
将项目命名为PortletExample，选择“创建portlet”，RAD就会自动在项目中添加一portlet。由于是要部署在Portal6上的，目标运行时设置为“WebSphere Portal V6.0 stub”。Portlet API选择“JSR 168 Portlet”，我们要开发的就是它嘛，如果还是“IBM Portlet”，搞不好哪天就被IBM自己抛弃了  Portlet类型选择“基本Portlet”，RAD就会创建一示例portlet，我们只需在其上做一些修改即可。其它都接受默认即可。

将所有的视图都勾上。

取消“将操作侦听器添加至portlet以处理操作请求”，我们暂时不会涉及到该方面内容。然后“完成”即可。
项目建立完成后我们就可以看见如图所示的项目文件列表。

WebContent下包含了项目的jsp文件，五个jsp文件分别对应五种视图。
3．编写代码。
（1）在PortletExamplePortlet.java中定义三变量EDIT_USERNAME、EDIT_PASSWORD和EDIT_CANCEL。EDIT_CANCEL用于处理按钮的取消事件。
publicstaticfinal String EDIT_USERNAME = "PortletExamplePortletEditUsername";
publicstaticfinal String EDIT_PASSWORD = "PortletExamplePortletEditPassword";
publicstaticfinal String EDIT_CANCEL   = "PortletExamplePortletEditCancel";
（2）编辑PortletExamplePortlet.java，处理EDIT_SUBMIT和EDIT_CANCEL按钮事件，在函数processAction中针对编辑视图的提交请求和取消进行处理，将username和password两值存入到PortletPreferences中。
if( request.getParameter(EDIT_SUBMIT) != null ) {
    PortletPreferences prefs = request.getPreferences();
    try {
        prefs.setValue(EDIT_USERNAME,request.getParameter(EDIT_USERNAME));
        prefs.setValue(EDIT_PASSWORD,request.getParameter(EDIT_PASSWORD));
        prefs.store();
    } catch( ReadOnlyException roe ) {
    } catch( ValidatorException ve ) {
    }
    response.setPortletMode(PortletMode.VIEW);
}
if( request.getParameter(EDIT_CANCEL) != null ) {
    response.setPortletMode(PortletMode.VIEW);
}
使用response.setPortletMode(PortletMode.VIEW);语句决定提交后将转向的视图。
（3）编辑PortletExamplePortletEdit.jsp，删除RAD自动生成的代码，设计用户名和密码提交页面。
<%@page session="false" contentType="text/html" pageEncoding="GB18030" import="javax.portlet.*,portletexample.*"%>
<%@taglib uri="http://java.sun.com/portlet" prefix="portlet" %>
<portlet:defineObjects/>

<%
    PortletPreferences prefs = renderRequest.getPreferences();
    if (prefs != null) {
        String username = prefs.getValue(PortletExamplePortlet.EDIT_USERNAME, "");
        String password = prefs.getValue(PortletExamplePortlet.EDIT_PASSWORD, "");
%>

<FORM ACTION="<portlet:actionURL/>"METHOD="POST">
Username:<INPUT NAME="<%=PortletExamplePortlet.EDIT_USERNAME%>"VALUE="<%=username%>"TYPE="text"><BR>
Password:<INPUT NAME="<%=PortletExamplePortlet.EDIT_PASSWORD%>"VALUE="<%=password%>"TYPE="password"><BR>
<INPUT NAME="<%=PortletExamplePortlet.EDIT_SUBMIT%>"TYPE="submit" value="Save">
<INPUT NAME="<%=PortletExamplePortlet.EDIT_CANCEL%>"TYPE="submit" value="Cancel">
</FORM>

<%
    } else {
%>
Error: PortletPreferences is null.
<%
    }
%>
注意标签<portlet:defineObjects/>，在页面中添加它后才可调用PortletConfig、RenderRequest、RenderResponse这几个对象。
（4）编辑PortletExamplePortletView.jsp，在页面上输出用户名和密码值。
<%@page session="false" contentType="text/html" pageEncoding="GB18030" import="javax.portlet.*,portletexample.*" %>
<%@taglib uri="http://java.sun.com/portlet" prefix="portlet" %>
<portlet:defineObjects/>

<%
    PortletPreferences prefs = renderRequest.getPreferences();
    if (prefs != null) {
        String username = prefs.getValue(PortletExamplePortlet.EDIT_USERNAME, "");
        String password = prefs.getValue(PortletExamplePortlet.EDIT_PASSWORD, "");
%>

<P><%=PortletExamplePortlet.EDIT_USERNAME%>:<%=username%></P>
<P><%=PortletExamplePortlet.EDIT_PASSWORD%>:<%=password%></P>

<%
    } else {
%>
Error: PortletPreferences is null.
<%
    }
%>
4．全部修改完成后保存，导出WAR安装包。

指定导出位置。

5．在Portal6上安装，新建一测试页面将该Portlet添加到页面上。
初始运行界面如图，由于最初用户名和密码都为空，所以显示的也都是空的。

点击右上角小三角打开portlet菜单，点击个性化，即进入编辑模式，输入用户名密码然后保存。


此时页面转往视图模式，显示刚才设置的用户名和密码值。

如在个性化设置中点击取消，则所做改动无效，直接转回视图模式。
至此，第一个Portlet示例就开发完成了。
读者可以试着实现在配置模式中完成相同功能。

累了，去读意优休息一下下,QQ空间，美文，非主流，网络日记，搞笑短信，祝福短信，热门短信，有意思啊