NAME Mason::Plugin::RouterSimple - Specify routes for page components VERSION version 0.06 SYNOPSIS In a top-level component '/archives.mc': <%class> route ":section/{year:[0-9]{4}}/{month:[0-9]{2}}"; Archives for <% $.section %> For the month of <% $.month %>/<% $.year %> then `/archives/news/2010/02' outputs Archives for news For the month of 2010/02 DESCRIPTION See Mason::Manual::RequestDispatch for background on how request paths get mapped to page components. This plugin allows you to parse `$m->path_info' (the remainder of the top-level path) using Router::Simple routes. It can be used whenever `$m->path_info' is set, i.e. with a dhandler or with a partial path. Use the `route' keyword to declare routes in a <%class> block. Like Router::Simple::connect, `route' takes a string/regex pattern and a destination hashref; the latter defaults to `{}' if omitted. e.g. <%class> route "wiki/:page", { action => "wiki" }; route "download/*.*", { action => "download" }; route "blog/{year:[0-9]+}/{month:[0-9]{2}}"; This plugin overrides the default allow_path_info to return true for any component that declares at least one route. For components that do not declare a route, you will need to override `allow_path_info' as usual. Any named captured arguments, including `splat', are placed in component attributes, which are automatically declared (as standard read-write attributes) if you do not otherwise declare them. If you specify more than one route in a component, they will be tried in turn, with the first matching route taking precedence. If none of the routes match, the request will be declined; in a web context this generally means a 404. e.g. Given the route declarations above in a component named '/site.mc', * The URL `/site/wiki/HomePage' will set `$.action = "wiki"' and `$.page = "HomePage"'. * The URL `/site/download/ping.mp3' will set `$.action = "download"' and `$.splat = ['ping', 'mp3']'. * The URL `/site/blog/2010/02' will set `$.year = "2010"' and `$.month = "02"'. * The URLs `/site/other' and `/site/blog/10/02' will result in a decline/404. SUPPORT The mailing list for Mason and Mason plugins is mason-users@lists.sourceforge.net. You must be subscribed to send a message. To subscribe, visit https://lists.sourceforge.net/lists/listinfo/mason-users. You can also visit us at `#mason' on irc:. Bugs and feature requests will be tracked at RT: http://rt.cpan.org/NoAuth/Bugs.html?Dist=Mason-Plugin-RouterSimple bug-mason-plugin-routersimple@rt.cpan.org The latest source code can be browsed and fetched at: http://github.com/jonswar/perl-mason-plugin-routersimple git clone git://github.com/jonswar/perl-mason-plugin-routersimple.git SEE ALSO Mason, Router::Simple AUTHOR Jonathan Swartz 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.