Python：Tornado 第二章：实战演练：开发Tornado网站：第四节：RequestHandler：输入捕捉

上一篇文章： Python：Tornado 第二章：实战演练：开发Tornado网站：第三节：RequestHandler：接入点函数
下一篇文章： Python：Tornado 第二章：实战演练：开发Tornado网站：第五节：RequestHandler：输出相应函数

输入捕捉是指在RequestHandler中用于获取客户端输入的工具函数和属性。好比获取URL参数、Post提交参数等。

一、get_argument(name)、get_arguments(name)

RequestHandler.get_argument(name)与RequestHandler.get_arguments(name)都是返回给定参数的值。get_argument是获取单个值,而get_arguments在参数存在多个值得状况下使用，返回多个值的列表。
注意：使用这两个方法获取的事URL中查询的参数与POST提交的参数的参数合集。

二、get_query_argument(name)、get_query_arguments(name)

功能与上面两个方法相似，惟一区别是这两个方法仅仅从URL中查询参数。

三、get_body_argument(name)、get_body_arguments(name)

功能尚与上面四个方法相似，惟一区别是这两个方法仅仅从POST提交的参数中查询。

提示：实际开发中通常会使用get_argument、get_arguments这两个方法，由于他们会包含其余方法的查询结果。

四、get_cookie(name,default=None)

根据Cookie名称获取Cookie的值

五、 RequestHandler.request

返回tornado.httputil.HTTPServerRequest对象实例的属性，经过该对象能够获取关于HTTP请求的一切信息，好比：

from tornado.web import Application, RequestHandler
import tornado.ioloop


class DetailHandler(RequestHandler):
    def get(self):
        ip = self.request.remote_ip  # 获取客户端的IP地址
        host = self.request.host  # 获取请求的主机地址
        result="ip地址为%s,host为%s"%(ip,host)
        return self.write(result)


if __name__ == '__main__':
    app = Application([
        ("/request", DetailHandler)
    ])
    app.listen(8888)
    tornado.ioloop.IOLoop.current().start()

浏览器输入：http://localhost:8888/request

页面显示：

ip地址为::1,host为localhost:8888

经常使用的httputil.HTTPServerRequest对象属性以下表：

属性名	说明
method	HTTP请求方法，例如：GET、POST
uri	客户端请求的uri的完整内容。
path	uri路径名，即不包含查询字符串
query	uri中的查询字符串
version	客户端发送请求时使用的HTTP版本，例如：HTTP/1.1
headers	以字典方式的形式返回HTTP Headers
body	以字符串的形式返回HTTP消息体
remote_ip	客户端的IP地址
protocol	请求协议，例如：HTTP、HTTPS
host	请求消息的主机名
arguments	客户端提交的全部参数。
files	以字典形式返回客户端上传的文件，每一个文件名对应一个HTTPFile
cookies	客户端提交的Cookies字典