本文旨在解决在使用 CDI（Contexts and Dependency Injection）时，由于接口存在多个实现类而导致的注入歧义问题。通过引入 CDI 限定符，我们将学习如何明确指定需要注入的实现类，从而避免注入失败，并确保应用程序的正确运行。文章将提供详细的代码示例和步骤，帮助读者理解和应用 CDI 限定符，提升 CDI 开发技能。
在使用 CDI 进行依赖注入时，如果一个接口有多个实现类，CDI 容器将无法确定应该注入哪个实现类，从而导致注入歧义错误。 本文将介绍如何使用 CDI 限定符来解决这个问题，并提供详细的代码示例和步骤。
理解 CDI 注入歧义
在 CDI 中，Bean 是通过其类型和限定符来识别的。默认情况下，类型是从定义 Bean 的 Bean 类的传递类型闭包派生的（或者从定义 Bean 的生产者方法/字段的返回类型派生的）。
例如，如果有一个接口 Hello，它有两个实现类 HelloImpl1 和 HelloImpl2，那么 CDI 容器会识别出两个具有以下类型的 Bean：
- {Hello, HelloImpl1}
- {Hello, HelloImpl2}
如果没有使用任何限定符，当尝试使用 @Inject Hello hello 注入 Hello 接口时，CDI 容器会发现有两个符合条件的 Bean，因此无法确定应该注入哪个 Bean，从而导致注入歧义错误。
使用 CDI 限定符解决歧义
解决 CDI 注入歧义的正确方法是使用 CDI 限定符。限定符允许我们为 Bean 添加额外的标识信息，从而使 CDI 容器能够区分不同的 Bean。
1. 定义限定符
首先，需要定义一个自定义的限定符。限定符本身是一个注解，需要使用 @Qualifier、@Retention 和 @Target 元注解进行标记。
import static java.lang.annotation.ElementType.FIELD;
import static java.lang.annotation.ElementType.METHOD;
import static java.lang.annotation.ElementType.PARAMETER;
import static java.lang.annotation.ElementType.TYPE;
import static java.lang.annotation.RetentionPolicy.RUNTIME;
import java.lang.annotation.Retention;
import java.lang.annotation.Target;
import jakarta.inject.Qualifier;
@Qualifier
@Retention(RUNTIME)
@Target({ TYPE, FIELD, METHOD, PARAMETER })
public @interface MyQualifier {
}在上面的代码中，@MyQualifier 是我们自定义的限定符。@Retention(RUNTIME) 表示该注解在运行时保留，@Target 指定该注解可以应用于哪些元素（例如，类型、字段、方法、参数）。
2. 使用限定符标记 Bean
接下来，需要使用自定义的限定符来标记需要区分的 Bean。
import jakarta.enterprise.context.Dependent;
import jakarta.inject.Named;
@Dependent // this is just an example, use any scope you need or have been using
@MyQualifier // specify qualifier of this bean
@Named("HelloImpl1")
public class HelloImpl1 implements Hello {
// some very cool code
@Override
public String sayHello() {
return "Hello from HelloImpl1";
}
}import jakarta.enterprise.context.Dependent;
import jakarta.inject.Named;
@Dependent // this is just an example, use any scope you need or have been using
@Named("HelloImpl2")
public class HelloImpl2 implements Hello {
// some very cool code
@Override
public String sayHello() {
return "Hello from HelloImpl2";
}
}在上面的代码中，HelloImpl1 类使用 @MyQualifier 注解进行标记，表示它具有 MyQualifier 限定符。
3. 在注入点使用限定符
最后，需要在注入点使用相同的限定符来指定需要注入的 Bean。
import jakarta.inject.Inject;
public class MyClass {
// declare the injection point with qualifier(s)
@Inject
@MyQualifier
Hello helloBean;
public void doSomething() {
System.out.println(helloBean.sayHello());
}
}在上面的代码中，helloBean 字段使用 @MyQualifier 注解进行标记，表示需要注入具有 MyQualifier 限定符的 Hello 接口的实现类。
完整示例
以下是一个完整的示例，演示如何使用 CDI 限定符解决接口注入歧义问题：
// Hello.java
public interface Hello {
String sayHello();
}
// HelloImpl1.java
import jakarta.enterprise.context.Dependent;
import jakarta.inject.Named;
@Dependent // this is just an example, use any scope you need or have been using
@MyQualifier // specify qualifier of this bean
@Named("HelloImpl1")
public class HelloImpl1 implements Hello {
// some very cool code
@Override
public String sayHello() {
return "Hello from HelloImpl1";
}
}
// HelloImpl2.java
import jakarta.enterprise.context.Dependent;
import jakarta.inject.Named;
@Dependent // this is just an example, use any scope you need or have been using
@Named("HelloImpl2")
public class HelloImpl2 implements Hello {
// some very cool code
@Override
public String sayHello() {
return "Hello from HelloImpl2";
}
}
// MyQualifier.java
import static java.lang.annotation.ElementType.FIELD;
import static java.lang.annotation.ElementType.METHOD;
import static java.lang.annotation.ElementType.PARAMETER;
import static java.lang.annotation.ElementType.TYPE;
import static java.lang.annotation.RetentionPolicy.RUNTIME;
import java.lang.annotation.Retention;
import java.lang.annotation.Target;
import jakarta.inject.Qualifier;
@Qualifier
@Retention(RUNTIME)
@Target({ TYPE, FIELD, METHOD, PARAMETER })
public @interface MyQualifier {
}
// MyClass.java
import jakarta.inject.Inject;
public class MyClass {
// declare the injection point with qualifier(s)
@Inject
@MyQualifier
Hello helloBean;
public void doSomething() {
System.out.println(helloBean.sayHello());
}
public static void main(String[] args) {
// This part depends on your CDI container (e.g., Weld, OpenWebBeans)
// Here's a simplified example using a hypothetical CDI container:
MyClass myClass = CDI.current().select(MyClass.class).get();
myClass.doSomething();
}
}注意事项
- 确保限定符的 @Retention 设置为 RUNTIME，以便在运行时可以使用限定符。
- 确保在 Bean 的声明和注入点使用相同的限定符。
- 可以使用多个限定符来进一步区分 Bean。
总结
通过使用 CDI 限定符，我们可以解决接口注入歧义问题，并明确指定需要注入的实现类。 这可以提高应用程序的可靠性和可维护性，并使 CDI 注入更加灵活和强大。 建议阅读 CDI 规范，了解更多关于类型安全解析和限定符的信息。
