package org.springframework.beans.factory;
/**
* Interface to be implemented by beans that want to release resources on destruction.
* A {@link BeanFactory} will invoke the destroy method on individual destruction of a
* scoped bean. An {@link org.springframework.context.ApplicationContext} is supposed
* to dispose all of its singletons on shutdown, driven by the application lifecycle.
*
* A Spring-managed bean may also implement Java's {@link AutoCloseable} interface
* for the same purpose. An alternative to implementing an interface is specifying a
* custom destroy method, for example in an XML bean definition. For a list of all
* bean lifecycle methods, see the {@link BeanFactory BeanFactory javadocs}.
*
* @author Juergen Hoeller
* @since 12.08.2003
* @see InitializingBean
* @see org.springframework.beans.factory.support.RootBeanDefinition#getDestroyMethodName()
* @see org.springframework.beans.factory.config.ConfigurableBeanFactory#destroySingletons()
* @see org.springframework.context.ConfigurableApplicationContext#close()
*/
public interface DisposableBean {
/**
* Invoked by the containing {@code BeanFactory} on destruction of a bean.
* @throws Exception in case of shutdown errors. Exceptions will get logged
* but not rethrown to allow other beans to release their resources as well.
*/
void destroy() throws Exception;
}
简介
org.springframework.beans.factory.Aware 的一个子接口。
文档
要在销毁时释放资源的 bean 所实现的接口。BeanFactory 将在 有作用域的bean 单独销毁时调用 destroy 方法。 一个 org.springframework.context.ApplicationContext 应该在应用程序生命周期的驱动下在关闭时处理其所有单例。
出于同样的目的，Spring 管理的bean 也可以实现 Java 的 AutoCloseable 接口。 实现接口的替代方法是指定自定义的 destroy 方法，例如在 XML bean定义 中。
有关所有 bean生命周期 方法的列表，请参见 BeanFactory javadocs。
destroy
由包含 BeanFactory 的销毁 bean 调用。
@throws 在关闭错误的情况下发生异常。 异常将被记录，但不会重新抛出以允许其他bean也释放其资源。