掌握Java CDI（上下文与依赖注入）——从零开始的Java CDI依赖注入实战指南

为什么使用CDI？

• 简化代码：无需手动管理对象创建和依赖。
• 提高可测试性：依赖可以轻松被模拟或替换。
• 支持多种作用域：如请求作用域、会话作用域、单例等。
• 与Java EE其他技术无缝集成（如JAX-RS、EJB等）。

准备工作

要使用CDI，你需要一个支持Java EE 6+ 或 Jakarta EE 8+ 的应用服务器，例如：

• WildFly
• Payara Server
• TomEE
• Open Liberty

此外，你的项目必须包含一个空的beans.xml文件，放在src/main/resources/META-INF/（Java SE）或src/main/webapp/WEB-INF/（Web项目）目录下，以启用CDI功能。

第一个CDI示例

让我们通过一个简单的例子来演示如何使用CDI依赖注入。

步骤1：定义一个服务类

package com.example.service;import javax.enterprise.context.ApplicationScoped;@ApplicationScopedpublic class GreetingService {    public String greet(String name) {        return "Hello, " + name + "! Welcome to Java CDI.";    }}

这里我们使用了@ApplicationScoped注解，表示这个Bean在整个应用生命周期内是单例的。

步骤2：注入并使用服务

package com.example.controller;import com.example.service.GreetingService;import javax.inject.Inject;import javax.ws.rs.GET;import javax.ws.rs.Path;import javax.ws.rs.Produces;import javax.ws.rs.core.MediaType;@Path("/api")public class GreetingController {    @Inject    private GreetingService greetingService;    @GET    @Path("/greet/{name}")    @Produces(MediaType.TEXT_PLAIN)    public String sayHello(String name) {        return greetingService.greet(name);    }}

通过@Inject注解，CDI容器会自动将GreetingService的实例注入到GreetingController中，无需你手动创建。

CDI的作用域（Scopes）

CDI支持多种作用域，常见的包括：

• @Dependent（默认）：每次注入都创建新实例。
• @ApplicationScoped：整个应用共享一个实例。
• @RequestScoped：每个HTTP请求一个实例。
• @SessionScoped：每个用户会话一个实例。
• @Singleton：由容器保证线程安全的单例（注意与EJB的@Singleton区别）。

常见问题与最佳实践

- 确保你的类是无参构造函数，否则CDI可能无法实例化它。
- 避免在Bean中使用static字段存储状态。
- 使用限定符（Qualifiers）解决多个实现类的注入歧义问题。

结语

通过本篇Java CDI教程，你应该已经掌握了CDI依赖注入的基本用法，并了解了如何在实际项目中应用它。CDI不仅简化了代码结构，还提升了应用的可维护性和可测试性。如果你正在开发Java EE CDI应用，那么熟练掌握上下文与依赖注入将是迈向高级Java开发的重要一步。

继续深入学习Jakarta EE规范，探索更多CDI高级特性，如事件、拦截器和装饰器！