Back to Adaptive Vision Studio website

You are here: Start » Filter Reference » System » HTTP » Http_SendRequest_POST_ByteBuffer

Http_SendRequest_POST_ByteBuffer


Module: FoundationBasic

Sends a POST request to the server and receives a text answer.

Name Type Description
inUrl String URL of request.
inFields StringArray Request data to send. It will be automatically encoded.
inFieldsData StringArray Request data to send. It will be automatically encoded.
outAnswer ByteBuffer? Answer as a binary byte buffer.
outResponseCode Integer Answer code. Typically 200 for OK.

Description

Filter sends a POST request to the server using application/x-www-form-urlencoded format. Filter waits for the sever binary answer. Filter can be used to download files from the remote server.

Examples

Filter executed with parameters:

  • inUrl = http://localhost/test
  • inFields = ["param1", "param2"]
  • inFieldsData = ["1", "2"]

Request sent to the server:

POST /test HTTP/1.1
Host: localhost
User-Agent: Adaptive Vision/1.0
Accept: */*
Content-Length: 17
Content-Type: application/x-www-form-urlencoded

param1=1&param2=2

Remarks

Filter only accepts text answers encoded using UTF-8 or plain ASCII. To receive answer in arbitrary format please use Http_SendRequest_POST_ByteBuffer.

Errors

This filter can throw an exception to report error. Read how to deal with errors in Error Handling.

List of possible exceptions:

Error type Description
DomainError Different size of inFields and inFieldsData in Http_SendRequest_POST_ByteBuffer.
DomainError Empty inUrl in Http_SendRequest_POST_ByteBuffer.
DomainError Invalid inUrl in Http_SendRequest_POST_ByteBuffer.
DomainError Secured HTTPS connection is not supported in Http_SendRequest_POST_ByteBuffer.

Complexity Level

This filter is available on Basic Complexity Level.

Disabled in Lite Edition

This filter is disabled in Lite Edition. It is available only in full, Adaptive Vision Studio Professional version.

Filter Group

This filter is member of Http_SendRequest_POST filter group.

See Also