UrlRequest.Callback

public static abstract class UrlRequest.Callback extends Object
Known Direct Subclasses
Known Indirect Subclasses

Users of Cronet extend this class to receive callbacks indicating the progress of a UrlRequest being processed. An instance of this class is passed in to UrlRequest.Builder's constructor when constructing the UrlRequest.

Note: All methods will be invoked on the thread of the Executor used during construction of the UrlRequest.

Public Constructor Summary

Public Method Summary

void
onCanceled(UrlRequest request, UrlResponseInfo info)
Invoked if request was canceled via UrlRequest.cancel().
abstract void
onFailed(UrlRequest request, UrlResponseInfo info, CronetException error)
Invoked if request failed for any reason after UrlRequest.start().
abstract void
onReadCompleted(UrlRequest request, UrlResponseInfo info, ByteBuffer byteBuffer)
Invoked whenever part of the response body has been read.
abstract void
onRedirectReceived(UrlRequest request, UrlResponseInfo info, String newLocationUrl)
Invoked whenever a redirect is encountered.
abstract void
onResponseStarted(UrlRequest request, UrlResponseInfo info)
Invoked when the final set of headers, after all redirects, is received.
abstract void
onSucceeded(UrlRequest request, UrlResponseInfo info)
Invoked when request is completed successfully.

Inherited Method Summary

Public Constructors

public Callback ()

Public Methods

public void onCanceled (UrlRequest request, UrlResponseInfo info)

Invoked if request was canceled via UrlRequest.cancel(). Once invoked, no other UrlRequest.Callback methods will be invoked. Default implementation takes no action.

Parameters
request Request that was canceled.
info Response information. May be null if no response was received.

public abstract void onFailed (UrlRequest request, UrlResponseInfo info, CronetException error)

Invoked if request failed for any reason after UrlRequest.start(). Once invoked, no other UrlRequest.Callback methods will be invoked. error provides information about the failure.

Parameters
request Request that failed.
info Response information. May be null if no response was received.
error information about error.

public abstract void onReadCompleted (UrlRequest request, UrlResponseInfo info, ByteBuffer byteBuffer)

Invoked whenever part of the response body has been read. Only part of the buffer may be populated, even if the entire response body has not yet been consumed. With the exception of onCanceled(), no other UrlRequest.Callback method will be invoked for the request, including onSucceeded() and onFailed(), until UrlRequest.read() is called to attempt to continue reading the response body.

Parameters
request Request that received data.
info Response information.
byteBuffer The buffer that was passed in to UrlRequest.read(), now containing the received data. The buffer's position is updated to the end of the received data. The buffer's limit is not changed.
Throws
Exception if an error occurs while processing a read completion. onFailed(UrlRequest, UrlResponseInfo, CronetException) will be called with the thrown exception set as the cause of the CallbackException.

public abstract void onRedirectReceived (UrlRequest request, UrlResponseInfo info, String newLocationUrl)

Invoked whenever a redirect is encountered. This will only be invoked between the call to UrlRequest.start() and onResponseStarted(). The body of the redirect response, if it has one, will be ignored. The redirect will not be followed until the URLRequest's UrlRequest.followRedirect() method is called, either synchronously or asynchronously.

Parameters
request Request being redirected.
info Response information.
newLocationUrl Location where request is redirected.
Throws
Exception if an error occurs while processing a redirect. onFailed(UrlRequest, UrlResponseInfo, CronetException) will be called with the thrown exception set as the cause of the CallbackException.

public abstract void onResponseStarted (UrlRequest request, UrlResponseInfo info)

Invoked when the final set of headers, after all redirects, is received. Will only be invoked once for each request. With the exception of onCanceled(), no other UrlRequest.Callback method will be invoked for the request, including onSucceeded() and onFailed(), until UrlRequest.read() is called to attempt to start reading the response body.

Parameters
request Request that started to get response.
info Response information.
Throws
Exception if an error occurs while processing response start. onFailed(UrlRequest, UrlResponseInfo, CronetException) will be called with the thrown exception set as the cause of the CallbackException.

public abstract void onSucceeded (UrlRequest request, UrlResponseInfo info)

Invoked when request is completed successfully. Once invoked, no other UrlRequest.Callback methods will be invoked.

Parameters
request Request that succeeded.
info Response information.