UrlRequest

public abstract class UrlRequest

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

สรุป

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

ตัวสร้างสำหรับ UrlRequest
public abstract class UrlRequest.Callback

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

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

ค่าสถานะคำขอที่แสดงผลโดย getStatus
public abstract class UrlRequest.StatusListener

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

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

เมธอดสาธารณะ
abstract void

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

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

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

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

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

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

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

UrlRequest

public UrlRequest()

เมธอดสาธารณะ

ยกเลิก

public abstract void cancel()

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

followRedirect

public abstract void followRedirect()

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

getStatus

public abstract void getStatus(UrlRequest.StatusListener listener)

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

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

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

isDone

public abstract boolean isDone()

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

การคืนสินค้า
boolean

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

อ่านแล้ว

public abstract void read(ByteBuffer buffer)

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

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

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

เริ่ม

public abstract void start()

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