mx.rpc.soap.mxml.WebService (Flex 3.2)

包	mx.rpc.soap.mxml
类	public dynamic class WebService
继承	WebService WebService AbstractWebService AbstractService Proxy Object
实现	IMXMLSupport, IMXMLObject

<mx:WebService> 标签使您可以访问与 SOAP 兼容的 Web 服务的操作。

MXML 语法

隐藏 MXML 语法

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

 <mx:WebService
   Properties
   concurrency="multiple|single|last"
   destination="No default."
   id="No default."
   serviceName="No default."
   showBusyCursor="false|true"
   makeObjectsBindable="false|true"
   useProxy="false|true"
   wsdl="No default."
    Events
   fault="No default."
   result="No default."
 />

An <mx:WebService> tag can have multiple <mx:operation> tags, which have the following tag attributes:

 <mx:operation
   Properties
   concurrency="multiple|single|last"
   name=No default, required.
   resultFormat="object|xml|e4x"
   makeObjectsBindable="false|true"
    
   Events
   fault=No default.
   result=No default.
 />

An <mx:Operation> tag contains an <mx:request> tag. To specify an XML structure in an <mx:request> tag, you must set the value of the tag's format attribute to "xml". Otherwise, the body is converted into Objects.

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		定义方
		channelSet : ChannelSet 提供对服务使用的 ChannelSet 的访问。	AbstractService
		concurrency : String 指示如何处理对同一服务的多个调用的值。	WebService
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		description : String 当前活动端口的服务描述。	AbstractWebService
		destination : String 服务的目标。	AbstractWebService
		endpointURI : String WebService 的位置。	AbstractWebService
		headers : Array [只读 (read-only)] 返回为 WebService 注册的 SOAPHeaders 数组。	AbstractWebService
		httpHeaders : Object 发送到 SOAP 端点的自定义 HTTP 标头。	AbstractWebService
		makeObjectsBindable : Boolean 当该置为 true 时，返回的匿名对象将强制成为可绑定的对象。	AbstractWebService
		operations : Object 如果使用 MXML 标签创建服务，则操作数组通常仅由 MXML 编译器设置。	AbstractService
		port : String 指定此 WebService 应使用的 WSDL 文档中的端口.	AbstractWebService
		protocol : String [只写] 不适合使用，请改用相应目标；或者如果使用 url，请使用 DefaultHTTP 或 DefaultHTTPS。	WebService
		prototype : Object [静态] 对类或函数对象的原型对象的引用。	Object
		ready : Boolean [只读 (read-only)] 指定 WebService 是否准备好发送请求。	AbstractWebService
		requestTimeout : int 提供对已发送消息的请求超时（以秒为单位）的访问。	AbstractService
		rootURL : String WebService 在计算相对 URL 时应使用的 URL。	AbstractWebService
		service : String 指定此 WebService 应使用的 WSDL 文档中的服务。	AbstractWebService
		serviceName : String	WebService
		showBusyCursor : Boolean 如果为 true，在执行服务时会显示忙碌光标。	WebService
		useProxy : Boolean 指定是否使用 Flex 代理服务。	AbstractWebService
		wsdl : String 此 WebService 的 WSDL 文档的位置。	WebService
		xmlSpecialCharsFilter : Function 用于在对任何简单内容编码之前转义 XML 特殊字符的自定义函数。	AbstractWebService

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		定义方
		WebService(destination:String = null) 创建一个新的 WebService 组件。	WebService
		addHeader(header:Object):void 添加将应用于此 Web 服务所有操作的标头。	AbstractWebService
		addSimpleHeader(qnameLocal:String, qnameNamespace:String, headerName:String, headerValue:String):void 添加将应用于此 WebService 所有操作的标头。	AbstractWebService
		canLoadWSDL():Boolean 返回一个布尔值，指示 WebService 是否准备好加载 WSDL（是否指定了有效的目标或 wsdl）。	WebService
		clearHeaders():void 清除应用于所有操作的标头。	AbstractWebService
		disconnect():void 断开此服务的网络连接并删除任何未处理的请求 responder。	AbstractService
		getHeader(qname:QName, headerName:String = null):SOAPHeader 如果根据 QName、localName 和 URI 找到匹配项，则返回标头。	AbstractWebService
		getOperation(name:String):AbstractOperation 返回给定名称的操作。	WebService
		hasOwnProperty(name:String):Boolean 指示对象是否已经定义了指定的属性。	Object
		initialized(document:Object, id:String):void 如果使用标签设置 WebService，则由 MXML 编译器自动调用。	WebService
		isPrototypeOf(theClass:Object):Boolean 指示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		loadWSDL(uri:String = null):void 指示 WebService 下载 WSDL 文档。	WebService
		logout():void 将用户从目标中注销。	AbstractService
		propertyIsEnumerable(name:String):Boolean 指示指定的属性是否存在、是否可枚举。	Object
		removeHeader(qname:QName, headerName:String = null):void 从所有操作中删除具有给定 QName 的标头。	AbstractWebService
		setCredentials(username:String, password:String, charset:String = null):void 当在服务器端使用 Data Services 时，为服务访问的目标设置凭据。	AbstractService
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void 在访问 webservice 时对用户进行身份验证的用户名和密码。	AbstractWebService
		toString():String 将 WebService 的实例表示为字符串，描述如目标 id 和所分配的通道集等重要属性。	WebService
		valueOf():Object 返回指定对象的原始值。	Object

	方法	定义方
		initializeOperation(operation:Operation):void 初始化一个新的 Operation。	WebService

摘要	定义方
fault	当服务调用失败并且操作自身不处理时，将调度 fault 事件。	AbstractService
invoke	当调用服务操作时，只要在通道尝试发送消息前没有引发错误，将调度 invoke 事件。	AbstractService
load	当已成功加载 WSDL 文档时调度 LoadEvent.LOAD。	WebService
result	当服务调用成功返回并且操作自身不处理时，将调度 result 事件。	AbstractService

	常量	定义方
		DEFAULT_DESTINATION_HTTP : String = "DefaultHTTP" [静态]	WebService
		DEFAULT_DESTINATION_HTTPS : String = "DefaultHTTPS" [静态]	WebService

属性详细信息

concurrency

属性

concurrency:String [读写]

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

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

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

protocol

属性

protocol:String [只写]

不推荐使用: 属性协议不再适合使用。请使用服务配置文件中的适当通道（如 DefaultHTTP 或 DefaultHTTPS）；当 useProxy 为 false 时，设置 URL 以使用正确的协议。

不适合使用，请改用相应目标；或者如果使用 url，请使用 DefaultHTTP 或 DefaultHTTPS。如果使用默认，则该不适合使用的行为将仅更新目标。

实现
public function set protocol(value:String):void

serviceName

属性

serviceName:String [读写]

不推荐使用: 请使用 destination

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

showBusyCursor

属性

showBusyCursor:Boolean [读写]

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

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

构造函数详细信息

WebService

()

构造函数

public function WebService(destination:String = null)

创建一个新的 WebService 组件。

参数

destination:String (default = null) — WebService 的目标，应与 services-config.xml 文件中的目标名称匹配。如果未指定，则 WebService 组件使用 DefaultHTTP 目标。

方法详细信息

getOperation

()

方法

override public function getOperation(name:String):AbstractOperation

返回给定名称的操作。如果之前没有创建该操作，则将在此调用过程中创建一个新的 mx.rpc.soap.mxml.Operation。通常只需在服务变量之后命名操作即可访问操作 (myService.someOperation)，但如果 Operation 的名称恰好与服务上所定义的方法（如 setCredentials）相匹配，则可以改用此方法来获取 Operation。

参数

name:String — 操作的名称。

AbstractOperation — 为此名称执行的操作。

initialized

()

方法

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

如果使用标签设置 WebService，则由 MXML 编译器自动调用。如果通过 ActionScript 创建 WebService，则可能希望自行调用此方法（因为它对验证任何参数都非常有用）。

参数

	`document:Object` — 此 WebService 所在的 MXML 文档

	`id:String` — 此 WebService 在文档中的 ID

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