Neue Ressource erstellen

Für die Erstellung einer Ressource wird eine Position als ein Argument an eine typspezifische Erstellungsmethode übergeben.

Alle Eigenschaften, die für die Erstellung der Ressource erforderlich sein könnten (wie beispielsweise der Datenstrom für die Aktivität), müssen im Proxy festgelegt werden, bevor die create-Methode aufgerufen wird. Eine Ressource kann nicht mit fehlenden oder ungültigen Werten für erforderliche Eigenschaften erstellt werden. Bei einem entsprechenden Versuch tritt ein Fehler auf (z. B. eine WvcmException), wenn Sie die Methode doCreateResource() oder doCreateGeneratedResource() aufrufen.

Der Activity-Proxy (im folgenden Beispiel a2) wird vor dem serverseitigen Objekt konstruiert. Beispiel:
CcStream stream = . . .;
CcActivity a2 = provider.ccActivity(provider.stpLocation("cc.activity:a_new_activity@\projects"));

// Festlegen der Überschrift
a2.setHeadline("Die neue Task");

// Festlegen des Datenstroms
a2.setStream(stream);

// Erstellen der Aktivität
a2.doCreateCcActivity(); 
Eine neue Ressource (einschließlich einer dateibereichsspezifischen ControllableResource wie CcFile oder CcDirectory) wird wie folgt erstellt:
  1. Bestimmen Sie die Adresse für die neue Ressource.
  2. Konstruieren Sie mit einer der StpProvider.stpLocation()-Methoden ein Location-Objekt für diese Adresse. Erstellen Sie eine Position für die Ressource, indem Sie zur ausgewählten Ordnerposition ein untergeordnetes Segment hinzufügen.
  3. Rufen Sie vom Provider einen Proxy für diese Position ab. Konstruieren Sie einen Proxy, dessen Objektklasse dem Typ der neuen Ressource entspricht. Verwenden Sie dazu die geeignete Factory-Methode des Providerproxys.
  4. Füllen Sie den Proxy mit allen Eigenschaftswerten, die für die neue Ressource erforderlich oder angemessen sind. Legen Sie die Anfangswerte für die Ressourceneigenschaften fest, die mit den set-Methoden für den neuen Proxy gesetzt werden können.
  5. Rufen Sie die Ressourcenerstellungsoperation (Methode doCreateResource) für den Proxy auf. Die Methode gibt für die neu erstellte Ressource einen Proxy zurück, der alle in der Ressourcenerstellungsoperation angeforderten Eigenschaftswerte enthält.