Enunciate가 xs : elements의 설명을 생성하지 않습니다.

Question

우리는 maven-enunciate-plugin 버전 1.26.2를 사용 중이며 문서 생성 중에 문제가 발생합니다. 우리는 다음과 같은 방식으로 우리의 XSD를에 주석을 추가 한 :

<xs:complexType name="PagingParameters"> 
    <xs:annotation> 
     <xs:documentation>information about PagingParameters</xs:documentation> 
    </xs:annotation> 
    <xs:sequence> 
     <xs:choice minOccurs="0"> 
      <xs:element name="StartPos" type="xs:long" nillable="false">      
       <xs:annotation> 
        <xs:documentation>information about StartPos</xs:documentation> 
       </xs:annotation> 
      </xs:element> 
      <xs:element name="FollowOnBrowseToken" type="xs:string" nillable="false"> 
       <xs:annotation> 
        <xs:documentation>information about token</xs:documentation> 
       </xs:annotation> 
      </xs:element> 
     </xs:choice> 
     <xs:element name="NoOfRecords" type="xs:long" nillable="false"> 
      <xs:annotation> 
       <xs:documentation>information about noOfRecords</xs:documentation> 
      </xs:annotation> 
     </xs:element> 
    </xs:sequence> 
</xs:complexType> 

첫 번째 세트는 그러나 담아서 페이지에서 제대로 거기에 완전히 손실 된 개별 요소에 대한 설명을 모두 분석 출력됩니다. 이상하게도 이는 일련의 요소에서만 발생하지만 열거 형은 정상적으로 작동합니다.

나는 CDATA 블록의 사용을 포함하여 문서를 포맷하는 몇 가지 다른 방법을 시도했지만 아무 것도 작동하지 않는 것 같습니다.

무엇이 누락 되었습니까? 필요한 경우 XSD를 더 포함 할 수 있습니다.

Answer 1

Enunciate는 JavaDoc을 사용하여 문서를 구문 분석합니다. JavaDoc이 생성 된 Java 클래스에 표시되는지 확인할 수 있습니까?

Answer 2

자바 독 은하지 생성 된-클래스에 표시하지만, JAXB는이 같은 자신의 표준 코멘트와 함께이 문제를 덮어 수행

/** 
* Gets the value of the X property. 
* 
* @return 
*  possible object is 
*  {@link String } 
*  
*/ 
public String getX() { 

하지만 여전히 자바 독은 enuciate

에 표시되지 않습니다