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

ManualSyncConfiguration  - AS3 ADEP Data Services

Paketmx.data
Klassepublic class ManualSyncConfiguration
VererbungManualSyncConfiguration Inheritance Object

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

Diese Klasse wird verwendet, wenn Sie mehr Steuerungsmöglichkeiten in Bezug auf den Datenaustausch zwischen Clients benötigen, als durch die autoSyncEnabled-Funktion bereitgestellt werden. Wenn autoSyncEnabled als true festgelegt wird, leitet der Server automatisch Meldungen weiter, indem genau verfolgt wird, welche Objekte von jedem Client verwaltet werden. Dies ist kein vollständig skalierbares System, da jeder Server einen Speicher mit (wenigstens) den IDs aller Objekte enthält, die von den verwalteten Clients verwaltet werden. Außerdem werden alle Datenmeldungen zu allen Servern weitergeleitet.

Sie können die Effizienz dieses Prozesses erhöhen oder die Datensynchronisierung beschränken, indem Sie Produzenten (andere Clients oder Servercode) und Verbraucher (Clients) manuell zuordnen. LCDS stellt einen flexiblen Mechanismus zum Zuordnen von Produzenten und Verbrauchern bereit: Sie können einfach die von Produzenten veröffentlichten Themen den von Verbrauchern abonnierten Themen zuordnen. Jeder Produzent kann eine Liste mit Unterthemen festlegen und jeder Verbraucher kann eine Liste mit Unterthemen abonnieren. (Hinweis: Die Übermittlung erfolgt immer relativ zum übergeordneten Ziel, das als übergeordnetes Thema verstanden werden kann.)

Für die erweiterte Verwendung senden Produzenten einen beliebigen Satz mit Name/Wert-Paaren. Das Abonnement erfolgt durch die Verbraucher über einen Selektorausdruck (mithilfe der Selektorsprache von JMS – ähnlich einer einfachen SQL-WHERE-Klausel). In jeder Meldung sind die Name/Wert-Paare des Produzenten als Meldungs-Header festgelegt. Diese Header werden mit dem Selektorausdruck des Verbrauchers abgeglichen und nur wenn eine Übereinstimmung vorliegt, wird die Meldung weitergeleitet. Sie können diese Mechanismen auch in Kombination miteinander verwenden.

Beachten Sie, dass die manuelle Sync-Konfiguration nur Änderungen an den Client weiterleitet. Der Client muss weiterhin fill, getItem() oder andere Methoden ausführen, sodass ein Speicherort vorhanden ist, um diese Änderungen zu empfangen. Wenn ein Client eine gesendete Meldung für ein Element, das nicht auf dem Client verwaltet wird, empfängt, wird diese ignoriert. Sie können die Debug-Protokollierungsinformationen auf dem Client sehen, um zu erkennen, wann dies passiert. Außerdem kann die Debug-Protokollierung auf dem Server zur Diagnose von Abonnementproblemen auf dem Server verwendet werden.



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  consumerSubscriptions : ArrayCollection
Diese Eigenschaft legt den aktuellen Satz der Abonnements für diese manualSync-Konfiguration fest.
ManualSyncConfiguration
  producerDefaultHeaders : Object
Diese Eigenschaft legt einen Satz mit Name/Wert-Paaren fest, die Änderungen hinzugefügt werden, die nachfolgend von diesem Datendienst durchgeführt wurden.
ManualSyncConfiguration
  producerSubtopics : ArrayCollection
Diese Eigenschaft legt die Liste der Themen fest, an die nachfolgende Änderungen gesendet werden.
ManualSyncConfiguration
Öffentliche Methoden
 MethodeDefiniert von
  
Konstruktor.
ManualSyncConfiguration
  
consumerAddSubscription(subtopic:String = null, selector:String = null, maxFrequency:uint = 0):void
Dies ist eine Vereinfachungsmethode, um dem Client ein Abonnement hinzuzufügen.
ManualSyncConfiguration
  
consumerRemoveSubscription(subtopic:String = null, selector:String = null):void
Dies ist eine Vereinfachungsmethode, um ein Abonnement vom Client zu entfernen.
ManualSyncConfiguration
  
consumerSubscribe(clientId:String = null):void
Diese Methode wird zum Abonnieren von Änderungen vom Server durch den Client verwendet.
ManualSyncConfiguration
  
Diese Methode wird zum Abmelden des Clients von allen Abonnements verwendet.
ManualSyncConfiguration
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Eigenschaftendetails

consumerSubscriptions

Eigenschaft
consumerSubscriptions:ArrayCollection

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

Diese Eigenschaft legt den aktuellen Satz der Abonnements für diese manualSync-Konfiguration fest. Dies ist eine ArrayCollection mit SubscriptionInfo-Instanzen. Sie können dieser Eigenschaft direkt Abonnements hinzufügen, indem Sie die mx.messaging.SubscriptionInfo-Klasse oder die Vereinfachungsmethoden consumerAddSubscription oder consumerRemoveSubscription verwenden. Die SubscriptionInfo-Instanz hat ein Unterthema und eine Selektoreigenschaft. Ist das Unterthema null, gilt das Abonnement für das Standardthema des Ziels. Nur Meldungen ohne Unterthema stimmen mit dem Standardziel überein. Ist der Selektorausdruck null, wird jede Meldung, die mit dem Thema des Abonnements übereinstimmt, für den Client bereitgestellt.

Zusätzlich zum Festlegen einer Liste von Abonnements müssen Sie auch die subscribe-Methode in der Reihenfolge aufrufen, um das Abonnement zu initiieren. Sobald der Verbraucher abonniert hat, gelten alle an der subscriptions-Eigenschaft durchgeführten Änderungen automatisch für die Serverabonnements des Clients. Wenn Sie „consumerUnsubscribe“ aufrufen, wird die subscriptions-Eigenschaft nicht geändert, sondern der Client wird von allen aktuellen Abonnements abgemeldet.



Implementierung
    public function get consumerSubscriptions():ArrayCollection
    public function set consumerSubscriptions(value:ArrayCollection):void

producerDefaultHeaders

Eigenschaft 
public var producerDefaultHeaders:Object

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

Diese Eigenschaft legt einen Satz mit Name/Wert-Paaren fest, die Änderungen hinzugefügt werden, die nachfolgend von diesem Datendienst durchgeführt wurden. Sie verwenden diese Eigenschaften normalerweise zum Vergleich mit einem Selektorausdruck, der von einer der ConsumerSubscriptions bereitgestellt wird. Zum Beispiel können Sie diese Eigenschaft folgenderweise festlegen: dataService.manualSync.producerDefaultHeaders = {a:'3'}. Ein Verbraucher könnte einen übereinstimmenden Selektorausdruck hinzufügen: dataService.manualSync.consumerAddSubscription(null, "a IN ('3', '4', '5')");

producerSubtopics

Eigenschaft 
public var producerSubtopics:ArrayCollection

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

Diese Eigenschaft legt die Liste der Themen fest, an die nachfolgende Änderungen gesendet werden. Wenn ein anderer Client-Datendienst eines dieser Themen abonniert, empfängt der betreffende Client diese Änderungen. Die Eigenschaft ist eine ArrayCollection mit Stringnamen für Themen. Die Namen sollten mit den Namen der consumerSubscriptions-Eigenschaft eines anderen Clients übereinstimmen, damit der andere Client diese Meldung empfangen kann. Eine Übereinstimmung tritt auf, wenn entweder die Unterthemennamen identisch sind oder der Verbraucher das Abonnement mithilfe eines Unterthemenplatzhalterausdrucks eingerichtet hat, der mit dem Unterthema des Produzenten übereinstimmt.

Konstruktordetails

ManualSyncConfiguration

()Konstruktor
public function ManualSyncConfiguration()

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

Konstruktor.

Methodendetails

consumerAddSubscription

()Methode
public function consumerAddSubscription(subtopic:String = null, selector:String = null, maxFrequency:uint = 0):void

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

Dies ist eine Vereinfachungsmethode, um dem Client ein Abonnement hinzuzufügen.

Parameter

subtopic:String (default = null) — Das Unterthemastring.
 
selector:String (default = null) — Der Selektorstring.
 
maxFrequency:uint (default = 0) — Die maximale Anzahl der Meldungen pro Sekunde, die der DataService für das Abonnement empfangen möchte. Beachten Sie, dass dieser Wert die DataService-weite maxFrequency überschreibt.

consumerRemoveSubscription

()Methode 
public function consumerRemoveSubscription(subtopic:String = null, selector:String = null):void

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

Dies ist eine Vereinfachungsmethode, um ein Abonnement vom Client zu entfernen.

Parameter

subtopic:String (default = null) — Das Unterthemastring.
 
selector:String (default = null) — Der Selektorstring.

consumerSubscribe

()Methode 
public function consumerSubscribe(clientId:String = null):void

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 wird zum Abonnieren von Änderungen vom Server durch den Client verwendet. Um diese Methode zu verwenden, sollten Sie vorher der subscriptions-Eigenschaft mindestens ein Abonnement hinzugefügt haben (oder consumerAddSubscription verwenden).

Parameter

clientId:String (default = null) — Die Client-ID.

consumerUnsubscribe

()Methode 
public function consumerUnsubscribe():void

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 wird zum Abmelden des Clients von allen Abonnements verwendet. Das Aufrufen dieser Methode hat keine Auswirkungen auf die subscriptions-Eigenschaft, sodass das Abonnieren/Abbestellen für den Client als Ganzes vereinfacht wird.





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

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