NAME¶

"Net::Async::WebSocket::Server" - serve WebSocket clients using "IO::Async"

SYNOPSIS¶

   use Future::AsyncAwait;
   use IO::Async::Loop;
   use Net::Async::WebSocket::Server;
   my $server = Net::Async::WebSocket::Server->new(
      on_client => sub {
         my ( undef, $client ) = @_;
         $client->configure(
            on_text_frame => sub {
               my ( $self, $frame ) = @_;
               $self->send_text_frame( $frame );
            },
         );
      }
   );
   my $loop = IO::Async::Loop->new;
   $loop->add( $server );
   await $server->listen(
      service => 3000,
   );
   $loop->run;

DESCRIPTION¶

This subclass of IO::Async::Listener accepts WebSocket connections. When a new connection arrives it will perform an initial handshake, and then pass the connection on to the continuation callback or method.

EVENTS¶

The following events are invoked, either using subclass methods or CODE references in parameters:

   $self->on_client( $client );
   $on_client->( $self, $client );

   $self->on_handshake( $client, $hs, $continue );
   $on_handshake->( $self, $client, $hs, $continue );

   on_handshake => sub {
      my ( $self, $client, $hs, $continue ) = @_;
      $continue->( $hs->req->origin eq "http://localhost" );
   }

PARAMETERS¶

The following named parameters may be passed to "new" or "configure":

on_client => CODE

on_handshake => CODE

CODE references for event handlers.

AUTHOR¶

Paul Evans <leonerd@leonerd.org.uk>