UrlRequest.Builder

public static final int REQUEST_PRIORITY_HIGHEST = 4

ลำดับความสำคัญของคำขอสูงสุด ส่งต่อให้ setPriority แล้ว

public static final int REQUEST_PRIORITY_IDLE = 0

ลำดับความสำคัญของคำขอต่ำสุด ส่งต่อให้ setPriority แล้ว

public static final int REQUEST_PRIORITY_LOW = 2

ลำดับความสำคัญของคำขอต่ำ ส่งต่อให้ setPriority แล้ว

public static final int REQUEST_PRIORITY_LOWEST = 1

ลำดับความสำคัญของคำขอต่ำมาก ส่งต่อให้ setPriority แล้ว

public static final int REQUEST_PRIORITY_MEDIUM = 3

ลำดับความสำคัญของคำขอระดับปานกลาง ส่งต่อให้ setPriority แล้ว นี่คือลำดับความสำคัญเริ่มต้นที่กำหนดให้กับคำขอ

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

เพิ่มส่วนหัวของคำขอ

public UrlRequest.Builder addRequestAnnotation(Object annotation)

เชื่อมโยงออบเจ็กต์คำอธิบายประกอบกับคำขอนี้ อาจเพิ่มได้มากกว่า 1 รายการ ส่งต่อไปยัง RequestFinishedInfo.Listener โปรดดู getAnnotations

public abstract UrlRequest.Builder allowDirectExecutor()

เครื่องหมายที่ผู้ดำเนินการคำขอนี้จะใช้เพื่อแจ้งเตือนการเรียกกลับ (สำหรับ UploadDataProvider และ UrlRequest.Callback) จะดำเนินการแบบอินไลน์โดยเจตนา เช่น directExecutor ของ Guava หรือ java.util.concurrent.ThreadPoolExecutor.CallerRunsPolicy

คำเตือน: ตัวเลือกนี้อาจทำให้บล็อกเธรดเครือข่ายโดยไม่ตั้งใจได้ง่าย ไม่ควรใช้หากการเรียกกลับของคุณดำเนินการ I/O ของดิสก์ รับล็อก หรือเรียกใช้โค้ดอื่นๆ ที่คุณไม่ได้ควบคุมและตรวจสอบอย่างรอบคอบ

public UrlRequest.Builder bindToNetwork(long networkHandle)

เชื่อมโยงคำขอกับแฮนเดิลเครือข่ายที่ระบุ Cronet จะส่งคำขอนี้โดยใช้เฉพาะเครือข่ายที่เชื่อมโยงกับแฮนเดิลนี้ หากเครือข่ายนี้ตัดการเชื่อมต่อ คำขอจะล้มเหลว โดยข้อผิดพลาดที่แน่นอนจะขึ้นอยู่กับขั้นตอนการประมวลผลคำขอเมื่อเครือข่ายตัดการเชื่อมต่อ คุณรับแฮนเดิลเครือข่ายได้ผ่าน Network#getNetworkHandle พร้อมใช้งานตั้งแต่ Android Marshmallow เป็นต้นไปเท่านั้น

public abstract UrlRequest build()

สร้าง UrlRequest โดยใช้การกำหนดค่าภายใน Builder นี้ จากนั้นคุณจะเริ่มใช้ UrlRequest ที่ส่งคืนมาได้โดยโทรหา start

public abstract UrlRequest.Builder disableCache()

ปิดใช้แคชสำหรับคำขอ หากไม่ได้ตั้งค่าบริบทให้ใช้แคช การเรียกนี้จะไม่มีผล

public abstract UrlRequest.Builder setHttpMethod(String method)

ตั้งค่าคำกริยาของเมธอด HTTP ที่จะใช้สำหรับคำขอนี้

ค่าเริ่มต้นเมื่อไม่ได้เรียกใช้เมธอดนี้คือ "GET" หากคำขอไม่มีเนื้อหา หรือ "POST" หากมีเนื้อหา

public abstract UrlRequest.Builder setPriority(int priority)

ตั้งค่าลำดับความสำคัญของคำขอ ซึ่งควรเป็นค่าใดค่าหนึ่งของ REQUEST_PRIORITY_* ระบบจะให้REQUEST_PRIORITY_MEDIUMลำดับความสำคัญแก่คำขอหากไม่ได้เรียกใช้เมธอดนี้

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

อนุญาตให้ Cronet ใช้พจนานุกรมการบีบอัดที่ระบุสำหรับคำขอนี้ เมื่อระบุไว้ Cronet อาจส่งสัญญาณไปยังเซิร์ฟเวอร์ว่าพจนานุกรมการบีบอัดดังกล่าวพร้อมใช้งาน หากต้องการให้การดำเนินการนี้มีผล คุณต้องกำหนดค่า CronetEngine ที่จะดำเนินการคำขอนี้ให้เปิดใช้รูปแบบการบีบอัดที่รองรับพจนานุกรมภายนอก ซึ่งเป็นการนำ draft-ietf-httpbis-compression-dictionary ไปใช้บางส่วนภายใน Cronet Cronet จะไม่จัดการส่วนหัวของการตอบกลับ "Use-As-Dictionary" โดยตรง แต่จะอาศัยโปรแกรมฝังเพื่อจัดการส่วนหัวเหล่านั้น แล้วเรียกใช้ UrlRequest.Builder#setCompressionDictionary ในภายหลังสำหรับคำขอที่ตรงกับกฎของ Use-As-Dictionary หรือดึงข้อมูลพจนานุกรมการบีบอัดผ่านกลไกอื่นๆ นอกแบนด์ แล้วเรียกใช้ UrlRequest.Builder#setCompressionDictionary ในภายหลัง Cronet จะตีความพจนานุกรมว่าตรงกับ UrlRequest นี้เท่านั้น หากมีการเปลี่ยนเส้นทางคำขอดังกล่าว และผู้ฝังตัดสินใจที่จะติดตามการเปลี่ยนเส้นทาง พจนานุกรมจะตรงกับ URL ใหม่ด้วย

public UrlRequest.Builder setRequestFinishedListener(RequestFinishedInfo.Listener listener)

ตั้งค่า Listener ที่จะเรียกใช้หลังจาก onCanceled(), onFailed() หรือ onSucceeded() กลับมา

ระบบจะเรียกใช้ Listener พร้อมข้อมูลคำขอที่เสร็จสมบูรณ์ใน java.util.concurrent.Executor ที่ getExecutor() ระบุ

public UrlRequest.Builder setTrafficStatsTag(int tag)

ตั้งค่าแท็ก android.net.TrafficStats ที่จะใช้เมื่อพิจารณาการเข้าชมซ็อกเก็ตที่เกิดจากคำขอนี้ ดูข้อมูลเพิ่มเติมที่ android.net.TrafficStats หากไม่ได้ตั้งค่าแท็ก (เช่น ไม่ได้เรียกใช้เมธอดนี้) บัญชี Android จะถือว่าการเข้าชมซ็อกเก็ตที่เกิดจากคำขอนี้เป็นค่าแท็กที่ตั้งเป็น 0

หมายเหตุ: การตั้งค่าแท็กจะไม่อนุญาตให้แชร์ซ็อกเก็ตกับคำขอที่มีแท็กอื่น ซึ่งอาจส่งผลเสียต่อประสิทธิภาพโดยการห้ามแชร์การเชื่อมต่อ กล่าวคือ จะอนุญาตให้ใช้ซ็อกเก็ตแบบมัลติเพล็กซ์ (เช่น HTTP/2 และ QUIC) ก็ต่อเมื่อคำขอทั้งหมดมีแท็กซ็อกเก็ตเดียวกัน

public UrlRequest.Builder setTrafficStatsUid(int uid)

ตั้งค่า UID ที่เฉพาะเจาะจงเพื่อใช้เมื่อบันทึกการรับส่งข้อมูลของซ็อกเก็ตที่เกิดจากคำขอนี้ ดูข้อมูลเพิ่มเติมที่ android.net.TrafficStats ออกแบบมาเพื่อใช้เมื่อดำเนินการในนามของแอปพลิเคชันอื่น ผู้โทรต้องมีสิทธิ์ MODIFY_NETWORK_ACCOUNTING โดยค่าเริ่มต้น ระบบจะระบุแหล่งที่มาของการเข้าชมเป็น UID ของผู้โทร

หมายเหตุ: การตั้งค่า UID จะไม่อนุญาตให้แชร์ซ็อกเก็ตกับคำขอที่มี UID อื่น ซึ่งอาจส่งผลเสียต่อประสิทธิภาพโดยการห้ามการแชร์การเชื่อมต่อ กล่าวคือ จะอนุญาตให้ใช้ซ็อกเก็ตแบบมัลติเพล็กซ์ (เช่น HTTP/2 และ QUIC) ก็ต่อเมื่อคำขอทั้งหมดมีการตั้งค่า UID เดียวกัน

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

ตั้งค่าผู้ให้บริการข้อมูลการอัปโหลด เปลี่ยนเมธอดเป็น "POST" หากไม่ได้ตั้งค่าไว้อย่างชัดแจ้ง การเริ่มคำขอจะทำให้เกิดข้อยกเว้นหากไม่ได้ตั้งค่าส่วนหัว Content-Type