Spring BootのDI（依存性注入）完全ガイド｜@Autowiredの仕組みから各アノテーションの使い分けまで

// ❌ DIなし：自分でnewする問題パターン
public class UserController {
    private UserService userService = new UserService(); // 自分でnew

    public void saveUser(String name) {
        userService.save(name);  // ここで保存
    }
}

public class AdminController {
    private UserService userService = new UserService(); // 別のインスタンス！

    public List getUsers() {
        return userService.findAll();  // 空のリストが返る…
    }
}

@Repository   // ← これだけでSpringがBeanとして管理
public class UserRepository {

    private List<String> users = new ArrayList<>();

    public void save(String name) {
        users.add(name);
    }

    public List<String> findAll() {
        return users;
    }
}

@Service
public class UserService {

    private final UserRepository userRepository;

    // コンストラクタインジェクション（推奨）
    // コンストラクタが1つなら @Autowired は省略可
    public UserService(UserRepository userRepository) {
        this.userRepository = userRepository;
        // ↑ SpringがコンテナからUserRepositoryを自動で渡してくれる
    }

    public void register(String name) {
        userRepository.save(name);
    }

    public List<String> getAll() {
        return userRepository.findAll();
    }
}

@RestController
@RequestMapping("/users")
public class UserController {

    private final UserService userService;

    public UserController(UserService userService) {
        this.userService = userService;
        // ↑ SpringがコンテナからUserServiceのBeanを自動注入
    }

    // POST /users?name=Taro → ユーザー登録
    @PostMapping
    public String register(@RequestParam String name) {
        userService.register(name);
        return name + " を登録しました";
    }

    // GET /users → 全ユーザー取得
    @GetMapping
    public List<String> getAll() {
        return userService.getAll();
    }
}

@SpringBootApplication   // @ComponentScan を内包
public class DemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

@Component（Bean登録の基本）
 ├── @Controller（Web入力受付 / MVC用）
 ├── @Service（ビジネスロジック処理の中心）
 ├── @Repository（DB操作 / 例外変換あり★）
 └── @RestController（@Controller + @ResponseBody）

// パッと見て役割がわかる ✅
@Controller    // → Webの入り口
@Service       // → ビジネスロジック
@Repository    // → DB操作
@Component     // → それ以外の汎用部品（スケジューラーなど）

@Service
public class OrderService {

    @Transactional  // Service層に書くのが慣習
    public void placeOrder(Order order) {
        // 在庫を減らして、注文を保存して、請求を作成する
        // → どれか1つ失敗したら全部ロールバック
    }
}

// ① フィールドインジェクション（簡単だが非推奨）
@Service
public class UserService {

    @Autowired
    private UserRepository userRepository;
    // テスト時にモックを差し替えにくい・finalにできない
}


// ② セッターインジェクション（オプション注入に使うことがある）
@Service
public class UserService {

    private UserRepository userRepository;

    @Autowired
    public void setUserRepository(UserRepository userRepository) {
        this.userRepository = userRepository;
    }
}


// ③ コンストラクタインジェクション（現在の推奨 ✅）
@Service
public class UserService {

    private final UserRepository userRepository; // final にできる

    // コンストラクタが1つだけなら @Autowired は省略可（Spring 4.3以降）
    public UserService(UserRepository userRepository) {
        this.userRepository = userRepository;
    }
}

@Service
public class UserService {

    // @Autowired なし・コンストラクタ注入なし
    private UserRepository userRepository; // null のまま！

    public void register(String name) {
        userRepository.save(name); // ← NullPointerException 発生！
    }
}