「三」DOCKER源码分析3 从serverapi到docker run的调用

func initRouter(s *apiserver.Server, d *daemon.Daemon, c *cluster.Cluster) {
	decoder := runconfig.ContainerDecoder{}//获取解码器
	routers := []router.Router{
		...
		//与container的路由，例如/containers/create,/containers/{name:.*}/start
		container.NewRouter(d, decoder),   
		...
	}
	//如果允许网络控制，则添加network相关的路由
	if d.NetworkControllerEnabled() {
		routers = append(routers, network.NewRouter(d, c))
	}
	//如果是experimental模式将所有路由数据项中的experimental模式下的api路由功能激活
	if d.HasExperimental() {
		for _, r := range routers {
			for _, route := range r.Routes() {
				if experimental, ok := route.(router.ExperimentalRoute); ok {
					experimental.Enable()
				}
			}
		}
	}
	//根据设置好的路由表routers来初始化apiServer的路由器
	s.InitRouter(debug.IsEnabled(), routers...)  
}

//从上文container.NewRouter(d, decoder)可以看出，传入的b=d，为daemon.Daemon实例
//这里初始化了一个container相关的路由器对象
func NewRouter(b Backend, decoder httputils.ContainerDecoder) router.Router {
	r := &containerRouter{
		backend: b,
		decoder: decoder,
	}
	r.initRoutes()
	return r
}

//初始化路由数据
func (r *containerRouter) initRoutes() {
	r.routes = []router.Route{
		...		
		// POST
		router.NewPostRoute("/containers/create", r.postContainersCreate), 
		router.NewPostRoute("/containers/{name:.*}/start", r.postContainersStart),
		...
	}
}

//初始化一个以HTTP POST方式的路由,返回类型为Route
func NewPostRoute(path string, handler httputils.APIFunc) Route {
	return NewRoute("POST", path, handler)
}

//初始化一个local route
func NewRoute(method, path string, handler httputils.APIFunc) Route {
	return localRoute{method, path, handler}
}

type localRoute struct {
	method  string //该路由中方法名
	path    string //该路由中方法所在的路径
	handler httputils.APIFunc //该方法的handler
}

func (s *Server) InitRouter(enableProfiler bool, routers ...router.Router) {
	s.routers = append(s.routers, routers...)  //将创建好的路由表信息追加到apiServer对象中的routers。
	m := s.createMux()  //追加后再次初始化apiServer路由器进行更新，下文详细解释
	
	//这里设置好了mux.Route之后，将该route设置到apiServer的路由交换器中去，至此所有deamon.start（）的相关工作处理完毕
	s.routerSwapper = &routerSwapper{
		router: m,
	}  
}

func (s *Server) createMux() *mux.Router {
	/*
	mux位于vendor/github.com/gorilla/mux,该函数新建一个mux.go中的Route（路由数据项）对象并追加到mux.Router结构体中的成员routes中去，然后返回该路由器mux.Route m
	*/
	m := mux.NewRouter()  
	
	//遍历所有apiserver中的api路由器如：container
	for _, apiRouter := range s.routers {
		//遍历每个apiRouter的子命令路由r如"/containers/create"  
		for _, r := range apiRouter.Routes() {
			//给每个r的路由handler包裹了一层中间件（这里还不是很清楚）
			f := s.makeHTTPHandler(r.Handler())
			/*
			在mux.Route路由结构中根据这个r.Path()路径设置一个适配器来匹配方法method和handler，当满足versionMatcher+r.Path()路径的正则表达式要求就可以适配到相应的方法名及该handler
			*/
			m.Path(versionMatcher + r.Path()).Methods(r.Method()).Handler(f)
			//同上
			m.Path(r.Path()).Methods(r.Method()).Handler(f) 
		}
	}
	...
	return m
}