随笔-86  评论-767  文章-3  trackbacks-3

第三节  Portal的对象

JSR168Portal定义了几个特别的对象,用来操作Portal特有的信息。这些对象跟Servlet的对象有点类似,又有点不同。这些对象都封装在{PORTAL_HOME}/common/lib/ext/portlet.jar包中,具体支持实现要视Portal服务器而定。

3.3.1  Request对象

Portlet中的RequestServletRequest一样接受客户端发送的请求,但是与Servlet不同,PortletRequest分为Action RequestRender Request两种类型,因此Portlet接口中定义了两种方法用来处理不同的Request。分别是processAction(ActionRequest requestActionResponse response) render(RenderRequest requestRenderResponse response),分别用以处理Action RequestRender Request。某种意义上来讲,render方法类似Servlet中的service方法,doViewdoEditdoHelp方法又类似doGetdoPost方法。
图3.3.1–1.jpg图3.3.1–2.jpg图3.3.1-3.jpg

RenderRequestActionRequest

PortletRequest分为RenderRequestActionRequest两种,分别由renderURLactionURL来触发。renderURLactionURL的一种优化。Portlet的开发过程中尽量使用renderURL而避免actionURLactionURL适用于有确实的Action(行为)的情况下。比如说,表单form提交后Persistent状态的改变、session的改变、perference的修改等等。renderURL通常用来处理Portlet的导航。举个例子:

使用actionURL

<%

PortletURL pu = renderResponse.createActionURL();

pu.setParameter("ACTION""LOGIN");

%>

说明:表单提交最好使用Post方法而不是Get方法,因为某些Portal服务器可能会将内部状态编码到URLQuery字符串中。

使用renderURL

<%

PortletURL pu=renderResponse.createRenderURL();

Pu.setParameter("PAGE"Number);

%>

下一页

renderURLactionURL的处理方式

当客户端请求是由一个renderURL触发的时候,Portal服务器会调用该Portal页面所有Portletrender方法。

而当客户端请求是由一个actionURL触发的时候,Portal服务器会先按用该页面所有PortletprocessAction方法再调用render方法。所以,要明确自己到底使用那种URL来出发客户端请求。

RenderRequestActionRequestparameter参数作用范围

当客户端请求由一个actionRequest触发时,所有parameter参数的取得都必须在processAction方法中进行。比如:

public void processAction(ActionRequest reqActionResponse res){

       String str = req.getParameter("ACTION");

       //response.setRenderParameter("ACTION"action);

}

 

public void doView(ActionRequest reqActionResponse res){

       String str = req.getParameter("ACTION");

}

如上processAction方法中,getParameter方法将能成功得到表单中的参数ACTION所对应的值,因为我们知道,当目标PortletprocessAction方法运行完后,Portlet Container将调用Portal页面中所有Portletrender方法.但是实际上doView方法中使用getParameter不会得到任何值.但是如果把processAction方法中注释了的一行解除注释的话,你就可以在doView方法中的得到参数ACTION对应的值. 这说明action request的参数,render方法中不可以直接取到.必须使用了setRenderParameter方法,再次传递一次.

3.3.2  Response对象

Request对象一样,Response对象也有两种:RenderResponseActionResponse,分别用来封装对应的RenderRequestActionRequest的返回信息,比如重定向、窗口状态、Portlet模式等。他们两者的父类PortletResponse拥有serPorpertygetPorperty两个方法,用来传递信息给Portal容器。
图3.3.2-1.jpg图3.3.2-2.jpg图3.3.2-3.jpg

ActionResponse主要用来处理以下功能:

a、  重定向

b、  改变窗口状态、Portlet模式

c、  传递parameter参数到RenderRequest中去

RenderResponse主要用来提供以下功能:

a、  设置ContentType

b、  得到OutputStreamWriter对象,用来输出页面内容

c、  Buffering缓冲

d、  设定Portlet的标题,但是必须在Portlet输出前调用,否则将被忽略

3.3.3  PortletConfig对象

ServletConfig对象类似,PortletConfig对象提供对Portlet初始化信息以及PortletContext对象存取的方法。

ServletConfig对象不同的是,PortletConfig对象提供对Portlet的标题等资源的I18N支持,可以通过设定不同的Resource Bundle文件以提供多种语言支持。

3.3.4  Session对象

由于容器不同,PortalSession对象与ServletSession对象略有不同。

由于Portlet处于Portal服务器的缘故,PortletSession分为Application ScopePortlet Scope。两者的区别在于:

Application Scope范围的Session中保存的对象,对于同一个Portlet应用范围内的所有Portlet都是可用的。

Portlet Scope范围的Session中保存的对象,只对本Portlet可用,其他Portlet即使在同一个应用中,也不可用。

图3.3.4-1.jpg

但是对于Portlet应用来说,可以通过HttpSession来访问。毕竟Portlet应用也是Web应用。在使用Session对象的时候,最好能明确指出使用的是那个Scope范围的Session。比如:

NORMAL" PortletMode="view" var="pu1">

 

NORMAL" PortletMode="view" var="pu2">

这个JSP创建了两个ActionURL,分别产生了两种PortletSession对象。

PortletSession ps = req.getPortletSession();

if(ps.getAttribute("PortletSession.AS"PortletSession.APPLICATION_SCOPE)!=null){

       app=ps.getAttribute("PortletSession.AS"PortletSession.APPLICATION_SCOPE).

toString();

}

if(ps.getAttribute("PortletSession.PS"PortletSession.PORTLET_SCOPE)!=null){

       Portlet=ps.getAttribute("PortletSession.PS"PortletSession.PORTLET_SCOPE).

toString();

}

以上代码根据需要取得不同Scope范围的Session对象值。

同一个应用下,可以直接通过ServletSession取得PortletSession.APPLICATION_SCOPE范围下的Session对象值。

HttpSession se = request.getSession();

if(se.getAttribute("PortletSession.AS")!=null){

       app=se.getAttribute("PortletSession.AS");

}

3.3.5  Preference对象

Preference对象被设计用来实现用户的个性化设置,可以帮助用户对Portlet进行符合用户需求的显示定制和行为定制,可以替代部分的数据库功能。需要指出的是,Preference对象只是用来存取简单的配置信息,并不能完全替代数据库应用。
图3.3.5-1.jpg

Preference对象对于配置信息采用键-值的形式存取,用户可以将需要的信息暂时保存在Preference中。

PortletPreference p= req.getPortletPreferences();

p.setValue("educhina.username""educhina");

p.store();

       Preference对象用来存取用户的个性化信息,所以不同用户的Preference对象不能共享,这点跟Session不同。

可以在Portlet.xml中配置Preference信息,如下:

 

    educhinausername

    educhina

    true

 


另外,还可以配套使用PreferencesValidator对象,对PortletPreference在存储之前进行验证,以确保Preference的正确性。

具体规范可以参照http://java.sun.com/xml/ns/Portlet/Portlet-app_1_0.xsd 部分。

posted on 2005-10-21 09:17 eamoi 阅读(6033) 评论(2)  编辑  收藏 所属分类: Java

评论:
# re: 【原创】Liferay Portal二次开发指南(9) 2006-01-13 15:54 | kelo
麻烦问一下,您用的开发工具是什么?如是eclipse的话有插件吗?能否介绍一下环境的搭建。 bpmopq@163.com  回复  更多评论
  
# re: 【原创】Liferay Portal二次开发指南(9) 2007-04-19 03:45 | Tong
the article is very nice. It talked about most important aspects of the JSR 168 portlet. Very useful.  回复  更多评论
  

只有注册用户登录后才能发表评论。


网站导航: