Spring Boot 2 实践记录之 条件装配
实验项目是想要使用多种数据库访问方式,比如 JPA 和 MyBatis。
项目的 Service 层业务逻辑相同,只是具体实现代码不同,自然是一组接口,两组实现类的架构比较合理。
不过这种模式却有一个问题,如果 Bean 是按实现类装配,则在切换数据库访问方式时,就需要大量的代码修改。如果按接口装配,则会出现歧义(同一接口有两个实现,无法自动装配)。
虽然可以使用「首选Bean」或「限定」装配,但是与直接使用实现类装配一样,切换数据库访问地,仍然要大量修改源码。
经过实验,使用「条件装配」实现了利用配置切换数据库访问方式,不需要修改代码了。
示例:
先定义 Service 接口:
public interface UserServiceInterface { ...... }
再定义 MyBatis 实现类:
@Service @Conditional(MybatisCondition.class) public class UserServiceMybatisImpl implements UserServiceInterface { ...... }
注意其中的 @Conditional(MybatisCondition.class),MybatisCondition 类必须实现 org.springframework.context.annotation.Condition 接口,该接口仅有一个 matches 方法,当该方法返回真时,UserServiceMybatisImpl 被装配。
MybatisCondition 的 matches 方法的逻辑被实现为根据配置文件中的 use.data.access.method 属性是否为 mybatis,来决定是否装配 UserServiceMybatisImpl 类:
import org.springframework.context.annotation.Condition; import org.springframework.context.annotation.ConditionContext; import org.springframework.core.env.Environment; import org.springframework.core.type.AnnotatedTypeMetadata; public class MybatisCondition implements Condition { @Override public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) { Environment env = context.getEnvironment(); if (env.getProperty("use.data.access.method").equals("mybatis")) { return true; } return false; } }
再定义 SPA 实现类及其 SpaCondition 类,实现方式与 Mybatis 相同,仅在配置项为 spa 时,装配 UserServiceSpaImpl 类:
@Service @Conditional(SpaCondition.class) public class UserServiceSpaImpl implements UserServiceInterface { ...... }
import org.springframework.context.annotation.Condition; import org.springframework.context.annotation.ConditionContext; import org.springframework.core.env.Environment; import org.springframework.core.type.AnnotatedTypeMetadata; public class SpaCondition implements Condition { @Override public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) { Environment env = context.getEnvironment(); if (env.getProperty("use.data.access.method").equals("spa")) { return true; } return false; } }
定义一个类,自动装配 UserServiceInterface,并打印其类名:
public class Test { @Autowired private UserServiceInterface userServiceInterface; public void testUserService() { System.out.println(userServiceInterface.getClass(); } }
现在还不能运行,需要添加配置项。
先将配置项配置为 mybatis:
use.data.access.method = mybatis
运行 Test 类的 testUserService 方法,结果为:
UserServiceMybatisImpl
将配置项修改为 spa:
use.data.access.method = spa
运行 Test 类的 testUserService 方法,结果为:
UserServiceSpaImpl
不过,有个小小的缺憾,就是在 Idea 中,如下代码行:
@Autowired private UserServiceInterface userServiceInterface;
会有错误提示:
Could not autowire. There is more than one bean of 'UserServiceInterface' type.
Beans:
userServiceMybatisImpl (UserServiceMybatisImpl.java)
userServiceSpaImpl (UserServiceSpaImpl.java)
由于配置项是在运行时读取的,Idea 在静态语法检查时,实在没办法搞定这个自动装配的判断。
没关系,不影响运行!