深入理解注解驱动配置与XML配置的融合与区别

摘要:本文旨在深入探讨Spring框架的注解驱动配置与XML配置,揭示两者之间的相似性与差异。

本文分享自华为云社区《Spring高手之路2——深入理解注解驱动配置与XML配置的融合与区别》,作者:砖业洋__ 。

本文旨在深入探讨Spring框架的注解驱动配置与XML配置,揭示两者之间的相似性与差异。我们首先介绍了配置类的编写与Bean的注册,然后比较了注解驱动的IOC依赖注入与XML依赖注入。文章进一步解析了Spring的组件注册与组件扫描,包括使用@ComponentScan和XML启用component-scan的情况,以及不使用@ComponentScan的场景。接下来,我们深入探讨了其他相关的组件

1.配置类的编写与Bean的注册

XML配置中,我们通常采用ClassPathXmlApplicationContext,它能够加载类路径下的XML配置文件来初始化Spring应用上下文。然而,在注解驱动的配置中,我们则使用以Annotation开头和ApplicationContext结尾的类,如AnnotationConfigApplicationContext。AnnotationConfigApplicationContext是Spring容器的一种,它实现了ApplicationContext接口。

对比于 XML 文件作为驱动,注解驱动需要的是配置类。一个配置类就可以类似的理解为一个 XML 。配置类没有特殊的限制,只需要在类上标注一个 @Configuration 注解即可。

我们创建一个 Book 类:

public class Book {
 private String title;
 private String author;
 public String getTitle() {
 return title;
 }
 public void setTitle(String title) {
 this.title = title;
 }
 public String getAuthor() {
 return author;
 }
 public void setAuthor(String author) {
 this.author = author;
 }
}

在 xml 中声明 Bean 是通过 <bean> 标签

<bean id="book" class="com.example.Book">
 <property name="title" value="Java Programming"/>
 <property name="author" value="Unknown"/>
</bean>

如果要在配置类中替换掉 <bean> 标签,需要使用 @Bean 注解

我们创建一个配置类来注册这个 Book bean:

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
@Configuration
public class LibraryConfiguration {
 @Bean
 public Book book() {
 Book book = new Book();
 book.setTitle("Java Programming");
 book.setAuthor("Unknown");
 return book;
 }
}

在这个配置中,我们使用了 @Configuration 注解来表示这是一个配置类,类似于一个 XML 文件。我们在 book() 方法上使用了 @Bean 注解,这意味着这个方法将返回一个由 Spring 容器管理的对象。这个对象的类型就是 Book,bean 的名称id就是方法的名称,也就是 “book”。

类似于 XML 配置的 <bean> 标签,@Bean 注解负责注册一个 bean。你可以把 @Bean 注解看作是 <bean> 标签的替代品。

如果你想要更改这个 bean 的名称,你可以在 @Bean 注解中使用 name 属性:

 @Bean(name="mybook")
 public Book book() {
 Book book = new Book();
 book.setTitle("Java Programming");
 book.setAuthor("Unknown");
 return book;
 }

这样,这个 Book bean 的名称就变成了 “mybook”。

启动并初始化注解驱动的IOC容器

@SpringBootApplication
public class DemoApplication {
 public static void main(String[] args) {
ApplicationContext context = new AnnotationConfigApplicationContext(LibraryConfiguration.class);
 // 从容器中获取 Book bean
 LibraryConfiguration libraryConfiguration = context.getBean(LibraryConfiguration.class);
 System.out.println(libraryConfiguration.book().getTitle());
 System.out.println(libraryConfiguration.book().getAuthor());
 }
}

ApplicationContext context = new AnnotationConfigApplicationContext(LibraryConfiguration.class)这个语句创建了一个Spring的应用上下文,它是以配置类LibraryConfiguration.class作为输入的,这里明确指定配置类的Spring应用上下文,适用于更一般的Spring环境。

对比一下ApplicationContext context = SpringApplication.run(DemoApplication.class, args);这个语句则是Spring Boot应用的入口,启动一个Spring Boot应用。SpringApplication.run()方法会创建一个Spring Boot应用上下文(也就是一个SpringApplication对象),这个上下文包含了Spring Boot应用所有的Bean和配置类,还有大量的默认配置。这个方法之后,Spring Boot的自动配置就会起作用。你可以把SpringApplication.run()创建的Spring Boot上下文看作是更加功能丰富的Spring上下文。

打印结果:

Java Programming和Unknown被打印,执行成功。

注意:@SpringBootApplication是一个复合注解,它等效于同时使用了@Configuration,@EnableAutoConfiguration和@ComponentScan。这三个注解的作用是:

  • @Configuration:指明该类是一个配置类,它可能会有零个或多个@Bean注解,方法产生的实例由Spring容器管理。
  • @EnableAutoConfiguration:告诉Spring Boot根据添加的jar依赖自动配置你的Spring应用。
  • @ComponentScan:Spring Boot会自动扫描该类所在的包以及子包,查找所有的Spring组件,包括@Configuration类。

在非Spring Boot的传统Spring应用中,我们通常使用AnnotationConfigApplicationContext或者ClassPathXmlApplicationContext等来手动创建和初始化Spring的IOC容器。

"非Spring Boot的传统Spring应用"是指在Spring Boot项目出现之前的Spring项目,这些项目通常需要手动配置很多东西,例如数据库连接、事务管理、MVC控制器等。这种类型的Spring应用通常需要开发者对Spring框架有深入的了解,才能做出正确的配置。

Spring Boot是Spring项目的一个子项目,它旨在简化Spring应用的创建和配置过程。Spring Boot提供了一系列的"起步依赖",使得开发者只需要添加少量的依赖就可以快速开始项目的开发。此外,Spring Boot还提供了自动配置的特性,这使得开发者无需手动配置数据库连接、事务管理、MVC控制器等,Spring Boot会根据项目的依赖自动进行配置。

因此,"非Spring Boot的传统Spring应用"通常需要手动创建和初始化Spring的IOC容器,比如使用AnnotationConfigApplicationContext或ClassPathXmlApplicationContext等。在Spring Boot应用中,这个过程被自动化了,开发者只需要在main方法中调用SpringApplication.run方法,Spring Boot就会自动创建和初始化Spring的IOC容器。SpringApplication.run(Application.class, args);语句就是启动Spring Boot应用的关键。它会启动一个应用上下文,这个上下文会加载所有的Spring组件,并且也会启动Spring的IOC容器。在这个过程中,所有通过@Bean注解定义的bean都会被创建,并注册到IOC容器中。

有人说,那学习Spring Boot就好了,学什么Spring和Spring MVC啊,这不是落后了吗

Spring Boot并不是Spring框架的替代品,而是建立在Spring框架之上的一种工具,它内部仍然使用Spring框架的很多核心技术,包括Spring MVC。所以,当我们在使用Spring Boot时,我们实际上仍然在使用Spring MVC来处理Web层的事务。

简而言之,Spring MVC是一个用于构建Web应用程序的框架,而Spring Boot是一个用于简化Spring应用程序开发的工具,它内部仍然使用了Spring MVC。你在Spring Boot应用程序中使用的@Controller、@Service、@Autowired等注解,其实都是Spring框架提供的,所以,原理性的东西还是需要知道。

2. 注解驱动IOC的依赖注入与XML依赖注入对比

我们就以上面的例子来说,假设配置类注册了两个bean,并设置相关的属性:

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
@Configuration
public class LibraryConfiguration {
 @Bean
 public Book book() {
 Book book = new Book();
 book.setTitle("Java Programming");
 book.setAuthor("Unknown");
 return book;
 }
 @Bean
 public Library library() {
 Library library = new Library();
 library.setBook(book());
 return library;
 }
}

这里的方法有@Bean注解,这个注解告诉Spring,这个方法返回的对象需要被注册到Spring的IOC容器中。

如果不用注解,要实现相同功能的话,对应的XML配置如下:

<bean id="book" class="com.example.Book">
 <property name="title" value="Java Programming"/>
 <property name="author" value="Unknown"/>
</bean>
<bean id="library" class="com.example.Library">
 <property name="book" ref="book"/>
</bean>

在这个XML配置中,我们定义了两个<bean>元素,分别用来创建Book对象和Library对象。在创建Book对象时,我们使用了<property>元素来设置title和author属性。在创建Library对象时,我们也使用了<property>元素,但是这次我们使用了ref属性来引用已经创建的Book对象,这就相当于将Book对象注入到Library对象中。

3. Spring中组件的概念

在Spring框架中,当我们说 “组件” 的时候,我们通常指的是被Spring管理的各种Java对象,这些对象在Spring的应用上下文中作为Bean存在。这些组件可能是服务层的类、数据访问层的类、控制器类、配置类等等。

@ComponentScan注解会扫描指定的包(及其子包)中的类,如果这些类上标注了@Component、@Controller、@Service、@Repository、@Configuration等注解,那么Spring就会为这些类创建Bean定义,并将这些Bean定义注册到Spring的应用上下文中。因此,我们通常说@ComponentScan进行了"组件扫描",因为它扫描的是标注了上述注解的类,这些类在Spring中都被视为组件。

而这些注解标记的类,最终在Spring的应用上下文中都会被创建为Bean,因此,你也可以理解@ComponentScan为"Bean扫描"。但是需要注意的是,@ComponentScan只负责扫描和注册Bean定义,Bean定义就是元数据描述,包括了如何创建Bean实例的信息。

总结一下,@ComponentScan注解会扫描并注册的"组件"包括:

  • 标注了@Component注解的类
  • 标注了@Controller注解的类(Spring MVC中的控制器组件)
  • 标注了@Service注解的类(服务层组件)
  • 标注了@Repository注解的类(数据访问层组件)
  • 标注了@Configuration注解的类(配置类)

这些组件最终都会在Spring的应用上下文中以Bean的形式存在。

4. 组件注册

这里Library 标注 @Configuration 注解,即代表该类会被注册到 IOC 容器中作为一个 Bean。

@Component
public class Library {
}

相当于 xml 中的:

<bean id="library" class="com.example.demo.configuration.Library">

如果想指定 Bean 的名称,可以直接在 @Configuration 中声明 value 属性即可

@Component("libra")
public class Library {
}

@Component("libra")就将这个bean的名称改为了libra,如果不指定 Bean 的名称,它的默认规则是 “类名的首字母小写”(例如Library默认名称是 library )

5. 组件扫描

如果我们只写了@Component, @Configuration 这样的注解,IOC容器是找不到这些组件的。

5.1 使用@ComponentScan的组件扫描

忽略掉之前的例子,在这里我们需要运行的代码如下:

@Component
public class Book {
 private String title = "Java Programming";
 private String author = "Unknown";
 public String getTitle() {
 return title;
 }
 public void setTitle(String title) {
 this.title = title;
 }
 public String getAuthor() {
 return author;
 }
 public void setAuthor(String author) {
 this.author = author;
 }
}
@Component
public class Library {
 @Resource
 private Book book;
 public Book getBook() {
 return book;
 }
 public void setBook(Book book) {
 this.book = book;
 }
}

如果不写@ComponentScan,而且@Component注解标识的类不在当前包或者子包,那么就会报错。

难道@Component注解标识的类在当前包或者当前包的子包,主程序上就可以不写@ComponentScan了吗?

是的!前面说了,@SpringBootApplication 包含了 @ComponentScan,其实已经帮我们写了!只有组件和主程序不在一个共同的根包下,才需要显式地使用 @ComponentScan 注解。由于 Spring Boot 的设计原则是“约定优于配置”,所以推荐将主应用类放在根包下。

在应用中,我们的组件(带有 @Component、@Service、@Repository、@Controller 等注解的类)和主配置类位于不同的包中,并且主配置类或者启动类没有使用 @ComponentScan 指定扫描这些包,那么在运行时就会报错,因为Spring找不到这些组件。

主程序:

@SpringBootApplication
@ComponentScan(basePackages = "com.example")
public class DemoApplication {
 public static void main(String[] args) {
 ApplicationContext context = SpringApplication.run(DemoApplication.class, args);
 Library library = context.getBean(Library.class);
 System.out.println(library.getBook().getTitle());
 System.out.println(library.getBook().getAuthor());
 }
}

@ComponentScan 不一定非要写在主程序(通常是指 Spring Boot 的启动类)上,它可以写在任何配置类(标记有 @Configuration 注解的类)上。@ComponentScan 注解会告诉 Spring 从哪些包开始进行组件扫描。

为了简化配置,我们通常会将 @ComponentScan 放在主程序上,因为主程序一般会位于根包下,这样可以扫描到所有的子包。这里为了演示,并没有把主程序放在根目录。

我们上面说过,@ComponentScan只负责扫描和注册Bean定义,只有需要某个Bean时,这个Bean才会实例化。

那怎么才能知道是不是需要这个Bean呢?

我来给大家举例子,并且还会说明Bean的创建顺序问题,"需要某个Bean"通常体现在以下几个方面:

  • 依赖注入(Dependency Injection): 如果一个BeanA的字段或者构造方法被标注为@Autowired或者@Resource,那么Spring就会尝试去寻找类型匹配的BeanB并注入到BeanA中。在这个过程中,如果BeanB还没有被创建,那么Spring就会先创建BeanB的实例。
@Component
public class BeanA {
 @Autowired
 private BeanB beanB;
}
@Component
public class BeanB {
}

BeanA依赖于BeanB。在这种情况下,当你尝试获取BeanA的实例时,Spring会首先创建BeanB的实例,然后把这个实例注入到BeanA中,最后创建BeanA的实例。在这个例子中,BeanB会先于BeanA被创建。

这种方式的一个主要优点是,我们不需要关心Bean的创建顺序,Spring会自动解决这个问题。这是Spring IoC容器的一个重要特性,也是为什么它能够使我们的代码更加简洁和易于维护的原因。

  • Spring框架调用: 有些情况下,Spring框架的一些组件或者模块可能需要用到你定义的Bean。比如,如果你定义了一个@Controller,那么在处理HTTP请求时,Spring MVC就会需要使用到这个@Controller Bean。如果这个时候Bean还没有被创建,那么Spring也会先创建它的实例。

假设我们有一个名为BookController的类,该类需要一个BookService对象来处理一些业务逻辑。

@Controller
public class BookController {
 @Autowired
 private BookService bookService;
 // 其他的控制器方法
}

BookService类

@Service
public class BookService {
 @Autowired
 private BookMapper bookMapper;
 // 一些业务逻辑方法
}

当Spring Boot应用程序启动时,以下步骤将会发生:

  1. 首先,Spring框架通过@ComponentScan注解扫描类路径,找到了BookController、BookService和BookMapper等类,并为它们创建Bean定义,注册到Spring的应用上下文中。
  2. 当一个请求到达并需要使用到BookController时,Spring框架会尝试创建一个BookController的Bean实例。
  3. 在创建BookController的Bean实例的过程中,Spring框架发现BookController类中需要一个BookService的Bean实例(通过@Autowired注解指定),于是Spring框架会先去创建一个BookService的Bean实例。
  4. 同样,在创建BookService的Bean实例的过程中,Spring框架发现BookService类中需要一个BookMapper的Bean实例(通过@Autowired注解指定),于是Spring框架会先去创建一个BookMapper的Bean实例。
  5. 在所有依赖的Bean都被创建并注入之后,BookController的Bean实例最终被创建完成,可以处理来自用户的请求了。

在这个过程中,BookController、BookService和BookMapper这三个Bean的创建顺序是有严格要求的,必须按照他们之间的依赖关系来创建。只有当一个Bean的所有依赖都已经被创建并注入后,这个Bean才能被创建。这就是Spring框架的IoC(控制反转)和DI(依赖注入)的机制。

  • 手动获取: 如果你在代码中手动通过ApplicationContext.getBean()方法获取某个Bean,那么Spring也会在这个时候创建对应的Bean实例,如果还没有创建的话。

总的来说,"需要"一个Bean,是指在运行时有其他代码需要使用到这个Bean的实例,这个"需要"可能来源于其他Bean的依赖,也可能来源于框架的调用,或者你手动获取。在这种需要出现时,如果对应的Bean还没有被创建,那么Spring就会根据之前通过@ComponentScan等方式注册的Bean定义,创建对应的Bean实例。

5.2 xml中启用component-scan组件扫描

对应于 @ComponentScan 的 XML 配置是 <context:component-scan> 标签

<beans xmlns="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="com.example" />
</beans>

在这段 XML 配置中,<context:component-scan> 标签指定了 Spring 需要扫描 com.example 包及其子包下的所有类,这与 @ComponentScan 注解的功能是一样的。

注意:在使用 <context:component-scan> 标签时,需要在 XML 配置文件的顶部包含 context 命名空间和相应的 schema 位置(xsi:schemaLocation)。

5.3 不使用@ComponentScan的组件扫描

如果我们不写@ComponentScan注解,那么这里可以把主程序改为如下:

@SpringBootApplication
public class DemoApplication {
 public static void main(String[] args) {
 ApplicationContext context = new AnnotationConfigApplicationContext("com.example");
 Library library = context.getBean(Library.class);
 System.out.println(library.getBook().getTitle());
 System.out.println(library.getBook().getAuthor());
 }
}

AnnotationConfigApplicationContext 的构造方法中有一个是填写basePackages路径的,可以接受一个或多个包的名字作为参数,然后扫描这些包及其子包。

运行结果如下:

在这个例子中,Spring 将会扫描 com.example 包及其所有子包,查找并注册所有的 Bean,达到和@ComponentScan注解一样的效果。

我们也可以手动创建一个配置类来注册bean,那么想要运行得到一样的效果,需要的代码如下:

@Component
public class Book {
 private String title = "Java Programming";
 private String author = "Unknown";
 public String getTitle() {
 return title;
 }
 public void setTitle(String title) {
 this.title = title;
 }
 public String getAuthor() {
 return author;
 }
 public void setAuthor(String author) {
 this.author = author;
 }
}
@Component
public class Library {
 private Book book;
 public Book getBook() {
 return book;
 }
 public void setBook(Book book) {
 this.book = book;
 }
}
@Configuration
public class LibraryConfiguration {
 @Bean
 public Book book() {
 Book book = new Book();
 book.setTitle("Java Programming");
 book.setAuthor("Unknown");
 return book;
 }
 @Bean
 public Library library() {
 Library library = new Library();
 library.setBook(book());
 return library;
 }
}

主程序:

@SpringBootApplication
public class DemoApplication {
 public static void main(String[] args) {
 ApplicationContext context = new AnnotationConfigApplicationContext(LibraryConfiguration.class);
 Library library = context.getBean(Library.class);
 System.out.println(library.getBook().getTitle());
 System.out.println(library.getBook().getAuthor());
 }
}

我们创建了一个配置类LibraryConfiguration,用于定义Book和Library这两个bean。然后以配置类LibraryConfiguration.class作为输入的来创建Spring的IOC容器(Spring应用上下文就是Spring IOC容器)。

运行结果和前面一样。

注意,在这个例子里,如果你写@ComponentScan,并且SpringApplication.run(Application.class, args);作为Spring上下文,那么这里运行配置类需要去掉Book和Library类的@Component注解,不然会报错A bean with that name has already been defined。这是因为如果同时在 Book 和Library 类上使用了 @Component 注解,而且配置类LibraryConfiguration上使用了@Configuration注解,这都会被 @ComponentScan 扫描到,那么 Book 和 Library的实例将会被创建并注册两次。正确的做法是,要么在配置类中通过 @Bean 注解的方法创建Book 和 Library的实例,要么在 Book 和 Library 类上写 @Component 注解。如果不是第三方库,我们一般选择后者。

为什么要有配置类出现?所有的Bean上面使用@Component,用@ComponentScan注解扫描不就能解决了吗?

我们在使用一些第三方库时,需要对这些库进行一些特定的配置。这些配置信息,我们可能无法直接通过注解或者XML来完成,或者通过这些方式完成起来非常麻烦。而配置类可以很好地解决这个问题。通过配置类,我们可以在Java代码中完成任何复杂的配置逻辑。

假设你正在使用 MyBatis,在这种情况下可能需要配置一个SqlSessionFactory,在大多数情况下,我们无法(也不应该)直接修改第三方库的代码,所以无法直接在SqlSessionFactory类或其他类上添加@Configuration、@Component等注解。为了能够在Spring中使用和配置这些第三方库,我们需要创建自己的配置类,并在其中定义@Bean方法来初始化和配置这些类的实例。这样就可以灵活地控制这些类的实例化过程,并且可以利用Spring的依赖注入功能。

下面是一个使用@Configuration和@Bean来配置MyBatis的例子:

@Configuration
@MapperScan("com.example.demo.mapper")
public class MyBatisConfig {
 @Bean
 public SqlSessionFactory sqlSessionFactory(DataSource dataSource) throws Exception {
 SqlSessionFactoryBean factoryBean = new SqlSessionFactoryBean();
        factoryBean.setDataSource(dataSource);
        factoryBean.setMapperLocations(
 new PathMatchingResourcePatternResolver().getResources("classpath*:com/example/demo/mapper/*Mapper.xml")
 );
 return factoryBean.getObject();
 }
}

sqlSessionFactory方法创建一个SqlSessionFactoryBean对象,并使用DataSource(Spring Boot默认为你配置的一个Bean)进行初始化。然后,它指定MyBatis mapper XML文件的位置,最后返回SqlSessionFactory对象。

通过这种方式,你可以灵活地配置MyBatis,并将其整合到Spring应用中。这是一种比使用XML配置文件或仅仅依赖于自动配置更为灵活和强大的方式。

6. 组件注册的其他注解

@Controller, @Service, @Repository和@Component 一样的效果,它们都会被 Spring IoC 容器识别,并将类实例化为 Bean。让我们来看这些注解:

  • @Controller:这个注解通常标注在表示表现层(比如 Web 层)的类上,如Spring MVC 中的控制器。它们处理用户的 HTTP 请求并返回响应。虽然 @Controller 与 @Component 在功能上是类似的,但 @Controller 注解的使用表示了一种语义化的分层结构,使得控制层代码更加清晰。
  • @Service:这个注解通常用于标注业务层的类,这些类负责处理业务逻辑。使用 @Service 注解表明该类是业务处理的核心类,使得代码更具有语义化。
  • @Repository:这个注解用于标记数据访问层,也就是数据访问对象或DAO层的组件。在数据库操作的实现类上使用 @Repository 注解,这样Spring将自动处理与数据库相关的异常并将它们转化为Spring的DataAccessExceptions。

在实际开发中,几乎很少看到@Repository,而是利用 MyBatis 的 @Mapper 或 @MapperScan 实现数据访问,通常做法是,@MapperScan 注解用于扫描特定包及其子包下的接口,这些接口被称为 Mapper 接口。Mapper 接口方法定义了 SQL 查询语句的签名,而具体的 SQL 查询语句则通常在与接口同名的 XML 文件中定义。

@MapperScan("com.example.**.mapper") 会扫描 com.example 包及其所有子包下的名为 mapper 的包,以及 mapper 包的子包。 ** 是一个通配符,代表任意深度的子包。

举个例子,以下是一个 Mapper 接口的定义:

package com.example.demo.mapper;
public interface BookMapper {
 Book findBookById(int id);
}

对应的 XML 文件(通常位于 resources 目录下,并且与接口在相同的包路径中)

<!DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
 "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.example.demo.BookMapper">
 <select id="findBookById" parameterType="int" resultType="com.example.demo.Book">
        SELECT title, author FROM book WHERE id = #{id}
 </select>
</mapper>

注意:在 XML 文件中的 namespace 属性值必须与 Mapper 接口的全限定类名相同,<select> 标签的 id 属性值必须与接口方法名相同。

然后,在 Spring Boot 的主类上,我们使用 @MapperScan 注解指定要扫描的包:

@SpringBootApplication
@MapperScan("com.example.**.mapper")
public class Application {
 public static void main(String[] args) {
 SpringApplication.run(Application.class, args);
 }
}

这样,MyBatis 就会自动为 UserMapper 接口创建一个实现类(实际上是一个代理对象),并将其注册到 Spring IOC 容器中,你就可以在你的服务类中直接注入 BookMapper 并使用它。

可能有小伙伴注意到了,这几个注解中都有这么一段代码

 @AliasFor(
        annotation = Component.class
 )
 String value() default "";

@AliasFor 是 Spring 框架的注解,它允许你在一个注解属性上声明别名。在 Spring 的许多核心注解中,@AliasFor 用于声明一个或多个别名属性。

举个例子,在 @Controller, @Service, @Repository注解中,value() 方法上的 @AliasFor 声明了一个别名属性,它的目标注解是 @Component,具体的别名属性是 value。也就是说,当我们在 @Controller, @Service, @Repository 注解上使用 value() 方法设置值时,实际上也就相当于在 @Component 注解上设置了 name 属性的值。同时,这也表明了 @Controller, @Service, @Repository注解本身就是一个特殊的 @Component。

7. 将注解驱动的配置与XML驱动的配置结合使用

有没有这么一种可能,一个旧的Spring项目,里面有很多旧的XML配置,现在你接手了,想要全部用注解驱动,不想再写XML配置了,那应该怎么兼容呢?

假设我们有一个旧的Spring XML配置文件 old-config.xml:

<beans xmlns="http://www.springframework.org/schema/beans"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="http://www.springframework.org/schema/beans
    http://www.springframework.org/schema/beans/spring-beans.xsd">
 <bean id="oldBean" class="com.example.OldBean" />
</beans>

这个文件定义了一个名为 “oldBean” 的bean。

然后,我们编写一个新的注解驱动的配置类:

package com.example;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.ImportResource;
@Configuration
@ImportResource("classpath:old-config.xml")
public class NewConfig {
 @Bean
 public NewBean newBean() {
 return new NewBean();
 }
}

在这个新的配置类中,我们使用 @ImportResource 注解来引入旧的XML配置文件,并定义了一个新的bean “newBean”。@ImportResource("classpath:old-config.xml")告诉Spring在初始化AppConfig配置类时,去类路径下寻找old-config.xml文件,并加载其中的配置。

当我们启动应用程序时,Spring会创建一个 ApplicationContext,这个 ApplicationContext 会包含 old-config.xml 文件中定义的所有beans(例如 “oldBean”),以及 NewConfig 类中定义的所有beans(例如 “newBean”)。

package com.example;
import org.springframework.context.ApplicationContext;
import org.springframework.context.annotation.AnnotationConfigApplicationContext;
public class Application {
 public static void main(String[] args) {
 ApplicationContext context = new AnnotationConfigApplicationContext(NewConfig.class);
 OldBean oldBean = context.getBean("oldBean", OldBean.class);
 NewBean newBean = context.getBean("newBean", NewBean.class);
 System.out.println(oldBean);
 System.out.println(newBean);
 }
}

在以上的main方法中,我们通过使用AnnotationConfigApplicationContext并传入NewConfig.class作为参数,初始化了一个Spring上下文。在这个上下文中,既包含了从old-config.xml导入的bean,也包含了在NewConfig配置类中使用@Bean注解定义的bean。

所以,通过使用 @ImportResource,可以在新的注解配置中引入旧的XML配置,这样就可以在不打断旧的XML配置的基础上逐步迁移至新的注解配置。

上面我们说到类路径,什么是类路径?

resources目录就是类路径(classpath)的一部分。所以当我们说"类路径下"的时候,实际上也包含了"resources“目录。JVM在运行时,会把”src/main/resources"目录下的所有文件和文件夹都添加到类路径中。

例如有一个XML文件位于"src/main/resources/config/some-context.xml",那么可以用以下方式来引用它:

@Configuration
@ImportResource("classpath:config/some-context.xml")
public class AppConfig {
 //...
}

这里可以描述为在类路径下的’config‘目录中查找’some-context.xml'文件。

为什么说JVM在运行时,会把"src/main/resources"目录下的所有文件和文件夹都添加到类路径中?

当你编译并运行一个Java项目时,JVM需要知道去哪里查找.class文件以及其他资源文件。这个查找的位置就是所谓的类路径(Classpath)。类路径可以包含文件系统上的目录,也可以包含jar文件。简单的说,类路径就是JVM查找类和资源的地方。

在一个标准的Maven项目结构中,Java源代码通常在src/main/java目录下,而像是配置文件、图片、静态网页等资源文件则放在src/main/resources目录下。

当你构建项目时,Maven(或者其他的构建工具,如Gradle)会把src/main/java目录下的.java文件编译成.class文件,并把它们和src/main/resources目录下的资源文件一起复制到项目的输出目录(通常是target/classes目录)。

然后当你运行程序时,JVM会把target/classes目录(即编译后的src/main/java和src/main/resources)添加到类路径中,这样JVM就可以找到程序运行所需的类和资源了。

如果有一个名为application.properties的文件在src/main/resources目录下,就可以使用类路径来访问它,就像这样:classpath:application.properties。在这里classpath:前缀告诉JVM这个路径是相对于类路径的,所以它会在类路径中查找application.properties文件。因为src/main/resources在运行时被添加到了类路径,所以JVM能找到这个文件。

8. 思考总结

8.1 为什么我们需要注册组件,这与Bean注册有什么区别?

在Spring框架中,Bean对象是由Spring IoC容器创建和管理的。通常Bean对象是应用程序中的业务逻辑组件,如数据访问对象(DAO)或其他服务类。

组件注册,或者说在Spring中通过@Component或者其派生注解(@Service, @Controller, @Repository等)标记的类,是告诉Spring框架这个类是一个组件,Spring需要创建它的实例并管理它的生命周期。这样当使用到这个类的时候,Spring就可以自动地创建这个类的实例并注入到需要的地方。

Bean注册和组件注册其实是非常类似的,都是为了让Spring知道它需要管理哪些类的实例。区别在于Bean注册通常发生在配置类中,使用@Bean注解来明确地定义每一个Bean,而组件注册则是通过在类上使用@Component或者其派生注解来告诉Spring,这个类是一个组件,Spring应该自动地为其创建实例。

8.2 什么是组件扫描,为什么我们需要它,它是如何工作的?

组件扫描是Spring的一种机制,用于自动发现应用程序中的Spring组件,并自动地为这些组件创建Bean定义,然后将它们注册到Spring的应用上下文中,我们可以通过使用@ComponentScan注解来启动组件扫描。

我们需要组件扫描是因为它可以大大简化配置过程,我们不再需要为应用程序中的每个类都显式地创建Bean。而是通过简单地在类上添加@Component或者其派生注解,并启动组件扫描,就可以让Spring自动地为我们的类创建Bean并管理它们。

组件扫描的工作过程如下:使用@ComponentScan注解并指定一个或多个包路径时,Spring会扫描这些包路径及其子包中的所有类。对于标记了@Component或者其派生注解的类,Spring会在应用上下文启动时为它们创建Bean,并将这些Bean定义注册到Spring的应用上下文中。当需要使用这些类的实例时,Spring就可以自动注入这些实例。

点击关注,第一时间了解华为云新鲜技术~

相关推荐

鸿蒙案例上新啦 | 购物、听歌、健身:15个模板带你一键激活社交娱乐

页面层级如何组织、跨页共享状态如何同步、列表与详情及个人中心如何形成稳定闭环。鸿蒙开发实践中心将这些高频消费与互动场景沉淀为可参考的标准模板,提供从业务架构到界面实现的快捷实践入口。更多实战案例欢迎前往鸿蒙开发实践中心案例中心查看并开启云端体验。

华为云官方博客 383

鸿蒙案例上新啦 | 出门打车、到家上课:25个模板带你一屏打通日常生活

如何合理拆分页面组件、如何建立单一可信的状态源、如何让用户在每一步操作中都获得明确反馈。鸿蒙开发实践中心以标准化的应用与元服务模板为入口,将清晰的业务架构与可复用的代码结构直观呈现。不妨立即挑选一个感兴趣的方向进入云端环境,从页面布局、组件封装、状态管理到路由组织,亲手跑通你的鸿蒙实战项目。

华为云官方博客 356

LakeAgent:DWS数据仓库的第二大脑,告别 “翻译式运维”,迈入智能自治时代

和普通 SQL 改写工具不同,LakeAgent 自动做多方案代价对比,主动规避负优化陷阱:补充分区键过滤实现剪枝,扫描分区由 37 收敛至 1,执行代价从 758.28 降至 113.74;未来的数据仓库,将不止能算、能存,更能看懂自己、诊断自己、理解自己。长久以来,数仓的智能都依附于人:信号需要人解读,瓶颈需要人研判,经验困在个体里,无法随底座永续生长。CPU 高、CPU 告警、CPU 诊断、CPU 使用率过高、CPU 满。语法、错误码、计费、性能调优、最佳实践、故障处置等全场景内容。

华为云官方博客 579

如何使用RDS Supabase后端BaaS能力:文件存储(File Storage)

• product-images(公开桶,允许公共读取):策略名称"Public read for product-images",允许SELECT,目标角色anon,策略定义bucket_id = 'product-images'。上传/删除需另配INSERT/DELETE策略,详见SQL。• product-specs(私有桶,仅认证用户访问自己的文件夹):建议拆为上传、读取、删除三条策略,策略定义均为 bucket_id = 'product-specs' 且仅限本人文件夹(详见下文 SQL)。

华为云官方博客 499

如何使用RDS Supabase后端BaaS能力:实时订阅与推送(Realtime)

Realtime 把数据库的每次变更同步到客户端:表里增、删、改一行,订阅者无需刷新页面或主动请求即可秒级收到。三大能力各司其职:• Postgres Changes — 监听表的 INSERT/UPDATE/DELETE,变化即通知• Broadcast — 客户端之间直接互发,适合瞬时通知、协同编辑• Presence — 跟踪频道里“谁在线”典型场景有实时数据展示(订单、库存、监控指标即时刷新)、即时通讯(消息收发、在线名单、“对方正在输入”)、协同编辑与实时通知。

华为云官方博客 489

AI Agent如何通过MCP连接到华为云RDS Supabase应用平台

Schema元数据列出所有可访问的表(按schema分组)。Schema元数据列出表的列及元数据(类型/默认值/约束)。Schema元数据列出所有约束(PK/FK/UNIQUE/CHECK/EXCLUDE)。可按schema/表/类型过滤。Schema元数据列出所有外键关系。可按schema/表过滤。Schema元数据列出所有索引及定义和大小。可按schema/表过滤。Schema元数据列出已应用的数据库迁移记录。Schema元数据列出已安装的PostgreSQL扩展。

华为云官方博客 492

华为大数据Flink让每一 CU 算力,跑出开源 5.74 倍的性能

1. 开源Apache Flink 已成为业界流计算事实标准,但在极端重负载场景下存在性能瓶颈。2. 华为大数据Flink通过多项自研深度优化,在执行计划、算子执行、状态存储三个层面构建协同的优化体系。3. Nexmark Benchmark 测试结果:整体性能提升 5.74 倍,极端重负载场景性能领先最高 18.3 倍。4. 100% 兼容 Apache Flink 1.20,业务代码零改造,无缝迁移。

华为云官方博客 396

LakeAgent实战 | 业务分析篇从一句提问到业务分析

本文以“订单金额变化”分析为例,展示LakeAgent如何通过自然语言提问,结合DataArtsStudio的数据资产与专业技能,帮助业务人员快速定位数据、生成SQL、追踪血缘、生成报告。从问题出发,逐步实现数据发现、变化洞察、原因追溯与团队协作,最终形成可复用的分析流程与企业规则,显著提升数据分析效率与一致性。

华为云官方博客 405

华为云RDS Supabase AI应用已开放公测 :30分钟搭建AI应用后端

认证、存储、实时推送、数据库API——4个后端模块,传统开发需要数周。今天,你只需要30分钟。AI创业公司的全栈开发工程师。上周老板说"下周要上线的AI对话应用,后端你来搞"——认证鉴权、数据库接口、文件存储、实时推送,每一个模块都需要数周搭建,而市场不会等你。小张打开华为云RDS Supabase,30分钟搭好认证、数据库API、对象存储,剩下的时间全用来打磨AI交互体验。基于开源Supabase+华为云RDS PostgreSQL全托管能力,为开发者提供。

华为云官方博客 411

如何使用RDS Supabase后端BaaS能力:数据库函数(Database Function)

上一篇介绍了 Database Data API——建表即自动生成增删改查接口,解决单表读写,但聚合统计、跨表事务、字段自动维护等逻辑已超出其能力边界。本篇推进到数据库函数(Database Function):把业务逻辑封装进数据库,前端通过 .rpc() 调用,由触发器自动响应数据变更。上一篇中,小张基于 Data API 完成了产品目录的建表与基础读写。但新需求随之而来:按分类统计产品数与价格区间、上架新品同时写产品表与定价表、产品修改后自动刷新更新时间。

华为云官方博客 477

如何使用RDS Supabase后端BaaS能力:创表即生成API(Database Data API)

认证、存储、实时推送、数据库API——4个后端模块,传统开发要数周。本系列逐个拆解,首篇聚焦数据库API(Database Data API):建表即得 API,无需手写后端。小张,AI创业公司的全栈工程师。老板让他做个产品目录页,展示产品与价格、支持上下架。传统做法要搭后端、写接口、配权限,工期少说1-2周;而在华为云RDS Supabase,建两张表、应用 SDK 直连,几分钟增删改查全跑通。

华为云官方博客 489

从一句话到一个能出去的链接,AI开发者空间做了什么

自行搭建的 Agent、正在使用的开源项目、团队既有的工具,都可以接入,可以通过AI创建或者手动搭建环境;华为云 AI开发者空间——面向开发者的云端一站式开发平台,做的就是把这段路接上:环境免安装,浏览器打开即为完整的 Linux 运行环境,预置的 AI 智能体开箱即用。第一个任务建议选能出结果的:做一个游戏、生成一个页面、创建一台实例,从需求走到可访问的链接,一次就能看清这个环境在做什么。沙箱是一个完整的 Linux 环境,依赖、服务、端口都是真实的,不是模拟。环境释放后,权限随之失效。

华为云官方博客 435

华为云码道配置自定义大模型,四种方式完整实操

案例介绍。

华为云官方博客 652

图数据库:实现穿透式监管的数据基座

穿透式监管标志着国企监管从“管企业”向“管资本”转型过程中的关键一跃。而图数据库正是这一跃的技术支点。从股权穿透到资金链穿透,从供应链穿透到数据穿透,华为GES图数据库正在将“穿透式监管”从理念变为可落地、可操作的实践。无论是天眼查式的全量链路查询,还是某集团财经的税务规则判断,抑或是芯片供应链式的部件风险分析,乃至通过Palantir构建决策知识图谱,其底层逻辑都是一致的——用图的力量,穿透一切形式的“隔离层”,直抵风险本质与责任核心。

华为云官方博客 671

《公共云三十问》正式收官,奔赴企业AI百场景新征程

今年6月底,公共云产业联盟重点推出《公共云三十问》专栏,以每周三问的节奏,连载十周,解读《先进公共云》白皮书,分享国计民生系列案例,旨在凝聚共识、推动落地实践。同时,专栏分析公共云在产业升级、民生福祉、科技创新、全球发展等方面的作用,梳理中国特色公共云发展路径:以普惠云拓展用云广度,以智算云提升用云深度,以自主云夯实用云厚度,以全球云打开用云跨度。这十问从专属云、行业云切入,深入政务、金融、交通、电力、钢铁、化工、油气、制造等国计民生场景,回答公共云“怎么用”。

华为云官方博客 476

开发者小技巧|IAM配置,让码道代码智能体连续30天免登录

案例介绍。

华为云官方博客 652

码道深度对接CodeArts,让需求自动落地为代码

案例介绍。

华为云官方博客 725

【公共云三十问 之三十】拥抱AI,企业如何建设面向智能体的专属云?

企业可分阶段建设覆盖开发、运行、运营及安全的一体化智能体平台——从构建一站式、高低码协同的智能体开发平台,到打造高性能、极致弹性的运行时环境,再到搭建AgentOps驱动的持续运营与运维体系,同时构建端到端、多层次的全链路安全防护体系。在数据湖建设方面,遵循“存量复用、平滑演进、AI导向、分步迭代”原则,分三阶段推进——打造AI多模数据湖核心能力、完成存算分离与统一元数据管理、实现闭环赋能全面支撑智能体规模化落地,在保护既有投资的前提下将传统数据平台转型为AI数据专属供给平台。

华为云官方博客 826

【公共云三十问 之二十九】国计民生之制造:制造云如何重塑数智时代的新质生产力?

平台打通软件交付的完整路径,覆盖需求管理、代码托管、代码检查、编译构建、制品仓库、部署、测试等关键环节,支持大模型能力融入研发全流程,实现从需求到交付的端到端管理。通过构建“研发一朵云”,方案打破地域与组织壁垒,实现跨团队协同开发,有效缩短软件交付周期,助力工业制造企业从“传统研发”走向“敏捷研发”,加速数智化转型进程。当制造云真正成为数据流通的平台、AI创新的底座,公共云的社会价值将从基础设施层向生产场景层持续延伸,为新型工业化建设和制造强国战略注入源源不断的动力,重塑数智时代的中国制造新质生产力。

华为云官方博客 797

告别重复手工迁仓,码道MCP+Skill实现仓库批量迁移

案例介绍。

华为云官方博客 794

【公共云三十问 之二十八】国计民生之油气:智算云如何叩响数智时代的“地心蓝金”?

西南油气田以“向地球深部要资源”为战略方向,联合以华为云Stack为代表的公共云服务商共同打造统一算力底座,建设西南区域数据湖与通用技术平台,构建“勘探开发工程技术、天然气生产过程管控、天然气产运储销”等三个一体化协同应用场景,支撑油气勘探、开发生产、管输储运等全业务链的数智化转型。当智算云真正成为数据流通的平台、AI创新的底座,油气田得以将算力效能、数据价值与智能技术深度融入勘探开发全链条,将“看不见的算力”转化为“摸得着的储量”,以智能化手段持续降低勘探风险、缩短发现周期、提高采收效率,确保生产安全。

华为云官方博客 613

【公共云三十问 之二十七】国计民生之化工:数智云如何重塑传统化工新范式?

在架构方面,方案构建云边协同的统一体系,涵盖AI协同、数据协同与运营协同三大维度——总部集中训练大模型,边缘节点负责推理执行,云边持续迭代,实现“边用边学”的智能闭环,模型平均精度提升20%以上。此外,方案提供一站式企业级工业物联网平台、数据湖与数据治理平台,覆盖工业数据分析“采、存、算、管、用”全流程,打通生产现场与管理系统间的数据壁垒,有效消除数据孤岛。层面,方案充分发挥软硬协同优势,实现计算、存储、网络与云平台的深度协同,训练线性度超95%,为大模型训练推理提供强劲算力支撑。▲化工“数智”新模式。

华为云官方博客 666

【公共云三十问 之二十六】国计民生之钢铁:数智云如何淬炼中国钢铁新力量?

同时,构建云边端协同的统一架构,支撑集团总部与各生产基地两级协同发展——总部集中训练大模型,边缘节点负责推理执行,云边持续迭代,实现训推一体化的资源调度与高效协同,为钢铁行业的数智化转型构建了坚实的算力底座。层面,方案构建覆盖“工业数采→边缘IT/OT融合→统一数据湖→数据治理平台→数据应用”全链路的一站式数据治理与流通平台,打通生产现场与管理系统间的数据壁垒,让数据“采得到、流得动、用得好”,加速数据价值从生产现场向经营决策层流动释放。湘潭钢铁集团的钢铁数智云,是钢铁工业智能云建设的标杆案例。

华为云官方博客 526

LakeWatch——MRS 智能运维Agent

从资源池、队列、作业等多个维度,对集群CPU与内存资源进行精细化分析与对比,直观呈现不同时间段的空闲、满载等使用状态,识别资源浪费,指导治理优化,为扩缩容决策提供数据支撑。对HDFS存储进行多维度深度分析(目录、用户、用户组等),涵盖使用量、增量、文件大小分布及数据热度等指标,帮助快速识别增长较快的目录、长期未访问的文件,统计目录文件数量与小文件占比,评估HDFS总存储量与扩缩容需求,为存储治理与资源规划提供全面数据支撑。Agent主动巡检,识别异常趋势并提前预警,让运维从"事后处理"转向"事前预防"。

华为云官方博客 517

华为云专题文档发布:丰富的AI案例、选型指导和概念解读

发布 “云服务选型”、“云计算概念”专题,提供云服务选型指导,助您选择匹配业务的云服务,解读云计算相关概念,开启云上学习之路。开发者工具和文档专区上线,提供从学习、实践到反馈的全链路支持。帮助中心新增100余篇AI案例。

华为云官方博客 286

一个人,也能用AI做点“星东西”

华为云星耀创想者大赛-2026华为云OPC创意大赛等你来~

华为云官方博客 293

从需求到可执行工作项:MCP+Skill 让智能体规划真正落地

回顾整个体验,以前让智能体帮我拆需求,它是洋洋洒洒给我列了一大篇 Markdown,看着挺像那么回事,但最后还是得我一条条往 CodeArts Req 里搬,搬完再手动挂父子关系、排日期,拆需求五分钟,搬运两小时。现在好了,MCP 给智能体接上了"手",Skill 给它装上了"项目经理的脑子",一句话下去,34 个工作项连带排期、层级关系全给我建好了,甘特图一拉,齐刷刷都在两周内,节省了多少工作量啊,美滋滋。本次实操在码道代码智能体基础上,构建了一套"需求→可执行工作项"的自动化规划方案。

华为云官方博客 579

华为云码道「码力续航计划」更新!

✅上新GLM‑5.3‑Flash,高速响应,代码生成、工程解析、Agent调试高效输出。新增GLM‑5.3‑Flash福利模型,每日解锁1000万免费Tokens。● 本次活动共发放总量价值100万元Tokens,发完即止!把耗算力的编码重活,交给华为云码道代码智能体🚀🚀。● 每日额度准时刷新,当日清零、次日满血重置。✅复杂算法、大项目解析、批量代码生成随便跑。✅不用抠额度、不用算消耗,放开调试大胆迭代。✅无需额外操作,登录即送,直接切换模型使用。● 把算力交给码道,让撸码不再内耗👏🏻。

华为云官方博客 698

【公共云三十问 之二十四】国计民生之交通:交通云如何铺就数智通衢新坦途?

交通行业作为支撑实体经济的关键基础设施,涵盖公路、铁路、机场、港口、地铁等众多子领域,其中,公路网络作为综合交通运输体系的基础骨架,承担着全国超过70%的客货运量,其数字化、智能化转型的需求尤为迫切。方面,提供Agent开发框架、知识库管理、RAG工程、意图识别、静态应用编排及模型评测等能力,支持客户将行业知识、业务流程与AI能力深度融合,快速构建面向收费稽核、路网调度、应急处置等场景的智能应用。开发并实现落地应用,全面覆盖建设、管理、养护、运营、服务、安全、办公七大业务领域。

华为云官方博客 466

【公共云三十问 之二十五】国计民生之电力:电力云如何点亮数智电力新引擎?

方案构建了覆盖数据获取、质量评估到标准化处理的全链路能力。基于公共云服务商智算底座及气象大模型,通过时空图神经网络重新建模产流机制,中国华电建成超50TB多源融合数据集,突破时空建模与机理融合等五大关键技术,短期径流预测精度较传统机理模型提升5个百分点以上,实现15天中期径流预测精度超85%,推理效率达秒级。基于气象大模型的基础架构与预训练能力,客户可直接在大模型之上开展增量训练与微调,充分利用场站所在区域的高精度历史数据(如3公里、1公里分辨率),针对不同场站和区域的地形地貌与气候特征进行模型调优。

华为云官方博客 382
上一篇: GaussDB(DWS)查询过滤器原理与应用
下一篇: 大赛报名 | 2023 MindSpore量子计算黑客松全国大赛正式开启,速来挑战!
华为云开发者联盟
华为云开发者联盟 企业官方账号 企业官方账号
博客等级 码龄10年 72万+粉丝 5985原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值