UrlRequest.Callback

abstract class UrlRequest.Callback

इस क्लास से सीधे इनहेरिट करने वाली ज्ञात सबक्लास
ImplicitFlowControlCallback

UrlRequest.Callback का एक ऐसा लागू करने का तरीका जिससे अनुरोध के लाइफ़साइकल को मैनेज करने की मुश्किल कम हो जाती है. साथ ही, यह जवाब को पूरी तरह से अपने-आप पढ़ता है.
इस क्लास से सीधे इनहेरिट न करने वाली ज्ञात सबक्लास
ByteArrayCronetCallback

InMemoryTransformCronetCallback का एक खास वर्शन. यह जवाब के बाइट को बिना किसी बदलाव के दिखाता है.
InMemoryTransformCronetCallback

एक ऐब्स्ट्रैक्ट क्रोनेट कॉलबैक, जो पूरे जवाब को मेमोरी में पढ़ता है. साथ ही, एचटीटीपी अनुरोध जारी करने वाले को वापस भेजने से पहले, जवाब को डीसीरियलाइज़ भी कर सकता है.
JsonCronetCallback

InMemoryTransformCronetCallback का एक खास वर्शन, जो जवाब को JSON के तौर पर दिखाता है.
StringCronetCallback

InMemoryTransformCronetCallback का एक खास वर्शन, जो जवाब को स्ट्रिंग के तौर पर दिखाता है.

Cronet के उपयोगकर्ता, इस क्लास को बढ़ाकर UrlRequest को प्रोसेस करने की प्रोसेस की जानकारी देने वाले कॉलबैक पा सकते हैं. इस क्लास का एक इंस्टेंस, UrlRequest.Builder के कंस्ट्रक्टर में पास किया जाता है, जब UrlRequest बनाया जाता है.

ध्यान दें: सभी तरीकों को, UrlRequest बनाते समय इस्तेमाल किए गए java.util.concurrent.Executor के थ्रेड पर लागू किया जाएगा.

खास जानकारी

सार्वजनिक कंस्ट्रक्टर

सार्वजनिक फ़ंक्शन
Unit
onCanceled(request: UrlRequest!, info: UrlResponseInfo!)

अगर cancel के ज़रिए अनुरोध रद्द किया गया, तो इसे लागू किया जाता है.
abstract Unit
onFailed(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    error: CronetException!
)

start के बाद, किसी भी वजह से अनुरोध पूरा न होने पर, इसे लागू किया जाता है.
abstract Unit
onReadCompleted(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    byteBuffer: ByteBuffer!
)

जवाब के किसी हिस्से को पढ़ने पर, इसे लागू किया जाता है.
abstract Unit
onRedirectReceived(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    newLocationUrl: String!
)

रीडायरेक्ट होने पर, इसे लागू किया जाता है.
abstract Unit

सभी रीडायरेक्ट के बाद, हेडर का फ़ाइनल सेट मिलने पर, इसे लागू किया जाता है.
abstract Unit
onSucceeded(request: UrlRequest!, info: UrlResponseInfo!)

अनुरोध सफलतापूर्वक पूरा होने पर, इसे लागू किया जाता है.

सार्वजनिक कंस्ट्रक्टर

Callback

Callback()

सार्वजनिक फ़ंक्शन

onCanceled

fun onCanceled(request: UrlRequest!, info: UrlResponseInfo!): Unit

अगर cancel के ज़रिए अनुरोध रद्द किया गया, तो इसे लागू किया जाता है. इसे लागू करने के बाद, Callback के अन्य तरीकों को लागू नहीं किया जाएगा. डिफ़ॉल्ट तौर पर, यह कोई कार्रवाई नहीं करता.

पैरामीटर
request: UrlRequest!

रद्द किया गया अनुरोध.
info: UrlResponseInfo!

जवाब की जानकारी. अगर कोई जवाब नहीं मिला, तो यह null हो सकता है.

onFailed

abstract fun onFailed(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    error: CronetException!
): Unit

start के बाद, किसी भी वजह से अनुरोध पूरा न होने पर, इसे लागू किया जाता है. इसे लागू करने के बाद, Callback के अन्य तरीकों को लागू नहीं किया जाएगा. error से, अनुरोध पूरा न होने की वजह के बारे में जानकारी मिलती है.

पैरामीटर
request: UrlRequest!

अनुरोध पूरा नहीं हुआ.
info: UrlResponseInfo!

जवाब की जानकारी. अगर कोई जवाब नहीं मिला, तो यह null हो सकता है.
error: CronetException!

गड़बड़ी के बारे में जानकारी.

onReadCompleted

abstract fun onReadCompleted(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    byteBuffer: ByteBuffer!
): Unit

जवाब के किसी हिस्से को पढ़ने पर, इसे लागू किया जाता है. बफ़र का सिर्फ़ कुछ हिस्सा भरा जा सकता है. भले ही, जवाब का पूरा हिस्सा इस्तेमाल न किया गया हो. onCanceled() को छोड़कर, अनुरोध के लिए Callback का कोई अन्य तरीका लागू नहीं किया जाएगा. इनमें onSucceeded() और onFailed() भी शामिल हैं. ऐसा तब तक होगा, जब तक UrlRequest.read() को जवाब के बाकी हिस्से को पढ़ने के लिए कॉल नहीं किया जाता.

पैरामीटर
request: UrlRequest!

वह अनुरोध जिसे डेटा मिला.
info: UrlResponseInfo!

जवाब की जानकारी.
byteBuffer: ByteBuffer!

वह बफ़र जिसे UrlRequest.read() में पास किया गया था. इसमें अब मिला हुआ डेटा शामिल है. बफ़र की पोज़िशन, मिले हुए डेटा के आखिर तक अपडेट हो जाती है. बफ़र की सीमा में कोई बदलाव नहीं किया जाता.
थ्रॉ
java.lang.Exception

अगर जवाब के किसी हिस्से को पढ़ने की प्रोसेस पूरी करते समय कोई गड़बड़ी होती है. onFailed को, थ्रो किए गए अपवाद के साथ कॉल किया जाएगा. इसे CallbackException की वजह के तौर पर सेट किया जाएगा.

onRedirectReceived

abstract fun onRedirectReceived(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    newLocationUrl: String!
): Unit

रीडायरेक्ट होने पर, इसे लागू किया जाता है. इसे सिर्फ़ start और onResponseStarted() के बीच कॉल किया जाएगा. रीडायरेक्ट जवाब के मुख्य हिस्से को अनदेखा किया जाएगा. जब तक URLRequest के followRedirect तरीके को सिंक्रोनस या एसिंक्रोनस तरीके से कॉल नहीं किया जाता, तब तक रीडायरेक्ट को फ़ॉलो नहीं किया जाएगा.

पैरामीटर
request: UrlRequest!

रीडायरेक्ट किया जा रहा अनुरोध.
info: UrlResponseInfo!

जवाब की जानकारी.
newLocationUrl: String!

वह जगह जहां अनुरोध रीडायरेक्ट किया गया है.
थ्रॉ
java.lang.Exception

अगर रीडायरेक्ट की प्रोसेस पूरी करते समय कोई गड़बड़ी होती है. onFailed को, थ्रो किए गए अपवाद के साथ कॉल किया जाएगा. इसे CallbackException की वजह के तौर पर सेट किया जाएगा.

onResponseStarted

abstract fun onResponseStarted(request: UrlRequest!, info: UrlResponseInfo!): Unit

सभी रीडायरेक्ट के बाद, हेडर का फ़ाइनल सेट मिलने पर, इसे लागू किया जाता है. इसे हर अनुरोध के लिए सिर्फ़ एक बार लागू किया जाएगा. onCanceled() को छोड़कर, अनुरोध के लिए Callback का कोई अन्य तरीका लागू नहीं किया जाएगा. इनमें onSucceeded() और onFailed() भी शामिल हैं. ऐसा तब तक होगा, जब तक UrlRequest.read() को जवाब के मुख्य हिस्से को पढ़ने के लिए कॉल नहीं किया जाता.

पैरामीटर
request: UrlRequest!

वह अनुरोध जिसके लिए जवाब मिलना शुरू हुआ.
info: UrlResponseInfo!

जवाब की जानकारी.
थ्रॉ
java.lang.Exception

अगर जवाब मिलने की प्रोसेस शुरू करते समय कोई गड़बड़ी होती है. onFailed को, थ्रो किए गए अपवाद के साथ कॉल किया जाएगा. इसे CallbackException की वजह के तौर पर सेट किया जाएगा.

onSucceeded

abstract fun onSucceeded(request: UrlRequest!, info: UrlResponseInfo!): Unit

अनुरोध सफलतापूर्वक पूरा होने पर, इसे लागू किया जाता है. इसे लागू करने के बाद, Callback के अन्य तरीकों को लागू नहीं किया जाएगा.

पैरामीटर
request: UrlRequest!

अनुरोध पूरा हुआ.
info: UrlResponseInfo!

जवाब की जानकारी.