The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Danga::Socket::Callback - Use Danga::Socket From Callbacks

SYNOPSIS

  my $danga = Danga::Socket::Callback->new(
    handle         => $socket,
    context        => { ... },
    on_read_ready  => sub { ... },
    on_write_ready => sub { ... },
    on_error       => sub { ... },
    on_signal_hup  => sub { ... },
  );

  Danga::Socket->EventLoop();

DESCRIPTION

Love the fact that Perlbal, Mogilefs, and friends all run fast because of Danga::Socket, but despise it because you need to subclass it every time? Well, here's a module for all you lazy people.

Danga::Socket::Callback is a thin wrapper arond Danga::Socket that allows you to set callbacks to be called at various events. This allows you to define multiple Danga::Socket-based sockets without defining multiple classes:

  my $first = Danga::Socket::Callback->new(
    hadle => $sock1,
    on_read_ready => \&sub1
  );

  my $second = Danga::Socket::Callback->new(
    hadle => $sock2,
    on_read_ready => \&sub2
  );

  Danga::Socket->EventLoop();

METHODS

new

Creates a new instance of Danga::Socket::Callback. Takes the following parameters:

handle

The socket/handle to read from.

context

Arbitrary data to be shared between your app and Danga::Socket::Callback.

on_read_ready

Specify the code reference to be fired when the socket is ready to be read

on_write_ready

Specify the code reference to be fired when the socket is ready to be written

on_error

Specify te code reference to be fired when there was an error

on_signal_hup

Specify the code reference to be fired when a HUP signal is received.

event_read

event_write

event_err

event_hup

Implements each method available from Danga::Socket. If the corresponding callbacks are available, then calls the callback. Each callback receives the Danga::Socket::Callback object.

For event_write, if no callback is available, then the default event_write method from Danga::Socket is called.

BUGS

Possibly. I don't claim to use 100% of Danga::Socket. If you find any, please report them (preferrably with a failing test case)

AUTHOR

Copyright (c) Daisuke Maki <daisuke@endeworks.jp> All rights reserved.

LICENSE

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

See http://www.perl.com/perl/misc/Artistic.html