vweb

package module
v3.4.1 Latest Latest
Warning

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

Go to latest
Published: Nov 1, 2026 License: Apache-2.0 Imports: 41 Imported by: 1

README

vweb

一个用 Go 编写的高性能、模块化、可扩展的 Web 服务器框架,内置多站点托管、动态模板执行、插件化 RPC/HTTP 通信、配置热重载、Let's Encrypt 自动证书等能力。


特性

  • 多站点托管:一个进程管理多个站点,按 Host 隔离;支持通配符域名匹配(如 *.example.com)。
  • 多监听地址:通过配置即可同时启动任意数量的 IP:Port 监听;服务器连接参数与 TLS 可独立配置。
  • 动态模板执行:支持 Yaegi(Go 解释器)、Ixgo/Igop、Wazero(WASM)等动态引擎;同一站点可按文件后缀路由到不同引擎。
  • 路由能力:
    • 精确匹配(O(1))
    • 正则匹配(以 ^、$ 界定)
    • 通配符匹配([]*?\)
    • 占位符匹配(如 /user/{id}、b{id}b)
  • 反向代理 / URL 重写:规则在配置加载阶段预编译;支持重定向、排除路径、连续匹配。
  • 插件系统:
    • PluginRPC:基于 net/rpc + gob 的 RPC 连接池
    • PluginHTTP:基于 http.Transport 的反向代理
  • 会话管理:可配置名称、ID 长度、过期时间、加盐;支持 Defer 退出回调与哈希失效。
  • 全局缓存与会话:基于 vmap,支持键级别过期、过期回调、重置。
  • 静态文件服务:支持 GET/HEAD、Range(单/多区间、后缀区间)、ETag、If-None-Match、If-Range、Cache-Control 等。
  • HTTPS 支持:
    • 手动加载证书(PEM/DER/CRT)
    • Let's Encrypt autocert 自动申请与缓存
    • 白名单 host.txt 动态热重载
  • 配置热重载:config.json / config.toml 变更后自动重载并重建站点、服务器与插件。
  • 优雅关闭:服务组 Close、站点池 Close、动态模板 Close 全部保证清理与 Defer 执行。
  • 健壮性:并发安全、反射越界防护、路径穿越防护、WASM 头探测、临时文件原子提交等。
  • 内置解释器:builtin 包提供动态模板可用的 Get/Set/Make/Compute/Len/Append/Copy/Convert/Init/CopyStruct 等函数,兼顾安全与性能。

快速开始

编译
git clone https://github.com/456vv/vweb.git
cd vweb
go build -o vweb ./cmd/main

需要 Go 1.22+(依赖 reflect.TypeFor、for range int、maps.Copy 等特性)。

运行
./vweb -RootDir=/opt/vweb -ConfigFile=config.json -LogFile=error.log

启动参数

参数 默认值 说明
-RootDir 程序所在目录 程序根目录(会 chdir)
-ConfigFile config.json 主配置文件路径
-LogFile error.log 日志文件
-CertCache ssl/auto Let's Encrypt 证书缓存目录
-AllowCertHost ssl/auto/host.txt 自动申请证书的域名白名单

注意:不带任何 flag 时会打印帮助后退出(flag.NFlag() == 0)。


项目结构

vweb/
├── builtin/              # 动态模板内置函数库(Get/Set/Compute/Make/Convert…)
├── cmd/main/             # 可执行入口
│   ├── internal/
│   │   ├── base/         # 信号处理(跨平台)
│   │   └── dynamic/      # 动态引擎注册表(Yaegi/Ixgo/Wazero)
│   ├── func.go           # 自动证书白名单加载
│   └── main.go           # 主入口
├── plugin/               # 独立 RPC/HTTP 插件服务器
├── server/               # 服务组、监听器、配置解析
│   ├── config/           # 配置文件结构 & 合并逻辑
│   ├── Server.go         # http.Server 封装
│   ├── listener.go       # TCP/KeepAlive/TLS 监听器
│   ├── plugin.go         # 插件客户端管理
│   └── func.go           # 通配符域名、请求头处理
├── PluginRPC.go          # RPC 插件客户端
├── pluginHTTP.go         # HTTP 插件客户端
├── dot.go                # Dot 上下文(模板点)
├── route.go              # 路由系统
├── rewrite.go            # URL 重写
├── response.go           # Response 封装
├── serverHandlerDynamic.go # 动态模板处理
├── serverHandlerStatic.go  # 静态文件处理
├── sessions.go           # 会话管理
├── Session.go            # 单个会话
├── Site.go               # 站点与站点池
├── cookie.go             # Cookie 工具
├── defer.go              # 延迟调用
├── func.go               # 工具函数(随机 ID、域名匹配等)
├── reflect.go            # 反射调试输出
└── vweb.go               # 包常量与上下文 key

配置文件

主配置 config.json
{
  "Servers": {
    "Public": {
      "CC": {
        "default": {
          "KeepAlive": true,
          "KeepAlivePeriod": 180000,
          "NoDelay": true
        }
      },
      "CS": {
        "default": {
          "ReadTimeout": 15000,
          "WriteTimeout": 60000,
          "IdleTimeout": 60000,
          "KeepAlivesEnabled": true,
          "ShutdownConn": true
        }
      }
    },
    "Listen": {
      ":8080": {
        "Status": true,
        "CC": { "PublicName": "default" },
        "CS": { "PublicName": "default" }
      },
      ":8443": {
        "Status": true,
        "CC": { "PublicName": "default" },
        "CS": {
          "PublicName": "default",
          "TLS": {
            "RootCAs": [
              { "CertFile": "ssl/server.crt", "KeyFile": "ssl/server.key" }
            ],
            "MinVersion": 771,
            "NextProtos": ["h2", "http/1.1"]
          }
        }
      }
    }
  },
  "Sites": {
    "Public": {
      "Session": {
        "default": { "Name": "SID", "Size": 64, "Expired": 1200 }
      },
      "Header": {
        "default": {
          "MIME": { ".wasm": "application/wasm" },
          "Static": {
            ".*": { "PageExpired": 3600 }
          }
        }
      }
    },
    "Site": [
      {
        "Status": true,
        "Name": "示例站点",
        "Identity": "example",
        "Host": ["example.com", "*.example.com"],
        "IndexFile": ["index.html", "index.go"],
        "Directory": {
          "Root": "/srv/web/example",
          "Virtual": ["/static/"]
        },
        "Session": { "PublicName": "default" },
        "Header":  { "PublicName": "default" },
        "Dynamic": {
          "Ext": [".go"],
          "Cache": true,
          "CacheParseTimeout": 300
        },
        "Forward": {
          "example.com": {
            "List": [
              {
                "Status": true,
                "Path": ["^/api/(.*)$"],
                "RePath": "/gateway/$1",
                "End": true
              }
            ]
          }
        },
        "Plugin": {
          "HTTP": {
            "gw": {
              "Status": true,
              "Addr": "127.0.0.1:9000",
              "Scheme": "http",
              "Timeout": 3000
            }
          }
        },
        "ErrorPage": {
          "404": "404.html",
          "500": "500.html"
        }
      }
    ]
  }
}
子配置文件

主配置所在目录下的以下文件会被自动加载并合并:

  • *.site.json / *.site.toml:按 Identity 合并站点列表(同名替换、异名追加)
  • *.listen.json / *.listen.toml:合并监听地址

TOML 示例:

[[Site]]
Status = true
Name = "示例站点"
Identity = "example"
Host = ["example.com"]
IndexFile = ["index.html"]

[Site.Directory]
Root = "/srv/web/example"

路由

route := new(vweb.Route)

// 精确匹配
route.HandleFunc("/health", func(w http.ResponseWriter, r *http.Request) {
    w.Write([]byte("ok"))
})

// 正则匹配
route.HandleFunc(`^/api/v\d+/`, func(w http.ResponseWriter, r *http.Request) { /* ... */ })

// 通配符匹配
route.HandleFunc("/static/*", func(w http.ResponseWriter, r *http.Request) { /* ... */ })

// 占位符匹配
route.HandleFuncDot("/user/{id}", func(d vweb.Doter) {
    params, _ := d.Context().Value("url-params").(map[string]string)
    d.Response().WriteString("id=" + params["id"])
})

占位符规则:

  • {name} 提取任意非空值
  • b{id}b 支持前后缀
  • 不允许相邻占位符 {a}{b}

插件系统

RPC 插件(PluginRPC)
c := &vweb.PluginRPCClient{
    ConnPool: vconnpool.NewPool(),
    Addr:     "127.0.0.1:9001",
    Path:     "/_rpc",
}
rpc, err := c.Connection()
if err != nil { /* ... */ }
defer rpc.Discard()

var reply string
err = rpc.Call("Example.Hello", "world", &reply)

服务端可使用 plugin.NewServerRPC():

srv := plugin.NewServerRPC()
srv.RegisterName("Example", new(ExampleService))
srv.HandleHTTP("/_rpc", "/_rpc/debug")
srv.Addr = ":9001"
srv.ListenAndServe()
HTTP 插件(PluginHTTP)
c := &vweb.PluginHTTPClient{
    Tr:     &http.Transport{},
    Addr:   "127.0.0.1:9000",
    Scheme: "http",
    Host:   "backend",
}
p, _ := c.Connection()
// p 直接实现 http.Handler
http.ListenAndServe(":8080", p)

动态模板

ServerHandlerDynamic 依据文件第一行(注释)或 WASM 文件头选择动态引擎:

  • 首行 // yaegi → Yaegi
  • 首行 // igop / // ixgo → Ixgo
  • 首行 // wasm-01000000 或 WASM 二进制(\0asm)→ Wazero

一个动态文件示例:

// yaegi
package main

import "github.com/456vv/vweb/v3"

func Main(d vweb.Doter) {
    d.Response().WriteString("Hello, " + d.Request().URL.Path)
}

请求路径会映射为执行入口函数名(index.go → Main,about.go → About)。


会话与缓存

// 在 Dot 中访问
s := d.Session()      // Sessioner
s.Set("uid", 42)
uid := s.Get("uid")

g := d.Global()       // Globaler
g.SetExpiredCall("token", 5*time.Minute, func(v any) {
    log.Println("token expired:", v)
})

会话 ID 的生成、加盐、Cookie 写入、过期扫描由 Sessions 统一处理;InstantDeadAll 会遍历并清理全部会话并执行 Defer。


自动证书(Let's Encrypt)

cmd/main 内置 autocert.Manager:

  • 证书缓存到 -CertCache 目录
  • 域名白名单由 -AllowCertHost 文件控制(每行一个域名,# 注释)
  • 文件变更后自动重载
  • 白名单为空时 默认拒绝 一切自动申请(HostPolicy 返回错误)

优雅关闭

group := server.NewGroup()
// ...
base.StartSigHandlers()

go func() {
    <-base.Interrupted
    group.Close()
}()

Group.Close 会:

  1. 停止所有监听(ShutdownConn=true 时优雅关闭,否则立即关闭)
  2. 清理 srvMan 中的服务器
  3. 清理全部站点、插件、动态模板缓存、会话、全局数据
  4. 关闭 sitePool(最多等待 3 秒让 Defer 完成)

贡献

欢迎通过 GitHub Issue / Pull Request 反馈问题或贡献代码。提交前请确保:

  • go build ./... 与 go vet ./... 通过
  • 关键路径覆盖测试(尤其是并发与生命周期)
  • 配置/协议变更请同步更新文档与示例

许可

本项目基于仓库中 LICENSE 文件所示的许可证发布。若未附带 LICENSE 文件,请在使用前联系作者确认授权条款。

部分源自 Go 标准库的代码(如 cmd/main/internal/base/signal*.go)保留其 BSD 风格版权声明。


致谢

感谢所有依赖项目作者与贡献者的开源工作。

Documentation

Index

Constants

This section is empty.

Variables

View Source
var (
	SiteContextKey     = &contextKey{"web-site"}
	RouterContextKey   = &contextKey{"web-router"}
	ListenerContextKey = &contextKey{"web-listener"}
	ConnContextKey     = &contextKey{"web-conn"}
	PluginContextKey   = &contextKey{"web-plugin"}
)

上下文中使用的key

Functions

func AddSalt

func AddSalt(rnd []byte, salt string) string

AddSalt 加盐

rnd []byte	标识字节串
salt string	盐
string  	标识符

func AutoCert

func AutoCert(ac *autocert.Manager, tlsconf *tls.Config, handler http.Handler) http.Handler

AutoCert 自动从 Let's Encrypt 申请证书

ac *autocert.Manager	申请证书管理
tlsconf *tls.Config		tls配置
handler http.Handler	http处理

func ExecFunc

func ExecFunc(f any, args ...any) ([]any, error)

ExecFunc 执行函数调用

call any            函数
args ... any        参数或更多个函数是函数的参数
[]any				返回直
error                       错误

func ForMethod

func ForMethod(x any) string

ForMethod 遍历并返回方法信息

func ForType

func ForType(x any, showUnexported bool, maxDepth int) string

ForType 遍历字段 x: 目标对象 showUnexported: 是否展示小写(未导出)字段 maxDepth: 最大递归深度

func GenerateRandom

func GenerateRandom(length int) ([]byte, error)

GenerateRandom 生成标识符

length int	长度
[]byte  	生成的标识符
err error	错误

func GenerateRandomID

func GenerateRandomID(rnd []byte) error

GenerateRandomID 生成标识符

[]byte  	生成的标识符
err error	错误

func GenerateRandomString

func GenerateRandomString(length int) (string, error)

GenerateRandomString 生成标识符

length int	长度
string  	生成的标识符
err error	错误

func PagePath

func PagePath(root, p string, index []string) (os.FileInfo, string, error)

PagePath 页路径

root string		    根目录
p string            路径
index []string      索引文件名
os.FileInfo         文件信息
string          	路径
error				错误,如果文件不存在

Types

type Cookie struct {
	R *http.Request       // 请求
	W http.ResponseWriter // 响应
}

func (*Cookie) Add

func (c *Cookie) Add(name, value, path, domain string, maxAge int, secure, only bool, sameSite http.SameSite)

Add 增加,写入一条Cookie,可以写入多条Cookie保存至浏览器

func (*Cookie) Del

func (c *Cookie) Del(name string)

Del 删除,删除指定的Cookie

name string            名称

func (*Cookie) Get

func (c *Cookie) Get(name string) string

Get 读取Cookie,如果不存在返回空字符

name string     指定名称读取的Cookie
string          返回值

func (*Cookie) ReadAll

func (c *Cookie) ReadAll() map[string]string

ReadAll 读出所有Cookie

map[string]string        读取出所有Cookie

func (*Cookie) RemoveAll

func (c *Cookie) RemoveAll()

RemoveAll 移除所有Cookie

type Cookier

type Cookier interface {
	ReadAll() map[string]string                                                                  // 读取所有
	RemoveAll()                                                                                  // 删除所用
	Get(name string) string                                                                      // 读取
	Add(name, value, path, domain string, maxAge int, secure, only bool, sameSite http.SameSite) // 增加
	Del(name string)                                                                             // 删除
}

type Dot

type Dot struct {
	R *http.Request       // 请求
	W http.ResponseWriter // 响应

	Site *Site // 网站配置
	// contains filtered or unexported fields
}

Dot 模板点

func (*Dot) Close

func (T *Dot) Close() error

Close 释放

func (*Dot) Context

func (T *Dot) Context() context.Context

Context 上下文

context.Context 上下文

func (*Dot) Cookie

func (T *Dot) Cookie() Cookier

Cookie 用户的Cookie

Cookier	接口

func (*Dot) Defer

func (T *Dot) Defer(call any, args ...any) error

Defer 在用户会话时间过期后,将被调用。

	call any            函数
	args ... any        参数或更多个函数是函数的参数
	error                       错误
 例:
	.Defer(fmt.Println, "1", "2")
	.Defer(fmt.Printf, "%s", "汉字")

func (*Dot) Global

func (T *Dot) Global() Globaler

Global 全站缓存

Globaler	公共缓存

func (*Dot) Header

func (T *Dot) Header() http.Header

Header 标头

http.Header   响应标头

func (*Dot) Request

func (T *Dot) Request() *http.Request

Request 用户的请求信息

*http.Request 请求

func (*Dot) RequestLimitSize

func (T *Dot) RequestLimitSize(l int64) *http.Request

RequestLimitSize 请求限制大小

l int64         复制body大小
*http.Request   请求

func (*Dot) Response

func (T *Dot) Response() Responser

Response 数据写入响应

Responser     响应

func (*Dot) RootDir

func (T *Dot) RootDir(upath string) string

RootDir 网站的根目录

upath string	页面路径
string 			根目录

func (*Dot) SaveStatic

func (T *Dot) SaveStatic(path string) (wr io.WriteCloser, err error)

SaveStatic 保存为静态文件

func (*Dot) Session

func (T *Dot) Session() Sessioner

Session 用户的会话缓存

Sessioner  会话缓存

func (*Dot) Swap

func (T *Dot) Swap() *vmap.Map

Swap 信息交换

Swaper  映射

func (*Dot) WithContext

func (T *Dot) WithContext(ctx context.Context)

WithContext 替换上下文

ctx context.Context 上下文

type DotContexter

type DotContexter interface {
	Context() context.Context        // 上下文
	WithContext(ctx context.Context) // 替换上下文
}

type Doter

type Doter interface {
	RootDir(path string) string                            // 网站的根目录
	Request() *http.Request                                // 用户的请求信息
	RequestLimitSize(l int64) *http.Request                // 请求限制大小
	Header() http.Header                                   // 标头
	Response() Responser                                   // 数据写入响应
	Session() Sessioner                                    // 用户的会话缓存
	Global() Globaler                                      // 全站缓存
	Cookie() Cookier                                       // 用户的Cookie
	Swap() *vmap.Map                                       // 信息交换
	Defer(call any, args ...any) error                     // 退回调用
	SaveStatic(path string) (wr io.WriteCloser, err error) // 保存为静态文件
	DotContexter                                           // 上下文
}

Doter 可以在模本中使用的方法

type DynamicTemplateFunc

type DynamicTemplateFunc func(*ServerHandlerDynamic) DynamicTemplater

DynamicTemplateFunc 声明动态模板获取函数类型

type DynamicTemplater

type DynamicTemplater interface {
	SetPath(root string, page string)
	Parse(r io.Reader) (err error)                        // 解析模板内容
	Execute(name string, out io.Writer, dot ...any) error // 执行模板并输出
	Close() error                                         // 释放相关资源
}

DynamicTemplater 动态模板接口规范

type ExecCall

type ExecCall struct {
	// contains filtered or unexported fields
}

ExecCall 执行函数包装器

func (*ExecCall) Exec

func (T *ExecCall) Exec() []any

Exec 执行函数

func (*ExecCall) Func

func (T *ExecCall) Func(call any, args ...any) error

Func 初始化函数和参数

type ExitCall

type ExitCall struct {
	// contains filtered or unexported fields
}

ExitCall 任务管理

func (*ExitCall) Defer

func (T *ExitCall) Defer(call any, args ...any) error

func (*ExitCall) Free

func (T *ExitCall) Free()

type Forward

type Forward struct {
	Path        []string // 多种路径匹配
	ExcludePath []string // 排除多种路径匹配
	RePath      string   // 重写路径
}

Forward 原始配置结构

func (*Forward) Compile

func (T *Forward) Compile() (*ForwardRewriter, error)

Compile 预编译正则,建议在程序初始化或配置加载时调用一次。 返回的 *ForwardRewriter 可被多 goroutine 并发安全地调用 Rewrite。

type ForwardRewriter

type ForwardRewriter struct {
	// contains filtered or unexported fields
}

ForwardRewriter 编译后的执行对象

func (*ForwardRewriter) Rewrite

func (T *ForwardRewriter) Rewrite(upath string) (string, bool)

Rewrite 对给定路径进行重写。 返回值:(重写后的路径, 是否发生了重写) 方法本身是并发安全的,可在多个 goroutine 中同时调用。

type Globaler

type Globaler interface {
	Set(key, val any)                                     // 设置
	Has(key any) bool                                     // 判断
	Get(key any) any                                      // 读取
	GetHas(key any) (val any, ok bool)                    // 读取判断
	Del(key any)                                          // 删除
	SetExpired(key any, d time.Duration)                  // 过期
	SetExpiredCall(key any, d time.Duration, f func(any)) // 过期调用
	Range(f func(key, value any) bool)                    // 遍历
	GetNewMaps(keys ...any) *vmap.Map                     // 更多
}

type HandleFunc

type HandleFunc []func(Doter)

func (HandleFunc) ServeHTTP

func (T HandleFunc) ServeHTTP(w http.ResponseWriter, r *http.Request)

type PluginHTTP

type PluginHTTP interface {
	Type() PluginType                                           // 类型
	ServeHTTP(w http.ResponseWriter, r *http.Request)           // 服务HTTP
	RoundTrip(r *http.Request) (resp *http.Response, err error) // 代理
	CancelRequest(req *http.Request)                            // 取消HTTP请求
	CloseIdleConnections()                                      // 关闭空闲连接
	RegisterProtocol(scheme string, rt http.RoundTripper)       // 注册新协议
}

PluginHTTP http插件接口

type PluginHTTPClient

type PluginHTTPClient struct {
	Tr     *http.Transport // 客户端
	Addr   string          // 地址
	Scheme string          // 协议(用于默认填充)
	Host   string          // 请求Host(用于默认填充)
	Dialer *net.Dialer
	// contains filtered or unexported fields
}

PluginHTTPClient 插件HTTP客户端

func (*PluginHTTPClient) Connection

func (T *PluginHTTPClient) Connection() (PluginHTTP, error)

Connection 快速连接HTTP

PluginHTTP	插件HTTP
error		错误

type PluginRPC

type PluginRPC interface {
	Type() PluginType                           // 类型
	Register(value any)                         // 注册struct类型
	Call(name string, arg any, reply any) error // 用于返回具体类型
	Discard() error                             // 废弃连接
	Close() error                               // 关闭
}

PluginRPC rpc插件接口

type PluginRPCClient

type PluginRPCClient struct {
	ConnPool *vconnpool.Pool // 连接池
	Addr     string          // 地址
	Path     string          // 路径
}

PluginRPCClient 插件RPC客户端

func (*PluginRPCClient) Connection

func (T *PluginRPCClient) Connection() (PluginRPC, error)

Connection 快速连接RPC

PluginRPC			插件RPC
error				错误

type PluginType

type PluginType int
const (
	PluginTypeRPC PluginType = iota
	PluginTypeHTTP
)

type Pluginer

type Pluginer interface {
	RPC(name string) (PluginRPC, error)
	HTTP(name string) (PluginHTTP, error)
}

type Responser

type Responser interface {
	Write([]byte) (int, error)                        // 写入字节
	WriteString(string) (int, error)                  // 写入字符串
	ReadFrom(io.Reader) (int64, error)                // 读取并写入
	Redirect(string, int)                             // 转向
	WriteHeader(int)                                  // 状态码
	Header() http.Header                              // 标头
	Error(string, int)                                // 错误
	Flush()                                           // 刷新缓冲
	Push(target string, opts *http.PushOptions) error // HTTP/2推送
	Hijack() (net.Conn, *bufio.ReadWriter, error)     // 劫持,能双向互相发送信息
}

type Route

type Route struct {
	HandlerError http.HandlerFunc // 错误访问处理
	// contains filtered or unexported fields
}

func (*Route) HandleFunc

func (T *Route) HandleFunc(url string, handler func(w http.ResponseWriter, r *http.Request))

HandleFunc 绑定处理函数,匹配的网址支持正则,这说明你要严格的检查。

url string                                          网址,支持正则匹配
handler func(w ResponseWriter, r *Request)    		处理函数

func (*Route) HandleFuncDot

func (T *Route) HandleFuncDot(url string, handler ...func(Doter))

func (*Route) ServeHTTP

func (T *Route) ServeHTTP(w http.ResponseWriter, r *http.Request)

ServeHTTP 服务HTTP

w ResponseWriter    响应
r *Request          请求

func (*Route) SetSiteMan

func (T *Route) SetSiteMan(siteMan *SiteMan)

SetSiteMan 设置站点管理,将会携带在请求上下文中 siteMan *SiteMan 站点

type Router added in v3.0.3

type Router interface {
	HandleFunc(url string, handler func(w http.ResponseWriter, r *http.Request))
	HandleFuncDot(url string, handler ...func(Doter))
	ServeHTTP(w http.ResponseWriter, r *http.Request)
}

type ServerHandlerDynamic

type ServerHandlerDynamic struct {
	// RootPath 网站根目录;PagePath 固定使用的页面路径(可选)
	RootPath, PagePath string

	// 可选的配置
	Site   *Site                                       // 网站配置
	Module func(name string) (DynamicTemplater, error) // 根据解析的首行识别动态文件类型对应的解释器

	// 读取文件。仅在 .ServeHTTP 方法中使用,可外接特殊存储介质
	ReadFile func(filePath string, u *url.URL) (io.ReadCloser, time.Time, error)
	// contains filtered or unexported fields
}

ServerHandlerDynamic 处理动态页面文件并作缓存管理

func (*ServerHandlerDynamic) Close added in v3.0.5

func (T *ServerHandlerDynamic) Close() error

Close 关闭整个处理器缓存释放相关持有资源

func (*ServerHandlerDynamic) ServeHTTP

func (T *ServerHandlerDynamic) ServeHTTP(rw http.ResponseWriter, req *http.Request)

ServeHTTP 服务 HTTP 请求

rw http.ResponseWriter    响应写入流
req *http.Request         当前客户端请求

type ServerHandlerStatic

type ServerHandlerStatic struct {
	RootPath, PagePath string
	PageExpired        int64 // 缓存过期时长(单位:秒),0则不缓存
}

ServerHandlerStatic 静态文件服务配置

func (*ServerHandlerStatic) ServeHTTP

func (T *ServerHandlerStatic) ServeHTTP(rw http.ResponseWriter, req *http.Request)

ServeHTTP 实现 http.Handler 接口,处理文件读取与响应 输入: rw - 响应流, req - HTTP请求

type Session

type Session struct {
	vmap.Map // 数据,用户存储的数据
	// contains filtered or unexported fields
}

Session 会话用于用户保存数据

func (*Session) Defer

func (T *Session) Defer(call any, args ...any) error

Defer 在用户会话时间过期后,将被调用。

	call any            函数
	args ... any        参数或更多个函数是函数的参数
	error                       错误
 例:
	.Defer(fmt.Println, "1", "2")
	.Defer(fmt.Printf, "%s", "汉字")

func (*Session) Free

func (T *Session) Free()

Free 执行结束Defer和键值有效期

func (*Session) Token

func (T *Session) Token() string

Token 读取当前的令牌

string	令牌

type Sessioner

type Sessioner interface {
	Token() string                       // 编号
	Set(key, val any)                    // 设置
	Has(key any) bool                    // 判断
	Get(key any) any                     // 读取
	GetHas(key any) (val any, ok bool)   // 读取判断
	Del(key any)                         // 删除
	SetExpired(key any, d time.Duration) // 过期
	Reset()                              // 重置
	Defer(call any, args ...any) error   // 退出调用
	Free()                               // 释放调用
}

Sessioner 用户独立的内存存储接口

type Sessions

type Sessions struct {
	Expired time.Duration // 保存session时间长
	Name    string        // 标识名称。用于Cookie
	Size    int           // 会话ID长度。用于Cookie。(默认64位)
	Salt    string        // 加盐,由于计算机随机数是伪随机数。(可默认为空)。用于Cookie
	// contains filtered or unexported fields
}

Sessions 用于管理不同用户的会话。

注意:Sessions 内部含 sync.WaitGroup 与 vmap.Map,**不可按值复制**。

func (*Sessions) CheckDeadAll

func (T *Sessions) CheckDeadAll() []any

CheckDeadAll 定时来处理过期的Session

func (*Sessions) DelSession

func (T *Sessions) DelSession(id string)

DelSession 使用id删除的会话

id string   id标识符

func (*Sessions) GetSession

func (T *Sessions) GetSession(id string) (Sessioner, bool)

GetSession 使用id读取会话

id string   id标识符
Sessioner   会话
bool        是否存在

func (*Sessions) InstantDeadAll

func (T *Sessions) InstantDeadAll()

InstantDeadAll 立即清理全部会话,并异步执行各自的 Defer。

func (*Sessions) InstantDeadAllInto added in v3.3.0

func (T *Sessions) InstantDeadAllInto(wg *sync.WaitGroup)

InstantDeadAllInto 与 InstantDeadAll 行为一致,并把每个异步 Free 注册到调用方提供的 wg。 wg 不能为 nil(否则与 InstantDeadAll 等价,无必要调用本方法)。

使用约定:

  • 调用方保证 wg 的 Wait 在本方法返回之后才发起;
  • 调用方自行控制超时(本方法不阻塞);
  • 多个 Sessions 可共享同一个 wg(SitePool.Close 正是如此)。

func (*Sessions) Len

func (T *Sessions) Len() int

Len 当前Session数量

int	数量

func (*Sessions) NewSession

func (T *Sessions) NewSession(id string) Sessioner

NewSession 新建会话

func (*Sessions) Session

func (T *Sessions) Session(rw http.ResponseWriter, req *http.Request) Sessioner

Session 会话

func (*Sessions) SessionID

func (T *Sessions) SessionID(req *http.Request) (id string, err error)

SessionID 从请求中读取会话标识

func (*Sessions) SetSession

func (T *Sessions) SetSession(id string, s Sessioner) Sessioner

SetSession 使用id写入新的会话

type Site

type Site struct {
	RootDir func(path string) string // 网站的根目录z
	Extend  vmap.Map                 // 接口类型,可以自己存在任何类型
	// contains filtered or unexported fields
}

Site 站点数据存储

func (*Site) Global

func (T *Site) Global() Globaler

func (*Site) PoolName

func (T *Site) PoolName() string

PoolName 网站池名称

string	名称

func (*Site) Sessions

func (T *Site) Sessions() *Sessions

type SiteMan

type SiteMan struct {
	// contains filtered or unexported fields
}

func (*SiteMan) Add

func (T *SiteMan) Add(host string, site *Site)

Add 设置一个站点

host string		站点host
*Site			站点

func (*SiteMan) Get

func (T *SiteMan) Get(host string) (*Site, bool)

Get 读取一个站点

host string		站点host
*Site			站点
bool			true存在,否则没有

func (*SiteMan) Range

func (T *SiteMan) Range(f func(host string, site *Site) bool)

Range 迭举站点

f func(host string, site *Site) bool

type SitePool

type SitePool struct {
	// contains filtered or unexported fields
}

SitePool 网站池

func NewSitePool

func NewSitePool() *SitePool

func (*SitePool) Close

func (T *SitePool) Close() error

Close 关闭池,关闭前将遍历池中的站点出来清理会话和全局数据。如果已经关闭则返回错误。

func (*SitePool) DelSite

func (T *SitePool) DelSite(name string)

DelSite 删除站点

name string		站点name

func (*SitePool) NewSite

func (T *SitePool) NewSite(name string) *Site

NewSite 创建一个站点,如果存在返回已经存在的。Sessions 使用默认的设置,你需要修改它。

name string		站点name
*Site			站点

func (*SitePool) RangeSite

func (T *SitePool) RangeSite(f func(name string, site *Site) bool)

RangeSite 迭举站点

f func(name string, site *Site) bool

func (*SitePool) SetRecoverSession

func (T *SitePool) SetRecoverSession(d time.Duration)

SetRecoverSession 设置回收无效的会话间隔。默认为1秒

d time.Duration     回收时间隔,不可以等于或小于0,否则CPU爆增(警告)

Directories

Path Synopsis
cmd
main command

Jump to

Keyboard shortcuts

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