easyfk-core 核心模块

com.mcst.easyfk.core
├── annotation/               # 注解定义（12个）
├── builders/                 # 构建器（6个）
├── constants/                # 常量定义（4个）
├── context/                  # 线程上下文（3个）
├── dto/                      # 数据传输对象
│   ├── login/                  - 登录相关 DTO
│   ├── page/                   - 分页相关 DTO
│   ├── request/                - 请求相关 DTO
│   ├── response/               - 响应相关 DTO
│   └── validation/             - 校验结果 DTO
├── exception/                # 异常定义
├── function/                 # 函数式接口
└── utils/                    # 工具类
    ├── common/                 - 通用工具
    ├── date/                   - 日期工具
    ├── expression/             - 表达式工具
    └── returns/                - 返回值工具

BaseResult<T>
├── success: Boolean      // 是否成功
├── data: T               // 数据
├── msg: String           // 消息
└── code: String          // 状态码

ResponseResult<T>
├── code: String          // OK/ERROR/UN_LOGIN/UN_AUTH/PARAM_ERROR/BUSYNESS
├── count: Long           // 总条数（分页用）
├── msg: String           // 提示消息
├── data: T               // 数据
└── traceId: String       // 链路追踪 ID

// 链式构建
BRBuilder.<String>builder(true).data("token").msg("成功").build();

// 快捷方法
BRBuilder.successResult();
BRBuilder.successResult(data);
BRBuilder.failResult();
BRBuilder.failResult("错误消息", "ERROR_CODE");

// 成功响应
RRBuilder.buildSuccessBody();
RRBuilder.buildSuccessBody(data);
RRBuilder.buildSuccessPageBody(count, dataList);
RRBuilder.buildSuccessListBody(dataList);

// 失败响应
RRBuilder.buildFailedBody("错误消息");
RRBuilder.buildFailedBody("ERROR_CODE", "错误消息");

// BaseResult 转 ResponseResult
RRBuilder.buildBodyByBaseResult(baseResult);

// 分页结果转响应
RRBuilder.buildBodyByPageResult(pageResult);

// 异常转响应
RRBuilder.buildFailByException(exception);

PRBuilder.result(total, rows);
PRBuilder.<User>builder().total(100L).rows(userList).build();

// 从 BasicParam 自动构建（自动提取分页参数）
SRPBuilder.buildRequest(queryParam);

// 链式构建（类型安全的 Lambda 字段引用）
SRPBuilder.<UserDto>builder()
    .example(queryParam)
    .page(new PageSearch(1, 20))
    .likeFields(UserDto::getName, UserDto::getPhone)
    .in(UserDto::getStatus, Arrays.asList(0, 1))
    .nullFields(UserDto::getDeletedAt)
    .notFields(UserDto::getType)
    .selectFields(UserDto::getName, UserDto::getPhone)
    .build();

// 单对象操作
MRPBuilder.buildRequest(userDto);
MRPBuilder.buildRequest(reqObj, UserDto.class);  // 自动类型转换

// 批量操作
MRPBuilder.buildRequest(userDtoList);

// 链式构建
MRPBuilder.<UserDto>builder()
    .param(userDto)
    .ids("id1", "id2", "id3")
    .enableNullFields(UserDto::getAvatar, UserDto::getNickname)
    .build();

// 通过 Lambda 引用设置字段值
UserDto user = OBJBuilder.builder(UserDto.class)
    .setFieldValue(UserDto::getName, "张三")
    .setFieldValue(UserDto::getPhone, "13800138000")
    .build();

UserDataContext.setUserData(userData);     // 设置当前线程用户数据
UserData data = UserDataContext.getUserData(); // 获取当前线程用户数据
UserDataContext.remove();                  // 清理

RequestHeaderContext.setRequestHeaders(headers);
RequestHeaders h = RequestHeaderContext.getRequestHeaders();
RequestHeaderContext.remove();

TraceIdContext.setTraceId("trace-001");
String traceId = TraceIdContext.getTraceId();
boolean has = TraceIdContext.hasTraceId();
String safe = TraceIdContext.getTraceIdOrDefault("N/A");
String required = TraceIdContext.getRequiredTraceId(); // 不存在时抛异常

// 安全执行（自动清理）
TraceIdContext.executeWithCleanup(() -> {
    // 业务逻辑
});

TraceIdContext.remove();

// 使用枚举
throw new BusinessException(MyErrorEnum.USER_NOT_FOUND);
// 使用 code + message
throw new BusinessException("USER_001", "用户不存在");
// 仅 message
throw new BusinessException("操作失败");

public enum MyErrorEnum implements BaseErrorEnum {
    USER_NOT_FOUND("USER_001", "用户不存在");
    // ...
}

// 类型安全的字段引用
EFunction<UserDto, String> nameRef = UserDto::getName;
String fieldName = FunctionColumnToStringUtil.columnToString(nameRef); // "name"

ThrowingSupplier<String, IOException> supplier = () -> readFile();

EmptyUtil.isEmpty(value);          // 支持 String/List/Map/Array/Object
EmptyUtil.isNotEmpty(value);
EmptyUtil.allFieldIsEmpty(obj);    // 判断对象所有字段是否为空
EmptyUtil.emptyThrowException(value, "不能为空"); // 为空抛 BusinessException
EmptyUtil.isNotEmptyChars(str);    // 排除 "null" 和 "undefined"

UserResp resp = TransformUtil.transformObj(dto, UserResp.class);
List<UserResp> list = TransformUtil.transformList(dtoList, UserResp.class);
PageResult<UserResp> page = TransformUtil.transformPageResult(pageResult, UserResp.class);
Map<String, Object> map = TransformUtil.transformToMap(obj);
UserDto dto = TransformUtil.transformFromMap(map, UserDto.class);

UserResp resp = MapStructConvertUtil.convert(dto, UserResp.class);
List<UserResp> list = MapStructConvertUtil.convertList(dtoList, UserResp.class);

// 拷贝值（Lambda 指定强制置空字段）
MapStructConvertUtil.copyValue(source, target, UserDto::getAvatar);

// 自定义回调
MapStructConvertUtil.copyValue(source, target, (s, t) -> {
    if (s.getStatus() == null) t.setStatus(0);
});

Field[] fields = ReflectUtil.getAllFields(clazz);           // 获取所有字段（含父类）
Object value = ReflectUtil.getValueByFieldName(obj, "name");// 获取字段值
ReflectUtil.setValueByFieldName(obj, "name", "张三");       // 设置字段值
Field[] annotated = ReflectUtil.getFieldsByAnnotation(clazz, PrimaryKey.class);
T instance = ReflectUtil.createInstanceAndSetValue(clazz, valueMap);

StringUtil.underlineToCamel("user_name");   // "userName"
StringUtil.camelToUnderline("userName");     // "user_name"
StringUtil.upperFirstChar("name");          // "Name"
StringUtil.lowerFirstChar("Name");          // "name"
StringUtil.isChinese("中文");               // true

List<String> list = SplitUtil.split("a,b，c d/e");  // ["a","b","c","d","e"]
List<Integer> ids = SplitUtil.splitAndConvert("1,2,3", Integer.class);

OrderNoUtil.get18OrderNumber("PO");   // "PO202602281430001230"
OrderNoUtil.get22OrderNumber("SO");   // 22位订单号
OrderNoUtil.get27OrderNumber("TX");   // 27位订单号

MyEnum e = EnumUtils.getEnumByValue(MyEnum.class, "value1");
String name = EnumUtils.getNameByValue(MyEnum.class, "value1");
MyEnum e2 = EnumUtils.getEnumByCode(MyEnum.class, "code1");

LocalDateUtil.getLocalDateTimeString();          // "2026-02-28 14:30:00"
LocalDateUtil.string2LocalDateTime("2026-02-28 14:30:00");
LocalDateUtil.localDateTime2Date(localDateTime);
LocalDateUtil.date2LocalDateTime(date);
LocalDateUtil.between("2026-01-01 00:00:00", "2026-12-31 23:59:59");
LocalDateUtil.firstDayOfMonth(LocalDate.now());
LocalDateUtil.getIntervalDays(date1, date2);

I18NUtil.getMessage("user.not.found");
I18NUtil.getMessage("user.welcome", new Object[]{"张三"});
I18NUtil.getMessage("error.code", "custom/messages");
Locale locale = I18NUtil.getLocale();  // 从请求头自动获取

String result = ExpressionUtil.parse("#userId", method, args);
Integer value = ExpressionUtil.parse("#order.amount", method, args, Integer.class);