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

Catalog  - AS3 ADEP Composite Application

Packagecom.adobe.mosaic.mxml
Classpublic class Catalog
InheritanceCatalog Inheritance FrameworkInitializer
Implements ICatalogSpecifier, IMXMLObject

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Experience Services - Composite Application Framework 10
Runtime Versions: AIR 2.6, Flash Player 10.2

The Catalog mxml component is a representation of the Composite Application Framework SDK ICatalog. This component, when used with the ServerSession and Application components, configures a composite application Catalog for use within an Application and is the location and reference repository for all Tile and Service components. A Catalog contains a reference to a composite application ICatalog via the "catalogNode" property.

View the examples

Related API Elements



Public Properties
 PropertyDefined By
  catalogNode : ICatalog
[read-only] The underlying Composite Application Framework SDK ICatalog.
Catalog
  loaded : Boolean
[read-only] Checks if the underlying ICatalog is instantiated.
Catalog
  name : String
The name set of the composite application catalog.
Catalog
  serverSession : ServerSession
The ServerSession associated with this composite application catalog.
Catalog
  session : ISession
[read-only] The ISession associated with this composite application catalog from the Experience Server.
Catalog
Public Methods
 MethodDefined By
  
Constructor.
Catalog
  
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
[override] Overridden EventDispatcher addEventListener.
Catalog
  
Implementation of IMXMLObject initialized.
Catalog
Events
 Event Summary Defined By
  The catalogLoadEventFailure defines a failure notification of an attempt to load an CatalogCatalog
  The catalogLoadEventSuccess defines a successful notification of loading a CatalogCatalog
Property Detail

catalogNode

property
catalogNode:ICatalog  [read-only]

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Experience Services - Composite Application Framework 10
Runtime Versions: AIR 2.6, Flash Player 10.2

The underlying Composite Application Framework SDK ICatalog.



Implementation
    public function get catalogNode():ICatalog

Related API Elements

loaded

property 
loaded:Boolean  [read-only]

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Experience Services - Composite Application Framework 10
Runtime Versions: AIR 2.6, Flash Player 10.2

Checks if the underlying ICatalog is instantiated.



Implementation
    public function get loaded():Boolean

name

property 
name:String

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Experience Services - Composite Application Framework 10
Runtime Versions: AIR 2.6, Flash Player 10.2

The name set of the composite application catalog.



Implementation
    public function get name():String
    public function set name(value:String):void

serverSession

property 
serverSession:ServerSession

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Experience Services - Composite Application Framework 10
Runtime Versions: AIR 2.6, Flash Player 10.2

The ServerSession associated with this composite application catalog.



Implementation
    public function get serverSession():ServerSession
    public function set serverSession(value:ServerSession):void

Related API Elements

session

property 
session:ISession  [read-only]

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Experience Services - Composite Application Framework 10
Runtime Versions: AIR 2.6, Flash Player 10.2

The ISession associated with this composite application catalog from the Experience Server.



Implementation
    public function get session():ISession

Related API Elements

Constructor Detail

Catalog

()Constructor
public function Catalog()

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Experience Services - Composite Application Framework 10
Runtime Versions: AIR 2.6, Flash Player 10.2

Constructor.

Method Detail

addEventListener

()method
override public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Experience Services - Composite Application Framework 10
Runtime Versions: AIR 2.6, Flash Player 10.2

Overridden EventDispatcher addEventListener. Registers an event listener object with an EventDispatcher object so that the listener receives notification of an event. You can register event listeners on all nodes in the display list for a specific type of event, phase, and priority.

After you successfully register an event listener, you cannot change its priority through additional calls to addEventListener(). To change a listener's priority, you must first call removeListener(). Then you can register the listener again with the new priority level.

Keep in mind that after the listener is registered, subsequent calls to addEventListener() with a different type or useCapture value result in the creation of a separate listener registration. For example, if you first register a listener with useCapture set to true, it listens only during the capture phase. If you call addEventListener() again using the same listener object, but with useCapture set to false, you have two separate listeners: one that listens during the capture phase and another that listens during the target and bubbling phases.

You cannot register an event listener for only the target phase or the bubbling phase. Those phases are coupled during registration because bubbling applies only to the ancestors of the target node.

If you no longer need an event listener, remove it by calling removeEventListener(), or memory problems could result. Event listeners are not automatically removed from memory because the garbage collector does not remove the listener as long as the dispatching object exists (unless the useWeakReference parameter is set to true).

Copying an EventDispatcher instance does not copy the event listeners attached to it. (If your newly created node needs an event listener, you must attach the listener after creating the node.) However, if you move an EventDispatcher instance, the event listeners attached to it move along with it.

If the event listener is being registered on a node while an event is being processed on this node, the event listener is not triggered during the current phase but can be triggered during a later phase in the event flow, such as the bubbling phase.

If an event listener is removed from a node while an event is being processed on the node, it is still triggered by the current actions. After it is removed, the event listener is never invoked again (unless registered again for future processing).

Parameters

type:String — The type of event.
 
listener:Function — The listener function that processes the event. This function must accept an Event object as its only parameter and must return nothing, as this example shows:
function(evt:Event):void

The function can have any name.

 
useCapture:Boolean (default = false)Determines whether the listener works in the capture phase or the target and bubbling phases. If useCapture is set to true, the listener processes the event only during the capture phase and not in the target or bubbling phase. If useCapture is false, the listener processes the event only during the target or bubbling phase. To listen for the event in all three phases, call addEventListener twice, once with useCapture set to true, then again with useCapture set to false.
 
priority:int (default = 0) — The priority level of the event listener. The priority is designated by a signed 32-bit integer. The higher the number, the higher the priority. All listeners with priority n are processed before listeners of priority n-1. If two or more listeners share the same priority, they are processed in the order in which they were added. The default priority is 0.
 
useWeakReference:Boolean (default = false) — Determines whether the reference to the listener is strong or weak. A strong reference (the default) prevents your listener from being garbage-collected. A weak reference does not.

Class-level member functions are not subject to garbage collection, so you can set useWeakReference to true for class-level member functions without subjecting them to garbage collection. If you set useWeakReference to true for a listener that is a nested inner function, the function will be garbage-collected and no longer persistent. If you create references to the inner function (save it in another variable) then it is not garbage-collected and stays persistent.

initialized

()method 
public function initialized(document:Object, id:String):void

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Experience Services - Composite Application Framework 10
Runtime Versions: AIR 2.6, Flash Player 10.2

Implementation of IMXMLObject initialized.

Parameters

document:Object — Specifies the document object.
 
id:String — Specifies the MXML ID of the string.
Event Detail

catalogLoadEventFailure

Event
Event Object Type: com.adobe.mosaic.om.events.CatalogLoadEvent
property CatalogLoadEvent.type = com.adobe.mosaic.om.events.CatalogLoadEvent.FAILURE

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Experience Services - Composite Application Framework 10
Runtime Versions: AIR 2.6, Flash Player 10.2

The catalogLoadEventFailure defines a failure notification of an attempt to load an Catalog

The message type sent when a catalog fails to load.

catalogLoadEventSuccess

Event  
Event Object Type: com.adobe.mosaic.om.events.CatalogLoadEvent
property CatalogLoadEvent.type = com.adobe.mosaic.om.events.CatalogLoadEvent.SUCCESS

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Experience Services - Composite Application Framework 10
Runtime Versions: AIR 2.6, Flash Player 10.2

The catalogLoadEventSuccess defines a successful notification of loading a Catalog

The message type sent when a catalog is loaded successfully.
This example demonstrates the component declaration for Catalog
     
     <fx:Declarations>
         <mosaic:ServerSession id="myServer"
                               openSessionEventSuccess="myServer_connectedHandler(event)" 
                               openSessionEventFailure="myServer_faultHandler(event)"                              
                               url="{_serverUrl}" />
         <mosaic:Application  id="myApp"
                              loadApplicationEventSuccess="myApp_loadApplicationEventSuccessHandler(event)"
                              loadApplicationEventFailure="myApp_loadApplicationEventFailureHandler(event)">
             <mosaic:catalogs>
                 <mosaic:Catalog id="sampleCatalog" 
                                 name="sample_catalog"
                                 catalogLoadEventSuccess="myCatalogSuccess(event)"
                                 catalogLoadEventFailure="myCatalogFail(event)"
                                 serverSession="{myServer}"/>
             </mosaic:catalogs>
         </mosaic:Application>
     </fx:Declarations>