Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

UrlRequest.Callback

abstract class UrlRequest.Callback

Bekannte direkte Unterklassen

ImplicitFlowControlCallback

ImplicitFlowControlCallback

Eine Implementierung von UrlRequest.Callback, die die Schwierigkeit der Verwaltung des Anfragestatus entfernt und automatisch mit dem vollständigen Lesen der Antwort fortfährt.

Bekannte indirekte Unterklassen

ByteArrayCronetCallback, InMemoryTransformCronetCallback, JsonCronetCallback, StringCronetCallback

`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
`Callback()`

Öffentliche Funktionen
`Unit`	`onCanceled(request: UrlRequest!, info: UrlResponseInfo!)` Wird aufgerufen, wenn die Anfrage über `cancel` abgebrochen wurde.
`abstract Unit`	`onFailed( request: UrlRequest!, info: UrlResponseInfo!, error: CronetException! )` Wird aufgerufen, wenn die Anfrage nach `start` aus irgendeinem Grund fehlgeschlagen ist.
`abstract Unit`	`onReadCompleted( request: UrlRequest!, info: UrlResponseInfo!, byteBuffer: ByteBuffer! )` Wird aufgerufen, wenn ein Teil des Antworttextkörpers gelesen wurde.
`abstract Unit`	`onRedirectReceived( request: UrlRequest!, info: UrlResponseInfo!, newLocationUrl: String! )` Wird aufgerufen, wenn eine Weiterleitung auftritt.
`abstract Unit`	`onResponseStarted(request: UrlRequest!, info: UrlResponseInfo!)` Wird aufgerufen, wenn der endgültige Satz von Headern nach allen Weiterleitungen empfangen wurde.
`abstract Unit`	`onSucceeded(request: UrlRequest!, info: UrlResponseInfo!)` Wird aufgerufen, wenn die Anfrage erfolgreich abgeschlossen wurde.

Öffentliche Konstruktoren

Callback

Callback()

Öffentliche Funktionen

onCanceled

fun onCanceled(request: UrlRequest!, info: UrlResponseInfo!): Unit

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
`request: UrlRequest!`	Abgebrochene Anfrage.
`info: UrlResponseInfo!`	Antwortinformationen. Kann `null` sein, wenn keine Antwort empfangen wurde.

onFailed

abstract fun onFailed(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    error: CronetException!
): Unit

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
`request: UrlRequest!`	Fehlgeschlagene Anfrage.
`info: UrlResponseInfo!`	Antwortinformationen. Kann `null` sein, wenn keine Antwort empfangen wurde.
`error: CronetException!`	Informationen zum Fehler.

onReadCompleted

abstract fun onReadCompleted(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    byteBuffer: ByteBuffer!
): Unit

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 weiterzulesen.

Parameter
`request: UrlRequest!`	Anfrage, die Daten empfangen hat.
`info: UrlResponseInfo!`	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 eines Lesevorgangs ein Fehler auftritt. `onFailed` wird aufgerufen, wobei die ausgelöste Ausnahme als Ursache der `CallbackException` festgelegt wird.

onRedirectReceived

abstract fun onRedirectReceived(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    newLocationUrl: String!
): Unit

Wird aufgerufen, wenn eine Weiterleitung auftritt. Dies 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 der URLRequest aufgerufen wird, entweder synchron oder asynchron.

Parameter
`request: UrlRequest!`	Anfrage, die weitergeleitet wird.
`info: UrlResponseInfo!`	Antwortinformationen.
`newLocationUrl: String!`	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

abstract fun onResponseStarted(request: UrlRequest!, info: UrlResponseInfo!): Unit

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
`request: UrlRequest!`	Anfrage, die eine Antwort erhalten hat.
`info: UrlResponseInfo!`	Antwortinformationen.

Löst aus
`java.lang.Exception`	wenn beim Verarbeiten des Antwortstarts ein Fehler auftritt. `onFailed` wird aufgerufen, wobei die ausgelöste Ausnahme als Ursache der `CallbackException` festgelegt wird.

onSucceeded

abstract fun onSucceeded(request: UrlRequest!, info: UrlResponseInfo!): Unit

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

Parameter
`request: UrlRequest!`	Erfolgreiche Anfrage.
`info: UrlResponseInfo!`	Antwortinformationen.