Spring BootでHello Worldを実現する完全手順

Spring Bootは、JavaでWebアプリやAPIを開発するためのフレームワークです。この記事では、初心者でも理解できるように、環境構築からプロジェクト作成、Controllerの実装、アプリケーションの起動、よくあるエラーの解決までを、一歩一歩解説します。

Spring Bootは、JavaのWebアプリケーションやREST APIを開発するためのフレームワークであり、従来のJava Web開発に比べて手軽に始められるよう設計されています。特に、「Hello World」を実装するという非常にシンプルな例から始めることが、多くの学習者にとって効果的です。「Hello World」は、アプリケーションが正しく動作しているかを確認するための基本的なチェックポイントであり、Spring Bootでは組み込みTomcatサーバーと自動設定機能により、最小限のコードで即座に起動できます。

Spring Bootとは？なぜ「Hello World」から始めるのか

Spring Bootは、JavaでWebアプリやAPIを開発するためのフレームワークです。従来のJava Web開発では、サーバーの設定やXMLの構成など、多くの手間がかかることがありました。しかし、Spring Bootでは、組み込みTomcatサーバーが含まれており、最小限の設定でアプリケーションを起動できます。

また、「スターター」という構成により、必要なライブラリや依存関係を自動的に設定します。これにより、環境構築の負担が大幅に軽減され、初心者でも手軽にSpring Bootを始めることが可能になります。「Hello World」の実装は、Spring Bootの基本的な動作を理解するための最適なステップです。その理由は、プロジェクト構造やControllerの役割、mainメソッドの処理など、すべてを一貫して確認できるからです。

開発環境の準備（JDKとIDE）

Spring BootでHello Worldを動かすには、基本的な開発環境を整える必要があります。主に必要なものは以下の3つです：

• JDK（Java Development Kit）：JDK 17以上が推奨されます。
• IDE（Integrated Development Environment）：IntelliJ IDEA Community版が初心者向けに適しています。
• インターネット接続：初回の依存関係ダウンロードに必要です。

JDKはOracleの公式ダウンロードページから入手可能です。一方、IntelliJ IDEAは公式サイトで無料でダウンロードできます。JDKは17でも問題なく使用できますが、最新のLTSであるJDK 21を選択することで、長期的なサポートを受けられます。

Spring Bootプロジェクトの作成（Spring Initializr）

Spring Bootプロジェクトの作成には、Spring Initializrという公式のプロジェクト生成ツールが最適です。このツールを使うことで、アプリケーションの構造や必要な依存関係を簡単に設定できます。

Spring Initializrにアクセスして、以下の設定を行います：

• Project：Maven Project
• Language：Java
• Spring Boot：最新安定版
• Packaging：Jar
• Java：17
• Dependencies：Spring Webを追加

設定が完了したら、「Generate」をクリックしてZIPファイルをダウンロードし、解凍してIDEで開きます。これで、Spring Bootのプロジェクト構造が完成し、Hello Worldアプリケーションの土台が出来上がります。

Hello Worldを返すControllerの実装

次に、ブラウザに「Hello World」を返すControllerを作成します。Spring Bootのプロジェクト構造に従って、src/main/java配下のパッケージ（例：com.example.demo）にHelloControllerというクラスを作成します。その中で、以下のコードを記述します：

package com.example.demo;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController {

    @GetMapping("/")
    public String hello() {
        return "Hello World";
    }
}

このコードのポイントは以下の通りです：

• @RestController：HTTPレスポンスとして文字列を返すためのアノテーション
• @GetMapping("/")：/（ルートパス）へのGETリクエストをhelloメソッドにマッピング
• return "Hello World"：文字列をそのままブラウザに返す

Controllersは、アプリケーションのエンドポイントを定義する役割を持ち、REST APIの実装に不可欠です。@RestControllerは、HTMLテンプレートを返す場合は@Controllerを使用します。

mainメソッドでSpring Bootアプリケーションを起動する

Spring Initializrで生成されたプロジェクトには、アプリケーションのエントリーポイントとなるmainメソッドが含まれています。通常はDemoApplication（名前はプロジェクトによって異なる場合があります）というクラスです。その中には、Spring Bootの起動処理が含まれており、以下のようなコードがあります：

package com.example.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class DemoApplication {

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

}

このmainメソッドを実行すると、組み込みTomcatサーバーが起動し、Spring Bootアプリケーションとして動作します。組み込みTomcatは、外部のWebサーバー設定を必要とせず、すぐに起動できるよう設計されています。

アプリケーションの起動と確認

IDEからDemoApplicationの実行ボタン（▶）をクリックして、アプリケーションを起動します。コンソールに次のようなログが表示されれば、アプリケーションが正常に起動していることを確認できます：

Tomcat started on port(s): 8080 (http)
Started DemoApplication in 5 seconds

この時点で、Spring Bootの基本的な動作が確認できました。次に、ブラウザを開き、以下にアクセスします：

http://localhost:8080/

画面に「Hello World」が表示されたら、プロジェクトの作成とControllerの実装が成功したことを確認できます。

よくあるエラーと対処法

Spring Bootの初期学習では、以下のようなよくあるエラーに遭遇する場合があります。

1. 既にポートが使用されています（Port 8080 is already in use）

8080番ポートが他のアプリケーションで使用されている場合、Spring Bootの起動時にエラーとなります。この場合、application.propertiesに以下を追加することで、別のポートで起動させられます：

server.port=8081

これにより、http://localhost:8081/でアプリケーションを確認できます。

2. 404 Not Found が返ってくる

404 Not Foundエラーが発生した場合、以下の点を確認してください：

• @RestControllerがクラスに正しく適用されているか
• @GetMapping("/")のパスが正しいか
• Controllerクラスが@SpringBootApplicationと同じパッケージ配下にあるか

これらが正しい場合、エラーの原因は起動のタイミングやルートパスの設定にある可能性があります。

3. 日本語が文字化けする

Spring Boot 2.x以降ではUTF-8がデフォルトの文字コードとして設定されています。そのため、通常は日本語の文字化けが起こらないのが特徴です。それでも、文字化けが発生した場合は、application.propertiesに以下を追加することで、文字コードを明示的にUTF-8に設定できます：

spring.messages.encoding=UTF-8

日本語を返す場合は、以下のように記述します：

@GetMapping("/hello")
public String helloJa() {
    return "こんにちは Spring Boot！";
}

このように記述すれば、日本語が正しく表示されるはずです。

よくある質問（FAQ：springboot helloworld）

Q1. Javaの経験がほとんどなくても springboot はできますか？

はい、できます。クラス、メソッド、文字列の基本がわかれば、Spring Bootも比較的簡単に理解できます。

Q2. helloworld の次に何を学べばいいですか？

「Hello World」が成功した後、以下のステップをおすすめします：

• 複数のパスを作る（/hello や /users など）
• パラメータを受け取る（@RequestParam や @PathVariable）
• JSONを返すAPIを作る（オブジェクトを返却）
• DB（MySQLやPostgreSQL）と接続してデータを保存・取得する

Q3. @Controller と @RestController のどちらを使うべきですか？

「Hello World」では@RestControllerを使うのが楽です。HTMLテンプレートを返す場合は@Controllerを使うのが適切です。

Q4. MavenとGradleのどちらを選べばいいですか？

初心者であれば、Mavenを選び、安心して学習を進めるのがおすすめです。

Q5. Spring Initializrは無料ですか？

はい、無料で利用できます。公式サイトはこちら： https://start.spring.io/

Q6. WindowsとMacで手順は違いますか？

基本的な手順は同じです。JDKとIDEが動けば、OSの違いに左右されません。

参考リンク（公式・信頼性の高い情報）

以下に、Spring Bootに関する信頼性の高い情報源を紹介します：

• Spring Boot 公式サイト： https://spring.io/projects/spring-boot

• Spring Boot 公式ドキュメント： https://docs.spring.io/spring-boot/docs/current/reference/htmlsingle/

• Oracle Java SE 17 公式ダウンロード： https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html

• Maven 公式ガイド： https://maven.apache.org/guides/

• IntelliJ IDEA 公式サイト： https://www.jetbrains.com/idea/

これらのリンクから、Spring Bootの学習や実装に関する詳しい情報を入手できます。

関連記事

Spring BootのController設計を理解したい場合は、以下を参考にしてください：

• Spring BootのController徹底解説｜springboot controller入門

この記事では、Controllerの基本的な設計やREST APIの実装方法について解説しています。「Hello World」の実装が成功した後は、Controllerの実装スキルを高めるためにもこの記事は役立ちます。

まとめ：springboot helloworldは「最初の一歩」

この記事では、Spring Bootで「Hello World」を表示するまでの手順を詳しく解説しました。その手順は以下の通りです：

• Spring Initializrでプロジェクトを作成
• @RestControllerと@GetMappingでControllerを実装
• mainメソッドからアプリケーションを起動
• ブラウザで http://localhost:8080/ を確認

「Hello World」が表示されれば、Spring Bootの基本的な動作が確認でき、Webエンジニアとしての最初の一歩を踏み出せます。このステップをクリアした後は、REST APIの実装やDB連携、認証、エラーハンドリングなどの実務に近いテーマへと進むことができます。

キーワード

Spring Boot, Hello World, Controller, @RestController, @GetMapping, mainメソッド, サーバー起動, application.properties, ポート設定, 文字化け対処, FAQ, 環境構築, JDK, IDE