Services RESTful - WSDL Équivalent

J'ai lu sur le REPOS et le SAVON, et de comprendre pourquoi la mise en œuvre de REPOS peut être bénéfique sur l'aide d'un protocole SOAP. Cependant, je ne comprends toujours pas pourquoi il n'y a pas le "WSDL" équivalent dans le RESTE du monde. J'ai vu des posts disant qu'il y a "pas besoin" pour le WSDL ou qu'elle est redondante Dans le RESTE du monde, mais je ne comprends pas pourquoi. N'est-il pas toujours utile de programmation pour la lier à une définition et à créer des classes de proxy au lieu de saisir manuellement le codage? Je ne veux pas entrer dans un débat philosophique, à la recherche de la raison pour laquelle il n'existe pas de fichier WSDL dans le REPOS, ou pourquoi il n'est pas nécessaire. Merci.

  • J'ai la même question. Il semble à partir d'un client de perspective services restful sont beaucoup plus difficile à utiliser ensuite un document WSDL du service.
  • Il me semble que si vous êtes d'exposer quelque chose de simple, alors vous n'avez pas besoin d'un WADL ou WSDL. Mais si vous êtes d'exposer quelque chose d'aussi complexe que SAP... je ne peux pas imaginer de ne pas avoir une sorte de réflexion et d'espace de noms pour gérer la pléthore de fonctionnalités.
  • Ne pouvais pas le HTTP méthode des OPTIONS être considéré comme un "équivalent" comme il se doit de fournir des informations sur les méthodes et les paramètres requis pour toute action possible?
InformationsquelleAutor skaz | 2010-11-06
  1. 39

    La Application Web Langage De Description De (WADL) est essentiellement l'équivalent d'un fichier WSDL pour les services RESTful mais il y a eu une controverse en cours si quelque chose comme cela est nécessaire à tous.

    Joe Gregorio a écrit un bel article à propos de ce sujet qui est intéressant à lire.

    • Grâce Joschi. J'ai lu les articles, mais n'ai pas trouvé la seconde de trop convaincant. Les points qu'il aborde avez-vous trouvé le plus précieux?
    • Il est intéressant de noter qu' .NET a également un moyen de publier des métadonnées (msdn.microsoft.com/en-us/library/ms730243.aspx). Avec cela dit, la plupart des services RESTE que j'ai vu développés par les grands sites comprennent une variété de clients téléchargeables développé pour les principaux langages de programmation (Java, .NET, PHP, etc). À mon avis, cela met beaucoup de charge sur le fournisseur de services.
    • Ne semble pas beaucoup de point dans la rédaction d'un service qui vous exige alors d'écrire aussi sur le client?
    InformationsquelleAutor joschi
  2. 16

    WSDL décrit les points de terminaison du service. RESTE les clients ne devraient pas être couplé à des points de terminaison de serveur (c'est à dire ne doit pas être au courant d'une Url à l'avance). RESTE les clients sont couplés sur les types de médias qui sont transférées entre le client et le serveur.

    Il peut faire sens pour générer automatiquement les classes sur le client pour s'enrouler autour de la retourné types de médias. Cependant, dès que vous commencez à créer des classes de proxy à travers le service interactions de commencer à obscurcir la HTTP interactions et risque de dégénérer en arrière vers un modèle RPC.

    • Pouvez-vous nous en dire un peu plus? J'ai peur de ne pas l'obtenir. Merci.
    • Essayez cette roy.gbiv.com/untangled/2008/rest-apis-must-be-hypertext-driven
    • Des classes de Proxy sont un moyen d'avoir la machine de validation au moment de la compilation. Sans eux, vous ne l'avez écrit manuellement docs et les tests basés sur la "validation".
    • cependant, cette approche a très bien fonctionné pour le web jusqu'à présent.
    • dépend ce que tu appelles "bien travaillé", c'est comme dans les années 80, lorsque tout le monde serait d'écrire son interops de papier docs, de sorte qu'il fonctionne, mais "bien"?
    • Venant d'une banque, le RESTE n'a pas d'avantages. Vous avez BESOIN de taper fort et de la compilation de validation, sinon vous êtes tout simplement écrit des scripts de test contre "quelque chose"...obtenir l'ensemble des scripts de même un peu de mal et vous ne saurez pas jusqu'à ce qu'il soit trop tard.
    • En dépit de ce que vous voyez dans la pratique courante, le RESTE est en fait très fortement typé. Chaque charge utile a un support de type qui a un cahier des charges qui décrit la sémantique de la charge utile exactement. Les Api REST ne devrait jamais exiger des clients pour comprendre la sémantique qui ne sont pas explicitement mentionnés dans le message HTTP.
    • Merci @DarrelMiller - peut-être que sa viens de la implémentations qui sont pauvres alors. Cependant, nous amène à la question COMMENT récupérer les médias-type de cahier des charges? Je ne veux pas l'aversion de REPOS...mais tout ce que j'ai travaillé avec des m'a laissé le sentiment que c'est un quick-and-dirty solution...merci de me prouver le contraire.
    • Les médias de type specs sont traitées à l'ancienne. Soit vous trouver un analyseur syntaxique pour le spec, ou vous pouvez aller lire la spec et écrire vous-même. La chose importante à noter est que l'objectif est le type de support des spécifications à être ré-utilisable à travers des Api. L'écriture d'un nouvel analyseur pour chaque API, défaites le point. RESTE quand c'est fait droit est pour le très long terme, les avantages de l'évolution indépendante de client et de serveur.
    • Merci encore @DarrelMiller -1) Que sont les "media-type specs" - celui que j'ai donné, c'est un document word, ce qui a des incohérences dans ce que je peux repérer avant même le développement! -2) cela signifie Types de Médias sont destinés à être "global" et immuable? par exemple, Si le repos de service que je REÇOIS de changements, il est media-type, alors comment puis-je savoir jusqu'à ce que j'obtiens une erreur? Que faire si les médias-type de modifications/évolue? Êtes-vous censé version les types de médias?
    • À l'échelle mondiale types de médias enregistrés sont ici iana.org/assignments/media-types/application/index.html Vous pouvez créer votre propre, vous devez les enregistrer, L'en-tête HTTP Content-Type indique quel type de support le serveur est de retour. Vous pouvez dire le serveur qui les types de médias que vous comprenez dans la demande d'en-tête Accept. Vous pouvez version types de médias, mais il est préférable de conception d'évoluer. Un HTML 1.0 doc peut encore être consommé aujourd'hui les navigateurs web et a toujours texte/html comme type de média.
    • Q) Sont des services RESTful plus orienté vers l'interaction avec quelque chose de visuel? c'est à dire un site web/fil d'actualité? par exemple, Vous pouvez construire votre site autour de quelqu'un d'autre services restful pour interagir avec elle...donc, comme vous le savez, le premier bit pour commencer, tout en restant interaction (URI) est retourné par le service lui-même?

    InformationsquelleAutor Darrel Miller
  3. 7

    RSDL vise à faire de repos, comme un hypermédia, en d'autres termes, il a plus d'informations qu'un descripteur de service comme WSDL ou WADL. Par exemple, il dispose de l'information sur la navigation, comme hypertextes et hyperliens.

    Par exemple, étant donné un ressources actuelles, vous disposez d'un ensemble d'os des liens vers un autre ressources connexes.

    Cependant, je n'ai pas trouver le Repos des Clients qui prend en charge ce format ou de Repos des Solutions de Serveur avec une fonctionnalité d'auto générer.

    Je pense qu'il y a un long chemin pour une conclusion à ce sujet. Voir le code HTML longue histoire et le W3C vs Navigateurs lol.

    Pour plus de détails au sujet Reste comme Hypermédia regarder: http://en.wikipedia.org/wiki/HATEOAS

    Remarque : Roy Fielding a critiqué ces tendances dans les Api Rest sans hypermidia approche: http://roy.gbiv.com/untangled/2008/rest-apis-must-be-hypertext-driven

    Ma Conclusion : Maintenant, un jour, WADL est plus commun que le Repos et l'Intégration des Frameworks comme Chameau CXF prend déjà en charge WADL ( de générer et d'exploiter ), parce qu'il est semblable WSDL, donc plus facile à comprendre dans ce processus de migration ( SAVON pour les MAINS ).

    Nous allons voir les prochains chapitres 😉

    InformationsquelleAutor Eduardo Fabricio
  4. 7

    N'est-il pas toujours utile de programmation pour la lier à une définition et à
    créer des classes de proxy au lieu de saisir manuellement le codage?

    Tout à fait d'accord, c'est pourquoi j'ai personnellement utilisé Swagger.io

    Swagger est un puissant framework open source soutenu par un grand
    l'écosystème d'outils qui vous aide à concevoir, construire, document, et de consommer
    votre RESTful Api.

    Donc, fondamentalement, je utiliser Swagger pour décrire mes modèles, les systèmes d'extrémité, etc, puis-je utiliser d'autres outils comme swagger-codegen pour générer les classes proxy au lieu de saisir manuellement à coder ça.

    Voir aussi: RAML

    • Ne savais pas Swagger aussi l'a fait. Pensé qu'il était juste de documentation/cadre générique pour l'Api REST
    InformationsquelleAutor Alex Nolasco
  5. 5

    Il y a un RSDL (reposant service description language) qui est l'équivalent de WSDL. L'URL ci-dessous décrit sa pratique http://en.wikipedia.org/wiki/HATEOAS et http://en.wikipedia.org/wiki/RSDL.
    Le problème est que nous avons beaucoup d'outil pour générer du code à partir de wsdl pour java, ou l'inverse.
    Mais je n'ai pas trouvé un outil pour générer du code à partir de RSDL.

    InformationsquelleAutor richard
  6. 1

    WSDL est extensible pour permettre la description des points de terminaison et de leurs messages, indépendamment de ce que les formats de message ou les protocoles réseau sont utilisés pour communiquer

    Cependant, RESTE utilise le protocole réseau en utilisant le protocole HTTP verbes et les URI pour représenter des objets dans l'état.

    Langage wsdl vous dire à cet endroit, si vous envoyez ce message, vous devrez effectuer cette action et d'obtenir ce format en arrière.

    En RESTE, si j'ai voulu créer un nouveau profil, je voudrais utiliser le verbe POST avec un JSON corps ou serveur http variables décrivant mon profil à l'URL /profile

    POST doit retourner un côté serveur ID généré en utilisant le code d'état 201 CREATED et l'en-tête Location: *new_profile_id* (par exemple 12345)

    Je pouvez ensuite effectuer des mises à jour de l'évolution de l'état de /profile/12345 en utilisant le verbe HTTP POST, dire de changer mon adresse e-mail ou numéro de téléphone. Évidemment modification de l'état de l'objet distant.

    GET serait de retour l'état actuel de la /profile/12345

    PUT est généralement utilisé pour le côté client ID généré

    DELETE, évident

    HEAD, obtient le statut sans avoir à retourner le corps.

    Avec le RESTE, il devrait être auto-documenter par le biais d'un API et donc plus facile à utiliser.

    C'est un excellent article sur le REPOS. - Il vraiment m'aider à comprendre aussi.

    • Je dirais que c'est l'hypermédia contrainte de REPOS, plus que l'uniforme de la contrainte d'interface qui élimine la nécessité pour de WSDL.
    • Où vous découvrez le "profil"? Comment fournir de l'aide quand au lieu d'un seul, vous avez des dizaines? Tout le reste du service là s'appuient sur des écrits à la main docs et écrit manuellement Api, qui sont beaucoup de travail et de risques d'erreur.
    • Je suis d'accord avec @EricGrange - s'il vous plaît pourriez-vous nous expliquer COMMENT vous savez quelles sont les entités, vous pouvez effectuer les opérations CRUD(L) opérations SUR les...à moins que quelqu'un écrit quelque part?
    InformationsquelleAutor roder
  7. 1

    Spécification WSDL 2.0 a ajouté le support pour les services web REST trop. Le meilleur des deux mondes scénario. Le problème est WSDL 2.0 n'est pas largement pris en charge par la plupart des outils là-bas encore. WSDL 2.0 est recommandée par W3C, WSDL1.1 n'est pas recommandée par W3C, mais largement soutenue par les outils et les développeurs.
    Ref:
    http://www.ibm.com/developerworks/library/ws-restwsdl/

    InformationsquelleAutor supernova
  8. 0

    L'Application Web Langage de Description (WADL) est un vocabulaire XML utilisé pour décrire des services web RESTful.

    Comme avec WSDL, un client générique peut charger un WADL de fichier et d'être immédiatement équipé d'accéder à toutes les fonctionnalités du service web correspondant.

    Depuis RESTful services de simplifier les interfaces, WADL n'est pas aussi nécessaire à ces services WSDL est de style RPC SOAP services.

    InformationsquelleAutor JSS