[Spring]Spring Bean

대체 Bean이 뭐고 왜 필요한데???

 

 

빈(Bean)이란?
스프링이 대신 new해서 생성하고 앱 전반에서 쓸 수 있도록 관리해주는 객체

리액트로 비유해 보자면,
빈(Bean) = Context Provider에 등록된 값.
스프링이 Provider역할을 해서 빈을 미리 만들어두고 어디서든 @Autowired (≒useContext)로 꺼내는 구조!


빈(Bean)은 기본적으로 싱글톤(한 번만 만들어져서 전체 공유)

빈(Bean)에 들어갈 값은 new 클래스()로 만든 객체(=인스턴스)이다.
즉, 클래스는 설계도이고, 그 설계도로 만든 객체가 스프링 컨테이너에 Bean으로 들어간다.
이 객체는 스프링이 대신 new 해서 만들어주고, 앱 전체에서 꺼내쓸 수 있게 관리해준다.

 

 

왜 굳이 스프링이 객체를 대신 만들고 관리하게 하는데

 

 

1. new를 안써도 됨.(자동연결)

예를들면 React에서 props내려주는 구조가 아래 코드와 같다면

<App>
  <Page user={user}>
    <Profile user={user} />
  </Page>
</App>

 

문제는 중간 컴포넌트(Page)는 user안씀, 그럼에도 내려줘야 함

해결책으로는 Context써서 어디서든 바로 꺼내쓰기.

 

 

 

그래서 Spring에선 빈을 미리 만들어주고 자동으로 주입하는 구조다.

@Service
public class ProfileService {
    private final UserRepository userRepository;

    // 생성자에 @Autowired → 스프링이 알아서 빈을 연결해줌
    public ProfileService(UserRepository userRepository) {
        this.userRepository = userRepository;
    }
}

결과로는 직접 new UserRepository() 안해도 됨.

스프링이 대신 만들어서 넣어줌

 

 

2.한 번만 만들어서 전체 공유(싱글톤)

React의 Context에 넣는 객체는 전체공유가 가능하다. 이와 비슷함

<DataContext.Provider value={myApiClient}>
  <App />
</DataContext.Provider>

 

Spring 기본적으로 빈은 싱글톤, 한 번만 만들어져서 어디서든 사용 가능하다는 특징이 있다.

@Configuration
public class AppConfig {
    @Bean
    public ApiClient apiClient() {
        return new ApiClient("https://api.example.com");
    }
}

apiClient()는 애플리케이션 실행 중 단 1번만 호출

 

 

3. 테스트할 때도 편함

@TestConfiguration
public class TestConfig {
    @Bean
    public ApiClient fakeApiClient() {
        return new FakeApiClient(); // 테스트용 객체!
    }
}

실제 구현체를 바꾸지 않고도 테스트용으로 교체가 가능하다

이게 다 빈등록을 통해 의존성 연결을 스프링이 맡기기 때문에 가능

 

 

---

어떻게 등록하고 꺼내쓰는데?

 

→ ComponentScan = 자동 등록해주는 기능
→ @Bean = 직접 등록해주는 기능

 

@ComponentScan: "자동 등록기"

 

무슨말이냐면,

예를들면, React로 치면, 내가 만든 컴포넌트를 App.js에서 일일이 import 안해도 src/ components /폴더에 전체를 자동으로 스캔해서 등록해주는 기능

 

Spring에선 아래 코드와 같다.

@Component
public class MyService {
    public void doSomething() {
        System.out.println("Spring Bean!");
    }
}

 

이 클래스가 있는 위치를 기준으로 스프링이 자동으로 스캔한다.

@SpringBootApllication이 있는 클래스 기준으로 하위 패키지를 뒤져서 이런 @Component, @Service, @Controller, @Repository가 붙은 걸 전부 Bean으로 등록해준다.

 

즉, 일일이 등록하지 않아도 그냥 자동으로 등록해줘서 편하다.

 

비유를 해보자면, 

React에서 components/폴더에 있는 모든 파일을 자동으로 import해주는 느낌

(실제로는 그렇지 않지만, 그런 자동탐색기 역할을 한다고 이해하면 딱 좋음)

 

 

@SpringBootApplication이 왜 중요함?

@SpringBootApplication
public class MainApplication {
    public static void main(String[] args) {
        SpringApplication.run(MainApplication.class, args);
    }
}

 

이 @SpringBootApllication안에 이미 @ComponentScan이 포함돼 있음

즉, 이 클래스가 있는 패키지를 기준으로 아래에 있는 모든 @Components들을 등록해줘라는 의미다.

 

그래서 MainApplication의 위치가 엄청 중요함.

너무 하위에 있으면 위에 있는 것들을 스캔 못함

 

 

자동 등록이 싫고 직접 등록하고 싶을 땐? (@Bean)

 

React에서 Context.Provider안에 값을 명시적으로 넣어주는 느낌이라고 이해하면 된다.

 

@Bean은 외부 라이브러리 객체나 내가 컨트롤 못하는 클래스를 빈으로 등록할 때 유용하다.

Spring코드는 아래와 같다

@Configuration // "이 클래스는 Bean 등록용 클래스야"
public class AppConfig {

    @Bean  // "이 메서드가 반환하는 객체를 Spring Bean으로 등록해줘!"
    public TestService testService() {
        return new TestServiceImpl();
    }
}

이제부터는 testService()가 반환하는 TestServiceImpl객체가 스프링 컨테이너 안에 들어간다.

ApplicationContext context = new AnnotationConfigApplicationContext(AppConfig.class);
TestService service = context.getBean(TestService.class);

 

React로 치면, Context.Provider안에 value={myService} 넣어준 느낌.

 

 

 

Bean 충돌이 났을 땐?

 

두 개의 같은 이름을 가진 Bean이 있으면?

 

@Component("service") // 자동 등록
public class ConflictServiceV1 implements ConflictService {...}

@Component("service") // 자동 등록
public class ConflictServiceV2 implements ConflictService {...}

이건 마치 Context.Provider 안에 두 개의 value를 동시에 넣으려는 거임

스프링은 ConflictingBeanDefinitionException 에러를 뱉음(누굴 쓸지 모르니깐!)

그럴 땐?

 

• 수동 등록이 우선권을 가진다.
  • 즉, 수동으로 등록한 @Bean이 자동 등록된 @Component보다 먼저 먹히게 된다.
• 실수로 이름 겹치면 진짜 버그남.
• 그래서 Spring Boot에서는 충돌하면 애초에 실행 오휴 내버리는 정책을 씀. 이게 더 안전하다.

 

---

 

예시코드로 보는 Bean

 

com.example
├── MyApplication.java  // 여기 @SpringBootApplication 붙음
├── controller/
│   └── HelloController.java (@RestController)
├── service/
│   └── GreetingServiceImpl.java (@Service)

 

// 1. 인터페이스 선언: 역할 정의
public interface GreetingService {
    String greet(String name);
}

 

 

 

// 2. 인터페이스 구현체 만들기
@Service // ComponentScan에 의해 자동으로 빈 등록됨
// ComponentScan를 선언 안 했는데 어떻게 자동 등록이 되는가?
// @SpringBootApplication안에 @ComponentScan이 들어있기 때문.

public class GreetingServiceImpl implements GreetingService {

    @Override
    public String greet(String name) {
        return "안녕하세요, " + name + "님!";
    }
}

위 코드에서 @ComponentScan 선언 안 했는데 어떻게 자동등록이 되는지 간략하게 설명하고 넘어가겠다.

@SpringBootApplication
public class MyApplication {
    public static void main(String[] args) {
        SpringApplication.run(MyApplication.class, args);
    }
}

이렇게 스프링부트 프로젝트를 시작하면, @SpringBootApllication이 자동으로 @ComponentScan을 포함하고 있어서

별도로 @ComponentScan을 선언하지 않아도 됨.

// 실제로 @SpringBootApplication에는 이런 코드가 있음
@SpringBootApplication
= @Configuration
+ @EnableAutoConfiguration
+ @ComponentScan   요게 포함되어 있음!!!

즉, @SpringBootApplication = 3개를 한 번에 붙인 효과

 

 

// 3. 이 서비스를 사용하는 컨트롤러
@RestController
public class HelloController {

    private final GreetingService greetingService;

    // 4. 생성자 주입: 스프링이 GreetingServiceImpl을 자동으로 넣어줌!
    public HelloController(GreetingService greetingService) {
        this.greetingService = greetingService;
    }

    // 5. 브라우저에서 /hello?name=한솔 → 이 메서드 실행
    @GetMapping("/hello")
    public String hello(@RequestParam String name) {
        return greetingService.greet(name);  // 실제 구현체 메서드 호출
    }
}