Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: Получение данных с сервера...
Получение данных с сервера...
com.adobe.gravity.utility.async 

IToken  - AS3 ADEP Client Component

Пакетcom.adobe.gravity.utility.async
Интерфейсpublic interface IToken
Средство реализации AggregatingToken, AsyncTokenWrapper, ImmediateFaultToken, ImmediateSuccessToken, Token

Язык версии: ActionScript 3.0
Версия продукта: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
Версии среды выполнения: AIR 1.1, Flash Player 9

IToken objects are returned from functions that initiate asynchronous operations. You are guaranteed that either the fault handlers or the success handlers will be invoked, depending on whether the operation succeeded or failed.

Success handlers take an arbitrary number of parameters. The number and type of the parameters depend on the API that returns the token; the API documentation will generally indicate what to expect. Fault handlers must take a single parameter of type Error.

The asynchronous token concept: the classes in this package implement the asynchronous token concept. Instead of calling asynchronous methods on an object and adding event listeners to that object to learn the result, a token is returned from the asynchronous method and success and fault handlers are added to the token.

For example, in the traditional Flash model one might have:

	 public function addPhotoToLibrary(photoUrl:String, library:PhotoLibrary):void
	 {
	    library.importPhoto(photoUrl);
	    library.addEventHandler(PhotoLibraryEvent.IMPORT_COMPLETE, importCompleteHandler);
	    library.addEventHandler(PhotoLibraryEvent.IMPORT_FAULT, importFaultHandler);
	 }
	 
	 public function importCompleteHandler(event:PhotoLibraryEvent):void
	 {
	    library.removeEventHandler(PhotoLibraryEvent.IMPORT_COMPLETE, importCompleteHandler);
	    library.removeEventHandler(PhotoLibraryEvent.IMPORT_FAULT, importFaultHandler);
	    var photo:IPhoto = event.photo;
	    // now that the photo has been imported, do something else
	 }
	 	
	 public function importFaultHandler(fault:FaultEvent):void
	 {
	 library.removeEventHandler(PhotoLibraryEvent.IMPORT_COMPLETE, importCompleteHandler);
	 library.removeEventHandler(PhotoLibraryEvent.IMPORT_FAULT, importFaultHandler);
	 // deal with the error here
	 }
	 

With a token, the pattern is slightly different:

	 public function addPhotoToLibrary(photoUrl:String, library:PhotoLibrary):void
	 {
	    var token:IToken = library.importPhoto(photoUrl);
	    token.addSuccessHandler(importCompleteHandler);
	    token.addFaultHandler(importFaultHandler);
	 }
	 
	 public function importCompleteHandler(photo:IPhoto):void
	 {
	    // now that the photo has been imported, do something else
	 }
	 
	 public function importFaultHandler(error:Error):void
	 {
	 // deal with the error here
	 }
	 

The benefit of this model is that since the token is associated with a specific invocation of the operation, handlers added to that token will only get invoked for that specific operation invocation.



Общедоступные методы
 МетодОпределено
  
addFaultHandler(handler:Function, weakReference:Boolean = false):void
Add a handler to be called if the operation fails.
IToken
  
addSuccessHandler(handler:Function, weakReference:Boolean = false):void
Add a handler to be called if the operation succeeds.
IToken
  
Remove a fault handler.
IToken
  
Remove a success handler.
IToken
Сведения о методе

addFaultHandler

()метод
public function addFaultHandler(handler:Function, weakReference:Boolean = false):void

Язык версии: ActionScript 3.0
Версия продукта: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
Версии среды выполнения: AIR 1.1, Flash Player 9

Add a handler to be called if the operation fails.

Параметры

handler:Function — A function to be called if the operation fails.
 
weakReference:Boolean (default = false) — Use a weak reference to hold onto the handler.

addSuccessHandler

()метод 
public function addSuccessHandler(handler:Function, weakReference:Boolean = false):void

Язык версии: ActionScript 3.0
Версия продукта: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
Версии среды выполнения: AIR 1.1, Flash Player 9

Add a handler to be called if the operation succeeds.

Параметры

handler:Function — A function to be called if the operation succeeds.
 
weakReference:Boolean (default = false) — Use a weak reference to hold onto the handler.

removeFaultHandler

()метод 
public function removeFaultHandler(handler:Function):void

Язык версии: ActionScript 3.0
Версия продукта: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
Версии среды выполнения: AIR 1.1, Flash Player 9

Remove a fault handler.

Параметры

handler:Function — The handler to be removed.

removeSuccessHandler

()метод 
public function removeSuccessHandler(handler:Function):void

Язык версии: ActionScript 3.0
Версия продукта: Adobe Digital Enterprise Platform Experience Services - Client Component Framework 10
Версии среды выполнения: AIR 1.1, Flash Player 9

Remove a success handler.

Параметры

handler:Function — The handler to remove.





[ X ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.