21. Создание простого HTTP-клиента
В этой главе будет написана программа, которая может считывать файлы из Internet
по HTTP протоколу и записывать их на диск.
Для связи с Internet в Visual C++ существует так называемый WinInet Class.
В него входят несколько подклассов.
Далее представлены ксассы WinInet:
Классы |
Описание |
CInternetSession |
Создаёт Internet сессию. Все MFC WinInet приложения
должны создавать CInternetSession объект
перед использрванием других WinInet классов. |
CInternetConnection |
Создаёт коннект с Internet. Это базовый класс для классов
CFtpConnection, CGopherConnection, и
CHttpConnection. |
CFtpConnection |
Устанавливает соединение по FTP протоколу. |
CGopherConnection |
Создаёт Gopher коннект. |
CHttpConnection |
Устанавливает соединение по HTTP протоколу. |
CInternetFile |
Разрешает удалённый доступ к файлам на Internet серверах.
Это базовый класс для классов
CGopherFile and
CHttpFile. |
CGopherFile |
Разрешает удалённый доступ к файлам на Gopher серверах. |
CHttpFile |
Разрешает удалённый доступ к файлам на HTTP серверах. |
CFileFind |
Разрешает поиск файлов в Internet.
Это базовый класс для классов
CFtpFileFind and
CGopherFileFind. |
CFtpFileFind |
Разрешает поиск файлов на FTP серверах. |
CGopherFileFind |
Разрешает поиск файлов на Gopher серверах. |
CGopherLocator |
Отыскивает Gopher устройство ввода позиций от gopher сервера.
|
CInternetException |
Управляет исключениями, сгенерированными WinInet классом.
|
Наша программа будет использовать четыре класса WinInet: CInternetSession, CInternetFile,
CHttpFile и CHttpConnection
Далее будут описаны методы( функции ) этих классов:
Методы ( функции ) класса CInternetSession
Функции |
Описание |
Close() |
Закрывает Internet сессию. |
EnableStatusCallback() |
Разрешает использование функции повторного вызова,
которая используется для асинхронных действий.
|
GetContext() |
Получает значение контекста Internet сессии. |
GetFtpConnection() |
Устанавливает подключение по FTP протоколу. |
GetGopherConnection() |
Устанавливает подключение с Gopher серверами. |
GetHttpConnection() |
Устанавливает подключение по HTTP протоклолу. |
OnStatusCallback() |
Модифицирует состояние операции. |
OpenURL() |
Соединяется с данным URL. |
QueryOption() |
Сервис проверки ошибки провайдера. |
ServiceTypeFromHandle() |
Получает тип сервиса от Internet дескриптора. |
SetOption() |
Устанавливает опции Internet сессии. |
Методы ( функции ) класса CInternetFile
Функции |
Описание |
Abort() |
Закрывает файл и игнорирует все ошибки. |
Close() |
Закрывает файл. |
Flush() |
Сбрасывает файл на диск. |
Read() |
Счатывает байт из файла. |
ReadString() |
Считывает строку символов из файла. |
Seek() |
Переустанавливает указатель внутри файла. |
SetReadBufferSize() |
Устанавливает размер буфера для чтения. |
SetWriteBufferSize() |
Устанавливает размер буфера для записи. |
Write() |
Записывает байт в файл. |
WriteString() |
Записывает строку с нулевым символом в конце в файл. |
Методы ( функции ) класса CHttpFile
Функции |
Описание |
AddRequestHeaders() |
Добавляет заголовок к HTTP запросу. |
Close() |
Закрывает CHttpFile объект. |
GetFileURL() |
Получает URL файла. |
GetObject() |
Получает объект по HTTP запросу. |
GetVerb() |
Получает заголовок запроса. |
QueryInfo() |
Получает ответ или заголовок запроса. |
QueryInfoStatusCode() |
Получает код состояния HTTP запроса. |
SendRequest() |
Посылает HTTP запрос. |
Далее напишем код программы и разберём каждую строчку:
...
CString m_url = "mark5.dhtp.kiae.ru"; // имя URL
CString m_mes; // переменная в которой будут хранится сообщения
char temp[100]; // промежуточная переменная для перевода
// данных из Int в char
CString m_path; // имя файла для записи
char strBody[1024]; // буфер из 1024 байт
...
int CHTTP_ClientDlg::OnButtonConnect()
{
// создаём переменную session и открываем сессию ANDY
CInternetSession session( _T( "ANDY" ), PRE_CONFIG_INTERNET_ACCESS );
// создаём переменную pServer класса CHttpConnection
CHttpConnection* pServer = NULL;
// создаём переменную pFile класса CHttpFile
CHttpFile* pFile = NULL;
/*
Обратите внимание, что все запросы к функциям членам WinInet классов включены в блок программы TRY.
Это сделано так, потому что при соединении с каким либо URL есть риск неправильной ссылки,
особенно, когда Вы полагаете, что пользователь сам печатает URL.
Другая проблема - времена ожидания, которые возникают, когда требуемый URL в настоящее время
неспособен обслужить подключение.
Так же обработка WinInet исключений, которые представлены в классе
CInternetException, является важной частью создания Internet приложения под MFC.
*/
try
{
CString strServerName; // имя сервера
CString strObject; // имя объекта
INTERNET_PORT nPort; // номер порта для связи
DWORD dwServiceType; // тип сервиса
// функция AfxParseURL получает данные с указанного URL ( у нас m_url ) об сервере,
// объекте, типе сервиса и порте
if ( AfxParseURL( m_url, dwServiceType, strServerName, strObject, nPort ) == 0 )
{
return 1; // выход из функции OnButtonConnect()
}
// вывод данных о сервере
m_mes = "";
m_mes += "Server Name = ";
m_mes += (CString)strServerName; m_mes += "\r\n";
m_mes += "Object Name = ";
m_mes += (CString)strObject; m_mes += "\r\n";
m_mes += "Port = ";
itoa( nPort, temp, 10 );
m_mes += (CString)&temp[0]; m_mes += "\r\n";
UpdateData( FALSE );
// Устанавливаем подключение по HTTP протоклолу.
pServer = session.GetHttpConnection( strServerName, nPort );
// посылаем запрос об объекте ( strObject )
pFile = pServer->OpenRequest(
CHttpConnection::HTTP_VERB_GET, strObject, NULL, 1, NULL, NULL,
INTERNET_FLAG_EXISTING_CONNECT | INTERNET_FLAG_NO_AUTO_REDIRECT
);
// Добавляем заголовок к HTTP запросу
pFile->AddRequestHeaders( _T( "Accept: */*\r\nUser-Agent: ANDY\r\n" ) );
// посылаем запрос
pFile->SendRequest( );
DWORD dwRet; // переменная для хранения кода состояния
pFile->QueryInfoStatusCode( dwRet ); // записываем код состояния в dwRet
// вывод данных
m_mes += "The HTTP GET returned a status code of ";
itoa( dwRet, temp, 10 );
m_mes += (CString)&temp[0]; m_mes += "\r\n";
CString strHeader; // переменная для хранения полученного заголовока запроса
pFile->QueryInfo(HTTP_QUERY_RAW_HEADERS_CRLF, strHeader); // записываем заголовок в strHeader
// вывод данных
m_mes += "Header = ";
m_mes += strHeader;
UpdateData( FALSE );
// если код состояния не равен 200, то выходим из функции
if( dwRet != 200 ) { m_mes += "Program terminate!"; UpdateData( FALSE ); return 1; }
// ----------------------------------------------------------
// проверка выбора файла для записи
m_mes += "Starting download the file."; m_mes += "\r\n";
if( m_path == "" )
{
m_mes += "Error! No file to save. Choese the file.";
m_mes += "\r\n"; UpdateData( FALSE ); return 1; }
else
{
m_mes += "File name to save : ";
m_mes += m_path; m_mes += "\r\n"; UpdateData( FALSE );
}
CFile file2; // объявляем переменную file2 класса CFile
// открываем файл для записи в двоичном формате ( CFile::typeBinary ) !!!
file2.Open((LPCTSTR)m_path,
CFile::modeCreate|CFile::modeWrite|CFile::typeBinary);
int allRead = 0; // переменная для хранения общего числи считанных байт
int nRead = pFile->Read( strBody, 1024 ); // считываем первые 1024 байта в буфер.
// переменная nRead хранит количество
// считанных байт
allRead += nRead; // обновляем общее число считанных байт
// вывод данных
m_mes += "Loading ";
itoa( nRead, temp, 10 );
m_mes += (CString)&temp[0]; m_mes += " bytes"; m_mes += "\r\n";
UpdateData( FALSE );
// записываем буфер из nRead байт в файл
file2.Write( strBody, nRead );
// цикл считывания, пока nRead не будет равняться нулю
while ( nRead > 0 )
{
nRead = pFile->Read( strBody, 1024 );
if( nRead != 0 )
{
m_mes += "Loading ";
itoa( nRead, temp, 10 );
m_mes += (CString)&temp[0]; m_mes += " bytes"; m_mes += "\r\n";
file2.Write( strBody, nRead );
allRead += nRead;
UpdateData( FALSE );
}
}
// вывод данных
m_mes += "\r\n";
m_mes += "Total bytes = ";
itoa( allRead, temp, 10 );
m_mes += &temp[0]; m_mes += "\r\n"; UpdateData( FALSE );
file2.Close(); // закрываем файл
pFile->Close(); // закрываем Internet файл
pServer->Close(); // закрываем сервер
m_mes += "Download is complete !!!"; m_mes += "\r\n";UpdateData( FALSE );
}
catch ( CInternetException* pEx )
{
// Если произошла ошибка в WinInet
// вывод ошибки
char szErr[1024];
pEx->GetErrorMessage( szErr, 1024 );
m_mes += "Error: ( ";
itoa( int(pEx->m_dwError), temp ,10 );
m_mes += (CString)&temp[0];
m_mes += " ) ";
m_mes += (CString)&szErr[0]; m_mes += "\r\n";
UpdateData( FALSE );
pEx->Delete( ); // удаление переменной класса CInternetException
if ( pFile != NULL )
delete pFile; // закрываем Internet файл
if ( pServer != NULL )
delete pServer; // закрываем сервер
session.Close( ); // закрываем сессию
return 1;
}
if ( pFile != NULL )
delete pFile; // закрываем Internet файл
if ( pServer != NULL )
delete pServer; // закрываем сервер
session.Close( ); // закрываем сессию
return 0;
}
Ну вот и всё, приложение готово.
Отсюда можно взять рабочую
программу HTTP Client под MFC, с использованием WinInet.