jifty::view::mason::handler(3pm) [debian man page]

Jifty::View::Mason::Handler(3pm)			User Contributed Perl Documentation			  Jifty::View::Mason::Handler(3pm)

NAME

       Jifty::View::Mason::Handler - Handler for Mason requests inside of Jifty

SUMMARY

       Jifty controls all of the input and output from the Mason templating engine; this means that we cannot use the Mason's standard
       HTML::Mason::CGIHandler interface to interact with it.

   new PARAMHASH
       Takes a number of key-value parameters; see HTML::Mason::Params.  Defaults the "out_method" to appending to "buffer" in Jifty::Handler and
       the "request_class" to Jifty::View::Mason::Request (below).  Finally, adds "h" and "u" escapes, which map to "escape_uri" and escape_utf8
       respectively.

   config
       Returns our Mason config.  We use the component root specified in the "Web/TemplateRoot" framework configuration variable (or "html" by
       default).  Additionally, we set up a "jifty" component root, as specified by the "Web/DefaultTemplateRoot" configuration.  All
       interpolations are HTML-escaped by default, and we use the fatal error mode.

   escape_utf8 SCALARREF
       Does a css-busting but minimalist escaping of whatever html you're passing in.

   escape_uri SCALARREF
       Escapes in-place URI component according to RFC2396. Takes a reference to perl string.

       *Note* that octets would be treated as latin1 encoded sequence and converted to UTF-8 encoding and then escaped. So this sub always provide
       UTF-8 escaped string. See also Encode for more info about converting.

   template_exists COMPONENT
       Checks if the "COMPONENT" exists, or if "COMPONENT/index.html" exists, and returns which one did.  If neither did, it searches for
       "dhandler" components which could match, returning "COMPONENT" if it finds one.	Finally, if it finds no possible component matches,
       returns undef.

       Note that this algorithm does not actually decisively return if Mason will handle a given component; the dhandlers could defer handling,
       for instance.

   show COMPONENT
       Takes a component path to render.  Deals with setting up a global HTML::Mason::FakeApache and Request object, and calling the component.

   handle_comp
       A synonym for show

   request_args
       The official source for request arguments is from the current Jifty::Request object.

   create_cache_directories
       Attempts to create our application's mason cache directory.

perl v5.14.2							    2010-12-08					  Jifty::View::Mason::Handler(3pm)

HTML::Mason::Resolver(3pm)				User Contributed Perl Documentation				HTML::Mason::Resolver(3pm)

NAME

       HTML::Mason::Resolver - Component path resolver base class

SYNOPSIS

	 # make a subclass and use it

DESCRIPTION

       The resolver is responsible for translating a component path like /foo/index.html into a component.  By default, Mason expects components
       to be stored on the filesystem, and uses the HTML::Mason::Resolver::File class to get information on these components.

       The HTML::Mason::Resolver provides a virtual parent class from which all resolver implementations should inherit.

Class::Container
       This class is used by most of the Mason object's to manage constructor parameters and has-a relationships with other objects.

       See the documentation on this class for details on how to declare what paremeters are valid for your subclass's constructor.

       HTML::Mason::Resolver is a subclass of Class::Container so you do not need to subclass it yourself.

METHODS

       If you are interested in creating a resolver subclass, you must implement the following methods.

       new This method is optional.  The new method included in this class is simply inherited from "Class::Container".  If you need something
	   more complicated done in your new method you will need to override it in your subclass.

       get_info
	   Takes three arguments: an absolute component path, a component root key, and a component root path. Returns a new
	   HTML::Mason::ComponentSource object.

       glob_path
	   Takes two arguments: a path glob pattern, something like "/foo/*" or "/foo/*/bar", and a component root path. Returns a list of
	   component paths for components which match this glob pattern.

	   For example, the filesystem resolver simply appends this pattern to the component root path and calls the Perl "glob()" function to
	   find matching files on the filesystem.

   Using a Resolver with HTML::Mason::ApacheHandler
       If you are creating a new resolver that you intend to use with the HTML::Mason::ApacheHandler module, then you must implement the following
       method as well.

       apache_request_to_comp_path ($r, @comp_root_array)
	   This method, given an Apache object and a list of component root pairs, should return a component path or undef if none exists.  This
	   method is used by the HTML::Mason::ApacheHandler class to translate web requests into component paths.  You can omit this method if
	   your resolver subclass will never be used in conjunction with HTML::Mason::ApacheHandler.

SEE ALSO

       HTML::Mason

perl v5.14.2							    2012-02-04						HTML::Mason::Resolver(3pm)