Mojo::IOLoop::Server

NAME
SYNOPSIS
DESCRIPTION
ATTRIBUTES
- 'iowatcher'
METHODS
EVENTS
- 'accept'
SEE ALSO

NAME

Mojo::IOLoop::Server - IOLoop Socket Server

SYNOPSIS

  use Mojo::IOLoop::Server;
     
  # Create listen socket
  my $server = Mojo::IOLoop::Server->new;
  $server->on(accept => sub {
    my ($self, $handle) = @_;
    ...
  });
  $server->listen(port => 3000);
     
  # Start and stop accepting connections
  $server->resume;
  $server->pause;

DESCRIPTION

Mojo::IOLoop::Server accepts incoming socket connections for Mojo::IOLoop. Note that this module is EXPERIMENTAL and might change without warning!

ATTRIBUTES

Mojo::IOLoop::Server implements the following attributes.

iowatcher

  my $watcher = $server->iowatcher;
  $server     = $server->iowatcher(Mojo::IOWatcher->new);

Low level event watcher, usually a Mojo::IOWatcher or Mojo::IOWatcher::EV object.

METHODS

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

listen

  $server->listen(port => 3000);

Create a new listen socket. Note that TLS support depends on IO::Socket::SSL and IPv6 support on IO::Socket::IP.

These options are currently available:

address
Local address to listen on, defaults to all.
backlog
Maximum backlog size, defaults to SOMAXCONN.
port
Port to listen on.
tls
Enable TLS.
tls_cert
Path to the TLS cert file, defaulting to a built-in test certificate.
tls_key
Path to the TLS key file, defaulting to a built-in test key.
tls_ca
Path to TLS certificate authority file or directory.

generate_port

  my $port = $server->generate_port;

Find a free TCP port.

pause

  $server->pause;

Stop accepting connections.

resume

  $server->resume;

Start accepting connections.

EVENTS

Mojo::IOLoop::Server can emit the following events.

accept

Emitted for each accepted connection.