欢迎访问我的GitHub
这里分类和汇总了欣宸的全部原创(含配套源码)：https://github.com/zq2599/blog_demos
本篇概览
- 本文是《quarkus依赖注入》系列的第四篇，在应用中，一个接口有多个实现是很常见的，那么依赖注入时，如果类型是接口，如何准确选择实现呢？前文介绍了五种注解，用于通过配置项、profile等手段选择注入接口的实现类，面对复杂多变的业务场景，有时候仅靠这两种手段是不够的，最好是有更自由灵活的方式来选择bean，这就是本篇的内容，通过注解、编码等更多方式选择bean
- 本篇涉及的选择bean的手段有以下四种：
- 修饰符匹配
- Named注解的属性匹配
- 根据优先级选择
- 写代码选择
关于修饰符匹配
- 为了说明修饰符匹配，先来看一个注解Default，其源码如下
@Target({ TYPE, METHOD, PARAMETER, FIELD })
@Retention(RUNTIME)
@Documented
@Qualifier
public @interface Default {
public static final class Literal extends AnnotationLiteral<Default> implements Default {
public static final Literal INSTANCE = new Literal();
private static final long serialVersionUID = 1L;
}
}
- Default的源码在这里不重要，关键是它被注解Qualifier修饰了，这种被Qualifier修饰的注解，咱们姑且称之为Qualifier修饰符
- 如果咱们新建一个注解，也用Qualifier来修饰，如下所示，这个MyQualifier也是个Qualifier修饰符
@Qualifier
@Retention(RUNTIME)
@Target({TYPE, METHOD, FIELD, PARAMETER})
public @interface MyQualifier {
@Nonbinding String value();
}
- 在quarkus容器中的每一个bean都应该有一个Qualifier修饰符在修饰，如下图红框，如果没有，就会被quarkus添加Default注解
- 依赖注入时，直接用Qualifier修饰符修饰注入对象，这样quarkus就会去寻找被这个Qualifier修饰符修饰的bean，找到就注入（找不到报错，找到多个也报错，错误逻辑和之前的一样）
- 所以用修饰符匹配来选择bean的实现类，一共分三步：
- 假设有名为HelloQualifier的接口，有三个实现类：HelloQualifierA、HelloQualifierB、HelloQualifierC，业务需求是使用HelloQualifierA
- 第一步：自定义一个注解，假设名为MyQualifier，此注解要被Qualifier修饰
- 第二步：用MyQualifier修饰HelloQualifierA
- 第三步：在业务代码的注入点，用MyQualifier修饰HelloQualifier类型的成员变量，这样成员变量就会被注入HelloQualifierA实例
- 仅凭文字描述，很难把信息准确传递给读者（毕竟欣宸文化水平极其有限），还是写代码实现上述场景吧，聪明的您一看就懂
编码演示修饰符匹配：准备工作
-
先按照前面的假设将接口和实现类准备好，造成一个接口有多个实现bean的事实，然后，再用修饰符匹配来准确选定bean
-
首先是接口HelloQualifier，如下所示
package com.bolingcavalry.service;
public interface HelloQualifier {
String hello();
}
- 实现类HelloQualifierA，返回自己的类名
package com.bolingcavalry.service.impl;
import com.bolingcavalry.service.HelloQualifier;
import javax.enterprise.context.ApplicationScoped;
@ApplicationScoped
public class HelloQualifierA implements HelloQualifier {
@Override
public String hello() {
return this.getClass().getSimpleName();
}
}
- 实现类HelloQualifierB、HelloQualifierC的代码和上面的HelloQualifierA相同，都是返回自己类名，就不贴出来了
- 关于使用HelloQualifier类型bean的代码，咱们就在单元测试类中注入吧，如下所示：
package com.bolingcavalry;
import com.bolingcavalry.service.HelloQualifier;
import com.bolingcavalry.service.impl.HelloQualifierA;
import io.quarkus.test.junit.QuarkusTest;
import org.junit.jupiter.api.Assertions;
import org.junit.jupiter.api.Test;
import javax.inject.Inject;
@QuarkusTest
public class QualifierTest {
@Inject
HelloQualifier helloQualifier;
@Test
public void testQualifier() {
Assertions.assertEquals(HelloQualifierA.class.getSimpleName(),
helloQualifier.hello());
}
}
- 上面的代码中，成员变量helloQualifier的类型是HelloQualifier，quarkus的bean容器中，HelloQualifierA、HelloQualifierB、HelloQualifierC等三个bean都符合注入要求，此时如果执行单元测试，应该会报错：同一个接口多个实现bean的问题
- 执行单元测试，如下图，黄框中给出了两个线索：第一，错误原因是注入时发现同一个接口有多个实现bean，第二，这些bean都是用Default修饰的，然后是绿框，里面将所有实现bean列出来，方便开发者定位问题
- 现在准备工作完成了，来看如何用修饰符匹配解决问题：在注入点准确注入HelloQualifierA类型实例
编码演示修饰符匹配：实现匹配
- 使用修饰符匹配，继续按照前面总结的三步走
- 第一步：自定义一个注解，名为MyQualifier，此注解要被Qualifier修饰
package com.bolingcavalry.annonation;
import javax.enterprise.