资源是存在于存储库中的属性的已命名集合。某些资源(例如文件)具有内容和属性。某些资源仅存在于服务器上。某些资源独立地存在于客户机文件区域中。一个资源无法存在于两个不同的位置,但是两个资源却可以给人以两者之间有紧密联系的映象。例如,文件区域中的文件和服务器上对应的文件是两个不同的资源。它们是相关的,但是每个资源具有其自己的位置、内容和属性。
代理对象可用于创建、修改和最终破坏资源。在创建资源后到其被破坏之前,除了调用修改该资源的提供程序之外,该资源都会保存在存储库中。
在 Rational® CM
API 中,Resource 接口是所有 Rational CM
API Resource 类型的基本接口。以下是资源的示例:
- Rational ClearCase® 视图中的文件
- 版本化对象基础(VOB)中的版本
- Rational ClearQuest® 用户数据库中的缺陷
CM API 代理接口形成层次结构。该层次结构的根是
javax.wvcm.Resource。例如,以下是扩展 Resource 接口的某些接口:
- StpResource 扩展 Resource。
- CqResource 和 CcResource 扩展 StpResource。
- stp 程序包包含 StpActivity、StpFolder 和 StpRepository 接口。
- cc 程序包包含 CcActivity、CcAttributeType、CcBaseline、CcBranchType、CcComponent、CcControllableFolder、CcControllableResource、CcElement、CcElementType、CcFolder、CcFolderVersion、CcProject、CcProjectFolder、CcVersion、CcView、CcVob 和 CcVobResource 接口。
- cq 程序包包含 CqAction、CqAttachment、CqAttachmentFolder、CqDbSet、CqFieldDefinition、CqForm、CqGroup、CqHook、CqProjectMember、CqQuery、CqQueryFolder、CqQueryFolderItem、CqRecord、CqRecordType、CqReport 和 CqUserDb 接口。
资源具有一个资源类型、一个唯一的位置(以 Location 选择器字符串的形式出现)以及一个显示名称。每个类型的资源都具有一个唯一接口用于对资源的访问。