Spring框架学习记录 5 注解开发

使用注解配置 bean ：

注解	说明
@component	使用在类上用于实例化 bean
@Controller	使用在 Web 层类上用于实例化 bean
@Service	使用在 Service 层类上用于实例化 bean
@Repository	使用在 Dao 层类上用于实例化 bean
@Autowired	使用在字段上，根据 bean的类型进行依赖注入
@Qualifier	结合 @Autowired 一起使用，根据 bean 的 id 进行依赖注入
@Resource	相当于 @Autowired + @Qualifier ，根据 bean 的 id 进行依赖注入
@Value	注入普通属性
@Scope	标注 bean 的作用范围
@PostConstruct	使用在方法上，标注该方法是 bean 的初始化方法
@PreDestroy	使用在方法上，标注该方法是 bean 的销毁方法

示例

（1）在 UserDaoImple 和 UserServiceImple 类中增加相应注解

UserDaoImple：

package Dao.Implement;

import Dao.UserDao;
import org.springframework.stereotype.Component;

@Component("userDao")
public class UserDaoImple implements UserDao {

	@Override
	public void say() {
		System.out.println("喵~");
	}

}

UserServiceImple：

package Service.Implement;

import Dao.UserDao;
import Service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Qualifier;
import org.springframework.stereotype.Component;

@Component("userService")
public class UserServiceImple implements UserService {

	@Autowired
	@Qualifier("userDao")
	private UserDao userDao;

	@Override
	public void say() {
		userDao.say();
	}

}

@component("userDao") 用于实例化 bean，代替了 <bean> 标签的作用，相当于：

<bean id="userDao" class="Dao.Implement.UserDaoImple"/>

@Autowired 用于根据类型依赖注入，若不与 @Qualifier 配合使用，则默认在 Spring 容器中匹配类型相同的 bean ，若 Spring 容器中对于该类型的 bean 有多个，则默认匹配属性名与 bean 的 id 相同的 bean ，否则抛出 NoUniqueBeanDefinitionException 异常，此时则需要与 @qualifier 配合使用，指定相应 id 的 bean 进行注入

（2）在 xml 配置文件中配置组件扫描

<context:component-scan base-package="Dao Service"/>

使用 <context:component-scan> 标签配置组件扫描，该标签在命名空间 context 下

base-package 指定一个需要扫描的基类包，Spring 容器将会扫描这个基类包及其子包中的所有类

若需扫描多个包，只需用空格分开即可

（3）在 UserController 类中进行测试

import Service.UserService;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;

public class UserController {
	public static void main(String[] args) {
		ApplicationContext app = new ClassPathXmlApplicationContext("applicationContext.xml");
		UserService userService = app.getBean(UserService.class);
		userService.say();
	}
}

注解与 xml 优先级问题

当同时使用 xml 配置文件和注解进行 bean 的配置时，若 bean 的 id 相同，默认 xml 优先级高于注解

测试示例如下：

（1）创建 UserDaoImple2 类

package Dao.Implement;

import Dao.UserDao;

public class UserDaoImple2 implements UserDao {

	@Override
	public void say() {
		System.out.println("汪~");
	}

}

（2）在 xml 配置文件中配置 UserDaoImple2 的 bean

<bean id="userDao" class="Dao.Implement.UserDaoImple2"/>

（3）修改组件扫描与 <bean> 标签的相对位置进行测试

<context:component-scan base-package="Dao Service"/>
<bean id="userDao" class="Dao.Implement.UserDaoImple2"/>

<bean id="userDao" class="Dao.Implement.UserDaoImple2"/>
<context:component-scan base-package="Dao Service"/>

对于 UserDaoImple 和 UserDaoImple2 ，它们的 bean 的 id 相同，但无论哪一种顺序，最终留在容器中的都是 UserDaoImple2 ，也就是使用 xml 配置文件进行配置的 bean ，故 xml 优先级高于注解

其余注解介绍

对于 @Controller 、@Service 、@Repository ，与 @component 功能一致，但具有更强的可读性

对于 @Resource ，相当于 @Autowired + @Qualifier，其后可以用 name 指定具体 bean 的 id ，如 @Resource(name = "userDao") ，不写 name 时，与 @Autowired 类似，按照类型匹配，若存在多个类型相同 id 不同的 bean 时，则按照属性名与 id 匹配

对于 @Value ，可以注入普通数据，还可以根据 EL 表达式注入 properties 数据，如下所示：

package Dao.Implement;

import Dao.UserDao;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Repository;

@Repository("userDao")
public class UserDaoImple implements UserDao {

	@Value("${jdbc.username}")
	private String userName;

	@Override
	public void say() {
		System.out.println(userName);
		System.out.println("喵~");
	}

}

对于 @Scope，可以使用 @Scope("singleton") 和 @Scope("prototype") 标注 bean 的作用范围为单例或多例，与在 <bean> 标签中配置效果一致，不再赘述

对于 @PostConstruct 和 @PreDestroy 与 <bean> 标签中的 init-method 和 destroy-method 属性功能一致，不再赘述

---

Spring 新注解

上文中的注解只能代替自定义 bean 的 xml 配置，对于 xml 的其它功能，还需要其它的注解进行配置，最终实现注解完全替代 xml 配置文件

注解	说明
@Configuration	用于指定当前类是一个 Spring 配置类，当创建容器时会从该类上加载注解
@ComponentScan	用于指定 Spring 在初始化容器时要扫描的包
@Bean	使用在方法上，将该方法的返回值存储到 Spring 容器中
@PropertySource	用于加载 properties 文件
@Import	用于导入其他配置类

（1）创建 SpringConfiguration 配置类

package Config;

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


@Configuration
@ComponentScan({"Dao", "Service"})
@Import(DataSourceConfiguration.class)
public class SpringConfiguration {

}

@Configuration 指定当前类为 Spring 配置类

@ComponentScan({"Dao", "Service"}) 代替 <context:component-scan> ，指定初始化 Spring 容器时扫描的包

@Import(DataSourceConfiguration.class) 代替 <import> ，在配置类较大时，可以分为多个，并在主配置类中通过该注解导入其它配置类

（2）创建 DataSourceConfiguration 配置类

package Config;

import com.mchange.v2.c3p0.ComboPooledDataSource;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.PropertySource;

import javax.sql.DataSource;
import java.beans.PropertyVetoException;

@PropertySource("classpath:jdbc.properties")
public class DataSourceConfiguration {

	@Value("${jdbc.driver}")
	private String driver;

	@Value("${jdbc.url}")
	private String url;

	@Value("${jdbc.username}")
	private String username;

	@Value("${jdbc.password}")
	private String password;

	@Bean("dataSource")
	public DataSource getDataSource() throws PropertyVetoException {
		ComboPooledDataSource dataSource = new ComboPooledDataSource();
		dataSource.setDriverClass(driver);
		dataSource.setJdbcUrl(url);
		dataSource.setUser(username);
		dataSource.setPassword(password);
		return dataSource;
	}

}

@PropertySource("classpath:jdbc.properties") 代替 <context:property-placeholder> ，加载 properties 文件

对于非自定义的 bean 的配置，如这里的数据源对象，创建一个 getDataSource 方法，在方法中返回所需的对象，并将 @Bean 加在方法上即可，@Bean("dataSource") 表示这个 bean 的 id 为 dataSource，若不指定 id 则默认为方法名