Conflict

Package	mx.data
Class	public class Conflict
Inheritance	Conflict Error Object
Implements	IExternalizable

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

Represents an error that has occurred due to an update operation. Conflicts are generated for many reasons. For example, another client has updated the same property of an item.

Conflicts are determined by both the remote destination and the local DataService. A conflict detected by the DataService is considered a local conflict. A conflict detected by the remote destination is a remote conflict.

Custom assemblers can generate a remote conflict for any operation when processing an update. Local conflicts are determined by the ConflictDetector object. To customize local conflict detection the ConflictDetector can be extended and assigned to the DataService.conflictDetector property.

All conflicts must be resolved before changes can be committed.

Public Properties

	Property		Defined By
		cause : DataMessage [read-only] The DataMessage object that caused the conflict.	Conflict
		causedByLocalCommit : Boolean [read-only] Contains true if this conflict resulted from commiting a local change to the remote destination, and false if it resulted from a pushed change conflicting with a local change.	Conflict
		clientObject : Object [read-only] The state of the client object (whose property was changed) at the time of the conflict.	Conflict
		constructor : Object A reference to the class object or constructor function for a given object instance.	Object
		destination : String [read-only] The destination for the data service of the item involved in this conflict.	Conflict
		errorID : int [read-only] Contains the reference number associated with the specific error message.	Error
		message : String Contains the message associated with the Error object.	Error
		name : String Contains the name of the Error object.	Error
		originalObject : Object [read-only] The state of the original client object before its properties were changed, as known at the time of the conflict.	Conflict
		propertyNames : Array [read-only] An Array of the names of the properties that were in conflict between the client change and the remote item state.	Conflict
		resolved : Boolean [read-only] Indicates whether this Conflict has been resolved (The acceptClient() or acceptServer() method has been called).	Conflict
		serverObject : Object [read-only] The value of the server object whose property was to be changed.	Conflict
		serverObjectDeleted : Boolean [read-only] When the serverObject property of this class is null, this property lets you know whether the server version is null because the item was deleted on the server (true) or because the item was removed from a fill that this client is subscribed to (false).	Conflict
		serverObjectReferencedIds : Object [read-only] If the serverObject has any properties with lazy="true", returns an Object that stores the referencedId Arrays for each lazily loaded property, using the property name as the lookup key value.	Conflict

Public Methods

	Method		Defined By
		acceptClient():void Requeues the current local changes and updates the property values such that a subsequent call to DataService.commit() should succeed, causing these changes to override the previous ones.	Conflict
		acceptServer():void Removes the conflicting local change and applies the property values found on the Conflict.serverObject property to the local item.	Conflict
		getStackTrace():String Returns the call stack for an error at the time of the error's construction as a string.	Error
		hasOwnProperty(name:String):Boolean Indicates whether an object has a specified property defined.	Object
		isPrototypeOf(theClass:Object):Boolean Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.	Object
		matches(otherConflict:Conflict):Boolean Checks if this conflict describes the same item as the item of the given conflict.	Conflict
		propertyIsEnumerable(name:String):Boolean Indicates whether the specified property exists and is enumerable.	Object
		readExternal(input:IDataInput):void	Conflict
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Sets the availability of a dynamic property for loop operations.	Object
		toLocaleString():String Returns the string representation of this object, formatted according to locale-specific conventions.	Object
		toString():String Returns a String representation of this Conflict object.	Conflict
		valueOf():Object Returns the primitive value of the specified object.	Object
		writeExternal(output:IDataOutput):void	Conflict

Public Constants

	Constant		Defined By
		NONE : String = "none" [static] Conflict mode constant representing zero conflict detection.	Conflict
		OBJECT : String = "object" [static] Conflict mode constant representing object level conflict detection.	Conflict
		PROPERTY : String = "property" [static] Conflict mode constant representing property level conflict detection.	Conflict

Property Detail

cause

property

cause:DataMessage [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

The DataMessage object that caused the conflict.

Implementation
public function get cause():DataMessage

causedByLocalCommit

property

causedByLocalCommit: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

Contains true if this conflict resulted from commiting a local change to the remote destination, and false if it resulted from a pushed change conflicting with a local change.

Implementation
public function get causedByLocalCommit():Boolean

clientObject

property

clientObject:Object [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

The state of the client object (whose property was changed) at the time of the conflict.

Implementation
public function get clientObject():Object

destination

property

destination:String [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

The destination for the data service of the item involved in this conflict.

Implementation
public function get destination():String

originalObject

property

originalObject:Object [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

The state of the original client object before its properties were changed, as known at the time of the conflict.

Implementation
public function get originalObject():Object

propertyNames

property

propertyNames:Array [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

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.

Implementation
public function get propertyNames():Array

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 whether this Conflict has been resolved (The acceptClient() or acceptServer() method has been called).

Implementation
public function get resolved():Boolean

Related API Elements

mx.data.Conflict.acceptServer()
mx.data.Conflict.acceptClient()

serverObject

property

serverObject:Object [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

The value of the server object whose property was to be changed.

Implementation
public function get serverObject():Object

serverObjectDeleted

property

serverObjectDeleted: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

When the serverObject property of this class is null, this property lets you know whether the server version is null because the item was deleted on the server (true) or because the item was removed from a fill that this client is subscribed to (false). This flag will return false if the serverObject property is not null.

Implementation
public function get serverObjectDeleted():Boolean

serverObjectReferencedIds

property

serverObjectReferencedIds:Object [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

If the serverObject has any properties with lazy="true", returns an Object that stores the referencedId Arrays for each lazily loaded property, using the property name as the lookup key value.

Implementation
public function get serverObjectReferencedIds():Object

Method Detail

acceptClient

()

method

public function acceptClient():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

Requeues the current local changes and updates the property values such that a subsequent call to DataService.commit() should succeed, causing these changes to override the previous ones.

Example ( How to use this example )

         private function conflictHandler(event:DataConflictEvent):void
         {
             if (acceptClientCheck.selected)
             {
                  event.conflict.acceptClient();
             }
             else
             {
                  event.conflict.acceptServer();
             }
         }

acceptServer

()

method

public function acceptServer():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 the conflicting local change and applies the property values found on the Conflict.serverObject property to the local item.

Example ( How to use this example )

         private function conflictHandler(event:DataConflictEvent):void
         {
             if (acceptClientCheck.selected)
             {
                  event.conflict.acceptClient();
             }
             else
             {
                  event.conflict.acceptServer();
             }
         }

matches

()

method

public function matches(otherConflict:Conflict):Boolean

Language Version:

ActionScript 3.0

Product Version:

Adobe Digital Enterprise Platform Data Services for Java EE 3.1

Runtime Versions:

Flash Player 9, AIR 1.5

Checks if this conflict describes the same item as the item of the given conflict.

Parameters

otherConflict:Conflict — the other conflict object to compare.

Returns

Boolean — true if both conflict objects reference the same managed item.

readExternal

()

method

public function readExternal(input:IDataInput):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

Parameters

input:IDataInput

toString

()

method

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 Conflict object.

Returns

String — A String representation of this Conflict object.

writeExternal

()

method

public function writeExternal(output:IDataOutput):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

Parameters

output:IDataOutput

Constant Detail

NONE

Constant

public static const NONE:String = "none"

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

Conflict mode constant representing zero conflict detection.

OBJECT

Constant

public static const OBJECT:String = "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

Conflict mode constant representing object level conflict detection.

PROPERTY

Constant

public static const PROPERTY:String = "property"

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

Conflict mode constant representing property level conflict detection.

Legal Notices | Online Privacy Policy

Conflict - AS3 ADEP Data Services

Classes x

cause

causedByLocalCommit

clientObject

destination

originalObject

propertyNames

resolved

serverObject

serverObjectDeleted

serverObjectReferencedIds

acceptClient

acceptServer

matches

readExternal

toString

writeExternal

NONE

OBJECT

PROPERTY