package com.klszkj.aqscgkpt.module.ship.crewEnterChange.vo; import lombok.*; import java.util.*; import com.fasterxml.jackson.annotation.JsonIgnore; import jakarta.validation.constraints.NotEmpty; import jakarta.validation.constraints.NotNull; import io.swagger.v3.oas.annotations.media.Schema; import com.alibaba.excel.annotation.ExcelIgnoreUnannotated; import com.alibaba.excel.annotation.ExcelProperty; import com.klszkj.aqscgkpt.framework.excel.core.annotations.DictFormat; import com.klszkj.aqscgkpt.framework.excel.core.convert.DictConvert; import com.klszkj.aqscgkpt.framework.common.pojo.PageParam; import org.springframework.format.annotation.DateTimeFormat; import java.time.LocalDateTime;

<think>嗯，用户想了解Java中各种注解的作用，特别是Lombok、验证、Swagger、数据转换等方面的。首先，我需要回忆一下Lombok的常用注解，比如@Data、@Getter、@Setter这些，它们能自动生成代码，减少样板代码。然后，用户提到的jakarta.validation中的@NotEmpty和@NotNull，这些用于参数校验，确保数据有效性。 接下来是Swagger相关的注解，比如@Schema，用来生成API文档，描述模型属性。还有DictFormat和DictConvert，这些可能属于自定义注解，用于数据字典的转换，比如将编码转成文字。ExcelProperty和DateTimeFormat可能跟EasyExcel库相关，处理Excel导入导出时的列映射和日期格式。 然后，LocalDateTime和PageParam可能是用户自定义的类型或注解，需要解释它们的用途。比如PageParam用于分页查询参数。在组织回答时，需要分门别类，把Lombok、验证、Swagger、数据转换等部分分开说明，每个注解给出简洁的作用说明，并附上示例代码。 还要注意用户提供的引用内容，引用1到4都是关于Lombok的@Data、@AllArgsConstructor和@NoArgsConstructor，所以需要重点覆盖这些。同时，用户的问题中还提到了其他注解，比如ToString、Builder、Jakarta Validation的注解，这些也要涵盖进去，确保全面性。 可能用户是在开发Spring Boot应用，使用了Lombok简化实体类，结合Swagger生成API文档，用验证注解做参数校验，以及处理Excel导入导出和数据字典转换。需要确保解释清晰，每个注解的用途和常见使用场景，让用户能够理解如何在自己的项目中应用这些注解。 最后，生成的相关问题要围绕这些注解的扩展使用，比如组合注解的最佳实践、验证注解的其他选项、Swagger的更多用法等，帮助用户深入学习和解决问题。</think># Java注解使用说明及作用详解 ## 一、Lombok注解 ### 1. 代码生成类 - `@Data`：组合注解，自动生成`getter/setter`、`toString()`、`equals()`、`hashCode()`方法[^2][^3] ```java @Data // 等价于@Getter + @Setter + @ToString + @EqualsAndHashCode public class User { private String username; private Integer age; } ``` - `@Getter`/`@Setter`：生成字段的访问器/修改器 - `@NoArgsConstructor`：生成无参构造函数[^1] ```java @NoArgsConstructor // 生成 public User() {} public class User {} ``` - `@AllArgsConstructor`：生成全参构造函数[^4] ```java @AllArgsConstructor // 生成 public User(String username, Integer age) {...} public class User {} ``` - `@Builder`：生成建造者模式构造器 ```java User.builder().username("test").age(18).build(); ``` ### 2. 方法控制类 - `@ToString`：覆盖`toString()`方法 - `@EqualsAndHashCode`：生成`equals()`和`hashCode()`方法 ## 二、验证注解（jakarta.validation） ### 1. 空值校验 - `@NotEmpty`：验证字符串/集合非空 - `@NotNull`：验证对象引用不为null ```java public class LoginDTO { @NotEmpty(message = "用户名不能为空") private String username; @NotNull(message = "密码强度不能为空") private PasswordLevel level; } ``` ### 2. 范围校验 - `@Size`：验证字符串/集合长度 - `@Min`/`@Max`：数值范围校验 - `@Pattern`：正则表达式校验 ## 三、Swagger注解 ### 1. 接口文档 - `@Schema`：描述模型属性/参数 ```java @Schema(description = "用户登录请求体") public class LoginRequest { @Schema(description = "用户名", example = "admin") private String username; } ``` ### 2. 接口标注 - `@Operation`：描述接口操作 - `@Parameter`：描述接口参数 ## 四、数据转换注解 ### 1. 字典转换 - `@DictFormat`：标注字典编码字段 - `@DictConvert`：自动转换编码为文字 ```java @DictFormat(dictType = "user_status") private Integer status; // 1->启用, 0->禁用 ``` ### 2. Excel处理 - `@ExcelProperty`：定义Excel列映射 ```java @ExcelProperty("用户姓名") private String name; ``` ### 3. 时间格式 - `@DateTimeFormat`：定义时间格式 ```java @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss") private LocalDateTime createTime; ``` ## 五、其他实用注解 ### 1. 分页参数 - `@PageParam`：自定义分页参数注解 ```java public Page<User> queryUsers(@PageParam Pageable pageable) { // 分页查询逻辑 } ``` ### 2. 时间类型 - `LocalDateTime`：Java8日期时间类型 ```java private LocalDateTime createTime = LocalDateTime.now(); ```