Tomas Doran > Catalyst-View-Component-SubInclude-0.10 > Catalyst::View::Component::SubInclude::HTTP

Download:
Catalyst-View-Component-SubInclude-0.10.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  2
Open  1
View/Report Bugs
Module Version: 0.01   Source  

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>

SPONSORSHIP ^

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.

syntax highlighting: