MoneyJsonConverter Class

Definition

Namespace: Bodu.Financial.Serialization.Json

Assembly: Bodu.Financial.Serialization.Json.dll

Package: Bodu.Financial.Serialization.Json 1.0.0

Source: MoneyJsonConverter.cs

Converts a Money to and from JSON using the policy supplied at construction. Mirrors the shape vocabulary of MoneyOfTCurrencyJsonConverter<TCurrency> so a single FinancialJsonPolicy selection produces a coherent on-the-wire format across the monetary types.

public sealed class MoneyJsonConverter : JsonConverter<Money>

Inheritance: object

JsonConverter

JsonConverter<Money>

MoneyJsonConverter

Inherited Members: JsonConverter<Money>.CanConvert(Type)

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

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

JsonConverter<Money>.HandleNull

JsonConverter<Money>.Type

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.ReferenceEquals(object, object)

object.ToString()

Extension Methods: ComparableExtensions.AtLeast<T>(T, T, IComparer<T>)

ComparableExtensions.AtMost<T>(T, T, IComparer<T>)

ComparableExtensions.IsEqualTo<T>(T, T, IComparer<T>)

ComparableExtensions.Max<T>(T, T, IComparer<T>)

ComparableExtensions.Min<T>(T, T, IComparer<T>)

Remarks

The Strict and Lenient policies share the canonical object shape {"amount":19.99,"currency":"USD"}. A value carrying an explicit minor-unit scale - a unit price whose precision differs from the currency's registered minor units (see FromExplicitScale(decimal, CurrencyCode, int, MidpointRounding)) - additionally emits a scale property, for example {"amount":145.678912,"currency":"USD","scale":6}, and the reader reconstructs the value at that scale so the precision (including trailing zeros) survives the round-trip. A payload without scale deserializes at the registry precision, keeping previously written documents valid.

The Compact policy writes a single string, "19.99 USD", padding the amount to the value's minor units. On read, an amount printed with more fractional digits than the currency's registered minor units is reconstructed at that finer scale (via TryParse(ReadOnlySpan<char>, IFormatProvider?, out Money)), so a unit price round-trips through the compact form without separate scale metadata; a scale coarser than the registered precision is preserved only by the object shapes.

Constructors