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 (μκΈ° μ°Έμ‘° κ³μΈ΅ ꡬ쑰)
@Entity,@Id,@GeneratedValue,@Column@OneToMany,@ManyToOne,@OneToOne,@ManyToMany@Embedded/@Embeddableβ κ° νμ (Address)- 컬λ μ νλ λ 벨 μ΄κΈ°ν κΆμ₯ μ΄μ (Hibernate λ΄λΆ νλ‘μ 보νΈ)
// Bad: λ©μλμμ μμ±νλ©΄ Hibernateκ° λ³κ²½ μΆμ μ λμΉ μ μμ
// Good: νλμμ μ΄κΈ°ν
private List<Order> orders = new ArrayList<>();μμͺ½μ λμμ μΈν ν΄μΌ κ°μ²΄ μν μΌκ΄μ±μ΄ μ μ§λ©λλ€.
// Order.java
public void setMember(Member member) {
this.member = member;
member.getOrders().add(this);
}@XToOne κ΄κ³λ κΈ°λ³Έμ΄ μ¦μ λ‘λ©(EAGER) β λͺ¨λ LAZYλ‘ λ³κ²½ νμ.
@ManyToOne(fetch = FetchType.LAZY)
private Member member;λ¨μΌ ν
μ΄λΈ μ λ΅ (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 |
μ κ·νλ ν μ΄λΈ, μ‘°μΈ νμ |
Order μ μ₯ ν λ²μΌλ‘ μ°κ΄ μν°ν°κΉμ§ μλ μ μ₯λ©λλ€.
@OneToMany(mappedBy = "order", cascade = CascadeType.ALL)
private List<OrderItem> orderItems = new ArrayList<>();μλͺ μ£ΌκΈ°κ° μμ ν μ’ μλ λλ§ μ¬μ© (Order β OrderItem, Order β Delivery)
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) { ... }
}λΆλ³ κ°μ²΄λ‘ μ€κ³ν΄μΌ 곡μ μ°Έμ‘° λ²κ·Έλ₯Ό λ°©μ§ν μ μμ΅λλ€.
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();
}String jpql = "select o from Order o join o.member m";
if (StringUtils.hasText(condition.getMemberName()))
jpql += " where m.name like :name";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 μ¬μ©μ κΆμ₯ν©λλ€.
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 | μ±λ₯ μ΅μ°μ μ μ¬μ© |
// OrderRepository.java
"select o from Order o" +
" join fetch o.member m" +
" join fetch o.delivery d"# application.yml
spring.jpa.properties.hibernate.default_batch_fetch_size: 100컬λ μ
μ‘°ν μ WHERE id IN (?, ?, ...) λ°©μμΌλ‘ ν λ²μ λ‘λ©ν©λλ€.
// μν°ν° λ³κ²½ μ API μ€νμ΄ λ°λλ λ¬Έμ λ°μ
@GetMapping("/api/v1/members")
public List<Member> membersV1() {
return memberService.findMembers();
}@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;
}쿼리 μ΅μ νλ νμν λ§νΌλ§ λ¨κ³μ μΌλ‘ μ μ©ν©λλ€.
μν°ν° μ‘°ν λ°©μ (κΆμ₯ μμ)
ββββββββββββββββββββββββββββββββββββββββββββββββββββββ
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- μ± μ€ν: http://localhost:8080
- H2 μ½μ: http://localhost:8080/h2-console
- JDBC URL:
jdbc:h2:mem:testdb
- JDBC URL:
κΈ°λ μ
initDb.javaμ@PostConstructλ‘ μν λ°μ΄ν°(νμ 2λͺ , μ£Όλ¬Έ 2건)κ° μλ μ½μ λ©λλ€.
| 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 쿼리 |