Pete Freitag Pete Freitag

Serializing CFC's in ColdFusion 8

Published on August 06, 2007
By Pete Freitag

One of the handy new features in ColdFusion 8 is that CFC's are now serializable. There isn't a whole lot of information about this new feature in the docs, but I did some playing around and it does appear that they have used Java's serialization API. This means that you can use java's to serialize your CFC's...

Here's an example of how you might write serialize a CFC to a file:

<cfset myCFCInstance = CreateObject("component", "test")>
<cfset myCFCInstance.setName("something")>
<cfset fileOut = CreateObject("java", "")>
<cfset fileOut.init(ExpandPath("./serialized_cfc.txt"))>
<cfset objOut = CreateObject("java", "")>
<cfset objOut.init(fileOut)>
<cfset objOut.writeObject(myCFCInstance)>
<cfset objOut.close()>

You will now have a file called serialized_cfc.txt that you can open up. The file is actually a binary file, but you can read it with a text editor and see the values of your CFC instance variables inside this file.

Now suppose you want to read that file and reconstruct your CFC instance (deserialize it). We just use a FileInputStream and a ObjectInputStream:

<cfset fileIn = CreateObject("java", "")>
<cfset fileIn.init(ExpandPath("./serialized_cfc.txt"))>
<cfset objIn = CreateObject("java", "")>
<cfset objIn.init(fileIn)>
<cfset newCFCInstance = objIn.readObject()>
<cfset objIn.close()>


Now suppose you didn't want to write the CFC instance to a file, but rather store it as a value somewhere else... We can use a ByteArrayOutputStream and then turn turn the Byte Array into a Base64 string.

<cfset byteOut = CreateObject("java", "")>
<cfset byteOut.init()>
<cfset objOut = CreateObject("java", "")>
<cfset objOut.init(byteOut)>
<cfset objOut.writeObject(myCFCInstance)gt;
<cfset objOut.close()>

<cfdump var="#ToBase64(byteOut.toByteArray())#">

Handy Stuff. Are there any functions or new features that I have missed that make this process any easier?

coldfusion cfml serialization cfc coldfusion 8 java base64

Serializing CFC's in ColdFusion 8 was first published on August 06, 2007.

If you like reading about coldfusion, cfml, serialization, cfc, coldfusion 8, java, or base64 then you might also like:


The Fixinator Code Security Scanner for ColdFusion & CFML is an easy to use security tool that every CF developer can use. It can also easily integrate into CI for automatic scanning on every commit.

Try Fixinator

The weekly newsletter for the CFML Community


Is this how we are supposed to work with the serializable cfc's? This is really awesome, but I'm just wondering if there is an easier way, such as using the new file handling functions in cf 8?

With a base64 string, could you stick that representation of the object in a database for instance? If so, what datatype and size would you need (sorry, don't know much about base64)
by Ryan Guill on 08/06/2007 at 11:06:39 AM UTC
Ryan - like I said I couldn't find too much about serialization in the Docs, I did test CFWDDX and the new SerializeJSON functions, they don't work with CFC's So as far as I know this is the way to do it, but if anyone else knows a better way I would like to hear it...

As for the base64 string - yes you could store this in a database - I would probably use a text feild instead of a varchar, because they can get very big. The size of the base64 string will be bigger than the size of the data it is encoding. Base64 is a way to encode binary data using printable ascii characters.
by Pete Freitag on 08/06/2007 at 11:17:00 AM UTC
Ah, I see. Can you link to the information you did find in the docs... I can't seem to find anything at all.
by Ryan Guill on 08/06/2007 at 11:41:42 AM UTC
Michael - I haven't had a chance to test that yet, but I would guess that those would be serialized as well. If anyone want's to test please post the results in the comments here.
by Pete Freitag on 08/06/2007 at 1:44:15 PM UTC
Thanks for following up on this for me. I am going to mess around with this tonight on a CF cluster to see how the serialization works in a cluster. Ill let you know.
by robi sen on 08/06/2007 at 3:52:58 PM UTC
very nice pete. But what are the practical use cases for this functionality? In a real world app, why and where can this functionality be applied?
by William from Lagos on 08/07/2007 at 12:41:48 AM UTC
Nice post.
I agree that there is not much information available in the docs on CFC serialization. That is because, CFCs stored in the session just replicate across sessions in a cluster environment during session replication. Nothing specific has to be done to get this working.

By the way, I am Rakshith ( from Adobe and I was the one who got the CFC serialization working in ColdFusion 8. I have a post on CFC serialization on my blog. Check it out if you are interested

@Micheal : The "has a" component too will be serialized. In fact, the serialization also takes care of circular references where a CFC points to itself.

@William: I start off my post on CFC serialization with a hypothetical use case. That should give you an idea where the functionality can be applied.
by Rakshith on 08/07/2007 at 1:13:51 AM UTC
This is very helpful, but how might one convert the last example back to the instance of the CFC?

by Jason on 08/07/2007 at 7:16:21 AM UTC
Ok after some playing I found out how to make it happen. Basically I used converted the Base64 string back to binary using toBinary() then used the and passed it into the similar to the example reading the file.

Is this the suggested method?
by Jason on 08/07/2007 at 7:32:11 AM UTC
@Rakshith - Thanks for commenting and answering some questions...

@Jason - Yes that is the method I would use to convert the base64 string back into a CFC.

@Michael - There are a lot of different use cases for object serialization, but allowing CFC's in a session variable on a clustered environment is probably the main reason it was added in CF8. See Rakshith's post for more about that.
by Pete Freitag on 08/07/2007 at 10:19:20 AM UTC
I found this CFC for creating XML objects from CFCs (and vice versa)in the meantime. It DOES work with Arrays, etc:
by Jim Crews on 05/13/2009 at 3:43:43 PM UTC
I always here Java folks talking about serializing objects. I do not understand what it really does, what benefit it gives me, or what a real life use would be. Would you explain. Thanks
by Jon on 02/05/2010 at 8:21:06 AM UTC
Jon, one good use case for object serialization is caching. Suppose you had some objects that are expensive to populate and you wanted them to persist for some period of time even if the server was restarted.

There are probably more use cases for serialization when building Java GUI apps, than with building CF web apps, so thats why you hear java folks talking about it more.
by Pete Freitag on 02/05/2010 at 10:19:18 AM UTC