Apache::App::Mercury::Controller - Example Controller class
This is simply a skeleton class which illustrates how a controller should interact with Apache::App::Mercury. Please look at the code to see how it should contruct and initialize an Apache::App::Mercury object, run its main content handler, and then cleanup non-persistent instance variables on completion. It does not illustrate object persistence; not for difficulty reasons, simply for lack of time. I highly recommend Apache::Session.
The below instance variables and accessors are required in your controller class for Apache::App::Mercury to operate properly.
$controller->{q}
A CGI query object for the current http request.
$controller->{r}
An Apache->request object for the current http request.
infomsg([$msg])
Set or get a page-specific informational message. The controller should display this message in some prominent location on the resulting HTML page.
pagetitle([$title])
Set or get the HTML page title.
pagebody([$body])
Set or get the page body content.
get_time()
Return the current unixtime, as returned by the Perl time() function. This accessor is used for time synchronization throughout the application, so your controller can keep a single time for each http request.
sitemark([$mark])
Set or get a page-specific location mark, for logging purposes.
Adi Fairbank <adi@adiraj.org>
Copyright (c) 2003 - Adi Fairbank
This software (Apache::App::Mercury and all related Perl modules under the Apache::App::Mercury namespace) is copyright Adi Fairbank.
July 19, 2003
To install Apache::App::Mercury, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Apache::App::Mercury
CPAN shell
perl -MCPAN -e shell install Apache::App::Mercury
For more information on module installation, please visit the detailed CPAN module installation guide.