Entity먼저 데이터베이스에 저장하기 위해 유저가 정의한 클래스가 필요한데 그런 클래스를
Entity라고 한다. Domain이라고 생각하면 된다.
일반적으로RDBMS에서 Table을 객체화시킨 것으로 보면 된다.
그래서 Table의 이름이나 컬럼들에 대한 정보를 가진다.
/** * Created by Itner on 2017. 7. 20.. */ @Entity public class Member { @Id @GeneratedValue(strategy= GenerationType.AUTO) private long id; @Column private String name; @Column private int age; public long getId() { return id; }
public void setId(long id) { this.id = id; }
public String getName() { return name; }
public void setName(String name) { this.name = name; }
public int getAge() { return age; }
public void setAge(int age) { this.age = age; } }
@Id
primary key를 가지는 변수를 선언하는 것을 뜻한다. @GeneratedValue 어노테이션은 해당 Id 값을
어떻게 자동으로 생성할지 전략을 선택할 수 있다. 여기서 선택한 전략은 "AUTO"이다.
@Table
별도의 이름을 가진 데이터베이스 테이블과 매핑한다. 기본적으로 @Entity로 선언된 클래스의 이름은 실제
데이터베이스의테이블 명과 일치하는 것을매핑한다. 따라서 @Entity의 클래스명과 데이터베이스의 테이블명이
다를 경우에 @Table(name=" ")과 같은 형식을 사용해서 매핑이 가능하다.
@Column
@Column 선언이 꼭 필요한 것은 아니다. 하지만 @Column에서 지정한 변수명과 데이터베이스의 컬럼명을
서로 다르게 주고 싶다면 @Column(name=" ") 같은 형식으로 작성하면 된다.
그렇지 않은 경우에는 기본적으로 멤버 변수명과 일치하는 데이터베이스 컬럼을 매핑한다.
Repository
Entity클래스를 작성했다면 이번엔 Repository 인터페이스를 만들어야 한다.
스프링부트에서는 Entity의기본적인 CRUD가 가능하도록 JpaRepository 인터페이스를 제공한다.
/** * Created by Itner on 2017. 7. 20.. */ public interface MemberRepository extends JpaRepository<Member, Long> {
}
Spring Data JPA에서 제공하는JpaRepository 인터페이스를 상속하기만 해도 되며,
인터페이스에 따로 @Repository등의 어노테이션을 추가할 필요가 없다.
JpaRepository를 상속받을 때는 사용될 Entity 클래스와 ID 값이 들어가게 된다.
즉,JpaRepository<T, ID>가 된다.
그렇게 JpaRepository를 단순하게 상속하는 것만으로 위의 인터페이스는 Entity 하나에 대해서
아래와 같은 기능을 제공하게 된다.
method
기능
save()
레코드 저장 (insert, update)
findOne()
primary key로 레코드 한건 찾기
findAll()
전체 레코드 불러오기. 정렬(sort), 페이징(pageable) 가능
count()
레코드 갯수
delete()
레코드 삭제
위의 기본기능을 제외한 조회 기능을 추가하고 싶으면규칙에 맞는 메서드를 추가해야한다.
/** * Created by Itner on 2017. 7. 20.. */ public interface MemberRepository extends JpaRepository<Member, Long> {
Member findByName(String name); Page<Member> findByName(String name, Pageable pageable); }
위와 같이Query 메소드를 추가하여 스프링에게 알릴 수 있다.
그러기위해서는규칙에 맞는 메서드를 작성해야 하는데, 그 규칙은 다음과 같다.
method
설명
findBy로 시작
쿼리를 요청하는 메서드 임을 알림
countBy로 시작
쿼리 결과 레코드 수를 요청하는 메서드 임을 알림
위의 findBy에 이어 해당 Entity 필드 이름을 입력하면 검색 쿼리를 실행한 결과를 전달한다.
SQL의 where절을 메서드 이름을 통해 전달한다고 생각하면 된다.
메서드의 반환형이 Entity 객체이면 하나의 결과만을 전달하고, 반환형이 List라면 쿼리에 해당하는
모든 객체를 전달한다.
Query 메소드에포함할 수 있는 키워드는 다음과 같다.
메서드 이름 키워드
샘플
설명
And
findByEmailAndUserId(String email, String userId)
여러필드를 and 로 검색
Or
findByEmailOrUserId(String email, String userId)
여러필드를 or 로 검색
Between
findByCreatedAtBetween(Date fromDate, Date toDate)