Фильтр Array

Фильтр Array указывает на массив значений в любом из элементов базового запроса, которые могут содержать массивы.

Фильтр Array может использоваться в point'е совместно со следующими фильтрами:

• Get;
• Header;
• Form_urlencoded;
• Multipart;
• Xml_tag;
• Json_obj.

К элементам массива, на который указывает фильтр Array, необходимо обращаться по индексу. Индексация этого массива начинается с нуля.

Пример совместного применения фильтров Get и Array

Для запроса

GET http://example.com/login?id[]="01234"&id[]="56789" HTTP/1.1

при применении к значению строкового параметра id фильтр Array будет указывать на следующий массив:

• Point GET_id_ARRAY_0_value будет ссылаться на значение 01234, которое находится в массиве значений строкового параметра id, на который указывает фильтр Array, с индексом 0;
• Point GET_id_ARRAY_1_value будет ссылаться на значение 56789, которое находится в массиве значений строкового параметра id, на который указывает фильтр Array, с индексом 1.

Пример совместного применения фильтров Header и Array

Для запроса

GET http://example.com/login/index.php HTTP/1.1
X-Identifier: 01234
X-Identifier: 56789

при применении к заголовку X-Identifier фильтр Array будет указывать на следующий массив:

• Point HEADER_X-Identifier_ARRAY_0_value будет ссылаться на значение 01234, которое хранится в массиве значений заголовка X-Identifier, на который указывает фильтр Array, с индексом 0;
• Point HEADER_X-Identifier_ARRAY_1_value будет ссылаться на значение 56789, которое хранится в массиве значений заголовка X-Identifier, на который указывает фильтр Array, с индексом 1.

Пример совместного применения парсера Form_urlencoded и фильтра Array

Для запроса

POST http://example.com/login/index.php HTTP/1.1
Content-Type: application/x-www-form-urlencoded

с телом

id[]=01234&id[]=56789

при применении к параметру id в теле запроса в формате form-urlencoded фильтр Array будет указывать на следующий массив:

• Point POST_FORM_URLENCODED_id_ARRAY_0_value будет ссылаться на значение 01234, которое находится в массиве значений параметра id в теле запроса, на который указывает фильтр Array, с индексом 0;
• Point POST_FORM_URLENCODED_id_ARRAY_1_value будет ссылаться на значение 56789, которое находится в массиве значений параметра id в теле запроса, на который указывает фильтр Array, с индексом 1.

Пример совместного применения парсера Multipart и фильтра Array

Для запроса

POST http://example.com/login/index.php HTTP/1.1
Content-Type: multipart/form-data;boundary="boundary" 

--boundary 
Content-Disposition: form-data; name="id[]" 

01234 
--boundary 
Content-Disposition: form-data; name="id[]"

56789

при применении к параметру id в теле запроса в формате multipart фильтр Array будет указывать на следующий массив:

• Point POST_MULTIPART_id_ARRAY_0_value будет ссылаться на значение 01234, которое находится в массиве значений параметра id в теле запроса, на который указывает фильтр Array, с индексом 0;
• Point POST_MULTIPART_id_ARRAY_1_value будет ссылаться на значение 56789, которое находится в массиве значений параметра id в теле запроса, на который указывает фильтр Array, с индексом 1.

Пример совместного применения фильтров Xml_tag и Array

Для запроса

POST http://example.com/main/login HTTP/1.1
Content-type: application/xml

с телом

<?xml version="1.0"?>
<!DOCTYPE foo [<!ENTITY eee SYSTEM "aaaa">]>
<?xml-stylesheet type="text/xsl" href="style.xsl"?>
<!-- first -->
<text>
Sample text.
</text>
<text>
    &eee;
</text>

при применении к тегу text в теле запроса в формате XML фильтр Array будет указывать на следующий массив:

• Point POST_XML_XML_TAG_text_ARRAY_0_value будет ссылаться на значение Sample text., которое находится в массиве значений тега text, на который указывает фильтр Array, с индексом 0;
• Point POST_XML_XML_TAG_text_ARRAY_1_value будет ссылаться на значение aaaa, которое находится в массиве значений тега text, на который указывает фильтр Array, с индексом 1.

Пример совместного применения фильтров Json_obj и Array

Для запроса

POST http://example.com/main/login HTTP/1.1
Content-type: application/json

с телом

{
    "username": "user",
    "rights":["read","write"]
}

при применении к JSON-объекту rights в теле запроса совместно с парсером Json_doc и фильтром Json_obj фильтр Array будет указывать на следующий массив значений:

• Point POST_JSON_DOC_JSON_OBJ_rights_ARRAY_0_value будет ссылаться на значение read, которое находится в массиве значений JSON-объекта rights, на который указывает фильтр Array, с индексом 0;
• Point POST_JSON_DOC_JSON_OBJ_rights_ARRAY_1_value будет ссылаться на значение write, которое находится в массиве значений JSON-объекта rights, на который указывает фильтр Array, с индексом 1.