Creating CacheBox

CacheBox is the core framework you need to instantiate in order to work with caching in your application. You can instantiate it with a CacheBoxConfig object that will hold all of your caching configurations. To configure the library you can either do it programmatically or via a struct/data DSL, the choice is yours. After the library is instantiated and configured you can ask from it a named cache provider, or interact with the caches. By default, CacheBox can be started with no configuration and it will configure itself with the default configuration that is shipped with CacheBox that can be found in the following location:
1
/cachebox/system/cache/config/DefaultConfiguration.cfc
Copied!
The default configuration is the following:
1
function configure(){
2
    // The CacheBox configuration structure DSL
3
    cacheBox = {
4
        // LogBox Configuration file
5
        logBoxConfig = "cachebox.system.cache.config.LogBox",
6
​
7
        // Scope registration, automatically register the cachebox factory instance on any CF scope
8
        // By default it registers itself on application scope
9
        scopeRegistration = {
10
            enabled = true,
11
            scope   = "application", // valid CF scope
12
            key     = "cacheBox"
13
        },
14
​
15
        // The defaultCache has an implicit name of "default" which is a reserved cache name
16
        // It also has a default provider of cachebox which cannot be changed.
17
        // All timeouts are in minutes
18
        // Please note that each object store could have more configuration properties
19
        defaultCache = {
20
            objectDefaultTimeout = 120,
21
            objectDefaultLastAccessTimeout = 30,
22
            useLastAccessTimeouts = true,
23
            reapFrequency = 2,
24
            freeMemoryPercentageThreshold = 0,
25
            evictionPolicy = "LRU",
26
            evictCount = 1,
27
            maxObjects = 300,
28
            // Our default store is the concurrent soft reference
29
            objectStore = "ConcurrentSoftReferenceStore",
30
            // This switches the internal provider from normal cacheBox to coldbox enabled cachebox
31
            coldboxEnabled = false
32
        },
33
​
34
        // Register all the custom named caches you like here
35
        caches = {},
36
        // Register all event listeners here, they are created in the specified order
37
        listeners = []
38
    };
39
}
Copied!
If you are using CacheBox within a ColdBox application you do not need to worry about creating or even configuring the framework, as ColdBox ships already with a default configuration for ColdBox applications. However, you also have full control of configuring CacheBox at your application level (Please see the ColdBox application configuration section). The default configuration for a ColdBox application can be found in the following location:
1
/coldbox/system/web/config/CacheBox.cfc
Copied!
Modes of Operation
In summary, CacheBox has two modes of operation:
Standalone Framework
ColdBox Application
If you have downloaded CacheBox as a standalone framework, then please make sure you use the correct namespace path (cachebox.system). Also, once you create CacheBox make sure that you persist it somewhere, either in Application scope or any other scope or a dependency injection context (WireBox). ColdBox application users already have an instance of CacheBox created for you in every application and it is stored in the main application controller and can be retrieved via the following function:
1
// Get a reference to CacheBox
2
controller.getCacheBox();
3
​
4
// Get a reference to the default cache provider
5
controller.getCache() or getCache()
6
​
7
// Get a reference to a named cache provider
8
controller.getCache("template") or getCache("template")
Copied!
Info Note: Most of the examples shown in this documentation refer the default framework namespace of coldbox.system. However, if you are using CacheBox as a standalone framework, then the namespace to use is cachebox.system. Happy Coding!
Creating CacheBox Examples
Let's start with the simplest example of them all which is just creating CacheBox with the default configuration. The rest of the samples show different configuration options:
1
import cachebox.system.cache.*;
2
​
3
// create cachebox
4
cachebox = new CacheFactory();
5
// get the default cache
6
cache = cachebox.getDefaultCache();
7
// set a value in cache, with 60 minute timeout and 20 minute idle timeout.
8
cache.set("MyValue", {name="Luis Majano", awesome=true, cacheWeirdo=true}, 60,20);
Copied!
Here are some more configuration samples:
1
// Create CacheBox with default configuration
2
cacheBox = new cachebox.system.cache.CacheFactory( );
3
​
4
​
5
// Create CacheBox instance
6
cacheBox = new cachebox.system.cache.CacheFactory( config );
7
​
8
// Create the config object as a CacheBox DSL Simple CFC
9
dataCFC = new MyCacheBoxConfig();
10
config = new cachebox.system.cache.config.CacheBoxConfig( CFCConfig=dataCFC );
11
// Create CacheBox instance
12
cacheBox = new cachebox.system.cache.CacheFactory( config );
13
​
14
​
15
// Create the config object as a CacheBox DSL Simple CFC path only
16
config = new cachebox.system.cache.config.CacheBoxConfig( CFCConfigPath="MyCacheBoxConfig" );
17
// Create CacheBox instance
18
cacheBox = new cachebox.system.cache.CacheFactory( config );
19
​
20
// Create CacheBoxConfig, call configuration methods on it and then create the factory
21
config = new cachebox.system.cache.config.CacheBoxConfig();
22
// Configure programmatically: You can chain methods, woot!
23
config.scopeRegistration( true, "application" )
24
    .defaultCache( objectStore="DiskStore", maxObject=200 );
25
// Create CacheBox instance
26
cacheBox = new cachebox.system.cache.CacheFactory( config );
Copied!
Getting Started - Previous
Installing CacheBox
Common CacheFactory Methods
Copy link
Contents
Modes of Operation
Creating CacheBox Examples