nova-api源码分析(APP的调用)
调用APIRouter的 __call__函数
nova/wsgi.py
class Router(object):
def __init__(self, mapper): self.map = mapper self._router = routes.middleware.RoutesMiddleware(self._dispatch, self.map) @webob.dec.wsgify(RequestClass=Request) def __call__(self, req): return self._router @staticmethod @webob.dec.wsgify(RequestClass=Request) def _dispatch(req): match = req.environ['wsgiorg.routing_args'][1] if not match: return webob.exc.HTTPNotFound() app = match['controller'] return app
当osapi_compute_app_v2接收到HTTP请求时,根据类的继承关系, 将调用nova.wsgi.Router.__call__函数,如上所示。查看一下webob.dec.wsgify 的源码,发现如果函数返回的是wsgi app时,它还会被继续调用,并返回它的处理结果。
3.2.1 self._router 为routes.middleware.RoutesMiddleware实例,所以会调用routes.middleware.RoutesMiddleware.__call__函数,该函数调用routes.mapper.routematch来获取HTTP请求的URL所映射的controller等参数,以{"controller":Resource(Controller()), "action": funcname, "project_id": uuid, ...}的格式放在match中。并设置如下的environ变量,方便后面调用的self._dispatch访问。
environ['wsgiorg.routing_args'] = ((url), match) environ['routes.route'] = route environ['routes.url'] = url
最后调用self._dispatch()。 self._dispatch通过前面设置的environ['wsgiorg.routing_args']来找到url对应的controller,并返回该controller。
3.2.2 这里的controller就是在APIRouter初始化中设置的controller,也就是使用相应Controller类初始化的Resource实例。所以接着调用nova.api.openstack.wsgi.Resource.__call__函数,该函数通过environ['wsgiorg.routing_args']获取上面设置的match,该match有一个action属性,它指定了所要调用Controller成员函数的名字,以及其它相关的调用参数。在我们定义Controller的成员函数时,一般需要通过nova.api.openstack.wsgi.{serializers, deserializers}来指定解释body内容的模板,可以是xml或者json格式的。前面说过重定义nova.api.openstack.urlmap.URLMap的目的是为了判断content_type。Resource接着在解析body时会参考content_type,然后调用相应的解析器进行body解析(如XMLDeserializer、JSONDeserializer),接着将解析出的参数更新进action_args,使用action_args来调用Controller成员函数,即最终的http请求处理函数。最后将执行结果使用指定的序列化器序列化,并返回结果。
3.2.3 这里特别说明一下对常见RESTful请求之外的action请求的处理。以/servers/xxx/action请求为例,请求调用的函数实际包含在请求的body中。经过routes.middleware.RoutesMiddleware的__call__函数解析后,此时即将调用的Resource已经确定为哪个模块中的Controller所构建的Resource,而action参数为"action",接下来在Resource的__call__函数里面会因为action=="action"从而开始解析body的内容,找出Controller中所对应的方法。Controller在构建的过程中会由于MetaClass的影响将其所有action类型的方法填入一个字典中,key由每个_action_xxx方法前的@wsgi.action('xxx')装饰函数给出,value为每个_action_xxx方法的名字(从中可以看出规律,在body里面请求的方法名前加上_aciton_即为Controller中对应调用的方法)。之后在使用Controller构建Resource对象的过程中会向Resource注册该Controller的这个字典中的内容。这样,只需在请求的body中给出调用方法的key,然后就可以找到这个key所映射的方法,最后在Resource的__call__函数中会调用Controller类的这个函数!
参考文档: