webserver

package

v0.7.2 Latest Latest Go to latest Published: Aug 10, 2026 License: Apache-2.0 Imports: 14 Imported by: 0

Details

This section is empty.

This section is empty.

This section is empty.

type Option func(*Server)

func WithIdleTimeout(d time.Duration) Option

func WithMetadata(md map[string]string) Option

func WithMiddleware(middlewares ...func(http.Handler) http.Handler) Option

WithMiddleware 添加 HTTP 中间件

func WithReadTimeout(d time.Duration) Option

func WithServiceName(name string) Option

func WithShutdownTimeout(d time.Duration) Option

WithShutdownTimeout 设置 HTTP 服务优雅关闭的最长等待时间，默认 30s。

func WithTLS(certFile, keyFile string) Option

WithTLS 通过证书文件启用 HTTPS。certFile 和 keyFile 为 PEM 格式文件路径。

func WithTLSConfig(cfg *tls.Config) Option

WithTLSConfig 通过自定义 tls.Config 启用 HTTPS，适合 mTLS 或自定义 CA 场景。

func WithVersion(version string) Option

WithVersion 将服务版本写入 metadata，注册到注册中心后可见，灰度发布时可用于流量路由。

func WithWriteTimeout(d time.Duration) Option

type Server struct {
	*http.Server
	// contains filtered or unexported fields
}

func New(addr string, mux http.Handler, opts ...Option) *Server

func (s *Server) Addr() string

func (s *Server) ID() string

func (s *Server) Kind() string

func (s *Server) Metadata() map[string]string

func (s *Server) Name() string

func (s *Server) Ready() <-chan struct{}

func (s *Server) Start(ctx context.Context) error

func (s *Server) String() string