[CDRIVER-4305] ChangeStream Spec: fullDocument field in ChangeStreamOptions should be an optional to handle "default" case. Created: 09/Mar/22  Updated: 06/Jun/22  Resolved: 25/May/22

Status: Closed
Project: C Driver
Component/s: None
Affects Version/s: None
Fix Version/s: 1.22.0, 1.22.0-beta0

Type: Spec Change Priority: Major - P3
Reporter: PM Bot Assignee: Colby Pike
Resolution: Done Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Depends
is depended on by CDRIVER-4279 Do not error when parsing change stre... Backlog
Issue split
split from DRIVERS-2231 ChangeStream Spec: fullDocument field... Closed
Related
Upstream Changes Summary:

DRIVERS-2231:
Currently, the ChangeStream spec defines the fullDocument field in ChangeStreamOptions as a String that defaults to the string literal "default". As of server version 3.6, sending "default" and sending no fullDocument field have identical behavior, so fullDocument should be defined as an Optional<String> to avoid using the "default" string literal.

Drivers should sync legacy change streams tests to mongodb/specifications@31edce6 and legacy retryable reads tests to mongodb/specifications@006a4f1 .


 Description   

This ticket was split from DRIVERS-2231, please see that ticket for a detailed description.



 Comments   
Comment by Githook User [ 25/May/22 ]

Author:

{'name': 'vector-of-bool', 'email': 'vectorofbool@gmail.com', 'username': 'vector-of-bool'}

Message: CDRIVER-4305: 'fullDocument' may be null/omitted (#1010)

This commit implements CDRIVER-4305, which allows fullDocument to be
NULL equivalent to a literal "default" string. This is permitted in
server 3.6+, and this change makes that the preferred and default
behavior.

This driver already requires 3.6 or newer (as per minWireVersion)
Branch: master
https://github.com/mongodb/mongo-c-driver/commit/8bc2fd71e22da9bc25fcfdf3016966273e841406

Comment by Jeremy Mikola [ 01/Apr/22 ]

kevin.albertson: I reverted this to "Needs Triage", since it will be a prerequisite for DRIVERS-1713 and DRIVERS-1995. We don't yet have language tickets for DRIVERS-1713, but I'll add a relationship to the language ticket for DRIVERS-1995.

Generated at Wed Feb 07 21:20:32 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.