1. 首页
  2. 笔记

捉摸Python的WSGI – Python

发布于: 2012年7月21日
标签：, ,

  过去的这个月，接触的最多的就是Python的WSGI了，WSGI不是框架不是模块，仅仅是一个规范协议，定义了一些接口，却影响着Python网络开发的方方面面。对于WSGI有这么一段定义：WSGI is the Web Server Gateway Interface. It is a specification for web servers and application servers to communicate with web applications (though it can also be used for more than that).我想我这篇文章不是详细介绍WSGI内容的，只是想扯扯我对WSGI相关的学习。

 

      诚如那个WSGI的定义所说的，协议定义了一套接口来实现服务器端与应用端通信的规范化（或者说是统一化）。这是怎样的一套接口呢？很简单，尤其是对于应用端。

 

      应用端只需要实现一个接受两个参数的，含有__call__方法的，返回一个可遍历的含有零个或多个string结果的Python对象（我强调说 Python对象，只是想和Java的对象区别开，在Python里一个方法、一个类型……都是对象，Python是真“一切皆对象”，详见 《Python源码分析》）即可。码农都知道，传入参数的名字可以任意取，这里也不例外，但习惯把第一个参数命名为“environ”，第二个为 “start_response”。至于这个对象的内容怎样，应用自由发挥去吧……

 

      服务器端要做的也不复杂，就是对于每一个来访的请求，调用一次应用端“注册”的那个协议规定应用端必须要实现的对象，然后返回相应的响应消息。这样一次 服务器端与应用端的通信也就完成了，一次对用户请求的处理也随之完成了！当然了，既然协议规定了服务器端在调用的时候要传递两个参数，自然也规定了这两个 参数的一些细节。比如第一个参数其实就是一个字典对象，里面是所有从用户请求和服务器环境变量中获取的信息内容，协议当然会定义一些必须有的值，及这些值 对应的变量名；第二个参数其实就是一个回调函数，它向应用端传递一个用来生成响应内容体的write对象，这个对象也是有__call__方法的。

 

      协议也提到了，还可以设计中间件来连接服务器端与应用端，来实现一些通用的功能，比如session、routing等。

 

具体怎么应用这个协议呢？Python自带的wsgiref模块有个简单的例子：

 

Python代码  收藏代码
  1. from wsgiref.simple_server import make_server  
  2.   
  3. def hello_world_app(environ, start_response):  
  4.     status = ‘200 OK’ # HTTP Status  
  5.     headers = [(‘Content-type’, ‘text/plain’)] # HTTP Headers  
  6.     start_response(status, headers)  
  7.   
  8.     # The returned object is going to be printed  
  9.     return [“Hello World”]  
  10.   
  11. httpd = make_server(”, 8000, hello_world_app)  
  12. print “Serving on port 8000…”  
  13.   
  14. # Serve until process is killed  
  15. httpd.serve_forever()  

 

 

     这个例子更多体现的是应用端的开发方法，很简单的按照协议实现一个了满足规范的方法，这样当浏览器向本机8000端口发起一个请求时，就会得到一个 “Hello World”的字符串文本响应。这个例子虽然简单，但非常清楚的说明了应用端与服务器端的接口应用方式。


     你可能会想到：现在对该端口的不同地址的请求都是由这个“hello_world_app”函数处理的，你可以实现一个功能，解析一下请求的PATH信 息，针对不同的地址转发给不同的函数或是类来处理；你可能会觉得使用environ和start_response这两个参数不直观，你可以像Java的 servlet那样自己封装成两个request和response对象来用；你觉得有些常用功能可以提取出来，在具体应用逻辑之外来做……哈哈，那你就 已经在思考怎么做中间件或是Web框架了！其实这些也都有人做过了，比如Routes、WebOb、Beaker……当然你大可以自己造自己独有的轮子， 有时候自己做过一遍了才会对现有的成熟的东西有更好的理解，最重要的是在Python的世界里这些都不难做到！

 

     不知你是不是和我一样，在写应用的时候或多或少的会想一下服务器端是怎么运作的呢？可能最模糊的流程大家都能想得到：服务器开一个socket等待客户端 连接；请求来了，服务器会读出传来的数据，然后根据HTTP协议做一些初步的封装，接着就可以调用事先注册的应用程序了，并将请求的数据塞进去；等响应处 理完毕了再把数据通过socket发出去，over。好在Python的代码简洁，而自带的wsgiref中的simple server也很简单，就让我们探究一下更具体的实现吧！

 

      首先看一下类的继承关系，这个simple server真正的类是WSGIServer，继承自HTTPServer，HTTPServer类又继承自TCPServer，TCPServer又继 承自BaseServer；与server类直接打交道的还有RequestHandler类，从最上层的WSGIRequestHandler —> BaseHTTPRequestHandler —> StreamRequestHandler —> BaseRequestHandler。相对Java而言不是很复杂吧，它们是怎么工作的呢？容我稍微解释一下。


     让我们从Server的最基类BaseServer看起。它有一段注释非常清楚的介绍了它定义的方法的用处：

 

Python代码  收藏代码
  1. Methods for the caller:  
  2.   
  3. – __init__(server_address, RequestHandlerClass)  
  4. – serve_forever()  
  5. – handle_request()  # if you do not use serve_forever()  
  6. – fileno() -> int   # for select()  
  7.   
  8. Methods that may be overridden:  
  9.   
  10. – server_bind()  
  11. – server_activate()  
  12. – get_request() -> request, client_address  
  13. – verify_request(request, client_address)  
  14. – server_close()  
  15. – process_request(request, client_address)  
  16. – close_request(request)  
  17. – handle_error()  
  18.   
  19. Methods for derived classes:  
  20.   
  21. – finish_request(request, client_address)  

 

可见，一个server类其实就这么几个方法。


      在可以被外部调用的四个方法中，构造方法显然就是用来创建实例的；第四个可能是和构建异步服务器有关的，这里就略过了；从具体的代码可以看到，剩下两个 方法的用处是相同的，就是处理收到的请求，只是serve_forever()方法会在server进程存在期间循环处理，而 handle_request()处理一次就退出了（其实server_forever()就是循环调用了handle_request()）。在 handle_request()中说明了具体的从接受到返回一个请求的全部流程，代码也很简单：

 

Python代码  收藏代码
  1. def handle_request(self):  
  2.         “””Handle one request, possibly blocking.”””  
  3.         try:  
  4.             request, client_address = self.get_request()  
  5.         except socket.error:  
  6.             return  
  7.         if self.verify_request(request, client_address):  
  8.             try:  
  9.                 self.process_request(request, client_address)  
  10.             except:  
  11.                 self.handle_error(request, client_address)  
  12.                 self.close_request(request)  

 

     BaseServer虽然定义了这些内部调用的方法，但内容基本都是空的，留给了具体的Server类去实现。从BaseServer的代码中就可以看到 RequestHandler类的用处了，它是具体的解析了request的内容，它由finish_request()调用，而这个 finsh_request()方法显然应该是在process_request()方法中被调用的。


     TCPServer继承BaseServer类，它真正具体化了我们猜测的socket连接的初始化过程。


     在与上面两个类相同的源文件中，还有两个主要的类：ThreadingMixIn和ForkingMixIn，这两个类分别重载了 process_request()方法，并且相应使用了新建一个线程或是进程的方式来调用finish_request()方法。这也从应用的角度解释 了为什么要在finish_request()外套一层process_request()，而不是直接在handle_request()的第二个 try块中调用。

 

     HTTPServer其实做的工作很简单，就是记录了socket server的名字。

 

     接下来就该看看WSGIServer了。它做了两件新的工作：设置了一些基本的环境变量值，并且接受应用程序的注册。从这个Server的代码可以看出， 应用端实现的那个接口就是从这里注册到服务器端的，而且只能注册一个哦！所以要有多个应用只能通过routing的方式来转发调用了。而且这个 WSGIServer不是多线程或是多进程的~

 

     至于具体封装请求内容的RequestHandler类就不打算分析了，感兴趣的话，看官们自个看一下源码吧，也很简单哦！下一篇博客打算分享一下我对pylons框架的运行过程的学习。

- EOF -