
🔥小陈又菜: 个人主页
📖个人专栏: 《MySQL:菜鸟教程》《小陈的C++之旅》《Java基础》
✨️想多了都是问题,做多了都是答案!

目录
[1. QTcpServer](#1. QTcpServer)
[1.1. 公共成员函数](#1.1. 公共成员函数)
[1.2. 信号](#1.2. 信号)
当接收新连接导致错误时,发射如下信号,SocketError参数参数描述了发生的错误信息:
[每次有新连接时发送信号newConnection() 信号:](#每次有新连接时发送信号newConnection() 信号:)
[2. QTcpScoket](#2. QTcpScoket)
[2.1. 公共成员函数](#2.1. 公共成员函数)
[2.2. 信号](#2.2. 信号)
[在使用QTcpSocket进行套接字通信时,如果该类对象发射readyRead()信号,说明对端发送的的数据达到了,之后就可以调用 read函数 接收数据了:](#在使用QTcpSocket进行套接字通信时,如果该类对象发射readyRead()信号,说明对端发送的的数据达到了,之后就可以调用 read函数 接收数据了:)
调用connectToHost()函数并成功建立连接之后发出connected()信号:
在标准C++中没有提供专门用于套接字通信类,所以只能使用操作系统的基于C的API函数,基于这些C的函数我们也可以连接自己的C++类。但是Qt不一样,它是一个C++的框架,提供了用于套接字通信的类(当然在Qt中使用标准C的API函数也是可以的)。
使用Qt提供的类进行基于TCP的套接字通信需要用到两个类:
- QTcpServer:服务器类,用于监听客户端连接以及和客户端建立连接
- QTcpSocket:通信的套接字类,客户端、服务器端都需要使用
这两个套接字通信类都属于网络模块network
1. QTcpServer
QTcpServer类用于监听客户端连接以及和客户端建立连接,在使用之前先介绍一下这个类提供的一些常用API函数:
1.1. 公共成员函数
构造函数:
QTcpServer::QTcpServer(QObject *parent = Q_NULLPTR);
给监听的套接字设置监听:
bool QTcpServer::listen(const QHostAddress &address = QHostAddress::Any, quint16 port = 0);
// 判断当前对象是否在监听, 是返回true,没有监听返回false
bool QTcpServer::isListening() const;
// 如果当前对象正在监听返回监听的服务器地址信息, 否则返回 QHostAddress::Null
QHostAddress QTcpServer::serverAddress() const;
// 如果服务器正在侦听连接,则返回服务器的端口; 否则返回0
quint16 QTcpServer::serverPort() const;
参数:
- address:通过类QHostAddress可以封装IPv4、IPv6格式的IP地址,QHostAddress::Any表示自动绑定
- port:如果指定为0表示随机绑定一个可用端口
返回值:绑定成功返回true,失败返回false
得到一个QTcpSocket套接字对象:
QTcpSocket *QTcpServer::nextPendingConnection();
它是一个QTcpServer的子对象,当QTcpServer对象析构时QTcpSocket对象也会自动析构(但还是建议手动析构这个通信对象)。
阻塞等待客户端发起请求连接:
bool QTcpServer::waitForNewConnection(int msec = 0, bool *timedOut = Q_NULLPTR);
参数:
- msec:指定阻塞的最大时长
- timeout:传出参数,如果操作超时timeout为true,没有超时timeout为false
1.2. 信号
当接收新连接导致错误时,发射如下信号,SocketError参数参数描述了发生的错误信息:
[signal] void QTcpServer::acceptError(QAbstractSocket::SocketError socketError);
每次有新连接时发送信号newConnection() 信号:
[signal] void QTcpServer::newConnection();
2. QTcpScoket
QTcpSocket是一个套接字通信类,不管是客户端还是服务器端都需要使用。在Qt中发送和接收数据也属于IO操作(网络IO),先来看一下这个类的继承关系:

2.1. 公共成员函数
构造函数:
QTcpSocket::QTcpSocket(QObject *parent = Q_NULLPTR);
连接服务器,需要指定服务器绑定的端口IP和端口信息:
[virtual] void QAbstractSocket::connectToHost(const QString &hostName, quint16 port, OpenMode openMode = ReadWrite, NetworkLayerProtocol protocol = AnyIPProtocol);
[virtual] void QAbstractSocket::connectToHost(const QHostAddress &address, quint16 port, OpenMode openMode = ReadWrite);
接收数据:
// 指定可接收的最大字节数 maxSize 的数据到指针 data 指向的内存中
qint64 QIODevice::read(char *data, qint64 maxSize);
// 指定可接收的最大字节数 maxSize,返回接收的字符串
QByteArray QIODevice::read(qint64 maxSize);
// 将当前可用操作数据全部读出,通过返回值返回读出的字符串
QByteArray QIODevice::readAll();
在Qt中不管调用读操作函数接收数据,还是调用写函数发送数据,操作的对象都是本地的由Qt框架维护的一块内存。因此,调用了发送函数数据不一定会马上被发送到网络中,调用了接收函数也不是直接从网络中接收数据,关于底层的相关操作是不需要使用者来维护的。
发送数据:
// 指定可接收的最大字节数 maxSize 的数据到指针 data 指向的内存中
qint64 QIODevice::read(char *data, qint64 maxSize);
// 指定可接收的最大字节数 maxSize,返回接收的字符串
QByteArray QIODevice::read(qint64 maxSize);
// 将当前可用操作数据全部读出,通过返回值返回读出的字符串
QByteArray QIODevice::readAll();
2.2. 信号
在使用QTcpSocket进行套接字通信时,如果该类对象发射readyRead()信号,说明对端发送的的数据达到了,之后就可以调用 read函数 接收数据了:
[signal] void QIODevice::readyRead();
调用connectToHost()函数并成功建立连接之后发出connected()信号:
[signal] void QAbstractSocket::connected();
在套接字断开连接时发出disconnected()信号:
[signal] void QAbstractSocket::disconnected();
本篇完