[JPA 기본편] 객체지향 쿼리 언어1 - 기본 문법

JPQL은 엔티티 객체를 대상으로 쿼리.

SQL은 데이터베이스 테이블을 대상으로 쿼리.

JPQL을 한마디로 정의하면 객체 지향 SQL

 

하지만, JPQL로 동적 쿼리를 작성하기 불편하다..

 

Criteria

            //Criteria
            CriteriaBuilder criteriaBuilder = em.getCriteriaBuilder();
            CriteriaQuery<Member> query = criteriaBuilder.createQuery(Member.class);

            Root<Member> m = query.from(Member.class);
            String username = "aaaa";

            CriteriaQuery<Member> cq = query.select(m);
            
            if (username != null){
                cq = cq.where(criteriaBuilder.equal(m.get("username"), "kim"));
            }
            List<Member> resultList = em.createQuery(cq).getResultList();

위 코드처럼 Criteria로 동적 쿼리를 작성할 수 있지만, 알아보기 힘들어 유지보수가 힘들어서 실무에서 사용하지 않는다. 

 

동적 쿼리 작성 시에는 Criteria대신에 Querydsl 사용하기.

 

JDBC 직접 사용, SpringJdbcTemplate 등

• JPA를 사용하면서 JDBC 커넥션을 직접 사용하거나, 스프링 JdbcTemplate, 마이 바티스 등을 함께 사용 가능하다.
• 단, 영속성 컨텍스트를 적절한 시점에 강제로 플러시하는 것이 필요하다. ( em.flush() )
  • JPA는 커밋할 때나, 쿼리를 보낼 때 플러시하는데, JDBC를 사용할 때는 직접 플러시해야 앞 줄에 작성한 코드들이 DB에 적용되어 제대로 사용할 수 있다. 
• 예) JPA를 우회해서 SQL을 실행하기 직전에 영속성 컨텍스트 수동 플러시 

실무에서 95%는 JPQL과 Querydsl로 짜고, 나머지 5%는 SpringJdbcTemplate으로 짠다. 근데 그마저도 JPQL과 Querydsl로 가능하긴 하다. 

 

JPQL 기본 문법과 기능

• JPQL은 SQL을 추상화해서 특정 데이터베이스 SQL에 의존하지 않는다.
• JPQL은 결국 SQL로 변환된다. 

JPQL 문법

select문 ::=
	select절
    from절
    [where절]
    [groupby절]
    [having절]
    [orderby절]
    
update문 ::= update절 [where절]
delete문 ::= delete절 [where절]

• 엔티티와 속성은 대소문자를 구분한다.
• JPQL 키워드는 대소문자를 구분하지 않는다.
• 엔티티 이름을 사용한다. 테이블 이름이 아니다.
• 별칭은 필수다. as는 생략 가능하다. 

 

TypeQuery, Query

• TypeQuery: 반환 타입이 명확할 때 사용
• Query: 반환 타입이 명확하지 않을 때 사용

Member member = new Member();
member.setName("member1");
em.persist(member);

TypedQuery<Member> query1 = em.createQuery("select m from Member m", Member.class);
Query query2 = em.createQuery("select m.name, m.age from Member m"); //m.name과 m.age가 타입이 달라서 타입을 명시할 수 없음.

 

결과 조회

• query.getResultList(): 결과가 하나 이상일 때, 리스트 반환
  • 결과가 없으면 빈 리스트 반환
• query.getSingleResult(): 결과가 정확히 하나, 단일 객체 반환
  • 결과가 없으면: NoResultException
  • 결과가 여러개: NonUniqueResultException

파라미터 바인딩

TypedQuery<Member> query1 = em.createQuery("select m from Member m where m.name = :name", Member.class);
query1.setParameter("name", "member1");
Member singleResult = query1.getSingleResult();
System.out.println("singleResult = " + singleResult.getName());

Member singleResult = em.createQuery("select m from Member m where m.name = :name", Member.class)
                    .setParameter("name", "member1")
                    .getSingleResult();
System.out.println("singleResult = " + singleResult.getName());

위와 아래는 동일. 보통 아래 체인으로 함. 

 

프로젝션

• select 절에 조회할 대상을 지정하는 것
• 프로젝션 대상: 엔티티, 임베디드 타입, 스칼라 타입(숫자, 문자 등 기본 데이터 타입)
• select m from Member m -> 엔티티 프로젝션
• select m.team from Member m -> 엔티티 프로젝션
• select m.address from Member m -> 임베디드 타입 프로젝션
• select m.username, m.age from Member m -> 스칼라 타입 프로젝션
• DISTINCT로 중복 제거 

여러 타입 반환

• Query
• Object[] 타입으로 조회
• new 명령어로 조회 
  • 단순 값을 DTO로 조회

Member member = new Member();
member.setName("member1");
em.persist(member);

List<MemberDTO> result = em.createQuery("select new jpql.MemberDTO(m.name, m.age) from Member m", MemberDTO.class)
                            .getResultList(); //DTO의 패키지명 다 적어야함. 

MemberDTO memberDTO = result.get(0);
System.out.println("memberDTO.getUsername() = " + memberDTO.getUsername());
System.out.println("memberDTO.getAge() = " + memberDTO.getAge());

패키지 명을 포함한 클래스 명을 모두 적어야 한다.

 

페이징 

• JPA는 페이징을 다음 두 API로 추상화
• setFirstResult(int startPosition): 조회 시작 위치 (0부터 시작)
• setMaxResults(int maxResult): 조회할 데이터 수 

for (int i = 0; i < 100; i++) {
                Member member = new Member();
                member.setName("member" + i);
                member.setAge(i);
                em.persist(member);
            }

em.flush();
em.clear();

List<Member> result = em.createQuery("select m from Member m order by m.age desc", Member.class)
           .setFirstResult(1)
           .setMaxResults(10)
           .getResultList();

 

조인

• 내부 조인
  • select m from Member m [INNER] JOIN m.team t
• 외부 조인
  • select m from Member m LEFT [OUTER] JOIN m.team t
• 세타 조인
  • select count(m) from Member m, Team t where m.username = t.name
  • 연관 관계가 없는 것들끼
• ON 절
  • 조인 대상 필터링. 조인할 때의 조건 
    • 회원과 팀을 조인하면서, 팀 이름이 A인 팀만 조인
      • select m, t from Member m left join m.team t on t.name = 'A'; 
  • 연관 관계 없는 엔티티도 외부 조인이 가능하다. 
    • select m, t from Member m left join Team t on m.username = t.name

서브 쿼리

• 나이가 평균보다 많은 회원
  • select m from Member m where m.age > (select avg(m2.age) from Member m2);
• 한 건이라도 주문한 고객
  • select m from Member where (select count(o) from Order o where m = o.member) > 0;
• 서브 쿼리 지원 함수
  • [NOT] EXISTS (subquery)
    • {ALL | ANY | SOME} (subquery)
• [NOT] IN (subquery) 
• JPA는 where, having 절에서만 서브 쿼리 사용 가능
• select절도 가능
• from절의 서브쿼리는 현재 JPQL에서 불가능
  • 조인으로 풀 수 있으면 풀어서 해결해야함.

JPQL의 타입 표현과 기타식

• 타입 표현
  • 문자: ' '안에 표현, '를 표현하려면 ''
  • 숫자: 10L(Long), 10D(double), 10F(Float)
  • Boolean: TRUE, FALSE
  • ENUM: jpabook.MemberType.Admin (패키지명 포함해서 넣기) 
    • 파라미터 바인딩으로 해도 됨
  • 엔티티 타입
    • select i from Item i where type(i) = Book
    • 상속 관계에서 사용함. 
• 기타식
  
  • SQL과 문법이 같은 식
  • EXISTS, IN
  • AND, OR, NOT
  • =, >, >=, <, <=, <>
  • BETWEEN, LIKE, IS NULL

조건식 

• case식

            String query =
                    "select " +
                            "case when m.age <= 10 then '학생요금' " +
                            "     when m.age >= 60 then '경로요금' " +
                            "     else '일반요금' end "+
                    "from Member m";

            List<String> resultList = em.createQuery(query, String.class).getResultList();
            for (String s : resultList) {
                System.out.println("s = " + s);
            }

 

• coalesce: 하나씩 조회해서 null이 아니면 반환
• NULLIF: 두 값이 같으면 null 반환, 다르면 첫번째 값 반환 

JPQL 함수

• 데이터베이스에 관계없이 사용 가능한 함수
  • CONCAT: 문자 두개 더하기
  • SUBSTRING: 문자 잘라내기
  • TRIM: 공백 제거
  • LOWER, UPPER: 대소문자 변경
  • LENGTH: 문자 길이
  • LOCATE: 문자 위치 찾기
  • ABS, SQRT, MOD
  • SIZE, INDEX(JPA 용도): SIZE는 컬렉션의 크기를 돌려주고, INDEX는 컬렉션의 위치값을 구할 때 사용 가능한데, 안쓰는게 좋다. 
• 사용자 정의 함수
  
  • ...Dialect를 보면 데이터베이스에 종속적인. 데이터베이스가 제공하는 함수들이 있다. 
    
    • 그래서 굳이 사용자 정의 함수를 만들지 않아도 된다.