[Blog] 블로그 프로젝트 만들기 - 3 (레포지토리 만들기)

레포지토리(Repository)란?

• 레포지토리는 데이터베이스와 엔티티(데이터 클래스) 사이에서 데이터를 저장하고, 불러오고, 수정하고, 삭제하는 역할을 하는 도구이다.
• 예를 들어, "사용자" 데이터를 저장하고 싶다면, 레포지토리를 사용하여 "사용자"를 데이터베이스에 저장할 수 있다. 또는 저장된 "사용자" 데이터를 레포지토리를 통해 불러오거나 삭제할 수 있다.

 

 

JpaRepository란?

• 스프링에서 제공하는 JpaRepository는 우리가 따로 SQL(데이터베이스 쿼리)을 작성하지 않아도 데이터베이스와 쉽게 연결할 수 있도록 해주는 도구이다.
• JpaRepository는 우리가 자주 사용하는 기본 기능들을 미리 만들어 놓은 것이다. 예를 들어, 데이터 저장, 조회, 수정, 삭제 같은 작업을 쉽게 할 수 있게 도와준다.

 

 

장점 확인

• 간편한 사용: 복잡한 SQL을 쓰지 않고, 데이터를 쉽게 저장, 조회, 수정, 삭제할 수 있다.
• 확장 가능: 기본 기능 외에도 복잡한 쿼리나 검색 조건이 필요할 때는 쉽게 추가할 수 있다.

 

 

---

 

JpaRepository 계층 구조

1. Repository (최상위 인터페이스)
   • Repository<T, ID>는 가장 상위에 있는 마커 인터페이스로, 이 인터페이스 자체에는 메서드가 정의되어 있지 않지만, 스프링 데이터에서 모든 레포지토리 인터페이스의 루트가 된다.
   • 모든 스프링 데이터 JPA 레포지토리는 이 인터페이스를 상속받고 있다.
2. CrudRepository (기본 CRUD 기능 제공)
   • CrudRepository<T, ID>는 CRUD(Create, Read, Update, Delete) 작업을 위한 기본 메서드를 제공하는 인터페이스입니다. 여기에 정의된 메서드는 아래와 같다
     • save(S entity) – 데이터를 저장 또는 업데이트
     • findById(ID id) – 기본 키로 데이터를 조회
     • findAll() – 모든 데이터를 조회
     • deleteById(ID id) – 기본 키로 데이터를 삭제
     • count() – 전체 데이터의 수를 반환
3. PagingAndSortingRepository (페이징 및 정렬 기능 추가)
   • PagingAndSortingRepository<T, ID>는 페이징(Pagination)과 정렬(Sorting) 기능을 추가로 제공한다. 이 인터페이스는 CrudRepository를 확장하며, 페이징과 정렬에 관련된 메서드가 추가된다
     • findAll(Sort sort) – 데이터를 특정 정렬 기준으로 조회
     • findAll(Pageable pageable) – 데이터를 페이지 단위로 조회
4. JpaRepository (추가 JPA 관련 기능 제공)
   • JpaRepository<T, ID>는 PagingAndSortingRepository를 확장하며, JPA와 관련된 추가 기능을 제공한다. 예를 들어, 배치 저장, 플러시(flush), 데이터 삭제와 같은 JPA에서 자주 사용하는 기능이 추가된다
     • flush() – 영속성 컨텍스트의 변경 내용을 데이터베이스에 반영
     • saveAllAndFlush(Iterable<S> entities) – 여러 엔티티를 저장하고 바로 플러시
     • deleteAllInBatch() – 데이터를 일괄 삭제

 

 

 

 

마커 인터페이스란?

마커 인터페이스는 아무 메서드도 가지지 않는 인터페이스로, 단순히 특정 클래스가 해당 인터페이스를 구현했는지를 표시하기 위한 역할을 합니다.인터페이스에 아무런 기능이나 행동을 정의하지 않으면서, 그 인터페이스를 구현한 클래스가 특정 속성이나 능력을 가지고 있음을 나타냅니다.

 

 

 

 

(구현체는 스프링이 자동 생성) 동작 원리 알아 보기

우리가 작성한 PostRepository 인터페이스는 스프링 데이터 JPA에서 제공하는 JpaRepository를 상속받는 인터페이스이다. 이 경우, 따로 구현 클래스를 작성하지 않아도 스프링이 자동으로 구현체를 생성해 주고, 필요한 기능을 제공하게 된다. 즉, 기본적인 CRUD(Create, Read, Update, Delete) 작업을 스프링이 자동으로 처리해 준다.

 

JpaRepository 인터페이스를 상속받으면, 스프링은 자동으로 레포지토리의 구현체를 생성한다. 스프링이 런타임 시에 동적으로 이 인터페이스의 구현 클래스를 만들어주고, 이를 스프링의 빈(Bean)으로 등록한다. 그러면 우리는 이 레포지토리를 서비스나 컨트롤러에서 주입받아(DI) 사용할 수 있다.

 

예시코드

@Service
public class TempService {

    @Autowired
    private TempRepository tempRepository;  // 의존성 주입

    public void createPost(Article article) {
        tempRepository.save(article);  // 기본적인 저장 기능 사용
    }

    public Article getPost(Integer id) {
        return tempRepository.findById(id).orElse(null);  // 기본적인 조회 기능 사용
    }

    public void deletePost(Integer id) {
        tempRepository.deleteById(id);  // 기본적인 삭제 기능 사용
    }
}

 

 

---

 

 

PostRepository 에 사용

package com.example.demo._domain.blog.repository;

import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.stereotype.Repository;

import com.example.demo._domain.blog.entity.Article;

// C R D E 
// @Repository  <-- 생략 가능 왜?  상속한 녀석에게 어노테이션이 존재 한다. 
public interface PostRepository extends JpaRepository<Article, Integer> {
	// 기본적인 CRUD 기능을 자동을 제공 한다. 
	
	// 필요하다면 우리가 만들어 놓은 곳에 추가적인 쿼리나 메서드 정의 가능하다. 
}

 

 

 

문법 확인

JpaRepository<T, ID>

 

첫 번째 타입 (Article)

• 엔티티 클래스를 넣어야 한다. 이 클래스는 데이터베이스의 테이블과 연결되며, 데이터를 저장하거나 조회할 때 사용된다.
• 예를 들어, Article은 데이터베이스의 article 테이블과 연결되는 클래스이다.

두 번째 타입 (Integer)

• 기본 키(Primary Key)의 데이터 타입을 넣는다. 즉, 엔티티 클래스의 기본 키 필드(고유 ID)가 어떤 타입인지 지정한다.
• 여기서는 Integer 타입의 기본 키(예: id 필드)가 있다고 가정한다.

 

---

 

중간 핵심 개념 정리

ORM(Object-Relational Mapping)

• 객체와 데이터베이스 간의 연결을 통해, 객체지향적으로 데이터베이스를 다룰 수 있도록 하는 프로그래밍 기법이다. ORM을 사용하면 SQL을 직접 작성하지 않고도 객체를 통해 데이터베이스를 쉽게 다룰 수 있다.

JPA(Java Persistence API)

• 자바에서 관계형 데이터베이스와 상호작용하는 방법을 정의한 인터페이스이다. JPA는 데이터베이스와 객체 간의 매핑을 관리하며, 표준화된 API를 제공한다.

엔티티(Entity)

• 영속성(persistence)을 가진 객체를 의미하며, 데이터베이스의 테이블과 매핑된다.

엔티티 매니저(EntityManager)

• 엔티티를 관리하고 조회, 저장, 수정, 삭제와 같은 작업을 수행한다.

엔티티 매니저 팩토리(EntityManagerFactory)

•  엔티티 매니저를 생성하는 역할을 한다. 데이터베이스 연결을 설정하고, 엔티티 매니저를 생성하여 영속성 컨텍스트를 관리한다.

영속성 컨텍스트(Persistence Context)

• 엔티티를 1차 캐시에 저장하고, 쓰기 지연, 변경 감지, 지연 로딩 등의 기능을 제공하는 공간이다. 엔티티 매니저를 통해 관리된다.

엔티티의 상태

• 엔티티는 비영속(new), 영속(managed), 준영속(detached), 삭제(removed) 상태로 나뉘며, 엔티티 매니저의 동작에 따라 상태가 변한다.

하이버네이트(Hibernate)

• JPA의 대표적인 구현체로, 자바 언어를 위한 ORM 프레임워크이다. 하이버네이트는 JPA를 기반으로 다양한 기능을 추가하여 더 강력한 ORM 기능을 제공한다.

스프링 데이터 JPA

•  JPA를 더 쉽게 사용할 수 있도록 스프링에서 제공하는 모듈이다. 기본적인 CRUD 기능을 자동으로 제공하며, 복잡한 쿼리도 간단한 메서드 정의만으로 구현할 수 있도록 도와준다.