命名慣例

從 Resource 介面衍生的每一個介面都有一組完整定義的內容,可透過 Rational® CM API 來檢查及修改。每一個介面也都有一組完整定義的作業,可以在虛擬物件上呼叫,進而對基礎資源引發某些動作。

虛擬物件方法的名稱開頭及其用途如下:

取得設定內容的方法不會與資源互動。設定方法會將其引數值儲存在虛擬物件中,而取得方法則會擷取已儲存在虛擬物件中的內容值。利用 Resource.doReadProperties() 之類的執行方法從儲存庫中讀取這些值,並利用 doWriteProperties() 之類的執行方法將值寫入儲存庫。

do 方法會使得「Rational CM API 提供者」對資源執行作業,並導致與伺服器產生互動。許多 do 方法都接受選用的 ProperyRequest 或 Feedback 參數,在執行方法時,可讓用戶端要求從資源讀取內容。所有執行方法都會將前次伺服器互動之後,在虛擬物件中已設定的任何內容值寫入實際的資源中。

在每一個 Rational CM API 套件中,每一個介面的名稱都是唯一的,且會以字首來表示其內含的套件。如此一來,就算不是採用完整的介面名稱,也能清楚地了解程式碼的意義。


意見反應