tornado学习笔记

本文摘自http://demo.pythoner.com/itt2zh/index.html

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

from tornado.options import define, options
define("port", default=8000, help="run on the given port", type=int) #Tornado包括了一个有用的模块（tornado.options）来从命令行中
                                                                     #读取设置.我们在这里使用这个模块指定我们的应用监听HTTP请求
                                                                     #的端口.它的工作流程如下：如果一个与define语句中同名的设置
                                                                     #在命令行中被给出,那么它将成为全局options的一个属性.如果用
                                                                     #户运行程序时使用了--help选项,程序将打印出所有你定义的选项
                                                                     #以及你在define函数的help参数中指定的文本.如果用户没有为这
                                                                     #个选项指定值，则使用default的值进行代替.Tornado使用type参
                                                                     #数进行基本的参数类型验证,当不合适的类型被给出时抛出一个异
                                                                     #常.因此,我们允许一个整数的port参数作为options.port来访问程
                                                                     #序,如果用户没有指定值,则默认为8000.

class IndexHandler(tornado.web.RequestHandler):                      #这是Tornado的请求处理函数类.当处理一个请求时,Tornado将这个
                                                                     #类实例化,并调用与HTTP请求方法所对应的方法.在这个例子中,我们
                                                                     #只定义了一个get方法,也就是说这个处理函数将对HTTP的GET请求作
                                                                     #出响应.我们稍后将看到实现不止一个HTTP方法的处理函数。

                                                                    
    def get(self):                                                    
        greeting = self.get_argument('greeting', 'Hello')            #Tornado的RequestHandler类有一系列有用的内建方法,包括
                                                                     #get_argument,我们在这里从一个查询字符串中取得参数
                                                                     #greeting的值.(如果这个参数没有出现在查询字符串中,
                                                                     #Tornado将使用get_argument的第二个参数作为默认值.)

        self.write(greeting + ', friendly user!')                    #RequestHandler的另一个有用的方法是write,它以一个字符串
                                                                     #作为函数的参数,并将其写入到HTTP响应中.在这里，我们使用
                                                                     #请求中greeting参数提供的值插入到greeting中，并写回到响应中.

if __name__ == "__main__":
    tornado.options.parse_command_line()                             #我们使用Tornado的options模块来解析命令行。
    app = tornado.web.Application(handlers=[(r"/", IndexHandler)])   #我们创建了一个Tornado的Application类的实例.传递给Application
                                                                     #类__init__方法的最重要的参数是handlers。它告诉Tornado应该用
                                                                     #哪个类来响应请求.

    http_server = tornado.httpserver.HTTPServer(app)                 #从这里开始的代码将会被反复使用:一旦Application对象被创建,
                                                                     #我们可以将其传递给Tornado的HTTPServer对象,然后使用我们在命令
                                                                     #行指定的端口进行监听(通过options对象取出.)最后,在程序准备好接
                                                                     #收HTTP请求后,我们创建一个Tornado的IOLoop的实例。
    http_server.listen(options.port)
    tornado.ioloop.IOLoop.instance().start()