mx.rpc.http.HTTPMultiService (Flex 3.4)

	Property	Defined By
		baseURL : String The URL that the HTTPService object should use when computing relative URLs.	HTTPMultiService
		channelSet : ChannelSet Provides access to the ChannelSet used by the service.	AbstractService
		constructor : Object A reference to the class object or constructor function for a given object instance.	Object
		contentType : String = "application/x-www-form-urlencoded" Type of content for service requests.	HTTPMultiService
		destination : String The destination of the service.	AbstractService
		headers : Object Custom HTTP headers to be sent to the third party endpoint.	HTTPMultiService
		makeObjectsBindable : Boolean = true When true, the objects returned support data binding to UI controls.	HTTPMultiService
		managers : Array The managers property stores a list of data managers which modify the behavior of this service.	AbstractService
		method : String = "GET" HTTP method for sending the request if a method is not set explicit on the operation.	HTTPMultiService
		operationList : Array This serves as the default property for this instance so that we can define a set of operations as direct children of the HTTPMultiService tag in MXML.	HTTPMultiService
		operations : Object The Operations array is usually only set by the MXML compiler if you create a service using an MXML tag.	AbstractService
		prototype : Object [static] A reference to the prototype object of a class or function object.	Object
		requestTimeout : int Provides access to the request timeout in seconds for sent messages.	AbstractService
		resultFormat : String Value that indicates how you want to deserialize the result returned by the HTTP call.	HTTPMultiService
		serializationFilter : SerializationFilter Default serializationFilter used by all operations which do not set one explicitly	HTTPMultiService
		showBusyCursor : Boolean = false If true, a busy cursor is displayed while a service is executing.	HTTPMultiService
		useProxy : Boolean Specifies whether to use the Flex proxy service.	HTTPMultiService

	Method	Defined By
		HTTPMultiService(baseURL:String = null, destination:String = null) Creates a new HTTPService.	HTTPMultiService
		disconnect():void Disconnects the service's network connection and removes any pending request responders.	AbstractService
		getOperation(name:String):AbstractOperation Returns an Operation of the given name.	AbstractService
		hasOwnProperty(name:String):Boolean Indicates whether an object has a specified property defined.	Object
		initialize():void Called to initialize the service.	AbstractService
		isPrototypeOf(theClass:Object):Boolean Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.	Object
		logout():void Logs the user out of the destination.	AbstractService
		propertyIsEnumerable(name:String):Boolean Indicates whether the specified property exists and is enumerable.	Object
		setCredentials(username:String, password:String, charset:String = null):void Sets the credentials for the destination accessed by the service when using Data Services on the server side.	AbstractService
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Sets the availability of a dynamic property for loop operations.	Object
		setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void The username and password to be used to authenticate a user when accessing a remote, third-party endpoint such as a web service through a proxy or a remote object through a custom adapter when using Data Services on the server side.	AbstractService
		toLocaleString():String Returns the string representation of this object, formatted according to locale-specific conventions.	Object
		toString():String Returns the string representation of the specified object.	Object
		valueOf():Object Returns the primitive value of the specified object.	Object

Summary	Defined By
fault	Dispatched when an HTTPMultiService call fails.	HTTPMultiService
invoke	The invoke event is fired when an HTTPMultiService call is invoked so long as an Error is not thrown before the Channel attempts to send the message.	HTTPMultiService
result	Dispatched when an HTTPMultiService call returns successfully.	HTTPMultiService

Property Detail

baseURL

property

public var baseURL:String

The URL that the HTTPService object should use when computing relative URLs. This contains a prefix which is prepended onto any URLs when it is set. It defaults to null in which case the URL for the SWF is used to compute relative URLs.

contentType

property

public var contentType:String = "application/x-www-form-urlencoded"

Type of content for service requests. The default is application/x-www-form-urlencoded which sends requests like a normal HTTP POST with name-value pairs. application/xml send requests as XML.

headers

property

public var headers:Object

Custom HTTP headers to be sent to the third party endpoint. If multiple headers need to be sent with the same name the value should be specified as an Array. These headers are sent to all operations. You can also set headers at the operation level.

makeObjectsBindable

property

public var makeObjectsBindable:Boolean = true

When true, the objects returned support data binding to UI controls. That means they send PropertyChangeEvents when their property values are being changed. This is the default value for any operations whose makeObjectsBindable property is not set explicitly.

method

property

public var method:String = "GET"

HTTP method for sending the request if a method is not set explicit on the operation. Permitted values are GET, POST, HEAD, OPTIONS, PUT, TRACE and DELETE. Lowercase letters are converted to uppercase letters. The default value is GET.

operationList

property

operationList:Array

This serves as the default property for this instance so that we can define a set of operations as direct children of the HTTPMultiService tag in MXML.

Implementation
public function get operationList():Array
public function set operationList(value:Array):void

resultFormat

property

resultFormat:String

Value that indicates how you want to deserialize the result returned by the HTTP call. The value for this is based on the following:

Whether you are returning XML or name/value pairs.
How you want to access the results; you can access results as an object, text, or XML.

The default value is object. The following values are permitted:

object The value returned is XML and is parsed as a tree of ActionScript objects. This is the default.
array The value returned is XML and is parsed as a tree of ActionScript objects however if the top level object is not an Array, a new Array is created and the result set as the first item. If makeObjectsBindable is true then the Array will be wrapped in an ArrayCollection.
xml The value returned is XML and is returned as literal XML in an ActionScript XMLnode object.
flashvars The value returned is text containing name=value pairs separated by ampersands, which is parsed into an ActionScript object.
text The value returned is text, and is left raw.
e4x The value returned is XML and is returned as literal XML in an ActionScript XML object, which can be accessed using ECMAScript for XML (E4X) expressions.

Implementation
public function get resultFormat():String
public function set resultFormat(value:String):void

serializationFilter

property

public var serializationFilter:SerializationFilter

Default serializationFilter used by all operations which do not set one explicitly

showBusyCursor

property

public var showBusyCursor:Boolean = false

If true, a busy cursor is displayed while a service is executing. The default value is false.

useProxy

property

useProxy:Boolean

Specifies whether to use the Flex proxy service. The default value is false. If you do not specify true to proxy requests though the Flex server, you must ensure that the player can reach the target URL. You also cannot use destinations defined in the services-config.xml file if the useProxy property is set to false.

The default value is false.

Implementation
public function get useProxy():Boolean
public function set useProxy(value:Boolean):void

Constructor Detail

HTTPMultiService

()

Constructor

public function HTTPMultiService(baseURL:String = null, destination:String = null)

Creates a new HTTPService. If you expect the service to send using relative URLs you may wish to specify the baseURL that will be the basis for determining the full URL (one example would be Application.application.url).

Parameters

	`baseURL:String` (default = `null`) — The URL the HTTPService should use when computing relative URLS.

	`destination:String` (default = `null`)

Event Detail

fault

Event

Event Object Type: mx.rpc.events.FaultEvent
property FaultEvent.type = mx.rpc.events.FaultEvent.FAULT

Dispatched when an HTTPMultiService call fails.

The FAULT event type.

The properties of the event object have the following values:

Property	Value
`bubbles`	false
`cancelable`	true, calling preventDefault() from the associated token's responder.fault method will prevent the service or operation from dispatching this event
`currentTarget`	The Object that defines the event listener that handles the event. For example, if you use `myButton.addEventListener()` to register an event listener, myButton is the value of the `currentTarget`.
`fault`	The Fault object that contains the details of what caused this event.
`message`	The Message associated with this event.
`target`	The Object that dispatched the event; it is not always the Object listening for the event. Use the `currentTarget` property to always access the Object listening for the event.
`token`	The token that represents the call to the method. Used in the asynchronous completion token pattern.

invoke

Event

Event Object Type: mx.rpc.events.InvokeEvent
property InvokeEvent.type = mx.rpc.events.InvokeEvent.INVOKE

The invoke event is fired when an HTTPMultiService call is invoked so long as an Error is not thrown before the Channel attempts to send the message.

The INVOKE event type.

The properties of the event object have the following values:

Property	Value
`bubbles`	false
`token`	The token that represents the indiviudal call to the method. Used in the asynchronous completion token pattern.
`cancelable`	true
`currentTarget`	The Object that defines the event listener that handles the event. For example, if you use `myButton.addEventListener()` to register an event listener, myButton is the value of the `currentTarget`.
`message`	The request Message associated with this event.
`target`	The Object that dispatched the event; it is not always the Object listening for the event. Use the `currentTarget` property to always access the Object listening for the event.

result

Event

Event Object Type: mx.rpc.events.ResultEvent
property ResultEvent.type = mx.rpc.events.ResultEvent.RESULT

Dispatched when an HTTPMultiService call returns successfully.

The RESULT event type.

The properties of the event object have the following values:

Property	Value
`bubbles`	false
`cancelable`	true, preventDefault() from the associated token's responder.result method will prevent the service or operation from dispatching this event
`currentTarget`	The Object that defines the event listener that handles the event. For example, if you use `myButton.addEventListener()` to register an event listener, myButton is the value of the `currentTarget`.
`message`	The Message associated with this event.
`target`	The Object that dispatched the event; it is not always the Object listening for the event. Use the `currentTarget` property to always access the Object listening for the event.
`result`	Result that the RPC call returns.
`token`	The token that represents the indiviudal call to the method. Used in the asynchronous completion token pattern.

Adobe® Flex™ 3.4 Language Reference Language Reference only	All Packages \| All Classes \| Language Elements \| Index \| Appendixes \| Conventions \| Frames No Frames
HTTPMultiService	Properties \| Methods \| Events

Package	mx.rpc.http
Class	public dynamic class HTTPMultiService
Inheritance	HTTPMultiService AbstractService Proxy Object