OpenAPI Generator Data Mapping — Mapping OpenAPI Data Types Across Language Ecosystems

In this tutorial, you will learn about OpenAPI Generator Data Mapping. We cover key concepts, practical examples, and best practices to help you master this topic.

OpenAPI Generator data maps OpenAPI schema types to native language types, handling format-specific mappings (date, date-time, byte, binary), nullable type handling, and custom type overrides.

flowchart LR
    A["OpenAPI Schema Type"] --> B["string + format"]
    A --> C["integer + format"]
    A --> D["number + format"]
    A --> E["boolean"]
    A --> F["array"]
    A --> G["object"]

    B --> B1["string: str/String"]
    B --> B2["date: date/LocalDate"]
    B --> B3["date-time: datetime/Instant"]
    B --> B4["byte: bytes/byte[]"]
    B --> B5["binary: IO/Stream"]
    B --> B6["email: str/String (validated)"]
    B --> B7["uri: str/URI"]

    C --> C1["int32: int/Int32"]
    C --> C2["int64: long/Int64"]
    C --> C3["untyped: int/BigInteger"]

    D --> D1["float: float/Float"]
    D --> D2["double: double/Double"]

What's Next

Configure mappings in {{< ilink "OpenAPI" "OpenAPI Generator Custom Types" }} and apply {{< ilink "OpenAPI" "OpenAPI Generator Best Practices" }}.