mx.rpc.soapOperation 专门由 WebServices 使用的 Operation。mx.rpc:AbstractOperation 专门由 WebServices 使用的 Operation。Operation 是服务上的单个方法。可以通过在服务上调用同名函数或在服务上访问作为属性的 Operation 并调用 send() 方法来调用 Operation。 header 当 Operation 调用返回响应结果中的 SOAP 标头时分派。mx.rpc.events.HeaderEvent.HEADERmx.rpc.events.HeaderEvent 当 Operation 调用返回响应结果中的 SOAP 标头时分派。为每个 SOAP 标头调用 HeaderEvent。 Operation 创建一个新的 Operation。webServicemx.rpc:AbstractServicenull对其调用此 Operation 的 Web 服务。 namenull此操作的名称。 创建一个新的 Operation。当访问未知操作时,该操作通常直接由 MXML 编译器完成或由 WebService 自动完成。建议开发人员不要直接使用此构造函数。 addHeader 添加仅应用于此 Operation 的标头。header要添加到此 Operation 的 SOAP 标头。 添加仅应用于此 Operation 的标头。标头可以以预编码形式提供,可以作为 XML 实例,也可以作为 SOAPHeader 实例(将编码留给内部 SOAP 编码器处理)。 addSimpleHeader 添加仅应用于此 Operation 的标头。qnameLocal标头 QName 的 localname qnameNamespace标头 QName 的命名空间 headerName标头的名称。 headerValue标头的值。 添加仅应用于此 Operation 的标头。 cancel 取消上次服务调用或具有指定 ID 的调用。与被取消的调用关联的 AsyncToken,如果未取消任何调用,则为 null。 mx.rpc:AsyncTokenidnull要取消的调用的 messageId。可选。如果省略,将取消上一次服务调用。 取消上次服务调用或具有指定 ID 的调用。即使网络操作可能仍在继续,也不分派 result 或 fault 事件。 clearHeaders 清除此单个 Operation 的标头。 清除此单个 Operation 的标头。 getHeader 如果根据 QName localName 和 URI 找到匹配标头,则返回该标头。返回 SOAPHeader。 mx.rpc.soap:SOAPHeaderqnameSOAPHeader 的 QName。 headerNamenullSOAPHeader 内容中的标头名称(可选) 如果根据 QName localName 和 URI 找到匹配标头,则返回该标头。 removeHeader 从所有操作中删除具有给定 QName 的标头。qnameSOAPHeader 的 QName。 headerNamenullSOAPHeader 内容中的标头名称(可选) 从所有操作中删除具有给定 QName 的标头。 endpointURI 此 Operation 的 WebService 位置。 此 Operation 的 WebService 位置。通常,WSDL 指定服务的位置,但可设置此属性来覆盖该单个 Operation 的位置。 forcePartArrays 确定定义为数组的输出消息部分的单个返回值或空返回值是否应作为包含一个或零个元素的数组返回。 确定定义为数组的输出消息部分的单个返回值或空返回值是否应作为包含一个或零个元素的数组返回。这适用于文档/文本“wrapped”Web 服务,在采用此方式的服务中,表示“wrapper”序列中各消息部分的一个或多个元素可将 maxOccurs 属性设置为大于 1 的值。这表示:即使响应包含该部分的零个或一个值,相应部分也应被视为一个数组。将 forcePartArrays 设置为 true 将始终为以此方式定义的各部分创建数组,无论返回的值数是多少都是如此。如果将 forcePartArrays 保留为 false,则仅在返回两个或多个元素时才创建数组。 headerFormat 确定如何解码 SOAP 编码的标头。 确定如何解码 SOAP 编码的标头。值 object 指定将每个标头 XML 节点解码为一个 SOAPHeader 对象,并且其 content 属性采用在 WSDL 文档中指定的对象结构。值 xml 指定 XML 将保留为 XMLNodes。值 e4x 指定将可使用 ECMAScript for XML (E4X) 表达式访问该 XML。 headers 要在每次调用操作时发送的 SOAPHeaders 数组的存取器。 要在每次调用操作时发送的 SOAPHeaders 数组的存取器。 httpHeaders 发送到 SOAP 端点的自定义 HTTP 标头。 发送到 SOAP 端点的自定义 HTTP 标头。如果需要以相同名称发送多个标头,应将值指定为一个数组。 ignoreWhitespace 确定为 SOAP 编码的请求或响应处理 XML 时是否忽略空格。 确定为 SOAP 编码的请求或响应处理 XML 时是否忽略空格。默认值为 true,即不保留空格。如果 XML Schema 类型定义指定将 whiteSpace 限制设置为 preserve,则必须先将 ignoreWhitespace 设置为 false。相反,如果将 whiteSpace 类型限制设置为 replacecollapse,则即使 ignoreWhitespace 设置为 false 也保留该设置。 makeObjectsBindable 当该置为 true 时,返回的匿名对象将强制成为可绑定的对象。 当该置为 true 时,返回的匿名对象将强制成为可绑定的对象。 multiplePartsFormat 确定调用在输出消息中定义多个部分的 Web 服务的默认结果对象的类型。 确定调用在输出消息中定义多个部分的 Web 服务的默认结果对象的类型。值“object”指定 lastResult 对象将是具有与各输出部分对应命名属性的 Object。值“array”将使 lastResult 成为一个数组,各部分值按照在 SOAP 消息体中出现的顺序进入数组。文档文本操作的默认值为“object”。RPC 操作的默认值为“array”。仅当 resultFormat 为“object”时 multiplePartsFormat 属性才可用,否则将忽略。 request 该 Operation 的请求是对象结构或 XML 结构。 该 Operation 的请求是对象结构或 XML 结构。如果指定 XML,则 XML 按原样发送。如果传递一个对象,则该对象将被编码为 SOAP XML 结构。 resultFormat 确定如何解码 Operation 结果。 确定如何解码 Operation 结果。值 object 指定将 XML 解码为 WSDL 文档中所指定的对象结构。值 xml 指定 XML 将保留为 XMLNodes。值 e4x 指定将可使用 ECMAScript for XML (E4X) 表达式访问该 XML。 resultHeaders 上次执行此操作过程中返回的标头。 上次执行此操作过程中返回的标头。它们与 lastResult 属性相匹配并且与作为 HeaderEvents 单独分派的标头集合相同。 xmlSpecialCharsFilter 指定用于在对任何简单内容编码之前转义 XML 特殊字符的自定义函数。 指定用于在对任何简单内容编码之前转义 XML 特殊字符的自定义函数。除非专门在操作级上进行了覆盖,否则对 Web 服务上的所有操作有效。如果未提供函数,则默认为由 IXMLEncoder 的特定实现设置的相应内容。 AbstractWebService AbstractWebService 是提供对基于 SOAP 的 Web 服务的 RPC 访问的实现的抽象基类。mx.rpc:AbstractService AbstractWebService 是提供对基于 SOAP 的 Web 服务的 RPC 访问的实现的抽象基类。此类在运行时不加载 WSDL 说明。 AbstractWebService 创建一个新的 WebService。destinationnull目标。该值应与 services-config.xml 文件中的目标名称匹配。 rootURLnullWebService 在计算相对 URL 时应使用的 URL。 创建一个新的 WebService。目标(如果已指定)应与 services-config.xml 中的条目匹配。如果未指定,WebService 使用 DefaultHTTP 目标。如果打算使用相对 URL 查找此 WebService 的 WSDL 文档,则 rootURL 是必需的。 addHeader 添加将应用于此 Web 服务所有操作的标头。header要添加到所有操作的 SOAP 标头。 添加将应用于此 Web 服务所有操作的标头。标头可以以预编码形式提供,可以作为 XML 实例,也可以作为 SOAPHeader 实例(将编码留给内部 SOAP 编码器处理)。 addSimpleHeader 添加将应用于此 WebService 所有操作的标头。qnameLocal标头 QName 的 localname。 qnameNamespace标头 QName 的命名空间。 headerName标头的名称。 headerValue标头的值。 添加将应用于此 WebService 所有操作的标头。 clearHeaders 清除应用于所有操作的标头。 清除应用于所有操作的标头。 getHeader 如果根据 QName、localName 和 URI 找到匹配项,则返回标头。如果根据 QName、localName 和 URI 找到匹配项,则返回标头。 mx.rpc.soap:SOAPHeaderqnameSOAPHeader 的 QName。 headerNamenull(可选)SOAPHeader 内容中标头的名称。 如果根据 QName、localName 和 URI 找到匹配项,则返回标头。 removeHeader 从所有操作中删除具有给定 QName 的标头。qnameSOAPHeader 的 QName。 headerNamenull(可选)SOAPHeader 内容中标头的名称。 从所有操作中删除具有给定 QName 的标头。 setRemoteCredentials 在访问 webservice 时对用户进行身份验证的用户名和密码。remoteUsername要传递给远程端点的用户名。 remotePassword要传递给远程端点的密码。 charsetnull对远程凭据进行编码时使用的字符集编码。默认值为 null,表示旧字符集 ISO-Latin-1。其它受支持的字符集仅有“UTF-8”。 在访问 webservice 时对用户进行身份验证的用户名和密码。这些将作为 HTTP 身份验证标头的一部分从代理传递到端点。如果 useProxy 为 false,将忽略此属性。 DEFAULT_DESTINATION_HTTPS 通过代理调用 WebService 时,对 HTTPS 连接要使用的默认目标。DefaultHTTPS 通过代理调用 WebService 时,对 HTTPS 连接要使用的默认目标。如果不提供目标,并将 useProxy 属性设置为 true,则将使用默认目标将请求路由至 WebSerive 端点。

注意,如果使用默认目标,则必须在客户端上指定 WSDL 和 endpointURI。如果使用非默认的代理目标,则可以在目标配置中指定 WSDL 和 endpointURI。

DEFAULT_DESTINATION_HTTP 通过代理调用 WebService 时,对 HTTP 连接要使用的默认目标。DefaultHTTP 通过代理调用 WebService 时,对 HTTP 连接要使用的默认目标。如果不提供目标,并将 useProxy 属性设置为 true,则将使用默认目标将请求路由至 WebSerive 端点。

注意,如果使用默认目标,则必须在客户端上指定 WSDL 和 endpointURI。如果使用非默认的代理目标,则可以在目标配置中指定 WSDL 和 endpointURI。

convertParametersHandler 一个可选函数,主要供具有以下需要的框架开发人员使用:安装用传递给每个 webservice 操作调用的参数进行调用的函数。 一个可选函数,主要供具有以下需要的框架开发人员使用:安装用传递给每个 webservice 操作调用的参数进行调用的函数。该函数接受一个参数数组,并返回可能改变的数组。该函数定义应该如下所示: function myParametersFunction(parameters:Array):Array convertResultHandler 一个可选函数,主要供具有以下需要的框架开发人员使用:安装一个挂钩,以便在通知结果处理程序之前处理操作的结果。 一个可选函数,主要供具有以下需要的框架开发人员使用:安装一个挂钩,以便在通知结果处理程序之前处理操作的结果。该函数定义应该如下所示: function myConvertResultsFunction(result: operation:AbstractOperation): 在 makeObjectsBindable 转换完成之后、创建结果事件之前向其传递结果。 description 当前活动端口的服务描述。 当前活动端口的服务描述。 destination 服务的目标。 服务的目标。该值应与 services-config.xml 文件中的目标条目匹配。 endpointURI WebService 的位置。 WebService 的位置。通常,WSDL 文档指定服务的位置,但可设置此属性来覆盖该位置。 headers 返回为 WebService 注册的 SOAPHeaders 数组。 返回为 WebService 注册的 SOAPHeaders 数组。 httpHeaders 发送到 SOAP 端点的自定义 HTTP 标头。 发送到 SOAP 端点的自定义 HTTP 标头。如果需要以相同名称发送多个标头,应将值指定为一个数组。 makeObjectsBindable 当该置为 true 时,返回的匿名对象将强制成为可绑定的对象。 当该置为 true 时,返回的匿名对象将强制成为可绑定的对象。 port 指定此 WebService 应使用的 WSDL 文档中的端口。 指定此 WebService 应使用的 WSDL 文档中的端口。 ready 指定 WebService 是否准备好发送请求。 指定 WebService 是否准备好发送请求。 rootURL WebService 在计算相对 URL 时应使用的 URL。 WebService 在计算相对 URL 时应使用的 URL。此属性仅在使用代理时使用。当 useProxy 属性设置为 to false 时,将根据运行此应用程序的 SWF 的位置自动计算相对 URL。如果未明确设置,将把 rootURL 自动设置为 mx.messaging.config.LoaderConfig.url 的 URL。 service 指定此 WebService 应使用的 WSDL 文档中的服务。 指定此 WebService 应使用的 WSDL 文档中的服务。 useProxy 指定是否使用 Flex 代理服务。false 指定是否使用 Flex 代理服务。默认值为 false。如果没有对通过 Flex 服务器的代理请求指定 true,则必须确保 Flash Player 可以到达目标 URL。如果 useProxy 属性设置为 false,则也不可以使用 services-config.xml 文件中定义的目标。 xmlSpecialCharsFilter 用于在对任何简单内容编码之前转义 XML 特殊字符的自定义函数。 用于在对任何简单内容编码之前转义 XML 特殊字符的自定义函数。除非专门在操作级上进行了覆盖,否则对 Web 服务上的所有操作有效。如果未提供函数,则默认函数为由 IXMLEncoder 的特定实现设置的相应内容。
SOAPFault mx.rpc.Fault 的子类,提供 SOAP 封套 Fault 元素中的 SOAP 特定信息。mx.rpc:Fault mx.rpc.Fault 的子类,提供 SOAP 封套 Fault 元素中的 SOAP 特定信息。 SOAPFault 构造一个新的 SOAPFault。faultCode错误代码的完全限定名称。 faultString错误的说明。 detailnull错误的任何其它详细信息。 elementnullSOAP 错误的原始 XML。 faultactornull有关 SOAP 错误来源的信息。 构造一个新的 SOAPFault。 toString 返回 String“SOAPFault”以及 faultCode、faultString 和 faultDetail。返回 String“SOAPFault”以及 faultCode、faultString 和 faultDetail。 返回 String“SOAPFault”以及 faultCode、faultString 和 faultDetail。 element 此 SOAP Fault 的原始 XML。 此 SOAP Fault 的原始 XML。 faultactor SOAP Fault 可通过 faultactor 属性提供关于导致该错误的源的信息。 SOAP Fault 可通过 faultactor 属性提供关于导致该错误的源的信息。 faultcode faultcode 属性与 faultCode 类似,其存在是为了既与 SOAP Fault 中的 faultcode 元素的大小写相匹配又可以提供代码的完全限定名称。 faultcode 属性与 faultCode 类似,其存在是为了既与 SOAP Fault 中的 faultcode 元素的大小写相匹配又可以提供代码的完全限定名称。 mx.rpc.Fault.faultDetaildetail detail 属性与 faultDetail 相同,其存在是为了与 SOAP Fault 中的 detail 元素的大小写相匹配。 detail 属性与 faultDetail 相同,其存在是为了与 SOAP Fault 中的 detail 元素的大小写相匹配。 mx.rpc.Fault.faultDetailfaultstring faultstring 属性与 faultString 相同,其存在是为了与 SOAP 封套 Fault 中的 faultstring 元素的大小写相匹配。 faultstring 属性与 faultString 相同,其存在是为了与 SOAP 封套 Fault 中的 faultstring 元素的大小写相匹配。 mx.rpc.Fault.faultStringWebService WebService 类提供对远程服务器上基于 SOAP 的 Web 服务的访问。mx.rpc.soap:AbstractWebService WebService 类提供对远程服务器上基于 SOAP 的 Web 服务的访问。 load 当已成功加载 WSDL 文档时分派 LoadEvent.LOAD。mx.rpc.soap.LoadEvent.LOADmx.rpc.soap.LoadEvent 当已成功加载 WSDL 文档时分派 LoadEvent.LOADWebService 创建一个新的 WebService。destinationnullWebService 的目标,应与 services-config.xml 文件中的目标名称匹配。 rootURLnullWebService 的根 URL。 创建一个新的 WebService。目标(如果已指定)应与 services-config.xml 中的条目匹配。如果未指定,WebService 使用 DefaultHTTP 目标。如果打算使用相对 URL 查找此 WebService 的 WSDL 文档,则 rootURL 是必不可少的。 canLoadWSDL 返回一个布尔值,指示 WebService 是否准备好加载 WSDL(是否指定了有效的目标或 wsdl)。如果 WebService 准备好加载 WSDL,则返回 true,否则返回 false 返回一个布尔值,指示 WebService 是否准备好加载 WSDL(是否指定了有效的目标或 wsdl)。 getOperation 返回给定名称的操作。为此名称执行的操作。 mx.rpc:AbstractOperationname操作的名称。 返回给定名称的操作。如果之前没有创建该操作,则将在此调用过程中创建一个新的 mx.rpc.soap.Operation。通常只需在服务变量之后命名操作即可访问操作 (myService.someOperation),但如果 Operation 的名称恰好与服务上所定义的方法(如 setCredentials)相匹配,则可以改用此方法来获取 Operation。 initializeOperation 初始化一个新的 Operation。operationmx.rpc.soap:Operation要初始化的 Operation。 初始化一个新的 Operation。 loadWSDL 指示 WebService 下载 WSDL 文档。urinull如果之前没有指定 wsdl,可以在此指定。 指示 WebService 下载 WSDL 文档。当在 WebService MXML 标签中指定时,WebService 自动调用此方法;但是如果在指定 destinationwsdl 属性值后在 ActionScript 中创建 WebService 对象,则必须手动调用此方法。 toString 将 WebService 的实例表示为字符串,描述如目标 id 和所分配的通道集等重要属性。返回 WebService 的字符串表示形式。 将 WebService 的实例表示为字符串,描述如目标 id 和所分配的通道集等重要属性。 DEFAULT_DESTINATION_HTTPSDefaultHTTPSDEFAULT_DESTINATION_HTTPDefaultHTTPwsdl 此 WebService 的 WSDL 文档的位置。 此 WebService 的 WSDL 文档的位置。如果使用相对 URL,请确保已指定 rootURL 或者是在 MXML 中创建的 WebService。 LoadEvent 当已成功加载 WSDL XML 文档时分派此事件。mx.rpc.events:WSDLLoadEvent 当已成功加载 WSDL XML 文档时分派此事件。 loadmx.rpc.soap:LoadEvent:LOADmx.rpc.soap:LoadEventLoadEvent 创建一个新的 WSDLLoadEvent。type事件类型;指示触发事件的动作。 bubblesfalse指定该事件是否可以在显示列表层次结构得到冒泡处理。 cancelabletrue指定是否可以防止与事件相关联的行为。 wsdlnull包含 WSDL 文档的对象。 locationnullWSDL 文档的 URL。 创建一个新的 WSDLLoadEvent。 clone 返回此 LoadEvent 的副本。返回此 LoadEvent 的副本。 返回此 LoadEvent 的副本。 toString 返回此 LoadEvent 的字符串表示形式。返回此 LoadEvent 的字符串表示形式。 返回此 LoadEvent 的字符串表示形式。 LOAD LOAD 常量为 load 事件定义事件对象的 type 属性的值。load LOAD 常量为 load 事件定义事件对象的 type 属性的值。

事件对象的属性有下列值:

属性bubblesfalsecancelabletruewsdlWSDL 对象。locationWSDL 文档的 URI
document 保留此 getter,对作为 flash.xml.XMLDocument 的实例加载的文档提供原有的访问方式。 保留此 getter,对作为 flash.xml.XMLDocument 的实例加载的文档提供原有的访问方式。
SOAPResult 基于 SOAP 的远程过程调用的结果的上下文。Object 基于 SOAP 的远程过程调用的结果的上下文。 SOAPResult 创建一个新的 SOAPResult。 创建一个新的 SOAPResult。 headers 标头对象的集合。 标头对象的集合。SOAPDecoder 可以根据解码器的 headerFormat 设置,使用 SOAPHeader、XML 或 XMLDocument 类型的元素填充此数组。 isFault 用于指明此结果对象是否表示 SOAP Fault 消息的标志。 用于指明此结果对象是否表示 SOAP Fault 消息的标志。 result SOAP 结果的主体。 SOAP 结果的主体。SOAPDecoder 可以根据解码器的 resultFormat 设置填充该值。 SOAPHeader 使用 SOAPHeader 指定需要添加到 WebService Operation 请求的 SOAP 封套的标头。Object 使用 SOAPHeader 指定需要添加到 WebService Operation 请求的 SOAP 封套的标头。 SOAPHeader 构造一个新的 SOAPHeader。qnameSOAP 标头的限定名称。 content为标头值发送的内容。 构造一个新的 SOAPHeader。SOAP 标头的限定名称和内容是必需的。 content 为标头值发送的内容。 为标头值发送的内容。如果为标头提供 XML 或 flash.xml.XMLNode 实例,该实例将直接用作预编码内容并作为子项追加到 soap:header 元素。否则,可以提供 String 或 Number 等形式的值,而基础 SOAP 编码器将尝试根据 SOAPHeader 中提供的 QName(如果不存在类型定义,则最终会采用 xsd:anyType)对该值正确地编码。 mustUnderstand 指定标头是否必须由端点识别。 指定标头是否必须由端点识别。如果处理了标头但标头必须被识别,则端点应返回 SOAP 错误。 qname SOAP 标头的限定名称。 SOAP 标头的限定名称。 role 指定该标头在潜在的处理 SOAP 请求的端点链中角色的 URI。 指定该标头在潜在的处理 SOAP 请求的端点链中角色的 URI。如果定义,则该值用于指定 SOAP 标头的 actor