एक Subscription डेटा एक्सचेंज की मध्यस्थता के उद्देश्य से ठीक एक Publisher और एक Subscriber द्वारा साझा किया जा सकता है। यही कारण है कि subscribe() विधि निर्मित Subscription को वापस नहीं करती, बल्कि void लौटाती है। Subscription को केवल onSubscribe() विधि कॉलबैक के माध्यम से Subscriber को पास किया जाता है। Subscription इंटरफेस में दो विधियां होती हैं: request() और cancel()।
सिंटैक्स
public interface Subscription { public void request(long n); public void cancel(); } Subscription इंटरफेस के नियम:
- Subscription.request() और Subscription.cancel() विधियों को केवल इसके Subscriber संदर्भ के अंदर ही कॉल किया जाना चाहिए।
- Subscription को Subscriber को onNext() या onSubscribe() विधियों के भीतर से Subscription.request() विधि को सिंक्रोनस रूप से कॉल करने की अनुमति देनी चाहिए।
- Subscription.request() विधि को Publisher और Subscriber के बीच संभावित सिंक्रोनस रिकर्सन पर एक ऊपरी सीमा रखनी चाहिए।
- Subscription.request() विधि को अपने कॉलर की प्रतिक्रियाशीलता का सम्मान करना चाहिए और समय पर वापस लौटना चाहिए।
- Subscription.cancel() विधि को अपने कॉलर की प्रतिक्रियाशीलता का सम्मान करना चाहिए, समय पर वापस लौटना चाहिए, और थ्रेड-सेफ होना चाहिए।
- जब तक Subscription रद्द नहीं की जाती, Subscription.request(long n) विधि को संबंधित सब्सक्राइबर को उत्पादित किए जाने वाले अतिरिक्त तत्वों की दी गई संख्या को पंजीकृत करना चाहिए।
- जब तक Subscription रद्द नहीं की जाती, Subscription.request(long n) विधि को IllegalArgumentException के साथ onError() विधि को कॉल करना चाहिए यदि तर्क <= 0 है।
- जब तक Subscription रद्द नहीं की जाती, Subscription.request(long n) विधि इस या अन्य सब्सक्राइबर्स पर onNext() विधि को सिंक्रोनस रूप से कॉल कर सकती है।
- जब तक Subscription रद्द नहीं की जाती, Subscription.request(long n) विधि इस या अन्य सब्सक्राइबर्स पर onComplete() या onError() विधियों को सिंक्रोनस रूप से कॉल कर सकती है।
- जब तक Subscription रद्द नहीं की जाती, Subscription.cancel() विधि को Publisher से अपने Subscriber को सिग्नल करना बंद करने का अनुरोध करना चाहिए। ऑपरेशन को तुरंत Subscription को प्रभावित करने की आवश्यकता नहीं है।
- जब तक Subscription रद्द नहीं की जाती, Subscription.cancel() विधि को Publisher से संबंधित सब्सक्राइबर के किसी भी संदर्भ को छोड़ने का अनुरोध करना चाहिए।
- Subscription.cancel() और Subscription.request() विधियों को कॉल करना सामान्य रूप से वापस लौटना चाहिए।
- Subscription को request के असीमित संख्या में कॉल का समर्थन करना चाहिए और 2^63-1 तक की मांग का समर्थन करना चाहिए। यदि मांग 2^63-1 के बराबर या उससे अधिक है, तो Publisher द्वारा इसे प्रभावी रूप से असीमित माना जा सकता है।