Tornado.web.Application 之 -settings

Configuración de la aplicación

class  （handlers ： List [Union [Rule ，Tuple]] = None ，default_host ： str = None ，转换 ： List [Type [OutputTransform]] = None ，** settings  ）tornado.web.Application

settings

Los otros argumentos de palabras clave pasados ​​al constructor se guardan en un diccionario, que a menudo se denomina "configuración de la aplicación" en el documento. La configuración se usa para personalizar varios aspectos del tornado (aunque en algunos casos, puede hacer personalizaciones más ricas anulando los métodos en las subclases ). Algunas aplicaciones también prefieren usar diccionarios como una forma de permitir que los manejadores usen configuraciones específicas de la aplicación sin usar variables globales. Los ajustes utilizados en el tornado son los siguientes.settingsRequestHandlersettings

Configuraciones comunes:

• autoreload: En caso afirmativo True, el proceso del servidor se reiniciará cuando cambie cualquier archivo fuente, como se describe en Modo de depuración y Recarga automática . Esta opción es una nueva característica en Tornado 3.2; anteriormente, esta característica estaba controlada por la debugconfiguración .

• debug: Abreviatura de varias configuraciones de modo de depuración, como se describe en modo de depuración y recarga automática . Ajustedebug=True el equivalente de autoreload=True, compiled_template_cache=False, static_hash_cache=False, serve_traceback=True.

• default_handler_classY default_handler_args: si no se encuentra otra coincidencia, se usará este controlador; úselo para implementar una página 404 personalizada (nuevo en Tornado 3.2).

• compress_response: Si es así True, la respuesta del formato de texto se comprimirá automáticamente. Nuevas características de Tornado 4.0.

• gzip: Alias ​​no recomendado compress_responsedesde Tornado 4.0 .

• log_function: Esta función se llamará al final de cada solicitud para registrar el resultado (con un parámetro, el objeto). La implementación predeterminada escribirá en la grabadora raíz del módulo. También se puede personalizar sobrescribiendo .RequestHandlerloggingApplication.log_request

• serve_traceback: En caso afirmativo True, la página de error predeterminada contendrá el rastreo de error. Esta opción es una nueva característica en Tornado 3.2; anteriormente, esta característica estaba controlada por la debugconfiguración .

• ui_modulesY ui_methods: se puede establecer como un método de interfaz de usuario de plantilla o asignación de método de interfaz de usuario . Se puede establecer en módulo, diccionario o módulo y / o lista de diccionarios. Para más detalles, consulte el módulo de la interfaz de usuario .UIModule

• websocket_ping_interval: Si se establece en un número, todos los sockets de red harán ping cada n segundos. Esto puede ayudar a mantener activa la conexión al cerrar algunos servidores proxy para conexiones inactivas, y puede detectar si el websocket ha fallado y no se cerró correctamente.

• websocket_ping_timeout: Si se establece el intervalo de ping y el servidor no recibe "pong" en este segundo, cerrará el websocket. El valor predeterminado es tres veces el intervalo de ping, al menos 30 segundos. Si no se establece el intervalo de ping, se ignora.

Autenticación y configuración de seguridad:

• cookie_secret: Utilizado por  y para firmar cookies.RequestHandler.get_secure_cookieset_secure_cookie

• key_version:  Cuando el  diccionario de claves es un diccionario de claves , requestHandler se  utiliza para firmar cookies con una clave específica .set_secure_cookiecookie_secret

• login_url: Si el usuario no ha iniciado sesión, el decorador redirigirá a esa URL. Se puede personalizar aún más reescribiendoauthenticatedRequestHandler.get_login_url

• xsrf_cookies: En caso afirmativo True, se habilitará la protección de falsificación de solicitudes entre sitios .

• xsrf_cookie_version: Controle la versión de la nueva cookie XSRF generada por este servidor. En general, debe dejarse en su valor predeterminado (siempre será la versión más alta admitida), pero se puede configurar temporalmente en un valor más bajo durante la transición de la versión. Nuevo en Tornado 3.2.2, presenta la versión 2 de la cookie XSRF.

• xsrf_cookie_kwargs: Se puede configurar  como un diccionario que la cookie XSRF  pasa a otros parámetros .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: Como se usa  módulo para comprobar los diferentes API.tornado.auth

Configuraciones de plantilla:

• autoescape: Controla el escape automático de plantillas. Se puede configurar para Nonedesactivar el escape, o se establece en  función de todos a través de la salida debe ser el nombre . El valor por defecto es "xhtml_escape". Puede usar instrucciones para realizar cambios por plantilla .{% autoescape %}

• compiled_template_cache: El valor predeterminado es True;  si se False debe volver a compilar la plantilla de acuerdo con cada solicitud. Esta opción es una nueva característica en Tornado 3.2; anteriormente, esta característica estaba controlada por la debugconfiguración .

• template_path: Directorio que contiene archivos de plantilla. Se puede personalizar aún más cubriendoRequestHandler.get_template_path

• template_loader: La instancia asignada  se carga con una plantilla personalizada. Si se utiliza esta  configuración, se ignorarán las configuraciones y . Se puede personalizar aún más sobrescribiendo .tornado.template.BaseLoadertemplate_pathautoescapeRequestHandler.create_template_loader

• template_whitespace: Controla el manejo de espacios en la plantilla; consulte los valores permitidos. Nuevas características de Tornado 4.3.tornado.template.filter_whitespace

Configuración de archivo estático:

• static_hash_cache: El valor predeterminado es True;  si False la URL estática se volverá a calcular en cada solicitud. Esta opción es una nueva característica en Tornado 3.2; anteriormente, esta característica estaba controlada por la debugconfiguración .

• static_path: Se proporcionará un directorio de archivos estáticos.

• static_url_prefix: Prefijo URL de archivos estáticos, el valor predeterminado es "/static/".

• static_handler_class, static_handler_args: Se puede configurar para usar otros controladores para archivos estáticos en lugar de usar el controlador predeterminado  . (Si se establece), debe ser un diccionario de argumentos de palabras clave que se pasará al método del controlador .tornado.web.StaticFileHandlerstatic_handler_argsinitialize