問題タブ [enunciate]

既存の Java REST (Jersey を使用) プロジェクトに「enunciate」を使用しています。私は build.xml と enunciate.xml を持っています: 出力ファイル docs.zip が作成されますが、このファイルを解凍した後、私は持っています: css/ dir, js/ dir, robots.txt, model.html, index.html, favicon.ico, crossdomain.xml、application.wadl、apple-touch-icon.png ファイル。

index.html と model.html には、私の Java REST コードからのドキュメントがありません。ここで誰か助けてくれませんか？私は「発音」の経験がありません。

ありがとう、

---> これは REST コードの例の 1 つです。

@Path("/{spacecraftId}/log")

パブリック クラス UserLogHandler は、ProcessCommunicationFacilityFailureListenerInterface、MessageCustomerInterface、IMessageAvailable を実装します {

}

---> 「build.xml」ファイル:

---> 「enunciate.xml」ファイル:

enunciateを使用して、REST API のSwaggerドキュメントを生成しています。私のレガシー Bean の 1 つにマップが含まれており、Swagger はこれについて不平を言っています。

Swagger がこれを処理できるように、Bean クラスにドロップできる注釈はありますか?

それを除いて、フィールドまたはクラス全体を単に無視するように Swagger に指示する方法はありますか? @XmlRootElementSwagger がアノテーションのないクラスを無視することは知っていますが、残念ながらBazBeanXML を受け入れる別のエンドポイントで使用されています。

PathParam と FormDataParam は REST API 内で使用されますが、enunciate のドキュメントは PathParam の「パス」と FormDataParam の「formdata」を示していますか?

インクルード pattern="com.sun.jersey.multipart.FormDataParam" インクルード pattern="javax.ws.rs.PathParam" があります

enunciate.xml ファイルで。

なにか提案を ？

--->>> REST API:

--->>> ブラウザのドキュメント:

パラメータ 名前 説明 タイプ デフォルト spacecraftId (ドキュメントは提供されていません) path uploadedInputStream (ドキュメントは提供されていません) formdata disposition (ドキュメントは提供されていません) formdata fileType (ドキュメントは提供されていません) formdata inputGroup (ドキュメントは提供されていません) formdata creationTime (ドキュメントは提供されていません) formdata チェックサム (なしドキュメントが提供されます) フォームデータ

ところで、「説明」フィールドに情報を表示するにはどうすればよいですか?

ありがとう、

次のクラス階層があります。サブクラスの Javadoc を生成すると、生成されたドキュメントに、スーパー クラスから継承されたメソッドの Java ドキュメント コメントが含まれていません。

サブクラスのドキュメントを生成しています。SuperClass からのメソッドのドキュメントが空です。

Resteasy で構築された Java REST API のドキュメントを作成するために Enunciate を評価しています。リソース クラス名をカスタム文字列で変更するにはどうすればよいですか?

アノテーション @ResourceLabel は、メソッドにのみ適用できます。何か案が？

ありがとう、ファブリツィオ