文章
数字化体验
|
|||
|
安装 Oracle JDeveloper 开发 WebCenter Portal 资产
作者：Mitchell Palski
配置开发环境，从 Oracle WebCenter Portal 下载资产，然后将它们上载到 Oracle JDeveloper 进行维护或增强。
2013 年 4 月
下载
Oracle JDeveloper
Oracle WebCenter Portal
Oracle WebCenter Portal 的往返开发特性让您可以简单、方便地创建和修改 Oracle WebCenter Portal 资产，无需重新部署整个应用程序。往返开发指的是，使用这些特性和技术，您可以从 Oracle WebCenter Portal 下载资产，然后将它们上载到 Oracle JDeveloper 进行维护和增强。资产一经修改，您就可以将其上载回到 Oracle WebCenter Portal 立即进行使用或测试。
在本文中，您将了解如何针对 Oracle WebCenter 11.1.1.8 搭建开发环境。
本文中的示例所使用的环境安装并运行 Oracle WebLogic Server、Oracle WebCenter Portal 和 Oracle WebCenter Content。
在安装了 Windows 7 操作系统的笔记本电脑上安装 Oracle JDeveloper。
JDeveloper 安装和配置
- 下载并安装 JDeveloper 11.1.1.7
- 截至 2013 年 9 月 26 日，这是最新版本的 JDeveloper，支持针对 Oracle WebCenter Portal 11.1.1.8 进行资产开发
- JDeveloper 11.1.2.X.X 版不支持 WebCenter 开发
JDeveloper 的安装路径：C:\Oracle\Middleware\11117
本文将引用该路径，可能与您的安装路径不同。
- 打开 JDeveloper。
- 安装 Oracle WebCenter 11.1.1.8 Portal Extension for JDeveloper。
- Help —> Check For Updates
- 搜索 Oracle WebCenter Portal 扩展（11.1.1.8.0 版）
- 选择该扩展，然后单击 Finish
- 重新启动 JDeveloper
- 从 OTN 下载门户资产开发工作区：
- http://download.oracle.com/otndocs/tech/webcenter/files/DesignWebCenterSpaces_11.1.1.8.0.zip
- 该文件夹是一个 JDeveloper 应用程序，您将它连接到 WebCenter 实例直接进行下载和上载。
该 ZIP 文件下载到：C:\Users\MPALSKI\Downloads。
下文将引用该路径。 - 将 DesignWebCenterSpaces_11.1.1.8.0.zip 解压缩到 C:\Users\MPALSKI\Downloads\DesignWebCenterSpaces_11.1.1.8.0
- 将工作区 WLST 脚本复制到 JDeveloper 实例。
- 导航至： C:\Users\MPALSKI\Downloads\DesignWebCenterSpaces_11.1.1.8.0\copy_to_common\common
- 选择 script_handlers 和 wlst 文件夹并进行复制
- 导航至： C:\Oracle\Middleware\11117\oracle_common\common
- 将这两个文件夹粘贴到 common 目录下，替换现有的 script_handlers 和 wlst 文件夹（图 1）。
图 1
- 将工作区 JAR 文件复制到 JDeveloper 扩展库。
- 导航至： C:\Users\MPALSKI\Downloads\DesignWebCenterSpaces_11.1.1.8.0\copy_to_jdev_ext
- 右键单击，复制 oracle.webcenter.portal.jar
- 导航至： C:\Oracle\Middleware\11117\jdeveloper\jdev\extensions
- 将 oracle.webcenter.portal.jar 重命名为 oracle.webcenter.portal_old.jar。
- 将 oracle.webcenter.portal.jar 粘贴到文件夹中（图 2）。
图 2
- 将工作区复制到 JDeveloper 文件夹中。
- 导航至： C:\Users\MPALSKI\Downloads\DesignWebCenterSpaces_11.1.1.8.0
- 复制 DesignWebCenterSpaces 文件夹。
- 导航至：C:\JDeveloper\mywork。
- 注意，这与您的 JDeveloper 安装文件夹不同。
- 将工作区粘贴到 mywork 文件夹中。
- 重启 JDeveloper。
- 关闭 JDeveloper
- 重新打开 JDeveloper
工作区配置
- 打开工作区：
- 打开 JDeveloper
- 导航到 File —> Open
- 导航到 C:\JDeveloper\mywork\DesignWebCenterSpaces
- 选择 DesignWebCenterSpaces.jws
- 单击 Open 按钮。
- 打开连接属性文件：
- 展开 WebCenterSpacesExtensionLibrary
- 展开 Resources
- 展开 WebCenterSpacesExtensionLibrary
- 双击 config.properties 打开该文件（图 3）。
图 3
- 设置连接属性：
- 按照该文件中用绿色显示、以 # 为前缀（所以被注释掉）的说明进行操作。
- 为便于参考，以下是一些示例值：
- jdeveloper.install.home.directory=C:\\Oracle\\Middleware\\11117
- wlst.executable=wlst.cmd
- extending.spaces.home.dir=C:\\JDeveloper\\mywork\\DesignWebCenterSpaces
- oracle.jdeveloper.ojdeploy.path=${jdeveloper.install.home.directory}/jdeveloper/jdev/bin/ojdeploy
- wls.port=7001
- wls.host=<IP 地址>
- wc.port=8888
- wc.host= <IP 地址>
- wc.protocol=http
- 创建用户密钥和用户配置文件：
- 导航到 wlst.cmd 文件
- C:\Oracle\Middleware\11117\oracle_common\common\bin
- 双击 wlst.cmd
- 连接到管理服务器
- connect('weblogic','welcome1','<IP address>:7001')
- 输入以下命令
- storeUserConfig('C:/myFiles/myuserconfigfile.secure', 'C:/myFiles/myuserkeyfile.secure')
- 出现提示时，输入 Y，然后按 Enter（图 4）。
- 导航到 wlst.cmd 文件
图 4
- 填写连接属性：
- wls.userkey=C:\\myFiles\\myuserkeyfile.secure
- wls.userconfig=C:\\myFiles\\myuserconfigfile.secure
- wls.target=WC_Spaces,AdminServer
- wls.webcenter.app.target=WC_Spaces
- webcenter.app.name=webcenter
- restart.implementation.version.suffix=2
- restart.implementation.version.suffix.ear=2
- 测试连接：
- 导航至 WebCenterSpacesResources\Web Content\oracle\webcenter\siteresources\scopedMD\s8bba98ff_4cbb_40b8_beee_296c916a23ed\navigation\gsra789be69_045e_40dc_9884_c9d30e78a90b\Navigation.xml
- 右键单击 Navigation.xml
- 选择 Upload Portal Resource to server…（图 5）。
图 5 - 输入您的管理员用户名和口令。默认值为（图 6）：
- Username：weblogic
- Password：welcome1
图 6 - 将显示确认对话框（图 7）：
图 7
下载资产
- 在 Navigator 中，右键单击 WebCenterSpacesResources 项目，然后选择 Download Portal Resource from Server。可能会提示您输入用户名和口令。
图 8 - 在 Download Portal Resources 对话框中，选择下载一个共享资产 (Application-Level Resource) 或门户资产 Portal-Level Resource)。
- 要筛选可能的资产名称列表，请从 Resource Type 菜单中选择您要下载的资产类型（图 9）。
图 - 最后，从 Resource Name 菜单中选择您要下载的资产名称。
- 单击 OK 按钮。将显示一个进度条，然后将显示确认信息（图 10）。
图 10 - 您可以查看日志文件，确认下载成功完成。您的日志文件应类似于图 11。
图 11 - 您选择的资产现在将出现在 JDeveloper 项目中。在以下示例屏幕截图中，下载了一个 Page Template（图 12）。
图 12 - 为了确保您查看的是刚下载的资产，请右键单击资产并选择 Update Portal Resource（图 14）。显示名称将与您在下载期间选择的 Resource Name 匹配（本节中的第 3 步）。
图 13 - 单击 Cancel 关闭对话框，返回您的项目进行资源开发。
在 JDeveloper 中编辑 Portal 资源
要详细了解如何构建资产，请阅读 Oracle WebCenter 文档的相应章节：
- 页面模板 — 开发页面模板
- 页面样式 — 开发页面样式
- 皮肤 — 开发皮肤
- 导航 — 开发导航模型
- 内容展示区显示模板 — 创建内容展示区显示模板
- 资源目录 — 开发资源目录
- 任务流样式 — 开发任务流样式
备份资源
有时，您可能想创建门户资产的一个备份副本。例如，上载新版本之前对门户资产进行备份是明智的选择，这样可以应对开发过程中出现的意外结果。
门户资源保存为 EAR 文件。要保存一个门户资产副本，请执行以下步骤：
- 导航至 Administration 页面。
- 在顶部导航中选择 Shared Assets。
- 从左侧导航中选择一个资产类别。
- 导航至您要备份的资源，右键单击并选择 Download（图 14）。
图 14 - 在 Download 对话框中，单击 Download 将 EAR 文件保存到本地计算机（图 15）。
图 15 - 现在，您成功地备份了该门户资源。
恢复备份
要恢复资源的备份副本，只需返回 Administration 界面，使用 Upload 按钮导入您下载的备份 EAR 文件（图 16）。
图 16
替换 JDeveloper 中已经编辑的资产的副本：
- 右键单击该资产并选择 Delete（图 17），删除已导入 JDeveloper 的资产。
图 17 - 执行本文中的步骤，将 WebCenter 中的资源下载到您的 JDeveloper 项目。
总结
Oracle WebCenter Portal 为工具知识型员工和开发人员提供了相应的工具，可以快速、轻松地创建门户、内联网、外联网和自助应用程序，从而让用户可以更加有效、高效地访问信息、业务应用和流程并与之进行交互。可以使用基于浏览器的工具和 JDeveloper 对 Oracle WebCenter Portal 进行定制。
可以使用 JDeveloper 开发可在 Oracle WebCenter Portal 中部署和使用的组件。组件包括 ADF 任务流、数据控件、托管 bean 以及其他资产，如皮肤、页面样式、任务流样式、页面模板、内容呈现显示模板、导航和资源目录。
JDeveloper 和 Oracle WebCenter Portal 之间可以直接进行上载/下载，让开发团队可以更加快速、轻松地进行迭代资产开发。
通过将门户资产作为 EAR 文件下载的间接过程，开发团队先备份门户资产，然后将新版本部署到环境中。
关于作者
Mitchell Palski 是一个 Oracle WebCenter 售前顾问，主要与美国中大西洋和东北地区的州和地方政府机构打交道。加入 Oracle 之前，Mitchell 曾担任 Booz Allen Hamilton 的软件开发顾问，他在该公司作为 Oracle WebCenter（Portal 和 Content）实施团队的一员为美国军方提供服务。Mitchell 的专业技术领域包括 Web 开发（HTML、CSS、JavaScript）、Java 应用程序开发和敏捷项目管理方法。
Printer View