3.使用Spring MVC开发RESTful API

前言

使用SpringMVC 开发RESTful API主要讲解一下内容

1. 使用Spring MVC编写Restful API

2.使用Spring MVC处理其余web应用常见的需求和场景

3.Restful API开发经常使用辅助框架(swagger,wiremok)

内容

1. 使用Spring MVC编写Restful API

1.1 Restful简介

1.1.1 传统接口和Restful API对比

增删查改传统和Restful API的URL对比

传统	Restful API
查询	/user/query?name=Jack	GET		/user?name=Jack	GET
详情	/user/getInfo?id=1	GET		/user/1	GET
建立	/user/create?name=Jack	POST		/user	POST
修改	/user/update?id=1&name=Jack	POST		/user/1	PUT
删除	/user/delete?id=1	GET		/user/1	DELETE

增删查改传统和Restful API的特色对比

传统	Restful API
用URL描述行为(分别带有操做动词:经过这些动词知道行为)	用URL描述资源(url上看不到行为:上面详情、修改、删除都是对id=1的用户;用户id为1的用户对系统来讲是一个资源)
行为描述用url动词,http结果无论成功失败都是返回json,也许状态码都是200	用HTTP方法描述行为(用GET、POST、PUT、DELETE描述行为),使用HTTP状态码来标识不一样结果
url上使用键值对传递参数较多	使用json交互数据
	Restful API只是一种风格,并非强制标准

1.1.2 Rest成熟度模型

一下模型中,把Restful成熟度分为了4级。0-3,数字越大级别越高 越来知足此模型

• 使用HTTP做为传输方式,不是http传输就不是restful API。
• 引入资源概念,每一个资源都有对应url;restful API是用URL描述资源，请求接口中无动做。
• 使用HTTP方法进行不一样操做、使用HTTP状态码表示不一样结果。
• 超媒体控制：在资源的表达中包含了连接信息。这种规范在大部分工做中很难达到，通常知足到level2。

1.2 查询请求

编写Restful API须要编写如下内容:

1. 编写针对Restful API测试用例(使用web浏览器地址栏是检验不了PUT、post)
2. 使用注解声明Restful API
3. 在Restful API中传递参数

1.2.1 编写针对Restful API测试用例

首先须要引入测试依赖；

<dependency>  
 <groupId>org.springframework.boot</groupId>  
 <artifactId>spring-boot-starter-test</artifactId>  
</dependency>

咱们有时候执行:mvn clean install时候下载不下来对应依赖时候,咱们在本地依赖仓库删除所依赖,而后从新执行:mvn clean install