mirror of
https://github.com/OpenAPITools/openapi-generator.git
synced 2026-03-20 13:49:07 +00:00
* Adds "useTags" option to all jaxrs code generators (AbstractJAXRSServerCodegen):
- jaxrs-jersey
- jaxrs-spec
- jaxrs-cxf-cdi
- jaxrs-resteasy
- jaxrs-cxf
- jaxrs-cxf-extended
- java-msf4j
- jaxrs-resteasy-eap
* jaxrs-spec
- Changed handling of root paths: e.g "/:", "/{id}:" to simplify code and create a more consistent behaviour
-- old: use tag for classname
-- new: use tag only if useTags is enabled, use "DefaultApi" if not
* @path class level annotation
- for all generators above and the microprofile generator (uses same jaxrs postprocessing)
- extended the "commonPath" to contain more than only the root path if possible
- e.g. "/group1/subgroup1/op1" -> "/group1/subgroup1" is moved to class level annotation
JAX-RS server with OpenAPI
Overview
This server was generated by the OpenAPI Generator project. By using an OpenAPI-Spec, you can easily generate a server stub.
This is an example of building a OpenAPI-enabled JAX-RS server. This example uses the JAX-RS framework.
The JAX-RS implementation needs to be provided by the application server you are deploying on.
To run the server from the command line, you can use maven to provision an start a TomEE Server. Please execute the following:
mvn -Dtomee-embedded-plugin.http=80 package org.apache.tomee.maven:tomee-embedded-maven-plugin:7.0.5:run
You can then call your server endpoints under:
http://localhost:80/v2/
Note that if you have configured the host to be something other than localhost, the calls through
swagger-ui will be directed to that host and not localhost!