[Springboot] 0부터 시작하는 스프링부트 도전기 #3. Create(엔티티로 DB 저장하기)

받은 데이터를 데이터베이스에 저장하는 방법을 알아보겠습니다. DB 프로그램으로는 MySQL, 오라클, 마리아 DB 등 여러가지가 있지만 이번 실습에서는 스프링부트 프로젝트 생성 시 받은 H2 DB를 사용하여 진행합니다.

 

JPA

Java Persistence API

 

DB는 SQL(Structured Query Language)를 사용합니다. 그래서 Java를 사용하여 직접 명령을 내리는 것이 불가능합니다. 이 때 JPA를 사용하여 DB에 Java를 사용하여 명령을 내릴 수 있습니다.

 

JPA는 자바 언어로 DB에 명령을 내리는 도구로, 데이터를 객체 지향적으로 관리할 수 있게 합니다.

 

JPA의 핵심 도구

엔티티

자바 객체를 DB가 이해할 수 있게 만든 것으로, 이를 기반으로 테이블을 생성한다.

 

리파지터리

엔티티가 DB 속 테이블에 저장 및  관리될 수 있게 하는 인터페이스

 

실습

JPA 기본 개념을 알았으니, 실습을 통해 DTO로 만든 폼 데이터를 DB에 저장하는 예제를 실습해보겠습니다.

 

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

ArticleController.java 파일에서 실습을 이어하겠습니다. 

 

DTO를 엔티티로 변환하기 위해서는 form 객체의 toEntity()라는 메서드를 호출하고, 그  반환값을 Article 타입의 article 엔티티에 저장합니다. 이 코드를 실행하기 위해서는 Article 클래스와 toEntity() 메서드를 만들어주어야 합니다.

 

💡DTO를 엔티티로 변환하기 위해서는 먼저 엔티티 클래스를 만들어야 한다.

 

빨간색으로 표시된 Article에 마우스를 올리고 alt + Enter 시 메뉴 선택하여 클래스 생성 가능

 

Article 클래스 만들기

Create Class Article 창에서, 패키지 생성 위치를 controller->entity로 수정 후, OK 버튼을 누르면 entity 패키지가 생성되고, 내부에 Article 클래스가 함께 만들어진 것을 확인할 수 있습니다.

entity 패키지와 Article 클래스 생성

 

Article 클래스 코드를 작성해줍니다.

 

1. Article 클래스가 엔티티임을 선언하기 위해 @Entity 어노테이션을 붙입니다.

2. title, content 필드를 선언하고, DB에서 인식할 수 있도록 @Column 어노테이션을 붙입니다. 

3. 엔티티의 대표값이 될 id를 선언하고, @Id 어노테이션을 붙입니다. @GeneratedValue 어노테이션을 사용하여 대푯값을 자동으로 생성하게 합니다. 대표값은 식별을 위해 사용합니다.

 

이처럼 코드를 작성하면, Entity의 id, title, content 필드가 DB의 각 열로 연결됩니다.

엔티티 클래스

 

4. Article 객체 생성 및 초기화를 위해 생성자를 추가합니다. content 필드 아래에 마우스 오른쪽 버튼 클릭 후, Generate->Constructor을 선택, id: Long, title: String, content: String을 모두 선택하여 코드를 자동으로 생성합니다.

5. 마우스 오른쪽 버튼 클릭 후, Generate->toString()을 선택하여 위와 동일한 항목들을 모두 선택한 후, 확인하여 toString 메서드도 추가해줍니다.

 

ArticleController로 돌아가서 보면, Article의 오류 표시가 사라진 것을 확인할 수 있습니다. 이제는 toEntity() 메서드를 만들어야 합니다.

 

toEntity() 메서드 만들기

toEntity() 메서드는 DTO인 form 객체를 엔티티 객체로 변환하는 역할을 합니다.

 

1. Create method 'toEntity' in 'ArticleForm'을 클릭하면, ArticleForm이 열리면서 toEntity() 메서드가 추가됩니다.

2. toEntity() 메서드에서는 폼 데이터를 담은 DTO 객체를 엔티티로 반환합니다. 전달값은 Article 클래스의 생성자 형식에 맞게 작성합니다. 

 

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

리파지터리로 엔티티를 DB에 저장해야 합니다.

 

1. articleRepository.save() 메서드를 호출하여 article 엔티티를 저장합니다.

2. save() 메서드는 저장된 엔티티를 반환하므로 이를 Article 타입의 saved 객체에서 받아옵니다. 오류없이 사용하기 위해서는 articleRepository 객체를 선언해주어야 합니다.

 

빨간 오류들을 잡기 위해서는 리파지터리를 생성해주어야 합니다.

 

리파지터리 만들기

1. repository라는 이름의 새로운 패키지를 생성해줍니다.

2. ArticleRepository라는 이름의 인터페이스를 만들어줍니다.

3. 리파지터리는 JPA에서 제공하는 리파지터리 인터페이스를 활용하여 만들 수 있습니다. ArticleRepository 다음에 extends Crud를 입력하면 생성되는 펼침 목록에서 CrudRepository<T, ID>를 선택하여, CrudRepository라는 인터페이스를 상속받습니다.

 

💡CrudRepository는 JPA에서 제공하는 인터페이스로, 이를 상속해 엔티티를 관리할 수 있다.

 

4. CrudRepository에 <> 를 붙이고, 그 안에 2개의 제네릭 요소를 받습니다. 각각 관리 대상 엔티티의 클래스 타입, 관리 대상 엔티티의 대표값 타입입니다. 본 실습에서는 Article, Long을 입력합니다.

 

5. 여기까지 작성하면 CrudRepository에서 제공하는 기능을 별도 정의 없이, 그대로 사용할 수 있습니다.

 

객체 주입하기

스프링부트에서는 객체를 만들지 않아도, 스프링부트가 자동으로 객체를 만들어주기 때문에 별도의 인터페이스 구현 객체를 생성하지 않아도 됩니다. @Autowired 어노테이션을 사용하여 스프링부트가 미리 생성한 객체를 가져다 연결해줍니다.

 

 💡@Autowired는 스프링 부트가 만들어놓은 객체를 가져와 주입해주며, 이를 의존성 주입이라고 한다.

 

오류 해결

데이터가 저장되는지 확인을 위해 서버를 실행하니 아래 오류가 발생했습니다.

 

문제의 원인은 jenkins...jenkins 사용 방법을 익힐 때 localhost:8080 포트를 사용하고 있었는데 그게 아직 사용 중인 상태였나봅니다. 스프링부트 실행 포트를 바꾸거나, jenkins를 꺼주어야 하는데 jenkins를 끄는 방법으로 해결했습니다.

jenkins 아웃

서버를 재시작해보면 잘 실행됩니다👍👍