ActionScript: The Definitive Guide

Name

XML.send( ) Method — send XML source code to a script

Availability

Flash 5

Synopsis

XMLdoc.send(URL, window)

Arguments

URL

A string specifying the location of a script or application to which XMLdoc should be sent.

window

A required string, specifying the name of the browser window or frame into which to load the script’s response. May be a custom name or one of the four presets: "_blank", "_ parent", "_self", or "_top". For details, see the description of the window settings under the global getURL( ) function.

Description

The send( ) method converts XMLdoc into a string of XML source code and sends that code in an HTTP request to the script or application residing at URL. The script or application is expected to process the XML in some way and optionally return a response—normally a web page—to the browser, which displays it in window. Note that the response is not caught by Flash but by the browser; use sendAndLoad( ) to catch the response within Flash.

When XML.send( ) is invoked from the Flash Player running in a browser, XMLdoc is sent via the POST method. When XML.send( ) is invoked from the Flash Player running as a standalone application, XMLdoc is sent via the GET method. The server application receiving the posted XML string must be able to access the raw POST data of the HTTP request directly and should not attempt to parse it as normal name/value pairs. In Perl, the data in a POST request is available from STDIN, and may be extracted and stored in, say, $buffer as follows: ...