#28 책 생성 API - INSERT

- 다음 글 부터는 먼저 코드를 작성한 다음에 강의를 들어보자

---

● 도서관에 책을 등록하는 기능

[API 스펙]
- HTTP Method : POST
- HTTP Path : /book
- HTTP Body(JSON) : {"name" : String // 책 이름}  → name은 필수
- 결과 반환 X, HTTP Code 200이면 OK

- 이러한 구조로 만들어야 한다.

인프런 - 자바와 스프링 부트로 생애 최초 서버 만들기, 누구나 쉽게 개발부터 배포까지!(최태현)

 

1. Book Table

CREATE TABLE BOOK (
   ID     BIGINT       AUTO_INCREMENT,
   NAME   VARCHAR(255) NOT NULL,
   PRIMARY KEY(ID)
);

- VARCHAR(255)라고 설정한 이유

1. JPA를 사용할 때 @Column Annotation의 length 속성의 기본값이 255이다.  → @Column Annotation에서 length 속성을 생략할려고 (255)로 설정한 것이다.

2. 문자열 필드의 경우 최적화를 해야 하는 CASE가 아니라면 조금 여유롭게 설정하는 것이 좋다.

 

2. Book 객체

package com.group.libraryapp.domain.book;

import javax.persistence.*;

@Entity
public class Book {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id = null;

    @Column(nullable = false, name = "name")
    private String name;

    // JPA Entity는 기본 생성자가 하나 필요하다.
    protected Book() {}

    public Book(String name) {
        // name은 필수값이다.
        if(name == null || name.isBlank()) throw new IllegalArgumentException(String.format("잘못된 name(%s)이 들어왔습니다.", name));
        this.name = name;
    }
}

 

3. BookRepository

package com.group.libraryapp.domain.book;

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

public interface BookRepository extends JpaRepository<Book, Long> {

}

cf)

- 강의를 듣다보니 BookRepository와 UserRepository를 왜 하필 domain package 아래에 생성하는지 궁금했다. 그냥 Repository package 아래에 생성하면 통일성이 있는데 강사는 왜 그런 것일까?

- 아니나 다를까 이미 다른 사람이 이에 대해서 물어봤다.

- 강사의 답변을 보니 이건 그냥 강사 개인이 이번 Spring 강의에서 만드는 프로젝트는 이러한 구조가 더 적합한 것 같아서 그렇게 구성한 것이라고 한다.

- 패키지를 구성하는 방법에는 정답이 없고 상황에 따라 매번 달라진다.

 

4. DTO

- DTO는 HTTP Body 스펙을 보고 그에 맞게 생성하면 된다.

HTTP Body(JSON) : {"name" : String // 책 이름}  → name은 필수

package com.group.libraryapp.dto.book.request;

public class BookCreateRequest {
    private String name;

    public String getName() {
        return this.name;
    }
}

BookCreateRequest class 위치

 

5. Controller & Service

[Controller]

package com.group.libraryapp.controller.book;

import com.group.libraryapp.dto.book.request.BookCreateRequest;
import com.group.libraryapp.service.book.BookService;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class BookController {

    private final BookService bookService;

    // 생성자를 만들어 Spring bean을 주입받는다.
    public BookController(BookService bookService) {
        this.bookService = bookService;
    }

    @PostMapping("/book")
    public void saveBook(@RequestBody BookCreateRequest request) {
        bookService.saveBook(request);
    }
}

[Service]

package com.group.libraryapp.service.book;

import com.group.libraryapp.domain.book.Book;
import com.group.libraryapp.domain.user.BookRepository;
import com.group.libraryapp.dto.book.request.BookCreateRequest;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;

@Service
public class BookService {
    private final BookRepository bookRepository;

    // 생성자를 만들어 Spring bean을 주입받는다.
    public BookService(BookRepository bookRepository) {
        this.bookRepository = bookRepository;
    }

    @Transactional
    public void saveBook(BookCreateRequest request) {
        bookRepository.save(new Book(request.getName()));
    }
}

cf)

2023.08.04 - [Spring] - #7 DTO와 VO(Entity는 링크한 글을 보자)

#7 DTO와 VO(Entity는 링크한 글을 보자)

---

● 테스트

인텔리제이 콘솔에는 이렇게 찍혔다.