問題タブ [enunciate]

リソース クラスは次のように定義されます。

そして、私は次のように定義されたメソッドを持っています:

enunciate doc ゴールを実行するために maven コマンドを実行すると、生成された wadl は次のようになります。

この「/rest/」は、リソース パスのどこから来ていますか? 私は自分のプロジェクトのあらゆる場所を検索しましたが、それへの参照はありません。

これが私のenunciate.xml設定ファイルです：

Enunciate を使用して、REST プロジェクトのドキュメントを生成しています。私が抱えている問題は、それが生成する json オブジェクトの例にあります。XML 表現は正しいですが、同じオブジェクトの JSON 表現にはルート要素がありません (以下の例では「env」)。

次に、オブジェクト タイプ「env」を定義する Java クラス

Enunciate によって生成された XML ドキュメント (正しい - ルート要素とすべて)

Enunciate によって生成された JSON ドキュメント (これは正しくありません - ルート要素 "env" がありません)

どんな助けでも大歓迎です。

Enunciate with Maven を使用して war ファイルにビルドする jax-ws プロジェクトがあります。アプリサーバーにデプロイすると、SoapUI でテストしようとすると、奇妙な名前空間の問題が発生します。xml 要求には複合型の正しい名前空間プレフィックスが含まれますが、要求がサーバーに送信されると、オブジェクトは常に null になります。

これが私のWebサービスインターフェースです：

これはenunciateで問題なく構築されますが、SoapUIを介してリクエストを作成しようとすると、「犬」オブジェクトがnullとしてサーバーに渡されます。

Maven で enunciate の「アセンブル」ゴールを無効にし、「targetNamespace」を犬の WebParam に追加すると、リクエストは SoapUI で完全に機能します。

ただし、「アセンブル」目標でプロジェクトをビルドしようとすると、デプロイは次のエラーで失敗します。

enunciate で生成された「Submit」リクエスト ラッパー クラスと「Dog」オブジェクトの間に何らかの切断があることがわかりますが、私の人生では解決できません。助けてください！前もって感謝します。

を使用して Maven プロジェクトをビルドするか、Eclipse 構成を生成するmvn eclipse:eclipseと、次のエラーが発生します。

問題を単一の依存関係に分離しました。

この依存関係が必要なので、それを取り除くことはできませんが、なぜこれが原因で enunciate にエラーが表示されるのですか? これを修正する方法はありますか？

編集:いくつかのさらなるテストの後、問題の根本は、以前の依存関係の依存関係の依存関係の依存関係のこの依存関係にある可能性があります:

完全なエラー:

mvn -e enunciate:docsプロジェクトの実行中に次のエラーが発生します。

私のJavaファイルはどこにも言及されていません。問題の原因となっているファイルを特定する方法はありますか?

-X オプションも有効にしてコマンドを実行しましたが、表示された [DEBUG] メッセージは次のタイプのものだけでした。[class name] is a potential schema type definition, but we're not going to add it directly to the model. (It could still be indirectly added, though.)

何がうまくいかないのですか？

問題: 一部のエンドポイントで、リクエストとレスポンスの両方のボディに Java モデルが使用されています。問題は、特定のリクエストで、そのモデルのすべてのフィールドを表示したくないということです。また、応答では、同じモデルとはまったく異なるフィールドを表示したいかもしれません。

質問:これは Enunciate を使用して可能ですか? それとも、リクエストとレスポンスの両方で同じモデル構成を使用する必要がありますか?

これを調べたところ、Enunciate API Facetsが見つかりました。ただし、モデルから一部のフィールドのみを除外する方法がわかりません。この特定の機能以外に、今のところ、Enunciate は非常に便利で使いやすいことがわかりました。また、非常に見栄えの良いドキュメントを生成します。:)

マルチモジュールのMavenプロジェクトでEnunciateを使用しています。私はバージョン 1.28 を使用しており、SOAP サービスに関する文書化の目的でのみ使用しています。

これは、すべてのサービスで問題なく機能します。@WebService アノテーションで targetNamespace と endpointInterface を宣言する必要があり、すべて正常に機能します。wsdl/wadl/xsd/html 出力で zip を取得しました。

すべての javadoc が認識され、出力ファイルを通じて公開されます。

しかし...ない場合はここには書きませんが...

すべてのデータ モデル ファイルではありません。次のオプションを試しました。

モジュールは webarchive に含まれていませんが、依存関係として宣言されています:

データ モデルの DTO と ENUMS には、通常、次のものがあります。

そして、クラスと属性に関するJavadoc。

しかし、ゲッターとセッターでもJavadocを試しました。

プロジェクトの実装例からいくつかの xml 注釈を試してみました。

成功せずに。SOAP サービスの場合とは異なり、javadoc は xsd/wsdl/html ファイルには含まれません。

何か考えはありますか？

Enunciate を使用して、Spring MVC 3.2 を使用して Java で記述された REST API の静的ドキュメントを生成しようとしています。Enunciate Web サイトは、ここで特定のプラグインを使用して Spring をサポートしていると主張しています。

http://enunciate.codehaus.org/module_spring_app.html

構成オプションを見ると、Spring の applicationContext.xml をインポートする必要があるようです。このプロジェクトでは注釈ベースの構成を使用しているため、applicationContext.xml はありません。私の場合、これを機能させる方法はありますか？

助けてくれてありがとう。

enunciate を使用して残りの api ドキュメントを生成しています。プロジェクトに春の依存関係を追加しない限り、最初は正常に機能していました。
私の現在のポン：

api上記の構成は、生成された war の下のディレクトリにドキュメントを生成しています。次のenunciate.xml構成 があります。

ドキュメントは適切に生成されますが、ヒットしようとするとhttp://localhost:8080/amg-web/api/index.html404 応答が返されます。必要なすべてのファイルを含むディレクトリが正常に生成された tomcat webapp で抽出された war を確認しましたapiが、ブラウザで展開されたアプリからアクセスできません。助けてください。