JPA Entity Definition and Lifecycle Hook - TheOpenCloudEngine/uEngine-cloud GitHub Wiki

레퍼런스 참고 : http://arahansa.github.io/docs_spring/jpa.html

이번장은 Gearing up the MSA 에서 생성하였던 코드에 JPA 부분을 좀더 자세히 설명 하고자 한다.

우선 Course 라는 Entity 클레스를 생성하여 보자

import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.Id;

@Entity
public class Course {
    @Id
    @GeneratedValue
    Long id;
    String title;
    int duration;
    String description;
    int maxEnrollment;
    int minEnrollment;
}

이 클레스는 @Entity 라고 명시를 하였다.
import 를 할적에 javax 로 시작하는 것은 java의 표준으로 정의 되어있다는 뜻이다.
JPA를 제공하는 provider 는 hibernate 도 있고, eclipse link 같은 것도 있다.
이때 표준으로 제공되있는 libary를 사용하면 provider를 변경하여도 유연하게 사용이 가능하다.

이제 getter, setter 를 생성하여 주는데, 변경하면 안되는 값인 id는 제외하고 만들어 준다.
java 에서 getter, setter 는 경계값을 설정하여 주는 역할이다.
member 변수들은 private 값 으로 주고 getter, setter 로 public 을 주어서 어느곳에서 변경되었는지를 파악할수 있다.
이렇게 설정을 해야 방어적인 프로그래밍을 할 수 있다.

@GeneratedValue 는 아이디에 시스템에서 생성되는 일련번호를 부여하기 위하여 사용한다.

    @PrePersist
    @PreUpdate
    public void validation(){
        if( minEnrollment < 10 ){
            throw new IllegalArgumentException("수강생은 10명 이상이어 합니다.");
        }
    }

@PrePersist 어노테이션은 insert 되기 전에 해당 로직을 실행 하라는 의미이다.
JPA framework 와 REST 는 BCI(Byte Code Instrumentation) 라는 강력한 libary를 사용하여 getter, setter 를 경유하지 않고 데이터를 주고 받는다. 한마디로 getter에 비지니스 로직을 넣어봤자 인식이 안된다는 뜻이다.
@PreUpdate 는 값이 변경될때마다 체크를 하여 해당 로직을 실행 하라는 의미이다.
@PreRemove 는 값이 지워질때 체크를 한다.
이런식으로 Lifecycle을 모두 체크할 수 있다.

    @PostPersist
    public void greeting(){
        // 광고이메일 발송 --> 1번 방법
        // 과정 등록에 대한 이벤트 publish --> 2번 방법
        System.out.println("과정이 등록됨 " + this.getTitle());
    }

@PostPersist 어노테이션은 성공적으로 등록이 되면 그 후 일을 하겠다는 의미이다.
1번 방법처럼 바로 비지니스 로직을 작성 할 수 있지만, 직접 여기에서 해당 microservice를 찾아서 호출하는 것 보다, 2번 방법처럼 kafka같은 message를 알려주고, 거기에 알아서 반응해 라고 만드는 방법이 훨씬 좋다.
왜냐하면 microservice의 갯수가 많기 때문이다.
이러한 Anotation을 통하여 Event에 반응 할수 있는 JPA가 있기에 전체 아키택쳐가 간단해지고,
이것은 'microservice들이 백그라운에서 돌고 있지만, 모두 연결 될 수 있다' 라는 것을 의미한다.

여기까지 하고, 해당 console로 들어가서 httpie로 http localhost:8080 을 호출해 보자.
방금 만들었던 Course가 나오지 않는것을 확인 할 수 있는데,
이는 Entity만 만들었고, Repository를 만들지 않아서 Rest를 아직 사용 할 수 없는 것이다.

이제 Reopsitory라는 Interface를 만들 차례이다. Interface는 구현체를 채워 달라고 하는 요청이다.
네이밍 규칙은 꼭 지킬 필요가 없지만, 코딩시 Entity와 같은 package에 파일을 생성하고,
Entity뒤에 Repository라는 명명을 하여 생성하는 것을 추천한다.

public interface CourseRepository extends PagingAndSortingRepository<Course, Long> {
}

PagingAndSortingRepository 는 페이징 기능을 담고 있는 Repository이다
레파지토리의 새로운 유형을 만들고 싶을때는 해당 Repository를 extends해서 새롭게 만들 수 있다.
interface 의 구현체는 없지만 Repository 생성시 스프링 부트가 runtime에 실제 워킹하는 sql문을 생성하고 쿼리를 날리는 것을 generate 해준다

이제 테스트를 통하여 Lifecycle이 정상 작동하는지 확인해 봅니다.
콘솔창을 연 후에 mvn spring-boot:run 으로 어플리케이션을 run 합니다.

## Course가 Rest로 등록되었는지 확인
$ http localhost:8080
{
    "_links": {
        "courses": {
            "href": "http://localhost:8080/courses{?page,size,sort}",
            "templated": true
        },
        "profile": {
            "href": "http://localhost:8080/profile"
        }
    }
}
## 정상적으로 데이터가 들어감
$ http localhost:8080/courses title="software modeling lecture" duration=5 maxEnrollment=5 minEnrollment=10
## @PrePersist 에 의하여 throw new IllegalArgumentException("수강생은 10명 이상이어 합니다."); 발생
$ http localhost:8080/courses title="software modeling lecture" duration=5 maxEnrollment=5 minEnrollment=1
## @PostPersist 에 의하여  greeting() 메서드 실행됨
$ http PATCH localhost:8080/courses/1 description="설명"