当前位置：首页 > article >正文

java——SpringBoot中常用注解及其底层原理

article 2024/11/28 5:33:06

SpringBoot中的注解是简化配置、自动装配组件和实现声明式服务的关键。以下是对SpringBoot中常用注解及其底层原理的详细解析：

常用注解

@SpringBootApplication
- 标注在主程序类上，表示这是一个Spring Boot应用的入口。
- 它是一个复合注解，包括了@Configuration、@EnableAutoConfiguration和@ComponentScan。
```
@SpringBootApplication
public class MyApplication {
    public static void main(String[] args) {
        SpringApplication.run(MyApplication.class, args);
    }
}
```

@EnableAutoConfiguration

启用Spring Boot的自动配置机制，根据添加的依赖和配置文件自动配置Spring应用。

@EnableAutoConfiguration
public class MyApplication {
    public static void main(String[] args) {
        SpringApplication.run(MyApplication.class, args);
    }
}

@Configuration
- 标识一个类作为配置类，相当于传统的Spring XML配置文件。
- 可以包含一个或多个@Bean方法。
```
@Configuration
public class AppConfig {
    @Bean
    public MyService myService() {
        return new MyServiceImpl();
    }
}
```
@ComponentScan
- 指定要扫描的包，以便发现和注册Spring组件。
- 默认情况下，扫描主应用类所在的包及其子包。
```
@ComponentScan(basePackages = "com.example")
public class MyApplication {
}
```
@Component
- 将一个类标识为Spring组件（Bean），可以被Spring容器自动检测和注册。
- 通用注解，适用于任何层次的组件。
```
@Component
public class MyComponent {
}
```
@Service
- 标识服务层组件，实际上是@Component的一个特化，用于表示业务逻辑服务。
```
@Service
public class MyService {
}
```
@Repository
- 标识持久层组件（dao层），实际上是@Component的一个特化，用于表示数据访问组件。
- 常用于与数据库交互。
```
@Repository
public class MyRepository {
}
```
@Controller
- 标识控制层组件，实际上是@Component的一个特化，用于表示Web控制器。
- 处理HTTP请求并返回视图或响应数据。
```
@Controller
public class MyController {
}
```
@RestController
- 标识RESTful Web服务的控制器，实际上是@Controller和@ResponseBody的结合。
- 返回的对象会自动序列化为JSON或XML，并写入HTTP响应体中。
```
@RestController
public class MyRestController {
}
```

@RequestMapping

映射HTTP请求到处理方法上（支持GET、POST、PUT、DELETE等）。

@Controller
public class MyController {
    @RequestMapping("/hello")
    public String sayHello() {
        return "hello";
    }
}

@GetMapping、@PostMapping、@PutMapping、@DeleteMapping

映射HTTP请求到处理方法上，是@RequestMapping的简化版本。

@RestController
public class MyRestController {
/*
@GetMapping("users") 等价于@RequestMapping(value="/users",method=RequestMethod.GET)
@PostMapping("users") 等价于@RequestMapping(value="/users",method=RequestMethod.POST)
@PutMapping("/users/{userId}") 等价于@RequestMapping(value="/users/{userId}",method=RequestMethod.PUT)
*/
@DeleteMapping("/users/{userId}")等价于@RequestMapping(value="/users/{userId}",method=RequestMethod.DELETE)
    @GetMapping("/users")
    public List<User> getUsers() {
        return userService.getAllUsers();
    }
}

@ResponseBody

将方法的返回值转换为指定格式（如JSON、XML）作为HTTP响应的内容返回给客户端。

常用于RESTful服务中。

@RestController
public class MyRestController {
    @GetMapping("/hello")
    @ResponseBody
    public String sayHello() {
        return "Hello, World!";
    }
}

@RequestBody

将HTTP请求体的内容（如JSON、XML）转换为Java对象。

常用于接收前端传递的数据。

@RestController
public class MyRestController {
    @PostMapping("/users")
    public User createUser(@RequestBody User user) {
        return userService.createUser(user);
    }
}

@Autowired

用于自动注入依赖对象。

@Autowired
@Qualifier("baseDao")
private BaseDao baseDao;

@Qualifier
- 用于指定注入特定名称的bean。

底层原理

自动配置：Spring Boot 自动配置的核心在于 @EnableAutoConfiguration。它利用了 Spring 的条件化配置机制（@Conditional），结合 spring.factories 文件中定义的自动配置类列表，根据类路径中是否存在某些特定的类、环境变量等条件来决定是否应用某个配置。
组件扫描：@ComponentScan 注解使得 Spring 能够在指定的包路径下查找带有 @Component, @Service, @Repository, @Controller 等注解的类，并将它们注册为 Spring Bean。
依赖注入：@Autowired 注解的背后是 Spring 的依赖注入机制。Spring 使用反射技术来识别需要注入的字段、构造函数或方法，并从容器中获取合适的 Bean 来完成注入。
条件化配置：@Conditional 及其子注解（如 @ConditionalOnProperty）允许开发者根据特定条件来选择性地激活配置。这使得同一个应用可以根据不同的运行环境（如开发、测试、生产）加载不同的配置。
属性绑定：Spring Boot 支持通过 application.properties 或 application.yml 文件来配置应用属性。这些属性可以通过 @Value 注解直接注入到 Bean 中，或者通过 @ConfigurationProperties 注解与 Java 类绑定，从而实现更复杂的配置管理。