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.
4: H2 にデータを保存して JAR をパッケージ化する
Spring Boot REST API チュートリアル、第 3 部: ファイルのアップロードとダウンロード から続行します。 インメモリマップを H2 データベースに置き換えて、再起動後も写真が残るようにしてから、アプリケーションをパッケージ化し、IntelliJ IDEA の外部で実行します。
ファイルベースの H2 データベースを構成する。構成する maybe title no period? Titles generally no full stop. Use
プロジェクトを作成したときに、H2 と Spring Data JDBC をプロジェクトの依存関係として追加しました。 H2 は Java ライブラリとして記述されたデータベースで、アプリケーション内で実行されます。 Spring Data JDBC はオブジェクトをデータベース行にマッピングし、リポジトリ操作用の SQL を提供します。
H2 はデータをメモリに保持できますが、その場合、現在のマップと同様に、シャットダウン時に写真が失われます。 代わりにファイルを参照するようにしてから、列が写真のフィールドに対応するテーブルを定義します。
application.properties で、ファイルベースのデータソースを追加し、スキーマの初期化を有効にします。
spring.datasource.url=jdbc:h2:file:~/photos-demo-db spring.sql.init.mode=alwaysjdbc:h2:file:はローカルファイルを使用するよう H2 に指示します。~はホームディレクトリを表すため、~/photos-demo-dbはそのファイルへのパスです。spring.sql.init.mode=alwaysは、起動時に schema.sql を実行するよう Spring Boot に指示します。アプリケーションを再起動して、ファイルが作成されたかどうかを確認しましょう。 Finder または Explorer でホームディレクトリを開きます。

H2 は指定した名前に
.mv.dbを追加するため、ファイルは photos-demo-db.mv.db になります。その 1 つのファイルがデータベース全体です。 コピーして Java がインストールされた別のマシンで開くことができますが、先にアプリケーションを停止するのを忘れないでください。
データベースにはまだテーブルがありません。 Spring Boot は起動時にそれらを作成でき、その方法はいくつかあります。 このチュートリアルでは、Spring が起動時に実行する 1 つの SQL ファイルを使用します。
src/main/resources で、 schema.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が画像バイトを保存します。SQL 支援を設定するには、 を開きます。
追加 をクリックし、ファイル選択でプロジェクトディレクトリを選択して、その SQL ダイアレクトを H2 に設定します。

ダイアレクトを設定すると、IntelliJ IDEA は入力中にステートメント内のエラーをハイライトします。セミコロンの不足も含まれます。
Spring Data JDBC リポジトリを作成する
スキーマは写真の保存場所を定義します。 リポジトリは、写真を読み書きする操作を Java コードに提供します。 Spring Data はモデルマッピングを使用して、 Photo とテーブル内の行との間を変換します。
service の横に repository パッケージを作成し、
PhotosRepositoryという名前の インターフェースを追加します。public interface PhotosRepository extends CrudRepository<Photo, Integer> { }CrudRepositoryは、写真の保存、検索、削除を行うメソッドを提供します。 その型パラメーターは、モデルと識別子の型を指定します。 実装クラスを記述する必要はありません。Spring がこのインターフェース用に実装を作成し、それらの操作用の SQL を提供します。Photoで、マッピングアノテーション (@Table("PHOTOS")と@Id) を追加し、識別子 (id) のフィールド、getter、setter をIntegerに変更します。 引数なしコンストラクターと他のアクセサーは変更しないでください。@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になります。
インメモリマップをリポジトリに置き換える
コントローラーはすでにサービスに写真を要求しています。 ここで、サービスが写真を取得する場所を変更します。各マップ操作はリポジトリ呼び出しになります。 リポジトリが新しい写真を保存すると、データベースがその識別子を生成し、以前にサービスが生成していた UUID を置き換えます。
PhotosServiceで、マップフィールドを削除し、リポジトリフィールドとコンストラクターを追加します。@Service public class PhotosService { private final PhotosRepository photosRepository; public PhotosService(PhotosRepository photosRepository) { this.photosRepository = photosRepository; } }Spring は、サービスをコントローラーに注入するのと同じように、リポジトリ実装を注入します。
サービスメソッドを次のリポジトリ呼び出しに置き換えます。
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 を割り当てなくなります。
コントローラーメソッドを更新する
PhotosControllerとDownloadControllerで、すべての@PathVariable String idを@PathVariable Integer idに変更します。PhotosControllerで、リストエンドポイントを更新してIterableを返すようにします。@GetMapping("/photos") public Iterable<Photo> get() { return photosService.get(); }レスポンスは JSON 配列のままです。
戻り値をチェックせずにサービスを呼び出すよう、削除エンドポイントを更新します。
@DeleteMapping("/photos/{id}") public void delete(@PathVariable Integer id) { photosService.remove(id); }存在しない写真を削除すると、リポジトリの削除操作は写真が存在したかどうかを報告しないため、404 ではなく 200 が返されるようになります。
再起動後も写真が残ることを確認する
写真のアップロードと一覧表示によって、リポジトリ呼び出しを確認できます。 再起動すると永続化チェックが追加されます。インメモリ状態がなくなった後、アプリケーションはデータベースファイルから写真を取得する必要があります。
アプリケーションを再起動し、
http://localhost:8080/upload.htmlから画像をアップロードします。 レスポンスには、データベースによって割り当てられた数値の識別子が含まれます。
アプリケーションを停止し、もう一度起動して、
http://localhost:8080/photosを開きます。 写真は、空の状態で新しいプロセスが作成したマップではなくファイル内にあるため、引き続き一覧表示されます。
http://localhost:8080/download/<id>でその識別子を使用して、保存された画像をダウンロードします。
アプリケーションを実行可能 JAR としてパッケージ化する
ここまでは、IntelliJ IDEA からアプリケーションを起動してきました。 パッケージ化すると、コード、依存関係、埋め込み Web サーバーを含む実行可能 JAR が生成されます。 互換性のある Java ランタイムを使用して IDE の外部で実行され、別のアプリケーションサーバーをインストールする必要はありません。
ポート 8080 とデータベースファイルを解放するために、IntelliJ IDEA でアプリケーションを停止します。 Maven ビルドでは同じデータベースを開くテストが実行されるため、アプリケーションを実行したままにすると、データベースファイルがロックされてビルドが失敗する可能性があります。
Maven ツールウィンドウを開き、 を展開して、 package をダブルクリックします。 ビルドが成功するまで待ちます。
IntelliJ IDEA はビルドを実行し、 実行ツールウィンドウで進捗を報告します。 ビルドが成功したことを確認する行を探します。
packageフェーズでは最初にコードをコンパイルしてテストを実行するため、テストが失敗するとここでビルドが停止します。
target ディレクトリ内の photos-demo-0.0.1-SNAPSHOT.jar を見つけます。

この実行可能 JAR を使用します。 .jar.original ファイルは、バンドルされた依存関係を含まない元のアーカイブです。
ターミナルで target ディレクトリに移動し、次を実行します。
java -jar photos-demo-0.0.1-SNAPSHOT.jarhttp://localhost:8080/photosを開きます。 アップロードした写真は引き続き一覧表示されます。このプロセスがホームディレクトリ内の同じデータベースファイルを使用しているためです。 JAR を別のマシンにコピーするとアプリケーションは転送されますが、このデータベースは転送されません。
コードを確認する
アプリケーションが期待どおりに動作しない場合は、ファイルを以下のコードと比較してください。 PhotosDemoApplication は、Spring Initializr が生成した後に変更されないため、一覧には含まれていません。
まとめと次のステップ
Spring Boot を使用して、写真共有 REST API を構築しました。 このチュートリアルの 4 つのパートを通して、次のことを行いました。
共有サービスとコンストラクター注入を使用して、写真ストレージをリクエスト処理から分離しました。
ファイルアップロードと、元のファイル名で画像を返す ダウンロードエンドポイントを追加しました。
Spring Data JDBC を使用して H2 に 写真を保存し、アプリケーションの再起動後も写真が残ることを 確認しました。
Maven で実行可能 JAR を ビルドし、IDE の外部でアプリケーションを実行しました。
プロジェクトでの作業を続けるには、 テスト駆動開発チュートリアルでテストの作成と実行方法を学び、 Git の基本チュートリアルで変更を追跡します。
Spring Boot アプリケーションの構成と拡張の詳細については、 Spring Boot ドキュメントを参照してください。