18

私はこれを行う何らかの拡張機能が利用可能であることを望んでいます（私の希望は愚かな楽観的だと思いますが）。

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

4

3 に答える 3

10

あなたはEnunciateを見るかもしれません。Mavenプラグインを使用して、Javadocコメントから静的HTMLファイルを生成することができます。これは、SOAP（つまり、JAX-WS）およびREST（つまり、JAX-RS）エンドポイントで機能します。

興味深い読み物：

生産例：

于 2010-02-22T09:25:38.660 に答える
8

WSDL ドキュメントを生成する方法を探しているのはあなただけではありませんが ( Javadocスレッドから WSDL ドキュメントを生成するを参照)、これを行うための標準的なJAX-WS の方法はありません。

ここで、 JBWS-1850@Documentationで言及されている JBoss 独自のアノテーションを見てください。このアノテーションは、 Java->WSDL アプローチを使用する場合にセクション2.9 Javadoc のカスタマイズで説明されているアーティファクトを生成します。それはまさにあなたが求めていたものではありませんが、いくつかのアイデアが得られるかもしれません。jaxws:binding

いずれにせよ、目的の WSDLWSDLGeneratorExtensionを拡張して生成するには、独自のものを用意する必要があると思います。wsgen

于 2010-02-20T07:51:54.153 に答える
0

あるプロジェクトでは、多数の WSDL を公開しました。すべての Web サービスに対して、WS メソッド「getDocumentationURL()」を公開しました。このメソッドは、SEI から生成された JavaDoc へのリンクを返します。JavaDoc は、アクセス可能なイントラネット サーバーに配置されました。

于 2012-11-20T15:40:33.200 に答える