server

package

v0.2.0 Latest Latest Go to latest Published: Mar 22, 2026 License: MIT Imports: 11 Imported by: 0

Details

View Source

const (
	SuccessEmptyResponse = "success"
	EchoStr              = "echostr"
)

This section is empty.

This section is empty.

type EchoStrMode int

EchoStrMode echostr验证模式

const (
	// EchoStrPlain 明文直接返回（公众号）
	EchoStrPlain EchoStrMode = iota
	// EchoStrDecrypt 需要解密后返回（企业微信）
	EchoStrDecrypt
)

type EncryptMode int

EncryptMode 加密模式

const (
	// EncryptModeAuto 自动检测 aes/明文（公众号）
	EncryptModeAuto EncryptMode = iota
	// EncryptModeAES 强制 AES 加密（企业微信）
	EncryptModeAES
)

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

Server 统一服务端

func New(account contracts.AccountInterface, opts ...ServerOption) *Server

New 创建服务端实例

func (s *Server) Dispatch(
	request *http.Request,
	writer http.ResponseWriter,
	handler contracts.EventHandler,
)

Dispatch 直接调度事件处理（跳过路由匹配）

func (s *Server) On(handler contracts.EventHandler, eventTypes ...event.EventType)

On 注册事件处理器，支持多个事件类型绑定同一个 handler

func (s *Server) Serve(request *http.Request, writer http.ResponseWriter)

Serve 处理微信回调请求

func (s *Server) Use(middlewares ...contracts.Middleware)

Use 注册全局中间件

type ServerOption func(*Server)

ServerOption 服务端配置

func WithEchoStrMode(mode EchoStrMode) ServerOption

WithEchoStrMode 设置echostr验证模式

func WithEncryptMode(mode EncryptMode) ServerOption

WithEncryptMode 设置加密模式