MoneyOfTCurrencyJsonConverter<TCurrency> Class

Definition

Namespace

Bodu.Financial.Serialization.Json

Assembly

Bodu.Financial.Serialization.Json.dll

Package

Bodu.Financial.Serialization.Json 1.0.0

Source

MoneyOfTCurrencyJsonConverter{T}.cs

Converts a Money<TCurrency> to and from JSON using the policy supplied at construction.

public sealed class MoneyOfTCurrencyJsonConverter<TCurrency> : JsonConverter<Money<TCurrency>> where TCurrency : ICurrency

Type Parameters

TCurrency

The currency type identifier.

Inheritance

object

JsonConverter

JsonConverter<Money<TCurrency>>

MoneyOfTCurrencyJsonConverter<TCurrency>

Inherited Members

JsonConverter<Money<TCurrency>>.CanConvert(Type)

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

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

JsonConverter<Money<TCurrency>>.HandleNull

JsonConverter<Money<TCurrency>>.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 converter shape is selected by FinancialJsonPolicy:

• Strict - canonical object form { "amount": 19.99, "currency": "USD" }; rejects duplicate properties and currency mismatches.
• Lenient - same shape as Strict, with additional tolerance for lowercase currency codes and whitespace around the currency value.
• Compact - string form "19.99 USD"; reads accept either ISO-prefix or ISO-suffix arrangement and reuse TryParse(ReadOnlySpan<char>, IFormatProvider?, out Money<TCurrency>).

Constructors

MoneyOfTCurrencyJsonConverter()

Initializes a new instance of the MoneyOfTCurrencyJsonConverter<TCurrency> class configured for the Strict shape.

public MoneyOfTCurrencyJsonConverter()

MoneyOfTCurrencyJsonConverter(FinancialJsonPolicy)

Initializes a new instance of the MoneyOfTCurrencyJsonConverter<TCurrency> class configured for the supplied policy.

public MoneyOfTCurrencyJsonConverter(FinancialJsonPolicy policy)

Parameters

policy FinancialJsonPolicy

The serialization policy.

Exceptions

ArgumentOutOfRangeException

policy is not a defined FinancialJsonPolicy value.

Methods

Read(ref Utf8JsonReader, Type, JsonSerializerOptions)

Reads and converts the JSON to type Money.

public override Money<TCurrency> 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

Money<TCurrency>

The converted value.

Write(Utf8JsonWriter, Money<TCurrency>, JsonSerializerOptions)

Writes a specified value as JSON.

public override void Write(Utf8JsonWriter writer, Money<TCurrency> value, JsonSerializerOptions options)

Parameters

writer Utf8JsonWriter

The writer to write to.

value Money<TCurrency>

The value to convert to JSON.

options JsonSerializerOptions

An object that specifies serialization options to use.

Applies to

Product	Versions
.NET	8, 10