使用JAX-WS从Javadoc生成WSDL文档的任何方式？ [英] Any way to generate WSDL documentation from Javadoc with JAX-WS?

问题描述

我希望有这样的延伸（尽管我认为我的希望是愚蠢乐观的）。

I'm hoping that an extension of some kind is available that does this (although I suppose that my hope is foolishly optimistic).

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

Thanks, LES2

推荐答案

您可以查看 Enunciate 。可以使用它是Maven插件从Javadoc注释生成静态HTML文件。这适用于SOAP（即JAX-WS）和REST（即JAX-RS）端点。

You may look at Enunciate. It's possible to use it's Maven plugin to generate static HTML files from Javadoc comments. This works for SOAP (i.e. JAX-WS) and REST (i.e. JAX-RS) endpoints.

有趣的是：

• https://github.com/stoicflame/ enunciate / wiki /仅文档


• http： //raibledesigns.com/rd/entry/my_experience_with_java_rest

• https://github.com/stoicflame/enunciate/wiki/Documentation-Only
• http://raibledesigns.com/rd/entry/my_experience_with_java_rest

制作示例：

• http://www.realtybaron.com/api/


• http://www.agentrank.com/ api /


• http：// api .setlist.fm / docs / index.html

• http://www.realtybaron.com/api/
• http://www.agentrank.com/api/
• http://api.setlist.fm/docs/index.html

这篇关于使用JAX-WS从Javadoc生成WSDL文档的任何方式？的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！