CF Providers
Our CFColdboxProvider
is an implementation specifically written for Adobe ColdFusion 9.0.1 and beyond. This provider leverages the EHCache engine within ColdFusion 9 and extends the native ColdFusion capabilities by talking to the EHCache sessions natively via Java. In this manner we are able to do things like:
Get extended cached object metadata
Get overall cache statistics
Talk to terracotta classes
Do quiet operations on get, clear, and put
Check if an element is expired
Do reporting and content reporting
Much more
Properties
Each CacheBox provider can have its own set of configuration properties it needs for operation. Our CF providers also have some. Please note, all properties other than "cacheName" are passed through to the underlying EHCache implementation in ColdFusion. The default values may differ if you have edited the ehcache.xml
file on your server.
Property | Type | Required | Default | Description |
cacheName | string | false | object | The named cache to talk to via ColdFusion cache operations. By default we talk to the default ColdFusion object cache. |
clearOnFlush | boolean | false | true | Sets whether the MemoryStore should be cleared when flush() is called on the cache |
diskExpiryThreadIntervalSeconds | integer | false | 120 (2 minutes) | The interval in seconds between runs of the disk expiry thread. |
diskPersistent | boolean | false | false | Specifies whether to persist caches stored on disk through JVM restarts. |
diskSpoolBufferSizeMB | integer | false | 30 | The size of the disk spool used to buffer writes |
external | boolean | false | false | Specifies whether no timeout or idletime applies. A true value indicates that the object or page is cached without any timespan being specified. |
maxElementsInMemory | integer | fasle | 10000 | The maximum number of objects that can be cached in memory. If the number is exceeded and overflowtodisk is false, the new objects entered replace old elements using algorithm specified in the memoryevictionpolicy entry. |
maxElementsOnDisk | integer | false | 10000000 | The maximum number of objects that can be stored on disk if overfllowtodisk is true. |
memoryEvictionPolicy | string | false | LRU | The algorithm to used to evict old entries when maximum limit is reached, such as LRU (least recently used) or LFU (least frequently used). |
overflowToDisk | boolean | false | false | Specifies whether when the maximum number of elements allowed in memory is reached, objects can be moved to disk, as determined by the memoryevictionpolicy value. |
timeToIdleSeconds | integer | false | 86400 | The idle time in seconds. Used if a cfcache tag does not specify an idleTime attribute. |
timeToLiveSeconds | integer | false | 86400 | The timeout time in seconds. Used if a cfcache tag does not specify a timespan attribute. |
Info Please note that you can configure more than 1
CFColdboxProvider
cache engine in your applications that can talk to more than one referenced ColdFusion (EHCache) custom cache.
Last updated