mx.data.mxml

# ManagedRemoteService - AS3 ADEP Data Services

Package | mx.data.mxml
Class | public dynamic class ManagedRemoteService
Inheritance | ManagedRemoteService ManagedRemoteService AbstractService Proxy
Implements | IMXMLObject

Language Version: | ActionScript 3.0

Product Version: | Adobe Digital Enterprise Platform Data Services for Java EE 4.5

Runtime Versions: | Flash Player 10.1, AIR 2.0

The ManagedRemoteService class provides the top-level client-side functionality for the ADEP Data Services Managed Remoting. This is an MXML-specific subclass of mx.data.ManagedRemoteService that allows binding to the properties of a ManagedRemoteService instance.

Note: The `destination` property must be set before using a ManagedRemoteService object.

MXML Syntax Show MXML Syntax
Hide MXML Syntax

The <mx:ManagedRemoteService> tag accepts the following tag attributes:

      <mx:ManagedRemoteService
       Properties
       id="No default."
       destination="No default."
       channelSet=No default"
       concurrency="multiple"
       convertParametersHandler="No Default"
       convertResultHandler="No Default"
       requestTimeout="-1"
       showBusyCursor="false"
       throwItemPendingErrors="true"
       verifyEntityClasses="true"

       Events
       conflict="No default."
       fault="No default."
       invoke="No default."
       message="No default."
       result="No default."
     />

Related API Elements

mx.data.ManagedRemoteService

Public Properties
Hide Inherited Public Properties
Show Inherited Public Properties

| Property | Defined By
--- | --- | ---
|  | channelSet : ChannelSet Provides access to the ChannelSet used by the service. | AbstractService
|  | concurrency : String Value that indicates how to handle multiple calls to the same service. | ManagedRemoteService
|  | convertParametersHandler : Function An optional function, primarily intended for framework developers who need to install a function to get called with the parameters passed to each remote object invocation. | ManagedRemoteService
|  | convertResultHandler : Function An optional function, primarily intended for framework developers who need to install a hook to process the results of an operation before notifying the result handlers. | ManagedRemoteService
|  | destination : String [override] Provides access to the destination for the MessageAgent. | ManagedRemoteService
|  | managers : Array [override] Not supportted by Managed Remoting. | ManagedRemoteService
|  | operations : Object The Operations array is usually only set by the MXML compiler if you create a service using an MXML tag. | AbstractService
|  | requestTimeout : int Provides access to the request timeout in seconds for sent messages. | AbstractService
|  | showBusyCursor : Boolean If true, a busy cursor is displayed while a service is executing. | ManagedRemoteService
|  | throwItemPendingErrors : Boolean Set this property to false if you want to suppress item pending errors when lazily fetched or unpaged data is accessed. | ManagedRemoteService
|  | verifyEntityClasses : Boolean If true, verify that all managed entities are present. | ManagedRemoteService

Public Methods
Hide Inherited Public Methods
Show Inherited Public Methods

| Method | Defined By
--- | --- | ---
|  | ManagedRemoteService(dest:String = null) Constructs an instance of the ManagedRemoteService with the specified destination. | ManagedRemoteService
|  | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [override] Add an event listener to the service. | ManagedRemoteService
|  | commitRequiredOn(item:Object):Boolean Indicates if there are pending changes for this particular object. | ManagedRemoteService
|  | disconnect():void Disconnects the service's network connection and removes any pending request responders. | AbstractService
|  | getOperation(name:String):AbstractOperation [override] Returns an Operation of the given name. | ManagedRemoteService
|  | initialize():void Called to initialize the service. | AbstractService
|  | initializeService():mx.rpc:AsyncToken Force initialization of the Managed Remote Service. | ManagedRemoteService
|  | logout():void [override] Log the user out of the destination for the service and releases all managed collections and items. | ManagedRemoteService
|  | releaseCollection(view:ListCollectionView, clear:Boolean = false, copyStillManagedItems:Boolean = true):void Releases the specified collection from management by the underlying DataService. | ManagedRemoteService
|  | releaseItem(item:IManaged, dontClearStillManagedItems:Boolean = true, copyStillManagedItems:Boolean = true):IManaged Releases the specified item from management by the underlying DataService. | ManagedRemoteService
|  | removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void [override] Remove specified listener from the service. | ManagedRemoteService
|  | revertChanges(item:IManaged = null):Boolean This will undo any changes to the specified item and remove those changes from the cache. | ManagedRemoteService
|  | setCredentials(username:String, password:String, charset:String = null):void [override] Sets the credentials for the destination accessed by the service when using Managed Remoting on the server side. | ManagedRemoteService
|  | setPageSizeForOperation(operationName:String, pageSize:int):void Set the pageSize for the specified named operation. | ManagedRemoteService
|  | setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void [override] Sets the credentials for the third party of this Managed Remoting destination. | ManagedRemoteService
|  | toString():String Represents an instance of MangedRemoteService as a String, describing important properties such as the destination id and the set of channels assigned. | ManagedRemoteService

Events
Click for more information on events
Hide Inherited Events
Show Inherited Events

| Event | Summary | Defined By
--- | --- | --- | ---
|  | conflict | The DataConflictEvent.CONFLICT event is dispatched when a conflict is detected between pending local changes and changes submitted by another client, or when changes submitted by this client conflict with those in the remote destination. | ManagedRemoteService
|  | fault | The DataServiceFaultEvent.FAULT event is dispatched when a service call fails due to an error. | ManagedRemoteService
|  | invoke | The invoke event is dispatched when a service Operation is invoked so long as an Error is not thrown before the Channel attempts to send the message. | AbstractService
|  | message | The MessageEvent.MESSAGE event is dispatched when the remote destination pushes a notification of a data operation. | ManagedRemoteService
|  | result | The ResultEvent.RESULT event is dispatched when a service call successfully returns. | ManagedRemoteService

Constructor Detail

### ManagedRemoteService

()
Constructor

`public function ManagedRemoteService(dest:String = null)`

Language Version: | ActionScript 3.0

Product Version: | Adobe Digital Enterprise Platform Data Services for Java EE 4.5

Runtime Versions: | Flash Player 10.1, AIR 2.0

Constructs an instance of the ManagedRemoteService with the specified destination. The destination must be a reference to a destination configured in the services-config.xml file.

Parameters

| `dest:String` (default = `null`)`` — String that contains the name of the remote destination this service will connect to.

© 2015 Adobe Systems Incorporated. All rights reserved.
Mon Apr 10 2017, 12:28 PM -07:00