Deprecated API

Contents

• Terminally Deprecated
• Interfaces
• Classes
• Exception Classes
• Methods
• Constructors
• Enum Constants

Terminally Deprecated Elements

Element	Description
org.springframework.http.client.support.HttpAccessor	since 7.1 with no replacement.
org.springframework.http.client.support.InterceptingHttpAccessor	since 7.1 with no replacement.
org.springframework.http.codec.cbor.Jackson2CborDecoder	since 7.0 in favor of JacksonCborDecoder
org.springframework.http.codec.cbor.Jackson2CborEncoder	since 7.0 in favor of JacksonCborEncoder
org.springframework.http.codec.CodecConfigurer.DefaultCodecs.jackson2JsonDecoder(Decoder<?>)	in favor of CodecConfigurer.DefaultCodecs.jacksonJsonDecoder(Decoder).
org.springframework.http.codec.CodecConfigurer.DefaultCodecs.jackson2JsonEncoder(Encoder<?>)	in favor of CodecConfigurer.DefaultCodecs.jacksonJsonEncoder(Encoder).
org.springframework.http.codec.CodecConfigurer.DefaultCodecs.jackson2SmileDecoder(Decoder<?>)	in favor of CodecConfigurer.DefaultCodecs.jacksonSmileDecoder(Decoder).
org.springframework.http.codec.CodecConfigurer.DefaultCodecs.jackson2SmileEncoder(Encoder<?>)	in favor of CodecConfigurer.DefaultCodecs.jacksonSmileEncoder(Encoder).
org.springframework.http.codec.json.AbstractJackson2Decoder	since 7.0 in favor of AbstractJacksonDecoder
org.springframework.http.codec.json.AbstractJackson2Encoder	since 7.0 in favor of AbstractJacksonEncoder
org.springframework.http.codec.json.Jackson2CodecSupport	since 7.0 in favor of JacksonCodecSupport
org.springframework.http.codec.json.Jackson2JsonDecoder	since 7.0 in favor of AbstractJacksonDecoder
org.springframework.http.codec.json.Jackson2JsonEncoder	since 7.0 in favor of JacksonJsonEncoder
org.springframework.http.codec.json.Jackson2SmileDecoder	since 7.0 in favor of JacksonSmileDecoder
org.springframework.http.codec.json.Jackson2SmileEncoder	since 7.0 in favor of JacksonSmileEncoder
org.springframework.http.converter.AbstractHttpMessageConverter.supportsRepeatableWrites(T)	since 7.1 in favor of HttpMessageConverter.canWriteRepeatedly(Object, MediaType).
org.springframework.http.converter.cbor.MappingJackson2CborHttpMessageConverter	since 7.0 in favor of JacksonCborHttpMessageConverter
org.springframework.http.converter.json.AbstractJackson2HttpMessageConverter	since 7.0 in favor of AbstractJacksonHttpMessageConverter
org.springframework.http.converter.json.Jackson2ObjectMapperBuilder	since 7.0 in favor using directly Jackson 3 builders like JsonMapper.builder()
org.springframework.http.converter.json.Jackson2ObjectMapperFactoryBean	since 7.0 in favor of using directly Jackson 3 converters default constructor
org.springframework.http.converter.json.MappingJackson2HttpMessageConverter	since 7.0 in favor of JacksonJsonHttpMessageConverter
org.springframework.http.converter.json.MappingJacksonInputMessage	since 7.0 in favor of using SmartHttpMessageConverter hints
org.springframework.http.converter.json.MappingJacksonValue	since 7.0 in favor of using SmartHttpMessageConverter hints
org.springframework.http.converter.json.SpringHandlerInstantiator	since 7.0 in favor of JacksonHandlerInstantiator
org.springframework.http.converter.smile.MappingJackson2SmileHttpMessageConverter	since 7.0 in favor of JacksonSmileHttpMessageConverter
org.springframework.http.converter.support.AllEncompassingFormHttpMessageConverter	since 7.1 in favor of MultipartHttpMessageConverter.
org.springframework.http.converter.xml.MappingJackson2XmlHttpMessageConverter	since 7.0 in favor of JacksonXmlHttpMessageConverter
org.springframework.http.converter.yaml.MappingJackson2YamlHttpMessageConverter	since 7.0 in favor of JacksonYamlHttpMessageConverter
org.springframework.http.HttpEntity(T, MultiValueMap<String, String>)	in favor of HttpEntity(Object, HttpHeaders)
org.springframework.http.HttpEntity(MultiValueMap<String, String>)	in favor of HttpEntity(HttpHeaders)
org.springframework.http.HttpHeaders.asMultiValueMap()	This method is provided for backward compatibility with APIs that would only accept maps. Generally avoid using HttpHeaders as a Map or MultiValueMap.
org.springframework.http.HttpHeaders.asSingleValueMap()	in favor of HttpHeaders.toSingleValueMap() which performs a copy
org.springframework.http.RequestEntity(T, MultiValueMap<String, String>, HttpMethod, URI, Type)	in favor of RequestEntity(Object, HttpHeaders, HttpMethod, URI, Type)
org.springframework.http.RequestEntity(T, MultiValueMap<String, String>, HttpMethod, URI)	in favor of RequestEntity(Object, HttpHeaders, HttpMethod, URI)
org.springframework.http.RequestEntity(MultiValueMap<String, String>, HttpMethod, URI)	in favor of RequestEntity(HttpHeaders, HttpMethod, URI)
org.springframework.http.ResponseEntity(T, MultiValueMap<String, String>, int)	in favor of ResponseEntity(Object, HttpHeaders, int)
org.springframework.http.ResponseEntity(T, MultiValueMap<String, String>, HttpStatusCode)	in favor of ResponseEntity(Object, HttpHeaders, HttpStatusCode)
org.springframework.http.ResponseEntity(MultiValueMap<String, String>, HttpStatusCode)	in favor of ResponseEntity(HttpHeaders, HttpStatusCode)
org.springframework.web.client.DefaultResponseErrorHandler	as of 7.1 in favor of RestClient.ResponseSpec.ErrorHandler
org.springframework.web.client.ExtractingResponseErrorHandler	as of 7.1 in favor of RestClient.ResponseSpec.ErrorHandler
org.springframework.web.client.HttpMessageConverterExtractor	as of 7.1 with no replacement.
org.springframework.web.client.NoOpResponseErrorHandler	as of 7.1 in favor of RestClient.ResponseSpec.ErrorHandler
org.springframework.web.client.RequestCallback	as of 7.1 in favor of RestClient.RequestHeadersSpec.httpRequest(Consumer).
org.springframework.web.client.ResponseErrorHandler	as of 7.1 in favor of RestClient.ResponseSpec.ErrorHandler
org.springframework.web.client.ResponseExtractor	as of 7.1 in favor of RestClient.RequestHeadersSpec.exchange(RestClient.RequestHeadersSpec.ExchangeFunction).
org.springframework.web.client.RestClient.Builder.defaultStatusHandler(ResponseErrorHandler)	as of 7.1 in favor of RestClient.Builder.defaultStatusHandler(Predicate, ResponseSpec.ErrorHandler)
org.springframework.web.client.RestClient.Builder.messageConverters(Iterable<HttpMessageConverter<?>>)	since 7.0 in favor of RestClient.Builder.configureMessageConverters(Consumer)
org.springframework.web.client.RestClient.Builder.messageConverters(Consumer<List<HttpMessageConverter<?>>>)	since 7.0 in favor of RestClient.Builder.configureMessageConverters(Consumer)
org.springframework.web.client.RestClient.ResponseSpec.onStatus(ResponseErrorHandler)	as of 7.1 in favor of RestClient.ResponseSpec.onStatus(Predicate, ErrorHandler)
org.springframework.web.client.RestOperations	as of 7.1, in favor of RestClient.
org.springframework.web.client.RestTemplate	as of 7.1, in favor of RestClient. For removal in 8.0.
org.springframework.web.client.support.RestGatewaySupport	as of 7.1, in favor of RestClient.
org.springframework.web.client.support.RestTemplateAdapter	as of 7.1 in favor of RestClientAdapter.
org.springframework.web.cors.UrlBasedCorsConfigurationSource.setAllowInitLookupPath(boolean)	use of PathMatcher and UrlPathHelper is deprecated for use at runtime in web modules in favor of parsed patterns with PathPatternParser.
org.springframework.web.cors.UrlBasedCorsConfigurationSource.setAlwaysUseFullPath(boolean)	as of 5.3 in favor of using UrlBasedCorsConfigurationSource.setUrlPathHelper(UrlPathHelper), if at all. For further details, please see UrlBasedCorsConfigurationSource.setAllowInitLookupPath(boolean).
org.springframework.web.cors.UrlBasedCorsConfigurationSource.setPathMatcher(PathMatcher)	use of PathMatcher and UrlPathHelper is deprecated for use at runtime in web modules in favor of parsed patterns with PathPatternParser.
org.springframework.web.cors.UrlBasedCorsConfigurationSource.setRemoveSemicolonContent(boolean)	as of 5.3 in favor of using UrlBasedCorsConfigurationSource.setUrlPathHelper(UrlPathHelper), if at all. For further details, please see UrlBasedCorsConfigurationSource.setAllowInitLookupPath(boolean).
org.springframework.web.cors.UrlBasedCorsConfigurationSource.setUrlDecode(boolean)	as of 5.3 in favor of using UrlBasedCorsConfigurationSource.setUrlPathHelper(UrlPathHelper), if at all. For further details, please see UrlBasedCorsConfigurationSource.setAllowInitLookupPath(boolean).
org.springframework.web.cors.UrlBasedCorsConfigurationSource.setUrlPathHelper(UrlPathHelper)	use of PathMatcher and UrlPathHelper is deprecated for use at runtime in web modules in favor of parsed patterns with PathPatternParser.
org.springframework.web.filter.ForwardedHeaderFilter()	as of 7.1, in favor of ForwardedHeaderFilter(boolean)
org.springframework.web.method.annotation.HandlerMethodValidator.determineValidationGroups(Object, Method)
org.springframework.web.server.adapter.ForwardedHeaderTransformer()	as of 7.1, in favor of ForwardedHeaderTransformer(boolean)
org.springframework.web.util.ForwardedHeaderUtils.adaptFromForwardedHeaders(URI, HttpHeaders)	as of 7.1 in favor of ForwardedHeaderUtils.parseStandardHeader(URI, HttpHeaders, InetSocketAddress, InetSocketAddress) and ForwardedHeaderUtils.parseXForwardedHeaders(URI, HttpHeaders, InetSocketAddress, InetSocketAddress)
org.springframework.web.util.ForwardedHeaderUtils.parseForwardedBy(URI, HttpHeaders, InetSocketAddress)	as of 7.1 in favor of ForwardedHeaderUtils.parseStandardHeader(URI, HttpHeaders, InetSocketAddress, InetSocketAddress) and ForwardedHeaderUtils.parseXForwardedHeaders(URI, HttpHeaders, InetSocketAddress, InetSocketAddress)
org.springframework.web.util.ForwardedHeaderUtils.parseForwardedFor(URI, HttpHeaders, InetSocketAddress)	as of 7.1 in favor of ForwardedHeaderUtils.parseStandardHeader(URI, HttpHeaders, InetSocketAddress, InetSocketAddress) and ForwardedHeaderUtils.parseXForwardedHeaders(URI, HttpHeaders, InetSocketAddress, InetSocketAddress)

Deprecated Interfaces

Interface	Description
org.springframework.web.client.RequestCallback	as of 7.1 in favor of RestClient.RequestHeadersSpec.httpRequest(Consumer).
org.springframework.web.client.ResponseErrorHandler	as of 7.1 in favor of RestClient.ResponseSpec.ErrorHandler
org.springframework.web.client.ResponseExtractor	as of 7.1 in favor of RestClient.RequestHeadersSpec.exchange(RestClient.RequestHeadersSpec.ExchangeFunction).
org.springframework.web.client.RestOperations	as of 7.1, in favor of RestClient.

Deprecated Classes

Class	Description
org.springframework.http.client.support.HttpAccessor	since 7.1 with no replacement.
org.springframework.http.client.support.InterceptingHttpAccessor	since 7.1 with no replacement.
org.springframework.http.codec.cbor.Jackson2CborDecoder	since 7.0 in favor of JacksonCborDecoder
org.springframework.http.codec.cbor.Jackson2CborEncoder	since 7.0 in favor of JacksonCborEncoder
org.springframework.http.codec.json.AbstractJackson2Decoder	since 7.0 in favor of AbstractJacksonDecoder
org.springframework.http.codec.json.AbstractJackson2Encoder	since 7.0 in favor of AbstractJacksonEncoder
org.springframework.http.codec.json.Jackson2CodecSupport	since 7.0 in favor of JacksonCodecSupport
org.springframework.http.codec.json.Jackson2JsonDecoder	since 7.0 in favor of AbstractJacksonDecoder
org.springframework.http.codec.json.Jackson2JsonEncoder	since 7.0 in favor of JacksonJsonEncoder
org.springframework.http.codec.json.Jackson2SmileDecoder	since 7.0 in favor of JacksonSmileDecoder
org.springframework.http.codec.json.Jackson2SmileEncoder	since 7.0 in favor of JacksonSmileEncoder
org.springframework.http.converter.cbor.MappingJackson2CborHttpMessageConverter	since 7.0 in favor of JacksonCborHttpMessageConverter
org.springframework.http.converter.json.AbstractJackson2HttpMessageConverter	since 7.0 in favor of AbstractJacksonHttpMessageConverter
org.springframework.http.converter.json.Jackson2ObjectMapperBuilder	since 7.0 in favor using directly Jackson 3 builders like JsonMapper.builder()
org.springframework.http.converter.json.Jackson2ObjectMapperFactoryBean	since 7.0 in favor of using directly Jackson 3 converters default constructor
org.springframework.http.converter.json.MappingJackson2HttpMessageConverter	since 7.0 in favor of JacksonJsonHttpMessageConverter
org.springframework.http.converter.json.MappingJacksonInputMessage	since 7.0 in favor of using SmartHttpMessageConverter hints
org.springframework.http.converter.json.MappingJacksonValue	since 7.0 in favor of using SmartHttpMessageConverter hints
org.springframework.http.converter.json.SpringHandlerInstantiator	since 7.0 in favor of JacksonHandlerInstantiator
org.springframework.http.converter.smile.MappingJackson2SmileHttpMessageConverter	since 7.0 in favor of JacksonSmileHttpMessageConverter
org.springframework.http.converter.support.AllEncompassingFormHttpMessageConverter	since 7.1 in favor of MultipartHttpMessageConverter.
org.springframework.http.converter.xml.MappingJackson2XmlHttpMessageConverter	since 7.0 in favor of JacksonXmlHttpMessageConverter
org.springframework.http.converter.yaml.MappingJackson2YamlHttpMessageConverter	since 7.0 in favor of JacksonYamlHttpMessageConverter
org.springframework.web.client.DefaultResponseErrorHandler	as of 7.1 in favor of RestClient.ResponseSpec.ErrorHandler
org.springframework.web.client.ExtractingResponseErrorHandler	as of 7.1 in favor of RestClient.ResponseSpec.ErrorHandler
org.springframework.web.client.HttpMessageConverterExtractor	as of 7.1 with no replacement.
org.springframework.web.client.NoOpResponseErrorHandler	as of 7.1 in favor of RestClient.ResponseSpec.ErrorHandler
org.springframework.web.client.RestTemplate	as of 7.1, in favor of RestClient. For removal in 8.0.
org.springframework.web.client.support.RestGatewaySupport	as of 7.1, in favor of RestClient.
org.springframework.web.client.support.RestTemplateAdapter	as of 7.1 in favor of RestClientAdapter.

Deprecated Exception Classes

Exception Class	Description
org.springframework.web.client.HttpClientErrorException.UnprocessableEntity	since 7.0 in favor of HttpClientErrorException.UnprocessableContent
org.springframework.web.server.PayloadTooLargeException	since 7.0 in favor of ContentTooLargeException

Deprecated Methods

Method	Description
org.springframework.http.codec.CodecConfigurer.DefaultCodecs.jackson2JsonDecoder(Decoder<?>)	in favor of CodecConfigurer.DefaultCodecs.jacksonJsonDecoder(Decoder).
org.springframework.http.codec.CodecConfigurer.DefaultCodecs.jackson2JsonEncoder(Encoder<?>)	in favor of CodecConfigurer.DefaultCodecs.jacksonJsonEncoder(Encoder).
org.springframework.http.codec.CodecConfigurer.DefaultCodecs.jackson2SmileDecoder(Decoder<?>)	in favor of CodecConfigurer.DefaultCodecs.jacksonSmileDecoder(Decoder).
org.springframework.http.codec.CodecConfigurer.DefaultCodecs.jackson2SmileEncoder(Encoder<?>)	in favor of CodecConfigurer.DefaultCodecs.jacksonSmileEncoder(Encoder).
org.springframework.http.converter.AbstractHttpMessageConverter.supportsRepeatableWrites(T)	since 7.1 in favor of HttpMessageConverter.canWriteRepeatedly(Object, MediaType).
org.springframework.http.HttpHeaders.asMultiValueMap()	This method is provided for backward compatibility with APIs that would only accept maps. Generally avoid using HttpHeaders as a Map or MultiValueMap.
org.springframework.http.HttpHeaders.asSingleValueMap()	in favor of HttpHeaders.toSingleValueMap() which performs a copy
org.springframework.http.ResponseEntity.unprocessableEntity()	since 7.0 in favor of ResponseEntity.unprocessableContent()
org.springframework.web.client.RestClient.Builder.defaultStatusHandler(ResponseErrorHandler)	as of 7.1 in favor of RestClient.Builder.defaultStatusHandler(Predicate, ResponseSpec.ErrorHandler)
org.springframework.web.client.RestClient.Builder.messageConverters(Iterable<HttpMessageConverter<?>>)	since 7.0 in favor of RestClient.Builder.configureMessageConverters(Consumer)
org.springframework.web.client.RestClient.Builder.messageConverters(Consumer<List<HttpMessageConverter<?>>>)	since 7.0 in favor of RestClient.Builder.configureMessageConverters(Consumer)
org.springframework.web.client.RestClient.ResponseSpec.onStatus(ResponseErrorHandler)	as of 7.1 in favor of RestClient.ResponseSpec.onStatus(Predicate, ErrorHandler)
org.springframework.web.cors.UrlBasedCorsConfigurationSource.setAllowInitLookupPath(boolean)	use of PathMatcher and UrlPathHelper is deprecated for use at runtime in web modules in favor of parsed patterns with PathPatternParser.
org.springframework.web.cors.UrlBasedCorsConfigurationSource.setAlwaysUseFullPath(boolean)	as of 5.3 in favor of using UrlBasedCorsConfigurationSource.setUrlPathHelper(UrlPathHelper), if at all. For further details, please see UrlBasedCorsConfigurationSource.setAllowInitLookupPath(boolean).
org.springframework.web.cors.UrlBasedCorsConfigurationSource.setPathMatcher(PathMatcher)	use of PathMatcher and UrlPathHelper is deprecated for use at runtime in web modules in favor of parsed patterns with PathPatternParser.
org.springframework.web.cors.UrlBasedCorsConfigurationSource.setRemoveSemicolonContent(boolean)	as of 5.3 in favor of using UrlBasedCorsConfigurationSource.setUrlPathHelper(UrlPathHelper), if at all. For further details, please see UrlBasedCorsConfigurationSource.setAllowInitLookupPath(boolean).
org.springframework.web.cors.UrlBasedCorsConfigurationSource.setUrlDecode(boolean)	as of 5.3 in favor of using UrlBasedCorsConfigurationSource.setUrlPathHelper(UrlPathHelper), if at all. For further details, please see UrlBasedCorsConfigurationSource.setAllowInitLookupPath(boolean).
org.springframework.web.cors.UrlBasedCorsConfigurationSource.setUrlPathHelper(UrlPathHelper)	use of PathMatcher and UrlPathHelper is deprecated for use at runtime in web modules in favor of parsed patterns with PathPatternParser.
org.springframework.web.method.annotation.HandlerMethodValidator.determineValidationGroups(Object, Method)
org.springframework.web.util.ForwardedHeaderUtils.adaptFromForwardedHeaders(URI, HttpHeaders)	as of 7.1 in favor of ForwardedHeaderUtils.parseStandardHeader(URI, HttpHeaders, InetSocketAddress, InetSocketAddress) and ForwardedHeaderUtils.parseXForwardedHeaders(URI, HttpHeaders, InetSocketAddress, InetSocketAddress)
org.springframework.web.util.ForwardedHeaderUtils.parseForwardedBy(URI, HttpHeaders, InetSocketAddress)	as of 7.1 in favor of ForwardedHeaderUtils.parseStandardHeader(URI, HttpHeaders, InetSocketAddress, InetSocketAddress) and ForwardedHeaderUtils.parseXForwardedHeaders(URI, HttpHeaders, InetSocketAddress, InetSocketAddress)
org.springframework.web.util.ForwardedHeaderUtils.parseForwardedFor(URI, HttpHeaders, InetSocketAddress)	as of 7.1 in favor of ForwardedHeaderUtils.parseStandardHeader(URI, HttpHeaders, InetSocketAddress, InetSocketAddress) and ForwardedHeaderUtils.parseXForwardedHeaders(URI, HttpHeaders, InetSocketAddress, InetSocketAddress)

Deprecated Constructors

Constructor	Description
org.springframework.http.HttpEntity(T, MultiValueMap<String, String>)	in favor of HttpEntity(Object, HttpHeaders)
org.springframework.http.HttpEntity(MultiValueMap<String, String>)	in favor of HttpEntity(HttpHeaders)
org.springframework.http.RequestEntity(T, MultiValueMap<String, String>, HttpMethod, URI, Type)	in favor of RequestEntity(Object, HttpHeaders, HttpMethod, URI, Type)
org.springframework.http.RequestEntity(T, MultiValueMap<String, String>, HttpMethod, URI)	in favor of RequestEntity(Object, HttpHeaders, HttpMethod, URI)
org.springframework.http.RequestEntity(MultiValueMap<String, String>, HttpMethod, URI)	in favor of RequestEntity(HttpHeaders, HttpMethod, URI)
org.springframework.http.ResponseEntity(T, MultiValueMap<String, String>, int)	in favor of ResponseEntity(Object, HttpHeaders, int)
org.springframework.http.ResponseEntity(T, MultiValueMap<String, String>, HttpStatusCode)	in favor of ResponseEntity(Object, HttpHeaders, HttpStatusCode)
org.springframework.http.ResponseEntity(MultiValueMap<String, String>, HttpStatusCode)	in favor of ResponseEntity(HttpHeaders, HttpStatusCode)
org.springframework.web.filter.ForwardedHeaderFilter()	as of 7.1, in favor of ForwardedHeaderFilter(boolean)
org.springframework.web.server.adapter.ForwardedHeaderTransformer()	as of 7.1, in favor of ForwardedHeaderTransformer(boolean)

Deprecated Enum Constants

Enum Constant	Description
org.springframework.http.HttpStatus.BANDWIDTH_LIMIT_EXCEEDED	since 7.0, this is now unassigned
org.springframework.http.HttpStatus.I_AM_A_TEAPOT	since 7.0, marked as unused in RFC 9110
org.springframework.http.HttpStatus.NOT_EXTENDED	since 7.0, this is now marked as "historic" and not endorsed by a standards body.
org.springframework.http.HttpStatus.PAYLOAD_TOO_LARGE	since 7.0 in favor of HttpStatus.CONTENT_TOO_LARGE
org.springframework.http.HttpStatus.PROCESSING	since 7.0, removed from WebDAV specification
org.springframework.http.HttpStatus.UNPROCESSABLE_ENTITY	since 7.0 in favor of HttpStatus.UNPROCESSABLE_CONTENT