为两点之间的路径设计Web服务API

时间:2014-03-16 13:14:49

标签: web-services api

我有一个Web服务,它返回给定的两个输入点之间的路径细节(如果存在)。 Web Service API类似于getPath(Point start,Point end)。现在,如果在给定的开始和之间不存在路径。终点,API如何在以下选项中表现

  1. 返回空对象
  2. 抛出PathNotFoundException
  3. 始终在响应中包含状态代码以及路径详细信息。在这种情况下,返回空路径和状态代码作为适当的错误代码,如“PATH_NOT_FOUND”/“ERROR”
  4. 还有其他选择吗?请提出建议。
  5. 请告诉我您的意见

    谢谢, 哈里什

1 个答案:

答案 0 :(得分:1)

建议:1。返回null或空路径。

在http中抛出异常可能不是最好的主意,返回状态代码是一种解决抛出异常的方法。缺少路径不应该在客户端出现错误。

我会为错误的参数,错误的参数数量,一些服务器端问题(例如无法访问的数据库等)保留异常/状态代码。

假设您正在向数据库查询来自纽约的客户列表。如果列表为空或只返回一个空列表,您会抛出异常吗?这听起来就像你的情景。