View on
MetaCPAN
Sebastian Riedel > Mojolicious > Mojo

Download:
Mojolicious-7.61.tar.gz

Dependencies

Annotate this POD

Website

View/Report Bugs
Source  

NAME ^

Mojo - Web development toolkit

SYNOPSIS ^

  package MyApp;
  use Mojo::Base 'Mojo';

  # All the complexities of CGI, PSGI, HTTP and WebSockets get reduced to a
  # single method call!
  sub handler {
    my ($self, $tx) = @_;

    # Request
    my $method = $tx->req->method;
    my $path   = $tx->req->url->path;

    # Response
    $tx->res->code(200);
    $tx->res->headers->content_type('text/plain');
    $tx->res->body("$method request for $path!");

    # Resume transaction
    $tx->resume;
  }

DESCRIPTION ^

A powerful web development toolkit, with all the basic tools and helpers needed to write simple web applications and higher level web frameworks, such as Mojolicious. Some of the most commonly used tools are Mojo::UserAgent, Mojo::DOM, Mojo::JSON, Mojo::Server::Daemon, Mojo::Server::Prefork, Mojo::IOLoop and Mojo::Template.

The class Mojo serves as an abstract base class for web frameworks like Mojolicious and Mojolicious::Lite. It provides essentials like the "log" attribute, which web servers like Mojo::Server::Daemon depend on.

See Mojolicious::Guides for more!

ATTRIBUTES ^

Mojo implements the following attributes.

log

  my $log = $app->log;
  $app    = $app->log(Mojo::Log->new);

The logging layer of your application, defaults to a Mojo::Log object.

  # Log debug message
  $app->log->debug('It works');

METHODS ^

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

build_tx

  my $tx = $app->build_tx;

Transaction builder, defaults to building a Mojo::Transaction::HTTP object.

config

  my $hash = $app->config;
  my $foo  = $app->config('foo');
  $app     = $app->config({foo => 'bar', baz => 23});
  $app     = $app->config(foo => 'bar', baz => 23);

Application configuration.

  # Remove value
  my $foo = delete $app->config->{foo};

  # Assign multiple values at once
  $app->config(foo => 'test', bar => 23);

handler

  $app->handler(Mojo::Transaction::HTTP->new);

The handler is the main entry point to your application or framework and will be called for each new transaction, which will usually be a Mojo::Transaction::HTTP or Mojo::Transaction::WebSocket object. Meant to be overloaded in a subclass.

  sub handler {
    my ($self, $tx) = @_;
    ...
  }

SEE ALSO ^

Mojolicious, Mojolicious::Guides, http://mojolicious.org.

syntax highlighting: