2011-11-25 2 views
1

제목처럼 : 웹 서비스 메서드 매개 변수에 대한 javadoc 주석을 wsdl로 내보낼 수 있습니까? 우리는 소스 코드에서 wsdl을 생성하기 위해 CXF와 maven의 java2ws 목표를 사용하고 있습니다.CXF와 maven을 사용하여 WSDL로 소스 코드 주석을 내 보냅니 까?

+0

JAXWS 및 params에 대해서는 잘 모르지만 JAXRS에서는 * methods *에'org.apache.cxf.jaxrs.ext.Description' 주석을 달 수 있으며 생성 된 WADL에 나타납니다. – Qwerky

+0

흠,'@ WSDLDocumentation' 주석이 있지만 충분하지 않습니다. 두 개 이상의 매개 변수가있는 메서드 또는 매개 변수를 만드는 데 사용해야하는 생성자가 있으면 전체 메서드에 대한 설명 하나만으로 충분하지 않습니다. 웹 서비스를 사용하는 개발자가 서비스가 기대하는 객체를 작성하는 방법을 알고 있으므로 javadocs를 사용할 수있게하고 싶습니다. – Pete

답변

2

주석 @WSDLDocumentationCollection 주석을 사용하면 단일 방법 (다른 게재 위치)에 여러 개의 @WSDLDocumentation 주석을 첨부 할 수 있지만, 포트의 단일 작업에 문서를 배치하는 것보다 훨씬 더 깊게 진행할 수는 없습니다 WSDL 문제가되고 XSD 문제가됩니다. XSD 문서는 그러한 주석이 존재하지 않는다는 점을 제외하고는 JAXB 수준의 주석에 의해 처리됩니다. 생성 된 스키마에는 <xs:documentation> 요소가 포함되지 않습니다. (스키마에서 시작하면 설명서 주석은 Javadoc로 생성 될 수 있지만 자바 클래스 파일에는 Javadoc 주석이 유지되지 않으므로 반대 방향이 발생하지 않습니다.)

관련 문제