jeus jpa 안내서 - kr.tmaxsoft.com · 즉, 웹 모듈이나, ejb 모듈, 애플리케이션...

JEUS

JPA 안내서

JEUS v6.0 Fix#8

Copyright © 2011 TmaxSoft Co., Ltd. All Rights Reserved.

Copyright Notice

Copyright © 2011 TmaxSoft Co., Ltd. All Rights Reserved.

대한민국 경기도 성남시 분당구 서현동 272-6 우) 463-824

Restricted Rights Legend

All TmaxSoft Software (JEUS®) and documents are protected by copyright laws and the Protection Act of Com

puter Programs, and international convention. TmaxSoft software and documents are made available under the

terms of the TmaxSoft License Agreement and may only be used or copied in accordance with the terms of this

agreement. No part of this document may be transmitted, copied, deployed, or reproduced in any form or by any

means, electronic, mechanical, or optical, without the prior written consent of TmaxSoft Co., Ltd.

이 소프트웨어(JEUS®) 사용설명서의 내용과 프로그램은 저작권법, 컴퓨터프로그램보호법 및 국제 조약에 의해

서 보호받고 있습니다. 사용설명서의 내용과 여기에 설명된 프로그램은 TmaxSoft Co., Ltd.와의 사용권 계약 하에

서만 사용이 가능하며, 사용권 계약을 준수하는 경우에만 사용 또는 복제할 수 있습니다. 이 사용설명서의 전부 또

는 일부분을 TmaxSoft의 사전 서면 동의 없이 전자, 기계, 녹음 등의 수단을 사용하여 전송, 복제, 배포, 2차적 저

작물작성 등의 행위를 하여서는 안 됩니다.

Trademarks

JEUS® is registered trademark of TmaxSoft Co., Ltd. Other products, titles or services may be registered trademarks

of their respective companies.

JEUS®는 TmaxSoft Co., Ltd.의 등록 상표입니다. 기타 모든 제품들과 회사 이름은 각각 해당 소유주의 상표로서

참조용으로만 사용됩니다.

Open Source Software Notice

This product includes open source software developed and/or licensed by "OpenSSL", "RSA Data Security, Inc.",

"Apache Foundation", and "Jean-loup Gailly and Mark Adler". Information about the aforementioned and the related

open source software can be found in the "${INSTALL_PATH}/license/oss_licenses" directory.

본 제품은 “OpenSSL”, “RSA Data Security, Inc.”, “Apache Foundation” 및 “Jean-loup Gailly와 Mark Adler”에 의

해 개발 또는 라이선스된 오픈 소스 소프트웨어를 포함합니다. 관련 상세 정보는 제품의 디렉터리 “${IN

STALL_PATH}/license/oss_licenses”에 기재된 사항을 참고해 주십시오.

안내서 정보

안내서 제목: JEUS JPA 안내서

발행일: 2011-11-04

소프트웨어 버전: JEUS v6.0 Fix #8

안내서 버전: v2.1.3

내용 목차

안내서에 대하여 ........................................................................................................................... ix

제1장 소개 ................................................................................................................................. 1

제2장 프로바이더 설정 ................................................................................................................ 3

2.1. 데이터베이스 설정 ....................................................................................................... 3

2.1.1. 사용환경별 설정 ................................................................................................ 3

2.1.2. 데이터베이스 타입 설정 ..................................................................................... 5

2.1.3. 스키마 자동 생성 설정 ........................................................................................ 6

2.2. Caching ....................................................................................................................... 7

2.3. Query 힌트 .................................................................................................................. 9

2.4. Logging 설정 .............................................................................................................. 10

제3장 프로바이더 변경 .............................................................................................................. 11

3.1. Persistence 프로바이더 변경 ....................................................................................... 11

3.2. 사용 가능한 Persistence 프로바이더 ............................................................................ 12

용어해설 ..................................................................................................................................... 13

색인 ............................................................................................................................................ 15

JEUS iii

표 목차

[표 2.1] Java SE 모드 데이터베이스 프로퍼티 ............................................................................... 4

[표 2.2] toplink.target-데이터베이스 프로퍼티 ............................................................................... 5

[표 2.3] Java Type to SQL Type Mappings ..................................................................................... 6

JEUS v

예 목차

[예 2.1] Java EE 모드에서 데이터베이스 설정 예 ........................................................................... 3

[예 2.2] Java SE 모드에서 데이터베이스 설정 예 ........................................................................... 4

[예 2.3] 데이터베이스 타입 설정 예 .............................................................................................. 5

[예 2.4] Query 힌트 사용 예제 ...................................................................................................... 9

[예 3.1] Persistence 프로바이더 변경 예 ..................................................................................... 11

JEUS vii

안내서에 대하여

안내서의 대상

본 안내서는 JEUS에서 Java Persistence API를 이용하여 개발하고자 하는 개발자를 대상으로 하고 있다.

안내서의 전제 조건

본 안내서를 원활하게 이해하기 위해서는 다음과 같은 사항을 미리 알고 있어야 한다.

● JEUS 소개

● JEUS 설치 및 시작하기

안내서의 제한 조건

본 안내서에서는 Java EE와 Java 스펙에 대한 것은 설명하지 않고, JEUS 관련 내용만 설명한다.

안내서 구성

본 안내서는 총 3개의 장으로 구성되어 있다.

● “제1장 소개”

JPA와 JEUS에 대해 설명한다.

● “제2장 프로바이더 설정”

JEUS의 기본 프로바이더의 설정에 대해 설명한다.

● “제3장 프로바이더 변경”

JEUS의 기본 프로바이더를 변경하는 방법에 대해 설명한다.

안내서에 대하여 ix

안내서 규약

의미표기

프로그램 소스 코드의 파일명<<AaBbCc123>>

Ctrl과 C를 동시에 누름<Ctrl>+C

GUI의 버튼 또는 메뉴 이름[Button]

강조진하게

다른 관련 안내서 또는 안내서 내의 다른 장 및 절 언급" "(따옴표)

화면 UI에서 입력 항목에 대한 설명'입력항목'

메일계정, 웹 사이트하이퍼링크

메뉴의 진행 순서>

하위 디렉터리 또는 파일 있음+----

하위 디렉터리 또는 파일 없음|----

참고 또는 주의사항참고

주의할 사항주의

그림 이름[그림 1.1]

표 이름[표 1.1]

Java 코드, XML 문서AaBbCc123

옵션 파라미터[ command argument ]

‘<’와 ‘>’ 사이의 내용이 실제 값으로 변경됨< xyz >

선택 사항. 예) A|B: A나 B 중 하나|

파라미터 등이 반복되어서 나옴…

x JEUS JPA 안내서

시스템 사용 환경

본 안내서는 모든 예제와 환경 구성을 Microsoft Windows™의 스타일을 따랐다. UNIX와 같은 다른 환경

에서 작업하는 사람은 몇 가지 사항만 고려하면 별 무리없이 사용할 수 있다. 대표적인 것이 디렉터리 구

분자인데, Windows 스타일인 “\”를 UNIX 스타일인 “/”로 바꿔서 사용하면 무리가 없다. 이외에 환경변수도

UNIX 스타일로 변경해서 사용하면 된다.

그러나 Java 표준을 고려해서 문서를 작성했기 때문에, 대부분의 내용은 동일하게 적용된다.

관련 안내서

설명안내서

JEUS 6 서버에 대한 전반적인 소개와 JEUS의 아키텍처를 포함하

여 각 구성 요소들에 대해 설명한 안내서이다.

JEUS 소개

JEUS에 대한 소개와 설치 및 시작 방법에 대해 기술한 안내서이다.JEUS 설치 및 시작하기

JEUS 시스템과 서버의 개요와 시스템 관리를 위한 안내서이다.JEUS Server 안내서

참고 자료

● Java EE 5 Tutorial, Part 4: Java Persistence

http://www.oracle.com/technetwork/java/javaee/documentation/tutorials-137605.html

● Pro EJB 3 Java Persistence API, Mike Keith and Merrick Schincariol, Apress

● Enterprise JavaBeans 3.0 5th ed., Bill Burke and Richard Monson-Haefel, O’Reilly

● Mastering Enterprise JavaBeans 3.0 3rd ed., Rima Patel Sriganesh, Gerald Brose, Micah Silverman,

Wiley

● Sun Microsystems, Inc.의 EJB 3.0 Specification - Java Persistence API 1.0

안내서에 대하여 xi

http://www.oracle.com/technetwork/java/javaee/documentation/tutorials-137605.html

연락처

Korea

TmaxSoft Co., Ltd

272-6, Seohyeon-dong, Bundang-gu,

Seongnam-si, Gyeonggi-do, 463-721

South Korea

Tel: +82-31-8018-1000

Fax: +82-31-8018-1115

Email: [email protected]

Web (Korean): http://www.tmax.co.kr

기술지원: http://technet.tmaxsoft.com

USA

TmaxSoft, Inc.

560 Sylvan Avenue Englewood Cliffs, NJ 07632

U.S.A

Tel: +1-201-567-8266

Fax: +1-201-567-7339


Web (English): http://www.tmaxsoft.com

Japan

TmaxSoft Japan Co., Ltd.

5F Sanko Bldg, 3-12-16 Mita, Minato-Ku, Tokyo, 108-0073

Japan

Tel: +81-3-5765-2550

Fax: +81-3-5765-2567


Web (Japanese): http://www.tmaxsoft.co.jp

xii JEUS JPA 안내서

http://www.tmax.co.kr

http://technet.tmaxsoft.com

http://www.tmaxsoft.com

http://www.tmaxsoft.co.jp

China

TmaxSoft China Co., Ltd.

Beijing Silver Tower, RM 1508, 2# North Rd Dong San Huan,

Chaoyang District, Beijing, China, 100027

China

Tel: +86-10-6410-6145~8

Fax: +86-10-6410-6144


Web (Chinese): http://www.tmaxsoft.com.cn

안내서에 대하여 xiii

http://www.tmaxsoft.com.cn

제1장 소개

Java Persistence API(이하 JPA)는 관계형 데이터베이스에 접근하기 위한 표준 ORM 기술을 제공하며,

기존에 EJB에서 제공되던 CMP Entity Bean을 대체하는 기술이다.

JEUS는 JPA 스펙의 기능을 모두 지원한다. JPA는 JSR 220에서 정의된 EJB 3.0 스펙의 일부로 정의가

되어 있지만, JPA는 EJB 컨테이너에 의존하지 않으며 EJB, 웹 모듈 및 Java SE Standalone 클라이언트

에서 모두 사용이 가능하다.

또한, JPA는 사용자가 원하는 Persistence 프로바이더(Provider) 구현체를 선택해서 사용할 수 있다. JEUS

에서는 기본적으로 GlassFish 프로젝트의 TopLink Essentials 구현체를 제공한다. 그리고 Fix#7부터는

TopLink 를 기반으로 오픈 소스화한 EclipseLink 구현체를 시스템 라이브러리로 제공하고 있다. 그리고 필

요에 따라 다른 구현체를 선택해서 사용할 수 있다. 이에 대한 자세한 사항은 “3.1. Persistence 프로바이

더 변경”을 참고한다.

실제 JPA를 사용할 때는 JPA 스펙에서 제공하는 기본적인 API나 설정과 프로바이더의 특성을 함께 고려

해야 한다. 특히, Caching과 같은 것은 중요한 특성으로 이를 모르고 애플리케이션을 개발하면 원하는 결

과를 얻지 못할 수도 있다. 따라서, JPA를 환경에 따라 적절하게 구성해서 개발해야 한다. 이러한 것들은

앞으로 다양한 패턴을 통해 소개될 것이므로 GlassFish 프로젝트나 TopLink JPA 사이트를 계속 참조하기

를 권장한다.

● GlassFish 프로젝트

http://glassfish.dev.java.net

● TopLink JPA Resources

http://www.oracle.com/technology/products/ias/toplink/jpa/resources-index.html

본 안내서는 JEUS의 기본 프로바이더인 TopLink Essentials를 JEUS에서 사용하는데 필요한 설정에 대

해서만 설명한다. JPA 기술 자체나 프로그래밍 방법에 대해서는 다루고 있지 않기 때문에 이에 대해서는

본 안내서의 참고 자료 부분을 참고한다.

제1장 소개 1

http://glassfish.dev.java.net

http://www.oracle.com/technology/products/ias/toplink/jpa/resources-index.html

제2장 프로바이더 설정

본 장에서는 JEUS의 기본 프로바이더인 TopLink Essentials에 대한 설정을 설명한다. 이러한 설정은 JPA

스펙에서 정의되지 않는 기능을 구현하기 위해 필요한 부분으로, 각 애플리케이션에 맞게 정확하게 설정

되어야 한다.

2.1. 데이터베이스 설정사용환경, 데이터베이스 타입에 따른 데이터베이스 설정과 자동으로 데이터베이스 스키마를 생성하는 설

정에 대해 설명한다.

2.1.1. 사용환경별 설정

사용환경에 따라 데이터베이스의 설정 방법이 달라진다.

Java EE 환경

여기에서 Java EE 환경(혹은 모드)이라고 하는 것은 JPA가 JEUS의 컨테이너에서 사용될 때를 의미한다.

즉, 웹 모듈이나, EJB 모듈, 애플리케이션 클라이언트 모듈에서 JPA를 사용할 때 이를 Java EE 모드에서

사용한다고 말한다.

사용할 데이터베이스 대상에 대한 설정은 persistence.xml Descriptor에 설정한다. 이때, 사용할 트랜잭션

의 종류에 따라서 <jta-data-source>와 <non-jta-data-source> 값을 설정한다.

● 글로벌 트랜잭션을 사용하는 경우

<transaction-type>의 값을 JTA로 지정하고, <jta-data-source>에 해당 Data Source의 JNDI 이름을

설정한다.

● 로컬 트랜잭션을 사용하는 경우

<transaction-type>의 값을 RESOURCE_LOCAL로 설정하고 <non-jta-data-source>에 해당 Data

Source의 JNDI 이름을 설정한다.

[예 2.1] Java EE 모드에서 데이터베이스 설정 예

<?xml version="1.0" encoding="UTF-8"?>

<persistence xmlns="http://java.sun.com/xml/ns/persistence">

<persistence-unit name="em" transaction-type="JTA">

<jta-data-source>jdbc/MyDB</jta-data-source>

</persistence-unit>

</persistence>

제2장 프로바이더 설정 3

참고

1. Java EE 환경에서는 <transaction-type> 값을 지정하지 않을 경우, 기본적으로 JTA 트랜잭션으로

설정한다.

2. JEUS에서 DB 데이터 소스를 설정하는 방법은 “JEUS Server 안내서”의 “8.3. JDBC 데이터 소스

설정”을 참고한다.

Java SE 환경

Java SE 환경(혹은 모드)은 Java EE 컨테이너에서 사용하지 않는 경우이다. 예를 들어 Java stand-alone

클라이언트와 같은 환경에서 사용하는 경우를 말한다. 이때는 로컬 트랜잭션만 사용할 수 있으며, 사용되

는 데이터베이스의 JDBC 설정을 프로퍼티로 설정해야 한다.

다음의 예제와 같이 <transaction-type>의 값을 RESOURCE_LOCAL로 설정한다.

[예 2.2] Java SE 모드에서 데이터베이스 설정 예



<persistence-unit name="em" transaction-type="RESOURCE_LOCAL">

<properties>

<property name="toplink.jdbc.driver"

value="org.apache.derby.jdbc.ClientDriver"/>

<property name="toplink.jdbc.url"

value="jdbc:derby://localhost:1527/testdb"/>

<property name="toplink.jdbc.user" value="APP"/>

<property name="toplink.jdbc.password" value="APP"/>

</properties>

</persistence-unit>

</persistence>

다음은 프로퍼티 값에 대한 설명이다.

[표 2.1] Java SE 모드 데이터베이스 프로퍼티

설명프로퍼티 값

대상 데이터베이스의 JDBC 드라이버 클래스 이름이다.toplink.jdbc.driver

대상 데이터베이스의 JDBC URL이다.toplink.jdbc.url

대상 데이터베이스의 사용자명이다.toplink.jdbc.user

대상 데이터베이스의 패스워드이다.toplink.jdbc.password

4 JEUS JPA 안내서

2.1.2. 데이터베이스 타입 설정

기본적으로 해당 데이터베이스 타입을 JDBC 커넥션 정보를 통해 자동으로 감지한다. 하지만, 자동 감지

기능이 제대로 동작하지 않거나, 별도의 다른 데이터베이스를 사용하는 경우라면 toplink.target-database

프로퍼티를 설정할 수 있다.

참고

데이터베이스 타입은 JDBC 드라이버의 DatabaseMetaData.getDatabaseProductName()을 이용하

여, 데이터베이스 벤더 이름을 regular expression으로 비교하는 방식을 사용한다.

[예 2.3] 데이터베이스 타입 설정 예



<persistence-unit name="em">


<properties>

<property name="toplink.target-database" value="DB2"/>

</properties>

</persistence-unit>

</persistence>

다음은 지원되는 데이터베이스 타입 값에 대한 설명이다.

[표 2.2] toplink.target-데이터베이스 프로퍼티

설명값

(Default) 자동 감지Auto

Attunity DBMSAttunity

Cloudscape DBMSCloudscape

IBM DB2 DBMSDB2

IBM DB2 Mainframe DBMSDB2Mainframe

DBase DBMSDBase

Apache Derby DBMSDerby

HSQL DBMSHSQL

Informix DBMSInformix

JavaDB DBMSJavaDB

MySQL DBMSMySQL4

Oracle DBMSOracle

PointBase DBMSPointBase


설명값

PostreSQL DBMSPostreSQL

SQLAnywhere DBMSSQLAnyWhere

Microsoft SQLServer DBMSSQLServer

Sybase DBMSSybase

Oracle Timesten DBMSTimesTen

기본적으로 지원되지 않는 DBMS를 추가할 때 사용한다.Customized class name

기본적으로 지원되지 않는 DBMS의 경우 별도로 DBMS 지원 기능을 구현하여 사용할 수 있다. 이때는 해

당 클래스 이름을 지정하면 된다. 이에 대한 자세한 정보는 본 안내서의 참고 자료 부분을 참고한다.

2.1.3. 스키마 자동 생성 설정

자동으로 DB 스키마를 생성하는 기능을 이용하는 경우 설정한다. 이를 이용하면 애플리케이션을 디플로

이할 때 DB 테이블 및 제약 사항(Constraints)을 자동으로 생성한다.

관련된 프로퍼티 설정은 다음과 같다.

● toplink.ddl-generation

스키마 DDL(Data Descriptor Language)을 어떤식으로 생성할지 설정한다.

설명옵션

아무것도 하지 않는다. (기본값)none

존재하지 않는 테이블을 생성하며, 기존 테이블은 그대로 남겨둔다.create-tables

기존에 존재하는 테이블을 삭제하고 다시 생성한다.drop-and-create-tables

DDL을 생성할 때 기본적으로 다음과 같이 Java 타입을 해당 데이터베이스 SQL 타입에 맞게 생성한다.

[표 2.3] Java Type to SQL Type Mappings

MySQLSQLServerSybaseDB2OracleDerby,

JavaDB,

Cloudscape

Java Type

TINYINT(1)BITBITSMALLINTNUMBER(1)SMALLINTboolean,

Boolean

INTEGERINTEGERINTEGERINTEGERNUMBER(10)INTEGERint, Integer

BIGINTNUMER

IC(19)

NUMER

IC(19)

INTEGERNUMBER(19)BIGINTlong, Long

FLOATFLOAT(16)FLOAT(16)FLOATNUMER

IC(19,4)

FLOATfloat, Float


MySQLSQLServerSybaseDB2OracleDerby,

JavaDB,

Cloudscape

Java Type

DOUBLEFLOAT(32)FLOAT(32)FLOATNUMER

IC(19,4)

FLOATdouble, Dou

ble

SMALLINTSMALLINTSMALLINTSMALLINTNUMBER(5)SMALLINTshort, Short

SMALLINTSMALLINTSMALLINTSMALLINTNUMBER(3)SMALLINTbyte, Byte

DECIMAL(38)NUMER

IC(28)

NUMER

IC(38)

DECIMAL(15)NUMBER(38)DECIMALja

va.lang.Num

ber

BIGINTNUMER

IC(28)

NUMER

IC(38)

BIGINTNUMBER(38)BIGINTjava.math.Big

Integer

DECIMAL(38)NUMER

IC(28)

NUMER

IC(38)

DECIMAL(15)NUMBER(38)DECIMALja

va.math.BigDec

imal

VAR

CHAR(255)

VAR

CHAR(255)

VAR

CHAR(255)

VAR

CHAR(255)

VAR

CHAR(255)

VAR

CHAR(255)

ja

va.lang.String

CHAR(1)CHAR(1)CHAR(1)CHAR(1)CHAR(1)CHAR(1)char, Charac

ter

TEXT(64000)TEXTTEXTBLOB(64000)LONG RAWBLOB(64000)byte[], Byte[],

java.sql.Blob

TEXT(64000)TEXTTEXTCLOB(64000)LONGCLOB(64000)char[], Char

acter[], ja

va.sql.Clob

DATEDATETIMEDATETIMEDATEDATEDATEjava.sql.Date

TIMEDATETIMEDATETIMETIMEDATETIMEjava.sql.Time

DATETIMEDATETIMEDATETIMETIMESTAMPDATETIMESTAMPja

va.sql.Times

tamp

2.2. CachingJPA에서는 기본적으로 Persistence Context라고 하는 1st-level Caching을 지원하고 있다. 하지만, 일반적

으로 Persistence Context는 트랜잭션별로 새로 생성되기 때문에(Extended Persistence Context는 이에

해당하지 않음) 트랜잭션 간에 Caching을 지원하지 않는다. 이를 보완하기 위해 TopLink Essentials에서

는 2nd-level Caching 기능을 제공한다.

2nd-level Caching은 EntityManagerFactory 레벨에서 지원되기 때문에, 동일한 EntityManagerFactory에

서 생성된 모든 EntityManager의 경우 이 공유 Cache를 사용하게 된다. 즉, Persistence Context에 없는


Entity를 가져올 때 2nd-level Caching을 참고하여 존재하는 경우에 이를 가져온다. 따라서 반복적인 Read

작업의 경우 성능 향상을 가져오게 된다.

Caching에 관련된 옵션은 다음을 참고한다.

● toplink.cache.type.default

Caching 방식을 설정한다.

설명옵션

객체를 Hard reference로 Caching한다. 따라서 Entity가 삭제되기 전까지 항상 Cache에

존재하게 된다.

Full

Weak와 유사하며, 자주 사용되는 객체는 Hard reference로 Caching한다.HardWeak

Weak와 유사하며, 자주 사용되는 객체는 Soft reference로 Caching한다. 자주 사용되는

객체는 메모리가 부족할 때 사라진다. (기본값)

SoftWeak

객체를 Weak reference로 Caching한다. Garbage Collection(GC)이 되면 사라진다.Weak

객체를 Cache에 저장하지 않는다. 사용을 권장하지 않으며 Caching 기능을 이용하고 싶

지 않다면, toplink.cache.shared.xxx 프로퍼티를 설정하기를 권장한다.

NONE

● toplink.cache.size.default

Cache에 저장될 최대 객체수를 설정한다. (기본값 : 1000)

● toplink.cache.shared.default

공유 Cache를 사용할지 여부를 설정한다.

설명옵션

객체가 공유 Cache에 저장된다. 모든 EntityManager는 Caching을 사용하게 된다.true

(기본값)

객체가 공유 Cache에 저장되지 않는다. 따라서, EntityManager별로 Cache를 공유하지

않는다. 이를 사용하면 2nd-level Caching을 하지 않는 효과가 있다.

false

● toplink.cache.type.<ENTITY>

Entity 별로 Caching을 하는 방식을 지정한다. <ENTITY>는 Entity 이름 혹은 fully-qualified 클래스 이름

이 될 수 있다. 해당 Entity와 관계를 가지는 모든 Entity는 같은 설정을 가져야 한다.

toplink.cache.type.default [8]의 값 설명과 동일하다.

● toplink.cache.size.<ENTITY>

Entity 별로 Cache 사이즈를 지정한다. <ENTITY>는 Entity 이름 혹은 fully-qualified 클래스 이름이 될

수 있다. toplink.cache.size.default [8]의 값 설명과 동일하다.

● toplink.cache.shared.<ENTITY>


Entity 별로 공유 Cache를 사용할지를 지정한다. <ENTITY>는 Entity 이름 혹은 fully-qualified 클래스 이

름이 될 수 있다. 해당 Entity와 관계를 가지는 모든 Entity는 동일한 설정을 가져야 한다.

toplink.cache.shared.default [8]의 값 설명과 동일하다.

주의

2nd-level Caching이 사용될 때 주의할 것은 외부 애플리케이션에 의해 혹은 직접 데이터베이스의

데이터를 변경하는 경우 해당 내용이 Caching에 반영되지 않는다는 점이다. 이런 경우, 데이터베이

스의 최신 값이 아닌 Caching된 값이 리턴되기 때문에 애플리케이션에 이를 고려해야 한다.

Caching 옵션을 애플리케이션 환경을 고려하여 적절히 설정하거나, EntityManager.refresh() ,

toplink.refresh Query 힌트 혹은 locking(pessimistic/optimistic) 등을 사용하여 이런 문제를 피할 수

있다.

2.3. Query 힌트Query 힌트는 Query 객체를 사용할 때 프로바이더에서 제공하는 기능을 사용할 수 있도록 한다.

Query 힌트는 다음 예제와 같이 Query를 실행할 때 설정할 수도 있고, Named Query를 사용하는 경우

@QueryHint Annotation을 사용하여 지정할 수도 있다.

[예 2.4] Query 힌트 사용 예제

List employees

= em.createQuery("SELECT e FROM Employee e WHERE e.name = :name")

.setParameter("name", name)

.setHint("toplink.refresh", true)

.getResultList();

제공하는 Query 힌트는 다음과 같다.

● toplink.pessimistic-lock

SELECT할 때 Pessimistic Locking을 사용할지 여부를 설정한다.

설명옵션

사용하지 않는다. (기본값)NoLock

SELECT ... FOR UPDATE 문을 이용해 Locking을 한다.Lock

SELECT ... FOR UPDATE NO WAIT 문을 이용해 Locking을 한다.NoLockWait

● toplink.refresh

데이터베이스에서 최신값을 가져와 Caching을 업데이트할지 여부를 설정한다.

설명옵션

최신값을 가져오고 Caching을 업데이트한다.true


설명옵션

Cache에 있는 값을 사용한다. (기본값)false

2.4. Logging 설정좀 더 자세한 로그를 보고 싶다면 Logging 레벨을 설정할 수 있다.

기본적으로 Logging 레벨은 JEUS 서버에 전체적으로 적용되는 레벨(기본적으로 INFO)을 따르게 되지만,

이를 Persistence Unit별로 변경할 경우 toplink.logging.level 프로퍼티로 설정할 수 있다. Logger의 경우

Java EE 모드에서는 기본적으로 JEUS에서 제공되는 Logger(JEUS Logger)를 사용하게 되며, Java SE

모드에서는 standard output으로 출력되는 DefaultLogger를 사용하게 된다. 이를 변경하려면 toplink.log

ging.logger 프로퍼티로 설정할 수 있다.

다음은 설정에 대한 자세한 설명이다.

● toplink.logging.level

Logging 레벨을 지정한다.

– OFF: Logging을 하지 않는다.

– SEVERE

– WARNING

– INFO(기본값)

– CONFIG

– FINE: SQL 관련 정보를 보고 싶다면, 이 레벨로 설정한다.

– FINER

– FINEST

● toplink.logging.logger

사용할 Logger를 지정한다.

설명옵션

JEUS에서 제공되는 Logger이다. (Java EE 모드인 경우 기본값)JEUSLogger

기본 standard output Logger이다. (Java SE 모드인 경우 기본값)DefaultLogger

java.util.logging Logger이다.JavaLogger

별도의 Logger를 구현한 경우 지정한다.Custom class name

참고

TopLink Essentials에 대한 자세한 설정은 TopLink JPA Extensions Reference를 참고한다.

http://www.oracle.com/technology/products/ias/toplink/jpa/resources/toplink-jpa-extensions.html


http://www.oracle.com/technology/products/ias/toplink/jpa/resources/toplink-jpa-extensions.html

제3장 프로바이더 변경

본 장에서는 JEUS의 기본 프로바이더를 변경하는 방법에 대해서 설명한다.

3.1. Persistence 프로바이더 변경JEUS에서 기본적으로 제공되는 프로바이더(TopLink Essentials)가 아닌 다른 프로바이더를 사용하려면

JPA 스펙에 따라서 이를 지원한다.

먼저 필요한 라이브러리들을 JEUS_HOME\lib\application에 복사하거나 또는 각 애플리케이션 별로 패키

징한다. 그리고 해당 프로바이더 클래스 이름을 persistence.xml의 <provider> 값에 설정하면, Persistence

Unit 별로 설정한 프로바이더를 사용하게 된다. 프로바이더 클래스 이름과 관련 프로퍼티 값들도 각 프로

바이더 별로 다르므로 해당 문서를 참고하여 설정해야 한다.

예를 들어, Hibernate를 사용하는 경우 다음과 같이 설정한다.

[예 3.1] Persistence 프로바이더 변경 예



<persistence-unit name="em">

<provider>org.hibernate.ejb.HibernatePersistence</provider>


<properties>



</properties>

</persistence-unit>

</persistence>

JEUS 6 Fix#7부터 시스템 라이브러리(JEUS_HOME/lib/system/eclipselink.jar)로 EclipseLink를 제공하고

있다. 만약 EclipseLink를 사용하려면 <provider> 값으로 org.eclipse.persistence.jpa.PersistenceProvider

를 설정한다.

위와 같이 Persistence Unit별로 프로바이더를 변경할 수도 있지만, JEUS의 디폴트 프로바이더를 변경할

수도 있다. JEUS를 구동시킬 때 시스템 프로퍼티 jeus.persistence.defaultProvider를 해당 프로바이더 클

래스 이름으로 설정하면 프로바이더가 지정되지 않는 모든 Persistence Unit의 경우 해당 디폴트 프로바

이더를 사용하게 된다.

참고

JEUS 시스템 프로퍼티 설정은 "JEUS Server 안내서"나 "JEUS Reference Book"을 참고한다.

제3장 프로바이더 변경 11

3.2. 사용 가능한 Persistence 프로바이더다른 Persistence 프로바이더에 대해서는 다음의 각 사이트를 참고한다.

● EclipseLink

http://www.eclipse.org/eclipselink

● Hibernate EntityManager

http://www.hibernate.org

● OpenJPA

http://openjpa.apache.org

● BEA Kodo

http://www.bea.com


http://www.eclipse.org/eclipselink

http://www.hibernate.org

http://openjpa.apache.org

http://www.bea.com

용어해설

글로벌 트랜잭션

여러 XA 자원(데이타베이스)들을 포괄하는 트랜잭션을 말한다. 분산 트랜잭션이라고도고 하며, 보통 2 Phase

Commit을 통해 트랜잭션을 단일성을 보장한다.

로컬 트랜잭션

글로벌 트랜잭션과 달리 하나의 자원에만 범위를 가지는 트랜잭션을 말한다.

EJB

Enterprise Java Beans이다.

EntityManager

javax.persistence.EntityManager 객체이다.

EntityManagerFactory

javax.persistence.EntityManagerFactory 객체이다.

JPA

Java Persistence API 약자이다.

named query

Java Persistence API에서 XML Descriptor나 Annotation으로 지정된 Query이다.

ORM

Object Relational Mapping 약어이다.

persistence 프로바이더

Java Persistence API를 지원하는 구현체이다.

persistence context

Java Persistence API에서 현재 관리되고 있는 Entity Instance의 집합이다.

persistence unit

Java Persistence API에서 관리되는 논리적인 단위로, Entity 클래스와 매핑 정보를 포괄한다.

용어해설 13

색인

Symbols2nd-level Caching, 7

CCaching, 7

LLogger, 10

PPersistence Provider, 1, 11

Persistence 프로바이더, 3

Ttoplink.cache.shared.<ENTITY>, 8

toplink.cache.shared.default, 8

toplink.cache.size.<ENTITY>, 8

toplink.cache.size.default, 8

toplink.cache.type.<ENTITY>, 8

toplink.cache.type.default, 8

toplink.ddl-generation, 6

toplink.jdbc.driver, 4

toplink.jdbc.password, 4

toplink.jdbc.url, 4

toplink.jdbc.user, 4

toplink.logging.level, 10

toplink.logging.logger, 10

toplink.pessimistic-lock, 9

toplink.refresh, 9

색인 15

jeus jpa 안내서 - kr.tmaxsoft.com · 즉, 웹 모듈이나, ejb 모듈, 애플리케이션...

Documents