+xns/Data
Message: UpdateObject

+xns/Core/XNSObject
   |
   +--+xns/Core/Message
         |
         +--+xns/Data/UpdateObject


Updates the object at the specified address with the object provided. This message may be called instead of the +xns/Data/Set message to update an existing object in one of the following scenarios:
1) There is no way of knowing the prior state, therefore no way of specifying the changes to that state.
2) Regardless of the prior state, the object must be placed in the specified state.
This message should be used only if the Set or individual Add/Update/Delete messages cannot be used, because it may result in undesirable side-affects in a multi-user environment. Specifically, if two applications change different elements of the same object at the same time, the Set message will allow both changes to take place, while the UpdateObject message may overwrite the first application's changes. On the other hand, if this is the desired effect, then the UpdateObject message may be more appropriate than Set.

To: Identity in which to set the provided object.
From: Usually the owner or distributor of data at the specified address.


 

Input
+xns/Core/IdentityDataAddress Address Address of the object to update.
+xns/Core/XNSObject Object Object to set at the specified address.
String UpdateObject Identifier of the XNS contract governing the change.
 

Exceptions
IncorrectType The object at the specified address is not of the same type as the object provided.
 

Input Detail

Address

Address of the object to update. This may be an address of an object owned by the to-identity, or it may be an address of data the to-identity has subscribed from another identity.  

DataType: +xns/Core/IdentityDataAddress
 


Object

Object to set at the specified address.  

DataType: +xns/Core/XNSObject
 


UpdateObject

Identifier of the XNS contract governing the change. If the data change request is originated from an XNS contract, then the from-identity is the data provider, and this element identifies the contract authorizing the provider to make this update.  

DataType: String
 


 

Publishing Identity: +xns
© 2002 XNSORG
Last Updated: 07/09/2002