NAME
Mojo::IOLoop::Server - Non-blocking TCP 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->start;
$server->stop;
# Start reactor if necessary
$server->reactor->start unless $server->reactor->is_running;DESCRIPTION
Mojo::IOLoop::Server accepts TCP connections for Mojo::IOLoop.
EVENTS
Mojo::IOLoop::Server inherits all events from Mojo::EventEmitter and can emit the following new ones.
accept
$server->on(accept => sub {
my ($server, $handle) = @_;
...
});Emitted safely for each accepted connection.
ATTRIBUTES
Mojo::IOLoop::Server implements the following attributes.
multi_accept
my $multi = $server->multi_accept;
$server = $server->multi_accept(100);Number of connections to accept at once, defaults to 50.
reactor
my $reactor = $server->reactor;
$server = $server->reactor(Mojo::Reactor::Poll->new);Low level event reactor, defaults to the reactor attribute value of the global Mojo::IOLoop singleton.
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 (1.75+) and IPv6 support on IO::Socket::IP (0.16+).
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_ca
-
Path to TLS certificate authority file.
- tls_cert
-
Path to the TLS cert file, defaults to a built-in test certificate.
- tls_key
-
Path to the TLS key file, defaults to a built-in test key.
- tls_verify
-
TLS verification mode, defaults to
0x03.
generate_port
my $port = $server->generate_port;Find a free TCP port, this is a utility function primarily used for tests.
start
$server->start;Start accepting connections.
stop
$server->stop;Stop accepting connections.