const mixinafJson::JsonConverters

The default set of JSON <-> Fantom converters.

Converts a JSON string to the given Fantom type. If fantomType is null, then null is always returned.

Converts a list of JSON values to the given Fantom (non-list) type.

fromJsonList(list, MyEntity#)

Convenience for calling fromJsonVal() with a cast.

Converts a JSON object to the given Fantom type.

Convenience for calling fromJsonVal() with a cast.

Converts a JSON value to the given Fantom type. If fantomType is null then null is always returned.

jsonVal is nullable so converters can choose whether or not to create empty lists and maps.

Returns the Converter instance used to convert the given type.

Returns a new JsonConverters instance.

If converters is null then defConvs is used. Common options are:

afJson.makeEntity        : |Type type, Field:Obj? fieldVals->Obj?| { BeanBuilder.build(type, vals) }
afJson.strictMode        : false
afJson.dateFormat        : "YYYY-MM-DD"
afJson.dateTimeFormat    : "YYYY-MM-DD'T'hh:mm:ss.FFFz"
afJson.propertyCache     : JsonPropertyCache()
afJson.serializableMode  : true

Override makeEntity to have IoC create entity instances. Set strictMode to true to Err if the JSON contains unmapped data.

Serializable Mode is where all non-transient fields are converted, regardless of any @JsonProperty facets. Data from @JsonProperty facets, however, is still honoured if defined.

Returns a fn that normalises .NET and snake_case key names into standard Fantom camelCase names.

.NET examples
-------------
UniqueID        -->  uniqueId
SWVersion       -->  swVersion
MegaVERIndex    -->  megaVerIndex
UtilITEMS.Rec   -->  utilItems.rec

Snake_case examples
-------------------
unique_id       -->  uniqueId
sw_Version      -->  swVersion
mega_VER_Index  -->  megaVerIndex

Use as a hook option:

converters := JsonConverters(null, [
    "afJson.fromJsonHook" : JsonConverters.normaliseKeyNamesFn
])

Converts the given Fantom object to its JSON string representation.

options is passed to JsonWriter, so may just be true for pretty printing.

Deeply converts the given Fantom List to its JSON representation.

Convenience for calling toJsonVal() with a cast.

Converts the given Fantom object to its JSON object representation.

Convenience for calling toJsonVal() with a cast.

Converts the given Fantom object to its JSON representation.

fantomObj is nullable so converters can create empty / default objects. fantomType in case fantomObj is null, but defaults to fantomObj?.typeof.

Returns a new JsonConverters whose options are overridden with the given ones.