REST端點元數據

Question

所有 我正在尋找一些方法，以顯示有關RESTful Web服務， 如元數據信息操作，參數等。 你知道嗎？

Answer 1

一種流行的解決方案是使用Atom and AtomPub

Answer 2

休息端點支持WADL。

WADL到REST是作爲WSDL到JAX-WS（SOAP）類似。

你可以找到更多關於WADL：http://wadl.java.net/（包括規格鏈接）。 （http://jersey.java.net）是一個Oracles JSR-311參考實現，它還具有一些附加功能，如自動WADL生成，最近（版本1.9）得到改進 - 它包括XSD模式用於傳輸類型（可用於更好的客戶端代碼生成）。

一般來說，如果你想使用一些標準，請使用WADL，不推倒重來..

Answer 3

我聽到HTML是受歡迎的代表終點的元數據。你有鏈接參考，你有載荷的形式，很大的空間來解釋事情的英文文本，這種格式很好地記錄了一個衆所周知的處理模型。

Answer 4

了JAX-的doclet包可以生成從JAX-RS或JAXB標註類似JavaDoc的文檔。

http://www.lunatech-labs.com/open-source/jax-doclets

在我們的項目中，我們目前手動生成文檔，但我們已開始評估這個工具。