由于Spring Boot能够快速开发.便捷部署等特性,相信有很大一部分Spring Boot的用户会用来构建RESTful API.而我们构建RESTful API的目的通常都是由于多终端的原因,这些终端会共用很多底层业务逻辑,因此我们会抽象出这样一层来同时服务于多个移动端或者Web前端. 这样一来,我们的RESTful API就有可能要面对多个开发人员或多个开发团队:IOS开发.Android开发或是Web开发等.为了减少与其他团队平时开发期间的频繁沟通成本,传统做法我们会创建一份RESTf…
Spring boot 多模块项目 + Swagger 让你的API可视化 前言 手写 Api 文档的几个痛点: 文档需要更新的时候,需要再次发送一份给前端,也就是文档更新交流不及时. 接口返回结果不明确 不能直接在线测试接口,通常需要使用工具,比如postman 接口文档太多,不好管理 为了前后台更好的对接,为了以后交接方便,为了不再长篇大论的手写 api 文档,那么就来用Swagger吧(不是打广告,确实强),它可以轻松的整合到 Spring 中,它既可以减少我们手写 api 文档的时间,同…
用Spring Boot编写RESTful API 学习笔记 Transactional 判定顺序 propagation isolation 脏读 不可重复读 幻读 不可重复读是指记录不同 (update),幻读是数据条数不同 (insert, delete) 几种隔离的比较 isolation vs. lock 两个不同的东西,隔离不是靠锁实现的,是靠对数据的监控实现的 锁:表加好锁了,除非出现死锁等特殊状况,事务是不会被数据库主动回滚的 隔离:如果发现数据不符合相应的事务隔离级别,当前事务…
用Spring Boot编写RESTful API 学习笔记 概念 驱动模块 被测模块 桩模块 替代尚未开发完毕的子模块 替代对环境依赖较大的子模块 (例如数据访问层) 示例 测试 Service @RunWith(SpringRunner.class) @SpringBootTest public class TvSeriesServiceTest { @MockBean TvSeriesDao tvSeriesDao; @MockBean TvCharacterDao tvCharacter…
用Spring Boot编写RESTful API 学习笔记 添加依赖 <dependency> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> <version>1.3.2</version> </dependency> <dependency> <…
用Spring Boot编写RESTful API 学习笔记 程序的层次结构 相邻层级的数据传输 JavaBean 有一个 public 的无参构造方法 属性 private,且可以通过 get.set.is (可以替代 get,用在布尔属性上) 方法或遵循特定命名规范的其他方法访问 可序列化,实现 Serializable 接口 POJO & JavaBean POJO 比 JavaBean 更简单.POJO 严格地遵守简单对象的概念,而一些 JavaBean 中往往会封装一些简单逻辑 POJ…
用Spring Boot编写RESTful API 学习笔记 约束规则对子类依旧有效 groups 参数 每个约束用注解都有一个 groups 参数 可接收多个 class 类型 (必须是接口) 不声明 groups 参数是默认组 javax.validation.groups.Default 声明了 groups 参数的会从 Default 组移除,如需加入 Default 组需要显示声明,例如 @Null(groups={Default.class, Step1.class}) @Valid…
用Spring Boot编写RESTful API 学习笔记 RESTful API 介绍 REST 是 Representational State Transfer 的缩写 所有的东西都是资源,所有操作都通过对资源的增删改查 (CRUD) 实现 对资源的增删改查对应对 URL 的操作 (POST, DELETE, PUT, GET) 无状态的 URL 中都应该是名词,不应该出现动词 关于 RESTful API 更详细可参考阮一峰老师的 RESTful API 最佳实践 RestContro…
1.添加Swagger2依赖 在pom.xml中加入Swagger2的依赖 <!--swagger2--> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>2.6.1</version> </dependency> <dependency>…
项目现状:由于前后端分离,没有很好的前后端合作工具. 由于接口众多,并且细节复杂(需要考虑不同的HTTP请求类型.HTTP头部信息.HTTP请求内容等),高质量地创建这份文档本身就是件非常吃力的事,下游的抱怨声不绝于耳. 随着时间推移,不断修改接口实现的时候都必须同步修改接口文档,而文档与代码又处于两个不同的媒介,除非有严格的管理机制,不然很容易导致不一致现象. 为了解决上面这样的问题,本文将介绍RESTful API的重磅好伙伴Swagger2,它可以轻松的整合到Spring Boot中,并与…