UrlRequest.Callback

public abstract class UrlRequest.Callback

คลาสย่อยโดยตรงที่ทราบ
ImplicitFlowControlCallback

การใช้งาน UrlRequest.Callback ที่ช่วยลดความยุ่งยากในการจัดการวงจรการใช้งานของคำขอ และดำเนินการอ่านการตอบกลับทั้งหมดโดยอัตโนมัติ
คลาสย่อยโดยอ้อมที่ทราบ
ByteArrayCronetCallback

InMemoryTransformCronetCallback ที่มีความเฉพาะเจาะจงมากขึ้น ซึ่งแสดงผลไบต์ของเนื้อหาตามตัวอักษรโดยไม่มีการตีความ
InMemoryTransformCronetCallback

การเรียกกลับ Cronet แบบนามธรรมที่อ่านเนื้อหาทั้งหมดลงในหน่วยความจำ และเลือกที่จะยกเลิกการซีเรียลไลซ์เนื้อหาก่อนที่จะส่งกลับไปยังผู้ออกคำขอ HTTP
JsonCronetCallback

InMemoryTransformCronetCallback ที่มีความเฉพาะเจาะจงมากขึ้น ซึ่งตีความเนื้อหาการตอบกลับเป็น JSON
StringCronetCallback

InMemoryTransformCronetCallback ที่มีความเฉพาะเจาะจงมากขึ้น ซึ่งตีความเนื้อหาการตอบกลับเป็นสตริง

ผู้ใช้ Cronet ขยายคลาสนี้เพื่อรับการเรียกกลับที่ระบุความคืบหน้าของการประมวลผล UrlRequest ระบบจะส่งอินสแตนซ์ของคลาสนี้ไปยังเครื่องมือสร้างของ UrlRequest.Builder เมื่อสร้าง UrlRequest

หมายเหตุ: ระบบจะเรียกใช้เมธอดทั้งหมดในเธรดของ java.util.concurrent.Executor ที่ใช้ระหว่างการสร้าง UrlRequest

สรุป

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

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

เรียกใช้หากมีการยกเลิกคำขอผ่าน cancel
abstract void
onFailed(
    UrlRequest request,
    UrlResponseInfo info,
    CronetException error
)

เรียกใช้หากคำขอล้มเหลวด้วยเหตุผลใดก็ตามหลังจาก start
abstract void
onReadCompleted(
    UrlRequest request,
    UrlResponseInfo info,
    ByteBuffer byteBuffer
)

เรียกใช้ทุกครั้งที่อ่านเนื้อหาการตอบกลับบางส่วน
abstract void
onRedirectReceived(
    UrlRequest request,
    UrlResponseInfo info,
    String newLocationUrl
)

เรียกใช้ทุกครั้งที่พบการเปลี่ยนเส้นทาง
abstract void

เรียกใช้เมื่อได้รับชุดส่วนหัวสุดท้ายหลังจากเปลี่ยนเส้นทางทั้งหมด
abstract void

เรียกใช้เมื่อคำขอเสร็จสมบูรณ์เรียบร้อยแล้ว

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

Callback

public Callback()

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

onCanceled

public void onCanceled(UrlRequest request, UrlResponseInfo info)

เรียกใช้หากมีการยกเลิกคำขอผ่าน cancel เมื่อเรียกใช้แล้ว ระบบจะไม่เรียกใช้เมธอด Callback อื่นๆ การใช้งานเริ่มต้นจะไม่ดำเนินการใดๆ

พารามิเตอร์
UrlRequest request

คำขอที่ถูกยกเลิก
UrlResponseInfo info

ข้อมูลการตอบกลับ อาจเป็น null หากไม่ได้รับการตอบกลับ

onFailed

public abstract void onFailed(
    UrlRequest request,
    UrlResponseInfo info,
    CronetException error
)

เรียกใช้หากคำขอล้มเหลวด้วยเหตุผลใดก็ตามหลังจาก start เมื่อเรียกใช้แล้ว ระบบจะไม่เรียกใช้เมธอด Callback อื่นๆ error ให้ข้อมูลเกี่ยวกับความล้มเหลว

พารามิเตอร์
UrlRequest request

คำขอที่ล้มเหลว
UrlResponseInfo info

ข้อมูลการตอบกลับ อาจเป็น null หากไม่ได้รับการตอบกลับ
CronetException error

ข้อมูลเกี่ยวกับข้อผิดพลาด

onReadCompleted

public abstract void onReadCompleted(
    UrlRequest request,
    UrlResponseInfo info,
    ByteBuffer byteBuffer
)

เรียกใช้ทุกครั้งที่อ่านเนื้อหาการตอบกลับบางส่วน บัฟเฟอร์อาจมีข้อมูลเพียงบางส่วน แม้ว่าจะยังไม่ได้ใช้เนื้อหาการตอบกลับทั้งหมดก็ตาม ยกเว้น onCanceled() ระบบจะไม่เรียกใช้เมธอด Callback อื่นๆ สำหรับคำขอ รวมถึง onSucceeded() และ onFailed() จนกว่าจะมีการเรียกใช้ UrlRequest.read() เพื่อพยายามอ่านเนื้อหาการตอบกลับต่อ

พารามิเตอร์
UrlRequest request

คำขอที่ได้รับข้อมูล
UrlResponseInfo info

ข้อมูลการตอบกลับ
ByteBuffer byteBuffer

บัฟเฟอร์ที่ส่งไปยัง UrlRequest.read() ซึ่งตอนนี้มีข้อมูลที่ได้รับ ระบบจะอัปเดตตำแหน่งของบัฟเฟอร์เป็นส่วนท้ายของข้อมูลที่ได้รับ และจะไม่เปลี่ยนแปลงขีดจำกัดของบัฟเฟอร์
ส่ง
java.lang.Exception

หากเกิดข้อผิดพลาดขณะประมวลผลการอ่านเสร็จสมบูรณ์ ระบบจะเรียกใช้ onFailed โดยตั้งค่าข้อยกเว้นที่ส่งเป็นสาเหตุของ CallbackException

onRedirectReceived

public abstract void onRedirectReceived(
    UrlRequest request,
    UrlResponseInfo info,
    String newLocationUrl
)

เรียกใช้ทุกครั้งที่พบการเปลี่ยนเส้นทาง ระบบจะเรียกใช้ฟังก์ชันนี้ระหว่างการเรียกใช้ start กับ onResponseStarted() เท่านั้น ระบบจะเพิกเฉยต่อเนื้อหาการตอบกลับการเปลี่ยนเส้นทาง หากมี ระบบจะไม่เปลี่ยนเส้นทางจนกว่าจะมีการเรียกใช้เมธอด followRedirect ของ URLRequest แบบซิงโครนัสหรืออะซิงโครนัส

พารามิเตอร์
UrlRequest request

คำขอที่กำลังเปลี่ยนเส้นทาง
UrlResponseInfo info

ข้อมูลการตอบกลับ
String newLocationUrl

ตำแหน่งที่จะเปลี่ยนเส้นทางคำขอ
ส่ง
java.lang.Exception

หากเกิดข้อผิดพลาดขณะประมวลผลการเปลี่ยนเส้นทาง ระบบจะเรียกใช้ onFailed โดยตั้งค่าข้อยกเว้นที่ส่งเป็นสาเหตุของ CallbackException

onResponseStarted

public abstract void onResponseStarted(UrlRequest request, UrlResponseInfo info)

เรียกใช้เมื่อได้รับชุดส่วนหัวสุดท้ายหลังจากเปลี่ยนเส้นทางทั้งหมด ระบบจะเรียกใช้ฟังก์ชันนี้เพียงครั้งเดียวสำหรับคำขอแต่ละรายการ ยกเว้น onCanceled() ระบบจะไม่เรียกใช้เมธอด Callback อื่นๆ สำหรับคำขอ รวมถึง onSucceeded() และ onFailed() จนกว่าจะมีการเรียกใช้ UrlRequest.read() เพื่อพยายามเริ่มอ่านเนื้อหาการตอบกลับ

พารามิเตอร์
UrlRequest request

คำขอที่เริ่มรับการตอบกลับ
UrlResponseInfo info

ข้อมูลการตอบกลับ
ส่ง
java.lang.Exception

หากเกิดข้อผิดพลาดขณะประมวลผลการเริ่มต้นการตอบกลับ ระบบจะเรียกใช้ onFailed โดยตั้งค่าข้อยกเว้นที่ส่งเป็นสาเหตุของ CallbackException

onSucceeded

public abstract void onSucceeded(UrlRequest request, UrlResponseInfo info)

เรียกใช้เมื่อคำขอเสร็จสมบูรณ์เรียบร้อยแล้ว เมื่อเรียกใช้แล้ว ระบบจะไม่เรียกใช้เมธอด Callback อื่นๆ

พารามิเตอร์
UrlRequest request

คำขอที่สำเร็จ
UrlResponseInfo info

ข้อมูลการตอบกลับ