参考资料在文后列出,本文只是作为我个人的备忘,做个小结,如果想要了解更多细节,欢迎阅读文后参考资料。

wsgi基本处理模式为 : WSGI Server -> WSGI Middleware-> WSGI Application 逐一学习以上三个部分。

###WSGI Server/gateway ####功能 接收request请求,封装一系列环境变量,按照wsgi规范调用注册的wsgi app,最后将response返回给客户端。 ####基本工作流程

  1. 服务器创建socket,监听端口,等待客户端连接。
  2. 当有请求来时,服务器解析客户端信息放到环境变量environ中,并调用绑定的handler来处理请求。
  3. handler解析这个http请求,将请求信息例如method,path等放到environ中。
  4. wsgi handler再将一些服务器端信息也放到environ中,最后服务器信息,客户端信息,本次请求信息全部都保存到了环境变量environ中。
  5. wsgi handler 调用注册的wsgi app,并将environ和回调函数传给wsgi app
  6. wsgi app 将reponse header/status/body 回传给wsgi handler
  7. 最终handler还是通过socket将response信息塞回给客户端。

###WSGI Application wsgi application就是一个普通的callable对象,当有请求到来时,wsgi server会调用这个wsgi app。 这个对象接收两个参数,通常为environ和start_response。(理解为协议接口).
environ就像前面介绍的,可以理解为环境变量,跟一次请求相关的所有信息都保存在了这个环境变量中,包括服务器信息,客户端信息,请求信息。start_response是一个callback函数,wsgi application通过调用start_response,将response headers/status 返回给wsgi server。此外这个wsgi app会return 一个iterator对象 ,这个iterator就是response body。
对着下面这个简单的例子看就明白很多了。

1
2
3
4
5
def simple_app(environ, start_response):
    status ='200 OK'
    response_headers =[('Content-type','text/plain')]
    start_response(status, response_headers)
    return[u"This is hello wsgi app".encode('utf8')]

我们再用wsgiref 作为wsgi server ,然后调用这个wsgi app,就能直观看到一次request,response的效果:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
from wsgiref.simple_server import make_server

def simple_app(environ, start_response):
    status ='200 OK'
    response_headers =[('Content-type','text/plain')]
    start_response(status, response_headers)
    return[u"This is hello wsgi app".encode('utf8')]

httpd = make_server('',8000, simple_app)
print"Serving on port 8000..."
httpd.serve_forever()

此外,上面讲到了wsgi app只要是一个callable对象就可以了,因此不一定要是函数,一个实现了__call__方法的实例也可以

###WSGI Middleware 上面的application看起来没什么意思,感觉没有太大用,但加上一层层的middleware包装之后就不一样了。

以下例子用来实现URL路由:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

from wsgiref.simple_server import make_server

URL_PATTERNS= (
('hi/','say_hi'),
('hello/','say_hello'),
)

class Dispatcher(object):

     def _match(self,path):
          path = path.split('/')[1]
          for url,app in URL_PATTERNS:
               if path in url:
               return app

     def __call__(self,environ, start_response):
          path = environ.get('PATH_INFO','/')
          app = self._match(path)
          if app :
                   app = globals()[app]
                    return app(environ, start_response)
          else:
                    start_response("404 NOT FOUND",[('Content-type', 'text/plain')])
                    return ["Page dose not exists!"]

def say_hi(environ, start_response):
     start_response("200 OK",[('Content-type', 'text/html')])
     return ["kenshin say hi to you!"]

def say_hello(environ, start_response):
     start_response("200 OK",[('Content-type', 'text/html')])
     return ["kenshin say hello to you!"]

app = Dispatcher()

httpd = make_server('', 8000, app)
print "Serving on port 8000..."
httpd.serve_forever()
#实际是装饰器模式,没有通过的话 提前返回  提示错误

经过这些middleware的包装,已经有点框架的感觉了。其实基于wsgi的框架,例如paste,pylons就是这样通过一层层middleware组合起来的。只是一个成熟的框架,这样的middleware会有很多

1
2
3
4
5
6
7
8
def configure(app):
     return ErrorHandlerMiddleware(
          SessionMiddleware(
              IdentificationMiddleware(
                  AuthenticationMiddleware(
                        UrlParserMiddleware(app))))))

#哪一层有问题就在那里提前退出

只要这些Middleware符合wsgi规范,甚至还可以在各个框架之间组合重用。

似乎写一个python web框架也不算太难~

学习wsgi的感触:越是底层越是普适啊,越强大的抽象能力,也越接近于思想本身。各个框架不过是具体实现而已。就像柏拉图在《理想国》里说的 真实的事物只是对理念的模仿,唯有理念是不变的~ 参考资料: