Struct WireFrame

This struct defines a frame transmitted as a part of WireMsg which can be used for transport or session management needs

Inherited Members
System.ValueType.Equals(System.Object)
System.ValueType.GetHashCode()
System.Object.Equals(System.Object, System.Object)
System.Object.GetType()
System.Object.ReferenceEquals(System.Object, System.Object)
Namespace: Azos.Glue.Native
Assembly: Azos.dll
Syntax
public struct WireFrame
Remarks

Frame Content:

MAGIC ushort 2 byte - 0xABBA VESRION byte 1 byte TYPE {G|H|E|R|D} 1 byte FORMAT int32BE 4 bytes ONEWAY {0|!0} 1 byte REQID FID 8 bytes HDRSLEN int32BE 4 bytes ------------ 21 bytes

HDRSCONTENT utf8_char[x] HDRSLEN bytes

               21 + HDRSLEN  bytes total size

Constructors

WireFrame(FrameType, Int32, Boolean, FID, String)

Declaration
public WireFrame(FrameType type, int format, bool oneWay, FID reqID, string headersContent = null)
Parameters
Type Name Description
FrameType type
System.Int32 format
System.Boolean oneWay
FID reqID
System.String headersContent

WireFrame(Int32, Boolean, FID, String)

Declaration
public WireFrame(int format, bool oneWay, FID reqID, string headersContent = null)
Parameters
Type Name Description
System.Int32 format
System.Boolean oneWay
FID reqID
System.String headersContent

WireFrame(Stream)

Reconstruct (deserializes) frame from the stream. May throw on error

Declaration
public WireFrame(Stream stream)
Parameters
Type Name Description
System.IO.Stream stream

Fields

FID_LENGTH

Declaration
public const byte FID_LENGTH = 8
Field Value
Type Description
System.Byte

FRAME_LENGTH

Declaration
public const byte FRAME_LENGTH = 21
Field Value
Type Description
System.Byte

HEADERS_ENCODING

Declaration
public static readonly Encoding HEADERS_ENCODING
Field Value
Type Description
System.Text.Encoding

MAGIC

Declaration
public const ushort MAGIC = 43962
Field Value
Type Description
System.UInt16

MAX_HEADERS_BYTE_LENGTH

Declaration
public const int MAX_HEADERS_BYTE_LENGTH = 4194304
Field Value
Type Description
System.Int32

SLIM_FORMAT

Declaration
public const int SLIM_FORMAT = 1397508429
Field Value
Type Description
System.Int32

VERSION

Declaration
public const byte VERSION = 1
Field Value
Type Description
System.Byte

Properties

Format

Format used for payload encoding, use FORMAT_SLIM as a default constant

Declaration
public int Format { get; }
Property Value
Type Description
System.Int32

Headers

Optional frame headers parsed from XML HeadersContent

Declaration
public IConfigSectionNode Headers { get; }
Property Value
Type Description
IConfigSectionNode

HeadersContent

Optional frame headers content - an unparsed XML string

Declaration
public string HeadersContent { get; }
Property Value
Type Description
System.String

Length

The total byte size of the frame that includes the length of headers (if any)

Declaration
public int Length { get; }
Property Value
Type Description
System.Int32

OneWay

True if the requesting party does not expect a response

Declaration
public bool OneWay { get; }
Property Value
Type Description
System.Boolean

RequestID

RequestID of the request in following message or echo response message

Declaration
public FID RequestID { get; }
Property Value
Type Description
FID

Type

Returns type of this frame

Declaration
public FrameType Type { get; }
Property Value
Type Description
FrameType

Methods

Serialize(Stream)

Serialize the frame to the given stream returning the byte size of the frame

Declaration
public int Serialize(Stream stream)
Parameters
Type Name Description
System.IO.Stream stream
Returns
Type Description
System.Int32

ToString()

Declaration
public override string ToString()
Returns
Type Description
System.String
Overrides
System.ValueType.ToString()

Extension Methods