MongoGridfsfind()

Finds a given file(s) from the Mongo GridFS bucket. You can get the file specifying either file name, _id or a query. You can download the actual file using MongoGridFSGet()

Usage

ARRAY = MongoGridfsfind( datasource, bucket, filename, query )
Argument Summary
datasource datasource name. Name previously created using MongoRegister
bucket GridFS bucket name
filename the name of the files to find [defaults]
query the query to find [optional]

Calling

Supports named-parameter calling allowing you to use the function like:

MongoGridfsfind(
   datasource=?, 
   bucket=?, 
   filename=?, 
   query=?
);

Supports passing parameters as a structure using ArgumentCollection:

MongoGridfsfind( ArgumentCollection={
   datasource : ?, 
   bucket : ?, 
   filename : ?, 
   query : ?
} );

Extra

For more information on using MongoDB, visit the MongoCFML page

For functions that update data, you can pass in the writeconcern. The possible values are:

  • FSYNC_SAFE
    Exceptions are raised for network issues, and server errors; the write operation waits for the server to flush the data to disk
  • JOURNAL_SAFE
    Exceptions are raised for network issues, and server errors; the write operation waits for the server to group commit to the journal file on disk
  • MAJORITY
    Exceptions are raised for network issues, and server errors; waits on a majority of servers for the write operation
  • NONE
    No exceptions are raised, even for network issues
  • NORMAL
    Exceptions are raised for network issues, but not server errors
  • REPLICAS_SAFE
    Exceptions are raised for network issues, and server errors; waits for at least 2 servers for the write operation
  • SAFE
    Exceptions are raised for network issues, and server errors; waits on a server for the write operation