JsonMessage

Overview

The JsonMessage class implements a Message type that can be used to encode messages in a JSON format to send between client and server.

The JSON data format is a simple, human readable data interchange format written in subset of JavaScript syntax. JSON-RPC is ideal for calls from a JavaScript client, and the Service Builder includes a header generator for JavaScript that uses a JSON library from the Yahoo User Interface library.

Location


 

constructor

Creates a new instance of the JsonMessage class.

 

constructor

 

JsonMessage()

 

Sub New()

AddServerExceptionPrefix    (declared in Message)

 

property AddServerExceptionPrefix: Boolean read write;

 

Boolean AddServerExceptionPrefix { get; set; }

 

Property AddServerExceptionPrefix() As Boolean

AfterReadMessageParam    (declared in Message)

Gets triggered after a parameter was read from the incoming message. You can use this event to inspect the parameter name, type and value.

 

event AfterReadMessageParam: EventHandler<MessageParamEventArgs>;

 

delegate EventHandler<MessageParamEventArgs> AfterReadMessageParam()

 

Event AfterReadMessageParam As EventHandler<MessageParamEventArgs>

AfterUnwrapEnvelopes    (declared in Message)

 

event AfterUnwrapEnvelopes: EventHandler<StreamOperationEventArgs>;

 

delegate EventHandler<StreamOperationEventArgs> AfterUnwrapEnvelopes()

 

Event AfterUnwrapEnvelopes As EventHandler<StreamOperationEventArgs>

AfterWrapEnvelopes    (declared in Message)

 

event AfterWrapEnvelopes: EventHandler<StreamOperationEventArgs>;

 

delegate EventHandler<StreamOperationEventArgs> AfterWrapEnvelopes()

 

Event AfterWrapEnvelopes As EventHandler<StreamOperationEventArgs>

BeforeUnwrapEnvelopes    (declared in Message)

 

event BeforeUnwrapEnvelopes: EventHandler<StreamOperationEventArgs>;

 

delegate EventHandler<StreamOperationEventArgs> BeforeUnwrapEnvelopes()

 

Event BeforeUnwrapEnvelopes As EventHandler<StreamOperationEventArgs>

BeforeWrapEnvelopes    (declared in Message)

 

event BeforeWrapEnvelopes: EventHandler<StreamOperationEventArgs>;

 

delegate EventHandler<StreamOperationEventArgs> BeforeWrapEnvelopes()

 

Event BeforeWrapEnvelopes As EventHandler<StreamOperationEventArgs>

BeforeWriteMessageParam    (declared in Message)

Gets triggered before a parameter gets written to the outgoing message. You can use this event to inspect the parameter name, type and value.

 

event BeforeWriteMessageParam: EventHandler<MessageParamEventArgs>;

 

delegate EventHandler<MessageParamEventArgs> BeforeWriteMessageParam()

 

Event BeforeWriteMessageParam As EventHandler<MessageParamEventArgs>

CheckForEnvelope  protected    (declared in Message)

 

method CheckForEnvelope(stream: Stream; out envelopeName: String): Boolean

 

Boolean CheckForEnvelope(Stream stream, out String envelopeName)

 

Function CheckForEnvelope(stream As Stream, <OutAttribute> ByRef envelopeName As String) As Boolean

Parameters:

  • stream:
  • envelopeName:

Clear    (declared in Message)

Clears all internal data structures and prepare the class to handle the processing of a new message.

 

method Clear

 

void Clear()

 

Sub Clear()

ClearAttributes    (declared in Message)

Clears internally set serializer options based on the attribute values and/or HTTP headers.

 

method ClearAttributes(channel: IChannel)

 

void ClearAttributes(IChannel channel)

 

Sub ClearAttributes(channel As IChannel)

Parameters:

  • channel: Communication channel

ClientID    (declared in Message)

Contains the Client ID for the message. Client IDs are used by the Remoting SDK for Session Management and to uniquely identify individual client on the server, for example by the Per-Client Class Factory or in your own custom code. Generally, you will not need to assign or read this value; the framework will automatically create a new unique client ID whenever a message object is instantiated on the client. However, you do have the option to read and write the ClientID property manually, for example to persist a specific client ID between shutdown and restart of your application.

 

property ClientID: Guid read write;

 

Guid ClientID { get; set; }

 

Property ClientID() As Guid

Clone

Creates and returns an identical copy of the message.

 

method Clone: IMessage

 

IMessage Clone()

 

Function Clone() As IMessage

CloneFrom  protected    (declared in Message)

Copies properties values from the provided instance to the current instance.

 

method CloneFrom(message: Message)

 

void CloneFrom(Message message)

 

Sub CloneFrom(message As Message)

Parameters:

  • message: Message to clone

ContainsData

Gets or sets a flag indicating whether current message instance contains data or not.

 

property ContainsData: Boolean read write;

 

Boolean ContainsData { get; set; }

 

Property ContainsData() As Boolean

ContentType

Gets message's content type.

The value of this property is application/json; charset=utf-8.

 

property ContentType: String read;

 

String ContentType { get; }

 

ReadOnly Property ContentType() As String

ContentType    (declared in Message)

Gets message's content type.

 

property ContentType: String read write;

 

String ContentType { get; set; }

 

Property ContentType() As String

CreateException  protected    (declared in Message)

 

method CreateException(exceptionName: String; message: String): Exception

 

Exception CreateException(String exceptionName, String message)

 

Function CreateException(exceptionName As String, message As String) As Exception

Parameters:

  • exceptionName:
  • message:

CurrentObject

Gets or sets the current JsonBaseObject instance. This property is used to traverse the message content while deserializing data it contains.

 

property CurrentObject: JsonBaseObject read write;

 

JsonBaseObject CurrentObject { get; set; }

 

Property CurrentObject() As JsonBaseObject

DefaultDispatcherName

Gets the default/recommended dispatcher name for the message type.

The value of this property is json.

 

property DefaultDispatcherName: String read;

 

String DefaultDispatcherName { get; }

 

ReadOnly Property DefaultDispatcherName() As String

Dispose  protected    (declared in Message)

 

method Dispose(disposing: Boolean)

 

void Dispose(Boolean disposing)

 

Sub Dispose(disposing As Boolean)

Parameters:

  • disposing:

Envelopes    (declared in Message)

 

property Envelopes: MessageEnvelopes read;

 

MessageEnvelopes Envelopes { get; }

 

ReadOnly Property Envelopes() As MessageEnvelopes

ExtendedExceptionClass

Gets or sets Extended Exception Class name.

This is the name of an entry in the mesaage data that contains extended server exception information, including name of exception class that should be used to raise an exception on the client side.

The default property of this value is ROJSONException.

 

property ExtendedExceptionClass: String read write;

 

String ExtendedExceptionClass { get; set; }

 

Property ExtendedExceptionClass() As String

FinalizeMessage    (declared in Message)

This method should be implemented to ensure that the message content is complete before sending it by doing any final processing necessary.

FinalizeMessage is called after all Parameters have been written to a Message and before the message will be sent. It should perform any necessary wrap-up to ensure that a subsequent call to WriteToStream() will produce a complete message.

 

method FinalizeMessage

 

void FinalizeMessage()

 

Sub FinalizeMessage()

FinalizeRequest    (declared in Message)

Finalizes the data request serialization.

 

method FinalizeRequest(channel: IRequest)

 

void FinalizeRequest(IRequest channel)

 

Sub FinalizeRequest(channel As IRequest)

Parameters:

  • channel: Communication channel

GetExceptionMessage  protected    (declared in Message)

 

method GetExceptionMessage(exception: Exception): String

 

String GetExceptionMessage(Exception exception)

 

Function GetExceptionMessage(exception As Exception) As String

Parameters:

  • exception:

GetStream    (declared in Message)

Creates a new stream with the content of the message.

 

method GetStream: Stream

 

Stream GetStream()

 

Function GetStream() As Stream

HasEnvelope    (declared in Message)

 

class method HasEnvelope(data: array of Byte): Boolean

 

static Boolean HasEnvelope(Byte[] data)

 

Shared Function HasEnvelope(data As Byte()) As Boolean

Parameters:

  • data:

Id

Gets or sets Client's ID.

This identifier corresponds to the session ID on the server side when the SessionIdAsId property is set to true.

 

property Id: String read write;

 

String Id { get; set; }

 

Property Id() As String

IncludeMessageVersion

 

property IncludeMessageVersion: Boolean read write;

 

Boolean IncludeMessageVersion { get; set; }

 

Property IncludeMessageVersion() As Boolean

IncludeTypeName

Gets or sets a flag indicating whether serialized JSON data should contain the type name of serialized custom objects or not.

When this property is set to true the resulting data stream will contain entry **__type** describing type name of the serialized complex object.

 

property IncludeTypeName: Boolean read write;

 

Boolean IncludeTypeName { get; set; }

 

Property IncludeTypeName() As Boolean

Indent

Gets or sets a flag indicating whether serialized JSON data should be formatted & indented to make it easier to read.

 

property Indent: Boolean read write;

 

Boolean Indent { get; set; }

 

Property Indent() As Boolean

InitializeEventMessage (IChannel, String, String)    (declared in Message)

Initializes new event message for interface interfaceName with message name messageName on channel channel.

 

method InitializeEventMessage(channel: IChannel; interfaceName: String; messageName: String)

 

void InitializeEventMessage(IChannel channel, String interfaceName, String messageName)

 

Sub InitializeEventMessage(channel As IChannel, interfaceName As String, messageName As String)

Parameters:

  • channel: Communication channel that will be used to send the event message
  • interfaceName: Communication channel that will be used to send the event message
  • messageName: Message name. Corresponds to the name of the service method being executed

InitializeEventMessage (IChannel, String, String, String)

Initializes new event message.

 

method InitializeEventMessage(channel: IChannel; libraryName: String; interfaceName: String; messageName: String)

 

void InitializeEventMessage(IChannel channel, String libraryName, String interfaceName, String messageName)

 

Sub InitializeEventMessage(channel As IChannel, libraryName As String, interfaceName As String, messageName As String)

Parameters:

  • channel: Communication channel that will be used to send the event message
  • libraryName: RODL library name
  • interfaceName: Communication channel that will be used to send the event message
  • messageName: Message name. Corresponds to the name of the service method being executed

InitializeExceptionMessage (IChannel, String, String, Exception)    (declared in Message)

Should be implemented by Message components to initialize a Exception message.

 

method InitializeExceptionMessage(channel: IChannel; interfaceName: String; messageName: String; exception: Exception)

 

void InitializeExceptionMessage(IChannel channel, String interfaceName, String messageName, Exception exception)

 

Sub InitializeExceptionMessage(channel As IChannel, interfaceName As String, messageName As String, exception As Exception)

Parameters:

  • channel: Communication channel that will be used to send the exception message
  • interfaceName: A name of the interface (i.e. the service).
  • messageName: Message name. Corresponds to the name of the service method being executed
  • exception: Exception that should be serialized and sent to the client application

InitializeExceptionMessage (IChannel, String, String, String, Exception)

Initializes new exception message for interface interfaceName with message name messageName on channel channel.

 

method InitializeExceptionMessage(channel: IChannel; libraryName: String; interfaceName: String; messageName: String; e: Exception)

 

void InitializeExceptionMessage(IChannel channel, String libraryName, String interfaceName, String messageName, Exception e)

 

Sub InitializeExceptionMessage(channel As IChannel, libraryName As String, interfaceName As String, messageName As String, e As Exception)

Parameters:

  • channel: Communication channel that will be used to send the exception message
  • libraryName: RODL library name
  • interfaceName: Interface name. Consider it as the service name
  • messageName: Message name. Corresponds to the name of the service method being executed
  • e: Exception that should be serialized and sent to the client application

InitializeExceptionMessage (IChannel, String, String, String, Exception)    (declared in Message)

Should be implemented by Message components to initialize a Exception message.

 

method InitializeExceptionMessage(channel: IChannel; libraryName: String; interfaceName: String; messageName: String; exception: Exception)

 

void InitializeExceptionMessage(IChannel channel, String libraryName, String interfaceName, String messageName, Exception exception)

 

Sub InitializeExceptionMessage(channel As IChannel, libraryName As String, interfaceName As String, messageName As String, exception As Exception)

Parameters:

  • channel: Communication channel that will be used to send the exception message
  • libraryName: RODL library name
  • interfaceName: A name of the interface (i.e. the service).
  • messageName: Message name. Corresponds to the name of the service method being executed
  • exception: Exception that should be serialized and sent to the client application

InitializeMessage (IChannel, String, String, MessageType)    (declared in Message)

Initializes message of requested type for interface interfaceName with message name messageName on channel channel.

 

method InitializeMessage(channel: IChannel; interfaceName: String; messageName: String; messageType: MessageType)

 

void InitializeMessage(IChannel channel, String interfaceName, String messageName, MessageType messageType)

 

Sub InitializeMessage(channel As IChannel, interfaceName As String, messageName As String, messageType As MessageType)

Parameters:

  • channel: Communication channel
  • interfaceName: Interface name
  • messageName: Message name
  • messageType: Message type (event, exception etc)

InitializeMessage (IChannel, String, String, String, MessageType)

Initializes new message for interface interfaceName with message name messageName on channel channel.

 

method InitializeMessage(channel: IChannel; libraryName: String; interfaceName: String; messageName: String; messageType: MessageType)

 

void InitializeMessage(IChannel channel, String libraryName, String interfaceName, String messageName, MessageType messageType)

 

Sub InitializeMessage(channel As IChannel, libraryName As String, interfaceName As String, messageName As String, messageType As MessageType)

Parameters:

  • channel: Communication channel that will be used to send the message
  • libraryName: RODL library name
  • interfaceName: Interface name. Consider it as the service name
  • messageName: Message name. Corresponds to the name of the service method being executed
  • messageType: Message type (ie request, response, exception etc)

InitializeMessageEx

Initializes new message.

 

method InitializeMessageEx(channel: IChannel; messageType: MessageType)

 

void InitializeMessageEx(IChannel channel, MessageType messageType)

 

Sub InitializeMessageEx(channel As IChannel, messageType As MessageType)

Parameters:

  • channel: Communication channel that will be used to send the message
  • messageType: Message type (ie request, response, exception etc)

InitializeRead    (declared in Message)

 

method InitializeRead(channel: IChannel)

 

void InitializeRead(IChannel channel)

 

Sub InitializeRead(channel As IChannel)

Parameters:

  • channel: Communication channnel

InitializeRequest    (declared in Message)

Sets additional options of the communication channel and data serializer.

 

method InitializeRequest(channel: IRequest)

 

void InitializeRequest(IRequest channel)

 

Sub InitializeRequest(channel As IRequest)

Parameters:

  • channel: Communication channnel

InitializeRequestMessage (IChannel, String, String)    (declared in Message)

Should be implemented by Message components to initialize a Request message.

 

method InitializeRequestMessage(channel: IChannel; interfaceName: String; messageName: String)

 

void InitializeRequestMessage(IChannel channel, String interfaceName, String messageName)

 

Sub InitializeRequestMessage(channel As IChannel, interfaceName As String, messageName As String)

Parameters:

  • channel:
  • interfaceName:
  • messageName:

InitializeRequestMessage (IChannel, String, String, String)    (declared in Message)

 

method InitializeRequestMessage(channel: IChannel; libraryName: String; interfaceName: String; messageName: String)

 

void InitializeRequestMessage(IChannel channel, String libraryName, String interfaceName, String messageName)

 

Sub InitializeRequestMessage(channel As IChannel, libraryName As String, interfaceName As String, messageName As String)

Parameters:

  • channel:
  • libraryName:
  • interfaceName:
  • messageName:

InitializeResponseMessage (IChannel, String, String)    (declared in Message)

Should be implemented by Message components to initialize a Response message.

 

method InitializeResponseMessage(channel: IChannel; interfaceName: String; messageName: String)

 

void InitializeResponseMessage(IChannel channel, String interfaceName, String messageName)

 

Sub InitializeResponseMessage(channel As IChannel, interfaceName As String, messageName As String)

Parameters:

  • channel:
  • interfaceName:
  • messageName:

InitializeResponseMessage (IChannel, String, String, String)    (declared in Message)

 

method InitializeResponseMessage(channel: IChannel; libraryName: String; interfaceName: String; messageName: String)

 

void InitializeResponseMessage(IChannel channel, String libraryName, String interfaceName, String messageName)

 

Sub InitializeResponseMessage(channel As IChannel, libraryName As String, interfaceName As String, messageName As String)

Parameters:

  • channel:
  • libraryName:
  • interfaceName:
  • messageName:

InitializeSerializer  protected

 

method InitializeSerializer

 

void InitializeSerializer()

 

Sub InitializeSerializer()

InterfaceName    (declared in Message)

Contains the name of the interface (i.e. the service) that is being called (read-only).

 

property InterfaceName: String read write;

 

String InterfaceName { get; set; }

 

Property InterfaceName() As String

IsValidMessage    (declared in Message)

 

property IsValidMessage: Boolean read;

 

Boolean IsValidMessage { get; }

 

ReadOnly Property IsValidMessage() As Boolean

MessageMatchingTargetUri (String): IMessage    (declared in Message)

Creates a client message with type matching the provided target Uri. F.e. for provided uri supertcp://192.168.1.100:7020/bin this method will return an instance of the BinMessage class.

 

class method MessageMatchingTargetUri(uri: String): IMessage

 

static IMessage MessageMatchingTargetUri(String uri)

 

Shared Function MessageMatchingTargetUri(uri As String) As IMessage

Parameters:

  • uri: Server Uri

MessageMatchingTargetUri (Uri): IMessage    (declared in Message)

Creates a client message with type matching the provided target Uri. F.e. for provided uri supertcp://192.168.1.100:7020/bin this method will return an instance of the BinMessage class.

 

class method MessageMatchingTargetUri(uri: Uri): IMessage

 

static IMessage MessageMatchingTargetUri(Uri uri)

 

Shared Function MessageMatchingTargetUri(uri As Uri) As IMessage

Parameters:

  • uri: Server Uri

MessageName    (declared in Message)

Contains the name of the message (i.e. the method) that is being called (read-only).

 

property MessageName: String read write;

 

String MessageName { get; set; }

 

Property MessageName() As String

MessageType    (declared in Message)

Contains the Type of message represented by the message instance.

 

property MessageType: MessageType read write;

 

MessageType MessageType { get; set; }

 

Property MessageType() As MessageType

OnFinalizeMessage    (declared in Message)

Gets triggered when FinalizeMessage method was called to finalize an outgoing message just before it will be actually sent across the wire to the remote system.

 

event OnFinalizeMessage: EventHandler<EventArgs>;

 

delegate EventHandler<EventArgs> OnFinalizeMessage()

 

Event OnFinalizeMessage As EventHandler<EventArgs>

OnInitializeMessage    (declared in Message)

Gets triggered when InitializeMessage method is called to initialize an outgoing message. You can hook into this event to inspect information such as the service name and message (method) name, as well as the channel that the message is being dispatched through.

 

event OnInitializeMessage: EventHandler<InitMessageEventArgs>;

 

delegate EventHandler<InitMessageEventArgs> OnInitializeMessage()

 

Event OnInitializeMessage As EventHandler<InitMessageEventArgs>

ParamsAsArray

Gets or sets a flag defining the way method parameters are serialized in the JSON data stream.

 

property ParamsAsArray: Boolean read write;

 

Boolean ParamsAsArray { get; set; }

 

Property ParamsAsArray() As Boolean

ProcessException  protected    (declared in Message)

 

method ProcessException

 

void ProcessException()

 

Sub ProcessException()

Read    (declared in Message)

Calls the appropriate method for reading the given Type (such as ReadString or ReadInt32). If the type is unsupported, an exception is raised. Objects can be written to the Serializer using the Write method. You will usually not need to override this method when implementing a custom Serializer.

 

method Read(name: String; type: Type; format: StreamingFormat): Object

 

Object Read(String name, Type type, StreamingFormat format)

 

Function Read(name As String, type As Type, format As StreamingFormat) As Object

Parameters:

  • name:
  • type:
  • format:

ReadAnsiString    (declared in Message)

Should be implemented to read an ANSI String value from the message.

 

method ReadAnsiString(name: String): String

 

String ReadAnsiString(String name)

 

Function ReadAnsiString(name As String) As String

Parameters:

  • name:

ReadBoolean    (declared in Message)

 

method ReadBoolean(name: String): Boolean

 

Boolean ReadBoolean(String name)

 

Function ReadBoolean(name As String) As Boolean

Parameters:

  • name:

ReadCurrency    (declared in Message)

 

method ReadCurrency(name: String): Decimal

 

Decimal ReadCurrency(String name)

 

Function ReadCurrency(name As String) As Decimal

Parameters:

  • name:

ReadDateTime    (declared in Message)

 

method ReadDateTime(name: String): DateTime

 

DateTime ReadDateTime(String name)

 

Function ReadDateTime(name As String) As DateTime

Parameters:

  • name:

ReadDecimal    (declared in Message)

 

method ReadDecimal(name: String): Decimal

 

Decimal ReadDecimal(String name)

 

Function ReadDecimal(name As String) As Decimal

Parameters:

  • name:

ReadDouble    (declared in Message)

 

method ReadDouble(name: String): Double

 

Double ReadDouble(String name)

 

Function ReadDouble(name As String) As Double

Parameters:

  • name:

ReadEnum    (declared in Message)

 

method ReadEnum(name: String; type: Type): Enum

 

Enum ReadEnum(String name, Type type)

 

Function ReadEnum(name As String, type As Type) As Enum

Parameters:

  • name:
  • type:

ReadException

Reads the current message as an exception, then returns a new ServerException instance, properly initialized with the message values.

 

method ReadException: Exception

 

Exception ReadException()

 

Function ReadException() As Exception

ReadFromStream    (declared in Message)

Should be implemented to read the contents of the message from the given stream.

 

method ReadFromStream(stream: Stream)

 

void ReadFromStream(Stream stream)

 

Sub ReadFromStream(stream As Stream)

Parameters:

  • stream:

ReadGuid    (declared in Message)

 

method ReadGuid(name: String): Guid

 

Guid ReadGuid(String name)

 

Function ReadGuid(name As String) As Guid

Parameters:

  • name:

ReadInt32    (declared in Message)

 

method ReadInt32(name: String): Int32

 

Int32 ReadInt32(String name)

 

Function ReadInt32(name As String) As Int32

Parameters:

  • name:

ReadInt64    (declared in Message)

 

method ReadInt64(name: String): Int64

 

Int64 ReadInt64(String name)

 

Function ReadInt64(name As String) As Int64

Parameters:

  • name:

ReadUtf8String    (declared in Message)

 

method ReadUtf8String(name: String): String

 

String ReadUtf8String(String name)

 

Function ReadUtf8String(name As String) As String

Parameters:

  • name:

ReadVariant    (declared in Message)

 

method ReadVariant(name: String): Object

 

Object ReadVariant(String name)

 

Function ReadVariant(name As String) As Object

Parameters:

  • name:

ReadWideString    (declared in Message)

Should be implemented to read an Unicode Wide String value from the message.

 

method ReadWideString(name: String): String

 

String ReadWideString(String name)

 

Function ReadWideString(name As String) As String

Parameters:

  • name:

ReadXml    (declared in Message)

 

method ReadXml(name: String): XmlNode

 

XmlNode ReadXml(String name)

 

Function ReadXml(name As String) As XmlNode

Parameters:

  • name:

RootObject

Gets the root JsonObject instance in the JSON data contained in the message.

 

property RootObject: JsonObject read;

 

JsonObject RootObject { get; }

 

ReadOnly Property RootObject() As JsonObject

SendExtendedException

Gets or sets a flag defining the way exceptions are sent to the client application.

When the flag is set to true then ExtendedExceptionClass object is sent as exception description.

The default value of this property is false.

 

property SendExtendedException: Boolean read write;

 

Boolean SendExtendedException { get; set; }

 

Property SendExtendedException() As Boolean

SerializerInstance    (declared in Message)

This is the Serializer used to write values to the message. Descendant classes will set this property to a custom Serializer class within their InitializeMessage or ReadFromStream methods, so that future calls to the Read* and Write* methods can access the custom Serializer.

 

property SerializerInstance: Serializer read write;

 

Serializer SerializerInstance { get; set; }

 

Property SerializerInstance() As Serializer

ServerExceptionPrefix    (declared in Message)

 

property ServerExceptionPrefix: String read write;

 

String ServerExceptionPrefix { get; set; }

 

Property ServerExceptionPrefix() As String

SessionIdAsId

Gets or sets a flag indicating whether the Id property should be used as a session identifier.

 

property SessionIdAsId: Boolean read write;

 

Boolean SessionIdAsId { get; set; }

 

Property SessionIdAsId() As Boolean

SetAttributes    (declared in Message)

 

method SetAttributes(channel: IChannel; attributeNames: array of String; attributeValues: array of String)

 

void SetAttributes(IChannel channel, String[] attributeNames, String[] attributeValues)

 

Sub SetAttributes(channel As IChannel, attributeNames As String(), attributeValues As String())

Parameters:

  • channel:
  • attributeNames:
  • attributeValues:

TriggerAfterReadMessageParam (String, Object)  protected    (declared in Message)

 

method TriggerAfterReadMessageParam(name: String; parameter: Object)

 

void TriggerAfterReadMessageParam(String name, Object parameter)

 

Sub TriggerAfterReadMessageParam(name As String, parameter As Object)

Parameters:

  • name:
  • parameter:

TriggerAfterReadMessageParam (String, Object, Type)  protected    (declared in Message)

 

method TriggerAfterReadMessageParam(name: String; parameter: Object; type: Type)

 

void TriggerAfterReadMessageParam(String name, Object parameter, Type type)

 

Sub TriggerAfterReadMessageParam(name As String, parameter As Object, type As Type)

Parameters:

  • name:
  • parameter:
  • type:

TriggerAfterReadMessageParam (String, Object, Type, StreamingFormat)  protected    (declared in Message)

 

method TriggerAfterReadMessageParam(name: String; parameter: Object; type: Type; format: StreamingFormat)

 

void TriggerAfterReadMessageParam(String name, Object parameter, Type type, StreamingFormat format)

 

Sub TriggerAfterReadMessageParam(name As String, parameter As Object, type As Type, format As StreamingFormat)

Parameters:

  • name:
  • parameter:
  • type:
  • format:

TriggerAfterUnwrapEnvelopes  protected    (declared in Message)

 

method TriggerAfterUnwrapEnvelopes(stream: Stream)

 

void TriggerAfterUnwrapEnvelopes(Stream stream)

 

Sub TriggerAfterUnwrapEnvelopes(stream As Stream)

Parameters:

  • stream:

TriggerAfterWrapEnvelopes  protected    (declared in Message)

 

method TriggerAfterWrapEnvelopes(stream: Stream)

 

void TriggerAfterWrapEnvelopes(Stream stream)

 

Sub TriggerAfterWrapEnvelopes(stream As Stream)

Parameters:

  • stream:

TriggerBeforeUnwrapEnvelopes  protected    (declared in Message)

 

method TriggerBeforeUnwrapEnvelopes(stream: Stream)

 

void TriggerBeforeUnwrapEnvelopes(Stream stream)

 

Sub TriggerBeforeUnwrapEnvelopes(stream As Stream)

Parameters:

  • stream:

TriggerBeforeWrapEnvelopes  protected    (declared in Message)

 

method TriggerBeforeWrapEnvelopes(stream: Stream)

 

void TriggerBeforeWrapEnvelopes(Stream stream)

 

Sub TriggerBeforeWrapEnvelopes(stream As Stream)

Parameters:

  • stream:

TriggerBeforeWriteMessageParam (String, Object)  protected    (declared in Message)

 

method TriggerBeforeWriteMessageParam(name: String; parameter: Object)

 

void TriggerBeforeWriteMessageParam(String name, Object parameter)

 

Sub TriggerBeforeWriteMessageParam(name As String, parameter As Object)

Parameters:

  • name:
  • parameter:

TriggerBeforeWriteMessageParam (String, Object, Type)  protected    (declared in Message)

 

method TriggerBeforeWriteMessageParam(name: String; parameter: Object; type: Type)

 

void TriggerBeforeWriteMessageParam(String name, Object parameter, Type type)

 

Sub TriggerBeforeWriteMessageParam(name As String, parameter As Object, type As Type)

Parameters:

  • name:
  • parameter:
  • type:

TriggerBeforeWriteMessageParam (String, Object, Type, StreamingFormat)  protected    (declared in Message)

 

method TriggerBeforeWriteMessageParam(name: String; parameter: Object; type: Type; format: StreamingFormat)

 

void TriggerBeforeWriteMessageParam(String name, Object parameter, Type type, StreamingFormat format)

 

Sub TriggerBeforeWriteMessageParam(name As String, parameter As Object, type As Type, format As StreamingFormat)

Parameters:

  • name:
  • parameter:
  • type:
  • format:

TriggerOnFinalizeMessage  protected    (declared in Message)

 

method TriggerOnFinalizeMessage

 

void TriggerOnFinalizeMessage()

 

Sub TriggerOnFinalizeMessage()

TriggerOnInitializeMessage  protected    (declared in Message)

 

method TriggerOnInitializeMessage(channel: IChannel; interfaceName: String; messageName: String; exception: Exception)

 

void TriggerOnInitializeMessage(IChannel channel, String interfaceName, String messageName, Exception exception)

 

Sub TriggerOnInitializeMessage(channel As IChannel, interfaceName As String, messageName As String, exception As Exception)

Parameters:

  • channel:
  • interfaceName:
  • messageName:
  • exception:

UnwrapEnvelopes  protected    (declared in Message)

 

method UnwrapEnvelopes(stream: Stream): Stream

 

Stream UnwrapEnvelopes(Stream stream)

 

Function UnwrapEnvelopes(stream As Stream) As Stream

Parameters:

  • stream:

Validate    (declared in Message)

 

method Validate(content: String): Boolean

 

Boolean Validate(String content)

 

Function Validate(content As String) As Boolean

Parameters:

  • content:

WrapEnvelopes  protected    (declared in Message)

 

method WrapEnvelopes(stream: Stream): Stream

 

Stream WrapEnvelopes(Stream stream)

 

Function WrapEnvelopes(stream As Stream) As Stream

Parameters:

  • stream:

WrapResult

Gets or sets a flag indicating whether the JSON root object of the current message should be wrapped into a result JSON entry.

This property should be set to true if it is intended to allow Remoting SDK for JavaScript-based clients to communicate with the server.

 

property WrapResult: Boolean read write;

 

Boolean WrapResult { get; set; }

 

Property WrapResult() As Boolean

Write    (declared in Message)

 

method Write(name: String; value: Object; type: Type; format: StreamingFormat)

 

void Write(String name, Object value, Type type, StreamingFormat format)

 

Sub Write(name As String, value As Object, type As Type, format As StreamingFormat)

Parameters:

  • name:
  • value:
  • type:
  • format:

WriteAnsiString    (declared in Message)

Should be implemented to write an ANSI String value to the message.

 

method WriteAnsiString(name: String; value: String)

 

void WriteAnsiString(String name, String value)

 

Sub WriteAnsiString(name As String, value As String)

Parameters:

  • name:
  • value:

WriteBoolean    (declared in Message)

 

method WriteBoolean(name: String; value: Boolean)

 

void WriteBoolean(String name, Boolean value)

 

Sub WriteBoolean(name As String, value As Boolean)

Parameters:

  • name:
  • value:

WriteCurrency    (declared in Message)

 

method WriteCurrency(name: String; value: Decimal)

 

void WriteCurrency(String name, Decimal value)

 

Sub WriteCurrency(name As String, value As Decimal)

Parameters:

  • name:
  • value:

WriteDateTime    (declared in Message)

 

method WriteDateTime(name: String; value: DateTime)

 

void WriteDateTime(String name, DateTime value)

 

Sub WriteDateTime(name As String, value As DateTime)

Parameters:

  • name:
  • value:

WriteDecimal    (declared in Message)

 

method WriteDecimal(name: String; value: Decimal)

 

void WriteDecimal(String name, Decimal value)

 

Sub WriteDecimal(name As String, value As Decimal)

Parameters:

  • name:
  • value:

WriteDouble    (declared in Message)

 

method WriteDouble(name: String; value: Double)

 

void WriteDouble(String name, Double value)

 

Sub WriteDouble(name As String, value As Double)

Parameters:

  • name:
  • value:

WriteEnum    (declared in Message)

 

method WriteEnum(name: String; value: Enum)

 

void WriteEnum(String name, Enum value)

 

Sub WriteEnum(name As String, value As Enum)

Parameters:

  • name:
  • value:

WriteEnvelopeHeader    (declared in Message)

 

method WriteEnvelopeHeader(envelope: MessageEnvelope; stream: Stream)

 

void WriteEnvelopeHeader(MessageEnvelope envelope, Stream stream)

 

Sub WriteEnvelopeHeader(envelope As MessageEnvelope, stream As Stream)

Parameters:

  • envelope:
  • stream:

WriteException

Writes the provided exception to the current message.

 

method WriteException(exception: Exception)

 

void WriteException(Exception exception)

 

Sub WriteException(exception As Exception)

Parameters:

  • exception: Exception that should be serialized and sent to the client application

WriteGuid    (declared in Message)

 

method WriteGuid(name: String; value: Guid)

 

void WriteGuid(String name, Guid value)

 

Sub WriteGuid(name As String, value As Guid)

Parameters:

  • name:
  • value:

WriteInt32    (declared in Message)

 

method WriteInt32(name: String; value: Int32)

 

void WriteInt32(String name, Int32 value)

 

Sub WriteInt32(name As String, value As Int32)

Parameters:

  • name:
  • value:

WriteInt64    (declared in Message)

 

method WriteInt64(name: String; value: Int64)

 

void WriteInt64(String name, Int64 value)

 

Sub WriteInt64(name As String, value As Int64)

Parameters:

  • name:
  • value:

WriteToStream    (declared in Message)

 

method WriteToStream(stream: Stream)

 

void WriteToStream(Stream stream)

 

Sub WriteToStream(stream As Stream)

Parameters:

  • stream:

WriteUtf8String    (declared in Message)

 

method WriteUtf8String(name: String; value: String)

 

void WriteUtf8String(String name, String value)

 

Sub WriteUtf8String(name As String, value As String)

Parameters:

  • name:
  • value:

WriteVariant    (declared in Message)

 

method WriteVariant(name: String; value: Object)

 

void WriteVariant(String name, Object value)

 

Sub WriteVariant(name As String, value As Object)

Parameters:

  • name:
  • value:

WriteWideString    (declared in Message)

 

method WriteWideString(name: String; value: String)

 

void WriteWideString(String name, String value)

 

Sub WriteWideString(name As String, value As String)

Parameters:

  • name:
  • value:

WriteXml    (declared in Message)

 

method WriteXml(name: String; value: XmlNode)

 

void WriteXml(String name, XmlNode value)

 

Sub WriteXml(name As String, value As XmlNode)

Parameters:

  • name:
  • value:

 

AddServerExceptionPrefix    (declared in Message)

 

property AddServerExceptionPrefix: Boolean read write;

 

Boolean AddServerExceptionPrefix { get; set; }

 

Property AddServerExceptionPrefix() As Boolean

ClientID    (declared in Message)

Contains the Client ID for the message. Client IDs are used by the Remoting SDK for Session Management and to uniquely identify individual client on the server, for example by the Per-Client Class Factory or in your own custom code. Generally, you will not need to assign or read this value; the framework will automatically create a new unique client ID whenever a message object is instantiated on the client. However, you do have the option to read and write the ClientID property manually, for example to persist a specific client ID between shutdown and restart of your application.

 

property ClientID: Guid read write;

 

Guid ClientID { get; set; }

 

Property ClientID() As Guid

ContainsData

Gets or sets a flag indicating whether current message instance contains data or not.

 

property ContainsData: Boolean read write;

 

Boolean ContainsData { get; set; }

 

Property ContainsData() As Boolean

ContentType

Gets message's content type.

The value of this property is application/json; charset=utf-8.

 

property ContentType: String read;

 

String ContentType { get; }

 

ReadOnly Property ContentType() As String

ContentType    (declared in Message)

Gets message's content type.

 

property ContentType: String read write;

 

String ContentType { get; set; }

 

Property ContentType() As String

CurrentObject

Gets or sets the current JsonBaseObject instance. This property is used to traverse the message content while deserializing data it contains.

 

property CurrentObject: JsonBaseObject read write;

 

JsonBaseObject CurrentObject { get; set; }

 

Property CurrentObject() As JsonBaseObject

DefaultDispatcherName

Gets the default/recommended dispatcher name for the message type.

The value of this property is json.

 

property DefaultDispatcherName: String read;

 

String DefaultDispatcherName { get; }

 

ReadOnly Property DefaultDispatcherName() As String

Envelopes    (declared in Message)

 

property Envelopes: MessageEnvelopes read;

 

MessageEnvelopes Envelopes { get; }

 

ReadOnly Property Envelopes() As MessageEnvelopes

ExtendedExceptionClass

Gets or sets Extended Exception Class name.

This is the name of an entry in the mesaage data that contains extended server exception information, including name of exception class that should be used to raise an exception on the client side.

The default property of this value is ROJSONException.

 

property ExtendedExceptionClass: String read write;

 

String ExtendedExceptionClass { get; set; }

 

Property ExtendedExceptionClass() As String

Id

Gets or sets Client's ID.

This identifier corresponds to the session ID on the server side when the SessionIdAsId property is set to true.

 

property Id: String read write;

 

String Id { get; set; }

 

Property Id() As String

IncludeMessageVersion

 

property IncludeMessageVersion: Boolean read write;

 

Boolean IncludeMessageVersion { get; set; }

 

Property IncludeMessageVersion() As Boolean

IncludeTypeName

Gets or sets a flag indicating whether serialized JSON data should contain the type name of serialized custom objects or not.

When this property is set to true the resulting data stream will contain entry **__type** describing type name of the serialized complex object.

 

property IncludeTypeName: Boolean read write;

 

Boolean IncludeTypeName { get; set; }

 

Property IncludeTypeName() As Boolean

Indent

Gets or sets a flag indicating whether serialized JSON data should be formatted & indented to make it easier to read.

 

property Indent: Boolean read write;

 

Boolean Indent { get; set; }

 

Property Indent() As Boolean

InterfaceName    (declared in Message)

Contains the name of the interface (i.e. the service) that is being called (read-only).

 

property InterfaceName: String read write;

 

String InterfaceName { get; set; }

 

Property InterfaceName() As String

IsValidMessage    (declared in Message)

 

property IsValidMessage: Boolean read;

 

Boolean IsValidMessage { get; }

 

ReadOnly Property IsValidMessage() As Boolean

MessageName    (declared in Message)

Contains the name of the message (i.e. the method) that is being called (read-only).

 

property MessageName: String read write;

 

String MessageName { get; set; }

 

Property MessageName() As String

MessageType    (declared in Message)

Contains the Type of message represented by the message instance.

 

property MessageType: MessageType read write;

 

MessageType MessageType { get; set; }

 

Property MessageType() As MessageType

ParamsAsArray

Gets or sets a flag defining the way method parameters are serialized in the JSON data stream.

 

property ParamsAsArray: Boolean read write;

 

Boolean ParamsAsArray { get; set; }

 

Property ParamsAsArray() As Boolean

RootObject

Gets the root JsonObject instance in the JSON data contained in the message.

 

property RootObject: JsonObject read;

 

JsonObject RootObject { get; }

 

ReadOnly Property RootObject() As JsonObject

SendExtendedException

Gets or sets a flag defining the way exceptions are sent to the client application.

When the flag is set to true then ExtendedExceptionClass object is sent as exception description.

The default value of this property is false.

 

property SendExtendedException: Boolean read write;

 

Boolean SendExtendedException { get; set; }

 

Property SendExtendedException() As Boolean

SerializerInstance    (declared in Message)

This is the Serializer used to write values to the message. Descendant classes will set this property to a custom Serializer class within their InitializeMessage or ReadFromStream methods, so that future calls to the Read* and Write* methods can access the custom Serializer.

 

property SerializerInstance: Serializer read write;

 

Serializer SerializerInstance { get; set; }

 

Property SerializerInstance() As Serializer

ServerExceptionPrefix    (declared in Message)

 

property ServerExceptionPrefix: String read write;

 

String ServerExceptionPrefix { get; set; }

 

Property ServerExceptionPrefix() As String

SessionIdAsId

Gets or sets a flag indicating whether the Id property should be used as a session identifier.

 

property SessionIdAsId: Boolean read write;

 

Boolean SessionIdAsId { get; set; }

 

Property SessionIdAsId() As Boolean

WrapResult

Gets or sets a flag indicating whether the JSON root object of the current message should be wrapped into a result JSON entry.

This property should be set to true if it is intended to allow Remoting SDK for JavaScript-based clients to communicate with the server.

 

property WrapResult: Boolean read write;

 

Boolean WrapResult { get; set; }

 

Property WrapResult() As Boolean

 

HasEnvelope    (declared in Message)

 

class method HasEnvelope(data: array of Byte): Boolean

 

static Boolean HasEnvelope(Byte[] data)

 

Shared Function HasEnvelope(data As Byte()) As Boolean

Parameters:

  • data:

MessageMatchingTargetUri (String): IMessage    (declared in Message)

Creates a client message with type matching the provided target Uri. F.e. for provided uri supertcp://192.168.1.100:7020/bin this method will return an instance of the BinMessage class.

 

class method MessageMatchingTargetUri(uri: String): IMessage

 

static IMessage MessageMatchingTargetUri(String uri)

 

Shared Function MessageMatchingTargetUri(uri As String) As IMessage

Parameters:

  • uri: Server Uri

MessageMatchingTargetUri (Uri): IMessage    (declared in Message)

Creates a client message with type matching the provided target Uri. F.e. for provided uri supertcp://192.168.1.100:7020/bin this method will return an instance of the BinMessage class.

 

class method MessageMatchingTargetUri(uri: Uri): IMessage

 

static IMessage MessageMatchingTargetUri(Uri uri)

 

Shared Function MessageMatchingTargetUri(uri As Uri) As IMessage

Parameters:

  • uri: Server Uri

 

constructor

Creates a new instance of the JsonMessage class.

 

constructor

 

JsonMessage()

 

Sub New()

CheckForEnvelope  protected    (declared in Message)

 

method CheckForEnvelope(stream: Stream; out envelopeName: String): Boolean

 

Boolean CheckForEnvelope(Stream stream, out String envelopeName)

 

Function CheckForEnvelope(stream As Stream, <OutAttribute> ByRef envelopeName As String) As Boolean

Parameters:

  • stream:
  • envelopeName:

Clear    (declared in Message)

Clears all internal data structures and prepare the class to handle the processing of a new message.

 

method Clear

 

void Clear()

 

Sub Clear()

ClearAttributes    (declared in Message)

Clears internally set serializer options based on the attribute values and/or HTTP headers.

 

method ClearAttributes(channel: IChannel)

 

void ClearAttributes(IChannel channel)

 

Sub ClearAttributes(channel As IChannel)

Parameters:

  • channel: Communication channel

Clone

Creates and returns an identical copy of the message.

 

method Clone: IMessage

 

IMessage Clone()

 

Function Clone() As IMessage

CloneFrom  protected    (declared in Message)

Copies properties values from the provided instance to the current instance.

 

method CloneFrom(message: Message)

 

void CloneFrom(Message message)

 

Sub CloneFrom(message As Message)

Parameters:

  • message: Message to clone

CreateException  protected    (declared in Message)

 

method CreateException(exceptionName: String; message: String): Exception

 

Exception CreateException(String exceptionName, String message)

 

Function CreateException(exceptionName As String, message As String) As Exception

Parameters:

  • exceptionName:
  • message:

Dispose  protected    (declared in Message)

 

method Dispose(disposing: Boolean)

 

void Dispose(Boolean disposing)

 

Sub Dispose(disposing As Boolean)

Parameters:

  • disposing:

FinalizeMessage    (declared in Message)

This method should be implemented to ensure that the message content is complete before sending it by doing any final processing necessary.

FinalizeMessage is called after all Parameters have been written to a Message and before the message will be sent. It should perform any necessary wrap-up to ensure that a subsequent call to WriteToStream() will produce a complete message.

 

method FinalizeMessage

 

void FinalizeMessage()

 

Sub FinalizeMessage()

FinalizeRequest    (declared in Message)

Finalizes the data request serialization.

 

method FinalizeRequest(channel: IRequest)

 

void FinalizeRequest(IRequest channel)

 

Sub FinalizeRequest(channel As IRequest)

Parameters:

  • channel: Communication channel

GetExceptionMessage  protected    (declared in Message)

 

method GetExceptionMessage(exception: Exception): String

 

String GetExceptionMessage(Exception exception)

 

Function GetExceptionMessage(exception As Exception) As String

Parameters:

  • exception:

GetStream    (declared in Message)

Creates a new stream with the content of the message.

 

method GetStream: Stream

 

Stream GetStream()

 

Function GetStream() As Stream

InitializeEventMessage (IChannel, String, String)    (declared in Message)

Initializes new event message for interface interfaceName with message name messageName on channel channel.

 

method InitializeEventMessage(channel: IChannel; interfaceName: String; messageName: String)

 

void InitializeEventMessage(IChannel channel, String interfaceName, String messageName)

 

Sub InitializeEventMessage(channel As IChannel, interfaceName As String, messageName As String)

Parameters:

  • channel: Communication channel that will be used to send the event message
  • interfaceName: Communication channel that will be used to send the event message
  • messageName: Message name. Corresponds to the name of the service method being executed

InitializeEventMessage (IChannel, String, String, String)

Initializes new event message.

 

method InitializeEventMessage(channel: IChannel; libraryName: String; interfaceName: String; messageName: String)

 

void InitializeEventMessage(IChannel channel, String libraryName, String interfaceName, String messageName)

 

Sub InitializeEventMessage(channel As IChannel, libraryName As String, interfaceName As String, messageName As String)

Parameters:

  • channel: Communication channel that will be used to send the event message
  • libraryName: RODL library name
  • interfaceName: Communication channel that will be used to send the event message
  • messageName: Message name. Corresponds to the name of the service method being executed

InitializeExceptionMessage (IChannel, String, String, Exception)    (declared in Message)

Should be implemented by Message components to initialize a Exception message.

 

method InitializeExceptionMessage(channel: IChannel; interfaceName: String; messageName: String; exception: Exception)

 

void InitializeExceptionMessage(IChannel channel, String interfaceName, String messageName, Exception exception)

 

Sub InitializeExceptionMessage(channel As IChannel, interfaceName As String, messageName As String, exception As Exception)

Parameters:

  • channel: Communication channel that will be used to send the exception message
  • interfaceName: A name of the interface (i.e. the service).
  • messageName: Message name. Corresponds to the name of the service method being executed
  • exception: Exception that should be serialized and sent to the client application

InitializeExceptionMessage (IChannel, String, String, String, Exception)

Initializes new exception message for interface interfaceName with message name messageName on channel channel.

 

method InitializeExceptionMessage(channel: IChannel; libraryName: String; interfaceName: String; messageName: String; e: Exception)

 

void InitializeExceptionMessage(IChannel channel, String libraryName, String interfaceName, String messageName, Exception e)

 

Sub InitializeExceptionMessage(channel As IChannel, libraryName As String, interfaceName As String, messageName As String, e As Exception)

Parameters:

  • channel: Communication channel that will be used to send the exception message
  • libraryName: RODL library name
  • interfaceName: Interface name. Consider it as the service name
  • messageName: Message name. Corresponds to the name of the service method being executed
  • e: Exception that should be serialized and sent to the client application

InitializeExceptionMessage (IChannel, String, String, String, Exception)    (declared in Message)

Should be implemented by Message components to initialize a Exception message.

 

method InitializeExceptionMessage(channel: IChannel; libraryName: String; interfaceName: String; messageName: String; exception: Exception)

 

void InitializeExceptionMessage(IChannel channel, String libraryName, String interfaceName, String messageName, Exception exception)

 

Sub InitializeExceptionMessage(channel As IChannel, libraryName As String, interfaceName As String, messageName As String, exception As Exception)

Parameters:

  • channel: Communication channel that will be used to send the exception message
  • libraryName: RODL library name
  • interfaceName: A name of the interface (i.e. the service).
  • messageName: Message name. Corresponds to the name of the service method being executed
  • exception: Exception that should be serialized and sent to the client application

InitializeMessage (IChannel, String, String, MessageType)    (declared in Message)

Initializes message of requested type for interface interfaceName with message name messageName on channel channel.

 

method InitializeMessage(channel: IChannel; interfaceName: String; messageName: String; messageType: MessageType)

 

void InitializeMessage(IChannel channel, String interfaceName, String messageName, MessageType messageType)

 

Sub InitializeMessage(channel As IChannel, interfaceName As String, messageName As String, messageType As MessageType)

Parameters:

  • channel: Communication channel
  • interfaceName: Interface name
  • messageName: Message name
  • messageType: Message type (event, exception etc)

InitializeMessage (IChannel, String, String, String, MessageType)

Initializes new message for interface interfaceName with message name messageName on channel channel.

 

method InitializeMessage(channel: IChannel; libraryName: String; interfaceName: String; messageName: String; messageType: MessageType)

 

void InitializeMessage(IChannel channel, String libraryName, String interfaceName, String messageName, MessageType messageType)

 

Sub InitializeMessage(channel As IChannel, libraryName As String, interfaceName As String, messageName As String, messageType As MessageType)

Parameters:

  • channel: Communication channel that will be used to send the message
  • libraryName: RODL library name
  • interfaceName: Interface name. Consider it as the service name
  • messageName: Message name. Corresponds to the name of the service method being executed
  • messageType: Message type (ie request, response, exception etc)

InitializeMessageEx

Initializes new message.

 

method InitializeMessageEx(channel: IChannel; messageType: MessageType)

 

void InitializeMessageEx(IChannel channel, MessageType messageType)

 

Sub InitializeMessageEx(channel As IChannel, messageType As MessageType)

Parameters:

  • channel: Communication channel that will be used to send the message
  • messageType: Message type (ie request, response, exception etc)

InitializeRead    (declared in Message)

 

method InitializeRead(channel: IChannel)

 

void InitializeRead(IChannel channel)

 

Sub InitializeRead(channel As IChannel)

Parameters:

  • channel: Communication channnel

InitializeRequest    (declared in Message)

Sets additional options of the communication channel and data serializer.

 

method InitializeRequest(channel: IRequest)

 

void InitializeRequest(IRequest channel)

 

Sub InitializeRequest(channel As IRequest)

Parameters:

  • channel: Communication channnel

InitializeRequestMessage (IChannel, String, String)    (declared in Message)

Should be implemented by Message components to initialize a Request message.

 

method InitializeRequestMessage(channel: IChannel; interfaceName: String; messageName: String)

 

void InitializeRequestMessage(IChannel channel, String interfaceName, String messageName)

 

Sub InitializeRequestMessage(channel As IChannel, interfaceName As String, messageName As String)

Parameters:

  • channel:
  • interfaceName:
  • messageName:

InitializeRequestMessage (IChannel, String, String, String)    (declared in Message)

 

method InitializeRequestMessage(channel: IChannel; libraryName: String; interfaceName: String; messageName: String)

 

void InitializeRequestMessage(IChannel channel, String libraryName, String interfaceName, String messageName)

 

Sub InitializeRequestMessage(channel As IChannel, libraryName As String, interfaceName As String, messageName As String)

Parameters:

  • channel:
  • libraryName:
  • interfaceName:
  • messageName:

InitializeResponseMessage (IChannel, String, String)    (declared in Message)

Should be implemented by Message components to initialize a Response message.

 

method InitializeResponseMessage(channel: IChannel; interfaceName: String; messageName: String)

 

void InitializeResponseMessage(IChannel channel, String interfaceName, String messageName)

 

Sub InitializeResponseMessage(channel As IChannel, interfaceName As String, messageName As String)

Parameters:

  • channel:
  • interfaceName:
  • messageName:

InitializeResponseMessage (IChannel, String, String, String)    (declared in Message)

 

method InitializeResponseMessage(channel: IChannel; libraryName: String; interfaceName: String; messageName: String)

 

void InitializeResponseMessage(IChannel channel, String libraryName, String interfaceName, String messageName)

 

Sub InitializeResponseMessage(channel As IChannel, libraryName As String, interfaceName As String, messageName As String)

Parameters:

  • channel:
  • libraryName:
  • interfaceName:
  • messageName:

InitializeSerializer  protected

 

method InitializeSerializer

 

void InitializeSerializer()

 

Sub InitializeSerializer()

ProcessException  protected    (declared in Message)

 

method ProcessException

 

void ProcessException()

 

Sub ProcessException()

Read    (declared in Message)

Calls the appropriate method for reading the given Type (such as ReadString or ReadInt32). If the type is unsupported, an exception is raised. Objects can be written to the Serializer using the Write method. You will usually not need to override this method when implementing a custom Serializer.

 

method Read(name: String; type: Type; format: StreamingFormat): Object

 

Object Read(String name, Type type, StreamingFormat format)

 

Function Read(name As String, type As Type, format As StreamingFormat) As Object

Parameters:

  • name:
  • type:
  • format:

ReadAnsiString    (declared in Message)

Should be implemented to read an ANSI String value from the message.

 

method ReadAnsiString(name: String): String

 

String ReadAnsiString(String name)

 

Function ReadAnsiString(name As String) As String

Parameters:

  • name:

ReadBoolean    (declared in Message)

 

method ReadBoolean(name: String): Boolean

 

Boolean ReadBoolean(String name)

 

Function ReadBoolean(name As String) As Boolean

Parameters:

  • name:

ReadCurrency    (declared in Message)

 

method ReadCurrency(name: String): Decimal

 

Decimal ReadCurrency(String name)

 

Function ReadCurrency(name As String) As Decimal

Parameters:

  • name:

ReadDateTime    (declared in Message)

 

method ReadDateTime(name: String): DateTime

 

DateTime ReadDateTime(String name)

 

Function ReadDateTime(name As String) As DateTime

Parameters:

  • name:

ReadDecimal    (declared in Message)

 

method ReadDecimal(name: String): Decimal

 

Decimal ReadDecimal(String name)

 

Function ReadDecimal(name As String) As Decimal

Parameters:

  • name:

ReadDouble    (declared in Message)

 

method ReadDouble(name: String): Double

 

Double ReadDouble(String name)

 

Function ReadDouble(name As String) As Double

Parameters:

  • name:

ReadEnum    (declared in Message)

 

method ReadEnum(name: String; type: Type): Enum

 

Enum ReadEnum(String name, Type type)

 

Function ReadEnum(name As String, type As Type) As Enum

Parameters:

  • name:
  • type:

ReadException

Reads the current message as an exception, then returns a new ServerException instance, properly initialized with the message values.

 

method ReadException: Exception

 

Exception ReadException()

 

Function ReadException() As Exception

ReadFromStream    (declared in Message)

Should be implemented to read the contents of the message from the given stream.

 

method ReadFromStream(stream: Stream)

 

void ReadFromStream(Stream stream)

 

Sub ReadFromStream(stream As Stream)

Parameters:

  • stream:

ReadGuid    (declared in Message)

 

method ReadGuid(name: String): Guid

 

Guid ReadGuid(String name)

 

Function ReadGuid(name As String) As Guid

Parameters:

  • name:

ReadInt32    (declared in Message)

 

method ReadInt32(name: String): Int32

 

Int32 ReadInt32(String name)

 

Function ReadInt32(name As String) As Int32

Parameters:

  • name:

ReadInt64    (declared in Message)

 

method ReadInt64(name: String): Int64

 

Int64 ReadInt64(String name)

 

Function ReadInt64(name As String) As Int64

Parameters:

  • name:

ReadUtf8String    (declared in Message)

 

method ReadUtf8String(name: String): String

 

String ReadUtf8String(String name)

 

Function ReadUtf8String(name As String) As String

Parameters:

  • name:

ReadVariant    (declared in Message)

 

method ReadVariant(name: String): Object

 

Object ReadVariant(String name)

 

Function ReadVariant(name As String) As Object

Parameters:

  • name:

ReadWideString    (declared in Message)

Should be implemented to read an Unicode Wide String value from the message.

 

method ReadWideString(name: String): String

 

String ReadWideString(String name)

 

Function ReadWideString(name As String) As String

Parameters:

  • name:

ReadXml    (declared in Message)

 

method ReadXml(name: String): XmlNode

 

XmlNode ReadXml(String name)

 

Function ReadXml(name As String) As XmlNode

Parameters:

  • name:

SetAttributes    (declared in Message)

 

method SetAttributes(channel: IChannel; attributeNames: array of String; attributeValues: array of String)

 

void SetAttributes(IChannel channel, String[] attributeNames, String[] attributeValues)

 

Sub SetAttributes(channel As IChannel, attributeNames As String(), attributeValues As String())

Parameters:

  • channel:
  • attributeNames:
  • attributeValues:

TriggerAfterReadMessageParam (String, Object)  protected    (declared in Message)

 

method TriggerAfterReadMessageParam(name: String; parameter: Object)

 

void TriggerAfterReadMessageParam(String name, Object parameter)

 

Sub TriggerAfterReadMessageParam(name As String, parameter As Object)

Parameters:

  • name:
  • parameter:

TriggerAfterReadMessageParam (String, Object, Type)  protected    (declared in Message)

 

method TriggerAfterReadMessageParam(name: String; parameter: Object; type: Type)

 

void TriggerAfterReadMessageParam(String name, Object parameter, Type type)

 

Sub TriggerAfterReadMessageParam(name As String, parameter As Object, type As Type)

Parameters:

  • name:
  • parameter:
  • type:

TriggerAfterReadMessageParam (String, Object, Type, StreamingFormat)  protected    (declared in Message)

 

method TriggerAfterReadMessageParam(name: String; parameter: Object; type: Type; format: StreamingFormat)

 

void TriggerAfterReadMessageParam(String name, Object parameter, Type type, StreamingFormat format)

 

Sub TriggerAfterReadMessageParam(name As String, parameter As Object, type As Type, format As StreamingFormat)

Parameters:

  • name:
  • parameter:
  • type:
  • format:

TriggerAfterUnwrapEnvelopes  protected    (declared in Message)

 

method TriggerAfterUnwrapEnvelopes(stream: Stream)

 

void TriggerAfterUnwrapEnvelopes(Stream stream)

 

Sub TriggerAfterUnwrapEnvelopes(stream As Stream)

Parameters:

  • stream:

TriggerAfterWrapEnvelopes  protected    (declared in Message)

 

method TriggerAfterWrapEnvelopes(stream: Stream)

 

void TriggerAfterWrapEnvelopes(Stream stream)

 

Sub TriggerAfterWrapEnvelopes(stream As Stream)

Parameters:

  • stream:

TriggerBeforeUnwrapEnvelopes  protected    (declared in Message)

 

method TriggerBeforeUnwrapEnvelopes(stream: Stream)

 

void TriggerBeforeUnwrapEnvelopes(Stream stream)

 

Sub TriggerBeforeUnwrapEnvelopes(stream As Stream)

Parameters:

  • stream:

TriggerBeforeWrapEnvelopes  protected    (declared in Message)

 

method TriggerBeforeWrapEnvelopes(stream: Stream)

 

void TriggerBeforeWrapEnvelopes(Stream stream)

 

Sub TriggerBeforeWrapEnvelopes(stream As Stream)

Parameters:

  • stream:

TriggerBeforeWriteMessageParam (String, Object)  protected    (declared in Message)

 

method TriggerBeforeWriteMessageParam(name: String; parameter: Object)

 

void TriggerBeforeWriteMessageParam(String name, Object parameter)

 

Sub TriggerBeforeWriteMessageParam(name As String, parameter As Object)

Parameters:

  • name:
  • parameter:

TriggerBeforeWriteMessageParam (String, Object, Type)  protected    (declared in Message)

 

method TriggerBeforeWriteMessageParam(name: String; parameter: Object; type: Type)

 

void TriggerBeforeWriteMessageParam(String name, Object parameter, Type type)

 

Sub TriggerBeforeWriteMessageParam(name As String, parameter As Object, type As Type)

Parameters:

  • name:
  • parameter:
  • type:

TriggerBeforeWriteMessageParam (String, Object, Type, StreamingFormat)  protected    (declared in Message)

 

method TriggerBeforeWriteMessageParam(name: String; parameter: Object; type: Type; format: StreamingFormat)

 

void TriggerBeforeWriteMessageParam(String name, Object parameter, Type type, StreamingFormat format)

 

Sub TriggerBeforeWriteMessageParam(name As String, parameter As Object, type As Type, format As StreamingFormat)

Parameters:

  • name:
  • parameter:
  • type:
  • format:

TriggerOnFinalizeMessage  protected    (declared in Message)

 

method TriggerOnFinalizeMessage

 

void TriggerOnFinalizeMessage()

 

Sub TriggerOnFinalizeMessage()

TriggerOnInitializeMessage  protected    (declared in Message)

 

method TriggerOnInitializeMessage(channel: IChannel; interfaceName: String; messageName: String; exception: Exception)

 

void TriggerOnInitializeMessage(IChannel channel, String interfaceName, String messageName, Exception exception)

 

Sub TriggerOnInitializeMessage(channel As IChannel, interfaceName As String, messageName As String, exception As Exception)

Parameters:

  • channel:
  • interfaceName:
  • messageName:
  • exception:

UnwrapEnvelopes  protected    (declared in Message)

 

method UnwrapEnvelopes(stream: Stream): Stream

 

Stream UnwrapEnvelopes(Stream stream)

 

Function UnwrapEnvelopes(stream As Stream) As Stream

Parameters:

  • stream:

Validate    (declared in Message)

 

method Validate(content: String): Boolean

 

Boolean Validate(String content)

 

Function Validate(content As String) As Boolean

Parameters:

  • content:

WrapEnvelopes  protected    (declared in Message)

 

method WrapEnvelopes(stream: Stream): Stream

 

Stream WrapEnvelopes(Stream stream)

 

Function WrapEnvelopes(stream As Stream) As Stream

Parameters:

  • stream:

Write    (declared in Message)

 

method Write(name: String; value: Object; type: Type; format: StreamingFormat)

 

void Write(String name, Object value, Type type, StreamingFormat format)

 

Sub Write(name As String, value As Object, type As Type, format As StreamingFormat)

Parameters:

  • name:
  • value:
  • type:
  • format:

WriteAnsiString    (declared in Message)

Should be implemented to write an ANSI String value to the message.

 

method WriteAnsiString(name: String; value: String)

 

void WriteAnsiString(String name, String value)

 

Sub WriteAnsiString(name As String, value As String)

Parameters:

  • name:
  • value:

WriteBoolean    (declared in Message)

 

method WriteBoolean(name: String; value: Boolean)

 

void WriteBoolean(String name, Boolean value)

 

Sub WriteBoolean(name As String, value As Boolean)

Parameters:

  • name:
  • value:

WriteCurrency    (declared in Message)

 

method WriteCurrency(name: String; value: Decimal)

 

void WriteCurrency(String name, Decimal value)

 

Sub WriteCurrency(name As String, value As Decimal)

Parameters:

  • name:
  • value:

WriteDateTime    (declared in Message)

 

method WriteDateTime(name: String; value: DateTime)

 

void WriteDateTime(String name, DateTime value)

 

Sub WriteDateTime(name As String, value As DateTime)

Parameters:

  • name:
  • value:

WriteDecimal    (declared in Message)

 

method WriteDecimal(name: String; value: Decimal)

 

void WriteDecimal(String name, Decimal value)

 

Sub WriteDecimal(name As String, value As Decimal)

Parameters:

  • name:
  • value:

WriteDouble    (declared in Message)

 

method WriteDouble(name: String; value: Double)

 

void WriteDouble(String name, Double value)

 

Sub WriteDouble(name As String, value As Double)

Parameters:

  • name:
  • value:

WriteEnum    (declared in Message)

 

method WriteEnum(name: String; value: Enum)

 

void WriteEnum(String name, Enum value)

 

Sub WriteEnum(name As String, value As Enum)

Parameters:

  • name:
  • value:

WriteEnvelopeHeader    (declared in Message)

 

method WriteEnvelopeHeader(envelope: MessageEnvelope; stream: Stream)

 

void WriteEnvelopeHeader(MessageEnvelope envelope, Stream stream)

 

Sub WriteEnvelopeHeader(envelope As MessageEnvelope, stream As Stream)

Parameters:

  • envelope:
  • stream:

WriteException

Writes the provided exception to the current message.

 

method WriteException(exception: Exception)

 

void WriteException(Exception exception)

 

Sub WriteException(exception As Exception)

Parameters:

  • exception: Exception that should be serialized and sent to the client application

WriteGuid    (declared in Message)

 

method WriteGuid(name: String; value: Guid)

 

void WriteGuid(String name, Guid value)

 

Sub WriteGuid(name As String, value As Guid)

Parameters:

  • name:
  • value:

WriteInt32    (declared in Message)

 

method WriteInt32(name: String; value: Int32)

 

void WriteInt32(String name, Int32 value)

 

Sub WriteInt32(name As String, value As Int32)

Parameters:

  • name:
  • value:

WriteInt64    (declared in Message)

 

method WriteInt64(name: String; value: Int64)

 

void WriteInt64(String name, Int64 value)

 

Sub WriteInt64(name As String, value As Int64)

Parameters:

  • name:
  • value:

WriteToStream    (declared in Message)

 

method WriteToStream(stream: Stream)

 

void WriteToStream(Stream stream)

 

Sub WriteToStream(stream As Stream)

Parameters:

  • stream:

WriteUtf8String    (declared in Message)

 

method WriteUtf8String(name: String; value: String)

 

void WriteUtf8String(String name, String value)

 

Sub WriteUtf8String(name As String, value As String)

Parameters:

  • name:
  • value:

WriteVariant    (declared in Message)

 

method WriteVariant(name: String; value: Object)

 

void WriteVariant(String name, Object value)

 

Sub WriteVariant(name As String, value As Object)

Parameters:

  • name:
  • value:

WriteWideString    (declared in Message)

 

method WriteWideString(name: String; value: String)

 

void WriteWideString(String name, String value)

 

Sub WriteWideString(name As String, value As String)

Parameters:

  • name:
  • value:

WriteXml    (declared in Message)

 

method WriteXml(name: String; value: XmlNode)

 

void WriteXml(String name, XmlNode value)

 

Sub WriteXml(name As String, value As XmlNode)

Parameters:

  • name:
  • value:

 

AfterReadMessageParam    (declared in Message)

Gets triggered after a parameter was read from the incoming message. You can use this event to inspect the parameter name, type and value.

 

event AfterReadMessageParam: EventHandler<MessageParamEventArgs>;

 

delegate EventHandler<MessageParamEventArgs> AfterReadMessageParam()

 

Event AfterReadMessageParam As EventHandler<MessageParamEventArgs>

AfterUnwrapEnvelopes    (declared in Message)

 

event AfterUnwrapEnvelopes: EventHandler<StreamOperationEventArgs>;

 

delegate EventHandler<StreamOperationEventArgs> AfterUnwrapEnvelopes()

 

Event AfterUnwrapEnvelopes As EventHandler<StreamOperationEventArgs>

AfterWrapEnvelopes    (declared in Message)

 

event AfterWrapEnvelopes: EventHandler<StreamOperationEventArgs>;

 

delegate EventHandler<StreamOperationEventArgs> AfterWrapEnvelopes()

 

Event AfterWrapEnvelopes As EventHandler<StreamOperationEventArgs>

BeforeUnwrapEnvelopes    (declared in Message)

 

event BeforeUnwrapEnvelopes: EventHandler<StreamOperationEventArgs>;

 

delegate EventHandler<StreamOperationEventArgs> BeforeUnwrapEnvelopes()

 

Event BeforeUnwrapEnvelopes As EventHandler<StreamOperationEventArgs>

BeforeWrapEnvelopes    (declared in Message)

 

event BeforeWrapEnvelopes: EventHandler<StreamOperationEventArgs>;

 

delegate EventHandler<StreamOperationEventArgs> BeforeWrapEnvelopes()

 

Event BeforeWrapEnvelopes As EventHandler<StreamOperationEventArgs>

BeforeWriteMessageParam    (declared in Message)

Gets triggered before a parameter gets written to the outgoing message. You can use this event to inspect the parameter name, type and value.

 

event BeforeWriteMessageParam: EventHandler<MessageParamEventArgs>;

 

delegate EventHandler<MessageParamEventArgs> BeforeWriteMessageParam()

 

Event BeforeWriteMessageParam As EventHandler<MessageParamEventArgs>

OnFinalizeMessage    (declared in Message)

Gets triggered when FinalizeMessage method was called to finalize an outgoing message just before it will be actually sent across the wire to the remote system.

 

event OnFinalizeMessage: EventHandler<EventArgs>;

 

delegate EventHandler<EventArgs> OnFinalizeMessage()

 

Event OnFinalizeMessage As EventHandler<EventArgs>

OnInitializeMessage    (declared in Message)

Gets triggered when InitializeMessage method is called to initialize an outgoing message. You can hook into this event to inspect information such as the service name and message (method) name, as well as the channel that the message is being dispatched through.

 

event OnInitializeMessage: EventHandler<InitMessageEventArgs>;

 

delegate EventHandler<InitMessageEventArgs> OnInitializeMessage()

 

Event OnInitializeMessage As EventHandler<InitMessageEventArgs>