Welcome!

Java Authors: Maureen O'Gara, Liz McMillan, Walter H. Pinson, III, Yakov Werde, Tony Bishop

Related Topics: ColdFusion

ColdFusion: Article

Adobe ColdFusion 8 Tips

A compilation of Ben Forta's blog entries from his ColdFusion 8 user group tour

To debug your code you can do the following:

  1. Open the ColdFusion file to be debugged in Eclipse.
  2. Set breakpoints as needed by double-clicking to the left of the desired line in the vertical bar to the left of the Eclipse editor window. You'll see a little circle appear, indicating that a breakpoint has been set. You can also right-click in the vertical bar and select "Toggle Breakpoint".
  3. Now you need to switch to the Eclipse Debug view (called a "Perspective" in Eclipse). If you see a Debug button listed with the Perspectives on the top right of Eclipse, click it. Or, just click the Open Perspective button (or select Windows->Open Perspective) and select "Debug".
  4. Once you are in the Debug perspective, start the debugging session. To do this, go back to the dialog where you defined the ColdFusion server (under the Debug button), select the ColdFusion server to debug against, and click the Debug button at the bottom of the dialog.
  5. Eclipse will pause while it opens a debug session, connecting to the specified ColdFusion server. You'll see the connection show up in the Debug window.
  6. Now just open any browser and run your application. When you request a page with a breakpoint, execution will pause and the debugger will pop up. You'll be able to step through the code, view variables and expressions (in the top right panel), see generated server output, and more.
  7. When you're done debugging, you can terminate the debug session by clicking the red square Terminate button.
That'll do it. I know this seems complex and a lot of work, but the bulk of it is the initial setup. Once that setup is complete, you'll be able to quickly and easily fire up the debugger on demand and when needed.

ColdFusion 8 File I/O Enhancements
At one of the usergroup sessions someone asked if there was a way to get file information (size, date time, etc.) easily using a function. I said they should use <CFDIRECTORY>, but afterwards remembered that we did indeed add a new function to ColdFusion 8 called GetFileInfo() that returns a structure containing:

  • canread
  • canwrite
  • ishidden
  • lastmodified
  • name
  • parent
  • path
  • size
  • type
Which makes this a good opportunity to review some of the file i/o changes coming in ColdFusion 8.

For starters, if you ever had to work with large text files in ColdFusion (maybe parsing a large CSV file), you'll know that doing so is very inefficient. You probably use code like this:

<!--- Read entire file --->
<cffile action="read"
    file="#fileName#"
    variable="myFile">
<!--- Loop through file variable one line at a time --->
<cfloop list="#myFile#"
    index="line"
    delimiters="#chr(10)##chr(13)#">
    <!--- Do stuff with line here --->
    ...
</cfloop>

This is slow for two reasons. Not only does ColdFusion read the entire file into memory in a variable all at once, but also looping through the file requires treating it as a list, which involves lots of parsing that can also be resource intensive.
Well, inefficient no more. In ColdFusion ColdFusion 8 you'll be able to replace the above code block with this:

<!--- Loop through file one line at a time --->
<cfloop file="#fileName#" index="line">
    <!--- Do stuff with line here --->
    ...
</cfloop>

This code block opens the file, reads one line at a time, and closes it when done. I actually used this myself recently in a ColdFusion code snippet that had to parse a massive tab-delimited file, turning each line into a query row. Replacing the old <CFFILE> <CFLOOP> with a new <CFFILE FILE=> cut down the processing time from several minutes to under 10 seconds.
Although reading files line by line is the more common use case, you can also read by n characters at a time, like this:

<!--- Loop through file 100 characters at a time --->
<cfloop file="#fileName#" index="chars" characters="100">
<!--- Do stuff with line here --->
...
</cfloop>

More Stories By Ben Forta

Ben Forta is Adobe's Senior Technical Evangelist. In that capacity he spends a considerable amount of time talking and writing about Adobe products (with an emphasis on ColdFusion and Flex), and providing feedback to help shape the future direction of the products. By the way, if you are not yet a ColdFusion user, you should be. It is an incredible product, and is truly deserving of all the praise it has been receiving. In a prior life he was a ColdFusion customer (he wrote one of the first large high visibility web sites using the product) and was so impressed he ended up working for the company that created it (Allaire). Ben is also the author of books on ColdFusion, SQL, Windows 2000, JSP, WAP, Regular Expressions, and more. Before joining Adobe (well, Allaire actually, and then Macromedia and Allaire merged, and then Adobe bought Macromedia) he helped found a company called Car.com which provides automotive services (buy a car, sell a car, etc) over the Web. Car.com (including Stoneage) is one of the largest automotive web sites out there, was written entirely in ColdFusion, and is now owned by Auto-By-Tel.

Comments (1) View Comments

Share your thoughts on this story.

Add your comment
You must be signed in to add a comment. Sign-in | Register

In accordance with our Comment Policy, we encourage comments that are on topic, relevant and to-the-point. We will remove comments that include profanity, personal attacks, racial slurs, threats of violence, or other inappropriate material that violates our Terms and Conditions, and will block users who make repeated violations. We ask all readers to expect diversity of opinion and to treat one another with dignity and respect.


Most Recent Comments
turbotad 07/02/09 11:42:00 PM EDT

Question: I'm pretty new to ColdFusion, but am more experienced running J2EE type boxes. I'm trying to set up a ColdFusion dev server on a VM with limited memory, and I'm trying to trim it back so that it doesn't pork out and use every bit of memory on any computer within a 10 mile radius. I.e. trying to get it so that it perhaps doesn't fire up all of the Flash remoting servlets or other things I don't need for basic CF functionality, in hopes that this might trim back the RAM usage. Any help you might be able to be on this?