Utility - AS3 / Startup Manager

The Startup Manager utility offers a solution to the problem of how to manage the asynchronous loading of Model resources during application startup. It supports loading order dependencies, and is progress-aware.

Key Functionality

In the context of the PureMVC framework, the application typically has a StartupCommand that manages the instantiation of essential actors like Proxies and Mediators. At this time, you may also want to prime the application with some resources, for example data, before allowing user interaction. This utility offers a way of doing that. It enables the application to do the following:

• State how the resource loading should be sequenced so that dependent resources are loaded in correct order.
• Be aware of the progress of the resource loading.
• Know when the resource loading is complete.
• Asset loading.

Changes in Version 1.6.1

This release is backward compatible.

• Method addResourceViaStartupProxy() of StartupMonitorProxy now registers the new StartupResourceProxy objects. For background, see  this post

Changes in Version 1.6

This release is backward compatible.

Within asset loader feature, in AssetFactory class:

• Support for .css urls as asset type Text, plus defaulting to type Text, hence reduced likelihood of 'unexpected url type' as an Error condition.
• Within StartupMonitorProxy class: new cleanup method, to remove StartupResourceProxy objects from proxy map; also, the reset method now includes this cleanup of SRP objects.

Changes in Version 1.5

This release is backward compatible.

• New class StartupManager has public consts, as an alternative to StartupMonitorProxy.
• Asset Loader feature; see API docs and  Startup for Assets demo.

Changes in Version 1.4

This release is backward compatible. A MultiCore version has been added, in the multicore source folder. Both swc's are included in the bin folder, be sure to use the one appropriate to your PureMVC version.

Otherwise in general, increased exposure of state and behaviour, to facilitate easier public access and easier adaptation by inheritance.

• In StartupMonitorProxy: public access to sendProgressNotification() and allResourcesLoaded();
• New addResourceViaStartupProxy() method;
• New getResourceViaStartupProxyName() method;
• Allow override of notification name for 'waiting for more resources';
• New jobId property, included as type on all sent notifications.
• In ResourceList: some vars changed from private to protected access;
• Now responsible for progress percentage calculation;
• New getResourceViaStartupProxyName() method.
• In RetryPolicy: increased exposure of state vars;
• Interface !IRetryPolicy has additional behaviour, to match that of RetryPolicy.
• In RetryParameters: some vars changed from private to protected access.

Changes in Version 1.3

• Added reset() method on StartupMonitorProxy;
• Added support for retry policy with automatic retries etc.;
• Added support for open-ended resource list. There are interfaces for retry policy and for resource list.

Migration from prior Versions

Version 1.3 breaks backward compatibility with the previous release. Migration is as follows, using the word 'monitor' for the instance of StartupMonitorProxy.

• Replace monitor.defaultTimeout = nn, by monitor.defaultRetryPolicy = new RetryPolicy(new RetryParameters(0,0,nn))
• RetryPolicy and RetryParameters are in the model package
• Review the API documentation to decide what to pass to RetryParameters
• Replace monitor.retryLoadResources() by monitor.tryToCompleteLoadResources()
• Remove LOAD_RESOURCES_REJECTED from notification interests and handling
• Additional notifications are: RETRYING_LOAD_RESOURCE and WAITING_FOR_MORE_RESOURCES.

See the latest version of StartupAsOrdered demo for example of use.

Changes in Version 1.2

• Refactored source into src folder

Changes in Version 1.1

• Cater for timeout.
• Provides better overall functionality.

Features in Version 1.0

• Initial release. Works with PureMVC 2.0
• Extracted from the StartupAsOrdered demo.