CXFとmavenを使用してソースコードのコメントをWSDLにエクスポートしますか?

タイトルのように:Webサービスメソッドのパラメータのjavadocコメントをwsdlにエクスポートできますか?ソースコードからwsdlを生成するには、CXFとmavenのjava2wsゴールを使用しています。

1
JAXWSとparamsについてはわかりませんが、JAXRSでは org.apache.cxf.jaxrs.ext.Description メソッドに注釈を付けることができ、生成されたWADLに表示されます。
追加された 著者 Qwerky,
うーん、 @WSDLDocumentation アノテーションがありますが、それは十分ではありません。 2つ以上のパラメータを持つメソッド、またはパラメータを作成するために使用するコンストラクタがある場合、メソッド全体に対する1つの記述では不十分です。私はjavadocを利用できるようにしたいので、Webサービスを使用する開発者は、サービスが期待するオブジェクトを構築する方法を知っています。
追加された 著者 Pete,

1 答え

You can use the @WSDLDocumentationCollection annotation to attach multiple @WSDLDocumentation annotations to a single method (with different placements) but you can't use this to go much deeper than placing documentation on single operations of a port, because that's where it ceases to be a WSDL problem and becomes an XSD problem. XSD documentation would be handled by an annotation at the JAXB level, except that no such annotation exists; the schema generated won't contain elements. (When starting from a schema, documentation comments can be generated as Javadoc, but the reverse direction doesn't happen as Javadoc comments aren't retained in Java class files.)

2
追加された