tornado.wsgi — Interoperability with other Python frameworks and servers¶

WSGI support for the Tornado web framework.

WSGI is the Python standard for web servers, and allows for interoperabilitybetween Tornado and other Python web frameworks and servers. This moduleprovides WSGI support in two ways:

• WSGIAdapter converts a tornado.web.Application to the WSGI applicationinterface. This is useful for running a Tornado app on anotherHTTP server, such as Google App Engine. See the WSGIAdapter classdocumentation for limitations that apply.
• WSGIContainer lets you run other WSGI applications and frameworks on theTornado HTTP server. For example, with this class you can mix Djangoand Tornado handlers in a single server.

Running Tornado apps on WSGI servers¶

class tornado.wsgi.WSGIAdapter(application)[源代码]¶

Converts a tornado.web.Application instance into a WSGI application.

Example usage:

import tornado.web
import tornado.wsgi
import wsgiref.simpleserver

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

if name == "main":
    application = tornado.web.Application([
        (r"/", MainHandler),
    ])
    wsgi_app = tornado.wsgi.WSGIAdapter(application)
    server = wsgiref.simple_server.make_server('', 8888, wsgi_app)
    server.serve_forever()

See the appengine demofor an example of using this module to run a Tornado app on GoogleApp Engine.

In WSGI mode asynchronous methods are not supported. This meansthat it is not possible to use AsyncHTTPClient, or thetornado.auth or tornado.websocket modules.


4.0 新版功能.

_class tornado.wsgi.WSGIApplication(handlers=None, default_host='', transforms=None, **settings)[源代码]¶

A WSGI equivalent of tornado.web.Application.


4.0 版后已移除: Use a regular Application and wrap it in WSGIAdapter instead.

Running WSGI apps on Tornado servers¶

class tornado.wsgi.WSGIContainer(wsgi_application)[源代码]¶

Makes a WSGI-compatible function runnable on Tornado’s HTTP server.


警告

WSGI is a synchronous interface, while Tornado’s concurrency modelis based on single-threaded asynchronous execution. This means thatrunning a WSGI app with Tornado’s WSGIContainer is less scalable_than running the same app in a multi-threaded WSGI server likegunicorn or uwsgi. Use WSGIContainer only when there arebenefits to combining Tornado and WSGI in the same process thatoutweigh the reduced scalability.


Wrap a WSGI function in a WSGIContainer and pass it to HTTPServer torun it. For example:

def simple_app(environ, start_response):
    status = "200 OK"
    response_headers = [("Content-type", "text/plain")]
    start_response(status, response_headers)
    return ["Hello world!\n"]

container = tornado.wsgi.WSGIContainer(simple_app)
http_server = tornado.httpserver.HTTPServer(container)
http_server.listen(8888)
tornado.ioloop.IOLoop.current().start()

This class is intended to let other frameworks (Django, web.py, etc)run on the Tornado HTTP server and I/O loop.

The tornado.web.FallbackHandler class is often useful for mixingTornado and WSGI apps in the same server. Seehttps://github.com/bdarnell/django-tornado-demo for a complete example.

_static environ(request)[源代码]¶

Converts a tornado.httputil.HTTPServerRequest to a WSGI environment.

原文:

https://tornado-zh-cn.readthedocs.io/zh_CN/latest/wsgi.html