Checking To See If CFFlush Has Already Been Executed
I just posted this on the House of Fusion CF-Talk list, but I thought I would posted up here. Someone has asked if there was a way to determine if the CFFlush tag had already been executed. I am sure there is a way to get this by digging around in the GetPageContext() family of objects, but you can perform this simply by trying to set a header value:
<cftry> <!--- Try set a status code. ---> <cfheader statuscode="200" statustext="OK" /> <!--- We set the status code, flush has not been called. ---> <cfset REQUEST.FlushInitiated = false /> <cfcatch> <!--- The CFHeader tag has thrown an error. CFFlush has already been executed. ---> <cfset REQUEST.FlushInitiated = true /> </cfcatch> </cftry>
CFHeader tags can only be executes prior to content being sent to the browser since header information is the first thing that is sent. If content has already been flushed to the browser, then CFHeader will throw an error upon execution. In this example, we CFTry to execute a CFHeader tag. If it works, then no content has been sent to the browser, and we set our flag (REQUEST.FlushInitiated) accordingly. If an error is thrown by the CFHeader tag, then we know CFFlush has been executed and we set our flag accordingly.
If you want to do this with out having to set a variable, the easy solution would be to just wrap it in a ColdFusion user defined function (UDF):
<cffunction name="IsFlushInitiated" access="public" returntype="boolean" output="false" hint="Determines if a CFFlush tag has been executed yet."> <cftry> <!--- Try set a status code. ---> <cfheader statuscode="200" statustext="OK" /> <!--- We set the status code, flush has not been called. ---> <cfreturn false /> <cfcatch> <!--- The CFHeader tag has thrown an error. CFFlush has already been executed. ---> <cfreturn true /> </cfcatch> </cftry> </cffunction>
Then you can just call this like:
<!--- Check to see if CFFlush has been called. ---> <cfif IsFlushInitiated()> .... </cfif>
Want to use code from this post? Check out the license.
Just added this to ColdFire. Thanks!
Throwing an exception as regular program flow is far from best practice and can also be quite expensive in some situations. This method also has the unintended side effect that checking if the buffer has been flushed resets the response code to 200 which may be undesirable if a different part of the application had explicitly set the response code to something else previously.
You're right though, there is a PageContext method! :)
On a side note. If for some reason you *cannot* use getPageContext(), for instance if you're on CF5, an alternative method would be:
<cfheader name="CFFlushInited" value="false">
which will throw an exception just like your code, but won't overwrite potentially valuable response information.
Good point; throwing exceptions is not a good practice. But to be fair, checking to see if CFFlush has been executed is probably not a best practice either :)
Thanks for pointing out a better way to perform this task. I think I saw something like this in FireBug or something (Ray Camden).
As far as an alternate method for CF5... what is CF5? ;)
Silly people still using CF5....