从入门到精通:Spring基础注解的全面解析

简介: 从入门到精通:Spring基础注解的全面解析


Spring 的这些基础注解仅仅是简化了 XML 的配置,但是并不能替代 XML。Spring 使用注解后是如何进行解耦的呢(注解都写死在代理里)?其实 Spring 在应用注解开发的时候,如果对注解不满意,还是可以通过 Spring 的配置文件(XML)进行覆盖的。

想要应用 Spring 注解进行开发,还需要进行如下配置,告知 Spring 扫描对应包下的注解。

<!-- 配置扫描包 -->
<context:component-scan base-package="world.xuewei"/>

对象创建相关

@Component

替换原来的 标签,将一个类声明为组件,通常是指那些没有明显角色的类。

@Component
public class Account implements Serializable {

就相当于如下的 XML 配置:

<bean id="account" class="world.xuewei.entity.Account"/>

@Component 注解提供了默认的 id 属性,使用类名的首单词首字母小写的方式,即 Account -> accountUserService -> userService。原来 bean 标签的 class 属性,就可以通过反射的方式获取类的全限定类名。

@Component 也可以手动指定 id 属性,如下:

@Component("acc")
public class Account implements Serializable {

如果想要在 XML 中覆盖注解配置,可以在配置文件中配置 bean,要求 bean 的 id 和 class 都需要和注解的配置一致,进而可以在 bean 标签的进行注入配置等。

<bean id="acc" class="world.xuewei.entity.Account">
    <property name="id" value="1"/>
</bean>

@Component 的衍生注解

  1. @Repository:将 DAO 类声明为 Spring Bean,用于数据库访问层。
  2. @Service:将 Service 类声明为 Spring Bean,用于业务逻辑层。
  3. @Controller:将 Controller 类声明为 Spring Bean,用于 MVC 控制器层。

这些衍生注解的用法细节和 @Component 是一模一样的。只不过是换了个更有针对性的名字。

注意:Spring 整合 Mybatis 开发过程中,不使用 @Component 和 @Repository。

@Scope

@Scope 注解用于指定 Spring 管理的 Bean 的作用域(Scope),即控制 Bean 的生命周期和实例化方式。通过 @Scope 注解,你可以将一个类或方法标记为一个 Spring Bean ,并指定其作用域。

在 Spring 中,常用的作用域包括以下几种:

  1. singleton(默认):每个 Spring 容器中只存在一个 Bean 实例。无论有多少次请求,都返回同一个 Bean 实例。
  2. prototype:每次请求都会创建一个新的 Bean 实例。每次使用 getBean() 方法获取该 Bean 时,都会得到一个全新的实例。
  3. request:每个 HTTP 请求都会创建一个新的 Bean 实例。当请求结束后,Bean 实例将被销毁。
  4. session:每个 HTTP 会话(Session)都会创建一个新的 Bean 实例。当会话结束后,Bean 实例将被销毁。
@Component
@Scope("prototype")
public class MyBean {
    // ...
}

注意:如果不添加 @Scope 注解,那么默认这个 Bean 就是单例的 Singleton。

@Lazy

@Lazy 是 Spring 框架中的一个注解,用于延迟加载(Lazy Loading)Bean 实例。当一个 Bean 被标记为 @Lazy 时,它将在第一次使用时才会被初始化,而不是在应用启动时就创建。

使用 @Lazy 注解可以提高应用的性能和资源利用率,特别是在存在大量复杂或耗时的 Bean 初始化过程时。通过延迟加载,可以避免在启动阶段创建所有的 Bean 实例,从而加快应用的启动速度。

例如,假设有一个名为 MyBean 的类,我们可以将其标记为 @Lazy

@Component
@Lazy
public class MyBean {
    // ...
}

在这种情况下,当 Spring 上下文初始化时,不会立即创建 MyBean 的实例。而是在第一次访问该 Bean 时才进行初始化。

注意:@Lazy 注解只针对单实例(@Scope("singleton")) Bean 生效。当 @Scope 不为 singleton 时,指定 @Lazy 无意义。

生命周期相关

以下的两个注解并不是 Spring 提供的,而是 JSR(JavaEE 规范)520 提供,Spring 做了很好的兼容。

@PostConstruct

当一个 Bean 被标记了 @PostConstruct 注解时,在该 Bean 的依赖注入完成后,容器会自动调用被注解的方法。这个方法可以用来执行一些初始化操作,例如初始化成员变量、建立连接、加载数据等。

使用 @PostConstruct 注解的方法需要满足以下条件:

  1. 方法不能有任何参数。
  2. 方法的返回类型必须为 void
  3. 方法不能抛出受检查的异常。

例如,假设有一个名为 MyBean 的类,我们可以在其中定义一个使用 @PostConstruct 注解的方法:

@Component
public class MyBean {
    @PostConstruct
    public void init() {
        // 初始化操作
    }
}

需要注意的是,@PostConstruct 注解通常与依赖注入(如 @Autowired)一起使用,以确保依赖关系已经注入完成后再执行初始化操作。

@PreDestroy

当一个 Bean 被标记了 @PreDestroy 注解时,在该 Bean 被销毁之前,容器会自动调用被注解的方法。这个方法可以用来执行一些清理操作,例如释放资源、关闭连接等。

使用 @PreDestroy 注解的方法需要满足以下条件:

  1. 方法不能有任何参数。
  2. 方法的返回类型必须为 void
  3. 方法不能抛出受检查的异常。

例如,假设有一个名为 MyBean 的类,我们可以在其中定义一个使用 @PreDestroy 注解的方法:

@Component
public class MyBean {
    @PreDestroy
    public void cleanup() {
        // 清理操作
    }
}

需要注意的是,@PreDestroy 注解通常与依赖注入(如 @Autowired)一起使用,以确保依赖关系已经注入完成后再执行清理操作。

注入相关

@Autowired

@Autowired 注解是 Spring 框架中用于实现依赖注入的注解之一。通过 @Autowired 注解,你可以自动将依赖的 Bean 注入到需要使用它的地方,无需手动创建和管理依赖对象。

使用 @Autowired 注解时,Spring 会根据类型进行自动装配。具体来说,当 Spring 容器中存在多个与被注入字段或方法参数类型匹配的 Bean 时,Spring 会根据一定的规则选择合适的 Bean 进行注入。如果只有一个匹配的 Bean,Spring 会直接将其注入;如果没有匹配的 Bean,将会抛出异常。

@Autowired 注解可以应用在以下位置:

  1. 字段上(直接放在成员变量上的时候,Spring 通过反射为变成进行赋值注入,不是通过 Set 方法):
@Autowired
private MyDependency myDependency;
  1. 构造函数上:
@Autowired
public MyClass(MyDependency myDependency) {
    this.myDependency = myDependency;
}
  1. Set 方法上(通过调用 Set 方法进行赋值注入):
@Autowired
public void setMyDependency(MyDependency myDependency) {
    this.myDependency = myDependency;
}

将下面的 Spring XML 配置可以转换为:

<bean id="accountService" class="world.xuewei.service.AccountServiceImpl">
    <property name="accountDao" ref="accountDao"/>
</bean>
@Repository
public class AccountDao {
    void insert(Account account){
        // ...
    }
}
@Service
public class AccountService {
    private AccountDao accountDao;
    public AccountDao getAccountDao() {
        return accountDao;
    }
    @Autowired
    public void setAccountDao(AccountDao accountDao) {
        this.accountDao = accountDao;
    }
    void register(Account account) {
        accountDao.insert(account);
    }
}

@Autowired 是基于类型进行注入的,要注入的 Bean 需要是定义成员变量的相同类型、或子类、或实现类。

@Qualifier

@Qualifier 注解是 Spring 框架中用于解决依赖注入歧义性的注解。当存在多个类型相同的 Bean 时,使用 @Qualifier 注解可以指定要注入的特定 Bean。

在使用 @Autowired 进行自动装配时,如果存在多个与被注入字段或方法参数类型匹配的 Bean,Spring 无法确定要注入哪个 Bean,从而抛出异常。这时,可以结合 @Qualifier 注解来解决歧义性问题。

@Qualifier 注解可以应用在以下位置:

  1. 字段上:
@Autowired
@Qualifier("myBean")
private MyInterface myBean;
  1. 构造函数上:
@Autowired
public MyClass(@Qualifier("myBean") MyInterface myBean) {
    this.myBean = myBean;
}
  1. Set 方法上:
@Autowired
public void setMyBean(@Qualifier("myBean") MyInterface myBean) {
    this.myBean = myBean;
}

需要注意的是,@Qualifier 注解配合 @Autowired 注解使用时,要确保指定的 Bean 名称与容器中的 Bean 名称一致。通常情况下,Bean名称是通过 @Component@Service@Repository 等注解指定的,或者是根据默认的命名规则生成的。

@Resouce

@Resource 注解是 Java EE(JSR 250) 标准中用于实现依赖注入的注解之一。它可以用于注入其他组件或资源,如数据源、JMS 队列等。在 Spring 框架中,@Resource 注解也可以用于实现依赖注入。

@Autowired 注解不同的是,@Resource 注解既可以按照名称进行注入,也可以按照类型进行注入。当使用 @Resource 注解按照名称进行注入时,它会根据指定的名称在容器中查找对应的 Bean 进行注入;当使用 @Resource 注解按照类型进行注入时,它会根据指定的类型在容器中查找对应的 Bean 进行注入。

  • 使用名称注入:@Resource(name = “XXX”),此时相当于 @Autowired 和 @Qualifier 的组合,但是需要注意的是,@Resource(name = “XXX”) 如果没有匹配到指定名称的 Bean,那么会按照类型再去匹配。
  • 使用类型注入:单独使用 @Resource,此时相当于 @Autowired。

@Resource 注解可以应用在以下位置:

  1. 字段上:
@Resource(name = "myBean")
private MyInterface myBean;
  1. 构造函数上:
@Autowired
public MyClass(@Resource(name = "myBean") MyInterface myBean) {
    this.myBean = myBean;
}
  1. Set 方法上:
@Resource(name = "myBean")
public void setMyBean(MyInterface myBean) {
    this.myBean = myBean;
}

需要注意的是,@Resource 注解在按照名称进行注入时,要确保指定的 Bean 名称与容器中的 Bean 名称一致。通常情况下,Bean名称是通过 @Component@Service@Repository 等注解指定的,或者是根据默认的命名规则生成的。

@Inject

@Inject 是 Java 中的一个注解,用于进行依赖注入。它是 Java 的标准依赖注入规范(JSR 330)中定义的注解之一。

使用 @Inject 注解可以在需要依赖的地方进行注入,例如字段、构造方法、普通方法等。它可以与其他依赖注入框架(如 Spring、CDI)一起使用,也可以作为 Java 自带的依赖注入机制的一部分使用。

@Inject 的用法与 @Autowired 完全一致。都是基于类型的注入。但是我们想要使用 Inject 注解,我们还需要额外引入依赖。

<dependency>
  <groupId>javax.inject</groupId>
  <artifactId>javax.inject</artifactId>
  <version>1</version>
</dependency>

@Value

@Value 注解是 Spring 框架中用于注入值的注解。它可以用于将配置文件中的值或者直接指定的值注入(通过 ${} 符号读取)到 Bean 中的字段、方法参数或构造函数中。

定义配置文件 test.properties 内容如下:

my.property=XW

配置 Spring 加载指定配置文件:

<!-- 指定加载配置文件 -->
<context:property-placeholder location="classpath:test.properties"/>

@Value 注解可以应用在以下位置:

  1. 字段上:
@Value("${my.property}")
  1. 构造函数上:
@Autowired
public MyClass(@Value("${my.property}") String myProperty) {
    this.myProperty = myProperty;
}
  1. Set 方法上:
@Autowired
public void setMyProperty(@Value("${my.property}") String myProperty) {
    this.myProperty = myProperty;
}

注意:@Value 注解不能标记在静态属性中。如果是静态的变量,那么无法进行复制(但是不会报错)。

注意:@Value 注解 + properties 这种方式不能注入集合类型的数据。可以通过 @Value + YAML 文件的方式实现集合类型的数据的注入。

@PropertySource

在上面的 @Value 笔记中,我们需要在 Spring 的配置文件中配置加载指定的配置文件。Spring 提供了 @PropertySource 注解让我们省去配置 XML。

@Component
@PropertySource("classpath:test.properties")
public class Account implements Serializable {
    private Integer id;
    @Value("${my.property}")
    private String name;
 
    // ..
}



相关文章
|
1月前
|
缓存 安全 Java
Spring Security通用权限管理模型解析
Spring Security作为Spring生态的核心安全框架,结合RBAC与ACL权限模型,基于IoC与AOP构建灵活、可扩展的企业级权限控制体系,涵盖认证、授权流程及数据库设计、性能优化等实现策略。
158 0
|
1月前
|
缓存 安全 Java
Spring Security权限管理解析
Spring Security是Spring生态中的核心安全框架,采用认证与授权分离架构,提供高度可定制的权限管理方案。其基于过滤器链实现认证流程,通过SecurityContextHolder管理用户状态,并结合RBAC模型与动态权限决策,支持细粒度访问控制。通过扩展点如自定义投票器、注解式校验与前端标签,可灵活适配多租户、API网关等复杂场景。结合缓存优化与无状态设计,适用于高并发与前后端分离架构。
159 0
|
1月前
|
缓存 监控 Java
SpringBoot @Scheduled 注解详解
使用`@Scheduled`注解实现方法周期性执行,支持固定间隔、延迟或Cron表达式触发,基于Spring Task,适用于日志清理、数据同步等定时任务场景。需启用`@EnableScheduling`,注意线程阻塞与分布式重复问题,推荐结合`@Async`异步处理,提升任务调度效率。
417 128
|
1月前
|
人工智能 Java 开发者
【Spring】原理解析:Spring Boot 自动配置
Spring Boot通过“约定优于配置”的设计理念,自动检测项目依赖并根据这些依赖自动装配相应的Bean,从而解放开发者从繁琐的配置工作中解脱出来,专注于业务逻辑实现。
|
1月前
|
XML 安全 Java
使用 Spring 的 @Aspect 和 @Pointcut 注解简化面向方面的编程 (AOP)
面向方面编程(AOP)通过分离横切关注点,如日志、安全和事务,提升代码模块化与可维护性。Spring 提供了对 AOP 的强大支持,核心注解 `@Aspect` 和 `@Pointcut` 使得定义切面与切入点变得简洁直观。`@Aspect` 标记切面类,集中处理通用逻辑;`@Pointcut` 则通过表达式定义通知的应用位置,提高代码可读性与复用性。二者结合,使开发者能清晰划分业务逻辑与辅助功能,简化维护并提升系统灵活性。Spring AOP 借助代理机制实现运行时织入,与 Spring 容器无缝集成,支持依赖注入与声明式配置,是构建清晰、高内聚应用的理想选择。
342 0
|
13天前
|
XML Java 数据格式
《深入理解Spring》:AOP面向切面编程深度解析
Spring AOP通过代理模式实现面向切面编程,将日志、事务等横切关注点与业务逻辑分离。支持注解、XML和编程式配置,提供五种通知类型及丰富切点表达式,助力构建高内聚、低耦合的可维护系统。
|
13天前
|
前端开发 Java 微服务
《深入理解Spring》:Spring、Spring MVC与Spring Boot的深度解析
Spring Framework是Java生态的基石,提供IoC、AOP等核心功能;Spring MVC基于其构建,实现Web层MVC架构;Spring Boot则通过自动配置和内嵌服务器,极大简化了开发与部署。三者层层演进,Spring Boot并非替代,而是对前者的高效封装与增强,适用于微服务与快速开发,而深入理解Spring Framework有助于更好驾驭整体技术栈。
|
21天前
|
XML Java 应用服务中间件
【SpringBoot(一)】Spring的认知、容器功能讲解与自动装配原理的入门,带你熟悉Springboot中基本的注解使用
SpringBoot专栏开篇第一章,讲述认识SpringBoot、Bean容器功能的讲解、自动装配原理的入门,还有其他常用的Springboot注解!如果想要了解SpringBoot,那么就进来看看吧!
194 3
|
1月前
|
XML Java 数据格式
常用SpringBoot注解汇总与用法说明
这些注解的使用和组合是Spring Boot快速开发和微服务实现的基础,通过它们,可以有效地指导Spring容器进行类发现、自动装配、配置、代理和管理等核心功能。开发者应当根据项目实际需求,运用这些注解来优化代码结构和服务逻辑。
220 12
|
1月前
|
Java 测试技术 数据库
使用Spring的@Retryable注解进行自动重试
在现代软件开发中,容错性和弹性至关重要。Spring框架提供的`@Retryable`注解为处理瞬时故障提供了一种声明式、可配置的重试机制,使开发者能够以简洁的方式增强应用的自我恢复能力。本文深入解析了`@Retryable`的使用方法及其参数配置,并结合`@Recover`实现失败回退策略,帮助构建更健壮、可靠的应用程序。
191 1
使用Spring的@Retryable注解进行自动重试

热门文章

最新文章

推荐镜像

更多
  • DNS
  • 下一篇
    开通oss服务