数据传输使用文档

数据传输使用文档

1传输基本架构：

传输分为三个层级：门店端、超市总部、公司端。

门店端在每天晚上固定时间内，将门店一天的流水等四张数据表的数据，以txt的形式，处理成一个压缩包，放到门店对应的路径下。

超市总部在门店端的备份开始一小时以后，开始调用门店服务获取门店的备份数据并保存在本地，之后调用公司端的服务，将本地获取的备份数据上传。

公司端在所有门店备份数据接收成功后，对压缩包进行解压，并将数据导入到数据库，继而完成传输的整个流程。

2模块传输详情：

2.1门店端

运维时间：00:00:00 – 00:10:00

部署方式：war包形式

详细细节：

2.1.1门店文件路径：

将程序部署到门店端运行之后，会生成与备份数据相关的文件夹。文件夹保存在的

盘符在项目启动的时候会动态选择。

1、门店端日志路径：.\ md_transbackups\backuplog

2、门店端TXT路径：.\ md_transbackups\backuptxt

3、门店端ZIP路径：.\ md_transbackups\backupzip

2.1.2门店端提供的服务：

1、文件传输服务：将本地文件上传至超市总部

2、结果传输服务：分为成功和失败，其中失败又包括：数据库连接失败、备份文

件生成失败、压缩文件生成失败

3、备份服务：超市总部通过页面功能手动调用门店端的备份服务

2.1.3注意事项：

1、门店端会先生成TXT文件，再将TXT文件压缩。如果压缩成功或者压缩过程中

出现异常，则生成的TXT文件会被删除。

2、手动备份门店数据的过程中，会在日志记录中体现“手动”的标记。

2.2超市总部

运维时间：01:00:00 – 01:10:00

部署方式：war包形式

详细细节：

2.2.1超市总部文件路径

1、超市总部日志路径：.\cs_transbackups\backuplog

2、超市总部ZIP路径：.\cs_transbackups\backupzip

IP配置：

在部署前，需要在超市总部配置超市总部IP：IP_MarketCenterSever

还有公司端的IP：IP_CompanyServer

2.2.2超市总部客户端的功能

1、获取门店端备份数据的功能，将获取到的压缩文件保存在zip路径下

2、获取门店端备份数据结果的功能，结果值保存在csjgb中

3、在超市总部设有“门店数据传输结果汇总”页面的功能，用于展现门店到超市，

超市到公司的数据传输进行结果。

4、超市手动调用门店端的备份流程的功能，用于门店数据备份出现异常或者错误

时使用，功能位于门店传输结果汇总页面的“手工备份”

5、超市向公司传输备份文件的功能

6、调用公司总部对上传文件的解压和数据落地的功能

2.2.3注意事项

1、超市总部通知公司端进行解压缩和导入的时候，公司端会直接返回成功的标识，

并启动一个线程进行数据的采集。所以当超市总部接收到成功的响应时只是表示公司端已经开始进行处理了而已。

2.3公司端

部署方式：war包形式

详细细节：

2.3.1公司端文件路径：

1、公司端日志路径：.\cs_transbackups\backuplog

2、公司端ZIP路径：.\cs_transbackups\backupzip

2.3.2公司端提供的服务：

1、文件传输服务：超市总部上传文件至公司端

2、数据解析服务：针对从门店端获取到的压缩文件进行解压和导入数据库

2.3.3注意事项

1、如果解压缩成功，系统将会将其移动到.\cs_transbackups\history 目录下进行保

存。

2、如果解压缩失败，则将失败的文件的文件名、传输时间以及文件路径保存至

jyajgb中。

3、数据解压缩的过程的逻辑是，每读取1000条数据进行插入处理，若1000条里

失败条数超过10条，则在日志中只打印前10条，并继续进行解压导入。如果

这期间出现不可预知的异常，则跳出本次的解压导入的流程，返回失败。3.表结构

在门店和超市所使用的MySQL和公司端对应的Oracle中，各有两张新建的表：

MySQL中：

csjgb（传输结果表）

gsdm 公司代码主键

mdh 门店号主键

cssj 传输时间主键

csjg 传输结果

jgms 结果描述

xh 序号主键

Oracle中：

jysjgb （解压缩结果表）

wjlj 文件路径主键

cssj 传输时间

wjmc 文件名称