問題タブ [wadl]

Martin さん、wadl ドキュメント生成コードを使用して Javadoc アノテーションから REST インターフェイスをドキュメント化しようとしましたが、メソッド / クエリ パラメータへのパラメータをドキュメント化することができませんでした。何が間違っているのかよくわかりません。通常の方法でメソッドに Javadoc コメントを指定します。次に例を示します。

私が見逃している明らかな何かがあると確信しています。上記のように、「ID で Account オブジェクトを取得する」というコメントは、resourcedoc.xml ファイルに入り、そこから application.wadl ファイルに入りますが、パラメーター定義はどれも機能しません。追加すると

resourcedoc.xml ファイルでパラメータの説明を確認できますが、間違った場所に表示されているようで、application.wadl ファイルには何も表示されません。あなたが与えることができるどんな助けも大歓迎です。

特定のWADLファイルを検証する方法はありますか？

XMLスキーマに対して検証しても、すべてのエラーがキャッチされるわけではありません。これは、間違ったスタイルや未定義のタイプのメソッドパラメーターなどのエラーをキャッチしないためです。

apache cxfのコマンドラインツールWADL2javaも試しましたが、これはwadl仕様のすべての違反をキャッチするわけではありません。すべてのエラーをキャッチできたとしても、検証のためだけにコードを生成する必要はないようです。

私が取り組んでいる Web サービスには、Jersey が作成する WADL が生成されています。私がしたいのは、xsd0.xsd の名前を Result.xsd などに変更することです。毎回WADLを再生成するとResult.xsdになります。これはJerseyで可能ですか？

REST のパフォーマンスとスケーラビリティ Web サービスのテストにガトリングを使用したいと考えています。このプロジェクトを開始したときにガトリングを認識していなかったため、現在これに JMeter を使用しています。Gatling はよりよく統合され、多くの理由でプロジェクトに適しています。

主な質問を 1 つ聞きたいと思います。

明らかに、正しい Web サービス情報を使用して Gatling を構成するには、多くのオーバーヘッドがあります。私はすでにJMeterでこれを行っていますが、もう一度やりたいとは思っていません。サブプロジェクトの 1 つには WADL がありますが、もう 1 つのプロジェクトにはそのようなものはありません。箱から出してインポートすることは可能ですか:

を。JMeter テスト計画と
b. WADL ドキュメント

ガトリングに？

ドキュメントを調べましたが、残念ながらこれらを参照しているものは見つかりません。

WADLシームは、RESTサービスに注釈を付けるためのより良い（軽量の）方法です。

私の質問：WADL仕様を作成および管理するためのビジュアルツール（オンライン、Eclipseプラグインなど）を知っていますか？

ありがとう。

自動WADL生成の優れた機能を利用して、RESTfulAPIの実装にJerseyを使用しています。

例として、メソッドがあります

これにより、WADLに次のフラグメントが生成されます。

属性は、、である可能name性typeがsizeあり、実行時に値を検証するだけでなく、生成されたwadlに表示する必要があります。このドキュメント<option>によると、このような機能は、内部にいくつかのタグを生成することでサポートされる必要があります<param>。つまり、次のようなものを期待しています。

私の問題は、Jerseyでそれを有効にすることです。関連するドキュメントが見つからず、パラメータのタイプをからに変更すると、この機能が自動的に機能すると想定した場合はString、enumメソッドのシグネチャを次のように変更しました。

どこ

ただし、Jerseyは<param>オプションなしでタグを生成し、パラメーターのタイプはまだxs:stringです。

私はそれをJerseyのコードで見つけようとしcom.sun.research.ws.wadl.Option、関連するJAXBアノテーションを持つクラスを見つけたので、関連しているように見えますが、それを機能させる方法がわかりません。問題はにあると思いWadlGeneratorConfigます。

これが私たちのジャージー定義の関連部分ですweb.xml

OurWADLGeneratorコードは次のとおりです。

ここで何が欠けていますか？前もって感謝します。

少なくとも、Java APIにJavadocを使用するのと同じように、WebサービスのAPIを文書化する標準的な方法があるべきではありませんか？WSDLを使用すると、XMLSpyなどのツールでサービスリクエストテンプレートを作成できます。このテンプレートを使用して、QAおよびWebサービスクライアントは、サービスを簡単に利用し、その動作とプロパティについて詳しく知ることができます。ほとんどがWADLを使用しないRESTfulWebサービスの場合、それはギャップではありませんか？

以下は、顧客のすべてのサブスクリプションを一覧表示するための適切な残りの設計手法ですか。

[BaseUrl]/subscriptions/[accountid]/payTV
[BaseUrl]/subscriptions/[accountid]/paywall
など...

またはそれはむしろあるべきです：

[BaseUrl]/subscriptions/payTV?[accountID]
[BaseUrl]/subscriptions/paywall?[accountID]
など...

または、他の何か？

WADL は WSDL のような本当の標準ですか? WADL URI は「.wadl」拡張子で終わる必要がありますか?

ジャージーで HelloWorld の例を作成し、URL から WADL を取得しました。次に、「wadl-client-plugin」を使用してクライアントを作成しましたが、動作します。

私の質問は次のとおりです。WADL を生成する別のフレームワーク (つまり CXF) を使用する場合、「wadl-client-plugin」でそれを使用してクライアントを作成できますか?