Author: jdkim528 Date: 2007-02-25 00:34:40 -0500 (Sun, 25 Feb 2007) New Revision: 11241 Modified: trunk/Hibernate3/doc/reference/ko/modules/query_hql.xml Log: HHH-1851 : relax special 'id' property handling Modified: trunk/Hibernate3/doc/reference/ko/modules/query_hql.xml =================================================================== --- trunk/Hibernate3/doc/reference/ko/modules/query_hql.xml 2007-02-25 05:33:51 UTC (rev 11240) +++ trunk/Hibernate3/doc/reference/ko/modules/query_hql.xml 2007-02-25 05:34:40 UTC (rev 11241) @@ -1,6 +1,6 @@ -<chapter id="queryhql"> +<chapter id="queryhql" revision="1"> <title>HQL: 하이버네이트 질의 언어(Hibernate Query Language)</title> - + <para> Hibernate는 (아주 의도적으로) SQL과 매우 흡사하게 보이는 극히 강력한 질의 언어를 구비하고 있다. 그러나 그 구문에 의해 우롱당하지 말라; HQL은 상속, 다형성 그리고 연관과 같은 개념들을 이해하여서, 전체적으로 객체 지향적이다. @@ -15,12 +15,12 @@ <literal>org.hibernate.eg.Foo</literal>과 같지 않고 <literal>foo.barSet</literal>은 <literal>foo.BARSET</literal>과 같지 않다. </para> - + <para> 이 매뉴얼은 소문자 HQL 키워드를 사용한다. 몇몇 사용자들은 보다 나은 가독성을 위해 대문자 키워드들을 가진 질의들을 찾지만, 우리는 자바 코드 속에 삽입될 때 이 컨벤션이 추하다는 점을 발견한다. </para> - + </sect1> <sect1 id="queryhql-from"> @@ -29,16 +29,16 @@ <para> 가장 간단한 가능한 Hibernate 질의는 다음 형식이다: </para> - + <programlisting><![CDATA[from eg.Cat]]></programlisting> - + <para> 이것은 <literal>eg.Cat</literal> 클래스의 모든 인스턴스들을 간단하게 반환한다. 우리는 대개 클래스 이름을 수식할 필요가 없다. 왜냐하면, <literal>auto-import</literal>가 디폴트이기 때문이다. 따라서 우리는 대개 항상 단지 다음과 같이 작성한다: </para> - + <programlisting><![CDATA[from Cat]]></programlisting> - + <para> 대개 당신은 한 개의 <emphasis>alias</emphasis>를 할당할 필요가 있을 것이다. 왜냐하면 당신은 질의의 다른 부분들에서 <literal>Cat</literal>을 참조하고자 원할 것이기 때문이다. @@ -50,21 +50,21 @@ 이 질의는 alias <literal>cat</literal>을 <literal>Cat</literal> 인스턴스들에 할당하여서, 우리는 나중에 질의 속에서 그 alias를 사용할 수 있을 것이다. <literal>as</literal> 키워드는 옵션이다; 우리는 또한 다음과 같이 작성할 수 있다: </para> - + <programlisting><![CDATA[from Cat cat]]></programlisting> - + <para> 여러 개의 클래스들은 cartesian product(카티젼 곱) 또는 "크로스" 조인으로 귀결되어 나타날 수도 있다. </para> - + <programlisting><![CDATA[from Formula, Parameter]]></programlisting> <programlisting><![CDATA[from Formula as form, Parameter as param]]></programlisting> - + <para> 로컬 변수들에 대한 Java 네이밍 표준들과 일치되게, 첫 소문자를 사용하여 질의 alias들을 명명하는 것은 좋은 습관으로 간주된다 (예를 들면 <literal>domesticCat</literal>). </para> - + </sect1> <sect1 id="queryhql-joins" revision="2"> @@ -109,7 +109,7 @@ </para> </listitem> </itemizedlist> - + <para> <literal>inner join</literal>, <literal>left outer join</literal>, 그리고 <literal>right outer join</literal> 구조체들이 약칭될 수 있다. @@ -118,7 +118,7 @@ <programlisting><![CDATA[from Cat as cat join cat.mate as mate left join cat.kittens as kitten]]></programlisting> - + <para> 당신은 HQL <literal>with</literal> 키워드를 사용하여 특별한 조인 조건들을 제공할 수 있다. </para> @@ -132,22 +132,22 @@ 것을 허용해준다. 이것은 콜렉션의 경우에 특히 유용하다. 그것은 연관관계들과 콜렉션들에 대한 매핑 파일의 outer join과 lazy 선언들을 효율적으로 오버라이드 시킨다. 추가 정보는 <xref linkend="performance-fetching"/>을 보라. </para> - + <programlisting><![CDATA[from Cat as cat inner join fetch cat.mate left join fetch cat.kittens]]></programlisting> - + <para> fetch join은 대개 alias를 할당할 필요가 없다. 왜냐하면, 연관된 객체들이 <literal>where</literal> 절(또는 어떤 다른 절) 속에 사용되지 않을 것이기 때문이다. 또한 연관된 객체들은 질의 결과들 속에 직접 반환되지 않는다. 대신 그것들은 부모 객체를 통해 접근될 수 있다. 우리가 alias를 필요로 할 수 있는 유일한 이유는 더 많은 콜렉션들을 재귀적으로 조인 페칭시키는 경우이다: </para> - + <programlisting><![CDATA[from Cat as cat 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>를 사용하여 호출되는 질의들 내에 사용될 수 없음을 노트하라. 이들 오퍼레이션들이 결과 행들에 @@ -159,12 +159,12 @@ 또한 때때로 bag 매핑들에 대해 예기치 않은 결과들을 가져다주기 때문에, 당신이 이 경우에 당신의 질의들을 처방하는 방법에 대해 주의하라. 마지막으로 <literal>full join fetch</literal>와 <literal>right join fetch</literal>는 의미가 없다. </para> - + <para> 만일 당신이 (바이트코드 방편으로) property-레벨 lazy 페칭을 사용할 경우, Hibernate로 하여금 <literal>fetch all properties</literal>를 사용하여 (첫 번째 질의에서) lazy 프로퍼티들을 즉시 페치하도록 강제시키는 것이 가능하다. </para> - + <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> @@ -191,6 +191,39 @@ <programlisting><![CDATA[from Cat as cat where cat.mate.name like '%s%']]></programlisting> </sect1> + <sect1 id="queryhql-identifier-property"> + <title>식별자 속성 참조하기</title> + + <para> + 개략적으로 말하자면, 엔티티의 식별자 속성을 참조하는 2가지 방법들이 존재한다: + </para> + <itemizedlist spacing="compact"> + <listitem> + <para> + <emphasis>엔티티가 id로 명명된 비식별자 속성을 정의하지 않는다고 가정하면</emphasis> + 특별한 속성(소문자) <literal>id</literal>가 엔티티의 식별자 속성을 참조하는데 사용될 수 있다. + </para> + </listitem> + <listitem> + <para> + 만일 그 엔티티가 명명된 식별자 속성을 정의하는 경우, 당신은 그 속성 이름을 사용할 수도 있다. + </para> + </listitem> + </itemizedlist> + + <para> + composite 식별자 속성들에 대한 참조들은 동일한 네이밍 규칙들을 따른다. 만일 그 엔티티가 id로 명명된 비식별자를 + 갖고 있을 경우, composite 속성은 오직 그것의 정의된 명명에 의해 참조될 수 있다; 그밖의 경우 특별한 <literal>id</literal> + 속성이 식별자 속성을 참조하는데 사용될 수 있다. + </para> + + <para> + 노트: 이것은 버전 3.2.2에서 시작될 때 현격하게 변경되었다. 이전 버전들에서, <literal>id</literal>는 <emphasis>항상</emphasis> + 그것의 실제 이름에 관계없이 식별자 속성을 참조했다. 그 결정의 분기점은 <literal>id</literal>로 명명된 비식별자 속성들이 + Hibernate 질의들 내에서 결코 참조될 수 없었다는 점이었다. + </para> + </sect1> + <sect1 id="queryhql-select"> <title>select 절</title> @@ -228,29 +261,29 @@ from DomesticCat as mother inner join mother.mate as mate left outer join mother.kittens as offspr]]></programlisting> - + <para> 또는 <literal>List</literal>로서, </para> - + <programlisting><![CDATA[select new list(mother, offspr, mate.name) from DomesticCat as mother inner join mother.mate as mate left outer join mother.kittens as offspr]]></programlisting> - + <para> 또는 실제 typesafe 자바 객체로서, </para> - + <programlisting><![CDATA[select new Family(mother, mate, offspr) from DomesticCat as mother join mother.mate as mate left join mother.kittens as offspr]]></programlisting> - + <para> 반환할 수도 있다. </para> - + <para> 당신은 <literal>as</literal>를 사용하여 select되는 표현식들에 alias들을 할당할 수 있다: </para> @@ -261,14 +294,14 @@ <para> 다음은 <literal>select new map</literal>과 함께 사용될 때 가장 유용하다: </para> - + <programlisting><![CDATA[select new map( max(bodyWeight) as max, min(bodyWeight) as min, count(*) as n ) from Cat cat]]></programlisting> <para> 이 질의는 select된 값들에 대한 alias로부터 한 개의 <literal>Map</literal>을 반환한다. </para> - + </sect1> <sect1 id="queryhql-aggregation"> @@ -312,18 +345,18 @@ </para> </listitem> </itemizedlist> - + <para> 당신은 select 절 속에 산술 연산자들, 연결 연산자, 그리고 인지된 SQL 함수들을 사용할 수 있다: </para> - + <programlisting><![CDATA[select cat.weight + sum(kitten.weight) from Cat cat join cat.kittens kitten group by cat.id, cat.weight]]></programlisting> <programlisting><![CDATA[select firstName||' '||initial||' '||upper(lastName) from Person]]></programlisting> - + <para> <literal>distinct</literal> 키워드와 all <literal>all</literal>가 사용될 수 있고 SQL의 경우와 동일한 의미를 갖는다. </para> @@ -333,7 +366,7 @@ select count(distinct cat.name), count(cat) from Cat cat]]></programlisting> </sect1> - + <sect1 id="queryhql-polymorphism"> <title>Polymorphic(다형성) 질의들</title> @@ -349,24 +382,24 @@ 명명할 수 있다. 질의는 그 클래스를 확장하거나 그 인터페이스를 구현하는 모든 영속 클래스들의 인스턴스들을 반환할 것이다. 다음 질의는 모든 영속 객체들을 반환할 것이다: </para> - + <programlisting><![CDATA[from java.lang.Object o]]></programlisting> - + <para> 인터페이스 <literal>Named</literal>는 여러 가지 영속 클래스들에 의해 구현될 수도 있다: </para> - + <programlisting><![CDATA[from Named n, Named m where n.name = m.name]]></programlisting> - + <para> 이들 마지막 두 개의 질의들은 하나 이상의 SQL <literal>SELECT</literal>를 필요로 할 것임을 노트하라. 이것은 <literal>order by</literal> 절이 정확하게 전체 결과 셋을 순서지우지 않음을 의미한다.(그것은 또한 당신이 <literal>Query.scroll()</literal>을 사용하여 이들 질의들을 호출할 수 없음을 의미한다). </para> - + </sect1> - <sect1 id="queryhql-where"> + <sect1 id="queryhql-where" revision="1"> <title>where 절</title> <para> @@ -375,11 +408,11 @@ </para> <programlisting><![CDATA[from Cat where name='Fritz']]></programlisting> - + <para> 만일 한 개의 alias가 존재할 경우, 하나의 수식어가 붙은 프로퍼티 이름을 사용하라: </para> - + <programlisting><![CDATA[from Cat as cat where cat.name='Fritz']]></programlisting> <para> @@ -420,8 +453,8 @@ where cat.mate = mate]]></programlisting> <para> - 특별한 프로퍼티(소문자) <literal>id</literal>는 객체의 유일 식별자를 참조하는데 사용될 수 있다.(당신은 또한 그것의 프로퍼티 - 이름을 사용할 수도 있다.) + 특별한 프로퍼티(소문자) <literal>id</literal>는 객체의 유일 식별자를 참조하는데 사용될 수 있다. + 추가 정보는 <xref linkend="queryhql-identifier-property"/>를 보라. </para> <programlisting><![CDATA[from Cat as cat where cat.id = 123 @@ -433,23 +466,23 @@ </para> <para> - composite identifier(합성 식별자)들의 프로퍼티들이 또한 사용될 수 있다. <literal>Person</literal>이 - <literal>country</literal>와 <literal>medicareNumber</literal>로 구성된 composite identifier를 갖는다고 - 가정하자. + composite(합성) 식별자들의 프로퍼티들이 또한 사용될 수 있다. <literal>Person</literal>이 + <literal>country</literal>와 <literal>medicareNumber</literal>로 구성된 composite 식별자를 갖는다고 + 가정하자. 식별자 속성들을 참조하는 것과 관련된 추가 정보는 다시 <xref linkend="queryhql-identifier-property"/>를 보라. </para> <programlisting><![CDATA[from bank.Person person -where person.id.country = 'AU' +where person.id.country = 'AU' and person.id.medicareNumber = 123456]]></programlisting> <programlisting><![CDATA[from bank.Account account -where account.owner.id.country = 'AU' +where account.owner.id.country = 'AU' and account.owner.id.medicareNumber = 123456]]></programlisting> <para> 다시 한번, 두 번째 질의는 테이블 join을 필요로 하지 않는다. </para> - + <para> 마찬가지로, 특별한 프로퍼티 <literal>class</literal>는 다형적인 영속성(polymorphic persistence)의 경우에 인스턴스의 판별자(discriminator) 값에 액세스한다. where 절 속에 삽입된 Java 클래스 이름은 그것의 판별자(discriminator) 값으로 @@ -457,30 +490,26 @@ </para> <programlisting><![CDATA[from Cat cat where cat.class = DomesticCat]]></programlisting> - + <para> - 당신은 또한 컴포넌트들 또는 composite 사용자 정의 타입들의 (그리고 컴포넌트들의 컴포넌트들, 기타의) 프로퍼티들을 - 지정할 수도 있다. (컴포넌트의 프로퍼티와은 반대로) 컴포넌트 타입의 프로퍼티로 끝나는 경로-표현식을 사용하려고 결코 시도하지 말라. - 예를 들어, 만일 <literal>store.owner</literal>가 컴포넌트 <literal>address</literal>를 가진 엔티티일 경우 + 당신은 또한 컴포넌트들 또는 composite 사용자 타입들, 또는 명명된 컴포넌트 타입들의 속성들을 사용할 수도 있다. 상세한 것은 + <xref linkend="queryhql-coomponents"/>를 보라. </para> - <programlisting><![CDATA[store.owner.address.city // okay -store.owner.address // error!]]></programlisting> - <para> "임의의" 타입은 다음 방법으로 join을 표현하는 것을 우리에게 허용해주는, 특별한 프로퍼티들 <literal>id</literal>와 <literal>class</literal>를 갖는다(여기서 <literal>AuditLog.item</literal>은 <literal>&lt;any&gt;</literal>로 매핑된 프로퍼티이다). </para> - + <programlisting><![CDATA[from AuditLog log, Payment payment where log.item.class = 'Payment' and log.item.id = payment.id]]></programlisting> - + <para> <literal>log.item.class</literal>와 <literal>payment.class</literal>는 위의 질의 내에서 완전히 다른 데이터베이스 컬럼들의 값들을 참조할 것임을 노트하라. </para> - + </sect1> <sect1 id="queryhql-expressions"> @@ -659,13 +688,13 @@ 최소 인덱스과 최대 인덱스를 참조할 수 있다. 유사하게 당신은 <literal>minelement</literal>와 <literal>maxelement</literal> 함수를 사용하여 기본 타입을 가진 콜렉션의 최소 요소 및 최대 요소를 참조할 수 있다. </para> - + <programlisting><![CDATA[from Calendar cal where maxelement(cal.holidays) > current_date]]></programlisting> - + <programlisting><![CDATA[from Order order where maxindex(order.items) > 100]]></programlisting> <programlisting><![CDATA[from Order order where minelement(order.items) > 10000]]></programlisting> - + <para> SQL 함수들 <literal>any, some, all, exists, in</literal>은 콜렉션의 요소 또는 인덱스 세트(<literal>elements</literal> 함수와 <literal>indices</literal> 함수), 또는 서브질의의 결과를 전달했을 때 지원된다(아래를 보라). @@ -688,11 +717,11 @@ <literal>minindex</literal>, <literal>maxindex</literal>, <literal>minelement</literal>, <literal>maxelement</literal>-는 Hibernate3에서 where 절 내에서만 사용될 것임을 노트하라. </para> - + <para> 인덱싱 된 콜렉션들의 요소들(배열들, 리스트들, map들)은 인덱스에 의해 참조될 수 있다(where 절 안에서만): </para> - + <programlisting><![CDATA[from Order order where order.items[0].id = 1234]]></programlisting> <programlisting><![CDATA[select person from Person person, Calendar calendar @@ -708,10 +737,10 @@ <para> <literal>[]</literal> 내부의 표현식은 산술 표현실일 수 있다. </para> - + <programlisting><![CDATA[select item from Item item, Order order where order.items[ size(order.items) - 1 ] = item]]></programlisting> - + <para> HQL은 또한 one-to-many 연관 또는 값들을 가진 콜렉션의 요소들에 대해 미리 만들어진 <literal>index()</literal> 함수를 제공한다. @@ -778,7 +807,7 @@ </para> </sect1> - <sect1 id="queryhql-grouping"> + <sect1 id="queryhql-grouping" revision="1"> <title>group by 절</title> <para> @@ -810,95 +839,72 @@ <programlisting><![CDATA[select cat from Cat cat join cat.kittens kitten -group by cat +group by cat.id, cat.name, cat.other, cat.properties having avg(kitten.weight) > 100 order by count(kitten) asc, sum(kitten.weight) desc]]></programlisting> <para> <literal>group by</literal> 절도 <literal>order by</literal> 절 어느 것도 산술 표현식들을 포함할 수 없다는 점을 - 노트하라. + 노트하라. 또한 Hibernate는 현재 그룹지워진 엔티티를 확장하지 않아서 만일 <literal>cat</literal>의 + 모든 속성들이 집계되지 않을 경우에 당신이 <literal>group by cat</literal>을 쓸수 없음을 노트하라. + 당신은 명시적으로 모든 집계되지 않는 속성들을 리스트해야 한다. </para> </sect1> - - <sect1 id="queryhql-subqueries" revision="2"> + + <sect1 id="queryhql-subqueries" revision="3"> <title>서브질의들</title> <para> subselect들을 지원하는 데이터베이스들의 경우, Hibernate는 질의들 내에 서브질의들을 지원한다. 서브질의는 괄호로 묶여져야 - 한다(자주 SQL 집계함수 호출에 의해). 심지어 서로 상관된 서브질의들(외부 질의 내에서 alias를 참조하는 서브질의들)이 허용된다. + 한다(자주 SQL 집계함수 호출에 의해). 심지어 서로 상관된 서브질의들(외부 질의 내에서 alias를 참조하는 서브질의들)이 허용된다. </para> - <programlisting><![CDATA[from Cat as fatcat -where fatcat.weight > ( - select avg(cat.weight) from DomesticCat cat + <programlisting><![CDATA[from Cat as fatcat +where fatcat.weight > ( + select avg(cat.weight) from DomesticCat cat )]]></programlisting> - <programlisting><![CDATA[from DomesticCat as cat -where cat.name = some ( - select name.nickName from Name as name + <programlisting><![CDATA[from DomesticCat as cat +where cat.name = some ( + select name.nickName from Name as name )]]></programlisting> - - <programlisting><![CDATA[from Cat as cat -where not exists ( - from Cat as mate where mate.mate = cat + + <programlisting><![CDATA[from Cat as cat +where not exists ( + from Cat as mate where mate.mate = cat )]]></programlisting> - <programlisting><![CDATA[from DomesticCat as cat -where cat.name not in ( - select name.nickName from Name as name + <programlisting><![CDATA[from DomesticCat as cat +where cat.name not in ( + select name.nickName from Name as name )]]></programlisting> - <programlisting><![CDATA[select cat.id, (select max(kit.weight) from cat.kitten kit) + <programlisting><![CDATA[select cat.id, (select max(kit.weight) from cat.kitten kit) from Cat as cat]]></programlisting> <para> - select 리스트 내에 있는 하나 이상의 표현식을 가진 서브질의들의 경우에 당신은 tuple 생성자를 사용할 수 있다: - </para> - - <para> - select 목록 내에 하나 이상의 표현식을 가진 서브질의들의 경우, 당신은 튜플(tuple) 구조를 사용할 수 있다: - </para> - - <programlisting><![CDATA[from Cat as cat -where not ( cat.name, cat.color ) in ( - select cat.name, cat.color from DomesticCat cat -)]]></programlisting> - - <para> HQL 서브질의들이 select 절 또는 where 절 내에서만 일어날 수 있음을 노트하라. </para> - <para> - (Oracle 또는 HSQL이 아닌) 몇몇 데이터베이스들 상에서, 당신은 다른 컨텍스트들 내에서, 예를 들면 component들이나 composite - 사용자 타입들을 질의할 때 tuple 생성자들을 사용할 수 있음을 노트하라: - </para> - <programlisting><![CDATA[from Person where name = ('Gavin', 'A', 'King')]]></programlisting> - <para> - 이것을 더 풀어쓰면 다음과 동일하다: + 서브질의들은 또한 <literal>row value constructor</literal> 구문을 활용할 수 있다. 상세한 것은 + <xref linkend="queryhql-tuple"/>를 보라. </para> - - <programlisting><![CDATA[from Person where name.first = 'Gavin' and name.initial = 'A' and name.last = 'King')]]></programlisting> - <para> - 당신이 이런 종류의 것을 행하는 것을 원하지 않을 수 있는 두 가지 좋은 이유들이 존재한다: 첫 번째로 데이터베이스 플랫폼들 사이에 완전하게 - 이식성이 없다; 두 번째로 그 질의는 이제 매핑 문서 속에 있는 프로퍼티들의 순서에 의존한다. - </para> - </sect1> <sect1 id="queryhql-examples"> <title>HQL 예제들</title> - + <para> - + Hibernate 질의들은 매우 강력하고 복잡할 수 있다. 사실, 질의 언어의 힘은 Hibernate의 주요 판매 포인트들 중 하나이다. 다음은 내가 최근의 프로젝트에서 사용했던 질의들과 매우 유사한 몇몇 예제 질의들이다. 당신이 작성하게 될 대부분의 질의들은 이것들보다 훨씬 간단하다는 점을 노트하라! </para> - + <para> 다음 질의는 특정 고객에 대한 모든 지불되지 않은 주문들의 주문 id, 항목들의 개수, 그리고 주문의 전체 합계값 그리고 주어진 최소 전체 합계를 전체 합계값에 따라 결과들을 순서지워서 반환한다. 가격 결정에 있어, 그것은 현재의 카타록을 사용한다. @@ -906,7 +912,7 @@ <literal>CATALOG</literal>, <literal>PRICE</literal> 테이블들에 대한 네 개의 inner 조인들과 한 개의(상관지워지지 않은) subselect를 갖고 있다. </para> - + <programlisting><![CDATA[select order.id, sum(price.amount), count(item) from Order as order join order.lineItems as item @@ -925,11 +931,11 @@ group by order having sum(price.amount) > :minAmount order by sum(price.amount) desc]]></programlisting> - + <para> 괴물 같은 것! 실제로 실 생활에서, 나는 서브질의들을 매우 좋아하지 않아서, 나의 질의는 실제로 다음과 같았다: </para> - + <programlisting><![CDATA[select order.id, sum(price.amount), count(item) from Order as order join order.lineItems as item @@ -943,7 +949,7 @@ group by order having sum(price.amount) > :minAmount order by sum(price.amount) desc]]></programlisting> - + <para> 다음 질의는 현재 사용자에 의해 가장 최근의 상태 변경이 행해졌던 <literal>AWAITING_APPROVAL</literal> 상태에 있는 모든 지불들을 제외한, 각각의 상태에 있는 지불들의 개수를 카운트 한다. 그것은 <literal>PAYMENT</literal>, @@ -971,7 +977,7 @@ 만일 내가 <literal>statusChanges</literal> 콜렉션을 set가 아닌 list로 매핑했다면, 그 질의는 작성하기가 훨씬 더 간단했을 것이다. </para> - + <programlisting><![CDATA[select count(payment), status.name from Payment as payment join payment.currentStatus as status @@ -1085,7 +1091,7 @@ <para> 콜렉션 요소들은 질의 필터를 사용하여 순서(ordering)지워지거나 그룹지워질 수 도 있다: </para> - + <programlisting><![CDATA[Collection orderedCollection = s.filter( collection, "order by this.amount" ); Collection counts = s.filter( collection, "select this.type, count(this) group by this.type" );]]></programlisting> @@ -1097,5 +1103,76 @@ </sect1> + <sect1 id="queryhql-components"> + <title>컴포넌트들</title> + + <para> + 컴포넌트들은 단지 간단한 값 유형들이 HQL 질의들 내에 사용될 수 있는 모든 방법으로 사용될 수 있다. 그것들은 + <literal>select</literal> 절 내에 나타날 수 있다. + </para> + + <programlisting><![CDATA[select p.name from from Person p]]></programlisting> + <programlisting><![CDATA[select p.name.first from from Person p]]></programlisting> + + <para> + 여기서 Person의 name 속성은 컴포넌트이다. 컴포넌트들은 또한 <literal>where</literal> 절 내에 사용될 수 있다: + </para> + + <programlisting><![CDATA[from from Person p where p.name = :name]]></programlisting> + <programlisting><![CDATA[from from Person p where p.name.first = :firstName]]></programlisting> + + <para> + 컴포넌트들은 또한 <literal>order by</literal> 절 내에 사용될 수 있다: + </para> + + <programlisting><![CDATA[from from Person p order by p.name]]></programlisting> + <programlisting><![CDATA[from from Person p order by p.name.first]]></programlisting> + + <para> + 컴포넌트들에 대한 또 다른 공통적인 사용은 <xref linkend="queryhql-tuple">row value constructors</xref>에 있다. + </para> + </sect1> + + <sect1 id="queryhql-tuple"> + <title>Row value constructor 구문</title> + + <para> + HQL은 ANSI SQL <literal>row value constructor</literal> 구문(종종 <literal>tuple</literal> 구문이라 명명된다)의 사용을 지원한다. + 비록 데이터베이스가 그 개념을 지원하지 않을지라도 그러하다. 여기서 우리는 전형적으로 컴포넌트들과 연관되어 있는 다중-값 비교들을 + 일반적으로 언급하고 있다. name 컴포넌트를 정의하는 Person 엔티티를 검토하자: + </para> + + <programlisting><![CDATA[from Person p where p.name.first='John' and p.name.last='Jingleheimer-Schmidt']]></programlisting> + + <para> + 비록 약간 장황스럽지만 그것은 유효한 구문이다. 이것을 약간 더 간결하게 만들고 + <literal>row value constructor</literal> 구문을 사용하는 것이 좋다: + </para> + + <programlisting><![CDATA[from Person p where p.name=('John', 'Jingleheimer-Schmidt')]]></programlisting> + + <para> + <literal>select</literal>절 내에 이것을 지정하는 것이 또한 유용할 수 있다: + </para> + + <programlisting><![CDATA[select p.name from from Person p]]></programlisting> + + <para> + <literal>row value constructor</literal> 구문을 사용하는 또 다른 경우는 다중 값들에 대해 비교할 필요가 있는 + 서브 질의들을 사용할 때이다: + </para> + + <programlisting><![CDATA[from Cat as cat +where not ( cat.name, cat.color ) in ( + select cat.name, cat.color from DomesticCat cat +)]]></programlisting> + + <para> + 만일 당신이 이 구문을 사용하고자 원할 경우에 고려해야 할 한 가지는 질의가 메타데이터 내에 있는 + 컴포넌트 서브-속성들의 순서에 종속될 것이라는 점이다. + </para> + + </sect1> + </chapter>