22
edits
Changes
Add section on boxing single values as objects
When using optional fields, be wary that if the field contains bad data or otherwise fails to serialize, the error will be silently caught, and the field will serialize as the default value instead!
When using optional fields, be wary that if the field contains bad data or otherwise fails to serialize, the error will be silently caught, and the field will serialize as the default value instead!
===Boxing values as objects===
In some situations, we may need to serialize a single value as a single-field object. We can use fieldOf to box a single value in this way without needing the entire RecordCodecBuilder process:
<syntaxhighlight lang="java">
public static final Codec<Integer> BOXED_INT_CODEC = Codec.INT.fieldOf("value").codec();
JsonElement value = BOXED_INT_CODEC.encodeStart(JsonOps.INSTANCE, 5).result().get();
</syntaxhighlight>
Which serializes the following output:
<syntaxhighlight lang="json">
{"value":5}
</syntaxhighlight>
==Unit==
==Unit==