Я надеюсь, что расширение некоторого вида доступно, который делает это (хотя я предполагаю, что моя надежда по-дурацки оптимистична).
/**
* <p>
* Gets the {@link ResultObject} given the identifier. The following
* fields are not available for some users and will contain a null value:
* </p>
*
* <ul>
* <li>{@code resultObject.comment}</li>
* <li>{@code resultObject.anotherObject.actionById}</li>
* <li>{@code resultObject.anotherObject.actionByName}</li>
* </ul>
*
* <p>
* The {@code daysInPurgatory} value will be {@code -1} when not
* applicable
* </p>
*
* @param requestUser
* the user initiating the request
* @param identifier
* the id of the ResultObject
* @return the {@link ResultObject} or {@code null} if none exists
* @throws SomeException
* if the {@code identifier} is {@code null}
*/
@WebMethod
@WebResult(name = "resultObject")
public ResultObject getResultObjectById(
@WebParam(name = "RequestUser", header = true, partName = "RequestUser") final String requestUser,
@WebParam(name = "identifier") final Long identifier)
throws SomeException;
Спасибо, LES2
Вы можете посмотреть на Enunciate. Можно использовать его плагин для Maven для генерации статических HTML файлов из комментариев Javadoc. Это работает для конечных точек SOAP (т.е. JAX-WS) и REST (т.е. JAX-RS).
Интересное чтение:
Производственные примеры:
Вы не единственный, кто ищет способ генерировать документацию WSDL (см. тему Generating WSDL documentation from Javadoc), но, AFAIK, не существует стандартного JAX-WS способа сделать это.
Теперь, возможно, взгляните на аннотацию @Documentation
, упомянутую в JBWS-1850, которая генерирует jaxws:binding
артефакты, описанные в разделе 2.9 Javadoc Customization при использовании подхода Java->WSDL. Это не совсем то, о чем вы просили, но это может дать вам некоторые идеи.
В любом случае, я полагаю, что это потребует предоставления собственного WSDLGeneratorExtension
для расширения wsgen
и генерации желаемого WSDL.