Files
go-sms-V2/internal/pkg/cache/client.go
T

105 lines
2.8 KiB
Go

// Package cache Redis 缓存客户端封装(go-redis/v9,Day 6)。
// 统一 single / cluster / sentinel 三种模式的客户端构造与生命周期,
// 业务侧通过嵌入的 redis.UniversalClient 使用全部 Redis 命令。
package cache
import (
"errors"
"fmt"
"strings"
"time"
"github.com/redis/go-redis/v9"
)
// Mode 常量:Redis 部署模式。
const (
ModeSingle = "single"
ModeCluster = "cluster"
ModeSentinel = "sentinel"
)
// Options Redis 客户端配置(对应 config.Redis)。
type Options struct {
Mode string // single | cluster | sentinel
Addrs []string
Password string
DB int // 仅 single/sentinel 有效
PoolSize int
MasterName string // 仅 sentinel 有效
}
// Client 统一 Redis 客户端;嵌入 UniversalClient,
// 单机与集群命令签名一致(Set/Get/Del/Eval/Pipeline 等)。
type Client struct {
redis.UniversalClient
mode string
}
// Mode 返回部署模式。
func (c *Client) Mode() string { return c.mode }
// New 按模式构造 Redis 客户端(lazy 连接,首次命令时建立连接)。
func New(opt Options) (*Client, error) {
mode := strings.ToLower(strings.TrimSpace(opt.Mode))
if mode == "" {
mode = ModeSingle
}
if len(opt.Addrs) == 0 {
return nil, errors.New("redis.addrs 不能为空")
}
if opt.PoolSize <= 0 {
opt.PoolSize = 100
}
var uc redis.UniversalClient
switch mode {
case ModeSingle:
uc = redis.NewClient(&redis.Options{
Addr: opt.Addrs[0],
Password: opt.Password,
DB: opt.DB,
PoolSize: opt.PoolSize,
DialTimeout: dialTimeout,
ReadTimeout: readTimeout,
WriteTimeout: writeTimeout,
})
case ModeCluster:
uc = redis.NewClusterClient(&redis.ClusterOptions{
Addrs: opt.Addrs,
Password: opt.Password,
PoolSize: opt.PoolSize,
DialTimeout: dialTimeout,
ReadTimeout: readTimeout,
WriteTimeout: writeTimeout,
})
case ModeSentinel:
if opt.MasterName == "" {
return nil, errors.New("sentinel 模式必须配置 master_name")
}
uc = redis.NewFailoverClient(&redis.FailoverOptions{
MasterName: opt.MasterName,
SentinelAddrs: opt.Addrs,
Password: opt.Password,
DB: opt.DB,
PoolSize: opt.PoolSize,
DialTimeout: dialTimeout,
ReadTimeout: readTimeout,
WriteTimeout: writeTimeout,
})
default:
return nil, fmt.Errorf("未知 redis 模式: %q(可选 single/cluster/sentinel)", opt.Mode)
}
return &Client{UniversalClient: uc, mode: mode}, nil
}
// Ping 连通性检查直接使用嵌入的 UniversalClient.Ping(返回 *redis.StatusCmd),
// 例如:if err := c.Ping(ctx).Err(); err != nil { ... }。
// 超时常量(连接建立与命令 IO)。
const (
dialTimeout = 3 * time.Second
readTimeout = 1 * time.Second
writeTimeout = 1 * time.Second
)