MessageChannel  - AS3

Geeft aan of de interne wachtrij van MessageChannel een of meer berichten van de verzendende worker bevat.

Hiermee wordt de huidige status van het MessageChannel-object aangeduid (open, wordt gesloten of gesloten). Mogelijke waarden voor deze eigenschap worden gedefinieerd in de klasse MessageChannelState.

Verwante API-elementen

Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt. U kunt gebeurtenislisteners registreren op alle knooppunten in het weergaveoverzicht van een specifiek type gebeurtenis, fase of prioriteit.

Nadat het registreren van een gebeurtenislistener is voltooid, kunt u de prioriteit ervan niet wijzigen door extra aanroepen van addEventListener(). Wanneer u de prioriteit van een listener wilt wijzigen, moet u eerst removeListener() aanroepen. U kunt de listener opnieuw registreren met het nieuwe prioriteitsniveau.

Nadat de listener is geregistreerd, resulteren volgende aanroepen van addEventListener() met een andere waarde voor type of useCapture in het maken van een afzonderlijke listenerregistratie. Wanneer u bijvoorbeeld eerst een listener registreert bij useCapture ingesteld op true, luistert deze alleen tijdens de vastlegfase. Wanneer u addEventListener() opnieuw aanroept met hetzelfde listenerobject maar met useCapture ingesteld op false, hebt u twee afzonderlijke listeners: één die tijdens de vastlegfase luistert en één die tijdens de doel- en terugkoppelfasen luistert.

U kunt geen gebeurtenislistener registeren voor alleen de doel- of terugkoppelfase. Deze fasen worden bij de registratie gekoppeld, omdat terugkoppeling alleen van toepassing is op voorouders van het doelknooppunt.

Wanneer u een gebeurtenislistener niet langer nodig hebt, kunt u deze verwijderen door removeEventListener() aan te roepen; anders kan dit resulteren in geheugenproblemen. Gebeurtenisluisteraars worden niet automatisch uit het geheugen verwijderd, omdat de verzamelaar met ongewenste details de luisteraar niet verwijderd zolang het verzendende object bestaat (behalve als de parameter useWeakReference op true is ingesteld).

Het kopiëren van een instantie EventDispatcher kopieert de daaraan gekoppelde gebeurtenislisteners. (Wanneer uw nieuwe knooppunt een gebeurtenislistener nodig heeft, moet u de listener eraan koppelen na het maken van het knooppunt.) Wanneer u echter een instantie EventDispatcher verplaatst, worden de daaraan gekoppelde listeners mee verplaatst.

Wanneer de gebeurtenislistener wordt geregistreerd op een knooppunt terwijl een gebeurtenis op dit knooppunt wordt verwerkt, wordt de gebeurtenislistener niet geactiveerd tijdens de huidige fase maar kan wel worden geactiveerd in een latere fase in de gebeurtenisstroom, zoals de terugkoppelfase.

Wanneer een gebeurtenislistener wordt verwijderd uit een knooppunt terwijl een gebeurtenis wordt verwerkt op het knooppunt, wordt deze nog steeds geactiveerd door de huidige handelingen. Nadat deze is verwijderd, wordt de gebeurtenislistener niet meer aangeroepen (tenzij deze opnieuw wordt geregistreerd voor toekomstige verwerking).

Parameters

function(evt:Event):void

Instrueert het huidige MessageChannel om te sluiten zodra alle berichten zijn ontvangen.

Zodra u deze methode aanroept, kunt u de methode send() niet meer aanroepen om berichten toe te voegen aan de wachtrij. Als u send() toch aanroept, mislukt de aanroep en wordt de waarde false geretourneerd.

U kunt ook alleen de methode receive() aanroepen om berichten te ontvangen die al in de wachtrij zijn geplaatst. Als de wachtrij leeg is, retourneert de receive()-aanroep de waarde null.

Hiermee wordt een enkel berichtobject opgehaald uit de wachtrij met berichten die via dit berichtenkanaal worden verzonden.

Telkens wanneer de methode send() van het MessageChannel-object wordt aangeroepen door de code van de verzendende worker, wordt een enkel object toegevoegd aan de interne wachtrij van het berichtkanaal. Deze objecten worden in de wachtrij geplaatst, totdat ze achtereenvolgens worden opgehaald door de verzendende worker die de methode receive() aanroept. De berichtobjecten worden ontvangen in de volgorde waarin ze zijn verzonden.

Als u wilt controleren of de wachtrij een berichtobject bevat dat kan worden ontvangen, gebruikt u de eigenschap messageAvailable.

Normaal gesproken wordt het object dat aan de methode send() wordt via serienummering doorgegeven in de AMF3-indeling. Wanneer het object uit de wachtrij wordt gehaald door de receive()-aanroep, wordt het object via serienummering omgezet in een ActionScript-object (een kopie van het oorspronkelijke object) in de ontvangende worker en ontvangt de worker een referentie naar die kopie. Sommige objecttypen worden gedeeld tussen workers, en niet gekopieerd. In dat geval is het object dat de ontvangende worker krijgt, een referentie naar het gedeelde object en geen kopie ervan. Zie de beschrijving van de methode send() voor meer informatie hierover.

Het gedrag van de methode verandert als de wachtrij leeg is en u de waarde true doorgeeft voor de blockUntilReceived-parameter. In dat geval pauzeert de worker de bijbehorende uitvoeringsthread bij de receive()-aanroep en wordt er geen code meer uitgevoerd. Zodra de verzendende worker send() aanroept, wordt de receive()-aanroep voltooid doordat het bericht wordt ontvangen. Hierna vervolgt de worker de uitvoering met de code die volgt op de receive-aanroep.

Parameters

Verwante API-elementen

Verwijdert een listener uit het object EventDispatcher. Wanneer geen overeenkomende listener is geregistreerd bij het object EventDispatcher, heeft een aanroep van deze methode geen invloed.

Parameters

Verstuurt een object van de verzendende worker en voegt dit object toe aan de wachtrij met berichten voor de ontvangende worker.

Praktisch elk object kan worden doorgegeven aan de arg-parameter. Met uitzondering van de onderstaande objecten, worden objecten die zijn doorgegeven aan de arg-parameter, niet als referentie doorgegeven. Wijzigingen die worden doorgevoerd in het object van een worker nadat send() is aangeroepen, worden niet doorgevoerd in de andere worker. Wanneer receive() wordt aangeroepen, wordt het object via serienummering gekopieerd naar de AMF3-indeling en vervolgens weer via serienummering omgezet in een nieuw object in de ontvangende worker. Dit is ook waarom objecten die niet via serienummering kunnen worden omgezet in een AMF-indeling (zoals bijvoorbeeld weergaveobjecten), niet kunnen worden doorgegeven aan de arg-parameter. Voor een juiste doorgave van een aangepaste klasse moet de klassendefinitie worden geregistreerd met de functie flash.net.registerClassAlias() of met [RemoteClass]-metagegevens. Voor beide methoden geldt dat hetzelfde alias moet worden gebruikt voor de klassenversies van beide workers.

Er zijn vijf objecttypen die een uitzondering vormen op de regel dat objecten niet daadwerkelijk worden gedeeld door workers:

• Worker-item 
• MessageChannel
• deelbare ByteArray (een ByteArray-object waarvan de eigenschap shareable is ingesteld op true
• Mutex
• Condition

Wanneer u een instantie van een van deze objecten doorgeeft met de arg-parameter, beschikt elke worker over een referentie naar hetzelfde onderliggende object. Wijzigingen die in één worker worden toegepast op een instantie zijn dan direct beschikbaar in alle andere workers. Bovendien geldt dat als u eenzelfde instantie van deze objecten meerdere keren doorgeeft aan een worker met behulp van send(), er niet telkens een nieuw exemplaar van het object in de ontvangende worker wordt gemaakt door de runtime. In plaats hiervan wordt dezelfde referentie opnieuw gebruikt, waardoor er minder systeemgeheugen in beslag wordt genomen.

Bij deze methode wordt het object standaard toegevoegd aan de wachtrij, waarna de volgende coderegel direct wordt uitgevoerd. Als u wilt voorkomen dat de wachtrij te groot wordt, kunt u met de parameter queueLimit aangeven hoeveel items maximaal in de wachtrij zijn toegestaan. Wanneer de wachtrij meer items bevat dan de door u opgegeven limiet en de methode send() wordt aangeroepen, pauzeert de worker de uitvoeringsthread bij de send()-aanroep. Wanneer de ontvangende worker voldoende receive()-aanroepen heeft uitgevoerd en de limiet voor de wachtrij niet meer wordt overschreden, wordt de send()-aanroep voltooid. Hierna vervolgt de worker de uitvoering vanaf de volgende coderegel.

Parameters

Verwante API-elementen

Retourneert een tekenreeksrepresentatie van het opgegeven object.

Opmerking: methoden van de klasse Object worden dynamisch gemaakt in het prototype van Object. Wanneer u deze methode opnieuw wilt definiëren in een subklasse van Object, moet u het trefwoord override niet gebruiken. Bijvoorbeeld, een subklasse van Object implementeert de functie toString():String in plaats van dat deze de basisklasse overschrijft.

Wordt telkens verzonden wanneer de verzendende worker de methode send() van dit MessageChannel-object aanroept om aan te duiden dat er een nieuw berichtobject beschikbaar is in de wachtrij van de MessageChannel-instantie.

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden wanneer de waarde van de state-eigenschap van het berichtkanaal wordt gewijzigd.

Deze gebeurtenis heeft de volgende eigenschappen: