2017-01-16 105 views
-4

我习惯于使用基于SOAP的Web服务使用JAX-WS来设计API,但我需要切换到REST服务。在Java中设计REST API的最佳方法

我想的办法应该是什么:

  • 开始写作Java方法签名的
  • 开始写某种WSDL描述的呼叫,即使不会使用
  • 开始编写一些其他类型(哪一个?)的基于文本的描述为API
  • 使用一些工具(哪一个?)
  • 其他?

我不是在问全部细节,而是在开始编写代码之前设计REST API之前,REST新手应该考虑什么。 (如太多)

谢谢

回答

1

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

+0

谢谢。我想这是考虑API的完全不同的方式。如果不是关于访问资源,而是执行操作,那该怎么办? (并不一定在资源上) – aldo

+0

REST是针对资源运行的应用程序的体系结构风格。如果您的操作不在资源上(通过网址识别的东西),则REST不适合使用。您可以使用HTTP方法作为动词来执行操作,也可以通过创建另一个作为操作结果并导航到该资源的资源来执行操作。由于这样的导航不是无副作用的,所以您应该使用POST而不是GET来进行导航。 –