쿼리 메소드(NamedQuery)

Mina Park·2022년 10월 3일
0
  • @NamedQuery 어노테이션으로 Named 쿼리를 정의
@Entity
@Getter @Setter
@NoArgsConstructor(access = AccessLevel.PROTECTED) //JPA는 기본생성자가 필요한데 access level은 protected까지만 허용
@ToString(of = {"id", "username", "age"})
@NamedQuery(
        name="Member.findByUsername",
        query="select m from Member m where m.username = :username"
)
public class Member {

    @Id @GeneratedValue
    @Column(name = "member_id")
    private Long id;

    private String username;

    private int age;

    @ManyToOne(fetch = FetchType.LAZY) //relation owner
    @JoinColumn(name = "team_id") //FK
    private Team team;

    public Member(String username) {
        this.username = username;
    }

    public Member(String username, int age, Team team) {
        this.username = username;
        this.age = age;
        if (team != null) {
            changeTeam(team);
        }
    }

    public Member(String username, int age) {
        this.username = username;
        this.age = age;
    }

    //엔티티의 경우 setter 대신 변경이 필요한 경우 의미있는 메소드 생성방식 권장
    public void changeUsername(String username) {
        this.username = username;
    }

    //연관관계 편의 메소드
    public void changeTeam(Team team) {
        this.team = team;
        team.getMembers().add(this);
    }
}
  • Spring Data Jpa를 사용해서 Named 쿼리 호출
public interface MemberRepository extends JpaRepository<Member, Long> {

    //쿼리 메소드
    List<Member> findByUsernameAndAgeGreaterThan(String username, int age);

    List<Member> findTop3HelloBy();

    @Query(name = "Member.findByUsername") //생략가능
        //어노테이션이 없더라도 우선적으로 위에 선언된 Member 클래스의 NamedQuery를 먼저 찾고 없을 경우 쿼리 이름으로 메소드 생성
        //JPQL에 파라미터를 명확하게 넘길 때 @Param 어노테이션 필요
    List<Member> findByUsername(@Param("username") String username);
}

NamedQuery의 최대 장점

  • 애플리케이션 실행 시점에 에러가 바로 발생
    • NamedQuery는 정적쿼리이기 때문에 실행 시점에 파싱을 하기 때문

[참고] 실무에서 Spring Data JPA를 사용하게 되면 Named Query를 직접 등록해서 사용하는 일은 드물며, 보통은 대신 @Query를 사용해서 repository 메소드에 쿼리를 직접 정의

0개의 댓글