| Paket | mx.data |
| Klasse | public class DataService |
| Vererbung | DataService  DataManager Object |
| Unterklassen | DataService |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Adobe Digital Enterprise Platform Data Services für Java EE 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Eine DataService-Instanz wird durch Festlegen des gewünschten Ziels erstellt. Ziele werden im Allgemeinen aus der services-config.xml-Datei konfiguriert, können aber auch mit Laufzeitkonfiguration, wie im Fall der modellgesteuerten Entwicklung, dynamisch konfiguriert werden.
Es gibt zwei Methoden zum Abrufen von Daten aus dem festgelegten Remote-Ziel. Die erste Methode gilt für sammlungsverwaltete Objekte. Die zweite gilt für einzeln verwaltete Objekte.
Verwenden Sie die DataService.fill()-Methode für sammlungsverwaltete Objekte. Diese Methode füllt eine ArrayCollection mit Objekten, die dieser Dienst verwaltet.
Verwenden Sie die DataService.getItem()- und DataService.createItem()-Methoden, um einzeln verwaltete Objekte aufzurufen.
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 DataService.releaseCollection()-Methode aufgerufen.
Wenn ein vorher abgerufenes Element, das DataService.getItem() oder DataService.createItem() verwendet, nicht mehr gebraucht wird oder wenn es keine Aktualisierungen empfangen oder erstellen soll, wird die DataService.releaseItem()-Methode aufgerufen. Die DataService.createItem()- und DataService.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 DataService.releaseItem()-Methode löst das Aufrufen der ItemReference.releaseItem()-Methode eine bestimmte Instanz eines einzeln verwalteten Objekts aus. Die DataService.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 DataService.getItem()- und DataService.createItem()-Methoden mit der Anzahl der Aufrufe der DataService.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 DataService.fill()-Methode oder die DataService.commit()-Methode aufrufen, während nicht übernommene Aktualisierungen vorhanden sind, wird die DataService-Instanz versuchen, eine Verbindung zum Remote-Ziel herzustellen. Um die Trennung der Verbindung einer DataService-Instanz zu erzwingen, rufen Sie die DataService.disconnect()-Methode auf. Die DataService.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 DataService.disconnect()-Methode die Verbindung beenden.
Die bindbare connected-Eigenschaft zeigt den aktuellen Status der verknüpften DataService-Verbindung an.
Wenn ein Remote-Ziel Sicherheitsbeschränkungen für einen Vorgang deklariert hat, müssen Benutzerdaten bereitgestellt werden, indem die DataService.setCredentials()-Methode aufgerufen wird. Ein Aufruf der DataService.setCredentials()-Methode wird am Remote-Ziel in einen Anmeldungsbefehl umgewandelt. Um Benutzerdaten zu ändern oder die aktuelle Sitzung ungültig zu machen, wird die DataService.logout()-Methode aufgerufen, die alle lokal verwalteten Daten freigibt. Der Aufruf der DataService.logout()-Methode entspricht dem Aufruf der DataService.release()-Methode.
Jede DataService-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 DataService-Instanzen. Standardmäßig verwendet eine DataService-Instanz die gleiche DataStore-Instanz gemeinsam mit anderen DataService-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 DataService-Instanz die Änderungen für alle DataService-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 DataService-Instanzen bestehen.
DataService- und DataStore-Instanzen lösen Ergebnis- und Fehlerereignisse für alle Vorgänge aus, die einen Remote-Aufruf erfordern.
Hinweis: Wenn Sie zwei DataService-Instanzen erstellen, die auf das gleiche Ziel verweisen, verwenden beide Instanzen dieselbe Sammlung von verwalteten Objekten gemeinsam und lösen denselben Ereignissatz aus. Wenn Sie beispielsweise einer DataService-Instanz einen Ereignis-Listener für ein Ziel hinzufügen und eine andere Instanz zum Starten eines Vorgangs verwenden, erhält die erste DataService-Instanz diese Ereignisse weiterhin. Jeder Vorgang, den Sie auf einer DataService-Instanz starten, gibt eine AsyncToken-Instanz zurück. Sie können dieser AsyncToken-Instanz 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 DataService-Instanz verwenden. Außerdem wird eine DataService-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 DataService-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 DataService-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 DataService.conflicts.resolved-Eigenschaft einbinden.
Die DataService-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 Wertfalseist, müssen Sie einen expliziten Aufruf dercommit()-Methode vornehmen. Verwenden Sie die bindbareDataService.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 dieDataService.merge()-Methode aufgerufen wird.
Die DataService.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 DataService.revertChanges()-Methode erstellt, um die Änderungen als Teil einer Fehlerprozedur rückgängig zu machen.
Die mx.data.mxml.DataService-Klasse ist eine MXML-spezifische Unterklasse der mx.data.DataService-Klasse, die die Bindung mit den Eigenschaften einer DataService-Instanz zulässt.
MXML-Syntax
MXML-Syntax anzeigen
MXML-Syntax ausblendenThe <mx:DataService> element accepts the following attributes:
<mx:DataService Properties autoCommit="true" autoMerge="true" autoSaveCache="false" autoSyncEnabled="true" conflictDetector="No default." dataStore="No default." destination="No default." pageSize="No default." id="No default." Events conflict="No default." fault="No default." message="No default." propertyChange="No default." result="No default." />
Verwandte API-Elemente
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 | |
| channelSet : ChannelSet
Gibt Zugriff auf den vom Dienst verwendeten ChannelSet. | DataService | ||
| 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 | |
| destination : String [schreibgeschützt]
Zeigt an, mit welchem Remote-Ziel dieser Dienst verknüpft ist. | DataService | ||
| 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 | ||
|---|---|---|---|
DataService(destination:String)
Erstellt eine DataService-Instanz mit dem angegebenen Ziel. | DataService | ||
|
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 | |
Meldet den Benutzer vom Ziel des DataService ab. | DataService | ||
|
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 Benutzerdaten für dieses DataService-Ziel fest. | DataService | ||
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
Legt die Benutzerdaten für Dritte in diesem DataService-Ziel fest. | DataService | ||
|
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 | |
| 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 Clientkonflikt übertragene Änderungen einen Konflikt mit Änderungen im Remote-Ziel haben. | DataService | |||
| Das DataServiceFaultEvent.FAULT-Ereignis wird ausgelöst, wenn ein Dienstaufruf aufgrund eines Fehlers fehlschlägt. | DataService | |||
| Das MessageEvent.MESSAGE-Ereignis wird ausgelöst, wenn das Remote-Ziel eine Benachrichtigung zu einem Datenvorgang ausgibt. | DataService | |||
| Das PropertyChangeEvent.PROPERTY_CHANGE-Ereignis wird bei Änderung einer Eigenschaft dieses Dienstes ausgelöst. | DataService | |||
| Das ResultEvent.RESULT-Ereignis wird ausgelöst, wenn ein Dienstaufruf erfolgreich zurückgegeben wird. | DataService | |||
channelSet | Eigenschaft |
channelSet:ChannelSet| 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 das vom Dienst verwendete ChannelSet bereit. Der ChannelSet kann manuell erstellt und zugewiesen werden oder wird dynamisch erstellt, wobei er die konfigurierten Kanäle als destination dieses Dienstes verwendet
Implementierung
public function get channelSet():ChannelSet public function set channelSet(value:ChannelSet):voiddestination | Eigenschaft |
destination:String [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, mit welchem Remote-Ziel dieser Dienst verknüpft ist.
Implementierung
public function get destination():StringDataService | () | Konstruktor |
public function DataService(destination:String)| 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 DataService-Instanz mit dem angegebenen Ziel. Der Zielname muss ein Verweis auf ein in einer LiveCycle Data Service-Konfigurationsdatei oder mit Laufzeitkonfiguration konfiguriertes Ziel sein.
Parameterdestination:String — die den Namen des gewünschten Ziels enthält.
|
logout | () | Methode |
public function logout():void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Adobe Digital Enterprise Platform Data Services für Java EE 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Meldet den Benutzer vom Ziel des DataService ab. Die Abmeldung von einem Zielpfad wird auf alle verbundenen Elemente angewandt, die denselben ChannelSet verwenden, der in der Serverkonfiguration angegeben ist. Beispiel: Wenn Sie über den my-rtmp-Kanal verbunden sind und sich mit einer Ihrer DataService-Instanzen abmelden, wird alles, was über das gleiche ChannelSet verbunden ist, abgemeldet.
Hinweis: Adobe empfiehlt, statt dieser Methode die mx.messaging.ChannelSet.logout()-Methode zu verwenden.
Verwandte API-Elemente
setCredentials | () | Methode |
public function setCredentials(username:String, password:String):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Adobe Digital Enterprise Platform Data Services für Java EE 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Legt die Benutzerdaten für dieses DataService-Ziel fest. Die Benutzerdaten werden auf alle Dienste angewendet, die über den gleichen ChannelSet verbunden sind.
Parameter
username:String — Der Benutzername für das Ziel.
| |
password:String — Das Kennwort für das Ziel.
|
setRemoteCredentials | () | Methode |
public function setRemoteCredentials(username:String, password:String):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Adobe Digital Enterprise Platform Data Services für Java EE 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Legt die Benutzerdaten für Dritte in diesem DataService-Ziel fest.
Parameter
username:String — Der Benutzername für das Ziel.
| |
password:String — Das Kennwort für das Ziel.
|
conflict | Ereignis |
mx.data.events.DataConflictEventEigenschaft 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 Clientkonflikt übertragene Änderungen einen Konflikt mit Änderungen im Remote-Ziel haben. Jede DataService-Instanz 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.
DieCONFLICT-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.DataServiceFaultEventEigenschaft 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 DataServiceFaultEvent.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.MessageEventEigenschaft 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 dieser DataService-Instanz 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.PropertyChangeEventEigenschaft 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:
commitRequiredmergeRequiredconnected
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.ResultEventEigenschaft 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. Dieses Ereignis wird beispielsweise ausgelöst, wenn ein Aufruf der fill()-Methode 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