Packageflash.net
Classpublic final class URLRequestMethod
InheritanceURLRequestMethod Inheritance Object

Language version: ActionScript 3.0
Runtime version: 

The URLRequestMethod class provides values that specify whether the URLRequest object should use the POST method or the GET method when sending data to a server.

View the examples.

See also

URLRequest
URLVariables


Public Properties
 PropertyDefined by
 Inheritedconstructor : Object
A reference to the class object or constructor function for a given object instance.
Object
 Inheritedprototype : Object
[static] A reference to the prototype object of a class or function object.
Object
Public Methods
 MethodDefined by
 Inherited
Indicates whether an object has a specified property defined.
Object
 Inherited
Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.
Object
 Inherited
Indicates whether the specified property exists and is enumerable.
Object
 Inherited
Sets the availability of a dynamic property for loop operations.
Object
 Inherited
Returns the string representation of this object, formatted according to locale-specific conventions.
Object
 Inherited
Returns the string representation of the specified object.
Object
 Inherited
Returns the primitive value of the specified object.
Object
Public Constants
 ConstantDefined by
  DELETE : String = "DELETE"
[static] Specifies that the URLRequest object is a DELETE.
URLRequestMethod
  GET : String = "GET"
[static] Specifies that the URLRequest object is a GET.
URLRequestMethod
  HEAD : String = "HEAD"
[static] Specifies that the URLRequest object is a HEAD.
URLRequestMethod
  OPTIONS : String = "OPTIONS"
[static] Specifies that the URLRequest object is OPTIONS.
URLRequestMethod
  POST : String = "POST"
[static] Specifies that the URLRequest object is a POST.
URLRequestMethod
  PUT : String = "PUT"
[static] Specifies that the URLRequest object is a PUT.
URLRequestMethod
Constant detail
DELETEconstant
public static const DELETE:String = "DELETE"

Language version: ActionScript 3.0
Runtime version: AIR 1.0

Specifies that the URLRequest object is a DELETE.

GETconstant 
public static const GET:String = "GET"

Language version: ActionScript 3.0
Runtime version: 

Specifies that the URLRequest object is a GET.

HEADconstant 
public static const HEAD:String = "HEAD"

Language version: ActionScript 3.0
Runtime version: AIR 1.0

Specifies that the URLRequest object is a HEAD.

OPTIONSconstant 
public static const OPTIONS:String = "OPTIONS"

Language version: ActionScript 3.0
Runtime version: AIR 1.0

Specifies that the URLRequest object is OPTIONS.

POSTconstant 
public static const POST:String = "POST"

Language version: ActionScript 3.0
Runtime version: 

Specifies that the URLRequest object is a POST.

Note: For content running in Adobe AIR, when When using the navigateToURL() function, the runtime treats a URLRequest that uses the POST method (one that has its method property set to URLRequestMethod.POST) as using the GET method.

PUTconstant 
public static const PUT:String = "PUT"

Language version: ActionScript 3.0
Runtime version: AIR 1.0

Specifies that the URLRequest object is a PUT.

Examples
examples\URLRequestMethodExample
The following example loads and displays the data found in a local text file. It also traces event handling information.

Note:To run this example, put a file named example.txt in the same directory as your SWF file. That file should be a simple text file containing a few words or lines of text.

The example code does the following:

  1. The constructor function creates a URLLoader instance named loader.
  2. The loader object is passed to the configureListeners() method, which adds listeners for each of the supported URLLoader events.
  3. A URLRequest instance named request is created, which specifies name of the file to be loaded.
  4. The method property of the request is set to URLRequestMethod.POST.
  5. The request object is then passed to loader.load(), which loads the text file.
  6. When the URLLoader has finished loading the text file the Event.COMPLETE event fires, triggering the completeHandler() method. The completeHandler() method simply traces the data property, the contents of the text file.


package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.net.*;

    public class URLRequestMethodExample extends Sprite {
		private var loader:URLLoader;
		
        public function URLRequestMethodExample() {
            loader = new URLLoader();
            configureListeners(loader);

            var request:URLRequest = new URLRequest("example.txt");
            
            request.method = URLRequestMethod.POST;
            loader.load(request);
        }

        private function configureListeners(dispatcher:IEventDispatcher):void {
            dispatcher.addEventListener(Event.COMPLETE, completeHandler);
            dispatcher.addEventListener(Event.OPEN, openHandler);
            dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
            dispatcher.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler);
            dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
        }

        private function completeHandler(event:Event):void {
            var loader:URLLoader = URLLoader(event.target);
            trace("completeHandler: " + loader.data);
        }

        private function openHandler(event:Event):void {
            trace("openHandler: " + event);
        }

        private function progressHandler(event:ProgressEvent):void {
            trace("progressHandler loaded:" + event.bytesLoaded + " total: " + event.bytesTotal);
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }

        private function httpStatusHandler(event:HTTPStatusEvent):void {
            trace("httpStatusHandler: " + event);
        }

        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }
    }
}