# 修改请求

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

# 前提条件

已 新建请求。

# 操作步骤

1. 打开 vMessenger，在左侧菜单栏选择集合，进入集合界面。

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

# 修改请求名称

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、pingLnterval、pingTimeout、pingLost 等	单击参数名，在下拉列表框中选择目标参数，然后填写对应的参数值，支持设置多个参数 单击参数列表右上角的可以添加参数 单击参数最左侧的可以取消参数选择 单击参数最右侧的可以删除参数 单击参数列表右上角的可以清除所有参数	pingInterval：5000
   请求参数	客户端向服务端发送请求时的请求参数，对应 payload 的 param 参数，参数类型为 Object 或 String，支持以 JSON 或 Text 格式定义	单击请求参数，在请求参数页签左上角的下拉列表框中选择 None、Text 或 JSON，并按照对应的格式输入请求参数。当没有请求参数时，直接选择 None 即可	hello: 'hello'
   请求数据	设置客户端向服务端发送请求时的请求数据，对应 payload 的 data 参数，参数类型为 Buffer。支持的数据类型包括 Text/Plain、Base64 或文件	单击请求数据，在请求数据页签左上角的下拉列表框中选择 Text/Plain 、Base64 或上传文件，并输入请求数据。格式说明如下： 如果选择“Text”，则系统会自动将输入的数据信息转化为 UTF-8 编码格式 如果选择“Base64”，则系统会自动将输入的数据信息转化为 Base64 编码格式 如果选择“上传文件”，则单击上传文件，选择目标文件进行上传即可	name
   数据流	指传输连续的数据。如果服务端支持数据流（Steam），则客户端与服务端成功建立连接后，便可以持续发送请求数据。支持的数据类型包括 Text/Plain、Base64 或文件	单击数据流，在数据流页签左上角的下拉列表框中选择 Text/Plain 、Base64 或上传文件，并输入数据流信息。当客户端与服务端建立连接后，单击文本框右上角的发送，可以持续向服务端发送请求；若选择的是“上传文件”，则单击发送，数据发送成功后，vMessenger 会自动断开客户端连接	example

3. 修改完成后，单击发送，向服务端发送请求，测试服务端是否可以正常响应。响应参数说明请参见表 2。

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

   • 如果服务端支持数据流，则单击发送后，客户端会一直和服务端保持通信，此时可以在数据流页签持续发送类型为“Text/Plain”或“Base64”的请求数据，当要终止请求时，可以单击断开，断开本次客户端请求。

     

   表 2 响应参数说明

   参数	说明
   负载	即响应负载，指客户端向服务端发送请求时，服务端返回的响应结果，其中包含了 payload 的 param 和 data 参数
   数据流	当服务端需要向客户端传输较大的数据时，可以采用数据流方式进行传输，以提高传输效率和降低网络负载

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