[hibernate-commits] Hibernate SVN: r10956 - in branches/Branch_3_2/Hibernate3/doc/reference/ko: . fop modules styles
hibernate-commits at lists.jboss.org
hibernate-commits at lists.jboss.org
Fri Dec 8 03:07:55 EST 2006
Author: christian.bauer at jboss.com
Date: 2006-12-08 03:07:27 -0500 (Fri, 08 Dec 2006)
New Revision: 10956
Modified:
branches/Branch_3_2/Hibernate3/doc/reference/ko/README-KO.txt
branches/Branch_3_2/Hibernate3/doc/reference/ko/fop/userconfig.xml
branches/Branch_3_2/Hibernate3/doc/reference/ko/master.xml
branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/architecture.xml
branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/association_mapping.xml
branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/basic_mapping.xml
branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/batch.xml
branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/collection_mapping.xml
branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/component_mapping.xml
branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/configuration.xml
branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/events.xml
branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/example_mappings.xml
branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/inheritance_mapping.xml
branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/performance.xml
branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/persistent_classes.xml
branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/query_criteria.xml
branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/query_hql.xml
branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/query_sql.xml
branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/session_api.xml
branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/transactions.xml
branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/tutorial.xml
branches/Branch_3_2/Hibernate3/doc/reference/ko/styles/fopdf.xsl
Log:
Synchronized KO translation between 3.2 branch and trunk
Modified: branches/Branch_3_2/Hibernate3/doc/reference/ko/README-KO.txt
===================================================================
--- branches/Branch_3_2/Hibernate3/doc/reference/ko/README-KO.txt 2006-12-08 08:01:55 UTC (rev 10955)
+++ branches/Branch_3_2/Hibernate3/doc/reference/ko/README-KO.txt 2006-12-08 08:07:27 UTC (rev 10956)
@@ -9,28 +9,56 @@
Blog : http://blog.naver.com/jdkim528/
[Down/Config/Build]
- cvs Ŭ¶óÀ̾ðÆ®¸¦ °®°í ÀÖ´Ù¸é,
- 1)¿¬°á À¯Çü : pserve/extssh Áß Çϳª¸¦ ¼±ÅÃÇÕ´Ï´Ù
- 2)»ç¿ëÀÚÀ̸§ : anonymous
- 3)È£½ºÆ® : cvs.sourceforge.net
- 4)Æ÷Æ® : ±âº»°ª
- 5)ÀúÀå¼Ò°æ·Î : /cvsroot/hibernate
- 6)¸ðµâ : Hibernate3/doc/reference
- À§¿Í °°ÀÌ ¿¬°á Á¤º¸¸¦ ÀÔ·Â ÇϽŠÈÄ REFERENCE Àüü¸¦ ³»·Á¹ÞÀ¸¼Åµµ µÇÁö¸¸,
- ÇÑ±Û ¹ø¿ªº»¸¸ ÇÊ¿äÇÏ½Ã´Ù¸é ´ÙÀ½°ú °°ÀÌ Çϼŵµ µË´Ï´Ù.
- [°¡]. °øÅë ¸ðµâ ¹Þ±â
- À§¿¡¼ 6)¸ðµâÀ» Hibernate3/doc/reference/support·Î ÁöÁ¤ÇϽðí
- ·ÎÄà ÄÄÇ»ÅÍÀÇ µð·ºÅ丮 [·ÎÄà °æ·Î]/reference/ ÇÏ¿¡ ¹Þ½À´Ï´Ù
- [³ª]. Çѱۺ» ¸ðµâ ¹Þ±â
- À§¿¡¼ 6)¸ðµâÀ» Hibernate3/doc/reference/ko·Î ÁöÁ¤ÇÏ°í
- ·ÎÄà ÄÄÇ»ÅÍÀÇ µð·ºÅ丮 [·ÎÄà °æ·Î]/reference/ ÇÏ¿¡ ¹Þ½À´Ï´Ù.
- [´Ù]. ºôµå ÆÄÀÏ ¹Þ±â
- ±×·± ´ÙÀ½ /doc/reference/build.xml ÆÄÀÏÀ» ³»·Á ¹ÞÀº ´ÙÀ½
+ * ±âÁ¸ÀÇ CVS¿¡¼ SVNÀ¸·Î ¹Ù²î¸é¼ ½Å±Ô »ç¿ëÀÚµéÀ» À§ÇÑ ±æÀâÀ̸¦ ÀÛ¼ºÇÒ ÇÊ¿ä°¡
+ »ý°å³×¿ä...
+
+ ÇÊÀÚ´Â °³ÀÎÀûÀ¸·Î TortoiseSVN°ú Subclipse¸¦ »ç¿ëÇÏ°í ÀÖÀ¸³ª Subclpse¸¦ Áß½ÉÀ¸·Î
+ ¼³¸íÇÒ±î ÇÕ´Ï´Ù.(¼±È£ÇÏ´Â svn Ŭ¶óÀ̾ðÆ®°¡ ÀÖ´Ù¸é ÇØ´ç Ŭ¶óÀ̾ðÆ®ÀÇ ¼³Á¤¿¡
+ µû¶ó ¼³Á¤ÇÑ ÈÄ¿¡ »ç¿ëÇϼŵµ µÉ °ÍÀÔ´Ï´Ù.)
+
+ [Subclipse ¼³Ä¡]
+
+ Subclipse¸¦ ¼³Ä¡ÇÏ´Â ¹æ¹ýÀº http://subclipse.tigris.org/install.html À» ÂüÁ¶ÇÏ¿©
+ eclipseÀÇ µµ¿ò¸»>¼ÒÇÁÆ®¿þ¾î°»½Å>ã±â ¹× ¼³Ä¡ ¸Þ´º¸¦ ÅëÇØ ½±°Ô ¼³Ä¡ÇÒ ¼ö ÀÖ½À´Ï´Ù.
+
+ [Subclipse Checkout]
+ 0) Subclipse ¼³Ä¡°¡ ³¡³µÀ¸¸é ÀÌŬ¸³½º¸¦ Àç½ÃÀÛÇϽʽÿÀ.
+ 1) ÀÌŬ¸³½ºÀÇ Perspective ¿±â¿¡¼ SVN Repository exploringÀ» ¿¾î ÀúÀå¼Ò¸¦ µî·ÏÇÏ¿© »ç¿ëÇϰųª
+ ÀÌŬ¸³½ºÀÇ ÆÐÅ°Áö Ž»ö±â¿¡¼ ¸¶¿ì½º ¿À¸¥ÂÊ Æ˾÷ ¸Þ´º¿¡¼ "ÇÁ·ÎÁ§Æ®"¸¦ »ý¼º½Ãŵ´Ï´Ù.
+ ¿©±â¼´Â "ÇÁ·ÎÁ§Æ®" »ý¼º ¹æ¹ýÀ» ¼³¸íÇÕ´Ï´Ù.
+ 2) ÀÌŬ¸³½ºÀÇ ÆÐÅ°Áö Ž»ö±â¿¡¼ ¸¶¿ì½º ¿À¸¥ÂÊ Æ˾÷ ¸Þ´º¿¡¼ "ÇÁ·ÎÁ§Æ®"¸¦ Ŭ¸¯ÇÑ´Ù
+ 3) Æ˾÷ âÀÇ "SVN" ³ëµå¿¡¼ "Checkout Projects from SVN"À» ¼±ÅÃÇÑ´Ù
+ 4) "´ÙÀ½" ¹öÆ°À» Ŭ¸¯ÇÑ´Ù
+ 5) "Create a new respository location"À» ¼±ÅÃÇÑ´Ù
+ 6) ´ÙÀ½" ¹öÆ°À» Ŭ¸¯ÇÑ´Ù
+ 7) Location url¿¡ "http://anonhibernate.labs.jboss.com/trunk/Hibernate3" ¶Ç´Â
+ "https://hibernate.labs.jboss.com/repos/hibernate/trunk" À» ÀÔ·ÂÇÕ´Ï´Ù.
+ 8) "Hibernate3" ³ëµå´Â ¼±ÅÃÇϰųª ÇÏÀ§ÀÇ Æ¯Á¤ ³ëµå¸¦ ¼±ÅÃÇÏ°í "¿Ï·á" ¹öÆ°À» Ŭ¸¯ÇÑ´Ù.
+ 9) ÇÁ·ÎÁ§Æ® ¸íÀ» hibernate3 µîÀÇ ¿øÇÏ´Â À̸§À¸·Î ¸í¸íÇÑ´Ù.
+ 10) checkoutÀÌ ½ÇÇàµË´Ï´Ù.
+
+ [TortoiseSVN ¼³Ä¡]
+ TortoiseSVN Ŭ¶óÀ̾ðÆ®¸¦ ¼³Ä¡Çϼ̴ٸé, ½Ã½ºÅÛÀ» Àç½ÃÀÛ ÇϽʽÿÀ.
+ 1)·¹ÆÄÁöÅ丮¸¦ À§ÇÑ Æú´õ¸¦ Çϳª »ý¼º½Ãŵ´Ï´Ù.(D:\repo)
+ 2)À©µµ¿ìŽ»ö±â¿¡¼ D:\repo¸¦ ¸¶¿ì½º ¿À¸¥ÂÊ Å¬¸¯ÇÑ ÈÄ TortoiseSVN ¸Þ´º¿¡¼
+ "Create repository Here..."¸¦ Ŭ¸¯Çϸé Æ˾÷ÀÌ ¶ß´Âµ¥,
+ ÆÄÀϽýºÅÛ/¹öŬ¸®DB Çü½Ä Áß Çϳª¸¦ ¼±ÅÃÇÏ°í OK ¹öÆ°À» ´©¸£¼¼¿ä.
+ 3)hibernate¸¦ ³»·Á ¹Þ±â À§ÇÑ Æú´õ¸¦ Çϳª »ý¼º½ÃÅ°¼¼¿ä(D:\repo\Hibernate3)
+ 4)D:\repo\hibernate Æú´õ¸¦ ¸¶¿ì½º ¿À¸¥ÂÊ Å¬¸¯ÇÑ ÈÄ,
+ TortoiseSVN Æ˾÷ ¸Þ´º¿¡¼ CheckOutÀ» Ŭ¸¯ÇϽʽÿÀ.
+ 5)URL repository¿¡ "http://anonhibernate.labs.jboss.com/trunk/Hibernate3" ¶Ç´Â
+ "https://hibernate.labs.jboss.com/repos/hibernate/trunk" ¸¦ ÀÔ·ÂÇÏ°í,
+ OK ¹öÆ°À» Ŭ¸¯ÇϽʽÿÀ
+ 6)¸ðµÎ ³»·Á¹ÞÀ¸½Å ´ÙÀ½¿¡ D:\repo\Hibernate3\doc\reference·Î À̵¿ÇÕ´Ï´Ù.
+ 7)ÀÌÁ¦ ºôµåÇÏ½Ã¸é µË´Ï´Ù.
+
+ *) ÇÑ±Û ¹ø¿ªº»¸¸ ÇÊ¿äÇÏ½Ã´Ù¸é ´ÙÀ½°ú °°ÀÌ Çϼŵµ µË´Ï´Ù.
+ /doc/reference/build.xml ÆÄÀÏÀ»
¾Æ·¡ ¿¹¿Í °°ÀÌ ÇÑ±Û ¹ø¿ªº» ¿ÜÀÇ ºÎºÐµéÀ» ÁÖ¼®Ã³¸®ÇÕ´Ï´Ù.
- [¶ó]. ºôµåÇϱâ
+ [°¡]. ºôµåÇϱâ
±×·± ´ÙÀ½ [·ÎÄà °æ·Î]/reference/ ¿¡¼ ant all.doc·Î ºôµåÇÏ½Ã¸é µË´Ï´Ù.
ºôµå ½Ã°£Àº 2ºÐ °¡·® ¼Ò¿äµË´Ï´Ù.
- [¸¶]. ¹®¼ º¸±â
+ [³ª]. ¹®¼ º¸±â
µð·ºÅ丮 [·ÎÄà °æ·Î]/reference/build/ko/ µð·ºÅ丮¿¡ ºôµåµÈ ¹®¼¸¦ º¸½Ã±â ¹Ù¶ø´Ï´Ù.
±×·³ ÇÏÀ̹ö³×ÀÌÆ®¿Í ÇÔ²² Áñ°Å¿î ½Ã°£À» º¸³»¼¼¿ä.
Modified: branches/Branch_3_2/Hibernate3/doc/reference/ko/fop/userconfig.xml
===================================================================
--- branches/Branch_3_2/Hibernate3/doc/reference/ko/fop/userconfig.xml 2006-12-08 08:01:55 UTC (rev 10955)
+++ branches/Branch_3_2/Hibernate3/doc/reference/ko/fop/userconfig.xml 2006-12-08 08:07:27 UTC (rev 10956)
@@ -92,17 +92,17 @@
<font-triplet name="Mincho" style="italic" weight="bold"/>
</font>
-->
- <font metrics-file="Gulim.xml" kerning="yes" embed-file="gulim.ttc">
- <font-triplet name="Gulim" style="normal" weight="normal"/>
- <font-triplet name="Gulim" style="normal" weight="bold"/>
- <font-triplet name="Gulim" style="italic" weight="normal"/>
- <font-triplet name="Gulim" style="italic" weight="bold"/>
+ <font metrics-file="Hankc.xml" kerning="yes" embed-file="Hankc.ttf">
+ <font-triplet name="Hankc" style="normal" weight="normal"/>
+ <font-triplet name="Hankc" style="normal" weight="bold"/>
+ <font-triplet name="Hankc" style="italic" weight="normal"/>
+ <font-triplet name="Hankc" style="italic" weight="bold"/>
</font>
-<font metrics-file="Gaeul.xml" kerning="yes" embed-file="Gaeul.ttf">
-<font-triplet name="ê°€ì„ì²´" style="normal" weight="normal"/>
-<font-triplet name="ê°€ì„ì²´" style="normal" weight="bold"/>
-<font-triplet name="ê°€ì„ì²´" style="italic" weight="normal"/>
-<font-triplet name="ê°€ì„ì²´" style="italic" weight="bold"/>
+<font metrics-file="Bangwool.xml" kerning="yes" embed-file="Bangwool.ttf">
+<font-triplet name="Bangwool" style="normal" weight="normal"/>
+<font-triplet name="Bangwool" style="normal" weight="bold"/>
+<font-triplet name="Bangwool" style="italic" weight="normal"/>
+<font-triplet name="Bangwool" style="italic" weight="bold"/>
</font>
</fonts>
Modified: branches/Branch_3_2/Hibernate3/doc/reference/ko/master.xml
===================================================================
--- branches/Branch_3_2/Hibernate3/doc/reference/ko/master.xml 2006-12-08 08:01:55 UTC (rev 10955)
+++ branches/Branch_3_2/Hibernate3/doc/reference/ko/master.xml 2006-12-08 08:07:27 UTC (rev 10956)
@@ -33,7 +33,7 @@
<bookinfo lang="ko">
<title>HIBERNATE - 개성있는 ìžë°”를 위한 관계 ì˜ì†</title>
<subtitle>하ì´ë²„네ì´íŠ¸ 참조 문서</subtitle>
- <releaseinfo lang="ko">3.1</releaseinfo>
+ <releaseinfo lang="ko">3.2 cr3</releaseinfo>
</bookinfo>
<toc lang="ko" />
Modified: branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/architecture.xml
===================================================================
--- branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/architecture.xml 2006-12-08 08:01:55 UTC (rev 10955)
+++ branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/architecture.xml 2006-12-08 08:07:27 UTC (rev 10956)
@@ -78,19 +78,19 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Persistent objects and collections</term>
+ <term>ì˜ì† ê°ì²´ë“¤ê³¼ ì½œë ‰ì…˜ë“¤</term>
<listitem>
<para>
persistent ìƒíƒœì™€ 비지니스 ê¸°ëŠ¥ì„ í¬í•¨í•˜ëŠ” ìˆ˜ëª…ì´ ì§§ê³ , ë‹¨ì¼ ì“°ë ˆë“œì¸ ê°ì²´ë“¤. ì´ê²ƒë“¤ì€ 통ìƒì˜ JavaBeans/POJO들ì¼
수 ìžˆê³ , ì˜¤ì§ ê·¸ê²ƒë“¤ì— ëŒ€í•œ ì˜¤ì§ íŠ¹ë³„í•œ ê²ƒì€ ê·¸ê²ƒë“¤ì´ í˜„ìž¬ (ì •í™•í•˜ê²Œ í•œ ê°œì˜) <literal>Session</literal>ê³¼ ì—°ê´€ë˜ì–´
있다는 ì ì´ë‹¤. <literal>Session</literal>ì´ ë‹«ížˆìžë§ˆìž, ê·¸ê²ƒë“¤ì€ ë¶„ë¦¬ë (detached ìƒíƒœê°€ ë ) 것ì´ê³ 어플리케ì´ì…˜
- ë ˆì´ì–´ì—ì„œ 사용하는 ê²ƒì´ ìžìœ 로와진다(예를 들면. 프리ì í…Œì´ì…˜ìœ¼ë¡œì˜ ë°ì´í„° ì „ì†¡ ê°ì²´ë“¤ë¡œì„œ ì§ì ‘ì 으로 ê·¸ë¦¬ê³ í”„ë¦¬ì í…Œì´ì…˜ìœ¼ë¡œë¶€í„°
- ë°ì´í„° ì „ì†¡ ê°ì²´ë“¤ë¡œì„œ ì§ì ‘으로).
+ ë ˆì´ì–´ì—ì„œ 사용하는 ê²ƒì´ ìžìœ 로와진다(예를 들면. ì§ì ‘ì 으로 프리ì í…Œì´ì…˜ 계층으로
+ ë°ì´í„° ì „ì†¡ ê°ì²´ë“¤ë¡œì„œ ê·¸ë¦¬ê³ ì§ì ‘ì 으로 프리ì í…Œì´ì…˜ 계층으로부터 ë°ì´í„° ì „ì†¡ ê°ì²´ë“¤ë¡œì„œ).
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Transient and detached objects and collections</term>
+ <term>ì „ì´(Transient, í•„ìž ì£¼-ê³¼ë„) ê°ì²´ë“¤ê³¼ ì½œë ‰ì…˜ë“¤</term>
<listitem>
<para>
<literal>Session</literal>ê³¼ 현재 ì—°ê´€ë˜ì–´ 있지 ì•Šì€ ì˜ì† í´ëž˜ìŠ¤ë“¤ì˜ ì¸ìŠ¤í„´ìŠ¤ë“¤. ê·¸ê²ƒë“¤ì€ ì–´í”Œë¦¬ì¼€ì´ì…˜ì— ì˜í•´ 초기화
@@ -236,7 +236,7 @@
</para>
</sect1>
- <sect1 id="architecture-current-session" revision="1">
+ <sect1 id="architecture-current-session" revision="2">
<title>컨í…스트 ìƒì˜ 세션들</title>
<para>
Hibernate를 사용하는 ëŒ€ë¶€ë¶„ì˜ ì–´í”Œë¦¬ì¼€ì´ì…˜ë“¤ì€ ì–´ë–¤ ì–‘ì‹ì˜ "컨í…스트ìƒì˜(contextual)" ì„¸ì…˜ë“¤ì„ í•„ìš”ë¡œ 한다. 여기서
@@ -264,7 +264,7 @@
<para>
ê·¸ê²ƒì˜ ê³„ì•½ì— ëŒ€í•œ ìƒì„¸í•œ ë…¼ì˜ëŠ” <literal>org.hibernate.context.CurrentSessionContext</literal> ì¸í„°íŽ˜ì´ìŠ¤ì—
관한 javadocs를 ë³´ë¼. ê·¸ê²ƒì€ í•˜ë‚˜ì˜ ë©”ì†Œë“œ, <literal>currentSession()</literal>를 ì •ì˜í•˜ë©°, ê·¸ 구현ì€
- í˜„ìž¬ì˜ ì»¨í…스트 ìƒì˜ ì„¸ì…˜ì„ ì¶”ì í• ì±…ìž„ì´ ìžˆë‹¤. 비공ì‹ì 으로, Hibernate는 ì´ ì¸í„°íŽ˜ì´ìŠ¤ì— 대한 구 ê°œì˜ êµ¬í˜„ë“¤ì„ ë¶€ìˆ˜ì 으로
+ í˜„ìž¬ì˜ ì»¨í…스트 ìƒì˜ ì„¸ì…˜ì„ ì¶”ì í• ì±…ìž„ì´ ìžˆë‹¤. 비공ì‹ì 으로, Hibernate는 ì´ ì¸í„°íŽ˜ì´ìŠ¤ì— 대한 세 ê°œì˜ êµ¬í˜„ë“¤ì„ ë¶€ìˆ˜ì 으로
í¬í•¨í•˜ê³ 있다.
</para>
@@ -284,7 +284,7 @@
</listitem>
</itemizedlist>
<para>
- ë‘ êµ¬í˜„ë“¤ì€ <emphasis>session-per-request</emphasis>ë¡œ ì•Œë ¤ì§€ê³ ì‚¬ìš©ë˜ê³ 있는
+ 처ìŒì˜ ë‘ êµ¬í˜„ë“¤ì€ <emphasis>session-per-request</emphasis>ë¡œ ì•Œë ¤ì§€ê³ ì‚¬ìš©ë˜ê³ 있는
"í•˜ë‚˜ì˜ ì„¸ì…˜ - í•˜ë‚˜ì˜ ë°ì´í„°ë² ì´ìŠ¤ 트랜ìžì…˜" í”„ë¡œê·¸ëž˜ë° ëª¨í˜•ì„ ì œê³µí•œë‹¤. í•˜ë‚˜ì˜ Hibernate ì„¸ì…˜ì˜ ì‹œìž‘ê³¼ ëì€
ë°ì´í„°ë² ì´ìŠ¤ 트랜ìžì…˜ì˜ ì¡´ì† ê¸°ê°„ì— ì˜í•´ ì •ì˜ëœë‹¤. ë§Œì¼ (예를 들면 순수 J2SEì—ì„œ ë˜ëŠ” JTA/UserTransaction/BMTì˜ ê²½ìš°ì—)
ë‹¹ì‹ ì´ í”„ë¡œê·¸ëž¨ ìƒì˜ 트랜ìžì…˜ ê²½ê³„êµ¬ë¶„ì„ ì‚¬ìš©í• ê²½ìš°, ë‹¹ì‹ ì€ ë‹¹ì‹ ì˜ ì½”ë“œë¡œë¶€í„° 기본 트랜ìžì…˜ ì‹œìŠ¤í…œì„ ì€í시키는ë°
Modified: branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/association_mapping.xml
===================================================================
--- branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/association_mapping.xml 2006-12-08 08:01:55 UTC (rev 10955)
+++ branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/association_mapping.xml 2006-12-08 08:07:27 UTC (rev 10956)
@@ -48,8 +48,7 @@
</id>
</class>]]></programlisting>
<programlisting><![CDATA[
-create table Person ( personId bigint not null primary key,
- addressId bigint not null )
+create table Person ( personId bigint not null primary key, addressId bigint not null )
create table Address ( addressId bigint not null primary key )
]]></programlisting>
@@ -79,8 +78,7 @@
</id>
</class>]]></programlisting>
<programlisting><![CDATA[
-create table Person ( personId bigint not null primary key,
- addressId bigint not null unique )
+create table Person ( personId bigint not null primary key, addressId bigint not null unique )
create table Address ( addressId bigint not null primary key )
]]></programlisting>
@@ -135,8 +133,7 @@
</class>]]></programlisting>
<programlisting><![CDATA[
create table Person ( personId bigint not null primary key )
-create table Address ( addressId bigint not null primary key,
- personId bigint not null )
+create table Address ( addressId bigint not null primary key, personId bigint not null )
]]></programlisting>
<para>
@@ -177,8 +174,7 @@
</class>]]></programlisting>
<programlisting><![CDATA[
create table Person ( personId bigint not null primary key )
-create table PersonAddress ( personId not null,
- addressId bigint not null primary key )
+create table PersonAddress ( personId not null, addressId bigint not null primary key )
create table Address ( addressId bigint not null primary key )
]]></programlisting>
@@ -211,8 +207,7 @@
</class>]]></programlisting>
<programlisting><![CDATA[
create table Person ( personId bigint not null primary key )
-create table PersonAddress ( personId bigint not null primary key,
- addressId bigint not null )
+create table PersonAddress ( personId bigint not null primary key, addressId bigint not null )
create table Address ( addressId bigint not null primary key )
]]></programlisting>
@@ -247,8 +242,7 @@
</class>]]></programlisting>
<programlisting><![CDATA[
create table Person ( personId bigint not null primary key )
-create table PersonAddress ( personId bigint not null primary key,
- addressId bigint not null unique )
+create table PersonAddress ( personId bigint not null primary key, addressId bigint not null unique )
create table Address ( addressId bigint not null primary key )
]]></programlisting>
@@ -279,9 +273,7 @@
</class>]]></programlisting>
<programlisting><![CDATA[
create table Person ( personId bigint not null primary key )
-create table PersonAddress ( personId bigint not null,
- addressId bigint not null,
- primary key (personId, addressId) )
+create table PersonAddress ( personId bigint not null, addressId bigint not null, primary key (personId, addressId) )
create table Address ( addressId bigint not null primary key )
]]></programlisting>
@@ -319,8 +311,7 @@
</class>]]></programlisting>
<programlisting><![CDATA[
-create table Person ( personId bigint not null primary key,
- addressId bigint not null )
+create table Person ( personId bigint not null primary key, addressId bigint not null )
create table Address ( addressId bigint not null primary key )
]]></programlisting>
@@ -386,8 +377,7 @@
property-ref="address"/>
</class>]]></programlisting>
<programlisting><![CDATA[
-create table Person ( personId bigint not null primary key,
- addressId bigint not null unique )
+create table Person ( personId bigint not null primary key, addressId bigint not null unique )
create table Address ( addressId bigint not null primary key )
]]></programlisting>
@@ -459,8 +449,7 @@
</class>]]></programlisting>
<programlisting><![CDATA[
create table Person ( personId bigint not null primary key )
-create table PersonAddress ( personId bigint not null,
- addressId bigint not null primary key )
+create table PersonAddress ( personId bigint not null, addressId bigint not null primary key )
create table Address ( addressId bigint not null primary key )
]]></programlisting>
@@ -505,8 +494,7 @@
</class>]]></programlisting>
<programlisting><![CDATA[
create table Person ( personId bigint not null primary key )
-create table PersonAddress ( personId bigint not null primary key,
- addressId bigint not null unique )
+create table PersonAddress ( personId bigint not null primary key, addressId bigint not null unique )
create table Address ( addressId bigint not null primary key )
]]></programlisting>
@@ -543,9 +531,7 @@
<programlisting><![CDATA[
create table Person ( personId bigint not null primary key )
-create table PersonAddress ( personId bigint not null,
- addressId bigint not null,
- primary key (personId, addressId) )
+create table PersonAddress ( personId bigint not null, addressId bigint not null, primary key (personId, addressId) )
create table Address ( addressId bigint not null primary key )
]]></programlisting>
Modified: branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/basic_mapping.xml
===================================================================
--- branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/basic_mapping.xml 2006-12-08 08:01:55 UTC (rev 10955)
+++ branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/basic_mapping.xml 2006-12-08 08:07:27 UTC (rev 10956)
@@ -92,7 +92,7 @@
- <sect2 id="mapping-declaration-doctype" revision="2">
+ <sect2 id="mapping-declaration-doctype" revision="3">
<title>Doctype</title>
<para>
@@ -102,6 +102,56 @@
ë‹¹ì‹ ì´ ì¸í„°ë„· ì—°ê²°ì„ ì‚¬ìš©í•˜ëŠ” DTDì— ëŒ€í•œ ë£©ì—…ë“¤ì„ ê²ªê²Œ ë 경우, ë‹¹ì‹ ì˜ classpathì˜ ì»¨í…ì¸ ì— ëŒ€í•´ ë‹¹ì‹ ì˜ DTD ì„ ì–¸ì„
ì²´í¬í•˜ë¼.
</para>
+
+ <sect3 id="mapping-declaration-entity-resolution">
+ <title>EntityResolver</title>
+ <para>
+ ì•žì„œ 언급했듯ì´, Hibernate는 ë¨¼ì € ê·¸ê²ƒì˜ classpathì—ì„œ DTDë“¤ì„ í•´ì„í•˜ë ¤ê³ ì‹œë„í• ê²ƒì´ë‹¤.
+ Hibernateê°€ ì´ê²ƒì„ 행하는 ë°©ë²•ì€ ê·¸ê²ƒì´ xml 파ì¼ë“¤ì„ ì½ì–´ë“¤ì´ëŠ”ë° ì‚¬ìš©í•˜ëŠ” SAXReaderì— ë§žì¶¤í˜•
+ <literal>org.xml.sax.EntityResolver</literal> êµ¬í˜„ì„ ë“±ë¡í•˜ëŠ” 것ì´ë‹¤. ì´ ë§žì¶¤í˜•
+ <literal>EntityResolver</literal>는 ë‘ ê°œì˜ ë‹¤ë¥¸ systemId namespaceë“¤ì„ ì¸ì§€í•´ë‚¸ë‹¤.
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <literal>hibernate namespace</literal>는 resolver가
+ <literal>http://hibernate.sourceforge.net/</literal>ë¡œ 시작하는 하나ì˜
+ systemId와 ë§Œë‚ ë•Œë§ˆë‹¤ ì¸ì§€ëœë‹¤; resolver는 Hibernate í´ëž˜ìŠ¤ë“¤ì„ ë¡œë“œì‹œì¼°ë˜ í´ëž˜ìŠ¤ë¡œë”를 통해
+ ì´ë“¤ ì—”í‹°í‹°ë“¤ì„ í•´ì„í•˜ë ¤ê³ ì‹œë„한다.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>user namespace</literal>는 resolver가 <literal>classpath://</literal>
+ URL í”„ë¡œí† ì½œì„ ì‚¬ìš©í•˜ëŠ” systemId를 ë§Œë‚ ë•Œë§ˆë‹¤ ì¸ì§€ëœë‹¤; resolver는 (1)현재 ì“°ë ˆë“œ 컨í…스트
+ í´ëž˜ìŠ¤ë¡œë”와 (2)Hibernate í´ëž˜ìŠ¤ë“¤ì„ ë¡œë“œì‹œì¼°ë˜ í´ëž˜ìŠ¤ë¡œë”를 통해 ì´ë“¤ ì—”í‹°í‹°ë“¤ì„ í•´ì„í•˜ë ¤ê³
+ ì‹œë„í• ê²ƒì´ë‹¤.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ user namespacingì„ í™œìš©í•˜ëŠ” ì˜ˆì œ:
+ </para>
+ <programlisting><![CDATA[<?xml version="1.0"?>
+<!DOCTYPE hibernate-mapping PUBLIC
+ "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
+ "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd" [
+ <!ENTITY types SYSTEM "classpath://your/domain/types.xml">
+]>
+
+<hibernate-mapping package="your.domain">
+ <class name="MyEntity">
+ <id name="id" type="my-custom-id-type">
+ ...
+ </id>
+ <class>
+ &types;
+</hibernate-mapping>]]></programlisting>
+ <para>
+ 여기서 <literal>types.xml</literal>ì€ <literal>your.domain</literal> 패키지 ë‚´ì— ìžˆëŠ” 리소스ì´ê³
+ 맞춤형 <xref linkend="mapping-types-custom">typedef</xref>를 í¬í•¨í•œë‹¤.
+ </para>
+ </sect3>
</sect2>
<sect2 id="mapping-declaration-mapping" revision="3">
@@ -692,6 +742,17 @@
</para>
</listitem>
</varlistentry>
+ <varlistentry>
+ <term><literal>sequence-identity</literal></term>
+ <listitem>
+ <para>
+ ì‹¤ì œ ê°’ ìƒì„±ì„ 위해 ë°ì´í„°ë² ì´ìŠ¤ 시퀀스를 활용하지만, ìƒì„±ëœ ì‹ë³„ìž ê°’ì„ insert 문장 ì‹¤í–‰ì˜ ë¶€ë¶„ìœ¼ë¡œì„œ
+ ì‹¤ì œë¡œ 반환시키기 위해 ì´ê²ƒì„ JDBC3 getGeneratedKeys와 결합시킨 íŠ¹í™”ëœ ì‹œí€€ìŠ¤ ìƒì„± ë°©ë„. ì´ ë°©ë„는
+ JDK 1.4ì— ëŒ€ìƒí™”ëœ Oracle 10g ë“œë¼ì´ë²„들 ìƒì—서만 지ì›ë˜ëŠ” 거승로 ì•Œë ¤ì ¸ 있다. ì´ë“¤ insert 문장들ì—
+ 대한 주ì„ë“¤ì€ Oracle ë“œë¼ì´ë²„들 ë‚´ì— ìžˆëŠ” 버그 ë•Œë¬¸ì— ì‚¬ìš©ë¶ˆê°€ëŠ¥í•˜ê²Œ ë˜ì–´ 있ìŒì„ 노트하ë¼.
+ </para>
+ </listitem>
+ </varlistentry>
</variablelist>
</para>
@@ -1082,7 +1143,7 @@
</para>
</sect2>
- <sect2 id="mapping-declaration-timestamp" revision="3" >
+ <sect2 id="mapping-declaration-timestamp" revision="4" >
<title>timestamp (옵션)</title>
<para>
@@ -1090,7 +1151,7 @@
ë²„ì „í™”ì— ëŒ€í•œ 대체물로서 ê³ ì•ˆë˜ì—ˆë‹¤. Timestampì€ ê³ ìœ í•˜ê²Œ optimistic ìž ê¸ˆì— ëŒ€í•œ 다소 ì•ˆì „í•œ 구현ì´ë‹¤. 하지만 때때로
어플리케ì´ì…˜ì€ 다른 방법들로 timestampë“¤ì„ ì‚¬ìš©í• ìˆ˜ë„ ìžˆë‹¤.
</para>
-
+
<programlistingco>
<areaspec>
<area id="timestamp1" coords="2 70"/>
@@ -1123,7 +1184,7 @@
가진 ìžë°”빈즈 스타ì¼ì˜ 프로í¼í‹° ì´ë¦„.
</para>
</callout>
- <callout arearefs="timestamp3">
+ <callout arearefs="timestamp3">
<para>
<literal>access</literal> (옵션 - ë””í´íŠ¸ëŠ” <literal>property</literal>):
Hibernateê°€ 프로í¼í‹° ê°’ì— ì ‘ê·¼í•˜ëŠ”ë° ì‚¬ìš©í• ë°©ë„.
@@ -1140,18 +1201,18 @@
<callout arearefs="timestamp5">
<para>
<literal>source</literal> (옵션 - ë””í´íŠ¸ëŠ” <literal>vm</literal>):
- Hibernate는 ì–´ëŠ ìž¥ì†Œë¡œë¶€í„° timestamp ê°’ì„ ê²€ìƒ‰í• ê²ƒì¸ê°€? ë°ì´í„°ë² ì´ìŠ¤ë¡œë¶€í„°ì¸ê°€ í˜„ìž¬ì˜ JVM으로부터ì¸ê°€?
- Hibernateê°€ "ë‹¤ìŒ ê°’"ì„ ê²°ì •í•˜ê¸° 위해 ë°ì´í„°ë² ì´ìŠ¤ì— ì ‘ì†í•´ì•¼ 하기 ë•Œë¬¸ì— ë°ì´í„°ë² ì´ìŠ¤ 기반ì˜
- timestampë“¤ì€ ì˜¤ë²„í—¤ë“œë¥¼ 초래하지만, í´ëŸ¬ìŠ¤í„°ë§ëœ í™˜ê²½ë“¤ì˜ ìš©ë„ë¡œ ë” ì•ˆì „í• ê²ƒì´ë‹¤. ë˜í•œ 모ë“
+ Hibernate는 어디서 timestamp ê°’ì„ ê²€ìƒ‰í• ê²ƒì¸ê°€? ë°ì´í„°ë² ì´ìŠ¤ë¡œë¶€í„°ì¸ê°€ í˜„ìž¬ì˜ JVM으로부터ì¸ê°€?
+ ë°ì´í„°ë² ì´ìŠ¤ ê¸°ë°˜ì˜ timestampë“¤ì€ Hibernateê°€ "ë‹¤ìŒ ê°’"ì„ ê²°ì •í•˜ê¸° 위해 ë°ì´í„°ë² ì´ìŠ¤ì— ì ‘ì†í•´ì•¼
+ 하기 ë•Œë¬¸ì— ì˜¤ë²„í—¤ë“œë¥¼ 초래하지만, í´ëŸ¬ìŠ¤í„°ë§ëœ 환경들ì—ì„œì˜ ìš©ë„ë¡œ 보다 ë” ì•ˆì „í• ê²ƒì´ë‹¤. ë˜í•œ 모ë“
<literal>Dialect</literal>ë“¤ì´ ë°ì´í„°ë² ì´ìŠ¤ì˜ í˜„ìž¬ì˜ timestampì— ëŒ€í•œ ê²€ìƒ‰ì„ ì§€ì›í•˜ëŠ” 것으로 ì•Œë ¤ì ¸
- 있는 반면ì—, 다른 <literal>Dialect</literal>ë“¤ì€ ì •ë°€ë„ ê²°í• ë•Œë¬¸ì— ìž ê¸ˆì— ìžˆì–´ ì‚¬ìš©ì— ëŒ€í•´ ì•ˆì „í•˜ì§€ ì•Šì„
+ 있지 않지만, 다른 <literal>Dialect</literal>ë“¤ì€ ì •ë°€ë„ ê²°í• ë•Œë¬¸ì— ìž ê¸ˆì— ìžˆì–´ ì‚¬ìš©ì´ ì•ˆì „í•˜ì§€ ì•Šì„
수 있ìŒì„ 노트하ë¼(예를 들면 오ë¼í´ 8).
</para>
</callout>
<callout arearefs="timestamp6">
<para>
<literal>generated</literal> (옵션 - ë””í´íŠ¸ëŠ” <literal>never</literal>):
- ì´ timestamp 프로í¼í‹° ê°’ì´ ë°ì´í„°ë² ì´ìŠ¤ì— ì˜í•´ ì‹¤ì œë¡œ 산출ë˜ëŠ”지를 ì§€ì •í•œë‹¤.
+ ì´ timestamp 프로í¼í‹° ê°’ì´ ë°ì´í„°ë² ì´ìŠ¤ì— ì˜í•´ ì‹¤ì œë¡œ ìƒì„±ë¨ì„ ì§€ì •í•œë‹¤.
<xref linkend="mapping-generated">산출ë˜ëŠ” 프로í¼í‹°ë“¤</xref>ì— ëŒ€í•œ ë…¼ì˜ë“¤ ë³´ë¼.
</para>
</callout>
@@ -2202,7 +2263,8 @@
<title>join</title>
<para>
- <literal><join></literal> 요소를 사용하면, í•œ ê°œì˜ í´ëž˜ìŠ¤ì˜ 프로í¼í‹°ë“¤ì„ 몇 ê°œì˜ í…Œì´ë¸”들로 매핑시키는 것ì´
+ <literal><join></literal> í…Œì´ë¸”들 사ì´ì— 1ëŒ€ì¼ ê´€ê³„ê°€ ì¡´ìž¬í• ë•Œ,
+ 요소를 사용하여 í•˜ë‚˜ì˜ í´ëž˜ìŠ¤ì— ì†í•œ 프로í¼í‹°ë“¤ì„ 몇 ê°œì˜ í…Œì´ë¸”들로 매핑시키는 것ì´
가능하다.
</para>
Modified: branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/batch.xml
===================================================================
--- branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/batch.xml 2006-12-08 08:01:55 UTC (rev 10955)
+++ branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/batch.xml 2006-12-08 08:07:27 UTC (rev 10956)
@@ -28,8 +28,6 @@
<para>
ë‹¹ì‹ ì€ ë˜í•œ second-level ìºì‹œë¥¼ 가진 ìƒí˜¸ìž‘ìš©ì´ ì™„ì „í•˜ê²Œ 불가능한 프로세스 ë‚´ì—ì„œ ì´ëŸ° ì¢…ë¥˜ì˜ ìž‘ì—…ì„ í–‰í•˜ê³ ì‹¶ì–´í• ìˆ˜ë„ ìžˆë‹¤:
- You also might like to do this kind of work in a process where interaction with
- the second-level cache is completely disabled:
</para>
<programlisting><![CDATA[hibernate.cache.use_second_level_cache false]]></programlisting>
@@ -94,7 +92,6 @@
session.close();]]></programlisting>
</sect1>
-
<sect1 id="batch-statelesssession">
<title>StatelessSession ì¸í„°íŽ˜ì´ìŠ¤</title>
@@ -140,7 +137,7 @@
</sect1>
- <sect1 id="batch-direct" revision="2">
+ <sect1 id="batch-direct" revision="3">
<title>DML-ìŠ¤íƒ€ì¼ ì—°ì‚°ë“¤</title>
<para>
@@ -151,9 +148,9 @@
(<xref linkend="queryhql">HQL</xref>)를 통해 실행ë˜ëŠ” 대량 SQL-스타ì¼ì˜ DML 문장 ì‹¤í–‰ì„ ìœ„í•œ ë©”ì†Œë“œë“¤ì„ ì œê³µí•œë‹¤.
</para>
- <para>
- <literal>UPDATE</literal>와 <literal>DELETE</literal> ë¬¸ìž¥ë“¤ì˜ ìœ ì‚¬-êµ¬ë¬¸ì€ ë‹¤ìŒê³¼ 같다:
- <literal>( UPDATE | DELETE ) FROM? EntityName (WHERE where_conditions)?</literal>. ë…¸íŠ¸í• ëª‡ 가지 :
+ <para>
+ <literal>UPDATE</literal>와 <literal>DELETE</literal> ë¬¸ìž¥ë“¤ì— ëŒ€í•œ ìœ ì‚¬ êµ¬ë¬¸ì€ ë‹¤ìŒê³¼ 같다:
+ <literal>( UPDATE | DELETE ) FROM? EntityName (WHERE where_conditions)?</literal>. ë…¸íŠ¸í• ëª‡ 가지:
</para>
<itemizedlist spacing="compact">
@@ -201,10 +198,34 @@
session.close();]]></programlisting>
<para>
- í•œ ê°œì˜ HQL <literal>DELETE</literal>를 실행하기 위해, ë™ì¼í•œ <literal>Query.executeUpdate()</literal> 메소드를
+ HQL <literal>UPDATE</literal> ë¬¸ìž¥ë“¤ì€ ë””í´íŠ¸ë¡œ ì˜í–¥ë°›ëŠ” ì—”í‹°í‹°ë“¤ì— ëŒ€í•œ
+ <xref linkend="mapping-declaration-version">version</xref> ë˜ëŠ”
+ <xref linkend="mapping-declaration-timestamp">timestamp</xref> 프로í¼í‹° ê°’ë“¤ì— ì˜í–¥ì„ 주지 않는다;
+ ì´ê²ƒì€ EJB3 명세서ì—ì„œ ìœ ì§€ë˜ê³ 있다. 하지만 ë‹¹ì‹ ì€ í•˜ì´ë²„네ì´íŠ¸ë¡œ 하여금 <literal>versioned update</literal>ì˜
+ ì‚¬ìš©ì„ í†µí•´ <literal>version</literal> ë˜ëŠ” <literal>timestamp</literal> 프로í¼í‹° ê°’ë“¤ì„ ì ì ˆí•˜ê²Œ
+ ìž¬ì„¤ì •í•˜ë„ë¡ ê°•ì œí• ìˆ˜ 있다. ì´ê²ƒì€ <literal>UPDATE</literal> 키워드 ë’¤ì— <literal>VERSIONED</literal> 키워드를
+ 추가시켜서 성취ëœë‹¤.
+ </para>
+<programlisting><![CDATA[Session session = sessionFactory.openSession();
+Transaction tx = session.beginTransaction();
+String hqlVersionedUpdate = "update versioned Customer set name = :newName where name = :oldName";
+int updatedEntities = s.createQuery( hqlUpdate )
+ .setString( "newName", newName )
+ .setString( "oldName", oldName )
+ .executeUpdate();
+tx.commit();
+session.close();]]></programlisting>
+
+ <para>
+ 맞춤형 version 타입들(<literal>org.hibernate.usertype.UserVersionType</literal>)ì€
+ <literal>update versioned</literal> 문장과 함께 사용하는 ê²ƒì´ í—ˆìš©ë˜ì§€ ì•ŠìŒì„ 노트하ë¼.
+ </para>
+
+ <para>
+ HQL <literal>DELETE</literal>를 ì‹¤í–‰í•˜ë ¤ë©´, ê°™ì€ ë©”ì†Œë“œ <literal>Query.executeUpdate()</literal>를
사용하ë¼:
</para>
-
+
<programlisting><![CDATA[Session session = sessionFactory.openSession();
Transaction tx = session.beginTransaction();
Modified: branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/collection_mapping.xml
===================================================================
--- branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/collection_mapping.xml 2006-12-08 08:01:55 UTC (rev 10955)
+++ branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/collection_mapping.xml 2006-12-08 08:07:27 UTC (rev 10956)
@@ -107,7 +107,7 @@
schema="schema_name"
lazy="true|extra|false"
inverse="true|false"
- cascade="all|none|save-update|delete|all-delete-orphan"
+ cascade="all|none|save-update|delete|all-delete-orphan|delete-orphan"
sort="unsorted|natural|comparatorClass"
order-by="column_name asc|desc"
where="arbitrary sql where condition"
Modified: branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/component_mapping.xml
===================================================================
--- branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/component_mapping.xml 2006-12-08 08:01:55 UTC (rev 10955)
+++ branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/component_mapping.xml 2006-12-08 08:07:27 UTC (rev 10956)
@@ -184,8 +184,7 @@
<property name="purchaseDate"/>
<property name="price"/>
<property name="quantity"/>
- <many-to-one name="item" class="eg.Item"/>
- <!-- class attribute is optional -->
+ <many-to-one name="item" class="eg.Item"/> <!-- class attribute is optional -->
</composite-element>
</set>
</class>]]></programlisting>
Modified: branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/configuration.xml
===================================================================
--- branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/configuration.xml 2006-12-08 08:01:55 UTC (rev 10955)
+++ branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/configuration.xml 2006-12-08 08:07:27 UTC (rev 10956)
@@ -653,9 +653,16 @@
ì„ íƒí• 것ì´ë‹¤.
<para>
<emphasis role="strong">eg.</emphasis>
- <literal>on_close</literal> (ë””í´íŠ¸) | <literal>after_transaction</literal> |
- <literal>after_statement</literal> | <literal>auto</literal>
+ <literal>auto</literal> (ë””í´íŠ¸) | <literal>on_close</literal> |
+ <literal>after_transaction</literal> | <literal>after_statement</literal>
</para>
+ <para>
+ ì´ ì„¤ì •ì´ <literal>SessionFactory.openSession</literal>로부터 ë°˜í™˜ëœ <literal>Session</literal>들ì—만
+ ì˜í–¥ì„ 준다는 ì ì„ ë…¸íŠ¸í•˜ë¼. <literal>SessionFactory.getCurrentSession</literal>ì„ í†µí•´ 얻어진
+ <literal>Session</literal>ë“¤ì˜ ê²½ìš°, 사용하기 위해 êµ¬ì„±ëœ <literal>CurrentSessionContext</literal> 구현ì´
+ 그들 <literal>Session</literal>ë“¤ì— ëŒ€í•œ ì—°ê²° í•´ì œë¥¼ ì œì–´í•œë‹¤. <xref linkend="architecture-current-session"/>를
+ ë³´ë¼.
+ </para>
</entry>
</row>
<row>
@@ -864,7 +871,7 @@
</tgroup>
</table>
- <table frame="topbot" id="configuration-misc-properties" revision="9">
+ <table frame="topbot" id="configuration-misc-properties" revision="10">
<title>여러가지 프로í¼í‹°ë“¤</title>
<tgroup cols="2">
<colspec colname="c1" colwidth="1*"/>
@@ -882,12 +889,12 @@
</entry>
<entry>
"현재" <literal>Session</literal>ì˜ ì˜ì—화를 위한 í•˜ë‚˜ì˜ (맞춤) ë°©ë„를
- 공급한다. 빌드ë˜ì–´ 있는 ë°©ë„ë“¤ì— ëŒ€í•œ 추가 ì •ë³´ëŠ”
+ ì œê³µí•œë‹¤. 빌드ë˜ì–´ 있는 ë°©ë„ë“¤ì— ëŒ€í•œ 추가 ì •ë³´ëŠ”
<xref linkend="architecture-current-session"/>를 ë³´ë¼.
<para>
<emphasis role="strong">예.</emphasis>
- <literal>jta</literal> | <literal>thread</literal> |
- <literal>custom.Class</literal>
+ <literal>jta</literal> | <literal>thread</literal> |
+ <literal>managed</literal> | <literal>custom.Class</literal>
</para>
</entry>
</row>
@@ -899,7 +906,7 @@
Chooses the HQL 파서 êµ¬í˜„ì„ ì„ íƒí•œë‹¤.
<para>
<emphasis role="strong">예.</emphasis>
- <literal>org.hibernate.hql.ast.ASTQueryTranslatorFactory</literal> ë˜ëŠ”
+ <literal>org.hibernate.hql.ast.ASTQueryTranslatorFactory</literal> or
<literal>org.hibernate.hql.classic.ClassicQueryTranslatorFactory</literal>
</para>
</entry>
@@ -909,7 +916,8 @@
<literal>hibernate.query.substitutions</literal>
</entry>
<entry>
- Hibernate 질ì˜ë“¤ ë‚´ì˜ í† í°ë“¤ë¡œë¶€í„° SQL í† í°ë“¤ë¡œì˜ 매핑(예를 들어 í† í°ë“¤ì€ 함수 ì´ë¦„ ë˜ëŠ” 리터럴 ì´ë¦„ì¼ ìˆ˜ 있다).
+ Hibernate 질ì˜ë“¤ ë‚´ì˜ í† í°ë“¤ë¡œë¶€í„° SQL í† í°ë“¤ë¡œì˜ 매핑
+ (예를 들어 í† í°ë“¤ì€ 함수 ì´ë¦„ ë˜ëŠ” 리터럴 ì´ë¦„ì¼ ìˆ˜ 있다).
<para>
<emphasis role="strong">예.</emphasis>
<literal>hqlLiteral=SQL_LITERAL, hqlFunction=SQLFUNC</literal>
@@ -921,8 +929,10 @@
<literal>hibernate.hbm2ddl.auto</literal>
</entry>
<entry>
- <literal>SessionFactory</literal>ê°€ ìƒì„±ë ë•Œ 스키마 DDLì„ ë°ì´í„°ë² ì´ìŠ¤ë¡œ ìžë™ì 으로 ìœ íš¨ì„± 검사하거나 내보내기 한다. <literal>create-drop</literal>ì˜ ê²½ìš°,
- <literal>SessionFactory</literal>ê°€ 명시ì 으로 닫혀질 ë•Œ,, ë°ì´í„°ë² ì´ìŠ¤ 스키마가 ë“œë¡ë 것ì´ë‹¤.
+ <literal>SessionFactory</literal>ê°€ ìƒì„±ë ë•Œ, ìžë™ì 으로 ìœ íš¨ì„±ì„ ê²€ì‚¬í•˜ê±°ë‚˜
+ schema DDLì„ ë°ì´í„°ë² ì´ìŠ¤ë¡œ 내보내기 한다. <literal>create-drop</literal>ì˜ ê²½ìš°,
+ <literal>SessionFactory</literal>ê°€ 명시ì 으로 닫혀질 ë•Œ ë°ì´í„°ë² ì´ìŠ¤ 스키마가
+ ë“œë¡ë 것ì´ë‹¤.
<para>
<emphasis role="strong">예.</emphasis>
<literal>validate</literal> | <literal>update</literal> |
@@ -935,8 +945,10 @@
<literal>hibernate.cglib.use_reflection_optimizer</literal>
</entry>
<entry>
- 런타임 reflection ëŒ€ì‹ ì— CGLIBì˜ ì‚¬ìš©ì„ ê°€ëŠ¥í•˜ë„ë¡ ë§Œë“ ë‹¤(시스템 ë ˆë²¨ 프로í¼í‹°). Reflectionì€ ë¬¸ì œê°€ ë°œìƒí• ì‹œì— ë•Œë•Œë¡œ ìœ ìš©í• ìˆ˜ ìžˆê³ ,
- ë‹¹ì‹ ì´ optimizer를 사용하지 ì•Šì„ ê²½ìš°ì¡°ì°¨ë„ Hibernate는 í•ìƒ 필요로 í•¨ì„ ìœ ì˜í•˜ë¼. ë‹¹ì‹ ì€ <literal>hibernate.cfg.xml</literal>
+ 런타임 reflection ëŒ€ì‹ ì— CGLIBì˜ ì‚¬ìš©ì„ ê°€ëŠ¥í•˜ë„ë¡ ë§Œë“ ë‹¤(시스템 ë ˆë²¨ 프로í¼í‹°).
+ Reflectionì€ ë¬¸ì œê°€ ë°œìƒí• ì‹œì— ë•Œë•Œë¡œ ìœ ìš©í• ìˆ˜ ìžˆê³ ,
+ ë‹¹ì‹ ì´ optimizer를 사용하지 ì•Šì„ ê²½ìš°ì¡°ì°¨ë„ Hibernate는 í•ìƒ 필요로 í•¨ì„ ìœ ì˜í•˜ë¼.
+ ë‹¹ì‹ ì€ <literal>hibernate.cfg.xml</literal>
ì†ì— ì´ í”„ë¡œí¼í‹°ë¥¼ ì„¤ì •í• ìˆ˜ 없다.
<para>
<emphasis role="strong">예.</emphasis>
Modified: branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/events.xml
===================================================================
--- branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/events.xml 2006-12-08 08:01:55 UTC (rev 10955)
+++ branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/events.xml 2006-12-08 08:07:27 UTC (rev 10956)
@@ -6,7 +6,7 @@
ê·¸ë¦¬ê³ Hibernateì˜ í™•ìž¥ ê¸°ëŠ¥ì˜ êµ¬í˜„ì„ í—ˆìš©í•´ì¤€ë‹¤.
</para>
- <sect1 id="objectstate-interceptors" revision="2">
+ <sect1 id="objectstate-interceptors" revision="3">
<title>ì¸í„°ì…‰í„°ë“¤</title>
<para>
@@ -106,9 +106,16 @@
}]]></programlisting>
<para>
- ì„¸ì…˜ì´ ìƒì„±ë ë•Œ ì¸í„°ì…‰í„°ê°€ ì§€ì •ë 것ì´ë‹¤.
+ ì¸í„°ì…‰í„°ë“¤ì€ ë‹¤ìŒ ë‘ ê°œì˜ íŠ¹ì§•ë“¤ë¡œ 나타난다: <literal>Session</literal>-ì˜ì—í™” 그리ê³
+ <literal>SessionFactory</literal>-ì˜ì—í™”.
</para>
+ <para>
+ <literal>Session</literal>-ì˜ì—ì˜ ì¸í„°ì…‰í„°ëŠ” ì„¸ì…˜ì´ í•˜ë‚˜ì˜ <literal>Interceptor</literal>를 수용하는
+ ì˜¤ë²„ë¡œë“œëœ SessionFactory.openSession() 메소드들 중 하나를 사용하여 열릴 ë•Œ
+ ì§€ì •ëœë‹¤.
+ </para>
+
<programlisting><![CDATA[Session session = sf.openSession( new AuditInterceptor() );]]></programlisting>
<para>
@@ -116,23 +123,34 @@
ì´ ê²½ìš°ì—, ì¸í„°ì…‰í„°ëŠ” threadsafeì´ì–´ì•¼ 한다.
</para>
+ <programlisting><![CDATA[Session session = sf.openSession( new AuditInterceptor() );]]></programlisting>
+
+ <para>
+ <literal>SessionFactory</literal>-ì˜ì—ì˜ ì¸í„°ì…‰í„°ëŠ” <literal>SessionFactory</literal>ì„ ë¹Œë“œí•˜ê¸°ì— ì•žì„œ
+ <literal>Configuration</literal> ê°ì²´ì— 등ë¡ëœë‹¤. ì´ ê²½ìš°ì—, 공급ë˜ëŠ” ì¸í„°ì…‰í„°ëŠ” ê·¸ <literal>SessionFactory</literal>로부터
+ ì—´ë ¤ì§„ ëª¨ë“ ì„¸ì…˜ë“¤ì— ì ìš©ë 것ì´ë‹¤; í•˜ë‚˜ì˜ ì„¸ì…˜ì´ ì‚¬ìš©í• ì¸í„°ì…‰í„°ë¥¼ 명시ì 으로 ì§€ì •í•˜ì—¬ 열리지 않는 í•œ ì´ê²ƒì€ ì°¸ì´ë‹¤.
+ <literal>SessionFactory</literal>-ì˜ì—ì˜ ì¸í„°ì…‰í„°ë“¤ì€ 세션-ì§€ì •ì ì¸ ìƒíƒœë¥¼ ì €ìž¥í•˜ì§€ ì•Šë„ë¡ ì£¼ì˜í•˜ì—¬ ì“°ë ˆë“œ-ì•ˆì „í•´ì•¼ 한다.
+ 왜ëƒí•˜ë©´ 다중 ì„¸ì…˜ë“¤ì€ (ìž ì •ì 으로) ì´ ì¸í„°ì…‰í„°ë¥¼ ë™ì‹œì 으로 ì‚¬ìš©í• ê²ƒì´ê¸° 때문ì´ë‹¤.
+ </para>
+
<programlisting><![CDATA[new Configuration().setInterceptor( new AuditInterceptor() );]]></programlisting>
</sect1>
- <sect1 id="objectstate-events" revision="3">
+ <sect1 id="objectstate-events" revision="4">
<title>ì´ë²¤íŠ¸ 시스템</title>
<para>
- ë§Œì¼ ë‹¹ì‹ ì´ ë‹¹ì‹ ì˜ ì˜ì† 계층ì—ì„œ 특별한 ì´ë²¤íŠ¸ë“¤ì— 대해 ë°˜ì‘해야 한다면, ë‹¹ì‹ ì€ ë˜í•œ Hibernate3 <emphasis>ì´ë²¤íŠ¸</emphasis>
+ ë§Œì¼ ë‹¹ì‹ ì´ ë‹¹ì‹ ì˜ ì˜ì† 계층ì—ì„œ íŠ¹ì • ì´ë²¤íŠ¸ë“¤ì— 대해 ë°˜ì‘해야 한다면, ë‹¹ì‹ ì€ ë˜í•œ Hibernate3 <emphasis>event</emphasis>
아키í…처를 ì‚¬ìš©í• ìˆ˜ë„ ìžˆë‹¤. ì´ë²¤íŠ¸ ì‹œìŠ¤í…œì€ ë¶€ê°€ë¬¼ë¡œ 사용ë 수 있거나 ì¸í„°ì…‰í„°ë“¤ì— 대한 대체물로 사용ë 수 있다.
</para>
<para>
- 본질ì 으로 <literal>Session</literal> ì¸í„°íŽ˜ì´ìŠ¤ì˜ ëª¨ë“ ë©”ì†Œë“œë“¤ì€ ì´ë²¤íŠ¸ì™€ 서로 ê´€ë ¨ë˜ì–´ 있다. ë‹¹ì‹ ì€ <literal>LoadEvent</literal>,
+ 본질ì 으로 <literal>Session</literal> ì¸í„°íŽ˜ì´ìŠ¤ì˜ ëª¨ë“ ë©”ì†Œë“œë“¤ì€ ì´ë²¤íŠ¸ì™€ 서로 ê´€ë ¨ë˜ì–´ 있다.
+ ë‹¹ì‹ ì€ <literal>LoadEvent</literal>,
<literal>FlushEvent</literal>, ë“±ì„ ê°–ëŠ”ë‹¤ (ì •ì˜ëœ ì´ë²¤íŠ¸ íƒ€ìž…ë“¤ì˜ ì „ì²´ ë¦¬ìŠ¤íŠ¸ì— ëŒ€í•´ì„œëŠ” XML 구성 íŒŒì¼ DTD ë˜ëŠ”
<literal>org.hibernate.event</literal> 패키지를 참조하ë¼). í•˜ë‚˜ì˜ ìš”ì²ì´ ì´ë“¤ 메소드들 중 í•˜ë‚˜ì— ì˜í•´ 만들어질 ë•Œ,
- Hibernate <literal>Session</literal>ì€ ì ì ˆí•œ ì´ë²¤íŠ¸ë¥¼ ìƒì„±ì‹œí‚¤ê³ ê·¸ê²ƒì„ ê·¸ íƒ€ìž…ì— ëŒ€í•œ êµ¬ì„±ëœ ì´ë²¤íŠ¸ 리스너ì—게 ì „ë‹¬í•œë‹¤.
+ Hibernate <literal>Session</literal>ì€ ì ì ˆí•œ ì´ë²¤íŠ¸ë¥¼ ìƒì„±ì‹œí‚¤ê³ ê·¸ê²ƒì„ ê·¸ íƒ€ìž…ì˜ êµ¬ì„±ëœ ì´ë²¤íŠ¸ 리스너ì—게 ì „ë‹¬í•œë‹¤.
박싱없ì´, ì´ë“¤ ë¦¬ìŠ¤ë„ˆë“¤ì€ ê·¸ë“¤ ë©”ì†Œë“œë“¤ì´ í•ìƒ 귀결ë˜ì—ˆë˜ ë™ì¼í•œ í”„ë¡œì„¸ì‹±ì„ êµ¬í˜„í•œë‹¤. 하지만 ë‹¹ì‹ ì´ ë¦¬ìŠ¤ë„ˆ ì¸í„°íŽ˜ì´ìŠ¤ë“¤ 중 í•˜ë‚˜ì˜ ë§žì¶¤ì„
구현하는 ê²ƒì´ ìžìœ ë¡ê³ (예를 들어 <literal>LoadEvent</literal>는 <literal>LoadEventListener</literal> ì¸í„°íŽ˜ì´ìŠ¤ì˜
등ë¡ëœ êµ¬í˜„ì— ì˜í•´ 처리ëœë‹¤), ê·¸ ê²½ìš°ì— ê·¸ë“¤ êµ¬í˜„ì€ <literal>Session</literal>ì— ëŒ€í•´ 행해진 ìž„ì˜ì˜ <literal>load()</literal>
@@ -146,10 +164,10 @@
<para>
맞춤형 리스너는 ê·¸ê²ƒì´ íŽ¸ì˜ì ì¸ ê¸°ì € í´ëž˜ìŠ¤ë“¤(ë˜ëŠ” ë¦¬ìŠ¤ë„ˆë“¤ì´ ì´ ìš©ë„ë¡œ finalì´ ì•„ë‹Œ 것으로 ì„ ì–¸ë˜ë¯€ë¡œ Hibernate
- out-of-the-boxì— ì˜í•´ ì‚¬ìš©ëœ ë””í´íŠ¸ ì´ë²¤íŠ¸ 리스너들) 중 하나를 ì²˜ë¦¬í•˜ê³ ìž ê·¸ë¦¬ê³ /ë˜ëŠ” í™•ìž¥í•˜ê³ ìž ì›í•˜ëŠ” ì´ë²¤íŠ¸ë“¤ì— 대해
+ out-of-the-boxì— ì˜í•´ ì‚¬ìš©ëœ ë””í´íŠ¸ ì´ë²¤íŠ¸ 리스너들) 중 하나를 ì²˜ë¦¬í•˜ê³ /하거나 í™•ìž¥í•˜ê³ ìž ì›í•˜ëŠ” ì´ë²¤íŠ¸ë“¤ì— 대해
ì ì ˆí•œ ì¸í„°íŽ˜ì´ìŠ¤ë¥¼ 구현해야 한다. 맞춤형 ë¦¬ìŠ¤ë„ˆë“¤ì€ <literal>Configuration</literal> ê°ì²´ë¥¼ 통해 프로그램 ìƒìœ¼ë¡œ
등ë¡ë 수 있거나, Hibernate 구성 XML ì†ì— ì§€ì •ë 수 있다 (properties 파ì¼ì„ 통한 ì„ ì–¸ì ì¸ êµ¬ì„±ì€ ì§€ì›ë˜ì§€ 않는다).
- 다ìŒì€ 맞춤형 load ì´ë²¤íŠ¸ ë¦¬ìŠ¤ë„ˆì— ëŒ€í•œ ì˜ˆì œì´ë‹¤:
+ 다ìŒì€ 맞춤형 load ì´ë²¤íŠ¸ ë¦¬ìŠ¤ë„ˆì— ëŒ€í•œ ì˜ˆì œì´ë‹¤:
</para>
<programlisting><![CDATA[public class MyLoadListener implements LoadEventListener {
@@ -185,13 +203,13 @@
cfg.EventListeners().setLoadEventListeners(stack);]]></programlisting>
<para>
- ì„ ì–¸ì 으로 등ë¡ëœ ë¦¬ìŠ¤ë„ˆë“¤ì€ ì¸ìŠ¤í„´ìŠ¤ë“¤ì„ ê³µìœ í• ìˆ˜ 없다. ë§Œì¼ ë™ì¼í•œ í´ëž˜ìŠ¤ ì´ë¦„ì´ ì—¬ëŸ¬ <literal><listener/></literal>
+ ì„ ì–¸ì 으로 등ë¡ëœ ë¦¬ìŠ¤ë„ˆë“¤ì€ ì¸ìŠ¤í„´ìŠ¤ë“¤ì„ ê³µìœ í• ìˆ˜ 없다. ë§Œì¼ ë™ì¼í•œ í´ëž˜ìŠ¤ ì´ë¦„ì´ ì—¬ëŸ¬ ê°œì˜ <literal><listener/></literal>
요소들ì—ì„œ 사용ë 경우, ê°ê°ì˜ 참조는 ê·¸ í´ëž˜ìŠ¤ì— 대한 별ë„ì˜ ì¸ìŠ¤í„´ìŠ¤ë¡œ 귀결ë 것ì´ë‹¤. ë§Œì¼ ë‹¹ì‹ ì´ ë¦¬ìŠ¤ë„ˆ 타입들 사ì´ì—ì„œ 리스너 ì¸ìŠ¤í„´ìŠ¤ë“¤ì„
ê³µìœ í• ê°€ìš©ì„±ì„ í•„ìš”ë¡œ í• ê²½ìš° ë‹¹ì‹ ì€ í”„ë¡œê·¸ëž˜ë° ë°©ì‹ì˜ ë“±ë¡ ì ‘ê·¼ë²•ì„ ì‚¬ìš©í•´ì•¼ 한다.
</para>
<para>
- ì»¨í”¼ê·¸ë ˆì´ì…˜ ë™ì•ˆì— 왜 ì¸í„°íŽ˜ì´ìŠ¤ë¥¼ êµ¬í˜„í•˜ê³ íŠ¹ì • íƒ€ìž…ì„ ì§€ì •í•˜ëŠ”ê°€? ë¬¼ë¡ ë¦¬ìŠ¤ë„ˆ êµ¬í˜„ì€ ì—¬ëŸ¬ ê°œì˜ ì´ë²¤íŠ¸ 리스너 ì¸í„°íŽ˜ì´ìŠ¤ë“¤ì„
+ 구성 ë™ì•ˆì— 왜 ì¸í„°íŽ˜ì´ìŠ¤ë¥¼ êµ¬í˜„í•˜ê³ íŠ¹ì • íƒ€ìž…ì„ ì§€ì •í•˜ëŠ”ê°€? ë¬¼ë¡ ë¦¬ìŠ¤ë„ˆ êµ¬í˜„ì€ ì—¬ëŸ¬ ê°œì˜ ì´ë²¤íŠ¸ 리스너 ì¸í„°íŽ˜ì´ìŠ¤ë“¤ì„
êµ¬í˜„í• ìˆ˜ 있다. ë“±ë¡ ë™ì•ˆì— 추가ì 으로 íƒ€ìž…ì„ ì •ì˜í•˜ëŠ” ê²ƒì€ ì»¨í”¼ê·¸ë ˆì´ì…˜ ë™ì•ˆì— 맞춤형 ë¦¬ìŠ¤ë„ˆë“¤ì˜ ì‚¬ìš© 여부를 ì „í™˜ì‹œí‚¤ëŠ” 것ì„
ë” ì‰½ê²Œ 해준다.
</para>
Modified: branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/example_mappings.xml
===================================================================
--- branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/example_mappings.xml 2006-12-08 08:01:55 UTC (rev 10955)
+++ branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/example_mappings.xml 2006-12-08 08:07:27 UTC (rev 10956)
@@ -538,7 +538,7 @@
</class>
]]></programlisting>
</sect2>
-
+
<sect2 id="example-mappings-content-discrimination">
<title>ë‚´ìš© 기반 íŒë³„</title>
<programlisting><![CDATA[<class name="Person"
Modified: branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/inheritance_mapping.xml
===================================================================
--- branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/inheritance_mapping.xml 2006-12-08 08:01:55 UTC (rev 10955)
+++ branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/inheritance_mapping.xml 2006-12-08 08:07:27 UTC (rev 10956)
@@ -63,6 +63,7 @@
</subclass>
</hibernate-mapping>]]></programlisting>
+
<sect2 id="inheritance-tableperclass" >
<title>Table per class hierarchy</title>
Modified: branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/performance.xml
===================================================================
--- branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/performance.xml 2006-12-08 08:01:55 UTC (rev 10955)
+++ branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/performance.xml 2006-12-08 08:07:27 UTC (rev 10956)
@@ -576,11 +576,24 @@
만료ë˜ë„ë¡ êµ¬ì„±ë˜ì–´ 있ì„지ë¼ë„) ë˜ ë‹¤ë¥¸ 어플리케ì´ì…˜ì— ì˜í•´ ì˜ì† ì €ìž¥ì†Œì— ëŒ€í•´ 행해진 ë³€ê²½ë“¤ì„ ê²°ì½” 알지 못한다.
</para>
- <para>
+ <para revision="1">
ë””í´íŠ¸ë¡œ, Hibernate는 JVM-ë ˆë²¨ì˜ ìºì‹±ì— EHCache를 사용한다. (JCS 지ì›ì€ ì´ì œ 진부하게 ë˜ì—ˆê³ Hibernateì˜ ìž¥ëž˜ ë²„ì „ì—ì„œ
ì œê±°ë 것ì´ë‹¤.) ë‹¹ì‹ ì€ <literal>hibernate.cache.provider_class</literal> 프로í¼í‹°ë¥¼ 사용하여
<literal>org.hibernate.cache.CacheProvider</literal>를 구현하는 í´ëž˜ìŠ¤ì˜ ì´ë¦„ì„ ì§€ì •í•¨ìœ¼ë¡œì¨ ë‹¤ë¥¸ êµ¬í˜„ì„ ì„ íƒí• 수ë„
있다.
+ You have the option to tell Hibernate which caching implementation to use by
+ specifying the name of a class that implements <literal>org.hibernate.cache.CacheProvider</literal>
+ using the property <literal>hibernate.cache.provider_class</literal>. Hibernate
+ comes bundled with a number of built-in integrations with open-source cache providers
+ (listed below); additionally, you could implement your own and plug it in as
+ outlined above. Note that versions prior to 3.2 defaulted to use EhCache as the
+ default cache provider; that is no longer the case as of 3.2.
+ ë‹¹ì‹ ì€ <literal>hibernate.cache.provider_class</literal> 프로í¼í‹°ë¥¼ 사용하여
+ <literal>org.hibernate.cache.CacheProvider</literal>를 구현하는 í´ëž˜ìŠ¤ì˜ ì´ë¦„ì„ ì§€ì •í•¨ìœ¼ë¡œì¨ ì–´ëŠ ìºì‹± 구현ì„
+ ì‚¬ìš©í• ê²ƒì¸ì§€ë¥¼ Hibernateì—게 ì•Œë ¤ì£¼ëŠ” ì˜µì…˜ì„ ê°–ëŠ”ë‹¤. Hibernate는 (ì•„ëž˜ì— ì—´ê±°ëœ) 오픈-소스 프로바ì´ë”ë“¤ì„ ê°€ì§„
+ ë§Žì€ ë¹Œë“œë˜ì–´ 있는 í†µí•©ë“¤ì„ ë²ˆë“¤ë¡œ ê°–ê³ ìžˆë‹¤; 추가ì 으로 ë‹¹ì‹ ì€ ìœ„ì—ì„œ ì–¸ê¸‰í–ˆë“¯ì´ ê·¸ê²ƒì— ë‹¹ì‹ ìžì‹ ì˜ ê²ƒì„ êµ¬í˜„í• ìˆ˜ ìžˆê³ ê·¸ê²ƒì—
+ 플러그 시킬 수 있다. 3.2 ì´ë²ˆ ë²„ì „ë“¤ì€ ë””í”ŒíŠ¸ ìºì‹œ 프로바ì´ë”로서 EhCache를 사용하ë„ë¡ ë””í¬ë¦ë¡œ 내장ë˜ì–´ 있ìŒì„ 노트하ë¼;
+ ë²„ì „ 3.2ì˜ ê²½ìš°ì— ê·¸ê²ƒì€ ë”ì´ìƒ ë””í´íŠ¸ ë‚´ìž¥ì´ ì•„ë‹ˆë‹¤.
</para>
<table frame="topbot" id="cacheproviders" revision="1">
Modified: branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/persistent_classes.xml
===================================================================
--- branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/persistent_classes.xml 2006-12-08 08:01:55 UTC (rev 10955)
+++ branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/persistent_classes.xml 2006-12-08 08:07:27 UTC (rev 10956)
@@ -104,6 +104,7 @@
ì¤€ìˆ˜í• ë„¤ ê°œì˜ ì£¼ìš” ê·œì¹™ë“¤ì´ ë‹¤ìŒì— 있다:
</para>
+
<sect2 id="persistent-classes-pojo-constructor" revision="1">
<title>아규먼트 없는 ìƒì„±ìžë¥¼ êµ¬í˜„í•˜ë¼ </title>
@@ -228,7 +229,8 @@
<title><literal>equals()</literal>와 <literal>hashCode()</literal> 구현하기</title>
<para>
- ë§Œì¼ ë‹¹ì‹ ì´
+ ë§Œì¼ ë‹¹ì‹ ì´ ë‹¤ìŒì˜ 경우ë¼ë©´, ë‹¹ì‹ ì€ <literal>equals()</literal>와 <literal>hashCode()</literal>
+ ë©”ì†Œë“œë“¤ì„ ì˜¤ë²„ë¼ì´ë“œ 시켜야 한다.
</para>
<itemizedlist spacing="compact">
<listitem>
@@ -244,11 +246,8 @@
</para>
</listitem>
</itemizedlist>
+
<para>
- ê²½ìš°ì— ë‹¹ì‹ ì€ <literal>equals()</literal>와 <literal>hashCode()</literal> ë©”ì†Œë“œë“¤ì„ ì˜¤ë²„ë¼ì´ë“œ 시켜야 한다.
- </para>
-
- <para>
Hibernate는 íŠ¹ì • session 범위 ë‚´ì—서만 persistent identity(ë°ì´í„°ë² ì´ìŠ¤ í–‰)ê³¼ Java identityì˜ ê°™ìŒì„ 보장한다.
ë”°ë¼ì„œ 우리가 다른 세션들ì—ì„œ ê²€ìƒ‰ëœ ì¸ìŠ¤í„´ìŠ¤ë“¤ì„ 혼합시키ìžë§ˆìž, 우리가 <literal>Set</literal>ë“¤ì— ëŒ€í•´ ìœ ì˜ë¯¸í•˜ê²Œ
ë§Œë“¤ê³ ìž ì›í• 경우, 우리는 <literal>equals()</literal>와 <literal>hashCode()</literal>를 구현해야 한다.
@@ -432,7 +431,7 @@
</sect1>
- <sect1 id="persistent-classes-tuplizers" revision="0">
+ <sect1 id="persistent-classes-tuplizers" revision="1">
<title>Tuplizer들</title>
<para>
@@ -442,8 +441,8 @@
그런 ë°ì´í„° 구조로부터 ê°’ë“¤ì„ ì¶”ì¶œì‹œí‚¤ëŠ” 방법 ê·¸ë¦¬ê³ ê·¸ëŸ° ë°ì´í„°êµ¬ì¡° ì†ìœ¼ë¡œ ê°’ë“¤ì„ ì‚½ìž…ì‹œí‚¤ëŠ” ë°©ë²•ì„ ì•Œê³ ìžˆëŠ” 것ì´ë‹¤.
예를 들어, POJO 엔티티 ëª¨ë“œì˜ ê²½ìš°, 대ì‘하는 tuplizer는 ê·¸ê²ƒì˜ ìƒì„±ìžë¥¼ 통해 POJO를 ìƒì„±ì‹œí‚¤ëŠ” 방법, ê·¸ë¦¬ê³ ì •ì˜ëœ
프로í¼í‹° ì ‘ê·¼ìžë“¤ì„ 사용하여 POJO 프로í¼í‹°ë“¤ì— ì ‘ê·¼í•˜ëŠ” ë°©ë²•ì„ ì•ˆë‹¤.
- <literal>org.hibernate.tuple.EntityTuplizer</literal> ì¸í„°íŽ˜ì´ìŠ¤ì™€
- <literal>org.hibernate.tuple.ComponentTuplizer</literal> ì¸í„°íŽ˜ì´ìŠ¤ì— ì˜í•´ 표현ë˜ëŠ” ë‘ ê°€ì§€ ê³ ê¸‰ ìœ í˜•ì˜
+ <literal>org.hibernate.tuple.entity.EntityTuplizer</literal> ì¸í„°íŽ˜ì´ìŠ¤ì™€
+ <literal>org.hibernate.tuple.component.ComponentTuplizer</literal> ì¸í„°íŽ˜ì´ìŠ¤ì— ì˜í•´ 표현ë˜ëŠ” ë‘ ê°€ì§€ ê³ ê¸‰ ìœ í˜•ì˜
Tuplizerë“¤ì´ ì¡´ìž¬í•œë‹¤. <literal>EntityTuplizer</literal>ë“¤ì€ ì—”í‹°í‹°ë“¤ì— ê´€í•´ì„œëŠ” ìœ„ì— ì–¸ê¸‰ëœ ê³„ì•½ë“¤ì„ ë§¤í•‘í•
ì±…ìž„ì´ ìžˆëŠ” 반면ì—, <literal>ComponentTuplizer</literal>ë“¤ì€ ì»´í¬ë„ŒíŠ¸ë“¤ì— ëŒ€í•´ì„œë„ ë™ì¼í•œ ê²ƒì„ í–‰í•œë‹¤.
</para>
@@ -476,7 +475,7 @@
public class CustomMapTuplizerImpl
- extends org.hibernate.tuple.DynamicMapEntityTuplizer {
+ extends org.hibernate.tuple.entity.DynamicMapEntityTuplizer {
// override the buildInstantiator() method to plug in our custom map...
protected final Instantiator buildInstantiator(
org.hibernate.mapping.PersistentClass mappingInfo) {
Modified: branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/query_criteria.xml
===================================================================
--- branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/query_criteria.xml 2006-12-08 08:01:55 UTC (rev 10955)
+++ branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/query_criteria.xml 2006-12-08 08:07:27 UTC (rev 10956)
@@ -364,7 +364,6 @@
</sect1>
-
<!--TODO: ResultSetTransformer + aliasing. AliasToBeanTransformer는 -JDO2ì—ì„œ setResultClass와 ìœ ì‚¬í•œ- ìž„ì˜ì ì¸
ì‚¬ìš©ìž ê°ì²´ë“¤ì„ 반환하는 ê²ƒì„ í—ˆìš©í•œë‹¤. ResultTransformerì— ëŒ€í•œ ì¼ë°˜ì ì¸ ì‚¬ìš©ì´ ë˜í•œ 설명ë 수 있다. -->
Modified: branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/query_hql.xml
===================================================================
--- branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/query_hql.xml 2006-12-08 08:01:55 UTC (rev 10955)
+++ branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/query_hql.xml 2006-12-08 08:07:27 UTC (rev 10956)
@@ -1,5 +1,5 @@
<chapter id="queryhql">
- <title>HQL: Hibernate Query Language</title>
+ <title>HQL: 하ì´ë²„네ì´íŠ¸ ì§ˆì˜ ì–¸ì–´(Hibernate Query Language)</title>
<para>
Hibernate는 (아주 ì˜ë„ì 으로) SQLê³¼ 매우 í¡ì‚¬í•˜ê²Œ ë³´ì´ëŠ” 극히 ê°•ë ¥í•œ ì§ˆì˜ ì–¸ì–´ë¥¼ êµ¬ë¹„í•˜ê³ ìžˆë‹¤. 그러나 ê·¸ êµ¬ë¬¸ì— ì˜í•´ 우롱당하지 ë§ë¼;
@@ -126,7 +126,7 @@
<programlisting><![CDATA[from Cat as cat
left join cat.kittens as kitten
with kitten.bodyWeight > 10.0]]></programlisting>
-
+
<para>
게다가, "fetch" joinì€ ê°’ë“¤ì„ ê°€ì§„ ì½œë ‰ì…˜ë“¤ì´ë‚˜ ì—°ê´€ê´€ê³„ë“¤ì´ í•œ ê°œì˜ select를 사용하여, ê·¸ê²ƒë“¤ì˜ ë¶€ëª¨ ê°ì²´ë“¤ì— ë”°ë¼ ì´ˆê¸°í™” ë˜ëŠ”
ê²ƒì„ í—ˆìš©í•´ì¤€ë‹¤. ì´ê²ƒì€ ì½œë ‰ì…˜ì˜ ê²½ìš°ì— íŠ¹ížˆ ìœ ìš©í•˜ë‹¤. ê·¸ê²ƒì€ ì—°ê´€ê´€ê³„ë“¤ê³¼ ì½œë ‰ì…˜ë“¤ì— ëŒ€í•œ 매핑 파ì¼ì˜ outer joinê³¼ lazy ì„ ì–¸ë“¤ì„
@@ -147,7 +147,7 @@
inner join fetch cat.mate
left join fetch cat.kittens child
left join fetch child.kittens]]></programlisting>
-
+
<para>
(ë¹„ë¡ <literal>scroll()</literal>ì´ ì‚¬ìš©ë 수 있ì„지ë¼ë„) <literal>fetch</literal> 구조체는
<literal>iterate()</literal>를 사용하여 호출ë˜ëŠ” 질ì˜ë“¤ ë‚´ì— ì‚¬ìš©ë 수 ì—†ìŒì„ 노트하ë¼. ì´ë“¤ 오í¼ë ˆì´ì…˜ë“¤ì´ ê²°ê³¼ 행들ì—
@@ -167,9 +167,9 @@
<programlisting><![CDATA[from Document fetch all properties order by name]]></programlisting>
<programlisting><![CDATA[from Document doc fetch all properties where lower(doc.name) like '%cats%']]></programlisting>
-
+
</sect1>
-
+
<sect1 id="queryhql-joins-forms">
<title>join êµ¬ë¬¸ì˜ í˜•ì‹ë“¤</title>
@@ -566,39 +566,27 @@
</listitem>
<listitem>
<para>
- ì¡°ì¸ëœ ì¸ë±ì‹±ëœ ì½œë ‰ì…˜ì˜ aliasë“¤ì— ì ìš©ë˜ëŠ”, HQL <literal>index()</literal> 함수
- </para>
- </listitem>
- <listitem>
- <para>
- ì½œë ‰ì…˜ ê°’ì„ ê°€ì§„ 경로 표현ì‹ë“¤ì„ 취하는 HQL 함수들 : <literal>some, all, exists, any, in</literal>ì„
- 사용하여 ì •ëŸ‰í™” ë 수 있는 특별한 <literal>elements()</literal>와 <literal>indices</literal>
- 함수들과 함께 <literal>size(), minelement(), maxelement(), minindex(), maxindex()</literal>.
- </para>
- </listitem>
- <listitem>
- <para>
<literal>cast(... as ...)</literal>, 여기서 ë‘번 째 아규먼트는 Hibernate íƒ€ìž…ì˜ ì´ë¦„ì´ê³ ,
- ANSI <literal>cast()</literal>와 <literal>extract()</literal>ê°€ 기본 ë°ì´í„°ë² ì´ìŠ¤ì— ì˜í•´ 지ì›ë 경우ì—는
- <literal>extract(... from ...)</literal>
+ ANSI <literal>cast()</literal>와 <literal>extract()</literal>ê°€ 기반 ë°ì´í„°ë² ì´ìŠ¤ì— ì˜í•´
+ 지ì›ë 경우ì—는 <literal>extract(... from ...)</literal>.
</para>
</listitem>
<listitem>
<para>
- ì¡°ì¸ëœ ì¸ë±ì‹±ëœ ì½œë ‰ì…˜ì˜ aliasë“¤ì„ ì 용하는 HQL <literal>index()</literal> 함수
+ ì¡°ì¸ëœ ì¸ë±ì‹±ëœ ì½œë ‰ì…˜ì˜ aliasë“¤ì— ì ìš©ë˜ëŠ”, HQL <literal>index()</literal> 함수
</para>
</listitem>
<listitem>
<para>
- ì½œë ‰ì…˜ ê°’ 경로 표현ì‹ë“¤ì„ 취하는 HQL 함수들: <literal>some, all, exists, any, in</literal>ì„ ì‚¬ìš©í•˜ì—¬
- ì–‘ì´ í•œì •ë 수 있는 특별한 <literal>elements()</literal> ë° <literal>indices</literal> 함수들과 함께
- <literal>size(), minelement(), maxelement(), minindex(), maxindex()</literal> 함수들.
+ ì½œë ‰ì…˜ ê°’ì„ ê°€ì§„ 경로 표현ì‹ë“¤ì„ 취하는 HQL 함수들 : <literal>some, all, exists, any, in</literal>ì„
+ 사용하여 ì •ëŸ‰í™” ë 수 있는 특별한 <literal>elements()</literal>와 <literal>indices</literal>
+ 함수들과 함께 <literal>size(), minelement(), maxelement(), minindex(), maxindex()</literal>.
</para>
</listitem>
<listitem>
<para>
<literal>sign()</literal>, <literal>trunc()</literal>, <literal>rtrim()</literal>,
- <literal>sin()</literal>ê³¼ ê°™ì´ ìž„ì˜ì˜ ë°ì´í„°ë² ì´ìŠ¤-ì§€ì› SQL ìŠ¤ì¹¼ë¼ í•¨ìˆ˜
+ <literal>sin()</literal>ê³¼ ê°™ì´ ìž„ì˜ì˜ ë°ì´í„°ë² ì´ìŠ¤ ì§€ì› SQL ìŠ¤ì¹¼ë¼ í•¨ìˆ˜
</para>
</listitem>
<listitem>
@@ -867,6 +855,10 @@
<para>
select 리스트 ë‚´ì— ìžˆëŠ” 하나 ì´ìƒì˜ 표현ì‹ì„ 가진 서브질ì˜ë“¤ì˜ ê²½ìš°ì— ë‹¹ì‹ ì€ tuple ìƒì„±ìžë¥¼ ì‚¬ìš©í• ìˆ˜ 있다:
</para>
+
+ <para>
+ select ëª©ë¡ ë‚´ì— í•˜ë‚˜ ì´ìƒì˜ 표현ì‹ì„ 가진 서브질ì˜ë“¤ì˜ 경우, ë‹¹ì‹ ì€ íŠœí”Œ(tuple) 구조를 ì‚¬ìš©í• ìˆ˜ 있다:
+ </para>
<programlisting><![CDATA[from Cat as cat
where not ( cat.name, cat.color ) in (
Modified: branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/query_sql.xml
===================================================================
--- branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/query_sql.xml 2006-12-08 08:01:55 UTC (rev 10955)
+++ branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/query_sql.xml 2006-12-08 08:07:27 UTC (rev 10956)
@@ -1,216 +1,366 @@
<?xml version="1.0" encoding="UTF-8"?>
<chapter id="querysql" revision="2">
- <title>Native SQL</title>
+ <title>Native SQL</title>
- <para>
- ë‹¹ì‹ ì€ ë˜í•œ ë‹¹ì‹ ì˜ ë°ì´í„°ë² ì´ìŠ¤ì˜ native SQL dialectë¡œ 질ì˜ë“¤ì„ í‘œí˜„í• ìˆ˜ë„ ìžˆë‹¤. ë‹¹ì‹ ì´ ì˜¤ë¼í´ì˜ ì§ˆì˜ ížŒíŠ¸ë“¤ ë˜ëŠ”
- <literal>CONNECT</literal> 키워드와 ê°™ì€ ë°ì´í„°ë² ì´ìŠ¤ ì§€ì •ì ì¸ íŠ¹ì§•ë“¤ì„ í™œìš©í•˜ê³ ìž ì›í• ê²½ìš°ì— ì´ê²ƒì´ ìœ ìš©í•˜ë‹¤.
- ê·¸ê²ƒì€ ë˜í•œ ì§ì ‘ì ì¸ SQL/JDBC ê¸°ë°˜ì˜ ì–´í”Œë¦¬ì¼€ì´ì…˜ìœ¼ë¡œë¶€í„° Hibernateë¡œì˜ ë³´ë‹¤ 명료한 ì´ì „ 경로를 ì œê³µí•œë‹¤.
- </para>
+ <para>ë‹¹ì‹ ì€ ë˜í•œ ë‹¹ì‹ ì˜ ë°ì´í„°ë² ì´ìŠ¤ì˜ native SQL dialectë¡œ 질ì˜ë“¤ì„ í‘œí˜„í• ìˆ˜ë„ ìžˆë‹¤.
+ ë‹¹ì‹ ì´ ì˜¤ë¼í´ì˜ ì§ˆì˜ ížŒíŠ¸ë“¤ ë˜ëŠ” <literal>CONNECT</literal> 키워드와 ê°™ì€
+ ë°ì´í„°ë² ì´ìŠ¤ ì§€ì •ì ì¸ íŠ¹ì§•ë“¤ì„ í™œìš©í•˜ê³ ìž ì›í• ê²½ìš°ì— ì´ê²ƒì´ ìœ ìš©í•˜ë‹¤.
+ ê·¸ê²ƒì€ ë˜í•œ ì§ì ‘ì ì¸ SQL/JDBC ê¸°ë°˜ì˜ ì–´í”Œë¦¬ì¼€ì´ì…˜ìœ¼ë¡œë¶€í„° Hibernateë¡œì˜ ë³´ë‹¤ 명료한
+ ì´ì „ 경로를 ì œê³µí•œë‹¤.</para>
- <para>
- Hibernate3ì€ ë˜í•œ ëª¨ë“ create, update, delete, load 오í¼ë ˆì´ì…˜ë“¤ì— 대해 (내장 í”„ë¡œì‹œì €ë“¤ì„ í¬í•¨í•˜ì—¬) ì†ìœ¼ë¡œ ìž‘ì„±ëœ SQLì„
- ì§€ì •í•˜ëŠ” ê²ƒì„ ë‹¹ì‹ ì—게 허용해준다.
- </para>
+ <para>Hibernate3ì€ ë˜í•œ ëª¨ë“ create, update, delete, load 오í¼ë ˆì´ì…˜ë“¤ì— 대해
+ (내장 í”„ë¡œì‹œì €ë“¤ì„ í¬í•¨í•˜ì—¬) ì†ìœ¼ë¡œ ìž‘ì„±ëœ SQLì„ ì§€ì •í•˜ëŠ” ê²ƒì„ ë‹¹ì‹ ì—게 허용해준다.</para>
- <sect1 id="querysql-creating" revision="3">
- <title><literal>SQLQuery</literal> 사용하기</title>
+ <sect1 id="querysql-creating" revision="4">
+ <title><literal>SQLQuery</literal> 사용하기</title>
- <para>
- native SQL 질ì˜ë“¤ì˜ ì‹¤í–‰ì€ <literal>SQLQuery</literal> ì¸í„°íŽ˜ì´ìŠ¤ë¥¼ 통해 ì œì–´ë˜ë©°, 그것ì€
- <literal>Session.createSQLQuery()</literal>ì„ í˜¸ì¶œí•˜ì—¬ íšë“ëœë‹¤. 극히 간단한 경우들ì—ì„œ ,
- 우리는 ë‹¤ìŒ í˜•ì‹ì„ ì‚¬ìš©í• ìˆ˜ 있다:
- </para>
+ <para>native SQL 질ì˜ë“¤ì˜ ì‹¤í–‰ì€ <literal>SQLQuery</literal> ì¸í„°íŽ˜ì´ìŠ¤ë¥¼ 통해
+ ì œì–´ë˜ë©°, ê·¸ê²ƒì€ <literal>Session.createSQLQuery()</literal>ì„ í˜¸ì¶œí•˜ì—¬
+ íšë“ëœë‹¤. 다ìŒì€ ì´ API를 질ì˜ì— 사용하는 ë°©ë²•ì„ ì„¤ëª…í•œë‹¤.</para>
- <programlisting><![CDATA[List cats = sess.createSQLQuery("select * from cats")
- .addEntity(Cat.class)
- .list();]]></programlisting>
-
- <para>ì´ ì§ˆì˜ëŠ” 다ìŒì„ ì§€ì •í–ˆë‹¤:</para>
+ <sect2>
+ <title>ìŠ¤ì¹¼ë¼ ì§ˆì˜ë“¤</title>
- <itemizedlist>
+ <para>가장 기본ì ì¸ SQL 질ì˜ëŠ” 스칼ë¼ë“¤(값들)ì˜ ëª©ë¡ì„ 얻는
+ 것ì´ë‹¤.</para>
+
+ <programlisting><![CDATA[sess.createSQLQuery("SELECT * FROM CATS").list();
+sess.createSQLQuery("SELECT ID, NAME, BIRTHDATE FROM CATS").list();
+]]></programlisting>
+
+ <para>ì´ê²ƒë“¤ì€ 둘다 CATS í…Œì´ë¸” ë‚´ì— ìžˆëŠ” ê°ê°ì˜ ì»¬ëŸ¼ì— ëŒ€í•œ ìŠ¤ì¹¼ë¼ ê°’ë“¤ì„ ê°€ì§„ Object
+ ë°°ì—´ë“¤ì˜ List를 ë°˜í™˜í• ê²ƒì´ë‹¤. Hibernate는 반환ë˜ëŠ” ìŠ¤ì¹¼ë¼ ê°’ë“¤ì˜ ì‹¤ì œ 순서와 타입들ì„
+ ë„ì¶œí•˜ëŠ”ë° ResultSetMetadata를 ì‚¬ìš©í• ê²ƒì´ë‹¤.</para>
+
+ <para><literal>ResultSetMetadata</literal> ì‚¬ìš©ì˜ ì˜¤ë²„í—¤ë“œë¥¼ 피하거나
+ 간단하게는 반환ë˜ëŠ” ê²ƒì„ ë³´ë‹¤ 명시ì ì´ê²Œë” 하기 위해 우리는
+ <literal>addScalar()</literal>를 ì‚¬ìš©í• ìˆ˜ 있다.</para>
+
+ <programlisting><![CDATA[sess.createSQLQuery("SELECT * FROM CATS")
+ .addScalar("ID", Hibernate.LONG)
+ .addScalar("NAME", Hibernate.STRING)
+ .addScalar("BIRTHDATE", Hibernate.DATE)
+]]></programlisting>
+
+ <para>ì´ ì§ˆì˜ëŠ” 다ìŒì„ ì§€ì •í–ˆë‹¤:</para>
+
+ <itemizedlist>
<listitem>
- <para>
- SQL ì§ˆì˜ ë¬¸ìžì—´
- </para>
+ <para>SQL ì§ˆì˜ ë¬¸ìžì—´</para>
</listitem>
+
<listitem>
- <para>
- ê·¸ 질ì˜ì— ì˜í•´ 반환ë˜ëŠ” 엔티티
- </para>
+ <para>ë°˜í™˜í• ì»¬ëŸ¼ë“¤ê³¼ 타입들</para>
</listitem>
- </itemizedlist>
+ </itemizedlist>
- <para>
- 여기서, ê²°ê³¼ ì…‹ 컬럼 ì´ë¦„ë“¤ì€ ë§¤í•‘ 문서 ë‚´ì— ì§€ì •ëœ ì»¬ëŸ¼ ì´ë¦„들과 ë™ì¼í•œ 것으로 ê°€ì •ëœë‹¤. ì´ê²ƒì€ ì¡°ì¸ ë‹¤ì¤‘ í…Œì´ë¸”ë“¤ì„ ê°€ì§„
- SQL 질ì˜ë“¤ì— 대해 ë¬¸ì œê°€ ë 수 있다. 왜ëƒí•˜ë©´ ë™ì¼í•œ 컬럼 ì´ë¦„ë“¤ì´ í•˜ë‚˜ ì´ìƒì˜ í…Œì´ë¸” 들 ë‚´ì— ë‚˜íƒ€ë‚ ìˆ˜ë„ ìžˆê¸° 때문ì´ë‹¤.
- ë‹¤ìŒ í˜•ì‹ì€ 컬럼 ì´ë¦„ ì¤‘ë³µì— ëŒ€í•´ 취약하지 않다:
- </para>
+ <para>ì´ê²ƒì€ ì—¬ì „ížˆ Object ë°°ì—´ë“¤ì„ ë°˜í™˜í• ê²ƒì´ì§€ë§Œ, ì´ì œ 그것ì€
+ <literal>ResultSetMetdata</literal>를 사용하지 ì•Šì„ ê²ƒì´ê³ ëŒ€ì‹ ì—
+ 기반 결과셋으로부터 ID, NAME ê·¸ë¦¬ê³ BIRTHDATE ì»¬ëŸ¼ì„ ê°ê° Long, String
+ ê·¸ë¦¬ê³ Short 타입으로 ë°˜í™˜í• ê²ƒì´ë‹¤. 심지어 ê·¸ 질ì˜ê°€ <literal>*</literal>를
+ ì‚¬ìš©í•˜ê³ ì„¸ ê°œì˜ ì—´ê±°ëœ ì»¬ëŸ¼ë“¤ 보다 ë” ë§Žì€ ê²ƒì„ ë°˜í™˜í• ìˆ˜ 있ì„지ë¼ë„, ì´ê²ƒì€
+ ë˜í•œ ì˜¤ì§ ì´ë“¤ 세 ê°œì˜ ì»¬ëŸ¼ë“¤ ë§Œì´ ë°˜í™˜ë ê²ƒìž„ì„ ì˜ë¯¸í•œë‹¤.</para>
- <programlisting><![CDATA[List cats = sess.createSQLQuery("select {cat.*} from cats cat")
- .addEntity("cat", Cat.class)
- .list();]]></programlisting>
+ <para>스칼ë¼ë“¤ 중 몇몇 ë˜ëŠ” ì „ë¶€ì— ëŒ€í•œ 타입 ì •ë³´ë¥¼ 남겨ë‘는 ê²ƒì´ ê°€ëŠ¥í•˜ë‹¤.</para>
+ <programlisting><![CDATA[sess.createSQLQuery("SELECT * FROM CATS")
+ .addScalar("ID", Hibernate.LONG)
+ .addScalar("NAME")
+ .addScalar("BIRTHDATE")
+]]></programlisting>
+
+ <para>ì´ê²ƒì€ 본질ì 으로 ì•žì˜ ê²ƒê³¼ ë™ì¼í•œ 질ì˜ì´ì§€ë§Œ, ì´ì œ
+ <literal>ResultSetMetaData</literal>는 IDì˜ íƒ€ìž…ì´ ëª…ì‹œì 으로 ì§€ì •ë˜ì–´ 있으므로
+ NAMEê³¼ BIRTHDATEì˜ íƒ€ìž…ì„ ê²°ì •í•˜ëŠ”ë° ì‚¬ìš©ëœë‹¤.</para>
+
+ <para>java.sql.Types returned from ResultSetMetaDataì´ Hibernate
+ 타입들로 매핑ë˜ëŠ” ë°©ë²•ì€ Dialectì— ì˜í•´ ì œì–´ëœë‹¤. ë§Œì¼ íŠ¹ì • íƒ€ìž…ì´ ë§¤í•‘ë˜ì§€ 않거나
+ 예ìƒë˜ëŠ” 타입으로 귀결ë˜ì§€ ì•Šì„ ê²½ìš°ì— Dialect ë‚´ì— ìžˆëŠ”
+ <literal>registerHibernateType</literal>ì— ëŒ€í•œ í˜¸ì¶œë“¤ì„ í†µí•´ 그것ì„
+ 맞춤화 시키는 ê²ƒì´ ê°€ëŠ¥í•˜ë‹¤.</para>
+ </sect2>
+
+ <sect2>
+ <title>Entity 질ì˜ë“¤</title>
+
+ <para>ìœ„ì˜ ì§ˆì˜ë“¤ì€ ìŠ¤ì¹¼ë¼ ê°’ë“¤ì„ ë°˜í™˜í•˜ëŠ” 것, 결과셋들로부터 "ì›ëž˜ì˜" 값들ì„
+ 기본ì 으로 반환하는 ê²ƒì— ëŒ€í•œ ì „ë¶€ì˜€ë‹¤. 다ìŒì€ <literal>addEntity()</literal>를
+ 통해 native sql 질ì˜ë¡œë¶€í„° 엔티티 ê°ì²´ë“¤ì„ 얻는 ë°©ë²•ì„ ë³´ì—¬ì¤€ë‹¤.</para>
+
+ <programlisting><![CDATA[sess.createSQLQuery("SELECT * FROM CATS").addEntity(Cat.class);
+sess.createSQLQuery("SELECT ID, NAME, BIRTHDATE FROM CATS").addEntity(Cat.class);
+]]></programlisting>
+
<para>ì´ ì§ˆì˜ëŠ” 다ìŒì„ ì§€ì •í–ˆë‹¤:</para>
-
+
<itemizedlist>
<listitem>
- <para>
- Hibernateê°€ 컬럼 aliasë“¤ì„ ë„입하기 위한, placeholder를 가진, SQL ì§ˆì˜ ë¬¸ìžì—´
- </para>
+ <para>SQL ì§ˆì˜ ë¬¸ìžì—´</para>
</listitem>
+
<listitem>
- <para>
- ê·¸ 질ì˜ì— ì˜í•´ ë°˜í™˜ëœ ì—”í‹°í‹°ì™€ ê·¸ê²ƒì˜ SQL í…Œì´ë¸” alias
- </para>
+ <para>ê·¸ 질ì˜ì— ì˜í•´ 반환ë˜ëŠ” 엔티티</para>
</listitem>
- </itemizedlist>
-
- <para>
- <literal>addEntity()</literal> 메소드는 SQL í…Œì´ë¸” alias를 ë°˜í™˜ëœ ì—”í‹°í‹° í´ëž˜ìŠ¤ì™€ ì—°ê´€ì§€ìš°ê³ ,
- ì§ˆì˜ ê²°ê³¼ ì…‹ì˜ í˜•íƒœë¥¼ ê²°ì •í•œë‹¤.
- </para>
-
- <para>
- <literal>addJoin()</literal> 메소드는 다른 엔티티들과 ì½œë ‰ì…˜ë“¤ì— ëŒ€í•œ ì—°ê´€ë“¤ì„ ë¡œë“œì‹œí‚¤ëŠ”ë° ì‚¬ìš©ë 수 있다.
- </para>
-
- <programlisting><![CDATA[List cats = sess.createSQLQuery(
- "select {cat.*}, {kitten.*} from cats cat, cats kitten where kitten.mother = cat.id"
- )
- .addEntity("cat", Cat.class)
- .addJoin("kitten", "cat.kittens")
- .list();]]></programlisting>
-
- <para>
- native SQL 질ì˜ëŠ” 간단한 ìŠ¤ì¹¼ë¼ ê°’ì„ ë°˜í™˜í•˜ê±°ë‚˜ 스칼ë¼ë“¤ê³¼ ì—”í‹°í‹°ë“¤ì˜ ì¡°í•©ì„ ë°˜í™˜í• ìˆ˜ë„ ìžˆë‹¤.
- </para>
+ </itemizedlist>
- <programlisting><![CDATA[Double max = (Double) sess.createSQLQuery("select max(cat.weight) as maxWeight from cats cat")
- .addScalar("maxWeight", Hibernate.DOUBLE);
- .uniqueResult();]]></programlisting>
-
- <para>ë‹¹ì‹ ì€ ë‹¹ì‹ ì˜ hbm 파ì¼ë“¤ ë‚´ì— ê²°ê³¼ì…‹ 매핑 ì •ë³´ë¥¼ ëŒ€ì•ˆì €ê¸ë¡œ 설명활 수 ìžˆê³ ë‹¹ì‹ ì˜ ì§ˆì˜ë“¤ì„ 위해 그것들ì„
- ì‚¬ìš©í• ìˆ˜ 있다.</para>
+ <para>Catì´ ì»¬ëŸ¼ ID, NAME ê·¸ë¦¬ê³ BIRTHDATE로서 매핑ëœë‹¤ê³ ê°€ì •í•˜ë©´,
+ ìœ„ì˜ ì§ˆì˜ë“¤ì€ 둘다 ê°ê°ì˜ 요소가 í•˜ë‚˜ì˜ Cat ì—”í‹°í‹°ì¸ í•˜ë‚˜ì˜ List를 ë°˜í™˜í• ê²ƒì´ë‹¤.</para>
- <programlisting><![CDATA[List cats = sess.createSQLQuery(
- "select {cat.*}, {kitten.*} from cats cat, cats kitten where kitten.mother = cat.id"
- )
- .setResultSetMapping("catAndKitten")
- .list();]]></programlisting>
+ <para>ë§Œì¼ ê·¸ 엔티티가 ë˜ ë‹¤ë¥¸ ì—”í‹°í‹°ì— ëŒ€í•´ <literal>many-to-one</literal>ë¡œ
+ 매핑ë˜ì–´ 있다면 ë˜í•œ native 질ì˜ë¥¼ ì‹¤í–‰í• ë•Œ ì´ê²ƒì„ 반환하는 ê²ƒì´ í•„ìˆ˜ì ê³ , ê·¸ ë°–ì˜ ê²½ìš°
+ ë°ì´í„°ë² ì´ìŠ¤ ì§€ì •ì ì¸ "ì»¬ëŸ¼ì´ ë°œê²¬ë˜ì§€ 않았습니다" 오류가 ì¼ì–´ë‚ 것ì´ë‹¤. 추가ì ì¸
+ ì»¬ëŸ¼ì€ * 표기를 ì‚¬ìš©í• ìžë™ì 으로 반환ë 것ì´ì§€ë§Œ, 우리는 ë‹¤ìŒ <literal>Dog</literal>ì—
+ 대한 <literal>many-to-one</literal> ì˜ˆì œì—서처럼 명시ì ì¸ ê²ƒì„ ë” ì„ í˜¸í•œë‹¤:</para>
- </sect1>
+ <programlisting><![CDATA[sess.createSQLQuery("SELECT ID, NAME, BIRTHDATE, DOG_ID FROM CATS").addEntity(Cat.class);
+]]></programlisting>
- <sect1 id="querysql-aliasreferences">
- <title>Alias 참조와 프로í¼í‹° 참조</title>
+ <para>ì´ê²ƒì€ cat.getDog()ì´ ê³ ìœ í•˜ê²Œ 기능하는 ê²ƒì„ í—ˆìš©í•œë‹¤.</para>
+ </sect2>
- <para>
- 위ì—ì„œ ì‚¬ìš©ëœ <literal>{cat.*}</literal> 표기는 "ëª¨ë“ í”„ë¡œí¼í‹°"ì— ëŒ€í•œ 약어ì´ë‹¤. 다른 방법으로, ë‹¹ì‹ ì€ ëª…ì‹œì 으로 컬럼들ì„
- ë¦¬ìŠ¤íŠ¸í• ìˆ˜ 있지만, 심지어 ì´ ê²½ìš° ì¡°ì°¨ë„ ìš°ë¦¬ëŠ” Hibernateë¡œ 하여금 ê°ê°ì˜ 프로í¼í‹°ì— 대해 SQL 컬럼 aliasë“¤ì„ ë¼ì›Œë„£ë„ë¡ í•´ì•¼ 한다.
- 컬럼 aliasì— ëŒ€í•œ placeholder는 í…Œì´ë¸” alias 수ì‹ì–´ê°€ ë¶™ì€ í”„ë¡œí¼í‹° ì´ë¦„ì´ë‹¤. ë‹¤ìŒ ì˜ˆì œì—ì„œ, 우리는 매핑 메타ë°ì´í„°ì— ì„ ì–¸ëœ
- ê²ƒì— ëŒ€í•´ 다른 í…Œì´ë¸” (<literal>cat_log</literal>)로부터 <literal>Cat</literal>ë“¤ì„ ê²€ìƒ‰í•œë‹¤. 우리는 심지어 우리가
- ì¢‹ì•„í• ê²½ìš° where ì ˆ ì†ì— 프로í¼í‹° aliasë“¤ì„ ì‚¬ìš©í• ìˆ˜ë„ ìžˆìŒì„ 주목하ë¼.
- </para>
- <para>
- The <literal>{}</literal>-syntax is <emphasis>not</emphasis> required for named queries.
- See <xref linkend="querysql-namedqueries"/>
- </para>
-
- <programlisting><![CDATA[String sql = "select cat.originalId as {cat.id}, " +
- "cat.mateid as {cat.mate}, cat.sex as {cat.sex}, " +
- "cat.weight*10 as {cat.weight}, cat.name as {cat.name} " +
- "from cat_log cat where {cat.mate} = :catId"
+ <sect2>
+ <title>연관들과 ì½œë ‰ì…˜ë“¤ì„ ì²˜ë¦¬í•˜ê¸°</title>
+ <para>프ë½ì‹œë¥¼ 초기화 ì‹œí‚´ì— ìžˆì–´ 가능한 특별한 ë¼ìš´ë“œíŠ¸ë¦½ì„ 피하기 위해서
+ <literal>Dog</literal>ì—ì„œ eagerly join시키는 ê²ƒì´ ê°„ìœ¼í•˜ë‹¤. ì´ê²ƒì€
+ <literal>addJoin()</literal> 메소드를 통해 행해지는ë°, 그것ì€
+ ì—°ê´€ì´ë‚˜ ì½œë ‰ì…˜ ë‚´ì—ì„œ ì¡°ì¸ì‹œí‚¤ëŠ” ê²ƒì„ ë‹¹ì‹ ì—게 허용해준다.</para>
+
+ <programlisting><![CDATA[sess.createSQLQuery("SELECT c.ID, NAME, BIRTHDATE, DOG_ID, D_ID, D_NAME FROM CATS c, DOGS d WHERE c.DOG_ID = d.D_ID")
+ .addEntity("cat", Cat.class)
+ .addJoin("cat.dog");
+]]></programlisting>
+
+ <para>ì´ ì˜ˆì œì—ì„œ 반환ë˜ëŠ” <literal>Cat</literal>ë“¤ì€ ë°ì´í„°ë² ì´ìŠ¤ì—
+ 대한 ìž„ì˜ì˜ 특별한 ë¼ìš´ë“œí¬ë¦½ ì—†ì´ ì „ì²´ì 으로 ì´ˆê¸°í™”ëœ ê·¸ê²ƒë“¤ì˜ <literal>dog</literal>
+ 프로í¼í‹°ë¥¼ 갖는다. 우리가 joinì˜ ëŒ€ìƒ í”„ë¡œí¼í‹° 경로를 ì§€ì •í•˜ëŠ” ê²ƒì„ ê°€ëŠ¥í•˜ë„ë¡ í•˜ê¸° 위해
+ í•˜ë‚˜ì˜ alias ì´ë¦„("cat")ì„ ì¶”ê°€í–ˆìŒì„ 주지하ë¼. ëŒ€ì‹ ì— ì˜ˆë¥¼ 들어 <literal>Cat</literal>ì´
+ <literal>Dog</literal>ì— ëŒ€í•´ one-to-many를 가질 경우, ì½œë ‰ì…˜ë“¤ì— ëŒ€í•´ ë™ì¼í•œ eager joiningì„
+ 행하는 ê²ƒì´ ê°€ëŠ¥í•˜ë‹¤.</para>
+
+ <programlisting><![CDATA[sess.createSQLQuery("SELECT ID, NAME, BIRTHDATE, D_ID, D_NAME, CAT_ID FROM CATS c, DOGS d WHERE c.ID = d.CAT_ID")
+ .addEntity("cat", Cat.class)
+ .addJoin("cat.dogs");
+]]></programlisting>
+
+ <p>ì´ ë‹¨ê³„ì—ì„œ 우리는 Hibernateì—ì„œ native 질ì˜ë“¤ì„ 사용가능하ë„ë¡ ë§Œë“¤ê¸° 위해
+ sql 질ì˜ë“¤ì„ 강화시키지는 ê²ƒì„ ì‹œìž‘í•˜ì§€ ì•Šê³ ì„œë„ native 질ì˜ë“¤ë¡œì„œ 가능한 ê²ƒì˜ í•œê³„ì—
+ ë„ë‹¬í•˜ê³ ìžˆë‹¤; ë¬¸ì œì ë“¤ì€ ë™ì¼í•œ íƒ€ìž…ì˜ ì—¬ëŸ¬ ì—”í‹°í‹°ë“¤ì„ ë°˜í™˜í• ë•Œ ë˜ëŠ” ë””í´íŠ¸ alias/column
+ ì´ë¦„ë“¤ì´ ì¶©ë¶„í•˜ì§€ ì•Šì„ ë•Œ ë°œìƒí•˜ê¸° 시작한다.</p>
+ </sect2>
+
+ <sect2>
+ <title>여러 ê°œì˜ ì—”í‹°í‹°ë“¤ì„ ë°˜í™˜í•˜ê¸°</title>
+
+ <para>지금까지 ê²°ê³¼ ì…‹ 컬럼 ì´ë¦„ë“¤ì€ ë§¤í•‘ 문서 ë‚´ì— ì§€ì •ëœ ì»¬ëŸ¼ ì´ë¦„들과 ë™ì¼í•˜ë‹¤ê³ ê°€ì •ë˜ì–´ 있다.
+ ë™ì¼í•œ ì»¬ëŸ¼ì´ í•˜ë‚˜ ì´ìƒì˜ í…Œì´ë¸” ë‚´ì—ì„œ ë‚˜íƒ€ë‚ ìˆ˜ 있기 때문ì—, ì´ê²ƒì€ 여러 ê°œì˜ í…Œì´ë¸”ë“¤ì„ ì¡°ì¸ì‹œí‚¤ëŠ”
+ SQL 질ì˜ë“¤ì— 대해 ë¬¸ì œê°€ ë 수 있다.</para>
+
+ <para>컬럼 alias ì£¼ìž…ì€ ë‹¤ìŒ ì§ˆì˜(아마 ì‹¤íŒ¨í• ê²ƒì´ë‹¤)ì—ì„œ 필요하다:</para>
+
+ <programlisting><![CDATA[sess.createSQLQuery("SELECT c.*, m.* FROM CATS c, CATS m WHERE c.MOTHER_ID = c.ID")
+ .addEntity("cat", Cat.class)
+ .addEntity("mother", Cat.class)
+]]></programlisting>
+
+ <para>ì´ ì§ˆì˜ì˜ 목ì ì€ ë‹¨ìœ„ í–‰ 당 ë‘ ê°œì˜ Cat ì¸ìŠ¤í„´ìŠ¤ë“¤, í•˜ë‚˜ì˜ cat ê·¸ë¦¬ê³ ê·¸ê²ƒì˜ mother를
+ 반환하는 것ì´ë‹¤. 왜ëƒí•˜ë©´ ê·¸ê²ƒë“¤ì´ ë™ì¼í•œ 컬럼 ì´ë¦„들로 매핑ë˜ì–´ 있기 ë•Œë¬¸ì— ì´ê²ƒì€ ì‹¤íŒ¨í• ê²ƒì´ê³
+ ë°ì´ë² ì´ìŠ¤ ìƒì—ì„œ ë°˜í™˜ëœ ì»¬ëŸ¼ aliasë“¤ì€ ì•„ë§ˆ 매핑들 ë‚´ì— ì§€ì •ëœ ì»¬ëŸ¼ë“¤("ID" 와 "NAME")ê³¼ 같지 ì•Šì€
+ "c.ID", "c.NAME" ë“±ì˜ í˜•ì‹ì¼ 것ì´ë‹¤.</para>
+
+ <para>ë‹¤ìŒ í˜•ì‹ì€ 컬럼 ì´ë¦„ 중복 취약ì ì„ ê°–ì§€ 않는다:</para>
+
+ <programlisting><![CDATA[sess.createSQLQuery("SELECT {cat.*}, {mother.*} FROM CATS c, CATS m WHERE c.MOTHER_ID = c.ID")
+ .addEntity("cat", Cat.class)
+ .addEntity("mother", Cat.class)
+]]></programlisting>
+
+ <para>ì´ ì§ˆì˜ëŠ” 다ìŒì„ ì§€ì •í–ˆë‹¤:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>컬럼 aliasë“¤ì„ ì£¼ìž…í•˜ê¸° 위한 Hibernateìš© placeholderë“¤ì„ ê°€ì§„ SQL ì§ˆì˜ ë¬¸ìžì—´</para>
+ </listitem>
+
+ <listitem>
+ <para>ê·¸ 질ì˜ì— ì˜í•´ 반환ë˜ëŠ” 엔티티들</para>
+ </listitem>
+ </itemizedlist>
+
+ <para>ìœ„ì— ì‚¬ìš©ëœ {cat.*} ê³¼ {mother.*} 표기는 "ëª¨ë“ í”„ë¡œí¼í‹°ë“¤"ì— ëŒ€í•œ ìƒëžµì´ë‹¤.
+ 다른 방법으로 ë‹¹ì‹ ì€ ì»¬ëŸ¼ë“¤ì„ ëª…ì‹œì 으로 ì—´ê±°í• ìˆ˜ë„ ìžˆì§€ë§Œ, ì´ ê²½ìš°ì— ìš°ë¦¬ëŠ” Hibernateë¡œ 하여금
+ SQL 컬럼 aliasë“¤ì„ ê°ê°ì˜ ì»¬ëŸ¼ì— ì£¼ìž…ì‹œí‚¤ë„ë¡ ê°•ì œí•œë‹¤. 컬럼 alias를 위한 placeholder는 단지
+ ê·¸ í…Œì´ë¸” aliasì— ì˜í•´ 수ì‹ëœ 프로í¼í‹° ì´ë¦„ì´ë‹¤. ë‹¤ìŒ ì˜ˆì œì—ì„œ, 우리는 다른 í…Œì´ë¸”(cat_log)로부터
+ 매핑 메타ë°ì´í„° ë‚´ì— ì„ ì–¸ëœ ê²ƒìœ¼ë¡œì˜ Cat들과 ê·¸ê²ƒë“¤ì˜ motherë“¤ì„ ê²€ìƒ‰í•œë‹¤. 우리는 우리가 좋다면
+ 심지어 where ì ˆ ë‚´ì— í”„ë¡œí¼í‹° alias를 ì‚¬ìš©í• ìˆ˜ë„ ìžˆìŒì„ 주지하ë¼.</para>
+
+ <programlisting><![CDATA[String sql = "SELECT ID as {c.id}, NAME as {c.name}, " +
+ "BIRTHDATE as {c.birthDate}, MOTHER_ID as {c.mother}, {mother.*} " +
+ "FROM CAT_LOG c, CAT_LOG m WHERE {c.mother} = c.ID";
+
List loggedCats = sess.createSQLQuery(sql)
- .addEntity("cat", Cat.class)
- .setLong("catId", catId)
- .list();]]></programlisting>
+ .addEntity("cat", Cat.class)
+ .addEntity("mother", Cat.class).list()
+]]></programlisting>
+ <sect3 id="querysql-aliasreferences" revision="2">
+ <title>alias 참조와 프로í¼í‹° 참조</title>
+
+ <para>ëŒ€ë¶€ë¶„ì˜ ê²½ìš°ì— ìœ„ì˜ alias ì£¼ìž…ì´ í•„ìš”í•˜ì§€ë§Œ, composite 프로í¼í‹°ë“¤, ìƒì† íŒë³„ìžë“¤
+ (inheritance discriminators), ì½œë ‰ì…˜ 등과 ê°™ì€ ë³´ë‹¤ 복잡한 매핑들과 ê´€ë ¨ëœ ì§ˆì˜ë“¤ì˜ 경우ì—는
+ ê³ ìœ í•œ aliasë“¤ì„ ì£¼ìž…ì‹œí‚¤ëŠ” ê²ƒì„ Hibernateì—게 í—ˆìš©í•˜ëŠ”ë° ì‚¬ìš©ë 몇몇 특별한 aliasë“¤ì´ ì¡´ìž¬í•œë‹¤.</para>
+
+ <para>ë‹¤ìŒ í…Œì´ë¸”ì€ alias ì£¼ìž…ì„ ì‚¬ìš©í•˜ëŠ” 다른 ê°€ëŠ¥ì„±ë“¤ì„ ë³´ì—¬ì¤€ë‹¤. 노트: ê²°ê³¼ ë‚´ì— ìžˆëŠ” alias ì´ë¦„들ì´
+ ì˜ˆì œì´ë©°, ê°ê°ì˜ alias는 사용ë ë•Œ í•˜ë‚˜ì˜ ìœ ì¼í•œ ì´ë¦„ê³¼ 아마 다른 ì´ë¦„ì„ ê°€ì§ˆ 것ì´ë‹¤.</para>
+
+ <table frame="topbot" id="aliasinjection-summary">
+ <title>alias 주입 ì´ë¦„들</title>
+
+ <tgroup cols="3">
+ <colspec colwidth="1*" />
+
+ <colspec colwidth="1*" />
+
+ <colspec colwidth="2.5*" />
+
+ <thead>
+ <row>
+ <entry>설명</entry>
+
+ <entry>구문</entry>
+
+ <entry>ì˜ˆì œ</entry>
+ </row>
+ </thead>
+
+ <tbody>
+ <row>
+ <entry>간단한 프로í¼í‹°</entry>
+ <entry><literal>{[aliasname].[propertyname]</literal></entry>
+
+ <entry><literal>A_NAME as {item.name}</literal></entry>
+ </row>
+
+ <row>
+ <entry>composite 프로í¼í‹°</entry>
+
+ <entry><literal>{[aliasname].[componentname].[propertyname]}</literal></entry>
+
+ <entry><literal>CURRENCY as {item.amount.currency}, VALUE as {item.amount.value}</literal></entry>
+ </row>
+
+ <row>
+ <entry>ì—”í‹°í‹°ì˜ íŒë³„ìž(Discriminator)</entry>
+ <entry><literal>{[aliasname].class}</literal></entry>
+
+ <entry><literal>DISC as {item.class}</literal></entry>
+ </row>
+
+ <row>
+ <entry>ì—”í‹°í‹°ì˜ ëª¨ë“ í”„ë¡œí¼í‹°ë“¤</entry>
+ <entry><literal>{[aliasname].*}</literal></entry>
+
+ <entry><literal>{item.*}</literal></entry>
+ </row>
+
+ <row>
+ <entry>ì½œë ‰ì…˜ 키</entry>
+ <entry><literal>{[aliasname].key}</literal></entry>
+
+ <entry><literal>ORGID as {coll.key}</literal></entry>
+ </row>
+
+ <row>
+ <entry>ì½œë ‰ì…˜ì˜ id</entry>
+ <entry><literal>{[aliasname].id}</literal></entry>
+
+ <entry><literal>EMPID as {coll.id}</literal></entry>
+ </row>
+
+ <row>
+ <entry>ì½œë ‰ì…˜ì˜ ìš”ì†Œ</entry>
+ <entry><literal>{[aliasname].element}</literal></entry>
+
+ <entry><literal>XID as {coll.element}</literal></entry>
+ <entry></entry>
+ </row>
+
+ <row>
+ <entry>ì½œë ‰ì…˜ ë‚´ì— ìžˆëŠ” ìš”ì†Œì˜ í”„ë¡œí¼í‹°</entry>
+ <entry><literal>{[aliasname].element.[propertyname]}</literal></entry>
+
+ <entry><literal>NAME as {coll.element.name}</literal></entry>
+ </row>
+
+ <row>
+ <entry>ì½œë ‰ì…˜ ë‚´ì— ìžˆëŠ” ìš”ì†Œì˜ ëª¨ë“ í”„ë¡œí¼í‹°ë“¤</entry>
+ <entry><literal>{[aliasname].element.*}</literal></entry>
+
+ <entry><literal>{coll.element.*}</literal></entry>
+ </row>
+
+ <row>
+ <entry>ì½œë ‰ì…˜ì˜ ëª¨ë“ í”„ë¡œí¼í‹°ë“¤</entry>
+ <entry><literal>{[aliasname].*}</literal></entry>
+
+ <entry><literal>{coll.*}</literal></entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </sect3>
+ </sect2>
+
+ <sect2>
+ <title>non-managed ì—”í‹°í‹°ë“¤ì„ ë°˜í™˜í•˜ê¸°</title>
+
+ <para>native sql 질ì˜ì— ResultTransformer를 ì 용하는 ê²ƒì´ ê°€ëŠ¥í•˜ë‹¤. 예를 들어
+ non-managed ì—”í‹°í‹°ë“¤ì„ ë°˜í™˜í•˜ê¸° 위해 ResultTransformer를 허용하는 것.</para>
+
+ <programlisting><![CDATA[sess.createSQLQuery("SELECT NAME, BIRTHDATE FROM CATS")
+ .setResultTransformer(Transformers.aliasToBean(CatDTO.class))]]></programlisting>
+
+ <para>ì´ ì§ˆì˜ëŠ” 다ìŒì„ ì§€ì •í–ˆë‹¤:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>SQL ì§ˆì˜ ë¬¸ìžì—´</para>
+ </listitem>
+
+ <listitem>
+ <para>ê²°ê³¼ 변환ìž(transformer)</para>
+ </listitem>
+ </itemizedlist>
+
<para>
- <emphasis>노트:</emphasis> ë§Œì¼ ë‹¹ì‹ ì´ ê°ê°ì˜ 프로í¼í‹°ë¥¼ 명시ì 으로 ë¦¬ìŠ¤íŠ¸í• ê²½ìš°, ë‹¹ì‹ ì€ ê·¸ í´ëž˜ìŠ¤ì™€
- <emphasis>ê·¸ê²ƒì˜ ì„œë¸Œí´ëž˜ìŠ¤ë“¤</emphasis>ì˜ ëª¨ë“ í”„ë¡œí¼í‹°ë“¤ì„ í¬í•¨í•´ì•¼ 한다!
+ ìœ„ì˜ ì§ˆì˜ëŠ” 초기화ë˜ì–´ ìžˆê³ NAMEê³¼ BIRTHNAMEì˜ ê°’ë“¤ì„ <literal>CatDTO</literal>ì˜
+ 대ì‘하는 프로í¼í‹°ë“¤ê³¼ 필드들 ì†ìœ¼ë¡œ 주입시킨 <literal>CatDTO</literal>ì˜ ë¦¬ìŠ¤íŠ¸ë¥¼ ë°˜í™˜í• ê²ƒì´ë‹¤.
</para>
- <para>
- ë‹¤ìŒ í…Œì´ë¸”ì€ alias injectionì„ ì‚¬ìš©í•˜ëŠ” 다른 ê°€ëŠ¥ì„±ë“¤ì„ ë³´ì—¬ì¤€ë‹¤. 노트 : ê²°ê³¼ ë‚´ì—ì„œ alias ì´ë¦„ë“¤ì´ ì˜ˆì œë“¤ì´ë©°, ê°ê°ì˜ alias는
- 사용ë ì‹œì— í•˜ë‚˜ì˜ ìœ ì¼í•œ ê·¸ë¦¬ê³ ê°€ëŠ¥í•œ 다른 ì´ë¦„ì„ ê°€ì§ˆ 것ì´ë‹¤.
- </para>
+ </sect2>
- <table frame="topbot" id="aliasinjection-summary">
- <title>Alias injection ì´ë¦„들</title>
-
- <tgroup cols="4">
- <colspec colwidth="1*"/>
-
- <colspec colwidth="1*"/>
-
- <colspec colwidth="2.5*"/>
-
- <thead>
- <row>
- <entry>설명</entry>
- <entry>구문</entry>
- <entry>ì˜ˆì œ</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>간단한 프로í¼í‹°</entry>
- <entry><literal>{[aliasname].[propertyname]</literal></entry>
- <entry><literal>A_NAME as {item.name}</literal></entry>
- </row>
- <row>
- <entry>composite 프로í¼í‹°</entry>
- <entry><literal>{[aliasname].[componentname].[propertyname]}</literal></entry>
- <entry><literal>CURRENCY as {item.amount.currency}, VALUE as {item.amount.value}</literal></entry>
- </row>
- <row>
- <entry>ì—”í‹°í‹°ì˜ íŒë³„ìž(Discriminator)</entry>
- <entry><literal>{[aliasname].class}</literal></entry>
- <entry><literal>DISC as {item.class}</literal></entry>
- </row>
- <row>
- <entry>ì—”í‹°í‹°ì˜ ëª¨ë“ í”„ë¡œí¼í‹°ë“¤</entry>
- <entry><literal>{[aliasname].*}</literal></entry>
- <entry><literal>{item.*}</literal></entry>
- </row>
- <row>
- <entry>ì½œë ‰ì…˜ 키</entry>
- <entry><literal>{[aliasname].key}</literal></entry>
- <entry><literal>ORGID as {coll.key}</literal></entry>
- </row>
- <row>
- <entry>ì½œë ‰ì…˜ì˜ id</entry>
- <entry><literal>{[aliasname].id}</literal></entry>
- <entry><literal>EMPID as {coll.id}</literal></entry>
- </row>
- <row>
- <entry>ì½œë ‰ì…˜ì˜ ìš”ì†Œ</entry>
- <entry><literal>{[aliasname].element}</literal></entry>
- <entry><literal>XID as {coll.element}</literal></entry>
- <entry></entry>
- </row>
- <row>
- <entry>ì½œë ‰ì…˜ ë‚´ì— ìžˆëŠ” ìš”ì†Œì˜ í”„ë¡œí¼í‹°</entry>
- <entry><literal>{[aliasname].element.[propertyname]}</literal></entry>
- <entry><literal>NAME as {coll.element.name}</literal></entry>
- </row>
-
- <row>
- <entry>ì½œë ‰ì…˜ ë‚´ì— ìžˆëŠ” ìš”ì†Œì˜ ëª¨ë“ í”„ë¡œí¼í‹°ë“¤</entry>
- <entry><literal>{[aliasname].element.*}</literal></entry>
- <entry><literal>{coll.element.*}</literal></entry>
- </row>
- <row>
- <entry>ì½œë ‰ì…˜ì˜ ëª¨ë“ í”„ë¡œí¼í‹°ë“¤</entry>
- <entry><literal>{[aliasname].*}</literal></entry>
- <entry><literal>{coll.*}</literal></entry>
- </row>
- </tbody>
- </tgroup>
- </table>
+ <sect2>
+ <title>ìƒì† 처리하기</title>
+ <para>ìƒì†ì˜ 부분으로서 매핑ë˜ëŠ” ì—”í‹°í‹°ë“¤ì„ ì§ˆì˜í•˜ëŠ” native sql 질ì˜ë“¤ì€ baseclassì˜
+ ëª¨ë“ í”„ë¡œí¼í‹°ë“¤ì„ í¬í•¨í•´ì•¼ í•˜ê³ ê·¸ ëª¨ë“ ê²ƒì´ ì„œë¸Œí´ëž˜ìŠ¤í™” ë˜ì–´ì•¼ 한다.</para>
+ </sect2>
+
+ <sect2>
+ <title>파ë¼ë¯¸í„°ë“¤</title>
+
+ <para>Native sql 질ì˜ë“¤ì€ 위치 파ë¼ë¯¸í„°ë“¤ ë¿ë§Œ ì•„ë‹ˆë¼ ëª…ëª…ëœ íŒŒë¼ë¯¸í„°ë“¤ì„ 지ì›í•œë‹¤:</para>
+
+ <programlisting><![CDATA[Query query = sess.createSQLQuery("SELECT * FROM CATS WHERE NAME like ?").addEntity(Cat.class);
+List pusList = query.setString(0, "Pus%").list();
+
+query = sess.createSQLQuery("SELECT * FROM CATS WHERE NAME like :name").addEntity(Cat.class);
+List pusList = query.setString("name", "Pus%").list(); ]]></programlisting>
+ </sect2>
+
+
+
</sect1>
-
+
<sect1 id="querysql-namedqueries" revision="3">
<title>ëª…ëª…ëœ SQL 질ì˜ë“¤</title>
@@ -219,7 +369,7 @@
<literal>addEntity()</literal> í˜¸ì¶œì„ í•„ìš”ë¡œ 하지 <emphasis>않는다</emphasis>.
</para>
- <programlisting><![CDATA[<sql-query name="persons">
+ <programlisting><![CDATA[<sql-query name="persons">
<return alias="person" class="eg.Person"/>
SELECT person.NAME AS {person.name},
person.AGE AS {person.age},
@@ -228,16 +378,17 @@
WHERE person.NAME LIKE :namePattern
</sql-query>]]></programlisting>
- <programlisting><![CDATA[List people = sess.getNamedQuery("persons")
+ <programlisting><![CDATA[List people = sess.getNamedQuery("persons")
.setString("namePattern", namePattern)
.setMaxResults(50)
.list();]]></programlisting>
- <para>
- The <literal><return-join></literal> 요소와 <literal><load-collection></literal>
- 요소는 ì—°ê´€ë“¤ì„ ì¡°ì¸ì‹œí‚¤ê³ ì½œë ‰ì…˜ë“¤ì„ ê°ê° 초기화 시키는 질ì˜ë“¤ì„ ì •ì˜í•˜ëŠ”ë° ì‚¬ìš©ëœë‹¤.
- </para>
+
+ <para><literal><return-join></literal> 요소와
+ <literal><load-collection></literal>
+ 요소는 ì—°ê´€ë“¤ì„ ì¡°ì¸ì‹œí‚¤ê³ ì½œë ‰ì…˜ë“¤ì„ ê°ê° 초기화 시키는 질ì˜ë“¤ì„
+ ì •ì˜í•˜ëŠ”ë° ì‚¬ìš©ëœë‹¤.</para>
- <programlisting><![CDATA[<sql-query name="personsWith">
+ <programlisting><![CDATA[<sql-query name="personsWith">
<return alias="person" class="eg.Person"/>
<return-join alias="address" property="person.mailingAddress"/>
SELECT person.NAME AS {person.name},
@@ -253,12 +404,11 @@
WHERE person.NAME LIKE :namePattern
</sql-query>]]></programlisting>
- <para>
- ëª…ëª…ëœ SQL 질ì˜ëŠ” ìŠ¤ì¹¼ë¼ ê°’ì„ ë°˜í™˜í• ìˆ˜ë„ ìžˆë‹¤. ë‹¹ì‹ ì€ <literal><return-scalar></literal> 요소를 사용하여
- 컬럼 alias와 Hibernate íƒ€ìž…ì„ ì„ ì–¸í•´ì•¼ 한다:
- </para>
+ <para>ëª…ëª…ëœ SQL 질ì˜ëŠ” ìŠ¤ì¹¼ë¼ ê°’ì„ ë°˜í™˜í• ìˆ˜ë„ ìžˆë‹¤. ë‹¹ì‹ ì€
+ <literal><return-scalar></literal> 요소를 사용하여
+ 컬럼 alias와 Hibernate íƒ€ìž…ì„ ì„ ì–¸í•´ì•¼ 한다:</para>
- <programlisting><![CDATA[<sql-query name="mySqlQuery">
+ <programlisting><![CDATA[<sql-query name="mySqlQuery">
<return-scalar column="name" type="string"/>
<return-scalar column="age" type="long"/>
SELECT p.NAME AS name,
@@ -288,16 +438,23 @@
WHERE person.NAME LIKE :namePattern
</sql-query>]]></programlisting>
- <sect2 id="propertyresults">
- <title>명시ì 으로 column/alias ì´ë¦„ë“¤ì„ ì§€ì •í•˜ëŠ”ë° return-property 사용하기</title>
+ <para>다른방법으로 ë‹¹ì‹ ì€ ë‹¹ì‹ ì˜ hbm 파ì¼ë“¤ ë‚´ì— ì§ì ‘ ìžë°” 코드로 ëœ ê²°ê³¼ì…‹ 매핑 ì •ë³´ë¥¼ ì‚¬ìš©í• ìˆ˜ 있다.</para>
+
+ <programlisting><![CDATA[List cats = sess.createSQLQuery(
+ "select {cat.*}, {kitten.*} from cats cat, cats kitten where kitten.mother = cat.id"
+ )
+ .setResultSetMapping("catAndKitten")
+ .list();]]></programlisting>
+
+ <sect2 id="propertyresults">
+ <title>명시ì 으로 column/alias ì´ë¦„ë“¤ì„ ì§€ì •í•˜ëŠ”ë° return-property 사용하기</title>
+
+ <para>Hibernateë¡œ 하여금 그것 ìžì‹ ì˜ aliasë“¤ì„ ë¼ì›Œë„£ë„ë¡ í•˜ê¸° 위해
+ <literal>{}</literal>-êµ¬ë¬¸ì„ ì‚¬ìš©í•˜ëŠ” 것 ëŒ€ì‹ ì—,
+ <literal><return-property></literal>로서 ë‹¹ì‹ ì€ ì‚¬ìš©í•
+ 컬럼 aliasë“¤ì´ ë¬´ì—‡ì¸ì§€ë¥¼ Hibernateì—게 명시ì 으로 ì•Œë ¤ì¤„ 수 있다.</para>
- <para>
- Hibernateë¡œ 하여금 그것 ìžì‹ ì˜ aliasë“¤ì„ ë¼ì›Œë„£ë„ë¡ í•˜ê¸° 위해 <literal>{}</literal>-êµ¬ë¬¸ì„ ì‚¬ìš©í•˜ëŠ” 것 ëŒ€ì‹ ì—,
- <literal><return-property></literal>로서 ë‹¹ì‹ ì€ ì‚¬ìš©í• ì»¬ëŸ¼ aliasë“¤ì´ ë¬´ì—‡ì¸ì§€ë¥¼ Hibernateì—게 명시ì 으로
- ì•Œë ¤ì¤„ 수 있다.
- </para>
-
- <programlisting><![CDATA[<sql-query name="mySqlQuery">
+ <programlisting><![CDATA[<sql-query name="mySqlQuery">
<return alias="person" class="eg.Person">
<return-property name="name" column="myName"/>
<return-property name="age" column="myAge"/>
@@ -310,12 +467,11 @@
</sql-query>
]]></programlisting>
- <para>
- <literal><return-property></literal>는 ë˜í•œ 다중 ì»¬ëŸ¼ë“¤ì— ëŒ€í•´ ë™ìž‘한다. ì´ê²ƒì€ 다중-컬럼 프로í¼í‹°ë“¤ì—
- 대한 fine grained ì œì–´ë¥¼ í—ˆìš©í• ìˆ˜ 없는 <literal>{}</literal>-êµ¬ë¬¸ì„ ê°€ì§„ ì œì•½ì„ í•´ê²°í•´ì¤€ë‹¤.
- </para>
-
- <programlisting><![CDATA[<sql-query name="organizationCurrentEmployments">
+ <para><literal><return-property></literal>는 ë˜í•œ 다중 ì»¬ëŸ¼ë“¤ì— ëŒ€í•´ ë™ìž‘한다.
+ ì´ê²ƒì€ 다중-컬럼 프로í¼í‹°ë“¤ì— 대한 fine grained ì œì–´ë¥¼ í—ˆìš©í• ìˆ˜ 없는
+ <literal>{}</literal>-êµ¬ë¬¸ì„ ê°€ì§„ ì œì•½ì„ í•´ê²°í•´ì¤€ë‹¤.</para>
+
+ <programlisting><![CDATA[<sql-query name="organizationCurrentEmployments">
<return alias="emp" class="Employment">
<return-property name="salary">
<return-column name="VALUE"/>
@@ -330,28 +486,22 @@
WHERE EMPLOYER = :id AND ENDDATE IS NULL
ORDER BY STARTDATE ASC
</sql-query>]]></programlisting>
-
- <para>
- ì´ ì˜ˆì œì—ì„œ 우리는 ë¼ì›Œë„£ê¸°(injection)를 위해 <literal>{}</literal>-구문과 함께 <literal><return-property></literal>를
- 사용했ìŒì„ 주목하ë¼. 사용ìžë“¤ì´ 컬럼과 프로í¼í‹°ë“¤ì„ ì°¸ì¡°í•˜ê³ ìž ì›í•˜ëŠ” ë°©ë²•ì„ ì„ íƒí•˜ëŠ” ê²ƒì„ ì‚¬ìš©ìžë“¤ì—게 허용해줌으로ì¨.
- </para>
- <para>
- ë§Œì¼ ë‹¹ì‹ ì˜ ë§¤í•‘ì´ í•œ ê°œì˜ íŒë³„ìž(discriminator )를 가질 경우 ë‹¹ì‹ ì€ íŒë³„ìž ì»¬ëŸ¼ì„ ì§€ì •í•˜ëŠ”ë°
- <literal><return-discriminator></literal>를 사용해야 한다.
- </para>
- </sect2>
+ <para>ì´ ì˜ˆì œì—ì„œ 우리는 ë¼ì›Œë„£ê¸°(injection)를 위해 <literal>{}</literal>-구문과 함께 <literal><return-property></literal>를
+ 사용했ìŒì„ 주목하ë¼. 사용ìžë“¤ì´ 컬럼과 프로í¼í‹°ë“¤ì„ ì°¸ì¡°í•˜ê³ ìž ì›í•˜ëŠ” ë°©ë²•ì„ ì„ íƒí•˜ëŠ” ê²ƒì„ ì‚¬ìš©ìžë“¤ì—게 허용해줌으로ì¨.</para>
+
+ <para>ë§Œì¼ ë‹¹ì‹ ì˜ ë§¤í•‘ì´ í•œ ê°œì˜ íŒë³„ìž(discriminator )를 가질 경우 ë‹¹ì‹ ì€ íŒë³„ìž ì»¬ëŸ¼ì„ ì§€ì •í•˜ëŠ”ë°
+ <literal><return-discriminator></literal>를 사용해야 한다.</para>
+ </sect2>
- <sect2 id="sp_query" revision="1">
- <title>질ì˜ë¥¼ 위한 내장 í”„ë¡œì‹œì € 사용하기</title>
-
- <para>
- Hibernate 3ì€ ë‚´ìž¥ í”„ë¡œì‹œì €ë“¤ê³¼ í•¨ìˆ˜ë“¤ì„ í†µí•œ ì§ˆì˜ ì§€ì›ì„ ë„입한다. ëŒ€ë¶€ë¶„ì˜ ë‹¤ìŒ ë¬¸ì„œëŠ” ì–‘ìž ëª¨ë‘ì— ë™ì¼í•˜ê²Œ ì ìš©ëœë‹¤.
- 내장 í”„ë¡œì‹œì €/함수는 Hibernate와 ë™ìž‘하는 ê²ƒì´ ê°€ëŠ¥í•˜ë„ë¡ ì²« 번째 out-파ë¼ë¯¸í„°ë¡œì„œ í•œ ê°œì˜ ê²°ê³¼ì…‹ì„ ë°˜í™˜í•´ì•¼ 한다.
- Oracle9 ì´ìƒì˜ ë²„ì „ì—ì„œ 그런 내장 í”„ë¡œì‹œì €ì— ëŒ€í•œ ì˜ˆì œëŠ” 다ìŒê³¼ 같다:
- </para>
-
- <programlisting><![CDATA[CREATE OR REPLACE FUNCTION selectAllEmployments
+ <sect2 id="sp_query" revision="1">
+ <title>질ì˜ë¥¼ 위한 내장 í”„ë¡œì‹œì € 사용하기</title>
+
+ <para>Hibernate 3ì€ ë‚´ìž¥ í”„ë¡œì‹œì €ë“¤ê³¼ í•¨ìˆ˜ë“¤ì„ í†µí•œ ì§ˆì˜ ì§€ì›ì„ ë„입한다. ëŒ€ë¶€ë¶„ì˜ ë‹¤ìŒ ë¬¸ì„œëŠ” ì–‘ìž ëª¨ë‘ì— ë™ì¼í•˜ê²Œ ì ìš©ëœë‹¤.
+ 내장 í”„ë¡œì‹œì €/함수는 Hibernate와 ë™ìž‘하는 ê²ƒì´ ê°€ëŠ¥í•˜ë„ë¡ ì²« 번째 out-파ë¼ë¯¸í„°ë¡œì„œ í•œ ê°œì˜ ê²°ê³¼ì…‹ì„ ë°˜í™˜í•´ì•¼ 한다.
+ Oracle9 ì´ìƒì˜ ë²„ì „ì—ì„œ 그런 내장 í”„ë¡œì‹œì €ì— ëŒ€í•œ ì˜ˆì œëŠ” 다ìŒê³¼ 같다:</para>
+
+ <programlisting><![CDATA[CREATE OR REPLACE FUNCTION selectAllEmployments
RETURN SYS_REFCURSOR
AS
st_cursor SYS_REFCURSOR;
@@ -363,12 +513,11 @@
FROM EMPLOYMENT;
RETURN st_cursor;
END;]]></programlisting>
-
- <para>
- Hibernateì—ì„œ ì´ ì§ˆì˜ë¥¼ 사용하기 위해 ë‹¹ì‹ ì€ í•˜ë‚˜ì˜ ëª…ëª…ëœ ì§ˆì˜(a named query)를 통해 ê·¸ê²ƒì„ ë§¤í•‘í• í•„ìš”ê°€ 있다.
- </para>
-
- <programlisting><![CDATA[<sql-query name="selectAllEmployees_SP" callable="true">
+
+ <para>Hibernateì—ì„œ ì´ ì§ˆì˜ë¥¼ 사용하기 위해 ë‹¹ì‹ ì€ í•˜ë‚˜ì˜ ëª…ëª…ëœ ì§ˆì˜(a named query)를 통해
+ ê·¸ê²ƒì„ ë§¤í•‘í• í•„ìš”ê°€ 있다.</para>
+
+ <programlisting><![CDATA[<sql-query name="selectAllEmployees_SP" callable="true">
<return alias="emp" class="Employment">
<return-property name="employee" column="EMPLOYEE"/>
<return-property name="employer" column="EMPLOYER"/>
@@ -383,78 +532,61 @@
</return>
{ ? = call selectAllEmployments() }
</sql-query>]]></programlisting>
-
- <para>
- 내장 í”„ë¡œì‹œì €ë“¤ì€ í˜„ìž¬ 스칼ë¼ë“¤ê³¼ 엔티티들 ë§Œì„ ë°˜í™˜í•¨ì„ ì£¼ëª©í•˜ë¼. <literal><return-join></literal>ê³¼
- <literal><load-collection></literal>ì€ ì§€ì›ë˜ì§€ 않는다.
- </para>
-
- <sect3 id="querysql-limits-storedprocedures" revision="1">
- <title>내장 í”„ë¡œì‹œì €ë“¤ì„ ì‚¬ìš©í•˜ëŠ” 규칙들/ì œì•½ë“¤</title>
-
- <para>
- Hibernateì—ì„œ 내장 í”„ë¡œì‹œì €ë“¤ì„ ì‚¬ìš©í•˜ê¸° 위해서 í”„ë¡œì‹œì €ë“¤/í•¨ìˆ˜ë“¤ì€ ë‹¤ìŒ ëª‡ëª‡ ê·œì¹™ë“¤ì„ ë”°ë¼ì•¼ 한다. ë§Œì¼ ê·¸ê²ƒë“¤ì´ ê·¸ë“¤ 규칙들ì„
- 따르지 ì•Šì„ ê²½ìš° ê·¸ê²ƒë“¤ì€ Hibernate와 함께 사용 불가능하다. ë§Œì¼ ë‹¹ì‹ ì´ ì—¬ì „ížˆ ì´ë“¤ í”„ë¡œì‹œì €ë“¤ì„ ì‚¬ìš©í•˜ê³ ìž ì›í• 경우,
- ë‹¹ì‹ ì€ <literal>session.connection()</literal>ì„ í†µí•´ ê·¸ê²ƒë“¤ì„ ì‹¤í–‰ì‹œì¼œì•¼ 한다. ë°ì´í„°ë² ì´ìŠ¤ 벤ë”ë“¤ì´ ë‹¤ë¥¸ 내장
- í”„ë¡œì‹œì € ì˜ë¯¸ë¡ /êµ¬ë¬¸ì„ ê°–ê³ ìžˆê¸° 때문ì—, ê·œì¹™ë“¤ì€ ê°ê°ì˜ ë°ì´í„°ë² ì´ìŠ¤ì— ë”°ë¼ ì°¨ì´ê°€ 난다.
- </para>
- <para>
- 내장 í”„ë¡œì‹œì € 질ì˜ë“¤ì€ <literal>setFirstResult()/setMaxResults()</literal>로서 쪽매김 ë 수 없다.
- </para>
+ <para>내장 í”„ë¡œì‹œì €ë“¤ì€ í˜„ìž¬ 스칼ë¼ë“¤ê³¼ 엔티티들 ë§Œì„ ë°˜í™˜í•¨ì„ ì£¼ëª©í•˜ë¼. <literal><return-join></literal>ê³¼
+ <literal><load-collection></literal>ì€ ì§€ì›ë˜ì§€ 않는다.</para>
- <para>권장ë˜ëŠ” 호출 형ì‹ì€ 표준 SQL92ì´ë‹¤: <literal>{ ? = call
+ <sect3 id="querysql-limits-storedprocedures" revision="1">
+ <title>내장 í”„ë¡œì‹œì €ë“¤ì„ ì‚¬ìš©í•˜ëŠ” 규칙들/ì œì•½ë“¤</title>
+
+ <para>Hibernateì—ì„œ 내장 í”„ë¡œì‹œì €ë“¤ì„ ì‚¬ìš©í•˜ê¸° 위해서 í”„ë¡œì‹œì €ë“¤/í•¨ìˆ˜ë“¤ì€ ë‹¤ìŒ ëª‡ëª‡ ê·œì¹™ë“¤ì„ ë”°ë¼ì•¼ 한다. ë§Œì¼ ê·¸ê²ƒë“¤ì´ ê·¸ë“¤ 규칙들ì„
+ 따르지 ì•Šì„ ê²½ìš° ê·¸ê²ƒë“¤ì€ Hibernate와 함께 사용 불가능하다. ë§Œì¼ ë‹¹ì‹ ì´ ì—¬ì „ížˆ ì´ë“¤ í”„ë¡œì‹œì €ë“¤ì„ ì‚¬ìš©í•˜ê³ ìž ì›í• 경우,
+ ë‹¹ì‹ ì€ <literal>session.connection()</literal>ì„ í†µí•´ ê·¸ê²ƒë“¤ì„ ì‹¤í–‰ì‹œì¼œì•¼ 한다. ë°ì´í„°ë² ì´ìŠ¤ 벤ë”ë“¤ì´ ë‹¤ë¥¸ 내장
+ í”„ë¡œì‹œì € ì˜ë¯¸ë¡ /êµ¬ë¬¸ì„ ê°–ê³ ìžˆê¸° 때문ì—, ê·œì¹™ë“¤ì€ ê°ê°ì˜ ë°ì´í„°ë² ì´ìŠ¤ì— ë”°ë¼ ì°¨ì´ê°€ 난다.</para>
+
+ <para>내장 í”„ë¡œì‹œì € 질ì˜ë“¤ì€ <literal>setFirstResult()/setMaxResults()</literal>로서 쪽매김 ë 수 없다.</para>
+
+ <para>권장ë˜ëŠ” 호출 형ì‹ì€ 표준 SQL92ì´ë‹¤: <literal>{ ? = call
functionName(<parameters>) }</literal> ë˜ëŠ” <literal>{ ? = call
procedureName(<parameters>}</literal>. Native 호출 êµ¬ë¬¸ì€ ì§€ì›ë˜ì§€ 않는다.</para>
- <para>
- Oracleì˜ ê²½ìš° ë‹¤ìŒ ê·œì¹™ë“¤ì´ ì ìš©ëœë‹¤:
- </para>
-
- <itemizedlist spacing="compact">
- <listitem>
- <para>í•˜ë‚˜ì˜ í•¨ìˆ˜ëŠ” í•˜ë‚˜ì˜ ê²°ê³¼ ì…‹ì„ ë°˜í™˜í•´ì•¼ 한다. í”„ë¡œì‹œì €ì˜ ì²« 번째 파ë¼ë¯¸í„°ëŠ” í•˜ë‚˜ì˜ ê²°ê³¼ ì…‹ì„ ë°˜í™˜í•˜ëŠ”
- í•˜ë‚˜ì˜ <literal>OUT</literal>ì´ì–´ì•¼ 한다. ì´ê²ƒì€ Oracle 9 ë˜ëŠ” 10ì—ì„œ í•˜ë‚˜ì˜ <literal>SYS_REFCURSOR</literal>를
- 사용하여 행해진다. Oracleì—ì„œ ë‹¹ì‹ ì´ <literal>REF CURSOR</literal> íƒ€ìž…ì„ ì •ì˜í• 필요가 있다면, Oracle ë³´ê³ ì„œë¥¼ ë³´ë¼.
- </para>
- </listitem>
- </itemizedlist>
-
- <para>
- Sybase ë˜ëŠ” MS SQL serverì˜ ê²½ìš° ë‹¤ìŒ ê·œì¹™ë“¤ì´ ì ìš©ëœë‹¤:
- </para>
-
- <itemizedlist spacing="compact">
- <listitem>
- <para>
- í”„ë¡œì‹œì €ëŠ” í•œ ê°œì˜ ê²°ê³¼ ì…‹ì„ ë°˜í™˜í•´ì•¼ 한다. ì´ë“¤ ì„œë²„ë“¤ì´ ì—¬ëŸ¬ ê°œì˜ ê²°ê³¼ì…‹ë“¤ê³¼ ì—…ë°ì´íŠ¸ ì¹´ìš´íŠ¸ë“¤ì„ ë°˜í™˜ í• ìˆ˜ 있다/í• ê²ƒì´ì´ë¯€ë¡œ,
- Hibernate는 ê²°ê³¼ë“¤ì„ ë°˜ë³µ ìˆœí™˜í• ê²ƒì´ê³ ê·¸ê²ƒì˜ ë°˜í™˜ 값으로서 í•˜ë‚˜ì˜ ê²°ê³¼ ì…‹ì¸ ì²« 번째 결과를 ì·¨í• ê²ƒì´ë‹¤. ê·¸ ë°–ì˜ ëª¨ë“ ê²ƒì€
- í기ë 것ì´ë‹¤.
- </para>
- </listitem>
- <listitem>
- <para>
- ë§Œì¼ ë‹¹ì‹ ì´ ë‹¹ì‹ ì˜ í”„ë¡œì‹œì € ë‚´ì— <literal>SET NOCOUNT ON</literal>ì„ ì´ìš© 가능하게 í• ìˆ˜ 있다면 ê·¸ê²ƒì€ ì•„ë§ˆ
- 보다 효율ì ì´ê²Œ ë 것ì´ì§€ë§Œ ì´ê²ƒì€ í•„ìš” ì¡°ê±´ì´ ì•„ë‹ˆë‹¤.
- </para>
- </listitem>
- </itemizedlist>
- </sect3>
- </sect2>
+ <para>Oracleì˜ ê²½ìš° ë‹¤ìŒ ê·œì¹™ë“¤ì´ ì ìš©ëœë‹¤:</para>
- </sect1>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>í•˜ë‚˜ì˜ í•¨ìˆ˜ëŠ” í•˜ë‚˜ì˜ ê²°ê³¼ ì…‹ì„ ë°˜í™˜í•´ì•¼ 한다. í”„ë¡œì‹œì €ì˜ ì²« 번째 파ë¼ë¯¸í„°ëŠ” í•˜ë‚˜ì˜ ê²°ê³¼ ì…‹ì„ ë°˜í™˜í•˜ëŠ”
+ í•˜ë‚˜ì˜ <literal>OUT</literal>ì´ì–´ì•¼ 한다. ì´ê²ƒì€ Oracle 9 ë˜ëŠ” 10ì—ì„œ 하나ì˜
+ <literal>SYS_REFCURSOR</literal>를 사용하여 행해진다. Oracleì—ì„œ ë‹¹ì‹ ì€
+ <literal>REF CURSOR</literal> íƒ€ìž…ì„ ì •ì˜í• 필요가 있는ë°, Oracle ë³´ê³ ì„œë¥¼ ë³´ë¼.</para>
+ </listitem>
+ </itemizedlist>
- <sect1 id="querysql-cud">
- <title>create, update ê·¸ë¦¬ê³ delete를 위한 맞춤형 SQL</title>
+ <para>Sybase ë˜ëŠ” MS SQL serverì˜ ê²½ìš° ë‹¤ìŒ ê·œì¹™ë“¤ì´ ì ìš©ëœë‹¤:</para>
- <para>
- Hibernate3는 create, update, delete 오í¼ë ˆì´ì…˜ë“¤ì„ 위한 맞춤형 ë¬¸ìž¥ë“¤ì„ ì‚¬ìš©í• ìˆ˜ 있다. Hibernateì—ì„œ í´ëž˜ìŠ¤ì™€ ì½œë ‰ì…˜
- ì˜ì†ìžë“¤ì€ 구성 ì‹œì— ìƒì„±ëœ 문ìžì—´ë“¤ì˜ 집합(insertsql, deletesql, updatesql 등)ì„ ì´ë¯¸ í¬í•¨í•˜ê³ 있다.
- <literal><sql-insert></literal>, <literal><sql-delete></literal>,
- <literal><sql-update></literal> 매핑 íƒœê·¸ë“¤ì€ ì´ë“¤ 문ìžì—´ë“¤ì„ 오버ë¼ì´ë“œ 시킨다:
- </para>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>í”„ë¡œì‹œì €ëŠ” í•œ ê°œì˜ ê²°ê³¼ ì…‹ì„ ë°˜í™˜í•´ì•¼ 한다. ì´ë“¤ ì„œë²„ë“¤ì´ ì—¬ëŸ¬ ê°œì˜ ê²°ê³¼ì…‹ë“¤ê³¼ ì—…ë°ì´íŠ¸ ì¹´ìš´íŠ¸ë“¤ì„ ë°˜í™˜ í• ìˆ˜ 있다/í• ê²ƒì´ì´ë¯€ë¡œ,
+ Hibernate는 ê²°ê³¼ë“¤ì„ ë°˜ë³µ ìˆœí™˜í• ê²ƒì´ê³ ê·¸ê²ƒì˜ ë°˜í™˜ 값으로서 í•˜ë‚˜ì˜ ê²°ê³¼ ì…‹ì¸ ì²« 번째 결과를 ì·¨í• ê²ƒì´ë‹¤. ê·¸ ë°–ì˜ ëª¨ë“ ê²ƒì€
+ í기ë 것ì´ë‹¤.</para>
+ </listitem>
+ <listitem>
+ <para>ë§Œì¼ ë‹¹ì‹ ì´ ë‹¹ì‹ ì˜ í”„ë¡œì‹œì € ë‚´ì— <literal>SET NOCOUNT ON</literal>ì„ ì´ìš© 가능하게 í• ìˆ˜ 있다면 ê·¸ê²ƒì€ ì•„ë§ˆ
+ 보다 효율ì ì´ê²Œ ë 것ì´ì§€ë§Œ ì´ê²ƒì€ í•„ìš” ì¡°ê±´ì´ ì•„ë‹ˆë‹¤.</para>
+ </listitem>
+ </itemizedlist>
+ </sect3>
+ </sect2>
+ </sect1>
- <programlisting><![CDATA[<class name="Person">
+ <sect1 id="querysql-cud">
+ <title>create, update ê·¸ë¦¬ê³ delete를 위한 맞춤형 SQL</title>
+
+ <para>Hibernate3는 create, update, delete 오í¼ë ˆì´ì…˜ë“¤ì„ 위한 맞춤형 ë¬¸ìž¥ë“¤ì„ ì‚¬ìš©í• ìˆ˜ 있다. Hibernateì—ì„œ í´ëž˜ìŠ¤ì™€ ì½œë ‰ì…˜
+ ì˜ì†ìžë“¤ì€ 구성 ì‹œì— ìƒì„±ëœ 문ìžì—´ë“¤ì˜ 집합(insertsql, deletesql, updatesql 등)ì„ ì´ë¯¸ í¬í•¨í•˜ê³ 있다.
+ <literal><sql-insert></literal>, <literal><sql-delete></literal>,
+ <literal><sql-update></literal> 매핑 íƒœê·¸ë“¤ì€ ì´ë“¤ 문ìžì—´ë“¤ì„ 오버ë¼ì´ë“œ 시킨다:</para>
+
+ <programlisting><![CDATA[<class name="Person">
<id name="id">
<generator class="increment"/>
</id>
@@ -464,14 +596,10 @@
<sql-delete>DELETE FROM PERSON WHERE ID=?</sql-delete>
</class>]]></programlisting>
- <para>
- SQLì´ ë‹¹ì‹ ì˜ ë°ì´í„°ë² ì´ìŠ¤ ë‚´ì—ì„œ ì§ì ‘ 실행ë˜ì–´ì„œ, ë‹¹ì‹ ì´ ì¢‹ì•„í•˜ëŠ” ìž„ì˜ì˜ dialect를 사용하는 ê²ƒì´ ìžìœ ë¡ë‹¤. ë§Œì¼ ë‹¹ì‹ ì´ ë°ì´í„°ë² ì´ìŠ¤
- ì§€ì •ì ì¸ SQLì„ ì‚¬ìš©í• ê²½ìš° ì´ê²ƒì€ ë¬¼ë¡ ë‹¹ì‹ ì˜ ë§¤í•‘ì˜ ì´ì‹ì„±ì„ ê°ì†Œì‹œí‚¬ 것ì´ë‹¤.
- </para>
+ <para>SQLì´ ë‹¹ì‹ ì˜ ë°ì´í„°ë² ì´ìŠ¤ ë‚´ì—ì„œ ì§ì ‘ 실행ë˜ì–´ì„œ, ë‹¹ì‹ ì´ ì¢‹ì•„í•˜ëŠ” ìž„ì˜ì˜ dialect를 사용하는 ê²ƒì´ ìžìœ ë¡ë‹¤. ë§Œì¼ ë‹¹ì‹ ì´ ë°ì´í„°ë² ì´ìŠ¤
+ ì§€ì •ì ì¸ SQLì„ ì‚¬ìš©í• ê²½ìš° ì´ê²ƒì€ ë¬¼ë¡ ë‹¹ì‹ ì˜ ë§¤í•‘ì˜ ì´ì‹ì„±ì„ ê°ì†Œì‹œí‚¬ 것ì´ë‹¤.</para>
- <para>
- ë§Œì¼ <literal>callable</literal> ì†ì„±ì´ ì„¤ì •ë˜ë©´ 내장 í”„ë¡œì‹œì €ë“¤ì´ ì§€ì›ëœë‹¤:
- </para>
+ <para>ë§Œì¼ <literal>callable</literal> ì†ì„±ì´ ì„¤ì •ë˜ë©´ 내장 í”„ë¡œì‹œì €ë“¤ì´ ì§€ì›ëœë‹¤:</para>
<programlisting><![CDATA[<class name="Person">
<id name="id">
@@ -483,24 +611,19 @@
<sql-update callable="true">{? = call updatePerson (?, ?)}</sql-update>
</class>]]></programlisting>
- <para>
- 위치 파ë¼ë¯¸í„°ë“¤ì€ Hibernateê°€ ê·¸ê²ƒë“¤ì„ ê¸°ëŒ€í•˜ëŠ” 것과 ê°™ì€ ìˆœì„œê°€ ë˜ì–´ì•¼ 하므로, 위치 파ë¼ë¯¸í„°ë“¤ì˜ 순서는 현재 ì ˆëŒ€ì 으로 중요하다.
- </para>
-
- <para>
- ë‹¹ì‹ ì€ <literal>org.hiberate.persister.entity</literal> ë ˆë²¨ë¡œ 디버그 ë¡œê¹…ì„ ì‚¬ìš© 가능하게 í•¨ìœ¼ë¡œì¨ ì˜ˆìƒëœ 순서를 ë³¼ 수
- 있다. ì´ ë ˆë²¨ì„ ì´ìš© 가능하게 하면 Hibernate는 ì—”í‹°í‹°ë“¤ì„ ìƒì„±ì‹œí‚¤ê³ , ì—…ë°ì´íŠ¸í•˜ê³ , ì‚ì œí•˜ëŠ”ë° ì‚¬ìš©ë˜ëŠ” ì •ì ì¸ SQLì„ ì¶œë ¥í• ê²ƒì´ë‹¤.
- (예ìƒë˜ëŠ” 결과를 ë³´ë ¤ë©´, Hibernate ìƒì„±ëœ ì •ì ì¸ sqlì„ ì˜¤ë²„ë¼ì´ë“œ 시키게 매핑 파ì¼ë“¤ ì†ì— ë‹¹ì‹ ì˜ ë§žì¶¤í˜• SQLì„ í¬í•¨ì‹œí‚¤ì§€ ì•Šë„ë¡ ì—¼ë‘ì—
- ë‘ë¼.)
- </para>
+ <para>위치 파ë¼ë¯¸í„°ë“¤ì€ Hibernateê°€ ê·¸ê²ƒë“¤ì„ ê¸°ëŒ€í•˜ëŠ” 것과 ê°™ì€ ìˆœì„œê°€ ë˜ì–´ì•¼ 하므로,
+ 위치 파ë¼ë¯¸í„°ë“¤ì˜ 순서는 현재 ì ˆëŒ€ì 으로 중요하다.</para>
- <para>
- Hibernateê°€ ë¬¸ìž¥ì˜ ì„±ê³µì„ ìœ„í•´ 몇몇 실행 ì‹œ ì²´í¬ë“¤ì„ 행하므로, 내장 í”„ë¡œì‹œì €ë“¤ì€ ëŒ€ë¶€ë¶„ì˜ ê²½ìš°ë“¤(ì½ê¸°:다른 경우들 보다 ê·¸ê²ƒì„ ë” ìž˜
- 행한다)ì—ì„œ insertë˜ê³ /ì—…ë°ì´íŠ¸ë˜ê³ /ì‚ì œëœ í–‰ë“¤ì˜ ê°œìˆ˜ë¥¼ ë°˜í™˜í•˜ëŠ”ë° í•„ìš”í•˜ë‹¤. Hibernate는 í•ìƒ CUD 오í¼ë ˆì´ì…˜ë“¤ì— 대한 숫ìž
- ì¶œë ¥ 파ë¼ë¯¸í„°ë¡œì„œ 첫 번째 문장 파ë¼ë¯¸í„°ë¥¼ 등ë¡ì‹œí‚¨ë‹¤:
- </para>
+ <para>ë‹¹ì‹ ì€ <literal>org.hiberate.persister.entity</literal> ë ˆë²¨ë¡œ 디버그 ë¡œê¹…ì„ ì‚¬ìš© 가능하게 í•¨ìœ¼ë¡œì¨ ì˜ˆìƒëœ 순서를 ë³¼ 수
+ 있다. ì´ ë ˆë²¨ì„ ì´ìš© 가능하게 하면 Hibernate는 ì—”í‹°í‹°ë“¤ì„ ìƒì„±ì‹œí‚¤ê³ , ì—…ë°ì´íŠ¸í•˜ê³ , ì‚ì œí•˜ëŠ”ë° ì‚¬ìš©ë˜ëŠ” ì •ì ì¸ SQLì„ ì¶œë ¥í• ê²ƒì´ë‹¤.
+ (예ìƒë˜ëŠ” 결과를 ë³´ë ¤ë©´, Hibernate ìƒì„±ëœ ì •ì ì¸ sqlì„ ì˜¤ë²„ë¼ì´ë“œ 시키게 매핑 파ì¼ë“¤ ì†ì— ë‹¹ì‹ ì˜ ë§žì¶¤í˜• SQLì„ í¬í•¨ì‹œí‚¤ì§€ ì•Šë„ë¡ ì—¼ë‘ì—
+ ë‘ë¼.)</para>
- <programlisting><![CDATA[CREATE OR REPLACE FUNCTION updatePerson (uid IN NUMBER, uname IN VARCHAR2)
+ <para>Hibernateê°€ ë¬¸ìž¥ì˜ ì„±ê³µì„ ìœ„í•´ 몇몇 실행 ì‹œ ì²´í¬ë“¤ì„ 행하므로, 내장 í”„ë¡œì‹œì €ë“¤ì€ ëŒ€ë¶€ë¶„ì˜ ê²½ìš°ë“¤(ì½ê¸°:다른 경우들 보다 ê·¸ê²ƒì„ ë” ìž˜
+ 행한다)ì—ì„œ insertë˜ê³ /ì—…ë°ì´íŠ¸ë˜ê³ /ì‚ì œëœ í–‰ë“¤ì˜ ê°œìˆ˜ë¥¼ ë°˜í™˜í•˜ëŠ”ë° í•„ìš”í•˜ë‹¤. Hibernate는 í•ìƒ CUD 오í¼ë ˆì´ì…˜ë“¤ì— 대한 숫ìž
+ ì¶œë ¥ 파ë¼ë¯¸í„°ë¡œì„œ 첫 번째 문장 파ë¼ë¯¸í„°ë¥¼ 등ë¡ì‹œí‚¨ë‹¤:</para>
+
+ <programlisting><![CDATA[CREATE OR REPLACE FUNCTION updatePerson (uid IN NUMBER, uname IN VARCHAR2)
RETURN NUMBER IS
BEGIN
@@ -513,18 +636,14 @@
return SQL%ROWCOUNT;
END updatePerson;]]></programlisting>
+ </sect1>
-
- </sect1>
+ <sect1 id="querysql-load">
+ <title>ë¡œë”©ì„ ìœ„í•œ 맞춤형 SQL</title>
- <sect1 id="querysql-load">
- <title>ë¡œë”©ì„ ìœ„í•œ 맞춤형 SQL</title>
+ <para>ë‹¹ì‹ ì€ ë˜í•œ 엔티티 ë¡œë”©ì„ ìœ„í•œ ë‹¹ì‹ ìžì‹ ì˜ SQL (ë˜ëŠ” HQL)ì„ ì„ ì–¸í• ìˆ˜ë„ ìžˆë‹¤:</para>
- <para>
- ë‹¹ì‹ ì€ ë˜í•œ 엔티티 ë¡œë”©ì„ ìœ„í•œ ë‹¹ì‹ ìžì‹ ì˜ SQL (ë˜ëŠ” HQL)ì„ ì„ ì–¸í• ìˆ˜ë„ ìžˆë‹¤:
- </para>
-
- <programlisting><![CDATA[<sql-query name="person">
+ <programlisting><![CDATA[<sql-query name="person">
<return alias="pers" class="Person" lock-mode="upgrade"/>
SELECT NAME AS {pers.name}, ID AS {pers.id}
FROM PERSON
@@ -532,11 +651,9 @@
FOR UPDATE
</sql-query>]]></programlisting>
- <para>
- ì´ê²ƒì€ ì•žì„œ ë…¼ì˜í–ˆë“¯ì´ 단지 ëª…ëª…ëœ ì§ˆì˜ ì„ ì–¸ì´ë‹¤. ë‹¹ì‹ ì€ class 매핑 ì†ì— ì´ ëª…ëª…ëœ ì§ˆì˜ë¥¼ ì°¸ì¡°í• ìˆ˜ 있다:
- </para>
+ <para>ì´ê²ƒì€ ì•žì„œ ë…¼ì˜í–ˆë“¯ì´ 단지 ëª…ëª…ëœ ì§ˆì˜ ì„ ì–¸ì´ë‹¤. ë‹¹ì‹ ì€ class 매핑 ì†ì— ì´ ëª…ëª…ëœ ì§ˆì˜ë¥¼ ì°¸ì¡°í• ìˆ˜ 있다:</para>
- <programlisting><![CDATA[<class name="Person">
+ <programlisting><![CDATA[<class name="Person">
<id name="id">
<generator class="increment"/>
</id>
@@ -544,20 +661,16 @@
<loader query-ref="person"/>
</class>]]></programlisting>
- <para>
- ì´ê²ƒì€ 심지어 내장 í”„ë¡œì‹œì €ë“¤ì— ë™ìž‘한다.
- </para>
+ <para>ì´ê²ƒì€ 심지어 내장 í”„ë¡œì‹œì €ë“¤ì— ë™ìž‘한다.</para>
- <para>
- ë‹¹ì‹ ì€ ì½œë ‰ì…˜ ë¡œë”©ì„ ìœ„í•œ í•œ ê°œì˜ ì§ˆì˜ë¥¼ ì •ì˜í• ìˆ˜ë„ ìžˆë‹¤:
- </para>
+ <para>ë‹¹ì‹ ì€ ì½œë ‰ì…˜ ë¡œë”©ì„ ìœ„í•œ í•œ ê°œì˜ ì§ˆì˜ë¥¼ ì •ì˜í• ìˆ˜ë„ ìžˆë‹¤:</para>
<programlisting><![CDATA[<set name="employments" inverse="true">
<key/>
<one-to-many class="Employment"/>
<loader query-ref="employments"/>
</set>]]></programlisting>
-
+
<programlisting><![CDATA[<sql-query name="employments">
<load-collection alias="emp" role="Person.employments"/>
SELECT {emp.*}
@@ -566,9 +679,7 @@
ORDER BY STARTDATE ASC, EMPLOYEE ASC
</sql-query>]]></programlisting>
- <para>
- ë‹¹ì‹ ì€ ì‹¬ì§€ì–´ ì¡°ì¸ íŽ˜ì¹ì— ì˜í•´ í•˜ë‚˜ì˜ ì½œë ‰ì…˜ì„ ë¡œë“œì‹œí‚¤ëŠ” í•˜ë‚˜ì˜ ì—”í‹°í‹°ë¥¼ ì •ì˜í• 수 있다:
- </para>
+ <para>ë‹¹ì‹ ì€ ì‹¬ì§€ì–´ ì¡°ì¸ íŽ˜ì¹ì— ì˜í•´ í•˜ë‚˜ì˜ ì½œë ‰ì…˜ì„ ë¡œë“œì‹œí‚¤ëŠ” í•˜ë‚˜ì˜ ì—”í‹°í‹°ë¥¼ ì •ì˜í• 수 있다:</para>
<programlisting><![CDATA[<sql-query name="person">
<return alias="pers" class="Person"/>
@@ -579,7 +690,5 @@
ON pers.ID = emp.PERSON_ID
WHERE ID=?
</sql-query>]]></programlisting>
-
- </sect1>
-
+ </sect1>
</chapter>
\ No newline at end of file
Modified: branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/session_api.xml
===================================================================
--- branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/session_api.xml 2006-12-08 08:01:55 UTC (rev 10955)
+++ branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/session_api.xml 2006-12-08 08:07:27 UTC (rev 10956)
@@ -413,7 +413,7 @@
</sect3>
- <sect3 id="objectstate-querying-executing-named">
+ <sect3 id="objectstate-querying-executing-named" revision="1">
<title>ëª…ëª…ëœ ì§ˆì˜ë“¤ì„ 구체화 시키기</title>
<para>
@@ -421,7 +421,7 @@
í¬í•¨í• ê²½ìš°ì— <literal>CDATA</literal> ì„¹ì…˜ì„ ì‚¬ìš©í•˜ëŠ” ê²ƒì„ ê¸°ì–µí•˜ë¼))
</para>
- <programlisting><![CDATA[<query name="eg.DomesticCat.by.name.and.minimum.weight"><![CDATA[
+ <programlisting><![CDATA[<query name="ByNameAndMaximumWeight"><![CDATA[
from eg.DomesticCat as cat
where cat.name = ?
and cat.weight > ?
@@ -431,7 +431,7 @@
파ë¼ë¯¸í„° ë°”ì¸ë”©ê³¼ ì‹¤í–‰ì€ í”„ë¡œê·¸ëž¨ ìƒìœ¼ë¡œ 행해진다:
</para>
- <programlisting><![CDATA[Query q = sess.getNamedQuery("eg.DomesticCat.by.name.and.minimum.weight");
+ <programlisting><![CDATA[Query q = sess.getNamedQuery("ByNameAndMaximumWeight");
q.setString(0, name);
q.setInt(1, minWeight);
List cats = q.list();]]></programlisting>
@@ -440,6 +440,13 @@
ì‹¤ì œ 프로그램 코드는 사용ë˜ëŠ” ì§ˆì˜ ì–¸ì–´ì— ë…립ì ì´ê³ , ë‹¹ì‹ ì€ ë˜í•œ 메타ë°ì´í„°ë¡œ native SQL 질ì˜ë“¤ì„ ì •ì˜í• ìˆ˜ë„ ìžˆê±°ë‚˜
ê·¸ê²ƒë“¤ì„ ë§¤í•‘ 파ì¼ë“¤ ì†ì— 기존 질ì˜ë“¤ì„ ìœ„ì¹˜ì§€ì›€ìœ¼ë¡œì¨ ê¸°ì¡´ 질ì˜ë“¤ì„ Hibernateë¡œ ì´ì „시킬 ìˆ˜ë„ ìžˆìŒì„ 노트하ë¼.
</para>
+
+ <para>
+ ë˜í•œ <literal><hibernate-mapping></literal> 요소 ë‚´ì—ì„œ í•˜ë‚˜ì˜ ì§ˆì˜ ì„ ì–¸ì€ ê·¸ 질ì˜ì— 대한
+ ì „ì— ìœ ì¼ ì´ë¦„ì„ í•„ìš”ë¡œ í•˜ê³ , ë°˜ë©´ì— <literal><class></literal> 요소 ë‚´ì—ì„œì˜ ì§ˆì˜ ì„ ì–¸ì€
+ í´ëž˜ìŠ¤ ì´ë¦„으로 수ì§ëœì´ë¦„ì„ ì²¨ê°€í•˜ì—¬ ìžë™ì 으로 ìœ ì¼í•˜ê²Œ 만들어진다.
+ 예를 들어 <literal>eg.Cat.ByNameAndMaximumWeight</literal>.
+ </para>
</sect3>
Modified: branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/transactions.xml
===================================================================
--- branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/transactions.xml 2006-12-08 08:01:55 UTC (rev 10955)
+++ branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/transactions.xml 2006-12-08 08:07:27 UTC (rev 10956)
@@ -317,10 +317,7 @@
않다.
</para>
- <para>
- However, it is often desirable to keep your persistence layer portable between non-managed
- resource-local environments, and systems that can rely on JTA but use BMT instead of CMT.
- In both cases you'd use programmatic transaction demaracation.
+ <para>
하지만, CMT ëŒ€ì‹ BMT를 사용하는 JTAì— ì˜ì¡´í• 수 있는 시스템들, ê·¸ë¦¬ê³ ê´€ë¦¬ë˜ì§€ 않는 resource-local 환경들 사ì´ì—ì„œ
ë‹¹ì‹ ì˜ ì˜ì† ê³„ì¸µì— ì´ì‹ì„±ì„ ìœ ì§€ì‹œí‚¤ëŠ” ê²ƒì´ ìžì£¼ í¬ë§ëœë‹¤. ë‘ ê²½ìš°ë“¤ì—ì„œ ë‹¹ì‹ ì€ í”„ë¡œê·¸ëž¨ ìƒì˜ 트랜ìžì…˜ ê²½ê³„ì„¤ì •ì„ ì‚¬ìš©í• ê²ƒì´ë‹¤.
Hibernate는 ë‹¹ì‹ ì˜ ë°°ì¹˜ í™˜ê²½ì˜ ê³ ìœ í•œ 트랜ìžì…˜ 시스템 ì†ìœ¼ë¡œ 변환ë˜ëŠ” <literal>Transaction</literal>ì´ë¼ 명명ë˜ëŠ”
@@ -488,7 +485,7 @@
tx.rollback();
throw e; // or display error message
}]]></programlisting>
-
+
<para>
CMTì˜ ê²½ìš°, 트랜ìžì…˜ ê´€í• [경계 ì„¤ì •]ì€ í”„ë¡œê·¸ëž¨ ìƒì´ ì•„ë‹Œ, session bean 배치 디스í¬ë¦½í„°ë“¤ ì†ì—ì„œ 행해진다.
그러므로 코드는 다ìŒìœ¼ë¡œ ê°ì†Œëœë‹¤:
@@ -621,7 +618,7 @@
sess.getTransaction().commit()
}
catch (RuntimeException e) {
- sess.getTransaction().rollback();
+ sess.getTransaction().rollback();
throw e; // or display error message
}
finally {
@@ -716,7 +713,6 @@
session.flush(); // Only for last transaction in conversation
t.commit(); // Also return JDBC connection
session.close(); // Only for last transaction in conversation]]></programlisting>
-
<para>
<literal>foo</literal> ê°ì²´ëŠ” ê·¸ê²ƒì´ ë¡œë“œë˜ì—ˆë˜ <literal>Session</literal>ì´ ì–´ëŠ ê²ƒì¸ì§€ë¥¼ ì—¬ì „ížˆ ì•Œê³ ìžˆë‹¤.
ì´ì „ 세션 ìƒì—ì„œ í•˜ë‚˜ì˜ ìƒˆë¡œìš´ ë°ì´í„°ë² ì´ìŠ¤ 트랜ìžì…˜ì„ 시작하는 ê²ƒì€ í•˜ë‚˜ì˜ ìƒˆë¡œìš´ ì»¤ë„¥ì…˜ì„ íšë“í•˜ê³ ê·¸ ì„¸ì…˜ì„ ì†Œë¹„í•œë‹¤.
Modified: branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/tutorial.xml
===================================================================
--- branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/tutorial.xml 2006-12-08 08:01:55 UTC (rev 10955)
+++ branches/Branch_3_2/Hibernate3/doc/reference/ko/modules/tutorial.xml 2006-12-08 08:07:27 UTC (rev 10956)
@@ -1,20 +1,25 @@
<chapter id="tutorial">
<title>Hibernate 개요</title>
- <sect1 id="tutorial-intro">
+ <sect1 id="tutorial-intro" revision="1">
<title>머리ë§</title>
<para>
ì´ ìž¥ì€ Hibernate 초심ìžë¥¼ 위한 ê°œë¡ ì ì¸ íŠœí† ë¦¬ì–¼ì´ë‹¤. 우리는 메모리-ë‚´ ë°ì´í„°ë² ì´ìŠ¤ë¥¼
사용하는 간단한 ëª…ë ¹ ë¼ì¸ 어플리케ì´ì…˜ìœ¼ë¡œ ì‹œìž‘í•˜ê³ ë‹¨ê³„ë“¤ì„ ì´í•´í•˜ë„ë¡ ì‰½ê²Œ ê·¸ê²ƒì„ ê°œë°œí•œë‹¤.
-
</para>
<para>
ì´ íŠœí† ë¦¬ì–¼ì€ Hibernate ì‹ ê·œ 사용ìžë“¤ì„ ì˜ë„í•˜ê³ ìžˆì§€ë§Œ Java와 SQL 지ì‹ì„ 필요로 한다.
- ê·¸ê²ƒì€ Michael Gloeglì´ ìž‘ì„±í•œ íŠœí† ë¦¬ì–¼ì— ê¸°ì´ˆí•œë‹¤.
+ ê·¸ê²ƒì€ Michael Gloeglì´ ìž‘ì„±í•œ íŠœí† ë¦¬ì–¼ì— ê¸°ì´ˆí•˜ë©°, 우리가 명명하는 ì œ 3ì˜ ë¼ì´ë¸ŒëŸ¬ë¦¬ë“¤ì€
+ JDK 1.4와 5.0 ë²„ì „ìš©ì´ë‹¤. ë‹¹ì‹ ì€ JDK1.3ì— ëŒ€í•´ 다른 ë¼ì´ë¸ŒëŸ¬ë¦¬ë“¤ì„ 필요로 í• ìˆ˜ë„ ìžˆë‹¤.
</para>
+ <para>
+ íŠœí† ë¦¬ì–¼ìš© 소스는 <literal>doc/reference/tutorial/</literal> ë””ë ‰í† ë¦¬ ë‚´ì— ìžˆëŠ”
+ ë°°í¬ë³¸ ë‚´ì— í¬í•¨ë˜ì–´ 있다.
+ </para>
+
</sect1>
<sect1 id="tutorial-firstapp" revision="2">
@@ -62,22 +67,24 @@
다ìŒìœ¼ë¡œ 우리는 우리가 ë°ì´í„°ë² ì´ìŠ¤ ì†ì— ì €ìž¥ì‹œí‚¤ê³ ìž ì›í•˜ëŠ” ì´ë²¤íŠ¸ë¥¼ 표현하는 í•œ ê°œì˜ í´ëž˜ìŠ¤ë¥¼ ìƒì„±ì‹œí‚¨ë‹¤.
</para>
- <sect2 id="tutorial-firstapp-firstclass">
+ <sect2 id="tutorial-firstapp-firstclass" revision="1">
<title>첫 번째 í´ëž˜ìŠ¤</title>
<para>
ìš°ë¦¬ì˜ ì²« 번째 ì˜ì† í´ëž˜ìŠ¤ëŠ” 몇몇 프로í¼í‹°ë“¤ì„ 가진 간단한 ìžë°”빈즈 í´ëž˜ìŠ¤ì´ë‹¤:
</para>
- <programlisting><![CDATA[import java.util.Date;
+ <programlisting><![CDATA[package events;
+import java.util.Date;
+
public class Event {
private Long id;
private String title;
private Date date;
- Event() {}
+ public Event() {}
public Long getId() {
return id;
@@ -107,18 +114,19 @@
<para>
ë‹¹ì‹ ì€ ì´ í´ëž˜ìŠ¤ê°€ 프로í¼í‹° getter와 setter ë©”ì†Œë“œë“¤ì— ëŒ€í•œ 표준 ìžë°”빈즈 명명법들 ë¿ë§Œ ì•„ë‹ˆë¼ í•„ë“œë“¤ì— ëŒ€í•œ
private ê°€ì‹œì„±ì„ ì‚¬ìš©í•˜ê³ ìžˆìŒì„ ì•Œ 수 있다. ì´ê²ƒì€ 권장ë˜ëŠ” 설계ì´ì§€ë§Œ, 필수ì ì´ì§€ëŠ” 않다. Hibernate는
- ë˜í•œ í•„ë“œë“¤ì— ì§ì ‘ ì ‘ê·¼í• ìˆ˜ 있으며, accessor ë©”ì†Œë“œë“¤ì˜ ì´ì ì€ ê°•ê±´í•œ ë¦¬íŒ©í† ë§ì´ë‹¤.
+ ë˜í•œ í•„ë“œë“¤ì— ì§ì ‘ ì ‘ê·¼í• ìˆ˜ 있으며, accessor ë©”ì†Œë“œë“¤ì˜ ì´ì ì€ ê°•ê±´í•œ ë¦¬íŒ©í† ë§ì´ë‹¤. 아규먼트 없는 ìƒì„±ìžëŠ”
+ reflectionì„ í†µí•´ ì´ í´ëž˜ìŠ¤ì˜ ê°ì²´ë¥¼ 초기화 시킬 필요가 있다.
</para>
<para>
- <literal>id</literal> 프로í¼í‹°ëŠ” 특별한 ì´ë²¤íŠ¸ë¥¼ 위한 ìœ ì¼ ì‹ë³„ìžë¥¼ ì†Œìœ í•œë‹¤. ë§Œì¼ ìš°ë¦¬ê°€ Hibernateì˜
- ì „ì²´ íŠ¹ì§•ì„ ì‚¬ìš©í•˜ê³ ìž ì›í• 경우 ëª¨ë“ ì˜ì† 엔티티 í´ëž˜ìŠ¤ë“¤(보다 ëœ ì¤‘ìš”í•œ ì¢…ì† í´ëž˜ìŠ¤ë“¤ ë˜í•œ 존재한다)ì€ ê·¸ëŸ°
- ì‹ë³„ìž í”„ë¡œí¼í‹°ë¥¼ 필요로 í• ê²ƒì´ë‹¤. 사실 ëŒ€ë¶€ë¶„ì˜ ì–´í”Œë¦¬ì¼€ì´ì…˜ë“¤(특히 웹 어플리케ì´ì…˜ë“¤)ì€ ì‹ë³„ìžì— ì˜í•´
- ê°ì²´ë“¤ì„ êµ¬ë¶„ì§€ì„ í•„ìš”ê°€ 있어서, ë‹¹ì‹ ì€ ì´ê²ƒì„ ì–´ë–¤ ì œí•œì´ë¼ê¸° 보다는 í•˜ë‚˜ì˜ íŠ¹ì§•ìœ¼ë¡œ ê°„ì£¼í• ê²ƒì´ë‹¤. 하지만
- 우리는 대개 ê°ì²´ì˜ í•ë“±(identity)를 처리하지 않으므로, setter 메소드는 privateì´ì–´ì•¼ 한다. ê°ì²´ê°€ ì €ìž¥ë ë•Œ,
- Hibernate는 단지 ì‹ë³„ìžë¥¼ í• ë‹¹í• ê²ƒì´ë‹¤. ë‹¹ì‹ ì€ Hibernateê°€ public, private, protected ì ‘ê·¼ìž ë©”ì†Œë“œë“¤
- ë¿ë§Œ ì•„ë‹ˆë¼ (public, private, protected) 필드들ì—ë„ ì§ì ‘ ì ‘ê·¼í• ìˆ˜ 있ìŒì„ ì•Œ 수 있다. ì„ íƒì€ ë‹¹ì‹ ì—게 ë‹¬ë ¤
- 있으며, ë‹¹ì‹ ì€ ë‹¹ì‹ ì˜ ì–´í”Œë¦¬ì¼€ì´ì…˜ ì„¤ê³„ì— ì 합하ë„ë¡ ê·¸ê²ƒì„ ë¶€í•©ì‹œí‚¬ 수 있다.
+ <literal>id</literal> 프로í¼í‹°ëŠ” 특별한 ì´ë²¤íŠ¸ë¥¼ 위한 ìœ ì¼ ì‹ë³„ìžë¥¼ ì†Œìœ í•œë‹¤. ëª¨ë“ ì˜ì† 엔티티 í´ëž˜ìŠ¤ë“¤
+ (보다 ëœ ì¤‘ìš”í•œ ì¢…ì† í´ëž˜ìŠ¤ë“¤ë„ 존재한다)ì€ ìš°ë¦¬ê°€ Hibernateì˜ ì „ì²´ 특징 ì§‘í•©ì„ ì‚¬ìš©í•˜ê³ ìž ì›í• 경우ì—
+ 그런 ì‹ë³„ìž í”„ë¡œí¼í‹°ë¥¼ 필요로 í• ê²ƒì´ë‹¤. 사실 ëŒ€ë¶€ë¶„ì˜ ì–´í”Œë¦¬ì¼€ì´ì…˜ë“¤(특히 웹 어플리케ì´ì…˜ë“¤)ì€ ì‹ë³„ìžì— ì˜í•´
+ ê°ì²´ë“¤ì„ êµ¬ë¶„ì§€ì„ í•„ìš”ê°€ 있어서, ë‹¹ì‹ ì€ ì´ê²ƒì„ ì–´ë–¤ ì œì•½ì ì´ë¼ê¸° 보다는 í•˜ë‚˜ì˜ íŠ¹ì§•ìœ¼ë¡œ ê°„ì£¼í• ê²ƒì´ë‹¤. 하지만
+ 우리는 대개 ê°ì²´ì˜ í•ë“±(identity)를 처리하지 않으므로, setter 메소드는 privateì´ì–´ì•¼ 한다. ê°ì²´ê°€ ì €ìž¥ë ë•Œ,
+ Hibernate는 단지 ì‹ë³„ìžë“¤ì„ í• ë‹¹í• ê²ƒì´ë‹¤. ë‹¹ì‹ ì€ Hibernateê°€ public, private, protected ì ‘ê·¼ìž ë©”ì†Œë“œë“¤
+ ë¿ë§Œ ì•„ë‹ˆë¼ (public, private, protected) 필드들ì—ë„ ì§ì ‘ ì ‘ê·¼í• ìˆ˜ 있ìŒì„ ì•Œ 수 있다. ì„ íƒì€ ë‹¹ì‹ ì—게 ë‹¬ë ¤
+ 있으며, ë‹¹ì‹ ì€ ë‹¹ì‹ ì˜ ì–´í”Œë¦¬ì¼€ì´ì…˜ ì„¤ê³„ì— ì 합하ë„ë¡ ê·¸ê²ƒì„ ë¶€í•©ì‹œí‚¬ 수 있다.
</para>
<para>
@@ -128,7 +136,7 @@
</para>
<para>
- ì´ Java 노스 파ì¼ì„ 개발 í´ë” ë‚´ì˜ <literal>src</literal>ë¡œ ëª…ëª…ëœ ë””ë ‰í† ë¦¬ ì†ì— 있는 위치지워ë¼. ì´ì œ
+ ì´ Java 소스 파ì¼ì„ 개발 í´ë” ë‚´ì˜ <literal>src</literal>ë¡œ ëª…ëª…ëœ ë””ë ‰í† ë¦¬ ì†ì— 있는 위치지워ë¼. ì´ì œ
ê·¸ ë””ë ‰í† ë¦¬ëŠ” 다ìŒê³¼ ê°™ì„ ê²ƒì´ë‹¤:
</para>
@@ -136,7 +144,8 @@
+lib
<Hibernate and third-party libraries>
+src
- Event.java]]></programlisting>
+ +events
+ Event.java]]></programlisting>
<para>
ë‹¤ìŒ ë‹¨ê³„ì—ì„œ, 우리는 Hiberanteì—게 ì´ ì˜ì† í´ëž˜ìŠ¤ì— 대해 ì•Œë ¤ 준다.
@@ -144,8 +153,8 @@
</sect2>
- <sect2 id="tutorial-firstapp-mapping">
- <title>매핑 파ì¼</title>
+ <sect2 id="tutorial-firstapp-mapping" revision="1">
+ <title>The mapping file</title>
<para>
Hibernate는 ì˜ì† í¬ëž˜ìŠ¤ë“¤ì— 대한 ê°ì²´ë“¤ì„ ë¡œë“œì‹œí‚¤ê³ ì €ìž¥ì‹œí‚¤ëŠ” ë°©ë²•ì„ ì•Œ 필요가 있다.
@@ -189,7 +198,7 @@
<programlisting><![CDATA[<hibernate-mapping>
- <class name="Event" table="EVENTS">
+ <class name="events.Event" table="EVENTS">
</class>
@@ -204,9 +213,9 @@
<programlisting><![CDATA[<hibernate-mapping>
- <class name="Event" table="EVENTS">
+ <class name="events.Event" table="EVENTS">
<id name="id" column="EVENT_ID">
- <generator class="increment"/>
+ <generator class="native"/>
</id>
</class>
@@ -230,9 +239,9 @@
<programlisting><![CDATA[
<hibernate-mapping>
- <class name="Event" table="EVENTS">
+ <class name="events.Event" table="EVENTS">
<id name="id" column="EVENT_ID">
- <generator class="increment"/>
+ <generator class="native"/>
</id>
<property name="date" type="timestamp" column="EVENT_DATE"/>
<property name="title"/>
@@ -242,7 +251,9 @@
<para>
<literal>id</literal> ìš”ì†Œì˜ ê²½ìš°ì²˜ëŸ¼, <literal>property</literal> ìš”ì†Œì˜ <literal>name</literal>
- ì†ì„±ì€ ì‚¬ìš©í• getter ë° setter ë©”ì†Œë“œë“¤ì´ ì–´ëŠ ê²ƒì¸ì§€ë¥¼ Hibernateì—게 ì•Œë ¤ì¤€ë‹¤.
+ ì†ì„±ì€ ì‚¬ìš©í• getter ë° setter ë©”ì†Œë“œë“¤ì´ ì–´ëŠ ê²ƒì¸ì§€ë¥¼ Hibernateì—게 ì•Œë ¤ì¤€ë‹¤. ë”°ë¼ì„œ ì´ ê²½ìš°ì— Hibernate는
+ <literal>getDate()/setDate()</literal> ë¿ë§Œ ì•„ë‹ˆë¼ <literal>getTitle()/setTitle()</literal>ì„
+ 찾게 ë 것ì´ë‹¤.
</para>
<para>
@@ -262,8 +273,9 @@
ê·¸ ìžì²´ë¥¼ ê²°ì •í•˜ë ¤ê³ ì‹œë„í• ê²ƒì´ë‹¤. 몇몇 경우들ì—ì„œ (Java í´ëž˜ìŠ¤ì— 대한 Reflectionì„ ì‚¬ìš©í•˜ëŠ”) ì´ ìžë™ì ì¸ ê²€ì¶œì€
ë‹¹ì‹ ì´ ì˜ˆìƒí•˜ê±°ë‚˜ 필요로 하는 ë””í´íŠ¸ë¥¼ 갖지 ì•Šì„ ìˆ˜ë„ ìžˆë‹¤. ì´ê²ƒì€ <literal>date</literal> 프로í¼í‹°ë¥¼ 가진
경우ì´ë‹¤. Hibernate는 ê·¸ 프로í¼í‹°ê°€ SQL <literal>date</literal> 컬럼, <literal>timestamp</literal>
- 컬럼 ë˜ëŠ” <literal>time</literal> 컬럼 중 ì–´ëŠ ê²ƒìœ¼ë¡œ 매핑ë˜ì–´ì•¼ 하는지를 ì•Œ 수가 없다. 우리는 <literal>timestamp</literal>를
- 가진 프로í¼í‹°ë¥¼ ë§¤í•‘í•¨ìœ¼ë¡œì¨ ì „ì²´ ë‚ ì§œì™€ 시간 ì •ë³´ë¥¼ ë³´ì¡´í•˜ê³ ì‹¶ë‹¤ê³ ì„ ì–¸í•œë‹¤.
+ 컬럼 ë˜ëŠ” <literal>time</literal> 컬럼 중 ì–´ëŠ ê²ƒìœ¼ë¡œ 매핑ë˜ì–´ì•¼ 하는지를 ì•Œ 수가 없다. 우리는
+ <literal>timestamp</literal> 컨버터를 가진 프로í¼í‹°ë¥¼ ë§¤í•‘í•¨ìœ¼ë¡œì¨ ì „ì²´ ë‚ ì§œì™€ 시간 ì •ë³´ë¥¼ ë³´ì¡´í•˜ê³ ì‹¶ë‹¤ê³
+ ì„ ì–¸í•œë‹¤.
</para>
<para>
@@ -277,8 +289,9 @@
+lib
<Hibernate and third-party libraries>
+src
- Event.java
- Event.hbm.xml]]></programlisting>
+ +events
+ Event.java
+ Event.hbm.xml]]></programlisting>
<para>
우리는 Hibernateì˜ ë©”ì¸ êµ¬ì„±ì„ ê³„ì† í–‰í•œë‹¤.
@@ -299,7 +312,7 @@
<para>
개발 ë””ë ‰í† ë¦¬ì˜ ë£¨íŠ¸ì— <literal>data</literal>ë¡œ ëª…ëª…ëœ ë””ë ‰í† ë¦¬ë¥¼ ìƒì„±ì‹œì¼œë¼ - ì´ ë””ë ‰í† ë¦¬ëŠ”
HSQL DBê°€ ê·¸ê²ƒì˜ ë°ì´í„° 파ì¼ë“¤ì„ ì €ìž¥í•˜ê²Œ ë 장소ì´ë‹¤. ì´ì œ ì´ ë°ì´í„° ë””ë ‰í† ë¦¬ì—ì„œ
- <literal>java -classpath lib/hsqldb.jar org.hsqldb.Server</literal>를 실행시켜서
+ <literal>java -classpath ../lib/hsqldb.jar org.hsqldb.Server</literal>를 실행시켜서
ë°ì´í„°ë² ì´ìŠ¤ë¥¼ 시작시켜ë¼. ë‹¹ì‹ ì€ ê·¸ê²ƒì´ ì‹œìž‘ë˜ê³ ì´ê²ƒì€ ìš°ë¦¬ì˜ ì–´í”Œë¦¬ì¼€ì´ì…˜ì´ ë‚˜ì¤‘ì— ì—°ê²°í•˜ê²Œ ë 장소ì¸,
í•˜ë‚˜ì˜ TCP/IP ì†Œì¼“ì— ë°”ì¸ë“œ ë˜ëŠ” ê²ƒì„ ë³¼ 수 있다. ë§Œì¼ ì´ íŠœí† ë¦¬ì–¼ ë™ì•ˆì— ë‹¹ì‹ ì´ ìƒˆ ë°ì´í„°ë² ì´ìŠ¤ë¡œ
ì‹œìž‘í•˜ê³ ìž ì›í• 경우, HSQL DB를 ì…§ë‹¤ìš´ì‹œí‚¤ê³ (왼ë„ìš°ì—ì„œ <literal>CTRL + C</literal>를 눌러ë¼),
@@ -332,26 +345,29 @@
<!-- Database connection settings -->
<property name="connection.driver_class">org.hsqldb.jdbcDriver</property>
- <property name="connection.url">jdbc:hsqldb:data/tutorial</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>
- <!-- For a HSQL 1.8 in-memory database, this is required -->
- <property name="connection.shutdown">true</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.NoCacheProvider</property>
+
<!-- Echo all executed SQL to stdout -->
<property name="show_sql">true</property>
<!-- Drop and re-create the database schema on startup -->
<property name="hbm2ddl.auto">create</property>
- <mapping resource="Event.hbm.xml"/>
+ <mapping resource="events/Event.hbm.xml"/>
</session-factory>
@@ -382,7 +398,7 @@
</sect2>
- <sect2 id="tutorial-firstapp-ant">
+ <sect2 id="tutorial-firstapp-ant" revision="1">
<title>Ant로 빌드하기</title>
<para>
@@ -393,16 +409,6 @@
명명ë˜ê³ 개발 ë””ë ‰í† ë¦¬ ì†ì— ì§ì ‘ 위치ë 것ì´ë‹¤.
</para>
- <note>
- <title>Ant 설치</title>
- <para>
- ë””í´íŠ¸ë¡œ Ant ë°°í¬ë³¸ì€ (FAQì— ì„¤ëª…ë˜ì—ˆë“¯ì´) ê¹¨ì–´ì ¸ 있으며, 예를 들어, ë§Œì¼ ë‹¹ì‹ ì´ ë‹¹ì‹ ì˜ ë¹Œë“œ íŒŒì¼ ë‚´ë¶€ì—ì„œ
- JUnit를 ì‚¬ìš©í•˜ê³ ìž ì›í• 경우 ë‹¹ì‹ ì— ì˜í•´ ì •ì •ë˜ì–´ì•¼ 한다. JUnit íƒœìŠ¤í¬ ìž‘ì—…ì„ í–‰í•˜ê¸° 위해(우리는 ì´
- íŠœí† ë¦¬ì–¼ì—ì„œ ê·¸ê²ƒì„ í•„ìš”ë¡œ 하지 ì•Šì„ ê²ƒì´ë‹¤), junit.jar를 <literal>ANT_HOME/lib</literal>ì— ë³µì‚¬í•˜ê±°ë‚˜
- <literal>ANT_HOME/lib/ant-junit.jar</literal> í”ŒëŸ¬ê·¸ì¸ ìŠ¤í…ì„ ì œê±°í•˜ë¼.
- </para>
- </note>
-
<para>
기본 빌드 파ì¼ì€ 다ìŒê³¼ 같다:
</para>
@@ -460,7 +466,7 @@
</sect2>
- <sect2 id="tutorial-firstapp-helpers" revision="1">
+ <sect2 id="tutorial-firstapp-helpers" revision="3">
<title>시작과 helper들</title>
<para>
@@ -478,12 +484,14 @@
ìœ ìš©í•˜ë©°, 우리는 í˜„ìž¬ì˜ ìž‘ì—… 단위를 í˜„ìž¬ì˜ ì“°ë ˆë“œì™€ 연관지워 ìœ ì§€í•œë‹¤. êµ¬í˜„ì„ ì‚´íŽ´ë³´ìž:
</para>
- <programlisting><![CDATA[import org.hibernate.*;
+ <programlisting><![CDATA[package util;
+
+import org.hibernate.*;
import org.hibernate.cfg.*;
public class HibernateUtil {
- public static final SessionFactory sessionFactory;
+ private static final SessionFactory sessionFactory;
static {
try {
@@ -496,25 +504,10 @@
}
}
- public static final ThreadLocal session = new ThreadLocal();
-
- public static Session getCurrentSession() throws HibernateException {
- Session s = (Session) session.get();
- // Open a new Session, if this thread has none yet
- if (s == null) {
- s = sessionFactory.openSession();
- // Store it in the ThreadLocal variable
- session.set(s);
- }
- return s;
+ public static SessionFactory getSessionFactory() {
+ return sessionFactory;
}
- public static void closeSession() throws HibernateException {
- Session s = (Session) session.get();
- if (s != null)
- s.close();
- session.set(null);
- }
}]]></programlisting>
<para>
@@ -545,9 +538,11 @@
+lib
<Hibernate and third-party libraries>
+src
- Event.java
- Event.hbm.xml
- HibernateUtil.java
+ +events
+ Event.java
+ Event.hbm.xml
+ +util
+ HibernateUtil.java
hibernate.cfg.xml
+data
build.xml]]></programlisting>
@@ -567,7 +562,7 @@
</sect2>
- <sect2 id="tutorial-firstapp-workingpersistence" revision="2">
+ <sect2 id="tutorial-firstapp-workingpersistence" revision="4">
<title>ê°ì²´ 로딩과 ê°ì²´ ì €ìž¥</title>
<para>
@@ -575,11 +570,13 @@
메소드를 가진 í•œ ê°œì˜ <literal>EventManager</literal> í´ëž˜ìŠ¤ë¥¼ 작성한다:
</para>
- <programlisting><![CDATA[import org.hibernate.Transaction;
+ <programlisting><![CDATA[package events;
import org.hibernate.Session;
import java.util.Date;
+import util.HibernateUtil;
+
public class EventManager {
public static void main(String[] args) {
@@ -589,28 +586,24 @@
mgr.createAndStoreEvent("My Event", new Date());
}
- HibernateUtil.sessionFactory.close();
+ HibernateUtil.getSessionFactory().close();
}
-}]]></programlisting>
+ private void createAndStoreEvent(String title, Date theDate) {
- <para>
- 우리는 ëª…ë ¹ ë¼ì¸ìœ¼ë¡œë¶€í„° 몇몇 ì•„ê·œë¨¼íŠ¸ë“¤ì„ ì½ì–´ë“¤ì´ê³ , ë§Œì¼ ì²« 번째 아규먼트가 "store"ì´ë©´, 우리는
- 새로운 Event를 ìƒì„±ì‹œí‚¤ê³ ì €ìž¥ì‹œí‚¨ë‹¤:
- </para>
+ Session session = HibernateUtil.getSessionFactory().getCurrentSession();
- <programlisting><![CDATA[private void createAndStoreEvent(String title, Date theDate) {
- Session session = HibernateUtil.getCurrentSession();
- Transaction tx = session.beginTransaction();
+ session.beginTransaction();
- Event theEvent = new Event();
- theEvent.setTitle(title);
- theEvent.setDate(theDate);
+ Event theEvent = new Event();
+ theEvent.setTitle(title);
+ theEvent.setDate(theDate);
- session.save(theEvent);
+ session.save(theEvent);
- tx.commit();
- HibernateUtil.closeSession();
+ session.getTransaction().commit();
+ }
+
}]]></programlisting>
<para>
@@ -621,30 +614,39 @@
</para>
<para>
- <literal>Session</literal>ì€ í•œ ê°œì˜ ìž‘ì—… 단위ì´ë‹¤. ë‹¹ì‹ ì€ ìš°ë¦¬ê°€ 추가ì ì¸ API, <literal>Transaction</literal>dmf
- ê°–ê³ ìžˆìŒì— 놀ëžì„ ìˆ˜ë„ ìžˆë‹¤. ì´ê²ƒì€ ìž‘ì—… 단위가 í•œ ê°œì˜ ë°ì´í„°ë² ì´ìŠ¤ 트랜ìžì…˜ë³´ë‹¤ "ë” ê¸´" ê²½ìš°ì¼ ìˆ˜ 있ìŒì„ ì˜ë¯¸í•œë‹¤
- -웹 어플리케ì´ì…˜ ì†ì—ì„œ 여러 ê°œì˜ Http ìš”ì²/ì‘답 주기들(예를 들면 마법사 대화ìƒìž)ì— ê±¸ì¹˜ëŠ” ìž‘ì—… 단위를 ìƒìƒí•˜ë¼.
- 지금 우리는 ê·¸ê²ƒë“¤ì„ ê°„ë‹¨í•˜ê²Œ ìœ ì§€í• ê²ƒì´ê³ <literal>Session</literal>ê³¼ <literal>Transaction</literal>
- 사ì´ì— í•œ ê°œì˜ one-to-one ìž…ìƒì„ ê°€ì •í• ê²ƒì´ë‹¤.
+ <literal>Session</literal>ì€ í•œ ê°œì˜ ìž‘ì—… 단위ì´ë‹¤. 지금부터 우리는 ë‹¨ìˆ¨í•¨ì„ ìœ ì§€í• ê²ƒì´ê³
+ Hibernate <literal>Session</literal>ê³¼ ë°ì´í„°ë² ì´ìŠ¤ 트랜ìžì…˜ 사ì´ì˜ ì¼-대-ì¼ ê³¼ë¦½í˜•(granularity)ì„ ê°€ì •í• ê²ƒì´ë‹¤.
+ ì‹¤ì œ 기반 트랜ìžì…˜ 시스템으로부터 ìš°ë¦¬ì˜ ì†ŒìŠ¤ë¥¼ ì€í시키기 위해(ì´ ê²½ìš° 통ìƒì˜ JDBCì´ì§€ë§Œ, ê·¸ê²ƒì€ ë˜í•œ JTAì—ë„ ì‹¤í–‰ëœë‹¤)
+ 우리는 Hibernate <literal>Session</literal> ìƒì—ì„œ ì´ìš© 가능한 <literal>Transaction</literal> API를
+ 사용한다.
</para>
<para>
- <literal>Transaction.begin()</literal>ê³¼ <literal>commit()</literal>ì€ ë¬´ì—‡ì„ í–‰í•˜ëŠ”ê°€?
- 잘못ë˜ëŠ” 경우들ì—ì„œ <literal>rollback()</literal>ì€ ì–´ë””ì— ìžˆëŠ”ê°€? Hibernate
- <literal>Transaction</literal> API는 ì‹¤ì œ 옵션ì´ì§€ë§Œ, 우리는 편ì˜ì™€ ì´ì‹ì„±ì„ 위해 ê·¸ê²ƒì„ ì‚¬ìš©í•œë‹¤.
- (예를 들어 <literal>session.connection.commit()</literal>ì„ í˜¸ì¶œí•¨ìœ¼ë¡œì¨)ë§Œì¼ ë‹¹ì‹ ìžì‹ ì´
- ë°ì´í„°ë² ì´ìŠ¤ 트랜ìžì…˜ì„ 처리했다면, ë‹¹ì‹ ì€ ì´ ì§ì ‘ì ì¸ ê´€ë¦¬ë˜ì§€ 않는 JDBCë¡œ 특별한 배치 í™˜ê²½ì— ê·¸ 코드를
- ë°”ì¸ë“œì‹œì¼°ë‹¤. ë‹¹ì‹ ì˜ Hibernate 구성 ì†ì—ì„œ <literal>Transaction</literal>ì„ ìœ„í•œ íŒ©í† ë¦¬ë¥¼ ì„¤ì •í•¨ìœ¼ë¡œì¨,
- ë‹¹ì‹ ì€ ë‹¹ì‹ ì˜ ì˜ì† ê³„ì¸µì„ ì–´ë””ì—서나 ë°°ì¹˜í• ìˆ˜ 있다. 트랜ìžì…˜ 처리와 ê´€í• ì— ëŒ€í•œ 추가 ì •ë³´ëŠ”
- <xref linkend="transactions"/>를 살펴보ë¼. 우리는 ë˜í•œ ì´ ì˜ˆì œì—ì„œ 오류 핸들ë§ê³¼ ë¡¤ë°±ì„ ìƒëžµí–ˆë‹¤.
+ <literal>sessionFactory.getCurrentSession()</literal>ì€ ë¬´ì—‡ì„ í–‰í•˜ëŠ”ê°€? ë¨¼ì €
+ ë‹¹ì‹ ì€ ë‹¹ì‹ ì´ (<literal>HibernateUtil</literal> ë•ë¶„ì— ì‰½ê²Œ) <literal>SessionFactory</literal>ì„
+ ë‹¹ì‹ ì´ ì†Œìœ í•˜ê³ ìžˆë‹¤ë©´, ì›í•˜ëŠ” ë§Œí¼ ì–´ë””ì„œë“ ì—¬ëŸ¬ë²ˆ ê·¸ê²ƒì„ í˜¸ì¶œí• ìˆ˜ 있다.
+ <literal>getCurrentSession()</literal> 메소드는 í•ìƒ "현재ì˜" ìž‘ì—… 단위를 반환한다. 우리가
+ <literal>hibernate.cfg.xml</literal> ë‚´ì—ì„œ ì´ ë§¤ì»¤ë‹ˆì¦˜ì— ëŒ€í•œ 구성 ì˜µì…˜ì„ "thread"ë¡œ ì „í™˜ì‹œì¼°ìŒì„ 기억하는가?
+ 그러므로 현재 ìž‘ì—… ë‹¨ìœ„ì˜ ì˜ì—ì€ ìš°ë¦¬ì˜ ì–´í”Œë¦¬ì¼€ì´ì…˜ì„ 실행시키는 í˜„ìž¬ì˜ Java ì“°ë ˆë“œì´ë‹¤. 하지만 ì´ê²ƒì€
+ ì „ë¶€ê°€ ì§„ì‹¤ì€ ì•„ë‹ˆë‹¤. ê·¸ê²ƒì´ ì²˜ìŒìœ¼ë¡œ 필요로 ë˜ê³ , <literal>getCurrentSession()</literal>ì„ ì²«ë²ˆì§¸ë¡œ
+ í˜¸ì¶œí• ë•Œ <literal>Session</literal>ì´ ì‹œìž‘ëœë‹¤. 그때 í˜„ì§¸ì˜ ì“°ë ˆë“œì— ëŒ€í•´ Hibernateì— ì˜í•´ ë°”ì¸ë“œ ëœë‹¤.
+ 트랜ìžì…˜ì´ 종료ë ë•Œ 커밋 ë˜ê±°ë‚˜ 롤백ë˜ê³ , Hibernate는 ë˜í•œ ì“°ë ˆë“œë¡œë¶€í„° <literal>Session</literal>ì„
+ ë°”ì¸ë“œ í•´ì œì‹œí‚¤ê³ ë‹¹ì‹ ì„ ìœ„í•´ ê·¸ê²ƒì„ ë‹«ëŠ”ë‹¤. ë§Œì¼ ë‹¹ì‹ ì´ <literal>getCurrentSession()</literal>ì„ ë‹¤ì‹œ
+ 호출한다면, ë‹¹ì‹ ì€ ìƒˆë¡œìš´ <literal>Session</literal>ì„ ì–»ê³ ìƒˆë¡œìš´ 작업단위를 ì‹œìž‘í• ìˆ˜ 있다. ì´
+ <emphasis>thread-bound</emphasis> í”„ë¡œê·¸ëž˜ë° ëª¨í˜•ì€ Hibernate를 사용하는 가장 대중ì ì¸ ë°©ë²•ì´ë‹¤.
</para>
<para>
+ 트랜ìžì…˜ 핸들ë§ê³¼ ê²½ê³„êµ¬ë¶„ì— ëŒ€í•œ 추가 ì •ë³´ëŠ” <xref linkend="transactions"/>ì„ ì‚´íŽ´ë³´ë¼.
+ 우리는 ë˜í•œ ì•žì˜ ì˜ˆì œì—ì„œ ìž„ì˜ì˜ 오류 처리와 ë¡¤ë°±ì„ ìƒëžµí–ˆë‹¤.
+ </para>
+
+ <para>
ì´ ì²« 번째 ë£¨í‹´ì„ ì‹¤í–‰í•˜ê¸° 위해서 우리는 호출 가능한 대ìƒì„ Ant 빌드 파ì¼ì— 추가해야 한다:
</para>
<programlisting><![CDATA[<target name="run" depends="compile">
- <java classname="EventManager" classpathref="libraries">
+ <java fork="true" classname="events.EventManager" classpathref="libraries">
<classpath path="${targetdir}"/>
<arg value="${action}"/>
</java>
@@ -691,13 +693,14 @@
</para>
<programlisting><![CDATA[private List listEvents() {
- Session session = HibernateUtil.getCurrentSession();
- Transaction tx = session.beginTransaction();
+ Session session = HibernateUtil.getSessionFactory().getCurrentSession();
+
+ session.beginTransaction();
+
List result = session.createQuery("from Event").list();
- tx.commit();
- session.close();
+ session.getTransaction().commit();
return result;
}]]></programlisting>
@@ -722,9 +725,9 @@
</listitem>
<listitem>
<para>
- ì´ì œ ë‹¹ì‹ ì˜ <literal>hibernate.cfg.xml</literal> íŒŒì¼ ì†ì—ì„œ 프로í¼í‹°ë¥¼ 주ì„ì²˜ë¦¬í•¨ìœ¼ë¡œì¨ hbm2ddlì„
- 사용불가능하게 하ë¼. 대개 ë‹¹ì‹ ì€ ì§€ì†ë˜ëŠ” 단위 테스팅ì—ì„œ ê·¸ê²ƒì„ ì‚¬ìš© 가능하게 ë‚´ë²„ë ¤ë‘ì–´ë„ ë˜ì§€ë§Œ, ë˜ ë‹¤ë¥¸
- hbm2ddlì˜ ì‹¤í–‰ì€ ë‹¹ì‹ ì´ ì €ìž¥í–ˆë˜ ëª¨ë“ ê²ƒì„ <emphasis>ë“œë¡</emphasis>시킬 것ì´ë‹¤ - <literal>create</literal>
+ ì´ì œ ë‹¹ì‹ ì˜ <literal>hibernate.cfg.xml</literal> íŒŒì¼ ì†ì—ì„œ ê·¸ 프로í¼í‹°ë¥¼ 주ì„ì²˜ë¦¬í•¨ìœ¼ë¡œì¨ hbm2ddlì„
+ 사용불가능하게 하ë¼. 대개 ë‹¹ì‹ ì€ ì§€ì†ë˜ëŠ” 단위 테스팅ì—서는 ê·¸ê²ƒì„ ì‚¬ìš© 가능하게 ë‚´ë²„ë ¤ë‘ì–´ë„ ë˜ì§€ë§Œ, ë˜ ë‹¤ë¥¸
+ hbm2ddlì˜ ì‹¤í–‰ì€ ë‹¹ì‹ ì´ ì €ìž¥í–ˆë˜ ëª¨ë“ ê²ƒì„ <emphasis>drop</emphasis>시킬 것ì´ë‹¤ - <literal>create</literal>
구성 ì„¤ì •ì€ ì‹¤ì œë¡œ "스키마로부터 ëª¨ë“ í…Œì´ë¸”ë“¤ì„ ë“œë¡ì‹œí‚¤ê³ 나서, SessionFactoryê°€ 빌드ë ë•Œ ëª¨ë“ í…Œì´ë¸”들ì„
다시 ìƒì„±ì‹œí‚¤ëŠ” 것"으로 변환ëœë‹¤.
</para>
@@ -755,35 +758,38 @@
우리는 ìš°ë¦¬ì˜ ì–´í”Œë¦¬ì¼€ì´ì…˜ì— ì‚¬ëžŒë“¤ì„ ì¶”ê°€í•˜ê³ ê·¸ë“¤ì´ ì°¸ì—¬í•˜ëŠ” ì´ë²¤íŠ¸ë“¤ì˜ 목ë¡ì„ ì €ìž¥í• ê²ƒì´ë‹¤.
</para>
- <sect2 id="tutorial-associations-mappinguser">
+ <sect2 id="tutorial-associations-mappinguser" revision="1">
<title>Person í´ëž˜ìŠ¤ 매핑하기</title>
<para>
í´ëž˜ìŠ¤ì˜ 첫 번째 ìž¥ë©´ì€ ê°„ë‹¨í•˜ë‹¤:
</para>
- <programlisting><![CDATA[public class Person {
+ <programlisting><![CDATA[package events;
+public class Person {
+
private Long id;
private int age;
private String firstname;
private String lastname;
- Person() {}
+ public Person() {}
// Accessor methods for all properties, private setter for 'id'
}]]></programlisting>
<para>
- <literal>Person.hbm.xml</literal>ë¡œ ëª…ëª…ëœ ìƒˆë¡œìš´ 매핑 파ì¼ì„ ìƒì„±ì‹œì¼œë¼:
+ <literal>Person.hbm.xml</literal>ë¡œ 명명ë˜ëŠ” 새로운 매핑 파ì¼ì„ ìƒì„±ì‹œì¼œë¼
+ (ë§¨ìœ„ì— DTD 참조를 잊지ë§ë¼):
</para>
<programlisting><![CDATA[<hibernate-mapping>
- <class name="Person" table="PERSON">
+ <class name="events.Person" table="PERSON">
<id name="id" column="PERSON_ID">
- <generator class="increment"/>
+ <generator class="native"/>
</id>
<property name="age"/>
<property name="firstname"/>
@@ -796,9 +802,8 @@
마지막으로 새로운 ë§¤í•‘ì„ Hibernateì˜ êµ¬ì„±ì— ì¶”ê°€í•˜ë¼:
</para>
- <programlisting><![CDATA[ <mapping resource="Event.hbm.xml"/>
- <mapping resource="Person.hbm.xml"/>
-]]></programlisting>
+ <programlisting><![CDATA[<mapping resource="events/Event.hbm.xml"/>
+<mapping resource="events/Person.hbm.xml"/>]]></programlisting>
<para>
ì´ì œ 우리는 ì´ë“¤ ë‘ ê°œì˜ ì—”í‹°í‹°ë“¤ 사ì´ì— í•œ ê°œì˜ ì—°ê´€ì„ ìƒì„±ì‹œí‚¬ 것ì´ë‹¤. 명백하게, ê°œì¸ë“¤ì€ ì´ë²¤íŠ¸ë“¤ì—
@@ -845,29 +850,6 @@
사용한다:
</para>
- <programlisting><![CDATA[public class Person {
-
- private Set events = new HashSet();
-
- public Set getEvents() {
- return events;
- }
-
- public void setEvents(Set events) {
- this.events = events;
- }
-}]]></programlisting>
-
- <para>
- ì´ ì—°ê´€ì„ ë§¤í•‘ì‹œí‚¤ê¸° ì „ì—, 다른 ì¸¡ì— ëŒ€í•´ ìƒê°í•´ë³´ìž. 명료하게 우리는 ì´ê²ƒì„ 단방향으로 ìœ ì§€ì‹œí‚¬ 수 있다. ë˜ëŠ”
- ë§Œì¼ ìš°ë¦¬ê°€ 양방향으로 네비게ì´íŠ¸í•˜ëŠ” ê²ƒì„ ê°€ëŠ¥í•˜ë„ë¡ í•˜ê³ ìž ì›í• 경우ì—, 우리는 <literal>Event</literal> ìƒì˜
- ë˜ ë‹¤ë¥¸ ì½œë ‰ì…˜ì„ ìƒì„±ì‹œí‚¬ 수 있다. 예를 들면.<literal>anEvent.getParticipants()</literal>. ì´ê²ƒì€
- 기능ì ì¸ ê´€ì ì—ì„œ 필수ì ì´ì§€ 않다. ë‹¹ì‹ ì€ íŠ¹ì • ì´ë²¤íŠ¸ì— 대한 참여ìžë“¤ì„ 검색하기 위해 í•˜ë‚˜ì˜ ëª…ì‹œì ì¸ ì§ˆì˜ë¥¼ í•ìƒ
- 실행시킬 수 있다. ì´ê²ƒì€ ë‹¹ì‹ ì—게 설계ìƒì˜ ì„ íƒìœ¼ë¡œ 남겨ë‘지만, ì´ ë…¼ì˜ì—ì„œ 명료해지는 ê²ƒì€ ê·¸ ì—°ê´€ì˜ ë‹¤ì¤‘ì„±ì´ë‹¤:
- ì–‘ ì¸¡ë“¤ì´ "many" ê°’ì„ ê°€ì§ˆ 경우, 우리는 ì´ê²ƒì„ <emphasis>many-to-many</emphasis> ì—°ê´€ì´ë¼ 명명한다. 그러므로,
- 우리는 Hibernateì˜ many-to-many ë§¤í•‘ì„ ì‚¬ìš©í•œë‹¤:
- </para>
-
<programlisting><![CDATA[<class name="events.Person" table="PERSON">
<id name="id" column="PERSON_ID">
<generator class="native"/>
@@ -882,6 +864,7 @@
</set>
</class>]]></programlisting>
+
<para>
Hibernate는 ëª¨ë“ ì¢…ë¥˜ì˜ ì½œë ‰ì…˜ 매핑들, 가장 공통ì ì¸ <literal><set></literal>ì„ ì§€ì›í•œë‹¤. many-to-many
ì—°ê´€ (ë˜ëŠ” <emphasis>n:m</emphasis> 엔티티 관계)ì˜ ê²½ìš°, í•œ ê°œì˜ ì—°ê´€ í…Œì´ë¸”ì´ í•„ìš”í•˜ë‹¤. ì´ í…Œì´ë¸” ë‚´ì— ìžˆëŠ” ê°ê°ì˜
@@ -912,7 +895,7 @@
</sect2>
- <sect2 id="tutorial-associations-working" revision="1">
+ <sect2 id="tutorial-associations-working" revision="2">
<title>ì—°ê´€ë“¤ì— ìž‘ì—…í•˜ê¸°</title>
<para>
@@ -920,16 +903,16 @@
</para>
<programlisting><![CDATA[private void addPersonToEvent(Long personId, Long eventId) {
- Session session = HibernateUtil.getCurrentSession();
- Transaction tx = session.beginTransaction();
+ Session session = HibernateUtil.getSessionFactory().getCurrentSession();
+ session.beginTransaction();
+
Person aPerson = (Person) session.load(Person.class, personId);
Event anEvent = (Event) session.load(Event.class, eventId);
aPerson.getEvents().add(anEvent);
- tx.commit();
- HibernateUtil.closeSession();
+ session.getTransaction().commit();
}]]></programlisting>
<para>
@@ -940,7 +923,9 @@
프로í¼í‹°ë¥¼ ë³€ê²½í•¨ìœ¼ë¡œì¨ ê·¸ê²ƒì„ ì‹œë„í• ìˆ˜ 있다. ê·¸ê²ƒë“¤ì´ <emphasis>ì˜ì†(persistent)</emphasis> ìƒíƒœì— 있는 ë™ì•ˆ, 즉 íŠ¹ì • Hibernate
<literal>Session</literal>ì— ë°”ì¸ë“œë˜ì–´ 있는 ë™ì•ˆ(예를 들면. ê·¸ê²ƒë“¤ì€ ìž‘ì—… 단위 ì†ì— 방금 로드ë˜ì—ˆê±°ë‚˜ ì €ìž¥ë˜ì—ˆë‹¤),
Hibernate는 ìž„ì˜ì˜ ë³€ê²½ë“¤ì„ ëª¨ë‹ˆí„°ë§í•˜ê³ 쓰기 ì´ë©´ì˜ 형태로 SQLì„ ì‹¤í–‰ì‹œí‚¨ë‹¤. 메모리 ìƒíƒœë¥¼ ë°ì´í„°ë² ì´ìŠ¤ì™€ ë™ê¸°í™” 시키는
- ê³¼ì •ì€ ëŒ€ê°œ ì˜¤ì§ ìž‘ì—… ë‹¨ìœ„ì˜ ëì—ì„œì´ê³ , <emphasis>flushing</emphasis>ì´ë¼ 명명ëœë‹¤.
+ ê³¼ì •ì€ ëŒ€ê°œ ì˜¤ì§ ìž‘ì—… ë‹¨ìœ„ì˜ ëì—ì„œì´ê³ , <emphasis>flushing</emphasis>ì´ë¼ 명명ëœë‹¤. ìš°ë¦¬ì˜ ì½”ë“œì—ì„œ, ìž‘ì—… 단위는
+ <literal>CurrentSessionContext</literal> í´ëž˜ìŠ¤ì— 대한 <literal>thread</literal> 구성 ì˜µì…˜ì— ì˜í•´ ì •ì˜ëœ
+ 대로 - ë°ì´í„°ë² ì´ìŠ¤ 트랜ìžì…˜ì˜ 커밋(ë˜ëŠ” 롤백)으로 ëì´ë‚œë‹¤.
</para>
<para>
@@ -949,41 +934,54 @@
<emphasis>detached</emphasis>ë¼ê³ 부른다). (매우 사실ì ì´ì§€ ì•Šì€) 코드 ë‚´ì—ì„œ ì´ê²ƒì€ 다ìŒê³¼ ê°™ì„ ìˆ˜ 있다:
</para>
- <programlisting><![CDATA[ private void addPersonToEvent(Long personId, Long eventId) {
+ <programlisting><![CDATA[private void addPersonToEvent(Long personId, Long eventId) {
- Session session = HibernateUtil.getCurrentSession();
- Transaction tx = session.beginTransaction();
+ Session session = HibernateUtil.getSessionFactory().getCurrentSession();
+ session.beginTransaction();
- Person aPerson = (Person) session.load(Person.class, personId);
- Event anEvent = (Event) session.load(Event.class, eventId);
+ Person aPerson = (Person) session
+ .createQuery("select p from Person p left join fetch p.events where p.id = :pid")
+ .setParameter("pid", personId)
+ .uniqueResult(); // Eager fetch the collection so we can use it detached
- tx.commit();
- HibernateUtil.closeSession();
+ Event anEvent = (Event) session.load(Event.class, eventId);
- aPerson.getEvents().add(anEvent); // aPerson is detached
+ session.getTransaction().commit();
- Session session2 = HibernateUtil.getCurrentSession();
- Transaction tx2 = session.beginTransaction();
+ // End of first unit of work
- session2.update(aPerson); // Reattachment of aPerson
+ aPerson.getEvents().add(anEvent); // aPerson (and its collection) is detached
- tx2.commit();
- HibernateUtil.closeSession();
- }
-]]></programlisting>
+ // Begin second unit of work
+ Session session2 = HibernateUtil.getSessionFactory().getCurrentSession();
+ session2.beginTransaction();
+
+ session2.update(aPerson); // Reattachment of aPerson
+
+ session2.getTransaction().commit();
+}]]></programlisting>
+
<para>
- <literal>update</literal>ì— ëŒ€í•œ í˜¸ì¶œì€ í•œ ê°œì˜ detached ê°ì²´ë¥¼ ì˜ì†í™” ì‹œí‚¤ê³ , ë‹¹ì‹ ì€ ê·¸ê²ƒì´ ìƒˆë¡œìš´ ìž‘ì—… 단위ì—
+ <literal>update</literal>ì— ëŒ€í•œ í˜¸ì¶œì€ í•œ ê°œì˜ detached ê°ì²´ë¥¼ 다시 ì˜ì†í™” ì‹œí‚¤ê³ , ë‹¹ì‹ ì€ ê·¸ê²ƒì´ ìƒˆë¡œìš´ ìž‘ì—… 단위ì—
ë°”ì¸ë“œëœë‹¤ê³ ë§í• 수 ìžˆê³ , ë”°ë¼ì„œ detached ë™ì•ˆì— ë‹¹ì‹ ì´ ê·¸ê²ƒì— ëŒ€í•´ 행한 ìž„ì˜ì˜ ë³€ê²½ë“¤ì´ ë°ì´í„°ë² ì´ìŠ¤ì— ì €ìž¥ë 수 있다.
+ ì´ê²ƒì€ ë‹¹ì‹ ì´ ê·¸ 엔티티 ê°ì²´ì˜ ì½œë ‰ì…˜ì— ëŒ€í•´ í–‰í–ˆë˜ ìž„ì˜ì˜ 변경들(추가/ì‚ì œ)를 í¬í•¨í•œë‹¤.
</para>
<para>
- ë¬¼ë¡ , ì´ê²ƒì€ ìš°ë¦¬ì˜ í˜„ìž¬ ìƒí™©ì—ì„œ ë§Žì´ ì‚¬ìš©ë˜ì§€ 않지만, ê·¸ê²ƒì€ ë‹¹ì‹ ì´ ë‹¹ì‹ ìžì‹ ì˜ ì–´í”Œë¦¬ì¼€ì´ì…˜ ì†ìœ¼ë¡œ ì„¤ê³„í• ìˆ˜ 있는 중요한
- ê°œë…ì´ë‹¤. 지금 í•œ ê°œì˜ ìƒˆë¡œìš´ ì•¡ì…˜ì„ <literal>EventManager</literal>ì˜ main ë©”ì†Œë“œì— ì¶”ê°€í•˜ê³ ëª…ë ¹ ë¼ì¸ì—ì„œ 그것ì„
+ ë¬¼ë¡ , ìš°ë¦¬ì˜ í˜„ìž¬ ìƒí™©ì—ì„œ ì´ê²ƒì€ ë§Žì´ ì‚¬ìš©ë˜ì§€ 않지만, ê·¸ê²ƒì€ ë‹¹ì‹ ì´ ë‹¹ì‹ ìžì‹ ì˜ ì–´í”Œë¦¬ì¼€ì´ì…˜ ë‚´ë¡œ ì„¤ê³„í• ìˆ˜ 있는 중요한
+ ê°œë…ì´ë‹¤. 지금 <literal>EventManager</literal>ì˜ main ë©”ì†Œë“œì— í•œ ê°œì˜ ìƒˆë¡œìš´ ì•¡ì…˜ì„ ì¶”ê°€í•˜ê³ ëª…ë ¹ ë¼ì¸ì—ì„œ 그것ì„
호출하여 ì´ ì—°ìŠµì„ ì™„ë£Œí•˜ë¼. ë§Œì¼ ë‹¹ì‹ ì´ í•œëª…ì˜ ê°œì¸ê³¼ í•œ ê°œì˜ ì´ë²¤íŠ¸ì— 대한 ì‹ë³„ìžë“¤ì„ 필요로 í• ê²½ìš° - <literal>save()</literal>
- 메소드가 ê·¸ê²ƒì„ ë°˜í™˜ì‹œí‚¨ë‹¤.
+ 메소드가 ê·¸ê²ƒì„ ë°˜í™˜ì‹œí‚¨ë‹¤(ë‹¹ì‹ ì€ ê·¸ ì‹ë³„ìžë¥¼ 반환시키는 ì•žì˜ ë©”ì†Œë“œë“¤ 중 ëª‡ëª‡ì„ ë³€ê²½ì‹œì¼œì•¼ í• ê²ƒì´ë‹¤):
</para>
+ <programlisting><![CDATA[else if (args[0].equals("addpersontoevent")) {
+ Long eventId = mgr.createAndStoreEvent("My Event", new Date());
+ Long personId = mgr.createAndStorePerson("Foo", "Bar");
+ mgr.addPersonToEvent(personId, eventId);
+ System.out.println("Added person " + personId + " to event " + eventId);
+}]]></programlisting>
+
<para>
ì´ê²ƒì€ ë‘ ê°œì˜ ë™ë“±í•˜ê²Œ 중요한 í´ëž˜ìŠ¤ë“¤, ë‘ ê°œì˜ ì—”í‹°í‹°ë“¤ 사ì´ì—ì„œ í•œ ê°œì˜ ì—°ê´€ì— ê´€í•œ ì˜ˆì œì˜€ë‹¤. ì•žì„œ 언급했듯ì´, ì „í˜•ì ì¸ ëª¨í˜• ë‚´ì—는
다른 í´ëž˜ìŠ¤ë“¤ê³¼ 타ì´ë“¤ì´ 존재하는ë°, 대개 "ëœ ì¤‘ìš”í•˜ë‹¤". ë‹¹ì‹ ì€ ì´ë¯¸ <literal>int</literal> ë˜ëŠ” <literal>String</literal>ê³¼
@@ -1065,9 +1063,29 @@
ê·¸ê²ƒì€ Javaì—ì„œ ë™ì¼í•œ 코드ì´ë‹¤.
</para>
+ <programlisting><![CDATA[private void addEmailToPerson(Long personId, String emailAddress) {
+
+ Session session = HibernateUtil.getSessionFactory().getCurrentSession();
+ session.beginTransaction();
+
+ Person aPerson = (Person) session.load(Person.class, personId);
+
+ // The getEmailAddresses() might trigger a lazy load of the collection
+ aPerson.getEmailAddresses().add(emailAddress);
+
+ session.getTransaction().commit();
+}]]></programlisting>
+
+ <para>
+ 지금 우리는 ì½œë ‰ì…˜ì„ ì´ˆê¸°í™” ì‹œí‚¤ëŠ”ë° <emphasis>fetch</emphasis> 질ì˜ë¥¼ 사용하지 않았다.
+ 그러므로 ì½œë ‰ì…˜ì˜ getter ë©”ì†Œë“œì— ëŒ€í•œ í˜¸ì¶œì€ ì½œë ‰ì…˜ì„ ì´ˆê¸°í™” 시키기 위해 추가ì ì¸ select를 트리거 시킬
+ 것ì´ì–´ì„œ, 우리는 ê·¸ê²ƒì— ìš”ì†Œë¥¼ 추가시킬 수 있다. SQL 로그를 ê´€ì°°í•˜ê³ ì´ê²ƒì„ eager fetchë¡œ 최ì í™” ì‹œí‚¤ë ¤ê³
+ ì‹œë„하ë¼.
+ </para>
+
</sect2>
- <sect2 id="tutorial-associations-bidirectional">
+ <sect2 id="tutorial-associations-bidirectional" revision="1">
<title>Bi-directional associations</title>
<para>
@@ -1097,7 +1115,7 @@
<programlisting><![CDATA[<set name="participants" table="PERSON_EVENT" inverse="true">
<key column="EVENT_ID"/>
- <many-to-many column="PERSON_ID" class="Person"/>
+ <many-to-many column="PERSON_ID" class="events.Person"/>
</set>]]></programlisting>
<para>
@@ -1183,7 +1201,7 @@
ê·¸ê²ƒì€ ìƒˆë¡œìš´ ì´ë²¤íŠ¸ë“¤ì„ ìž…ë ¥í•˜ê¸° 위한 HTML formì„ ì œê³µí•œë‹¤.
</para>
- <sect2 id="tutorial-webapp-servlet">
+ <sect2 id="tutorial-webapp-servlet" revision="1">
<title>기본 서블릿 작성하기</title>
<para>
@@ -1198,18 +1216,10 @@
public class EventManagerServlet extends HttpServlet {
- private final SimpleDateFormat dateFormatter =
- new SimpleDateFormat("dd.MM.yyyy");
-
// Servlet code
}]]></programlisting>
<para>
- <literal>dateFormatter</literal>는 ë‚˜ì¤‘ì— ë¬¸ìžì—´ë“¤ë¡œë¶€í„° ê·¸ë¦¬ê³ ë¬¸ìžì—´ë¡œ <literal>Date</literal> ê°ì²´ë“¤ì„
- ë³€í™˜í•˜ëŠ”ë° ë‚˜ì¤‘ì— ì‚¬ìš©í•˜ê²Œ ë ë„구ì´ë‹¤. ì„œë¸”ë¦¿ì˜ ë©¤ë²„ë¡œì„œ ì˜¤ì§ í•œ ê°œì˜ formatter를 갖는 ê²ƒì´ ë„ë¦¬ì— ë§žë‹¤.
- </para>
-
- <para>
ì„œë¸”ë¦¿ì€ HTTP <literal>GET</literal> ìš”ì²ë“¤ ë§Œì„ ì²˜ë¦¬í•˜ë¯€ë¡œ, 우리가 구현하는 메소드는 <literal>doGet()</literal>ì´ë‹¤:
</para>
@@ -1217,6 +1227,8 @@
HttpServletResponse response)
throws ServletException, IOException {
+ SimpleDateFormat dateFormatter = new SimpleDateFormat("dd.MM.yyyy");
+
try {
// Begin unit of work
HibernateUtil.getSessionFactory()
@@ -1259,7 +1271,7 @@
</sect2>
- <sect2 id="tutorial-webapp-processing">
+ <sect2 id="tutorial-webapp-processing" revision="1">
<title>프로세싱과 ë Œë”ë§</title>
<para>
@@ -1286,7 +1298,7 @@
// Print page
printEventForm(out);
-listEvents(out);
+listEvents(out, dateFormatter);
// Write HTML footer
out.println("</body></html>");
@@ -1315,7 +1327,8 @@
ì“°ë ˆë“œì— ê²°í•©ëœ Hibernate <literal>Session</literal>ì„ ì‚¬ìš©í•œë‹¤:
</para>
- <programlisting><![CDATA[private void listEvents(PrintWriter out) {
+ <programlisting><![CDATA[private void listEvents(PrintWriter out, SimpleDateFormat dateFormatter) {
+
List result = HibernateUtil.getSessionFactory()
.getCurrentSession().createCriteria(Event.class).list();
if (result.size() > 0) {
Modified: branches/Branch_3_2/Hibernate3/doc/reference/ko/styles/fopdf.xsl
===================================================================
--- branches/Branch_3_2/Hibernate3/doc/reference/ko/styles/fopdf.xsl 2006-12-08 08:01:55 UTC (rev 10955)
+++ branches/Branch_3_2/Hibernate3/doc/reference/ko/styles/fopdf.xsl 2006-12-08 08:07:27 UTC (rev 10956)
@@ -43,10 +43,10 @@
<fo:block>
<fo:external-graphic src="file:images/hibernate_logo_a.png"/>
</fo:block>
- <fo:block font-family="ê°€ì„ì²´" font-size="24pt" padding-before="10mm">
+ <fo:block font-family="Bangwool" font-size="18pt" padding-before="10mm">
<xsl:value-of select="bookinfo/subtitle"/>
</fo:block>
- <fo:block font-family="ê°€ì„ì²´" font-size="14pt" padding="10mm">
+ <fo:block font-family="Bangwool" font-size="12pt" padding="10mm">
ë²„ì „:
<xsl:value-of select="bookinfo/releaseinfo"/>
</fo:block>
@@ -92,7 +92,7 @@
<xsl:variable name="Version">
<xsl:choose>
<xsl:when test="//releaseinfo">
- <xsl:text>하ì´ë²„네ì´íŠ¸ </xsl:text>
+ <xsl:text>하ì´ë²„네ì´íŠ¸</xsl:text>
<xsl:value-of select="//releaseinfo"/>
</xsl:when>
<xsl:otherwise>
@@ -256,10 +256,10 @@
################################################### -->
<!-- Default Font size -->
- <xsl:param name="body.font.master">11</xsl:param>
+ <xsl:param name="body.font.master">10</xsl:param>
<!-- Line height in body text -->
- <xsl:param name="line-height">1.4</xsl:param>
+ <xsl:param name="line-height">1.6</xsl:param>
<!-- Monospaced fonts are smaller than regular text -->
<xsl:attribute-set name="monospace.properties">
@@ -311,7 +311,6 @@
<l:template name="sect4" text="the section called %t"/>
<l:template name="sect5" text="the section called %t"/>
</l:context>
-
</l:l10n>
</l:i18n>
@@ -516,9 +515,9 @@
<!-- Korean related Settings -->
<xsl:param name="hyphenate">false</xsl:param>
- <xsl:param name="body.font.family">Gulim</xsl:param>
- <!-- xsl:param name="monospace.font.family">ê°€ì„ì²´</xsl:param-->
- <xsl:param name="title.font.family">ê°€ì„ì²´</xsl:param>
+ <xsl:param name="body.font.family">Hankc</xsl:param>
+ <!-- xsl:param name="monospace.font.family">Bangwool</xsl:param-->
+ <xsl:param name="title.font.family">Bangwool</xsl:param>
<xsl:param name="saxon.character.representation" select="native"/>
<xsl:param name="callout.unicode" select="1"/>
<xsl:param name="callout.unicode.start.character" select="10102"/>
More information about the hibernate-commits
mailing list