| Пакет | mx.rpc.http |
| Класс | public class HTTPService |
| Наследование | HTTPService  AbstractInvoker EventDispatcher Object |
| Подклассы | HTTPService |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
send() объекта HTTPService выполняется запрос HTTP на указанный URL, и возвращается ответ HTTP. Дополнительно на указанный URL-адрес можно передать параметры. Если не применяется служба прокси на базе сервера, можно использовать только методы HTTP GET или POST. Однако если при использовании службы прокси на базе сервера для свойства useProxy установлено значение true, можно также использовать методы HTTP HEAD, OPTIONS, TRACE и DELETE.
Примечание. Вследствие программного ограничения при использовании метода GET служба HTTPService не генерирует понятных пользователю сообщений об ошибках.
Связанные элементы API
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
| channelSet : ChannelSet
Предоставляет доступ к ChannelSet, используемому данной службой. | HTTPService | ||
| concurrency : String
Значение, которое указывает способ обработки нескольких вызовов одной службы. | HTTPService | ||
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| contentType : String
Тип содержимого для запросов служб. | HTTPService | ||
| destination : String
Имя адреса назначения HTTPService в файле services-config.xml. | HTTPService | ||
| headers : Object
Пользовательские заголовки HTTP, передаваемые в конечную точку третьей стороны. | HTTPService | ||
| lastResult : Object [переопределить] [только для чтения]
Результат последнего вызова. | HTTPService | ||
| makeObjectsBindable : Boolean [переопределить]
Если значение равно true, возвращенные анонимные объекты принудительно передаются объектам со свойством bindable. | HTTPService | ||
| method : String
Метод HTTP для передачи запроса. | HTTPService | ||
| operationManager : Function
Это свойство обычно устанавливается кодом инфраструктуры, если требуется изменить поведение вызова службы без изменения способа внешнего вызова этой службы. | AbstractInvoker | |
| request : Object
Объект пар «значение - имя», используемых в качестве параметров URL-адреса. | HTTPService | ||
| requestTimeout : int
Предоставляет доступ к тайм-ауту запроса в секундах для переданных сообщений. | HTTPService | ||
| resultElementType : Class
Аналогично resultType предназначается для определения класса ActionScript, используемого данной операцией, но применяется только в отношении операций, возвращающих результат с несколькими значениями (например, | AbstractInvoker | |
| resultFormat : String
Значение, указывающее способ десериализации возвращаемого результата при вызове HTTP. | HTTPService | ||
| resultType : Class
Указывает дополнительный тип возврата для операции. | AbstractInvoker | |
| rootURL : String
URL-адрес, который должен использоваться объектом службы при вычислении относительных URL-адресов. | HTTPService | ||
| serializationFilter : SerializationFilter
Обеспечивает адаптер, управляющий процессом преобразования тела ответа HTTP в объекты ActionScript и/или преобразования параметров или тела в contentType, URL-адрес и тело оператора POST запроса HTTP. | HTTPService | ||
| showBusyCursor : Boolean
Если значение true, во время выполнения службы отображается курсор в состоянии занятости. | HTTPService | ||
| url : String
Местоположение службы. | HTTPService | ||
| useProxy : Boolean
Указывает, требуется ли использовать службу прокси Flex. | HTTPService | ||
| xmlDecode : Function
Функция ActionScript, используемая для декодирования результата службы из XML. | HTTPService | ||
| xmlEncode : Function
Функция ActionScript используется для кодирования запроса службы в XML. | HTTPService | ||
| Метод | Определено | ||
|---|---|---|---|
Создает новую службу HTTPService. | HTTPService | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
[переопределить]
Отменяет последний вызов службы или вызов с указанным идентификатором. | HTTPService | ||
[переопределить]
Устанавливает для свойства result объекта вызова значение null. | HTTPService | ||
Отключает сетевое подключение службы. | HTTPService | ||
|
Посылает событие в поток событий. | EventDispatcher | |
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
Регистрирует пользователя за пределами адреса назначения. | HTTPService | ||
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
Выполняет запрос службы HTTPService. | HTTPService | ||
Устанавливает учетные данные для адреса назначения, используемого службой. | HTTPService | ||
|
Задает доступность динамического свойства для операций цикла. | Object | |
Имя пользователя и пароль для аутентификации пользователя при переходе по URL-адресу HTTP. | HTTPService | ||
|
Эта функция предоставляется для обновления свойства lastResult. | AbstractInvoker | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
| Событие | Сводка | Определено | ||
|---|---|---|---|---|
| [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным. | EventDispatcher | ||
| [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным. | EventDispatcher | ||
| Отправляется в случае сбоя вызова службы HTTPService. | HTTPService | |||
| Событие вызова запускается при вызове службы HTTPService и длится до выдачи ошибки перед попыткой канала передать сообщение. | HTTPService | |||
| Отправляется в случае успешного возврата вызова службы HTTPService. | HTTPService | |||
| Константа | Определено | ||
|---|---|---|---|
| CONTENT_TYPE_FORM : String = "application/x-www-form-urlencoded" [статические]
Указывает на то, что передаваемые службой HTTP данные кодируются в application/x-www-form-urlencoded. | HTTPService | ||
| CONTENT_TYPE_XML : String = "application/xml" [статические]
Указывает на то, что передаваемые службой HTTP данные кодируются в application/xml. | HTTPService | ||
| DEFAULT_DESTINATION_HTTP : String = "DefaultHTTP" [статические]
Определяет использование объектом службы HTTPService адреса назначения DefaultHTTP. | HTTPService | ||
| DEFAULT_DESTINATION_HTTPS : String = "DefaultHTTPS" [статические]
Определяет использование объектом службы HTTPService адреса назначения DefaultHTTPS. | HTTPService | ||
| ERROR_DECODING : String = "Client.CouldNotDecode" [статические]
Указывает на то, что отформатированный результат XML не может быть переведен в XML-экземпляр или декодирован в объект. | HTTPService | ||
| ERROR_ENCODING : String = "Client.CouldNotEncode" [статические]
Указывает на то, что вводимый параметр не мог быть кодирован в XML. | HTTPService | ||
| ERROR_URL_REQUIRED : String = "Client.URLRequired" [статические]
Указывает на то, что свойство useProxy имеет значение false, но URL-адрес не был введен. | HTTPService | ||
| RESULT_FORMAT_ARRAY : String = "array" [статические]
«Массив» форматов результата схож с «объектом», однако возвращаемое значение всегда определяется следующим образом: если результат, возвращаемый от «объекта» форматов результата, еще не является массивом, этот элемент будет первым элементом нового массива. | HTTPService | ||
| RESULT_FORMAT_E4X : String = "e4x" [статические]
Формат результата e4x указывает на то, что возвращенное значение является XML-экземпляром, к которому можно перейти с помощью ECMAScript для выражений XML (E4X). | HTTPService | ||
| RESULT_FORMAT_FLASHVARS : String = "flashvars" [статические]
Формат результата flashvars указывает на то, что возвращенное значение является текстом, содержащим пары «имя = значение» через амперсанды и при анализе становится объектом ActionScript. | HTTPService | ||
| RESULT_FORMAT_OBJECT : String = "object" [статические]
Формат результата object указывает на то, что возвращаемое значение является XML, но анализируется как дерево объектов ActionScript. | HTTPService | ||
| RESULT_FORMAT_TEXT : String = "text" [статические]
Формат результата text указывает на то, что текст результата HTTPService должен быть необработанной строкой. | HTTPService | ||
| RESULT_FORMAT_XML : String = "xml" [статические]
Формат результата xml указывает на то, что результат должен возвращаться в виде экземпляра flash.xml.XMLNode с указанием на первый нижестоящий документ по отношению к вышестоящему flash.xml.XMLDocument. | HTTPService | ||
channelSet | свойство |
channelSet:ChannelSet| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Предоставляет доступ к ChannelSet, используемому данной службой. ChannelSet может быть создан и присвоен вручную или динамически – для использования настроенных каналов со значением destination этой службы.
Реализация
public function get channelSet():ChannelSet public function set channelSet(value:ChannelSet):voidconcurrency | свойство |
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):voiddestination | свойство |
destination:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Имя адреса назначения HTTPService в файле services-config.xml. Если оно не указано, Flex использует адрес назначения DefaultHTTP. Если используется свойство url, но запросы должны достигать прокси по HTTPS, укажите DefaultHTTPS.
Реализация
public function get destination():String public function set destination(value:String):voidheaders | свойство |
headers:Object| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Пользовательские заголовки HTTP, передаваемые в конечную точку третьей стороны. Если требуется передать несколько заголовков с одним именем, необходимо указать значение как массив.
Реализация
public function get headers():Object public function set headers(value:Object):voidlastResult | свойство |
lastResult:Object [только для чтения] [переопределить] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Результат последнего вызова.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие resultForBinding .
Реализация
override public function get lastResult():ObjectmakeObjectsBindable | свойство |
makeObjectsBindable:Boolean[переопределить] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Если значение равно true, возвращенные анонимные объекты принудительно передаются объектам со свойством bindable.
Реализация
override public function get makeObjectsBindable():Boolean override public function set makeObjectsBindable(value:Boolean):voidmethod | свойство |
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 | свойство |
request:Object| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Объект пар «значение - имя», используемых в качестве параметров URL-адреса. Если свойство contentType определено как application/xml, это документ XML.
Реализация
public function get request():Object public function set request(value:Object):voidrequestTimeout | свойство |
requestTimeout:int| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 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 | свойство |
serializationFilter:SerializationFilter| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Обеспечивает адаптер, управляющий процессом преобразования тела ответа HTTP в объекты ActionScript и/или преобразования параметров или тела в contentType, URL-адрес и тело оператора POST запроса HTTP. Также может быть определен косвенно указанием resultFormat через регистрацию SerializationFilter с помощью статического метода: SerializationFilter.registerFilterForResultFormat ("formatName", filter)
Реализация
public function get serializationFilter():SerializationFilter public function set serializationFilter(value:SerializationFilter):voidshowBusyCursor | свойство |
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 | свойство |
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;
}
Реализация
public function get xmlDecode():Function public function set xmlDecode(value:Function):voidxmlEncode | свойство |
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("");
}
Реализация
public function get xmlEncode():Function public function set xmlEncode(value:Function):voidHTTPService | () | Конструктор |
public function HTTPService(rootURL:String = null, destination:String = null)| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Создает новую службу HTTPService. Если ожидается передача службой с использованием относительных URL-адресов, может потребоваться указание rootURL, на основе которого будет определяться полный URL-адрес (например, Application.application.url).
rootURL:String (default = null) | |
destination:String (default = null) |
cancel | () | метод |
override public function cancel(id:String = null):mx.rpc:AsyncToken| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Отменяет последний вызов службы или вызов с указанным идентификатором. Даже в том случае, если возможность выполнения сетевой операции сохраняется, события результата или ошибки не передаются.
Параметры
id:String (default = null) |
mx.rpc:AsyncToken — AsyncToken, связанный с вызовом, который был отменен или является нулевым (если отмена вызовов не выполнялась).
|
clearResult | () | метод |
override public function clearResult(fireBindingEvent:Boolean = true):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Устанавливает для свойства result объекта вызова значение null. Рекомендуется использовать в случае, если результат является крупным объектом, который больше не используется.
Параметры
fireBindingEvent:Boolean (default = true)true. В противном случае устанавливается значение false. Значением по умолчанию является true
|
disconnect | () | метод |
public function disconnect():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Отключает сетевое подключение службы. Этот метод не ожидает завершения сетевых операций в очереди.
logout | () | метод |
public function logout():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Регистрирует пользователя за пределами адреса назначения. Выход из адреса назначения применяется в отношении всех компонентов подключенных с использованием одного, указанного в конфигурации сервера канала. Например, при подключении по каналу my-rtmp и выходе из системы с помощью одного из компонентов RPC, выполняется выход из системы всех подключенных компонентов my-rtmp.
Примечание. Adobe рекомендует вместо этого метода использовать метод mx.messaging.ChannelSet.logout().
Связанные элементы API
send | () | метод |
public function send(parameters:Object = null):mx.rpc:AsyncToken| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Выполняет запрос службы HTTPService. Эти параметры являются необязательными, но если они указаны, то должны быть объектом, содержащим пары «значение - имя», или объектом XML в зависимости от свойства contentType.
Параметры
parameters:Object (default = null) |
mx.rpc:AsyncToken — Объект, представляющий маркер асинхронного завершения. Этот же объект доступен в свойстве result или fault события token.
|
setCredentials | () | метод |
public function setCredentials(username:String, password:String, charset:String = null):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Устанавливает учетные данные для адреса назначения, используемого службой. Учетные данные применяются ко всем службам, подключенным по одному ChannelSet. Обратите внимание, что службы, использующие прокси для удаленного адреса назначения, должны будут вместо этого выполнить вызов метода setRemoteCredentials().
Параметры
username:String — имя пользователя для адреса назначения.
| |
password:String — пароль для адреса назначения.
| |
charset:String (default = null) |
setRemoteCredentials | () | метод |
public function setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Имя пользователя и пароль для аутентификации пользователя при переходе по URL-адресу HTTP. Они передаются как часть заголовка авторизации HTTP от прокси в конечную точку. Если свойство useProxy имеет значение false, это свойство игнорируется.
Параметры
remoteUsername:String — имя пользователя для передачи в удаленную конечную точку.
| |
remotePassword:String — пароль для передачи в удаленную конечную точку.
| |
charset: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 |
Отправляется в случае сбоя вызова службы HTTPService.
Тип события 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 |
Событие вызова запускается при вызове службы HTTPService и длится до выдачи ошибки перед попыткой канала передать сообщение.
Тип события 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 |
Отправляется в случае успешного возврата вызова службы HTTPService.
Тип события RESULT.Свойства объекта события имеют следующие значения:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | true, preventDefault() из метода связанного маркера responder.result предотвращает передачу этого события операцией или службой |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
message | Сообщение, связанное с этим событием. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
result | Результат, возвращаемый вызовом RPC. |
token | Маркер, представляющий отдельный вызов метода. Используется в образце асинхронного маркера выполнения. |
CONTENT_TYPE_FORM | Константа |
public static const CONTENT_TYPE_FORM:String = "application/x-www-form-urlencoded"| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Указывает на то, что передаваемые службой HTTP данные кодируются в application/x-www-form-urlencoded.
CONTENT_TYPE_XML | Константа |
public static const CONTENT_TYPE_XML:String = "application/xml"| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Указывает на то, что передаваемые службой HTTP данные кодируются в application/xml.
DEFAULT_DESTINATION_HTTP | Константа |
public static const DEFAULT_DESTINATION_HTTP:String = "DefaultHTTP"| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Определяет использование объектом службы HTTPService адреса назначения DefaultHTTP.
DEFAULT_DESTINATION_HTTPS | Константа |
public static const DEFAULT_DESTINATION_HTTPS:String = "DefaultHTTPS"| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Определяет использование объектом службы HTTPService адреса назначения DefaultHTTPS.
ERROR_DECODING | Константа |
public static const ERROR_DECODING:String = "Client.CouldNotDecode"| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Указывает на то, что отформатированный результат XML не может быть переведен в XML-экземпляр или декодирован в объект.
ERROR_ENCODING | Константа |
public static const ERROR_ENCODING:String = "Client.CouldNotEncode"| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Указывает на то, что вводимый параметр не мог быть кодирован в XML.
ERROR_URL_REQUIRED | Константа |
public static const ERROR_URL_REQUIRED:String = "Client.URLRequired"| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Указывает на то, что свойство useProxy имеет значение false, но URL-адрес не был введен.
RESULT_FORMAT_ARRAY | Константа |
public static const RESULT_FORMAT_ARRAY:String = "array"| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
«Массив» форматов результата схож с «объектом», однако возвращаемое значение всегда определяется следующим образом: если результат, возвращаемый от «объекта» форматов результата, еще не является массивом, этот элемент будет первым элементом нового массива.
RESULT_FORMAT_E4X | Константа |
public static const RESULT_FORMAT_E4X:String = "e4x"| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Формат результата e4x указывает на то, что возвращенное значение является XML-экземпляром, к которому можно перейти с помощью ECMAScript для выражений XML (E4X).
RESULT_FORMAT_FLASHVARS | Константа |
public static const RESULT_FORMAT_FLASHVARS:String = "flashvars"| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Формат результата flashvars указывает на то, что возвращенное значение является текстом, содержащим пары «имя = значение» через амперсанды и при анализе становится объектом ActionScript.
RESULT_FORMAT_OBJECT | Константа |
public static const RESULT_FORMAT_OBJECT:String = "object"| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Формат результата object указывает на то, что возвращаемое значение является XML, но анализируется как дерево объектов ActionScript. Это значение по умолчанию.
RESULT_FORMAT_TEXT | Константа |
public static const RESULT_FORMAT_TEXT:String = "text"| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Формат результата text указывает на то, что текст результата HTTPService должен быть необработанной строкой.
RESULT_FORMAT_XML | Константа |
public static const RESULT_FORMAT_XML:String = "xml"| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Формат результата xml указывает на то, что результат должен возвращаться в виде экземпляра flash.xml.XMLNode с указанием на первый нижестоящий документ по отношению к вышестоящему flash.xml.XMLDocument.
Tue Jun 12 2018, 11:34 AM Z