이 페이지의 구성
JPA Configuration
JPA Configuration
JPA는 실행 속성을 포함하고 있는 persistence.xml을 기반으로 하여 동작하도록 구성되어 있다. persistence.xml 파일의 주요 구성 요소와 속성 정의 방법에 대해 살펴보기로 한다. 먼저, persistence.xml 파일은 가장 상위에 <persistence> 태그를 포함하고 있으며 <persistence> 태그 내에 여러개의 <persistence-unit>를 포함할 수 있다.
Persistence Unit
Persistence Unit에 포함하고 있는 주요한 엔티티들은 다음과 같다.
| element 명 | 설 명 |
|---|---|
| provider | Entity Manager를 지원하는 Provider 클래스 |
| mapping-file | 매핑정보 파일 |
| class | Entity 클래스 리스트, @Entity, @Embeddable or @MappedSuperclass 를 포함하고 있는 클래스 |
| exclude-unlisted-classes | class 에서 정의하지 않은 것은 제외 |
| properties | JPA 구현체 프로퍼티 리스트 |
상세한 정보는 스키마 참조 아래는 위의 항목을 포함하고 있는 설정파일 예입니다.
<persistence-unit name="HSQLMUnit" transaction-type="RESOURCE_LOCAL">
<provider>org.hibernate.ejb.HibernatePersistence</provider>
<class>egovframework.sample.model.bidirection.User</class>
<exclude-unlisted-classes/>
<properties>
<property name="hibernate.connection.driver_class" value="net.sf.log4jdbc.DriverSpy"/>
...
Hibernate Properties
Properties 아래에 정의되는 Vendor별 설정 정보중에 Hibernate의 설정정보에 대해서 설명한다. 좀더 자세한 사항은 Hibernate사이트 를 참조한다.
DataSource 속성
아래의 속성들을 통해 Hibernate는 특정 DB에 접근하여 데이터 액세스 처리가 가능하다.
| 속 성 명 | 설 명 |
|---|---|
| hibernate.connection.driver_class | 접근 대상이 되는 DB의 Driver 클래스명을 정의하기 위한 속성 |
| hibernate.connection.url | 접근 대상이 되는 DB의 URL을 정의하기 위한 속성 |
| hibernate.connection.username | DB에 접근할 때 사용할 사용자명을 정의하기 위한 속성 |
| hibernate.connection.password | DB에 접근할 때 사용할 패스워드를 정의하기 위한 속성 |
다음은 위에서 언급한 속성들을 포함하고 있는 persistence.xml 파일의 일부이다
<property name="hibernate.connection.driver_class" value="net.sf.log4jdbc.DriverSpy"/>
<property name="hibernate.connection.url" value="jdbc:log4jdbc:hsqldb:mem:testdb"/>
<property name="hibernate.connection.username" value="sa"/>
Generated SQL 속성
아래의 속성들을 통해 Hibernate는 특정 DB에 접근하여 데이터 액세스 처리가 가능하다.
| 속 성 명 | 설 명 |
|---|---|
| hibernate.dialect | Hibernate 기반 개발시 DB에 특화된 SQL을 구성하지 않더라도 DB에 따라 알맞은 SQL을 생성할 수 있다. 이를 위해서 Dialect 클래스를 사용한다. hibernate.dialect는 Dialect 클래스명을 정의하기 위한 속성 |
| hibernate.default_schema | Hibernate에서 SQL을 생성할 때 특정 테이블에 대해 별도 정의된 Schema가 없는 경우 적용할 DB Schema 명을 정의하기 위한 속성 |
| hibernate.default_catalog | Hibernate에서 SQL을 생성할 때 특정 테이블에 대해 별도 정의된 Catalog가 없는 경우 적용할 DB Catalog 명을 정의하기 위한 속성 |
다음은 위에서 언급한 속성들을 포함하고 있는 persistence.xml 파일의 일부이다
<property name="hibernate.dialect" value="org.hibernate.dialect.HSQLDialect"/>
다음은 Hibernate에서 제공하는 주요 Dialect 클래스 목록이다
| DB 종류 | Dialect 클래스 |
|---|---|
| Oracle 10g | org.hibernate.dialect.Oracle10gDialect |
| Oracle 9i/10i | org.hibernate.dialect.Oracle9iDialect |
| Oracle (모든 버전) | org.hibernate.dialect.OracleDialect |
| MySQL 5.x | org.hibernate.dialect.MySQL5Dialect |
| MySQL 4.x, 3.x | org.hibernate.dialect.MySQLDialect |
| DB2 | org.hibernate.dialect.DB2Dialect |
| Sybase 11.9.2 | org.hibernate.dialect.Sybase11Dialect |
| Sybase Anywhere | org.hibernate.dialect.SybaseAnywhereDialect |
Cache 속성
아래의 속성들을 통해 Hibernate는 Cache 기능을 지원한다.
| 속 성 명 | 설 명 |
|---|---|
| hibernate.cache.provider_class | Cache 기능을 구현하고 있는 구현체의 클래스명을 정의하기 위한 속성 |
| hibernate.cache.use_second_level_cache | 2nd Level Cache를 적용할지 여부를 정의하기 위한 속성 (true/false) |
| hibernate.cache.use_query_cache | Hibernate Query를 Caching할지 여부를 정의하기 위한 속성 (true/false) |
다음은 위에서 언급한 속성들을 포함하고 있는 persistence.xml 파일의 일부이다
<property name="hibernate.cache.use_second_level_cache" value="true"/>
<property name="hibernate.cache.use_query_cache" value="true"/>
<property name="hibernate.cache.provider_class" value="org.hibernate.cache.EhCacheProvider"/>
Logging 속성
아래의 속성들을 통해 Hibernate는 좀더 자세한 Logging 기능을 지원한다.
| 속 성 명 | 설 명 |
|---|---|
| hibernate.show_sql | Hibernate을 통해 생성된 SQL을 콘솔에 남길 것인지 여부를 정의하는 속성 (true/false) |
| hibernate.format_sql | hibernate.show_sql=true인 경우 해당 SQL문의 포맷을 정돈하여 콘솔에 남길 것인지 여부를 정의하는 속성 (true/false) |
| hibernate.use_sql_comments | Hibernate을 통해 생성된 SQL을 콘솔에 남길 때 Comments도 같이 남길 것인지 여부를 정의하는 속성 (true/false) |
다음은 위에서 언급한 속성들을 포함하고 있는 persistence.xml 파일의 일부이다
<property name="hibernate.show_sql" value="true"/>
<property name="hibernate.format_sql" value="true"/>
기타 속성
| 속 성 명 | 설 명 |
|---|---|
| hibernate.hbm2ddl.auto | DDL을 자동으로 검증,생성 또는 수정할지 여부를 정의하기 위한 속성 (validate/ update/ create/ create-drop) |
| hibernate.jdbc.batch_size | Hibernate는 일반적으로 실행해야 할 SQL들에 대해 일괄적으로 batch 처리를 수행하는데 이 때 batch로 처리할 SQL의 개수를 정의하기 위한 속성 |
다음은 위에서 언급한 속성들을 포함하고 있는 persistence.xml 파일의 일부이다
<property name="hibernate.hbm2ddl.auto" value="create-drop"/>
<property name="hibernate.jdbc.batch_size" value="10" />