# 新建模拟服务器

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

# 操作步骤

1. 打开 vMessenger，在左侧菜单栏选择模拟服务器，进入模拟服务器界面。

2. 在模拟服务器界面，按需新建模拟服务器。

# 新建基础模拟服务器

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

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

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

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

     

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

     

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

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

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

   说明：

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

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

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

     

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

     
     注意：

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

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

   

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

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

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

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

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

     

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

     

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

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

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

   说明：

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

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

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

     

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

     
     注意：

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

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