Daniel P. Berrangé > Net-DBus-0.33.2 > Net::DBus::ASyncReply

Download:
Net-DBus-0.33.2.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  8
Open  0
View/Report Bugs
Source   Latest Release: Net-DBus-1.0.0

NAME ^

Net::DBus::ASyncReply - asynchronous method reply handler

SYNOPSIS ^

  use Net::DBus::Annotation qw(:call);

  my $object = $service->get_object("/org/example/systemMonitor");

  # List processes & get on with other work until
  # the list is returned.
  my $asyncreply = $object->list_processes(dbus_call_async, "someuser");

  while (!$asyncreply->is_ready) {
    ... do some background work..
  }

  my $processes = $asyncreply->get_result;

DESCRIPTION ^

This object provides a handler for receiving asynchronous method replies. An asynchronous reply object is generated when making remote method call with the dbus_call_async annotation set.

METHODS ^

$asyncreply->discard_result;

Indicates that the caller is no longer interested in recieving the reply & that it should be discarded. After calling this method, this object should not be used again.

$asyncreply->wait_for_result;

Blocks the caller waiting for completion of the of the asynchronous reply. Upon returning from this method, the result can be obtained with the get_result method.

my $boolean = $asyncreply->is_ready;

Returns a true value if the asynchronous reply is now complete (or a timeout has occurred). When this method returns true, the result can be obtained with the get_result method.

my @data = $asyncreply->get_result;

Retrieves the data associated with the asynchronous reply. If a timeout occurred, then this method will throw an exception. This method can only be called once the reply is complete, as indicated by the is_ready method returning a true value. After calling this method, this object should no longer be used.

AUTHOR ^

Daniel Berrange <dan@berrange.com>

COPYRIGHT ^

Copright (C) 2006, Daniel Berrange.

SEE ALSO ^

Net::DBus, Net::DBus::RemoteObject, Net::DBus::Annotation

syntax highlighting: