User Guide

The HTTP API 47
MMHttp.getFileCallback()
Description
This function gets the file at the specified URL, saves it in the Configuration/Temp folder inside
the Dreamweaver application folder, and then calls the specified function with the request ID and
reply result. When saving the file locally, Dreamweaver automatically creates
subfolders that mimic the folder structure of the server; for example, if the specified file is at
www.dreamcentral.com/people/index.html, Dreamweaver stores the index.html file in the People
folder inside the www.dreamcentral.com folder.
Arguments
callbackFunction
, URL, {prompt}, {saveURL}, {titleBarLabel}
• The callbackFunction argument is the name of the JavaScript function to call when the
HTTP request is complete.
• The URL argument is an absolute URL on a web server; if http:// is omitted from the URL,
Dreamweaver assumes HTTP protocol.
• The prompt argument, which is optional, is a Boolean value that specifies whether to prompt
the user to save the file. If
saveURL argument specifies a location outside the Configuration/
Temp folder, a
prompt value of false is ignored for security reasons.
• The saveURL argument, which is optional, is the location on the user’s hard disk where the file
should be saved, which is expressed as a file:// URL. If prompt is a
true value or saveURL is
outside the Configuration/Temp folder, the user can override
saveURL in the Save dialog box.
• The titleBarLabel argument, which is optional, is the label that should appear in the title
bar of the Save dialog box.
Returns
An object that represents the reply from the server. The data property of this object is a string
that contains the location where the file was saved, which is expressed as a file:// URL. Normally
the
statusCode property of the object contains the status code that is received from the server.
However, if a disk error occurs while Dreamweaver is saving the file on the local drive, the
statusCode property contains an integer that represents an error code. See MMHttp.getFile() for
a list of possible error codes.
MMHttp.getText()
Availability
Macromedia Dreamweaver UltraDev 4, enhanced in Dreamweaver MX.
Description
Retrieves the contents of the document at the specified URL.
Arguments
URL
, {serverScriptsFolder}
• The URL argument is an absolute URL on a web server. If http:// is omitted from the URL,
Dreamweaver assumes HTTP protocol.
000_DW_API_Print.book Page 47 Wednesday, August 20, 2003 9:14 AM