使用Eclipse plus Pluto开发你的第一个与JSR168兼容的Portlet（二）

最新推荐文章于 2024-08-11 09:00:00 发布
最新推荐文章于 2024-08-11 09:00:00 发布
阅读量2.3k 收藏 1
点赞数
分类专栏： portlet 文章标签： portlet eclipse application action encoding import

By Terry.lee

SpiritSeekerS@sqatester.com

 

 

本部分使用本系列中Part1搭建的开发环境,如果还没有搭建好开发环境,请参考Portlet应用开发(JSR168),Part1进行开发环境的搭建.

 

在Part1中,我们开发了一个简单的portlet程序,但是几乎所有的代码和文件都是由Eclipse的pluto plugin替我们完成的,如何配置用来在Pluto中的Portal中添加新的Portal Page并且将新的Portlet添加到新的Page中去呢? Part2将一步一步教你如何创建一个新Portal Page.

 

 

·         Portal的设定
Tomcat 中Webapps目录: 其中pluto是portal所在目录, 用以配置Portal Page的两个文件分别是pageregistry.xml和portletentityregistry.xml (如图Figure1_1)

Figure1_1

 

 

其中pageregistry.xml用来在Portal中配置Portal Page, 而portletentityregistry.xml 用来在Page中配置Portlet.

 

·         portletentityregistry.xml
打开pageregistry.xml, 内容如下 :

<?xml version="1.0" encoding="UTF-8"?>

<portlet-entity-registry>

    <application id="1">

        <definition-id>portlets</definition-id>

        <portlet id="1">

            <definition-id>portlets.SimplePortlet</definition-id>

        </portlet>

    </application>

</portlet-entity-registry>

其中application 标签表明了目前的application 的 ID, portlet标签定义了一个Portlet , 如果你新开发了一个Portlet , 可以加入以下内容:

<?xml version="1.0" encoding="UTF-8"?>

<portlet-entity-registry>

    <application id="1">

        <definition-id>portlets</definition-id>

        <portlet id="1">

            <definition-id>portlets.SimplePortlet</definition-id>

        </portlet>

        <portlet id="2">

            <definition-id>portlets.IntroPortlet</definition-id>

        </portlet>

    </application>

</portlet-entity-registry>

 

这样一来你又在portal中注册了一个新的Portlet,接下来是将新注册的Portlet加入Page中.

 

·         pageregistry.xml
打开pageregistry.xml, 内容如下 :

<?xml version="1.0"?>

<portal>

 

    <fragment name="navigation" class="org.apache.pluto.portalImpl.aggregation.navigation.TabNavigation">

    </fragment>

   

    <fragment name="sample" type="page">

        <navigation>

            <title>Sample Portlet</title>

            <description>Basic page to show the simple portlet</description>

        </navigation>

 

        <fragment name="row" type="row">

 

            <fragment name="col1" type="column">

 

                <fragment name="p1" type="portlet">

                    <property name="portlet" value="1.1"/>

                </fragment>

 

            </fragment>

 

        </fragment>

 

    </fragment>

</portal>

 

以上是sample portlet的配置.

 

Fragment标签用来配置navigation(导航栏), Page,以及Page中的Column和Row.

分别用fragment标签的type属性来标识. Pluto自带的Portal使用fragment标签来配置及处理简单的Portlet Layout.

 

<property name="portlet" value="1.1"/>中的value值是在portletentityregistry.xml中定义的. 分别对应application id 和portlet id, 将其值用”.”连接起来使用用以定义一个Portlet. 同样 , 如果使用<property name="portlet" value="1.2"/>,则将使用portlets.IntroPortlet.

        

 

 

1)     配置同一行中的两个Portlet, 如下:

<?xml version="1.0"?>

<portal>

 

    <fragment name="navigation" class="org.apache.pluto.portalImpl.aggregation.navigation.TabNavigation">

    </fragment>

   

    <fragment name="sample" type="page">

        <navigation>

            <title>Sample Portlet</title>

            <description>Basic page to show the simple portlet</description>

        </navigation>

 

        <fragment name="row" type="row">

 

            <fragment name="col1" type="column">

 

                <fragment name="p1" type="portlet">

                    <property name="portlet" value="1.1"/>

                </fragment>

 

                <fragment name="p2" type="portlet">

                    <property name="portlet" value="1.1"/>

                </fragment>

 

            </fragment>

 

        </fragment>

 

    </fragment>

 

</portal>

 

2)     配置同一列中的两个Portlet, 如下:

<?xml version="1.0"?>

<portal>

 

    <fragment name="navigation" class="org.apache.pluto.portalImpl.aggregation.navigation.TabNavigation">

    </fragment>

   

    <fragment name="sample" type="page">

        <navigation>

            <title>Sample Portlet</title>

            <description>Basic page to show the simple portlet</description>

        </navigation>

 

        <fragment name="row1" type="row">

 

            <fragment name="col1" type="column">

 

                <fragment name="p1" type="portlet">

                    <property name="portlet" value="1.1"/>

                </fragment>

 

            </fragment>

 

        </fragment>

 

        <fragment name="row2" type="row">

 

            <fragment name="col1" type="column">

 

                <fragment name="p1" type="portlet">

                    <property name="portlet" value="1.1"/>

                </fragment>

 

            </fragment>

 

        </fragment>

 

    </fragment>

 

</portal>

 

 

 

 

·         Portlet Modes 和 Portlet window states
Portlet模式(Portlet Mode)是Portlet提供的用以区分 Portlet所执行功能的一个概念.通常情况下其拥有以下几种模式:
1. VIEW

2. EDIT

3. HELP

以上各模式分别对应GenericPortlet中的 doView(…) , doEdit(…) , doHelp(…) 方法,分别调用以上方法来产生各个模式中的Fragment内容. 非常类似Servlet中的doGet(…) , doPost(…) 方法,都是Helper方法, 但是概念不同.

 

Portlet状态(Portlet window states)提供了对于Portlet窗口的控制功能 , 其中有如下三种最基本的状态:

1.     Normal

2.     Maximized

3.     Minimized

 

Portlet开发人员可以在处理ActionRequest (以后的章节将讲述其概念) 时使用代码实现Portlet模式, 及其Portlet状态的转变.

 

注: 只能在处理ActionRequest时改变Portlet Modes和Portlet Window states.

     

以上Portlet Modes和Portlet window states都可以配置成custom Portlet mode和custom portlet window state. 不同的地方在于对于Mode来说, 定制化的Mode需要对GenericPortlet的doDispatch方法进行重写(Overriding), 因为GenericPortlet类通过render方法按照不同的Portlet Mode将request分别分发给doView,doEdit,doHelp等辅助方法. 如果需要定制的Mode , 必须重写doDispatch 方法. 同时如果使用Portal提供商的Portlet Modes 或者 Portlet window States,都必须在部署描述中添加相关的设定.

 

A.     添加Custom Portlet Modes

以下使用代码实现了一个新的Portlet Mode: CONFIG , 当然也可以使用Portal提供商支持的Portlet Mode. 但是需要Mapping到Portal提供商所支持的Portlet Mode. 使用如下描述:

 

    <custom-portlet-mode>

         <description>Provides administration functions</description>

         <portlet-mode>CONFIG</portlet-mode>

    </custom-portlet-mode>

 

1. Portlet代码 (CustomPortletModeExample.java)

 

package portlets.portletmode;

 

/**

 * @author terry

 *

 * To change the template for this generated type comment go to

 * Window&gt;Preferences&gt;Java&gt;Code Generation&gt;Code and Comments

 */

import javax.portlet.*;

import java.io.IOException;

 

public class CustomPortletModeExample extends GenericPortlet{

 

  public void doView(RenderRequest request, RenderResponse response)

  throws PortletException, IOException

  {

  response.setContentType("text/html");

 

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

 

  PortletRequestDispatcher rd =

    getPortletContext().getRequestDispatcher(jspName);

 

  rd.include(request, response);

  }

 

  public void doEdit(RenderRequest request, RenderResponse response)

  throws PortletException, IOException

  {

  response.setContentType("text/html");

 

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

 

  PortletRequestDispatcher rd =

    getPortletContext().getRequestDispatcher(jspName);

 

  rd.include(request, response);

  }

   

  public void render(RenderRequest request, RenderResponse response)

  throws PortletException, IOException{

         doDispatcher(request,response);

  }

   

  public void doDispatcher(RenderRequest request, RenderResponse response)

         throws PortletException, IOException{

         if(!request.getWindowState().equals(WindowState.MINIMIZED)){

         if(request.getPortletMode().equals(PortletMode.VIEW)){

                doView(request,response);

         }else if(request.getPortletMode().equals(PortletMode.EDIT)){

                doEdit(request,response);

         }else if(request.getPortletMode().equals(new PortletMode("CONFIG"))){

                doConfig(request,response);

         }

}

  }

 

  public void doConfig(RenderRequest request, RenderResponse response)

    throws PortletException, IOException

  {

    response.setContentType("text/html");

 

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

 

    PortletRequestDispatcher rd =

         getPortletContext().getRequestDispatcher(jspName);

 

    rd.include(request, response);

  }

 

  public void processAction(ActionRequest request, ActionResponse response)

         throws PortletException, IOException

  {

         String action=request.getParameter("ACTION");

         System.out.println("ACTION" + action);

         if(action==null){

                action="";

         }

         response.setRenderParameter("ACTION",action);

  }

}

 

2. JSP(all_mode.jsp)

<%@ page session="false" %>

<%@ page import="javax.portlet.*"%>

<%@ page import="java.util.*"%>

<%@ taglib uri='/WEB-INF/tld/portlet.tld' prefix='portlet'%>

<portlet:defineObjects/>

<br>

<h3>Custom Portlet Mode Example</h3>

Current Portlet Mode: <b><%=renderRequest.getPortletMode()%></b><br>

Current Window State : <b><%=renderRequest.getWindowState()%></b><br>

<br>

 

 


5. Portlet.xml


<?xml version="1.0" encoding="UTF-8"?>

<portlet-app xmlns="/org/apache/pluto/portalImpl/xml/portlet-app_1_0.xsd" version="1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="/org/apache/pluto/portalImpl/xml/portlet-app_1_0.xsd /org/apache/pluto/portalImpl/xml/portlet-app_1_0.xsd">

 

  <!-- Custom PortletMode Example -->

  <portlet>

         <description>CustomPortletModeExample Example</description>

         <portlet-name>CustomPortletModeExample</portlet-name>

         <display-name>CustomPortletModeExample</display-name>

         <portlet-class>portlets.portletmode.CustomPortletModeExample</portlet-class>

         <init-param>

                <name>all</name>

                <value>/fragments/portletmode/all_mode.jsp</value>

         </init-param>

         <expiration-cache>-1</expiration-cache>

         <supports>

                <mime-type>text/html</mime-type>

                <portlet-mode>VIEW</portlet-mode>

                <portlet-mode>EDIT</portlet-mode>

                <portlet-mode>CONFIG</portlet-mode>

         </supports>

         <supported-locale>en</supported-locale>

         <portlet-info>

                <title>Custom PortletMode Example</title>

                <short-title>PortletMode</short-title>

                <keywords>PortletMode</keywords>

         </portlet-info>

    </portlet>

 

</portlet-app>


6. portletregistry.xml.

 

<?xml version="1.0" encoding="UTF-8"?>

<portlet-entity-registry>

    <application id="10">

        <definition-id>portlets</definition-id>

        <portlet id="10">

            <definition-id>portlets.CustomPortletModeExample</definition-id>

        </portlet>

    </application>

</portlet-entity-registry>

 

7. pageregistry.xml


<?xml version="1.0"?>

<portal>

 

    <fragment name="navigation" class="org.apache.pluto.portalImpl.aggregation.navigation.TabNavigation">

    </fragment>

   

         <!-- Custom PortletMode Example Page -->

      <fragment name="customportletmodepage" type="page">

        <navigation>

            <title>Custom PortletMode Example Page</title>

            <description>Custom PortletMode Example Page</description>

        </navigation>

        <fragment name="row1" type="row">

            <fragment name="col1" type="column">

                <fragment name="p1" type="portlet">

                    <property name="portlet" value="10.10"/>

                </fragment>

            </fragment>

        </fragment>

  </fragment>

 

</portal>

 

 

将以上源代码编译后, 再通过Eclipse生成/更新Portlet的web.xml后,  将所有配置及相关文件部署后, 启动Tomcat.

 

 

 

在Browser中加载如下页面: Http://localhost:8080/pluto/portal , 可以看到如下的页面(图:2_1)

 

                               图2-1

 

 

单击Custom PortletMode Example Page后可以看到如下Portlet 页面:

 

图2-2

 

单击右上角的config后,可以看到如下页面片段:

 

图2-3

 

以上可以看到新添加的Portlet Mode: config.

 

 

B.     添加Custom Window States

 

 添加新的window states同样需要在配置文件中加入相应的描述,如下:
<custom-window-state>

<description>Occupies 50% of the portal page</description>

<name>half_page</name>

</custom-window-state>

 

但是同样需要Mapping到Portal提供商所支持的Window state.

 

总结:

因为Eclipse 的Pluto plugin使用的是version1.0 , 所以可能有许多Bugs或者没有实现的功能, 所以如果需要最新版本的Pluto , 可以在Apache的CVS上下载, 下载的代码中有现成的Build scripts 以及相关的deploy script.请参考相关文档资料.

 

资源:

·         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

Part 1: Get your feet wet with the specification's underlying terms and concepts (August 2003)

Part 2: The Portlet API's reference implementation reveals its secrets (September 2003)

 
duzou
关注
  • 0
    点赞
  • 踩
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
eclipse+tomcat开发portlet
05-14
在这个文件中，添加`<Context crossContext="true" />`，其中`crossContext`属性设为`true`，允许portlet与同一应用中的其他组件交互，满足Plutoportlet容器的要求。 5. **实现portlet接口**： 创建名为`...
jsr168 portlet(struts2+spring2.5+hibernate3.3)（转载）
04-22
【标题】"jsr168 portlet(struts2+spring2.5+hibernate3.3)" 是一个基于Java技术栈的Web应用程序开发示例，它利用JSR168规范来创建portlet，同时结合了Struts2、Spring2.5和Hibernate3.3这三大框架，为构建可重用、...
Eclipse 中使用Pluto开发portlet
moneyding的专栏
02-08 5638
[pre]使用Eclipse plus Pluto开发你的第一个与JSR168兼容的PortletBy Terry.liSpiritSeekerS@sqatester.com[/pre]本文将介绍开发基于Portlet Specification v1.0 (JSR168) 的Portlet应用.  我们使用Pluto作为Portlet Container和Portal. 同时可以将开发的Port
eclipse debug apache pluto 1.0 portal
王星乐的博客
12-03 667
（1）、tomcat的server.xml中加入： （2）、pluto的pageregistry.xml中加入： Calendar Calendar Example
使用eclipse和pluto开发和测试portlet
popoer
09-27 152
预备软件: Eclipse Europa 3.3 Pluto 1.1.4 Maven 2.0.7 Xdoclet 1.2.3 M2Eclipse Doclipse 环境设置 eclipse\pluto\xdoclet解压到指定目录即可 下载maven，解压到一个目录，设置环境变量JAVA_HOME...
使用Eclipse plus Pluto开发你的第一个与JSR168兼容的Portlet（三）
毛里求斯的化石的专栏
08-10 1610
By Terry.lee SpiritSeekerS@sqatester.com           本部份将讲述PortletConfig对象及其PortletContext对象的概念及应用.  PortletConfig对象和ServletConfig对象类似, PortletConfig对象提供Portlet初始的所需的参数及其对PortletContext
终于成功地在Pluto中部署了一个Portlet了
weixin_33763244的博客
05-13 132
　　开源的工程就是懒，Apache的Pluto是一个简单的符合JSR168规范的Portlets容器，网站上寥寥数笔，很多东西都没说清楚，连个API参考文档都找不到。甚至到现在从源代码来编译也没成功！只好用网站上提供的二进制版本（因为Pluto是借助Tomcat服务器的，这样原来的安装的一个Tomcat只好停掉）。Pluto本身不足以用来创建门户（Portal）网站，但可以用来测试自己的Portl...
Struts2 + Pluto + portletV1.0(JSR 168) CRUD Demo
03-17
JSR 168是Java Portlet API的第一个版本，它定义了portlet的接口和生命周期，使得portlet可以嵌入到任何支持该规范的portlet容器中。Portlet的主要功能是在portlet容器中提供独立的、可重用的UI组件。在本示例中，...
Pluto 简单的实例包含数据库连接和源码
01-08
Pluto 简单的实例包含数据库连接和源码 Pluto 入门学习必备啊
Apache Pluto Portal 学习文档
02-21
Apache Pluto Portal 文档说明 简单易懂 适合初学者
解决pluto的两个中文问题
03-06
博文链接：https://popoer.iteye.com/blog/163568
pluto+portlet实例
03-26
不会让你失望的实例，我研究了1周才弄明白，里面内置pluto2.0.3 + portlet项目 使用于pluto 和 portlet的初学者 。 往eclipse里面配置的时候一定要按照里面图片那样配置一下。
Eclipse基本配置01
Pluto___的博客
11-01 599
Eclipse showView添加Server新装完Eclipse裸编辑器时，仅仅只能运行java文件，像在本地运行项目需要“tomcat”服务器运行，以下记录如果添加Server选项. 新装完Eclipse裸编辑器时，仅仅只能运行java文件，像在本地运行项目需要“tomcat”服务器运行，以下记录如果添加Server选项. 1.点击“Help–&gt;InstallNew Software”...
Portlet with Apache Pluto 实践（一）---感受portlet
普善园
07-07 367
Portlet with Apache Pluto 实践（一）---感受portlet 概述 Apache Pluto 是 JSR-168 和JSR-268的参考实现（pluto 2.0基于JSR-268（Java Portlet Specification V2.0），之前的版本基于JSR-168（Java Portlet Specification V1....
(Portal 开发读书笔记）PortletFileUpload
weixin_34270865的博客
04-25 107
Portlet 也可以上传文件，它用的是apache commons-fileupload的PortletFileUpload类 也在commons-fileupload.jar 包里面 publicclassPortletFileUploadextendsFileUpload{publicstaticfinalbooleanisMultipar...
(Portal 开发读书笔记) 处理资源 ResourceServingPortlet
weixin_33812433的博客
04-30 62
ResourceServingPortlet是从Portlet 2.0才引入的接口，如果使用了它，就没有必要使用servlet来处理资源或者处理Ajax请求了。 publicabstractinterfaceResourceServingPortlet{publicabstractvoidserveResource(ResourceRequestpar...
pluto启动分析
yanghw0510的专栏
03-01 2537
 web.xml中         contextConfigLocation        /WEB-INF/pluto-portal-driver-services-config.xml    和         org.springframework.web.context.ContextLoaderListener      负责加载pluto的portal的服务，
Portal应用点滴（二） —— Portlet简介
perhaps
09-23 88
        在昨天的Post中，偶已经对Portal进行了简单的介绍，不知道各位对Portal是不是有一点点认识了呢？如果还是云里雾里的话也没有关系，毕竟Portal所涵盖的内容是很广博的，掌握它需要时间，了解也是需要时间的。在初步介绍了Portal的概念之后，今天我们来探讨一下Portal的核心——Portlet。        首先，Portlet在表现形式上就是我们所看到的页面上一个个小...
eclipse免安装版64位（专业的Java 开发工具 2018版本）
最新发布
dafenqileguai的博客
08-11 295
eclipse是一个开放源代码的、基于Java的可扩展开发平台。就其本身而言，它只是一个框架和一组服务，用于通过插件组件构建开发环境。
JSR168 Portlet开发详解：难点与案例分析
Portlet开发高层设计文档主要关注基于JSR168标准的Portlet开发，这是一个用于构建可重用、可插拔的应用组件的Java规范。文档首先从项目概述开始，对产品进行了深入分析： 1. 项目概述： - 产品分析：文档对比了几...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值