Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Exceptions
• Deprecated Annotation Types
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors
• Deprecated Enum Constants

Deprecated Interfaces

Interface and Description
org.springframework.http.client.AsyncClientHttpRequest as of Spring 5.0, in favor of ClientRequest
org.springframework.http.client.AsyncClientHttpRequestExecution as of Spring 5.0, in favor of ExchangeFilterFunction
org.springframework.http.client.AsyncClientHttpRequestFactory as of Spring 5.0, in favor of ClientHttpConnector
org.springframework.http.client.AsyncClientHttpRequestInterceptor as of Spring 5.0, in favor of ExchangeFilterFunction
org.springframework.web.client.AsyncRequestCallback as of Spring 5.0, in favor of ExchangeFilterFunction
org.springframework.web.client.AsyncRestOperations as of Spring 5.0, in favor of WebClient

Deprecated Classes

Class and Description
org.springframework.web.reactive.support.AbstractAnnotationConfigDispatcherHandlerInitializer in favor of AbstractReactiveWebInitializer
org.springframework.web.reactive.support.AbstractDispatcherHandlerInitializer in favor of AbstractReactiveWebInitializer
org.springframework.web.reactive.support.AbstractServletHttpHandlerAdapterInitializer in favor of AbstractReactiveWebInitializer
org.springframework.web.util.AbstractUriTemplateHandler as of 5.0 in favor of DefaultUriBuilderFactory
org.springframework.http.client.support.AsyncHttpAccessor as of Spring 5.0, with no direct replacement
org.springframework.web.client.AsyncRestTemplate as of Spring 5.0, in favor of WebClient
org.springframework.web.context.request.async.CallableProcessingInterceptorAdapter as of 5.0 where CallableProcessingInterceptor has default methods
org.springframework.oxm.castor.CastorMarshaller as of Spring Framework 4.3.13, due to the lack of activity on the Castor project
org.springframework.util.comparator.CompoundComparator as of Spring Framework 5.0, in favor of the standard JDK 8 Comparator.thenComparing(Comparator)
org.springframework.web.util.DefaultUriTemplateHandler as of 5.0 in favor of DefaultUriBuilderFactory
org.springframework.web.context.request.async.DeferredResultProcessingInterceptorAdapter as of 5.0 where DeferredResultProcessingInterceptor has default methods
org.springframework.orm.jpa.vendor.HibernateJpaSessionFactoryBean as of Spring Framework 4.3.12 against Hibernate 5.2, in favor of a custom solution based on EntityManagerFactory.unwrap(java.lang.Class<T>) with explicit qualifiers and/or primary markers
org.springframework.http.client.HttpComponentsAsyncClientHttpRequestFactory as of Spring 5.0, with no direct replacement
org.springframework.http.client.InterceptingAsyncClientHttpRequestFactory as of Spring 5.0, with no direct replacement
org.springframework.http.client.support.InterceptingAsyncHttpAccessor as of Spring 5.0, with no direct replacement
org.springframework.util.comparator.InvertibleComparator as of Spring Framework 5.0, in favor of the standard JDK 8 Comparator.reversed()
org.springframework.mock.http.client.MockAsyncClientHttpRequest as of Spring 5.0, with no direct replacement
org.springframework.http.client.Netty4ClientHttpRequestFactory as of Spring 5.0, in favor of ReactorClientHttpConnector
org.apache.commons.logging.impl.SimpleLog
org.springframework.web.servlet.config.annotation.WebMvcConfigurerAdapter as of 5.0 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.xml.XmlBeanFactory as of Spring 3.1 in favor of DefaultListableBeanFactory and XmlBeanDefinitionReader

Deprecated Exceptions

Exceptions and Description
org.springframework.oxm.castor.CastorMappingException as of Spring Framework 4.3.13, due to the lack of activity on the Castor project

Deprecated Annotation Types

Annotation Type and Description
org.springframework.lang.UsesJava7
org.springframework.lang.UsesJava8

Deprecated Fields

Field and Description
org.springframework.beans.factory.config.AutowireCapableBeanFactory.AUTOWIRE_AUTODETECT as of Spring 3.0: If you are using mixed autowiring strategies, prefer annotation-based autowiring for clearer demarcation of autowiring needs.
org.springframework.beans.factory.support.AbstractBeanDefinition.AUTOWIRE_AUTODETECT as of Spring 3.0: If you are using mixed autowiring strategies, use annotation-based autowiring for clearer demarcation of autowiring needs.
org.springframework.web.bind.annotation.CrossOrigin.DEFAULT_ALLOW_CREDENTIALS as of Spring 5.0, in favor of using CorsConfiguration.applyPermitDefaultValues()
org.springframework.web.bind.annotation.CrossOrigin.DEFAULT_ALLOWED_HEADERS as of Spring 5.0, in favor of using CorsConfiguration.applyPermitDefaultValues()
org.springframework.web.bind.annotation.CrossOrigin.DEFAULT_MAX_AGE as of Spring 5.0, in favor of using CorsConfiguration.applyPermitDefaultValues()
org.springframework.web.bind.annotation.CrossOrigin.DEFAULT_ORIGINS as of Spring 5.0, in favor of using CorsConfiguration.applyPermitDefaultValues()

Deprecated Methods

Method and Description
org.springframework.cache.support.AbstractCacheManager.addCache(Cache) as of Spring 4.3, in favor of AbstractCacheManager.getMissingCache(String)
org.springframework.web.servlet.support.WebContentGenerator.applyCacheSeconds(HttpServletResponse, int, boolean) as of 4.2, in favor of WebContentGenerator.applyCacheControl(javax.servlet.http.HttpServletResponse, org.springframework.http.CacheControl)
org.springframework.test.web.client.MockRestServiceServer.bindTo(AsyncRestTemplate) see deprecation notice on AsyncRestTemplate itself
org.springframework.web.servlet.support.WebContentGenerator.cacheForSeconds(HttpServletResponse, int) as of 4.2, in favor of WebContentGenerator.applyCacheControl(javax.servlet.http.HttpServletResponse, org.springframework.http.CacheControl)
org.springframework.web.servlet.support.WebContentGenerator.cacheForSeconds(HttpServletResponse, int, boolean) as of 4.2, in favor of WebContentGenerator.applyCacheControl(javax.servlet.http.HttpServletResponse, org.springframework.http.CacheControl)
org.springframework.web.servlet.support.WebContentGenerator.checkAndPrepare(HttpServletRequest, HttpServletResponse, boolean) as of 4.2, since the lastModified flag is effectively ignored, with a must-revalidate header only generated if explicitly configured
org.springframework.web.servlet.support.WebContentGenerator.checkAndPrepare(HttpServletRequest, HttpServletResponse, int, boolean) as of 4.2, since the lastModified flag is effectively ignored, with a must-revalidate header only generated if explicitly configured
org.springframework.test.web.client.MockRestServiceServer.createServer(AsyncRestTemplate) see deprecation notice on AsyncRestTemplate itself
org.springframework.context.support.AbstractApplicationContext.destroy() as of Spring Framework 5.0, in favor of AbstractApplicationContext.close()
org.springframework.util.Assert.doesNotContain(String, String) as of 4.3.7, in favor of Assert.doesNotContain(String, String, String)
org.springframework.mock.web.MockHttpServletResponse.encodeRedirectUrl(String)
org.springframework.mock.web.MockHttpServletResponse.encodeUrl(String)
org.springframework.test.web.servlet.request.MockMvcRequestBuilders.fileUpload(String, Object...) in favor of MockMvcRequestBuilders.multipart(String, Object...)
org.springframework.test.web.servlet.request.MockMvcRequestBuilders.fileUpload(URI) in favor of MockMvcRequestBuilders.multipart(URI)
org.springframework.core.MethodParameter.forMethodOrConstructor(Object, int) as of 5.0, in favor of MethodParameter.forExecutable(java.lang.reflect.Executable, int)
org.springframework.mock.web.MockPageContext.getExpressionEvaluator()
org.apache.commons.logging.LogFactory.getFactory() in favor of LogFactory.getLog(Class)/LogFactory.getLog(String)
org.springframework.http.client.HttpComponentsAsyncClientHttpRequestFactory.getHttpAsyncClient() as of 4.3.10, in favor of HttpComponentsAsyncClientHttpRequestFactory.getAsyncClient()
org.springframework.web.client.DefaultResponseErrorHandler.getHttpStatusCode(ClientHttpResponse) as of 5.0, in favor of DefaultResponseErrorHandler.handleError(ClientHttpResponse, HttpStatus)
org.apache.commons.logging.LogFactory.getInstance(Class<?>) in favor of LogFactory.getLog(Class)
org.apache.commons.logging.LogFactory.getInstance(String) in favor of LogFactory.getLog(String)
org.springframework.mock.web.MockHttpServletRequest.getRealPath(String)
org.springframework.mock.web.MockServletContext.getServlet(String)
org.springframework.mock.web.MockServletContext.getServletNames()
org.springframework.mock.web.MockServletContext.getServlets()
org.springframework.mock.web.MockPageContext.getVariableResolver()
org.springframework.util.ObjectUtils.hashCode(boolean) as of Spring Framework 5.0, in favor of the native JDK 8 variant
org.springframework.util.ObjectUtils.hashCode(double) as of Spring Framework 5.0, in favor of the native JDK 8 variant
org.springframework.util.ObjectUtils.hashCode(float) as of Spring Framework 5.0, in favor of the native JDK 8 variant
org.springframework.util.ObjectUtils.hashCode(long) as of Spring Framework 5.0, in favor of the native JDK 8 variant
org.springframework.util.Assert.hasLength(String) as of 4.3.7, in favor of Assert.hasLength(String, String)
org.springframework.util.Assert.hasText(String) as of 4.3.7, in favor of Assert.hasText(String, String)
org.springframework.web.bind.support.WebBindingInitializer.initBinder(WebDataBinder, WebRequest) as of 5.0 in favor of WebBindingInitializer.initBinder(WebDataBinder)
org.springframework.beans.BeanUtils.instantiate(Class<T>) as of Spring 5.0, following the deprecation of Class.newInstance() in JDK 9
org.springframework.web.servlet.support.WebContentGenerator.isAlwaysMustRevalidate() as of 4.2, in favor of WebContentGenerator.getCacheControl()
org.springframework.test.web.servlet.result.StatusResultMatchers.isDestinationLocked() matching the deprecation of HttpStatus.DESTINATION_LOCKED
org.springframework.test.web.servlet.result.StatusResultMatchers.isInsufficientSpaceOnResource() matching the deprecation of HttpStatus.INSUFFICIENT_SPACE_ON_RESOURCE
org.springframework.test.web.servlet.result.StatusResultMatchers.isMethodFailure() matching the deprecation of HttpStatus.METHOD_FAILURE
org.springframework.test.web.servlet.result.StatusResultMatchers.isMovedTemporarily() in favor of StatusResultMatchers.isFound()
org.springframework.util.Assert.isNull(Object) as of 4.3.7, in favor of Assert.isNull(Object, String)
org.springframework.mock.web.MockHttpServletRequest.isRequestedSessionIdFromUrl()
org.springframework.test.web.servlet.result.StatusResultMatchers.isRequestEntityTooLarge() matching the deprecation of HttpStatus.REQUEST_ENTITY_TOO_LARGE
org.springframework.test.web.servlet.result.StatusResultMatchers.isRequestUriTooLong() matching the deprecation of HttpStatus.REQUEST_URI_TOO_LONG
org.springframework.util.Assert.isTrue(boolean) as of 4.3.7, in favor of Assert.isTrue(boolean, String)
org.springframework.web.servlet.support.WebContentGenerator.isUseCacheControlHeader() as of 4.2, in favor of WebContentGenerator.getCacheControl()
org.springframework.web.servlet.support.WebContentGenerator.isUseCacheControlNoStore() as of 4.2, in favor of WebContentGenerator.getCacheControl()
org.springframework.web.servlet.support.WebContentGenerator.isUseExpiresHeader() as of 4.2, in favor of WebContentGenerator.getCacheControl()
org.springframework.test.web.servlet.result.StatusResultMatchers.isUseProxy() matching the deprecation of HttpStatus.USE_PROXY
org.springframework.mock.web.MockServletContext.log(Exception, String)
org.springframework.asm.ClassWriter.newHandle(int, String, String, String) this method is superseded by ClassWriter.newHandle(int, String, String, String, boolean).
org.springframework.util.Assert.noNullElements(Object[]) as of 4.3.7, in favor of Assert.noNullElements(Object[], String)
org.springframework.util.Assert.notEmpty(Collection<?>) as of 4.3.7, in favor of Assert.notEmpty(Collection, String)
org.springframework.util.Assert.notEmpty(Map<?, ?>) as of 4.3.7, in favor of Assert.notEmpty(Map, String)
org.springframework.util.Assert.notEmpty(Object[]) as of 4.3.7, in favor of Assert.notEmpty(Object[], String)
org.springframework.util.Assert.notNull(Object) as of 4.3.7, in favor of Assert.notNull(Object, String)
org.springframework.orm.hibernate5.support.OpenSessionInterceptor.openSession() as of 5.0, in favor of OpenSessionInterceptor.openSession(SessionFactory)
org.springframework.web.servlet.support.WebContentGenerator.preventCaching(HttpServletResponse) as of 4.2, in favor of WebContentGenerator.applyCacheControl(javax.servlet.http.HttpServletResponse, org.springframework.http.CacheControl)
org.springframework.context.support.PropertySourcesPlaceholderConfigurer.processProperties(ConfigurableListableBeanFactory, Properties) in favor of PropertySourcesPlaceholderConfigurer.processProperties(ConfigurableListableBeanFactory, ConfigurablePropertyResolver)
org.springframework.scheduling.config.ScheduledTaskRegistrar.scheduleFixedDelayTask(IntervalTask) as of 5.0.2, in favor of ScheduledTaskRegistrar.scheduleFixedDelayTask(FixedDelayTask)
org.springframework.scheduling.config.ScheduledTaskRegistrar.scheduleFixedRateTask(IntervalTask) as of 5.0.2, in favor of ScheduledTaskRegistrar.scheduleFixedRateTask(FixedRateTask)
org.springframework.web.servlet.support.WebContentGenerator.setAlwaysMustRevalidate(boolean) as of 4.2, in favor of WebContentGenerator.setCacheControl(org.springframework.http.CacheControl)
org.springframework.http.client.HttpComponentsAsyncClientHttpRequestFactory.setHttpAsyncClient(CloseableHttpAsyncClient) as of 4.3.10, in favor of HttpComponentsAsyncClientHttpRequestFactory.setAsyncClient(HttpAsyncClient)
org.springframework.messaging.simp.config.ChannelRegistration.setInterceptors(ChannelInterceptor...) as of 4.3.12, in favor of ChannelRegistration.interceptors(ChannelInterceptor...)
org.springframework.mock.web.MockHttpServletResponse.setStatus(int, String)
org.springframework.web.servlet.support.WebContentGenerator.setUseCacheControlHeader(boolean) as of 4.2, since going forward, the HTTP 1.1 cache-control header will be required, with the HTTP 1.0 headers disappearing
org.springframework.web.servlet.support.WebContentGenerator.setUseCacheControlNoStore(boolean) as of 4.2, in favor of WebContentGenerator.setCacheControl(org.springframework.http.CacheControl)
org.springframework.web.servlet.support.WebContentGenerator.setUseExpiresHeader(boolean) as of 4.2, since going forward, the HTTP 1.1 cache-control header will be required, with the HTTP 1.0 headers disappearing
org.springframework.web.accept.PathExtensionContentNegotiationStrategy.setUseJaf(boolean) as of 5.0, in favor of AbstractMappingContentNegotiationStrategy.setUseRegisteredExtensionsOnly(boolean).
org.springframework.web.accept.ContentNegotiationManagerFactoryBean.setUseJaf(boolean) as of 5.0, in favor of ContentNegotiationManagerFactoryBean.setUseRegisteredExtensionsOnly(boolean), which has reverse behavior.
org.springframework.util.Assert.state(boolean) as of 4.3.7, in favor of Assert.state(boolean, String)
org.springframework.web.servlet.config.annotation.ContentNegotiationConfigurer.useJaf(boolean) as of 5.0, in favor of ContentNegotiationConfigurer.useRegisteredExtensionsOnly(boolean) which has reverse behavior
org.springframework.asm.MethodVisitor.visitMethodInsn(int, String, String, String)

Deprecated Constructors

Constructor and Description
org.springframework.web.socket.config.annotation.AbstractWebSocketHandlerRegistration(TaskScheduler) as of 5.0 a TaskScheduler is not provided upfront, not until it is obvious that it is needed, see AbstractWebSocketHandlerRegistration.getSockJsServiceRegistration().
org.springframework.core.io.ClassPathResource(String, ClassLoader, Class<?>) as of 4.3.13, in favor of selective use of ClassPathResource.ClassPathResource(String, ClassLoader) vs ClassPathResource.ClassPathResource(String, Class)
org.springframework.asm.Handle(int, String, String, String) this constructor has been superseded by Handle.Handle(int, String, String, String, boolean).
org.springframework.web.servlet.handler.HandlerMappingIntrospector(ApplicationContext)
org.springframework.web.socket.config.annotation.ServletWebSocketHandlerRegistration(TaskScheduler) as of 5.0 a TaskScheduler is not provided upfront, not until it is obvious that it is needed, see AbstractWebSocketHandlerRegistration.getSockJsServiceRegistration().
org.springframework.web.socket.config.annotation.ServletWebSocketHandlerRegistry(ThreadPoolTaskScheduler) as of 5.0 a TaskScheduler is not provided upfront, not until it is obvious that it is needed, see ServletWebSocketHandlerRegistry.requiresTaskScheduler() and ServletWebSocketHandlerRegistry.setTaskScheduler(org.springframework.scheduling.TaskScheduler).
org.springframework.web.socket.config.annotation.SockJsServiceRegistration(TaskScheduler) as of 5.0 a TaskScheduler is not provided upfront, not until it is obvious that it is needed; call SockJsServiceRegistration.getTaskScheduler() to check and then SockJsServiceRegistration.setTaskScheduler(TaskScheduler) to set it before a call to SockJsServiceRegistration.createSockJsService()

Deprecated Enum Constants

Enum Constant and Description
org.springframework.http.HttpStatus.DESTINATION_LOCKED See WebDAV Draft Changes
org.springframework.http.HttpStatus.INSUFFICIENT_SPACE_ON_RESOURCE See WebDAV Draft Changes
org.springframework.http.HttpStatus.METHOD_FAILURE See WebDAV Draft Changes
org.springframework.http.HttpStatus.MOVED_TEMPORARILY in favor of HttpStatus.FOUND which will be returned from HttpStatus.valueOf(302)
org.springframework.http.HttpStatus.REQUEST_ENTITY_TOO_LARGE in favor of HttpStatus.PAYLOAD_TOO_LARGE which will be returned from HttpStatus.valueOf(413)
org.springframework.http.HttpStatus.REQUEST_URI_TOO_LONG in favor of HttpStatus.URI_TOO_LONG which will be returned from HttpStatus.valueOf(414)
org.springframework.http.HttpStatus.USE_PROXY due to security concerns regarding in-band configuration of a proxy