阿里低代码引擎 | LowCodeEngine - 请求配置与调用指南

前言

在前端开发中，发送请求是非常常见且重要的一部分。阿里低代码引擎作为一款低代码开发平台，自然也提供了请求发送的功能。在阿里低代码引擎中，请求的配置是在数据源中进行的，数据源的位置如下图所示：

[数据源位置示意图]

配置界面如下图所示：

[数据源配置界面截图]

其中，数据源 ID 推荐使用小驼峰命名法。

请求配置

请求参数

在请求配置中，可以设置请求的参数。请求参数包括查询参数、路径参数和请求体参数三种。

• 查询参数：添加到请求 URL 中的参数，以 ? 开头，多个参数之间用 & 连接。例如：?name=John&age=20
• 路径参数：添加到请求 URL 路径中的参数，以 / 分隔。例如：/users/1
• 请求体参数：添加到请求体中的参数，通常用于 POST、PUT 等请求方法。例如：{"name": "John", "age": 20}

请求头

在请求配置中，还可以设置请求头。请求头是客户端发送给服务器的附加信息，用于请求的详细信息。常用的请求头包括：

• Content-Type：指定请求体的媒体类型，例如：application/json
• Accept：指定客户端希望服务器返回的媒体类型，例如：application/json
• Authorization：指定用于身份验证的凭证，例如：Bearer 123456

请求体

在请求配置中，还可以设置请求体。请求体是发送给服务器的数据，通常用于 POST、PUT 等请求方法。请求体的格式可以是 JSON、XML、文本等。

请求超时

在请求配置中，还可以设置请求超时时间。请求超时时间是指客户端等待服务器响应的最长时间。如果在超时时间内没有收到服务器响应，则请求将被中止。

重试次数

在请求配置中，还可以设置请求重试次数。请求重试次数是指在请求失败后，客户端重新发送请求的次数。如果请求失败，则客户端会根据重试次数进行重试，直到成功或达到最大重试次数。

请求调用

在配置好请求之后，就可以在代码中调用请求了。在阿里低代码引擎中，可以使用 request 方法来发送请求。request 方法的语法如下：

request(url, options)

其中：

• url：请求的 URL
• options：请求配置对象

options 对象可以包含以下属性：

• method：请求方法，例如：GET、POST、PUT 等
• params：请求参数
• headers：请求头
• data：请求体
• timeout：请求超时时间
• retry：请求重试次数

例如，以下代码发送一个 GET 请求到 https://example.com/api/users：

request('https://example.com/api/users')

以下代码发送一个 POST 请求到 https://example.com/api/users，并附带一个请求体：

request('https://example.com/api/users', {
  method: 'POST',
  data: {
    name: 'John',
    age: 20
  }
})

响应处理

在发送请求后，就可以对服务器的响应进行处理了。在阿里低代码引擎中，可以使用 then 方法来处理服务器的响应。then 方法的语法如下：

then(successCallback, errorCallback)

其中：

• successCallback：成功回调函数，在服务器响应成功时执行
• errorCallback：错误回调函数，在服务器响应失败时执行

例如，以下代码发送一个 GET 请求到 https://example.com/api/users，并在服务器响应成功时输出响应数据：

request('https://example.com/api/users').then((res) => {
  console.log(res.data)
})

以下代码发送一个 POST 请求到 https://example.com/api/users，并在服务器响应失败时输出错误信息：

request('https://example.com/api/users', {
  method: 'POST',
  data: {
    name: 'John',
    age: 20
  }
}).then((res) => {
  console.log(res.data)
}, (err) => {
  console.log(err.message)
})

高级特性

除了上述基本功能之外，阿里低代码引擎还提供了以下高级特性：

• 请求拦截：在请求发送之前对请求进行拦截，可以修改请求参数、请求头等信息
• 响应拦截：在服务器响应之后对响应进行拦截，可以修改响应数据、响应头等信息
• 请求缓存：将请求结果缓存起来，当下次发送相同的请求时，直接从缓存中获取结果，提高请求效率
• 请求取消：允许客户端取消正在进行的请求

结语

本文详细介绍了阿里低代码引擎中如何配置并调用请求，包括数据源配置、请求参数、请求头、请求体、请求超时、重试次数、响应解析、请求拦截、响应拦截、请求缓存、请求取消、代码示例等内容。希望本文能够帮助您轻松掌握请求的配置与调用。