Какой-либо способ генерировать документацию WSDL от Javadoc с JAX-WS?

Я надеюсь, что расширение некоторого вида доступно, который делает это (хотя я предполагаю, что моя надежда по-дурацки оптимистична).

   /**
     * <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

18
задан Pascal Thivent 20 February 2010 в 07:52
поделиться

2 ответа

Вы можете посмотреть на Enunciate. Можно использовать его плагин для Maven для генерации статических HTML файлов из комментариев Javadoc. Это работает для конечных точек SOAP (т.е. JAX-WS) и REST (т.е. JAX-RS).

Интересное чтение:

Производственные примеры:

10
ответ дан 30 November 2019 в 09:11
поделиться

Вы не единственный, кто ищет способ генерировать документацию WSDL (см. тему Generating WSDL documentation from Javadoc), но, AFAIK, не существует стандартного JAX-WS способа сделать это.

Теперь, возможно, взгляните на аннотацию @Documentation, упомянутую в JBWS-1850, которая генерирует jaxws:binding артефакты, описанные в разделе 2.9 Javadoc Customization при использовании подхода Java->WSDL. Это не совсем то, о чем вы просили, но это может дать вам некоторые идеи.

В любом случае, я полагаю, что это потребует предоставления собственного WSDLGeneratorExtension для расширения wsgen и генерации желаемого WSDL.

7
ответ дан 30 November 2019 в 09:11
поделиться
Другие вопросы по тегам:

Похожие вопросы: