Classe entité de service distant (stereotype)
De Wiki1000
(Différences entre les versions)
(Page créée avec « ==Classe Entité non persistante de Service distant (sdata)== Ce stéréotype permet de gérer les objets distants comme des objets non persistants il faut appeler une mét… ») |
|||
(14 révisions intermédiaires par 2 utilisateurs sont masquées) | |||
Ligne 1 : | Ligne 1 : | ||
− | + | {{tip|Ces classes s'utilisent dans un scénario Client pour consommer des ressources SData}} | |
− | + | Les classes entité de service distante non persistante sont des classes permettant de manipuler des ressource exposées par un Service SData. | |
− | + | Il y a deux façon d'utiliser ces classes : | |
− | + | ||
− | {{ | + | * Avec un objet fournisseur de Service. |
+ | :Dans ce cas vous devez créer un objet de la classe TSDataServiceProviderInfo et définir manuellement les valeurs de ses propriétés puis utiliser cet objet pour effectuer les opérations GET,POST,PUT,DELETE SData. | ||
+ | |||
+ | * Avec un fournisseur de Service enregistrée dans l'administration. | ||
+ | :Dans ce cas vous devez définir les propriétés du Service dans les Fournisseurs de Service de l'administration, associer ce fournisseur à la base de données de l'application puis appeler directement les méthodes du stéréotype pour effectuer les opérations GET,POST,PUT,DELETE SData. | ||
+ | |||
+ | ===Attributs du stéréotype=== | ||
+ | {|class="wikitable" | ||
+ | |- | ||
+ | |[[SDataID (TSDataRemoteObjectNP)|SDataID]] | ||
+ | |Identifiant de ressource | ||
+ | |- | ||
+ | |[[SDataKey (TSDataRemoteObjectNP)|SDataKey]] | ||
+ | |[http://interop.sage.com/daisy/sdata/AnatomyOfAnSDataFeed/190-DSY.html Identifiant de clé primaire SData] | ||
+ | |- | ||
+ | |[[SDataEtag (TSDataRemoteObjectNP)|SDataEtag]] | ||
+ | |Identifiant de version | ||
+ | |- | ||
+ | |[[SDataUUID (TSDataRemoteObjectNP)|SDataUUID]] | ||
+ | |Identifiant de correlation | ||
+ | |- | ||
+ | |[[SDataServiceProvider (TSDataRemoteObjectNP)|SDataServiceProvider]] | ||
+ | |Fournisseur de service SData | ||
+ | |} | ||
+ | |||
+ | ===Méthode du stéréotype=== | ||
+ | {|class="wikitable" | ||
+ | |- | ||
+ | |[[Get (TSDataRemoteObject)|Get]] | ||
+ | |Retrouve une ressource par son identifiant SData | ||
+ | |- | ||
+ | |[[GetWhere (TSDataRemoteObject)|GetWhere]] | ||
+ | |Retrouve une ressource par une clause Where | ||
+ | |- | ||
+ | |[[GetList (TSDataRemoteObject)|GetList]] | ||
+ | |Retrouve une liste de ressources | ||
+ | |- | ||
+ | |[[Post (TSDataRemoteObject)|Post]] | ||
+ | |Crée la ressource sur le serveur distant | ||
+ | |- | ||
+ | |[[Put (TSDataRemoteObject)|Put]] | ||
+ | |Met à jour la ressource sur le serveur distant | ||
+ | |- | ||
+ | |[[Delete (TSDataRemoteObject)|Delete]] | ||
+ | |Supprime la ressource sur le serveur distant. | ||
+ | |- | ||
+ | |[[DeleteByKey (TSDataRemoteObject)|DeleteByKey]] | ||
+ | |Supprime la ressource sur le serveur distant. | ||
+ | |} | ||
+ | |||
+ | Exemple : | ||
+ | |||
+ | Création d'une ressource sur un Service SData en utilisant un objet [[Fournisseur de Service (sdata)|fournisseur de Service]] : | ||
+ | |||
+ | <source lang="delphi"> | ||
+ | var inst:remoteEntity; prv:TSDataServiceProviderInfo; | ||
+ | begin | ||
+ | // create an instance of sdata service provider | ||
+ | prv := TSDataServiceProviderInfo.Create; | ||
+ | prv.UserName := userName; | ||
+ | prv.UserPassword := jeton; | ||
+ | prv.EndPointURL := endpoint; | ||
+ | |||
+ | // Build a ressource | ||
+ | // | ||
+ | inst := remoteEntity.create; | ||
+ | inst.code := remoteCode; | ||
+ | ... | ||
+ | prv.PostEntity(inst); | ||
+ | end; | ||
+ | </source> | ||
+ | |||
+ | Création d'une ressource sur un Service SData en utilisant un [[Fournisseur de Service (sdata)|fournisseur de Service]] enregistré dans l'administration : | ||
+ | |||
+ | <source lang="delphi"> | ||
+ | var inst:remoteEntity; | ||
+ | begin | ||
+ | // build a remote sdata entity | ||
+ | // | ||
+ | inst := remoteEntity.create; | ||
+ | inst.code := remoteCode; | ||
+ | ... | ||
+ | inst.Post; | ||
+ | end; | ||
+ | </source> | ||
+ | |||
+ | |||
+ | {{warning|Pour fonctionner, les classes qu'on souhaite instancier doivent appartenir à un paquet dont le module est lié à la base de données,courante.}} | ||
+ | |||
+ | Voir aussi : | ||
+ | |||
+ | * [[TSDataServiceProviderInfo (class)|Classe fournisseur de Service]] | ||
+ | * [[Gestion des relations des classes entité de service distant]] | ||
− | |||
[[Category:Stereotype]] | [[Category:Stereotype]] | ||
+ | [[Category:SData]] | ||
+ | [[Category:Stéréotype entité de service distant]] |
Version actuelle en date du 15 mars 2013 à 10:08
Les classes entité de service distante non persistante sont des classes permettant de manipuler des ressource exposées par un Service SData.
Il y a deux façon d'utiliser ces classes :
- Avec un objet fournisseur de Service.
- Dans ce cas vous devez créer un objet de la classe TSDataServiceProviderInfo et définir manuellement les valeurs de ses propriétés puis utiliser cet objet pour effectuer les opérations GET,POST,PUT,DELETE SData.
- Avec un fournisseur de Service enregistrée dans l'administration.
- Dans ce cas vous devez définir les propriétés du Service dans les Fournisseurs de Service de l'administration, associer ce fournisseur à la base de données de l'application puis appeler directement les méthodes du stéréotype pour effectuer les opérations GET,POST,PUT,DELETE SData.
Attributs du stéréotype
SDataID | Identifiant de ressource |
SDataKey | Identifiant de clé primaire SData |
SDataEtag | Identifiant de version |
SDataUUID | Identifiant de correlation |
SDataServiceProvider | Fournisseur de service SData |
Méthode du stéréotype
Get | Retrouve une ressource par son identifiant SData |
GetWhere | Retrouve une ressource par une clause Where |
GetList | Retrouve une liste de ressources |
Post | Crée la ressource sur le serveur distant |
Put | Met à jour la ressource sur le serveur distant |
Delete | Supprime la ressource sur le serveur distant. |
DeleteByKey | Supprime la ressource sur le serveur distant. |
Exemple :
Création d'une ressource sur un Service SData en utilisant un objet fournisseur de Service :
var inst:remoteEntity; prv:TSDataServiceProviderInfo; begin // create an instance of sdata service provider prv := TSDataServiceProviderInfo.Create; prv.UserName := userName; prv.UserPassword := jeton; prv.EndPointURL := endpoint; // Build a ressource // inst := remoteEntity.create; inst.code := remoteCode; ... prv.PostEntity(inst); end;
Création d'une ressource sur un Service SData en utilisant un fournisseur de Service enregistré dans l'administration :
var inst:remoteEntity; begin // build a remote sdata entity // inst := remoteEntity.create; inst.code := remoteCode; ... inst.Post; end;
Attention : Pour fonctionner, les classes qu'on souhaite instancier doivent appartenir à un paquet dont le module est lié à la base de données,courante. |
Voir aussi :
Whos here now: Members 0 Guests 0 Bots & Crawlers 1 |