Deprecated API

Contents

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

Deprecated Interfaces

Interface and Description
org.springframework.core.ConcurrentMap as of Spring 3.0, since standard ConcurrentMap is available on Java 5+ anyway
org.springframework.remoting.jaxrpc.JaxRpcServicePostProcessor in favor of JAX-WS support in org.springframework.remoting.jaxws
org.springframework.core.enums.LabeledEnum as of Spring 3.0, in favor of Java 5 enums.
org.springframework.core.enums.LabeledEnumResolver as of Spring 3.0, in favor of Java 5 enums.
org.springframework.ejb.support.SmartSessionBean as of Spring 3.2, in favor of implementing EJBs in EJB 3 style

Deprecated Classes

Class and Description
org.springframework.core.enums.AbstractCachingLabeledEnumResolver as of Spring 3.0, in favor of Java 5 enums.
org.springframework.ejb.support.AbstractEnterpriseBean as of Spring 3.2, in favor of implementing EJBs in EJB 3 style
org.springframework.core.enums.AbstractGenericLabeledEnum as of Spring 3.0, in favor of Java 5 enums.
org.springframework.ejb.support.AbstractJmsMessageDrivenBean as of Spring 3.2, in favor of implementing EJBs in EJB 3 style
org.springframework.core.enums.AbstractLabeledEnum as of Spring 3.0, in favor of Java 5 enums.
org.springframework.ejb.support.AbstractMessageDrivenBean as of Spring 3.2, in favor of implementing EJBs in EJB 3 style
org.springframework.ejb.support.AbstractSessionBean as of Spring 3.2, in favor of implementing EJBs in EJB 3 style
org.springframework.ejb.support.AbstractStatefulSessionBean as of Spring 3.2, in favor of implementing EJBs in EJB 3 style
org.springframework.ejb.support.AbstractStatelessSessionBean as of Spring 3.2, in favor of implementing EJBs in EJB 3 style
org.springframework.beans.factory.config.BeanReferenceFactoryBean as of Spring 3.2, in favor of using regular bean name aliases (which support placeholder parsing since Spring 2.5)
org.springframework.util.CachingMapDecorator as of Spring 3.2, to be removed along with LabeledEnum support
org.springframework.http.client.CommonsClientHttpRequestFactory In favor of HttpComponentsClientHttpRequestFactory
org.springframework.beans.factory.config.CommonsLogFactoryBean as of Spring 3.2, in favor of a bean definition that points to the bean class "org.apache.commons.logging.LogFactory" and the factory method "getLog", passing in the log name as constructor argument
org.springframework.jms.listener.DefaultMessageListenerContainer102 as of Spring 3.0, in favor of the JMS 1.1 based DefaultMessageListenerContainer
org.springframework.scheduling.timer.DelegatingTimerTask as of Spring 3.0, in favor of the scheduling.concurrent package which is based on Java 5's java.util.concurrent.ExecutorService
org.springframework.web.jsf.DelegatingVariableResolver as of Spring 3.2, in favor of the JSF 1.2 based SpringBeanFacesELResolver
org.springframework.web.util.ExpressionEvaluationUtils as of Spring 3.2, in favor of the JSP 2.0+ native support for embedded expressions in JSP pages (also applying to tag attributes)
org.springframework.remoting.jaxrpc.JaxRpcPortClientInterceptor in favor of JAX-WS support in org.springframework.remoting.jaxws
org.springframework.remoting.jaxrpc.JaxRpcPortProxyFactoryBean in favor of JAX-WS support in org.springframework.remoting.jaxws
org.springframework.jms.core.JmsTemplate102 as of Spring 3.0, in favor of the JMS 1.1 based JmsTemplate
org.springframework.jms.connection.JmsTransactionManager102 as of Spring 3.0, in favor of the JMS 1.1 based JmsTransactionManager
org.springframework.core.enums.LetterCodedLabeledEnum as of Spring 3.0, in favor of Java 5 enums.
org.springframework.remoting.jaxrpc.LocalJaxRpcServiceFactory in favor of JAX-WS support in org.springframework.remoting.jaxws
org.springframework.remoting.jaxrpc.LocalJaxRpcServiceFactoryBean in favor of JAX-WS support in org.springframework.remoting.jaxws
org.springframework.jms.listener.adapter.MessageListenerAdapter102 as of Spring 3.0, in favor of the JMS 1.1 based MessageListenerAdapter
org.springframework.scheduling.timer.MethodInvokingTimerTaskFactoryBean as of Spring 3.0, in favor of the scheduling.concurrent package which is based on Java 5's java.util.concurrent.ExecutorService
org.springframework.transaction.jta.OC4JJtaTransactionManager as of Spring 3.2, in favor of WebLogicJtaTransactionManager since Oracle end-of-lifed OC4J in favor of WebLogic
org.springframework.instrument.classloading.oc4j.OC4JLoadTimeWeaver as of Spring 3.2, in favor of WebLogicLoadTimeWeaver since Oracle end-of-lifed OC4J in favor of WebLogic
org.springframework.scheduling.timer.ScheduledTimerTask as of Spring 3.0, in favor of the scheduling.concurrent package which is based on Java 5's java.util.concurrent.ExecutorService
org.springframework.web.context.support.ServletContextFactoryBean as of Spring 3.0, since "servletContext" is now available as a default bean in every WebApplicationContext
org.springframework.web.context.support.ServletContextPropertyPlaceholderConfigurer in Spring 3.1 in favor of PropertySourcesPlaceholderConfigurer in conjunction with StandardServletEnvironment.
org.springframework.remoting.jaxrpc.ServletEndpointSupport in favor of JAX-WS support in org.springframework.remoting.jaxws
org.springframework.core.enums.ShortCodedLabeledEnum as of Spring 3.0, in favor of Java 5 enums.
org.springframework.jms.support.converter.SimpleMessageConverter102 as of Spring 3.0, in favor of the JMS 1.1 based SimpleMessageConverter
org.springframework.jms.listener.SimpleMessageListenerContainer102 as of Spring 3.0, in favor of the JMS 1.1 based SimpleMessageListenerContainer
org.springframework.jms.connection.SingleConnectionFactory102 as of Spring 3.0, in favor of the JMS 1.1 based SingleConnectionFactory
org.springframework.web.jsf.SpringBeanVariableResolver as of Spring 3.2, in favor of the JSF 1.2 based SpringBeanFacesELResolver
org.springframework.core.enums.StaticLabeledEnum as of Spring 3.0, in favor of Java 5 enums.
org.springframework.core.enums.StaticLabeledEnumResolver as of Spring 3.0, in favor of Java 5 enums.
org.springframework.core.enums.StringCodedLabeledEnum as of Spring 3.0, in favor of Java 5 enums.
org.springframework.scheduling.timer.TimerFactoryBean as of Spring 3.0, in favor of the scheduling.concurrent package which is based on Java 5's java.util.concurrent.ExecutorService
org.springframework.scheduling.timer.TimerTaskExecutor as of Spring 3.0, in favor of the scheduling.concurrent package which is based on Java 5's java.util.concurrent.ExecutorService
org.springframework.transaction.interceptor.TransactionAspectUtils as of Spring 3.1.2 in favor of BeanFactoryUtils
org.springframework.web.jsf.WebApplicationContextVariableResolver as of Spring 3.2, in favor of the JSF 1.2 based WebApplicationContextFacesELResolver
org.springframework.http.converter.xml.XmlAwareFormHttpMessageConverter in favor of AllEncompassingFormHttpMessageConverter
org.springframework.beans.factory.xml.XmlBeanFactory as of Spring 3.1 in favor of DefaultListableBeanFactory and XmlBeanDefinitionReader

Deprecated Enums

Enum and Description
org.springframework.expression.spel.support.ReflectionHelper.ArgsMatchKind in its public form as of Spring 3.2.7, since there is no need to refer to this directly...

Deprecated Exceptions

Exceptions and Description
org.springframework.remoting.jaxrpc.JaxRpcSoapFaultException in favor of JAX-WS support in org.springframework.remoting.jaxws

Deprecated Fields

Field and Description
org.springframework.scheduling.config.AnnotationDrivenBeanDefinitionParser.ASYNC_ANNOTATION_PROCESSOR_BEAN_NAME as of Spring 3.1 in favor of AnnotationConfigUtils.ASYNC_ANNOTATION_PROCESSOR_BEAN_NAME
org.springframework.scheduling.config.AnnotationDrivenBeanDefinitionParser.ASYNC_EXECUTION_ASPECT_BEAN_NAME as of Spring 3.1 in favor of AnnotationConfigUtils.ASYNC_EXECUTION_ASPECT_BEAN_NAME
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.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.xml.BeanDefinitionParserDelegate.BEAN_NAME_DELIMITERS as of Spring 3.1 in favor of BeanDefinitionParserDelegate.MULTI_VALUE_ATTRIBUTE_DELIMITERS
org.springframework.web.util.CookieGenerator.DEFAULT_COOKIE_MAX_AGE in favor of setting no max age value at all in such a case
org.springframework.core.env.EnumerablePropertySource.EMPTY_NAMES_ARRAY
org.springframework.jmx.support.MBeanRegistrationSupport.REGISTRATION_FAIL_ON_EXISTING since Spring 3.2, in favor of RegistrationPolicy.FAIL_ON_EXISTING
org.springframework.jmx.support.MBeanRegistrationSupport.REGISTRATION_IGNORE_EXISTING since Spring 3.2, in favor of RegistrationPolicy.IGNORE_EXISTING
org.springframework.jmx.support.MBeanRegistrationSupport.REGISTRATION_REPLACE_EXISTING since Spring 3.2, in favor of RegistrationPolicy.REPLACE_EXISTING
org.springframework.scheduling.config.AnnotationDrivenBeanDefinitionParser.SCHEDULED_ANNOTATION_PROCESSOR_BEAN_NAME as of Spring 3.1 in favor of AnnotationConfigUtils.SCHEDULED_ANNOTATION_PROCESSOR_BEAN_NAME

Deprecated Methods

Method and Description
org.springframework.aop.framework.AdvisedSupport.addAllAdvisors(Advisor[]) as of Spring 3.0, in favor of AdvisedSupport.addAdvisors(org.springframework.aop.Advisor...)
org.springframework.ui.ModelMap.addAllObjects(Collection) as of Spring 2.5, in favor of ModelMap.addAllAttributes(Collection)
org.springframework.ui.ModelMap.addAllObjects(Map) as of Spring 2.5, in favor of ModelMap.addAllAttributes(Map)
org.springframework.beans.factory.support.BeanDefinitionBuilder.addConstructorArg(Object) since Spring 2.5, in favor of BeanDefinitionBuilder.addConstructorArgValue(java.lang.Object)
org.springframework.core.convert.support.ConversionServiceFactory.addDefaultConverters(GenericConversionService) in Spring 3.1 in favor of DefaultConversionService.addDefaultConverters(ConverterRegistry)
org.springframework.context.support.AbstractApplicationContext.addListener(ApplicationListener<?>) as of Spring 3.0, in favor of AbstractApplicationContext.addApplicationListener(org.springframework.context.ApplicationListener<?>)
org.springframework.ui.ModelMap.addObject(Object) as of Spring 2.5, in favor of ModelMap.addAttribute(Object)
org.springframework.ui.ModelMap.addObject(String, Object) as of Spring 2.5, in favor of ModelMap.addAttribute(String, Object)
org.springframework.web.bind.WebDataBinder.bindMultipartFiles(Map<String, MultipartFile>, MutablePropertyValues) as of Spring 3.0, in favor of WebDataBinder.bindMultipart(java.util.Map<java.lang.String, java.util.List<org.springframework.web.multipart.MultipartFile>>, org.springframework.beans.MutablePropertyValues) which binds all multipart files, even if more than one sent for the same name
org.springframework.core.CollectionFactory.createConcurrentMap(int) as of Spring 3.0, for usage on JDK 1.5 or higher
org.springframework.core.CollectionFactory.createConcurrentMapIfPossible(int) as of Spring 3.0, for usage on JDK 1.5 or higher
org.springframework.web.context.ContextLoaderListener.createContextLoader() in favor of simply subclassing ContextLoaderListener itself (which extends ContextLoader, as of Spring 3.0)
org.springframework.core.CollectionFactory.createCopyOnWriteSet() as of Spring 3.0, for usage on JDK 1.5 or higher
org.springframework.core.convert.support.ConversionServiceFactory.createDefaultConversionService() in Spring 3.1 in favor of DefaultConversionService()
org.springframework.beans.factory.xml.DefaultBeanDefinitionDocumentReader.createHelper(XmlReaderContext, Element, BeanDefinitionParserDelegate)
org.springframework.core.CollectionFactory.createIdentityMapIfPossible(int) as of Spring 2.5, for usage on JDK 1.4 or higher
org.springframework.beans.factory.config.PropertiesFactoryBean.createInstance() as of Spring 3.0, in favor of PropertiesFactoryBean.createProperties()
org.springframework.core.CollectionFactory.createLinkedCaseInsensitiveMapIfPossible(int) as of Spring 3.0, for usage on JDK 1.5 or higher
org.springframework.core.CollectionFactory.createLinkedMapIfPossible(int) as of Spring 2.5, for usage on JDK 1.4 or higher
org.springframework.core.CollectionFactory.createLinkedSetIfPossible(int) as of Spring 2.5, for usage on JDK 1.4 or higher
org.springframework.transaction.interceptor.TransactionAspectSupport.createTransactionIfNecessary(Method, Class) in favor of TransactionAspectSupport.createTransactionIfNecessary(PlatformTransactionManager, TransactionAttribute, String)
org.springframework.web.context.ContextLoader.createWebApplicationContext(ServletContext, ApplicationContext) as of Spring 3.1 in favor of ContextLoader.createWebApplicationContext(ServletContext) and ContextLoader.configureAndRefreshWebApplicationContext(ConfigurableWebApplicationContext, ServletContext)
org.springframework.remoting.rmi.RmiClientInterceptorUtils.doInvoke(MethodInvocation, Remote) as of Spring 2.5, in favor of RmiClientInterceptorUtils.invokeRemoteMethod(org.aopalliance.intercept.MethodInvocation, java.lang.Object)
org.springframework.web.util.UriUtils.encodeHttpUrl(String, String) in favor of UriComponentsBuilder; see note about query param encoding
org.springframework.web.util.UriTemplate.encodeUri(String) No longer in use; to be removed in Spring 4.0.
org.springframework.web.util.UriUtils.encodeUri(String, String) in favor of UriComponentsBuilder; see note about query param encoding
org.springframework.web.util.UriUtils.encodeUriComponents(String, String, String, String, String, String, String, String, String) in favor of UriComponentsBuilder
org.springframework.aop.config.AopNamespaceUtils.forceAutoProxyCreatorToUseClassProxying(BeanDefinitionRegistry) since Spring 2.5, in favor of AopConfigUtils.forceAutoProxyCreatorToUseClassProxying(BeanDefinitionRegistry)
org.springframework.util.ClassUtils.forName(String) as of Spring 3.0, in favor of specifying a ClassLoader explicitly: see ClassUtils.forName(String, ClassLoader)
org.springframework.web.context.ContextLoaderListener.getContextLoader() in favor of simply subclassing ContextLoaderListener itself (which extends ContextLoader, as of Spring 3.0)
org.springframework.core.convert.TypeDescriptor.getElementType() in Spring 3.1 in favor of TypeDescriptor.getElementTypeDescriptor()
org.springframework.validation.DataBinder.getErrors() in favor of DataBinder.getBindingResult(). Use the BindException(BindingResult) constructor to create a BindException instance if still needed.
org.springframework.http.HttpHeaders.getIfNotModifiedSince() use HttpHeaders.getIfModifiedSince()
org.springframework.core.convert.TypeDescriptor.getMapKeyType() in Spring 3.1 in favor of TypeDescriptor.getMapKeyTypeDescriptor()
org.springframework.core.convert.TypeDescriptor.getMapValueType() in Spring 3.1 in favor of TypeDescriptor.getMapValueTypeDescriptor()
org.springframework.transaction.interceptor.TransactionAspectUtils.getTransactionManager(BeanFactory, String) as of Spring 3.1.2 in favor of BeanFactoryAnnotationUtils.qualifiedBeanOfType(BeanFactory, Class, String)
org.springframework.transaction.interceptor.TransactionAspectUtils.getTransactionManager(ConfigurableListableBeanFactory, String) as of Spring 3.1.2 in favor of BeanFactoryAnnotationUtils.qualifiedBeanOfType(BeanFactory, Class, String)
org.springframework.format.support.FormattingConversionServiceFactoryBean.installFormatters(FormatterRegistry) since Spring 3.1 in favor of FormattingConversionServiceFactoryBean.setFormatterRegistrars(Set)
org.springframework.remoting.rmi.RmiClientInterceptorUtils.invoke(MethodInvocation, Remote, String) as of Spring 2.5, in favor of RmiClientInterceptorUtils.invokeRemoteMethod(org.aopalliance.intercept.MethodInvocation, java.lang.Object)
org.springframework.core.JdkVersion.isAtLeastJava14() as of Spring 3.0 which requires Java 1.5+
org.springframework.core.JdkVersion.isAtLeastJava15() as of Spring 3.0 which requires Java 1.5+
org.springframework.core.JdkVersion.isAtLeastJava16() as of Spring 3.0, in favor of reflective checks for the specific Java 1.6 classes of interest
org.springframework.aop.support.AopUtils.isCglibProxyClass(Class<?>) as of Spring 3.1 in favor of ClassUtils.isCglibProxyClass(Class)
org.springframework.aop.support.AopUtils.isCglibProxyClassName(String) as of Spring 3.1 in favor of ClassUtils.isCglibProxyClassName(String)
org.springframework.beans.factory.xml.AbstractSimpleBeanDefinitionParser.isEligibleAttribute(Attr) in favour of AbstractSimpleBeanDefinitionParser.isEligibleAttribute(org.w3c.dom.Attr, ParserContext)
org.springframework.util.ClassUtils.isPresent(String) as of Spring 2.5, in favor of ClassUtils.isPresent(String, ClassLoader)
org.springframework.transaction.interceptor.TransactionAspectSupport.methodIdentification(Method) in favor of TransactionAspectSupport.methodIdentification(Method, Class)
org.springframework.beans.factory.support.AbstractBeanDefinition.overrideFrom(AbstractBeanDefinition) since Spring 2.5, in favor of AbstractBeanDefinition.overrideFrom(BeanDefinition)
org.springframework.beans.factory.config.PropertyPlaceholderConfigurer.parseStringValue(String, Properties, Set<?>) as of Spring 3.0, in favor of using PropertyPlaceholderConfigurer.resolvePlaceholder(java.lang.String, java.util.Properties, int) with PropertyPlaceholderHelper. Only retained for compatibility with Spring 2.5 extensions.
org.springframework.context.support.PropertySourcesPlaceholderConfigurer.processProperties(ConfigurableListableBeanFactory, Properties) in favor of PropertySourcesPlaceholderConfigurer.processProperties(ConfigurableListableBeanFactory, ConfigurablePropertyResolver)
org.springframework.aop.config.AopNamespaceUtils.registerAutoProxyCreatorIfNecessary(ParserContext, Object) since Spring 2.5, in favor of AopNamespaceUtils.registerAutoProxyCreatorIfNecessary(ParserContext, Element) and AopConfigUtils.registerAutoProxyCreatorIfNecessary(BeanDefinitionRegistry, Object)
org.springframework.beans.PropertyEditorRegistrySupport.registerSharedEditor(Class<?>, PropertyEditor) as of Spring 3.0, in favor of PropertyEditorRegistrars or ConversionService usage
org.springframework.core.GenericTypeResolver.resolveReturnTypeForGenericMethod(Method, Object[]) in favor of resolveReturnTypeForFactoryMethod in the internal AutowireUtils class in the beans module; we do not expect other use of it!
org.springframework.oxm.xstream.XStreamMarshaller.setAnnotatedClass(Class<?>) in favor of XStreamMarshaller.setAnnotatedClasses(java.lang.Class<?>...) with varargs
org.springframework.beans.factory.xml.DefaultBeanDefinitionDocumentReader.setEnvironment(Environment)
org.springframework.beans.factory.xml.BeanDefinitionDocumentReader.setEnvironment(Environment) in favor of Environment access via XmlReaderContext
org.springframework.beans.factory.support.BeanDefinitionBuilder.setFactoryBean(String, String) since Spring 2.5, in favor of preparing this on the raw BeanDefinition object
org.springframework.oxm.castor.CastorMarshaller.setObject(Object) in favor of CastorMarshaller.setRootObject(java.lang.Object)
org.springframework.jmx.support.MBeanRegistrationSupport.setRegistrationBehavior(int) since Spring 3.2, in favor of MBeanRegistrationSupport.setRegistrationPolicy(RegistrationPolicy)
org.springframework.jmx.support.MBeanRegistrationSupport.setRegistrationBehaviorName(String) since Spring 3.2, in favor of MBeanRegistrationSupport.setRegistrationPolicy(RegistrationPolicy)
org.springframework.beans.factory.support.BeanDefinitionBuilder.setResourceDescription(String) since Spring 2.5, in favor of preparing this on the raw BeanDefinition object
org.springframework.beans.factory.support.AbstractBeanDefinition.setSingleton(boolean) since Spring 2.5, in favor of AbstractBeanDefinition.setScope(java.lang.String)
org.springframework.beans.factory.support.BeanDefinitionBuilder.setSingleton(boolean) since Spring 2.5, in favor of BeanDefinitionBuilder.setScope(java.lang.String)
org.springframework.beans.factory.support.BeanDefinitionBuilder.setSource(Object) since Spring 2.5, in favor of preparing this on the raw BeanDefinition object

Deprecated Constructors

Constructor and Description
org.springframework.beans.factory.support.AbstractBeanDefinition(AbstractBeanDefinition) since Spring 2.5, in favor of AbstractBeanDefinition(BeanDefinition)
org.springframework.core.io.support.ResourceArrayPropertyEditor(ResourcePatternResolver) as of 3.1 in favor of ResourceArrayPropertyEditor(ResourcePatternResolver, PropertyResolver)
org.springframework.core.io.support.ResourceArrayPropertyEditor(ResourcePatternResolver, boolean) as of 3.1 in favor of ResourceArrayPropertyEditor(ResourcePatternResolver, PropertyResolver, boolean)
org.springframework.core.io.ResourceEditor(ResourceLoader) as of Spring 3.1 in favor of ResourceEditor(ResourceLoader, PropertyResolver)
org.springframework.core.io.ResourceEditor(ResourceLoader, boolean) as of Spring 3.1 in favor of ResourceEditor(ResourceLoader, PropertyResolver, boolean)
org.springframework.beans.support.ResourceEditorRegistrar(ResourceLoader) as of Spring 3.1 in favor of ResourceEditorRegistrar(ResourceLoader, PropertyResolver)
org.springframework.beans.factory.support.RootBeanDefinition(Class, boolean) since Spring 2.5, in favor of AbstractBeanDefinition.setScope(java.lang.String)
org.springframework.beans.factory.support.RootBeanDefinition(Class, int) as of Spring 3.0, in favor of AbstractBeanDefinition.setAutowireMode(int) usage
org.springframework.beans.factory.support.RootBeanDefinition(Class, MutablePropertyValues) as of Spring 3.0, in favor of AbstractBeanDefinition.getPropertyValues() usage
org.springframework.beans.factory.support.RootBeanDefinition(Class, MutablePropertyValues, boolean) since Spring 2.5, in favor of AbstractBeanDefinition.setScope(java.lang.String)

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)