Как я могу сгенерировать документацию для моего REST API Джерси, которая использует привязку JSON JAXB?
Теперь, когда ямы выясниликак использовать JAXB генерировать JSON Я могу запросить / ответить с ним на моем сервере, и я 'Я хотел бы выяснить, как я могу генерировать полезную документацию для людей, которые не используют Java. Мой код сервера выглядит так:
@POST
@Path("apath")
@Consumes(MediaType.APPLICATION_JSON)
public String postAPath(InstanceWithXmlRootElementAnnotation instanceWithXmlRootElementAnnotation) {
Тот'Все хорошо, если кто-то использует Java. Я просто дал им банку сInstanceWithXmlRootElementAnnotation
класс в нем и сказать им, чтобы отправить его (да, тамнемного больше работы, игнорируйте эти детали).
Если они'использую какой-то другой язык, я нене знаю как яЯ должен сказать им формат их полезной нагрузки и что ожидать от сервера, если он возвращаетInstanceWithXmlRootElementAnnotation
, Как я могу сгенерировать документацию, которая объясняет ожидаемый формат полезной нагрузки JSON?