GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  POE::REQUEST::EMIT (3)

.ds Aq ’

NAME

POE::Request::Emit - encapsulates non-terminal replies to POE::Request

CONTENTS

SYNOPSIS



        # Note, this is not a complete program.
        # See the distributions examples directory.

        sub do_something :Handler {
                my $req; # current request
                $req->emit(
                        type    => "pending",
                        args    => {
                                retry => $retry_number,
                        }
                );
        }



DESCRIPTION

POE::Request::Emit objects are used to send intermediate responses to stages that have requested something. It’s used internally by POE::Request’s emit() method.

Emitted replies do not cancel the requests they respond to. A stage may therefore emit() multiple messages for a single request, finally calling return() or cancel() to end the request.

    recall PAIRS

The stage receiving an emit()ted message may invoke recall() on that message. The recall() method sends another message back to the session that called emit(). Both emit() and recall() may be used multiple times to implement an ongoing, two-way dialogue between a requesting stage and the stage it’s called.

Once constructed, the recall message is automatically sent to the source of the POE::Request::Emit object.

recall() creates and automatically sends a POE::Request::Recall object to the session that sent the POE::Request::Emit object. The PAIRS are named parameters, which will be received as arguments to the receiving stage’s handler method.

See POE::Request::Recall for more discussion about recall messages.

BUGS

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

POE::Stage is too young for production use. For example, its syntax is still changing. You probably know what you don’t like, or what you need that isn’t included, so consider fixing or adding that, or at least discussing it with the people on POE’s mailing list or IRC channel. Your feedback and contributions will bring POE::Stage closer to usability. We appreciate it.

SEE ALSO

POE::Request, POE::Request::Upward, POE::Request::Recall, and probably POE::Stage.

AUTHORS

Rocco Caputo <rcaputo@cpan.org>.

LICENSE

POE::Request::Emit is Copyright 2005-2006 by Rocco Caputo. All rights are reserved. You may use, modify, and/or distribute this module under the same terms as Perl itself.
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 POE::REQUEST::EMIT (3) 2008-12-05

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.