Discussion :

[knebhi]

Bonjour,

j'aimerai savoir quelles sont les technologies les plus recommandées pour décrire un web service ReST ?
D'autre part, j'aimerai savoir si vous me conseillez un client particulier pour consommer ce genre de web service ?
j'utilise actuellement la librairie Curl de php.

merci

[Tommy31]

La description des resources se fait habituellement en WADL (http://en.wikipedia.org/wiki/Web_App...ption_Language), un dialecte XML pendant de WSDL pour SOAP.

Il est intéressant de le proposer en réponse d'une invocation sur une resource par le verbe OPTIONS, ce qui permet la découverte de services sans introduire le document WADL en tant que resource supplémentaire.

Il est également possible de le proposer en différentes saveurs (json ou html).

[knebhi]

La description des resources se fait habituellement en WADL (http://en.wikipedia.org/wiki/Web_App...ption_Language), un dialecte XML pendant de WSDL pour SOAP.

Il est intéressant de le proposer en réponse d'une invocation sur une resource par le verbe OPTIONS, ce qui permet la découverte de services sans introduire le document WADL en tant que resource supplémentaire.

Il est également possible de le proposer en différentes saveurs (json ou html).

merci pour la réponse. est ce que tu aurais un lien vers un tutoriel qui montre un peu le côté pratique ?

[Mihinot]

La description des resources se fait habituellement en WADL (http://en.wikipedia.org/wiki/Web_App...ption_Language), un dialecte XML pendant de WSDL pour SOAP.

Il est intéressant de le proposer en réponse d'une invocation sur une resource par le verbe OPTIONS, ce qui permet la découverte de services sans introduire le document WADL en tant que resource supplémentaire.

Il est également possible de le proposer en différentes saveurs (json ou html).

Salut Tommy,

Je travaille actuellement sur le potentiel développement de webservices REST/JSON et je vois que tu fais allusion à cette possibilité, aurais-tu des liens à me soumettre stp ?

PS: un vieux post...je sais mais comme quoi j'en ai encore besoin

[Tommy31]

Quelle technologie utilises-tu ?

[Mihinot]

Salut,

J'utilise actuellement Maven, xml, Jersey, Jaxb et je veux me servir de jackson pour le parsing json. je m'exerce à l'utilisation d'apache httpclient pour accéder aux ressources mais s'il y mieux j suis preneur. J'ai pas mal avancé mais une aide en plus est tjrs la bienvenue vu que je nage encore à vue... :s

Merci

[DeathMaker]

WADL n'est-il pas anti-REST justement ?

D'après mes quelques lectures, un client devrait (je dis bien devrait) pouvoir naviguer au sein de l'API de manière autonome (via la découverte de liens ou par la méthode OPTIONS comme tu l'indiques).

Donc faut-il mettre à disposition un WADL lorsque l'on créer un web service REST ?

Et comment mettre à disposition du client tous les paramètres possible qui peuvent être passés lors de l'appel à un GET sur une ressource ?

[nicorama]

Par experience, et sauf cas très particulier, mieux vaux avoir une bonne documentation que s’embêter avec un WADL qu'aucun outil ne sait correctement gérer.

Ce blog date de 2007 : Do we need WADL ?

[montesq]

Pour se convaincre de l'inutilité du WADL, il suffit de naviguer sur le web pour lire la documentation des services Web des "grands"

google -> https://developers.google.com/google-apps/app-apis
twitter -> https://dev.twitter.com/docs
facebook -> https://developers.facebook.com/docs/reference/api/

et plus généralement pour trouver d'autres API: http://www.programmableweb.com/

Je n'ai jamais croisé de WADL de mon côté. Je suis d'accord avec DeathMaker pour considérer que le WADL est contraire à l'esprit REST...