简介
use Mojolicious::Routes;
# Simple route
my $r = Mojolicious::Routes->new;
$r->route('/')->to(controller => 'blog', action => 'welcome');
# More advanced routes
my $blog = $r->under('/blog');
$blog->get('/list')->to('blog#list');
$blog->get('/:id' => [id => qr/\d+/])->to('blog#show', id => 23);
$blog->patch(sub { shift->render(text => 'Go away!', status => 405) });
Mojolicious::Routes是Mojolicious Web框架的核心。
属性
Mojolicious::Routes 从 Mojolicious::Roures::Route继承了所有的属性,并实现以下属性。
base_classes
my $classes = $r->base_classes;
$r = $r->base_classes(['MyApp::Controller']);
用于识别控制器的基类,默认为Mojolicious::Controller 和Mojo。
cache
my $cache = $r->cache;
$r = $r->cache(Mojo::Cache->new);
路径缓存,默认为Mojo::Cache对象。
conditions
my $conditions = $r->conditions;
$r = $r->conditions({foo => sub {...}});
包含所有可用的条件。用于有条件的访问控制器。
hidden
my $hidden = $r->hidden;
$r = $r->hidden(['attr', 'has', 'new']);
指定在路由器中隐藏的控制器属性和方法,默认为 attr、has、new 和 tap。
namespaces
my $namespaces = $r->namespaces;
$r = $r->namespaces(['MyApp::Controller', 'MyApp']);
命名空间,用于加载控制器的命名空间。
# Add another namespace to load controllers from
push @{$r->namespaces}, 'MyApp::MyController';
shortcuts
my $shortcuts = $r->shortcuts;
$r = $r->shortcuts({foo => sub {...}});
包含所有可用的shortcuts,用于简写的指定路由的控制器的方法。
方法
Mojolicious::Routes 从Mojolicious::Routes::Route继承所有方法,并实现以下方法。
add_condition
$r = $r->add_condition(foo => sub {...});
注册一个条件。
$r->add_condition(foo => sub {
my ($route, $c, $captures, $arg) = @_;
...
return 1;
});
add_shortcut
$r = $r->add_shortcut(foo => sub {...});
注册一个shortcut.
$r->add_shortcut(foo => sub {
my ($route, @args) = @_;
...
});
continue
$r->continue(Mojolicious::Controller->new);
继续调度后面的链,并在Mojolicious中为每个action触发around_action事件。
dispatch
使用match方法匹配路由,并对匹配到的路由调用continue方法。
hide
$r = $r->hide('foo', 'bar');
在路由中隐藏控制器的属性和方法。
is_hidden
my $bool = $r->is_hidden('foo');
检查控制器的一个属性或方法名是否已经在路由器中隐藏了。
lookup
my $route = $r->lookup('foo');
通过Mojolicious::Routes::Route中的find方法按名称查找路由,并缓存结果以供将来使用。
match
$r->match(Mojolicious::Controller->new);
使用Mojolicious::Routes::Match对象进行路由匹配。