Type mapping

Type mapping is an important feature of the processor and helps it to create the expected code.

Using type mapping, we can tell the processor to map types (schemas) from an openapi.yaml description to a specific existing java type instead of generating a model class from the source OpenAPI type.

This can be a type created by us or a type from a framework. For example, to map paging parameters and result to the Spring types Page<> & Pageable.

It can also be used to map the OpenAPI array type to a different java collection type if the default does not fulfill our needs.

Type mapping is very flexible. It is possible to define the mapping globally, globally for a specific response or parameter or limited to a specific endpoint or even http method for an endpoint.

Type mapping also supports (nested) generic parameters to the target type. One level.

Type mapping works best with named schemas (i.e., schemas $ref erenced by their name).