mx.rpc.http.mxml.HTTPService (Flex 3.2)

包	mx.rpc.http.mxml
类	public class HTTPService
继承	HTTPService HTTPService AbstractInvoker EventDispatcher Object
实现	IMXMLSupport, IMXMLObject

在 MXML 文件中使用 <mx:HTTPService> 标签代表 HTTPService 对象。当调用 HTTPService 对象的 send() 方法时，将发出对指定 URL 的 HTTP 请求，并且返回 HTTP 响应。可以选择向指定 URL 传递参数。如果没有使用基于服务器的代理服务，则只能使用 HTTP GET 或 POST 方法。如果将 useProxy 属性设置为 true 并使用基于服务器的代理服务，则还可以使用 HTTP HEAD、OPTIONS、TRACE 和 DELETE 方法。

注意：由于软件限制，当使用 GET 时 HTTPService 不生成用户界面友好的错误消息。

MXML 语法

隐藏 MXML 语法

The <mx:HTTPService> tag accepts the following tag attributes:

 <mx:HTTPService
 Properties
 concurrency="multiple|single|last"
 contentType="application/x-www-form-urlencoded|application/xml"
 destination="DefaultHTTP"
 id="No default."
 method="GET|POST|HEAD|OPTIONS|PUT|TRACE|DELETE"
 resultFormat="object|array|xml|e4x|flashvars|text"
 showBusyCursor="false|true"
 makeObjectsBindable="false|true"
 url="No default."
 useProxy="false|true"
 xmlEncode="No default."
 xmlDecode="No default."
  Events
 fault="No default."
 result="No default."
 />

The <mx:HTTPService> tag can have a single <mx:request> tag under which the parameters can be specified.

另请参见

mx.rpc.http.HTTPService
mx.validators.Validator
mx.managers.CursorManager

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		定义方
		channelSet : ChannelSet 提供对服务使用的 ChannelSet 的访问。	HTTPService
		concurrency : String 指示如何处理对同一服务的多个调用的值。	HTTPService
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		contentType : String = "application/x-www-form-urlencoded" 服务请求的内容类型。	HTTPService
		destination : String services-config.xml 文件中的 HTTPService 目标名称。	HTTPService
		headers : Object 发送到第三方端点的自定义 HTTP 标头。	HTTPService
		lastResult : Object [只读 (read-only)] 上次调用的结果。	AbstractInvoker
		makeObjectsBindable : Boolean 当该置为 true 时，返回的匿名对象将强制成为可绑定的对象。	AbstractInvoker
		method : String = "GET" 发送请求的 HTTP 方法。	HTTPService
		prototype : Object [静态] 对类或函数对象的原型对象的引用。	Object
		request : Object 用作 URL 参数的名称/值对的对象。	HTTPService
		requestTimeout : int 提供对已发送消息的请求超时（以秒为单位）的访问。	HTTPService
		resultFormat : String 指示如何反序列化由 HTTP 调用返回的结果的值。	HTTPService
		rootURL : String HTTPService 对象在计算相对 URL 时应使用的 URL。	HTTPService
		showBusyCursor : Boolean 如果为 true，在执行服务时会显示忙碌光标。	HTTPService
		url : String 服务的位置。	HTTPService
		useProxy : Boolean 指定是否使用 Flex 代理服务。	HTTPService
		xmlDecode : Function ActionScript 函数，用于解码 XML 格式的服务结果。	HTTPService
		xmlEncode : Function ActionScript 函数，用于将服务请求按 XML 编码。	HTTPService

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		定义方
		HTTPService(rootURL:String = null, destination:String = null) 创建一个新的 HTTPService。	HTTPService
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		cancel(id:String = null):AsyncToken 取消上次服务调用或具有指定 ID 的调用。	AbstractInvoker
		clearResult(fireBindingEvent:Boolean = true):void 将 invoker 的 result 属性设置为 null。	AbstractInvoker
		disconnect():void 断开服务的网络连接。	HTTPService
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 指示对象是否已经定义了指定的属性。	Object
		initialized(document:Object, id:String):void 创建实现对象且初始化在 MXML 标签上指定的所有组件属性后调用。	HTTPService
		isPrototypeOf(theClass:Object):Boolean 指示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		logout():void 将用户从目标中注销。	HTTPService
		propertyIsEnumerable(name:String):Boolean 指示指定的属性是否存在、是否可枚举。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		send(parameters:Object = null):AsyncToken 执行 HTTPService 请求。	HTTPService
		setCredentials(username:String, password:String, charset:String = null):void 为服务访问的目标设置凭据。	HTTPService
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void 在访问 HTTP URL 时对用户进行身份验证的用户名和密码。	HTTPService
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。	EventDispatcher

摘要	定义方
activate	[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。	EventDispatcher
deactivate	[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。	EventDispatcher
fault	当 HTTPService 调用失败时调度。	HTTPService
invoke	只要在通道尝试发送消息前没有引发错误，当调用 HTTPService 调用时将触发 invoke 事件。	HTTPService
result	当 HTTPService 调用成功返回时调度。	HTTPService

公共常量

隐藏继承的公共常量

显示继承的公共常量

	常量		定义方
		CONTENT_TYPE_FORM : String = "application/x-www-form-urlencoded" [静态] 指示由 HTTP 服务发送的数据按 application/x-www-form-urlencoded 进行编码。	HTTPService
		CONTENT_TYPE_XML : String = "application/xml" [静态] 指示由 HTTP 服务发送的数据按 application/xml 进行编码。	HTTPService
		DEFAULT_DESTINATION_HTTP : String = "DefaultHTTP" [静态] 指示 HTTPService 对象使用 DefaultHTTP 目标。	HTTPService
		DEFAULT_DESTINATION_HTTPS : String = "DefaultHTTPS" [静态] 指示 HTTPService 对象使用 DefaultHTTPS 目标。	HTTPService
		ERROR_DECODING : String = "Client.CouldNotDecode" [静态] 指示无法将 XML 格式的结果分析为 XML 实例或解码为对象。	HTTPService
		ERROR_ENCODING : String = "Client.CouldNotEncode" [静态] 指示输入参数无法按 XML 编码。	HTTPService
		ERROR_URL_REQUIRED : String = "Client.URLRequired" [静态] 指示 useProxy 属性设置为 false 但没有提供 url。	HTTPService
		RESULT_FORMAT_ARRAY : String = "array" [静态] 结果格式“array”与“object”相似，但是其返回的值始终为数组；这样，如果从结果格式“object”返回的结果尚不是数组，则将把该项目添加为一个新数组的第一个项目。	HTTPService
		RESULT_FORMAT_E4X : String = "e4x" [静态] 结果格式“e4x”指定返回的值是一个 XML 实例，此实例可以使用 ECMAScript for XML (E4X) 表达式访问。	HTTPService
		RESULT_FORMAT_FLASHVARS : String = "flashvars" [静态] 结果格式“flashvars”指定返回的值是包含由 & 符号分隔的名称=值对的文本，该文本被分析为 ActionScript 对象。	HTTPService
		RESULT_FORMAT_OBJECT : String = "object" [静态] 结果格式“object”指定返回的值是 XML，但按照 ActionScript 对象树分析。	HTTPService
		RESULT_FORMAT_TEXT : String = "text" [静态] 结果格式“text”指定 HTTPService 结果文本应为未经处理的字符串。	HTTPService
		RESULT_FORMAT_XML : String = "xml" [静态] 结果格式“xml”指定结果应作为指向父 flash.xml.XMLDocument 的第一个子项的 flash.xml.XMLNode 实例返回。	HTTPService

属性详细信息

concurrency

属性

concurrency:String [读写]

指示如何处理对同一服务的多个调用的值。默认值为 multiple。允许使用的值包括：

multiple 不取消现有请求，开发人员通过谨慎管理事件流来负责确保返回数据的一致性。这是默认值。
single 一次操作仅允许执行一个请求；多个请求会生成错误。
last 发出请求会取消所有现有请求。

实现
public function get concurrency():String
public function set concurrency(value:String):void

showBusyCursor

属性

showBusyCursor:Boolean [读写]

如果为 true，在执行服务时会显示忙碌光标。默认值为 false。

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

构造函数详细信息

HTTPService

()

构造函数

public function HTTPService(rootURL:String = null, destination:String = null)

创建一个新的 HTTPService。此构造函数通常由 MXML 文档生成的代码调用。通常使用 mx.rpc.http.HTTPService 类在 ActionScript 中创建 HTTPService。

参数

	`rootURL:String` (default = `null`) — HTTPService 在计算相对 URL 时应使用的 URL。

	`destination:String` (default = `null`) — service-config.xml 文件中的 HTTPService 目标名称。

方法详细信息

initialized

()

方法

public function initialized(document:Object, id:String):void

创建实现对象且初始化在 MXML 标签上指定的所有组件属性后调用。如果在 ActionScript 中创建此类并希望在其执行时使用验证，则必须调用此方法并传入 MXML 文档和 HTTPService 的 id。

参数

	`document:Object` — 创建此对象的 MXML 文档。

	`id:String` — `document` 用来引用此对象的标识符。如果此对象是文档上的深层属性，则 `id` 为 null。

send

()

方法

override public function send(parameters:Object = null):AsyncToken

执行 HTTPService 请求。参数是可选的；但如果指定参数，所指定的值应该是包含名称/值对的 Object 或 XML 对象（取决于 contentType）。

参数

parameters:Object (default = null)

AsyncToken — AsyncToken。该对象与 result 或 fault 事件的 token 属性中的对象相同。

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