Фильтр Hash

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

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

• Get;
• Form_urlencoded;
• Multipart;
• Json_doc;
• Json_obj;
• Json_array.

К элементам хэш-таблицы, на которую указывает фильтр Hash, необходимо обращаться по ключу.

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

Для запроса

POST http://example.com/login?id[user]=01234&id[group]=56789

при применении к значению строкового параметра id фильтр Hash будет указывать на следующую хэш-таблицу:

• Point GET_id_HASH_user_value будет ссылаться на значение 01234, которое находится в хэш-таблице значений строкового параметра id, на которую указывает фильтр Hash, с ключом user;
• Point GET_id_HASH_group_value будет ссылаться на значение 56789, которое находится в хэш-таблице значений строкового параметра id, на которую указывает фильтр Hash, с ключом group.

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

Для запроса

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

с телом

id[user]=01234&id[group]=56789

при применении к параметру id в теле запроса в формате form-urlencoded фильтр Hash будет указывать на следующую хэш-таблицу:

• Point POST_FORM_URLENCODED_id_HASH_user_value будет ссылаться на значение 01234, которое находится в хэш-таблице параметров в теле запроса, на которую указывает фильтр Hash, с ключом user;
• Point POST_FORM_URLENCODED_id_HASH_group_value будет ссылаться на значение 56789, которое находится в хэш-таблице параметров в теле запроса, на которую указывает фильтр Hash, с ключом group.

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

Для запроса

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

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

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

56789

при применении к параметру id в теле запроса в формате multipart фильтр Hash будет указывать на следующую хэш-таблицу:

• Point POST_MULTIPART_id_HASH_user_value будет ссылаться на значение 01234, которое находится в хэш-таблице параметров тела запроса, на которую указывает фильтр Hash, с ключом user;
• Point POST_MULTIPART_id_HASH_group_value будет ссылаться на значение 56789, которое находится в хэш-таблице параметров тела запроса, на которую указывает фильтр Hash, с ключом group.

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

Для запроса

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

с телом

{
    "username": "user",
    "rights": "read"
}

при применении к телу запроса в формате JSON совместно с парсером Json_doc фильтр Hash будет указывать на следующую хэш-таблицу:

• Point POST_JSON_DOC_HASH_username_value будет ссылаться на значение user, которое находится в хэш-таблице параметров тела запроса, на которую указывает фильтр Hash, с ключом username;
• Point POST_JSON_DOC_HASH_rights_value будет ссылаться на значение read, которое находится в хэш-таблице параметров тела запроса, на которую указывает фильтр Hash, с ключом rights.

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

Для запроса

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

с телом

{
    "username": "user",
    "info": {
        "status": "active",
        "rights": "read"
    }
}

при применении к телу запроса в формате JSON совместно с парсером Json_doc и фильтром Json_obj фильтр Hash будет указывать на следующую хэш-таблицу:

• Point POST_JSON_DOC_JSON_OBJ_info_HASH_status_value будет ссылаться на значение active, которое находится в хэш-таблице JSON-объектов, дочерних для объекта info, на которую указывает фильтр Hash, с ключом status;
• Point POST_JSON_DOC_JSON_OBJ_info_HASH_rights_value будет ссылаться на значение read, которое находится в хэш-таблице JSON-объектов, дочерних для объекта info, на которую указывает фильтр Hash, с ключом rights.

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

Для запроса

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

с телом

{
    "username": "user",
    "posts": [{
            "title": "Greeting",
            "length": "256"
        },
        {
            "title": "Hello World!",
            "length": "32"
        }
    ]
}

при применении к первому элементу массива JSON-объектов posts в теле запроса совместно с парсером Json_doc и фильтрами Json_obj и Json_array фильтр Hash будет указывать на следующую хэш-таблицу:

• Point POST_JSON_DOC_JSON_OBJ_posts_JSON_ARRAY_0_HASH_title_value будет ссылаться на значение Greeting, которое находится в хэш-таблице JSON-объектов, на которую указывает фильтр Hash, с ключом title;
• Point POST_JSON_DOC_JSON_OBJ_posts_JSON_ARRAY_1_HASH_length_value будет ссылаться на значение 256, которое находится в хэш-таблице JSON-объектов, на которую указывает фильтр Hash, с ключом length.