Документирование веб-сервисов EJB3 - PullRequest
1 голос
/ 11 августа 2010

У меня есть простой веб-сервис, как показано ниже

/**
 * 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 + " !";
  }
}

Существует ли способ (с использованием аннотаций или иным образом) добавления комментариев к веб-службе или веб-методу, чтобы при вызове третьей стороной (илипроверяет WSDL), есть комментарии / документация, которая описывает веб-сервис, его методы и параметры;очень похоже на комментарии, которые позже включаются в документацию Java.

Я думаю, что возможно (последний комментарий) для веб-службы .NET, но не уверен в веб-службах Java.

Ответы [ 2 ]

0 голосов
/ 02 сентября 2010

Учитывая отсутствие стандартного способа создания документа, мы пошли по пути enunciate .

Играет действительно хорошо с Maven.

0 голосов
/ 11 августа 2010

Вы можете добавить <wsdl:documentation> элементов в wsdl: Структура документа WSDL

...