Deprecated API

Contents

• Terminally Deprecated
• Packages
• Interfaces
• Classes
• Enum Classes
• Methods
• Constructors
• Annotation Interface Elements

Terminally Deprecated Elements

Element	Description
org.springframework.data.mongodb.config.MappingMongoConverterParser.potentiallyCreateMappingContext(Element, ParserContext, BeanDefinition, String)	since 4.3. Use MappingMongoConverterParser.potentiallyCreateMappingContext(Element, ParserContext, BeanDefinition, String, boolean) instead.
org.springframework.data.mongodb.config.MongoJmxParser	since 4.5
org.springframework.data.mongodb.core.aggregation.AggregationOperationContext.continueOnMissingFieldReference()	since 4.3.1, FieldLookupPolicy should be specified explicitly when creating the AggregationOperationContext.
org.springframework.data.mongodb.core.aggregation.OutOperation.insertDocuments()	extended $out syntax was superseded by $merge. Support for the extended syntax has been removed with MongoDB 5, use MergeOperation instead.
org.springframework.data.mongodb.core.aggregation.OutOperation.mode(OutOperation.OutMode)	extended $out syntax was superseded by $merge. Support for the extended syntax has been removed with MongoDB 5, use MergeOperation instead.
org.springframework.data.mongodb.core.aggregation.OutOperation.OutMode	extended $out syntax was superseded by $merge. Support for the extended syntax has been removed with MongoDB 5, use MergeOperation instead.
org.springframework.data.mongodb.core.aggregation.OutOperation.replaceCollection()	extended $out syntax was superseded by $merge. Support for the extended syntax has been removed with MongoDB 5, use MergeOperation instead.
org.springframework.data.mongodb.core.aggregation.OutOperation.replaceDocuments()	extended $out syntax was superseded by $merge. Support for the extended syntax has been removed with MongoDB 5, use MergeOperation instead.
org.springframework.data.mongodb.core.aggregation.OutOperation.uniqueKey(String)	extended $out syntax was superseded by $merge. Support for the extended syntax has been removed with MongoDB 5, use MergeOperation instead.
org.springframework.data.mongodb.core.aggregation.OutOperation.uniqueKeyOf(Iterable<String>)	extended $out syntax was superseded by $merge. Support for the extended syntax has been removed with MongoDB 5, use MergeOperation instead.
org.springframework.data.mongodb.core.aggregation.TypeBasedAggregationOperationContext.continueOnMissingFieldReference()
org.springframework.data.mongodb.core.index.Indexed.expireAfterSeconds()	since 4.4 - Please use Indexed.expireAfter() instead.
org.springframework.data.mongodb.core.index.IndexOperations.ensureIndex(IndexDefinition)	since 4.5, in favor of IndexOperations.createIndex(IndexDefinition).
org.springframework.data.mongodb.core.index.ReactiveIndexOperations.ensureIndex(IndexDefinition)	since 4.5, in favor of ReactiveIndexOperations.createIndex(IndexDefinition).
org.springframework.data.mongodb.core.MongoAdmin	since 4.5
org.springframework.data.mongodb.core.MongoAdminOperations
org.springframework.data.mongodb.core.query.MongoRegexCreator.toCaseInsensitiveMatch(Object)	since 4.1.1
org.springframework.data.mongodb.monitor
org.springframework.data.mongodb.monitor.AbstractMonitor	since 4.5
org.springframework.data.mongodb.monitor.AssertMetrics	since 4.5
org.springframework.data.mongodb.monitor.BackgroundFlushingMetrics	since 4.5
org.springframework.data.mongodb.monitor.BtreeIndexCounters	since 4.5
org.springframework.data.mongodb.monitor.ConnectionMetrics	since 4.5
org.springframework.data.mongodb.monitor.GlobalLockMetrics	since 4.5
org.springframework.data.mongodb.monitor.MemoryMetrics	since 4.5
org.springframework.data.mongodb.monitor.OperationCounters	since 4.5
org.springframework.data.mongodb.monitor.ServerInfo	since 4.5
org.springframework.data.mongodb.util.DBObjectUtils	since 4.2.0

Deprecated Packages

Package	Description
org.springframework.data.mongodb.core.mapreduce	since MongoDB server version 5.0
org.springframework.data.mongodb.monitor

Deprecated Interfaces

Interface	Description
org.springframework.data.mongodb.core.ExecutableMapReduceOperation.MapReduceWithOptions	since 4.0 in favor of org.springframework.data.mongodb.core.aggregation.
org.springframework.data.mongodb.core.MongoAdminOperations
org.springframework.data.mongodb.core.ScriptOperations	since 2.2. The eval command has been removed without replacement in MongoDB Server 4.2.0.

Deprecated Classes

Class	Description
org.springframework.data.mongodb.config.MongoJmxParser	since 4.5
org.springframework.data.mongodb.core.aggregation.RelaxedTypeBasedAggregationOperationContext	since 4.3.1
org.springframework.data.mongodb.core.mapping.event.ValidatingMongoEventListener	since 4.5, use ValidatingEntityCallback respectively ReactiveValidatingEntityCallback instead to ensure ordering and interruption of saving when encountering validation constraint violations.
org.springframework.data.mongodb.core.mapreduce.MapReduceCounts	since 3.4 in favor of org.springframework.data.mongodb.core.aggregation.
org.springframework.data.mongodb.core.mapreduce.MapReduceOptions	since 3.4 in favor of org.springframework.data.mongodb.core.aggregation.
org.springframework.data.mongodb.core.mapreduce.MapReduceResults	since 3.4 in favor of org.springframework.data.mongodb.core.aggregation.
org.springframework.data.mongodb.core.mapreduce.MapReduceTiming	since 3.4 in favor of org.springframework.data.mongodb.core.aggregation.
org.springframework.data.mongodb.core.MongoAdmin	since 4.5
org.springframework.data.mongodb.core.script.ExecutableMongoScript	since 2.2. The eval command has been removed without replacement in MongoDB Server 4.2.0.
org.springframework.data.mongodb.core.script.NamedMongoScript	since 2.2. The eval command has been removed without replacement in MongoDB Server 4.2.0.
org.springframework.data.mongodb.monitor.AbstractMonitor	since 4.5
org.springframework.data.mongodb.monitor.AssertMetrics	since 4.5
org.springframework.data.mongodb.monitor.BackgroundFlushingMetrics	since 4.5
org.springframework.data.mongodb.monitor.BtreeIndexCounters	since 4.5
org.springframework.data.mongodb.monitor.ConnectionMetrics	since 4.5
org.springframework.data.mongodb.monitor.GlobalLockMetrics	since 4.5
org.springframework.data.mongodb.monitor.MemoryMetrics	since 4.5
org.springframework.data.mongodb.monitor.OperationCounters	since 4.5
org.springframework.data.mongodb.monitor.ServerInfo	since 4.5
org.springframework.data.mongodb.util.DBObjectUtils	since 4.2.0

Deprecated Enum Classes

Enum Class	Description
org.springframework.data.mongodb.core.aggregation.OutOperation.OutMode	extended $out syntax was superseded by $merge. Support for the extended syntax has been removed with MongoDB 5, use MergeOperation instead.

Deprecated Methods

Method	Description
org.springframework.data.mongodb.config.MappingMongoConverterParser.potentiallyCreateMappingContext(Element, ParserContext, BeanDefinition, String)	since 4.3. Use MappingMongoConverterParser.potentiallyCreateMappingContext(Element, ParserContext, BeanDefinition, String, boolean) instead.
org.springframework.data.mongodb.core.aggregation.AggregationOperation.toDocument(AggregationOperationContext)	since 2.2 in favor of AggregationOperation.toPipelineStages(AggregationOperationContext).
org.springframework.data.mongodb.core.aggregation.AggregationOperationContext.continueOnMissingFieldReference()	since 4.3.1, FieldLookupPolicy should be specified explicitly when creating the AggregationOperationContext.
org.springframework.data.mongodb.core.aggregation.AggregationOptions.getHint()	since 4.1, use AggregationOptions.getHintObject() instead.
org.springframework.data.mongodb.core.aggregation.OutOperation.insertDocuments()	extended $out syntax was superseded by $merge. Support for the extended syntax has been removed with MongoDB 5, use MergeOperation instead.
org.springframework.data.mongodb.core.aggregation.OutOperation.mode(OutOperation.OutMode)	extended $out syntax was superseded by $merge. Support for the extended syntax has been removed with MongoDB 5, use MergeOperation instead.
org.springframework.data.mongodb.core.aggregation.OutOperation.replaceCollection()	extended $out syntax was superseded by $merge. Support for the extended syntax has been removed with MongoDB 5, use MergeOperation instead.
org.springframework.data.mongodb.core.aggregation.OutOperation.replaceDocuments()	extended $out syntax was superseded by $merge. Support for the extended syntax has been removed with MongoDB 5, use MergeOperation instead.
org.springframework.data.mongodb.core.aggregation.OutOperation.uniqueKey(String)	extended $out syntax was superseded by $merge. Support for the extended syntax has been removed with MongoDB 5, use MergeOperation instead.
org.springframework.data.mongodb.core.aggregation.OutOperation.uniqueKeyOf(Iterable<String>)	extended $out syntax was superseded by $merge. Support for the extended syntax has been removed with MongoDB 5, use MergeOperation instead.
org.springframework.data.mongodb.core.aggregation.TypeBasedAggregationOperationContext.continueOnMissingFieldReference()
org.springframework.data.mongodb.core.convert.MongoCustomConversions.MongoConverterConfigurationAdapter.setPropertyValueConversions(PropertyValueConversions)	since 4.2. Use MongoCustomConversions.MongoConverterConfigurationAdapter.withPropertyValueConversions(PropertyValueConversions) instead.
org.springframework.data.mongodb.core.index.GeospatialIndex.withBucketSize(double)	since MongoDB server version 4.4
org.springframework.data.mongodb.core.index.GeoSpatialIndexed.bucketSize()	since MongoDB server version 4.4
org.springframework.data.mongodb.core.index.Indexed.expireAfterSeconds()	since 4.4 - Please use Indexed.expireAfter() instead.
org.springframework.data.mongodb.core.index.IndexOperations.ensureIndex(IndexDefinition)	since 4.5, in favor of IndexOperations.createIndex(IndexDefinition).
org.springframework.data.mongodb.core.index.ReactiveIndexOperations.ensureIndex(IndexDefinition)	since 4.5, in favor of ReactiveIndexOperations.createIndex(IndexDefinition).
org.springframework.data.mongodb.core.MongoClientSettingsFactoryBean.setStreamFactoryFactory(Object)	since 4.3, will be removed in the MongoDB 5.0 driver in favor of com.mongodb.connection.TransportSettings.
org.springframework.data.mongodb.core.MongoOperations.geoNear(NearQuery, Class<T>)	since 2.2. The eval command has been removed in MongoDB Server 4.2.0. Use Aggregations with Aggregation.geoNear(NearQuery, String) instead.
org.springframework.data.mongodb.core.MongoOperations.geoNear(NearQuery, Class<T>, String)	since 2.2. The eval command has been removed in MongoDB Server 4.2.0. Use Aggregations with Aggregation.geoNear(NearQuery, String) instead.
org.springframework.data.mongodb.core.MongoOperations.mapReduce(String, String, String, Class<T>)	since 3.4 in favor of MongoOperations.aggregate(TypedAggregation, Class).
org.springframework.data.mongodb.core.MongoOperations.mapReduce(String, String, String, MapReduceOptions, Class<T>)	since 3.4 in favor of MongoOperations.aggregate(TypedAggregation, Class).
org.springframework.data.mongodb.core.MongoOperations.mapReduce(Query, String, String, String, Class<T>)	since 3.4 in favor of MongoOperations.aggregate(TypedAggregation, Class).
org.springframework.data.mongodb.core.MongoOperations.mapReduce(Query, String, String, String, MapReduceOptions, Class<T>)	since 3.4 in favor of MongoOperations.aggregate(TypedAggregation, Class).
org.springframework.data.mongodb.core.MongoOperations.scriptOps()	since 2.2. The eval command has been removed without replacement in MongoDB Server 4.2.0.
org.springframework.data.mongodb.core.MongoTemplate.mapReduce(Query, Class<?>, String, String, String, MapReduceOptions, Class<T>)	since 3.4 in favor of MongoTemplate.aggregate(TypedAggregation, Class).
org.springframework.data.mongodb.core.query.MongoRegexCreator.toCaseInsensitiveMatch(Object)	since 4.1.1
org.springframework.data.mongodb.core.query.Query.isRestrictedTypeKey(String)	don't call this method as the restricted type handling will undergo some significant changes going forward.
org.springframework.data.mongodb.core.ReactiveMongoOperations.geoNear(NearQuery, Class<T>)	since 2.2. The eval command has been removed in MongoDB Server 4.2.0. Use Aggregations with Aggregation.geoNear(NearQuery, String) instead.
org.springframework.data.mongodb.core.ReactiveMongoOperations.geoNear(NearQuery, Class<T>, String)	since 2.2. The eval command has been removed in MongoDB Server 4.2.0. Use Aggregations with Aggregation.geoNear(NearQuery, String) instead.
org.springframework.data.mongodb.core.ReactiveMongoOperations.mapReduce(Query, Class<?>, Class<T>, String, String, MapReduceOptions)	since 3.4 in favor of ReactiveMongoOperations.aggregate(TypedAggregation, Class).
org.springframework.data.mongodb.core.ReactiveMongoOperations.mapReduce(Query, Class<?>, String, Class<T>, String, String, MapReduceOptions)	since 3.4 in favor of ReactiveMongoOperations.aggregate(TypedAggregation, Class).
org.springframework.data.mongodb.repository.query.AbstractReactiveMongoQuery.getSpelEvaluatorFor(ExpressionDependencies, MongoParameterAccessor)	since 4.4.0, use AbstractReactiveMongoQuery.getValueExpressionEvaluatorLater(ExpressionDependencies, MongoParameterAccessor) instead

Deprecated Constructors

Constructor	Description
org.springframework.data.mongodb.core.convert.MappingMongoConverter(MongoDatabaseFactory, MappingContext<? extends MongoPersistentEntity<?>, MongoPersistentProperty>)	use the constructor taking a DbRefResolver instead.
org.springframework.data.mongodb.core.DefaultIndexOperations(MongoDatabaseFactory, String, QueryMapper)	since 2.1. Please use DefaultIndexOperations(MongoOperations, String, Class).
org.springframework.data.mongodb.core.DefaultIndexOperations(MongoDatabaseFactory, String, QueryMapper, Class<?>)	since 2.1. Please use DefaultIndexOperations(MongoOperations, String, Class).
org.springframework.data.mongodb.repository.query.AbstractMongoQuery(MongoQueryMethod, MongoOperations, ExpressionParser, QueryMethodEvaluationContextProvider)	use the constructor version with ValueExpressionDelegate
org.springframework.data.mongodb.repository.query.AbstractReactiveMongoQuery(ReactiveMongoQueryMethod, ReactiveMongoOperations, ExpressionParser, ReactiveQueryMethodEvaluationContextProvider)	use the constructor version with ValueExpressionDelegate
org.springframework.data.mongodb.repository.query.PartTreeMongoQuery(MongoQueryMethod, MongoOperations, ExpressionParser, QueryMethodEvaluationContextProvider)	since 4.4, use the constructors accepting QueryMethodValueEvaluationContextAccessor instead.
org.springframework.data.mongodb.repository.query.ReactivePartTreeMongoQuery(ReactiveMongoQueryMethod, ReactiveMongoOperations, ExpressionParser, ReactiveQueryMethodEvaluationContextProvider)	since 4.4.0, use the constructors accepting QueryMethodValueEvaluationContextAccessor instead.
org.springframework.data.mongodb.repository.query.ReactiveStringBasedAggregation(ReactiveMongoQueryMethod, ReactiveMongoOperations, ExpressionParser, ReactiveQueryMethodEvaluationContextProvider)	since 4.4.0, use the constructors accepting ValueExpressionDelegate instead.
org.springframework.data.mongodb.repository.query.ReactiveStringBasedMongoQuery(String, ReactiveMongoQueryMethod, ReactiveMongoOperations, ExpressionParser, ReactiveQueryMethodEvaluationContextProvider)	since 4.4.0, use the constructors accepting ValueExpressionDelegate instead.
org.springframework.data.mongodb.repository.query.ReactiveStringBasedMongoQuery(ReactiveMongoQueryMethod, ReactiveMongoOperations, ExpressionParser, ReactiveQueryMethodEvaluationContextProvider)	since 4.4.0, use the constructors accepting ValueExpressionDelegate instead.
org.springframework.data.mongodb.repository.query.StringBasedAggregation(MongoQueryMethod, MongoOperations, ExpressionParser, QueryMethodEvaluationContextProvider)	since 4.4.0, use the constructors accepting QueryMethodValueEvaluationContextAccessor instead.
org.springframework.data.mongodb.repository.query.StringBasedMongoQuery(MongoQueryMethod, MongoOperations, ExpressionParser, QueryMethodEvaluationContextProvider)	since 4.4.0, use the constructors accepting ValueExpressionDelegate instead.
org.springframework.data.mongodb.util.json.ParameterBindingContext(ValueProvider, SpELExpressionEvaluator)	since 4.4.0, use ParameterBindingContext(ValueProvider, ValueExpressionEvaluator) instead.
org.springframework.data.mongodb.util.json.ParameterBindingContext(ValueProvider, SpelExpressionParser, EvaluationContext)	since 4.4.0, use ParameterBindingContext(ValueProvider, ExpressionParser, Supplier) instead.

Deprecated Annotation Interface Elements

Annotation Interface Element	Description
org.springframework.data.mongodb.core.index.GeoSpatialIndexed.bucketSize()	since MongoDB server version 4.4
org.springframework.data.mongodb.core.index.Indexed.expireAfterSeconds()	since 4.4 - Please use Indexed.expireAfter() instead.