JavaプロジェクトとMaven/Gradle

以前、EclipseやIntelliJ IDEAといったIDEの導入をしました。それでコードを書き始める準備が整ったわけだけど、ちょっと待って！その前に、Java開発に欠かせないもう一つの強力なツール、プロジェクト管理ツールについて知っておこう。

「プロジェクト管理ツール？いきなり難しそう…」と思うかもしれないけど、心配はいらない。今回は、Java開発でよく使われるMavenとGradleという2つのツールを、初心者でもわかるように、フランクな言葉で解説していくね。これらを使いこなせると、開発効率がグッと上がるから、ぜひマスターしてほしいな。

なぜプロジェクト管理ツールが必要なの？

さて、まずは「なんでそんなものが必要なの？」という疑問から解消していこう。簡単なプログラムなら、Javaファイルをコンパイルして実行するだけだから、特に問題ないよね。でも、開発が進んでプロジェクトが大きくなってくると、以下のような問題が出てくるんだ。

たくさんのライブラリ管理: Java開発では、便利な機能を持ったライブラリを組み合わせて使うことがほとんど。例えば、「Webアプリケーションを作りたい」と思ったら、Spring FrameworkやHibernateといったライブラリが必要になる。これらを一つ一つ手動でダウンロードして、プロジェクトに組み込むのは、正直言ってめちゃくちゃ面倒！しかも、ライブラリ同士の依存関係（あるライブラリを使うために、別のライブラリも必要になること）も考慮しないといけないし、バージョン管理も大変なんだ。
ビルド（コンパイル・パッケージング）の自動化: コードを書いても、それを実行可能な形式（JARファイルやWARファイルなど）に変換する「ビルド」という作業が必要だよね。開発が進むと、このビルドも複雑になってくる。いちいち手動でコマンドを打つのは非効率だし、ミスも起こりやすい。
プロジェクトの標準化: チームで開発する場合、メンバーごとに開発環境やビルド方法がバラバラだと、予期せぬエラーや問題が発生しやすくなる。プロジェクトのビルド手順を標準化して、誰がやっても同じ結果になるようにしたいよね。

こんな問題を解決してくれるのが、MavenやGradleといったプロジェクト管理ツールなんだ。彼らは、これらの面倒な作業を自動化してくれる、まさに開発者の救世主！

プロジェクト管理ツールって何をしてくれるの？

具体的にどんなことをしてくれるのか、主な機能をいくつか見てみよう。

依存関係の解決: これが一番ありがたい機能かもしれないね。必要なライブラリの名前とバージョンを教えてあげるだけで、あとはツールが自動的にインターネット上からダウンロードしてきて、プロジェクトに組み込んでくれるんだ。しかも、そのライブラリがさらに別のライブラリに依存している場合でも、芋づる式に全部ダウンロードしてくれる。
ビルドの自動化: コードのコンパイル、テストの実行、実行可能なJARファイルやWARファイルの作成、ドキュメントの生成など、プロジェクトのビルドに関わる一連の作業を自動化してくれる。コマンド一つで、複雑なビルドプロセスが実行できるようになるよ。
プロジェクト構成の標準化: プロジェクトのディレクトリ構成や、ビルドの設定などを標準化できる。これにより、誰が見ても同じように理解できる、整理されたプロジェクトになるんだ。

Mavenってどんなツール？

まずは、Javaの世界で長らくデファクトスタンダードとして使われてきたMavenから見ていこう。

Mavenは、「Convention over Configuration (設定より規約)」という考え方を強く意識して作られているツールなんだ。これは、「特別な設定をしない限り、こういう構成で開発するんだよ」という規約があらかじめ決められているということ。このおかげで、初めてMavenを使う人でも、比較的簡単にプロジェクトの作成やビルドができるようになっているんだ。

Mavenのプロジェクトは、「POM (Project Object Model)」というXML形式のファイルで管理されるよ。このpom.xmlファイルに、プロジェクトの基本情報（プロジェクト名、バージョンなど）や、必要なライブラリの情報（依存関係）、ビルドの設定などを記述していくんだ。

Mavenのpom.xmlの例:

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/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example</groupId>
    <artifactId>my-first-maven-app</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>jar</packaging>

    <name>My First Maven Application</name>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
            <version>2.0.7</version>
        </dependency>
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter-api</artifactId>
            <version>5.10.0</version>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-jar-plugin</artifactId>
                <version>3.3.0</version>
                <configuration>
                    <archive>
                        <manifest>
                            <addClasspath>true</addClasspath>
                            <mainClass>com.example.MyApplication</mainClass>
                        </manifest>
                    </archive>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

この例では、slf4j-apiというログ出力用のライブラリと、junit-jupiter-apiというテスト用のライブラリを依存関係として定義しているんだ。Mavenは、このXMLファイルを読み込んで、必要なライブラリを自動でダウンロードしてくれるんだよ。

Mavenの基本的なコマンド:

mvn clean: ビルド時に生成されたファイルを削除する
mvn compile: ソースコードをコンパイルする
mvn test: テストを実行する
mvn package: コンパイル済みのコードをJARファイルなどの形式にパッケージングする
mvn install: 作成したパッケージをローカルリポジトリにインストールする（他のMavenプロジェクトから参照できるようになる）

Gradleってどんなツール？

次に紹介するのは、近年、人気をぐんぐん伸ばしているGradleだ。Mavenに比べて後発だけど、より柔軟で高機能なのが特徴だよ。Androidアプリ開発の標準ビルドツールとしても採用されているから、名前を聞いたことがある人もいるかもしれないね。

Gradleは、ビルドスクリプトに「Groovy」や「Kotlin DSL」という言語を使うんだ。MavenがXMLで設定を記述するのに対し、Gradleはプログラミング言語でビルドのロジックを記述できるから、より複雑なビルド処理も柔軟に実現できるんだ。

Gradleのbuild.gradleの例 (Groovy DSL):

Groovy

plugins {
    id 'java'
    id 'application' // アプリケーション実行に必要な設定を追加
}

group 'com.example'
version '1.0-SNAPSHOT'

repositories {
    mavenCentral() // Maven Centralリポジトリからライブラリを取得
}

dependencies {
    implementation 'org.slf4j:slf4j-api:2.0.7' // 実行時に必要なライブラリ
    testImplementation 'org.junit.jupiter:junit-jupiter-api:5.10.0' // テスト時に必要なライブラリ
}

application {
    mainClass = 'com.example.MyApplication' // 実行するメインクラス
}

jar {
    manifest {
        attributes 'Main-Class': 'com.example.MyApplication'
    }
    from {
        configurations.runtimeClasspath.collect { it.isDirectory() ? it : zipTree(it) }
    }
}

MavenのXMLと比べて、より直感的で記述量が少ないように感じるかな？ GradleもMavenと同じく、このbuild.gradleファイルを読み込んで、必要なライブラリのダウンロードやビルドを実行してくれるよ。

Gradleの基本的なコマンド:

gradle clean: ビルド時に生成されたファイルを削除する
gradle build: コンパイル、テスト、パッケージングなど、ビルドの全工程を実行する
gradle run: アプリケーションを実行する（applicationプラグインが適用されている場合）
gradle test: テストを実行する

MavenとGradle、どっちを選べばいいの？

さて、MavenとGradle、どちらを使えばいいのか迷うよね。ざっくりとした選び方としては、こんな感じかな。

Maven:
- 歴史が長く、安定している: 多くの既存プロジェクトで採用されており、情報も豊富。
- 設定より規約: シンプルなプロジェクトであれば、特別な設定なしでサクッと始められる。
- XMLでの設定に抵抗がない: XMLの構造を理解していれば、設定ファイルの読み書きはしやすい。
- 初めてのJavaプロジェクト: まずはシンプルなプロジェクトから始めたいならおすすめ。
Gradle:
- 柔軟性が高い: GroovyやKotlin DSLでビルドロジックを記述できるため、複雑なビルド要件にも対応しやすい。
- 高速なビルド: インクリメンタルビルド（変更があった部分だけをビルドする）やビルドキャッシュなどの機能により、ビルド速度が速い。
- Android開発の標準: 将来的にAndroidアプリ開発も視野に入れているなら、Gradleに慣れておくのは必須。
- モダンなプロジェクト: 新規でプロジェクトを始めるなら、よりモダンで高機能なGradleを選ぶ傾向がある。