详解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 相关文章推荐
在Python的web框架中编写创建日志的程序的教程
Apr 30 Python
编写Python脚本抓取网络小说来制作自己的阅读器
Aug 20 Python
Python中不同进制的语法及转换方法分析
Jul 27 Python
python中解析json格式文件的方法示例
May 03 Python
基于python3 类的属性、方法、封装、继承实例讲解
Sep 19 Python
解决Pycharm中import时无法识别自己写的程序方法
May 18 Python
django 在原有表格添加或删除字段的实例
May 27 Python
详解python3安装pillow后报错没有pillow模块以及没有PIL模块问题解决
Apr 17 Python
python opencv将图片转为灰度图的方法示例
Jul 31 Python
Windows下Anaconda安装、换源与更新的方法
Apr 17 Python
一文解决django 2.2与mysql兼容性问题
Jul 15 Python
k-means & DBSCAN 总结
Apr 27 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
使用PHP遍历文件夹与子目录的函数代码
2011/09/26 PHP
使用php方法curl抓取AJAX异步内容思路分析及代码分享
2014/08/25 PHP
PHP编写登录验证码功能 附调用方法
2016/05/19 PHP
PHP实现二维数组根据key进行排序的方法
2016/12/30 PHP
javascript Excel操作知识点
2009/04/24 Javascript
javascript 设置文本框中焦点的位置
2009/11/20 Javascript
用js判断页面刷新或关闭的方法(onbeforeunload与onunload事件)
2012/06/22 Javascript
node.js中的fs.readlinkSync方法使用说明
2014/12/17 Javascript
JavaScript语言对Unicode字符集的支持详解
2014/12/30 Javascript
JS实现淡蓝色简洁竖向Tab点击切换效果
2015/10/06 Javascript
jQuery插件EasyUI设置datagrid的checkbox为禁用状态的方法
2016/08/05 Javascript
Asp.Net之JS生成分页条的方法
2016/11/23 Javascript
Angular中的$watch、$watchGroup、$watchCollection
2017/06/25 Javascript
js事件委托和事件代理案例分享
2017/07/25 Javascript
超级简易的JS计算器实例讲解(实现加减乘除)
2017/08/08 Javascript
vue动态删除从数据库倒入列表的某一条方法
2018/09/29 Javascript
详解vuex commit保存数据技巧
2018/12/25 Javascript
微信小程序全局变量功能与用法详解
2019/01/22 Javascript
给你选择Python语言实现机器学习算法的三大理由
2017/11/15 Python
python实现百万答题自动百度搜索答案
2018/01/16 Python
Django和Flask框架优缺点对比
2019/10/24 Python
将tf.batch_matmul替换成tf.matmul的实现
2020/06/18 Python
通过代码实例了解Python异常本质
2020/09/16 Python
关于css兼容性问题及一些常见问题汇总
2016/05/03 HTML / CSS
美国优质马术服装购买网站:Breeches.com
2019/12/16 全球购物
入党自我鉴定范文
2013/10/04 职场文书
自我鉴定书面格式
2014/01/13 职场文书
优秀团队获奖感言
2014/02/19 职场文书
医院院务公开实施方案
2014/05/03 职场文书
员工保密承诺书
2014/05/28 职场文书
化工专业自荐书
2014/06/16 职场文书
工程催款通知书
2015/04/17 职场文书
消防安全月活动总结
2015/05/08 职场文书
导游词之无锡丝业博物馆
2019/11/12 职场文书
python实现学员管理系统(面向对象版)
2022/06/05 Python
python基础之//、/与%的区别详解
2022/06/10 Python