DataManager  - AS3 ADEP Data Services

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

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.

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.

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.

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.

Verwandte API-Elemente

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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

Der Standardwert ist false.

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.

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.

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.

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.

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.

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).

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

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

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.

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.

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.

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.

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.

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.

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.

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.

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.

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

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

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

Parameter

Ü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

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

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.

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

Verwandte API-Elemente

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

Parameter

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

Parameter

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

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

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>
      

Parameter

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

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

Parameter

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

Parameter

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

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

Parameter

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

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

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

Parameter

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

Erzwingt die Initialisierung des DataStore.

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

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

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

Parameter

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

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.

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.

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

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

Parameter

Verwandte API-Elemente

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

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

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

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

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

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

Parameter

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

Verwandte API-Elemente

         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
      

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

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

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

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

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

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

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

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

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

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:

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

• commitRequired
• mergeRequired
• connected

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

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: