当前位置：首页 > news >正文

QAxios研发笔记（二）：在Qt环境下基于Promise风格简化Http的Post请求

news 2025/11/3 6:36:30

QAxios研发笔记（二）：在Qt环境下基于Promise风格简化Http的Post请求

1、引言
2、研发背景与意义
- 2.1 使用Qt发送Post请求
- 2.2 使用前端Axios框架发送Post请求
- 2.3 本工作的意义
3、研发内容
- 3.1 构建C++的Promise对象
- 3.2 构建QAxios对象
- 3.3 封装Post请求
4、结果验证
- 4.1 使用Spring Boot搭建Http服务
- 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请求并处理响应，例如：

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请求。以下是其实现代码：

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类，用于封装请求参数：

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服务。以下是后端代码示例：

@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类定义如下：

public class Dog {private String name;private int age;// Getter和Setter方法@Overridepublic String toString() {return "Dog{" +"name='" + name + '\'' +", age=" + age +'}';}
}

4.2 使用QAxios发送Post请求

通过QAxios，我们可以轻松发送Post请求并处理响应：

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);
});