| Пакет | mx.rpc.http |
| Класс | public class AbstractOperation |
| Наследование | AbstractOperation  AbstractOperation AbstractInvoker EventDispatcher Object |
| Подклассы | Operation |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
send(param1, param2). Службы HTTP также поддерживают метод sendBody, позволяющий напрямую определять тело ответа HTTP. При использовании метода send(param1, param2) тело обычно формируется путем объединения свойства операции argumentNames с переданными параметрами. Создается объект, использующий argumentNames[i] в качестве ключа и соответствующий параметр в качестве значения.
Конкретный способ помещения аргументов операции HTTP в тело HTTP определяется используемым классом serializationFilter.
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
| argumentNames : Array
Упорядоченный список имен аргументов для передачи в вызов метода. | AbstractOperation | ||
 | arguments : Object
Аргументы для передачи операции при ее вызове. | AbstractOperation | |
| concurrency : String
Значение, которое указывает способ обработки нескольких вызовов одной службы. | AbstractOperation | ||
| constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| contentType : String
Тип содержимого для запросов служб. | AbstractOperation | ||
| headers : Object
Пользовательские заголовки HTTP, передаваемые в конечную точку третьей стороны. | AbstractOperation | ||
| lastResult : Object [только для чтения]
Результат последнего вызова. | AbstractInvoker | |
| makeObjectsBindable : Boolean
Если значение равно true, возвращенные анонимные объекты принудительно передаются объектам со свойством bindable. | AbstractInvoker | |
| method : String
Метод HTTP для передачи запроса. | AbstractOperation | ||
| name : String
Имя этой операции. | AbstractOperation | |
| operationManager : Function
Это свойство обычно устанавливается кодом инфраструктуры, если требуется изменить поведение вызова службы без изменения способа внешнего вызова этой службы. | AbstractInvoker | |
| properties : Object
Эта функция предназначена, главным образом, для разработчиков инфраструктуры с целью регистрации дополнительных пользовательских свойств для операции. | AbstractOperation | |
| request : Object
Объект пар «значение - имя», используемых в качестве параметров URL-адреса. | AbstractOperation | ||
| requestTimeout : int
Предоставляет доступ к тайм-ауту запроса в секундах для переданных сообщений. | AbstractOperation | ||
| resultElementType : Class
Аналогично resultType предназначается для определения класса ActionScript, используемого данной операцией, но применяется только в отношении операций, возвращающих результат с несколькими значениями (например, | AbstractInvoker | |
| resultFormat : String
Значение, указывающее способ десериализации возвращаемого результата при вызове HTTP. | AbstractOperation | ||
| resultType : Class
Указывает дополнительный тип возврата для операции. | AbstractInvoker | |
| rootURL : String
URL-адрес, который должен использоваться объектом службы при вычислении относительных URL-адресов. | AbstractOperation | ||
| serializationFilter : SerializationFilter
SerializationFilter может управлять форматированием аргументов для формирования содержимого запроса HTTP. | AbstractOperation | ||
| service : AbstractService [только для чтения]
Предоставляет удобный доступ к службе, в которой вызывается операция. | AbstractOperation | |
| showBusyCursor : Boolean
Если значение true, во время выполнения службы отображается курсор в состоянии занятости. | AbstractOperation | ||
| url : String
Местоположение службы. | AbstractOperation | ||
| useProxy : Boolean
Указывает, требуется ли использовать службу прокси Flex. | AbstractOperation | ||
| xmlDecode : Function
Функция ActionScript, используемая для декодирования результата службы из XML. | AbstractOperation | ||
| xmlEncode : Function
Функция ActionScript используется для кодирования запроса службы в XML. | AbstractOperation | ||
| Метод | Определено | ||
|---|---|---|---|
Создает новую операцию. | AbstractOperation | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
|
Отменяет последний вызов службы или вызов с указанным идентификатором. | AbstractInvoker | |
|
Устанавливает для свойства result объекта вызова значение null. | AbstractInvoker | |
|
Посылает событие в поток событий. | EventDispatcher | |
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
|
Выполняет соответствующий метод. | AbstractOperation | |
| AbstractOperation | |||
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Эта функция предоставляется для обновления свойства lastResult. | AbstractInvoker | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
| Метод | Определено | ||
|---|---|---|---|
Возвращает заголовки запроса HTTP. | AbstractOperation | ||
Возвращает фильтр сериализации. | AbstractOperation | ||
argumentNames | свойство |
public var argumentNames:Array| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Упорядоченный список имен аргументов для передачи в вызов метода. Поскольку объект аргументов представляет собой карту хеширования без гарантированной очередности, этот массив позволяет все корректно скомпилировать. Он устанавливается автоматически MXML-компилятором в случае использования операции в форме тега.
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 | свойство |
contentType:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Тип содержимого для запросов служб. Значение по умолчанию – application/x-www-form-urlencoded, передающее запросы в режиме стандартной операции HTTP POST с парами «значение - имя». application/xml передает запросы в виде XML.
Реализация
public function get contentType():String public function set contentType(value:String):voidheaders | свойство |
public var headers:Object| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Пользовательские заголовки HTTP, передаваемые в конечную точку третьей стороны. Если требуется передать несколько заголовков с одним именем, необходимо указать значение как массив.
method | свойство |
method:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Метод HTTP для передачи запроса. Допустимыми являются значения: GET, POST, HEAD, OPTIONS, PUT, TRACE и DELETE. Буквы нижнего регистра преобразуются в буквы верхнего регистра. Значение по умолчанию: GET.
Реализация
public function get method():String public function set method(value:String):voidrequest | свойство |
public var request:Object| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Объект пар «значение - имя», используемых в качестве параметров URL-адреса. Если свойство contentType определено как application/xml, это документ XML.
requestTimeout | свойство |
requestTimeout:int| Язык версии: | ActionScript 3.0 |
| Версии продуктов: | BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Предоставляет доступ к тайм-ауту запроса в секундах для переданных сообщений. Если подтверждение, ответ или ошибка не получены от удаленного адресата по истечении тайм-аута, то сообщение привело к ошибке на клиенте. Если значение меньше или равно нулю, тайм-аут запроса не применяется.
Реализация
public function get requestTimeout():int public function set requestTimeout(value:int):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):voidrootURL | свойство |
rootURL:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
URL-адрес, который должен использоваться объектом службы при вычислении относительных URL-адресов. Это свойство используется только при передаче через прокси. Если свойство useProxy определено как false, относительный URL-адрес вычисляется автоматически по местоположению SWF, запускающего это приложение. Если значение rootURL не установлено явно, в качестве этого значения автоматически используется URL mx.messaging.config.LoaderConfig.url.
Реализация
public function get rootURL():String public function set rootURL(value:String):voidserializationFilter | свойство |
public var serializationFilter:SerializationFilter| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
SerializationFilter может управлять форматированием аргументов для формирования содержимого запроса HTTP. При этом также контролируется способ преобразования результатов в объекты ActionScript. Это можно настроить прямым использованием этого свойства или косвенным использованием свойства resultFormat.
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):voidurl | свойство |
url:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Местоположение службы. Если указан url и адрес назначения, отличный от адреса назначения по умолчанию, адрес назначения в файле services-config.xml должен допускать указанный URL-адрес.
Реализация
public function get url():String public function set url(value:String):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):voidxmlDecode | свойство |
public var xmlDecode:Function| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Функция ActionScript, используемая для декодирования результата службы из XML. Если resultFormat является объектом и определено свойство xmlDecode, Flex использует XML, возвращаемый службой HTTP для создания объекта. Если свойство не определено, по умолчанию для выполнения работы используется 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>
В следующем примере показана функция xmlDecoder:
function xmlDecoder (myXML)
{
// Simplified decoding logic.
var myObj = {};
myObj.name = myXML.firstChild.nodeValue;
myObj.honorific = myXML.firstChild.attributes.honorific;
return myObj;
}
xmlEncode | свойство |
public var xmlEncode:Function| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Функция ActionScript используется для кодирования запроса службы в XML. Если contentType запроса определено как application/xml, а переданный объект запроса является объектом, Flex попытается использовать функцию, указанную в свойстве xmlEncode, для его преобразования в объект flash.xml.XMLNode. Если свойство xmlEncode не определено, для преобразования графика объекта в объект flash.xml.XMLNode Flex использует XMLEncoder по умолчанию.
Свойство xmlEncode принимает объект и должно возвратить объект flash.xml.XMLNode. В этом случае объект XMLNode может быть объектом flash.xml.XML, который является подклассом XMLNode или первым нижестоящим элементом объекта flash.xml.XML, получаемым из тега <mx:XML>. Возврат неверного типа объекта является причиной сбоя. В следующем примере показан тег <mx:HTTPService>, определяющий функцию xmlEncode:
<mx:HTTPService id="hs" xmlEncode="xmlEncoder" url="myURL" resultFormat="object" contentType="application/xml">
<mx:request><source/>
<obj>{RequestObject}</obj>
</mx:request>
</mx:HTTPService>
В следующем примере показана функция xmlEncoder:
function xmlEncoder (myObj)
{
return new XML("");
}
AbstractOperation | () | Конструктор |
public function AbstractOperation(service:AbstractService = null, name:String = null)| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 Creates a new Operation. |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Создает новую операцию.
Параметрыservice:AbstractService (default = null) | |
name:String (default = null) |
getHeaders | () | метод |
protected function getHeaders():Object| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает заголовки запроса HTTP. Подклассы могут переопределить этот метод для управления поиском заголовков запроса HTTP.
ВозвращаетObject — Заголовки запроса HTTP.
|
getSerializationFilter | () | метод |
protected function getSerializationFilter():SerializationFilterВозвращает фильтр сериализации. Подклассы могут переопределить этот метод для управления поиском заголовков запроса HTTP.
ВозвращаетSerializationFilter — Фильтр сериализации.
|
sendBody | () | метод |
public function sendBody(parameters:Object):mx.rpc:AsyncTokenПараметры
parameters:Object |
mx.rpc:AsyncToken |
Tue Jun 12 2018, 11:34 AM Z