Server Plugin

默认页眉

所需依赖项：io.ktor:ktor-server-default-headers

原生服务器

Ktor 支持 Kotlin/Native，允许您在没有额外运行时或虚拟机的情况下运行服务器。

支持：✅

DefaultHeaders 插件会在每个响应中添加标准的 Server 和 Date 页眉。此外，您可以提供额外的默认页眉并重写 Server 页眉。

添加依赖项

要使用 DefaultHeaders，您需要在构建脚本中包含 ktor-server-default-headers 构件：

Gradle (Kotlin)Gradle (Groovy)Maven

安装 DefaultHeaders

要将 DefaultHeaders 插件安装到应用程序，请将其传递给指定

模块

模块允许您通过对路由进行分组来构建应用程序。

中的 install 函数。 下面的代码片段展示了如何安装 DefaultHeaders ……

• ……在 embeddedServer 函数调用中。
• ……在显式定义的 module 中，它是 Application 类的扩展函数。

embeddedServermodule

DefaultHeaders 插件也可以安装到特定路由。 如果您需要为不同的应用程序资源使用不同的 DefaultHeaders 配置，这可能会很有用。

配置 DefaultHeaders

添加额外页眉

要自定义默认页眉列表，请通过使用 header(name, value) 函数将所需的页眉传递给 install。name 参数接受 HttpHeaders 值，例如：

    install(DefaultHeaders) {
        header(HttpHeaders.ETag, "7c876b7e")
    }

要添加自定义页眉，请将其名称作为字符串值传递：

    install(DefaultHeaders) {
        header("Custom-Header", "Some value")
    }

重写页眉

要重写 Server 页眉，请使用相应的 HttpHeaders 值：

    install(DefaultHeaders) {
        header(HttpHeaders.Server, "Custom")
    }

请注意，出于性能原因，Date 页眉会被缓存，无法使用 DefaultHeaders 进行重写。