NAME

WWW::OAuth::Request - HTTP Request container role

SYNOPSIS

  use Role::Tiny::With;
  with 'WWW::OAuth::Request';

DESCRIPTION

WWW::OAuth::Request is a Role::Tiny role that provides a consistent interface to WWW::OAuth for parsing and authenticating requests. See "HTTP REQUEST CONTAINERS" in WWW::OAuth for specifics.

METHODS

WWW::OAuth::Request implements or requires the following methods.

body_pairs

 my $pairs = $req->body_pairs;

Return body parameters from "application/x-www-form-urlencoded" "content" as an even-sized arrayref of keys and values.

content

 my $content = $req->content;
 $req        = $req->content('foo=1&baz=2');

Set or return request content. Must be implemented to compose role.

content_is_form

 my $bool = $req->content_is_form;

Check whether content is single-part and content type is "application/x-www-form-urlencoded". Must be implemented to compose role.

 my $header = $req->header('Content-Type');
 $req       = $req->header('Content-Type' => 'application/x-www-form-urlencoded');

Set or return a request header. Multiple values can be set by passing an array reference as the value, and multi-value headers are joined on ", " when returned. Must be implemented to compose role.

method

 my $method = $req->method;
 $req       = $req->method('GET');

Set or return request method. Must be implemented to compose role.

query_pairs

 my $pairs = $req->query_pairs;

Return query parameters from "url" as an even-sized arrayref of keys and values.

request_with

 my $res = $req->request_with($ua);

Send request using passed user-agent object, and return response. Must be implemented to compose role.

url

 my $url = $req->url;
 $req    = $req->url('http://example.com/api/');

Set or return request URL. Must be implemented to compose role.

BUGS

Report any issues on the public bugtracker.

AUTHOR

Dan Book <dbook@cpan.org>

COPYRIGHT AND LICENSE

This is free software, licensed under:

  The Artistic License 2.0 (GPL Compatible)