NAME

Jifty::Handler - Methods related to the Mason handler

SYNOPSIS

  use Jifty;
  Jifty->new();

  my $handler = Jifty::Handler->handle_request( cgi => $cgi );

  # after each request is handled
  Jifty::Handler->cleanup_request;

DESCRIPTION

Jifty::Handler provides methods required to deal with Mason CGI handlers.

mason

Returns the Jifty c<HTML::Mason> handler. While this "should" be just another template handler, we still rely on it for little bits of Jifty infrastructure. Patches welcome.

new

Create a new Jifty::Handler object. Generally, Jifty.pm does this only once at startup.

view_handlers

Returns a list of modules implementing view for your Jifty application.

XXX TODO: this should take pluggable views

fallback_view_handler

Returns the object for our "last-resort" view handler. By default, this is the HTML::Mason handler.

setup_view_handlers

Initialize all of our view handlers.

view ClassName

Returns the Jifty view handler for ClassName.

create_cache_directories

Attempts to create our app's mason cache directory.

cgi

Returns the CGI object for the current request, or undef if there is none.

apache

Returns the HTML::Mason::FakeApache or Apache object for the current request, ot undef if there is none.

handle_request

When your server processs (be it Jifty-internal, FastCGI or anything else) wants to handle a request coming in from the outside world, you should call handle_request.

cgi

A CGI object that your server has already set up and loaded with your request's data.

cleanup_request

Dispatchers should call this at the end of each request, as a class method. It flushes the session to disk, as well as flushing Jifty::DBI's cache.