ActionScript® 3.0 Reference for the Adobe® Flash® Platform
Home  |  Show Packages and Classes List |  Packages  |  Classes  |  What's New  |  Index  |  Appendixes
com.adobe.icc.services.external 

IExternalDataService  - AS3 Asset Composer

Packagecom.adobe.icc.services.external
Interfacepublic interface IExternalDataService extends IEventDispatcher

Language Version: ActionScript 3.0
Product Version: Asset Composer Building Block 9.5
Runtime Versions: AIR (unsupported), Flash Player 9, Flash Player 10

Defines a service for reading data external to the service itself (i.e. external to the web server hosting the application).



Public Methods
 MethodDefined By
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registers an event listener object with an EventDispatcher object so that the listener receives notification of an event.
IEventDispatcher
 Inherited
Dispatches an event into the event flow.
IEventDispatcher
  
Load the referenced external URL as binary data.
IExternalDataService
 Inherited
Checks whether the EventDispatcher object has any listeners registered for a specific type of event.
IEventDispatcher
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Removes a listener from the EventDispatcher object.
IEventDispatcher
 Inherited
Checks whether an event listener is registered with this EventDispatcher object or any of its ancestors for the specified event type.
IEventDispatcher
Method Detail

getObject

()method
public function getObject(url:String):com.adobe.icc.token:IAsyncToken

Language Version: ActionScript 3.0
Product Version: Asset Composer Building Block 9.5
Runtime Versions: AIR (unsupported), Flash Player 9, Flash Player 10

Load the referenced external URL as binary data. Supported schemes are the standard JVM URL schemes such as HTTP, FTP, file:///, etc., as well as file:// (to fetch data from a local file, i.e. the same server as the application).

Note: An exception is not thrown if the URL appears valid but the referenced resource cannot be read. In this case, the operation is deemed successful but null is returned instead of the bytes.

Parameters

url:String — The absolute URL from which to retrieve the data.

Returns
com.adobe.icc.token:IAsyncToken — A ByteArray containing the binary data retrieved or null if the URL was syntactically valid but the data could not be read from the resource (e.g. the resource doesn't exist).

Throws
Error — If the URL is syntactically incorrect, relative or not supported.