Jetty的Servlt请求路由与ContextHandlerColleection的实现

们一般会在tomcat下面部署多个应用，每个应用都对应着一个自己的context，那么就需要一个collection将他们管理起来，而且需要对http请求进行路由，将http请求交个相应的应用来处理。。。。

这件事情在jetty中就是ContextHanlerCollection干的事情，它维护者当前jetty中部署的应用。。。将http请求交给匹配的context，然后context再转由内部的servlet来处理。。。。

好了。。还是先来看看ContextHanlerCollection的继承体系吧：



本身继承还是很简单的，前面已经说过了，整个jetty在这方面都还算比较简单一些。。。

其实从名字就能够知道这是一个collection，用于存储handler，其实这里的handler就是前面的文章分析过的contextHandler。。。。

这里我们先来看看HandlerCollection的定义吧。。。这里我们就来看看一些比较重要的内容就好了。。。。

[java] view
plaincopy

//添加一个handler，其实是要将其添加到最后面去，说白了就是建立一个数组

public void addHandler(Handler handler) {

setHandlers((Handler[])LazyList.addToArray(getHandlers(), handler, Handler.class));

}



这个是添加handler的方法，其实也就是建立一个数组，新添加的handler将会在这个数组的最后面。。。

[java] view
plaincopy

//其实就是启动保存的所有的handler

protected void doStart() throws Exception {

MultiException mex=new MultiException();

if (_handlers!=null)

{

for (int i=0;i<_handlers.length;i++)

try{_handlers[i].start();}catch(Throwable e){mex.add(e);}

}

super.doStart();

mex.ifExceptionThrow();

}



启动，其实也没啥意思，主要就是启动当前所包含的所有的handler

另外handlerCollection本身也有handle方法，不过这个方法的实现比较的扯淡，对于http请求，它会遍历所有的handler，然后直到找到一个handler将这个http请求处理了为止。。。它的实现将会在ContextHandlerCollection中被覆盖。。。

好了，接下来我们来看看ContextHandlerCollection的定义吧，先来看两个比较重要的属性的定义：

[java] view
plaincopy

private PathMap _contextMap; //用于context的map，将contextPath与contextHandler对应起来，而且还有lazy匹配，一些前缀，后缀匹配什么的

private Class _contextClass = ContextHandler.class; //这里是用到的handler的类型



首先前面的contextMap就是用于维护contextPath与contextHandler的对应关系，PathMap是jetty自己定义的类型，它继承自HashMap，但是对其进行了一些扩展，加上了前缀匹配，后缀匹配。。。lazy匹配什么的。。。

至于PathMap的分析留给以后吧，，，其实还算是比较有意思的东西，毕竟所有的http请求都要先到这里经由它来匹配出相应的contextHandler，还算是比较重的。。。。而且在contextHandler中又要用到它来处理path与servlet的对应关系。。。

我们来看看它的doStart方法吧：

[java] view
plaincopy

//启动当前的组件

protected void doStart() throws Exception {

mapContexts(); //对当前所有的app的context进行map

super.doStart(); //父类的启动组要是启动当前所有的handler

}



这里第一个方法的执行是比较重要的，它用于创建pathMap，创建当前所有的handler与path之间的对应关系。。。然后在执行父类的doStart方法，前面已经说过，在父类中主要是进行handler的启动工作。。。

好饿了。。那么我们来看看这个重要的mapContexts方法吧：

[java] view
plaincopy

//用于map请求的path，这里会创建PathMap，用于path来索引相应的contextHandler

public void mapContexts() {

PathMap contextMap = new PathMap(); //创建一个pathmap

Handler[] branches = getHandlers(); //获取所有的handler

//遍历当前的所有的handler

for (int b=0;branches!=null && b<branches.length;b++) {

Handler[] handlers=null;

if (branches instanceof ContextHandler) { //如果是contextHandler需要新创建爱你一个数组 。。？为啥。。？

handlers = new Handler[]{ branches[b] };

} else if (branches[b] instanceof HandlerContainer) {

handlers = ((HandlerContainer)branches[b]).getChildHandlersByClass(ContextHandler.class);

} else {

continue;

}

//遍历当前的contextHandler

for (int i=0;i<handlers.length;i++) {

ContextHandler handler=(ContextHandler)handlers[i];

String contextPath=handler.getContextPath(); //获取当前这个handler的context的path

//判断不合规的contextPath

if (contextPath==null || contextPath.indexOf(‘,’)>=0 || contextPath.startsWith(“*”))

throw new IllegalArgumentException (“Illegal context spec:”+contextPath);

if(!contextPath.startsWith(“/”)) //如果不是/开头的，那么给它加上

contextPath=’/’+contextPath;

if (contextPath.length()>1) {

if (contextPath.endsWith(“/”)) //表示一个路径下的所有，那么就为其添加*

contextPath+=”*”;

else if (!contextPath.endsWith(“/*”))

contextPath+=”/*”; //反正都是要变成/*

}

//也就是最后的contextPath都要变成类似于：/manager/* 类型的

Object contexts=contextMap.get(contextPath); //这个path对应的所有contexts，这里可以理解为其实一个数组

String[] vhosts=handler.getVirtualHosts(); //获取虚拟主机名

if (vhosts!=null && vhosts.length>0) { //如果有虚拟主机名字

Map hosts;

if (contexts instanceof Map) {

hosts=(Map)contexts;

} else {

hosts=new HashMap();

hosts.put(”*”,contexts);

contextMap.put(contextPath, hosts);

}

for (int j=0;j<vhosts.length;j++)

{

String vhost=vhosts[j];

contexts=hosts.get(vhost);

contexts=LazyList.add(contexts,branches[b]);

hosts.put(vhost,contexts);

}

} else if (contexts instanceof Map) {

Map hosts=(Map)contexts;

contexts=hosts.get(”*”);

contexts= LazyList.add(contexts, branches[b]);

hosts.put(”*”,contexts);

} else {

contexts= LazyList.add(contexts, branches[b]); //为这个contexts添加handler

contextMap.put(contextPath, contexts); //将这个paht与这个context对应起来，里面会进行前缀和后缀的处理

}

}

}

_contextMap=contextMap; //让当前的contextMap指向刚刚创建的pathMap

}



代码还挺长的。。。其实主要要做的事情如下：

（1）遍历当前所有的handler，其实也就是contextHandler

（2）预处理他们的path，一般情况下例如加入我们的工程为manager，那么部署在jetty，默认的path将是/manager，这里的预处理是将其变成/manager/*这个样子。。。

（3）将其放到pathMap里面去。。。让pathMap来处理对应关系。。。有前缀，后缀匹配什么的。。这里还涉及到虚拟主机名什么的。。就不细看了。。

最后我们再来看看另外一个很重要的方法，handle方法，ContextHandlerCollection的handle方法的用处就是将http请求分发给对应的contextHandler来处理。。。

来看他的定义吧：

[b][java] view
plaincopy

//这里的target是没有经过处理的，直接就是最原始的url后面的那些，例如/manager/public/aa.jpg，也就是包括了前面的contextPath

//这个函数用于将http请求路由给匹配的contextHandler来处理

public void handle(String target, HttpServletRequest request, HttpServletResponse response, int dispatch) throws IOException, ServletException {

Handler[] handlers = getHandlers(); //获得当前所有的handler

if (handlers==null || handlers.length==0)

return;

Request base_request = HttpConnection.getCurrentConnection().getRequest(); //获取当前的http请求，前面会将它保存在线程变量中

// data structure which maps a request to a context

// each match is called in turn until the request is handled

// { context path =>

// { virtual host => context }

// }

PathMap map = _contextMap; //当前的context的map

if (map!=null && target!=null && target.startsWith(“/”)) {

//这里获取所有匹配的context

Object contexts = map.getLazyMatches(target); //获取匹配的context

for (int i=0; i<LazyList.size(contexts); i++) { //遍历当前的context

// then, match against the virtualhost of each context

Map.Entry entry = (Map.Entry)LazyList.get(contexts, i);

Object list = entry.getValue();

if (list instanceof Map) {

Map hosts = (Map)list;

String host = normalizeHostname(request.getServerName());

// explicitly-defined virtual hosts, most specific

list=hosts.get(host);

for (int j=0; j<LazyList.size(list); j++) {

Handler handler = (Handler)LazyList.get(list,j);

handler.handle(target,request, response, dispatch);

if (base_request.isHandled())

return;

}

// wildcard for one level of names

list=hosts.get(”*.”+host.substring(host.indexOf(“.”)+1));

for (int j=0; j<LazyList.size(list); j++)

{

Handler handler = (Handler)LazyList.get(list,j);

handler.handle(target,request, response, dispatch);

if (base_request.isHandled())

return;

}

// no virtualhosts defined for the context, least specific

// will handle any request that does not match to a specific virtual host above

list=hosts.get(”*”);

for (int j=0; j<LazyList.size(list); j++)

{

Handler handler = (Handler)LazyList.get(list,j);

handler.handle(target,request, response, dispatch);

if (base_request.isHandled())

return;

}

} else {

//一般都是执行这里，因为前面获取所有匹配的context的时候会将所有匹配上的handler构成一个数组

for (int j=0; j<LazyList.size(list); j++) {

Handler handler = (Handler)LazyList.get(list,j);

handler.handle(target,request, response, dispatch);

if (base_request.isHandled())

return; //如果有handler处理了，那么就不处理了

}

}

}

} else {

// This may not work in all circumstances… but then I think it should never be called

for (int i=0;i<handlers.length;i++) {

handlers[i].handle(target,request, response, dispatch);

if ( base_request.isHandled())

return;

}

}

}



因为这里有了一些虚拟主机什么的东西，所以看起来稍微复杂一些。。但是其实最主要做的事情如下：

（1）调用当前contextMap的getLazyMatches方法，找到所有与当前匹配的contextHandle

（2）遍历这些handler，然后依次调用他们的handle方法来处理这个请求，知道这次的请求被处理了为止。。

好了，到这里ContextHandlerCollection的主要类容就算看完了。。。它还算是比较重要的。。。其实到这里为止http请求在jetty中的处理流程就算是比较的清楚了。。。用一张图来说明一下吧：