| Package | flash.net |
| Class | public final class URLLoaderDataFormat |
| Inheritance | URLLoaderDataFormat Object |
| Constant | Defined By | ||
|---|---|---|---|
| BINARY : String = "binary" [static]
Specifies that downloaded data is received as raw binary data.
| URLLoaderDataFormat | ||
| TEXT : String = "text" [static]
Specifies that downloaded data is received as text.
| URLLoaderDataFormat | ||
| VARIABLES : String = "variables" [static]
Specifies that downloaded data is received as URL-encoded variables.
| URLLoaderDataFormat | ||
| BINARY | Constant |
public static const BINARY:String = "binary"
Specifies that downloaded data is received as raw binary data.
| TEXT | Constant |
public static const TEXT:String = "text"
Specifies that downloaded data is received as text.
| VARIABLES | Constant |
public static const VARIABLES:String = "variables"
Specifies that downloaded data is received as URL-encoded variables.
loader and a URLRequest
instance named request, which is the location and name of the file to be loaded.loader object is passed to the configureListeners() method, which adds
listeners for each of the supported URLLoader events:
completeHandler(): listens for the complete event, which is dispatched
after TextFile.txt has successfully loaded.openHandler(): listens for the open event, dispatched upon start of the
download (to the player) of TextFile.txt.progressHandler(): listens for the progress events, dispatched when data
is received as the download operation progresses.securityErrorHandler(): listens for securityError events, which would be
dispatched if the text file was accessed with the wrong local playback security setting.httpStatusHandler(): listens for httpStatusHandler events, which will not be
dispatched in this case since TextFile.txt is local.ioErrorHandler(): listens for ioError events, which would happen only
if there were a serious problem with the file, such as if it were missing.request object is then passed to the loader.load() method, which loads the text file
into memory using a DisplayObject object.Notes:
package {
import flash.display.Sprite;
import flash.events.*;
import flash.net.*;
public class URLLoaderDataFormatExample extends Sprite {
private var source:String = "TextFile.txt";
private var dataFormat:String = URLLoaderDataFormat.TEXT;
public function URLLoaderDataFormatExample () {
var loader:URLLoader = new URLLoader();
loader.dataFormat = dataFormat;
configureListeners(loader);
var request:URLRequest = new URLRequest(source);
try {
loader.load(request);
} catch (error:Error) {
trace("Error loading requested document: " + source);
}
}
private function configureListeners(dispatcher:URLLoader):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);
switch(loader.dataFormat) {
case URLLoaderDataFormat.TEXT :
trace("completeHandler (text): " + loader.data);
break;
case URLLoaderDataFormat.BINARY :
trace("completeHandler (binary): " + loader.data);
break;
case URLLoaderDataFormat.VARIABLES :
trace("completeHandler (variables): " + loader.data);
break;
}
}
private function httpStatusHandler(event:Event):void {
trace("httpStatusHandler: " + event);
}
private function ioErrorHandler(event:IOErrorEvent):void {
trace("ioErrorHandler: " + event);
}
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);
}
}
}