HTTPService  - AS3 Flex

提供对服务使用的 ChannelSet 的访问。可以手动构造并分配 ChannelSet，否则将动态创建 以使用为此服务的 配置的通道。

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

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

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

services-config.xml 文件中的 HTTPService 目标名称。未指定时，Flex 将使用 DefaultHTTP 目标。如果正在使用 url 属性，但希望请求通过 HTTPS 到达代理，则请指定 DefaultHTTPS。

发送到第三方端点的自定义 HTTP 标头。如果需要以相同名称发送多个标头，应将值指定为一个数组。

上次调用的结果。

此属性可用作数据绑定的源。修改此属性后，将调度 resultForBinding 事件。

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

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

用作 URL 参数的名称/值对的对象。如果将 contentType 属性设置为 application/xml，则它应为一个 XML 文档。

提供对已发送消息的请求超时（以秒为单位）的访问。如果值小于 0 或等于 0，则可阻止请求超时的发生。

指示如何反序列化由 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) 表达式进行访问。

HTTPService 对象在计算相对 URL 时应使用的 URL。此属性仅在使用代理时使用。当 useProxy 属性设置为 false 时，将根据运行此应用程序的 SWF 的位置自动计算相对 URL。如果未明确设置，将把 rootURL 自动设置为 mx.messaging.config.LoaderConfig.url 的 URL。

提供一个适配器，用于控制将 HTTP 响应主体转换成 ActionScript 对象和/或将参数或主体转换成 HTTP 请求的 contentType、URL 和 Post 主体的过程。也可以间接对此进行设置，方法是使用静态方法 SerializationFilter.registerFilterForResultFormat("formatName", filter) 注册 SerializationFilter，进而设置 resultFormat。

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

服务的位置。如果指定 url 并指定非默认目标，则 services-config.xml 文件中的目标必须允许该指定的 URL。

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

默认值为 false。

ActionScript 函数，用于解码 XML 格式的服务结果。当 resultFormat 是一个对象并且设置了 xmlDecode 属性时，Flex 使用 HTTPService 返回的 XML 来创建对象。如果没有定义，则使用默认 XMLDecoder 进行此操作。

xmlDecode 属性引用的函数必须将一个 flash.xml.XMLNode 对象作为参数并应返回一个对象。返回的类型可以是任意的，但必须返回对象。返回 null 或 undefined 会导致错误。

   <mx:HTTPService id="hs" xmlDecode="xmlDecoder" url="myURL" resultFormat="object" contentType="application/xml">
        <mx:request><source/>
            <obj>{RequestObject}</obj>
        </mx:request>
   </mx:HTTPService>

function xmlDecoder (myXML)
{
 // Simplified decoding logic.
 var myObj = {};
 myObj.name = myXML.firstChild.nodeValue;
 myObj.honorific = myXML.firstChild.attributes.honorific;
 return myObj;
}

ActionScript 函数，用于将服务请求按 XML 编码。当请求的 contentType 为 application/xml 并且传入的请求对象是 Object 时，Flex 将尝试使用在 xmlEncode 属性中指定的函数将其转换为 flash.xml.XMLNode 对象；如果未设置 xmlEncode 属性，则 Flex 使用默认 XMLEncoder 将对象图形转换为 flash.xml.XMLNode 对象。

xmlEncode 属性采用 Object 并且应返回 flash.xml.XMLNode 对象。在这种情况下，XMLNode 对象可以是一个 flash.xml.XML 对象（XMLNode 的子类），也可以是 flash.xml.XML 对象的第一个子项（从 <mx:XML> 标签获取的内容）。返回错误的对象类型会导致错误。下例显示指定 xmlEncode 函数的 <mx:HTTPService> 标签：

  <mx:HTTPService id="hs" xmlEncode="xmlEncoder" url="myURL" resultFormat="object" contentType="application/xml">
        <mx:request><source/>
            <obj>{RequestObject}</obj>
        </mx:request>
   </mx:HTTPService>
    

function xmlEncoder (myObj)
{
  return new XML("");
}

创建一个新的 HTTPService。如果希望使用相对 URL 发送服务，则可能希望指定将作为确定完整 URL 的基础的 rootURL（例如 Application.application.url）。

取消上次服务调用或具有指定 ID 的调用。即使网络操作可能仍在继续，也不调度 result 或 fault 事件。

参数

将 invoker 的 result 属性设置为 null。当结果为不再使用的较大对象时，这将非常有用。

参数

断开服务的网络连接。此方法不会等待未完成的网络操作完成。

将用户从目标中注销。从目标中注销适用于使用在服务器配置中指定的同一通道连接的所有对象。例如，如果通过 my-rtmp 通道连接并且使用 RPC 组件之一注销，则通过 my-rtmp 连接的所有对象都将被注销。

注意：Adobe 建议使用 mx.messaging.ChannelSet.logout() 方法而不是此方法。

相关 API 元素

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

参数

为服务访问的目标设置凭据。凭据适用于通过相同 ChannelSet 连接的所有服务。请注意，使用代理连接到远程目标的服务将需要改为调用 setRemoteCredentials() 方法。

参数

在访问 HTTP URL 时对用户进行身份验证的用户名和密码。这些作为 HTTP 身份验证标头的一部分从代理传递到端点。如果 useProxy 属性设置为 false，则忽略此属性。

参数

当 HTTPService 调用失败时调度。

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

只要在通道尝试发送消息前没有引发错误，当调用 HTTPService 调用时将触发 invoke 事件。

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

当 HTTPService 调用成功返回时调度。

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

指示由 HTTP 服务发送的数据按 application/x-www-form-urlencoded 进行编码。

指示由 HTTP 服务发送的数据按 application/xml 进行编码。

指示 HTTPService 对象使用 DefaultHTTP 目标。

指示 HTTPService 对象使用 DefaultHTTPS 目标。

指示无法将 XML 格式的结果分析为 XML 实例或解码为对象。

指示输入参数无法按 XML 编码。

指示 useProxy 属性设置为 false 但没有提供 url。

结果格式“array”与“object”相似，但是其返回的值始终为数组；这样，如果从结果格式“object”返回的结果尚不是数组，则将把该项目添加为一个新数组的第一个项目。

结果格式“e4x”指定返回的值是一个 XML 实例，此实例可以使用 ECMAScript for XML (E4X) 表达式访问。

结果格式“flashvars”指定返回的值是包含由 & 符号分隔的名称=值对的文本，该文本被分析为 ActionScript 对象。

结果格式“object”指定返回的值是 XML，但按照 ActionScript 对象树分析。此为默认。

结果格式“text”指定 HTTPService 结果文本应为未经处理的字符串。

结果格式“xml”指定结果应作为指向父 flash.xml.XMLDocument 的第一个子项的 flash.xml.XMLNode 实例返回。