Création d'une nouvelle ressource

Une ressource est créée en fournissant un emplacement comme argument à une méthode de création spécifique à un type.

Toutes les propriétés qui peuvent s'avérer nécessaires pour créer la ressource, telles que le flot pour l'activité, doivent être définies dans le proxy avant d'appeler la méthode create. Vous ne pouvez pas créer de ressource avec des valeurs vides ou non valides pour les propriétés requises. L'échec se produit (sous forme de WvcmException) lorsque vous appelez la méthode doCreateResource() ou doCreateGeneratedResource().

Le proxy Activité (a2, dans l'exemple suivant) est créé avant l'objet côté serveur. Par exemple :
CcStream stream = . . .;
CcActivity a2 = provider.ccActivity(provider.stpLocation("cc.activity:a_new_activity@\projects"));

// Définissez le titre
a2.setHeadline("The new task");

// Définissez le flot
a2.setStream(stream);

// créez l'activité
a2.doCreateCcActivity(); 
Une nouvelle ressource (comprenant une ControllableResource privée de fichier telle que CcFile ou CcDirectory) est créée comme suit :
  1. Déterminez l'adresse de la nouvelle ressource.
  2. Créez un objet Emplacement pour cette adresse à l'aide de l'une des méthodes StpProvider.stpLocation(). Créez un emplacement pour la ressource en ajoutant un segment enfant à l'emplacement du dossier sélectionné.
  3. Obtenez un proxy auprès du fournisseur pour cet emplacement. Créez un proxy dont la classe d'objet correspond au type de la nouvelle ressource en utilisant la méthode appropriée de fabrication de proxy du fournisseur.
  4. Renseignez le proxy avec les valeurs de propriété requises ou adéquates pour la nouvelle ressource. Etablissez les valeurs initiales des propriétés de ressource qui peuvent être définies à l'aide des méthodes set sur le nouveau proxy.
  5. Appelez l'opération créer-ressource (méthode doCreateResource) sur le proxy, qui renvoie un proxy pour la ressource nouvellement créée et qui contient toutes les valeurs de propriété demandées dans l'opération créer-ressource.

Commentaires