-
Notifications
You must be signed in to change notification settings - Fork 1.5k
Add Javadoc to specify that CSOT does not limit socket writes #1791
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -716,6 +716,9 @@ public Builder inetAddressResolver(@Nullable final InetAddressResolver inetAddre | |
| * <li>{@code > 0} The time limit to use for the full execution of an operation.</li> | ||
| * </ul> | ||
| * | ||
| * <p><strong>NOTE:</strong> When using synchronous API, this timeout does not limit socket writes, therefore there is a possibility that the | ||
| * operation might not be timed out when expected. This limitation does not apply to the reactive streams API. | ||
|
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. We should also add this note to the The same suggestion applies to the rest of the |
||
| * | ||
| * @param timeout the timeout | ||
| * @param timeUnit the time unit | ||
| * @return this | ||
|
|
||
|
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. We should revert the changes to |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -78,6 +78,9 @@ public open class MongoCluster protected constructor(private val wrapped: JMongo | |
| * - `0` means infinite timeout. | ||
| * - `> 0` The time limit to use for the full execution of an operation. | ||
| * | ||
| * <p><strong>NOTE:</strong> This timeout does not limit socket writes, therefore there is a possibility that the | ||
|
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. To be consistent with the majority of API notes in the The same suggestion applies to the |
||
| * operation might not be timed out when expected. | ||
| * | ||
| * @return the optional timeout duration | ||
| */ | ||
| @Alpha(Reason.CLIENT) | ||
|
|
@@ -131,6 +134,9 @@ public open class MongoCluster protected constructor(private val wrapped: JMongo | |
| * - `0` means an infinite timeout | ||
| * - `> 0` The time limit to use for the full execution of an operation. | ||
| * | ||
| * <p><strong>NOTE:</strong> This timeout does not limit socket writes, therefore there is a possibility that the | ||
| * operation might not be timed out when expected. | ||
| * | ||
| * @param timeout the timeout, which must be greater than or equal to 0 | ||
| * @param timeUnit the time unit, defaults to Milliseconds | ||
| * @return a new MongoCluster instance with the set time limit for operations | ||
|
|
||
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
|
|
@@ -1370,6 +1370,9 @@ public Builder srvServiceName(final String srvServiceName) { | |||||
| * <li>{@code > 0} The time limit to use for the full execution of an operation.</li> | ||||||
| * </ul> | ||||||
| * | ||||||
| * <p><strong>Note:</strong> This timeout does not limit socket writes, therefore there is a possibility that the | ||||||
|
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. To be consistent with the rest of the API notes in this class, then we should say
Suggested change
|
||||||
| * operation might not be timed out when expected. | ||||||
|
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. We should also add this note to the |
||||||
| * | ||||||
| * @param timeoutMS the timeout in milliseconds | ||||||
| * @return this | ||||||
| * @since 5.2 | ||||||
|
|
||||||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -169,6 +169,9 @@ public interface MongoCluster { | |
| * <li>{@code > 0} The time limit to use for the full execution of an operation.</li> | ||
| * </ul> | ||
| * | ||
| * <p><strong>NOTE:</strong> This timeout does not limit socket writes, therefore there is a possibility that the | ||
|
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. To be consistent with the majority of API notes in the The same suggestion applies to the rest of the |
||
| * operation might not be timed out when expected. | ||
|
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. We should also add this note to the The same suggestion applies to the rest of the |
||
| * | ||
| * @param timeout the timeout, which must be greater than or equal to 0 | ||
| * @param timeUnit the time unit | ||
| * @return a new MongoCluster instance with the set time limit for the full execution of an operation. | ||
|
|
||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -104,6 +104,9 @@ public interface GridFSBucket { | |
| * <li>{@code > 0} The time limit to use for the full execution of an operation.</li> | ||
| * </ul> | ||
| * | ||
| * <p><strong>NOTE:</strong> This timeout does not limit socket writes, therefore there is a possibility that the | ||
|
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. To be consistent with the majority of API notes in the com.mongodb package, we should say The same suggestion applies to the |
||
| * operation might not be timed out when expected. | ||
| * | ||
| * @param timeUnit the time unit | ||
| * @return the timeout in the given time unit | ||
| * @since 4.x | ||
|
|
@@ -155,6 +158,9 @@ public interface GridFSBucket { | |
| * <li>{@code > 0} The time limit to use for the full execution of an operation.</li> | ||
| * </ul> | ||
| * | ||
| * <p><strong>NOTE:</strong> This timeout does not limit socket writes, therefore there is a possibility that the | ||
| * operation might not be timed out when expected. | ||
| * | ||
| * @param timeout the timeout, which must be greater than or equal to 0 | ||
| * @param timeUnit the time unit | ||
| * @return a new GridFSBucket instance with the set time limit for the full execution of an operation | ||
|
|
||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
To be consistent with the majority of API notes in the
com.mongodbpackage, we should say<p>Note: When....The same suggestion applies to the rest of the
driver-core/src/main/com/mongodbfiles modified in the PR.