Welcome to Hexo! This is your very first post. Check documentation for more info. If you get any problems when using Hexo, you can find the answer in troubleshooting or you can ask me on GitHub.
Quick Start
Create a new post
1 | $ hexo new "My New Post" |
More info: Writing
Run server
1 | $ hexo server |
More info: Server
Generate static files
1 | $ hexo generate |
More info: Generating
Deploy to remote sites
1 | $ hexo deploy |
按时大苏打实打实大苏打啊实打实打算
More info: Deployment
RESTful API概述
RESTful API是什么
RESTful是Representational State Transfer的缩写,代表着表征状态转移。REST拥有一组架构约束条件和原则,只要符合这一套约束原则的架构,就是RESTful架构。
需要注意的是,REST并没有提供新的组件、技术,也并不是专门为HTTP提供规范,而是通过约束和原则去合理使用Web的现有特征和能力(是的,REST受到Web现有特征的影响还是比较深的)。RESTful API 是一种围绕 资源(resource)展开的无状态传输的API设计方案。所有的HTTP Action,都应该是在相应resource上可以被操作和处理的,而API就是对资源的管理操作,而这个具体操作是由 HTTP Action 指定的。
RESTful API在功能上更像是隔离层,要访问服务器资源,就必须找到API入口。如果这个入口的规则遵循REST风格,那就是RESTful设计框架。
RESTful API产生的意义
随着移动互联网的发展,各类Client层出不穷,RESTful可以通过一套统一的接口为Web、ios和Android提供服务。对于广大平台来说,例如微信公共平台,它们不需要有显示的前段,只需要一套提供服务的接口,RESTful正好是最佳选择。
规定的资源格式
资源的标识URL
资源是一个数据单元,这个单元可大可小,根据业务规模自主定制。要准确识别一个资源,需要有一个唯一标识,在Web中这个唯一标识就是URL(Uniform Resource Identifier)。
URL的设计应该具有自适性、可寻址、直观性的原则。用/来表示层级,用_或-来分割单词,用?来过滤资源。
HTTP协议语义支持
- GET:从服务器取出资源或资源列表
- POST:在服务器新建一个资源
- PUT:客户端提供数据,以整体的方式更新服务器资源
- PATCH:只更新服务器一个资源的一个属性
- DELETE:从服务器删除资源
- HEAD:从服务器获取报头信息(不是资源)
- OPTIONS:获取客户端能对资源做什么操作的信息
除了POST不是幂等的,其他几个都是幂等的。
HTTP的幂等性是指一次和多次请求某一个资源应该具有同样的副作用。幂等性的一个实例:在网速不够快的条件下,客户端发送第一个请求后不能立即得到响应,由于不能确定是否请求是否被成功提交,所以它有可能会再次发送另一个相同的请求,幂等性决定了第二个请求是否有效。幂等情况下,第一次请求成功实现了事务操作,第二次请求就一定不能再次操作事务。
媒体类型
客户端与服务端进行交互式,需要规定双方能够接受的媒体表现形式。常见的媒体格式类型有:
- application/json:JSON数据格式
- application/xhtml+xml:XHTML数据格式
- application/xml:XML数据格式
- application/atom+xml:ATOM XML聚合格式
在设计RESTful API的时候,要规定端端之间具有统一的数据传输格式,目前JSON数据格式使用范围比较广。
好的API是什么样的
举例来说,有一个API提供动物园(zoo)的信息,还包括各种动物和雇员的信息,则他的路径应该设计成以下的样子。
1 | + https://api.example.com/v1/zoos |
博客魔改记录
- 归档侧边栏显示查看更多,要修改
blog/node_modules/hexo/lib/plugins/helper/list_archives.js
内容 - 新增友情链接侧边栏
- page页显示字数、阅读量、等等
- 添加page页类型
others
- 导航渐变色
- 首页不显示全图
- 二级导航栏
- 文章h1\h2\h3。。。显示优化
- 自由调整top_img的布局
1 |
|