Portlet 对象详解.docVIP

1、Portlet Request URL 在一个 Portal 页面中，通常都包含了多个 Portlet ，在一个时刻用户只能与一个 Portlet 交互，当用户向一个 Portlet 发出请求（例如点击了“ submit ”按钮），整个 Portlet 页面将会重新构成。在这个过程中，是否有与用户交互的 Portlet 处理方式显然是不同的，而且用户没有与之交互的 Portlet 显然不应该接收到用户的请求参数。　 因此 JSR168 规范中将对 Portlet 的请求分为 Action 和 Render 两种。 Portlet 在收到 Action 请求，获取用户所提交的信息，进行相应的处理；受到 Render 请求后，则生成页面代码。当用户向一个 Portlet 发出请求，该请求被 Portlet 容器接受， Portlet 容器再调用相应 Portlet 的 processAction() 方法；等到 processAction() 方法执行完毕后， Portlet 容器再调用所有 Portlet 的 render() 方法，并将这些方法所返回的内容组合形成一个页面返回给客户端。在上述过程中，所有 Portlet 的 render() 方法的调用次序在规范中没有规定，既可能是有顺序的串行调用，也可能是多线程的同步调用，依赖于厂商的具体实现。为了接受用户请求，一个 Portlet 需要有一个指向其自身的 URL ，例如用在 HTTP FORM 的 ACTION 字段。但是与 Servlet 不同的是， Portlet 不是一个完整的页面而只是页面的一部分，一个 Portlet 可以出现在多个页面中，所以 Portlet 无法绑定具体的 URL 。在 JSR168 规范中定义了 PortletURL 接口，通过该接口可以得到指向 Portlet 自身的 URL ，对应两种用户请求有两种产生 URL 的方法： q?4k2@*v_rk*l一、for render(): PortletURL url = response.createRenderURL(); S A(`L v(surl.setParameter(“customer”,””); url.setParameter(“show”,”summary”); !g{f#vk^writer.print(“A HREF=\””+url.toString()+”\”Summary/A”); 4x
_kUS/^![二、for processAction(): `kT
i3OPortletURL url = response.createActionURL(); url.setParameter(“paymentMethod”,”creditCardInProfile”); url.setWindowState(WindowState.MAXIMIZED); 1xp VfHwriter.print(“FORM METHOD=\”POST\” ACTION=\””+ url.toString()+”\””); (r/aI iI(v/i　　上面的代码我们可以看到，除了得到 URL 外，还可以在其中加入参数。另外由于 Portal 服务器厂商通常都会利用 URL 增加一些产品相关的参数，因此强烈建议在 Portlet 中提交用户请求采用 POST 方式。 2、 Portlet Modes Window States在 Portal 应用中，用户通常需要设置、调整 Portlet 的显示方式，对此 JSR168 同样做出了规定。分别有 Portlet Modes 和 Window States 。Portlet Modes 说明 Portlet 目前所执行的功能模式，规范要求 Portal 服务器必须支持以下三种模式： \ k6k7c
Wk)e-[_lj rqsIqVIEW ——内容显示，通常为缺省模式 EDIT ——编辑相关的设置 HELP ——显示帮助信息 除此之外可以Portal服务器可以实现自定义的模式。portal爱好者0XLqXP5iv J每个 Portlet 在 Portal 页面中就是一个“窗口”，类似于 MS Windows 、 XWindo 等窗口系统 Portlet 也有自己的窗口状态（ Window States ），规范要求 Portal 服务器必须支持以下三种窗口状态 ： NORMAL ——普通 portlet 窗口，在这个状态下通常是与其它 Portlet 共享 Portal 页面； portal爱好者
t8u/O/F;FMAXIMIZ