RequestHandler 类

RequestHandler 类是 HTTP 请求处理程序的超类。

RequestHandler 由 google.appengine.ext.webapp 模块提供。

• 简介
• RequestHandler()
• 实例方法：
  • get()
  • post()
  • put()
  • head()
  • options()
  • delete()
  • trace()
  • handle_exception()
  • error()
  • redirect()
  • initialize()
• 实例属性：
  • request
  • response

简介

webapp 应用程序会定义一个或多个 RequestHandler 类以处理请求。handler 类会覆盖以下一个或多个方法以处理相应类型的 HTTP 请求：get()、post()、head()、options()、put()、delete() 或 trace()。

构造函数

class RequestHandler()

HTTP 请求处理程序的基类。

该构造函数不使用任何参数。可使用 initialize() 方法初始化该实例。

实例方法

RequestHandler 类的子类可继承或覆盖以下方法：

get(*args)

调用此方法以处理 HTTP GET 请求。可由 Handler 子类覆盖此方法。

post(*args)

调用此方法以处理 HTTP POST 请求。可由 Handler 子类覆盖此方法。

put(*args)

调用此方法以处理 HTTP PUT 请求。可由 Handler 子类覆盖此方法。

head(*args)

调用此方法以处理 HTTP HEAD 请求。可由 Handler 子类覆盖此方法。

options(*args)

调用此方法以处理 HTTP OPTIONS 请求。可由 Handler 子类覆盖此方法。

delete(*args)

调用此方法以处理 HTTP DELETE 请求。可由 Handler 子类覆盖此方法。

trace(*args)

调用此方法以处理 HTTP TRACE 请求。可由 Handler 子类覆盖此方法。

handle_exception(exception, debug_mode)

处理程序抛出异常时调用此方法。默认情况下，handle_exception 会将 HTTP 状态代码设置为 500（[服务器错误]）。如果 debug_mode 为 True，则它将向浏览器打印一个堆栈跟踪。否则，将只打印一个纯文本错误消息。RequestHandler 类可覆盖此方法以提供自定义行为。

error(code)

处理程序用来返回错误响应的一种快捷方法。清除响应输出流并将 HTTP 错误代码设置为 code。这相当于调用 self.response.clear() 和 self.response.set_status(code)。

redirect(uri, permanent=False)

处理程序用来返回重定向响应的一种快捷方法。设置 HTTP 错误代码和 Location: 标头以重定向至 uri，并清除响应输出流。如果 permanent 为 True，则它将使用 HTTP 状态代码 301 来进行永久重定向。否则，将使用 HTTP 状态代码 302 进行临时重定向。

initialize(request, response)

使用 Request 和 Response 对象初始化处理程序实例。通常，WSGIApplication 在实例化 Handler 类后执行此操作。

实例属性

RequestHandler 的子类的实例具有以下属性：

request

Request 实例。通常，由 WSGIApplication 在构建对象之后初始化该属性。

response

Response 实例。通常，由 WSGIApplication 在构建对象之后初始化该属性。