GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  CGI::APPLICATION::PLUGIN::ANYTEMPLATE::COMPONENTHANDLER (3)

.ds Aq ’

NAME

CGI::Application::Plugin::AnyTemplate::ComponentHandler - Embed run modes within a template

CONTENTS

DESCRIPTION

This is a little helper module used by CGI::Application::Plugin::AnyTemplate to handle finding and running the run modes for embedded components, and returning their content.

You shouldn’t need to use this module directly unless you are adding support for a new template system.

For information on embedded components see the docs of CGI::Application::Plugin::AnyTemplate.

METHODS

new Creates a new CGI::Application::Plugin::AnyTemplate::ComponentHandler object.



    my $component_handler = CGI::Application::Plugin::AnyTemplate::ComponentHandler->new(
        webapp              => $webapp,
        containing_template => $template,
    );



The webapp parameter should be a reference to a CGI::Application object.

The containing_template parameter should be a reference to the template object in which this component is embedded.

embed Runs the specified runmode of the webapp object. Returns the results of this call.

Parameters passed to embed should be passed on to the run mode.

If the results are a scalar reference, then the return value is dereferenced before returning. This is the safest way of calling a run mode since you’ll get the output as a string and return it as a string, but it involves returning potentially very large strings from subroutines.

embed_direct Runs the specified runmode of the webapp object. Returns the results of this call.

Parameters passed to embed_direct should be passed on to the run mode.

Even if the result of this call is a scalar reference, the result is NOT dereferenced before returning it.

If you call this method instead of embed, you should be careful to deal with the possibility that your results are a reference to a string and not the string itself.

AUTHOR

Michael Graham, <mgraham@cpan.org>

COPYRIGHT & LICENSE

Copyright 2005 Michael Graham, All Rights Reserved.

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

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 CGI::APPLICATION::PLUGIN::ANYTEMPLATE::COMPONENTHANDLER (3) 2016-03-18

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.