完成app接口国际化
Some checks failed
CI Build and Test / build (push) Has been cancelled
Deploy to Server / build-and-deploy (push) Has been cancelled

This commit is contained in:
2025-10-21 10:15:38 +08:00
parent 1e356a03bb
commit 928bb078f0
16 changed files with 791 additions and 89 deletions

View File

@@ -63,6 +63,7 @@ com.corewing.app/
│ └── Result.java # 统一返回结果类
├── config/ # 配置类
│ ├── DruidConfig.java # Druid 数据源监控配置
│ ├── I18nConfig.java # 国际化配置
│ ├── MybatisPlusConfig.java # MyBatis-Plus 配置
│ ├── RedisConfig.java # Redis 配置
│ └── SaTokenConfig.java # Sa-Token 权限配置
@@ -87,6 +88,7 @@ com.corewing.app/
│ └── VerifyCodeServiceImpl.java # 验证码服务实现
└── util/ # 工具类
├── EmailUtil.java # 邮件发送工具类
├── I18nUtil.java # 国际化工具类
├── IpUtil.java # IP 工具类
├── RedisUtil.java # Redis 工具类
└── SmsBaoUtil.java # 短信宝工具类
@@ -103,6 +105,10 @@ com.corewing.app/
- 短信宝配置
- 邮件配置
### 资源文件
- `src/main/resources/i18n/messages_zh_CN.properties` - 中文国际化消息
- `src/main/resources/i18n/messages_en_US.properties` - 英文国际化消息
### 数据库
- 建表 SQL`src/main/resources/db/user.sql`
- 主表:`app_user` - 应用用户表
@@ -159,6 +165,20 @@ com.corewing.app/
- 验证码邮件采用精美的 HTML 模板
- 支持多种邮箱服务商QQ、163、Gmail 等)
### 9. 国际化支持
- 支持中文zh_CN和英文en_US双语
- 客户端通过 HTTP Header 的 `Accept-Language``lang` 指定语言
- 默认语言:中文
- 国际化范围:
- API 响应消息(成功/失败提示)
- 用户操作反馈(登录、注册、登出等)
- 所有异常和错误消息
- 邮件模板内容
- 短信模板内容
- 钉钉推送消息
- I18nUtil 工具类提供便捷的国际化消息获取
- 详细使用说明参见:`I18N_README.md`
## 开发规范
### 1. 依赖注入
@@ -183,6 +203,12 @@ com.corewing.app/
- 使用 `IpUtil.getClientIp()` 获取真实 IP
- 支持多级代理
### 6. 国际化消息
- 所有用户可见的消息都应使用国际化
- 使用 `I18nUtil.getMessage("message.key")` 获取国际化消息
- 支持消息参数:`I18nUtil.getMessage("message.key", param1, param2)`
- 新增消息时需同时更新中英文资源文件
## 项目特点
- 项目使用 MyBatis Plus 作为 ORM 框架,支持自动代码生成
@@ -191,4 +217,5 @@ com.corewing.app/
- 使用 Lombok 简化实体类代码
- 开发环境支持热重载 (Spring Boot DevTools)
- Druid 数据库连接池,提供 SQL 监控功能
- 统一返回结果封装,规范 API 响应格式
- 统一返回结果封装,规范 API 响应格式
- 完整的国际化支持,支持中英文双语切换