@@ -7,7 +7,7 @@ ______________________________________________________________________
77
88## Abstract
99
10- GridFS is a convention drivers use to store and retrieve BSON binary data (type "x05") that exceeds MongoDB" s
10+ GridFS is a convention drivers use to store and retrieve BSON binary data (type "x05") that exceeds MongoDB' s
1111BSON-document size limit of 16 MiB. When this data, called a ** user file** , is written to the system, GridFS divides the
1212file into ** chunks** that are stored as distinct documents in a ** chunks collection** . To retrieve a stored file, GridFS
1313locates and returns all of its component chunks. Internally, GridFS creates a ** files collection document** for each
@@ -30,7 +30,7 @@ The keywords "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SH
3030
3131** Bucket name**
3232
33- A prefix under which a GridFS system" s collections are stored. Collection names for the files and chunks collections are
33+ A prefix under which a GridFS system' s collections are stored. Collection names for the files and chunks collections are
3434prefixed with the bucket name. The bucket name MUST be configurable by the user. Multiple buckets may exist within a
3535single database. The default bucket name is "fs".
3636
@@ -621,25 +621,25 @@ the point at which the application stopped reading won't be detected by the driv
621621class GridFSBucket {
622622
623623 /**
624- * Given a @id, delete this stored file" s files collection document and
624+ * Given a @id, delete this stored file' s files collection document and
625625 * associated chunks from a GridFS bucket.
626626 */
627627 void delete (TFileId id);
628628
629629}
630630```
631631
632- Deletes the stored file" s files collection document and associated chunks from the underlying database.
632+ Deletes the stored file' s files collection document and associated chunks from the underlying database.
633633
634- As noted for download(), drivers that previously used id" s of a different type MAY implement a delete() method that
634+ As noted for download(), drivers that previously used id' s of a different type MAY implement a delete() method that
635635accepts that type, but MUST mark that method as deprecated.
636636
637637** Implementation details:**
638638
639639There is an inherent race condition between the chunks and files collections. Without some transaction-like behavior
640640between these two collections, it is always possible for one client to delete a stored file while another client is
641- attempting a read of the stored file. For example, imagine client A retrieves a stored file" s files collection document,
642- client B deletes the stored file, then client A attempts to read the stored file" s chunks. Client A wouldn"t find any
641+ attempting a read of the stored file. For example, imagine client A retrieves a stored file' s files collection document,
642+ client B deletes the stored file, then client A attempts to read the stored file' s chunks. Client A wouldn"t find any
643643chunks for the given stored file. To minimize the window of vulnerability of reading a stored file that is the process
644644of being deleted, drivers MUST first delete the files collection document for a stored file, then delete its associated
645645chunks.
@@ -798,7 +798,7 @@ return the bytes of the file in `[start, end)`. If "start" and "end" are equal n
798798If either "start" or "end" is invalid, drivers MUST raise an error. These values are considered invalid if they are
799799negative, greater than the file length, or if "start" is greater than "end".
800800
801- When performing partial reads, drivers SHOULD use the file" s "chunkSize" to calculate which chunks contain the desired
801+ When performing partial reads, drivers SHOULD use the file' s "chunkSize" to calculate which chunks contain the desired
802802section and avoid reading unneeded documents from the "chunks" collection.
803803
804804### Renaming stored files
@@ -814,7 +814,7 @@ class GridFSBucket {
814814}
815815```
816816
817- Sets the filename field in the stored file" s files collection document to the new filename.
817+ Sets the filename field in the stored file' s files collection document to the new filename.
818818
819819** Implementation details:**
820820
0 commit comments