Deprecated API

Contents

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

Terminally Deprecated Elements

Element	Description
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.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.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 but ensures that collection-iterating methods like entrySet() are case-insensitive
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.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.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.

Deprecated Classes

Class	Description
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.xml.MappingJackson2XmlHttpMessageConverter	since 7.0 in favor of JacksonXmlHttpMessageConverter
org.springframework.http.converter.yaml.MappingJackson2YamlHttpMessageConverter	since 7.0 in favor of JacksonYamlHttpMessageConverter

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.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 but ensures that collection-iterating methods like entrySet() are case-insensitive
org.springframework.http.ResponseEntity.unprocessableEntity()	since 7.0 in favor of ResponseEntity.unprocessableContent()
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.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.

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)

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