CachePut(id, value, [timeSpan], [idleTime], [region], [throwOnError])
cfcache, CacheGet, CacheGetAllIds, CacheGetProperties, CacheRemove, CacheSetProperties
ColdFusion 10: Added the region and throwOnError parameters.ColdFusion 9: Added the function.
Parameter |
Description |
---|---|
id |
The ID for the cache object. |
value |
The value of the object. Can be any data type supported by ColdFusion |
timeSpan |
(Optional) The interval until the object is flushed from the cache, as a decimal number of days. One way to set the value is to use the return value from the CreateTimeSpan function. The default is to not time out the object. |
idleTime |
(Optional) A decimal number of days after which the object is flushed from the cache if it is not accessed during that time. One way to set the value is to use the return value from the CreateTimeSpan function. |
region |
Optional. Specifies the cache region where you can place the cache object. |
throwOnError |
Optional. If True and if regen does not exist, throws an error.
|
<cfscript> //define a cache region struct rProps={}; // define properties for region struct rProps.MAXELEMENTSINMEMORY = "5"; rProps.ETERNAL = "false"; rProps.TIMETOIDLESECONDS = "100"; rProps.TIMETOLIVESECONDS = "50"; rProps.OVERFLOWTODISK = "true"; rProps.DISKEXPIRYTHREADINTERVALSECONDS = "3600"; rProps.DISKPERSISTENT = "false"; rProps.DISKSPOOLBUFFERSIZEMB = "30"; rProps.MAXELEMENTSONDISK = "10"; rProps.MEMORYEVICTIONPOLICY = "LRU"; rProps.CLEARONFLUSH = "true"; rProps.OBJECTTYPE = "OBJECT"; // create a cache region, kRegion, that contains the properties defined above CacheRegionNew("cRegion",#rProps#,true); // display the properties of the newly created cache region WriteDump(CacheGetProperties("cRegion")); // store an object in the cache cpRegion // create object myObj myObj={}; myObj.a="hello"; myObj.b="world"; // store myObj in the cache region CachePut("id_1",myObj,createTimespan(0,0,30,0),createTimespan(0,0,15,0),"cRegion"); // display the contents of the cache Writedump(CacheGet("id_1","cRegion")); </cfscript>
Sign in to your account