Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Latest commit

Β 

History

19 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Spring JPA ν•™μŠ΅ ν”„λ‘œμ νŠΈ

Spring Boot + JPAλ₯Ό ν™œμš©ν•œ μ‡Όν•‘λͺ° 도메인 μ‹€μŠ΅ ν”„λ‘œμ νŠΈμž…λ‹ˆλ‹€.
μ—”ν‹°ν‹° 섀계뢀터 API μ΅œμ ν™”κΉŒμ§€ JPA의 핡심 κ°œλ…λ“€μ„ λ‹¨κ³„λ³„λ‘œ ν•™μŠ΅ν•©λ‹ˆλ‹€.


기술 μŠ€νƒ

λΆ„λ₯˜ 기술
Framework Spring Boot 3.3.5
ORM Spring Data JPA (Hibernate)
Database H2 (In-memory)
View Thymeleaf
Build Gradle
Language Java 17
Utility Lombok

ν”„λ‘œμ νŠΈ ꡬ쑰

src/main/java/jpabook/jpashop/
β”œβ”€β”€ domain/              # JPA μ—”ν‹°ν‹° (도메인 λͺ¨λΈ)
β”‚   β”œβ”€β”€ item/            # Item 상속 계측 (Book, Album, Movie)
β”‚   β”œβ”€β”€ Address.java     # μž„λ² λ””λ“œ κ°’ νƒ€μž…
β”‚   β”œβ”€β”€ Member.java
β”‚   β”œβ”€β”€ Order.java
β”‚   β”œβ”€β”€ OrderItem.java
β”‚   β”œβ”€β”€ Delivery.java
β”‚   └── Category.java
β”œβ”€β”€ repository/          # 데이터 μ ‘κ·Ό 계측 (EntityManager 직접 μ‚¬μš©)
β”‚   └── order/query/     # 쑰회 μ „μš© DTO 쿼리 리포지토리
β”œβ”€β”€ service/             # λΉ„μ¦ˆλ‹ˆμŠ€ 둜직
β”œβ”€β”€ api/                 # REST API 컨트둀러
β”œβ”€β”€ controller/          # MVC μ›Ή 컨트둀러 (Thymeleaf)
└── exception/           # μ»€μŠ€ν…€ μ˜ˆμ™Έ

도메인 λͺ¨λΈ

Member 1 ──────────── N Order 1 ──── 1 Delivery
                            β”‚
                            N
                        OrderItem N ──── 1 Item (Book/Album/Movie)

Category N ──────────── N Item (자기 μ°Έμ‘° 계측 ꡬ쑰)

ν•™μŠ΅ λ‚΄μš©

1. μ—”ν‹°ν‹° λ§€ν•‘ 기초

  • @Entity, @Id, @GeneratedValue, @Column
  • @OneToMany, @ManyToOne, @OneToOne, @ManyToMany
  • @Embedded / @Embeddable β€” κ°’ νƒ€μž… (Address)
  • μ»¬λ ‰μ…˜ ν•„λ“œ 레벨 μ΄ˆκΈ°ν™” ꢌμž₯ 이유 (Hibernate λ‚΄λΆ€ ν”„λ‘μ‹œ 보호)
// Bad: λ©”μ„œλ“œμ—μ„œ μƒμ„±ν•˜λ©΄ Hibernateκ°€ λ³€κ²½ 좔적을 놓칠 수 있음
// Good: ν•„λ“œμ—μ„œ μ΄ˆκΈ°ν™”
private List<Order> orders = new ArrayList<>();

2. 연관관계 λ§€ν•‘

μ–‘λ°©ν–₯ 연관관계 편의 λ©”μ„œλ“œ

μ–‘μͺ½μ„ λ™μ‹œμ— μ„ΈνŒ…ν•΄μ•Ό 객체 μƒνƒœ 일관성이 μœ μ§€λ©λ‹ˆλ‹€.

// Order.java
public void setMember(Member member) {
    this.member = member;
    member.getOrders().add(this);
}

μ§€μ—° λ‘œλ”© (LAZY) κΈ°λ³Έ 원칙

@XToOne κ΄€κ³„λŠ” 기본이 μ¦‰μ‹œ λ‘œλ”©(EAGER) β†’ λͺ¨λ‘ LAZY둜 λ³€κ²½ ν•„μš”.

@ManyToOne(fetch = FetchType.LAZY)
private Member member;

3. 상속 관계 λ§€ν•‘

단일 ν…Œμ΄λΈ” μ „λž΅ (SINGLE_TABLE) μ‚¬μš©:

@Entity
@Inheritance(strategy = InheritanceType.SINGLE_TABLE)
@DiscriminatorColumn(name = "dtype")
public abstract class Item { ... }

@Entity
@DiscriminatorValue("B")
public class Book extends Item { ... }
μ „λž΅ νŠΉμ§•
SINGLE_TABLE ν•œ ν…Œμ΄λΈ”μ— λͺ¨λ“  μ„œλΈŒνƒ€μž… μ €μž₯, 쑰회 μ„±λŠ₯ 우수
TABLE_PER_CLASS μ„œλΈŒνƒ€μž…λ§ˆλ‹€ ν…Œμ΄λΈ”, UNION 쿼리
JOINED μ •κ·œν™”λœ ν…Œμ΄λΈ”, 쑰인 ν•„μš”

4. μ˜μ†μ„± 전이 (Cascade)

Order μ €μž₯ ν•œ 번으둜 μ—°κ΄€ μ—”ν‹°ν‹°κΉŒμ§€ μžλ™ μ €μž₯λ©λ‹ˆλ‹€.

@OneToMany(mappedBy = "order", cascade = CascadeType.ALL)
private List<OrderItem> orderItems = new ArrayList<>();

생λͺ…μ£ΌκΈ°κ°€ μ™„μ „νžˆ 쒅속될 λ•Œλ§Œ μ‚¬μš© (Order β†’ OrderItem, Order β†’ Delivery)


5. κ°’ νƒ€μž… β€” @Embeddable

AddressλŠ” μ—”ν‹°ν‹°κ°€ μ•„λ‹Œ κ°’ νƒ€μž…μž…λ‹ˆλ‹€.

@Embeddable
@Getter // setter 없이 λΆˆλ³€ 객체둜 섀계
public class Address {
    private String city;
    private String street;
    private String zipcode;

    protected Address() {} // JPA κΈ°λ³Έ μƒμ„±μž
    public Address(String city, String street, String zipcode) { ... }
}

λΆˆλ³€ 객체둜 섀계해야 곡유 μ°Έμ‘° 버그λ₯Ό λ°©μ§€ν•  수 μžˆμŠ΅λ‹ˆλ‹€.


6. λΉ„μ¦ˆλ‹ˆμŠ€ 둜직의 μœ„μΉ˜ (도메인 λͺ¨λΈ νŒ¨ν„΄)

JPAλ₯Ό μ“Έ λ•ŒλŠ” μ—”ν‹°ν‹° μžμ‹ μ΄ λΉ„μ¦ˆλ‹ˆμŠ€ λ‘œμ§μ„ κ°–λŠ” 것이 μžμ—°μŠ€λŸ½μŠ΅λ‹ˆλ‹€.

// Item.java β€” 재고 관리 둜직
public void removeStock(int quantity) {
    int restStock = this.stockQuantity - quantity;
    if (restStock < 0) throw new NotEnoughStockException("재고 λΆ€μ‘±");
    this.stockQuantity = restStock;
}

// Order.java β€” μ£Όλ¬Έ μ·¨μ†Œ 둜직
public void cancel() {
    if (delivery.getStatus() == DeliveryStatus.COMP)
        throw new IllegalStateException("이미 배솑 μ™„λ£Œλœ μƒν’ˆμ€ μ·¨μ†Œ λΆˆκ°€");
    this.setStatus(OrderStatus.CANCEL);
    for (OrderItem item : orderItems) item.cancel();
}

7. JPQL & 동적 쿼리

String 방식 (λ‹¨μˆœν•˜μ§€λ§Œ 였λ₯˜ μœ„ν—˜)

String jpql = "select o from Order o join o.member m";
if (StringUtils.hasText(condition.getMemberName()))
    jpql += " where m.name like :name";

Criteria API 방식 (νƒ€μž… μ•ˆμ „)

CriteriaBuilder cb = em.getCriteriaBuilder();
CriteriaQuery<Order> cq = cb.createQuery(Order.class);
Root<Order> o = cq.from(Order.class);
List<Predicate> criteria = new ArrayList<>();
if (StringUtils.hasText(orderSearch.getMemberName())) {
    criteria.add(cb.like(m.get("name"), "%" + orderSearch.getMemberName() + "%"));
}
cq.where(cb.and(criteria.toArray(new Predicate[0])));

μ‹€λ¬΄μ—μ„œλŠ” QueryDSL μ‚¬μš©μ„ ꢌμž₯ν•©λ‹ˆλ‹€.


8. N+1 문제 ν•΄κ²° μ „λž΅

문제 상황

Order 10건 쑰회 μ‹œ β†’ member 10번 + delivery 10번 = 총 21쿼리 λ°œμƒ

// N+1 문제 λ°œμƒ μ½”λ“œ
List<Order> orders = orderRepository.findAll(); // 쿼리 1번
orders.forEach(o -> o.getMember().getName());   // LAZY λ‘œλ”© N번

ν•΄κ²° 방법 비ꡐ

방법 쿼리 수 νŽ˜μ΄μ§• κ°€λŠ₯ μ„€λͺ…
fetch join (ToOne) 1 O join fetch o.member
fetch join (μ»¬λ ‰μ…˜) 1 X DISTINCT ν•„μš”, νŽ˜μ΄μ§• λΆˆκ°€
batch_fetch_size 1+1 O μΆ”μ²œ: ToOne은 fetch join, μ»¬λ ‰μ…˜μ€ batch
DTO 직접 쑰회 (IN절) 1+1 O μ„±λŠ₯ μ΅œμš°μ„  μ‹œ μ‚¬μš©

Fetch Join (ToOne 관계)

// OrderRepository.java
"select o from Order o" +
" join fetch o.member m" +
" join fetch o.delivery d"

Batch Fetch Size (μ»¬λ ‰μ…˜ + νŽ˜μ΄μ§•)

# application.yml
spring.jpa.properties.hibernate.default_batch_fetch_size: 100

μ»¬λ ‰μ…˜ 쑰회 μ‹œ WHERE id IN (?, ?, ...) λ°©μ‹μœΌλ‘œ ν•œ λ²ˆμ— λ‘œλ”©ν•©λ‹ˆλ‹€.


9. API 섀계 β€” μ—”ν‹°ν‹° 직접 λ…ΈμΆœ vs DTO

Bad: μ—”ν‹°ν‹° 직접 λ°˜ν™˜

// μ—”ν‹°ν‹° λ³€κ²½ μ‹œ API μŠ€νŽ™μ΄ λ°”λ€ŒλŠ” 문제 λ°œμƒ
@GetMapping("/api/v1/members")
public List<Member> membersV1() {
    return memberService.findMembers();
}

Good: DTO둜 감싸기

@GetMapping("/api/v2/members")
public Result membersV2() {
    List<MemberDto> collect = memberService.findMembers().stream()
            .map(m -> new MemberDto(m.getName()))
            .collect(toList());
    return new Result(collect.size(), collect); // λ°°μ—΄ λŒ€μ‹  객체둜 감싸야 API μœ μ—°μ„± 확보
}

@Data
@AllArgsConstructor
static class Result<T> {
    private int count;
    private T data;
}

10. 쿼리 μ΅œμ ν™” 단계 (OrderQueryRepository)

쿼리 μ΅œμ ν™”λŠ” ν•„μš”ν•œ 만큼만 λ‹¨κ³„μ μœΌλ‘œ μ μš©ν•©λ‹ˆλ‹€.

μ—”ν‹°ν‹° 쑰회 방식 (ꢌμž₯ μˆœμ„œ)
──────────────────────────────────────────────────────
1단계: μ—”ν‹°ν‹° 쑰회 ν›„ DTO λ³€ν™˜ (κ°€μž₯ μœ μ§€λ³΄μˆ˜ μ’‹μŒ)
2단계: ν•„μš” μ‹œ fetch join으둜 μ„±λŠ₯ μ΅œμ ν™”
3단계: νŽ˜μ΄μ§•μ΄ ν•„μš”ν•˜λ©΄ batch_fetch_size 적용

DTO 직접 쑰회 방식 (μ„±λŠ₯ κ·Ήν•œ μ΅œμ ν™” μ‹œ)
──────────────────────────────────────────────────────
4단계: JPAμ—μ„œ DTO 직접 쑰회 (N+1 λ°œμƒ)
5단계: IN 절둜 μ»¬λ ‰μ…˜ 일괄 쑰회 (쿼리 1+1)
6단계: 단일 쿼리둜 flat 쑰회 ν›„ Javaμ—μ„œ κ·Έλ£Ήν•‘ (νŽ˜μ΄μ§• λΆˆκ°€)
버전 방식 쿼리 수 νŽ˜μ΄μ§•
V4 DTO 쑰회 N+1 1 + N O
V5 DTO 쑰회 IN절 μ΅œμ ν™” 1 + 1 O
V6 DTO 단일 flat 쿼리 1 X

νŠΈλžœμž­μ…˜ 관리

@Service
@Transactional(readOnly = true) // κΈ°λ³Έ: 읽기 μ „μš© (μ„±λŠ₯ μ΅œμ ν™”)
public class MemberService {

    @Transactional // μ“°κΈ° μž‘μ—…μ€ 별도 νŠΈλžœμž­μ…˜
    public Long join(Member member) { ... }
}

더티 체킹 (λ³€κ²½ 감지)
νŠΈλžœμž­μ…˜ μ•ˆμ—μ„œ μ—”ν‹°ν‹° ν•„λ“œλ₯Ό μˆ˜μ •ν•˜λ©΄ merge() 없이도 μžλ™ UPDATEλ©λ‹ˆλ‹€.

@Transactional
public void update(Long id, String name) {
    Member member = memberRepository.find(id);
    member.setName(name); // flush μ‹œμ μ— μžλ™μœΌλ‘œ UPDATE SQL μ‹€ν–‰
}

μ‹€ν–‰ 방법

cd spring-jpa
./gradlew bootRun

기동 μ‹œ initDb.java의 @PostConstruct둜 μƒ˜ν”Œ 데이터(νšŒμ› 2λͺ…, μ£Όλ¬Έ 2건)κ°€ μžλ™ μ‚½μž…λ©λ‹ˆλ‹€.


μ£Όμš” API μ—”λ“œν¬μΈνŠΈ

Method URL μ„€λͺ…
GET /api/v1/members νšŒμ› 쑰회 (μ—”ν‹°ν‹° 직접 λ…ΈμΆœ β€” ν•™μŠ΅μš©)
GET /api/v2/members νšŒμ› 쑰회 (DTO λ°˜ν™˜ β€” ꢌμž₯)
POST /api/v1/members νšŒμ› 등둝 (μ—”ν‹°ν‹° 직접 λ°›μŒ β€” ν•™μŠ΅μš©)
POST /api/v2/members νšŒμ› 등둝 (DTO β€” ꢌμž₯)
PUT /api/v2/members/{id} νšŒμ› μˆ˜μ • (더티 체킹)
GET /api/v1/simple-orders μ£Όλ¬Έ λ‹¨μˆœ 쑰회 (LAZY κ°•μ œ μ΄ˆκΈ°ν™”)
GET /api/v3/simple-orders 주문 쑰회 (fetch join)
GET /api/v3.1/orders μ£Όλ¬Έ+μ»¬λ ‰μ…˜ (fetch join + batch, νŽ˜μ΄μ§• O)
GET /api/v4/orders 주문 DTO 쑰회 (N+1)
GET /api/v5/orders μ£Όλ¬Έ DTO IN절 μ΅œμ ν™”
GET /api/v6/orders μ£Όλ¬Έ 단일 flat 쿼리

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages