NAME

POE::Stage::App - a base class for POE::Stage applications

SYNOPSIS

        #!/usr/bin/env perl
        {
                package App;
                use POE::Stage::App qw(:base);
                sub on_run {
                        print "hello, ", my $arg_whom, "!\n";
                }
        }
        App->new->run( whom => "world" );
        exit;

DESCRIPTION

POE::Stage::App is a base class for a POE::Stage-based program's main code. It's used to bootstrap the initial stage from which messages can be sent, and it provides an abstract run() method that kicks off the program's main message dispatch loop.

PUBLIC METHODS

POE::Stage::App exists to provide a single method: run().

run ARGUMENT_PAIRS

run() instantiates the application, sends a message to its "on_run" method, and starts the framework's main dispatch loop. The ARGUMENT_PAIRS given to App->run(...) are passed as parameters to the application's on_run() method.

run() will not return until the application is finished. Most examples follow run() with "exit" as a reminder of this fact.

BUGS

See <http://thirdlobe.com/projects/poe-stage/report/1> for known issues. See <http://thirdlobe.com/projects/poe-stage/newticket> to report a problem.

AUTHORS

Rocco Caputo <rcaputo@cpan.org>.