java - 如何为使用 JSON JAXB 绑定(bind)的 Jersey REST API 生成文档？

Question

现在我已经弄清楚了how to use JAXB generate JSON我可以在我的服务器上请求/响应它，我想弄清楚如何为不使用 Java 的人生成有用的文档。我的服务器代码如下所示:

@POST
@Path("apath")
@Consumes(MediaType.APPLICATION_JSON)
public String postAPath(InstanceWithXmlRootElementAnnotation instanceWithXmlRootElementAnnotation) {

如果有人使用 Java，那就太好了。我只是给他们包含 InstanceWithXmlRootElementAnnotation 类的 Jar，并告诉他们将其发送过来(是的，还有一些工作，请忽略这些细节)。

如果他们使用其他语言，我不知道应该如何告诉他们有效负载的格式，以及如果服务器返回InstanceWithXmlRootElementAnnotation，服务器会期望什么。如何生成解释 JSON 有效负载的预期格式的文档？

Answer 1

是的，这正是Swagger是为了.看看github有关如何与 JAX-RS 集成的详细信息