NAME

Net::Analysis::Listener::Example1 - emit/receive custom events

SYNOPSIS

 package Net::Analysis::Listener::Example1;
 use strict;
 use warnings;
 use base qw(Net::Analysis::Listener::Base);
 sub tcp_monologue {
     my ($self, $args) = @_;
     my ($mono) = $args->{monologue}; # isa Net::Analysis::TCPMonologue
     my $t = $mono->t_elapsed()->as_number();
     my $l = $mono->length();
     $self->emit(name => 'example_bandwidth_measurement_event',
                 args => { kb_sec => ($t) ? $l/($t*1024) : 0 }
                );
 }
 sub example_bandwidth_measurement_event {
     my ($self, $args) = @_;
     printf "Bandwidth: %10.2f KB/sec\n", $args->{kb_sec};
 }
 1;

You can invoke this example on a TCP capture file from the command line, as follows:

 $ perl -MNet::Analysis -e main Example1 t/t1_google.tcp

DESCRIPTION

This example shows how to emit your own custom events, and also how to listen to them. This particular example has "example_bandwidth_measurement_event" in the same Listener.pm file, but you could easily put it in another Listener.pm if you wanted - just remember to tell the dispatcher about both of them.

SEE ALSO

Net::Analysis.

AUTHOR

Adam B. Worrall, <worrall@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2004 by Adam B. Worrall

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.5 or, at your option, any later version of Perl 5 you may have available.