Class MandVoluJsonConverter

Namespace

DatabentoDotNet.Reference.Json

Assembly

DatabentoDotNet.Reference.dll

Reads and writes MandVolu as its one-character wire code.

public sealed class MandVoluJsonConverter : JsonConverter<MandVolu>

Inheritance

object

JsonConverter

JsonConverter<MandVolu>

MandVoluJsonConverter

Inherited Members

JsonConverter<MandVolu>.CanConvert(Type)

JsonConverter<MandVolu>.ReadAsPropertyName(ref Utf8JsonReader, Type, JsonSerializerOptions)

JsonConverter<MandVolu>.WriteAsPropertyName(Utf8JsonWriter, MandVolu, JsonSerializerOptions)

JsonConverter<MandVolu>.Type

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.ReferenceEquals(object, object)

object.ToString()

Remarks

An unrecognised code throws. That is the deliberate difference from the ten open code types ReferenceCodeJsonConverter<T> serves, and the argument for it is in ReferenceWireStrings: these alphabets were probed against the live server, so a code outside one means this library is stale rather than that the caller should be handed an opaque string. The offending code is in the message. So is a string whose length is not one, which is unrecognised for the same reason.

A blank is rejected, and the dictionary is the reason. The MANDVOLU group lists no blank entry, and upstream declares the field pub mand_volu_flag: MandVolu (corporate.rs:303) rather than an Option.

Attached to the type by [JsonConverter], which is what the System.Text.Json source generator reads — so MandVolu is AOT-safe wherever a generated context holds a model carrying one, with no converter to register at a call site.

Write(Utf8JsonWriter, MandVolu, JsonSerializerOptions) exists so the type is usable in a consumer's own serialization; nothing in this library calls it, and upstream gives these enums a Serialize impl for the same reason (enums.rs:65-72).

Properties

HandleNull

true, so a JSON null reaches Read(ref Utf8JsonReader, Type, JsonSerializerOptions) and is rejected with a message rather than silently becoming default(MandVolu).

public override bool HandleNull { get; }

Property Value

bool

Remarks

System.Text.Json already passes a null token to a value type's converter, so this restates the framework default rather than changing it. It is stated because the rejection below is the behaviour under test, and a default that quietly changed would turn it into an undefined enum value instead of an exception.

Methods

Read(ref Utf8JsonReader, Type, JsonSerializerOptions)

Reads and converts the JSON to type MandVolu.

public override MandVolu Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)

Parameters

reader Utf8JsonReader

The reader.

typeToConvert Type

The type to convert.

options JsonSerializerOptions

An object that specifies serialization options to use.

Returns

MandVolu

The converted value.

Write(Utf8JsonWriter, MandVolu, JsonSerializerOptions)

Writes a specified value as JSON.

public override void Write(Utf8JsonWriter writer, MandVolu value, JsonSerializerOptions options)

Parameters

writer Utf8JsonWriter

The writer to write to.

value MandVolu

The value to convert to JSON.

options JsonSerializerOptions

An object that specifies serialization options to use.