网络通讯协议定义语言及代理代码生成器

最新推荐文章于 2024-07-08 13:21:40 发布
最新推荐文章于 2024-07-08 13:21:40 发布
阅读量1w 收藏 2
点赞数
文章标签： 语言 网络 通讯 whitespace struct
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/aerror/article/details/4472057
版权

2008-12-26

修改：2009-8-7

 

 

目录

1.概述... 3

2.命名规则... 3

3.保留字... 3

4.数据类型... 3

4.1简单数据类型... 3

4.2复杂数据类型... 4

4.3 复杂数据类型的继承... 4

5.注释... 4

6.枚举... 5

7.数组... 5

8.协议接口... 6

9.边效(side effect)—可序列化和XML. 6

10.完整语法（扩展巴科斯范式EBNF）... 6

11.改进需求... 10

 

 

 

1.概述

该语言可以定义出用于C++, ACTION SCRIPT 3.0 ,JAVA及PHP 或其它语言的网络通信协议，这种语言的编译器可以把这种语言编写的IDL协议文件自动生成可用于C++, ACTION SCRIPT 3.0,JAVA及PHP 或其它语言的实现代码。

2.命名规则

大小写敏感.

遵守C,JAVA和C#规则.

即变量,结构，枚举或函数名只能由字母,数字,和下划线_组成, 命名的开头不能是数字,只能以字母或下划线组成.

 

由(),{},[]三种标志划分命名的区域.

 

3.保留字

C,JAVA,PHP和AS语言的保留字并集.

enum,

struct,

coclass,

interface,

dispinterface

4.数据类型

4.1简单数据类型

 

CHAR

8 bit 有符号字节

UCHAR

8 bit 无符号字节

SHORT

16 bit 有符号整型

USHORT

16 bit 无符号整型

INT

32 bit 有符号整型

UINT

32 bit 无符号整型

LONGLONG

64 bit 有符号整型

ULONGLONG

64 bit 无符号整型

FLOAT

32 bit 单精度浮点数

DOUBLE

64 bit 双精度浮点数

STRINGA

utf8 字符串

STRINGW

Utf16字符串

 

****不支持指针类型

目前ACTION SCRIPT 中STRINGW（Utf16字符串）尚未支持,如果涉及as代码，请不要使用STRINGW（Utf16字符串）,只能使用STRINGA(utf8 字符串).

而不少语言并不支持unsigned的整型，如java,php等，在这些语言中的应用，生成代码需要模拟实现或避免使用unsigned的整形。

 

4.2复杂数据类型

使用struct来自行定义, 语法类似C语言的结构定义, 但不支持typedef语法。

语法:

struct 保留字;

结构名;

{  //(开括号)

成员定义

……

} //括号

 

例子:

struct TLOGIN_CHALLENGE

{

CHAR acc[32];

};

4.3 复杂数据类型的继承

语法定义如下:
struct A

{

         INT ma;

};

 

struct B:public A

{

         INT mb;

};

 

这时称为B继承了A, B拥有A的全部结构，B称为子，A为父.

由于大部分的语言都不支持多继承，这里也不支持多继承。

子类的成员命名不能和它所继承的父类重名，如上例，struct B中不能名字为ma的成员变量。

        

5.注释

使用 C++语言风格注释。支持转换成各种语言的注释后,还保持原来的位置及风格或形成doxygen的注释风格

 

6.枚举

语法类似C语言的结构定义, 但不支持typedef.

例子:

enum  _ECHARACTER_RACE

{

           RACE_HUMAN=0,

           RACE_UNDEAD,

           RACE_ELF,

           RACE_BLOOD_ELF

};

 

7.数组

只支持一维的定长或不定长数组, 不支持多维数据

 

例:

固定长度数组:

CHAR s[16]; //表示这个一个长度是16的CHAR数组

不定长数组;

CHAR s[]; //对于C++生成一个XNET_ARRAY<CHAR>对象.

 

[]括号中表示数组的个数,支持复杂的数结构.

 

例:

 

struct TIME_ZONE_INFO

{

int                                       TIME_ZONE;

STRINGUTF8  szDesc;

}

 

struct TCLIENT_PROOF

{

int  acclen;

CHAR acc[acclen];

int     pwdHash[40];

int  clientRand[40];

TIME_ZONE_INFO timeInfo;

};

 

struct TSERVER_PROOF

{                 

           int  result;

           int  clientRand[40];

};

 

8.协议接口

使用coclass保留字定义

每一个coclass表示是一套完整的网络接口协议，协议是从客户端的角度出发的。

每个由coclass定义协议包括两个接口, interface和dispinterface,其中interface表示由客户端向服务器进行主动请求的接口，而dispinterface则是服务器对于客户端的请求的回应事件接口.

 

Interface和dispinterface的方法声明和C语言的函数声明一致，但每个方法必须是返回INT.

即语法如下:

INT foo(…..);

 

例子：

coclass LoginProtocol

{

 

interface IloginAuthServer //有且只有一个

{

                    INT SendClientChallenge(ClientChallenge cc);

                    INT SendClientProof(ClientProof cf);

                    INT  SendGetChannelList();

};

 

                   

dispinterface LoginAuthServerEvent //有且只有一个

{

                    INT OnServerChallenge(ServerChallenge sc);

                    INT OnServerProof(ServerProof sf);

                    INT OnChannelList(ChannelServerInfo channelList[]);

};

};

 

9.边效(side effect)—可序列化和XML

所有由该语言定义的复杂结构都是可序列化及反序列化的，即:

1.       可以整个类序化成一段二进制数据流或XML。

2.       类可以从一段二进制数据流或XML初始化。

 

 

10.完整语法（扩展巴科斯范式EBNF）

使用SPIRITC++语言描述

 

grammar= (idl_file_define=*whitespace>>+

           (enum_define|struct_define|coclass_define),

 

comment = comment_p ("/*", "*/") | comment_p ("//","/n"),

 

whitespace = space_p|comment,

 

typedefine_ =str_p("CHAR") | "UCHAR" | "SHORT" | "USHORT" | "INT"

| "UINT" | "LONGLONG" | "ULONGLONG" | "STRINGA" | "STRINGW"

| "DOUBLE" | "FLOAT" ,

 

enum_keyword_ = str_p ("enum"),

 

struct_keyword_ = str_p("struct"),

 

coclass_keyword_ =str_p("coclass"),

 

inteface_keyword_ =str_p("interface"),

 

dispinterface_keyword_ =str_p("dispinterface"),

 

inherit_keyword_ =str_p("public"),

 

keyword_ = enum_keyword_

|struct_keyword_

|coclass_keyword_

|inteface_keyword_

|dispinterface_keyword_

|inherit_keyword_

|typedefine_,

 

keyword = keyword_ >> +whitespace,

 

identifer_ = ((alpha_p | '_') >> *(alnum_p | '_'))-keyword_,

 

identifer = identifer_>>*(whitespace),

 

typedefine = (typedefine_|identifer_)>>+whitespace,

 

assign_operate_ = ch_p('='),

inherit_operate_ = ch_p(':'),

define_start_ = ch_p('{'),

define_end_ = ch_p('}'),

define_seperator_ = ch_p(';'),

entry_seperator_ =ch_p(','),

param_decl_start_ = ch_p('('),

param_decl_end_ = ch_p(')'),

array_d_start_ = ch_p('['),

array_d_end_ = ch_p(']'),

 

operators =assign_operate_

|inherit_operate_

|define_start_

|define_end_

|define_seperator_

|entry_seperator_

|param_decl_start_

|param_decl_end_

|array_d_start_

|array_d_end_

,

 

number_ = ((str_p("0x")|str_p("0X"))>>hex_p)|int_p,

number  = number_>>*(whitespace),

 

unsigned_int_=((str_p("0x")|str_p("0X"))>>hex_p)|uint_p,

unsigned_int =unsigned_int_>>*(whitespace),

 

 

array_d_start = array_d_start_>>*(whitespace),

 

array_d_end   = array_d_end_>>*(whitespace),

 

assign_operate = assign_operate_>>*(whitespace),    

 

inherit_operate = inherit_operate_>>*(whitespace),

 

define_start = define_start_>>*(whitespace),

 

define_end = define_end_>>*(whitespace),

 

define_seperator = define_seperator_>>*(whitespace),

 

entry_seperator =entry_seperator_>>*(whitespace),

 

param_decl_start = param_decl_start_>>*whitespace,

 

param_decl_end = param_decl_end_>>*whitespace,

 

//enum

enum_assign_value = assign_operate>>number,

 

enum_entry  = identifer>>*enum_assign_value,

 

enum_header = enum_keyword_>>+whitespace>>identifer,

 

enum_define = enum_header

>>define_start

>>enum_entry      

>>*(entry_seperator>>(enum_entry))

>>!entry_seperator

>>define_end

>>define_seperator,

 

//structure

array_define= array_d_start

    >>!unsigned_int

    >>array_d_end,

 

variable_define = typedefine

>>identifer

>>*array_define ,

 

member_entry = variable_define>>define_seperator

,

struct_header =struct_keyword_>>+whitespace>>identifer

,

struct_parent = inherit_operate

>>inherit_keyword_

>>+whitespace>>identifer

,

struct_define =struct_header

       >>*struct_parent

       >>define_start

       >>+(member_entry)

       >>define_end

       >>define_seperator

,

 

//method

param_define  = variable_define>>

*(entry_seperator>>variable_define),

 

method_header = str_p("INT")>>+whitespace>>identifer,

 

method_define = method_header

    >>param_decl_start

    >>*(param_define)

    >>param_decl_end

    >>define_seperator

,

 

//inteface

interface_header = inteface_keyword_>>+whitespace>>identifer,

interface_define = interface_header

       >>define_start

       >>+(method_define)

       >>define_end

       >>define_seperator

,

 

//dispinterface

dispinterface_header = dispinterface_keyword_>>+whitespace>>identifer,

dispinterface_define = dispinterface_header

       >>define_start

       >>+(method_define)

       >>define_end

       >>define_seperator

,

 

//coclass

coclass_header = coclass_keyword_>>+whitespace>>identifer,

 

coclass_define = coclass_header

       >>define_start

       >>interface_define

       >>dispinterface_define

       >>define_end

>>define_seperator

);

 

11.改进需求

1.目前限制了interface与dispinterface必须配对，且才一对出现在coclass中，同时生成的代码中dispinterface和interface合并到一个类中,实践发现，这个不利于程序模块划分。因此，以下几点需要改进:

a. 必须出现一个以上的interface和dispinterface，但是不限制inteface和dispactch的数量.

b.每个inteface生成一个单独的类，同样每个dispinterface也生成一个单独的类.

c.生成interface和dispinterface生成时作为coclass的成员变量.

d.所有的数据从coclass进入，由dispactch统一分配指令号并分发调用.

 

2.  目前生成代码只支持actionscript和c++, 需要扩展支持PHP和JAVA.

3.       目前生成的代码中没有注释，希望可以把注释带到生成的代码中，这样便于更准确地描述接口给开发人员。

4.       定长数组，因为有不定长数组的存在，事实上定长数组是不定数组的一个子集，从理论上来说是无需保留的，但它的存在对于性能上有好处，值得商榷.

5.       STRINGW是UTF-16,对于大部分的脚本语言和解释语言，并不支持，需要不需要保留也值得商榷。

6.       某些协议可能需要定义些两方共用的字符串变量或其它数组型的常量，有必要引入const定义，鉴于数组在大部的语言中可以使用字符串的转义来表达，如”/x0/xf6/x78”，表示可以表示一个数组{0,0xf6,0x78}, 所以引入const保留定来表示常量的字符串即可满足上述要求。

 

7.  考虑对复杂的容器的支持，如MAP和SET，对应脚本语言的关联数组(Assoc Array之类)。这样可以避免cpp中传递这样的容器时候要转成一个array所造成的效率问题。

aerror
关注
didcomm-protocol-doc-generator:DID通信协议文档生成器
03-05
DID通信协议的文档生成器 我已经厌倦了手工编写协议和消息文档，所以我创建了这个工具来删除部分工作。 该工具接受JSON结构并生成Markdown文档。 JSON应该如下所示： { " https://example.com/my-protocol/1.0 " : { " description " : " Description of the protocol. " , " messages " : { " https://example.com/my-protocol/1.0/message-type " : { " name " : " message-type " , " description " : " description of the message " , " fields " : [ { " key
协议生成器工具
~生命淡如水~
06-16 3210
前言 何为协议生成器？其实就是前后端同学在对协议的时候使用的工具，手动添加对应的内容，最后一键发布自己需要的任何与协议有关的内容。 有人会说，我直接写proto文件用它的命令行也可以生成很多文件的。不过proto本身的能力，我工具都可以使用，因为本身工具就可以调用proto。下面开始介绍一下这款附带源码的工具 良心价格，买来不一定要用，但是你可以拿来学习这种思想；用什么语言开并不重要，重要的还是思想；编程编的就是思想，就跟写文章一样。 介绍 文件功能 定义服务 可能我门一款游戏用到好几个服务，比如登陆
各网络通讯协议汇总（一）- TCP/IP
oyzy_Sean的篝火
07-09 1588
一、OSI（Open System Interconnection） 我们先认识OSI参考模型的七层中每层的含义、作用、可用协议和设备。 OSI的七层模型具体如下图 （一）、物理层（信号和介质） 含义：在物理信道（机械、电子、定时接口通信信道）上实现原始比特流的传输。 作用：定义了通讯接口及介质的标准，以及将上层封装的数据转换为比特流方式进行传输。 协议：IEEE 802.2、Ethernet ...
三次握手
weixin_30609331的博客
05-24 108
TCP三次握手过程 1 主机A通过向主机B 发送一个含有同步序列号的标志位的数据段给主机B ,向主机B 请求建立连接,通过这个数据段, 主机A告诉主机B 两件事:我想要和你通信;你可以用哪个序列号作为起始数据段来回应我. 2 主机B 收到主机A的请求后,用一个带有确认应答(ACK)和同步序列号(SYN)标志位的数据段响应主机A,也告诉主机A两件事: 我已经收到你的请求了,你可以传输数据了;你要用哪...
网络通信协议
04-08
socket学习资料大全，包含网络通讯协议等方面的基础进阶资料。
快速了解PROFINET通讯协议以及相关产品如何解决客户现场实际问题
KITJI的博客
05-08 2008
PROFINET是一种新的以太网通讯系统，是由西门子公司和Profibus用户协会开发。PROFINET具有多制造商产品之间的通讯能力，自动化和工程模式，并针对分布式智能自动化系统进行了优化。其应用结果能够大大节省配置和调试费用。PROFINET系统集成了基于Profibus的系统，提供了对现有系统投资的保护。它也可以集成其它现场总线系统。PROFINET基于工业以太网,具有很好的实时性,可以直接连接现场设备(使用PROFINETIO),使用组件化的设计,PROFINET支持分布的自动化控制方式(PROFI
网络取证协议：识别网络犯罪来源及数字证据
沙特国王大学学报识别网络犯罪真实来源的网络取证调查协议Rachana Y.放大图片创作者：Patila，Satish R.德瓦恩湾aA.C.Patil College of Engineering，Kharghar，410210 Navi Mumbai，IndiabDatta Meghe College of ...
基础技术篇 9 ——物联网常见通信协议与通讯协议梳理【上】- 通讯协议
热门推荐
illusion116的专栏
07-17 1万+
微信公众号“智物客”和您免费分享物联网、智慧城市相关技术和项目解决方案。本文从物联网体系各层协议入手，重点分析了物联网体系常用的通讯协议，在下半部分，笔者将分享物联网体系的通信协议。
网络协议-BIO实战和NIO编程
weixin_43874650的博客
12-23 789
flip 方法将 Buffer 从写模式切换到读模式。调用 flip0)方法会将 position 设回 0,并将 limit设置成之前 position 的值。put 方法有很多版本，允许你以不同的方式把数据写入到 Buffer 中。例如， 写到一个指定的位置，或者把一个字节数组写入到 Buffer。put(byte b) 相对写，向 position 的位置写入一个 byte，并将 postion+1，为下次读写作准备。从 Channel 写到 Buffer 的例子。原生JDK网络编程-BIO。
一种可高度扩展的IM通讯协议
weixin_40976380的博客
10-12 547
这里写自定义目录标题欢迎使用Markdown编辑器新的改变功能快捷键合理的创建标题，有助于目录的生成如何改变文本的样式插入链接与图片如何插入一段漂亮的代码片生成一个适合你的列表创建一个表格设定内容居中、居左、居右SmartyPants创建一个自定义列表如何创建一个注脚注释也是必不可少的KaTeX数学公式新的甘特图功能，丰富你的文章UML 图表FLowchart流程图导出与导入导出导入 欢迎使用Ma...
bpdtool:二进制协议设计器工具
05-13
bpdtool-二进制协议设计器工具 下载二进制可执行文件： 概述 如果要使用C ++编写自己的客户端/服务器TCP / IP网络程序，则可能希望以数据包的形式发送和接收C struct对象。 由于TCP / IP是流协议，因此您很快就会注意到，除了核心结构内容之外，还需要数据包标识符和长度。 在某些受限环境中，您可以这样编写代码： // Shared protocol info file struct PacketBase { short id; short len; }; struct Action1Packet : PacketBase { int target; int param; }; # define ID_ACTION1 100 // sender void Socket::SendPacket ( short id, PacketBase* p
通信软件V1.0(自定义通信协议)
08-27
这是我最近开发的通信工具，具有客户机和服务器端。具有完整的用户登陆、注册、发送信息、增加好友、删除好友、添加组、删除组、查看好友信息。并且这个软件中具有自定义的开发协议，和一些安全机制。
Unity C# 网络学习（十一）——自定义协议生成工具
zzzsss123333的博客
06-27 743
在开发网络游戏中，协议是必不可少的东西，一款游戏可能有非常多的协议，但是协议的重复性非常高，而且前端后端都需要，人工完成显然不现实，可以通过共同的配置去生成我们的协议
完整网络协议自动生成工具
最新发布
听老罗娓娓道来
07-08 77
实现一个高扩展、高性能、高可配置的网络协议自动生成工具是一个复杂的任务。这个工具需要能够解析协议定义文件，生成相应的C#代码，并且支持多种协议格式（如JSON、XML、Protobuf等）。以下是一个详细的实现思路和代码示例。 1. 项目结构 首先，我们需要定义项目的结构： NetworkProtocolGenerator/ ├── Program.cs ├── ProtocolDefinition/ │ ├── IProtocolParser.cs │ ├── JsonProtocolParser
lin通信ldf文件解析_基于LIN协议的代码自动生成系统及方法_2014108531085_说明书_专利查询_专利网_钻瓜专利网...
weixin_39870199的博客
12-19 855
技术领域本发明属于汽车电子LIN网络通讯领域，公开了一种利用LDF文件自动生成LIN通讯软件代码的方法。背景技术目前汽车电子产品的软件开发逐渐向模块化、标准化、集成化、自动化发展。LIN通讯模块软件，在不同的项目中，客户需求(LDF文件)都不一样，每次都需要重新开发，严重的制约了产品开发的时间周期和稳定性。本发明可通过LDF文件自动生成LIN通讯软件代码，不仅提高了软件开发效率，还保证了软件的可靠...
网络协议解析数据设计和excel辅助生成代码
03-02 847
在设计一个网络协议解析的模块，实现网络协议解析和设置到底层服务程序的操作。软件控制流程为： 1、服务程序获取指令字符串。 2、查找对应指令操作函数，跳转执行。 3、指令操作函数查找指令参数，执行操作。 4、组装返回字符串，发送回客户端。 对于数据结构，尽量简洁明了。整个业务的流程很简单，比较繁琐的是指令的数量比较大。为了避免过多的代码编辑（switch case 或者if
uniqs的协议生成工具
uniqs 的博客
03-31 1060
由于他喵的GOOGLE PROTOBUF官网老是访问不了，于是本人决定自己写一个。有任何问题联系本人。可以直接下载：Uniqs协议生成工具直接下载https://download.csdn.net/download/u_1_n_2_i_3/10320175也可以SVN下载。 SVN地址：svn://gitee.com/uniqs/uniqsproto/官方网站：https://gitee.com/...
自动生成自增协议号
AllenJoe666的博客
05-19 1401
自动生成自增协议号生成规则代码展示 生成规则 生成规则为“AA+时间到天+四位数自增序列号”，如AA202005190001 代码展示 /** * 自动生成协议号 * 生成规则为“AA+时间到天+四位数自增序列号”，如SA202005190001 * @return */ private String generateAgreementCode(Long entId) { String agreementPrefix = "AA";
Qt学习（1）——如何基于TCP协议写一个通信小助手（服务器）界面，并生成自定义图标的.exe启动程序，以及将其打包发布
BinHeon的博客
07-30 909
Qt学习（1）——如何基于TCP协议写一个通信小助手（服务器）界面，并生成自定义图标的.exe启动程序   本次的任务要求：1、利用Qt，设计一个基于Tcp协议的通讯小助手；2、该助手作为服务器端；3、其拥有最基本的通信功能，能够提示服务器/客户端的ip以及端口信息、收发数据信息；4、根据自身需要，其具有一键发送自定义信息的按钮控件，用于发送特定信息给客户端，从而达到一种通过服务器发送指令去控制...
网络通讯协议详解：奥运版
"该资源是一份详尽的网络通讯协议图，特别以2008奥运版为主题，展示了当时各种网络协议之间的相互关系。图中包括了多种协议，如VIP、VINES、NetBIOS、IP、IPX、SNMP、TCP、UDP、SPX、AppleTalk、X.25、FTP、SMTP、...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值