एक Publisher अपने सब्सक्राइबर्स से प्राप्त मांग के अनुसार क्रमबद्ध तत्वों की असीमित संख्या का प्रदाता है। Publisher<T> इंटरफेस प्रकार T के तत्वों को प्रकाशित करने के लिए जिम्मेदार है और सब्सक्राइबर्स को इससे जुड़ने के लिए एक subscribe() विधि प्रदान करता है।
public interface Publisher<T> { public void subscribe(Subscriber<? super T> s); } Publisher इंटरफेस के नियम:
- Publisher द्वारा Subscriber को संकेतित onNext() विधियों की कुल संख्या, सभी समय में सब्सक्राइबर के Subscription द्वारा अनुरोधित तत्वों की कुल संख्या से कम या बराबर होनी चाहिए।
- एक Publisher अनुरोधित से कम onNext() विधियों को संकेतित कर सकता है, और onComplete() या onError() विधियों को कॉल करके Subscription को समाप्त कर सकता है।
- एक Subscriber को संकेतित onSubscribe(), onNext(), onError(), और onComplete() विधियों को क्रमिक रूप से संकेतित किया जाना चाहिए।
- यदि Publisher विफल होता है, तो उसे onError() विधि का संकेत देना चाहिए।
- यदि Publisher सफलतापूर्वक समाप्त होता है, तो उसे onComplete() विधि का संकेत देना चाहिए।
- यदि Publisher Subscriber पर onError() या onComplete() विधि का संकेत देता है, तो सब्सक्राइबर की Subscription रद्द कर दी जानी चाहिए।
- एक बार टर्मिनल स्टेट संकेतित हो जाने पर (onError(), onComplete()), यह आवश्यक है कि कोई और सिग्नल न हो।
- यदि Subscription रद्द कर दी जाती है, तो उसका Subscriber संकेतित होना बंद कर देना चाहिए।
- Publisher.subscribe() विधि को प्रदान किए गए Subscriber पर किसी अन्य सिग्नल से पहले onSubscribe() विधि को कॉल करना चाहिए और सामान्य रूप से वापस लौटना चाहिए, सिवाय जब प्रदान किया गया Subscriber null हो। इस मामले में, इसे कॉलर को NullPointerException फेंकना चाहिए।
- Publisher.subscribe() विधि को आवश्यकतानुसार कई बार कॉल किया जा सकता है, हर बार एक अलग Subscriber के साथ।
- एक Publisher कई सब्सक्राइबर्स का समर्थन कर सकता है और तय करता है कि प्रत्येक Subscription यूनिकास्ट या मल्टीकास्ट हो सकती है।