您的位置: 首页  >  文章  >  Spring注解的快速入门（02）

Spring注解的快速入门（02）

分类: 文章 • 2024-09-15 13:13:04

一、学习Spring就要知道Spring的核心（IOC、AOP、DI）这三大核心思想

 1.1      需要导入IOC容器需要的6个jar包+spring-aop.jar

例如：创建包结构并编写java类

UserService接口

publicinterface UserService {

  

   /**

    * 业务层：用户保存

    */

   publicvoid save();

  

}


  UserServiceImpl实现类

包名

 

import cn.itcast.service.UserService;


publicclass UserServiceImplimplements UserService{

 

   @Override

   publicvoid save() {

      System.out.println("业务层：用户保存");

   }

 

}

二、在java类上添加注解

 2.1 在UserServiceImpl实现类上添加注解@Component,相当于<bean id=””class=””>,value属性给bean指定id，value属性的名字也可以不写，直接写一个值

@Component("userService")

publicclass UserServiceImplimplements UserService{

 

   @Override

   publicvoid save() {

      System.out.println("业务层：用户保存");

   }

 

}


2.2   在applicationContext.xml中引入约束

   在src目录下，创建applicationContext.xml的配置文件，引入约束。注意：因为现在想使用注解，那么引入的约束发生了变化，需要context的约束。

【提示】：约束可以从spring开发文档中拷贝

  

<?xmlversion="1.0"encoding="UTF-8"?>

<beansxmlns="http://www.springframework.org/schema/beans"

    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

    xmlns:context="http://www.springframework.org/schema/context"

    xsi:schemaLocation="http://www.springframework.org/schema/beans

       http://www.springframework.org/schema/beans/spring-beans.xsd

       http://www.springframework.org/schema/context

       http://www.springframework.org/schema/context/spring-context.xsd">

     

</beans>

2.3 在applicationContext.xml中开启注解扫描

<?xmlversion="1.0"encoding="UTF-8"?>

<beansxmlns="http://www.springframework.org/schema/beans"

    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

    xmlns:context="http://www.springframework.org/schema/context"

    xsi:schemaLocation="http://www.springframework.org/schema/beans

       http://www.springframework.org/schema/beans/spring-beans.xsd

       http://www.springframework.org/schema/context

       http://www.springframework.org/schema/context/spring-context.xsd">

      <!-- 开启注解扫描。注意千万不能开启注解扫描不然程序会出现错误的 -->

      <context:component-scan base-package="cn.itcast.service"></context:component-scan>

</beans>

2.4 编写测试代码

/**

    * 测试注解

*/

@Test

publicvoid test1(){

      ApplicationContext applicationContext = new

ClassPathXmlApplicationContext("applicationContext.xml");

      UserService userService = (UserService) applicationContext.getBean("userService");

      userService.save();

}

三、Spring框架中bean管理的常用注解

3.1 用于创建对象的（重点）

  3.1.1 @Component注解

              作用：把资源让Spring来管理。相当于xml中配置一个bean（总体来说就是把资源交给Spring容器进行管理，可以降低耦合性）

              属性：value：指定bean的id 。如果不指定value属性，默认bean的id是当前类的类名首字母小写

 3.1.2 @Controller、@Service、@Repository

           解释：他们三个注解都是一个类的衍生注解，他们的作用以及属性都是一样的，只是提供了更加明确的语义化

          @Controller：一般用于表现层的注解

          @Service：一般用于业务层的注解

          @Repository：一般用于持久层的注解

//@Component("userService")     这一个注解在三个注解中都是通用的，只是使用下面的一个注解，只是提供了一个更加明确的语义化的注解的实现

@Service("userService")

publicclass UserServiceImplimplements UserService{

 

   @Override

   publicvoid save() {

      System.out.println("业务层：用户保存");

   }

 

}

 

@Repository("userDao")

publicclass UserDaoImplimplements UserDao {

 

   @Override

   publicvoid save() {

      System.out.println("持久层：用户保存");

   }

 

}

 

说明：这三个注解是为了让标注类本身的用途清晰

3.2  用来注入数据的

   相当于：<property name="" ref="">       

                  <property name="" value="">

3.2.1  @Value

           作用：注入基本数据类型和Spring类型的数据

          Value用于指定值

@Service("userService")

publicclass UserServiceImplimplements UserService{

  

   @Value("张三")

   private Stringname;

 

 

   @Override

   publicvoid save() {

      System.out.println("业务层：用户保存");

      System.out.println("用户名：" +name);

   }

 

}

3.2.2 @Autowired(重点)

      作用：自动按照类型进行注入。当使用注解注入属性的时候，set方法可以省略，他只能注入其他bean类型，当有多个类型匹配的时候，使用要注入对象的变量名作为bean的id，在Spring容器中进行查找，找到了也可以匹配成功。找不到就报错

@Service("userService")

publicclass UserServiceImplimplements UserService{

  

   @Value("张三")

   private String name;

  

   @Autowired

   private UserDao userDao;

 但是要特别注意：如果@Autowire注入的时候，有两个类型不能确定的时候，还是需要使用另一个注解来指明

 

   @Override

   publicvoid save() {

      System.out.println("业务层：用户保存");

      System.out.println("用户名：" +name);

      userDao.save();

   }

 

}

3.2.3 特别注意补充解释：

@Autowired(required = false)

当不能确定 Spring 容器中一定拥有某个类的 Bean 时，可以在需要自动注入该类 Bean 的地方可以使用 @Autowired(required = false) ，这等于告诉 Spring：在找不到匹配 Bean 时也不报错。

当然，一般情况下，使用 @Autowired 的地方都是需要注入 Bean 的，使用了自动注入而又允许不注入的情况一般仅会在开发期或测试期碰到（如为了快速启动 Spring 容器，仅引入一些模块的 Spring 配置文件），所以 @Autowired(required = false) 会很少用到。

@Qualifier

使用@Autowired注释进行byType注入，如果需要byName（byName就是通过id去标识）注入，增加@Qualifier注释。一般在候选Bean数目不为1时应该加@Qualifier注释。

在默认情况下使用 @Autowired 注释进行自动注入时，Spring 容器中匹配的候选 Bean 数目必须有且仅有一个。当找不到一个匹配的 Bean 时，Spring 容器将抛出

BeanCreationException 异常，并指出必须至少拥有一个匹配的 Bean。

和找不到一个类型匹配 Bean 相反的一个错误是：如果 Spring 容器中拥有多个候选 Bean，Spring 容器在启动时也会抛出 BeanCreationException 异常。

Spring 允许我们通过 @Qualifier 注释指定注入 Bean 的名称，这样歧义就消除了，可以通过下面的方法解决异常：


[java] view plain copy
  1. @Autowired  
  2. public void setOffice(@Qualifier("office")Office office)  
  3. {  
  4.     this.office =office;  
  5. }  

也可以直接注入到属性:

[java] view plain copy
  1. @Autowired   
  2. @Qualifier("office")   
  3. private Office office;  

@Qualifier(“office”)中的office是Bean的名称，所以@Autowired和@Qualifier结合使用时，自动注入的策略就从byType转变成byName了。

@Autowired可以对成员变量、方法以及构造函数进行注释，而@Qualifier的标注对象是成员变量、方法入参、构造函数入参。正是由于注释对象的不同，所以Spring不将 @Autowired和@Qualifier统一成一个注释类。

@Qualifier 只能和@Autowired 结合使用，是对@Autowired有益的补充。

一般来讲，@Qualifier对方法签名中入参进行注释会降低代码的可读性，而对成员变量注释则相对好一些。

@Resource

Spring不但支持自己定义的@Autowired注解，还支持几个由JSR-250规范定义的注解，它们分别是@Resource、@PostConstruct以及@PreDestroy。

@Resource的作用相当于@Autowired，只不过@Autowired按byType自动注入，而@Resource默认按 byName自动注入罢了。@Resource有两个属性是比较重要的，分是name和type，Spring将@Resource注解的name属性解析为bean的名字，而type属性则解析为bean的类型。所以如果使用name属性，则使用byName的自动注入策略，而使用type属性时则使用byType自动注入策略。如果既不指定name也不指定type属性，这时将通过反射机制使用byName自动注入策略。

@Resource装配顺序

1. 如果同时指定了name和type，则从Spring上下文中找到唯一匹配的bean进行装配，找不到则抛出异常

2. 如果指定了name，则从上下文中查找名称（id）匹配的bean进行装配，找不到则抛出异常

3. 如果指定了type，则从上下文中找到类型匹配的唯一bean进行装配，找不到或者找到多个，都会抛出异常

4. 如果既没有指定name，又没有指定type，则自动按照byName方式进行装配；如果没有匹配，则回退为一个原始类型进行匹配，如果匹配则自动装配；

@Component、@Repository、@Service、@Controller

Spring 2.5 中除了提供 @Component 注释外，还定义了几个拥有特殊语义的注释，它们分别是：@Repository、@Service 和 @Controller。

在目前的 Spring 版本中，这 3 个注释和 @Component 是等效的，但是从注释类的命名上，很容易看出这 3 个注释分别和持久层、业务层和控制层（Web 层）相对应。

虽然目前这3 个注释和 @Component 相比没有什么新意，但 Spring 将在以后的版本中为它们添加特殊的功能。

所以，如果 Web 应用程序采用了经典的三层分层结构的话，最好在持久层、业务层和控制层分别采用上述注解对分层中的类进行注释。

@Service用于标注业务层组件

@Controller用于标注控制层组件（如struts中的action）

@Repository用于标注数据访问组件，即DAO组件

@Component泛指组件，当组件不好归类的时候，我们可以使用这个注解进行标注。

[java] view plain copy
  1. @Service  
  2. public class VentorServiceImpl implements iVentorService {     
  3. }  
  4. @Repository  
  5. public class VentorDaoImpl implements iVentorDao {   
  6. }  

在一个稍大的项目中，如果组件采用xml的bean定义来配置，显然会增加配置文件的体积，查找以及维护起来也不太方便。

Spring2.5为我们引入了组件自动扫描机制，他在类路径下寻找标注了上述注解的类，并把这些类纳入进spring容器中管理。

它的作用和在xml文件中使用bean节点配置组件时一样的。要使用自动扫描机制，我们需要打开以下配置信息：

[xml] view plain copy
  1. <?xml version="1.0" encoding="UTF-8" ?>   
  2. <beans xmlns="http://www.springframework.org/schema/beans"  
  3.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
  4.     xmlns:context="http://www.springframework.org/schema/context"  
  5.     xsi:schemaLocation="http://www.springframework.org/schema/beans  
  6.   
  7. http://www.springframework.org/schema/beans/spring-beans-2.5.xsd  
  8.   
  9.   
  10. http://www.springframework.org/schema/context  
  11.   
  12.         http://www.springframework.org/schema/context/spring-context-2.5.xsd">   
  13.   
  14.     <context:annotation-config />  
  15.     <context:component-scan base-package=”com.iteedu.spring”>     
  16. </beans>  

annotation-config是对标记了@Required、@Autowired、@PostConstruct、@PreDestroy、@Resource、@WebServiceRef、@EJB、@PersistenceContext、@PersistenceUnit等注解的类进行对应的操作使注解生效。

base-package为需要扫描的包（含所有子包），负责扫描那些类有注解。

可以使用以下方式指定初始化方法和销毁方法：

[java] view plain copy
  1. @PostConstruct  
  2. public void init() {   
  3. }   
  4. @PreDestroy  
  5. public void destory() {   
  6. } 

3.2.4  @Qualifer

           作用：在自动按照类型注入的基础上，再按照bean的id进行注入。他在给字段注入时不能独立使用，必须和@Autowired配合一起使用，但是给方法注入参数的时候可以独立使用

          属性：value指定bean的id

创建UserDao接口的第二个实现类UserDaoImpl2

@Repository("userDao2")

publicclass UserDaoImpl2implements UserDao {

 

   @Override

   publicvoid save() {

      System.out.println("持久层2：保存用户");

   }

 

测试发现，UserServiceImpl中注入的还是第一个UserDaoImpl，想指定注入UserDaoImpl2，需要使用@Qualifier注解根据名字来注入

@Service("userService")

publicclass UserServiceImplimplements UserService{

  

   @Value("张三")

   private Stringname;

  

   @Autowired

   @Qualifier("userDao2")

   private UserDaouserDao;

 

 

   @Override

   publicvoid save() {

      System.out.println("业务层：用户保存");

      System.out.println("用户名：" +name);

      userDao.save();

   }

 

}

3.2.5 @Resource

          作用：直接bean的id进行注入，他也只能注入其他bean类型

          属性：name指定bean的id

例如：

@Service("userService")

publicclass UserServiceImplimplements UserService{

  

   @Value("张三")

   private Stringname;

  

// @Autowired

// @Qualifier("userDao2")

   @Resource(name="userDao2")

   private UserDaouserDao;

 

 

   @Override

   publicvoid save() {

      System.out.println("业务层：用户保存");

      System.out.println("用户名：" +name);

      userDao.save();

   }

 

}

3.2 用于改变作用域范围的

     3.2.1 @Scope

              作用：指定bean的作用范围

              属性：value：指定范围的值取值（singleton       prototype     ）

 @Scope指定bean的作用域，默认值是singleton，单例的。

@Service("userService")

@Scope("prototype")

publicclass UserServiceImplimplements UserService{

  

   @Value("张三")

   private Stringname;

  

// @Autowired

// @Qualifier("userDao2")

   @Resource(name="userDao2")

   private UserDaouserDao;

 

 

   @Override

   publicvoid save() {

      System.out.println("业务层：用户保存");

      System.out.println("用户名：" +name);

      userDao.save();

   }

 

}


 测试发现：当scope指定为prototype时，两次获取UserService的对象是不一致的

/**

    * 测试注解

    */

@Test

publicvoid test1(){

      ApplicationContext applicationContext =new ClassPathXmlApplicationContext("applicationContext.xml");

      UserService userService = (UserService)applicationContext.getBean("userService");

      userService.save();

      System.out.println(userService);

     

      UserService userService1 = (UserService)applicationContext.getBean("userService");

      System.out.println(userService1);

   }

Scope还可以取request,session,globalsession;

四、 和生命周期相关的（了解）

相当于：<beanid="" class=""init-method=""destroy-method="" />

4.1 @PostConstruct注解

@PostConstruct加在方法上，指定bean对象创建好之后，调用该方法初始化对象，类似于xml的init-method方法

@Service("userService")

@Scope("prototype")

publicclass UserServiceImplimplements UserService{

  

   @Value("张三")

   private Stringname;

  

// @Autowired

// @Qualifier("userDao2")

   @Resource(name="userDao2")

   private UserDaouserDao;

  

   @PostConstruct

   publicvoid init(){

      System.out.println("调用了init方法");

   }

 

 

   @Override

   publicvoid save() {

      System.out.println("业务层：用户保存");

      System.out.println("用户名：" +name);

      userDao.save();

   }

 

}

4. 2  @PreDestory注解

@PreDestory加在方法上，指定bean销毁之前，调用该方法，类似于xml的destory-method方法

@Service("userService")

@Scope("singleton")

publicclass UserServiceImplimplements UserService{

  

   @Value("张三")

   private Stringname;

  

// @Autowired

// @Qualifier("userDao2")

   @Resource(name="userDao2")

   private UserDaouserDao;

  

   @PostConstruct

   publicvoid init(){

      System.out.println("调用了init方法");

   }

  

   @PreDestroy

   publicvoid destory(){

      System.out.println("调用了destory方法");

   }

 

 

   @Override

   publicvoid save() {

      System.out.println("业务层：用户保存");

      System.out.println("用户名：" +name);

      userDao.save();

   }

 

}

注意：要看到@PreDestory的效果，需要调用ClassPathXmlApplicationContext.close方法，同时scope的值要是singleton

五、 XML和注解的比较

注解的优势：

    配置简单，维护方便。（我们找到了类，就相当于找到了配置）

XML的优势：

    修改时，不用改源码。不涉及重新编译和部署。


Xml和注解的比较

Spring注解的快速入门（02）

相关推荐