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

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的感触：越是底层越是普适啊，越强大的抽象能力，也越接近于思想本身。各个框架不过是具体实现而已。就像柏拉图在《理想国》里说的 真实的事物只是对理念的模仿，唯有理念是不变的～ 参考资料：

文章作者 种瓜

上次更新 2014-02-23