Tomcat5.5.16 部署web项目源码详解(转)

Tomcat.5.5.16安装web项目时执行的代码主要是HostConfig类，其中deployApps() 执行部署web应用的功能；

protected void deployApps() {

 

        File appBase = appBase();

        File configBase = configBase();

        // Deploy XML descriptors from configBase

        deployDescriptors(configBase, configBase.list());

        // Deploy WARs, and loop if additional descriptors are found

        deployWARs(appBase, appBase.list());

        // Deploy expanded folders

        deployDirectories(appBase, appBase.list());

        

    }  

从上面这段代码，我们可以知道tomcat在部署web项目是按如下顺序依次部署的；

1．    首先部署$CATALINA_HOME/conf/Catalina/localhost目录下面的.xml文件；

deployDescriptors(configBase, configBase.list());

（1）      configBase的值是通过调用configBase()获取的，

     File file = new File(System.getProperty("catalina.base"), "conf");

        Container parent = host.getParent();

        if ((parent != null) && (parent instanceof Engine)) {

            file = new File(file, parent.getName());

        }

file = new File(file, host.getName());

可以看出configBase是由四部分内容组成; 

System.getProperty("catalina.base")+ “conf” + parent.getName()+host.getName()

parent.getName()和host.getName()是分别取server.xml中

<Engine name="Catalina" defaultHost="localhost">和

<Host name="localhost" appBase="webapps"  … 对应的name属性值；

由此可以得出configBase的值为$CATALINA_HOME/conf/Catalina/localhost 

 

        (2) 按文件名顺序依次读取configBase目录下面的xml文件部署web应用；

           第一步，首先获取文件名（不包含.xml）作为上下文路径

                String nameTmp = files[i].substring(0, files[i].length() - 4);

                String contextPath = "/" + nameTmp.replace('#', '/');

           第二步，解析xml文件，分析docBase的值；

    注意这里的docBase的判断很重要，采用和以前版本完全不同的做法；

                                   if (!docBase.isAbsolute()) {

                        docBase = new File(appBase(), context.getDocBase());

                     }

                  首先判断docBase是否为绝对路径，如果不是绝对路径，在改为

                      $CATALINA_HOME/webapps+docBase

   

                     // If external docBase, register .xml as redeploy first

                    if(!docBase.getCanonicalPath().startsWith(appBase().getAbsolutePath())) 

{

//这个判断很重要，这里是判断如果docBase路径是以

$ CATALINA_HOME/webapps+docBase开头的字符串，则忽略掉了

                          isExternal = true;

                          ...

                       if (docBase.getAbsolutePath().toLowerCase().endsWith(".war")) {

                            isWar = true;

                       }

                   } else{

       // Ignore specified docBase

     context.setDocBase(null);

}

           

          从上面可以看出，<Context path="/xxxx" docBase="xxxx" .中docBase 只有为绝对路径并且该路径不是以$CATALINA_HOME/webapps开头，才会生效；否则就忽略掉了；

 

 

2．    接下来部署$CATALINA_HOME/webapps/目录下以。War结尾的文件

deployWARs(appBase, appBase.list());

(1)首先仍是把文件名(不用.war)作为其应用的上下文路径;

    if (files[i].toLowerCase().endsWith(".war")) {

                // Calculate the context path and make sure it is unique

                String contextPath = "/" + files[i];

                int period = contextPath.lastIndexOf(".");

        (2) 接下来判断以该上下文路径contextPath是否已经装载过了，如果是则直接退出；    if (deploymentExists(contextPath))

                     return;

       （3）继续判断以该上下文命名的部署文件是否存在，如war文件为AAA.war,则判断在$CATALINA_HOME/conf/Catalina/localhost/AAA.xml文件是否存在，如果不存在继续执行以下操作；

            File xml = new File

            (configBase, file.substring(0, file.lastIndexOf(".")) + ".xml");

        if (deployXML && !xml.exists()) {

          entry = jar.getJarEntry(Constants.ApplicationContextXml);

          configBase.mkdirs();

          。。。

      先从wart文件中读取META-INF/context.xml文件，然后把它copy到

      $CATALINA_HOME/conf/Catalina/localhost/AAA.xml,注意war文件部署文件必须为

context.xml，且在META-INF目录下；   

 （4）接下来操作和上面类似，部署该web应用；

3. 最后是以$CATALINA_HOME/webapps目录下的文件夹为目标按文件夹名顺序进行部署；

    deployDirectories(appBase, appBase.list());

（1）       同样先把该文件夹名作为上下文路径进行部署；

            File dir = new File(appBase, files[i]);

            if (dir.isDirectory()) {

 

                // Calculate the context path and make sure it is unique

                String contextPath = "/" + files[i];

              

（2）       接下来的步骤就基本上是一样了，首先判断该上下文路径是否已经部署过，如果是则直接退出，否则和上面一样，读取META-INF/context.xml文件进行部署；

注意这里和上面的war文件部署稍微有点不同，就是它不会copy 部署文件context.xml文件到$CATALINA_HOME/conf/Catalina/localhost中去；