man Catalyst::View::Component::SubInclude::HTTP (3): HTTP plugin for C::V::Component::SubInclude

SYNOPSIS

In your view class:

package MyApp::View::TT;
use Moose;
extends 'Catalyst::View::TT';
with 'Catalyst::View::Component::SubInclude';
__PACKAGE__->config(
subinclude_plugin => 'HTTP::GET',
subinclude => {
'HTTP::GET' => {
class => 'HTTP',
http_method => 'GET',
ua_timeout => '10',
uri_map => {
'/my/' => 'http://localhost:5000/',
},
},
'HTTP::POST' => {
class => 'HTTP',
http_method => 'POST',
ua_timeout => '10',
uri_map => {
'/foo/' => 'http://www.foo.com/',
},
},
},
);

Then, somewhere in your templates:

    [% subinclude('/my/widget') %]
    ...
    [% subinclude_using('HTTP::POST', '/foo/path', { foo => 1 }) %]

DESCRIPTION

"Catalyst::View::Component::SubInclude::HTTP" does HTTP requests (currently using LWP::UserAgent) and uses the responses to render subinclude contents.

CONFIGURATION

The configuration is passed in the "subinclude" key based on your plugin name which can be arbitrary.

class: Required just in case your plugin name differs from "HTTP".
http_method: Accepts "GET" and "POST" as values. The default one is "GET".
user_agent: This lazily builds a LWP::UserAgent obj, however you can pass a different user agent obj that implements the required API.
ua_timeout: User Agent's timeout config param. Defaults to 10 seconds.
uri_map: This expects a HashRef in order to map paths to different URLs.
base_url: Used only if "uri_map" is "undef" and defaults to "$c->request->base".

METHODS

generate_subinclude( $c, $path, $args )

Note that $path should be the relative path.

AUTHOR

Wallace Reis "<[email protected]>"

SPONSORSHIP

Development sponsored by Ionzero LLC <http://www.ionzero.com/>.

COPYRIGHT & LICENSE

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.