[Spring] @Controller VS @RestController

💡 개발에서 우선순위는 항상 자세히 선언된것이 우선순위가 높다.

---

✔️ @Controller

📌 주요 특징

✅ Spring MVC에서 컨트롤러 역할을 하는 클래스임을 명시한다.

✅ 뷰(View)와 연결되는 컨트롤러로 사용된다.

✅ @Component가 포함되어 있어 Spring Bean으로 등록되며, 싱글톤으로 관리된다.

✅ 주로 HTML을 반환하는 경우 사용된다.

📌 어노테이션 설명

💡 아래의 어노테이션에 대한 자세한 설명 👉 [Spring] Annotation

• @Target(ElementType.Type)

  • Class, Interface, Annotation, Enum, Record Declaration(Java16) 에 적용할 수 있다.

• @Retention(RetentionPolicy.RUNTIME)

  • 클래스 파일(.class)에 저장되고, JVM에 의해 런타임 시점에 읽을 수 있다.

• @Document

  • Javadoc 등의 문서화 도구에 의해 문서화되어야 함을 나타낸다.

• @Component

  • Spring Bean에 등록한다.

  • 싱글톤으로 관리된다.

  👀 Q. 싱글톤이 무엇인가요?
  
  💬 A. 싱글톤은 객체를 하나만 생성하여 생성된 인스턴스를 공유하여 사용하는 것을 의미g한다. 특정 클래스의 인스턴스가 여러개 생성되지 않도록 하여 자원의 낭비를 방지하고, 인스턴스를 공유함으로써 상태를 일관되게 유지하기 위함이다. 하지만, 공유 변수 사용을 주의해야 한다.

---

✔️ @RestController

📌 주요 특징

✅ @Controller에 @ResponseBody가 결합된 어노테이션

✅ @RestController는 @Controller와 달리 각 메서드마다 @ResponseBody를 추가하지 않아도 된다.

📌 어노테이션 설명

• @Target(ElementType.Type)

  • Class, Interface, Annotation, Enum, Record Declaration(Java16) 에 적용할 수 있다.

• @Retention(RetentionPolicy.RUNTIME)

  • 클래스 파일(.class)에 저장되고, JVM에 의해 런타임 시점에 읽을 수 있다.

• @Document

  • Javadoc 등의 문서화 도구에 의해 문서화되어야 함을 나타낸다.

• @Controller

  • Spring의 컨트롤러 역할을 수행

• @ResponseBody

  • 모든 메서드의 반환값을 HTTP 응답 바디에 직접 삽입

---

✔️ @ResponseBody

📌 주요 특징

✅ 컨트롤러의 반환 값을 뷰가 아니라, HTTP 응답 바디에 직접 삽입한다.

✅ @Controller에서 특정 메서드만 REST API 응답을 하게 하고 싶다면, 해당 메서드에 @ResponseBody를 추가하면 된다.

📌 어노테이션 설명

• @Target{ElementType.TYPE, ElementType.METHOD}

  • class 레벨에도 , Method 레벨에도 적용 가능하다.

  ❓ @Controller에 동일한 Target이 선언되어 있는데 왜 중복으로 선언이 되어있나요?
  
  💡 @ResponseBody는 @Target{ElementType.TYPE, ElementType.METHOD} 이지만, @RestController은 @Target(ElementType.TYPE)이기 때문에 더 자세하게 선언된 @RestController의 @Target(ElementType.TYPE)이 적용된다. 따라서 TYPE 범위에만 @ResponseBody가 적용된다.
  
  즉, @Restcontroller는 TYPE인 Class Level에만 적용할 수 있다!

  ✔️ 이 때, "더 자세히 선언된 것이 우선순위가 높다"에서, @Target{ElementType.TYPE, ElementType.METHOD}가 @Target(ElementType.TYPE)보다 더 포괄적인 범위를 가지는 것처럼 보인다. 하지만 여기서 "더 자세히 선언된 것이 우선순위가 높다" 는 의미는 적용 범위가 더 좁은 것(더 구체적인 제한)이 우선 적용된다는 것이다.