使用定制技术领域扩展拓扑编辑器

IBM® Rational® Software Architect® 7.5 之中找到的部署结构工具,包含了不同技术领域内的建模元素,例如数据库、程序服务器以及 Java EE 程序。这些元素通常已经足够建模任意类型的电脑系统或者软件开发,但是如果您使用技术的领域,其中没有提供特定的建模元素,所以您可能想要创建通用单元以及功能。本文向您展示了怎样创建通用单元以及功能,您可以使用它,通过拓扑域生成工具箱来建模任意领域信息技术的构件。

André Zwanziger, 研究员, Otto-von-Guericke Universität Magdeburg

author photoAndré Zwanziger 是位于德国马格德堡的 Very Large Business Applications Lab 的一名研究人员。Zwanziger 的研究主题包括软件部署的规划和自动化。



Chad Holliday, IBM Rational 软件开发团队成员, IBM

Chad HollidayChad Holliday 是 IBM Rational Deployment Architecture Platform 团队的一名成员,并且是 Topology Domain Generator Toolkit 的创作者。Holliday 拥有位于 Urbana-Champaign 的 Illinois 大学的学士学位。



Sebastian Herden, 研究员, Otto-von-Guericke Universität Magdeburg

Sebastian HerdenSebastian Herden 是位于德国马格德堡的 Very Large Business Applications Lab 的一名研究人员。Herden 的研究主题包括软件部署的规划和自动化。



Tim McMackin, 技术作者, IBM

Timothy McMackinTim McMackin 是 IBM Rational 软件在北卡莱罗纳州 Raleigh 的一名技术作者。他有推广技术产品的写作背景,自从 2004 年就加入 IBM。



2010 年 7 月 23 日

引言

IBM® Rational® Software Architect 中包含的部署结构工具,随着一系列预定义的技术领域一起发布,以支持程序部署的规划。由于今天硬件、软件及介质巨大的数量,对可扩展平台的需求与日俱增。

扩展可用单元的一种简单方式,是复制并重命名通用单元,例如 Generic Software 单元。如果拓扑编辑器只用于部署建模,而且不需要创建对模型拓扑的进一步转化,那么这种方法已经足够了。但是,如果方法拓扑成为其他转变的基础(例如,配置文件或者安装脚本),那么这种方法就不够了,因为拓扑的结果 XML 代表太过通用,而扩展的元素也只能为命名习惯来识别,这可以是模糊的,而且不够强大。为了获取系列拓扑中的 XML 类型,您必须在平台中创建一个规范的域。拓扑域生成工具箱提供了一种直接的方式,来在拓扑文件中创建带有 XMl 类型的定制技术领域。

在本文中,我们将会呈现一幅真实世界的场景,并展示为拓扑编辑器使用扩展机制的简单方式,这使得您可以快速定义拥有 XML 类型的技术领域。


扩展部署结构平台

本文的总体场景是为 MySQL 数据库规划一个程序部署,这不是 Rational Software Architect 工具集所提供的一种域。这些域包括 DB2、Derby、以及通用的数据库单元,但是没有 MySQL。

创建新类型单元的一种方式是复制一个已存在的单元,并给其起一个能够表面不同类型单元的标题。例如,您可能重命名一个通用数据库单元,以使其看起来是一个 MySQL 数据库,如图 1 所示。

图 1. 重新为已存在单元换标签来创建新的单元
图表中一个可定制的通用单元

但是,该策略会创建一个单元,仅仅像是 MySQL 数据库构件;单元本身会保持原始单元的类型与属性。您可以对单元作出更改,以指示它的不同,例如对单元应用形式或者外观,但是这些更改都是很肤浅的;单元类型并没有得到更改。

建模一个新类型单元的更好方式,是创建一个拥有特定软件构件属性的 MySQL 数据库系统,并确保它对新类型的最大重复使用能力,您可以权衡可得到的已存在模型结构。

为了使用您自己的技术领域来扩展部署结构平台,您可以按照下面的步骤进行操作:

  1. 安装拓扑域生成工具箱。
  2. 为新技术领域创建一个 XML 方案定义。该方案定义定义了新技术领域想要的元模型,包含了域中可得的单元及功能类型。
  3. 以 IBM Rational Software Architect 可以使用的方式生成插件代码。

前提条件

本文假设您对拓扑以及部署结构工具有一个基本的熟悉。对于这些问题的入门性资料,您可以查看 参考资料 部分。

安装拓扑域生成工具箱

  1. 从 Resources 部分中下载拓扑域生成工具箱,并提取出“zephyr-sdk.zip”文件。该文件包含有一个您必须安装到 Eclipse 工作台之中的特性。
  2. 从工作台的菜单栏之中,点击 Help > Software Updates
  3. 在软件更新和 Add-ons 窗口之中,切换至 Available Software 项,点击 Add Site,点击 Local,并切换至您提取 SDK 特性的目录之中(见于图 2)。
图 2. 添加拓扑域生成工具箱更新站点
Add Side 对话框打开了
  1. 选择域生成特性然后点击 Install
  2. 完成安装向导中的过程并重启工作台(见于图 3)。
图 3. 安装域生成特性
打开的选择特性

创建域扩展

Eclipse 项目中包含有定义域的文件。稍后,本文向您展示了怎样包裹该项目,以与那些也想要使用通用域的其他人进行共享。

  1. 为了使工作台为创建域扩展做好准备,您可以切换至 Plug-in Development 视角,并激活 XML Developer 功能。您可以点击 Window > Open Perspective > Other 并双击 Plugin Development。然后点击 Window > Preferences; General > Capabilities,选中 XML Developer 复选框,并点击 OK
  2. 在 IBM Rational Software Architect 中创建一个空白的项目(File > New > Project; General > Project)并将其命名为“org.example.mysql”。
  3. 向新项目添加一个名为“model”的文件夹,并在名为“ecore”和“schema”的“model”之下创建其他两个文件夹。这就是我们模型结构的位置。现在项目如图 4 所示。
图 4. 初始的项目结构
显示 Package Explorer 视图打开的图
  1. 在“schema”文件夹之中,创建一个新的 XML Schema Definition,这就是域扩展的起始点,它包含了技术领域扩展的初始模型元素。
  2. 右击“schema”文件夹并从菜单中选择“New > Other”。
  3. 在 New 窗口中,选择 Example EMF Model Creation Wizards > XSD Model。(如果您不会看到 Example EMF Model Creation Wizards,那么您可以在向导的底部选中 Show All Wizards 复选框)。
  4. 点击 Next 并将方案文件命名为“mysql.xsd”然后再次点击 Next。(如果您选中了 Show All Wizards 复选框,那么就会出现一个弹出窗口,问您是否想要激活 Eclipse Modeling Framework 功能;如果您看到了该窗口,那么您可以点击 OK)。
  5. 在接下来的对话框中(见于图 5)中,为 XSD 模型指定初始的设置。在这里,您可以将 Target Namespace Prefix 设置为“mysql”,并将 Target Namespace 设置为 http://www.example.org/deploy/mysql/1.0.0/。目标名字域为 XML 方案文件及其域扩展定义了独一的标识符。
  6. 点击 Finish。 创建了 XSD 文件,在工作区中打开了 XSD 编辑器。
  7. 选择编辑器中的 Source 项以在文本模式下编辑 XSD 的内容。
图 5. mysql.xsd 文件的初始设置
显示 XSD Model Dialog 属性的图
  1. 为“ecore”和“core”域添加一个名字域,并使用 ecore 属性来注释 XSD 文件,从而编辑如代码清单 1 所示的文件。转化过程需要 ecore 信息,而属性 ecore:nsPrefix 的值稍后将用作域扩展的名字域前缀。名字域“core”引用了拓扑编辑器的基本元素定义,稍后将需要它来获取您自己的单元与功能。为了访问 core 方案的元素,XSD 导入声明提供了它的位置。
清单 1. 域扩展的初始 XML 方案文件
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<xsd:schema xmlns:mysql="http://www.example.org/deploy/mysql/1.0.0/" 
 xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
 targetNamespace="http://www.example.org/deploy/mysql/1.0.0/" 
 elementFormDefault="qualified" 
 
 xmlns:ecore="http://www.eclipse.org/emf/2002/Ecore" 
 xmlns:core="http://www.ibm.com/ccl/soa/deploy/core/1.0.0/" 
 
 ecore:nsPrefix="mysql"
 ecore:name="mysql"
 ecore:package="org.example.mysql">

 <xsd:import namespace="http://www.ibm.com/ccl/soa/deploy/core/1.0.0/" 
 schemaLocation=
 "platform:/plugin/com.ibm.ccl.soa.deploy.core/models/schemas/base.xsd"/> 

 <!-- unit and capability definitions go here -->

</xsd:schema>

向域添加一个单元

作为下一步,您需要定义一个新拓扑元素(在目前的情况下,是一个单元),它代表了拓扑中的 MySQL 数据库,并将出现在拓扑编辑器的配置板上。每一个拓扑元素都需要 XSD 文件中的两个元素:一个声明单元类型的 xsd:element 元素,以及一个定义单元类型的超类和属性的 xsd:complexType 元素。

第一个 XSD 元素包含有以下的信息:

  • 新图表元素的名字。
  • 属性 substitutionGroup,指定了新元素拓扑元素的种类,例如一个单元或者一个功能。对于单元,该属性被设置为“core:unit”;对于功能,该属性被设置为“core:capability”。
  • 对类型定义的引用。您可以使用与不止一个单元相同的类型,但是实际上这是为每一个单元定义新类型最简单的方式。

MySQL 数据库系统的单元定义如代码清单 2 所示:

清单 2:单元声明代码片段
<xsd:element name="unit.MySQLSystemUnit" 
        substitutionGroup="core:unit" type="mysql:MySQLDatabaseSystemUnit"/>

xsd:complexType 元素之中的类型定义为单元指定了超类。对于超类,您可以引用“core”方案之中“Unit”或者“SoftwareComponent”定义的通用类型,或者您可以引用另一种预定义域中更特定的单元。在后面一种情况下,您必须导入域规格(名字域声明与 XSD 导入声明),所以 XSD 分析器就可以解决引用的元素了。

在 MySQL 范例的背景之下,我们可以从数据库域中已存在单元“DatabaseSystemUnit”中,获取我们的新元素,它定义了数据库管理系统的通用概念。单元类型定义如代码清单 3 中的代码所示:

清单 3:单元类型定义代码片段
<xsd:complexType name="MySQLDatabaseSystemUnit">
  <xsd:complexContent>
    <xsd:extension base="database:DatabaseSystemUnit"/>
  </xsd:complexContent>
</xsd:complexType>

这种类型定义引用了数据库域之中的单元,所以您必须为数据库域,从代码清单 4 向 XSD 添加名字域声明以及导入声明。该代码清单片段包含了添加至已存在 xsd:schema 元素的新属性,以及作为 xsd:schema 元素子类添加的新 xsd:import 元素。

清单 4:为数据库域导入声明代码片段
<xsd:schema …
 xmlns:core="…" 
 xmlns:database="http://www.ibm.com/ccl/soa/deploy/database/1.0.0/" 
 …
>
…
 <xsd:import namespace="http://www.ibm.com/ccl/soa/deploy/database/1.0.0/" 
 schemaLocation=
   "platform:/plugin/com.ibm.ccl.soa.deploy.database/models/schemas/databaseDomain.xsd"/>

该导入声明引用了数据库域名的名字域以及数据库域方案文件的位置。查看 附录 A 以得到可用域及它们的名字域和方案文件。

向您的 XSD 文件添加这些三段代码(单元声明,单元类型定义,以及导入声明),确定单元声明的属性“类型”引用了 complexType 定义的名字。在 complexType 定义中,确定对标签“扩展”的数据域引用使用了获取该类型的正确名字。复杂 XSD 文件如代码清单 5 所示。

清单 5. 使用通用单元来完成 XML 方案文件
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<xsd:schema …
 xmlns:core="…" 
 xmlns:database="http://www.ibm.com/ccl/soa/deploy/database/1.0.0/" 
 …
>
…
 <xsd:import namespace="http://www.ibm.com/ccl/soa/deploy/database/1.0.0/" 
 schemaLocation=
 "platform:/plugin/com.ibm.ccl.soa.deploy.database/models/schemas/databaseDomain.xsd"/>

 <xsd:element name="unit.MySQLSystemUnit" 
 substitutionGroup="core:unit" type="mysql:MySQLDatabaseSystemUnit"/> 

 <xsd:complexType name="MySQLDatabaseSystemUnit">
   <xsd:complexContent>
     <xsd:extension base="database:DatabaseSystemUnit"/>
   </xsd:complexContent>
 </xsd:complexType>

</xsd:schema>

注意: 按照习惯,单元名拥有前缀“单元”以及一个可识别的字符串。在这种情况下,单元被命名为 unit.MySQLSystemUnit。


向域添加一个功能

为了完成 MySQL 范例,您可以向 XSD 添加带有三个属性(Version、Port 与 MaxAllowedPacket)的功能。拓扑编辑器中使用功能定义,来代表单元可以向其他单元提供的功能。

注意: 向单元类型添加属性是可能的,但是按照惯例,所有的通用属性都位于功能而不是单元之中。

功能的定义遵循与单元定义相类似的步骤:

  1. 添加一个带有属性名字、substitutionGroup 和类型的新 XSD 元素。属性 substitutionGroup 的值必须被设置为“core:capability”。按照惯例,功能的名字以“capability”开始。
  2. 添加新 XSD 元素的类型定义作为一个 complexType。在类型定义之中,指定功能的超类与功能的属性。
  3. 如果属性或者功能是从其他域中引用的,那么您可以添加相应的名字域并导入声明。

代码清单 6 为新的 SQL 数据库系统功能提供了一个代码片段,包括元素声明与类型定义。

清单 6:功能代码
<xsd:element name="capability.MySQLDatabaseSystem" 
        substitutionGroup="core:capability" type="mysql:MySQLDatabaseSystem"/>

<xsd:complexType name="MySQLDatabaseSystem">
  <xsd:complexContent>
    <xsd:extension base="database:DatabaseSystem">
      <xsd:attribute name="MySQLVersion" type="core:VersionString"/>
      <xsd:attribute name="Port" type="os:TCPPortType"/>
      <xsd:attribute name="MaxAllowedPacket" type="xsd:int"/>
    </xsd:extension>
  </xsd:complexContent>
</xsd:complexType>

代码清单 7 显示了添加“capability.MySQLDatabaseSystem”功能时,对 mysql.xsd 文件所做的所有更改。新功能从预定义的数据库域中扩展了已存在的功能“DatabaseSystem”。另外,属性“Port”的类型来自域操作系统(OS),它需要更多的名字域“os”以及 XSD 导入声明。

右击 Project Explorer 视图中的 XSD 文件然后选择 Validate,来向 mysql.xsd 文件添加更改,并确认内容。如果确认成功,那么您可以继续进行本文下一部分的操作。如果确认过程显示失败,那么请确认您的代码能够匹配代码清单 7 中的代码。Resources 部分同样还提供了完整的 XSD 文件。

清单 7. 带有新单元和功能的完整 XSD 文件
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<xsd:schema xmlns:mysql="http://www.example.org/deploy/mysql/1.0.0/" 
            xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
            targetNamespace="http://www.example.org/deploy/mysql/1.0.0/" 
            elementFormDefault="qualified" 
            
            xmlns:ecore="http://www.eclipse.org/emf/2002/Ecore" 
            xmlns:core="http://www.ibm.com/ccl/soa/deploy/core/1.0.0/" 
            xmlns:database="http://www.ibm.com/ccl/soa/deploy/database/1.0.0/" 
            xmlns:os="http://www.ibm.com/ccl/soa/deploy/os/1.0.0"
            
            ecore:nsPrefix="mysql"
            ecore:name="mysql"
            ecore:package="org.example.mysql">

   <xsd:import namespace="http://www.ibm.com/ccl/soa/deploy/core/1.0.0/" 
        schemaLocation=
        "platform:/plugin/com.ibm.ccl.soa.deploy.core/models/schemas/base.xsd"/> 

   <xsd:import namespace="http://www.ibm.com/ccl/soa/deploy/database/1.0.0/" 
        schemaLocation=
   "platform:/plugin/com.ibm.ccl.soa.deploy.database/models/schemas/databaseDomain.xsd"/>
     
   <xsd:import namespace="http://www.ibm.com/ccl/soa/deploy/os/1.0.0/" 
        schemaLocation=
        "platform:/plugin/com.ibm.ccl.soa.deploy.os/models/schemas/os.xsd"/>

        
   <!-- Custom unit -->

   <xsd:element name="unit.MySQLSystemUnit" 
        substitutionGroup="core:unit" type="mysql:MySQLDatabaseSystemUnit"/> 

   <xsd:complexType name="MySQLDatabaseSystemUnit">
     <xsd:complexContent>
       <xsd:extension base="database:DatabaseSystemUnit"/>
     </xsd:complexContent>
   </xsd:complexType>

   
   <!-- Custom capability -->

   <xsd:element name="capability.MySQLDatabaseSystem" 
        substitutionGroup="core:capability" type="mysql:MySQLDatabaseSystem"/>

   <xsd:complexType name="MySQLDatabaseSystem">
     <xsd:complexContent>
       <xsd:extension base="database:DatabaseSystem">
         <xsd:attribute name="MySQLVersion" type="core:VersionString"/>
         <xsd:attribute name="Port" type="os:TCPPortType"/>
         <xsd:attribute name="MaxAllowedPacket" type="xsd:int"/>
       </xsd:extension>
     </xsd:complexContent>
   </xsd:complexType>

</xsd:schema>

您可以向 XSD 文件添加尽可能多的单元与功能类型。当您完成添加新的拓扑元素时,现在就是时候将 XSD 文件转化为一个拓扑编辑器可以使用的域扩展。


生成域扩展

在这个部分中,您要从 XML Schema Definition 中生成一个 Ecore Model 及一个 EMF Model(也叫做一个 genmodel)。从 genmodel 中,您可以为域扩展创建插件代码。

  1. 右击 Package Explorer 视图之中的 mysql.xsd 文件,并选择 New > Other。这样“New Wizard”就会打开了。
  2. 点击 Eclipse Modeling Framework > EMF Model 然后点击 Next
  3. 在接下来的对话框中,名为“New EMF Model”(见于图 6),选择“ecore”文件夹,并确保 genmodel 的文件名被设置为“mysql.genmodel”。
  4. 然后点击 Next
图 6. 为 genmodel 编辑名字与位置
EMF Model Creation Wizard
  1. 选择 XML Schema 模型导入器并点击 Next
  2. mysql.xsd 文件会自动出现在文本区域“Model URIs”之中。如果不是,那么您可以选择 Browse Workspace 并选择您的 mysql.xsd 文件。
  3. 点击 Load 以启动 XSD 文件的导入。
  4. 如果 XSD 文件没有包含任何错误,所以 Next 按钮就处于激活状态;点击该按钮以继续操作。
  5. 在接下来的对话框中,您可以选择根包以及尚未导入的包:在对话框的上面表格中,选择“org.example.mysql”包。在下面的框中,选中所有引用的包(见于图 7)。
图 7. 完成的 Package Selection
EMF Model Package Selection 项
  1. 然后点击 Finish。 在项目的“ecore”文件夹中汇创建一个 mysql.ecore 文件及 mysql.genmodel 文件。
  2. 双击“mysql.genmodel”以在 genmodel 编辑器中打开文件,并选择模型的顶部根模型。
  3. 编辑 genmodel 文件的属性,并指定以下的属性,如图 8 所示:
    1. 将“Compliance Level”设置为“1.4”
    2. 将“Non-NLS Markers”设置为“true”
    3. 从“Edit Directory”中删除“.edit”;该字段的新值是“/org.example.mysql/src”。
    4. 将您所做的更改保存到 genmodel 文件之中(Ctrl+s)。
图 8. 编辑 genmodel 属性
MySQL 根元素的属性
  1. 在 genmodel 编辑器中,右击标为“”的顶部节点,并生成 Model 代码(见于图 9),Edit 代码(见于图 10),以及最终的 Topology Edit 代码(见于图 11)。

在 Project Explorer 视图中,您将会看到每一个生成步骤的生成工件。“Model Code”为域工件与域确认器生成了 EMF 代码。“Edit Code”生成器会创建插件基础,以编辑plug-in.xml 的模型,META-INF 目录,并提供作为 ItemProvider 和 EditPlugin 的类。这些文件允许您去创建单元的实例以及拓扑之中的功能。您不需要直接编辑这些文件。

域生成器创建了一个名为“templates”的新文件夹,具体和概念性的 MySQL 单元的拓扑模板就存储在那么。另外,生成器创建了一个名为“org.example.mysql.ui”的新项目,它包含了图表扩展的插件代码。

图 9. 生成 Model Code
Generate Model Code 界面
图 10. 生成 Edit Code
Root 元素内容菜单
图 11.生成 Topology Code
生成 Topology Edit Code

测试运行时的新技术领域

为了测试新创建的技术领域,您可以在工作台的运行时实例中运行生成的插件。

从“org.example.mysql”中打开“plugin.xml”文件并点击 Launch an Eclipse application,如图 12 所示。

图 12. org.example.mysql 项目的 plugin.xml
plugin.xml Overview Tab 的屏幕截图

工作台的运行时实例在新窗口中得到了初始化。

  1. 在运行时实例中添加一个新项目(File > New > Project | General > Project)。并将其命名为“org.example.mysql.topology”。
  2. 在 Project Explorer 中,右击新创建的项目并选择 New > Topology
  3. 在对话框中,给拓扑起一个类似于“MySQLExample”的名字并点击 Finish
  4. 默认条件下,生成域中的配置板条目位于 Middleware 之中。打开这个折叠项,点击 MySQLDatabaseSystemUnit 条目,并将其置于拓扑图中(见于图 13)。

注意: 您还可以使用快速配置板来选择新单元。点击拓扑图并点击 Ctrl+t,一个带有可用单元的弹出窗口会打开。现在您就可以浏览单元,并且可以更快地输入单元名字的首字母了。

图 13. 从配置板中选择 MySQLDatabaseUnit
Runtime Instance 与 MySQL Unit
  1. 在将单元置于图表中之后,您可以检查 MySQLDatabaseSystem 功能是否存在以及单元 Properties 视图中它的属性。

注意: 如果选项“Window > Preferences; Topology Editor > Unit Appearance; Capabilities and Requirements”得到设置时,您可以选择,直接从单元中访问功能与需求(见于图 14)。

图 14. MySQLDatabaseUnit 功能
MySQL 单元与功能窗口

为了评审带有 XML 类型的已创建拓扑,您可以保存图表(Ctrl+s)并在文本编辑器中打开一个拓扑文件(右击 MySQLExample.topology 然后点击 Open With > Text Editor)。拓扑文件的源如图 15 所示。

图 15. 带有 xml 类型的 .topology 文件的源代码
XML 格式的结果 .topology 文件

该源代码显示了 MySQL 单元是分明的类型,并不仅仅是编辑器中其他单元的拷贝。发布者以及拓扑编辑器中的其他扩展,现在可以将这些单元与其他的数据库单元区分开来。

关闭运行时实例(Ctrl+F4)并继续处理本文的下一部分。


配置拓扑编辑器的配置板

生成过程创建 拓扑模板 ,它是配置板中的条目,该配置板包含有一个或者多个单元,让您添加至拓扑之中。在这种情况下,生成进程会为您所定义的每一个新单元类型创建两个新的模板,一个包含有单元的概念性版本,另一个包含有单元的实际版本。这些模板默认条件下都位于配置板的“Middleware”之中。

模板的位置是在 ui 和域项目的 plugin.xml 文件中指定的。在 ui 项目中,折叠项(顶级类别)和栈(相关模板的组)得到了定义,它作为拓扑模板的容器。每一个折叠项都包含了私人的模板条目,以及相关模板的栈。每一个折叠项、栈和模板在相同的层级结构下,都必须拥有一个独一无二的标识符。在域项目之中,模板是同绑定的 UI 一起提供的,它包含了一个配置板路径属性,将模板与一个或者更多的折叠项或栈联系起来。如果路径定义无效或者丢失了,那么模板就不会显示在配置板中。

在 MySQL 范例之中,会创建一个新的折叠项,该折叠项包含了 example.org 域的所有元素。在该折叠项中,会包含已存在的 MySQL 栈(由域生成工具箱所创建)。

  1. 打开 UI 项目的插件编辑器(双击 plugin.xml)并切换至 Extensions 项。
  2. 展开 org.eclipse.gmf.runtime.diagram.ui.paletteProviders > com.ibm.ccl.soa.deploy.core.ui.providers.DeployCorePaletteProviders。如图 16 所示,拓扑域生成器工具箱为 路径 /serverSoftwareDrawer 上名为 mysqlStack 中的 MySQL 数据库创建一个默认的配置板条目(代表了“Middleware”折叠项)。
图 16. 为 MySQL Domain 生成的配置板条目
plugin.xml 编辑器栈扩展
  1. 为了展开带有一个通用折叠项的配置板,您可以右击贡献条目 com.ibm.ccl.soa.deploy.core.ui.providers.DeployCorePaletteFactory 并选择 New > entry,如图 17 所示。
图 17. 添加一个新的配置板条目
向 plugin.xml 文件添加一个条目

在界面的右边,您可以编辑新扩展条目的细节信息。

  1. kind 区域中,选择 drawer 并输入 id“ExampleOrgExtensions”。折叠项作为配置板中顶级层次的原始,它由 path 区域的 ‘/' 指示。
  2. label 区域中,为新折叠项的标签指定“example.org Extensions”。假如属性的值仍然是空白的,那么会设置一个默认的值。您可以选择,为新折叠项设置一个描述与图标。
  3. 在您输入数据之后,选择条目 example.org Extensions 并点击对话框中的 Up 按钮(见于图 18)。见折叠项定义移动到栈定义之上,以确保插入 mysqlStack 之前来创建新的折叠项。
图 18. 检查新折叠项位于栈条目(左边)与新折叠项细节(右边)之上
打开的 Extensions Tab
  1. 接下来的一步是将 mysqlStack 条目与新创建的折叠项条目联系起来。为了完成这项操作,您可以打开 Mysql Stack 条目并将它的 path 属性设置为“/ExampleOrgExtensions”。
  2. 保存 ui plugin.xml(Ctrl+s)。

接下来,您可以更新模板的路径,以指向新折叠项和栈。

  1. 打开域项目的 plugin.xml 文件(并不是 UI 项目),并切换至 Extensions 项。展开扩展点 com.ibm.ccl.soa.deploy.core.domains。域扩展中的每一个模板都定义为一个 resourceType(它包含了关于资源的通用信息)以及一个 resourceTypeUIBinding(它包含了资源的 UI 定义,包含了它在配置板中的位置以及它的标签和图标)。在 resourceTypeUIBinding 之中,属性“path”定义了配置的路径。
  2. 对于两个模板,您可以将配置板属性的值设置为“/ExampleOrgExtensions/mysqlStack/”,如图 19 所示,并保存更改。
图 19. 域项目 plugin.xml 文件的扩展对话框以及属性“path”的添加值
域扩展的屏幕截图
  1. 点击 Overview 项之上的 Launch an Eclipse application,来测试运行时环境之中的新配置。您可以看到 Overview 中新的折叠项以及栈,如图 20 所示。
图 20. 新 Palette 折叠项
运行时实例之中的 Palette

您可以添加尽可能多的 Palette 折叠项以及模板。默认条件下,每一个模板只包含有一个单元,但是您可以通过创建带有单元和功能的拓扑,来创建拥有尽可能多单元和功能的模板,将该拓扑保存在域项目的“模板”文件夹中,并创建 resourceType 和 resourceTypeUIBinding 元素,如前面的范例所示。

您还可以向已存在的折叠项添加 Palette 条目;这些默认折叠项列在 附录 B 的 ID 中。


导出并安装新域扩展插件

为了轻松交换创建的插件与模板,所有的插件都可以集合到一个更新站点项目之中,扩展的所有用户都可以访问该项目。一个更新站点由一些特性的集合体组成,而特性本身由安装在一起的插件组成。对于 MySQL 范例,更新站点将会提供一个特性,它包含了域和 UI 插件。

在创建更新站点之前,请确保插件档案中包含有域插件的模板文件夹:

  1. 在插件编辑器中打开域插件的 plugin.xml 文件,并切换至 Build 项。
  2. Binary Build 部分中,请确保“templates”文件夹旁边的复选框被选中了。
  3. 保存更改(Ctrl+s)并关闭编辑器(Ctrl+F4)。

创建一个新的特性,以包含域和 ui 插件:

  1. 创建一个新的 Feature Project(File > New | Plugin Development > Feature Project)。
  2. 在如图 21 所示的对话框之中,为项目输入一个名字,例如“org.example.mysql.feature”,给 Feature Name 起一个“MySQL Feature”之类的名字,然后点击 Next
  3. 在接下来的对话框中,选择插件以包含到特性之中(见于图 22)。在现在的情况中,选择两个 mysql 插件(org.example.mysql 与 org.example.mysql.ui)的复选框,并点击 Finish

新项目会得到创建,而 feature.xml 编辑器会在工作区中打开。

图 21. 创建一个新特性项目
Feature Properties 创建向导
图 22. 选择插件
Feature Creation 向导显示了插件选择
  1. 在编辑器中,切换至 Plug-ins 项并检查两个插件都得到了适当的添加。默认条件下,插件的版本号被设置成了“0.0.0”,它是一个占位符,用于引用插件项目中所配置的最新版本。
  2. Information 项上,您可以更改特性(例如特性描述,版权,许可协议和访问的更多网站)的总体信息。当有人在安装特性时,这些信息会显示在“软件更新 ”对话框的前面。

接下来,创建一个更新网站,以允许人们来安装域扩展:

  1. 返回至 Overview 项并在 Publishing 部分中,点击 Create an Update Site Project(见于图 23)。
图 23. feature.xml 编辑器的概述页面
打开的 feature.xml Overview 项
  1. New Update Site 对话框之中,输入一个项目名(例如,org.example.mysql.updatesite)并点击 Finish。Update Site 打开时会自动切换至 Site Map 项,从该项中,您可以向更新站点中添加新的类别与特性。
  2. 点击 New Category 并输入“MySQL Extension”作为 NameLabel 字段的值。
  3. 然后选择类别“MySQL Extension”并点击 Add Feature。一个选择对话框会打开,您可以在这个对话框中添加 mysql 特性(org.example.mysql.feature)。
  4. 点击 Build All 以构建插件、特性以及 Update Site(见于图 24)。
  5. 最终,您可以从更新站点项目中删除生成的文件“content.xml”与“artifacts.xml”,以避免在新插件的安装过程中产生一条错误信息。
图 24. 为 mysql 范例完成 site.xml 的配置工作
Update Site Project

现在您可以与想要使用域扩展的其他人一起共享更新站点了。更新站点项目在“features”与“plugins”文件夹之中包含了所有需要的插件与特性,所以当您在分散更新站点时,您并不需要包含其他的项目。按照指南来从更新站点中安装域扩展:

  1. 打开软件安装对话框(Help > Software Updates)并选择 Available Software 项。
  2. 点击 Add Site 并选择包含有更新站点项目的文件夹。在软件更新对话框之中,新 MySQL Extension 与 MySQL Feature 显示如图 25 所示。
  3. 选中特性的复选框并点击 Install
  4. 重启工作台。
  5. 为了确认域扩展得到了安装,您可以创建一个带有拓扑的新项目来测试域,并向拓扑添加域中的单元。
图 25. 软件更新对话框与 MySQL 特性
软件更新对话框与 MySQL 特性

总结

IBM Rational Software Architect 的拓扑结构编辑器是与一系列预定义的单元与功能一起发布的。但是,拓扑的高级用户需要更多的单元和功能,这些单元和功能能够在拓扑文件中被他们的 xml 类型所识别。在本文中,我们涉及到了怎样使用拓扑域生成工具箱来添加定制技术领域。从定义技术领域开始,拓扑域生成工具箱能够帮助您生成拓扑扩展所需要的源文件,并将您的扩展快速集成到拓扑编辑器之中。最终,我们向您展示了,新的单元是如何定制到配置板中,以及插件是怎样在建模者之间交换的。

参考资料

学习

获得产品和技术

讨论

条评论

developerWorks: 登录

标有星(*)号的字段是必填字段。


需要一个 IBM ID?
忘记 IBM ID?


忘记密码?
更改您的密码

单击提交则表示您同意developerWorks 的条款和条件。 查看条款和条件

 


在您首次登录 developerWorks 时,会为您创建一份个人概要。您的个人概要中的信息(您的姓名、国家/地区,以及公司名称)是公开显示的,而且会随着您发布的任何内容一起显示,除非您选择隐藏您的公司名称。您可以随时更新您的 IBM 帐户。

所有提交的信息确保安全。

选择您的昵称



当您初次登录到 developerWorks 时,将会为您创建一份概要信息,您需要指定一个昵称。您的昵称将和您在 developerWorks 发布的内容显示在一起。

昵称长度在 3 至 31 个字符之间。 您的昵称在 developerWorks 社区中必须是唯一的,并且出于隐私保护的原因,不能是您的电子邮件地址。

标有星(*)号的字段是必填字段。

(昵称长度在 3 至 31 个字符之间)

单击提交则表示您同意developerWorks 的条款和条件。 查看条款和条件.

 


所有提交的信息确保安全。


static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=10
Zone=Rational
ArticleID=630775
ArticleTitle=使用定制技术领域扩展拓扑编辑器
publish-date=07232010