Net::DBus::Binding::PendingCall(3pm)
NAME
Net::DBus::Binding::PendingCall - A handler for pending method replies
SYNOPSIS
my $call = Net::DBus::Binding::PendingCall->new(method_call => $call,
pending_call => $reply);
# Wait for completion
$call->block;
# And get the reply message
my $msg = $call->get_reply;
DESCRIPTION
This object is used when it is neccessary to make asynchronous method
calls. It provides the means to be notified when the reply is finally
received.
METHODS
- my $call = Net::DBus::Binding::PendingCall->new(method_call =>
$method_call, pending_call => $pending_call); - Creates a new pending call object, with the "method_call" parameter
being a reference to the "Net::DBus::Binding::Message::MethodCall"
object whose reply is being waiting for. The "pending_call"
parameter is a reference to the raw C pending call object. - $call->cancel
- Cancel the pending call, causing any reply that is later received
to be discarded. - my $boolean = $call->get_completed
- Returns a true value if the pending call has received its reply, or a timeout has occurred.
- $call->block
- Block the caller until the reply is recieved or a timeout occurrs.
- my $msg = $call->get_reply;
- Retrieves the "Net::DBus::Binding::Message" object associated with the complete call.
- $call->set_notify($coderef);
- Sets a notification function to be invoked when the pending call
completes. The callback will be passed a single argument which is
this pending call object.
SEE ALSO
Net::DBus::Binding::Connection, Net::DBus::Binding::Message,
Net::DBus::ASyncReply
AUTHOR
Daniel Berrange <dan@berrange.com>
COPYRIGHT
- Copyright 2006 by Daniel Berrange