1.4 数据上报要求
省、市级能耗监测系统,通过定时任务自动从省、市级数据中心数据库中提取能耗分类数据,打包后发送到部级数据中心。数据的分类编码要求跟上述十个分类保持一致,不得超出字典表定义范围,且要求为大写;数据采集时间和上传时间的格式要求为“yyyy-mm-dd”,年份占四位,月和日都占两位,例如“2011-05-08”。数据上传的时间要求为每天的早八点前上传前一天的数据。
2、接口协议及示例
2.1 通信协议
采用持久TCP/IP连接。
2.2 通讯步骤
建立socket连接后,首先发送身份认证报文(密码直接通过正文发送),服务器接收到报文后验证身份,发送回执报文,通过回执报文报头中的_state参数识别是否认证成功(0-成功),认证成功后发送业务数据报文,服务器接收到业务数据报文后,发送回执给发送者,通知发送者收到业务数据报文,同时解析业务报文为内部对象,异步发送给内部消息缓存池,进行相应的逻辑服务处理,进行数据解析,并将解析结果异步方式发送给发送者。
(1)、连接服务器
通过客户端socket连接服务器,部级数据中心数据接收服务器的IP地址:219.142.101.190 ,监听端口: 6767。
(2)、身份认证
确认连接成功后发送身份认证数据报进行身份验证,数据中心编码(从住房和城乡建设部信息中心获取)通过协议报头的_sender 发送,比如北京数据中心编码为:110000,天津数据中心编码为:120000。密码通过正文发送,然后返回认证数据报,报头的_state 标识认证是否成功(0-成功;1-账号不存在;2-密码错误或超过允许次数等)。
(3)、发送业务数据
身份认证成功,发送业务数据报;认证失败,重新认证。发送业务数据报后可以取回执确认报。
2.3 基础协议
身份认证报、返回认证数据报、业务数据报、回执确认报都按照下述基础协议进行封装。
基础通讯协议基于字节码方式通讯。
序号
| 名称
| 长度
| 描述
|
1
| 报文开始标记
| 3 子节
| 0x8b, 0xae, 0x9b
|
2
| 报文类型
| 2子节
| 16进制 范围 0-254,默认为0
|
3
| 报头长度
| 4子节
| 16进制 报头字节码(byte)长度
|
4
| 正文长度
| 7子节
| 16进制 正文字节码(byte)长度 最大正文254M
|
5
| 报头
| X
| 数据格式为字节码(byte)
参数名称: _id 编码
_name 标题;
_sender 发送者,数据中心编码
_target 接收目标
_answer 处理结果给谁
_style 正文类型 取值2
_time 发送时间
_state 状态
参数对之间采用&分割
参数名称和参数值之间采用=分割
数组类型参数值采用,分割
|
6
| 正文
| X
| 数据格式为字节码(byte)
|