AbstractOperation

Pacchetto	mx.rpc.http
Classe	public class AbstractOperation
Ereditarietà	AbstractOperation AbstractOperation AbstractInvoker EventDispatcher Object
Sottoclassi	Operation

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

An Operation used specifically by HTTPService or HTTPMultiService. An Operation is an individual operation on a service usually corresponding to a single operation on the server side. An Operation can be called either by invoking the function of the same name on the service or by accessing the Operation as a property on the service and calling the send(param1, param2) method. HTTP services also support a sendBody method which allows you to directly specify the body of the HTTP response. If you use the send(param1, param2) method, the body is typically formed by combining the argumentNames property of the operation with the parameters sent. An Object is created which uses the argumentNames[i] as the key and the corresponding parameter as the value.

The exact way in which the HTTP operation arguments is put into the HTTP body is determined by the serializationFilter used.

Proprietà pubbliche

Nascondi proprietà pubbliche ereditate

Mostra proprietà pubbliche ereditate

	Proprietà		Definito da
		argumentNames : Array An ordered list of the names of the arguments to pass to a method invocation.	AbstractOperation
		arguments : Object The arguments to pass to the Operation when it is invoked.	AbstractOperation
		concurrency : String Value that indicates how to handle multiple calls to the same service.	AbstractOperation
		constructor : Object Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.	Object
		contentType : String Type of content for service requests.	AbstractOperation
		headers : Object Custom HTTP headers to be sent to the third party endpoint.	AbstractOperation
		lastResult : Object [sola lettura] The result of the last invocation.	AbstractInvoker
		makeObjectsBindable : Boolean When this value is true, anonymous objects returned are forced to bindable objects.	AbstractInvoker
		method : String HTTP method for sending the request.	AbstractOperation
		name : String The name of this Operation.	AbstractOperation
		operationManager : Function This property is set usually by framework code which wants to modify the behavior of a service invocation without modifying the way in which the service is called externally.	AbstractInvoker
		properties : Object This is a hook primarily for framework developers to register additional user specified properties for your operation.	AbstractOperation
		request : Object Object of name-value pairs used as parameters to the URL.	AbstractOperation
		requestTimeout : int Provides access to the request timeout in seconds for sent messages.	AbstractOperation
		resultElementType : Class Like resultType, used to define the ActionScript class used by a given operation though this property only applies to operations which return a multi-valued result (e.g.	AbstractInvoker
		resultFormat : String Value that indicates how you want to deserialize the result returned by the HTTP call.	AbstractOperation
		resultType : Class Specifies an optional return type for the operation.	AbstractInvoker
		rootURL : String The URL that the HTTPService object should use when computing relative URLs.	AbstractOperation
		serializationFilter : SerializationFilter A SerializationFilter can control how the arguments are formatted to form the content of the HTTP request.	AbstractOperation
		service : AbstractService [sola lettura] Provides convenient access to the service on which the Operation is being invoked.	AbstractOperation
		showBusyCursor : Boolean If true, a busy cursor is displayed while a service is executing.	AbstractOperation
		url : String Location of the service.	AbstractOperation
		useProxy : Boolean Specifies whether to use the Flex proxy service.	AbstractOperation
		xmlDecode : Function ActionScript function used to decode a service result from XML.	AbstractOperation
		xmlEncode : Function ActionScript function used to encode a service request as XML.	AbstractOperation

Metodi pubblici

Nascondi metodi pubblici ereditati

Mostra metodi pubblici ereditati

	Metodo		Definito da
		AbstractOperation(service:AbstractService = null, name:String = null) Creates a new Operation.	AbstractOperation
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento.	EventDispatcher
		cancel(id:String = null):mx.rpc:AsyncToken Cancels the last service invocation or an invokation with the specified ID.	AbstractInvoker
		clearResult(fireBindingEvent:Boolean = true):void Sets the result property of the invoker to null.	AbstractInvoker
		dispatchEvent(event:Event):Boolean Invia un evento nel flusso di eventi.	EventDispatcher
		hasEventListener(type:String):Boolean Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica se per un oggetto è definita una proprietà specifica.	Object
		isPrototypeOf(theClass:Object):Boolean Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.	Object
		propertyIsEnumerable(name:String):Boolean Indica se la proprietà specificata esiste ed è enumerabile.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Rimuove un listener dall'oggetto EventDispatcher.	EventDispatcher
		send(... args):mx.rpc:AsyncToken Executes the method.	AbstractOperation
		sendBody(parameters:Object):mx.rpc:AsyncToken	AbstractOperation
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.	Object
		setResult(result:Object):void This hook is exposed to update the lastResult property.	AbstractInvoker
		toLocaleString():String Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.	Object
		toString():String Restituisce la rappresentazione in formato stringa dell'oggetto specificato.	Object
		valueOf():Object Restituisce il valore di base dell'oggetto specificato.	Object
		willTrigger(type:String):Boolean Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato.	EventDispatcher

Metodi protetti

	Metodo		Definito da
		getHeaders():Object Returns the HTTP request headers.	AbstractOperation
		getSerializationFilter():SerializationFilter Returns the serialization filter.	AbstractOperation

Eventi

Fate clic per visualizzare altre informazioni sugli eventi

Nascondi eventi ereditati

Mostra eventi ereditati

	Riepilogo	Definito da
activate	[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR ottiene lo stato di attivazione del sistema operativo ed entra nello stato attivo.	EventDispatcher
deactivate	[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo.	EventDispatcher
fault	Dispatched when an Operation call fails.	AbstractOperation
result	Dispatched when an Operation invocation successfully returns.	AbstractOperation

Descrizione delle proprietà

argumentNames

proprietà

public var argumentNames:Array

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

An ordered list of the names of the arguments to pass to a method invocation. Since the arguments object is a hashmap with no guaranteed ordering, this array helps put everything together correctly. It will be set automatically by the MXML compiler, if necessary, when the Operation is used in tag form.

concurrency

proprietà

concurrency:String

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

Value that indicates how to handle multiple calls to the same service. The default value is multiple. The following values are permitted:

multiple Existing requests are not cancelled, and the developer is responsible for ensuring the consistency of returned data by carefully managing the event stream. This is the default value.
single Only a single request at a time is allowed on the operation; multiple requests generate a fault.
last Making a request cancels any existing request.

Implementazione
public function get concurrency():String
public function set concurrency(value:String):void

contentType

proprietà

contentType:String

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

Type of content for service requests. The default is application/x-www-form-urlencoded which sends requests like a normal HTTP POST with name-value pairs. application/xml send requests as XML.

Implementazione
public function get contentType():String
public function set contentType(value:String):void

headers

proprietà

public var headers:Object

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

Custom HTTP headers to be sent to the third party endpoint. If multiple headers need to be sent with the same name the value should be specified as an Array.

method

proprietà

method:String

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

HTTP method for sending the request. Permitted values are GET, POST, HEAD, OPTIONS, PUT, TRACE and DELETE. Lowercase letters are converted to uppercase letters. The default value is GET.

Implementazione
public function get method():String
public function set method(value:String):void

request

proprietà

public var request:Object

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

Object of name-value pairs used as parameters to the URL. If the contentType property is set to application/xml, it should be an XML document.

requestTimeout

proprietà

requestTimeout:int

Versione linguaggio:

ActionScript 3.0

Versioni prodotto:

BlazeDS 4, Adobe Digital Enterprise Platform Data Services per Java EE 3

Versioni runtime:

Flash Player 9, AIR 1.1

Provides access to the request timeout in seconds for sent messages. If an acknowledgement, response or fault is not received from the remote destination before the timeout is reached the message is faulted on the client. A value less than or equal to zero prevents request timeout.

Implementazione
public function get requestTimeout():int
public function set requestTimeout(value:int):void

resultFormat

proprietà

resultFormat:String

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

Value that indicates how you want to deserialize the result returned by the HTTP call. The value for this is based on the following:

Whether you are returning XML or name/value pairs.
How you want to access the results; you can access results as an object, text, or XML.

The default value is object. The following values are permitted:

object The value returned is XML and is parsed as a tree of ActionScript objects. This is the default.
array The value returned is XML and is parsed as a tree of ActionScript objects however if the top level object is not an Array, a new Array is created and the result set as the first item. If makeObjectsBindable is true then the Array will be wrapped in an ArrayCollection.
xml The value returned is XML and is returned as literal XML in an ActionScript XMLnode object.
flashvars The value returned is text containing name=value pairs separated by ampersands, which is parsed into an ActionScript object.
text The value returned is text, and is left raw.
e4x The value returned is XML and is returned as literal XML in an ActionScript XML object, which can be accessed using ECMAScript for XML (E4X) expressions.

Implementazione
public function get resultFormat():String
public function set resultFormat(value:String):void

rootURL

proprietà

rootURL:String

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

The URL that the HTTPService object should use when computing relative URLs. This property is only used when going through the proxy. When the useProxy property is set to false, the relative URL is computed automatically based on the location of the SWF running this application. If not set explicitly rootURL is automatically set to the URL of mx.messaging.config.LoaderConfig.url.

Implementazione
public function get rootURL():String
public function set rootURL(value:String):void

serializationFilter

proprietà

public var serializationFilter:SerializationFilter

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

A SerializationFilter can control how the arguments are formatted to form the content of the HTTP request. It also controls how the results are converted into ActionScript objects. It can be set either explicitly using this property or indirectly using the resultFormat property.

showBusyCursor

proprietà

showBusyCursor:Boolean

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

If true, a busy cursor is displayed while a service is executing. The default value is false.

Implementazione
public function get showBusyCursor():Boolean
public function set showBusyCursor(value:Boolean):void

url

proprietà

url:String

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

Location of the service. If you specify the url and a non-default destination, your destination in the services-config.xml file must allow the specified URL.

Implementazione
public function get url():String
public function set url(value:String):void

useProxy

proprietà

useProxy:Boolean

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

Specifies whether to use the Flex proxy service. The default value is false. If you do not specify true to proxy requests though the Flex server, you must ensure that the player can reach the target URL. You also cannot use destinations defined in the services-config.xml file if the useProxy property is set to false.

Il valore predefinito è false.

Implementazione
public function get useProxy():Boolean
public function set useProxy(value:Boolean):void

xmlDecode

proprietà

public var xmlDecode:Function

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

ActionScript function used to decode a service result from XML. When the resultFormat is an object and the xmlDecode property is set, Flex uses the XML that the HTTPService returns to create an Object. If it is not defined the default XMLDecoder is used to do the work.

The function referenced by the xmlDecode property must take a flash.xml.XMLNode object as a parameter and should return an Object. It can return any type of object, but it must return something. Returning null or undefined causes a fault.

The following example shows an <mx:HTTPService> tag that specifies an xmlDecode function:

   <mx:HTTPService id="hs" xmlDecode="xmlDecoder" url="myURL" resultFormat="object" contentType="application/xml">
        <mx:request><source/>
            <obj>{RequestObject}</obj>
        </mx:request>
   </mx:HTTPService>

The following example shows an xmlDecoder function:

function xmlDecoder (myXML)
{
 // Simplified decoding logic.
 var myObj = {};
 myObj.name = myXML.firstChild.nodeValue;
 myObj.honorific = myXML.firstChild.attributes.honorific;
 return myObj;
}

xmlEncode

proprietà

public var xmlEncode:Function

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

ActionScript function used to encode a service request as XML. When the contentType of a request is application/xml and the request object passed in is an Object, Flex attempts to use the function specified in the xmlEncode property to turn it into a flash.xml.XMLNode object If the xmlEncode property is not set, Flex uses the default XMLEncoder to turn the object graph into a flash.xml.XMLNode object.

The xmlEncode property takes an Object and should return a flash.xml.XMLNode object. In this case, the XMLNode object can be a flash.xml.XML object, which is a subclass of XMLNode, or the first child of the flash.xml.XML object, which is what you get from an <mx:XML> tag. Returning the wrong type of object causes a fault. The following example shows an <mx:HTTPService> tag that specifies an xmlEncode function:

  <mx:HTTPService id="hs" xmlEncode="xmlEncoder" url="myURL" resultFormat="object" contentType="application/xml">
        <mx:request><source/>
            <obj>{RequestObject}</obj>
        </mx:request>
   </mx:HTTPService>

The following example shows an xmlEncoder function:

function xmlEncoder (myObj)
{
  return new XML("");
}

Descrizione della funzione di costruzione

()

Funzione di costruzione

public function AbstractOperation(service:AbstractService = null, name:String = null)

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3 Creates a new Operation.

Versioni runtime:

Flash Player 9, AIR 1.1

Creates a new Operation.

Parametri

	`service:AbstractService` (default = `null`) — The object defining the type of service, such as HTTPMultiService, WebService, or RemoteObject.

	`name:String` (default = `null`) — The name of the service.

Descrizione dei metodi

getHeaders

()

metodo

protected function getHeaders():Object

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

Returns the HTTP request headers. Subclasses can override this method to control the retrieval of the HTTP request headers.

Restituisce

Object — The HTTP request headers.

getSerializationFilter

()

metodo

protected function getSerializationFilter():SerializationFilter

Returns the serialization filter. Subclasses can override this method to control the retrieval of the HTTP request headers.

Restituisce

SerializationFilter — The serialization filter.

sendBody

()

metodo

public function sendBody(parameters:Object):mx.rpc:AsyncToken

Parametri

parameters:Object

Restituisce

mx.rpc:AsyncToken

Note legali | Informativa sulla privacy online

AbstractOperation - AS3 Flex

Classi x

argumentNames

concurrency

contentType

headers

method

request

requestTimeout

resultFormat

rootURL

serializationFilter

showBusyCursor

url

useProxy

xmlDecode

xmlEncode