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

BPMN Format

Build-time BPMN definition reader and runtime XML binding via JDK StAX.

The BPMN format module parses BPMN 2.0 XML definitions using JDK StAX — no Camunda, no Flowable, no vendor dependency. BPMN is treated as an authoring format, not a workflow engine. Definitions are parsed into BpmnIntermediateModel, then adapted into the canonical meta-model.

Documentation → All Formats →
BPMN
Capabilities

Production-ready by default

  • JDK StAX-only XML parsing — zero process engine dependency
  • XXE-safe: IS_SUPPORTING_EXTERNAL_ENTITIES=false, SUPPORT_DTD=false
  • BpmnIntermediateModel → NodeCursor adapter for unified binding
  • Mandatory ResourceLoader for classpath resolution
  • Same codegen pipeline as YAML and JSON definitions
Example

See it in action

// BPMN document binding at runtime
BindingResult<WorkflowDefinition> result =
  twinMapperRuntime.readBpmn(
    bpmnInputStream,
    WorkflowDefinition.class
  );

// Same BindingResult<T> as YAML and JSON
WorkflowDefinition workflow = result.getValue();
Related

Explore more