QAxios研发笔记（二）：在Qt环境下基于Promise风格简化Http的Post请求
- 1、引言
- 2、研发背景与意义
-
- [2.1 使用Qt发送Post请求](#2.1 使用Qt发送Post请求)
- [2.2 使用前端Axios框架发送Post请求](#2.2 使用前端Axios框架发送Post请求)
- [2.3 本工作的意义](#2.3 本工作的意义)
- 3、研发内容
-
- [3.1 构建C++的Promise对象](#3.1 构建C++的Promise对象)
- [3.2 构建QAxios对象](#3.2 构建QAxios对象)
- [3.3 封装Post请求](#3.3 封装Post请求)
- 4、结果验证
-
- [4.1 使用Spring Boot搭建Http服务](#4.1 使用Spring Boot搭建Http服务)
- [4.2 使用QAxios发送Post请求](#4.2 使用QAxios发送Post请求)
- 5、项目介绍
- 6、总结与展望
- 7、参考文献
1、引言
HTTP Post方法是一种常用的HTTP请求方法，主要用于向服务器提交数据。与Get方法不同，Post方法将请求参数包含在请求体中，适用于传输大量数据或敏感信息（如表单数据、文件上传等）。Post请求广泛应用于用户注册、登录、数据提交等场景。
在Qt环境下，发送Post请求通常需要手动处理网络请求的创建、参数的封装以及响应的处理。为了简化这一过程，我们研发了QAxios库，旨在为Qt开发者提供一个类似于前端Axios的HTTP请求库，支持Promise风格的异步操作，从而提升开发效率和代码可读性。
2、研发背景与意义
2.1 使用Qt发送Post请求
在Qt中，开发者通常使用QNetworkAccessManager类来发送HTTP请求。发送Post请求的典型流程包括：
- 创建
QNetworkRequest对象并设置请求头（如Content-Type）。 - 将请求参数封装为
QByteArray或QJsonObject。 - 使用
QNetworkAccessManager::post()方法发送请求。 - 处理异步响应，通常通过信号槽机制实现。
虽然Qt提供了完整的网络请求功能，但其API较为底层，开发过程中需要处理大量的重复性代码，尤其是在异步操作和错误处理方面。
2.2 使用前端Axios框架发送Post请求
在前端开发中，Axios是一个流行的HTTP客户端库，支持Promise风格的API。通过Axios，开发者可以轻松发送Post请求并处理响应，例如：
javascript
axios.post('/look', {
name: '勇勇',
age: 250
}).then(response => {
console.log(response.data);
}).catch(error => {
console.log(error);
});Axios的简洁性和灵活性使其成为前端开发的首选工具之一。
2.3 本工作的意义
QAxios的目标是将前端Axios的简洁性引入Qt开发环境。通过封装Qt的网络请求API并结合Promise风格的异步处理，QAxios能够显著简化HTTP Post请求的开发流程，提升开发效率。
3、研发内容
3.1 构建C++的Promise对象
Promise对象是实现异步操作的基础。我们参考了基于C++11实现的Promise库（基于C++11手撸前端Promise），构建了一个适用于Qt环境的Promise实现。通过Promise，开发者可以轻松处理异步操作的完成和失败状态。
3.2 构建QAxios对象
QAxios的核心是封装Qt的网络请求API，并提供类似Axios的API接口。我们参考了之前的工作（QAxios研发笔记（一）：在Qt环境下,构建Promise风格的Get请求接口），并在此基础上扩展了对Post请求的支持。
3.3 封装Post请求
我们实现了QAxios::post方法，用于发送Post请求。以下是其实现代码：
cpp
AxiosPromise* QAxios::post(const QString& url, IParam* param)
{
QNetworkRequest request;
request.setUrl(url);
request.setHeader(QNetworkRequest::ContentTypeHeader, QVariant("application/json"));
QNetworkReply* reply = m_networkAccessManager->post(request, param != nullptr ? param->toParam() : nullptr);
if (param != nullptr)
{
delete param;
param = nullptr;
}
return createAxiosPromise(reply);
}此外，我们还定义了IParam接口和Param类，用于封装请求参数：
cpp
class QAXIOS_EXPORT IParam
{
protected:
QJsonObject m_valueObject;
public:
QByteArray toParam();
};
class QAXIOS_EXPORT Param : public IParam
{
public:
static Param* param();
Param* addParam(const QString& name, int value);
Param* addParam(const QString& name, const QString& value);
};通过Param类，开发者可以轻松构建请求参数并发送Post请求。
4、结果验证
4.1 使用Spring Boot搭建Http服务
为了验证QAxios的功能，我们使用Spring Boot搭建了一个简单的HTTP服务。以下是后端代码示例：
java
@PostMapping("/look")
public ResultResponse<Boolean> look(@RequestBody Dog dog){
String message = String.format("%s是一条%d岁的老狗！", dog.getName(), dog.getAge());
System.out.println(message);
return ResultResponse.message(message);
}其中，Dog类定义如下：
java
public class Dog {
private String name;
private int age;
// Getter和Setter方法
@Override
public String toString() {
return "Dog{" +
"name='" + name + '\'' +
", age=" + age +
'}';
}
}4.2 使用QAxios发送Post请求
通过QAxios，我们可以轻松发送Post请求并处理响应：
cpp
QAxios* axios = QAxios::axios("axios");
Param* param = Param::param()
->addParam("name", QString::fromLocal8Bit("勇勇"))
->addParam("age", 250);
axios->post("http://127.0.0.1:8060/look", param)->then([=](ResultResponse result)-> void {
qDebug() << result.toString("message");
})->onCatch([=](const std::string& reason) {
qDebug() << QString::fromStdString(reason);
});运行上述代码后，控制台将输出：
勇勇是一条250岁的老狗！这表明QAxios成功发送了Post请求并处理了服务器的响应。
5、项目介绍
QAxios是一个开源项目，旨在为Qt开发者提供一个简洁、高效的HTTP请求库。项目地址如下：
https://gitee.com/shendeyidi/softwarer_qt
欢迎开发者参与贡献，共同完善QAxios的功能！
6、总结与展望
通过本文的介绍，我们展示了如何在Qt环境下基于Promise风格实现Post请求的简化。QAxios不仅支持Post请求，还提供了完整的Promise实现和灵活的参数封装机制，显著提升了Qt网络开发的效率。
未来，我们计划进一步扩展QAxios的功能，包括支持更多的HTTP方法（如Put、Delete等）、增强错误处理机制以及提供更丰富的请求头配置选项。我们期待QAxios能够成为Qt开发者网络开发的首选工具。
7、参考文献
【1†source】QAxios的目标是为Qt开发者提供一个类似于Axios的HTTP请求库，支持Promise
【2†source】QAxios研发笔记（一）：从Qt到Promise风格的Get请求接口设计逻辑