【Java入門】簡易フレームワークの作り方｜アノテーションとDIを活用して設計力を学ぶ完全解説

「SpringやStrutsのようなフレームワークの中身を理解したい」
「けれど大規模すぎてどこから手をつけていいか分からない」
そんな方にぴったりなのが、Javaで簡易フレームワークを自作してみることです。

依存注入・ルーティング・アノテーション処理など、フレームワークの基礎的な考え方を自分の手で作ることで、
実務で必要な設計力や仕組みへの理解が飛躍的に深まります。

この記事では、初心者〜中級者でも構築できる超シンプルなJavaフレームワークの作り方を、
コード例・図解・つまずきやすいポイントの解決策付きで詳しく解説いたします。

フレームワークとは何か？
1. 自作して初めてわかる仕組みの大切さ
最低限のフレームワーク構成を設計
1. 必要な機能はたったこれだけ
アノテーションの定義：Controller.java
ユーザーコードの実装例：SampleApp.java
フレームワーク本体：MiniFramework.java
実行ファイル：Main.java
よくあるエラーとその解決方法
1. 躓きやすいポイントと対処法を紹介します
応用機能でさらに学べる
1. 発展例で実力をさらに高めましょう
完成形まとめと構成
まとめ：Javaの中身を理解する最短ルート

フレームワークとは何か？

自作して初めてわかる仕組みの大切さ

結論：フレームワークとは「よく使う仕組みを共通化した道具箱」です。

SpringやLaravelのような有名なフレームワークも、
基本的には「ルール・部品・流れ」が一式で揃ったものです。

自分でミニフレームワークを作ることで、以下の力が身につきます：

アノテーションの使い方
DI（依存性の注入）の考え方
ルーティングの構造
処理の流れを自動化する工夫

最低限のフレームワーク構成を設計

必要な機能はたったこれだけ

結論：次の3つの機能だけで「それっぽいフレームワーク」が完成します。

ルーティング処理（文字列から関数を呼び出す）
DI機能（オブジェクトを自動で渡す）
アノテーション解析（クラス・メソッドに目印を付ける）

Javaの構成イメージ：

myframework/
├─ MiniFramework.java       // DI・ルーティングの仕組み
├─ Controller.java          // アノテーション定義
├─ SampleApp.java           // ユーザーコード（アノテーション使用）
└─ Main.java                // 起動処理

アノテーションの定義：Controller.java

import java.lang.annotation.*;

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
public @interface Controller {
    String path();
}

ユーザーコードの実装例：SampleApp.java

@Controller(path = "/hello")
public class SampleApp {
    public void sayHello() {
        System.out.println("こんにちは！フレームワークから呼ばれました。");
    }
}

フレームワーク本体：MiniFramework.java

import java.lang.annotation.Annotation;
import java.lang.reflect.*;

public class MiniFramework {
    public static void run(Class<?>[] classes, String inputPath) {
        for (Class<?> cls : classes) {
            if (cls.isAnnotationPresent(Controller.class)) {
                Controller ctrl = cls.getAnnotation(Controller.class);
                if (ctrl.path().equals(inputPath)) {
                    try {
                        Object obj = cls.getDeclaredConstructor().newInstance();
                        for (Method m : cls.getDeclaredMethods()) {
                            if (m.getName().startsWith("say")) {
                                m.invoke(obj);
                            }
                        }
                    } catch (Exception e) {
                        System.out.println("エラー発生：" + e.getMessage());
                    }
                }
            }
        }
    }
}

実行ファイル：Main.java

public class Main {
    public static void main(String[] args) {
        MiniFramework.run(
            new Class[]{SampleApp.class},
            "/hello"
        );
    }
}