NAME

Reflex::Collection - Autmatically manage a collection of Reflex objects

VERSION

version 0.004

SYNOPSIS

package TcpEchoServer;

use Moose;
extends 'Reflex::Listener';
use Reflex::Collection;
use EchoStream;

has clients => (
	is      => 'rw',
	isa     => 'Reflex::Collection',
	default => sub { Reflex::Collection->new() },
	handles => { remember_client => "remember" },
);

sub on_listener_accepted {
	my ($self, $args) = @_;
	$self->remember_client(
		EchoStream->new(
			handle => $args->{socket},
			rd     => 1,
		)
	);
}

1;

DESCRIPTION

Some object manage collections of other objects. For example, network servers must track objects that represent client connections. If not, those objects would go out of scope, destruct, and disconnect their clients.

Reflex::Collection is a generic object collection manager. It exposes remember() and forget(), which may be mapped to other methods using Moose's "handles" aspect.

Reflex::Collection goes beyond this simple hash-like interface. It will automatically forget() objects that emit "stopped" events, triggering their destruction if nothing else refers to them. This eliminates a large amount of repetitive work.

new

Create a new Reflex::Collection. It takes no parameters.

remember

Remember an object. Reflex::Collection works best if it contains the only references to the objects it manages, so you may often see objects remembered while they're constructed. See the SYNOPSIS for one such example.

remember() takes one parameter: the object to remember.

forget

Forget an object, returning its reference. You've supplied the reference, so the returned one is usually redundant. forget() takes one parameter: the object to forget.

SEE ALSO

Reflex

"ACKNOWLEDGEMENTS" in Reflex "ASSISTANCE" in Reflex "AUTHORS" in Reflex "BUGS" in Reflex "BUGS" in Reflex "CONTRIBUTORS" in Reflex "COPYRIGHT" in Reflex "LICENSE" in Reflex "TODO" in Reflex