アプリケーション構成
クラス (handlers:List [Union [Rule 、Tuple]] =なし、default_host:str =なし、转换:List [Type [OutputTransform]] =なし、**設定 )tornado.web.
Application
settings
コンストラクタに渡される他のキーワード引数は、ドキュメントでは「アプリケーション設定」と呼ばれることが多い辞書に保持されます。設定は、竜巻のさまざまな側面をカスタマイズするために使用されます(場合によっては、サブクラスのメソッドをオーバーライドすることにより、より豊かなカスタマイズを行うことができます)。一部のアプリケーションでは、ハンドラーがグローバル変数を使用せずにアプリケーション固有の設定を使用できるようにする方法として、辞書を使用することも好みます。トルネードで使用する設定は以下の通りです。settings
RequestHandler
settings
一般的な設定:
-
autoreload
:はいの場合True
、デバッグモードと自動再読み込みで説明されているように、ソースファイルが変更されるとサーバープロセスが再起動されます。このオプションはトルネード3.2の新機能で、以前は設定によって制御されていました。debug
-
debug
:デバッグモードと自動再読み込みで説明されているように、いくつかのデバッグモード設定の省略形。設定debug=True
の同等のものをautoreload=True
、compiled_template_cache=False
、static_hash_cache=False
、serve_traceback=True
。 -
default_handler_class
そしてdefault_handler_args
:他に一致するものが見つからない場合、このハンドラーが使用されます; これを使用してカスタム404ページを実装します(トルネード3.2の新機能)。 -
compress_response
:の場合True
、テキスト形式の応答は自動的に圧縮されます。トルネード4.0の新機能。 -
gzip
:compress_response
Tornado 4.0以降、エイリアスは推奨されていません。 -
log_function
:この関数は、各リクエストの最後に呼び出され、結果を記録します(1つのパラメーターであるオブジェクト)。デフォルトの実装では、モジュールのルートレコーダーに書き込みます。上書きしてカスタマイズすることもできます。RequestHandler
logging
Application.log_request
-
serve_traceback
: yesのTrue
場合、デフォルトのエラーページにエラートレースバックが含まれます。このオプションはトルネード3.2の新機能で、以前は設定によって制御されていました。debug
-
ui_modules
Andui_methods
:テンプレートUIメソッドまたはUIメソッドマッピングとして設定できます。モジュール、辞書またはモジュールおよび/または辞書リストに設定できます。詳細については、 UIモジュールを参照してください。UIModule
-
websocket_ping_interval
:数値に設定すると、すべてのネットワークソケットがn秒ごとにpingを実行します。これは、アイドル接続のプロキシサーバーをいくつか閉じることによって接続をアクティブに保つのに役立ち、WebSocketが失敗して適切に閉じられなかったかどうかを検出できます。 -
websocket_ping_timeout
: ping間隔が設定されており、サーバーがこの1秒以内に「pong」を受信しない場合、サーバーはWebソケットを閉じます。デフォルト値は、ping間隔の3倍、少なくとも30秒です。ping間隔が設定されていない場合、無視されます。
認証とセキュリティの設定:
-
cookie_secret
: とCookieの署名に使用されます。RequestHandler.get_secure_cookie
set_secure_cookie
-
key_version
: ときに キー辞書は辞書のキーであるのRequestHandler 特定のキーのクッキーを使用するが署名されています。set_secure_cookie
cookie_secret
-
login_url
:ユーザーがログインしていない場合、デコレータはそのURLにリダイレクトします。書き換えによりさらにカスタマイズ可能authenticated
RequestHandler.get_login_url
-
xsrf_cookies
:はいの場合True
、クロスサイトリクエストフォージェリ保護が有効になります。 -
xsrf_cookie_version
:このサーバーによって生成された新しいXSRF Cookieのバージョンを制御します。通常はデフォルト値のままにします(常にサポートされている最も高いバージョンになります)が、バージョンの移行中に一時的に低い値に設定できます。トルネード3.2.2の新機能として、XSRF Cookieバージョン2が導入されました。 -
xsrf_cookie_kwargs
: XSRF Cookie が他のパラメーターに渡す辞書として 設定できます。RequestHandler.set_cookie
-
twitter_consumer_key
、twitter_consumer_secret
、friendfeed_consumer_key
、friendfeed_consumer_secret
、google_consumer_key
、google_consumer_secret
、facebook_api_key
、facebook_secret
:としては使用され 、さまざまなAPIを検証するために、モジュールを。tornado.auth
テンプレート設定:
-
autoescape
:テンプレートの自動エスケープを制御します。するように設定することができNone
、エスケープ、または無効に設定し 、すべての出力によって機能する必要があります名前。デフォルトは"xhtml_escape"
です。手順を使用して、テンプレートごとに変更を加えることができます。{% autoescape %}
-
compiled_template_cache
:デフォルトはTrue
;False
各リクエストに従ってテンプレートを再コンパイルするかどうか。このオプションはトルネード3.2の新機能で、以前は設定によって制御されていました。debug
-
template_path
:テンプレートファイルを含むディレクトリ。カバーすることでさらにカスタマイズできますRequestHandler.get_template_path
-
template_loader
:割り当てられたインスタンスは、カスタムテンプレートとともにロードされます 。この設定を使用すると、および 設定は無視されます。上書きすることでさらにカスタマイズできます。tornado.template.BaseLoader
template_path
autoescape
RequestHandler.create_template_loader
-
template_whitespace
:テンプレート内のスペースの処理を制御します。許可される値については、を参照してください。トルネード4.3の新機能。tornado.template.filter_whitespace
静的ファイルの設定:
-
static_hash_cache
:デフォルトはTrue
;False
静的URLがリクエストごとに再計算されるかどうか。このオプションはトルネード3.2の新機能で、以前は設定によって制御されていました。debug
-
static_path
:静的ファイルのディレクトリが提供されます。 -
static_url_prefix
:静的ファイルのURL接頭辞。デフォルトは"/static/"
です。 -
static_handler_class
、static_handler_args
:デフォルトのハンドラーを使用する代わりに、静的ファイルの他のハンドラーを使用するように設定できます 。 (設定されている場合)、ハンドラーメソッドに渡されるキーワード引数の辞書である必要があります。tornado.web.StaticFileHandler
static_handler_args
initialize