[零基础学python]Tornado静态路径以及一个项目框架

时间 2019-11-11

标签零基础 python tornado 静态路径以及一个项目框架栏目 Python 繁體版

原文原文链接

"just as the Son of Man came not to be served but to serve, and to give his life a ransom for many."(MATTHEW:20:28)javascript

在网上浏览网页，因为如今网速也快了，大概你不多注意网页中那些所谓的静态文件。怎么找出来静态文件呢？css

若是使用firefox(我特别向列位推荐这个浏览器，它是我认为的最好的浏览器，没有之一。哈哈。“你信不信？反正我信了。”)，能够经过firebug组件，来研究网页的代码，固然，你直接看源码也行。html

上图中，我打开了一个对天朝不少人来讲不存在的网站，而且经过Firebug查看其源码，打开<head>，发现里面有很多<script和<link开始引入的文件，这些文件一部分是javascript文件，一部分是css文件。在一个网站中，这类文件通常是不会发生变化的，也就是它的内容稳定，直到下次文件管理员或者有权限的人修改时。而网站程序自己通常不会修改它们。所以将他们称之为静态文件。前端

此外，网站中的静态文件还包括一些图片，好比logo，以及作为边框的图片等。java

在tornado中，有专门方法处理这些静态文件。python

静态路径

看官是否还记得在前面写过这个模样的代码：template_path=os.path.join(os.path.dirname(__file__), "templates")，这里是设置了模板的路径，放置模板的目录名称是templates。相似的方法，咱们也能够设置好静态文件的路径。web

static_path=os.path.join(os.path.dirname(__file__), "static")

这里的设置，就是将全部的静态文件，放在了static目录中。sql

这样就设置了静态路径。数据库

下面的代码是将[上一节]的代码进行了改写，注意变化的地方canvas

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

import os.path
import tornado.httpserver
import tornado.ioloop
import tornado.web
import tornado.options

from tornado.options import define, options
define("port", default=8000, help="run on the given port", type=int)

class IndexHandler(tornado.web.RequestHandler):
    def get(self):
        lst = ["python","www.itdiffer.com","qiwsir@gmail.com"]
        self.render("index.html", info=lst)

handlers = [(r"/", IndexHandler),]

template_path = os.path.join(os.path.dirname(__file__), "temploop")
static_path = os.path.join(os.paht.dirname(__file__), "static")    #这里增长设置了静态路径

if __name__ == "__main__":
    tornado.options.parse_command_line()
    app = tornado.web.Application(handlers, template_path, static_path, debug=True)   #这里也多了点
    http_server = tornado.httpserver.HTTPServer(app)
    http_server.listen(options.port)
    tornado.ioloop.IOLoop.instance().start()

上面的代码比前一讲中，多了两处，一处是定义了静态文件路径static_path，在这里将存储静态文件的目录命名为static。另一个修改就是在实例化tornado.web.Application()的时候，在参数中，出了有静态路径参数static_path，还有一个参数设置debug=True，这个参数设置的含义是当前的tornado服务器能够不用重启，就可以体现已经修改的代码功能。回想一下，在前面进行调试的时候，是否是每次若是修改了代码，就得重启tornado服务器，才能看到修改效果。用了这个参数就不用这么麻烦了。

特别说着，debug=True仅仅用于开发的调试过程当中，若是在生产部署的时候，就不要这么使用了。

编写模板文件

咱们设置静态路径的目的就是要在模板中引入css和js等类型的文件以及图片等等。那么如何引入呢，下面以css为例说明。

在通常网页的<head>...</head>部分，都会引入CSS，例以下面的写法很多网站都愿意引用google的字体库，样式以下：

<link href='http://fonts.googleapis.com/css?family=Open+Sans:300,400,600&subset=latin,latin-ext' rel='stylesheet'>

这就是CSS的引入。

可是，若是看官在墙内也这么引入字体库，但愿本身的网页上能使用，那就有点麻烦了，由于google的这个项目已经不行被墙，若是在网页中写了上面代码，会致使网页打开速度很慢，有的甚至出错。

怎么办？那就不用啦。不过，国内有好心网站作了整个谷歌字体的代理，能够用下面方式，墙里面就不怕了。

<link href='http://fonts.useso.com/css?family=Open+Sans:300,400,600&subset=latin,latin-ext' rel='stylesheet'>

顺便提供一个墙内的经常使用前端库地址：http://libs.useso.com/，供看官参考使用。

那么若是我本身写CSS呢？而且按照前面的设定，已经将该CSS文件放在了static目录里面，命名为style.css，就能够这样引入

<link href="/static/style.css" rel="stylesheet">

可是，这里每每会有一个不方便的地方，若是我手闲着无聊，或者由于别的充足理由，将存储静态文件的目录static换成了sta，而且假设我已经在好几个模板中都已经写了上面的代码。接下来我就要把这些文件全打开，一个一个更改<link>里面的地址。

请牢记，凡是遇到重复的事情，必定要找一个函数方法解决。tornado就提供了这么一个：static_url(),把上面的代码写成：

<link href="{{ static_url("style.css") }}" rel="stylesheet" >

这样，就无论你如何修改静态路径，模板中的设置能够不用变。

按照这个引入再修改相应的模板文件。

一个项目框架

以上以及此前，咱们全部写过的，都是简单的技术方法演示，若是要真的写一个基于tornado框架的网站，通常是不用这样的直接把代码都写到一个文件index.py中的，一个重要缘由，就是这样作不容易之后维护，也不便于多人协做写一个项目。

因此在真实的项目中，经常要将不一样部件写在不一样文件中。下面的例子就是一个项目的基本框架。固然，这仍是一个比较小的项目，可是“麻雀虽小，五脏俱全”。

建立一个文件夹，我给它命名为project，在这个文件里面分别建立下面的文件和目录，文件和目录里面的内容能够先不用管，“把式把式，先看架势”，先搭起项目结构来。

文件application.py：这个文件的核心任务是完成tornado.web.Application()的实例化
文件url.py：在这个文件中记录项目中全部URL和映射的类，即完成前面代码中handlers=[...]的功能
文件server.py：这是项目的入口文件，里面包含if __name__ == "__main__"，从这里启动项目和服务
目录handler：存放.py文件，即所谓各类请求处理类（固然，若是更大一些的项目，可能还要分配给别的目录来存储这种东西）
目录optsql：存放操做数据库的文件，好比各类读取或者写入数据库的类或函数，都放在这里面的某些文件中
目录static：存放静态文件，就是上文说的好比CSS，JS，图片等，为了更清晰，在这个目录里面，还可创建子目录，好比我就创建了：css,js,img三个子目录，分别对应上面的三种。
目录template：存放.html的模板（在更大型的项目中，可能会设计多个目录来存放不一样的模板，或者在里面再有子目录进行区分）

以上就是我规划的一个项目的基本框架了。不一样开发者根据本身的习惯，有不一样的规划，或者有不一样的命名，这没有关系。不过须要说明的，尽可能使用名词（英文）。我看到过有人作过单复数之争论。我我的认为，这个无所谓，只要在一个项目中一向就行了。我仍是用单数吧，由于总忘记那个复数后面的s

下面分别把不一样部分文件的内容列出来，由于都是前面代码的重复，不过是作了一点重新部署，因此，就不解释了。个别地方有一点点说明。

文件application.py的代码以下：

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

from url import url 

import tornado.web
import os

setting = dict(
    template_path=os.path.join(os.path.dirname(__file__),"template"),
    static_path=os.path.join(os.path.dirname(__file__),"static"),
    )

application = tornado.web.Application(
    handlers=url,
    **setting
    )

from url import url是从文件url.py引入内容

下面看看url.py文件内容：

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

import sys
reload(sys)
sys.setdefaultencoding('utf-8')

from handler.index import IndexHandler

url=[
    (r'/', IndexHandler),

    ]

在这个文件中，从import sys开始的三行，主要是为了解决若是文件里面有汉字，避免出现乱码。如今这个文件很简单，里面只有(r'/', IndexHandler)一条URL，若是多条了，就要说明每条是什么用途，若是用中文写注释，须要避免乱码。

以上两个预备好了，就开始写server.py，内容以下：

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

import tornado.ioloop
import tornado.options
import tornado.httpserver

import sys

from application import application

from tornado.options import define,options
define("port",default=8888,help="run on th given port",type=int)

def main():
    tornado.options.parse_command_line()
    http_server = tornado.httpserver.HTTPServer(application)
    http_server.listen(options.port)
    print 'Development server is running at http://127.0.0.1:%s/' % options.port
    print 'Quit the server with Control-C'
    tornado.ioloop.IOLoop.instance().start()

if __name__=="__main__":
    main()

这个就不须要解释了。接下来就看目录，首先在static/css/里面创建一个style.css的文件，并写样式表。我只写了下面的样式，这个样式的目的主要是去除浏览器默认的样式，在实际的工程项目中，这个步骤是很是必要的，必定要去除全部默认的样式，而后从新定义，才能便于控制。

html, body, div, span, applet, object, iframe,h1, h2, h3, h4, h5, h6, p, blockquote, pre,a, abbr, acronym, address, big, cite, code,del, dfn, em, img, ins, kbd, q, s, samp,small, strike, strong, sub, sup, tt, var,b, u, i, center,dl, dt, dd, ol, ul, li,fieldset, form, label, legend,table, caption, tbody, tfoot, thead, tr, th, td,article, aside, canvas, details, embed, figure, figcaption, footer, header, hgroup, menu, nav, output, ruby, section, summary,time, mark, audio, video {
    margin: 0;
    padding: 0;
    border: 0;
    font-size: 100%;
    font: inherit;
    vertical-align: baseline;
}
/* HTML5 display-role reset for older browsers */
article, aside, details, figcaption, figure, footer, header, hgroup, menu, nav, section {
        display: block;
}


body {
        /* standard body */
        margin: 0 auto;
        width: 960px;
        font: 14px/20px "Trebuchet MS", Verdana, Helvetica, Arial, sans-serif;
}

为了可以在演示的时候看出样式控制的变化，多写了一个对body的控制，居中且宽度为960px。

样式表已经定义好，就要看template/index.html了，这个文件就是本项目中的惟一一个模板。

<DOCTYPE html>
<html>
    <head>
        <title>Loop in template</title>
        <link rel="stylesheet" type="text/css" href="{{ static_url('css/style.css')}}">
    </head>
    <body>
    <h1>aaaAAA</h1>
    <p>There is a list, it is <b>{{info}}</b></p>
    <p>I will print the elements of this list in order.</p>
    {% for element in info %}
        <p>{{element}}</p>
    {% end %}
    <br>
    {% for index,element in enumerate(info) %}
        <p>info[{{index}}] is {{element}}
        {% if element == "python" %}
            <p> <b>I love this language--{{element}}</b></p>
        {% end %}
    {% end %}

    {% if "qiwsir@gmail.com" in info %}
        <p><b>A Ha, this the python lesson of LaoQi, It is good! His email is {{info[2]}}</b></p>
    {% end %}
    <h2>Next, I set "python-tornado"(a string) to a variable(var)</h2>
    {% set var="python-tornado" %}
    <p>Would you like {{var}}?</p>
    </body>
</html>

在这个文件中，特别注意就是<link rel="stylesheet" type='text/css' href="{{ static_url('css/style.css')}}",这里引入了前面定义的样式表文件。引入方式就是前文讲述的方式，不过因为是在css这个子目录里面，因此写了相对路径。

行文到此，我原觉得已经完成了。一检查，发现一个重要的目录handler里面还空着呢，那里面放index.py文件，这个文件里面是请求响应的类IndexHandler

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

import tornado.web

import sys
reload(sys)
sys.setdefaultencoding('utf-8') 

class IndexHandler(tornado.web.RequestHandler):
    def get(self):
        lst = ["python","www.itdiffer.com","qiwsir@gmail.com"]
        self.render("index.html", info=lst)

这个文件的代码没有什么增长的内容，只是多了三行设置为utf-8的配置，目的是避免汉字乱码。另外，很须要说明的是，因为这个文件在handler目录里面，要在上一层的url.py中引用（看url.py内容）,必需要在本目录中创建一个名称是__init__.py的空文。

好了，基本结构已经完成。跑起来。效果就是这样的：

[零基础学python]Tornado静态路径以及一个项目框架

静态路径

编写模板文件

一个项目框架

欢迎反问个人网站：www.itdiffer.com，这里已经将全部《零基础学python》的课程整理好，而且及时更改错误。