# QtMultiThreadNetwork-master

**Repository Path**: iggi128/QtMultiThreadNetwork-master

## Basic Information

- **Project Name**: QtMultiThreadNetwork-master
- **Description**: Qt 多线程网络请求库，异步并发任务，支持停止单个任务和所有任务
- **Primary Language**: Unknown
- **License**: LGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2025-06-29
- **Last Updated**: 2025-06-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

Qt multi-threaded network module
==============================================================================================================================
@version:	2.1.1   
@Author:	Vilas Wang  
@Contact:	QQ451930733 | 451930733@qq.com  



> 
Copyright © 2016-2019 Vilas Wang. All rights reserved.

** QtMultiThreadNetwork is free libraries licensed under the term of LGPL v3.0.
If you use QtMultiThreadNetwork or its constituent libraries, you must adhere to the terms of the license in question. **


目前该库支持在windows平台下编译成功，其它平台若有编译不过，请自行增加兼容代码。
openssl x86 x64库下载地址：https://github.com/VilasWang/3rd_Dev_Library.git




## Detailed Description

The Qt multi-threaded network module is a wrapper of `Qt Network module`, and combine with `thread-pool` to realize multi-threaded networking.
- Multitask concurrent(Each request task is executed in different threads).
- Both single request and batch request mode are supported.
- Large file `multi-thread downloading` supported. (The thread here refers to the download channel. Download speed is faster)
- `HTTP(S)`/`FTP` protocol supported.
- Multiple request methods supported. (`GET`/`POST`/`PUT`/`DELETE`/`HEAD`)
- Asynchronous API.
- Thread-safe.

Note:	You must call `NetworkManager::initialize()` before use, and call `NetworkManager::unInitialize()` before application quit. 
	That must be called in the main thread.


Qt多线程网络模块是对Qt Network的封装，并且结合线程池以实现多线程网络请求，
- 多任务并发执行（每个请求任务在不同的线程中执行）
- 支持单请求任务或批处理请求两种请求模式
- 支持大文件`多线程下载`模式（这里的线程是指下载的通道。多个通道同时下载, 下载速度更快）
- 支持`HTTP(S)`/`FTP`协议
- 支持多种请求方式（`GET`/`POST`/`PUT`/`DELETE`/`HEAD`）
- 异步调用
- 所有方法线程安全

注意:	在使用之前，你必须先调用`NetworkManager::initialize()`，并且在程序退出前调用`NetworkManager::unInitialize()`.
	初始化和反初始化都必须在主线程中被调用。



## How to use

```CPP
#include "networkdefs.h"
#include "networkmanager.h"
#include "networkreply.h"
```

>Main thread：
>

```CPP
//使用之前调用
NetworkManager::initialize();

//程序退出前调用
NetworkManager::unInitialize();
```




### How to download a file by using Qt multi-threaded network module? (Or otehr request?)

>Download file:
```CPP
RequestTask task;
task.eType = RequestType::Download;
task.url = QString("http://pic2.52pk.com/files/131112/2255194_1405292P.png");
task.strReqArg = QString("D:/Download");
task.bShowProgress = true;
task.bReplaceFileIfExist = true;
task.bTryAgainIfFailed = true;
task.nMaxRedirectionCount = 5;

NetworkReply *pReply = NetworkManager::globalInstance()->addRequest(task);
if (nullptr != pReply)
{
	connect(pReply, &NetworkReply::requestFinished, this, &T::onRequestFinished);
}
```

>Upload file:
```CPP
RequestTask task;
task.url = QString("http://127.0.0.1:80/_php/upload.php?filename=upload/test.png");
task.eType = RequestType::Upload;
task.strReqArg = QString("resources/1.png"); //local file path
task.bShowProgress = true;
task.bTryAgainIfFailed = true;
task.nMaxRedirectionCount = 5;
task.bUploadUsePut = true;

NetworkReply *pReply = NetworkManager::globalInstance()->addRequest(task);
if (nullptr != pReply)
{
	connect(pReply, &NetworkReply::requestFinished, this, &T::onRequestFinished);
}
```

>GET method:
```CPP
RequestTask task;
task.url = QString("http://m.kugou.com/singer/list/88?json=true");
task.eType = RequestType::Get;
task.bTryAgainIfFailed = true;
task.nMaxRedirectionCount = 5;

NetworkReply *pReply = NetworkManager::globalInstance()->addRequest(task);
if (nullptr != pReply)
{
	connect(pReply, &NetworkReply::requestFinished, this, &T::onRequestFinished);
}
```

>POST method:
```CPP
RequestTask task;
task.url = QString("https://passportservice.7fgame.com/HttpService/PlatService.ashx");
task.eType = RequestType::Post;
task.strReqArg = "userId=121892674&userName=33CxghNmt1FhAA==&st=QQBnAEEAQQBBAEUATAB2AFEAdwBjAEEAQQBBAEEAQQBBAEEAQQBBAEEATAB2AFAANwBoAE4AcwBJAC8AbwBWAFMAQQArAEQAVgBIADIAdgAyAHcARgBRAGYANABJAHkAOQA3AFAAYQBkAFMARwBoAEoAKwBUAEoAcAAzADkAVgBYAFYAMwBDAE4AVABiAHEAZQB3AE4AMAANAAoAOABlAHUANQBBAHMAUwBYAFEAbQAyAFUAWQBmAHEAMgA1ADkAcQBvAG4AZQBCAFEAYgB5AE8ANwAyAFQAMQB0AGwARwBIADYAdAB1AGYAYQBxAEoAMwBnAFUARwA4AGoAdQA5AGsAOQBzAFoAYQB1AHAARwBjAE8ANABnADIAegBnADIANgB1AEcANwBoAHAAUwBHADIAVQANAAoAWQBmAHEAMgA1ADkAcQBvAG4AZQBCAFEAYgB5AE8ANwAyAFQAMAA9AA==";
task.bTryAgainIfFailed = true;
task.nMaxRedirectionCount = 5;

NetworkReply *pReply = NetworkManager::globalInstance()->addRequest(task);
if (nullptr != pReply)
{
	connect(pReply, &NetworkReply::requestFinished, this, &T::onRequestFinished);
}
```

>DELETE method:
```CPP
RequestTask task;
task.url = QString("http://127.0.0.1:80/_php/delete.php?filename=upload/test.txt");
task.eType = RequestType::Delete;
task.bTryAgainIfFailed = true;

NetworkReply *pReply = NetworkManager::globalInstance()->addRequest(task);
if (nullptr != pReply)
{
	connect(pReply, &NetworkReply::requestFinished, this, &T::onRequestFinished);
}
```

>HEAD method:
```CPP
RequestTask task;
task.url = QString("http://iso.mirrors.ustc.edu.cn/qtproject/archive/qt/5.12/5.12.1/single/qt-everywhere-src-5.12.1.zip");
task.eType = RequestType::Head;
task.bTryAgainIfFailed = true;

NetworkReply *pReply = NetworkManager::globalInstance()->addRequest(task);
if (nullptr != pReply)
{
	connect(pReply, &NetworkReply::requestFinished, this, &T::onRequestFinished);
}
```


### How to download a batch of files by using Qt multi-threaded network module? (such as updating application)

```cpp
connect(NetworkManager::globalInstance(), &NetworkManager::batchDownloadProgress,
	this, &T::onBatchDownloadProgress);
	
connect(NetworkManager::globalInstance(), &NetworkManager::batchUploadProgress,
	this, &T::onBatchUploadProgress);

BatchRequestTask tasks;
RequestTask task;
foreach (const QString& strUrl, strlstUrl)
{
	task.url = QDir::fromNativeSeparators(strUrl);
	task.eType = RequestType::Download;
	task.strReqArg = QString("save file dir");
	task.bShowProgress = true;
	tasks.append(std::move(task));
}
```

>A batch of requests corresponding to one NetworkReply object
> 
```cpp
quint64 uiBatchId = 0;
NetworkReply *pReply = NetworkManager::globalInstance()->addBatchRequest(tasks, uiBatchId);
qDebug() << "uiBatchId: " << uiBatchId;
if (nullptr != pReply)
{
	connect(pReply, &NetworkReply::requestFinished, this, &T::onRequestFinished);
}
```


### How to stop request?

>Stop a request
> 
```cpp
quint64 uiTaskId = 1;
NetworkManager::globalInstance()->stopRequest(uiTaskId);
```

>Stop a batch of requests
> 
```cpp
quint64 uiTaskBatchId = 1;
NetworkManager::globalInstance()->stopBatchRequests(uiTaskBatchId);
```

>Stop all requests
> 
```cpp
NetworkManager::globalInstance()->stopAllRequest();
```