Apache Mavenを使うとJavaの開発時にライブラリを簡単に導入できて重宝していますが、Javaアプリを実行することも簡単にできます。さっそくやってみましょう。
準備
まずはJavaアプリの雛形を作成します。お馴染みのQuickStartですね。
$ mvn archetype:generate \ -DgroupId=org.sssg.soft.sample.maven \ -DartifactId=simpleapp \ -DarchetypeArtifactId=maven-archetype-quickstart \ -DinteractiveMode=false
simpleappディレクトリができあがり、srcにはHello Worldを表示するプログラムが自動生成されます。
exec-maven-plugin
これでJavaアプリの雛形ができるので、できあがったsimpleappディレクトリにあるpom.xmlにexec-maven-pluginを使うための記述を追加します。具体的には「
<build> <plugins> <plugin> <groupId>org.codehaus.mojo</groupId> <artifactId>exec-maven-plugin</artifactId> <configuration> <mainClass>org.sssg.soft.sample.maven.App</mainClass> </configuration> </plugin> </plugins> </build>
準備はこれだけです。実行してみましょう。mvn packageをしてから、mvn exec:javaとすると、Hello World!という出力がでているのがわかるでしょうか。
$ cd simpleapp $ mvn package $ mvn exec:java (略) [INFO] <<< exec-maven-plugin:1.2.1:java (default-cli) @ simpleapp <<< [INFO] [INFO] --- exec-maven-plugin:1.2.1:java (default-cli) @ simpleapp --- Hello World! [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 0.482s [INFO] Finished at: Tue Jul 30 17:31:01 JST 2013 [INFO] Final Memory: 5M/15M [INFO] ------------------------------------------------------------------------
引き数を扱うこともできます。src/main/org/sssg/soft/sample/maven/App.javaを次のように修正します。
package org.sssg.soft.sample.maven; public class App { public static void main( String[] args ) { System.out.println( "Hello World!" ); int i=0; for (String a: args) { System.out.println("arg" + i + ":" + a); i++; } } }
次にpom.xmlを修正します。exec-maven-pluginの設定でarguments要素を追加している点に注目してください。ここで指定した内容が実行時に引き数として渡されます。
<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/maven-v4_0_0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>org.sssg.soft.sample.maven</groupId> <artifactId>simpleapp</artifactId> <packaging>jar</packaging> <version>1.0-SNAPSHOT</version> <name>simpleapp</name> <url>http://maven.apache.org</url> <build> <plugins> <plugin> <groupId>org.codehaus.mojo</groupId> <artifactId>exec-maven-plugin</artifactId> <configuration> <mainClass>org.sssg.soft.sample.maven.App</mainClass> <arguments> <argument>a1</argument> <argument>a2</argument> </arguments> </configuration> </plugin> </plugins> </build> <dependencies> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>3.8.1</version> <scope>test</scope> </dependency> </dependencies> </project>
さっきと同様にしてmvn package してから、mvn exec:java をしてみましょう。下記のように引き数の情報が表示され、引き数がプログラムに渡っていることがわかります。
[INFO] --- exec-maven-plugin:1.2.1:java (default-cli) @ simpleapp --- Hello World! arg0:a1 arg1:a2 [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 0.449s [INFO] Finished at: Tue Jul 30 17:40:25 JST 2013 [INFO] Final Memory: 5M/15M [INFO] ------------------------------------------------------------------------
実行時に次のように指定すると、設定ファイルとは別の引き数を渡すことができます。
$ mvn exec:java -Dexec.args="b1 b2 b3"
便利ですね!
maven-jar-plugin
maven-jar-pluginを使うと、実行時に依存関係があるライブラリをJavaアプリのjarと一緒にtargetディレクトリへ出力することができます。自作アプリを他のマシンへ持っていくときなどに便利ですね。
さきほどの、pom.xmlでbuild要素の中に入れたplugins要素に、maven-jar-pluginの設定を追加します。
<plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-jar-plugin</artifactId> <configuration> <archive> <manifest> <mainClass>org.sssg.soft.sample.maven.App</mainClass> <packageName>org.sssg.soft.sample.maven</packageName> <addClasspath>true</addClasspath> <addExtensions>true</addExtensions> <classpathPrefix>dependency</classpathPrefix> </manifest> </archive> </configuration> </plugin> </plugins>
例えばlog4jを追加すると下記のようなpom.xmlとなります。
<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/maven-v4_0_0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>org.sssg.soft.sample.maven</groupId> <artifactId>simpleapp</artifactId> <packaging>jar</packaging> <version>1.0-SNAPSHOT</version> <name>simpleapp</name> <url>http://maven.apache.org</url> <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-jar-plugin</artifactId> <version>2.4</version> <configuration> <archive> <manifest> <mainClass>org.sssg.soft.sample.maven.App</mainClass> <packageName>org.sssg.soft.sample.maven</packageName> <addClasspath>true</addClasspath> <addExtensions>true</addExtensions> <classpathPrefix>dependency</classpathPrefix> </manifest> </archive> </configuration> </plugin> </plugins> </build> <dependencies> <dependency> <groupId>log4j</groupId> <artifactId>log4j</artifactId> <version>1.2.17</version> </dependency> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>3.8.1</version> <scope>test</scope> </dependency> </dependencies> </project>
ライブラリをclasspathPrefix要素で指定したdependencyディレクトリへ出力するには次のようにします。
$ mvn package $ mvn dependency:copy-dependencies
Manifestファイルにも使用するライブラリの情報が書き込まれます。
$ cat META-INF/MANIFEST.MF Manifest-Version: 1.0 Extension-List: log4j Built-By: hiro345 Build-Jdk: 1.7.0_25 Class-Path: dependency/log4j-1.2.17.jar Package: org.sssg.soft.sample.maven log4j-Extension-Name: log4j Created-By: Apache Maven 3.0.4 log4j-Implementation-Version: 1.2.17 Main-Class: org.sssg.soft.sample.maven.App Archiver-Version: Plexus Archiver
実行は下記のようになります。targetディレクトリにJARファイルとdependencyディレクトリが生成されるので、targetディレクトリでjarファイルを実行すれば良いということですね。
$ cd target $ java -jar simpleapp-1.0-SNAPSHOT.jar
依存ライブラリをdependencyではなく例えばlibとかのディレクトリへ出力するように変更したい場合は、classpathPrefix要素のボディ部をlibと変更して、mvn dependency:copy-dependenciesを実行するときに-DoutputDirectory=target/libとします。
$ mvn package $ mvn dependency:copy-dependencies -DoutputDirectory=target/lib
- Apache Maven 3クックブック Javaソフトウェア開発のための特選レシピ集
- プログラミング言語Java (The Java Series)
- Effective Java 第2版 (The Java Series)