webserver

func WithIdleTimeout ¶

func WithIdleTimeout(d time.Duration) Option

func WithMetadata ¶

func WithMetadata(md map[string]string) Option

func WithMiddleware ¶

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

WithMiddleware 添加 HTTP 中间件

func WithReadTimeout ¶

func WithReadTimeout(d time.Duration) Option

func WithRegionInfo ¶ added in v0.8.0

func WithRegionInfo(region, zone, campus string) Option

WithRegionInfo 设置地域信息（region/zone/campus），与 grpcserver.WithRegionInfo 对齐。 用于 LocalityRouter 地域亲和路由和 LabelFilter 标签过滤。

func WithServiceName ¶

func WithServiceName(name string) Option

func WithShutdownTimeout ¶

func WithShutdownTimeout(d time.Duration) Option

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

func WithTLS ¶

func WithTLS(certFile, keyFile string) Option

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

func WithTLSConfig ¶

func WithTLSConfig(cfg *tls.Config) Option

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

func WithVersion ¶

func WithVersion(version string) Option

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

func WithWriteTimeout ¶

func WithWriteTimeout(d time.Duration) Option

func New ¶

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