Struct groupcache::GroupcacheBuilder

pub struct GroupcacheBuilder<Value: ValueBounds> { /* private fields */ }

Allows to build groupcache instance with customized caches, timeouts etc

Implementations

impl<Value: ValueBounds> GroupcacheBuilder<Value>

pub fn main_cache(self, main_cache: Cache<String, Value>) -> Self

Sets main_cache for groupcache.

main_cache is the cache for items that this peer is the owner of. There is one owner of a given key in a set of peers forming hash ring and this peer stores values in main_cache.

By default, moka cache is used and this setter allows to customize this cache (eviction policy, size etc.)

pub fn hot_cache(self, hot_cache: Cache<String, Value>) -> Self

Sets hot_cache for groupcache.

The hot_cache is the cache for items that seem popular enough to replicate to this node, even though it’s not the owner. This however may lead to inconsistencies when expiring values (see Groupcache::remove).

By default, hot_cache stores up to 10k items and expires after 30s. Depending on use_case you may either disable hot_cache or tweak time_to_live.

pub fn https(self) -> Self

When connecting to peers, use https instead of http.

Note that this requires you to configure server running Groupcache::grpc_service to handle TLS. Look into tonic/axum documentation how to do so.

By default, http is used.

pub fn grpc_endpoint_builder( self, builder: impl Fn(Endpoint) -> Endpoint + Send + Sync + 'static ) -> Self

Allows to customize HTTP/2 channels for peer-to-peer connections.

By default, request timeout is set to 10 seconds.

pub fn service_discovery( self, service_discovery: impl ServiceDiscovery + 'static ) -> Self

Enable automatic pull-based service discovery via ServiceDiscovery

By default, automatic service is disabled, useful when: - deployed on kubernetes (see examples) - registered in consul etc

pub fn build(self) -> Groupcache<Value>