Package | com.adobe.icomm.assetplacement.model |
Class | public final class PackageDefinitionLoader |
Inheritance | PackageDefinitionLoader ![]() |
Language Version: | ActionScript 3.0 |
Product Version: | Asset Placement Building Block 9.5 |
Runtime Versions: | AIR 1.0, Flash Player 9, Flash Player 10 |
The PackageDefinition
object loads the package definition file (package.xml) in a
non-blocking operation. The PackageDefinitionLoader uses an eventListener/eventDispatcher mechanism
to get a reference to the PackageDefinition object, in order to ensure:
- That every caller gets access to the same object (to prevent redundant loading of the package.xml file); and
- That the package is fully loaded before a caller makes use of it.
In order to get a reference to the PackageDefinition object, add an event listener for the
PackageDefinitionReadyEvent and make a call to getPackageDefinition()
. When
the PackageDefinition object is ready for use, the listener will be called. Add an event listener for the
PackageDefinitionLoadFailed event to get notification that the package definition failed to load.
Note: the PackageDefinitionReadyEvent listener should be removed once the event fires; if it is not removed the event may fire multiple times when other requesters ask for the PackageDefinition object.
Related API Elements
com.adobe.icomm.assetplacement.model.PackageDefinitionReadyEvent
com.adobe.icomm.assetplacement.model.PackageDefinitionLoadFailedEvent
Method | Defined By | ||
---|---|---|---|
![]() |
Indicates whether an object has a specified property defined. | Object | |
![]() |
Indicates whether an instance of the Object class is in the prototype chain of the object specified
as the parameter. | Object | |
![]() |
Indicates whether the specified property exists and is enumerable. | Object | |
![]() |
Sets the availability of a dynamic property for loop operations. | Object | |
![]() |
Returns the string representation of this object, formatted according to locale-specific conventions. | Object | |
![]() |
Returns the string representation of the specified object. | Object | |
![]() |
Returns the primitive value of the specified object. | Object |
public function init():void { PackageDefinitionLoader.addEventListener(PackageDefinitionReadyEvent.PACKAGE_DEFINITION_READY, onPackageDefinitionReady); PackageDefinitionLoader.addEventListener(PackageDefinitionLoadFailedEvent.PACKAGE_DEFINITION_LOAD_FAILED, onPackageDefinitionLoadFailed); PackageDefinitionLoader.readyPackageDefinition(); } public function onPackageDefinitionReady(event:PackageDefinitionReadyEvent):void { // Once we get the ready event, we don't want to listen for it anymore PackageDefinitionLoader.removeEventListener(PackageDefinitionReadyEvent.PACKAGE_DEFINITION_READY, onPackageDefinitionReady); PackageDefinitionLoader.removeEventListener(PackageDefinitionLoadFailedEvent.PACKAGE_DEFINITION_LOAD_FAILED, onPackageDefinitionLoadFailed); var packageDef:PackageDefinition = event.packageDefinition; } public function onPackageDefinitionLoadFailed(event:PackageDefinitionLoadFailedEvent):void { PackageDefinitionLoader.removeEventListener(PackageDefinitionReadyEvent.PACKAGE_DEFINITION_READY, onPackageDefinitionReady); PackageDefinitionLoader.removeEventListener(PackageDefinitionLoadFailedEvent.PACKAGE_DEFINITION_LOAD_FAILED, onPackageDefinitionLoadFailed); var error:String = event.error; }
Thu Dec 6 2018, 01:12 PM -08:00