| Mojolicious::Routes::Match(3pm) | User Contributed Perl Documentation | Mojolicious::Routes::Match(3pm) |
Mojolicious::Routes::Match - Find routes
use Mojolicious::Controller;
use Mojolicious::Routes;
use Mojolicious::Routes::Match;
# Routes
my $r = Mojolicious::Routes->new;
$r->get('/user/:id');
$r->put('/user/:id');
# Match
my $c = Mojolicious::Controller->new;
my $match = Mojolicious::Routes::Match->new(root => $r);
$match->find($c => {method => 'PUT', path => '/user/23'});
say $match->stack->[0]{id};
# Render
say $match->path_for->{path};
say $match->path_for(id => 24)->{path};
Mojolicious::Routes::Match finds routes in Mojolicious::Routes structures.
Mojolicious::Routes::Match implements the following attributes.
my $route = $match->endpoint; $match = $match->endpoint(Mojolicious::Routes::Route->new);
The route endpoint that matched, usually a Mojolicious::Routes::Route object.
my $position = $match->position; $match = $match->position(2);
Current position on the "stack", defaults to 0.
my $root = $match->root; $match = $match->root(Mojolicious::Routes->new);
The root of the route structure, usually a Mojolicious::Routes object.
my $stack = $match->stack;
$match = $match->stack([{action => 'foo'}, {action => 'bar'}]);
Captured parameters with nesting history.
Mojolicious::Routes::Match inherits all methods from Mojo::Base and implements the following new ones.
$match->find(Mojolicious::Controller->new, {method => 'GET', path => '/'});
Match controller and options against "root" to find an appropriate "endpoint".
my $info = $match->path_for;
my $info = $match->path_for(foo => 'bar');
my $info = $match->path_for({foo => 'bar'});
my $info = $match->path_for('named');
my $info = $match->path_for('named', foo => 'bar');
my $info = $match->path_for('named', {foo => 'bar'});
Render matching route with parameters into path.
Mojolicious, Mojolicious::Guides, <https://mojolicious.org>.
| 2022-12-22 | perl v5.36.0 |