Java での Web サービスは初めてです。
SOAP Web サービスでは、操作などのサービスについて通知する wsdl がありますが、REST では wsdl を取得しません。
したがって、私の質問は、誰かがサービスの詳細を知りたい場合、REST Web サービスの場合にそれを見つける方法です。
2 に答える
2
REST では、これを達成するための単一の確立された方法はまだありませんが、いくつかのオプションが出現しています。
- Swagger http://swagger.wordnik.com/ - ソース コードの注釈を検査し (Web フレームワーク JAX-RS 注釈、Spring 注釈、Play2 をサポート)、API を説明する JSON ドキュメントを生成します。この JSON ドキュメントは、 swagger-uiを使用して、エンド ユーザー ドキュメントとしてインタラクティブな Web ページとして表示できます。
- Json ホーム https://datatracker.ietf.org/doc/html/draft-nottingham-json-home-02 - RESTful API を説明する JSON ドキュメントの仕様
- WADL http://en.wikipedia.org/wiki/Web_Application_Description_Language
于 2012-12-10T08:27:16.850 に答える
2
SOAP はサービスを記述するために WSDL を導入しました。サービスは自動的に検出され、UDDI などのメカニズムと統合されます。実際には、SOAP はハードコーディングされた RPC と同じように使用されます。REST を使用する場合、例外処理、操作の種類、べき等性などの多くの詳細は、よく知られている HTTP メカニズムを使用して処理されます。知っておく必要があるのは、ペイロードのエンコーディングだけです。XML を使用する場合は、XSD を使用してサービスを記述できます。JSON を使用する場合は、これを自分で処理する必要があります (はるかに単純です)。URL の構造は、1 ページの readme ファイルで説明できるように、十分に直感的に設計する必要があります。長い答えを簡潔に言うと、Web サービスは非常に複雑であり、多くのボイラープレートが必要でした。REST サービスは非常に単純であるため、開発者は基本を再定義して再文書化する必要はありません。
于 2012-12-10T08:27:49.113 に答える