REST-Webdienst WSDL?

Ich bin Implementierung eines web service und ich umgesetzt haben sowohl eine REST-und SOAP-version zu sehen, die geeignet ist, meine Bedürfnisse.Ich habe beschlossen, zu wählen, REST wegen seiner Einfachheit und wahrscheinlich werde ich die Entwicklung einer iPhone-app zu konsumieren. Meine Frage ist eigentlich ganz einfach, ist es möglich, erstellen Sie eine WSDL oder WADL für meine REST-Dienst und ist es notwendig?

Dank

InformationsquelleAutor der Frage Ian | 2011-07-26

  1. 35

    Mit einem guten RESTful-Dienst, es ist nicht notwendig, um zu generieren WADL (geschweige denn die viel-weniger-gut sitzende WSDL) für es, weil es sich selbst zu beschreiben. Von "sich selbst beschreiben" ich habe mich extra bedeutet, dass es liefert Dokumente, die beschreiben, alle (relevanten) Ressourcen veröffentlicht durch den service, und dass die Verwendung eines standard-HTTP-OPTIONS-Anfrage auf diesen werden grundlegende Informationen darüber, wie Sie interagieren. Der einzige wirkliche Vorteil bei WADL ist, dass es erlaubt, den Anrufer zu entdecken, die schemas für komplexe Dokumente, die es braucht, um mit zu arbeiten, vor der Zeit; REST selbst bietet keine Hilfe gibt (und einige RESTians glauben, dass solche Dinge tun, ist kontraproduktiv, die ich bin mir nicht sicher, ich Stimme mit).

    Natürlich, dass dem nicht erfassen der tieferen Interaktionsmuster, aber auch nicht die überwiegende Mehrheit der WSDL-Beschreibungen der services keine änderung gibt.

    Für das Protokoll, ich benutze Apache CXF zum erstellen von RESTful-services (mit JAX-RS) und veröffentlicht, die WADL für Sie.

    InformationsquelleAutor der Antwort Donal Fellows

  2. 6

    Den W3C gemacht hat, die eine förmliche Empfehlung für eine REST documentation standard basierend auf WSDL 2.0. Hier ist ein Zitat aus der IBM Artikel:

    Dem Begriff Web services wird in der Regel in Zusammenhang mit Betriebs - oder
    Aktion-basierten services mit SOAP und die WS - * - standards, wie
    WS-Addressing und WS-Security. Der Begriff REST-Web-services im Allgemeinen
    bezieht sich auf eine Ressource-basierte Web-services-Architektur, die HTTP verwendet
    und XML. Jedes dieser architektonischen Web-service-Stile hat seinen Platz,
    aber bis vor kurzem der WSDL-standard hat nicht gleich unterstützen
    styles. Die WSDL 1.1-HTTP-Bindung nicht ausreicht, um zu beschreiben,
    Kommunikation mit HTTP und XML, so gab es keine Möglichkeit, formell
    beschreiben, REST Web services mit WSDL. Die Veröffentlichung von WSDL 2.0,
    wurde mit REST-Web-services im Kopf, als World Wide Web
    Consortium (W3C) eine Empfehlung bedeutet, dass es jetzt eine Sprache
    beschreiben, REST Web services.

    InformationsquelleAutor der Antwort chaotic3quilibrium

  3. 3

    Es ist natürlich möglich, aber für die Antwort, wenn es notwendig ist oder nicht, Sie hat nicht genug info.

    Ich schlage vor, Sie nehmen einen Blick auf der ibm developerworks-Website, die bieten einen interessanten Artikel zu dem Thema http://www.ibm.com/developerworks/webservices/library/ws-restwsdl/
    Hoffe, es hilft.

    Streng, mit WSDL 1.0 können Sie' t, aber mit WSDL2 Sie können, denn entwickelt wurde für akzeptieren diese Art von Nachfrage,

    "... WSDL 2.0 WS-I-Profil, dass an die Anforderungen
    für REST-style Web services. Die Zugabe von GET in SOAP 1.2 und mehrere
    Ergänzungen in WSDL 2.0-wie die Betriebssicherheit, die Fähigkeit zu beschreiben
    Nachrichten, die sich auf anderen Web-Diensten und der verbesserten HTTP-Bindung
    ist es nun möglich zu beschreiben, REST-style Web-services.", Arthur Ryman.

    InformationsquelleAutor der Antwort Giulia Di Federico

  4. 3

    Als @GiuliaDiFederico sagte, "natürlich ist es möglich" (mit WSDL2), zeigen eine gute Quelle link dazu, wie Sie tun. @DonalFellows, von anderer hand, nicht ermutigt, die Verwendung von WSDL...

    Ich denke der Einsatz von WSDL ist eine Frage der

    • FORMALISIERUNG EBENE: mit WSDL können Sie mehr Ausdrücken formal alle relevanten details zu Ihrem webservice.
    • STABILITÄTS-LEVEL: wenn Sie langfristige Verträge ab, und vermeiden Sie die Risiken von änderungen in der Umgebung, wo Ihr webservice ausgesetzt ist, WSDL hilft zu mantain Stabilität.
    • NOTWENDIGKEIT FÜR STANDARDS: wenn Kunden bevorzugen webservices, die gesagt werden kann, "standard-konform", Verwendung von standards. Der einzige W3C, W3C erfordert, XML, SOAP und WSDL.

    InformationsquelleAutor der Antwort Peter Krauss

  5. 3

    RestDoc versucht, zu erstellen eine einfache Dokumentation framework für REST Ressourcen.
    Ein browser ist über restdoc-renderer.

    Es bietet auch Java-Annotationen aktivieren von on-the-fly Erzeugung von RestDoc documetnation. Implementierungen sind verfügbar für Trikot 1.x und JAX-RS 2.0.

    InformationsquelleAutor der Antwort koppor

  6. 1

    Ich denke WSDL ist nicht geeignet für die ERHOLUNG und WADL ist nicht notwendig. HTTP macht schon was WADL beschreiben könnte in einer separaten Datei. Zum Beispiel die "Allow" - header gibt erlaubte HTTP-Methode, und die Content-Negotiation ist für die Wahl des richtigen format.

    InformationsquelleAutor der Antwort deamon

Schreibe einen Kommentar