Admin: 1 revision imported

2021-02-07T06:51:24Z

1 revision imported

Admin at 07:26, 24 April 2020

2020-04-24T07:26:59Z

New page

{{infobox function
|name=HTTPTranslateCookieRequest
|object=[[Объект IP]]
|caption=Работа с HTTP
|type=1
|status=2
|db=0
|exception=Невозможно превратить в строку
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Объект IP]]}}
Функция превращает запрос из поля <code>Set-Cookie</code> (к примеру, полученный функцией [[IPConnection.HTTPGetCookieRequest|HTTPGetCookieRequest]]) в список, разделяя его на директивы, если запрос будет пустой строкой, функция возвращает пустое значение. Первым элементом списка всегда будет следовать значение cookie, наименования первого элемента будет совпадать с наименованием cookie. Последующие элементы будут содержать директивы запроса. Некоторые директивы могут не содержать текстового значения (к примеру, <code>Secure, HttpOnly</code>), для них значение элемента будет пустой строкой, для остальных значение будет заполнено значением директивы. Для директивы <code>Expires</code> значение будет автоматически переведено в тип данных дата и время, а для директивы <code>Max-Age</code> в число. Обычно функции, связанные с полями запроса cookie, применяются после получения ответа сервера, чтобы получить информацию о cookie, которые просит сохранить сервер. Вместо получения и обработки cookie с помощью функций HTTP, можно использовать объект cookie, информацию в который можно загрузить с помощью функции [[IPConnection.Cookie.UpdateFromHeader|UpdateFromHeader]]. Важно: наименования cookie должны обрабатываться с учетом регистра.

== Синтаксис ==
<code>
{{Grey|IPConnection.}}'''HTTPTranslateCookieRequest'''(''<Строка запроса cookie (STRING)>''):''<Список директив запроса cookie (LIST)>''
</code>

==== Аргументы ====
* <code>''<Строка запроса cookie (STRING)>''</code> - ANSI строка в виде <code><CookieName>=<value>[; <opt1>; <opt2>...]</code>, которую, к примеру, можно получить с помощью функции [[IPConnection.HTTPGetCookieRequest|HTTPGetCookieRequest]] или разобрав заголовок построчно.

==== Возвращаемое значение ====
Возвращает список с директивами и значением запроса cookie, либо пустое значение.

== Примеры ==
<pre>
Try
If not TCP.HTTPReceive Then
Exit;
EndIf;
aList:=TCP.HTTPTranslateCookieRequest(TCP.HTTPGetCookieRequest("session"));
If _And(not isEmpty(aList),aList.Size()>0) Then
Message("Значение запроса cookie ""session"": "+aList.Get(1));
Message("Запрос cookie ""session"" имеет следующие директивы:");
For i:=2 to aList.Size() Do
Message(" "+aList.GetName(i)+": "+aList.Get(i));
EndDo;
EndIf;
...
Finally
TCP.Disconnect();
EndTry;
</pre>

← Older revision	Revision as of 06:51, 7 February 2021
(No difference)

IPConnection.HTTPTranslateCookieRequest - Revision history

Admin: 1 revision imported

Admin at 07:26, 24 April 2020