【Spring基础系列3】Spring常用的注解

简介: 前两篇文章分别讲解了Sping IOC的基础知识,以及Spring通过注解装配Bean的常用方式,包括@Component、@Repository、@Service、@Controller、@Autowired、@Resource和@Qualifier,这篇文章主要对剩余高频的注解进行讲解。

IINO0UE_8BJH8SXU9}JBS%F.jpg

主要讲解Spring中常用的注解和使用姿势。


前言


前两篇文章分别讲解了Sping IOC的基础知识,以及Spring通过注解装配Bean的常用方式,包括@Component、@Repository、@Service、@Controller、@Autowired、@Resource和@Qualifier,这篇文章主要对剩余高频的注解进行讲解。


@ComponentScan


之前我们都是在applicationContext.xml中指定扫描路径,这样Spring才能将该包下面的注解扫描出来:

<!--使用context命名空间,通知spring扫描指定目录,进行注解的解析-->
<context:component-scan base-package="com.java.annotation"/>


然后使用的时候需要引入配置文件:

ApplicationContext context =new ClassPathXmlApplicationContext("classpath:applicationContext.xml");
Pets pets=context.getBean("pets", Pets.class);
System.out.println(pets.toString());


通过xml配置的方式告诉扫描路径,简直太Low了,我们可以通过@ComponentScan指定扫描路径,然后通过Spring IoC容器的实现类AnnotationConfigApplicationContext去生成容器,使用姿势如下:

@Data
@Service
@ComponentScan({"com.java.annotation.spring.bean.test5"})
public class Pets {
    @Resource
    private Dog dog;
    @Resource
    private Cat cat;
    public static void main(String args[]) {
        ApplicationContext context = new AnnotationConfigApplicationContext(Pets.class);
        Pets pets = context.getBean(Pets.class);
        System.out.println(pets.toString());
    }
}


那么Spring就会将com.java.annotation.spring.bean.test5包下面的Bean注册到Spring中,包括Dog、Cat和Pets,我之前的示例一直需要在配置文件中加入Pets的配置,现在连下面这一行代码都省掉了,是不是很酷:

// 直接省略掉
<bean id="pets" class="com.java.annotation.spring.bean.test5.Pets"/>


如果@ComponentScan未指定路径,那么默认只扫描当前的包,所以需要实体和配置所在的包必须一致,不过我们一般不这么用,因为一般用该注解都需要指定路径。当然你也可以指定具体需要扫描的类,不过这些都不常用,知道有这个就行:

@ComponentScan(basePackageClasses = {Dog.class, Cat.class, Pets.class})

未使用@ComponentScan注解的代码示例,可以参考文章《【Spring基础系列1】基于注解装配Bean》


@Configuration


指示一个类声明一个或者多个@Bean声明的方法并且由Spring容器统一管理,以便在运行时为这些bean生成bean的定义和服务请求的类。我们先定义一个MyBean类:

public class MyBean {
    public MyBean(){
        System.out.println("generate MyBean Instance");
    }
    public void init(){
        System.out.println("MyBean Resources Initialized");
    }
}


然后再通过@Configuration,定义一个MyConfiguration环境配置类:

@Configuration
@ToString
public class MyConfiguration {
    private String name = "配置测试";
    @Bean
    public MyBean myBean(){
        System.out.println("myBean Initialized");
        return new MyBean();
    }
}

MyConfiguration是一个配置类,能够在此类下面声明管理多个Bean,我们声明了一个MyBean的bean,希望它被容器加载和管理。


我们来看一下测试用例:

public static void main(String[] args) {
    ApplicationContext context1 = new AnnotationConfigApplicationContext(MyConfiguration.class);
    MyConfiguration myConfiguration = context1.getBean(MyConfiguration.class);
    System.out.println(myConfiguration.toString());
}
// 输出:
// myBean Initialized
// generate MyBean Instance
// MyConfiguration(name=配置测试)

从输出的结果可以看到,默认名称为myBean 的bean随着容器的加载而加载,因为myBean方法返回一个myBean的构造方法,所以myBean被初始化了,然后MyConfiguration也作为一个Bean注入到Spring框架中。

通过这种方式,我们就省略了在XML中配置MyBean,同时也省略了配置MyConfiguration和MyBean的依赖关系,具体的XML配置,我就不贴了,如果大家看了我之前的两篇文章,应该很容易写出来。


@Bean


Bean注解主要用于方法上,有点类似于工厂方法,当使用了@Bean注解,我们可以连续使用多种定义bean时用到的注解,譬如用@Qualifier注解定义工厂方法的名称,用@Scope注解定义该bean的作用域范围,譬如是singleton还是prototype等。

Spring 中新的 Java 配置支持的核心就是@Configuration 注解的类。这些类主要包括 @Bean 注解的方法来为 Spring 的 IoC 容器管理的对象定义实例,配置和初始化逻辑,除了和@Configuration配合使用,@Bean自身也有一些特有的用法,我再简单扩展一下。


接受生命周期回调

我们可以指定Bean的生命周期,比如我们基于上述代码,进行简单修改:

@Configuration
@ToString
public class MyConfiguration {
    private String name = "配置测试";
    @Bean(initMethod = "init") // 新增init
    public MyBean myBean(){
        System.out.println("myBean Initialized");
        return new MyBean();
    }
}

用同样的测试用例测试,输出:

myBean Initialized
generate MyBean Instance
MyBean Resources Initialized // 新增输出
MyConfiguration(name=配置测试)

对于上面的例子,也可以手动调用init()方法,与上面的方式等效:

public MyBean myBean(){
    System.out.println("myBean Initialized");
    MyBean myBean = new MyBean();
    myBean.init();
    return myBean;
}


Bean的作用域

默认情况下,Spring应用上下文中所有bean都是作为以单例(singleton)的形式创建的。也就是不管给定的一个bean被注入到其他bean多少次,每次所注入的都是同一个实例。

大多数情况下,单例bean是很理想的方案。初始化和垃圾回收对象实例所带来的成本只留给一些小规模任务,在这些任务中,让对象保持无状态并且在应用中反复重用这些对象可能并不合理。

有时候,所使用的类是易变的(mutable),它们会保持一些状态,因此重用是不安全的。在这种情况下,不应该将class声明为单例的bean,因为对象会被污染,重用的时候会出现意想不到的问题。

@Configuration
@ToString
public class MyConfiguration {
    private String name = "配置测试";
    @Bean(initMethod = "init")
    @Scope("prototype") // 新增作用范围
    public MyBean myBean(){
        System.out.println("myBean Initialized");
        return new MyBean();
    }
}

Spring定义了多种作用域:

  • 单例(Singleton):在整个应用中,只创建bean的一个实例。
  • 原型(Prototype):每次注入或者通过Spring应用上下文获取的时候,都会创建一个新的bean实例。
  • 会话(Session):在Web应用中,为每个会话创建一个bean实例。
  • 请求(Rquest):在Web应用中,为每个请求创建一个bean实例。

通过XML定义的Bean,都可以指定他们的作用域,等同:

<bean id="louzai" class="xxx" scope="prototype" />


Bean其它用法

Bean可以指定名称:

@Bean(name="louzai")
public MyBean myBean(){
    System.out.println("myBean Initialized");
    return new MyBean();
}

或者指定别名:

@Bean({"dataSource", "dataSourceA", "dataSourceB"})
public MyBean myBean(){
    System.out.println("myBean Initialized");
    return new MyBean();
}

或者指定描述:

@Bean(name="louzai")
    @Description("此方法的bean名称为louzai")
    public MyBean myBean(){
        System.out.println("myBean Initialized");
        return new MyBean();
    }

@Bean主要和@Configuration配合使用,去获取配置文件中的配置数据,这个等看到这一块,我再完善这部分内容,目前只给出基本用法。


@Transactional


由于这个注解需要讲述的内容比较多,一方面该注解非常重要,另一方面非常容易入坑,所以这个注解的内容,就单独放到下一篇文章来讲。


总结


关于Java Spring的内容,基础知识可以参考这篇万字长文《【Spring基础系列2】很全的Spring IOC基础知识》,MVC相关的注解可以参考《【Spring基础系列1】基于注解装配Bean》,还有一部分注解内容,虽然不是Spring家族,但是用的也非常多,可以参考《【Java基础系列1】Lombok常用注解》,然后加上这篇文章讲解的注解,Spring中高频的注解基本就能掌握,如果后面遇到其它的注解,我也会继续连载这个系列。

下一篇文章主要讲述@Transactional和容易遇到的坑,之后就开始学习AOP相关的内容,希望本周能完成Spring基础知识的学习。

相关文章
|
1月前
|
XML Java 数据格式
SpringBoot入门(8) - 开发中还有哪些常用注解
SpringBoot入门(8) - 开发中还有哪些常用注解
50 0
|
2月前
|
Java Spring
在使用Spring的`@Value`注解注入属性值时,有一些特殊字符需要注意
【10月更文挑战第9天】在使用Spring的`@Value`注解注入属性值时,需注意一些特殊字符的正确处理方法,包括空格、引号、反斜杠、新行、制表符、逗号、大括号、$、百分号及其他特殊字符。通过适当包裹或转义,确保这些字符能被正确解析和注入。
124 3
|
20天前
|
前端开发 Java Spring
Spring MVC核心:深入理解@RequestMapping注解
在Spring MVC框架中,`@RequestMapping`注解是实现请求映射的核心,它将HTTP请求映射到控制器的处理方法上。本文将深入探讨`@RequestMapping`注解的各个方面,包括其注解的使用方法、如何与Spring MVC的其他组件协同工作,以及在实际开发中的应用案例。
36 4
|
1月前
|
XML JSON Java
SpringBoot必须掌握的常用注解!
SpringBoot必须掌握的常用注解!
60 4
SpringBoot必须掌握的常用注解!
|
20天前
|
前端开发 Java 开发者
Spring MVC中的请求映射:@RequestMapping注解深度解析
在Spring MVC框架中,`@RequestMapping`注解是实现请求映射的关键,它将HTTP请求映射到相应的处理器方法上。本文将深入探讨`@RequestMapping`注解的工作原理、使用方法以及最佳实践,为开发者提供一份详尽的技术干货。
59 2
|
20天前
|
前端开发 Java Spring
探索Spring MVC:@Controller注解的全面解析
在Spring MVC框架中,`@Controller`注解是构建Web应用程序的基石之一。它不仅简化了控制器的定义,还提供了一种优雅的方式来处理HTTP请求。本文将全面解析`@Controller`注解,包括其定义、用法、以及在Spring MVC中的作用。
40 2
|
23天前
|
消息中间件 Java 数据库
解密Spring Boot:深入理解条件装配与条件注解
Spring Boot中的条件装配与条件注解提供了强大的工具,使得应用程序可以根据不同的条件动态装配Bean,从而实现灵活的配置和管理。通过合理使用这些条件注解,开发者可以根据实际需求动态调整应用的行为,提升代码的可维护性和可扩展性。希望本文能够帮助你深入理解Spring Boot中的条件装配与条件注解,在实际开发中更好地应用这些功能。
28 2
|
24天前
|
JSON Java 数据格式
springboot常用注解
@RestController :修饰类,该控制器会返回Json数据 @RequestMapping(“/path”) :修饰类,该控制器的请求路径 @Autowired : 修饰属性,按照类型进行依赖注入 @PathVariable : 修饰参数,将路径值映射到参数上 @ResponseBody :修饰方法,该方法会返回Json数据 @RequestBody(需要使用Post提交方式) :修饰参数,将Json数据封装到对应参数中 @Controller@Service@Compont: 将类注册到ioc容器
|
24天前
|
XML Java 数据格式
SpringBoot入门(8) - 开发中还有哪些常用注解
SpringBoot入门(8) - 开发中还有哪些常用注解
37 2
|
2月前
|
XML Java 数据格式
Spring从入门到入土(bean的一些子标签及注解的使用)
本文详细介绍了Spring框架中Bean的创建和使用,包括使用XML配置文件中的标签和注解来创建和管理Bean,以及如何通过构造器、Setter方法和属性注入来配置Bean。
77 9
Spring从入门到入土(bean的一些子标签及注解的使用)