CM API 是用于执行有关 Rational 产品方面的操作的公共组件。要将这个 API 用于 Rational 产品,必须在自己的系统上安装该产品。另外还必须将 CM API 文件复制到自己的类路径下,这些 API 文件是在安装 Rational 产品时,安装到了系统上。
使用 Rational ClearQuest® 资源所需的 CM API 文件包括所有 CM API 资源类型需要的文件以及 Rational ClearQuest 资源需要的文件。
这些 Java™ 软件包是利用 Rational CM
API 执行 Rational ClearQuest 操作所必需的。
- javax.wvcm:工作空间版本控制和配置管理软件包(WVCM)。
- com.ibm.rational.wvcm.stp:Rational 软件团队软件包是 WVCM 软件包的扩展。该软件包包含 Rational CM API 接口,并且为 Rational 产品资源提供了公共对象模型。
该软件包独立于针对产品的存储库或独立于实现。
- com.ibm.rational.wvcm.stp.cq:是该产品的扩展,它提供了对 Rational ClearQuest 数据库的访问。通过该软件包可以更全面地(针对产品)使用 ClearQuest 数据库的功能及其底层资源。
尽管您能够将本文档中的代码剪贴到可编译的 Java 环境中,但可能无法进行该代码,因为其中可能包含一些印刷错误,导致无法编译。这些示例完整的可编译代码位于随 Rational CM API 文档一起分发的补充归档文件中 Eclipse 项目下的 samples 中。
缺省情况下,Rational CM
API JAR 文件和其他必要的 JAR 文件安装在以下位置。
install-dir 表示 Rational 产品的安装目录。
缺省情况下,在 UNIX® 和 Linux® 系统中,该目录为
/opt/rational;在
Windows® 系统中,该目录为
C:\Program Files\IBM Rational。
- 在 Windows 系统上:
- <install-dir>/Common/stpwvcm.jar:Rational CM
API 接口 JAR 文件。
- <install-dir>/Common/stpcmmn.jar:公共实现 JAR 文件。
- <install-dir>/ClearQuest/stpcq.jar:ClearQuest 产品的扩展。
- <install-dir>/ClearQuest/cqjni.jar:Rational ClearQuest JAR 文件。
- 在 UNIX 和 Linux 系统上:
- <install-dir>/common/stpwvcm.jar
- <install-dir>/common/stpcmmn.jar
- <install-dir>/clearquest/cqweb/lib/stpcq.jar
- <install-dir>/clearquest/cqweb/lib/cqjni.jar
为了使用 Rational CM API JAR 文件,必须将所有文件所在的位置添加到类路径。
要从 Eclipse 插件访问 Rational CM
API,可以将 com.ibm.rational.stp.cmapi.zip 文件和样本项目导入到 Eclipse,或者可以执行以下步骤:
您必须安装了具有许可证的 Rational ClearQuest,从而可以利用 Rational CM
API 来使用 ClearQuest 资源。如果安装并配置了 JAR 文件,但未安装相应的产品,那么调用这个 Java 软件包会失败。