| Mojolicious documentation | Contained in the Mojolicious distribution. |
Mojo::Server - HTTP Server Base Class
use Mojo::Base 'Mojo::Server';
sub run {
my $self = shift;
# Get a transaction
my $tx = $self->on_transaction->($self);
# Call the handler
$tx = $self->on_request->($self);
}
Mojo::Server is an abstract HTTP server base class.
Mojo::Server implements the following attributes.
appmy $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.
on_request my $handler = $server->on_request;
$server = $server->on_request(sub {
my ($self, $tx) = @_;
});
Callback to be invoked for requests that need a response.
on_transaction my $btx = $server->on_transaction;
$server = $server->on_transaction(sub {
my $self = shift;
return Mojo::Transaction::HTTP->new;
});
Callback to be invoked when a new transaction is needed.
on_websocket my $handshake = $server->on_websocket;
$server = $server->on_websocket(sub {
my ($self, $tx) = @_;
});
Callback to be invoked for WebSocket handshakes.
Mojo::Server inherits all methods from Mojo::Base and implements the following new ones.
load_app my $app = $server->load_app('./myapp.pl');
Load application from script. Note that this method is EXPERIMENTAL and might change without warning!
print Mojo::Server->new->load_app('./myapp.pl')->home;
run$server->run;
Start server.
Mojolicious, Mojolicious::Guides, http://mojolicio.us.
| Mojolicious documentation | Contained in the Mojolicious distribution. |
package Mojo::Server; use Mojo::Base -base; use Carp 'croak'; use Mojo::Loader; use Mojo::Util 'md5_sum'; use Scalar::Util 'blessed'; has app => sub { my $self = shift; # App in environment return $ENV{MOJO_APP} if ref $ENV{MOJO_APP}; # Load if (my $e = Mojo::Loader->load($self->app_class)) { die $e if ref $e; } $self->app_class->new; }; has app_class => sub { ref $ENV{MOJO_APP} || $ENV{MOJO_APP} || 'Mojo::HelloWorld' }; has on_request => sub { sub { my $app = shift->app; my $tx = shift; $app->handler($tx); }; }; has on_transaction => sub { sub { my $self = shift; $self->app->on_transaction->($self->app); }; }; has on_websocket => sub { sub { my $self = shift; $self->app->on_websocket->($self->app, @_)->server_handshake; }; }; sub load_app { my ($self, $file) = @_; # Cleanup environment local $ENV{MOJO_APP_LOADER} = 1; local $ENV{MOJO_APP}; local $ENV{MOJO_EXE}; # Try to load application from script into sandbox my $class = 'Mojo::Server::SandBox::' . md5_sum($file . $$); my $app; die $@ unless eval <<EOF; package $class; { unless (\$app = do \$file) { die qq/Can't load application "\$file": \$@/ if \$@; die qq/Can't load application "\$file": \$!/ unless defined \$app; die qq/Can't load application' "\$file".\n/ unless \$app; } } 1; EOF die qq/"$file" is not a valid application.\n/ unless blessed $app && $app->isa('Mojo'); $self->app($app); $app; } # "Are you saying you're never going to eat any animal again? What about # bacon? # No. # Ham? # No. # Pork chops? # Dad, those all come from the same animal. # Heh heh heh. Ooh, yeah, right, Lisa. A wonderful, magical animal." sub run { croak 'Method "run" not implemented by subclass' } 1; __END__