Tornado框架中HttpServer的详细参数及配置说明

Tornado是一个高性能的Python web框架，其内置了一个基于非阻塞IO的HTTP服务器，被称为Tornado HTTPServer。该HTTP服务器允许用户通过提供一些参数来进行配置和自定义。

下面是Tornado HTTPServer的一些常见参数及配置说明：

1. bind：绑定的IP地址和端口号。默认为localhost:8888。可以使用字符串形式的address:port或长度为2的元组，例如('localhost', 8888)。

2. xheaders：是否使用X-Real-IP和X-Scheme等头部信息传递给应用程序。默认为False。当设置为True时，Tornado会尝试从X-Real-IP、X-Forwarded-For和X-Scheme等头部中获取真实的客户端IP地址和协议。

3. ssl_options：使用SSL/TLS进行安全连接的选项。默认为None，表示不使用SSL/TLS。可以传递一个字典，包含SSL证书和私钥的路径、密码等信息。

4. max_body_size：请求体的最大长度，单位为字节。默认为100*1024*1024，即100MB。如果请求体超过该限制，Tornado会返回400 Bad Request错误响应。

5. max_buffer_size：每个HTTP请求的最大缓冲区大小，单位为字节。默认为104857600，即100MB。如果请求超过了该限制，Tornado会关闭连接。

6. max_header_size：HTTP请求头部的最大长度，单位为字节。默认为65536，即64KB。如果请求头部超过了该限制，Tornado会返回400 Bad Request错误响应。

7. idle_connection_timeout：空闲连接的超时时间，单位为秒。默认为2*60，即2分钟。如果连接在指定时间内没有任何读写操作，Tornado会关闭连接。

8. body_timeout：请求体读取的超时时间，单位为秒。默认为20。如果请求体在指定时间内没有被完整读取，Tornado会返回400 Bad Request错误响应。

9. header_timeout：HTTP请求头部读取的超时时间，单位为秒。默认为20。如果请求头部在指定时间内没有被完整读取，Tornado会返回400 Bad Request错误响应。

10. request_callback：在接收到一个完整的HTTP请求后，Tornado会调用该回调函数来处理请求。默认为None，表示使用Tornado内置的默认请求处理方式。

下面是一个使用Tornado HTTPServer的简单示例：

import tornado.ioloop
import tornado.web
from tornado.httpserver import HTTPServer

class MainHandler(tornado.web.RequestHandler):
    def get(self):
        self.write("Hello, Tornado!")

def make_app():
    return tornado.web.Application([
        (r"/", MainHandler),
    ])

if __name__ == "__main__":
    app = make_app()
    http_server = HTTPServer(app)
    http_server.listen(8888)
    tornado.ioloop.IOLoop.current().start()

在上述示例中，我们首先定义了一个MainHandler类，用于处理HTTP请求。然后通过make_app函数创建了一个Tornado应用程序，将URL路径'/'与MainHandler类关联起来。接着，我们创建了一个Tornado HTTPServer实例http_server，监听在端口8888上。最后，通过IOLoop.current().start()方法启动Tornado的事件循环，开始处理HTTP请求。

可以通过修改上述代码中的参数来自定义Tornado HTTPServer的配置。比如，可以通过设置bind参数来指定绑定的IP地址和端口号，通过设置ssl_options参数来启用SSL/TLS安全连接等。