Класс QNetworkProxyQuery

Класс QNetworkProxyQuery используется для запроса настроек прокси для сокета. Подробнее...

• Список всех членов, включая унаследованные

Открытые типы

Открытые функции

Подробное описание

QNetworkProxyQuery хранит детали создаваемого сокета или выполняемого запроса. Он используется классами QNetworkProxy и QNetworkProxyFactory, чтобы приложения могли более точно контролировать, какие серверы прокси используются в зависимости от деталей запроса. Это позволяет приложению применять разные настройки в зависимости от протокола или имени хоста назначения, например.

QNetworkProxyQuery поддерживает следующие критерии для выбора прокси:

• тип запроса
• номер локального порта для использования
• имя хоста назначения
• номер порта назначения
• имя протокола, например «http» или «ftp»
• запрашиваемый URL

Имя хоста назначения — это хост в подключении в случае исходящих сокетов подключения. Это значение hostName передаваемое в QTcpSocket::connectToHost() или компонент хоста в запрашиваемом URL с помощью QNetworkRequest.

Номер порта назначения — это запрашиваемый порт для подключения в случае исходящих сокетов, а номер локального порта — это порт, который сокет хочет использовать локально перед попыткой внешнего подключения. В большинстве случаев номер локального порта используется только сокетами прослушивания (QTcpSocket) или сокетами дейтаграмм (QUdpSocket).

Имя протокола — это произвольная строка, указывающая тип выполняемого подключения. Например, она может соответствовать схеме URL, например «http», «https» и «ftp». В большинстве случаев выбор прокси не зависит от протокола, но эта информация предоставляется на случай, если можно сделать лучший выбор, например, выбрать кэширующий HTTP-прокси для подключений на основе HTTP, но более мощный прокси SOCKSv5 для всех остальных.

Некоторые из критериев могут не иметь смысла для всех типов запросов. В следующей таблице перечислены критерии, которые чаще всего используются в зависимости от типа запроса.

Следует отметить, что любой из критериев может отсутствовать или быть неизвестным (пустой QString для имени хоста или имени протокола, -1 для номеров портов). В этом случае функции, выполняющие запрос, должны сделать лучшее предположение или применить некоторые определённые реализацией значения по умолчанию.

См. также QNetworkProxy, QNetworkProxyFactory, QNetworkAccessManager и QAbstractSocket::setProxy.

Документация типов членов

перечисление QNetworkProxyQuery::QueryType

Описывает тип одного запроса QNetworkProxyQuery.

См. также queryType() и setQueryType().

Документация функций-членов

QNetworkProxyQuery::QNetworkProxyQuery(const QNetworkProxyQuery &other)

Создает объект QNetworkProxyQuery, являющийся копией other.

QNetworkProxyQuery::QNetworkProxyQuery(quint16 bindPort, const QString &protocolTag = QString(), QNetworkProxyQuery::QueryType queryType = TcpServer)

Создает QNetworkProxyQuery типа queryType и устанавливает тег протокола в protocolTag. Этот конструктор подходит для запросов QNetworkProxyQuery::TcpSocket, поскольку он устанавливает номер локального порта в bindPort.

Обратите внимание, что bindPort имеет тип quint16, чтобы указать точный запрашиваемый номер порта. Значение -1 (неизвестно) в данном контексте недопустимо.

См. также localPort().

QNetworkProxyQuery::QNetworkProxyQuery(const QString &hostname, int port, const QString &protocolTag = QString(), QNetworkProxyQuery::QueryType queryType = TcpSocket)

Создает QNetworkProxyQuery типа queryType и устанавливает тег протокола в protocolTag. Этот конструктор подходит для запросов QNetworkProxyQuery::TcpSocket, поскольку он устанавливает имя хоста удаленного узла в hostname и номер порта удаленного узла в port.

QNetworkProxyQuery::QNetworkProxyQuery(const QUrl &requestUrl, QNetworkProxyQuery::QueryType queryType = UrlRequest)

Создает QNetworkProxyQuery с URL requestUrl и устанавливает тип запроса в queryType.

См. также protocolTag(), peerHostName() и peerPort().

QNetworkProxyQuery::QNetworkProxyQuery()

Создает объект QNetworkProxyQuery по умолчанию. По умолчанию тип запроса будет QNetworkProxyQuery::TcpSocket.

QNetworkProxyQuery &QNetworkProxyQuery::operator=(const QNetworkProxyQuery &other)

Копирует содержимое other.

QNetworkProxyQuery::~QNetworkProxyQuery()

Удаляет этот объект QNetworkProxyQuery.

int QNetworkProxyQuery::localPort() const

Возвращает номер порта сокета, который будет принимать входящие пакеты от удаленных серверов, или -1, если порт неизвестен.

См. также peerPort(), peerHostName() и setLocalPort().

QString QNetworkProxyQuery::peerHostName() const

Возвращает имя хоста или IP-адрес запрашиваемого исходящего подключения, или пустую строку, если имя удалённого хоста неизвестно.

Если тип запроса QNetworkProxyQuery::UrlRequest, эта функция возвращает компонент хоста запрошенного URL.

См. также peerPort(), localPort() и setPeerHostName().

int QNetworkProxyQuery::peerPort() const

Возвращает номер порта для исходящего запроса или -1, если номер порта неизвестен.

Если тип запроса QNetworkProxyQuery::UrlRequest, эта функция возвращает номер порта запрошенного URL. Как правило, фреймворки будут заполнять номер порта из своих значений по умолчанию.

См. также peerHostName(), localPort() и setPeerPort().

QString QNetworkProxyQuery::protocolTag() const

Возвращает тег протокола для этого объекта QNetworkProxyQuery, или пустую QString в случае, если тег протокола неизвестен.

В случае запросов типа QNetworkProxyQuery::UrlRequest, эта функция возвращает значение компонента схемы URL.

См. также setProtocolTag() и url().

QNetworkProxyQuery::QueryType QNetworkProxyQuery::queryType() const

Возвращает тип запроса.

См. также setQueryType().

void QNetworkProxyQuery::setLocalPort(int port)

Устанавливает номер порта, который сокет хочет использовать локально для приема входящих пакетов от удаленных серверов, в port. Локальный порт чаще всего используется с типами запросов QNetworkProxyQuery::TcpServer и QNetworkProxyQuery::UdpSocket.

Допустимые значения: от 0 до 65535 (0 означает, что любой номер порта будет приемлем) или -1, что означает, что локальный номер порта неизвестен или неприменим.

В некоторых случаях, для специальных протоколов, локальный номер порта может также использоваться с запросом типа QNetworkProxyQuery::TcpSocket. В этом случае сокет указывает, что хочет использовать номер порта port при подключении к удалённому хосту.

См. также localPort(), setPeerPort() и setPeerHostName().

void QNetworkProxyQuery::setPeerHostName(const QString &hostname)

Устанавливает имя хоста исходящего подключения в hostname. Пустое имя хоста можно использовать для указания того, что удалённый хост неизвестен.

Имя хоста удалённого узла также может использоваться для указания ожидаемого исходного адреса входящего подключения в случае типов запросов QNetworkProxyQuery::UdpSocket или QNetworkProxyQuery::TcpServer.

См. также peerHostName(), setPeerPort() и setLocalPort().

void QNetworkProxyQuery::setPeerPort(int port)

Устанавливает запрашиваемый номер порта для исходящего подключения в port. Допустимые значения: от 1 до 65535 или -1 для указания того, что номер порта удалённого узла неизвестен.

Номер порта удалённого узла также может использоваться для указания ожидаемого номера порта входящего подключения в случае типов запросов QNetworkProxyQuery::UdpSocket или QNetworkProxyQuery::TcpServer.

См. также peerPort(), setPeerHostName() и setLocalPort().

void QNetworkProxyQuery::setProtocolTag(const QString &protocolTag)

Устанавливает тег протокола для этого объекта QNetworkProxyQuery в protocolTag.

Тег протокола — произвольная строка, которая указывает, какой протокол используется по сокету, например, "http", "xmpp", "telnet" и т. д. Тег протокола используется бэкендом для возвращения запроса, более специфичного для конкретного протокола: например, HTTP-соединение может использовать кэширующий HTTP-прокси-сервер, в то время как все остальные соединения используют более мощный прокси-сервер SOCKSv5.

См. также protocolTag().

void QNetworkProxyQuery::setQueryType(QNetworkProxyQuery::QueryType type)

Устанавливает тип запроса этого объекта на type.

См. также queryType().

void QNetworkProxyQuery::setUrl(const QUrl &url)

Устанавливает компонент URL этого объекта QNetworkProxyQuery на url. Установка URL также установит тег протокола, имя удалённого хоста и номер порта. Это делается для того, чтобы упростить реализацию кода, определяющего используемый прокси-сервер.

См. также url(), peerHostName() и peerPort().

[since 5.0] void QNetworkProxyQuery::swap(QNetworkProxyQuery &other)

Меняет местами этот экземпляр запроса прокси-сервера с other. Эта функция очень быстрая и никогда не вызывает ошибок.

Эта функция была добавлена в Qt 5.0.

QUrl QNetworkProxyQuery::url() const

Возвращает компонент URL этого объекта QNetworkProxyQuery в случае запроса типа QNetworkProxyQuery::UrlRequest.

См. также setUrl().

bool QNetworkProxyQuery::operator!=(const QNetworkProxyQuery &other) const

Возвращает true если этот объект QNetworkProxyQuery не содержит тех же данных, что и other.

bool QNetworkProxyQuery::operator==(const QNetworkProxyQuery &other) const

Возвращает true если этот объект QNetworkProxyQuery содержит те же данные, что и other.