# Spring Boot REST API チュートリアル、パート 4: H2 にデータを保存して JAR をパッケージ化する。英語を日本語に翻訳する際は、日本語の見出しでは通常句点不要かもしれない。 But source title no period. Need no 。 Hmm final already period bad? Actually titles no period. Need fix. We'll output all clean. Wait final field cannot have commentary. Need regenerate. Sorry.

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

* [1: Spring Boot プロジェクトを作成して実行する](spring-boot-tutorial-create-project.html)

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

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

* [4: H2 にデータを保存して JAR をパッケージ化する]()

[Spring Boot REST API チュートリアル、第 3 部: ファイルのアップロードとダウンロード](spring-boot-tutorial-file-upload-download.html) から続行します。 インメモリマップを H2 データベースに置き換えて、再起動後も写真が残るようにしてから、アプリケーションをパッケージ化し、IntelliJ IDEA の外部で実行します。

Procedure: ファイルベースの H2 データベースを構成する。構成する maybe title no period? Titles generally no full stop. Use

プロジェクトを作成したときに、H2 と Spring Data JDBC をプロジェクトの依存関係として追加しました。 H2 は Java ライブラリとして記述されたデータベースで、アプリケーション内で実行されます。 Spring Data JDBC はオブジェクトをデータベース行にマッピングし、リポジトリ操作用の SQL を提供します。

H2 はデータをメモリに保持できますが、その場合、現在のマップと同様に、シャットダウン時に写真が失われます。 代わりにファイルを参照するようにしてから、列が写真のフィールドに対応するテーブルを定義します。

1. `application.properties`  で、ファイルベースのデータソースを追加し、スキーマの初期化を有効にします。

```PROPERTIES
spring.datasource.url=jdbc:h2:file:~/photos-demo-db
spring.sql.init.mode=always

```

`jdbc:h2:file:`  はローカルファイルを使用するよう H2 に指示します。  `~`  はホームディレクトリを表すため、  `~/photos-demo-db`  はそのファイルへのパスです。

`spring.sql.init.mode=always`  は、起動時に  `schema.sql`  を実行するよう Spring Boot に指示します。

2. アプリケーションを再起動して、ファイルが作成されたかどうかを確認しましょう。 Finder または Explorer でホームディレクトリを開きます。

![データソース URL をファイルベースのストレージに切り替えた後に H2 が作成した photos-demo-db.mv.db ファイルがある Finder のホームディレクトリ。](https://resources.jetbrains.com/help/img/idea/2026.3/sb_data_source_file.png)

H2 は指定した名前に  `.mv.db`  を追加するため、ファイルは  `photos-demo-db.mv.db`  になります。

その 1 つのファイルがデータベース全体です。 コピーして Java がインストールされた別のマシンで開くことができますが、先にアプリケーションを停止するのを忘れないでください。

3. データベースにはまだテーブルがありません。 Spring Boot は起動時にそれらを作成でき、その方法はいくつかあります。 このチュートリアルでは、Spring が起動時に実行する 1 つの SQL ファイルを使用します。

`src/main/resources`  で、  `schema.sql`  という名前の新しいファイルを作成します。

```SQL
create table if not exists photos (
    id bigint generated by default as identity primary key,
    file_name varchar(255),
    content_type varchar(255),
    data blob
);

```

列は  `Photo`  のフィールドに一致します。 データベースが識別子を生成し、  `blob`  が画像バイトを保存します。

> **Note:**
> `if not exists`  により起動を繰り返せますが、スキーマを編集しても既存のテーブルは更新されません。 このチュートリアルでテーブルを再作成するには、アプリケーションを停止し、ホームディレクトリから  `photos-demo-db.mv.db`  を削除します。 これにより、保存されているすべての写真が削除されます。

4. SQL 支援を設定するには、  `設定 | 言語 & フレームワーク | SQL ダイアレクト`  を開きます。 ![追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/schema.sql に H2 が割り当てられ、IntelliJ IDEA がスキーマ内のエラーをハイライトする SQL ダイアレクト設定。](https://resources.jetbrains.com/help/img/idea/2026.3/sb_sql_dialect.png)

ダイアレクトを設定すると、IntelliJ IDEA は入力中にステートメント内のエラーをハイライトします。セミコロンの不足も含まれます。

Procedure: Spring Data JDBC リポジトリを作成する

スキーマは写真の保存場所を定義します。 リポジトリは、写真を読み書きする操作を Java コードに提供します。 Spring Data はモデルマッピングを使用して、  `Photo`  とテーブル内の行との間を変換します。

1. `service`  の横に  `repository`  パッケージを作成し、  `PhotosRepository`  という名前の  インターフェース を追加します。

```JAVA
public interface PhotosRepository extends CrudRepository<Photo, Integer> {
}

```

`CrudRepository`  は、写真の保存、検索、削除を行うメソッドを提供します。 その型パラメーターは、モデルと識別子の型を指定します。 実装クラスを記述する必要はありません。Spring がこのインターフェース用に実装を作成し、それらの操作用の SQL を提供します。

2. `Photo`  で、マッピングアノテーション (  `@Table("PHOTOS")`  と  `@Id` ) を追加し、識別子 (  `id` ) のフィールド、getter、setter を  `Integer`  に変更します。 引数なしコンストラクターと他のアクセサーは変更しないでください。

```JAVA
@Table("PHOTOS")
public class Photo {

    @Id
    private Integer id;

    private String fileName;

    private String contentType;

    @JsonIgnore
    private byte[] data;

    public Integer getId() {
        return id;
    }

    public void setId(Integer id) {
        this.id = id;
    }

    // no-argument constructor and the other accessors unchanged

}

```

インポートには  `org.springframework.data.annotation.Id`  と  `org.springframework.data.relational.core.mapping.Table`  を使用します。

`@Table("PHOTOS")`  は H2 の大文字のテーブル名と一致し、  `@Id`  は主キーを識別します。 他のフィールドは名前でマッピングされます。  `fileName`  は  `file_name`  になり、  `contentType`  は  `content_type`  になります。

Procedure: インメモリマップをリポジトリに置き換える

コントローラーはすでにサービスに写真を要求しています。 ここで、サービスが写真を取得する場所を変更します。各マップ操作はリポジトリ呼び出しになります。 リポジトリが新しい写真を保存すると、データベースがその識別子を生成し、以前にサービスが生成していた UUID を置き換えます。

1. `PhotosService`  で、マップフィールドを削除し、リポジトリフィールドとコンストラクターを追加します。

```JAVA
@Service
public class PhotosService {

    private final PhotosRepository photosRepository;

    public PhotosService(PhotosRepository photosRepository) {
        this.photosRepository = photosRepository;
    }

}

```

Spring は、サービスをコントローラーに注入するのと同じように、リポジトリ実装を注入します。

2. サービスメソッドを次のリポジトリ呼び出しに置き換えます。

```JAVA
public Iterable<Photo> get() {
    return photosRepository.findAll();
}

public Photo get(Integer id) {
    return photosRepository.findById(id).orElse(null);
}

public void remove(Integer id) {
    photosRepository.deleteById(id);
}

public Photo save(String fileName, String contentType, byte[] data) {
    Photo photo = new Photo();
    photo.setFileName(fileName);
    photo.setContentType(contentType);
    photo.setData(data);
    return photosRepository.save(photo);
}

```

リポジトリメソッドの戻り値の型は、マップ操作とは異なります。  `findAll()`  は  `Iterable`  を返すため、サービスもその型を公開します。  `findById()`  は  `Optional`  を返し、写真を保持することも空であることもあります。  `orElse(null)`  を呼び出すことで、コントローラー内の既存の写真未検出チェックが引き続き機能します。

`deleteById()`  は何も返さないため、  `remove()`  は削除された写真を返せなくなります。 次の手順では、これらのシグネチャー変更に合わせてコントローラーを調整します。

`save()`  は、データベースで生成された識別子を持つ保存済み写真を返すため、サービスは UUID を割り当てなくなります。

Procedure: コントローラーメソッドを更新する

1. `PhotosController`  と  `DownloadController`  で、すべての  `@PathVariable String id`  を  `@PathVariable Integer id`  に変更します。

2. `PhotosController`  で、リストエンドポイントを更新して  `Iterable`  を返すようにします。

```JAVA
@GetMapping("/photos")
public Iterable<Photo> get() {
    return photosService.get();
}

```

レスポンスは JSON 配列のままです。

3. 戻り値をチェックせずにサービスを呼び出すよう、削除エンドポイントを更新します。

```JAVA
@DeleteMapping("/photos/{id}")
public void delete(@PathVariable Integer id) {
    photosService.remove(id);
}

```

存在しない写真を削除すると、リポジトリの削除操作は写真が存在したかどうかを報告しないため、404 ではなく 200 が返されるようになります。

Procedure: 再起動後も写真が残ることを確認する

写真のアップロードと一覧表示によって、リポジトリ呼び出しを確認できます。 再起動すると永続化チェックが追加されます。インメモリ状態がなくなった後、アプリケーションはデータベースファイルから写真を取得する必要があります。

1. アプリケーションを再起動し、  `http://localhost:8080/upload.html`  から画像をアップロードします。 レスポンスには、データベースによって割り当てられた数値の識別子が含まれます。

![ij.png のアップロード後に表示される JSON レスポンス付きのブラウザーアラート。id フィールドには H2 データベースによって割り当てられた識別子 1 が表示されています。](https://resources.jetbrains.com/help/img/idea/2026.3/sb_photo_with_identifier.png)

2. アプリケーションを停止し、もう一度起動して、  `http://localhost:8080/photos`  を開きます。 写真は、空の状態で新しいプロセスが作成したマップではなくファイル内にあるため、引き続き一覧表示されます。

![アプリケーションの再起動後の localhost:8080/photos からのレスポンス。データベースファイルに保存されているため、id 1 の ij.png が引き続き一覧表示されています。](https://resources.jetbrains.com/help/img/idea/2026.3/sb_photo_listed.png)

`http://localhost:8080/download/<id>`  でその識別子を使用して、保存された画像をダウンロードします。

Procedure: アプリケーションを実行可能 JAR としてパッケージ化する

ここまでは、IntelliJ IDEA からアプリケーションを起動してきました。 パッケージ化すると、コード、依存関係、埋め込み Web サーバーを含む実行可能 JAR が生成されます。 互換性のある Java ランタイムを使用して IDE の外部で実行され、別のアプリケーションサーバーをインストールする必要はありません。

1. ポート 8080 とデータベースファイルを解放するために、IntelliJ IDEA でアプリケーションを停止します。 Maven ビルドでは同じデータベースを開くテストが実行されるため、アプリケーションを実行したままにすると、データベースファイルがロックされてビルドが失敗する可能性があります。

2. [Maven](maven.html) ツールウィンドウを開き、  `photos-demo | ライフサイクル`  を展開して、   package   をダブルクリックします。 ビルドが成功するまで待ちます。

IntelliJ IDEA はビルドを実行し、 [実行](run-tool-window.html)ツールウィンドウで進捗を報告します。 ビルドが成功したことを確認する行を探します。  `package`  フェーズでは最初にコードをコンパイルしてテストを実行するため、テストが失敗するとここでビルドが停止します。

![photos-demo package Maven ゴールが完了し、BUILD SUCCESS 行で JAR がビルドされたことを確認できる実行ツールウィンドウ。](https://resources.jetbrains.com/help/img/idea/2026.3/sb_maven_package.png)

3. `target`  ディレクトリ内の  `photos-demo-0.0.1-SNAPSHOT.jar`  を見つけます。

![Maven package の実行後に、target ディレクトリ内の photos-demo-0.0.1-SNAPSHOT.jar とその .jar.original ファイルを表示しているプロジェクトツールウィンドウ。](https://resources.jetbrains.com/help/img/idea/2026.3/sb_target_jar.png)

この実行可能 JAR を使用します。  `.jar.original`  ファイルは、バンドルされた依存関係を含まない元のアーカイブです。

4. ターミナルで  `target`  ディレクトリに移動し、次を実行します。

```BASH
java -jar photos-demo-0.0.1-SNAPSHOT.jar

```

5. `http://localhost:8080/photos`  を開きます。 アップロードした写真は引き続き一覧表示されます。このプロセスがホームディレクトリ内の同じデータベースファイルを使用しているためです。 JAR を別のマシンにコピーするとアプリケーションは転送されますが、このデータベースは転送されません。

## コードを確認する

アプリケーションが期待どおりに動作しない場合は、ファイルを以下のコードと比較してください。  `PhotosDemoApplication`  は、Spring Initializr が生成した後に変更されないため、一覧には含まれていません。

```JAVA
package com.jetbrains.photos.demo.model;

import com.fasterxml.jackson.annotation.JsonIgnore;
import org.springframework.data.annotation.Id;
import org.springframework.data.relational.core.mapping.Table;

@Table("PHOTOS")
public class Photo {

    @Id
    private Integer id;

    private String fileName;

    private String contentType;

    @JsonIgnore
    private byte[] data;

    public Photo() {
    }

    public Integer getId() {
        return id;
    }

    public void setId(Integer id) {
        this.id = id;
    }

    public String getFileName() {
        return fileName;
    }

    public void setFileName(String fileName) {
        this.fileName = fileName;
    }

    public String getContentType() {
        return contentType;
    }

    public void setContentType(String contentType) {
        this.contentType = contentType;
    }

    public byte[] getData() {
        return data;
    }

    public void setData(byte[] data) {
        this.data = data;
    }

}

```

```JAVA
package com.jetbrains.photos.demo.repository;

import com.jetbrains.photos.demo.model.Photo;
import org.springframework.data.repository.CrudRepository;

public interface PhotosRepository extends CrudRepository<Photo, Integer> {
}

```

```JAVA
package com.jetbrains.photos.demo.service;

import com.jetbrains.photos.demo.model.Photo;
import com.jetbrains.photos.demo.repository.PhotosRepository;
import org.springframework.stereotype.Service;

@Service
public class PhotosService {

    private final PhotosRepository photosRepository;

    public PhotosService(PhotosRepository photosRepository) {
        this.photosRepository = photosRepository;
    }

    public Iterable<Photo> get() {
        return photosRepository.findAll();
    }

    public Photo get(Integer id) {
        return photosRepository.findById(id).orElse(null);
    }

    public void remove(Integer id) {
        photosRepository.deleteById(id);
    }

    public Photo save(String fileName, String contentType, byte[] data) {
        Photo photo = new Photo();
        photo.setFileName(fileName);
        photo.setContentType(contentType);
        photo.setData(data);
        return photosRepository.save(photo);
    }

}

```

```JAVA
package com.jetbrains.photos.demo.web;

import com.jetbrains.photos.demo.model.Photo;
import com.jetbrains.photos.demo.service.PhotosService;
import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.DeleteMapping;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestPart;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;
import org.springframework.web.server.ResponseStatusException;

import java.io.IOException;

@RestController
public class PhotosController {

    private final PhotosService photosService;

    public PhotosController(PhotosService photosService) {
        this.photosService = photosService;
    }

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

    @GetMapping("/photos")
    public Iterable<Photo> get() {
        return photosService.get();
    }

    @GetMapping("/photos/{id}")
    public Photo get(@PathVariable Integer id) {
        Photo photo = photosService.get(id);
        if (photo == null) {
            throw new ResponseStatusException(HttpStatus.NOT_FOUND);
        }
        return photo;
    }

    @DeleteMapping("/photos/{id}")
    public void delete(@PathVariable Integer id) {
        photosService.remove(id);
    }

    @PostMapping("/photos")
    public Photo create(@RequestPart("data") MultipartFile file) throws IOException {
        return photosService.save(file.getOriginalFilename(), file.getContentType(), file.getBytes());
    }

}

```

```JAVA
package com.jetbrains.photos.demo.web;

import com.jetbrains.photos.demo.model.Photo;
import com.jetbrains.photos.demo.service.PhotosService;
import org.springframework.http.ContentDisposition;
import org.springframework.http.HttpHeaders;
import org.springframework.http.HttpStatus;
import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.server.ResponseStatusException;

@RestController
public class DownloadController {

    private final PhotosService photosService;

    public DownloadController(PhotosService photosService) {
        this.photosService = photosService;
    }

    @GetMapping("/download/{id}")
    public ResponseEntity<byte[]> download(@PathVariable Integer id) {
        Photo photo = photosService.get(id);
        if (photo == null) {
            throw new ResponseStatusException(HttpStatus.NOT_FOUND);
        }

        HttpHeaders headers = new HttpHeaders();
        headers.setContentType(MediaType.valueOf(photo.getContentType()));
        headers.setContentDisposition(
                ContentDisposition.builder("attachment")
                        .filename(photo.getFileName())
                        .build());

        return new ResponseEntity<>(photo.getData(), headers, HttpStatus.OK);
    }

}

```

```PROPERTIES
spring.application.name=photos-demo
spring.servlet.multipart.max-file-size=100MB
spring.servlet.multipart.max-request-size=100MB
spring.datasource.url=jdbc:h2:file:~/photos-demo-db
spring.sql.init.mode=always

```

```SQL
create table if not exists photos (
    id bigint generated by default as identity primary key,
    file_name varchar(255),
    content_type varchar(255),
    data blob
);

```

```HTML
<!DOCTYPE html>
<html lang="en">
<head><link rel="canonical" href="https://www.jetbrains.com/ja-jp/help/idea/spring-boot-tutorial-h2-database-jar.html.md/" data-react-helmet="true"/>
    <meta charset="UTF-8">
    <title>Photo Upload</title>
</head>
<body>

<h2>Photo Upload</h2>

<input id="fileupload" type="file" name="fileupload"/>
<button id="upload-button" onclick="uploadFile()">Upload</button>

<script>
    async function uploadFile() {
        let formData = new FormData();
        formData.append("data", fileupload.files[0]);
        await fetch("http://localhost:8080/photos", {
            method: "POST",
            body: formData
        }).then(result => result.text())
            .then(text => alert(text));
    }
</script>
</body>
</html>

```

## まとめと次のステップ

Spring Boot を使用して、写真共有 REST API を構築しました。 このチュートリアルの 4 つのパートを通して、次のことを行いました。

* IntelliJ IDEA で Spring Boot プロジェクトを [作成](spring-boot-tutorial-create-project.html#create-project)して [実行](spring-boot-tutorial-create-project.html#first-run)しました。

* 写真を [一覧表示](spring-boot-tutorial-rest-endpoints.html#return-all-photos)、 [取得](spring-boot-tutorial-rest-endpoints.html#return-one-photo)、 [削除](spring-boot-tutorial-rest-endpoints.html#delete-photo)する REST エンドポイントを追加しました。

* [共有サービスとコンストラクター注入](spring-boot-tutorial-rest-endpoints.html#create-service)を使用して、写真ストレージをリクエスト処理から分離しました。

* [ファイルアップロード](spring-boot-tutorial-file-upload-download.html#receive-file)と、元のファイル名で画像を返す [ダウンロードエンドポイント](spring-boot-tutorial-file-upload-download.html#serve-image)を追加しました。

* Spring Data JDBC を使用して H2 に [写真を保存](#rewrite-service)し、アプリケーションの再起動後も写真が残ることを [確認](#check-round-trip)しました。

* Maven で実行可能 JAR を [ビルド](#build-jar)し、IDE の外部でアプリケーションを実行しました。

プロジェクトでの作業を続けるには、 [テスト駆動開発チュートリアル](tdd-with-intellij-idea.html)でテストの作成と実行方法を学び、 [Git の基本チュートリアル](working-with-git-tutorial.html)で変更を追跡します。

Spring Boot アプリケーションの構成と拡張の詳細については、 [Spring Boot ドキュメント](https://docs.spring.io/spring-boot/index.html)を参照してください。

