Package com.kazforge.jsonapi.patch

@NullMarked package com.kazforge.jsonapi.patch

Backend-independent presence and requested-change contracts for resource PATCH.

PatchPresence distinguishes an omitted DTO member from a supplied value, including a supplied converted null. PatchCommand contains only supplied mapped changes; omitted attributes, relationships, and meta locations do not appear in its change list.

On the low-level path, StructuredPatch recursively preserves exactly the supplied members of a traversable structured attribute or meta value. Missing nested members remain omitted, an empty structured patch is a supplied empty object, and list, set, array, map, and relationship values remain whole replacements rather than element-addressed mutation protocols.

These values describe a requested change; they do not authorize it or mutate application state. The application owns authorization, concurrency, persistence, and mutation semantics.

Class	Description
PatchChange	Backend-independent requested change in a PatchCommand: a supplied mapped attribute, relationship, or resource-side meta location.
PatchChange.AttributeChange	A supplied mapped attribute change.
PatchChange.RelationshipChange	A supplied mapped relationship linkage replacement.
PatchChange.RelationshipMetaChange	A supplied relationship meta change for a specific mapped relationship.
PatchChange.ResourceMetaChange	A supplied resource-side meta change.
PatchCommand<T>	Immutable presence-aware resource-update command parameterized by the annotated DTO type T.
PatchPresence<T>	Backend-independent tri-state presence for a single patchable PATCH DTO member.
PatchPresence.Omitted<T>	The member was omitted from the update document; no requested change.
PatchPresence.Present<T>	The member was supplied.
StructuredMember	Backend-independent supplied nested member of a StructuredPatch.
StructuredMemberState	Sealed state algebra for one supplied nested StructuredMember of a StructuredPatch.
StructuredMemberState.Atomic	A supplied atomic nested value.
StructuredMemberState.Structured	A supplied structured nested value; an empty list is a supplied empty structured object.
StructuredPatch	Backend-independent low-level requested-change payload for a supplied structured value.