mx.messaging.channels.HTTPChannel (Flex 3.2)

（仅限 BlazeDS）

包	mx.messaging.channels
类	public class HTTPChannel
继承	HTTPChannel PollingChannel Channel EventDispatcher Object
子类	SecureHTTPChannel, StreamingHTTPChannel

HTTPChannel 类支持使用 HTTP 进行消息传送。您可以配置此 Channel 每隔一段时间对服务器轮询以充分利用服务器推送技术。您还可以在禁用轮询的前提下使用此 Channel 将 RPC 消息发送到远程目标，以调用其方法。

HTTPChannel 依赖于 Flash Player 和 AIR 的本机网络服务，并由 URLLoader 类向 ActionScript 公开。此通道以独占方式使用 URLLoader，并在每次请求时创建一个新的 URLLoader。

使用 ServerConfig.getChannel() 方法在框架内创建通道。如果需要，可以直接构造通道并将其分配给 ChannelSet。

通道表示到远程端点的物理连接。默认情况下，通道可以跨目标共享。这意味着定向于不同目标的客户端可以使用同一 Channel 与这些目标进行通信。

在轮询模式下使用时，此 Channel 将基于配置文件中的 polling-interval-seconds 属性轮询服务器以查看是否有新消息，您可以通过设置 pollingInterval 属性更改此设置。默认值为 3 秒。若要启用轮询，必须连接此通道并将配置文件中的 polling-enabled 属性设置为 true，或者必须将此 Channel 的 pollingEnabled 属性设置为 true。

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		定义方
		authenticated : Boolean [只读 (read-only)] 指示此通道是否已经过身份验证。	Channel
		channelSets : Array [只读 (read-only)] 提供对连接到 Channel 的 ChannelSet 的访问。	Channel
		connected : Boolean [只读 (read-only)] 指示此通道是否已与远程目标建立连接。	Channel
		connectTimeout : int 提供对此通道的连接超时（以秒为单位）的访问。	Channel
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		endpoint : String [只读 (read-only)] 提供对此通道的端点的访问。	Channel
		failoverURIs : Array 提供对此通道可能尝试将故障转移到的端点 URI 集的访问（如果端点已群集化）。	Channel
		id : String 提供对此通道的 id 的访问。	Channel
		piggybackingEnabled : Boolean 指示未处理的轮询还在等待处理时，此通道是否捎带轮询请求以及普通出站消息。	HTTPChannel
		polling : Boolean [只读 (read-only)] 报告当前是否正在轮询通道。	HTTPChannel
		pollingEnabled : Boolean 指示是否对此通道启用轮询。	HTTPChannel
		pollingInterval : Number 提供对此 Channel 轮询间隔的访问权限。	HTTPChannel
		protocol : String [只读 (read-only)] 返回此通道的协议 (http)。	HTTPChannel
		prototype : Object [静态] 对类或函数对象的原型对象的引用。	Object
		reconnecting : Boolean [只读 (read-only)] 指示此通道是否正在重新连接到其它端点。	Channel
		recordMessageSizes : Boolean [只读 (read-only)] Channel 属性确定性能信息注入的级别 - 无论我们注入消息大小与否。	Channel
		recordMessageTimes : Boolean [只读 (read-only)] Channel 属性确定性能信息注入的级别 - 无论我们注入时间戳与否。	Channel
		requestTimeout : int 提供对通道的默认请求超时（以秒为单位）的访问。	Channel
		uri : String 提供对用于创建此通道的整个端点 URI 的 URI 的访问。	Channel

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		定义方
		HTTPChannel(id:String = null, uri:String = null) 创建新的 HTTPChannel 实例。	HTTPChannel
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		applySettings(settings:XML):void 子类应覆盖此方法以应用单个通道可能需要的任何设置。	Channel
		connect(channelSet:ChannelSet):void 将 ChannelSet 连接到 Channel。	Channel
		disablePolling():void 根据调用 enablePolling() 和 disablePolling() 的次数禁用轮询。	PollingChannel
		disconnect(channelSet:ChannelSet):void 断开 ChannelSet 与 Channel 的连接。	Channel
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		enablePolling():void 根据调用 enablePolling() 和 disablePolling() 的次数启用轮询。	PollingChannel
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 指示对象是否已经定义了指定的属性。	Object
		isPrototypeOf(theClass:Object):Boolean 指示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		logout(agent:MessageAgent):void 如果 Channel 已连接，则向服务器发送 CommandMessage 以进行注销。	Channel
		poll():void 如果有使用者订阅此通道则会启动轮询操作，同时此通道也会启用轮询。	PollingChannel
		propertyIsEnumerable(name:String):Boolean 指示指定的属性是否存在、是否可枚举。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		send(agent:MessageAgent, message:IMessage):void 向其目标对象发送指定的消息。	PollingChannel
		setCredentials(credentials:String, agent:MessageAgent = null, charset:String = null):void 将凭据设置为指定的值。	Channel
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。	EventDispatcher

受保护的方法

显示继承的受保护方法

	方法		定义方
		connectFailed(event:ChannelFaultEvent):void 处理失败的内部连接并为 Channel 调度 FAULT 事件。	Channel
		connectSuccess():void 处理成功的内部连接并为 Channel 调度 CONNECT 事件。	Channel
		connectTimeoutHandler(event:TimerEvent):void 通过调度 ChannelFaultEvent 处理连接超时。	Channel
		disconnectFailed(event:ChannelFaultEvent):void 处理失败的内部断开连接并为 Channel 调度 FAULT 事件。	Channel
		disconnectSuccess(rejected:Boolean = false):void 处理成功的内部断开连接并为 Channel 调度 DISCONNECT 事件。	Channel
		flexClientWaitHandler(event:PropertyChangeEvent):void 处理对用于管理应用程序的初始 Channel 连接的保护条件的更改。	Channel
		getMessageResponder(agent:MessageAgent, message:IMessage):MessageResponder 为 Channel 的 send() 方法返回适当的 MessageResponder。	Channel
		internalConnect():void 将 Channel 连接到其端点。	Channel
		internalDisconnect(rejected:Boolean = false):void 断开 Channel 与其端点之间的连接。	Channel
		internalSend(messageResponder:MessageResponder):void 通过 Channel 发送 Message 并将响应传送到 Responder。	Channel

摘要	定义方
activate	[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。	EventDispatcher
channelConnect	通道连接到其端点后调度。	Channel
channelDisconnect	通道与其端点断开连接后调度。	Channel
channelFault	通道出错后调度。	Channel
deactivate	[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。	EventDispatcher
message	在通道从其端点接收到消息时调度。	Channel
propertyChange	在通道的某一属性发生更改时调度。	Channel

属性详细信息

piggybackingEnabled

属性

piggybackingEnabled:Boolean [读写]

指示未处理的轮询还在等待处理时，此通道是否捎带轮询请求以及普通出站消息。这允许服务器捎带客户端数据及其对客户端消息的响应。

实现
public function get piggybackingEnabled():Boolean
public function set piggybackingEnabled(value:Boolean):void

polling

属性

polling:Boolean [只读 (read-only)]

报告当前是否正在轮询通道。

实现
public function get polling():Boolean

pollingEnabled

属性

pollingEnabled:Boolean [读写]

指示是否对此通道启用轮询。

实现
public function get pollingEnabled():Boolean
public function set pollingEnabled(value:Boolean):void

pollingInterval

属性

pollingInterval:Number [读写]

提供对此 Channel 轮询间隔的访问权限。此值以毫秒为单位。此值确定 Channel 从服务器请求消息的频率，以便充分利用服务器推送技术。

实现
public function get pollingInterval():Number
public function set pollingInterval(value:Number):void

引发

ArgumentError — 如果分配给 pollingInterval 的值等于或小于 0。

protocol

属性

protocol:String [只读 (read-only)]

返回此通道的协议 (http)。

实现
public function get protocol():String

构造函数详细信息

HTTPChannel

()

构造函数

public function HTTPChannel(id:String = null, uri:String = null)

创建新的 HTTPChannel 实例。

参数

	`id:String` (default = `null`) — 此 Channel 的 id。

	`uri:String` (default = `null`) — 此 Channel 的 uri。

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