NAME

HTTP::Router - Yet Another Path Router for HTTP

SYNOPSIS

use HTTP::Router;

my $router = HTTP::Router->new;

my $route = HTTP::Router::Route->new(
    path       => '/',
    conditions => { method => 'GET' },
    params     => { controller => 'Root', action => 'index' },
);
$router->add_route($route);
# or
$router->add_route('/' => (
    conditions => { method => 'GET' },
    params     => { controller => 'Root', action => 'index' },
));

# GET /
my $match = $router->match($req);
$match->params;  # { controller => 'Root', action => 'index' }
$match->uri_for; # '/'

DESCRIPTION

HTTP::Router provides a way of constructing routing tables.

If you are interested in a Merb-like constructing way, please check HTTP::Router::Declare.

METHODS

new

Returns a HTTP::Router object.

add_route($route)

add_route($path, %args)

Adds a new route. You can specify HTTP::Router::Route object, or path string and options pair.

example:

my $route = HTTP::Router::Route->new(
    path       => '/',
    conditions => { method => 'GET' },
    params     => { controller => 'Root', action => 'index' },
);

$router->add_route($route);

equals to:

$router->add_route('/' => (
    conditions => { method => 'GET' },
    params     => { controller => 'Root', action => 'index' },
));

routes

Returns registered routes.

reset

Clears registered routes.

freeze

Creates inline matcher using registered routes.

thaw

Clears inline matcher.

is_frozen

Returns true if inline matcher is defined.

match($req)

Returns a HTTP::Router::Match object that matches a given request. If no routes match, it returns undef.

route_for($req)

Returns a HTTP::Router::Route object that matches a given request. If no routes match, it returns undef.

AUTHOR

NAKAGAWA Masaki <masaki@cpan.org>

Takatoshi Kitano <kitano.tk@gmail.com>

LICENSE

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

SEE ALSO

HTTP::Router::Declare, HTTP::Router::Route, HTTP::Router::Match,

MojoX::Routes, http://merbivore.com/, HTTPx::Dispatcher, Path::Router, Path::Dispatcher