Mason::Manual::RequestDispatch(3pm)			User Contributed Perl Documentation		       Mason::Manual::RequestDispatch(3pm)

NAME

       Mason::Manual::RequestDispatch - How request paths get mapped to page components

DESCRIPTION

       Given the request path

	   /news/sports/hockey

       Mason searches for the following components in order, setting $m->path_info as noted.

	   /news/sports/hockey.{mp,mc}
	   /news/sports/hockey/index.{mp,mc}
	   /news/sports/hockey/dhandler.{mp,mc}
	   /news/sports/dhandler.{mp,mc}  # $m->path_info = hockey
	   /news/sports.{mp,mc} 	  # $m->path_info = hockey (but see next section)
	   /news/dhandler.{mp,mc}	  # $m->path_info = sports/hockey
	   /news.{mp,mc}		  # $m->path_info = sports/hockey (but see next section)
	   /dhandler.{mp,mc}		  # $m->path_info = news/sports/hockey

       where ".{mp,mc}" means either ".mp" (indicating a pure-perl component). or ".mc" (indicating a top-level component).

       The following sections describe these elements in more detail.

   Autoextended path
       The request path is suffixed with ".mp" and ".mc" to translate it to a component path.

	   /news/sports/hockey.{mp,mc}

   Index
       An index matches its exact directory, nothing underneath.

	   /news/sports/hockey/index.{mp,mc}

   Dhandlers
       A dhandler matches its directory as well as anything underneath, setting "$m->path_info" to the remainder.

	   /news/sports/hockey/dhandler.{mp,mc}
	   /news/sports/dhandler.{mp,mc}  # $m->path_info = hockey
	   /news/dhandler.{mp,mc}	  # $m->path_info = sports/hockey
	   /dhandler.{mp,mc}		  # $m->path_info = news/sports/hockey

   Partial paths
       A component can match an initial part of the URL, setting "$m->path_info" to the remainder:

	   /news/sports.{mp,mc} 	  # $m->path_info = hockey
	   /news.{mp,mc}		  # $m->path_info = sports/hockey

       Since this isn't always desirable behavior, it must be explicitly enabled for the component. Mason will call method "allow_path_info" on
       the component class, and will only allow the match if it returns true:

	   <%class>
	   method allow_path_info { 1 }
	   </%class>

       The default "allow_path_info" returns false.

       "allow_path_info" is not checked on dhandlers, since the whole point of dhandlers is to match partial paths.

   Routes
       It is possible to use route syntax to more elegantly parse "$m->path_info" for dhandlers and partial paths, e.g.

	   <%class>
	   route "{year:[0-9]+}/{month:[0-9]{2}}";
	   </%class>

       See Mason::Plugin::RouterSimple.

SEE ALSO

       Mason

AUTHOR

       Jonathan Swartz <swartz@pobox.com>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2011 by Jonathan Swartz.

       This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

perl v5.14.2							    2012-05-02				       Mason::Manual::RequestDispatch(3pm)