BidirectionalStream.Builder

public abstract class BidirectionalStream.Builder

Kreator dla BidirectionalStream. Umożliwia skonfigurowanie strumienia przed jego utworzeniem za pomocą funkcji build. Utworzone przez newBidirectionalStreamBuilder.

Podsumowanie

Stałe
static final int

Najwyższy priorytet transmisji.
static final int

Najniższy priorytet strumienia.
static final int

Niski priorytet strumienia.
static final int

Bardzo niski priorytet strumienia.
static final int

Średni priorytet strumienia.

Konstruktory publiczne

Metody publiczne
abstract BidirectionalStream.Builder
addHeader(String header, String value)

Dodaje nagłówek żądania.
BidirectionalStream.Builder

Powiązuje obiekt adnotacji z tym żądaniem.
BidirectionalStream.Builder
bindToNetwork(long networkHandle)

Wiąże żądanie z określonym uchwytem sieci.
abstract BidirectionalStream

Tworzy BidirectionalStream na podstawie konfiguracji z tego Builder.
abstract BidirectionalStream.Builder
delayRequestHeadersUntilFirstFlush(
    boolean delayRequestHeadersUntilFirstFlush
)

Opóźnia wysyłanie nagłówków żądań do momentu wywołania funkcji flush.
abstract BidirectionalStream.Builder

Ustawia metodę HTTP dla żądania.
abstract BidirectionalStream.Builder
setPriority(int priority)

Ustawia priorytet strumienia, który powinien być jedną z wartości STREAM_PRIORITY_*.
BidirectionalStream.Builder

Ustawia tag android.net.TrafficStats, który będzie używany podczas rozliczania ruchu gniazda spowodowanego przez to żądanie.
BidirectionalStream.Builder

Ustawia konkretny identyfikator UID, który będzie używany podczas rozliczania ruchu gniazda spowodowanego przez to żądanie.

Stałe

STREAM_PRIORITY_HIGHEST

public static final int STREAM_PRIORITY_HIGHEST = 4

Najwyższy priorytet strumienia. Przekazano do setPriority.

STREAM_PRIORITY_IDLE

public static final int STREAM_PRIORITY_IDLE = 0

Najniższy priorytet strumienia. Przekazano do setPriority.

STREAM_PRIORITY_LOW

public static final int STREAM_PRIORITY_LOW = 2

Niski priorytet strumienia. Przekazano do setPriority.

STREAM_PRIORITY_LOWEST

public static final int STREAM_PRIORITY_LOWEST = 1

Bardzo niski priorytet strumienia. Przekazano do setPriority.

STREAM_PRIORITY_MEDIUM

public static final int STREAM_PRIORITY_MEDIUM = 3

Średni priorytet strumienia. Przekazano do setPriority. Jest to domyślny priorytet przypisany do strumienia.

Konstruktory publiczne

Kreator

public Builder()

Metody publiczne

addHeader

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

Dodaje nagłówek żądania. Zwraca narzędzie do tworzenia, aby ułatwić łączenie.

Parametry
String header

nazwę nagłówka,
String value

wartość nagłówka
Zwraca
BidirectionalStream.Builder

konstruktora, aby ułatwić łączenie.

addRequestAnnotation

public BidirectionalStream.Builder addRequestAnnotation(Object annotation)

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

Parametry
Object annotation

obiekt do przekazania do RequestFinishedInfo.Listener z właściwością RequestFinishedInfo.
Zwraca
BidirectionalStream.Builder

w narzędziu do tworzenia, aby ułatwić łączenie.

bindToNetwork

public BidirectionalStream.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.

Parametry
long networkHandle

uchwyt sieci, do którego ma być powiązana prośba. Aby usunąć powiązanie, wpisz UNBIND_NETWORK_HANDLE.
Zwraca
BidirectionalStream.Builder

w narzędziu do tworzenia, aby ułatwić łączenie.

kompilacja

public abstract BidirectionalStream build()

Tworzy BidirectionalStream na podstawie konfiguracji z tego Builder. Zwrócony BidirectionalStream można następnie uruchomić, wywołując start.

Zwraca
BidirectionalStream

utworzony BidirectionalStream na podstawie konfiguracji z tego elementu Builder

delayRequestHeadersUntilFirstFlush

public abstract BidirectionalStream.Builder delayRequestHeadersUntilFirstFlush(
    boolean delayRequestHeadersUntilFirstFlush
)

Opóźnia wysyłanie nagłówków żądań do momentu wywołania funkcji flush. Ten flag jest obecnie uwzględniany tylko wtedy, gdy negocjowany jest protokół QUIC. Jeśli ta wartość jest prawdziwa, QUIC będzie wysyłać ramkę nagłówka żądania wraz z ramkami danych jako pojedynczy pakiet, gdy będzie to możliwe.

Parametry
boolean delayRequestHeadersUntilFirstFlush

Jeśli wartość to „prawda”, wysyłanie nagłówków żądań zostanie opóźnione do momentu wywołania funkcji flush().
Zwraca
BidirectionalStream.Builder

w narzędziu do tworzenia, aby ułatwić łączenie.

setHttpMethod

public abstract BidirectionalStream.Builder setHttpMethod(String method)

Ustawia metodę HTTP dla żądania. Zwraca narzędzie do tworzenia, aby ułatwić łączenie.

Parametry
String method

metoda, która ma być używana w żądaniu. Wartość domyślna to „POST”.
Zwraca
BidirectionalStream.Builder

konstruktora, aby ułatwić łączenie.

setPriority

public abstract BidirectionalStream.Builder setPriority(int priority)

Ustawia priorytet strumienia, który powinien być jedną z wartości STREAM_PRIORITY_*. Jeśli ta metoda nie zostanie wywołana, strumień otrzyma priorytet STREAM_PRIORITY_MEDIUM.

Parametry
int priority

priorytet strumienia, który powinien być jedną z wartości STREAM_PRIORITY_*.
Zwraca
BidirectionalStream.Builder

w narzędziu do tworzenia, aby ułatwić łączenie.

setTrafficStatsTag

public BidirectionalStream.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.

Parametry
int tag

wartość tagu używana podczas rozliczania ruchu gniazd spowodowanego przez to żądanie. Tagi z zakresu od 0xFFFFFF00 do 0xFFFFFFFF są zarezerwowane i używane wewnętrznie przez usługi systemowe, takie jak android.app.DownloadManager, podczas przesyłania ruchu w imieniu aplikacji.
Zwraca
BidirectionalStream.Builder

w narzędziu do tworzenia, aby ułatwić łączenie.

setTrafficStatsUid

public BidirectionalStream.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.

Parametry
int uid

identyfikator UID do przypisywania ruchu gniazda spowodowanego przez to żądanie;
Zwraca
BidirectionalStream.Builder

w narzędziu do tworzenia, aby ułatwić łączenie.