Class MessagePackFormatter

Namespace

StreamJsonRpc

Assembly

StreamJsonRpc.dll

Serializes JSON-RPC messages using MessagePack (a fast, compact binary format).

public class MessagePackFormatter : FormatterBase, IJsonRpcFormatterState, IJsonRpcInstanceContainer, IDisposable, IJsonRpcMessageFormatter, IJsonRpcFormatterTracingCallbacks, IJsonRpcMessageFactory

Inheritance

object

FormatterBase

MessagePackFormatter

Implements

IJsonRpcFormatterState

IJsonRpcInstanceContainer

IDisposable

IJsonRpcMessageFormatter

IJsonRpcFormatterTracingCallbacks

IJsonRpcMessageFactory

Inherited Members

FormatterBase.JsonRpc

FormatterBase.FormatterProgressTracker

FormatterBase.DuplexPipeTracker

FormatterBase.EnumerableTracker

FormatterBase.ApplicableMethodAttributeOnDeserializingMethod

FormatterBase.Dispose()

FormatterBase.Dispose(bool)

FormatterBase.TrackDeserialization(JsonRpcMessage, ReadOnlySpan<ParameterInfo>)

FormatterBase.TrackSerialization(JsonRpcMessage)

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Remarks

The MessagePack implementation used here comes from https://github.com/neuecc/MessagePack-CSharp. The README on that project site describes use cases and its performance compared to alternative .NET MessagePack implementations and this one appears to be the best by far.

Constructors

MessagePackFormatter()

Initializes a new instance of the MessagePackFormatter class.

public MessagePackFormatter()

Properties

DefaultUserDataSerializationOptions

Gets the default MessagePack.MessagePackSerializerOptions used for user data (arguments, return values and errors) in RPC calls prior to any call to SetMessagePackSerializerOptions(MessagePackSerializerOptions).

public static MessagePackSerializerOptions DefaultUserDataSerializationOptions { get; }

Property Value

MessagePackSerializerOptions

This is MessagePack.Resolvers.StandardResolverAllowPrivate.Options modified to use the MessagePack.MessagePackSecurity.UntrustedData security setting.

MultiplexingStream

Gets or sets the MultiplexingStream that may be used to establish out of band communication (e.g. marshal IDuplexPipe arguments).

public MultiplexingStream? MultiplexingStream { get; set; }

Property Value

MultiplexingStream

Methods

Deserialize(ReadOnlySequence<byte>)

Deserializes a JsonRpcMessage.

public JsonRpcMessage Deserialize(ReadOnlySequence<byte> contentBuffer)

Parameters

contentBuffer ReadOnlySequence<byte>

A sequence of bytes to deserialize.

Returns

JsonRpcMessage

The deserialized JsonRpcMessage.

GetJsonText(JsonRpcMessage)

Gets a JSON representation for a given message for tracing purposes.

public object GetJsonText(JsonRpcMessage message)

Parameters

message JsonRpcMessage

The message to be traced.

Returns

object

Any object whose ToString() method will produce a human-readable JSON string, suitable for tracing.

Serialize(IBufferWriter<byte>, JsonRpcMessage)

Serializes a JsonRpcMessage.

public void Serialize(IBufferWriter<byte> contentBuffer, JsonRpcMessage message)

Parameters

contentBuffer IBufferWriter<byte>

message JsonRpcMessage

The message to serialize.

SetMessagePackSerializerOptions(MessagePackSerializerOptions)

Sets the MessagePack.MessagePackSerializerOptions to use for serialization of user data.

public void SetMessagePackSerializerOptions(MessagePackSerializerOptions options)

Parameters

options MessagePackSerializerOptions

The options to use. Before this call, the options used come from DefaultUserDataSerializationOptions.