ImplicitFlowControlCallback

public abstract class ImplicitFlowControlCallback extends UrlRequest.Callback

Bekannte direkte Unterklassen
InMemoryTransformCronetCallback

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

Bekannte indirekte Unterklassen
ByteArrayCronetCallback

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

JsonCronetCallback

Eine Spezialisierung von InMemoryTransformCronetCallback, die den Antworttext als JSON interpretiert.

StringCronetCallback

Eine Spezialisierung von InMemoryTransformCronetCallback, die den Antworttext als String interpretiert.


Eine Implementierung von UrlRequest.Callback, die die Verwaltung des Anfragelebenszyklus vereinfacht und die Antwort automatisch vollständig liest.

Zusammenfassung

Öffentliche Konstruktoren

Öffentliche Methoden

final void

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

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

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

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

Wird aufgerufen, wenn ein Teil des Antworttexts gelesen wurde.

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

Wird immer aufgerufen, wenn eine Weiterleitung erfolgt.

final void

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

final void

Wird aufgerufen, wenn die Anfrage erfolgreich abgeschlossen wurde.

Geschützte Methoden

abstract void

Wird aufgerufen, wenn ein Teil des Antworttexts gelesen wurde.

abstract void

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

abstract void

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

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.

abstract boolean

Wird immer aufgerufen, wenn eine Weiterleitung erfolgt.

Öffentliche Konstruktoren

ImplicitFlowControlCallback

public ImplicitFlowControlCallback()

Öffentliche Methoden

onCanceled

public final void onCanceled(UrlRequest request, UrlResponseInfo info)

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

Parameter
UrlRequest request

Anfrage, die abgebrochen wurde.

UrlResponseInfo info

Antwortinformationen. Kann null sein, wenn keine Antwort eingegangen ist.

onFailed

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

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

Parameter
UrlRequest request

Die fehlgeschlagene Anfrage.

UrlResponseInfo info

Antwortinformationen. Kann null sein, wenn keine Antwort eingegangen ist.

CronetException error

Informationen zum Fehler.

onReadCompleted

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

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

Parameter
UrlRequest request

Anfrage, mit der Daten empfangen wurden.

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 einer Leseabschließung ein Fehler auftritt. onFailed wird mit der ausgelösten Ausnahme als Ursache der CallbackException aufgerufen.

onRedirectReceived

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

Wird immer aufgerufen, wenn eine Weiterleitung erfolgt. Diese Methode wird nur zwischen dem Aufruf von start und onResponseStarted() aufgerufen. Der Text der Weiterleitungsantwort wird ignoriert, sofern vorhanden. Der Weiterleitung wird erst gefolgt, wenn die followRedirect-Methode von URLRequest synchron oder asynchron aufgerufen wird.

Parameter
UrlRequest request

Anfrage wird weitergeleitet.

UrlResponseInfo info

Antwortinformationen.

String newLocationUrl

Standort, an den die Anfrage weitergeleitet wird.

Löst aus
java.lang.Exception

wenn bei der Verarbeitung einer Weiterleitung ein Fehler auftritt. onFailed wird mit der ausgelösten Ausnahme als Ursache der CallbackException aufgerufen.

onResponseStarted

public final 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 für die Anfrage keine andere Callback-Methode aufgerufen, einschließlich onSucceeded() und onFailed(), bis UrlRequest.read() aufgerufen wird, um zu versuchen, den Antworttext zu lesen.

Parameter
UrlRequest request

Anfrage, auf die eine Antwort eingegangen ist.

UrlResponseInfo info

Antwortinformationen.

Löst aus
java.lang.Exception

wenn bei der Verarbeitung des Antwortstarts ein Fehler auftritt. onFailed wird mit der ausgelösten Ausnahme als Ursache der CallbackException aufgerufen.

onSucceeded

public final void onSucceeded(UrlRequest request, UrlResponseInfo info)

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

Parameter
UrlRequest request

Anfrage erfolgreich.

UrlResponseInfo info

Antwortinformationen.

Geschützte Methoden

onBodyChunkRead

protected abstract void onBodyChunkRead(UrlResponseInfo info, ByteBuffer bodyChunk)

Wird aufgerufen, wenn ein Teil des Antworttexts gelesen wurde. Möglicherweise ist nur ein Teil des Puffers gefüllt, auch wenn der gesamte Antworttext noch nicht verarbeitet wurde. Der Puffer kann gelesen werden. Puffer werden intern wiederverwendet. Die implementierende Klasse sollte den Puffer daher nicht speichern oder an anderer Stelle als in der Implementierung dieser Methode verwenden.

Parameter
UrlResponseInfo info

Antwortinformationen.

ByteBuffer bodyChunk

Der Puffer, der die empfangenen Daten enthält, wurde zum Lesen umgedreht.

Löst aus
java.lang.Exception

Wenn bei der Verarbeitung eines Lesevorgangs ein Fehler auftritt, wird „onFailed“ aufgerufen. Die ausgelöste Ausnahme wird als Ursache von CallbackException festgelegt.

onCanceled

protected abstract void onCanceled(@Nullable UrlResponseInfo info)

Wird aufgerufen, wenn die Anfrage über cancel abgebrochen wurde. Nach dem Aufrufen werden keine anderen UrlRequest.Callback-Methoden mehr aufgerufen.

Parameter
@Nullable UrlResponseInfo info

Antwortinformationen. Kann null sein, wenn keine Antwort eingegangen ist.

onFailed

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

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

Parameter
@Nullable UrlResponseInfo info

Antwortinformationen. Kann null sein, wenn keine Antwort eingegangen ist.

CronetException exception

Informationen zum Fehler.

onResponseStarted

protected abstract void onResponseStarted(UrlResponseInfo info)

Wird aufgerufen, wenn der endgültige Satz von Headern nach allen Weiterleitungen empfangen wurde. Wird nur einmal pro Anfrage aufgerufen. Es wird garantiert, dass Cronet den Textkörper erst liest, wenn diese Methode zurückgegeben wird.

Parameter
UrlResponseInfo info

Antwortinformationen.

Löst aus
java.lang.Exception

Wenn beim Verarbeiten des Antwortstarts ein Fehler auftritt, wird „onFailed“ aufgerufen. Die ausgelöste Ausnahme wird als Ursache von CallbackException festgelegt.

onSucceeded

protected abstract void onSucceeded(UrlResponseInfo info)

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

Parameter
UrlResponseInfo info

Antwortinformationen.

shouldFollowRedirect

protected abstract boolean shouldFollowRedirect(UrlResponseInfo info, String newLocationUrl)

Wird immer aufgerufen, wenn eine Weiterleitung erfolgt. Diese Methode wird nur zwischen dem Aufruf von start und onResponseStarted() aufgerufen. Der Text der Weiterleitungsantwort wird ignoriert, sofern vorhanden.

Parameter
UrlResponseInfo info

Antwortinformationen.

String newLocationUrl

Standort, an den die Anfrage weitergeleitet wird.

Gibt Folgendes zurück:
boolean

„true“, wenn der Weiterleitung gefolgt werden soll, „false“, wenn die Anfrage abgebrochen werden soll.

Löst aus
java.lang.Exception

wenn bei der Verarbeitung einer Weiterleitung ein Fehler auftritt. „onFailed“ wird aufgerufen, wobei die ausgelöste Ausnahme als Ursache von CallbackException festgelegt wird.