본문 바로가기

Spring boot

[Spring boot] H2 DB 연결 & JPA 실행 & 기타 설정, JPQL이란?

H2 DB 연결준비

1. pom.xml (library 셋팅)

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>

<groupId>jpa-basic</groupId>
<artifactId>ex1-hello-jpa</artifactId>
<version>1.0.0</version>

<properties>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
</properties>

<dependencies>
    <!-- JPA 하이버네이트 -->
    <dependency>
        <groupId>org.hibernate</groupId>
        <artifactId>hibernate-entitymanager</artifactId>
        <version>5.3.10.Final</version>
    </dependency>
    <!-- H2 데이터베이스 -->
    <dependency>
        <groupId>com.h2database</groupId>
        <artifactId>h2</artifactId>
        <version>1.4.199</version>     
    </dependency>
    <!-- java 11 버전 사용시 필요 -->
    <dependency>
        <groupId>javax.xml.bind</groupId>
        <artifactId>jaxb-api</artifactId>
        <version>2.3.0</version>
    </dependency>
</dependencies>


</project>
더보기

hibernate version 찾기 

spring > spring boot > LEARN > Reference Doc. > Dependency Versions > (ctrl+f) org.hibernate 검색 

Reference Doc.&nbsp;

             오른쪽에 버전 확인 후 작성

5.4.32.Final

 H2 DB 버전 찾기

설치된 h2 DB와 같은 version으로 작성

설치할 때 Download 아래 써있는 version 확인

1.4.199

 

 

2. persistence.xml  (persistence가 있어야 돌아간다)

src > main> resources > META-INF > persistence.xml 파일 생성 

//persistence.xml

<?xml version="1.0" encoding="UTF-8"?>
<persistence version="2.2"
             xmlns="http://xmlns.jcp.org/xml/ns/persistence" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/persistence http://xmlns.jcp.org/xml/ns/persistence/persistence_2_2.xsd">
    <persistence-unit name="hello">
        <properties>
            <!-- 필수 속성 -->
            <property name="javax.persistence.jdbc.driver" value="org.h2.Driver"/>
            <property name="javax.persistence.jdbc.user" value="sa"/>
            <property name="javax.persistence.jdbc.password" value=""/>
            <property name="javax.persistence.jdbc.url" value="jdbc:h2:tcp://localhost/~/test"/>
            <property name="hibernate.dialect" value="org.hibernate.dialect.H2Dialect"/>
            

            <!-- 옵션 -->
            <property name="hibernate.show_sql" value="true"/>
            <property name="hibernate.format_sql" value="true"/>
            <property name="hibernate.use_sql_comments" value="true"/>
            <!--<property name="hibernate.hbm2ddl.auto" value="create" />-->
        </properties>
    </persistence-unit>
</persistence>

! 필수 속성 중 jdbc.url은 jdbc:h2:tcp://localhost/~/test"로 h2 url과 동일해야 한다.

더보기

 

property name

property name = "javax.~"는 자바 표준을 뜻하며 다른 JPA library를 써도 호환된다. property name = "hibernate.~"는 hibernate 전용 library로 hibernate에서만 적용된다. 만약 hibernate가 아닌 다른 jpa library로 바꾼다면 property name = "hibernate.~"를 다 변경해줘야 한다.

 

dialect

Oracle이나 H2등 DB마다 다른 기능명(방언)을 dialect가 통일시켜준다. 

출처 : 김영한.(2019).자바 ORM 표준 JPA 프로그래밍 - 기본편(강의자료)

 

 

H2 DB 생성

1. H2 Console을 열고(또는 localhost:8082 접속)

  • 저장한 이름, 설정이름 : Server
  • JDBC URL : jdbc:h2:tcp://localhost/~/test

2. 연결

jdbc:h2:tcp://localhost/~/test

 


오류 발생 시 

처음 H2 데이터베이스를 실행했을 때 아래와 같은 오류가 발생하면 데이터베이스 파일을 생성하면 된다.

Database "~/test" not found, and IFEXISTS=true, so we cant auto-create it [90146-199]

 

데이터베이스 파일 생성 방법

jdbc:h2:~/test

그 이후는 계속

jdbc:h2:tcp://localhost/~/test

jdbc:h2:tcp://localhost/~/test로만 접속

 

 

 

 

JPA 실행

JPA 구동방식

출처 : 김영한.(2019).자바 ORM 표준 JPA 프로그래밍 - 기본편(강의자료)

 

 

엔티티 매니저 팩토리와 엔티티 매니저

사용자 요청이 들어올 때마다 엔티티 매니저 팩토리는 엔티티 매니저를 만든다.

각 엔티티 매니저는 connection을 만든다. 

출처 : 김영한.(2019).자바 ORM 표준 JPA 프로그래밍 - 기본편(강의자료)

 

Main 실행

//src > main > java > 프로젝트명(hellojpa) > class명(jpaMain)

package hellojpa;

import javax.persistence.EntityManager;
import javax.persistence.EntityManagerFactory;
import javax.persistence.EntityTransaction;
import javax.persistence.Persistence;

public class JpaMain {
    public static void main(String[] args) {
    
        EntityManagerFactory emf = Persistence.createEntityManagerFactory("hello");
        EntityManager em = emf.createEntityManager();

        EntityTransaction tx = em.getTransaction();
        tx.begin();

        try{
            /*instance 생성 및 변경*/ 

            em.persist({instance명});

            tx.commit();
        }catch (Exception e){
            tx.rollback();
        }finally {
            em.close();
        }

        emf.close();
    }
}
  • JPA의 모든 데이터 변경은 트랜잭션 안에서 실행되어야 한다. 
  • 고객의 요청이 들어오면 꼭 엔티티 매니저를 통해서 작업을 해야한다.
  • "hello"는 persistence.xml 파일의 <persistence-unit name="hello">에서 가져온 것.
  • 아래 더보기는 필수사항
더보기

EntityManagerFactory emf = Persistence.createEntityManagerFactory("hello");

=> 엔티티 매니저 팩토리는application loading시 DB 1개당 1개만 생성된다.  

 

EntityManager em = emf.createEntityManager();

=> 엔티티 매니저는 고객의 요청이 올때마다(transaction 단위로) 생성되며 쓰레드간 공유할 수 없어서 사용하고 버려야 한다. close(); 필수!

EntityTransaction tx = em.getTransaction();

tx.begin();

=> DB transaction 시작

em.persist();

Entity를 영구저장할 환경 생성

 

tx.commit();

=> instance 저장

 

em.close();

DB connection 반환

 

emf.close();

웹 어플리케이션이면 WAS가 내려갈 때 엔티티 매니저 패키지도 닫아줌. 자원 릴리즈

 

 

기타 설정 (application.yml)

spring:
  datasource:
    url: jdbc:h2:tcp://localhost/~/jpashop
    username: sa
    password:
    driver-class-name: org.h2.Driver
    
  jpa:
    hibernate:
      ddl-auto: create
    properties:
      hibernate:
        show_sql: true
        # format_sql: true
        
  logging.level:
    org.hibernate.SQL: debug
    # org.hibernate.type : trace
더보기

spring.jpa.hibernate.ddl-auto: create : 애플리케이션 실행 시점에 테이블을 drop 하고, 다시 생성한다.

 

show_sql : System.out 에 하이버네이트 실행 SQL을 남긴다.

org.hibernate.SQL : logger를 통해 하이버네이트 실행 SQL을 남긴다 (보통 logger를 통해 남김)

 

 

쿼리 파라미터 로그 남기기
log를 보면 insert ~~ (?,?)이 있는데 ?에 뭐가 들어가는지 궁금하면 아래 방법 실행 

  1. application.yml에 org.hibernate.type: trace
  2. build.gradle에 implementation 'com.github.gavlyukovskiy:p6spy-spring-boot-starter:1.5.6'  추가 

 ( ※ 개발 단계가 아닌 운영시스템에 적용하려면 성능테스트 하기)

 

JPQL

객체 지향 SQL

 

JPA는 엔티티 객체를 중심으로 개발하지만 SQL은 데이터베이스 테이블 중심이다. 

이 둘을 연결해줄 JPQL은 테이블이 아닌 객체를 대상으로 검색하는, 객체 지향 쿼리.

SQL을 추상화해 특정 DB SQL에 의존하지 않으며 JPA는 이러한 JPQL를 제공 

 

한 줄 정리 =>

JPA는 객체 중심이기 때문에 DB 중심인 SQL과 연결하기 위해 SQL을 추상화한 객체 지향 SQL(JPQL)을 제공.

 

 

 

 

 

추가 정보

방언 : 각각의 DB가 제공하는 SQL 문법과 함수는 조금씩 다른데, SQL 표준을 지키지 않는 특정 DB만의 고유한 기능.

   예 ) 문자열을 자르는 함수   :      SQL 표준은 SUBSTRING(),  Oracle은 SUBSTR()