mx.messaging.MultiTopicProducer (Flex 3.2)

（仅限 BlazeDS）

包	mx.messaging
类	public class MultiTopicProducer
继承	MultiTopicProducer AbstractProducer MessageAgent EventDispatcher Object

MultiTopicProducer 将消息发送到具有零个或多个 subtopics 的目标。它与常规 Producer 类似，但它可以将消息定向到任何订阅大量 subtopics 之一的使用者。如果使用者是 MultiTopicConsumer，并且该使用者已订阅了生产者使用的 subtopics 列表中的多个 subtopic，则使用者将仅能收到消息一次。

MultiTopicProducer 将为其发送的每条消息调度 MessageAckEvent 或 MessageFaultEvent，具体取决于出站消息的发送和处理是否成功。

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		定义方
		authenticated : Boolean [只读 (read-only)] 指示此 MessageAgent 是否使用指向其目标的经过身份验证的连接。	MessageAgent
		autoConnect : Boolean 如果为 true，则 Producer 将在第一次调用 send() 方法时自动连接到其目标。	AbstractProducer
		channelSet : ChannelSet 提供对 MessageAgent 使用的 ChannelSet 的访问。	MessageAgent
		clientId : String [只读 (read-only)] 提供对 MessageAgent 的客户端 id 的访问。	MessageAgent
		connected : Boolean [只读 (read-only)] 指示此 MessageAgent 当前是否已通过其 ChannelSet 连接到了其目标。	MessageAgent
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		defaultHeaders : Object 要应用于 Producer 发送的消息的默认标头。	AbstractProducer
		destination : String 提供对 MessageAgent 的目标的访问。	MessageAgent
		prototype : Object [静态] 对类或函数对象的原型对象的引用。	Object
		reconnectAttempts : int Producer 在目标不可用或连接到目标关闭的情况下进行的重新连接尝试次数。	AbstractProducer
		reconnectInterval : int 重新连接尝试之间间隔的毫秒数。	AbstractProducer
		requestTimeout : int 提供对已发送消息的请求超时（以秒为单位）的访问。	MessageAgent
		subtopics : ArrayCollection 提供对发布消息时使用的 subtopics 列表的访问	MultiTopicProducer

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		定义方
		MultiTopicProducer() 构造 Producer。	MultiTopicProducer
		acknowledge(ackMsg:AcknowledgeMessage, msg:IMessage):void 收到已发送消息的结果时由 MessageResponder 调用。	MessageAgent
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		addSubtopic(subtopic:String):void 将 subtopic 添加到此制造者发送的消息的当前 subtopics 列表中。	MultiTopicProducer
		channelConnectHandler(event:ChannelEvent):void 处理 CONNECT ChannelEvent。	MessageAgent
		channelDisconnectHandler(event:ChannelEvent):void 处理 DISCONNECT ChannelEvent。	MessageAgent
		channelFaultHandler(event:ChannelFaultEvent):void 处理 ChannelFaultEvent。	MessageAgent
		connect():void 将 Producer 连接到其目标。	AbstractProducer
		disconnect():void 断开 Producer 与其远程目标之间的连接。	AbstractProducer
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		fault(errMsg:ErrorMessage, msg:IMessage):void 收到已发送消息的错误时由 MessageResponder 调用。	MessageAgent
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 指示对象是否已经定义了指定的属性。	Object
		hasPendingRequestForMessage(msg:IMessage):Boolean 如果存在传入消息的任何挂起的请求，则返回 true。	MessageAgent
		initialized(document:Object, id:String):void 在创建了实现对象、并分配了标签上指定的所有属性后调用。	MessageAgent
		isPrototypeOf(theClass:Object):Boolean 指示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		logout():void 从其远程目标注销 MessageAgent。	MessageAgent
		propertyIsEnumerable(name:String):Boolean 指示指定的属性是否存在、是否可枚举。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		removeSubtopic(subtopic:String):void 将 subtopic 从 subtopics 属性中删除。	MultiTopicProducer
		send(message:IMessage):void 向其目标发送指定的消息。	AbstractProducer
		setCredentials(username:String, password:String, charset:String = null):void 设置 MessageAgent 用于对目标进行身份验证的凭据。	MessageAgent
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		setRemoteCredentials(username:String, password:String, charset:String = null):void 设置将传递到远程目标以对次系统进行身份验证的远程凭据。	MessageAgent
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。	EventDispatcher

	方法	定义方
		initChannelSet(message:IMessage):void 用于首次连接之前自动初始化 MessageAgent 的 channelSet 属性。	MessageAgent
		internalSend(message:IMessage, waitForClientId:Boolean = true):void 使用代理的 ChannelSet 将 Message 从 MessageAgent 发送到其目标。	MessageAgent
		reAuthorize(msg:IMessage):void 子类将覆盖此函数来实现由特定于它们的服务器会话超时行为而导致的重新身份验证。	MessageAgent

事件

隐藏继承的事件

显示继承的事件

	摘要	定义方
acknowledge	收到已发送消息的确认消息时调度。	MessageAgent
activate	[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。	EventDispatcher
channelConnect	MessageAgent 使用的基础 Channel 建立连接时调度。	MessageAgent
channelDisconnect	MessageAgent 使用的基础 Channel 断开连接时调度。	MessageAgent
channelFault	MessageAgent 使用的基础 Channel 出错时调度。	MessageAgent
deactivate	[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。	EventDispatcher
fault	发生消息错误时调度。	MessageAgent
propertyChange	MessageAgent 的连接属性发生更改时调度。	MessageAgent

属性详细信息

subtopics

属性

subtopics:ArrayCollection [读写]

提供对发布消息时使用的 subtopics 列表的访问

此属性可用作数据绑定的源。修改此属性后，将调度 propertyChange 事件。

实现
public function get subtopics():ArrayCollection
public function set subtopics(value:ArrayCollection):void

构造函数详细信息

MultiTopicProducer

()

构造函数

public function MultiTopicProducer()

构造 Producer。

示例

function sendMessage():void
       {
           var producer:MultiTopicProducer = new MultiTopicProducer();
           producer.destination = "NASDAQ";
           var msg:AsyncMessage = new AsyncMessage();
           msg.headers.operation = "UPDATE";
           msg.body = {"SYMBOL":50.00};
           // only send to subscribers to subtopic "SYMBOL" and "ALLSTOCKS"
           msg.addSubtopic("SYMBOL");
           msg.addSubtopic("ALLSTOCKS");
           producer.send(msg);
       }

方法详细信息

addSubtopic

()

方法

public function addSubtopic(subtopic:String):void

将 subtopic 添加到此制造者发送的消息的当前 subtopics 列表中。这是将此 subtopic 添加到 subtopics 属性的快捷方式。

参数

subtopic:String — 要添加到由此 producer 发送的 subtopic 的当前列表的 subtopic。

removeSubtopic

()

方法

public function removeSubtopic(subtopic:String):void

将 subtopic 从 subtopics 属性中删除。如果列表中不包含该 subtopic，则将引发错误。

参数

subtopic:String — 要从 subtopics 属性删除的 subtopic。

Adobe® Flex™ 3.2 语言参考		全部包 \| 全部类 \| 语言元素 \| 索引 \| 附录 \| 约定 \| 框架无框架
MultiTopicProducer	属性 \| 方法 \| 事件 \| 样式 \| 效果 \| 常量 \| 示例