第三节  Portal的对象

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

3.3.1  Request对象

Portlet中的Request与Servlet的Request一样接受客户端发送的请求，但是与Servlet不同，Portlet的Request分为Action Request及Render Request两种类型，因此Portlet接口中定义了两种方法用来处理不同的Request。分别是processAction(ActionRequest request，ActionResponse response) 和render(RenderRequest request，RenderResponse response)，分别用以处理Action Request和Render Request。某种意义上来讲，render方法类似Servlet中的service方法，doView，doEdit，doHelp方法又类似doGet，doPost方法。

①、RenderRequest和ActionRequest

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

使用actionURL：

<%

PortletURL pu = renderResponse.createActionURL();

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

%>

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

使用renderURL：

<%

PortletURL pu=renderResponse.createRenderURL();

Pu.setParameter("PAGE"，Number);

%>

下一页

②、renderURL和actionURL的处理方式

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

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

③、RenderRequest和ActionRequest的parameter参数作用范围

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

public void processAction(ActionRequest req，ActionResponse res){

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

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

}

public void doView(ActionRequest req，ActionResponse res){

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

}

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

3.3.2  Response对象

与Request对象一样，Response对象也有两种：RenderResponse和ActionResponse，分别用来封装对应的RenderRequest和ActionRequest的返回信息，比如重定向、窗口状态、Portlet模式等。他们两者的父类PortletResponse拥有serPorperty和getPorperty两个方法，用来传递信息给Portal容器。

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

a、  重定向

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

c、  传递parameter参数到RenderRequest中去

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

a、  设置ContentType

b、  得到OutputStream和Writer对象，用来输出页面内容

c、  Buffering缓冲

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

3.3.3  PortletConfig对象

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

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

3.3.4  Session对象

由于容器不同，Portal的Session对象与Servlet的Session对象略有不同。

由于Portlet处于Portal服务器的缘故，Portlet的Session分为Application Scope和Portlet Scope。两者的区别在于：

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

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

但是对于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对象只是用来存取简单的配置信息，并不能完全替代数据库应用。

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

PortletPreference p= req.getPortletPreferences();

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

p.store();

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

可以在Portlet.xml中配置Preference信息，如下：

    educhina。username

    educhina

    true

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

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