UrlRequest

abstract class UrlRequest


Steuert eine HTTP-Anfrage (GET, PUT, POST usw.). Wird von UrlRequest.Builder erstellt, das durch Aufrufen von newUrlRequestBuilder abgerufen werden kann. Hinweis: Alle Methoden müssen für den Executor aufgerufen werden, der an newUrlRequestBuilder übergeben wurde.

Zusammenfassung

Verschachtelte Typen

abstract class UrlRequest.Builder

Builder für UrlRequests.

abstract class UrlRequest.Callback

Nutzer von Cronet erweitern diese Klasse, um Rückrufe zu erhalten, die den Fortschritt der Verarbeitung einer UrlRequest angeben.

Eine Annotation für APIs, die noch nicht als stabil gelten.

Anfragestatuswerte, die von getStatus zurückgegeben werden.

Listener-Klasse, die mit getStatus verwendet wird, um den Status einer UrlRequest zu erhalten.

Öffentliche Konstruktoren

Öffentliche Funktionen

abstract Unit

Bricht die Anfrage ab.

abstract Unit

Folgt einer ausstehenden Weiterleitung.

abstract Unit

Fragt den Status der Anfrage ab.

abstract Boolean

Gibt true zurück, wenn die Anfrage erfolgreich gestartet und jetzt abgeschlossen ist (abgeschlossen, abgebrochen oder fehlgeschlagen).

abstract Unit
read(buffer: ByteBuffer!)

Versucht, einen Teil des Antworttexts in den angegebenen Puffer zu lesen.

abstract Unit

Startet die Anfrage. Alle Rückrufe werden an Callback gesendet.

Öffentliche Konstruktoren

UrlRequest

UrlRequest()

Öffentliche Funktionen

Abbrechen

abstract fun cancel(): Unit

Bricht die Anfrage ab. Kann jederzeit aufgerufen werden. onCanceled() wird aufgerufen, wenn der Abbruch abgeschlossen ist. Es werden keine weiteren Rückrufmethoden aufgerufen. Wenn die Anfrage abgeschlossen ist oder noch nicht gestartet wurde, hat der Aufruf von cancel() keine Auswirkungen und onCanceled() wird nicht aufgerufen. Wenn der Executor während der UrlRequest Erstellung übergebene Aufgaben in einem einzelnen Thread ausführt und cancel() in diesem Thread aufgerufen wird, werden nach dem Aufruf von cancel() keine Rückrufmethoden (außer onCanceled()) aufgerufen. Andernfalls kann nach Abschluss von cancel() höchstens eine Callback-Methode aufgerufen werden.

followRedirect

abstract fun followRedirect(): Unit

Folgt einer ausstehenden Weiterleitung. Darf für jeden Aufruf von onRedirectReceived() höchstens einmal aufgerufen werden.

getStatus

abstract fun getStatus(listener: UrlRequest.StatusListener!): Unit

Fragt den Status der Anfrage ab.

Parameter
listener: UrlRequest.StatusListener!

Ein StatusListener, der mit dem aktuellen Status der Anfrage aufgerufen wird. listener wird für den Executor aufgerufen, der beim Erstellen der Anfrage übergeben wurde.

isDone

abstract fun isDone(): Boolean

Gibt true zurück, wenn die Anfrage erfolgreich gestartet und jetzt abgeschlossen ist (abgeschlossen, abgebrochen oder fehlgeschlagen).

Gibt Folgendes zurück:
Boolean

true, wenn die Anfrage erfolgreich gestartet und jetzt abgeschlossen ist (abgeschlossen, abgebrochen oder fehlgeschlagen).

read

abstract fun read(buffer: ByteBuffer!): Unit

Versucht, einen Teil des Antworttexts in den angegebenen Puffer zu lesen. Darf als Antwort auf jeden Aufruf der Methoden onResponseStarted() und onReadCompleted() des Callback höchstens einmal aufgerufen werden. Jeder Aufruf führt zu einem asynchronen Aufruf der Methode Callback'sonReadCompleted(), wenn Daten gelesen werden, der Methode onSucceeded(), wenn keine weiteren Daten gelesen werden können, oder der Methode onFailed(), wenn ein Fehler auftritt.

Parameter
buffer: ByteBuffer!

ByteBuffer, in den der Antworttext geschrieben werden soll. Muss ein direkter ByteBuffer sein. Der Einbettungscode darf die Position, das Limit oder die Daten des Puffers zwischen seiner Position und seinem Limit nicht lesen oder ändern, bis die Anfrage in den Callback zurückkehrt.

start

abstract fun start(): Unit

Startet die Anfrage. Alle Rückrufe werden an Callback gesendet. Darf nur einmal aufgerufen werden. Darf nicht aufgerufen werden, wenn cancel aufgerufen wurde.