首页 > 在RESTFUL风格中怎样定义需要多个参数才能确定的资源路径

在RESTFUL风格中怎样定义需要多个参数才能确定的资源路径

有些资源只需要一个参数就能定位出来比如xxx.com/user/2就定位了id号为2的用户,但是有些资源需要两个或者两个以上的参数才能定位,该如何组织这种资源的URL比较好?
比如要表示x轴为2,y轴为3的点该用下列哪种URL比较好?
1. xxx.com/dot/2/3
2. xxx.com/dot?x=2&y=3
3. xxx.com/dot/2-3(or 2.3)
或者还有别的更好的方案?求指教


个人认为2更好。

restful 的url表示资源的逻辑地址,每个网址代表一种资源(resource)。x轴为2,y轴为3的点可以理解成对点的过滤,x=2和y=2都是过滤条件。

以上是个人观点,欢迎指正~

对于restful的理解及api设计可以参考 阮一峰 大神的blog:

http://www.ruanyifeng.com/blog/2011/09/restful.html
http://www.ruanyifeng.com/blog/2014/05/restful_api.html


@Controller
@RequestMapping("/second")
public class SController {

//如果有多个请求参数时,只需要中间用"/"分开就好,但是此时web.xml中需要配置/

@RequestMapping("/answer/{id}/{key}")

public String answer(@PathVariable("id")String id,@PathVariable("key")String key,HttpServletRequest request,HttpServletResponse response,Model model) throws Exception{
request.setCharacterEncoding("utf-8");
response.setContentType("text/html;charset=utf-8");

if(key == null || !key.trim().matches("[a-z0-9]{32}")){
return "errorkey";
}
if(id==null||"".equals(id)){
return "errorURI";
}

return "OK";

}

}

最终请求地址是://http://localhost:8080/funny/second/answer/109885/f23c92defda04fa97807d7a60c0a56e5

返回结果:
{
"error_code": 0,
"reason": "Success",
"result": {
"data": [
{
"id": 109885,
"body": "却上心头。",
"valid": 0,
"title": "已有推辞之意(打一琼瑶作品)",
"cname": "谜语"
}
]
}
}


可以参照Rails中的标准的定义方式。
如果定义这个资源的两个参数具有从属关系,那么生成的路由就是

owner/1/property/1

其中property从属于owner。

比如用户1的编号为2的文章,就是users/1/articles/2

如果两个资源是平等的,那么一般是作为路由中HTTP方法的参数,

比如你提到的“要表示x轴为2,y轴为3的点”,就一般是用xxx.com/dot?x=2&y=3

【热门文章】
【热门文章】