Enunciate - Как отображать типы мультимедиа в сгенерированных документах REST? - PullRequest
2 голосов
/ 01 февраля 2012

Я успешно создал документацию для моих конечных точек, используя enunciate.Это пример с конечной точки:

@Produces("application/json")
public class Messages {
  .....
  @DocumentationExample("provide an example")
  @Consumes("application/json")
  @GET
  Message createMessage (Message input) {
    .... store the message, validate, etc. 
  }
  ....
}

Message отображается в JAX-WS через Jackson и имеет такую ​​структуру:

@XmlRootType
public class Message {
  ..
}

Хотя это работает для enunciateЯ нигде не вижу ни @Produces, ни @Consumes в документации.Можно ли как-то «пометить» классы домена - не через @XmlRootElement, а через какой-нибудь внешний файл конфигурации?Я не заинтересован в изменении домена только для enunciate (даже если речь идет об аннотациях).

Я также не вижу аннотацию @DocumentationExample (или значение, указанное в качестве примера).Можно ли привести несколько примеров?

Спасибо.

1 Ответ

2 голосов
/ 10 июля 2013

Это было исправлено.Последняя версия Enunciate: 1.27.

...