GO Server.Shutdown用法及代码示例

GO语言"net/http"包中"Server.Shutdown"类型的用法及代码示例。

用法:

func(srv *Server) Shutdown(ctx context.Context) error

Shutdown 优雅地关闭服务器而不中断任何活动连接。关闭首先关闭所有打开的侦听器，然后关闭所有空闲连接，然后无限期地等待连接返回空闲状态，然后关闭。如果提供的上下文在关闭完成之前过期，则 Shutdown 返回上下文的错误，否则返回关闭服务器的底层侦听器返回的任何错误。

当调用 Shutdown 时，Serve、ListenAndServe 和 ListenAndServeTLS 立即返回 ErrServerClosed 确保程序不退出并等待 Shutdown 返回。

Shutdown 不会尝试关闭也不会等待被劫持的连接，例如 WebSockets 如果需要，Shutdown 的调用者应单独通知此类 long-lived 连接关闭并等待它们关闭。有关注册关闭通知函数的方法，请参见RegisterOnShutdown。

一旦在服务器上调用了 Shutdown，它就不能被重用；未来对诸如 Serve 等方法的调用将返回 ErrServerClosed

例子：

package main

import (
    "context"
    "log"
    "net/http"
    "os"
    "os/signal"
)

func main() {
    var srv http.Server

    idleConnsClosed := make(chan struct{})
    go func() {
        sigint := make(chan os.Signal, 1)
        signal.Notify(sigint, os.Interrupt)
        <-sigint

        // We received an interrupt signal, shut down.
        if err := srv.Shutdown(context.Background()); err != nil {
            // Error from closing listeners, or context timeout:
            log.Printf("HTTP server Shutdown: %v", err)
        }
        close(idleConnsClosed)
    }()

    if err := srv.ListenAndServe(); err != http.ErrServerClosed {
        // Error starting or closing listener:
        log.Fatalf("HTTP server ListenAndServe: %v", err)
    }

    <-idleConnsClosed
}

相关用法

注：本文由纯净天空筛选整理自golang.google.cn大神的英文原创作品 Server.Shutdown。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。