NAME

POE::Component::Supervisor::Handle - Base role for supervision handles

SYNOPSIS

# see Handle::Proc and Handle::Session

DESCRIPTION

This is a base role for supervision handles.

ATTRIBUTES

supervisor

The POE::Component::Supervisor utilizing over this handle.

child

The child descriptor this handle was spawned for.

spawned_callback
stopped_callback

These callbacks are called as handle methods with the arguments sent to the supervisor.

Note that they are not invoked with POE's calling convention, but rather arbitrary arguments from the supervision handle.

METHODS

stop

Stops the running supervised thingy.

Required.

is_running

Checks if the supervised thingy is running.

Required.

stop_for_restart

By default an alias to stop.

If stopping for the purpose of a restart should be handled differently this can be overridden.