[Spring] Spring Data JPA — 데이터베이스 작업을 간편하게 만드는 기술

📝  Spring Data JPA — 데이터베이스 작업을 간편하게 만드는 기술

안녕하세요, 개발자 여러분! 우리가 애플리케이션을 만들 때, 사용자의 정보, 게시글, 상품 목록 등 수많은 데이터를 저장하고 관리해야 합니다. 이러한 데이터는 보통 데이터베이스라는 체계적인 저장소에 보관되죠.

그런데 자바와 같은 프로그래밍 언어가 데이터베이스와 직접 '대화'하려면 SQL이라는 특별한 언어를 사용해야 하고, 때로는 이 과정이 꽤 복잡하고 반복적인 작업이 될 수 있습니다. 마치 외국어를 사용하여 정해진 양식에 맞춰 서류를 작성하는 것과 비슷하다고 할 수 있죠.

이러한 번거로움을 줄여주고, 개발자가 좀 더 자바 코드 자체에 집중할 수 있도록 도와주는 멋진 도구가 바로 Spring Data JPA입니다. 오늘은 이 Spring Data JPA가 무엇이고, 어떻게 우리의 데이터베이스 작업을 편리하게 만들어주는지 핵심 원리를 중심으로 쉽게 알아보겠습니다.

---

🏢 1. Spring Data JPA란?

📌 먼저, Spring Data부터!

• Spring Data는 여러 종류의 데이터 저장소(예: MySQL, MongoDB, Redis)를 일관되게 사용할 수 있도록 도와주는 도구예요.
• 즉, 저장소가 달라도 사용법은 거의 똑같게 만들어줘요.

📌 그중에서도 가장 많이 쓰는 건?

바로 Spring Data JPA입니다!

• 이건 JPA라는 기술을 기반으로 만들어졌어요.
• JpaRepository 같은 인터페이스를 상속받기만 해도, 저장, 조회, 수정, 삭제가 다 돼요!

🎮 즉, 복잡한 SQL 안 쓰고도 DB랑 대화할 수 있는 마법 같은 도구!

---

📚 2. CRUDRepository: 기본 기능은 여기 다 있어요!

Spring Data JPA를 사용하면 가장 먼저 만나게 되는 친구 중 하나가 바로 CrudRepository 인터페이스입니다. 이름에서 알 수 있듯이, 데이터 처리에 가장 기본적이고 필수적인 CRUD 기능을 제공합니다.

• Create (생성 - 데이터 저장)
• Read (읽기 - 데이터 조회)
• Update (갱신 - 데이터 수정)
• Delete (삭제 - 데이터 삭제)

놀라운 점은, 개발자가 이 CrudRepository 인터페이스를 상속받는 새로운 인터페이스를 만들기만 하면, Spring Data JPA가 자동으로 기본적인 CRUD 메서드 구현체를 만들어준다는 것입니다! 개발자는 직접 SQL을 작성하거나 복잡한 JPA 코드를 구현할 필요가 거의 없습니다.

딱 두 가지만 명시해주면 됩니다:

1. 어떤 엔티티(Entity, 데이터베이스 테이블과 매핑될 자바 객체) 를 다룰 것인지 (예: Board 클래스)
2. 그 엔티티의 ID(식별자) 타입이 무엇인지 (예: Long 타입)

🛠 CRUD란?

기능설명메서드 예시

조회	데이터 읽기	findById(), findAll()
저장/수정	데이터 넣기 또는 바꾸기	save()
삭제	데이터 없애기	deleteById(), delete()

 

BoardRepository (게시판 데이터 접근 인터페이스) 예시:

import org.springframework.data.repository.CrudRepository;

// Board 엔티티를 다루고, Board의 ID 타입은 Long이다.
public interface BoardRepository extends CrudRepository<Board, Long> {
    // 기본적인 CRUD 메서드들은 이미 여기에 준비되어 있어요!
    // 특별한 조회 조건이 필요하면 여기에 메서드를 추가할 수 있습니다.
}

정말 간단하죠? 이 인터페이스만 정의하면, Spring Data JPA가 내부적으로 실제 작동하는 코드를 생성해줍니다.

CrudRepository의 주요 기본 제공 메서드 📜

작업 분류메서드 (기능)설명 (이해하기 쉽게 풀어서)

생성/수정	save(S entity)	"이 엔티티(데이터)를 저장해줘!" (ID가 없거나 DB에 없으면 새로 저장, ID가 DB에 이미 존재하면 해당 데이터 수정)
조회	findById(ID id)	"이 ID를 가진 엔티티 하나만 찾아줘!" (결과는 Optional<S> 타입으로 반환되어 null 처리가 용이)
	findAll()	"해당 타입의 모든 엔티티를 다 보여줘!"
	count()	"엔티티가 총 몇 개 있는지 알려줘!"
	existsById(ID id)	"이 ID를 가진 엔티티가 실제로 존재하는지 확인해줘!" (존재하면 true, 없으면 false)
삭제	deleteById(ID id)	"이 ID를 가진 엔티티를 삭제해줘!"
	delete(S entity)	"이 엔티티 객체 자체를 삭제해줘!"
	deleteAll()	"해당 타입의 모든 엔티티를 삭제해줘! (주의해서 사용해야 합니다!)"
	deleteAll(Iterable<? extends S> entities)	"이 목록에 있는 엔티티들만 골라서 삭제해줘!"

Sheets로 내보내기

• S는 엔티티 타입을, ID는 해당 엔티티의 ID 타입을 의미합니다.

한 단계 더: PagingAndSortingRepository 📈📄

만약 다루어야 할 데이터가 수천, 수만 건이라면 한 번에 모든 데이터를 가져와 화면에 보여주는 것은 비효율적입니다. 마치 두꺼운 백과사전을 한 페이지씩 넘겨보거나, 원하는 내용을 찾기 위해 특정 순서로 정렬하는 것과 같은 기능이 필요하죠.

PagingAndSortingRepository 는 CrudRepository의 기능을 모두 가지면서, 추가적으로 다음과 같은 유용한 기능을 제공하는 인터페이스입니다.

• 페이징 (Paging): 대량의 데이터를 여러 페이지로 나누어 조회하는 기능 (예: 10개씩 끊어서 1페이지, 2페이지 보기)
• 정렬 (Sorting): 데이터를 특정 기준(예: 작성일 순, 이름 순)으로 정렬하여 조회하는 기능

PagingAndSortingRepository는 CrudRepository를 상속(확장) 하기 때문에, CrudRepository의 모든 메서드를 사용할 수 있을 뿐만 아니라 페이징과 정렬 관련 메서드도 추가로 사용할 수 있습니다.

Java

 

import org.springframework.data.repository.PagingAndSortingRepository;

// Board 엔티티를 다루고 ID는 Long 타입이며, 페이징과 정렬 기능도 사용한다.
public interface BoardPagingRepository extends PagingAndSortingRepository<Board, Long> {
    // CrudRepository의 메서드 + 페이징/정렬 관련 메서드 사용 가능!
}

---

✍️ 3. 게시판 예제 - Board 클래스

이제 Board 엔티티와 BoardRepository를 사용하여 실제 데이터베이스 작업을 어떻게 하는지 테스트 코드를 통해 단계별로 살펴보겠습니다.

1. Board.java (게시글 정보를 담는 엔티티 클래스)

먼저, 데이터베이스 테이블과 매핑될 Board 클래스(엔티티)를 정의합니다.

import jakarta.persistence.Entity; // 또는 javax.persistence.*;
import jakarta.persistence.Id;
import jakarta.persistence.Temporal;
import jakarta.persistence.TemporalType;
import java.util.Date;

@Entity // 이 클래스가 데이터베이스 테이블과 연결될 엔티티임을 나타냅니다.
public class Board {
    @Id // bno 필드가 이 엔티티의 고유 식별자(PK)임을 나타냅니다.
//    @GeneratedValue // ID 자동 생성 기능을 사용하려면 주석을 해제하세요.
    private Long bno; // 게시물 번호

    private String title;   // 제목
    private String writer;  // 작성자
    private String content; // 내용
    private Long viewCnt;   // 조회수

    @Temporal(value= TemporalType.DATE) // 날짜 정보만 저장 (시간 제외)
    private Date inDate;    // 작성일
    @Temporal(value= TemporalType.DATE)
    private Date upDate;    // 수정일

    // toString(), Getters, Setters ...
    // (제공해주신 코드와 동일합니다)
}

• @Entity: 이 Board 클래스가 데이터베이스의 특정 테이블에 대응되는 '실체'임을 JPA에게 알려줍니다.
• @Id: bno 필드가 각 게시글을 유일하게 구분하는 기본 키(Primary Key)임을 명시합니다.
• @Temporal: Date 타입 필드를 데이터베이스에 어떤 형식(날짜, 시간, 날짜+시간)으로 저장할지 지정합니다.

 

---

💾 4. BoardRepository 인터페이스

 

앞서 본 것처럼 매우 간단하게 정의합니다.

import org.springframework.data.repository.CrudRepository;

public interface BoardRepository extends CrudRepository<Board, Long> {
    // 현재는 기본 CRUD 기능만 사용하므로 추가 메서드 정의는 없습니다.
}

이렇게 한 줄만 작성해도,
save, findById, deleteById, findAll 등 기본 기능이 자동으로 생깁니다!

---

✅ 5. 기능별 테스트 코드 따라해보기!

이제 BoardRepository가 제대로 작동하는지 JUnit 테스트를 통해 확인해봅니다.

import org.junit.jupiter.api.MethodOrderer;
import org.junit.jupiter.api.Order;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.TestMethodOrder;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import java.util.Date;
import static org.junit.jupiter.api.Assertions.assertTrue; // 테스트 결과 확인용

@SpringBootTest // 스프링 부트 환경에서 테스트를 실행합니다.
@TestMethodOrder(MethodOrderer.OrderAnnotation.class) // @Order 어노테이션 순서대로 테스트 실행
class BoardRepositoryTest {

    @Autowired // 스프링 컨테이너가 BoardRepository 구현체를 자동으로 주입해줍니다.
    private BoardRepository boardRepository;

    @Test
    @Order(1) // 첫 번째로 실행될 테스트: 데이터 삽입
    public void insertTest() {
        System.out.println("데이터 삽입 테스트 시작...");
        Board board = new Board();      // 새로운 Board 객체 생성
        board.setBno(1L);               // ID를 직접 설정 (자동 생성을 사용하지 않을 경우)
        board.setTitle("첫 번째 게시글");
        board.setContent("Spring Data JPA 테스트 중입니다.");
        board.setWriter("개발자A");
        board.setViewCnt(0L);
        board.setInDate(new Date());
        board.setUpDate(new Date());

        boardRepository.save(board);    // CrudRepository의 save 메서드로 데이터 저장!
        System.out.println("ID 1번 게시글 저장 완료.");
    }

    @Test
    @Order(2) // 두 번째로 실행될 테스트: 데이터 조회
    public void selectTest() {
        System.out.println("\n데이터 조회 테스트 시작...");
        // ID가 1인 Board를 조회. orElse(null)은 해당 ID의 데이터가 없으면 null을 반환.
        Board board = boardRepository.findById(1L).orElse(null);
        System.out.println("조회된 게시글: " + board);
        assertTrue(board != null, "1번 게시글이 조회되어야 합니다."); // board가 null이 아니면 테스트 성공
    }

    @Test
    @Order(3) // 세 번째로 실행될 테스트: 데이터 수정
    public void updateTest() {
        System.out.println("\n데이터 수정 테스트 시작...");
        Board board = boardRepository.findById(1L).orElse(null);
        assertTrue(board != null, "수정할 1번 게시글이 존재해야 합니다.");

        board.setTitle("제목 수정됨 - Spring Data JPA"); // 제목 수정
        boardRepository.save(board); // 다시 save 메서드 호출. ID(bno)가 존재하므로 수정(UPDATE)됨.

        Board updatedBoard = boardRepository.findById(1L).orElse(null);
        System.out.println("수정 후 조회된 게시글: " + updatedBoard);
        assertTrue(updatedBoard != null && "제목 수정됨 - Spring Data JPA".equals(updatedBoard.getTitle()), "제목이 성공적으로 수정되어야 합니다.");
        System.out.println("게시글 수정 완료.");
    }

    @Test
    @Order(4) // 네 번째로 실행될 테스트: 데이터 삭제
    public void deleteTest() {
        System.out.println("\n데이터 삭제 테스트 시작...");
        boardRepository.deleteById(1L); // ID가 1인 Board 삭제

        Board board = boardRepository.findById(1L).orElse(null); // 삭제 후 다시 조회
        System.out.println("삭제 후 조회된 게시글: " + board);
        assertTrue(board == null, "1번 게시글이 성공적으로 삭제되어 null이어야 합니다."); // board가 null이면 테스트 성공
        System.out.println("게시글 삭제 완료.");
    }
}

• @SpringBootTest: 테스트 시 실제 스프링 애플리케이션 컨텍스트를 로드하여 통합 테스트를 진행합니다.
• @Autowired: BoardRepository 타입의 빈(Spring Data JPA가 자동으로 생성한 구현체)을 스프링이 찾아서 주입해줍니다.
• @Order(숫자): 테스트 메서드의 실행 순서를 지정합니다. 데이터의 상태에 의존적인 CRUD 테스트에서는 순서가 중요합니다.
• save() 메서드의 지능적인 동작: insertTest에서는 ID가 없는 새로운 Board 객체를 save() 했으므로 데이터베이스에 새로운 행이 삽입(INSERT)됩니다. 반면, updateTest에서는 findById()로 기존 데이터를 가져와 수정한 후 save()를 호출했습니다. 이때 Board 객체는 이미 ID(bno)를 가지고 있고, 이 ID가 데이터베이스에 존재하므로 Spring Data JPA는 이를 감지하여 새로운 행을 삽입하는 대신 기존 행의 내용을 갱신(UPDATE)합니다.

---

📝 요약 정리

개념한 줄 요약

Spring Data	저장소 종류와 상관없이 똑같이 다루기
Spring Data JPA	JPA를 쉽게 쓰게 해주는 도구
CrudRepository	기본 저장/조회/수정/삭제 기능 제공
PagingAndSortingRepository	페이징과 정렬 기능까지 지원
save()	저장도 되고 수정도 됨
findById()	ID로 하나 조회
deleteById()	ID로 하나 삭제
findAll()	전체 조회

 

---

🎯 마무리

오늘은 Spring Data JPA가 무엇인지, 그리고 CrudRepository와 같은 편리한 인터페이스를 통해 얼마나 쉽게 데이터베이스 작업을 처리할 수 있는지 살펴보았습니다. 복잡한 SQL 문장이나 JPA의 내부 동작을 깊이 알지 못해도, Spring Data JPA가 제공하는 잘 정의된 메서드들을 활용하면 기본적인 데이터 관리는 정말 간편해집니다.