Specifications

Chapter 23284
MMHttp.getFileCallback()
Description
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 directory structure of the server; for example, if the specified file is at
http://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}
• callbackFunction is the name of the JavaScript function to call when the HTTP request is
complete.
• URL is an absolute URL on a web server; if http:// is omitted from the URL, Dreamweaver MX
assumes HTTP protocol.
• prompt is a Boolean value that specifies whether to prompt the user to save the file. If saveURL
is outside the Configuration/Temp folder, a
prompt value of false is ignored for security
reasons.
• saveURL 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
true or saveURL is outside the Configuration/Temp
folder, the user can override
saveURL in the Save dialog box.
• titleBarLabel 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()”
on page 282 for a list of possible error codes.
MMHttp.getText()
Description
Retrieves the contents of the document at the specified URL.
Arguments
URL
URL
is an absolute URL on a web server. If http:// is omitted from the URL, Dreamweaver MX
assumes HTTP protocol.
Returns
An object that represents the reply from the server. The data property of this object is a string
that contains the contents of the document.