Vert.x API Generationをちょっと調べつつ、Vert.xのRedis ClientをSmallRye Mutinyに対応させてみる

これは、なにをしたくて書いたもの？

Quarkusには、SmallRye Mutinyに対応したReactiveなSQLクライアントやRedisクライアントなどがあります。

Quarkus - Reactive SQL Clients

Quarkus - Using the Redis Client

これらは、Vert.xのライブラリを元にしているものですが、Vert.x自体はSmallRye Mutinyには対応していません。

このあたりのからくりを、時々調べては忘れてしまうのでメモしておこうかな、と。

あと、ここで紹介するVert.x API Genratorを使って、Redisを題材にVert.xのRedisクライアントをSmallRye Mutinyに対応させて
みましょう。

からくり？

QuarkusのRedis Extensionは、smallrye-mutiny-vertx-redis-clientというライブラリに依存しています。

https://github.com/quarkusio/quarkus/blob/1.9.2.Final/extensions/redis-client/runtime/pom.xml#L23-L26

https://github.com/quarkusio/quarkus/blob/1.9.2.Final/bom/application/pom.xml#L135

smallrye-mutiny-vertx-redis-clientというライブラリは、こちらのリポジトリに含まれています。

GitHub - smallrye/smallrye-reactive-utils

で、リポジトリを見ると気づくのですが、このライブラリにはsrc/main/javaがありません。テストコードは
あるのですが。

https://github.com/smallrye/smallrye-reactive-utils/tree/1.2.2/vertx-mutiny-clients/vertx-mutiny-redis-client

そもそも、Vert.xのRedisクライアントのドキュメントを見てもReactive StreamsなAPIが使える雰囲気は感じません。

Vert.x-redis - Vert.x

さて、これはどういうことでしょう？というのが、今回のお題です。

Vert.x API Generation

smallrye-mutiny-vertx-redis-clientのpom.xmlを見ていると、どうもソースコードを自動生成していそうな雰囲気があります。

https://github.com/smallrye/smallrye-reactive-utils/blob/1.2.2/vertx-mutiny-clients/vertx-mutiny-redis-client/pom.xml

特にこのあたりですね。

            <plugin>
                <groupId>org.bsc.maven</groupId>
                <artifactId>maven-processor-plugin</artifactId>
                <version>4.2-jdk8</version>
                <configuration>
                    <systemProperties>
                        <java.util.logging.SimpleFormatter.format>%4$s: %3$s - %5$s %6$s%n
                        </java.util.logging.SimpleFormatter.format>
                        <mvel2.disable.jit>true</mvel2.disable.jit>
                    </systemProperties>
                </configuration>
                <executions>
                    <!-- Run the annotation processor on java sources and generate the API -->
                    <execution>
                        <id>generate-api</id>
                        <goals>
                            <goal>process</goal>
                        </goals>
                        <phase>generate-sources</phase>
                        <configuration>
                            <sourceDirectory>${project.build.directory}/sources/java</sourceDirectory>
                            <processors>
                                <processor>io.vertx.codegen.CodeGenProcessor</processor>
                            </processors>
                            <optionMap>
                                <codegen.generators>mutiny</codegen.generators>
                            </optionMap>
                        </configuration>
                    </execution>
                </executions>
            </plugin>

ここで動いているのが、Vert.x API Generationです。

GitHub - vert-x3/vertx-codegen: Vert.x code generator for asynchronous polyglot APIs

あまり詳細を追うつもりはないですが（？）、io.vertx.codegen.Generatorの実装クラスをロードする
io.vertx.codegen.GeneratorLoaderの実装をMETA-INF/services/io.vertx.codegen.GeneratorLoaderで指定する、
要はService Loaderの仕組みを使って以下のようなことができるそうです。

• Data object converters
• Service proxy and service handler
• RxJava-ified classes API
• Groovy extension methods API

今回は、SmallRye MutinyスタイルのAPIを生成するのに使います、と。

SmalleRye Mutiny向けに用意されているのは、こちらですね。

https://github.com/smallrye/smallrye-reactive-utils/tree/1.2.2/vertx-mutiny-clients/vertx-mutiny-generator

GeneratorLoaderの指定。

https://github.com/smallrye/smallrye-reactive-utils/blob/1.2.2/vertx-mutiny-clients/vertx-mutiny-generator/src/main/resources/META-INF/services/io.vertx.codegen.GeneratorLoader

先ほど記載したpom.xmlでこんな記述がありましたが

                            <optionMap>
                                <codegen.generators>mutiny</codegen.generators>
                            </optionMap>

この指定で使われるGeneratorはこちらになります。

https://github.com/smallrye/smallrye-reactive-utils/blob/1.2.2/vertx-mutiny-clients/vertx-mutiny-generator/src/main/java/io/smallrye/mutiny/vertx/codegen/MutinyGenerator.java

というわけで、smallrye-mutiny-vertx-redis-clientのpom.xmlをもう少し読み解いてみると。

vertx-redis-clientをターゲットにして

    <properties>
        <gen-source-groupId>io.vertx</gen-source-groupId>
        <gen-source-artifactId>vertx-redis-client</gen-source-artifactId>
        <gen.output>${project.build.directory}/sources/java</gen.output>
    </properties>

https://github.com/smallrye/smallrye-reactive-utils/blob/1.2.2/vertx-mutiny-clients/vertx-mutiny-redis-client/pom.xml#L14-L18

Maven Dependency Pluginでvertx-redis-clientのソースコードをダウンロードして展開、

            <plugin>
                <artifactId>maven-dependency-plugin</artifactId>
                <configuration>
                    <includeGroupIds>${gen-source-groupId}</includeGroupIds>
                    <includeArtifactIds>${gen-source-artifactId}</includeArtifactIds>
                    <classifier>sources</classifier>
                    <includeTypes>jar</includeTypes>
                </configuration>
                <executions>
                    <!-- Unpack java sources to target/java-sources -->
                    <execution>
                        <id>unpack-java</id>
                        <phase>generate-sources</phase>
                        <goals>
                            <goal>unpack-dependencies</goal>
                        </goals>
                        <configuration>
                            <includes>io/vertx/**/*.java</includes>
                            <excludes>**/impl/**/*.java</excludes>
                            <outputDirectory>${gen.output}</outputDirectory>
                        </configuration>
                    </execution>
                </executions>
            </plugin>

https://github.com/smallrye/smallrye-reactive-utils/blob/1.2.2/vertx-mutiny-clients/vertx-mutiny-redis-client/pom.xml#L53-L76

展開されたソースコードをインプットに、SmallRye Mutinyに対応したソースコードを生成してパッケージングしている、
というのが実体のようです。

https://github.com/smallrye/smallrye-reactive-utils/blob/1.2.2/vertx-mutiny-clients/vertx-mutiny-redis-client/pom.xml#L78-L108

            <plugin>
                <groupId>org.bsc.maven</groupId>
                <artifactId>maven-processor-plugin</artifactId>
                <version>4.2-jdk8</version>
                <configuration>
                    <systemProperties>
                        <java.util.logging.SimpleFormatter.format>%4$s: %3$s - %5$s %6$s%n
                        </java.util.logging.SimpleFormatter.format>
                        <mvel2.disable.jit>true</mvel2.disable.jit>
                    </systemProperties>
                </configuration>
                <executions>
                    <!-- Run the annotation processor on java sources and generate the API -->
                    <execution>
                        <id>generate-api</id>
                        <goals>
                            <goal>process</goal>
                        </goals>
                        <phase>generate-sources</phase>
                        <configuration>
                            <sourceDirectory>${project.build.directory}/sources/java</sourceDirectory>
                            <processors>
                                <processor>io.vertx.codegen.CodeGenProcessor</processor>
                            </processors>
                            <optionMap>
                                <codegen.generators>mutiny</codegen.generators>
                            </optionMap>
                        </configuration>
                    </execution>
                </executions>
            </plugin>

なるほど、と。

Quarkusは、この生成されたソースコードをさらにラップして提供している形態になります。

https://github.com/quarkusio/quarkus/blob/1.9.2.Final/extensions/redis-client/runtime/src/main/java/io/quarkus/redis/client/runtime/ReactiveRedisClientImpl.java

というか、このリポジトリに含まれるクライアントライブラリ全体的に、こんな感じでソースコードの自動生成を元に
構成されている様子ですね。

https://github.com/smallrye/smallrye-reactive-utils/tree/1.2.2/vertx-mutiny-clients

その他、このリポジトリにはReactive Convertersという変換ライブラリもあるようなので、こちらも覚えておいてよいかもしれません。

https://github.com/smallrye/smallrye-reactive-utils/tree/1.2.2/reactive-converters

RxJava 1／2はどうした？

ところで、Vert.xはRxJava 1および2に対応していそうなドキュメントがあります。

Reactive

リポジトリはこちらです。

GitHub - vert-x3/vertx-rx: Reactive Extensions for Vert.x

中身を見てみると、こちらもVert.x API Generationを使ってVert.xのAPIから自動生成したものでした。

同じ仕組みですね！

API Constraint

こんな感じで書いていくと、あるソースコードから特定のReactive Streamsの実装に対応したソースコードを出力してくれそうな
すごいもののような印象を受けますが、それなりに制限はあります。

API constraints

そもそもがPluggable Annotation Processing APIで実現されている仕組みなのでアノテーションの付与が必要ですし、
アノテーションが付与される対象はインターフェースであることとかいろいろあります。

たとえば、以下のインターフェースがVert.x API Generationに関するアノテーションが付与されたクラスですね。

https://github.com/vert-x3/vertx-redis-client/blob/3.9.4/src/main/java/io/vertx/redis/client/RedisAPI.java

つまり、このインターフェースはソースコード生成対象となります。

というわけで

とまあ、ここまでで理屈はなんとなくわかりました。

ここで終わってもいいのですが、1度自分でコード生成を行ってみてもよいのではないでしょうか。

というわけで、smallrye-mutiny-vertx-redis-clientを参考に、自分でvertx-redis-clientをSmallRye Mutinyに対応させてみましょう。

https://github.com/smallrye/smallrye-reactive-utils/tree/1.2.2/vertx-mutiny-clients/vertx-mutiny-redis-client

コード生成およびJARの作成と、それを使ったテストコードによる簡単な動作確認をゴールにします。

これらは、Mavenのマルチプロジェクトで構成するとしましょう。

環境

今回の環境は、こちらです。

$ java --version
openjdk 11.0.9.1 2020-11-04
OpenJDK Runtime Environment (build 11.0.9.1+1-Ubuntu-0ubuntu1.20.04)
OpenJDK 64-Bit Server VM (build 11.0.9.1+1-Ubuntu-0ubuntu1.20.04, mixed mode, sharing)


$ mvn --version
Apache Maven 3.6.3 (cecedd343002696d0abb50b32b541b8a6ba2883f)
Maven home: $HOME/.sdkman/candidates/maven/current
Java version: 11.0.9.1, vendor: Ubuntu, runtime: /usr/lib/jvm/java-11-openjdk-amd64
Default locale: ja_JP, platform encoding: UTF-8
OS name: "linux", version: "5.4.0-54-generic", arch: "amd64", family: "unix"

Vert.xは3.9.4を使用します。

親プロジェクト

親プロジェクトを用意します。含まれるサブモジュールが定義されているだけですが。
pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>org.littlewings</groupId>
    <artifactId>vertx-codegen-redis-example</artifactId>
    <packaging>pom</packaging>
    <version>0.0.1-SNAPSHOT</version>
    <modules>
        <module>hello-redis-client</module>
        <module>my-smallrye-mutiny-vertx-redis-client</module>
    </modules>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <maven.compiler.source>11</maven.compiler.source>
        <maven.compiler.target>11</maven.compiler.target>
    </properties>
</project>

my-smallrye-mutiny-vertx-redis-clientが自前で作る、SmallRye Mutinyに対応したRedisクライアント、
hello-redis-clientがmy-smallrye-mutiny-vertx-redis-clientを使ったテストコードを書く形にします。

    <modules>
        <module>hello-redis-client</module>
        <module>my-smallrye-mutiny-vertx-redis-client</module>
    </modules>

vertx-redis-clientをSmallRye Mutinyに対応させる

では、vertx-redis-clientをSmallRye Mutinyに対応させるプロジェクトを作ります。自前のsmallrye-mutiny-vertx-redis-clientです。

といっても、用意するのはpom.xmlだけでいいのですが。

Vert.x API GenerationのREADME.mdを見ると、Maven Compiler Pluginでの設定が行われているのですが

Processor configuration

オリジナルのsmallrye-mutiny-vertx-redis-clientを見ると、Maven Processor Pluginで設定が行われています。

https://github.com/smallrye/smallrye-reactive-utils/blob/1.2.2/vertx-mutiny-clients/vertx-mutiny-redis-client/pom.xml#L78-L108

こちらのプラグインですね。

MAVEN PROCESSOR PLUGIN – About

RxJava向けのソースコードを生成しているプロジェクトを見ても、同じでした。

GitHub - vert-x3/vertx-rx: Reactive Extensions for Vert.x

どうしようかと迷ったところで、両方やりましょう。

やることは、次の内容です。

• vertx-redis-clientをベースに、SmallRye Mutinyに対応するライブラリを作る
• vertx-redis-clientのソースコードはMaven Dependency Pluginを使い、ダウンロードする
  • ダウンロードしたソースコードの展開先は${project.build.directory}/sources/javaとする（オリジナルのsmallrye-mutiny-vertx-redis-clientと同じ）
  • ここに配置されたソースコードをVert.x API GenerationのPluggable Annotation Processing APIで処理する
• Vert.x API Generationで処理する際には、SmallRye Mutiny向けのGeneratorを指定する

どちらのMavenプラグインを使った方法でも共通する部分は、最初に貼っておきます（最後に全体は載せます）。

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <artifactId>vertx-codegen-redis-example</artifactId>
        <groupId>org.littlewings</groupId>
        <version>0.0.1-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>my-smallrye-mutiny-vertx-redis-client</artifactId>

〜省略〜

</project>

Maven Compiler Pluginでソースコードを生成する

最初は、Vert.x API GenerationのREADME.mdに沿って、Maven Compiler Pluginで設定を行います。

ライブラリ依存関係はオリジナルのsmallrye-mutiny-vertx-redis-clientに習いますが、こちらのvertx-codegenの明示的な追加が
必要です。

    <dependencies>
        <dependency>
            <groupId>io.vertx</groupId>
            <artifactId>vertx-redis-client</artifactId>
            <version>3.9.4</version>
        </dependency>

        <dependency>
            <groupId>io.smallrye.reactive</groupId>
            <artifactId>smallrye-mutiny-vertx-core</artifactId>
            <version>1.2.2</version>
        </dependency>

        <dependency>
            <groupId>io.vertx</groupId>
            <artifactId>vertx-codegen</artifactId>
            <classifier>processor</classifier>
            <version>3.9.4</version>
            <optional>true</optional>
        </dependency>
    </dependencies>

vertx-codegenが必要なのはドキュメント通りなのですが、Maven Processor Pluginを使った時は依存関係に加えなくても
動作するんですよねぇ…。

Processor configuration

ちなみに、vertx-codegenへの依存関係はsmallrye-mutiny-vertx-coreに含まれているのですが、processor classifierのものを
依存関係に加える必要があります。

processor classifier有無の差は、どうやらMETA-INF/services/javax.annotation.processing.Processorが含まれているか
どうかのようで、これがないとMaven Compiler Pluginの場合はPluggable Annotation Processing APIが起動しない…というか、
それがふつうですね…。

Maven Processor Pluginが不思議なのか…。

あとはMavenプラグインの設定です。こんな感じにしました。

    <build>
        <plugins>
            <plugin>
                <artifactId>maven-dependency-plugin</artifactId>
                <configuration>
                    <includeGroupIds>io.vertx</includeGroupIds>
                    <includeArtifactIds>vertx-redis-client</includeArtifactIds>
                    <classifier>sources</classifier>
                    <includeTypes>jar</includeTypes>
                </configuration>
                <executions>
                    <execution>
                        <id>unpack-java</id>
                        <phase>generate-sources</phase>
                        <goals>
                            <goal>unpack-dependencies</goal>
                        </goals>
                        <configuration>
                            <includes>io/vertx/**/*.java</includes>
                            <excludes>**/impl/**/*.java</excludes>
                            <outputDirectory>${project.build.directory}/sources/java</outputDirectory>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
            <plugin>
                <groupId>org.codehaus.mojo</groupId>
                <artifactId>build-helper-maven-plugin</artifactId>
                <version>3.2.0</version>
                <executions>
                    <execution>
                        <phase>generate-sources</phase>
                        <goals>
                            <goal>add-source</goal>
                        </goals>
                        <configuration>
                            <sources>
                                <source>${project.build.directory}/sources/java</source>
                            </sources>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
            <plugin>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.8.1</version>
                <configuration>
                    <source>11</source>
                    <target>11</target>
                    <encoding>${project.build.sourceEncoding}</encoding>
                    <useIncrementalCompilation>false</useIncrementalCompilation>
                </configuration>
                <executions>
                    <execution>
                        <id>generate-mutiny-source</id>
                        <configuration>
                            <annotationProcessors>
                                <annotationProcessor>io.vertx.codegen.CodeGenProcessor</annotationProcessor>
                            </annotationProcessors>
                            <compilerArgs>
                                <arg>-Acodegen.generators=mutiny</arg>
                            </compilerArgs>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>

Maven Dependency Pluginでvertx-redis-clientのソースコードを取得して、${project.build.directory}/sources/javaに展開。
includesやexcludesの指定は、オリジナルのsmallrye-mutiny-vertx-redis-clientの設定をそのまま使っています。

            <plugin>
                <artifactId>maven-dependency-plugin</artifactId>
                <configuration>
                    <includeGroupIds>io.vertx</includeGroupIds>
                    <includeArtifactIds>vertx-redis-client</includeArtifactIds>
                    <classifier>sources</classifier>
                    <includeTypes>jar</includeTypes>
                </configuration>
                <executions>
                    <execution>
                        <id>unpack-java</id>
                        <phase>generate-sources</phase>
                        <goals>
                            <goal>unpack-dependencies</goal>
                        </goals>
                        <configuration>
                            <includes>io/vertx/**/*.java</includes>
                            <excludes>**/impl/**/*.java</excludes>
                            <outputDirectory>${project.build.directory}/sources/java</outputDirectory>
                        </configuration>
                    </execution>
                </executions>
            </plugin>

展開したvertx-redis-clientのソースコードを、ビルド対象に追加。

            <plugin>
                <groupId>org.codehaus.mojo</groupId>
                <artifactId>build-helper-maven-plugin</artifactId>
                <version>3.2.0</version>
                <executions>
                    <execution>
                        <phase>generate-sources</phase>
                        <goals>
                            <goal>add-source</goal>
                        </goals>
                        <configuration>
                            <sources>
                                <source>${project.build.directory}/sources/java</source>
                            </sources>
                        </configuration>
                    </execution>
                </executions>
            </plugin>

最後に、Vert.x API Generationを使ってソースコードを生成します。

            <plugin>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.8.1</version>
                <configuration>
                    <source>11</source>
                    <target>11</target>
                    <encoding>${project.build.sourceEncoding}</encoding>
                    <useIncrementalCompilation>false</useIncrementalCompilation>
                </configuration>
                <executions>
                    <execution>
                        <id>generate-mutiny-source</id>
                        <configuration>
                            <annotationProcessors>
                                <annotationProcessor>io.vertx.codegen.CodeGenProcessor</annotationProcessor>
                            </annotationProcessors>
                            <compilerArgs>
                                <arg>-Acodegen.generators=mutiny</arg>
                            </compilerArgs>
                        </configuration>
                    </execution>
                </executions>
            </plugin>

アノテーションプロセッサーおよびSmallRye Mutiny向けのGeneratorの指定は、ここですね。

                            <annotationProcessors>
                                <annotationProcessor>io.vertx.codegen.CodeGenProcessor</annotationProcessor>
                            </annotationProcessors>
                            <compilerArgs>
                                <arg>-Acodegen.generators=mutiny</arg>
                            </compilerArgs>

ビルドしてみましょう。

$ mvn package

できあがったJARファイルには、io.vertx.mutinyパッケージに属するクラスが含まれるようになっています。

$ jar -tvf target/my-smallrye-mutiny-vertx-redis-client-0.0.1-SNAPSHOT.jar 
     0 Mon Nov 23 23:01:18 JST 2020 META-INF/
   133 Mon Nov 23 23:01:16 JST 2020 META-INF/MANIFEST.MF
     0 Mon Nov 23 23:01:16 JST 2020 io/
     0 Mon Nov 23 23:01:16 JST 2020 io/vertx/
     0 Mon Nov 23 23:01:16 JST 2020 io/vertx/mutiny/
     0 Mon Nov 23 23:01:16 JST 2020 io/vertx/mutiny/redis/
     0 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/
     0 Mon Nov 23 23:01:16 JST 2020 io/vertx/mutiny/redis/sentinel/
182280 Mon Nov 23 23:01:16 JST 2020 io/vertx/mutiny/redis/RedisTransaction.class
  3083 Mon Nov 23 23:01:16 JST 2020 io/vertx/mutiny/redis/Script.class
196928 Mon Nov 23 23:01:16 JST 2020 io/vertx/mutiny/redis/RedisClient.class
  1923 Mon Nov 23 23:01:16 JST 2020 io/vertx/mutiny/redis/RedisTransaction$1.class
  1927 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$90.class
  1928 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$83.class
  1963 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$78.class
  1926 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$58.class
  1909 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$2.class
  1967 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$45.class
  1927 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$54.class
  1925 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$47.class
  1911 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$19.class
  1916 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$108.class
  1949 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$153.class
  1926 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$75.class
  1915 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$98.class
  1934 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$200.class
  1945 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$49.class
  1993 Mon Nov 23 23:01:16 JST 2020 io/vertx/mutiny/redis/client/RedisConnection$2.class
  1936 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$116.class
  1369 Mon Nov 23 23:01:16 JST 2020 io/vertx/mutiny/redis/client/RedisConnection$1.class
  1969 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$134.class
  1966 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$132.class
  1931 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$148.class
  1967 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$101.class
  1930 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$115.class
  1912 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$85.class
  1930 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$179.class
  1928 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$97.class
  1925 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$27.class
  1929 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$170.class
  1947 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$31.class
  1927 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$178.class
  1926 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$11.class
  1928 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$28.class
  1927 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$143.class
  1928 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$169.class
  1915 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$4.class
  1928 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$173.class
  1952 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$119.class
  1925 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$3.class
  1935 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$107.class
  1926 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$55.class
  1970 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$183.class
  1914 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$161.class
  1928 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$120.class
  1927 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$74.class
  1928 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$34.class
  1947 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$162.class
  1969 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$12.class
  1929 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$121.class
  1977 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$193.class
  1967 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$180.class
  1932 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$149.class
  1925 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$99.class
  1927 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$72.class
  1926 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$43.class
  1947 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$46.class
  1926 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$56.class
  1927 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$21.class
  1948 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$61.class
  1984 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$71.class
  5154 Mon Nov 23 23:01:16 JST 2020 io/vertx/mutiny/redis/client/Request.class
  1930 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$184.class
  1927 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$6.class
  1927 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$167.class
  1927 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$100.class
  1925 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$87.class
  1923 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/Redis$2.class
  1931 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$135.class
  2983 Mon Nov 23 23:01:16 JST 2020 io/vertx/mutiny/redis/client/RedisConnection$3.class
  1948 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$133.class
  1929 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$33.class
  1928 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$147.class
  1949 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$32.class
 15791 Mon Nov 23 23:01:16 JST 2020 io/vertx/mutiny/redis/client/RedisConnection.class
  1928 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$95.class
  1927 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$76.class
  1927 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$165.class
  1933 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$128.class
  1928 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$177.class
  1927 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$81.class
  1951 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$197.class
129895 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI.class
  1929 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$104.class
  1947 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$22.class
  1948 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$92.class
  1924 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$8.class
  1950 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$105.class
  1925 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$59.class
  1967 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$150.class
  1928 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$157.class
  1912 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$24.class
  1928 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$163.class
  1927 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$30.class
  1934 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$152.class
  1938 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$41.class
  1933 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$141.class
  9056 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/Redis.class
  1931 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$171.class
  1926 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$10.class
  1966 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$142.class
  1910 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$89.class
  1925 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$9.class
  1949 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$176.class
  1931 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$113.class
  1968 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$181.class
  1928 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$36.class
  1932 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$175.class
  1947 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$70.class
  1949 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$111.class
  1927 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$67.class
  1934 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$137.class
  1933 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$174.class
 14133 Mon Nov 23 23:01:16 JST 2020 io/vertx/mutiny/redis/client/Command.class
  1925 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$5.class
  1928 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$96.class
  1976 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$192.class
  1947 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$64.class
  1929 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$136.class
  1966 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$51.class
  1928 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$156.class
  1934 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$145.class
  1930 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$50.class
  1951 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$112.class
  1929 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$151.class
  1930 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$185.class
  1950 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$93.class
  1964 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$80.class
  1945 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$1.class
  1937 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$195.class
  1930 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$39.class
  1928 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$62.class
  1927 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$73.class
  1929 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$158.class
  1939 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$196.class
  1967 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$131.class
  1909 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$29.class
  1965 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$60.class
  1925 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$66.class
  1927 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$146.class
  1927 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$26.class
  1913 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$68.class
  1930 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$125.class
  1932 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$194.class
  1929 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$186.class
  1936 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$188.class
  1948 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$189.class
  1926 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$94.class
  5522 Mon Nov 23 23:01:16 JST 2020 io/vertx/mutiny/redis/client/Response.class
  1971 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$52.class
  1929 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$106.class
  1952 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$138.class
  1927 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$18.class
  1927 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$164.class
  1949 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$199.class
  1948 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$103.class
  1916 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$110.class
  1911 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$154.class
  1928 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$16.class
  1927 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$122.class
  1928 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$198.class
  1940 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$42.class
  1928 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$37.class
  1931 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$129.class
  1915 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$109.class
  1927 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$15.class
  1934 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$160.class
  1928 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$69.class
  1938 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/Redis$1.class
  1963 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$79.class
  1947 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$44.class
  1927 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$190.class
  1927 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$144.class
  1927 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$7.class
  1929 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$14.class
  1975 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$191.class
  1929 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$172.class
  1927 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$124.class
  1932 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$40.class
  1911 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$123.class
  1911 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$117.class
  1928 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$127.class
  1926 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$130.class
  1945 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$86.class
  1929 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$118.class
  1911 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$155.class
  1928 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$53.class
  1927 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$88.class
  1925 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$82.class
  2913 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/Redis$3.class
  1929 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$166.class
  1929 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$13.class
  1927 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$38.class
  1929 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$126.class
  1933 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$102.class
  1965 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$77.class
  1934 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$182.class
  1926 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$20.class
  1927 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$35.class
  1952 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$65.class
  1912 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$17.class
  1934 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$187.class
  1927 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$25.class
  1925 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$57.class
  1929 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$168.class
  1948 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$48.class
  1930 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$140.class
  1927 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$84.class
  1952 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$114.class
  1929 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$159.class
  1930 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$91.class
  1924 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$23.class
  1950 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$139.class
  1927 Mon Nov 23 23:01:18 JST 2020 io/vertx/mutiny/redis/client/RedisAPI$63.class
 10817 Mon Nov 23 23:01:16 JST 2020 io/vertx/mutiny/redis/sentinel/RedisSentinel.class
  1888 Mon Nov 23 23:01:16 JST 2020 io/vertx/mutiny/redis/RedisClient$1.class
     0 Mon Nov 23 23:01:18 JST 2020 META-INF/maven/
     0 Mon Nov 23 23:01:18 JST 2020 META-INF/maven/org.littlewings/
     0 Mon Nov 23 23:01:18 JST 2020 META-INF/maven/org.littlewings/my-smallrye-mutiny-vertx-redis-client/
  3479 Mon Nov 23 22:21:48 JST 2020 META-INF/maven/org.littlewings/my-smallrye-mutiny-vertx-redis-client/pom.xml
   146 Mon Nov 23 23:01:18 JST 2020 META-INF/maven/org.littlewings/my-smallrye-mutiny-vertx-redis-client/pom.properties

生成されたソースコードは、こちら。

$ find target/generated-sources -type f
target/generated-sources/apt/io/vertx/mutiny/redis/Script.java
target/generated-sources/apt/io/vertx/mutiny/redis/RedisTransaction.java
target/generated-sources/apt/io/vertx/mutiny/redis/RedisClient.java
target/generated-sources/apt/io/vertx/mutiny/redis/client/Request.java
target/generated-sources/apt/io/vertx/mutiny/redis/client/Command.java
target/generated-sources/apt/io/vertx/mutiny/redis/client/RedisConnection.java
target/generated-sources/apt/io/vertx/mutiny/redis/client/Redis.java
target/generated-sources/apt/io/vertx/mutiny/redis/client/Response.java
target/generated-sources/apt/io/vertx/mutiny/redis/client/RedisAPI.java
target/generated-sources/apt/io/vertx/mutiny/redis/sentinel/RedisSentinel.java

生成されたソースコードの雰囲気は、こんな感じです。
target/generated-sources/annotations/io/vertx/mutiny/redis/client/RedisAPI.java

package io.vertx.mutiny.redis.client;

import java.util.Map;
import io.smallrye.mutiny.Multi;
import io.smallrye.mutiny.Uni;
import java.util.function.Consumer;
import org.reactivestreams.Subscriber;
import org.reactivestreams.Publisher;
import java.util.List;
import io.vertx.core.AsyncResult;
import io.vertx.core.Handler;

/**
 * <b>Auto generated</b> Redis API client wrapper.
 *
 * <p/>
 * NOTE: This class has been automatically generated from the {@link io.vertx.redis.client.RedisAPI original} non Mutiny-ified interface using Vert.x codegen.
 */

@io.smallrye.mutiny.vertx.MutinyGen(io.vertx.redis.client.RedisAPI.class)
public class RedisAPI {

  public static final io.smallrye.mutiny.vertx.TypeArg<RedisAPI> __TYPE_ARG = new io.smallrye.mutiny.vertx.TypeArg<>(    obj -> new RedisAPI((io.vertx.redis.client.RedisAPI) obj),
    RedisAPI::getDelegate
  );

  private final io.vertx.redis.client.RedisAPI delegate;
  
  public RedisAPI(io.vertx.redis.client.RedisAPI delegate) {
    this.delegate = delegate;
  }

  /**
  * Empty constructor used by CDI, do not use this constructor directly.
  **/
  RedisAPI() {    this.delegate = null;
  }

  public io.vertx.redis.client.RedisAPI getDelegate() {
    return delegate;
  }

  @Override
  public String toString() {
    return delegate.toString();
  }

  @Override
  public boolean equals(Object o) {
    if (this == o) return true;
    if (o == null || getClass() != o.getClass()) return false;
    RedisAPI that = (RedisAPI) o;
    return delegate.equals(that.delegate);
  }
  
  @Override
  public int hashCode() {
    return delegate.hashCode();
  }

  public void close() { 
    delegate.close();
  }

  /**
   * @param arg0 
   * @param arg1 
   * @param handler 
   * @return fluent self
   */
  private io.vertx.mutiny.redis.client.RedisAPI __append(String arg0, String arg1, Handler<AsyncResult<io.vertx.mutiny.redis.client.Response>> handler) { 
    delegate.append(arg0, arg1, new Handler<AsyncResult<io.vertx.redis.client.Response>>() {
      public void handle(AsyncResult<io.vertx.redis.client.Response> ar) {
        if (ar.succeeded()) {
          handler.handle(io.vertx.core.Future.succeededFuture(io.vertx.mutiny.redis.client.Response.newInstance(ar.result())));
        } else {
          handler.handle(io.vertx.core.Future.failedFuture(ar.cause()));
        }
      }
    });
    return this;
  }

  /**
   * Redis command <a href="https://redis.io/commands/append">append</a>.
   * <p>
   * Unlike the <em>bare</em> Vert.x variant, this method returns a {@link io.smallrye.mutiny.Uni Uni}.
   * Don't forget to <em>subscribe</em> on it to trigger the operation.
   * @param arg0 
   * @param arg1 
   * @return fluent self
   */
  public Uni<io.vertx.mutiny.redis.client.Response> append(String arg0, String arg1) { 
    return io.smallrye.mutiny.vertx.AsyncResultUni.toUni(handler -> {
      __append(arg0, arg1, handler);
    });
  }

〜省略〜
}

生成元のRedisAPIインターフェースは、こんな感じでした。

〜省略〜

@VertxGen
public interface RedisAPI {

  @GenIgnore(PERMITTED_TYPE)
  static RedisAPI api(Redis client) {
    return new RedisAPIImpl(client);
  }

  @GenIgnore(PERMITTED_TYPE)
  static RedisAPI api(RedisConnection connection) {
    return new RedisAPIImpl(connection);
  }

  void close();

  /**
   * Redis command <a href="https://redis.io/commands/append">append</a>.
   * @return fluent self
   */
  @Fluent
  default RedisAPI append(String arg0, String arg1, Handler<AsyncResult<@Nullable Response>> handler) {
    send(Command.APPEND, arg0, arg1).setHandler(handler);
    return this;
  }

  /**
   * Redis command <a href="https://redis.io/commands/asking">asking</a>.
   * @return fluent self
   */
  @Fluent
  default RedisAPI asking(Handler<AsyncResult<@Nullable Response>> handler) {
    send(Command.ASKING).setHandler(handler);
    return this;
  }

〜省略〜
}

https://github.com/vert-x3/vertx-redis-client/blob/3.9.4/src/main/java/io/vertx/redis/client/RedisAPI.java

とりあえず、こちらはここまで。

Maven Processor Pluginでソースコードを生成する

続いては、Maven Processor Pluginを使います。

ライブラリの依存関係は、これだけでOKです。

    <dependencies>
        <dependency>
            <groupId>io.vertx</groupId>
            <artifactId>vertx-redis-client</artifactId>
            <version>3.9.4</version>
        </dependency>

        <dependency>
            <groupId>io.smallrye.reactive</groupId>
            <artifactId>smallrye-mutiny-vertx-core</artifactId>
            <version>1.2.2</version>
        </dependency>
    </dependencies>

Mavenプラグインの設定は、こんな感じに。

    <build>
        <plugins>
            <plugin>
                <artifactId>maven-dependency-plugin</artifactId>
                <configuration>
                    <includeGroupIds>io.vertx</includeGroupIds>
                    <includeArtifactIds>vertx-redis-client</includeArtifactIds>
                    <classifier>sources</classifier>
                    <includeTypes>jar</includeTypes>
                </configuration>
                <executions>
                    <execution>
                        <id>unpack-java</id>
                        <phase>generate-sources</phase>
                        <goals>
                            <goal>unpack-dependencies</goal>
                        </goals>
                        <configuration>
                            <includes>io/vertx/**/*.java</includes>
                            <excludes>**/impl/**/*.java</excludes>
                            <outputDirectory>${project.build.directory}/sources/java</outputDirectory>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
            <plugin>
                <groupId>org.bsc.maven</groupId>
                <artifactId>maven-processor-plugin</artifactId>
                <version>4.4-jdk8</version>
                <configuration>
                    <systemProperties>
                        <java.util.logging.SimpleFormatter.format>%4$s: %3$s - %5$s %6$s%n</java.util.logging.SimpleFormatter.format>
                        <mvel2.disable.jit>true</mvel2.disable.jit>
                    </systemProperties>
                </configuration>
                <executions>
                    <execution>
                        <goals>
                            <goal>process</goal>
                        </goals>
                        <phase>generate-sources</phase>
                        <configuration>
                            <sourceDirectory>${project.build.directory}/sources/java</sourceDirectory>
                            <processors>
                                <processor>io.vertx.codegen.CodeGenProcessor</processor>
                            </processors>
                            <optionMap>
                                <codegen.generators>mutiny</codegen.generators>
                            </optionMap>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>

Maven Dependency Pluginの設定は、先ほどとまったく同じなので割愛します。

違うのはこちら。プロジェクトのソースディレクトリとしてvertx-redis-clientの展開先をsourceDirectoryで指定しています。

            <plugin>
                <groupId>org.bsc.maven</groupId>
                <artifactId>maven-processor-plugin</artifactId>
                <version>4.4-jdk8</version>
                <configuration>
                    <systemProperties>
                        <java.util.logging.SimpleFormatter.format>%4$s: %3$s - %5$s %6$s%n</java.util.logging.SimpleFormatter.format>
                        <mvel2.disable.jit>true</mvel2.disable.jit>
                    </systemProperties>
                </configuration>
                <executions>
                    <execution>
                        <goals>
                            <goal>process</goal>
                        </goals>
                        <phase>generate-sources</phase>
                        <configuration>
                            <sourceDirectory>${project.build.directory}/sources/java</sourceDirectory>
                            <processors>
                                <processor>io.vertx.codegen.CodeGenProcessor</processor>
                            </processors>
                            <optionMap>
                                <codegen.generators>mutiny</codegen.generators>
                            </optionMap>
                        </configuration>
                    </execution>
                </executions>
            </plugin>

アノテーションプロセッサーの指定およびSmalleRye Mutiny向けのGeneratorの指定は、こちら。

                            <processors>
                                <processor>io.vertx.codegen.CodeGenProcessor</processor>
                            </processors>
                            <optionMap>
                                <codegen.generators>mutiny</codegen.generators>
                            </optionMap>

パッケージング。

$ mvn package

結果はほぼ同じなので、割愛します。

生成したライブラリを使う

では、生成したライブラリを使ってみましょう。ライブラリ依存関係とMavenプラグインの設定は、こちら。

    <dependencies>
        <dependency>
            <groupId>${project.groupId}</groupId>
            <artifactId>my-smallrye-mutiny-vertx-redis-client</artifactId>
            <version>${project.version}</version>
        </dependency>

        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter-api</artifactId>
            <version>5.7.0</version>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter-engine</artifactId>
            <version>5.7.0</version>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.assertj</groupId>
            <artifactId>assertj-core</artifactId>
            <version>3.18.1</version>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <artifactId>maven-surefire-plugin</artifactId>
                <version>2.22.2</version>
            </plugin>
        </plugins>
    </build>

テストコードで確認することにします。

自前のライブラリの部分は、こちらですね。

        <dependency>
            <groupId>${project.groupId}</groupId>
            <artifactId>my-smallrye-mutiny-vertx-redis-client</artifactId>
            <version>${project.version}</version>
        </dependency>

テストコード。
src/test/java/org/littlewings/vertx/codegen/mutiny/ReactiveRedisTest.java

package org.littlewings.vertx.codegen.mutiny;

import java.util.List;

import io.smallrye.mutiny.Uni;
import io.vertx.mutiny.core.Vertx;
import io.vertx.mutiny.redis.client.Redis;
import io.vertx.mutiny.redis.client.RedisAPI;
import io.vertx.mutiny.redis.client.Response;
import org.junit.jupiter.api.Test;

import static org.assertj.core.api.Assertions.assertThat;

public class ReactiveRedisTest {
    @Test
    public void putAndGet() {
        Vertx vertx = Vertx.vertx();

        Redis redis = Redis.createClient(vertx, "redis://redispass@172.17.0.2:6379/1");
        RedisAPI redisApi = RedisAPI.api(redis);

        Uni<Response> setResponse = redisApi.set(List.of("key1", "value1"));
        Uni<Response> getResponse = setResponse.flatMap(r -> redisApi.get("key1"));

        Response actualGetResponse = getResponse
                .await()
                .indefinitely();

        assertThat(actualGetResponse.toString())
                .isEqualTo("value1");
    }
}

Redisは、172.17.0.2でパスワード「redispass」で起動しているものとします。なお、バージョンは6.0.9を使用しました。

        Redis redis = Redis.createClient(vertx, "redis://redispass@172.17.0.2:6379/1");

あとは、SmallRye Mutiny向けに生成されたAPIを使ってテストを書いて確認。

    @Test
    public void putAndGet() {
        Vertx vertx = Vertx.vertx();

        Redis redis = Redis.createClient(vertx, "redis://redispass@172.17.0.2:6379/1");
        RedisAPI redisApi = RedisAPI.api(redis);

        Uni<Response> setResponse = redisApi.set(List.of("key1", "value1"));
        Uni<Response> getResponse = setResponse.flatMap(r -> redisApi.get("key1"));

        Response actualGetResponse = getResponse
                .await()
                .indefinitely();

        assertThat(actualGetResponse.toString())
                .isEqualTo("value1");
    }

すべて、SmalleRye Mutiny向けのパッケージです。Vertxすら、Mutiny向けのものがあるのに注意です。

import io.smallrye.mutiny.Uni;
import io.vertx.mutiny.core.Vertx;
import io.vertx.mutiny.redis.client.Redis;
import io.vertx.mutiny.redis.client.RedisAPI;
import io.vertx.mutiny.redis.client.Response;

SmallRye Mutiny向けのVertxの生成元は、こちらですね。

https://github.com/smallrye/smallrye-reactive-utils/tree/1.2.2/vertx-mutiny-clients/vertx-mutiny-core

テストは、これでパスするので最低限はOKということで。

Maven Compiler PluginとMaven Processor Pluginの使い分けは、オリジナルのライブラリからソースコードを自動生成するだけでは
なくて、src/main/javaに追加で自作のものがあったりする場合に選ぶのかな？とも思ったのですが、vertx-mutiny-coreの
構成を見る限りそうでもなさそうです…。こちらもMaven Processr Plugin。

https://github.com/smallrye/smallrye-reactive-utils/tree/1.2.2/vertx-mutiny-clients/vertx-mutiny-core

まあ、いいかな…？

まとめ

Vert.x API Generationについてちょっと調べてみたのと、自分でも他のライブラリからソースコードを生成する例を試して
みました。

これで、SmallRye Mutinyに対応されているやり方はなんとなくわかるでしょう。

というのと、あとでこのエントリを見れば思い出すでしょう…。

最後に、自前のsmallrye-mutiny-vertx-redis-clientを生成するpom.xmlの全体を2種類載せておきます。
マルチモジュール構成のまま載せているのは、ご愛嬌…。

Maven Compile Pluginを使うパターン。

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <artifactId>vertx-codegen-redis-example</artifactId>
        <groupId>org.littlewings</groupId>
        <version>0.0.1-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>my-smallrye-mutiny-vertx-redis-client</artifactId>

    <dependencies>
        <dependency>
            <groupId>io.vertx</groupId>
            <artifactId>vertx-redis-client</artifactId>
            <version>3.9.4</version>
        </dependency>

        <dependency>
            <groupId>io.smallrye.reactive</groupId>
            <artifactId>smallrye-mutiny-vertx-core</artifactId>
            <version>1.2.2</version>
        </dependency>

        <dependency>
            <groupId>io.vertx</groupId>
            <artifactId>vertx-codegen</artifactId>
            <classifier>processor</classifier>
            <version>3.9.4</version>
            <optional>true</optional>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <artifactId>maven-dependency-plugin</artifactId>
                <configuration>
                    <includeGroupIds>io.vertx</includeGroupIds>
                    <includeArtifactIds>vertx-redis-client</includeArtifactIds>
                    <classifier>sources</classifier>
                    <includeTypes>jar</includeTypes>
                </configuration>
                <executions>
                    <execution>
                        <id>unpack-java</id>
                        <phase>generate-sources</phase>
                        <goals>
                            <goal>unpack-dependencies</goal>
                        </goals>
                        <configuration>
                            <includes>io/vertx/**/*.java</includes>
                            <excludes>**/impl/**/*.java</excludes>
                            <outputDirectory>${project.build.directory}/sources/java</outputDirectory>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
            <plugin>
                <groupId>org.codehaus.mojo</groupId>
                <artifactId>build-helper-maven-plugin</artifactId>
                <version>3.2.0</version>
                <executions>
                    <execution>
                        <phase>generate-sources</phase>
                        <goals>
                            <goal>add-source</goal>
                        </goals>
                        <configuration>
                            <sources>
                                <source>${project.build.directory}/sources/java</source>
                            </sources>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
            <plugin>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.8.1</version>
                <configuration>
                    <source>11</source>
                    <target>11</target>
                    <encoding>${project.build.sourceEncoding}</encoding>
                    <useIncrementalCompilation>false</useIncrementalCompilation>
                </configuration>
                <executions>
                    <execution>
                        <id>generate-mutiny-source</id>
                        <configuration>
                            <annotationProcessors>
                                <annotationProcessor>io.vertx.codegen.CodeGenProcessor</annotationProcessor>
                            </annotationProcessors>
                            <compilerArgs>
                                <arg>-Acodegen.generators=mutiny</arg>
                            </compilerArgs>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

Maven Processor Pluginを使う場合。

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <artifactId>vertx-codegen-redis-example</artifactId>
        <groupId>org.littlewings</groupId>
        <version>0.0.1-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>my-smallrye-mutiny-vertx-redis-client</artifactId>

    <dependencies>
        <dependency>
            <groupId>io.vertx</groupId>
            <artifactId>vertx-redis-client</artifactId>
            <version>3.9.4</version>
        </dependency>

        <dependency>
            <groupId>io.smallrye.reactive</groupId>
            <artifactId>smallrye-mutiny-vertx-core</artifactId>
            <version>1.2.2</version>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <artifactId>maven-dependency-plugin</artifactId>
                <configuration>
                    <includeGroupIds>io.vertx</includeGroupIds>
                    <includeArtifactIds>vertx-redis-client</includeArtifactIds>
                    <classifier>sources</classifier>
                    <includeTypes>jar</includeTypes>
                </configuration>
                <executions>
                    <execution>
                        <id>unpack-java</id>
                        <phase>generate-sources</phase>
                        <goals>
                            <goal>unpack-dependencies</goal>
                        </goals>
                        <configuration>
                            <includes>io/vertx/**/*.java</includes>
                            <excludes>**/impl/**/*.java</excludes>
                            <outputDirectory>${project.build.directory}/sources/java</outputDirectory>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
            <plugin>
                <groupId>org.bsc.maven</groupId>
                <artifactId>maven-processor-plugin</artifactId>
                <version>4.4-jdk8</version>
                <configuration>
                    <systemProperties>
                        <java.util.logging.SimpleFormatter.format>%4$s: %3$s - %5$s %6$s%n</java.util.logging.SimpleFormatter.format>
                        <mvel2.disable.jit>true</mvel2.disable.jit>
                    </systemProperties>
                </configuration>
                <executions>
                    <execution>
                        <goals>
                            <goal>process</goal>
                        </goals>
                        <phase>generate-sources</phase>
                        <configuration>
                            <sourceDirectory>${project.build.directory}/sources/java</sourceDirectory>
                            <processors>
                                <processor>io.vertx.codegen.CodeGenProcessor</processor>
                            </processors>
                            <optionMap>
                                <codegen.generators>mutiny</codegen.generators>
                            </optionMap>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

Maven Shade PluginのResource Transformerをちゃんと見る

これは、なにをしたくて書いたもの？

Maven Shade Pluginを使うと、依存関係を含めたアーティファクトをUber JARにパッケージングすることができます。

で、設定する時にResource Transformerをなんとなく使っていたので、今回ちゃんと見てみようかなぁという気になりまして。

Resource Transformer？

Resource Transformerとは、複数のアーティファクトやライブラリを集約する際に、重複するリソースをマージするための
方法を提供するものです。

一覧はここに載っています。

Apache Maven Shade Plugin – Resource Transformers

ざっと載せると、こんな感じですね。

• ApacheLicenseResourceTransformer … ライセンスの重複を防ぐ
• ApacheNoticeResourceTransformer … NOTICEファイルの集約
• AppendingTransformer … 指定の名前のファイルの内容をひとつに集約する
• ComponentsXmlResourceTransformer … META-INF/plexus/components.xmlファイルをマージする
• DontIncludeResourceTransformer … 指定されたルールに合致するファイルが含まれないようにする
• GroovyResourceTransformer … Apache Groovyによる拡張モジュールファイル（META-INF/services/org.codehaus.groovy.runtime.ExtensionModule）をマージする
• IncludeResourceTransformer … 指定したリソースを追加する
• ManifestResourceTransformer … MANIFESTを設定する
• PluginXmlResourceTransformer … Maven Plugin Descriptorを再配置する
• ResourceBundleAppendingTransformer … 指定されたResourceBundleをマージする
• ServicesResourceTransformer … META-INF/services/配下にあるService Loaderによりロードするファイルをマージする
• XmlAppendingTransformer … 指定されたXMLファイルをマージする
• PropertiesTransformer … 指定のプロパティファイルをマージする
• OpenWebBeansPropertiesTransformer … Apache OpenWebBeansの設定ファイルをマージする
• MicroprofileConfigTransformer … 指定されたMicroProfile Configで使う設定ファイルをマージする

ソースコード自体は、こちらにあります。

https://github.com/apache/maven-shade-plugin/tree/maven-shade-plugin-3.2.4/src/main/java/org/apache/maven/plugins/shade/resource

https://github.com/apache/maven-shade-plugin/tree/maven-shade-plugin-3.2.4/src/main/java/org/apache/maven/plugins/shade/resource/properties

とまあ、説明を読んでいるとどんなことができそうなのか雰囲気はわかるのですが、少しは使ってみましょうか。

お題

こちらのネタを流用して、Maven Shade Pluginを使ってUber JARを作ろうと思います。

RESTEasy＋Vert.x（Handler）で遊ぶ - CLOVER🍀

ソースコードの内容は、もうちょっとシンプルにします。

この時に、Resource Transformerをいくつか使ってみましょう。

環境

今回の環境は、こちら。

$ java --version
openjdk 11.0.9.1 2020-11-04
OpenJDK Runtime Environment (build 11.0.9.1+1-Ubuntu-0ubuntu1.20.04)
OpenJDK 64-Bit Server VM (build 11.0.9.1+1-Ubuntu-0ubuntu1.20.04, mixed mode, sharing)


$ mvn --version
Apache Maven 3.6.3 (cecedd343002696d0abb50b32b541b8a6ba2883f)
Maven home: $HOME/.sdkman/candidates/maven/current
Java version: 11.0.9.1, vendor: Ubuntu, runtime: /usr/lib/jvm/java-11-openjdk-amd64
Default locale: ja_JP, platform encoding: UTF-8
OS name: "linux", version: "5.4.0-54-generic", arch: "amd64", family: "unix"

準備

Maven依存関係は、これだけ設定。

    <dependencies>
        <dependency>
            <groupId>org.jboss.resteasy</groupId>
            <artifactId>resteasy-vertx</artifactId>
            <version>4.5.8.Final</version>
        </dependency>
        <dependency>
            <groupId>org.jboss.resteasy</groupId>
            <artifactId>resteasy-reactor</artifactId>
            <version>4.5.8.Final</version>
        </dependency>
        <dependency>
            <groupId>org.jboss.resteasy</groupId>
            <artifactId>resteasy-jackson2-provider</artifactId>
            <version>4.5.8.Final</version>
        </dependency>

        <dependency>
            <groupId>io.vertx</groupId>
            <artifactId>vertx-core</artifactId>
            <version>3.9.4</version>
        </dependency>
        <dependency>
            <groupId>io.projectreactor</groupId>
            <artifactId>reactor-core</artifactId>
            <version>3.4.0</version>
        </dependency>
        <dependency>
            <groupId>javax.enterprise</groupId>
            <artifactId>cdi-api</artifactId>
            <version>2.0.SP1</version>
        </dependency>
    </dependencies>

ソースコードはこちら。ちょっと強引に、Jackson 2とReactorを使います。

src/main/java/org/littlewings/maven/shade/App.java

package org.littlewings.maven.shade;

import io.vertx.core.Vertx;
import io.vertx.core.http.HttpServer;
import org.jboss.logging.Logger;
import org.jboss.resteasy.plugins.server.vertx.VertxRequestHandler;
import org.jboss.resteasy.plugins.server.vertx.VertxResteasyDeployment;
import org.jboss.resteasy.spi.ResteasyDeployment;

public class App {
    public static void main(String... args) {
        Logger logger = Logger.getLogger(App.class);

        Vertx vertx = Vertx.vertx();
        HttpServer server = vertx.createHttpServer();

        ResteasyDeployment deployment = new VertxResteasyDeployment();
        deployment.start();
        deployment.getRegistry().addPerRequestResource(EchoResource.class);

        server.requestHandler(new VertxRequestHandler(vertx, deployment));

        int port = 8080;
        server.listen(port);

        logger.infof("startup, server[%d]", port);
    }
}

src/main/java/org/littlewings/maven/shade/EchoResource.java

package org.littlewings.maven.shade;

import javax.ws.rs.Consumes;
import javax.ws.rs.POST;
import javax.ws.rs.Path;
import javax.ws.rs.Produces;
import javax.ws.rs.core.MediaType;

import reactor.core.publisher.Mono;

@Path("echo")
public class EchoResource {
    @POST
    @Consumes(MediaType.APPLICATION_JSON)
    @Produces(MediaType.APPLICATION_JSON)
    public Mono<MessageResponse> echo(MessageRequest request) {
        String message = request.getMessage();

        String responseMessage = String.format("reply: %s", message);

        return Mono.just(new MessageResponse(responseMessage));
    }


    public static class MessageRequest {
        String message;

        public String getMessage() {
            return message;
        }
    }

    public static class MessageResponse {
        String message;

        public MessageResponse(String message) {
            this.message = message;
        }

        public String getMessage() {
            return message;
        }
    }
}

起動。

$ mvn compile exec:java -Dexec.mainClass=org.littlewings.maven.shade.App

動作確認。

$ curl -i -H 'Content-Type: application/json' localhost:8080/echo -d '{"message": "Hello World!!"}'
HTTP/1.1 200 OK
transfer-encoding: chunked
Content-Type: application/json

{"message":"reply: Hello World!!"}

このアプリケーションを、Maven Shade PluginでUber JARにしていきます。

Maven Shade Pluginを設定する

なにはともあれということで、Maven Shade Pluginをまずは設定します。

        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-shade-plugin</artifactId>
                <version>3.2.4</version>
                <executions>
                    <execution>
                        <phase>package</phase>
                        <goals>
                            <goal>shade</goal>
                        </goals>
                    </execution>
                </executions>
                </configuration>
            </plugin>
        </plugins>
    </build>

パッケージングします。

$ mvn package

すると、targetディレクトリ配下に生成されるJARファイルが、Uber JARになります。

$ ll -h target/maven-shade-plugin-example-0.1.jar 
-rw-rw-r-- 1 xxxxx xxxxx 14M 11月 22 23:04 target/maven-shade-plugin-example-0.1.jar

起動には、mainメソッドを持ったクラスの指定が必要です。

$ java -cp target/maven-shade-plugin-example-0.1.jar org.littlewings.maven.shade.App
11月 22, 2020 11:05:55 午後 org.littlewings.maven.shade.App main
INFO: startup, server[8080]

実は、オリジナルのJARファイルを置き換えるようにメッセージが出ているので

[INFO] Replacing original artifact with shaded artifact.
[INFO] Replacing /path/to/target/maven-shade-plugin-example-0.1.jar with /path/to/target/maven-shade-plugin-example-0.1-shaded.jar

オリジナルのJARファイルを残すようにしてみましょうか。

configurationで、shadedArtifactAttachedをtrueに指定します。

            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-shade-plugin</artifactId>
                <version>3.2.4</version>
                <executions>
                    <execution>
                        <phase>package</phase>
                        <goals>
                            <goal>shade</goal>
                        </goals>
                    </execution>
                </executions>
                <configuration>
                    <shadedArtifactAttached>true</shadedArtifactAttached>
                </configuration>
            </plugin>

パッケージング。

$ mvn clean package

こうすると、オリジナルのJARファイルが残り、Maven Shade PluginによるUber JARはshaded classierが付いた状態で
作成されます。

$ ll target/*.jar
-rw-rw-r-- 1 xxxxx xxxxx 13668491 11月 22 23:07 target/maven-shade-plugin-example-0.1-shaded.jar
-rw-rw-r-- 1 xxxxx xxxxx     5395 11月 22 23:07 target/maven-shade-plugin-example-0.1.jar

このshadedというのは、shadedClassifierNameで変更可能です。

                <configuration>
                    <shadedArtifactAttached>true</shadedArtifactAttached>
                    <shadedClassifierName>uber-jar</shadedClassifierName>
                </configuration>

生成される名前については、outputFile、shadedArtifactId、finalNameなど設定可能なものがいくつかあるので、詳しくは
shade:shadeゴールのドキュメントを参照。

Apache Maven Shade Plugin – shade:shade

以降は、以下の状態からconfigurationの中を変更していきます。

                <configuration>
                    <shadedArtifactAttached>true</shadedArtifactAttached>
                </configuration>

ManifestResourceTransformerでMANIFESTの設定を行う

最初に、mainクラスを指定していたのをなんとかしましょう。ManifestResourceTransformerを使用します。

Setting Manifest Entries with the ManifestResourceTransformer

こちらにも、ほぼ同等のことが書かれています。

Apache Maven Shade Plugin – Executable JAR

こんな感じで。

                <configuration>
                    <shadedArtifactAttached>true</shadedArtifactAttached>
                    <transformers>
                        <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                            <manifestEntries>
                                <Main-Class>org.littlewings.maven.shade.App</Main-Class>
                            </manifestEntries>
                        </transformer>
                    </transformers>
                </configuration>

これで、Main-Classを指定するとMETA-INF/MANIFEST.MFに指定したクラスが設定されます。

MANIFEST.MFの中身を確認。

$ unzip -p target/maven-shade-plugin-example-0.1-shaded.jar META-INF/MANIFEST.MF
Manifest-Version: 1.0
Archiver-Version: Plexus Archiver
Created-By: Apache Maven 3.6.3
Built-By: kazuhira
Build-Jdk: 11.0.9.1
Main-Class: org.littlewings.maven.shade.App

パッケージングして起動確認。

$ java -jar target/maven-shade-plugin-example-0.1-shaded.jar 
11月 22, 2020 11:25:22 午後 org.littlewings.maven.shade.App main
INFO: startup, server[8080]

java -jarで起動できるようになりました。

ServicesResourceTransformerを使って、META-INF/servicesの中身をマージする

ところで、現状だとJARファイルを実行してもうまく動きません。

$ curl -i -H 'Content-Type: application/json' localhost:8080/echo -d '{"message": "Hello World!!"}'
HTTP/1.1 415 Unsupported Media Type
transfer-encoding: chunked

Content-Typeに対応したMessageBodyReaderがないと言っています。

11月 22, 2020 11:26:56 午後 org.jboss.resteasy.core.ExceptionHandler handleWebApplicationException
ERROR: RESTEASY002010: Failed to execute
javax.ws.rs.NotSupportedException: RESTEASY003200: Could not find message body reader for type: class org.littlewings.maven.shade.EchoResource$MessageRequest of content type: application/json
    at org.jboss.resteasy.core.interception.jaxrs.ServerReaderInterceptorContext.throwReaderNotFound(ServerReaderInterceptorContext.java:55)
    at org.jboss.resteasy.core.interception.jaxrs.AbstractReaderInterceptorContext.getReader(AbstractReaderInterceptorContext.java:133)
    at org.jboss.resteasy.core.interception.jaxrs.AbstractReaderInterceptorContext.proceed(AbstractReaderInterceptorContext.java:75)

パッケージングする時に実はこんな感じで大量にWARNINGが出力されていて、Uber JARを作るために各アーティファクト、
ライブラリをまとめる時にファイルが重複しているものがあると言っています。

[WARNING] Discovered module-info.class. Shading will break its strong encapsulation.
[WARNING] Discovered module-info.class. Shading will break its strong encapsulation.
[WARNING] Discovered module-info.class. Shading will break its strong encapsulation.
[WARNING] Discovered module-info.class. Shading will break its strong encapsulation.
[WARNING] Discovered module-info.class. Shading will break its strong encapsulation.
[WARNING] Discovered module-info.class. Shading will break its strong encapsulation.
[WARNING] Discovered module-info.class. Shading will break its strong encapsulation.
[WARNING] Discovered module-info.class. Shading will break its strong encapsulation.
[WARNING] Discovered module-info.class. Shading will break its strong encapsulation.
[WARNING] Discovered module-info.class. Shading will break its strong encapsulation.
[WARNING] asyncutil-0.1.0.jar, btf-1.3.jar, cdi-api-2.0.SP1.jar, commons-codec-1.13.jar, commons-io-2.5.jar, commons-logging-1.2.jar, httpclient-4.5.12.jar, httpcore-4.4.13.jar, istack-commons-runtime-3.0.10.jar, jackson-annotations-2.11.1.jar, jackson-core-2.11.1.jar, jackson-coreutils-2.0.jar, jackson-databind-2.11.1.jar, jackson-jaxrs-base-2.11.1.jar, jackson-jaxrs-json-provider-2.11.1.jar, jackson-module-jaxb-annotations-2.11.1.jar, jakarta.activation-1.2.1.jar, jakarta.activation-api-1.2.1.jar, jakarta.validation-api-2.0.2.jar, javax.el-api-3.0.0.jar, javax.interceptor-api-1.2.jar, jaxb-runtime-2.3.3-b02.jar, jboss-annotations-api_1.3_spec-2.0.1.Final.jar, jboss-jaxb-api_2.3_spec-1.0.1.Final.jar, jboss-jaxrs-api_2.1_spec-2.0.1.Final.jar, jboss-logging-3.3.2.Final.jar, json-patch-1.13.jar, maven-shade-plugin-example-0.1.jar, microprofile-config-api-1.4.jar, microprofile-context-propagation-api-1.0-RC1.jar, msg-simple-1.2.jar, netty-buffer-4.1.49.Final.jar, netty-codec-4.1.49.Final.jar, netty-codec-dns-4.1.49.Final.jar, netty-codec-http-4.1.49.Final.jar, netty-codec-http2-4.1.49.Final.jar, netty-codec-socks-4.1.49.Final.jar, netty-common-4.1.49.Final.jar, netty-handler-4.1.49.Final.jar, netty-handler-proxy-4.1.49.Final.jar, netty-resolver-4.1.49.Final.jar, netty-resolver-dns-4.1.49.Final.jar, netty-transport-4.1.49.Final.jar, reactive-streams-1.0.3.jar, reactor-core-3.4.0.jar, resteasy-client-4.5.8.Final.jar, resteasy-client-api-4.5.8.Final.jar, resteasy-context-propagation-4.5.8.Final.jar, resteasy-core-4.5.8.Final.jar, resteasy-core-spi-4.5.8.Final.jar, resteasy-jackson2-provider-4.5.8.Final.jar, resteasy-jaxb-provider-4.5.8.Final.jar, resteasy-reactor-4.5.8.Final.jar, resteasy-vertx-4.5.8.Final.jar, smallrye-config-1.6.1.jar, smallrye-config-common-1.6.1.jar, smallrye-context-propagation-1.0.1.jar, smallrye-context-propagation-api-1.0.1.jar, txw2-2.3.3-b02.jar, vertx-core-3.9.4.jar define 1 overlapping resource: 
[WARNING]   - META-INF/MANIFEST.MF
[WARNING] istack-commons-runtime-3.0.10.jar, jakarta.activation-1.2.1.jar, jakarta.activation-api-1.2.1.jar, jaxb-runtime-2.3.3-b02.jar, jboss-annotations-api_1.3_spec-2.0.1.Final.jar, jboss-jaxrs-api_2.1_spec-2.0.1.Final.jar, txw2-2.3.3-b02.jar define 2 overlapping resources: 
[WARNING]   - META-INF/LICENSE.md
[WARNING]   - META-INF/NOTICE.md
[WARNING] cdi-api-2.0.SP1.jar, commons-codec-1.13.jar, commons-io-2.5.jar, commons-logging-1.2.jar, javax.el-api-3.0.0.jar, javax.interceptor-api-1.2.jar, jboss-jaxb-api_2.3_spec-1.0.1.Final.jar, jboss-logging-3.3.2.Final.jar define 1 overlapping resource: 
[WARNING]   - META-INF/LICENSE.txt
[WARNING] btf-1.3.jar, httpclient-4.5.12.jar, httpcore-4.4.13.jar, jackson-annotations-2.11.1.jar, jackson-core-2.11.1.jar, jackson-coreutils-2.0.jar, jackson-databind-2.11.1.jar, jackson-jaxrs-base-2.11.1.jar, jackson-jaxrs-json-provider-2.11.1.jar, jackson-module-jaxb-annotations-2.11.1.jar, jboss-jaxb-api_2.3_spec-1.0.1.Final.jar, json-patch-1.13.jar, microprofile-config-api-1.4.jar, msg-simple-1.2.jar define 1 overlapping resource: 
[WARNING]   - META-INF/LICENSE
[WARNING] jakarta.activation-1.2.1.jar, jakarta.activation-api-1.2.1.jar define 31 overlapping classes: 
[WARNING]   - javax.activation.ActivationDataFlavor
[WARNING]   - javax.activation.CommandInfo
[WARNING]   - javax.activation.CommandInfo$Beans
[WARNING]   - javax.activation.CommandInfo$Beans$1
[WARNING]   - javax.activation.CommandMap
[WARNING]   - javax.activation.CommandObject
[WARNING]   - javax.activation.DataContentHandler
[WARNING]   - javax.activation.DataContentHandlerFactory
[WARNING]   - javax.activation.DataHandler
[WARNING]   - javax.activation.DataHandler$1
[WARNING]   - 21 more...
[WARNING] resteasy-client-4.5.8.Final.jar, resteasy-context-propagation-4.5.8.Final.jar, resteasy-core-4.5.8.Final.jar, resteasy-jackson2-provider-4.5.8.Final.jar, resteasy-jaxb-provider-4.5.8.Final.jar, resteasy-reactor-4.5.8.Final.jar define 1 overlapping resource: 
[WARNING]   - META-INF/services/javax.ws.rs.ext.Providers
[WARNING] httpclient-4.5.12.jar, httpcore-4.4.13.jar, jackson-core-2.11.1.jar, jackson-databind-2.11.1.jar, jackson-jaxrs-json-provider-2.11.1.jar, jackson-module-jaxb-annotations-2.11.1.jar, microprofile-config-api-1.4.jar define 1 overlapping resource: 
[WARNING]   - META-INF/NOTICE
[WARNING] httpclient-4.5.12.jar, httpcore-4.4.13.jar define 1 overlapping resource: 
[WARNING]   - META-INF/DEPENDENCIES
[WARNING] commons-codec-1.13.jar, commons-io-2.5.jar, commons-logging-1.2.jar define 1 overlapping resource: 
[WARNING]   - META-INF/NOTICE.txt
[WARNING] btf-1.3.jar, jackson-coreutils-2.0.jar, json-patch-1.13.jar, msg-simple-1.2.jar define 2 overlapping resources: 
[WARNING]   - META-INF/ASL-2.0.txt
[WARNING]   - META-INF/LGPL-3.0.txt
[WARNING] netty-common-4.1.49.Final.jar, reactor-core-3.4.0.jar define 1 overlapping resource: 
[WARNING]   - META-INF/services/reactor.blockhound.integration.BlockHoundIntegration
[WARNING] netty-buffer-4.1.49.Final.jar, netty-codec-4.1.49.Final.jar, netty-codec-dns-4.1.49.Final.jar, netty-codec-http-4.1.49.Final.jar, netty-codec-http2-4.1.49.Final.jar, netty-codec-socks-4.1.49.Final.jar, netty-common-4.1.49.Final.jar, netty-handler-4.1.49.Final.jar, netty-handler-proxy-4.1.49.Final.jar, netty-resolver-4.1.49.Final.jar, netty-resolver-dns-4.1.49.Final.jar, netty-transport-4.1.49.Final.jar define 1 overlapping resource: 
[WARNING]   - META-INF/io.netty.versions.properties
[WARNING] maven-shade-plugin has detected that some class files are
[WARNING] present in two or more JARs. When this happens, only one
[WARNING] single version of the class is copied to the uber jar.
[WARNING] Usually this is not harmful and you can skip these warnings,
[WARNING] otherwise try to manually exclude artifacts based on
[WARNING] mvn dependency:tree -Ddetail=true and the above output.
[WARNING] See http://maven.apache.org/plugins/maven-shade-plugin/

で、今回は特にこれが問題になっていますね。

[WARNING] resteasy-client-4.5.8.Final.jar, resteasy-context-propagation-4.5.8.Final.jar, resteasy-core-4.5.8.Final.jar, resteasy-jackson2-provider-4.5.8.Final.jar, resteasy-jaxb-provider-4.5.8.Final.jar, resteasy-reactor-4.5.8.Final.jar define 1 overlapping resource: 
[WARNING]   - META-INF/services/javax.ws.rs.ext.Providers

マージ後はどうなっているんでしょう？

$ unzip -p target/maven-shade-plugin-example-0.1-shaded.jar META-INF/services/javax.ws.rs.ext.Providers
org.jboss.resteasy.client.jaxrs.internal.CompletionStageRxInvokerProvider

ひとつだけ残っています…。

ここで、ServicesResourceTransformerを使います。

Concatenating Service Entries with the ServicesResourceTransformer

                <configuration>
                    <shadedArtifactAttached>true</shadedArtifactAttached>
                    <transformers>
                        <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                            <manifestEntries>
                                <Main-Class>org.littlewings.maven.shade.App</Main-Class>
                            </manifestEntries>
                        </transformer>
                        <transformer implementation="org.apache.maven.plugins.shade.resource.ServicesResourceTransformer"/>
                    </transformers>
                </configuration>

JARファイルを再度作成して起動。

$ java -jar target/maven-shade-plugin-example-0.1-shaded.jar 
11月 22, 2020 11:37:36 午後 org.littlewings.maven.shade.App main
INFO: startup, server[8080]

確認。

$ curl -i -H 'Content-Type: application/json' localhost:8080/echo -d '{"message": "Hello World!!"}'
HTTP/1.1 200 OK
transfer-encoding: chunked
Content-Type: application/json

{"message":"reply: Hello World!!"}

今度はOKでした。

マージ後のファイルはどうなったんでしょう？

$ unzip -p target/maven-shade-plugin-example-0.1-shaded.jar META-INF/services/javax.ws.rs.ext.Providers
org.jboss.resteasy.client.jaxrs.internal.CompletionStageRxInvokerProvider
org.jboss.resteasy.plugins.providers.AsyncStreamingOutputProvider
org.jboss.resteasy.plugins.providers.DataSourceProvider
org.jboss.resteasy.plugins.providers.DocumentProvider
org.jboss.resteasy.plugins.providers.DefaultTextPlain
org.jboss.resteasy.plugins.providers.DefaultNumberWriter
org.jboss.resteasy.plugins.providers.DefaultBooleanWriter
org.jboss.resteasy.plugins.providers.StringTextStar
org.jboss.resteasy.plugins.providers.SourceProvider
org.jboss.resteasy.plugins.providers.InputStreamProvider
org.jboss.resteasy.plugins.providers.ReaderProvider
org.jboss.resteasy.plugins.providers.ByteArrayProvider
org.jboss.resteasy.plugins.providers.FormUrlEncodedProvider
org.jboss.resteasy.plugins.providers.JaxrsFormProvider
org.jboss.resteasy.plugins.providers.CompletionStageProvider
org.jboss.resteasy.plugins.providers.ReactiveStreamProvider
org.jboss.resteasy.plugins.providers.FileProvider
org.jboss.resteasy.plugins.providers.FileRangeWriter
org.jboss.resteasy.plugins.providers.StreamingOutputProvider
org.jboss.resteasy.plugins.providers.IIOImageProvider
org.jboss.resteasy.plugins.providers.MultiValuedParamConverterProvider
org.jboss.resteasy.plugins.interceptors.CacheControlFeature
org.jboss.resteasy.plugins.interceptors.ClientContentEncodingAnnotationFeature
org.jboss.resteasy.plugins.interceptors.ServerContentEncodingAnnotationFeature
org.jboss.resteasy.plugins.interceptors.MessageSanitizerContainerResponseFilter
org.jboss.resteasy.plugins.providers.sse.SseEventProvider
org.jboss.resteasy.plugins.providers.sse.SseEventSinkInterceptor

org.jboss.resteasy.reactor.MonoProvider
org.jboss.resteasy.reactor.MonoRxInvokerImpl
org.jboss.resteasy.reactor.MonoRxInvokerProvider
org.jboss.resteasy.reactor.FluxProvider
org.jboss.resteasy.reactor.FluxRxInvokerImpl
org.jboss.resteasy.reactor.FluxRxInvokerProvider
org.jboss.resteasy.context.ContextFeature
org.jboss.resteasy.plugins.providers.jackson.ResteasyJackson2Provider
org.jboss.resteasy.plugins.providers.jackson.UnrecognizedPropertyExceptionHandler
org.jboss.resteasy.plugins.providers.jackson.PatchMethodFilter
org.jboss.resteasy.plugins.providers.jaxb.JAXBXmlSeeAlsoProvider
org.jboss.resteasy.plugins.providers.jaxb.JAXBXmlRootElementProvider
org.jboss.resteasy.plugins.providers.jaxb.JAXBElementProvider
org.jboss.resteasy.plugins.providers.jaxb.JAXBXmlTypeProvider
org.jboss.resteasy.plugins.providers.jaxb.CollectionProvider
org.jboss.resteasy.plugins.providers.jaxb.MapProvider
org.jboss.resteasy.plugins.providers.jaxb.XmlJAXBContextFinder

めちゃくちゃ増えました…。

PropertiesTransformerでプロパティファイルをマージする

WARNINGを見ていると、プロパティファイルも重複しているようです。

[WARNING] netty-buffer-4.1.49.Final.jar, netty-codec-4.1.49.Final.jar, netty-codec-dns-4.1.49.Final.jar, netty-codec-http-4.1.49.Final.jar, netty-codec-http2-4.1.49.Final.jar, netty-codec-socks-4.1.49.Final.jar, netty-common-4.1.49.Final.jar, netty-handler-4.1.49.Final.jar, netty-handler-proxy-4.1.49.Final.jar, netty-resolver-4.1.49.Final.jar, netty-resolver-dns-4.1.49.Final.jar, netty-transport-4.1.49.Final.jar define 1 overlapping resource: 
[WARNING]   - META-INF/io.netty.versions.properties

これを、PropertiesTransformerを使ってマージしてみましょう。

Merging properties files with PropertiesTransformer

現時点での中身を確認。

$ unzip -p target/maven-shade-plugin-example-0.1-shaded.jar META-INF/io.netty.versions.properties
#Generated by netty-parent/pom.xml
#Wed, 22 Apr 2020 10:53:19 +0000

netty-common.version=4.1.49.Final
netty-common.buildDate=2020-04-22 10\:53\:19 +0000
netty-common.commitDate=2020-04-22 09\:57\:26 +0000
netty-common.shortCommitHash=d0ec961
netty-common.longCommitHash=d0ec961cce19646519d6a0d59e7604b0eacd9bf2
netty-common.repoStatus=clean

PropertiesTransformerを設定。

                <configuration>
                    <shadedArtifactAttached>true</shadedArtifactAttached>
                    <transformers>
                        <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                            <manifestEntries>
                                <Main-Class>org.littlewings.maven.shade.App</Main-Class>
                            </manifestEntries>
                        </transformer>
                        <transformer implementation="org.apache.maven.plugins.shade.resource.ServicesResourceTransformer"/>
                        <transformer implementation="org.apache.maven.plugins.shade.resource.properties.PropertiesTransformer">
                            <resource>META-INF/io.netty.versions.properties</resource>
                            <alreadyMergedKey>already_merged</alreadyMergedKey>
                        </transformer>
                    </transformers>
                </configuration>

パッケージングして、プロパティファイルの中身を確認。

$ unzip -p target/maven-shade-plugin-example-0.1-shaded.jar META-INF/io.netty.versions.properties
# Merged by maven-shade-plugin (org.apache.maven.plugins.shade.resource.properties.PropertiesTransformer)
netty-buffer.buildDate=2020-04-22 10\:54\:59 +0000
netty-buffer.commitDate=2020-04-22 09\:57\:26 +0000
netty-buffer.longCommitHash=d0ec961cce19646519d6a0d59e7604b0eacd9bf2
netty-buffer.repoStatus=clean
netty-buffer.shortCommitHash=d0ec961
netty-buffer.version=4.1.49.Final
netty-codec-dns.buildDate=2020-04-22 10\:59\:08 +0000
netty-codec-dns.commitDate=2020-04-22 09\:57\:26 +0000
netty-codec-dns.longCommitHash=d0ec961cce19646519d6a0d59e7604b0eacd9bf2
netty-codec-dns.repoStatus=clean
netty-codec-dns.shortCommitHash=d0ec961
netty-codec-dns.version=4.1.49.Final
netty-codec-http.buildDate=2020-04-22 11\:04\:06 +0000
netty-codec-http.commitDate=2020-04-22 09\:57\:26 +0000
netty-codec-http.longCommitHash=d0ec961cce19646519d6a0d59e7604b0eacd9bf2
netty-codec-http.repoStatus=clean
netty-codec-http.shortCommitHash=d0ec961
netty-codec-http.version=4.1.49.Final
netty-codec-http2.buildDate=2020-04-22 11\:04\:52 +0000
netty-codec-http2.commitDate=2020-04-22 09\:57\:26 +0000
netty-codec-http2.longCommitHash=d0ec961cce19646519d6a0d59e7604b0eacd9bf2
netty-codec-http2.repoStatus=clean
netty-codec-http2.shortCommitHash=d0ec961
netty-codec-http2.version=4.1.49.Final
netty-codec-socks.buildDate=2020-04-22 11\:06\:56 +0000
netty-codec-socks.commitDate=2020-04-22 09\:57\:26 +0000
netty-codec-socks.longCommitHash=d0ec961cce19646519d6a0d59e7604b0eacd9bf2
netty-codec-socks.repoStatus=clean
netty-codec-socks.shortCommitHash=d0ec961
netty-codec-socks.version=4.1.49.Final
netty-codec.buildDate=2020-04-22 10\:58\:33 +0000
netty-codec.commitDate=2020-04-22 09\:57\:26 +0000
netty-codec.longCommitHash=d0ec961cce19646519d6a0d59e7604b0eacd9bf2
netty-codec.repoStatus=clean
netty-codec.shortCommitHash=d0ec961
netty-codec.version=4.1.49.Final
netty-common.buildDate=2020-04-22 10\:53\:19 +0000
netty-common.commitDate=2020-04-22 09\:57\:26 +0000
netty-common.longCommitHash=d0ec961cce19646519d6a0d59e7604b0eacd9bf2
netty-common.repoStatus=clean
netty-common.shortCommitHash=d0ec961
netty-common.version=4.1.49.Final
netty-handler-proxy.buildDate=2020-04-22 11\:07\:55 +0000
netty-handler-proxy.commitDate=2020-04-22 09\:57\:26 +0000
netty-handler-proxy.longCommitHash=d0ec961cce19646519d6a0d59e7604b0eacd9bf2
netty-handler-proxy.repoStatus=clean
netty-handler-proxy.shortCommitHash=d0ec961
netty-handler-proxy.version=4.1.49.Final
netty-handler.buildDate=2020-04-22 11\:00\:05 +0000
netty-handler.commitDate=2020-04-22 09\:57\:26 +0000
netty-handler.longCommitHash=d0ec961cce19646519d6a0d59e7604b0eacd9bf2
netty-handler.repoStatus=clean
netty-handler.shortCommitHash=d0ec961
netty-handler.version=4.1.49.Final
netty-resolver-dns.buildDate=2020-04-22 11\:08\:26 +0000
netty-resolver-dns.commitDate=2020-04-22 09\:57\:26 +0000
netty-resolver-dns.longCommitHash=d0ec961cce19646519d6a0d59e7604b0eacd9bf2
netty-resolver-dns.repoStatus=clean
netty-resolver-dns.shortCommitHash=d0ec961
netty-resolver-dns.version=4.1.49.Final
netty-resolver.buildDate=2020-04-22 10\:56\:46 +0000
netty-resolver.commitDate=2020-04-22 09\:57\:26 +0000
netty-resolver.longCommitHash=d0ec961cce19646519d6a0d59e7604b0eacd9bf2
netty-resolver.repoStatus=clean
netty-resolver.shortCommitHash=d0ec961
netty-resolver.version=4.1.49.Final
netty-transport.buildDate=2020-04-22 10\:57\:08 +0000
netty-transport.commitDate=2020-04-22 09\:57\:26 +0000
netty-transport.longCommitHash=d0ec961cce19646519d6a0d59e7604b0eacd9bf2
netty-transport.repoStatus=clean
netty-transport.shortCommitHash=d0ec961
netty-transport.version=4.1.49.Final

めちゃくちゃ増えました…。

ライセンスの破棄やNOTICEのマージ

最後に、ライブラリに含まれているLICENSEおよびLICENSE.txtを破棄して

[WARNING] cdi-api-2.0.SP1.jar, commons-codec-1.13.jar, commons-io-2.5.jar, commons-logging-1.2.jar, javax.el-api-3.0.0.jar, javax.interceptor-api-1.2.jar, jboss-jaxb-api_2.3_spec-1.0.1.Final.jar, jboss-logging-3.3.2.Final.jar define 1 overlapping resource: 
[WARNING]   - META-INF/LICENSE.txt
[WARNING] btf-1.3.jar, httpclient-4.5.12.jar, httpcore-4.4.13.jar, jackson-annotations-2.11.1.jar, jackson-core-2.11.1.jar, jackson-coreutils-2.0.jar, jackson-databind-2.11.1.jar, jackson-jaxrs-base-2.11.1.jar, jackson-jaxrs-json-provider-2.11.1.jar, jackson-module-jaxb-annotations-2.11.1.jar, jboss-jaxb-api_2.3_spec-1.0.1.Final.jar, json-patch-1.13.jar, microprofile-config-api-1.4.jar, msg-simple-1.2.jar define 1 overlapping resource: 
[WARNING]   - META-INF/LICENSE

Preventing License Duplication with the ApacheLicenseResourceTransformer

NOTICEファイルをマージします。

[WARNING] httpclient-4.5.12.jar, httpcore-4.4.13.jar, jackson-core-2.11.1.jar, jackson-databind-2.11.1.jar, jackson-jaxrs-json-provider-2.11.1.jar, jackson-module-jaxb-annotations-2.11.1.jar, microprofile-config-api-1.4.jar define 1 overlapping resource: 
[WARNING]   - META-INF/NOTICE
[WARNING] commons-codec-1.13.jar, commons-io-2.5.jar, commons-logging-1.2.jar define 1 overlapping resource: 
[WARNING]   - META-INF/NOTICE.txt

Aggregating Notices with the ApacheNoticeResourceTransformer

設定。

                <configuration>
                    <shadedArtifactAttached>true</shadedArtifactAttached>
                    <transformers>
                        <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                            <manifestEntries>
                                <Main-Class>org.littlewings.maven.shade.App</Main-Class>
                            </manifestEntries>
                        </transformer>
                        <transformer implementation="org.apache.maven.plugins.shade.resource.ServicesResourceTransformer"/>
                        <transformer implementation="org.apache.maven.plugins.shade.resource.properties.PropertiesTransformer">
                            <resource>META-INF/io.netty.versions.properties</resource>
                            <alreadyMergedKey>already_merged</alreadyMergedKey>
                        </transformer>
                        <transformer implementation="org.apache.maven.plugins.shade.resource.ApacheLicenseResourceTransformer">
                        </transformer>
                        <transformer implementation="org.apache.maven.plugins.shade.resource.ApacheNoticeResourceTransformer">
                            <addHeader>false</addHeader>
                        </transformer>
                    </transformers>
                </configuration>

これで、LICENSE.txtおよびLICENSEファイルがなくなります。

$ unzip -l target/maven-shade-plugin-example-0.1-shaded.jar | grep LICENSE
    35084  2019-06-16 21:23   META-INF/LICENSE.md

.mdの方が残っていますが…。

NOTICEファイルは、マージされます。

$ unzip -p target/maven-shade-plugin-example-0.1-shaded.jar META-INF/NOTICE

Apache Commons IO
Copyright 2002-2016 The Apache Software Foundation

This product includes software developed at
The Apache Software Foundation (http://www.apache.org/).

=========================================================================
==  NOTICE file corresponding to section 4(d) of the Apache License,   ==
==  Version 2.0, in this case for Microprofile Config                  ==
=========================================================================

Portions of this software were originally based on the following:
* Apache DeltaSpike Config
  https://deltaspike.apache.org
  under Apache License, v2.0

SPDXVersion: SPDX-2.1
PackageName: Eclipse Microprofile
PackageHomePage: http://www.eclipse.org/microprofile
PackageLicenseDeclared: Apache-2.0

PackageCopyrightText: <text>
Mark Struberg struberg@apache.org,
Gerhard Petracek gpetracek@apache.org,
Romain Manni-Bucau rmannibucau@apache.org,
Ron Smeral rsmeral@apache.org,
Emily Jiang emijiang@uk.ibm.com,
Ondrej Mihalyi ondrej.mihalyi@gmail.com,
Gunnar Morling gunnar@hibernate.org
</text>

Apache HttpClient
Copyright 1999-2020 The Apache Software Foundation

Apache HttpCore
Copyright 2005-2020 The Apache Software Foundation

Apache Commons Logging
Copyright 2003-2014 The Apache Software Foundation

Apache Commons Codec
Copyright 2002-2019 The Apache Software Foundation

This product includes software developed at
The Apache Software Foundation (https://www.apache.org/).

src/test/org/apache/commons/codec/language/DoubleMetaphoneTest.java
contains test data from http://aspell.net/test/orig/batch0.tab.
Copyright (C) 2002 Kevin Atkinson (kevina@gnu.org)

===============================================================================

The content of package org.apache.commons.codec.language.bm has been translated
from the original php source code available at http://stevemorse.org/phoneticinfo.htm
with permission from the original authors.
Original source copyright:
Copyright (c) 2008 Alexander Beider & Stephen P. Morse.

# Jackson JSON processor

Jackson is a high-performance, Free/Open Source JSON processing library.
It was originally written by Tatu Saloranta (tatu.saloranta@iki.fi), and has
been in development since 2007.
It is currently developed by a community of developers, as well as supported
commercially by FasterXML.com.

## Licensing

Jackson core and extension components may licensed under different licenses.
To find the details that apply to this artifact see the accompanying LICENSE file.
For more information, including possible other licensing options, contact
FasterXML.com (http://fasterxml.com).

## Credits

A list of contributors may be found from CREDITS file, which is included
in some artifacts (usually source distributions); but is always available
from the source code management (SCM) system project uses.

Jackson core and extension components may be licensed under different licenses.
To find the details that apply to this artifact see the accompanying LICENSE file.
For more information, including possible other licensing options, contact
FasterXML.com (http://fasterxml.com).

今回は、ざっとこんな感じで。

まとめ

これまでMaven Shade Pluginをそれほど使っていなかったというのと、使っても雰囲気でコピー＆ペーストしていてあまり
ちゃんと見ていなかったので、これを機に見てみてだいぶ雰囲気わかった気がします。

今後は、もうちょっとちゃんと使いましょう…。

最後に、今回のMaven Shade Pluginの設定全体を載せておきます。

            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-shade-plugin</artifactId>
                <version>3.2.4</version>
                <executions>
                    <execution>
                        <phase>package</phase>
                        <goals>
                            <goal>shade</goal>
                        </goals>
                    </execution>
                </executions>
                <configuration>
                    <shadedArtifactAttached>true</shadedArtifactAttached>
                    <transformers>
                        <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                            <manifestEntries>
                                <Main-Class>org.littlewings.maven.shade.App</Main-Class>
                            </manifestEntries>
                        </transformer>
                        <transformer implementation="org.apache.maven.plugins.shade.resource.ServicesResourceTransformer"/>
                        <transformer implementation="org.apache.maven.plugins.shade.resource.properties.PropertiesTransformer">
                            <resource>META-INF/io.netty.versions.properties</resource>
                            <alreadyMergedKey>already_merged</alreadyMergedKey>
                        </transformer>
                        <transformer implementation="org.apache.maven.plugins.shade.resource.ApacheLicenseResourceTransformer">
                        </transformer>
                        <transformer implementation="org.apache.maven.plugins.shade.resource.ApacheNoticeResourceTransformer">
                            <addHeader>false</addHeader>
                        </transformer>
                    </transformers>
                </configuration>
            </plugin>