最近在跟着程序员DD的Spring boot教程系列学习Spring boot,由于年代原因,Spring boot已经发生了一些变化,所以在这里进行一些补充。
补充的知识大多来自评论区,百度,StackOverFlow
重要提示
阅读本文前请打开程序员DD的Spring boot教程系列
Spring Boot快速入门
- 如果你使用Intellij-idea的话,可以直接通过File-New-Project-Spring Initializr 操作新建项目,会比导入从网站生成的Maven demo更加快捷。
- 在Spring mvc的
@RequestMapping
标签中,可以不添加/,Spring mvc会帮助你默认添加。 - 当前的Spring mvc中,出于支持REST的需求,形如
@RequestMapping(method="RequestMapping.GET")
标签可以简单替换成@GetMapping
标签,POST,PUT,DELETE操作同理。 - 单元测试文档中,形如
@RunWith(SpringJUnit4ClassRunner.class)
@SpringApplicationConfiguration(classes = MockServletContext.class)
@WebAppConfiguration
的类标签,需要替换成如下:
@RunWith(SpringJUnit4ClassRunner.class)
@SpringBootTest
Spring Boot开发Web应用
这里问题不多,只有一个,原例子中的th标签没有添加xmln引用,通过Alt+Enter自动添加即可。
Spring Boot工程结构推荐
没什么问题,没有细分Dao层和Entity层,合并为了Domain层,其实是符合现代开发的。
Spring Boot构建RESTful API与单元测试
这里本身没有问题,需要注意的是,此处的对象是通过HTTP头添加的,也就是基于POST方法直接添加到ModelMap中,此处的测试也是通过这样的形式测试,而下一篇内容的相似代码在这里产生了区别。
Spring Boot中使用Swagger2构建强大的RESTful API文档
重点
对于Swagger2的使用,程序员DD大大提供了一种更优雅的方法,请参考这篇:
简化Swagger使用的自制Starter:spring-boot-starter-swagger,欢迎使用和吐槽
使用非常简单,通过yml统一配置也更加方便一些。这个配置方式集成了swagger2和swagger-ui。
这篇中格式相关内容有一些欠缺,这里详细说一些。
- 对于Swagger2文档里的
@ApiImplicitParam
属性,里面的内容如果是一个uri变量,那么应该加上paramType=path
,才能正确识别。 dataType
是一个必须要加的属性,加了这个才能正确显示。- 如果变量比较简单,其实默认生成的文档已经很强大了。不过最好还是手写
@ApiOperation
属性。 - Swagger2的配置文件中
.apis(RequestHandlerSelectors.basePackage("com.didispace.web"))
需要改为自己的包名,另外,contact()
方法在新版本中已经改为了新形式,请注意改动。 - 本篇中,对象是通过Body添加的,对应的测试方法也要改变,原测试方法中
request = post("/users/")
.param("id", "1")
.param("name", "测试大师")
.param("age", "20");
改为
request = post("/users/").contentType(MediaType.APPLICATION_JSON).content("{\"id\":1,\"name\":\"测试大师\",\"age\":20}");
其他地方也类似。
- 即使不使用swagger-ui库,我们也可以到处为json版本,访问/v2/api-docs就能获取json版本,并且,可以用postman导入该api,进行测试非常方便。
Spring Boot中使用Spring-data-jpa让数据访问更简单、更优雅
@Query("from User u where u.name=:name")
需要改成
@Query("select u from User u where u.name=:name")
spring.jpa.properties.hibernate.hbm2ddl.auto=create-drop
create-drop策略测试用用就好,一般选择update策略
- 该篇中没设置hibernate的方言,这是必须要设置的
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQLDialect
Spring Boot中使用Redis数据库
- 本文中Redis配置均为Spring boot给的默认配置,所以没有特殊改动根本不用写。
- Redis的工厂类RedisConfig,Spring boot有提供默认值,不用写。
- 如果你用的Redis版本大于2.8,那么Redis已经支持了类似jpa的Reporsity方式,不需要像文中一样麻烦。当需要管理自己的组件时,可以使用Redis提供的标签。
这里举例:
User类
@RedisHash("user")
public class User{
@Id
private Long id;
private String name;
private Integer age;
//构造函数(空参数和name,age双参数),访问器略
}
只要在类上添加好RedisHash标签,并在key上添加Spring的Id标签,即可。
UserRedisRepository类
public interface UserRedisRepository extends CrudRepository {
}
和jpa的Repository类类似,该接口实现了CRUD操作,并尽可能多的实现了各种查询方式,对于NoSQL而言,这基本满足了所有的需求,毕竟又不支持关系数据库的复杂功能。如果需要自定义,就要实现这个接口自己去写了,写法可以直接参考文档。
可以测试一下
RedisTests类
@RunWith(SpringJUnit4ClassRunner.class)
@SpringBootTest
public class RedisTests {
@Autowired
private StringRedisTemplate stringRedisTemplate;
@Autowired
private UserRedisRepository userRedisRepository;
@Test
public void testStringRedis() throws Exception{
stringRedisTemplate.opsForValue().set("Cielo","Good Boy");
Assert.assertEquals("Good Boy",stringRedisTemplate.opsForValue().get("Cielo"));
}
@Test
public void testObjectRedis() throws Exception{
User user=new User("Cielo",20);
user.setId(1l);
userRedisRepository.save(user);
Assert.assertEquals(user.getName(),userRedisRepository.findOne(1l).getName());
}
}
这个类测试了spring提供的string类型RedisTemplate和我们自定义的userRedisReposity。
中间多篇幅没有问题,略过。
需要注意的是,如果Redis和Hibernate的Repository同时作用于一个实体上时,会产生错误导致Hibernate的Repository不可用。
以及,Redis在Spring中和jpa一样支持事务,只要在相应方法上加上事务标记即可。
Spring boot中使用log4j记录日志
log4j已经旧了,而且Spring-boot原生集成了logback,后续将在此处补充logback配置信息。
Spring Boot中使用AOP统一处理Web请求日志
Spring的最主要特性之一,终于和大家见面了。
在写这篇的补充前,希望大家能理解其中一些写法的意思,DD给出的比较基础了,但是还不够全面。
这篇可以看看Spring之AOP注解配置详解
以及,aop是基于Spring的扫描去工作的而不是Spring-mvc,因此同时使用aop和web时,需要在pom.xml中先引入aop包才可以。这里简直大坑。
最后,关于aop的一些用途,可以看看这个例子:
使用AOP 实现Redis缓存注解,支持SPEL
Spring Boot中的事务管理
这里面有一个问题,DD大大对@Rollback这个注解没有详细说明,我在评论里看到几个网友都表示有疑问,我自己研究了下,在评论里进行了回复,也贴到这里:
实际上,@Rollback
标签是需要配合@Transcational
标签共同使用的,你可以理解为在Junit下对于加了Transactional标签的方法,会默认视为@Rollback(true)
,如果让这个方法不回滚,那么就要手动设置@Rollback(false)
。