UrlRequest.Builder

public static final int REQUEST_PRIORITY_HIGHEST = 4

Prioritas permintaan tertinggi. Diteruskan ke setPriority.

public static final int REQUEST_PRIORITY_IDLE = 0

Prioritas permintaan terendah. Diteruskan ke setPriority.

public static final int REQUEST_PRIORITY_LOW = 2

Prioritas permintaan rendah. Diteruskan ke setPriority.

public static final int REQUEST_PRIORITY_LOWEST = 1

Prioritas permintaan sangat rendah. Diteruskan ke setPriority.

public static final int REQUEST_PRIORITY_MEDIUM = 3

Prioritas permintaan sedang. Diteruskan ke setPriority. Ini adalah prioritas default yang diberikan pada permintaan.

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

Menambahkan header permintaan.

public UrlRequest.Builder addRequestAnnotation(Object annotation)

Mengaitkan objek anotasi dengan permintaan ini. Dapat menambahkan lebih dari satu. Diteruskan ke RequestFinishedInfo.Listener, lihat getAnnotations.

public abstract UrlRequest.Builder allowDirectExecutor()

Menandai bahwa eksekutor yang akan digunakan permintaan ini untuk memberi tahu callback (untuk UploadDataProvider dan UrlRequest.Callback) sengaja melakukan eksekusi inline, seperti directExecutor Guava atau java.util.concurrent.ThreadPoolExecutor.CallerRunsPolicy.

Peringatan: Opsi ini memudahkan pemblokiran thread jaringan secara tidak sengaja. Tidak boleh digunakan jika callback Anda melakukan I/O disk, mendapatkan kunci, atau memanggil kode lain yang tidak Anda kontrol dan audit dengan cermat.

public UrlRequest.Builder bindToNetwork(long networkHandle)

Mengikat permintaan ke handle jaringan yang ditentukan. Cronet akan mengirim permintaan ini hanya menggunakan jaringan yang terkait dengan handle ini. Jika jaringan ini terputus, permintaan akan gagal, dan error yang tepat akan bergantung pada tahap pemrosesan permintaan saat jaringan terputus. Nama sebutan jaringan dapat diperoleh melalui Network#getNetworkHandle. Hanya tersedia mulai Android Marshmallow.

public abstract UrlRequest build()

Membuat UrlRequest menggunakan konfigurasi dalam Builder ini. UrlRequest yang ditampilkan kemudian dapat dimulai dengan memanggil start.

public abstract UrlRequest.Builder disableCache()

Menonaktifkan cache untuk permintaan. Jika konteks tidak disiapkan untuk menggunakan cache, panggilan ini tidak akan berpengaruh.

public abstract UrlRequest.Builder setHttpMethod(String method)

Menetapkan kata kerja metode HTTP yang akan digunakan untuk permintaan ini.

Defaultnya jika metode ini tidak dipanggil adalah "GET" jika permintaan tidak memiliki isi atau "POST" jika memiliki isi.

public abstract UrlRequest.Builder setPriority(int priority)

Menetapkan prioritas permintaan yang harus berupa salah satu nilai REQUEST_PRIORITY_*. Permintaan diberi prioritas REQUEST_PRIORITY_MEDIUM jika metode ini tidak dipanggil.

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

Mengizinkan Cronet menggunakan kamus kompresi yang ditentukan untuk permintaan ini. Jika ditentukan, Cronet dapat memberi sinyal kepada server tentang ketersediaan kamus kompresi tersebut. Agar dapat memberikan efek, CronetEngine yang akan mengeksekusi permintaan ini harus telah dikonfigurasi untuk mengaktifkan skema kompresi yang mendukung kamus eksternal. Hal ini sebagian menerapkan draft-ietf-httpbis-compression-dictionary dalam Cronet. Cronet tidak akan menangani header respons "Use-As-Dictionary" secara langsung, melainkan akan mengandalkan penyematan untuk: menangani header tersebut dan kemudian memanggil UrlRequest.Builder#setCompressionDictionary untuk permintaan yang cocok dengan aturan Use-As-Dictionary; atau mengambil kamus kompresi melalui mekanisme di luar band lainnya, dan kemudian memanggil UrlRequest.Builder#setCompressionDictionary. Cronet akan menafsirkan kamus sebagai hanya cocok dengan UrlRequest ini. Jika permintaan tersebut dialihkan, dan penyemat memutuskan untuk mengikuti pengalihan, kamus juga akan cocok dengan URL baru.

public UrlRequest.Builder setRequestFinishedListener(RequestFinishedInfo.Listener listener)

Menetapkan pemroses yang dipanggil setelah onCanceled(), onFailed(), atau onSucceeded() ditampilkan.

Pemroses dipanggil dengan info permintaan selesai pada java.util.concurrent.Executor yang disediakan oleh getExecutor().

public UrlRequest.Builder setTrafficStatsTag(int tag)

Menetapkan tag android.net.TrafficStats yang akan digunakan saat memperhitungkan traffic soket yang disebabkan oleh permintaan ini. Lihat android.net.TrafficStats untuk informasi selengkapnya. Jika tidak ada tag yang ditetapkan (misalnya, metode ini tidak dipanggil), Android akan memperhitungkan traffic soket yang disebabkan oleh permintaan ini seolah-olah nilai tag ditetapkan ke 0.

CATATAN:Menetapkan tag melarang berbagi soket dengan permintaan yang memiliki tag lain, yang dapat memengaruhi performa secara negatif dengan melarang berbagi koneksi. Dengan kata lain, penggunaan soket yang di-multiplex (misalnya HTTP/2 dan QUIC) hanya akan diizinkan jika semua permintaan memiliki tag soket yang sama.

public UrlRequest.Builder setTrafficStatsUid(int uid)

Menetapkan UID tertentu untuk digunakan saat menghitung traffic soket yang disebabkan oleh permintaan ini. Lihat android.net.TrafficStats untuk mengetahui informasi selengkapnya. Dirancang untuk digunakan saat melakukan operasi atas nama aplikasi lain. Pemanggil harus memiliki izin MODIFY_NETWORK_ACCOUNTING. Secara default, traffic diatribusikan ke UID pemanggil.

CATATAN:Menetapkan UID melarang berbagi soket dengan permintaan yang memiliki UID lain, yang dapat memengaruhi performa secara negatif dengan melarang berbagi koneksi. Dengan kata lain, penggunaan soket yang di-multiplex (misalnya HTTP/2 dan QUIC) hanya akan diizinkan jika semua permintaan memiliki set UID yang sama.

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

Menetapkan penyedia data upload. Mengalihkan metode ke "POST" jika tidak ditetapkan secara eksplisit. Memulai permintaan akan memunculkan pengecualian jika header Content-Type tidak ditetapkan.