com.pcloud.networking.client

Interface MultiCallback

public interface MultiCallback

A contract for a callback to be fired when making a MultiCall

See Also:

MultiCall, Response, Request, MultiResponse

Method Summary

Modifier and Type	Method and Description
void	onComplete(MultiCall call, MultiResponse response) Fires once only after all the requests have been executed and only if no exceptions were thrown in the process.
void	onFailure(MultiCall call, java.io.IOException e, java.util.List<Response> completedResponses) Fires only once when one of the calls execution has thrown an IOException
void	onResponse(MultiCall call, int key, Response response) Fires each time a request is successful.

Method Detail

onFailure

void onFailure(MultiCall call,
               java.io.IOException e,
               java.util.List<Response> completedResponses)

Fires only once when one of the calls execution has thrown an IOException

Note that the rest of the calls scheduled for execution will not be executed and onComplete(MultiCall, MultiResponse) will not be called.

Parameters:

call - A reference to the MultiCall object.

e - The IOException that was thrown during execution.

completedResponses - A List of the Response objects that were constructed from successful call executions prior to the IOException

onResponse

void onResponse(MultiCall call,
                int key,
                Response response)
         throws java.io.IOException

Fires each time a request is successful.

Parameters:

call - A reference to the MultiCall object

key - The position in numerical order of the Response which corresponds to the position of the Request in numerical order

response - A reference to the Response obtained from the request

Throws:

java.io.IOException - On failed IO operations

onComplete

void onComplete(MultiCall call,
                MultiResponse response)
         throws java.io.IOException

Fires once only after all the requests have been executed and only if no exceptions were thrown in the process.

Note that onComplete(MultiCall, MultiResponse) will not fire if onFailure(MultiCall, IOException, List) does.

Parameters:

call - A reference to the MultiCall object

response - A reference to the MultiResponse object

Throws:

java.io.IOException - On failed IO operations