【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基础知识的学习。

相关文章
|
3月前
|
缓存 监控 Java
SpringBoot @Scheduled 注解详解
使用`@Scheduled`注解实现方法周期性执行,支持固定间隔、延迟或Cron表达式触发,基于Spring Task,适用于日志清理、数据同步等定时任务场景。需启用`@EnableScheduling`,注意线程阻塞与分布式重复问题,推荐结合`@Async`异步处理,提升任务调度效率。
570 128
|
3月前
|
XML 安全 Java
使用 Spring 的 @Aspect 和 @Pointcut 注解简化面向方面的编程 (AOP)
面向方面编程(AOP)通过分离横切关注点,如日志、安全和事务,提升代码模块化与可维护性。Spring 提供了对 AOP 的强大支持,核心注解 `@Aspect` 和 `@Pointcut` 使得定义切面与切入点变得简洁直观。`@Aspect` 标记切面类,集中处理通用逻辑;`@Pointcut` 则通过表达式定义通知的应用位置,提高代码可读性与复用性。二者结合,使开发者能清晰划分业务逻辑与辅助功能,简化维护并提升系统灵活性。Spring AOP 借助代理机制实现运行时织入,与 Spring 容器无缝集成,支持依赖注入与声明式配置,是构建清晰、高内聚应用的理想选择。
436 0
|
3月前
|
Java 测试技术 API
将 Spring 的 @Embedded 和 @Embeddable 注解与 JPA 结合使用的指南
Spring的@Embedded和@Embeddable注解简化了JPA中复杂对象的管理,允许将对象直接嵌入实体,减少冗余表与连接操作,提升数据库设计效率。本文详解其用法、优势及适用场景。
305 126
|
4月前
|
XML JSON Java
Spring框架中常见注解的使用规则与最佳实践
本文介绍了Spring框架中常见注解的使用规则与最佳实践,重点对比了URL参数与表单参数的区别,并详细说明了@RequestParam、@PathVariable、@RequestBody等注解的应用场景。同时通过表格和案例分析,帮助开发者正确选择参数绑定方式,避免常见误区,提升代码的可读性与安全性。
|
2月前
|
XML Java 应用服务中间件
【SpringBoot(一)】Spring的认知、容器功能讲解与自动装配原理的入门,带你熟悉Springboot中基本的注解使用
SpringBoot专栏开篇第一章,讲述认识SpringBoot、Bean容器功能的讲解、自动装配原理的入门,还有其他常用的Springboot注解!如果想要了解SpringBoot,那么就进来看看吧!
401 2
|
3月前
|
Java 测试技术 数据库
使用Spring的@Retryable注解进行自动重试
在现代软件开发中,容错性和弹性至关重要。Spring框架提供的`@Retryable`注解为处理瞬时故障提供了一种声明式、可配置的重试机制,使开发者能够以简洁的方式增强应用的自我恢复能力。本文深入解析了`@Retryable`的使用方法及其参数配置,并结合`@Recover`实现失败回退策略,帮助构建更健壮、可靠的应用程序。
391 1
使用Spring的@Retryable注解进行自动重试
|
3月前
|
XML Java 数据格式
常用SpringBoot注解汇总与用法说明
这些注解的使用和组合是Spring Boot快速开发和微服务实现的基础,通过它们,可以有效地指导Spring容器进行类发现、自动装配、配置、代理和管理等核心功能。开发者应当根据项目实际需求,运用这些注解来优化代码结构和服务逻辑。
302 12
|
3月前
|
传感器 Java 数据库
探索Spring Boot的@Conditional注解的上下文配置
Spring Boot 的 `@Conditional` 注解可根据不同条件动态控制 Bean 的加载,提升应用的灵活性与可配置性。本文深入解析其用法与优势,并结合实例展示如何通过自定义条件类实现环境适配的智能配置。
191 0
探索Spring Boot的@Conditional注解的上下文配置
|
3月前
|
智能设计 Java 测试技术
Spring中最大化@Lazy注解,实现资源高效利用
本文深入探讨了 Spring 框架中的 `@Lazy` 注解,介绍了其在资源管理和性能优化中的作用。通过延迟初始化 Bean,`@Lazy` 可显著提升应用启动速度,合理利用系统资源,并增强对 Bean 生命周期的控制。文章还分析了 `@Lazy` 的工作机制、使用场景、最佳实践以及常见陷阱与解决方案,帮助开发者更高效地构建可扩展、高性能的 Spring 应用程序。
142 0
Spring中最大化@Lazy注解,实现资源高效利用