Constant 基础工具

Constant 为 EFC（enterprise-framework-core）的组件和应用提供共用约定与基础工具。例如，去除标签列表中的重复项，或将手机号转换为展示用的脱敏文本，都可以直接调用静态方法完成。

模块提供常量、注解与条件、响应消息和异常、Hook 抽象、元组，以及集合、文件图片、编码脱敏和证件格式处理。它不实现账号、组织等业务流程，也不提供 HTTP 接口。

按需阅读

首次接入先完成快速开始，运行一个列表去重示例。之后按需求选择路线，无需逐页顺读：

• 直接使用工具：进入下表中的集合、文件、通用工具或脱敏专题，选择对应示例；无需先学习 Spring 配置、响应或 Hook。
• 接入公共约定或扩展：需要按配置启用 Bean、绑定属性时读使用与配置；需要统一业务错误或组织扩展处理时读响应与 Hook。

能力与阅读入口

任务	文档
在普通 Java 程序中完成列表去重	快速开始
使用常量、注解、Spring 条件与属性模型	使用与配置
统一错误消息、组织有序或按类型选择的扩展	响应与 Hook
去重、分组、排序、构树与懒分页	集合与分页
文件 Base64、目录下载与图片压缩	文件与图片
文本、参数、时间、TraceId 与进程内事件	通用工具
脱敏展示、证件信息提取与旧编码协议对接	脱敏与编码

接入与职责边界

实际坐标为 com.own:constant:4.1.0-SNAPSHOT，是 JAR，由 Component BOM 管理版本，Java 包前缀为 com.own.constant。当前构建基线为 Java 25。

静态工具可以在普通 Java 程序中使用，但该 JAR 仍传递依赖 Spring Boot、Spring Context/Beans/Core、Guava、Commons Lang/Codec、Hutool HTTP、SLF4J 和 Fastjson2。它没有 AutoConfiguration.imports，不会仅凭依赖自动开启组件扫描或创建应用服务。

• Base 消费公共异常和 TraceId 约定，提供 MVC 异常转换、响应模型与上下文生命周期。
• Authentication 提供身份来源适配；登录与权限注解的拦截需要相应消费者，声明注解本身不会保护接口。
• 系统日志 消费日志注解，具体采集与保存行为由日志组件实现。
• Hook 基类只整理传入的实例；收集 Bean、触发执行、事务和错误处理由调用方负责。

工具的可变性与失败返回并不统一。具体页面会在调用处说明懒计算、就地修改、空值回退和共享状态，接入时按所选 API 确认。

按文件查阅方法

重点文件与方法逐项说明核心类、接口和方法重载的用途、参数、返回值、调用示例与注意事项，并链接到公开仓库对应源码。