Camel REST DSL OpenAPI Plugin

Generates a Camel REST DSL project from an OpenAPI document

License

License

GroupId

GroupId

com.ms3-inc.tavros
ArtifactId

ArtifactId

camel-restdsl-openapi-plugin
Last Version

Last Version

0.1.7
Release Date

Release Date

Type

Type

maven-plugin
Description

Description

Camel REST DSL OpenAPI Plugin
Generates a Camel REST DSL project from an OpenAPI document
Project URL

Project URL

https://github.com/MS3Inc/camel-restdsl-openapi-plugin
Source Code Management

Source Code Management

https://github.com/MS3Inc/camel-restdsl-openapi-plugin

Download camel-restdsl-openapi-plugin

How to add to project

<plugin>
    <groupId>com.ms3-inc.tavros</groupId>
    <artifactId>camel-restdsl-openapi-plugin</artifactId>
    <version>0.1.7</version>
</plugin>

Dependencies

compile (1)

Group / Artifact Type Version
io.swagger.parser.v3 : swagger-parser-v3 jar 2.0.24

provided (4)

Group / Artifact Type Version
org.apache.maven : maven-plugin-api jar 3.3.9
org.apache.maven : maven-core jar 3.3.9
org.apache.maven : maven-artifact jar 3.3.9
org.apache.maven.plugin-tools : maven-plugin-annotations jar 3.6.0

test (3)

Group / Artifact Type Version
org.apache.maven : maven-compat jar 3.3.9
junit : junit jar 4.13.1
org.apache.maven.plugin-testing : maven-plugin-testing-harness jar 3.3.0

Project Modules

There are no modules declared in this project.

Camel REST DSL OpenApi Maven Plugin

This is a custom Maven plugin, part of Tavros, for generating the REST DSL for projects generated using the OpenAPI Archetype. It is run automatically during the generation of the OpenAPI archetype.

According to the HTTP 1.1 specification RFC7231, certain HTTP methods do not have semantic definitions and therefore sending a payload body with such methods might cause some existing implementations to reject the request. OpenAPI 3.0.0 provides further guidance, specifying that a requestBody SHALL be ignored by consumers for these methods. This plugin will still generate code according to the OpenAPI document, but runtime support will depend on the HTTP server library used and all other components on the request path, such as proxies and gateways.

There is one goal associated with this plugin:

generate - To generate the REST DSL for both RoutesGenerated and RoutesImplementation classes.

How do I install the plugin locally?

Clone the main branch of this repo, change to the plugin directory, and run mvn clean install.

If you add or update a file and receive an error about missing headers, such as Missing header in: , run mvn com.mycila:license-maven-plugin:format. If you get an error with that command saying that you don't have the plugin locally, you can get it by running mvn org.apache.maven.plugins:maven-dependency-plugin:2.8:get -Dartifact=com.mycila:license-maven-plugin:4.0.rc2.

Who do I talk to?

Contact:

com.ms3-inc.tavros

MS3 Inc

Mountain State Software Solutions

Versions

Version
0.1.7
0.1.6
0.1.5