[자바 ORM 표준 JPA 프로그래밍 - 기본편] 13. JPQL 기본 문법 / 쿼리 API

 

JPQL - 기본 문법과 기능

 

엔티티 객체를 대상으로 쿼리하는 것 

 

JPQL 은 결국 SQL로 변환된다. 

 

"select m From Member m where m.age > 18"

 

엔티티와 속성은 대소문자를 구분한다. ( Member , age ) 

 

JPQL 키워드는 대소문자를 구분하지 않는다 ( SELECT , FROM , where ) 

 

JPQL 은 테이블 이름이 아닌 엔티티 이름을 사용한다. ( Member ) 

 

별칭은 필수이다. ( Member as m ) as 는 생략가능하다 . 

 

 

 

TypeQuery, Query

 

TypedQuery<Member> query1 = em.createQuery("select m from Member m ", Member.class);

TypeQuey : 반환 타입이 명확할 때 사용한다. 

 

 

Query query2 = em.createQuery("select m.username, m.age from Member m");

Query : 반환 타입이 명확하지 않을 때 사용한다. 

 

 

 

 

결과 조회 API

query.getResultList();

 

getResultList() : 결과가 하나 이상일 때 , 리스트 반환 결과가 없으면 빈 리스트를 반환한다. 

 

( NPE 걱정할 필요 없다 ) 

 

 

query.getSingleResult();

 

getSingleResult() : 결과가 정확히 하나를 반환한다 . 단일 객체 반환

 

결과가 없으면 javax.persistence.NoResultException

 

둘 이상이면 javax.persistence.NonUniqueResultException

 

 

 

파라미터 바인딩

em.createQuery("select m from Member m where m.username = :username", Member.class)
        .setParameter("username","member1")
        .getSingleResult();

 

 쿼리에 작성되는 특정 속성을 매개변수로 매핑하는 것을 말한다.

 

 이름 기준 바인딩은 =: 연산자를 사용한다.

 

 

 

 

프로젝션(SELECT)

 

SELECT 절에 조회할 대상을 지정하는 것이다.

 

프로젝션의 대상 

 

엔티티 프로젝션

SLECET m FROM Member m

 

엔티티 프로젝션 

SLECET m.team FROM Member m

 

 임베디드 타입 프로젝션 

SLECET m.address FROM Member m

 

 스칼라 타입 프로젝션 ( 숫자, 문자등 기본 데이터 타입 ) 

SLECET m.username, m.age FROM Member m

 

 

DISTINCT 로 중복을 제거할 수 있다.

SELECT DISTINCT m.username FROM Member m

 

 

 여러값 조회

Query query = em.createQuery("select m.username, m.age from Member m");

 

여러값으로 조회했을 때는 TypedQuery를 사용할 수 없고, Query만 사용할 수 있다.

 

 

List<Object[]> resultList = query.getResultList();

for(Object[] row : resultList){
    String username = (String)row[0];
    Integer age = (Integer)row[1];
    Team team = (Team)row[2];
}

 

Object[] 타입으로 조회할 수도 있다. 

 

 

 

TypedQuery<UserDTO> query =
        em.createQuery("SELECT NEW com.joont.dto.UserDTO(m.username, m.age, m.team) FROM Member m", UserDTO.class);

List<UserDTO> resultList = query.getResultList();

 

NEW 명령어를 사용하면 Object[] 대신 바로 객체로 생성해서 받아볼 수 있다.

 

• 패키지명을 포함한 클래스명을 입력해야 한다.
• 순서와 타입이 일치하는 생성자가 필요하다.

 

 

 

 

https://www.inflearn.com/course/ORM-JPA-Basic/dashboard

자바 ORM 표준 JPA 프로그래밍 - 기본편 - 인프런 | 강의