【Java ORM完全攻略】自作ライブラリの作り方｜アノテーション×リフレクションで学ぶ設計力

「HibernateやJPAを使っているけど、なぜ動くのか仕組みを知りたい」
「SQLを自動で生成する処理を自分でも作ってみたい」
そんな思いをお持ちの方におすすめなのが、JavaでのORMライブラリの自作体験です。

本記事では、リフレクション・アノテーション・SQL文字列の動的生成を使って、
初心者でも構築できるシンプルなORMライブラリの作り方を、
コード付きでわかりやすく解説いたします。

ORMライブラリとは何か？
1. SQL操作をコードで簡単に扱える仕組み
自作ORMの基本構成を理解する
1. 最小限で動く構成を設計します
アノテーションの定義：Entity.java / Column.java
エンティティクラスの例：User.java
ORMの本体処理：OrmManager.java
使い方例：Main.java
躓きやすいエラーと解決策
応用アイデアで実用性を高める
完成構成のまとめ
まとめ：仕組みを知れば応用も自在

ORMライブラリとは何か？

SQL操作をコードで簡単に扱える仕組み

結論：ORMとは「データベースとJavaのクラスを結びつける仕組み」です。

従来、データベース操作にはSQL文の記述が必要でした。
しかしORMを使えば、SQL文を直接書かずに以下のような操作ができます：

データの取得（SELECT）
データの登録（INSERT）
データの更新（UPDATE）
データの削除（DELETE）

これにより、保守性・可読性・安全性が大きく向上します。

自作ORMの基本構成を理解する

最小限で動く構成を設計します

結論：以下の4ファイルだけで簡易ORMは構築可能です。

src/
├─ Entity.java           // エンティティ用アノテーション
├─ Column.java           // カラム用アノテーション
├─ OrmManager.java       // ORMの本体（登録・取得など）
└─ User.java             // 実際のエンティティ（Userテーブル）

アノテーションの定義：Entity.java / Column.java

import java.lang.annotation.*;
 
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
public @interface Entity {
    String table();
}

import java.lang.annotation.*;
 
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD)
public @interface Column {
    String name();
}

エンティティクラスの例：User.java

@Entity(table = "users")
public class User {
    @Column(name = "id")
    public int id;
 
    @Column(name = "name")
    public String name;
 
    @Column(name = "email")
    public String email;
}

ORMの本体処理：OrmManager.java

import java.lang.reflect.*;
 
public class OrmManager {
 
    public static String generateInsertSQL(Object obj) throws Exception {
        Class<?> cls = obj.getClass();
 
        if (!cls.isAnnotationPresent(Entity.class)) {
            throw new Exception("Entityアノテーションが見つかりません");
        }
 
        Entity entity = cls.getAnnotation(Entity.class);
        StringBuilder columns = new StringBuilder();
        StringBuilder values = new StringBuilder();
 
        for (Field field : cls.getDeclaredFields()) {
            if (field.isAnnotationPresent(Column.class)) {
                Column col = field.getAnnotation(Column.class);
                field.setAccessible(true);
                Object value = field.get(obj);
                columns.append(col.name()).append(", ");
                values.append("'").append(value).append("', ");
            }
        }
 
        String columnStr = columns.substring(0, columns.length() - 2);
        String valueStr = values.substring(0, values.length() - 2);
 
        return String.format("INSERT INTO %s (%s) VALUES (%s);", entity.table(), columnStr, valueStr);
    }
}

使い方例：Main.java

public class Main {
    public static void main(String[] args) throws Exception {
        User user = new User();
        user.id = 1;
        user.name = "Taro";
        user.email = "taro@example.com";
 
        String sql = OrmManager.generateInsertSQL(user);
        System.out.println(sql);
    }
}