วงจรชีวิตของคำขอ Cronet

ดูข้อมูลเกี่ยวกับวงจรของคำขอที่สร้างขึ้นโดยใช้ Cronet และวิธีจัดการคำขอโดยใช้เมธอด Callback ที่ไลบรารีมีให้

ภาพรวมวงจรลูกค้า

คลาส UrlRequest แสดงถึงคำขอเครือข่ายที่สร้างขึ้นโดยใช้ไลบรารี Cronet แนวคิดต่อไปนี้มีความสำคัญต่อการทำความเข้าใจวงจรชีวิตของ UrlRequest

รัฐ
สถานะคือเงื่อนไขเฉพาะที่คำขออยู่ในเวลาที่กำหนด ออบเจ็กต์ UrlRequest ที่สร้างขึ้นโดยใช้ไลบรารี Cronet จะเปลี่ยนสถานะต่างๆ ในวงจร วงจรคำขอประกอบด้วยสถานะเริ่มต้น และสถานะการเปลี่ยนผ่านและสถานะสุดท้ายหลายสถานะ
UrlRequest วิธี
ไคลเอ็นต์สามารถเรียกใช้เมธอดที่เฉพาะเจาะจงในออบเจ็กต์ UrlRequest ได้โดยขึ้นอยู่กับสถานะ เมธอดจะย้ายคำขอจากสถานะหนึ่งไปยังอีกสถานะหนึ่ง
Callback วิธี
เมื่อใช้เมธอดของคลาส UrlRequest.Callback แอปของคุณจะได้รับข้อมูลอัปเดตเกี่ยวกับความคืบหน้าของคำขอ คุณสามารถใช้เมธอด Callback เพื่อเรียกใช้เมธอดของออบเจ็กต์ UrlRequest ที่นำวงจรจากสถานะหนึ่งไปยังอีกสถานะหนึ่งได้

รายการต่อไปนี้อธิบายขั้นตอนของวงจรชีวิตของ UrlRequest

  1. วงจรจะอยู่ในสถานะเริ่มต้นหลังจากที่แอปเรียกใช้เมธอด start()
  2. เซิร์ฟเวอร์อาจส่งการตอบกลับการเปลี่ยนเส้นทาง ซึ่งจะนำขั้นตอนไปยังเมธอด onRedirectReceived() ในวิธีนี้ คุณสามารถดำเนินการอย่างใดอย่างหนึ่งต่อไปนี้กับไคลเอ็นต์
    • ทำตามการเปลี่ยนเส้นทางโดยใช้ followRedirect() วิธีนี้จะนำคำขอกลับไปที่สถานะเริ่มต้น
    • ยกเลิกคำขอโดยใช้ cancel() เมธอดนี้จะส่งคำขอไปยังเมธอด onCanceled() ซึ่งแอปสามารถดำเนินการเพิ่มเติมก่อนที่คำขอจะเปลี่ยนเป็นสถานะสุดท้ายยกเลิกแล้ว
  3. หลังจากแอปทำตามการเปลี่ยนเส้นทางทั้งหมดแล้ว เซิร์ฟเวอร์จะส่งส่วนหัวการตอบกลับและ Cronet จะเรียกใช้เมธอด onResponseStarted() คำขออยู่ในสถานะรอ read() แอปต้องเรียกใช้เมธอด read() เพื่อพยายามอ่านส่วนหนึ่งของเนื้อหาการตอบกลับ หลังจากแอปเรียกใช้ read() คำขอจะอยู่ในสถานะกำลังอ่าน ซึ่งอาจมีผลลัพธ์ที่เป็นไปได้ดังนี้
    • การดำเนินการอ่านสำเร็จ และมีข้อมูลเพิ่มเติมที่พร้อมใช้งาน Cronet จะเรียกใช้เมธอด onReadCompleted() และคำขอจะอยู่ในสถานะรอ read() อีกครั้ง แอปสามารถเรียกใช้เมธอด read() อีกครั้งเพื่ออ่านเนื้อหาการตอบกลับต่อได้ นอกจากนี้ แอปยังหยุดอ่านคำขอได้โดยใช้เมธอด cancel()
    • การดำเนินการอ่านสำเร็จ และไม่มีข้อมูลที่พร้อมใช้งานอีกต่อไป Cronet จะเรียกใช้เมธอด onSucceeded() และคำขอจะอยู่ในสถานะสุดท้ายเป็นสำเร็จ
    • การดำเนินการอ่านไม่สำเร็จ Cronet จะเรียกใช้เมธอด onFailed() และสถานะสุดท้ายของคำขอคือไม่สำเร็จ

แผนภาพต่อไปนี้แสดงวงจรของออบเจ็กต์ UrlRequest

แผนภาพวงจรคำขอ Cronet
วงจรคำขอ Cronet

Legend
สถานะเริ่มต้น ไอคอนคำอธิบายสถานะเริ่มต้นของ Cronet รายการ สถานะสุดท้าย ไอคอนคำอธิบายสถานะสุดท้ายของ Cronet รายการ
สถานะการเปลี่ยนผ่าน ไอคอนคำอธิบายสถานะการเปลี่ยนผ่านของ Cronet รายการ เมธอด Callback ไอคอนคำอธิบายเมธอด Callback ของ Cronet รายการ
ไอคอนคำอธิบายการดำเนินการของไคลเอ็นต์ Cronet UrlRequest วิธี