住房和城乡建设部网站职责东莞网络营销全网推广
搞个引言
在现代 Java 开发中，Spring Boot 凭借其便捷性和高效性成为了众多开发者的首选框架。而注解作为 Spring Boot 的核心特性之一，极大地简化了开发过程，提高了代码的可读性和可维护性。本文将深入探讨 Spring Boot 中几种重要的注解，帮助你全面理解它们的作用和使用场景。
一、Spring Boot 启动注解
1.1 @SpringBootApplication
@SpringBootApplication 是 Spring Boot 应用中最常用的注解之一，它是一个组合注解，包含了 @SpringBootConfiguration、@EnableAutoConfiguration 和 @ComponentScan。
1.1.1 @SpringBootConfiguration
@SpringBootConfiguration 继承自 @Configuration，用于标记当前类是一个 Spring 的配置类。配置类就像是一个 XML 配置文件的 Java 版本，它可以包含多个 Bean 的定义。
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;@SpringBootApplication
public class MyApplication {public static void main(String[] args) {SpringApplication.run(MyApplication.class, args);}@Beanpublic MyService myService() {return new MyService();}
}class MyService {public void doSomething() {System.out.println("Doing something...");}
}
1.1.2 @EnableAutoConfiguration
@EnableAutoConfiguration 是 Spring Boot 自动配置的核心注解。它会根据类路径下的依赖和配置，自动为应用配置合适的 Bean。例如，如果类路径下存在 Spring Data JPA 的依赖，Spring Boot 会自动配置数据源和 JPA 相关的 Bean。
1.1.3 @ComponentScan
@ComponentScan 用于指定 Spring 扫描组件的包路径。Spring 会自动扫描指定包及其子包下的所有带有 @Component、@Service、@Repository 和 @Controller 等注解的类，并将它们注册为 Spring Bean。
1.2 @Enable* 系列注解
除了 @EnableAutoConfiguration，Spring Boot 还有许多以 @Enable 开头的注解，用于启用特定的功能。
1.2.1 @EnableScheduling
@EnableScheduling 用于启用 Spring 的定时任务功能。在配置类上添加该注解后，就可以使用 @Scheduled 注解来定义定时任务。
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.scheduling.annotation.EnableScheduling;
import org.springframework.scheduling.annotation.Scheduled;@SpringBootApplication
@EnableScheduling
public class ScheduledTaskApplication {public static void main(String[] args) {SpringApplication.run(ScheduledTaskApplication.class, args);}@Scheduled(fixedRate = 5000) // 每 5 秒执行一次public void performTask() {System.out.println("Task is running...");}
}
1.2.2 @EnableAsync
@EnableAsync 用于启用 Spring 的异步方法执行功能。在配置类上添加该注解后，就可以使用 @Async 注解来标记异步方法。
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.scheduling.annotation.EnableAsync;
import org.springframework.scheduling.annotation.Async;
import org.springframework.stereotype.Service;@SpringBootApplication
@EnableAsync
public class AsyncApplication {public static void main(String[] args) {SpringApplication.run(AsyncApplication.class, args);}
}@Service
class MyAsyncService {@Asyncpublic void asyncMethod() {try {Thread.sleep(3000);System.out.println("Async method completed.");} catch (InterruptedException e) {e.printStackTrace();}}
}
二、组件扫描与 Bean 定义注解
2.1 @Component、@Service、@Repository 和 @Controller
这些注解都用于标记一个类为 Spring 的组件，它们的区别主要在于语义上的不同。
2.1.1 @Component
@Component 是一个通用的组件注解，用于标记任何 Spring 管理的组件。当一个类没有明确的角色时，可以使用 @Component 注解。
import org.springframework.stereotype.Component;@Component
public class MyComponent {public void doSomething() {System.out.println("MyComponent is doing something.");}
}
2.1.2 @Service
@Service 用于标记业务逻辑层的服务类。它是 @Component 的一个特殊化注解，主要用于表示服务层的组件。
import org.springframework.stereotype.Service;@Service
public class UserService {public void saveUser() {System.out.println("Saving user...");}
}
2.1.3 @Repository
@Repository 用于标记数据访问层的类，通常用于与数据库交互的 DAO（Data Access Object）类。它也是 @Component 的一个特殊化注解，并且 Spring 会自动处理 @Repository 注解类抛出的异常。
import org.springframework.stereotype.Repository;@Repository
public class UserRepository {public void saveUserToDatabase() {System.out.println("Saving user to database...");}
}
2.1.4 @Controller
@Controller 用于标记控制器类，负责处理 HTTP 请求。它也是 @Component 的一个特殊化注解，通常与 Spring MVC 框架一起使用。
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.ResponseBody;@Controller
public class HelloController {@GetMapping("/hello")@ResponseBodypublic String hello() {return "Hello, Spring Boot!";}
}
2.2 @Configuration 和 @Bean
2.2.1 @Configuration
@Configuration 用于标记一个类为配置类，它可以包含多个 @Bean 注解的方法，用于定义 Spring Bean。
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Bean;@Configuration
public class AppConfig {@Beanpublic MyBean myBean() {return new MyBean();}
}class MyBean {public void doSomething() {System.out.println("MyBean is doing something.");}
}
2.2.2 @Bean
@Bean 用于在配置类中定义一个 Bean。它可以将一个方法的返回值注册为 Spring 容器中的 Bean。
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;@Configuration
public class AnotherConfig {@Beanpublic String myStringBean() {return "This is a string bean.";}
}
三、依赖注入注解
3.1 @Autowired
@Autowired 是 Spring 中最常用的依赖注入注解，它可以自动将 Spring 容器中的 Bean 注入到需要的地方。
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;@Service
public class UserService {private final UserRepository userRepository;@Autowiredpublic UserService(UserRepository userRepository) {this.userRepository = userRepository;}public void saveUser() {userRepository.saveUserToDatabase();}
}
3.2 @Qualifier
当一个接口有多个实现类时，使用 @Autowired 可能会导致歧义。这时可以使用 @Qualifier 注解来指定具体要注入的 Bean。
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Qualifier;
import org.springframework.stereotype.Service;interface MessageService {void sendMessage();
}@Service("emailService")
class EmailService implements MessageService {@Overridepublic void sendMessage() {System.out.println("Sending email...");}
}@Service("smsService")
class SmsService implements MessageService {@Overridepublic void sendMessage() {System.out.println("Sending SMS...");}
}@Service
public class MessageSenderService {private final MessageService messageService;@Autowiredpublic MessageSenderService(@Qualifier("emailService") MessageService messageService) {this.messageService = messageService;}public void send() {messageService.sendMessage();}
}
3.3 @Resource
@Resource 是 Java 标准的依赖注入注解，它可以根据名称或类型进行注入。默认情况下，它会根据名称进行注入。
import javax.annotation.Resource;
import org.springframework.stereotype.Service;@Service
public class ResourceInjectionService {@Resource(name = "emailService")private MessageService messageService;public void sendMessage() {messageService.sendMessage();}
}
四、Spring MVC 注解
4.1 @RestController
@RestController 是 @Controller 和 @ResponseBody 的组合注解，用于标记一个类为 RESTful 风格的控制器。它会自动将控制器方法的返回值转换为 JSON 或 XML 等格式返回给客户端。
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;@RestController
public class RestfulController {@GetMapping("/data")public String getData() {return "{\"name\": \"John\", \"age\": 30}";}
}
4.2 @RequestMapping、@GetMapping、@PostMapping 等
4.2.1 @RequestMapping
@RequestMapping 是一个通用的请求映射注解，用于将 HTTP 请求映射到控制器的方法上。它可以指定请求的路径、请求方法（如 GET、POST 等）、请求参数等。
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;@RestController
@RequestMapping("/api")
public class RequestMappingController {@RequestMapping(value = "/hello", method = RequestMethod.GET)public String hello() {return "Hello, RequestMapping!";}
}
4.2.2 @GetMapping、@PostMapping 等
@GetMapping、@PostMapping、@PutMapping、@DeleteMapping 等是 @RequestMapping 的简化注解，分别对应 HTTP 的 GET、POST、PUT、DELETE 请求方法。
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RestController;@RestController
@RequestMapping("/api")
public class SimplifiedMappingController {@GetMapping("/get")public String get() {return "This is a GET request.";}@PostMapping("/post")public String post() {return "This is a POST request.";}
}
4.3 @RequestBody 和 @RequestParam
4.3.1 @RequestBody
@RequestBody 用于将 HTTP 请求的 body 部分绑定到方法的参数上。通常用于处理 JSON 或 XML 格式的请求数据。
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;class User {private String name;private int age;// Getters and setterspublic String getName() {return name;}public void setName(String name) {this.name = name;}public int getAge() {return age;}public void setAge(int age) {this.age = age;}
}@RestController
@RequestMapping("/users")
public class UserController {@PostMappingpublic String createUser(@RequestBody User user) {return "User created: " + user.getName() + ", " + user.getAge();}
}
4.3.2 @RequestParam
@RequestParam 用于从 HTTP 请求的参数中获取值，并绑定到方法的参数上。
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;@RestController
@RequestMapping("/search")
public class SearchController {@GetMappingpublic String search(@RequestParam String keyword) {return "Searching for: " + keyword;}
}
五、数据访问注解
5.1 @Entity 和 @Table
5.1.1 @Entity
@Entity 用于标记一个类为 JPA 实体类，该类对应数据库中的一张表。
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;@Entity
public class Product {@Id@GeneratedValue(strategy = GenerationType.IDENTITY)private Long id;private String name;private double price;// Getters and setterspublic Long getId() {return id;}public void setId(Long id) {this.id = id;}public String getName() {return name;}public void setName(String name) {this.name = name;}public double getPrice() {return price;}public void setPrice(double price) {this.price = price;}
}
5.1.2 @Table
@Table 用于指定实体类对应的数据库表名。如果不指定，默认表名与实体类名相同。
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
import javax.persistence.Table;@Entity
@Table(name = "products")
public class Product {// 同上
}
5.2 @Column 和 @Id
5.2.1 @Column
@Column 用于指定实体类的属性对应数据库表的列名。如果不指定，默认列名与属性名相同。
import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;@Entity
@Table(name = "products")
public class Product {@Id@GeneratedValue(strategy = GenerationType.IDENTITY)private Long id;@Column(name = "product_name")private String name;private double price;// Getters and setters
}
5.2.2 @Id
@Id 用于标记实体类的属性为主键。
5.3 @Repository
在数据访问层，@Repository 注解用于标记 DAO 类，并且 Spring 会自动处理该类抛出的异常。
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.stereotype.Repository;
import com.example.demo.entity.Product;@Repository
public interface ProductRepository extends JpaRepository<Product, Long> {
}
六、AOP 注解
6.1 @Aspect
@Aspect 用于标记一个类为切面类，该类可以包含多个通知方法。
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.annotation.Before;
import org.springframework.stereotype.Component;@Aspect
@Component
public class LoggingAspect {@Before("execution(* com.example.demo.service.*.*(..))")public void beforeAdvice() {System.out.println("Before method execution...");}
}
6.2 @Before、@After、@Around 等
6.2.1 @Before
@Before 是一个前置通知注解，用于在目标方法执行之前执行通知方法。
6.2.2 @After
@After 是一个后置通知注解，用于在目标方法执行之后执行通知方法，无论目标方法是否抛出异常。
6.2.3 @Around
@Around 是一个环绕通知注解，它可以在目标方法执行前后都进行增强处理，并且可以控制目标方法是否执行。
import org.aspectj.lang.ProceedingJoinPoint;
import org.aspectj.lang.annotation.Around;
import org.aspectj.lang.annotation.Aspect;
import org.springframework.stereotype.Component;@Aspect
@Component
public class AroundAspect {@Around("execution(* com.example.demo.service.*.*(..))")public Object aroundAdvice(ProceedingJoinPoint joinPoint) throws Throwable {System.out.println("Before method execution...");Object result = joinPoint.proceed();System.out.println("After method execution...");return result;}
}
七、总结
Spring Boot 中的注解为开发者提供了强大而便捷的功能呀，通过合理使用这些注解，可以大大简化开发过程，提高代码的质量和可维护性。你学费啦吗！
✍结尾
🀙🀚🀛🀜🀝🀞🀟🀠🀡🀐🀑🀒🀓🀔🀕🀖🀘🀗🀏🀎🀍🀌🀋🀊🀉🀈🀇🀆🀅🀃🀂🀁🀀🀄︎🀢🀣🀥🀤🀦🀧🀨🀩🀪
📘 妹妹听后点了点头，脸上露出了满意的笑容。她轻声说道：“原来如此，谢谢你，鸽鸽。看来我不仅要多读书，还要多动手实践，提升自己才行。”
看着她那充满求知欲的眼神，我不禁感叹，学习之路虽然充满挑战，但有这样一位美丽聪慧的伙伴相伴，一切都变得格外有意义。快去和妹妹一起实践一下吧！
📘相关阅读⚡⚡
笔者 綦枫Maple 的其他作品，欢迎点击查阅哦~：
📚Jmeter性能测试大全：Jmeter性能测试大全系列教程！持续更新中！
📚UI自动化测试系列： Selenium+Java自动化测试系列教程❤
📚移动端自动化测试系列：Appium自动化测试系列教程
📚Postman系列：Postman高级使用技巧系列
👨🎓作者：綦枫Maple
🚀博客：CSDN、掘金等
🚀CSDN技术社区：https://bbs.csdn.net/forums/testbean
🚀网易云音乐：https://y.music.163.com/m/user?id=316706413
🚫特别声明：原创不易，转载请附上原文出处链接和本文声明，谢谢配合。
🙏版权声明：文章里可能部分文字或者图片来源于互联网或者百度百科，如有侵权请联系处理。
🀐其他：若有兴趣，可以加文章结尾的Q群，一起探讨学习哦~