2026.3

Apart from a few fixes this release adds support for @HttpExchange based interfaces (#439).

Spring Boot provides two annotation families

• the standard mapping annotations, i.e., @RequestMapping, @GetMapping and friends to define server side controllers

• and the new exchange (HTTP service clients) annotations, i.e., @HttpExchange, @GetExchange and friends to define server side controllers and http clients based on the same interface.

This makes it possible to use the endpoint interfaces generated by openapi-processor-spring to call the endpoints. Spring does generate (with a few lines of configuration) the boilerplate code that is required to to call the api endpoints.

Switching between both annotation families is done in the mapping.yaml:

openapi-processor-spring: v1 # <1>

options:
  package-name: io.openapiprocesser

  spring: # <2>
    # default, i.e., mapping annotations
    #annotations: mapping
    # use exchange annotations
    annotations: exchange # <3>

There are a few things that are important here:

<1> the mapping identifier has changed. It is now expecting openapi-processor-spring instead of openapi-processor-mapping. The processor will still accept openapi-processor-mapping.

The new identifier is required to get proper editing support for the new option with the IntelliJ plugin.

<2> a new Spring specific section in the options object.

<3> the annotation family: mapping or exchange. With mapping being the default.

The openapi-processor-samples repository has a sample that provides an api endpoint and calls itself using the @HttpExchange based interface.

See the core release notes 2026.3 for the other changes.

dependency updates

• updated openapi-processor-core to 2026.3

2026.2

This release adds/fixes application/x-www-form-urlencoded handling and accepts endpoints with a single 1xx/3xx HTTP status response code as valid.

See the core release notes 2026.2 for more.

2026.1

This release adds interface mapping, alternative mapping keywords, more control over annotation placing and fixes the duplicated oneOf interface.

See the core release notes 2026.1 for more.

2025.5

This release adds OpenAPI 3.2 support and generation of unreferenced schemas.

See the core release notes 2025.6 for more.

dependency updates

• updated openapi-processor-core to 2025.6

2025.4

This release fixes a couple of issues, see the core release notes

• 2025.5.1
• 2025.5

for more.

dependency updates

• updated openapi-processor-core to 2025.5.1 (was 2025.4.1)

2025.3.1

This release fixes two enum related issues:

• prefix invalid enum values instead of stripping invalid characters at the start when converting it to a java indentifier (#350)
• allow @Values annotation at generic parameter, e.g. List<@Values(values = {...}) String> (#350)

See the core release notes 2025.4.1 for more.

dependency updates

• updated openapi-processor-core to 2025.4.1 (was 2025.4)

2025.3

This release brings two new features:

• create package-names from location (openapi-processor/openapi-processor-base#115)
• generate response status annotation (#339)

See the core release notes 2025.4 for more.

dependency updates

• updated openapi-processor-core to 2025.4 (was 2025.2)

2025.2

This release comes with a few response handling improvements and the possibility to drop endpoint parameters:

• improve handling of multiple responses pf same content type (#328)
• marker interface for response objects (openapi-processor/openapi-processor-base#247)
• drop parameter (#327)
• support result-style on all mapping levels (openapi-processor/openapi-processor-base#253)
• added missing formatter selection (#331)

See the core release notes 2025.2 for more.

dependency updates

• updated openapi-processor-core to 2025.2 (was 2025.1.1)

2025.1.1

a small bug fix release

See the core release notes 2025.1.1 for more.

dependency updates

• updated openapi-processor-core to 2025.1.1 (was 2025.1)

2025.1

do not generate accessors for pojos (then re-add with lombok), schema mappings (new), javadoc fix & improvement

See the core release notes 2025.1 for more.

dependency updates

• updated openapi-processor-core to 2025.1 (was 2024.7)