105 lines
2.8 KiB
Go
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
|
|
)
|