Spring IoC注解式开发详解（附代码示例）

最新推荐文章于 2025-11-06 12:57:37 发布

原创最新推荐文章于 2025-11-06 12:57:37 发布 · 783 阅读

10 ·

CC 4.0 BY-SA版权

文章标签：

#spring #java #数据库

spring 专栏收录该内容

19 篇文章

订阅专栏

Spring框架的IoC（Inversion of Control，控制反转）机制是其核心特性之一。通过注解式开发，我们可以简化配置，提高代码的可读性和灵活性。本文将详细介绍Spring IoC注解式开发的核心知识点，并提供对应的代码示例。

一、IoC与注解开发简介

1. 什么是IoC？

IoC是一种设计思想，核心是将对象的创建和管理交给Spring容器，而非由应用程序直接控制。通过IoC，开发者无需手动创建对象，而是通过配置（XML或注解）声明依赖关系，Spring容器会自动完成对象的实例化和依赖注入。

2.注解开发的优势

简洁性：减少XML配置文件的冗余代码。
可读性：注解直接与Java代码绑定，逻辑更清晰。
灵活性：支持组件扫描、自动装配等功能。

二、声明Bean的注解

Spring提供了多个注解来声明Bean，常见的包括：

@Component：通用组件注解。
@Service：业务逻辑层组件。
@Repository：持久化层组件。
@Controller：控制层组件。

1.示例代码

// 数据访问层组件
@Repository
public class UserRepository {
    public void save() {
        System.out.println("Saving user to database...");
    }
}

// 业务逻辑层组件
@Service
public class UserService {
    @Autowired
    private UserRepository userRepository;

    public void registerUser() {
        userRepository.save();
    }
}

// 控制层组件
@Controller
public class UserController {
    @Autowired
    private UserService userService;

    public void handleRequest() {
        userService.registerUser();
    }
}

说明：

@Repository、@Service、@Controller都是@Component的派生注解，功能相同，但语义上区分了组件的层次。
Spring容器会自动扫描这些注解，并将对应的类注册为Bean。

三、组件扫描（Component Scanning）

1.什么是组件扫描？

组件扫描是Spring自动发现和注册带有注解的类（如@Component）的功能。开发者只需指定包路径，Spring会自动扫描并创建Bean。

2.配置组件扫描

在配置类或XML文件中启用组件扫描：

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

XML配置示例：

<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:context="http://www.springframework.org/schema/context"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
                           https://www.springframework.org/schema/beans/spring-beans.xsd
                           http://www.springframework.org/schema/context
                           https://www.springframework.org/schema/context/spring-context.xsd">

    <!-- 启用组件扫描 -->
    <context:component-scan base-package="com.example.demo" />
</beans>

四、依赖注入（Dependency Injection）

1. 使用`@Autowired`注入依赖

Spring通过@Autowired注解自动完成依赖注入，支持字段、构造方法、Setter方法等场景。

示例1：字段注入

@Service
public class OrderService {
    @Autowired
    private OrderRepository orderRepository;

    public void processOrder() {
        orderRepository.save();
    }
}

示例2：构造方法注入

@Service
public class ProductService {
    private final ProductRepository productRepository;

    @Autowired
    public ProductService(ProductRepository productRepository) {
        this.productRepository = productRepository;
    }

    public void createProduct() {
        productRepository.save();
    }
}

示例3：Setter注入

@Service
public class CustomerService {
    private CustomerRepository customerRepository;

    @Autowired
    public void setCustomerRepository(CustomerRepository customerRepository) {
        this.customerRepository = customerRepository;
    }

    public void addCustomer() {
        customerRepository.save();
    }
}

2.使用`@Value`注入基本类型

@Value用于注入基本数据类型或外部配置的值。

@Component
public class ConfigReader {
    @Value("${app.max-users}")
    private int maxUsers;

    public void printMaxUsers() {
        System.out.println("Max users allowed: " + maxUsers);
    }
}

application.properties：

app.max-users=100

五、配置类（@Configuration + @Bean）

1.什么是配置类？

配置类通过@Configuration注解定义，用于替代XML配置文件。@Bean注解用于声明方法返回的对象为Spring容器管理的Bean。

2.示例代码

@Configuration
public class AppConfig {
    @Bean
    public DataSource dataSource() {
        return new HikariDataSource(); // 示例数据源
    }

    @Bean
    public UserRepository userRepository(DataSource dataSource) {
        return new UserRepository(dataSource);
    }
}

说明：

@Configuration标记的类可以包含多个@Bean方法。
方法返回的对象会被Spring容器注册为Bean。

六、自定义注解

1. 定义自定义注解

自定义注解需要结合元注解（如@Target、@Retention）。

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface MyComponent {
    String value() default "";
}

2.使用自定义注解

@MyComponent("customBean")
public class CustomService {
    public void execute() {
        System.out.println("Custom service executing...");
    }
}

3. 扫描自定义注解

在配置类中启用自定义注解的扫描：

@Configuration
@ComponentScan(
    basePackages = "com.example.demo",
    includeFilters = @ComponentScan.Filter(type = FilterType.ANNOTATION, classes = MyComponent.class)
)
public class AppConfig {
}