如果要透過 Rational® CM
API 存取 Rational ClearQuest®,您必須匯入共用介面和
Rational ClearQuest 特定的介面。
將已安裝的 CM API 檔案新增至類別路徑之後,您可以開始使用 CM API 進行程式設計。就像任何 Java™ 程式設計一樣,您需要匯入包含在程式碼中使用的方法的所有介面。因為 ClearQuest 介面全部都在同一個套件中,所以您可以使用萬用字元來包括它們:
import com.ibm.rational.wvcm.stp.cq.*
您需要「工作區版本化及配置管理 (WVCM)」套件中的類別來實作 API 的基本機制。WVCM 套件中的其餘介面特別處理來源配置管理資源,若專門處理 Rational ClearQuest 則不使用。
// 匯入給 ClearQuest 應用程式的 WVCM 類別
import javax.wvcm.Feedback;
import javax.wvcm.PropertyNameList;
import javax.wvcm.ProviderFactory;
import javax.wvcm.ResourceList;
import javax.wvcm.PropertyRequestItem.NestedPropertyName;
import javax.wvcm.PropertyRequestItem.PropertyRequest;
import javax.wvcm.PropertyNameList.PropertyName;
import javax.wvcm.ProviderFactory.Callback;
import javax.wvcm.ProviderFactory.Callback.Authentication;
import javax.wvcm.WvcmException;
您也可以使用「軟體小組套件 (STP)」中的許多介面,來指定 Rational CM API 所使用的 WVCM 延伸規格。
// 匯入給 ClearQuest 的共用 Rational CM API 類別
import com.ibm.rational.wvcm.stp.StpException;
import com.ibm.rational.wvcm.stp.StpProperty;
import com.ibm.rational.wvcm.stp.StpResource;
import com.ibm.rational.wvcm.stp.StpProperty.MetaPropertyName;
import com.ibm.rational.wvcm.stp.StpLocation;
最後,因為範例應用程式使用 Swing GUI,所以您還必須包含一些 Swing、AWT 及 Java 公用程式類別。
// 針對此指導教學而匯入的其他公用程式類別
import java.lang.reflect.InvocationTargetException;
import java.awt.BorderLayout;
import java.awt.Component;
import java.awt.FlowLayout;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import java.io.File;
import java.util.Hashtable;
import java.util.Iterator;
import java.util.Arrays;
import java.util.Comparator;
import javax.swing.JButton;
import javax.swing.JComponent;
import javax.swing.JFrame;
import javax.swing.JOptionPane;
import javax.swing.JPanel;
import javax.swing.JScrollPane;
import javax.swing.JTable;
import javax.swing.ListSelectionModel;
import javax.swing.event.ListSelectionEvent;
import javax.swing.event.ListSelectionListener;
import javax.swing.table.AbstractTableModel;
import javax.swing.table.TableModel;
import javax.swing.JComboBox;
import javax.swing.JFileChooser;