使用构造函数注入实现 Spring 依赖注入

Spring 框架提供了多种方式来实现依赖注入，其中构造函数注入是最推荐的一种方式。通过构造函数注入，可以确保所有必需的依赖在对象创建时就被提供，避免了未初始化的依赖导致的潜在问题。本文将详细介绍如何使用构造函数注入实现 Spring 依赖注入。

一、什么是依赖注入

依赖注入（Dependency Injection, DI）是控制反转（Inversion of Control, IoC）的实现方式之一。它通过将对象的依赖（通常是其他对象）注入到对象内部，而不是在对象内部自行创建这些依赖，从而使得对象之间的依赖关系变得更加清晰和可管理。Spring 通过其 IoC 容器实现了依赖注入，允许开发者轻松地管理对象及其依赖关系。

二、构造函数注入概述

构造函数注入是依赖注入的一种方式，它通过构造函数参数将依赖传递给对象。使用构造函数注入的主要优势包括：

1. 强制依赖：在对象创建时强制提供所有必需的依赖，确保对象总是处于正确的初始化状态。
2. 不可变性：依赖通过构造函数传递后，通常不再改变，有助于保持对象的不可变性。
3. 易于测试：通过构造函数注入，可以轻松地在测试中提供模拟（mock）依赖。

三、使用构造函数注入实现依赖注入

1. 项目结构

一个典型的 Spring 项目结构如下：

my-spring-constructor-injection-project/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/
│   │   │       └── example/
│   │   │           └── project/
│   │   │               ├── config/
│   │   │               │   └── AppConfig.java
│   │   │               ├── service/
│   │   │               │   ├── ExampleService.java
│   │   │               │   └── AnotherService.java
│   │   │               └── controller/
│   │   │                   └── ExampleController.java
│   └── resources/
│       └── application.properties
└── pom.xml

2. Java 类定义

// ExampleService.java
package com.example.project.service;

import org.springframework.stereotype.Service;

@Service
public class ExampleService {
    public String serve() {
        return "Service is serving";
    }
}

// AnotherService.java
package com.example.project.service;

import org.springframework.stereotype.Service;

@Service
public class AnotherService {
    public String assist() {
        return "Another service is assisting";
    }
}

// ExampleController.java
package com.example.project.controller;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import com.example.project.service.ExampleService;
import com.example.project.service.AnotherService;

@Controller
public class ExampleController {
    private final ExampleService exampleService;
    private final AnotherService anotherService;

    @Autowired
    public ExampleController(ExampleService exampleService, AnotherService anotherService) {
        this.exampleService = exampleService;
        this.anotherService = anotherService;
    }

    public void doSomething() {
        System.out.println(exampleService.serve());
        System.out.println(anotherService.assist());
    }
}

3. 配置类

// AppConfig.java
package com.example.project.config;

import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;

@Configuration
@ComponentScan(basePackages = "com.example.project")
public class AppConfig {
}

4. 启动类

// Application.java
package com.example.project;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

5. application.properties

配置文件用于配置应用程序参数，如服务器端口、数据库连接等。

server.port=8080

6. 测试类

// ApplicationTests.java
package com.example.project;

import com.example.project.controller.ExampleController;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;

@SpringBootTest
public class ApplicationTests {
    
    @Autowired
    private ExampleController exampleController;

    @Test
    public void testDoSomething() {
        exampleController.doSomething();
    }
}

四、总结

构造函数注入是实现 Spring 依赖注入的一种推荐方式。它通过构造函数参数将依赖传递给对象，确保对象在创建时就具备所有必需的依赖，从而避免了未初始化的依赖问题。构造函数注入不仅有助于保持对象的不可变性，还能提高代码的可测试性。在实际开发中，使用构造函数注入可以使得代码更加清晰、健壮和易于维护。