在Java中设计REST API的最佳方法

Question

我曾经使用JAX-WS使用基于SOAP的Web服务设计API，但我需要切换到REST服务。

我想知道应该采用什么方法：

• 从编写java方法签名开始
• 开始编写某种描述调用的WSDL，即使它不会被使用
• 开始为API
编写其他类型（哪一个？）基于文本的描述
• 使用一些工具（哪一个？）
• 别的什么？

我不是在询问有关详细信息，而是在开始编写代码之前，REST新手应该在设计REST API之前考虑什么。 （太多了）

感谢

Answer 1

不要将API视为一组方法调用。 REST基于在Web上工作的原则 - 资源和它们之间的链接。首先考虑需要哪些资源和这些资源的表示。