Java コード用の適切な javadoc を作成するための優れた例とガイドラインが多数あります (ref [1] を参照)。

Restletを使用してWADL経由でRESTインターフェースを文書化しています

http://wiki.restlet.org/docs_2.0/13-restlet/28-restlet/72-restlet.html

そのチュートリアルを引用して、次のようなコードを追加しています...

適切な簡潔な WADL のコーディング標準または例はありますか。たとえば、HTTP 動詞または URL に暗黙的に含まれる情報を複製したくありません。

参照 1. Javadoc ツールのドキュメント コメントの書き方。私は新しいユーザーなので URL を追加できませんが、
www.oracle.com/technetwork/java/javase/documentation/index-137868.htmlのガイドラインを意味します。

こんにちは、WADL Web サービスを使用してスタブを作成したいと考えています。

スタブジェネレーターを使用してwsdlファイルからスタブを作成する方法を知っています.netbeans j2me Webサービスクライアントからでもwscompileします

しかし、WADLファイルがあり、WSDLと同じ方法でスタブを作成していると、次のエラーが発生します

ここで何が問題なのですか?? WADL ファイルのスタブを作成する別の方法がありますか?

エラーは期待される WSDL を示しているので、WADL を使用してスタブを作成する別の方法があるはずです。

WADL のスタブを作成することは可能ですか?

私はWebサービスの分野に不慣れです。REST バインディングで WSDL を使用することはできますか? それとも WADL を使用する必要がありますか?

ここで説明されているとおり: http://wikis.sun.com/display/Jersey/WADL

Tomcat 6 で Jersey 1.4 を使用しています。

「/application.wadl」を使用してすべての可能な URI を試しましたが、取得できるのは 404 (利用できません) だけです。私は明らかに何かを理解していませんが、私が読んだすべてのブログは、これが「すぐに使える」機能のように聞こえます。私はTomcat 6を使用しています..これは問題ですか？

ここでWadlResourceオブジェクトの使用に関する Pavel の例を使用できましたが、これを行う必要はないようです。 ：結果

ありがとう。

RESTeasy 実装を使用して RESTful Web サービスを作成し、EJB を JSON に変換しました。そして今、私はクライアント側の開発に取り組んでいます。私はネットビーンズを使用しています。WADL ファイルを生成するにはどうすればよいですか? そして、問題なくクライアントスタブを生成した後。

どうすればこれを行うことができるか教えてください。または、別の簡単な方法を知っているかもしれません。

どうもありがとう！アルテム

RESTful サービス用の WADL ファイルを取得する必要があります。ジャージを使用する場合は、として利用できることを知っていますhttp://localhost:8080/application.wadl。しかし、RESTeasy を使用しています。

フレームワークのケースで同じことを行うことはできますか?

Web サービスが残りの動作をサポートしているかどうかを確認するにはどうすればよいですか? また、サービスがRestをサポートしている場合、そのサービスは、メソッド名、メソッドパラメーター、およびメソッドタイプ（Get、put、postなど）を取得できる記述子（WADLなど）を公開しますか？

WSDL 2.0 は Rest をサポートしていますが、現在それをサポートする Web サービスはありません。

ありがとう、アシフ

こんにちは、Tomcat で実行されている残りの Web サービスがあります。wadlを生成しようとしています。私が読んだのは、 url:http://ip:8080/application.wadlと入力するだけで生成されるということです。ただし、取得するのは 404 ステータスだけです。たとえば、展開された戦争名が ABC の場合、実行しようとしていますhttp://ip:8080/ABC.wadlが、再び 404.

私が間違っていることは何か分かりますか？

整数や文字列などのプリミティブだけでなく、任意の複雑なオブジェクトを引数として取り込む必要があるJAX-RSを使用していくつかのサービスを作成しています。CXFメーリングリストに関する議論では、この場合、ラッパーオブジェクトを単一のパラメーターとして使用するだけであると述べています。

私の懸念は、サービスへの入力形式をどのように文書化するかです。次のようなサービスを作成する場合：

CXFが生成する自動生成されたWADLは、以下のみを生成します。

これには、要求または応答に実際に含まれている内容に関する情報は含まれていません。CXFメーリングリストのSergeyは、スキーマを表現にリンクすることは可能であると述べましたが、どうすればよいでしょうか。また、XSDを作成するにはどうすればよいですか？

（PSべき等リソースにPOSTを使用することは、RESTfulではないかもしれませんが、本質的にJsonを使用してRPCを実行しているため、ここでは重要ではありません。これは、多かれ少なかれ既存のSOAPベースのAPIの1：1クローンです。）

状況：

私たちは、古いSOAP（Spring、apache CXF）Webサービスのセットの長い側に新しいサービスのセットを構築することを計画しています。私たちの顧客は、？wsdlを使用して、サービスとそれが受け入れる/返すコンテンツを説明するwsdlを取得できることに慣れています。

SpringコントローラーとRESTfulURLを介して新しいサービスを提供することを検討しています。ただし、すべてのリクエストをRESTful URLで処理できるわけではないため、ペイロードのリクエストとレスポンスが必要です。@RequestBodyと@ResponseBody、およびSpringのメッセージコンバーターを使用して、XMLコンテンツとJSONコンテンツの両方を自動（魔法のように）処理することを検討しています。スプリングに可能な限りヒービングリフティングを行わせるというアイデア。

問題：

私は、REST /メッセージコンバーターの概念を前提として、？wsdl要求と同様の方法でサービスとその要求/応答データの説明を提供できるかどうかを理解しようとしています。一部のシステムで生成できるWADLドキュメントがあることは理解していますが、それらは提案であり、まだ完全には受け入れられていないようです。

SpringがWADLや、クライアントがRESTfulサービスのデータ構造をクエリできるようにするために使用できる他の何かを生成できるかどうか誰かが知っていますか？