LAWYER API PLATFORM

律师业务服务的
一体化 API 平台

基于 Kotlin 与 Spring Boot 构建的高性能后端服务,采用 MySQL + SQL Server 双数据源架构,内置统一响应、全局异常处理与全链路追踪,为律师业务系统提供稳定可靠的数据支撑。

Kotlin 2.3 Spring Boot 4 MySQL SQL Server MyBatis-Plus
LawyerApi 平台插图
2双数据源架构
7+REST 接口
100%Kotlin 编写
全链路TraceId 追踪

核心特性

从数据层到接口层,LawyerApi 提供开箱即用的工程化基座

双数据源架构

MySQL 主库 + SQL Server 副库独立管理,按数据源隔离 SqlSessionFactory 与分页方言,互不干扰。

标准化 REST 接口

基于 MyBatis-Plus BaseMapper 的完整 CRUD 示例,分页插件自动适配两种数据库方言。

统一响应结构

所有接口返回统一的 ApiResponse 结构,包含业务码、消息、数据与 traceId,前后端协作零歧义。

全局异常兜底

业务异常、参数校验、数据库错误分类处理,错误码统一枚举管理,不向前端暴露内部细节。

链路追踪 TraceId

过滤器自动生成或透传 X-Trace-Id,写入 MDC 贯穿全部日志,配合访问日志切面快速定位问题。

OpenAPI 在线文档

集成 springdoc-openapi,接口定义即文档,Swagger UI 在线调试,降低联调成本。

API 一览

当前版本开放的 REST 接口,点击右上角 Swagger 文档可在线调试

方法路径说明
GET/api/test服务健康检查
GET/api/db/mysql查询 MySQL 主数据源信息
GET/api/db/sqlserver查询 SQL Server 第二数据源信息
GET/api/{db}/users分页查询用户列表
GET/api/{db}/users/{id}根据 id 查询用户
POST/api/{db}/users新增用户
PUT/api/{db}/users/{id}修改用户
DELETE/api/{db}/users/{id}删除用户

路径参数 {db} 支持 mysql 与 sqlserver,用于选择目标数据源

双数据源架构插图

现代技术栈

LawyerApi 采用 Kotlin 全函数式风格开发,借助 Spring Boot 生态与 MyBatis-Plus 提供稳定的数据访问能力,同时为后续业务扩展预留了搜索、缓存与认证等集成空间。

语言Kotlin 2.3 框架Spring Boot 4.1 ORMMyBatis-Plus 3.5 数据库MySQL 8 / SQL Server 文档springdoc-openapi 3 安全Spring Security 监控Spring Actuator 构建Gradle 9 + Kotlin DSL

快速开始

三步启动服务,立即体验全部接口

1

配置数据源

在 application.properties 中配置 MySQL 与 SQL Server 的连接信息。

2

启动应用

执行 ./gradlew bootRun 或运行 LawyerApiApplicationKt 启动服务。

3

调用接口

访问 Swagger UI 在线调试,或直接使用 curl 调用 REST 接口。

# 启动服务
./gradlew bootRun

# 健康检查
curl http://localhost:8080/api/test

# 查询 MySQL 用户列表(第 1 页,每页 10 条)
curl http://localhost:8080/api/mysql/users?pageNum=1&pageSize=10

# 新增用户
curl -X POST http://localhost:8080/api/mysql/users \
  -H "Content-Type: application/json" \
  -d '{"name":"张律师","email":"zhang@lawfirm.com","age":35}'