PR

Spring Framework開発環境構築ガイド：初心者でも安心！

Spring

Spring Frameworkを使ったWebアプリケーション開発に興味がありますか？

堅牢でスケーラブルなアプリケーションを効率的に開発できるSpringは、Java開発者にとって強力な味方です。この記事では、Spring Frameworkの開発環境をゼロから構築する方法を、初心者の方にも分かりやすく解説します。

1. 開発環境構築の全体像

Spring Frameworkの開発環境を構築するには、主に以下のツールが必要になります。

  • Java Development Kit (JDK): Springアプリケーションを実行するために必須です。
  • 統合開発環境 (IDE): コードの記述、デバッグ、ビルドなどを効率的に行うためのツールです。今回は、Spring開発で最も人気のある「IntelliJ IDEA Community Edition」と「Eclipse」の両方を紹介します。
  • Apache Maven または Gradle: プロジェクトのビルド、依存関係管理を行うためのツールです。Spring Bootプロジェクトでは自動的に設定されますが、概念を理解しておくことは重要です。
  • Spring Initializr: Spring Bootプロジェクトのひな形を簡単に生成できるWebサービスです。

2. 各ツールのインストールと設定

2.1. Java Development Kit (JDK) のインストール

Springアプリケーションを実行するにはJDKが必要です。最新の安定版JDK（現在はJDK 17 LTSまたはJDK 21 LTSが推奨されます）をインストールしましょう。

Oracle JDKまたはOpenJDKのダウンロード:

環境変数の設定 (Windowsの場合):

  • 「コントロールパネル」>「システムとセキュリティ」>「システム」>「システムの詳細設定」を開きます。
  • 「環境変数」ボタンをクリックします。
  • 「システム環境変数」セクションで「Path」を選択し、「編集」をクリックします。
  • 「新規」をクリックし、JDKのbinディレクトリへのパスを追加します（例: C:\Program Files\Java\jdk-17\bin）。
  • 新しく「JAVA_HOME」というシステム変数を追加し、JDKのインストールディレクトリへのパスを設定します（例: C:\Program Files\Java\jdk-17）。

環境変数の設定 (macOS/Linuxの場合):

  • ターミナルを開き、以下のコマンドを実行して、~/.bash_profile、~/.zshrcなどのシェル設定ファイルにJDKのパスを追加します。
export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home # JDKのパスに合わせて変更 export PATH=$JAVA_HOME/bin:$PATH
  • 変更を適用するために、source ~/.bash_profile (または~/.zshrc) を実行するか、ターミナルを再起動します。

インストール確認:

ターミナルまたはコマンドプロンプトで以下のコマンドを実行し、JDKのバージョンが表示されれば成功です。

java -versionjavac -version

2.2. 統合開発環境 (IDE) のインストール

a. IntelliJ IDEA Community Edition (推奨)

Spring開発において非常に人気があり、便利な機能が豊富です。

  1. ダウンロード: https://www.jetbrains.com/ja-jp/idea/download/ からCommunity Editionをダウンロードし、インストールします。
  2. Spring Boot Assistantプラグインのインストール:
    • IntelliJ IDEAを起動し、「Configure」>「Plugins」を選択します。
    • 「Marketplace」タブで「Spring Boot Assistant」と検索し、インストールします。

b. Eclipse

こちらも広く利用されているIDEです。

  1. ダウンロード: https://www.eclipse.org/downloads/ から「Eclipse IDE for Enterprise Java and Web Developers」をダウンロードし、インストールします。
  2. Spring Tools 4 (STS) プラグインのインストール:
    • Eclipseを起動し、「Help」>「Eclipse Marketplace…」を選択します。
    • 検索バーに「Spring Tools 4」と入力し、検索結果からインストールします。

2.3. Maven または Gradle (Spring Initializrで自動生成されるため、個別のインストールは必須ではありませんが、理解しておくと良いでしょう)

Spring BootプロジェクトをSpring Initializrで生成する場合、ビルドツール（MavenまたはGradle）は自動的に組み込まれます。しかし、もし手動でインストールしたい場合は、それぞれの公式サイトからダウンロードしてパスを通すことができます。

3. Spring Bootプロジェクトの作成 (Spring Initializr を利用)

Spring Initializrは、Spring Bootアプリケーションのひな形を簡単に生成できるWebサービスです。

  1. Spring Initializrにアクセス: https://start.spring.io/ にアクセスします。
  2. プロジェクト設定:
    • Project: Maven Project または Gradle Project を選択します。（今回はMaven Projectを推奨）
    • Language: Java を選択します。
    • Spring Boot: 最新の安定版を選択します。
    • Project Metadata:
      • Group: ドメイン名を逆にしたもの（例: com.example）
      • Artifact: プロジェクト名（例: my-spring-app）
      • Name: プロジェクト名（Artifactと同じで良い）
      • Description: プロジェクトの説明
      • Package Name: GroupとArtifactを組み合わせたもの（例: com.example.myspringapp）
    • Packaging: Jar を選択します。（Webアプリケーションの場合はWarも選択可能ですが、今回はJarで進めます）
    • Java: インストールしたJDKのバージョン（例: 17）
  3. Dependencies (依存関係の追加): 「ADD DEPENDENCIES…」ボタンをクリックし、必要な依存関係を追加します。最低限、Webアプリケーションを開発するために以下のものを追加しましょう。
    • Spring Web: Webアプリケーション開発に必要なモジュール
    • Spring Boot DevTools: 開発時の利便性を高めるツール（自動リロードなど）
    • Lombok: ボイラープレートコードを削減するのに役立つライブラリ
    必要に応じて、データベース接続のためのSpring Data JPA、テンプレートエンジンのThymeleafなどを追加してください。
  4. プロジェクトの生成とダウンロード: 設定が完了したら、「GENERATE」ボタンをクリックしてプロジェクトをダウンロードします。ZIPファイルがダウンロードされるので、任意のディレクトリに解凍します。

4. IDEでのプロジェクトインポートと実行

a. IntelliJ IDEAの場合

  1. IntelliJ IDEAを起動し、「Open」をクリックします。
  2. 解凍したプロジェクトのルートディレクトリ（pom.xmlまたはbuild.gradleがあるディレクトリ）を選択し、「Open」をクリックします。
  3. IntelliJ IDEAが自動的にMavenまたはGradleプロジェクトとして認識し、必要な依存関係をダウンロードします。（初回は時間がかかる場合があります）
  4. プロジェクト構造が構築されたら、src/main/java/com/example/myproject/MySpringAppApplication.java のようなメインクラスを開きます。
  5. メインクラスのmainメソッドの左にある緑色の実行ボタンをクリックし、「Run ‘MySpringAppApplication'”」を選択します。
  6. コンソールに「Started MySpringAppApplication in …」のようなメッセージが表示されれば、アプリケーションが起動しています。デフォルトではポート8080で起動します。

b. Eclipseの場合

  1. Eclipseを起動し、「File」>「Import…」を選択します。
  2. 「Maven」>「Existing Maven Projects」を選択し、「Next」をクリックします。
  3. 「Browse…」をクリックし、解凍したプロジェクトのルートディレクトリを選択します。
  4. pom.xmlが認識されることを確認し、「Finish」をクリックします。
  5. Eclipseがプロジェクトをインポートし、必要な依存関係をダウンロードします。（初回は時間がかかる場合があります）
  6. プロジェクト構造が構築されたら、src/main/java/com/example/myproject/MySpringAppApplication.java のようなメインクラスを右クリックします。
  7. 「Run As」>「Spring Boot App」を選択します。
  8. コンソールに「Started MySpringAppApplication in …」のようなメッセージが表示されれば、アプリケーションが起動しています。デフォルトではポート8080で起動します。

5. Hello Worldアプリケーションの作成と確認

アプリケーションが起動したら、簡単な「Hello World」を表示するRESTコントローラーを作成してみましょう。

  1. メインクラスと同じパッケージ（例: com.example.myspringapp）に新しいJavaクラスを作成します。名前はHelloController.javaとします。
  2. 以下のコードを記述します。
package com.example.myspringapp;
import org.springframework.web.bind.annotation.GetMapping;import org.springframework.web.bind.annotation.RestController;
@RestControllerpublic class HelloController {    @GetMapping("/")
    public String hello() {
        return "Hello, Spring World!";
    }
}
  1. ファイルを保存します。Spring Boot DevToolsを導入している場合、自動的にアプリケーションが再起動するはずです。
  2. Webブラウザを開き、http://localhost:8080/ にアクセスします。
  3. ブラウザに「Hello, Spring World!」と表示されれば、Spring Frameworkの開発環境構築は無事に完了です！

まとめ

これで、Spring Frameworkを使ったアプリケーション開発を始める準備が整いました。この環境をベースに、さらに複雑なWebアプリケーションやRESTful APIの構築に挑戦してみてください。

Happy coding!

コメント

タイトルとURLをコピーしました