Installation guide

4.5.4 CFDEBUGGER

CFDEBUGGER is a CFML tag introduced by BlueDragon that adds a powerful new weapon

in CFML debugging. In simple terms, it writes a trace to a log file indicating each CFML

line of code that's been executed.

Consider the following simplified example of its use:

This two-line template will create an entry in a file named trace.log (as indicated in the

LOGFILE attribute) with the following info:

#0: CFDEBUGGER trace started @ 19/Aug/2003 15:03.19

#1: active.file=C:/Inetpub/wwwroot/regression/cfdebugger.cfm

#2: tag.end=CFDEBUGGER; L/C=(1,1);

File=C:/Inetpub/wwwroot/regression/cfdebugger.cfm

#3: tag.start=CFSET; L/C=(2,1);

File=C:/Inetpub/wwwroot/regression/cfdebugger.cfm

#4: tag.end=CFSET; L/C=(2,1);

File=C:/Inetpub/wwwroot/regression/cfdebugger.cfm

#5: file.end=C:/Inetpub/wwwroot/regression/cfdebugger.cfm

#6: Session Ended

Note that it indicates the time the template was run and the template's name. More

important, the trace shows, for each CFML tag it encounters, its start and end lines in the

given template.

For more information on the

CFDEBUGGER tag, see the November 2003 ColdFusion

Developers Journal article on the subject:

http://www.sys-con.com/coldfusion/article.cfm?id=679

4.5.5 CFFORWARD

CFFORWARD is a tag introduced by BlueDragon that allows you to do a “server-side

redirect” to another CFML page, a Java servlet, or a JavaServer Page (JSP). In a “client-

side redirect,” which is done using the

CFLOCATION tag, a response is sent to the browser

telling it to send in a new request for a specified URL. In contrast,

CFFORWARD processing

is handled completely on the server.

The advantages of

CFFORWARD over CFLOCATION are:

• There is no need for extra messaging between the server and browser.

• Variables in the

URL, FORM, and REQUEST scopes are available to the target of the

CFFORWARD tag.

BlueDragon 6.1 CFML Compatibility and Reference Guide 25