Я успешно создал документацию для моих конечных точек, используя 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
(или значение, указанное в качестве примера).Можно ли привести несколько примеров?
Спасибо.