内容


在 IBM Rational Application Developer 中创建和部署 Web Application Bridge 过滤器

Comments

概述

IBM Web Application Bridge(或 WAB)是在 IBM WebSphere Portal 页面中集成不同外部 Web 应用程序的一种原生特性,这使得 WebSphere Portal 成为了惟一的访问窗口。外部 Web 应用程序可以是在 Web 浏览器中打开的任何网站。

WAB 提供了一个名为 Virtual Web Application Manager 的界面。该界面可以帮助您:

  • 配置必须在门户内集成的 Web 内容来源或内容提供者站点(比如 Microsoft SharePoint 站点或任何外部网站)。来源是由 WAB 在门户页面内显示的外部 Web 内容。
  • 创建可以使用在前面的项目符号中提到的来源的 Web Dock 应用程序。然后,可以将应用程序放置在门户页面作为 portlet。

WAB 还提供了一个拦截机制,操纵向内容提供者站点发起的请求和来自该站点的响应。这个拦截机制以 Servlet 过滤器 API 为基础,可以用 Virtual Web Application Manager (VWAT) 接口进行配置。

有两种类型的 WAB:

  • Request 过滤器 将额外的信息添加到自 WebSphere Portal 向内容提供者站点发起的请求。 例如,它可能会将一个额外的页眉添加到从 WebSphere Portal 发起的请求,而且内容提供者站点可能相应地返回适当的响应。
  • Response 过滤器 操纵从内容提供者站点发给门户的内容。响应过滤器可能过滤站点的页眉和页脚,然后在 WebSphere Portal 页面中不显示该站点的页眉和页脚。

IBM® Rational® Application Developer for WebSphere 软件提供了一些工具来创建和部署 WAB Request 和 Response 过滤器。您可以创建针对各种 Portal 运行时创建 WAB 过滤器项目。本文向您展示了在 Rational Application Developer 中创建和部署响应过滤器的详细过程。您还将学习如何在门户中使用在 Rati​​onal Application Developer 中创建的过滤器。

先决条件

要执行本文中的步骤,您必须在计算机上安装:

  • IBM Rational Application Developer V9.1.0.1
  • IBM WebSphere Portal V8.5

您需要执行的任务包括:

  1. 在 Rational Application Developer 中创建一个 WAB 响应过滤器,并用删除示例站点的(在本例中是 http://www.ibm.com/in/en/ )页眉和页脚的代码更新它。
  2. 使用 VWAT 界面配置内容提供者站点。
  3. 创建将使用第 1 点中的内容提供者的应用程序 portlet。
  4. 将 portlet 放在门户页面,并检查输出。
  5. 应用在第 1 点中创建的过滤器。
  6. 再次检查输出。

创建 WAB Filter 项目。

第一项任务是创建一个 WAB 过滤器项目。完成该任务的所有步骤请参见图 1。在 Rational Application Developer 中:

  1. 选择 File > New > Project > Other > WAB Filter project。New WAB Filter Project 创建向导打开。
  2. 在 Project name 字段中键入 FilterProject
  3. 从 Target runtime 下拉菜单中选择 WebSphere Portal v8.5
  4. WAB Filter Settings 部分的文本框中,键入 Clipping Filter for Filter class。选中 Response Filter 作为 Filter type。
图 1. WAB 过滤器项目
WAB 过滤器项目创建向导
WAB 过滤器项目创建向导
  1. 单击 Finish。WAB 过滤器项目已创建,在 Java 编辑器中打开类 ClippingFilter,如图 2 所示。
图 2. 在 Java 编辑器中显示的过滤器代码
Java 编辑器显示过滤器代码
Java 编辑器显示过滤器代码

添加 WAB 过滤器自定义代码

创建过滤器后,添加自己的代码,以便过滤网站的页眉和页脚。 使用 WAB 将此信息显示在门户中。

  • 打开类 ClippingFilter
  • 找到方法 clipSections 并添加清单 1 中的代码行。
清单 1.clipSections 方法的自定义代码
//hide the header and footer
replacers.put( "div id=\"ibm-masthead\"" ,  "div id=\"header\" style=\"display:none;\"" );
replacers.put("div id=\"ibm-footer\"", "div id=\"footer\"style=\"display:none;\"");

在过滤器中,清单 1 中的代码将 id 为 ibm-mastheadibm-footer 的 div 容器的显示样式(如图 6 所示)设置为 display:none。这意味着 div 容器在最终响应中是不可见的。清单 2 显示了 clipSection 方法。

清单 2. 更新后的 clipSection 方法
private Map<String, String> clipSections(){  
  Map<String, String>  replacers  =  new  HashMap<String, String>(); 
 	 	 
//hide the header and footer
  replacers .put( "div id=\"ibm-masthead\"" ,  "div id=\"header\" style=\"display:none;\"" ); 
  replacers .put( "div id=\"ibm-footer\"" ,  "div id=\"footer\" style=\"display:none;\"" );  
 	     
     return   replacers ; 
  }

部署过滤器

现在已创建了所需的带有自定义逻辑的过滤器,下一步就是将过滤器部署到门户服务器,让您可以使用过滤器。部署过滤器:

  1. 右键单击项目 FilterProject 并选择选项 Deploy WAB Filter,如图 3 所示。
图 3. 部署 WAB 过滤器选项
WAB 过滤器部署选项
WAB 过滤器部署选项
  1. 如图 4 中所示的 Deploy WAB Filter 向导将会打开。
图 4. Deploy WAB Filter
WAB 过滤器部署向导
WAB 过滤器部署向导
  1. 选择您要使用的门户服务器。对于这篇文章,我们选择的是 WebSphere Portal v8.5 Server at localhost
  2. 单击 Finish

成功部署后,如图 5 所示的提示将会打开。

图 5. 部署完成通知
部署完成的通知
部署完成的通知

配置源内容提供者,并使用过滤器

在完成 WAB 过滤器的 创建部署 后,需要配置源内容提供者,以及一个使用源内容提供者的应用程序。 在这篇文章中,内容提供者站点的 URL 是:http://www.ibm.com/in/en/ ,图 6 显示了该站点。用绿色突出显示的部分代表被您所创建的过滤器类 ClippingFilter 裁剪的 div 容器。

图 6. 源内容提供者站点
内容提供者站点
内容提供者站点

配置源内容提供者站点

遵循以下步骤来配置源内容提供者站点:

  1. 在 Web 浏览器中打开门户站点,以管理员用户的身份登录。
  2. 在浏览器中,单击管理菜单中的选项 Portal User Interface,如图 7 所示。
图 7. Portal User Interface 选项
门户用户界面选项
门户用户界面选项
  1. 单击选项 Virtual Web Application Manager,如图 8 所示。
图 8. Virtual Web Application Manager
Virtual Web Application Manager 选项
Virtual Web Application Manager 选项
  1. 在所生成的页面上,单击 Content Provider Profiles 选项。
  2. 单击按钮 Create Content Provider Profile,如图 9 所示。
图 9. Create Content Provider Profile 选项
Create Content Provider Profile 选项
Create Content Provider Profile 选项
  1. Unique profile title 文本框中键入 IBM
  2. Host name or IP address 文本字段中键入 http://www.ibm.com,如图 10 所示。主机名称代表要从中提取内容的域。
图 10. 内容供应者配置文件值
内容供应者配置文件值
内容供应者配置文件值
  1. 单击 Save 按钮。如图 11 所示的内容提供者配置文件被创建。
  2. 单击 Add Policy 选项,如图 11 中突出显示的部分所示。图 12 中所示的页面将会打开。
图 11. Add Policy 选项
Add Policy 选项
Add Policy 选项
  1. Unique policy title 文本框中键入 IBM,如图 12 所示。
  2. 单击 Response 选项,如图 12 中突出显示的部分所示。
图 12. 输入策略详细信息
输入策略的详细信息
输入策略的详细信息
  1. Filters 部分中,单击选项 Insert Response Filter,如图 13 中突出显示的部分所示。
图 13. Response 选项卡
响应值选项卡
响应值选项卡
  1. Name 字段中键入 Clipping,并在 Value 字段中键入 com.ibm.filterproject.ClippingFilter,如图 14 所示。

    com.ibm.filterproject.ClippingFilter 是您在 Rational Application Developer 中创建的过滤器类的完全限定类名。
图 14. 指定过滤器
指定过滤器的选项
指定过滤器的选项
  1. 单击 Save。您在提供者配置文件中创建的策略将会打开,如图 15 所示。
图 15. 策略已添加
完成策略添加
完成策略添加

创建一个 Web Dock 应用程序

在配置 内容提供者配置文件 后,您需要创建一个使用来自该供应者的内容的 Web Dock 应用程序。在将它添加到门户页面后,就可以将它作为一个应用程序提供。要创建一个 Web Dock 应用程序:

  1. 单击位于 Content Provider Profiles 上方的 Web Dock Applications 选项,如图 16 中突出显示的部分所示。
图 16. Web Dock Applications 选项
Web dock 应用程序选项
Web dock 应用程序选项
  1. 单击 Create Web Dock Application 按钮,如图 17 所示。
图 17. Create Web Dock Application 按钮
Web Dock Application 按钮
Web Dock Application 按钮
  1. Web Dock Application UI 打开。图 18 显示了该应用程序所需的值。
    • 在 Unique web dock application title 文本框中键入 IBMApplication
    • 从 Content provider profile 下拉菜单中选择 IBM。
    • Resource path 文本框中键入 /in/en/
      备注
      资源路径表示您的 Web Dock 应用程序从中下载其内容的准确资源。该路径相对于您在 配置 内容提供者配置文件时所选定的主机。
图 18. Web Dock 应用程序创建 UI
为 Web dock 应用程序创建 UI
为 Web dock 应用程序创建 UI
  1. 单击 Save 创建 Web Dock 应用程序,如图 19 所示。
图 19. Web Dock 应用程序
创建 Web Dock 应用程序
创建 Web Dock 应用程序

使用 Web Dock 主题配置文件创建门户页面

在创建内容提供者配置文件并利用 Rati​​onal Application Developer 中创建的 WAB 过滤器的 Web Dock 应用程序后,您需要创建一个门户页面,将 Web Dock 主题配置文件应用到该门户页面。 Web Dock 主题配置文件有一组模块可与 Web Dock 应用程序配合使用。要创建一个门户页面和应用 Web Dock 主题配置文件到该页面,请遵循下列步骤,并在主页上开始执行这些步骤:

  1. 单击 Edit Mode
  2. 单击 Create,如图 20 所示。
图 20. 页面创建的选项
页面创建选项
  1. 单击 Page 链接,如图 21 所示。
    您会在右侧看到 Page Settings 部分。
  2. Page title 文本框中,输入 WABPortalPage,如图 21 所示。
  3. 单击 Create Page 按钮。新的页面被创建。
图 21. 新建页面对话框
新建页面对话框
新建页面对话框
  1. 单击 Page 打开页面选项卡。
  2. 单击 General
  3. 单击 Edit Page properties 选项。这三个步骤如图 22 所示。
图 22. 编辑页面属性对话框
编辑页面属性对话框
编辑页面属性对话框
  1. Manage Page properties 对话框将被打开,如图 23 所示。
图 23. Manage Page properties 对话框
管理页面属性对话框
管理页面属性对话框
  1. 单击 Advanced 选项卡,如图 24 所示。
  2. 将主题配置文件 Web Dock 应用到该页面,如图 24 突出显示的部分所示。
图 24. 应用 Web Dock 主题配置文件
应用 Web Dock 主题配置文件的选项
应用 Web Dock 主题配置文件的选项
  1. 单击 Save 按钮关闭 Manage Page Properties 对话框。

将 Web Dock 应用程序放进门户页面

请遵循以下步骤将 Web Dock 应用程序放入门户页面(步骤 3-6,如图 25 所示):

  1. 单击 Create 选项卡,如图 25 所示。
  2. 单击 Applications 选项。
  3. 在文本框中键入 IBMApplication 搜索您所创建的 Web Dock 应用程序。
  4. 单击 IBMApplication 缩略图中的 + 图标。
图 25. 添加 Web Dock 应用程序
在页面中添加 Web Dock 应用程序的步骤
在页面中添加 Web Dock 应用程序的步骤
  1. 消息 The application 'IBMApplication' has successfully been added to the page 'WABPortalPage' 将会出现,如图 26 中突出显示的部分所示。
  2. 单击如图 26 中突出显示的 X,关闭页面对话框。
图 26. 关闭页面对话框
关闭页面对话框的选项
关闭页面对话框的选项
  1. 来自 www.ibm.com/in/en 的内容显示在门户页面中。请注意,我们已从所生成的响应中去除了页眉和页脚,如图 27 所示。为了看到确切的差别,请比较图 27 与图 28(它显示了未过滤的响应)。
图 27. 最终结果
最终结果
最终结果
图 28. 未过滤的响应
未过滤的响应
未过滤的响应

结束语

本文中的步骤指导您完成了在 IBM Rational Application Developer V9.1 中创建和部署一个 WAB 过滤器的过程。本文还介绍了如何在门户中的 WAB 应用程序中利用过滤器。

要创建其他 WAB 过滤器,七情选中 WAB 过滤器项目,然后单击并选择选项 File > New > Others > WAB Filter,如图 29 所示。

图 29. 新建 WAB 过滤器向导的选项
新建 WAB 过滤器的选项
新建 WAB 过滤器的选项

如图 30 所示的新向导将会打开。

图 30. New WAB Filter 选项
New WAB Filter 选项
New WAB Filter 选项

关于示例应用程序

下载文件包含用于创建本教程的 Web Filter 项目应用程序。要使用示例,请将该文件导入您的 Rational Application Developer 工作区。

必须满足 先决条件 才能使用这个示例应用程序。


下载资源


相关主题


评论

添加或订阅评论,请先登录注册

static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=10
Zone=Rational
ArticleID=995186
ArticleTitle=在 IBM Rational Application Developer 中创建和部署 Web Application Bridge 过滤器
publish-date=01142015