view release on metacpan or  search on metacpan

docs/api/Apache/Wombat.html  view on Meta::CPAN

server and enables it to act as an Apache request handler during the
content handling phase.</P>
<P>Typically an instance of <STRONG>Apache::Wombat</STRONG> is created at server
startup time and configured as a method handler for requests that
should be served by Wombat.</P>
<P>In order to use this class, mod_perl must be built with
<CODE>PERL_METHOD_HANDLERS</CODE> enabled.</P>
<P>
<HR>
<H1><A NAME="constructor">CONSTRUCTOR</A></H1>
<DL>
<DT><STRONG><A NAME="item_new">new($home, $configFile)</A></STRONG><BR>
<DD>
Create and return an instance.
<P>A couple of assumptions are made with regard to the Wombat server's
configuration:</P>
<OL>
<LI>
Exactly one Service is configured, with exactly one Engine and one or
more Hosts beneath it. If more than one service is configured, only
the first will be used. If the Service or Engine are not configured,
the constructor will die.
<P></P>
<LI>
At most one standard Connector (<STRONG>Apache::Wombat::Connector</STRONG>) and one
secure Connector are configured. Any further Connectors will be
ignored.
<P></P></OL>
<P>Assuming everything goes OK, for each child process, <CODE>await()</CODE> will
be called on the child's copy of the server during the child init
phase, and <CODE>stop()</CODE> will be called on it during the child exit
phase. Note that active sessions are not expired when httpd is
shutdown (due to some kind of mod_perl bug with registering a server
cleanup handler). This is <STRONG>NOT</STRONG> a session persistence mechanism and
should not be relied upon as such.</P>
<P><STRONG>Parameters:</STRONG></P>
<DL>
<DT><STRONG><A NAME="item_%24home">$home</A></STRONG><BR>
<DD>
the path to Wombat's home directory, either absolute or relative
to the Apache ServerRoot (defaults to the ServerRoot)
<P></P>
<DT><STRONG><A NAME="item_%24configFile">$configFile</A></STRONG><BR>
<DD>
the path to Wombat's server deployment descriptor, <CODE>server.xml</CODE>,
either absolute or relative to the home directory (defaults to
<CODE>$home/conf/server.xml</CODE>)
<P></P></DL>
<P>Dies if a configuration problem is encountered or if the server cannot
be started.</P>
</DL>
<P>
<HR>
<H1><A NAME="public methods">PUBLIC METHODS</A></H1>
<DL>
<DT><STRONG><A NAME="item_handler"><CODE>handler($r)</CODE></A></STRONG><BR>
<DD>
Delegate request processing to the Wombat server. If <CODE>$ENV{HTTPS}</CODE> is
set, the request is handed to the configured secure Connector;
otherwise, the configured standard Connector gets the request.
<P>Make sure your SSL module sets <CODE>$ENV{HTTPS}</CODE>! With mod_ssl, you can
do this with <CODE>SSLOptions +StdEnvVars</CODE>.</P>
<P><STRONG>Parameters:</STRONG></P>
<DL>
<DT><STRONG><A NAME="item_%24r">$r</A></STRONG><BR>
<DD>
the <STRONG>Apache</STRONG> request object
<P></P></DL>
</DL>
<P>
<HR>
<H1><A NAME="see also">SEE ALSO</A></H1>
<P><EM>mod_perl</EM>,
<EM>Apache</EM>,
<A HREF="../../api/Wombat/Server.html">the Wombat::Server manpage</A></P>
<P>
<HR>
<H1><A NAME="author">AUTHOR</A></H1>
<P>Brian Moseley, <A HREF="mailto:bcm@maz.org">bcm@maz.org</A></P>

</BODY>

</HTML>