forward(theurl)

Last updated October 20, 2003

author

Description:
This UDF performs a serverside redirection through getPageContext(). This redirect must be to a relative location on the server. Unlike <cflocation>, this UDF does not send a 302 header to the browser to ask for a redirect - instead, the Coldfusion server stops executing the current page and starts executing the new page; this is done by accessing the J2EE backend behind Coldfusion MX with the use of the internal function getPageContext().
For furthering information on accessing the J2EE backend, see:
http://www.macromedia.com/devnet/mx/coldfusion/articles/java.html
Also, note that using this function (or the getPageContext().forward() function) when you have data in the Form scope throws the java err.io.short_read error in Coldfusion MX versions eariler then Update Release 3. More information:
http://www.macromedia.com/support/coldfusion/releasenotes/mx/releasenotes_mx_updater01.html
(Scroll down to CFML Function-Related Issues)