详解Python程序与服务器连接的WSGI接口


Posted in Python onApril 29, 2015

了解了HTTP协议和HTML文档,我们其实就明白了一个Web应用的本质就是:

  •     浏览器发送一个HTTP请求;
  •     服务器收到请求,生成一个HTML文档;
  •     服务器把HTML文档作为HTTP响应的Body发送给浏览器;
  •     浏览器收到HTTP响应,从HTTP Body取出HTML文档并显示。

所以,最简单的Web应用就是先把HTML用文件保存好,用一个现成的HTTP服务器软件,接收用户请求,从文件中读取HTML,返回。Apache、Nginx、Lighttpd等这些常见的静态服务器就是干这件事情的。

如果要动态生成HTML,就需要把上述步骤自己来实现。不过,接受HTTP请求、解析HTTP请求、发送HTTP响应都是苦力活,如果我们自己来写这些底层代码,还没开始写动态HTML呢,就得花个把月去读HTTP规范。

正确的做法是底层代码由专门的服务器软件实现,我们用Python专注于生成HTML文档。因为我们不希望接触到TCP连接、HTTP原始请求和响应格式,所以,需要一个统一的接口,让我们专心用Python编写Web业务。

这个接口就是WSGI:Web Server Gateway Interface。

WSGI接口定义非常简单,它只要求Web开发者实现一个函数,就可以响应HTTP请求。我们来看一个最简单的Web版本的“Hello, web!”:

def application(environ, start_response):
  start_response('200 OK', [('Content-Type', 'text/html')])
  return '<h1>Hello, web!</h1>'

上面的application()函数就是符合WSGI标准的一个HTTP处理函数,它接收两个参数:

  1.     environ:一个包含所有HTTP请求信息的dict对象;
  2.     start_response:一个发送HTTP响应的函数。

在application()函数中,调用:

start_response('200 OK', [('Content-Type', 'text/html')])

就发送了HTTP响应的Header,注意Header只能发送一次,也就是只能调用一次start_response()函数。start_response()函数接收两个参数,一个是HTTP响应码,一个是一组list表示的HTTP Header,每个Header用一个包含两个str的tuple表示。

通常情况下,都应该把Content-Type头发送给浏览器。其他很多常用的HTTP Header也应该发送。

然后,函数的返回值'<h1>Hello, web!</h1>'将作为HTTP响应的Body发送给浏览器。

有了WSGI,我们关心的就是如何从environ这个dict对象拿到HTTP请求信息,然后构造HTML,通过start_response()发送Header,最后返回Body。

整个application()函数本身没有涉及到任何解析HTTP的部分,也就是说,底层代码不需要我们自己编写,我们只负责在更高层次上考虑如何响应请求就可以了。

不过,等等,这个application()函数怎么调用?如果我们自己调用,两个参数environ和start_response我们没法提供,返回的str也没法发给浏览器。

所以application()函数必须由WSGI服务器来调用。有很多符合WSGI规范的服务器,我们可以挑选一个来用。但是现在,我们只想尽快测试一下我们编写的application()函数真的可以把HTML输出到浏览器,所以,要赶紧找一个最简单的WSGI服务器,把我们的Web应用程序跑起来。

好消息是Python内置了一个WSGI服务器,这个模块叫wsgiref,它是用纯Python编写的WSGI服务器的参考实现。所谓“参考实现”是指该实现完全符合WSGI标准,但是不考虑任何运行效率,仅供开发和测试使用。
运行WSGI服务

我们先编写hello.py,实现Web应用程序的WSGI处理函数:

# hello.py

def application(environ, start_response):
  start_response('200 OK', [('Content-Type', 'text/html')])
  return '<h1>Hello, web!</h1>'

然后,再编写一个server.py,负责启动WSGI服务器,加载application()函数:

# server.py
# 从wsgiref模块导入:
from wsgiref.simple_server import make_server
# 导入我们自己编写的application函数:
from hello import application

# 创建一个服务器,IP地址为空,端口是8000,处理函数是application:
httpd = make_server('', 8000, application)
print "Serving HTTP on port 8000..."
# 开始监听HTTP请求:
httpd.serve_forever()
Try

确保以上两个文件在同一个目录下,然后在命令行输入python server.py来启动WSGI服务器:

详解Python程序与服务器连接的WSGI接口

注意:如果8000端口已被其他程序占用,启动将失败,请修改成其他端口。

启动成功后,打开浏览器,输入http://localhost:8000/,就可以看到结果了:

详解Python程序与服务器连接的WSGI接口

在命令行可以看到wsgiref打印的log信息:

详解Python程序与服务器连接的WSGI接口

按Ctrl+C终止服务器。

如果你觉得这个Web应用太简单了,可以稍微改造一下,从environ里读取PATH_INFO,这样可以显示更加动态的内容:

# hello.py

def application(environ, start_response):
  start_response('200 OK', [('Content-Type', 'text/html')])
  return '<h1>Hello, %s!</h1>' % (environ['PATH_INFO'][1:] or 'web')

你可以在地址栏输入用户名作为URL的一部分,将返回Hello, xxx!:

详解Python程序与服务器连接的WSGI接口

是不是有点Web App的感觉了?
小结

无论多么复杂的Web应用程序,入口都是一个WSGI处理函数。HTTP请求的所有输入信息都可以通过environ获得,HTTP响应的输出都可以通过start_response()加上函数返回值作为Body。

复杂的Web应用程序,光靠一个WSGI函数来处理还是太底层了,我们需要在WSGI之上再抽象出Web框架,进一步简化Web开发。

Python 相关文章推荐
基于scrapy实现的简单蜘蛛采集程序
Apr 17 Python
python递归打印某个目录的内容(实例讲解)
Aug 30 Python
Python的numpy库中将矩阵转换为列表等函数的方法
Apr 04 Python
Python处理菜单消息操作示例【基于win32ui模块】
May 09 Python
Python socket实现多对多全双工通信的方法
Feb 13 Python
Django重置migrations文件的方法步骤
May 01 Python
如何使用python爬虫爬取要登陆的网站
Jul 12 Python
Python利用WMI实现ping命令的例子
Aug 14 Python
Python socket 套接字实现通信详解
Aug 27 Python
Python input函数使用实例解析
Nov 22 Python
PyQt5多线程刷新界面防假死示例
Dec 13 Python
Python telnet登陆功能实现代码
Apr 16 Python
Python的SQLAlchemy框架使用入门
Apr 29 #Python
python使用post提交数据到远程url的方法
Apr 29 #Python
python实现根据ip地址反向查找主机名称的方法
Apr 29 #Python
连接Python程序与MySQL的教程
Apr 29 #Python
python实现通过代理服务器访问远程url的方法
Apr 29 #Python
python实现带错误处理功能的远程文件读取方法
Apr 29 #Python
python使用socket远程连接错误处理方法
Apr 29 #Python
You might like
查找mysql字段中固定字符串并替换的几个方法
2012/09/23 PHP
PHP异常处理定义与使用方法分析
2017/07/25 PHP
Yii框架Session与Cookie使用方法示例
2019/10/14 PHP
IE与FireFox的兼容性问题分析
2007/04/22 Javascript
浅析jquery的js图表组件highcharts
2014/03/06 Javascript
Node.js(安装,启动,测试)
2014/06/09 Javascript
javascript实现类似百度分享功能的方法
2015/07/27 Javascript
基于jQuery实现鼠标点击导航菜单水波动画效果附源码下载
2016/01/06 Javascript
Google 爬虫如何抓取 JavaScript 的内容
2017/04/07 Javascript
最基础的vue.js双向绑定操作
2017/08/23 Javascript
bootstrap table sum总数量统计实现方法
2017/10/29 Javascript
vue.js vue-router如何实现无效路由(404)的友好提示
2017/12/20 Javascript
vue 开发一个按钮组件的示例代码
2018/03/27 Javascript
Angular4.x Event (DOM事件和自定义事件详解)
2018/10/09 Javascript
基于vue实现一个神奇的动态按钮效果
2019/05/15 Javascript
JavaScript手写数组的常用函数总结
2020/11/22 Javascript
vue3使用vue-count-to组件的实现
2020/12/25 Vue.js
Python内置模块logging用法实例分析
2018/02/12 Python
Python基于生成器迭代实现的八皇后问题示例
2018/05/23 Python
python3 json数据格式的转换(dumps/loads的使用、dict to str/str to dict、json字符串/字典的相互转换)
2019/04/01 Python
pyqt5 删除layout中的所有widget方法
2019/06/25 Python
py-charm延长试用期限实例
2019/12/22 Python
Python3 hashlib密码散列算法原理详解
2020/03/30 Python
Python-jenkins 获取job构建信息方式
2020/05/12 Python
Python优秀开源项目Rich源码解析的流程分析
2020/07/06 Python
python利用opencv实现颜色检测
2021/02/23 Python
丝芙兰香港官网:Sephora香港
2018/03/13 全球购物
Bloomingdale’s阿联酋:选购奢华时尚、美容及更多
2020/09/22 全球购物
什么是托管函数?托管函数有什么用?
2014/06/15 面试题
酒店工作职员求职简历的自我评价
2013/10/23 职场文书
婚前保证书
2014/04/29 职场文书
房展策划方案
2014/06/07 职场文书
党员学习中共十八大报告思想汇报
2014/09/15 职场文书
云南省召开党的群众路线教育实践活动总结会议新闻稿
2014/10/21 职场文书
汽车转让协议书
2015/01/29 职场文书
教你怎么用Python生成九宫格照片
2021/05/20 Python