bokeh.application.handlers.handler

为Bokeh应用程序处理程序类提供基类。

启动Bokeh服务器会话时，Bokeh服务器请求应用程序提供新文档来为会话提供服务。为此，应用程序首先创建一个新的空文档，然后将此新文档传递给 modify_document 方法。当所有处理程序都更新了文档后，它将用于为用户会话提供服务。

下面是一个自定义处理程序的示例大纲，该处理程序可以根据某些数据库中的信息修改文档：

class DatabaseHandler(Handler):
    """ A Bokeh Application handler to initialize Documents from a database

    """

    def modify_document(self, doc):

        # do some data base lookup here to generate 'plot'

        # add the plot to the document (i.e modify the document)
        doc.add_root(plot)

        # and return it
        return doc

class Handler(*args, **kwargs)

为Bokeh应用程序提供一种机制来构建新的Bokeh文档。

modify_document(doc)

以指定方式修改申请文件。

启动Bokeh服务器会话时，Bokeh服务器请求应用程序提供新文档来为会话提供服务。为此，应用程序首先创建一个新的空文档，然后将此文档传递给 modify_document 方法。当所有处理程序都更新了文档后，它将用于为用户会话提供服务。

子类必须实现此方法

参数

doc (Document) -- 要更新的Bokeh文档

返回

文件

on_server_loaded(server_context)

第一次启动服务器时执行代码。

子类可以实现此方法，以提供在服务器启动后，但在创建任何会话之前所需的任何一次性初始化。

参数

server_context (ServerContext) --

on_server_unloaded(server_context)

当服务器完全退出时执行代码。（在停止服务器的 IOLoop ）

子类可以实现此方法，以便在服务器退出之前提供任何必需的一次性删除。

参数

server_context (ServerContext) --

警告

实际上，这段代码可能无法运行，因为服务器通常会被信号杀死。

async on_session_created(session_context)

创建新会话时执行代码。

子类可以实现此方法来提供之前所需的每个会话初始化 modify_doc 被要求参加会议。

参数

session_context (SessionContext) --

async on_session_destroyed(session_context)

在会话被破坏时执行代码。

子类可以实现此方法，以便在会话被销毁时为每个会话提供必要的销毁。

参数

session_context (SessionContext) --

process_request(request)

处理传入的HTTP请求，返回要添加到会话上下文的附加数据字典。

参数

request -- HTTP请求

返回

要包含在会话上下文中的JSON可序列化数据的字典。

static_path()

返回应用程序特定静态资源的路径（如果适用）。

url_path()

返回默认的URL路径（如果适用）。

Handlers子类可以选择性地实现这个方法，以通知Bokeh应用程序应该安装在哪个URL。

如果多个处理程序指定 url_path 应用程序将使用其处理程序列表中第一个处理程序中的值。

property error

如果处理程序失败，则可能包含相关的错误消息。

property error_detail

如果处理程序失败，则可能包含回溯或其他详细信息。

property failed

True 如果处理程序修改单据失败