Java 常用注解扩展对比

@Data
public class User {
    private Long id;
    private String name;
    // 自动生成所有方法
}

public class ManualUser {
    private Long id;
    private String name;
    // 手动编写 getter/setter
    public Long getId() { return id; }
    public void setId(Long id) { this.id = id; }
}

注意事项：

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

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

@Data
@TableName("sys_user") // 显式指定表名
public class User {
    private Long id;
}

@Data
public class SysUser { // 默认映射为 sys_user
    private Long id;
}

注意事项：

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

四、依赖注入注解对比

代码示例：

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

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

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

代码示例：

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

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

六、JPA/Hibernate 映射注解对比

代码示例：

@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 配置注解对比

配置示例：

app:
  security:
    enabled: true
    timeout: 300

代码实现：

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

八、Lombok 注解对比

代码示例：

@Value
@Builder
public class ImmutablePoint {
    private final int x;
    private final int y;
}
// 使用 ImmutablePoint point = ImmutablePoint.builder().x(10).y(20).build();

九、事务管理注解对比

代码示例：

@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);
}

十、测试相关注解对比

测试示例：

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

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

综合对比总结表

最佳实践建议

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

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