|
|
Benoît Dissert -
on 9/13/11 at 9:36 AM
Bonjour,
Dans le principe d'une architecture REST, on peut envisager plusieurs rendus pour une ressource donnée.
Chaque format de rendu est appelé une "représentation" de la ressource, et, en général, on utilise la résolution avec les champs Accept (dans la requête) et Content-type pour déterminer la représentation.
Après, pour une API donnée, on a une ou plusieurs représentation disponible pour une ressource.
Dans le cadre de JCMS OpenAPI, il n'y a qu'une représentation disponible, à savoir, pour les données, la représentation XML correspondant à l'export XML (qui est utilisé pour l'import-export entre plusieurs site JCMS).
Cela dit, il est toujours possible d'envisager d'autre représentations (plein texte, Atom, JSON). Dans la version actuelle (JCMS 7.0 SP1), seuls ces types de représentations sont possibles.
L'API d'extension côté serveur, telle qu'elle existe aujourd'hui (JCMS 7.0 SP1) ne permet pas d'ajouter une représentation aux ressources déjà présentes de manière complètement non intrusive.
En effet, vous pouvez, en vous basant sur l'API existante :
- étendre les classes natives ;
- ajouter un Variant (pour qu'une nouvelle entrée dans Accept soit possible) ;
- implémenter une nouvelle méthode pour ajouter une représentation :
- getPlainTextRepresentation ;
- getJSONRepresentation ;
- getAtomRepresentation ;
- déclarer votre nouvelle ressource dans votre plugin.xml
Pourriez-vous donner un exemple de flux que vous aimeriez avoir (par exemple pour une donnée de type SmallNews) ?
Benoît
Consultant indépendant, spécialiste Jalios (et tout particulièrement JCMSOpenAPI)
|
|