[Java] Spring boot 입문자를 위한 개념 정리 (feat. 사실은 내가 몰라서 정리한 걸 곁들인)

 

이번 SKALA에서 스프링부트 프로젝트를 하면서,

알게 된 개념이나 계속 헷갈렸던 문법을 한 번에 정리한 내용이다~!

---

0. 개발 및 파일 작성 순서 

• 데이터 모델 → 리포지토리 → 서비스 → 컨트롤러 → 프론트엔드

현업의 교수님께서는 정석적인 순서는 위와 같다고 말씀하였다. 

하지만 상황에 따라, 프론트엔드가 병렬적으로 급하게 진행돼야 할 때는 컨트롤러를 먼저 작성하기도 한다고 하심!

위의 순서는 개인의 취향에 달린 문제이기 때문에 자유롭게 변경이 가능하다!

 

전체 다 보이면,

1. Entity
2. Repository
3. DTO
4. Mapper
5. Service
6. Controller

 

1. 스프링의 핵심 개념: Bean, DI, 의존성 주입

Bean이란?

• Bean은 Spring이 생성하고 관리하는 객체
• 직접 new 키워드로 생성하지 않고, `@Component`, `@Service`, `@Repository`, `@Controller` 같은 어노테이션을 붙이면 Spring이 자동으로 객체를 만들어 등록
• 이렇게 등록된 객체는 다른 클래스에서 `@Autowired` 또는 생성자 주입을 통해 쉽게 사용 가능 

의존성 주입(DI: Dependency Injection)

• 내가 필요한 객체를 내가 직접 만들지 않고, Spring이 대신 만들어서 넣어주는 것
• 예시:

@RequiredArgsConstructor
public class StockService {
    private final StockRepository stockRepository;
    private final StockMapper stockMapper;
}

• 여기서 final로 선언하면, 해당 객체는 반드시 생성자에서 초기화되어야 함을 의미
• `@RequiredArgsConstructor`는 final 필드를 파라미터로 받는 생성자를 자동으로 생성
• 생성자 주입을 사용하면 의존성이 명확히 드러나고, 테스트가 쉬우며, 컴파일 타임에 누락을 방지할 수 있음

 

2. Spring Data JPA: Repository 구조와 동작 원리

Repository란?

• 데이터베이스와 직접 소통하는 계층
• JPA에서는 JpaRepository<T, ID>를 상속받은 인터페이스를 통해 DB에 접근
• 예시:

public interface StockRepository extends JpaRepository<Stock, UUID> {
    Optional<Stock> findByName(String name);
    boolean existsByName(String name);
}

Spring Data JPA의 동작 구조

1. @EnableJpaRepositories 설정을 기반으로 Spring이 Repository 인터페이스들을 스캔
2. 내부적으로 RepositoryFactoryBean이 동작하여, 인터페이스만 보고 구현체를 생성
3. 그 구현체는 프록시(Proxy) 객체이며, 실제 DB와 연결되는 동작은 이 프록시를 통해 수행
4. 파생 쿼리 메서드의 경우, 메서드 이름을 분석하여 쿼리를 자동 생성
   • 예: findByName(String name) → SELECT * FROM stock WHERE name = ?

직접 쿼리 작성 (@Query)

@Query("SELECT p FROM Player p LEFT JOIN FETCH p.playerStockList WHERE p.id = :playerId")
Optional<Player> findByIdWithStocks(@Param("playerId") UUID playerId);

• 복잡하거나 조인이 필요한 경우 직접 JPQL 작성 가능

 

3. Entity vs DTO: 왜 나눠야 하는가?

Entity

• DB 테이블과 매핑되는 클래스
• 내부 로직 포함, 연관관계(@OneToMany 등)도 포함
• 예: Player, Stock, PlayerStock

DTO(Data Transfer Object)

• 요청/응답에 맞춘 데이터 구조
• 보통 불변(immutable) 객체로 설계
• 외부에 노출되는 구조이기 때문에 Entity와 분리

public class StockMapper {
    public Stock toEntity(final CreateStockRequest request) { ... }
    public StockResponse toResponse(final Stock stock) { ... }
}

왜 final을 쓰는가?

• 메서드 내부에서 매개변수가 변경되지 않도록 보장
• final은 읽기 전용을 의미하며, 실수로 값을 바꾸는 것을 방지

record DTO 사용 (Java 14+)

public record StockResponse(String name, int price) {}

• 장점: 생성자, getter, equals, toString 자동 생성
• 모든 필드가 final이며 변경 불가

 

4. 트랜잭션 처리: @Transactional

사용 이유

• 하나의 작업 단위를 트랜잭션으로 묶어 처리함으로써 중간에 오류 발생 시 전체 작업을 롤백할 수 있음
• 조회만 하는 경우 readOnly = true로 설정하면 성능 최적화

@Transactional(readOnly = true)
public List<Stock> getStocks() { ... }

데이터 변경이 필요한 경우

@Transactional
public Stock createStock(CreateStockRequest request) { ... }

 

5. 예외 처리: CustomException 설계

@Getter
public class CustomException extends RuntimeException {
    private final HttpStatus status;

    public CustomException(String message, HttpStatus status) {
        super(message);
        this.status = status;
    }
}

• 사용 예:

throw new CustomException("해당 주식이 존재하지 않습니다", HttpStatus.NOT_FOUND);

• 프론트엔드로 의미 있는 메시지와 함께 HTTP 상태코드를 전달 가능

상황 상태 코드

상황	상태 코드
로그인 필요	401 Unauthorized
권한 없음	403 Forbidden
데이터 없음	404 Not Found
중복 데이터	409 Conflict
요청 오류	400 Bad Request
정상 생성	201 Created

 

6. 요청 매핑 어노테이션과 위치

데이터 위치 어노테이션 설명

데이터 위치	어노테이션	설명
요청 본문(JSON)	`@RequestBody`	JSON → 객체로 변환
URL 경로 변수	`@PathVariable`	/stocks/{id} 와 같은 형태에서 ID 추출
쿼리 파라미터	`@RequestParam`	?page=1 같은 쿼리에서 값 추출
헤더 값	`@RequestHeader`	Authorization 등의 헤더 추출
쿠키 값	`@CookieValue`	세션 ID 추출 등

 

예시:

@GetMapping("/stocks")
public ResponseEntity<List<StockResponse>> getStocks(@RequestParam int page) { ... }

 

7. 페이징 처리: Pageable과 Page

Pageable pageable = PageRequest.of(page, 10, Sort.by(Direction.DESC, "id"));
Page<Stock> marketStockList = stockRepository.findAll(pageable);
return marketStockList.stream().map(stockMapper::toResponse).toList();

• Pageable: page 번호, 크기, 정렬 정보를 포함한 요청 객체
• Page<T>: content(List) 외에도 전체 페이지 수, 현재 페이지 등의 정보를 포함

List<StockResponse> result = new ArrayList<>();
for (Stock stock : marketStockList) {
    result.add(stockMapper.toResponse(stock));
}

• 위 코드는 `stream`을 사용해 간결하게 대체 가능

 

8. 연관관계 설정과 Cascade, OrphanRemoval

@OneToMany(mappedBy = "player", cascade = CascadeType.ALL, orphanRemoval = true)
private List<PlayerStock> playerStockList;

• `cascade = ALL`: 부모 저장/삭제 시 자식도 자동 처리
• `orphanRemoval = true`: 부모에서 제거된 자식은 DB에서도 제거