属性和元属性

资源具有属性。每个属性都具有名称、类型和值;它们可能还具有与其相关联的其他元属性(例如:值、大小或有效性指示)。

属性的值属于特定类型,例如:整数、字符串、日期、时间或对资源的引用。属性类型取决于属性名称和资源类。ClearQuest® CM API 中的属性名称由 PropertyNameList.PropertyName 对象来表示。PropertyNameList.PropertyName 是参数化类型,其中参数指定属性值的类型。一些属性由 WVCM 定义,一些属性由 ClearQuest CM API 定义,作为对 WVCM 的扩展,还有一些属性可能由服务器和客户机应用程序定义。

在 ClearQuest CM API 中,元属性由 MetaPropertyName 对象来标识。MetaPropertyName 可用于从服务器读取属性后访问该属性的元属性。MetaPropertyNames 在 StpProperty 类及其子类中定义。还使用元属性值的类型对其进行了参数化。

属性的 PROPERTY_NAMEVALUE 元属性是专有元属性。PROPERTY_NAME 值用于请求和访问属性及其任何元属性。VALUE 是元属性,请求它可确定是否仅在请求中使用属性名。

由每个 CM API 代理接口定义的每种类型的资源识别的一组属性名是一系列类型为 PropertyName 的字段。这些 PropertyName 对象用于从服务器请求属性,并在从服务器获取属性值后访问属性值。 在 CM API 中定义的每个 PropertyName 字段名称是大写标识,其中的单词用下划线隔开(例如,CONTENT_LENGTH)。

属性名的示例为 Resource.COMMENTResource.DISPLAY_NAMEResource.CREATION_DATEResource.CONTENT_LENGTH。属性名在 Resource 类及其子类中定义。在类中定义的属性适用于类及其所有子类。例如,CqQuery 类具有 CqQuery.DISPLAY_FIELDSCqQuery.DYNAMIC_FILTERSCqQuery.USER_FRIENDLY_LOCATIONCqQuery.STABLE_LOCATION 属性名,最后两个属性继承自 StpResource 类。每个 Resource 代理子类定义 PropertyName 字段,该字段用于标识与代理表示的资源类型关联的属性并对其进行命名。


反馈