UrlRequest.Builder

public static final int REQUEST_PRIORITY_HIGHEST = 4

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

public static final int REQUEST_PRIORITY_IDLE = 0

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

public static final int REQUEST_PRIORITY_LOW = 2

Niski priorytet żądania. Przekazano do setPriority.

public static final int REQUEST_PRIORITY_LOWEST = 1

Bardzo niski priorytet żądania. Przekazano do setPriority.

public static final int REQUEST_PRIORITY_MEDIUM = 3

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

public abstract UrlRequest.Builder addHeader(String header, String value)

Dodaje nagłówek żądania.

public UrlRequest.Builder addRequestAnnotation(Object annotation)

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

public abstract UrlRequest.Builder allowDirectExecutor()

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ć.

public UrlRequest.Builder bindToNetwork(long networkHandle)

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.

public abstract UrlRequest build()

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

public abstract UrlRequest.Builder disableCache()

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.

public abstract UrlRequest.Builder setHttpMethod(String method)

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ść.

public abstract UrlRequest.Builder setPriority(int priority)

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
public UrlRequest.Builder setRawCompressionDictionary(
    byte[] dictionarySha256Hash,
    ByteBuffer dictionary,
    String dictionaryId
)

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.

public UrlRequest.Builder setRequestFinishedListener(RequestFinishedInfo.Listener listener)

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().

public UrlRequest.Builder setTrafficStatsTag(int tag)

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.

public UrlRequest.Builder setTrafficStatsUid(int uid)

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.

public abstract UrlRequest.Builder setUploadDataProvider(
    UploadDataProvider uploadDataProvider,
    Executor executor
)

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.