[ Spring Boot ] 게시판 CRUD 만들기 : DTO를 데이터베이스에 저장하기

받은 데이터를 데이터베이스에 저장해보자

📌 데이터베이스와 JPA

데이터베이스

• DB
• 데이터를 관리하는 창고
• 데이터를 행과 열로 구성된 테이블에 저장해 관리한다.
• DB 프로그램 : MySQL, 오라클, 마리아DB, H2 DB 등
• SQL ( Structured Query Language ) 언어를 사용한다.

자바로 DB에 명령을 어떻게 내리나?

자바 언어 ( JPA : Java Persistence API ) 로 DB에 명령을 내린다. 데이터를 객체 지향적으로 관리할 수 있게 해 준다.

 

🤍 JPA의 핵심 도구

• 엔티티 : 자바 객체를 DB가 이해할 수 있게 만든 것, 이를 기반으로 테이블이 만들어진다.
• 리파지터리 : 엔티티가 DB 속 테이블에 저장 및 관리될 수 있게 하는 인터페이스이다.

DTO로 받은 폼 데이터를 DB에 어떻게 저장하나?

1. DTO를 엔티티로 변환한다.
2. 리파지터리를 이용해 엔티티를 DB에 저장한다.

---

1. DTO를 엔티티로 변환하기

ArticleControlelr

package com.example.firstproject.controller;

import com.example.firstproject.dto.AritcleForm;
import com.example.firstproject.entity.Article;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;

@Controller //컨트롤러 선언.
public class ArticleController { //URL 요청 접수.
    @GetMapping("/articles/new") //메서드 생성 및 반환값 작성.
    public String newArticleForm() {
        return "articles/new";
    }


    @PostMapping("/articles/create") //뷰 페이지에서 폼 데이터를 post방식으로 전송 -> 컨트롤러에서 받을 때도 postmapping으로 받음.
    public String createArticle(AritcleForm form){ //폼 데이터를 DTO로 받기
        System.out.println("DTO 받기"+form.toString()); //DTO에 폼 데이터가 잘 담겼는지 확인

        //1.DTO를 엔티티로 변환
        Article article = form.toEntity();

        //2.리파지터리로 엔티티를 DB에 저장

        return "";
    }
}

//1.DTO를 엔티티로 변환

DTO를 엔티티로 변환하기 위해 form 객체의 toEntity() 메서드를 호출해서 그 반환값을 Artcle 타입의 article 엔티티에 저장한다.

DTO를 엔티티로 변환하려면 먼제 엔티티 클래스부터 만들어야 한다.

 

Aritcle

package com.example.firstproject.entity;

import jakarta.persistence.Column;
import jakarta.persistence.Entity;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.Id;

@Entity
public class Article {
    @Id //엔티티의 대푯값 지정.
    @GeneratedValue //자동 생성 기능 추가 (숫자가 자동으로 매겨짐)
    private Long id;

    @Column //title 필드 선언, DB 테이블의 title 열과 연결.
    private String title;

    @Column //content 필드 선언, DB 테이블의 content 열과 연결.
    private String content;
}

@Entity

• JPA에서 제공하는 어노테이션
• 이 어노테이션이 붙은 클래스를 기반으로 DB에 테이블이 생성 ( 테이블 이름은 클래스 이름과 동일하게 Article로 생성 )

@Column

• 필드가 DB 테이블의 각 열과 연결

@Id

• 엔티티 대푯값 설정
• Article 엔티티 중에 제목과 내용이 같은 것이 있더라고 대푯값 id로 다른 글임을 구분한다.

@GenerateValue

• 대푯값을 자동으로 생성 ex) 1,2,3...

Aritcle

package com.example.firstproject.entity;

import jakarta.persistence.Column;
import jakarta.persistence.Entity;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.Id;

@Entity
public class Article {
    @Id //엔티티의 대푯값 지정.
    @GeneratedValue //자동 생성 기능 추가 (숫자가 자동으로 매겨짐)
    private Long id;

    @Column //title 필드 선언, DB 테이블의 title 열과 연결.
    private String title;

    @Column //content 필드 선언, DB 테이블의 content 열과 연결.
    private String content;

    //Article 생성자 추가 (Article 객체의 생성 및 초기화를 위해)
    public Article(Long id, String title, String content) {
        this.id = id;
        this.title = title;
        this.content = content;
    }

    //toString() 메서드 추가
    @Override
    public String toString() {
        return "Article{" +
                "id=" + id +
                ", title='" + title + '\'' +
                ", content='" + content + '\'' +
                '}';
    }
}

 

toEntity() 메서드 추가하기

 

toEntity() 메서드 

• DTO인 form 객체를 엔티티 객체로 변환하는 역할

ArticleForm

package com.example.firstproject.dto;

import com.example.firstproject.entity.Article;

public class AritcleForm {
    private String title; //제목을 받을 필드.
    private String content; //내용을 받을 필드.

    //전송받은 제목과 내용을 필드에 저장하는 생성자 추가.
    public AritcleForm(String title, String content) {
        this.title = title;
        this.content = content;
    }

    //데이터를 잘 받았는지 확인할 toString() 메서드 추가.
    @Override
    public String toString() {
        return "AritcleForm{" +
                "title='" + title + '\'' +
                ", content='" + content + '\'' +
                '}';
    }

    //폼 데이터를 담은 DTO 객체를 엔티티로 변환.
    public Article toEntity() {
        return new Article(null,title,content);
    }
}

return new Article 전달값은 Article 클래스의 생성자 형식에 맞게 작성한다.

id,title,content를 매개변수로 받고 있으나 ArticleForm 객체에 id 정보는 없으므로 첫 번째 전달값은 null, 두 번째 전달값 title, 세 번째 전달값 content로 한다.

 

//2.리파지터리로 엔티티를 DB에 저장

 

ArticleControlelr

package com.example.firstproject.controller;

import com.example.firstproject.dto.AritcleForm;
import com.example.firstproject.entity.Article;
import com.example.firstproject.repository.ArticleRepository;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;

@Controller //컨트롤러 선언.
public class ArticleController { //URL 요청 접수.
    private ArticleRepository articleRepository; //객체 선언.

    @GetMapping("/articles/new") //메서드 생성 및 반환값 작성.
    public String newArticleForm() {
        return "articles/new";
    }


    @PostMapping("/articles/create") //뷰 페이지에서 폼 데이터를 post방식으로 전송 -> 컨트롤러에서 받을 때도 postmapping으로 받음.
    public String createArticle(AritcleForm form){ //폼 데이터를 DTO로 받기
        System.out.println("DTO 받기"+form.toString()); //DTO에 폼 데이터가 잘 담겼는지 확인

        //1.DTO를 엔티티로 변환
        Article article = form.toEntity();

        //2.리파지터리로 엔티티를 DB에 저장
        Article saved = articleRepository.save(article); //article 엔티티를 저장해 Saved 객체에 반환

        return "";
    }
}

ArticleRepository

package com.example.firstproject.repository;

import com.example.firstproject.entity.Article;
import org.springframework.data.repository.CrudRepository;

public interface ArticleRepository extends CrudRepository <Article,Long> {
}

리파지터리는 사용자가 직접 구현할 수도 있지만 JPA에서 제공하는 리파지터리 인터페이스를 활용해 만들 수 있다.

ArticleRepository 다음에 extends Crud...를 입력하면 펼침 목록이 나타나는데 그중에서 CrudRepository<T,ID>를 선택한다.

이는 CrudRepository라는 인터페이스를 상속받는 명령이다.

 

CrudRepository

• JPA에서 제공하는 인터페이스
• 엔티티를 관리(생성,조회,수정,삭제)할 수 있다.
• CrudRepository에 <>를 붙이고 그 안에 2개의 제네릭 요소를 받는다.
  • Article : 관리 대상 엔티티의 클래스 타입입니다. ex)Article
  • Long : 관리 대상 엔티티의 대푯값 타입 ex)Article.java 파일은 대푯값 타입이 id이다. id의 타입은 Long이므로 Long을 입력한다.

ArticleControlelr

package com.example.firstproject.controller;

import com.example.firstproject.dto.AritcleForm;
import com.example.firstproject.entity.Article;
import com.example.firstproject.repository.ArticleRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;

@Controller //컨트롤러 선언.
public class ArticleController { //URL 요청 접수.
    @Autowired //스프링 부트가 미리 생성해 놓은 리파지터리 객체 주입.
    private ArticleRepository articleRepository; //객체 선언.

    @GetMapping("/articles/new") //메서드 생성 및 반환값 작성.
    public String newArticleForm() {
        return "articles/new";
    }


    @PostMapping("/articles/create") //뷰 페이지에서 폼 데이터를 post방식으로 전송 -> 컨트롤러에서 받을 때도 postmapping으로 받음.
    public String createArticle(AritcleForm form){ //폼 데이터를 DTO로 받기
        System.out.println("DTO 받기"+form.toString()); //DTO에 폼 데이터가 잘 담겼는지 확인

        //1.DTO를 엔티티로 변환
        Article article = form.toEntity();

        //2.리파지터리로 엔티티를 DB에 저장
        Article saved = articleRepository.save(article); //article 엔티티를 저장해 Saved 객체에 반환

        return "";
    }
}

@Autowired

• 스프링 부트에서 제공하는 어노테이션
• 컨트롤러의 필드에 붙이면 스프링 부트가 만들어 놓은 객체를 가져와 주입한다.
• 의존성 주입 (DI, Dependency Injection)이라고 한다.

---

2.데이터 저장 확인하기

ArticleController

package com.example.firstproject.controller;

import com.example.firstproject.dto.AritcleForm;
import com.example.firstproject.entity.Article;
import com.example.firstproject.repository.ArticleRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;

@Controller //컨트롤러 선언.
public class ArticleController { //URL 요청 접수.
    @Autowired //스프링 부트가 미리 생성해 놓은 리파지터리 객체 주입.
    private ArticleRepository articleRepository; //객체 선언.

    @GetMapping("/articles/new") //메서드 생성 및 반환값 작성.
    public String newArticleForm() {
        return "articles/new";
    }


    @PostMapping("/articles/create") //뷰 페이지에서 폼 데이터를 post방식으로 전송 -> 컨트롤러에서 받을 때도 postmapping으로 받음.
    public String createArticle(AritcleForm form){ //폼 데이터를 DTO로 받기
        System.out.println("DTO 받기"+form.toString()); //DTO에 폼 데이터가 잘 담겼는지 확인

        //1.DTO를 엔티티로 변환
        Article article = form.toEntity();
        System.out.println(article.toString());

        //2.리파지터리로 엔티티를 DB에 저장
        Article saved = articleRepository.save(article); //article 엔티티를 저장해 Saved 객체에 반환
        System.out.println(article);

        return "";
    }
}

http://localhost:8080/articles/new 에 접속한다

1. 폼 데이터를 받는 객체인 DTO에 title,content가 저장된다.
2. DTO가 엔티티로 변환되어 id,title,content가 저장된다.
3. 리파지터리가 엔티티를 DB에 저장되어 saved라는 엔티티 변수에 반환한다. id는 자동으로 설정된 1을 출력한다.

---

- <도서> 코딩 자율학습 스프링 부트 3 자바 백엔드 개발 입문

https://product.kyobobook.co.kr/detail/S000202971420

코딩 자율학습 스프링 부트 3 자바 백엔드 개발 입문 | 홍팍 - 교보문고