JavaJaxRS.resteasy.README.mustache Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of openapi-generator Show documentation

There is a newer version: 7.6.0

# JAX-RS/RESTEasy server with OpenAPI

## Overview
This server was generated by the [OpenAPI Generator](https://openapi-generator.tech) project. By using an
[OpenAPI-Spec](https://openapis.org), 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](https://jax-rs-spec.java.net/) framework.
RESTEasy is used as JAX-RS implementation library and is defined as dependency.

To run the server, please execute the following:

```
mvn -Djetty.http.port={{serverPort}} package org.eclipse.jetty:jetty-maven-plugin:run
```

You can then view the OpenAPI v2 specification here:

```
http://localhost:{{serverPort}}{{contextPath}}/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!