Ben Nadel
On User Experience (UX) Design, JavaScript, ColdFusion, Node.js, Life, and Love.
I am the chief technical officer at InVision App, Inc - a prototyping and collaboration platform for designers, built by designers. I also rock out in JavaScript and ColdFusion 24x7.
Meanwhile on Twitter
Loading latest tweet...
Ben Nadel at CFinNC 2009 (Raleigh, North Carolina) with:

Use Content Length When Streaming Binary Variables In ColdFusion

Posted by Ben Nadel
Tags: ColdFusion

I was just reading over on cf.Objective() about how it's important to use Content-Length when streaming files to the client. Without it, the browser knows how much it has downloaded so far, but not necessarily how much it will have to download in total (I guess it goes till some sort of End Of File marker?). I can understand the need for this fix - there is perhaps nothing more frustrating than having no idea how much file you have left to download.

The problem is that while I sometimes stream actual files, it is more common that I stream binary data using ColdFusion CFContent's Variable attribute. Jared only covered the File attribute, so I wasn't sure what to do in this case. But after a bit of testing, it looks like the browser is happy know the number of bytes in the byte array that represents the binary object:

  • <!--- Kill extra output. --->
  • <cfsilent>
  •  
  • <!--- Read in the image binary. --->
  • <cffile
  • action="readbinary"
  • file="#ExpandPath( './test_girl.jpg' )#"
  • variable="binImage"
  • />
  •  
  •  
  • <!---
  • Set the content disposition and give a suggested
  • file name for the client.
  • --->
  • <cfheader
  • name="content-disposition"
  • value="attachment; filename=test_girl.jpg"
  • />
  •  
  • <!---
  • Set the content length. This is the length of the
  • byte array that represenets the binary image object.
  • --->
  • <cfheader
  • name="content-length"
  • value="#ArrayLen( binImage )#"
  • />
  •  
  • <!---
  • Set the content type and then stream the binary
  • image to the client.
  • --->
  • <cfcontent
  • type="image/jpeg"
  • variable="#binImage#"
  • />
  •  
  • </cfsilent>

This downloads the file nicely, and when I check the headers in FireBug, the content length is set correctly. Thanks Jared, good tip.

Also, as a funny little thing, if I increase the content-length by doing something like this:

  • #(ArrayLen( binImage ) + 1)#

... FireFox will actually never stop trying to download the image! I guess it just won't give up hope on that last byte :) So, I guess the moral of the story is that if you are going to provide a content length to the browser, make sure that it is correct otherwise you will do more damage than good.




Reader Comments

Cool tip! I'll definitely remember this when I start working on an app in a few weeks that will be uploading/downloading files.

CooLJJ

Reply to this Comment

Ben,

This is good, but not perfect. Docs say:

"Note: This action reads the file into a variable in the local Variables scope. It is not intended for use with large files, such as logs, because they can bring down the server."

What if you allow users/customers to download files routinely in the megs.

I haven't found a good solution to be able to give the file size for large files. Any ideas?

Reply to this Comment

@Sami,

To be honest, I don't deal with a lot of file security most of the time. Therefore, I usually just link to files directly on the public server which bypasses all the ColdFusion stuff and just lets IIS deal with the file transfer.

But I agree with the documentation - this is not a good idea for large files. If you need file security, I guess the best thing to do is copy the file to a temp directory and then forward the person to it.

Reply to this Comment

Post A Comment

?
You — Get Out Of My Dreams, Get Into My Comments
Live in the Now
Oops!
Comment Etiquette: Please do not post spam. Please keep the comments on-topic. Please do not post unrelated questions or large chunks of code. And, above all, please be nice to each other - we're trying to have a good conversation here.