Some documentation

christophstrobl · christophstrobl · commit 7a6f392b00eb · 2025-03-10T08:35:49.000+01:00
diff --git a/src/main/antora/modules/ROOT/pages/mongodb/mapping/custom-conversions.adoc b/src/main/antora/modules/ROOT/pages/mongodb/mapping/custom-conversions.adoc
@@ -103,3 +103,11 @@ class MyMongoConfiguration extends AbstractMongoClientConfiguration {
 	}
 }
 ----
+
+[[mongo.numeric-conversion]]
+== Big Number Format
+
+MongoDB in its early days did not have support for large numeric values such as `BigDecimal`.
+In order to persist values those types got converted into their `String` representation.
+Nowadays `org.bson.types.Decimal128` offers a native solution to storing big numbers.
+Next to influencing the to be stored numeric representation via the `@Field` annotation you can configure `MongoCustomConversions` to use `Decimal128` instead of `String` via the `MongoConverterConfigurationAdapter#numericFormat(...)` or set the `mongo.numeric.format=decimal128` property.

Original file line number	Diff line number	Diff line change
`@@ -103,3 +103,11 @@ class MyMongoConfiguration extends AbstractMongoClientConfiguration {`
`103`	`103`	`}`
`104`	`104`	`}`
`105`	`105`	`----`
	`106`	`+`
	`107`	`+[[mongo.numeric-conversion]]`
	`108`	`+== Big Number Format`
	`109`	`+`
	`110`	+MongoDB in its early days did not have support for large numeric values such as `BigDecimal`.
	`111`	+In order to persist values those types got converted into their `String` representation.
	`112`	+Nowadays `org.bson.types.Decimal128` offers a native solution to storing big numbers.
	`113`	+Next to influencing the to be stored numeric representation via the `@Field` annotation you can configure `MongoCustomConversions` to use `Decimal128` instead of `String` via the `MongoConverterConfigurationAdapter#numericFormat(...)` or set the `mongo.numeric.format=decimal128` property.