UrlRequest.Callback

public abstract class UrlRequest.Callback

Bekannte direkte Unterklassen
ImplicitFlowControlCallback

Eine Implementierung von UrlRequest.Callback, die die Schwierigkeit der Verwaltung des Anfragestatus entfernt und automatisch die gesamte Antwort liest.

Bekannte indirekte Unterklassen
ByteArrayCronetCallback

Eine Spezialisierung von InMemoryTransformCronetCallback, die die Textkörper-Bytes unverändert ohne Interpretation zurückgibt.

InMemoryTransformCronetCallback

Ein abstrakter Cronet-Callback, der den gesamten Textkörper in den Arbeitsspeicher liest und den Textkörper optional deserialisiert, bevor er an den Aussteller der HTTP-Anfrage zurückgegeben wird.

JsonCronetCallback

Eine Spezialisierung von InMemoryTransformCronetCallback, die den Antworttextkörper als JSON interpretiert.

StringCronetCallback

Eine Spezialisierung von InMemoryTransformCronetCallback, die den Antworttextkörper als String interpretiert.


Cronet-Nutzer erweitern diese Klasse, um Callbacks zu erhalten, die den Fortschritt der Verarbeitung einer UrlRequest angeben. Eine Instanz dieser Klasse wird beim Erstellen der UrlRequest an den Konstruktor von UrlRequest.Builder übergeben.

Hinweis: Alle Methoden werden im Thread des java.util.concurrent.Executor aufgerufen, der beim Erstellen der UrlRequest verwendet wird.

Zusammenfassung

Öffentliche Konstruktoren

Öffentliche Methoden

void

Wird aufgerufen, wenn die Anfrage über cancel abgebrochen wurde.

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

Wird aufgerufen, wenn die Anfrage nach start aus irgendeinem Grund fehlgeschlagen ist.

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

Wird aufgerufen, wenn ein Teil des Antworttextkörpers gelesen wurde.

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

Wird aufgerufen, wenn eine Weiterleitung auftritt.

abstract void

Wird aufgerufen, wenn der endgültige Satz von Headern nach allen Weiterleitungen empfangen wurde.

abstract void

Wird aufgerufen, wenn die Anfrage erfolgreich abgeschlossen wurde.

Öffentliche Konstruktoren

Callback

public Callback()

Öffentliche Methoden

onCanceled

public void onCanceled(UrlRequest request, UrlResponseInfo info)

Wird aufgerufen, wenn die Anfrage über cancel abgebrochen wurde. Nach dem Aufruf werden keine anderen Callback-Methoden mehr aufgerufen. Die Standardimplementierung führt keine Aktion aus.

Parameter
UrlRequest request

Abgebrochene Anfrage.

UrlResponseInfo info

Antwortinformationen. Kann null sein, wenn keine Antwort empfangen wurde.

onFailed

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

Wird aufgerufen, wenn die Anfrage nach start aus irgendeinem Grund fehlgeschlagen ist. Nach dem Aufruf werden keine anderen Callback-Methoden mehr aufgerufen. error enthält Informationen zum Fehler.

Parameter
UrlRequest request

Fehlgeschlagene Anfrage.

UrlResponseInfo info

Antwortinformationen. Kann null sein, wenn keine Antwort empfangen wurde.

CronetException error

Informationen zum Fehler.

onReadCompleted

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

Wird aufgerufen, wenn ein Teil des Antworttextkörpers gelesen wurde. Nur ein Teil des Puffers ist möglicherweise gefüllt, auch wenn der gesamte Antworttextkörper noch nicht verarbeitet wurde. Mit Ausnahme von onCanceled() wird keine andere Callback-Methode für die Anfrage aufgerufen, einschließlich onSucceeded() und onFailed(), bis UrlRequest.read() aufgerufen wird, um zu versuchen, den Antworttextkörper weiter zu lesen.

Parameter
UrlRequest request

Anfrage, die Daten empfangen hat.

UrlResponseInfo info

Antwortinformationen.

ByteBuffer byteBuffer

Der Puffer, der an UrlRequest.read() übergeben wurde und jetzt die empfangenen Daten enthält. Die Position des Puffers wird auf das Ende der empfangenen Daten aktualisiert. Das Limit des Puffers wird nicht geändert.

Löst aus
java.lang.Exception

, wenn beim Verarbeiten des Abschlusses einer Leseoperation ein Fehler auftritt. onFailed wird aufgerufen, wobei die ausgelöste Ausnahme als Ursache der CallbackException festgelegt wird.

onRedirectReceived

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

Wird aufgerufen, wenn eine Weiterleitung auftritt. Diese Methode wird nur zwischen dem Aufruf von start und onResponseStarted() aufgerufen. Der Textkörper der Weiterleitungsantwort wird ignoriert, falls vorhanden. Die Weiterleitung wird erst ausgeführt, wenn die Methode followRedirect von URLRequest synchron oder asynchron aufgerufen wird.

Parameter
UrlRequest request

Anfrage, die weitergeleitet wird.

UrlResponseInfo info

Antwortinformationen.

String newLocationUrl

Ort, an den die Anfrage weitergeleitet wird.

Löst aus
java.lang.Exception

, wenn beim Verarbeiten einer Weiterleitung ein Fehler auftritt. onFailed wird aufgerufen, wobei die ausgelöste Ausnahme als Ursache der CallbackException festgelegt wird.

onResponseStarted

public abstract void onResponseStarted(UrlRequest request, UrlResponseInfo info)

Wird aufgerufen, wenn der endgültige Satz von Headern nach allen Weiterleitungen empfangen wurde. Wird nur einmal pro Anfrage aufgerufen. Mit Ausnahme von onCanceled() wird keine andere Callback-Methode für die Anfrage aufgerufen, einschließlich onSucceeded() und onFailed(), bis UrlRequest.read() aufgerufen wird, um zu versuchen, den Antworttextkörper zu lesen.

Parameter
UrlRequest request

Anfrage, die eine Antwort erhalten hat.

UrlResponseInfo info

Antwortinformationen.

Löst aus
java.lang.Exception

, wenn beim Verarbeiten des Beginns der Antwort ein Fehler auftritt. onFailed wird aufgerufen, wobei die ausgelöste Ausnahme als Ursache der CallbackException festgelegt wird.

onSucceeded

public abstract void onSucceeded(UrlRequest request, UrlResponseInfo info)

Wird aufgerufen, wenn die Anfrage erfolgreich abgeschlossen wurde. Nach dem Aufruf werden keine anderen Callback-Methoden mehr aufgerufen.

Parameter
UrlRequest request

Erfolgreiche Anfrage.

UrlResponseInfo info

Antwortinformationen.