Skip to content

Maven plugin to generate OpenAPI Specification 3.0.1 from Spring MVC Project

License

Notifications You must be signed in to change notification settings

ebi-uniprot/openapi-spring-maven-plugin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

44 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Maven Central

Swagger Maven Plugin for Spring MVC

This maven plugin generates Open Specification 3.0.1 (OAS3) for your Spring Rest Project. It supports most of the Swagger 2+ and Spring Web annotation. It is simple to use and generates the OAS3 specifaction in yaml format. Please note that it is the first release so there are few bugs, we will fix them.

#Prerequisite

  • Maven >= 3.3.9
  • Java 8

Features

Versions

  • [0.3] supports Swagger Spec [2.0] SpingMVC.

Usage/Example

Import the plugin in your project by adding following configuration in your plugins block of pom file:

<build>
    <plugins>
        <plugin>
            <groupId>uk.ac.ebi.uniprot</groupId>
            <artifactId>openapi-maven-plugin</artifactId>
            <version>0.3</version>
            <configuration>
                <packageLocations>
			<packageLocation>your.package.with.spring.controllers</packageLocation>
	        	<packageLocation>your.package.with.spring.controllers</packageLocation>
                </packageLocations>
                <openApiDirectory>generated/swagger</openApiDirectory>
                <openApiFileName>openapi.yaml</openApiFileName>
                <serverBaseUrl>http://localhost/</serverBaseUrl>
            </configuration>
            <executions>
                <execution>
                    <phase>compile</phase>
                    <goals>
                        <goal>oas-generate</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

Configuration for configuration

name description
packageLocations Mandatory param to pass the packageLocation name(s) where Spring Controllers are.
openApiDirectory Path of the directory where you want to generate the Open API Specification yaml file. Defaults to target/generated-sources/swagger/
openApiFileName Name of the Open API Specification yaml file. Defaults to openapi3.yaml
serverBaseUrl Server URL. Default to localhost

#Build the source

  • mvn clean install
  • mcn clean install -DskipTests -- To skip the test

#Dependency conflicts If you face any dependency conflict after adding the plugin, use the below command to exclude duplicate dependency:

mvn dependency:tree

An example to exclude slf4j-log4j12 :

        <dependency>
            <groupId>uk.ac.ebi.uniprot</groupId>
            <artifactId>openapi-maven-plugin</artifactId>
            <version>${openapi-maven-plugin.version}</version>
            <exclusions>
                <exclusion>
                    <groupId>org.slf4j</groupId>
                    <artifactId>slf4j-log4j12</artifactId>
                </exclusion>
            </exclusions>
        </dependency>

Credit

The project uses codes or inspires from the codes from the below 3 projects. Thanks to them for writing such code.

About

Maven plugin to generate OpenAPI Specification 3.0.1 from Spring MVC Project

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages