| 包 | mx.rpc.soap |
| 类 | public dynamic class WebService |
| 继承 | WebService  AbstractWebService AbstractService Proxy |
| 子类 | WebService |
| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
公共属性
隐藏继承的公共属性
显示继承的公共属性| 属性 | 由以下参数定义 | ||
|---|---|---|---|
 | channelSet : ChannelSet
提供对服务使用的 ChannelSet 的访问。 | AbstractService | |
| convertParametersHandler : Function
一个可选函数，主要供具有以下需要的框架开发人员使用：安装用传递给每个 webservice 操作调用的参数进行调用的函数。 | AbstractWebService | |
| convertResultHandler : Function
一个可选函数，主要供具有以下需要的框架开发人员使用：安装一个挂钩，以便在通知结果处理程序之前处理操作的结果。 | AbstractWebService | |
| description : String
当前活动端口的服务描述。 | AbstractWebService | |
| destination : String [覆盖]
服务的目标。 | AbstractWebService | |
| endpointURI : String
WebService 的位置。 | AbstractWebService | |
| headers : Array [只读]
返回为 WebService 注册的 SOAPHeaders 数组。 | AbstractWebService | |
| httpHeaders : Object
发送到 SOAP 端点的自定义 HTTP 标头。 | AbstractWebService | |
| makeObjectsBindable : Boolean
当该置为 true 时，返回的匿名对象将强制成为可绑定的对象。 | AbstractWebService | |
| managers : Array
managers 属性存储修改此服务行为的数据管理器的列表。 | AbstractService | |
| operations : Object
如果使用 MXML 标签创建服务，则操作数组通常仅由 MXML 编译器设置。 | AbstractService | |
| port : String
指定此 WebService 应使用的 WSDL 文档中的端口。 | AbstractWebService | |
| ready : Boolean [只读]
指定 WebService 是否准备好发送请求。 | AbstractWebService | |
| requestTimeout : int
提供对已发送消息的请求超时（以秒为单位）的访问。 | AbstractService | |
| rootURL : String
WebService 在计算相对 URL 时应使用的 URL。 | AbstractWebService | |
| service : String
指定此 WebService 应使用的 WSDL 文档中的服务。 | AbstractWebService | |
| useProxy : Boolean
指定是否使用 Flex 代理服务。 | AbstractWebService | |
| wsdl : String
此 WebService 的 WSDL 文档的位置。 | WebService | ||
| xmlSpecialCharsFilter : Function
用于在对任何简单内容编码之前转义 XML 特殊字符的自定义函数。 | AbstractWebService | |
公共方法
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
创建一个新的 WebService。 | WebService | ||
|
添加将应用于此 Web 服务所有操作的标头。 | AbstractWebService | |
| addSimpleHeader(qnameLocal:String, qnameNamespace:String, headerName:String, headerValue:String):void
添加将应用于此 WebService 所有操作的标头。 | AbstractWebService | |
返回一个布尔值，指示 WebService 是否准备好加载 WSDL（是否指定了有效的目标或 wsdl）。 | WebService | ||
|
清除应用于所有操作的标头。 | AbstractWebService | |
|
断开此服务的网络连接并删除任何未处理的请求 responder。 | AbstractService | |
|
如果根据 QName、localName 和 URI 找到匹配项，则返回标头。 | AbstractWebService | |
[覆盖]
返回给定名称的操作。 | WebService | ||
|
调用以初始化服务。 | AbstractService | |
指示 WebService 下载 WSDL 文档。 | WebService | ||
|
将用户从目标中注销。 | AbstractService | |
|
从所有操作中删除具有给定 QName 的标头。 | AbstractWebService | |
|
当在服务器端使用 Data Services 时，为服务访问的目标设置凭据。 | AbstractService | |
| [覆盖]
在访问 webservice 时对用户进行身份验证的用户名和密码。 | AbstractWebService | |
将 WebService 的实例表示为字符串，描述如目标 id 和所分配的通道集等重要属性。 | WebService | ||
受保护的方法
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
初始化一个新的 Operation。 | WebService | ||
事件
| 事件 | 摘要 | 由以下参数定义 | ||
|---|---|---|---|---|
| 当服务调用失败并且操作自身不处理时，将调度 fault 事件。 | AbstractService | ||
| 当调用服务操作时，只要在通道尝试发送消息前没有引发错误，将调度 invoke 事件。 | AbstractService | ||
| 当已成功加载 WSDL 文档时调度 LoadEvent.LOAD。 | WebService | |||
| 当服务调用成功返回并且操作自身不处理时，将调度 result 事件。 | AbstractService | ||
公共常量
| 常量 | 由以下参数定义 | ||
|---|---|---|---|
| DEFAULT_DESTINATION_HTTP : String = "DefaultHTTP" [静态] | WebService | ||
| DEFAULT_DESTINATION_HTTPS : String = "DefaultHTTPS" [静态] | WebService | ||
属性详细信息
wsdl | 属性 |
构造函数详细信息
WebService | () | 构造函数 |
public function WebService(destination:String = null, rootURL:String = null)| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
创建一个新的 WebService。目标（如果已指定）应与 services-config.xml 中的条目匹配。如果未指定，WebService 使用 DefaultHTTP 目标。如果打算使用相对 URL 查找此 WebService 的 WSDL 文档，则 rootURL 是必不可少的。
destination:String (default = null) | |
rootURL:String (default = null) |
方法详细信息
canLoadWSDL | () | 方法 |
getOperation | () | 方法 |
override public function getOperation(name:String):AbstractOperation| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
返回给定名称的操作。如果之前没有创建该操作，则将在此调用过程中创建一个新的 mx.rpc.soap.Operation。通常只需在服务变量之后命名操作即可访问操作 (myService.someOperation)，但如果 Operation 的名称恰好与服务上所定义的方法（如 setCredentials）相匹配，则可以改用此方法来获取 Operation。
参数
name:String — 操作的名称。
|
AbstractOperation — 为此名称执行的操作。
|
initializeOperation | () | 方法 |
loadWSDL | () | 方法 |
public function loadWSDL(uri:String = null):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
指示 WebService 下载 WSDL 文档。当在 WebService MXML 标签中指定时，WebService 自动调用此方法；但是如果在指定 destination 或 wsdl 属性值后在 ActionScript 中创建 WebService 对象，则必须手动调用此方法。
参数
uri:String (default = null) |
toString | () | 方法 |
事件详细信息
load | 事件 |
事件对象类型:
属性 LoadEvent.type =
mx.rpc.soap.LoadEvent属性 LoadEvent.type =
mx.rpc.soap.LoadEvent.LOAD| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
当已成功加载 WSDL 文档时调度 LoadEvent.LOAD。
LOAD 常量为 load 事件定义事件对象的 type 属性的值。
事件对象的属性有下列值：
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | true |
wsdl | WSDL 对象。 |
location | WSDL 文档的 URI |
常量详细信息
DEFAULT_DESTINATION_HTTP | 常量 |
public static const DEFAULT_DESTINATION_HTTP:String = "DefaultHTTP"DEFAULT_DESTINATION_HTTPS | 常量 |
public static const DEFAULT_DESTINATION_HTTPS:String = "DefaultHTTPS"Tue Jun 12 2018, 11:04 AM Z