Java常用注解扩展对比举例详解

更新时间：2025年03月25日 09:49:44 作者：猿享天开

这篇文章主要介绍了Java常用注解扩展对比的相关资料,提供了丰富的代码示例,并总结了最佳实践建议,帮助开发者更好地理解和应用这些注解,需要的朋友可以参考下

一、@Controller 与 @RestController 对比
二、使用 @Data 与不使用 @Data 对比
三、使用 @TableName 与不使用 @TableName 对比
四、依赖注入注解对比
五、Spring MVC 参数绑定注解对比
六、JPA/Hibernate 映射注解对比
七、Spring Boot 配置注解对比
八、Lombok 注解对比
九、事务管理注解对比
十、测试相关注解对比

综合对比总结表
最佳实践建议

总结

一、@Controller 与 @RestController 对比

对比维度	@Controller	@RestController
定义	Spring MVC 的基础控制器注解	`@Controller` + `@ResponseBody` 的组合注解
返回值处理	返回视图名称（需配合视图解析器）	直接返回JSON/XML数据（自动添加 `@ResponseBody`）
适用场景	传统MVC架构（如JSP/Thymeleaf页面渲染）	RESTful API开发（前后端分离场景）
HTTP响应头	`Content-Type: text/html`（默认）	`Content-Type: application/json`（默认）
代码示例	```java	```java
	@Controller	@RestController
	public class WebCtrl {	public class ApiCtrl {
	@GetMapping(“/page”)	@GetMapping(“/data”)
	public String page() {	public User data() {
	return “index”; // 返回视图名	return userService.findUser(); // 自动转JSON
	}	}
	}	}

二、使用 @Data 与不使用 @Data 对比

对比维度	使用 @Data	不使用 @Data
代码量	自动生成以下方法： - 所有字段的getter/setter - `toString()`- `equals()`/`hashCode()`	需手动编写所有方法
维护性	字段增减时无需修改方法	字段变更需同步修改相关方法
继承关系处理	需显式添加 `@EqualsAndHashCode(callSuper=true)` 包含父类字段	手动编写时可直接控制是否包含父类字段
框架兼容性	依赖Lombok插件（需IDE支持）	无额外依赖
代码示例	```java	```java
	@Data	public class User {
	public class User {	private Long id;
	private Long id;	private String name;
	private String name;
	// 自动生成所有方法	// 手动编写getter/setter
	}	public Long getId() { return id; }
		public void setId(Long id) { this.id = id; }
		// …其他方法
		}

注意事项：

使用 @Data 时，若类有继承关系，需添加 @EqualsAndHashCode(callSuper=true)
某些场景（如JPA实体类）需显式定义无参构造器（通过 @NoArgsConstructor）

三、使用 @TableName 与不使用 @TableName 对比

对比维度	使用 @TableName	不使用 @TableName
表名映射规则	显式指定数据库表名（如 `@TableName("sys_user")`）	按MyBatis-Plus默认规则映射：类名驼峰转下划线（如 `SysUser` → `sys_user`）
适用场景	1. 表名含特殊字符（如 `user-info`） 2. 类名与表名无对应关系	类名与表名严格遵循驼峰转下划线规则
全局配置覆盖	优先级高于全局配置	可通过配置文件统一设置表名前缀： `mybatis-plus.global-config.db-config.table-prefix=sys_`
代码示例	```java	```java
	@Data	@Data
	@TableName(“sys_user”) // 显式指定表名	public class SysUser { // 默认映射为 sys_user
	public class User {	private Long id;
	private Long id;	}
	}

注意事项：

表名包含SQL关键字时需转义：@TableName("order")
分表场景可通过动态表名处理器（TableNameHandler）实现

四、依赖注入注解对比

注解对	核心区别	使用场景
@Autowired vs @Resource	- `@Autowired`（Spring）按类型注入 - `@Resource`（JSR-250）按名称注入	明确指定Bean名称时用`@Resource`，优先使用构造器注入时用`@Autowired`
@Primary vs @Qualifier	- `@Primary`标记首选Bean - `@Qualifier`指定具体Bean名称	存在多个相同类型Bean时，优先使用`@Primary`，需精确控制时用`@Qualifier`

代码示例：

// @Autowired + @Qualifier
@Autowired 
@Qualifier("mysqlDataSource")
private DataSource dataSource;

// @Resource
@Resource(name = "oracleDataSource")
private DataSource dataSource;

五、Spring MVC 参数绑定注解对比

注解对	核心区别	使用场景
@RequestParam vs @PathVariable	- `@RequestParam`获取URL参数 - `@PathVariable`获取URI模板变量	RESTful风格URL用`@PathVariable`，传统表单参数用`@RequestParam`
@ModelAttribute vs @RequestBody	- `@ModelAttribute`绑定Form表单数据 - `@RequestBody`绑定JSON请求体	表单提交用`@ModelAttribute`，API接口传输复杂对象用`@RequestBody`

代码示例：

// PathVariable
@GetMapping("/users/{id}")
public User getUser(@PathVariable Long id) { ... }

// RequestBody
@PostMapping("/users")
public ResponseEntity<?> createUser(@RequestBody UserDTO userDTO) { ... }

六、JPA/Hibernate 映射注解对比

注解对	核心区别	使用场景
@Entity vs @Table	- `@Entity`声明JPA实体类 - `@Table`指定数据库表名	类名与表名不一致时使用`@Table`
@Column vs @Transient	- `@Column`映射数据库列 - `@Transient`标记非持久化字段	字段需要特殊列名或类型时用`@Column`，临时计算字段用`@Transient`
@OneToMany vs @ManyToOne	- 定义一对多/多对一关系	根据业务关系方向选择（部门-员工：部门用`@OneToMany`，员工用`@ManyToOne`）

代码示例：

@Entity
@Table(name = "departments")
public class Department {
    @OneToMany(mappedBy = "department")
    private List<Employee> employees;
}

@Entity
public class Employee {
    @ManyToOne
    @JoinColumn(name = "dept_id")
    private Department department;
}

七、Spring Boot 配置注解对比

注解对	核心区别	使用场景
@Value vs @ConfigurationProperties	- `@Value`注入单个属性 - `@ConfigurationProperties`批量绑定属性	简单配置用`@Value`，复杂配置对象用`@ConfigurationProperties`
@Profile vs @Conditional	- `@Profile`按环境激活配置 - `@Conditional`按条件创建Bean	多环境配置用`@Profile`，动态装配逻辑用`@Conditional`

配置示例：

# application.yml
app:
  security:
    enabled: true
    timeout: 300

代码实现：

@Configuration
@ConfigurationProperties(prefix = "app.security")
public class SecurityConfig {
    private boolean enabled;
    private int timeout;
    // getters/setters
}

八、Lombok 注解对比

注解对	核心区别	使用场景
@Data vs @Value	- `@Data`生成可变对象 - `@Value`生成不可变对象（final字段）	需要修改字段值时用`@Data`，只读数据传输对象用`@Value`
@Builder vs @AllArgsConstructor	- `@Builder`支持链式构建 - `@AllArgsConstructor`生成全参构造器	复杂对象构建用`@Builder`，依赖注入全参构造用`@AllArgsConstructor`

代码示例：

@Value
@Builder
public class ImmutablePoint {
    private final int x;
    private final int y;
}

// 使用
ImmutablePoint point = ImmutablePoint.builder().x(10).y(20).build();

九、事务管理注解对比

注解对	核心区别	使用场景
@Transactional vs @Modifying	- `@Transactional`声明事务边界 - `@Modifying`标记DML操作	服务层方法用`@Transactional`，JPA更新查询用`@Modifying`

代码示例：

@Service
public class UserService {
    @Transactional
    public void updateUser(User user) {
        userRepository.save(user);
    }
}

@Repository
public interface UserRepository extends JpaRepository<User, Long> {
    @Modifying
    @Query("UPDATE User u SET u.name = ?1 WHERE u.id = ?2")
    int updateNameById(String name, Long id);
}

十、测试相关注解对比

注解对	核心区别	使用场景
@Mock vs @MockBean	- `@Mock`（Mockito）创建模拟对象 - `@MockBean`（Spring Boot Test）替换Spring容器中的Bean	单元测试用`@Mock`，集成测试用`@MockBean`
@SpringBootTest vs @WebMvcTest	- `@SpringBootTest`加载完整上下文 - `@WebMvcTest`仅加载Web层组件	全集成测试用`@SpringBootTest`，控制层隔离测试用`@WebMvcTest`

测试示例：

// 全集成测试
@SpringBootTest
class UserServiceIntegrationTest {
    @Autowired
    private UserService userService;
}

// 控制层测试
@WebMvcTest(UserController.class)
class UserControllerTest {
    @MockBean
    private UserService userService;
    @Autowired
    private MockMvc mockMvc;
}

综合对比总结表

功能场景	推荐注解组合	典型应用
REST API开发	`@RestController` + `@RequestBody` + `@Valid`	前后端分离接口开发
JPA实体映射	`@Entity` + `@Table` + `@Column` + `@OneToMany`	数据库表结构映射
配置管理	`@ConfigurationProperties` + `@Profile`	多环境配置切换
测试覆盖	`@SpringBootTest` + `@MockBean` + `@DataJpaTest`（按需选择）	分层测试策略
依赖注入	构造器注入优先，`@Autowired` + `@Qualifier`	避免循环依赖

最佳实践建议

分层使用严格遵循Controller→Service→Repository分层架构，避免跨层注解混用。
注解最小化
- 优先使用框架提供的组合注解（如@RestController代替@Controller+@ResponseBody）
- 避免重复注解（如同时使用@Component和@Service）
Lombok规范
- 实体类统一使用@Data + @Builder
- 禁用无约束的@AllArgsConstructor
事务控制
- Service层统一声明@Transactional(readOnly = true)
- 写操作显式指定@Transactional(rollbackFor = Exception.class)
测试隔离
- 单元测试使用Mockito + JUnit5
- 集成测试按需选择@WebMvcTest或@DataJpaTest

通过系统化的注解对比与组合使用，可显著提高代码规范性和团队协作效率。建议结合SonarLint等代码质量管理工具，确保注解使用的合理性与一致性。

总结

到此这篇关于Java常用注解扩展对比的文章就介绍到这了,更多相关Java常用注解扩展内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

springboot将mybatis升级为mybatis-plus的实现
之前项目工程用的是mybatis,现在需要将其替换为mybatis-plus,本文主要介绍了springboot将mybatis升级为mybatis-plus的实现,具有一定的参考价值,感兴趣的可以了解一下
2023-09-09
Java和MySQL数据库中关于小数的保存问题详析
在Java和MySQL中小数的精度可能会受到限制,如float类型的小数只能精确到6-7位,double类型也只能精确到15-16位,这篇文章主要给大家介绍了关于Java和MySQL数据库中关于小数的保存问题,需要的朋友可以参考下
2024-01-01
将Java程序包打包为.exe文件的操作步骤
将Java程序打包为为.exe文件分为俩个步骤：将Java程序打包成Jar包和打包为.exe文件,文中通过图文结合的方式给大家讲解的非常详细,具有一定的参考价值,需要的朋友可以参考下
2024-06-06
SpringCloud的Hystrix简单介绍
这篇文章主要介绍了SpringCloud的Hystrix简单介绍,SpringCloud Hystrix是Netflix开源的一款容错框架，具备服务降级，服务熔断，依赖隔离，监控(Hystrix Dashboard)等功能,同样具有自我保护能力,需要的朋友可以参考下
2023-07-07
Spring Cloud Hystrix 服务容错保护的原理实现
这篇文章主要介绍了Spring Cloud Hystrix 服务容错保护的原理实现，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2019-05-05
SpringBoot如何使用redis
文章主要介绍了如何在Spring Boot项目中配置Redis并解决乱码问题,同时提供了使用Redis操作不同类型数据（如String、List、Hash、Set、ZSet和Bitmap）的代码示例
2025-03-03
SpringBoot整合Freemarker的基本步骤
这篇文章主要介绍了SpringBoot整合Freemarker的基本步骤,添加依赖及添加相关配置的实例代码详解，代码简单易懂，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2022-02-02
Java操作MinIO实现文件的上传和删除
本文主要介绍如何将本地Java项目resources目录下的一个PNG图片上传到MinIO，然后将上传的图片删除，文中有详细的流程步骤和示例代码,需要的朋友可以参考下
2023-06-06
教你使用springboot配置多数据源
发现有很多小伙伴还不会用springboot配置多数据源,今天特地给大家整理了本篇文章,文中有非常详细的图文介绍及代码示例,对正在学习java的小伙伴很有帮助,需要的朋友可以参考下
2021-05-05
Spring IOC简单理解及创建对象的方式
这篇文章主要介绍了Spring IOC简单理解及创建对象的方式,本文通过两种方式给大家介绍创建对象的方法，通过实例代码给大家介绍的非常详细，需要的朋友可以参考下
2021-09-09