License	License Apache License, Version 2.0
Categories	Categories Maven Build Tools CLI User Interface
GroupId	GroupId org.lorislab.maven
ArtifactId	ArtifactId mp-rest-client-maven-plugin
Last Version	Last Version 0.6.0
Release Date	Release Date Oct 23, 2020
Type	Type maven-plugin
Description	Description mp-rest-client-maven-plugin Micro-Profile rest client codegen maven plugin
Project URL	Project URL https://github.com/lorislab/mp-rest-client-maven-plugin
Project Organization	Project Organization lorislab
Source Code Management	Source Code Management https://github.com/lorislab/mp-rest-client-maven-plugin

Filename	Size
mp-rest-client-maven-plugin-0.6.0.pom
mp-rest-client-maven-plugin-0.6.0.jar	42 KB
mp-rest-client-maven-plugin-0.6.0-sources.jar	27 KB
mp-rest-client-maven-plugin-0.6.0-javadoc.jar	426 KB
Browse

Group / Artifact	Type	Version
io.swagger.codegen.v3 : swagger-codegen	jar	3.0.22
org.apache.maven : maven-project	jar	2.2.1
org.apache.maven : maven-plugin-api	jar	3.6.0
io.swagger.codegen.v3 : swagger-codegen-generators	jar	1.0.22
com.google.googlejavaformat : google-java-format	jar	1.7
org.apache.maven : maven-core	jar	3.6.0

Group / Artifact	Type	Version
org.apache.maven.plugin-tools : maven-plugin-annotations	jar	3.5.2
org.projectlombok : lombok	jar	1.18.6

mp-rest-client-maven-plugin

Microprofile rest client maven plugin

Configuration parameters

Version 0.5.0+ add support for RestController class and proxy implementation.

Version 0.5.0+ contains check for generated files. If the generator generated more files with the same name the generator throws exception. The combination of the parameters apiName, pathPrefix or groupByTags is use to generate corresponding java classes for the openAPI schema.

Example combination

default configuration generated file for each REST path. /admin/name, /admin and /user/name will generate two java classes AdminRestClient and UserRestClient
if you add only apiName=User generator creates one java class UserRestClient for all REST method in openAPI schema.
apiName=MyRest and pathPrefix=/admin will generated one file MyRestRestClient for all REST method which start with /admin or admin path.
apiName=MyRest and pathPrefix=/ will generated one file with all REST method. This is equals to setting only the apiName parameter.
if you set the groupByTags to true the generator will group the REST api by the tags in the openAPI schema. This is default swagger generator but it could generated wrong java classes; depend on your openAPI schema and the parameter apiName and pathPrefix will be ignored.

Method of the java class are base on the operationId. If there are multiple operationId methods in the java class the tag of the operation is add as prefix to the method. If there are multiple tag+ operationId methods in the java class generator will add suffix _<number> to the method.

The plugin extends the parameter from: Swagger maven plugin Extended parameters:

Name	Default	Values	Description
modelPackage			The package name of the models
apiPackage			The package name of the `RestClient` or `RestController`
formatter	true		The google source code formatter
apiName			The api name if this is set the generator will generate one file for all REST method
interfaceOnly	true		Generate the interface only. If you need to generate `RestController` set this attribute to `false`
implType	CLASS	CLASS,INTERFACE,PROXY	This attribute is use only for `interfaceOnly=false`. The default implementation `CLASS` will generate the class with `Response 501` for each method. The `INTERFACE` value will generate the interface with default method implementation `Response 501`
pathPrefix			The path prefix for all interfaces. Example 'v2/' or '/'. REST method which starts not with this prefix will be ignored.
apiSuffix	RestClient		The api interface suffix
annotations			The list of custom annotations for the interface.
modelAnnotations			The list of custom annotations for the model.
restClient	true		The flag to generate the micro-profile rest client for the interface.
returnResponse	true		The return type will be the Response.
beanParamSuffix	BeanParam		The bean parameter suffix.
beanParamCount	9		The number of the parameters to group by the bean parameter.
jsonLib	JSONB	JACKSON,JSONB	The JSON implementation.
fieldGen	PUBLIC	LOMBOK,GET_SET,PUBLIC	The model field generator type.
dateLibrary	java8		The date library.
useBeanValidation	true		Use the bean validation on the methods.
apiInterfaceDoc	true		Generate the micro-profile annotation on the generated interface.
groupByTags	false		Group the REST in the openAPI schema by tags (Default by swagger). Default is false to group the REST method by path

Examples

Goal: codegen - RestClient

<plugin>
    <groupId>org.lorislab.maven</groupId>
    <artifactId>mp-restclient-maven-plugin</artifactId>
    <version>0.5.0</version>
    <executions>
        <execution>
            <id>test</id>
            <goals>
                <goal>codegen</goal>
            </goals>
            <configuration>
                <inputSpec>src/main/resources/clients/openapi.yaml</inputSpec>
                <output>${project.build.directory}/generated-sources/mprestclient</output>
                <apiPackage>gen.org.lorislab.test</apiPackage>
                <modelPackage>gen.org.lorislab.test.models</modelPackage>
                <generateSupportingFiles>false</generateSupportingFiles>
                <apiInterfaceDoc>false</apiInterfaceDoc>
                <fieldGen>LOMBOK</fieldGen>
                <jsonLib>JACKSON</jsonLib>                
                <annotations>
                    <annotation>javax.inject.Singleton</annotation>
                    <annotation>org.eclipse.microprofile.rest.client.inject.RegisterRestClient(configKey="my-client-key")</annotation>
                </annotations>
                <modelAnnotations>
                    <modelAnnotation>lombok.ToString</modelAnnotation>
                    <modelAnnotation>io.quarkus.runtime.annotations.RegisterForReflection</modelAnnotation>
                </modelAnnotations>
                <configOptions>
                    <sourceFolder>test</sourceFolder>
                </configOptions>
            </configuration>
        </execution>
    </executions>
</plugin>

Goal: codegen - RestController

<plugin>
    <groupId>org.lorislab.maven</groupId>
    <artifactId>mp-restclient-maven-plugin</artifactId>
    <version>0.5.0</version>
    <executions>
        <execution>
            <id>user</id>
            <goals>
                <goal>codegen</goal>
            </goals>
            <configuration>
                <inputSpec>src/main/resources/META-INF/openapi.yaml</inputSpec>
                <output>${project.build.directory}/generated-sources/endpoints</output>
                <apiPackage>org.lorislab.test.rs.internal</apiPackage>
                <modelPackage>org.lorislab.test.rs.internal.models</modelPackage>
                <generateSupportingFiles>false</generateSupportingFiles>
                <apiInterfaceDoc>false</apiInterfaceDoc>
                <interfaceOnly>false</interfaceOnly>
                <apiSuffix>RestController</apiSuffix>
                <fieldGen>LOMBOK</fieldGen>
                <jsonLib>JACKSON</jsonLib>                
                <annotations>
                    <annotation>javax.enterprise.context.ApplicationScoped</annotation>
                </annotations>
                <modelAnnotations>
                    <modelAnnotation>lombok.ToString</modelAnnotation>
                    <modelAnnotation>io.quarkus.runtime.annotations.RegisterForReflection</modelAnnotation>
                </modelAnnotations>
                <configOptions>
                    <sourceFolder>user</sourceFolder>
                </configOptions>
            </configuration>
        </execution>
    </executions>
</plugin>

Goal: codegen - Proxy

The implType=PROXY will generate the proxy REST endpoint. For this implementation you need to add the proxyClientClass which is the RestClient class and the modelPackage needs to have the same value like the RestClient.

<plugin>
    <groupId>org.lorislab.maven</groupId>
    <artifactId>mp-restclient-maven-plugin</artifactId>
    <version>0.5.0</version>
    <executions>
        <execution>
            <id>user-client</id>
            <goals>
                <goal>codegen</goal>
            </goals>
            <configuration>
                <inputSpec>src/main/resources/user/openapi.yaml</inputSpec>
                <output>${project.build.directory}/generated-sources/restclients</output>
                <apiPackage>org.lorislab.user.rs.proxy</apiPackage>
                <modelPackage>org.lorislab.user.rs.proxy.models</modelPackage>
                <generateSupportingFiles>false</generateSupportingFiles>
                <apiInterfaceDoc>false</apiInterfaceDoc>
                <fieldGen>LOMBOK</fieldGen>
                <jsonLib>JACKSON</jsonLib>
                <annotations>
                    <annotation>javax.inject.Singleton</annotation>
                    <annotation>org.eclipse.microprofile.rest.client.inject.RegisterRestClient(configKey="my-client-key")</annotation>
                </annotations>
                <modelAnnotations>
                    <modelAnnotation>lombok.ToString</modelAnnotation>
                    <modelAnnotation>io.quarkus.runtime.annotations.RegisterForReflection</modelAnnotation>
                </modelAnnotations>
                <configOptions>
                    <sourceFolder>user</sourceFolder>
                </configOptions>
            </configuration>
        </execution>
        <execution>
            <id>user-proxy</id>
            <goals>
                <goal>codegen</goal>
            </goals>
            <configuration>
                <inputSpec>src/main/resources/user/openapi.yaml</inputSpec>
                <output>${project.build.directory}/generated-sources/endpoints</output>
                <apiPackage>org.lorislab.user.rs.proxy</apiPackage>
                <modelPackage>org.lorislab.user.rs.proxy.models</modelPackage>
                <generateSupportingFiles>false</generateSupportingFiles>
                <apiInterfaceDoc>false</apiInterfaceDoc>
                <interfaceOnly>false</interfaceOnly>
                <implType>PROXY</implType>
                <fieldGen>LOMBOK</fieldGen>
                <jsonLib>JACKSON</jsonLib>
                <apiSuffix>RestController</apiSuffix>
                <proxyClientClass>UsersRestClient</proxyClientClass>
                <annotations>
                    <annotation>javax.enterprise.context.ApplicationScoped</annotation>
                </annotations>
                <modelAnnotations>
                    <modelAnnotation>lombok.ToString</modelAnnotation>
                    <modelAnnotation>io.quarkus.runtime.annotations.RegisterForReflection</modelAnnotation>
                </modelAnnotations>
                <configOptions>
                    <sourceFolder>user</sourceFolder>
                </configOptions>
            </configuration>
        </execution>
    </executions>
</plugin>

Example

 <plugin>
    <groupId>org.lorislab.maven</groupId>
    <artifactId>mp-rest-client-maven-plugin</artifactId>
    <version>999-SNAPSHOT</version>
    <executions>
        <execution>
            <id>p6-gateway</id>
            <goals>
                <goal>codegen</goal>
            </goals>
            <configuration>
                <inputSpec>src/main/resources/clients/openapi.yaml</inputSpec>
                <output>${project.build.directory}/generated-sources/mprestclient</output>
                <apiPackage>gen.org.lorislab.test</apiPackage>
                <modelPackage>gen.org.lorislab.test.models</modelPackage>
                <generateSupportingFiles>false</generateSupportingFiles>
                <apiInterfaceDoc>false</apiInterfaceDoc>
                <fieldGen>LOMBOK</fieldGen>
                <jsonLib>JACKSON</jsonLib> 
                <annotations>
                    <annotation>javax.inject.Singleton</annotation>
                    <annotation>org.lorislab.quarkus.jel.log.interceptor.LoggerService</annotation>
                    <annotation>org.eclipse.microprofile.rest.client.inject.RegisterRestClient(configKey="my-client-key")</annotation>
                </annotations>
                <modelAnnotations>
                    <modelAnnotation>lombok.ToString(callSuper = true)</modelAnnotation>
                    <modelAnnotation>io.quarkus.runtime.annotations.RegisterForReflection</modelAnnotation>
                </modelAnnotations>
                <configOptions>
                    <sourceFolder>test</sourceFolder>
                </configOptions>
            </configuration>
        </execution>
    </executions>
</plugin>

Generate source code

package api;

import model.Error;
import model.Pets;

import javax.ws.rs.*;
import javax.ws.rs.core.Response;
import org.eclipse.microprofile.rest.client.inject.RegisterRestClient;

import lombok.Data;

import java.util.Map;
import java.util.List;
import javax.validation.constraints.*;
import javax.validation.Valid;

@Path("/pets")
@RegisterRestClient
@org.lorislab.quarkus.jel.log.interceptor.RestClientLogInterceptor
@org.lorislab.quarkus.jel.log.interceptor.LoggerService
@javax.annotation.Generated(
    value = "org.lorislab.swagger.mp.RestClientCodegen",
    date = "2019-06-13T08:26:44.867834+02:00[Europe/Berlin]")
public interface TestTestClient {

  @POST
  Response createPets(@BeanParam CreatePetsBeanParam beanParam, @Valid String body);

  @Data
  public class CreatePetsBeanParam {

    @QueryParam("limit")
    Integer limit;

    @QueryParam("limit2")
    Integer limit2;

    @HeaderParam("limit3")
    Integer limit3;

    @PathParam("petId2")
    String petId2;

    @PathParam("petId")
    String petId;
  }

  @GET
  Response listPets(@QueryParam("limit") Integer limit);

  @GET
  @Path("/{petId}")
  Response showPetById(@PathParam("petId") String petId);
}

Release process of this plugin

Create new release run

mvn semver-release:release-create

Create new patch branch run

mvn semver-release:patch-create -DpatchVersion=X.X.0

mp-rest-client-maven-plugin

License

Categories

GroupId

ArtifactId

Last Version

Release Date

Type

Description

Project URL

Project Organization

Source Code Management

Download mp-rest-client-maven-plugin

How to add to project

Dependencies

compile (6)

provided (2)

Project Modules

mp-rest-client-maven-plugin

Configuration parameters

Examples

Goal: codegen - RestClient

Goal: codegen - RestController

Goal: codegen - Proxy

Example

Release process of this plugin

lorislab

Versions

Version
0.6.0 Oct 23, 2020
0.5.0 Oct 23, 2020
0.4.0 Jan 15, 2020
0.3.0 Jan 10, 2020
0.2.0 Oct 11, 2019
0.1.1 Aug 6, 2019
0.1.0 Aug 5, 2019