GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  MOJOLICIOUS::ROUTES::MATCH (3)

.ds Aq ’

NAME

Mojolicious::Routes::Match - Find routes

CONTENTS

SYNOPSIS



  use Mojolicious::Controller;
  use Mojolicious::Routes;
  use Mojolicious::Routes::Match;

  # Routes
  my $r = Mojolicious::Routes->new;
  $r->get(/:controller/:action);
  $r->put(/:controller/:action);

  # Match
  my $c = Mojolicious::Controller->new;
  my $match = Mojolicious::Routes::Match->new(root => $r);
  $match->find($c => {method => PUT, path => /foo/bar});
  say $match->stack->[0]{controller};
  say $match->stack->[0]{action};

  # Render
  say $match->path_for->{path};
  say $match->path_for(action => baz)->{path};



DESCRIPTION

Mojolicious::Routes::Match finds routes in Mojolicious::Routes structures.

ATTRIBUTES

Mojolicious::Routes::Match implements the following attributes.

    endpoint



  my $route = $match->endpoint;
  $match    = $match->endpoint(Mojolicious::Routes::Route->new);



The route endpoint that matched, usually a Mojolicious::Routes::Route object.

    position



  my $position = $match->position;
  $match       = $match->position(2);



Current position on the stack, defaults to 0.

    root



  my $root = $match->root;
  $match   = $match->root(Mojolicious::Routes->new);



The root of the route structure, usually a Mojolicious::Routes object.

    stack



  my $stack = $match->stack;
  $match    = $match->stack([{action => foo}, {action => bar}]);



Captured parameters with nesting history.

METHODS

Mojolicious::Routes::Match inherits all methods from Mojo::Base and implements the following new ones.

    find



  $match->find(Mojolicious::Controller->new, {method => GET, path => /});



Match controller and options against root to find an appropriate endpoint.

    path_for



  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.

SEE ALSO

Mojolicious, Mojolicious::Guides, <http://mojolicious.org>.
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 MOJOLICIOUS::ROUTES::MATCH (3) 2016-03-15

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.