MessageChannel  - AS3

Wskazuje, czy wewnętrzna kolejka komunikatów obiektu MessageChannel zawiera co najmniej jeden komunikat od wysyłającego procesu roboczego.

Wskazuje bieżący stan obiektu MessageChannel (otwarty, zamykanie lub zamknięty). Możliwe wartości dla tej właściwości są zdefiniowane w klasie MessageChannelState.

Powiązane elementy interfejsu API

Rejestruje obiekt detektora zdarzenia w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu. We wszystkich węzłach listy wyświetlania można rejestrować detektory zdarzeń reagujące na zdarzenia konkretnego typu, znajdujące się w określonej fazie i mające określony priorytet.

Po pomyślnym zarejestrowaniu detektora zdarzeń nie można zmienić jego priorytetu poprzez dodatkowe wywołania metody addEventListener(). Aby zmienić priorytet detektora, należy najpierw wywołać metodę removeListener(). Następnie można ponownie zarejestrować detektor z nowym poziomem priorytetu.

Należy pamiętać, że po zarejestrowaniu detektora późniejsze wywołania metody addEventListener() z różnymi wartościami type albo useCapture powodują rejestrowanie odrębnych detektorów. Na przykład detektor zarejestrowany z parametrem useCapture ustawionym na true wykrywa tylko zdarzenia w fazie przechwytywania. Po ponownym wywołaniu metody addEventListener() z tym samym obiektem detektora, ale z parametrem useCapture ustawionym na false będą istniały dwa odrębne detektory: jeden wykrywający zdarzenia w fazie przechwytywania, a drugi wykrywający zdarzenia w fazach miejsca docelowego i propagacji.

Nie można zarejestrować detektora zdarzeń, który wykrywałby tylko zdarzenia w fazie miejsca docelowego lub tylko zdarzenia w fazie propagacji. Te fazy są sprzężone podczas rejestracji, ponieważ propagacja zachodzi tylko w przodkach węzła miejsca docelowego.

Gdy detektor zdarzeń przestanie być potrzebny, należy go usunąć, wywołując metodę removeEventListener(); w przeciwnym razie mogą wystąpić problemy w zarządzaniu pamięcią. Detektory zdarzeń nie są automatycznie usuwane z pamięci, ponieważ proces czyszczenia pamięci nie usuwa detektora, pod warunkiem że istnieje obiekt wywołujący (o ile dla parametru useWeakReference ustawiona jest wartość true).

Skopiowanie instancji klasy EventDispatcher nie powoduje skopiowania detektorów zdarzeń dołączonych do tej instancji. (Jeśli utworzono nowy węzeł, dla którego potrzebny jest detektor zdarzeń, należy dołączyć detektor po utworzeniu węzła). Jednak przeniesienie instancji klasy EventDispatcher powoduje również przeniesienia dołączonych do niej detektorów zdarzeń

Jeśli detektor zdarzeń jest rejestrowany w węźle w momencie, gdy ten węzeł przetwarza zdarzenie, detektor nie zostanie wywołany w bieżącej fazie, ale może być wywołany w późniejszej fazie przepływu zdarzeń, np. w fazie propagacji.

Jeśli detektor zdarzeń zostanie usunięty z węzła w momencie, gdy ten węzeł przetwarza zdarzenie, zostanie wywołany przez bieżące operacje. Raz usunięty detektor zdarzeń nie jest nigdy ponownie wywoływany (chyba że zostanie ponownie zarejestrowany na potrzeby dalszego etapu wykonania programu).

Parametry

function(evt:Event):void

Nakazuje zamknięcie bieżącego obiektu MessageChannel po otrzymaniu wszystkich komunikatów.

Po wywołaniu tej metody nie można już wywoływać metody send() w celu dodawania komunikatów do kolejki. Wywołanie metody send() nie powiedzie się i zostanie zwrócona wartość false.

Ponadto metodę receive() można wywoływać tylko w celu odbierania komunikatów oczekujących w kolejce. Jeżeli kolejka jest pusta, wywołanie metody receive() zwróci wartość null.

Pobiera pojedynczy obiekt komunikatu z kolejki komunikatów wysłanych za pośrednictwem tego kanału komunikatów.

Za każdym razem, gdy kod wysyłającego procesu roboczego wywołuje metodę send() obiektu MessageChannel, do wewnętrznej kolejki w kanale komunikatów dodawany jest pojedynczy obiekt. Obiekty te są gromadzone w kolejce do momentu usunięcia ich pojedynczo przez wywołanie metody receive() w odbierającym procesie roboczym. Obiekty komunikatów są odbierane w kolejności wysyłania.

Aby sprawdzić, czy kolejka zawiera obiekt komunikatu do odebrania, należy użyć właściwości messageAvailable.

W standardowych przypadkach obiekt przekazany do metody send() jest serializowany w formacie AMF3. Gdy obiekt zostaje usunięty z kolejki przez wywołanie metody receive(), jest deserializowany do obiektu ActionScript (kopii oryginalnego obiektu) w odbierającym procesie roboczym, a proces roboczy otrzymuje odniesienie do tej kopii. Określone typy obiektów są współużytkowane przez procesy robocze, a nie kopiowane. W takiej sytuacji obiekt dostarczany do procesu roboczego jest odniesieniem do obiektu współużytkowanego, a nie nową kopią obiektu. Więcej informacji na ten temat można znaleźć w opisie metody send().

Zachowanie metody zmienia się, gdy kolejka komunikatów jest pusta, a przekazany parametr blockUntilReceived ma wartość true. W takim przypadku proces roboczy wstrzymuje wątek wykonywania przy wywołaniu metody receive() i nie wykonuje dodatkowego kodu. Po wywołaniu przez wysyłający proces roboczy metody send() wywołanie metody receive() kończy działanie odebraniem komunikatu. Następnie proces roboczy wznawia wykonywanie kodu w następnym wierszu po wywołaniu metody receive().

Parametry

Powiązane elementy interfejsu API

Usuwa detektor z obiektu EventDispatcher. Jeśli w obiekcie EventDispatcher nie ma zarejestrowanego zgodnego detektora zdarzeń, wywołanie tej metody nie odnosi żadnego skutku.

Parametry

Wysyła obiekt z wysyłającego procesu roboczego, dodając obiekt do kolejki komunikatów dla odbierającego procesu roboczego.

Do parametru arg można przekazać prawie dowolny obiekt. Poza wyjątkami wskazanymi poniżej obiekty przekazywane do parametru arg nie są przekazywane przez odniesienie. Zmiany wprowadzone w obiekcie w jednym z procesów roboczych po wywołaniu metody send() nie są przenoszone do innego procesu roboczego. Obiekt jest kopiowany przez serializację do formatu AMF3, a następnie deserializację w postaci nowego obiektu w odbierającym procesie roboczym po wywołaniu metody receive(). Z tego powodu obiektów, które nie umożliwiają serializacji w formacie AMF3 (w tym obiektów wyświetlanych), nie można przekazać do parametru arg. W celu prawidłowego przekazania obiektu klasy własnej definicja tej klasy musi zostać zrejestrowana przy użyciu funkcji flash.net.registerClassAlias() lub metadanych [RemoteClass]. W przypadku obu tych technik należy zastosować taki sam alias dla wersji klas obu procesów roboczych.

Istnieje pięć typów obiektów, które są wyjątkami od reguły dotyczącej braku współużytkowania obiektów między procesami roboczymi:

• Worker
• MessageChannel
• Współużytkowany obiekt ByteArray (obiekt ByteArray, którego właściwość shareable ma wartość true)
• Mutex
• Condition

W przypadku przekazania jednego z tych obiektów do parametru arg każdy proces roboczy zawiera odniesienie do tego samego obiektu podstawowego. Zmiany wprowadzone w wystąpieniu w jednym procesie roboczym są natychmiast dostępne w innych procesach. Ponadto jeżeli to samo wystąpienie tych obiektów zostanie wielokrotnie przekazane przy użyciu metody send(), środowisko wykonawcze nie utworzy nowej kopii obiektu w odbiorczym procesie roboczym. Zamiast tego zostanie ponownie użyte to samo odniesienie, co pozwala ograniczyć użycie pamięci systemowej.

Domyślnie ta metoda dodaje obiekt do kolejki i natychmiast powraca do wykonywania kodu od następnego wiersza. Aby zapobiec przekroczeniu określonego rozmiaru kolejki, można za pomocą parametru queueLimit określić maksymalną liczbę elementów dozwolonych w kolejce. Jeśli podczas wywołania funkcji send() liczba elementów w kolejce będzie większa niż określony limit, proces roboczy wstrzyma wątek wykonywania przy wywołaniu funkcji send(). Gdy odbierający proces roboczy wywoła metodę receive() wystarczającą liczbę razy, aby ograniczyć rozmiar kolejki do określonego limitu, wywołanie metody send() zostanie zakończone. Następnie proces roboczy wznowi wykonywanie kodu w następnym wierszu.

Parametry

Powiązane elementy interfejsu API

Zwraca ciąg znaków reprezentujący określony obiekt.

Uwaga: Metody klasy Object są tworzone dynamicznie w prototypie klasy Object. Do ponownego zdefiniowania tej metody w podklasie Object, nie należy używać słowa kluczowego override. Na przykład zamiast nadpisania klasy podstawowej dla podklasy Object implementowana jest funkcja function toString():String.

Wywoływana za każdym razem, gdy wysyłający proces roboczy wywołuje metodę send() danego obiektu MessageChannel, co wskazuje, że w kolejce wystąpienia klasy MessageChannel dostępny jest nowy obiekt komunikatu.

To zdarzenie ma następujące właściwości:

Wywoływana, gdy zmienia się wartość właściwości state kanału komunikatów.

To zdarzenie ma następujące właściwości: