+xns/ID
Message: Resolve

+xns/Core/XNSObject
   |
   +--+xns/Core/Message
         |
         +--+xns/ID/Resolve


Resolves an identity ID to the URIs used to channel communication to the identity.

If the identity's URIs are managed by a host identity, then the host identity ID is returned along with the URIs.

To: Any host identity.
From: Any identity or an application acting on behalf of the to-identity.


 

Input
+xns/Core/IdentityID IdentityID The ID path of the identity to be resolved.
Boolean NoCache Is a cached value unacceptable?
 

Output
Boolean Cached Was the result determined from cached data?
+xns/Core/HostID HostID The ID of the located identity's host.
+xns/Core/IdentityID IdentityID The ID path of the identity to be resolved.
+xns/Core/TextList Locations The URIs of the resolved identity's host.
 

Exceptions
IdentityNotFound "HostNotFound" "IdentityRetired"
 

Input Detail

IdentityID

The ID path of the identity to be resolved.  

DataType: +xns/Core/IdentityID
 

Required: true
 


NoCache

Is a cached value unacceptable? True=do not accept a cached value--return only a value retrieved from the definition source; False=accept a cached value.  

DataType: Boolean
 


 

Output Detail

Cached

Was the result determined from cached data? True=the result was determined based on a cached value; False=the result was received from the original registrar within a reasonable timeframe (usually 1 hour). The timeframe allows for immediate self-healing of changed URIs, but prevents repeated requests from one host to an ID service if the resolved host URIs are down for maintenance.  

DataType: Boolean
 


HostID

The ID of the located identity's host.  

DataType: +xns/Core/HostID
 


IdentityID

The ID path of the identity to be resolved.  

DataType: +xns/Core/IdentityID
 

Required: true
 


Locations

The URIs of the resolved identity's host.  

DataType: +xns/Core/TextList
 

List: true
 


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