< 上一课 | 下一课 >

设置和安装 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,可以将 com.ibm.rational.stp.cmapi.zip 文件和样本项目导入到 Eclipse,或者可以执行以下步骤:

  1. 用打包在 com.ibm.rational.stp.cmapi.zip 中的文件创建 Eclipse 插件。
  2. 要将 Rational CM API 插件添加到运行时配置,请将该插件复制到 Eclipse 实例中或创建一个新的扩展安装点。这会为 Rational CM API 创建一个新目录(例如,C:\eclipse\plugins\com.ibm.rational.stp.cmapi)。 这个新插件是一个简单的自包含 Eclipse 插件,包含 Rational CM API JAR 文件和该产品专有的 JAR 文件。请注意,.zip 文件不包含实际的产品 JAR 文件。
  3. 创建插件目录后,必须将每个已经安装的 JAR 文件从其安装位置复制到新的插件目录。每个 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 中的哪些文件是系统必需的
< 上一课 | 下一课 >

反馈