Package com.tangosol.net

Interface BackingMapManager

    • Method Detail

      • init

        void init​(BackingMapManagerContext context)
        Called by a CacheService to indicate to this manager that the manager is being associated with the CacheService. This method is called once immediately upon the startup of the CacheService, before any NamedCache objects are created by the CacheService.

        Important note: BackingMapManager cannot be associated with more then one instance of a CacheService. However, in a situation when a CacheService automatically restarts, it is possible that this manager instance is re-used by a newly created (restarted) CacheService calling this method once again providing a new context.

        Parameters:
        context - the BackingMapManagerContext object for this BackingMapManager

      • getCacheFactory

        ConfigurableCacheFactory getCacheFactory()
        Obtain the "container" ConfigurableCacheFactory that created this manager and which this manager is bound to.
        Returns:
        the ConfigurableCacheFactory that created this manager

      • getContext

        BackingMapManagerContext getContext()
        Determine the current BackingMapManagerContext for this BackingMapManager.
        Returns:
        the current context

      • instantiateBackingMap

        Map instantiateBackingMap​(String sName)
        Instantiate a [thread safe] Map that should be used by a CacheService to store cached values for a NamedCache with the specified name.

        If the contents of the Map can be modified by anything other than the CacheService itself (e.g. if the Map automatically expires its entries periodically or size-limits its contents), then the returned object must implement the ObservableMap interface.

        Parameters:
        sName - the name of the NamedCache for which this backing map is being created
        Returns:
        an object implementing the Map interface that will provide backing storage for the specified cache name

      • isBackingMapPersistent

        boolean isBackingMapPersistent​(String sName)
        Determine if the contents of the Map that is used by a CacheService to store cached values for a NamedCache with the specified name should be persisted.
        Parameters:
        sName - the name of the NamedCache
        Returns:
        true if the CacheService should persist the backing storage of the specified NamedCache

      • isBackingMapPersistent

        default boolean isBackingMapPersistent​(String sName,
                                       boolean fSnapshot)
        Determine if the contents of the Map that is used by a CacheService to store cached values for a NamedCache with the specified name should be persisted.
        Parameters:
        sName - the name of the NamedCache
        fSnapshot - true if asked for the purpose of creating a snapshot
        Returns:
        true if the CacheService should persist the backing storage of the specified NamedCache

      • isBackingMapSlidingExpiry

        boolean isBackingMapSlidingExpiry​(String sName)
        Determine if the Map that is used by a CacheService to store cached values for a NamedCache with specified name enables the sliding expiry - the expiry delay being extended by the read operations.
        Parameters:
        sName - the name of the NamedCache
        Returns:
        true if the backing map of the specified NamedCache enables the sliding expiry

      • getReadLocator

        default BiFunction<Ownership,​PartitionedService,​Member> getReadLocator​(String sName)
        Return a function that when called will return a member given the current partition owners and service, or null if the service should target the primary. This function is called by the respective service to target read requests at the relevant member, and can be specific to a cache.

        An implementation can return any member in the ownership chain, inferring a tolerance to stale reads when a backup (non-primary) is targeted. This may be possible as the primary (or other backups) process future changes while the member that performed the read (and was chosen by the returned function) has not.

        There are several benefits in targeting backups for reads including balancing load and latency. For example, the latter can be achieved by targeting the read to a backup that resides on the same machine, rack or site. The default implementation allows this to be chosen via configuration.

        Parameters:
        sName - the name of the NamedCache
        Returns:
        a function that when called will return a member given the current partition owners and service, or null if the service should target the primary

      • releaseBackingMap

        void releaseBackingMap​(String sName,
                       Map map)
        Release the specified Map that was created using the instantiateBackingMap(String) method. This method is invoked by the CacheService when the CacheService no longer requires the specified Map object.
        Parameters:
        sName - the name of the NamedCache for which the specified Map object has acted as the backing map
        map - the Map object that is being released