1 2 3 Previous Next 42 Replies Latest reply on Mar 27, 2008 11:29 PM by 702619

    Portlet应用开发(Touch JSR168 Portlets), Part 1 - 6

    702619
      Portlet应用开发, Part 1
      使用Eclipse plus Pluto开发你的第一个与JSR168兼容的Portlet
      By Terry.li
      SpiritSeekerS@sqatester.com

      本文将介绍开发基于Portlet Specification v1.0 (JSR168) 的Portlet应用.
      我们使用Pluto作为Portlet Container和Portal. 同时可以将开发的Portlet应用迁移到任何支持JSR168的Portlet Container上,如果Weblogic Portlet Container完全支持Portlet规范v1.0,那么可以将Portlet程序直接迁移到Weblogic Portal server上,这样一来就可以使用workshop进行portlet开发了.本文中的Portlet Sample可以直接在Weblogic8.1上运行,只要你安装了BEA提供的JSR168 Portlet开发包.

      ·     为什么要发布Portlet Specification? 什么是JSR168?
      由于越来越多的公司开发了各自的Portal组件和基于其的Portal产品(如Bea, IBM, Oracle, Sun, Sybase, Novell, SAP, Jetspeed, Vignette 等.这种互不兼容的接口实现不断带给程序提供商各种问题和麻烦, 为了解决这种问题, JCP发布了JSP168 (Java Specification Request), Portlet Specification, 用以提供不同Portal和Portlets之间a的互用性

      ·     什么是Portal?
      Portal是基于WEB的应用程序, 它将不同资源进行整合并展现给用户
      通常其有如下三个特点:

      a.     Personalization (个性化)
      b.     Single sign on (单点登陆)
      c.     Content aggregation (内容聚合)

      其中Content aggregation指的是将不同来源的信息整合到一个页面中用来让用户更方便的进行使用.
      比如, 如果某客户需要进行一次商业采购,以往需要访问不同的供应商的主页得到相关信息, 但如果使用Portal将所有不同的货物供应商的商品catalog页面都整合到一个Catalog Portal页面中, 那么所有的商品信息都可以更快的进行浏览,筛选和定货, 加快了客户的商业运作效率.

      ·     什么是Portlet?
      Portlet是一种基于WEB组件的JAVA技术, 由Portlet Container进行管理. 处理请求并动态返回页面, 可以做为Portal 的可拔插的用户界面组件.

      ·     什么是Portlet Container? Portlet Container用来管理Portlet的生命周期并且提供其运行所需要的必要环境. 并且为Portlet Preferences提供持久性(Persistent)存取服务.但是其不支持内容的Aggregation. Aggregation由Portal组件提供.

      注: Portlet Preferences是Portlet的一个新特性,提供类似数据库的功能.但是不是用来取代数据库. 只是用来存取简单的Portlet参数配置.
                
      ·     什么是WSRP?
      WSRP 是 OASIS Web Service for Remote Portlets的缩写. WSRP主要用来简化Portal对于各种资源或者程序的整合的复杂性, 可以避免编程带来的整合的复杂性. 并且Portal的管理员可以从大量的服务中选择需要的用以整和到Portal中.


      ·     Portlet and Servlet

      摘自(Portlet Specs v1.0)

      相同点:
      Portlets are Java technology based web components
      Portlets are managed by a specialized container
      Portlets generate dynamic content
      Portlets lifecycle is managed by a container
      Portlets interact with web client via a request/response paradigm

      不同点:
      Portlets only generate markup fragments, not complete documents. The Portal aggregates portlet markup fragments into a complete portal page
      Portlets are not directly bound to a URL Web clients interact with portlets through a portal system
      Portlets have a more refined request handling, action requests and render requests
      Portlets have predefined portlet modes and window states that indicate the function the portlet is performing and the amount of real state in the portal page
      Portlets can exist many times in a portal page

      Portlet特有:
      Portlets have means for accessing and storing persistent configuration and customization data
      Portlets have access to user profile information
      Portlets have URL rewriting functions for creating hyperlinks within their content, which allow portal server agnostic creation of links and actions in page fragments
      Portlets can store transient data in the portlet session in two different scopes: the application-wide scope and the portlet private scope

      Servlet特有:
      Setting the character set encoding of the response
      Setting HTTP headers on the response
      The URL of the client request to the portal

      ·     什么是Pluto ?
      Pluto 是 Apache开发下的一个Open Source项目, 是基于Portlet Specs的一个 Portlet Container 的实现. 它也提供了Sample Portal实现. 但是功能相对简单:

           例如,
           1) 没有复杂的Layout实现.
           2) 不是multi-user enabled, 比如, 不同User之间的Portlet Preferences互相是可以share的.

           请记住Pluto只是一个Portlet Container的实现, 不是一个Portal的实现. 如果你需要功能更为强大的Portal,可以使用JetSpeed , 它同样也是Apache的一个Open Source Project. 请参考文章末尾的资源部分.

      ·     概念
      如图: Figure 1.1
      a.     Decorations and controls (修饰部分及 控制部分)
      b.     Portlet fragment (Portlet 片段)
      c.     Portlet window (Portlet 窗口)
      d.     Portlet page (Portlet 页面)

      http://cn.geocities.com/jjfatplus/Figure11.jpg
      Figure 1.1

      ·     开发工具( Eclipse2.1, Pluto-plugin, Jakarta-tomcat-4.1.29)
      下载地址:
      Eclipse
      http://www.eclipse.org/downloads/index.php

      Pluto-plugin
      http://prdownloads.sourceforge.net/plutoeclipse/org.eclipsefan.pluto.ui_1.0.0.zip?download

      Tomcat4.1
      http://mirrors.midco.net/pub/apache.org/jakarta/tomcat-4/v4.1.29/bin/jakarta-tomcat-4.1.29.zip

      JDK1.4
      http://Java.sun.com

      ·     配置开发环境
           Step1 : 解压eclipse-SDK-2.1.1-win32.zip
           Step2 : 解压org.eclipsefan.pluto.ui_1.0.0.zip , 并将其拷入eclipse\plugins目录
      下, 如下: eclipse\plugins\org.eclipsefan.pluto.ui_1.0.0\
      \Icon
      \Lib
      \Source
      \Webapp

                Step3: 解压tomat4.1到一目录. 并且配置好Tomcat服务器.     
                Congratulations, It’s done!

      a. 使用Portlet Wizard 来创建Portal
      1) 选择File > New > Project… > Portal > Pluto Portal application, 单击Next, 如图:
      http://cn.geocities.com/jjfatplus/Figure12.jpg
      Figure 1.2

      2) 指定Project名称 (如图1.3), 这里使用pluto, 然后单击Next.
      http://cn.geocities.com/jjfatplus/Figure13.jpg
      Figure 1.3




      3) 指定Tomcat路径, 单击Finish. 之后eclipse会将Pluto安装到tomcat上,并且自动配置好环境.
      http://cn.geocities.com/jjfatplus/Figure14.jpg
      Figure 1.4




      b. 创建Portlets Application


      1) 创建Pluto portlet application (如图Figure 1.5)
      http://cn.geocities.com/jjfatplus/Figure15.jpg
      Figure 1.5

                2) 输入project名称 (如图Figure 1.6), 这里用portlets
      http://cn.geocities.com/jjfatplus/Figure16.jpg
      Figure 1.6




           c. 最后生成的工程如图 (Figure 1.7):
      http://cn.geocities.com/jjfatplus/Figure17.jpg     
      Figure 1.7               
      d. 通过portlet.xml 生成/更新 web.xml (如图Figure 1.8)
      http://cn.geocities.com/jjfatplus/Figure18.jpg
      Figure 1.8

      e. 部署 Portlets

      1) 编译 portlets 工程.
      2) 在 [your tomcat installation directory]/webapps下, 新建目录portlets
      3) 将portlets工程下的web-root目录下所有文件, 拷入以上新建的portlets目录中.
      Tip: 如果在每次修改后你厌倦了Ctrl+C 和 Ctrl+V, 你可以在Portlets工程目录下自己编一个Bat文件, 然后你可以在eclipse里的Package Explorer中看到它, 双击就可以了. 如上图(Figure 1.8): 其中deploy.bat文件就是实现其功能的.

      4) Start tomcat.
      5) 在IE 中输入: http://localhost: 8080/pluto/portal, 你应该能看到portal 页面.


      ·     Sample Portlet
      在Portlets工程文件创建过程中, 自动生成许多文件, 包括一个简单的Portlet, 我们来观察一下生成的sample portlet.


      1) 与Servlet非常类似, Portlet扩展自GenericPortlet
           
           import javax.portlet.*;

      public class SimplePortlet extends GenericPortlet

      2) 其三个方法对应了Portlet 标题栏中的三个联接 (View, Edit, Help) ,如图figure1.9
      http://cn.geocities.com/jjfatplus/Figure19.jpg
      public void doView(…)

      public void doEdit(…)

      public void doHelp(…)

      3) 三个方法分别调用了三个JSP文件, 用以生成Portlet fragment, 同样也可以调用Servlet产生Portlet fragment. 与Servlet应用类似,也可以使用
      getInitParameter(String s)方法,得到配置文件中Portlet的初始值. 只不过Servlet使用web.xml,而Portlet 使用portlet.xml文件.


      portlet.xml

           <init-param>
      <name>jspView</name>
      <value>/jsp/view.jsp</value>
      </init-param>


      SimplePortlet.java

      String jspName =
      getPortletConfig().getInitParameter("jspView");


      ·     Portlet Tag library

      1)defineObjects Tag

      如果打开其中的一个JSP文件,你会发现,和Servlet一样,JSP中可以使用Portlet的一些variables.例如:

      renderResponse
      renderRequest
      portletConfig

      但是必须声名:
      <portlet:defineObjects/>
      其中不可以定义任何属性或者包含任何内容.

      2) actionURL Tag
      属性     值类型     对应值
      windowState     String     Minimized,Normal,maximized
      portletMode     String     view, edit , help
      var     String     
      secure     String     True,false

      <portlet:actionURL windowState=”normal” portletMode=”edit”>
      <portlet:param name=”action” value=”login”/>
      </portlet:actionURL>

      创建一个action URL , 当访问它时将使portlet window变为normal 装态, 模式变为 edit.

      3) renderURL Tag
      属性     值类型     对应值
      windowState     String     Minimized,Normal,maximized
      portletMode     String     view, edit , help
      var     String     
      secure     String     True,false

      <portlet:renderURL portletMode=”view” windowState=”maximized”>
      <portlet:param name=”number” value=”1”/>
      <portlet:param name=”page” value=”2”/>
      </portlet:renderURL>

      创建一个render URL , 当访问它时将使portlet window变为maximized装态, 模式变为 view.

      4) namespace Tag
      为目前的Portlet产生一个唯一的Value. 防止和其他的Portlet 或者Portal页面上的value产生冲突.
      doFoo()”>Foo

      5) param Tag
      属性     值类型
      name     String
      <portlet:param name=”myParam” value=”someValue”/>
      注: param Tag不可以有body content.


      总结
      Pluto目前是v1.0, 有部分Portlet规范没有完全实现, 例如, renderResponse.setTitle (), 同时你可以从Apache的CVS下载最新的Pluto代码, 希望这编文章可以帮大家搭建一个简单的Portlet开发环境 , 熟悉Portlet相关的知识.


      资源:
      ·     Pluto
      http://jakarta.apache.org/pluto

      ·     Pluto Mail List
      http://news.gmane.org/gmane.comp.jakarta.pluto.user

      ·     WSRP Spec1.0
      http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=wsrp

      ·     Apache的WSRP实现
      http://ws.apache.org/wsrp4j/

      ·     Apache’s Portal, JetSpeed:
      http://jakarta.apache.org/jetspeed/site/index.html

      ·     JSR 168:
      http://www.jcp.org/en/jsr/detail?id=168

      ·     "Portlet 规范介绍" By Stefan Hepper 和 Stephan Hesmer
      o     Part 1: Get your feet wet with the specification's underlying terms and concepts (August 2003)
      http://www.javaworld.com/javaworld/jw-08-2003/jw-0801-portlet.html
      o     Part 2: The Portlet API's reference implementation reveals its secrets (September 2003)
      http://www.javaworld.com/javaworld/jw-09-2003/jw-0905-portlet2.html


      完整的教程如下:

      http://dev2dev.bea.com.cn/bbs/thread.jspa?forumID=101&threadID=14461&tstart=0


      该帖由 SpiritSeekerS 在 2004-9-3 下午1:48 编辑过
        1 2 3 Previous Next