Deprecated API

Contents

• Deprecated Classes
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors

Deprecated Classes

Class and Description
org.springframework.web.servlet.resource.AppCacheManifestTransformer as of 5.3 since browser support is going away
org.springframework.web.servlet.resource.GzipResourceResolver as of 5.1, in favor of using EncodedResourceResolver
org.springframework.web.servlet.handler.HandlerInterceptorAdapter as of 5.3 in favor of implementing HandlerInterceptor and/or AsyncHandlerInterceptor directly.
org.springframework.web.servlet.view.ResourceBundleViewResolver as of 5.3, in favor of Spring's common view resolver variants and/or custom resolver implementations
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.web.servlet.view.XmlViewResolver as of 5.3, in favor of Spring's common view resolver variants and/or custom resolver implementations

Deprecated Fields

Field and Description
org.springframework.web.servlet.HandlerMapping.LOOKUP_PATH as of 5.3 in favor of UrlPathHelper.PATH_ATTRIBUTE and ServletRequestPathUtils.PATH_ATTRIBUTE. To access the cached path used for request mapping, use ServletRequestPathUtils.getCachedPathValue(ServletRequest).

Deprecated Methods

Method and Description
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.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.web.servlet.config.annotation.ContentNegotiationConfigurer.favorPathExtension(boolean) as of 5.2.4. See deprecation note on ContentNegotiationManagerFactoryBean.setFavorPathExtension(boolean).
org.springframework.web.servlet.resource.ResourceHttpRequestHandler.getContentNegotiationManager() as of 5.2.4.
org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping.getFileExtensions() as of 5.2.4. See class-level note on the deprecation of path extension config options.
org.springframework.web.servlet.mvc.method.RequestMappingInfo.BuilderConfiguration.getFileExtensions() as of 5.2.4. See class-level note in RequestMappingHandlerMapping on the deprecation of path extension config options.
org.springframework.web.servlet.handler.AbstractHandlerMethodMapping.getMappingPathPatterns(T) as of 5.3 in favor of providing non-pattern mappings via AbstractHandlerMethodMapping.getDirectPaths(Object) instead
org.springframework.web.servlet.mvc.method.RequestMappingInfo.BuilderConfiguration.getUrlPathHelper() as of 5.3, the path is resolved externally and obtained with ServletRequestPathUtils.getCachedPathValue(ServletRequest); this method always returns UrlPathHelper.defaultInstance.
org.springframework.web.servlet.config.annotation.ContentNegotiationConfigurer.ignoreUnknownPathExtensions(boolean) as of 5.2.4. See deprecation note on ContentNegotiationManagerFactoryBean.setIgnoreUnknownPathExtensions(boolean).
org.springframework.web.servlet.resource.ResourceHttpRequestHandler.initContentNegotiationStrategy() as of 5.2.4 this method returns null, and if a sub-class returns an actual instance,the instance is used only as a source of media type mappings, if it contains any. Please, use ResourceHttpRequestHandler.setMediaTypes(Map) instead, or if you need to change behavior, you can override ResourceHttpRequestHandler.getMediaType(HttpServletRequest, Resource).
org.springframework.web.servlet.support.WebContentGenerator.isAlwaysMustRevalidate() as of 4.2, in favor of WebContentGenerator.getCacheControl()
org.springframework.web.servlet.i18n.LocaleChangeInterceptor.isLanguageTagCompliant() as of 5.1 since it always returns true now
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.web.servlet.config.annotation.PathMatchConfigurer.isUseRegisteredSuffixPatternMatch() as of 5.2.4, see deprecation note on PathMatchConfigurer.setUseRegisteredSuffixPatternMatch(Boolean).
org.springframework.web.servlet.config.annotation.PathMatchConfigurer.isUseSuffixPatternMatch() as of 5.2.4, see deprecation note on PathMatchConfigurer.setUseSuffixPatternMatch(Boolean).
org.springframework.web.servlet.config.annotation.PathMatchConfigurer.isUseTrailingSlashMatch()
org.springframework.web.servlet.handler.MappedInterceptor.matches(String, PathMatcher) as of 5.3 in favor of MappedInterceptor.matches(HttpServletRequest)
org.springframework.web.servlet.function.ServerRequest.pathContainer() as of 5.3, in favor on ServerRequest.requestPath()
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.web.servlet.support.WebContentGenerator.setAlwaysMustRevalidate(boolean) as of 4.2, in favor of WebContentGenerator.setCacheControl(org.springframework.http.CacheControl)
org.springframework.web.servlet.mvc.WebContentInterceptor.setAlwaysUseFullPath(boolean) as of 5.3, the path is resolved externally and obtained with ServletRequestPathUtils.getCachedPathValue(ServletRequest)
org.springframework.web.servlet.view.DefaultRequestToViewNameTranslator.setAlwaysUseFullPath(boolean) as of 5.3, the path is resolved externally and obtained with ServletRequestPathUtils.getCachedPathValue(ServletRequest)
org.springframework.web.servlet.resource.ResourceHttpRequestHandler.setContentNegotiationManager(ContentNegotiationManager) as of 5.2.4 in favor of using ResourceHttpRequestHandler.setMediaTypes(Map) with mappings possibly obtained from ContentNegotiationManager.getMediaTypeMappings().
org.springframework.web.servlet.i18n.LocaleChangeInterceptor.setLanguageTagCompliant(boolean) as of 5.1 since it only accepts true now
org.springframework.web.servlet.mvc.method.RequestMappingInfo.BuilderConfiguration.setRegisteredSuffixPatternMatch(boolean) as of 5.2.4. See class-level note in RequestMappingHandlerMapping on the deprecation of path extension config options.
org.springframework.web.servlet.view.DefaultRequestToViewNameTranslator.setRemoveSemicolonContent(boolean) as of 5.3, the path is resolved externally and obtained with ServletRequestPathUtils.getCachedPathValue(ServletRequest)
org.springframework.web.servlet.mvc.method.RequestMappingInfo.BuilderConfiguration.setSuffixPatternMatch(boolean) as of 5.2.4. See deprecation note on RequestMappingHandlerMapping.setUseSuffixPatternMatch(boolean).
org.springframework.web.servlet.mvc.WebContentInterceptor.setUrlDecode(boolean) as of 5.3, the path is resolved externally and obtained with ServletRequestPathUtils.getCachedPathValue(ServletRequest)
org.springframework.web.servlet.view.DefaultRequestToViewNameTranslator.setUrlDecode(boolean) as of 5.3, the path is resolved externally and obtained with ServletRequestPathUtils.getCachedPathValue(ServletRequest)
org.springframework.web.servlet.mvc.method.RequestMappingInfo.BuilderConfiguration.setUrlPathHelper(UrlPathHelper) as of 5.3, the path is resolved externally and obtained with ServletRequestPathUtils.getCachedPathValue(ServletRequest)
org.springframework.web.servlet.mvc.WebContentInterceptor.setUrlPathHelper(UrlPathHelper) as of 5.3, the path is resolved externally and obtained with ServletRequestPathUtils.getCachedPathValue(ServletRequest)
org.springframework.web.servlet.view.DefaultRequestToViewNameTranslator.setUrlPathHelper(UrlPathHelper) as of 5.3, the path is resolved externally and obtained with ServletRequestPathUtils.getCachedPathValue(ServletRequest)
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.servlet.mvc.method.annotation.RequestMappingHandlerMapping.setUseRegisteredSuffixPatternMatch(boolean) as of 5.2.4. See class level note on the deprecation of path extension config options.
org.springframework.web.servlet.config.annotation.PathMatchConfigurer.setUseRegisteredSuffixPatternMatch(Boolean) as of 5.2.4. See class-level note in RequestMappingHandlerMapping on the deprecation of path extension config options.
org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping.setUseSuffixPatternMatch(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.servlet.config.annotation.PathMatchConfigurer.setUseSuffixPatternMatch(Boolean) as of 5.2.4. See class-level note in RequestMappingHandlerMapping 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.servlet.config.annotation.ContentNegotiationConfigurer.useJaf(boolean) as of 5.0, in favor of ContentNegotiationConfigurer.useRegisteredExtensionsOnly(boolean) which has reverse behavior
org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping.useRegisteredSuffixPatternMatch() as of 5.2.4. See deprecation notice on RequestMappingHandlerMapping.setUseRegisteredSuffixPatternMatch(boolean).
org.springframework.web.servlet.mvc.method.RequestMappingInfo.BuilderConfiguration.useRegisteredSuffixPatternMatch() as of 5.2.4. See class-level note in RequestMappingHandlerMapping on the deprecation of path extension config options.
org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping.useSuffixPatternMatch() as of 5.2.4. See deprecation notice on RequestMappingHandlerMapping.setUseSuffixPatternMatch(boolean).
org.springframework.web.servlet.mvc.method.RequestMappingInfo.BuilderConfiguration.useSuffixPatternMatch() as of 5.2.4. See deprecation note on RequestMappingHandlerMapping.setUseSuffixPatternMatch(boolean).

Deprecated Constructors

Constructor and Description
org.springframework.web.servlet.handler.HandlerMappingIntrospector(ApplicationContext) as of 4.3.12, in favor of HandlerMappingIntrospector.setApplicationContext(org.springframework.context.ApplicationContext)
org.springframework.web.servlet.mvc.condition.PatternsRequestCondition(String[], UrlPathHelper, PathMatcher, boolean) as of 5.3 in favor of PatternsRequestCondition.PatternsRequestCondition(String[], boolean, PathMatcher).
org.springframework.web.servlet.mvc.condition.PatternsRequestCondition(String[], UrlPathHelper, PathMatcher, boolean, boolean) as of 5.2.4. See class-level note in RequestMappingHandlerMapping on the deprecation of path extension config options.
org.springframework.web.servlet.mvc.condition.PatternsRequestCondition(String[], UrlPathHelper, PathMatcher, boolean, boolean, List<String>) as of 5.2.4. See class-level note in RequestMappingHandlerMapping on the deprecation of path extension config options.
org.springframework.web.servlet.mvc.method.RequestMappingInfo(PatternsRequestCondition, RequestMethodsRequestCondition, ParamsRequestCondition, HeadersRequestCondition, ConsumesRequestCondition, ProducesRequestCondition, RequestCondition<?>) as of 5.3 in favor using RequestMappingInfo.Builder via RequestMappingInfo.paths(String...).
org.springframework.web.servlet.mvc.method.RequestMappingInfo(RequestMappingInfo, RequestCondition<?>) since 5.3 in favor of using RequestMappingInfo.addCustomCondition(RequestCondition).
org.springframework.web.servlet.mvc.method.RequestMappingInfo(String, PatternsRequestCondition, RequestMethodsRequestCondition, ParamsRequestCondition, HeadersRequestCondition, ConsumesRequestCondition, ProducesRequestCondition, RequestCondition<?>) as of 5.3 in favor using RequestMappingInfo.Builder via RequestMappingInfo.paths(String...).