web-services - REST Web サービスの「WSDL」に推奨される方法は何ですか?

Question

私はたくさんのSOAP Webサービスを構築しましたが、特定のプロジェクト用にREST Webサービスを構築しています.RESTサービスの「WSDL」に何を使用しているのか、それが必要なのか疑問に思っていました.

Answer 1

JSON オープン標準を使用して REST サービスを記述できるSwagger (現在は OpenAPI) を試すことができます。

Answer 2

REST は実際には、リソースに対して HTTP 動詞 (GET、PUT、POST、DELETE) のみを使用します。リソースに対するすべての操作は、そのように表現されるはずです。POST は、ビジネス ロジックを他の 3 つの方法で表現できない場合のキャッチ オールとして使用されます。リソースには 4 つのメソッドしかないため、実際には REST サービス用の WSDL が存在しないのはそのためです。Zend Framework REST ライブラリは実際には RESTful ではなく、単純な古い XML (POX) サービスであることに注意してください。

Answer 3

RESTful Web アプリケーションは WSDL に直接対応するものを必要としないという Sam の意見は正しいですが、RESTful Web アプリケーションを記述するのに役立つ XML ボキャブラリーがあります: WADL、またはWeb Application Description Languageです。私の会社では主に WADL を使用して、構築したい特定のサービスの仕様を定義します。通常、プログラムで使用することはありません。とはいえ、WADL ホームページにはコード生成用の Java ツールがいくつか含まれており、Java REST フレームワークであるRestletには、WADL に基づいてアプリケーションを動的に配線し、配線されたアプリケーションに基づいて WADL を動的に生成するための WADL 拡張機能が含まれています。私は WADL のファンです。ぜひチェックしてみてください。

Answer 4

実際には WSDL を使用することは可能ですが、v 2.0 である必要があります。「 WSDL 2.0 を使用して REST Web サービスを記述する」記事を参照してください。

Answer 5

REST サービスで XML を使用している場合は、XSD を指定できます。

または、XML の例だけで、とにかく単純なデータ構造を解決するのに十分なはずです。