先生と生徒の会話形式で理解しよう

生徒

「Spring BootのプロジェクトをJavaで作りたいんですが、どうやって始めればいいですか？」

先生

「いい質問ですね！Spring Bootはウェブアプリケーションを簡単に作成できるフレームワークです。EclipseとGradleを使ったプロジェクトの作成方法について説明していきましょう。」

生徒

「どんな設定が必要なんでしょうか？」

先生

「依存関係としてSpring Web、Thymeleaf、Spring Boot DevToolsを追加しておくと便利ですよ。」

1. Spring Bootプロジェクトの作成方法

まずは「Spring Bootのプロジェクトをひとつ用意する」ところから始めます。プロジェクトとは、これから作っていくJavaファイルや設定ファイルをひとまとめにした「作業フォルダ」のようなものです。ここで土台をしっかり用意しておくと、あとから画面や機能を追加しやすくなります。

今回の手順では、Java初心者の方でも使いやすい統合開発環境であるEclipseと、ビルドや依存関係の管理を自動化してくれるGradleを組み合わせて、Spring Bootプロジェクトを作成していきます。難しい設定ファイルをいちから書かなくても、ウィザードに沿って入力するだけで、すぐに実行できるアプリケーションのひな型が完成します。

プロジェクト作成の流れは、ざっくり次のようなイメージです。

新しいSpring Bootプロジェクトを作成する
プロジェクト名やパッケージ名、Javaのバージョンを指定する
Webアプリで使う機能（Spring WebやThymeleafなど）を依存関係として追加する

最終的には、次のような「メインクラス」が自動生成された状態からスタートできます。


@SpringBootApplication
public class DemoApplication {

    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }

}

今はこのコードの細かい意味が分からなくても問題ありません。「アプリを起動するための入り口」としてSpring Bootが自動で用意してくれるものだ、とざっくり覚えておけば大丈夫です。この土台となるプロジェクトを、次の章ではEclipseの画面操作を追いながら実際に作っていきましょう。

2. EclipseでのSpring Bootプロジェクト作成

まずはEclipseを使ってSpring Bootプロジェクトを作成してみましょう。

次の手順に従って、Eclipseで新規プロジェクトを作成します。

ステップ1: Eclipseを起動し、ファイルから新規 > その他を選択します。
ステップ2: Spring Starter Projectを選び、次へをクリックします。
ステップ3: プロジェクト名を入力し、パッケージ名やJavaのバージョンを選択します。ビルドツールにはGradleを選択します。
ステップ4: 依存関係の設定では、以下の3つを追加します。
- Spring Web: RESTfulなウェブアプリケーションを作成するために必要です。
- Thymeleaf: テンプレートエンジンとして、動的なHTMLを生成します。
- Spring Boot DevTools: アプリケーションを自動でリロードするなど、開発を効率化します。
ステップ5: 完了をクリックすると、自動的にプロジェクトが生成されます。

3. Gradleによるプロジェクト構成

Spring Bootプロジェクトの依存関係や設定は、build.gradleファイルで管理します。ここでは、Spring Web、Thymeleaf、Spring Boot DevToolsの依存関係を追加したサンプルを紹介します。


plugins {
    id 'org.springframework.boot' version '2.5.4'
    id 'io.spring.dependency-management' version '1.0.11.RELEASE'
    id 'java'
}

group = 'com.example'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = '11'

repositories {
    mavenCentral()
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'
    developmentOnly 'org.springframework.boot:spring-boot-devtools'
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

tasks.named('test') {
    useJUnitPlatform()
}

上記のbuild.gradleファイルでは、必要な依存関係を記述しています。依存関係により、Spring Webを使ってWebアプリケーションを構築し、Thymeleafでテンプレートエンジンを使用でき、DevToolsが自動リロード機能を提供します。

4. Spring Bootプロジェクトの起動と確認

プロジェクトの設定が完了したら、Spring Bootアプリケーションを起動します。Eclipseでは以下のように操作して実行できます。

手順1: プロジェクトを右クリックし、実行 > Spring Bootアプリケーションとして実行を選択します。
手順2: ブラウザを開き、http://localhost:8080にアクセスしてアプリケーションが起動していることを確認します。

これでHello, World!のような基本の表示ができるようになり、Spring Bootプロジェクトが正しく動作していることを確認できます。

5. Spring Web、Thymeleaf、Spring Boot DevToolsの詳細

ここでは、依存関係で追加した3つのライブラリの役割について詳しく説明します。

Spring Web: Spring Bootでウェブアプリケーションを作成するための基本的なモジュールで、REST APIを簡単に構築できます。
Thymeleaf: 動的なHTMLページを生成するためのテンプレートエンジンで、HTMLファイル内で変数を使うことができます。
Spring Boot DevTools: 開発支援ツールで、コード変更時に自動リロードができるため、効率的な開発が可能です。

これらの依存関係を利用することで、簡単にWebページを作成し、変更を即座に反映できるため、初学者にとっても取り組みやすい環境が整います。

6. まとめ

この記事では、Spring Bootを使用したプロジェクト作成の基本手順を解説しました。EclipseとGradleを使うことで、初心者でも簡単にウェブアプリケーションの開発を始められます。Spring WebやThymeleafといった依存関係を追加することで、ダイナミックなHTMLページやREST APIの開発もスムーズに行えます。

また、Spring Boot DevToolsを利用することで、コードの変更を即座に反映する自動リロード機能を活用でき、開発効率が大幅に向上します。build.gradleを使った依存関係の管理やプロジェクトの構成についても学びました。

以下に、今回の記事を元に作成されたHello, World!アプリケーションのサンプルコードを掲載します。Spring Bootのプロジェクト作成から起動までの流れを復習してください。


import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@SpringBootApplication
public class SummaryApplication {

    public static void main(String[] args) {
        SpringApplication.run(SummaryApplication.class, args);
    }

    @RestController
    class HelloController {
        @GetMapping("/")
        public String hello() {
            return "Hello, World! Spring Bootで簡単なアプリケーションを作成！";
        }
    }
}

このコードでは、@SpringBootApplicationや@RestControllerを使用し、Spring Bootアプリケーションを簡潔に構築しています。ブラウザでhttp://localhost:8080にアクセスすると、「Hello, World!」が表示されます。

Spring Bootは、初期設定が簡単で、初心者でも実用的なウェブアプリケーションを短期間で作成することが可能です。ぜひこの記事を参考に、初めてのSpring Bootプロジェクトに挑戦してみてください。

先生と生徒の振り返り会話

生徒

「Spring Bootのプロジェクト作成は思ったより簡単でした！EclipseとGradleを使えば、すぐに開発が始められますね。」

先生

「その通りです。特にSpring Bootは、デフォルト設定が豊富で、初心者にも使いやすい設計になっています。」

生徒

「Gradleのbuild.gradleファイルで依存関係を管理するのも便利でした。自動リロード機能も役に立ちます！」

先生

「そうですね。DevToolsのおかげで、コードを変更するたびにアプリケーションを再起動する手間が省けます。」

生徒