Spring Boot整合Swagger二、Mybatis构建RESTful API
- 首先推荐一个好玩的网站 ASCll ,能够把你想要的字母生成文本的图形，而后
copy到banner.txt,便可替换Spring Boot的开启图标
88 88
88 88
88 88
88 88 ,adPPYba, 8b d8 ,adPPYba, 88 88
88 88 a8" "8a `8b d8' a8P_____88 88 88 88 88 8b d8 `8b d8' 8PP""""""" 88 88 88 88 "8a, ,a8" `8b,d8' "8b, ,aa "8a, ,a88 88 88 `"YbbdP"' "8" `"Ybbd8"' `"YbbdP'Y8 88 88 88 88 "" "" 88 ,adPPYba, 88,dPPYba, 88 88,dPYba,,adPYba, 88 8b,dPPYba, ,adPPYb,d8 I8[ "" 88P' "8a 88 88P' "88" "8a 88 88P' `"8a a8" `Y88 `"Y8ba, 88 88 88 88 88 88 88 88 88 8b 88 aa ]8I 88 88 88 88 88 88 88 88 88 "8a, ,d88 `"YbbdP"' 88 88 88 88 88 88 88 88 88 `"YbbdP"Y8
aa, ,88
"Y8bbdP"
复制代码
Swagger2
Swagger是一款能够快速生成符合RESTful风格API并进行在线调试的插件。REST实际上为Representational State Transfer的缩写，翻译为“表现层状态转化” 。若是一个架构符合REST原则，就称它为RESTful架构。 实际上，“表现层状态转化”省略了主语，完整的说应该是“资源表现层状态转化”。什么是资源Resource？资源指的是网络中信息的表现形式，好比一段文本，一首歌，一个视频文件等等；什么是表现层Reresentational？表现层即资源的展示在你面前的形式，好比文本能够是JSON格式的，也能够是XML形式的，甚至为二进制形式的。图片能够是gif，也能够是PNG；什么是状态转换State Transfer？用户可以使用URL经过HTTP协议来获取各类资源，HTTP协议包含了一些操做资源的方法，好比：GET 用来获取资源， POST 用来新建资源 , PUT用来更新资源，DELETE 用来删除资源，PATCH 用来更新资源的部分属性。经过这些HTTP协议的方法来操做资源的过程即为状态转换。html
- 传统
URL请求和RESTful风格请求的区别
描述 传统请求 方法 RESTful请求 方法
查询 /user/query?name=mrbird GET /user?name=mrbird GET
详情 /user/getInfo?id=1 GET /user/1 GET
建立 /user/create?name=mrbird POST /user POST
修改 /user/update?name=mrbird&id=1 POST /user/1 PUT
删除 /user/delete?id=1 GET /user/1 DELETE
复制代码
大体能够总结下传统请求和RESTful请求的几个区别：
- 传统请求经过URL来描述行为，如
create，delete等；RESTful请求经过URL来描述资源。 RESTful请求经过HTTP请求的方法来描述行为，好比DELETE，POST，PUT等，而且使用HTTP状态码来表示不一样的结果。RESTful请求经过JSON来交换数据。
1、引入Swagger、MySQL 依赖
<!-- MySQL 链接驱动依赖 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>${mysql-connector}</version>
</dependency>
<!-- Spring Boot Mybatis 依赖 -->
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>${mybatis-spring-boot}</version>
</dependency>
<!--使用的Swagger版本为2.6.1：-->
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.6.1</version>
</dependency>
<!--ui的界面-->
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger-ui</artifactId>
<version>2.6.1</version>
</dependency>
复制代码
2、配置 SwaggerConfig
/**
* author： Created by shiming on 2018/9/26 18:10
* mailbox：lamshiming@sina.com
*/
@Configuration
@EnableSwagger2
public class SwaggerConfig {
// 在配置类中添加@EnableSwagger2注解来启用Swagger2，apis()定义了扫描的包路径
@Bean
public Docket buildDocket() {
return new Docket(DocumentationType.SWAGGER_2)
.apiInfo(buildApiInf())
.select()
.apis(RequestHandlerSelectors.basePackage("com.example.swagger.web"))
.paths(PathSelectors.any())
.build();
}
private ApiInfo buildApiInf() {
return new ApiInfoBuilder()
.title("RESTful API 文档")
.contact(new Contact("shiming", "https://www.shiming.site/", null))
.version("1.0")
.build();
}
}
复制代码
3、配置数据库，建立表
## 数据源配置
spring.datasource.url= jdbc:mysql://localhost:3306/shiming?useUnicode=true&characterEncoding=utf-8&useSSL=true
spring.datasource.username=root
spring.datasource.password=App123
spring.datasource.driver-class-name=com.mysql.jdbc.Driver
复制代码
-
-
建立数据库java
DROP TABLE IF EXISTS `user`;
CREATE TABLE `user` (
`id` int(10) unsigned NOT NULL AUTO_INCREMENT COMMENT 'id',
`user_name` varchar(25) DEFAULT NULL COMMENT '用户姓名',
`user_age` varchar(25) DEFAULT NULL COMMENT '用户年级',
`description` varchar(25) DEFAULT NULL COMMENT '用户描述',
PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8;
复制代码
INSERT user VALUES (0,'仕明','25','仕明是个好同窗');
复制代码
-
-
-
最终的建立的表 mysql
-
访问本地地址 ：http://localhost:8080/swagger-ui.html#/git
4、测试
-
使用
swagger新增用户 github
-
使用
swagger获取用户列表，也能够访问：http://localhost:8080/user/listweb
{
"code": "0",
"message": "success",
"result": [
{
"id": 1,
"name": "仕明",
"age": "25",
"description": "仕明是个好同窗"
},
{
"id": 2,
"name": "仕明",
"age": "25",
"description": "仕明是个好同窗"
},
{
"id": 3,
"name": "仕明",
"age": "25",
"description": "仕明是个好同窗"
},
{
"id": 4,
"name": "仕明",
"age": "25",
"description": "仕明是个好同窗"
},
{
"id": 5,
"name": "仕明",
"age": "25",
"description": "仕明是个好同窗"
},
{
"id": 6,
"name": "仕明",
"age": "25",
"description": "仕明是个好同窗"
},
{
"id": 7,
"name": "仕明",
"age": "25",
"description": "仕明是个好同窗"
}
]
}
复制代码
-
使用
swagger删除id=1的用户！ spring
-
使用
swagger获取id=2的用户！ sql
{
"code": "0",
"message": "success",
"result": {
"id": 2,
"name": "仕明",
"age": "25",
"description": "仕明是个好同窗"
}
}
复制代码
- 使用
swagger更新用户！
{
"id": 7,
"name": "仕明",
"age": "25",
"description": "我更新了-仕明是个好同窗"
}
复制代码
-
更新后的数据库 数据库
-
UserController的代码以下api
/**
* author： Created by shiming on 2018/9/26 16:42
* mailbox：lamshiming@sina.com
*/
@Api(value = "用户Controller")
@Controller
@RequestMapping(value = "/user")
public class UserController {
@Autowired
UserService cityService;
//{"id":1,"name":"仕明","age":"25","description":"仕明是个好同窗"}
// http://localhost:8080/user/1
@ApiOperation(value = "获取用户信息", notes = "根据用户id获取用户信息")
@ApiImplicitParam(name = "id", value = "用户id", required = true, dataType = "Long", paramType = "path")
@GetMapping("/{id}")
@ResponseBody
public ResultBody getUserById(@PathVariable(value = "id") Long id) throws GlobalErrorInfoException {
System.out.println("id="+id);
User userById = cityService.getUserById(id);
if(userById!=null){
ResultBody resultBody = new ResultBody(userById);
return resultBody;
}
// User user = new User();
// user.setDescription("没有找到这我的");
throw new GlobalErrorInfoException(GlobalErrorInfoEnum.NOT_FOUND);
// return user;
}
// http://localhost:8080/user/list
@ApiOperation(value = "获取用户列表", notes = "获取用户列表")
@GetMapping("/list")
@ResponseBody
public ResultBody getUserList() throws GlobalErrorInfoException {
List<User> userList = cityService.getUserList();
if (userList==null||userList.size()==0){
throw new GlobalErrorInfoException(GlobalErrorInfoEnum.NOT_FOUND);
}
ResultBody resultBody = new ResultBody(userList);
return resultBody;
}
@ApiOperation(value = "新增用户", notes = "根据用户实体建立用户")
@ApiImplicitParam(name = "user", value = "用户实体", required = true, dataType = "User")
@PostMapping("/add")
@ResponseBody
public ResultBody addUser(@RequestBody User user) {
Long aLong = cityService.addUser(user);
System.out.println("Long=="+aLong);
Map<String, Object> map = new HashMap<>();
map.put("result", "新增用户成功");
ResultBody resultBody = new ResultBody(map);
return resultBody;
}
@ApiOperation(value = "删除用户", notes = "根据用户id删除用户")
@ApiImplicitParam(name = "id", value = "用户id", required = true, dataType = "Long", paramType = "path")
@DeleteMapping("/{id}")
@ResponseBody
public ResultBody deleteUser(@PathVariable(value = "id") Long id) {
Long aLong = cityService.deleteUser(id);
System.out.println("along="+aLong);
System.out.println("删除掉的id="+id);
Map<String, Object> map = new HashMap<>();
map.put("result", "删除成功");
ResultBody resultBody = new ResultBody(map);
return resultBody;
}
@ApiOperation(value = "更新用户", notes = "根据用户id更新用户")
@ApiImplicitParams(@ApiImplicitParam(name = "user", value = "用户实体", required = true, dataType = "User"))
@PutMapping("/{id}")
@ResponseBody
public ResultBody updateUser(@RequestBody User user) {
System.out.println(user.toString());
Long aLong = cityService.updateUser(user);
System.out.println("aLong="+aLong);
Map<String, Object> map = new HashMap<>();
map.put("result", "更新成功");
ResultBody resultBody = new ResultBody(map);
return resultBody;
}
}
复制代码
Swagger经常使用注解
-
@Api：修饰整个类，描述Controller的做用；
-
@ApiOperation：描述一个类的一个方法，或者说一个接口；
-
@ApiParam：单个参数描述；
-
@ApiModel：用对象来接收参数；
-
@ApiProperty：用对象接收参数时，描述对象的一个字段；
-
@ApiResponse：HTTP响应其中1个描述；
-
@ApiResponses：HTTP响应总体描述；
-
@ApiIgnore：使用该注解忽略这个API；
-
@ApiError ：发生错误返回的信息；
-
@ApiImplicitParam：一个请求参数；
-
@ApiImplicitParams：多个请求参数。
-
编写RESTful API接口
- Spring Boot中包含了一些注解，对应于HTTP协议中的方法：
- @GetMapping对应HTTP中的GET方法；
- @PostMapping对应HTTP中的POST方法；
- @PutMapping对应HTTP中的PUT方法；
- @DeleteMapping对应HTTP中的DELETE方法；
- @PatchMapping对应HTTP中的PATCH方法。
-
本文git地址Swagger2Demo
-
最后说明几点
- 感谢给与我学习的帮助SpringAll
RESTful只是一种风格，并非一种强制性的标准。- 访问 http://localhost:8080/swagger-ui.html#/ 就是
Swagger UI spring.profiles.active=dev使用的是开发的环境- 为了使APi返回更加的规整，我使用了
ResultBody,来返回给客户端，若是不写getXXX的方法的话，IllegalArgumentException： 不合法的参数异常。No converter found for return value of type： 找不到类型返回值的转换器 .这个类必定得提供。 - 仅限于学习
相关文章
- 1. Spring Boot整合Swagger2构建RESTful API
- 2. Spring Boot构建RESTful API
- 3. Spring Boot 、mybatis 、swagger 和 c3p0 整合
- 4. SSM整合系列之 集成Swagger构建RESTFul API文档
- 5. 二十6、spring-boot结合Swagger2构建RESTful API测试体系
- 6. Spring Boot：整合Swagger文档
- 7. spring boot+mybatis+swagger搭建
- 8. Spring boot 整合 Swagger UI
- 9. springcloud整合swagger 界面查看restful api
- 10. spring boot+swagger 生成Restful风格API
- 更多相关文章...
- • SSM（Spring+Spring MVC+MyBatis）框架整合搭建详细步骤 - Spring教程
- • MyBatis与Spring的整合实例 - MyBatis教程
- • Spring Cloud 微服务实战(三) - 服务注册与发现
- • 适用于PHP初学者的学习线路和建议
相关标签/搜索
每日一句
-
每一个你不满意的现在，都有一个你没有努力的曾经。
欢迎关注本站公众号,获取更多信息
相关文章
- 1. Spring Boot整合Swagger2构建RESTful API
- 2. Spring Boot构建RESTful API
- 3. Spring Boot 、mybatis 、swagger 和 c3p0 整合
- 4. SSM整合系列之 集成Swagger构建RESTFul API文档
- 5. 二十6、spring-boot结合Swagger2构建RESTful API测试体系
- 6. Spring Boot：整合Swagger文档
- 7. spring boot+mybatis+swagger搭建
- 8. Spring boot 整合 Swagger UI
- 9. springcloud整合swagger 界面查看restful api
- 10. spring boot+swagger 生成Restful风格API