Spring Boot 注解详解：一步一步了解Spring Boot的核心注解

前言

Spring Boot是一个强大的框架，它简化了Spring应用程序的创建和开发过程。在Spring Boot中，注解扮演了非常重要的角色，通过各种注解，我们可以轻松地设置和配置Spring应用程序。这篇文章将系统化地讲解Spring Boot中常见和重要的注解，让你更深入地理解Spring Boot。

1. 主要的注解：@SpringBootApplication

我们的入口类一般会被此注解所标注，如下所示：

// 这个是你的Spring Boot的主类
@SpringBootApplication
public class Application {
    // 这是主入口方法
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}
1
2
3
4
5
6
7
8

@SpringBootApplication是一个复合注解，用于标记应用程序的主类。这个注解封装了以下三个注解的功能：

• @Configuration：标记一个类作为bean定义的应用程序上下文。
• @EnableAutoConfiguration：让Spring Boot根据类路径中的jar依赖自动配置应用程序。
• @ComponentScan：Spring将扫描类所在的包以及子包，查找@Component、@Service、@Repository和@Controller等注解。

2. 控制器注解

我们创建一个基本的控制器来查看这些注解的使用：

// @RestController表示这是一个RESTful Web服务
@RestController
// @RequestMapping("/api")映射了类上的所有响应路径
@RequestMapping("/api")
public class MyController {
    // @RequestMapping("/hello")映射到/api/hello
    @RequestMapping("/hello")
    public String hello() {
        return "Hello, Spring Boot!";
    }
}
1
2
3
4
5
6
7
8
9
10
11

3. 服务和组件注解

// @Component标记这个类为Spring的bean
@Component
public class MyComponent {
    public String sayHello() {
        return "Hello, Component!";
    }
}

// @Service更具有语义化，通常用于标记业务逻辑类
@Service
public class MyService {
    public String serve() {
        return "Hello, Service!";
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

4. 依赖注入注解

// RESTful Web服务
@RestController
// 映射响应路径
@RequestMapping("/api")
public class MyController {
    // 自动装配MyService类型的bean到myService字段
    @Autowired
    private MyService myService;

    // 映射到/api/service
    @RequestMapping("/service")
    public String callService() {
        return myService.serve();
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

5. 配置类注解

// 标记这是一个配置类
@Configuration
public class AppConfig {
    // 表示myComponent方法返回的对象应该被Spring注册为一个bean
    @Bean
    public MyComponent myComponent() {
        return new MyComponent();
    }
}
1
2
3
4
5
6
7
8
9

6. Spring Boot 数据库相关注解

在Spring Boot中，往往需要进行数据库的操作，以下是一些相关的注解：

// @Repository标记这是一个持久化层的类，通常与数据库操作相关
@Repository
public class MyRepository {
    // 数据库操作方法
}

// @Entity标记这是一个实体类，用于映射数据库中的表
@Entity
public class MyEntity {
    // 数据库字段和方法
}
1
2
3
4
5
6
7
8
9
10
11

@Repository注解标记这是一个持久化层的类，通常与数据库操作相关。而@Entity注解标记这是一个实体类，用于映射数据库中的表。

7. Spring Boot AOP相关注解

Spring Boot也支持面向切面编程(AOP)，以下是相关的注解：

// @Aspect标记这是一个切面类
@Aspect
public class MyAspect {
    // 切点和通知方法
}

// @Before用于标记一个前置通知，即在目标方法执行前执行的通知
@Before("execution(* com.example.MyService.*(..))")
public void beforeAdvice() {
    // 通知方法体
}

// @After用于标记一个后置通知，即在目标方法执行后执行的通知
@After("execution(* com.example.MyService.*(..))")
public void afterAdvice() {
    // 通知方法体
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

@Aspect注解标记这是一个切面类，而@Before和@After则用于标记前置和后置通知。

8. Spring Boot 配置属性注解

在Spring Boot中，我们常常需要从配置文件中读取一些属性值，以下是相关的注解：

// @ConfigurationProperties用于绑定配置文件中的属性
@ConfigurationProperties(prefix = "my")
public class MyProperties {
    // 配置文件中的属性字段
}
1
2
3
4
5

@ConfigurationProperties注解用于绑定配置文件中的属性，通过设置prefix值，可以指定绑定哪个前缀的属性。

以上是Spring Boot中的一些常见注解的介绍和示例，Spring Boot中还有许多其他的注解，这些注解可以帮助我们更好地开发Spring Boot应用。