# Spring Boot REST API チュートリアル、パート 1: プロジェクトの作成と実行

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/idea/llms.txt).

* [1: Spring Boot プロジェクトを作成して実行する]()

* [2: REST エンドポイントを追加する](spring-boot-tutorial-rest-endpoints.html)

* [3: ファイルをアップロードおよびダウンロードする](spring-boot-tutorial-file-upload-download.html)

* [4: H2 にデータを保存して JAR をパッケージ化する](spring-boot-tutorial-h2-database-jar.html)

このチュートリアルの最初のパートでは、Spring Boot プロジェクトを生成し、パッケージを整理して、ブラウザーリクエストに応答するコントローラーを追加します。

Procedure: Spring Initializr でプロジェクトを作成する

Spring プロジェクトは [Spring Initializr](https://start.spring.io/) によって生成されます。 ウェブサイトを使用することもできますが、IntelliJ IDEA には同じジェネレーターが   新規プロジェクト   ウィザードに組み込まれているため、アーカイブのダウンロードとアンパックの手間を省けます。

1. ホーム画面で   新規プロジェクト   をクリックします。 別のプロジェクトがすでに開いている場合は、メインメニューの  `ファイル | 新規 | プロジェクト`  に移動します。

2. ジェネレーター   リストから   Spring Boot   を選択します。

3. プロジェクトのお名前を  `photos-demo`  にし、   Java   を   言語   として選択します。

4. Maven   を   タイプ   として選択してください。

Maven と Gradle はどちらも使用できます。 すでにどちらかを使用している場合は、そのまま使用してください。 初めて選ぶ場合、Maven はプロジェクトをビルドする前に学ぶことが少なくて済むため、このチュートリアルでは Maven を使用します。

5. プロジェクトを識別する座標を入力します。

グループ   は、コードを所有する組織のお名前を指定します。通常はドメイン名を逆順で記述します。 このチュートリアルでは  `com.jetbrains`  を使用します。自分のプロジェクトでは、会社または個人のドメインを使用してください。

アーティファクト   は、そのグループ内のこの単一のプロジェクトを識別します。  `photos-demo`  と入力します。 グループと合わせて、別のプロジェクトが対象のプロジェクトに依存するときにビルドツールが解決する対象になります。

パッケージ名   は Java ソースのルートパッケージであり、IntelliJ IDEA は上記の両方のフィールドから候補を作成します。  `com.jetbrains.photos.demo`  に設定します。 このチュートリアルで作成するすべてのクラスは、このパッケージまたはその配下に配置されます。これは後で重要になります。Spring はアプリケーションクラスを含むパッケージとそのサブパッケージをスキャンし、その外側は検出しません。

6. JDK    リストから JDK を選択し、次に   Java   リストから同じバージョンを選択します。 古いリリースを使い続ける理由がない限り、利用可能な最新のものを使用してください。

JDK がインストールされているのに IntelliJ IDEA に表示されない場合は、   JDK を追加   を選択し、そのホームディレクトリを指定します。 何もインストールされていない場合は、   JDK のダウンロード   を選択します。

7. Jar   をパッケージングタイプとして選択したままにし、残りのフィールドはデフォルトのままにします。   次へ   をクリックします。

次の依存関係を選択します:

* Spring ウェブ : HTTP リクエストの処理、JSON 変換、組み込みウェブサーバー。

* Spring Data JDBC : 最後のパートで Java オブジェクトをデータベースの行にマッピングします。

* H2 データベース : 別途インストールしなくてもアプリケーションと一緒に実行されるデータベース。

作成   をクリックし、IntelliJ IDEA がプロジェクトを生成してインポートするまで待ちます。

Procedure: パッケージ構造を設定する

生成されたプロジェクトには、Maven 依存関係用の  `pom.xml` 、Java コード用の  `src/main/java` 、  `application.properties`  と静的ファイル用の  `src/main/resources`  が含まれています。

ジェネレーターはアプリケーションクラスを単一のパッケージに配置します。 さらにクラスを追加する前に、それぞれの役割に応じたサブパッケージを作成し、新しい各クラスをプロジェクト内に配置できるようにします。

* [プロジェクト](project-tool-window.html)ツールウィンドウで、アプリケーションクラスを含むパッケージを右クリックし(このチュートリアルでは  `com.jetbrains.photos.demo` )、  `新規 | パッケージ`  を選択します。

三つのサブパッケージを作成します:

* `web` : HTTP リクエストを処理するコントローラー。

* `service` : アプリケーションロジックと写真ストレージ。

* `model` : 写真データを表すクラス。

![PhotosDemoApplication クラスの横にある com.jetbrains.photos.demo 配下の model、service、ウェブのサブパッケージを含むプロジェクトツールウィンドウ。](https://resources.jetbrains.com/help/img/idea/2026.3/sb_packages.png)

`PhotosDemoApplication`  はルートパッケージに保持します。 Spring はそのパッケージとサブパッケージをスキャンして、追加したコントローラーとサービスを見つけます。

Procedure: REST コントローラーを作成する

REST コントローラーは、受信した HTTP リクエストを Java メソッドに接続します。 まず挨拶を返すメソッドから始めます。ブラウザーで確認することで、写真 API を追加する前にリクエストがコードに到達していることを確認できます。

1. `web`  パッケージを右クリックし、  `新規 | Java クラス`  を選択します。 クラスのお名前を  `PhotosController`  にします。

2. 以下に示す挨拶メソッドとアノテーションを追加します。  `@RestController`  と  `@GetMapping`  を入力するときに、補完リストから選択してインポートを追加します。 リストが表示されない場合は、 `Ctrl+Space` (Windows), `⌃ Space` (macOS), `⌃ Space` (IntelliJ IDEA Classic (macOS)), `⌃ Space` (macOS System Shortcuts), `Ctrl+Space` (XWin), `Ctrl+Space` (GNOME), `Ctrl+Space` (KDE), `Alt+/` (Emacs), `Ctrl+Space` (Sublime Text), `⌃ Space` (Sublime Text (macOS)), `Ctrl+Space` (Visual Studio), `⌃ Space` (Visual Studio (macOS)), `Ctrl+Space` (NetBeans), `Ctrl+Space` (Eclipse), `⌃ Space` (Eclipse (macOS)) を押します。

```JAVA
@RestController
public class PhotosController {

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

}

```

両方のアノテーションで作業を分担します。  `@RestController`  は、このクラスがリクエストを処理することを Spring に伝えるため、Spring は始動時にインスタンスを作成します。  `@GetMapping("/")`  は  `/`  への GET リクエストを  `hello()`  にマッピングします。 返された文字列は、ブラウザーに表示されるレスポンス本文になります。

> **Tip:**
> エディターを離れずにアノテーションの Javadoc を読むには、アノテーションにマウスを合わせるか、 [ドキュメント](documentation-tool-window.html)ツールウィンドウを使用します。

Procedure: Spring Boot アプリケーションを実行する

1. `PhotosDemoApplication`  を開き、  `main()`  の横のガターで ![実行ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.gutter.run.svg)   実行   をクリックするか、 `Shift+F10` (Windows), `⌃ R` (macOS), `⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌥ ⇧ R` (macOS System Shortcuts), `Shift+F10` (XWin), `Shift+F10` (GNOME), `Shift+F10` (KDE), `Shift+F10` (Emacs), `Shift+F10` (Sublime Text), `Shift+F10` (Sublime Text (macOS)), `Ctrl+F5` (Visual Studio), `⌃ F5` (Visual Studio (macOS)), `F6` (NetBeans), `Alt+Shift+X` (Eclipse), `⌘ ⇧ F11` (Eclipse (macOS)) を押します。

2. [実行](run-tool-window.html)ツールウィンドウで、Tomcat がポート 8080 で起動したことを示すメッセージを探します。

![Tomcat が初期化され、ポート 8080 で起動したことを確認できるコンソールログを表示した PhotosDemoApplication の実行ツールウィンドウ。](https://resources.jetbrains.com/help/img/idea/2026.3/sb_tomcat_8080.png)

ブラウザーで  `http://localhost:8080/`  を開きます。 ページに  `Hello World`  が表示されます。

[次のパート](spring-boot-tutorial-rest-endpoints.html)

