-
WSGI 应用程序是 Python_可调用_的,例如函数、类或具有
__call__
方法的类实例 -
应用程序可调用必须接受两个参数:
environ
,它是一个包含请求数据的 Python 字典,以及start_fn
,它本身是可调用的。 -
应用程序必须
start_fn
使用两个参数调用:状态代码(作为字符串)和表示为 2 元组的标头列表。 -
应用程序返回一个包含响应正文中字节的可迭代对象,以方便的、可流式传输的块形式——在本例中,是一个仅包含
"Hello, World!"
. (如果app
是一个类,这可以在__iter__
方法中完成。)
举例来说,接下来的两个例子与第一个例子是等价的:
class app(object):
def init(self, environ, start_fn):
self.environ = environ
self.start_fn = start_fn
def iter(self):
self.start_fn(‘200 OK’, [(‘Content-Type’, ‘text/plain’)])
yield “Hello World!\n”
class Application(object):
def call(self, environ, start_fn):
start_fn(‘200 OK’, [(‘Content-Type’, ‘text/plain’)])
yield “Hello World!\n”
app = Application()
您可能已经在考虑使用这些信息的方法,但最相关的方法可能是编写中间件。
让它变得活泼起来
中间件是扩展 WSGI 应用程序功能的一种简单方法。由于您只需要提供一个可调用对象,因此您可以随意将其包装在其他函数中。
例如,假设我们要检查environ
. 我们可以轻松地创建一个中间件来执行此操作,如下例所示:
import pprint
def handler(environ, start_fn):
start_fn(‘200 OK’, [(‘Content-Type’, ‘text/plain’)])
return [“Hello World!\n”]
def log_environ(handler):
def _inner(environ, start_fn):
pprint.pprint(environ)
return handler(environ, start_fn)
return _inner
app = log_environ(handler)
这里,log_environ
是一个返回函数的函数,它environ
在推迟到原始回调之前漂亮地打印参数。
以这种方式编写中间件的好处是中间件和处理程序不必相互了解或关心。例如,您可以轻松地log_environ
连接到Flask应用程序,因为 Flask 应用程序是 WSGI 应用程序。
其他一些有用的中间件想法:
import pprint
def handle_error(handler):
def _inner(environ, start_fn):
try:
return handler(environ, start_fn)
except Exception as e:
print e # Log error
start_fn(‘500 Server Error’, [(‘Content-Type’, ‘text/plain’)])
return [‘500 Server Error’]
return _inner
def wrap_query_params(handler):
def _inner(environ, start_fn):
qs = environ.get(‘QUERY_STRING’)
environ[‘QUERY_PARAMS’] = urlparse.parse_qs(qs)
return handler(environ, start_fn)
return _inner
reduce
如果您不想在文件底部制作一个大金字塔,您可以使用一次应用一堆中间件:
# Applied from bottom to top on the way in, then top to bottom on the way out
MIDDLEWARES = [wrap_query_params,
log_environ,
handle_error]
app = reduce(lambda h, m: m(h), MIDDLEWARES, handler)
您还可以利用参数编写修改响应的中间件start_fn
。这是一个中间件,如果Content-Type
标头是,则反转输出text/plain
:
def reverser(handler):
# A reverse function
rev = lambda it: it[::-1]
def _inner(environ, start_fn):
do_reverse = [] # Must be a reference type such as a list
# Override start_fn to check the content type and set a flag
def start_reverser(status, headers):
for name, value in headers:
if (name.lower() == ‘content-type’
and value.lower() == ‘text/plain’):
do_reverse.append(True)
break
# Remember to call start_fn
start_fn(status, headers)
response = handler(environ, start_reverser)
try:
if do_reverse:
return list(rev(map(rev, response)))
return response
finally:
if hasattr(response, ‘close’):
response.close()
return _inner
由于分离和响应,它有点纠结start_fn
,但仍然完美可行。
另请注意,要严格遵守 WSGI 规范,我们必须检查响应上的close方法并在存在时调用它。传统的 WSGI 应用程序也可能在调用时返回一个write函数而不是一个 iterable handler
;如果您希望您的中间件支持较旧的应用程序,您可能需要处理这种情况。
一旦你开始使用原始的 WSGI,你就会开始理解为什么 Python 有几十个 Web 框架。WSGI 使得从头开始构建东西变得非常简单。例如,您可能正在考虑路由问题:
routes = {
‘/’: home_handler,
‘/about’: about_handler,
}
class Application(object):
def init(self, routes):
self.routes = routes
def not_found(self, environ, start_fn):
start_fn(‘404 Not Found’, [(‘Content-Type’, ‘text/plain’)])
return [‘404 Not Found’]
def call(self, environ, start_fn):