启动Tomcat

Posted 2021-01-29 陈东

　　这篇随笔的重点关注启动Tomcat时会用到的两个类，分别是Catalina类 和 Bootstrap类，它们都位于org.apache.catalina.startup包下，Catalina类用于启动或关闭Server对象，并负责解析Tomcat文件:server.xml文件。Bootstrap类是一个入口点，负责创建Catalina实例，并调用其process()方法，理论上这两个类可以合并为一个，但是为了支持Tomcat的多种运行模式，而提供了多种启动类，例如，上面说到的Bootstrap类是作为一个独立的应用程序运行Tomcat的，而另一个类org.apahce.catalina.starup.BootstrapService可以使Tomcat作为一个Windows NT服务来运行。

　　为了使用户使用方便，Tomcat附带了批处理文件 和 shell 脚本，可以方便的启动或者关闭servlet容器，在这些批处理 文件 和  shell 脚本的帮助下， 用户无须为了执行Bootstrap类 而记下 java.exe程序的选项，相反，用户只需要运行相应的批处理文件或者 shell脚本即可，

先介绍一下Catalina类

　Catalina类

　　org.apache.catalina.startup.Catalina类是启动类，它包含了一个Digester对象，用于解析位于%CATALIN_HOME%conf目录下的server.xml文件。理解了添加到Digester对象中的规则之后，就可以自行配置Tomcat了。

　　Catalina类还封装了一个Server对象，该对象有一个Service对象，正如之前学习的那样，Service对象包含一个Servlet容器 和 一个 或者多个连接器，可以使用Catalina类来启动或者关闭Server对象，

　　可以通过实例化Catalina类，并调用其process方法来运行Tomcat，但是在调用该方法时，需要传入适当的参数，第一个参数是start 表示要启动Tomcat，或 stop 表示要向Tomcat发送一条关闭命令，还有其他的参数可选，包括-help、-config、-debug和-nothing

　　注意：当使用nothing参数时，表示将不对JNDI 命名提供支持，更多关于Tomcat中 对JNDI命名的支持 看org.apahce.naming包中的类吧

　　一般情况下，及时Catalina类提供了main方法作为程序的入口点，也需要使用Bootstrap类来实例化Catalina类，并调用其process方法，下面给出procee的实现

 

/**
     * 实例主程序。
     *
     * @param args Command line arguments
     */
    public void process(String args[]) {

        setCatalinaHome();
        setCatalinaBase();
        try {
            if (arguments(args))
                execute();
        } catch (Exception e) {
            e.printStackTrace(System.out);
        }
    }

process 方法设置了两个系统属性，分别是 catalina.home 和 catalina.base，默认值均与user.dir值相同，

注意：user.dir属性的值指明了用户的工作目录，即，会从哪个目录下调用java命令，更多系统属性的列表，可以参见java.lang.System类 getProperties方法的介绍

然后procee 方法会调用arguments方法，并传入参数列表，arguments方法处理命令行参数，如果Catalina对象能够继续处理的话，arguments方法会返回true，

 

/**
     * 处理指定的命令行参数，如果应该继续处理，则返回true；否则返回false。
     *
     * @param args
     *            Command line arguments to process
     */
    protected boolean arguments(String args[]) {

        boolean isConfig = false;

        if (args.length < 1) {
            usage();
            return (false);
        }

        for (int i = 0; i < args.length; i++) {
            if (isConfig) {
                configFile = args[i];
                isConfig = false;
            } else if (args[i].equals("-config")) {
                isConfig = true;
            } else if (args[i].equals("-debug")) {
                debug = true;
            } else if (args[i].equals("-nonaming")) {
                useNaming = false;
            } else if (args[i].equals("-help")) {
                usage();
                return (false);
            } else if (args[i].equals("start")) {
                starting = true;
            } else if (args[i].equals("stop")) {
                stopping = true;
            } else {
                usage();
                return (false);
            }
        }

        return (true);

    }

 　　process方法会检查arguments方法的返回值，如果返回值为true，则调用execute方法

 1 /**
 2      * 执行 命令行配置后 处理。
 3      * 
 4      * 
 5      */
 6     protected void execute() throws Exception {
 7 
 8         // 如果命令启动则启动
 9         if (starting)
10             start();
11         // 如果命令停止则停止
12         else if (stopping)
13             stop();
14 
15     }

execute方法会调用start方法 启动Tomcat 或者 调用stop方法来关闭Tomcat。

注意：在Tomcat 5 以及之后，没有execute方法，会在procee方法中调用 start方法 或者 stop方法

Start方法

　　start方法 会创建一个Digester实例来解析server.xml文件（Tomcat 配置文件），在解析 server.xml文件之前，start方法会调用Digester对象的push方法，传入当前Catalin对象作为参数，这样Catalina对象就成为了 Digester对象的内部栈中的第一个对象，解析Server.xml文件之后，会使变量server引用一个Server对象，默认是org.apache.catalina.core.StandardServer类型的对象，然后start方法会调用Server对象的initialize方法 和 start方法，接着，Catalina对象的start方法会调用Server对象的await反方循环等待，直到接收到正确的关闭命令，当await方法返回时，Catalina对象的start方法会调用Server对象的stop方法，从而关闭Server对象和其他的组件，此外 start方法 还会使用关闭钩子，确保用户突然退出应用程序时会执行Server对象的stop方法。