NAME¶
Catalyst::View::Component::SubInclude::HTTP - 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.
SEE ALSO¶
Catalyst::View::Component::SubInclude
AUTHOR¶
Wallace Reis "<wreis@cpan.org>"
Development sponsored by Ionzero LLC <
http://www.ionzero.com/>.
COPYRIGHT & LICENSE¶
Copyright (c) 2010 Wallace Reis.
This program is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.