DUE TO SPAM, SIGN-UP IS DISABLED. Goto Selfserve wiki signup and request an account.
...
The following optional parameters can be configured in OpenApiFeature. Note that although there are some similarities with Swagger specifications 1.x/2.x, OpenAPI v3.0 is a significant revamp of the specification (in a good sense of it).
| Name | Description | Default value (if applicable) | Sample value (if applicable) | |||
|---|---|---|---|---|---|---|
| configLocation | the OpenAPI configuration location | null | /config/openapi-configuration.yml | |||
| scanKnownConfigLocations | scan known OpenAPI configuration location (classpath or filesystem), which are:
| true | true | |||
| propertiesLocation | the properties file location | /swagger.properties | /swagger.properties | |||
| securityDefinitions | a list of security definitions* | null | ["basicAuth" -> new SecurityScheme().type(Type.HTTP))] | |||
| customizer | the customizer class instance | null | new OpenApiCustomizer() | |||
| swaggerUiMavenGroupAndArtifact | the Maven artifacts to pinpoint SwaggerUI | null | "org.webjars.swagger-ui' | |||
| swaggerUiVersion | the version of SwaggerUI | null | "3.13.0" | |||
| supportSwaggerUi | turns on/off SwaggerUI support | null (== true) | true | |||
| filterClass | a security filter** | null | "com.example.filter.SampleFilter" | |||
| resourceClasses | a list of resource classes which must be scanned** | null | ["com.example.rest.SampleResource"] | |||
| resourcePackages | a list of package names where resources must be scanned** | null | ["com.example.rest"] | |||
| ignoredRoutes | excludes specific paths when scanning all resources (see scanAllResources)** | null | ["/api/test"] | |||
| prettyPrint | when generating openapi.json, pretty-print the JSON document** | true | true | |||
| runAsFilter | runs the feature as a filter | false | false | |||
| scan | Scan all JAX-RS resources automatically | true | true | |||
| readAllResources | Read all operations also with no @Operation** | true | true | |||
| termsOfServiceUrl | the terms of service URL* | null | null | |||
| licenseUrl | the license URL* | null | "http://www.apache.org/licenses/LICENSE-2.0.html" | |||
| license | the license* | null | "Apache 2.0 License" | |||
| contactUrl | the contact link* | null | null | |||
| contactEmail | the contact email* | null | "users@cxf.apache.org" | |||
| contactName | the contact name* | null | null | |||
| description | the description* | null | "The Sample REST Application with OpenAPI integration" | |||
| title | the title* | null | "Sample REST Application" | |||
| version | the version* | null | "1.0.0" |
* - the properties are defined in the OpenAPI class
...
| Code Block | ||||
|---|---|---|---|---|
| ||||
<dependency>
<groupId>org.webjars</groupId>
<artifactId>swagger-ui</artifactId>
<version>3.13.0</version>
</dependency> |
For example, let's assume a JAX-RS endpoint is published at 'http://host:port/context/services/'.
Open the browser and go to 'http://host:port/context/services/api-docs/?url=/openapi.json' which will return a Swagger UI page.
CXF Services page will also link to Swagger UI. Go to 'http://host:port/context/services/' and follow a Swagger link which will return a Swagger UI page.
See samples/jax_rs/description_openapi_v3 as an example.
To deactivate automatic Swagger UI integration please set 'supportSwaggerUi' property to "false".
Samples
CXF's distribution contains the following samples.
- samples/jax_rs/description_openapi_v3: the OpenAPI v3.0 standalone sample using OpenApiFeature programmatically
- samples/jax_rs/description_openapi_v3_osgi: the OpenAPI v3.0 OSGi application sample using OpenApiFeature using Blueprint
- samples/jax_rs/description_openapi_v3_web: the OpenAPI v3.0 sample using OpenApiFeature inside WAR-based deployment