NAME

Mojo::Server - HTTP server base class

SYNOPSIS

use Mojo::Base 'Mojo::Server';

sub run {
  my $self = shift;

  # Get a transaction
  my $tx = $self->build_tx;

  # Emit request
  $self->emit(request => $tx);
}

DESCRIPTION

Mojo::Server is an abstract HTTP server base class.

EVENTS

Mojo::Server can emit the following events.

request

$server->on(request => sub {
  my ($server, $tx) = @_;
});

Emitted when a request is ready and needs to be handled.

$server->on(request => sub {
  my ($server, $tx) = @_;
  $tx->res->code(200);
  $tx->res->headers->content_type('text/plain');
  $tx->res->body('Hello World!');
  $tx->resume;
});

ATTRIBUTES

Mojo::Server implements the following attributes.

app

my $app = $server->app;
$server = $server->app(MojoSubclass->new);

Application this server handles, defaults to a Mojo::HelloWorld object.

app_class

my $app_class = $server->app_class;
$server       = $server->app_class('MojoSubclass');

Class of the application this server handles, defaults to Mojo::HelloWorld.

METHODS

Mojo::Server inherits all methods from Mojo::EventEmitter and implements the following new ones.

new

my $server = Mojo::Server->new;

Construct a new Mojo::Server object.

build_tx

my $tx = $server->build_tx;

Let application build a transaction.

load_app

my $app = $server->load_app('./myapp.pl');

Load application from script. Note that this method is EXPERIMENTAL and might change without warning!

say Mojo::Server->new->load_app('./myapp.pl')->home;

run

$server->run;

Start server.

SEE ALSO

Mojolicious, Mojolicious::Guides, http://mojolicio.us.