Spring Lifecycle组件

简要介绍

Lifecycle组件是为了扩展bean的生命周期功能而增加的,它还有一个直接子类为SmartLifecycle接口,该接口能够控制组件生命周期的执行顺序。

下面是接口定义

public interface Lifecycle {

    
    void start();

    
    void stop();

    
    boolean isRunning();

}
public interface SmartLifecycle extends Lifecycle, Phased {

   
    int DEFAULT_PHASE = Integer.MAX_VALUE;

   
    default boolean isAutoStartup() {
        return true;
    }

    default void stop(Runnable callback) {
        stop();
        callback.run();
    }

  
    @Override
    default int getPhase() {
        return DEFAULT_PHASE;
    }
}

SmartLifecycle和Lifecycle区别如下

  • 实现SmartLifecycle接口的bean,在ApplicationContext初始化完成后(所有单例bean都已初始化),如果isAutoStartup方法返回true,则会自动调用start方法。而Lifecycle接口则需要手动调用ApplicationContext的start方法来触发。
  • SmartLifecycle接口可以控制执行顺序,它继承了Phased接口,getPhase方法返回的值越小,start()则越先调用,stop方法越晚执行。Spring内部执行时按照Phase分组执行的,同一个Phase下的SmartLifecycle只能通过依赖关系干预执行顺序,Ordered接口无能为力。
  • SmartLifecycle增加了一个带有回调接口的stop,这样组件可以异步停止,回调callback是spring自己传递,就是一个CountDownLatch执行countDown方法,而主线程会执行CountDownLatch的await方法,等待组件stop方法执行完毕,当然这个等待时间由spring.lifecycle.timeout-per-shutdown-phase控制的,默认是30s。该参数不是等待所有的Lifecycle,执行时会根据phase来分组,是指每一个组的Lifecycle最多执行spring.lifecycle.timeout-per-shutdown-phase这么久,超了这个时间就执行下一个组了。
  • 另外ApplicationContext执行close方法时,不论是Lifecycle还是SmartLifecycle都会执行,前提是isRunning方法返回true。此时Lifecycle的phase会给0来参与分组排序。

因此只需要使用SmartLifecycle即可。

另外一个细节就是isRunning方法了,spring在调用start方法之前会先判断isRunning方法是不是返回false,调用stop方法之前会判断isRunning方法是不是返回true

实现模板

public class SimpleLifecycle implements SmartLifecycle {

    /**
     * 使用volatile修饰
     */
    private volatile boolean running;

    @Override
    public void start() {
        running = true;
        // doSomething
    }

    @Override
    public void stop() {
        running = false;
        // doSomething
    }

    @Override
    public boolean isRunning() {
        return running;
    }

    /**
     * 根据需要指定顺序
     */
    @Override
    public int getPhase() {
        return 0;
    }
}

执行时机源码

start生命周期

AbstractApplicationContext类

refresh -> finishRefresh -> getLifecycleProcessor().onRefresh()

触发SmartLifecycle执行的类为LifecycleProcessor

stop生命周期

AbstractApplicationContext类

close -> doClose -> lifecycleProcessor.onClose()

servlet容器优雅关闭

servlet容器的启动和关闭就是通过SmartLifecycle来实现的

WebServerStartStopLifecycle

用于正常启动和关闭servlet容器

WebServerGracefulShutdownLifecycle

用于优雅停机,和WebServerStartStopLifecycle搭配使用。

  • 开启优雅停机属性才会将它注册到Spring容器中, server.shutdown=graceful

  • 它的phase比WebServerStartStopLifecycle的大,因此它的start方法会比WebServerStartStopLifecycle晚执行,stop方法执行顺序则先于WebServerStartStopLifecycle

  • 它最终会启动一个异步线程去关闭servlet容器的Connector,这样servlet容器就会停止处理新的请求,然后循环等待现有请求执行完毕(通过判断正在执行的请求数是否等于0)。当所有请求执行完毕后,会执行Spring传入的callback,将CountDownLatch计数减1,Spring便可以执行下一个phase下的SmartLifecycle,当然了如果所有请求迟迟没有结束,Spring也只会最多等待spring.lifecycle.timeout-per-shutdown-phase秒(其实就是调用CountDownLatch的await),当Spring执行下一个phase下的SmartLifecycle时,WebServerStartStopLifecycle的stop方法就会执行了,同时会修改WebServerGracefulShutdownLifecycle循环的标记,这样子即便等待所有请求执行完成这个条件没有满足,也能终止循环,终止这个异步线程。

posted on 2026-02-28 20:34  wastonl  阅读(35)  评论(0)    收藏  举报