NAME

       UR::Service::WebServer - A PSGI-based web server

SYNOPSIS

         my $s = UR::Service::WebServer(port => 4321);
         $s->run( \&handle_request );

DESCRIPTION

       Implements a simple, standalone web server based on HTTP::Server::PSGI.  The event loop is
       entered by calling the run() method.

   Properties
       host
           The IP address to listen on for connections.  The default value is 'localhost'.  host
           can be changed any time before the server is created, usually the first time run() is
           called.

       port
           The TCP port to listen on for connections.   The detault value is undef, meaning that
           the system will pick an unused port.  port can be changed any time before the server
           is created, usually the first time run() is called.

       server
           Holds a reference to an object that isa HTTP::Server::PSGI.  This will be
           automatically created the first time run() is called.

       cb  Holds a CODE reference used as the default request handler within run().

   Methods
       $self->announce()
           This method is called when the PSGI server is ready to accept requests.  The base-
           class behavior is to print the listening URL on STDOUT.  Subclasses can override it to
           implement their own behavior.

       my $code = $self->file_handler_for_directory($path)
           A helper method used for implementing server for files located in the directory $path.
           It returns a CODE ref that takes 2 arguments, $env (the standard PSGI env hashref) and
           $pathname (a path relative to $path).  It returns the standard tuple a PSGI server
           expects.

           $pathname is pre-processed by removing all occurrences of ".." to keep requests within
           the provided $path.  If the requested file is not found, then it returns a 404.

       $self->run(<$cb>)
           Enter the request loop.  If a callback is not provided to run(), then the object's cb
           property is used instead.  If neither have a value, then run() returns immediately.

           For each request $cb is called with one argument, the standard PSGI env hashref.

SEE ALSO

       UR::Service::UrlRouter