NAME

WebService::Hexonet::Connector::ResponseTemplate - Library that provides basic functionality to access API response data.

SYNOPSIS

This module is internally used by the WebService::Hexonet::Connector::Response module as described below. To be used in the way:

    # specify the API plain-text response (this is just an example that won't fit to the command above)
    $plain = "[RESPONSE]\r\nCODE=200\r\nDESCRIPTION=Command completed successfully\r\nEOF\r\n";

    # create a new instance
    $r = WebService::Hexonet::Connector::ResponseTemplate->new($plain);

The difference of this library and the Response library is simply that this library

• does not provide further data access possibilities based on Column and Record library

• does not require an API command to be specified in constructor

DESCRIPTION

HEXONET Backend API always responds in plain-text format that needs to get parsed into a useful data structure. This module manages all this: parsing data into hash format. It provides different methods to access the data to fit your needs. It is used as base class for WebService::Hexonet::Connector::Response. We internally use this module also in our automated tests to play with hardcoded API responses.

Methods

new( $plain )

Returns a new WebService::Hexonet::Connector::ResponseTemplate instance. Specify the plain-text API response as $plain.

getCode

Returns the API response code as int.

getDescription

Returns the API response description as string.

getPlain

Returns the plain-text API response as string.

getQueuetime

Returns the Queuetime of the API response as decimal.

getHash

Returns the API response as Hash.

getRuntime

Returns the Runtime of the API response code as decimal.

isError

Checks if the API response code represents an error case. 500 <= Code <= 599 Returns boolean 0 or 1.

isSuccess

Checks if the API response code represents a success case. 200 <= Code <= 299 Returns boolean 0 or 1.

isTmpError

Checks if the API response code represents a temporary error case. 400 <= Code <= 499 Returns boolean 0 or 1.

isPending

Checks if current operation is returned as pending. Returns boolean 0 or 1.

LICENSE AND COPYRIGHT

This program is licensed under the MIT License.

AUTHOR

HEXONET GmbH