使用Java注解进行Spring bean管理

标签: java 注解 spring | 发表时间:2014-11-02 11:34 | 作者:darrenzhu
出处:http://www.iteye.com

原文链接: http://www.ibm.com/developerworks/cn/webservices/ws-springjava/

使用 Java 配置进行 Spring bean 管理

学习使用 Java 配置管理 Spring bean

Spring bean 是使用传统的 XML 方法配置的。在这篇文章中,您将学习使用基于纯 Java 的配置而非 XML 来编写 Spring bean 并配置它们。本文将介绍可用来配置 bean 的多种注释。此外还将演示基于 Java 的配置,将它与基于传统 XML 的方法进行比较。

概述

众所周知,Spring 框架是控制反转 (IOC) 或依赖性注入 (DI) 模式的推动因素,而这种推动是通过基于容器的配置实现的。过去,Spring 允许开发人员使用基于 XML 的配置,通过利用应用程序上下文 XML 文件来管理 bean 依赖性。此文件处于应用程序的外部,包含 bean 及其与该应用程序的依赖项的定义。尽管使用 XML 配置较为简单和便捷,但仍有另外一种方法可定义 bean 及其依赖项。这种方法也称为基于 Java 的配置。不同于 XML,基于 Java 的配置使您能够以编程方式管理 bean。这可通过运用多种注释来实现。 这篇文章将演示 Java 配置示例,并将其与传统 XML 配置方法相对比。本文将按照如下步骤演示基于 Java 的配置的基本用法:

  • 理解 @Configuration 和 @Bean 注释
  • 使用 AnnotationConfigApplicationContext 注册配置类
  • 配置 Web 应用程序
  • 实现 bean 生命周期回调和范围

我们将使用一所在线大学的 “创建课程” 用例。在创建课程的过程中,还会创建主题或者模块,而各主题可能又有着不同的作业。因此,我们要创建三个 bean,分别为 Course、Module 和 Assignment。 Course bean 将包含一个对  Module bean 的引用,后者包含对  Assignment bean 的引用。

理解 @Configuration 和 @Bean 注释

在理想的场景中,您可以在表示应用程序上下文的 XML 中定义 bean。以下代码展示了 创建课程 用例中的上下文 XML 及 bean 定义:

清单 1. XML 与 bean 定义
<beans>
	<bean id="course" class="demo.Course">
		<property name="module" ref="module"/>
  	</bean>
	
	<bean id="module" class="demo.Module">
		<property name="assignment" ref="assignment"/>
  	</bean>
	
	<bean id="assignment" class="demo.Assignment" />
</beans>

以上 XML 就是您在使用 Spring 配置 bean 时通常会编写的代码。这段 XML 代码定义了  Course bean,它引用  Module bean。 Module bean 有一个  Assignment bean 的引用。您现在要删除这段 XML,编写同等效果的 Java 代码。您将使用基于 Java 的配置定义上面指定的 bean。我们会将 XML 替换为 Java 类,这个 Java 类现在将用作 bean 配置的平台。我们将这个类命名为  AppContext.java。以下代码展示了  AppContext 类。

清单 2. 包含 bean 定义的 AppContext 配置类
@Configuration
public class AppContext {
	@Bean
	public Course course() {
		Course course = new Course();
		course.setModule(module());
		return course;
	}

	@Bean
	public Module module() {
		Module module = new Module();
		module.setAssignment(assignment());
		return module;
	}

	@Bean
	public Assignment assignment() {
		return new Assignment();
	}
}

正如您通过以上代码所看到的那样,现在可以以编程的方式将 bean 定义为基于 Java 的配置的一部分。 AppContext 类现在就像 XML 一样表示配置类。这是通过利用  @Configuration 注释实现的。 @Configuration 注释位于类的顶端。它告知 Spring 容器这个类是一个拥有 bean 定义和依赖项的配置类。 @Bean 注释用于定义 bean。上述注释位于实例化 bean 并设置依赖项的方法上方。方法名称与 bean id 或默认名称相同。该方法的返回类型是向 Spring 应用程序上下文注册的 bean。您可使用 bean 的 setter 方法来设置依赖项,容器将调用它们来连接相关项。基于 Java 的配置也被视为基于注释的配置。

使用 AnnotationConfigApplicationContext 注册配置类

在传统 XML 方法中,您可使用  ClassPathXmlApplicationContext 类来加载外部 XML 上下文文件。但在使用基于 Java 的配置时,有一个 AnnotationConfigApplicationContext 类。 AnnotationConfigApplicationContext 类是  ApplicationContext 接口的一个实现,使您能够注册所注释的配置类。此处的配置类是使用  @Configuration 注释声明的  AppContext。在注册了所述类之后, @Bean 注释的方法返回的所有 bean 类型也会得到注册。以下代码演示了  AnnotationConfigApplicationContext 类的使用:

清单 3. 使用 AnnotationConfigApplicationContext 注册 AppContext 类
public static void main(String[] args) {
  ApplicationContext ctx = new AnnotationConfigApplicationContext(AppContext.class);
  Course course = ctx.getBean(Course.class);
  course.getName();
}

正如以上代码所示, AppContext 配置类的注册方式是将其传递给  AnnotationConfigApplicationContext 构造函数。此外,您还可以使用所述上下文类的  register 方法来注册配置类。以下代码展示了另外一种方法。

清单 4. 注册 AppContext 类:另外一种方法
public static void main(String[] args) {
  ApplicationContext ctx = new AnnotationConfigApplicationContext();
  ctx.register(AppContext.class)
}

注册配置类将自动注册  @Bean 注释的方法名称,因而其对应的 bean 就是  CourseModule 和  Assignment。随后您可以使用  getBean 方法来获取相关的 bean,并调用其业务方法。如您所见,编写 Java 的配置类并将其注册到 Spring 上下文非常简单。下一节将讨论如何将基于 Java 的配置与 Web 应用程序配合使用。

配置 Web 应用程序

过去,您通常要利用  XmlWebApplicationContext 上下文来配置 Spring Web 应用程序,即在 Web 部署描述符文件 web.xml 中指定外部 XML 上下文文件的路径。 XMLWebApplicationContext 是 Web 应用程序使用的默认上下文类。以下代码描述了  web.xml 中指向将由 ContextLoaderListener 监听器类载入的外部 XML 上下文文件的元素。

清单 5. 使用外部 XML 上下文文件的 web.xml
<web-app>
	<context-param>
		<param-name>contextConfigLocation</param-name>
		<param-value>/WEB-INF/applicationContext.xml</param-value>
	</context-param>
	<listener>
		<listener-class>
			org.springframework.web.context.ContextLoaderListener
		</listener-class>
	</listener>
	<servlet>
	<servlet-name>sampleServlet</servlet-name>
	<servlet-class>
		org.springframework.web.servlet.DispatcherServlet
	</servlet-class>
	</servlet>

...
</web-app>

现在,您要将  web.xml 中的上述代码更改为使用  AnnotationConfigApplicationContext 类。切记, XmlWebApplicationContext是 Spring 为 Web 应用程序使用的默认上下文实现,因此您永远不必在您的  web.xml 文件中显式指定这个上下文类。现在,您将使用基于 Java 的配置,因此在配置 Web 应用程序时,需要在  web.xml 文件中指定  AnnotationConfigApplicationContext 类。上述代码将修改如下:

清单 6. 修改后的使用 AnnotationConfigApplicationContext 的 web.xml
<web-app>
	<context-param>
		<param-name>contextClass</param-name>
		<param-value>
			org.springframework.web.context.
			support.AnnotationConfigWebApplicationContext
		</param-value>
	</context-param>
	<context-param>
		<param-name>contextConfigLocation</param-name>
		<param-value>
			demo.AppContext
		</param-value>
	</context-param>
	<listener>
		<listener-class>
			org.springframework.web.context.ContextLoaderListener
		</listener-class>
	</listener>
	<servlet>
	<servlet-name>sampleServlet</servlet-name>
	<servlet-class>
		org.springframework.web.servlet.DispatcherServlet
	</servlet-class>
	<init-param>
		<param-name>contextClass</param-name>
		<param-value>
			org.springframework.web.context.
			support.AnnotationConfigWebApplicationContext
		</param-value>
	</init-param>
	</servlet>

...
</web-app>

以上修改后的  web.xml 现在定义了  AnnotationConfigWebApplicationContext 上下文类,并将其作为上下文参数和 servlet 元素的一部分。上下文配置位置现在指向  AppContext 配置类。这非常简单。下一节将演示 bean 的生命周期回调和范围的实现。

实现 bean 生命周期回调和范围

生命周期回调

您还可以使用基于 Java 的配置来管理 bean 的生命周期。 @Bean 支持两种属性,即  initMethod 和  destroyMethod,这些属性可用于定义生命周期方法。在实例化 bean 或即将销毁它时,容器便可调用生命周期方法。生命周期方法也称为回调方法,因为它将由容器调用。使用  @Bean 注释注册的 bean 也支持 JSR-250 规定的标准  @PostConstruct 和  @PreDestroy 注释。如果您正在使用 XML 方法来定义 bean,那么就应该使用 bean 元素来定义生命周期回调方法。以下代码显示了在 XML 配置中通常使用 bean 元素定义回调的方法。

清单 7. 使用 XML 方法实现生命周期回调
<bean id="course" class="demo.Course" init-method="setup" destroy-method="cleanup" >
	<property name="module" ref="module"/>
</bean>

以下代码演示了使用 Java 配置的生命周期方法

清单 8. 使用 AppContext 配置类实现 bean 生命周期方法
@Configuration
public class AppContext {
	@Bean(initMethod = "setup", destroyMethod = "cleanup")
	public Course course() {
		Course course = new Course();
		course.setModule(module());
		return course;
	}

	@Bean(initMethod = "setup", destroyMethod = "cleanup")
	public Module module() {
		Module module = new Module();
		module.setAssignment(assignment());
		return module;
	}
	
	...
}		
public class Course {

	private Module module;
	private String name;
	
	public Course() {
	}
	
	public void setup() {
		this.name = "M100 Pythagoras Theorems"
	}
	
	public void setModule(Module module) {
		this.module = module;
	}
	
	public void cleanup() {
		module = null;
	}
}

上面的代码重新访问了  AppContext 配置类。 @Bean 注释现在有两个额外的属性,即  initMethod 和  destroyMethod。它们定义了生命周期方法的设置和清除。这些方法是在已经注册的 bean 中实现的,最终由容器在 bean 初始化及其销毁之前调用它。这里以  Course bean 为例,提供了生命周期方法实现。所实现的方法是  setup 和  cleanup。同样,您还可以在  Module 和  Assignment bean 中实现这些方法。

Bean 范围

bean 的方法是使用  @Scope 注释定义的。XML 中实现这一目标的方法是指定 bean 元素中的 scope 属性。

清单 9. 使用 XML 方法定义 bean 范围
<bean id="course" class="demo.Course" scope="prototype" >
	<property name="module" ref="module"/>
</bean>

以下代码展示了使用 Java 配置的 bean 范围定义:

清单 10. 使用 AppContext 配置类定义 bean 范围
@Configuration
public class AppContext {
	@Bean(initMethod = "setup", destroyMethod = "cleanup")
	@Scope("prototype")
	public Course course() {
		Course course = new Course();
		course.setModule(module());
		return course;
	}
	...
}

正如您在上面的代码中所看到的那样,在 Java 配置类中定义 bean 的范围非常简单。上面的  AppContext 配置类使用  @Scope 注释为  Coursebean 定义了一个  prototype 范围。默认范围是  singleton

利用 Java 配置可以做许多事情。本文只触及了一些基础内容。使用 Java 配置并无显著优势,它仅仅是 Spring 提供的 XML 配置的替代方法。对于不喜欢在框架中使用 XML 的人来说,这是实现配置的一种出色方法。但缺点也是显而易见的,如果您对 Java 类中的配置做出了任何更改,就必须重新编译应用程序。



已有 0 人发表留言,猛击->> 这里<<-参与讨论


ITeye推荐



相关 [java 注解 spring] 推荐:

使用Java注解进行Spring bean管理

- - 编程语言 - ITeye博客
原文链接: http://www.ibm.com/developerworks/cn/webservices/ws-springjava/. 使用 Java 配置进行 Spring bean 管理. 学习使用 Java 配置管理 Spring bean. Spring bean 是使用传统的 XML 方法配置的.

Java Spring注解任务调度并实现AOP监控任务执行情况

- - 极客521 | 极客521
本文讲的是通过Spring注解的方式实现任务调度. 只要引入了spring-context包就能够在项目中使用注解方式的任务调度. 需要在Spring配置文件中加入task的schema. 然后在代码中就可以直接用了,要定时执行的方法必须是void的,并且没有任何参数的. cron表达式请自行问百度,下面只列出几个从网上找的例子.

Spring 4.1与Java 8 java.util.Optional

- - ImportNew
在Spring 4.1中,利用Java 8的 java.util.Optional,通过 @RequestParam、 @RequestHeader和 @MatrixVariable三个注解,支持了仅包含非空(non-null)的容器对象. 有了Java 8的 java.util.Optional,你可以保证你的参数永远不会为 null.

Spring Boot 中使用 Java API 调用 lucene

- - SegmentFault 最新的文章
Lucene是apache软件基金会4 jakarta项目组的一个子项目,是一个开放源代码的全文检索引擎工具包,但它不是一个完整的全文检索引擎,而是一个全文检索引擎的架构,提供了完整的查询引擎和索引引擎,部分文本分析引擎(英文与德文两种西方语言). Lucene的目的是为软件开发人员提供一个简单易用的工具包,以方便的在目标系统中实现全文检索的功能,或者是以此为基础建立起完整的全文检索引擎.

spring MVC 使用注解返回json

- - ITeye博客
使用spring MVC框架时,如何使用注解返回json呢?.  注意:使用如下方式也可以把内容添加到json中. 已有 0 人发表留言,猛击->> 这里<<-参与讨论. —软件人才免语言低担保 赴美带薪读研.

(转)Spring中@Autowired注解、@Resource注解的区别

- - jackyrong
Spring不但支持自己定义的@Autowired注解,还支持几个由JSR-250规范定义的注解,它们分别是@Resource、@PostConstruct以及@PreDestroy.   @Resource的作用相当于@Autowired,只不过@Autowired按byType自动注入,而@Resource默认按 byName自动注入罢了.

spring mvc +spring aop结合注解的 用户操作日志记录

- - 行业应用 - ITeye博客
参考了网上的一些 文章 但是他们写的不是很全  自己也是经过了一些摸索  可以实现 记录 spring mvc controller层操作记录. 一个关注点的模块化,这个关注点可能会横切多个对象. 事务管理是J2EE应用中一个关于横切关注点的很好的例子. AOP中,切面可以使用通用类(基于模式的风格) 或者在普通类中以 @Aspect 注解(@AspectJ风格)来实现.

Java中如何获取Spring中配置的bean

- - CSDN博客推荐文章
Spring是一个轻量级的控制反转(IoC)和面向切面(AOP)的容器框架. 二、如何在程序中获取Spring配置的bean呢. 方法一:在初始化时保存ApplicationContext对象. 说明:这种方式适用于采用Spring框架的独立应用程序,需要程序通过配置文件手工初始化Spring的情况.

[Java][web]利用Spring随时随地获得Request和Session

- - CSDN博客推荐文章
利用Spring随时随地获得Request和Session. 在web.xml中添加  . 1、方法一:通过代码实现. 2、方法二:通过注解实现:. 三、关于RequestContextListener的背景知识:. 基于LocalThread将HTTP request对象绑定到为该请求提供服务的线程上.

使用SPRING中的线程池ThreadPoolTaskExecutor实现JAVA并发

- - Java - 编程语言 - ITeye博客
//线程池所使用的缓冲队列 . //线程池维护线程的最少数量 . //线程池维护线程的最大数量 . //线程池维护线程所允许的空闲时间 .  .      .      .      .