Java——Spring中Bean配置核心规则：id、name、ref的用法与区别

Spring中Bean配置核心规则：id、name、ref的用法与区别

在Spring框架的XML配置中，<bean>标签及其子标签<property>的配置是核心基础。初学者常对id、name、ref等属性的用法产生困惑，本文将系统讲解这些属性的作用、修改规则及配置原则，帮助开发者快速掌握Spring Bean的配置逻辑。

一、<bean id="xxx">：Bean的唯一标识

1. 作用

id是Spring容器中Bean的唯一标识符，用于在容器中定位和引用该Bean。例如：

<!-- id为dataSource的数据源Bean -->
<bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource"/>

2. 能否修改？

可以修改，但需遵循两个规则：

• 唯一性：在整个Spring容器中，id的值不能重复（包括与name属性的值重复）。
• 命名规范：符合XML标识符规则，不能以数字开头，避免包含空格、&、#等特殊字符。

3. 命名建议

虽然id可自定义，但建议根据Bean的功能命名，提高可读性：

<!-- 数据源Bean -->
<bean id="druidDataSource" class="com.alibaba.druid.pool.DruidDataSource"/>

<!-- MyBatis的SqlSessionFactoryBean -->
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"/>

二、<property name="yyy">：属性注入的"钥匙"

1. 作用

name属性用于指定Bean中需要注入的属性名，Spring通过该属性匹配对应的setter方法完成注入。例如：

<bean id="userService" class="com.example.UserService">
    <!-- 注入userDao属性 -->
    <property name="userDao" ref="userDao"/>
</bean>

上述配置会触发UserService类的setUserDao(UserDao userDao)方法，完成属性注入。

2. 能否修改？

不能随意修改，name的值必须与目标类中的属性名完全一致（严格区分大小写）。

核心原因：

Spring的属性注入基于setter方法命名规范：name="xxx"对应目标类中的setXxx()方法。例如：

• name="dataSource" → 对应setDataSource(DataSource dataSource)
• name="username" → 对应setUsername(String username)

若修改name的值（如将name="dataSource"改为name="dbSource"），而目标类中没有setDbSource()方法，Spring会抛出NoSuchMethodException异常。

3. 特殊场景：允许修改的情况

只有当目标类的属性名发生变更时，name才能同步修改。例如：

// 目标类属性名改为dbSource
public class UserService {
    private UserDao dbSource; // 属性名是dbSource
    // setter方法同步修改
    public void setDbSource(UserDao dbSource) {
        this.dbSource = dbSource;
    }
}

此时配置需改为：

<bean id="userService" class="com.example.UserService">
    <property name="dbSource" ref="userDao"/> <!-- 与属性名一致 -->
</bean>

三、<property ref="xxx">：依赖引用的"指针"

1. 作用

ref属性用于指定当前Bean依赖的其他Bean的id，实现Bean之间的关联。例如：

<!-- 数据源Bean -->
<bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource"/>

<!-- 依赖数据源的SqlSessionFactoryBean -->
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
    <!-- 引用id为dataSource的Bean -->
    <property name="dataSource" ref="dataSource"/>
</bean>

2. 能否修改？

可以修改，但必须与被引用Bean的id（或name）保持一致。

示例：

若数据源Bean的id改为druidDataSource，则ref需同步修改：

<!-- 数据源Bean的id改为druidDataSource -->
<bean id="druidDataSource" class="com.alibaba.druid.pool.DruidDataSource"/>

<!-- ref需匹配新的id -->
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
    <property name="dataSource" ref="druidDataSource"/> <!-- 与数据源id一致 -->
</bean>

四、核心规则对照表

五、常见错误案例分析

错误1：id重复

<!-- 错误：两个Bean的id相同 -->
<bean id="userDao" class="com.example.UserDao"/>
<bean id="userDao" class="com.example.UserDaoImpl"/>

后果：Spring启动时抛出BeanDefinitionStoreException，提示id重复。

错误2：name与属性名不匹配

<!-- 错误：name="userDao"与目标类的属性名userDAO不匹配（大小写错误） -->
<bean id="userService" class="com.example.UserService">
    <property name="userDao" ref="userDao"/>
</bean>

<!-- 目标类 -->
public class UserService {
    private UserDao userDAO; // 属性名是userDAO（大写DAO）
    public void setUserDAO(UserDao userDAO) { // setter方法是setUserDAO
        this.userDAO = userDAO;
    }
}

后果：Spring找不到setUserDao()方法，抛出NoSuchMethodException。

错误3：ref与id不匹配

<!-- 数据源id是druidDataSource -->
<bean id="druidDataSource" class="com.alibaba.druid.pool.DruidDataSource"/>

<!-- 错误：ref引用了不存在的dataSource -->
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
    <property name="dataSource" ref="dataSource"/> <!-- ref与id不一致 -->
</bean>

后果：Spring找不到id为dataSource的Bean，抛出NoSuchBeanDefinitionException。

通过掌握以上规则，能有效避免Spring配置中的常见错误，理解Bean之间的依赖关系和注入逻辑，为后续学习Spring整合其他框架（如MyBatis、Spring MVC）打下基础。