用 @ApiVersion 注解给 API 增加版本号

通常我们设计 REST 接口时会要求在 API 上增加版本号,以方便在接口升级时保证一定的兼容性。我们假定设计的接口入下:

1
GET /api/v1/user/{userId}

在 Spring MVC 中可以这样这样实现:

1
2
3
4
5
@GetMapping(value = "/api/v1/user/{userId}")
public ResponseEntity<?> getUser(@PathVariable(value = "userId") String userId) {
return WebResponse.create(userService.getUser(userId))
.ok();
}

GetMapping 注解中手动指定了接口版本,但每个接口都指定或指定在类上也是非常不方便的,我们希望有一个注解来简化的约束这个配置的过程

Spring 中手动注入 @Autowired 字段

自己 new 出来的对象如何让 Spring 帮我们注入其中依赖的对象?可以使用以下方法:

1
2
3
4
Bean bean = new Bean();
AutowireCapableBeanFactory factory = applicationContext.getAutowireCapableBeanFactory();
factory.autowireBean( bean );
factory.initializeBean( bean, "bean" );

使用注解的方式注册 Quartz 的 Job

Java 程序员最喜欢的就是造轮子了,后端开发中时常要自己造一些轮子,一个工具包、封装一些开源组件、功能定制化等等,太常见了。

在 Spring 的自造轮子最常见的莫过于设计个注解,然后扫描到后在 BeanPostProcessor 中处理该注解对象,并根据注解组装一个新的对象然后注册到 Spring 中。

场景如《Quartz 动态调度 Job》所述那样,现在对文中 @ScheduledJob 注解的实现做详细说明。

Quartz 动态调度 Job

最近在开发 Quartz Job 任务时有一种很迫切的需求,希望能动态调整生产的 Job 的运行,开启或停止 Job、调整 Job 的运行频率。翻了一下源码,基于 Quartz 的 Scheduler 扩展一个。

控制 Quartz 是否启动

在开发集成了 Quartz 的应用时,由于 Quartz 在开发环境一般也会自动启动。这样会给人造成不少烦恼,一个是启动 Job 会影响本地的运行效率,同时如果是分布 式模式的 Quartz 会出现本地抢任务运行,又由于本地和测试环境的各种不一致,会出现很多奇怪问题。

GenericJackson2JsonRedisSerializer 的时间序列化问题

GenericJackson2JsonRedisSerializer 是 Spring Data Redis 包提供的一个类,用于将 Java 对象与 JSON 字符串进行转换,存储于 Redis 时是 JSON,取出来时转换为 Java 对象。

该类是用于设置 RedisTemplate 的序列化器时一般这样配置:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
private RedisTemplate<Object, Object> createGenericRedisTemplate(RedisConnectionFactory redisConnectionFactory) {
RedisTemplate<Object, Object> redisTemplate = new RedisTemplate<>();

redisTemplate.setKeySerializer(new StringRedisSerializer());

redisTemplate.setHashKeySerializer(new StringRedisSerializer());


redisTemplate.setValueSerializer(new GenericJackson2JsonRedisSerializer());
redisTemplate.setHashValueSerializer(new GenericJackson2JsonRedisSerializer());
redisTemplate.setDefaultSerializer(new GenericJackson2JsonRedisSerializer());

redisTemplate.setConnectionFactory(redisConnectionFactory);
return redisTemplate;
}

这个配置一般用起来是没问题的,但很快你会发现一些理所当然的配置会不生效。

Spring Boot 中的 @EnableWebMvc

@EnableWebMvc 注解并不是像一般理解的那样在 Spring Boot 中使用 Spring MVC 必需要有的配置,而且并不是像字面意思那样启用 Spring MVC 的 功能。

@EnableWebMvc 的作用是引入 DelegatingWebMvcConfiguration 类来支持通过 WebMvcConfigurer 来对 WebMvc 进行配置。但其引入 DelegatingWebMvcConfiguration 的结果是导致 Spring MVC 相关的自动配置功能失效。