mirror of
https://github.com/ergochat/ergo.git
synced 2024-11-22 11:59:40 +01:00
ConfigStore: clarify intended use
This commit is contained in:
parent
c603d41d08
commit
34ad3a2dc1
@ -11,22 +11,23 @@ import (
|
|||||||
/*
|
/*
|
||||||
This can be used to implement the following pattern:
|
This can be used to implement the following pattern:
|
||||||
|
|
||||||
1. Load and munge a config (this can be arbitrarily expensive)
|
1. Prepare a config object (this can be arbitrarily expensive)
|
||||||
2. Use Set() to install the config
|
2. Take a pointer to the config object and use Set() to install it
|
||||||
3. Use Get() to access the config
|
3. Use Get() to access the config from any goroutine
|
||||||
4. As long as any individual config is not modified (by any goroutine)
|
4. To update the config, call Set() again with a new prepared config object
|
||||||
after the initial call to Set(), this is free of data races, and Get()
|
5. As long as any individual config object is not modified (by any goroutine)
|
||||||
|
after it is installed with Set(), this is free of data races, and Get()
|
||||||
is extremely cheap (on amd64 it compiles down to plain MOV instructions).
|
is extremely cheap (on amd64 it compiles down to plain MOV instructions).
|
||||||
*/
|
*/
|
||||||
|
|
||||||
type ConfigStore[T any] struct {
|
type ConfigStore[Config any] struct {
|
||||||
ptr unsafe.Pointer
|
ptr unsafe.Pointer
|
||||||
}
|
}
|
||||||
|
|
||||||
func (c *ConfigStore[T]) Get() *T {
|
func (c *ConfigStore[Config]) Get() *Config {
|
||||||
return (*T)(atomic.LoadPointer(&c.ptr))
|
return (*Config)(atomic.LoadPointer(&c.ptr))
|
||||||
}
|
}
|
||||||
|
|
||||||
func (c *ConfigStore[T]) Set(ptr *T) {
|
func (c *ConfigStore[Config]) Set(ptr *Config) {
|
||||||
atomic.StorePointer(&c.ptr, unsafe.Pointer(ptr))
|
atomic.StorePointer(&c.ptr, unsafe.Pointer(ptr))
|
||||||
}
|
}
|
||||||
|
Loading…
Reference in New Issue
Block a user