Deprecated API

Contents

• Terminally Deprecated
• Interfaces
• Classes
• Exceptions
• Fields
• Methods
• Constructors
• Enum Constants

Terminally Deprecated Elements

Element	Description
org.springframework.http.client.ClientHttpResponse.getRawStatusCode()	in favor of ClientHttpResponse.getStatusCode(), for removal in 7.0
org.springframework.http.client.HttpComponentsClientHttpRequestFactory.setBufferRequestBody(boolean)	since 6.1 requests are never buffered, as if this property is false
org.springframework.http.client.OkHttp3ClientHttpRequestFactory	since 6.1, in favor of other ClientHttpRequestFactory implementations; scheduled for removal in 7.0
org.springframework.http.client.reactive.ClientHttpResponse.getRawStatusCode()	in favor of ClientHttpResponse.getStatusCode(), for removal in 7.0
org.springframework.http.client.ReactorClientHttpRequestFactory.setExchangeTimeout(long)	as of 6.2 and no longer set by default (previously 5 seconds) in favor of using Reactor Netty HttpClient timeout configuration.
org.springframework.http.client.ReactorClientHttpRequestFactory.setExchangeTimeout(Duration)	as of 6.2 and no longer set by default (previously 5 seconds) in favor of using Reactor Netty HttpClient timeout configuration.
org.springframework.http.client.ReactorNettyClientRequestFactory	in favor of the renamed ReactorClientHttpRequestFactory
org.springframework.http.client.SimpleClientHttpRequestFactory.setBufferRequestBody(boolean)	since 6.1 requests are never buffered, as if this property is false
org.springframework.http.client.SimpleClientHttpRequestFactory.setOutputStreaming(boolean)	as of 6.1 requests are always streamed, as if this property is true
org.springframework.http.HttpHeaders.writableHttpHeaders(HttpHeaders)	as of 6.2 in favor of HttpHeaders(MultiValueMap).
org.springframework.http.MediaType.APPLICATION_GRAPHQL	as of 6.0.3, in favor of MediaType.APPLICATION_GRAPHQL_RESPONSE
org.springframework.http.MediaType.APPLICATION_GRAPHQL_VALUE	as of 6.0.3, in favor of MediaType.APPLICATION_GRAPHQL_RESPONSE_VALUE
org.springframework.http.MediaType.QUALITY_VALUE_COMPARATOR	As of 6.0, with no direct replacement
org.springframework.http.MediaType.sortByQualityValue(List<MediaType>)	As of 6.0, with no direct replacement
org.springframework.http.MediaType.sortBySpecificity(List<MediaType>)	As of 6.0, in favor of MimeTypeUtils.sortBySpecificity(List)
org.springframework.http.MediaType.SPECIFICITY_COMPARATOR	As of 6.0, with no direct replacement
org.springframework.http.server.reactive.ServerHttpResponse.getRawStatusCode()	in favor of ServerHttpResponse.getStatusCode(), for removal in 7.0
org.springframework.web.bind.MissingServletRequestParameterException(String, String, boolean)	in favor of MissingServletRequestParameterException(String, MethodParameter, boolean)
org.springframework.web.filter.reactive.ServerHttpObservationFilter	since 6.1 in favor of WebHttpHandlerBuilder.
org.springframework.web.server.handler.ResponseStatusExceptionHandler.determineRawStatusCode(Throwable)	in favor of ResponseStatusExceptionHandler.determineStatus(Throwable), for removal in 7.0
org.springframework.web.service.invoker.HttpClientAdapter	in favor of ReactorHttpExchangeAdapter
org.springframework.web.util.UriComponentsBuilder.fromHttpRequest(HttpRequest)	in favor of ForwardedHeaderUtils.adaptFromForwardedHeaders(java.net.URI, org.springframework.http.HttpHeaders); to be removed in 7.0
org.springframework.web.util.UriComponentsBuilder.fromOriginHeader(String)	in favor of UriComponentsBuilder.fromUriString(String); to be removed in 7.0

Deprecated Interfaces

Interface	Description
org.springframework.web.service.invoker.HttpClientAdapter	in favor of ReactorHttpExchangeAdapter

Deprecated Classes

Class	Description
org.springframework.http.client.OkHttp3ClientHttpRequestFactory	since 6.1, in favor of other ClientHttpRequestFactory implementations; scheduled for removal in 7.0
org.springframework.http.client.reactive.ReactorResourceFactory	since 6.1 due to a package change; use ReactorResourceFactory instead.
org.springframework.http.client.ReactorNettyClientRequestFactory	in favor of the renamed ReactorClientHttpRequestFactory
org.springframework.web.accept.PathExtensionContentNegotiationStrategy	as of 5.2.4. See class-level note in ContentNegotiationManagerFactoryBean on the deprecation of path extension config options.
org.springframework.web.accept.ServletPathExtensionContentNegotiationStrategy	as of 5.2.4. See class-level note in ContentNegotiationManagerFactoryBean on the deprecation of path extension config options.
org.springframework.web.filter.reactive.ServerHttpObservationFilter	since 6.1 in favor of WebHttpHandlerBuilder.
org.springframework.web.util.CookieGenerator	as of 6.0 in favor of ResponseCookie

Deprecated Exceptions

Exceptions	Description
org.springframework.web.util.NestedServletException	as of 6.0, in favor of standard ServletException nesting

Deprecated Fields

Field	Description
org.springframework.http.MediaType.APPLICATION_GRAPHQL	as of 6.0.3, in favor of MediaType.APPLICATION_GRAPHQL_RESPONSE
org.springframework.http.MediaType.APPLICATION_GRAPHQL_VALUE	as of 6.0.3, in favor of MediaType.APPLICATION_GRAPHQL_RESPONSE_VALUE
org.springframework.http.MediaType.APPLICATION_JSON_UTF8	as of 5.2 in favor of MediaType.APPLICATION_JSON since major browsers like Chrome now comply with the specification and interpret correctly UTF-8 special characters without requiring a charset=UTF-8 parameter.
org.springframework.http.MediaType.APPLICATION_JSON_UTF8_VALUE	as of 5.2 in favor of MediaType.APPLICATION_JSON_VALUE since major browsers like Chrome now comply with the specification and interpret correctly UTF-8 special characters without requiring a charset=UTF-8 parameter.
org.springframework.http.MediaType.APPLICATION_PROBLEM_JSON_UTF8	as of 5.2 in favor of MediaType.APPLICATION_PROBLEM_JSON since major browsers like Chrome now comply with the specification and interpret correctly UTF-8 special characters without requiring a charset=UTF-8 parameter.
org.springframework.http.MediaType.APPLICATION_PROBLEM_JSON_UTF8_VALUE	as of 5.2 in favor of MediaType.APPLICATION_PROBLEM_JSON_VALUE since major browsers like Chrome now comply with the specification and interpret correctly UTF-8 special characters without requiring a charset=UTF-8 parameter.
org.springframework.http.MediaType.APPLICATION_STREAM_JSON	as of 5.3, see notice on MediaType.APPLICATION_STREAM_JSON_VALUE.
org.springframework.http.MediaType.APPLICATION_STREAM_JSON_VALUE	as of 5.3 since it originates from the W3C Activity Streams specification which has a more specific purpose and has been since replaced with a different mime type. Use MediaType.APPLICATION_NDJSON as a replacement or any other line-delimited JSON format (for example, JSON Lines, JSON Text Sequences).
org.springframework.http.MediaType.QUALITY_VALUE_COMPARATOR	As of 6.0, with no direct replacement
org.springframework.http.MediaType.SPECIFICITY_COMPARATOR	As of 6.0, with no direct replacement

Deprecated Methods

Method	Description
org.springframework.http.client.ClientHttpResponse.getRawStatusCode()	in favor of ClientHttpResponse.getStatusCode(), for removal in 7.0
org.springframework.http.client.HttpComponentsClientHttpRequestFactory.setBufferRequestBody(boolean)	since 6.1 requests are never buffered, as if this property is false
org.springframework.http.client.reactive.ClientHttpResponse.getRawStatusCode()	in favor of ClientHttpResponse.getStatusCode(), for removal in 7.0
org.springframework.http.client.ReactorClientHttpRequestFactory.setExchangeTimeout(long)	as of 6.2 and no longer set by default (previously 5 seconds) in favor of using Reactor Netty HttpClient timeout configuration.
org.springframework.http.client.ReactorClientHttpRequestFactory.setExchangeTimeout(Duration)	as of 6.2 and no longer set by default (previously 5 seconds) in favor of using Reactor Netty HttpClient timeout configuration.
org.springframework.http.client.SimpleClientHttpRequestFactory.setBufferRequestBody(boolean)	since 6.1 requests are never buffered, as if this property is false
org.springframework.http.client.SimpleClientHttpRequestFactory.setOutputStreaming(boolean)	as of 6.1 requests are always streamed, as if this property is true
org.springframework.http.codec.CodecConfigurer.CustomCodecs.decoder(Decoder<?>)	as of 5.1.13, use CodecConfigurer.CustomCodecs.register(Object) or CodecConfigurer.CustomCodecs.registerWithDefaultConfig(Object) instead.
org.springframework.http.codec.CodecConfigurer.CustomCodecs.encoder(Encoder<?>)	as of 5.1.13, use CodecConfigurer.CustomCodecs.register(Object) or CodecConfigurer.CustomCodecs.registerWithDefaultConfig(Object) instead.
org.springframework.http.codec.CodecConfigurer.CustomCodecs.reader(HttpMessageReader<?>)	as of 5.1.13, use CodecConfigurer.CustomCodecs.register(Object) or CodecConfigurer.CustomCodecs.registerWithDefaultConfig(Object) instead.
org.springframework.http.codec.CodecConfigurer.CustomCodecs.withDefaultCodecConfig(Consumer<CodecConfigurer.DefaultCodecConfig>)	as of 5.1.13, use CodecConfigurer.CustomCodecs.registerWithDefaultConfig(Object) or CodecConfigurer.CustomCodecs.registerWithDefaultConfig(Object, Consumer) instead.
org.springframework.http.codec.CodecConfigurer.CustomCodecs.writer(HttpMessageWriter<?>)	as of 5.1.13, use CodecConfigurer.CustomCodecs.register(Object) or CodecConfigurer.CustomCodecs.registerWithDefaultConfig(Object) instead.
org.springframework.http.ContentDisposition.Builder.creationDate(ZonedDateTime)	since 5.2.3 as per RFC 6266, Appendix B, to be removed in a future release.
org.springframework.http.ContentDisposition.Builder.modificationDate(ZonedDateTime)	since 5.2.3 as per RFC 6266, Appendix B, to be removed in a future release.
org.springframework.http.ContentDisposition.Builder.readDate(ZonedDateTime)	since 5.2.3 as per RFC 6266, Appendix B, to be removed in a future release.
org.springframework.http.ContentDisposition.Builder.size(Long)	since 5.2.3 as per RFC 6266, Appendix B, to be removed in a future release.
org.springframework.http.ContentDisposition.getCreationDate()	since 5.2.3 as per RFC 6266, Appendix B, to be removed in a future release.
org.springframework.http.ContentDisposition.getModificationDate()	since 5.2.3 as per RFC 6266, Appendix B, to be removed in a future release.
org.springframework.http.ContentDisposition.getReadDate()	since 5.2.3 as per RFC 6266, Appendix B, to be removed in a future release.
org.springframework.http.ContentDisposition.getSize()	since 5.2.3 as per RFC 6266, Appendix B, to be removed in a future release.
org.springframework.http.HttpHeaders.writableHttpHeaders(HttpHeaders)	as of 6.2 in favor of HttpHeaders(MultiValueMap).
org.springframework.http.HttpStatus.Series.valueOf(HttpStatus)	as of 5.3, in favor of invoking HttpStatus.series() directly
org.springframework.http.MediaType.sortByQualityValue(List<MediaType>)	As of 6.0, with no direct replacement
org.springframework.http.MediaType.sortBySpecificity(List<MediaType>)	As of 6.0, in favor of MimeTypeUtils.sortBySpecificity(List)
org.springframework.http.MediaType.sortBySpecificityAndQuality(List<MediaType>)	As of 6.0, in favor of MimeTypeUtils.sortBySpecificity(List)
org.springframework.http.ResponseEntity.getStatusCodeValue()	as of 6.0, in favor of ResponseEntity.getStatusCode(); scheduled for removal in 7.0
org.springframework.http.server.reactive.AbstractListenerWriteProcessor.writingPaused()	originally introduced for Undertow to stop write notifications when no data is available, but deprecated as of 5.0.6 since constant switching on every requested item causes a significant slowdown.
org.springframework.http.server.reactive.ServerHttpResponse.getRawStatusCode()	in favor of ServerHttpResponse.getStatusCode(), for removal in 7.0
org.springframework.http.server.reactive.ServerHttpResponseDecorator.getRawStatusCode()
org.springframework.web.accept.ContentNegotiationManagerFactoryBean.setFavorPathExtension(boolean)	as of 5.2.4. See class-level note on the deprecation of path extension config options. As there is no replacement for this method, in 5.2.x it is necessary to set it to false. In 5.3 the default changes to false and use of this property becomes unnecessary.
org.springframework.web.accept.ContentNegotiationManagerFactoryBean.setIgnoreUnknownPathExtensions(boolean)	as of 5.2.4. See class-level note on the deprecation of path extension config options.
org.springframework.web.accept.ContentNegotiationManagerFactoryBean.setUseJaf(boolean)	as of 5.0, in favor of ContentNegotiationManagerFactoryBean.setUseRegisteredExtensionsOnly(boolean), which has reverse behavior.
org.springframework.web.accept.PathExtensionContentNegotiationStrategy.setUseJaf(boolean)	as of 5.0, in favor of AbstractMappingContentNegotiationStrategy.setUseRegisteredExtensionsOnly(boolean).
org.springframework.web.client.DefaultResponseErrorHandler.hasError(int)	in favor of DefaultResponseErrorHandler.hasError(HttpStatusCode)
org.springframework.web.client.RestClientResponseException.getRawStatusCode()	in favor of RestClientResponseException.getStatusCode(), for removal in 7.0
org.springframework.web.client.RestTemplate.doExecute(URI, HttpMethod, RequestCallback, ResponseExtractor<T>)	in favor of RestTemplate.doExecute(URI, String, HttpMethod, RequestCallback, ResponseExtractor)
org.springframework.web.client.UnknownContentTypeException.getRawStatusCode()	in favor of UnknownContentTypeException.getStatusCode(), for removal in 7.0
org.springframework.web.context.support.AbstractRefreshableWebApplicationContext.getTheme(String)
org.springframework.web.context.support.GenericWebApplicationContext.getTheme(String)
org.springframework.web.context.support.StaticWebApplicationContext.getTheme(String)
org.springframework.web.cors.reactive.CorsUtils.isSameOrigin(ServerHttpRequest)	as of 5.2, same-origin checks are performed directly by CorsUtils.isCorsRequest(org.springframework.http.server.reactive.ServerHttpRequest)
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.setLookupPathAttributeName(String)	as of 5.3 in favor of UrlPathHelper.PATH_ATTRIBUTE.
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.method.support.ModelAndViewContainer.setIgnoreDefaultModelOnRedirect(boolean)	as of 6.0 without a replacement; once removed, the default model will always be ignored on redirect
org.springframework.web.server.handler.ResponseStatusExceptionHandler.determineRawStatusCode(Throwable)	in favor of ResponseStatusExceptionHandler.determineStatus(Throwable), for removal in 7.0
org.springframework.web.server.MethodNotAllowedException.getResponseHeaders()	as of 6.0 in favor of MethodNotAllowedException.getHeaders()
org.springframework.web.server.NotAcceptableStatusException.getResponseHeaders()	as of 6.0 in favor of NotAcceptableStatusException.getHeaders()
org.springframework.web.server.ResponseStatusException.getResponseHeaders()	as of 6.0 in favor of ResponseStatusException.getHeaders()
org.springframework.web.server.UnsupportedMediaTypeStatusException.getResponseHeaders()	as of 6.0 in favor of UnsupportedMediaTypeStatusException.getHeaders()
org.springframework.web.util.pattern.PathPatternParser.isMatchOptionalTrailingSeparator()	as of 6.0 together with PathPatternParser.setMatchOptionalTrailingSeparator(boolean).
org.springframework.web.util.pattern.PathPatternParser.setMatchOptionalTrailingSeparator(boolean)	transparent support for trailing slashes is deprecated as of 6.0 in favor of configuring explicit redirects through a proxy, Servlet/web filter, or a controller.
org.springframework.web.util.UriComponentsBuilder.fromHttpRequest(HttpRequest)	in favor of ForwardedHeaderUtils.adaptFromForwardedHeaders(java.net.URI, org.springframework.http.HttpHeaders); to be removed in 7.0
org.springframework.web.util.UriComponentsBuilder.fromHttpUrl(String)	as of 6.2, in favor of UriComponentsBuilder.fromUriString(String); scheduled for removal in 7.0.
org.springframework.web.util.UriComponentsBuilder.fromOriginHeader(String)	in favor of UriComponentsBuilder.fromUriString(String); to be removed in 7.0
org.springframework.web.util.UrlPathHelper.getLookupPathForRequest(HttpServletRequest, String)	as of 5.3 in favor of using UrlPathHelper.resolveAndCacheLookupPath(HttpServletRequest) and UrlPathHelper.getResolvedLookupPath(ServletRequest).

Deprecated Constructors

Constructor	Description
org.springframework.http.client.reactive.JettyClientHttpConnector(JettyResourceFactory, Consumer<HttpClient>)	as of 5.2, in favor of JettyClientHttpConnector(HttpClient, JettyResourceFactory)
org.springframework.http.converter.HttpMessageNotReadableException(String)	as of 5.1, in favor of HttpMessageNotReadableException(String, HttpInputMessage)
org.springframework.http.converter.HttpMessageNotReadableException(String, Throwable)	as of 5.1, in favor of HttpMessageNotReadableException(String, Throwable, HttpInputMessage)
org.springframework.web.bind.MissingServletRequestParameterException(String, String, boolean)	in favor of MissingServletRequestParameterException(String, MethodParameter, boolean)
org.springframework.web.HttpMediaTypeException(String)	as of 6.0
org.springframework.web.HttpMediaTypeException(String, List<MediaType>)	as of 6.0

Deprecated Enum Constants

Enum Constant	Description
org.springframework.http.HttpStatus.CHECKPOINT	in favor of HttpStatus.EARLY_HINTS which will be returned from HttpStatus.valueOf(103)
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