Tornado框架01-入门总概

时间 2019-11-16

原文原文链接

咱们首先来谈谈web框架. web框架的本质其实就是socket服务端再加上业务逻辑处理, 好比像是Tornado这样的框架. 有一些框架则只包含业务逻辑处理, 例如Django, bottle, flask这些框架, 它们的使用须要依赖包含socket的第三方模块(即 wsgiref)来运行
在python中常见的web框架构建模式有如下两种: css

MVC框架:
- 数据库相关操做的Models
- 视图文件的Views
- 业务逻辑的Controllers
MTV框架:
- 数据库相关操做的Models
- 模板文件Templates
- 业务逻辑的Views

以上两种只是命名不一样, 所遵循的的思想也只是大同小异html

在使用Tornado框架前, 咱们先使用wsgiref再加上本身写的业务逻辑自定义一个web框架python

#!/usr/bin/env python
# -*- coding:utf-8 -*-
from wsgiref.simple_server import make_server


def index():
    return "This is index "


def news():
    return "welcome to news "


URLS = {
    '/index': index,
    '/news': news,
}


def RunServer(rq, rp):
    rp('200 OK', [('Content-Type', 'text/html')])
    url = rq['PATH_INFO']
    if url in URLS.keys():
        ret = URLS[url]()
    else:
        ret = '404'
    return ret


if __name__ == '__main__':
    http = make_server('', 8000, RunServer)
    http.serve_forever()复制代码

wsgiref在py2中运行正常, 在py3中会报错
http = make_server('', 8000, RunServer) 这里建立socket服务端, 并传入业务逻辑功能函数RunServer(rq, rp)
http.serve_forever() 启动服务端, 阻塞进程等待客户端访问, 一旦有访问则执行RunServer(rq, rp)方法
RunServer(rq, rp) 该方法中rq封装了请求信息, rp封装了响应信息
- url = rq['PATH_INFO'] 获取请求的url链接地址
- ret = URLS[url]() 根据请求的url执行对应的函数
当咱们将执行的index()和news()功能函数放进Controllers业务逻辑处理模块, 将返回结果ret改成文件读写后的内容, 并将该文件放置到Views或者Template模块中, 就造成了最基础版本的MVC和MTV框架

接下来咱们使用Tornado实现一个简陋的任务表功能demoweb

commons.css文件内容: 数据库

.body {
    margin: 0;
    background-color: cornflowerblue;
}复制代码

index.html文件内容: flask

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>S1</title>
    <link rel="stylesheet" href="../static/commons.css">
</head>
<body>
<form method="post">
    <input type="text" name="name">
    <input type="submit" value="提交">
</form>
<h1>内容展现</h1>
<ul>
    {% for item in contents %}
        <li>{{item}}</li>
    {% end %}
</ul>
</body>
</html>复制代码

index.py文件内容: 浏览器

#!/usr/bin/env python
# -*- coding:utf-8 -*-
import tornado.web, tornado.ioloop


class MyHandle(tornado.web.RequestHandler):
    def get(self, *args, **kwargs):
        self.render("index.html", contents=CONTENTS_LIST)

    def post(self, *args, **kwargs):
        CONTENTS_LIST.append(self.get_argument('name'))
        self.render('index.html', contents=CONTENTS_LIST)


if __name__ == '__main__':
    CONTENTS_LIST = []
    settings = {
        'template_path': 'template',
        'static_path': 'static',
        'static_url_prefix': 'static/',
    }

    application = tornado.web.Application([
        (r"/index", MyHandle)
    ], **settings)
    application.listen(80)
    tornado.ioloop.IOLoop.instance().start()复制代码

CONTENTS_LIST = [] 为存放的是输入框输入的内容
settings字典表示的是配置文件
- 'template_path': 'template' 模板文件的存放位置
- 'static_path': 'static' 静态文件的存放位置, 静态文件必须声明, 不然浏览器没法找到静态文件
- 'static_url_prefix': 'static/' 静态文件前缀, 减小每一个文件引入都要加前缀的麻烦

application = tornado.web.Application([
     (r"/index", MyHandle)
 ], **settings)复制代码

根据浏览器的url肯定其对应的处理类并生成该类的对象

application.listen(80) 设置服务端的监听端口
tornado.ioloop.IOLoop.instance().start() 阻塞服务端进程, 等待客户端的访问
客户端第一次访问调用的是MyHandle类中的get(self, *args, **kwargs)方法, 服务端向客户端返回index.html文件
客户端浏览器接受到index.html文件以后, 在输入框中输入内容并提交以后会调用post(self, *args, **kwargs), 并将输入的内容追加到
self.get_argument('name') 获取指定参数的内容
CONTENTS_LIST中, 服务端返回index.html, 返回过程当中Toranado
会将CONTENTS_LIST 的内容渲染到index.html以后才会发给客户端浏览器

python中的模板引擎本质上是将html文件转换成一段python函数字符串, 再经过compile和exec将该函数执行, 以此来进行模板渲染缓存

如今咱们介绍一下模板引擎的使用: cookie

uimethod.py文件以下: session

#!/usr/bin/env python
# -*- coding:utf-8 -*-

def test_uimethod(self):
    return "uimethod"复制代码

uimodule.py文件以下:

#!/usr/bin/env python
# -*- coding:utf-8 -*-
from tornado.web import UIModule

class MyClass(UIModule):
    def render(self, *args, **kwargs):
        return "uimodule"复制代码

index.py文件以下:

#!/usr/bin/env python
# -*- coding:utf-8 -*-
import tornado.web, tornado.ioloop
import uimethod as ut
import uimodule as ud


class MyHandle(tornado.web.RequestHandler):
    def get(self, *args, **kwargs):
        self.render("index.html", ag="this is ag", contents=CONTENTS_LIST)

    def post(self, *args, **kwargs):
        CONTENTS_LIST.append(self.get_argument('name'))
        self.render('index.html', contents=CONTENTS_LIST)


if __name__ == '__main__':
    CONTENTS_LIST = []
    settings = {
        'template_path': 'template',
        'static_path': 'static',
        'static_url_prefix': 'static/',
        'ui_methods': ut,
        'ui_modules': ud
    }

    application = tornado.web.Application([
        (r"/index", MyHandle)
    ], **settings)
    application.listen(80)
    tornado.ioloop.IOLoop.instance().start()复制代码

index.html文件以下:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>S1</title>
    <link rel="stylesheet" href='{{static_url("commons.css")}}'>
</head>
<body>
<h1>{{ag}}</h1>
<h1>{{test_uimethod()}}</h1>
<h1>{%module MyClass()%}</h1>
<form method="post">
    <input type="text" name="name">
    <input type="submit" value="提交">
</form>
<h1>内容展现</h1>
<ul>
    {% for item in contents %}
    <li>{{item}}</li>
    {% end %}
</ul>
<hr>
</body>
</html>复制代码

咱们看看客户端访问的结果:

模板引擎中的{{key}}表示取key对应的值, 当key为函数时候执行该函数并取该函数结果. 例如index.html文件中的<h1>{{ag}}</h1> 实际上取得是index.py的self.render("index.html", ag="this is ag", contents=CONTENTS_LIST)中的参数ag的值
<h1>{{test_uimethod()}}</h1> 这里执行的是自定义函数, 咱们将这个自定义函数写在uimethod.py文件中, 而且在index.py文件中导入, 而后将index.py文件中的settings配置增长一行'ui_methods': ut, 该行内容表示模板引擎可执行自定义函数
模板引擎中的{%%}可用于循环语句和条件语言以及自定义类的执行, {% for item in contents %}此处正是用于循环遍历contents中的内容
<h1>{%module MyClass()%}</h1>此处表示模板引擎执行自定义类, 该类的文件对应的是uimodule.py文件, 咱们须要在index.py的settings中增长一行'ui_modules': ud, 改行表示模板引擎可以使用自定义类
注意, 咱们将index.html文件引入css的方式改成了<link rel="stylesheet" href='{{static_url("commons.css")}}'>, static_url()是模板引擎内置的自定义函数, 用该函数引入css文件时候, 仅当css文件内容发生变化时候, 浏览器才会从新缓存该css文件

考虑到篇幅太长不容易阅读, 笔者这里将关于Tornado框架的cookie知识, 自定义session的使用路由系统,以及模板引擎高级部分放在后期文章分篇共享