Package com.kazforge.jsonapi.mapping

@NullMarked package com.kazforge.jsonapi.mapping

Backend-independent application/domain mapping contracts and values.

JSON:API mapping roles select protocol locations without replacing the backend's property configuration. Identifier conversion, resource-type registrations, and resource decorators are explicit inputs to major-specific mapper or reader construction; there is no global registry or ambient mapping configuration.

MappedDocument carries mapping-produced sparse-fieldset provenance to the document writer so validation observes the representation that was actually mapped. DomainData and IncludedResources preserve document shape and wire order for advanced heterogeneous envelopes. RelationshipLinkage is the opt-in carrier for meta owned by one relationship identifier occurrence.

Class	Description
DomainData	Primary data of a domain document envelope, preserving explicit null, single, and collection states.
DomainData.IdentifierCollection	A collection of core identifiers in wire order; defensive copy with unmodifiable view.
DomainData.NullData
DomainData.ResourceCollection	A collection of bound resource DTOs in wire order; defensive copy with unmodifiable view.
DomainData.SingleIdentifier	One core identifier as primary data; never DTO-bound.
DomainData.SingleResource	One bound resource DTO as primary data.
IdentifierConverter	Converts a domain identifier value to its JSON:API string representation, and back.
IncludedResources	Independently bound included resources of a domain document envelope.
MappedDocument	Domain-mapping result that carries the produced document plus the identities of included resources whose inbound linkage was removed by an applied sparse fieldset during that mapping call.
RelationshipDecoration	Additive relationship-level decoration for domain writes.
RelationshipLinkage<T,M>	Opt-in application-owned wrapper for one relationship linkage occurrence that carries identifier meta.
ResourceDecoration	Backend-independent additive resource-level decoration for domain writes.
ResourceDecoration.Builder	Mutable builder whose ResourceDecoration.Builder.build() result defensively copies supplied values.
ResourceDecorator<T>	Backend-independent application-provided decoration for JSON:API resource links during domain writes.
ResourceDecoratorRegistry	Immutable registry of ResourceDecorator instances keyed by application domain type.
ResourceDecoratorRegistry.Builder	Mutable builder whose ResourceDecoratorRegistry.Builder.build() result defensively copies supplied values.
ResourceTypeRegistry	Immutable, explicit mapping from JSON:API resource types to Java target types.
ResourceTypeRegistry.Builder	Builder for one immutable registry.
ResourceTypeRegistry.Registration	One explicit wire-type to Java-type registration.