Documenter EJB3 Web Services

Question

J'ai un service Web simple comme ci-dessous

/** 
* Test web service 
*/ 
@Stateless 
@WebService 
public class HelloWorldWebService { 

    /** 
    * Greets the user by appending 'Hello' before the name 
    */ 
    @WebMethod 
    public String doWork(String name){ 
     return "Hello " + name + " !"; 
    } 
} 

Est-il possible (en utilisant des annotations ou autres) d'ajouter des commentaires à la méthode de service Web ou Web afin que lorsqu'un tiers appelle (ou inspecte le WSDL), il y a des commentaires/documentation qui décrivent le service web, ses méthodes et paramètres; un peu comme les commentaires qui sont ensuite inclus dans les docs java.

Je pense que c'est possible (dernier commentaire) pour le service Web .NET, mais pas sûr dans les services Web Java.

Answer 1

Compte tenu de la lack de manière standard de générer la doc, nous sommes allés le chemin enunciate.

Lit really bien avec Maven.

Answer 2

Vous pouvez ajouter des éléments à la <wsdl:documentation> wsdl: WSDL Document Structure