+xns/Core
Message: Message

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


A communication sent to an identity and from an identity or an application. This is an abstract base class for all XNS messages.


 

Input
Boolean Async Is this message being sent asynchronously?
+xns/Authentication/AuthSession AuthSession The authenticated session identifying the end-user who triggered the event resulting in the creation of this message.
+xns/Certification/AuthorizationCert Authorization Message authorization provided by some identity.
+xns/Core/XMLDateTime Date Timestamp of when the message was constructed.
+xns/Core/IdentityAddress From Address of the identity initiating the message.
+xns/Core/ID ID Global identifier of the message object.
+xns/Core/IdentityDef Identity The portion of identity the from-identity wishes to provide to the to-identity for purposes of message authorization.
+xns/Core/MsgStateEnum MsgState The phase of a message's life cycle.
+xns/Core/IdentityAddress RespondTo Address of the identity to receive the response to this asynchronous message.
+xns/Core/IdentityAddress To Address of the identity targeted by the message.
+xns/Core/IdentityDataAddress type Address of the schema that defines this message.
 

Output
+xns/Core/XMLDateTime Date Timestamp of when the message was constructed.
+xns/Core/IdentityAddress From Address of the identity initiating the message.
+xns/Core/ID ID Global identifier of the message object.
+xns/Core/MsgStateEnum MsgState The phase of a message's life cycle.
+xns/Core/IdentityAddress RespondTo Address of the identity to receive the response to this asynchronous message.
+xns/Core/IdentityAddress To Address of the identity targeted by the message.
+xns/Core/XNSException XNSException The details of a failed message.
+xns/Core/IdentityDataAddress type Address of the schema that defines this message.
 

Exceptions
InvalidArgument A required input parameter was not supplied or an input parameter is of the incorrect type.
 

Input Detail

Async

Is this message being sent asynchronously? True=message is asynchronous and sender is not waiting for a reply; False=message is synchronous and sender is awaiting a reply.  

DataType: Boolean
 


AuthSession

The authenticated session identifying the end-user who triggered the event resulting in the creation of this message.  

DataType: +xns/Authentication/AuthSession
 


Authorization

Message authorization provided by some identity. The identity receiving a message with an authorization may decide to perform its own authorization or use the authorizations provided in this element.  

DataType: +xns/Certification/AuthorizationCert
 


Date

Timestamp of when the message was constructed.  

DataType: +xns/Core/XMLDateTime
 


From

Address of the identity initiating the message. If the message is initiated from an application, then this is blank.  

DataType: +xns/Core/IdentityAddress
 


ID

Global identifier of the message object.  

DataType: +xns/Core/ID
 


Identity

The portion of identity the from-identity wishes to provide to the to-identity for purposes of message authorization. Some messages may require that the from-identity posess specific identity attributes (such as being an identity of a certain type, or a member of a certain group). If the from-identity is willing to provide this information in order to receive the service, it is provided in this element.  

DataType: +xns/Core/IdentityDef
 


MsgState

The phase of a message's life cycle.  

DataType: +xns/Core/MsgStateEnum
 


RespondTo

Address of the identity to receive the response to this asynchronous message. This only applies if Async is 'True.' If the message is asynchronous and RespondTo is blank, the response is not sent.  

DataType: +xns/Core/IdentityAddress
 


To

Address of the identity targeted by the message.  

DataType: +xns/Core/IdentityAddress
 

Required: true
 


type

Address of the schema that defines this message.  

DataType: +xns/Core/IdentityDataAddress
 

Required: true
 


 

Output Detail

Date

Timestamp of when the message was constructed.  

DataType: +xns/Core/XMLDateTime
 


From

Address of the identity initiating the message. If the message is initiated from an application, then this is blank.  

DataType: +xns/Core/IdentityAddress
 


ID

Global identifier of the message object.  

DataType: +xns/Core/ID
 


MsgState

The phase of a message's life cycle.  

DataType: +xns/Core/MsgStateEnum
 


RespondTo

Address of the identity to receive the response to this asynchronous message. This only applies if Async is 'True.' If the message is asynchronous and RespondTo is blank, the response is not sent.  

DataType: +xns/Core/IdentityAddress
 


To

Address of the identity targeted by the message.  

DataType: +xns/Core/IdentityAddress
 

Required: true
 


XNSException

The details of a failed message. This is contained within a message object when the message state is EXCEPTION.  

DataType: +xns/Core/XNSException
 


type

Address of the schema that defines this message.  

DataType: +xns/Core/IdentityDataAddress
 

Required: true
 


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