NAME

Connector::Proxy::HTTP

DESCRIPTION

Send or retrieve data from a defined URI using HTTP.

USAGE

minimal setup

  Connector::Proxy::HTTP->new({
    LOCATION => 'https://127.0.0.1/my/base/url',
  });

connection settings

See Connector::Role::SSLUserAgent for SSL and HTTP related settings

additional options

named_parameters: not implemented yet
header: A HashRef, the key/value pairs are set as HTTP headers.
http_auth: A HashRef with user and pass used as credentials to perform a HTTP Basic Authentication.
chomp_result: When working with text documents the transport layer adds a trailing newline which might be unhandy when working with scalar values. If set to a true value, a trailing newline will be removed by calling "chomp".
undef_on_404: By default, the connector will die if a resource is not found. If set to a true value the connector returns undef, note that die_on_undef will be obeyed.

Parameter used with set

file/path: You can append a templated string to the LOCATION by setting file, path or simply pass ARGS. See Connector::Role::LocalPath for details.
content: A template toolkit string to generate the payload, receives the payload argument as HasRef in DATA.
content_type: The Content-Type header to use, default is no header.
http_method: The http method to use, default is PUT.

Result Handling

If you need to parse the result returned by get, inherit from the class an implement _parse_result. This method receives the response object from the user agent call and must return a scalar value which is returned to the caller.