RPCDataServiceAdapter  - AS3 ADEP Data Services

An abstract method which returns an AsyncRequest that is used to handle all DataService operations. By overriding the AsyncRequest.invoke method you can intercept managed requests. The AsyncRequest class also exposes the various methods for determining if the service is connected or disconnected.

Static map from destination name to data manager for that destination.

Name of destination for this data service adapter.

This controls whether or not DMS wraps the items into a serialization descriptor which excludes the associations. The MessagingDataServiceAdapter will use this approach for sending associations - not used in the RPCDataServiceAdapter.

Returns false because this data manager does not throw an error if there is a fault with no listeners on the data manager. For RPC servies, those errors are proxied to listeners on the service and so throwing the error is not appropriate.

This method gets called after a fault which might determine a conflict. In the fault handler for that fault, issue a getItem() call to retrieve the server's current version of the item.

One reason you might want to override this method is if you need to take action after no conflict is detected.

매개 변수

This method is called by the RPCDataServiceAdapter when it needs to perform the createItem operation. The default implementation is to invoke the managed operation registered for the createItem operation using the item as the first parameter. If you need to invoke more than one service or change the parameter signature for this operation, you can extend the RPCDataServiceAdapter and override this createItem method.

매개 변수

This is called by the RPCDataServiceAdapter when the management layer wants to delete an item from the server. The item to be deleted is provided as an argument. The default implementation of this method looks for a ManagedOperation of type="delete". That method is called with the item to be deleted, or the id of the item to be deleted if the parameters of the ManagedOperation is set to "id".

매개 변수

Called when the adapter needs to execute a named query. If paging is enabled, this will fetch the first page in the collection.

매개 변수

Returns an array of property names that conflict between the client's version of an item and the server's version. Returns null if there are no conflicts.

매개 변수

Finds the data manager for a specified destination.

매개 변수

Called to retrieve an individual item by identity from the adapter. The includeSpecifier parameter specifies the set of properties requested.

매개 변수

Adapter method called when a list of items for a specific destination need to be fetched. The PropertySpecifier indicates the minimum set of properties needed. The default implementation of this method is to call the getItem method repeatedly. If your server can perform this operation more efficiently it may improve some operations to implement this method.

매개 변수

This gets called after we've finished processing a fault of a create, update, delete, or update collection operation. It is an adapter's chance to customize logic associated with the error handling and check for conflicts. The default implementation implements the RPCDataManager conflictMode feature. When it gets a fault for an UPDATE or DELETE operation, it compares the current server version against the original version of the updated/deleted object. If the server version is different, we raise that as a conflict. This assumes that the faulting change has already been put back into the uncommitted batch of changes.

매개 변수

This method actually performs the getItem operation but the result handler will not be used to update the managed result. This method is used by the default getItem implementation to invoke the operation. When conflict detection is enabled, after a fault is received for an update or delete operation, this method is called to retrieve the current server version of the object so we can see if the fault was an indication a conflict and to get the current server version so we can resolve that conflict.

매개 변수

Perform a query for a single page of a client side query. This method is called when pagingEnabled is set on a ManagedQuery. The client code will invoke the query as normal with just the usual query parameters. The management layer will insert the startIndex and numItems parameters before it makes the call.

매개 변수

Simulate an event from the server that corresponds to an item delete. This is useful to notify LCDS that something has been deleted on the server.

매개 변수

Simulate an event from the server that corresponds to an item update or creation. This is useful to notify LCDS that something has changed on the server.

매개 변수

Low-level method used by the DataManager to processes a data message. It converts the data message into calls to the adpater interface so typically you can override one of those operations.

매개 변수

Fault responder for RPCDataService operations. Handles faults by building appropriate error message and propagating it up the token's responder chain.

매개 변수

Success responder for RPCDataService operations. Wraps the received message in a message event and propagates it up the token's responder chain.

매개 변수

This gets called when we get a fault that might be a conflict from the server. We'll try to get the current values for the item which is in conflict and then compare them to the original item in the change we tried to apply. If there are differences, that is a conflict which we'll raise.

매개 변수

This is called when a collection managed by a query (not an association) has items added to the collection or removed from the collection. There is a single message with a list of individual changes. Often you do not need to override this method as those changes are not needed to persist changes made on the client.

If you are implementing associations such as a many-to-many relationship using queries, it may be helpful though to add/remove a row during these operations.

The RPCDataServiceAdapter implementation maps these to individual add and remove calls.

매개 변수

This method is called by the RPCDataServiceAdapter to perform a specific updateItem operation. It is given the new version of the item, the original version of that item before it was modified on this client and the list of properties which are changed. The default implementation looks for a ManagedOperation of type="update" and calls that. The managed operation should at least take the new version of the item as a parameter. If it additionally declares parameters with the special names "origItem" and "changes" those parameters will be provided as well to the remote service.

매개 변수