Theine-Go 项目教程

Theine-Go 项目教程

theine-gohigh performance in-memory cache项目地址:https://gitcode.com/gh_mirrors/th/theine-go

1. 项目的目录结构及介绍

Theine-Go 项目的目录结构如下：

theine-go/
├── cache/
│   ├── cache.go
│   └── cache_test.go
├── loading_cache/
│   ├── loading_cache.go
│   └── loading_cache_test.go
├── README.md
├── LICENSE
└── go.mod

目录结构介绍

• cache/: 该目录包含了缓存的核心实现文件 cache.go 和测试文件 cache_test.go。
• loading_cache/: 该目录包含了加载缓存的实现文件 loading_cache.go 和测试文件 loading_cache_test.go。
• README.md: 项目的介绍文件，包含了项目的概述、使用方法和贡献指南。
• LICENSE: 项目的开源许可证文件，通常为 MIT 许可证。
• go.mod: Go 模块文件，定义了项目的依赖关系。

2. 项目的启动文件介绍

Theine-Go 项目的主要启动文件是 cache/cache.go 和 loading_cache/loading_cache.go。这两个文件分别实现了基本的缓存功能和加载缓存功能。

cache/cache.go

该文件定义了缓存的基本操作，包括：

• 创建缓存客户端
• 设置缓存项
• 获取缓存项
• 删除缓存项

loading_cache/loading_cache.go

该文件扩展了缓存功能，支持在缓存未命中时自动加载数据。主要功能包括：

• 定义加载函数
• 自动加载并缓存数据

3. 项目的配置文件介绍

Theine-Go 项目没有传统的配置文件，但可以通过代码中的配置选项来调整缓存的行为。以下是一些常见的配置选项：

缓存客户端配置

client, err := theine.NewBuilder[string, string](1000).
    Cost(func(v string) int64 { return int64(len(v)) }).
    Doorkeeper(true).
    RemovalListener(func(key string, value string, reason theine.RemoveReason) {}).
    Build()

加载缓存配置

client, err := theine.NewBuilder[string, string](1000).
    Loading(func(ctx context.Context, key string) (theine.Loaded[string], error) {
        return theine.Loaded[string]{Value: key, Cost: 1, TTL: 0}, nil
    }).
    Build()

配置选项说明

• Max Size (1000): 缓存的最大容量。
• Cost Function: 动态计算缓存项的成本。
• Doorkeeper: 启用布隆过滤器，提高写入性能但可能降低命中率。
• Removal Listener: 缓存项被移除时的回调函数。
• Loading Function: 缓存未命中时的加载函数。

通过这些配置选项，可以灵活地调整 Theine-Go 缓存的行为，以满足不同的应用需求。

theine-gohigh performance in-memory cache项目地址:https://gitcode.com/gh_mirrors/th/theine-go