NAME¶

Dancer2::Core::Dispatcher - Class for dispatching request to the appropriate route handler

VERSION¶

version 0.152000

SYNOPSIS¶

    use Dancer2::Core::Dispatcher;
    # Create an instance of dispatcher
    my $dispatcher = Dancer2::Core::Dispatcher->new( apps => [$app] );
    # Dispatch a request
    my $resp = $dispatcher->dispatch($env)->to_psgi;
    # Capture internal error of a response (if any) after a dispatch
    $dispatcher->response_internal_error($app, $error);
    # Capture response not found for an application the after dispatch
    $dispatcher->response_not_found($env);

ATTRIBUTES¶

apps¶

The apps is an array reference to Dancer2::Core::App.

default_content_type¶

The default_content_type is a string which represents the context of the request. This attribute is read-only.

METHODS¶

dispatch¶

The "dispatch" method accepts the list of applications, hash reference for the env attribute of Dancer2::Core::Request and optionally the request object and an env as input arguments. "dispatch" returns a response object of Dancer2::Core::Response. Any before hook and matched route code is wrapped using Return::MultiLevel to allow DSL keywords such as forward and redirect to short-circuit remaining code without having to throw an exception. Return::MultiLevel will use Scope::Upper (an XS module) if it is available.

response_internal_error¶

The "response_internal_error" takes as input the list of applications and a variable error and returns an object of Dancer2::Core::Error.

response_not_found¶

The "response_not_found" consumes as input the list of applications and an object of type Dancer2::Core::App and returns an object Dancer2::Core::Error.

AUTHOR¶

Dancer Core Developers

COPYRIGHT AND LICENSE¶

This software is copyright (c) 2014 by Alexis Sukrieh. This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.