java - SOAP インターフェイスに関するドキュメントを公開するためにどのような方法がありますか?

Question

SOAP サービスのドキュメント (Javadoc など) を公開しようとしています。最良のケースとして、WSDL から直接公開するか、自律的に生成されたレポートを介して公開します。SOAP 実装として CXF を使用しています。

hereにある WSDL Viewer を使用してみましたが、メソッドに注釈を付けて、彼の例に見られる構造と詳細レベルを取得する方法に関する適切なチュートリアルが見つかりませんでした。

Answer 1

これまでに見つけた最善の解決策は、Enunciate ( http://enunciate.codehaus.org/ ) として知られるエンジンを使用することです。プロジェクトに追加されると、JavaDocs を読み取り、一連の HTML ファイルを作成します。私はすべての機能や問題を完全には理解していません (独自の WSDL を生成してリンクしますが、これは理想的ではなく、プロジェクト内の余分なフォルダー内で「スクラッチ作業」を行い、削除されない限りエラーとして読み取られます) 、しかし、JavaDocsを明確で使いやすい方法で正常に読み取り、公開します。