Package | mx.data |
Class | public class Conflicts |
Inheritance | Conflicts ArrayList EventDispatcher Object |
Language Version: | ActionScript 3.0 |
Product Version: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
You cannot commit any changes until all conflicts are resolved.
At that point, the DataService.commit()
method will call remove
all of these conflicts.
If you attempt to resolve a Conflict which was already resolved,
an error is thrown.
An instance of this class can be accessed from the
DataService.conflicts
property.
Because this class implements IList
it can be used with an
ArrayCollection.list
property,
allowing it to participate as a data source for user interface controls and data binding.
Default MXML Propertysource
Property | Defined By | ||
---|---|---|---|
constructor : Object
A reference to the class object or constructor function for a given object instance. | Object | ||
length : int [override] [read-only]
The length of the source Array. | Conflicts | ||
prototype : Object [static]
A reference to the prototype object of a class or function object. | Object | ||
resolved : Boolean [read-only]
Indicates if there are any unresolved conflicts in the list. | Conflicts | ||
source : Array [override]
An Array of Conflict objects. | Conflicts | ||
uid : String
Provides access to the unique id for this list. | ArrayList |
Method | Defined By | ||
---|---|---|---|
Conflicts(dataService:ConcreteDataService = null)
Constructor. | Conflicts | ||
This is a convenience method that iterates all of the conflicts within
this list and invokes the Conflict.acceptClient() method. | Conflicts | ||
This is a convenience method that iterates all of the conflicts within
this list and invokes the Conflict.acceptClient() method. | Conflicts | ||
Adds a list of items to the current list, placing them at the end of
the list in the order they are passed. | ArrayList | ||
Adds a list of items to the current list, placing them at the position
index passed in to the function. | ArrayList | ||
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. | EventDispatcher | ||
Add the specified item to the end of the list. | ArrayList | ||
Add the item at the specified index. | ArrayList | ||
Dispatches an event into the event flow. | EventDispatcher | ||
If there is an outstanding conflict for the given object, returns that
conflict. | Conflicts | ||
Get the item at the specified index. | ArrayList | ||
Return the index of the item if it is in the list such that
getItemAt(index) == item. | ArrayList | ||
Checks whether the EventDispatcher object has any listeners registered for a specific type
of event. | EventDispatcher | ||
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 | ||
itemUpdated(item:Object, property:Object = null, oldValue:Object = null, newValue:Object = null):void
Notify the view that an item has been updated. | ArrayList | ||
Indicates whether the specified property exists and is enumerable. | Object | ||
raiseConflict(dataManager:DataManager, cause:DataMessage, serverObject:Object, conflictingProperties:Array):void
This method is used by the DataServiceAdapter implementation when it need to raise
a conflict because a change is in conflict with the server version. | Conflicts | ||
Remove all items from the list. | ArrayList | ||
Removes all resolved conflicts from this collection. | Conflicts | ||
Removes a listener from the EventDispatcher object. | EventDispatcher | ||
Removes the specified item from this list, should it exist. | ArrayList | ||
Remove the item at the specified index and return it. | ArrayList | ||
Place the item at the specified index. | ArrayList | ||
Sets the availability of a dynamic property for loop operations. | Object | ||
Return an Array that is populated in the same order as the IList
implementation. | ArrayList | ||
Returns the string representation of this object, formatted according to locale-specific conventions. | Object | ||
[override]
Returns a String representation of this Conflicts object. | Conflicts | ||
Returns the primitive value of the specified object. | Object | ||
Checks whether an event listener is registered with this EventDispatcher object or any of
its ancestors for the specified event type. | EventDispatcher |
length | property |
length:int
[read-only] [override] Language Version: | ActionScript 3.0 |
Product Version: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The length of the source
Array.
This property can be used as the source for data binding. When this property is modified, it dispatches the collectionChange
event.
Implementation
override public function get length():int
resolved | property |
resolved:Boolean
[read-only] Language Version: | ActionScript 3.0 |
Product Version: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Indicates if there are any unresolved conflicts in the list.
When this returns true
all conflicts have been resolved and
DataService.commit()
can be called without an error.
This property can be used as the source for data binding. When this property is modified, it dispatches the propertyChange
event.
Implementation
public function get resolved():Boolean
source | property |
source:Array
[override] Language Version: | ActionScript 3.0 |
Product Version: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
An Array of Conflict objects.
Implementation
override public function get source():Array
override public function set source(value:Array):void
Conflicts | () | Constructor |
public function Conflicts(dataService:ConcreteDataService = null)
Language Version: | ActionScript 3.0 |
Product Version: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Constructor.
ParametersdataService:ConcreteDataService (default = null ) — The DataService that caused the conflict.
|
acceptAllClient | () | method |
public function acceptAllClient():void
Language Version: | ActionScript 3.0 |
Product Version: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
This is a convenience method that iterates all of the conflicts within
this list and invokes the Conflict.acceptClient()
method.
Once completed this method will clear all of the conflicts in the list.
Calling this method will requeue each local change and update all
property values such that a subsequent call to
DataService.commit()
should succeed, allowing these changes
to override the current ones.
Related API Elements
acceptAllServer | () | method |
public function acceptAllServer():void
Language Version: | ActionScript 3.0 |
Product Version: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
This is a convenience method that iterates all of the conflicts within
this list and invokes the Conflict.acceptClient()
method.
Once completed this method will clear all of the conflicts in the list.
Calling this method removes the conflicting local change and applies the
property values found on each Conflict.serverObject
within
the list to each related local item.
Related API Elements
getConflict | () | method |
public function getConflict(item:Object):Conflict
Language Version: | ActionScript 3.0 |
Product Version: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
If there is an outstanding conflict for the given object, returns that conflict. Otherwise, returns null.
Parameters
item:Object — The object to check for conflicts.
|
Conflict — A Conflict object if there is a conflict, and null otherwise.
|
raiseConflict | () | method |
public function raiseConflict(dataManager:DataManager, cause:DataMessage, serverObject:Object, conflictingProperties:Array):void
Language Version: | ActionScript 3.0 |
Product Version: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
This method is used by the DataServiceAdapter implementation when it need to raise a conflict because a change is in conflict with the server version.
Parameters
dataManager:DataManager — The DataManager instance.
| |
cause:DataMessage — The DataMessage object that caused the conflict.
The cause should
be the pending change which is in conflict with the server.
| |
serverObject:Object — The value of the server object whose property was to be changed.
| |
conflictingProperties:Array — An Array of the names of the properties
that were in conflict between the client change and the remote item state.
All property names are String values and exist in the public namespace.
|
removeAllResolved | () | method |
public function removeAllResolved():void
Language Version: | ActionScript 3.0 |
Product Version: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Removes all resolved conflicts from this collection.
toString | () | method |
override public function toString():String
Language Version: | ActionScript 3.0 |
Product Version: | Adobe Digital Enterprise Platform Data Services for Java EE 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Returns a String representation of this Conflicts object.
ReturnsString — A String representation of this Conflicts object.
|
Mon Nov 28 2011, 06:48 AM -08:00