UrlRequest

abstract class UrlRequest

ควบคุมคำขอ HTTP (GET, PUT, POST ฯลฯ) สร้างโดย UrlRequest.Builder ซึ่งรับได้โดยการเรียก newUrlRequestBuilder หมายเหตุ: ต้องเรียกใช้เมธอดทั้งหมดใน Executor ที่ส่งไปยัง newUrlRequestBuilder

สรุป

ประเภทที่ซ้อนกัน
abstract class UrlRequest.Builder

ผู้รับสร้างบ้านสำหรับ UrlRequest
abstract class UrlRequest.Callback

ผู้ใช้ Cronet ขยายคลาสนี้เพื่อรับการเรียกกลับที่ระบุความคืบหน้าของ UrlRequest ที่กำลังประมวลผล

คำอธิบายประกอบสำหรับ API ที่ยังไม่ถือว่าเสถียร

ค่าสถานะคำขอที่แสดงผลโดย getStatus

คลาส Listener ที่ใช้กับ getStatus เพื่อรับสถานะของ UrlRequest

เครื่องมือสร้างสาธารณะ

ฟังก์ชันสาธารณะ
abstract Unit

ยกเลิกคำขอ
abstract Unit

ติดตามการเปลี่ยนเส้นทางที่รอดำเนินการ
abstract Unit

สอบถามสถานะคำขอ
abstract Boolean

แสดงผล true หากคำขอเริ่มต้นสำเร็จและเสร็จสมบูรณ์แล้ว (เสร็จสมบูรณ์ ยกเลิก หรือล้มเหลว)
abstract Unit
read(buffer: ByteBuffer!)

พยายามอ่านส่วนหนึ่งของเนื้อหาการตอบกลับลงในบัฟเฟอร์ที่ระบุ
abstract Unit

เริ่มคำขอ การเรียกกลับทั้งหมดจะไปที่ Callback

เครื่องมือสร้างสาธารณะ

UrlRequest

UrlRequest()

ฟังก์ชันสาธารณะ

ยกเลิก

abstract fun cancel(): Unit

ยกเลิกคำขอ เรียกได้ทุกเมื่อ onCanceled() จะทำงานเมื่อการยกเลิกเสร็จสมบูรณ์และจะไม่มีการเรียกใช้เมธอดการเรียกกลับเพิ่มเติม หากคำขอเสร็จสมบูรณ์แล้วหรือยังไม่ได้เริ่มต้น การเรียก cancel() จะไม่มีผลและระบบจะไม่เรียกใช้ onCanceled() หาก Executor ที่ส่งผ่านระหว่างการสร้าง UrlRequest เรียกใช้ฟังก์ชันในเธรดเดียว และมีการเรียก cancel() ในเธรดนั้น ระบบจะไม่เรียกใช้เมธอดการเรียกกลับ (นอกเหนือจาก onCanceled()) หลังจากเรียก cancel() ไม่เช่นนั้น ระบบอาจเรียกใช้เมธอด Callback อย่างน้อย 1 รายการหลังจาก cancel() เสร็จสมบูรณ์

followRedirect

abstract fun followRedirect(): Unit

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

getStatus

abstract fun getStatus(listener: UrlRequest.StatusListener!): Unit

สอบถามสถานะคำขอ

พารามิเตอร์
listener: UrlRequest.StatusListener!

StatusListener ที่จะทำงานพร้อมสถานะปัจจุบันของคำขอ ระบบจะเรียกใช้ listener กลับใน Executor ที่ส่งผ่านเมื่อสร้างคำขอ

isDone

abstract fun isDone(): Boolean

แสดงผล true หากคำขอเริ่มต้นสำเร็จและเสร็จสมบูรณ์แล้ว (เสร็จสมบูรณ์ ยกเลิก หรือล้มเหลว)

แสดงผล
Boolean

true หากคำขอเริ่มต้นสำเร็จและเสร็จสมบูรณ์แล้ว (เสร็จสมบูรณ์ ยกเลิก หรือล้มเหลว)

อ่านแล้ว

abstract fun read(buffer: ByteBuffer!): Unit

พยายามอ่านส่วนหนึ่งของเนื้อหาการตอบกลับลงในบัฟเฟอร์ที่ระบุ ต้องเรียกใช้ได้ไม่เกิน 1 ครั้งเพื่อตอบสนองต่อการเรียกใช้เมธอด onResponseStarted() และ onReadCompleted() ของ Callback แต่ละครั้ง การเรียกใช้แต่ละครั้งจะส่งผลให้เกิดการเรียกใช้แบบไม่พร้อมกันไปยังเมธอด Callback'sonReadCompleted() หากมีการอ่านข้อมูล เมธอด onSucceeded() หากไม่มีข้อมูลให้อ่านอีก หรือเมธอด onFailed() หากมีข้อผิดพลาด

พารามิเตอร์
buffer: ByteBuffer!

ByteBuffer เพื่อเขียนเนื้อหาการตอบกลับ ต้องเป็น ByteBuffer โดยตรง ผู้ฝังต้องไม่อ่านหรือแก้ไขตำแหน่ง ขีดจำกัด หรือข้อมูลของบัฟเฟอร์ระหว่างตำแหน่งและขีดจำกัดจนกว่าคำขอจะเรียกกลับไปยัง Callback

เริ่ม

abstract fun start(): Unit

เริ่มคำขอ การเรียกกลับทั้งหมดจะไปที่ Callback เรียกได้เพียงครั้งเดียว เรียกไม่ได้หากมีการเรียก cancel