Portlet应用开发实例

目的：

开发一个符合JSR-168标准的Portlet应用，将其部署到Jetspeed2上。熟悉Portlet应用的开发过程和了解Jetspeed2对Portlet应用的支持情况。

背景资料：

JSR-168标准：由Java Community Process(JCP)于2003年10月7日发布的Portlet Specification 1.0最终版本。定义了Portlet应用的标准接口。获得业界的广泛支持。

内容：

1、Portlet应用代码

本文中的介绍的Portlet应用是由IBM developerworks提供的一个简单Hello World示例。包括了doView方法显示一个jsp页面。使用Portlet中的processAction方法处理jsp中From表单提交的数据，并把得到的数据放到一个Java Bean中，该Java Bean又被放到PortletSession中供jsp文件调用。具体说明和源码下载可参见：

http://www-128.ibm.com/developerworks/cn/websphere/library/techarticles/yangjiang/0402_jsr168/jsr168portlet.html?ca=dwcn-newsletter-wsdd

2、编辑打包

在编辑时需要两个标准类库：portlet-api-1.0.jar和pluto-1.0.1.jar。

注意：在打包时不要将这两个类库包含进去。因为在Tomcat/shared/lib里已经有了，不然就会报Cannot create Portlet instance错误。

使用JDK的jar命令把项目文件打包成web archive 文件。

3、发布

将打包生成的HelloWorld.war文件拷贝到/jetspeed/WEB-INF/deploy目录下即可。系统会自动部署到Portal中。

4、调用

在页面编辑状态下，点击新增Portlet会出现“Portlet选择器”。里面会新增一个“HelloWorld portlet”应用。选中后确定就可将其添加到页面中。

<shapetype id="_x0000_t75" stroked="f" filled="f" path="m@4@5l@4@11@9@11@9@5xe" o:preferrelative="t" o:spt="75" coordsize="21600,21600"><stroke joinstyle="miter"></stroke><formulas><f eqn="if lineDrawn pixelLineWidth 0"></f><f eqn="sum @0 1 0"></f><f eqn="sum 0 0 @1"></f><f eqn="prod @2 1 2"></f><f eqn="prod @3 21600 pixelWidth"></f><f eqn="prod @3 21600 pixelHeight"></f><f eqn="sum @0 0 1"></f><f eqn="prod @6 1 2"></f><f eqn="prod @7 21600 pixelWidth"></f><f eqn="sum @8 21600 0"></f><f eqn="prod @7 21600 pixelHeight"></f><f eqn="sum @10 21600 0"></f></formulas><path o:connecttype="rect" gradientshapeok="t" o:extrusionok="f"></path><lock aspectratio="t" v:ext="edit"></lock></shapetype><shape id="_x0000_i1025" style="WIDTH: 414.75pt; HEIGHT: 348pt" type="#_x0000_t75"><imagedata o:title="䘦Ŗ푼h" src="file:///C:/DOCUME~1/s/LOCALS~1/Temp/msohtml1/01/clip_image001.png"></imagedata></shape>

除此之外还有个更简单的办法可以显示portlet。在/jetspeed/WEB-INF/pages目录下的default-page.psml文件中增加一个fragment定义。

<fragment id="dp-19" type="portlet" name="HelloWorld::HelloWorldPortlet">

<property name="row" value="6"/>

<property name="column" value="0"/>

</fragment>

其中：

id 为任意项

name 为${portlet.application.id}和${portlet.name}的组合。

${portlet.application.id}是实际的war文件名；${portlet.name}为在portlet.xml中定义的<portlet-name>。

row ,column为页面中的位置。

5、错误及解决方法

将应用部署到页面后发现不能正常显示，报Portlet is Not Available错误。

经过对日志分析，原来jetspeed2不支持PropertyManager容器服务。在代码里使用了renderRequest.getProperty("wps.markup")获得这个初始化参数的值。

修改程序通过初始化来获得参数的值。

private static String defaultMarkupSource = "";

/**

* Initialize portlet configuration.

*/

public void init(PortletConfig config) throws PortletException

{

super.init(config);

defaultMarkupSource = config.getInitParameter("wps.markup");

}

private static String getJspFilePath(RenderRequest request, String jspFile)

{

//String markup = request.getProperty("wps.markup");

String markup = defaultMarkupSource;

if (markup == null)

{

markup = getMarkup(request.getResponseContentType());

}

return JSP_FOLDER + markup + "/" + jspFile + "." +

getJspExtension(markup);

}

重新编译部署，应用即可正常显示。

总结：

Jetspeed2.0支持JSR-168标准，Portlet应用可方便地部署到Jetspeed2.0上，操作非常便捷。应用可正常运行。不足之处就是不支持Property Manager服务，造成一些Portlet应用的移植困难。

参考资料：

杨江，《Hello World，一个简单的JSR 168 portlet》,

http://www-128.ibm.com/developerworks/cn/websphere/library/techarticles/yangjiang/0402_jsr168/jsr168portlet.html?ca=dwcn-newsletter-wsdd2004-02-01