Package | flash.net |
Class | public final class URLLoaderDataFormat |
Inheritance | URLLoaderDataFormat ![]() |
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); } } }