com.atlassian.confluence.cache

Class DefaultCacheSettingsManager

java.lang.Object

com.atlassian.confluence.cache.DefaultCacheSettingsManager

All Implemented Interfaces:

com.atlassian.cache.CacheSettingsDefaultsProvider, CacheSettingsManager, org.springframework.beans.factory.InitializingBean

Deprecated.

since 6.14, Implementation detail, will be moved into an internal package in a future release.

@Deprecated
public class DefaultCacheSettingsManager
extends Object
implements CacheSettingsManager, org.springframework.beans.factory.InitializingBean

Implementation of CacheSettingsManager that uses a read-only Configuration file that specifies the cache defaults. The configuration file must be in the format to be parsed using the Typesafe Config Library.

The format of the file must include an entry caches which is an array of objects, that each object contains the following cacheSettingsOverridesProperties:

• name - name of the caches to match. Note that trailing wildcards are supported. E.g. "com.*" will match "com.food" and "com."
• config - object containing the cacheSettingsOverridesProperties for the cache. See below.

A config object may contain the following cacheSettingsOverridesProperties:

• expire-after-access-secs - used to set the CacheSettingsBuilder.expireAfterAccess hint
• expire-after-write-secs - used to set the CacheSettingsBuilder.expireAfterWrite hint
• flushable - used to set the CacheSettingsBuilder.flushable() hint
• local - used to set the CacheSettingsBuilder.local() hint
• max-entries - used to set the CacheSettingsBuilder.maxEntries hint
• replicate-async - used to set the CacheSettingsBuilder.replicateAsynchronously() hint
• replicate-via-copy - used to set CacheSettingsBuilder.replicateViaCopy() hint

An example minimal configuration file is:

 // Defaults for local caches
 local-defaults = {
     local = true
     flushable = true
     max-entries = 1000
     expire-after-access-secs = 360
 }

 // Defaults for replicated caches
 remote-defaults = ${local-defaults} {
     local = false
     replicate-via-copy = true
 }

 remote-big = ${remote-defaults} {
     expire-after-write-secs = 42
     flushable = false
     replicate-async = true
     replicate-via-copy = false
     max-entries = 666666
 }

 caches = [
     { name = "a.local.cache", config = ${local-defaults} }
     { name = "a.remote.cache", config = ${remote-defaults} }
     { name = "big.ones.*", config = ${remote-big} }
     { name = "reg.+exp[chars(\\", config = ${remote-big} }
     { name = "*", config = ${remote-defaults} }
 ]
 

Constructor Summary

Constructors

Constructor and Description
DefaultCacheSettingsManager(BootstrapManager bootstrapManager, com.atlassian.beehive.ClusterLockService clusterLockService, String cacheSettingsDefaults, String cacheSettingsOverrides) Deprecated.
DefaultCacheSettingsManager(BootstrapManager bootstrapManager, com.atlassian.beehive.ClusterLockService clusterLockService, String cacheSettingsDefaults, String cacheSettingsOverrides, List<String> ignored) Deprecated. since 5.9.1

Method Summary

Modifier and Type	Method and Description
void	afterPropertiesSet() Deprecated.
@NonNull com.atlassian.cache.CacheSettings	getDefaults(@NonNull String name) Deprecated.
boolean	saveSettings() Deprecated. Persists all changes made so far by update* methods.
com.atlassian.fugue.Option<Integer>	updateMaxEntries(@NonNull String name, int newValue) Deprecated. since 7.0.1. Use CacheSettingsManager.changeMaxEntries(String, int)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.atlassian.confluence.cache.CacheSettingsManager

changeMaxEntries

Constructor Detail

DefaultCacheSettingsManager

public DefaultCacheSettingsManager(BootstrapManager bootstrapManager,
                                   com.atlassian.beehive.ClusterLockService clusterLockService,
                                   String cacheSettingsDefaults,
                                   String cacheSettingsOverrides)

Deprecated.

DefaultCacheSettingsManager

@Deprecated
public DefaultCacheSettingsManager(BootstrapManager bootstrapManager,
                                               com.atlassian.beehive.ClusterLockService clusterLockService,
                                               String cacheSettingsDefaults,
                                               String cacheSettingsOverrides,
                                               List<String> ignored)

Deprecated. since 5.9.1

Method Detail

afterPropertiesSet

public void afterPropertiesSet()
                        throws Exception

Deprecated.

Specified by:

afterPropertiesSet in interface org.springframework.beans.factory.InitializingBean

Throws:

Exception

updateMaxEntries

@Deprecated
public com.atlassian.fugue.Option<Integer> updateMaxEntries(@NonNull String name,
                                                                        int newValue)

Deprecated. since 7.0.1. Use CacheSettingsManager.changeMaxEntries(String, int)

Description copied from interface: CacheSettingsManager

Persists updates to the max entries settings for the specified cache.

Specified by:

updateMaxEntries in interface CacheSettingsManager

Parameters:

name - the name of the cache to update

Returns:

the previous value of the specified max entries if any have

saveSettings

public boolean saveSettings()

Deprecated.

Description copied from interface: CacheSettingsManager

Persists all changes made so far by update* methods.

Specified by:

saveSettings in interface CacheSettingsManager

Returns:

true if changes were persisted successfully

getDefaults

public @NonNull com.atlassian.cache.CacheSettings getDefaults(@NonNull String name)

Deprecated.

Specified by:

getDefaults in interface com.atlassian.cache.CacheSettingsDefaultsProvider