bokeh.application.handlers.function

提供一个Bokeh应用程序处理程序，通过运行指定的Python函数来构建文档。

Bokeh服务器命令行工具不使用此处理程序，但如果用户希望以编程方式嵌入Bokeh服务器，则通常很有用：

def make_doc(doc):

    # do work to modify the document, add plots, widgets, etc.

    return doc

app = Application(FunctionHandler(make_doc))

server = Server({'/bkapp': app}, io_loop=IOLoop.current())

server.start()

有关此技术的完整示例，请参见 examples/howto/server_embed

class FunctionHandler(func, *, trap_exceptions=False)

一个处理程序，它接受一个纯python函数来修改Bokeh文档。

例如，下面的代码使用一个函数配置处理程序，该函数可向文档添加空绘图：

def add_empty_plot(doc):
    p = figure(x_range=(0,10), y_range=(0, 10))
    doc.add_root(p)
    return doc

handler = FunctionHandler(add_empty_plot)

可以在应用程序上配置此处理程序，并且应用程序将在每次创建新会话时运行此函数。

__init__(func, *, trap_exceptions=False)

参数

• func (callable) -- 修改并返回Bokeh文档的函数。函数应具有以下形式：。。code block:：python def func（doc）：#修改单据返回单据，修改到位后返回传入单据。

• trap_exceptions (bool) -- 是否应在 func 被捕获和记录或允许传播

modify_document(doc)

执行配置的 func 修改文档。

第一次执行此方法后， safe_to_fork 将返回 False .

property safe_to_fork

Bokeh服务器是否仍能安全地分配新员工。

False 如果 modify_doc 已被呼叫。