NAME

Dancer2::Core::Role::Server - Role for Server classes

VERSION

version 0.10

DESCRIPTION

This role defines what servers need to implement and provide some helpful attributes and methods for server implementations.

This role requires implementations that consume it to provide a name subroutine.

ATTRIBUTES

host

Hostname to which the server will bind.

Required.

port

Port number to which the server will bind.

Required.

is_daemon

Boolean for whether the server should daemonize.

apps

An arrayref to hold Dancer2 applications.

dispatcher

A read/write attribute which holds the Dancer2::Core::Dispatcher object, to dispatch an incoming request to the appropriate route.

It has a lazy builder that creates a new dispatcher with the server's apps.

postponed_hooks

Postponed hooks will be applied at the end, when the hookable objects are instantiated, not before.

METHODS

psgi_app

Returns a code reference of a proper PSGI reply to a dispatched request.

It dispatches the request using the dispatcher (and provides the environment variables) and then calls to_psgi and returns that reply wrapped in a code reference.

Please review PSGI for more details on the protocol and how it works.

register_application

Adds another application to the apps attribute (see above).

AUTHOR

Dancer Core Developers

COPYRIGHT AND LICENSE

This software is copyright (c) 2013 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.