mirror of
https://github.com/OpenAPITools/openapi-generator.git
synced 2026-03-20 10:29:03 +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/Jersey 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.
Jersey is used as JAX-RS implementation, io.swagger:swagger-jersey2-jaxrs is used to derive the OpenAPI Specification from the annotated code.
To run the server, please execute the following:
mvn clean package jetty:run
You can then view the OpenAPI v2 specification here:
http://localhost:8080/v2/swagger.json
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!