运用 REST API 集成及扩展 IBM Rational Team Concert

核心提示： 示例程序源代码解析打开包管理器，所有类如下图所示，运用 REST API 集成及扩展 IBM Rational Team Concert(10)，图 3. 源代码包结构下面对每个类的功能进行简单地介绍，RTCRestClientException.java该类作为该项目的根 Exception

示例程序源代码解析

打开包管理器，所有类如下图所示。

图 3. 源代码包结构

下面对每个类的功能进行简单地介绍。

RTCRestClientException.java该类作为该项目的根 Exception 类。Resource.java该类封装了 RTC 中常规资源的属性：包含资源的名称、类型以及对应的资源 URL。比如工作项中的 Severity、Priority 以及 State 等都是一个资源对象实例。Workitem.java该类对 RTC 中的工作项进行了封装。一个工作项中通常包含唯一标识符、标题、描述、Severity、Priority 等属性。该类也包含了同 JSON 对象之间相互转换的方法。Configuration.java该类用于读取系统配置文件 config.properties。QueryResults.java该类用以封装 REST API 的查询结果。RTCRestClient.java该类封装了对 RTC REST API 调用，以传统的 Java 方法暴露对 RTC 的操作。对于每次 REST API 操作，程序会检查是否已进行过认证或者之前认证后获取的 Cookie 是否仍有效或者已过期。如果 Cookie 已过期则重新认证。本示例代码实现是表单认证方式，如果你的 RTC 配置的是基本认证方式则需要自己对代码做些修改。WorkitemManager.java该类通过对 RTCRestClient.java 的调用封装了若干对工作项的操作，例如创建工作项、查询工作项、修改工作项状态等操作。SampleCaller.java该类是一个示例客户端调用程序。它调用了 WorkitemManager 中的方法并输出运行结果。

创建工作项代码详解

图 4. UML 时序图（创建工作项）