스프링 레이어 구조

🧱 1. Controller (컨트롤러)

📌 역할

• 사용자의 요청을 받아서 처리하는 입구 역할
• 주로 HTTP 요청(GET, POST, PUT, DELETE)을 받고,
• 요청을 처리할 Service를 호출하고,
• 결과를 클라이언트에게 응답으로 반환함.

🎯 사용 예

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

    private final UserService userService;
    public UserController(UserService userService) {
        this.userService = userService;
    }

    @GetMapping("/{id}")
    public UserDto getUser(@PathVariable Long id) {
        return userService.getUserById(id);
    }
}

 

🧠 2. Service (서비스)

📌 역할

• 비즈니스 로직이 들어있는 중간 관리자
• 데이터 처리 순서, 계산, 검증 등 주요 로직 수행
• 컨트롤러는 서비스한테 "이거 해줘"라고 요청함
• 서비스는 DB와 직접 접촉하지 않고 Repository를 호출함

🎯 사용 예

@Service
public class UserService {

    private final UserRepository userRepository;
    public UserService(UserRepository userRepository) {
        this.userRepository = userRepository;
    }

    public UserDto getUserById(Long id) {
        User user = userRepository.findById(id)
            .orElseThrow(() -> new RuntimeException("User not found"));
        return new UserDto(user.getId(), user.getName());
    }
}

 

🗃️ 3. Repository (레포지토리)

📌 역할

• DB에 직접 접근해서 데이터를 가져오거나 저장하는 계층
• 보통 JPA, MyBatis, JDBC 등을 사용해서 구현
• 인터페이스만 만들어도 JPA가 알아서 구현해줌 

🎯 사용 예

@Repository
public interface UserRepository extends JpaRepository<User, Long> {
    // 필요한 경우 커스텀 쿼리도 추가 가능
    Optional<User> findByEmail(String email);
}

 

🧬 4. Domain (도메인)

📌 역할

• **비즈니스 대상이 되는 실제 객체(엔티티)**를 표현하는 클래스
• 예: User, Product, Order 같은 실제 비즈니스 객체들
• DB 테이블과 매핑되며, JPA에서 @Entity로 표시함

🎯 사용 예

@Entity
public class User {

    @Id @GeneratedValue
    private Long id;

    private String name;
    private String email;

    // getter, setter, 생성자 등 생략
}

 

 

🔄 전체 흐름 요약

[Client] → 요청
   ↓
[Controller] → 요청 파라미터 받고, Service 호출
   ↓
[Service] → 비즈니스 로직 수행, Repository 호출
   ↓
[Repository] → DB에서 데이터 조회 or 저장
   ↓
[Domain] → 실제 데이터 객체(Entity)
   ↓
결과를 다시 위로 반환 → 최종 응답

 

💡 실제 예: 유저 조회 API

[브라우저 요청] GET /users/1
     ↓
[UserController] → userService.getUserById(1)
     ↓
[UserService] → userRepository.findById(1)
     ↓
[UserRepository] → DB에서 User 엔티티 조회
     ↓
[User] → 엔티티 → DTO로 변환 → 클라이언트에게 응답

 

📎 정리표

계층 역할 설명 어노테이션 주요 키워드

Controller	요청 처리 & 응답 반환	@Controller, @RestController	HTTP
Service	비즈니스 로직	@Service	로직
Repository	데이터베이스 접근	@Repository or JpaRepository	DB
Domain	DB 테이블과 매핑되는 모델 클래스	@Entity	객체