ImplicitFlowControlCallback

public abstract class ImplicitFlowControlCallback extends UrlRequest.Callback

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

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

คลาสย่อยทางอ้อมที่ทราบ
ByteArrayCronetCallback

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

JsonCronetCallback

การเชี่ยวชาญของ InMemoryTransformCronetCallback ที่ตีความเนื้อหาการตอบกลับเป็น JSON

StringCronetCallback

การเชี่ยวชาญของ InMemoryTransformCronetCallback ที่ตีความเนื้อหาการตอบกลับเป็นสตริง


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

สรุป

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

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

final void

เรียกใช้หากมีการยกเลิกคำขอผ่าน cancel

final void
onFailed(
    UrlRequest request,
    UrlResponseInfo info,
    CronetException error
)

เรียกใช้หากคำขอไม่สำเร็จไม่ว่าด้วยเหตุผลใดก็ตามหลังจาก start

final void
onReadCompleted(
    UrlRequest request,
    UrlResponseInfo info,
    ByteBuffer byteBuffer
)

เรียกใช้เมื่อใดก็ตามที่อ่านส่วนหนึ่งของเนื้อหาการตอบกลับ

final void
onRedirectReceived(
    UrlRequest request,
    UrlResponseInfo info,
    String newLocationUrl
)

เรียกใช้เมื่อใดก็ตามที่พบการเปลี่ยนเส้นทาง

final void

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

final void

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

วิธีการที่ได้รับการปกป้อง

abstract void

เรียกใช้เมื่อใดก็ตามที่อ่านส่วนหนึ่งของเนื้อหาการตอบกลับ

abstract void

เรียกใช้หากมีการยกเลิกคำขอผ่าน cancel

abstract void

เรียกใช้หากคำขอไม่สำเร็จไม่ว่าด้วยเหตุผลใดก็ตามหลังจาก start

abstract void

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

abstract void

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

abstract boolean

เรียกใช้เมื่อใดก็ตามที่พบการเปลี่ยนเส้นทาง

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

ImplicitFlowControlCallback

public ImplicitFlowControlCallback()

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

onCanceled

public final void onCanceled(UrlRequest request, UrlResponseInfo info)

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

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

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

UrlResponseInfo info

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

onFailed

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

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

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

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

UrlResponseInfo info

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

CronetException error

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

onReadCompleted

public final 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 final 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 final void onResponseStarted(UrlRequest request, UrlResponseInfo info)

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

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

คำขอที่เริ่มได้รับการตอบกลับ

UrlResponseInfo info

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

ส่ง
java.lang.Exception

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

onSucceeded

public final void onSucceeded(UrlRequest request, UrlResponseInfo info)

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

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

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

UrlResponseInfo info

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

วิธีการที่ได้รับการปกป้อง

onBodyChunkRead

protected abstract void onBodyChunkRead(UrlResponseInfo info, ByteBuffer bodyChunk)

เรียกใช้เมื่อใดก็ตามที่อ่านส่วนหนึ่งของเนื้อหาการตอบกลับ ระบบอาจป้อนข้อมูลบัฟเฟอร์เพียงบางส่วน แม้ว่าเนื้อหาการตอบสนองทั้งหมดจะยังไม่ได้ใช้ก็ตาม บัฟเฟอร์พร้อมสำหรับการอ่านแล้ว ระบบจะนำบัฟเฟอร์กลับมาใช้ซ้ำภายใน ดังนั้นคลาสที่ใช้จึงไม่ควรจัดเก็บบัฟเฟอร์หรือใช้บัฟเฟอร์ในที่อื่นนอกเหนือจากการใช้งานเมธอดนี้

พารามิเตอร์
UrlResponseInfo info

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

ByteBuffer bodyChunk

บัฟเฟอร์ที่มีข้อมูลที่ได้รับ ซึ่งพลิกเพื่ออ่าน

ส่ง
java.lang.Exception

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

onCanceled

protected abstract void onCanceled(@Nullable UrlResponseInfo info)

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

พารามิเตอร์
@Nullable UrlResponseInfo info

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

onFailed

protected abstract void onFailed(@Nullable UrlResponseInfo info, CronetException exception)

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

พารามิเตอร์
@Nullable UrlResponseInfo info

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

CronetException exception

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

onResponseStarted

protected abstract void onResponseStarted(UrlResponseInfo info)

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

พารามิเตอร์
UrlResponseInfo info

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

ส่ง
java.lang.Exception

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

onSucceeded

protected abstract void onSucceeded(UrlResponseInfo info)

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

พารามิเตอร์
UrlResponseInfo info

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

shouldFollowRedirect

protected abstract boolean shouldFollowRedirect(UrlResponseInfo info, String newLocationUrl)

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

พารามิเตอร์
UrlResponseInfo info

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

String newLocationUrl

ตำแหน่งที่คำขอเปลี่ยนเส้นทาง

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

เป็นจริงหากควรติดตามการเปลี่ยนเส้นทาง เป็นเท็จหากควรงยกเลิกคำขอ

ส่ง
java.lang.Exception

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