UrlRequest.Builder

const val REQUEST_PRIORITY_HIGHEST = 4: Int

Najwyższy priorytet żądania. Przekazano do setPriority.

const val REQUEST_PRIORITY_IDLE = 0: Int

Najniższy priorytet żądania. Przekazano do setPriority.

const val REQUEST_PRIORITY_LOW = 2: Int

Niski priorytet żądania. Przekazano do setPriority.

const val REQUEST_PRIORITY_LOWEST = 1: Int

Bardzo niski priorytet żądania. Przekazano do setPriority.

const val REQUEST_PRIORITY_MEDIUM = 3: Int

Żądanie o średnim priorytecie. Przekazano do setPriority. Jest to domyślny priorytet przypisany do żądania.

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

Dodaje nagłówek żądania.

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

Powiązuje obiekt adnotacji z tym żądaniem. Możesz dodać więcej niż jeden. Przekazywane do RequestFinishedInfo.Listener, patrz getAnnotations.

abstract fun allowDirectExecutor(): UrlRequest.Builder!

Oznacza, że wykonawcy, których użyje to żądanie do powiadamiania wywołań zwrotnych (w przypadku UploadDataProvider i UrlRequest.Callback), celowo wykonują działanie w linii, np. directExecutor z biblioteki Guava lub java.util.concurrent.ThreadPoolExecutor.CallerRunsPolicy.

Ostrzeżenie: ta opcja ułatwia przypadkowe zablokowanie wątku sieciowego. Nie należy go używać, jeśli wywołania zwrotne wykonują operacje wejścia/wyjścia na dysku, uzyskują blokady lub wywołują inny kod, nad którym nie masz pełnej kontroli i którego nie możesz dokładnie sprawdzić.

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

Wiąże żądanie z określonym uchwytem sieci. Cronet wyśle tę prośbę tylko za pomocą sieci powiązanej z tym uchwytem. Jeśli ta sieć zostanie odłączona, żądanie nie zostanie zrealizowane. Dokładny błąd zależy od etapu przetwarzania żądania, na którym nastąpi odłączenie sieci. Uchwyty sieci można uzyskać za pomocą Network#getNetworkHandle. Dostępne tylko na urządzeniach z Androidem Marshmallow.

abstract fun build(): UrlRequest!

Tworzy UrlRequest za pomocą konfiguracji w tym Builder. Zwrócony UrlRequest można następnie uruchomić, wywołując start.

abstract fun disableCache(): UrlRequest.Builder!

Wyłącza pamięć podręczną dla żądania. Jeśli kontekst nie jest skonfigurowany do korzystania z pamięci podręcznej, to wywołanie nie ma żadnego efektu.

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

Ustawia czasownik metody HTTP, który ma być używany w tym żądaniu.

Jeśli ta metoda nie zostanie wywołana, domyślnie używana jest metoda „GET”, jeśli żądanie nie ma treści, lub „POST”, jeśli ma treść.

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

Ustawia priorytet żądania, który powinien być jedną z wartości REQUEST_PRIORITY_*. Jeśli ta metoda nie zostanie wywołana, żądanie otrzyma priorytet REQUEST_PRIORITY_MEDIUM.

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

Umożliwia Cronetowi używanie określonego słownika kompresji w przypadku tego żądania. Jeśli jest określony, Cronet może sygnalizować serwerowi dostępność danego słownika kompresji. Aby to ustawienie miało jakikolwiek wpływ, silnik CronetEngine, który wykona to żądanie, musi być skonfigurowany tak, aby włączał schemat kompresji obsługujący słowniki zewnętrzne. Ta funkcja częściowo implementuje w Cronet roboczą wersję dokumentu draft-ietf-httpbis-compression-dictionary. Cronet nie będzie bezpośrednio obsługiwać nagłówków odpowiedzi „Use-As-Dictionary”. Zamiast tego będzie polegać na aplikacji osadzającej, która będzie je obsługiwać, a następnie wywoływać metodę UrlRequest.Builder#setCompressionDictionary w przypadku żądań zgodnych z regułami „Use-As-Dictionary”. Może też pobierać słowniki kompresji za pomocą innego mechanizmu poza pasmem, a następnie wywoływać metodę UrlRequest.Builder#setCompressionDictionary. Cronet zinterpretuje słownik jako pasujący tylko do tego obiektu UrlRequest. Jeśli żądanie zostanie przekierowane, a osoba umieszczająca zdecyduje się na przekierowanie, słownik będzie pasować również do nowego adresu URL.

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

Ustawia odbiornik, który jest wywoływany po zwróceniu wartości onCanceled(), onFailed() lub onSucceeded().

Słuchacz jest wywoływany z informacjami o zakończeniu żądania na obiekcie java.util.concurrent.Executor dostarczonym przez getExecutor().

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

Ustawia tag android.net.TrafficStats, który będzie używany podczas rozliczania ruchu gniazda spowodowanego przez to żądanie. Przeczytaj android.net.TrafficStats, by dowiedzieć się więcej. Jeśli tag nie jest ustawiony (np. ta metoda nie jest wywoływana), Android uwzględnia ruch gniazda spowodowany przez to żądanie tak, jakby wartość tagu była ustawiona na 0.

UWAGA: ustawienie tagu uniemożliwia udostępnianie gniazd żądaniom z innymi tagami, co może negatywnie wpłynąć na wydajność, ponieważ uniemożliwia udostępnianie połączeń. Innymi słowy, używanie multipleksowanych gniazd (np. HTTP/2 i QUIC) będzie dozwolone tylko wtedy, gdy wszystkie żądania będą miały ten sam tag gniazda.

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

Ustawia konkretny identyfikator UID, który będzie używany podczas rozliczania ruchu gniazda spowodowanego przez to żądanie. Więcej informacji znajdziesz tutaj: android.net.TrafficStats. Przeznaczony do użycia podczas wykonywania operacji w imieniu innej aplikacji. Dzwoniący musi mieć uprawnienie MODIFY_NETWORK_ACCOUNTING. Domyślnie ruch jest przypisywany do identyfikatora UID osoby dzwoniącej.

UWAGA: ustawienie identyfikatora UID uniemożliwia udostępnianie gniazd żądaniom z innymi identyfikatorami UID, co może negatywnie wpłynąć na wydajność, ponieważ uniemożliwia udostępnianie połączeń. Innymi słowy, używanie multipleksowanych gniazd (np. HTTP/2 i QUIC) będzie dozwolone tylko wtedy, gdy wszystkie żądania mają ustawiony ten sam identyfikator UID.

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

Ustawia dostawcę danych przesyłanych przez użytkowników. Jeśli nie zostanie określona, metoda zostanie zmieniona na „POST”. Rozpoczęcie żądania spowoduje zgłoszenie wyjątku, jeśli nie ustawiono nagłówka Content-Type.