新人と先輩の会話形式で理解しよう

新人

「先輩、Spring MVCでデータベースと連携する時に@Entityや@Id、@GeneratedValueってよく見かけるんですが、どういうものなんですか？」

先輩

「それらはJPAでデータベース操作を簡単にするためのアノテーションだよ。エンティティを定義して、主キーを指定し、自動採番を設定することでデータ操作がスムーズになるんだ。」

新人

「なるほど！でも具体的にどうやって使うんですか？」

先輩

「それじゃあ、基本的な使い方を実例で一緒に見ていこう！」

1. @Entityとは？

@Entityは、Javaのクラスがデータベースのテーブルと対応することを示すアノテーションです。このアノテーションを付けることで、JPAがそのクラスをエンティティとして認識し、データベース操作が可能になります。


package com.example.demo.entity;

import jakarta.persistence.Entity;
import jakarta.persistence.Table;

@Entity
@Table(name = "products")
public class Product {
    private Long id;
    private String name;
    private double price;
}

上記の例では、Productクラスがproductsテーブルに対応します。@Tableでテーブル名を明示的に指定しています。

2. @Idとは？

@Idは、エンティティの主キー（Primary Key）を示すアノテーションです。データベースでレコードを一意に識別するために必要です。


import jakarta.persistence.Id;

@Entity
public class Product {
    @Id
    private Long id;
    private String name;
    private double price;
}

このように、idフィールドに@Idを付けることで、Productテーブルの主キーとして認識されます。

3. @GeneratedValueとは？

@GeneratedValueは、主キーの値を自動的に生成するためのアノテーションです。これを使用すると、手動でIDを設定せずにデータベースが自動的に番号を付与します。


import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;

@Entity
public class Product {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;
    private double price;
}

@GeneratedValueにはいくつかの生成戦略がありますが、GenerationType.IDENTITYはデータベースの自動インクリメント機能を利用します。

4. エンティティクラスの作成手順（実際のコード例を含めて解説）

ここでは、@Entity、@Id、@GeneratedValueを使ったエンティティクラスの作成手順を解説します。エンティティは、データベースのテーブルに対応するJavaクラスであり、JPAを用いることで簡単にデータベース操作が可能になります。

4.1 プロジェクトの準備

まず、pleiadesを使用してSpring Bootプロジェクトを作成し、Gradleの依存関係にJPAとデータベース接続用ライブラリを追加します。依存関係は、pleiadesのチェックボックスで追加可能です。


dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
    implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'
    runtimeOnly 'com.h2database:h2' // 開発用データベース
}

4.2 エンティティクラスの作成

次に、Productエンティティクラスを作成します。これはデータベースのproductsテーブルとマッピングされます。


package com.example.demo.entity;

import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;
import jakarta.persistence.Column;
import jakarta.persistence.Table;

@Entity
@Table(name = "products")
public class Product {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(nullable = false, length = 100)
    private String name;

    @Column(nullable = false)
    private double price;

    // ゲッターとセッター
    public Long getId() { return id; }
    public void setId(Long id) { this.id = id; }

    public String getName() { return name; }
    public void setName(String name) { this.name = name; }

    public double getPrice() { return price; }
    public void setPrice(double price) { this.price = price; }
}

このコードでは、@Entityでエンティティとして定義し、@Tableでテーブル名を指定しています。@Idで主キーを示し、@GeneratedValueでIDの自動採番を有効にしています。

5. @Entity, @Id, @GeneratedValueの組み合わせ使用例

実際に、エンティティを使ってデータベースに情報を保存する処理を見てみましょう。ここでは、ProductServiceを作成して商品情報を保存します。


package com.example.demo.service;

import com.example.demo.entity.Product;
import com.example.demo.repository.ProductRepository;
import org.springframework.stereotype.Service;
import org.springframework.beans.factory.annotation.Autowired;

@Service
public class ProductService {

    @Autowired
    private ProductRepository productRepository;

    public void saveProduct(String name, double price) {
        Product product = new Product();
        product.setName(name);
        product.setPrice(price);
        productRepository.save(product); // 自動的にIDが付与されて保存されます
    }
}

ProductRepositoryは、Spring Data JPAが提供するインターフェースを継承することで、SQLを書くことなくデータ操作が可能です。


package com.example.demo.repository;

import com.example.demo.entity.Product;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.stereotype.Repository;

@Repository
public interface ProductRepository extends JpaRepository<Product, Long> {
}

このコードでは、商品情報を保存する際に@GeneratedValueにより自動でIDが生成されます。SQLの手書きが不要で、データベース操作が大幅に簡単になります。

6. エンティティとデータベースのマッピング関係

エンティティとデータベースの関係は、フィールドと列（カラム）が1対1で対応しています。上記のProductクラスは次のようなテーブルにマッピングされます。


CREATE TABLE products (
    id BIGINT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(100) NOT NULL,
    price DOUBLE NOT NULL
);

エンティティクラスで指定したアノテーションに基づき、データベース上で制約や型が自動生成されます。たとえば、@Column(nullable = false)はNOT NULL制約を付けます。

実行結果

実際に商品情報を保存した場合、データベースに次のようなレコードが挿入されます。


id | name         | price
---+--------------+-------
1  | ノートパソコン | 120000
2  | マウス         | 2500

このように、JPAのアノテーションを使用することで、Javaコードを通じてデータベース操作がスムーズに行えます。

7. 実際にエンティティを使ったデータ操作（作成・保存・検索）

ここでは、@Entity、@Id、@GeneratedValueを使った実際のデータ操作（作成・保存・検索）の手順を解説します。Spring MVCとJPAを使えば、SQLを書かずにデータベース操作が簡単に行えます。

7.1 データの作成と保存

まずは、エンティティを作成し、データベースに保存する処理を見てみましょう。以下のコードは、ProductControllerで商品情報を保存する例です。


package com.example.demo.controller;

import com.example.demo.service.ProductService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;

@Controller
public class ProductController {

    @Autowired
    private ProductService productService;

    @GetMapping("/saveProduct")
    public String saveProduct(@RequestParam String name, @RequestParam double price) {
        productService.saveProduct(name, price);
        return "product-saved"; // product-saved.htmlが表示されます
    }
}

上記のコードでは、/saveProductにアクセスすると、指定した名前と価格の商品がデータベースに保存されます。

実行結果


http://localhost:8080/saveProduct?name=キーボード&price=4500


id | name       | price
---+------------+------
1  | キーボード   | 4500.0

このように、ブラウザからURLにアクセスするだけで商品情報がデータベースに保存されます。

7.2 データの検索

次に、保存したデータを検索して表示する方法を見ていきましょう。ProductServiceに検索メソッドを追加します。


public Product findProductById(Long id) {
    return productRepository.findById(id).orElse(null);
}

コントローラ側での呼び出し例:


@GetMapping("/findProduct")
public String findProduct(@RequestParam Long id) {
    Product product = productService.findProductById(id);
    System.out.println("商品名: " + product.getName() + ", 価格: " + product.getPrice());
    return "product-found"; // product-found.htmlが表示されます
}

実行結果


http://localhost:8080/findProduct?id=1


商品名: キーボード, 価格: 4500.0

上記のように、指定したIDの商品情報が取得されます。

8. よくあるエンティティ関連のエラーとその解決方法

エンティティを使用する際、初心者がつまずきやすいエラーについて紹介し、その解決方法を解説します。

8.1 エラー1: "No identifier specified for entity"

原因: エンティティに@Idアノテーションが付いていない場合に発生します。


@Entity
public class Product {
    private Long id; // @Id が抜けているためエラーになります
}

解決方法: @Idを忘れずに追加しましょう。


@Id
private Long id;

8.2 エラー2: "Could not determine recommended JdbcType"

原因: フィールドに対応するデータ型が適切でない場合に発生します。


@Column(nullable = false)
private Object invalidField; // 不適切な型

解決方法: 適切な型に変更します。


@Column(nullable = false)
private String validField;

8.3 エラー3: "Table not found"

原因: テーブルが自動生成されていない、またはデータベースが正しく設定されていない場合に発生します。

解決方法: application.propertiesに以下を追加してください。


spring.jpa.hibernate.ddl-auto=update
spring.datasource.url=jdbc:h2:mem:testdb
spring.datasource.driver-class-name=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=

9. 実践アドバイス

この記事では、@Entity、@Id、@GeneratedValueの基本的な使い方とエンティティを利用したデータ操作について解説しました。これらのアノテーションを理解し、正しく使うことで、データベース操作が非常に簡単になります。

@Entity: クラスがデータベースのテーブルと対応することを示す。
@Id: 主キーを示し、データの一意性を保証する。
@GeneratedValue: 主キーの自動採番を行い、手動でのID指定を省略できる。
エンティティとリポジトリを組み合わせることで、SQLなしで簡単にデータ操作が可能。

実践アドバイス: 最初はエンティティの作成から始め、簡単な保存・検索機能を実装することで理解が深まります。また、エラーが発生した場合は、アノテーションの付け忘れや設定ミスがないか確認しましょう。

まとめ

ここまでの流れを振り返ると、@Entity、@Id、@GeneratedValueという三つのアノテーションは、Spring Boot と JPA を使った開発において欠かせない基礎であり、エンティティの振る舞いを理解するうえでとても重要な役割を果たしています。エンティティを介してデータベースとアプリケーションが自然につながることで、複雑なデータ操作を意識せずとも扱えるようになり、ビジネスロジックに集中しやすくなるという大きなメリットがあります。フィールドにアノテーションを正しく付けることで、データの一意性、整合性、自動採番、テーブルとのマッピングなど、さまざまな処理が自動で補われ、余計なエラーも避けられるようになります。また、今回の例では Product エンティティを中心に解説しましたが、実際の業務システムでは商品だけでなく、会員、注文、在庫、履歴など多くのエンティティが登場します。それぞれがどのような制約を持ち、どのデータと紐づくのか、どのように自動採番されるべきかなど、エンティティの設計一つでシステム全体の整合性や処理速度に影響が出ることもあります。そのため、アノテーションの意味を丁寧に理解しつつ、必要な情報を整理してクラスを設計することが、これからの開発で非常に大きな力になります。さらに、@GeneratedValueにおける採番戦略の違いや、@Columnを使った制約設定なども合わせて覚えておくと、トラブルが起きたときに原因をすぐに推測できるようになります。例えば、テーブルの主キーが重複してしまう問題や、自動採番が意図しない値を返してしまうような状況では、エンティティ側のアノテーション定義が誤っていることが多く、落ち着いて確認すれば改善できるケースがほとんどです。今後、Spring Data JPA を使ってより複雑な CRUD 操作や、関連エンティティ間のリレーション管理に挑戦する際には、今回取り上げた基礎部分が確実に役に立つでしょう。特に、一意性や自動採番の管理は、注文管理やユーザー管理など日常的に多くのデータを扱うシステムでは避けて通れない部分であり、今回の内容がスムーズな設計につながります。

振り返りとしてのサンプルコード

エンティティ設定の総復習として、もう一度シンプルなエンティティと、それを保存するサービスコードを掲載します。


package com.example.demo.entity;

import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;
import jakarta.persistence.Column;

@Entity
public class ReviewEntity {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(nullable = false, length = 200)
    private String title;

    @Column(nullable = false)
    private int score;

    // ゲッターとセッター
    public Long getId() { return id; }
    public void setId(Long id) { this.id = id; }
    public String getTitle() { return title; }
    public void setTitle(String title) { this.title = title; }
    public int getScore() { return score; }
    public void setScore(int score) { this.score = score; }
}


@Service
public class ReviewService {

    @Autowired
    private ReviewRepository reviewRepository;

    public void saveReview(String title, int score) {
        ReviewEntity review = new ReviewEntity();
        review.setTitle(title);
        review.setScore(score);
        reviewRepository.save(review);
    }
}

このように、実際のコードではアノテーションを丁寧に配置することで、エンティティの役割が明確になり、データベースとの連携も自然に成立します。特に、ID の自動採番は日常的に使う機能であり、商品管理、会員管理、レビュー管理など、どんな画面でも欠かせない仕組みです。今回のサンプルを土台として少しずつ応用していくことで、より高度なデータ操作にもスムーズに対応できるようになるでしょう。

先生と生徒の振り返り会話

生徒：「今回の内容を通して、@Entity と @Id と @GeneratedValue がどういう役割なのか少しずつ分かってきました。特に、主キーを自動で設定してくれる仕組みはすごく便利だと思いました。」

先生：「その感覚が持てれば十分だよ。自動採番はどんなシステムでも頻繁に使う機能だから、仕組みを理解しておくと後が本当に楽になるんだ。」

生徒：「確かに、手動で ID を指定しなくていいのでコードもスッキリしますし、データの重複も気にしなくて良くなりますね。」

先生：「そうだね。ただし、複数の採番戦略があることも忘れずに。プロジェクトによっては IDENTITY が合わない場合もあるから、用途に合わせて選べるようになるとさらに一歩進んだ理解につながるよ。」

生徒：「@Column の使い方も今回の例でイメージしやすくなりました。制約を付けておくことで、アプリケーション側のバグも防げるんですね。」

先生：「その通り。エンティティはテーブルの土台だから、ここがしっかりしていると開発全体が安定する。今回学んだ基礎をそのまま次の CRUD 操作やリレーションの学習にも活かしていこう。」

生徒：「はい！まずは自分でもサンプルアプリを作って、いろんなパターンのエンティティを試してみます！」