Spring Bean 配置

Spring Bean 配置零基础全面详解

一、什么是 Bean？为什么需要配置 Bean？

Bean 的定义

Spring 容器管理的对象称为 Bean，这些对象可以是 Service、DAO、工具类等。Bean 的创建、依赖注入、生命周期由 Spring 控制，开发者只需声明配置。

为什么要配置 Bean？

1. 解耦：通过容器管理对象依赖，避免硬编码。例如，通过配置注入依赖，而不是在代码中直接实例化对象。
2. 灵活性：通过配置切换实现类，例如在测试环境使用 Mock 实现，在生产环境使用真实实现。
3. 复用性：Bean 可被多个组件共享，避免重复创建。例如，多个 Service 可以共享同一个 DAO Bean。

二、Spring Bean 配置的核心方式

Spring 支持多种配置方式，适用于不同场景：

配置方式	适用场景	优点	缺点
XML 配置	传统项目、复杂依赖配置	集中管理、灵活性高	配置冗长
注解配置	现代项目、快速开发	简洁、代码与配置结合	分散在各处，不易管理
Java 配置类	完全代码控制、避免 XML	类型安全、IDE 友好	学习成本略高
自动装配	简单依赖注入	零配置、快速	复杂场景需额外注解

三、详细配置方式及示例

1. 通过 XML 配置 Bean

(1) 基础配置：定义 Bean

<!-- 定义 UserService 类为 Bean，id 为唯一标识 -->
<bean id="userService" class="com.example.UserService" />

• id：Bean 的唯一名称，通过 context.getBean("userService") 获取。
• class：Bean 的全限定类名，Spring 通过反射创建实例。

(2) 依赖注入：属性注入

通过 <property> 标签注入简单类型或引用类型：

<bean id="userRepository" class="com.example.UserRepositoryImpl" />

<bean id="userService" class="com.example.UserService">
    <!-- 注入引用类型 -->
    <property name="userRepository" ref="userRepository" />
    <!-- 注入简单类型（String、int 等） -->
    <property name="maxRetry" value="3" />
</bean>

• name：对应类的属性名（需有 setter 方法）。
• ref：引用其他 Bean 的 id。
• value：直接赋值基本类型或字符串。

(3) 构造器注入

强制依赖推荐使用构造器注入，避免空指针：

<bean id="userService" class="com.example.UserService">
    <!-- 通过构造器参数注入 -->
    <constructor-arg index="0" ref="userRepository" />
    <constructor-arg index="1" value="3" />
</bean>

• index：参数位置（从 0 开始）。
• type：指定参数类型（如 type="int"）。
• name：参数名称（需与构造器一致）。

(4) 内部 Bean

仅在当前 Bean 内部使用的对象：

<bean id="userService" class="com.example.UserService">
    <property name="repository">
        <!-- 内部 Bean，无法被其他 Bean 引用 -->
        <bean class="com.example.InMemoryUserRepository" />
    </property>
</bean>

2. 通过注解配置 Bean

(1) 启用注解扫描

在 XML 中配置扫描包路径：

<context:component-scan base-package="com.example" />

(2) 常用注解

注解	作用
@Component	通用 Bean，标记为 Spring 组件
@Service	业务层 Bean
@Repository	数据访问层 Bean（自动处理数据库异常）
@Autowired	自动按类型注入依赖
@Qualifier("id")	指定 Bean 名称注入（解决同类型多个 Bean 问题）

(3) 示例代码

@Service
public class UserService {
    // 自动注入 UserRepository 类型的 Bean
    @Autowired
    private UserRepository userRepository;

    // 若存在多个 UserRepository 实现，需指定名称
    @Autowired
    @Qualifier("mysqlUserRepository")
    private UserRepository specificRepository;
}

@Repository("mysqlUserRepository")
public class MysqlUserRepository implements UserRepository { /* ... */ }

@Repository("mockUserRepository")
public class MockUserRepository implements UserRepository { /* ... */ }

3. 通过 Java 配置类（@Configuration）

完全用 Java 代码替代 XML 配置，适合现代项目：

@Configuration
public class AppConfig {
    // 定义 Bean，方法名默认作为 Bean 的 id
    @Bean
    public UserRepository userRepository() {
        return new MysqlUserRepository();
    }

    // 注入其他 Bean 作为参数
    @Bean
    public UserService userService(UserRepository userRepository) {
        return new UserService(userRepository);
    }
}

• 优点：类型安全、IDE 自动提示、易于重构。
• 适用场景：需要动态生成 Bean 或复杂初始化逻辑时。

4. 高级配置技巧

(1) 使用 p 命名空间简化 XML

<!-- 声明 p 命名空间 -->
xmlns:p="http://www.springframework.org/schema/p"

<!-- 等价于 <property name="name" value="张三" /> -->
<bean id="user" class="com.example.User" 
      p:name="张三" 
      p:age="25" />

(2) 使用 util 命名空间定义集合

<!-- 声明 util 命名空间 -->
xmlns:util="http://www.springframework.org/schema/util"

<!-- 定义可复用的 List -->
<util:list id="commonList">
    <value>Item1</value>
    <value>Item2</value>
</util:list>

<!-- 注入到 Bean 中 -->
<bean id="listUser" class="com.example.ListUser">
    <property name="items" ref="commonList" />
</bean>

(3) 注入集合类型

<bean id="collectionBean" class="com.example.CollectionBean">
    <property name="list">
        <list>
            <value>字符串元素</value>
            <ref bean="userService" /> <!-- 引用其他 Bean -->
        </list>
    </property>
    <property name="map">
        <map>
            <entry key="service" value-ref="userService" />
        </map>
    </property>
</bean>

五、常见问题与调试技巧

• Bean 未找到错误：

  • 检查 <context:component-scan> 包路径是否正确。
  • 确认 Bean 的 id/名称是否拼写错误。

• 依赖注入失败：

  • 使用 @Autowired(required=false) 标记可选依赖。
  • 在 XML 中开启 <context:annotation-config/> 支持注解。

• 循环依赖问题：

  • 优先使用构造器注入，避免字段注入。
  • 重构代码，解耦相互依赖的 Bean。

六、总结：如何选择配置方式？

场景	推荐方式
传统项目、复杂配置	XML + 注解混合
现代应用、快速开发	注解 + Java 配置类
需要动态生成 Bean	Java 配置类
简单依赖、快速原型	自动装配（@Autowired）

通过灵活组合以上方式，可以高效管理 Spring Bean 的依赖关系与生命周期。对于零基础学习者，建议先从 XML 配置入手，理解 Bean 的基本概念，再逐步过渡到注解和 Java 配置类。