ImplicitFlowControlCallback

public abstract class ImplicitFlowControlCallback extends UrlRequest.Callback

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

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

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

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

अगर रीडायरेक्ट को फ़ॉलो करना है, तो true. अगर अनुरोध को रद्द करना है, तो false.

थ्रो
java.lang.Exception

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