命名约定

每个从 Resource 接口派生的接口都有定义良好的属性设置,可以通过 ClearQuest® CM API 来检查和修改这些设置。每个接口还有一组定义良好的操作,可以在代理上调用这些操作来影响底层的资源。名称的开头为 getsetdo 的代理方法用来执行特定的操作。
对于任何代理方法,如果其名称开始于:

getset 属性的方法不与资源进行交互。set 方法将其参数值存储在代理中,而 get 方法检索存储在代理中的属性值。使用 do 方法(例如 Resource.doReadProperties())可从存储库读取值,使用 do 方法(例如 doWriteProperties())可将值写入存储库。

do 方法使 API Provider 对资源执行操作并使其与服务器交互。 许多 do 方法采用可选的 ProperyRequestFeedback 参数,客户机可以通过这些参数在运行 do 方法时,请求从资源读取属性。所有 do 方法都会在资源中写入自上次服务器交互以来代理中设置的任何属性值。

每个 ClearQuest CM API 程序包中每个接口的名称都是唯一的,并包括标识程序包(名称所在的程序包)的前缀。这样就使得即使未使用标准接口名称,读取代码也会比较简单。


反馈