JSR-168 Portlet指南.doc
5星 · 超过95%的资源 需积分: 9 12 浏览量
2007-09-09
17:09:26
上传
评论
收藏 44KB DOC 举报 
摘要
JSR-168 是适合于 portlet 开发人员的 Java API 集合。设计符合规范的 JSR-168 portlet 的原
因有很多。可移植性就一个显而易见的好处。根据规范编写的代码更容易在门户服务器之间移动。
多数基于 Java 的门户服务器都支持 JSR-168 portlet。
另一个好处是更易于联合。当 portlet 符合 JSR-168 规范时，通过 Web Services for Remote
Portlets (WSRP)生产者公开 JSR-168 Portlet 会更容易一些。WSRP 提供了一个通过 Web service
联合 portlet 内容的标准。JSR-168 和 WSRP 1.0 portlet 功能是紧密耦合的。JSR-168 to WSRP
portlet 桥利用 JSR-168 的 URL 重写 API。本文将阐述开发 JSR-168 portlet 以便获得可移植性的
最佳实践。
1. 总是利用 URL 重写 API，以获得 Portlet 中的内容
Java 开发人员经常在如下所示 JSP 中编写图像的 URL：
<img src="/<%= request.getContextPath()%>/images/logo.gif"/>
这在 JSR-168 portlet 中是不正确的。正确的方法是：
<img src="<%= renderResponse.encodeURL(renderRequest.getContextPath()+
"/images/logo.gif") %>"/>
encodeURL()方法可以采用完全路径 URI 或者完全限定 URL。完全路径 URI 是最常用的。在
使用 JSR-168 portlet 将资源嵌入 Web Application Archive (WAR)中时，可以使用此技术。在将图
像放置到单独服务器上时，可以使用完全限定 URL。专门为静态内容提供服务的缓存服务器就是
一个示例，它卸掉来自门户服务器的通信量。尽管可以通过对完全限定 URL 使用 encodeURL()来
引用 portlet 以外的内容，但应该只在无法通过客户机访问资源时这样做。如果客户机可以直接浏
览资源，则无需对 URL 使用 encodeURL()。例如，如果有一台 Web 服务器，可用该服务器获得
门户用户无法直接浏览的防火墙内的静态内容，则需要调用 encodeURL()。如果这些内容在防火
墙之外，并且门户用户可以直接浏览到 Web 服务器，则无需调用 encodeURL()。
2. 不要将路径附加到重写 URL 中
传入 RenderRequest 的 encodeUrl()方法中的 URL 在调用该方法之前必须是完整的。在调用
该方法之后，无法添加 URL 的某些部分。例如，如果想从 XSLT 转换中生成一个 URL 转换，则不
能将已编码的基本 URL(http://foo.com/)作为参数传递，并将路径(pages/bar.jsp)附加到该转换中
的已编码基本 URL 中。
以下调用演示了将 URL 编码到图像中的正确方式：
<@= renderResponse.encodeURL(renderRequest.getContextPath()+
"/images/logo.gif")@>
它使用一个.portal 文件在 BEA WebLogic Portal 9.2 中生成以下 HTML 片段：
<img src="http://localhost:7001/PortalWebApp/images/logo.gif;
资源评论
wangdflx2012-01-29只有主要的片段，如果上传整本pdf书就好了
