CARMA 能够将 Rational® Developer
工作空间(例如,本地或远程项目)中的(关联)资源与 CARMA RAM
中的资源进行比较。在确定已对工作空间文件进行哪些更改并将这些更改检入到 CARMA 中时,这很有用。
关于此任务
当 CARMA 将资源下载到工作空间中时,它会存储当前的条件值。根据条件值和工作空间更改,CARMA
可确定已对 RAM 中的版本进行哪些更改并指示应该在哪个方向移动更改。例如,CARMA
可确定是否已使用本地方式和/或在 RAM 中对工作空间文件进行更新。根据更改信息,CARMA
可指示该文件的哪些部分已更改以及指示应该在何处将更改上载至 RAM 和从 RAM
复制更改或者是否需要进行合并,因为在工作空间和 RAM 中已发生更改。
为了以灵活的方式执行比较,CARMA
已提供比较条件配置文件 – syncConfig.xml。此 syncConfig
文件被放置在 RSE 配置目录*中,并且当 RSE 启动**时会自动由 CARMA 获取。
该比较配置文件允许
RAM 开发者指定各种条件以按“RAM 到 RAM”的方式进行比较。以下是比较配置文件的示例:
<?xml version="1.0" encoding="UTF-8"?>
<CARMACompare xmlns="http://www.ibm.com/CARMA/SyncConfig">
<RAMCompare ramId="00">
<memberinfo key="Last Modified Date" type="date" format="MM/DD/YY"/>
<memberinfo key="Last Modified Time" type="date" format="HH:MM"/>
<memberinfo key="Last Modified Seconds" type="int" />
</RAMCompare>
<RAMCompare ramId="01">
<content />
</RAMCompare>
</CARMACompare>
XML 文档必须以
CARMACompare 元素开始。
CARMACompare
元素可以包含 1 个或多个
RAMCompare 元素。每个
RAMCompare 元素都指定单个 RAM
的比较条件。该条件所适用的 RAM 由
ramId 属性表示。
ramId
值应该与 CARMA VSAM 配置中的 RAM 标识匹配,并且为 2 位数字。如果该标识少于
2 位,那么需要将 0s 添加至标识值的开头。以上示例为 2 个 RAM(01 和 02)定义比较条件。每个
RAMCompare 元素都包含 RAM 的条件。当前,可用于检查的条件包括如下:
成员信息
配置可为每个
RAMCompare 定义 1 个或多个
memberinfo
元素。成员信息元素并置在一起以形成比较。成员信息元素包含
key、
type 以及
format(可选)属性。当前,会忽略
type 和
format 属性,但是包括了对用法的解释。当前,会直接比较这些键,以检查字符串等价情况。
- key 属性
- key 属性会引用在资源的属性中找到的成员信息项。key
属性应该与由资源的 RAM 返回的键匹配。
- type 属性
- type 属性指定应该如何处理键值。type
属性可设置为下列其中一项:
类型定义应该如何比较成员信息。例如,使用以下条件:
<memberinfo key="Last Modified Seconds" type="int" />
成员信息值
0001 将等于 1。
- format 属性
- 仅对于指定了类型“date”的元素,才需要
format 属性。format
属性允许用于定义应该如何解析和比较日期值的条件。例如,使用以下条件:
<memberinfo key="Last Modified Time" type="date" format="HH:MM"/>
成员信息值
1:10 PM 将等价于 13:10。
成员内容
配置可对每个
RAMCompare 都定义一个内容元素。内容元素指示 CARMA
应该检查资源的字节内容以获取更改。
注: 这要求将完整的文件下载到工作空间中以执行比较。
文件内容会下载到工作空间中,并且会对这些文件内容执行文件散列
(MD5)。如果文件内容散列不同于工作空间文件散列,那么会指示差别。
缺省比较条件
如果没有为 CARMA
使用的 RAM 定义 RAMCompare 元素,那么会使用已设置的缺省比较条件。缺省比较条件首先注意检查是否为要比较的资源定义了
carma.version 成员信息键。如果 carma.version
键可用,那么该单键值用作比较条件。如果 carma.version
键不可用,那么会根据成员内容执行比较。
注: * 请参阅 Rational Developer
for System z® Host Configuration Guide (SC23-7658-00),以获取有关
RSE 配置目录的更多信息。
注: ** 仅当 RSE 启动时,才会获取该比较配置文件。为了检测到更改,请与
RSE 断开连接并重新进行连接。