广告：
网页制作参考
千千学园
雨路开发频道
雨路技术文档
技术问答
编程技术

JSR 168和Struts支持包使用指南

---

Download Now 8.4 MB

出品: BEA Systems 最后更新: 2003年7月15日 必要条件: WebLogic Portal 版本: 8.1

认证

---

这个包已经通过BEA系统认证。经过BEA认证的代码已经通过BEA内部开发人员的测试和验证，从而提供了质量保证。如果你对这个包或者代码库中任何针对WebLogic Portal 的经过BEA认证的包有任何的疑问或者建议，请发邮件至weblogic.developer.interest.portal 新闻组。


它能做什么

---

这个early-access版本包括支持用Portlet Specification(JSR168)的公众审议草案（public review draft）和Struts 1.1rc1开发的portlets的技术。


它怎样工作

---

Portlet Specification为portlet 开发者建立和部署portlet指定了一个标准编程模型。early-access版本提供了对这种技术的预览，让你可以用这个规范构建portlet，并部署到 WebLogic Portal 8.1上。要了解更多有关JSR168的信息以及该规范的公众草案（public draft） ，请参见http://www.jcp.org/en/jsr/detail?id=168。

这个版本还添加了对将struts应用程序作为portlet部署到WebLogic Portal 8.1上的支持。这使你可以很容易地在 WebLogic Portal上部署现有的Struts应用程序。早期访问实现是基于Struts 1.1rc1的。


如何运行该代码

---

警告：在尝试执行下面的安装指令之前，对这个过程中所有要修改的文件/目录复制副本。

下面的这些介绍将帮助你在WebLogic Portal 8.1安装Portlet API 和Struts 1.1的支持包。

这些步骤假设你已经安装了WebLogic Portal 8.1。
这些指令假定WebLogic Portal 8.1被安装在<WL_DIR>。比如，如果你将WebLogic Portal 8.1安装在 Windows的c:\bea\weblogic81目录下，那么<WL_DIR>指的就是c:\bea\weblogic81。

在开始之前

创建一个临时的dev2dev目录，并将那些附加的文件解压到那个目录中。

为WebLogic Portal 8.1提供的Portlet API支持包

按照下面的步骤为你的web应用添加Java Portlet API 1.0支持包。

1. 将dev2dev/lib/netuix_system.jar复制到WL_DIR/portal/lib/netuix/system/netuix_system.jar。
2. 将dev2dev/lib/web 目录下的所有文件复制到WL_DIR/portal/lib/netuix/web目录下。
3. 将下面的servlet 添加到文件web.xml中。
　<servlet>
　<servlet-name>com.bea.portlet.server.PortletHttpServer</servlet-name>
　<servlet-class>com.bea.portlet.server.PortletHttpServer</servlet-class>
　<load-on-startup>1</load-on-startup>
　</servlet>
4. 将下面的条目加入到文件weblogic.xml中。
　<jsp-descriptor>
　<jsp-param>
　<param-name>superclass</param-name>
　<param-value>com.bea.portlet.jsp.PortletJspBase</param-value>
　</jsp-param>
　</jsp-descriptor>
　对于用IDE创建的每一个portal web 项目，都要执行步骤3和步骤4。


为WebLogic Workshop 8.1提供的Portlet API支持包

　1. 将dev2dev/lib/wlw/portal-project.zip复制到WL_DIR>/workshop/templates目录下。
　2. 将dev2dev/lib/wlw/portalbuilder.jar复制到<WL_DIR>/workshop/extensions 目录下。


为WebLogic Portal 8.1提供的Struts 1.1 支持包

为了使用struts应用程序中的内容，现在可以在portlet中使用一种新的StrutsContent元素。这种支持包是基于Struts 1.1rc1的，还包括修订后的struts.jar以及对其他WebLogic Portal 8.1 jar文件的更新。

为了允许在portlet中使用Struts 1.1应用程序，请遵循下面的步骤：

1. 将dev2dev/lib/netuix_system.jar复制到WL_DIR/portal/lib/netuix/system/netuix_system.jar。
2. 将dev2dev/lib/web/netuix_servlet.jar复制到webapp的WEB-INF/lib 目录中。
3. 将dev2dev/lib/web/struts.jar复制到webapp的 WEB-INF/lib目录中。
4. 将struts应用程序复制到你的webapp中的新目录中。你所选择的放置struts应用程序的目录将成为用于portal中应用程序的struts模块路径。比如，如果你的struts应用程序目录是<WEB-APP>/struts/myExample，那么你的应用程序的模块就是/struts/myExample。
5. 将针对你的struts应用程序的struts-config.xml复制到WEB-INF目录中，根据以下模式对其进行重命名：
jpf-struts-config-<module>.xml
使用以上的示例，该struts配置文件将被命名为
pf-struts-config-struts-myExample.xml

使用这种命名规则允许用在 portal 中的行为 servlet动态地注册struts应用程序模块。如果你不希望使用该功能，你可以将你的struts配置文件改成你所希望的任何名称。但是你需要通过一个在web.xml中使用一个init配置参数来手动地注册这个名称。
6. 将下面的内容添加到struts的配置文件中： <controller processorClass="com.bea.wlw.netui.pageflow.PageFlowRequestProcessor"/>
7. 更新web.xml以定义 struts标记库。
8. 将你的struts 应用程序所需的任何java源代码放入WEB-INF/src中。
9. 创建一个struts portlet，这个struts portlet使用新的StrutsContent元素来定义模块和初始行为。这可以手工完成或者通过WebLogic Workshop 8.1中的Struts Portlet Wizard 完成。
10. 将struts添加到你的portal中。
11. 务必通过在netuix-config.xml中使用以下元素启用pageflow。
　<pageflow>
　<enable>true</enable>
　</pageflow>


示例

该发布包含一个示例webapp，这个webapp包含了几个示例portlet。按照下面的步骤部署这个webapp。
1. 将dev2dev/lib/netuix_system.jar复制到WL_DIR/portal/lib/netuix/system/netuix_system.jar。
2. 将目录dev2dev/lib/web下的所有文件复制到目录WL_DIR/portal/lib/netuix/web下。
3. 启动WebLogic Workshop，然后打开portal应用程序WL_DIR/samples/portal/portalApp/portalApp.work。这将打开portal应用程序。
4. 从"File"菜单中选择"Import Project"。选择针对这类项目的"Portal Web Project"。
5. 单击浏览按钮选择目录dev2dev/webapps/samples。输入该项目的名称（比如"samples"），然后单击"Import"。复制了若干文件后，Workshop将用对话框提示你更新该项目。单击"No"继续。
6. 从"Tools | WebLogic Server"子菜单中选择"Start WebLogic Server"以启动服务器。
7. 为了使用登录portlet成功地登录和注销，用WebLogic Server 控制台创建一个用户帐号。要获得更多的帮助请参见WebLogic Server文档。
8. 为了顺利地使用电子邮件portlet，用WebLogic Server 控制台创建一个邮件会话（用 IMAP作为协议）。这一步需要重启服务器。要获得更多帮助请参见WebLogic Server文档。
9. 启动了服务器后，将你的浏览器定位到http://localhost:7001/samples/samples.portal 以查看示例portlet。

你可以按照同样的过程将示例webapp导入一个新的WebLogic Server 域中的新WebLogic Workshop应用程序。

注意，为了得到与portlet相关的用户信息以便显示用户属性，你需要为你的应用程序添加用户属性集，要获得更多的细节请参见WebLogic Portal 文档。