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”应用。选中后确定就可将其添加到页面中。

 

       除此之外还有个更简单的办法可以显示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 portle t》,

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