使用Python的Tornado框架实现一个Web端图书展示页面

程序员文章站 2022-04-08 22:56:50

...

首先，为什么选择Tornado：
1.高性能的网络库，这可以和gevent,twisted,libevent等做对。
提供了异步io支持，超时事件处理，在此基础上提供了tcpserver,httpclient，尤其是curlhttpclient,
在现有http客户端中肯定排第一。可以用来做爬虫，游戏服务器，据我所知业界已有使用tornado作为游戏服务器

2.web框架，这可以和django,flask对。
提供了路由，模板等web框架必备组件。与其他区别是tornado是异步的，天然适合长轮训，
这也是friendfeed发明tornado的原因，当前flask也可以支持，但必须借助gevent等

3.较为完备的http服务器，这点可以和nginx,apache对比，
但只支持http1.0,所以使用nginx做前段不仅是为了更好利用多核，也是让其支持http1.1

4.完备的wsgi服务器，这可以和gunicore,gevent wsgi server做对比，
也就是说可以让flask运行在tornado之上，让tornado加速flask

5.提供了完备的websocket支持，这让html5的游戏等提供了便利。
像知乎长轮训就是使用了websocket,但websocket手机支持的不是很好，
前段时间不得不使用定时ajax发送大量请求，期待手机浏览器赶快奋起直追

使用tornado创建一个简单的图书介绍页
好了，言归正传，下面我们来看一下这个图书介绍页的代码实现：
1.创建一个web服务的入口文件 blockmain.py

#coding:utf-8
import tornado.web
import tornado.httpserver
import tornado.ioloop
import tornado.options
import os.path
import json
import urllib2

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

class MainHandler(tornado.web.RequestHandler):
  def get(self):
    self.render(
      "index.html",
      page_title = "Burt's Books ¦ Home",
      header_text = "Welcome to Burt's Books!",
      books = ['细说php','python','PHP','小时代']
    )


class HelloModule(tornado.web.UIModule):
  def render(self):
    return'I am yyx and this is an information from module hello!'

class BookModule(tornado.web.UIModule):
  def render(self,bookname):
    doubanapi = r'https://api.douban.com/v2/book/'
    searchapi = r'https://api.douban.com/v2/book/search?q='
    searchurl = searchapi+bookname
    searchresult = urllib2.urlopen(searchurl).read()
    bookid = json.loads(searchresult)['books'][0]['id']
    bookurl = doubanapi+bookid
    injson = urllib2.urlopen(bookurl).read()
    bookinfo = json.loads(injson)
    return self.render_string('modules/book.html',book = bookinfo)

  def embedded_javascript(self):
    return "document.write(\"hi!\")"

  def embedded_css(self):
    return '''.book {background-color:#F5F5F5}
         .book_body{color:red}
    '''

  def html_body(self):
    return ''

if __name__ == "__main__":
  tornado.options.parse_command_line()
  app = tornado.web.Application(
    handlers = [
      (r'/',MainHandler),

    ],
    template_path = os.path.join(os.path.dirname(__file__),'templates'),
    static_path = os.path.join(os.path.dirname(__file__),'static'),
    debug = True,
    ui_modules={'Hello':HelloModule,'Book':BookModule}


    )
  http_server = tornado.httpserver.HTTPServer(app)
  http_server.listen(options.port)
  tornado.ioloop.IOLoop.instance().start()

说明一下，一些基本的MVC概念：
tornado也是通过pathinfo模式来匹配用户的输入来获得参数，然后再调用相应的处理函数，它是通过为各种匹配模式设定相应的class类来处理，比如我这里就是通过class MainHandler来处理来自/的get请求
MainHandler把请求render渲染到index.html，参数在index.html中通过{{参数}}来调用

2.建立相应的模板，先创建一个基础的父类main.html模板，创建templates目录，在它下面创建main.html,这个模板只是定义了最基础的网页框架，里面的具体内容由继承于它的子类来具体实现


{{ page_title }}
    
      {% block header %}Burt's Books{% end %}
    

      
        {% block body %}{% end %}
      
    
    
      {% set mailLink = 'Contact Us' %}
      {% set script = '' %}
      {% block footer %}

        
          For more information about our selection, hours or events, please email us at{% raw mailLink %}

           
        
      {% end %}

这里是定义了一个主框架，其中里面的{% block header %}

Burt's Books

{% end %}是为了子类模板的继承的块(block)，当子类继承了这个main.html，具体这个块里写什么内容由子类来实现，不实现的话就使用父类的默认值，如是这里的

Burt's Books

，MainHandler类是render到一个index.html，那么接下来写一个index.html来继承这个父类

{% extends "main.html" %}

{% block header %}
  {{ header_text }}
{% end %}

{% block body %}
  
    Welcome to Burt's Books!
    {% module Hello() %}

    {% for book in books %}
      {% module Book(book) %}
    {% end %}
    ...
  
{% end %}

简单简洁吧，这也是使用了继承的好处，不用再重复写父类的东西，只要实现父类的block内容即可
MainHandler类里的render方法中的参数

page_title = "Burt's Books | Home",
header_text = "Welcome to Burt's Books!",
books = ['细说php','python','PHP','小时代']

将会通过参数传送到这里来
tornado的模板里可以使用python的代码，加上{% %}当使用if for while等要使用{% end %}结尾
代码中{% module Book(book) %} 将会调用入口服务文件中的定义和'Book'所对应的模块
ui_modules={'Hello':HelloModule,'Book':BookModule} 也就是BookModule，查看上面的BookModule定义

class BookModule(tornado.web.UIModule):
  def render(self,bookname):
    doubanapi = r'https://api.douban.com/v2/book/'
    searchapi = r'https://api.douban.com/v2/book/search?q='
    searchurl = searchapi+bookname
    searchresult = urllib2.urlopen(searchurl).read()
    bookid = json.loads(searchresult)['books'][0]['id']
    bookurl = doubanapi+bookid
    injson = urllib2.urlopen(bookurl).read()
    bookinfo = json.loads(injson)
    return self.render_string('modules/book.html',book = bookinfo)

BookModule 继承自tornado.web.UIModule，UI模块的使用是最后render_string()方法来把一个对象渲染到一个模板中去，我这里简单的使用了豆瓣的图书api，先通过search来查询一下包含关键词的图书信息，返回第一条图书的id，再使用book api来查询该图书的具体信息，将这个具体图书的信息render到对应的模板
在templates 目录下创建modules目录，再下创建一个book.html，这里是具体的book要显示的内容框架


  {{ book["title"] }}
  点击查看详情
  {% if book["subtitle"] != "" %}
    {{ book["subtitle"] }}
  {% end %}
  
    Released: {{ book["pubdate"]}}    
    Description:
    {% raw book["summary"] %}

最后的文件目录结构应该是这样的

├── blockmain.py
└── templates
  ├── index.html
  ├── main.html
  └── modules
    └── book.html

程序的执行是这样的：
先通过路径‘/'来使用MainHandler类访问index.html---->index.html继承自 main.html---->index.html中的{% module Book(book) %}反过来查找blockmain.py中的Book对应的ui_modules---->ui_modules中将查询得到的book对象内容渲染到modules下的book.html中，这样就把完整的内容呈现出来了，没有做前端…… 通过python blockmain.py启动服务，通过http://localhost:8000 来访问得到如下的网页

使用Python的Tornado框架实现一个Web端图书展示页面