java中的REST端点元数据

全部 我正在寻找一些方法来显示RESTful Web服务的元数据信息， e、 g.操作、参数等。

---

你知道吗

一种流行的解决方案是使用一些rest端点支持WADL

WADL到REST类似于WSDL到JAX-WS（SOAP）

有关wadl的更多信息，请访问：（包括规范链接）

泽西(http://jersey.java.net)是一个Oracles JSR-311参考实现，它还具有一些附加功能，如最近（版本1.9）改进的自动WADL生成—它包括用于传输类型的XSD模式（可用于更好的客户端代码生成）

---

一般来说，如果您想使用一些标准，请使用WADL，不要重新发明轮子。

我听说HTML在表示端点元数据方面很流行。有链接引用，有有效负载的表单，有大量的空间供英文文本解释，该格式有一个众所周知的处理模型进行了很好的文档记录。

jax doclets包可以从jax-RS或JAXB注释生成类似javadoc的文档

---

在我们的项目中，我们目前手动生成文档，但我们正在开始评估此工具。

您知道任何生成此文档的工具吗，或者您实际上打算手动编写此文档？您可以手动编写，或者如果您确实有一些元数据，则可以将其转换为HTML。你的元数据现在是什么格式？