Tomcat4 源代码分析 （16） How Tomcat Works 第十六章

 

Chapter 16 : Shutdown Hook

 

概览

 

    有些时候，我们需要我们的应用在结束时 执行一些clean的代码。但是，不能指望由用户永远按照我们设定的方式退出。

    幸好 JVM 提供了一种方法，能够保证我们的clean up代码一定会执行。

    在java中，jvm在下面两种事件发生时会关闭：

    （1）程序正常退出，即System.exit方法执行。 或， 最后一个非守护线程退出。

    （2）用户强制退出，比如ctrl+c 或者是直接关电脑。

    在关闭时，能确定的事情是 jvm一定会走下面两步：

    （1）jvm启动所有注册的shutdown hooks（如果存在）。

    （2）jvm调用所有的uninvoked finalizers（如果必要）。

 

    下面给出一个简单的例子：

首先 定义一个hook:

ShutdownHook.java

 

 public class ShutdownHook extends Thread {
 
 public void run() {
  
  System.out.println("Shutting Down");
 }
 
}

 

然后，注册这个hook

 

public class ShutdownHookDemo {

 public static void main(String[] args) {
  ShutdownHookDemo demo = new ShutdownHookDemo();
  demo.start();
  try{
   System.in.read();
   
  }catch(Exception e) {
   
  }
 }
 
 public void start() {
  System.out.println("Demo");
  ShutdownHook hook = new ShutdownHook(); // 创建一个hook
  Runtime.getRuntime().addShutdownHook(hook); // 注册这个hook
 }

}

 

后面还有个swing程序的例子。hook类被作为内部类实现，方便访问到外部类中的私有成员。

 

 

Shutdown Hook in Tomcat

 

    Tomcat的shutdown hook在org.apache.catalina.startup.Catalina类中。以内部类的形式实现，如下：

 

 protected class CatalinaShutdownHook extends Thread {

        public void run() {

            if (server != null) {
                try {
                    ((Lifecycle) server).stop();
                } catch (LifecycleException e) {
                    System.out.println("Catalina.stop: " + e);
                    e.printStackTrace(System.out);
                    if (e.getThrowable() != null) {
                        System.out.println("----- Root Cause -----");
                        e.getThrowable().printStackTrace(System.out);
                    }
                }
            }

        }
    }

 

 

 （完毕）