#!/usr/bin/env perl
# vim: ts=2 sw=2 noexpandtab
# This example illustrates explicit callbacks via Reflex roles. An
# object is assigned a role to play in its owner. Event names are
# mapped to methods by joining a prefix ("on" by default), the role
# name, and the event name. For example, a DNS resolver might have
# the role "resolver". The invocant's on_resolver_answer() would be
# called by default to invoke the resolver's "answer" event.
# Reflex::Callbacks and the Reflex::Callback helper classes will
# abstract callbacks to fulfill a number of goals. The goals are
# detailed in docs/TODO.otl and summarized in eg/eg-20-rcb-callback.pl
use warnings;
use strict;
use lib qw(t/lib);
use Test::More tests => 4;
# Create a thing that will invoke callbacks. cb_role() defines the
# thing's role within the RoleHandlerObject.
#
# There is no nonambiguous implicit syntax at this time. Suggestions
# for one are welcome.
{
package RoleHandlerObject;
use Moose;
use Reflex::Callbacks qw(cb_role);
use ThingWithCallbacks;
has callback_thing => ( is => 'rw', isa => 'ThingWithCallbacks' );
sub BUILD {
my $self = shift;
$self->callback_thing(
ThingWithCallbacks->new( cb_role($self, "thing") )
);
}
sub on_thing_event {
my ($self, $arg) = @_;
Test::More::pass("$self - role object handled event");
}
sub run_thing {
my $self = shift;
$self->callback_thing()->run();
}
}
my $rho = RoleHandlerObject->new();
$rho->run_thing();
pass("$rho - role handler object ran to completion");
# This form invokes a class methods.
{
package RoleHandlerClass;
use Moose;
use Reflex::Callbacks qw(cb_role);
use ThingWithCallbacks;
has callback_thing => ( is => 'rw', isa => 'ThingWithCallbacks' );
sub BUILD {
my $self = shift;
$self->callback_thing(
ThingWithCallbacks->new( cb_role(__PACKAGE__, "thing") )
);
}
sub on_thing_event {
my ($self, $arg) = @_;
Test::More::pass("$self - role class handled event");
}
sub run_thing {
my $self = shift;
$self->callback_thing()->run();
}
}
my $rhc = RoleHandlerClass->new();
$rhc->run_thing();
pass("$rhc - role handler class ran to completion");