UrlRequest.Callback

public abstract class UrlRequest.Callback

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

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

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

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

यह InMemoryTransformCronetCallback का एक खास वर्शन है, जो रिस्पॉन्स बॉडी को JSON के तौर पर इंटरप्रेट करता है.
StringCronetCallback

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

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

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

खास जानकारी

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

पब्लिक मेथड
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

इस फ़ंक्शन को तब कॉल किया जाता है, जब अनुरोध पूरा हो जाता है.

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

कॉलबैक

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() के बीच कॉल करने पर लागू किया जाएगा. अगर रीडायरेक्ट किए गए जवाब में कोई बॉडी है, तो उसे अनदेखा कर दिया जाएगा. जब तक URLRequest के followRedirect तरीके को सिंक्रोनस या एसिंक्रोनस रूप से कॉल नहीं किया जाता, तब तक रीडायरेक्ट नहीं किया जाएगा.

पैरामीटर
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

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