1주차 Q&A : Annotation

[YONGHYNG]

🔍 애노테이션의 시작부터 현재

1. 애노테이션의 시작 (JDK 5, 2004년)

• 배경
  • 에노테이션은 코드에 메타데이터(추가 정보)를 붙이기 위해 등장
  • 이전에는 설정을 XML 파일로 따로 관리하거나, Marker Interface를 사용
• 단점
  • XML 설정은 코드와 분리되어 있어서 유지보수 어렵고 가독성이 나쁨
  • Marker Interface는 목적이 불명확하고 기능이 부족
  • 코드를 분석하거나 확장할 때 리렉션 사용이 번거로움

👉 그래서 **JDK 5 (2004년)**에서 애노테이션을 도입하면서 코드 안에서 직접 설정할 수 있도록 개선

• JDK 5 기본 애노테이션
  • @OverRide : 부모 메서드 오버라이딩 확인
  • @deprecated : 사용하지 않는 코드 표시
  • @SuppressWarnings : 컴파일러 경고 무시

2. 애노테이션의 확장 (Spring, JPA, Lombok)

• Spring(의존성 주입, AOP, MVC)
  • @controller, @service, @repository → 빈(Bean) 등록 자동화
  • @Autowired → 객체 자동 주입(DI, Dependecy Injection)
  • @transactional → 트랜잭션 관리
• JPA (객체와 DB 매핑)
  • @entity → 클래스를 DB 테이블로 매핑
  • @id → 기본 키 설정
  • @GeneratedValue(strategy = GenerationType.IDENTITY) → 자동 증가 값 설정
• Lombok (코드 자동 생성)
  • @Getter, @Setter → 자동으로 getter/setter 생성
  • @DaTa → 여러 애노테이션을 한 번에 적용
  • @AllArgsConstructor, @NoArgsConstructor → 생성자 자동 생성

1. 애노테이션의 발전(현재)
   • 1. 스프링 부트(Spring Boot) → 설정 최소화
     • @SpringBootApplication → 자동 설정 + 컴포넌트 스캔 + 설정 빈 등록
     • @RestController → JSON 응답 자동으로 처리
     • @configuration → 자바 기반 설정으로 XML 대체
   • 2. 런타임 애노테이션 처리 → AOP와 결합
     • @aspect → AOP(관점 지향 프로그래밍) 활용
     • @around → 특정 메서드 실행 전후 로직 추가
   • 3. 마이크로서비스 & 클라우드(Spring Cloud, Kubernetes)
     • @FeignClient → 마이크로서비스 간 통신 자동화
     • @EnableEurekaClient → 서비스 등록 & 발견
     • @retryable → 네트워크 장애 발생 시 자동 재시도
   • 4. 자바 17+와 애노테이션 발전
     • Record(레코드) + 애노테이션 조합 → @component 같은 애노테이션과 사용
     • Sealed Class(봉인 클래스) + 애노테이션 @JsonSubTypes 등과 결합 가능

📌 예시

1. 기본 애노테이션(JDK 제공) - @OverRide, @deprecated, @SuppressWarnings
   • @Override → 부모 클래스의 메서드를 제대로 오버라이딩했는지 검사
   • @Deprecated → 더 이상 사용하지 않는 메서드(나중에 삭제될 예정)
   • @SuppressWarnings("deprecation") → @Deprecated 경고를 무시

class Parent {
		void showMessage() {
			System.out.println("Parent method");
		}
		
		@Deprecated //이제 사용하지 않는 메서드(나중에 삭제될 예정)
		void oldMethod() {
			 System.out.println("This is an old method");
		}
		
		@SuppressWarnings("deprecation") //경고 무시
		void useOldMethod() {
			oldMethod();
		}
}

1. Spring 애노테이션(DI, MVC, 트랜잭션)

   → @component, @service, @repository, @Autowired

   • @Component → Spring Bean 등록 (기본적인 컴포넌트로 사용)
   • @Service → 비즈니스 로직을 담당하는 클래스
   • @Repository → DB 관련 작업을 처리하는 클래스
   • @Autowired → Spring이 자동으로 객체를 주입해줌

import org.springframework.stereotype.Service;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Repository;
import org.springframework.stereotype.Component;

@Component //일반적인 Spring Bean 등록
class MyComponent {
	void doSomething() {
		System.out.println("Component is working");
	}
}

@Service //서비스 계층(비즈니스 로직)
class MyService {
	@Autowired
	private MyComponent myComponent;
	
	void execute() {
			myComponent.doSomething();
			System.out.println("Service executed");
  	}
}

@Repository //데이터 계층(DB 관련 작업)
class MyRepository {
		void saveData() {
			System.out.println("Data saved!");
		}
}

1. Spring MVC 애노테이션(Controller, API 요청 처리)

   → @RestController, @RequestMapping, @GetMapping, @PostMapping

   • @RestController → Spring MVC 컨트롤러, JSON 응답을 반환
   • @RequestMapping("/api") → 공통 URL을 지정하여 그룹화
   • @GetMapping("/hello") → GET 요청을 처리
   • @PostMapping("/add") → POST 요청을 처리하고 데이터를 받음

import org.springframework.web.bind.annotation.*;

@RestController //JSON 데이터를 반환하는 컨트롤러
@RequestMapping("/api") //공통 URL 지정
class MyController {

		@GetMapping("/hello") //GET 요청 처리
		public String sayHello() {
				return "Hello, World!";
		}
		
		@PostMapping("/add") //POST 요청 처리
		public String addData(@RequestBody String data){
				return "Received data:" + data;
		}
}

1. Spring 트랜잭션 관리

   ->@transactional

   • @Transactional → 트랜잭션을 관리하여 오류 발생 시 롤백 처리

import org.springframework.transaction.annotation.Transactional;
import org.springframework.stereotype.Service;

@Service
class AccountService {

		@Transactional //트랜잭션 시작(실패 시 롤백)
		public void transferMoney() {
				System.out.println("Money transfer started...");
				
				// 계좌 출금
        System.out.println("Withdraw money");
        
        if(true){
		        throw new RuntimeException("Something went wrong!");
        }
        
        //계좌 입금(실행되지 않음)
        System.out.println("Deposit money");
		}
}

1. JPA 애노테이션(ORM, DB 매핑)

   → @entity, @id, @column, @GeneratedValue

   • @Entity → 클래스를 DB 테이블과 매핑
   • @Table(name = "users") → 테이블 이름 설정 (생략 가능)
   • @Id → 기본 키(PK) 설정
   • @GeneratedValue(strategy = GenerationType.IDENTITY) → 자동 증가 (MySQL 사용)
   • @Column(name = "user_name", nullable = false) → DB 컬럼 이름과 제약 조건 설정

import jakarta.persistence.*;

@Entity //이 클래스가 DB 테이블과 매핑
@Table(name = "users") //테이블 이름 지정
class User {

		@Id //기본 키 설정
		@GeneratedValue(strategy = GenerationType.IDENTITY) //자동 증가
		private Long id;
		
		@Column(name = "user_name", nullable = false) //DB 컬럼 이름 지정
		private String name;
		
		//기본 생성자
		public User(){}
		
		//생성자
		public User(String name){
				this.name = name;
		}
		
		//Getter & Setter
		public Long getId() {
			return id;
		}
		
		public String getName() {
			return name;
		}
}

1. Lombok 애노테이션

   → @Getter, @Setter, @DaTa, @AllArgsConstructor, @NoArgsConstructor

   • @Data → @Getter, @Setter, @ToString, @EqualsAndHashCode 자동 적용
   • @AllArgsConstructor → 모든 필드를 받는 생성자 자동 생성
   • @NoArgsConstructor → 기본 생성자 자동 생성

import lombokl.*;

@Data //Getter, Setter, toString, equals, hashCode 자동 생성
@AllArgsConstructor //모든 필드를 받는 생성자 자동 생성
@NoArgsConstructor //기본 생성자 자동 생성
class Product {
		private Long id;
		private String name;
		private double price;
}

public class LombokExample {
	public static void main(String[] args) {
			Product product = new Product(1L, "Laptop", 1200.50);
			System.out.println(product.getName()); 자동 생성된 getter 사용
	}
}