Tomcat源码阅读系列(六)类加载器

本文是Tomcat源码阅读系列的第六篇文章,本系列前五篇文章如下:
Tomcat源码阅读系列(一)使用IntelliJ IDEA运行Tomcat6源码
Tomcat源码阅读系列(二)Tomcat总体架构
Tomcat源码阅读系列(三)启动和关闭过程
Tomcat源码阅读系列(四)Connector连接器
Tomcat源码阅读系列(五)Catalina容器
本文主要介绍Tomcat的类加载器。
关于Java的类加载器的介绍,大家可以Google一下,网上关于其介绍比较多且比较详细,本文就不再重复介绍,本文主要介绍Tomcat的类加载器。关于Tomcat的类加载器可以分为两部分,第一个是Tomcat自身所使用的类加载器,这个是Tomcat服务器专用的,用于加载Tomcat服务器本身的class。另外一个就是WEB应用程序用的,每一个web应用程序都有自己专用的WebappClassLoader,用于加载属于自己应用程序的资源,例如/web-inf/lib下面的jar包,classes里面的class文件。下面分别介绍这Tomcat类加载器的创建和WebappClassLoader的特殊之处。

1 Tomcat类加载器的创建

说道Tomcat类加载的创建,还是从Bootstrap说起,Bootstrap#init()方法会调用initClassLoaders方法创建3个ClassLoader,它们分别是commonLoader,catalinaLoader,sharedLoader,其中catalinaLoader,sharedLoader的父亲加载器是commonLoader,initClassLoaders执行的过程中会执行createClassLoader,而createClassLoader是根据conf/catalina.properties文件中common.loader,server.loader,shared.loader的值来初始化,它的代码如下:

private ClassLoader createClassLoader(String name, ClassLoader parent)
        throws Exception {
        String value = CatalinaProperties.getProperty(name + ".loader");
        //判断如果catalina.properties中没有配置对应的loader属性的话,直接返回父加载器,而默认情况下,
        //server.loader,shared.loader为空,那么此时的catalinaLoader,sharedLoader其实是同一个ClassLoader.
        if ((value == null) || (value.equals("")))
            return parent;

       //....................

       //根据环境变量的配置替换字符串中的值.默认情况下,common.loader的值为
       //common.loader=${catalina.base}/lib,${catalina.base}/lib/.jar,${catalina.home}/lib,${catalina.home}/lib/.jar

        //最终创建了org.apache.catalina.loader.StandardClassLoader实例
        ClassLoader classLoader = ClassLoaderFactory.createClassLoader
            (locations, types, parent);

        // ....................

    }

这里就可以看到创建了commonLoader,catalinaLoader与sharedLoader,而且可以很清楚的看到他们之间的双亲结构。上面分析了Tomcat在启动的时候,初始化的几个ClassLoader,接下来我们再来继续看看,commonLoader,catalinaLoader,sharedLoader具体都用在什么地方。
commonLoader
根据程序可知commonLoader除了在initClassLoaders处使用,在其他地方,并没有使用。
catalinaLoader和sharedLoader

 public void init() throws Exception{

        //..............

        //设置setContextClassLoader为catalinaLoader 设置当前线程classLoader  
        Thread.currentThread().setContextClassLoader(catalinaLoader);

        //设置securityClassLoad为catalinaLoader
        SecurityClassLoad.securityClassLoad(catalinaLoader);

        // Load our startup class and call its process() method
        if (log.isDebugEnabled())
            log.debug("Loading startup class");
        //catalinaLoader在这里使用
        Class startupClass =
            catalinaLoader.loadClass
            ("org.apache.catalina.startup.Catalina");
        Object startupInstance = startupClass.newInstance();

        // Set the shared extensions class loader
        if (log.isDebugEnabled())
            log.debug("Setting startup class properties");
        String methodName = "setParentClassLoader";
        Class paramTypes[] = new Class[1];
        paramTypes[0] = Class.forName("java.lang.ClassLoader");
        Object paramValues[] = new Object[1];

        //注意!!注意!! 这里将Catalina的ParentClassLoader设置为sharedLoader 
        //调用刚刚创建的org.apache.catalina.startup.Catalina对象的setParentClassLoader设置classLoader,shareloader  
        paramValues[0] = sharedLoader;
        Method method =
            startupInstance.getClass().getMethod(methodName, paramTypes);
        method.invoke(startupInstance, paramValues);

        catalinaDaemon = startupInstance;//将这个启动的实例保存起来,这里引用的是catalina的类型的对象  
    }

通过上面的代码,我们可以清楚的看到调用了Catalina的setParentClassLoader放,那么到这里我们可能又要想知道,设置了parentClassLoader以后,sharedLoader又是在哪里使用的呢?
我们查找Catalina.parentClassLoader的引用,发现在createStartDigester()方法中引用了parentClassLoader,并有注释,

  // When the 'engine' is found, set the parentClassLoader.当发现engine时,将其设置为parentClassLoader
  digester.addRule("Server/Service/Engine",
                         new SetParentClassLoaderRule(parentClassLoader));

按图索骥,我们找到SetParentClassLoaderRule类,如下:

final class SetParentClassLoaderRule extends Rule {
    public SetParentClassLoaderRule(ClassLoader parentClassLoader) {
        this.parentClassLoader = parentClassLoader;
    }
    ClassLoader parentClassLoader = null;
    public void begin(String namespace, String name, Attributes attributes)
        throws Exception {
        if (digester.getLogger().isDebugEnabled())
            digester.getLogger().debug("Setting parent class loader");
        Container top = (Container) digester.peek();

        //由Server/Service/Engine的配置可以看出,出现StandardEngine时,将其parentClassLoader设置为sharedLoader
        top.setParentClassLoader(parentClassLoader);
    }
}

可以知道,StandardEngine的parentClassLoader被设置为sharedLoader。到此,我们已经知道了commonLoader,catalinaLoader,sharedLoader在不同地方的使用。如果要深挖,那么就需要知道StandardEngine的parentClassLoader在哪里使用了。
StandardEngine的parentClassLoader
实际上调用top.setParentClassLoader(parentClassLoader);时,实际调用的是ContainerBase的setParentClassLoader方法,

 public void setParentClassLoader(ClassLoader parent) {
        ClassLoader oldParentClassLoader = this.parentClassLoader;
        this.parentClassLoader = parent;//设置parentClassLoader为sharedLoader
        support.firePropertyChange("parentClassLoader", oldParentClassLoader,this.parentClassLoader);                            
    }

如果想知道ContainerBase.parentClassLoader的使用,我们仅仅需要知道哪里调用了ContainerBase.getParentClassLoader()即可。分析getParentClassLoader的调用栈,我们可以看到StandardContext.start()方法调用了这个方法。如下

//................
 if (getLoader() == null) {
            WebappLoader webappLoader = new WebappLoader(getParentClassLoader());
            webappLoader.setDelegate(getDelegate());
            setLoader(webappLoader);
}
//................
try {
    if (ok) {
        // Start our subordinate components, if any
        if ((loader != null) && (loader instanceof Lifecycle))
            ((Lifecycle) loader).start();
        //other code    
    }catch(Exception e){
    }

通过查看上面的代码,我们看到在StandardContext启动的时候,会创建webapploader,创建webapploader的时候会将getParentClassLoader方法返回的结果(这里返回的其实就是sharedLoader)赋值给自己的parentClassLoader变量,接着又会调用到Webapploader的start方法,接下来就来看看WebappLoader的start方法,我们摘取一部分与本篇相关的代码片段如下:

  classLoader = createClassLoader();
  classLoader.setResources(container.getResources());
  classLoader.setDelegate(this.delegate);
  classLoader.setSearchExternalFirst(searchExternalFirst);

从上的代码可以看到调用了WebappLoader#createClassLoader方法创建一个classLoader,那么我们再看来看看WebappLoader#createClassLoader的代码:

  private WebappClassLoader createClassLoader()
        throws Exception {

        Class clazz = Class.forName(loaderClass);
        WebappClassLoader classLoader = null;
        //parentClassLoader为sharedLoader不为空
        if (parentClassLoader == null) {
            parentClassLoader = container.getParentClassLoader();
        }
        Class[] argTypes = { ClassLoader.class };
        Object[] args = { parentClassLoader };
        Constructor constr = clazz.getConstructor(argTypes);
        classLoader = (WebappClassLoader) constr.newInstance(args);

        return classLoader;

    }

在上面的代码里面,loaderClass是WebappLoader的实例变量,其值为org.apache.catalina.loader.WebappClassLoader,那么上面的代码其实就是通过反射调用了WebappClassLoader的构造函数,然后传递了sharedLoader作为其父亲加载器。
代码阅读到这里,我们已经基本清楚了Tomcat中ClassLoader的总体结构,总结如下: 在Tomcat存在common,cataina,shared三个公共的classloader,默认情况下,这三个classloader其实是同一个,都是common classloader,针对每个webapp,也就是Standardcontext都有自己的WebappClassLoader来加载每个应用自己的类(对应代码中的StandardContext类,在StandardContext.start()方法调用了创建WebappLoader和loader.start方法!)。上面的描述,我们可以通过下图形象化的描述:
描述

2 WebappClassLoader

我们知道Java的ClassLoader机制有parent-first的机制,而这种机制是在loadClass方法保证的,一般情况下,我们只需要重写findClass方法就好了,而对于WebAppClassLoader,通过查看源代码,我们发现loadClass和findClass方法都进行了重写,那么我们首先就来看看它的loadClass方法,它的代码如下:

扫描二维码关注公众号,回复: 1554554 查看本文章
public synchronized Class loadClass(String name, boolean resolve)
        throws ClassNotFoundException {

        if (log.isDebugEnabled())
            log.debug("loadClass(" + name + ", " + resolve + ")");
        Class clazz = null;

        // Log access to stopped classloader
        if (!started) {
            try {
                throw new IllegalStateException();
            } catch (IllegalStateException e) {
                log.info(sm.getString("webappClassLoader.stopped", name), e);
            }
        }

        // (0) Check our previously loaded local class cache 
        //从当前ClassLoader的本地缓存中加载类,如果找到则返回
        clazz = findLoadedClass0(name);
        if (clazz != null) {
            if (log.isDebugEnabled())
                log.debug("  Returning class from cache");
            if (resolve)
                resolveClass(clazz);
            return (clazz);
        }

        // (0.1) Check our previously loaded class cache
        // 本地缓存没有的情况下,调用ClassLoader的findLoadedClass方法查看jvm是否已经加载过此类,如果已经加载则直接返回。
        clazz = findLoadedClass(name);
        if (clazz != null) {
            if (log.isDebugEnabled())
                log.debug("  Returning class from cache");
            if (resolve)
                resolveClass(clazz);
            return (clazz);
        }

        // (0.2) Try loading the class with the system class loader, to prevent
        //       the webapp from overriding J2SE classes
        //通过系统的来加载器加载此类,这里防止应用写的类覆盖了J2SE的类,这句代码非常关键,如果不写的话,
        //就会造成你自己写的类有可能会把J2SE的类给替换调,另外假如你写了一个javax.servlet.Servlet类,放在当前应用的WEB-INF/class中,
        //如果没有此句代码的保证,那么你自己写的类就会替换到Tomcat容器Lib中包含的类。
        try {
            clazz = system.loadClass(name);
            if (clazz != null) {
                if (resolve)
                    resolveClass(clazz);
                return (clazz);
            }
        } catch (ClassNotFoundException e) {
            // Ignore
        }

        // (0.5) Permission to access this class when using a SecurityManager
        //如果启用了SecurityManager,则检查此类是否允许被载入,如果不允许,则抛出异常
        if (securityManager != null) {
            int i = name.lastIndexOf('.');
            if (i >= 0) {
                try {
                    securityManager.checkPackageAccess(name.substring(0,i));
                } catch (SecurityException se) {
                    String error = "Security Violation, attempt to use " +
                        "Restricted Class: " + name;
                    log.info(error, se);
                    throw new ClassNotFoundException(error, se);
                }
            }
        }

        //判断是否需要委托给父类加载器进行加载,delegate属性默认为false,那么delegatedLoad的值就取决于filter的返回值了,
        //filter方法中根据包名来判断是否需要进行委托加载,默认情况下会返回false.因此delegatedLoad为false
        boolean delegateLoad = delegate || filter(name);

        // (1) Delegate to our parent if requested
        //因为delegatedLoad为false,那么此时不会委托父加载器去加载,这里其实是没有遵循parent-first的加载机制。
        if (delegateLoad) {
            if (log.isDebugEnabled())
                log.debug("  Delegating to parent classloader1 " + parent);
            ClassLoader loader = parent;
            if (loader == null)
                loader = system;
            try {
                clazz = loader.loadClass(name);
                if (clazz != null) {
                    if (log.isDebugEnabled())
                        log.debug("  Loading class from parent");
                    if (resolve)
                        resolveClass(clazz);
                    return (clazz);
                }
            } catch (ClassNotFoundException e) {
                ;
            }
        }

        // (2) Search local repositories
        if (log.isDebugEnabled())
            log.debug("  Searching local repositories");
        //调用findClass方法在webapp级别进行加载
        try {
            clazz = findClass(name);
            if (clazz != null) {
                if (log.isDebugEnabled())
                    log.debug("  Loading class from local repository");
                if (resolve)
                    resolveClass(clazz);
                return (clazz);
            }
        } catch (ClassNotFoundException e) {
            ;
        }

        // (3) Delegate to parent unconditionally
        //如果还是没有加载到类,并且不采用委托机制的话,则通过父类加载器去加载。
        if (!delegateLoad) {
            if (log.isDebugEnabled())
                log.debug("  Delegating to parent classloader at end: " + parent);
            ClassLoader loader = parent;
            if (loader == null)
                loader = system;
            try {
                clazz = loader.loadClass(name);
                if (clazz != null) {
                    if (log.isDebugEnabled())
                        log.debug("  Loading class from parent");
                    if (resolve)
                        resolveClass(clazz);
                    return (clazz);
                }
            } catch (ClassNotFoundException e) {
                ;
            }
        }

        throw new ClassNotFoundException(name);

    }

通过上面的描述,我们可以知道Tomcat在加载webapp级别的类的时候,默认是不遵守parent-first的,这样做的好处是更好的实现了应用的隔离,但是坏处就是加大了内存浪费,同样的类库要在不同的app中都要加载一份。接下来,我们再看一下findClass方法调用的findClassInternal方法

  protected Class findClassInternal(String name)
        throws ClassNotFoundException {

        if (!validate(name))
            throw new ClassNotFoundException(name);

        String tempPath = name.replace('.', '/');
        String classPath = tempPath + ".class";

        ResourceEntry entry = null;

        if (securityManager != null) {
            PrivilegedAction<ResourceEntry> dp =
                new PrivilegedFindResourceByName(name, classPath);
            entry = AccessController.doPrivileged(dp);
        } else {
            //通过名称去当前webappClassLoader的仓库中查找对应的类文件
            entry = findResourceInternal(name, classPath);
        }

       //....................

            try {
            //通过defineClass转变为Jvm可以识别的Class对象返回
                clazz = defineClass(name, entry.binaryContent, 0,
                        entry.binaryContent.length, 
                        new CodeSource(entry.codeBase, entry.certificates));
            } catch (UnsupportedClassVersionError ucve) {
                throw new UnsupportedClassVersionError(
                        ucve.getLocalizedMessage() + " " +
                        sm.getString("webappClassLoader.wrongVersion",
                                name));
            }
            entry.loadedClass = clazz;
            entry.binaryContent = null;
            entry.source = null;
            entry.codeBase = null;
            entry.manifest = null;
            entry.certificates = null;
        }

        return clazz;

    }

重写了loadClass方法,对J2SE的类,使用系统类加载器加载,对Web应用自己的类使用自己的类加载器加载,不遵守parent-first的,这样做的好处是更好的实现了应用的隔离,这便是WebappClassLoader的精妙之处,但是坏处就是加大了内存浪费,同样的类库要在不同的app中都要加载一份。

猜你喜欢

转载自blog.csdn.net/yangzl2008/article/details/48214945