contract-last (jaxb schemagen을 통해) webservice를 문서화하는 방법?

Question

나는 웹 서비스를 개발 했으니 까 내 사용자는 문서를보고 싶어한다. javadoc 주석 또는 명시 적 주석을 사용하여 내 코드를 문서화하는 것을 선호합니다.

@XmlComment("This is used to [blah blah]") 
@XmlElement(name = "referenceDate", namespace = NAMESPACE, type = Date.class) 
public void setReferenceDate(Date referenceDate) { 
    this.referenceDate = referenceDate; 
} 

또는

/** 
* This is used to [blah blah] 
*/ 
@XmlElement(name = "referenceDate", namespace = NAMESPACE, type = Date.class) 
public void setReferenceDate(Date referenceDate) { 
    this.referenceDate = referenceDate; 
} 

위 여기에서 알 수 있듯이, 지원되지 않습니다 -

• JAXB-273 XS 수 있도록 2,006 요청 : 주석에서 문서 요소를
• JAXB-369-2007 주석에서 xs : documentation 요소를 요청하십시오.
• SO-470001 - "그럴 수 없어"stackoverflow 질문

그래서 내 서비스에 댓글을 달 수 없다는 것을 이해합니다. 그러나 ... 확실히 비 수동 방식으로 그렇게하는 방법은 여전히 ​​있습니다. 이 모든 XML을 수작업으로 작성해야합니까? 이 인 경우 JAXB에이 기능을 추가하는 데 관심이없는 이유는 무엇입니까? 엔터프라이즈 급 웹 서비스를 위해 필수적인 것 같습니다.

Answer 1

네가 맞아. 가난 하네. 요즘 가장 중점을 둡니다 계약 우선, 그래서 그것은 우선 순위가없는 것 같아요. XSLT를 사용하여 주석을 별도의 XML 문서에서 WSDL에 추가 할 수 있습니다. Java 코드에서 생성하는 것만 큼 좋지는 않지만 아무것도 아닌 것보다 낫습니다. 여기에 고대 게시판이 있습니다. http://www.gridlab.org/WorkPackages/wp-5/guide/wsdltips.html