Редактирование: Qt:Документация 4.3.2/qtnetwork

{{Qt4.3.2_header}}

[Назад: [[Qt:Документация 4.3.2/qtgui | QtGui Module]]] [ [[Qt:Документация 4.3.2/modules | Qt's Modules]] ][Далее: [[Qt:Документация 4.3.2/qtopengl | QtOpenGL Module]]]

=Модуль QtNetwork<br />=
Модуль QtNetwork предоставляет классы, для написания TCP/IP клиентов и серверов. [[#details | Подробней...]]

==Пространство имен==

{|  width="100%" class="annotated" cellpadding="2" cellspacing="1" border="0"
|- valign="top" class="odd" | 
![[Qt:Документация 4.3.2/qssl | QSsl]]
|Хранит обьявления enum'ов общих для всех SSL классов в QtNetwork модуле
|}

==Классы==

{|  width="100%" class="annotated" cellpadding="2" cellspacing="1" border="0"
|- valign="top" class="odd" | 
![[Qt:Документация 4.3.2/qabstractsocket | QAbstractSocket]]
|Базовый функционал, общий для всех типов сокетов
|- valign="top" class="even" | 
![[Qt:Документация 4.3.2/qauthenticator | QAuthenticator]]
|Обьект аутентификации
|- valign="top" class="odd" | 
![[Qt:Документация 4.3.2/qftp | QFtp]]
|Реализация клиентской стороны FTP протокола 
|- valign="top" class="even" | 
![[Qt:Документация 4.3.2/qhostaddress | QHostAddress]]
|IP адресс
|- valign="top" class="odd" | 
![[Qt:Документация 4.3.2/qhostinfo | QHostInfo]]
|Статические функции для поиска имен
|- valign="top" class="even" | 
![[Qt:Документация 4.3.2/qhttp | QHttp]]
|Реализация HTTP протокола 
|- valign="top" class="odd" | 
![[Qt:Документация 4.3.2/qhttpheader | QHttpHeader]]
|Заголовочная информация для HTTP
|- valign="top" class="even" | 
![[Qt:Документация 4.3.2/qhttprequestheader | QHttpRequestHeader]]
|Заголовочная информация HTTP запроса
|- valign="top" class="odd" | 
![[Qt:Документация 4.3.2/qhttpresponseheader | QHttpResponseHeader]]
|Заголовочная информация HTTP ответа
|- valign="top" class="even" | 
![[Qt:Документация 4.3.2/qnetworkaddressentry | QNetworkAddressEntry]]
|Хранит один IP адрес поддерживаемый сетевым интерфейсом, вместе с маской сети и broadcast address
|- valign="top" class="odd" | 
![[Qt:Документация 4.3.2/qnetworkinterface | QNetworkInterface]]
|Список IP адресов компьютеров и сетевых интерфейсов
|- valign="top" class="even" | 
![[Qt:Документация 4.3.2/qnetworkproxy | QNetworkProxy]]
|Работа с прокси
|- valign="top" class="odd" | 
![[Qt:Документация 4.3.2/qsslcertificate | QSslCertificate]]
|Традиционное API для сертификатов X509
|- valign="top" class="even" | 
![[Qt:Документация 4.3.2/qsslcipher | QSslCipher]]
|Работа с SSL криптографией
|- valign="top" class="odd" | 
![[Qt:Документация 4.3.2/qsslerror | QSslError]]
|SSL ошибка 
|- valign="top" class="even" | 
![[Qt:Документация 4.3.2/qsslkey | QSslKey]]
|Интерфейс для закрытых и открытых ключей
|- valign="top" class="odd" | 
![[Qt:Документация 4.3.2/qsslsocket | QSslSocket]]
|Зашифрованный SSL socket для клиентов и серверов
|- valign="top" class="even" | 
![[Qt:Документация 4.3.2/qtcpserver | QTcpServer]]
|TCP сервер 
|- valign="top" class="odd" | 
![[Qt:Документация 4.3.2/qtcpsocket | QTcpSocket]]
|TCP сокет 
|- valign="top" class="even" | 
![[Qt:Документация 4.3.2/qudpsocket | QUdpSocket]]
|UDP сокет 
|- valign="top" class="odd" | 
![[Qt:Документация 4.3.2/qurlinfo | QUrlInfo]]
|Хранилище информации о URL'ях
|}

==Детальное описание==
Модуль работы с сетью, предоставляет классы, которые помогают сделать сетевое программирование проще и переносимей. Он предлагает как классы высокого уровня, такие как [[Qt:Документация 4.3.2/qhttp | QHttp]] и [[Qt:Документация 4.3.2/qftp | QFtp]], которые имплементируют специфичные протоколы уровня приложений, и классы низкого уровня, такие как [[Qt:Документация 4.3.2/qtcpsocket | QTcpSocket]], [[Qt:Документация 4.3.2/qtcpserver | QTcpServer]], и [[Qt:Документация 4.3.2/qudpsocket | QUdpSocket]].

Модуль QtNetwork является частью [[Qt:Документация 4.3.2/commercialeditions#qt-console-edition | Qt Console Edition]], [[Qt:Документация 4.3.2/commercialeditions#qt-desktop-edition | Qt Desktop Edition]], и [[Qt:Документация 4.3.2/opensourceedition | Qt Open Source Edition]].

===Конфигурирование процесса сборки===
Приложения, которые используют сетевые классы Qt, нужно сконфигурировать, чтобы их можно было собрать с модулем QtNetwork. Следующая декларация в файле проекта qmake гарантирует, что приложение будет собрано и связано с данным модулем:
<source lang="cpp-qt"> QT += network</source> 
Эта строка необходима, так как по умолчанию только модули [[Qt:Документация 4.3.2/qtcore | QtCore]] и [[Qt:Документация 4.3.2/qtgui | QtGui]] используются в процессе сборки.

Чтобы включить определения классов данного модуля, используйте следующую директиву:
<source lang="cpp-qt"> #include <QtNetwork></source> 
===Написание  HTTP и FTP клиентов с помощью  классов QHttp и QFtp===
HTTP (Hypertext Transfer Protocol) является протоколом сети прикладного уровня, который используется главным образом для того, чтобы загружать HTML и XML файлы, а также как транспортный протокол высокого уровня для многих других типов данных, от картинок и кинофильмов, до заказов на поставку и банковским операциям.  FTP (File Transfer Protocol)  используется исключительно для просмотра удаленных директорий и для передачи файлов.

[[Image:httpstack.png|center]]

HTTP более простой протокол чем FTP. Он использует одно сетевое соединение, FTP же использует два (одно для отправки команд, другое для передачи данных). У HTTP протокола нет своего состояния; Запросы и ответы выполняются всегда раздельно. У FTP протокола имеется свое состояние и он требует, чтобы клиент послал некоторое количество команд, прежде чем начать передачу файла.

Практически, клиенты HTTP часто используют отдельные соединения для отдельных запросов, тогда как клиенты FTP устанавливают одно соединение и держат его открытым в течении всей сессии. 

Классы [[Qt:Документация 4.3.2/qhttp | QHttp]] и [[Qt:Документация 4.3.2/qftp | QFtp]]  предоставляют поддержку протоколов HTTP и FTP на клиентской стороне. Так как эти два протокола используются для решении похожих задач, [[Qt:Документация 4.3.2/qhttp | QHttp]] и [[Qt:Документация 4.3.2/qftp | QFtp]] классы имеют много общих особенностей:

*''Не блокирующее поведение .'' [[Qt:Документация 4.3.2/qhttp | QHttp]] и [[Qt:Документация 4.3.2/qftp | QFtp]] асинхронны. Вы можете отправить ряд команд (&quot;requests&quot; для HTTP). Команды выполнятся позже, когда управление вернется к циклу событий Qt. 
*''ID команд.'' Каждая команда имеет свой уникальный номер ID, который используется для слежения за выполнением команд. Например, [[Qt:Документация 4.3.2/qftp | QFtp]] передает [[Qt:Документация 4.3.2/qftp#commandStarted | commandStarted()]] и [[Qt:Документация 4.3.2/qftp#commandFinished | commandFinished()]] сигналы с ID для каждой команды, которая выполняется или выполнена. У [[Qt:Документация 4.3.2/qhttp | QHttp]] тоже имеются подобные сигнылы [[Qt:Документация 4.3.2/qhttp#requestStarted | requestStarted()]] и [[Qt:Документация 4.3.2/qhttp#requestFinished | requestFinished()]].
*''Индикаторы процесса передачи данных.'' [[Qt:Документация 4.3.2/qhttp | QHttp]] и [[Qt:Документация 4.3.2/qftp | QFtp]] используют сигналы при передаче данных ([[Qt:Документация 4.3.2/qftp#dataTransferProgress | QFtp::dataTransferProgress]](), [[Qt:Документация 4.3.2/qhttp#dataReadProgress | QHttp::dataReadProgress]](), и [[Qt:Документация 4.3.2/qhttp#dataSendProgress | QHttp::dataSendProgress]]()). Вы можете соединить данные сигналы например с QProgressBar::setProgress() или QProgressDialog::setProgress().
*''[[Qt:Документация 4.3.2/qiodevice | QIODevice]] поддержка.'' Оба класса поддерживают загрузку  из и в [[Qt:Документация 4.3.2/qiodevice | QIODevice]]s, дополнительно к API [[Qt:Документация 4.3.2/qbytearray | QByteArray]].

Есть два основных способа использования [[Qt:Документация 4.3.2/qhttp | QHttp]] и [[Qt:Документация 4.3.2/qftp | QFtp]]. Самый обычный способ состоит в том, чтобы отслеживать ID команд и следить за выполнением каждой команды соединившись с соответствующим сигналом.  Другой способ состоит в том, чтобы запланировать все команды сразу и соединиться только с сигналом done(), который посылается когда все команды были выполнены. Первый способ требует большего количества работы, но дает больший контроль над выполнением конкретных задач и позволяет вводить дополнительные команды основанные на результате предыдущих.  Что позволяет обеспечить пользователю детализированную обратную связь.

В примерах [[Qt:Документация 4.3.2/network-http | HTTP]] и [[Qt:Документация 4.3.2/network-ftp | FTP]]  показано, как можно написать свой HTTP или FTP клиент.

Для написания собственного HTTP или FTP сервера понадобиться использование классов низкого уровня [[Qt:Документация 4.3.2/qtcpsocket | QTcpSocket]] и [[Qt:Документация 4.3.2/qtcpserver | QTcpServer]].

===Использование TCP с помощью классов QTcpSocket и QTcpServer===
TCP (Transmission Control Protocol) является сетевым протоколом низкого уровня, используемым в соответствии с большинством интернет-протоколов, включая  HTTP и FTP, для передачи данных. Это - надежный, stream-oriented или connection-oriented транспортный протокол. Он особенно хорошо подходит для непрерывной передачи данных.

[[Image:tcpstream.png|center]]

Класс [[Qt:Документация 4.3.2/qtcpsocket | QTcpSocket]] предоставляет интерфейс для  TCP. Вы можете использовать [[Qt:Документация 4.3.2/qtcpsocket | QTcpSocket]] для создания стандартных сетевых протоколов таких как POP3, SMTP и NNTP, и для других.	

Перед передачей данных должно быть установлено TCP соединение. Как только связь была установлена, IP адресс и порт соединения доступны через [[Qt:Документация 4.3.2/qabstractsocket#peerAddress | QTcpSocket::peerAddress]]() и [[Qt:Документация 4.3.2/qabstractsocket#peerPort | QTcpSocket::peerPort]](). В любое время, соединение может быть закрыто, и тогда передача данных будет немедленно остановлена. 

[[Qt:Документация 4.3.2/qtcpsocket | QTcpSocket]] работает асинхронно и посылает сигналы сообщающие о статусе изменений и ошибок, точно так же как в [[Qt:Документация 4.3.2/qhttp | QHttp]] и [[Qt:Документация 4.3.2/qftp | QFtp]]. Что зависит от  цикла событий для обнаружения поступающих данных и автоматического сброса отправляемых. Записывать данные в сокет можно используя [[Qt:Документация 4.3.2/qiodevice#write | QTcpSocket::write]](), а читать данные используя [[Qt:Документация 4.3.2/qiodevice#read | QTcpSocket::read]](). [[Qt:Документация 4.3.2/qtcpsocket | QTcpSocket]] предоставляет два независимых потока данных: один для чтения, другой для записи.

Так как [[Qt:Документация 4.3.2/qtcpsocket | QTcpSocket]] унаследован от [[Qt:Документация 4.3.2/qiodevice | QIODevice]], можно использовать его и с [[Qt:Документация 4.3.2/qtextstream | QTextStream]] и [[Qt:Документация 4.3.2/qdatastream | QDataStream]]. При чтении из [[Qt:Документация 4.3.2/qtcpsocket | QTcpSocket]], нужно удостовериться, что доступно достаточно данных, это можно сделать вызова [[Qt:Документация 4.3.2/qabstractsocket#bytesAvailable | QTcpSocket::bytesAvailable]]().

Если нужно получить указатель на входящее TCP соединение (в серверном приложении), используйте класс [[Qt:Документация 4.3.2/qtcpserver | QTcpServer]]. Вызвав [[Qt:Документация 4.3.2/qtcpserver#listen | QTcpServer::listen]]() установите сервер, и соединитесь с сигналом [[Qt:Документация 4.3.2/qtcpserver#newConnection | QTcpServer::newConnection]](), который посылается для каждого клиента при соединении. В слоте, вызовите [[Qt:Документация 4.3.2/qtcpserver#nextPendingConnection | QTcpServer::nextPendingConnection]]() для того, чтобы принять соединение и использовать возвращаемый [[Qt:Документация 4.3.2/qtcpsocket | QTcpSocket]] для общения с клиентом. 

Хотя большинство его функций работает асинхронно, возможно синхронное использование [[Qt:Документация 4.3.2/qtcpsocket | QTcpSocket]]  (в блокирующем режиме). Чтобы установить блокирующий режим вызовите функции [[Qt:Документация 4.3.2/qtcpsocket | QTcpSocket]] waitFor...(); они приостанавливают выполнение потока до тех пор, пока не будет получен сигнал. Например, после вызова не блокирующей функции [[Qt:Документация 4.3.2/qabstractsocket#connectToHost | QTcpSocket::connectToHost]](), вызовите [[Qt:Документация 4.3.2/qabstractsocket#waitForConnected | QTcpSocket::waitForConnected]](), чтобы блокировать поток до получения сигнала [[Qt:Документация 4.3.2/qabstractsocket#connected | connected()]].

Использование синхронных сокетов часто приводит к более простому коду. Главное неудобство waitFor ... () подхода состоит в том, что события не будут обрабатываться, пока поток блокируется функцией waitFor ... (). Если использовать в  GUI потоке, то это может &quot;заморозить&quot; пользовательский интерфейс приложения. Поэтому мы рекомендуем использовать синхронные сокеты только в не GUI потоках. [[Qt:Документация 4.3.2/qtcpsocket | QTcpSocket]] при синхронном использовании не требует цикла событий. 

В примерах [[Qt:Документация 4.3.2/network-fortuneclient | Fortune Client]] и [[Qt:Документация 4.3.2/network-fortuneserver | Fortune Server]]  показано как использовать [[Qt:Документация 4.3.2/qtcpsocket | QTcpSocket]] и [[Qt:Документация 4.3.2/qtcpserver | QTcpServer]] для написания TCP client-server приложений. Также смотрите [[Qt:Документация 4.3.2/network-blockingfortuneclient | Blocking Fortune Client]] в качестве примера использования синхронного [[Qt:Документация 4.3.2/qtcpsocket | QTcpSocket]] в отдельном потоке (не используя цикл событий)  и [[Qt:Документация 4.3.2/network-threadedfortuneserver | Threaded Fortune Server]] в качестве примера мульти поточного TCP сервера, с одним потоком на каждого клиента.

===Использование  UDP с помощью класса QUdpSocket===
UDP (User Datagram Protocol) легкий, ненадежный, датаграмм ориентированный протокол, не требующий установки соединения. Он может быть использован, когда не важна надежность. Например, сервер сообщающий время может использовать UDP. Если датаграма с временем потеряна, клиент просто может сделать новый запрос.

[[Image:udppackets.png|center]]

Класс [[Qt:Документация 4.3.2/qudpsocket | QUdpSocket]] позволяет отправлять и принимать UDP датаграммы. Он унаследован от [[Qt:Документация 4.3.2/qabstractsocket | QAbstractSocket]], и поэтому похож на интерфейс [[Qt:Документация 4.3.2/qtcpsocket | QTcpSocket]]. Основное различие состоит в том, что [[Qt:Документация 4.3.2/qudpsocket | QUdpSocket]] передает данные как датаграммы, а не непрерывным потоком. Вкратце, датаграмма это пакет данных ограниченного размера (обычно менее 512 байтов), дополнительно к передаваемым данным, содержащий IP адрес и порт отправителя  и приемника датаграммы.

[[Qt:Документация 4.3.2/qudpsocket | QUdpSocket]] поддерживает IPv4 broadcasting. Broadcasting часто используется для реализации сетевых протоколов обнаружения, например, такой как поиск хоста в сети, на котором больше всего свободного места на диске. Один хост передает датаграмму по сети, которую получают все хосты. Каждый хост, который получил запрос, посылает ответ отправителю с его текущим количеством свободного дискового пространства. Создатель запроса ждет, пока не получит  ответы от всех хостов, после чего выбирает сервер с большим свободным местом, чтобы хранить данные. Чтобы передать датаграмму, просто пошлите ее специальному адресу [[Qt:Документация 4.3.2/qhostaddress#SpecialAddress-enum | QHostAddress::Broadcast]] (255.255.255.255), или широковещательному адресу вашей местной сети.

[[Qt:Документация 4.3.2/qudpsocket#bind | QUdpSocket::bind]]() подготавливает сокет для получения входящих датаграм, вызов [[Qt:Документация 4.3.2/qtcpserver#listen | QTcpServer::listen]]() для TCP серверов. Всякий раз, когда прибывает одна или более датаграмм, [[Qt:Документация 4.3.2/qudpsocket | QUdpSocket]] отправляет сигнал [[Qt:Документация 4.3.2/qiodevice#readyRead | readyRead()]]. Для чтения датаграмм используется [[Qt:Документация 4.3.2/qudpsocket#readDatagram | QUdpSocket::readDatagram]]().

[[Qt:Документация 4.3.2/network-broadcastsender | Broadcast Sender]] и [[Qt:Документация 4.3.2/network-broadcastreceiver | Broadcast Receiver]] примеры показывающие как написать UDP отправитель и UDP получатель используя Qt.

===Получение имен компьютеров используя класс QHostInfo===
Перед установкой сетевого соединения, [[Qt:Документация 4.3.2/qtcpsocket | QTcpSocket]] и [[Qt:Документация 4.3.2/qudpsocket | QUdpSocket]] выполняет поиск имени, переводя имя компьютера, с которым соединяется в IP адрес. Эта операция обычно выполняется с помощью DNS протокола (Domain Name Service).

[[Qt:Документация 4.3.2/qhostinfo | QHostInfo]] предоставляет статическую функцию, с помощью которой можно выполнить такой поиск самостоятельно. При вызове [[Qt:Документация 4.3.2/qhostinfo#lookupHost | QHostInfo::lookupHost]]() с именем компьютера, указателем на [[Qt:Документация 4.3.2/qobject | QObject]], и сигнатурой слота, [[Qt:Документация 4.3.2/qhostinfo | QHostInfo]] выполнит поиск имени и когда результаты будут готовы, вызовет заданный слот. Поиск происходит в отдельном потоке, используя собственные методы операционной системы.

[[Qt:Документация 4.3.2/qhostinfo | QHostInfo]] также предоставляет статическую функцию [[Qt:Документация 4.3.2/qhostinfo#fromName | QHostInfo::fromName]](), которая в качестве аргумента получает имя компьютера и возвращает результат. В этом случае, поиск имени происходит в том же потоке, где была вызвана данная функция. Эта перегрузка полезна в не-GUI приложениях или  для поиска имени отдельно от не-GUI потока. (При вызове данной функции в GUI потоке, пользовательский интерфейс не будет отвечать пока функция выполняет поиск.)

[Назад: [[Qt:Документация 4.3.2/qtgui | QtGui Module]]] [ [[Qt:Документация 4.3.2/modules | Qt's Modules]] ][Далее: [[Qt:Документация 4.3.2/qtopengl | QtOpenGL Module]]]

{{Qt4.3.2_footer}}