含有章节索引的中文 文章模板

-- HD [2004-08-10 22:23:57]

1. OpenGNS协议规范

Version 1.0alpha

OpenGNS协议规范用以规定OpenGNS Client与OpenGNS Server、OpenGNS Server与OpenGNS Server之间沟通的信息内容、格式以及详细的说明。

1.1. 连接方式

OpenGNS的通信是基于TCP连接进行会话，会话方式为短连接。一个TCP短连接的会话通常会有以下几个步骤：

1. Client向Server发起TCP连接
2. Client向Server发送认证请求报文
3. Server向Client回头认证回复报文
4. 如认证不通过Server断开连接
5. 如认证通过Client向Server发送指定报文
6. Server向Client发送报文回复
7. Client向Server发送断开连接请求报文
8. Server向Client发送断开连接回复报文
9. Server断开该连接
10. Client断开该连接

短连接有以下特点：

1. 由Client发起连接和请求报文
2. 按需连接
3. 每次连接的请求报文是按顺序发送，得到回复报文后再发送下一条报文
4. 报文发送完成后就会断开TCP连接

2. 报文定义

2.1. 报文格式定义

所有的报文包括两部分：

每条报文的报头长度和字段定义完全相同，而报体依据所发送的报文不同而自定义。所有报文的定义请见报头定义一节，报体的定义可见报体定义一节，具体的报文ID定义请见报文ID定义一节。

2.2. 数据格式定义

在报文中只会使用到两种数据格式：

int和unit长度为4个字节，string是由n个长度为8位的char组成。

2.3. 报头定义

由于系统的报文发送方式为短连接，所以报头只需要定义以下字段：

size定义了报文全部的长度，msgid定义了报文的ID，msgid的内容必须已经在报文ID定义中说明的数值。

2.4. 报文ID定义

报文ID定义说明了OpenGNS所支持的请求和回复报文的名称、编码、说明。 在定义中遵循了以下规则：

• 请求报文以第一位均为0
• 对应请求报文的回复报文高位均为一个f，其它与请求报文相同

2.4.1. 通用报文

通用报文是指无论客户机和服务器在任何情况下都会使用到的报文。

2.4.2. GNS服务标准操作

||

2.5. 报体定义

2.5.1. 通用报文

2.5.1.1. 请求连接到服务器（GNS_CONNECT）

GNS_CONNECT用于让客户机在连接完成后向服务器进行认证连接的操作，在注册认证能过后即在客户机和服务器间建立了应用层的连接，就可以进行进一步的报文请求操作。服务器端会向客户机回复GNS_CONNECT_RESP响应请求。

2.5.1.1.1. GNS_CONNECT定义（C->S）

2.5.1.1.2. GNS_CONNECT_RESP定义（S->C）

2.5.1.2. 断开连接请求（GNS_DISCONNECT）

GNS_DISCONNECT用于客户机和服务器拆除应用层的连接，拆除连接后对方会在回复报文后断开TCP的连接。

2.5.1.2.1. GNS_DISCONNECT定义（C<->S）

无报文体。

2.5.1.2.2. GNS_DISCONNECT_RESP定义（C<->S）

无报文体。

2.5.2. GNS服务标准操作

2.5.2.1. 注册服务（GNS_RESERVICE）

任何一个服务在启动时，都有义务向GNS服务器通知其在线工作。通过向GNS的通知，就使得应用系统中增加了一个服务。

2.5.2.1.1. GNS_RESERVICE定义（C->S）

2.5.2.1.2. GNS_RESERVICE定义（C->S）

2.5.2.2. 注销服务（GNS_DERESERVICE）

任何一个服务在停止时，都有义务向GNS服务器通知其下线停止工作。通过向GNS的通知，就使得应用系统中将一个服务取消。

2.5.2.2.1. GNS_DERESERVICE定义

2.5.2.2.2. GNS_DERESERVICE_RESP定义