# 修改请求

为方便开发与调试，vMessenger 支持修改请求名称和请求方法、路径及参数等配置信息。

# 前提条件

已 新建请求 或通过 导入集合 导入请求。

# 操作步骤

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

2. 在集合界面，选择要修改的请求，按需修改请求相关信息。

# 修改请求名称

vMessenger 提供了如下两种请求名称修改方法：

• 直接双击名称修改

  在集合界面，双击要修改名称的请求，输入新的请求名称，按“Enter”键完成修改。

• 通过菜单修改

  1. 在集合界面，右键单击要修改的请求，或鼠标悬停至要修改的请求并单击，选择编辑，打开编辑请求对话框。

     

  2. 在编辑请求对话框中，按需修改请求名称。

     

  3. 单击保存，完成请求名称修改。

# 修改请求配置信息

1. 在集合界面，选中要修改配置信息的请求，打开请求详情界面。

2. 在请求详情界面，参考表 1 修改请求的配置信息。

   

   表 1 修改请求参数说明

   参数	说明	设置方法	示例
   请求方法	设置客户端与服务端交互时使用的 VSOA 请求方法。支持的方法如下： GET：获取 RPC 请求 SET：设置 RPC 请求 DGRAM：指使用普通发送方式的 Datagram 请求 QDGRAM：指使用快速发送方式的 Datagram 请求	单击请求类型右侧的，在下拉列表框中选择需要的请求类型	GET
   URL	请求路径，包括服务器 IP 地址、端口号和请求的资源路径等信息	直接在 URL 文本框中输入对应的路径信息。如果已 新建环境，则可以单击右上角的选择环境，在下拉列表框中选择目标环境，然后请求路径根据变量名进行定义即可。例如：环境的“变量名 1" 为 url，"变量值 1" 为 127.0.0.1:3002，"变量名 2" 为 path，"变量值 2" 为 radar，则 URL 127.0.0.1:3002/radar可以定义为 {{url}}/{{path}}，详情请参见 应用环境	127.0.0.1:3002/radar
   客户端参数	指创建客户端及客户端与服务端建立连接时需要的参数，如 passwd、pingInterval、pingTimeout、pingLost 等	单击参数名，在下拉列表框中选择目标参数，然后填写对应的参数值，支持设置多个参数 单击参数列表右上角的可以添加参数 单击参数最左侧的可以取消参数选择 单击参数最右侧的可以删除参数 单击参数列表右上角的可以清除所有参数	pingInterval：5000
   请求参数	客户端向服务端发送请求时的请求参数，对应 payload 的 param 参数，参数类型为 Object 或 String，支持以 JSON 或 Text 格式定义	单击请求参数，在请求参数页签左上角的下拉列表框中选择 JSON、Text 或 None，并按照对应的格式输入请求参数。当没有请求参数时，直接选择 None 即可	hello: 'hello'
   请求数据	设置客户端向服务端发送请求时的请求数据，对应 payload 的 data 参数，参数类型为 Buffer。支持的数据类型包括 Text/Plain、Base64 或文件	单击请求数据，在请求数据页签左上角的下拉列表框中选择 Text/Plain 、Base64 或上传文件，并输入请求数据。格式说明如下： 如果选择“Text”，则系统会自动将输入的数据信息转化为 UTF-8 编码格式 如果选择“Base64”，则系统会自动将输入的数据信息转化为 Base64 编码格式 如果选择“上传文件”，则单击上传文件，选择目标文件进行上传即可	name
   数据流	指连续传输的数据，当服务端需要向客户端传输大量数据时，采用数据流方式可以提高传输效率并降低网络负载。如果服务端支持数据流（Stream），则客户端与服务端成功建立连接后，便可以持续发送请求数据。支持的数据类型包括 Text/Plain、Base64 或文件	单击数据流，在数据流页签左上角的下拉列表框中选择 Text/Plain 、Base64 或上传文件，并输入数据流信息。当客户端与服务端建立连接后，单击文本框右上角的发送，可以持续向服务端发送请求；若选择的是“上传文件”，则单击发送，数据发送成功后，vMessenger 会自动断开客户端连接	example

3. 修改完成后，可以通过以下几种方式向服务端发送请求以测试其响应：鼠标悬停至请求名称处单击、单击请求 URL 后的发送，或直接按下“Ctrl+Enter”/“Command+Enter”键。响应参数说明请参见表 2。

   • 如果服务端不支持数据流，则发送请求后，服务端直接返回响应数据，本次请求结束。返回的响应数据支持格式化、取消格式化和复制。

   • 如果服务端支持数据流，且客户端请求的数据流格式为“Text/Plain”或“Base64”，则发送请求后，客户端将一直与服务端保持通信。此时可以持续发送流数据，当要终止请求时，可以单击断开以断开连接。如果数据流格式为文件，则请求发送成功后将自动断开连接。

     

   表 2 响应参数说明

   参数	说明
   响应	即响应负载，指客户端向服务端发送请求时，服务端返回的响应结果，包含 payload 的 param 和 data 参数，结果在响应页签展示。如果请求失败，系统会返回相应的错误码，详情请参见 错误码说明
   数据流	如果服务端支持数据流，且请求数据包含了数据流，则响应区域的数据流页签会返回相应的流传输结果，且响应区域右上角的数据流值为 True，否则为 False
   请求日志	即请求记录，每条记录包含请求的状态码（code）、消息（msg）、请求负载（request）和响应数据（response）等信息
   状态	VSOA 服务端返回的状态，各状态码说明请参见 VSOA 状态码
   时间	请求响应时间，单位为 ms
   大小	响应数据大小，单位为 Byte

4. 测试成功后，单击保存，将数据保存至数据库，方便后续测试与调试。