功能明细 > Web客户端 > RPCServer接口

数据操作：

❖ 接口：

module IHDData{

exception InvokeError{

string reason;

}

sequence<byte> JsonSeq;

sequence<string> StringSeq;

struct Record {

string value;

int recordTime;

int recordTimeMs;

int quality;

}

sequence<Record> RecordSeq;

struct Tag {

string tagName;

int tagId;

int recordNum;

int tagType;

int errorCode;

RecordSeq records;

}

sequence<Tag> TagSeq;

interface HDDataHandler{

int saveSnapShots (TagSeq request, out TagSeq response)throws InvokeError;

int querySnapShots (TagSeq request, out TagSeq response)throws InvokeError;

int queryRawRecordsNum (JsonSeq request, out JsonSeq response)throws InvokeError;

int queryRawRecords (JsonSeq request, out TagSeq response)throws InvokeError;

int queryRawRecordsByDirection (JsonSeq request, out TagSeq response)throws InvokeError;

int queryInterpRecords (int queryMode, TagSeq request, out TagSeq response)throws InvokeError;

};

❖ 增加快照(saveSnapShots)

参数列表	名称	类型	是否可空	备注
	tags	array<Tag>	否	tag点数组
	+tagName	string	否	tag点名（只需填写tagName和records，其余字段可空）
	+records	array<Record>	否	record数组
	++value	string	否	快照值
	++recordTime	int	否	记录时间，Unix时间（1970年1月1日至今的秒数）
	++recordTimeMs	int	否	记录时间（毫秒）
	++quality	int	否	数据质量，192为Good，65343为Bad
返回值列表
	tags	array<Tag>	否	tag点数组
	+tagNames	string	是	tag点名
	+tagId	int	是	tag点ID
	+tagType	int	是	tag点数据类型 0： HD3_TAG_TYPE_INT 1： HD3_TAG_TYPE_INT16, 2： HD3_TAG_TYPE_INT32, 3： HD3_TAG_TYPE_FLOAT32, 4： HD3_TAG_TYPE_FLOAT64, 5： HD3_TAG_TYPE_DIGITAL, 6： HD3_TAG_TYPE_STRING, 7： HD3_TAG_TYPE_BLOB
	+errorCode	int	是	错误编号

❖实时数据查询(querySnapShots)

参数列表	名称	类型	是否可空	备注
	tags	array<Tag>	否	tag点数组
	+tagName	string	否	tag点名（只需填写tagName和records，其余字段可空）
返回值列表
	tags	array<Tag>	否	tag点数组
	+tagNames	string	是	tag点名
	+tagId	string	是	tag点ID
	+tagType	int	是	tag点数据类型 0： HD3_TAG_TYPE_INT 1： HD3_TAG_TYPE_INT16, 2： HD3_TAG_TYPE_INT32, 3： HD3_TAG_TYPE_FLOAT32, 4： HD3_TAG_TYPE_FLOAT64, 5： HD3_TAG_TYPE_DIGITAL, 6： HD3_TAG_TYPE_STRING, 7： HD3_TAG_TYPE_BLOB
	+errorCode	int	是	错误编号
	+records	array<Record>	否	record数组，大小为1
	++value	string	否	快照值
	++recordTime	int	否	快照时间，Unix时间（1970年1月1日至今的秒数）
	++recordTimeMs	int	否	快照时间（毫秒）
	++quality	int	否	数据质量，192为Good，65343为Bad

❖历史数据总数查询(queryRawRecordsNum)

参数列表	名称	类型	是否可空	备注
	request	object	否	Json字符串
	tags	array	否	tag点数组
	+startTime	string	否	起始时间，格式为"YYYY-MM-ddThh:mm:ss.SSS"
	+endTime	string	否	结束时间，格式为"YYYY-MM-ddThh:mm:ss.SSS"
	+tagName	string	否	tag点名
返回值列表
	response	object	否	Json字符串
	tags	array	否	tag点数组
	+tagName	string	是	tag点名
	+recordNum	int	否	查到总数
	+errorCode	int	是	错误编号

❖历史数据查询(queryRawRecords)

参数列表	名称	类型	是否可空	备注
	request	object	否	Json字符串
	tags	array	否	tag点数组
	+expectedNum	int	否	待查总数
	+startTime	string	否	起始时间，格式为"YYYY-MM-ddThh:mm:ss.SSS"
	+endTime	string	否	结束时间，格式为"YYYY-MM-ddThh:mm:ss.SSS"
	+tagName	string	否	tag点名
返回值列表
	tags	array<Tag>	否	tag点数组
	+tagName	string	是	tag点名
	+tagId	string	是	tag点ID
	+tagType	int	是	tag点数据类型 0： HD3_TAG_TYPE_INT 1： HD3_TAG_TYPE_INT16, 2： HD3_TAG_TYPE_INT32, 3： HD3_TAG_TYPE_FLOAT32, 4： HD3_TAG_TYPE_FLOAT64, 5： HD3_TAG_TYPE_DIGITAL, 6： HD3_TAG_TYPE_STRING, 7： HD3_TAG_TYPE_BLOB
	+recordNum	int	否	查到总数
	+errorCode	int	是	错误编号
	+records	array<Record>	否	record数组
	++value	string	否	记录值
	++recordTime	int	否	记录时间，Unix时间（1970年1月1日至今的秒数）
	++recordTimeMs	int	否	记录时间（毫秒）
	++quality	int	否	数据质量，192为Good，65343为Bad

❖前向或后向查询（queryRawRecordsByDirection）

参数列表	名称	类型	是否可空	备注
	request	object	否	Json字符串
	tags	array	否	tag点数组
	+expectedNum	int	否	待查总数
	+startTime	string	否	起始时间，格式为"YYYY-MM-ddThh:mm:ss.SSS"
	+direction	int	否	1表示向后查，0表示向前查
	+tagName	string	否	tag点名
返回值列表
	tags	array<Tag>	否	tag点数组
	+tagName	string	是	tag点名
	+tagId	string	是	tag点ID
	+tagType	int	是	tag点数据类型 0： HD3_TAG_TYPE_INT 1： HD3_TAG_TYPE_INT16, 2： HD3_TAG_TYPE_INT32, 3： HD3_TAG_TYPE_FLOAT32, 4： HD3_TAG_TYPE_FLOAT64, 5： HD3_TAG_TYPE_DIGITAL, 6： HD3_TAG_TYPE_STRING, 7： HD3_TAG_TYPE_BLOB
	+recordNum	int	否	查到总数（不超过65535）
	+errorCode	int	是	错误编号
	+records	array<Record>	否	record数组
	++value	string	否	记录值
	++recordTime	int	否	记录时间，Unix时间（1970年1月1日至今的秒数）
	++recordTimeMs	int	否	记录时间（毫秒）
	++quality	int	否	数据质量，192为Good，65343为Bad

❖插值查询(queryInterpRecords)

参数列表	名称	类型	是否可空	备注
	queryMode	int	否	插值模式: 0：线性插值 1：前向插值 2：最大值
	tags	array<Tag>	否	tag点数组
	+tagName	string	是	tag点名
	+records	array<Record>	否	record数组
	++recordTime	int	否	记录时间，Unix时间（1970年1月1日至今的秒数）
返回值列表
	tags	array<Tag>	否	tag点数组
	+tagName	string	是	tag点名
	+tagId	string	是	tag点ID
	+tagType	int	是	tag点数据类型 0： HD3_TAG_TYPE_INT 1： HD3_TAG_TYPE_INT16, 2： HD3_TAG_TYPE_INT32, 3： HD3_TAG_TYPE_FLOAT32, 4： HD3_TAG_TYPE_FLOAT64, 5： HD3_TAG_TYPE_DIGITAL, 6： HD3_TAG_TYPE_STRING, 7： HD3_TAG_TYPE_BLOB
	+recordNum	int	否	查到总数
	+errorCode	int	是	错误编号
	+records	array<Record>	否	record数组
	++value	string	否	记录值
	++recordTime	int	否	记录时间，Unix时间（1970年1月1日至今的秒数）
	++recordTimeMs	int	否	记录时间（毫秒）
	++quality	int	否	数据质量，192为Good，65343为Bad