Changelog

---

v2.1.9 🆕

👉 Go to Maven Repository

Release Date: 2025-07-18

• Optimized queries for entity fields with multi-dimensional collections
• Fixed $push method issue: 2D array cannot retrieve PushOptions
• Optimized one methods in CRUD operations
• Fixed conversion exception when document field type is an ObjectId collection
• Added BOM module
• Fixed @IgnoreLogic annotation not working
• Reduced warning log level for ObjectId conversion
• Optimized count to ignore custom conditions
• Fixed missing UpdateOptions in logical delete updates
• Optimized transaction exceptions to wrap properly
• Added reminder for inconsistent MongoDB driver versions
• Added keyword filtering feature

v2.1.8.1

Release Date: 2025-04-13

• Added custom codec support
• Optimized FieldChain and FreeFieldChain (not limited to lambda construction), more convenient than FunctionUtil
• Auto-fill now supports parent field backfill and skipping backfill
• Improved logical delete with better boolean compatibility
• Better GeoJSON type conversion support; entity classes recommended to use abstract class (Geometry)
• FunctionUtil now supports adding String type and specifying collection name via Class
• Added conversion support for collections of ObjectId

v2.1.8

Release Date: 2025-04-10

• Added GeoJSON operations
• Auto-fill fields now support automatic backfill
• @CollectionField annotation added isObjectId property
• Optimized logical delete with custom data types
• Added nested field builder, FieldChain
• Fixed null fields in concurrent query results
• Fixed optimistic lock retry strategy
• Fixed transaction propagation issues

v2.1.7

Release Date: 2025-03-04

• Added DBRef support
• $push supports options
• Added field-level ignoreNull via @CollectionField
• Optimized ignoring logical delete for specific collections
• in condition now supports enums
• Fixed multi-tenant logical ignore
• Fixed logical delete and tenant aggregate concatenation
• Fixed multi-module automatic index creation scanning issues
• Optimized exception throwing
• Optimized auto-fill related issues
• Fixed SpringBoot 3+ bean scanning errors
• Enhanced data backup methods
• UpdateWrapper added setNull method

v2.1.6.1

Release Date: 2024-12-20

• Optimized enum mapper
• Optimized auto-fill under high concurrency
• Local data backup now returns path
• Fixed path issues in factories

v2.1.6

Release Date: 2024-12-17

• Added asynchronous data backup
• CollectionName annotation supports SPEL expressions
• Added multi-tenant manager with programmatic tenant ignore
• Added database backup
• Added advanced interceptor similar to MyBatis interceptor
• Added automatic enum mapping
• Added optimistic lock plugin with auto-retry
• Added command method for find or aggregate commands
• Added mapper and repository layers
• Fixed logical delete issues and field value auto-insertion
• Fixed bulkWrite NullPointerException
• Fixed index creation naming issues

v2.1.5

Release Date: 2024-11-11

• Added options to CRUD operations
• Added ID generator
• Added BigDecimal mapper
• Added new methods in MongoPlusBasicDBObject
• Enhanced lookup method
• Optimized logical condition construction
• Added combine method in condition builder
• Optimized auto-fill concurrency
• Interceptor supports count without condition
• Pipeline query supports single result
• Fixed SpringBoot async startup errors
• Fixed logical delete errors
• Fixed index logging errors

v2.1.4

Release Date: 2024-08-28

• Added automatic index creation
• Added automatic time-series collection creation
• Optimized like operations to be case-insensitive
• Added configuration encryption
• Added nested field builder
• Added pull and pullAll operators
• Improved documentation and sample project
• Optimized likeLeft and likeRight
• Fixed project operator issues
• Fixed other known issues

For detailed usage, refer to the documentation

v2.1.3

Release Date: 2024-08-09

• Restored default ID field storage type
• Fixed sort operator
• Optimized Spring transaction usage
• Optimized camelCase to underscore priority
• Added data change record plugin support for DB insertion

v2.1.2

Release Date: 2024-08-07

• Added unset, addToSet, pop and other operators
• BsonValue no longer auto-converted
• Improved query efficiency
• Auto-fill supports raw object info and forced writing
• Optimized expr operator and condition builder with custom conditions
• ObjectId auto-conversion now configurable
• PageResult enhancements
• IService supports saveOrUpdate and saveOrUpdateBatch with DB query
• Fixed ObjectId as ID type response and auto-backfill
• Fixed between concatenation
• CamelCase to underscore in conditions
• inc operator now accepts Number

TIP

• Deprecated annotations removed, including MongoPlusMapMapper and old pipeline builders

v2.1.1

Release Date: 2024-07-11

• Fixed two-dimensional array issues in in, nin, all
• Added multi-data source handler
• Added multi-data source manager with dynamic temporary data source
• Multi-data source annotations support SPEL

v2.1.0

Release Date: 2024-07-08

• Added multi-tenant plugin
• Added dynamic collection plugin
• Added data change record plugin
• Added field masking
• Added field encryption/decryption
• Added SSL connection support
• Added logical delete ignore annotation
• Added class-level data source switching
• update condition builder supports inc and setOnInsert
• IService and BaseMapper support Class/TypeReference parameters
• Fixed auto-fill content retention
• Fixed underscore to camelCase conversion
• Fixed exception handling in add/update
• Fixed ObjectId document storage
• Fixed Function field name retrieval
• Fixed _id condition handling
• Deprecated MongoPlusMapMapper in favor of BaseMapper