+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 |
Publishing Identity: +xns © 2002 XNSORG |
Last Updated: 07/09/2002 |