NAME

POE::Component::Supervisor::Supervised::Session - Helps POE::Component::Supervisor babysit POE sessions.

VERSION

version 0.09

SYNOPSIS

POE::Component::Supervisor::Supervised::Session->new(
    start_callback => sub {
        return POE::Session->new(

        );
    },
);

POE::Component::Supervisor::Supervised::Session->new(
    implicit_tracking => 1, # any sessions from _child create events
    start_callback => sub {
        POE::Component::Foo->spawn(
            ...
        );
    },
);

DESCRIPTION

This is a factory object that creates POE::Component::Supervisor::Handle::Session objects.

ATTRIBUTES

See also "ATTRIBUTES" in POE::Component::Supervisor::Handle::Session, all of the documented attributes that apply to handle creation are borrowed by this class.

handle_class

The class to instantiate.

Defaults to POE::Component::Supervisor::Handle::Session.

Note that attributes are inherited only from POE::Component::Supervisor::Handle::Session. If your handle class requires additional attributes, you must subclass your own Supervised variant.

The _inherit_attributes_from_handle_class method can then be invoked on your subclass to re-inherit all the attributes. Read the source of POE::Component::Supervisor::Supervised for more details.

METHODS

See also "METHODS" in POE::Component::Supervisor::Supervised.

spawn

Called by POE::Component::Supervisor when a new instance of the child process should be spawned.

is_abnormal_exit

Used by should_restart. See POE::Component::Supervisor::Supervised for details.

Returns true if the error argument is provided (it's added by the handle when a DIE signal is caught from one of the tracked sessions).