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或者不严格使用都是完全没有问题的

猜你喜欢

转载自www.cnblogs.com/jimsfriend/p/10579468.html
今日推荐