CFContent-Variable Response vs. Standard Output Response

Posted November 23, 2009 at 6:56 PM by Ben Nadel

Tags: ColdFusion

I've been playing around with ColdFusion Builder Extensions lately and I'm running into some very odd behavior. Before I write anything about that, however, I wanted to confirm that a response driven by the CFContent tag and its Variable attribute is identical to a response driven by the standard ColdFusion output. To test this hypothesis, I created a simple ColdFusion page that would take XML data and return it, based on a URL variable, using either the standard ColdFusion output or the CFContent tag:

Content.cfm

  • <!---
  • Param the method of content delivery. Basically, whether or
  • not we want to use the CFContent tag to deliver the content
  • back to the client (as a binary stream).
  • --->
  • <cfparam name="url.cfcontent" type="boolean" default="false" />
  •  
  •  
  • <!---
  • Create the content that we are going to stream back. (NOTE:
  • this response is the Tick's war cry!!).
  • --->
  • <cfsavecontent variable="responseData">
  •  
  • <response>
  • <message>Spooooooon!</message>
  • </response>
  •  
  • </cfsavecontent>
  •  
  •  
  • <!---
  • Check to see which streaming method we are using: either
  • CFContent, or the standard output.
  • --->
  • <cfif url.cfcontent>
  •  
  • <!--- Use CFContent to stream back binary data. --->
  •  
  • <!---
  • Convert the raw data into a binary string so we can
  • use it with the CFContent tag's Variable attribute.
  • --->
  • <cfset responseBinary = toBinary(
  • toBase64( trim( responseData ) )
  • ) />
  •  
  • <!--- Tell client how much data to expect. --->
  • <cfheader
  • name="content-length"
  • value="#arrayLen( responseBinary )#"
  • />
  •  
  • <!--- Set a type-flag for debugging. --->
  • <cfheader
  • name="response-type"
  • value="CFCONTENT"
  • />
  •  
  • <!--- Stream the binary data to the client. --->
  • <cfcontent
  • type="text/xml"
  • variable="#responseBinary#"
  • />
  •  
  • <cfelse>
  •  
  • <!--- Use standard output to stream back data. --->
  •  
  • <!--- Tell client how much data to expect. --->
  • <cfheader
  • name="content-length"
  • value="#len( trim( responseData ) )#"
  • />
  •  
  • <!--- Set a type-flag for debugging. --->
  • <cfheader
  • name="response-type"
  • value="STANDARD"
  • />
  •  
  • <!---
  • Forgive this last piece of messiness - I just wanted
  • to make sure that this methodology would finalize the
  • request in the same way that CFContent would.
  • --->
  • <cfcontent
  • type="text/xml"
  • /><cfset writeOutput( trim( responseData ) ) /><cfabort />
  •  
  • </cfif>

As you can see above, starting with a single XML string, I configure the response in such a way that both responses halt immediately after the response data is written to the response output. Theoretically, the only difference between these two responses should be the custom CFHeader value, "response-type", which I am inserting for debugging / sanity-check purposes.

With the content page in place, I then set up a test page which would make two CFHTTP requests to the content.cfm page - one using the standard output response and one using the CFContent-driven response:

  • <!--- Build the URL for the standard content page. --->
  • <cfset standardURL = (
  • "http://" &
  • cgi.server_name &
  • getDirectoryFromPath( cgi.script_name ) &
  • "content.cfm"
  • ) />
  •  
  • <!---
  • Build the URL for the cfcontent-driven content page
  • (simply adding the URL-flag to the request).
  • --->
  • <cfset cfcontentURL = (standardURL & "?cfcontent=true") />
  •  
  •  
  •  
  • <!--- Request data from the standard url. --->
  • <cfhttp
  • result="standardGet"
  • method="get"
  • url="#standardURL#"
  • />
  •  
  • <!--- Request data from the cfcontent url. --->
  • <cfhttp
  • result="cfcontentGet"
  • method="get"
  • url="#cfcontentURL#"
  • />
  •  
  •  
  •  
  • <cfoutput>
  •  
  • <!--- Output the standard response. --->
  • <h2>
  • Standard Response
  • </h2>
  •  
  • <cfdump
  • var="#standardGet#"
  • label="Standard Get"
  • />
  •  
  • <p>
  • Message:
  • #xmlParse( standardGet.fileContent ).response.message#
  • </p>
  •  
  • <!--- ------------------------------------------------- --->
  • <!--- ------------------------------------------------- --->
  •  
  • <!--- Output the cfcontent-driven response. --->
  • <h2>
  • CFContent-Driven Response
  • </h2>
  •  
  • <cfdump
  • var="#cfcontentGet#"
  • label="CFContent-Driven Get"
  • />
  •  
  • <p>
  • Message:
  • #xmlParse( cfcontentGet.fileContent ).response.message#
  • </p>
  •  
  • </cfoutput>

As you can see, the only difference between the two CFHTTP requests is the use of the url-variable, "?cfcontent=true". When we run the above code, we get the following page output:

 
 
 
 
 
 
CFContent / Variable Response vs. Standard ColdFusion Output Response. 
 
 
 

Other than the "response-type" header value that I inserted (to make sure that I didn't mess this up), there is zero difference between the two responses; both report the same status code, content type, content length, and actual file content - from the requesting standpoint, these two responses are identical.

This result is not surprising - the CFContent / Variable approach to ColdFusion responses is something that I use often; this exploration and confirmation was meant only to be a lead-up to a following blog post.




Reader Comments

David McGuigan
Nov 24, 2009 at 1:14 AM // reply »
149 Comments
1,313 Points

I always thought you took the streamy approach because of some kind of performance gains or reduced server overhead you secretly knew about. Excited for the follow up.


Ben Nadel
Nov 24, 2009 at 8:01 AM // reply »
11,246 Comments
75,418 Points

@David,

No performance gain (that I know of). I just like the approach because it gives me ultimate control over what data is actually returned, including things like the content-length precision.


Barumpus
Nov 11, 2010 at 1:08 PM // reply »
1 Comments
11 Points

Thanks for posting this. It made me realize that my headers were missing because by cfheader tag was placed after the cfcontent tag.


Post A Comment

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.

Please review the following issues:

Author Name:
Author Email:
Author Website:
Comment:
Supported HTML tags for formatting: <strong>bold</strong>   <em>italic</em>   <code>code</code>







  • Help Wanted - Find Your Next ColdFusion Job
Ben Nadel's Company - Epicenter Consulting Recent Blog Comments
Brandon
May 23, 2013 at 9:52 PM
Preventing Links In Standalone iPhone Applications From Opening In Mobile Safari
@Muhmmadibn Did you figure out a solution to launching PDFs? I am running into the same issues myself. There is no way to close the PDF or go back once you launch it. Thanks in advance! ... read »
Dr Amadi
May 23, 2013 at 6:06 PM
The Girl Who Broke My Heart, And Made Me A Better Person
Good day,ladies and gentle men, my name is Dr AMADI the great spell caster in Africa, i have help so many people for different kind of problems,who say there is no solution to problems on earth, that ... read »
Ben Nadel
May 23, 2013 at 4:26 PM
ColdFusion QueryAppend( qOne, qTwo )
@Heather, Glad people are still getting value out of this! ... read »
Ben Nadel
May 23, 2013 at 3:49 PM
Strange Interaction Between DeserializeJson(), ArrayContains(), And Database Values In ColdFusion
@WebManWalking, I meant the code at the bottom (not the video). I did try to experiment with an intermediary variable, like: value = users.id[ i ]; arrayContains( userIDs, value ); ... but t ... read »
WebManWalking
May 23, 2013 at 11:06 AM
Strange Interaction Between DeserializeJson(), ArrayContains(), And Database Values In ColdFusion
@Ben, Are you talking about As Number: YES As String: YES As Java: YES? If so, that's with 3 different ways of referencing the constant 1, not users.id[1]. Query object references(*) are what seem ... read »
Ben Nadel
May 23, 2013 at 9:55 AM
Strange Interaction Between DeserializeJson(), ArrayContains(), And Database Values In ColdFusion
@Dan, According to the CF Admin, I'm running Java "1.6.0_45". As far as the DB column, in the database it's an INT. I'll see if I can dig into what CF sees it as. @WebManWalking, But h ... read »
WebManWalking
May 23, 2013 at 9:49 AM
Strange Interaction Between DeserializeJson(), ArrayContains(), And Database Values In ColdFusion
@Ben, I think the problem is that we're used to loose typing in ColdFusion, like JavaScript. If a value is a number but it's needed in an expression to be a string, noooo problem. I've encountered ... read »
Heather
May 23, 2013 at 9:47 AM
ColdFusion QueryAppend( qOne, qTwo )
You rock! Thank you, thank you, thank you!!! ... read »
InVision App - Prototyping Made Beautiful With Prototyping Tools