EclipseでSpring Bootの環境構築 | 分かりやすく図解で説明

2019年9月4日 2024年5月27日

1 EclipseでSpring Bootの環境構築手順
2 事前準備
3 Spring Bootプロジェクトの作成
4 MySQLの接続設定
5 Spring Bootプロジェクトの起動
6 終わりに

EclipseでSpring Bootの環境構築手順

Spring Bootとは、Spring FrameworkをベースとしたWebアプリケーションを手軽に作成できるフレームワークです。

◆構築する開発環境

開発環境	名称	説明
開発言語	Java	人気の開発言語
開発ツール	Eclipse	Javaでの定番開発ツール
フレームワーク	Spring Boot	人気のSpringフレームワークをベースとしたフレームワーク
テンプレートエンジン	Thymeleaf	Spring Bootと相性が良いテンプレートエンジン
データベース	MySQL	フリーで利用できる人気データベース

本記事では、Spring Bootを使用したWebアプリケーションの開発環境構築手順を紹介します。

事前準備

Java、Eclipseのインストール

まずは開発言語であるJavaと、開発ツールであるEclipseのインストールを行います。

インストール手順はこちら ⇒ Eclipseのインストール手順 | 分かりやすく図解で説明

MySQLのインストール

次にデータベースであるMySQLのインストールを行います。

インストール手順はこちら ⇒ MySQLのインストール手順 | 分かりやすく図解で説明

Spring Tool Suite（STS）のインストール

Spring Bootのプロジェクトを簡単に作成できるプラグインであるSpring Tool Suite（STS）のインストールを行います。

インストール手順はこちら ⇒ Spring Tool Suite（STS）のインストール手順 | 分かりやすく図解で説明

Spring Bootプロジェクトの作成

1. 新規プロジェクトの作成

Eclipseを起動して「ファイル(F)」⇒「新規(N)」⇒「プロジェクト(R)...」をクリックします。

2. Springスターター・プロジェクトの選択

新規プロジェクトのウィザードの選択画面が表示されるので、「Spring Boot」⇒「Springスターター・プロジェクト」を選択して「次へ(N)」を押下します。

3. Spring Bootプロジェクトの基本設定

Spring Bootプロジェクトの基本設定を行います。

名称	説明
名前	Spring Bootのプロジェクト名
型	プロジェクトをビルドするためのツール。以下の2種類があるので、お好みのビルドツールを選択■Maven 「pom.xml」ファイルでビルドする内容を管理 ■Gradle 「build.gradle」ファイルでビルドする内容を管理
パッケージング	プログラムを実行・配布する時のパッケージングの方式。以下の2種類があるので、お好みのパッケージ方式を選択■JAR Java プログラムの実行に必要なクラスファイルや設定ファイルがまとめられているアーカイブ。ライブラリはこの形式で配布されている事が多い。ライブラリを作る場合は、JAR形式を選択する。 ■WAR Webアプリで利用されるクラスファイル、設定ファイル、HTMLファイル、JAR形式のライブラリなどがまとめられているアーカイブ。アプリケーションサーバにWARファイルを配布すると、これを元にデプロイされる。Webアプリケーションを作る場合は、WAR形式を選択する。
Javaバージョン	Spring Bootプロジェクトで使用するJavaのバージョンを選択
言語	Spring Bootプロジェクトで使用する言語を選択。選択できる言語はJavaのプラットフォーム上で動作する「Java」「kotlin」「groovy」

今回は、型を「Gradle」、パッケージング「War」、Javaバージョン「11」、言語「Java」を選択します。

※パッケージ名などはサンプルプロジェクトなのでデフォルトのままにしますが、本来は適切な値に変更します。

4. Spring Bootバージョン、使用する機能の選択

Spring BootのバージョンとSpring Bootプロジェクトで使用する機能を選択します。後からで「build.gradle」ファイルで設定を変える事が出来ますが、使う事が分かっている機能はここで選択しておいた方が楽なので、必要な機能を選択します。

使用するSpring Bootのバージョンと機能を選択して「次へ」を押下します。

本記事では、バージョンはデフォルトのままで、機能は以下を選択し「次へ」を押下します。

「開発ツール」⇒「Lombok」
「SQL」⇒「Spring Data JPA」
「SQL」⇒「MySQL Driver」
「テンプレート・エンジン」⇒「Thymeleaf」
「Web」⇒「Spring Web」

※Lombokはgetterとsetterを自動で生成してくれるライブラリ（getter、setterを書かなくてすむ）

5. Spring Bootプロジェクトを作成する

「完了」ボタンを押下してSpring Bootプロジェクトを作成します。

6. 作成されたSpring Bootプロジェクトの「build.gradle」の内容確認

作成されたSpring Bootプロジェクトの「build.gradle」ファイルの内容を確認してみます。先ほど選択した機能が設定されているので、今後、機能の追加や変更したい場合は「build.gradle」ファイルの内容を修正します。

※Mavenの場合は「pom.xml」

MySQLの接続設定

Spring BootプロジェクトにMySQLを使用する設定にしたので、MySQLの接続情報を設定します。※SQLを使用する設定にしていない場合は、本設定は不要です。

作成されたプロジェクトにある「application.properties」を開き、MySQLの接続情報を設定します。

■設定内容

spring.datasource.url=jdbc:mysql://localhost/sampledb
spring.datasource.username=root
spring.datasource.password=password
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

バージョンによっては、serverTimezoneを指定しないとSpring Bootプロジェクト起動時にエラーが発生するので、エラーになる場合は次のように「serverTimezone」を指定します。※今回の例ではserverTimezone=Asia/Tokyo

spring.datasource.url=jdbc:mysql://localhost/sampledb?characterEncoding=UTF-8&serverTimezone=Asia/Tokyo

■設定内容の内訳

名称	説明
url	MySQLへの接続文字列jdbc:mysql://ドメイン/データベース名
username	接続データベースへログインするユーザ名
password	接続データベースへログインするパスワード
driver-class-name	MySQLへ接続するためのドライバ名

Spring Bootプロジェクトの起動

プロジェクトを右クリックして「実行(R)」⇒「Spring Bootアプリケーション」をクリックしてSpring Bootプロジェクトを実行します。

特にエラーが出力されなければ、Spring Bootプロジェクトの実行は成功です。

※もし「spring.jpa.open-in-view is enabled by default. Therefore, database queries may be performed during view rendering. Explicitly configure spring.jpa.open-in-view to disable this warning」の警告が出力される場合は、「application.properties」に「spring.jpa.open-in-view= true」を追加して、再度Spring Bootプロジェクトの実行をしてみてください。

終わりに

本記事では「EclipseでSpring Bootの環境構築」を行う手順について紹介しました。

次回から、Spring Bootプロジェクトを使用して実際にWebアプリケーションを作成する手順を紹介します。

helpful

この記事は役に立ちましたか？

佐藤 says:
2020年4月12日 at 6:37 PM
ためになる記事ありがとうございます。
「Spring Boot+MyBatisでデータベースに接続する」お待ちしております！
返信
- 管理人 says:
  2020年5月10日 at 3:10 PM
  コメントありがとうございます。
  只今、準備中ですので、少々お待ちください。
  返信
  - 管理人 says:
    2020年6月12日 at 11:03 AM
    お待たせいたしました。「Spring Boot + MyBatisでデータベースに接続する」を作成しましたので、よろしければご覧ください。
    返信
通りすがり says:
2021年5月28日 at 11:49 AM
SpringBootの勉強で参考にさせていただいております。
2021/5現在、MySQLのバージョンが8.0.25まで上がっているのですが、最新版をインストールした場合「application.properties」の"spring.datasource.url"に指定するパラメータ"serverTimezone=JST"の部分がプロジェクト起動の際にエラーになってしまいます。
原因としては、MySQLのバージョン8.0.23からタイムゾーンに関する仕様に変更が入ったことが考えられます。
参考：https://dev.mysql.com/doc/relnotes/connector-j/8.0/en/news-8-0-23.html
パラメータの指定を以下の通り変更したことで、プロジェクト起動が正常に行えるようになりました。
spring.datasource.url=jdbc:mysql://localhost/sampledb?characterEncoding=UTF-8&connectionTimeZone=SERVER
返信
- 管理人 says:
  2021年6月26日 at 12:28 PM
  情報の提供ありがとうございました。
  返信
help says:
2021年7月8日 at 12:20 PM
ためになる記事ありがとうございます。
Error creating bean with name 'entityManagerFactory' defined in class path resource [org/springframework/boot/autoconfigure/orm/jpa/HibernateJpaConfiguration.class]: Invocation of init method failed; nested exception is org.hibernate.service.spi.ServiceException: Unable to create requested service [org.hibernate.engine.jdbc.env.spi.JdbcEnvironment
こういったエラーが出る理由はなにかわかったりしますか？
返信
- 管理人 says:
  2021年7月9日 at 4:53 PM
  コメントありがとうございます。
  「application.properties」のmysql接続文字列をserverTimezone=JSTにするとエラーになるようです。
  （※記事も修正させていただきました）
  「application.properties」の設定を以下に変更したら動作しないでしょうか？
  spring.datasource.url=jdbc:mysql://localhost/sampledb
  もしくは
  spring.datasource.url=jdbc:mysql://localhost/sampledb?characterEncoding=UTF-8&serverTimezone=Asia/Tokyo
  返信
Ligz says:
2021年9月11日 at 6:00 PM
一覧画面にID昇順にユーザー情報を表示するため、Spring Data JPAのソート順を指定する方法について調べました。共有いたします。
/**
* ユーザー情報 Repository
*/
@Repository
public interface UserRepository extends JpaRepository {
/**
* ユーザー情報 ID昇順で全検索
*
* @return 検索結果
*/
List findAllByOrderByIdAsc();
}
返信
- 管理人 says:
  2021年9月12日 at 10:52 AM
  情報の提供ありがとうございました。
  返信
リゲルソフト says:
2022年6月21日 at 1:31 PM
以下の説明に書き間違えをしまっています。
箇所：「4. Spring Bootバージョン、使用する機能の選択」
　　誤：「SQL」⇒「Spring Data JAP」
　　正：「SQL」⇒「Spring Data JPA」
返信
- リゲルソフト says:
  2022年6月21日 at 1:34 PM
  同じ箇所：
  　誤：「Web」⇒「String Web」
  　正：「Web」⇒「Spring Web」
  返信
- 管理人 says:
  2022年6月21日 at 3:16 PM
  記事誤りのご指摘非常に助かります。
  修正させていただきます。
  返信
spring初心者 says:
2022年11月27日 at 7:54 PM
記事をありがとうございます。
ところで以下のところでエラー表示が出てしまいました。
×1spring.datasource.url=jdbc:mysql://localhost/sampledb
×5spring.datasource.url=jdbc:mysql://localhost/sampledb?characterEncoding=UTF-8&serverTimezone=Asia/Tokyo
「//localhost/sampledb」のところが間違っているのではと思いますが、「【図解】MySQL Workbenchでデータベースを作成する」にしたがってデータベースも作成しています。
どこがいけないのでしょうか？
よろしくお願いいたします。
返信
- 管理人 says:
  2022年11月28日 at 7:37 AM
  コメントありがとうございます。
  どのようなエラーが表示されていますでしょうか？
  返信

comment コメントをキャンセル

2024/10/20

Spring Bootで多言語対応する方法

Spring Bootで多言語対応の手順 Spring Bootにはデフォルトで多言語の機能（i18n）がついています。その機能を利用すれば多言語化対応は簡単にできます。本記事ではSpring Bootの多言語対応の手順について紹介します。 [手順1] 多言語ファイルの作成今回は日本語と英語の多言語ファイルを作成します。 src.main.resources配下に、日本語と英語用のプロパティファイルを作成します。 ※Springのデフォルトの配置場所がsrc.main.resources配下です。 [ ...

2020/8/23

Spring Tool Suite（STS）のインストール手順 | 分かりやすく図解で説明

Spring Tool Suite（STS）のインストール手順 Spring Bootで開発するには、EclipseにSpring Tool Suite（STS）のプラグインをインストールします。本記事ではEclipseを利用してSpring Tool Suite（STS）をインストールする手順について紹介します。 1. Eclipseを起動 Eclipseを起動します。Eclipseをインストールしていない場合は、Eclipseをインストールしてください。インストール手順はこちら ⇒ Eclipseの ...

2024/5/31

Spring Boot + Thymeleafで詳細画面を作成する

はじめに前回の記事では「Spring Boot」と「Thymeleaf」を使用した一覧画面の作成方法について紹介しました。本記事では一覧画面の「詳細」ボタンを押下して、対象データを詳細画面に表示させる方法について紹介します。 [前回の記事で作成した一覧画面] [本記事で作成する詳細画面] テーブル定義今回の例で使用するテーブル定義は次のとおり。 [テーブル定義] 物理名論理名データ型NOT NULL説明idIDBIGINT〇主キー（AUTO_INCREMENT）name名前VARCHAR(100)〇 ...

2023/2/1

Spring + MyBatisで楽観ロックを実装する

はじめに MyBatisを利用した楽観ロックの方法を紹介します。 MyBatisはSpring Data JPAのようにライブラリとして楽観ロックを行う仕組みは提供していないため、独自で実装する必要があります。本記事で使用するテーブル定義は次の通りです。物理名論理名データ型 NOT NULL 説明 id ID BIGINT 〇主キー（AUTO_INCREMENT） name 名前 VARCHAR(100) 〇ユーザーの名前 update_date 更新日時 TIMESTAMP 〇楽観ロック用 ...

2024/6/15

【Spring Boot】プロパティファイルでメッセージを管理する方法

Spring Bootでメッセージをプロパティファイルで管理する方法 Javaの人気フレームワークである「Spring Boot」を使用して、プロパティファイルで値（メッセージ）を管理する方法を紹介します。 1. プロパティファイルの作成 src.main.resources配下にmessages.propertiesファイルを作成します。 ※Springのデフォルトがsrc.main.resources配下です。 [messages.properties] hello=Hello World!! 2. ...

2024/5/27

Spring Boot + Thymeleafで編集画面を作成する

はじめに Javaの人気フレームワーク「Spring Boot」と「Spring Boot」と相性の良いテンプレートエンジン「Thymeleaf」を使用して編集画面を作成し、編集画面から更新処理を行う方法を紹介します。本記事で作成する「ユーザー情報編集」画面のイメージは以下のとおり。「保存」または「キャンセル」ボタン押下で「ユーザー情報詳細」画面に戻るようにします。入力項目項目チェック内容名前必須、100桁以内住所255桁以内電話番号必須、電話番号形式各イベント処理「キャンセル」リンク押下：詳 ...

アローダイアグラムとは

クリティカルパスとは