📌 [Spring Boot JPA 기초 정리 + 실습 예제]

📅 날짜

2025년 5월 7일

📝 학습 내용

1️⃣ JPA란?

• JPA(Java Persistence API)는 자바 ORM(Object-Relational Mapping) 기술 표준이다.
• 자바 객체와 관계형 데이터베이스 테이블 간의 매핑을 처리한다.
• SQL을 직접 작성하지 않고도 데이터 접근/수정이 가능하며, 유지보수성과 생산성을 높여준다.
• 구현체로는 Hibernate, EclipseLink 등이 있으며, Spring Boot에서는 Hibernate를 기본으로 사용한다.

---

2️⃣ Spring Boot JPA 의존성

implementation 'org.springframework.boot:spring-boot-starter-data-jpa'

• 내부적으로 Hibernate가 기본 구현체로 적용됨
• Spring Data JPA 기능도 포함되어 있어 Repository 인터페이스만 정의해도 CRUD 자동 처리 가능

---

3️⃣ application.properties 설정

spring.application.name=demo

# Server
server.port=8090

# Encoding 설정
spring.servlet.filter.encoding.filter-name=encodingFilter
spring.servlet.filter.encoding.filter-class=org.springframework.web.filter.CharacterEncodingFilter
spring.servlet.filter.encoding.init-param.encoding=UTF-8
spring.servlet.filter.encoding.init-param.forceEncoding=true
spring.servlet.filter.encoding.url-pattern=/*

# JSP 설정
spring.mvc.view.prefix=/WEB-INF/views/
spring.mvc.view.suffix=.jsp
server.servlet.jsp.init-parameters.development=true

# (예시) 데이터소스 설정 - MySQL
#spring.datasource.url=jdbc:mysql://localhost:3306/testdb
#spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
#spring.datasource.username=root
#spring.datasource.password=1234

# Hibernate 설정
spring.jpa.hibernate.ddl-auto=update
spring.jpa.properties.hibernate.format_sql=true
spring.jpa.properties.hibernate.jdbc.batch_size=1000
spring.jpa.properties.hibernate.order_inserts=true
spring.jpa.properties.hibernate.order_updates=true
spring.jpa.properties.hibernate.jdbc.batch_versioned_data=true
spring.sql.init.mode=always
spring.jpa.defer-datasource-initialization=true

---

4️⃣ Book 엔티티

package com.example.demo.domain.entity;

import jakarta.persistence.*;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;

@Entity
@Table(name="book")
@Data
@NoArgsConstructor
@AllArgsConstructor
@Builder
public class Book {
    @Id
//    @GeneratedValue(strategy = GenerationType.IDENTITY)
    // 👉 기본 키를 DB에서 자동으로 생성 (MySQL의 auto_increment 역할)
    @Column(name="bookcode")
    private Long bookCode; // 카멜 표기법 → DB에서는 book_code로 변환됨

    @Column(name="bookname")
    private String bookName;

    private String publisher;
    private String isbn;
}

---

5️⃣ User 엔티티

package com.example.demo.domain.entity;

import jakarta.persistence.Column;
import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import jakarta.persistence.Table;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;

@Entity
@Table(name = "user")
@Data
@NoArgsConstructor
@AllArgsConstructor
@Builder
public class User {
    @Id
    @Column(length = 100) // varchar(100)
    private String username;

    @Column(length = 255, nullable = false)
    private String password;

    @Column(length = 255)
    private String role; // 예: "USER", "ADMIN"
}

---

6️⃣ BookRepositoryTest 클래스 (CRUD 테스트)

package com.example.demo.domain.repository;

import com.example.demo.domain.entity.Book;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;

@SpringBootTest
class BookRepositoryTest {

    @Autowired
    private BookRepository bookRepository;

    @Test
    public void t1() throws Exception {
        // INSERT 예제
//        Book book = Book.builder()
//                .bookCode(1111L)
//                .bookName("이것이 리눅스다")
//                .publisher("한빛미디어")
//                .isbn("1111-1111")
//                .build();
//        bookRepository.save(book); // 저장

        // UPDATE 예제
//        book.setBookName("JAVA의 정석");
//        book.setPublisher("이지퍼블리싱");
//        book.setIsbn("1111-22-3333");
//        bookRepository.save(book); // 동일한 ID면 update 처리됨

        // DELETE 예제
        bookRepository.deleteById(1111L); // 해당 bookCode로 삭제
    }
}

---

🔥 정리

• JPA는 자바 ORM 기술의 표준으로, 객체 지향적으로 데이터를 다룰 수 있게 해준다.
• Hibernate 설정을 통해 자동 스키마 생성, SQL 출력, 배치 성능 최적화 등을 조정할 수 있다.
• Spring Boot와 함께 사용하면 설정과 사용이 매우 간편하다.
• Entity 클래스는 @Entity, @Id, @Column, @Builder 등으로 정의되며, JPA가 이를 기반으로 SQL을 생성해준다.
• 테스트 코드에서는 .save(), .deleteById() 등을 사용해 CRUD 동작을 검증할 수 있다.

---

🔗 참고 자료

• Spring Data JPA 공식 문서
• Hibernate ORM 공식 문서

---