ColdFusion 9.0 Resources |
ObjectSaveDescriptionConverts a ColdFusion array, CFC, DateTime object, Java object, query, or structure into a serializable binary object and optionally saves the object in a file. ReturnsA serializable binary representation of the object. CategoryFunction syntaxObjectSave(object[, filePath]) See alsoParameters
UsageThis function is useful for handling dynamic data that has a relatively long period of usefulness and takes substantial time or resources to obtain. It lets you save the data in a file and use it in multiple application instances. For example, you can create a CFC that stores a query that takes long time to run and retrieves infrequently updated data. If you use the ObjectSave function to initially save the CFC as a file, and deserialize the CFC file on future application starts, you can improve application performance. Example<h3>Saving and loading an object</h3> <!--- Create the component object. ---> <cfobject component="tellTime" name="tellTimeObj"> <!--- Save the component object to a file. ---> <cfset ObjectSave(tellTimeObj, "data.out")/> <!--- Load the component object again. ---> <cfset ObjLoaded = ObjectLoad("data.out") > <!--- Invoke the methods from loaded objects. ---> <cfinvoke component="#ObjLoaded#" method="getLocalTime" returnvariable="localTime"> <cfinvoke component="#ObjLoaded#" method="getUTCTime" returnvariable="UTCTime"> <!--- Display the results. ---> <h3>Time Display Page</h3> <cfoutput> Server's Local Time: #localTime#<br> Calculated UTC Time: #UTCTime# </cfoutput> |