23 lines
1.0 KiB
Markdown
23 lines
1.0 KiB
Markdown
# Common Web 模块指引
|
|
|
|
## 职责边界
|
|
|
|
- 提供 Servlet Web 通用能力：请求链路标识、上下文和统一异常响应。
|
|
- 不放具体业务 Controller、路由或领域异常编排；业务错误通过 `common-core` 的契约表达。
|
|
|
|
## 快速索引
|
|
|
|
| 功能 | 入口 |
|
|
|---|---|
|
|
| 链路上下文 | `src/main/java/com/baiyue/common/web/CorrelationContext.java` |
|
|
| 请求 ID 过滤器 | `src/main/java/com/baiyue/common/web/CorrelationIdFilter.java` |
|
|
| 全局异常映射 | `src/main/java/com/baiyue/common/web/GlobalExceptionHandler.java` |
|
|
| 过滤器测试 | `src/test/java/com/baiyue/common/web/CorrelationIdFilterTest.java` |
|
|
| 异常响应测试 | `src/test/java/com/baiyue/common/web/GlobalExceptionHandlerTest.java` |
|
|
|
|
## 修改与验证
|
|
|
|
- 修改异常响应时同时检查 HTTP 状态、`ApiResponse` 结构、校验错误和安全异常是否仍一致。
|
|
- 修改 Correlation ID 时检查请求头兼容、线程上下文清理和日志链路。
|
|
- 从父目录运行 `mvn -pl common-web -am test`。
|