透過提供一個位置作為類型專屬建立方法之引數來建立資源。
任何可能需要建立資源(如:活動的串流)的內容都必須先設定在虛擬物件中,才能呼叫建立方法。您無法以空的或無效的值來建立必要內容的資源。當您呼叫 doCreateResource() 或 doCreateGeneratedResource() 方法時,發生失敗 (WvcmException)。
「活動」虛擬物件(在下列範例中為
a2)會在伺服器端物件之前建構。例如:
CcStream stream = . . .;
CcActivity a2 = provider.ccActivity(provider.stpLocation("cc.activity:a_new_activity@\projects"));
// 設定標題
a2.setHeadline("The new task");
// 設定串流
a2.setStream(stream);
// 建立活動
a2.doCreateCcActivity();
建構新資源(包括檔案區專用的 ControllableResource,例如 CcFile 或 CcDirectory)的方式如下:
- 決定新資源的位址。
- 利用其中一個 StpProvider.stpLocation() 方法,建構該位址的「位置」物件。
新增子區段至已選取的資料夾位置,來建立該資源的位置。
- 從提供者取得該位置的虛擬物件。利用適當的「提供者」虛擬物件 Factory 方法,建構其物件類別符合新資源類型的虛擬物件。
- 將任何必要或適用於新資源的內容值移入虛擬物件。針對可透過對新的虛擬物件使用設定方法來設定的資源內容,建立其起始值。
- 對虛擬物件呼叫建立資源作業(doCreateResource 方法),其會傳回新建資源的虛擬物件,其中包含建立資源作業中所要求的任何內容值。