Deprecated Classes in Spring

Azure Spring Apps is a fully managed service from Microsoft (built in collaboration with VMware), focused on building and deploying Spring Boot applications on Azure Cloud without worrying about Kubernetes.

And, the Enterprise plan comes with some interesting features, such as commercial Spring runtime support, a 99.95% SLA and some deep discounts (up to 47%) when you are ready for production.

>> Learn more and deploy your first Spring Boot app to Azure.

You can also ask questions and leave feedback on the Azure Spring Apps GitHub page.

Slow MySQL query performance is all too common. Of course it is. A good way to go is, naturally, a dedicated profiler that actually understands the ins and outs of MySQL.

The Jet Profiler was built for MySQL only, so it can do things like real-time query performance, focus on most used tables or most frequent queries, quickly identify performance issues and basically help you optimize your queries.

Critically, it has very minimal impact on your server's performance, with most of the profiling work done separately - so it needs no server changes, agents or separate services.

Basically, you install the desktop application, connect to your MySQL server, hit the record button, and you'll have results within minutes:

>> Try out the Profiler

Accelerate Your Jakarta EE Development with Payara Server!

With best-in-class guides and documentation, Payara essentially simplifies deployment to diverse infrastructures.

Beyond that, it provides intelligent insights and actions to optimize Jakarta EE applications.

The goal is to apply an opinionated approach to get to what's essential for mission-critical applications - really solid scalability, availability, security, and long-term support:

>> Download and Explore the Guide (to learn more)

The AI Assistant to boost Boost your productivity writing unit tests - Machinet AI.

AI is all the rage these days, but for very good reason. The highly practical coding companion, you'll get the power of AI-assisted coding and automated unit test generation.
Machinet's Unit Test AI Agent utilizes your own project context to create meaningful unit tests that intelligently aligns with the behavior of the code.
And, the AI Chat crafts code and fixes errors with ease, like a helpful sidekick.

Simplify Your Coding Journey with Machinet AI:

>> Install Machinet AI in your IntelliJ

Looking for the ideal Linux distro for running modern Spring apps in the cloud?

Meet Alpaquita Linux: lightweight, secure, and powerful enough to handle heavy workloads.

This distro is specifically designed for running Java apps. It builds upon Alpine and features significant enhancements to excel in high-density container environments while meeting enterprise-grade security standards.

Specifically, the container image size is ~30% smaller than standard options, and it consumes up to 30% less RAM:

>> Try Alpaquita Containers now.

DbSchema is a super-flexible database designer, which can take you from designing the DB with your team all the way to safely deploying the schema.

The way it does all of that is by using a design model, a database-independent image of the schema, which can be shared in a team using GIT and compared or deployed on to any database.

And, of course, it can be heavily visual, allowing you to interact with the database using diagrams, visually compose queries, explore the data, generate random data, import data or build HTML5 database reports.

>> Take a look at DBSchema

Slow MySQL query performance is all too common. Of course it is. A good way to go is, naturally, a dedicated profiler that actually understands the ins and outs of MySQL.

Critically, it has very minimal impact on your server's performance, with most of the profiling work done separately - so it needs no server changes, agents or separate services.

Basically, you install the desktop application, connect to your MySQL server, hit the record button, and you'll have results within minutes:

>> Try out the Profiler

1. Introduction

In this tutorial, we’re going to take a look at the deprecated classes in Spring and Spring Boot and explain what these have been replaced with.

We’ll explore classes starting from Spring 4 and Spring Boot 1.4.

2. Deprecated Classes in Spring

For easier reading, we list classes and their replacements based on the Spring release. And, within each grouping of classes, we’ve sorted them by the class name, irrespective of package.

2.1. Spring 4.0.x

org.springframework.cache.interceptor.DefaultKeyGenerator – replaced by the SimpleKeyGenerator or custom KeyGenerator implementations based on hash codes
org.springframework.jdbc.support.lob.OracleLobHandler – DefaultLobHandler for the Oracle 10g driver and higher; we should consider it even against the Oracle 9i database
org.springframework.test.AssertThrows – we should make use of JUnit 4’s @Test(expected=…) support instead
org.springframework.http.converter.xml.XmlAwareFormHttpMessageConverter – AllEncompassingFormHttpMessageConverter

The following class was deprecated as of Spring 4.0.2, in favor of CGLIB 3.1’s default strategy, and was removed in Spring 4.1:

org.springframework.cglib.transform.impl.MemorySafeUndeclaredThrowableStrategy

All deprecated classes, as well as deprecated interfaces, fields, methods, constructors, and enum constants for this Spring version can be found on the official documentation page.

2.2. Spring 4.1.x

org.springframework.jdbc.core.simple.ParameterizedBeanPropertyRowMapper – BeanPropertyRowMapper
org.springframework.jdbc.core.simple.ParameterizedSingleColumnRowMapper – SingleColumnRowMapper

We can find the full list in the Spring 4.1.x JavaDoc.

2.3. Spring 4.2.x

org.springframework.web.servlet.view.document.AbstractExcelView – AbstractXlsView and its AbstractXlsxView and AbstractXlsxStreamingView variants
org.springframework.format.number.CurrencyFormatter – CurrencyStyleFormatter
org.springframework.messaging.simp.user.DefaultUserSessionRegistry – we should use the SimpUserRegistry in combination with the ApplicationListener listening for the AbstractSubProtocolEvent events
org.springframework.messaging.handler.HandlerMethodSelector – generalized and refined MethodIntrospector
org.springframework.core.JdkVersion – we should perform direct checks for the desired JDK API variants via reflection
org.springframework.format.number.NumberFormatter – NumberStyleFormatter
org.springframework.format.number.PercentFormatter – PercentStyleFormatter
org.springframework.test.context.transaction.TransactionConfigurationAttributes – this class is removed along with the @TransactionConfiguration in Spring 5
org.springframework.oxm.xmlbeans.XmlBeansMarshaller – following the XMLBeans retirement at Apache

The following classes are deprecated in favor of Apache Log4j 2:

org.springframework.web.util.Log4jConfigListener
org.springframework.util.Log4jConfigurer
org.springframework.web.filter.Log4jNestedDiagnosticContextFilter
org.springframework.web.context.request.Log4jNestedDiagnosticContextInterceptor
org.springframework.web.util.Log4jWebConfigurer

More details are available in the Spring 4.2.x JavaDoc.

2.4. Spring 4.3.x

This version of Spring brought lots of deprecated classes:

org.springframework.web.servlet.mvc.method.annotation.AbstractJsonpResponseBodyAdvice – this class is removed in Spring Framework 5.1; we should use CORS instead
org.springframework.oxm.castor.CastorMarshaller – deprecated due to the lack of activity on the Castor project
org.springframework.web.servlet.mvc.method.annotation.CompletionStageReturnValueHandler – DeferredResultMethodReturnValueHandler, which now supports CompletionStage return values via an adapter mechanism
org.springframework.jdbc.support.incrementer.DB2MainframeSequenceMaxValueIncrementer – renamed to Db2MainframeMaxValueIncrementer
org.springframework.jdbc.support.incrementer.DB2SequenceMaxValueIncrementer – renamed to Db2LuwMaxValueIncrementer
org.springframework.core.GenericCollectionTypeResolver – deprecated in favor of direct ResolvableType usage
org.springframework.web.servlet.mvc.method.annotation.ListenableFutureReturnValueHandler – DeferredResultMethodReturnValueHandler, which now supports ListenableFuture return values via an adapter mechanism
org.springframework.jdbc.support.incrementer.PostgreSQLSequenceMaxValueIncrementer – we should use PostgresSequenceMaxValueIncrementer instead
org.springframework.web.servlet.ResourceServlet – ResourceHttpRequestHandler

These classes are deprecated in favor of the HandlerMethod-based MVC infrastructure:

org.springframework.web.servlet.mvc.support.ControllerClassNameHandlerMapping
org.springframework.web.bind.annotation.support.HandlerMethodInvoker
org.springframework.web.bind.annotation.support.HandlerMethodResolver

Several classes are deprecated in favor of annotation-driven handler methods:

org.springframework.web.servlet.mvc.support.AbstractControllerUrlHandlerMapping
org.springframework.web.servlet.mvc.multiaction.AbstractUrlMethodNameResolver
org.springframework.web.servlet.mvc.support.ControllerBeanNameHandlerMapping
org.springframework.web.servlet.mvc.multiaction.InternalPathMethodNameResolver
org.springframework.web.servlet.mvc.multiaction.ParameterMethodNameResolver
org.springframework.web.servlet.mvc.multiaction.PropertiesMethodNameResolver

There are also a lot of classes from Spring that we should replace with their Hibernate 4.x/5.x equivalents:

org.springframework.orm.hibernate3.support.AbstractLobType
org.springframework.orm.hibernate3.AbstractSessionFactoryBean
org.springframework.orm.hibernate3.annotation.AnnotationSessionFactoryBean
org.springframework.orm.hibernate3.support.BlobByteArrayType
org.springframework.orm.hibernate3.support.BlobSerializableType
org.springframework.orm.hibernate3.support.BlobStringType
org.springframework.orm.hibernate3.support.ClobStringType
org.springframework.orm.hibernate3.FilterDefinitionFactoryBean
org.springframework.orm.hibernate3.HibernateAccessor
org.springframework.orm.hibernate3.support.HibernateDaoSupport
org.springframework.orm.hibernate3.HibernateExceptionTranslator
org.springframework.orm.jpa.vendor.HibernateJpaSessionFactoryBean
org.springframework.orm.hibernate3.HibernateTemplate
org.springframework.orm.hibernate3.HibernateTransactionManager
org.springframework.orm.hibernate3.support.IdTransferringMergeEventListener
org.springframework.orm.hibernate3.LocalDataSourceConnectionProvider
org.springframework.orm.hibernate3.LocalJtaDataSourceConnectionProvider
org.springframework.orm.hibernate3.LocalRegionFactoryProxy
org.springframework.orm.hibernate3.LocalSessionFactoryBean
org.springframework.orm.hibernate3.LocalTransactionManagerLookup
org.springframework.orm.hibernate3.support.OpenSessionInterceptor
org.springframework.orm.hibernate3.support.OpenSessionInViewFilter
org.springframework.orm.hibernate3.support.OpenSessionInViewInterceptor
org.springframework.orm.hibernate3.support.ScopedBeanInterceptor
org.springframework.orm.hibernate3.SessionFactoryUtils
org.springframework.orm.hibernate3.SessionHolder
org.springframework.orm.hibernate3.SpringSessionContext
org.springframework.orm.hibernate3.SpringTransactionFactory
org.springframework.orm.hibernate3.TransactionAwareDataSourceConnectionProvider
org.springframework.orm.hibernate3.TypeDefinitionBean

Several classes are deprecated in favor of FreeMarker:

org.springframework.web.servlet.view.velocity.VelocityConfigurer
org.springframework.ui.velocity.VelocityEngineFactory
org.springframework.ui.velocity.VelocityEngineFactoryBean
org.springframework.ui.velocity.VelocityEngineUtils
org.springframework.web.servlet.view.velocity.VelocityLayoutView
org.springframework.web.servlet.view.velocity.VelocityLayoutViewResolver
org.springframework.web.servlet.view.velocity.VelocityToolboxView
org.springframework.web.servlet.view.velocity.VelocityView
org.springframework.web.servlet.view.velocity.VelocityViewResolver

These classes are removed in Spring Framework 5.1, and we should use other transports instead:

org.springframework.web.socket.sockjs.transport.handler.JsonpPollingTransportHandler
org.springframework.web.socket.sockjs.transport.handler.JsonpReceivingTransportHandler

Finally, there are also a couple of classes without an appropriate replacement:

org.springframework.core.ControlFlowFactory
org.springframework.util.WeakReferenceMonitor

As usual, the Spring 4.3.x JavaDoc contains the complete list.

2.5. Spring 5.0.x

org.springframework.web.reactive.support.AbstractAnnotationConfigDispatcherHandlerInitializer – deprecated in favor of AbstractReactiveWebInitializer
org.springframework.web.util.AbstractUriTemplateHandler – DefaultUriBuilderFactory
org.springframework.web.socket.config.annotation.AbstractWebSocketMessageBrokerConfigurer – deprecated in favor of simply using the WebSocketMessageBrokerConfigurer, which has default methods, made possible by a Java 8 baseline
org.springframework.web.client.AsyncRestTemplate – WebClient
org.springframework.web.context.request.async.CallableProcessingInterceptorAdapter – deprecated since the CallableProcessingInterceptor has default methods
org.springframework.messaging.support.ChannelInterceptorAdapter – deprecated since the ChannelInterceptor has default methods (made possible by a Java 8 baseline) and can be implemented directly without the need for this no-op adapter
org.springframework.util.comparator.CompoundComparator – deprecated in favor of the standard JDK 8 Comparator.thenComparing(Comparator)
org.springframework.web.util.DefaultUriTemplateHandler – DefaultUriBuilderFactory; we should note that the DefaultUriBuilderFactory has a different default value for the parsePath property (changed from false to true)
org.springframework.web.context.request.async.DeferredResultProcessingInterceptorAdapter – since the DeferredResultProcessingInterceptor has default methods
org.springframework.util.comparator.InvertibleComparator – deprecated in favor of the standard JDK 8 Comparator.reversed()
org.springframework.http.client.Netty4ClientHttpRequestFactory – deprecated in favor of ReactorClientHttpConnector
org.apache.commons.logging.impl.SimpleLog – moved to spring-jcl (effectively equivalent to NoOpLog)
org.springframework.web.servlet.config.annotation.WebMvcConfigurerAdapter – WebMvcConfigurer has default methods (made possible by a Java 8 baseline) and can be implemented directly without the need for this adapter
org.springframework.beans.factory.config.YamlProcessor.StrictMapAppenderConstructor – superseded by SnakeYAML’s own duplicate key handling

We have two classes deprecated in favor of AbstractReactiveWebInitializer:

org.springframework.web.reactive.support.AbstractDispatcherHandlerInitializer
org.springframework.web.reactive.support.AbstractServletHttpHandlerAdapterInitializer

And, the following classes don’t have replacements:

org.springframework.http.client.support.AsyncHttpAccessor
org.springframework.http.client.HttpComponentsAsyncClientHttpRequestFactory
org.springframework.http.client.InterceptingAsyncClientHttpRequestFactory
org.springframework.http.client.support.InterceptingAsyncHttpAccessor
org.springframework.mock.http.client.MockAsyncClientHttpRequest

The complete list is available in the Spring 5.0.x JavaDoc.

2.6. Spring 5.1.x

org.springframework.http.client.support.BasicAuthorizationInterceptor – deprecated in favor of BasicAuthenticationInterceptor, which reuses the HttpHeaders.setBasicAuth(java.lang.String, java.lang.String) and now shares its default charset ISO-8859-1 instead of using UTF-8 as it did previously
org.springframework.jdbc.core.BatchUpdateUtils – no longer used by the JdbcTemplate
org.springframework.web.reactive.function.client.ExchangeFilterFunctions.Credentials – we should use the HttpHeaders.setBasicAuth(String, String) method while building the request
org.springframework.web.filter.reactive.ForwardedHeaderFilter – this filter is deprecated in favor of using the ForwardedHeaderTransformer, which can be declared as a bean with the name “forwardedHeaderTransformer” or registered explicitly in the WebHttpHandlerBuilder
org.springframework.jdbc.core.namedparam.NamedParameterBatchUpdateUtils – not used by the NamedParameterJdbcTemplate any more
org.springframework.core.io.PathResource – FileSystemResource.FileSystemResource(Path)
org.springframework.beans.factory.annotation.RequiredAnnotationBeanPostProcessor – we should use constructor injection for required settings (or a custom InitializingBean implementation)
org.springframework.remoting.caucho.SimpleHessianServiceExporter – HessianServiceExporter
org.springframework.remoting.httpinvoker.SimpleHttpInvokerServiceExporter – HttpInvokerServiceExporter
org.springframework.remoting.support.SimpleHttpServerFactoryBean – embedded Tomcat/Jetty/Undertow
org.springframework.remoting.jaxws.SimpleHttpServerJaxWsServiceExporter – SimpleJaxWsServiceExporter

These are deprecated in favor of EncodedResourceResolver:

org.springframework.web.reactive.resource.GzipResourceResolver
org.springframework.web.servlet.resource.GzipResourceResolver

There are several classes that are deprecated in favor of Java EE 7’s DefaultManagedTaskScheduler:

org.springframework.scheduling.commonj.DelegatingTimerListener
org.springframework.scheduling.commonj.ScheduledTimerListener
org.springframework.scheduling.commonj.TimerManagerAccessor
org.springframework.scheduling.commonj.TimerManagerFactoryBean
org.springframework.scheduling.commonj.TimerManagerTaskScheduler

And, a few are deprecated in favor of Java EE 7’s DefaultManagedTaskExecutor:

org.springframework.scheduling.commonj.DelegatingWork
org.springframework.scheduling.commonj.WorkManagerTaskExecutor

Finally, one class is deprecated without a substitute:

org.apache.commons.logging.LogFactoryService

For more details, please see the official Spring 5.1.x JavaDoc on deprecated classes.

3. Deprecated Classes in Spring Boot

Now, let’s take a look at the deprecated classes in Spring Boot back to version 1.4.

We should note here that, for Spring Boot 1.4 and 1.5, most of the replacement classes kept their original names but have been moved to different packages. Therefore, we use fully qualified class names in the next two subsections for both the deprecated and replacement classes.

3.1. Spring Boot 1.4.x

org.springframework.boot.actuate.system.ApplicationPidFileWriter – deprecated in favor of org.springframework.boot.system.ApplicationPidFileWriter
org.springframework.boot.yaml.ArrayDocumentMatcher – deprecated in favor of exact String-based matching
org.springframework.boot.test.ConfigFileApplicationContextInitializer – org.springframework.boot.test.context.ConfigFileApplicationContextInitializer
org.springframework.boot.yaml.DefaultProfileDocumentMatcher – it is no longer used
org.springframework.boot.context.embedded.DelegatingFilterProxyRegistrationBean – org.springframework.boot.web.servlet.DelegatingFilterProxyRegistrationBean
org.springframework.boot.actuate.system.EmbeddedServerPortFileWriter – org.springframework.boot.system.EmbeddedServerPortFileWriter
org.springframework.boot.test.EnvironmentTestUtils – org.springframework.boot.test.util.EnvironmentTestUtils
org.springframework.boot.context.embedded.ErrorPage – org.springframework.boot.web.servlet.ErrorPage
org.springframework.boot.context.web.ErrorPageFilter – org.springframework.boot.web.support.ErrorPageFilter
org.springframework.boot.context.embedded.FilterRegistrationBean – org.springframework.boot.web.servlet.FilterRegistrationBean
org.springframework.boot.test.IntegrationTestPropertiesListener – it is no longer used by the @IntegrationTest
org.springframework.boot.context.embedded.MultipartConfigFactory – org.springframework.boot.web.servlet.MultipartConfigFactory
org.springframework.boot.context.web.OrderedCharacterEncodingFilter – org.springframework.boot.web.filter.OrderedCharacterEncodingFilter
org.springframework.boot.context.web.OrderedHiddenHttpMethodFilter – org.springframework.boot.web.filter.OrderedHiddenHttpMethodFilter
org.springframework.boot.context.web.OrderedHttpPutFormContentFilter – org.springframework.boot.web.filter.OrderedHttpPutFormContentFilter
org.springframework.boot.context.web.OrderedRequestContextFilter – org.springframework.boot.web.filter.OrderedRequestContextFilter
org.springframework.boot.test.OutputCapture – org.springframework.boot.test.rule.OutputCapture
org.springframework.boot.context.web.ServerPortInfoApplicationContextInitializer – org.springframework.boot.context.embedded.ServerPortInfoApplicationContextInitializer
org.springframework.boot.context.web.ServletContextApplicationContextInitializer – org.springframework.boot.web.support.ServletContextApplicationContextInitializer
org.springframework.boot.context.embedded.ServletListenerRegistrationBean – org.springframework.boot.web.servlet.ServletListenerRegistrationBean
org.springframework.boot.context.embedded.ServletRegistrationBean – org.springframework.boot.web.servlet.ServletRegistrationBean
org.springframework.boot.test.SpringApplicationContextLoader – deprecated in favor of @SpringBootTest; if necessary, we may also use the org.springframework.boot.test.context.SpringBootContextLoader
org.springframework.boot.test.SpringBootMockServletContext – org.springframework.boot.test.mock.web.SpringBootMockServletContext
org.springframework.boot.context.web.SpringBootServletInitializer – org.springframework.boot.web.support.SpringBootServletInitializer
org.springframework.boot.test.TestRestTemplate – org.springframework.boot.test.web.client.TestRestTemplate

Since Velocity support is deprecated in Spring Framework 4.3, the following classes are also deprecated in Spring Boot:

org.springframework.boot.web.servlet.view.velocity.EmbeddedVelocityViewResolver
org.springframework.boot.autoconfigure.velocity.VelocityAutoConfiguration
org.springframework.boot.autoconfigure.velocity.VelocityAutoConfiguration.VelocityConfiguration
org.springframework.boot.autoconfigure.velocity.VelocityAutoConfiguration.VelocityNonWebConfiguration
org.springframework.boot.autoconfigure.velocity.VelocityAutoConfiguration.VelocityWebConfiguration
org.springframework.boot.autoconfigure.velocity.VelocityProperties
org.springframework.boot.autoconfigure.velocity.VelocityTemplateAvailabilityProvider

The Spring Boot 1.4.x JavaDoc has the full list.

3.2. Spring Boot 1.5.x

org.springframework.boot.context.event.ApplicationStartedEvent – deprecated in favor of org.springframework.boot.context.event.ApplicationStartingEvent
org.springframework.boot.autoconfigure.EnableAutoConfigurationImportSelector – deprecated in favor of org.springframework.boot.autoconfigure.AutoConfigurationImportSelector
org.springframework.boot.actuate.cache.GuavaCacheStatisticsProvider – following the removal of Guava support in Spring Framework 5
org.springframework.boot.loader.tools.Layouts.Module – deprecated in favor of a custom LayoutFactory
org.springframework.boot.autoconfigure.MessageSourceAutoConfiguration – deprecated in favor of org.springframework.boot.autoconfigure.context.MessageSourceAutoConfiguration
org.springframework.boot.autoconfigure.PropertyPlaceholderAutoConfiguration – deprecated in favor of org.springframework.boot.autoconfigure.context.PropertyPlaceholderAutoConfiguration
org.springframework.boot.actuate.autoconfigure.ShellProperties – deprecated since CRaSH is not actively maintained

These two classes are deprecated since CRaSH is not actively maintained:

org.springframework.boot.actuate.autoconfigure.CrshAutoConfiguration
org.springframework.boot.actuate.autoconfigure.CrshAutoConfiguration.AuthenticationManagerAdapterConfiguration

There also a few classes without a replacement:

org.springframework.boot.autoconfigure.cache.CacheProperties.Hazelcast
org.springframework.boot.autoconfigure.jdbc.metadata.CommonsDbcpDataSourcePoolMetadata
org.springframework.boot.autoconfigure.mustache.MustacheCompilerFactoryBean

To see the entire list of what was deprecated, we can consult the official Spring Boot 1.5.x JavaDoc site.

3.3. Spring Boot 2.0.x

org.springframework.boot.test.util.EnvironmentTestUtils – deprecated in favor of TestPropertyValues
org.springframework.boot.actuate.metrics.web.reactive.server.RouterFunctionMetrics – deprecated in favor of the auto-configured MetricsWebFilter

And one class doesn’t have a substitute:

org.springframework.boot.actuate.autoconfigure.couchbase.CouchbaseHealthIndicatorProperties

Please check out the deprecated list for Spring Boot 2.0.x for more details.

3.4. Spring Boot 2.1.x

org.springframework.boot.actuate.health.CompositeHealthIndicatorFactory – deprecated in favor of CompositeHealthIndicator.CompositeHealthIndicator(HealthAggregator, HealthIndicatorRegistry)
org.springframework.boot.actuate.health.CompositeReactiveHealthIndicatorFactory – deprecated in favor of CompositeReactiveHealthIndicator.CompositeReactiveHealthIndicator(HealthAggregator, ReactiveHealthIndicatorRegistry)

Finally, we can consult the complete list of deprecated classes and interfaces in Spring Boot 2.1.x.

4. Conclusion

In this tutorial, we explored deprecated classes in Spring since version 4 and Spring Boot from version 1.4, along with their corresponding replacements, where available.

REST with Spring

Learn Spring Security ▼▲

Learn Spring Security Core

Learn Spring Security OAuth

Learn Spring

Learn Spring Data JPA

Persistence

REST

Security

Full Archive

Baeldung Ebooks

About Baeldung

Write for Baeldung