当前位置：首页 > news >正文

Spring注解驱动开发：从XML到注解的完美蜕变

news 2025/9/21 5:49:22

一、前言：为什么要从XML转向注解？

传统的Spring框架依赖XML配置文件来管理Bean和依赖关系，但随着项目规模扩大，XML配置变得臃肿且难以维护。Spring 2.5引入的注解驱动开发彻底改变了这一局面，让代码更加简洁、直观。

本文将基于实际代码示例，带你全面掌握Spring注解开发的核心技巧！

二、项目结构概览

先来看一下我们的示例项目结构：

org.xsy
├── demo
│   ├── Demo.java      # 基础组件类
│   └── User.java      # 使用注解的实体类
└── xsy.java          # 测试类

三、详解核心注解

1. 组件注册注解

Spring提供了四个层次化的注解来注册Bean：

@Component        // 通用组件注解
@Controller       // 表现层组件注解
@Service          // 业务层组件注解
@Repository       // 持久层组件注解

这些注解本质上没有功能区别，但通过命名区分层次，提高了代码的可读性和维护性。

2. 依赖注入注解

(1) @Value - 普通类型注入

@Value("李华")     // 直接注入字符串值
private String name;@Value("10")      // 注入整型值
private int age;

@Value注解用于注入基本数据类型和String类型，支持SpEL表达式和属性占位符。

(2) 对象类型注入的三种方式

方式一：@Autowired + @Qualifier

@Autowired        // 按类型自动装配
@Qualifier("demo") // 指定Bean名称
private Demo demo;

方式二：@Resource

@Resource(name = "demo") // 按名称装配（推荐）
private Demo demo;

方式三：XML配置方式

<bean id="demo" class="org.xsy.demo.Demo"/>
<bean id="user" class="org.xsy.demo.User"><property name="name" value="张三"/><property name="age" value="20"/><property name="demo" ref="demo"/>
</bean>

3. 配置类注解

(1) XML配置方式

<!-- 开启注解扫描，扫描org.xsy包下的所有组件 -->
<context:component-scan base-package="org.xsy"/>

(2) 纯注解方式（Spring Boot推荐）

@Configuration      // 声明为配置类
@ComponentScan("org.xsy") // 配置组件扫描路径
public class AppConfig {
}

四、实战代码解析

1. 基础组件类

package org.xsy.demo;import org.springframework.stereotype.Component;@Component("demo") // 注册为Bean，指定ID为"demo"
public class Demo {public void hellow(){System.out.println("xsy");}
}

2. 使用注解的实体类

package org.xsy.demo;import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;
import javax.annotation.Resource;@Component("xx") // 注册为Bean，指定ID为"xx"
public class User {@Value("李华")private String name;@Value("10")private int age;@Resource(name = "demo") // 注入名为"demo"的Beanprivate Demo demo;@Overridepublic String toString() {return "User{" +"name='" + name + '\'' +", age=" + age +", demo=" + demo +'}';}public void run(){System.out.println("Hello User");}
}

3. 测试类

package org.xsy;import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;
import org.xsy.demo.User;public class xsy {public static void main(String[] args) {// 创建Spring容器，加载配置文件ApplicationContext context = new ClassPathXmlApplicationContext("applicationContext.xml");// 获取User实例User user = (User) context.getBean("xx");System.out.println(user);}
}

五、注解 vs XML：如何选择？

特性	注解配置	XML配置
定义	在源码中定义	在外部XML文件中定义
耦合度	与代码耦合	与代码解耦
可读性	直观，一目了然	需要在文件间切换
修改是否需重新编译	是	否
适合场景	中小项目，需求稳定	大型项目，需求频繁变化