Chapter 2 - Jetty读取配置文件和Loader (1)

Start.jar会调用org.mortbay.xml.XmlConfiguration的main()方法，如果没有提供启动参数则使用缺省的jetty.xml。代码首先实例化XmlConfiguration对象，然后调用其configure()方法去加载定义在xml文件里的类org.mortbay.jetty.Server，然后实例化Server类。

1. XmlConfiguration.main()方法：

    public static void main(String[] args)
    {
        try
        {
            Properties properties=new Properties();
            XmlConfiguration last=null;
            Object[] obj = new Object[args.length];
            for (int i = 0; i < args.length; i++)
            {
                if (args[i].toLowerCase().endsWith(".properties"))
                {
                    properties.load(Resource.newResource(args[i]).getInputStream());
                }
                else
                {
                    XmlConfiguration configuration = new XmlConfiguration(Resource.newResource(args[i]).getURL());
                    if (last!=null)
                        configuration.getIdMap().putAll(last.getIdMap());
                    if (properties.size()>0)
                        configuration.setProperties(properties);
                    obj[i] = configuration.configure();
                    last=configuration;
                }
            }

            for (int i = 0; i < args.length; i++)
            {
                if (obj[i] instanceof LifeCycle)
                {
                    LifeCycle lc = (LifeCycle)obj[i];
                    if (!lc.isRunning())
                        lc.start();
                }
            }
        }
        catch (Exception e)
        {
            Log.warn(Log.EXCEPTION, e);
        }

    }

a. 遍历传给start.jar的运行参数，如果是properties格式的文件，则加载该文件并保存在Properties中

b. 否则根据该文件实例化一个XmlConfiguration对象configuration(多个文件会实例化多个)

c. 把上个configuration的IdMap赋给当前的configuration，实现共享

d. 把properties里面的键值对赋值给当前configuration

e. 调用XmlConfiguration对象的configure()方法实例化xml文件里面对应的类

f. 遍历configuration数组，如果是有生命周期的configuration并且未启动，则启动它


2. XmlConfiguration.configure()方法

    public Object configure() throws Exception
    {
        Class oClass = nodeClass(_config);

        String id = _config.getAttribute("id");
        Object obj = id==null?null:_idMap.get(id);

        if (obj==null && oClass !=null)
            obj = oClass.newInstance();

        if (oClass!=null && !oClass.isInstance(obj))
            throw new ClassCastException(oClass.toString());

        configure(obj, _config, 0);
        return obj;
    }

首先会加载这个根类(Server)，然后看看这个类的实例是否存在于上下文中，没有就实例化。
然后会调用configure的重载方法去实例化子节点对应的类。

3. XmlConfiguration.nodeClass方法

private Class nodeClass(XmlParser.Node node) throws ClassNotFoundException
    {
        String className = node.getAttribute("class");
        if (className == null) return null;

        return Loader.loadClass(XmlConfiguration.class, className,true);
    }

4. Loader.loadClass方法

    public static Class loadClass(Class loadClass,String name,boolean checkParents)
        throws ClassNotFoundException
    {
        ClassNotFoundException ex=null;
        Class c =null;
        ClassLoader loader=Thread.currentThread().getContextClassLoader();
        while (c==null && loader!=null )
        {
            try { c=loader.loadClass(name); }
            catch (ClassNotFoundException e) {if(ex==null)ex=e;}
            loader=(c==null&&checkParents)?loader.getParent():null;
        }      

        loader=loadClass==null?null:loadClass.getClassLoader();
        while (c==null && loader!=null )
        {
            try { c=loader.loadClass(name); }
            catch (ClassNotFoundException e) {if(ex==null)ex=e;}
            loader=(c==null&&checkParents)?loader.getParent():null;
        }       

        if (c==null)
        {
            try { c=Class.forName(name); }
            catch (ClassNotFoundException e) {if(ex==null)ex=e;}
        }   

        if (c!=null)
            return c;
        throw ex;
    }

a. 首先调用当前线程的classLoader和它的parent

b. 然后调用XmlConfiguration的classLoader

c. 如果还没有load进来，试着用Class.forName()


5. 解析xml文件中的子节点，转换成代码进行操作

    private void configure(Object obj, XmlParser.Node cfg, int i) throws Exception
    {
        String id = cfg.getAttribute("id");
        if (id!=null)
            _idMap.put(id,obj);

        for (; i < cfg.size(); i++)
        {
            Object o = cfg.get(i);
            if (o instanceof String) continue;
            XmlParser.Node node = (XmlParser.Node) o;

            try
            {
                String tag = node.getTag();
                if ("Set".equals(tag))
                    set(obj, node);
                else if ("Put".equals(tag))
                    put(obj, node);
                else if ("Call".equals(tag))
                    call(obj, node);
                else if ("Get".equals(tag))
                    get(obj, node);
                else if ("New".equals(tag))
                    newObj(obj, node);
                else if ("Array".equals(tag))
                    newArray(obj, node);
                else if ("Ref".equals(tag))
                    refObj(obj, node);
                else if ("Property".equals(tag))
                    propertyObj(obj, node);
                else
                    throw new IllegalStateException("Unknown tag: " + tag);
            }
            catch (Exception e)
            {
                Log.warn("Config error at " + node, e.toString());
                throw e;
            }
        }
    }

例如解析下面的xml node

<Set name="ThreadPool">
	<New class="org.mortbay.thread.QueuedThreadPool">
		<Set name="minThreads">10</Set>
		<Set name="maxThreads">200</Set>
		<Set name="lowThreads">20</Set>
	</New>
</Set>

以Set标签为例：

   String attr = node.getAttribute("name");
   String name = "set" + attr.substring(0, 1).toUpperCase() + attr.substring(1);
   Object value = value(obj, node);
   Object[] arg = { value};   
   vClass[0] = value.getClass();

拿到name的值，然后构造一个setter方法。拿到经过处理的value，然后尝试很多种方式去调用这个方法：

a. Try for trivial match

   Method set = oClass.getMethod(name, vClass);
   set.invoke(obj, arg);

根据反射拿到这个方法，调用它

b. Try for native match

Field type = vClass[0].getField("TYPE");
vClass[0] = (Class) type.get(null);
Method set = oClass.getMethod(name, vClass);
set.invoke(obj, arg);

根据xml文件中的属性值的类来找到setter方法并调用

c. Try a field

Field field = oClass.getField(attr);
if (Modifier.isPublic(field.getModifiers()))
{
	field.set(obj, value);
	return;
}

查找当前对象是否有该字段，如果有并且是public的，就赋值进去。

d. Search for a match by trying all the set methods

   Method[] sets = oClass.getMethods();
   if (name.equals(sets[s].getName()) && sets[s].getParameterTypes().length == 1)
   set = sets[s];
   sets[s].invoke(obj, arg);

遍历名称为name的setter方法并且试着去调用

e. Try converting the arg to the last set found

   Class sClass = set.getParameterTypes()[0];
if (sClass.isPrimitive())
{
	for (int t = 0; t < __primitives.length; t++)
	{
		if (sClass.equals(__primitives[t]))
		{
			sClass = __primitiveHolders[t];
			break;
		}
	}
}
Constructor cons = sClass.getConstructor(vClass);
arg[0] = cons.newInstance(arg);
set.invoke(obj, arg);

拿到setter方法参数类型(如果是原始类型)并找到对应的封装类型。
然后找到封装类型以值的类型为参数的构造方法，调用该构造方法将参数值的类型转换为封装类型的。
最后调用该setter方法。

f. 玩不转了

throw new NoSuchMethodException(oClass + "." + name + "(" + vClass[0] + ")");

这样New出一个QueuedThreadPool, 然后赋给Server实例

接下来就依次构建xml里面定义的其它对象，这样Server实例就算羽翼丰满，等待启动了。