让我们先看一段程序 (hello.py)
import tornado.httpserver
import tornado.ioloop
import tornado.options
import tornado.web
from tornado.options import define, options
define("port", default=8888, help="run on the given port", type=int)
class IndexHandler(tornado.web.RequestHandler):
def get(self):
greeting = self.get_argument('greeting', 'Hello')
self.write(greeting + ',friendly user!')
if __name__ == "__main__":
tornado.options.parse_command_line()
app = tornado.web.Application(handlers=[(r"/", IndexHandler)])
http_server = tornado.httpserver.HTTPServer(app)
http_server.listen(options.port)
tornado.ioloop.IOLoop.instance().start()
我们可以通过命令行执行
$python hello.py --port=8888
来运行程序。这里命令行参数“--port=8888" 可以省略。如果省略,则使用程序中用 define 定义的默认值。我们后面将会解释。
现在打开一个浏览器,访问 http://localhost:8888/,我们可以看到浏览器显示:
Hello, friendly user!
如果访问 http://localhost:8888/?greeting=nihao,那么在浏览器中将会显示:
nihao, friendly user!
我们下面进行分析:
1. tornado.options 库用于解析命令行参数。 define 语句中定义的 选项都会成为全局对象 options 的属性。如果用户没有提供定义的参数,则使用 define 语句中定义的默认值。define 语句中的 type 参数用于进行简单的类型检查。检查失败回抛出异常。如本例中指定 port 类型为 int。
2. Tornado 的请求处理类(本例中的 IndexHandler)。当处理 HTTP 请求时,Tornado 实例化类并根据请求类型调用相应的方法。在本例中使用 GET 方法请求,因此调用 get 方法。
3. RequestHandler 的 get_argument 方法可以返回一个参数。如上例中 ?greeting=nihao,那么 get_argument("greeting", "Hello") 将返回 "nihao" 。如果没有参数则使用get_argument 的第二个参数作为默认值。
4. RequestHandler 的 write 方法。它具有一个字符串参数。该方法将字符串写入 HTTP response。