UrlRequest.Builder

public static final int REQUEST_PRIORITY_HIGHEST = 4

En yüksek istek önceliği. setPriority adlı hesaba aktarıldı.

public static final int REQUEST_PRIORITY_IDLE = 0

En düşük istek önceliği. setPriority adlı hesaba aktarıldı.

public static final int REQUEST_PRIORITY_LOW = 2

Düşük istek önceliği. setPriority adlı hesaba aktarıldı.

public static final int REQUEST_PRIORITY_LOWEST = 1

İstek önceliği çok düşük. setPriority adlı hesaba aktarıldı.

public static final int REQUEST_PRIORITY_MEDIUM = 3

Orta düzeyde istek önceliği. setPriority adlı hesaba aktarıldı. Bu, isteğe verilen varsayılan önceliktir.

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

İstek başlığı ekler.

public UrlRequest.Builder addRequestAnnotation(Object annotation)

Ek açıklama nesnesini bu istekle ilişkilendirir. Birden fazla ekleyebilirsiniz. RequestFinishedInfo.Listener aracılığıyla iletildi. getAnnotations bölümüne bakın.

public abstract UrlRequest.Builder allowDirectExecutor()

Bu isteği yürütenlerin geri çağırmaları ( UploadDataProvider ve UrlRequest.Callback için) bildirmek üzere kullanacağı işaretlerin, Guava'nın directExecutor'ı veya java.util.concurrent.ThreadPoolExecutor.CallerRunsPolicy gibi satır içi yürütmeyi kasıtlı olarak gerçekleştirdiği anlamına gelir.

Uyarı: Bu seçenek, ağ iş parçacığının yanlışlıkla engellenmesini kolaylaştırır. Geri çağırma işlemleriniz disk G/Ç'si gerçekleştiriyorsa, kilitler alıyorsa veya dikkatli bir şekilde kontrol edip denetlemediğiniz başka bir kodu çağırıyorsa kullanılmamalıdır.

public UrlRequest.Builder bindToNetwork(long networkHandle)

İsteği belirtilen ağ tanıtıcısına bağlar. Cronet, bu isteği yalnızca bu işleyiciyle ilişkili ağı kullanarak gönderir. Bu ağ bağlantısı kesilirse istek başarısız olur. Tam hata, ağ bağlantısının kesildiği sırada istek işleme aşamasına bağlıdır. Ağ kullanıcı adları Network#getNetworkHandle üzerinden alınabilir. Yalnızca Android Marshmallow ve sonraki sürümlerde kullanılabilir.

public abstract UrlRequest build()

Bu Builder içindeki yapılandırmayı kullanarak bir UrlRequest oluşturur. Geri dönen UrlRequest, start aranarak başlatılabilir.

public abstract UrlRequest.Builder disableCache()

İstek için önbelleği devre dışı bırakır. Bağlam, önbelleği kullanacak şekilde ayarlanmamışsa bu çağrının etkisi olmaz.

public abstract UrlRequest.Builder setHttpMethod(String method)

Bu istek için kullanılacak HTTP yöntemi fiilini ayarlar.

Bu yöntem çağrılmadığında varsayılan olarak, istekte gövde yoksa "GET", varsa "POST" kullanılır.

public abstract UrlRequest.Builder setPriority(int priority)

İsteğin önceliğini ayarlar. Bu değer, REQUEST_PRIORITY_* değerlerinden biri olmalıdır. Bu yöntem çağrılmazsa isteğe REQUEST_PRIORITY_MEDIUM önceliği verilir.

@UrlRequest.Experimental
public UrlRequest.Builder setRawCompressionDictionary(
    byte[] dictionarySha256Hash,
    ByteBuffer dictionary,
    String dictionaryId
)

Cronet'in bu istek için belirtilen sıkıştırma sözlüğünü kullanmasına izin verir. Belirtildiğinde Cronet, söz konusu sıkıştırma sözlüğünün kullanılabilirliğini sunucuya bildirebilir. Bunun herhangi bir etkisi olması için bu isteği yürütecek CronetEngine'in, harici sözlükleri destekleyen bir sıkıştırma şemasını etkinleştirecek şekilde yapılandırılmış olması gerekir. Bu, Cronet'te draft-ietf-httpbis-compression-dictionary'nin kısmen uygulanmasını sağlar. Cronet, "Use-As-Dictionary " yanıt başlıklarını doğrudan işlemez. Bunun yerine, bunları işlemek ve daha sonra Use-As-Dictionary kurallarına uyan istekler için UrlRequest.Builder#setCompressionDictionary'yi çağırmak ya da bant dışı başka bir mekanizma aracılığıyla sıkıştırma sözlüklerini getirmek ve daha sonra UrlRequest.Builder#setCompressionDictionary'yi çağırmak için yerleştiriciye güvenir. Cronet, sözlüğü yalnızca bu UrlRequest ile eşleşecek şekilde yorumlar. Söz konusu istek yönlendirilirse ve yerleştirici yönlendirmeyi takip etmeye karar verirse sözlük yeni URL ile de eşleşir.

public UrlRequest.Builder setRequestFinishedListener(RequestFinishedInfo.Listener listener)

onCanceled(), onFailed() veya onSucceeded() döndükten sonra çağrılan bir dinleyici ayarlar.

Dinleyici, getExecutor() tarafından sağlanan bir java.util.concurrent.Executor üzerinde istek tamamlandı bilgileriyle çağrılır.

public UrlRequest.Builder setTrafficStatsTag(int tag)

Bu istekten kaynaklanan soket trafiği hesaplanırken kullanılacak android.net.TrafficStats etiketini ayarlar. Daha fazla bilgi için android.net.TrafficStats dokümanına bakın. Etiket ayarlanmamışsa (ör. bu yöntem çağrılmamışsa) Android, etiket değeri 0 olarak ayarlanmış gibi bu isteğin neden olduğu soket trafiğini hesaba katar.

NOT: Etiket ayarlamak, soketlerin diğer etiketlere sahip isteklerle paylaşılmasına izin vermez. Bu durum, bağlantı paylaşımını engelleyerek performansı olumsuz etkileyebilir. Diğer bir deyişle, çoklu soketlerin (ör. HTTP/2 ve QUIC) kullanılması yalnızca tüm isteklerin aynı soket etiketine sahip olması durumunda mümkündür.

public UrlRequest.Builder setTrafficStatsUid(int uid)

Bu istekten kaynaklanan soket trafiğini hesaplarken kullanılacak belirli bir UID ayarlar. Daha fazla bilgi için android.net.TrafficStats sayfasına göz atın. Başka bir uygulama adına işlem yaparken kullanılmak üzere tasarlanmıştır. Arayan kullanıcının MODIFY_NETWORK_ACCOUNTING izni olmalıdır. Varsayılan olarak trafik, arayanın UID'sine ilişkilendirilir.

NOT: UID ayarlamak, soketlerin diğer UID'lere sahip isteklerle paylaşılmasına izin vermez. Bu durum, bağlantı paylaşımını engelleyerek performansı olumsuz etkileyebilir. Diğer bir deyişle, çoklu soketlerin (ör. HTTP/2 ve QUIC) kullanılması yalnızca tüm isteklerde aynı UID ayarlanmışsa mümkün olacaktır.

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

Yükleme veri sağlayıcısını ayarlar. Açıkça ayarlanmamışsa yöntemi "POST" olarak değiştirir. İstek başlatılırken Content-Type başlığı ayarlanmamışsa istisna oluşturulur.