| Пакет | mx.rpc.soap.mxml |
| Класс | public dynamic class WebService |
| Наследование | WebService  WebService AbstractWebService AbstractService Proxy |
| Реализует | IMXMLSupport, IMXMLObject |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Показать синтаксис MXML
Скрыть синтаксис MXMLThe <mx:WebService> tag accepts the following tag attributes:
<mx:WebService Properties concurrency="multiple|single|last" destination="No default." id="No default." serviceName="No default." showBusyCursor="false|true" makeObjectsBindable="false|true" useProxy="false|true" wsdl="No default." Events fault="No default." result="No default." />
An <mx:WebService> tag can have multiple <mx:operation> tags, which have the following tag attributes:
<mx:operation Properties concurrency="multiple|single|last" name=No default, required. resultFormat="object|xml|e4x" makeObjectsBindable="false|true" Events fault=No default. result=No default. />An <mx:Operation> tag contains an <mx:request> tag. To specify an XML structure in an <mx:request> tag, you must set the value of the tag's
format attribute to "xml". Otherwise, the body is converted into Objects.
Общедоступные свойства
| Свойство | Определено | ||
|---|---|---|---|
 | channelSet : ChannelSet
Предоставляет доступ к ChannelSet, используемому данной службой. | AbstractService | |
| concurrency : String
Значение, которое указывает способ обработки нескольких вызовов одной службы. | WebService | ||
| convertParametersHandler : Function
Дополнительная функция, предназначенная, главным образом, для разработчиков инфраструктуры, которые должны установить функцию для вызова с параметрами, передаваемыми в каждый вызов операции web-службы. | AbstractWebService | |
| convertResultHandler : Function
Дополнительная функция, предназначенная, прежде всего, для разработчиков инфраструктуры, которые должны установить функцию для обработки результатов операции перед уведомлением обработчиков результатов. | AbstractWebService | |
| description : String
Описание службы для активного в настоящее время порта. | AbstractWebService | |
| destination : String [переопределить]
Адрес назначения службы. | AbstractWebService | |
| endpointURI : String
Местоположение WebService. | AbstractWebService | |
| headers : Array [только для чтения]
Возвращает массив SOAPHeaders, зарегистрированный для WebService. | AbstractWebService | |
| httpHeaders : Object
Пользовательские заголовки HTTP, передаваемые в конечную точку SOAP. | AbstractWebService | |
| makeObjectsBindable : Boolean
Если значение равно true, возвращенные анонимные объекты принудительно передаются объектам со свойством bindable. | AbstractWebService | |
| managers : Array
Свойство managers используется для хранения списка менеджеров данных, которые изменяют поведение этой службы. | AbstractService | |
| operations : Object
Массив операций обычно устанавливается только компилятором MXML при создании службы посредством тега MXML. | AbstractService | |
| port : String
Указывает порт в документе WSDL, который должен использовать этот WebService. | AbstractWebService | |
| protocol : String Устаревший: Используйте channelSet [только для записи]
Устарело, используйте вместо этого соответствующий адрес назначения, либо DefaultHTTP или DefaultHTTPS (при использовании URL-адреса). | WebService | ||
| ready : Boolean [только для чтения]
Определяет готовность WebService к созданию запросов. | AbstractWebService | |
| requestTimeout : int
Предоставляет доступ к тайм-ауту запроса в секундах для переданных сообщений. | AbstractService | |
| rootURL : String
URL для использования WebService при вычислении относительных URL. | AbstractWebService | |
| service : String
Указывает службу в документе WSDL для использования в данной службе WebService. | AbstractWebService | |
| serviceName : String Устаревший: Используйте destination | WebService | ||
| showBusyCursor : Boolean
Если значение true, во время выполнения службы отображается курсор в состоянии занятости. | WebService | ||
| useProxy : Boolean
Указывает, требуется ли использовать службу прокси Flex. | AbstractWebService | |
| wsdl : String
Местоположение документа WSDL для WebService. | WebService | |
| xmlSpecialCharsFilter : Function
Пользовательская функция, которая используется для экранирования специальных символов XML перед кодированием любого простого содержимого. | AbstractWebService | |
Общедоступные методы
| Метод | Определено | ||
|---|---|---|---|
WebService(destination:String = null)
Создает новый компонент WebService. | WebService | ||
|
Добавляет заголовок, применимый ко всем операциям этой web-службы. | AbstractWebService | |
| addSimpleHeader(qnameLocal:String, qnameNamespace:String, headerName:String, headerValue:String):void
Добавляет заголовок, применимый ко всем операциям WebService. | AbstractWebService | |
|
Возвращает логическое значение, которое определяет готовность WebService загрузить WSDL (наличие допустимого адреса назначения или указанного wsdl). | WebService | |
|
Очищает заголовки, применимые ко всем операциям. | AbstractWebService | |
|
Разъединяет сетевое подключение службы и удаляет любые ответчики для запросов в очереди. | AbstractService | |
|
Возвращает заголовок, если найденное соответствие основано на значениях QName, localName и URI. | AbstractWebService | |
[переопределить]
Возвращает операцию для данного имени. | WebService | ||
|
Вызов для инициализации службы. | AbstractService | |
Вызывается автоматически компилятором MXML, если настройка WebService выполнена с использованием тега. | WebService | ||
|
Предоставляет для WebService инструкции по загрузке документа WSDL. | WebService | |
|
Регистрирует пользователя за пределами адреса назначения. | AbstractService | |
|
Удаляет заголовок с данным QName из всех операций. | AbstractWebService | |
|
Устанавливает учетные данные для адреса назначения, к которому обращалась служба при использовании Data Services на стороне сервера. | AbstractService | |
| [переопределить]
Имя пользователя и пароль для аутентификации пользователя при получении доступа к web-службе. | AbstractWebService | |
|
Представляет экземпляр WebService в виде строки с описанием важных свойств, например идентификатора адреса назначения или присвоенного набора каналов. | WebService | |
События
Общедоступные константы
Сведения о свойстве
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):voidprotocol | свойство |
protocol:String [только для записи] Устаревший: Используйте channelSet
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Устарело, используйте вместо этого соответствующий адрес назначения, либо DefaultHTTP или DefaultHTTPS (при использовании URL-адреса). При устаревшем поведении адрес назначения обновляется, если используется значение по умолчанию.
Реализация
public function set protocol(value:String):voidserviceName | свойство |
serviceName:StringУстаревший: Используйте destination
Реализация
public function get serviceName():String public function set serviceName(value:String):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):voidСведения о конструкторе
WebService | () | Конструктор |
public function WebService(destination:String = null)| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Создает новый компонент WebService.
Параметрыdestination:String (default = null) |
Сведения о методе
getOperation | () | метод |
override public function getOperation(name:String):AbstractOperation| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает операцию для данного имени. Если операция не была создана заранее, в течение этого вызова создается новая операция mx.rpc.soap.mxml.Operation. Как правило, доступ к операции можно получить путем простого указания ее имени после переменной службы (myService.someOperation), но если имя операции совпадает с определенным методом в службе (например, setCredentials), то для обращения к операции можно использовать этот метод.
Параметры
name:String — Имя операции.
|
AbstractOperation — Операция, которая выполняется для этого имени.
|
initialized | () | метод |
public function initialized(document:Object, id:String):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Вызывается автоматически компилятором MXML, если настройка WebService выполнена с использованием тега. При создании WebService через ActionScript может потребоваться вызвать этот метод самостоятельно, поскольку его использование рекомендуется для выполнения проверки правильности любых аргументов.
Параметры
document:Object — MXML-документ, в котором находится WebService.
| |
id:String — идентификатор WebService в документе.
|
Примеры Использование этого примера
WebServiceExample.mxml
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the WebService tag. -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:s="library://ns.adobe.com/flex/spark"
xmlns:mx="library://ns.adobe.com/flex/mx">
<!-- Make sure the Flex Data Services proxy-config.xml file contains
the following definition:
<destination id="DefaultHTTP">
<properties>
<dynamic-url>http://ws.invesbot.com</dynamic-url>
</properties>
</destination>
-->
<fx:Script>
<![CDATA[
import mx.controls.Alert;
]]>
</fx:Script>
<fx:Declarations>
<mx:WebService id="WS" wsdl="http://ws.invesbot.com/stockquotes.asmx?WSDL"
useProxy="true"
fault="Alert.show(event.fault.faultString), 'Error'">
<mx:operation name="GetQuote" resultFormat="object">
<mx:request>
<symbol>{stockSymbol.text}</symbol>
</mx:request>
</mx:operation>
</mx:WebService>
</fx:Declarations>
<mx:Panel title="WebService Example" height="75%" width="75%"
paddingTop="10" paddingBottom="10" paddingLeft="10" paddingRight="10">
<mx:Label width="100%" color="blue"
text="Enter a stock symbol to obtain a quote."/>
<mx:TextInput id="stockSymbol" text="ADBE"/>
<mx:Button label="Get Quote" click="WS.GetQuote.send()"/>
<mx:Text htmlText="Company: {WS.GetQuote.lastResult.GetQuoteResult.StockQuote.Company}"/>
<mx:Text htmlText="Current price: ${WS.GetQuote.lastResult.GetQuoteResult.StockQuote.Price}"/>
</mx:Panel>
</s:Application>
Tue Jun 12 2018, 11:34 AM Z