BlazeDs Message service 爲Producer組件提供一種,爲自己產生的消息添加信息頭(message headers)和副主題(subtopic )的功能,然後Consumer組件基於這些信息指定自己的過濾標準,這樣以來,只有符合這些過濾標準的信息才能被Consumer接收。Consumer會把過濾標準發送給server當它調用自身subscribe()
方法時。所以實際上過濾是在server端進行的,在信息被送到consumer之前。(注:過濾是基於信息頭和副主題的,所以不需要同時再用其它技術過濾。)
用選擇器(selectors)
Producer把額外的信息以信息頭的形式加入到自己生產的信息中,而Consumer再用信息選擇器屬性,基於信息頭值過濾信息。
我們可以用信息的AsyncMessage.headers 屬性去指明信息頭。然後這個信息頭就被關聯到一個數組中,這個數組的key值是信息頭名稱,value就是一個數字或者是一個字串。(注:不要以“JMS'“”DS“來作爲信息頭名稱的開始,這些前綴是被保留的。)
以下代碼把一個名爲”prop1“信息頭加入信息中,並設置了它的值。
<?xml version="1.0"?>
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">
<mx:Script>
<![CDATA[
import mx.messaging.*;
import mx.messaging.messages.*;
import mx.messaging.events.*;
private function sendMessage():void {
var message:AsyncMessage = new AsyncMessage();
message.headers = new Array();
message.headers["prop1"] = 5;
message.body = input.text; producer.send(message);
} ]]>
</mx:Script>
<mx:Producer id="producer" destination="chat"/>
<mx:TextInput id="userName"/>
<mx:TextInput id="input"/>
<mx:Button label="Send" click="sendMessage();"/>
</mx:Application>
過濾信息是基於信息頭的,用 Consumer.selector 去指明一個選擇器。一個信息選擇器是一個字串,這是一個基於SQL92條件表達式語法的一個條件表達式。Consumer只接受信息頭符合過濾標準的信息。
以下代碼設置一個Consumer.selector,讓它只接受信息頭名爲” prop1 “,並且值大於4的信息。
<?xml version="1.0"?>
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" creationComplete="logon();"> <mx:Script>
<![CDATA[
import mx.messaging.*;
import mx.messaging.messages.*;
import mx.messaging.events.*;
// Subscribe to destination.
private function logon():void {
consumer.subscribe();
}
// Write received message to TextArea control.
private function messageHandler(event:MessageEvent):void {
// Handle message event.
ta.text += event.message.body + "/n";
} ]]>
</mx:Script>
<mx:Consumer id="consumer" destination="chat" selector="prop1 > 4" message="messageHandler(event);"/> <mx:TextArea id="ta" width="100%" height="100%"/> </mx:Application>
用副主題(subtopics )
Producer能產生髮送信息並指明它的類別(category ),我們叫副主題,你可以配置一個組件讓他接受一個分配了某個或某些副主題的信息。(注:你不能使用副主題到JMS destination,你可以用message headers 和selector 來完成相似的功能。)
在一個Producer中用“subtopic ”屬性去爲一個信息分配副主題,如下形式:
producer.subtopic = mainToken[.secondaryToken][.additionalToken][...]。
例如:你可以定義“"chat", "chat.fds.newton"副主題,“.”是默認的分割符號,你可以在配置文件中用<subtopic-separator> 屬性定義一個不同的分割符。
在Consumer組件中,同樣用subtopic 屬性去指明要接收的信息擁有的副主題。當用通配符時,可以讓你的Consumer接收更多信息 副主題。
Messaging Service支持單字符通配在副主題字串中。比如 "foo.*"匹配"foo.bar" and "foo.baz", and also "foo.bar.aaa" and "foo.bar.bbb.ccc"。如果通配符在除了最後位置以外的地方,它只能匹配在這個位置上的字符,比如"foo.*.baz"匹配"foo.bar.baz" and "foo.aaa.baz", but not "foo.bar.cookie"and "foo.aaa.ccc.baz".
下面是Producer 設置destination and subtopic 的實踐代碼
<?xml version="1.0"?>
<!-- ds/messaging/Subtopic1.mxml -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">
<mx:Script>
<![CDATA[
import mx.messaging.*;
import mx.messaging.messages.*;
import mx.messaging.events.*;
private function useSubtopic():void {
var message:AsyncMessage = new AsyncMessage();
producer.subtopic = "chat.fds.newton";
// Generate message.
producer.send(message);
} ]]>
</mx:Script>
<mx:Producer id="producer" destination="chat"/>
</mx:Application>
然後我們用Consumer 來訂閱某個destination 和subtopic下的信息。這次我們用通配符去接收所有擁有在chat.fds下副主題的信息。
<?xml version="1.0"?>
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" creationComplete="logon();"> <mx:Script>
<![CDATA[
import mx.messaging.*;
import mx.messaging.messages.*;
import mx.messaging.events.*;
private function messageHandler(event:MessageEvent):void {
// Handle message event.
ta.text += event.message.body + "/n";
}
private function logon():void {
consumer.subtopic = "chat.fds.*";
consumer.subscribe(); }
]]>
</mx:Script>
<mx:Consumer id="consumer" destination="chat" message="messageHandler(event);"/>
<mx:TextArea id="ta" width="100%" height="100%"/>
</mx:Application>
爲了讓一個destination啓動subtopics功能 ,你要設置 <allow-subtopics >爲true,在messaging-config.xml文件destination定義中,而<subtopic-separator >是設置subtopics分割符的,the default value is "." 。
<destination id="ChatTopic">
<properties>
<network>
<subscription-timeout-minutes>0</subscription-timeout-minutes>
</network>
<server>
<message-time-to-live>0</message-time-to-live>
<allow-subtopics>true</allow-subtopics>
<subtopic-separator>.</subtopic-separator>
</server>
</properties>
<channels>
<channel ref="my-streaming-amf"/>
</channels>
</destination>
From: