A light-weight, fast OpenAPI 3.0 parser and validator with minimum third party dependencies.
Stack Overflow | Google Group | Gitter Chat | Subreddit | Youtube Channel | Documentation | Contribution Guide |
It is based on the generated code from KaiZen OpenAPI Parser without dependency on javaparser-core, guava, commons-cli, commons-io, javax.mail and guice.
OpenAPI path keys are relative to the first server URL. With server /v1, use
path key /pets to expose /v1/pets (endpoint /v1/pets@get). Earlier versions
also stripped the server prefix from specification keys, allowing a redundant
key /v1/pets to serve that same URL. That rewriting is removed: a key
/v1/pets now describes /v1/v1/pets with endpoint /v1/v1/pets@get.
Before upgrading, remove redundant server prefixes from path keys if the service must keep its current URLs and endpoint identifiers. Review endpoint-based Lambda mappings, security configuration, metrics and dashboards when intentionally retaining repeated prefixes. A leading segment equal to the server prefix can also be intentional, so the parser does not guess which form was intended. Unprefixed request paths remain supported for compatibility.
Request-prefix strategies use a Caffeine cache with a maximum size of 64 after maintenance; concurrent activity can temporarily exceed that size. Literal base paths use string comparisons, while regex base paths use cached patterns.
The OpenAPI Parser is provided under the Eclipse Public License 1.0 following the parent KaiZen OpenAPI Parser