文档编号：YBJ-JG-SJ-KFZN
国家医疗保障信息平台建设工程项目
应用系统开发指南
（V0.5.5）
国家医疗保障局
架构组
2020 年 3 月
II
III
变 更 记 录
注：对该文件内容增加、删除或修改均需填写此变更记录，详细记载变更信息，以保证
其可追溯
序号
版本号
修改内容
页号
修改人/日期
批准人/日期
实施日期
1
0.1
改版
李维波
2019 年 8 月
2 日
2
0.2
改版调整
李维波
2019 年 8 月
22 日
3
0.3
改版调整
李维波
2019 年 9 月
20 日
4
0.4
改版调整
李维波
2019 年 9 月
24 日
5
0.5
改版调整
李维波
2019 年 9 月
30 日
6
0.5.4
补充
@hsafrestpath
注解、统一日
志记录、统一
参数校验
四牛
2019 年 10
月 31 日
7
0.5.5
补充 5.3Jvm 参
数配置说明
四牛
2020 年 3 月
27 日
IV
目录
1 范围.............................................................................................................................................................5
2 术语和定义 ................................................................................................................................................5
3 缩略语.........................................................................................................................................................5
4 架构框架概述 ............................................................................................................................................6
4.1 总体技术架构.................................................................................................................................................6
4.2 HSAF 框架........................................................................................................................................................7
4.2.1 概述...........................................................................................................................................................7
4.2.2 HSAF 核心框架 .......................................................................................................................................7
4.2.3 HSAF 适配框架 .......................................................................................................................................8
4.3 技术架构设计.................................................................................................................................................8
5 开发环境准备 ............................................................................................................................................9
5.1 开发环境准备.................................................................................................................................................9
5.2 开发服务器环境准备 ...................................................................................................................................9
5.3 JVM 参数配置.................................................................................................................................................9
5.4 HSAF 框架环境准备...................................................................................................................................10
5.4.1 创建 Maven 仓库................................................................................................................................10
5.4.2 上传核心框架相关库.........................................................................................................................11
5.4.3 部署适配框架相关库.........................................................................................................................12
5.4.4 使用 Maven 仓库私服.......................................................................................................................14
6 核心框架 ..................................................................................................................................................15
6.1 自定义注解@HSAFRESTPATH ....................................................................................................................15
6.2 统一日志记录...............................................................................................................................................16
6.3 统一参数校验...............................................................................................................................................17
6.4 全局序列........................................................................................................................................................18
6.4.1 概述.........................................................................................................................................................18
6.4.2 使用说明 ...............................................................................................................................................18
6.5 登陆认证........................................................................................................................................................22
6.5.1 依赖 core 包内容................................................................................................................................22
V
6.5.2 实现内容 ...............................................................................................................................................22
6.5.3 使用说明 ...............................................................................................................................................23
6.6 任务调度........................................................................................................................................................26
6.6.1 使用说明 ...............................................................................................................................................26
6.6.2 接口说明 ...............................................................................................................................................33
6.7 分页.................................................................................................................................................................45
6.7.1 使用说明 ...............................................................................................................................................46
6.7.2 重要提示 ...............................................................................................................................................48
6.8 数据库兼容方案 ..........................................................................................................................................49
6.8.1 配置说明 ...............................................................................................................................................49
6.8.2 使用说明 ...............................................................................................................................................50
7 适配框架 ..................................................................................................................................................50
7.1 分布式缓存 ...................................................................................................................................................50
7.1.1 适配抽象层...........................................................................................................................................50
7.1.2 适配实现层...........................................................................................................................................51
7.1.3 使用说明 ...............................................................................................................................................52
7.2 消息队列........................................................................................................................................................61
7.2.1 适配抽象层...........................................................................................................................................61
7.2.2 适配实现层...........................................................................................................................................62
7.2.3 使用说明 ...............................................................................................................................................65
7.3 分布式存储 ...................................................................................................................................................73
7.3.1 适配抽象层...........................................................................................................................................73
7.3.2 适配实现层...........................................................................................................................................74
7.3.3 使用说明 ...............................................................................................................................................76
7.4 远程服务调用...............................................................................................................................................80
7.4.1 core 内容................................................................................................................................................80
7.4.2 实现内容 ...............................................................................................................................................80
7.4.3 使用说明 ...............................................................................................................................................80
