Функция netHead позволяет загружать данные. Функция запрашивает только заголовки и не получает никакого содержимого.
Краткий обзор
int netHead(строковый URL, сопоставление ирезультат [, параметры сопоставления]);,,
Параметр
| Параметр | Значение |
| url | Поскольку URL-адрес должен соответствовать определенным правилам синтаксиса, QT-реализация анализатора URL-адресов пытается исправить ошибки в синтаксисе. Смотрите раздел “QUrl::TolerantMode” в описании http://qt-project.org/doc/qt-5/qurl.php#ParsingMode-enum и http://tools.ietf.org/html/rfc3986.Функция завершается в случае недопустимого URL и возвращает значение -1. |
| Результат | По умолчанию переменная “result” содержит данные заголовка. ”headers” (всегда) … Содержит сопоставление с парами ключ (имя заголовка) и значение (заголовок) (ключ=имя_заголовка, значение=значение заголовка). Он также может быть пустым. |
| Опции | Вы можете использовать следующие ключи для отображающей переменной “options”: ”target» (строка) … абсолютный путь к каталогу или файлу, в котором сохраняется содержимое ответа. Если вы указываете путь к каталогу, имя файла из URL добавляется к пути к каталогу, чтобы создать окончательное имя файла. Это имя файла также сохраняется в переменной “результат” под ключевым словом “target”. Файл должен быть открыт для чтения, иначе функция возвращает значение -1 и завершается. Файл создается, если он не существует. ВНИМАНИЕ: вы можете использовать целевой ключ, но поскольку возвращаются только данные заголовка, файл пуст. ”заголовки» (сопоставление) … Дополнительный заголовок, который передается на сервер во время обмена данными. ключ=имя_заголовка, значение= значение заголовка, например makeMapping (“Агент пользователя”, “мой специальный агент пользователя”); Если вы укажете заголовок, который уже существует, существующий заголовок будет перезаписан.”ignoreSslErrors“ … Если вы передаете значение, неравное dyn_string, или пустое dyn_string, все ошибки SSL игнорируются. Однако возвращаются все возникшие ошибки SSL, и вы можете найти их в результате сопоставления [“sslErrors”]. Если вы указываете dyn_string, вы указываете, какие ошибки SSL могут игнорироваться. При наличии других ошибок SSL функция возвращает значение -1 и завершается. Возможные ключевые слова для ошибок SSL приведены в разделе “sslErrors” в главе netGet(). например опции[“ignoreSslErrors”] = “”; //Все ошибки SSL игнорируются опции[“ignoreSslErrors”] = makeDynString(“CertificateUntrusted”);//Игнорировать ошибки CertificateUntrustedfollowRedirection” …Если вы укажете false для параметра bool, автоматическая «Обработка перенаправления” будет деактивирована. При обработке перенаправления протокол HTTP позволяет серверу отправлять ответ “перенаправление”. Таким образом, клиент знает, что требуемый ресурс доступен по другому URL. Функция netGet по умолчанию следует этим инструкциям. Чтобы избежать цикла перенаправления (например, A -> A, A -> B -> C -> A и т.д.), количество ответов ограничено. Если это число превышено, функция возвращает значение -1 (ошибка “RedirectionLoop”) и завершается. Вы можете активировать или деактивировать обработку перенаправления, используя клавишу “followRedirection» для сопоставления параметров. например: параметры [“followRedirection”] = false; // автоматическое перенаправление деактивировано параметры [“followRedirection”] = true; // автоматическое перенаправление активировано (по умолчанию) ”sslConfig” … sslConfig – это сопоставление, которое содержит информацию о сертификате, необходимую для безопасного обмена, и содержит следующие ключи: “localCertificate” (строка) – сертификат в PEM–кодировке “PrivateKey” (сопоставление) — ключ и информацию об алгоритме “ключ” (строка) — закрытый ключ в кодировке PEM. “алогоритм” (строка) – Используемый алгоритм, возможные значения: “RSA“, ”DSA“, «EC” (эллиптическая кривая) Пример Файл сертификата в кодировке PEM может быть загружен с локального диска следующим образом: fileToString(getPath(CONFIG_REL_PATH, “certificate.pem”), cert); и затем возвращаемая строка может быть передана как значение для ключа “localCertificate”.“timeout” … определяет время ожидания, по истечении которого вызов вернется с кодом ошибки -2 (время ожидания истекло). Выполняемая операция будет прервана. |
Возвращаемое значение
Функция возвращает 0, если она была успешно выполнена, а в случае ошибок -1.
Описание
Функция netHead позволяет загружать данные. Функция запрашивает только заголовки и не получает никакого содержимого.
ПРИМЕР
В примере проверяется заголовок:
| main(){отображение m;netHead(“http://www.sdigital.ru“, m);if ( m[“HttpStatusCode”] == 200 ) DebugN(“Все в порядке”); else DebugN(m[“httpStatusText”]);} |
Назначение
HTTP-функции
Доступность
Пользовательский интерфейс, CTRL