Python学习笔记__19.3章 WSGI接口

# 这是学习廖雪峰老师python教程的学习笔记

1、Web应用的本质

1. 浏览器发送一个HTTP请求；

2. 服务器收到请求，生成一个HTML文档；

3. 服务器把HTML文档作为HTTP响应的Body发送给浏览器；

4. 浏览器收到HTTP响应，从HTTP      Body取出HTML文档并显示。

 

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

 

我们用Python生成HTML文档。不希望接触到TCP连接、HTTP原始请求和响应格式，这些底层代码应由专门的服务器软件实现。所以，需要WSGI：Web Server Gateway Interface 这个统一接口，让我们专心用Python编写Web业务。

2、WSGI

1. RESTful只是设计风格而不是标准，而WSGI（Web Server Gateway      Interface，Web 服务器网关接口）则是Python语言中所定义的Web服务器和Web应用程序之间或框架之间的通用接口标准。

2. WSGI就是一座桥梁，桥梁的一端称为服务端或网关端，另一端称为应用端或者框架端，WSGI的作用就是在协议之间进行转化。WSGI将Web组件分成了三类：Web 服务器（WSGI      Server）、Web中间件（WSGI Middleware）与Web应用程序（WSGI Application）。

           3. Web Server接收HTTP请求，封装一系列环境变量，按照WSGI接口标准调用注册的WSGI Application，最后将响应返回给客户端。

2.1、实现WSGI的函数

def application(environ, start_response):

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

    return [b'<h1>Hello, web!</h1>']

application()函数就是符合WSGI标准的一个HTTP处理函数，它接收两个参数：

• environ：一个包含所有HTTP请求信息的dict对象。【浏览器发过来的请求】

• start_response：一个发送HTTP响应的函数。【server端返回响应浏览器的HTTP请求 的Header】

  • 200 OK：HTTP响应码

  • [('Content-Type',       'text/html')]：一组list表示的HTTP Header，每个Header用一个tuple表示，tuple包含两个str

  • [b'<h1>Hello,       web!</h1>']：函数的返回值作为HTTP响应的Body发送给浏览器

2.2、WSGI的作用

有了WSGI，我们关心的就是：

1. 如何从environ这个dict对象拿到HTTP请求信息，

2. 根据请求信息构造HTML

3. 通过start_response()发送Header

4. 最后返回Body。

 

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

 

application()函数必须由WSGI服务器来调用。有很多符合WSGI规范的服务器，我们可以挑选一个来用。而Python内置了一个WSGI服务器，这个模块叫wsgiref，它是用纯Python编写的WSGI服务器的参考实现。帮助我们进行测试

 

2.3、运行WSGI服务

    1、编写hello.py，实现Web应用程序的WSGI处理函数

# hello.py

def application(environ, start_response):

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

    return [b'<h1>Hello, web!</h1>']

    2、编写server.py，负责启动WSGI服务器，加载application()函数

# server.py

from wsgiref.simple_server import make_server # 从wsgiref模块导入

from hello import application # 导入我们自己编写的application函数

 

# 创建一个服务器，IP地址为空，端口是8000，处理函数是application

httpd = make_server('', 8000, application)

print('Serving HTTP on port 8000...')

# 开始监听HTTP请求

httpd.serve_forever()

    3、测试

将两个文件在同一个目录下，然后在命令行输入python server.py来启动WSGI服务器

打开浏览器，输入 http://localhost:8000/

    4、改造application()函数，返回从environ里读取的PATH_INFO

# hello.py

def application(environ, start_response):

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

    body = '<h1>Hello, %s!</h1>' % (environ['PATH_INFO'][1:] or 'web')

    return [body.encode('utf-8')]

此时，在地址栏输入用户名作为URL的一部分，将返回Hello, xxx!

3、小结

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

 

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

 

4、参考文档

WSGI接口 (https://www.liaoxuefeng.com/wiki/0014316089557264a6b348958f449949df42a6d3a2e542c000/001432012393132788f71e0edad4676a3f76ac7776f3a16000)

详解WSGI (https://blog.youkuaiyun.com/li_101357/article/details/52748323)