Aspnet Mvc 前后端分离项目手记(三)关于restful 风格Url设计
RESTful 不是新东西,简单理解它的核心思想就是最大程度的利用http协议的一些特点,比如uri,比如请求动词,在前后端分离的项目中会有大大的好处
,好的设计的url简单明了,胜过详细的说明文档。关于介绍Restful的好文章也有很多 http://www.ruanyifeng.com/blog/2014/05/restful_api.html
看几个不错的restful风格的url设计,你就明白什么时restful风格了
1,豆瓣电影
https://movie.douban.com/subject/27179414/?from=showing
编号27179414的项目
编号27179414 电影的演员表 https://movie.douban.com/subject/27179414/celebrities
是不是很明了,一看url就知道他的内容
下面是在asp.net mvc中实践restful 的一点总结 ,项目没有使用webapi
首先,IIS默认是禁止Delete,Put等请求的,如果没有事先配置的话会报404
解决办法一:在web.config中标注module节点 <modules runAllManagedModulesForAllRequests=”true” runManagedModulesForWebDavRequests=”true”>
方法二:如果上述方法还是不奏效的话
可以直接在控制面板》》程序或功能》》启用或关闭Windows功能中关闭除WebDev模块
在这里,取消【WebDAV发布】的勾选就行,
启用是路由特性, 使用restful时有时候会自定义一些路由映射, 在RouteConfig中加入 routes.MapMvcAttributeRoutes();
关于路由特性也有一些很详细的文章 https://www.cnblogs.com/zeusro/p/RouteConfig.html
在URL中添加版本号
1 url中要有版本号 比如 https://api.demo.com/v1/controller/action , 也就是说要设置全局的路由
方法一, 添加区域,
,
方法二, 在IIS添加应用程序
在IIS里面添加网站的时候,不直接添加,二十添加一个空文件夹,然后再在里面添加应用程序
方法三,定义全局路由
定义全局路由, 这篇文章有介绍 https://www.cnblogs.com/savorboard/p/dontnet-IApplicationModelConvention.html
使用http动词来表明来意
分别使用来对应增删改查, url使用小写 ,尽量使用名字而不是动宾短语 比如 获取商品的url /products 要好于 /product/getproduct
post (新增)
put (修改)
delete(删除)
get(查询)
添加一个商品 /product post动词
编辑商品 /product put动词
删除商品 /product delete动词
获取商品列表 /products?page=1&pagesize=50 get动词
获取 ID为1的商品ID为3图片 /product/1/img/3 get动词
设置Id为1的商品价格为2 /product/1/setprice/2 post动词
restful缺点很多,在实际使用过程中其实很难做到完全遵循,这个时候千万不能生搬硬套,他并不是一个硬性的规定,只是一种风格,不用restful或者不严格使用都是完全没有问题的