ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
mx.data 

DataManager  - AS3 ADEP Data Services

Paketmx.data
Klassepublic class DataManager
VererbungDataManager Inheritance Object
Implementiert IEventDispatcher
Unterklassen DataService, RPCDataManager

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Die DataManager-Klasse stellt eine Synchronisierungsfunktionalität mit Objekten für alle Instanzen eines festgelegten Datentyps auf dem Server bereit. Der DataManager stellt Synchronisierung, Vervielfältigung, Konflikterkennung, Änderungsverfolgung und Dienste ohne ständige Verbindung bereit.

Die DataManager-Klasse ist eine abstrakte Klasse. Normalerweise wird eine DataService-Instanz erstellt, die den DataManager erweitert, oder es werden eine oder mehrere RPCDataManager-Instanzen zusammen mit einer RPC-Dienstkomponente wie einer HTTPMultiService-, WebService- oder RemoteObject-Instanz erstellt.

Um Single Managed Objects abzurufen, werden die DataManager.getItem()- und DataManager.createItem()-Methoden verwendet.

Wenn eine zuvor gefüllte ArrayCollection nicht mehr benötigt wird oder die Elemente innerhalb dieser Sammlung keine Aktualisierungen mehr empfangen oder erstellen sollen, wird die DataManager.releaseCollection()-Methode aufgerufen.

Wenn ein vorher abgerufenes Element, das DataManager.getItem() oder DataManager.createItem() verwendet, nicht mehr gebraucht wird oder wenn es keine Aktualisierungen empfangen oder erstellen soll, wird die DataManager.releaseItem()-Methode aufgerufen. Die DataManager.createItem()- und DataManager.getItem()-Methoden geben eine ItemReference-Instanz zurück, die für eine bestimmte Instanz eines einzelnen verwalteten Objekts verwendet werden kann. Anders als bei der DataManager.releaseItem()-Methode löst das Aufrufen der ItemReference.releaseItem()-Methode eine bestimmte Instanz eines einzeln verwalteten Objekts aus. Die DataManager.releaseItem()-Methode löst das erste gefundene einzeln verwaltete Objekt aus, dessen Identität mit einer festgelegten Identität übereinstimmt. Dies ist normalerweise unproblematisch, solange die Anzahl der Aufrufe der DataManager.getItem()- und DataManager.createItem()-Methoden mit der Anzahl der Aufrufe der DataManager.releaseItem()-Methode übereinstimmt.

Eine Verbindung zum Remote-Ziel wird automatisch beim erstmaligen Aufrufen von Methoden erstellt, für die eine Verbindung erforderlich ist. Beispiel: Wenn Sie die DataManager.fill()-Methode oder die DataManager.commit()-Methode aufrufen, während nicht übernommene Aktualisierungen vorhanden sind, wird die DataManager-Instanz versuchen, eine Verbindung zum Remote-Ziel herzustellen. Um die Trennung einer DataManager-Instanz zu erzwingen, rufen Sie die DataManager.disconnect()-Methode auf. Die DataManager.disconnect()-Methode kann zum Entfernen der Remote-Zielressourcen verwendet werden, wenn diese nicht mehr erforderlich sind. Da andere Dienste möglicherweise die gleiche physische Verbindung verwenden, kann der Aufruf der DataManager.disconnect()-Methode die Verbindung beenden.

Die bindbare Eigenschaft connected zeigt den aktuellen Status der verknüpften DataManager-Verbindung an.

Jede DataManager-Instanz hat eine dataStore-Eigenschaft, die ein Objekt des Typs mx.data.DataStore zurückgibt. Dieses Objekt speichert die nicht übernommenen Änderungen für eine oder mehrere DataManager-Instanzen. Standardmäßig verwendet eine DataManager-Instanz die gleiche DataStore-Instanz gemeinsam mit anderen DataManager-Instanzen, wenn sie über verwaltete Verknüpfungseigenschaften verfügen und den gleichen Satz von Kanälen gemeinsam verwenden. Bei gemeinsamer Verwendung einer DataStore-Instanz übernimmt ein Aufruf der commit()-Methode für eine DataManager-Instanz die Änderungen für alle DataManager-Instanzen, die die gemeinsame DataStore-Instanz verwenden. Dadurch bleibt die Reihenfolge der Vorgänge erhalten, falls Abhängigkeiten zwischen den Änderungen in den verknüpften DataManager-Instanzen bestehen.

DataManager und DataStore lösen Ergebnis- und Fehlerereignisse für alle Vorgänge aus, die einen Remote-Aufruf erfordern. Hinweis: Wenn Sie zwei DataManager-Instanzen erstellen, die auf das gleiche Ziel verweisen, nutzen beide Instanzen die gleiche Sammlung von verwalteten Objekten gemeinsam und lösen den gleichen Satz an Ereignissen aus. Wenn Sie beispielsweise einer DataManager-Instanz für ein Ziel einen Ereignis-Listener hinzufügen und eine andere Instanz zum Starten eines Vorgangs verwenden, empfängt die erste DataManager-Instanz diese Ereignisse weiterhin. Jeder Vorgang, den Sie auf einem DataManager starten, gibt ein AsyncToken zurück. Sie können diesem Token einen Ereignis-Responder hinzufügen, um ein für diesen Vorgang spezifisches Ergebnisereignis zu empfangen. Dieser Ansatz erzeugt oft präziseren Code als das globale Hinzufügen eines Ergebnisses oder einer Fehlerereignisprozedur zu einem gegebenen Ziel.

Sie können Datenbindung bei Eigenschaften von verwalteten Objekten für eine DataManager-Instanz verwenden. Außerdem wird eine DataManager-Instanz ein „message“-Ereignis auslösen, wenn bei einem verwalteten Objekt ein Remote-Vorgang auftritt. Beispiel: Bei der Aktualisierung eines lokal verwalteten Elements durch einen Remote-Vorgang wird eine Meldung an alle DataManager-Instanzen ausgegeben, die das Element weiterhin verwalten. Diese Meldung wird als MessageEvent.MESSAGE-Ereignis gesendet.

Ein Konfliktereignis wird ausgelöst, wenn ein Konflikt entweder am Remote-Ziel als Reaktion auf eine von der DataManager-Instanz ausgeführte Änderung oder aufgrund einer eingegangenen Änderung, die einer lokalen nicht übernommenen Änderung widerspricht, erkannt wird. Sie können Konfliktereignisse verarbeiten, indem Sie auf DataConflictEvent.CONFLICT warten. Verwenden Sie Datenbindung zur Aktualisierung von Benutzeroberflächensteuerelementen, indem Sie die DataManager.conflicts.resolved-Eigenschaft einbinden.

Die DataManager-Klasse unterstützt die folgenden Datensynchronisierungskonfigurationsmodi:

  • autoCommit – Ist der Wert „true“, wird jede Änderung unmittelbar zum Remote-Ziel gesendet, sobald sie erkannt wird. Wenn der Wert false ist, müssen Sie einen expliziten Aufruf der commit()-Methode vornehmen. Verwenden Sie die bindbare DataManager.commitRequired-Eigenschaft, um zu bestimmen, ob nicht übernommene Änderungen vorhanden sind.
  • autoSyncEnabled – Dies betrifft alle Aufrufe der fill()-, getItem()- oder createItem()-Methoden und ermittelt, ob verwaltete Instanzen auf Änderungen warten, die von anderen Clients für diese Objekte erstellt wurden oder von der DataServiceTransaction-Server-Push-API am Remote-Ziel.
  • autoMerge – Steuert, ob von einem Remote-Ziel empfangene Änderungen unmittelbar angewendet werden oder in der Warteschlange verbleiben, bis die DataManager.merge()-Methode aufgerufen wird.

Die DataManager.revertChanges()-Methode wird zur Wiederherstellung des Zustands vor den Änderungen an einem bestimmten Element oder an allen Elementen verwendet. Wenn ein Fehler in einem Vorgang für ein Remote-Ziel auftritt, werden die übernommenen Änderungen in die Warteschlange für nicht übernommene Änderungen zurückgelegt, sodass die Daten mit den Remote-Zieldaten synchronisiert bleiben. Wenn die Änderungen fehlerhaft sind, wird normalerweise ein Aufruf von der DataManager.revertChanges()-Methode erstellt, um die Änderungen als Teil einer Fehlerprozedur rückgängig zu machen.

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
  adapter : DataServiceAdapter = null
Eine Instanz einer Klasse, die die Interaktion mit dem Server steuert.
DataManager
  autoCommit : Boolean
Zeigt an, ob Änderungen am lokalen Cache automatisch übernommen werden.
DataManager
  autoConnect : Boolean
Zeigt an, ob dieser Dienst versuchen sollte, eine Verbindung zu Vorgängen herzustellen, für die eine Verbindung erforderlich ist.
DataManager
  autoMerge : Boolean
Bei Festlegung als „false“ werden Änderungen, die vom Remote-Ziel an den Client gesendet wurden, nicht sofort angewendet.
DataManager
  autoSaveCache : Boolean
Sie können den lokalen Cache mit Daten und Änderungen auf der Festplatte speichern.
DataManager
  autoSyncEnabled : Boolean
Bei „true“ geben fill()-, createItem()- und getItem()-Anforderungen Elemente zurück, die auf Aktualisierungen warten, die an diesen Elementen vom Remote-Ziel durchgeführt wurden.
DataManager
  cacheID : String
Stellt einen Zugriff auf den Cache-Bezeichner für diesen Dienst bereit.
DataManager
  commitRequired : Boolean
[schreibgeschützt] Zeigt an, wenn Änderungen noch nicht übernommen wurden und die commit()-Methode aufgerufen werden sollte.
DataManager
  conflictDetector : ConflictDetector
Stellt einen Zugriff auf die aktuelle Implementierung bereit, die zum Erkennen von Konflikten in Remote-Vorgängen verwendet wird, die an diese DataManager-Instanz gesendet wurden.
DataManager
  conflicts : Conflicts
[schreibgeschützt] Enthält ein Conflicts-Objekt, eine ArrayList mit Conflict-Instanzen.
DataManager
  connected : Boolean
[schreibgeschützt] Zeigt an, ob der DataService mit dem Remote-Ziel verbunden ist.
DataManager
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  dataStore : DataStore
Enthält ein Objekt des mx.data.DataStore-Typs.
DataManager
  deleteItemOnRemoveFromFill : Boolean
Standardmäßig wird ein Aufruf zum Löschen des Elements an den Server eingegeben, um das Element vollständig zu entfernen, wenn Sie die removeItemAt()-Methode in einer verwalteten gefüllten Sammlung aufrufen.
DataManager
  encryptLocalCache : Boolean
Zeigt an, ob Offlinespeicher für AIR-Clients, die einen SQL-Offline-Adapter verwenden, verschlüsselt werden soll.
DataManager
  fallBackToLocalFill : Boolean
Dieses Flag legt fest, ob die Anwendung den lokalen Speicher abfragen soll, wenn sie nicht verbunden ist.
DataManager
  hierarchicalEventsDefault : Boolean
Verknüpfungen, die optional Eigenschaftsänderungsereignisse für Eigenschaften der verknüpften Instanzen auflisten.
DataManager
  ignoreCollectionUpdates : Boolean
Zeigt an, ob Änderungen an verwalteten Sammlungen ignoriert werden sollen, anstatt sie dem Server bei Commit-Aufruf mitzuteilen.
DataManager
  indexReferences : Boolean
Um die Geschwindigkeit Ihrer Anwendung anzupassen, sollten Sie hier „false“ festlegen, wenn nur eine geringe Anzahl von Füllungen oder Verweisen auf Elemente vorhanden ist, die durch diesen DataManager über Verknüpfungseigenschaften anderer Elemente verwaltet werden.
DataManager
  isInitialized : Boolean
[schreibgeschützt] Zeigt an, ob die mit dieser DataManager-Instanz verknüpften Metadaten initialisiert sind.
DataManager
  manualSync : ManualSyncConfiguration
Stellt Zugriff auf die ManualSyncConfiguration-Instanz für jede DataManager-Instanz bereit.
DataManager
  maxFrequency : uint
Bestimmt die maximale Anzahl an Meldungen pro Sekunde, die von der DataManager-Instanz empfangen werden können.
DataManager
  mergeRequired : Boolean
[schreibgeschützt] Zeigt an, ob ausstehende Änderungen vorhanden sind, die zusammengeführt werden müssen.
DataManager
  offlineAdapter : DataServiceOfflineAdapter
Gibt ein Objekt des mx.data.DataServiceOfflineAdapter-Typs zurück.
DataManager
  pageSize : int
Stellt einen Zugriff auf die aktuelle Seitengrößeneinstellung für alle Sammlungen bereit.
DataManager
  pagingEnabled : Boolean
[schreibgeschützt] Zeigt an, ob das Remote-Ziel konfiguriert wurde, um Anforderungen mit Seitenerstellung zuzulassen.
DataManager
  priority : int
Die Standardmeldungspriorität für die von der DataManager-Instanz gesendeten Meldungen.
DataManager
  requestTimeout : int
Stellt einen Zugriff auf die Anforderungszeitüberschreitung in Sekunden für einen Vorgang bereit
DataManager
  resetCollectionOnFill : Boolean
Wenn die Eigenschaft auf „true“ gesetzt ist, wird nach dem Fertigstellen des Füllvorgangs ein RESET-Ereignis gesendet.
DataManager
  resubscribeAttempts : int
Steuert, wie oft eine DataManager-Instanz mit getrennter Verbindung versucht, sich erneut bei ihrem Ziel anzumelden.
DataManager
  resubscribeInterval : int
Steuert die Verzögerung, in Millisekunden, zwischen Versuchen zum erneuten Abonnement.
DataManager
  saveCacheRequired : Boolean
[schreibgeschützt] Gibt an, ob Änderungen vorliegen, die nicht in den lokalen Cache gespeichert wurden, und die saveCache()-Methode aufgerufen werden soll.
DataManager
  subscribed : Boolean
[schreibgeschützt] Gibt an, ob die DataManager-Instanz das Remote-Ziel abonniert hat.
DataManager
  throwItemPendingErrors : Boolean
Legen Sie diese Eigenschaft als „false“ fest, wenn Sie Fehler aufgrund ausstehender Elemente unterdrücken möchten, während auf träge abgerufene Daten oder Daten ohne Seitenerstellung zugegriffen wird.
DataManager
Öffentliche Methoden
 MethodeDefiniert von
  
Erstellt eine Instanz des DataService mit dem festgelegten Ziel.
DataManager
  
Löscht alle Daten, die auf der Festplatte gespeichert wurden, wenn zuvor ein Aufruf von der saveCache()-Methode erfolgt ist oder wenn für die autoSaveCache-Methode der Wert „true“ festgelegt wurde.
DataManager
  
Löscht die vom übergebenen Deskriptor festgelegten Daten vom Lokalspeicher.
DataManager
  
commit(itemsOrCollections:Array = null, cascadeCommit:Boolean = false):mx.rpc:AsyncToken
Übernimmt ausstehende Änderungen für alle Sammlungen, die zurzeit von der DataStore-Instanz verwaltet werden, die mit dieser DataManager-Instanz verknüpft ist.
DataManager
  
Zeigt an, ob ausstehende Änderungen für dieses bestimmte Objekt vorhanden sind.
DataManager
  
Erzwingt einen Verbindungsversuch dieses Dienstes mit dem Remote-Ziel.
DataManager
  
Ruft eine Zählmethode im Remote-Ziel auf.
DataManager
  
Fordert die Erstellung des festgelegten Elements im Remote-Speicher an.
DataManager
  
Fordert die Löschung des festgelegten Elements im Remote-Speicher an.
DataManager
  
Trennt die Netzwerkverbindung der DataManager-Instanz.
DataManager
  
executeQuery(queryName:String, propertySpecifier:PropertySpecifier, ... args):mx.rpc:AsyncToken
Führt eine Abfrage mit dem bereitgestellten Namen und den Argumenten aus.
DataManager
  
Füllt die angegebene ListCollectionView(Sammlung)-Instanz anhand der verknüpften Füllmethode des Ziels.
DataManager
  
Füllt die angegebene ListCollectionView(Sammlung)-Instanz anhand der verknüpften Füllmethode des Ziels.
DataManager
  
findItem(queryName:String, propertySpecifier:PropertySpecifier, ... args):mx.rpc:AsyncToken
Führt eine Abfrage aus, die ein einzelnes Element zurückgibt.
DataManager
  
Gibt eine ArrayCollection oder ein einzelnes verwaltetes Objekt vom lokalen Speicher zurück.
DataManager
  
Füllt die angegebene ListCollectionView(Sammlung)-Instanz mit CacheDataDescriptor-Instanzen.
DataManager
  
Füllt die festgelegte ListCollectionView(Sammlung)-Instanz mit allen Cache-Bezeichnern, die zuvor in der Anwendung verwendet wurden.
DataManager
  
getItem(identity:Object, defaultValue:Object = null):ItemReference
Erstellt eine asynchrone Anforderung für ein Element, das mit der festgelegten Identität übereinstimmt.
DataManager
  
Sucht das zur Verfügung gestellt Element mit der gegebenen Identität.
DataManager
  
Gibt die Seiteninformationen für die angegebene Sammlung zurück.
DataManager
  
Gibt den ausstehenden Vorgang im Meldungscache für das festgelegte Element zurück.
DataManager
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
  
Erzwingt die Initialisierung des DataStore.
DataManager
  
Gibt „true“ zurück, wenn die übergebene Sammlung von diesem Dienst verwaltet wird.
DataManager
  
Gibt „true“ zurück, wenn die übergebene Sammlung Pagingfunktionen verwendet.
DataManager
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
  
isRangeResident(view:ListCollectionView, startIndex:int, numberOfItems:int):Boolean
Gibt „true“ zurück, wenn der bereitgestellte Bereich mit Elementen vollständig im Seitenbereich liegt.
DataManager
  
Füllt die angegebene ListCollectionView basierend auf den verknüpften <fill-method>-Elementen anhand von Daten aus dem lokalen Speicher.
DataManager
  
Führt ausstehende Aktualisierungen in den verwalteten Objektsatz zusammen.
DataManager
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
  
Aktualisiert alle Daten, die von dieser DataManager-Instanz verwaltet werden.
DataManager
  
Aktualisiert eine Sammlung, die zuvor mit der Füllmethode gefüllt oder als eine verwaltete Verknüpfung verwaltet wurde.
DataManager
  
release(clear:Boolean = true, copyStillManagedItems:Boolean = true):void
Gibt alle verwalteten Sammlungen und Elemente für die DataManager-Instanz frei.
DataManager
  
releaseCollection(view:ListCollectionView, clear:Boolean = false, copyStillManagedItems:Boolean = true):void
Entlässt ein beliebiges Element innerhalb der festgelegten Sammlung aus der Verwaltung durch diese DataManager-Instanz.
DataManager
  
releaseItem(item:IManaged, copyStillManagedItems:Boolean = true, enableStillManagedCheck:Boolean = true):IManaged
Entlässt das festgelegte Element aus der Verwaltung durch diese DataManager-Instanz.
DataManager
  
releaseItemsFromCollection(collection:ListCollectionView, startIndex:int, numberOfItems:int):int
Gibt einen Bereich von Elementen aus der Sammlung frei.
DataManager
  
Gibt den Wert für eine Einzelwertverknüpfung frei.
DataManager
  
Stellt den vorherigen Zustand für nicht übernommene Änderungen am festgelegten Element wieder her.
DataManager
  
Setzt die Änderungen für ein beliebiges Element aus der angegebenen Sammlung zurück, das durch diese DataManager-Instanz verwaltet werden sollte.
DataManager
  
Diese Methode speichert den aktuellen Status des Cache der DataManager-Instanz.
DataManager
  
Gibt an, ob für dieses bestimmte Objekt Änderungen ausstehen, die nicht in den lokalen Cache gespeichert werden.
DataManager
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
  
Ruft die geänderten Elemente für alle vorherigen ausgeführten Füllungen in diesem Datendienst (Datenmanager) ab.
DataManager
  
[statisch] Eine Vereinfachungsmethode, die die Synchronisierung aller lokalen Daten ermöglicht: Eine synchronizeAllFills() wird für jeden Datendienst (Datenmanager) aufgerufen, der so angegeben ist, dass das endgültige Ergebnistoken nur dann abgeschlossen wird, wenn alle einzelnen synchronizeAllFills()-Aufrufe abgeschlossen sind.
DataManager
  
Ruft die geänderten Elemente ab, die sich auf dem Server geändert haben, seit eine fill oder synchronizeFill das letzte Mal aufgerufen wurde.
DataManager
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
  
updateItem(item:Object, origItem:Object = null, changes:Array = null):mx.rpc:AsyncToken
Löst eine Aktualisierung des angegebenen Elements aus.
DataManager
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Geschützte Methoden
 MethodeDefiniert von
  
Stellt einen Fehler in die Warteschlange, wenn dieser Datenmanager noch nicht initialisiert wurde.
DataManager
Ereignisse
 Ereignis Übersicht Definiert von
  Das DataConflictEvent.CONFLICT-Ereignis wird ausgelöst, wenn ein Konflikt zwischen ausstehenden lokalen Änderungen und von anderen Clients übertragenen Änderungen erkannt wird oder wenn von diesem Client übertragene Änderungen einen Konflikt mit Änderungen im Remote-Ziel haben.DataManager
  Das DataManagerFaultEvent.FAULT-Ereignis wird ausgelöst, wenn ein Dienstaufruf aufgrund eines Fehlers fehlschlägt.DataManager
  Das MessageEvent.MESSAGE-Ereignis wird ausgelöst, wenn das Remote-Ziel eine Benachrichtigung zu einem Datenvorgang ausgibt.DataManager
  Das PropertyChangeEvent.PROPERTY_CHANGE-Ereignis wird bei Änderung einer Eigenschaft dieses Dienstes ausgelöst.DataManager
  Das ResultEvent.RESULT-Ereignis wird ausgelöst, wenn ein Dienstaufruf erfolgreich zurückgegeben wird.DataManager
Eigenschaftendetails

adapter

Eigenschaft
public var adapter:DataServiceAdapter = null

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Eine Instanz einer Klasse, die die Interaktion mit dem Server steuert.

autoCommit

Eigenschaft 
autoCommit:Boolean

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Zeigt an, ob Änderungen am lokalen Cache automatisch übernommen werden. Übernommene Änderungen werden sofort an den Remote-Dienst gesendet.

Der Standardwert ist „true“ für DataService-Instanzen, die mit dem serverseitigen Data Management Service verwendete Datenmanager sind.

Der Standardwert ist „false“ für RPCDataManager-Instanzen, die Datenmanager sind, die clientseitige Datenverwaltungsfunktionalität für RPC-Servicekomponenten wie RemoteObject, HTTPMultiService und WebService zur Verfügung stellen.



Implementierung
    public function get autoCommit():Boolean
    public function set autoCommit(value:Boolean):void

autoConnect

Eigenschaft 
autoConnect:Boolean

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Zeigt an, ob dieser Dienst versuchen sollte, eine Verbindung zu Vorgängen herzustellen, für die eine Verbindung erforderlich ist. Vorgänge wie fill(), getItem() und count() versuchen, eine Verbindung herzustellen, wenn die Verbindung des Diensts getrennt ist und autoConnect als true festgelegt ist. Verwenden Sie diese Eigenschaft, um das Verhalten von nicht ständig verbundenen Anwendungen zu steuern.

Der Standardwert ist true.



Implementierung
    public function get autoConnect():Boolean
    public function set autoConnect(value:Boolean):void

autoMerge

Eigenschaft 
autoMerge:Boolean

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Bei Festlegung als false werden Änderungen, die vom Remote-Ziel an den Client gesendet wurden, nicht sofort angewendet. Stattdessen wird die mergeRequired-Eigenschaft als „true“ festgelegt.

Eine Ereignisprozedur kann registriert werden, um auf change-Ereignisse in dieser Eigenschaft zu warten, woraufhin eine Benachrichtigung gesendet wird, wenn eine Zusammenführung angewendet werden muss.

Rufen Sie die merge()-Methode auf, um Änderungen zusammenzuführen, und alle Änderungen werden angewendet.

Nicht übernommene Änderungen können nicht übernommen werden, wenn Änderungen vorhanden sind, die zusammengeführt werden müssen.

Ist Paging aktiviert, werden alle Anforderungen für nicht lokale Elemente zwischengespeichert, bis merge() aufgerufen wird. Nach dem Aufruf von merge() werden die zwischengespeicherten Anforderungen verarbeitet.

Der Standardwert ist true.



Implementierung
    public function get autoMerge():Boolean
    public function set autoMerge(value:Boolean):void

autoSaveCache

Eigenschaft 
autoSaveCache:Boolean

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Sie können den lokalen Cache mit Daten und Änderungen auf der Festplatte speichern. Ist die autoSaveCache-Eigenschaft als true festgelegt, werden die Daten jedes Mal auf der Festplatte gespeichert, wenn eine Änderung erstellt oder eine Remote-Änderung zurückgegeben wird. Bei Problemen mit dem Speichern aufgrund von fehlendem Speicherplatz oder verweigerten Schreibberechtigungen wird ein FaultEvent ausgelöst oder ein Fault ausgegeben.

Wird dieser Wert als false (Standardwert) festgelegt, werden keine Daten oder Änderungen auf der Festplatte gespeichert. Verwenden Sie die saveCache()-Methode, um das Speichern der aktuellen Daten und Änderungen auf der Festplatte zu erzwingen.

Der Standardwert ist false.



Implementierung
    public function get autoSaveCache():Boolean
    public function set autoSaveCache(value:Boolean):void

Verwandte API-Elemente

autoSyncEnabled

Eigenschaft 
autoSyncEnabled:Boolean

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Bei true geben fill()-, createItem()- und getItem()-Anforderungen Elemente zurück, die auf Aktualisierungen warten, die an diesen Elementen vom Remote-Ziel durchgeführt wurden. Wenn eine Änderung an diesem Eigenschaftswert durchgeführt wurde, wirkt sich dies nur auf zukünftige Aufrufe dieser Methoden aus und nicht auf vorhandene Sammlungen oder Elemente.

Beachten Sie, dass bei einer Mischung aus mit autoSyncEnabled abgerufenen und ohne autoSyncEnabled gefüllten Sammlungen alle Elemente, die in beiden Sammlungen vorhanden sind, weiterhin Update-Ereignisse empfangen.

Der Standardwert ist true.



Implementierung
    public function get autoSyncEnabled():Boolean
    public function set autoSyncEnabled(value:Boolean):void

cacheID

Eigenschaft 
cacheID:String

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Stellt einen Zugriff auf den Cache-Bezeichner für diesen Dienst bereit. Ein Cache-Bezeichner muss vor dem Durchführen von Vorgängen festgelegt werden, für die eine Interaktion mit lokal auf der Festplatte gespeicherten Daten erforderlich ist. Ist kein Cache-Bezeichner festgelegt, werden alle Cache-Vorgänge und -Eigenschaften als inkonsistent gewertet und bei beliebigen Vorgängen, die Daten von der lokalen Festplatte benötigen, wird ein DataServiceError ausgegeben. Diese Eigenschaft stellt einen eindeutigen „session“-Bezeichner für lokal gespeicherte Daten bereit. Ein Entwickler muss für diese Eigenschaft einen eindeutigen Wert für die Anwendung festlegen.

Der Wert null oder ein leerer String gelten als nicht festgelegt. Anforderungen für Daten mithilfe von Methoden wie fill() und getItem() versuchen, zuerst auf die lokalen Daten der Festplatte zuzugreifen, wenn die cacheID festgelegt wurde. Wurde die cacheID nicht festgelegt, wird nicht versucht, auf lokale Daten zuzugreifen.



Implementierung
    public function get cacheID():String
    public function set cacheID(value:String):void

commitRequired

Eigenschaft 
commitRequired:Boolean  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Zeigt an, wenn Änderungen noch nicht übernommen wurden und die commit()-Methode aufgerufen werden sollte. Wird diese Eigenschaft geändert, wird ein Ereignis ausgelöst. Diese Eigenschaft kann innerhalb einer Anwendung verwendet werden, um visuelles Feedback bereitzustellen.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das propertyChange -Ereignis ausgelöst.



Implementierung
    public function get commitRequired():Boolean

conflictDetector

Eigenschaft 
conflictDetector:ConflictDetector

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Stellt einen Zugriff auf die aktuelle Implementierung bereit, die zum Erkennen von Konflikten in Remote-Vorgängen verwendet wird, die an diese DataManager-Instanz gesendet wurden.



Implementierung
    public function get conflictDetector():ConflictDetector
    public function set conflictDetector(value:ConflictDetector):void

conflicts

Eigenschaft 
conflicts:Conflicts  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Enthält ein Conflicts-Objekt, eine ArrayList mit Conflict-Instanzen.

Konflikte müssen gelöst werden, bevor die commit()-Methode aufgerufen wird. Um Konflikte aufzulösen, können Sie entweder die Liste durchgehen und die Konflikte einzeln auflösen oder die acceptAllClient()- oder acceptAllServer()-Methode für diese Eigenschaft aufrufen.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das propertyChange -Ereignis ausgelöst.



Implementierung
    public function get conflicts():Conflicts

connected

Eigenschaft 
connected:Boolean  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Zeigt an, ob der DataService mit dem Remote-Ziel verbunden ist.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das propertyChange -Ereignis ausgelöst.



Implementierung
    public function get connected():Boolean

dataStore

Eigenschaft 
dataStore:DataStore

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Enthält ein Objekt des mx.data.DataStore-Typs. Die DataStore-Instanz verwaltet den Satz an eingehenden und ausgehenden Änderungen für eine oder mehrere DataManager-Instanzen, die möglicherweise aufeinander verweisen. Erfolgt die Übernahme in einem DataStore, werden alle ausstehenden Änderungen von jedem DataManager, der diesen DataStore verwendet, übernommen.

Standardmäßig verwendet eine DataManager-Instanz den gleichen DataStore gemeinsam mit anderen DataManager-Instanzen, wenn sie über verwaltete Verknüpfungseigenschaften verfügen und den gleichen Satz von Kanälen gemeinsam verwenden. Wenn Sie DataStores gemeinsam verwenden, übernimmt ein Commit-Aufruf in einem DataManager Änderungen in allen DataManagers, die diesen Datenspeicher verwenden. Dies behält die Reihenfolge der Vorgänge für den Fall bei, dass Abhängigkeiten zwischen den Änderungen in den ungebundenen Batches vorhanden sind.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das propertyChange -Ereignis ausgelöst.



Implementierung
    public function get dataStore():DataStore
    public function set dataStore(value:DataStore):void

deleteItemOnRemoveFromFill

Eigenschaft 
deleteItemOnRemoveFromFill:Boolean

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Standardmäßig wird ein Aufruf zum Löschen des Elements an den Server eingegeben, um das Element vollständig zu entfernen, wenn Sie die removeItemAt()-Methode in einer verwalteten gefüllten Sammlung aufrufen. Dies ermöglicht die Verwendung von Code, der eine verwaltete und eine nicht verwaltete Sammlung auf die gleiche Weise verwendet. In anderen Fällen möchten Sie aber möglicherweise das Element aus der Sammlung auf dem Client entfernen, ohne es vom Server zu löschen. In diesem Fall setzen Sie das Flag als false, bevor Sie die removeItemAt()-Methode aufrufen.

Beachten Sie, dass sich dies nicht auf Sammlungen auswirkt, die Verknüpfungen sind. Dies wirkt sich nur auf Sammlungen aus, die mit der fill()-Methode verwendet wurden.

Der Standardwert ist true.



Implementierung
    public function get deleteItemOnRemoveFromFill():Boolean
    public function set deleteItemOnRemoveFromFill(value:Boolean):void

encryptLocalCache

Eigenschaft 
encryptLocalCache:Boolean

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3.1
Laufzeitversionen: Flash Player 9, AIR 1.5

Zeigt an, ob Offlinespeicher für AIR-Clients, die einen SQL-Offline-Adapter verwenden, verschlüsselt werden soll.

Für browserbasierte Flex-Clients können Offlinedaten nicht verschlüsselt werden.



Implementierung
    public function get encryptLocalCache():Boolean
    public function set encryptLocalCache(value:Boolean):void

fallBackToLocalFill

Eigenschaft 
fallBackToLocalFill:Boolean

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3.1
Laufzeitversionen: Flash Player 9, AIR 1.1

Dieses Flag legt fest, ob die Anwendung den lokalen Speicher abfragen soll, wenn sie nicht verbunden ist. Wenn der Offline-Adapter für die Unterstützung der Ausführung einer dynamischen Abfrage konfiguriert ist, wird bei der Auslösung von fill() standardmäßig der lokale Speicher nicht abgefragt, wenn die Anwendung nicht verbunden ist. Wenn fallBackToLocalFill auf „true“ festgelegt ist, wird der lokale Speicher auch abgefragt, wenn die Verbindung zur Anwendung unterbrochen ist.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das propertyChange -Ereignis ausgelöst.



Implementierung
    public function get fallBackToLocalFill():Boolean
    public function set fallBackToLocalFill(value:Boolean):void

hierarchicalEventsDefault

Eigenschaft 
hierarchicalEventsDefault:Boolean

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Verknüpfungen, die optional Eigenschaftsänderungsereignisse für Eigenschaften der verknüpften Instanzen auflisten. Sie können dies für die Verknüpfung mit dem hierarchical-events-Konfigurationsattribut festlegen. Wenn Sie das hierarchical-events-Attribut nicht festlegen, ermitteln die Verknüpfungen für ein bestimmtes Ziel mithilfe dieser Eigenschaft den Standardwert.

Der Standardwert ist false. Bei Objekten in einer Baumstruktur (anstelle eines zyklischen Diagramms) möchten Sie dies möglicherweise der Übersicht halber für ein Ziel als true festlegen. Wenn Sie Eigenschaften Ihrer Eigenschaften verwenden, z. B. in einem Elementrenderer, bewirkt die Einstellung true für diese Verknüpfungseigenschaft, dass das Raster aktualisiert wird, wenn sich diese Eigenschaften der Eigenschaften ändern. Das System vermeidet das Senden rekursiver Ereignisse sowie das Erstellen langer Ereignisketten, z. B. parent.child[0].child[1].child[3].

Der Standardwert ist false.



Implementierung
    public function get hierarchicalEventsDefault():Boolean
    public function set hierarchicalEventsDefault(value:Boolean):void

ignoreCollectionUpdates

Eigenschaft 
ignoreCollectionUpdates:Boolean

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3.1
Laufzeitversionen: Flash Player 9, AIR 1.5

Zeigt an, ob Änderungen an verwalteten Sammlungen ignoriert werden sollen, anstatt sie dem Server bei Commit-Aufruf mitzuteilen.

Der Standardwert ist false.



Implementierung
    public function get ignoreCollectionUpdates():Boolean
    public function set ignoreCollectionUpdates(value:Boolean):void

indexReferences

Eigenschaft 
indexReferences:Boolean

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Um die Geschwindigkeit Ihrer Anwendung anzupassen, sollten Sie hier false festlegen, wenn nur eine geringe Anzahl von Füllungen oder Verweisen auf Elemente vorhanden ist, die durch diesen DataManager über Verknüpfungseigenschaften anderer Elemente verwaltet werden.



Implementierung
    public function get indexReferences():Boolean
    public function set indexReferences(value:Boolean):void

isInitialized

Eigenschaft 
isInitialized:Boolean  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Zeigt an, ob die mit dieser DataManager-Instanz verknüpften Metadaten initialisiert sind.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das propertyChange -Ereignis ausgelöst.



Implementierung
    public function get isInitialized():Boolean

manualSync

Eigenschaft 
manualSync:ManualSyncConfiguration

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Stellt Zugriff auf die ManualSyncConfiguration-Instanz für jede DataManager-Instanz bereit. Mithilfe der ManualSyncConfiguration-Klasse können Sie Änderungen abonnieren, die von anderen Clients oder auf dem Server erstellt wurden, und steuern, inwiefern Ihre Änderungen auf anderen Clients veröffentlicht werden, die unter Verwendung dieser Schnittstelle abonnieren.



Implementierung
    public function get manualSync():ManualSyncConfiguration
    public function set manualSync(value:ManualSyncConfiguration):void

maxFrequency

Eigenschaft 
maxFrequency:uint

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Bestimmt die maximale Anzahl an Meldungen pro Sekunde, die von der DataManager-Instanz empfangen werden können. Ein Server, der diesen Wert versteht, verwendet ihn als Eingabe, während die Geschwindigkeit festgestellt wird, mit der die Meldungen an den DataManager gesendet werden.

Der Standardwert ist 0, wobei der DataManager keine Voreinstellung für die Meldungsrate hat. Beachten Sie, dass diese Eigenschaft vor dem Abonnieren durch den DataManager festgelegt werden sollte. Alle Änderungen nach dem Abonnement werden erst wirksam, wenn der DataManager das Abonnement abbestellt und wieder neu erstellt.

Der Standardwert ist 0.



Implementierung
    public function get maxFrequency():uint
    public function set maxFrequency(value:uint):void

mergeRequired

Eigenschaft 
mergeRequired:Boolean  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Zeigt an, ob ausstehende Änderungen vorhanden sind, die zusammengeführt werden müssen.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das propertyChange -Ereignis ausgelöst.



Implementierung
    public function get mergeRequired():Boolean

offlineAdapter

Eigenschaft 
offlineAdapter:DataServiceOfflineAdapter

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3.1
Laufzeitversionen: Flash Player 9, AIR 1.1

Gibt ein Objekt des mx.data.DataServiceOfflineAdapter-Typs zurück. Der Offline-Adapter steuert die Implementierung für die dauerhafte Speicherung von Objekten auf dem lokalen Speicher (SQLLite/LSO).



Implementierung
    public function get offlineAdapter():DataServiceOfflineAdapter
    public function set offlineAdapter(value:DataServiceOfflineAdapter):void

pageSize

Eigenschaft 
pageSize:int

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Stellt einen Zugriff auf die aktuelle Seitengrößeneinstellung für alle Sammlungen bereit.



Implementierung
    public function get pageSize():int
    public function set pageSize(value:int):void

pagingEnabled

Eigenschaft 
pagingEnabled:Boolean  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Zeigt an, ob das Remote-Ziel konfiguriert wurde, um Anforderungen mit Seitenerstellung zuzulassen.



Implementierung
    public function get pagingEnabled():Boolean

priority

Eigenschaft 
priority:int

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Die Standardmeldungspriorität für die von der DataManager-Instanz gesendeten Meldungen. Die gültigen Werte sind 0 bis 9 (wobei 0 am niedrigsten ist) und -1 bedeutet, dass die DataManager-Instanz keine Priorität festgelegt hat. Beachten Sie, dass im Falle einer bereits definierten Priorität der Meldung diese einen Vorrang vor dieser Priorität hat.



Implementierung
    public function get priority():int
    public function set priority(value:int):void

requestTimeout

Eigenschaft 
requestTimeout:int

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Stellt einen Zugriff auf die Anforderungszeitüberschreitung in Sekunden für einen Vorgang bereit Ein Wert, der kleiner oder gleich null ist, verhindert die Anforderungszeitüberschreitung. Wenn ein aktueller Vorgang aufgrund der requestTimeout-Beschränkung die Zeit überschreitet, wird ein Fehler für diesen Vorgang ausgelöst, der anzeigt, dass die Anforderung die Zeit überschritten hat. Beachten Sie, dass es bei einer Zeitüberschreitung des Vorgangs möglich ist, dass der Server den Vorgang dennoch empfangen hat. Dies kann zu Abweichungen zwischen Ihrem Client-Status und dem Server führen.



Implementierung
    public function get requestTimeout():int
    public function set requestTimeout(value:int):void

resetCollectionOnFill

Eigenschaft 
resetCollectionOnFill:Boolean

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Wenn die Eigenschaft auf true gesetzt ist, wird nach dem Fertigstellen des Füllvorgangs ein RESET-Ereignis gesendet. Wenn die Eigenschaft auf false gesetzt ist, werden nur inkrementelle ADD-/REMOVE-Ereignisse für jedes Element aus dem Füllergebnis zurückgegeben. Das Festlegen dieser Eigenschaft wirkt sich alle initiierten Füllungen aus. Das Ändern dieser Eigenschaft nach dem Beginn des Füllens wirkt sich nicht auf das Verhalten der offenen Füllung aus.

Der Standardwert ist true.



Implementierung
    public function get resetCollectionOnFill():Boolean
    public function set resetCollectionOnFill(value:Boolean):void

resubscribeAttempts

Eigenschaft 
resubscribeAttempts:int

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Steuert, wie oft eine DataManager-Instanz mit getrennter Verbindung versucht, sich erneut bei ihrem Ziel anzumelden. Der Standardwert -1 steht für das kontinuierliche erneute Anmelden, bis der Client erneut verbunden ist.

Der Standardwert ist -1.



Implementierung
    public function get resubscribeAttempts():int
    public function set resubscribeAttempts(value:int):void

resubscribeInterval

Eigenschaft 
resubscribeInterval:int

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Steuert die Verzögerung, in Millisekunden, zwischen Versuchen zum erneuten Abonnement. Der Standardwert ist 5000, d. h. alle 5 Sekunden erfolgt ein Versuch zum erneuten Abonnement.

Der Standardwert ist 5000.



Implementierung
    public function get resubscribeInterval():int
    public function set resubscribeInterval(value:int):void

saveCacheRequired

Eigenschaft 
saveCacheRequired:Boolean  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 4.5
Laufzeitversionen: Flash Player 9, AIR 1.1

Gibt an, ob Änderungen vorliegen, die nicht in den lokalen Cache gespeichert wurden, und die saveCache()-Methode aufgerufen werden soll. Diese Methode kann „false“ zurückgeben, wenn commitRequired „true“ zurückgeben würde; damit wird angegeben, dass die Änderungen im lokalen Cache gespeichert, aber nicht an den Server übergeben werden.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das propertyChange -Ereignis ausgelöst.



Implementierung
    public function get saveCacheRequired():Boolean

subscribed

Eigenschaft 
subscribed:Boolean  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Gibt an, ob die DataManager-Instanz das Remote-Ziel abonniert hat.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das propertyChange -Ereignis ausgelöst.



Implementierung
    public function get subscribed():Boolean

throwItemPendingErrors

Eigenschaft 
throwItemPendingErrors:Boolean

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Legen Sie diese Eigenschaft als false fest, wenn Sie Fehler aufgrund ausstehender Elemente unterdrücken möchten, während auf träge abgerufene Daten oder Daten ohne Seitenerstellung zugegriffen wird. Anstatt einen Fehler auszulösen, wird „null“ für einen Eigenschaftswert oder einen getItemAt-Aufruf in einer Array-Sammlung zurückgegeben.

Von der size()-Methode werden 0 Elemente für eine Liste zurückgegeben, deren Größe noch nicht vom Server aufgerufen wurde. Wenn das Element vom Server zurückgegeben wird, führt dies zum Auslösen der entsprechenden PropertyChangeEvent- und CollectionEvent-Ereignisse.



Implementierung
    public function get throwItemPendingErrors():Boolean
    public function set throwItemPendingErrors(value:Boolean):void
Konstruktordetails

DataManager

()Konstruktor
public function DataManager()

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Erstellt eine Instanz des DataService mit dem festgelegten Ziel. Das Ziel muss ein Verweis auf ein in der services-config.xml-Datei konfiguriertes Ziel sein.

Methodendetails

checkImplementation

()Methode
protected function checkImplementation():void

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Stellt einen Fehler in die Warteschlange, wenn dieser Datenmanager noch nicht initialisiert wurde.

clearCache

()Methode 
public function clearCache(value:Object = null):mx.rpc:AsyncToken

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Löscht alle Daten, die auf der Festplatte gespeichert wurden, wenn zuvor ein Aufruf von der saveCache()-Methode erfolgt ist oder wenn für die autoSaveCache-Methode der Wert true festgelegt wurde.

Parameter

value:Object (default = null) — Objektverweis auf ein verwaltetes einzelnes Objekt oder eine ArrayCollection.

Rückgabewerte
mx.rpc:AsyncToken — AsyncToken, das dazu verwendet werden kann, auf den Erfolg oder das Fehlschlagen des Vorgangs zu reagieren.

clearCacheData

()Methode 
public function clearCacheData(descriptor:CacheDataDescriptor):mx.rpc:AsyncToken

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Löscht die vom übergebenen Deskriptor festgelegten Daten vom Lokalspeicher.

Parameter

descriptor:CacheDataDescriptor — Verweis auf den Deskriptor für die Daten, die vom lokalen Cache entfernt werden sollten.

Rückgabewerte
mx.rpc:AsyncToken — Verweis auf das Token, mit dem festgestellt werden kann, wann das Ergebnis oder der Fehler für diesen Vorgang aufgetreten ist.

commit

()Methode 
public function commit(itemsOrCollections:Array = null, cascadeCommit:Boolean = false):mx.rpc:AsyncToken

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Übernimmt ausstehende Änderungen für alle Sammlungen, die zurzeit von der DataStore-Instanz verwaltet werden, die mit dieser DataManager-Instanz verknüpft ist. Das Aufrufen dieser Methode ist äquivalent zum Aufruf der dataStore.commit()-Methode.

Wenn die autoCommit-Eigenschaft als true festgelegt ist, werden Transaktionen nicht verwendet und Sie müssen diese Methode nicht aufrufen. Um Transaktionen zu verwenden, legen Sie die autoCommit-Eigenschaft als false fest und rufen diese Methode direkt auf, um einen Batch mit Änderungen zu übernehmen.

Normalerweise rufen Sie nur commit() ohne Argumente auf, damit alle ausstehenden Änderungen übernommen werden. Sie können zusätzliche Argumente zur Verfügung stellen, um eine Untergruppe der ausstehenden Änderungen zu übernehmen. Sie müssen alle ausstehenden Konflikte auflösen, bevor Sie Änderungen an den Elementen im DataStore übernehmen können.

Wenn der Assembler so konfiguriert wurde, dass für use-transactions true festgelegt wird, werden alle Änderungen automatisch übernommen. Wenn ein Vorgang fehlschlägt, wird keiner der Vorgänge im Batch angewendet. Wenn use-transactions als false festgelegt ist, werden die Vorgänge einzeln übernommen, bis die Verarbeitung bei einem auftretenden Fehler stoppt. Alle vor dem Fehler aufgetretenen Änderungen werden angewendet, alle nach dem Fehler aufgetretenen Änderungen werden nicht angewendet. Wenn ein Fehler bei der Verarbeitung eines Batchs auftritt, werden die Änderungen in die nicht übernommene Warteschlange zurückgelegt. Sie müssen revertChanges aufrufen, wenn Sie die Änderungen entfernen möchten, die den Fehler verursacht haben.

Standardmäßig übernimmt die Commit-Methode alle ausstehenden Änderungen für alle Elemente, die für den DataStore erstellt, modifiziert und gelöscht wurden. Wenn Sie eine Untergruppe dieser Änderungen übernehmen möchten, können Sie eine Kombination von verwalteten ArrayCollection-Instanzen und/oder verwalteten Elementen festlegen, die die Untergruppe von Änderungen definieren, die im Batch enthalten sein sollen. Für jede von Ihnen festgelegte Array-Sammlung werden alle Änderungen an der Mitgliedschaft oder Reihenfolge der Elemente in dieser Array-Sammlung oder an beliebigen Elementen in dieser Array-Sammlung übernommen. Außerdem können Sie eine Liste mit einzelnen verwalteten Elementen festlegen, sodass nur Änderungen für diese Elemente übernommen werden. Wenn Sie Objekte im itemsOrCollections-Parameter festlegen, die keine verwalteten Sammlungen oder Elemente sind, wird ein DataServiceError ausgegeben.

Wenn Sie den itemsOrCollections-Parameter verwenden und Ihre Elemente Verknüpfungseigenschaften haben, die auf andere Elemente verweisen, können Sie den cascadeCommit-Parameter verwenden, um festzulegen, ob an verknüpften Elementen durchgeführte Änderungen auch im Batch enthalten sein sollen. Beispiel: Wenn Sie ein Group-Element im Elementparameter festlegen und die Group-Instanz eine Mitgliedereigenschaft hat, die auf eine Liste mit Person-Instanzen verweist, während cascadeCommit als „true“ festgelegt ist, werden Änderungen an einer Person-Instanz auch in den Satz der übernommenen Änderungen aufgenommen. Wenn cascadeCommit als „false“ festgelegt ist, werden nur Änderungen für Group aufgenommen. Verwenden Sie cascadeCommit=true, um sicherzustellen, dass alle abhängigen Änderungen im Batch enthalten sind.

Parameter

itemsOrCollections:Array (default = null) — Dies ist ein optionaler Parameter, der standardmäßig null ist, wenn Sie alle ausstehenden Änderungen übernehmen möchten. Wenn Sie eine Untergruppe der ausstehenden Änderungen übernehmen möchten, verwenden Sie dieses Argument zum Festlegen einer Liste von ListCollectionView-Instanzen und/oder verwalteten Elementen. ListCollectionView-Objekte sind normalerweise ArrayCollections, die in der Füllmethode bereitgestellt wurden. Die geeigneten Elemente für diese Methode sind alle verwalteten Versionen dieses Elements. Dies sind Elemente, die Sie von getItem oder createItem oder mithilfe der getItemAt-Methode für eine verwaltete Sammlung abrufen. Nur Änderungen für die Elemente, die durch einen der Werte in diesem Array definiert wurden, werden übernommen.
 
cascadeCommit:Boolean (default = false) — Bei true werden Änderungen auch an verknüpften Elementen, die in dieser Liste bereitgestellt werden, übernommen.

Rückgabewerte
mx.rpc:AsyncToken — AsyncToken, das in der call-Eigenschaft von ResultEvent.RESULT oder in FaultEvent.FAULT zurückgegeben wird. Benutzerdefinierte Daten können diesem Objekt hinzugefügt und später während der Ereignisverarbeitungsphase geprüft werden. Wenn in den relevanten Elementen keine Änderungen durchgeführt wurden, wird statt eines AsyncToken null zurückgegeben.

Auslöser
Error — ob die Initialisierung ausgeführt wird. Dies kann auftreten, wenn auf ein Laufzeitziel verwiesen und Commit vor der Initialisierung des Dienstes aufgerufen wird oder wenn die cacheID festgelegt und der lokale Cache nicht geladen wurde. Der Fehler kann in diesen Situationen vermieden werden, indem vor dem Aufruf von Commit auf das Ergebnis oder den Fehler für ein durch einen Initialisierungsaufruf oder durch einen vorherigen Vorgang zurückgegebenes Token gewartet wird.

commitRequiredOn

()Methode 
public function commitRequiredOn(object:Object):Boolean

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3.1
Laufzeitversionen: Flash Player 9, AIR 1.1

Zeigt an, ob ausstehende Änderungen für dieses bestimmte Objekt vorhanden sind. Ermöglicht granulare Aktivierung auf der Benutzeroberfläche. (siehe commitRequired für bindbare Eigenschaft für Benachrichtigung).

Parameter

object:Object — Das Objekt, bei dem möglicherweise Änderungen vorgenommen werden müssen.

Rückgabewerte
Booleantrue, wenn das Objekt ausstehende Änderungen aufweist.

connect

()Methode 
public function connect():mx.rpc:AsyncToken

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Erzwingt einen Verbindungsversuch dieses Dienstes mit dem Remote-Ziel. Diese Methode kann in Verbindung mit der autoConnect-Eigenschaft und der disconnect()-Methode zur Steuerung des Verbindungsstatus verwendet werden.

Rückgabewerte
mx.rpc:AsyncToken — AsyncToken-Verweis auf das Token, das diesen Vorgang in einem Ergebnis- oder Fehlerereignis identifizieren wird, das von diesem Dienst ausgelöst wird. Beim Aufruf von connect() wird immer die Ergebnisprozedur des Tokens aufgerufen und das Ergebnis ist der aktuelle Wert der connected-Eigenschaft des Dienstes.

count

()Methode 
public function count(... args):mx.rpc:AsyncToken

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Ruft eine Zählmethode im Remote-Ziel auf. Die aufgerufene Zählmethode basiert auf den verknüpften <count-method>-Tags und den übergebenen Parametern. Beispiel: Wenn der folgende count("firstName", "Bob")-Aufruf durchgeführt wurde und <count-method>-Tags vorhanden sind oder darauf in services-config.xml unter dem verknüpften Ziel verwiesen wird:

            <count-method>
                <name>getCount</name>
                <params>java.lang.String,java.lang.String</params>
                <security-run-as name="freddie" password="nightmare" />
            </count-method>
     
            <count-method>
                <name>getCount</name>
                <security-constraint ref="sample-users" />
            </count-method>
      
Die erste <count-method> mit der Run-as-Sicherheitseinstellung wird aufgerufen, da sie zwei Parameter enthält, die mit den <params>-Befehlstypen und -zählern übereinstimmen.

Parameter

... args — Liste mit Argumenten, die an das Remote-Ziel übergeben werden soll.

Rückgabewerte
mx.rpc:AsyncToken — Zurückgegebenes Objekt in der call-Eigenschaft des ResultEvent.RESULT oder des FaultEvent.FAULT. Benutzerdefinierte Daten können diesem Objekt hinzugefügt und später während der Ereignisverarbeitungsphase geprüft werden.

Verwandte API-Elemente

createItem

()Methode 
public function createItem(item:Object):ItemReference

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Fordert die Erstellung des festgelegten Elements im Remote-Speicher an. Wenn ein Fehler auftritt, wird ein DataConflictEvent-Ereignis ausgelöst.

Parameter

item:Object — Objekt, das im Remote-Speicher erstellt werden sollte.

Rückgabewerte
ItemReference — ItemReference (die das AsyncToken erweitert). Dieser Verweis wird in der token-Eigenschaft des ResultEvent.RESULT oder des FaultEvent.FAULT zurückgegeben. Benutzerdefinierte Daten können diesem Objekt hinzugefügt und später während der Ereignisverarbeitungsphase geprüft werden. Die result-Eigenschaft dieses Objekts ist bindbar und kann zum Binden des zurückgegebenen Elements verwendet werden. Dieses Ergebnisobjekt wird als null festgelegt, wenn das Element aus einem anderen Client entfernt wurde. Wenn ItemReference-Objekte in Ihrer Anwendung bestehen bleiben, sollten Sie die releaseItem()-Methode in der ItemReference-Instanz aufrufen, wenn Sie diesen Verweis auf das Element ausgeführt haben. Bleibt die ItemReference-Instanz nicht bestehen, können Sie die releaseItem()-Methode für die DataManager-Instanz verwenden. Dabei wird die Instanz des Elements selbst freigegeben. Wenn createItem() fehlschlägt, wird ein Fehler zurückgegeben. Das Element ist jedoch immer noch ausstehend. Sie müssen release() aufrufen, um es zu entfernen.

deleteItem

()Methode 
public function deleteItem(item:Object):mx.rpc:AsyncToken

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Fordert die Löschung des festgelegten Elements im Remote-Speicher an. Wenn ein Fehler auftritt, wird ein DataConflictEvent-Ereignis ausgelöst.

Parameter

item:Object — Objekt, das im Remote-Speicher gelöscht werden sollte.

Rückgabewerte
mx.rpc:AsyncToken — AsyncToken, das in der token-Eigenschaft des ResultEvent.RESULT oder des FaultEvent.FAULT zurückgegeben wird. Benutzerdefinierte Daten können diesem Objekt hinzugefügt und später während der Ereignisverarbeitungsphase geprüft werden.

disconnect

()Methode 
public function disconnect():void

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Trennt die Netzwerkverbindung der DataManager-Instanz. Diese Methode wartet nicht, bis anstehende Netzwerkvorgänge abgeschlossen sind.

executeQuery

()Methode 
public function executeQuery(queryName:String, propertySpecifier:PropertySpecifier, ... args):mx.rpc:AsyncToken

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Führt eine Abfrage mit dem bereitgestellten Namen und den Argumenten aus. Normalerweise verwenden Sie diese Methode mit einer RPCDataManager-Instanz, wo Abfragen einen festgelegten Namen haben. Sie können diese Methode auch mit Abfragen verwenden, die mithilfe des allgemeinen Füllmethodenansatzes definiert werden, sofern der erste Parameter der Füllmethode ein Stringwert ist. Der queryName wird als erster Füllparameter verwendet.

Sie müssen die releaseCollection()-Methode für Sammlungsergebnisse oder releaseItem für Einzelwertelementergebnisse aufrufen, wenn Sie mit den durch diese Methode zurückgegebenen Objekten fertig sind. Sie können stattdessen auch alle durch diese DataManager-Instanz abgerufenen verwalteten Verweise freigeben, indem Sie die release()-Methode aufrufen.

Rufen Sie die refreshCollection()-Methode auf, um den Inhalt einer durch diese Methode zurückgegebenen Sammlung zu aktualisieren.

Parameter

queryName:String — Name des aufzurufenden Vorgangs.
 
propertySpecifier:PropertySpecifier — Die abzurufenden Eigenschaften.
 
... args — Liste der Argumente für die Abfrage.

Rückgabewerte
mx.rpc:AsyncToken — AsyncToken-Bindung für die Ergebniseigenschaft des AsyncToken, die das Ergebnis abruft. Andernfalls können Sie auf das Änderungsereignis der Ergebniseigenschaft warten, dem Token einen oder mehrere Responder hinzufügen und zusätzliche Informationen als dynamische Eigenschaften des Token hinzufügen, um die Ergebnisse des Vorgangs zu protokollieren.

fill

()Methode 
public function fill(value:ListCollectionView, ... args):mx.rpc:AsyncToken

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Füllt die angegebene ListCollectionView(Sammlung)-Instanz anhand der verknüpften Füllmethode des Ziels. Dies ist zum Beispiel der Fall, wenn bei einem LiveCycle Data Services-Ziel, das einen Hibernate-Assembler verwendet, der erste Parameter der fill()-Methode die zu füllende Sammlung ist, der zweite Parameter die auszuführende Hibernate-Abfrage ist und alle anderen Parameter Hibernate-Abfrageparameter sind. Das gleiche Format ist auf die fill()-Methoden anwendbar, die in Service-Wrapper-Klassen für modellgesteuerte Entwicklung verwendet werden.

Die folgenden Beispiele zeigen eine fill()-Methode für ein Ziel, das einen Hibernate-Assembler verwendet. Der Assembler enthält eine Abfrage mit dem Namen getByDescription, die den Abfrageparameter description übernimmt:

     ProductService.fill(ac, "getByDescription", description);
     

Für ein LiveCycle Data Services-Ziel, das den Füllmethodenansatz verwendet, bei dem Füllmethoden in XML-Elementen in der Zielkonfiguration deklariert werden, wenn die folgenden <fill-method>-Elemente in der Zielkonfiguration vorhanden sind:

            <fill-method>
                <name>loadPersons</name>
                <params>java.lang.String,java.lang.String</params>
            </fill-method>
     
            <fill-method>
                <name>loadPersons</name>
                <security-constraint ref="sample-users" />
            </fill-method>
      
Der Aufruf von fill(myCollection, „firstName“, „Bob“) ruft die erste <fill-method> auf, da sie zwei Parameter enthält, die mit den <params>-Befehlstypen und -zählern übereinstimmen. Entsprechend wird durch fill(myCollection) das zweite <fill-method>-Tag aufgerufen, da es kein <params>-Tag enthält.

Ausstehende Änderungen an Elementen in dieser Sammlung werden entfernt. Beachten Sie, dass alle Daten in der Sammlung gelöscht werden, wenn Sie fill aufrufen. Sie können fill auch mithilfe einer vorher gefüllten Sammlung verwenden. In diesem Fall wird die Sammlung geleert, wenn die Füllparameter identisch sind, und die Füllmethode auf dem Server erneut aufgerufen. Bei unterschiedlichen Füllparametern wird die alte Sammlung freigegeben und die neue Sammlung gefüllt.

Parameter

value:ListCollectionView — Verweis auf die Sammlung, die mit den angegebenen Argumenten gefüllt werden soll.
 
... args — Array-Variablenliste mit Argumenten, die an das Remote-Ziel übergeben werden sollen.

Rückgabewerte
mx.rpc:AsyncToken — AsyncToken: Sie können dieses Token zur Registrierung einer oder mehrerer Rückruffunktionen verwenden, um Ergebnis- oder Fehlerereignisse von diesem Füllvorgang zu empfangen. Dieses Token wird auch in der call-Eigenschaft des ResultEvent.RESULToder des FaultEvent.FAULT zurückgegeben. Benutzerdefinierte Daten können diesem Objekt hinzugefügt und später während der Ereignisverarbeitungsphase geprüft werden.

fillSubset

()Methode 
public function fillSubset(value:ListCollectionView, ps:PropertySpecifier, ... args):mx.rpc:AsyncToken

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Füllt die angegebene ListCollectionView(Sammlung)-Instanz anhand der verknüpften Füllmethode des Ziels. Nur die im propertySpecifier-Parameter angegebene Untergruppe von Eigenschaften jedes Objekts wird ausgefüllt.

Parameter

value:ListCollectionView — Verweis auf die Sammlung, die mit den angegebenen Argumenten gefüllt werden soll.
 
ps:PropertySpecifier — An die Füllimplementierung des Servers zu übergebendes PropertySpecifier-Objekt, das die Untergruppe der Eigenschaften angibt, die für jedes Element ausgefüllt werden soll.
 
... args — Array-Variablenliste mit Argumenten, die an das Remote-Ziel übergeben werden sollen.

Rückgabewerte
mx.rpc:AsyncToken — AsyncToken: Sie können dieses Token zur Registrierung einer oder mehrerer Rückruffunktionen verwenden, um Ergebnis- oder Fehlerereignisse von diesem Füllvorgang zu empfangen. Dieses Token wird auch in der call-Eigenschaft des ResultEvent.RESULToder des FaultEvent.FAULT zurückgegeben. Benutzerdefinierte Daten können diesem Objekt hinzugefügt und später während der Ereignisverarbeitungsphase geprüft werden.

findItem

()Methode 
public function findItem(queryName:String, propertySpecifier:PropertySpecifier, ... args):mx.rpc:AsyncToken

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Führt eine Abfrage aus, die ein einzelnes Element zurückgibt.

Parameter

queryName:String — Name des aufzurufenden Vorgangs.
 
propertySpecifier:PropertySpecifier — Abzurufende Eigenschaften.
 
... args — Liste der Argumente für die Abfrage.

Rückgabewerte
mx.rpc:AsyncToken — AsyncToken-Bindung für die Ergebniseigenschaft des AsyncToken, die das Ergebnis abruft. Andernfalls können Sie auf das Änderungsereignis der Ergebniseigenschaft warten, dem Token einen oder mehrere Responder hinzufügen und zusätzliche Informationen als dynamische Eigenschaften des Token hinzufügen, um die Ergebnisse des Vorgangs zu protokollieren.

getCacheData

()Methode 
public function getCacheData(descriptor:CacheDataDescriptor):mx.rpc:AsyncToken

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Gibt eine ArrayCollection oder ein einzelnes verwaltetes Objekt vom lokalen Speicher zurück. Durch Aufrufen dieser Methode wird die letzte Zugriffszeit nicht aktualisiert.

Parameter

descriptor:CacheDataDescriptor — CacheDataDescriptor für die gewünschten Cache-Daten.

Rückgabewerte
mx.rpc:AsyncToken — AsyncToken-Verweis auf das Token, mit dem festgestellt werden kann, wann das Ergebnis oder der Fehler für diesen Vorgang aufgetreten ist. Die result-Eigenschaft des AsyncToken oder des verknüpften Ereignisses enthält eine neue Instanz einer nicht verwalteten ArrayCollection oder ItemReference für jeden Aufruf.

getCacheDescriptors

()Methode 
public function getCacheDescriptors(view:ListCollectionView, options:uint = 0, item:Object = null):mx.rpc:AsyncToken

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Füllt die festgelegte ListCollectionView(Sammlung)-Instanz mit CacheDataDescriptor-Instanzen. Wenn kein Argument festgelegt ist, werden alle verknüpften CacheDataDescriptor-Instanzen für zwischengespeicherte Daten unter diesem Dienst zurückgegeben.

Parameter

view:ListCollectionView — ListCollectionView-Verweis auf eine Sammlung, die mit den gewünschten Deskriptoren gefüllt werden kann.
 
options:uint (default = 0) — Muss eine der folgenden Konstanten sein:
  • CacheDataDescriptor.FILL – zeigt an, dass nur Deskriptoren für gefüllte Sammlungen in der Sammlung zurückgegeben werden sollten.
  • CacheDataDescriptor.ITEM – zeigt an, dass nur Deskriptoren für verwaltete Elemente in der Sammlung zurückgegeben werden sollten.
  • CacheDataDescriptor.ALL – [Standard] zeigt an, dass alle Deskriptoren zurückgegeben werden sollten.
 
item:Object (default = null) — Objektverweis auf eine festgelegte ItemReference, ein verwaltetes Element oder eine ListCollectionView, wobei der Parameter das Optionsargument überschreibt, wenn es festgelegt wird.

Rückgabewerte
mx.rpc:AsyncToken — AsyncToken-Verweis auf das Token, das diesen Vorgang in einem Ergebnis- oder Fehlerereignis identifizieren wird, das von diesem Dienst ausgelöst wird.

getCacheIDs

()Methode 
public function getCacheIDs(view:ListCollectionView):mx.rpc:AsyncToken

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Füllt die festgelegte ListCollectionView(Sammlung)-Instanz mit allen Cache-Bezeichnern, die zuvor in der Anwendung verwendet wurden.

Parameter

view:ListCollectionView — ListcollectionView-Verweis auf eine Sammlung, die mit allen Cache-Bezeichnern gefüllt werden soll, die zuvor in der Anwendung verwendet wurden.

Rückgabewerte
mx.rpc:AsyncToken — AsyncToken-Verweis auf das Token, das diesen Vorgang in einem Ergebnis- oder Fehlerereignis identifizieren wird, das von diesem Dienst ausgelöst wird.

getItem

()Methode 
public function getItem(identity:Object, defaultValue:Object = null):ItemReference

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Erstellt eine asynchrone Anforderung für ein Element, das mit der festgelegten Identität übereinstimmt. Wenn Sie einen defaultValue bereitstellen und das Element nicht vorhanden ist, wird das Element stattdessen mithilfe der Informationen im defaultValue erstellt. Diese Methode gibt eine ItemReference-Instanz zurück. Wenn Sie eine gültige Instanz vom Aufruf der getItem()-Methode empfangen, müssen Sie die releaseItem()-Methode aufrufen, um eine Instanz des Elements freizugeben. Wenn die ItemReference-Instanz erhalten bleibt, sollten Sie die releaseItem()-Methode für den Verweis aufrufen, um sicherzustellen, dass Sie den richtigen Verweis (für den Fall, dass Ihr Client die getItem()-Methode mehrfach für das gleiche Element aufgerufen hat) freigeben. Wenn die ItemReference-Instanz nicht erhalten bleibt, können Sie die releaseItem()-Methode auf dem DataManager mit dem eigentlichen Element aufrufen.

Parameter

identity:Object — Objekt, das die Identitätseigenschaften für das gewünschte Objekt enthält.
 
defaultValue:Object (default = null) — Eine Instanz des Typs mit den Standardwerten, die erstellt werden sollte, wenn sie nicht vorhanden ist.

Rückgabewerte
ItemReference — ItemReference-Instanz für das Element, das Sie abrufen möchten. Die ItemReference-Instanz erweitert AsyncToken, sodass Sie es zum Empfangen von Benachrichtigungen verwenden können, wenn das Element abgerufen wurde oder wenn dieser Aufruf einen Fehler generiert. Die ItemReference-Instanz wird als token-Eigenschaft des ResultEvent.RESULT oder des FaultEvent.FAULT zurückgegeben, wenn Sie auf Ereignisse im DataService-Objekt warten. Benutzerdefinierte Daten können diesem Objekt hinzugefügt und später während der Ereignisverarbeitungsphase geprüft werden. Außerdem können Sie mithilfe von Datenbindung die result-Eigenschaft der ItemReference-Instanz binden Für diese Eigenschaft wird ein gültiger Wert festgelegt, wenn das Element vom Remote-Ziel gefüllt wird. Sie ist bindbar, sodass Sie einfach die Benutzeroberflächen-Steuerelemente an die Eigenschaften der result-Eigenschaft der ItemReference binden können. Wenn das Element vom Server oder einem anderen Client entfernt wurde, wird dieser Verweis als null festgelegt. Die ItemReference hat auch eine invalid-Eigenschaft, die als true festgelegt ist, wenn Fehler bei der Rückgabe des Elements auftreten oder wenn der Server null für ein Element zurückgibt.

getLocalItem

()Methode 
public function getLocalItem(identity:Object):Object

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Sucht das zur Verfügung gestellt Element mit der gegebenen Identität. Ist das Element bereits auf dem Client verwaltet, wird die verwaltete Instanz zurückgegeben. Wenn nicht, wird null zurückgegeben. Im Gegensatz zum Aufruf der getItem-Methode erstellt dieser Aufruf keine Anforderung an den Server und fügt dem Element keinen zusätzlichen Verweis hinzu.

Parameter

identity:Object — Objekt, das die Identitätseigenschaften für das gewünschte Objekt enthält.

Rückgabewerte
Object — Objekt: Das verwaltete Objekt oder null, wenn das Element mit dieser ID noch nicht auf diesem Client verwaltet wird.

getPageInformation

()Methode 
public function getPageInformation(view:ListCollectionView):PageInformation

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Gibt die Seiteninformationen für die angegebene Sammlung zurück.

Parameter

view:ListCollectionView — Relevante Sammlung.

Rückgabewerte
PageInformation — Seiteninformationen für die angegebene Sammlung.

getPendingOperation

()Methode 
public function getPendingOperation(item:Object):uint

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Gibt den ausstehenden Vorgang im Meldungscache für das festgelegte Element zurück. Verwenden Sie diese Methode, um einem Benutzer visuelles Feedback über den Typ der Änderungen am Element bereitzustellen, falls vorhanden.

Parameter

item:Object — IManaged-Objekt, das überprüft werden soll.

Rückgabewerte
uint — uint-Klasse, die anzeigt, welcher ausstehender Vorgang ausgeführt wurde. Gültige Vorgänge für ein Element:
  • DataMessage.CREATE_OPERATION - zeigt an, dass ein Erstellungsvorgang für das festgelegte Element aussteht.
  • DataMessage.DELETE_OPERATION - zeigt an, dass ein Löschvorgang für das festgelegte Element aussteht.
  • DataMessage.UPDATE_OPERATION - zeigt an, dass Aktualisierungen für das festgelegte Element ausstehen.
  • DataMessage.UNKNOWN_OPERATION - zeigt an, dass keine Vorgänge für das festgelegte Element ausstehen.

initialize

()Methode 
public function initialize():mx.rpc:AsyncToken

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Erzwingt die Initialisierung des DataStore.

Rückgabewerte
mx.rpc:AsyncToken — AsyncToken-Verweis auf das Token, das diesen Vorgang in einem Ergebnis- oder Fehlerereignis identifizieren wird, das von diesem Dienst ausgelöst wird.

isCollectionManaged

()Methode 
public function isCollectionManaged(view:ListCollectionView):Boolean

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Gibt „true“ zurück, wenn die übergebene Sammlung von diesem Dienst verwaltet wird. Wenn die Sammlung von diesem Dienst verwaltet wird, ist es sicher, die Sammlung an releaseCollection() zu übergeben, um sie aus der Verwaltung zu entlassen.

Parameter

view:ListCollectionView — Der ListCollectionView-Verweis, um zu testen, ob die Verwaltung durch den Dienst erfolgt.

Rückgabewerte
Boolean — Als „true“ festgelegt, wenn die Sammlung von diesem Dienst verwaltet wird, andernfalls „false“.

isCollectionPaged

()Methode 
public function isCollectionPaged(view:ListCollectionView):Boolean

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Gibt „true“ zurück, wenn die übergebene Sammlung Pagingfunktionen verwendet. Wenn durch diesen Dienst eine Seitenerstellung für diese Sammlung bereitgestellt wird, ist es sicher, die Sammlung an releaseItemsFromCollection() zu übergeben, um einzelne Elemente in der Sammlung von der Verwaltung zu entlassen.

Parameter

view:ListCollectionView — Der ListCollectionView-Verweis, um zu testen, ob die Verwaltung durch den Dienst erfolgt.

Rückgabewerte
Boolean — Als „true“ festgelegt, wenn die Sammlung Paging verwendet, andernfalls „false“.

isRangeResident

()Methode 
public function isRangeResident(view:ListCollectionView, startIndex:int, numberOfItems:int):Boolean

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Gibt „true“ zurück, wenn der bereitgestellte Bereich mit Elementen vollständig im Seitenbereich liegt. Andernfalls wird „false“ zurückgegeben.

Parameter

view:ListCollectionView — Eine von diesem Datendienst verwaltete ListCollectionView.
 
startIndex:int — Die Anfangsindexposition in der ListCollectionView.
 
numberOfItems:int — Die Anzahl der Elemente in der ListCollectionView.

Rückgabewerte
Boolean — Der Wert ist true, wenn die Sammlung vollständig resident ist und false, wenn Elemente im bereitgestellten Bereich nicht resident sind.

localFill

()Methode 
public function localFill(value:ListCollectionView, ps:PropertySpecifier, ... args):mx.rpc:AsyncToken

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Füllt die angegebene ListCollectionView basierend auf den verknüpften <fill-method>-Elementen anhand von Daten aus dem lokalen Speicher. Ruft die offlineAdapter.executeOfflineQuery()-API auf, um die Daten abzufragen, und versucht nicht das Remote-Ziel abzufragen, selbst wenn die Anwendung verbunden ist. Dies wird idealerweise dort verwendet, wo die Daten mit dem Client synchronisiert werden und lokale Abfragen daran ausgeführt werden.

Parameter

value:ListCollectionView — Verweis auf die Sammlung, die mit den angegebenen Argumenten gefüllt werden soll.
 
ps:PropertySpecifier — Ein an den Offline-Adapter zu übergebendes PropertySpecifier-Objekt, das die Untergruppe der Eigenschaften angibt, die für jedes Element ausgefüllt werden soll.
 
... args — args:Array-Variablenliste mit Argumenten, die an den Offline-Adapter übergeben werden sollen.

Rückgabewerte
mx.rpc:AsyncToken — AsyncToken: Sie können dieses Token zur Registrierung einer oder mehrerer Rückruffunktionen verwenden, um Ergebnis- oder Fehlerereignisse von diesem lokalen Füllvorgang zu empfangen. Dieses Token wird auch in der call-Eigenschaft des ResultEvent.RESULToder des FaultEvent.FAULT zurückgegeben.

merge

()Methode 
public function merge():void

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Führt ausstehende Aktualisierungen in den verwalteten Objektsatz zusammen. Der Prozess des Zusammenführens von Änderungen erkennt Konflikte und verarbeitet ausstehende Elementanforderungen. Dies führt alle Meldungen für andere DataManager-Instanzen zusammen, die diese DataStore-Instanz gemeinsam verwenden.

refresh

()Methode 
public function refresh():mx.rpc:AsyncToken

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Aktualisiert alle Daten, die von dieser DataManager-Instanz verwaltet werden. Fills, getItem- und Seitenanforderungen werden auf dem Server ausgeführt, um alle verwalteten Elemente erneut abzurufen. Rufen Sie die DataStore.refresh()-Methode auf, um auch alle verknüpften Elemente für Verknüpfungen mit träge = true zu aktualisieren.

Rückgabewerte
mx.rpc:AsyncToken — AsyncToken: Sie können für die Ergebnis- oder Fehlereignisse dieses Aktualisierungsvorgangs dieses Token zur Registrierung einer oder mehrerer Rückruffunktionen verwenden.

refreshCollection

()Methode 
public function refreshCollection(value:ListCollectionView):mx.rpc:AsyncToken

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Aktualisiert eine Sammlung, die zuvor mit der Füllmethode gefüllt oder als eine verwaltete Verknüpfung verwaltet wurde. Diese Methode führt eine Anforderung an den Server aus und ruft die neue Version von residenten Elementen in der Sammlung entweder mithilfe der ursprünglichen Füllparameter, die bei dieser Sammlung verwendet wurden, oder durch Aufrufen der Eigenschaft vom übergeordneten Element ab. Wenn Änderungen gefunden werden, führt dies zu einem inkrementellen Zusammenführen in die Sammlung.

Parameter

value:ListCollectionView — ListCollectionView, die von dieser DataManager-Instanz verwaltet wird.

Rückgabewerte
mx.rpc:AsyncToken — AsyncToken: Sie können dieses Token zur Registrierung einer oder mehrerer Rückruffunktionen verwenden, um Ergebnis- oder Fehlerereignisse von diesem Aktualisierungsvorgang zu empfangen. Für den Fall, dass in einer Sammlung mit Seitenerstellung keine Aktualisierung erforderlich ist, wird null zurückgegeben. Dieses Token wird auch in der call-Eigenschaft des ResultEvent.RESULToder des FaultEvent.FAULT zurückgegeben. Benutzerdefinierte Daten können diesem Objekt hinzugefügt und später während der Ereignisverarbeitungsphase geprüft werden.

release

()Methode 
public function release(clear:Boolean = true, copyStillManagedItems:Boolean = true):void

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Gibt alle verwalteten Sammlungen und Elemente für die DataManager-Instanz frei.

Parameter

clear:Boolean (default = true) — Boolescher Wert, der anzeigt, ob alle Elemente aus der Liste entfernt werden sollten. Außerdem werden keine Kopien von den Elementen erstellt.
 
copyStillManagedItems:Boolean (default = true) — Gibt an, ob nach dem Freigeben dieses Datendienstes Verweise von verwalteten Verknüpfungen aus anderen Datendiensten Verweise auf einige dieser verwalteten Objekte enthalten können. In diesem Fall werden möglicherweise einige verwaltete Sammlungen in diesem Datendienst weiterhin aktiv verwaltet. Wenn Sie für diesen Flag „true“ übergeben, werden diese Verweise entfernt (clear=true) oder geklont (clear=false). Wenn Sie für diesen Flag „false“ übergeben, werden diese aktiven Verweise beibehalten. Die Verwendung von „false“ ist die schnellste Möglichkeit zum Löschen des Systemstatus. Die Verwendung von true stellt sicher, dass keine verwalteten Status als Verweise auf Sammlungen oder Elemente vorhanden sind, die von diesem Datendienst abgerufen wurden.

Verwandte API-Elemente

releaseCollection

()Methode 
public function releaseCollection(view:ListCollectionView, clear:Boolean = false, copyStillManagedItems:Boolean = true):void

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Entlässt ein beliebiges Element innerhalb der festgelegten Sammlung aus der Verwaltung durch diese DataManager-Instanz. Wenn das Element in mehr als einer Sammlung vorhanden ist, wird eine Kopie des Elements erstellt. Alle nicht übernommenen Änderungen an Elementen, die nur in dieser Sammlung vorhanden sind, werden freigegeben, einschließlich der Lösch-, Erstellungs- und Aktualisierungsvorgänge.

Parameter

view:ListCollectionView — ListCollectionView-Verweis, der keine Remote-Aktualisierungen mehr erhalten sollten.
 
clear:Boolean (default = false) — Gibt an, ob alle Elemente aus der Liste entfernt werden sollen. Außerdem werden keine Kopien von den Elementen erstellt.
 
copyStillManagedItems:Boolean (default = true) — Gibt an, ob andere verwaltete Verweise auf Elemente in dieser Sammlung vorhanden sind. Dieser Parameter bestimmt, ob Kopien dieser Elemente erstellt werden, sodass nach diesem Aufruf garantiert keine verwalteten Elemente mehr in der Sammlung vorhanden sind. Das Festlegen von „clear“ und dieser Option als „false“ ist die schnellste Möglichkeit zum Freigeben von verwalteten Verweisen.

releaseItem

()Methode 
public function releaseItem(item:IManaged, copyStillManagedItems:Boolean = true, enableStillManagedCheck:Boolean = true):IManaged

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Entlässt das festgelegte Element aus der Verwaltung durch diese DataManager-Instanz. Wenn eine ItemReference-Instanz erhalten bleibt, sollten Sie die releaseItem()-Methode für die ItemReference-Instanz aufrufen. Falls mehrere getItem()-Aufrufe erfolgt sind, die das gleiche Element von verschiedenen Teilen Ihrer Clientanwendung abrufen, wird dadurch sichergestellt, dass Sie den richtigen Verweis freigeben.

Dieser Aufruf gibt verknüpfte Ressourcen einschließlich verschachtelter Eigenschaften frei. Das festgelegte Element empfängt keine Aktualisierungen mehr vom Remote-Ziel. Wenn nicht übernommene Änderungen für das Element vorhanden sind und es nicht in einer anderen Sammlung erscheint, werden diese Änderungen ebenfalls freigegeben. Wenn das festgelegte Element in mehr als einer Sammlung vorhanden ist, ist der zurückgegebene Wert eine Kopie des Originals, sofern der allowCopy-Parameter nicht als false festgelegt ist.

Parameter

item:IManaged — IManaged-Verweis auf das freizugebende Element.
 
copyStillManagedItems:Boolean (default = true) — Boolescher Wert, der anzeigt, ob von den Elementen Kopien erstellt werden sollten, die weiterhin im Objektdiagramm verwaltet werden. Wird der Wert false übergeben, wird der Verweis auf diese Elemente gelöscht.
 
enableStillManagedCheck:Boolean (default = true) — Wird für diesen Parameter false übergeben, wird das Kopieren oder das Löschen von noch verwalteten Elementen deaktiviert. In diesem Fall ist der zurückgegebene Wert immer der ursprünglich verwaltete Wert, den Sie freigegeben haben. Wenn ein anderer Verweis dieses Element immer noch verwendet, wird es auch nach der Freigabe immer noch verwaltet.

Rückgabewerte
IManaged — Das freigegebene Element, das eine Kopie ist, wenn copyStillManagedItems false ist und das Element von einem anderen Verweis verwaltet wird.

releaseItemsFromCollection

()Methode 
public function releaseItemsFromCollection(collection:ListCollectionView, startIndex:int, numberOfItems:int):int

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Gibt einen Bereich von Elementen aus der Sammlung frei. Beim Blättern durch eine große Sammlung möchten Sie möglicherweise Ressourcen, die von Elementen in der Sammlung verwendet werden, freisetzen und das Aktualisierungsabonnement für diese Elemente beenden. Sie legen den startIndex für das erste freizugebende Element und die Anzahl der freizugebenden Elemente fest. Wurde für ein Element an dieser Position noch keine Seite erstellt, wird diese Indexposition übersprungen.

Parameter

collection:ListCollectionView — Verwaltete ListCollectionView.
 
startIndex:int — Indexposition des ersten freizugebenden Elements.
 
numberOfItems:int — Anzahl der freizugebenden Elemente, beginnend an dieser Position. numberOfItems sollte größer als 0 und startIndex + numberOfItems sollte kleiner als collection.length sein.

Rückgabewerte
int — Die Anzahl der freigegebenen Verweise.

releaseReference

()Methode 
public function releaseReference(item:Object, propName:String):Boolean

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Gibt den Wert für eine Einzelwertverknüpfung frei. Wenn der Wert nicht vollständig im Seitenbereich liegt, wird „false“ zurückgegeben. Wenn der Wert im Seitenbereich liegt, wird der Verweis freigegeben und „true“ zurückgegeben. Wenn dies der letzte Verweis auf ein bestimmtes Element war, führt der nächste Zugriffsversuch auf dieses Element zu einem ItemPendingError und der Wert muss erneut abgerufen werden.

Parameter

item:Object — Übergeordnetes Element mit einer Eigenschaft, die eine Einzelwertverknüpfung darstellt.
 
propName:String — Name der Eigenschaft, die auf eine Einzelwertverknüpfung verweist.

Rückgabewerte
Boolean — Bei „true“ wurde der Wert freigegeben.

revertChanges

()Methode 
public function revertChanges(item:IManaged = null):Boolean

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Stellt den vorherigen Zustand für nicht übernommene Änderungen am festgelegten Element wieder her. Wenn kein Element zur Verfügung gestellt wird, wird der vorherige Zustand für alle nicht übernommenen Änderungen wiederhergestellt. Wenn Sie einen Erstellungsvorgang auf diese Weise zurücksetzen, wird dadurch das Element entfernt. Wenn Sie einen Löschvorgang auf diese Weise zurücksetzen, wird dadurch das Element entfernt. Das Zurücksetzen einer Aktualisierung stellt die Originaleigenschaften des Elements wieder her, die vor der Änderung vorhanden waren. Das Aufrufen dieser Methode ist äquivalent zum Aufruf der dataStore.revertChanges()-Methode.

Zu den Situationen, in der Sie diese Methode verwenden würden, gehört das Auftreten eines Fehlers. In diesem Fall werden fehlgeschlagene Änderungen in die Liste der nicht übernommenen Änderungen zurückgelegt. An diesem Punkt können Sie entweder diese Änderungen modifizieren, um das Problem zu beheben, oder Sie setzen sie mithilfe dieser Methode wieder zurück, damit diese Änderungen nicht erneut gesendet werden.

Wenn ein Element bereitgestellt wird und dieses Element keine Änderungen hat, gibt diese Methode „false“ zurück. Wenn kein Element bereitgestellt wird und keine Änderungen vorhanden sind, gibt diese Methode „false“ zurück. Andernfalls wird „true“ zurückgegeben.

Parameter

item:IManaged (default = null) — Verweis, für dessen Änderungen der vorherige Zustand wiederhergestellt werden soll, oder null, um alle Änderungen zurückzusetzen

Rückgabewerte
Boolean — Boolescher Wert, der anzeigt, ob Änderungen zurückgesetzt wurden.

revertChangesForCollection

()Methode 
public function revertChangesForCollection(collection:ListCollectionView = null):Boolean

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Setzt die Änderungen für ein beliebiges Element aus der angegebenen Sammlung zurück, das durch diese DataManager-Instanz verwaltet werden sollte.

Parameter

collection:ListCollectionView (default = null) — Die wiederherzustellende Sammlung.

Rückgabewerte
Boolean — Der boolesche Wert, „true“, wenn Änderungen zurückgesetzt wurden.

saveCache

()Methode 
public function saveCache(value:Object = null):mx.rpc:AsyncToken

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Diese Methode speichert den aktuellen Status des Cache der DataManager-Instanz. Der Cache enthält In-Memory-Elemente und an denjenigen Elementen durchgeführte Änderungen, die nicht an das Remote-Ziel gesendet wurden.

Parameter

value:Object (default = null) — Objektverweise auf eine verwaltete ListCollectionView-Instanz oder ein Objekt.

Rückgabewerte
mx.rpc:AsyncToken — AsyncToken, das zur Benachrichtigung verwendet werden kann, wenn ein Vorgang erfolgreich abgeschlossen oder fehlgeschlagen ist.

Verwandte API-Elemente

autoSaveCache

Beispiel  ( Verwendung dieses Beispiels )
         var customerService:DataService = new DataService("customers");
         var customers:ArrayCollection = new ArrayCollection();
         customerService.fill(customers);
         // ...
         var customer:Customer = Customer(customers[0]);
         customer.priority = "top";
         customerService.saveCache();
         // now all of the changes and items in the customers collection
         // will be persisted locally
      

saveCacheRequiredOn

()Methode 
public function saveCacheRequiredOn(object:Object):Boolean

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 4.5
Laufzeitversionen: Flash Player 9, AIR 1.1

Gibt an, ob für dieses bestimmte Objekt Änderungen ausstehen, die nicht in den lokalen Cache gespeichert werden. Diese Methode kann „false“ zurückgeben, wenn comitRequiredOn „true“ zurückgeben würde; damit wird angegeben, dass die Änderung im lokalen Cache gespeichert, aber nicht an den Server übergeben wird.

Parameter

object:Object — Das Objekt, bei dem möglicherweise Änderungen vorgenommen werden müssen.

Rückgabewerte
Booleantrue, wenn das Objekt ausstehende Änderungen aufweist.

synchronizeAllFills

()Methode 
public function synchronizeAllFills():mx.rpc:AsyncToken

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 4.5
Laufzeitversionen: Flash Player 10.1, AIR 2.0

Ruft die geänderten Elemente für alle vorherigen ausgeführten Füllungen in diesem Datendienst (Datenmanager) ab.

Rückgabewerte
mx.rpc:AsyncToken — AsyncToken: Sie können dieses Token zur Registrierung einer oder mehrerer Rückruffunktionen verwenden, um Ergebnis- oder Fehlerereignisse von diesem Vorgang zu empfangen.

synchronizeDataServices

()Methode 
public static function synchronizeDataServices(services:Array):mx.rpc:AsyncToken

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 4.5
Laufzeitversionen: Flash Player 10.1, AIR 2.0

Eine Vereinfachungsmethode, die die Synchronisierung aller lokalen Daten ermöglicht: Eine synchronizeAllFills() wird für jeden Datendienst (Datenmanager) aufgerufen, der so angegeben ist, dass das endgültige Ergebnistoken nur dann abgeschlossen wird, wenn alle einzelnen synchronizeAllFills()-Aufrufe abgeschlossen sind.

Parameter

services:Array — Ein Array von zu synchronisierenden Datendiensten.

Rückgabewerte
mx.rpc:AsyncToken — AsyncToken: Sie können dieses Token zur Registrierung einer oder mehrerer Rückruffunktionen verwenden, um Ergebnis- oder Fehlerereignisse von diesem Vorgang zu empfangen.

synchronizeFill

()Methode 
public function synchronizeFill(... fillArgs):mx.rpc:AsyncToken

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 4.5
Laufzeitversionen: Flash Player 10.1, AIR 2.0

Ruft die geänderten Elemente ab, die sich auf dem Server geändert haben, seit eine fill oder synchronizeFill das letzte Mal aufgerufen wurde. Diese beinhalten erstellte, aktualisierte und gelöschte Elemente. Wenn keine vorherige Füllung vorhanden ist, entspricht dies der Durchführung einer erstmaligen Füllung.

Parameter

... fillArgs — fillArgs: Die Parameter der Füllung.

Rückgabewerte
mx.rpc:AsyncToken — AsyncToken: Sie können dieses Token zur Registrierung einer oder mehrerer Rückruffunktionen verwenden, um Ergebnis- oder Fehlerereignisse von diesem Füllvorgang zu empfangen. Eine ChangedItems-Instanz wird als Ergebnisobjekt im ResultEvent, das an die Ergebnisprozedur übergeben wird, verwendet, wobei die geänderten Elemente, die zurückgegeben wurden, beschrieben werden.

updateItem

()Methode 
public function updateItem(item:Object, origItem:Object = null, changes:Array = null):mx.rpc:AsyncToken

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Löst eine Aktualisierung des angegebenen Elements aus. Wenn Sie diese Methode für eine verwaltete Instanz aufrufen, werden alle Änderungen an diesem Element übernommen und ein Token zur Verfolgung der Änderungen wird zurückgegeben. Wenn keine Änderungen für dieses Element ausstehen, wird ein Null-Token zurückgegeben. Wenn Sie diesen Aufruf mit einer anderen Kopie der Instanz ausführen, werden geänderte Eigenschaften im Änderungsarray in die verwaltete Instanz kopiert, wobei Änderungen protokolliert und dann übernommen werden. Wenn autoCommit auf true gesetzt ist, werden die Änderungen an diesem Element sofort übernommen. Wenn der Wert auf false gesetzt ist, verbleiben Änderungen in der Warteschlange, bis die commit()-Methode aufgerufen wird.

Parameter

item:Object — Das zu aktualisierende Element.
 
origItem:Object (default = null) — Version des Elements, bevor Änderungen vorgenommen wurden. Diese Version wird zur Konflikterkennung verwendet. Kann „null“ entsprechen.
 
changes:Array (default = null) — Array von Eigenschaftsnamen, die aktualisiert wurden. Wird zur Leistungssteigerung verwendet. Kann „null“ entsprechen.

Rückgabewerte
mx.rpc:AsyncToken — Ein AsyncToken, mit dem Sie Änderungen verfolgen können (z. B. wenn ein Fehler- oder Ergebnisereignis beim Übernehmen von Änderungen an diesem Element ausgelöst wird). Wenn ein Element nicht geändert wurde, wird ein Null-AsyncToken zurückgegeben und es wird nichts in die Warteschlange gestellt.
Ereignisdetails

conflict

Ereignis
Ereignisobjekttyp: mx.data.events.DataConflictEvent
Eigenschaft DataConflictEvent.type = mx.data.events.DataConflictEvent.CONFLICT

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Das DataConflictEvent.CONFLICT-Ereignis wird ausgelöst, wenn ein Konflikt zwischen ausstehenden lokalen Änderungen und von anderen Clients übertragenen Änderungen erkannt wird, oder wenn von diesem Client übertragene Änderungen einen Konflikt mit Änderungen im Remote-Ziel haben. Jeder DataService sendet Konfliktereignisse nur für Elemente dieses bestimmten Ziels. Verwenden Sie das Konfliktereignis im DataService, wenn Sie Konflikte für eine Reihe von verwandten Zielen gleichzeitig verarbeiten müssen.

Die CONFLICT-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein conflict-Ereignis.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

EigenschaftWert
bubblesfalse
cancelablefalse
currentTargetDas Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise myButton.addEventListener() zur Registrierung eines Ereignis-Listeners verwenden, weist currentTarget den Wert „myButton“ auf.
conflict Das Conflict-Objekt, das den aufgetretenen Konflikt enthält.
message Die mit diesem Ereignis verknüpfte Meldung.
targetDas Objekt, von dem das Ereignis ausgelöst wurde. Dies ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die currentTarget-Eigenschaft, damit immer auf das Objekt, das auf das Ereignis wartet, zugegriffen wird.

fault

Ereignis  
Ereignisobjekttyp: mx.data.events.DataServiceFaultEvent
Eigenschaft DataServiceFaultEvent.type = mx.data.events.DataServiceFaultEvent.FAULT

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Das DataManagerFaultEvent.FAULT-Ereignis wird ausgelöst, wenn ein Dienstaufruf aufgrund eines Fehlers fehlschlägt. Dieses Ereignis wird beispielsweise ausgelöst, wenn ein Aufruf der fill()-Methode fehlschlägt. Außerdem wird dieses Ereignis für jedes Element ausgelöst, das einen Fehler als Teil eines Commit-Ergebnisses generiert. In diesem Fall enthält das DataServiceFaultEvent das vom Commit-Vorgang zurückgegebene Token; die Element- und Fehlermeldungsstrings im Fehler sind jedoch vom Element festgelegt, das den Fehler verursacht hat.

Die FAULT-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein fault-Ereignis.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

EigenschaftWert
bubblesfalse
cancelable„true“; durch Aufrufen von „preventDefault()“ von der responder.fault-Methode des verknüpften Tokens wird das Auslösen dieses Ereignisses durch den Dienst oder den Vorgang verhindert.
currentTargetDas Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise myButton.addEventListener() zur Registrierung eines Ereignis-Listeners verwenden, weist currentTarget den Wert „myButton“ auf.
fault Das Fault-Objekt, das den aufgetretenen Konflikt enthält.
item Das Element, das den Fehler erzeugt hat.
identity Die Identität des Elements, das den Fehler erzeugt hat.
message Die mit diesem Ereignis verknüpfte Meldung.
token Das Token, das den Aufruf der Methode darstellt. Wird im asynchronen Abschluss-Token-Muster verwendet.
targetDas Objekt, von dem das Ereignis ausgelöst wurde. Dies ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die currentTarget-Eigenschaft, damit immer auf das Objekt, das auf das Ereignis wartet, zugegriffen wird.

message

Ereignis  
Ereignisobjekttyp: mx.messaging.events.MessageEvent
Eigenschaft MessageEvent.type = mx.messaging.events.MessageEvent.MESSAGE

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Das MessageEvent.MESSAGE-Ereignis wird ausgelöst, wenn das Remote-Ziel eine Benachrichtigung zu einem Datenvorgang ausgibt. Beispiel: Bei der Aktualisierung von Daten im Remote-Ziel wird ein Aktualisierungsvorgang zu allen wartenden Clients gesendet und dieser Vorgang wird in diesem DataService in ein Meldungsereignis konvertiert.

Der Ereignistyp MESSAGE. Wird nach Erhalt einer Meldung ausgelöst.

Der Wert dieser Konstante ist "message".

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

EigenschaftWert
bubblesfalse
cancelablefalse
currentTargetDas Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise myButton.addEventListener() zur Registrierung eines Ereignis-Listeners verwenden, weist currentTarget den Wert „myButton“ auf.
messageDie Meldung, die mit diesem Ereignis verknüpft ist.
targetDas Objekt, von dem das Ereignis ausgelöst wurde. Dies ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die currentTarget-Eigenschaft, damit immer auf das Objekt, das auf das Ereignis wartet, zugegriffen wird.

propertyChange

Ereignis  
Ereignisobjekttyp: mx.events.PropertyChangeEvent
Eigenschaft PropertyChangeEvent.type = mx.events.PropertyChangeEvent.PROPERTY_CHANGE

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Das PropertyChangeEvent.PROPERTY_CHANGE-Ereignis wird bei Änderung einer Eigenschaft dieses Dienstes ausgelöst. Dies trifft auf folgende Eigenschaften zu:

  • commitRequired
  • mergeRequired
  • connected

Die PropertyChangeEvent.PROPERTY_CHANGE-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein PropertyChange-Ereignis.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

EigenschaftWert
bubblesWird vom Konstruktor bestimmt; standardmäßig „false“.
cancelableWird vom Konstruktor bestimmt; standardmäßig „false“.
kindArt der Änderung; PropertyChangeEventKind.UPDATE oder PropertyChangeEventKind.DELETE.
oldValueDer ursprüngliche Eigenschaftswert.
newValueDer neue Eigenschaftswert, falls vorhanden.
propertyDie geänderte Eigenschaft.
sourceDas Objekt mit der geänderten Eigenschaft.
currentTargetDas Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise myButton.addEventListener() zur Registrierung eines Ereignis-Listeners verwenden, weist currentTarget den Wert „myButton“ auf.
targetDas Objekt, von dem das Ereignis ausgelöst wurde. Dies ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die currentTarget-Eigenschaft, damit immer auf das Objekt, das auf das Ereignis wartet, zugegriffen wird.

result

Ereignis  
Ereignisobjekttyp: mx.rpc.events.ResultEvent
Eigenschaft ResultEvent.type = mx.rpc.events.ResultEvent.RESULT

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Das ResultEvent.RESULT wird ausgelöst, wenn ein Dienstaufruf erfolgreich zurückgegeben wird. Beispielsweise führt ein Aufruf von fill() dazu, dass dieses Ereignis ausgelöst wird, wenn der Aufruf erfolgreich ist.

Der RESULT-Ereignistyp.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

EigenschaftWert
bubblesfalse
cancelabletrue, preventDefault() aus der verknüpften responder.result-Methode des Token verhindert, dass der Dienst oder der Vorgang dieses Ereignis auslöst.
currentTargetDas Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise myButton.addEventListener() zur Registrierung eines Ereignis-Listeners verwenden, weist currentTarget den Wert „myButton“ auf.
message Die mit diesem Ereignis verknüpfte Meldung.
targetDas Objekt, von dem das Ereignis ausgelöst wurde. Dies ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die currentTarget-Eigenschaft, damit immer auf das Objekt, das auf das Ereignis wartet, zugegriffen wird.
resultVom RPC-Aufruf zurückgegebenes Ergebnis.
tokenToken, das den einzelnen Aufruf der Methode darstellt. Wird im asynchronen Abschluss-Token-Muster verwendet.




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.