как сгенерировать javaDoc из файла jaxb - PullRequest
2 голосов
/ 08 марта 2010

я работаю с Jaxb. и я хотел бы создать файлы javaDoc из этих классов, это так же, как я сделал бы это с обычными файлами java?

Ответы [ 3 ]

2 голосов
/ 08 апреля 2010

Вы можете использовать xs:annotation с xs:documentation, и jaxb поднимает их и делает из них Javadoc в классе.

Примечания:

  • когда тег xs: Documentation был вне тега xs: complexType, это не взял (понятно)
  • Я предполагаю, что то же самое можно сделать на уровень атрибута / элемента в .xsd для полей класса, но не пытался.
  • вывод будет ужасным, если вы попытаетесь поместить HTML-теги в документации. Там в вероятно, обойти это, но я Я тоже не пробовал.

    
      
       
           This becomes javadoc for TypeThatBecomesJavaClass
      
     
    ... etc ... 
2 голосов
/ 09 апреля 2010

Более прямой подход (из учебника JAXB), который решает проблемы выше: http://jaxb.java.net/tutorial/section_5_4-Adding-Documentation.html#Adding%20Documentation

0 голосов
/ 08 марта 2010

Если вы сгенерировали .java файлы из .xsd - да, это обычные классы, которые вы можете изменять, комментировать и документировать.

...