Home

MongoDB Module for Coldbox

CBMongoDB applies an Active Record to manage MongoDB documents and schema using a familiar syntax for CRUD operations, recordset processing and retrieval. It makes direct use of and provides a CFML interface to the Mongo 3.0 Java driver for advanced operations.

• Compatibility: ColdFusion 9.0.1+/Lucee 4.2+ w/ Coldbox 4+
• Module Version: 3.1.0.3 (Release Date: 12/12/2015)
• Mongo Java Driver Version: 3.1.0
• Compatibility Note: This module is no longer compatible with the CFMongoDB module, due to conflicting configuration keys.

Changelog:

Patch v3.2.0.3

1. Fixes issues with ACF Compatibility

Patch v3.2.0.2

1. Fixes issues with unexpected driver return types
2. Adds offset() helper method (alias for set_offset()) to ActiveEntity
3. Adds isObjectId() helper method to MongoUtil for detecting whether an object is a Mongo _id string

Patch v3.2.0.1

1. Fixes issues with module load/unload connection operations
2. Adds GridFS operational support
3. Adds GridFS FileEntity model
4. Fixes issues with _id queries not being typed appropriately
5. Fixes error when attempting to truncate a collection

Release v3.2.0.0

1. Updates MongoDB Java driver to version 3.2.0
2. Adds support for readConcern configuration option

Patch v3.1.0.4:

1. Adds validation methods for entities and support for new property ForceValidation, which will prevent saving of documents which do not validate
2. Adds auto-normalization capabilities for schema properties. When attributes are configured, schema will auto-normalize when set() and populate() methods are called.
3. Implements full support for component accessors on all schema properties. Var safe accessor closures are generated to allow recursion through an underscore delimiter (e.g. getFirstLevel_SecondLevel() to retrieve getDocument().FirstLevel.SecondLevel)
4. Fixes native CFML data types not being sanitized on deeply nested structs and arrays.
5. Add getDocument() and asStruct() utility methods, which can be used on unloaded and unloaded entities.
6. Adds append() and prepend() functions to assit in managing document schema arrays.
7. Fixes issues with property maps not being defined correctly and correct casting of boolean property defaults.
8. Adds MongoIndexer singleton to delegate index management away from Entity instances.

Patch v3.1.0.3:

1. Fixes issue with connections not being pooled accurately and adds connection closing to module unload
2. Moves module bindings to onLoad() to ensure availability of cbjavaloader module
3. Changes return type of all single record retrievals inserts and updates to native structs and adds auto-stringification of _id (eliminates the need for toString())
4. Ensures version of returned object from findOneAndUpdate/findOneAndReplace operations is the after-save version

Major Release v3.1.0:

1. Removes Requirement For CFMongoDB Module
2. Adds Requirement for CBJavaloader Module
3. Implements MongoDB 3.0 Driver
4. Implements the ability to use multiple databases
5. Implements the ability to configure databases at the entity level
6. Implements Native Collection Methods for the 3.0 MongoCollection
7. Implements CFML Aggregation methods while allowing direct access to native driver methods
8. Implements CFML Map-Reduce methods
9. Demonstrates 52% reduction in query execution times and database operations from the previous version
10. Implements handlers for API documentation (/cmbongodb/docs) and Unit Tests (/cbmongodb/tests)
11. Fixes issue with near() GEOSpatial operations on Polygon objects
12. Re-factors Test Suite to Require the Framework Context
13. Adds an asJSON argument to find() and findAll() entity queries
14. Encapsulates all Collection Result queries to provide the following delivery methods: .asResult() - MongoIterable, .asCursor() - MongoIterator, .asArray(), asJSON()