Ich habe viele SOAP-Webservices erstellt, aber ich erstelle einen REST-Webservice für ein bestimmtes Projekt, und ich frage mich, was Leute für eine WSDL für REST-Dienste verwendet haben oder ob sie überhaupt benötigt wird.Was ist die bevorzugte Methode für eine 'WSDL' für den REST-Webservice?
Sie können versuchen Swagger (jetzt OpenAPI), die ermöglicht, REST-Dienste mit einem offenen JSON-Standard zu beschreiben.
Sie können eine XSD bereitstellen, wenn Sie XML in Ihrem REST-Service verwenden.
Oder nur Beispiele der XML, sollte ausreichen, um Dinge für einfache Datenstrukturen sowieso zu erarbeiten.
REST verwendet wirklich nur die HTTP-Verben (GET, PUT, POST, DELETE) auf einer Ressource. Alle Operationen auf einer Ressource sollen so dargestellt werden. POST wird als ein Haken für alle verwendet, wenn Sie Ihre Geschäftslogik nicht in einer Weise ausdrücken können, die in die anderen drei passt. Aus diesem Grund gibt es für einen REST-Dienst nicht wirklich eine WSDL, da Sie nur 4 Methoden für die Ressource haben. Beachten Sie, dass die REST-Bibliothek des Zend Framework nicht wirklich REST-konform ist und eher ein einfacher XML-Dienst (POX) ist.
Während Sam korrekt ist, dass REST-konforme Webanwendungen keine direkte Analogie zu WSDL benötigen, gibt es ein XML-Vokabular, das hilfreich ist, um RESTful-Webanwendungen zu beschreiben: WADL oder Web Application Description Language. In meiner Firma verwenden wir hauptsächlich WADL, um eine Spezifikation für einen bestimmten Dienst zu definieren, den wir erstellen wollen - wir verwenden ihn im Allgemeinen nicht programmatisch. Das heißt, the WADL home page enthält einige Java-Tools für die Codegenerierung und Restlet, das Java-REST-Framework, enthält eine WADL-Erweiterung für die dynamische Verdrahtung von Anwendungen auf WADL-Basis und die dynamische Generierung von WADL basierend auf einer verdrahteten Anwendung. Ich bin ein Fan von WADL und empfehle Ihnen, es zu überprüfen.
Eigentlich ist es möglich, WSDL dafür zu verwenden, aber es sollte v 2.0 sein - siehe "Describe REST Web services with WSDL 2.0" Artikel.
Ich denke nicht, dass die Frage über XML-Inhalt, so sehr wie die Definition der API-Vertrag und Form der ausgetauschten Daten, unabhängig von ihrer Formatierung. –