UrlRequest

public 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
public abstract class UrlRequest.Builder

Builder für UrlRequests.
public 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.
public class UrlRequest.Status

Von getStatus zurückgegebene Statuswerte für Anfragen.
public abstract class UrlRequest.StatusListener

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

Public Constructors

Public Methods
abstract void

Bricht die Anfrage ab.
abstract void

Folgt einer ausstehenden Weiterleitung.
abstract void

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 void
read(ByteBuffer buffer)

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

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

Public Constructors

UrlRequest

public UrlRequest()

Public Methods

Abbrechen

public abstract void cancel()

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

public abstract void followRedirect()

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

getStatus

public abstract void getStatus(UrlRequest.StatusListener listener)

Fragt den Status der Anfrage ab.

Parameter
UrlRequest.StatusListener listener

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

public abstract boolean isDone()

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

public abstract void read(ByteBuffer buffer)

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
ByteBuffer buffer

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 einen Rückruf an den Callback sendet.

start

public abstract void start()

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