# 新建模拟服务器

开发者进行 VSOA 客户端开发时，可以新建模拟服务器来接收客户端消息，并返回响应数据，以验证客户端请求的准确性。vMessenger 支持针对 RPC、Datagram 和发布订阅类客户端请求，分别新建基础模拟服务器和发布订阅模拟服务器。

# 前提条件

已 安装 vMessenger。

# 操作步骤

1. 打开 vMessenger，确认当前 工作空间，按需新建、切换、修改或删除工作空间，然后在左侧菜单栏选择模拟服务器，进入模拟服务器界面。

2. 在模拟服务器界面，按需新建 基础模拟服务器 或 发布 / 订阅模拟服务器。

# 新建基础模拟服务器

此操作适用于新建通过 RPC、Datagram 方法开发的模拟服务器。

1. 在模拟服务器界面，通过如下几种方式新建模拟服务器：

   • 方式一：如果是首次新建模拟服务器，则单击中间区域的新建模拟服务器，打开模拟服务器详情窗口。如果本地有基础模拟服务器 JSON 文件，也可以单击导入模拟服务器，参考 导入模拟服务器 进行操作。

   • 方式二：如果已有模拟服务器，则单击模拟服务器列表右上方的新建 > 模拟服务器，打开模拟服务器详情窗口。

     

   • 方式三：如果上一步操作的是模拟服务器，则单击模拟服务器详情区域顶部的，打开模拟服务器详情窗口。

     

2. 在模拟服务器详情窗口，参考表 1 设置相关参数信息。

   表 1 新建模拟服务器参数说明

   参数	说明	设置方法	示例
   名称	模拟服务器的名称，默认为“新的模拟服务器”，支持自定义，建议定义为易识别的名称	单击模拟服务器详情区域左上角的默认名称，按需进行修改即可	example
   端口号	模拟服务器的端口号，建议为 [1024,65535] 范围内未被占用的端口号	直接在端口号文本框中输入端口信息，端口不可重复	3002
   IP 地址	本机网卡的 IP 地址，包括当前计算机的虚拟和物理 IP 地址等。默认 IP 地址为 0.0.0.0	单击 IP 地址下拉列表框，按需选择目标 IP 地址	0.0.0.0
   密码	服务端连接密码。如果服务端设置了密码，则请求中的客户端参数必须设置 passwd	直接在密码文本框中输入密码	-
   请求方法	设置服务端与客户端交互时使用的 VSOA 请求方法，服务端与客户端的请求方法应保持一致。支持的方法如下： GET：获取 RPC 请求 SET：设置 RPC 请求 DGRAM：指使用普通发送方式的 Datagram 请求 QDGRAM：指使用快速发送方式的 Datagram 请求	单击请求方法下拉列表框，按需选择目标请求方法	GET
   资源路径	设置请求的资源路径信息，用于定位服务端上的特定资源，必须以“/”开头	直接在资源路径文本框中输入要访问的路径信息	/axis
   响应参数	设置服务端向客户端返回的响应参数，对应 payload 的 param 参数，参数类型为 Object 或 String，支持以 JSON 或 Text 格式定义。此参数默认展示，可以单击请求列表右上角的，取消勾选响应参数选项	单击响应参数左侧的格式下拉列表框，选择所需的目标格式，然后在响应参数本文框中输入相应的参数信息。您也可以不设置格式，直接输入参数信息，系统会根据输入的内容自动调整格式。如果响应参数内容较多，可以在响应参数文本框中单击，打开编辑框进行设置	airspeed
   响应数据	设置服务端向客户端返回的响应数据，对应 payload 的 data 参数，参数类型为 Buffer。支持的数据类型包括 Text、Base64 或文件。此参数默认不展示，可以单击请求列表右上角的，勾选响应数据选项	单击响应数据左侧的格式下拉列表框，选择所需的目标格式，然后在响应数据本文框中输入相应的数据信息。格式说明如下： 如果选择“Text”，则系统会自动将输入的数据信息转化为 UTF-8 编码格式 如果选择“Base64”，则系统会自动将输入的数据信息转化为 Base64 编码格式 如果选择“上传文件”，则单击上传文件，选择目标文件进行上传即可	158
   数据流	指连续传输的数据，当服务端需要向客户端传输大量数据时，采用数据流方式可以提高传输效率并降低网络负载。如果服务端支持数据流（Stream），则客户端与服务端成功建立连接后，可以持续发送请求数据。支持的数据类型包括 Text、Base64 或文件。此参数默认不展示，可以单击请求列表右上角的，勾选数据流选项	单击数据流左侧的格式下拉列表框，按需选择目标格式，并在数据流本文框中输入相应的数据流信息。格式说明如下： 如果选择“Text”，则系统会自动将输入的数据流信息转化为 UTF-8 编码格式 如果选择“Base64”，则系统会自动将输入的数据流信息转化为 Base64 编码格式 如果选择“上传文件”，则单击上传文件，选择目标文件进行上传即可	example

   说明：

   • 如果要设置多组请求参数，则单击请求列表右上方的，添加参数。
   • 如果要删除某一组参数，则单击此参数列表最右侧的，删除对应参数。
   • 如果要删除所有参数，则单击参数列表右上方的，清除所有参数。

3. 设置完成后，单击右下角的保存，保存模拟服务器。保存模拟服务器的同时，会在集合模块中同步保存一份模拟服务器中的请求数据，方便开发者直接进行请求测试。

   • 保存后的模拟服务器界面如下图所示，模拟服务器的状态为“运行中”。

     

   • 保存后的请求数据如下图所示，每组数据会保存为一个单独的请求，请求 URL 和客户端参数 passwd 以变量{{url}}和{{passwd}}的形式展示，值为模拟服务器的端口号、IP 地址和密码信息。开发者可以参见 修改请求配置信息，设置请求的其他参数信息。

     
     注意：

     • 仅第一次保存模拟服务器时会在集合模块中同步保存一份请求数据，且集合中的请求数据与模拟服务器中的请求数据无关联关系，即保存后如果修改模拟服务器的配置信息，相关修改并不会同步至集合；同理，修改集合中的请求数据也不会同步至模拟服务器。
     • 如果请求设置了环境变量，且对应环境中定义了变量名为“url”和“passwd”的环境变量，则请求会优先引用环境中设置的变量信息；如果环境中未定义变量名为“url”和“passwd”的环境变量，则请求会默认引用对应模拟服务器的 IP 地址、端口号和密码信息，更多内容请参见 内置环境变量。

4. 在集合中选择一个请求，单击发送，测试是否可以和服务端通信。如果通信正常，则服务端会返回响应负载；同时，模拟服务器界面也会保存历史请求数据。单击，可以查看请求负载和响应负载详情。

   

# 新建发布 / 订阅模拟服务器

此操作适用于新建通过发布订阅方法开发的模拟服务器。

1. 在模拟服务器界面，通过如下几种方式新建模拟服务器：

   • 方式一：如果是首次新建模拟服务器，则单击中间区域的新建发布 / 订阅模拟服务器，打开发布 / 订阅模拟服务器详情窗口。如果本地有发布 / 订阅模拟服务器 JSON 文件，也可以单击导入模拟服务器，参考 导入模拟服务器 进行操作。

   • 方式二：如果已有模拟服务器，则单击模拟服务器列表右上方的新建 > 发布 / 订阅服务器，打开发布 / 订阅模拟服务器详情窗口。

     

   • 方式三：如果上一步操作的是发布 / 订阅模拟服务器，则单击模拟服务器详情区域顶部的，打开发布 / 订阅模拟服务器详情窗口。

     

2. 在发布 / 订阅模拟服务器详情窗口，参考表 2 设置相关参数信息。

   表 2 新建发布 / 订阅模拟服务器参数说明

   参数	说明	设置方法	示例
   名称	模拟服务器的名称，默认为“新的发布 / 订阅模拟服务器”，支持自定义，建议定义为易识别的名称	单击模拟服务器详情区域左上角的默认名称，按需进行修改即可	example
   端口号	模拟服务器的端口号，建议为 [1024,65535] 范围内未被占用的端口号	直接在端口号文本框中输入端口信息，端口不可重复	3006
   IP 地址	本机网卡的 IP 地址，包括当前计算机的虚拟和物理 IP 地址等。默认 IP 地址为 0.0.0.0	单击 IP 地址下拉列表框，按需选择目标 IP 地址	0.0.0.0
   密码	服务端连接密码。如果服务端设置了密码，则请求中的客户端参数必须设置 passwd	直接在密码文本框中输入密码	-
   资源路径	设置请求的资源路径信息，用于定位服务端上的特定资源，必须以“/”开头	直接在资源路径文本框中输入要访问的路径信息	/axis
   响应参数	设置服务端向客户端返回的响应参数，对应 payload 的 param 参数，参数类型为 Object 或 String，支持以 JSON 或 Text 格式定义。此参数默认展示，可以单击请求列表右上角的，取消勾选响应参数选项	单击响应参数左侧的格式下拉列表框，选择所需的目标格式，然后在响应参数本文框中输入相应的参数信息。您也可以不设置格式，直接输入参数信息，系统会根据输入的内容自动调整格式。如果响应参数内容较多，可以在响应参数文本框中单击，打开编辑框进行设置	pitch
   发布间隔	设置服务端发布消息的时间间隔，发布间隔需大于等于 1 ms。为了保证服务性能和稳定性，建议发布间隔大于等于 500 ms，默认发布间隔为 1 s	直接在发布间隔文本框中输入时间数字即可，单位默认为 ms	500
   响应数据	设置服务端向客户端返回的响应数据，对应 payload 的 data 参数，参数类型为 Buffer。支持的数据类型包括 Text、Base64 或文件。此参数默认不展示，可以单击请求列表右上角的，勾选响应数据选项	单击响应数据左侧的格式下拉列表框，选择所需的目标格式，然后在响应数据本文框中输入相应的数据信息。格式说明如下： 如果选择“Text”，则系统会自动将输入的数据信息转化为 UTF-8 编码格式 如果选择“Base64”，则系统会自动将输入的数据信息转化为 Base64 编码格式 如果选择“上传文件”，则单击上传文件，选择目标文件进行上传即可	name

   说明：

   • 如果要设置多组请求参数，则单击请求列表右上方的，添加参数。
   • 如果要删除某一组参数，则单击此参数列表最右侧的，删除对应参数。
   • 如果要删除所有参数，则单击参数列表右上方的，清除所有参数。

3. 设置完成后，单击右下角的保存，保存发布 / 订阅模拟服务器。保存模拟服务器的同时，会在发布 / 订阅模块中同步保存一份模拟服务器中的请求数据，方便开发者直接进行请求测试。

   • 保存后的模拟服务器界面如下图所示，模拟服务器的状态为“运行中”。

     

   • 保存后的请求数据如下图所示，每组数据会保存为一个单独的请求，请求 URL 和客户端参数 passwd 以变量{{url}}和{{passwd}}的形式展示，值为模拟服务器的端口号、IP 地址和密码信息。开发者可以参见 修改请求配置信息，设置请求的其他参数信息。

     
     注意：

     • 仅第一次保存发布 / 订阅模拟服务器时，会在发布 / 订阅模块中同步保存一份请求数据，且发布 / 订阅中的请求数据与模拟服务器中的请求数据无关联关系，即保存后如果修改模拟服务器的配置信息，相关修改并不会同步至发布/ 订阅；同理，修改发布 / 订阅中的请求数据也不会同步至模拟服务器。
     • 如果请求设置了环境变量，且对应环境中定义了变量名为“url”和“passwd”的环境变量，则请求会优先引用环境中设置的变量信息；如果环境中未定义变量名为“url”和“passwd”的环境变量，则请求会默认引用对应模拟服务器的 IP 地址、端口号和密码信息，更多内容请参见 内置环境变量。

4. 在发布 / 订阅模块对应集合中选择一个请求，单击连接，测试是否可以和服务端通信。如果通信正常，则响应数据区域会显示连接成功，并开始打印响应消息；同时，模拟服务器界面也会保存历史请求数据。