MongoGridFSMBS.Chunks as MongoCollectionMBS

Var GridFS As MongoGridFSMBS = Client.GridFS("test", "fs")
Var chunks As MongoCollectionMBS = GridFS.Chunks

// now request content and inspect it
Var item As MongoCursorMBS = chunks.Find("{}")
Var items As String = item.Records
Break

This instance is owned by the GridFS instance and should not be modified or freed.

MongoGridFSMBS.Constructor   Private

MongoGridFSMBS.CreateFile(options as MongoGridFSFileOptionsMBS) as MongoGridFSFileMBS

Var GridFS As MongoGridFSMBS = Client.GridFS("test", "fs")

Var options As New MongoGridFSFileOptionsMBS
options.FileName = "test.txt"
options.ContentType = "text/plain"

Var file As MongoGridFSFileMBS = GridFS.CreateFile(options)
Var BytesWritten As Integer = file.Write("Hello World")
file.Save

MongoGridFSMBS.CreateFileFromStream(stream as MongoStreamMBS, options as MongoGridFSFileOptionsMBS) as MongoGridFSFileMBS

// create a file from a file on disk
Var options As New MongoGridFSFileOptionsMBS
options.FileName = "test.pdf"
options.ContentType = "application/pdf"

Var stream As MongoStreamMBS = MongoStreamMBS.NewStreamFromPath("/Users/cs/Desktop/Installation.pdf")
Var file As MongoGridFSFileMBS = GridFS.CreateFileFromStream(stream, options)

Note that this function will read from stream until End of File, making it best suited for file-backed streams.

Some examples using this method:

• /MongoDB/MongoDB Test

MongoGridFSMBS.Drop

MongoGridFSMBS.Files as MongoCollectionMBS

Var GridFS As MongoGridFSMBS = Client.GridFS("test", "fs")
Var Files As MongoCollectionMBS = GridFS.Files

// now request content and inspect it
Var item As MongoCursorMBS = Files.Find("{}")
Var items As String = item.Records
Break

MongoGridFSMBS.Find(filterJSON as String, OptionsJSON as String = "") as MongoGridFSFileListMBS

You can iterate the matched gridfs files with the resulting file list.

See Find() in MongoCollectionMBS for a description of the filter and opts parameters.

This function is considered a retryable read operation. Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. If retryreads is false in the URI, the retry behavior does not apply.

MongoGridFSMBS.Find2(filterJSON as String, OptionsJSON as String = "") as MongoGridFSFileMBS()

// find all files
Var GridFS As MongoGridFSMBS = Client.GridFS("test", "fs")
Var files() As MongoGridFSFileMBS = GridFS.Find2("{}")

Same as Find() but returns a Xojo array with all files.

MongoGridFSMBS.FindOne(filterJSON as String, OptionsJSON as String = "") as MongoGridFSFileMBS

If there is an error, nil is returned and an exception is reported; if there is no error but no matching file is found, nil is returned.

See Find() for a description of the filter and opts parameters.

This function is considered a retryable read operation. Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. If retryreads is false in the URI, the retry behavior does not apply.

MongoGridFSMBS.FindOneByFileName(FileName as String) as MongoGridFSFileMBS

Var GridFS As MongoGridFSMBS = Client.GridFS("test", "fs")

// now find the file and read it
Var file As MongoGridFSFileMBS = GridFS.FindOneByFileName( "test.txt")
Var data As String = file.ReadAll

If there is an error, nil is returned and an exception is raised; if there is no error but no matching file is found, nil is returned.

This function is considered a retryable read operation. Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. If retryreads is false in the URI the retry behavior does not apply.

Some examples using this method:

• /MongoDB/MongoDB Test

MongoGridFSMBS.RemoveByFileName(Name as String)

Returns true if successful, including when no files match. Returns false and raises exception if there are invalid arguments or a server or network error.