MessageChannel  - AS3

Gibt an, ob der MessageChannel eine oder mehrere Nachrichten vom sendenden Worker in seiner internen Warteschlange hat.

Gibt den aktuellen Zustand des MessageChannel-Objekts an (geöffnet, schließend oder geschlossen). Die möglichen Werte dieser Eigenschaft sind als Konstanten in der MessageChannelState-Klasse definiert.

Verwandte API-Elemente

Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. Sie können Ereignis-Listener bei allen Knoten in der Anzeigeliste für eine bestimmte Art von Ereignis, Phase oder Priorität registrieren.

Nachdem Sie einen Ereignis-Listener erfolgreich registriert haben, können Sie seine Priorität nicht durch weitere Aufrufe von addEventListener() ändern. Um die Priorität eines Listeners zu ändern, müssen Sie zunächst removeListener() aufrufen. Anschließend können Sie den Listener mit der neuen Prioritätsstufe erneut aufrufen.

Nach der Registrierung des Listeners haben nachfolgende Aufrufe von addEventListener() mit einem anderen type- oder useCapture-Wert eine separate Listener-Registrierung zur Folge. Wenn Sie beispielsweise zuerst einen Listener registrieren, für den useCapture auf true gesetzt ist, wird dieser nur während der Aufnahmephase aktiv sein. Wenn Sie addEventListener() für dasselbe Listener-Objekt erneut aufrufen, diesmal aber useCapture auf false gesetzt ist, werden zwei separate Listener angelegt: einer, der während der Aufnahmephase aktiv ist und ein zweiter, der während der Ziel- und Bubbling-Phase aktiv ist.

Sie können einen Ereignis-Listener nicht nur für die Ziel- oder Bubbling-Phase registrieren. Die beiden Phasen hängen während der Registrierung immer zusammen, da Bubbling nur für übergeordnete Elemente des Zielknotens gilt.

Wenn Sie einen Ereignis-Listener nicht mehr brauchen, entfernen sie ihn, indem Sie removeEventListener() aufrufen. Andernfalls könnte es zu Speicherproblemen kommen. Ereignis-Listener werden nicht automatisch aus dem Speicher entfernt, da der Garbage Collector den Listener nicht entfernt, solange das auslösende Objekt vorhanden ist (sofern der useWeakReference-Parameter auf true gesetzt ist).

Beim Kopieren einer EventDispatcher-Instanz werden zugewiesene Ereignis-Listener nicht kopiert. (Wenn ein neu angelegter Knoten einen Ereignis-Listener benötigt, müssen Sie den Listener nach dem Erstellen des Knotens zuweisen.) Wenn Sie jedoch eine EventDispatcher-Instanz verschieben, werden zugewiesene Ereignis-Listener ebenfalls verschoben.

Wenn der Ereignis-Listener bei einem Knoten registriert wird, während mit diesem Knoten ein Ereignis durchgeführt wird, so wird der Ereignis-Listener während der aktuellen Phase nicht ausgelöst, kann aber während einer späteren Phase im Ereignisablauf ausgelöst werden, etwa während der Bubbling-Phase.

Wird ein Ereignis-Listener von einem Knoten entfernt, während mit dem Knoten ein Ereignis durchgeführt wird, so wird er von den aktuellen Aktionen immer noch ausgelöst. Nachdem er entfernt worden ist, wird der Ereignis-Listener nicht wieder aufgerufen (es sei denn er wird für spätere Verarbeitungsvorgänge erneut aufgerufen).

Parameter

function(evt:Event):void

Weist den aktuellen MessageChannel an, zu schließen, sobald alle Meldungen empfangen wurden.

Wenn Sie diese Methode einmal aufgerufen haben, können Sie nicht länger die send()-Methode aufrufen, um der Warteschlange Nachrichten hinzuzufügen. Der send()-Aufruf wird fehlschlagen und false zurückgeben.

Des Weiteren können Sie die receive()-Methode nur aufrufen, um Nachrichten abzurufen, die sich bereits in der Warteschlange befinden. Wenn die Warteschlange leer ist, gibt der receive()-Aufruf null zurück.

Ruft ein einzelnes Nachrichtenobjekt aus der Warteschlange mit Nachrichten ab, die über diesen Nachrichtenkanal gesendet wurden.

Jedes Mal, wenn der Code des sendenden Workers die send()-Methode des MessageChannel-Objekts aufruft, wird der internen Warteschlange des Nachrichtenkanals ein einzelnes Objekt hinzugefügt. Diese Objekte sammeln sich in der Warteschlange, bis sie einzeln entfernt werden, wenn der empfangende Worker die receive()-Methode aufruft. Die Nachrichtenobjekte werden in derselben Reihenfolge empfangen, in der sie gesendet werden.

Um zu überprüfen, ob die Warteschlange ein Nachrichtenobjekt enthält, das empfangen werden kann, verwenden Sie die messageAvailable-Eigenschaft.

Normalerweise wird das an send() übergebene Objekt im AMF3-Format serialisiert. Wenn es durch den receive()-Aufruf aus der Warteschlange entfernt wird, wird es im empfangenden Worker in ein ActionScript-Objekt serialisiert (eine Kopie des Originalobjekts) und der Worker erhält einen Verweis auf diese Kopie. Bestimmte Objekttypen werden nicht kopiert, sondern von Workern gemeinsam genutzt. In diesem Fall ist das Objekt, das der empfangende Worker erhält, keine neue Kopie des Objekts, sondern ein Verweis auf das gemeinsam genutzte Objekt. Weitere Informationen zu diesem Fall finden Sie in der Beschreibung der send()-Methode.

Das Verhalten der Methode ändert sich, wenn die Nachrichtenwarteschlange leer ist und Sie true für den blockUntilReceived-Parameter übergeben. In diesem Fall unterbricht der Worker seinen Ausführungsthread beim Aufruf von receive() und führt keinen weiteren Code aus. Wenn der sendende Worker send() aufruft, wird der receive()-Aufruf durch den Empfang der Nachricht abgeschlossen. Der Worker setzt die Ausführung des Codes dann in der nächsten Codezeile nach dem receive-Aufruf fort.

Parameter

Verwandte API-Elemente

Entfernt einen Listener aus dem EventDispatcher-Objekt. Wenn kein entsprechender Listener mit dem EventDispatcher-Objekt registriert ist, hat ein Aufruf dieser Methode keine Auswirkungen.

Parameter

Sendet ein Objekt vom sendenden Worker und fügt es der Nachrichtenwarteschlange für den empfangenden Worker hinzu.

Das Objekt, das an den arg-Parameter übergeben wird, kann ein nahezu beliebiges Objekt sein. Abgesehen von den unten aufgeführten Ausnahmen, werden Objekte, die an den arg-Parameter übergeben werden, nicht als Verweis übergeben. Alle Änderungen, die nach dem send()-Aufruf an einem Objekt in einem Worker vorgenommen werden, werden nicht an den anderen Worker übertragen. Das Objekt wird kopiert, indem es in das AMF3-Format serialisiert und im empfangenden Worker in ein neues Objekt deserialisiert wird, wenn receive() aufgerufen wird. Aus diesem Grund können Objekte, die nicht im AMF3-Format serialisiert werden können, zum Beispiel Anzeigeobjekte, nicht an den arg-Parameter übergeben werden. Damit eine benutzerdefinierte Klasse korrekt übergeben werden kann, muss die Klassendefinition mit der flash.net.registerClassAlias()-Funktion oder unter Verwendung von [RemoteClass]-Metadaten registriert werden. Bei beiden Techniken muss derselbe Alias für die Klassenversionen beider Worker verwendet werden.

Es gibt fünf Objekttypen, die eine Ausnahme der Regel darstellen, dass Objekte nicht von Workern gemeinsam genutzt werden:

• Worker
• MessageChannel
• gemeinsam nutzbares ByteArray (ein ByteArray-Objekt, dessen shareable-Eigenschaft auf true eingestellt ist
• Mutex
• Condition

Wenn Sie eine Instanz dieser Objekte an den arg-Parameter übergeben, hat jeder Worker einen Verweis auf dasselbe zugrunde liegende Objekt. Änderungen, die in einem Worker an einer Instanz vorgenommen werden, sind sofort auch in den anderen Workern verfügbar. Wenn Sie dieselbe Instanz dieser Objekte mehrmals mit send() übergeben, erstellt die Laufzeitumgebung keine neue Kopie des Objekts im empfangenden Worker. Stattdessen wird derselbe Verweis erneut verwendet, sodass der Arbeitsspeicher weniger belastet wird.

Standardmäßig fügt diese Methode das Objekt zur Warteschlange hinzu, gibt sofort einen Wert zurück und setzt die Ausführung mit der nächsten Codezeile fort. Wenn Sie die Größe der Warteschlange auf einen bestimmten Wert begrenzen möchten, können Sie mit dem queueLimit-Parameter die maximale Anzahl von Objekten in der Warteschlange festlegen. Wenn zum Zeitpunkt des send()-Aufrufs mehr Objekte in der Warteschlange sind als das von Ihnen festgelegte Limit, hält der Worker den Ausführungsthread beim send()-Aufruf an. Wenn der empfangende Worker oft genug receive() aufgerufen hat, sodass die Warteschlange weniger Objekte als das festgelegte Limit enthält, wird der send()-Aufruf abgeschlossen. Der Worker setzt die Ausführung dann in der nächsten Codezeile fort.

Parameter

Verwandte API-Elemente

Gibt das angegebene Objekt als String zurück.

Hinweis: Methoden der Object-Klasse werden für den Prototyp des Objekts dynamisch erstellt. Um diese Methode in eine Unterklasse von Object umzudefinieren, sollten Sie nicht das Schlüsselwort override verwenden. So implementiert eine Unterklasse von Object beispielsweise function toString():String anstatt die Basisklasse per „override“ außer Kraft zu setzen.

Wird jedes Mal abgesetzt, wenn der sendende Worker die send()-Methode dieses MessageChannel-Objekts aufruft und damit anzeigt, dass in der Warteschlange der MessageChannel-Instanz ein neues Nachrichtenobjekt verfügbar ist.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird abgesetzt, wenn sich der Wert der state-Eigenschaft des Nachrichtenkanals ändert.

Dieses Ereignis verfügt über die folgenden Eigenschaften: