[JAVA-3961] Docs: Clarify cold publishers Created: 26/Jan/21  Updated: 26/Jan/21  Resolved: 26/Jan/21

Status: Closed
Project: Java Driver
Component/s: Documentation, Reactive Streams
Affects Version/s: None
Fix Version/s: None

Type: Bug Priority: Minor - P4
Reporter: Ross Lawley Assignee: Ross Lawley
Resolution: Done Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Issue split
split from JAVA-3907 AsyncQueryBatchCursor does not releas... Closed
Related
is related to JAVA-3963 Document publisher properties in API ... Closed

 Description   

All Publishers returned from the API are cold, meaning that no I/O happens until they are subscribed to and the subscription makes a request. So just creating a Publisher won’t cause any network IO. It’s not until Subscription.request() is called that the driver executes the operation.

This is incorrect as its the subscription that may trigger i/o see: Hot Versus Cold with cold publishers nothing happens before you subscribe - regardless of the initial demand. So some IO may occur on subscribe, determining sessions / creating cursors.



 Comments   
Comment by Githook User [ 26/Jan/21 ]

Author:

{'name': 'Ross Lawley', 'email': 'ross.lawley@gmail.com', 'username': 'rozza'}

Message: Docs: Reactive streams clarify cold publishers (#645)

JAVA-3961
Branch: master
https://github.com/mongodb/mongo-java-driver/commit/a9dfbbf19aba1c6e41283db87d5ef5ed4acd6eec

Comment by Ross Lawley [ 26/Jan/21 ]

https://github.com/mongodb/mongo-java-driver/pull/645

Generated at Thu Feb 08 09:00:53 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.