Class ListingStatusJsonConverter

Namespace

DatabentoDotNet.Reference.Json

Assembly

DatabentoDotNet.Reference.dll

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

public sealed class ListingStatusJsonConverter : JsonConverter<ListingStatus>

Inheritance

object

JsonConverter

JsonConverter<ListingStatus>

ListingStatusJsonConverter

Inherited Members

JsonConverter<ListingStatus>.CanConvert(Type)

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

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

JsonConverter<ListingStatus>.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 LISTSTAT group lists no blank entry, and upstream declares the field pub listing_status: ListingStatus (security.rs:187) rather than an Option.

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

Write(Utf8JsonWriter, ListingStatus, 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(ListingStatus).

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 ListingStatus.

public override ListingStatus 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

ListingStatus

The converted value.

Write(Utf8JsonWriter, ListingStatus, JsonSerializerOptions)

Writes a specified value as JSON.

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

Parameters

writer Utf8JsonWriter

The writer to write to.

value ListingStatus

The value to convert to JSON.

options JsonSerializerOptions

An object that specifies serialization options to use.