storage

type Config struct {
	// ShardCount is the number of shards, recommended to be a power of 2.
	// ShardCount 是分片数量，建议为2的幂次方。
	ShardCount int

	// InitialCapacity is the initial capacity per shard.
	// InitialCapacity 是每个分片的初始容量。
	InitialCapacity int

	// LoadFactor determines when to resize the internal maps.
	// LoadFactor 决定何时调整内部映射的大小。
	LoadFactor float64

	// TrackAccessTime enables tracking of access times for items.
	// TrackAccessTime 是否启用访问时间追踪。
	TrackAccessTime bool

	// BatchSize is the buffer size for batch operations.
	// BatchSize 是批量操作的缓冲区大小。
	BatchSize int

	// MaxMemoryBytes is the maximum memory usage in bytes.
	// MaxMemoryBytes 是最大内存使用量（字节）。
	MaxMemoryBytes int64

	// AsyncAccessUpdate enables asynchronous updates of access times.
	// AsyncAccessUpdate 是否启用异步更新访问时间。
	AsyncAccessUpdate bool
}

type Item struct {
	Key        uint64      // Unique identifier / 键
	Value      interface{} // Cached value / 值
	Size       int64       // Size in bytes / 条目大小（字节）
	AccessTime int64       // Last access timestamp (Unix nano) / 最后访问时间（Unix纳秒）
	ExpireAt   int64       // Expiration timestamp (Unix nano, 0 means never expire) / 过期时间（Unix纳秒，0表示永不过期）
	Cost       int64       // Cost value for admission control / 成本，用于容量控制
	Flags      uint32      // Bit flags for item status / 标志位，用于标记条目状态
}

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

type OptimizerConfig struct {
	// 优化间隔（秒）
	Interval int64

	// 每次优化的最大项数
	MaxItems int

	// 内存限制（字节）
	MemoryLimit int64

	// 成本限制
	CostLimit int64

	// 采样比例（0-1）
	SampleRatio float64
}

type Stats struct {
	Hits            uint64 // Cache hit count / 命中次数
	Misses          uint64 // Cache miss count / 未命中次数
	Evictions       uint64 // Eviction count / 淘汰次数
	Expirations     uint64 // Expiration count / 过期次数
	ItemCount       int64  // Current item count / 条目数量
	BytesSize       int64  // Current size in bytes / 总大小（字节）
	EvictionCost    int64  // Cost of evicted items / 淘汰成本
	EvictionCount   uint64 // Number of eviction operations / 淘汰次数
	ExpiredCount    uint64 // Number of expired items / 过期条目数
	ConflictCount   uint64 // Hash conflict count / 冲突次数
	OverwriteCount  uint64 // Overwrite count / 覆盖次数
	AsyncQueueSize  int64  // Size of async operation queue / 异步队列大小
	AsyncDropCount  uint64 // Count of dropped async operations / 异步丢弃次数
	ReadLatencyNs   int64  // Average read latency in ns / 读取延迟（纳秒）
	WriteLatencyNs  int64  // Average write latency in ns / 写入延迟（纳秒）
	DeleteLatencyNs int64  // Average delete latency in ns / 删除延迟（纳秒）
}

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