用 @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" );

MapStruct 的 @BeanMapping 和 @Mapping 的不同

@MappingMapStruct 的核心注解,用于定义不同名字的属性之间的映射。

JavaDoc:
Configures the mapping of one bean attribute.
配置一个 bean 属性的映射

@BeanMapping 用于控制整个映射方法。你可以通过设置 @BeanMappingNullValueCheckStrategy 使整个方法都生效。

JavaDoc:
Configures the mapping between two bean types
配置两个 bean 类型的映射

MapStruct 忽略 source 中的空值属性

Bean 属性映射中如何满足以下场景:

  1. 给定一个有数据的 Bean 对象,该对象的数据可能从 DB 或其它什么地方获取而来
  2. 从前端传递一个 DTO 对象过来,将该对象的内容更新到 bean 中
  3. 忽略 DTO 中的空属性(NULL)

MapStruct 使用介绍

MapStruct 是一个 Bean 映射工具,通过配置的注解,可以生成 Java 代码进行 Bean 映射。

由于是通过两个 Bean 的信息生成 Java 代码,并通过调用属性的 Getter/Setter 方法来实现的功能,性能上比其它通过反射实现的 Bean 映射工具要高很多,相当于自己手写代码复制对象。

本文主要介绍 MapStruct 的几种对象映射场景,方便使用时选用。

Flowable 中节点任意跳转

工作流开发中经常有一种回退的需求,审批回退、驳回、撤回等都需要。

在 Activiti 中流程底层没开放对应的接口,而在 Flowable 中已经提供了支持节点跳转的功能。同时我们也可以像在 Activiti 中通过实现自己的 Command 来实现任意节点跳转的需求。

下面我们先介绍一下 Flowable 提供的内置跳转功能,最后我们再手动实现任务跳转的 Command。

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

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

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

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