Mavenの依存モジュールを操作する

ソースは公開されているがMavenリポジトリで公開されていないモジュールを利用するときに困ったので、依存関係を処理するコマンドのメモ。

• 例えばAzureのNotificationHubsを叩くモジュール

• 参考

  • Apache Maven Assembly Plugin
  • Azure/azure-notificationhubs-java-backend
  • Maven Assembly Pluginで実行可能jarをつくる

jarを生成

• targetフォルダにjarファイルを生成する。

$ mvn package

• ソースとJavadocのjarファイル生成

$ mvn source:jar javadoc:jar

テストをスキップする

• maven.test.skipプロパティを利用
  • -Dオプションでコマンドラインから指定できる。

$ mvn package -Dmaven.test.skip=true

fat jar(uber-jar) を作成

• 依存するモジュールを一つのjarにまとめる。
  • assemblyプラグインを利用する（またはshade）。
    • ここではassemblyを利用する。

pom.xml

• assemblyプラグインを追記し、ディスクリプタjar-with-dependenciesを設定する。
  • https://maven.apache.org/plugins/maven-assembly-plugin/usage.html

<build>
  [...]
  <plugins>
    [...]
    <plugin>
      <artifactId>maven-assembly-plugin</artifactId>
      <version>3.0.0</version>
      <configuration>
        <descriptorRefs>
          <descriptorRef>jar-with-dependencies</descriptorRef>
        </descriptorRefs>
      </configuration>
      <executions>
        <execution>
          <id>make-assembly</id>
          <phase>package</phase>
          <goals>
            <goal>single</goal>
          </goals>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

• packageコマンドで、targetフォルダに*-jar-with-dependencies.jarが出力される。
  • 通常のjarファイルもあわせて出力される。

$ mvn package

依存ライブラリをダウンロード

任意のフォルダにダウンロード

• dependency:copy-dependenciesで依存しているモジュールをダウンロードする。
  • デフォルトでは./target/dependencyにダウンロードを行う。
    • outputDirectoryプロパティでダウンロード先フォルダを変更できる。
    • classifierプロパティでソースファイル・Javadocのダウンロード指定を行う。
      • その他オプション: http://maven.apache.org/plugins/maven-dependency-plugin/copy-dependencies-mojo.html

$ mvn dependency:copy-dependencies
$ mvn dependency:copy-dependencies -Dclassifier=sources
$ mvn dependency:copy-dependencies -Dclassifier=javadoc

ローカルリポジトリにダウンロード

• デフォルトのローカルリポジトリ
  • ${HOME}/.m2/repository
    • リポジトリを変更するならmaven.repo.localプロパティを変更する

$ mvn dependency:go-offline