** 본 요약은 한빛미디어 '하이버네이트 프로그래밍' 책을 기준으로 작성되어져 있다.
** 본 설명은 바로 따라하기 하기엔 어려움이 있다. 책을 보지 않은 사람에게는 간단히 어떤 기능을 제공하는지 이해하는데 목적을 둔다.
** 하이버네이트 3.2.5.ga 버전, Ant 빌드를 기본적으로 사용한다.
3장 하이버네이트 활용
하이버네이트 설정(Configuration)을 properties 파일에서 cfg.xml 파일로 대체하기
기본 DB 접속 설정을 properties 파일, xml 파일, 또는 Program에서 직접 설정할 수 있다. 이 단락에서는 xml 파일을 이용한 설정 방법을 알아본다.
- 설정 방법
1) hibernate.cfg.xml 파일 생성 (샘플코드 참조) : src 최상위 디렉토리에 저장한다.
<?xml version='1.0' encoding='utf-8'?>
<hibernate-configuration
xmlns="http://www.hibernate.org/xsd/hibernate-configuration"
xsi:schemaLocation="http://www.hibernate.org/xsd/hibernate-configuration hibernate-configuration-4.0.xsd"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<session-factory>
<!-- Database connection settings -->
<property name="connection.driver_class">org.hsqldb.jdbcDriver</property>
<property name="connection.url">jdbc:hsqldb:hsql://localhost</property>
<property name="connection.username">sa</property>
<property name="connection.password"></property>
<!-- JDBC connection pool (use the built-in) -->
<property name="connection.pool_size">1</property>
<!-- SQL dialect -->
<property name="dialect">org.hibernate.dialect.HSQLDialect</property>
<!-- Enable Hibernate's automatic session context management -->
<property name="current_session_context_class">thread</property>
<!-- Disable the second-level cache -->
<property name="cache.provider_class">org.hibernate.cache.internal.NoCacheProvider</property>
<!-- Echo all executed SQL to stdout -->
<property name="show_sql">true</property>
<!-- Drop and re-create the database schema on startup -->
<!-- 아래 기능은 3.2버전에서 동작하는지 확인해야한다. -->
<!--
<property name="hbm2ddl.auto">update</property>
-->
<!-- 사용 중인 매핑 문서 나열 -->
<mapping resource="org/hibernate/tutorial/domain/Event.hbm.xml"/>
</session-factory>
</hibernate-configuration>
2) Ant build.xml 파일에 XML 설정을 사용할 수 있도록 지정
-> Hibernate Tool Task를 사용하는 Target의 '<hibernatetool>' 태그 안에 다음 줄을 추가한다.
<configuration configurationfile="${source.root}/hibernate.cfg.xml"/>
자바 객체를 DB에 저장하기
실제로 자바 코드를 이용해 어떻게 데이터를 생성하는지 알아본다. 전체 흐름을 간단히 요약하고, 코드를 보면 다음과 같다.
1) 기본 설정 부르기
2) 세션 팩토리 가져오기
3) 세션 열기
4) 트랜잭션 열기
5) 객체 생성 저장하기
6) 트랜잭션 반영
7) 세션 닫기
void sample() {
Configuration config = new Configuration() // (1)
config.configure();
SessionFactory sessionFactory = config.buildSessionFactory(); // (2)
Session session = sessionFactory.openSession() // (3)
Transaction tx = null;
try {
tx = session.beginTransaction(); // (4)
// 맵핑 객체 생성
MyObject obj = new MyObject("name", "value");
session.save(obj); // (5)
obj = new MyObject("name2", "value2");
session.save(obj);
tx.commit(); // (6)
} catch (Exception e) {
if (tx != null) {
tx.rollback();
}
throw new Exception("Transaction failed", e);
} finally {
session.close(); // (7)
}
sessionFactory.close(); // (7)
}
객체는 session.save(obj)가 호출 된 이후에 영속 객체가 된다. 즉 DB 데이터로 저장되어 진다.
SessionFactory 객체는 스레드세이프 하기 때문에 전체 애플리케이션에서 하나만 사용하지만, Session 객체는 스레드세이프 하지 않기 때문에 하나의 작업을 마치고 다음 작업으로 넘어가면 SessionFactory에서 새 세션을 가져와 사용하도록 한다.
DB 데이터를 자바 객체로 가져오기
저장된 DB 데이터를 가져오는데 하이버네이트에서는 여러가지 방법을 제공한다.
- HQL(하이버네이트의 sQL기반 쿼리언어)를 이용한 검색
- Named Query/Named parameter 이용한 검색
- Native SQL Query 이요한 검색
이번 단락에서는 HQL와 Named Query/Parameter를 사용하는 간단한 예제를 설명한다.
첫째로 HQL 방법은 다음 코드와 같이 session객체의 createQuery([쿼리]) 메소드를 이용한다.
Query query = session.createQuery("from Track as track " +
"Where track.playTime <= ?");
query.setParameter(0, value, Hibernate.[TYPE]);
query.list();
HQL은 JDBC의 PreparedStatement와 유사한 파라미터를 지원한다. 이런 방법은 SQL 주입 공격을 막지만 조금더 편리한 방법을 제공한다. 그리고 쿼리의 내용을 보면 객체와 테이블의 이름이 같고 컬럼과 프로퍼티의 이름을 동일하게 사용되어진다. 기본적으로 동일한 이름을 가지고 DB 스키마가 생성되기 때문이지만, 추후 명시적으로 다른 이름을 사용할 수 있도록 지정하는 방법을 알아본다.
다음으로는 위 코드에서 좀 더 편하게 파라미터를 입력할 수 있는 네임트 파라미터를 설명한다. 코드를 먼저 보면 다음과 같다.
Query query = session.createQuery("from Track as track " +
"Where track.playTime <= :value");
query.setString("value", value);
query.list();
네임드 파라미터는 쿼리 본문에 접두어 콜런(:)으로 구분 한다. Query 객체는 setter 메소드를 자바 타입별로 모두 갖쳐줘 있어서, query.setInteger(), query.setString()등의 메소드를 이용해 적절한 타입으로 설정할 수 있다.
이는 쿼리 상의 파라미터 값을 명시적으로 맵핑 시켜주기에 오류 가능성을 줄여준다. 혹시 파라미터를 수많은 '?'로 지정하고, 그 뒤에 코드로 파라미터 값을 맵핑해주는 코드를 짜본적 있다면 네임드 파라미터 방법의 편리성은 피부로 느낄 수 있다. 제일 큰건 순서 제약이 없어진다는 것이다. 테이블이 변경되어 수많은 파라미터 중에 중간 값이 없어지고, 새로운 값이 추가된다면, 이때 코드를 신경써서 작성하지 않는다면 오류가 발생할 확률은 커지게 마련인데 이를 개선시킨 것이다.
그럼 쿼리문을 자바 소스에서 분리 할 수 있는 방법을 설명한다. 분리는 다음 단계로 진행 된다.
1) 하이버네이트 매핑 문서(hbm.xml)의 <hibernate-mapping> 태그 내에 매핑 쿼리 작성하기
<query name="com.billy.getData">
<![CDATA[
from Track as track
where track.playTime <= :value
]]>
</query>
2) session 객체에서 getNamedQuery() 메소드를 이용해 쿼리를 호출
Query query = session.getNamedQuery("com.billy.getData");
query.setString("value", value);
query.list();
물론 하이버네이트 매핑 문서(hbm.xml)는 하이버네이트 설정 파일에 추가되어 있어야 한다.
