UrlRequest.Builder

const val REQUEST_PRIORITY_HIGHEST = 4: Int

Höchste Priorität für Anfragen. An setPriority weitergeleitet.

const val REQUEST_PRIORITY_IDLE = 0: Int

Niedrigste Anfragepriorität. An setPriority weitergeleitet.

const val REQUEST_PRIORITY_LOW = 2: Int

Niedrige Anfragepriorität An setPriority weitergeleitet.

const val REQUEST_PRIORITY_LOWEST = 1: Int

Die Priorität der Anfrage ist sehr niedrig. An setPriority weitergeleitet.

const val REQUEST_PRIORITY_MEDIUM = 3: Int

Mittlere Anfragepriorität. An setPriority weitergeleitet. Dies ist die Standardpriorität, die der Anfrage zugewiesen wird.

abstract fun addHeader(header: String!, value: String!): UrlRequest.Builder!

Fügt einen Anfrageheader hinzu.

fun addRequestAnnotation(annotation: Any!): UrlRequest.Builder!

Verknüpft das Annotations-Objekt mit dieser Anfrage. Sie können mehrere hinzufügen. An ein RequestFinishedInfo.Listener übergeben, siehe getAnnotations.

abstract fun allowDirectExecutor(): UrlRequest.Builder!

Markiert, dass die Executors, die in dieser Anfrage verwendet werden, um Callbacks zu benachrichtigen (für UploadDataProviders und UrlRequest.Callbacks), absichtlich Inline-Ausführung durchführen, z. B. directExecutor von Guava oder java.util.concurrent.ThreadPoolExecutor.CallerRunsPolicy.

Warnung:Mit dieser Option kann der Netzwerk-Thread leicht versehentlich blockiert werden. Sie sollten nicht verwendet werden, wenn in Ihren Callbacks Festplatten-I/O-Vorgänge ausgeführt, Sperren angefordert oder anderer Code aufgerufen wird, den Sie nicht sorgfältig kontrollieren und prüfen.

fun bindToNetwork(networkHandle: Long): UrlRequest.Builder!

Bindet die Anfrage an das angegebene Netzwerk-Handle. Cronet sendet diese Anfrage nur über das Netzwerk, das mit diesem Handle verknüpft ist. Wenn die Verbindung zum Netzwerk unterbrochen wird, schlägt die Anfrage fehl. Der genaue Fehler hängt davon ab, in welcher Phase der Verarbeitung der Anfrage die Verbindung zum Netzwerk unterbrochen wird. Netzwerk-Handles können über Network#getNetworkHandle abgerufen werden. Nur ab Android Marshmallow verfügbar.

abstract fun build(): UrlRequest!

Erstellt einen UrlRequest mit der Konfiguration in diesem Builder. Die zurückgegebene UrlRequest kann dann durch Aufrufen von start gestartet werden.

abstract fun disableCache(): UrlRequest.Builder!

Deaktiviert den Cache für die Anfrage. Wenn der Kontext nicht für die Verwendung des Cache eingerichtet ist, hat dieser Aufruf keine Auswirkungen.

abstract fun setHttpMethod(method: String!): UrlRequest.Builder!

Legt das HTTP-Methodenverb fest, das für diese Anfrage verwendet werden soll.

Wenn diese Methode nicht aufgerufen wird, ist der Standardwert „GET“, wenn die Anfrage keinen Textkörper hat, und „POST“, wenn sie einen hat.

abstract fun setPriority(priority: Int): UrlRequest.Builder!

Legt die Priorität der Anfrage fest. Sie muss einer der REQUEST_PRIORITY_*-Werte sein. Der Anfrage wird die Priorität REQUEST_PRIORITY_MEDIUM zugewiesen, wenn diese Methode nicht aufgerufen wird.

@UrlRequest.Experimental
fun setRawCompressionDictionary(
    dictionarySha256Hash: ByteArray!,
    dictionary: ByteBuffer!,
    dictionaryId: String!
): UrlRequest.Builder!

Ermöglicht Cronet, das angegebene Komprimierungswörterbuch für diese Anfrage zu verwenden. Wenn diese Option angegeben ist, kann Cronet dem Server die Verfügbarkeit des angegebenen Komprimierungs-Dictionarys signalisieren. Damit dies wirksam wird, muss die CronetEngine, die diese Anfrage ausführt, so konfiguriert sein, dass ein Komprimierungsschema aktiviert ist, das externe Wörterbücher unterstützt. Damit wird der Entwurf „draft-ietf-httpbis-compression-dictionary“ teilweise in Cronet implementiert. Cronet verarbeitet keine „Use-As-Dictionary“-Antwortheader direkt, sondern verlässt sich stattdessen darauf, dass der Embedder sie verarbeitet und später UrlRequest.Builder#setCompressionDictionary für Anfragen aufruft, die den Regeln von „Use-As-Dictionary“ entsprechen, oder Komprimierungs-Dictionaries über einen anderen Out-of-Band-Mechanismus abruft und später UrlRequest.Builder#setCompressionDictionary aufruft. Cronet interpretiert das Dictionary so, dass es nur mit dieser UrlRequest übereinstimmt. Wenn die Anfrage weitergeleitet wird und der Einbettungscode der Weiterleitung folgt, stimmt das Dictionary auch mit der neuen URL überein.

fun setRequestFinishedListener(listener: RequestFinishedInfo.Listener!): UrlRequest.Builder!

Legt einen Listener fest, der nach der Rückgabe von onCanceled(), onFailed() oder onSucceeded() aufgerufen wird.

Der Listener wird mit den Informationen zum Abschluss der Anfrage für ein java.util.concurrent.Executor aufgerufen, das von getExecutor() bereitgestellt wird.

fun setTrafficStatsTag(tag: Int): UrlRequest.Builder!

Legt das android.net.TrafficStats-Tag fest, das verwendet werden soll, wenn der durch diese Anfrage verursachte Socket-Traffic berücksichtigt wird. Weitere Informationen findest du in den android.net.TrafficStats. Wenn kein Tag festgelegt ist (z.B. wenn diese Methode nicht aufgerufen wird), berücksichtigt Android den durch diese Anfrage verursachten Socket-Traffic so, als wäre der Tag-Wert auf 0 gesetzt.

HINWEIS:Wenn Sie ein Tag festlegen, können Sockets nicht für Anfragen mit anderen Tags freigegeben werden. Dies kann sich negativ auf die Leistung auswirken, da keine Verbindungen gemeinsam genutzt werden können. Mit anderen Worten: Die Verwendung von Multiplex-Sockets (z.B. HTTP/2 und QUIC) ist nur zulässig, wenn alle Anfragen dasselbe Socket-Tag haben.

fun setTrafficStatsUid(uid: Int): UrlRequest.Builder!

Legt eine bestimmte UID fest, die bei der Abrechnung des Socket-Traffics verwendet werden soll, der durch diese Anfrage verursacht wird. Weitere Informationen finden Sie unter android.net.TrafficStats. Für die Verwendung bei der Ausführung eines Vorgangs im Namen einer anderen Anwendung vorgesehen. Der Aufrufer muss die Berechtigung MODIFY_NETWORK_ACCOUNTING haben. Standardmäßig wird Traffic der UID des Anrufers zugeordnet.

HINWEIS:Wenn Sie eine UID festlegen, können Sockets nicht für Anfragen mit anderen UIDs freigegeben werden. Dies kann sich negativ auf die Leistung auswirken, da keine Verbindungsfreigabe möglich ist. Mit anderen Worten: Die Verwendung von Multiplex-Sockets (z.B. HTTP/2 und QUIC) ist nur zulässig, wenn für alle Anfragen dieselbe UID festgelegt ist.

abstract fun setUploadDataProvider(
    uploadDataProvider: UploadDataProvider!,
    executor: Executor!
): UrlRequest.Builder!

Legt den Datenanbieter für den Upload fest. Die Methode wird auf „POST“ umgestellt, wenn sie nicht explizit festgelegt ist. Wenn kein Content-Type-Header festgelegt ist, wird beim Starten der Anfrage eine Ausnahme ausgelöst.