ImplicitFlowControlCallback

public abstract class ImplicitFlowControlCallback extends UrlRequest.Callback

Sottoclassi dirette note
InMemoryTransformCronetCallback

Un callback Cronet astratto che legge l'intero corpo in memoria e, se vuoi, lo deserializza prima di passarlo di nuovo al mittente della richiesta HTTP.

Sottoclassi indirette note
ByteArrayCronetCallback

Una specializzazione di InMemoryTransformCronetCallback che restituisce i byte del corpo letteralmente senza alcuna interpretazione.

JsonCronetCallback

Una specializzazione di InMemoryTransformCronetCallback che interpreta il corpo della risposta come JSON.

StringCronetCallback

Una specializzazione di InMemoryTransformCronetCallback che interpreta il corpo della risposta come una stringa.


Un'implementazione di UrlRequest.Callback che elimina la difficoltà di gestire il ciclo di vita delle richieste e procede automaticamente alla lettura completa della risposta.

Riepilogo

Costruttori pubblici

Metodi pubblici

final void

Richiamato se la richiesta è stata annullata tramite cancel.

final void
onFailed(
    UrlRequest request,
    UrlResponseInfo info,
    CronetException error
)

Richiamato se la richiesta non è riuscita per qualsiasi motivo dopo start.

final void
onReadCompleted(
    UrlRequest request,
    UrlResponseInfo info,
    ByteBuffer byteBuffer
)

Richiamato ogni volta che viene letta una parte del corpo della risposta.

final void
onRedirectReceived(
    UrlRequest request,
    UrlResponseInfo info,
    String newLocationUrl
)

Viene richiamato ogni volta che viene rilevato un reindirizzamento.

final void

Richiamato quando viene ricevuto il set finale di intestazioni, dopo tutti i reindirizzamenti.

final void

Richiamato quando la richiesta viene completata correttamente.

Metodi protetti

abstract void

Richiamato ogni volta che viene letta una parte del corpo della risposta.

abstract void

Richiamato se la richiesta è stata annullata tramite cancel.

abstract void

Richiamato se la richiesta non è riuscita per qualsiasi motivo dopo start.

abstract void

Richiamato quando viene ricevuto il set finale di intestazioni, dopo tutti i reindirizzamenti.

abstract void

Richiamato quando la richiesta viene completata correttamente.

abstract boolean

Viene richiamato ogni volta che viene rilevato un reindirizzamento.

Costruttori pubblici

ImplicitFlowControlCallback

public ImplicitFlowControlCallback()

Metodi pubblici

onCanceled

public final void onCanceled(UrlRequest request, UrlResponseInfo info)

Richiamato se la richiesta è stata annullata tramite cancel. Una volta richiamato, non verranno richiamati altri metodi Callback. L'implementazione predefinita non esegue alcuna azione.

Parametri
UrlRequest request

Richiesta annullata.

UrlResponseInfo info

Informazioni sulla risposta. Potrebbe essere null se non è stata ricevuta alcuna risposta.

onFailed

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

Richiamato se la richiesta non è riuscita per qualsiasi motivo dopo start. Una volta richiamato, non verranno richiamati altri metodi Callback. error fornisce informazioni sull'errore.

Parametri
UrlRequest request

Richiesta non riuscita.

UrlResponseInfo info

Informazioni sulla risposta. Potrebbe essere null se non è stata ricevuta alcuna risposta.

CronetException error

informazioni sull'errore.

onReadCompleted

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

Richiamato ogni volta che viene letta una parte del corpo della risposta. Potrebbe essere compilata solo una parte del buffer, anche se l'intero corpo della risposta non è ancora stato utilizzato. Ad eccezione di onCanceled(), nessun altro metodo Callback verrà richiamato per la richiesta, inclusi onSucceeded() e onFailed(), finché non viene chiamato UrlRequest.read() per tentare di continuare a leggere il corpo della risposta.

Parametri
UrlRequest request

Richiesta che ha ricevuto i dati.

UrlResponseInfo info

Informazioni sulla risposta.

ByteBuffer byteBuffer

Il buffer passato a UrlRequest.read(), ora contenente i dati ricevuti. La posizione del buffer viene aggiornata alla fine dei dati ricevuti. Il limite del buffer non viene modificato.

Genera
java.lang.Exception

se si verifica un errore durante l'elaborazione del completamento della lettura. Verrà chiamato onFailed con l'eccezione generata impostata come causa di CallbackException.

onRedirectReceived

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

Viene richiamato ogni volta che viene rilevato un reindirizzamento. Verrà richiamato solo tra la chiamata a start e onResponseStarted(). Il corpo della risposta di reindirizzamento, se presente, verrà ignorato. Il reindirizzamento non verrà seguito finché non viene chiamato il metodo followRedirect di URLRequest, in modo sincrono o asincrono.

Parametri
UrlRequest request

Richiesta di reindirizzamento.

UrlResponseInfo info

Informazioni sulla risposta.

String newLocationUrl

Posizione in cui viene reindirizzata la richiesta.

Genera
java.lang.Exception

se si verifica un errore durante l'elaborazione di un reindirizzamento. Verrà chiamato onFailed con l'eccezione generata impostata come causa di CallbackException.

onResponseStarted

public final void onResponseStarted(UrlRequest request, UrlResponseInfo info)

Richiamato quando viene ricevuto il set finale di intestazioni, dopo tutti i reindirizzamenti. Verrà richiamato una sola volta per ogni richiesta. Ad eccezione di onCanceled(), nessun altro metodo Callback verrà richiamato per la richiesta, inclusi onSucceeded() e onFailed(), finché non viene chiamato UrlRequest.read() per tentare di iniziare a leggere il corpo della risposta.

Parametri
UrlRequest request

Richiesta per la quale è iniziata la risposta.

UrlResponseInfo info

Informazioni sulla risposta.

Genera
java.lang.Exception

se si verifica un errore durante l'elaborazione dell'inizio della risposta. Verrà chiamato onFailed con l'eccezione generata impostata come causa di CallbackException.

onSucceeded

public final void onSucceeded(UrlRequest request, UrlResponseInfo info)

Richiamato quando la richiesta viene completata correttamente. Una volta richiamato, non verranno richiamati altri metodi Callback.

Parametri
UrlRequest request

Richiesta riuscita.

UrlResponseInfo info

Informazioni sulla risposta.

Metodi protetti

onBodyChunkRead

protected abstract void onBodyChunkRead(UrlResponseInfo info, ByteBuffer bodyChunk)

Richiamato ogni volta che viene letta una parte del corpo della risposta. Potrebbe essere compilata solo una parte del buffer, anche se l'intero corpo della risposta non è ancora stato utilizzato. Il buffer è pronto per la lettura. I buffer vengono riutilizzati internamente, pertanto la classe di implementazione non deve archiviarli o utilizzarli in un altro punto dell'implementazione di questo metodo.

Parametri
UrlResponseInfo info

Informazioni sulla risposta.

ByteBuffer bodyChunk

Il buffer che contiene i dati ricevuti, invertiti per la lettura.

Genera
java.lang.Exception

se si verifica un errore durante l'elaborazione del completamento di una lettura. onFailed verrà chiamato con l'eccezione generata impostata come causa di CallbackException.

onCanceled

protected abstract void onCanceled(@Nullable UrlResponseInfo info)

Richiamato se la richiesta è stata annullata tramite cancel. Una volta richiamato, non verranno richiamati altri metodi UrlRequest.Callback.

Parametri
@Nullable UrlResponseInfo info

Informazioni sulla risposta. Potrebbe essere null se non è stata ricevuta alcuna risposta.

onFailed

protected abstract void onFailed(@Nullable UrlResponseInfo info, CronetException exception)

Richiamato se la richiesta non è riuscita per qualsiasi motivo dopo start. Una volta richiamato, non verranno richiamati altri metodi UrlRequest.Callback. error fornisce informazioni sull'errore.

Parametri
@Nullable UrlResponseInfo info

Informazioni sulla risposta. Potrebbe essere null se non è stata ricevuta alcuna risposta.

CronetException exception

informazioni sull'errore.

onResponseStarted

protected abstract void onResponseStarted(UrlResponseInfo info)

Richiamato quando viene ricevuto il set finale di intestazioni, dopo tutti i reindirizzamenti. Verrà richiamato una sola volta per ogni richiesta. È garantito che Cronet non inizi a leggere il corpo finché questo metodo non restituisce un valore.

Parametri
UrlResponseInfo info

Informazioni sulla risposta.

Genera
java.lang.Exception

Se si verifica un errore durante l'elaborazione dell'inizio della risposta, viene chiamato onFailed con l'eccezione generata impostata come causa di CallbackException.

onSucceeded

protected abstract void onSucceeded(UrlResponseInfo info)

Richiamato quando la richiesta viene completata correttamente. Una volta richiamato, non verranno richiamati altri metodi UrlRequest.Callback.

Parametri
UrlResponseInfo info

Informazioni sulla risposta.

shouldFollowRedirect

protected abstract boolean shouldFollowRedirect(UrlResponseInfo info, String newLocationUrl)

Viene richiamato ogni volta che viene rilevato un reindirizzamento. Verrà richiamato solo tra la chiamata a start e onResponseStarted(). Il corpo della risposta di reindirizzamento, se presente, verrà ignorato.

Parametri
UrlResponseInfo info

Informazioni sulla risposta.

String newLocationUrl

Posizione in cui viene reindirizzata la richiesta.

Resi
boolean

true se il reindirizzamento deve essere seguito, false se la richiesta deve essere annullata.

Genera
java.lang.Exception

se si verifica un errore durante l'elaborazione di un reindirizzamento. onFailed verrà chiamato con l'eccezione generata impostata come causa di CallbackException.