Editions Mappers Use Cases Documentation Community Download Get Started →
Format · Stable

JSON Format

Build-time JSON definition reader and runtime document binding via Jackson.

The JSON format module reads JSON definitions into the internal meta-model at build time. At runtime, it parses JSON documents into JsonNodeCursor using Jackson. Zero additional dependency cost in Spring Boot applications.

Documentation → All Formats →
JSON
Capabilities

Production-ready by default

  • JSON definition files parsed into canonical DefinitionSet
  • Runtime JsonNodeCursor backed by Jackson ObjectMapper
  • @JsonNaming, @JsonAlias, PropertyNamingStrategies on generated DTOs
  • Jackson2ObjectMapperBuilderCustomizer for Spring Boot alignment
  • MappingJackson2HttpMessageConverter integration for Spring MVC REST
Example

See it in action

// Runtime JSON binding
BindingResult<OrderRequest> result =
  twinMapperRuntime.readJson(
    jsonInputStream,
    OrderRequest.class
  );

if (result.hasErrors()) {
  List<BindingError> errors = result.getErrors();
} else {
  OrderRequest order = result.getValue();
}
Related

Explore more

YAML Format

SnakeYAML-based YAML definition reader and runtime binding.

Learn more →

BPMN Format

JDK StAX-based BPMN XML parsing.

Learn more →

Document Binding Spec

Full binding pipeline specification.

Learn more →