# backend-application

**Repository Path**: MetaLite/backend-application

## Basic Information

- **Project Name**: backend-application
- **Description**: 【强制jar包依赖】元界MetaLite后端应用的技术底座、公共依赖库。
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-07-11
- **Last Updated**: 2026-05-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# backend-application

## 简介

`backend-application` 是 MetaLite 微服务框架的**核心应用框架**，提供21项开箱即用的企业级能力，是所有后端服务的**强制jar包依赖**。

### 定位与职责

| 定位 | 职责 |
|------|------|
| 核心框架 | 封装业务无关的自研公共组件 |
| 强制依赖 | 所有后端服务必须引入此模块 |
| 能力提供 | 提供21项企业级能力（限流、缓存、分布式ID等） |
| 最佳实践 | 浅层封装成熟开源组件，暴露最佳实践 |

---

## 设计思想

### 1. 浅层封装原则

```
开源组件 → MetaLite封装 → 业务代码
    │           │              │
    │           │              ▼
    │           │         极简API调用
    │           ▼
    │    统一风格、最佳实践
    ▼
复杂配置
```

### 2. 封装价值

| 价值 | 说明 |
|------|------|
| 降低学习成本 | 业务开发人员只需掌握一套API |
| 统一开发风格 | 规范调用方式，补充业务场景方法 |
| 暴露最佳实践 | 统一异常处理，避免工具类混用 |

---

## 核心能力

| 能力 | 模块 | 说明 |
|------|------|------|
| 统一请求响应 | pojo | InternalReq/ExternalReq、Resp统一封装 |
| 分布式ID生成 | id | 类雪花算法，每秒1677万个ID |
| 二级缓存 | cache | 本地缓存(Caffeine) + Redis |
| 分布式锁 | cache | Redis分布式锁，自动续期 |
| 对象转换 | convert | Bean/Map互转，MapStruct编译时生成 |
| JSON处理 | json | FastJson封装，支持脱敏、过滤、JSONPath |
| HTTP客户端 | rpc | 链式调用、超时控制、重试、降级 |
| 定时任务 | job | 优化版Spring @Scheduled，分布式作业抢占执行、独立线程池、任务追踪 |
| 加密解密 | security | AES/RSA/SM2/SM4/SHA256/SM3 |
| 数据脱敏 | security | 手机号、身份证、银行卡脱敏 |
| 线程上下文 | concurrent | 用户ID、AppId、TraceId管理 |
| 分布式链路追踪 | aspect | 自动追踪请求调用路径 |
| 操作日志审计 | aspect | 自动记录用户操作，支持审计 |
| 参数校验 | util | 断言工具，统一校验参数 |
| 日期时间 | util | LocalDateTime工具，格式化、运算 |
| 数字处理 | util | 分转元、高精度计算 |
| 空集合常量 | constant | EMPTY_LIST/EMPTY_MAP等 |
| 符号常量 | constant | COMMA/COLON/SLASH等 |
| 限流控制 | cache | Sentinel多维度限流 |
| 异常处理 | error | 统一全局异常、错误码体系 |
| 切面编程 | aspect | 日志、脱敏、幂等自动处理 |

---

## 模块结构

```
backend-application/
├── aspect/        # AOP切面（日志、脱敏、幂等）
├── cache/         # 二级缓存、分布式锁
├── concurrent/    # 并发工具、线程上下文
├── constant/      # 常量定义
├── convert/       # Bean/Map转换
├── error/         # 异常处理、错误码
├── id/            # 分布式ID生成
├── json/          # JSON处理
├── job/           # 定时任务
├── pojo/          # POJO规范、请求响应对象
├── rpc/           # HTTP客户端
├── security/      # 加密、签名、脱敏
└── util/          # 常用工具类
```

---

## 许可证

MIT License