| Paket | flash.system |
| Sınıf | public final class MessageChannel |
| Miras Alma | MessageChannel  EventDispatcher Object |
| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | Flash Player 11.4, AIR 3.4 |
Her MessageChannel nesnesi, gönderen worker (işçi) öğesinden alıcı worker (işçi) öğesine gönderilen mesaj nesnelerinin bir kuyruğunu içerir. send() öğesine yapılan her çağrıda, kuyruğa bir nesne eklenir. receive() öğesine yapılan her çağrıda, kuyruktan en eski mesaj nesnesi alınır.
MessageChannel() yapıcısını çağırarak doğrudan MessageChannel örnekleri oluşturmazsınız. Bir MessageChannel örneği oluşturmak için, alıcı Worker (İşçi) öğesini argüman olarak ileterek kanalda mesajlar gönderecek Worker nesnesinin createMessageChannel() yöntemini çağırın.
MessageChannel nesnesi ile mesaj göndermeye ilişkin tipik iş akışı şu şekildedir:
-
Mesaj kanalı oluşturmak için gönderen worker (işçi) öğesinin
createMessageChannel()yöntemini çağırın// In the sending worker swf var sendChannel:MessageChannel; sendChannel = Worker.current.createMessageChannel(receivingWorker); -
Worker.setSharedProperty()yöntemini çağırarak veya varolan mesaj kanalı aracılığıyla göndererek mesaj kanalını diğer worker (işçi) öğesine iletinreceivingWorker.setSharedProperty("incomingChannel", sendChannel); -
Alıcı worker (işçi) öğesindeki kod,
channelMessageolayı için MessageChannel nesnesi ile bir dinleyiciyi kaydeder// In the receiving worker swf var incomingChannel:MessageChannel; incomingChannel = Worker.current.getSharedProperty("incomingChannel"); incomingChannel.addEventListener(Event.CHANNEL_MESSAGE, handleIncomingMessage); -
Gönderen worker (işçi) öğesindeki kod,
send()yöntemini çağırarak bir mesaj gönderir// In the sending worker swf sendChannel.send("This is a message"); -
Çalışma zamanı, alıcı worker (işçi) kodunda olay işleyiciyi çağırarak bir mesajın gönderildiğini belirtir
// In the receiving worker swf // This method is called when the message channel gets a message private function handleIncomingMessage(event:Event):void { // Do something with the message, as shown in the next code listing } -
Alıcı worker (işçi) öğesindeki kod, mesajı almak için
receive()yöntemini çağırır.receive()yöntemi tarafından döndürülen nesne,send()yöntemine iletilen nesne ile aynı veri türüne sahiptir.var message:String = incomingChannel.receive() as String;
Yukarıda açıklanan senkronize olmayan iş akışına ek olarak, alıcı worker (işçi) öğesinde kodu duraklatmak için receive() yöntemi ile alternatif bir iş akışı kullanabilir ve bir mesaj gönderilinceye kadar bekleyebilirsiniz. Daha fazla bilgi için receive() yönteminin açıklamasına bakın.
MessageChannel sınıfı, worker (işçi) öğeleri arasında kopyalanan değil, paylaşılan özel nesne türlerinden biridir. Worker nesnesinin setSharedProperty() yöntemini çağırarak veya bir MessageChannel nesnesini kullanarak bir worker (işçi) öğesinden başka bir worker (işçi) öğesine bir mesaj kanalı ilettiğinizde, her iki worker (işçi) öğesinin de çalışma zamanının belleğinde aynı MessageChannel nesnesine referansı vardır.
İlgili API Öğeleri
Miras Alınan Genel Özellikleri Gizle
Miras Alınan Genel Özellikleri Göster| Özellik | Tanımlayan: | ||
|---|---|---|---|
 | constructor : Object
Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru. | Object | |
| messageAvailable : Boolean [salt okunur]
MessageChannel öğesinin, dahili mesaj kuyruğunda gönderen worker (işçi) öğesinden bir veya daha fazla mesaja sahip olup olmadığını belirtir. | MessageChannel | ||
| state : String [salt okunur]
MessageChannel nesnesinin geçerli durumunu belirtir (açık, kapanıyor veya kapalı). | MessageChannel | ||
| Yöntem | Tanımlayan: | ||
|---|---|---|---|
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [geçersiz kıl]
EventDispatcher nesnesi olan bir olay dinleyici nesnesini, dinleyicinin bir olayın bildirimini alması için kaydeder. | MessageChannel | ||
Geçerli MessageChannel öğesine, tüm mesajlar alındıktan sonra kapatılmasını söyler. | MessageChannel | ||
|
Olay akışına bir olay gönderir. | EventDispatcher | |
|
EventDispatcher nesnesinin belirli bir olay türü için kayıtlı dinleyicisi olup olmadığını kontrol eder. | EventDispatcher | |
|
Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir. | Object | |
|
Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir. | Object | |
|
Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir. | Object | |
Bu mesaj kanalı aracılığıyla gönderilen mesajların kuyruğundan tek bir mesaj nesnesini alır. | MessageChannel | ||
[geçersiz kıl]
EventDispatcher nesnesinden bir dinleyiciyi kaldırır. | MessageChannel | ||
Gönderen worker (işçi) öğesinden bir nesne göndererek bu nesneyi alıcı worker (işçi) için mesaj kuyruğuna ekler. | MessageChannel | ||
|
Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar. | Object | |
|
Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür. | Object | |
[geçersiz kıl]
Belirtilen nesnenin dize olarak temsil edilen halini döndürür. | MessageChannel | ||
|
Belirtilen nesnenin temel değerini döndürür. | Object | |
|
Bir olay dinleyicisinin bu EventDispatcher nesnesiyle mi, yoksa onun belirtilen olay türüne yönelik üst öğelerinden biriyle mi kayıtlı olduğunu kontrol eder. | EventDispatcher | |
| Olay | Özet | Tanımlayan: | ||
|---|---|---|---|---|
| [broadcast olayı] Flash Player veya AIR uygulaması işletim sistemi odağına gelip etkin olduğunda gönderilir. | EventDispatcher | ||
| Gönderen worker (işçi) öğesi bu MessageChannel nesnesinin send() yöntemini her çağırdığında gönderilir ve MessageChannel örneğinin kuyruğunda yeni bir mesaj nesnesinin kullanılabilir olduğunu belirtir. | MessageChannel | |||
| Mesaj kanalının state özelliğinin değeri değiştiğinde gönderilir. | MessageChannel | |||
| [broadcast olayı] Çalışan Flash Player veya AIR uygulaması sistem odağını kaybettiğinde ve etkin olmayan duruma geldiğinde gönderilir. | EventDispatcher | ||
messageAvailable | özellik |
messageAvailable:Boolean [salt okunur] | Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | Flash Player 11.4, AIR 3.4 |
MessageChannel öğesinin, dahili mesaj kuyruğunda gönderen worker (işçi) öğesinden bir veya daha fazla mesaja sahip olup olmadığını belirtir.
Uygulama
public function get messageAvailable():Booleanstate | özellik |
state:String [salt okunur] | Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | Flash Player 11.4, AIR 3.4 |
MessageChannel nesnesinin geçerli durumunu belirtir (açık, kapanıyor veya kapalı). Bu özellik için olası değerler, MessageChannelState sınıfında sabitler olarak tanımlanır.
Uygulama
public function get state():Stringİlgili API Öğeleri
addEventListener | () | yöntem |
override public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | Flash Player 11.4, AIR 3.4 |
EventDispatcher nesnesi olan bir olay dinleyici nesnesini, dinleyicinin bir olayın bildirimini alması için kaydeder. Belirli türde bir olay, aşama ve öncelik için görüntüleme listesindeki tüm düğümlere olay dinleyicilerini kaydedebilirsiniz.
Bir olay dinleyicisini başarıyla kaydettikten sonra, addEventListener() öğesine ek çağrılar yaparak önceliğini değiştiremezsiniz. Bir dinleyicinin önceliğini değiştirmek için, ilk olarak removeListener() öğesini çağırmanız gerekir. Daha sonra dinleyiciyi yeni öncelik seviyesiyle kaydedebilirsiniz.
Dinleyici kaydedildikten sonra, farklı bir type veya useCapture değeriyle addEventListener() öğesine yapılan çağrılar, ayrı bir dinleyici kaydının oluşturulmasıyla sonuçlanır. Örneğin, ilk olarak useCapture true değerine ayarlanmış durumdayken bir dinleyiciyi kaydederseniz, dinleyici yalnızca yakalama aşaması boyunca dinleme işlemi yapar. Aynı dinleyici nesnesini kullanarak, ancak useCapture false değerine ayarlanmış durumdayken tekrar addEventListener() öğesini çağırırsanız, iki ayrı dinleyiciniz olur: bunlardan biri yakalama aşamasında dinleme işlemi yapar, diğeri ise hedef ve köpürme aşamasında dinleme işlemi yapar.
Yalnızca hedef aşaması veya köpürme aşaması için bir olay dinleyicisini kaydedemezsiniz. Köpürme yalnızca hedef düğümün alt öğeleri için geçerli olduğundan, bu aşamalar kayıt sırasında birleştirilir.
Artık bir olay dinleyicisine ihtiyacınız olmadığında, removeEventListener() öğesini çağırarak olay dinleyicisini kaldırın, aksi takdirde bellek sorunları oluşabilir. Çöp toplayıcısı, gönderen nesne var olduğu sürece dinleyiciyi kaldırmadığından, (useWeakReference parametresi true olarak ayarlı değilse) olay dinleyicileri otomatik olarak bellekten kaldırılmaz.
Bir EventDispatcher örneği kopyalandığında, o örneğe ekli olan olay dinleyicileri kopyalanmaz. (Yeni oluşturulmuş düğümünüz için bir olay dinleyicisi gerekiyorsa, düğümü oluşturduktan sonra dinleyiciyi eklemeniz gerekir.) Ancak bir EventDispatcher örneğini taşırsanız, örneğe ekli olan olay dinleyicileri de onunla birlikte taşınır.
Bir olay düğümde işlenirken olay dinleyicisi o düğüme kaydediliyorsa, geçerli aşama sırasında olay dinleyicisi tetiklenmez ancak olay akışındaki köpürme aşaması gibi sonraki bir aşamada tetiklenebilir.
Bir olay düğümde işlenirken olay dinleyicisi o düğümden kaldırılırsa, geçerli eylemler tetiklenmeye devam eder. Olay dinleyicisi kaldırıldıktan sonra asla tekrar çağrılmaz (ileride işlenmek üzere tekrar kaydedilmediği sürece).
Parametreler
type:String — Olay türü.
| |
listener:Function — Olayı işleyen dinleyici işlevi. Bu işlev, bu örnekte gösterildiği gibi, Event nesnesini tek parametresi olarak kabul etmeli ve hiçbir öğe döndürmemelidir:
function(evt:Event):void İşleve herhangi bir ad verilebilir. | |
useCapture:Boolean (default = false)useCapture, true olarak ayarlanırsa dinleyici, olayı hedef veya köpürme aşamasında değil de yalnızca yakalama aşamasında işler. useCapture false değerindeyse dinleyici, olayı yalnızca hedef veya köpürme aşamasında işler. Olayı üç aşamada da dinlemek için addEventListener öğesini iki kez, biri useCapture true değerine ayarlanmış olarak, diğeri de useCapture false değerine ayarlanmış olarak çağırın.
| |
priority:int (default = 0) | |
useWeakReference:Boolean (default = false)Sınıf düzeyi üye işlevleri, çöp toplama işlemine tabi değildir. Böylece onları çöp toplama işlemine tabi tutmadan, sınıf düzeyi üye işlevleri için |
close | () | yöntem |
public function close():void| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | Flash Player 11.4, AIR 3.4 |
Geçerli MessageChannel öğesine, tüm mesajlar alındıktan sonra kapatılmasını söyler.
Bu yöntemi çağırdıktan sonra kuyruğa mesajlar eklemek için artık send() yöntemini çağıramazsınız. send() çağrısı başarısız olur ve false değerini döndürür.
Yalnızca önceden kuyrukta bekleyen mesajları almak için de receive() yöntemini çağırabilirsiniz. Kuyruk boşsa, receive() çağrısı null değerini döndürür.
Olaylar
channelState: — close() yöntemi çağrıldığında (bu, state özelliğini MessageChannelState.CLOSING olarak ayarlar) gönderilir. Tüm mesajlar alındığında ve state özelliği MessageChannelState.CLOSED olarak ayarlandığında yeniden gönderilir.
|
receive | () | yöntem |
public function receive(blockUntilReceived:Boolean = false):*| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | Flash Player 11.4, AIR 3.4 |
Bu mesaj kanalı aracılığıyla gönderilen mesajların kuyruğundan tek bir mesaj nesnesini alır.
Gönderen worker (işçi) öğesinin kodu, MessageChannel nesnesinin send() yöntemini her çağırdığında, mesaj kanalının dahili mesaj kuyruğuna tek bir nesne eklenir. Bu nesneler, receive() yöntemini çağıran alıcı worker (işçi) tarafından teker teker kaldırılıncaya kadar kuyrukta istiflenir. Mesaj nesneleri, gönderildikleri sırayla alınır.
Kuyruğun alınacak bir mesaj nesnesi içerip içermediğini kontrol etmek için messageAvailable özelliğini kullanın.
Standart durumda, send() öğesine iletilen nesne AMF3 biçiminde serileştirilir. receive() çağrısı tarafından kuyruktan kaldırıldığında, alıcı worker (işçi) öğesinde bir ActionScript nesnesine (orijinal nesnenin bir kopyası) bunun serileştirilmesi kaldırılır ve worker (işçi) o kopyanın bir referansını alır. Belirli türde nesneler kopyalanmaz, ancak worker (işçi) öğeleri arasında paylaşılır. Bu durumda, alıcı worker (işçi) öğesinin aldığı nesne, nesnenin yeni bir kopyası değil, paylaşılan nesnenin bir referansıdır. Bu durumla ilgili daha fazla bilgi için send() yönteminin açıklamasına bakın.
Mesaj kuyruğu boşsa ve blockUntilReceived parametresi için true değerini iletirseniz, yöntemin davranışı değişir. Bu durumda worker (işçi), receive() çağrısında yürütme iş parçacığını duraklatır ve daha fazla kod yürütmez. Gönderen worker (işçi), send() öğesini çağırdıktan sonra receive() çağrısı mesajı alarak tamamlanır. Worker (işçi), receive çağrısının ardından bir sonraki kod satırında kod yürütmeyi sürdürür.
Parametreler
blockUntilReceived:Boolean (default = false)false) veya receive() çağrısında duraklayıp kuyruk boş olduğunda bir mesajın gönderilmesini bekleyeceğini (true) belirtir
|
* — worker (işçi) gönderilerek send() yöntemine iletilen nesnenin bir kopyası. Nesne, worker (işçi) öğeleri arasında paylaşılan özel türlerden biriyse, döndürülen değer, paylaşılan nesnenin kopyası değil, paylaşılan nesnenin bir referansıdır. Kuyrukta kullanılabilir bir mesaj yoksa, yöntem null değerini döndürür.
|
Atar
IOError — yöntem çağrıldığı anda kanal kapatılırsa veya blockUntilReceived argümanı, yürütmenin duraklatılmasıyla sonuçlanırsa ve daha sonra kanal başka bir worker (işçi) tarafından kapatılırsa.
| |
ArgumentError — arama kodu, alıcı worker (işçi) öğesinde değilse
| |
ScriptTimeoutError — yöntem, Flash Player'da ilkel worker (işçi) öğesindeki koddan çağrılırsa ve blockUntilReceived argümanı, worker (işçi) öğesinin komut dosyası zaman aşımı sınırından (varsayılan olarak 15 saniye) uzun duraklamasına neden olursa
|
İlgili API Öğeleri
removeEventListener | () | yöntem |
override public function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | Flash Player 11.4, AIR 3.4 |
EventDispatcher nesnesinden bir dinleyiciyi kaldırır. EventDispatcher nesnesiyle kayıtlı eşlenen bir dinleyici yoksa, bu yönteme yapılan çağrının herhangi bir etkisi yoktur.
Parametreler
type:String — Olay türü.
| |
listener:Function — Kaldırılacak dinleyici nesnesi.
| |
useCapture:Boolean (default = false)removeEventListener() öğesine yapılan iki çağrı, ikisini de kaldırmak için gereklidir. useCapture() öğesine sahip çağrılardan biri true, useCapture() öğesine sahip olan diğeri ise false olarak ayarlanmıştır.
|
send | () | yöntem |
public function send(arg:*, queueLimit:int = -1):void| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | Flash Player 11.4, AIR 3.4 |
Gönderen worker (işçi) öğesinden bir nesne göndererek bu nesneyi alıcı worker (işçi) için mesaj kuyruğuna ekler.
arg parametresine iletilen nesne neredeyse herhangi bir nesne olabilir. Aşağıda belirtilen istisnalar dışında, arg parametresine iletilen herhangi bir nesne, referans tarafından iletilmez. send() çağrıldıktan sonra bir worker (işçi) öğesindeki nesneye yapılan herhangi bir değişiklik, diğer worker (işçi) öğesine taşınmaz. receive() çağrıldığında nesne AMF3 biçimine serileştirilerek ve alıcı worker (işçi) öğesindeki yeni bir nesneye serileştirilmesi kaldırılarak kopyalanır. Bu nedenle, görüntüleme nesneleri de dahil olmak üzere, AMF3 biçiminde serileştirilemeyen herhangi bir nesne, arg parametresine iletilemez. Özel sınıfın düzgün şekilde iletilmesi için, flash.net.registerClassAlias() işlevi veya [RemoteClass] meta verisi kullanılarak sınıf tanımının kaydedilmesi gerekir. Bu tekniklerden herhangi biriyle, her iki worker (işçi) öğesinin sınıf sürümü için aynı diğer ad kullanılmalıdır.
Bu kural için, nesnelerin worker (işçi) öğeleri arasında paylaşılmadığı istisna niteliğinde beş tür nesne vardır:
- Worker
- MessageChannel
- paylaşılabilir ByteArray (
shareableözelliğitrueolarak ayarlanmış bir ByteArray nesnesi - Mutex
- Durum
Bu nesnelerin bir örneğini arg parametresine iletirseniz, her worker (işçi) öğesinin aynı temel nesneye bir referansı vardır. Bir worker (işçi) öğesindeki örnek üzerinde yapılan değişiklikler, diğer worker (işçi) öğelerinde hemen kullanılabilir olur. Ayrıca, send() yöntemini kullanarak bu nesnelerin aynı örneğini birden çok defa iletirseniz çalışma zamanı, alıcı worker (işçi) öğesinde nesnenin yeni bir kopyasını oluşturmaz. Bunun yerine, aynı referans yeniden kullanılır ve böylece sistem belleği kullanımı azaltılır.
Varsayılan olarak bu yöntem, nesneyi kuyruğa ekler ve hemen dönerek sonraki kod satırıyla yürütmeyi sürdürür. Kuyruğun belirli bir boyutun ötesinde büyümesini önlemek istiyorsanız, kuyrukta izin verilecek maksimum öğe sayısını belirtmek için queueLimit parametresini kullanabilirsiniz. send() yöntemini çağırdığınız anda kuyruktaki öğe sayısı belirttiğiniz sınırdan büyükse worker (işçi), send() çağrısında yürütme iş parçacığını duraklatır. Alıcı worker (işçi), kuyruk boyutu belirtilen kuyruk sınırından küçük olacak şekilde receive() yöntemini yeterli defa çağırdıktan sonra, send() çağrısı tamamlanır. Ardından worker (işçi), sonraki kod satırında yürütmeye devam eder.
Parametreler
arg:* — mesaj kuyruğuna eklenecek nesne
| |
queueLimit:int (default = -1) |
Olaylar
channelMessage: — alıcı worker (işçi) öğesine, kuyrukta bir mesaj nesnesinin kullanılabilir olduğunu bildirmek için gönderilir
|
Atar
IOError — yöntem çağrıldığı anda kanal kapatılırsa veya queueLimit argümanı, yürütmenin duraklatılmasıyla sonuçlanırsa ve daha sonra kanal başka bir worker (işçi) tarafından kapatılırsa.
| |
ArgumentError — arama kodu, gönderen worker (işçi) öğesinde değilse
| |
ScriptTimeoutError — yöntem, Flash Player'da ilkel worker (işçi) öğesindeki koddan çağrılırsa ve queueLimit argümanı, worker (işçi) nesnesinin komut dosyası zaman aşımı sınırından (varsayılan olarak 15 saniye) uzun duraklamasına neden olursa
|
İlgili API Öğeleri
toString | () | yöntem |
override public function toString():String| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | Flash Player 11.4, AIR 3.4 |
Belirtilen nesnenin dize olarak temsil edilen halini döndürür.
Not: Object sınıfı yöntemleri, Object prototipinde dinamik olarak oluşturulur. Bir Object alt sınıfında bu yöntemi yeniden tanımlamak için override anahtar kelimesini kullanmayın. Örneğin, Object sınıfının bir alt sınıfı, temel sınıfın geçersiz kılınmasını kullanmak yerine, function toString():String uygular.
String — Nesnenin dize olarak temsil edilen hali.
|
channelMessage | Olay |
flash.events.Eventözellik Event.type =
flash.events.Event.CHANNEL_MESSAGE| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | Flash Player 11.4, AIR 3.4 |
Gönderen worker (işçi) öğesi bu MessageChannel nesnesinin send() yöntemini her çağırdığında gönderilir ve MessageChannel örneğinin kuyruğunda yeni bir mesaj nesnesinin kullanılabilir olduğunu belirtir.
Event.CHANNEL_MESSAGE sabiti, bir channelMessage olay nesnesinin type özelliğinin değerini tanımlar.
Bu olay şu özelliklere sahiptir:
| Özellik | Değer |
|---|---|
bubbles | false |
cancelable | false; iptal edilecek varsayılan davranış yoktur. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
target | Bu olayı gönderen nesne. |
channelState | Olay |
flash.events.Eventözellik Event.type =
flash.events.Event.CHANNEL_STATE| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | Flash Player 11.4, AIR 3.4 |
Mesaj kanalının state özelliğinin değeri değiştiğinde gönderilir.
Event.CHANNEL_STATE sabiti, bir channelState olay nesnesinin type özelliğinin değerini tanımlar.
Bu olay şu özelliklere sahiptir:
| Özellik | Değer |
|---|---|
bubbles | false |
cancelable | false; iptal edilecek varsayılan davranış yoktur. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
target | Bu olayı gönderen nesne. |
Tue Jun 12 2018, 01:09 PM Z