NAME

       UR::Service::UrlRouter - PSGI-aware router for incoming requests

SYNOPSIS

         my $r = UR::Service::UrlRouter->create();
         $r->GET('/index.html', \&handle_index);
         $r->POST(qr(update/(.*?).html, \&handle_update);

         my $s = UR::Service::WebServer->create();
         $s->run( $r );

DESCRIPTION

       This class acts as a middleman, routing requests from a PSGI server to the appropriate function to handle
       the requests.

   Properties
       verbose
           If verbose is true, the object will print details about the handled requests to STDOUT.

   Methods
       $r->GET($URLish, $handler)
       $r->POST($URLish, $handler)
       $r->PUT($URLish, $handler)
       $r->DELETE($URLisn, $handler)
           These  four  methods  register a handler for the given request method + URL pair.  The first argument
           specifies the URL to match against,  It can be specified in one of the following ways

           $string
               A simple string matches the incoming request if the request's path is eq to the $string

           qr(some regex (with) captures)
               A regex matches the incoming request if the path  matches  the  regex.   If  the  regex  contains
               captures, these are passed as additional arguments to the $handler.

           $coderef
               A coderef matches the incoming request if $coderef returns true.  $coderef is given one acgument:
               the PSGI env hashref.

               $handler is a CODE ref.  When called, the first argument is the standard PSGI env hashref.

       $r->__call__
           __call__ is not intended to be called directly.

           This  class  overloads  the  function dereference (call) operator so that the object may be used as a
           callable object (ie. $obj->(arg, arg)).  As overload  expects,  __call__  returns  a  code  ref  that
           handles  the  PSGI request by finding an appropriate match with the incoming request and a previously
           registered handler.  If no matching handler is found, it returns a 404 error code.

           If multiple handlers match the incoming request, then only the earliest registered  handler  will  be
           called.

SEE ALSO

       UR::Service::WebServer, HTTP::Server::PSGI, Plack

perl v5.32.1                                       2022-01-17                        UR::Service::UrlRouter(3pm)