NAME

Router::Simple::Cookbook - The Router::Simple Cookbook

FAQ

How to create Sinatra-ish framework with Router::Simple?

Please read the following example code.

package MySinatraish;
use Router::Simple;
use Plack::Request;

sub import {
    my $pkg = caller(0);
    my $router = Router::Simple->new();
    my $any = sub ($$;$) {
        my ($pattern, $dest, $opt) = do {
            if (@_ == 3) {
                my ($methods, $pattern, $code) = @_;
                ($pattern, {code => $code}, +{method => [ map { uc $_ } @$methods ]});
            } else {
                my ($pattern, $code) = @_;
                ($pattern, {code => $code}, +{});
            }
        };
        $router->connect(
            $pattern,
            $dest,
            $opt,
        );
    };
    no strict 'refs';
    # any [qw/get post delete/] => '/bye' => sub { ... };
    # any '/bye' => sub { ... };
    *{"${pkg}::any"} = $any;
    *{"${pkg}::get"} = sub {
        $any->([qw/GET HEAD/], $_[0], $_[1]);
    };
    *{"${pkg}::post"} = sub {
        $any->([qw/POST/], $_[0], $_[1]);
    };
    *{"${pkg}::as_psgi_app"} = sub {
        return sub {
            if (my $p = $router->match($_[0])) {
                [200, [], [$p->{code}->()]];
            } else {
                [404, [], ['not found']];
            }
        }
    };
}

package MyApp;
use MySinatraish;
get '/' => sub {
    'top';
};
post '/new' => sub {
    'posted';
};
as_psgi_app;

How to switch from HTTPx::Dispatcher?

HTTPx::Dispatcher is class specific declarative router.

package MyApp::Dispatcher;
use HTTPx::Dispatcher;
connect '/', {controller => 'foo', action => 'bar'};
1;

The following script is same as above.

package MyApp::Dispatcher;
use Router::Simple::Declare;

my $router = router {
    connect '/', {controller => 'foo', action => 'bar'};
};
sub match { $router->match() }

How to use Router::Simple with non-strictly-MVC application?

use Router::Simple::Declare;
my $router = router {
    connect '/foo/bar/' => { 'target' => '/foobar.asp' };
    connect '/topics/:topic' => { target => '/my-topic.asp' };
    connect '/products/{Category:.*}' => { target => '/products.asp', Category => 'All' };
    connect '/zipcode/{zip:[0-9]{5,5}}' => {target => '/zipcode.asp' };
};

You can pass the target path as destination.

AUTHOR

Tokuhiro Matsuno <tokuhirom AAJKLFJEF GMAIL COM>

LICENSE

Copyright (C) Tokuhiro Matsuno

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

SEE ALSO

Router::Simple