Chapter 2

123sw

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.toLowerCase().endsWith(".properties"))
{
properties.load(Resource.newResource(args).getInputStream());
}
else
{
XmlConfiguration configuration = new XmlConfiguration(Resource.newResource(args).getURL());
if (last!=null)
configuration.getIdMap().putAll(last.getIdMap());
if (properties.size()>0)
configuration.setProperties(properties);
obj = configuration.configure();
last=configuration;
}
}
for (int i = 0; i < args.length; i++)
{
if (obj instanceof LifeCycle)
{
LifeCycle lc = (LifeCycle)obj;
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.getName()) && sets.getParameterTypes().length == 1)
set = sets;
sets.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实例就算羽翼丰满，等待启动了。