Digimer: Created page with '{{dbtut_header}} = discard_result = Usage: $asyncreply->discard_result; This tells the program that the caller is no longer interested in any furt…'

2009-10-12T02:37:45Z

Created page with '{{dbtut_header}} = discard_result = Usage: <source lang="perl">$asyncreply->discard_result;</source> This tells the program that the caller is no longer interested in any furt…'

Páàjì titun

{{dbtut_header}}

= discard_result =

Usage:
<source lang="perl">$asyncreply->discard_result;</source>

This tells the program that the caller is no longer interested in any further responses. Once this is called, the associated object should no longer be used.

= wait_for_result =

Usage:
<source lang="perl">$asyncreply->wait_for_result;</source>

This holds or pauses the caller until the remote method has returned results. Once this returns, you can collect the returned data using the 'get_result' method.

= is_ready =

Usage:
<source lang="perl">my $boolean = $asyncreply->is_ready;</source>
:MADI: Would a good example of this be something like "while (!$asyncreply->is_ready) { &display_progress_bar; } # Where 'display_progress_bar' is some yet-written method..." ?

This returns a boolean value of (TRUE/0??) when the remote method has returned data or timed out. Once true, you can collect the data or error using the 'get_result' method.

= set_notify =

Usage:
<source lang="perl">
my $coderef=\&some_method();
$asyncreply->set_notify($coderef);
</source>

This takes a reference to a method and executes it when the remote method has completed. The referenced method will be called with only a reference to this object.

:MADI: Confirm that I understand this right. If I do, ask Daniel if it would be reasonable/safe/possible to take an array of extra variables that could be passed to the referenced method. Ie:

Usage:
<source lang="perl">
sub set_notify {
my $self = shift;
my $cb = shift;
my @vars = @_;

$self->{pending_call}->set_notify(sub
{
my $pending_call = shift;

&$cb($self, @vars);
});
}
</source>

Call with:
<source lang="perl">$asyncreply->set_notify($coderef, $conf, $foo, $bar);</source>

= get_result =

Usage:
<source lang="perl">my @data = $asyncreply->get_result;</source>

This returns the data from the remote method call. If the remote method call timed out, this method will throw an exception. This should only be called after the 'is_ready' method returns a true value or the 'wait_for_result' method has returned. Once this method is called, this object should no longer be used.
:MADI: In the case of an exception, could/should a program run this in an 'eval'?

{{footer}}

Net::DBus::ASyncReply Methods - Revision history

Digimer: Created page with '{{dbtut_header}} = discard_result = Usage: $asyncreply->discard_result; This tells the program that the caller is no longer interested in any furt…'