Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• 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.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.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 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.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.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