Paket | mx.data |
Klasse | public class DataManager |
Vererbung | DataManager 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 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 Wertfalse
ist, müssen Sie einen expliziten Aufruf dercommit()
-Methode vornehmen. Verwenden Sie die bindbareDataManager.commitRequired
-Eigenschaft, um zu bestimmen, ob nicht übernommene Änderungen vorhanden sind. -
autoSyncEnabled
– Dies betrifft alle Aufrufe derfill()
-,getItem()
- odercreateItem()
-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 dieDataManager.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
mx.data.RPCDataManager
mx.data.Conflicts
mx.data.Conflict
mx.data.ItemReference
mx.data.IManaged
mx.data.utils.Managed
mx.data.IChangeObject
Eigenschaft | Definiert 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 | ||
constructor : 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 |
Methode | Definiert 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 | ||
Ü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 | ||
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 | ||
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 | ||
getCacheDescriptors(view:ListCollectionView, options:uint = 0, item:Object = null):mx.rpc:AsyncToken
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 | ||
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 | ||
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 | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
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 | ||
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 | ||
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 | ||
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 | ||
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 | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Löst eine Aktualisierung des angegebenen Elements aus. | DataManager | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object |
Methode | Definiert von | ||
---|---|---|---|
Stellt einen Fehler in die Warteschlange, wenn dieser Datenmanager noch nicht initialisiert wurde. | DataManager |
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 |
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
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.
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.
|
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.
|
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.
|
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.
|
Boolean — true , 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.
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>
Parameter
... args — Liste mit Argumenten, die an das Remote-Ziel übergeben werden soll.
|
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.
|
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.
|
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.
|
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.
|
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.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.
|
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.
|
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.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.
|
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.
|
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.
|
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:
| |
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.
|
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.
|
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.
|
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.
|
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.
|
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.
|
uint — uint-Klasse, die anzeigt, welcher ausstehender Vorgang ausgeführt wurde. Gültige Vorgänge für ein Element:
|
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ückgabewertemx.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.
|
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.
|
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.
|
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.
|
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.RESULT oder 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.
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.
|
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.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.
|
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.
|
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.
|
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.
|
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
|
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.
|
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.
|
mx.rpc:AsyncToken — AsyncToken, das zur Benachrichtigung verwendet werden kann, wenn ein Vorgang erfolgreich abgeschlossen oder fehlgeschlagen ist.
|
Verwandte API-Elemente
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.
|
Boolean — true , 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ückgabewertemx.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.
|
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.
|
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.
|
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.
|
conflict | Ereignis |
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.
CONFLICT
-Konstante definiert den Wert der type
-Eigenschaft des Ereignisobjekts für ein conflict
-Ereignis.
Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false |
currentTarget | Das 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. |
target | Das 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 |
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.
FAULT
-Konstante definiert den Wert der type
-Eigenschaft des Ereignisobjekts für ein fault
-Ereignis.
Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:
Eigenschaft | Wert |
---|---|
bubbles | false |
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. |
currentTarget | Das 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. |
target | Das 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 |
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 Wert dieser Konstante ist "message"
.
Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false |
currentTarget | Das 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 Meldung, die mit diesem Ereignis verknüpft ist. |
target | Das 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 |
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
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:
Eigenschaft | Wert |
---|---|
bubbles | Wird vom Konstruktor bestimmt; standardmäßig „false“. |
cancelable | Wird vom Konstruktor bestimmt; standardmäßig „false“. |
kind | Art der Änderung; PropertyChangeEventKind.UPDATE oder PropertyChangeEventKind.DELETE. |
oldValue | Der ursprüngliche Eigenschaftswert. |
newValue | Der neue Eigenschaftswert, falls vorhanden. |
property | Die geänderte Eigenschaft. |
source | Das Objekt mit der geänderten Eigenschaft. |
currentTarget | Das 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. |
target | Das 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 |
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.
Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | true, preventDefault() aus der verknüpften responder.result-Methode des Token verhindert, dass der Dienst oder der Vorgang dieses Ereignis auslöst. |
currentTarget | Das 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. |
target | Das 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 | Vom RPC-Aufruf zurückgegebenes Ergebnis. |
token | Token, das den einzelnen Aufruf der Methode darstellt. Wird im asynchronen Abschluss-Token-Muster verwendet. |
Tue Jun 12 2018, 10:04 AM Z