| Пакет | mx.rpc.http |
| Класс | public dynamic class HTTPMultiService |
| Наследование | HTTPMultiService  AbstractService Proxy |
| Подклассы | HTTPMultiService |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
<mx:HTTPMultiService> используется для представления коллекции операций http. Каждый имеет URL-адрес, метод, параметры и тип возвращаемого значения.
Можно установить такие атрибуты, как URL-адрес и метод в теге HTTPMultiService, для использования в качестве значений по умолчанию, установленных в каждом отдельном теге операции. URL-адрес HTTPMultiService служит базовым URL-адресом (т. е. префиксом) для любых относительных URL-адресов, установленных в тегах операций HTTP. Каждая операция http имеет метод send() для выполнения запроса HTTP по указанному URL-адресу и возврата ответа HTTP.
Можно передать параметры по указанному URL-адресу, используемому для помещения данных в запрос HTTP. Свойство contentType указывает mimeType, используемый для определения формата передаваемых данных (например, кодировка формы HTTP или XML).
Для реализации пользовательского формата resultFormat, например JSON, можно также использовать фильтр сериализации. Если не применяется служба прокси на базе сервера, можно использовать только методы HTTP GET или POST. Однако если при использовании службы прокси на базе сервера для свойства useProxy было установлено значение true, можно также использовать методы HTTP HEAD, OPTIONS, TRACE и DELETE.
Примечание. В отличие от класса HTTPService, класс HTTPMultiService не определяет свойство request.
Примечание. Из-за ограничений, связанных с программным обеспечением, служба HTTPService, HTTPMultiService не создает понятные пользователю сообщения об ошибках при использовании метода GET, а не прокси.
Свойство MXML по умолчаниюoperationList
Связанные элементы API
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
| baseURL : String
URL-адрес, который должен использоваться объектом службы при вычислении относительных URL-адресов. | HTTPMultiService | ||
 | channelSet : ChannelSet
Предоставляет доступ к ChannelSet, используемому данной службой. | AbstractService | |
| concurrency : String
Значение, которое указывает способ обработки нескольких вызовов одной операции в службе. | HTTPMultiService | ||
| contentType : String = "application/x-www-form-urlencoded"
Тип содержимого для запросов служб. | HTTPMultiService | ||
| destination : String
Адрес назначения службы. | AbstractService | |
| headers : Object
Пользовательские заголовки HTTP, передаваемые в конечную точку третьей стороны. | HTTPMultiService | ||
| makeObjectsBindable : Boolean = true
Если значение true, возвращаемые объекты поддерживают привязку к элементам управления пользовательского интерфейса. | HTTPMultiService | ||
| managers : Array
Свойство managers используется для хранения списка менеджеров данных, которые изменяют поведение этой службы. | AbstractService | |
| method : String = "GET"
Метод HTTP для передачи запроса, если метод не определен в операции явным образом. | HTTPMultiService | ||
| operationList : Array
Служит свойством по умолчанию для этого экземпляра, поэтому набор операций можно определить как непосредственные нижестоящие элементы тега HTTPMultiService в MXML. | HTTPMultiService | ||
| operations : Object
Массив операций обычно устанавливается только компилятором MXML при создании службы посредством тега MXML. | AbstractService | |
| requestTimeout : int
Предоставляет доступ к тайм-ауту запроса в секундах для переданных сообщений. | AbstractService | |
| resultFormat : String
Значение, указывающее способ десериализации возвращаемого результата при вызове HTTP. | HTTPMultiService | ||
| serializationFilter : SerializationFilter По умолчанию всеми операциями, для которых значение не определено явным образом, используется serializationFilter. | HTTPMultiService | ||
| showBusyCursor : Boolean
Если значение true, во время выполнения службы отображается курсор в состоянии занятости. | HTTPMultiService | ||
| useProxy : Boolean
Указывает, требуется ли использовать службу прокси Flex. | HTTPMultiService | ||
| Метод | Определено | ||
|---|---|---|---|
Создает новую службу HTTPService. | HTTPMultiService | ||
|
Разъединяет сетевое подключение службы и удаляет любые ответчики для запросов в очереди. | AbstractService | |
|
Возвращает операцию для данного имени. | AbstractService | |
|
Вызов для инициализации службы. | AbstractService | |
|
Регистрирует пользователя за пределами адреса назначения. | AbstractService | |
|
Устанавливает учетные данные для адреса назначения, к которому обращалась служба при использовании Data Services на стороне сервера. | AbstractService | |
|
Имя пользователя и пароль для аутентификации пользователя в случае обращения к удаленной внешней конечной точке, например к web-службе через прокси или к удаленному объекту через пользовательский адаптер при использовании Data Services на стороне сервера. | AbstractService | |
| Событие | Сводка | Определено | ||
|---|---|---|---|---|
| Отправляется при сбое вызова HTTPMultiService. | HTTPMultiService | |||
| Событие вызова запускается при получении вызова HTTPMultiService и длится до передачи ошибки перед попыткой канала передать сообщение. | HTTPMultiService | |||
| Отправляется при получении значений возврата от вызова HTTPMultiService. | HTTPMultiService | |||
baseURL | свойство |
public var baseURL:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
URL-адрес, который должен использоваться объектом службы при вычислении относительных URL-адресов. В нем содержится префикс, указываемый перед любым URL-адресом при его определении. По умолчанию он имеет значение null, при этом для вычисления относительных URL-адресов используется SWF.
concurrency | свойство |
concurrency:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Значение, которое указывает способ обработки нескольких вызовов одной операции в службе. Применяемая в данном случае установка параллельной обработки будет использоваться для операций, не указывающих параллельную обработку. Индивидуальные операции с непосредственно заданной установкой параллельной обработки будут игнорировать установленное здесь значение. Значение по умолчанию: multiple. Допустимыми являются следующие значения:
multiple– существующие запросы не отменяются, и разработчик несет ответственность за обеспечение непротиворечивости возвращаемых данных путем тщательного управления потоком событий. Это значение является значением по умолчанию.single– допускается только один запрос в операции в конкретный момент времени; многократные запросы вызывают сбой.last– создание нового запроса отменяет любой существующий запрос.
Реализация
public function get concurrency():String public function set concurrency(value:String):voidcontentType | свойство |
public var contentType:String = "application/x-www-form-urlencoded"
Тип содержимого для запросов служб. Значение по умолчанию – application/x-www-form-urlencoded, передающее запросы в режиме стандартной операции HTTP POST с парами «значение - имя». application/xml передает запросы в виде XML.
headers | свойство |
public var headers:Object| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Пользовательские заголовки HTTP, передаваемые в конечную точку третьей стороны. Если требуется передать несколько заголовков с одним именем, необходимо указать значение как массив. Эти заголовки передаются всем операциям. Заголовки можно также определять на уровне операций.
makeObjectsBindable | свойство |
public var makeObjectsBindable:Boolean = true| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Если значение true, возвращаемые объекты поддерживают привязку к элементам управления пользовательского интерфейса. Это означает, что они отправляют PropertyChangeEvents, когда их значения свойств изменяются. Это значение является значением по умолчанию для любых операций, свойство makeObjectsBindable которых не определено явным образом.
method | свойство |
public var method:String = "GET"| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Метод HTTP для передачи запроса, если метод не определен в операции явным образом. Допустимыми являются значения: GET, POST, HEAD, OPTIONS, PUT, TRACE и DELETE. Буквы нижнего регистра преобразуются в буквы верхнего регистра. Значение по умолчанию: GET.
operationList | свойство |
operationList:Array| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Служит свойством по умолчанию для этого экземпляра, поэтому набор операций можно определить как непосредственные нижестоящие элементы тега HTTPMultiService в MXML.
Реализация
public function get operationList():Array public function set operationList(value:Array):voidresultFormat | свойство |
resultFormat:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Значение, указывающее способ десериализации возвращаемого результата при вызове HTTP. Значение этого основано на следующем:
- возвращается XML или возвращаются пары «имя/значение».
- Способ доступа к результатам; можно получить доступ к таким результатам, как объект, текст или XML.
Значение по умолчанию: object. Допустимыми являются следующие значения:
object– значение возвращается в виде XML и анализируется как дерево объектов ActionScript. Это значение по умолчанию.array– значение возвращается в виде XML и анализируется как дерево объектов ActionScript, однако если объект верхнего уровня не является массивом, создается новый массив, и результат устанавливается в качестве первого элемента. Если makeObjectsBindable имеет значение true, то массив включается в ArrayCollection.xml– значение возвращается в виде XML и в виде литерального XML в объекте ActionScript XMLnode.flashvars– значение возвращается в виде текста, содержащего пары «имя = значение», разделенные амперсандами, и при анализе преобразуется в объект ActionScript.text– значение возвращается в виде текста и остается необработанным.e4x– значение возвращается в виде XML и в виде литерального XML в объекте ActionScript XML, к которому можно получить доступ с помощью ECMAScript для выражений XML (E4X).
Реализация
public function get resultFormat():String public function set resultFormat(value:String):voidserializationFilter | свойство |
public var serializationFilter:SerializationFilterПо умолчанию всеми операциями, для которых значение не определено явным образом, используется serializationFilter.
showBusyCursor | свойство |
showBusyCursor:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Если значение true, во время выполнения службы отображается курсор в состоянии занятости. Значение по умолчанию false.
Реализация
public function get showBusyCursor():Boolean public function set showBusyCursor(value:Boolean):voiduseProxy | свойство |
useProxy:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Указывает, требуется ли использовать службу прокси Flex. Значение по умолчанию false. Если для запросов прокси через сервер Flex не указано значение true, необходимо обеспечить возможность достижения целевого URL-адреса для Flash Player. Также невозможно использовать адреса назначения, определенные в файле services-config.xml, если для свойства useProxy установлено значение false.
Значением по умолчанию является false.
Реализация
public function get useProxy():Boolean public function set useProxy(value:Boolean):voidHTTPMultiService | () | Конструктор |
public function HTTPMultiService(baseURL:String = null, destination:String = null)| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Создает новую службу HTTPService. Если служба должна выполнять передачу с помощью относительных URL-адресов, возможно, потребуется указать baseURL, на основе которого будет определяться полный URL-адрес (например, Application.application.url).
baseURL:String (default = null) | |
destination:String (default = null) |
fault | Событие |
mx.rpc.events.FaultEventсвойство FaultEvent.type =
mx.rpc.events.FaultEvent.FAULT| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Отправляется при сбое вызова HTTPMultiService.
Тип события FAULT.Свойства объекта события имеют следующие значения:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | true, вызов preventDefault()из метода responder.fault связанного маркера приводит к предотвращению передачи этого события службой или операцией |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
fault | Объект Fault, который содержит подробную информацию о причине этого события. |
message | Сообщение, связанное с этим событием. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
token | Маркер, представляющий вызов метода. Используется в образце асинхронного маркера выполнения. |
invoke | Событие |
mx.rpc.events.InvokeEventсвойство InvokeEvent.type =
mx.rpc.events.InvokeEvent.INVOKE| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Событие вызова запускается при получении вызова HTTPMultiService и длится до передачи ошибки перед попыткой канала передать сообщение.
Тип события INVOKE.Свойства объекта события имеют следующие значения:
| Свойство | Значение |
|---|---|
bubbles | false |
token | Маркер, представляющий отдельный вызов метода. Используется в образце асинхронного маркера выполнения. |
cancelable | true |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
message | Сообщение запроса, связанное с данным событием. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
result | Событие |
mx.rpc.events.ResultEventсвойство ResultEvent.type =
mx.rpc.events.ResultEvent.RESULT| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Отправляется при получении значений возврата от вызова HTTPMultiService.
Тип события RESULT.Свойства объекта события имеют следующие значения:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | true, preventDefault() из метода связанного маркера responder.result предотвращает передачу этого события операцией или службой |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
message | Сообщение, связанное с этим событием. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
result | Результат, возвращаемый вызовом RPC. |
token | Маркер, представляющий отдельный вызов метода. Используется в образце асинхронного маркера выполнения. |
Tue Jun 12 2018, 11:34 AM Z