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.

new

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

create_cache_directories

Attempts to create our app's mason cache directory.

mason_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.

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.