| 1234567891011121314151617181920212223242526272829 |
- ---
- description: 全局上下文约定
- alwaysApply: true
- ---
- # 全局上下文约定
- ## 注意事项
- 1. **修改 `.properties` 或 `.xml` 文件前必须征得用户同意**
- 2. **删除任意文件前必须征得用户同意**
- ## JSON使用规则
- - 项目同时存在 **Fastjson、Gson、Jackson**；新代码优先与**当前修改文件**已用的库保持一致，避免在同一流程混用三种序列化。
- ## 异常与响应
- - 业务错误：抛 `SelfException`（可带错误码、扩展数据、`SysLogEvent`）；由 `GlobalSelfExceptionHandler` 统一转 JSON。
- - 静态工厂方法优先复用 `GlobalSelfExceptionHandler.createResParam(...)` 等同项目既有写法。
- ## 依赖与副作用
- - 使用 `com.global.base.*`（gbase JAR）时，不假设本地有可替换实现；改动需考虑 **无该 JAR 时无法编译** 的环境。
- - 线程与后台任务：参考 `ThreadTaskMgr`、`AsyncTaskQueueMgr` 等现有模式，避免自建无界线程池。
- ## Git使用规范
- - 禁止自动提交，不得主动或自动执行 `git commit` 或 `git push`
|
