ГлавнаяСправка по использованию серверного ActionScript › Класс WebService

Класс WebService

Класс WebService: Методы и свойства

Доступно с версии сервера

Flash Media Server 2

Описание

Класс WebService используется для создания и доступа к веб-сервисам WSDL/SOAP. Во Flash Media Interactive Server несколько классов включают в себя функциональные возможности веб сервисов: класс WebService, класс SOAPFault, класс SOAPCall и класс Log.

Примечание: Класс WebService не в состоянии принимать сложные типы данных или массивы, возвращаемые веб сервисами. Класс WebService не поддерживает и возможностей безопасности.

Следующие шаги обрисовывают в общих чертах процесс создания и доступа к веб-сервису.

Создание веб-сервиса и получение к нему доступа:

  1. Загрузить класс WebServices:

    load("webservices/WebServices.asc");
  2. Подготовка местоположения WSDL:

    var wsdlURI = "http://www.flash-db.com/services/ws/companyInfo.wsdl";
  3. Создание экземпляра объекта веб сервиса используя местоположение WSDL:

    stockService = new WebService(wsdlURI);
  4. (Необязательное) Посредством обработчика событий WebService.onLoad() контролируем анализ WSDL и создание экземпляра объекта веб-сервиса:

    // контролируем событие загрузки WSDL. 
    stockService.onLoad = function(wsdl){ 
        wsdlField.text = wsdl; 
    }
  5. (Необязательное) Если WSDL не загружается, контролируем сбой:

    // Если в процессе загрузки WSDL происходит сбой, срабатывает обработчик событий onFault. 
    stockService.onFault = function(fault){ 
        wsdlField.text = fault.faultstring; 
    }
  6. (Необязательное) Добавление заголовков SOAP:

    // если заголовки являются обязательными, они добавляются следующим способом: 
    var myHeader = new XML(headerSource); 
    stockService.addHeader(myHeader);
  7. Вызываем операцию веб сервиса:

    // Вызовы метода возвращают асинхронный возврат (callback). 
    callback = stockService.doCompanyInfo("anyuser", "anypassword", "ADBE"); 
    // NOTE: callback является неопределенным (undefined) если сам сервис не создан 
    // (а так же срабатывает service.onFault).
  8. Контролируем либо же выданный результат или же ошибку в случаи сбоя вызова:

    // Контролируем успешно принятый результат. 
    callback.onResult = function(result){ 
        // Получаем результат SOAP, который в этом случаи является
        // структурой преобразованной из последовательной формы в параллельную (deserialized) (объект ActionScript). 
        for (var i in result){ 
                 trace(i +" : " +result[i]); 
        } 
    } 
    // Контролируем результат ошибки. 
    callback.onFault = function(fault){ 
        // Перехватываем сбой SOAP и управляем им  
        // в соответствии с нуждами приложения. 
        for (var i in fault){ 
            trace(i +" : " +fault[i]); 
        } 
    }

Краткое описание обработчиков событий

Обработчик событий

Описание

WebService.onFault()

Срабатывает когда в процессе анализа WSDL возникает ошибка.

WebService.onLoad()

Срабатывает когда веб-сервис успешно загрузил и проанализировал файл WSDL.

Ярлыки: , ,

  1. Пока без комментариев.
  1. Пока нету.