Operation

包	mx.rpc.http
类	public class Operation
继承	Operation AbstractOperation AbstractOperation AbstractInvoker EventDispatcher Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

专供 HTTPMultiService 使用的 Operation。Operation 是指对服务执行的单个操作，通常与服务器端的单个操作对应。可以通过调用服务的同名函数或通过访问作为服务属性的 Operation 并调用 send(param1, param2) 方法来调用 Operation。HTTP 服务还支持 sendBody 方法，该方法使您可以直接指定 HTTP 响应的主体。如果您使用 send(param1, param2) 方法，则通常通过将操作的 argumentNames 属性与发送的参数相结合来形成该主体。这会创建一个将 argumentNames[i] 用作键，将对应的参数用作值的对象。

将 HTTP 操作自变量放入 HTTP 主体内的确切方式由使用的 serializationFilter 决定。

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		argumentNames : Array 要传递给方法调用的参数名称的有序列表。	AbstractOperation
		arguments : Object 当操作被调用时传递到此操作的参数。	AbstractOperation
		concurrency : String [覆盖] 指示如何处理对同一服务操作的多个调用的值。	Operation
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		contentType : String [覆盖] 服务请求的内容类型。	Operation
		headers : Object 发送到第三方端点的自定义 HTTP 标头。	AbstractOperation
		lastResult : Object [只读] 上次调用的结果。	AbstractInvoker
		makeObjectsBindable : Boolean [覆盖] 当该置为 true 时，返回的匿名对象将强制成为可绑定的对象。	Operation
		method : String [覆盖] 发送请求的 HTTP 方法。	Operation
		name : String 此操作的名称。	AbstractOperation
		operationManager : Function 此属性通常由框架代码设置，框架代码需要修改服务调用的行为，而不修改外部调用服务的方式。	AbstractInvoker
		properties : Object 这是一个挂钩，主要供框架开发人员用来为您的操作注册用户指定的其它属性。	AbstractOperation
		request : Object 用作 URL 参数的名称/值对的对象。	AbstractOperation
		requestTimeout : int 提供对已发送消息的请求超时（以秒为单位）的访问。	AbstractOperation
		resultElementType : Class 与 resultType 类似，用于定义由给定操作使用的 ActionScript 类，但是此属性只适用于返回多值结果（例如，Array 或 ArrayCollection (IList)）的操作。	AbstractInvoker
		resultFormat : String [覆盖] 指示如何反序列化由 HTTP 调用返回的结果的值。	Operation
		resultType : Class 指定操作的可选返回类型。	AbstractInvoker
		rootURL : String [覆盖] rootURL 用于在为 HTTP 服务操作指定了相对 URL 时计算该操作的 URL。	Operation
		serializationFilter : SerializationFilter SerializationFilter 可以控制对自变量进行格式设置的方式，以形成 HTTP 请求的内容。	AbstractOperation
		service : AbstractService [只读] 提供对在其上调用此操作的服务的方便访问。	AbstractOperation
		showBusyCursor : Boolean [覆盖] 如果为 true，在执行服务时会显示忙状态光标。	Operation
		url : String 服务的位置。	AbstractOperation
		useProxy : Boolean [覆盖] 指定是否使用 Flex 代理服务。	Operation
		xmlDecode : Function ActionScript 函数，用于解码 XML 格式的服务结果。	AbstractOperation
		xmlEncode : Function ActionScript 函数，用于将服务请求按 XML 编码。	AbstractOperation

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		Operation(service:mx.rpc.http:HTTPMultiService = null, name:String = null) 创建一个新的 Operation。	Operation
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		cancel(id:String = null):mx.rpc:AsyncToken 取消上次服务调用或具有指定 ID 的调用。	AbstractInvoker
		clearResult(fireBindingEvent:Boolean = true):void 将 invoker 的 result 属性设置为 null。	AbstractInvoker
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		send(... args):mx.rpc:AsyncToken [覆盖] 执行 HTTP 操作。	Operation
		sendBody(parameters:Object):mx.rpc:AsyncToken	AbstractOperation
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		setResult(result:Object):void 公开此挂钩可以更新 lastResult 属性。	AbstractInvoker
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	EventDispatcher

受保护的方法

隐藏继承的受保护方法

显示继承的受保护方法

	方法		由以下参数定义
		getHeaders():Object 返回 HTTP 请求头。	AbstractOperation
		getSerializationFilter():SerializationFilter 返回序列化过滤器。	AbstractOperation

事件

单击此处了解有关事件的更多信息

隐藏继承的事件

显示继承的事件

	摘要	由以下参数定义
activate	[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。	EventDispatcher
deactivate	[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。	EventDispatcher
fault	当操作调用失败时调度。	AbstractOperation
result	当操作调用成功返回时调度。	AbstractOperation

属性详细信息

concurrency

属性

concurrency:String[覆盖]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

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

contentType

属性

contentType:String[覆盖]

服务请求的内容类型。默认值为 application/x-www-form-urlencoded（同带有名称/值对的常规 HTTP POST 使用相同方式发送请求）。application/xml 将请求按 XML 发送。

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

makeObjectsBindable

属性

makeObjectsBindable:Boolean[覆盖]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

当该置为 true 时，返回的匿名对象将强制成为可绑定的对象。

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

method

属性

method:String[覆盖]

发送请求的 HTTP 方法。允许的值有 GET、POST、HEAD、OPTIONS、PUT、TRACE 和 DELETE。将小写字母转换为大写字母。默认值为 GET。

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

resultFormat

属性

resultFormat:String[覆盖]

指示如何反序列化由 HTTP 调用返回的结果的值。该项目的值根据以下条件确定：

返回的是 XML 还是名称/值对。
访问结果的方式；可以将结果作为 object、text 或 XML 进行访问。

默认值为 object。允许使用的值包括：

object 返回的值为 XML 并且按照 ActionScript 对象树分析。此为默认。
array 返回的值是 XML 并且按照 ActionScript 对象树分析。但是，如果顶级对象不是数组，将创建一个新数组并且将结果设置为第一个项目。如果 makeObjectsBindable 为 true，则该数组将被包装在 ArrayCollection 中。
xml 返回的值为 XML 并且作为 ActionScript XMLnode 对象中的文本 XML 返回。
flashvars 返回的值是包含由 & 符号分隔的名称=值对的文本，该文本被分析为 ActionScript 对象。
text 返回的值为文本并且未经处理。
e4x 返回的值为 XML 并且作为 ActionScript XML 对象中的文本 XML 返回，可以使用 ECMAScript for XML (E4X) 表达式进行访问。

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

rootURL

属性

rootURL:String[覆盖]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

rootURL 用于在为 HTTP 服务操作指定了相对 URL 时计算该操作的 URL。rootURL 的目录名称被置于操作的任何相对 URL 的前面。通常情况下，设置 baseURL 变得更方便，因为 baseURL 直接指定目录名称，而 rootURL 指定其目录名称被前置的文件的名称。如果 rootURL 和 baseURL 都未显式设置，则将 .swf 文件的目录名称置于相对路径的前面。

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

showBusyCursor

属性

showBusyCursor:Boolean[覆盖]

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

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

useProxy

属性

useProxy:Boolean[覆盖]

指定是否使用 Flex 代理服务。默认值为 false。如果没有对通过 Flex 服务器的代理请求指定 true，则必须确保播放器可以到达目标 URL。如果 useProxy 属性设置为 false，则也不可以使用 services-config.xml 文件中定义的目标。

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

构造函数详细信息

()

构造函数

public function Operation(service:mx.rpc.http:HTTPMultiService = null, name:String = null)

语言版本:

ActionScript 3.0

产品版本:

Flex 3 Creates a new Operation.

运行时版本:

Flash Player 9, AIR 1.1

创建一个新的 Operation。

参数

	`service:mx.rpc.http:HTTPMultiService` (default = `null`) — 定义服务的 HTTPMultiService 对象。

	`name:String` (default = `null`) — 服务的名称。

方法详细信息

send

()

方法

override public function send(... args):mx.rpc:AsyncToken

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

执行 HTTP 操作。传入的任何自变量都将作为操作调用的一部分传递。如果没有传递任何自变量，则类的自变量属性将用作参数源。HTTP 操作通常采用命名参数，而不采用位置参数。要提供这些参数的名称，还可以将 argumentNames 属性设置为一个属性名称数组。

参数

... args — 作为方法调用的一部分传入的可选参数。如果没有传递的参数，则参数对象将用作参数源。

mx.rpc:AsyncToken — 使用异步完成标记模式的 AsyncToken 调用。token 属性的 result 和 fault 事件中具有相同的对象。

法律声明 | 在线隐私策略

Operation - AS3 Flex

类 x

concurrency

contentType

makeObjectsBindable

method

resultFormat

rootURL

showBusyCursor

useProxy

Operation

send