server

package
v3.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 2, 2026 License: Apache-2.0 Imports: 24 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

View Source
var ServerContextKey = &contextKey{"Server"}
View Source
var Version = "Server/v3"

Functions

This section is empty.

Types

type Group

type Group struct {
	ErrorLog *log.Logger                                      // 错误日志文件
	Module   func(name string) (vweb.DynamicTemplater, error) // 支持更动态文件类型

	CertManager *autocert.Manager // 自动申请证书 Let's Encrypt
	// contains filtered or unexported fields
}

func NewGroup

func NewGroup() *Group

func (*Group) Close

func (T *Group) Close() error

Close 关闭服务集群。 并发安全:通过 atomic run 标志防止重复关闭。 依次关闭所有 Server(调用完整 Close 以释放 listener 与 status)、 清理站点池与站点管理器,最后通知 Start 退出阻塞。 优化:整个清理过程在 configMu 下执行,避免与 UpdateConfig/LoadConfigFile 交错。

func (*Group) GetServer

func (T *Group) GetServer(laddr string) (*Server, bool)

GetServer 读取一个服务器

laddr string	监听地址
*Server			服务器
bool			如果存在服务器, 返回true。否则返回false

func (*Group) LoadConfigFile

func (T *Group) LoadConfigFile(p string) (ok bool, err error)

LoadConfigFile 挂载本地配置文件。

p string        文件路径
ok bool			true配置文件被修改过, false没有变动
err error       错误

func (*Group) SetServer

func (T *Group) SetServer(laddr string, srv *Server) error

func (*Group) SetSessionExpiryInterval

func (T *Group) SetSessionExpiryInterval(d time.Duration)

SetSessionExpiryInterval 设置session的过期时间, 随配置文件变动, d 原来的保存内容可能会被删除或增加。

func (*Group) SiteMan

func (T *Group) SiteMan() *vweb.SiteMan

SiteMan 站点管理器, 用于获取和设置站点信息。

func (*Group) Start

func (T *Group) Start() error

Start 启动服务集群。 通过 atomic run 标志保证只启动一次。 若已有配置则立即应用(更新站点与监听),然后阻塞等待退出信号。 优化:支持“Close 后再次 Start”(重建 exit 通道),并改用 close(exit) 通知, 消除“Close 在 Start 之前调用导致 Start 永久阻塞”的死锁隐患。

func (*Group) UpdateConfig

func (T *Group) UpdateConfig(conf *config.Config) error

UpdateConfig 更新配置并把配置分配到各个地方。不检查改动, 直接更新。更新配置需要调用 .Start 方法之后才生效。

conf *config.Config        配置
error               错误

type Server

type Server struct {
	*http.Server // http服务器
	Addr         string
	// contains filtered or unexported fields
}

Server 封装 http.Server,支持自定义 TCP 选项、TLS 与并发安全状态。

func (*Server) Close added in v3.1.0

func (T *Server) Close() error

Close 立即关闭服务器与底层 Listener(不等待进行中连接完成)。 先关闭 http.Server(触发 doneChan,令阻塞的 Serve 返回 http.ErrServerClosed), 再关闭自定义 listener(幂等),避免 Serve 以 net.ErrClosed 意外退出而误报错误。

func (*Server) ConfigConn

func (T *Server) ConfigConn(cc *config.Conn) error

ConfigConn 配置连接级 TCP 选项(KeepAlive、NoDelay、缓冲区、Deadline 等)。 必须在 Serve / ListenAndServe 之前调用。 选项会在每次 Accept 后、TLS 包装前应用到 *net.TCPConn。 运行期间禁止修改,防止与 Accept 并发产生数据竞争。

func (*Server) ConfigServer

func (T *Server) ConfigServer(cs *config.Server) error

ConfigServer 配置服务器参数(超时、TLS、KeepAlive 等)。 必须在 Serve / ListenAndServe 之前调用。 TLS 配置会同时写入 http.Server.TLSConfig 与自定义 listener.tlsconfig, 由 listener.Accept 完成 TLS 握手包装(支持非标准 TLS Listener 场景)。

func (*Server) IsRunning added in v3.1.0

func (T *Server) IsRunning() bool

IsRunning 返回服务器当前是否处于服务状态(并发安全)。

func (*Server) ListenAndServe

func (T *Server) ListenAndServe() error

ListenAndServe 在 T.Addr 上监听并服务。 若 Addr 为空,默认使用 ":http"。 内部调用 net.Listen("tcp", ...) 后转交 Serve,因此同样受 status CAS 保护。

func (*Server) Serve

func (T *Server) Serve(l net.Listener) error

Serve 启动服务。状态由 atomic CAS 保护,可被多 goroutine 安全调用。 兼容 *net.TCPListener 以及提供 TCPListener() 方法的包装监听器。

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL