README
¶
generic
golang generics library include stream, gmap, cache etc.
泛型使用最佳实践
在初期设计和实现的泛型库中，采用了面向对象的方式实现。在实际使用中发现，这类泛型会导致编译中间文件和最终文件的急剧膨胀。
结合goweight项目，以及go tool nm -size命令，得出下面最佳实践方式：
-
针对系统现有slice和map设计泛型函数，参见stream包。
-
将泛型对象拆分成纯泛型数据对象和处理泛型数据对象的泛型方法，参见gmap包
-
如果需要设计某个泛型对象，其需要支持数据泛型和方法，则建议减少泛型方法的数量，以及方法body的大小，最好将body中的逻辑实现委托给非泛型函数。
具体分析方法：
使用goweight
- 安装goweight
- 在项目目录下执行
goweight > dist/goweight.log，查看编译中间文件大小( 观察泛型包文件大小，以及使用该泛型对象、方法的包的大小)
使用go tool nm -size命令
- 在编译命令中添加
-work -x和2>&1 | tee dist/build_output_linux.txt，将编译中间文件保存下来，并记录包和编译文件的关系 - 结合
goweight.log和build_output_linux.txt文件找到包对应的中间文件 - 使用
go tool nm -size <中间文件>查看符号表，并做适当代码调整，再反复观察
Documentation
¶
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Cache ¶
type Cache[K comparable, V any] struct { // contains filtered or unexported fields }
func (*Cache[K, V]) Clear ¶
func (c *Cache[K, V]) Clear()
Clear removes all entries from the cache. It resets the innerMap to an empty state.
func (*Cache[K, V]) Evict ¶
Evict removes the entry with the specified key from the cache. It returns true if the entry was successfully evicted, and false otherwise.
func (*Cache[K, V]) GetOrLoad ¶
GetOrLoad retrieves the value associated with the specified key from the cache. If the entry does not exist, it calls the provided `loadFunc` function to load the value and store it in the cache. The `loadFunc` function should have the signature `func(k K) (V, error)`.
Source Files
Directories