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 ($server, $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!
EVENTS
Mojo::IOLoop::Server can emit the following events.
accept
$server->on(accept => sub {
my ($server, $handle) = @_;
});
Emitted for each accepted connection.
ATTRIBUTES
Mojo::IOLoop::Server implements the following attributes.
accepts
my $accepts = $server->accepts;
$server = $server->accepts(10);
Number of connections to accept at once, defaults to 10
.
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::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.