IPConnection.HTTPDecompress

From SunFlurry wiki
Revision as of 11:58, 20 March 2021 by 1>Admin
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
  HTTPDecompress (Работа со сжатыми HTTP-пакетами)
Объект:Объект IP
Статус разработки: Реализована
Тип:Функция
Обращение к БД:Нет
Исключения:Невозможно превратить в строку, число, неверный аргумент, системная ошибка.
Визуальность:Нет

Функция выполняет декомпрессию информации, обычно полученной из тела HTTP-пакета. При обмене сжатыми пакетами, обычно используется алгоритм gzip. Для иницииации компрессии в заголовке исходящего пакета необходимо указать Accept-Encoding: gzip (для алгоритма сжатия gzip). Функция может использоваться не только для информации, полученной по HTTP, но и для произвольной информации, единственным ограничением может служить факт, что функция не отдает имени файла, которое иногда записывается в архив (при передаче по http такое имя отсутствует). Функция может быть вызвана непосредственно из интерфейса.

Синтаксис

IPConnection.HTTPDecompress(<Строка или буфер для декомпрессии (STRING,BUFFER)>,<Алгоритм компрессии (INT)>=0):<Результат декомпрессии (STRING,BUFFER)>

Аргументы

  • <Строка или буфер для декомпрессии (STRING,BUFFER)> - ANSI-строка или буфер для декомпрессии. Если аргументом является строка, результат будет возвращен, как строка, если аргументом является буфер, результат будет возвращен как буфер.
  • <Алгоритм компрессии (INT)> - (необязательный аргумент) Аргумент задает алгоритм компрессии. На данный момент возможно только значение 0, которое отвечает за алгоритм gzip (являющийся оберткой алгоритма deflate)

Возвращаемое значение

Возвращается строку или буфер в зависимости от типа первого аргумента.

Примеры

aTCP:=IPConnection.Connect("www.google.com:80");
aTCP.HTTPSetOperation("GET / HTTP/1.0");
aTCP.HTTPSetHeaderField("Host","www.google.com");
aTCP.HTTPSetHeaderField("User-Agent","Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0)");
aTCP.HTTPSetHeaderField("Accept","text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8");
aTCP.HTTPSetHeaderField("Accept-Language","en");
aTCP.HTTPSetHeaderField("Accept-Encoding","gzip");
aTCP.HTTPSetHeaderField("Connection","Close");
If aTCP.HTTPSendAndReceive Then
  Стр:=aTCP.HTTPBodyAsString;
  If aTCP.HTTPGetHeaderField("Content-Encoding")="gzip" Then
    Стр:=IPConnection.HTTPDecompress(Стр);
  EndIf;
  Message("Полученная строка: "+Стр);
EndIf;