# vMessenger 使用示例

当正在进行基于 VSOA 的客户端或服务端的开发工作时，可以使用 vMessenger 作为开发调试与数据模拟的工具，以提升产品开发效率。vMessenger 可以模拟客户端请求，向正在开发的服务端发送请求数据，以验证服务端是否可以正常响应。 也可以模拟服务端接收请求，并返回相应的数据，以验证客户端请求信息的准确性。

# 使用须知

本章节只对 vMessenger 最基本的客户端和服务端开发调试功能的使用进行介绍，更详细的使用说明请参考 vMessenger 使用手册。

# 前提条件

在学习本章节前需要完成如下配置：

• 安装 vMessenger

• 设置基础信息

# 模拟客户端

支持基于 VSOA 的 RPC、Datagram 和发布订阅等功能新建 VSOA 客户端请求，并向服务端发送请求，以验证服务端是否可以正常响应。 支持的请求类型包括 GET、SET、DGRAM、QDGRAM 和发布 / 订阅。

# 不使用位置服务

# RPC GET/SET

1. 本小节使用 RPC 服务端范例用于 RPC GET 调用。

2. 单击左侧边栏的集合，单击请求详情区域顶部的，可以新建一个名称为新的请求的临时请求。

   

3. 请求方式选择 GET 或 SET ，输入 RPC 服务器的 IP 地址、端口号和请求的资源路径，并且设置服务端密码，点击发送。

   

4. 请求发送成功结果如图所示。

   

# DGRAM / QDGRAM

1. 本小节使用 Datagram 服务端范例用于 DGARM 调用。

2. 参考 RPC GET/SET 的步骤一，新建临时请求。

3. 请求方式选择 DGRAM 或 QDGRAM ，输入 Datagram 服务器的 IP 地址、端口号和请求的资源路径等信息，点击发送。

   

4. 请求发送成功则响应状态码200 OK，同时在响应负载显示行号1，如图所示。

   

# 发布 / 订阅

1. 本小节使用发布 / 订阅服务端范例用于发布 / 订阅调用。

2. 单击左侧边栏的发布 / 订阅，单击请求详情区域顶部的，可以新建一个名称为新的发布 / 订阅的临时请求。

   

3. 输入发布 / 订阅服务器的 IP 地址、端口号和请求的资源路径，并且设置服务端密码，点击发送。

   

4. 请求发送成功结果如图所示。

   

# 使用位置服务

vMessenger 还支持直接通过资源标识进行资源请求。

1. 使用发布 / 订阅服务端范例搭建一个服务器用于发布 / 订阅调用。

2. 通过设置基础信息正确配置位置服务地址。

3. 输入发布 / 订阅服务器的资源标识和请求的资源路径，并且设置服务端密码，点击连接。

   

4. 请求发送成功结果如图所示。

   

# 模拟服务端

开发者进行 VSOA 客户端开发时，可以新建模拟服务器，并自定义服务端口号、IP 地址、请求方法、资源路径、响应参数和响应数据等信息来模拟服务端行为，与客户端进行交互，以验证客户端请求信息的准确性。

# 创建模拟服务器

1. 单击左侧边栏的模拟服务器，单击新建模拟服务器或新建发布 / 订阅模拟服务器，可以新建一个模拟服务器。

   

2. 在模拟服务器详情窗口，端口号文本框设置模拟服务器的端口号。单击 IP 地址下拉列表框，按需选择目标 IP 地址。

   

3. 在请求列表设置资源的请求方式、资源路径、响应参数等信息。

   

说明

发布 / 订阅服务器不需要选择资源的请求方式，但需要设置资源发布间隔。如模拟服务器需要携带响应数据或者通过数据流的方式响应，请点击右上角...，自行添加。

4. 设置完成后，单击右下角的保存，保存模拟服务器。

# 使用模拟服务器

点击左侧边栏集合，点击新的模拟服务器，选中任意一个资源，点击发送即可在下方负载处获取模拟服务器响应的内容。

也可通过 VSOA 的客户端对模拟服务器发出资源的请求以获得数据。如使用 vcx 工具对模拟服务器发送请求，则请求结果如下。