< 上一课 | 下一课 >

设置和安装 CM API

在可以使用 CM API 之前,必须将文件添加至类路径,并且安装了带有许可证的 Rational® 产品。
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,请执行以下步骤:

  1. 使用归档文件 %RATIONAL_INSTALL%\common\cm\teamapi.zip 中位于目录 \plugins\com.ibm.rational.stp.cmapi 中的文件来创建一个 Eclipse 插件。
  2. 要将 Rational CM API 插件添加到运行时配置中,请将该插件复制到 Eclipse 实例中或创建一个新的扩展安装点。这样会为 Rational CM API 创建一个新目录(例如,C:\eclipse\plugins\com.ibm.rational.stp.cmapi)。 该新插件由 Rational CM API JAR 文件和 Rational ClearQuest JAR 文件组成。
  3. 创建好插件目录后,必须将各个已安装的 JAR 文件从其安装位置复制到该目录中。 ClearQuest JAR 文件需要 Rational CM API JAR 文件。 下次启动 Eclipse 时,该插件就已可供使用。
  4. 要从插件使用 Rational CM API,请确定与 com.ibm.rational.stp.cmapi 存在依存关系。
现在,您已准备好开始利用 Rational CM API 来编写 Java 程序。
您必须安装了具有许可证的 Rational ClearQuest,从而可以利用 Rational CM API 来使用 ClearQuest 资源。如果安装并配置了 JAR 文件,但未安装相应的产品,那么调用这个 Java 软件包会失败。

课程检查点

现在,您已经设置好系统来利用 CM API 进行编程,接下来准备开始学习 CM API 对象模型和编程模型。
在本课程中,您学习到了以下内容:
  • CM API 和 Rational ClearQuest 之间的关系
  • 如何设置系统来利用 CM API 进行编程
  • CM API 中的哪些文件是系统必需的
< 上一课 | 下一课 >

反馈