[发明专利]一种接口编/解码的方法和系统

说明书

技术领域

本发明涉及通信领域，特别是涉及一种接口编/解码的方法和系统。

背景技术

在编解码时，需要考虑两个有关联的子系统间或模块间，甚至具体到两个函数间的接口设计、编解码等方面，在接口的设计以及后续修改时，接口编码的优劣会对整个系统造成严重的影响。

现有的接口代码在各自子系统中定义和实现，存在以下问题：

第一，由于编码者的水平和能力不同，会直接造成在接口设计及编解码过程中的质量差别，接口代码的质量不高，有的甚至会造成潜在的隐患问题，对整个系统埋下致命的缺陷。

第二，会存在接口消息在传输过程中字节流的定义不统一的问题，进而引发接口对接等问题。

第三，采用现有的接口编码方式，系统间的耦合性大，在编码完成之后需要扩展时，各个子系统不仅需要对接口文件进行重新编写，而且接口代码也要重新进行定义和修改，这种接口的改动会直接对业务造成影响，可能导致大面积的代码修改，甚至可能导致接口无法扩展。

发明内容

本发明提供一种接口编/解码的方法和系统，以提高接口编/解码的质量。

为了解决上述问题，本发明公开了一种接口编/解码的方法，包括：

根据接口需求确定接口内容；

根据所述接口内容按照预设的统一规范编写接口文件；

执行自动代码生成工具，解析所述接口文件自动生成接口代码文件；

调用所述接口代码文件进行编码，生成接口消息并发送；

和/或，调用所述接口代码文件对接收到的接口消息进行解码，得到解码消息。

优选地，所述接口文件存储在Excel文件中；

其中，一个接口的内容编写为一个接口文件，一个接口文件存储在一个Excel文件中。

优选地，所述接口消息中的有符号整数根据范围转换为等长无符号整数进行发送；

其中，根据以下公式进行转换：

x＝value-lb；

所述公式中，x为转换到字节流中的无符号整数，value为转换前的有符号整数，lb为该有符号整数的下边界。

优选地，所述自动生成接口代码文件之前，还包括：

自动代码生成工具对所述接口文件进行合法性检查。

优选地，调用接口代码文件进行编码或解码包括：

调用接口；

调用对应所述接口的接口代码文件进行编码或解码。

优选地，上述方法还包括：

当所述接口需求变化时，根据变化后的接口需求确定新的接口内容；

根据所述新的接口内容修改对应的接口文件；

执行自动代码生成工具，根据修改后的接口文件自动生成新的接口代码文件；

调用所述新的接口代码文件进行编码，生成接口消息；

和/或，调用所述新的接口代码文件对接口消息进行解码，得到解码消息。

优选地，所述接口内容包括：

接口的消息内容及结构，所述消息结构包括结构名称、成员名称和成员类型。

优选地，所述预设的统一规范包括接口消息定义规范和传输过程中的接口消息流定义规范。

优选地，解析所述接口文件自动生成接口代码文件之后，还包括：

将所述接口代码文件集成到工程。

本发明还公开了一种接口编/解码的系统，包括：

接口内容确定模块，用于根据接口需求确定接口内容；

接口文件编写模块，用于根据所述接口内容按照预设的统一规范编写接口文件；

接口代码文件生成模块，用于执行自动代码生成工具，并解析所述接口文件自动生成接口代码文件；

编码模块和/或解码模块，其中，

编码模块，用于调用所述接口代码文件进行编码，生成接口消息并发送；

解码模块，用于调用所述接口代码文件对接收到的接口消息进行解码，得到解码消息。

优选地，上述系统还包括：

存储模块，用于接口文件编写模块编写完接口文件之后，将所述接口文件存储在Excel文件中；

其中，一个接口的内容编写为一个接口文件，一个接口文件存储在一个Excel文件中。

优选地，上述系统还包括：

转换模块，用于编码模块生成接口消息后，将所述接口消息中的有符号整数根据范围转换为等长无符号整数；

所述转换模块根据以下公式进行转换：

x＝value-lb；