The Spring Framework

## Deprecated API

Contents

- Deprecated Interfaces
- Deprecated Classes
- Deprecated Fields
- Deprecated Methods
- Deprecated Constructors

Deprecated Interfaces
org.springframework.jms.listener.serversession.ListenerSessionManager as of Spring 2.5, in favor of DefaultMessageListenerContainer and JmsMessageEndpointManager. To be removed in Spring 3.0.
org.springframework.beans.support.PagedListSourceProvider as of Spring 2.5, to be removed in Spring 3.0
org.springframework.util.ResponseTimeMonitor as of Spring 2.5, to be removed in Spring 3.0
org.springframework.jms.listener.serversession.ServerSessionFactory as of Spring 2.5, in favor of DefaultMessageListenerContainer and JmsMessageEndpointManager. To be removed in Spring 3.0.
org.springframework.web.servlet.mvc.throwaway.ThrowawayController as of Spring 2.5, in favor of annotation-based controllers. To be removed in Spring 3.0.
org.springframework.beans.factory.xml.XmlBeanDefinitionParser as of Spring 2.0: superseded by BeanDefinitionDocumentReader

Deprecated Classes
org.springframework.web.servlet.handler.metadata.AbstractPathMapHandlerMapping as of Spring 2.5, in favor of annotation-based request mapping. To be removed in Spring 3.0.
org.springframework.jms.listener.serversession.AbstractPoolingServerSessionFactory as of Spring 2.5, in favor of DefaultMessageListenerContainer and JmsMessageEndpointManager. To be removed in Spring 3.0.
org.springframework.aop.interceptor.ClassLoaderAnalyzerInterceptor as of Spring 2.5, to be removed in Spring 3.0
org.springframework.util.ClassLoaderUtils as of Spring 2.5, to be removed in Spring 3.0
org.springframework.web.servlet.handler.metadata.CommonsPathMapHandlerMapping as of Spring 2.5, in favor of annotation-based request mapping. To be removed in Spring 3.0.
org.springframework.jms.listener.serversession.CommonsPoolServerSessionFactory as of Spring 2.5, in favor of DefaultMessageListenerContainer and JmsMessageEndpointManager. To be removed in Spring 3.0.
org.springframework.web.servlet.handler.metadata.PathMap as of Spring 2.5, in favor of annotation-based request mapping. To be removed in Spring 3.0.
org.springframework.web.context.support.PerformanceMonitorListener as of Spring 2.5, to be removed in Spring 3.0. Use a custom ApplicationListener specific to your needs instead.
org.springframework.core.ReflectiveVisitorHelper as of Spring 2.5, to be removed in Spring 3.0
org.springframework.beans.support.RefreshablePagedListHolder as of Spring 2.5, to be removed in Spring 3.0
org.springframework.web.bind.RequestUtils as of Spring 2.0: use ServletRequestUtils instead
org.springframework.util.ResponseTimeMonitorImpl as of Spring 2.5, to be removed in Spring 3.0
org.springframework.jms.listener.serversession.ServerSessionMessageListenerContainer as of Spring 2.5, in favor of DefaultMessageListenerContainer and JmsMessageEndpointManager. To be removed in Spring 3.0.
org.springframework.jms.listener.serversession.ServerSessionMessageListenerContainer102 as of Spring 2.5, in favor of DefaultMessageListenerContainer and JmsMessageEndpointManager. To be removed in Spring 3.0.
org.springframework.jms.listener.serversession.SimpleServerSessionFactory as of Spring 2.5, in favor of DefaultMessageListenerContainer and JmsMessageEndpointManager. To be removed in Spring 3.0.
org.springframework.web.servlet.mvc.throwaway.ThrowawayControllerHandlerAdapter as of Spring 2.5, in favor of annotation-based controllers. To be removed in Spring 3.0.

Deprecated Fields
org.springframework.web.servlet.tags.form.AbstractDataBoundFormElementTag.COMMAND_NAME_VARIABLE_NAME as of Spring 2.5, in favor of `FormTag.MODEL_ATTRIBUTE_VARIABLE_NAME`
org.springframework.core.task.SimpleAsyncTaskExecutor.DEFAULT_THREAD_NAME_PREFIX as of Spring 2.0.3, since the default thread name prefix is now taken from the concrete class (could be a subclass)
org.springframework.validation.BindException.ERROR_KEY_PREFIX in favor of `BindingResult.MODEL_KEY_PREFIX`
org.springframework.web.util.UrlPathHelper.INCLUDE_CONTEXT_PATH_REQUEST_ATTRIBUTE as of Spring 2.0, in favor of `WebUtils.INCLUDE_CONTEXT_PATH_ATTRIBUTE`
org.springframework.web.util.UrlPathHelper.INCLUDE_SERVLET_PATH_REQUEST_ATTRIBUTE as of Spring 2.0, in favor of `WebUtils.INCLUDE_SERVLET_PATH_ATTRIBUTE`
org.springframework.web.util.UrlPathHelper.INCLUDE_URI_REQUEST_ATTRIBUTE as of Spring 2.0, in favor of `WebUtils.INCLUDE_REQUEST_URI_ATTRIBUTE`

Deprecated Methods
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.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.mock.web.MockHttpServletRequest.addRole(String) in favor of addUserRole
org.springframework.orm.jdo.JdoTemplate.attachCopy(Object) in favor of `JdoTemplate.makePersistent(Object)`. To be removed in Spring 3.0.
org.springframework.orm.jdo.JdoOperations.attachCopy(Object) in favor of `JdoOperations.makePersistent(Object)`. To be removed in Spring 3.0.
org.springframework.orm.jdo.JdoTemplate.attachCopyAll(Collection) in favor of `JdoTemplate.makePersistentAll(java.util.Collection)`. To be removed in Spring 3.0.
org.springframework.orm.jdo.JdoOperations.attachCopyAll(Collection) in favor of `JdoOperations.makePersistentAll(java.util.Collection)`. To be removed in Spring 3.0.
org.springframework.beans.factory.support.BeanDefinitionReaderUtils.createBeanDefinition(String, String, ConstructorArgumentValues, MutablePropertyValues, ClassLoader) in favor of `createBeanDefinition(String, String, ClassLoader)`
org.springframework.core.CollectionFactory.createIdentityMapIfPossible(int) as of Spring 2.5, for usage on JDK 1.4 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.scheduling.timer.TimerFactoryBean.createTimer(boolean) as of Spring 2.0.1, in favor of `TimerFactoryBean.createTimer(String, boolean)`
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.beans.BeanWrapperImpl.doTypeConversionIfNecessary(Object, Class) in favor of `convertIfNecessary`
org.springframework.orm.hibernate3.HibernateTemplate.execute(HibernateCallback, boolean) as of Spring 2.5, in favor of `HibernateTemplate.executeWithNativeSession(org.springframework.orm.hibernate3.HibernateCallback)`
org.springframework.beans.factory.xml.NamespaceHandlerSupport.findDecoratorForNode(Node) as of Spring 2.0.2; there should be no need to call this directly.
org.springframework.beans.factory.xml.NamespaceHandlerSupport.findParserForElement(Element) as of Spring 2.0.2; there should be no need to call this directly.
org.springframework.test.annotation.AbstractAnnotationAwareTransactionalTests.findUniqueProfileValueSourceFromContext(ApplicationContext) Use `@ProfileValueSourceConfiguration` instead.
org.springframework.aop.config.AopNamespaceUtils.forceAutoProxyCreatorToUseClassProxying(BeanDefinitionRegistry) since Spring 2.5, in favor of `AopConfigUtils.forceAutoProxyCreatorToUseClassProxying(BeanDefinitionRegistry)`
org.springframework.beans.factory.support.BeanDefinitionReader.getBeanFactory() in favor of the uniformly named `BeanDefinitionReader.getRegistry()`
org.springframework.validation.DataBinder.getErrors() in favor of `DataBinder.getBindingResult()`. Use the `BindException.BindException(BindingResult)` constructor to create a BindException instance if still needed.
org.springframework.web.servlet.view.xslt.AbstractXsltView.getParameters() as of Spring 2.0.4, in favor of the `AbstractXsltView.getParameters(HttpServletRequest)` variant
org.springframework.aop.framework.AopProxyUtils.getTargetClass(Object) as of Spring 2.0.3, in favor of `AopUtils.getTargetClass`
org.springframework.web.servlet.mvc.multiaction.MultiActionController.initBinder(ServletRequest, ServletRequestDataBinder) as of Spring 2.0: use `initBinder(HttpServletRequest, ServletRequestDataBinder)` instead
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.beans.BeanUtils.isAssignable(Class, Class) as of Spring 2.0, in favor of `ClassUtils.isAssignable`
org.springframework.beans.BeanUtils.isAssignable(Class, Object) as of Spring 2.0, in favor of `ClassUtils.isAssignableValue`
org.springframework.instrument.classloading.ShadowingClassLoader.isClassNameExcludedFromShadowing(String) in favor of `ShadowingClassLoader.isEligibleForShadowing(java.lang.String)`
org.springframework.aop.framework.autoproxy.AbstractAutoProxyCreator.isInfrastructureClass(Class, String) in favor of `isInfrastructureClass(beanClass)`
org.springframework.beans.factory.support.AbstractBeanDefinition.overrideFrom(AbstractBeanDefinition) since Spring 2.5, in favor of `AbstractBeanDefinition.overrideFrom(BeanDefinition)`
org.springframework.orm.ibatis.SqlMapClientTemplate.queryForPaginatedList(String, int) as of iBATIS 2.3.0
org.springframework.orm.ibatis.SqlMapClientOperations.queryForPaginatedList(String, int) as of iBATIS 2.3.0
org.springframework.orm.ibatis.SqlMapClientTemplate.queryForPaginatedList(String, Object, int) as of iBATIS 2.3.0
org.springframework.orm.ibatis.SqlMapClientOperations.queryForPaginatedList(String, Object, int) as of iBATIS 2.3.0
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.factory.config.ConfigurableBeanFactory.registerCustomEditor(Class, PropertyEditor) as of Spring 2.0.7, in favor of `ConfigurableBeanFactory.addPropertyEditorRegistrar(org.springframework.beans.PropertyEditorRegistrar)` and `ConfigurableBeanFactory.registerCustomEditor(Class, Class)`
org.springframework.orm.hibernate3.HibernateOperations.saveOrUpdateAll(Collection) as of Spring 2.5, in favor of individual `saveOrUpdate` or `merge` usage
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.beans.factory.xml.XmlBeanDefinitionReader.setParserClass(Class) as of Spring 2.0: superseded by "documentReaderClass"
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`
org.springframework.ui.freemarker.FreeMarkerConfigurationFactory.setTemplateLoaders(TemplateLoader[]) as of Spring 2.0.1, in favor of the "preTemplateLoaders" and "postTemplateLoaders" properties
org.springframework.beans.factory.xml.XmlBeanDefinitionReader.setValidating(boolean) as of Spring 2.0: superseded by "validationMode"
org.springframework.beans.BeanWrapper.setWrappedInstance(Object) as of Spring 2.5, in favor of recreating a BeanWrapper per target instance
org.springframework.web.servlet.mvc.BaseCommandController.suppressValidation(HttpServletRequest) as of Spring 2.0.4, in favor of the `BaseCommandController.suppressValidation(HttpServletRequest, Object)` variant

Deprecated Constructors
org.springframework.beans.factory.support.AbstractBeanDefinition(AbstractBeanDefinition) since Spring 2.5, in favor of `AbstractBeanDefinition.AbstractBeanDefinition(BeanDefinition)`
org.springframework.jdbc.CannotGetJdbcConnectionException(String, ClassNotFoundException) since Spring 2.5, in favor of throwing an IllegalStateException in case of the driver not being found
org.springframework.jdbc.datasource.DriverManagerDataSource(String, String, String, String) since Spring 2.5. DriverManagerDataSource is primarily intended for accessing pre-registered JDBC drivers. If you need to register a new driver, consider using `SimpleDriverDataSource` instead.
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, MutablePropertyValues, boolean) since Spring 2.5, in favor of `AbstractBeanDefinition.setScope(java.lang.String)`
org.springframework.jdbc.datasource.SingleConnectionDataSource(String, String, String, String, boolean) since Spring 2.5. Driver parameter usage is generally not recommended for a SingleConnectionDataSource. If you insist on using driver parameters directly, set up the Driver class manually before invoking this DataSource.

The Spring Framework

Copyright © 2002-2008 The Spring Framework.