hibernate-commits October 2007

hibernate-commits@lists.jboss.org

1 participants
127 discussions

Hibernate SVN: r14137 - core/trunk/documentation/manual/zh-CN/src/main/docbook/content.

by hibernate-commits＠lists.jboss.org

Author: xhuang(a)jboss.com Date: 2007-10-25 20:57:21 -0400 (Thu, 25 Oct 2007) New Revision: 14137 Modified: core/trunk/documentation/manual/zh-CN/src/main/docbook/content/architecture.xml core/trunk/documentation/manual/zh-CN/src/main/docbook/content/association_mapping.xml core/trunk/documentation/manual/zh-CN/src/main/docbook/content/basic_mapping.xml core/trunk/documentation/manual/zh-CN/src/main/docbook/content/batch.xml core/trunk/documentation/manual/zh-CN/src/main/docbook/content/best_practices.xml core/trunk/documentation/manual/zh-CN/src/main/docbook/content/collection_mapping.xml core/trunk/documentation/manual/zh-CN/src/main/docbook/content/component_mapping.xml core/trunk/documentation/manual/zh-CN/src/main/docbook/content/configuration.xml core/trunk/documentation/manual/zh-CN/src/main/docbook/content/events.xml core/trunk/documentation/manual/zh-CN/src/main/docbook/content/example_mappings.xml core/trunk/documentation/manual/zh-CN/src/main/docbook/content/example_parentchild.xml core/trunk/documentation/manual/zh-CN/src/main/docbook/content/example_weblog.xml core/trunk/documentation/manual/zh-CN/src/main/docbook/content/filters.xml core/trunk/documentation/manual/zh-CN/src/main/docbook/content/inheritance_mapping.xml core/trunk/documentation/manual/zh-CN/src/main/docbook/content/performance.xml core/trunk/documentation/manual/zh-CN/src/main/docbook/content/persistent_classes.xml core/trunk/documentation/manual/zh-CN/src/main/docbook/content/query_criteria.xml core/trunk/documentation/manual/zh-CN/src/main/docbook/content/query_hql.xml core/trunk/documentation/manual/zh-CN/src/main/docbook/content/query_sql.xml core/trunk/documentation/manual/zh-CN/src/main/docbook/content/quickstart.xml core/trunk/documentation/manual/zh-CN/src/main/docbook/content/session_api.xml core/trunk/documentation/manual/zh-CN/src/main/docbook/content/toolset_guide.xml core/trunk/documentation/manual/zh-CN/src/main/docbook/content/transactions.xml core/trunk/documentation/manual/zh-CN/src/main/docbook/content/tutorial.xml core/trunk/documentation/manual/zh-CN/src/main/docbook/content/xml.xml Log: Remove <feff> characters and match to latest English version Modified: core/trunk/documentation/manual/zh-CN/src/main/docbook/content/architecture.xml =================================================================== --- core/trunk/documentation/manual/zh-CN/src/main/docbook/content/architecture.xml 2007-10-26 00:48:48 UTC (rev 14136) +++ core/trunk/documentation/manual/zh-CN/src/main/docbook/content/architecture.xml 2007-10-26 00:57:21 UTC (rev 14137) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="architecture"> +<chapter id="architecture"> <title>体系结构(Architecture)</title> <sect1 id="architecture-overview" revision="1"> Modified: core/trunk/documentation/manual/zh-CN/src/main/docbook/content/association_mapping.xml =================================================================== --- core/trunk/documentation/manual/zh-CN/src/main/docbook/content/association_mapping.xml 2007-10-26 00:48:48 UTC (rev 14136) +++ core/trunk/documentation/manual/zh-CN/src/main/docbook/content/association_mapping.xml 2007-10-26 00:57:21 UTC (rev 14137) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="associations"> +<chapter id="associations"> <title>关联关系映射</title> Modified: core/trunk/documentation/manual/zh-CN/src/main/docbook/content/basic_mapping.xml =================================================================== --- core/trunk/documentation/manual/zh-CN/src/main/docbook/content/basic_mapping.xml 2007-10-26 00:48:48 UTC (rev 14136) +++ core/trunk/documentation/manual/zh-CN/src/main/docbook/content/basic_mapping.xml 2007-10-26 00:57:21 UTC (rev 14137) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="mapping"> +<chapter id="mapping"> <title>对象/关系数据库映射基础(Basic O/R Mapping)</title> <sect1 id="mapping-declaration" revision="1"> @@ -857,6 +857,171 @@ </sect3> </sect2> + <sect2 id="mapping-declaration-id-enhanced"> + <title>Enhanced identifier generators</title> + + <para> + Starting with release 3.2.3, there are 2 new generators which represent a re-thinking of 2 different + aspects of identifier generation. The first aspect is database portability; the second is optimization + (not having to query the database for every request for a new identifier value). These two new + generators are intended to take the place of some of the named generators described above (starting + in 3.3.x); however, they are included in the current releases and can be referenced by FQN. + </para> + + <para> + The first of these new generators is <literal>org.hibernate.id.enhanced.SequenceStyleGenerator</literal> + which is intended firstly as a replacement for the <literal>sequence</literal> generator and secondly as + a better portability generator than <literal>native</literal> (because <literal>native</literal> + (generally) chooses between <literal>identity</literal> and <literal>sequence</literal> which have + largely different semantics which can cause subtle isssues in applications eyeing portability). + <literal>org.hibernate.id.enhanced.SequenceStyleGenerator</literal> however achieves portability in + a different manner. It chooses between using a table or a sequence in the database to store its + incrementing values depending on the capabilities of the dialect being used. The difference between this + and <literal>native</literal> is that table-based and sequence-based storage have the same exact + semantic (in fact sequences are exactly what Hibernate tries to emmulate with its table-based + generators). This generator has a number of configuration parameters: + <itemizedlist spacing="compact"> + <listitem> + <para> + <literal>sequence_name</literal> (optional, defaults to <literal>hibernate_sequence</literal>): + The name of the sequence (or table) to be used. + </para> + </listitem> + <listitem> + <para> + <literal>initial_value</literal> (optional, defaults to <literal>1</literal>): The initial + value to be retrieved from the sequence/table. In sequence creation terms, this is analogous + to the clause typical named "STARTS WITH". + </para> + </listitem> + <listitem> + <para> + <literal>increment_size</literal> (optional, defaults to <literal>1</literal>): The value by + which subsequent calls to the sequence/table should differ. In sequence creation terms, this + is analogous to the clause typical named "INCREMENT BY". + </para> + </listitem> + <listitem> + <para> + <literal>force_table_use</literal> (optional, defaults to <literal>false</literal>): Should + we force the use of a table as the backing structure even though the dialect might support + sequence? + </para> + </listitem> + <listitem> + <para> + <literal>value_column</literal> (optional, defaults to <literal>next_val</literal>): Only + relevant for table structures! The name of the column on the table which is used to + hold the value. + </para> + </listitem> + <listitem> + <para> + <literal>optimizer</literal> (optional, defaults to <literal>none</literal>): + See <xref linkend="mapping-declaration-id-enhanced-optimizers"/> + </para> + </listitem> + </itemizedlist> + </para> + <para> + The second of these new generators is <literal>org.hibernate.id.enhanced.TableGenerator</literal> which + is intended firstly as a replacement for the <literal>table</literal> generator (although it actually + functions much more like <literal>org.hibernate.id.MultipleHiLoPerTableGenerator</literal>) and secondly + as a re-implementation of <literal>org.hibernate.id.MultipleHiLoPerTableGenerator</literal> utilizing the + notion of pluggable optimiziers. Essentially this generator defines a table capable of holding + a number of different increment values simultaneously by using multiple distinctly keyed rows. This + generator has a number of configuration parameters: + <itemizedlist spacing="compact"> + <listitem> + <para> + <literal>table_name</literal> (optional, defaults to <literal>hibernate_sequences</literal>): + The name of the table to be used. + </para> + </listitem> + <listitem> + <para> + <literal>value_column_name</literal> (optional, defaults to <literal>next_val</literal>): + The name of the column on the table which is used to hold the value. + </para> + </listitem> + <listitem> + <para> + <literal>segment_column_name</literal> (optional, defaults to <literal>sequence_name</literal>): + The name of the column on the table which is used to hold the "segement key". This is the + value which distinctly identifies which increment value to use. + </para> + </listitem> + <listitem> + <para> + <literal>segment_value</literal> (optional, defaults to <literal>default</literal>): + The "segment key" value for the segment from which we want to pull increment values for + this generator. + </para> + </listitem> + <listitem> + <para> + <literal>segment_value_length</literal> (optional, defaults to <literal>255</literal>): + Used for schema generation; the column size to create this segment key column. + </para> + </listitem> + <listitem> + <para> + <literal>initial_value</literal> (optional, defaults to <literal>1</literal>): + The initial value to be retrieved from the table. + </para> + </listitem> + <listitem> + <para> + <literal>increment_size</literal> (optional, defaults to <literal>1</literal>): + The value by which subsequent calls to the table should differ. + </para> + </listitem> + <listitem> + <para> + <literal>optimizer</literal> (optional, defaults to <literal></literal>): + See <xref linkend="mapping-declaration-id-enhanced-optimizers"/> + </para> + </listitem> + </itemizedlist> + </para> + </sect2> + + <sect2 id="mapping-declaration-id-enhanced-optimizers"> + <title>Identifier generator optimization</title> + <para> + For identifier generators which store values in the database, it is inefficient for them to hit the + database on each and every call to generate a new identifier value. Instead, you'd ideally want to + group a bunch of them in memory and only hit the database when you have exhausted your in-memory + value group. This is the role of the pluggable optimizers. Currently only the two enhanced generators + (<xref linkend="mapping-declaration-id-enhanced"/> support this notion. + <itemizedlist spacing="compact"> + <listitem> + <para> + <literal>none</literal> (generally this is the default if no optimizer was specified): This + says to not perform any optimizations, and hit the database each and every request. + </para> + </listitem> + <listitem> + <para> + <literal>hilo</literal>: applies a hi/lo algorithm around the database retrieved values. The + values from the database for this optimizer are expected to be sequential. The values + retrieved from the database structure for this optimizer indicates the "group number"; the + <literal>increment_size</literal> is multiplied by that value in memory to define a group + "hi value". + </para> + </listitem> + <listitem> + <para> + <literal>pooled</literal>: like was discussed for <literal>hilo</literal>, this optimizers + attempts to minimize the number of hits to the database. Here, however, we simply store + the starting value for the "next group" into the database structure rather than a sequential + value in combination with an in-memory grouping algorithm. <literal>increment_size</literal> + here refers to the values coming from the database. + </para> + </listitem> + </itemizedlist> + </para> + </sect2> <sect2 id="mapping-declaration-compositeid" revision="3"> <title>composite-id</title> Modified: core/trunk/documentation/manual/zh-CN/src/main/docbook/content/batch.xml =================================================================== --- core/trunk/documentation/manual/zh-CN/src/main/docbook/content/batch.xml 2007-10-26 00:48:48 UTC (rev 14136) +++ core/trunk/documentation/manual/zh-CN/src/main/docbook/content/batch.xml 2007-10-26 00:57:21 UTC (rev 14137) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="batch"> +<chapter id="batch"> <title>批量处理（Batch processing）</title> <para> 使用Hibernate将 100 000 条记录插入到数据库的一个很自然的做法可能是这样的 Modified: core/trunk/documentation/manual/zh-CN/src/main/docbook/content/best_practices.xml =================================================================== --- core/trunk/documentation/manual/zh-CN/src/main/docbook/content/best_practices.xml 2007-10-26 00:48:48 UTC (rev 14136) +++ core/trunk/documentation/manual/zh-CN/src/main/docbook/content/best_practices.xml 2007-10-26 00:57:21 UTC (rev 14137) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="best-practices" revision="2"> +<chapter id="best-practices" revision="2"> <title>最佳实践(Best Practices)</title> <variablelist spacing="compact"> @@ -30,7 +30,6 @@ 对所有的实体都标识出自然键，用<literal><natural-id></literal>进行映射。实现<literal>equals()</literal>和<literal>hashCode()</literal>，在其中用组成自然键的属性进行比较。 </para> </listitem> - Y00008051221000980 2.7，89，100万 </varlistentry> <varlistentry> Modified: core/trunk/documentation/manual/zh-CN/src/main/docbook/content/collection_mapping.xml =================================================================== --- core/trunk/documentation/manual/zh-CN/src/main/docbook/content/collection_mapping.xml 2007-10-26 00:48:48 UTC (rev 14136) +++ core/trunk/documentation/manual/zh-CN/src/main/docbook/content/collection_mapping.xml 2007-10-26 00:57:21 UTC (rev 14137) @@ -1,21 +1,17 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> - <chapter id="collections"> +<chapter id="collections"> <title>集合类(Collections)映射</title> <sect1 id="collections-persistent" revision="3"> <title>持久化集合类(Persistent collections)</title> - <para id="collections-persistent-translate-comment"> - (译者注：在阅读本章的时候，以后整个手册的阅读过程中，我们都会面临一个名词方面的问题，那就是“集合”。"Collections"和"Set"在中文里对应都被翻译为“集合”，但是他们的含义很不一样。Collections是一个超集，Set是其中的一种。大部分情况下，本译稿中泛指的未加英文注明的“集合”，都应当理解为“Collections”。在有些二者同时出现，可能造成混淆的地方，我们用“集合类”来特指“Collecions”,“集合(Set)”来指"Set"，一般都会在后面的括号中给出英文。希望大家在阅读时联系上下文理解，不要造成误解。 - 与此同时，“元素”一词对应的英文“element”，也有两个不同的含义。其一为集合的元素，是内存中的一个变量；另一含义则是XML文档中的一个标签所代表的元素。也请注意区别。 - 本章中,特别是后半部分是需要反复阅读才能理解清楚的。如果遇到任何疑问,请记住,英文版本的reference是惟一标准的参考资料。) - </para> - <para> - Hibernate要求持久化集合值字段必须声明为接口，比如： + Hibernate要求持久化集合值字段必须声明为接口，比如：(译者注：在阅读本章的时候，以后整个手册的阅读过程中，我们都会面临一个名词方面的问题，那就是“集合”。"Collections"和"Set"在中文里对应都被翻译为“集合”，但是他们的含义很不一样。Collections是一个超集，Set是其中的一种。大部分情况下，本译稿中泛指的未加英文注明的“集合”，都应当理解为“Collections”。在有些二者同时出现，可能造成混淆的地方，我们用“集合类”来特指“Collecions”,“集合(Set)”来指"Set"，一般都会在后面的括号中给出英文。希望大家在阅读时联系上下文理解，不要造成误解。 + 与此同时，“元素”一词对应的英文“element”，也有两个不同的含义。其一为集合的元素，是内存中的一个变量；另一含义则是XML文档中的一个标签所代表的元素。也请注意区别。 + 本章中,特别是后半部分是需要反复阅读才能理解清楚的。如果遇到任何疑问,请记住,英文版本的reference是惟一标准的参考资料。) </para> <programlisting><![CDATA[public class Product { @@ -725,7 +721,7 @@ </class> <class name="Item"> - <id name="id" column="ITEM_ID"/> + <id name="id" column="ITEM_ID"/> ...  Modified: core/trunk/documentation/manual/zh-CN/src/main/docbook/content/component_mapping.xml =================================================================== --- core/trunk/documentation/manual/zh-CN/src/main/docbook/content/component_mapping.xml 2007-10-26 00:48:48 UTC (rev 14136) +++ core/trunk/documentation/manual/zh-CN/src/main/docbook/content/component_mapping.xml 2007-10-26 00:57:21 UTC (rev 14137) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="components"> +<chapter id="components"> <title>组件（Component）映射</title> <para> Modified: core/trunk/documentation/manual/zh-CN/src/main/docbook/content/configuration.xml =================================================================== --- core/trunk/documentation/manual/zh-CN/src/main/docbook/content/configuration.xml 2007-10-26 00:48:48 UTC (rev 14136) +++ core/trunk/documentation/manual/zh-CN/src/main/docbook/content/configuration.xml 2007-10-26 00:57:21 UTC (rev 14137) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="session-configuration" revision="1"> +<chapter id="session-configuration" revision="1"> <title> 配置 Modified: core/trunk/documentation/manual/zh-CN/src/main/docbook/content/events.xml =================================================================== --- core/trunk/documentation/manual/zh-CN/src/main/docbook/content/events.xml 2007-10-26 00:48:48 UTC (rev 14136) +++ core/trunk/documentation/manual/zh-CN/src/main/docbook/content/events.xml 2007-10-26 00:57:21 UTC (rev 14137) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="events"> +<chapter id="events"> <title> 拦截器与事件(Interceptors and events) </title> Modified: core/trunk/documentation/manual/zh-CN/src/main/docbook/content/example_mappings.xml =================================================================== --- core/trunk/documentation/manual/zh-CN/src/main/docbook/content/example_mappings.xml 2007-10-26 00:48:48 UTC (rev 14136) +++ core/trunk/documentation/manual/zh-CN/src/main/docbook/content/example_mappings.xml 2007-10-26 00:57:21 UTC (rev 14137) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="example-mappings"> +<chapter id="example-mappings"> <title>示例：复杂映射实例</title> <para> 本章展示了一些较为复杂的关系映射。 Modified: core/trunk/documentation/manual/zh-CN/src/main/docbook/content/example_parentchild.xml =================================================================== --- core/trunk/documentation/manual/zh-CN/src/main/docbook/content/example_parentchild.xml 2007-10-26 00:48:48 UTC (rev 14136) +++ core/trunk/documentation/manual/zh-CN/src/main/docbook/content/example_parentchild.xml 2007-10-26 00:57:21 UTC (rev 14137) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="example-parentchild"> +<chapter id="example-parentchild"> <title>示例：父子关系(Parent Child Relationships)</title> <para> 刚刚接触Hibernate的人大多是从父子关系（parent / child type relationship）的建模入手的。父子关系的建模有两种方法。由于种种原因，最方便的方法是把<literal>Parent</literal>和<literal>Child</literal>都建模成实体类，并创建一个从<literal>Parent</literal>指向<literal>Child</literal>的<one-to-many>关联，对新手来说尤其如此。还有一种方法，就是将<literal>Child</literal>声明为一个<literal><composite-element></literal>（组合元素）。事实上在Hibernate中one to many关联的默认语义远没有composite element贴近parent / child关系的通常语义。下面我们会阐述如何使用<emphasis>带有级联的双向一对多关联(bidirectional one to many association with cascades)</emphasis>去建立有效、优美的parent / child关系。这一点也不难！ @@ -223,14 +223,7 @@ session.update(parent); session.flush();]]></programlisting> - <para> - Well, that's all very well for the case of a generated identifier, but what about assigned identifiers - and composite identifiers? This is more difficult, since Hibernate can't use the identifier property to - distinguish between a newly instantiated object (with an identifier assigned by the user) and an - object loaded in a previous session. In this case, Hibernate will either use the timestamp or version - property, or will actually query the second-level cache or, worst case, the database, to see if the - row exists. - </para> + <para> 这对于自动生成标识的情况是非常好的，但是自分配的标识和复合标识怎么办呢？这是有点麻烦，因为Hibernate没有办法区分新实例化的对象（标识被用户指定了）和前一个Session装入的对象。在这种情况下，Hibernate会使用timestamp或version属性，或者查询第二级缓存，或者最坏的情况，查询数据库，来确认是否此行存在。</para> Modified: core/trunk/documentation/manual/zh-CN/src/main/docbook/content/example_weblog.xml =================================================================== --- core/trunk/documentation/manual/zh-CN/src/main/docbook/content/example_weblog.xml 2007-10-26 00:48:48 UTC (rev 14136) +++ core/trunk/documentation/manual/zh-CN/src/main/docbook/content/example_weblog.xml 2007-10-26 00:57:21 UTC (rev 14137) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="example-weblog"> +<chapter id="example-weblog"> <title>示例：Weblog 应用程序</title> <sect1 id="example-weblog-classes"> Modified: core/trunk/documentation/manual/zh-CN/src/main/docbook/content/filters.xml =================================================================== --- core/trunk/documentation/manual/zh-CN/src/main/docbook/content/filters.xml 2007-10-26 00:48:48 UTC (rev 14136) +++ core/trunk/documentation/manual/zh-CN/src/main/docbook/content/filters.xml 2007-10-26 00:57:21 UTC (rev 14137) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="filters"> +<chapter id="filters"> <title>过滤数据</title> <para> Modified: core/trunk/documentation/manual/zh-CN/src/main/docbook/content/inheritance_mapping.xml =================================================================== --- core/trunk/documentation/manual/zh-CN/src/main/docbook/content/inheritance_mapping.xml 2007-10-26 00:48:48 UTC (rev 14136) +++ core/trunk/documentation/manual/zh-CN/src/main/docbook/content/inheritance_mapping.xml 2007-10-26 00:57:21 UTC (rev 14137) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> - <chapter id="inheritance"> +<chapter id="inheritance"> <title>继承映射(Inheritance Mappings)</title> <sect1 id="inheritance-strategies" revision="3"> @@ -266,7 +266,7 @@ </sect2> <sect2 id="inheritance-tableperconcreate-polymorphism"> - <title>Table per concrete class, using implicit polymorphism</title> + <title>每个具体类一张表，使用隐式多态</title> <para> Modified: core/trunk/documentation/manual/zh-CN/src/main/docbook/content/performance.xml =================================================================== --- core/trunk/documentation/manual/zh-CN/src/main/docbook/content/performance.xml 2007-10-26 00:48:48 UTC (rev 14136) +++ core/trunk/documentation/manual/zh-CN/src/main/docbook/content/performance.xml 2007-10-26 00:57:21 UTC (rev 14137) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="performance"> +<chapter id="performance"> <title>提升性能 </title> <sect1 id="performance-fetching" revision="2"> @@ -609,7 +609,7 @@ <entry>OSCache</entry> <entry><literal>org.hibernate.cache.OSCacheProvider</literal></entry> <entry>memory, disk</entry> - <entry>yes (clustered invalidation)</entry> + <entry></entry> <entry>yes</entry> </row> <row> Modified: core/trunk/documentation/manual/zh-CN/src/main/docbook/content/persistent_classes.xml =================================================================== --- core/trunk/documentation/manual/zh-CN/src/main/docbook/content/persistent_classes.xml 2007-10-26 00:48:48 UTC (rev 14136) +++ core/trunk/documentation/manual/zh-CN/src/main/docbook/content/persistent_classes.xml 2007-10-26 00:57:21 UTC (rev 14137) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="persistent-classes" revision="2"> +<chapter id="persistent-classes" revision="2"> <title>持久化类(Persistent Classes)</title> <para> Modified: core/trunk/documentation/manual/zh-CN/src/main/docbook/content/query_criteria.xml =================================================================== --- core/trunk/documentation/manual/zh-CN/src/main/docbook/content/query_criteria.xml 2007-10-26 00:48:48 UTC (rev 14136) +++ core/trunk/documentation/manual/zh-CN/src/main/docbook/content/query_criteria.xml 2007-10-26 00:57:21 UTC (rev 14137) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="querycriteria"> +<chapter id="querycriteria"> <title> 条件查询(Criteria Queries) </title> Modified: core/trunk/documentation/manual/zh-CN/src/main/docbook/content/query_hql.xml =================================================================== --- core/trunk/documentation/manual/zh-CN/src/main/docbook/content/query_hql.xml 2007-10-26 00:48:48 UTC (rev 14136) +++ core/trunk/documentation/manual/zh-CN/src/main/docbook/content/query_hql.xml 2007-10-26 00:57:21 UTC (rev 14137) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="queryhql"> +<chapter id="queryhql"> <title>HQL: Hibernate查询语言</title> <para> Hibernate配备了一种非常强大的查询语言，这种语言看上去很像SQL。但是不要被语法结构 @@ -191,6 +191,42 @@ <programlisting><![CDATA[from Cat as cat where cat.mate.name like '%s%']]></programlisting> </sect1> + <sect1 id="queryhql-identifier-property"> + <title>Refering to identifier property</title> + + <para> + There are, generally speaking, 2 ways to refer to an entity's identifier property: + </para> + <itemizedlist spacing="compact"> + <listitem> + <para> + The special property (lowercase) <literal>id</literal> may be used to reference the identifier + property of an entity <emphasis>provided that entity does not define a non-identifier property + named id</emphasis>. + </para> + </listitem> + <listitem> + <para> + If the entity defines a named identifier property, you may use that property name. + </para> + </listitem> + </itemizedlist> + + <para> + References to composite identifier properties follow the same naming rules. If the + entity has a non-identifier property named id, the composite identifier property can only + be referenced by its defined named; otherwise, the special <literal>id</literal> property + can be used to rerference the identifier property. + </para> + + <para> + Note: this has changed significantly starting in version 3.2.2. In previous versions, + <literal>id</literal> <emphasis>always</emphasis> referred to the identifier property no + matter what its actual name. A ramification of that decision was that non-identifier + properties named <literal>id</literal> could never be referenced in Hibernate queries. + </para> + </sect1> + <sect1 id="queryhql-select"> <title>select子句</title> @@ -505,6 +541,11 @@ 逻辑运算符<literal>and, or, not</literal> </para> </listitem> + <listitem> + <para> + Parentheses <literal>( )</literal>, indicating grouping + </para> + </listitem> <listitem> <para> <literal>in</literal>, @@ -856,32 +897,11 @@ 注意，HQL自查询只可以在select或者where子句中出现。 </para> - <para> - 在select列表中包含一个表达式以上的子查询，你可以使用一个元组构造符（tuple constructors）： + <para> + Note that subqueries can also utilize <literal>row value constructor</literal> syntax. See + <xref linkend="queryhql-tuple"/> for more details. </para> - <programlisting><![CDATA[from Cat as cat -where not ( cat.name, cat.color ) in ( - select cat.name, cat.color from DomesticCat cat -)]]></programlisting> - - <para> - 注意在某些数据库中（不包括Oracle与HSQL），你也可以在其他语境中使用元组构造符， - 比如查询用户类型的组件与组合： - </para> - - <programlisting><![CDATA[from Person where name = ('Gavin', 'A', 'King')]]></programlisting> - - <para> - 该查询等价于更复杂的： - </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"> Modified: core/trunk/documentation/manual/zh-CN/src/main/docbook/content/query_sql.xml =================================================================== --- core/trunk/documentation/manual/zh-CN/src/main/docbook/content/query_sql.xml 2007-10-26 00:48:48 UTC (rev 14136) +++ core/trunk/documentation/manual/zh-CN/src/main/docbook/content/query_sql.xml 2007-10-26 00:57:21 UTC (rev 14137) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="querysql" revision="2"> +<chapter id="querysql" revision="2"> <title>Native SQL查询</title> <para> 你也可以使用你的数据库的Native SQL语言来查询数据。这对你在要使用数据库的某些特性的时候(比如说在查询提示或者Oracle中的 @@ -460,7 +460,7 @@ FROM PERSON person WHERE person.NAME LIKE :name </sql-query> ]]></programlisting> - <literal><return-property></literal>也可用于多个字段,它解决了使用<literal>{}</literal>-语法不能细粒度控制多个字段的限制 +<para><literal><return-property></literal>也可用于多个字段,它解决了使用<literal>{}</literal>-语法不能细粒度控制多个字段的限制</para> <programlisting><![CDATA[<sql-query name="organizationCurrentEmployments"> <return alias="emp" class="Employment"> <return-property name="salary"> Modified: core/trunk/documentation/manual/zh-CN/src/main/docbook/content/quickstart.xml =================================================================== --- core/trunk/documentation/manual/zh-CN/src/main/docbook/content/quickstart.xml 2007-10-26 00:48:48 UTC (rev 14136) +++ core/trunk/documentation/manual/zh-CN/src/main/docbook/content/quickstart.xml 2007-10-26 00:57:21 UTC (rev 14137) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="quickstart"> +<chapter id="quickstart"> <title>在Tomcat中快速上手</title> <sect1 id="quickstart-intro" revision="2"> Modified: core/trunk/documentation/manual/zh-CN/src/main/docbook/content/session_api.xml =================================================================== --- core/trunk/documentation/manual/zh-CN/src/main/docbook/content/session_api.xml 2007-10-26 00:48:48 UTC (rev 14136) +++ core/trunk/documentation/manual/zh-CN/src/main/docbook/content/session_api.xml 2007-10-26 00:57:21 UTC (rev 14137) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="objectstate"> +<chapter id="objectstate"> <title>与对象共事</title> @@ -85,7 +85,28 @@ 你也可以按照EJB3 early draft中定义的语义，使用<literal>persist()</literal>替代<literal>save()</literal>。 </para> - + <itemizedlist spacing="compact"> + <listitem> + <para> + <literal>persist()</literal> makes a transient instance persistent. + However, it doesn't guarantee that the identifier value will be assigned to + the persistent instance immediately, the assignment might happen at flush time. + <literal>persist()</literal> also guarantees that it will not execute an + <literal>INSERT</literal> statement if it is called outside of transaction + boundaries. This is useful in long-running conversations with an extended + Session/persistence context. + </para> + </listitem> + <listitem> + <para> + <literal>save()</literal> does guarantee to return an identifier. If an INSERT + has to be executed to get the identifier ( e.g. "identity" generator, not + "sequence"), this INSERT happens immediately, no matter if you are inside or + outside of a transaction. This is problematic in a long-running conversation + with an extended Session/persistence context. + </para> + </listitem> + </itemizedlist> <para> 此外，你可以用一个重载版本的<literal>save()</literal>方法。 </para> @@ -190,12 +211,13 @@ </sect1> <sect1 id="objectstate-querying" revision="1"> - <title>查询</title> - <para> - 如果不知道所要寻找的对象的持久化标识，那么你需要使用查询。Hibernate支持强大且易于使用的面向对象查询语言(HQL)。 - 如果希望通过编程的方式创建查询，Hibernate提供了完善的按条件(Query By Criteria, QBC)以及按样例(Query By Example, QBE)进行查询的功能。 + <title>查询</title> + + <para> + 如果不知道所要寻找的对象的持久化标识，那么你需要使用查询。Hibernate支持强大且易于使用的面向对象查询语言(HQL)。 + 如果希望通过编程的方式创建查询，Hibernate提供了完善的按条件(Query By Criteria, QBC)以及按样例(Query By Example, QBE)进行查询的功能。你也可以用原生SQL(native SQL)描述查询，Hibernate额外提供了将结果集(result set)转化为对象的支持。 - </para> + </para> <sect2 id="objectstate-querying-executing" revision="1"> <title>执行查询</title> @@ -277,8 +299,8 @@ while ( kittensAndMothers.hasNext() ) { Object[] tuple = (Object[]) kittensAndMothers.next(); - Cat kitten = (Cat) tuple[0]; - Cat mother = (Cat) tuple[1]; + Cat kitten = (Cat) tuple[0]; + Cat mother = (Cat) tuple[1]; .... }]]></programlisting> @@ -520,16 +542,16 @@ 如果你选择使用Hibernate的API, 你必须把SQL别名用大括号包围起来: </para> - <programlisting><![CDATA[List cats = session.createSQLQuery("SELECT {cat.*} FROM CAT {cat} WHERE ROWNUM<10") - .addEntity("cat", Cat.class) -.list();]]></programlisting> - - <programlisting><![CDATA[List cats = session.createSQLQuery( - "SELECT {cat}.ID AS {cat.id}, {cat}.SEX AS {cat.sex}, " + - "{cat}.MATE AS {cat.mate}, {cat}.SUBCLASS AS {cat.class}, ... " + - "FROM CAT {cat} WHERE ROWNUM<10") - .addEntity("cat", Cat.class) -.list()]]></programlisting> + <programlisting><![CDATA[List cats = session.createSQLQuery("SELECT {cat.*} FROM CAT {cat} WHERE ROWNUM<10") + .addEntity("cat", Cat.class) +.list();]]></programlisting> + + <programlisting><![CDATA[List cats = session.createSQLQuery( + "SELECT {cat}.ID AS {cat.id}, {cat}.SEX AS {cat.sex}, " + + "{cat}.MATE AS {cat.mate}, {cat}.SUBCLASS AS {cat.class}, ... " + + "FROM CAT {cat} WHERE ROWNUM<10") + .addEntity("cat", Cat.class) +.list()]]></programlisting> <para> 和Hibernate查询一样，SQL查询也可以包含命名参数和占位参数。 Modified: core/trunk/documentation/manual/zh-CN/src/main/docbook/content/toolset_guide.xml =================================================================== --- core/trunk/documentation/manual/zh-CN/src/main/docbook/content/toolset_guide.xml 2007-10-26 00:48:48 UTC (rev 14136) +++ core/trunk/documentation/manual/zh-CN/src/main/docbook/content/toolset_guide.xml 2007-10-26 00:57:21 UTC (rev 14137) @@ -185,12 +185,6 @@ <entry><literal>foreign-key</literal></entry> <entry><literal>foreign_key_name</literal></entry> <entry> - specifies the name of the foreign key constraint generated - for an association, for a <literal><one-to-one></literal>, - <literal><many-to-one></literal>, <literal><key></literal>, - or <literal><many-to-many></literal> mapping element. Note that - <literal>inverse="true"</literal> sides will not be considered - by <literal>SchemaExport</literal>. 指明一个外键的名字，它是为关联生成的，或者<literal><one-to-one></literal>，<literal><many-to-one></literal>, <literal><key></literal>, 或者<literal><many-to-many></literal>映射元素。注意<literal>inverse="true"</literal>在<literal>SchemaExport</literal>时会被忽略。 </entry> Modified: core/trunk/documentation/manual/zh-CN/src/main/docbook/content/transactions.xml =================================================================== --- core/trunk/documentation/manual/zh-CN/src/main/docbook/content/transactions.xml 2007-10-26 00:48:48 UTC (rev 14136) +++ core/trunk/documentation/manual/zh-CN/src/main/docbook/content/transactions.xml 2007-10-26 00:57:21 UTC (rev 14137) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="transactions" revision="2"> +<chapter id="transactions" revision="2"> <title>事务和并发</title> <para> Hibernate的事务和并发控制很容易掌握。Hibernate直接使用JDBC连接和JTA资源，不添加任何附加锁定 Modified: core/trunk/documentation/manual/zh-CN/src/main/docbook/content/tutorial.xml =================================================================== --- core/trunk/documentation/manual/zh-CN/src/main/docbook/content/tutorial.xml 2007-10-26 00:48:48 UTC (rev 14136) +++ core/trunk/documentation/manual/zh-CN/src/main/docbook/content/tutorial.xml 2007-10-26 00:57:21 UTC (rev 14137) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="tutorial"> +<chapter id="tutorial"> <title> Hibernate入门 </title> Modified: core/trunk/documentation/manual/zh-CN/src/main/docbook/content/xml.xml =================================================================== --- core/trunk/documentation/manual/zh-CN/src/main/docbook/content/xml.xml 2007-10-26 00:48:48 UTC (rev 14136) +++ core/trunk/documentation/manual/zh-CN/src/main/docbook/content/xml.xml 2007-10-26 00:57:21 UTC (rev 14137) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="xml"> +<chapter id="xml"> <title>XML映射</title> <para><emphasis> 注意这是Hibernate 3.0的一个实验性的特性。这一特性仍在积极开发中。

18 years, 3 months

1
0
0 / 0

Hibernate SVN: r14136 - core/trunk/documentation/manual/pt-BR/src/main/docbook/content.

by hibernate-commits＠lists.jboss.org

Author: xhuang(a)jboss.com Date: 2007-10-25 20:48:48 -0400 (Thu, 25 Oct 2007) New Revision: 14136 Modified: core/trunk/documentation/manual/pt-BR/src/main/docbook/content/association_mapping.xml core/trunk/documentation/manual/pt-BR/src/main/docbook/content/basic_mapping.xml core/trunk/documentation/manual/pt-BR/src/main/docbook/content/batch.xml core/trunk/documentation/manual/pt-BR/src/main/docbook/content/best_practices.xml core/trunk/documentation/manual/pt-BR/src/main/docbook/content/collection_mapping.xml core/trunk/documentation/manual/pt-BR/src/main/docbook/content/component_mapping.xml core/trunk/documentation/manual/pt-BR/src/main/docbook/content/configuration.xml core/trunk/documentation/manual/pt-BR/src/main/docbook/content/events.xml core/trunk/documentation/manual/pt-BR/src/main/docbook/content/example_mappings.xml core/trunk/documentation/manual/pt-BR/src/main/docbook/content/example_parentchild.xml core/trunk/documentation/manual/pt-BR/src/main/docbook/content/example_weblog.xml core/trunk/documentation/manual/pt-BR/src/main/docbook/content/filters.xml core/trunk/documentation/manual/pt-BR/src/main/docbook/content/inheritance_mapping.xml core/trunk/documentation/manual/pt-BR/src/main/docbook/content/performance.xml core/trunk/documentation/manual/pt-BR/src/main/docbook/content/persistent_classes.xml core/trunk/documentation/manual/pt-BR/src/main/docbook/content/preface.xml core/trunk/documentation/manual/pt-BR/src/main/docbook/content/query_criteria.xml core/trunk/documentation/manual/pt-BR/src/main/docbook/content/query_hql.xml core/trunk/documentation/manual/pt-BR/src/main/docbook/content/query_sql.xml core/trunk/documentation/manual/pt-BR/src/main/docbook/content/session_api.xml core/trunk/documentation/manual/pt-BR/src/main/docbook/content/toolset_guide.xml core/trunk/documentation/manual/pt-BR/src/main/docbook/content/transactions.xml core/trunk/documentation/manual/pt-BR/src/main/docbook/content/tutorial.xml core/trunk/documentation/manual/pt-BR/src/main/docbook/content/xml.xml Log: Remove ^M characters, match with latest English XML Modified: core/trunk/documentation/manual/pt-BR/src/main/docbook/content/association_mapping.xml =================================================================== --- core/trunk/documentation/manual/pt-BR/src/main/docbook/content/association_mapping.xml 2007-10-26 00:46:38 UTC (rev 14135) +++ core/trunk/documentation/manual/pt-BR/src/main/docbook/content/association_mapping.xml 2007-10-26 00:48:48 UTC (rev 14136) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="associations"> +<chapter id="associations"> <title>Mapeamento de Associações</title> Modified: core/trunk/documentation/manual/pt-BR/src/main/docbook/content/basic_mapping.xml =================================================================== --- core/trunk/documentation/manual/pt-BR/src/main/docbook/content/basic_mapping.xml 2007-10-26 00:46:38 UTC (rev 14135) +++ core/trunk/documentation/manual/pt-BR/src/main/docbook/content/basic_mapping.xml 2007-10-26 00:48:48 UTC (rev 14136) @@ -1,3494 +1,3660 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="mapping"> - <title>Mapeamento O/R Bassico</title> - - <sect1 id="mapping-declaration" revision="1"> - <title>Declaração de mapeamento</title> - - <para> - Object/relational mappings are usually defined in an XML document. The mapping - document is designed to be readable and hand-editable. The mapping language is - Java-centric, meaning that mappings are constructed around persistent class - declarations, not table declarations. - </para> - - <para> - Note that, even though many Hibernate users choose to write the XML by hand, - a number of tools exist to generate the mapping document, including XDoclet, - Middlegen and AndroMDA. - </para> - - <para> - Lets kick off with an example mapping: - </para> - - <programlisting id="mapping-declaration-ex1" revision="1"><![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"> - -<hibernate-mapping package="eg"> - - <class name="Cat" - table="cats" - discriminator-value="C"> - - <id name="id"> - <generator class="native"/> - </id> - - <discriminator column="subclass" - type="character"/> - - <property name="weight"/> - - <property name="birthdate" - type="date" - not-null="true" - update="false"/> - - <property name="color" - type="eg.types.ColorUserType" - not-null="true" - update="false"/> - - <property name="sex" - not-null="true" - update="false"/> - - <property name="litterId" - column="litterId" - update="false"/> - - <many-to-one name="mother" - column="mother_id" - update="false"/> - - <set name="kittens" - inverse="true" - order-by="litter_id"> - <key column="mother_id"/> - <one-to-many class="Cat"/> - </set> - - <subclass name="DomesticCat" - discriminator-value="D"> - - <property name="name" - type="string"/> - - </subclass> - - </class> - - <class name="Dog"> -  - </class> - -</hibernate-mapping>]]></programlisting> - - <para> - Discutir agora o conteúdo deste documento de mapeamento. Iremos apenas descrever - os elementos do documento e atributos que são utilizados pelo Hibernate em tempo - de execução. O documento de mapeamento também contém alguns atributos adicionais - e opcionais além de elementos que afetam os esquemas de banco de dados exportados - pela ferramenta de exportação de esquemas. (Por exemplo, o atributo - <literal>not-null</literal>). - </para> - - - - <sect2 id="mapping-declaration-doctype" revision="3"> - <title>Doctype</title> - - <para> - Todos os mapeamentos de XML devem declarar o doctype exibido. O DTD atual pode - ser encontrado na URL abaixo, no diretório <literal>hibernate-x.x.x/src/org/ - hibernate </literal> ou no <literal>hibernate3.jar</literal>. O Hibernate sempre - irá procurar pelo DTD inicialmente no seu classpath. Se você tentar localizar - o DTD usando uma conexão de internet, compare a declaração do seu DTD com o - conteúdo do seu classpath - </para> - - <sect3 id="mapping-declaration-entity-resolution"> - <title>EntityResolver</title> - <para> - As mentioned previously, Hibernate will first attempt to resolve DTDs in its classpath. The - manner in which it does this is by registering a custom <literal>org.xml.sax.EntityResolver</literal> - implementation with the SAXReader it uses to read in the xml files. This custom - <literal>EntityResolver</literal> recognizes two different systemId namespaces. - </para> - <itemizedlist> - <listitem> - <para> - a <literal>hibernate namespace</literal> is recognized whenever the - resolver encounteres a systemId starting with - <literal>http://hibernate.sourceforge.net/</literal>; the resolver - attempts to resolve these entities via the classlaoder which loaded - the Hibernate classes. - </para> - </listitem> - <listitem> - <para> - a <literal>user namespace</literal> is recognized whenever the - resolver encounteres a systemId using a <literal>classpath://</literal> - URL protocol; the resolver will attempt to resolve these entities - via (1) the current thread context classloader and (2) the - classloader which loaded the Hibernate classes. - </para> - </listitem> - </itemizedlist> - <para> - An example of utilizing 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> - Where <literal>types.xml</literal> is a resource in the <literal>your.domain</literal> - package and contains a custom <xref linkend="mapping-types-custom">typedef</xref>. - </para> - </sect3> - </sect2> - - <sect2 id="mapping-declaration-mapping" revision="3"> - <title>hibernate-mapping</title> - - <para> - Este elemento tem diversos atributos opcionais. Os atributos - <literal>schema</literal> e <literal>catalog</literal> especificam que tabelas - referenciadas neste mapeamento pertencem ao esquema e/ou ao catalogo nomeado. - Se especificados, os nomes das tabelas irão ser qualificados no schema ou catalog dado. - Se não, os nomes das tabelas não serão qualificados. O atributo <literal>default-cascade - </literal> especifica qual estilo de cascata será assumido pelas propriedades e - coleções que não especificarm um atributo <literal>cascade</literal>. O atributo - <literal>auto-import</literal> nos deixa utilizar nomes de classes não qualificados - na linguagem de consulta, por default. - </para> - - <programlistingco> - <areaspec> - <area id="hm1" coords="2 55"/> - <area id="hm2" coords="3 55"/> - <area id="hm3" coords="4 55"/> - <area id="hm4" coords="5 55"/> - <area id="hm5" coords="6 55"/> - <area id="hm6" coords="7 55"/> - <area id="hm7" coords="8 55"/> - </areaspec> - <programlisting><![CDATA[<hibernate-mapping - schema="schemaName" - catalog="catalogName" - default-cascade="cascade_style" - default-access="field|property|ClassName" - default-lazy="true|false" - auto-import="true|false" - package="package.name" - />]]></programlisting> - <calloutlist> - <callout arearefs="hm1"> - <para> - <literal>schema</literal> (opcional): O nome do esquema do banco de dados. - </para> - </callout> - <callout arearefs="hm2"> - <para> - <literal>catalog</literal> (opcional): O nome do catálogo do banco de dados. - </para> - </callout> - <callout arearefs="hm3"> - <para> - <literal>default-cascade</literal> (opcional – default é <literal>nenhum - </literal>): Um estilo cascata default. - </para> - </callout> - <callout arearefs="hm4"> - <para> - <literal>default-access</literal> (opcional – default é <literal>property</literal>): - A estratégia que o Hibernate deve utilizar para acessar todas as propridades. Pode - ser uma implementação própria de <literal>PropertyAccessor</literal>. - </para> - </callout> - <callout arearefs="hm5"> - <para> - <literal>default-lazy</literal> (opcional - default é <literal>true</literal>): - O valor default para atributos <literal>lazy</literal> da classe e dos - mapeamentos de coleções. - </para> - </callout> - <callout arearefs="hm6"> - <para> - <literal>auto-import</literal> ((opcional - default é <literal>true</literal>): - Especifica se nós podemos usar nomes de classess não qualificados - (das classes deste mapeamento) na linguagem de consulta. - </para> - </callout> - <callout arearefs="hm7"> - <para> - <literal>package</literal> (opcional): Especifica um prefixo da package para - assumir para nomes de classes não qualificadas no documento de mapeamento. - </para> - </callout> - </calloutlist> - </programlistingco> - - <para> - Se voce tem duas classes persistentes com o mesmo nome (não qualificadas), você deve - setar <literal>auto-import="false"</literal>. O Hibernate irá gerar uma exceção se - você tentar setar duas classes para o mesmo nome "importado". - </para> - - <para> - Observe que o elemento <literal>hibernate-mapping</literal> permite a você - aninhar diversos mapeamentos de <literal><class></literal> persistentes, - como mostrado abaixo. Entretanto, é uma boa prática (e esperado por algumas - ferramentas)o mapeamento de apenas uma classe persistente simples (ou uma - hierarquia de classes simples) em um arquivo de mapeamento e nomea-la após - a superclasse persistente, por exemplo: <literal>Cat.hbm.xml</literal>, - <literal>Dog.hbm.xml</literal>, ou se estiver usando herança, - <literal>Animal.hbm.xml</literal>. - </para> - - </sect2> - - <sect2 id="mapping-declaration-class" revision="3"> - <title>class</title> - - <para> - Você pode declarar uma classe persistente utilizando o elemento - <literal>class</literal>: - </para> - - <programlistingco> - <areaspec> - <area id="class1" coords="2 55"/> - <area id="class2" coords="3 55" /> - <area id="class3" coords="4 55"/> - <area id="class4" coords="5 55" /> - <area id="class5" coords="6 55"/> - <area id="class6" coords="7 55" /> - <area id="class7" coords="8 55"/> - <area id="class8" coords="9 55" /> - <area id="class9" coords="10 55" /> - <area id="class10" coords="11 55"/> - <area id="class11" coords="12 55"/> - <area id="class12" coords="13 55"/> - <area id="class13" coords="14 55"/> - <area id="class14" coords="15 55"/> - <area id="class15" coords="16 55"/> - <area id="class16" coords="17 55"/> - <area id="class17" coords="18 55"/> - <area id="class18" coords="19 55"/> - <area id="class19" coords="20 55"/> - <area id="class20" coords="21 55"/> - <area id="class21" coords="22 55"/> - </areaspec> - <programlisting><![CDATA[<class - name="ClassName" - table="tableName" - discriminator-value="discriminator_value" - mutable="true|false" - schema="owner" - catalog="catalog" - proxy="ProxyInterface" - dynamic-update="true|false" - dynamic-insert="true|false" - select-before-update="true|false" - polymorphism="implicit|explicit" - where="arbitrary sql where condition" - persister="PersisterClass" - batch-size="N" - optimistic-lock="none|version|dirty|all" - lazy="true|false" - entity-name="EntityName" - check="arbitrary sql check condition" - rowid="rowid" - subselect="SQL expression" - abstract="true|false" - node="element-name" -/>]]></programlisting> - <calloutlist> - <callout arearefs="class1"> - <para> - <literal>name</literal> (opcional): O nome da classe Java inteiramente qualificado - da classe persistente (ou interface); Se o atributo é ausente, assume-se que o - mapeamento é para intidades não-POJO. - </para> - </callout> - <callout arearefs="class2"> - <para> - <literal>table</literal> (opcional – default para nomes de classes não - qualificadas) O nome da sua tabela do banco de dados. - </para> - </callout> - <callout arearefs="class3"> - <para> - <literal>discriminator-value</literal> (opcional – default para o nome da classe): - Um valor que distingue subclasses individuais, usadas para o comportamento polimorfico. - Valores aceitos incluem <literal>null</literal> e <literal>not null</literal> - </para> - </callout> - <callout arearefs="class4"> - <para> - <literal>mutable</literal> (opcional - valor default <literal>true</literal>): - Especifica que instancias da classe são (ou não) mutáveis - </para> - </callout> - <callout arearefs="class5"> - <para> - <literal>schema</literal> (opcional): Sobrepõe o nome do esquema especificado - pelo elemento root <literal><hibernate-mapping></literal>. - </para> - </callout> - <callout arearefs="class6"> - <para> - <literal>catalog</literal> (opcional): Sobrepõe o nome do catálogo especificado - pelo elemento root <literal><hibernate-mapping></literal>. - </para> - </callout> - <callout arearefs="class7"> - <para> - <literal>proxy</literal> (opcional): Especifica um interface para ser - utilizada pelos proxies de inicialização tardia. Você pode especificar o - nome da própria classe. - </para> - </callout> - <callout arearefs="class8"> - <para> - <literal>dynamic-update</literal> (opcional, valor default <literal>false</literal>): - Especifica que o SQL de <literal>UPDATE</literal> deve ser gerado em tempo de - execução e conter apenas aquelas colunas cujos valores foram alterados. - </para> - </callout> - <callout arearefs="class9"> - <para> - <literal>dynamic-insert</literal> (opcional, valor default <literal>false</literal>): - Especifica que o SQL de <literal>INSERT</literal> deve ser gerado em tempo de - execução e conter apenas aquelas colunas cujos valores não estão nulos. - </para> - </callout> - <callout arearefs="class10"> - <para> - <literal>select-before-update</literal> (opcional, valor default <literal>false</literal>): - Especifica que o Hibernate <emphasis>never</emphasis> deve executar um SQL de - <literal>UPDATE</literal> a não ser que com certeza um objeto está atualmente modificado. - Em certos casos (atualmente, apenas quando um objeto transiente foi associado com uma nova - sessão utilizando <literal>update()</literal>), isto significa que o Hibernate ira executar - uma instrução SQL de <literal>SELECT</literal> adicional para determinar se um - <literal>UPDATE</literal> é necessário nesse momento. - </para> - </callout> - <callout arearefs="class11"> - <para> - <literal>polymorphism</literal> (opcional, default para <literal>implicit</literal>): - Determina se deve ser utilizado a query polimorfica implicita ou explicitamente. - </para> - </callout> - <callout arearefs="class12"> - <para> - <literal>where</literal> (opicional) especifica um comando SQL <literal>WHERE</literal> - arbitrário para ser usado quando da recuperação de objetos desta classe. - </para> - </callout> - <callout arearefs="class13"> - <para> - <literal>persister</literal> (opcional): Espeicifca uma <literal>ClassPersister</literal> - customizada. - </para> - </callout> - <callout arearefs="class14"> - <para> - <literal>batch-size</literal> (opcional, valor default <literal>1</literal>) especifica um - "tamanho de lote" para a recuperação de instancias desta classe pelo identificador. - </para> - </callout> - <callout arearefs="class15"> - <para> - <literal>optimistic-lock</literal> (octional, valor default <literal>version</literal>): - Determina a estratégia de bloqueio. - </para> - </callout> - <callout arearefs="class16"> - <para> - <literal>lazy</literal> (opcional): A recuperação tardia pode ser completamente - desabilitada, setando <literal>lazy="false"</literal>. - </para> - </callout> - <callout arearefs="class17"> - <para> - <literal>entity-name</literal> (opcional, default para o nome da classe): O - Hibernate3 permite uma classe ser mapeada multiplas vezes, (potencialmente,para - diferentes tabelas), e permite mapeamentos de entidades que são representadas - por Maps ou XML no nível Java. Nestes casos, você deve especificar um nome - arbitrário explicitamente para a entidade. Veja <xref linkend="persistent-classes-dynamicmodels"/> - e <xref linkend="xml"/> para maiores informações. - </para> - </callout> - <callout arearefs="class18"> - <para> - <literal>check</literal> (opcional): Uma expressão SQL utilizada para gerar uma - constraint de <emphasis>verificação</emphasis> de múltiplas linhas para a geração - automática do esquema. - </para> - </callout> - <callout arearefs="class19"> - <para> - <literal>rowid</literal> (opcional): O Hibernate poder usar as assim chamadas - ROWIDs em bancos de dados que a suportam. Por exemplo, no Oracle, o Hibernate - pode utilizar a coluna extra rowid para atualizações mais rápidas se você - configurar esta opção para <literal>rowid</literal>. Um ROWID é uma implementação - que representa de maneira detalhada a localização física de uma determinada - tupla armazenado. - </para> - </callout> - <callout arearefs="class20"> - <para> - <literal>subselect</literal> (optional): Maps an immutable and read-only entity - to a database subselect. Useful if you want to have a view instead of a base table, - but don't. See below for more information. - <literal>subselect</literal> (opcional): Mapeia uma entidade imutavel e somente - de leitura para um subconjunto do banco de dados. Útil se você quiser ter uma - view em vez de uma tabela. Veja abaixo para mais informações. - </para> - </callout> - <callout arearefs="class21"> - <para> - <literal>abstract</literal> (opcional): Utilizada para marcar superclasses - abstratas em hierarquias <literal><union-subclass></literal>. - </para> - </callout> - </calloutlist> - </programlistingco> - - <para> - É perfeitamente aceitável para uma classe persitente nomeada ser uma interface. Você deverá - então declarar as classes implementadas desta interface utilizando o elemento - <literal><subclass></literal>. Você pode persistir qualquer classe de aninhada - <emphasis>estatica</emphasis>. Você deverá especificar o nome da classe usando a forma - padrão, por exemplo: <literal>eg.Foo$Bar</literal>. - </para> - - <para> - Classes imutáveis, <literal>mutable="false"</literal>, não podem ser modificadas ou excluídas - pela aplicação. Isso permite ao Hibernate fazer alguns aperfeiçoamentos de performance. - </para> - - <para> - O atributo opcional <literal>proxy</literal> habilita a inicialização tardia das - instâncias persistentes da classe. O Hibernate irá retornar CGLIB proxies como implementado - na interface nomeada. O objeto persistente atual será carregado quando um método do proxy - for invocado. Veja "Inicializando coleções e proxies" abaixo. - </para> - - <para>Polimorfismo <emphasis>implícito</emphasis> significa que instâncias de uma classe - serão retornada por uma query que dá nome a qualquer superclasse ou interface implementada, - ou a classe e as instancias de qualquer subclasse da classe será retornada por umq query - que nomeia a classe por si. Polimorfismo <emphasis>explícito</emphasis> significa que - instancias da classe serão retornadas apenas por queries que explicitamente nomeiam a - classe e que queries que nomeiam as classes irão retornar apenas instancias de subclasses - mapeadas dentro da declaração <literal><class></literal> como uma - <literal><subclass></literal> ou <literal><joined-subclass></literal>. - Para a maioria dos casos, o valor default <literal>polymorphism="implicit"</literal>, - é apropriado. Polimorfismo explicito é útil quando duas classes distintas estão mapeadas - para a mesma tabela (isso permite um classe "peso leve" que contem um subconjunto - de colunas da tabela). - </para> - - <para> - O atributo <literal>persister</literal> deixa você customizar a estratégia de persistência - utilizada para a classe. Você pode, por exemplo, especificar sua prórpia subclasse do - <literal>org.hibernate.persister.EntityPersister</literal> ou você pode criar - uma implementação completamente nova da interface - <literal>org.hibernate.persister.ClassPersister</literal> que implementa a persistência - através de, por exemplo, chamadas a stored procedeures, serialização de arquivos flat ou - LDAP. Veja <literal>org.hibernate.test.CustomPersister</literal> para um exemplo - simples (de "persistencia" para uma <literal>Hashtable</literal>). - </para> - - <para> - Observe que as configurações <literal>dynamic-update</literal> e - <literal>dynamic-insert</literal> não sao herdadas pelas subclasses e assim podem tambem - ser especificadas em elementos <literal><subclass></literal> or - <literal><joined-subclass></literal>. Estas configurações podem incrementar a - performance em alguns casos, mas pode realmente diminuir a performance em outras. - Use-as de forma bastante criteriosa. - </para> - - <para> - O uso de <literal>select-before-update</literal> geralmente irá diminuir a performance. Ela é - muito útil para prevenir que uma trigger de atualização no banco de dados seja ativada - desnecessariamente, se você reconectar um nó de uma instancia desconectada em uma - <literal>Session</literal>. - </para> - - <para> - Se você ativar <literal>dynamic-update</literal>, você terá de escolher - a estratégia de bloqueio otimista: - </para> - <itemizedlist> - <listitem> - <para> - <literal>version</literal> verifica a versão e a hora das colunas - </para> - </listitem> - <listitem> - <para> - <literal>all</literal> cverifica todas as colunas - </para> - </listitem> - <listitem> - <para> - <literal>dirty</literal> verifica as colunas modificadas, permitindo - alguns updates concorrentes - </para> - </listitem> - <listitem> - <para> - <literal>none</literal> não utiliza o bloqueio otimista - </para> - </listitem> - </itemizedlist> - <para> - Nós <emphasis>recomendamos</emphasis> com muita enfase que você utilize a - versão e a hora das colunas para o bloqueio otimista com o Hibernate. - Esta é a melhor estratégia com respeito a performance e é a única estratégia - que trata corretamente as modificações efetuadas em instancias desconectadas - (por exemplo, quando <literal>Session.merge()</literal> é utilizado). - - </para> - - <para> - Não ha diferença entre uma view e uma tabela para o mapeamento do Hibernate, e como - esperado isto é transparente no nível do banco de dados (observe que alguns bancos de - dados não suportam views apropriadamente, especialmente com updates). Algumas vezes, - você quer utilizar uma view, ma snão pode cria-la no banco de dados (por exemplo, - com um esquema legado). Neste caso, você pode mapear uma entidade imutável e de - somente leitura, para uma dada expressão SQL, que representa um subselect: - </para> - - <programlisting><![CDATA[<class name="Summary"> - <subselect> - select item.name, max(bid.amount), count(*) - from item - join bid on bid.item_id = item.id - group by item.name - </subselect> - <synchronize table="item"/> - <synchronize table="bid"/> - <id name="name"/> - ... -</class>]]></programlisting> - - <para> - Declare as tabelas para sincronizar com esta entidade, garantindo que o auto-flush - ocorra corretamente, e que as queries para esta entidade derivada não retornem dados - desatualizados. O <literal><subselect></literal> está disponível tanto como um - atributo como um elemento mapeado nested. - </para> - - </sect2> - - <sect2 id="mapping-declaration-id" revision="4"> - <title>id</title> - - <para> - Classes mapeadas <emphasis>precisam</emphasis> declarar a coluna de chave primaria da - tabela do banco de dados. Muitas classes irão tambem ter uma propriedade ao estilo - Java-Beans declarando o identificador unico de uma instancia. O elemento - <literal><id></literal> define o mapeamento desta propriedade para a chave primária. - </para> - - <programlistingco> - <areaspec> - <area id="id1" coords="2 70"/> - <area id="id2" coords="3 70" /> - <area id="id3" coords="4 70"/> - <area id="id4" coords="5 70" /> - <area id="id5" coords="6 70" /> - </areaspec> - <programlisting><![CDATA[<id - name="propertyName" - type="typename" - column="column_name" - unsaved-value="null|any|none|undefined|id_value" - access="field|property|ClassName"> - node="element-name|@attribute-name|element/@attribute|." - - <generator class="generatorClass"/> -</id>]]></programlisting> - <calloutlist> - <callout arearefs="id1"> - <para> - <literal>name</literal> (opcional): O nome do identificador. - </para> - </callout> - <callout arearefs="id2"> - <para> - <literal>type</literal> (opcional): Um nome que indica o tipo no Hibernate. - </para> - </callout> - <callout arearefs="id3"> - <para> - <literal>column</literal> (opcional – default para o a propridade name): O - nome coluna chave primaria. - </para> - </callout> - <callout arearefs="id4"> - <para> - <literal>unsaved-value</literal> (opcional - default para um valor "sensível"): - Uma propriedade de identificação que indica que a instancia foi novamente - instanciada (unsaved), diferenciando de instancias desconectadas que foram - salvas ou carregadas em uma sessão anterior. - </para> - </callout> - <callout arearefs="id5"> - <para> - <literal>access</literal> (opcional - valor default <literal>property</literal>): A - estratégia que o Hiberante deve utilizar para acessar o valor da propriedade - </para> - </callout> - </calloutlist> - </programlistingco> - - <para> - Se o atributo <literal>name</literal> não for declarado, assume-se que a classe não tem - a propriedade de identificação. - </para> - - <para> - O atributo <literal>unsaved-value</literal> não é mais necessário no Hibernate 3. - </para> - - <para> - Há declaração alternativa <literal><composite-id></literal> permite o acesso a - dados legados com chaves compostas. Nós desencorajamos fortemente o seu uso por - qualquer pessoa. - </para> - - <sect3 id="mapping-declaration-id-generator" revision="2"> - <title>Generator</title> - - <para> - O elemento filho opcional <literal><generator></literal> nomeia uma classe Java - usada para gerar identificadores unicos para instancias de uma classe persistente. - Se algum parâmetro é requerido para configurar ou inicializar a instancia geradora, - eles são passados utilizando o elemento <literal><param></literal>. - </para> - - <programlisting><![CDATA[<id name="id" type="long" column="cat_id"> - <generator class="org.hibernate.id.TableHiLoGenerator"> - <param name="table">uid_table</param> - <param name="column">next_hi_value_column</param> - </generator> -</id>]]></programlisting> - - <para> - Todos os generators implementam a interface <literal>org.hibernate.id.IdentifierGenerator</literal>. - Esta é uma interface bem simples; algumas aplicações podem prover sua própria implementação - esepecializada. Entretanto, o Hibernate disponibiliza um conjunto de implementações internamente. - Há nomes de atalhos para estes generators próprios: - <variablelist> - <varlistentry> - <term><literal>increment</literal></term> - <listitem> - <para> - gera identificadores dos tipos <literal>long</literal>, <literal>short</literal> ou - <literal>int</literal> que são unicos apenas quando nenhum outro processo está - inserindo dados na mesma tabela. <emphasis>Não utilize em ambientes - de cluster.</emphasis> - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>identity</literal></term> - <listitem> - <para> - suporta colunas de identidade em DB2, MySQL, MS SQL Server, Sybase e - HypersonicSQL. O identificador retornado é do tipo <literal>long</literal>, - <literal>short</literal> ou <literal>int</literal>. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>sequence</literal></term> - <listitem> - <para> - utiliza uma sequence em DB2, PostgreSQL, Oracle, SAP DB, McKoi ou um - generator no Interbase. O identificador de retorno é do tipo <literal> - long</literal>, <literal>short</literal> ou <literal>int</literal>. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>hilo</literal></term> - <listitem> - <para id="mapping-declaration-id-hilodescription" revision="1"> - utiliza um algoritmo hi/lo para gerar de forma eficiente identificadores do tipo - <literal>long</literal>, <literal>short</literal> ou <literal>int</literal>, - a partir de uma tabela e coluna fornecida (por default - <literal>hibernate_unique_key</literal> e <literal>next_hi</literal>) - como fonte para os valores hi. O algoritmo hi/lo gera identificadores que são - únicos apenas para um banco de dados particular. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>seqhilo</literal></term> - <listitem> - <para> - utiliza um algoritmo hi/lo para gerar de forma eficinete identificadores do tipo - <literal>long</literal>, <literal>short</literal> ou <literal>int</literal>, - a partir de uma sequence de banco de dados fornecida. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>uuid</literal></term> - <listitem> - <para> - utiliza um algortimo UUID de 128-bits para gerar identificadores do - tipo string, unicos em uma rede(o endereço IP é utilizado). O UUID é - codificado como um string de digitos hexadecimais de tamanho 32. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>guid</literal></term> - <listitem> - <para> - utiliza um string GUID gerado pelo banco de dados no MS SQL Server - e MySQL. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>native</literal></term> - <listitem> - <para> - seleciona entre <literal>identity</literal>, <literal>sequence</literal> - ou <literal>hilo</literal> dependendo das capacidades do banco de dados - utilizado. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>assigned</literal></term> - <listitem> - <para> - deixa a aplicação definir um identificador para o objeto antes que o - <literal>save()</literal> seja chamado. Esta é a estratégia default - se nenhum elemento <literal><generator></literal> é especificado. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>select</literal></term> - <listitem> - <para> - retorna a chave primaria recuperada por uma trigger do banco de - dados, selecionado uma linha pela chave única e recuperando o valor - da chave primária. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>foreign</literal></term> - <listitem> - <para> - utiliza o identificador de um outro objeto associado. Normalmente utilizado - em conjunto com uma associaçõa de chave primária do tipo - <literal><one-to-one></literal>. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>sequence-identity</literal></term> - <listitem> - <para> - a specialized sequence generation strategy which utilizes a - database sequence for the actual value generation, but combines - this with JDBC3 getGeneratedKeys to actually return the generated - identifier value as part of the insert statement execution. This - strategy is only known to be supported on Oracle 10g drivers - targetted for JDK 1.4. Note comments on these insert statements - are disabled due to a bug in the Oracle drivers. - </para> - </listitem> - </varlistentry> - </variablelist> - - </para> - </sect3> - - <sect3 id="mapping-declaration-id-hilo" revision="1"> - <title>Algoritmo Hi/lo</title> - <para> - Os geradores <literal>hilo</literal> e <literal>seqhilo</literal> fornecem duas - implementações alternativas do algoritmo hi/lo, uma solução preferencial para a geração - de identificadores. A primeira implementação requer uma tabela especial do banco de - dados para manter o proximo valor "hi" disponível. A segunda utiliza uma seqüência - do estilo Oracle (quando suportado). - </para> - - <programlisting><![CDATA[<id name="id" type="long" column="cat_id"> - <generator class="hilo"> - <param name="table">hi_value</param> - <param name="column">next_value</param> - <param name="max_lo">100</param> - </generator> -</id>]]></programlisting> - - <programlisting><![CDATA[<id name="id" type="long" column="cat_id"> - <generator class="seqhilo"> - <param name="sequence">hi_value</param> - <param name="max_lo">100</param> - </generator> -</id>]]></programlisting> - - <para> - Infelizemente, voce não pode utilizar <literal>hilo</literal> quando estiver - fornecendo sia propria <literal>Connection</literal> para o Hibernate. Quando o - Hibernate está usando um datasource do servidor de aplicações para obter conexões - suportadas com JTA, você precisa configurar adequadamente o - <literal>hibernate.transaction.manager_lookup_class</literal>. - </para> - </sect3> - - <sect3 id="mapping-declaration-id-uuid"> - <title>UUID algorithm</title> - <para> - O UUID contem: o endereço IP, hora de inicio da JVM (com precisão de um quarto - de segundo), a hora do sistema e um valor contador (unico dentro da JVM). - Não é possivel obter o endereço MAC ou um endereço de memória do código Java, - assim este é o melhor que pode ser feito sem utilizar JNI. - </para> - </sect3> - - <sect3 id="mapping-declaration-id-sequences"> - <title>Colunas de identidade e sequencias</title> - <para> - Para bancos de dados que suportam colunas de identidade (DB2, MySQL, Sybase, - MS SQL), você pode utilizar uma geração de chave <literal>identity</literal>. - Para bancos de dados que suportam sequencias (DB2, Oracle, PostgreSQL, Interbase, - McKoi, SAP DB) voce pode utilizar a geração de chaves no estilo - <literal>sequence</literal>. As duas estratégias requerem duas consultas SQL - para inserir um novo objeto. - </para> - - <programlisting><![CDATA[<id name="id" type="long" column="person_id"> - <generator class="sequence"> - <param name="sequence">person_id_sequence</param> - </generator> -</id>]]></programlisting> - - <programlisting><![CDATA[<id name="id" type="long" column="person_id" unsaved-value="0"> - <generator class="identity"/> -</id>]]></programlisting> - - <para> - Para desenvolvimento multi-plataforma, a estratégia <literal>native</literal> - irá escolher entre as estratégias i <literal>identity</literal>, - <literal>sequence</literal> e <literal>hilo</literal>, dependendo das - capacidades do banco de dados utilizado. - </para> - </sect3> - - <sect3 id="mapping-declaration-id-assigned"> - <title>Identificadores especificados</title> - <para> - Se você quer que a aplicação especifique os identificadores - (em vez do Hibernate gerá-los) você deve utilizar o gerador - <literal>assigned</literal>. Este gerador especial irá utilizar o valor - do identificador especificado para a propriedade de identificação do objeto. - Este gerador é usado quando a chave primaria é a chave natural em vez de uma - surrogate key. Este é o comportamento padrão se você não especificar - um elemento <literal><generator></literal>. - </para> - - <para> - Escolher o gerador <literal>assigned</literal> faz com que o Hibernate - utilize <literal>unsaved-value="undefined"</literal>, forçando o Hibernate - ir até o banco de dados para determinar se uma instância está transiente ou - desasociada, a menos que haja uma versão ou uma propriedade timestamp, - ou você pode definir <literal>Interceptor.isUnsaved()</literal>. - </para> - </sect3> - - <sect3 id="mapping-declaration-id-select"> - <title>Chaves primárias geradas por triggers</title> - <para> - Apenas para sistemas legados (o Hibernate nao gera DDL com triggers). - </para> - - <programlisting><![CDATA[<id name="id" type="long" column="person_id"> - <generator class="select"> - <param name="key">socialSecurityNumber</param> - </generator> -</id>]]></programlisting> - - <para> - No exemplo acima, há uma única propriedade com valor nomeada - <literal>socialSecurityNumber</literal> definida pela classe, - uma chave natural, e uma surrogate key nomeada - <literal>person_id</literal> cujo valor é gerado pro uma trigger. - </para> - - </sect3> - - </sect2> - - <sect2 id="mapping-declaration-compositeid" revision="3"> - <title>composite-id</title> - - <programlisting><![CDATA[<composite-id - name="propertyName" - class="ClassName" - mapped="true|false" - access="field|property|ClassName"> - node="element-name|." - - <key-property name="propertyName" type="typename" column="column_name"/> - <key-many-to-one name="propertyName class="ClassName" column="column_name"/> - ...... -</composite-id>]]></programlisting> - - <para> - Para tabelas com uma chave composta, você pode mapear múltiplas propriedades - da classe como propriedades de identificação. O elemento - <literal><composite-id></literal> aceita o mapeamento da propriedade - <literal><key-property></literal> e mapeamentos - <literal><key-many-to-one></literal>como elements filhos. - </para> - - <programlisting><![CDATA[<composite-id> - <key-property name="medicareNumber"/> - <key-property name="dependent"/> -</composite-id>]]></programlisting> - - <para> - Sua classe persistente <emphasis>precisa</emphasis> sobre escrever - <literal>equals()</literal> e <literal>hashCode()</literal> para implementar - identificadores compostos igualmente. E precisa também implementar - <literal>Serializable</literal>. - </para> - - <para> - Infelizmente, esta solução para um identificador composto significa que um objeto - persistente é seu próprio identificador. Não há outro "handle" que o próprio objeto. - Você mesmo precisa instanciar uma instância de outra classe persistente e preencher - suas propriedades de identificação antes que você possa dar um <literal>load()</literal> - para o estado persistente associado com uma chave composta. Nos chamamos esta - solução de identificador composto <emphasis>embedded</emphasis> e não aconselhamos - para aplicações sérias. - </para> - - <para> - Uma segunda solução é o que podemos chamar de identificador composto - <emphasis>mapped</emphasis> quando a propriedades de identificação nomeadas dentro do - elemento <literal><composite-id></literal> estão duplicadas tando na classe - persistente como em uma classe de identificação separada. - </para> - - <programlisting><![CDATA[<composite-id class="MedicareId" mapped="true"> - <key-property name="medicareNumber"/> - <key-property name="dependent"/> -</composite-id>]]></programlisting> - - <para> - No exemplo, ambas as classes de identificação compostas, <literal>MedicareId</literal>, - e a própria classe entidade tem propriedades nomeadas <literal>medicareNumber</literal> - e <literal>dependent</literal>. A classe identificadora precisa sobrepor - <literal>equals()</literal> e <literal>hashCode()</literal> e implementar - <literal>Serializable</literal>. A desvantagem desta solução é obvia – - duplicação de código. - </para> - - <para> - Os seguintes atributos ão utilizados para especificar o mapeamento de - um identificador composto: - </para> - - <itemizedlist spacing="compact"> - <listitem> - <para> - <literal>mapped</literal> mapped (opcional, valor default <literal>false - </literal>): indica que um identificar composto mapeado é usado, e que as - propriedades de mapeamento contidas refere-se tanto a classe entidade e - a classe de identificação composta. - </para> - </listitem> - <listitem> - <para> - <literal>class</literal> (opcional, mas requerida para um identificar composto - mapeado): A classe usada como um identificador composto. - </para> - </listitem> - </itemizedlist> - - <para> - Nós iremos descrever uma terceira e as vezes mais conveniente solução, onde o - identificador composto é implementado como uma classe componente na - <xref linkend="components-compositeid"/>. Os atributos descritos abaixo aplicam-se - apenas para esta solução: - </para> - - <itemizedlist spacing="compact"> - <listitem> - <para> - <literal>name</literal> (opcional, requerida para esta solução): Uma - propriedade do tipo componente que armazena o identificador composto - (veja capítulo 9) - </para> - </listitem> - <listitem> - <para> - <literal>access</literal> (opcional - valor default <literal>property</literal>): - A estartégia Hibernate que deve ser utilizada para acessar o valor da propriedade. - </para> - </listitem> - <listitem> - <para> - <literal>class</literal> (opcional - valor default para o tipo de propriedade - determiando por reflexão) : A classe componente utilizada como um identificador - composto (veja a próxima sessão). - </para> - </listitem> - </itemizedlist> - - <para> - Esta terceira solução, um <emphasis>componente de identificação</emphasis>, é o que nós - recomendamos para a maioria das aplicações. - </para> - - </sect2> - - <sect2 id="mapping-declaration-discriminator" revision="3"> - <title>discriminator</title> - - <para> - O elemento <literal><discriminator></literal> é necessário para persistência - polimórfica utilizando a estratégia de mapeamento table-per-class-hierarchy e declara - uma coluna discriminadora da tabela. A coluna discriminadora contem valores de marcação - que dizem a camada de persistência qual subclasse instanciar para uma linha particular. - Um restrito conjunto de tipos que podem ser utilizados: <literal>string</literal>, - <literal>character</literal>, <literal>integer</literal>, <literal>byte</literal>, - <literal>short</literal>, <literal>boolean</literal>, - <literal>yes_no</literal>, <literal>true_false</literal>. - </para> - - <programlistingco> - <areaspec> - <area id="discriminator1" coords="2 60"/> - <area id="discriminator2" coords="3 60" /> - <area id="discriminator3" coords="4 60" /> - <area id="discriminator4" coords="5 60" /> - <area id="discriminator5" coords="6 60" /> - </areaspec> - <programlisting><![CDATA[<discriminator - column="discriminator_column" - type="discriminator_type" - force="true|false" - insert="true|false" - formula="arbitrary sql expression" -/>]]></programlisting> - <calloutlist> - <callout arearefs="discriminator1"> - <para> - <literal>column</literal> (opcional - valor default <literal>class</literal>) - o nome da coluna discriminadora - </para> - </callout> - <callout arearefs="discriminator2"> - <para> - <literal>type</literal> (opcional - valor default <literal>string</literal>) - o nome que indica o tipo Hibernate - </para> - </callout> - <callout arearefs="discriminator3"> - <para> - <literal>force</literal> (opcional - valor default <literal>false</literal>) - "força" o Hibernate a especificar valores discriminadores permitidos mesmo - quando recuperando todas as instancias da classe root. - </para> - </callout> - <callout arearefs="discriminator4"> - <para> - <literal>insert</literal> (opcional - valor default para <literal>true</literal>) - sete isto para <literal>false</literal> se sua coluna discriminadora é também - parte do identificador composto mapeado. (Diz ao Hibernate para não incluir a - coluna em comandos SQL <literal>INSERT</literal>s). - </para> - </callout> - <callout arearefs="discriminator5"> - <para> - <literal>formula</literal> (opcional) uma expressão SQL arbitraria que é e - xecutada quando um tipo tem que ser avaliado. Permite discriminação baseada - em conteúdo. - </para> - </callout> - </calloutlist> - </programlistingco> - - <para> - Valores atuais de uma coluna discriminada são especificados pelo atributo - <literal>discriminator-value</literal> da <literal><class></literal> - e elementos da <literal><subclass></literal>. - </para> - - <para> - O atributo <literal>force</literal> é util (apenas) em tabelas contendo linhas com - valores discriminadores "extras" que não estão mapeados para uma classe persistente. - Este não é geralmente o caso. - </para> - - <para> - Usando o atributo <literal>formula</literal> voce pode declarar uma expressão SQL - arbitrária que sera utilizada para avaliar o tipo de uma linha : - </para> - - <programlisting><![CDATA[<discriminator - formula="case when CLASS_TYPE in ('a', 'b', 'c') then 0 else 1 end" - type="integer"/>]]></programlisting> - - </sect2> - - <sect2 id="mapping-declaration-version" revision="4"> - <title>version (optional)</title> - - <para> - O elemento <literal><version></literal> é opcional e indica que a tabela - possui dados versionados. Isto é particularmente útil se você planeja utilizar - <emphasis>transações longas</emphasis> (veja abaixo): - </para> - - <programlistingco> - <areaspec> - <area id="version1" coords="2 70"/> - <area id="version2" coords="3 70"/> - <area id="version3" coords="4 70"/> - <area id="version4" coords="5 70"/> - <area id="version5" coords="6 70"/> - <area id="version6" coords="7 70"/> - <area id="version7" coords="8 70"/> - </areaspec> - <programlisting><![CDATA[<version - column="version_column" - name="propertyName" - type="typename" - access="field|property|ClassName" - unsaved-value="null|negative|undefined" - generated="never|always" - insert="true|false" - node="element-name|@attribute-name|element/@attribute|." -/>]]></programlisting> - <calloutlist> - <callout arearefs="version1"> - <para> - <literal>column</literal> (opcional - default a a propriedade name): O nome da - coluna mantendo o numero da versão - </para> - </callout> - <callout arearefs="version2"> - <para> - <literal>name</literal>: O nome da propriedade da classe persistente. - </para> - </callout> - <callout arearefs="version3"> - <para> - <literal>type</literal> (opcional - valor default para <literal>integer</literal>): - O tipo do numero da versão - </para> - </callout> - <callout arearefs="version4"> - <para> - <literal>access</literal> (opcional - valor default <literal>property</literal>): - A estratégia Hibernate que deve ser usada para acessar o valor da propriedade. - </para> - </callout> - <callout arearefs="version5"> - <para> - <literal>unsaved-value</literal> (opcional – valor default para <literal>undefined - </literal>): Um valor para a propriedade versão que indica que uma instancia é - uma nova instanciada (unsaved), distinguindo de instancias desconectadas que foram - salvas ou carregadas em sessões anteriores. ((<literal>undefined</literal> especifica - que o valor da propriedade de identificação deve ser utilizado). - </para> - </callout> - <callout arearefs="version6"> - <para> - <literal>generated</literal> (optional - defaults to <literal>never</literal>): - Specifies that this version property value is actually generated by the database. - See the discussion of <xref linkend="mapping-generated">generated properties</xref>. - <literal>generated</literal> (opcional - valor default <literal>never</literal>): - Especifica que valor para a propriedade versão é na verdade gerado pelo banco de - dados. Veja a discussão da Seção - <xref linkend="mapping-generated">generated properties</xref>. - </para> - </callout> - <callout arearefs="version7"> - <para> - <literal>insert</literal> (opcional - valor default para <literal>true</literal>): - Especifica se a coluna de versão deve ser incluída no comando SQL de insert. - Pode ser configurado como <literal>false</literal> se a coluna do banco de dados - está definida com um valor default de <literal>0</literal>. - </para> - </callout> - </calloutlist> - </programlistingco> - - <para> - Números de versão podem ser dos tipos Hibernate <literal>long</literal>, - <literal>integer</literal>, <literal>short</literal>, <literal>timestamp</literal> ou - <literal>calendar</literal>. - </para> - - <para> - A versão de uma propriedade timestamp nunca deve ser nula para uma instancia - desconectada, assim o Hibernate irá identificar qualquer instância com uma versão - nula ou timestamp como transiente, não importando qual estratégia para foi - especificada para <literal>unsaved-value</literal>. <emphasis>Declarando uma versão - nula ou a propriedade timestamp é um caminho fácil para tratar problemas com - reconexões transitivas no Hibernate, especialmente úteis para pessoas utilizando - identificadores assinaldados ou chaves compostas!</emphasis> - </para> - </sect2> - - <sect2 id="mapping-declaration-timestamp" revision="4" > - <title>timestamp (optional)</title> - - <para> - O elemento opcional <literal><timestamp></literal> indica que uma tabela contém - dados timestamped. Isso tem por objetivo dar uma alternativa para versionamento. Timestamps - são por natureza uma implementação menos segura do locking otimista. Entretanto, algumas - vezes a aplicação pode usar timestamps em outros caminhos. - </para> - - <programlistingco> - <areaspec> - <area id="timestamp1" coords="2 70"/> - <area id="timestamp2" coords="3 70" /> - <area id="timestamp3" coords="4 70" /> - <area id="timestamp4" coords="5 70" /> - <area id="timestamp5" coords="6 70" /> - <area id="timestamp6" coords="7 70" /> - </areaspec> - <programlisting><![CDATA[<timestamp - column="timestamp_column" - name="propertyName" - access="field|property|ClassName" - unsaved-value="null|undefined" - source="vm|db" - generated="never|always" - node="element-name|@attribute-name|element/@attribute|." -/>]]></programlisting> - <calloutlist> - <callout arearefs="timestamp1"> - <para> - <literal>column</literal> (opcional - valor default para a propriedade name): - O nome da coluna que mantem o timestamp. - </para> - </callout> - <callout arearefs="timestamp2"> - <para> - <literal>name</literal>: O nome da propriedade no estilo JavaBeans do - tipo <literal>Date</literal> ou <literal>Timestamp</literal> da classe - persistente Java. - </para> - </callout> - <callout arearefs="timestamp3"> - <para> - <literal>access</literal> (opcional - valor default para <literal>property</literal>): - A estretagia Hibernate que deve ser utilizada para acessar o valor da propriedade. - </para> - </callout> - <callout arearefs="timestamp4"> - <para> - <literal>unsaved-value</literal> (opcional - valor default <literal>null</literal>): - Uma propriedade para a versão de que indica que uma instância é uma nova instanciada - (unsaved), distinguindo-a de instancias desconectadas que foram salvas ou carregadas - em sessões previas. (<literal>undefined</literal> especifica que um valor de - propriedade de identificação deve ser utilizado) - </para> - </callout> - <callout arearefs="timestamp5"> - <para> - <literal>source</literal> (opcional - valor default para <literal>vm</literal>): - De onde o Hibernate deve recuperar o valor timestamp? Do banco de dados ou da JVM - corrente? Timestamps baseados em banco de dados levam a um overhead porque o - Hibernate precisa acessar o banco de dados para determinar o "próximo valor", mas é - mais seguro para uso em ambientes de "cluster". Observe também, que nem todos - <literal>Dialect</literal>s suportam a recuperação do timestamp corrente do banco - de dados, enquando outros podem não ser seguros para utilização em bloqueios - pela falta de precisão (Oracle 8 por exemplo) - </para> - </callout> - <callout arearefs="timestamp6"> - <para> - <literal>generated</literal> (opcional - valor default <literal>never</literal>): - Especifica que o valor da propriedade timestamp é gerado pelo banco de dados. - Veja a discussão <xref linkend="mapping-generated">generated properties</xref>. - </para> - </callout> - </calloutlist> - </programlistingco> - - <para> - Observe que <literal><timestamp></literal> é equivalente a - <literal><version type="timestamp"></literal>. E - <literal><timestamp source="db"></literal> é equivalente a - <literal><version type="dbtimestamp"></literal>. - </para> - </sect2> - - - <sect2 id="mapping-declaration-property" revision="4"> - <title>property</title> - - <para> - O elemento <literal><property></literal> declara uma propriedade - persistente de uma classe, no estilo JavaBean. - </para> - - <programlistingco> - <areaspec> - <area id="property1" coords="2 70"/> - <area id="property2" coords="3 70"/> - <area id="property3" coords="4 70"/> - <areaset id="property4-5" coords=""> - <area id="property4" coords='5 70'/> - <area id="property5" coords='6 70'/> - </areaset> - <area id="property6" coords="7 70"/> - <area id="property7" coords="8 70"/> - <area id="property8" coords="9 70"/> - <area id="property9" coords="10 70"/> - <area id="property10" coords="11 70"/> - <area id="property11" coords="12 70"/> - <area id="property12" coords="13 70"/> - </areaspec> - <programlisting><![CDATA[<property - name="propertyName" - column="column_name" - type="typename" - update="true|false" - insert="true|false" - formula="arbitrary SQL expression" - access="field|property|ClassName" - lazy="true|false" - unique="true|false" - not-null="true|false" - optimistic-lock="true|false" - generated="never|insert|always" - node="element-name|@attribute-name|element/@attribute|." - index="index_name" - unique_key="unique_key_id" - length="L" - precision="P" - scale="S" -/>]]></programlisting> - <calloutlist> - <callout arearefs="property1"> - <para> - <literal>name</literal>: o nome da propriedade, iniciando com letra minúscula. - </para> - </callout> - <callout arearefs="property2"> - <para> - <literal>column</literal> (opcional - default para a propriedade name): o nome - da coluna mapeada do banco de dados, Isto pode também ser especificado pelo(s) - elemento(s) <literal><column></literal> aninhados. - - </para> - </callout> - <callout arearefs="property3"> - <para> - <literal>type</literal> (opcional): um nome que indica o tipo Hibernate. - </para> - </callout> - <callout arearefs="property4-5"> - <para> - <literal>update, insert</literal> (opcional - valor default <literal>true</literal>): - especifica que as colunas mapeadas devem ser incluidas nas instruções SQL de - <literal>UPDATE</literal> e/ou <literal>INSERT</literal> . Setar ambas para to - <literal>false</literal> permite uma propridade "derivada" pura cujo valor é - inicializado de outra propriedade que mapeie a mesma coluna(s) ou por uma trigger - ou outra aplicação. - </para> - </callout> - <callout arearefs="property6"> - <para> - <literal>formula</literal> (opcional): uma expressão SQL que definie o valor para - uma propriedade <emphasis>calculada</emphasis>. Propriedades calculadas nao tem - uma coluna de mapeamento para elas. - </para> - </callout> - <callout arearefs="property7"> - <para> - <literal>access</literal> (opcional – valor default <literal>property</literal>): - A estratégia que o Hibernate deve utilizar para acessar o valor da propriedade - </para> - </callout> - <callout arearefs="property8"> - <para> - <literal>lazy</literal> (opcional - valor default para <literal>false</literal>): - Especifica que esta propriedade deve ser trazida de forma "lazy" quando a - instancia da variável é acessada pela primeira vez (requer instrumentação - bytecode em tempo de criação). - </para> - </callout> - <callout arearefs="property9"> - <para> - <literal>unique</literal> (opcional): Habilita a geração de DDL de uma - unica constraint para as colunas. Assim, permite que isto seja o - alvo de uma <literal>property-ref</literal>. - </para> - </callout> - <callout arearefs="property10"> - <para> - <literal>not-null</literal> (opcional): Habilita a geração de DDL de uma - constraint de nulidade para as colunas. - </para> - </callout> - <callout arearefs="property11"> - <para> - <literal>optimistic-lock</literal> (opcional - valor default <literal>true</literal>): - Especifica se mudanças para esta propriedade requerem ou não bloqueio otimista. - Em outras palavras, determina se um incremento de versão deve ocorrer quando - esta propriedade está suja. - </para> - </callout> - <callout arearefs="property12"> - <para> - <literal>generated</literal> (opcional - valor default <literal>never</literal>): - Especifica que o valor da propriedade é na verdade gerado pelo banco de dados. - Veja a discussão da seção - <xref linkend="mapping-generated">generated properties</xref>. - </para> - </callout> - </calloutlist> - </programlistingco> - - <para> - <emphasis>typename</emphasis> pode ser: - </para> - - <orderedlist spacing="compact"> - <listitem> - <para> - The name of a Hibernate basic type (eg. <literal>integer, string, character, - date, timestamp, float, binary, serializable, object, blob</literal>). - O nome do tipo basico do Hibernate (ex., <literal>integer, string, character, - date, timestamp, float, binary, serializable, object, blob</literal>). - </para> - </listitem> - <listitem> - <para> - O nome da classe Java com um tipo básico default (ex. <literal>int, float, - char, java.lang.String, java.util.Date, java.lang.Integer, java.sql.Clob</literal>). - </para> - </listitem> - <listitem> - <para> - O nome da classe Java serializable - </para> - </listitem> - <listitem> - <para> - O nome da classe de um tipo customizado (ex. <literal>com.illflow.type.MyCustomType</literal>). - </para> - </listitem> - </orderedlist> - - <para> - Se você não especificar um tipo, o Hibernate ira utilizar reflexão sobre a - propriedade nomeada para ter uma idéia do tipo Hibernate correto. O Hibernate ira - tentar interpretar o nome da classe retornada, usando as regras 2, 3 e 4 nesta ordem. - Entretanto, isto não é sempre suficiente Em certos casos, você ainda irá necessitar - do atributo <literal>type</literal>. (Por exemplo, para distinguir entre - <literal>Hibernate.DATE</literal> ou <literal>Hibernate.TIMESTAMP</literal>, - ou para espcificar uma tipo ciustomizado.) - </para> - - <para> - O atributo <literal>access</literal> permite voce controlar como o Hibernate irá - acessar a propriedade em tempo de execução. Por default, o Hibernate irá chamar os - métodos get/set da propriedades. Se voce especificar <literal>access="field"</literal>, - o Hibernate ira bipassar os metodos get/set, acessnado o campo diretamente, - usando reflexão. Voc epode especificar sua própria estratégia para acesso da - propriedade criando uma classe que implemente a interface - <literal>org.hibernate.property.PropertyAccessor</literal>. - </para> - - <para> - Um recurso especialmente poderoso é o de propriedades derivadas. Estas propriedades - são por definição read-only, e o valor da propriedade é calculado em tempo de execução. - Você declara este calculo como uma expressão SQL, que traduz para clausula - <literal>SELECT</literal> de uma subquery daquery SQL que carrega a instancia: - </para> - - <programlisting><![CDATA[ -<property name="totalPrice" - formula="( SELECT SUM (li.quantity*p.price) FROM LineItem li, Product p - WHERE li.productId = p.productId - AND li.customerId = customerId - AND li.orderNumber = orderNumber )"/>]]></programlisting> - - <para> - Observe que você pode referenciar as entidades da própria tabela, - através da não declaração de um alias para uma coluna particular ( - <literal>customerId</literal> no exemplo dado). Observe tambem que voce pode usar o - mapeamento de elemento aninhado <literal><formula></literal>, se você não - gostar de usar o atributo. - </para> - - </sect2> - - <sect2 id="mapping-declaration-manytoone" revision="5"> - <title>many-to-one</title> - - <para> - Uma associação ordinária para outra classe persistente é declarada usando o - elemento <literal>many-to-one</literal>. O modelo relacional é uma - associação many-to-one: a uma chave estrangeira de uma tabela referenciando - a chave primaria da tabela destino. - </para> - - <programlistingco> - <areaspec> - <area id="manytoone1" coords="2 70"/> - <area id="manytoone2" coords="3 70"/> - <area id="manytoone3" coords="4 70"/> - <area id="manytoone4" coords="5 70"/> - <area id="manytoone5" coords="6 70"/> - <areaset id="manytoone6-7" coords=""> - <area id="manytoone6" coords='7 70'/> - <area id="manytoone7" coords='8 70'/> - </areaset> - <area id="manytoone8" coords="9 70"/> - <area id="manytoone9" coords="10 70"/> - <area id="manytoone10" coords="11 70"/> - <area id="manytoone11" coords="12 70"/> - <area id="manytoone12" coords="13 70"/> - <area id="manytoone13" coords="14 70"/> - <area id="manytoone14" coords="15 70"/> - <area id="manytoone15" coords="16 70"/> - <area id="manytoone16" coords="17 70"/> - </areaspec> - <programlisting><![CDATA[<many-to-one - name="propertyName" - column="column_name" - class="ClassName" - cascade="cascade_style" - fetch="join|select" - update="true|false" - insert="true|false" - property-ref="propertyNameFromAssociatedClass" - access="field|property|ClassName" - unique="true|false" - not-null="true|false" - optimistic-lock="true|false" - lazy="proxy|no-proxy|false" - not-found="ignore|exception" - entity-name="EntityName" - formula="arbitrary SQL expression" - node="element-name|@attribute-name|element/@attribute|." - embed-xml="true|false" - index="index_name" - unique_key="unique_key_id" - foreign-key="foreign_key_name" -/>]]></programlisting> - <calloutlist> - <callout arearefs="manytoone1"> - <para> - <literal>name</literal>: O nome da propriedade. - </para> - </callout> - <callout arearefs="manytoone2"> - <para> - <literal>column</literal> (opcional): O nome da coluna foreign key. Isto - pode também ser especificado através de elementos aninhados - <literal><column></literal>. - </para> - </callout> - <callout arearefs="manytoone3"> - <para> - <literal>class</literal> (opcional – default para o tipo de propriedade - determinado pela reflexão). O nome da classe associada. - </para> - </callout> - <callout arearefs="manytoone4"> - <para> - <literal>cascade</literal> (opcional): Especifica quais operações dever - ser em cascata do objeto pai para o objeto associado. - </para> - </callout> - <callout arearefs="manytoone5"> - <para> - <literal>fetch</literal> (opcional - default para <literal>select</literal>): - Escolhe entre recuperação outer-join ou recuperação seqüencial. - </para> - </callout> - <callout arearefs="manytoone6-7"> - <para> - <literal>update, insert</literal> (opcional - valor default <literal>true</literal>): - especifica que as colunas mapeadas dever ser incluidas em instruções SQL de - <literal>UPDATE</literal> e/ou <literal>INSERT</literal>. Setando ambas para - <literal>false</literal> você permite uma associação "derivada" pura cujos valores - são inicializados de algumas outras propriedades que mapeiam a mesma coluna ou - por uma trigger ou outra aplicação. - </para> - </callout> - <callout arearefs="manytoone8"> - <para> - <literal>property-ref</literal>: (opcional) O nome da propriedade da classe associada - que faz a junção desta foreign key. Se não especificada, a chave primaria da - classe associada será utilizada. - </para> - </callout> - <callout arearefs="manytoone9"> - <para> - <literal>access</literal> (opcional - valor default <literal>property</literal>): A - estrategia que o Hibernate deve utilizar para acessar o valor da propriedade. - </para> - </callout> - <callout arearefs="manytoone10"> - <para> - <literal>unique</literal> (opcional): Habilita a geração DDL de uma constraint - unique para a coluna foreign-key. Alem disso, permite ser o alvo de uma - <literal>property-ref</literal>. Isso torna a associação multipla - efetivamente um para um. - </para> - </callout> - <callout arearefs="manytoone11"> - <para> - <literal>not-null</literal> (opcional): Habilita a geração DDL de uma constraint de - nulidade para as foreign keys. - </para> - </callout> - <callout arearefs="manytoone12"> - <para> - <literal>optimistic-lock</literal> (opcional - valor default <literal>true</literal>): - Especifica se mudanças desta propriedade requerem ou não travamento otimista. - Em outras palavras, determina se um incremento de versão deve ocorrer quando - esta propriedade está suja. - </para> - </callout> - <callout arearefs="manytoone13"> - <para> - <literal>lazy</literal>(opcional – valor default <literal>proxy</literal>): - Por default, associações de ponto unico são envoltas em um proxie. - <literal>lazy="no-proxy"</literal> especifica que a propriedade deve ser - trazida de forma tardia quando a instancia da variável é acessada pela - primeira vez (requer instrumentação bytecode em tempo de criação) - <literal>lazy="false"</literal> especifica que a associação será - sempre recuperada fortemente. - </para> - </callout> - <callout arearefs="manytoone14"> - <para> - <literal>not-found</literal> (opcional - valor default <literal>exception</literal>): - Especifica como as foreign keys que referenciam linhas ausentes serão tratadas: - <literal>ignore</literal> irá tratar a linha ausente como ama associaççao de null - </para> - </callout> - <callout arearefs="manytoone15"> - <para> - <literal>entity-name</literal> (opcional): O nome da entidade da classe associada. - </para> - </callout> - </calloutlist> - <callout arearefs="manytoone16"> - <para> - <literal>formula</literal> (optional): Uma expressão SQL que define um valor - para um foreign key <emphasis>computed</emphasis>. - </para> - </callout> - </programlistingco> - - <para> - Setar o valor do atributo <literal>cascade</literal> para qualquer valor - significativo diferente de <literal>none</literal> irá propagar certas operações - ao objeto associado. Os valores significativos são os nomes das operações básicas - do Hibernate, <literal>persist, merge, delete, save-update, evict, replicate, lock, - refresh</literal>, assim como os valores especiais <literal>delete-orphan</literal> - e <literal>all</literal> e combinações de nomes de operações separadas por vírgula, - como por exemplo, <literal>cascade="persist,merge,evict"</literal> ou - <literal>cascade="all,delete-orphan"</literal>. Veja a seção - <xref linkend="objectstate-transitive"/> para uma explicação completa. Note que - associações valoradas simples (associações muitos-pra-um, e um-pra-um) não suportam - orphan delete. - </para> - - <para> - Uma típica declaração <literal>muitos-pra-um</literal> se parece com esta: - </para> - - <programlisting><![CDATA[<many-to-one name="product" class="Product" column="PRODUCT_ID"/>]]></programlisting> - - <para> - O atributo <literal>property-ref</literal> deve apenas ser usado para mapear dados - legados onde uma chave estrangeira se referencia a uma chave exclusiva da tabela - associada que não seja à chave primária. Este é um modelo relacional desagradável. - Por exemplo, suponha que a classe <literal>Product</literal> tenha um número - seqüencial exclusivo, que não é a chave primária. (O atributo <literal>unique</literal> - controla a geração de DDL do Hibernate com a ferramenta SchemaExport.) - </para> - - <programlisting><![CDATA[<property name="serialNumber" unique="true" type="string" column="SERIAL_NUMBER"/>]]></programlisting> - - <para> - Então o mapeamento para <literal>OrderItem</literal> poderia usar: - </para> - - <programlisting><![CDATA[<many-to-one name="product" property-ref="serialNumber" column="PRODUCT_SERIAL_NUMBER"/>]]></programlisting> - - <para> - Porém, isto obviamente não é indicado, nunca. - </para> - - <para> - Se a chave exclusiva referenciada engloba múltiplas propriedades da entidade associada, - você deve mapear as propriedades referenciadas dentro de um elemento chamado - <literal><properties></literal> - - </para> - - <para> - Se a chave exclusiva referenciada é a propriedade de um componente, você pode especificar - um caminho para a propriedade. - </para> - - <programlisting><![CDATA[<many-to-one name="owner" property-ref="identity.ssn" column="OWNER_SSN"/>]]></programlisting> - - </sect2> - - <sect2 id="mapping-declaration-onetoone" revision="3"> - <title>one-to-one (um-pra-um)</title> - - <para> - Uma associação um-pra-um para outra classe persistente é declarada usando - um elemento <literal>one-to-one </literal>. - </para> - - <programlistingco> - <areaspec> - <area id="onetoone1" coords="2 70"/> - <area id="onetoone2" coords="3 70"/> - <area id="onetoone3" coords="4 70"/> - <area id="onetoone4" coords="5 70"/> - <area id="onetoone5" coords="6 70"/> - <area id="onetoone6" coords="7 70"/> - <area id="onetoone7" coords="8 70"/> - <area id="onetoone8" coords="9 70"/> - <area id="onetoone9" coords="10 70"/> - <area id="onetoone10" coords="11 70"/> - </areaspec> - <programlisting><![CDATA[<one-to-one - name="propertyName" - class="ClassName" - cascade="cascade_style" - constrained="true|false" - fetch="join|select" - property-ref="propertyNameFromAssociatedClass" - access="field|property|ClassName" - formula="any SQL expression" - lazy="proxy|no-proxy|false" - entity-name="EntityName" - node="element-name|@attribute-name|element/@attribute|." - embed-xml="true|false" - foreign-key="foreign_key_name" -/>]]></programlisting> - <calloutlist> - <callout arearefs="onetoone1"> - <para> - <literal>name</literal>: O nome da propriedade. - </para> - </callout> - <callout arearefs="onetoone2"> - <para> - <literal>class</literal> (opcional – default para o tipo da propriedade - definido via reflection): O nome da classe associada. - </para> - </callout> - <callout arearefs="onetoone3"> - <para> - <literal>cascade</literal> (opcional): Especifica qual operação deve - ser cascateada do objeto pai para o objeto associado. - </para> - </callout> - <callout arearefs="onetoone4"> - <para> - <literal>constrained</literal> (opcional): Especifica que uma chave estrangeira - constraint na chave primária da tabela mapeada referencia a tabela da classe - associada, Esta opção afeta a ordem em queh <literal>save()</literal> e - <literal>delete()</literal> são cascateadas, e determina se a associação - pode ser substituída (isto também é usado pela ferramenta schema export). - </para> - </callout> - <callout arearefs="onetoone5"> - <para> - <literal>fetch</literal> ((opcional – valor default <literal>select</literal>): - Escolhe entre outer-join fetching ou sequential select fetching. - </para> - </callout> - <callout arearefs="onetoone6"> - <para> - <literal>property-ref</literal>(opcional): O nome da propriedade da classe associada - que é ligada a chave primária desta classe. Se não for especificada, a chave primária - da classe associada é utilizada. - </para> - </callout> - <callout arearefs="onetoone7"> - <para> - <literal>access</literal> (opcional - valor default padrão <literal>property</literal>): - A estratégia que o Hibernate pode usar para acessar o valor da propriedade. - </para> - </callout> - <callout arearefs="onetoone8"> - <para> - <literal>formula</literal> (opcional): Quase todas associações um-pra-um mapeiam - para a chave primária da entidade dona. No caso raro, que não é o caso, você - pode especificar uma outra coluna, colunas ou expressões para juntar utilizando - uma formula SQL. (Veja <literal>org.hibernate.test.onetooneformula</literal> - para exemplo). - </para> - </callout> - <callout arearefs="onetoone9"> - <para> - <literal>lazy</literal> (opcional – valor default <literal>proxy</literal>): - Por default, associações single point são proxied. <literal>lazy="no-proxy"</literal> - especifica que a propriedade deve ser fetched lazily quando o atributo é acessado - pela primeira vez (requer build-time bytecode instrumentation). - <literal>lazy="false"</literal> especifica que a associação vai sempre ser - avidamente fetched. <emphasis>Note que se <literal>constrained="false"</literal>, - proxing é impossível e o Hibernate vai ávido fetch a associação!</emphasis> - </para> - </callout> - <callout arearefs="onetoone10"> - <para> - <literal>entity-name</literal> (opcional): O nome da entidade da classe associada. - </para> - </callout> - </calloutlist> - </programlistingco> - - <para> - Existem duas variedades de associações um-pra-um: - </para> - <itemizedlist> - <listitem><para> - associações de chave primária - </para></listitem> - <listitem><para> - associações de chave estrangeira exclusiva - </para></listitem> - </itemizedlist> - - <para> - Associações de chave primária não necessitam de uma coluna extra de tabela; se duas - linhas são relacionadas pela associação então as duas linhas da tabela dividem a mesmo - valor da chave primária. Assim, se você quer que dois objetos sejam relacionados por - uma associação de chave primária, você deve ter certeza que eles são assinados com o - mesmo valor identificador! - </para> - - <para> - Para uma associação de chave primária, adicione os seguintes mapeamentos em - <literal>Employee</literal> e <literal>Person</literal>, respectivamente. - </para> - - <programlisting><![CDATA[<one-to-one name="person" class="Person"/>]]></programlisting> - <programlisting><![CDATA[<one-to-one name="employee" class="Employee" constrained="true"/>]]></programlisting> - - <para> - Agora nós devemos assegurar que as chaves primárias de linhas relacionadas nas - tabelas PERSON e EMPLOYEE são iguais. Nós usamos uma estratégia especial de geração - de identificador do Hibernate chamada <literal>foreign</literal>: - </para> - - <programlisting><![CDATA[<class name="person" table="PERSON"> - <id name="id" column="PERSON_ID"> - <generator class="foreign"> - <param name="property">employee</param> - </generator> - </id> - ... - <one-to-one name="employee" - class="Employee" - constrained="true"/> -</class>]]></programlisting> - - <para> - Uma nova instância de <literal>Person</literal> salva recentemente é então assinada - com o mesmo valor da chave primária da instância de <literal>employee</literal> referenciada - com a propriedade <literal>employee</literal> daquela <literal>Person</literal>. - </para> - - <para> - Alternativamente, uma chave estrangeira com uma unique constraint, de - <literal>Employee</literal> para <literal>Person</literal>, pode ser expressa como: - </para> - - <programlisting><![CDATA[<many-to-one name="person" class="Person" column="PERSON_ID" unique="true"/>]]></programlisting> - - <para> - E esta associação pode ser feita de forma bi-direcional adicionando o seguinte - no mapeamento de <literal>Person</literal>: - </para> - - <programlisting><![CDATA[<one-to-one name="employee" class="Employee" property-ref="person"/>]]></programlisting> - - </sect2> - - <sect2 id="mapping-declaration-naturalid"> - <title>natural-id</title> - - <programlisting><![CDATA[<natural-id mutable="true|false"/> - <property ... /> - <many-to-one ... /> - ...... -</natural-id>]]></programlisting> - - <para> - Embora nós recomendemos o uso de surrogate keys como chaves primárias, você deve - ainda identificar chaves naturais para todas as entidades. Uma chave natural é - uma propriedade ou combinação de propriedades que é exclusiva e não nula. Se não - pude ser modificada, melhor ainda. Mapeie as propriedades da chave natural dentro do - elemento <literal><natural-id></literal>. O Hibernate irá gerar a chave - exclusiva necessária e as constraints de nullability , e seu mapeamento será - apropriadamente auto documentado. - </para> - - <para> - Nós recomendamos com enfase que você implemente <literal>equals()</literal> e - <literal>hashCode()</literal> para comparar as propriedades da chave natural da - entidade. - </para> - - <para> - Este mapeamento não tem o objetivo de uso com entidades com natural chaves primárias. - </para> - - <itemizedlist spacing="compact"> - <listitem> - <para> - <literal>mutable</literal> mutable (opcional, valor default<literal>false</literal>): - Por default, propriedades naturais identificadoras são consideradas imutáveis (constante). - </para> - </listitem> - </itemizedlist> - - </sect2> - - <sect2 id="mapping-declaration-component" revision="2"> - <title>componente, componente dinâmico</title> - - <para> - O elemento<literal><component></literal> mapeia propriedades de um - objeto filho para colunas da tabela de uma classe pai. Componentes podem, - um após o outro, declarar suas próprias propriedades, componentes ou coleções. - Veja "Components" abaixo. - </para> - - <programlistingco> - <areaspec> - <area id="component1" coords="2 45"/> - <area id="component2" coords="3 45"/> - <area id="component3" coords="4 45"/> - <area id="component4" coords="5 45"/> - <area id="component5" coords="6 45"/> - <area id="component6" coords="7 45"/> - <area id="component7" coords="8 45"/> - <area id="component8" coords="9 45"/> - </areaspec> - <programlisting><![CDATA[<component - name="propertyName" - class="className" - insert="true|false" - update="true|false" - access="field|property|ClassName" - lazy="true|false" - optimistic-lock="true|false" - unique="true|false" - node="element-name|." -> - - <property ...../> - <many-to-one .... /> - ........ -</component>]]></programlisting> - <calloutlist> - <callout arearefs="component1"> - <para> - <literal>name</literal>: O nome da propriedade. - </para> - </callout> - <callout arearefs="component2"> - <para> - <literal>class</literal> (opcional – valor default para o tipo de - propriedade determinada por reflection): O nome da classe (filha) do - componente. - </para> - </callout> - <callout arearefs="component3"> - <para> - <literal>insert</literal>: As colunas mapeadas aparecem nos - SQL de <literal>INSERT</literal>s? - </para> - </callout> - <callout arearefs="component4"> - <para> - <literal>update</literal>: As colunas mapeadas aparecem nos - SQL de <literal>UPDATE</literal>s? - </para> - </callout> - <callout arearefs="component5"> - <para> - <literal>access</literal> (opcional – valor default <literal>property</literal>): - A estratégia que o Hibernate pode usar para acessar o valor da propriedade. - </para> - </callout> - <callout arearefs="component6"> - <para> - <literal>lazy</literal> (opcional - valor default <literal>false</literal>): - Especifica que este componente deve ser fetched lazily quando o atributo for - acessado pela primeira vez (requer build-time bytecode instrumentation). - </para> - </callout> - <callout arearefs="component7"> - <para> - <literal>optimistic-lock</literal> (opcional – valor default <literal>true</literal>): - Especifica que atualizações para este componente requerem ou não aquisição - de um lock otimista. Em outras palavras, determina se uma versão de incremento deve - ocorrer quando esta propriedade estiver modificada. - </para> - </callout> - <callout arearefs="component8"> - <para> - <literal>unique</literal> (opcional – valor default <literal>false</literal>): - Especifica que existe uma unique constraint em todas as colunas mapeadas do - componente. - </para> - </callout> - </calloutlist> - </programlistingco> - - <para> - A tag filha <literal><property></literal> acrescenta a propriedade - de mapeamento da classe filha para colunas de uma tabela. - </para> - - <para> - O elemento <literal><component></literal> permite um sub-elemento - <literal><parent></literal> mapeie uma propriedade da classe do componente - como uma referencia de volta para a entidade que o contém. - </para> - - <para> - O elemento <literal><dynamic-component></literal> permite que um - <literal>Map</literal> possa ser mapeado como um componente onde os nomes das - propriedades referem-se para as chaves no mapa, veja - <xref linkend="components-dynamic"/>. - </para> - - </sect2> - - <sect2 id="mapping-declaration-properties" revision="2"> - <title>propriedades</title> - - <para> - O elemento <literal><properties></literal> permite a definição de um grupo - com nome, lógico de propriedades de uma classe. O uso mais importante do construtor - é que este permite uma combinação de propriedades para ser o objetivo de uma - <literal>property-ref</literal>. É também um modo conveninente para definir uma - unique constraint de múltiplas colunas. - </para> - - <programlistingco> - <areaspec> - <area id="properties1" coords="2 45"/> - <area id="properties2" coords="3 45"/> - <area id="properties3" coords="4 45"/> - <area id="properties4" coords="5 45"/> - <area id="properties5" coords="6 45"/> - </areaspec> - <programlisting><![CDATA[<properties - name="logicalName" - insert="true|false" - update="true|false" - optimistic-lock="true|false" - unique="true|false" -> - - <property ...../> - <many-to-one .... /> - ........ -</properties>]]></programlisting> - <calloutlist> - <callout arearefs="properties1"> - <para> - <literal>name</literal>:: O nome lógico do agrupamento – - <emphasis>não </emphasis> é o nome atual de propriedade. - </para> - </callout> - <callout arearefs="properties2"> - <para> - <literal>insert</literal>: As colunas mapeadas aparecem nos - SQL de <literal>INSERT</literal>s? - </para> - </callout> - <callout arearefs="properties3"> - <para> - <literal>update</literal>: As colunas mapeadas aparecem nos - SQL de <literal>UPDATE</literal>s? - </para> - </callout> - <callout arearefs="properties4"> - <para> - <literal>optimistic-lock</literal> (opcional – valor default <literal>true</literal>): - Especifica que atualizações para estes componentes requerem ou não aquisição de um - lock otimista. Em outras palavras, determina se uma versão de incremento deve ocorrer - quando estas propriedades estiverem modificadas. - </para> - </callout> - <callout arearefs="properties5"> - <para> - <literal>unique</literal> (opcional – valor defautl <literal>false</literal>): - Especifica que uma unique constraint existe em todas as colunas mapeadas do componente. - </para> - </callout> - </calloutlist> - </programlistingco> - - <para> - Por exemplo, se nós temos o seguinte mapeamento de <literal><properties></literal>: - </para> - - <programlisting><![CDATA[<class name="Person"> - <id name="personNumber"/> - ... - <properties name="name" - unique="true" update="false"> - <property name="firstName"/> - <property name="initial"/> - <property name="lastName"/> - </properties> -</class>]]></programlisting> - - <para> - Então nós podemos ter uma associação de dados herdados que referem a esta chave - exclusiva da tabela <literal>Person</literal>, ao invés de se referirem a chave - primária: - </para> - - <programlisting><![CDATA[<many-to-one name="person" - class="Person" property-ref="name"> - <column name="firstName"/> - <column name="initial"/> - <column name="lastName"/> -</many-to-one>]]></programlisting> - - <para> - Nós não recomendamos o uso deste tipo de coisa fora do contexto de mapeamento de - dados herdados. - </para> - - </sect2> - - <sect2 id="mapping-declaration-subclass" revision="4"> - <title>subclass (subclasse)</title> - - <para> - Finalmente, a persistência polimórfica requer a declaração de cada subclasse - da classe de persistência raiz. Para a estratégia de mapeamento - table-per-class-hierarchy, a declaração <literal><subclass></literal> - deve ser usada. - </para> - - <programlistingco> - <areaspec> - <area id="subclass1" coords="2 55"/> - <area id="subclass2" coords="3 55"/> - <area id="subclass3" coords="4 55"/> - <area id="subclass4" coords="5 55"/> - </areaspec> - <programlisting><![CDATA[<subclass - name="ClassName" - discriminator-value="discriminator_value" - proxy="ProxyInterface" - lazy="true|false" - dynamic-update="true|false" - dynamic-insert="true|false" - entity-name="EntityName" - node="element-name" - extends="SuperclassName"> - - <property .... /> - ..... -</subclass>]]></programlisting> - <calloutlist> - <callout arearefs="subclass1"> - <para> - <literal>name</literal>: O nome de classe completamente qualificada da subclasse. - </para> - </callout> - <callout arearefs="subclass2"> - <para> - <literal>discriminator-value</literal> (opcional – valor default o nome da classe): - Um valor que distingue subclasses individuais. - </para> - </callout> - <callout arearefs="subclass3"> - <para> - <literal>proxy</literal> (opcional): Especifica a classe ou interface que - usará os proxies de inicialização atrasada. - </para> - </callout> - <callout arearefs="subclass4"> - <para> - <literal>lazy</literal> (opcional, valor default <literal>true</literal>): - Configurar <literal>lazy="false"</literal> desabilitará o uso de - inicialização atrasada. - </para> - </callout> - </calloutlist> - </programlistingco> - <para> - Cada subclasse deve declarar suas próprias propriedades persistentes e subclasses. - As propriedades <literal><version></literal> e <literal><id></literal> - são configuradas para serem herdades da classe raiz. Cada subclasse numa hierarquia - deve definir um único <literal>discriminator-value</literal>. Se nenhum for - especificado, o nome da classe Java completamente qualificada será usada. - </para> - - <para> - Para informações sobre mapeamento de heranças, veja o <xref linkend="inheritance"/>. - </para> - - </sect2> - - <sect2 id="mapping-declaration-joinedsubclass" revision="3"> - <title>joined-subclass</title> - - <para> - Alternativamente, cada subclasse pode ser mapeada para sua própria tabela - (Estratégia de mapeamento table-per-subclass). O estado herdado é devolvido - por associação com a tabela da superclasse. Nós usamos o elemento - <literal><joined-subclass></literal>. - </para> - - <programlistingco> - <areaspec> - <area id="joinedsubclass1" coords="2 45"/> - <area id="joinedsubclass2" coords="3 45"/> - <area id="joinedsubclass3" coords="4 45"/> - <area id="joinedsubclass4" coords="5 45"/> - </areaspec> - <programlisting><![CDATA[<joined-subclass - name="ClassName" - table="tablename" - proxy="ProxyInterface" - lazy="true|false" - dynamic-update="true|false" - dynamic-insert="true|false" - schema="schema" - catalog="catalog" - extends="SuperclassName" - persister="ClassName" - subselect="SQL expression" - entity-name="EntityName" - node="element-name"> - - <key .... > - - <property .... /> - ..... -</joined-subclass>]]></programlisting> - <calloutlist> - <callout arearefs="joinedsubclass1"> - <para> - <literal>name</literal>: O nome da classe completamente qualificada da - subclasse. - </para> - </callout> - <callout arearefs="joinedsubclass2"> - <para> - <literal>table</literal>: O nome da tabela da subclasse. - </para> - </callout> - <callout arearefs="joinedsubclass3"> - <para> - <literal>proxy</literal> (opcional): Especifica a classe ou interface - para usar os proxies de recuperação atrasada. - </para> - </callout> - <callout arearefs="joinedsubclass4"> - <para> - <literal>lazy</literal> (opcional, valor default <literal>true</literal>): - Fixanr <literal>lazy="false"</literal> desabilita o uso recuperação - atrasada. - </para> - </callout> - </calloutlist> - </programlistingco> - - <para> - A coluna discriminator requerida para esta estratégia de mapeamento. Porém, - cada subclasse deve declarar uma coluna de tabela com o identificador do objeto - usando o elemento <literal><key></literal>. O mapeamento no início do - capítulo poderia ser re-escrito assim: - </para> - - <programlisting><![CDATA[<?xml version="1.0"?> -<!DOCTYPE hibernate-mapping PUBLIC - "-//Hibernate/Hibernate Mapping DTD//EN" - "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd"> - -<hibernate-mapping package="eg"> - - <class name="Cat" table="CATS"> - <id name="id" column="uid" type="long"> - <generator class="hilo"/> - </id> - <property name="birthdate" type="date"/> - <property name="color" not-null="true"/> - <property name="sex" not-null="true"/> - <property name="weight"/> - <many-to-one name="mate"/> - <set name="kittens"> - <key column="MOTHER"/> - <one-to-many class="Cat"/> - </set> - <joined-subclass name="DomesticCat" table="DOMESTIC_CATS"> - <key column="CAT"/> - <property name="name" type="string"/> - </joined-subclass> - </class> - - <class name="eg.Dog"> -  - </class> - -</hibernate-mapping>]]></programlisting> - - <para> - Para informações de mapeamentos de herança, veja <xref linkend="inheritance"/>. - </para> - - </sect2> - - <sect2 id="mapping-declaration-unionsubclass" revision="2"> - <title>union-subclass</title> - - <para> - Uma terceira opção é mapear para tabelas apenas as classes concretas de uma - hierarquia de heranças, (a estratégia table-per-concrete-class) onde cada tabela - define todos os estados persistentes da classe, incluindo estados herdados. - No Hibernate, não é absolutamente necessário mapear explicitamente como hierarquia - de heranças. Você pode simplesmente mapear cada classe com uma declaração - <literal><class></literal> separada. Porém, se você deseja usar associações - polimórficas (por exemplo: uma associação para a superclasse de sua hierarquia), - você precisa usar o mapeamento <literal><union-subclass></literal>. - - </para> - - <programlistingco> - <areaspec> - <area id="unionsubclass1" coords="2 45"/> - <area id="unionsubclass2" coords="3 45"/> - <area id="unionsubclass3" coords="4 45"/> - <area id="unionsubclass4" coords="5 45"/> - </areaspec> - <programlisting><![CDATA[<union-subclass - name="ClassName" - table="tablename" - proxy="ProxyInterface" - lazy="true|false" - dynamic-update="true|false" - dynamic-insert="true|false" - schema="schema" - catalog="catalog" - extends="SuperclassName" - abstract="true|false" - persister="ClassName" - subselect="SQL expression" - entity-name="EntityName" - node="element-name"> - - <property .... /> - ..... -</union-subclass>]]></programlisting> - <calloutlist> - <callout arearefs="unionsubclass1"> - <para> - <literal>name</literal>: O nome da subclasse completamente qualificada. - </para> - </callout> - <callout arearefs="unionsubclass2"> - <para> - <literal>table</literal>: O nome da tabela da subclasse. - </para> - </callout> - <callout arearefs="unionsubclass3"> - <para> - <literal>proxy</literal> (optional): Specifies a class or interface to use - for lazy initializing proxies. - - <literal>proxy</literal> (opcional): Especifica a classe ou interface para usar - os proxies de recuperação atrasada. - </para> - </callout> - <callout arearefs="unionsubclass4"> - <para> - <literal>lazy</literal> (optional, defaults to <literal>true</literal>): Setting - <literal>lazy="false"</literal> disables the use of lazy fetching. - <literal>lazy</literal> (opcional, valor default p<literal>true</literal>): - Fixando <literal>lazy="false"</literal> desabilita o uso da recuperação atrasada. - </para> - </callout> - </calloutlist> - </programlistingco> - - <para> - A coluna discriminatõria não é requerida para esta estratégia de mapeamento. - - </para> - - <para> - Para informações sobre mapeamentos de herança, veja <xref linkend="inheritance"/>. - </para> - - </sect2> - - <sect2 id="mapping-declaration-join" revision="3"> - <title>join</title> - - <para> - Usando o elemento <literal><join></literal>>, é possível mapear - propriedades de uma classe para várias tabelas. - </para> - - <programlistingco> - <areaspec> - <area id="join1" coords="2 50"/> - <area id="join2" coords="3 50"/> - <area id="join3" coords="4 50"/> - <area id="join4" coords="5 50"/> - <area id="join5" coords="6 50"/> - <area id="join6" coords="7 50"/> - </areaspec> - <programlisting><![CDATA[<join - table="tablename" - schema="owner" - catalog="catalog" - fetch="join|select" - inverse="true|false" - optional="true|false"> - - <key ... /> - - <property ... /> - ... -</join>]]></programlisting> - - <calloutlist> - <callout arearefs="join1"> - <para> - <literal>table</literal>: O nome da tabela associada. - </para> - </callout> - <callout arearefs="join2"> - <para> - <literal>schema</literal> (opcional): Sobrepõe o nome do esquema - especificado pelo elemento raiz <literal><hibernate-mapping></literal>. - </para> - </callout> - <callout arearefs="join3"> - <para> - <literal>catalog</literal> (opcional): Sobrepõe o nome do catálogo - especificado pelo elemento raiz<literal><hibernate-mapping></literal>. - </para> - </callout> - <callout arearefs="join4"> - <para> - <literal>fetch</literal>(opcional – valor default <literal>join</literal>): Se setado - para <literal>join</literal>, o padrão, o Hibernate irá usar um inner join para - restaurar um <literal>join</literal> definido por uma classe ou suas subclasses e - uma outer join para um <literal>join</literal> definido por uma subclasse. - Se setado para <literal>select</literal>, então o Hibernate irá usar uma seleção - seqüencial para um <literal><join></literal> definida numa subclasse, que irá - ser emitido apenas se uma linha se concentrar para representar uma instância - da subclasse. Inner joins irá ainda ser usado para restaurar um - <literal><join></literal> definido pela classe e suas superclasses. - </para> - </callout> - <callout arearefs="join5"> - <para> - <literal>inverse</literal> (opcional – valor default <literal>false</literal>): - Se habilitado, o Hibernate não irá tentar inserir ou atualizar as propriedades - definidas por este join. - </para> - </callout> - <callout arearefs="join6"> - <para> - <literal>optional</literal> (opcional – valor default <literal>false</literal>): - Se habilitado, o Hibernate irá inserir uma linha apenas se as propriedades definidas - por esta junção não forem nulas e irá sempre usar uma outer join para - recuperar as propriedades. - </para> - </callout> - </calloutlist> - </programlistingco> - - <para> - Por exemplo, a informação de endereço para uma pessoa pode ser mapeada para uma - tabela separada (enquanto preservando o valor da semântica de tipos para - todas as propriedades): - </para> - - <programlisting><![CDATA[<class name="Person" - table="PERSON"> - - <id name="id" column="PERSON_ID">...</id> - - <join table="ADDRESS"> - <key column="ADDRESS_ID"/> - <property name="address"/> - <property name="zip"/> - <property name="country"/> - </join> - ...]]></programlisting> - - <para> - Esta característica é útil apenas para modelos de dados legados, nós recomendamos - menos tabelas do que classes e um modelo de domínio bem granulado. Porém, é - útil para ficar trocando entre estratégias de mapeamento de herança - numa hierarquia simples, como explicado mais a frente. - </para> - - </sect2> - - <sect2 id="mapping-declaration-key"> - <title>key</title> - - <para> - Nós vimos que o elemento <literal><key></literal> surgiu algumas vezes - até agora. Ele aparece em qualquer lugar que o elemento pai define uma junção - para a nova tabela, e define a chave estrangeira para a tabela associada, que - referencia a chave primária da tabela original. - </para> - - <programlistingco> - <areaspec> - <area id="key1" coords="2 50"/> - <area id="key2" coords="3 50"/> - <area id="key3" coords="4 50"/> - <area id="key4" coords="5 50"/> - <area id="key5" coords="6 50"/> - <area id="key6" coords="7 50"/> - </areaspec> - <programlisting><![CDATA[<key - column="columnname" - on-delete="noaction|cascade" - property-ref="propertyName" - not-null="true|false" - update="true|false" - unique="true|false" -/>]]></programlisting> - - <calloutlist> - <callout arearefs="key1"> - <para>. - <literal>column</literal> (opcional): O nome da coluna da chave estrangeira. - Isto também pode ser especificado por aninhamento de elemento(s) - <literal><column></literal>. - </para> - </callout> - <callout arearefs="key2"> - <para> - <literal>on-delete</literal> (opcional, valor default <literal>noaction</literal>): - Especifica se a constraint da chave estrangeira no banco de dados esta - habilitada para cascade delete . - </para> - </callout> - <callout arearefs="key3"> - <para> - <literal>property-ref</literal> (opcional): Especifica que a chave estrangeira - se refere a colunas que não são chave primária da tabela original. - (Util para base de dados legadas.) - </para> - </callout> - <callout arearefs="key4"> - <para> - <literal>not-null</literal> (opcional): Especifica que a coluna da chave - estrangeira não aceita valores nulos (isto é implícito em qualquer momento - que a chave estrangeira também fizer parte da chave primária). - </para> - </callout> - <callout arearefs="key5"> - <para> - <literal>update</literal> (optional): Specifies that the foreign key should never - be updated (this is implied whenever the foreign key is also part of the primary - key). - <literal>update</literal> (opcional): Especifica que a chave estrangeira nunca - deve ser atualizada (isto é implícito em qualquer momento que a chave estrangeira - também fizer parte da chave primária). - </para> - </callout> - <callout arearefs="key6"> - <para> - <literal>unique</literal> (opcional): Especifica que a chave estrangeira deve ter - uma constraint unique (sto é implícito em qualquer momento que a chave estrangeira - também fizer parte da chave primária). - </para> - </callout> - </calloutlist> - </programlistingco> - - <para> - Nós recomendamos que para sistemas que a performance de delete seja importante, todas as - chaves deve ser definida <literal>on-delete="cascade"</literal>, e o Hibernate irá usar - uma constraint a nível de banco de dados <literal>ON CASCADE DELETE</literal>, ao invés - de muitas instruções <literal>DELETE</literal>. Esteja ciente que esta característica é - um atalho da estratégia usual de optimistic locking do Hibernate para dados versionados. - </para> - - <para> - Os atributos <literal>not-null</literal> e <literal>update</literal> são úteis quando - estamos mapeamos uma associação unidirecional um para muitos. Se você mapear uma - asociação unidirecional um para muitos para uma chave estrangeira non-nullable, você - <emphasis>deve</emphasis> declarar a coluna chave usando - <literal><key not-null="true"></literal>. - </para> - - </sect2> - - <sect2 id="mapping-column" revision="4"> - <title>elementos column e formula</title> - <para> - Qualquer elemento de mapeamente que aceita um atributo <literal>column</literal> irá - aceitar alternativamente um subelemento <literal><column></literal>. Da mesma forma, - <literal>formula</literal> é uma alternativa para o atributo <literal>formula</literal>. - </para> - - <programlisting><![CDATA[<column - name="column_name" - length="N" - precision="N" - scale="N" - not-null="true|false" - unique="true|false" - unique-key="multicolumn_unique_key_name" - index="index_name" - sql-type="sql_type_name" - check="SQL expression" - default="SQL expression"/>]]></programlisting> - - <programlisting><![CDATA[<formula>SQL expression</formula>]]></programlisting> - - <para> - O atributo <literal>column</literal> e <literal>formula</literal> podem até ser combinados - dentro da mesma propriedade ou associação mapeando para expressar, - por exemplo, associações exóticas. - </para> - - <programlisting><![CDATA[<many-to-one name="homeAddress" class="Address" - insert="false" update="false"> - <column name="person_id" not-null="true" length="10"/> - <formula>'MAILING'</formula> -</many-to-one>]]></programlisting> - - </sect2> - - <sect2 id="mapping-declaration-import"> - <title>import</title> - - <para> - Suponha que a sua aplicação tem duas classes persistentes com o mesmo nome, e você não quer - especificar o nome qualificado (do pacote) nas queries do Hibernate. As Classes devem - ser "importadas" explicitamente, de preferência contando com <literal>auto-import="true"</literal>. - Você pode até importar classes e interfaces que não estão explicitamente mapeadas. - </para> - - <programlisting><![CDATA[<import class="java.lang.Object" rename="Universe"/>]]></programlisting> - - <programlistingco> - <areaspec> - <area id="import1" coords="2 40"/> - <area id="import2" coords="3 40"/> - </areaspec> - <programlisting><![CDATA[<import - class="ClassName" - rename="ShortName" -/>]]></programlisting> - <calloutlist> - <callout arearefs="import1"> - <para> - <literal>class</literal>: O nome qualificado (do pacote) de qualquer classe Java. - </para> - </callout> - <callout arearefs="import2"> - <para> - <literal>rename</literal> (opcional – valor default, o nome da classe não - qualificada): Um nome que pode ser usado numa linguagem de consulta. - </para> - </callout> - </calloutlist> - </programlistingco> - - </sect2> - - <sect2 id="mapping-types-anymapping" revision="2"> - <title>any</title> - - <para> - Existe mais um tipo de propriedade de mapeamento. O elemento de mapeamento - <literal><any></literal> define uma associação polimórfica para classes de múltiplas tabelas. - Este tipo de mapeamento sempre requer mais de uma coluna. A primeira coluna possui o tipo da entidade - associada. A outra coluna que ficou possui o identificador. É impossível especificar uma restrição - de chave estrangeira para este tipo de associação, assim isto claramente não é visto - como um caminho usual para associações (polimórficas) de mapeamento. Você deve usar este mapeamento - apenas em casos muito especiais (exemplo: audit logs, dados de sessão do usuário, etc). - - </para> - - <para> - O atributo <literal>meta-type</literal> permite a aplicação especificar um tipo adaptado - que mapeia valores de colunas de banco de dados para classes persistentes que tem propriedades - identificadoras do tipo especificado através do <literal>id-type</literal>. Você deve especificar - o mapeamento de valores do meta-type para nome de classes. - </para> - - <programlisting><![CDATA[<any name="being" id-type="long" meta-type="string"> - <meta-value value="TBL_ANIMAL" class="Animal"/> - <meta-value value="TBL_HUMAN" class="Human"/> - <meta-value value="TBL_ALIEN" class="Alien"/> - <column name="table_name"/> - <column name="id"/> -</any>]]></programlisting> - - <programlistingco> - <areaspec> - <area id="any1" coords="2 50"/> - <area id="any2" coords="3 50"/> - <area id="any3" coords="4 50"/> - <area id="any4" coords="5 50"/> - <area id="any5" coords="6 50"/> - <area id="any6" coords="7 50"/> - </areaspec> - <programlisting><![CDATA[<any - name="propertyName" - id-type="idtypename" - meta-type="metatypename" - cascade="cascade_style" - access="field|property|ClassName" - optimistic-lock="true|false" -> - <meta-value ... /> - <meta-value ... /> - ..... - <column .... /> - <column .... /> - ..... -</any>]]></programlisting> - <calloutlist> - <callout arearefs="any1"> - <para> - <literal>name</literal>: o nome da propriedade. - </para> - </callout> - <callout arearefs="any2"> - <para> - <literal>id-type</literal>: o tipo identificador. - </para> - </callout> - <callout arearefs="any3"> - <para> - <literal>meta-type</literal> (opcional – valor default <literal>string</literal>): - Qualquer tipo que é permitido para um mapeamento discriminador. - </para> - </callout> - <callout arearefs="any4"> - <para> - <literal>cascade</literal> (opcional – valor default <literal>none</literal>): - o estilo do cascade. - </para> - </callout> - <callout arearefs="any5"> - <para> - <literal>access</literal> (opcional – valor default <literal>property</literal>): - A estratégia que o hibernate deve usar para acessar o valor da propriedade. - </para> - </callout> - <callout arearefs="any6"> - <para> - <literal>optimistic-lock</literal> (opcional - valor default<literal>true</literal>): - Especifica que as atualizações para esta propriedade requerem ou não aquisição da - trava otimista. Em outras palavras, define se uma versão de incremento deve ocorrer - se esta propriedade está modificada. - </para> - </callout> - </calloutlist> - </programlistingco> - - </sect2> - - </sect1> - - <sect1 id="mapping-types"> - <title>Tipos do Hibernate</title> - - <sect2 id="mapping-types-entitiesvalues" revision="1"> - <title>Entidades e valores</title> - - <para> - Para entender o comportamento de vários objetos em nível de linguagem de Java a - respeito do serviço de persistência, nós precisamos classificá-los em dois grupos. - </para> - - <para> - Uma <emphasis>entidade </emphasis> existe independentemente de qualquer outro - objeto guardando referências para a entidade. Em contraste com o modelo usual de - Java que um objeto não referenciado é coletado pelo garbage collector. Entidades - devem ser explicitamente salvas ou deletada (exceto em operações de salvamento - ou deleção que possam ser executada em <emphasis>cascata</emphasis> de uma entidade - pai para seus filhos). Isto é diferente do modelo ODMG de persistência do objeto - por acessibilidade – e corresponde quase a como objetos de aplicações são - geralmente usados em grandes sistemas. Entidades suportam referências circulares - e comuns. Eles podem ser versionadas. - </para> - - <para> - Uma entidade em estado persistente consiste de referências para outras entidades - e instâncias de tipos de <emphasis>valor</emphasis>. Valores são primitivos, - coleções (não o que tem dentro de uma coleção), componentes e certos objetos - imutáveis. Entidades distintas, valores (em coleções e componentes particulares) - <emphasis>são </emphasis> persistidos e apagados por acessibilidade. Visto que - objetos value (e primitivos) são persistidos e apagados junto com as entidades - que os contém e não podem ser versionados independentemente. Valores têm - identidade não independente, assim eles não podem ser comuns para duas - entidades ou coleções. - - </para> - - <para> - Até agora, nós estivemos usando o termo "classe persistente" para referir - a entidades. Nós iremos continuar a fazer isto. Falando a rigor, porém, nem todas - as classes definidas pelo usuário com estados persistentes são entidades. Um - <emphasis>componente</emphasis> é uma classe de usuário definida com valores - semânticos. Uma propriedade de Java de tipo <literal>java.lang.String</literal> - também tem um valor semêntico. Dada esta definição, nós podemos dizer que - todos os tipos (classes) fornecida pelo JDK tem tipo de valor semântico em Java, - enquanto que tipos definidos pelo usuário pode ser mapeados com entidade ou valor - de tipo semântico. Esta decisão pertence ao desenvolvedor da aplicação. Uma boa - dica para uma classe entidade em um modelo de domínio são referências comuns - para uma instância simples daquela classe, enquanto a composição ou agregação - geralmente se traduz para um valor de tipo. - </para> - - <para> - Nós iremos rever ambos os conceitos durante toda a documentação. - - </para> - - <para> - O desafio pe mapear o sistema de tipo de Java (e a definição do desenvolvedor de - entidades e tipos de valor) para o sistema de tipo SQL/banco de dados. A ponte entre ambos - os sistemas é fornecido pelo Hibernate: para entidades que usam - <literal><class></literal>, <literal><subclass></literal> e assim por diante. - Para tipos de valores nós usamos <literal><property></literal>, - <literal><component></literal>, etc, geralmente com um atributo - <literal>type</literal>. O valor deste atributo é o nome de um <emphasis>tipo de - mapeamento</emphasis> do Hibernate. O Hibernate fornece muitos mapeamentos - (para tipos de valores do JDK padrão) ut of the box. Você pode escrever os seus - próprios tipos de mapeamentos e implementar sua estratégia de conversão adaptada, - como você verá adiante. - </para> - - <para> - Todos os tipos internos do hibernate exceto coleções suportam semânticas nulas. - - </para> - - </sect2> - - <sect2 id="mapping-types-basictypes" revision="3"> - <title>Valores de tipos básicos</title> - - <para> - O tipos internos de mapeamentos básicos podem ser a grosso modo categorizado como: - <variablelist> - <varlistentry> - <term><literal>integer, long, short, float, double, character, byte, - boolean, yes_no, true_false</literal></term> - <listitem> - <para> - Tipos de mapeamentos de classes primitivas ou wrapper Java especificos - (vendor-specific) para tipos de coluna SQL. Boolean, - <literal>boolean, yes_no</literal> são todas codificações alternativas - para um <literal>boolean</literal> ou <literal>java.lang.Boolean</literal> - do Java. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>string</literal></term> - <listitem> - <para> - Um tipo de mapeamento de <literal>java.lang.String</literal> para - <literal>VARCHAR</literal> (ou <literal>VARCHAR2</literal> no Oracle). - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>date, time, timestamp</literal></term> - <listitem> - <para> - Tipos de mapeamento de <literal>java.util.Date</literal> e suas - subclasses para os tipos SQL <literal>DATE</literal>, - <literal>TIME</literal> e <literal>TIMESTAMP</literal> - (ou equivalente). - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>calendar, calendar_date</literal></term> - <listitem> - <para> - Tipo de mapeamento de <literal>java.util.Calendar</literal> para - os tipos SQL <literal>TIMESTAMP</literal> e - <literal>DATE</literal> (ou equivalente). - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>big_decimal, big_integer</literal></term> - <listitem> - <para> - Tipo de mapeamento de <literal>java.math.BigDecimal</literal> and - <literal>java.math.BigInteger</literal> para <literal>NUMERIC</literal> - (ou <literal>NUMBER</literal> no Oracle). - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>locale, timezone, currency</literal></term> - <listitem> - <para> - Tipos de mapeamentos de <literal>java.util.Locale</literal>, - <literal>java.util.TimeZone</literal> e <literal>java.util.Currency</literal> - para <literal>VARCHAR</literal> (ou <literal>VARCHAR2</literal> no Oracle). - Instâncias de f <literal>Locale</literal> e <literal>Currency</literal> - são mapeados para seus códigos ISO. Instâncias de <literal>TimeZone</literal> - são mapeados para seu <literal>ID</literal>. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>class</literal></term> - <listitem> - <para> - um tipo de mapeamento de <literal>java.lang.Class</literal> para - <literal>VARCHAR</literal> (ou <literal>VARCHAR2</literal> no - Oracle). Uma <literal>Class</literal> é mapeada pelo - seu nome qualificado (completo). - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>binary</literal></term> - <listitem> - <para> - Mapeia arrays de bytes para um tipo binário de SQL apropriado. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>text</literal></term> - <listitem> - <para> - Maps long Java strings to a SQL <literal>CLOB</literal> or - <literal>TEXT</literal> type. - Mapeia strings longas de Java para um tipo SQL - <literal>CLOB</literal> ou <literal>TEXT</literal>. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>serializable</literal></term> - <listitem> - <para> - Mapeia tipos Java serializáveis para um tipo binário SQL apropriado. - Você pode também indicar o tipo <literal>serializable</literal> do - Hibernate com o nome da classe ou interface Java serializável que - não é padrão para um tipo básico. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>clob, blob</literal></term> - <listitem> - <para> - Tipos de mapeamentos para as classes JDBC <literal>java.sql.Clob</literal> and - <literal>java.sql.Blob</literal>. Estes tipos podem ser inconveniente para - algumas aplicações, visto que o objeto blob ou clob pode não ser reusado - fora de uma transação. (Além disso, o suporte de driver é imcompleto e - inconsistente.) - </para> - </listitem> - </varlistentry> - <varlistentry> - <term> - <literal>imm_date, imm_time, imm_timestamp, imm_calendar, imm_calendar_date, - imm_serializable, imm_binary</literal> - </term> - <listitem> - <para> - Mapeando tipos para o que geralmente são consideradas tipos mutáveis de - Java, onde o Hibernate faz determinadas otimizações apropriadas somente - para tipos imutáveis de Java, e a aplicação trata o objeto como imutável. - Por exemplo, você não deve chamar <literal>Date.setTime()</literal> para - uma instância mapeada como <literal>imm_timestamp</literal>. Para mudar - o valor da propriedade, e ter a mudança feita persistente, a aplicação - deve atribuir um novo objeto (nonidentical) à propriedade. - </para> - </listitem> - </varlistentry> - </variablelist> - - </para> - - <para> - Identificadores únicos das entidades e coleções podem ser de qualquer tipo - básico exceto <literal>binary</literal>, <literal>blob</literal> ou - <literal>clob</literal>. (Identificadores compostos também são permitidos, - veja abaixo.) - </para> - - <para> - Os tipos de valores básicos têm suas constantes <literal>Type</literal> - correspondentes definidas em <literal>org.hibernate.Hibernate</literal>. Por exemplo, - <literal>Hibernate.STRING</literal> representa o tipo <literal>string</literal>. - </para> - - </sect2> - - <sect2 id="mapping-types-custom" revision="2"> - <title>Tipos de valores personalizados</title> - - <para> - É relativamente fácil para desenvolvedores criar seus próprios tipos de valor. - Por exemplo, você pode querer persistir propriedades do tipo - <literal>java.lang.BigInteger</literal> para colunas <literal>VARCHAR</literal>. O - Hibernate não fornece um tipo correspondente para isso. Mas os tipos adaptados - não são limitados a mapeamento de uma propriedade (ou elemento de coleção) a uma - única coluna da tabela. Assim, por exemplo, você pôde ter uma propriedade Java - <literal>getName()</literal>/<literal>setName()</literal> do tipo - <literal>java.lang.String</literal> que é persistido para colunas - <literal>FIRST_NAME</literal>, <literal>INITIAL</literal>, <literal>SURNAME</literal>. - - </para> - - <para> - Para implementar um tipo personalizado, implemente <literal>org.hibernate.UserType</literal> - or <literal>org.hibernate.CompositeUserType</literal> e declare propriedades usando o nome - qualificado da classe do tipo. Veja <literal>org.hibernate.test.DoubleStringType</literal> - para ver o tipo das coisas que são possíveis. - </para> - - <programlisting><![CDATA[<property name="twoStrings" type="org.hibernate.test.DoubleStringType"> - <column name="first_string"/> - <column name="second_string"/> -</property>]]></programlisting> - - <para> - Observe o uso da tag <literal><column></literal> para mapear uma propriedade - para colunas múltiplas. - </para> - - <para> - As interfaces <literal>CompositeUserType</literal>, <literal>EnhancedUserType</literal>, - <literal>UserCollectionType</literal>, e <literal>UserVersionType</literal> - fornecem suporte para usos mais especializados. - </para> - - <para> - Você pode mesmo fornecer parâmetros a um <literal>UserType</literal> no arquivo de mapeamento. - Para isto, seu <literal>UserType</literal> deve implementar a interface - <literal>org.hibernate.usertype.ParameterizedType</literal>. Para fornecer parâmetros a seu - tipo personalizado, você pode usar o elemento <literal><type></literal> em seus - arquivos de mapeamento. - </para> - - <programlisting><![CDATA[<property name="priority"> - <type name="com.mycompany.usertypes.DefaultValueIntegerType"> - <param name="default">0</param> - </type> -</property>]]></programlisting> - - <para> - O <literal>UserType</literal> pode agora recuperar o valor para o parâmetro chamado - <literal>default</literal> da <literal>Propriedade</literal> do passado a ele. - </para> - - <para> - Se você usar freqüentemente um determinado <literal>UserType</literal>, pode ser útil definir - um nome mais curto para ele. Você pode fazer isto usando o elemento - <literal><typedef></literal>. Typedefs atribui um nome a um tipo personalizado, e pode também - conter uma lista de valores default de parâmetro se o tipo for parametrizado. - </para> - - <programlisting><![CDATA[<typedef class="com.mycompany.usertypes.DefaultValueIntegerType" name="default_zero"> - <param name="default">0</param> -</typedef>]]></programlisting> - - <programlisting><![CDATA[<property name="priority" type="default_zero"/>]]></programlisting> - - <para> - It is also possible to override the parameters supplied in a typedef on a case-by-case basis - by using type parameters on the property mapping. - </para> - - <para> - Even though Hibernate's rich range of built-in types and support for components means you - will very rarely <emphasis>need</emphasis> to use a custom type, it is nevertheless - considered good form to use custom types for (non-entity) classes that occur frequently - in your application. For example, a <literal>MonetaryAmount</literal> class is a good - candidate for a <literal>CompositeUserType</literal>, even though it could easily be mapped - as a component. One motivation for this is abstraction. With a custom type, your mapping - documents would be future-proofed against possible changes in your way of representing - monetary values. - </para> - - </sect2> - - </sect1> - - <sect1 id="mapping-entityname"> - <title>Mapping a class more than once</title> - <para> - It is possible to provide more than one mapping for a particular persistent class. In this - case you must specify an <emphasis>entity name</emphasis> do disambiguate between instances - of the two mapped entities. (By default, the entity name is the same as the class name.) - Hibernate lets you specify the entity name when working with persistent objects, when writing - queries, or when mapping associations to the named entity. - </para> - - <programlisting><![CDATA[<class name="Contract" table="Contracts" - entity-name="CurrentContract"> - ... - <set name="history" inverse="true" - order-by="effectiveEndDate desc"> - <key column="currentContractId"/> - <one-to-many entity-name="HistoricalContract"/> - </set> -</class> - -<class name="Contract" table="ContractHistory" - entity-name="HistoricalContract"> - ... - <many-to-one name="currentContract" - column="currentContractId" - entity-name="CurrentContract"/> -</class>]]></programlisting> - - <para> - Notice how associations are now specified using <literal>entity-name</literal> instead of - <literal>class</literal>. - </para> - - </sect1> - - <sect1 id="mapping-quotedidentifiers"> - <title>SQL quoted identifiers</title> - <para> - You may force Hibernate to quote an identifier in the generated SQL by enclosing the table or - column name in backticks in the mapping document. Hibernate will use the correct quotation - style for the SQL <literal>Dialect</literal> (usually double quotes, but brackets for SQL - Server and backticks for MySQL). - </para> - - <programlisting><![CDATA[<class name="LineItem" table="`Line Item`"> - <id name="id" column="`Item Id`"/><generator class="assigned"/></id> - <property name="itemNumber" column="`Item #`"/> - ... -</class>]]></programlisting> - - </sect1> - - - <sect1 id="mapping-alternatives"> - <title>Metadata alternatives</title> - - <para> - XML isn't for everyone, and so there are some alternative ways to define O/R mapping metadata in Hibernate. - </para> - - <sect2 id="mapping-xdoclet"> - <title>Using XDoclet markup</title> - - <para> - Many Hibernate users prefer to embed mapping information directly in sourcecode using - XDoclet <literal>@hibernate.tags</literal>. We will not cover this approach in this - document, since strictly it is considered part of XDoclet. However, we include the - following example of the <literal>Cat</literal> class with XDoclet mappings. - </para> - - <programlisting><![CDATA[package eg; -import java.util.Set; -import java.util.Date; - -/** - * @hibernate.class - * table="CATS" - */ -public class Cat { - private Long id; // identifier - private Date birthdate; - private Cat mother; - private Set kittens - private Color color; - private char sex; - private float weight; - - /* - * @hibernate.id - * generator-class="native" - * column="CAT_ID" - */ - public Long getId() { - return id; - } - private void setId(Long id) { - this.id=id; - } - - /** - * @hibernate.many-to-one - * column="PARENT_ID" - */ - public Cat getMother() { - return mother; - } - void setMother(Cat mother) { - this.mother = mother; - } - - /** - * @hibernate.property - * column="BIRTH_DATE" - */ - public Date getBirthdate() { - return birthdate; - } - void setBirthdate(Date date) { - birthdate = date; - } - /** - * @hibernate.property - * column="WEIGHT" - */ - public float getWeight() { - return weight; - } - void setWeight(float weight) { - this.weight = weight; - } - - /** - * @hibernate.property - * column="COLOR" - * not-null="true" - */ - public Color getColor() { - return color; - } - void setColor(Color color) { - this.color = color; - } - /** - * @hibernate.set - * inverse="true" - * order-by="BIRTH_DATE" - * @hibernate.collection-key - * column="PARENT_ID" - * @hibernate.collection-one-to-many - */ - public Set getKittens() { - return kittens; - } - void setKittens(Set kittens) { - this.kittens = kittens; - } - // addKitten not needed by Hibernate - public void addKitten(Cat kitten) { - kittens.add(kitten); - } - - /** - * @hibernate.property - * column="SEX" - * not-null="true" - * update="false" - */ - public char getSex() { - return sex; - } - void setSex(char sex) { - this.sex=sex; - } -}]]></programlisting> - - <para> - See the Hibernate web site for more examples of XDoclet and Hibernate. - </para> - - </sect2> - - <sect2 id="mapping-annotations" revision="2"> - <title>Using JDK 5.0 Annotations</title> - - <para> - JDK 5.0 introduced XDoclet-style annotations at the language level, type-safe and - checked at compile time. This mechnism is more powerful than XDoclet annotations and - better supported by tools and IDEs. IntelliJ IDEA, for example, supports auto-completion - and syntax highlighting of JDK 5.0 annotations. The new revision of the EJB specification - (JSR-220) uses JDK 5.0 annotations as the primary metadata mechanism for entity beans. - Hibernate3 implements the <literal>EntityManager</literal> of JSR-220 (the persistence API), - support for mapping metadata is available via the <emphasis>Hibernate Annotations</emphasis> - package, as a separate download. Both EJB3 (JSR-220) and Hibernate3 metadata is supported. - </para> - - <para> - This is an example of a POJO class annotated as an EJB entity bean: - </para> - - <programlisting><![CDATA[@Entity(access = AccessType.FIELD) -public class Customer implements Serializable { - - @Id; - Long id; - - String firstName; - String lastName; - Date birthday; - - @Transient - Integer age; - - @Embedded - private Address homeAddress; - - @OneToMany(cascade=CascadeType.ALL) - @JoinColumn(name="CUSTOMER_ID") - Set<Order> orders; - - // Getter/setter and business methods -}]]></programlisting> - - <para> - Note that support for JDK 5.0 Annotations (and JSR-220) is still work in progress and - not completed. Please refer to the Hibernate Annotations module for more details. - </para> - - </sect2> - </sect1> - - <sect1 id="mapping-generated" revision="1"> - <title>Generated Properties</title> - <para> - Generated properties are properties which have their values generated by the - database. Typically, Hibernate applications needed to <literal>refresh</literal> - objects which contain any properties for which the database was generating values. - Marking properties as generated, however, lets the application delegate this - responsibility to Hibernate. Essentially, whenever Hibernate issues an SQL INSERT - or UPDATE for an entity which has defined generated properties, it immediately - issues a select afterwards to retrieve the generated values. - </para> - <para> - Properties marked as generated must additionally be non-insertable and non-updateable. - Only <xref linkend="mapping-declaration-version">versions</xref>, - <xref linkend="mapping-declaration-timestamp">timestamps</xref>, and - <xref linkend="mapping-declaration-property">simple properties</xref> can be marked as - generated. - </para> - <para> - <literal>never</literal> (the default) - means that the given property value - is not generated within the database. - </para> - <para> - <literal>insert</literal> - states that the given property value is generated on - insert, but is not regenerated on subsequent updates. Things like created-date would - fall into this category. Note that even thought - <xref linkend="mapping-declaration-version">version</xref> and - <xref linkend="mapping-declaration-timestamp">timestamp</xref> properties can - be marked as generated, this option is not available there... - </para> - <para> - <literal>always</literal> - states that the property value is generated both - on insert and on update. - </para> - </sect1> - - <sect1 id="mapping-database-object"> - <title>Auxiliary Database Objects</title> - <para> - Allows CREATE and DROP of arbitrary database objects, in conjunction with - Hibernate's schema evolution tools, to provide the ability to fully define - a user schema within the Hibernate mapping files. Although designed specifically - for creating and dropping things like triggers or stored procedures, really any - SQL command that can be run via a <literal>java.sql.Statement.execute()</literal> - method is valid here (ALTERs, INSERTS, etc). There are essentially two modes for - defining auxiliary database objects... - </para> - <para> - The first mode is to explicitly list the CREATE and DROP commands out in the mapping - file: - </para> - <programlisting><![CDATA[<hibernate-mapping> - ... - <database-object> - <create>CREATE TRIGGER my_trigger ...</create> - <drop>DROP TRIGGER my_trigger</drop> - </database-object> -</hibernate-mapping>]]></programlisting> - <para> - The second mode is to supply a custom class which knows how to construct the - CREATE and DROP commands. This custom class must implement the - <literal>org.hibernate.mapping.AuxiliaryDatabaseObject</literal> interface. - </para> - <programlisting><![CDATA[<hibernate-mapping> - ... - <database-object> - <definition class="MyTriggerDefinition"/> - </database-object> -</hibernate-mapping>]]></programlisting> - <para> - Additionally, these database objects can be optionally scoped such that they only - apply when certain dialects are used. - </para> - <programlisting><![CDATA[<hibernate-mapping> - ... - <database-object> - <definition class="MyTriggerDefinition"/> - <dialect-scope name="org.hibernate.dialect.Oracle9Dialect"/> - <dialect-scope name="org.hibernate.dialect.OracleDialect"/> - </database-object> -</hibernate-mapping>]]></programlisting> - </sect1> -</chapter> - +<chapter id="mapping"> + <title>Mapeamento O/R Bassico</title> + + <sect1 id="mapping-declaration" revision="1"> + <title>Declaração de mapeamento</title> + + <para> + Object/relational mappings are usually defined in an XML document. The mapping + document is designed to be readable and hand-editable. The mapping language is + Java-centric, meaning that mappings are constructed around persistent class + declarations, not table declarations. + </para> + + <para> + Note that, even though many Hibernate users choose to write the XML by hand, + a number of tools exist to generate the mapping document, including XDoclet, + Middlegen and AndroMDA. + </para> + + <para> + Lets kick off with an example mapping: + </para> + + <programlisting id="mapping-declaration-ex1" revision="1"><![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"> + +<hibernate-mapping package="eg"> + + <class name="Cat" + table="cats" + discriminator-value="C"> + + <id name="id"> + <generator class="native"/> + </id> + + <discriminator column="subclass" + type="character"/> + + <property name="weight"/> + + <property name="birthdate" + type="date" + not-null="true" + update="false"/> + + <property name="color" + type="eg.types.ColorUserType" + not-null="true" + update="false"/> + + <property name="sex" + not-null="true" + update="false"/> + + <property name="litterId" + column="litterId" + update="false"/> + + <many-to-one name="mother" + column="mother_id" + update="false"/> + + <set name="kittens" + inverse="true" + order-by="litter_id"> + <key column="mother_id"/> + <one-to-many class="Cat"/> + </set> + + <subclass name="DomesticCat" + discriminator-value="D"> + + <property name="name" + type="string"/> + + </subclass> + + </class> + + <class name="Dog"> +  + </class> + +</hibernate-mapping>]]></programlisting> + + <para> + Discutir agora o conteúdo deste documento de mapeamento. Iremos apenas descrever + os elementos do documento e atributos que são utilizados pelo Hibernate em tempo + de execução. O documento de mapeamento também contém alguns atributos adicionais + e opcionais além de elementos que afetam os esquemas de banco de dados exportados + pela ferramenta de exportação de esquemas. (Por exemplo, o atributo + <literal>not-null</literal>). + </para> + + + + <sect2 id="mapping-declaration-doctype" revision="3"> + <title>Doctype</title> + + <para> + Todos os mapeamentos de XML devem declarar o doctype exibido. O DTD atual pode + ser encontrado na URL abaixo, no diretório <literal>hibernate-x.x.x/src/org/ + hibernate </literal> ou no <literal>hibernate3.jar</literal>. O Hibernate sempre + irá procurar pelo DTD inicialmente no seu classpath. Se você tentar localizar + o DTD usando uma conexão de internet, compare a declaração do seu DTD com o + conteúdo do seu classpath + </para> + + <sect3 id="mapping-declaration-entity-resolution"> + <title>EntityResolver</title> + <para> + As mentioned previously, Hibernate will first attempt to resolve DTDs in its classpath. The + manner in which it does this is by registering a custom <literal>org.xml.sax.EntityResolver</literal> + implementation with the SAXReader it uses to read in the xml files. This custom + <literal>EntityResolver</literal> recognizes two different systemId namespaces. + </para> + <itemizedlist> + <listitem> + <para> + a <literal>hibernate namespace</literal> is recognized whenever the + resolver encounteres a systemId starting with + <literal>http://hibernate.sourceforge.net/</literal>; the resolver + attempts to resolve these entities via the classlaoder which loaded + the Hibernate classes. + </para> + </listitem> + <listitem> + <para> + a <literal>user namespace</literal> is recognized whenever the + resolver encounteres a systemId using a <literal>classpath://</literal> + URL protocol; the resolver will attempt to resolve these entities + via (1) the current thread context classloader and (2) the + classloader which loaded the Hibernate classes. + </para> + </listitem> + </itemizedlist> + <para> + An example of utilizing 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> + Where <literal>types.xml</literal> is a resource in the <literal>your.domain</literal> + package and contains a custom <xref linkend="mapping-types-custom">typedef</xref>. + </para> + </sect3> + </sect2> + + <sect2 id="mapping-declaration-mapping" revision="3"> + <title>hibernate-mapping</title> + + <para> + Este elemento tem diversos atributos opcionais. Os atributos + <literal>schema</literal> e <literal>catalog</literal> especificam que tabelas + referenciadas neste mapeamento pertencem ao esquema e/ou ao catalogo nomeado. + Se especificados, os nomes das tabelas irão ser qualificados no schema ou catalog dado. + Se não, os nomes das tabelas não serão qualificados. O atributo <literal>default-cascade + </literal> especifica qual estilo de cascata será assumido pelas propriedades e + coleções que não especificarm um atributo <literal>cascade</literal>. O atributo + <literal>auto-import</literal> nos deixa utilizar nomes de classes não qualificados + na linguagem de consulta, por default. + </para> + + <programlistingco> + <areaspec> + <area id="hm1" coords="2 55"/> + <area id="hm2" coords="3 55"/> + <area id="hm3" coords="4 55"/> + <area id="hm4" coords="5 55"/> + <area id="hm5" coords="6 55"/> + <area id="hm6" coords="7 55"/> + <area id="hm7" coords="8 55"/> + </areaspec> + <programlisting><![CDATA[<hibernate-mapping + schema="schemaName" + catalog="catalogName" + default-cascade="cascade_style" + default-access="field|property|ClassName" + default-lazy="true|false" + auto-import="true|false" + package="package.name" + />]]></programlisting> + <calloutlist> + <callout arearefs="hm1"> + <para> + <literal>schema</literal> (opcional): O nome do esquema do banco de dados. + </para> + </callout> + <callout arearefs="hm2"> + <para> + <literal>catalog</literal> (opcional): O nome do catálogo do banco de dados. + </para> + </callout> + <callout arearefs="hm3"> + <para> + <literal>default-cascade</literal> (opcional – default é <literal>nenhum + </literal>): Um estilo cascata default. + </para> + </callout> + <callout arearefs="hm4"> + <para> + <literal>default-access</literal> (opcional – default é <literal>property</literal>): + A estratégia que o Hibernate deve utilizar para acessar todas as propridades. Pode + ser uma implementação própria de <literal>PropertyAccessor</literal>. + </para> + </callout> + <callout arearefs="hm5"> + <para> + <literal>default-lazy</literal> (opcional - default é <literal>true</literal>): + O valor default para atributos <literal>lazy</literal> da classe e dos + mapeamentos de coleções. + </para> + </callout> + <callout arearefs="hm6"> + <para> + <literal>auto-import</literal> ((opcional - default é <literal>true</literal>): + Especifica se nós podemos usar nomes de classess não qualificados + (das classes deste mapeamento) na linguagem de consulta. + </para> + </callout> + <callout arearefs="hm7"> + <para> + <literal>package</literal> (opcional): Especifica um prefixo da package para + assumir para nomes de classes não qualificadas no documento de mapeamento. + </para> + </callout> + </calloutlist> + </programlistingco> + + <para> + Se voce tem duas classes persistentes com o mesmo nome (não qualificadas), você deve + setar <literal>auto-import="false"</literal>. O Hibernate irá gerar uma exceção se + você tentar setar duas classes para o mesmo nome "importado". + </para> + + <para> + Observe que o elemento <literal>hibernate-mapping</literal> permite a você + aninhar diversos mapeamentos de <literal><class></literal> persistentes, + como mostrado abaixo. Entretanto, é uma boa prática (e esperado por algumas + ferramentas)o mapeamento de apenas uma classe persistente simples (ou uma + hierarquia de classes simples) em um arquivo de mapeamento e nomea-la após + a superclasse persistente, por exemplo: <literal>Cat.hbm.xml</literal>, + <literal>Dog.hbm.xml</literal>, ou se estiver usando herança, + <literal>Animal.hbm.xml</literal>. + </para> + + </sect2> + + <sect2 id="mapping-declaration-class" revision="3"> + <title>class</title> + + <para> + Você pode declarar uma classe persistente utilizando o elemento + <literal>class</literal>: + </para> + + <programlistingco> + <areaspec> + <area id="class1" coords="2 55"/> + <area id="class2" coords="3 55" /> + <area id="class3" coords="4 55"/> + <area id="class4" coords="5 55" /> + <area id="class5" coords="6 55"/> + <area id="class6" coords="7 55" /> + <area id="class7" coords="8 55"/> + <area id="class8" coords="9 55" /> + <area id="class9" coords="10 55" /> + <area id="class10" coords="11 55"/> + <area id="class11" coords="12 55"/> + <area id="class12" coords="13 55"/> + <area id="class13" coords="14 55"/> + <area id="class14" coords="15 55"/> + <area id="class15" coords="16 55"/> + <area id="class16" coords="17 55"/> + <area id="class17" coords="18 55"/> + <area id="class18" coords="19 55"/> + <area id="class19" coords="20 55"/> + <area id="class20" coords="21 55"/> + <area id="class21" coords="22 55"/> + </areaspec> + <programlisting><![CDATA[<class + name="ClassName" + table="tableName" + discriminator-value="discriminator_value" + mutable="true|false" + schema="owner" + catalog="catalog" + proxy="ProxyInterface" + dynamic-update="true|false" + dynamic-insert="true|false" + select-before-update="true|false" + polymorphism="implicit|explicit" + where="arbitrary sql where condition" + persister="PersisterClass" + batch-size="N" + optimistic-lock="none|version|dirty|all" + lazy="true|false" + entity-name="EntityName" + check="arbitrary sql check condition" + rowid="rowid" + subselect="SQL expression" + abstract="true|false" + node="element-name" +/>]]></programlisting> + <calloutlist> + <callout arearefs="class1"> + <para> + <literal>name</literal> (opcional): O nome da classe Java inteiramente qualificado + da classe persistente (ou interface); Se o atributo é ausente, assume-se que o + mapeamento é para intidades não-POJO. + </para> + </callout> + <callout arearefs="class2"> + <para> + <literal>table</literal> (opcional – default para nomes de classes não + qualificadas) O nome da sua tabela do banco de dados. + </para> + </callout> + <callout arearefs="class3"> + <para> + <literal>discriminator-value</literal> (opcional – default para o nome da classe): + Um valor que distingue subclasses individuais, usadas para o comportamento polimorfico. + Valores aceitos incluem <literal>null</literal> e <literal>not null</literal> + </para> + </callout> + <callout arearefs="class4"> + <para> + <literal>mutable</literal> (opcional - valor default <literal>true</literal>): + Especifica que instancias da classe são (ou não) mutáveis + </para> + </callout> + <callout arearefs="class5"> + <para> + <literal>schema</literal> (opcional): Sobrepõe o nome do esquema especificado + pelo elemento root <literal><hibernate-mapping></literal>. + </para> + </callout> + <callout arearefs="class6"> + <para> + <literal>catalog</literal> (opcional): Sobrepõe o nome do catálogo especificado + pelo elemento root <literal><hibernate-mapping></literal>. + </para> + </callout> + <callout arearefs="class7"> + <para> + <literal>proxy</literal> (opcional): Especifica um interface para ser + utilizada pelos proxies de inicialização tardia. Você pode especificar o + nome da própria classe. + </para> + </callout> + <callout arearefs="class8"> + <para> + <literal>dynamic-update</literal> (opcional, valor default <literal>false</literal>): + Especifica que o SQL de <literal>UPDATE</literal> deve ser gerado em tempo de + execução e conter apenas aquelas colunas cujos valores foram alterados. + </para> + </callout> + <callout arearefs="class9"> + <para> + <literal>dynamic-insert</literal> (opcional, valor default <literal>false</literal>): + Especifica que o SQL de <literal>INSERT</literal> deve ser gerado em tempo de + execução e conter apenas aquelas colunas cujos valores não estão nulos. + </para> + </callout> + <callout arearefs="class10"> + <para> + <literal>select-before-update</literal> (opcional, valor default <literal>false</literal>): + Especifica que o Hibernate <emphasis>never</emphasis> deve executar um SQL de + <literal>UPDATE</literal> a não ser que com certeza um objeto está atualmente modificado. + Em certos casos (atualmente, apenas quando um objeto transiente foi associado com uma nova + sessão utilizando <literal>update()</literal>), isto significa que o Hibernate ira executar + uma instrução SQL de <literal>SELECT</literal> adicional para determinar se um + <literal>UPDATE</literal> é necessário nesse momento. + </para> + </callout> + <callout arearefs="class11"> + <para> + <literal>polymorphism</literal> (opcional, default para <literal>implicit</literal>): + Determina se deve ser utilizado a query polimorfica implicita ou explicitamente. + </para> + </callout> + <callout arearefs="class12"> + <para> + <literal>where</literal> (opicional) especifica um comando SQL <literal>WHERE</literal> + arbitrário para ser usado quando da recuperação de objetos desta classe. + </para> + </callout> + <callout arearefs="class13"> + <para> + <literal>persister</literal> (opcional): Espeicifca uma <literal>ClassPersister</literal> + customizada. + </para> + </callout> + <callout arearefs="class14"> + <para> + <literal>batch-size</literal> (opcional, valor default <literal>1</literal>) especifica um + "tamanho de lote" para a recuperação de instancias desta classe pelo identificador. + </para> + </callout> + <callout arearefs="class15"> + <para> + <literal>optimistic-lock</literal> (octional, valor default <literal>version</literal>): + Determina a estratégia de bloqueio. + </para> + </callout> + <callout arearefs="class16"> + <para> + <literal>lazy</literal> (opcional): A recuperação tardia pode ser completamente + desabilitada, setando <literal>lazy="false"</literal>. + </para> + </callout> + <callout arearefs="class17"> + <para> + <literal>entity-name</literal> (opcional, default para o nome da classe): O + Hibernate3 permite uma classe ser mapeada multiplas vezes, (potencialmente,para + diferentes tabelas), e permite mapeamentos de entidades que são representadas + por Maps ou XML no nível Java. Nestes casos, você deve especificar um nome + arbitrário explicitamente para a entidade. Veja <xref linkend="persistent-classes-dynamicmodels"/> + e <xref linkend="xml"/> para maiores informações. + </para> + </callout> + <callout arearefs="class18"> + <para> + <literal>check</literal> (opcional): Uma expressão SQL utilizada para gerar uma + constraint de <emphasis>verificação</emphasis> de múltiplas linhas para a geração + automática do esquema. + </para> + </callout> + <callout arearefs="class19"> + <para> + <literal>rowid</literal> (opcional): O Hibernate poder usar as assim chamadas + ROWIDs em bancos de dados que a suportam. Por exemplo, no Oracle, o Hibernate + pode utilizar a coluna extra rowid para atualizações mais rápidas se você + configurar esta opção para <literal>rowid</literal>. Um ROWID é uma implementação + que representa de maneira detalhada a localização física de uma determinada + tupla armazenado. + </para> + </callout> + <callout arearefs="class20"> + <para> + <literal>subselect</literal> (optional): Maps an immutable and read-only entity + to a database subselect. Useful if you want to have a view instead of a base table, + but don't. See below for more information. + <literal>subselect</literal> (opcional): Mapeia uma entidade imutavel e somente + de leitura para um subconjunto do banco de dados. Útil se você quiser ter uma + view em vez de uma tabela. Veja abaixo para mais informações. + </para> + </callout> + <callout arearefs="class21"> + <para> + <literal>abstract</literal> (opcional): Utilizada para marcar superclasses + abstratas em hierarquias <literal><union-subclass></literal>. + </para> + </callout> + </calloutlist> + </programlistingco> + + <para> + É perfeitamente aceitável para uma classe persitente nomeada ser uma interface. Você deverá + então declarar as classes implementadas desta interface utilizando o elemento + <literal><subclass></literal>. Você pode persistir qualquer classe de aninhada + <emphasis>estatica</emphasis>. Você deverá especificar o nome da classe usando a forma + padrão, por exemplo: <literal>eg.Foo$Bar</literal>. + </para> + + <para> + Classes imutáveis, <literal>mutable="false"</literal>, não podem ser modificadas ou excluídas + pela aplicação. Isso permite ao Hibernate fazer alguns aperfeiçoamentos de performance. + </para> + + <para> + O atributo opcional <literal>proxy</literal> habilita a inicialização tardia das + instâncias persistentes da classe. O Hibernate irá retornar CGLIB proxies como implementado + na interface nomeada. O objeto persistente atual será carregado quando um método do proxy + for invocado. Veja "Inicializando coleções e proxies" abaixo. + </para> + + <para>Polimorfismo <emphasis>implícito</emphasis> significa que instâncias de uma classe + serão retornada por uma query que dá nome a qualquer superclasse ou interface implementada, + ou a classe e as instancias de qualquer subclasse da classe será retornada por umq query + que nomeia a classe por si. Polimorfismo <emphasis>explícito</emphasis> significa que + instancias da classe serão retornadas apenas por queries que explicitamente nomeiam a + classe e que queries que nomeiam as classes irão retornar apenas instancias de subclasses + mapeadas dentro da declaração <literal><class></literal> como uma + <literal><subclass></literal> ou <literal><joined-subclass></literal>. + Para a maioria dos casos, o valor default <literal>polymorphism="implicit"</literal>, + é apropriado. Polimorfismo explicito é útil quando duas classes distintas estão mapeadas + para a mesma tabela (isso permite um classe "peso leve" que contem um subconjunto + de colunas da tabela). + </para> + + <para> + O atributo <literal>persister</literal> deixa você customizar a estratégia de persistência + utilizada para a classe. Você pode, por exemplo, especificar sua prórpia subclasse do + <literal>org.hibernate.persister.EntityPersister</literal> ou você pode criar + uma implementação completamente nova da interface + <literal>org.hibernate.persister.ClassPersister</literal> que implementa a persistência + através de, por exemplo, chamadas a stored procedeures, serialização de arquivos flat ou + LDAP. Veja <literal>org.hibernate.test.CustomPersister</literal> para um exemplo + simples (de "persistencia" para uma <literal>Hashtable</literal>). + </para> + + <para> + Observe que as configurações <literal>dynamic-update</literal> e + <literal>dynamic-insert</literal> não sao herdadas pelas subclasses e assim podem tambem + ser especificadas em elementos <literal><subclass></literal> or + <literal><joined-subclass></literal>. Estas configurações podem incrementar a + performance em alguns casos, mas pode realmente diminuir a performance em outras. + Use-as de forma bastante criteriosa. + </para> + + <para> + O uso de <literal>select-before-update</literal> geralmente irá diminuir a performance. Ela é + muito útil para prevenir que uma trigger de atualização no banco de dados seja ativada + desnecessariamente, se você reconectar um nó de uma instancia desconectada em uma + <literal>Session</literal>. + </para> + + <para> + Se você ativar <literal>dynamic-update</literal>, você terá de escolher + a estratégia de bloqueio otimista: + </para> + <itemizedlist> + <listitem> + <para> + <literal>version</literal> verifica a versão e a hora das colunas + </para> + </listitem> + <listitem> + <para> + <literal>all</literal> cverifica todas as colunas + </para> + </listitem> + <listitem> + <para> + <literal>dirty</literal> verifica as colunas modificadas, permitindo + alguns updates concorrentes + </para> + </listitem> + <listitem> + <para> + <literal>none</literal> não utiliza o bloqueio otimista + </para> + </listitem> + </itemizedlist> + <para> + Nós <emphasis>recomendamos</emphasis> com muita enfase que você utilize a + versão e a hora das colunas para o bloqueio otimista com o Hibernate. + Esta é a melhor estratégia com respeito a performance e é a única estratégia + que trata corretamente as modificações efetuadas em instancias desconectadas + (por exemplo, quando <literal>Session.merge()</literal> é utilizado). + + </para> + + <para> + Não ha diferença entre uma view e uma tabela para o mapeamento do Hibernate, e como + esperado isto é transparente no nível do banco de dados (observe que alguns bancos de + dados não suportam views apropriadamente, especialmente com updates). Algumas vezes, + você quer utilizar uma view, ma snão pode cria-la no banco de dados (por exemplo, + com um esquema legado). Neste caso, você pode mapear uma entidade imutável e de + somente leitura, para uma dada expressão SQL, que representa um subselect: + </para> + + <programlisting><![CDATA[<class name="Summary"> + <subselect> + select item.name, max(bid.amount), count(*) + from item + join bid on bid.item_id = item.id + group by item.name + </subselect> + <synchronize table="item"/> + <synchronize table="bid"/> + <id name="name"/> + ... +</class>]]></programlisting> + + <para> + Declare as tabelas para sincronizar com esta entidade, garantindo que o auto-flush + ocorra corretamente, e que as queries para esta entidade derivada não retornem dados + desatualizados. O <literal><subselect></literal> está disponível tanto como um + atributo como um elemento mapeado nested. + </para> + + </sect2> + + <sect2 id="mapping-declaration-id" revision="4"> + <title>id</title> + + <para> + Classes mapeadas <emphasis>precisam</emphasis> declarar a coluna de chave primaria da + tabela do banco de dados. Muitas classes irão tambem ter uma propriedade ao estilo + Java-Beans declarando o identificador unico de uma instancia. O elemento + <literal><id></literal> define o mapeamento desta propriedade para a chave primária. + </para> + + <programlistingco> + <areaspec> + <area id="id1" coords="2 70"/> + <area id="id2" coords="3 70" /> + <area id="id3" coords="4 70"/> + <area id="id4" coords="5 70" /> + <area id="id5" coords="6 70" /> + </areaspec> + <programlisting><![CDATA[<id + name="propertyName" + type="typename" + column="column_name" + unsaved-value="null|any|none|undefined|id_value" + access="field|property|ClassName"> + node="element-name|@attribute-name|element/@attribute|." + + <generator class="generatorClass"/> +</id>]]></programlisting> + <calloutlist> + <callout arearefs="id1"> + <para> + <literal>name</literal> (opcional): O nome do identificador. + </para> + </callout> + <callout arearefs="id2"> + <para> + <literal>type</literal> (opcional): Um nome que indica o tipo no Hibernate. + </para> + </callout> + <callout arearefs="id3"> + <para> + <literal>column</literal> (opcional – default para o a propridade name): O + nome coluna chave primaria. + </para> + </callout> + <callout arearefs="id4"> + <para> + <literal>unsaved-value</literal> (opcional - default para um valor "sensível"): + Uma propriedade de identificação que indica que a instancia foi novamente + instanciada (unsaved), diferenciando de instancias desconectadas que foram + salvas ou carregadas em uma sessão anterior. + </para> + </callout> + <callout arearefs="id5"> + <para> + <literal>access</literal> (opcional - valor default <literal>property</literal>): A + estratégia que o Hiberante deve utilizar para acessar o valor da propriedade + </para> + </callout> + </calloutlist> + </programlistingco> + + <para> + Se o atributo <literal>name</literal> não for declarado, assume-se que a classe não tem + a propriedade de identificação. + </para> + + <para> + O atributo <literal>unsaved-value</literal> não é mais necessário no Hibernate 3. + </para> + + <para> + Há declaração alternativa <literal><composite-id></literal> permite o acesso a + dados legados com chaves compostas. Nós desencorajamos fortemente o seu uso por + qualquer pessoa. + </para> + + <sect3 id="mapping-declaration-id-generator" revision="2"> + <title>Generator</title> + + <para> + O elemento filho opcional <literal><generator></literal> nomeia uma classe Java + usada para gerar identificadores unicos para instancias de uma classe persistente. + Se algum parâmetro é requerido para configurar ou inicializar a instancia geradora, + eles são passados utilizando o elemento <literal><param></literal>. + </para> + + <programlisting><![CDATA[<id name="id" type="long" column="cat_id"> + <generator class="org.hibernate.id.TableHiLoGenerator"> + <param name="table">uid_table</param> + <param name="column">next_hi_value_column</param> + </generator> +</id>]]></programlisting> + + <para> + Todos os generators implementam a interface <literal>org.hibernate.id.IdentifierGenerator</literal>. + Esta é uma interface bem simples; algumas aplicações podem prover sua própria implementação + esepecializada. Entretanto, o Hibernate disponibiliza um conjunto de implementações internamente. + Há nomes de atalhos para estes generators próprios: + <variablelist> + <varlistentry> + <term><literal>increment</literal></term> + <listitem> + <para> + gera identificadores dos tipos <literal>long</literal>, <literal>short</literal> ou + <literal>int</literal> que são unicos apenas quando nenhum outro processo está + inserindo dados na mesma tabela. <emphasis>Não utilize em ambientes + de cluster.</emphasis> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>identity</literal></term> + <listitem> + <para> + suporta colunas de identidade em DB2, MySQL, MS SQL Server, Sybase e + HypersonicSQL. O identificador retornado é do tipo <literal>long</literal>, + <literal>short</literal> ou <literal>int</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>sequence</literal></term> + <listitem> + <para> + utiliza uma sequence em DB2, PostgreSQL, Oracle, SAP DB, McKoi ou um + generator no Interbase. O identificador de retorno é do tipo <literal> + long</literal>, <literal>short</literal> ou <literal>int</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>hilo</literal></term> + <listitem> + <para id="mapping-declaration-id-hilodescription" revision="1"> + utiliza um algoritmo hi/lo para gerar de forma eficiente identificadores do tipo + <literal>long</literal>, <literal>short</literal> ou <literal>int</literal>, + a partir de uma tabela e coluna fornecida (por default + <literal>hibernate_unique_key</literal> e <literal>next_hi</literal>) + como fonte para os valores hi. O algoritmo hi/lo gera identificadores que são + únicos apenas para um banco de dados particular. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>seqhilo</literal></term> + <listitem> + <para> + utiliza um algoritmo hi/lo para gerar de forma eficinete identificadores do tipo + <literal>long</literal>, <literal>short</literal> ou <literal>int</literal>, + a partir de uma sequence de banco de dados fornecida. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>uuid</literal></term> + <listitem> + <para> + utiliza um algortimo UUID de 128-bits para gerar identificadores do + tipo string, unicos em uma rede(o endereço IP é utilizado). O UUID é + codificado como um string de digitos hexadecimais de tamanho 32. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>guid</literal></term> + <listitem> + <para> + utiliza um string GUID gerado pelo banco de dados no MS SQL Server + e MySQL. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>native</literal></term> + <listitem> + <para> + seleciona entre <literal>identity</literal>, <literal>sequence</literal> + ou <literal>hilo</literal> dependendo das capacidades do banco de dados + utilizado. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>assigned</literal></term> + <listitem> + <para> + deixa a aplicação definir um identificador para o objeto antes que o + <literal>save()</literal> seja chamado. Esta é a estratégia default + se nenhum elemento <literal><generator></literal> é especificado. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>select</literal></term> + <listitem> + <para> + retorna a chave primaria recuperada por uma trigger do banco de + dados, selecionado uma linha pela chave única e recuperando o valor + da chave primária. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>foreign</literal></term> + <listitem> + <para> + utiliza o identificador de um outro objeto associado. Normalmente utilizado + em conjunto com uma associaçõa de chave primária do tipo + <literal><one-to-one></literal>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>sequence-identity</literal></term> + <listitem> + <para> + a specialized sequence generation strategy which utilizes a + database sequence for the actual value generation, but combines + this with JDBC3 getGeneratedKeys to actually return the generated + identifier value as part of the insert statement execution. This + strategy is only known to be supported on Oracle 10g drivers + targetted for JDK 1.4. Note comments on these insert statements + are disabled due to a bug in the Oracle drivers. + </para> + </listitem> + </varlistentry> + </variablelist> + + </para> + </sect3> + + <sect3 id="mapping-declaration-id-hilo" revision="1"> + <title>Algoritmo Hi/lo</title> + <para> + Os geradores <literal>hilo</literal> e <literal>seqhilo</literal> fornecem duas + implementações alternativas do algoritmo hi/lo, uma solução preferencial para a geração + de identificadores. A primeira implementação requer uma tabela especial do banco de + dados para manter o proximo valor "hi" disponível. A segunda utiliza uma seqüência + do estilo Oracle (quando suportado). + </para> + + <programlisting><![CDATA[<id name="id" type="long" column="cat_id"> + <generator class="hilo"> + <param name="table">hi_value</param> + <param name="column">next_value</param> + <param name="max_lo">100</param> + </generator> +</id>]]></programlisting> + + <programlisting><![CDATA[<id name="id" type="long" column="cat_id"> + <generator class="seqhilo"> + <param name="sequence">hi_value</param> + <param name="max_lo">100</param> + </generator> +</id>]]></programlisting> + + <para> + Infelizemente, voce não pode utilizar <literal>hilo</literal> quando estiver + fornecendo sia propria <literal>Connection</literal> para o Hibernate. Quando o + Hibernate está usando um datasource do servidor de aplicações para obter conexões + suportadas com JTA, você precisa configurar adequadamente o + <literal>hibernate.transaction.manager_lookup_class</literal>. + </para> + </sect3> + + <sect3 id="mapping-declaration-id-uuid"> + <title>UUID algorithm</title> + <para> + O UUID contem: o endereço IP, hora de inicio da JVM (com precisão de um quarto + de segundo), a hora do sistema e um valor contador (unico dentro da JVM). + Não é possivel obter o endereço MAC ou um endereço de memória do código Java, + assim este é o melhor que pode ser feito sem utilizar JNI. + </para> + </sect3> + + <sect3 id="mapping-declaration-id-sequences"> + <title>Colunas de identidade e sequencias</title> + <para> + Para bancos de dados que suportam colunas de identidade (DB2, MySQL, Sybase, + MS SQL), você pode utilizar uma geração de chave <literal>identity</literal>. + Para bancos de dados que suportam sequencias (DB2, Oracle, PostgreSQL, Interbase, + McKoi, SAP DB) voce pode utilizar a geração de chaves no estilo + <literal>sequence</literal>. As duas estratégias requerem duas consultas SQL + para inserir um novo objeto. + </para> + + <programlisting><![CDATA[<id name="id" type="long" column="person_id"> + <generator class="sequence"> + <param name="sequence">person_id_sequence</param> + </generator> +</id>]]></programlisting> + + <programlisting><![CDATA[<id name="id" type="long" column="person_id" unsaved-value="0"> + <generator class="identity"/> +</id>]]></programlisting> + + <para> + Para desenvolvimento multi-plataforma, a estratégia <literal>native</literal> + irá escolher entre as estratégias i <literal>identity</literal>, + <literal>sequence</literal> e <literal>hilo</literal>, dependendo das + capacidades do banco de dados utilizado. + </para> + </sect3> + + <sect3 id="mapping-declaration-id-assigned"> + <title>Identificadores especificados</title> + <para> + Se você quer que a aplicação especifique os identificadores + (em vez do Hibernate gerá-los) você deve utilizar o gerador + <literal>assigned</literal>. Este gerador especial irá utilizar o valor + do identificador especificado para a propriedade de identificação do objeto. + Este gerador é usado quando a chave primaria é a chave natural em vez de uma + surrogate key. Este é o comportamento padrão se você não especificar + um elemento <literal><generator></literal>. + </para> + + <para> + Escolher o gerador <literal>assigned</literal> faz com que o Hibernate + utilize <literal>unsaved-value="undefined"</literal>, forçando o Hibernate + ir até o banco de dados para determinar se uma instância está transiente ou + desasociada, a menos que haja uma versão ou uma propriedade timestamp, + ou você pode definir <literal>Interceptor.isUnsaved()</literal>. + </para> + </sect3> + + <sect3 id="mapping-declaration-id-select"> + <title>Chaves primárias geradas por triggers</title> + <para> + Apenas para sistemas legados (o Hibernate nao gera DDL com triggers). + </para> + + <programlisting><![CDATA[<id name="id" type="long" column="person_id"> + <generator class="select"> + <param name="key">socialSecurityNumber</param> + </generator> +</id>]]></programlisting> + + <para> + No exemplo acima, há uma única propriedade com valor nomeada + <literal>socialSecurityNumber</literal> definida pela classe, + uma chave natural, e uma surrogate key nomeada + <literal>person_id</literal> cujo valor é gerado pro uma trigger. + </para> + + </sect3> + + </sect2> + <sect2 id="mapping-declaration-id-enhanced"> + <title>Enhanced identifier generators</title> + + <para> + Starting with release 3.2.3, there are 2 new generators which represent a re-thinking of 2 different + aspects of identifier generation. The first aspect is database portability; the second is optimization + (not having to query the database for every request for a new identifier value). These two new + generators are intended to take the place of some of the named generators described above (starting + in 3.3.x); however, they are included in the current releases and can be referenced by FQN. + </para> + + <para> + The first of these new generators is <literal>org.hibernate.id.enhanced.SequenceStyleGenerator</literal> + which is intended firstly as a replacement for the <literal>sequence</literal> generator and secondly as + a better portability generator than <literal>native</literal> (because <literal>native</literal> + (generally) chooses between <literal>identity</literal> and <literal>sequence</literal> which have + largely different semantics which can cause subtle isssues in applications eyeing portability). + <literal>org.hibernate.id.enhanced.SequenceStyleGenerator</literal> however achieves portability in + a different manner. It chooses between using a table or a sequence in the database to store its + incrementing values depending on the capabilities of the dialect being used. The difference between this + and <literal>native</literal> is that table-based and sequence-based storage have the same exact + semantic (in fact sequences are exactly what Hibernate tries to emmulate with its table-based + generators). This generator has a number of configuration parameters: + <itemizedlist spacing="compact"> + <listitem> + <para> + <literal>sequence_name</literal> (optional, defaults to <literal>hibernate_sequence</literal>): + The name of the sequence (or table) to be used. + </para> + </listitem> + <listitem> + <para> + <literal>initial_value</literal> (optional, defaults to <literal>1</literal>): The initial + value to be retrieved from the sequence/table. In sequence creation terms, this is analogous + to the clause typical named "STARTS WITH". + </para> + </listitem> + <listitem> + <para> + <literal>increment_size</literal> (optional, defaults to <literal>1</literal>): The value by + which subsequent calls to the sequence/table should differ. In sequence creation terms, this + is analogous to the clause typical named "INCREMENT BY". + </para> + </listitem> + <listitem> + <para> + <literal>force_table_use</literal> (optional, defaults to <literal>false</literal>): Should + we force the use of a table as the backing structure even though the dialect might support + sequence? + </para> + </listitem> + <listitem> + <para> + <literal>value_column</literal> (optional, defaults to <literal>next_val</literal>): Only + relevant for table structures! The name of the column on the table which is used to + hold the value. + </para> + </listitem> + <listitem> + <para> + <literal>optimizer</literal> (optional, defaults to <literal>none</literal>): + See <xref linkend="mapping-declaration-id-enhanced-optimizers"/> + </para> + </listitem> + </itemizedlist> + </para> + <para> + The second of these new generators is <literal>org.hibernate.id.enhanced.TableGenerator</literal> which + is intended firstly as a replacement for the <literal>table</literal> generator (although it actually + functions much more like <literal>org.hibernate.id.MultipleHiLoPerTableGenerator</literal>) and secondly + as a re-implementation of <literal>org.hibernate.id.MultipleHiLoPerTableGenerator</literal> utilizing the + notion of pluggable optimiziers. Essentially this generator defines a table capable of holding + a number of different increment values simultaneously by using multiple distinctly keyed rows. This + generator has a number of configuration parameters: + <itemizedlist spacing="compact"> + <listitem> + <para> + <literal>table_name</literal> (optional, defaults to <literal>hibernate_sequences</literal>): + The name of the table to be used. + </para> + </listitem> + <listitem> + <para> + <literal>value_column_name</literal> (optional, defaults to <literal>next_val</literal>): + The name of the column on the table which is used to hold the value. + </para> + </listitem> + <listitem> + <para> + <literal>segment_column_name</literal> (optional, defaults to <literal>sequence_name</literal>): + The name of the column on the table which is used to hold the "segement key". This is the + value which distinctly identifies which increment value to use. + </para> + </listitem> + <listitem> + <para> + <literal>segment_value</literal> (optional, defaults to <literal>default</literal>): + The "segment key" value for the segment from which we want to pull increment values for + this generator. + </para> + </listitem> + <listitem> + <para> + <literal>segment_value_length</literal> (optional, defaults to <literal>255</literal>): + Used for schema generation; the column size to create this segment key column. + </para> + </listitem> + <listitem> + <para> + <literal>initial_value</literal> (optional, defaults to <literal>1</literal>): + The initial value to be retrieved from the table. + </para> + </listitem> + <listitem> + <para> + <literal>increment_size</literal> (optional, defaults to <literal>1</literal>): + The value by which subsequent calls to the table should differ. + </para> + </listitem> + <listitem> + <para> + <literal>optimizer</literal> (optional, defaults to <literal></literal>): + See <xref linkend="mapping-declaration-id-enhanced-optimizers"/> + </para> + </listitem> + </itemizedlist> + </para> + </sect2> + + <sect2 id="mapping-declaration-id-enhanced-optimizers"> + <title>Identifier generator optimization</title> + <para> + For identifier generators which store values in the database, it is inefficient for them to hit the + database on each and every call to generate a new identifier value. Instead, you'd ideally want to + group a bunch of them in memory and only hit the database when you have exhausted your in-memory + value group. This is the role of the pluggable optimizers. Currently only the two enhanced generators + (<xref linkend="mapping-declaration-id-enhanced"/> support this notion. + <itemizedlist spacing="compact"> + <listitem> + <para> + <literal>none</literal> (generally this is the default if no optimizer was specified): This + says to not perform any optimizations, and hit the database each and every request. + </para> + </listitem> + <listitem> + <para> + <literal>hilo</literal>: applies a hi/lo algorithm around the database retrieved values. The + values from the database for this optimizer are expected to be sequential. The values + retrieved from the database structure for this optimizer indicates the "group number"; the + <literal>increment_size</literal> is multiplied by that value in memory to define a group + "hi value". + </para> + </listitem> + <listitem> + <para> + <literal>pooled</literal>: like was discussed for <literal>hilo</literal>, this optimizers + attempts to minimize the number of hits to the database. Here, however, we simply store + the starting value for the "next group" into the database structure rather than a sequential + value in combination with an in-memory grouping algorithm. <literal>increment_size</literal> + here refers to the values coming from the database. + </para> + </listitem> + </itemizedlist> + </para> + </sect2> + + + <sect2 id="mapping-declaration-compositeid" revision="3"> + <title>composite-id</title> + + <programlisting><![CDATA[<composite-id + name="propertyName" + class="ClassName" + mapped="true|false" + access="field|property|ClassName"> + node="element-name|." + + <key-property name="propertyName" type="typename" column="column_name"/> + <key-many-to-one name="propertyName class="ClassName" column="column_name"/> + ...... +</composite-id>]]></programlisting> + + <para> + Para tabelas com uma chave composta, você pode mapear múltiplas propriedades + da classe como propriedades de identificação. O elemento + <literal><composite-id></literal> aceita o mapeamento da propriedade + <literal><key-property></literal> e mapeamentos + <literal><key-many-to-one></literal>como elements filhos. + </para> + + <programlisting><![CDATA[<composite-id> + <key-property name="medicareNumber"/> + <key-property name="dependent"/> +</composite-id>]]></programlisting> + + <para> + Sua classe persistente <emphasis>precisa</emphasis> sobre escrever + <literal>equals()</literal> e <literal>hashCode()</literal> para implementar + identificadores compostos igualmente. E precisa também implementar + <literal>Serializable</literal>. + </para> + + <para> + Infelizmente, esta solução para um identificador composto significa que um objeto + persistente é seu próprio identificador. Não há outro "handle" que o próprio objeto. + Você mesmo precisa instanciar uma instância de outra classe persistente e preencher + suas propriedades de identificação antes que você possa dar um <literal>load()</literal> + para o estado persistente associado com uma chave composta. Nos chamamos esta + solução de identificador composto <emphasis>embedded</emphasis> e não aconselhamos + para aplicações sérias. + </para> + + <para> + Uma segunda solução é o que podemos chamar de identificador composto + <emphasis>mapped</emphasis> quando a propriedades de identificação nomeadas dentro do + elemento <literal><composite-id></literal> estão duplicadas tando na classe + persistente como em uma classe de identificação separada. + </para> + + <programlisting><![CDATA[<composite-id class="MedicareId" mapped="true"> + <key-property name="medicareNumber"/> + <key-property name="dependent"/> +</composite-id>]]></programlisting> + + <para> + No exemplo, ambas as classes de identificação compostas, <literal>MedicareId</literal>, + e a própria classe entidade tem propriedades nomeadas <literal>medicareNumber</literal> + e <literal>dependent</literal>. A classe identificadora precisa sobrepor + <literal>equals()</literal> e <literal>hashCode()</literal> e implementar + <literal>Serializable</literal>. A desvantagem desta solução é obvia – + duplicação de código. + </para> + + <para> + Os seguintes atributos ão utilizados para especificar o mapeamento de + um identificador composto: + </para> + + <itemizedlist spacing="compact"> + <listitem> + <para> + <literal>mapped</literal> mapped (opcional, valor default <literal>false + </literal>): indica que um identificar composto mapeado é usado, e que as + propriedades de mapeamento contidas refere-se tanto a classe entidade e + a classe de identificação composta. + </para> + </listitem> + <listitem> + <para> + <literal>class</literal> (opcional, mas requerida para um identificar composto + mapeado): A classe usada como um identificador composto. + </para> + </listitem> + </itemizedlist> + + <para> + Nós iremos descrever uma terceira e as vezes mais conveniente solução, onde o + identificador composto é implementado como uma classe componente na + <xref linkend="components-compositeid"/>. Os atributos descritos abaixo aplicam-se + apenas para esta solução: + </para> + + <itemizedlist spacing="compact"> + <listitem> + <para> + <literal>name</literal> (opcional, requerida para esta solução): Uma + propriedade do tipo componente que armazena o identificador composto + (veja capítulo 9) + </para> + </listitem> + <listitem> + <para> + <literal>access</literal> (opcional - valor default <literal>property</literal>): + A estartégia Hibernate que deve ser utilizada para acessar o valor da propriedade. + </para> + </listitem> + <listitem> + <para> + <literal>class</literal> (opcional - valor default para o tipo de propriedade + determiando por reflexão) : A classe componente utilizada como um identificador + composto (veja a próxima sessão). + </para> + </listitem> + </itemizedlist> + + <para> + Esta terceira solução, um <emphasis>componente de identificação</emphasis>, é o que nós + recomendamos para a maioria das aplicações. + </para> + + </sect2> + + <sect2 id="mapping-declaration-discriminator" revision="3"> + <title>discriminator</title> + + <para> + O elemento <literal><discriminator></literal> é necessário para persistência + polimórfica utilizando a estratégia de mapeamento table-per-class-hierarchy e declara + uma coluna discriminadora da tabela. A coluna discriminadora contem valores de marcação + que dizem a camada de persistência qual subclasse instanciar para uma linha particular. + Um restrito conjunto de tipos que podem ser utilizados: <literal>string</literal>, + <literal>character</literal>, <literal>integer</literal>, <literal>byte</literal>, + <literal>short</literal>, <literal>boolean</literal>, + <literal>yes_no</literal>, <literal>true_false</literal>. + </para> + + <programlistingco> + <areaspec> + <area id="discriminator1" coords="2 60"/> + <area id="discriminator2" coords="3 60" /> + <area id="discriminator3" coords="4 60" /> + <area id="discriminator4" coords="5 60" /> + <area id="discriminator5" coords="6 60" /> + </areaspec> + <programlisting><![CDATA[<discriminator + column="discriminator_column" + type="discriminator_type" + force="true|false" + insert="true|false" + formula="arbitrary sql expression" +/>]]></programlisting> + <calloutlist> + <callout arearefs="discriminator1"> + <para> + <literal>column</literal> (opcional - valor default <literal>class</literal>) + o nome da coluna discriminadora + </para> + </callout> + <callout arearefs="discriminator2"> + <para> + <literal>type</literal> (opcional - valor default <literal>string</literal>) + o nome que indica o tipo Hibernate + </para> + </callout> + <callout arearefs="discriminator3"> + <para> + <literal>force</literal> (opcional - valor default <literal>false</literal>) + "força" o Hibernate a especificar valores discriminadores permitidos mesmo + quando recuperando todas as instancias da classe root. + </para> + </callout> + <callout arearefs="discriminator4"> + <para> + <literal>insert</literal> (opcional - valor default para <literal>true</literal>) + sete isto para <literal>false</literal> se sua coluna discriminadora é também + parte do identificador composto mapeado. (Diz ao Hibernate para não incluir a + coluna em comandos SQL <literal>INSERT</literal>s). + </para> + </callout> + <callout arearefs="discriminator5"> + <para> + <literal>formula</literal> (opcional) uma expressão SQL arbitraria que é e + xecutada quando um tipo tem que ser avaliado. Permite discriminação baseada + em conteúdo. + </para> + </callout> + </calloutlist> + </programlistingco> + + <para> + Valores atuais de uma coluna discriminada são especificados pelo atributo + <literal>discriminator-value</literal> da <literal><class></literal> + e elementos da <literal><subclass></literal>. + </para> + + <para> + O atributo <literal>force</literal> é util (apenas) em tabelas contendo linhas com + valores discriminadores "extras" que não estão mapeados para uma classe persistente. + Este não é geralmente o caso. + </para> + + <para> + Usando o atributo <literal>formula</literal> voce pode declarar uma expressão SQL + arbitrária que sera utilizada para avaliar o tipo de uma linha : + </para> + + <programlisting><![CDATA[<discriminator + formula="case when CLASS_TYPE in ('a', 'b', 'c') then 0 else 1 end" + type="integer"/>]]></programlisting> + + </sect2> + + <sect2 id="mapping-declaration-version" revision="4"> + <title>version (optional)</title> + + <para> + O elemento <literal><version></literal> é opcional e indica que a tabela + possui dados versionados. Isto é particularmente útil se você planeja utilizar + <emphasis>transações longas</emphasis> (veja abaixo): + </para> + + <programlistingco> + <areaspec> + <area id="version1" coords="2 70"/> + <area id="version2" coords="3 70"/> + <area id="version3" coords="4 70"/> + <area id="version4" coords="5 70"/> + <area id="version5" coords="6 70"/> + <area id="version6" coords="7 70"/> + <area id="version7" coords="8 70"/> + </areaspec> + <programlisting><![CDATA[<version + column="version_column" + name="propertyName" + type="typename" + access="field|property|ClassName" + unsaved-value="null|negative|undefined" + generated="never|always" + insert="true|false" + node="element-name|@attribute-name|element/@attribute|." +/>]]></programlisting> + <calloutlist> + <callout arearefs="version1"> + <para> + <literal>column</literal> (opcional - default a a propriedade name): O nome da + coluna mantendo o numero da versão + </para> + </callout> + <callout arearefs="version2"> + <para> + <literal>name</literal>: O nome da propriedade da classe persistente. + </para> + </callout> + <callout arearefs="version3"> + <para> + <literal>type</literal> (opcional - valor default para <literal>integer</literal>): + O tipo do numero da versão + </para> + </callout> + <callout arearefs="version4"> + <para> + <literal>access</literal> (opcional - valor default <literal>property</literal>): + A estratégia Hibernate que deve ser usada para acessar o valor da propriedade. + </para> + </callout> + <callout arearefs="version5"> + <para> + <literal>unsaved-value</literal> (opcional – valor default para <literal>undefined + </literal>): Um valor para a propriedade versão que indica que uma instancia é + uma nova instanciada (unsaved), distinguindo de instancias desconectadas que foram + salvas ou carregadas em sessões anteriores. ((<literal>undefined</literal> especifica + que o valor da propriedade de identificação deve ser utilizado). + </para> + </callout> + <callout arearefs="version6"> + <para> + <literal>generated</literal> (optional - defaults to <literal>never</literal>): + Specifies that this version property value is actually generated by the database. + See the discussion of <xref linkend="mapping-generated">generated properties</xref>. + <literal>generated</literal> (opcional - valor default <literal>never</literal>): + Especifica que valor para a propriedade versão é na verdade gerado pelo banco de + dados. Veja a discussão da Seção + <xref linkend="mapping-generated">generated properties</xref>. + </para> + </callout> + <callout arearefs="version7"> + <para> + <literal>insert</literal> (opcional - valor default para <literal>true</literal>): + Especifica se a coluna de versão deve ser incluída no comando SQL de insert. + Pode ser configurado como <literal>false</literal> se a coluna do banco de dados + está definida com um valor default de <literal>0</literal>. + </para> + </callout> + </calloutlist> + </programlistingco> + + <para> + Números de versão podem ser dos tipos Hibernate <literal>long</literal>, + <literal>integer</literal>, <literal>short</literal>, <literal>timestamp</literal> ou + <literal>calendar</literal>. + </para> + + <para> + A versão de uma propriedade timestamp nunca deve ser nula para uma instancia + desconectada, assim o Hibernate irá identificar qualquer instância com uma versão + nula ou timestamp como transiente, não importando qual estratégia para foi + especificada para <literal>unsaved-value</literal>. <emphasis>Declarando uma versão + nula ou a propriedade timestamp é um caminho fácil para tratar problemas com + reconexões transitivas no Hibernate, especialmente úteis para pessoas utilizando + identificadores assinaldados ou chaves compostas!</emphasis> + </para> + </sect2> + + <sect2 id="mapping-declaration-timestamp" revision="4" > + <title>timestamp (optional)</title> + + <para> + O elemento opcional <literal><timestamp></literal> indica que uma tabela contém + dados timestamped. Isso tem por objetivo dar uma alternativa para versionamento. Timestamps + são por natureza uma implementação menos segura do locking otimista. Entretanto, algumas + vezes a aplicação pode usar timestamps em outros caminhos. + </para> + + <programlistingco> + <areaspec> + <area id="timestamp1" coords="2 70"/> + <area id="timestamp2" coords="3 70" /> + <area id="timestamp3" coords="4 70" /> + <area id="timestamp4" coords="5 70" /> + <area id="timestamp5" coords="6 70" /> + <area id="timestamp6" coords="7 70" /> + </areaspec> + <programlisting><![CDATA[<timestamp + column="timestamp_column" + name="propertyName" + access="field|property|ClassName" + unsaved-value="null|undefined" + source="vm|db" + generated="never|always" + node="element-name|@attribute-name|element/@attribute|." +/>]]></programlisting> + <calloutlist> + <callout arearefs="timestamp1"> + <para> + <literal>column</literal> (opcional - valor default para a propriedade name): + O nome da coluna que mantem o timestamp. + </para> + </callout> + <callout arearefs="timestamp2"> + <para> + <literal>name</literal>: O nome da propriedade no estilo JavaBeans do + tipo <literal>Date</literal> ou <literal>Timestamp</literal> da classe + persistente Java. + </para> + </callout> + <callout arearefs="timestamp3"> + <para> + <literal>access</literal> (opcional - valor default para <literal>property</literal>): + A estretagia Hibernate que deve ser utilizada para acessar o valor da propriedade. + </para> + </callout> + <callout arearefs="timestamp4"> + <para> + <literal>unsaved-value</literal> (opcional - valor default <literal>null</literal>): + Uma propriedade para a versão de que indica que uma instância é uma nova instanciada + (unsaved), distinguindo-a de instancias desconectadas que foram salvas ou carregadas + em sessões previas. (<literal>undefined</literal> especifica que um valor de + propriedade de identificação deve ser utilizado) + </para> + </callout> + <callout arearefs="timestamp5"> + <para> + <literal>source</literal> (opcional - valor default para <literal>vm</literal>): + De onde o Hibernate deve recuperar o valor timestamp? Do banco de dados ou da JVM + corrente? Timestamps baseados em banco de dados levam a um overhead porque o + Hibernate precisa acessar o banco de dados para determinar o "próximo valor", mas é + mais seguro para uso em ambientes de "cluster". Observe também, que nem todos + <literal>Dialect</literal>s suportam a recuperação do timestamp corrente do banco + de dados, enquando outros podem não ser seguros para utilização em bloqueios + pela falta de precisão (Oracle 8 por exemplo) + </para> + </callout> + <callout arearefs="timestamp6"> + <para> + <literal>generated</literal> (opcional - valor default <literal>never</literal>): + Especifica que o valor da propriedade timestamp é gerado pelo banco de dados. + Veja a discussão <xref linkend="mapping-generated">generated properties</xref>. + </para> + </callout> + </calloutlist> + </programlistingco> + + <para> + Observe que <literal><timestamp></literal> é equivalente a + <literal><version type="timestamp"></literal>. E + <literal><timestamp source="db"></literal> é equivalente a + <literal><version type="dbtimestamp"></literal>. + </para> + </sect2> + + + <sect2 id="mapping-declaration-property" revision="4"> + <title>property</title> + + <para> + O elemento <literal><property></literal> declara uma propriedade + persistente de uma classe, no estilo JavaBean. + </para> + + <programlistingco> + <areaspec> + <area id="property1" coords="2 70"/> + <area id="property2" coords="3 70"/> + <area id="property3" coords="4 70"/> + <areaset id="property4-5" coords=""> + <area id="property4" coords='5 70'/> + <area id="property5" coords='6 70'/> + </areaset> + <area id="property6" coords="7 70"/> + <area id="property7" coords="8 70"/> + <area id="property8" coords="9 70"/> + <area id="property9" coords="10 70"/> + <area id="property10" coords="11 70"/> + <area id="property11" coords="12 70"/> + <area id="property12" coords="13 70"/> + </areaspec> + <programlisting><![CDATA[<property + name="propertyName" + column="column_name" + type="typename" + update="true|false" + insert="true|false" + formula="arbitrary SQL expression" + access="field|property|ClassName" + lazy="true|false" + unique="true|false" + not-null="true|false" + optimistic-lock="true|false" + generated="never|insert|always" + node="element-name|@attribute-name|element/@attribute|." + index="index_name" + unique_key="unique_key_id" + length="L" + precision="P" + scale="S" +/>]]></programlisting> + <calloutlist> + <callout arearefs="property1"> + <para> + <literal>name</literal>: o nome da propriedade, iniciando com letra minúscula. + </para> + </callout> + <callout arearefs="property2"> + <para> + <literal>column</literal> (opcional - default para a propriedade name): o nome + da coluna mapeada do banco de dados, Isto pode também ser especificado pelo(s) + elemento(s) <literal><column></literal> aninhados. + + </para> + </callout> + <callout arearefs="property3"> + <para> + <literal>type</literal> (opcional): um nome que indica o tipo Hibernate. + </para> + </callout> + <callout arearefs="property4-5"> + <para> + <literal>update, insert</literal> (opcional - valor default <literal>true</literal>): + especifica que as colunas mapeadas devem ser incluidas nas instruções SQL de + <literal>UPDATE</literal> e/ou <literal>INSERT</literal> . Setar ambas para to + <literal>false</literal> permite uma propridade "derivada" pura cujo valor é + inicializado de outra propriedade que mapeie a mesma coluna(s) ou por uma trigger + ou outra aplicação. + </para> + </callout> + <callout arearefs="property6"> + <para> + <literal>formula</literal> (opcional): uma expressão SQL que definie o valor para + uma propriedade <emphasis>calculada</emphasis>. Propriedades calculadas nao tem + uma coluna de mapeamento para elas. + </para> + </callout> + <callout arearefs="property7"> + <para> + <literal>access</literal> (opcional – valor default <literal>property</literal>): + A estratégia que o Hibernate deve utilizar para acessar o valor da propriedade + </para> + </callout> + <callout arearefs="property8"> + <para> + <literal>lazy</literal> (opcional - valor default para <literal>false</literal>): + Especifica que esta propriedade deve ser trazida de forma "lazy" quando a + instancia da variável é acessada pela primeira vez (requer instrumentação + bytecode em tempo de criação). + </para> + </callout> + <callout arearefs="property9"> + <para> + <literal>unique</literal> (opcional): Habilita a geração de DDL de uma + unica constraint para as colunas. Assim, permite que isto seja o + alvo de uma <literal>property-ref</literal>. + </para> + </callout> + <callout arearefs="property10"> + <para> + <literal>not-null</literal> (opcional): Habilita a geração de DDL de uma + constraint de nulidade para as colunas. + </para> + </callout> + <callout arearefs="property11"> + <para> + <literal>optimistic-lock</literal> (opcional - valor default <literal>true</literal>): + Especifica se mudanças para esta propriedade requerem ou não bloqueio otimista. + Em outras palavras, determina se um incremento de versão deve ocorrer quando + esta propriedade está suja. + </para> + </callout> + <callout arearefs="property12"> + <para> + <literal>generated</literal> (opcional - valor default <literal>never</literal>): + Especifica que o valor da propriedade é na verdade gerado pelo banco de dados. + Veja a discussão da seção + <xref linkend="mapping-generated">generated properties</xref>. + </para> + </callout> + </calloutlist> + </programlistingco> + + <para> + <emphasis>typename</emphasis> pode ser: + </para> + + <orderedlist spacing="compact"> + <listitem> + <para> + The name of a Hibernate basic type (eg. <literal>integer, string, character, + date, timestamp, float, binary, serializable, object, blob</literal>). + O nome do tipo basico do Hibernate (ex., <literal>integer, string, character, + date, timestamp, float, binary, serializable, object, blob</literal>). + </para> + </listitem> + <listitem> + <para> + O nome da classe Java com um tipo básico default (ex. <literal>int, float, + char, java.lang.String, java.util.Date, java.lang.Integer, java.sql.Clob</literal>). + </para> + </listitem> + <listitem> + <para> + O nome da classe Java serializable + </para> + </listitem> + <listitem> + <para> + O nome da classe de um tipo customizado (ex. <literal>com.illflow.type.MyCustomType</literal>). + </para> + </listitem> + </orderedlist> + + <para> + Se você não especificar um tipo, o Hibernate ira utilizar reflexão sobre a + propriedade nomeada para ter uma idéia do tipo Hibernate correto. O Hibernate ira + tentar interpretar o nome da classe retornada, usando as regras 2, 3 e 4 nesta ordem. + Entretanto, isto não é sempre suficiente Em certos casos, você ainda irá necessitar + do atributo <literal>type</literal>. (Por exemplo, para distinguir entre + <literal>Hibernate.DATE</literal> ou <literal>Hibernate.TIMESTAMP</literal>, + ou para espcificar uma tipo ciustomizado.) + </para> + + <para> + O atributo <literal>access</literal> permite voce controlar como o Hibernate irá + acessar a propriedade em tempo de execução. Por default, o Hibernate irá chamar os + métodos get/set da propriedades. Se voce especificar <literal>access="field"</literal>, + o Hibernate ira bipassar os metodos get/set, acessnado o campo diretamente, + usando reflexão. Voc epode especificar sua própria estratégia para acesso da + propriedade criando uma classe que implemente a interface + <literal>org.hibernate.property.PropertyAccessor</literal>. + </para> + + <para> + Um recurso especialmente poderoso é o de propriedades derivadas. Estas propriedades + são por definição read-only, e o valor da propriedade é calculado em tempo de execução. + Você declara este calculo como uma expressão SQL, que traduz para clausula + <literal>SELECT</literal> de uma subquery daquery SQL que carrega a instancia: + </para> + + <programlisting><![CDATA[ +<property name="totalPrice" + formula="( SELECT SUM (li.quantity*p.price) FROM LineItem li, Product p + WHERE li.productId = p.productId + AND li.customerId = customerId + AND li.orderNumber = orderNumber )"/>]]></programlisting> + + <para> + Observe que você pode referenciar as entidades da própria tabela, + através da não declaração de um alias para uma coluna particular ( + <literal>customerId</literal> no exemplo dado). Observe tambem que voce pode usar o + mapeamento de elemento aninhado <literal><formula></literal>, se você não + gostar de usar o atributo. + </para> + + </sect2> + + <sect2 id="mapping-declaration-manytoone" revision="5"> + <title>many-to-one</title> + + <para> + Uma associação ordinária para outra classe persistente é declarada usando o + elemento <literal>many-to-one</literal>. O modelo relacional é uma + associação many-to-one: a uma chave estrangeira de uma tabela referenciando + a chave primaria da tabela destino. + </para> + + <programlistingco> + <areaspec> + <area id="manytoone1" coords="2 70"/> + <area id="manytoone2" coords="3 70"/> + <area id="manytoone3" coords="4 70"/> + <area id="manytoone4" coords="5 70"/> + <area id="manytoone5" coords="6 70"/> + <areaset id="manytoone6-7" coords=""> + <area id="manytoone6" coords='7 70'/> + <area id="manytoone7" coords='8 70'/> + </areaset> + <area id="manytoone8" coords="9 70"/> + <area id="manytoone9" coords="10 70"/> + <area id="manytoone10" coords="11 70"/> + <area id="manytoone11" coords="12 70"/> + <area id="manytoone12" coords="13 70"/> + <area id="manytoone13" coords="14 70"/> + <area id="manytoone14" coords="15 70"/> + <area id="manytoone15" coords="16 70"/> + <area id="manytoone16" coords="17 70"/> + </areaspec> + <programlisting><![CDATA[<many-to-one + name="propertyName" + column="column_name" + class="ClassName" + cascade="cascade_style" + fetch="join|select" + update="true|false" + insert="true|false" + property-ref="propertyNameFromAssociatedClass" + access="field|property|ClassName" + unique="true|false" + not-null="true|false" + optimistic-lock="true|false" + lazy="proxy|no-proxy|false" + not-found="ignore|exception" + entity-name="EntityName" + formula="arbitrary SQL expression" + node="element-name|@attribute-name|element/@attribute|." + embed-xml="true|false" + index="index_name" + unique_key="unique_key_id" + foreign-key="foreign_key_name" +/>]]></programlisting> + <calloutlist> + <callout arearefs="manytoone1"> + <para> + <literal>name</literal>: O nome da propriedade. + </para> + </callout> + <callout arearefs="manytoone2"> + <para> + <literal>column</literal> (opcional): O nome da coluna foreign key. Isto + pode também ser especificado através de elementos aninhados + <literal><column></literal>. + </para> + </callout> + <callout arearefs="manytoone3"> + <para> + <literal>class</literal> (opcional – default para o tipo de propriedade + determinado pela reflexão). O nome da classe associada. + </para> + </callout> + <callout arearefs="manytoone4"> + <para> + <literal>cascade</literal> (opcional): Especifica quais operações dever + ser em cascata do objeto pai para o objeto associado. + </para> + </callout> + <callout arearefs="manytoone5"> + <para> + <literal>fetch</literal> (opcional - default para <literal>select</literal>): + Escolhe entre recuperação outer-join ou recuperação seqüencial. + </para> + </callout> + <callout arearefs="manytoone6-7"> + <para> + <literal>update, insert</literal> (opcional - valor default <literal>true</literal>): + especifica que as colunas mapeadas dever ser incluidas em instruções SQL de + <literal>UPDATE</literal> e/ou <literal>INSERT</literal>. Setando ambas para + <literal>false</literal> você permite uma associação "derivada" pura cujos valores + são inicializados de algumas outras propriedades que mapeiam a mesma coluna ou + por uma trigger ou outra aplicação. + </para> + </callout> + <callout arearefs="manytoone8"> + <para> + <literal>property-ref</literal>: (opcional) O nome da propriedade da classe associada + que faz a junção desta foreign key. Se não especificada, a chave primaria da + classe associada será utilizada. + </para> + </callout> + <callout arearefs="manytoone9"> + <para> + <literal>access</literal> (opcional - valor default <literal>property</literal>): A + estrategia que o Hibernate deve utilizar para acessar o valor da propriedade. + </para> + </callout> + <callout arearefs="manytoone10"> + <para> + <literal>unique</literal> (opcional): Habilita a geração DDL de uma constraint + unique para a coluna foreign-key. Alem disso, permite ser o alvo de uma + <literal>property-ref</literal>. Isso torna a associação multipla + efetivamente um para um. + </para> + </callout> + <callout arearefs="manytoone11"> + <para> + <literal>not-null</literal> (opcional): Habilita a geração DDL de uma constraint de + nulidade para as foreign keys. + </para> + </callout> + <callout arearefs="manytoone12"> + <para> + <literal>optimistic-lock</literal> (opcional - valor default <literal>true</literal>): + Especifica se mudanças desta propriedade requerem ou não travamento otimista. + Em outras palavras, determina se um incremento de versão deve ocorrer quando + esta propriedade está suja. + </para> + </callout> + <callout arearefs="manytoone13"> + <para> + <literal>lazy</literal>(opcional – valor default <literal>proxy</literal>): + Por default, associações de ponto unico são envoltas em um proxie. + <literal>lazy="no-proxy"</literal> especifica que a propriedade deve ser + trazida de forma tardia quando a instancia da variável é acessada pela + primeira vez (requer instrumentação bytecode em tempo de criação) + <literal>lazy="false"</literal> especifica que a associação será + sempre recuperada fortemente. + </para> + </callout> + <callout arearefs="manytoone14"> + <para> + <literal>not-found</literal> (opcional - valor default <literal>exception</literal>): + Especifica como as foreign keys que referenciam linhas ausentes serão tratadas: + <literal>ignore</literal> irá tratar a linha ausente como ama associaççao de null + </para> + </callout> + <callout arearefs="manytoone15"> + <para> + <literal>entity-name</literal> (opcional): O nome da entidade da classe associada. + </para> + </callout> + </calloutlist> + <callout arearefs="manytoone16"> + <para> + <literal>formula</literal> (optional): Uma expressão SQL que define um valor + para um foreign key <emphasis>computed</emphasis>. + </para> + </callout> + </programlistingco> + + <para> + Setar o valor do atributo <literal>cascade</literal> para qualquer valor + significativo diferente de <literal>none</literal> irá propagar certas operações + ao objeto associado. Os valores significativos são os nomes das operações básicas + do Hibernate, <literal>persist, merge, delete, save-update, evict, replicate, lock, + refresh</literal>, assim como os valores especiais <literal>delete-orphan</literal> + e <literal>all</literal> e combinações de nomes de operações separadas por vírgula, + como por exemplo, <literal>cascade="persist,merge,evict"</literal> ou + <literal>cascade="all,delete-orphan"</literal>. Veja a seção + <xref linkend="objectstate-transitive"/> para uma explicação completa. Note que + associações valoradas simples (associações muitos-pra-um, e um-pra-um) não suportam + orphan delete. + </para> + + <para> + Uma típica declaração <literal>muitos-pra-um</literal> se parece com esta: + </para> + + <programlisting><![CDATA[<many-to-one name="product" class="Product" column="PRODUCT_ID"/>]]></programlisting> + + <para> + O atributo <literal>property-ref</literal> deve apenas ser usado para mapear dados + legados onde uma chave estrangeira se referencia a uma chave exclusiva da tabela + associada que não seja à chave primária. Este é um modelo relacional desagradável. + Por exemplo, suponha que a classe <literal>Product</literal> tenha um número + seqüencial exclusivo, que não é a chave primária. (O atributo <literal>unique</literal> + controla a geração de DDL do Hibernate com a ferramenta SchemaExport.) + </para> + + <programlisting><![CDATA[<property name="serialNumber" unique="true" type="string" column="SERIAL_NUMBER"/>]]></programlisting> + + <para> + Então o mapeamento para <literal>OrderItem</literal> poderia usar: + </para> + + <programlisting><![CDATA[<many-to-one name="product" property-ref="serialNumber" column="PRODUCT_SERIAL_NUMBER"/>]]></programlisting> + + <para> + Porém, isto obviamente não é indicado, nunca. + </para> + + <para> + Se a chave exclusiva referenciada engloba múltiplas propriedades da entidade associada, + você deve mapear as propriedades referenciadas dentro de um elemento chamado + <literal><properties></literal> + + </para> + + <para> + Se a chave exclusiva referenciada é a propriedade de um componente, você pode especificar + um caminho para a propriedade. + </para> + + <programlisting><![CDATA[<many-to-one name="owner" property-ref="identity.ssn" column="OWNER_SSN"/>]]></programlisting> + + </sect2> + + <sect2 id="mapping-declaration-onetoone" revision="3"> + <title>one-to-one (um-pra-um)</title> + + <para> + Uma associação um-pra-um para outra classe persistente é declarada usando + um elemento <literal>one-to-one </literal>. + </para> + + <programlistingco> + <areaspec> + <area id="onetoone1" coords="2 70"/> + <area id="onetoone2" coords="3 70"/> + <area id="onetoone3" coords="4 70"/> + <area id="onetoone4" coords="5 70"/> + <area id="onetoone5" coords="6 70"/> + <area id="onetoone6" coords="7 70"/> + <area id="onetoone7" coords="8 70"/> + <area id="onetoone8" coords="9 70"/> + <area id="onetoone9" coords="10 70"/> + <area id="onetoone10" coords="11 70"/> + </areaspec> + <programlisting><![CDATA[<one-to-one + name="propertyName" + class="ClassName" + cascade="cascade_style" + constrained="true|false" + fetch="join|select" + property-ref="propertyNameFromAssociatedClass" + access="field|property|ClassName" + formula="any SQL expression" + lazy="proxy|no-proxy|false" + entity-name="EntityName" + node="element-name|@attribute-name|element/@attribute|." + embed-xml="true|false" + foreign-key="foreign_key_name" +/>]]></programlisting> + <calloutlist> + <callout arearefs="onetoone1"> + <para> + <literal>name</literal>: O nome da propriedade. + </para> + </callout> + <callout arearefs="onetoone2"> + <para> + <literal>class</literal> (opcional – default para o tipo da propriedade + definido via reflection): O nome da classe associada. + </para> + </callout> + <callout arearefs="onetoone3"> + <para> + <literal>cascade</literal> (opcional): Especifica qual operação deve + ser cascateada do objeto pai para o objeto associado. + </para> + </callout> + <callout arearefs="onetoone4"> + <para> + <literal>constrained</literal> (opcional): Especifica que uma chave estrangeira + constraint na chave primária da tabela mapeada referencia a tabela da classe + associada, Esta opção afeta a ordem em queh <literal>save()</literal> e + <literal>delete()</literal> são cascateadas, e determina se a associação + pode ser substituída (isto também é usado pela ferramenta schema export). + </para> + </callout> + <callout arearefs="onetoone5"> + <para> + <literal>fetch</literal> ((opcional – valor default <literal>select</literal>): + Escolhe entre outer-join fetching ou sequential select fetching. + </para> + </callout> + <callout arearefs="onetoone6"> + <para> + <literal>property-ref</literal>(opcional): O nome da propriedade da classe associada + que é ligada a chave primária desta classe. Se não for especificada, a chave primária + da classe associada é utilizada. + </para> + </callout> + <callout arearefs="onetoone7"> + <para> + <literal>access</literal> (opcional - valor default padrão <literal>property</literal>): + A estratégia que o Hibernate pode usar para acessar o valor da propriedade. + </para> + </callout> + <callout arearefs="onetoone8"> + <para> + <literal>formula</literal> (opcional): Quase todas associações um-pra-um mapeiam + para a chave primária da entidade dona. No caso raro, que não é o caso, você + pode especificar uma outra coluna, colunas ou expressões para juntar utilizando + uma formula SQL. (Veja <literal>org.hibernate.test.onetooneformula</literal> + para exemplo). + </para> + </callout> + <callout arearefs="onetoone9"> + <para> + <literal>lazy</literal> (opcional – valor default <literal>proxy</literal>): + Por default, associações single point são proxied. <literal>lazy="no-proxy"</literal> + especifica que a propriedade deve ser fetched lazily quando o atributo é acessado + pela primeira vez (requer build-time bytecode instrumentation). + <literal>lazy="false"</literal> especifica que a associação vai sempre ser + avidamente fetched. <emphasis>Note que se <literal>constrained="false"</literal>, + proxing é impossível e o Hibernate vai ávido fetch a associação!</emphasis> + </para> + </callout> + <callout arearefs="onetoone10"> + <para> + <literal>entity-name</literal> (opcional): O nome da entidade da classe associada. + </para> + </callout> + </calloutlist> + </programlistingco> + + <para> + Existem duas variedades de associações um-pra-um: + </para> + <itemizedlist> + <listitem><para> + associações de chave primária + </para></listitem> + <listitem><para> + associações de chave estrangeira exclusiva + </para></listitem> + </itemizedlist> + + <para> + Associações de chave primária não necessitam de uma coluna extra de tabela; se duas + linhas são relacionadas pela associação então as duas linhas da tabela dividem a mesmo + valor da chave primária. Assim, se você quer que dois objetos sejam relacionados por + uma associação de chave primária, você deve ter certeza que eles são assinados com o + mesmo valor identificador! + </para> + + <para> + Para uma associação de chave primária, adicione os seguintes mapeamentos em + <literal>Employee</literal> e <literal>Person</literal>, respectivamente. + </para> + + <programlisting><![CDATA[<one-to-one name="person" class="Person"/>]]></programlisting> + <programlisting><![CDATA[<one-to-one name="employee" class="Employee" constrained="true"/>]]></programlisting> + + <para> + Agora nós devemos assegurar que as chaves primárias de linhas relacionadas nas + tabelas PERSON e EMPLOYEE são iguais. Nós usamos uma estratégia especial de geração + de identificador do Hibernate chamada <literal>foreign</literal>: + </para> + + <programlisting><![CDATA[<class name="person" table="PERSON"> + <id name="id" column="PERSON_ID"> + <generator class="foreign"> + <param name="property">employee</param> + </generator> + </id> + ... + <one-to-one name="employee" + class="Employee" + constrained="true"/> +</class>]]></programlisting> + + <para> + Uma nova instância de <literal>Person</literal> salva recentemente é então assinada + com o mesmo valor da chave primária da instância de <literal>employee</literal> referenciada + com a propriedade <literal>employee</literal> daquela <literal>Person</literal>. + </para> + + <para> + Alternativamente, uma chave estrangeira com uma unique constraint, de + <literal>Employee</literal> para <literal>Person</literal>, pode ser expressa como: + </para> + + <programlisting><![CDATA[<many-to-one name="person" class="Person" column="PERSON_ID" unique="true"/>]]></programlisting> + + <para> + E esta associação pode ser feita de forma bi-direcional adicionando o seguinte + no mapeamento de <literal>Person</literal>: + </para> + + <programlisting><![CDATA[<one-to-one name="employee" class="Employee" property-ref="person"/>]]></programlisting> + + </sect2> + + <sect2 id="mapping-declaration-naturalid"> + <title>natural-id</title> + + <programlisting><![CDATA[<natural-id mutable="true|false"/> + <property ... /> + <many-to-one ... /> + ...... +</natural-id>]]></programlisting> + + <para> + Embora nós recomendemos o uso de surrogate keys como chaves primárias, você deve + ainda identificar chaves naturais para todas as entidades. Uma chave natural é + uma propriedade ou combinação de propriedades que é exclusiva e não nula. Se não + pude ser modificada, melhor ainda. Mapeie as propriedades da chave natural dentro do + elemento <literal><natural-id></literal>. O Hibernate irá gerar a chave + exclusiva necessária e as constraints de nullability , e seu mapeamento será + apropriadamente auto documentado. + </para> + + <para> + Nós recomendamos com enfase que você implemente <literal>equals()</literal> e + <literal>hashCode()</literal> para comparar as propriedades da chave natural da + entidade. + </para> + + <para> + Este mapeamento não tem o objetivo de uso com entidades com natural chaves primárias. + </para> + + <itemizedlist spacing="compact"> + <listitem> + <para> + <literal>mutable</literal> mutable (opcional, valor default<literal>false</literal>): + Por default, propriedades naturais identificadoras são consideradas imutáveis (constante). + </para> + </listitem> + </itemizedlist> + + </sect2> + + <sect2 id="mapping-declaration-component" revision="2"> + <title>componente, componente dinâmico</title> + + <para> + O elemento<literal><component></literal> mapeia propriedades de um + objeto filho para colunas da tabela de uma classe pai. Componentes podem, + um após o outro, declarar suas próprias propriedades, componentes ou coleções. + Veja "Components" abaixo. + </para> + + <programlistingco> + <areaspec> + <area id="component1" coords="2 45"/> + <area id="component2" coords="3 45"/> + <area id="component3" coords="4 45"/> + <area id="component4" coords="5 45"/> + <area id="component5" coords="6 45"/> + <area id="component6" coords="7 45"/> + <area id="component7" coords="8 45"/> + <area id="component8" coords="9 45"/> + </areaspec> + <programlisting><![CDATA[<component + name="propertyName" + class="className" + insert="true|false" + update="true|false" + access="field|property|ClassName" + lazy="true|false" + optimistic-lock="true|false" + unique="true|false" + node="element-name|." +> + + <property ...../> + <many-to-one .... /> + ........ +</component>]]></programlisting> + <calloutlist> + <callout arearefs="component1"> + <para> + <literal>name</literal>: O nome da propriedade. + </para> + </callout> + <callout arearefs="component2"> + <para> + <literal>class</literal> (opcional – valor default para o tipo de + propriedade determinada por reflection): O nome da classe (filha) do + componente. + </para> + </callout> + <callout arearefs="component3"> + <para> + <literal>insert</literal>: As colunas mapeadas aparecem nos + SQL de <literal>INSERT</literal>s? + </para> + </callout> + <callout arearefs="component4"> + <para> + <literal>update</literal>: As colunas mapeadas aparecem nos + SQL de <literal>UPDATE</literal>s? + </para> + </callout> + <callout arearefs="component5"> + <para> + <literal>access</literal> (opcional – valor default <literal>property</literal>): + A estratégia que o Hibernate pode usar para acessar o valor da propriedade. + </para> + </callout> + <callout arearefs="component6"> + <para> + <literal>lazy</literal> (opcional - valor default <literal>false</literal>): + Especifica que este componente deve ser fetched lazily quando o atributo for + acessado pela primeira vez (requer build-time bytecode instrumentation). + </para> + </callout> + <callout arearefs="component7"> + <para> + <literal>optimistic-lock</literal> (opcional – valor default <literal>true</literal>): + Especifica que atualizações para este componente requerem ou não aquisição + de um lock otimista. Em outras palavras, determina se uma versão de incremento deve + ocorrer quando esta propriedade estiver modificada. + </para> + </callout> + <callout arearefs="component8"> + <para> + <literal>unique</literal> (opcional – valor default <literal>false</literal>): + Especifica que existe uma unique constraint em todas as colunas mapeadas do + componente. + </para> + </callout> + </calloutlist> + </programlistingco> + + <para> + A tag filha <literal><property></literal> acrescenta a propriedade + de mapeamento da classe filha para colunas de uma tabela. + </para> + + <para> + O elemento <literal><component></literal> permite um sub-elemento + <literal><parent></literal> mapeie uma propriedade da classe do componente + como uma referencia de volta para a entidade que o contém. + </para> + + <para> + O elemento <literal><dynamic-component></literal> permite que um + <literal>Map</literal> possa ser mapeado como um componente onde os nomes das + propriedades referem-se para as chaves no mapa, veja + <xref linkend="components-dynamic"/>. + </para> + + </sect2> + + <sect2 id="mapping-declaration-properties" revision="2"> + <title>propriedades</title> + + <para> + O elemento <literal><properties></literal> permite a definição de um grupo + com nome, lógico de propriedades de uma classe. O uso mais importante do construtor + é que este permite uma combinação de propriedades para ser o objetivo de uma + <literal>property-ref</literal>. É também um modo conveninente para definir uma + unique constraint de múltiplas colunas. + </para> + + <programlistingco> + <areaspec> + <area id="properties1" coords="2 45"/> + <area id="properties2" coords="3 45"/> + <area id="properties3" coords="4 45"/> + <area id="properties4" coords="5 45"/> + <area id="properties5" coords="6 45"/> + </areaspec> + <programlisting><![CDATA[<properties + name="logicalName" + insert="true|false" + update="true|false" + optimistic-lock="true|false" + unique="true|false" +> + + <property ...../> + <many-to-one .... /> + ........ +</properties>]]></programlisting> + <calloutlist> + <callout arearefs="properties1"> + <para> + <literal>name</literal>:: O nome lógico do agrupamento – + <emphasis>não </emphasis> é o nome atual de propriedade. + </para> + </callout> + <callout arearefs="properties2"> + <para> + <literal>insert</literal>: As colunas mapeadas aparecem nos + SQL de <literal>INSERT</literal>s? + </para> + </callout> + <callout arearefs="properties3"> + <para> + <literal>update</literal>: As colunas mapeadas aparecem nos + SQL de <literal>UPDATE</literal>s? + </para> + </callout> + <callout arearefs="properties4"> + <para> + <literal>optimistic-lock</literal> (opcional – valor default <literal>true</literal>): + Especifica que atualizações para estes componentes requerem ou não aquisição de um + lock otimista. Em outras palavras, determina se uma versão de incremento deve ocorrer + quando estas propriedades estiverem modificadas. + </para> + </callout> + <callout arearefs="properties5"> + <para> + <literal>unique</literal> (opcional – valor defautl <literal>false</literal>): + Especifica que uma unique constraint existe em todas as colunas mapeadas do componente. + </para> + </callout> + </calloutlist> + </programlistingco> + + <para> + Por exemplo, se nós temos o seguinte mapeamento de <literal><properties></literal>: + </para> + + <programlisting><![CDATA[<class name="Person"> + <id name="personNumber"/> + ... + <properties name="name" + unique="true" update="false"> + <property name="firstName"/> + <property name="initial"/> + <property name="lastName"/> + </properties> +</class>]]></programlisting> + + <para> + Então nós podemos ter uma associação de dados herdados que referem a esta chave + exclusiva da tabela <literal>Person</literal>, ao invés de se referirem a chave + primária: + </para> + + <programlisting><![CDATA[<many-to-one name="person" + class="Person" property-ref="name"> + <column name="firstName"/> + <column name="initial"/> + <column name="lastName"/> +</many-to-one>]]></programlisting> + + <para> + Nós não recomendamos o uso deste tipo de coisa fora do contexto de mapeamento de + dados herdados. + </para> + + </sect2> + + <sect2 id="mapping-declaration-subclass" revision="4"> + <title>subclass (subclasse)</title> + + <para> + Finalmente, a persistência polimórfica requer a declaração de cada subclasse + da classe de persistência raiz. Para a estratégia de mapeamento + table-per-class-hierarchy, a declaração <literal><subclass></literal> + deve ser usada. + </para> + + <programlistingco> + <areaspec> + <area id="subclass1" coords="2 55"/> + <area id="subclass2" coords="3 55"/> + <area id="subclass3" coords="4 55"/> + <area id="subclass4" coords="5 55"/> + </areaspec> + <programlisting><![CDATA[<subclass + name="ClassName" + discriminator-value="discriminator_value" + proxy="ProxyInterface" + lazy="true|false" + dynamic-update="true|false" + dynamic-insert="true|false" + entity-name="EntityName" + node="element-name" + extends="SuperclassName"> + + <property .... /> + ..... +</subclass>]]></programlisting> + <calloutlist> + <callout arearefs="subclass1"> + <para> + <literal>name</literal>: O nome de classe completamente qualificada da subclasse. + </para> + </callout> + <callout arearefs="subclass2"> + <para> + <literal>discriminator-value</literal> (opcional – valor default o nome da classe): + Um valor que distingue subclasses individuais. + </para> + </callout> + <callout arearefs="subclass3"> + <para> + <literal>proxy</literal> (opcional): Especifica a classe ou interface que + usará os proxies de inicialização atrasada. + </para> + </callout> + <callout arearefs="subclass4"> + <para> + <literal>lazy</literal> (opcional, valor default <literal>true</literal>): + Configurar <literal>lazy="false"</literal> desabilitará o uso de + inicialização atrasada. + </para> + </callout> + </calloutlist> + </programlistingco> + <para> + Cada subclasse deve declarar suas próprias propriedades persistentes e subclasses. + As propriedades <literal><version></literal> e <literal><id></literal> + são configuradas para serem herdades da classe raiz. Cada subclasse numa hierarquia + deve definir um único <literal>discriminator-value</literal>. Se nenhum for + especificado, o nome da classe Java completamente qualificada será usada. + </para> + + <para> + Para informações sobre mapeamento de heranças, veja o <xref linkend="inheritance"/>. + </para> + + </sect2> + + <sect2 id="mapping-declaration-joinedsubclass" revision="3"> + <title>joined-subclass</title> + + <para> + Alternativamente, cada subclasse pode ser mapeada para sua própria tabela + (Estratégia de mapeamento table-per-subclass). O estado herdado é devolvido + por associação com a tabela da superclasse. Nós usamos o elemento + <literal><joined-subclass></literal>. + </para> + + <programlistingco> + <areaspec> + <area id="joinedsubclass1" coords="2 45"/> + <area id="joinedsubclass2" coords="3 45"/> + <area id="joinedsubclass3" coords="4 45"/> + <area id="joinedsubclass4" coords="5 45"/> + </areaspec> + <programlisting><![CDATA[<joined-subclass + name="ClassName" + table="tablename" + proxy="ProxyInterface" + lazy="true|false" + dynamic-update="true|false" + dynamic-insert="true|false" + schema="schema" + catalog="catalog" + extends="SuperclassName" + persister="ClassName" + subselect="SQL expression" + entity-name="EntityName" + node="element-name"> + + <key .... > + + <property .... /> + ..... +</joined-subclass>]]></programlisting> + <calloutlist> + <callout arearefs="joinedsubclass1"> + <para> + <literal>name</literal>: O nome da classe completamente qualificada da + subclasse. + </para> + </callout> + <callout arearefs="joinedsubclass2"> + <para> + <literal>table</literal>: O nome da tabela da subclasse. + </para> + </callout> + <callout arearefs="joinedsubclass3"> + <para> + <literal>proxy</literal> (opcional): Especifica a classe ou interface + para usar os proxies de recuperação atrasada. + </para> + </callout> + <callout arearefs="joinedsubclass4"> + <para> + <literal>lazy</literal> (opcional, valor default <literal>true</literal>): + Fixanr <literal>lazy="false"</literal> desabilita o uso recuperação + atrasada. + </para> + </callout> + </calloutlist> + </programlistingco> + + <para> + A coluna discriminator requerida para esta estratégia de mapeamento. Porém, + cada subclasse deve declarar uma coluna de tabela com o identificador do objeto + usando o elemento <literal><key></literal>. O mapeamento no início do + capítulo poderia ser re-escrito assim: + </para> + + <programlisting><![CDATA[<?xml version="1.0"?> +<!DOCTYPE hibernate-mapping PUBLIC + "-//Hibernate/Hibernate Mapping DTD//EN" + "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd"> + +<hibernate-mapping package="eg"> + + <class name="Cat" table="CATS"> + <id name="id" column="uid" type="long"> + <generator class="hilo"/> + </id> + <property name="birthdate" type="date"/> + <property name="color" not-null="true"/> + <property name="sex" not-null="true"/> + <property name="weight"/> + <many-to-one name="mate"/> + <set name="kittens"> + <key column="MOTHER"/> + <one-to-many class="Cat"/> + </set> + <joined-subclass name="DomesticCat" table="DOMESTIC_CATS"> + <key column="CAT"/> + <property name="name" type="string"/> + </joined-subclass> + </class> + + <class name="eg.Dog"> +  + </class> + +</hibernate-mapping>]]></programlisting> + + <para> + Para informações de mapeamentos de herança, veja <xref linkend="inheritance"/>. + </para> + + </sect2> + + <sect2 id="mapping-declaration-unionsubclass" revision="2"> + <title>union-subclass</title> + + <para> + Uma terceira opção é mapear para tabelas apenas as classes concretas de uma + hierarquia de heranças, (a estratégia table-per-concrete-class) onde cada tabela + define todos os estados persistentes da classe, incluindo estados herdados. + No Hibernate, não é absolutamente necessário mapear explicitamente como hierarquia + de heranças. Você pode simplesmente mapear cada classe com uma declaração + <literal><class></literal> separada. Porém, se você deseja usar associações + polimórficas (por exemplo: uma associação para a superclasse de sua hierarquia), + você precisa usar o mapeamento <literal><union-subclass></literal>. + + </para> + + <programlistingco> + <areaspec> + <area id="unionsubclass1" coords="2 45"/> + <area id="unionsubclass2" coords="3 45"/> + <area id="unionsubclass3" coords="4 45"/> + <area id="unionsubclass4" coords="5 45"/> + </areaspec> + <programlisting><![CDATA[<union-subclass + name="ClassName" + table="tablename" + proxy="ProxyInterface" + lazy="true|false" + dynamic-update="true|false" + dynamic-insert="true|false" + schema="schema" + catalog="catalog" + extends="SuperclassName" + abstract="true|false" + persister="ClassName" + subselect="SQL expression" + entity-name="EntityName" + node="element-name"> + + <property .... /> + ..... +</union-subclass>]]></programlisting> + <calloutlist> + <callout arearefs="unionsubclass1"> + <para> + <literal>name</literal>: O nome da subclasse completamente qualificada. + </para> + </callout> + <callout arearefs="unionsubclass2"> + <para> + <literal>table</literal>: O nome da tabela da subclasse. + </para> + </callout> + <callout arearefs="unionsubclass3"> + <para> + <literal>proxy</literal> (optional): Specifies a class or interface to use + for lazy initializing proxies. + + <literal>proxy</literal> (opcional): Especifica a classe ou interface para usar + os proxies de recuperação atrasada. + </para> + </callout> + <callout arearefs="unionsubclass4"> + <para> + <literal>lazy</literal> (optional, defaults to <literal>true</literal>): Setting + <literal>lazy="false"</literal> disables the use of lazy fetching. + <literal>lazy</literal> (opcional, valor default p<literal>true</literal>): + Fixando <literal>lazy="false"</literal> desabilita o uso da recuperação atrasada. + </para> + </callout> + </calloutlist> + </programlistingco> + + <para> + A coluna discriminatõria não é requerida para esta estratégia de mapeamento. + + </para> + + <para> + Para informações sobre mapeamentos de herança, veja <xref linkend="inheritance"/>. + </para> + + </sect2> + + <sect2 id="mapping-declaration-join" revision="3"> + <title>join</title> + + <para> + Usando o elemento <literal><join></literal>>, é possível mapear + propriedades de uma classe para várias tabelas. + </para> + + <programlistingco> + <areaspec> + <area id="join1" coords="2 50"/> + <area id="join2" coords="3 50"/> + <area id="join3" coords="4 50"/> + <area id="join4" coords="5 50"/> + <area id="join5" coords="6 50"/> + <area id="join6" coords="7 50"/> + </areaspec> + <programlisting><![CDATA[<join + table="tablename" + schema="owner" + catalog="catalog" + fetch="join|select" + inverse="true|false" + optional="true|false"> + + <key ... /> + + <property ... /> + ... +</join>]]></programlisting> + + <calloutlist> + <callout arearefs="join1"> + <para> + <literal>table</literal>: O nome da tabela associada. + </para> + </callout> + <callout arearefs="join2"> + <para> + <literal>schema</literal> (opcional): Sobrepõe o nome do esquema + especificado pelo elemento raiz <literal><hibernate-mapping></literal>. + </para> + </callout> + <callout arearefs="join3"> + <para> + <literal>catalog</literal> (opcional): Sobrepõe o nome do catálogo + especificado pelo elemento raiz<literal><hibernate-mapping></literal>. + </para> + </callout> + <callout arearefs="join4"> + <para> + <literal>fetch</literal>(opcional – valor default <literal>join</literal>): Se setado + para <literal>join</literal>, o padrão, o Hibernate irá usar um inner join para + restaurar um <literal>join</literal> definido por uma classe ou suas subclasses e + uma outer join para um <literal>join</literal> definido por uma subclasse. + Se setado para <literal>select</literal>, então o Hibernate irá usar uma seleção + seqüencial para um <literal><join></literal> definida numa subclasse, que irá + ser emitido apenas se uma linha se concentrar para representar uma instância + da subclasse. Inner joins irá ainda ser usado para restaurar um + <literal><join></literal> definido pela classe e suas superclasses. + </para> + </callout> + <callout arearefs="join5"> + <para> + <literal>inverse</literal> (opcional – valor default <literal>false</literal>): + Se habilitado, o Hibernate não irá tentar inserir ou atualizar as propriedades + definidas por este join. + </para> + </callout> + <callout arearefs="join6"> + <para> + <literal>optional</literal> (opcional – valor default <literal>false</literal>): + Se habilitado, o Hibernate irá inserir uma linha apenas se as propriedades definidas + por esta junção não forem nulas e irá sempre usar uma outer join para + recuperar as propriedades. + </para> + </callout> + </calloutlist> + </programlistingco> + + <para> + Por exemplo, a informação de endereço para uma pessoa pode ser mapeada para uma + tabela separada (enquanto preservando o valor da semântica de tipos para + todas as propriedades): + </para> + + <programlisting><![CDATA[<class name="Person" + table="PERSON"> + + <id name="id" column="PERSON_ID">...</id> + + <join table="ADDRESS"> + <key column="ADDRESS_ID"/> + <property name="address"/> + <property name="zip"/> + <property name="country"/> + </join> + ...]]></programlisting> + + <para> + Esta característica é útil apenas para modelos de dados legados, nós recomendamos + menos tabelas do que classes e um modelo de domínio bem granulado. Porém, é + útil para ficar trocando entre estratégias de mapeamento de herança + numa hierarquia simples, como explicado mais a frente. + </para> + + </sect2> + + <sect2 id="mapping-declaration-key"> + <title>key</title> + + <para> + Nós vimos que o elemento <literal><key></literal> surgiu algumas vezes + até agora. Ele aparece em qualquer lugar que o elemento pai define uma junção + para a nova tabela, e define a chave estrangeira para a tabela associada, que + referencia a chave primária da tabela original. + </para> + + <programlistingco> + <areaspec> + <area id="key1" coords="2 50"/> + <area id="key2" coords="3 50"/> + <area id="key3" coords="4 50"/> + <area id="key4" coords="5 50"/> + <area id="key5" coords="6 50"/> + <area id="key6" coords="7 50"/> + </areaspec> + <programlisting><![CDATA[<key + column="columnname" + on-delete="noaction|cascade" + property-ref="propertyName" + not-null="true|false" + update="true|false" + unique="true|false" +/>]]></programlisting> + + <calloutlist> + <callout arearefs="key1"> + <para>. + <literal>column</literal> (opcional): O nome da coluna da chave estrangeira. + Isto também pode ser especificado por aninhamento de elemento(s) + <literal><column></literal>. + </para> + </callout> + <callout arearefs="key2"> + <para> + <literal>on-delete</literal> (opcional, valor default <literal>noaction</literal>): + Especifica se a constraint da chave estrangeira no banco de dados esta + habilitada para cascade delete . + </para> + </callout> + <callout arearefs="key3"> + <para> + <literal>property-ref</literal> (opcional): Especifica que a chave estrangeira + se refere a colunas que não são chave primária da tabela original. + (Util para base de dados legadas.) + </para> + </callout> + <callout arearefs="key4"> + <para> + <literal>not-null</literal> (opcional): Especifica que a coluna da chave + estrangeira não aceita valores nulos (isto é implícito em qualquer momento + que a chave estrangeira também fizer parte da chave primária). + </para> + </callout> + <callout arearefs="key5"> + <para> + <literal>update</literal> (optional): Specifies that the foreign key should never + be updated (this is implied whenever the foreign key is also part of the primary + key). + <literal>update</literal> (opcional): Especifica que a chave estrangeira nunca + deve ser atualizada (isto é implícito em qualquer momento que a chave estrangeira + também fizer parte da chave primária). + </para> + </callout> + <callout arearefs="key6"> + <para> + <literal>unique</literal> (opcional): Especifica que a chave estrangeira deve ter + uma constraint unique (sto é implícito em qualquer momento que a chave estrangeira + também fizer parte da chave primária). + </para> + </callout> + </calloutlist> + </programlistingco> + + <para> + Nós recomendamos que para sistemas que a performance de delete seja importante, todas as + chaves deve ser definida <literal>on-delete="cascade"</literal>, e o Hibernate irá usar + uma constraint a nível de banco de dados <literal>ON CASCADE DELETE</literal>, ao invés + de muitas instruções <literal>DELETE</literal>. Esteja ciente que esta característica é + um atalho da estratégia usual de optimistic locking do Hibernate para dados versionados. + </para> + + <para> + Os atributos <literal>not-null</literal> e <literal>update</literal> são úteis quando + estamos mapeamos uma associação unidirecional um para muitos. Se você mapear uma + asociação unidirecional um para muitos para uma chave estrangeira non-nullable, você + <emphasis>deve</emphasis> declarar a coluna chave usando + <literal><key not-null="true"></literal>. + </para> + + </sect2> + + <sect2 id="mapping-column" revision="4"> + <title>elementos column e formula</title> + <para> + Qualquer elemento de mapeamente que aceita um atributo <literal>column</literal> irá + aceitar alternativamente um subelemento <literal><column></literal>. Da mesma forma, + <literal>formula</literal> é uma alternativa para o atributo <literal>formula</literal>. + </para> + + <programlisting><![CDATA[<column + name="column_name" + length="N" + precision="N" + scale="N" + not-null="true|false" + unique="true|false" + unique-key="multicolumn_unique_key_name" + index="index_name" + sql-type="sql_type_name" + check="SQL expression" + default="SQL expression"/>]]></programlisting> + + <programlisting><![CDATA[<formula>SQL expression</formula>]]></programlisting> + + <para> + O atributo <literal>column</literal> e <literal>formula</literal> podem até ser combinados + dentro da mesma propriedade ou associação mapeando para expressar, + por exemplo, associações exóticas. + </para> + + <programlisting><![CDATA[<many-to-one name="homeAddress" class="Address" + insert="false" update="false"> + <column name="person_id" not-null="true" length="10"/> + <formula>'MAILING'</formula> +</many-to-one>]]></programlisting> + + </sect2> + + <sect2 id="mapping-declaration-import"> + <title>import</title> + + <para> + Suponha que a sua aplicação tem duas classes persistentes com o mesmo nome, e você não quer + especificar o nome qualificado (do pacote) nas queries do Hibernate. As Classes devem + ser "importadas" explicitamente, de preferência contando com <literal>auto-import="true"</literal>. + Você pode até importar classes e interfaces que não estão explicitamente mapeadas. + </para> + + <programlisting><![CDATA[<import class="java.lang.Object" rename="Universe"/>]]></programlisting> + + <programlistingco> + <areaspec> + <area id="import1" coords="2 40"/> + <area id="import2" coords="3 40"/> + </areaspec> + <programlisting><![CDATA[<import + class="ClassName" + rename="ShortName" +/>]]></programlisting> + <calloutlist> + <callout arearefs="import1"> + <para> + <literal>class</literal>: O nome qualificado (do pacote) de qualquer classe Java. + </para> + </callout> + <callout arearefs="import2"> + <para> + <literal>rename</literal> (opcional – valor default, o nome da classe não + qualificada): Um nome que pode ser usado numa linguagem de consulta. + </para> + </callout> + </calloutlist> + </programlistingco> + + </sect2> + + <sect2 id="mapping-types-anymapping" revision="2"> + <title>any</title> + + <para> + Existe mais um tipo de propriedade de mapeamento. O elemento de mapeamento + <literal><any></literal> define uma associação polimórfica para classes de múltiplas tabelas. + Este tipo de mapeamento sempre requer mais de uma coluna. A primeira coluna possui o tipo da entidade + associada. A outra coluna que ficou possui o identificador. É impossível especificar uma restrição + de chave estrangeira para este tipo de associação, assim isto claramente não é visto + como um caminho usual para associações (polimórficas) de mapeamento. Você deve usar este mapeamento + apenas em casos muito especiais (exemplo: audit logs, dados de sessão do usuário, etc). + + </para> + + <para> + O atributo <literal>meta-type</literal> permite a aplicação especificar um tipo adaptado + que mapeia valores de colunas de banco de dados para classes persistentes que tem propriedades + identificadoras do tipo especificado através do <literal>id-type</literal>. Você deve especificar + o mapeamento de valores do meta-type para nome de classes. + </para> + + <programlisting><![CDATA[<any name="being" id-type="long" meta-type="string"> + <meta-value value="TBL_ANIMAL" class="Animal"/> + <meta-value value="TBL_HUMAN" class="Human"/> + <meta-value value="TBL_ALIEN" class="Alien"/> + <column name="table_name"/> + <column name="id"/> +</any>]]></programlisting> + + <programlistingco> + <areaspec> + <area id="any1" coords="2 50"/> + <area id="any2" coords="3 50"/> + <area id="any3" coords="4 50"/> + <area id="any4" coords="5 50"/> + <area id="any5" coords="6 50"/> + <area id="any6" coords="7 50"/> + </areaspec> + <programlisting><![CDATA[<any + name="propertyName" + id-type="idtypename" + meta-type="metatypename" + cascade="cascade_style" + access="field|property|ClassName" + optimistic-lock="true|false" +> + <meta-value ... /> + <meta-value ... /> + ..... + <column .... /> + <column .... /> + ..... +</any>]]></programlisting> + <calloutlist> + <callout arearefs="any1"> + <para> + <literal>name</literal>: o nome da propriedade. + </para> + </callout> + <callout arearefs="any2"> + <para> + <literal>id-type</literal>: o tipo identificador. + </para> + </callout> + <callout arearefs="any3"> + <para> + <literal>meta-type</literal> (opcional – valor default <literal>string</literal>): + Qualquer tipo que é permitido para um mapeamento discriminador. + </para> + </callout> + <callout arearefs="any4"> + <para> + <literal>cascade</literal> (opcional – valor default <literal>none</literal>): + o estilo do cascade. + </para> + </callout> + <callout arearefs="any5"> + <para> + <literal>access</literal> (opcional – valor default <literal>property</literal>): + A estratégia que o hibernate deve usar para acessar o valor da propriedade. + </para> + </callout> + <callout arearefs="any6"> + <para> + <literal>optimistic-lock</literal> (opcional - valor default<literal>true</literal>): + Especifica que as atualizações para esta propriedade requerem ou não aquisição da + trava otimista. Em outras palavras, define se uma versão de incremento deve ocorrer + se esta propriedade está modificada. + </para> + </callout> + </calloutlist> + </programlistingco> + + </sect2> + + </sect1> + + <sect1 id="mapping-types"> + <title>Tipos do Hibernate</title> + + <sect2 id="mapping-types-entitiesvalues" revision="1"> + <title>Entidades e valores</title> + + <para> + Para entender o comportamento de vários objetos em nível de linguagem de Java a + respeito do serviço de persistência, nós precisamos classificá-los em dois grupos. + </para> + + <para> + Uma <emphasis>entidade </emphasis> existe independentemente de qualquer outro + objeto guardando referências para a entidade. Em contraste com o modelo usual de + Java que um objeto não referenciado é coletado pelo garbage collector. Entidades + devem ser explicitamente salvas ou deletada (exceto em operações de salvamento + ou deleção que possam ser executada em <emphasis>cascata</emphasis> de uma entidade + pai para seus filhos). Isto é diferente do modelo ODMG de persistência do objeto + por acessibilidade – e corresponde quase a como objetos de aplicações são + geralmente usados em grandes sistemas. Entidades suportam referências circulares + e comuns. Eles podem ser versionadas. + </para> + + <para> + Uma entidade em estado persistente consiste de referências para outras entidades + e instâncias de tipos de <emphasis>valor</emphasis>. Valores são primitivos, + coleções (não o que tem dentro de uma coleção), componentes e certos objetos + imutáveis. Entidades distintas, valores (em coleções e componentes particulares) + <emphasis>são </emphasis> persistidos e apagados por acessibilidade. Visto que + objetos value (e primitivos) são persistidos e apagados junto com as entidades + que os contém e não podem ser versionados independentemente. Valores têm + identidade não independente, assim eles não podem ser comuns para duas + entidades ou coleções. + + </para> + + <para> + Até agora, nós estivemos usando o termo "classe persistente" para referir + a entidades. Nós iremos continuar a fazer isto. Falando a rigor, porém, nem todas + as classes definidas pelo usuário com estados persistentes são entidades. Um + <emphasis>componente</emphasis> é uma classe de usuário definida com valores + semânticos. Uma propriedade de Java de tipo <literal>java.lang.String</literal> + também tem um valor semêntico. Dada esta definição, nós podemos dizer que + todos os tipos (classes) fornecida pelo JDK tem tipo de valor semântico em Java, + enquanto que tipos definidos pelo usuário pode ser mapeados com entidade ou valor + de tipo semântico. Esta decisão pertence ao desenvolvedor da aplicação. Uma boa + dica para uma classe entidade em um modelo de domínio são referências comuns + para uma instância simples daquela classe, enquanto a composição ou agregação + geralmente se traduz para um valor de tipo. + </para> + + <para> + Nós iremos rever ambos os conceitos durante toda a documentação. + + </para> + + <para> + O desafio pe mapear o sistema de tipo de Java (e a definição do desenvolvedor de + entidades e tipos de valor) para o sistema de tipo SQL/banco de dados. A ponte entre ambos + os sistemas é fornecido pelo Hibernate: para entidades que usam + <literal><class></literal>, <literal><subclass></literal> e assim por diante. + Para tipos de valores nós usamos <literal><property></literal>, + <literal><component></literal>, etc, geralmente com um atributo + <literal>type</literal>. O valor deste atributo é o nome de um <emphasis>tipo de + mapeamento</emphasis> do Hibernate. O Hibernate fornece muitos mapeamentos + (para tipos de valores do JDK padrão) ut of the box. Você pode escrever os seus + próprios tipos de mapeamentos e implementar sua estratégia de conversão adaptada, + como você verá adiante. + </para> + + <para> + Todos os tipos internos do hibernate exceto coleções suportam semânticas nulas. + + </para> + + </sect2> + + <sect2 id="mapping-types-basictypes" revision="3"> + <title>Valores de tipos básicos</title> + + <para> + O tipos internos de mapeamentos básicos podem ser a grosso modo categorizado como: + <variablelist> + <varlistentry> + <term><literal>integer, long, short, float, double, character, byte, + boolean, yes_no, true_false</literal></term> + <listitem> + <para> + Tipos de mapeamentos de classes primitivas ou wrapper Java especificos + (vendor-specific) para tipos de coluna SQL. Boolean, + <literal>boolean, yes_no</literal> são todas codificações alternativas + para um <literal>boolean</literal> ou <literal>java.lang.Boolean</literal> + do Java. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>string</literal></term> + <listitem> + <para> + Um tipo de mapeamento de <literal>java.lang.String</literal> para + <literal>VARCHAR</literal> (ou <literal>VARCHAR2</literal> no Oracle). + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>date, time, timestamp</literal></term> + <listitem> + <para> + Tipos de mapeamento de <literal>java.util.Date</literal> e suas + subclasses para os tipos SQL <literal>DATE</literal>, + <literal>TIME</literal> e <literal>TIMESTAMP</literal> + (ou equivalente). + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>calendar, calendar_date</literal></term> + <listitem> + <para> + Tipo de mapeamento de <literal>java.util.Calendar</literal> para + os tipos SQL <literal>TIMESTAMP</literal> e + <literal>DATE</literal> (ou equivalente). + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>big_decimal, big_integer</literal></term> + <listitem> + <para> + Tipo de mapeamento de <literal>java.math.BigDecimal</literal> and + <literal>java.math.BigInteger</literal> para <literal>NUMERIC</literal> + (ou <literal>NUMBER</literal> no Oracle). + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>locale, timezone, currency</literal></term> + <listitem> + <para> + Tipos de mapeamentos de <literal>java.util.Locale</literal>, + <literal>java.util.TimeZone</literal> e <literal>java.util.Currency</literal> + para <literal>VARCHAR</literal> (ou <literal>VARCHAR2</literal> no Oracle). + Instâncias de f <literal>Locale</literal> e <literal>Currency</literal> + são mapeados para seus códigos ISO. Instâncias de <literal>TimeZone</literal> + são mapeados para seu <literal>ID</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>class</literal></term> + <listitem> + <para> + um tipo de mapeamento de <literal>java.lang.Class</literal> para + <literal>VARCHAR</literal> (ou <literal>VARCHAR2</literal> no + Oracle). Uma <literal>Class</literal> é mapeada pelo + seu nome qualificado (completo). + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>binary</literal></term> + <listitem> + <para> + Mapeia arrays de bytes para um tipo binário de SQL apropriado. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>text</literal></term> + <listitem> + <para> + Maps long Java strings to a SQL <literal>CLOB</literal> or + <literal>TEXT</literal> type. + Mapeia strings longas de Java para um tipo SQL + <literal>CLOB</literal> ou <literal>TEXT</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>serializable</literal></term> + <listitem> + <para> + Mapeia tipos Java serializáveis para um tipo binário SQL apropriado. + Você pode também indicar o tipo <literal>serializable</literal> do + Hibernate com o nome da classe ou interface Java serializável que + não é padrão para um tipo básico. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>clob, blob</literal></term> + <listitem> + <para> + Tipos de mapeamentos para as classes JDBC <literal>java.sql.Clob</literal> and + <literal>java.sql.Blob</literal>. Estes tipos podem ser inconveniente para + algumas aplicações, visto que o objeto blob ou clob pode não ser reusado + fora de uma transação. (Além disso, o suporte de driver é imcompleto e + inconsistente.) + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <literal>imm_date, imm_time, imm_timestamp, imm_calendar, imm_calendar_date, + imm_serializable, imm_binary</literal> + </term> + <listitem> + <para> + Mapeando tipos para o que geralmente são consideradas tipos mutáveis de + Java, onde o Hibernate faz determinadas otimizações apropriadas somente + para tipos imutáveis de Java, e a aplicação trata o objeto como imutável. + Por exemplo, você não deve chamar <literal>Date.setTime()</literal> para + uma instância mapeada como <literal>imm_timestamp</literal>. Para mudar + o valor da propriedade, e ter a mudança feita persistente, a aplicação + deve atribuir um novo objeto (nonidentical) à propriedade. + </para> + </listitem> + </varlistentry> + </variablelist> + + </para> + + <para> + Identificadores únicos das entidades e coleções podem ser de qualquer tipo + básico exceto <literal>binary</literal>, <literal>blob</literal> ou + <literal>clob</literal>. (Identificadores compostos também são permitidos, + veja abaixo.) + </para> + + <para> + Os tipos de valores básicos têm suas constantes <literal>Type</literal> + correspondentes definidas em <literal>org.hibernate.Hibernate</literal>. Por exemplo, + <literal>Hibernate.STRING</literal> representa o tipo <literal>string</literal>. + </para> + + </sect2> + + <sect2 id="mapping-types-custom" revision="2"> + <title>Tipos de valores personalizados</title> + + <para> + É relativamente fácil para desenvolvedores criar seus próprios tipos de valor. + Por exemplo, você pode querer persistir propriedades do tipo + <literal>java.lang.BigInteger</literal> para colunas <literal>VARCHAR</literal>. O + Hibernate não fornece um tipo correspondente para isso. Mas os tipos adaptados + não são limitados a mapeamento de uma propriedade (ou elemento de coleção) a uma + única coluna da tabela. Assim, por exemplo, você pôde ter uma propriedade Java + <literal>getName()</literal>/<literal>setName()</literal> do tipo + <literal>java.lang.String</literal> que é persistido para colunas + <literal>FIRST_NAME</literal>, <literal>INITIAL</literal>, <literal>SURNAME</literal>. + + </para> + + <para> + Para implementar um tipo personalizado, implemente <literal>org.hibernate.UserType</literal> + or <literal>org.hibernate.CompositeUserType</literal> e declare propriedades usando o nome + qualificado da classe do tipo. Veja <literal>org.hibernate.test.DoubleStringType</literal> + para ver o tipo das coisas que são possíveis. + </para> + + <programlisting><![CDATA[<property name="twoStrings" type="org.hibernate.test.DoubleStringType"> + <column name="first_string"/> + <column name="second_string"/> +</property>]]></programlisting> + + <para> + Observe o uso da tag <literal><column></literal> para mapear uma propriedade + para colunas múltiplas. + </para> + + <para> + As interfaces <literal>CompositeUserType</literal>, <literal>EnhancedUserType</literal>, + <literal>UserCollectionType</literal>, e <literal>UserVersionType</literal> + fornecem suporte para usos mais especializados. + </para> + + <para> + Você pode mesmo fornecer parâmetros a um <literal>UserType</literal> no arquivo de mapeamento. + Para isto, seu <literal>UserType</literal> deve implementar a interface + <literal>org.hibernate.usertype.ParameterizedType</literal>. Para fornecer parâmetros a seu + tipo personalizado, você pode usar o elemento <literal><type></literal> em seus + arquivos de mapeamento. + </para> + + <programlisting><![CDATA[<property name="priority"> + <type name="com.mycompany.usertypes.DefaultValueIntegerType"> + <param name="default">0</param> + </type> +</property>]]></programlisting> + + <para> + O <literal>UserType</literal> pode agora recuperar o valor para o parâmetro chamado + <literal>default</literal> da <literal>Propriedade</literal> do passado a ele. + </para> + + <para> + Se você usar freqüentemente um determinado <literal>UserType</literal>, pode ser útil definir + um nome mais curto para ele. Você pode fazer isto usando o elemento + <literal><typedef></literal>. Typedefs atribui um nome a um tipo personalizado, e pode também + conter uma lista de valores default de parâmetro se o tipo for parametrizado. + </para> + + <programlisting><![CDATA[<typedef class="com.mycompany.usertypes.DefaultValueIntegerType" name="default_zero"> + <param name="default">0</param> +</typedef>]]></programlisting> + + <programlisting><![CDATA[<property name="priority" type="default_zero"/>]]></programlisting> + + <para> + It is also possible to override the parameters supplied in a typedef on a case-by-case basis + by using type parameters on the property mapping. + </para> + + <para> + Even though Hibernate's rich range of built-in types and support for components means you + will very rarely <emphasis>need</emphasis> to use a custom type, it is nevertheless + considered good form to use custom types for (non-entity) classes that occur frequently + in your application. For example, a <literal>MonetaryAmount</literal> class is a good + candidate for a <literal>CompositeUserType</literal>, even though it could easily be mapped + as a component. One motivation for this is abstraction. With a custom type, your mapping + documents would be future-proofed against possible changes in your way of representing + monetary values. + </para> + + </sect2> + + </sect1> + + <sect1 id="mapping-entityname"> + <title>Mapping a class more than once</title> + <para> + It is possible to provide more than one mapping for a particular persistent class. In this + case you must specify an <emphasis>entity name</emphasis> do disambiguate between instances + of the two mapped entities. (By default, the entity name is the same as the class name.) + Hibernate lets you specify the entity name when working with persistent objects, when writing + queries, or when mapping associations to the named entity. + </para> + + <programlisting><![CDATA[<class name="Contract" table="Contracts" + entity-name="CurrentContract"> + ... + <set name="history" inverse="true" + order-by="effectiveEndDate desc"> + <key column="currentContractId"/> + <one-to-many entity-name="HistoricalContract"/> + </set> +</class> + +<class name="Contract" table="ContractHistory" + entity-name="HistoricalContract"> + ... + <many-to-one name="currentContract" + column="currentContractId" + entity-name="CurrentContract"/> +</class>]]></programlisting> + + <para> + Notice how associations are now specified using <literal>entity-name</literal> instead of + <literal>class</literal>. + </para> + + </sect1> + + <sect1 id="mapping-quotedidentifiers"> + <title>SQL quoted identifiers</title> + <para> + You may force Hibernate to quote an identifier in the generated SQL by enclosing the table or + column name in backticks in the mapping document. Hibernate will use the correct quotation + style for the SQL <literal>Dialect</literal> (usually double quotes, but brackets for SQL + Server and backticks for MySQL). + </para> + + <programlisting><![CDATA[<class name="LineItem" table="`Line Item`"> + <id name="id" column="`Item Id`"/><generator class="assigned"/></id> + <property name="itemNumber" column="`Item #`"/> + ... +</class>]]></programlisting> + + </sect1> + + + <sect1 id="mapping-alternatives"> + <title>Metadata alternatives</title> + + <para> + XML isn't for everyone, and so there are some alternative ways to define O/R mapping metadata in Hibernate. + </para> + + <sect2 id="mapping-xdoclet"> + <title>Using XDoclet markup</title> + + <para> + Many Hibernate users prefer to embed mapping information directly in sourcecode using + XDoclet <literal>@hibernate.tags</literal>. We will not cover this approach in this + document, since strictly it is considered part of XDoclet. However, we include the + following example of the <literal>Cat</literal> class with XDoclet mappings. + </para> + + <programlisting><![CDATA[package eg; +import java.util.Set; +import java.util.Date; + +/** + * @hibernate.class + * table="CATS" + */ +public class Cat { + private Long id; // identifier + private Date birthdate; + private Cat mother; + private Set kittens + private Color color; + private char sex; + private float weight; + + /* + * @hibernate.id + * generator-class="native" + * column="CAT_ID" + */ + public Long getId() { + return id; + } + private void setId(Long id) { + this.id=id; + } + + /** + * @hibernate.many-to-one + * column="PARENT_ID" + */ + public Cat getMother() { + return mother; + } + void setMother(Cat mother) { + this.mother = mother; + } + + /** + * @hibernate.property + * column="BIRTH_DATE" + */ + public Date getBirthdate() { + return birthdate; + } + void setBirthdate(Date date) { + birthdate = date; + } + /** + * @hibernate.property + * column="WEIGHT" + */ + public float getWeight() { + return weight; + } + void setWeight(float weight) { + this.weight = weight; + } + + /** + * @hibernate.property + * column="COLOR" + * not-null="true" + */ + public Color getColor() { + return color; + } + void setColor(Color color) { + this.color = color; + } + /** + * @hibernate.set + * inverse="true" + * order-by="BIRTH_DATE" + * @hibernate.collection-key + * column="PARENT_ID" + * @hibernate.collection-one-to-many + */ + public Set getKittens() { + return kittens; + } + void setKittens(Set kittens) { + this.kittens = kittens; + } + // addKitten not needed by Hibernate + public void addKitten(Cat kitten) { + kittens.add(kitten); + } + + /** + * @hibernate.property + * column="SEX" + * not-null="true" + * update="false" + */ + public char getSex() { + return sex; + } + void setSex(char sex) { + this.sex=sex; + } +}]]></programlisting> + + <para> + See the Hibernate web site for more examples of XDoclet and Hibernate. + </para> + + </sect2> + + <sect2 id="mapping-annotations" revision="2"> + <title>Using JDK 5.0 Annotations</title> + + <para> + JDK 5.0 introduced XDoclet-style annotations at the language level, type-safe and + checked at compile time. This mechnism is more powerful than XDoclet annotations and + better supported by tools and IDEs. IntelliJ IDEA, for example, supports auto-completion + and syntax highlighting of JDK 5.0 annotations. The new revision of the EJB specification + (JSR-220) uses JDK 5.0 annotations as the primary metadata mechanism for entity beans. + Hibernate3 implements the <literal>EntityManager</literal> of JSR-220 (the persistence API), + support for mapping metadata is available via the <emphasis>Hibernate Annotations</emphasis> + package, as a separate download. Both EJB3 (JSR-220) and Hibernate3 metadata is supported. + </para> + + <para> + This is an example of a POJO class annotated as an EJB entity bean: + </para> + + <programlisting><![CDATA[@Entity(access = AccessType.FIELD) +public class Customer implements Serializable { + + @Id; + Long id; + + String firstName; + String lastName; + Date birthday; + + @Transient + Integer age; + + @Embedded + private Address homeAddress; + + @OneToMany(cascade=CascadeType.ALL) + @JoinColumn(name="CUSTOMER_ID") + Set<Order> orders; + + // Getter/setter and business methods +}]]></programlisting> + + <para> + Note that support for JDK 5.0 Annotations (and JSR-220) is still work in progress and + not completed. Please refer to the Hibernate Annotations module for more details. + </para> + + </sect2> + </sect1> + + <sect1 id="mapping-generated" revision="1"> + <title>Generated Properties</title> + <para> + Generated properties are properties which have their values generated by the + database. Typically, Hibernate applications needed to <literal>refresh</literal> + objects which contain any properties for which the database was generating values. + Marking properties as generated, however, lets the application delegate this + responsibility to Hibernate. Essentially, whenever Hibernate issues an SQL INSERT + or UPDATE for an entity which has defined generated properties, it immediately + issues a select afterwards to retrieve the generated values. + </para> + <para> + Properties marked as generated must additionally be non-insertable and non-updateable. + Only <xref linkend="mapping-declaration-version">versions</xref>, + <xref linkend="mapping-declaration-timestamp">timestamps</xref>, and + <xref linkend="mapping-declaration-property">simple properties</xref> can be marked as + generated. + </para> + <para> + <literal>never</literal> (the default) - means that the given property value + is not generated within the database. + </para> + <para> + <literal>insert</literal> - states that the given property value is generated on + insert, but is not regenerated on subsequent updates. Things like created-date would + fall into this category. Note that even thought + <xref linkend="mapping-declaration-version">version</xref> and + <xref linkend="mapping-declaration-timestamp">timestamp</xref> properties can + be marked as generated, this option is not available there... + </para> + <para> + <literal>always</literal> - states that the property value is generated both + on insert and on update. + </para> + </sect1> + + <sect1 id="mapping-database-object"> + <title>Auxiliary Database Objects</title> + <para> + Allows CREATE and DROP of arbitrary database objects, in conjunction with + Hibernate's schema evolution tools, to provide the ability to fully define + a user schema within the Hibernate mapping files. Although designed specifically + for creating and dropping things like triggers or stored procedures, really any + SQL command that can be run via a <literal>java.sql.Statement.execute()</literal> + method is valid here (ALTERs, INSERTS, etc). There are essentially two modes for + defining auxiliary database objects... + </para> + <para> + The first mode is to explicitly list the CREATE and DROP commands out in the mapping + file: + </para> + <programlisting><![CDATA[<hibernate-mapping> + ... + <database-object> + <create>CREATE TRIGGER my_trigger ...</create> + <drop>DROP TRIGGER my_trigger</drop> + </database-object> +</hibernate-mapping>]]></programlisting> + <para> + The second mode is to supply a custom class which knows how to construct the + CREATE and DROP commands. This custom class must implement the + <literal>org.hibernate.mapping.AuxiliaryDatabaseObject</literal> interface. + </para> + <programlisting><![CDATA[<hibernate-mapping> + ... + <database-object> + <definition class="MyTriggerDefinition"/> + </database-object> +</hibernate-mapping>]]></programlisting> + <para> + Additionally, these database objects can be optionally scoped such that they only + apply when certain dialects are used. + </para> + <programlisting><![CDATA[<hibernate-mapping> + ... + <database-object> + <definition class="MyTriggerDefinition"/> + <dialect-scope name="org.hibernate.dialect.Oracle9Dialect"/> + <dialect-scope name="org.hibernate.dialect.OracleDialect"/> + </database-object> +</hibernate-mapping>]]></programlisting> + </sect1> +</chapter> + Modified: core/trunk/documentation/manual/pt-BR/src/main/docbook/content/batch.xml =================================================================== --- core/trunk/documentation/manual/pt-BR/src/main/docbook/content/batch.xml 2007-10-26 00:46:38 UTC (rev 14135) +++ core/trunk/documentation/manual/pt-BR/src/main/docbook/content/batch.xml 2007-10-26 00:48:48 UTC (rev 14136) @@ -1,360 +1,364 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="batch"> - <title>Processamento de lotes</title> - - <para> - Uma alternativa para inserir 100.000 linhas no banco de dados usando o Hibernate - pode ser a seguinte: - </para> - -<programlisting><![CDATA[Session session = sessionFactory.openSession(); -Transaction tx = session.beginTransaction(); -for ( int i=0; i<100000; i++ ) { - Customer customer = new Customer(.....); - session.save(customer); -} -tx.commit(); -session.close();]]></programlisting> - - <para> - Isto irá falhar em algum lugar próximo a linha 50.000, lançando uma - <literal>OutOfMemoryException</literal>. Isso ocorre devido ao fato do Hibernate - fazer cache de todas as instâncias de <literal>Customer</literal> inseridas num - cachê em nível de sessão. - </para> - - <para> - Neste capítulo veremos como contornar esse problema. Entretanto, se você vai realizar - processamento de lotes, é muito importante que você habilite o uso de lotes JDBC, se - você pretende obter um desempenho razoável. Defina o tamanho do lote JDBC em um - valor razoável (algo entre 10-50): - </para> - -<programlisting><![CDATA[hibernate.jdbc.batch_size 20]]></programlisting> - - <para> - Você também pode querer rodar esse tipo de processamento de lotes com o cache - secundário completamente desabilitado: - </para> - -<programlisting><![CDATA[hibernate.cache.use_second_level_cache false]]></programlisting> - - <para> - Mas isto não é absolutamente necessário, desde que nós possamos ajustar o - <literal>CacheMode</literal> para desabilitar a interação com o cache secundário. - </para> - - <sect1 id="batch-inserts"> - <title>Inserção de lotes</title> - - <para> - Quando você estiver inserindo novos objetos persistentes, vocês deve executar - os métodos <literal>flush()</literal> e <literal>clear()</literal> regularmente - na sessão, para controlar o tamanho do cache primário. - </para> - -<programlisting><![CDATA[Session session = sessionFactory.openSession(); -Transaction tx = session.beginTransaction(); - -for ( int i=0; i<100000; i++ ) { - Customer customer = new Customer(.....); - session.save(customer); - if ( i % 20 == 0 ) { //20, same as the JDBC batch size - //flush a batch of inserts and release memory: - session.flush(); - session.clear(); - } -} - -tx.commit(); -session.close();]]></programlisting> - - </sect1> - - <sect1 id="batch-update" > - <title>Batch updates</title> - - <para> - Para recuperar e atualizar informações a mesma idéia é válida. Adicionalmente, - pode precisar usar o <literal>scroll()</literal> para usar recursos no lado - do servidor em queries que retornam muita informação. - </para> - -<programlisting><![CDATA[Session session = sessionFactory.openSession(); -Transaction tx = session.beginTransaction(); - -ScrollableResults customers = session.getNamedQuery("GetCustomers") - .setCacheMode(CacheMode.IGNORE) - .scroll(ScrollMode.FORWARD_ONLY); -int count=0; -while ( customers.next() ) { - Customer customer = (Customer) customers.get(0); - customer.updateStuff(...); - if ( ++count % 20 == 0 ) { - //flush a batch of updates and release memory: - session.flush(); - session.clear(); - } -} - -tx.commit(); -session.close();]]></programlisting> - - </sect1> - - <sect1 id="batch-statelesssession"> - <title>A interface StatelessSession</title> - <para> - Alternativamente, o Hibernate provê uma API orientada à comandos, usada para - transmitir um fluxo de dados de e para o banco de dados na forma de objetos soltos. - Uma <literal>StatelessSession</literal> não tem um contexto persistente associado e - não fornece muito das semânticas de alto nível para controle do ciclo de vida. - Em especial, uma StatelessSession não implemente o cache primário e nem interage - com o cache secundário ou query cache. Ele não implementa salvamento transacional - automatico ou checagem automática de mudanças. Operação realizadas usando uma - StatelessSession não fazem nenhum tipo de cascade com as instancias associadas. - As coleções são ignoradas por uma StatelessSession. Operações realizadas com um - StatelessSession ignoram a arquitetura de eventos e os interceptadores. - StatelessSession são vulneráveis aos efeitos do aliasing dos dados, devido a - falta do cache primário. Uma StatelessSession é uma abstração de baixo nível, - muito mais próxima do JDBC. - </para> - -<programlisting><![CDATA[StatelessSession session = sessionFactory.openStatelessSession(); -Transaction tx = session.beginTransaction(); - -ScrollableResults customers = session.getNamedQuery("GetCustomers") - .scroll(ScrollMode.FORWARD_ONLY); -while ( customers.next() ) { - Customer customer = (Customer) customers.get(0); - customer.updateStuff(...); - session.update(customer); -} - -tx.commit(); -session.close();]]></programlisting> - - <para> - Veja neste exempo, as instancias de <literal>Customer</literal> retornadas pela query - são imediatamente desvinculadas. Elas nunca serão assossiadas à um contexto persistente. - </para> - - <para> - As operações <literal>insert(), update()</literal> e <literal>delete()</literal> - definidos pela interface <literal>StatelessSession</literal> são considerados - operações diretas no banco de dados (row-level operations), isso resulta em uma - execução imediata de comandos SQL <literal>INSERT, UPDATE</literal> ou - <literal>DELETE</literal> respectivamente. Devido a isso, eles possuem uma - semântica bem diferente das operações <literal>save(), saveOrUpdate()</literal> - ou <literal>delete()</literal> definidas na interface <literal>Session</literal>. - </para> - - </sect1> - - <sect1 id="batch-direct" revision="3"> - <title>Operações no estilo DML</title> - - <para> - Como já discutido, mapeamento objeto/relacional automático e transparente é conseguido - com a gerência do estado do objeto. Com isto o estado daquele objeto fica disponível na - memória, manipulando(usando as expressões SQL <literal>Data Manipulation Language</literal> - (SQL-style DML): <literal>INSERT</literal>, <literal>UPDATE</literal>, <literal>DELETE</literal>) - os dados diretamente no banco de dados não irá afetar o estado registrado em memória. - Entretanto, o Hibernate provê métodos para executar queries SQL-style DML, que são - totalmente executas com HQL (Hibernate Query Language) - (<xref linkend="queryhql">HQL</xref>). - </para> - - <para> - A pseudo-sintaxe para expressões <literal>UPDATE</literal> e <literal>DELETE</literal> é: - <literal>( UPDATE | DELETE ) FROM? NomeEntidade (WHERE condições_where)?</literal>. - Algumas observações: - </para> - - <itemizedlist spacing="compact"> - <listitem> - <para> - Na clausula from, a palavra chave FROM é opcional; - </para> - </listitem> - <listitem> - <para> - Somente uma entidade pode ser chamada na clausula from; opcionalmente pode ter - um alias. Se o nome da entidade for possuir um alias, então qualquer propriedade - referenciada deve usar esse alias qualificado; se o nome da entidade não possuir - um alias, então nenhuma das propriedade precisa usar o acesso qualificado. - </para> - </listitem> - <listitem> - <para> - Na <xref linkend="queryhql-joins-forms">joins</xref> (ambas implícita ou explicita) - pode ser especificada em um bulk HQL query. Sub-queries podem ser usadas na clausula - where; as subqueries podem conter joins. - </para> - </listitem> - <listitem> - <para> - A clausula where também é opcional. - </para> - </listitem> - </itemizedlist> - - <para> - Como exemplo para executar um HQL <literal>UPDATE</literal>, use o - método <literal>Query.executeUpdate()</literal>(o método ganhou o nome - devido a sua familiaridade com o do JDBC - <literal>PreparedStatement.executeUpdate()</literal>): - </para> - -<programlisting><![CDATA[Session session = sessionFactory.openSession(); -Transaction tx = session.beginTransaction(); - -String hqlUpdate = "update Customer c set c.name = :newName where c.name = :oldName"; -// or String hqlUpdate = "update 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> - HQL <literal>UPDATE</literal> statements, by default do not effect the - <xref linkend="mapping-declaration-version">version</xref> - or the <xref linkend="mapping-declaration-timestamp">timestamp</xref> property values - for the affected entities; this is in keeping with the EJB3 specification. However, - you can force Hibernate to properly reset the <literal>version</literal> or - <literal>timestamp</literal> property values through the use of a <literal>versioned update</literal>. - This is achieved by adding the <literal>VERSIONED</literal> keyword after the <literal>UPDATE</literal> - keyword. - - </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> - Note that custom version types (<literal>org.hibernate.usertype.UserVersionType</literal>) - are not allowed in conjunction with a <literal>update versioned</literal> statement. - </para> - - <para> - - Para executar um HQL <literal>DELETE</literal>, use o mesmo método - <literal>Query.executeUpdate()</literal>: - </para> - -<programlisting><![CDATA[Session session = sessionFactory.openSession(); -Transaction tx = session.beginTransaction(); - -String hqlDelete = "delete Customer c where c.name = :oldName"; -// or String hqlDelete = "delete Customer where name = :oldName"; -int deletedEntities = s.createQuery( hqlDelete ) - .setString( "oldName", oldName ) - .executeUpdate(); -tx.commit(); -session.close();]]></programlisting> - - <para> - O valor <literal>int</literal> retornado pelo método <literal>Query.executeUpdate()</literal> - indica o numero de entidade afetadas pela operação. Lembre-se que isso pode estar ou não - relacionado ao número de linhas alteradas no banco de dados. Uma operação bulk HQL pode resultar - em várias expressões SQL reais a serem executadas, por exemplo, no caso de joined-subclass. - O número retornado indica a quantidade real de entidades afetadas pela expressão. Voltando - ao exemplo da joined-subclass, a exclusão de uma das subclasses pode resultar numa - exclusão em outra tabelas, não apenas na tabela para qual a subclasses está mapeada, mas - também tabela "root" e possivelmente nas tabelas joined-subclass num nível hierárquico - imediatamente abaixo. - </para> - - <para> - - A pseudo-sintaxe para o comando <literal>INSERT</literal> é: - <literal>INSERT INTO EntityName properties_list select_statement</literal>. Alguns - pontos a observar: - </para> - - <itemizedlist spacing="compact"> - <listitem> - <para> - Apenas a forma INSERT INTO ... SELECT ... é suportada; INSERT INTO ... VALUES ... - não é suportada. - </para> - <para> - A lista de propriedade é análoga à <literal>especificação da coluna</literal> - do comando SQL <literal>INSERT</literal>. Para entidades envolvidas em mapeamentos, - apenas a propriedades definidas diretamente a nível da classe podem ser usandas na - properties_list. Propriedades da superclass não são permitidas; e as propriedades - da subclasse não faz sentido. Em outras palavras, os comandos - <literal>INSERT</literal> não são polimorficos. - </para> - </listitem> - <listitem> - <para> - O camando select pode ser qualquer query HQL válida, que tenha um retorno compatível - com o tipo com o esperado pela inclusão. Atualmente, isto é verificado durante a compilação - da query, isto é melhor do que permitir que a verificação chegue ao banco de dados. - Entretanto perceba que isso pode causar problemas entre os <literal>Tipo</literal> do Hibernate - que são <emphasis>equivalentes</emphasis> em oposição a <emphasis>equal</emphasis>. - Isso pode causar problemas nas combinações entre a propriedade definida como - <literal>org.hibernate.type.DateType</literal>e um propriedade definida como - <literal>org.hibernate.type.TimestampType</literal>, embora o banco de dados não possa - fazer uma distinção ou possa ser capaz de manusear a conversão. - </para> - </listitem> - <listitem> - <para> - Para a propriedade id, a expressão insert oferece duas opções. Você pode especificar - qualquer propriedade id explicitamente no properties_list (em alguns casos esse valor - é obtido diretamente da expressão select) ou pode omitir do properties_list (nesse caso, - um valor gerado é usado). Essa ultima opção só é válida quando são usados geradores de ids - que operam no banco de dados; a tentativa de usar essa opção com geradores do tipo - "em memória" vai causar um exceção durante a etapa de parser. Veja a finalidades desta - discussão, os seguintes geradores operam com o banco de dados - <literal>org.hibernate.id.SequenceGenerator</literal> (e suas subclasses) - e qualquer implementação de <literal>org.hibernate.id.PostInsertIdentifierGenerator</literal>. - Aqui, a exceção mais notável é o <literal>org.hibernate.id.TableHiLoGenerator</literal>, que - não pode ser usado porque ele não dispõe de mecanismos para recuperar o seu valor. - </para> - </listitem> - <listitem> - <para> - For properties mapped as either <literal>version</literal> or <literal>timestamp</literal>, - the insert statement gives you two options. You can either specify the property in the - properties_list (in which case its value is taken from the corresponding select expressions) - or omit it from the properties_list (in which case the <literal>seed value</literal> defined - by the <literal>org.hibernate.type.VersionType</literal> is used). - - Para propriedades mapeadas como <literal>version</literal> ou <literal>timestamp</literal>, - a expressão insert oferece a você duas opções. Você pode especificar a propriedade na - properties_list (nesse caso o seu valor é obtido a partir da expressão select correspondente) - ou ele pode ser omitido da properties_list (neste caso o usa o <literal>valor semente</literal> - definido pela classe <literal>org.hibernate.type.VersionType</literal>). - </para> - </listitem> - </itemizedlist> - - <para> - Exemplo da execução de um HQL <literal>INSERT</literal>: - </para> - -<programlisting><![CDATA[Session session = sessionFactory.openSession(); -Transaction tx = session.beginTransaction(); - -String hqlInsert = "insert into DelinquentAccount (id, name) select c.id, c.name from Customer c where ..."; -int createdEntities = s.createQuery( hqlInsert ) - .executeUpdate(); -tx.commit(); -session.close();]]></programlisting> - - </sect1> - -</chapter> +<chapter id="batch"> + <title>Processamento de lotes</title> + + <para> + Uma alternativa para inserir 100.000 linhas no banco de dados usando o Hibernate + pode ser a seguinte: + </para> + +<programlisting><![CDATA[Session session = sessionFactory.openSession(); +Transaction tx = session.beginTransaction(); +for ( int i=0; i<100000; i++ ) { + Customer customer = new Customer(.....); + session.save(customer); +} +tx.commit(); +session.close();]]></programlisting> + + <para> + Isto irá falhar em algum lugar próximo a linha 50.000, lançando uma + <literal>OutOfMemoryException</literal>. Isso ocorre devido ao fato do Hibernate + fazer cache de todas as instâncias de <literal>Customer</literal> inseridas num + cachê em nível de sessão. + </para> + + <para> + Neste capítulo veremos como contornar esse problema. Entretanto, se você vai realizar + processamento de lotes, é muito importante que você habilite o uso de lotes JDBC, se + você pretende obter um desempenho razoável. Defina o tamanho do lote JDBC em um + valor razoável (algo entre 10-50): + </para> + +<programlisting><![CDATA[hibernate.jdbc.batch_size 20]]></programlisting> + + <para> + Você também pode querer rodar esse tipo de processamento de lotes com o cache + secundário completamente desabilitado: + </para> + +<programlisting><![CDATA[hibernate.cache.use_second_level_cache false]]></programlisting> +<para id="disablebatching" revision="1"> + Note that Hibernate disables insert batching at the JDBC level transparently if you + use an <literal>identiy</literal> identifier generator. +</para> + + <para> + Mas isto não é absolutamente necessário, desde que nós possamos ajustar o + <literal>CacheMode</literal> para desabilitar a interação com o cache secundário. + </para> + + <sect1 id="batch-inserts"> + <title>Inserção de lotes</title> + + <para> + Quando você estiver inserindo novos objetos persistentes, vocês deve executar + os métodos <literal>flush()</literal> e <literal>clear()</literal> regularmente + na sessão, para controlar o tamanho do cache primário. + </para> + +<programlisting><![CDATA[Session session = sessionFactory.openSession(); +Transaction tx = session.beginTransaction(); + +for ( int i=0; i<100000; i++ ) { + Customer customer = new Customer(.....); + session.save(customer); + if ( i % 20 == 0 ) { //20, same as the JDBC batch size + //flush a batch of inserts and release memory: + session.flush(); + session.clear(); + } +} + +tx.commit(); +session.close();]]></programlisting> + + </sect1> + + <sect1 id="batch-update" > + <title>Batch updates</title> + + <para> + Para recuperar e atualizar informações a mesma idéia é válida. Adicionalmente, + pode precisar usar o <literal>scroll()</literal> para usar recursos no lado + do servidor em queries que retornam muita informação. + </para> + +<programlisting><![CDATA[Session session = sessionFactory.openSession(); +Transaction tx = session.beginTransaction(); + +ScrollableResults customers = session.getNamedQuery("GetCustomers") + .setCacheMode(CacheMode.IGNORE) + .scroll(ScrollMode.FORWARD_ONLY); +int count=0; +while ( customers.next() ) { + Customer customer = (Customer) customers.get(0); + customer.updateStuff(...); + if ( ++count % 20 == 0 ) { + //flush a batch of updates and release memory: + session.flush(); + session.clear(); + } +} + +tx.commit(); +session.close();]]></programlisting> + + </sect1> + + <sect1 id="batch-statelesssession"> + <title>A interface StatelessSession</title> + <para> + Alternativamente, o Hibernate provê uma API orientada à comandos, usada para + transmitir um fluxo de dados de e para o banco de dados na forma de objetos soltos. + Uma <literal>StatelessSession</literal> não tem um contexto persistente associado e + não fornece muito das semânticas de alto nível para controle do ciclo de vida. + Em especial, uma StatelessSession não implemente o cache primário e nem interage + com o cache secundário ou query cache. Ele não implementa salvamento transacional + automatico ou checagem automática de mudanças. Operação realizadas usando uma + StatelessSession não fazem nenhum tipo de cascade com as instancias associadas. + As coleções são ignoradas por uma StatelessSession. Operações realizadas com um + StatelessSession ignoram a arquitetura de eventos e os interceptadores. + StatelessSession são vulneráveis aos efeitos do aliasing dos dados, devido a + falta do cache primário. Uma StatelessSession é uma abstração de baixo nível, + muito mais próxima do JDBC. + </para> + +<programlisting><![CDATA[StatelessSession session = sessionFactory.openStatelessSession(); +Transaction tx = session.beginTransaction(); + +ScrollableResults customers = session.getNamedQuery("GetCustomers") + .scroll(ScrollMode.FORWARD_ONLY); +while ( customers.next() ) { + Customer customer = (Customer) customers.get(0); + customer.updateStuff(...); + session.update(customer); +} + +tx.commit(); +session.close();]]></programlisting> + + <para> + Veja neste exempo, as instancias de <literal>Customer</literal> retornadas pela query + são imediatamente desvinculadas. Elas nunca serão assossiadas à um contexto persistente. + </para> + + <para> + As operações <literal>insert(), update()</literal> e <literal>delete()</literal> + definidos pela interface <literal>StatelessSession</literal> são considerados + operações diretas no banco de dados (row-level operations), isso resulta em uma + execução imediata de comandos SQL <literal>INSERT, UPDATE</literal> ou + <literal>DELETE</literal> respectivamente. Devido a isso, eles possuem uma + semântica bem diferente das operações <literal>save(), saveOrUpdate()</literal> + ou <literal>delete()</literal> definidas na interface <literal>Session</literal>. + </para> + + </sect1> + + <sect1 id="batch-direct" revision="3"> + <title>Operações no estilo DML</title> + + <para> + Como já discutido, mapeamento objeto/relacional automático e transparente é conseguido + com a gerência do estado do objeto. Com isto o estado daquele objeto fica disponível na + memória, manipulando(usando as expressões SQL <literal>Data Manipulation Language</literal> + (SQL-style DML): <literal>INSERT</literal>, <literal>UPDATE</literal>, <literal>DELETE</literal>) + os dados diretamente no banco de dados não irá afetar o estado registrado em memória. + Entretanto, o Hibernate provê métodos para executar queries SQL-style DML, que são + totalmente executas com HQL (Hibernate Query Language) + (<xref linkend="queryhql">HQL</xref>). + </para> + + <para> + A pseudo-sintaxe para expressões <literal>UPDATE</literal> e <literal>DELETE</literal> é: + <literal>( UPDATE | DELETE ) FROM? NomeEntidade (WHERE condições_where)?</literal>. + Algumas observações: + </para> + + <itemizedlist spacing="compact"> + <listitem> + <para> + Na clausula from, a palavra chave FROM é opcional; + </para> + </listitem> + <listitem> + <para> + Somente uma entidade pode ser chamada na clausula from; opcionalmente pode ter + um alias. Se o nome da entidade for possuir um alias, então qualquer propriedade + referenciada deve usar esse alias qualificado; se o nome da entidade não possuir + um alias, então nenhuma das propriedade precisa usar o acesso qualificado. + </para> + </listitem> + <listitem> + <para> + Na <xref linkend="queryhql-joins-forms">joins</xref> (ambas implícita ou explicita) + pode ser especificada em um bulk HQL query. Sub-queries podem ser usadas na clausula + where; as subqueries podem conter joins. + </para> + </listitem> + <listitem> + <para> + A clausula where também é opcional. + </para> + </listitem> + </itemizedlist> + + <para> + Como exemplo para executar um HQL <literal>UPDATE</literal>, use o + método <literal>Query.executeUpdate()</literal>(o método ganhou o nome + devido a sua familiaridade com o do JDBC + <literal>PreparedStatement.executeUpdate()</literal>): + </para> + +<programlisting><![CDATA[Session session = sessionFactory.openSession(); +Transaction tx = session.beginTransaction(); + +String hqlUpdate = "update Customer c set c.name = :newName where c.name = :oldName"; +// or String hqlUpdate = "update 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> + HQL <literal>UPDATE</literal> statements, by default do not effect the + <xref linkend="mapping-declaration-version">version</xref> + or the <xref linkend="mapping-declaration-timestamp">timestamp</xref> property values + for the affected entities; this is in keeping with the EJB3 specification. However, + you can force Hibernate to properly reset the <literal>version</literal> or + <literal>timestamp</literal> property values through the use of a <literal>versioned update</literal>. + This is achieved by adding the <literal>VERSIONED</literal> keyword after the <literal>UPDATE</literal> + keyword. + + </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> + Note that custom version types (<literal>org.hibernate.usertype.UserVersionType</literal>) + are not allowed in conjunction with a <literal>update versioned</literal> statement. + </para> + + <para> + + Para executar um HQL <literal>DELETE</literal>, use o mesmo método + <literal>Query.executeUpdate()</literal>: + </para> + +<programlisting><![CDATA[Session session = sessionFactory.openSession(); +Transaction tx = session.beginTransaction(); + +String hqlDelete = "delete Customer c where c.name = :oldName"; +// or String hqlDelete = "delete Customer where name = :oldName"; +int deletedEntities = s.createQuery( hqlDelete ) + .setString( "oldName", oldName ) + .executeUpdate(); +tx.commit(); +session.close();]]></programlisting> + + <para> + O valor <literal>int</literal> retornado pelo método <literal>Query.executeUpdate()</literal> + indica o numero de entidade afetadas pela operação. Lembre-se que isso pode estar ou não + relacionado ao número de linhas alteradas no banco de dados. Uma operação bulk HQL pode resultar + em várias expressões SQL reais a serem executadas, por exemplo, no caso de joined-subclass. + O número retornado indica a quantidade real de entidades afetadas pela expressão. Voltando + ao exemplo da joined-subclass, a exclusão de uma das subclasses pode resultar numa + exclusão em outra tabelas, não apenas na tabela para qual a subclasses está mapeada, mas + também tabela "root" e possivelmente nas tabelas joined-subclass num nível hierárquico + imediatamente abaixo. + </para> + + <para> + + A pseudo-sintaxe para o comando <literal>INSERT</literal> é: + <literal>INSERT INTO EntityName properties_list select_statement</literal>. Alguns + pontos a observar: + </para> + + <itemizedlist spacing="compact"> + <listitem> + <para> + Apenas a forma INSERT INTO ... SELECT ... é suportada; INSERT INTO ... VALUES ... + não é suportada. + </para> + <para> + A lista de propriedade é análoga à <literal>especificação da coluna</literal> + do comando SQL <literal>INSERT</literal>. Para entidades envolvidas em mapeamentos, + apenas a propriedades definidas diretamente a nível da classe podem ser usandas na + properties_list. Propriedades da superclass não são permitidas; e as propriedades + da subclasse não faz sentido. Em outras palavras, os comandos + <literal>INSERT</literal> não são polimorficos. + </para> + </listitem> + <listitem> + <para> + O camando select pode ser qualquer query HQL válida, que tenha um retorno compatível + com o tipo com o esperado pela inclusão. Atualmente, isto é verificado durante a compilação + da query, isto é melhor do que permitir que a verificação chegue ao banco de dados. + Entretanto perceba que isso pode causar problemas entre os <literal>Tipo</literal> do Hibernate + que são <emphasis>equivalentes</emphasis> em oposição a <emphasis>equal</emphasis>. + Isso pode causar problemas nas combinações entre a propriedade definida como + <literal>org.hibernate.type.DateType</literal>e um propriedade definida como + <literal>org.hibernate.type.TimestampType</literal>, embora o banco de dados não possa + fazer uma distinção ou possa ser capaz de manusear a conversão. + </para> + </listitem> + <listitem> + <para> + Para a propriedade id, a expressão insert oferece duas opções. Você pode especificar + qualquer propriedade id explicitamente no properties_list (em alguns casos esse valor + é obtido diretamente da expressão select) ou pode omitir do properties_list (nesse caso, + um valor gerado é usado). Essa ultima opção só é válida quando são usados geradores de ids + que operam no banco de dados; a tentativa de usar essa opção com geradores do tipo + "em memória" vai causar um exceção durante a etapa de parser. Veja a finalidades desta + discussão, os seguintes geradores operam com o banco de dados + <literal>org.hibernate.id.SequenceGenerator</literal> (e suas subclasses) + e qualquer implementação de <literal>org.hibernate.id.PostInsertIdentifierGenerator</literal>. + Aqui, a exceção mais notável é o <literal>org.hibernate.id.TableHiLoGenerator</literal>, que + não pode ser usado porque ele não dispõe de mecanismos para recuperar o seu valor. + </para> + </listitem> + <listitem> + <para> + For properties mapped as either <literal>version</literal> or <literal>timestamp</literal>, + the insert statement gives you two options. You can either specify the property in the + properties_list (in which case its value is taken from the corresponding select expressions) + or omit it from the properties_list (in which case the <literal>seed value</literal> defined + by the <literal>org.hibernate.type.VersionType</literal> is used). + + Para propriedades mapeadas como <literal>version</literal> ou <literal>timestamp</literal>, + a expressão insert oferece a você duas opções. Você pode especificar a propriedade na + properties_list (nesse caso o seu valor é obtido a partir da expressão select correspondente) + ou ele pode ser omitido da properties_list (neste caso o usa o <literal>valor semente</literal> + definido pela classe <literal>org.hibernate.type.VersionType</literal>). + </para> + </listitem> + </itemizedlist> + + <para> + Exemplo da execução de um HQL <literal>INSERT</literal>: + </para> + +<programlisting><![CDATA[Session session = sessionFactory.openSession(); +Transaction tx = session.beginTransaction(); + +String hqlInsert = "insert into DelinquentAccount (id, name) select c.id, c.name from Customer c where ..."; +int createdEntities = s.createQuery( hqlInsert ) + .executeUpdate(); +tx.commit(); +session.close();]]></programlisting> + + </sect1> + +</chapter> Modified: core/trunk/documentation/manual/pt-BR/src/main/docbook/content/best_practices.xml =================================================================== --- core/trunk/documentation/manual/pt-BR/src/main/docbook/content/best_practices.xml 2007-10-26 00:46:38 UTC (rev 14135) +++ core/trunk/documentation/manual/pt-BR/src/main/docbook/content/best_practices.xml 2007-10-26 00:48:48 UTC (rev 14136) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="best-practices" revision="3"> +<chapter id="best-practices" revision="3"> <title>Boas práticas</title> <variablelist spacing="compact"> Modified: core/trunk/documentation/manual/pt-BR/src/main/docbook/content/collection_mapping.xml =================================================================== --- core/trunk/documentation/manual/pt-BR/src/main/docbook/content/collection_mapping.xml 2007-10-26 00:46:38 UTC (rev 14135) +++ core/trunk/documentation/manual/pt-BR/src/main/docbook/content/collection_mapping.xml 2007-10-26 00:48:48 UTC (rev 14136) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="collections"> +<chapter id="collections"> <title>Mapeamento de Coleções</title> <sect1 id="collections-persistent" revision="3"> Modified: core/trunk/documentation/manual/pt-BR/src/main/docbook/content/component_mapping.xml =================================================================== --- core/trunk/documentation/manual/pt-BR/src/main/docbook/content/component_mapping.xml 2007-10-26 00:46:38 UTC (rev 14135) +++ core/trunk/documentation/manual/pt-BR/src/main/docbook/content/component_mapping.xml 2007-10-26 00:48:48 UTC (rev 14136) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="components"> +<chapter id="components"> <title>Mapeamento de Componentes</title> <para> Modified: core/trunk/documentation/manual/pt-BR/src/main/docbook/content/configuration.xml =================================================================== --- core/trunk/documentation/manual/pt-BR/src/main/docbook/content/configuration.xml 2007-10-26 00:46:38 UTC (rev 14135) +++ core/trunk/documentation/manual/pt-BR/src/main/docbook/content/configuration.xml 2007-10-26 00:48:48 UTC (rev 14136) @@ -1,1792 +1,1789 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="session-configuration" revision="1"> - - <title>Configuração</title> - - <para> - Devido ao fato de o Hibernate ser projetado para operar em vários ambientes diferentes, - há um grande número de parâmetros de configuração. Felizmente, a maioria tem valores default - lógicos e o Hibernate é distribuído com um arquivo <literal>hibernate.properties</literal> - de exemplo no <literal>etc/</literal> que mostra várias opções. Apenas coloque o arquivo - de exemplo no seu classpath e personalize-o. - </para> - - <sect1 id="configuration-programmatic" revision="1"> - <title>1.11 Configuração programática</title> - - <para> - Uma instância de <literal>org.hibernate.cfg.Configuration</literal> - representa um conjunto inteiro de mapeamentos de tipos Java da aplicação para - um banco de dados SQL. O <literal>Configuration</literal> é usado para construir - uma <literal>SessionFactory</literal> (imutável). Os mapeamentos são compilados - a partir de arquivos de mapeamento XML. - - </para> - - <para> - Você pode obter uma instância <literal>Configuration</literal> intanciando- - o diretamente e especificando documentos de mapeamento XML. Se o arquivo - de mapeamento estão no classpath, use use <literal>addResource()</literal>: - </para> - - <programlisting><![CDATA[Configuration cfg = new Configuration() - .addResource("Item.hbm.xml") - .addResource("Bid.hbm.xml");]]></programlisting> - - <para> - Uma alternativa (às vezes melhor) é especificar a classe mapeada, - e permitir que o Hibernate encontre o documento de mapeamento para você: - </para> - - <programlisting><![CDATA[Configuration cfg = new Configuration() - .addClass(org.hibernate.auction.Item.class) - .addClass(org.hibernate.auction.Bid.class);]]></programlisting> - - <para> - Então o Hibernate procurará pelos arquivos de mapeamento chamados - <literal>/org/hibernate/auction/Item.hbm.xml</literal> e - <literal>/org/hibernate/auction/Bid.hbm.xml</literal> no classpath. - Esta abordagem elimina qualquer nome de arquivo de difícil compreensão. - </para> - - <para> - Uma <literal>Configuration</literal> também permite você especificar - propriedades de configuração: - </para> - - <programlisting><![CDATA[Configuration cfg = new Configuration() - .addClass(org.hibernate.auction.Item.class) - .addClass(org.hibernate.auction.Bid.class) - .setProperty("hibernate.dialect", "org.hibernate.dialect.MySQLInnoDBDialect") - .setProperty("hibernate.connection.datasource", "java:comp/env/jdbc/test") - .setProperty("hibernate.order_updates", "true");]]></programlisting> - - <para> - Este não é o único caminho para passar as propriedades de configuração - para o Hibernate. As várias opções incluem: - </para> - - <orderedlist spacing="compact"> - <listitem> - <para> - Passar uma instância de <literal>java.util.Properties</literal> - para <literal>Configuration.setProperties()</literal>. - </para> - </listitem> - <listitem> - <para> - Colocar <literal>hibernate.properties</literal> no diretório - raiz do classpath. - </para> - </listitem> - <listitem> - <para> - Determinar as propriedades do <literal>System</literal> - usando <literal>java -Dproperty=value</literal>. - </para> - </listitem> - <listitem> - <para> - Include <literal><property></literal> elements in - <literal>hibernate.cfg.xml</literal> (discussed later). - Incluir elementos <literal><property></literal> no - <literal>hibernate.cfg.xml</literal> (discutido mais tarde). - </para> - </listitem> - </orderedlist> - - <para> - <literal>hibernate.properties</literal> é o caminho mais facil - se você quer começar mais rápido. - </para> - - <para> - O <literal>Configuration</literal> é entendido como um objeto startup-time, - é descartado uma vez que a <literal>SessionFactory</literal> é criada. - </para> - - </sect1> - - <sect1 id="configuration-sessionfactory"> - <title>Obtendo uma SessionFactory</title> - - <para> - Quando todos os mapeamentos têm sido analisados pelo <literal>Configuration</literal>, - a aplicação deve obter uma factory para as instâncias da <literal>Session</literal>. - O objetivo desta factory é ser compartilhado por todas as threads da aplicação: - </para> - - <programlisting><![CDATA[SessionFactory sessions = cfg.buildSessionFactory();]]></programlisting> - - <para> - Hibernate permite sua aplicação instanciar mais do que uma - <literal>SessionFactory</literal>. Isto é útil se você está usando mais - do que um banco de dados. - </para> - - </sect1> - - <sect1 id="configuration-hibernatejdbc" revision="1"> - <title>Conexões JDBC</title> - - <para> - Normalmente, você quer mandar criar a <literal>SessionFactory</literal> criar um - pool de conexões JDBC para você. Se você seguir essa abordagem, a abertura de uma - <literal>Session</literal> é tão simples quanto: - - </para> - - <programlisting><![CDATA[Session session = sessions.openSession(); // open a new Session]]></programlisting> - - <para> - Assim que você fizer algo que requer o acesso ao banco de dados, uma - conexão JDBC será obtida do pool. - </para> - - <para> - Para esse trabalho, nós necessitamos passar algumas propriedades da conexão JDBC - para o Hibernate. Todos os nomes de propriedades Hibernate e semânticas são definidas - <literal>org.hibernate.cfg.Environment</literal>. Nós iremos descrever agora - o mais importantes configurações de conexão JDBC. - </para> - - <para> - O Hibernate obterá conexões( e pool) usando <literal>java.sql.DriverManager</literal> - se você determinar as seguintes propriedades: - </para> - - <table frame="topbot"> - <title>Propriedades JDBC Hibernate</title> - <tgroup cols="2"> - <colspec colname="c1" colwidth="1*"/> - <colspec colname="c2" colwidth="1*"/> - <thead> - <row> - <entry>Nome da Propriedade</entry> - <entry>Propósito</entry> - </row> - </thead> - <tbody> - <row> - <entry> - <literal>hibernate.connection.driver_class</literal> - </entry> - <entry> - <emphasis>Classe driver jdbc</emphasis> - </entry> - </row> - <row> - <entry> - <literal>hibernate.connection.url</literal> - </entry> - <entry> - <emphasis>URL jdbc</emphasis> - </entry> - </row> - <row> - <entry> - <literal>hibernate.connection.username</literal> - </entry> - <entry> - <emphasis>Usuário do banco de dados</emphasis> - </entry> - </row> - <row> - <entry> - <literal>hibernate.connection.password</literal> - </entry> - <entry> - <emphasis>Senha do usuário do banco de dados</emphasis> - </entry> - </row> - <row> - <entry> - <literal>hibernate.connection.pool_size</literal> - </entry> - <entry> - <emphasis>Número máximo de connecxões no pool</emphasis> - </entry> - </row> - </tbody> - </tgroup> - </table> - - <para> - O algoritmo de pool de conexões do próprio Hibernate entretanto é completamente - rudimentar. A intenção dele e ajudar a iniciar e <emphasis>não para usar em um - sistema de produção</emphasis> ou até para testar desempenho. Você deveria usar - uma ferramente de pool de terceiros para conseguir melhor desempenho e estabilidade. - Apenas especifique a propriedade <literal>hibernate.connection.pool_size</literal> - com a definição do pool de conexões. Isto irá desligar o pool interno do Hibernate. - Por exemplo, você pode gostar de usar C3P0. - </para> - - <para> - O C3P0 é um pool conexão JDBC de código aberto distribuído junto com - Hibernate no diretório <literal>lib</literal>. O Hibernate usará o - <literal>C3P0ConnectionProvider</literal> para o pool de conexão se - você configurar a propriedade <literal>hibernate.c3p0.*</literal>. Se você - gostar de usar Proxool consulte ao pacote <literal>hibernate.properties</literal> - e o web site do Hibernate para mais informações. - </para> - - <para> - Aqui é um exemplo de arquivo <literal>hibernate.properties</literal> para C3P0: - </para> - - <programlisting id="c3p0-configuration" revision="1"><![CDATA[hibernate.connection.driver_class = org.postgresql.Driver -hibernate.connection.url = jdbc:postgresql://localhost/mydatabase -hibernate.connection.username = myuser -hibernate.connection.password = secret -hibernate.c3p0.min_size=5 -hibernate.c3p0.max_size=20 -hibernate.c3p0.timeout=1800 -hibernate.c3p0.max_statements=50 -hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect]]></programlisting> - - <para> - Para usar dentro de um servidor de aplicação, você deve configurar - o Hibernate para obter conexões de um application server - <literal>Datasource</literal> registrado no JNDI. Você necessitará - determinar pelo menos uma das seguintes propriedades: - </para> - - <table frame="topbot"> - <title>Propriedades do Datasource do Hibernate</title> - <tgroup cols="2"> - <colspec colname="c1" colwidth="1*"/> - <colspec colname="c2" colwidth="1*"/> - <thead> - <row> - <entry>Nome da Propriedade</entry> - <entry>Propósito</entry> - </row> - </thead> - <tbody> - <row> - <entry> - <literal>hibernate.connection.datasource</literal> - </entry> - <entry> - <emphasis>Nome datasource JNDI</emphasis> - </entry> - </row> - <row> - <entry> - <literal>hibernate.jndi.url</literal> - </entry> - <entry> - <emphasis>URL do fornecedor JNDI</emphasis> (opcional) - </entry> - </row> - <row> - <entry> - <literal>hibernate.jndi.class</literal> - </entry> - <entry> - <emphasis>Classe do JNDI <literal>InitialContextFactory</literal></emphasis> (opcional) - </entry> - </row> - <row> - <entry> - <literal>hibernate.connection.username</literal> - </entry> - <entry> - <emphasis>Usuário do banco de dados</emphasis> (opcional) - </entry> - </row> - <row> - <entry> - <literal>hibernate.connection.password</literal> - </entry> - <entry> - <emphasis>Senha do usuário do banco de dados</emphasis> (opcional) - </entry> - </row> - </tbody> - </tgroup> - </table> - - <para> - Eis um exemplo de arquivo <literal>hibernate.properties</literal> para - um servidor de aplicação fornecedor de datasources JNDI: - </para> - - <programlisting><![CDATA[hibernate.connection.datasource = java:/comp/env/jdbc/test -hibernate.transaction.factory_class = \ - org.hibernate.transaction.JTATransactionFactory -hibernate.transaction.manager_lookup_class = \ - org.hibernate.transaction.JBossTransactionManagerLookup -hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect]]></programlisting> - - <para> - Conexões JDBC obtidas de um datasource JNDI irão automaticamente irão participar - das transações gerenciadas pelo container no servidor de aplicação. - </para> - - <para> - Arbitrariamente as propriedades de conexão podem ser acrescentandas ao - "<literal>hibernate.connnection</literal>" ao nome da propriedade. Por exemplo, - você deve especificar o <literal>charSet</literal> usando <literal>hibernate.connection.charSet</literal>.t. - </para> - - <para> - Você pode definir sua própria estratégia de plugin para obter conexões JDBC implementando - a interface <literal>org.hibernate.connection.ConnectionProvider</literal>. Você pode - escolher uma implementação customizada setando <literal>hibernate.connection.provider_class</literal>. - </para> - - </sect1> - - <sect1 id="configuration-optional" revision="1"> - <title>Propriedades opcionais de configuração</title> - - <para> - Há um grande número de outras propriedades que controlam o comportamento do Hibernate - em tempo de execução. Todos são opcionais e tem valores default lógicos. - </para> - - <para> - <emphasis>Aviso: algumas destas propriedades são somente a "nível de sistema".</emphasis> - Propriedades nível de sistema podem ser determinados somente via <literal>java -Dproperty=value</literal> - ou <literal>hibernate.properties</literal>. Elas <emphasis>não</emphasis>podem ser - configuradas por outras técnicas descritas abaixo. - </para> - - <table frame="topbot" id="configuration-optional-properties" revision="8"> - <title>Hibernate Configuration Properties</title> - <tgroup cols="2"> - <colspec colname="c1" colwidth="1*"/> - <colspec colname="c2" colwidth="1*"/> - <thead> - <row> - <entry>Nome da Propriedade</entry> - <entry>Propósito</entry> - </row> - </thead> - <tbody> - <row> - <entry> - <literal>hibernate.dialect</literal> - </entry> - <entry> - O nome da classe de um <literal>Dialeto</literal> - que permite o Hibernate gerar SQL otimizado para um banco de - dados relacional em particular. - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>full.classname.of.Dialect</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.show_sql</literal> - </entry> - <entry> - Escreve todas as instruções SQL no console. Esta é uma alternativa - a configurar a categoria de log <literal>org.hibernate.SQL</literal> - para <literal>debug</literal>. - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>true</literal> | <literal>false</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.format_sql</literal> - </entry> - <entry> - Imprime o SQL formatado no log e console. - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>true</literal> | <literal>false</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.default_schema</literal> - </entry> - <entry> - Qualifica no sql gerado, os nome das tabelas sem qualificar - com schena/tablespace dado - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>SCHEMA_NAME</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.default_catalog</literal> - </entry> - <entry> - Qualifica no sql gerado, os nome das tabelas sem qualificar - com catálogo dado - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>CATALOG_NAME</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.session_factory_name</literal> - </entry> - <entry> - O <literal>SessionFactory</literal> irá automaticamente - se ligar a este nome no JNDI depois de ter sido criado. - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>jndi/composite/name</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.max_fetch_depth</literal> - </entry> - <entry> - Estabelece a "profundidade" máxima para árvore outer join fetch - para associações finais únicas(one-to-one,many-to-one). - Um <literal>0</literal> desativa por default a busca outer join. - <para> - <emphasis role="strong">eg.</emphasis> - Valores recomendados entre<literal>0</literal> e <literal>3</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.default_batch_fetch_size</literal> - </entry> - <entry> - Determina um tamanho default para busca de associações em lotes do Hibernate - <para> - <emphasis role="strong">eg.</emphasis> - Valores recomendados <literal>4</literal>, <literal>8</literal>, - <literal>16</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.default_entity_mode</literal> - </entry> - <entry> - Determina um modo default para representação de entidades - para todas as sessões abertas desta <literal>SessionFactory</literal> - <para> - <literal>dynamic-map</literal>, <literal>dom4j</literal>, - <literal>pojo</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.order_updates</literal> - </entry> - <entry> - Força o Hibernate a ordenar os updates SQL pelo valor da chave - primária dos itens a serem atualizados. Isto resultará em menos - deadlocks nas transações em sistemas altamente concorrente. - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>true</literal> | <literal>false</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.generate_statistics</literal> - </entry> - <entry> - If enabled, Hibernate will collect statistics useful for - performance tuning. - Se habilitado, o Hibernate coletará estatísticas úties - para performance tuning dos bancos. - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>true</literal> | <literal>false</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.use_identifer_rollback</literal> - </entry> - <entry> - Se habilitado, propriedades identificadoras geradas - serão zeradas para os valores default quando os - objetos forem apagados. - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>true</literal> | <literal>false</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.use_sql_comments</literal> - </entry> - <entry> - Se ligado, o Hibernate irá gerar comentários dentro do SQL, - para facilitar o debugging, o valor default é <literal>false</literal>. - <para> - <emphasis role="strong">eg.</emphasis> - <literal>true</literal> | <literal>false</literal> - </para> - </entry> - </row> - </tbody> - </tgroup> - </table> - - <table frame="topbot" id="configuration-jdbc-properties" revision="8"> - <title>JDBC Hibernate e Propriedades de Conexão</title> - <tgroup cols="2"> - <colspec colname="c1" colwidth="1*"/> - <colspec colname="c2" colwidth="1*"/> - <thead> - <row> - <entry>Nome da Propriedade</entry> - <entry>Propósito</entry> - </row> - </thead> - <tbody> - <row> - <entry> - <literal>hibernate.jdbc.fetch_size</literal> - </entry> - <entry> - Um valor maior que zero determina o tamanho do fetch - do JDBC( chamadas <literal>Statement.setFetchSize()</literal>). - </entry> - </row> - <row> - <entry> - <literal>hibernate.jdbc.batch_size</literal> - </entry> - <entry> - Um valor maior que zero habilita uso de batch updates JDBC2 pelo Hibernate. - <para> - <emphasis role="strong">Ex.</emphasis> - valores recomentados entre <literal>5</literal> e <literal>30</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.jdbc.batch_versioned_data</literal> - </entry> - <entry> - Sete esta propriedade como <literal>true</literal> se seu driver JDBC retorna - o número correto de linhas no <literal>executeBatch()</literal> ( É usualmente - seguro tornar esta opção ligada). O Hibernate então irá usar betched DML - para automaticamente versionar dados. <literal>false</literal> por default. - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>true</literal> | <literal>false</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.jdbc.factory_class</literal> - </entry> - <entry> - Escolher um <literal>Batcher</literal> customizado. Muitas - aplicações não irão necessitar desta propriedade de configuração - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>classname.of.BatcherFactory</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.jdbc.use_scrollable_resultset</literal> - </entry> - <entry> - Habilita o uso de JDBC2 scrollable resultsets pelo Hibernate. - Essa propriedade somente é necessaria quando se usa Conexeções - JDBC providas pelo usuário, caso contrário o Hibernate os os - metadados da conexão. - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>true</literal> | <literal>false</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.jdbc.use_streams_for_binary</literal> - </entry> - <entry> - Use streams para escrever/ler tipos <literal>binary</literal> - ou <literal>serializable</literal> para/a o JDBC( propriedade a nível de sistema). - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>true</literal> | <literal>false</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.jdbc.use_get_generated_keys</literal> - </entry> - <entry> - Possibilita o uso <literal>PreparedStatement.getGeneratedKeys()</literal> - do JDBC3 para recuperar chaves geradas nativamente depois da inserçãp. - Requer driver JDBC3+ e JRE1.4+, determine para false se seu driver tem - problemas com gerador de indentificadores Hibernate. Por default, tente - determinar o driver capaz de usar metadados da conexão. - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>true|false</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.connection.provider_class</literal> - </entry> - <entry> - O nome da classe de um <literal>ConnectionProvider</literal> personalizado - o qual proverá conexões JDBC para o Hibernate. - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>classname.of.ConnectionProvider</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.connection.isolation</literal> - </entry> - <entry> - Determina o nível de isolamento de uma transação JDBC. - Verifique <literal>java.sql.Connection</literal> para valores - siginificativos mas note que a maior parte dos bancos de dados - não suportam todos os níveis de isolamento. - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>1, 2, 4, 8</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.connection.autocommit</literal> - </entry> - <entry> - Habilita autocommit para conexões no pool JDBC( não recomendado). - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>true</literal> | <literal>false</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.connection.release_mode</literal> - </entry> - <entry> - Especifica quando o Hibernate deve liberar conexões JDBC. Por default, - uma conexão JDBC é retida até a sessão está explicitamente fechada - ou desconectada. Para um datasource JTA do servidor de aplicação, você deve - usar <literal>after_statement</literal> para forçar s liberação da conexões - depois de todas as chamadas JDBC. Para uma conexão não-JTA, freqüentemente - faz sentido liberar a conexão ao fim de cada transação, usando - <literal>after_transaction</literal>. <literal>auto</literal> escolheremos - <literal>after_statement</literal> para as estratégias de transaçãoes JTA e CMT - e <literal>after_transaction</literal> para as estratégias de transação JDBC - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>auto</literal> (default) | <literal>on_close</literal> | - <literal>after_transaction</literal> | <literal>after_statement</literal> - </para> - <para> - Note that this setting only affects <literal>Session</literal>s returned from - <literal>SessionFactory.openSession</literal>. For <literal>Session</literal>s - obtained through <literal>SessionFactory.getCurrentSession</literal>, the - <literal>CurrentSessionContext</literal> implementation configured for use - controls the connection release mode for those <literal>Session</literal>s. - See <xref linkend="architecture-current-session"/> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.connection.<emphasis><propertyName></emphasis></literal> - </entry> - <entry> - Passa a propriedade JDBC <literal>propertyName</literal> - para <literal>DriverManager.getConnection()</literal>. - </entry> - </row> - <row> - <entry> - <literal>hibernate.jndi.<emphasis><propertyName></emphasis></literal> - </entry> - <entry> - Passar a propriedade <literal>propertyName</literal> para - o <literal>InitialContextFactory</literal> JNDI. - </entry> - </row> - </tbody> - </tgroup> - </table> - - <table frame="topbot" id="configuration-cache-properties" revision="7"> - <title>Propriedades de Cachê do Hibernate</title> - <tgroup cols="2"> - <colspec colname="c1" colwidth="1*"/> - <colspec colname="c2" colwidth="1*"/> - <thead> - <row> - <entry>Nome da Propriedade</entry> - <entry>Propósito</entry> - </row> - </thead> - <tbody> - <row> - <entry> - <literal>hibernate.cache.provider_class</literal> - </entry> - <entry> - O nome da classe de um <literal>CacheProvider</literal> customizado. - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>classname.of.CacheProvider</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.cache.use_minimal_puts</literal> - </entry> - <entry> - Otimizar operação de cachê de segundo nível para minimizar escritas, - ao custo de leituras mais frequantes. Esta configuração é mais útil - para cachês clusterizados e, no Hibernate3, é habilitado por default - para implementações de cachê clusterizar. - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>true|false</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.cache.use_query_cache</literal> - </entry> - <entry> - Habilita a cache de consultas, Mesmo assim, consultas individuais ainda tem que ser - habilitadas para o cache. - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>true|false</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.cache.use_second_level_cache</literal> - </entry> - <entry> - May be used to completely disable the second level cache, which is enabled - by default for classes which specify a <literal><cache></literal> - mapping. - Pode ser usada para desabilitar completamente ocache de segundo nível, - o qual está habilitado por default para classes que especificam - um mapeamento <literal><cache></literal>. - - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>true|false</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.cache.query_cache_factory</literal> - </entry> - <entry> - O nome de uma classe que implementa a interface - <literal>QueryCache</literal> personalizada, por - default, um <literal>StandardQueryCache</literal> - criado automaticamente. - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>classname.of.QueryCache</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.cache.region_prefix</literal> - </entry> - <entry> - Um prefixo para usar nos nomes da área especial - do cachê de segundo nível. - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>prefix</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.cache.use_structured_entries</literal> - </entry> - <entry> - Forces Hibernate to store data in the second-level cache - in a more human-friendly format. - Força o Hibernate armazenar dados no cachê se segundo - nível em um formato mais legivel. - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>true|false</literal> - </para> - </entry> - </row> - </tbody> - </tgroup> - </table> - - <table frame="topbot" id="configuration-transaction-properties" revision="9"> - <title>Propriedades de Transação do Hibernate</title> - <tgroup cols="2"> - <colspec colname="c1" colwidth="1*"/> - <colspec colname="c2" colwidth="1*"/> - <thead> - <row> - <entry>Nome da Propriedade</entry> - <entry>Propósito</entry> - </row> - </thead> - <tbody> - <row> - <entry> - <literal>hibernate.transaction.factory_class</literal> - </entry> - <entry> - O nome da clase de um a <literal>TransactionFactory</literal> - para usar com API <literal>Transaction</literal> - ( por default JDBCTransactionFactory). - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>classname.of.TransactionFactory</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>jta.UserTransaction</literal> - </entry> - <entry> - Um nome JNDI usado pelo <literal>JTATransactionFactory</literal> - para obter uma <literal>UserTransaction</literal> JTA a partir - do servidor de aplicação. - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>jndi/composite/name</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.transaction.manager_lookup_class</literal> - </entry> - <entry> - O nome da classe de um <literal>TransactionManagerLookup</literal> - – requerido quando caching a nível JVM esta habilitado ou quando - estivermos usando um generator hilo em um ambiente JTA. - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>classname.of.TransactionManagerLookup</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.transaction.flush_before_completion</literal> - </entry> - <entry> - Se habilitado, a sessão será automaticamente limpa antes da fase de - conclusão da transação. É preferivel a gerência interna e - automática do contexto da sessão, veja - <xref linkend="architecture-current-session"/> - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>true</literal> | <literal>false</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.transaction.auto_close_session</literal> - </entry> - <entry> - Se habilitado, a sessão será automaticamente fechada após a fase de - conclusão da transação. É preferivel a gerência interna e - automática do contexto da sessão, veja - <xref linkend="architecture-current-session"/> - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>true</literal> | <literal>false</literal> - </para> - </entry> - </row> - </tbody> - </tgroup> - </table> - - <table frame="topbot" id="configuration-misc-properties" revision="10"> - <title>Propriedades Variadas</title> - <tgroup cols="2"> - <colspec colname="c1" colwidth="1*"/> - <colspec colname="c2" colwidth="1*"/> - <thead> - <row> - <entry>Nome da Propriedade</entry> - <entry>Propósito</entry> - </row> - </thead> - <tbody> - <row> - <entry> - <literal>hibernate.current_session_context_class</literal> - </entry> - <entry> - Forneçe uma estratégia (personalizada) para extensão - da <literal>Session</literal> "corrente". Veja - <xref linkend="architecture-current-session"/> para - mais informação sobre estratégias internas. - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>jta</literal> | <literal>thread</literal> | - <literal>managed</literal> | <literal>custom.Class</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.query.factory_class</literal> - </entry> - <entry> - Escolha a implementação de análise HQL. - <para> - <emphasis role="strong">eg.</emphasis> - <literal>org.hibernate.hql.ast.ASTQueryTranslatorFactory</literal> or - <literal>org.hibernate.hql.classic.ClassicQueryTranslatorFactory</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.query.substitutions</literal> - </entry> - <entry> - Mapeamento a partir de símbolos em consultas HQL para - símbolos SQL( símbolos devem ser funções ou nome literais - , por exemplo). - <para> - <emphasis role="strong">eg.</emphasis> - <literal>hqlLiteral=SQL_LITERAL, hqlFunction=SQLFUNC</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.hbm2ddl.auto</literal> - </entry> - <entry> - Automaticamente valida ou exporta schema DDL para o banco de - dados quando o <literal>SessionFactory</literal> é criads. - Com <literal>create-drop</literal>, o schema do banco de dados - será excluido quando a <literal>create-drop</literal> for - fechada esplicitamente. - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>validate</literal> | <literal>update</literal> | - <literal>create</literal> | <literal>create-drop</literal> - </para> - </entry> - </row> - <row> - <entry> - <literal>hibernate.cglib.use_reflection_optimizer</literal> - </entry> - <entry> - Habilita o uso de CGLIB em vez de reflexão em tempo de execução - ( propriedade a nível de sistema). Reflexão pode algumas vezes ser ú - til quando controlar erros, note que o Hibernate sempre irá requerer a CGLIB - mesmo se você desligar o otimizador. Você não pode determinar esta - propriedade no hibernate.cfg.xml. - <para> - <emphasis role="strong">Ex.</emphasis> - <literal>true</literal> | <literal>false</literal> - </para> - </entry> - </row> - </tbody> - </tgroup> - </table> - - <sect2 id="configuration-optional-dialects" revision="1"> - <title>Dialetos SQL</title> - - <para> - Você deve sempre determinar a propriedade <literal>hibernate.dialect</literal> - para a subclasse de <literal>org.hibernate.dialect.Dialect</literal> correta de seu - banco de dados. Se você especificar um dialeto, Hibernate usará defaults lógicos - para qualquer um das outras propriedades listadas abaixo, reduzindo o esforço de - especificá-los manualmente. - </para> - - <table frame="topbot" id="sql-dialects" revision="2"> - <title>Hibernate SQL Dialects (<literal>hibernate.dialect</literal>)</title> - <tgroup cols="2"> - <colspec colwidth="1*"/> - <colspec colwidth="2.5*"/> - <thead> - <row> - <entry>RDBMS</entry> - <entry>Dialect</entry> - </row> - </thead> - <tbody> - <row> - <entry>DB2</entry> <entry><literal>org.hibernate.dialect.DB2Dialect</literal></entry> - </row> - <row> - <entry>DB2 AS/400</entry> <entry><literal>org.hibernate.dialect.DB2400Dialect</literal></entry> - </row> - <row> - <entry>DB2 OS390</entry> <entry><literal>org.hibernate.dialect.DB2390Dialect</literal></entry> - </row> - <row> - <entry>PostgreSQL</entry> <entry><literal>org.hibernate.dialect.PostgreSQLDialect</literal></entry> - </row> - <row> - <entry>MySQL</entry> <entry><literal>org.hibernate.dialect.MySQLDialect</literal></entry> - </row> - <row> - <entry>MySQL with InnoDB</entry> <entry><literal>org.hibernate.dialect.MySQLInnoDBDialect</literal></entry> - </row> - <row> - <entry>MySQL with MyISAM</entry> <entry><literal>org.hibernate.dialect.MySQLMyISAMDialect</literal></entry> - </row> - <row> - <entry>Oracle (any version)</entry> <entry><literal>org.hibernate.dialect.OracleDialect</literal></entry> - </row> - <row> - <entry>Oracle 9i/10g</entry> <entry><literal>org.hibernate.dialect.Oracle9Dialect</literal></entry> - </row> - <row> - <entry>Sybase</entry> <entry><literal>org.hibernate.dialect.SybaseDialect</literal></entry> - </row> - <row> - <entry>Sybase Anywhere</entry> <entry><literal>org.hibernate.dialect.SybaseAnywhereDialect</literal></entry> - </row> - <row> - <entry>Microsoft SQL Server</entry> <entry><literal>org.hibernate.dialect.SQLServerDialect</literal></entry> - </row> - <row> - <entry>SAP DB</entry> <entry><literal>org.hibernate.dialect.SAPDBDialect</literal></entry> - </row> - <row> - <entry>Informix</entry> <entry><literal>org.hibernate.dialect.InformixDialect</literal></entry> - </row> - <row> - <entry>HypersonicSQL</entry> <entry><literal>org.hibernate.dialect.HSQLDialect</literal></entry> - </row> - <row> - <entry>Ingres</entry> <entry><literal>org.hibernate.dialect.IngresDialect</literal></entry> - </row> - <row> - <entry>Progress</entry> <entry><literal>org.hibernate.dialect.ProgressDialect</literal></entry> - </row> - <row> - <entry>Mckoi SQL</entry> <entry><literal>org.hibernate.dialect.MckoiDialect</literal></entry> - </row> - <row> - <entry>Interbase</entry> <entry><literal>org.hibernate.dialect.InterbaseDialect</literal></entry> - </row> - <row> - <entry>Pointbase</entry> <entry><literal>org.hibernate.dialect.PointbaseDialect</literal></entry> - </row> - <row> - <entry>FrontBase</entry> <entry><literal>org.hibernate.dialect.FrontbaseDialect</literal></entry> - </row> - <row> - <entry>Firebird</entry> <entry><literal>org.hibernate.dialect.FirebirdDialect</literal></entry> - </row> - </tbody> - </tgroup> - </table> - - </sect2> - - <sect2 id="configuration-optional-outerjoin" revision="4"> - <title>Recuperação por união externa (Outer Join Fetching)</title> - - <para> - Se seu banco de dados suporta Recuperação por união externa (Outer Join Fetching) no estilo ANSI, - Oracle ou Sybase, A recuperação por união externa (Outer Join Fetching) frequentemente aumentará - o desempenho limitando o número de chamadas (round trips) ao banco de dados( ao custo de - possivelmente mais trabalho desempenhado pelo próprio banco de dados). A recuperação por - união externa (Outer Join Fetching)permite um gráfico completo de objetos conectados - por muitos-para-um, um-para-muitos, muitos-para-muitos e associações um-para-um para ser - recuperadas em um simples instrução SQL SELECT . - - </para> - - <para> - A recuperação por união externa (Outer Join Fetching) pode ser desabilitado - <emphasis>globalmente</emphasis> setando a propriedade - <literal>hibernate.max_fetch_depth</literal> para <literal>0</literal>. - Uma valor 1 ou maior habilita o outer join fetching para associações um-para-um - e muitos-para-umos cujos quais tem sido mapeado com <literal>fetch="join"</literal>. - </para> - - <para> - Veja <xref linkend="performance-fetching"/> para mais informações. - </para> - - </sect2> - - <sect2 id="configuration-optional-binarystreams" revision="1"> - <title>Fluxos Binários (Binary Streams)</title> - - <para> - O Oracle limita o tamanho de arrays de <literal>byte</literal> que pode ser - passado para/de o driver JDBC. Se você desejar usar grandes instâncias de - tipos <literal>binary</literal> ou <literal>serializable</literal>, você - deve habilitar <literal>hibernate.jdbc.use_streams_for_binary</literal>. - <emphasis>Essa é uma configuração que só pode ser feita a nível de sistema.</emphasis> - </para> - - </sect2> - - <sect2 id="configuration-optional-cacheprovider" revision="2"> - <title>Cachê de segundo nível e query</title> - - <para> - As propriedades prefixadas pelo <literal>hibernate.cache</literal> - permite você usar um sistema de cachê de segundo nível - em um processo executado em clustercom Hibernate. - Veja <xref linkend="performance-cache"/> para mais detalhes. - </para> - - </sect2> - - <sect2 id="configuration-optional-querysubstitution"> - <title>Substituições na Linguagem de Consulta</title> - - <para> - Você pode definir novos símbolos de consulta Hibernate usando - <literal>hibernate.query.substitutions</literal>. - Por exemplo: - </para> - - <programlisting>hibernate.query.substitutions true=1, false=0</programlisting> - - <para> - Faria com que os símbolos <literal>true</literal> e <literal>false</literal> - passasem a ser traduzidos para literais inteiro no SQL gerado. - </para> - - <programlisting>hibernate.query.substitutions toLowercase=LOWER</programlisting> - - <para> - permitirá você renomear a função <literal>LOWER</literal> no SQL. - </para> - - </sect2> - - <sect2 id="configuration-optional-statistics" revision="2"> - <title>Estatísticas do Hibernate</title> - - <para> - If you enable <literal>hibernate.generate_statistics</literal>, Hibernate will - expose a number of metrics that are useful when tuning a running system via - <literal>SessionFactory.getStatistics()</literal>. Hibernate can even be configured - to expose these statistics via JMX. Read the Javadoc of the interfaces in - <literal>org.hibernate.stats</literal> for more information. - - Se você habilitar <literal>hibernate.generate_statistics</literal>, o Hibernate - exibirá um número de métricas bastante útil ao ajustar um sistema via - <literal>SessionFactory.getStatistics()</literal>. O Hibernate pode até ser - configurado para exibir essas estatísticas via JMX. Leia o Javadoc da interface - <literal>org.hibernate.stats</literal> para mais informações. - </para> - - </sect2> - </sect1> - - <sect1 id="configuration-logging"> - <title>Logging</title> - - <para> - Hibernate registra vários eventos usando Apache commons-logging. - </para> - - <para> - O serviço commons-logging direcionará a saída para o Apache Log4j - ( se você incluir <literal>log4j.jar</literal>r no seu classpath) ou - JDK1.4 logging( se estiver em uso JDK1.4 ou maior). Você pode fazer o - download do Log4j a partir de <literal>http://jakarta.apache.org</literal>. - Para usar Log4j você necessitará colocar um arquivo - <literal>log4j.properties</literal> no seu classpath, um exemplo de arquivo - de propriedades é distribuído com o Hibernate no diretório - <literal>src/</literal>. - - </para> - - <para> - We strongly recommend that you familiarize yourself with Hibernate's log - messages. A lot of work has been put into making the Hibernate log as - detailed as possible, without making it unreadable. It is an essential - troubleshooting device. The most interesting log categories are the - following: - - Nós recomendamos enfaticamente que você se familiarize-se com mensagens de - log do Hibernate. Uma parte do trabalho tem sido posto em fazer o log - Hibernate tão detalhado quanto possível, sem fazê-lo ilegível. - É um essencial dispositivos de controle de erros. As categorias de log - mais interessantes são as seguintes: - </para> - - <table frame="topbot" id="log-categories" revision="2"> - <title>Categorias de Log do Hibernate</title> - <tgroup cols="2"> - <colspec colwidth="1*"/> - <colspec colwidth="2.5*"/> - <thead> - <row> - <entry>Categoria</entry> - <entry>Função</entry> - </row> - </thead> - <tbody> - <row> - <entry><literal>org.hibernate.SQL</literal></entry> - <entry>Registra todas as instruções SQL DML a medida que elas são executadas</entry> - </row> - <row> - <entry><literal>org.hibernate.type</literal></entry> - <entry>Registra todos os parâmetros JDBC</entry> - </row> - <row> - <entry><literal>org.hibernate.tool.hbm2ddl</literal></entry> - <entry>Registra todas as instruções SQL DDL a medida que elas são executadas</entry> - </row> - <row> - <entry><literal>org.hibernate.pretty</literal></entry> - <entry> - Log the state of all entities (max 20 entities) associated - with the session at flush time - Registra o estado de todas as entidades (máximo 20 entidades) - associadas a session no momento da limpeza (flush). - </entry> - </row> - <row> - <entry><literal>org.hibernate.cache</literal></entry> - <entry>Registra todas as atividades de cachê de segundo nível</entry> - </row> - <row> - <entry><literal>org.hibernate.transaction</literal></entry> - <entry>Registra atividades relacionada a transação</entry> - </row> - <row> - <entry><literal>org.hibernate.jdbc</literal></entry> - <entry>Registra todas as requisições de recursos JDBC</entry> - </row> - <row> - <entry><literal>org.hibernate.hql.ast.AST</literal></entry> - <entry> - Registra instruções SQL e HQL durante a análise da consultas - </entry> - </row> - <row> - <entry><literal>org.hibernate.secure</literal></entry> - <entry>Registra todas as requisições de autorização JAAS</entry> - </row> - <row> - <entry><literal>org.hibernate</literal></entry> - <entry> - Registra tudo ( uma parte das informações, mas muito - útil para controle de erros ) - </entry> - </row> - </tbody> - </tgroup> - </table> - - <para> - Quando desenvolver aplicações com Hibernate, você deve quase sempre trabalhar com - debug <literal>debug</literal> para a categoria <literal>org.hibernate.SQL</literal>, - ou, alternativamente, a com a propriedade <literal>hibernate.show_sql</literal> habilitada. - </para> - - - </sect1> - - <sect1 id="configuration-namingstrategy"> - <title>Implementado uma <literal>NamingStrategy</literal></title> - - <para> - A interface <literal>org.hibernate.cfg.NamingStrategy</literal> permite você - especificar um "padrão de nomeação" para objetos do banco de dados e elementos schema. - </para> - - <para> - Você deve criar regras para a geração automaticamente de identificadores - do banco de dados a partir de identificadores Java ou para processar - colunas "computadas" e nomes de tabelas dado o arquivo de mapeamento - para nomes "físicos" de tabelas e colunas. Esta característica ajuda a - reduzir a verbosidade do documento de mapeamento, eliminando interferências - repetitivas( <literal>TBL_</literal>prefixos, por exemplo). A estratégia - default usada pelo Hibernate é completamente mínima. - </para> - - <para> - Você pode especificar uma estratégia diferente ao chamar - <literal>Configuration.setNamingStrategy()</literal> antes de adicionar - os mapeamentos: - </para> - - <programlisting><![CDATA[SessionFactory sf = new Configuration() - .setNamingStrategy(ImprovedNamingStrategy.INSTANCE) - .addFile("Item.hbm.xml") - .addFile("Bid.hbm.xml") - .buildSessionFactory();]]></programlisting> - - <para> - <literal>org.hibernate.cfg.ImprovedNamingStrategy</literal> é uma estratégia - interna que pode ser um ponto de começo útil para algumas aplicações. - </para> - - </sect1> - - <sect1 id="configuration-xmlconfig" revision="2"> - <title>Arquivo de configuração XML</title> - - <para> - Uma maneira alternativa de configuração é especificar uma configuração completa - em um arquivo chamado <literal>hibernate.cfg.xml</literal>. Este arquivo pode - ser usado como um substituto para o arquivo <literal>hibernate.properties</literal> - ou, se ambos estão presentes, sobrescrever propriedades. - </para> - - <para> - The XML configuration file is by default expected to be in the root o - your <literal>CLASSPATH</literal>. Here is an example: - O arquivo XML de configuração é por default esperado para estar na - raiz do seu <literal>CLASSPATH</literal>. Veja um exemplo: - </para> - - <programlisting><![CDATA[<?xml version='1.0' encoding='utf-8'?> -<!DOCTYPE hibernate-configuration PUBLIC - "-//Hibernate/Hibernate Configuration DTD//EN" - "http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd"> - -<hibernate-configuration> - -  - <session-factory - name="java:hibernate/SessionFactory"> - -  - <property name="connection.datasource">java:/comp/env/jdbc/MyDB</property> - <property name="dialect">org.hibernate.dialect.MySQLDialect</property> - <property name="show_sql">false</property> - <property name="transaction.factory_class"> - org.hibernate.transaction.JTATransactionFactory - </property> - <property name="jta.UserTransaction">java:comp/UserTransaction</property> - -  - <mapping resource="org/hibernate/auction/Item.hbm.xml"/> - <mapping resource="org/hibernate/auction/Bid.hbm.xml"/> - -  - <class-cache class="org.hibernate.auction.Item" usage="read-write"/> - <class-cache class="org.hibernate.auction.Bid" usage="read-only"/> - <collection-cache collection="org.hibernate.auction.Item.bids" usage="read-write"/> - - </session-factory> - -</hibernate-configuration>]]></programlisting> - - <para> - Como você pode ver, a vantagem deste enfoque é a externalização dos nomes dos - arquivos de mapeamento para configuração. O <literal>hibernate.cfg.xml</literal> - também é mais conveniente caso você tenha que ajustar o cache do Hibernate. - Note que a escolha é sua em usar <literal>hibernate.properties</literal> ou - <literal>hibernate.cfg.xml</literal>, ambos são equivalente, à exceção dos benefícios - acima mencionados de usar a sintaxe de XML. - </para> - - <para> - Com a configuração do XML, iniciar o Hibernate é então tão simples como - </para> - - <programlisting><![CDATA[SessionFactory sf = new Configuration().configure().buildSessionFactory();]]></programlisting> - - <para> - You can pick a different XML configuration file using - </para> - - <programlisting><![CDATA[SessionFactory sf = new Configuration() - .configure("catdb.cfg.xml") - .buildSessionFactory();]]></programlisting> - - </sect1> - - <sect1 id="configuration-j2ee" revision="1"> - <title>Integração com servidores de aplicação J2EE</title> - - <para> - O Hibernate tem os seguintes pontos da integração para o infraestrutura de J2EE: - </para> - - <itemizedlist> - <listitem> - <para> - <emphasis>DataSources gerenciados pelo container</emphasis>: O Hibernate pode - usar conexões JDBC gerenciadas pelo Container e fornecidas pela JNDI. Geralmente, - um <literal>TransactionManager</literal> compatível com JTA e um - <literal>ResourceManager</literal> cuidam do gerenciamento da transação ( CMT ), - especialmente em transações distribuídas manipuladas através de vários DataSources. - Naturalmente, você também pode demarcar os limites das transações programaticamente (BMT) - ou você poderia querer usar a API opcional do Hibernate <literal>Transaction</literal> - para esta manter seu código portável. - </para> - </listitem> - </itemizedlist> - - <itemizedlist> - <listitem> - <para> - <emphasis>Ligação (binding) automática a JNDI</emphasis>: O Hibernate pode - associar sua <literal>SessionFactory</literal> a JNDI depois de iniciado. - </para> - </listitem> - </itemizedlist> - - <itemizedlist> - <listitem> - <para> - <emphasis>Ligação (binding) Session na JTA:</emphasis> - A <literal>Session</literal> do Hibernate pode automaticamente ser ligada - ao escopo da transações JTA. Simplesmente localizando a <literal>SessionFactory</literal> - da JNDI e obtendo a<literal>Session</literal> corrente. Deixe o Hibernate cuidar - da limpeza e encerramento da <literal>Session</literal> quando as transações JTA - terminarem. A Demarcação de transação pode ser declarativa (CMT) ou - programática(BMT/Transação do usuário). - </para> - </listitem> - </itemizedlist> - - <itemizedlist> - <listitem> - <para> - <emphasis>JMX deployment:</emphasis> Se você usa um JMX servidor de - aplicações capaz (ex. Jboss AS), você pode fazer a instação do Hibernate - como um Mbean controlado. Isto evita ter que iniciar uma linha de - código para construir sua <literal>SessionFactory</literal> de uma - <literal>Configuration</literal>. O container iniciará seu - <literal>HibernateService</literal>, e idealmente também cuidará - das dependências de serviços (DataSources, têm que estar disponíveis - antes do Hibernate iniciar, etc.). - </para> - </listitem> - </itemizedlist> - - <para> - Dependendo em seu ambiente, você poderia ter que ajustar a opção de configuração - <literal>hibernate.connection.aggressive_release</literal> para verdadeiro ( true ), - se seu servidor de aplicações lançar exeções "retenção de conecção". - </para> - - <sect2 id="configuration-optional-transactionstrategy" revision="3"> - <title>Configuração de estratégia de transação</title> - - <para> - A API Hibernate <literal>Session</literal> é independente de qualquer sistema de - demarcação de transação em sua arquitetura. Se você deixar o Hibernate usar - a JDBC diretamente, através de um pool de conexões, você pode inicializar e - encerrar suas transações chamando a API JDBC. Se você rodar em um servidor de - aplicações J2EE, você poderá usar transações controladas por beans e chamar - a API JTA e <literal>UserTransaction</literal> quando necessário. - - </para> - - <para> - Para manter seu código portável entre estes dois ( e outros ) ambientes, recomendamos - a API Hibernate <literal>Transaction</literal>, que envolve e esconde o sistema subjacente. - Você tem que especificar um classe construtora para <literal>Transaction</literal> instanciar - ajustando a propriedade de configuração do <literal>hibernate.transaction.factory_class</literal>. - - </para> - - <para> - Existem três escolhas (internas) padrões: - </para> - - <variablelist spacing="compact"> - <varlistentry> - <term><literal>org.hibernate.transaction.JDBCTransactionFactory</literal></term> - <listitem> - <para>delegada as transações (JDBC)a bases de dados (Padrão)</para> - - </listitem> - </varlistentry> - <varlistentry> - <term><literal>org.hibernate.transaction.JTATransactionFactory</literal></term> - <listitem> - <para> - delegada a transação a um container gerenciador se a transação - existente estiver de acordo neste contexto (ex: método bean sessão EJB), - se não uma nova transação é iniciada e uma transação controlado por - um bean é usada. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>org.hibernate.transaction.CMTTransactionFactory</literal></term> - <listitem> - <para>delega para um container gerenciador de transações JTA</para> - </listitem> - </varlistentry> - </variablelist> - - <para> - Você também pode definir suas próprias estratégias de transação ( para um serviço de - transação CORBA por exemplo). - </para> - - <para> - Algumas características no Hibernate (ex., o cache de segundo nível, sessões contextuais - com JTA, etc.) requerem acesso a JTA <literal>TransactionManager</literal> em um ambiente - controlado. Em um servidor de aplicação você tem que especificar como o Hibernate pode - obter uma referência para a <literal>TransactionManager</literal>, pois o J2EE não - padronize um mecanismo simples : - </para> - - <table frame="topbot" id="jtamanagerlookup" revision="1"> - <title>Gerenciadores de transações JTA</title> - <tgroup cols="2"> - <colspec colwidth="2.5*"/> - <colspec colwidth="1*"/> - <thead> - <row> - <entry>Transaction Factory</entry> - <entry align="center">Application Server</entry> - </row> - </thead> - <tbody> - <row> - <entry><literal>org.hibernate.transaction.JBossTransactionManagerLookup</literal></entry> - <entry align="center">JBoss</entry> - </row> - <row> - <entry><literal>org.hibernate.transaction.WeblogicTransactionManagerLookup</literal></entry> - <entry align="center">Weblogic</entry> - </row> - <row> - <entry><literal>org.hibernate.transaction.WebSphereTransactionManagerLookup</literal></entry> - <entry align="center">WebSphere</entry> - </row> - <row> - <entry><literal>org.hibernate.transaction.WebSphereExtendedJTATransactionLookup</literal></entry> - <entry align="center">WebSphere 6</entry> - </row> - <row> - <entry><literal>org.hibernate.transaction.OrionTransactionManagerLookup</literal></entry> - <entry align="center">Orion</entry> - </row> - <row> - <entry><literal>org.hibernate.transaction.ResinTransactionManagerLookup</literal></entry> - <entry align="center">Resin</entry> - </row> - <row> - <entry><literal>org.hibernate.transaction.JOTMTransactionManagerLookup</literal></entry> - <entry align="center">JOTM</entry> - </row> - <row> - <entry><literal>org.hibernate.transaction.JOnASTransactionManagerLookup</literal></entry> - <entry align="center">JOnAS</entry> - </row> - <row> - <entry><literal>org.hibernate.transaction.JRun4TransactionManagerLookup</literal></entry> - <entry align="center">JRun4</entry> - </row> - <row> - <entry><literal>org.hibernate.transaction.BESTransactionManagerLookup</literal></entry> - <entry align="center">Borland ES</entry> - </row> - </tbody> - </tgroup> - </table> - - </sect2> - - <sect2 id="configuration-optional-jndi" revision="3"> - <title><literal>SessionFactory</literal> ligada a JNDI</title> - - <para> - Uma <literal>SessionFactory</literal> de Hibernate ligada a JNDI pode simplificar - a localização da fabrica e a criação de novas <literal>Session</literal>s. - Observe que isto não relacionado a um <literal>Datasource</literal> ligado - a JNDI, simplemente ambos usam o mesmo registro! - </para> - - <para> - If you wish to have the <literal>SessionFactory</literal> bound to a JNDI namespace, specify - a name (eg. <literal>java:hibernate/SessionFactory</literal>) using the property - <literal>hibernate.session_factory_name</literal>. If this property is omitted, the - <literal>SessionFactory</literal> will not be bound to JNDI. (This is especially useful in - environments with a read-only JNDI default implementation, e.g. Tomcat.) - </para> - - <para> - When binding the <literal>SessionFactory</literal> to JNDI, Hibernate will use the values of - <literal>hibernate.jndi.url</literal>, <literal>hibernate.jndi.class</literal> to instantiate - an initial context. If they are not specified, the default <literal>InitialContext</literal> - will be used. - </para> - - <para> - Hibernate will automatically place the <literal>SessionFactory</literal> in JNDI after - you call <literal>cfg.buildSessionFactory()</literal>. This means you will at least have - this call in some startup code (or utility class) in your application, unless you use - JMX deployment with the <literal>HibernateService</literal> (discussed later). - </para> - - <para> - If you use a JNDI <literal>SessionFactory</literal>, an EJB or any other class may - obtain the <literal>SessionFactory</literal> using a JNDI lookup. - </para> - - <para> - We recommend that you bind the <literal>SessionFactory</literal> to JNDI in - a managend environment and use a <literal>static</literal> singleton otherwise. - To shield your application code from these details, we also recommend to hide the - actual lookup code for a <literal>SessionFactory</literal> in a helper class, - such as <literal>HibernateUtil.getSessionFactory()</literal>. Note that such a - class is also a convenient way to startup Hibernate—see chapter 1. - </para> - - </sect2> - - <sect2 id="configuration-j2ee-currentsession" revision="4"> - <title>Current Session context management with JTA</title> - - <para> - The easiest way to handle <literal>Session</literal>s and transactions is - Hibernates automatic "current" <literal>Session</literal> management. - See the discussion of <xref linkend="architecture-current-session">current sessions</xref>. - Using the <literal>"jta"</literal> session context, if there is no Hibernate - <literal>Session</literal> associated with the current JTA transaction, one will - be started and associated with that JTA transaction the first time you call - <literal>sessionFactory.getCurrentSession()</literal>. The <literal>Session</literal>s - retrieved via <literal>getCurrentSession()</literal> in <literal>"jta"</literal> context - will be set to automatically flush before the transaction completes, close - after the transaction completes, and aggressively release JDBC connections - after each statement. This allows the <literal>Session</literal>s to - be managed by the life cycle of the JTA transaction to which it is associated, - keeping user code clean of such management concerns. Your code can either use - JTA programmatically through <literal>UserTransaction</literal>, or (recommended - for portable code) use the Hibernate <literal>Transaction</literal> API to set - transaction boundaries. If you run in an EJB container, declarative transaction - demarcation with CMT is preferred. - </para> - - </sect2> - - <sect2 id="configuration-j2ee-jmx" revision="1"> - <title>JMX deployment</title> - - <para> - The line <literal>cfg.buildSessionFactory()</literal> still has to be executed - somewhere to get a <literal>SessionFactory</literal> into JNDI. You can do this - either in a <literal>static</literal> initializer block (like the one in - <literal>HibernateUtil</literal>) or you deploy Hibernate as a <emphasis>managed - service</emphasis>. - </para> - - <para> - Hibernate is distributed with <literal>org.hibernate.jmx.HibernateService</literal> - for deployment on an application server with JMX capabilities, such as JBoss AS. - The actual deployment and configuration is vendor specific. Here is an example - <literal>jboss-service.xml</literal> for JBoss 4.0.x: - </para> - - <programlisting><![CDATA[<?xml version="1.0"?> -<server> - -<mbean code="org.hibernate.jmx.HibernateService" - name="jboss.jca:service=HibernateFactory,name=HibernateFactory"> - -  - <depends>jboss.jca:service=RARDeployer</depends> - <depends>jboss.jca:service=LocalTxCM,name=HsqlDS</depends> - -  - <attribute name="JndiName">java:/hibernate/SessionFactory</attribute> - -  - <attribute name="Datasource">java:HsqlDS</attribute> - <attribute name="Dialect">org.hibernate.dialect.HSQLDialect</attribute> - -  - <attribute name="TransactionStrategy"> - org.hibernate.transaction.JTATransactionFactory</attribute> - <attribute name="TransactionManagerLookupStrategy"> - org.hibernate.transaction.JBossTransactionManagerLookup</attribute> - <attribute name="FlushBeforeCompletionEnabled">true</attribute> - <attribute name="AutoCloseSessionEnabled">true</attribute> - -  - <attribute name="MaximumFetchDepth">5</attribute> - -  - <attribute name="SecondLevelCacheEnabled">true</attribute> - <attribute name="CacheProviderClass">org.hibernate.cache.EhCacheProvider</attribute> - <attribute name="QueryCacheEnabled">true</attribute> - -  - <attribute name="ShowSqlEnabled">true</attribute> - -  - <attribute name="MapResources">auction/Item.hbm.xml,auction/Category.hbm.xml</attribute> - -</mbean> - -</server>]]></programlisting> - - <para> - This file is deployed in a directory called <literal>META-INF</literal> and packaged - in a JAR file with the extension <literal>.sar</literal> (service archive). You also need - to package Hibernate, its required third-party libraries, your compiled persistent classes, - as well as your mapping files in the same archive. Your enterprise beans (usually session - beans) may be kept in their own JAR file, but you may include this EJB JAR file in the - main service archive to get a single (hot-)deployable unit. Consult the JBoss AS - documentation for more information about JMX service and EJB deployment. - </para> - - </sect2> - - </sect1> - -</chapter> - +<chapter id="session-configuration" revision="1"> + + <title>Configuração</title> + + <para> + Devido ao fato de o Hibernate ser projetado para operar em vários ambientes diferentes, + há um grande número de parâmetros de configuração. Felizmente, a maioria tem valores default + lógicos e o Hibernate é distribuído com um arquivo <literal>hibernate.properties</literal> + de exemplo no <literal>etc/</literal> que mostra várias opções. Apenas coloque o arquivo + de exemplo no seu classpath e personalize-o. + </para> + + <sect1 id="configuration-programmatic" revision="1"> + <title>1.11 Configuração programática</title> + + <para> + Uma instância de <literal>org.hibernate.cfg.Configuration</literal> + representa um conjunto inteiro de mapeamentos de tipos Java da aplicação para + um banco de dados SQL. O <literal>Configuration</literal> é usado para construir + uma <literal>SessionFactory</literal> (imutável). Os mapeamentos são compilados + a partir de arquivos de mapeamento XML. + + </para> + + <para> + Você pode obter uma instância <literal>Configuration</literal> intanciando- + o diretamente e especificando documentos de mapeamento XML. Se o arquivo + de mapeamento estão no classpath, use use <literal>addResource()</literal>: + </para> + + <programlisting><![CDATA[Configuration cfg = new Configuration() + .addResource("Item.hbm.xml") + .addResource("Bid.hbm.xml");]]></programlisting> + + <para> + Uma alternativa (às vezes melhor) é especificar a classe mapeada, + e permitir que o Hibernate encontre o documento de mapeamento para você: + </para> + + <programlisting><![CDATA[Configuration cfg = new Configuration() + .addClass(org.hibernate.auction.Item.class) + .addClass(org.hibernate.auction.Bid.class);]]></programlisting> + + <para> + Então o Hibernate procurará pelos arquivos de mapeamento chamados + <literal>/org/hibernate/auction/Item.hbm.xml</literal> e + <literal>/org/hibernate/auction/Bid.hbm.xml</literal> no classpath. + Esta abordagem elimina qualquer nome de arquivo de difícil compreensão. + </para> + + <para> + Uma <literal>Configuration</literal> também permite você especificar + propriedades de configuração: + </para> + + <programlisting><![CDATA[Configuration cfg = new Configuration() + .addClass(org.hibernate.auction.Item.class) + .addClass(org.hibernate.auction.Bid.class) + .setProperty("hibernate.dialect", "org.hibernate.dialect.MySQLInnoDBDialect") + .setProperty("hibernate.connection.datasource", "java:comp/env/jdbc/test") + .setProperty("hibernate.order_updates", "true");]]></programlisting> + + <para> + Este não é o único caminho para passar as propriedades de configuração + para o Hibernate. As várias opções incluem: + </para> + + <orderedlist spacing="compact"> + <listitem> + <para> + Passar uma instância de <literal>java.util.Properties</literal> + para <literal>Configuration.setProperties()</literal>. + </para> + </listitem> + <listitem> + <para> + Colocar <literal>hibernate.properties</literal> no diretório + raiz do classpath. + </para> + </listitem> + <listitem> + <para> + Determinar as propriedades do <literal>System</literal> + usando <literal>java -Dproperty=value</literal>. + </para> + </listitem> + <listitem> + <para> + Include <literal><property></literal> elements in + <literal>hibernate.cfg.xml</literal> (discussed later). + Incluir elementos <literal><property></literal> no + <literal>hibernate.cfg.xml</literal> (discutido mais tarde). + </para> + </listitem> + </orderedlist> + + <para> + <literal>hibernate.properties</literal> é o caminho mais facil + se você quer começar mais rápido. + </para> + + <para> + O <literal>Configuration</literal> é entendido como um objeto startup-time, + é descartado uma vez que a <literal>SessionFactory</literal> é criada. + </para> + + </sect1> + + <sect1 id="configuration-sessionfactory"> + <title>Obtendo uma SessionFactory</title> + + <para> + Quando todos os mapeamentos têm sido analisados pelo <literal>Configuration</literal>, + a aplicação deve obter uma factory para as instâncias da <literal>Session</literal>. + O objetivo desta factory é ser compartilhado por todas as threads da aplicação: + </para> + + <programlisting><![CDATA[SessionFactory sessions = cfg.buildSessionFactory();]]></programlisting> + + <para> + Hibernate permite sua aplicação instanciar mais do que uma + <literal>SessionFactory</literal>. Isto é útil se você está usando mais + do que um banco de dados. + </para> + + </sect1> + + <sect1 id="configuration-hibernatejdbc" revision="1"> + <title>Conexões JDBC</title> + + <para> + Normalmente, você quer mandar criar a <literal>SessionFactory</literal> criar um + pool de conexões JDBC para você. Se você seguir essa abordagem, a abertura de uma + <literal>Session</literal> é tão simples quanto: + + </para> + + <programlisting><![CDATA[Session session = sessions.openSession(); // open a new Session]]></programlisting> + + <para> + Assim que você fizer algo que requer o acesso ao banco de dados, uma + conexão JDBC será obtida do pool. + </para> + + <para> + Para esse trabalho, nós necessitamos passar algumas propriedades da conexão JDBC + para o Hibernate. Todos os nomes de propriedades Hibernate e semânticas são definidas + <literal>org.hibernate.cfg.Environment</literal>. Nós iremos descrever agora + o mais importantes configurações de conexão JDBC. + </para> + + <para> + O Hibernate obterá conexões( e pool) usando <literal>java.sql.DriverManager</literal> + se você determinar as seguintes propriedades: + </para> + + <table frame="topbot"> + <title>Propriedades JDBC Hibernate</title> + <tgroup cols="2"> + <colspec colname="c1" colwidth="1*"/> + <colspec colname="c2" colwidth="1*"/> + <thead> + <row> + <entry>Nome da Propriedade</entry> + <entry>Propósito</entry> + </row> + </thead> + <tbody> + <row> + <entry> + <literal>hibernate.connection.driver_class</literal> + </entry> + <entry> + <emphasis>Classe driver jdbc</emphasis> + </entry> + </row> + <row> + <entry> + <literal>hibernate.connection.url</literal> + </entry> + <entry> + <emphasis>URL jdbc</emphasis> + </entry> + </row> + <row> + <entry> + <literal>hibernate.connection.username</literal> + </entry> + <entry> + <emphasis>Usuário do banco de dados</emphasis> + </entry> + </row> + <row> + <entry> + <literal>hibernate.connection.password</literal> + </entry> + <entry> + <emphasis>Senha do usuário do banco de dados</emphasis> + </entry> + </row> + <row> + <entry> + <literal>hibernate.connection.pool_size</literal> + </entry> + <entry> + <emphasis>Número máximo de connecxões no pool</emphasis> + </entry> + </row> + </tbody> + </tgroup> + </table> + + <para> + O algoritmo de pool de conexões do próprio Hibernate entretanto é completamente + rudimentar. A intenção dele e ajudar a iniciar e <emphasis>não para usar em um + sistema de produção</emphasis> ou até para testar desempenho. Você deveria usar + uma ferramente de pool de terceiros para conseguir melhor desempenho e estabilidade. + Apenas especifique a propriedade <literal>hibernate.connection.pool_size</literal> + com a definição do pool de conexões. Isto irá desligar o pool interno do Hibernate. + Por exemplo, você pode gostar de usar C3P0. + </para> + + <para> + O C3P0 é um pool conexão JDBC de código aberto distribuído junto com + Hibernate no diretório <literal>lib</literal>. O Hibernate usará o + <literal>C3P0ConnectionProvider</literal> para o pool de conexão se + você configurar a propriedade <literal>hibernate.c3p0.*</literal>. Se você + gostar de usar Proxool consulte ao pacote <literal>hibernate.properties</literal> + e o web site do Hibernate para mais informações. + </para> + + <para> + Aqui é um exemplo de arquivo <literal>hibernate.properties</literal> para C3P0: + </para> + + <programlisting id="c3p0-configuration" revision="1"><![CDATA[hibernate.connection.driver_class = org.postgresql.Driver +hibernate.connection.url = jdbc:postgresql://localhost/mydatabase +hibernate.connection.username = myuser +hibernate.connection.password = secret +hibernate.c3p0.min_size=5 +hibernate.c3p0.max_size=20 +hibernate.c3p0.timeout=1800 +hibernate.c3p0.max_statements=50 +hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect]]></programlisting> + + <para> + Para usar dentro de um servidor de aplicação, você deve configurar + o Hibernate para obter conexões de um application server + <literal>Datasource</literal> registrado no JNDI. Você necessitará + determinar pelo menos uma das seguintes propriedades: + </para> + + <table frame="topbot"> + <title>Propriedades do Datasource do Hibernate</title> + <tgroup cols="2"> + <colspec colname="c1" colwidth="1*"/> + <colspec colname="c2" colwidth="1*"/> + <thead> + <row> + <entry>Nome da Propriedade</entry> + <entry>Propósito</entry> + </row> + </thead> + <tbody> + <row> + <entry> + <literal>hibernate.connection.datasource</literal> + </entry> + <entry> + <emphasis>Nome datasource JNDI</emphasis> + </entry> + </row> + <row> + <entry> + <literal>hibernate.jndi.url</literal> + </entry> + <entry> + <emphasis>URL do fornecedor JNDI</emphasis> (opcional) + </entry> + </row> + <row> + <entry> + <literal>hibernate.jndi.class</literal> + </entry> + <entry> + <emphasis>Classe do JNDI <literal>InitialContextFactory</literal></emphasis> (opcional) + </entry> + </row> + <row> + <entry> + <literal>hibernate.connection.username</literal> + </entry> + <entry> + <emphasis>Usuário do banco de dados</emphasis> (opcional) + </entry> + </row> + <row> + <entry> + <literal>hibernate.connection.password</literal> + </entry> + <entry> + <emphasis>Senha do usuário do banco de dados</emphasis> (opcional) + </entry> + </row> + </tbody> + </tgroup> + </table> + + <para> + Eis um exemplo de arquivo <literal>hibernate.properties</literal> para + um servidor de aplicação fornecedor de datasources JNDI: + </para> + + <programlisting><![CDATA[hibernate.connection.datasource = java:/comp/env/jdbc/test +hibernate.transaction.factory_class = \ + org.hibernate.transaction.JTATransactionFactory +hibernate.transaction.manager_lookup_class = \ + org.hibernate.transaction.JBossTransactionManagerLookup +hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect]]></programlisting> + + <para> + Conexões JDBC obtidas de um datasource JNDI irão automaticamente irão participar + das transações gerenciadas pelo container no servidor de aplicação. + </para> + + <para> + Arbitrariamente as propriedades de conexão podem ser acrescentandas ao + "<literal>hibernate.connnection</literal>" ao nome da propriedade. Por exemplo, + você deve especificar o <literal>charSet</literal> usando <literal>hibernate.connection.charSet</literal>.t. + </para> + + <para> + Você pode definir sua própria estratégia de plugin para obter conexões JDBC implementando + a interface <literal>org.hibernate.connection.ConnectionProvider</literal>. Você pode + escolher uma implementação customizada setando <literal>hibernate.connection.provider_class</literal>. + </para> + + </sect1> + + <sect1 id="configuration-optional" revision="1"> + <title>Propriedades opcionais de configuração</title> + + <para> + Há um grande número de outras propriedades que controlam o comportamento do Hibernate + em tempo de execução. Todos são opcionais e tem valores default lógicos. + </para> + + <para> + <emphasis>Aviso: algumas destas propriedades são somente a "nível de sistema".</emphasis> + Propriedades nível de sistema podem ser determinados somente via <literal>java -Dproperty=value</literal> + ou <literal>hibernate.properties</literal>. Elas <emphasis>não</emphasis>podem ser + configuradas por outras técnicas descritas abaixo. + </para> + + <table frame="topbot" id="configuration-optional-properties" revision="8"> + <title>Hibernate Configuration Properties</title> + <tgroup cols="2"> + <colspec colname="c1" colwidth="1*"/> + <colspec colname="c2" colwidth="1*"/> + <thead> + <row> + <entry>Nome da Propriedade</entry> + <entry>Propósito</entry> + </row> + </thead> + <tbody> + <row> + <entry> + <literal>hibernate.dialect</literal> + </entry> + <entry> + O nome da classe de um <literal>Dialeto</literal> + que permite o Hibernate gerar SQL otimizado para um banco de + dados relacional em particular. + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>full.classname.of.Dialect</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.show_sql</literal> + </entry> + <entry> + Escreve todas as instruções SQL no console. Esta é uma alternativa + a configurar a categoria de log <literal>org.hibernate.SQL</literal> + para <literal>debug</literal>. + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>true</literal> | <literal>false</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.format_sql</literal> + </entry> + <entry> + Imprime o SQL formatado no log e console. + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>true</literal> | <literal>false</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.default_schema</literal> + </entry> + <entry> + Qualifica no sql gerado, os nome das tabelas sem qualificar + com schena/tablespace dado + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>SCHEMA_NAME</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.default_catalog</literal> + </entry> + <entry> + Qualifica no sql gerado, os nome das tabelas sem qualificar + com catálogo dado + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>CATALOG_NAME</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.session_factory_name</literal> + </entry> + <entry> + O <literal>SessionFactory</literal> irá automaticamente + se ligar a este nome no JNDI depois de ter sido criado. + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>jndi/composite/name</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.max_fetch_depth</literal> + </entry> + <entry> + Estabelece a "profundidade" máxima para árvore outer join fetch + para associações finais únicas(one-to-one,many-to-one). + Um <literal>0</literal> desativa por default a busca outer join. + <para> + <emphasis role="strong">eg.</emphasis> + Valores recomendados entre<literal>0</literal> e <literal>3</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.default_batch_fetch_size</literal> + </entry> + <entry> + Determina um tamanho default para busca de associações em lotes do Hibernate + <para> + <emphasis role="strong">eg.</emphasis> + Valores recomendados <literal>4</literal>, <literal>8</literal>, + <literal>16</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.default_entity_mode</literal> + </entry> + <entry> + Determina um modo default para representação de entidades + para todas as sessões abertas desta <literal>SessionFactory</literal> + <para> + <literal>dynamic-map</literal>, <literal>dom4j</literal>, + <literal>pojo</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.order_updates</literal> + </entry> + <entry> + Força o Hibernate a ordenar os updates SQL pelo valor da chave + primária dos itens a serem atualizados. Isto resultará em menos + deadlocks nas transações em sistemas altamente concorrente. + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>true</literal> | <literal>false</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.generate_statistics</literal> + </entry> + <entry> + If enabled, Hibernate will collect statistics useful for + performance tuning. + Se habilitado, o Hibernate coletará estatísticas úties + para performance tuning dos bancos. + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>true</literal> | <literal>false</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.use_identifer_rollback</literal> + </entry> + <entry> + Se habilitado, propriedades identificadoras geradas + serão zeradas para os valores default quando os + objetos forem apagados. + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>true</literal> | <literal>false</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.use_sql_comments</literal> + </entry> + <entry> + Se ligado, o Hibernate irá gerar comentários dentro do SQL, + para facilitar o debugging, o valor default é <literal>false</literal>. + <para> + <emphasis role="strong">eg.</emphasis> + <literal>true</literal> | <literal>false</literal> + </para> + </entry> + </row> + </tbody> + </tgroup> + </table> + + <table frame="topbot" id="configuration-jdbc-properties" revision="8"> + <title>JDBC Hibernate e Propriedades de Conexão</title> + <tgroup cols="2"> + <colspec colname="c1" colwidth="1*"/> + <colspec colname="c2" colwidth="1*"/> + <thead> + <row> + <entry>Nome da Propriedade</entry> + <entry>Propósito</entry> + </row> + </thead> + <tbody> + <row> + <entry> + <literal>hibernate.jdbc.fetch_size</literal> + </entry> + <entry> + Um valor maior que zero determina o tamanho do fetch + do JDBC( chamadas <literal>Statement.setFetchSize()</literal>). + </entry> + </row> + <row> + <entry> + <literal>hibernate.jdbc.batch_size</literal> + </entry> + <entry> + Um valor maior que zero habilita uso de batch updates JDBC2 pelo Hibernate. + <para> + <emphasis role="strong">Ex.</emphasis> + valores recomentados entre <literal>5</literal> e <literal>30</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.jdbc.batch_versioned_data</literal> + </entry> + <entry> + Sete esta propriedade como <literal>true</literal> se seu driver JDBC retorna + o número correto de linhas no <literal>executeBatch()</literal> ( É usualmente + seguro tornar esta opção ligada). O Hibernate então irá usar betched DML + para automaticamente versionar dados. <literal>false</literal> por default. + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>true</literal> | <literal>false</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.jdbc.factory_class</literal> + </entry> + <entry> + Escolher um <literal>Batcher</literal> customizado. Muitas + aplicações não irão necessitar desta propriedade de configuração + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>classname.of.BatcherFactory</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.jdbc.use_scrollable_resultset</literal> + </entry> + <entry> + Habilita o uso de JDBC2 scrollable resultsets pelo Hibernate. + Essa propriedade somente é necessaria quando se usa Conexeções + JDBC providas pelo usuário, caso contrário o Hibernate os os + metadados da conexão. + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>true</literal> | <literal>false</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.jdbc.use_streams_for_binary</literal> + </entry> + <entry> + Use streams para escrever/ler tipos <literal>binary</literal> + ou <literal>serializable</literal> para/a o JDBC( propriedade a nível de sistema). + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>true</literal> | <literal>false</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.jdbc.use_get_generated_keys</literal> + </entry> + <entry> + Possibilita o uso <literal>PreparedStatement.getGeneratedKeys()</literal> + do JDBC3 para recuperar chaves geradas nativamente depois da inserçãp. + Requer driver JDBC3+ e JRE1.4+, determine para false se seu driver tem + problemas com gerador de indentificadores Hibernate. Por default, tente + determinar o driver capaz de usar metadados da conexão. + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>true|false</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.connection.provider_class</literal> + </entry> + <entry> + O nome da classe de um <literal>ConnectionProvider</literal> personalizado + o qual proverá conexões JDBC para o Hibernate. + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>classname.of.ConnectionProvider</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.connection.isolation</literal> + </entry> + <entry> + Determina o nível de isolamento de uma transação JDBC. + Verifique <literal>java.sql.Connection</literal> para valores + siginificativos mas note que a maior parte dos bancos de dados + não suportam todos os níveis de isolamento. + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>1, 2, 4, 8</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.connection.autocommit</literal> + </entry> + <entry> + Habilita autocommit para conexões no pool JDBC( não recomendado). + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>true</literal> | <literal>false</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.connection.release_mode</literal> + </entry> + <entry> + Especifica quando o Hibernate deve liberar conexões JDBC. Por default, + uma conexão JDBC é retida até a sessão está explicitamente fechada + ou desconectada. Para um datasource JTA do servidor de aplicação, você deve + usar <literal>after_statement</literal> para forçar s liberação da conexões + depois de todas as chamadas JDBC. Para uma conexão não-JTA, freqüentemente + faz sentido liberar a conexão ao fim de cada transação, usando + <literal>after_transaction</literal>. <literal>auto</literal> escolheremos + <literal>after_statement</literal> para as estratégias de transaçãoes JTA e CMT + e <literal>after_transaction</literal> para as estratégias de transação JDBC + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>auto</literal> (default) | <literal>on_close</literal> | + <literal>after_transaction</literal> | <literal>after_statement</literal> + </para> + <para> + Note that this setting only affects <literal>Session</literal>s returned from + <literal>SessionFactory.openSession</literal>. For <literal>Session</literal>s + obtained through <literal>SessionFactory.getCurrentSession</literal>, the + <literal>CurrentSessionContext</literal> implementation configured for use + controls the connection release mode for those <literal>Session</literal>s. + See <xref linkend="architecture-current-session"/> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.connection.<emphasis><propertyName></emphasis></literal> + </entry> + <entry> + Passa a propriedade JDBC <literal>propertyName</literal> + para <literal>DriverManager.getConnection()</literal>. + </entry> + </row> + <row> + <entry> + <literal>hibernate.jndi.<emphasis><propertyName></emphasis></literal> + </entry> + <entry> + Passar a propriedade <literal>propertyName</literal> para + o <literal>InitialContextFactory</literal> JNDI. + </entry> + </row> + </tbody> + </tgroup> + </table> + + <table frame="topbot" id="configuration-cache-properties" revision="7"> + <title>Propriedades de Cachê do Hibernate</title> + <tgroup cols="2"> + <colspec colname="c1" colwidth="1*"/> + <colspec colname="c2" colwidth="1*"/> + <thead> + <row> + <entry>Nome da Propriedade</entry> + <entry>Propósito</entry> + </row> + </thead> + <tbody> + <row> + <entry> + <literal>hibernate.cache.provider_class</literal> + </entry> + <entry> + O nome da classe de um <literal>CacheProvider</literal> customizado. + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>classname.of.CacheProvider</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.cache.use_minimal_puts</literal> + </entry> + <entry> + Otimizar operação de cachê de segundo nível para minimizar escritas, + ao custo de leituras mais frequantes. Esta configuração é mais útil + para cachês clusterizados e, no Hibernate3, é habilitado por default + para implementações de cachê clusterizar. + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>true|false</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.cache.use_query_cache</literal> + </entry> + <entry> + Habilita a cache de consultas, Mesmo assim, consultas individuais ainda tem que ser + habilitadas para o cache. + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>true|false</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.cache.use_second_level_cache</literal> + </entry> + <entry> + Pode ser usada para desabilitar completamente ocache de segundo nível, + o qual está habilitado por default para classes que especificam + um mapeamento <literal><cache></literal>. + + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>true|false</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.cache.query_cache_factory</literal> + </entry> + <entry> + O nome de uma classe que implementa a interface + <literal>QueryCache</literal> personalizada, por + default, um <literal>StandardQueryCache</literal> + criado automaticamente. + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>classname.of.QueryCache</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.cache.region_prefix</literal> + </entry> + <entry> + Um prefixo para usar nos nomes da área especial + do cachê de segundo nível. + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>prefix</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.cache.use_structured_entries</literal> + </entry> + <entry> + Forces Hibernate to store data in the second-level cache + in a more human-friendly format. + Força o Hibernate armazenar dados no cachê se segundo + nível em um formato mais legivel. + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>true|false</literal> + </para> + </entry> + </row> + </tbody> + </tgroup> + </table> + + <table frame="topbot" id="configuration-transaction-properties" revision="9"> + <title>Propriedades de Transação do Hibernate</title> + <tgroup cols="2"> + <colspec colname="c1" colwidth="1*"/> + <colspec colname="c2" colwidth="1*"/> + <thead> + <row> + <entry>Nome da Propriedade</entry> + <entry>Propósito</entry> + </row> + </thead> + <tbody> + <row> + <entry> + <literal>hibernate.transaction.factory_class</literal> + </entry> + <entry> + O nome da clase de um a <literal>TransactionFactory</literal> + para usar com API <literal>Transaction</literal> + ( por default <literal>JDBCTransactionFactory</literal>). + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>classname.of.TransactionFactory</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>jta.UserTransaction</literal> + </entry> + <entry> + Um nome JNDI usado pelo <literal>JTATransactionFactory</literal> + para obter uma <literal>UserTransaction</literal> JTA a partir + do servidor de aplicação. + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>jndi/composite/name</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.transaction.manager_lookup_class</literal> + </entry> + <entry> + O nome da classe de um <literal>TransactionManagerLookup</literal> + – requerido quando caching a nível JVM esta habilitado ou quando + estivermos usando um generator hilo em um ambiente JTA. + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>classname.of.TransactionManagerLookup</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.transaction.flush_before_completion</literal> + </entry> + <entry> + Se habilitado, a sessão será automaticamente limpa antes da fase de + conclusão da transação. É preferivel a gerência interna e + automática do contexto da sessão, veja + <xref linkend="architecture-current-session"/> + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>true</literal> | <literal>false</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.transaction.auto_close_session</literal> + </entry> + <entry> + Se habilitado, a sessão será automaticamente fechada após a fase de + conclusão da transação. É preferivel a gerência interna e + automática do contexto da sessão, veja + <xref linkend="architecture-current-session"/> + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>true</literal> | <literal>false</literal> + </para> + </entry> + </row> + </tbody> + </tgroup> + </table> + + <table frame="topbot" id="configuration-misc-properties" revision="10"> + <title>Propriedades Variadas</title> + <tgroup cols="2"> + <colspec colname="c1" colwidth="1*"/> + <colspec colname="c2" colwidth="1*"/> + <thead> + <row> + <entry>Nome da Propriedade</entry> + <entry>Propósito</entry> + </row> + </thead> + <tbody> + <row> + <entry> + <literal>hibernate.current_session_context_class</literal> + </entry> + <entry> + Forneçe uma estratégia (personalizada) para extensão + da <literal>Session</literal> "corrente". Veja + <xref linkend="architecture-current-session"/> para + mais informação sobre estratégias internas. + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>jta</literal> | <literal>thread</literal> | + <literal>managed</literal> | <literal>custom.Class</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.query.factory_class</literal> + </entry> + <entry> + Escolha a implementação de análise HQL. + <para> + <emphasis role="strong">eg.</emphasis> + <literal>org.hibernate.hql.ast.ASTQueryTranslatorFactory</literal> or + <literal>org.hibernate.hql.classic.ClassicQueryTranslatorFactory</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.query.substitutions</literal> + </entry> + <entry> + Mapeamento a partir de símbolos em consultas HQL para + símbolos SQL( símbolos devem ser funções ou nome literais + , por exemplo). + <para> + <emphasis role="strong">eg.</emphasis> + <literal>hqlLiteral=SQL_LITERAL, hqlFunction=SQLFUNC</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.hbm2ddl.auto</literal> + </entry> + <entry> + Automaticamente valida ou exporta schema DDL para o banco de + dados quando o <literal>SessionFactory</literal> é criads. + Com <literal>create-drop</literal>, o schema do banco de dados + será excluido quando a <literal>create-drop</literal> for + fechada esplicitamente. + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>validate</literal> | <literal>update</literal> | + <literal>create</literal> | <literal>create-drop</literal> + </para> + </entry> + </row> + <row> + <entry> + <literal>hibernate.cglib.use_reflection_optimizer</literal> + </entry> + <entry> + Habilita o uso de CGLIB em vez de reflexão em tempo de execução + ( propriedade a nível de sistema). Reflexão pode algumas vezes ser ú + til quando controlar erros, note que o Hibernate sempre irá requerer a CGLIB + mesmo se você desligar o otimizador. Você não pode determinar esta + propriedade no <literal>hibernate.cfg.xml</literal>. + <para> + <emphasis role="strong">Ex.</emphasis> + <literal>true</literal> | <literal>false</literal> + </para> + </entry> + </row> + </tbody> + </tgroup> + </table> + + <sect2 id="configuration-optional-dialects" revision="1"> + <title>Dialetos SQL</title> + + <para> + Você deve sempre determinar a propriedade <literal>hibernate.dialect</literal> + para a subclasse de <literal>org.hibernate.dialect.Dialect</literal> correta de seu + banco de dados. Se você especificar um dialeto, Hibernate usará defaults lógicos + para qualquer um das outras propriedades listadas abaixo, reduzindo o esforço de + especificá-los manualmente. + </para> + + <table frame="topbot" id="sql-dialects" revision="2"> + <title>Hibernate SQL Dialects (<literal>hibernate.dialect</literal>)</title> + <tgroup cols="2"> + <colspec colwidth="1*"/> + <colspec colwidth="2.5*"/> + <thead> + <row> + <entry>RDBMS</entry> + <entry>Dialect</entry> + </row> + </thead> + <tbody> + <row> + <entry>DB2</entry> <entry><literal>org.hibernate.dialect.DB2Dialect</literal></entry> + </row> + <row> + <entry>DB2 AS/400</entry> <entry><literal>org.hibernate.dialect.DB2400Dialect</literal></entry> + </row> + <row> + <entry>DB2 OS390</entry> <entry><literal>org.hibernate.dialect.DB2390Dialect</literal></entry> + </row> + <row> + <entry>PostgreSQL</entry> <entry><literal>org.hibernate.dialect.PostgreSQLDialect</literal></entry> + </row> + <row> + <entry>MySQL</entry> <entry><literal>org.hibernate.dialect.MySQLDialect</literal></entry> + </row> + <row> + <entry>MySQL with InnoDB</entry> <entry><literal>org.hibernate.dialect.MySQLInnoDBDialect</literal></entry> + </row> + <row> + <entry>MySQL with MyISAM</entry> <entry><literal>org.hibernate.dialect.MySQLMyISAMDialect</literal></entry> + </row> + <row> + <entry>Oracle (any version)</entry> <entry><literal>org.hibernate.dialect.OracleDialect</literal></entry> + </row> + <row> + <entry>Oracle 9i/10g</entry> <entry><literal>org.hibernate.dialect.Oracle9Dialect</literal></entry> + </row> + <row> + <entry>Sybase</entry> <entry><literal>org.hibernate.dialect.SybaseDialect</literal></entry> + </row> + <row> + <entry>Sybase Anywhere</entry> <entry><literal>org.hibernate.dialect.SybaseAnywhereDialect</literal></entry> + </row> + <row> + <entry>Microsoft SQL Server</entry> <entry><literal>org.hibernate.dialect.SQLServerDialect</literal></entry> + </row> + <row> + <entry>SAP DB</entry> <entry><literal>org.hibernate.dialect.SAPDBDialect</literal></entry> + </row> + <row> + <entry>Informix</entry> <entry><literal>org.hibernate.dialect.InformixDialect</literal></entry> + </row> + <row> + <entry>HypersonicSQL</entry> <entry><literal>org.hibernate.dialect.HSQLDialect</literal></entry> + </row> + <row> + <entry>Ingres</entry> <entry><literal>org.hibernate.dialect.IngresDialect</literal></entry> + </row> + <row> + <entry>Progress</entry> <entry><literal>org.hibernate.dialect.ProgressDialect</literal></entry> + </row> + <row> + <entry>Mckoi SQL</entry> <entry><literal>org.hibernate.dialect.MckoiDialect</literal></entry> + </row> + <row> + <entry>Interbase</entry> <entry><literal>org.hibernate.dialect.InterbaseDialect</literal></entry> + </row> + <row> + <entry>Pointbase</entry> <entry><literal>org.hibernate.dialect.PointbaseDialect</literal></entry> + </row> + <row> + <entry>FrontBase</entry> <entry><literal>org.hibernate.dialect.FrontbaseDialect</literal></entry> + </row> + <row> + <entry>Firebird</entry> <entry><literal>org.hibernate.dialect.FirebirdDialect</literal></entry> + </row> + </tbody> + </tgroup> + </table> + + </sect2> + + <sect2 id="configuration-optional-outerjoin" revision="4"> + <title>Recuperação por união externa (Outer Join Fetching)</title> + + <para> + Se seu banco de dados suporta Recuperação por união externa (Outer Join Fetching) no estilo ANSI, + Oracle ou Sybase, A recuperação por união externa (Outer Join Fetching) frequentemente aumentará + o desempenho limitando o número de chamadas (round trips) ao banco de dados( ao custo de + possivelmente mais trabalho desempenhado pelo próprio banco de dados). A recuperação por + união externa (Outer Join Fetching)permite um gráfico completo de objetos conectados + por muitos-para-um, um-para-muitos, muitos-para-muitos e associações um-para-um para ser + recuperadas em um simples instrução SQL SELECT . + + </para> + + <para> + A recuperação por união externa (Outer Join Fetching) pode ser desabilitado + <emphasis>globalmente</emphasis> setando a propriedade + <literal>hibernate.max_fetch_depth</literal> para <literal>0</literal>. + Uma valor 1 ou maior habilita o outer join fetching para associações um-para-um + e muitos-para-umos cujos quais tem sido mapeado com <literal>fetch="join"</literal>. + </para> + + <para> + Veja <xref linkend="performance-fetching"/> para mais informações. + </para> + + </sect2> + + <sect2 id="configuration-optional-binarystreams" revision="1"> + <title>Fluxos Binários (Binary Streams)</title> + + <para> + O Oracle limita o tamanho de arrays de <literal>byte</literal> que pode ser + passado para/de o driver JDBC. Se você desejar usar grandes instâncias de + tipos <literal>binary</literal> ou <literal>serializable</literal>, você + deve habilitar <literal>hibernate.jdbc.use_streams_for_binary</literal>. + <emphasis>Essa é uma configuração que só pode ser feita a nível de sistema.</emphasis> + </para> + + </sect2> + + <sect2 id="configuration-optional-cacheprovider" revision="2"> + <title>Cachê de segundo nível e query</title> + + <para> + As propriedades prefixadas pelo <literal>hibernate.cache</literal> + permite você usar um sistema de cachê de segundo nível + em um processo executado em clustercom Hibernate. + Veja <xref linkend="performance-cache"/> para mais detalhes. + </para> + + </sect2> + + <sect2 id="configuration-optional-querysubstitution"> + <title>Substituições na Linguagem de Consulta</title> + + <para> + Você pode definir novos símbolos de consulta Hibernate usando + <literal>hibernate.query.substitutions</literal>. + Por exemplo: + </para> + + <programlisting>hibernate.query.substitutions true=1, false=0</programlisting> + + <para> + Faria com que os símbolos <literal>true</literal> e <literal>false</literal> + passasem a ser traduzidos para literais inteiro no SQL gerado. + </para> + + <programlisting>hibernate.query.substitutions toLowercase=LOWER</programlisting> + + <para> + permitirá você renomear a função <literal>LOWER</literal> no SQL. + </para> + + </sect2> + + <sect2 id="configuration-optional-statistics" revision="2"> + <title>Estatísticas do Hibernate</title> + + <para> + If you enable <literal>hibernate.generate_statistics</literal>, Hibernate will + expose a number of metrics that are useful when tuning a running system via + <literal>SessionFactory.getStatistics()</literal>. Hibernate can even be configured + to expose these statistics via JMX. Read the Javadoc of the interfaces in + <literal>org.hibernate.stats</literal> for more information. + + Se você habilitar <literal>hibernate.generate_statistics</literal>, o Hibernate + exibirá um número de métricas bastante útil ao ajustar um sistema via + <literal>SessionFactory.getStatistics()</literal>. O Hibernate pode até ser + configurado para exibir essas estatísticas via JMX. Leia o Javadoc da interface + <literal>org.hibernate.stats</literal> para mais informações. + </para> + + </sect2> + </sect1> + + <sect1 id="configuration-logging"> + <title>Logging</title> + + <para> + Hibernate registra vários eventos usando Apache commons-logging. + </para> + + <para> + O serviço commons-logging direcionará a saída para o Apache Log4j + ( se você incluir <literal>log4j.jar</literal>r no seu classpath) ou + JDK1.4 logging( se estiver em uso JDK1.4 ou maior). Você pode fazer o + download do Log4j a partir de <literal>http://jakarta.apache.org</literal>. + Para usar Log4j você necessitará colocar um arquivo + <literal>log4j.properties</literal> no seu classpath, um exemplo de arquivo + de propriedades é distribuído com o Hibernate no diretório + <literal>src/</literal>. + + </para> + + <para> + We strongly recommend that you familiarize yourself with Hibernate's log + messages. A lot of work has been put into making the Hibernate log as + detailed as possible, without making it unreadable. It is an essential + troubleshooting device. The most interesting log categories are the + following: + + Nós recomendamos enfaticamente que você se familiarize-se com mensagens de + log do Hibernate. Uma parte do trabalho tem sido posto em fazer o log + Hibernate tão detalhado quanto possível, sem fazê-lo ilegível. + É um essencial dispositivos de controle de erros. As categorias de log + mais interessantes são as seguintes: + </para> + + <table frame="topbot" id="log-categories" revision="2"> + <title>Categorias de Log do Hibernate</title> + <tgroup cols="2"> + <colspec colwidth="1*"/> + <colspec colwidth="2.5*"/> + <thead> + <row> + <entry>Categoria</entry> + <entry>Função</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>org.hibernate.SQL</literal></entry> + <entry>Registra todas as instruções SQL DML a medida que elas são executadas</entry> + </row> + <row> + <entry><literal>org.hibernate.type</literal></entry> + <entry>Registra todos os parâmetros JDBC</entry> + </row> + <row> + <entry><literal>org.hibernate.tool.hbm2ddl</literal></entry> + <entry>Registra todas as instruções SQL DDL a medida que elas são executadas</entry> + </row> + <row> + <entry><literal>org.hibernate.pretty</literal></entry> + <entry> + Log the state of all entities (max 20 entities) associated + with the session at flush time + Registra o estado de todas as entidades (máximo 20 entidades) + associadas a session no momento da limpeza (flush). + </entry> + </row> + <row> + <entry><literal>org.hibernate.cache</literal></entry> + <entry>Registra todas as atividades de cachê de segundo nível</entry> + </row> + <row> + <entry><literal>org.hibernate.transaction</literal></entry> + <entry>Registra atividades relacionada a transação</entry> + </row> + <row> + <entry><literal>org.hibernate.jdbc</literal></entry> + <entry>Registra todas as requisições de recursos JDBC</entry> + </row> + <row> + <entry><literal>org.hibernate.hql.ast.AST</literal></entry> + <entry> + Registra instruções SQL e HQL durante a análise da consultas + </entry> + </row> + <row> + <entry><literal>org.hibernate.secure</literal></entry> + <entry>Registra todas as requisições de autorização JAAS</entry> + </row> + <row> + <entry><literal>org.hibernate</literal></entry> + <entry> + Registra tudo ( uma parte das informações, mas muito + útil para controle de erros ) + </entry> + </row> + </tbody> + </tgroup> + </table> + + <para> + Quando desenvolver aplicações com Hibernate, você deve quase sempre trabalhar com + debug <literal>debug</literal> para a categoria <literal>org.hibernate.SQL</literal>, + ou, alternativamente, a com a propriedade <literal>hibernate.show_sql</literal> habilitada. + </para> + + + </sect1> + + <sect1 id="configuration-namingstrategy"> + <title>Implementado uma <literal>NamingStrategy</literal></title> + + <para> + A interface <literal>org.hibernate.cfg.NamingStrategy</literal> permite você + especificar um "padrão de nomeação" para objetos do banco de dados e elementos schema. + </para> + + <para> + Você deve criar regras para a geração automaticamente de identificadores + do banco de dados a partir de identificadores Java ou para processar + colunas "computadas" e nomes de tabelas dado o arquivo de mapeamento + para nomes "físicos" de tabelas e colunas. Esta característica ajuda a + reduzir a verbosidade do documento de mapeamento, eliminando interferências + repetitivas( <literal>TBL_</literal>prefixos, por exemplo). A estratégia + default usada pelo Hibernate é completamente mínima. + </para> + + <para> + Você pode especificar uma estratégia diferente ao chamar + <literal>Configuration.setNamingStrategy()</literal> antes de adicionar + os mapeamentos: + </para> + + <programlisting><![CDATA[SessionFactory sf = new Configuration() + .setNamingStrategy(ImprovedNamingStrategy.INSTANCE) + .addFile("Item.hbm.xml") + .addFile("Bid.hbm.xml") + .buildSessionFactory();]]></programlisting> + + <para> + <literal>org.hibernate.cfg.ImprovedNamingStrategy</literal> é uma estratégia + interna que pode ser um ponto de começo útil para algumas aplicações. + </para> + + </sect1> + + <sect1 id="configuration-xmlconfig" revision="2"> + <title>Arquivo de configuração XML</title> + + <para> + Uma maneira alternativa de configuração é especificar uma configuração completa + em um arquivo chamado <literal>hibernate.cfg.xml</literal>. Este arquivo pode + ser usado como um substituto para o arquivo <literal>hibernate.properties</literal> + ou, se ambos estão presentes, sobrescrever propriedades. + </para> + + <para> + The XML configuration file is by default expected to be in the root o + your <literal>CLASSPATH</literal>. Here is an example: + O arquivo XML de configuração é por default esperado para estar na + raiz do seu <literal>CLASSPATH</literal>. Veja um exemplo: + </para> + + <programlisting><![CDATA[<?xml version='1.0' encoding='utf-8'?> +<!DOCTYPE hibernate-configuration PUBLIC + "-//Hibernate/Hibernate Configuration DTD//EN" + "http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd"> + +<hibernate-configuration> + +  + <session-factory + name="java:hibernate/SessionFactory"> + +  + <property name="connection.datasource">java:/comp/env/jdbc/MyDB</property> + <property name="dialect">org.hibernate.dialect.MySQLDialect</property> + <property name="show_sql">false</property> + <property name="transaction.factory_class"> + org.hibernate.transaction.JTATransactionFactory + </property> + <property name="jta.UserTransaction">java:comp/UserTransaction</property> + +  + <mapping resource="org/hibernate/auction/Item.hbm.xml"/> + <mapping resource="org/hibernate/auction/Bid.hbm.xml"/> + +  + <class-cache class="org.hibernate.auction.Item" usage="read-write"/> + <class-cache class="org.hibernate.auction.Bid" usage="read-only"/> + <collection-cache collection="org.hibernate.auction.Item.bids" usage="read-write"/> + + </session-factory> + +</hibernate-configuration>]]></programlisting> + + <para> + Como você pode ver, a vantagem deste enfoque é a externalização dos nomes dos + arquivos de mapeamento para configuração. O <literal>hibernate.cfg.xml</literal> + também é mais conveniente caso você tenha que ajustar o cache do Hibernate. + Note que a escolha é sua em usar <literal>hibernate.properties</literal> ou + <literal>hibernate.cfg.xml</literal>, ambos são equivalente, à exceção dos benefícios + acima mencionados de usar a sintaxe de XML. + </para> + + <para> + Com a configuração do XML, iniciar o Hibernate é então tão simples como + </para> + + <programlisting><![CDATA[SessionFactory sf = new Configuration().configure().buildSessionFactory();]]></programlisting> + + <para> + You can pick a different XML configuration file using + </para> + + <programlisting><![CDATA[SessionFactory sf = new Configuration() + .configure("catdb.cfg.xml") + .buildSessionFactory();]]></programlisting> + + </sect1> + + <sect1 id="configuration-j2ee" revision="1"> + <title>Integração com servidores de aplicação J2EE</title> + + <para> + O Hibernate tem os seguintes pontos da integração para o infraestrutura de J2EE: + </para> + + <itemizedlist> + <listitem> + <para> + <emphasis>DataSources gerenciados pelo container</emphasis>: O Hibernate pode + usar conexões JDBC gerenciadas pelo Container e fornecidas pela JNDI. Geralmente, + um <literal>TransactionManager</literal> compatível com JTA e um + <literal>ResourceManager</literal> cuidam do gerenciamento da transação ( CMT ), + especialmente em transações distribuídas manipuladas através de vários DataSources. + Naturalmente, você também pode demarcar os limites das transações programaticamente (BMT) + ou você poderia querer usar a API opcional do Hibernate <literal>Transaction</literal> + para esta manter seu código portável. + </para> + </listitem> + </itemizedlist> + + <itemizedlist> + <listitem> + <para> + <emphasis>Ligação (binding) automática a JNDI</emphasis>: O Hibernate pode + associar sua <literal>SessionFactory</literal> a JNDI depois de iniciado. + </para> + </listitem> + </itemizedlist> + + <itemizedlist> + <listitem> + <para> + <emphasis>Ligação (binding) Session na JTA:</emphasis> + A <literal>Session</literal> do Hibernate pode automaticamente ser ligada + ao escopo da transações JTA. Simplesmente localizando a <literal>SessionFactory</literal> + da JNDI e obtendo a<literal>Session</literal> corrente. Deixe o Hibernate cuidar + da limpeza e encerramento da <literal>Session</literal> quando as transações JTA + terminarem. A Demarcação de transação pode ser declarativa (CMT) ou + programática(BMT/Transação do usuário). + </para> + </listitem> + </itemizedlist> + + <itemizedlist> + <listitem> + <para> + <emphasis>JMX deployment:</emphasis> Se você usa um JMX servidor de + aplicações capaz (ex. Jboss AS), você pode fazer a instação do Hibernate + como um Mbean controlado. Isto evita ter que iniciar uma linha de + código para construir sua <literal>SessionFactory</literal> de uma + <literal>Configuration</literal>. O container iniciará seu + <literal>HibernateService</literal>, e idealmente também cuidará + das dependências de serviços (DataSources, têm que estar disponíveis + antes do Hibernate iniciar, etc.). + </para> + </listitem> + </itemizedlist> + + <para> + Dependendo em seu ambiente, você poderia ter que ajustar a opção de configuração + <literal>hibernate.connection.aggressive_release</literal> para verdadeiro ( true ), + se seu servidor de aplicações lançar exeções "retenção de conecção". + </para> + + <sect2 id="configuration-optional-transactionstrategy" revision="3"> + <title>Configuração de estratégia de transação</title> + + <para> + A API Hibernate <literal>Session</literal> é independente de qualquer sistema de + demarcação de transação em sua arquitetura. Se você deixar o Hibernate usar + a JDBC diretamente, através de um pool de conexões, você pode inicializar e + encerrar suas transações chamando a API JDBC. Se você rodar em um servidor de + aplicações J2EE, você poderá usar transações controladas por beans e chamar + a API JTA e <literal>UserTransaction</literal> quando necessário. + + </para> + + <para> + Para manter seu código portável entre estes dois ( e outros ) ambientes, recomendamos + a API Hibernate <literal>Transaction</literal>, que envolve e esconde o sistema subjacente. + Você tem que especificar um classe construtora para <literal>Transaction</literal> instanciar + ajustando a propriedade de configuração do <literal>hibernate.transaction.factory_class</literal>. + + </para> + + <para> + Existem três escolhas (internas) padrões: + </para> + + <variablelist spacing="compact"> + <varlistentry> + <term><literal>org.hibernate.transaction.JDBCTransactionFactory</literal></term> + <listitem> + <para>delegada as transações (JDBC)a bases de dados (Padrão)</para> + + </listitem> + </varlistentry> + <varlistentry> + <term><literal>org.hibernate.transaction.JTATransactionFactory</literal></term> + <listitem> + <para> + delegada a transação a um container gerenciador se a transação + existente estiver de acordo neste contexto (ex: método bean sessão EJB), + se não uma nova transação é iniciada e uma transação controlado por + um bean é usada. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>org.hibernate.transaction.CMTTransactionFactory</literal></term> + <listitem> + <para>delega para um container gerenciador de transações JTA</para> + </listitem> + </varlistentry> + </variablelist> + + <para> + Você também pode definir suas próprias estratégias de transação ( para um serviço de + transação CORBA por exemplo). + </para> + + <para> + Algumas características no Hibernate (ex., o cache de segundo nível, sessões contextuais + com JTA, etc.) requerem acesso a JTA <literal>TransactionManager</literal> em um ambiente + controlado. Em um servidor de aplicação você tem que especificar como o Hibernate pode + obter uma referência para a <literal>TransactionManager</literal>, pois o J2EE não + padronize um mecanismo simples : + </para> + + <table frame="topbot" id="jtamanagerlookup" revision="1"> + <title>Gerenciadores de transações JTA</title> + <tgroup cols="2"> + <colspec colwidth="2.5*"/> + <colspec colwidth="1*"/> + <thead> + <row> + <entry>Transaction Factory</entry> + <entry align="center">Application Server</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>org.hibernate.transaction.JBossTransactionManagerLookup</literal></entry> + <entry align="center">JBoss</entry> + </row> + <row> + <entry><literal>org.hibernate.transaction.WeblogicTransactionManagerLookup</literal></entry> + <entry align="center">Weblogic</entry> + </row> + <row> + <entry><literal>org.hibernate.transaction.WebSphereTransactionManagerLookup</literal></entry> + <entry align="center">WebSphere</entry> + </row> + <row> + <entry><literal>org.hibernate.transaction.WebSphereExtendedJTATransactionLookup</literal></entry> + <entry align="center">WebSphere 6</entry> + </row> + <row> + <entry><literal>org.hibernate.transaction.OrionTransactionManagerLookup</literal></entry> + <entry align="center">Orion</entry> + </row> + <row> + <entry><literal>org.hibernate.transaction.ResinTransactionManagerLookup</literal></entry> + <entry align="center">Resin</entry> + </row> + <row> + <entry><literal>org.hibernate.transaction.JOTMTransactionManagerLookup</literal></entry> + <entry align="center">JOTM</entry> + </row> + <row> + <entry><literal>org.hibernate.transaction.JOnASTransactionManagerLookup</literal></entry> + <entry align="center">JOnAS</entry> + </row> + <row> + <entry><literal>org.hibernate.transaction.JRun4TransactionManagerLookup</literal></entry> + <entry align="center">JRun4</entry> + </row> + <row> + <entry><literal>org.hibernate.transaction.BESTransactionManagerLookup</literal></entry> + <entry align="center">Borland ES</entry> + </row> + </tbody> + </tgroup> + </table> + + </sect2> + + <sect2 id="configuration-optional-jndi" revision="3"> + <title><literal>SessionFactory</literal> ligada a JNDI</title> + + <para> + Uma <literal>SessionFactory</literal> de Hibernate ligada a JNDI pode simplificar + a localização da fabrica e a criação de novas <literal>Session</literal>s. + Observe que isto não relacionado a um <literal>Datasource</literal> ligado + a JNDI, simplemente ambos usam o mesmo registro! + </para> + + <para> + If you wish to have the <literal>SessionFactory</literal> bound to a JNDI namespace, specify + a name (eg. <literal>java:hibernate/SessionFactory</literal>) using the property + <literal>hibernate.session_factory_name</literal>. If this property is omitted, the + <literal>SessionFactory</literal> will not be bound to JNDI. (This is especially useful in + environments with a read-only JNDI default implementation, e.g. Tomcat.) + </para> + + <para> + When binding the <literal>SessionFactory</literal> to JNDI, Hibernate will use the values of + <literal>hibernate.jndi.url</literal>, <literal>hibernate.jndi.class</literal> to instantiate + an initial context. If they are not specified, the default <literal>InitialContext</literal> + will be used. + </para> + + <para> + Hibernate will automatically place the <literal>SessionFactory</literal> in JNDI after + you call <literal>cfg.buildSessionFactory()</literal>. This means you will at least have + this call in some startup code (or utility class) in your application, unless you use + JMX deployment with the <literal>HibernateService</literal> (discussed later). + </para> + + <para> + If you use a JNDI <literal>SessionFactory</literal>, an EJB or any other class may + obtain the <literal>SessionFactory</literal> using a JNDI lookup. + </para> + + <para> + We recommend that you bind the <literal>SessionFactory</literal> to JNDI in + a managend environment and use a <literal>static</literal> singleton otherwise. + To shield your application code from these details, we also recommend to hide the + actual lookup code for a <literal>SessionFactory</literal> in a helper class, + such as <literal>HibernateUtil.getSessionFactory()</literal>. Note that such a + class is also a convenient way to startup Hibernate—see chapter 1. + </para> + + </sect2> + + <sect2 id="configuration-j2ee-currentsession" revision="4"> + <title>Current Session context management with JTA</title> + + <para> + The easiest way to handle <literal>Session</literal>s and transactions is + Hibernates automatic "current" <literal>Session</literal> management. + See the discussion of <xref linkend="architecture-current-session">current sessions</xref>. + Using the <literal>"jta"</literal> session context, if there is no Hibernate + <literal>Session</literal> associated with the current JTA transaction, one will + be started and associated with that JTA transaction the first time you call + <literal>sessionFactory.getCurrentSession()</literal>. The <literal>Session</literal>s + retrieved via <literal>getCurrentSession()</literal> in <literal>"jta"</literal> context + will be set to automatically flush before the transaction completes, close + after the transaction completes, and aggressively release JDBC connections + after each statement. This allows the <literal>Session</literal>s to + be managed by the life cycle of the JTA transaction to which it is associated, + keeping user code clean of such management concerns. Your code can either use + JTA programmatically through <literal>UserTransaction</literal>, or (recommended + for portable code) use the Hibernate <literal>Transaction</literal> API to set + transaction boundaries. If you run in an EJB container, declarative transaction + demarcation with CMT is preferred. + </para> + + </sect2> + + <sect2 id="configuration-j2ee-jmx" revision="1"> + <title>JMX deployment</title> + + <para> + The line <literal>cfg.buildSessionFactory()</literal> still has to be executed + somewhere to get a <literal>SessionFactory</literal> into JNDI. You can do this + either in a <literal>static</literal> initializer block (like the one in + <literal>HibernateUtil</literal>) or you deploy Hibernate as a <emphasis>managed + service</emphasis>. + </para> + + <para> + Hibernate is distributed with <literal>org.hibernate.jmx.HibernateService</literal> + for deployment on an application server with JMX capabilities, such as JBoss AS. + The actual deployment and configuration is vendor specific. Here is an example + <literal>jboss-service.xml</literal> for JBoss 4.0.x: + </para> + + <programlisting><![CDATA[<?xml version="1.0"?> +<server> + +<mbean code="org.hibernate.jmx.HibernateService" + name="jboss.jca:service=HibernateFactory,name=HibernateFactory"> + +  + <depends>jboss.jca:service=RARDeployer</depends> + <depends>jboss.jca:service=LocalTxCM,name=HsqlDS</depends> + +  + <attribute name="JndiName">java:/hibernate/SessionFactory</attribute> + +  + <attribute name="Datasource">java:HsqlDS</attribute> + <attribute name="Dialect">org.hibernate.dialect.HSQLDialect</attribute> + +  + <attribute name="TransactionStrategy"> + org.hibernate.transaction.JTATransactionFactory</attribute> + <attribute name="TransactionManagerLookupStrategy"> + org.hibernate.transaction.JBossTransactionManagerLookup</attribute> + <attribute name="FlushBeforeCompletionEnabled">true</attribute> + <attribute name="AutoCloseSessionEnabled">true</attribute> + +  + <attribute name="MaximumFetchDepth">5</attribute> + +  + <attribute name="SecondLevelCacheEnabled">true</attribute> + <attribute name="CacheProviderClass">org.hibernate.cache.EhCacheProvider</attribute> + <attribute name="QueryCacheEnabled">true</attribute> + +  + <attribute name="ShowSqlEnabled">true</attribute> + +  + <attribute name="MapResources">auction/Item.hbm.xml,auction/Category.hbm.xml</attribute> + +</mbean> + +</server>]]></programlisting> + + <para> + This file is deployed in a directory called <literal>META-INF</literal> and packaged + in a JAR file with the extension <literal>.sar</literal> (service archive). You also need + to package Hibernate, its required third-party libraries, your compiled persistent classes, + as well as your mapping files in the same archive. Your enterprise beans (usually session + beans) may be kept in their own JAR file, but you may include this EJB JAR file in the + main service archive to get a single (hot-)deployable unit. Consult the JBoss AS + documentation for more information about JMX service and EJB deployment. + </para> + + </sect2> + + </sect1> + +</chapter> + Modified: core/trunk/documentation/manual/pt-BR/src/main/docbook/content/events.xml =================================================================== --- core/trunk/documentation/manual/pt-BR/src/main/docbook/content/events.xml 2007-10-26 00:46:38 UTC (rev 14135) +++ core/trunk/documentation/manual/pt-BR/src/main/docbook/content/events.xml 2007-10-26 00:48:48 UTC (rev 14136) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="events"> +<chapter id="events"> <title>Interceptadores e Eventos</title> <para> Modified: core/trunk/documentation/manual/pt-BR/src/main/docbook/content/example_mappings.xml =================================================================== --- core/trunk/documentation/manual/pt-BR/src/main/docbook/content/example_mappings.xml 2007-10-26 00:46:38 UTC (rev 14135) +++ core/trunk/documentation/manual/pt-BR/src/main/docbook/content/example_mappings.xml 2007-10-26 00:48:48 UTC (rev 14136) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="example-mappings"> +<chapter id="example-mappings"> <title>Exemplo: Vários Mapeamentos</title> <para> Modified: core/trunk/documentation/manual/pt-BR/src/main/docbook/content/example_parentchild.xml =================================================================== --- core/trunk/documentation/manual/pt-BR/src/main/docbook/content/example_parentchild.xml 2007-10-26 00:46:38 UTC (rev 14135) +++ core/trunk/documentation/manual/pt-BR/src/main/docbook/content/example_parentchild.xml 2007-10-26 00:48:48 UTC (rev 14136) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="example-parentchild"> +<chapter id="example-parentchild"> <title>Example: Parent/Child</title> <para> Modified: core/trunk/documentation/manual/pt-BR/src/main/docbook/content/example_weblog.xml =================================================================== --- core/trunk/documentation/manual/pt-BR/src/main/docbook/content/example_weblog.xml 2007-10-26 00:46:38 UTC (rev 14135) +++ core/trunk/documentation/manual/pt-BR/src/main/docbook/content/example_weblog.xml 2007-10-26 00:48:48 UTC (rev 14136) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="example-weblog"> +<chapter id="example-weblog"> <title>Example: Weblog Application</title> <sect1 id="example-weblog-classes"> Modified: core/trunk/documentation/manual/pt-BR/src/main/docbook/content/filters.xml =================================================================== --- core/trunk/documentation/manual/pt-BR/src/main/docbook/content/filters.xml 2007-10-26 00:46:38 UTC (rev 14135) +++ core/trunk/documentation/manual/pt-BR/src/main/docbook/content/filters.xml 2007-10-26 00:48:48 UTC (rev 14136) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="filters"> +<chapter id="filters"> <title>Filtrando dados</title> <para> Modified: core/trunk/documentation/manual/pt-BR/src/main/docbook/content/inheritance_mapping.xml =================================================================== --- core/trunk/documentation/manual/pt-BR/src/main/docbook/content/inheritance_mapping.xml 2007-10-26 00:46:38 UTC (rev 14135) +++ core/trunk/documentation/manual/pt-BR/src/main/docbook/content/inheritance_mapping.xml 2007-10-26 00:48:48 UTC (rev 14136) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="inheritance"> +<chapter id="inheritance"> <title>Mapeamento de Herança</title> <sect1 id="inheritance-strategies" revision="3"> Modified: core/trunk/documentation/manual/pt-BR/src/main/docbook/content/performance.xml =================================================================== --- core/trunk/documentation/manual/pt-BR/src/main/docbook/content/performance.xml 2007-10-26 00:46:38 UTC (rev 14135) +++ core/trunk/documentation/manual/pt-BR/src/main/docbook/content/performance.xml 2007-10-26 00:48:48 UTC (rev 14136) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="performance"> +<chapter id="performance"> <title>Aumentando a performance</title> <sect1 id="performance-fetching" revision="2"> Modified: core/trunk/documentation/manual/pt-BR/src/main/docbook/content/persistent_classes.xml =================================================================== --- core/trunk/documentation/manual/pt-BR/src/main/docbook/content/persistent_classes.xml 2007-10-26 00:46:38 UTC (rev 14135) +++ core/trunk/documentation/manual/pt-BR/src/main/docbook/content/persistent_classes.xml 2007-10-26 00:48:48 UTC (rev 14136) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="persistent-classes" revision="2"> +<chapter id="persistent-classes" revision="2"> <title>Persistent Classes</title> <para> Modified: core/trunk/documentation/manual/pt-BR/src/main/docbook/content/preface.xml =================================================================== --- core/trunk/documentation/manual/pt-BR/src/main/docbook/content/preface.xml 2007-10-26 00:46:38 UTC (rev 14135) +++ core/trunk/documentation/manual/pt-BR/src/main/docbook/content/preface.xml 2007-10-26 00:48:48 UTC (rev 14136) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<preface id="preface" revision="2"> +<preface id="preface" revision="2"> <title>Prefácio</title> <para> Modified: core/trunk/documentation/manual/pt-BR/src/main/docbook/content/query_criteria.xml =================================================================== --- core/trunk/documentation/manual/pt-BR/src/main/docbook/content/query_criteria.xml 2007-10-26 00:46:38 UTC (rev 14135) +++ core/trunk/documentation/manual/pt-BR/src/main/docbook/content/query_criteria.xml 2007-10-26 00:48:48 UTC (rev 14136) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="querycriteria"> +<chapter id="querycriteria"> <title>Consultas por critérios</title> <para> Modified: core/trunk/documentation/manual/pt-BR/src/main/docbook/content/query_hql.xml =================================================================== --- core/trunk/documentation/manual/pt-BR/src/main/docbook/content/query_hql.xml 2007-10-26 00:46:38 UTC (rev 14135) +++ core/trunk/documentation/manual/pt-BR/src/main/docbook/content/query_hql.xml 2007-10-26 00:48:48 UTC (rev 14136) @@ -1,1163 +1,1174 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="queryhql"> - <title>HQL: A linguagem de Queries do Hibernate</title> - - <para> - O Hibernate vem com uma poderosa linguagem que é (intencionalmente) muito parecida - com o SQL. Mas não seja enganado pela sintaxe; a HQL é totalmente orientada à objetos, - requer conhecimentos de herança, polimorfismo e associações. - </para> - - <sect1 id="queryhql-casesensitivity"> - <title>Case Sensitíve</title> - - <para> - As Queries não são case-sensitive, exceto pelo nomes das classes e propriedades Java. - <literal>sELEct</literal> e o mesmo que - <literal>SELECT</literal> mas - <literal>org.hibernate.eg.FOO</literal> não é - <literal>org.hibernate.eg.Foo</literal> e - <literal>foo.barSet</literal> não é - <literal>foo.BARSET</literal>. - - </para> - - <para> - Esse manual usa as palavras chave HQL em letras minúsculas. Alguns usuários acham que - com letras maiúsculas as queries ficam mais legíveis, mas nós achamos essa convenção feia - dentro do código Java. - </para> - - </sect1> - - <sect1 id="queryhql-from"> - <title>A clausula from</title> - - <para> - A mais simples query possível do Hibernate é a assim: - </para> - - <programlisting><![CDATA[from eg.Cat]]></programlisting> - - <para> - Ela irá retornar todas as instancias da classe <literal>eg.Cat</literal>. - Necessariamente não precisamos qualificar o nome da classe, pois é realizado - <literal>auto-import</literal> por padrão. Por isso na maior parte do tempos - nós simplesmente escrevemos: - </para> - - <programlisting><![CDATA[from Cat]]></programlisting> - - <para> - Na maior parte do tempo, você precisará atribuir um <emphasis>alias</emphasis>, - desde que você queira se referia ao <literal>Cat</literal> em outras partes da - query. - </para> - - <programlisting><![CDATA[from Cat as cat]]></programlisting> - - <para> - Essa query atribui um alias a <literal>cat</literal> para as instancias de - <literal>Cat</literal>, então nós podemos usar esse alias depois na query. - A palavra chave as é opcional; poderíamos escrever assim: - </para> - - <programlisting><![CDATA[from Cat cat]]></programlisting> - - <para> - Múltiplas classes pode ser envolvidas, resultando em um produto cartesiano ou "cross" join. - </para> - - <programlisting><![CDATA[from Formula, Parameter]]></programlisting> - <programlisting><![CDATA[from Formula as form, Parameter as param]]></programlisting> - - <para> - É considerada uma boa prática os nomes dos aliases começarem com letra minúscula, - aderente com os padrões Java para variáveis locais (ex: <literal>domesticCat</literal>). - </para> - - </sect1> - - <sect1 id="queryhql-joins" revision="2"> - <title>Associações e joins</title> - - <para> - Nós também podemos querer atribuir aliases em uma entidade associada, ou mesmo - em elementos de uma coleção de valores, usando um <literal>join</literal>. - </para> - - <programlisting><![CDATA[from Cat as cat - inner join cat.mate as mate - left outer join cat.kittens as kitten]]></programlisting> - - <programlisting><![CDATA[from Cat as cat left join cat.mate.kittens as kittens]]></programlisting> - - <programlisting><![CDATA[from Formula form full join form.parameter param]]></programlisting> - - <para> - Os tipos de joins suportados foram inspirados no SQL ANSI: - </para> - - <itemizedlist spacing="compact"> - <listitem> - <para> - <literal>inner join</literal> - </para> - </listitem> - <listitem> - <para> - <literal>left outer join</literal> - </para> - </listitem> - <listitem> - <para> - <literal>right outer join</literal> - </para> - </listitem> - <listitem> - <para> - <literal>full join</literal> (geralmente não é útil) - </para> - </listitem> - </itemizedlist> - - <para> - The <literal>inner join</literal>, <literal>left outer join</literal> and - <literal>right outer join</literal> constructs may be abbreviated. - As construções <literal>inner join</literal>, <literal>left outer join</literal> e - <literal>right outer join</literal> podem ser abreviadas. - </para> - - <programlisting><![CDATA[from Cat as cat - join cat.mate as mate - left join cat.kittens as kitten]]></programlisting> - - <para> - Você pode fornecer condições extras de join usando a palavra - chave do HQL <literal>with</literal>. - </para> - - <programlisting><![CDATA[from Cat as cat - left join cat.kittens as kitten - <literal>with</literal> kitten.bodyWeight > 10.0]]></programlisting> - - <para> - Adicionalmente, um "fetch" join permite que associações ou coleções de valores - sejam inicializadas junto com o objeto pai, usando apenas um select. Isso é - muito útil no caso das coleções. Isso efetivamente sobre escreve as declarações - outer join e lazy do arquivo mapeamento para associações e coleções. - Veja a seção <xref linkend="performance-fetching"/> para mais informações. - </para> - - <programlisting><![CDATA[from Cat as cat - inner join <literal>fetch</literal>cat.mate - left join <literal>fetch</literal>cat.kittens]]></programlisting> - - <para> - Usualmente, um <literal>fetch</literal>join não precisa atribuir um alias, pois o objeto associado não - deve ser usado na clausula <literal>where</literal> (ou em qualquer outra clausula). - Também, os objetos associados não são retornados diretamente nos resultados da query. - Ao invés disso, eles devem ser acessados usando o objeto pai. A única razão que nós - podemos necessitar de um alias é quando fazemos um fech join recursivamente em uma - coleção adicional: - </para> - - <programlisting><![CDATA[from Cat as cat - inner join <literal>fetch</literal>cat.mate - left join <literal>fetch</literal>cat.kittens child - left join <literal>fetch</literal>child.kittens]]></programlisting> - - <para> - Observe que a construção <literal>fetch</literal> não deve ser usada em queries invocadas usando - <literal>iterate()</literal> (embora possa ser usado com <literal>scroll()</literal>). O - <literal>fetch</literal> também não deve ser usado junto com o <literal>setMaxResults()</literal> ou - <literal>setFirstResult()</literal> pois essas operações são baseadas nas linhas retornadas, que - normalmente contem duplicidade devido ao fetching das coleções, então o número de linhas pode não - ser o que você espera. - - O <literal>fetch</literal> não deve ser usado junto com uma condição <literal>with</literal> em - uma condição <literal>with</literal> ad hoc. É possível que seja criado um produto cartesiano pelo - join fetching em mais do que uma coleção em uma query, então tome cuidado nesses casos. Um join - fetching em varias coleções pode trazer resultados inesperados para mapeamentos do tipo bag, tome - cuidado na hora de formular queries como essas. Finalmente, observe o seguinte, o - <literal>full join fetch</literal> e <literal>right join fetch</literal> não são significativos. - </para> - - <para> - - Se está usando o nível de propriedade lazy (<literal>com</literal> instrumentação de bytecode), é possível - forçar o Hibernate a <literal>buscar</literal> as propriedades lazy imediatamente (na primeira query), - usando <literal>fetch all properties </literal>. - </para> - - <programlisting><![CDATA[from Document <literal>fetch</literal>all properties order by name]]></programlisting> - <programlisting><![CDATA[from Document doc <literal>fetch</literal>all properties where lower(doc.name) like '%cats%']]></programlisting> - - </sect1> - - <sect1 id="queryhql-joins-forms"> - <title>Formas e sintaxe de joins</title> - - <para> - O HQL suporta duas formas de associação para união: <literal>implícita</literal> e <literal>explicita</literal>. - </para> - - <para> - As queries apresentadas na seção anterior usam a forma <literal>explicita</literal>, onde a - palavra chave "join" é explicitamente usada na clausula "from". Essa é a forma recomendada. - </para> - - <para> - A forma <literal>implícita</literal> não usa a palavra chave "join". Entretanto, as associações - são diferenciadas usando pontuação ("." - dotnation). Uniões implícitas podem aparecer em - qualquer das clausulas HQL. A união <literal>implícita</literal> resulta em declarações - SQL que contem inner joins. - </para> - - <programlisting><![CDATA[from Cat as cat where cat.mate.name like '%s%']]></programlisting> - </sect1> - - <sect1 id="queryhql-select"> - <title>Clausula select</title> - - <para> - A clausula <literal>select</literal> seleciona quais obetos e propriedades retornam - no resultado da query. Considere: - </para> - - <programlisting><![CDATA[select mate -from Cat as cat - inner join cat.mate as mate]]></programlisting> - - <para> - A query selecionará <literal>mate</literal>s (companheiros), de outros <literal>Cat</literal>s. - Atualmente, podemos expressar a query de forma mais compacta como: - </para> - - <programlisting><![CDATA[select cat.mate from Cat cat]]></programlisting> - - <para> - Queries podem retornar propriedades de qualquer tipo de valor, incluindo propriedades de tipo de componente: - - </para> - - <programlisting><![CDATA[select cat.name from DomesticCat cat -where cat.name like 'fri%']]></programlisting> - - <programlisting><![CDATA[select cust.name.firstName from Customer as cust]]></programlisting> - - <para> - Queries podem retornar múltiplos objetos e/ou propriedades como um array do - tipo Object[], - </para> - - <programlisting><![CDATA[select mother, offspr, mate.name -from DomesticCat as mother - inner join mother.mate as mate - left outer join mother.kittens as offspr]]></programlisting> - - <para> - ou como um <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> - ou como um objeto Java 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> - assumindo que a classe <literal>Family</literal> tenha um construtor apropriado. - </para> - - <para> - Pode-se designar referencias a expressões selecionadas, <literal>as</literal>: - </para> - - <programlisting><![CDATA[select max(bodyWeight) as max, min(bodyWeight) as min, count(*) as n -from Cat cat]]></programlisting> - - <para> - Isto é bem mais útil quando usado junto <literal>com</literal> <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> - Esta query retorna um <literal>Map</literal> de referencias para valores selecionados. - </para> - - </sect1> - - <sect1 id="queryhql-aggregation"> - <title>Funções de agregação</title> - - <para> - As queries HQL podem retornar o resultado de funções agregadas nas propriedades. - </para> - - <programlisting><![CDATA[select avg(cat.weight), sum(cat.weight), max(cat.weight), count(cat) -from Cat cat]]></programlisting> - - - - <para> - As funções agregadas suportadas são: - </para> - - <itemizedlist spacing="compact"> - <listitem> - <para> - <literal>avg(...), sum(...), min(...), max(...)</literal> - </para> - </listitem> - <listitem> - <para> - <literal>count(*)</literal> - </para> - </listitem> - <listitem> - <para> - <literal>count(...), count(distinct ...), count(all...)</literal> - </para> - </listitem> - </itemizedlist> - - <para> - Pode-se usar operadores aritiméticos, concatenação e funções SQL - reconhecidas na clausula select: - </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> - As palavras <literal>distinct</literal> e <literal>all</literal> podem ser usadas e têm - a mesma semântica como no SQL. - </para> - - <programlisting><![CDATA[select distinct cat.name from Cat cat - -select count(distinct cat.name), count(cat) from Cat cat]]></programlisting> - - </sect1> - - <sect1 id="queryhql-polymorphism"> - <title>Queries polimórficas</title> - - <para> - A query: - </para> - - <programlisting><![CDATA[from Cat as cat]]></programlisting> - - <para> - retorna instancias não só de <literal>Cat</literal>, mas também de subclasses como - <literal>DomesticCat</literal>. As queries do Hibernate podem nomear qualquer classe Java - ou interface na clausula <literal>from</literal>. A query retornará instancias de toda classe - persistente que extenda a determinada classe ou implemente a determinada interface. A query - , a seguir, pode retornar todo objeto persistente: - </para> - - <programlisting><![CDATA[from java.lang.Object o]]></programlisting> - - <para> - A interface <literal>Named</literal> pode ser implementada por várias classes persistentes: - </para> - - <programlisting><![CDATA[from Named n, Named m where n.name = m.name]]></programlisting> - - <para> - Note que as duas últimas queries requerem mais de um SQL SELECT . Isto significa que a clausula - <literal>order by</literal> não ordena corretamente todo o resultado. (Isso também significa que - você não pode chamar essas queries usando <literal>Query.scroll()</literal>.) - </para> - - </sect1> - - <sect1 id="queryhql-where"> - <title>A clausula where</title> - - <para> - A clausula <literal>where</literal> permite estreitar a lista de instancias retornada. - Se não houver referencia alguma, pode-se referir a propriedades pelo nome: - </para> - - <programlisting><![CDATA[from Cat where name='Fritz']]></programlisting> - - <para> - Se houver uma referência, use o nome da propriedade qualificada: - </para> - - <programlisting><![CDATA[from Cat as cat where cat.name='Fritz']]></programlisting> - - <para> - retorna instancias de <literal>Cat</literal> com nome ‘Fritz’. - </para> - - <programlisting><![CDATA[select foo -from Foo foo, Bar bar -where foo.startDate = bar.date]]></programlisting> - - <para> - retornará todas as instancias de <literal>Foo</literal>, para cada - um que tiver uma instancia de <literal>bar</literal> com a propriedade - <literal>date</literal> igual a propriedade - <literal>startDate</literal> de - <literal>Foo</literal>. Expressões de filtro compostas fazem da - clausula <literal>where</literal>, extremamente poderosa. Consideremos: - </para> - - <programlisting><![CDATA[from Cat cat where cat.mate.name is not null]]></programlisting> - - <para> - Esta query traduzida para uma query SQL <literal>com</literal> uma tabela (inner) join. Se fosse - escrever algo como: - </para> - - <programlisting><![CDATA[from Foo foo -where foo.bar.baz.customer.address.city is not null]]></programlisting> - - <para> - Poderia-se terminar <literal>com</literal> uma query que necessitasse de join de quatro tabelas, - no SQL. - </para> - - <para> - O operador <literal>=</literal> pode ser uasdo para comparar não apenas propriedades, - mas também instancias: - </para> - - <programlisting><![CDATA[from Cat cat, Cat rival where cat.mate = rival.mate]]></programlisting> - - <programlisting><![CDATA[select cat, mate -from Cat cat, Cat mate -where cat.mate = mate]]></programlisting> - - <para> - A propriedade especial (lowercase) <literal>id</literal> pode ser usada para referenciar - o identificador único de um objeto. (Pode-se usar também o nome de sua propriedade) - </para> - - <programlisting><![CDATA[from Cat as cat where cat.id = 123 - -from Cat as cat where cat.mate.id = 69]]></programlisting> - - <para> - A Segunda query é eficiente. Nenhuma união de tabelas é necessária! - </para> - - <para> - As propriedades de identificadores compostas também podem ser usadas. Suponha que - <literal>Person</literal> tenha um identificador composto que consiste de - <literal>country</literal> e <literal>medicareNumber</literal>. - </para> - - <programlisting><![CDATA[from bank.Person person -where person.id.country = 'AU' - and person.id.medicareNumber = 123456]]></programlisting> - - <programlisting><![CDATA[from bank.Account account -where account.owner.id.country = 'AU' - and account.owner.id.medicareNumber = 123456]]></programlisting> - - <para> - Mais uma vez, a Segunda query não precisa de nenhum join de tabela. - </para> - - <para> - Assim mesmo, a propriedade especial <literal>class</literal> acessa o valor discriminador da - instancia, no caso de persistência polimórfica. O nome de uma classe Java inclusa em uma - clausula "where", será traduzida para seu valor descriminante. - </para> - - <programlisting><![CDATA[from Cat cat where cat.class = DomesticCat]]></programlisting> - - <para> - Pode-se também especificar as propriedades dos components ou tipos de usuário composto - (e de componentes de componentes). Nunca tente usar uma expressão de filtro que termine na propriedade - de um tipo de componente (ao contrário de uma propriedade de um componente). Por exemplo, - se store.owner é uma entidade <literal>com</literal> um componente <literal>address</literal>. - </para> - - <programlisting><![CDATA[store.owner.address.city // okay -store.owner.address // error!]]></programlisting> - - <para> - Um tipo "any" tem as propriedades <literal>id</literal> e <literal>class</literal> especiais, - nôs permitindo expressar um join da seguinte forma (onde <literal>AuditLog.item</literal> é - uma propriedade mapeada <literal>com</literal> <literal><any></literal>) - </para> - - <programlisting><![CDATA[from AuditLog log, Payment payment -where log.item.class = 'Payment' and log.item.id = payment.id]]></programlisting> - - <para> - Veja que <literal>log.item.class</literal> e <literal>payment.class</literal> podem - referir-se a valores de colunas de banco de dados completamente diferentes, na query acima. - </para> - - </sect1> - - <sect1 id="queryhql-expressions"> - <title>Expressões</title> - - <para> - As expressões permitidas na cláusula <literal>where</literal> inclui a maioria - das coisas que você poderia escrever no SQL: - </para> - - <itemizedlist spacing="compact"> - <listitem> - <para> - operadores matemáticos <literal>+, -, *, /</literal> - </para> - </listitem> - <listitem> - <para> - operadores de comparação binários <literal>=, >=, <=, <>, !=, like</literal> - </para> - </listitem> - <listitem> - <para> - operadores lógicos <literal>and, or, not</literal> - </para> - </listitem> - <listitem> - <para> - parenteses <literal>( )</literal>, indicating grouping - </para> - </listitem> - <listitem> - <para> - <literal>in</literal>, - <literal>not in</literal>, - <literal>between</literal>, - <literal>is null</literal>, - <literal>is not null</literal>, - <literal>is empty</literal>, - <literal>is not empty</literal>, - <literal>member of</literal> and - <literal>not member of</literal> - </para> - </listitem> - <listitem> - <para> - case "simples" , <literal>case ... when ... then ... else ... end</literal>, and - "searched" case, <literal>case when ... then ... else ... end</literal> - </para> - </listitem> - <listitem> - <para> - concatenação de string <literal>...||...</literal> ou <literal>concat(...,...)</literal> - </para> - </listitem> - <listitem> - <para> - <literal>current_date()</literal>, <literal>current_time()</literal>, - <literal>current_timestamp()</literal> - </para> - </listitem> - <listitem> - <para> - <literal>second(...)</literal>, <literal>minute(...)</literal>, - <literal>hour(...)</literal>, <literal>day(...)</literal>, - <literal>month(...)</literal>, <literal>year(...)</literal>, - </para> - </listitem> - <listitem> - <para> - qualquer funcao ou operador definida pela EJB-QL 3.0: <literal>substring(), trim(), - lower(), upper(), length(), locate(), abs(), sqrt(), bit_length(), mod()</literal> - </para> - </listitem> - <listitem> - <para> - <literal>coalesce()</literal> and <literal>nullif()</literal> - </para> - </listitem> - <listitem> - <para> - <literal>str()</literal> para converter valores numericos ou temporais para string - </para> - </listitem> - <listitem> - <para> - <literal>cast(... as ...)</literal>, onde o segundo argumento é o nome do tipo - hibernate, e<literal>extract(... from ...)</literal> se ANSI - <literal>cast()</literal> e <literal>extract()</literal> é suportado pele - banco de dados usado - </para> - </listitem> - <listitem> - <para> - A função HQL <literal>index()</literal> , que se aplicam a referencias de - coleçôes associadas e indexadas - </para> - </listitem> - <listitem> - <para> - As funções hql que retornam expressões de coleções de valores: - <literal>size(), minelement(), maxelement(), minindex(), maxindex()</literal>, - <literal>junto</literal> com o elemento especial, <literal>elements()</literal>, - e funções de <literal>índice</literal> que podem ser quantificadas usando - <literal>some, all, exists, any, in</literal>. - </para> - </listitem> - <listitem> - <para> - Qualquer funçâo escalar pelo bando de dados como <literal>sign()</literal>, - <literal>trunc()</literal>, <literal>rtrim()</literal>, <literal>sin()</literal> - </para> - </listitem> - <listitem> - <para> - Parametros posicionais ao estilo JDBC <literal>?</literal> - </para> - </listitem> - <listitem> - <para> - Parametros nomeados <literal>:name</literal>, <literal>:start_date</literal>, <literal>:x1</literal> - </para> - </listitem> - <listitem> - <para> - Literais SQL <literal>'foo'</literal>, <literal>69</literal>, <literal>6.66E+2</literal>, - <literal>'1970-01-01 10:00:01.0'</literal> - </para> - </listitem> - <listitem> - <para> - Constantes Java <literal>public static final</literal> <literal>ex: Color.TABBY</literal> - </para> - </listitem> - </itemizedlist> - - <para> - <literal>in</literal> e <literal>between</literal> podem ser usadas da seguinte maneira: - </para> - - <programlisting><![CDATA[from DomesticCat cat where cat.name between 'A' and 'B']]></programlisting> - - <programlisting><![CDATA[from DomesticCat cat where cat.name in ( 'Foo', 'Bar', 'Baz' )]]></programlisting> - - <para> - e as formas negativas podem ser escritas - </para> - - <programlisting><![CDATA[from DomesticCat cat where cat.name not between 'A' and 'B']]></programlisting> - - <programlisting><![CDATA[from DomesticCat cat where cat.name not in ( 'Foo', 'Bar', 'Baz' )]]></programlisting> - - <para> - Likewise, <literal>is null</literal> and <literal>is not null</literal> may be used to test - for null values. - Assim mesmo, , <literal>is null</literal> e <literal>is not null</literal> podem ser usados - para testar valores nulos. - </para> - - <para> - Booleanos podem ser facilmente usados em expressões, declarando as substituições da HQL query, - na configuração do Hibernate - </para> - - <programlisting><![CDATA[<property name="hibernate.query.substitutions">true 1, false 0</property>]]></programlisting> - - <para> - Isso irá substituir as palavras chave <literal>true</literal> e <literal>false</literal> - <literal>pelos</literal> literais <literal>1</literal> e <literal>0</literal> na tradução do HQL para SQL. - </para> - - <programlisting><![CDATA[from Cat cat where cat.alive = true]]></programlisting> - - <para> - Pode-se testar o tamanho de uma coleção <literal>com</literal> a propriedade especial <literal>size</literal>, - ou a função especial <literal>size()</literal>. - </para> - - <programlisting><![CDATA[from Cat cat where cat.kittens.size > 0]]></programlisting> - - <programlisting><![CDATA[from Cat cat where size(cat.kittens) > 0]]></programlisting> - - <para> - Para coleções indexadas, você pode se referir aos índices máximo e mínimo, usando - as funções <literal>minindex</literal> e <literal>maxindex</literal>. Similarmente, - pode-se referir aos elementos máximo e mínimo de uma coleção de tipos básicos usando - as funções <literal>minelement</literal> e <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> - As funções SQL <literal>any, some, all, exists, in</literal> são suportadas quando passado o - elemento ou o conjunto de índices de uma coleção (<literal>elements</literal> e - <literal>indices</literal> de funções), ou o resultado de uma subquery (veja abaixo). - </para> - - <programlisting><![CDATA[select mother from Cat as mother, Cat as kit -where kit in elements(foo.kittens)]]></programlisting> - - <programlisting><![CDATA[select p from NameList list, Person p -where p.name = some elements(list.names)]]></programlisting> - - <programlisting><![CDATA[from Cat cat where exists elements(cat.kittens)]]></programlisting> - - <programlisting><![CDATA[from Player p where 3 > all elements(p.scores)]]></programlisting> - - <programlisting><![CDATA[from Show show where 'fizard' in indices(show.acts)]]></programlisting> - - <para> - Note que essas construções - <literal>size</literal>, <literal>elements</literal>, - <literal>indices</literal>, <literal>minindex</literal>, <literal>maxindex</literal>, - <literal>minelement</literal>, <literal>maxelement</literal>– - só podem ser usados na clausula where do Hibernate3. - </para> - - <para> - Elementos de coleções com índice (arrays, lists, maps), podem ser referenciadas - pelo índice (apenas na clausula where): - </para> - - <programlisting><![CDATA[from Order order where order.items[0].id = 1234]]></programlisting> - - <programlisting><![CDATA[select person from Person person, Calendar calendar -where calendar.holidays['national day'] = person.birthDay - and person.nationality.calendar = calendar]]></programlisting> - - <programlisting><![CDATA[select item from Item item, Order order -where order.items[ order.deliveredItemIndices[0] ] = item and order.id = 11]]></programlisting> - - <programlisting><![CDATA[select item from Item item, Order order -where order.items[ maxindex(order.items) ] = item and order.id = 11]]></programlisting> - - <para> - A expressão entre colchetes <literal>[]</literal>, pode ser até uma expressão aritimética. - </para> - - <programlisting><![CDATA[select item from Item item, Order order -where order.items[ size(order.items) - 1 ] = item]]></programlisting> - - <para> - O HQL também provê a função interna <literal>index()</literal>, para elementos de - associação um-pra-muitos ou coleção de valores. - </para> - - <programlisting><![CDATA[select item, index(item) from Order order - join order.items item -where index(item) < 5]]></programlisting> - - <para> - Funções escalares SQL, suportadas pelo banco de dados subjacente. - </para> - - <programlisting><![CDATA[from DomesticCat cat where upper(cat.name) like 'FRI%']]></programlisting> - - <para> - Se ainda ainda não está totalmente convencido, pense o quão maior e menos legível poderia - ser a query a seguir, em SQL: - </para> - - <programlisting><![CDATA[select cust -from Product prod, - Store store - inner join store.customers cust -where prod.name = 'widget' - and store.location.name in ( 'Melbourne', 'Sydney' ) - and prod = all elements(cust.currentOrder.lineItems)]]></programlisting> - - <para> - <emphasis>Hint:</emphasis> something like - </para> - - <programlisting><![CDATA[SELECT cust.name, cust.address, cust.phone, cust.id, cust.current_order -FROM customers cust, - stores store, - locations loc, - store_customers sc, - product prod -WHERE prod.name = 'widget' - AND store.loc_id = loc.id - AND loc.name IN ( 'Melbourne', 'Sydney' ) - AND sc.store_id = store.id - AND sc.cust_id = cust.id - AND prod.id = ALL( - SELECT item.prod_id - FROM line_items item, orders o - WHERE item.order_id = o.id - AND cust.current_order = o.id - )]]></programlisting> - - </sect1> - - <sect1 id="queryhql-ordering"> - <title>A clausula order by</title> - - <para> - A lista retornada pela query pode ser ordenada por qualquer propriedade da classe ou componente retornado: - </para> - - <programlisting><![CDATA[from DomesticCat cat -order by cat.name asc, cat.weight desc, cat.birthdate]]></programlisting> - - <para> - As opções <literal>asc</literal> ou <literal>desc</literal> indicam ordem crescente ou decrescente, - respectivamente. - </para> - </sect1> - - <sect1 id="queryhql-grouping"> - <title>A clausula group by</title> - - <para> - Uma query que retorne valores agregados, podem ser agrupados por qualquer propriedade de uma classe - ou componente retornado: - </para> - - <programlisting><![CDATA[select cat.color, sum(cat.weight), count(cat) -from Cat cat -group by cat.color]]></programlisting> - - <programlisting><![CDATA[select foo.id, avg(name), max(name) -from Foo foo join foo.names name -group by foo.id]]></programlisting> - - <para> - Uma clausula <literal>having</literal> também é permitida. - </para> - - <programlisting><![CDATA[select cat.color, sum(cat.weight), count(cat) -from Cat cat -group by cat.color -having cat.color in (eg.Color.TABBY, eg.Color.BLACK)]]></programlisting> - - <para> - Funções SQL e funções agregadas são permitidas nas clausulas - <literal>having</literal> e <literal>order by</literal>, se suportadas pelo banco - de dados subjacente (ex: não no MySQL). - </para> - - <programlisting><![CDATA[select cat -from Cat cat - join cat.kittens kitten -group by cat -having avg(kitten.weight) > 100 -order by count(kitten) asc, sum(kitten.weight) desc]]></programlisting> - - <para> - Note que, nem a clausula <literal>group by</literal> ou - <literal>order by</literal>, podem conter expressões aritiméticas. - </para> - - </sect1> - - <sect1 id="queryhql-subqueries" revision="2"> - <title>Subqueries</title> - - <para> - Para bancos de dados que suportem subselects, o Hibernate suporta subqueries dentro de queries. - Uma subquery precisa estar entre parênteses (normalmente uma chamada de função agregada SQL). - Mesmo subqueries co-relacionadas (subqueries que fazem referência à alias de outras queries), - são aceitas. - </para> - - <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> - - <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> - - <programlisting><![CDATA[select cat.id, (select max(kit.weight) from cat.kitten kit) -from Cat as cat]]></programlisting> - - <para> - Note que HQL subqueries podem aparecer apenas dentro de clausulas select ou where. - </para> - - <para> - Para subqueries <literal>com</literal> mais de uma expressão na lista do select, pode-se usar um construtor - de tuplas: - </para> - - <programlisting><![CDATA[from Cat as cat -where not ( cat.name, cat.color ) in ( - select cat.name, cat.color from DomesticCat cat -)]]></programlisting> - - <para> - Veja que em alguns bancos de dados (mas não o Oracle ou HSQL), pode-se usar construtores - de tuplas em outros contextos. Por exemplo quando buscando componentes ou tipos de usuário composto. - </para> - - <programlisting><![CDATA[from Person where name = ('Gavin', 'A', 'King')]]></programlisting> - - <para> - Qual é equivalente ao mais verbalizado: - </para> - - <programlisting><![CDATA[from Person where name.first = 'Gavin' and name.initial = 'A' and name.last = 'King')]]></programlisting> - - <para> - Há duas razões boas que você pode não querer fazer este tipo de coisa: primeira, não - é completamente portável entre plataformas de banco de dados; segunda, a query agora é - dependente da ordem de propriedades no documento de mapeamento. - </para> - - </sect1> - - <sect1 id="queryhql-examples"> - <title>Exemplos de HQL</title> - - <para> - As queries do Hibernate, podem ser muito poderosas e complexas. De fato, o poder da linguagem de - querie é um dos pontos principais na distribuição do Hibernate. Aqui temos algumas queries de exemplo, - muito similares a queries que usei em um projeto recente. Note que a maioria das queries que você - irá escrever, são mais simples que estas. - </para> - - <para> - A query a seguir retorna o id de order, numero de itens e o valor total do order para todos os - orders não pagos para um freguês particular e valor total mínimo dado, ordenando os resultados por - valor total. Ao determinar os preços, é usado o catalogo corrente. A query SQL resultante, - usando tabelas <literal>ORDER</literal>, <literal>ORDER_LINE</literal>, <literal>PRODUCT</literal>, - <literal>CATALOG</literal> e <literal>PRICE</literal>, tem quatro inner joins e um - (não correlacionado) subselect. - </para> - - <programlisting><![CDATA[select order.id, sum(price.amount), count(item) -from Order as order - join order.lineItems as item - join item.product as product, - Catalog as catalog - join catalog.prices as price -where order.paid = false - and order.customer = :customer - and price.product = product - and catalog.effectiveDate < sysdate - and catalog.effectiveDate >= all ( - select cat.effectiveDate - from Catalog as cat - where cat.effectiveDate < sysdate - ) -group by order -having sum(price.amount) > :minAmount -order by sum(price.amount) desc]]></programlisting> - - <para> - Que monstro! Atualmente, na vida real, eu não sou muito afeiçoado a subqueries, então - minha query seria mais parecida com isto: - </para> - - <programlisting><![CDATA[select order.id, sum(price.amount), count(item) -from Order as order - join order.lineItems as item - join item.product as product, - Catalog as catalog - join catalog.prices as price -where order.paid = false - and order.customer = :customer - and price.product = product - and catalog = :currentCatalog -group by order -having sum(price.amount) > :minAmount -order by sum(price.amount) desc]]></programlisting> - - <para> - A próxima query conta o número de pagamentos em cada status, tirando todos os pagamentos com - status <literal>AWAITING_APPROVAL</literal>, onde a mais recente mudança de status foi feita - pelo usuário corrente. Traduz-se para uma query SQL <literal>com</literal> dois inner joins e - um subselect correlacionado, nas tabelas <literal>PAYMENT</literal>, - <literal>PAYMENT_STATUS</literal> e <literal>PAYMENT_STATUS_CHANGE</literal> . - </para> - - <programlisting><![CDATA[select count(payment), status.name -from Payment as payment - join payment.currentStatus as status - join payment.statusChanges as statusChange -where payment.status.name <> PaymentStatus.AWAITING_APPROVAL - or ( - statusChange.timeStamp = ( - select max(change.timeStamp) - from PaymentStatusChange change - where change.payment = payment - ) - and statusChange.user <> :currentUser - ) -group by status.name, status.sortOrder -order by status.sortOrder]]></programlisting> - - <para> - Se eu tivesse mapeado a Collection <literal>statusChanges</literal> como um List, ao invés de um - Set, a query teria sido muito mais simples de escrever. - </para> - - <programlisting><![CDATA[select count(payment), status.name -from Payment as payment - join payment.currentStatus as status -where payment.status.name <> PaymentStatus.AWAITING_APPROVAL - or payment.statusChanges[ maxIndex(payment.statusChanges) ].user <> :currentUser -group by status.name, status.sortOrder -order by status.sortOrder]]></programlisting> - - <para> - A próxima query usa a função <literal>isNull()</literal> do MS SQL Server, para retornar - todas as contas e pagamentos não pagos para a organização, para cada usuário corrente - pertencente. Traduz-se para uma query SQL <literal>com</literal> três inner joins, - um outer join e um subselect nas tabelas <literal>ACCOUNT</literal>, <literal>PAYMENT</literal>, - <literal>PAYMENT_STATUS</literal>,<literal>ACCOUNT_TYPE</literal>, - <literal>ORGANIZATION</literal> e <literal>ORG_USER</literal> . - </para> - - <programlisting><![CDATA[select account, payment -from Account as account - left outer join account.payments as payment -where :currentUser in elements(account.holder.users) - and PaymentStatus.UNPAID = isNull(payment.currentStatus.name, PaymentStatus.UNPAID) -order by account.type.sortOrder, account.accountNumber, payment.dueDate]]></programlisting> - - <para> - Para alguns bancos de dados, precisaremos eleminar o subselect (correlacionado). - </para> - - <programlisting><![CDATA[select account, payment -from Account as account - join account.holder.users as user - left outer join account.payments as payment -where :currentUser = user - and PaymentStatus.UNPAID = isNull(payment.currentStatus.name, PaymentStatus.UNPAID) -order by account.type.sortOrder, account.accountNumber, payment.dueDate]]></programlisting> - - </sect1> - - <sect1 id="queryhql-bulk" revision="2"> - <title>update e delete em lote</title> - - <para> - Agora o HQL suporta declarações, <literal>update</literal>, - <literal>delete</literal> e <literal>insert ... select ...</literal> - Veja <xref linkend="batch-direct"/>, para mais detalhes. - </para> - </sect1> - - <sect1 id="queryhql-tipstricks"> - <title>Dicas e Truques</title> - - <para> - Pode-se contar o número de resultados da query, sem realmente retorna-los. - </para> - - <programlisting><![CDATA[( (Integer) session.createQuery("select count(*) from ....").iterate().next() ).intValue()]]></programlisting> - - <para> - Para ordenar um resultado pelo tamanho de uma Collection, use a query a seguir. - </para> - - <programlisting><![CDATA[select usr.id, usr.name -from User as usr - left join usr.messages as msg -group by usr.id, usr.name -order by count(msg)]]></programlisting> - - <para> - Se seu banco de dados suporta subselects, pode-se colocar uma condição sobre - tamanho de seleção na cláusula where da sua query: - </para> - - <programlisting><![CDATA[from User usr where size(usr.messages) >= 1]]></programlisting> - - <para> - Se seu banco de dados não suporta subselects, use a query a seguir: - </para> - - <programlisting><![CDATA[select usr.id, usr.name -from User usr.name - join usr.messages msg -group by usr.id, usr.name -having count(msg) >= 1]]></programlisting> - - <para> - Com essa solução não se pode retornar um <literal>User</literal> <literal>com</literal> sem - nenhuma menssagem, por causa do "inner join", a forma a seguir também é útil. - </para> - - <programlisting><![CDATA[select usr.id, usr.name -from User as usr - left join usr.messages as msg -group by usr.id, usr.name -having count(msg) = 0]]></programlisting> - - <para> - As propriedades de um JavaBean podem ser limitadas à parâmetros nomeados da query: - </para> - - <programlisting><![CDATA[Query q = s.createQuery("from foo Foo as foo where foo.name=:name and foo.size=:size"); -q.setProperties(fooBean); // fooBean has getName() and getSize() -List foos = q.list();]]></programlisting> - - <para> - As Collections são paginaveis, usando a interface <literal>Query</literal> <literal>com</literal> um filtro: - </para> - - <programlisting><![CDATA[Query q = s.createFilter( collection, "" ); // the trivial filter -q.setMaxResults(PAGE_SIZE); -q.setFirstResult(PAGE_SIZE * pageNumber); -List page = q.list();]]></programlisting> - - <para> - Os elementos da Collection podem ser ordenados ou agrupados - usando um filtro de query: - </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> - - <para> - Pode-se achar o tamanho de uma Collection sem inicializa-la: - </para> - - <programlisting><![CDATA[( (Integer) session.createQuery("select count(*) from ....").iterate().next() ).intValue();]]></programlisting> - - </sect1> - -</chapter> - +<chapter id="queryhql"> + <title>HQL: A linguagem de Queries do Hibernate</title> + + <para> + O Hibernate vem com uma poderosa linguagem que é (intencionalmente) muito parecida + com o SQL. Mas não seja enganado pela sintaxe; a HQL é totalmente orientada à objetos, + requer conhecimentos de herança, polimorfismo e associações. + </para> + + <sect1 id="queryhql-casesensitivity"> + <title>Case Sensitíve</title> + + <para> + As Queries não são case-sensitive, exceto pelo nomes das classes e propriedades Java. + <literal>sELEct</literal> e o mesmo que + <literal>SELECT</literal> mas + <literal>org.hibernate.eg.FOO</literal> não é + <literal>org.hibernate.eg.Foo</literal> e + <literal>foo.barSet</literal> não é + <literal>foo.BARSET</literal>. + + </para> + + <para> + Esse manual usa as palavras chave HQL em letras minúsculas. Alguns usuários acham que + com letras maiúsculas as queries ficam mais legíveis, mas nós achamos essa convenção feia + dentro do código Java. + </para> + + </sect1> + + <sect1 id="queryhql-from"> + <title>A clausula from</title> + + <para> + A mais simples query possível do Hibernate é a assim: + </para> + + <programlisting><![CDATA[from eg.Cat]]></programlisting> + + <para> + Ela irá retornar todas as instancias da classe <literal>eg.Cat</literal>. + Necessariamente não precisamos qualificar o nome da classe, pois é realizado + <literal>auto-import</literal> por padrão. Por isso na maior parte do tempos + nós simplesmente escrevemos: + </para> + + <programlisting><![CDATA[from Cat]]></programlisting> + + <para> + Na maior parte do tempo, você precisará atribuir um <emphasis>alias</emphasis>, + desde que você queira se referia ao <literal>Cat</literal> em outras partes da + query. + </para> + + <programlisting><![CDATA[from Cat as cat]]></programlisting> + + <para> + Essa query atribui um alias a <literal>cat</literal> para as instancias de + <literal>Cat</literal>, então nós podemos usar esse alias depois na query. + A palavra chave as é opcional; poderíamos escrever assim: + </para> + + <programlisting><![CDATA[from Cat cat]]></programlisting> + + <para> + Múltiplas classes pode ser envolvidas, resultando em um produto cartesiano ou "cross" join. + </para> + + <programlisting><![CDATA[from Formula, Parameter]]></programlisting> + <programlisting><![CDATA[from Formula as form, Parameter as param]]></programlisting> + + <para> + É considerada uma boa prática os nomes dos aliases começarem com letra minúscula, + aderente com os padrões Java para variáveis locais (ex: <literal>domesticCat</literal>). + </para> + + </sect1> + + <sect1 id="queryhql-joins" revision="2"> + <title>Associações e joins</title> + + <para> + Nós também podemos querer atribuir aliases em uma entidade associada, ou mesmo + em elementos de uma coleção de valores, usando um <literal>join</literal>. + </para> + + <programlisting><![CDATA[from Cat as cat + inner join cat.mate as mate + left outer join cat.kittens as kitten]]></programlisting> + + <programlisting><![CDATA[from Cat as cat left join cat.mate.kittens as kittens]]></programlisting> + + <programlisting><![CDATA[from Formula form full join form.parameter param]]></programlisting> + + <para> + Os tipos de joins suportados foram inspirados no SQL ANSI: + </para> + + <itemizedlist spacing="compact"> + <listitem> + <para> + <literal>inner join</literal> + </para> + </listitem> + <listitem> + <para> + <literal>left outer join</literal> + </para> + </listitem> + <listitem> + <para> + <literal>right outer join</literal> + </para> + </listitem> + <listitem> + <para> + <literal>full join</literal> (geralmente não é útil) + </para> + </listitem> + </itemizedlist> + + <para> + The <literal>inner join</literal>, <literal>left outer join</literal> and + <literal>right outer join</literal> constructs may be abbreviated. + As construções <literal>inner join</literal>, <literal>left outer join</literal> e + <literal>right outer join</literal> podem ser abreviadas. + </para> + + <programlisting><![CDATA[from Cat as cat + join cat.mate as mate + left join cat.kittens as kitten]]></programlisting> + + <para> + Você pode fornecer condições extras de join usando a palavra + chave do HQL <literal>with</literal>. + </para> + + <programlisting><![CDATA[from Cat as cat + left join cat.kittens as kitten + <literal>with</literal> kitten.bodyWeight > 10.0]]></programlisting> + + <para> + Adicionalmente, um "fetch" join permite que associações ou coleções de valores + sejam inicializadas junto com o objeto pai, usando apenas um select. Isso é + muito útil no caso das coleções. Isso efetivamente sobre escreve as declarações + outer join e lazy do arquivo mapeamento para associações e coleções. + Veja a seção <xref linkend="performance-fetching"/> para mais informações. + </para> + + <programlisting><![CDATA[from Cat as cat + inner join <literal>fetch</literal>cat.mate + left join <literal>fetch</literal>cat.kittens]]></programlisting> + + <para> + Usualmente, um <literal>fetch</literal>join não precisa atribuir um alias, pois o objeto associado não + deve ser usado na clausula <literal>where</literal> (ou em qualquer outra clausula). + Também, os objetos associados não são retornados diretamente nos resultados da query. + Ao invés disso, eles devem ser acessados usando o objeto pai. A única razão que nós + podemos necessitar de um alias é quando fazemos um fech join recursivamente em uma + coleção adicional: + </para> + + <programlisting><![CDATA[from Cat as cat + inner join <literal>fetch</literal>cat.mate + left join <literal>fetch</literal>cat.kittens child + left join <literal>fetch</literal>child.kittens]]></programlisting> + + <para> + Observe que a construção <literal>fetch</literal> não deve ser usada em queries invocadas usando + <literal>iterate()</literal> (embora possa ser usado com <literal>scroll()</literal>). O + <literal>fetch</literal> também não deve ser usado junto com o <literal>setMaxResults()</literal> ou + <literal>setFirstResult()</literal> pois essas operações são baseadas nas linhas retornadas, que + normalmente contem duplicidade devido ao fetching das coleções, então o número de linhas pode não + ser o que você espera. + + O <literal>fetch</literal> não deve ser usado junto com uma condição <literal>with</literal> em + uma condição <literal>with</literal> ad hoc. É possível que seja criado um produto cartesiano pelo + join fetching em mais do que uma coleção em uma query, então tome cuidado nesses casos. Um join + fetching em varias coleções pode trazer resultados inesperados para mapeamentos do tipo bag, tome + cuidado na hora de formular queries como essas. Finalmente, observe o seguinte, o + <literal>full join fetch</literal> e <literal>right join fetch</literal> não são significativos. + </para> + + <para> + + Se está usando o nível de propriedade lazy (<literal>com</literal> instrumentação de bytecode), é possível + forçar o Hibernate a <literal>buscar</literal> as propriedades lazy imediatamente (na primeira query), + usando <literal>fetch all properties </literal>. + </para> + + <programlisting><![CDATA[from Document <literal>fetch</literal>all properties order by name]]></programlisting> + <programlisting><![CDATA[from Document doc <literal>fetch</literal>all properties where lower(doc.name) like '%cats%']]></programlisting> + + </sect1> + + <sect1 id="queryhql-joins-forms"> + <title>Formas e sintaxe de joins</title> + + <para> + O HQL suporta duas formas de associação para união: <literal>implícita</literal> e <literal>explicita</literal>. + </para> + + <para> + As queries apresentadas na seção anterior usam a forma <literal>explicita</literal>, onde a + palavra chave "join" é explicitamente usada na clausula "from". Essa é a forma recomendada. + </para> + + <para> + A forma <literal>implícita</literal> não usa a palavra chave "join". Entretanto, as associações + são diferenciadas usando pontuação ("." - dotnation). Uniões implícitas podem aparecer em + qualquer das clausulas HQL. A união <literal>implícita</literal> resulta em declarações + SQL que contem inner joins. + </para> + + <programlisting><![CDATA[from Cat as cat where cat.mate.name like '%s%']]></programlisting> + </sect1> + + <sect1 id="queryhql-identifier-property"> + <title>Refering to identifier property</title> + + <para> + There are, generally speaking, 2 ways to refer to an entity's identifier property: + </para> + <itemizedlist spacing="compact"> + <listitem> + <para> + The special property (lowercase) <literal>id</literal> may be used to reference the identifier + property of an entity <emphasis>provided that entity does not define a non-identifier property + named id</emphasis>. + </para> + </listitem> + <listitem> + <para> + If the entity defines a named identifier property, you may use that property name. + </para> + </listitem> + </itemizedlist> + + <para> + References to composite identifier properties follow the same naming rules. If the + entity has a non-identifier property named id, the composite identifier property can only + be referenced by its defined named; otherwise, the special <literal>id</literal> property + can be used to rerference the identifier property. + </para> + + <para> + Note: this has changed significantly starting in version 3.2.2. In previous versions, + <literal>id</literal> <emphasis>always</emphasis> referred to the identifier property no + matter what its actual name. A ramification of that decision was that non-identifier + properties named <literal>id</literal> could never be referenced in Hibernate queries. + </para> + </sect1> + + <sect1 id="queryhql-select"> + <title>Clausula select</title> + + <para> + A clausula <literal>select</literal> seleciona quais obetos e propriedades retornam + no resultado da query. Considere: + </para> + + <programlisting><![CDATA[select mate +from Cat as cat + inner join cat.mate as mate]]></programlisting> + + <para> + A query selecionará <literal>mate</literal>s (companheiros), de outros <literal>Cat</literal>s. + Atualmente, podemos expressar a query de forma mais compacta como: + </para> + + <programlisting><![CDATA[select cat.mate from Cat cat]]></programlisting> + + <para> + Queries podem retornar propriedades de qualquer tipo de valor, incluindo propriedades de tipo de componente: + + </para> + + <programlisting><![CDATA[select cat.name from DomesticCat cat +where cat.name like 'fri%']]></programlisting> + + <programlisting><![CDATA[select cust.name.firstName from Customer as cust]]></programlisting> + + <para> + Queries podem retornar múltiplos objetos e/ou propriedades como um array do + tipo Object[], + </para> + + <programlisting><![CDATA[select mother, offspr, mate.name +from DomesticCat as mother + inner join mother.mate as mate + left outer join mother.kittens as offspr]]></programlisting> + + <para> + ou como um <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> + ou como um objeto Java 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> + assumindo que a classe <literal>Family</literal> tenha um construtor apropriado. + </para> + + <para> + Pode-se designar referencias a expressões selecionadas, <literal>as</literal>: + </para> + + <programlisting><![CDATA[select max(bodyWeight) as max, min(bodyWeight) as min, count(*) as n +from Cat cat]]></programlisting> + + <para> + Isto é bem mais útil quando usado junto <literal>com</literal> <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> + Esta query retorna um <literal>Map</literal> de referencias para valores selecionados. + </para> + + </sect1> + + <sect1 id="queryhql-aggregation"> + <title>Funções de agregação</title> + + <para> + As queries HQL podem retornar o resultado de funções agregadas nas propriedades. + </para> + + <programlisting><![CDATA[select avg(cat.weight), sum(cat.weight), max(cat.weight), count(cat) +from Cat cat]]></programlisting> + + + + <para> + As funções agregadas suportadas são: + </para> + + <itemizedlist spacing="compact"> + <listitem> + <para> + <literal>avg(...), sum(...), min(...), max(...)</literal> + </para> + </listitem> + <listitem> + <para> + <literal>count(*)</literal> + </para> + </listitem> + <listitem> + <para> + <literal>count(...), count(distinct ...), count(all...)</literal> + </para> + </listitem> + </itemizedlist> + + <para> + Pode-se usar operadores aritiméticos, concatenação e funções SQL + reconhecidas na clausula select: + </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> + As palavras <literal>distinct</literal> e <literal>all</literal> podem ser usadas e têm + a mesma semântica como no SQL. + </para> + + <programlisting><![CDATA[select distinct cat.name from Cat cat + +select count(distinct cat.name), count(cat) from Cat cat]]></programlisting> + + </sect1> + + <sect1 id="queryhql-polymorphism"> + <title>Queries polimórficas</title> + + <para> + A query: + </para> + + <programlisting><![CDATA[from Cat as cat]]></programlisting> + + <para> + retorna instancias não só de <literal>Cat</literal>, mas também de subclasses como + <literal>DomesticCat</literal>. As queries do Hibernate podem nomear qualquer classe Java + ou interface na clausula <literal>from</literal>. A query retornará instancias de toda classe + persistente que extenda a determinada classe ou implemente a determinada interface. A query + , a seguir, pode retornar todo objeto persistente: + </para> + + <programlisting><![CDATA[from java.lang.Object o]]></programlisting> + + <para> + A interface <literal>Named</literal> pode ser implementada por várias classes persistentes: + </para> + + <programlisting><![CDATA[from Named n, Named m where n.name = m.name]]></programlisting> + + <para> + Note que as duas últimas queries requerem mais de um SQL SELECT . Isto significa que a clausula + <literal>order by</literal> não ordena corretamente todo o resultado. (Isso também significa que + você não pode chamar essas queries usando <literal>Query.scroll()</literal>.) + </para> + + </sect1> + + <sect1 id="queryhql-where"> + <title>A clausula where</title> + + <para> + A clausula <literal>where</literal> permite estreitar a lista de instancias retornada. + Se não houver referencia alguma, pode-se referir a propriedades pelo nome: + </para> + + <programlisting><![CDATA[from Cat where name='Fritz']]></programlisting> + + <para> + Se houver uma referência, use o nome da propriedade qualificada: + </para> + + <programlisting><![CDATA[from Cat as cat where cat.name='Fritz']]></programlisting> + + <para> + retorna instancias de <literal>Cat</literal> com nome ‘Fritz’. + </para> + + <programlisting><![CDATA[select foo +from Foo foo, Bar bar +where foo.startDate = bar.date]]></programlisting> + + <para> + retornará todas as instancias de <literal>Foo</literal>, para cada + um que tiver uma instancia de <literal>bar</literal> com a propriedade + <literal>date</literal> igual a propriedade + <literal>startDate</literal> de + <literal>Foo</literal>. Expressões de filtro compostas fazem da + clausula <literal>where</literal>, extremamente poderosa. Consideremos: + </para> + + <programlisting><![CDATA[from Cat cat where cat.mate.name is not null]]></programlisting> + + <para> + Esta query traduzida para uma query SQL <literal>com</literal> uma tabela (inner) join. Se fosse + escrever algo como: + </para> + + <programlisting><![CDATA[from Foo foo +where foo.bar.baz.customer.address.city is not null]]></programlisting> + + <para> + Poderia-se terminar <literal>com</literal> uma query que necessitasse de join de quatro tabelas, + no SQL. + </para> + + <para> + O operador <literal>=</literal> pode ser uasdo para comparar não apenas propriedades, + mas também instancias: + </para> + + <programlisting><![CDATA[from Cat cat, Cat rival where cat.mate = rival.mate]]></programlisting> + + <programlisting><![CDATA[select cat, mate +from Cat cat, Cat mate +where cat.mate = mate]]></programlisting> + + <para> + A propriedade especial (lowercase) <literal>id</literal> pode ser usada para referenciar + o identificador único de um objeto. (Pode-se usar também o nome de sua propriedade) + </para> + + <programlisting><![CDATA[from Cat as cat where cat.id = 123 + +from Cat as cat where cat.mate.id = 69]]></programlisting> + + <para> + A Segunda query é eficiente. Nenhuma união de tabelas é necessária! + </para> + + <para> + As propriedades de identificadores compostas também podem ser usadas. Suponha que + <literal>Person</literal> tenha um identificador composto que consiste de + <literal>country</literal> e <literal>medicareNumber</literal>. + </para> + + <programlisting><![CDATA[from bank.Person person +where person.id.country = 'AU' + and person.id.medicareNumber = 123456]]></programlisting> + + <programlisting><![CDATA[from bank.Account account +where account.owner.id.country = 'AU' + and account.owner.id.medicareNumber = 123456]]></programlisting> + + <para> + Mais uma vez, a Segunda query não precisa de nenhum join de tabela. + </para> + + <para> + Assim mesmo, a propriedade especial <literal>class</literal> acessa o valor discriminador da + instancia, no caso de persistência polimórfica. O nome de uma classe Java inclusa em uma + clausula "where", será traduzida para seu valor descriminante. + </para> + + <programlisting><![CDATA[from Cat cat where cat.class = DomesticCat]]></programlisting> + + <para> + Pode-se também especificar as propriedades dos components ou tipos de usuário composto + (e de componentes de componentes). Nunca tente usar uma expressão de filtro que termine na propriedade + de um tipo de componente (ao contrário de uma propriedade de um componente). Por exemplo, + se store.owner é uma entidade <literal>com</literal> um componente <literal>address</literal>. + </para> + + <programlisting><![CDATA[store.owner.address.city // okay +store.owner.address // error!]]></programlisting> + + <para> + Um tipo "any" tem as propriedades <literal>id</literal> e <literal>class</literal> especiais, + nôs permitindo expressar um join da seguinte forma (onde <literal>AuditLog.item</literal> é + uma propriedade mapeada <literal>com</literal> <literal><any></literal>) + </para> + + <programlisting><![CDATA[from AuditLog log, Payment payment +where log.item.class = 'Payment' and log.item.id = payment.id]]></programlisting> + + <para> + Veja que <literal>log.item.class</literal> e <literal>payment.class</literal> podem + referir-se a valores de colunas de banco de dados completamente diferentes, na query acima. + </para> + + </sect1> + + <sect1 id="queryhql-expressions"> + <title>Expressões</title> + + <para> + As expressões permitidas na cláusula <literal>where</literal> inclui a maioria + das coisas que você poderia escrever no SQL: + </para> + + <itemizedlist spacing="compact"> + <listitem> + <para> + operadores matemáticos <literal>+, -, *, /</literal> + </para> + </listitem> + <listitem> + <para> + operadores de comparação binários <literal>=, >=, <=, <>, !=, like</literal> + </para> + </listitem> + <listitem> + <para> + operadores lógicos <literal>and, or, not</literal> + </para> + </listitem> + <listitem> + <para> + parenteses <literal>( )</literal>, indicating grouping + </para> + </listitem> + <listitem> + <para> + <literal>in</literal>, + <literal>not in</literal>, + <literal>between</literal>, + <literal>is null</literal>, + <literal>is not null</literal>, + <literal>is empty</literal>, + <literal>is not empty</literal>, + <literal>member of</literal> and + <literal>not member of</literal> + </para> + </listitem> + <listitem> + <para> + case "simples" , <literal>case ... when ... then ... else ... end</literal>, and + "searched" case, <literal>case when ... then ... else ... end</literal> + </para> + </listitem> + <listitem> + <para> + concatenação de string <literal>...||...</literal> ou <literal>concat(...,...)</literal> + </para> + </listitem> + <listitem> + <para> + <literal>current_date()</literal>, <literal>current_time()</literal>, + <literal>current_timestamp()</literal> + </para> + </listitem> + <listitem> + <para> + <literal>second(...)</literal>, <literal>minute(...)</literal>, + <literal>hour(...)</literal>, <literal>day(...)</literal>, + <literal>month(...)</literal>, <literal>year(...)</literal>, + </para> + </listitem> + <listitem> + <para> + qualquer funcao ou operador definida pela EJB-QL 3.0: <literal>substring(), trim(), + lower(), upper(), length(), locate(), abs(), sqrt(), bit_length(), mod()</literal> + </para> + </listitem> + <listitem> + <para> + <literal>coalesce()</literal> and <literal>nullif()</literal> + </para> + </listitem> + <listitem> + <para> + <literal>str()</literal> para converter valores numericos ou temporais para string + </para> + </listitem> + <listitem> + <para> + <literal>cast(... as ...)</literal>, onde o segundo argumento é o nome do tipo + hibernate, e<literal>extract(... from ...)</literal> se ANSI + <literal>cast()</literal> e <literal>extract()</literal> é suportado pele + banco de dados usado + </para> + </listitem> + <listitem> + <para> + A função HQL <literal>index()</literal> , que se aplicam a referencias de + coleçôes associadas e indexadas + </para> + </listitem> + <listitem> + <para> + As funções hql que retornam expressões de coleções de valores: + <literal>size(), minelement(), maxelement(), minindex(), maxindex()</literal>, + <literal>junto</literal> com o elemento especial, <literal>elements()</literal>, + e funções de <literal>índice</literal> que podem ser quantificadas usando + <literal>some, all, exists, any, in</literal>. + </para> + </listitem> + <listitem> + <para> + Qualquer funçâo escalar pelo bando de dados como <literal>sign()</literal>, + <literal>trunc()</literal>, <literal>rtrim()</literal>, <literal>sin()</literal> + </para> + </listitem> + <listitem> + <para> + Parametros posicionais ao estilo JDBC <literal>?</literal> + </para> + </listitem> + <listitem> + <para> + Parametros nomeados <literal>:name</literal>, <literal>:start_date</literal>, <literal>:x1</literal> + </para> + </listitem> + <listitem> + <para> + Literais SQL <literal>'foo'</literal>, <literal>69</literal>, <literal>6.66E+2</literal>, + <literal>'1970-01-01 10:00:01.0'</literal> + </para> + </listitem> + <listitem> + <para> + Constantes Java <literal>public static final</literal> <literal>ex: Color.TABBY</literal> + </para> + </listitem> + </itemizedlist> + + <para> + <literal>in</literal> e <literal>between</literal> podem ser usadas da seguinte maneira: + </para> + + <programlisting><![CDATA[from DomesticCat cat where cat.name between 'A' and 'B']]></programlisting> + + <programlisting><![CDATA[from DomesticCat cat where cat.name in ( 'Foo', 'Bar', 'Baz' )]]></programlisting> + + <para> + e as formas negativas podem ser escritas + </para> + + <programlisting><![CDATA[from DomesticCat cat where cat.name not between 'A' and 'B']]></programlisting> + + <programlisting><![CDATA[from DomesticCat cat where cat.name not in ( 'Foo', 'Bar', 'Baz' )]]></programlisting> + + <para> + Likewise, <literal>is null</literal> and <literal>is not null</literal> may be used to test + for null values. + Assim mesmo, , <literal>is null</literal> e <literal>is not null</literal> podem ser usados + para testar valores nulos. + </para> + + <para> + Booleanos podem ser facilmente usados em expressões, declarando as substituições da HQL query, + na configuração do Hibernate + </para> + + <programlisting><![CDATA[<property name="hibernate.query.substitutions">true 1, false 0</property>]]></programlisting> + + <para> + Isso irá substituir as palavras chave <literal>true</literal> e <literal>false</literal> + <literal>pelos</literal> literais <literal>1</literal> e <literal>0</literal> na tradução do HQL para SQL. + </para> + + <programlisting><![CDATA[from Cat cat where cat.alive = true]]></programlisting> + + <para> + Pode-se testar o tamanho de uma coleção <literal>com</literal> a propriedade especial <literal>size</literal>, + ou a função especial <literal>size()</literal>. + </para> + + <programlisting><![CDATA[from Cat cat where cat.kittens.size > 0]]></programlisting> + + <programlisting><![CDATA[from Cat cat where size(cat.kittens) > 0]]></programlisting> + + <para> + Para coleções indexadas, você pode se referir aos índices máximo e mínimo, usando + as funções <literal>minindex</literal> e <literal>maxindex</literal>. Similarmente, + pode-se referir aos elementos máximo e mínimo de uma coleção de tipos básicos usando + as funções <literal>minelement</literal> e <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> + As funções SQL <literal>any, some, all, exists, in</literal> são suportadas quando passado o + elemento ou o conjunto de índices de uma coleção (<literal>elements</literal> e + <literal>indices</literal> de funções), ou o resultado de uma subquery (veja abaixo). + </para> + + <programlisting><![CDATA[select mother from Cat as mother, Cat as kit +where kit in elements(foo.kittens)]]></programlisting> + + <programlisting><![CDATA[select p from NameList list, Person p +where p.name = some elements(list.names)]]></programlisting> + + <programlisting><![CDATA[from Cat cat where exists elements(cat.kittens)]]></programlisting> + + <programlisting><![CDATA[from Player p where 3 > all elements(p.scores)]]></programlisting> + + <programlisting><![CDATA[from Show show where 'fizard' in indices(show.acts)]]></programlisting> + + <para> + Note que essas construções - <literal>size</literal>, <literal>elements</literal>, + <literal>indices</literal>, <literal>minindex</literal>, <literal>maxindex</literal>, + <literal>minelement</literal>, <literal>maxelement</literal>– + só podem ser usados na clausula where do Hibernate3. + </para> + + <para> + Elementos de coleções com índice (arrays, lists, maps), podem ser referenciadas + pelo índice (apenas na clausula where): + </para> + + <programlisting><![CDATA[from Order order where order.items[0].id = 1234]]></programlisting> + + <programlisting><![CDATA[select person from Person person, Calendar calendar +where calendar.holidays['national day'] = person.birthDay + and person.nationality.calendar = calendar]]></programlisting> + + <programlisting><![CDATA[select item from Item item, Order order +where order.items[ order.deliveredItemIndices[0] ] = item and order.id = 11]]></programlisting> + + <programlisting><![CDATA[select item from Item item, Order order +where order.items[ maxindex(order.items) ] = item and order.id = 11]]></programlisting> + + <para> + A expressão entre colchetes <literal>[]</literal>, pode ser até uma expressão aritimética. + </para> + + <programlisting><![CDATA[select item from Item item, Order order +where order.items[ size(order.items) - 1 ] = item]]></programlisting> + + <para> + O HQL também provê a função interna <literal>index()</literal>, para elementos de + associação um-pra-muitos ou coleção de valores. + </para> + + <programlisting><![CDATA[select item, index(item) from Order order + join order.items item +where index(item) < 5]]></programlisting> + + <para> + Funções escalares SQL, suportadas pelo banco de dados subjacente. + </para> + + <programlisting><![CDATA[from DomesticCat cat where upper(cat.name) like 'FRI%']]></programlisting> + + <para> + Se ainda ainda não está totalmente convencido, pense o quão maior e menos legível poderia + ser a query a seguir, em SQL: + </para> + + <programlisting><![CDATA[select cust +from Product prod, + Store store + inner join store.customers cust +where prod.name = 'widget' + and store.location.name in ( 'Melbourne', 'Sydney' ) + and prod = all elements(cust.currentOrder.lineItems)]]></programlisting> + + <para> + <emphasis>Hint:</emphasis> something like + </para> + + <programlisting><![CDATA[SELECT cust.name, cust.address, cust.phone, cust.id, cust.current_order +FROM customers cust, + stores store, + locations loc, + store_customers sc, + product prod +WHERE prod.name = 'widget' + AND store.loc_id = loc.id + AND loc.name IN ( 'Melbourne', 'Sydney' ) + AND sc.store_id = store.id + AND sc.cust_id = cust.id + AND prod.id = ALL( + SELECT item.prod_id + FROM line_items item, orders o + WHERE item.order_id = o.id + AND cust.current_order = o.id + )]]></programlisting> + + </sect1> + + <sect1 id="queryhql-ordering"> + <title>A clausula order by</title> + + <para> + A lista retornada pela query pode ser ordenada por qualquer propriedade da classe ou componente retornado: + </para> + + <programlisting><![CDATA[from DomesticCat cat +order by cat.name asc, cat.weight desc, cat.birthdate]]></programlisting> + + <para> + As opções <literal>asc</literal> ou <literal>desc</literal> indicam ordem crescente ou decrescente, + respectivamente. + </para> + </sect1> + + <sect1 id="queryhql-grouping"> + <title>A clausula group by</title> + + <para> + Uma query que retorne valores agregados, podem ser agrupados por qualquer propriedade de uma classe + ou componente retornado: + </para> + + <programlisting><![CDATA[select cat.color, sum(cat.weight), count(cat) +from Cat cat +group by cat.color]]></programlisting> + + <programlisting><![CDATA[select foo.id, avg(name), max(name) +from Foo foo join foo.names name +group by foo.id]]></programlisting> + + <para> + Uma clausula <literal>having</literal> também é permitida. + </para> + + <programlisting><![CDATA[select cat.color, sum(cat.weight), count(cat) +from Cat cat +group by cat.color +having cat.color in (eg.Color.TABBY, eg.Color.BLACK)]]></programlisting> + + <para> + Funções SQL e funções agregadas são permitidas nas clausulas + <literal>having</literal> e <literal>order by</literal>, se suportadas pelo banco + de dados subjacente (ex: não no MySQL). + </para> + + <programlisting><![CDATA[select cat +from Cat cat + join cat.kittens kitten +group by cat +having avg(kitten.weight) > 100 +order by count(kitten) asc, sum(kitten.weight) desc]]></programlisting> + + <para> + Note que, nem a clausula <literal>group by</literal> ou + <literal>order by</literal>, podem conter expressões aritiméticas. + </para> + + </sect1> + + <sect1 id="queryhql-subqueries" revision="2"> + <title>Subqueries</title> + + <para> + Para bancos de dados que suportem subselects, o Hibernate suporta subqueries dentro de queries. + Uma subquery precisa estar entre parênteses (normalmente uma chamada de função agregada SQL). + Mesmo subqueries co-relacionadas (subqueries que fazem referência à alias de outras queries), + são aceitas. + </para> + + <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> + + <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> + + <programlisting><![CDATA[select cat.id, (select max(kit.weight) from cat.kitten kit) +from Cat as cat]]></programlisting> + + <para> + Note que HQL subqueries podem aparecer apenas dentro de clausulas select ou where. + </para> + + <para> + Note that subqueries can also utilize <literal>row value constructor</literal> syntax. See + <xref linkend="queryhql-tuple"/> for more details. + </para> + </sect1> + + <sect1 id="queryhql-examples"> + <title>Exemplos de HQL</title> + + <para> + As queries do Hibernate, podem ser muito poderosas e complexas. De fato, o poder da linguagem de + querie é um dos pontos principais na distribuição do Hibernate. Aqui temos algumas queries de exemplo, + muito similares a queries que usei em um projeto recente. Note que a maioria das queries que você + irá escrever, são mais simples que estas. + </para> + + <para> + A query a seguir retorna o id de order, numero de itens e o valor total do order para todos os + orders não pagos para um freguês particular e valor total mínimo dado, ordenando os resultados por + valor total. Ao determinar os preços, é usado o catalogo corrente. A query SQL resultante, + usando tabelas <literal>ORDER</literal>, <literal>ORDER_LINE</literal>, <literal>PRODUCT</literal>, + <literal>CATALOG</literal> e <literal>PRICE</literal>, tem quatro inner joins e um + (não correlacionado) subselect. + </para> + + <programlisting><![CDATA[select order.id, sum(price.amount), count(item) +from Order as order + join order.lineItems as item + join item.product as product, + Catalog as catalog + join catalog.prices as price +where order.paid = false + and order.customer = :customer + and price.product = product + and catalog.effectiveDate < sysdate + and catalog.effectiveDate >= all ( + select cat.effectiveDate + from Catalog as cat + where cat.effectiveDate < sysdate + ) +group by order +having sum(price.amount) > :minAmount +order by sum(price.amount) desc]]></programlisting> + + <para> + Que monstro! Atualmente, na vida real, eu não sou muito afeiçoado a subqueries, então + minha query seria mais parecida com isto: + </para> + + <programlisting><![CDATA[select order.id, sum(price.amount), count(item) +from Order as order + join order.lineItems as item + join item.product as product, + Catalog as catalog + join catalog.prices as price +where order.paid = false + and order.customer = :customer + and price.product = product + and catalog = :currentCatalog +group by order +having sum(price.amount) > :minAmount +order by sum(price.amount) desc]]></programlisting> + + <para> + A próxima query conta o número de pagamentos em cada status, tirando todos os pagamentos com + status <literal>AWAITING_APPROVAL</literal>, onde a mais recente mudança de status foi feita + pelo usuário corrente. Traduz-se para uma query SQL <literal>com</literal> dois inner joins e + um subselect correlacionado, nas tabelas <literal>PAYMENT</literal>, + <literal>PAYMENT_STATUS</literal> e <literal>PAYMENT_STATUS_CHANGE</literal> . + </para> + + <programlisting><![CDATA[select count(payment), status.name +from Payment as payment + join payment.currentStatus as status + join payment.statusChanges as statusChange +where payment.status.name <> PaymentStatus.AWAITING_APPROVAL + or ( + statusChange.timeStamp = ( + select max(change.timeStamp) + from PaymentStatusChange change + where change.payment = payment + ) + and statusChange.user <> :currentUser + ) +group by status.name, status.sortOrder +order by status.sortOrder]]></programlisting> + + <para> + Se eu tivesse mapeado a Collection <literal>statusChanges</literal> como um List, ao invés de um + Set, a query teria sido muito mais simples de escrever. + </para> + + <programlisting><![CDATA[select count(payment), status.name +from Payment as payment + join payment.currentStatus as status +where payment.status.name <> PaymentStatus.AWAITING_APPROVAL + or payment.statusChanges[ maxIndex(payment.statusChanges) ].user <> :currentUser +group by status.name, status.sortOrder +order by status.sortOrder]]></programlisting> + + <para> + A próxima query usa a função <literal>isNull()</literal> do MS SQL Server, para retornar + todas as contas e pagamentos não pagos para a organização, para cada usuário corrente + pertencente. Traduz-se para uma query SQL <literal>com</literal> três inner joins, + um outer join e um subselect nas tabelas <literal>ACCOUNT</literal>, <literal>PAYMENT</literal>, + <literal>PAYMENT_STATUS</literal>,<literal>ACCOUNT_TYPE</literal>, + <literal>ORGANIZATION</literal> e <literal>ORG_USER</literal> . + </para> + + <programlisting><![CDATA[select account, payment +from Account as account + left outer join account.payments as payment +where :currentUser in elements(account.holder.users) + and PaymentStatus.UNPAID = isNull(payment.currentStatus.name, PaymentStatus.UNPAID) +order by account.type.sortOrder, account.accountNumber, payment.dueDate]]></programlisting> + + <para> + Para alguns bancos de dados, precisaremos eleminar o subselect (correlacionado). + </para> + + <programlisting><![CDATA[select account, payment +from Account as account + join account.holder.users as user + left outer join account.payments as payment +where :currentUser = user + and PaymentStatus.UNPAID = isNull(payment.currentStatus.name, PaymentStatus.UNPAID) +order by account.type.sortOrder, account.accountNumber, payment.dueDate]]></programlisting> + + </sect1> + + <sect1 id="queryhql-bulk" revision="2"> + <title>update e delete em lote</title> + + <para> + Agora o HQL suporta declarações, <literal>update</literal>, + <literal>delete</literal> e <literal>insert ... select ...</literal> + Veja <xref linkend="batch-direct"/>, para mais detalhes. + </para> + </sect1> + + <sect1 id="queryhql-tipstricks"> + <title>Dicas e Truques</title> + + <para> + Pode-se contar o número de resultados da query, sem realmente retorna-los. + </para> + + <programlisting><![CDATA[( (Integer) session.createQuery("select count(*) from ....").iterate().next() ).intValue()]]></programlisting> + + <para> + Para ordenar um resultado pelo tamanho de uma Collection, use a query a seguir. + </para> + + <programlisting><![CDATA[select usr.id, usr.name +from User as usr + left join usr.messages as msg +group by usr.id, usr.name +order by count(msg)]]></programlisting> + + <para> + Se seu banco de dados suporta subselects, pode-se colocar uma condição sobre + tamanho de seleção na cláusula where da sua query: + </para> + + <programlisting><![CDATA[from User usr where size(usr.messages) >= 1]]></programlisting> + + <para> + Se seu banco de dados não suporta subselects, use a query a seguir: + </para> + + <programlisting><![CDATA[select usr.id, usr.name +from User usr.name + join usr.messages msg +group by usr.id, usr.name +having count(msg) >= 1]]></programlisting> + + <para> + Com essa solução não se pode retornar um <literal>User</literal> <literal>com</literal> sem + nenhuma menssagem, por causa do "inner join", a forma a seguir também é útil. + </para> + + <programlisting><![CDATA[select usr.id, usr.name +from User as usr + left join usr.messages as msg +group by usr.id, usr.name +having count(msg) = 0]]></programlisting> + + <para> + As propriedades de um JavaBean podem ser limitadas à parâmetros nomeados da query: + </para> + + <programlisting><![CDATA[Query q = s.createQuery("from foo Foo as foo where foo.name=:name and foo.size=:size"); +q.setProperties(fooBean); // fooBean has getName() and getSize() +List foos = q.list();]]></programlisting> + + <para> + As Collections são paginaveis, usando a interface <literal>Query</literal> <literal>com</literal> um filtro: + </para> + + <programlisting><![CDATA[Query q = s.createFilter( collection, "" ); // the trivial filter +q.setMaxResults(PAGE_SIZE); +q.setFirstResult(PAGE_SIZE * pageNumber); +List page = q.list();]]></programlisting> + + <para> + Os elementos da Collection podem ser ordenados ou agrupados + usando um filtro de query: + </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> + + <para> + Pode-se achar o tamanho de uma Collection sem inicializa-la: + </para> + + <programlisting><![CDATA[( (Integer) session.createQuery("select count(*) from ....").iterate().next() ).intValue();]]></programlisting> + + </sect1> + +</chapter> + Modified: core/trunk/documentation/manual/pt-BR/src/main/docbook/content/query_sql.xml =================================================================== --- core/trunk/documentation/manual/pt-BR/src/main/docbook/content/query_sql.xml 2007-10-26 00:46:38 UTC (rev 14135) +++ core/trunk/documentation/manual/pt-BR/src/main/docbook/content/query_sql.xml 2007-10-26 00:48:48 UTC (rev 14136) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="querysql" revision="2"> +<chapter id="querysql" revision="2"> <title>Native SQL</title> <para>You may also express queries in the native SQL dialect of your Modified: core/trunk/documentation/manual/pt-BR/src/main/docbook/content/session_api.xml =================================================================== --- core/trunk/documentation/manual/pt-BR/src/main/docbook/content/session_api.xml 2007-10-26 00:46:38 UTC (rev 14135) +++ core/trunk/documentation/manual/pt-BR/src/main/docbook/content/session_api.xml 2007-10-26 00:48:48 UTC (rev 14136) @@ -1,1248 +1,1270 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="objectstate"> - <title>Trabalhando com objetos</title> - - <para> - O Hibernate é uma solução completa de mapeamento objeto/relacional que não apenas - poupa o desenvolvedor dos detalhes de baixo nível do sistema de gerenciamento do - banco de dados, mas também oferece um <emphasis>gerenciamento de estado </emphasis> - para objetos. Isto é, ao contrário do gerenciamento de <literal>instruções </literal> - SQL em camadas de persistência JDBC/SQL comuns, uma visão natural da persistência - orientada a objetos em aplicações Java. - </para> - - <para> - Em outras palavras, desenvolvedores de aplicações Hibernate podem sempre pensar em - relação ao <emphasis>estado</emphasis> de seus objetos, e não necessariamente em - relação a execução de instruções SQL. Este parte é responsabilidade do Hibernate e - é relevante aos desenvolvedores de aplicações apenas quando estão ajustando - a performance do sistema. - </para> - - <sect1 id="objectstate-overview"> - <title>Estado dos objetos no Hibernate</title> - - <para> - O Hibernate define e suporta os seguintes estados de um objetos: - </para> - - <itemizedlist> - <listitem> - <para> - <emphasis>Transient</emphasis> - um objeto é transiente se ele foi instanciando - usando apenas o operador <literal>new</literal>, e não foi associado com uma - <literal>Session</literal> do Hibernate. Ele não terá uma representação - persistente no banco de dados e nenhum identificador será atribuído para ele. - Instâncias transientes serão destruídas pelo coletor de lixo se a aplicação - não manter sua referência. Use uma <literal>Session</literal> do Hibernate - para tornar o objeto persistente ( e deixe o Hibernate gerenciar as - instruções SQL que serão necessárias para executar esta transição). - </para> - </listitem> - <listitem> - <para> - <emphasis>Persistent</emphasis> -– uma instância persistente possui uma - representação no banco de dados e um identificador. Ele pode ter sido salvo - ou carregado, assim, ele está por definição no escopo de uma - <literal>Session</literal>. O Hibernate irá detectar qualquer mudança feita a - um objeto persistente e sincronizar o seu estado com o banco de dados quando - completar a unidade de trabalho. Desenvolvedores não executam instruções manuais - de <literal>UPDATE</literal>, ou instruções de <literal>DELETE</literal> - quando o objeto deve ser passado para transiente. - </para> - </listitem> - <listitem> - <para> - <emphasis>Detached</emphasis> – uma instância desaclopada é um objeto que - foi persistido, mas sua <literal>Session</literal> foi fechada. A referência - ao objeto continua válida, é claro, e a instância destacada desaclopada pode - ser acoplada a uma nova <literal>Session</literal> no futuro, fazendo-o - ( e todas as modificações sofridas) persistente novamente. Essa característica - possibilita um modelo de programação para unidades de trabalho que rodam - durante muito tempo que requer um pensamento por tempo do usuário. Podemos - chamar-las de <emphasis>transações da aplicação</emphasis>, i.e. uma unidade - de trabalho do ponto de vista do usuário. - </para> - </listitem> - </itemizedlist> - - <para> - Agora iremos discutir os estados e suas transições ( e os métodos do Hibernate que - disparam uma transição) em mais detalhes. - </para> - - </sect1> - - <sect1 id="objectstate-makingpersistent" revision="1"> - <title>Tornando os objetos persistentes</title> - - <para> - Instâncias recentemente instanciadas de uma classe persistente são - consideradas <emphasis>transientes </emphasis> pelo Hibernate. - Podemos tornar uma instância transiente em <emphasis>persistente</emphasis> - associando-a a uma sessão: - </para> - - <programlisting><![CDATA[DomesticCat fritz = new DomesticCat(); -fritz.setColor(Color.GINGER); -fritz.setSex('M'); -fritz.setName("Fritz"); -Long generatedId = (Long) sess.save(fritz);]]></programlisting> - - <para> - Se <literal>Cat</literal> possui um identificador gerado, o identificador - é gerado e atribuído a <literal>cat</literal> quando <literal>save()</literal> - for chamada. Se <literal>Cat</literal> possuir um identificador - <literal>Associado</literal>, ou uma chave composta, o identificador deve ser - atribuído à instância de <literal>cat</literal> antes que <literal>save()</literal> - seja chamado. Pode-se usar também <literal>persist()</literal> ao invés de - <literal>save()</literal>, com a semântica definada no novo esboço do EJB3. - </para> - - <para> - Alternativamente, pode-se atribuir o identificador usando uma versão - sobrecarregada de <literal>save()</literal>. - </para> - -<programlisting><![CDATA[DomesticCat pk = new DomesticCat(); -pk.setColor(Color.TABBY); -pk.setSex('F'); -pk.setName("PK"); -pk.setKittens( new HashSet() ); -pk.addKitten(fritz); -sess.save( pk, new Long(1234) );]]></programlisting> - - <para> - Se o objeto persistido possuir objetos associados (e.g. a coleção - <literal>kittens</literal> no exemplo anterior), esses objetos podem ser - tornar persistente em qualquer ordem que se queira ao menos que se tenha uma - restrição <literal>NOT NULL</literal> em uma coluna de chave estrangeira. - Nunca há risco de violação de restrições de chave estrangeira. Assim, - pode-se violar uma restrição <literal>NOT NULL</literal> se - <literal>save()</literal> for usada nos objetos em uma ordem errada. - </para> - - <para> - Geralmente você não deve se importar com esses detalhes, muito provavelmente se - usará a característica de <emphasis>persistência transitiva </emphasis> do Hibernate - para salvar os objetos associados automaticamente. Então, enquanto uma restrição - <literal>NOT NULL</literal> não ocorrer – Hibernate tomará conta de tudo. - Persistência transitiva será discutida futuramente nesse capítulo. - </para> - - </sect1> - - <sect1 id="objectstate-loading"> - <title>Carregando o objetos</title> - - <para> - O método <literal>load()</literal> de uma <literal> Session</literal> nos - fornece um meio para recuperar uma instância persistente se o identificador - for conhecido. <literal>load()</literal> recebe uma classe do objeto e carregará - o estado em uma instância mais recente dessa classe, no estado persistente. - </para> - - <programlisting><![CDATA[Cat fritz = (Cat) sess.load(Cat.class, generatedId);]]></programlisting> - -<programlisting><![CDATA[// you need to wrap primitive identifiers -long id = 1234; -DomesticCat pk = (DomesticCat) sess.load( DomesticCat.class, new Long(id) );]]></programlisting> - - <para> - Alternatively, you can load state into a given instance: -Alternativamente, pode-se carregar um estado em uma instância dada: - </para> - -<programlisting><![CDATA[Cat cat = new DomesticCat(); -// load pk's state into cat -sess.load( cat, new Long(pkId) ); -Set kittens = cat.getKittens();]]></programlisting> - - <para> - Repare que <literal>load()</literal> irá lançar uma exceção irrecuperável - se não houver na tabela no banco de dados um registro que combine. - Se a classe for mapeada com um proxy, <literal>load()</literal> - simplesmente retorna um proxy não inicializado e realmente não chamará - o banco de dados até que um método do proxy seja invocado. - Esse comportamento é muito útil se deseja-se criar uma associação - com um objeto sem que realmente o carregue do bando de dados. - Isto também permite que sejam carregadas múltiplas instâncias como um - grupo se <literal>batch-size</literal> estiver para o mapeamento da - classe. - </para> - - <para> - Se você não tiver certeza da existencia do registro no banco, você deve - usar o metodo <literal>get()</literal>, que consulta o banco - imediantamente e retorna um null se não existir o registro. - </para> - - <programlisting><![CDATA[Cat cat = (Cat) sess.get(Cat.class, id); -if (cat==null) { - cat = new Cat(); - sess.save(cat, id); -} -return cat;]]></programlisting> - - <para> - Também pode-se carregar um objeto usando <literal>SELECT ... FOR UPDATE</literal>, - usando um <literal>LockMode</literal>. Veja a documentação da API para maiores - informações. - </para> - - <programlisting><![CDATA[Cat cat = (Cat) sess.get(Cat.class, id, LockMode.UPGRADE);]]></programlisting> - - <para> - Note that any associated instances or contained collections are - <emphasis>not</emphasis> selected <literal>FOR UPDATE</literal>, unless you decide - to specify <literal>lock</literal> or <literal>all</literal> as a - cascade style for the association. - </para> - - <para> - O recarregamento de um objeto e todas as suas coleções é possível a qualquer momento, - usando o método <literal>refresh()</literal>. Util quando as triggers do banco de - dados são usados para inicializar algumas propriedades do objeto. - </para> - - <programlisting><![CDATA[sess.save(cat); -sess.flush(); //force the SQL INSERT -sess.refresh(cat); //re-read the state (after the trigger executes)]]></programlisting> - - <para> - Uma importante questão geralmente aparece neste ponto: O quanto Hibernate carrega - do banco de dados e quantos SQL <literal>SELECT</literal> ele irá usar? Isto - depende da estratégia de <emphasis>recuperação</emphasis>usada e explicada na - <xref linkend="performance-fetching"/>. - </para> - - </sect1> - - <sect1 id="objectstate-querying" revision="1"> - <title>Consultando</title> - - <para> - Se o identificador do objeto que se está buscando não for conhecido, - uma consulta será necessária. O Hibernate suporta uma linguagem de consulta - (HQL) orientada a objetos fácil mas poderosa. Para criação via programação - de consultas, o Hibernate suporta características sofisticadas de consulta - por Critério e Exemplo (QBCe QBE). Pode-se também expressar a consulta - por meio de SQL nativa do banco de dados, com suporte opcional do Hibernate - para conversão do conjunto de reultados em objetos. - </para> - - <sect2 id="objectstate-querying-executing" revision="1"> - <title>Executando consultas</title> - - <para> - Consultas HQL e SQL nativa são representadas por uma instância de <literal>org.hibernate.Query</literal>. - Esta interface oferece métodos para associação de parâmetros, tratamento de conjunto de resultados, - e para a execução de consultas reais. Você pode obter uma <literal>Query</literal> usando a - <literal>Session</literal> atual: - </para> - - <programlisting><![CDATA[List cats = session.createQuery( - "from Cat as cat where cat.birthdate < ?") - .setDate(0, date) - .list(); - -List mothers = session.createQuery( - "select mother from Cat as cat join cat.mother as mother where cat.name = ?") - .setString(0, name) - .list(); - -List kittens = session.createQuery( - "from Cat as cat where cat.mother = ?") - .setEntity(0, pk) - .list(); - -Cat mother = (Cat) session.createQuery( - "select cat.mother from Cat as cat where cat = ?") - .setEntity(0, izi) - .uniqueResult();]] - -Query mothersWithKittens = (Cat) session.createQuery( - "select mother from Cat as mother left join fetch mother.kittens"); -Set uniqueMothers = new HashSet(mothersWithKittens.list());]]></programlisting> - - <para> - Geralmente uma consulta é executada ao invocar <literal>list()</literal>, - o resultado da consulta será carregado completamente em uma coleção na memória. - Instâncias de entidades recuperadas por uma consulta estão no estado persistente. - O <literal>uniqueResult()</literal> oferece um atalho se você souber de - previamente que a consulta retornará apenas um único objeto. Repare que consultas - que fazem uso de buscas de coleções de forma ansiosa (eager) geralmente retornam - duplicatas dos objetos raiz ( mas com suas coleções inicializadas ). Pode-se - filtrar estas duplicatas através de um simples <literal>Set</literal>. - </para> - - <sect3 id="objectstate-querying-executing-iterate"> - <title>Interagindo com resultados</title> - - <para> - Ocasionalmente, deves-se ser capaz de atingir performances melhores com - a execução de consultas usando o método <literal>iterate()</literal>. - Geralmente isso será o caso esperado apenas se as instâncias dos entidades - reais retornadas pela consulta já estiverem na sessão ou no caché de segundo - nível. Caso elas ainda não tenham sido armazenadas, <literal>iterate()</literal> - será mais devagar do que <literal>list()</literal> e pode ser necessário vários - acessos ao banco de dados para um simples consulta, geralmente <emphasis>1</emphasis> - para a seleção inicial que retorna apenas identificadores, e <emphasis>n</emphasis> - consultas adicionais para inicializar as instâncias reais. - </para> - - <programlisting><![CDATA[// fetch ids -Iterator iter = sess.createQuery("from eg.Qux q order by q.likeliness").iterate(); -while ( iter.hasNext() ) { - Qux qux = (Qux) iter.next(); // fetch the object - // something we couldnt express in the query - if ( qux.calculateComplicatedAlgorithm() ) { - // delete the current instance - iter.remove(); - // dont need to process the rest - break; - } -}]]></programlisting> - </sect3> - - <sect3 id="objectstate-querying-executing-tuples"> - <title>Consultas que retornam tuplas</title> - - <para> - Algumas vezes as consultas do Hibernate retornam tuplas de objetos, nesse caso - cada tupla é retornada como um array: - </para> - - <programlisting><![CDATA[Iterator kittensAndMothers = sess.createQuery( - "select kitten, mother from Cat kitten join kitten.mother mother") - .list() - .iterator(); - -while ( kittensAndMothers.hasNext() ) { - Object[] tuple = (Object[]) kittensAndMothers.next(); - Cat kitten = (Cat) tuple[0]; - Cat mother = (Cat) tuple[1]; - .... -}]]></programlisting> - - </sect3> - - <sect3 id="objectstate-querying-executing-scalar" revision="1"> - <title>Resultados escalares</title> - - <para> - Consultas devem especificar uma propriedade da classe na clausula - <literal>select</literal>. Elas também podem chamar funções SQL de agregaçãos. - Propriedades ou agregações são considerados resultados agregados - ( e não entidades no estado persistente). - </para> - - <programlisting><![CDATA[Iterator results = sess.createQuery( - "select cat.color, min(cat.birthdate), count(cat) from Cat cat " + - "group by cat.color") - .list() - .iterator(); - -while ( results.hasNext() ) { - Object[] row = (Object[]) results.next(); - Color type = (Color) row[0]; - Date oldest = (Date) row[1]; - Integer count = (Integer) row[2]; - ..... -}]]></programlisting> - - </sect3> - - <sect3 id="objectstate-querying-executing-parameters"> - <title>Bind parameters</title> - - <para> - Methods on <literal>Query</literal> are provided for binding values to - named parameters or JDBC-style <literal>?</literal> parameters. - <emphasis>Contrary to JDBC, Hibernate numbers parameters from zero.</emphasis> - Named parameters are identifiers of the form <literal>:name</literal> in - the query string. The advantages of named parameters are: - </para> - - <itemizedlist spacing="compact"> - <listitem> - <para> - named parameters are insensitive to the order they occur in the - query string - </para> - </listitem> - <listitem> - <para> - they may occur multiple times in the same query - </para> - </listitem> - <listitem> - <para> - they are self-documenting - </para> - </listitem> - </itemizedlist> - - <programlisting><![CDATA[//named parameter (preferred) -Query q = sess.createQuery("from DomesticCat cat where cat.name = :name"); -q.setString("name", "Fritz"); -Iterator cats = q.iterate();]]></programlisting> - - <programlisting><![CDATA[//positional parameter -Query q = sess.createQuery("from DomesticCat cat where cat.name = ?"); -q.setString(0, "Izi"); -Iterator cats = q.iterate();]]></programlisting> - - <programlisting><![CDATA[//named parameter list -List names = new ArrayList(); -names.add("Izi"); -names.add("Fritz"); -Query q = sess.createQuery("from DomesticCat cat where cat.name in (:namesList)"); -q.setParameterList("namesList", names); -List cats = q.list();]]></programlisting> - - </sect3> - - <sect3 id="objectstate-querying-executing-pagination"> - <title>Pagination</title> - - <para> - If you need to specify bounds upon your result set (the maximum number of rows - you want to retrieve and / or the first row you want to retrieve) you should - use methods of the <literal>Query</literal> interface: - </para> - - <programlisting><![CDATA[Query q = sess.createQuery("from DomesticCat cat"); -q.setFirstResult(20); -q.setMaxResults(10); -List cats = q.list();]]></programlisting> - - <para> - Hibernate knows how to translate this limit query into the native - SQL of your DBMS. - </para> - - </sect3> - - <sect3 id="objectstate-querying-executing-scrolling"> - <title>Scrollable iteration</title> - - <para> - If your JDBC driver supports scrollable <literal>ResultSet</literal>s, the - <literal>Query</literal> interface may be used to obtain a - <literal>ScrollableResults</literal> object, which allows flexible - navigation of the query results. - </para> - - <programlisting><![CDATA[Query q = sess.createQuery("select cat.name, cat from DomesticCat cat " + - "order by cat.name"); -ScrollableResults cats = q.scroll(); -if ( cats.first() ) { - - // find the first name on each page of an alphabetical list of cats by name - firstNamesOfPages = new ArrayList(); - do { - String name = cats.getString(0); - firstNamesOfPages.add(name); - } - while ( cats.scroll(PAGE_SIZE) ); - - // Now get the first page of cats - pageOfCats = new ArrayList(); - cats.beforeFirst(); - int i=0; - while( ( PAGE_SIZE > i++ ) && cats.next() ) pageOfCats.add( cats.get(1) ); - -} -cats.close()]]></programlisting> - - <para> - Note that an open database connection (and cursor) is required for this - functionality, use <literal>setMaxResult()</literal>/<literal>setFirstResult()</literal> - if you need offline pagination functionality. - </para> - - </sect3> - - <sect3 id="objectstate-querying-executing-named" revision="1"> - <title>Externalizing named queries</title> - - <para> - You may also define named queries in the mapping document. (Remember to use a - <literal>CDATA</literal> section if your query contains characters that could - be interpreted as markup.) - </para> - - <programlisting><![CDATA[<query name="ByNameAndMaximumWeight"><![CDATA[ - from eg.DomesticCat as cat - where cat.name = ? - and cat.weight > ? -] ]></query>]]></programlisting> - - <para> - Parameter binding and executing is done programatically: - </para> - - <programlisting><![CDATA[Query q = sess.getNamedQuery("ByNameAndMaximumWeight"); -q.setString(0, name); -q.setInt(1, minWeight); -List cats = q.list();]]></programlisting> - - <para> - Note that the actual program code is independent of the query language that - is used, you may also define native SQL queries in metadata, or migrate - existing queries to Hibernate by placing them in mapping files. - </para> - - <para> - Also note that a query declaration inside a <literal><hibernate-mapping></literal> - element requires a global unique name for the query, while a query declaration inside a - <literal><class></literal> element is made unique automatically by prepending the - fully qualified name of the class, for example - <literal>eg.Cat.ByNameAndMaximumWeight</literal>. - </para> - - </sect3> - - </sect2> - - <sect2 id="objectstate-filtering" revision="1"> - <title>Filtering collections</title> - <para> - A collection <emphasis>filter</emphasis> is a special type of query that may be applied to - a persistent collection or array. The query string may refer to <literal>this</literal>, - meaning the current collection element. - </para> - - <programlisting><![CDATA[Collection blackKittens = session.createFilter( - pk.getKittens(), - "where this.color = ?") - .setParameter( Color.BLACK, Hibernate.custom(ColorUserType.class) ) - .list() -);]]></programlisting> - - <para> - The returned collection is considered a bag, and it's a copy of the given - collection. The original collection is not modified (this is contrary to - the implication of the name "filter", but consistent with expected behavior). - </para> - - <para> - Observe that filters do not require a <literal>from</literal> clause (though they may have - one if required). Filters are not limited to returning the collection elements themselves. - </para> - - <programlisting><![CDATA[Collection blackKittenMates = session.createFilter( - pk.getKittens(), - "select this.mate where this.color = eg.Color.BLACK.intValue") - .list();]]></programlisting> - - <para> - Even an empty filter query is useful, e.g. to load a subset of elements in a - huge collection: - </para> - - <programlisting><![CDATA[Collection tenKittens = session.createFilter( - mother.getKittens(), "") - .setFirstResult(0).setMaxResults(10) - .list();]]></programlisting> - - </sect2> - - <sect2 id="objecstate-querying-criteria" revision="1"> - <title>Criteria queries</title> - - <para> - HQL is extremely powerful but some developers prefer to build queries dynamically, - using an object-oriented API, rather than building query strings. Hibernate provides - an intuitive <literal>Criteria</literal> query API for these cases: - </para> - - <programlisting><![CDATA[Criteria crit = session.createCriteria(Cat.class); -crit.add( Restrictions.eq( "color", eg.Color.BLACK ) ); -crit.setMaxResults(10); -List cats = crit.list();]]></programlisting> - - <para> - The <literal>Criteria</literal> and the associated <literal>Example</literal> - API are discussed in more detail in <xref linkend="querycriteria"/>. - </para> - - </sect2> - - <sect2 id="objectstate-querying-nativesql" revision="2"> - <title>Queries in native SQL</title> - - <para> - You may express a query in SQL, using <literal>createSQLQuery()</literal> and - let Hibernate take care of the mapping from result sets to objects. Note - that you may at any time call <literal>session.connection()</literal> and - use the JDBC <literal>Connection</literal> directly. If you chose to use the - Hibernate API, you must enclose SQL aliases in braces: - </para> - - <programlisting><![CDATA[List cats = session.createSQLQuery("SELECT {cat.*} FROM CAT {cat} WHERE ROWNUM<10") - .addEntity("cat", Cat.class) -.list();]]></programlisting> - - <programlisting><![CDATA[List cats = session.createSQLQuery( - "SELECT {cat}.ID AS {cat.id}, {cat}.SEX AS {cat.sex}, " + - "{cat}.MATE AS {cat.mate}, {cat}.SUBCLASS AS {cat.class}, ... " + - "FROM CAT {cat} WHERE ROWNUM<10") - .addEntity("cat", Cat.class) -.list()]]></programlisting> - - <para> - SQL queries may contain named and positional parameters, just like Hibernate queries. - More information about native SQL queries in Hibernate can be found in - <xref linkend="querysql"/>. - </para> - - </sect2> - - </sect1> - - <sect1 id="objectstate-modifying" revision="1"> - <title>Modifying persistent objects</title> - - <para> - <emphasis>Transactional persistent instances</emphasis> (ie. objects loaded, saved, created or - queried by the <literal>Session</literal>) may be manipulated by the application - and any changes to persistent state will be persisted when the <literal>Session</literal> - is <emphasis>flushed</emphasis> (discussed later in this chapter). There is no need - to call a particular method (like <literal>update()</literal>, which has a different - purpose) to make your modifications persistent. So the most straightforward way to update - the state of an object is to <literal>load()</literal> it, - and then manipulate it directly, while the <literal>Session</literal> is open: - </para> - - <programlisting><![CDATA[DomesticCat cat = (DomesticCat) sess.load( Cat.class, new Long(69) ); -cat.setName("PK"); -sess.flush(); // changes to cat are automatically detected and persisted]]></programlisting> - - <para> - Sometimes this programming model is inefficient since it would require both an SQL - <literal>SELECT</literal> (to load an object) and an SQL <literal>UPDATE</literal> - (to persist its updated state) in the same session. Therefore Hibernate offers an - alternate approach, using detached instances. - </para> - - <para> - <emphasis>Note that Hibernate does not offer its own API for direct execution of - <literal>UPDATE</literal> or <literal>DELETE</literal> statements. Hibernate is a - <emphasis>state management</emphasis> service, you don't have to think in - <emphasis>statements</emphasis> to use it. JDBC is a perfect API for executing - SQL statements, you can get a JDBC <literal>Connection</literal> at any time - by calling <literal>session.connection()</literal>. Furthermore, the notion - of mass operations conflicts with object/relational mapping for online - transaction processing-oriented applications. Future versions of Hibernate - may however provide special mass operation functions. See <xref linkend="batch"/> - for some possible batch operation tricks.</emphasis> - </para> - - </sect1> - - <sect1 id="objectstate-detached" revision="2"> - <title>Modifying detached objects</title> - - <para> - Many applications need to retrieve an object in one transaction, send it to the - UI layer for manipulation, then save the changes in a new transaction. - Applications that use this kind of approach in a high-concurrency environment - usually use versioned data to ensure isolation for the "long" unit of work. - </para> - - <para> - Hibernate supports this model by providing for reattachment of detached instances - using the <literal>Session.update()</literal> or <literal>Session.merge()</literal> - methods: - </para> - - <programlisting><![CDATA[// in the first session -Cat cat = (Cat) firstSession.load(Cat.class, catId); -Cat potentialMate = new Cat(); -firstSession.save(potentialMate); - -// in a higher layer of the application -cat.setMate(potentialMate); - -// later, in a new session -secondSession.update(cat); // update cat -secondSession.update(mate); // update mate]]></programlisting> - - <para> - If the <literal>Cat</literal> with identifier <literal>catId</literal> had already - been loaded by <literal>secondSession</literal> when the application tried to - reattach it, an exception would have been thrown. - </para> - - <para> - Use <literal>update()</literal> if you are sure that the session does - not contain an already persistent instance with the same identifier, and - <literal>merge()</literal> if you want to merge your modifications at any time - without consideration of the state of the session. In other words, <literal>update()</literal> - is usually the first method you would call in a fresh session, ensuring that - reattachment of your detached instances is the first operation that is executed. - </para> - - <para> - The application should individually <literal>update()</literal> detached instances - reachable from the given detached instance if and <emphasis>only</emphasis> if it wants - their state also updated. This can be automated of course, using <emphasis>transitive - persistence</emphasis>, see <xref linkend="objectstate-transitive"/>. - </para> - - <para> - The <literal>lock()</literal> method also allows an application to reassociate - an object with a new session. However, the detached instance has to be unmodified! - </para> - - <programlisting><![CDATA[//just reassociate: -sess.lock(fritz, LockMode.NONE); -//do a version check, then reassociate: -sess.lock(izi, LockMode.READ); -//do a version check, using SELECT ... FOR UPDATE, then reassociate: -sess.lock(pk, LockMode.UPGRADE);]]></programlisting> - - <para> - Note that <literal>lock()</literal> can be used with various - <literal>LockMode</literal>s, see the API documentation and the - chapter on transaction handling for more information. Reattachment is not - the only usecase for <literal>lock()</literal>. - </para> - - <para> - Other models for long units of work are discussed in <xref linkend="transactions-optimistic"/>. - </para> - - </sect1> - - <sect1 id="objectstate-saveorupdate"> - <title>Automatic state detection</title> - - <para> - Hibernate users have requested a general purpose method that either saves a - transient instance by generating a new identifier or updates/reattaches - the detached instances associated with its current identifier. - The <literal>saveOrUpdate()</literal> method implements this functionality. - </para> - - <programlisting><![CDATA[// in the first session -Cat cat = (Cat) firstSession.load(Cat.class, catID); - -// in a higher tier of the application -Cat mate = new Cat(); -cat.setMate(mate); - -// later, in a new session -secondSession.saveOrUpdate(cat); // update existing state (cat has a non-null id) -secondSession.saveOrUpdate(mate); // save the new instance (mate has a null id)]]></programlisting> - - <para> - The usage and semantics of <literal>saveOrUpdate()</literal> seems to be confusing - for new users. Firstly, so long as you are not trying to use instances from one session - in another new session, you should not need to use <literal>update()</literal>, - <literal>saveOrUpdate()</literal>, or <literal>merge()</literal>. Some whole - applications will never use either of these methods. - </para> - - <para> - Usually <literal>update()</literal> or <literal>saveOrUpdate()</literal> are used in - the following scenario: - </para> - - <itemizedlist spacing="compact"> - <listitem> - <para> - the application loads an object in the first session - </para> - </listitem> - <listitem> - <para> - the object is passed up to the UI tier - </para> - </listitem> - <listitem> - <para> - some modifications are made to the object - </para> - </listitem> - <listitem> - <para> - the object is passed back down to the business logic tier - </para> - </listitem> - <listitem> - <para> - the application persists these modifications by calling - <literal>update()</literal> in a second session - </para> - </listitem> - </itemizedlist> - - <para> - <literal>saveOrUpdate()</literal> does the following: - </para> - - <itemizedlist spacing="compact"> - <listitem> - <para> - if the object is already persistent in this session, do nothing - </para> - </listitem> - <listitem> - <para> - if another object associated with the session has the same identifier, - throw an exception - </para> - </listitem> - <listitem> - <para> - if the object has no identifier property, <literal>save()</literal> it - </para> - </listitem> - <listitem> - <para> - if the object's identifier has the value assigned to a newly instantiated - object, <literal>save()</literal> it - </para> - </listitem> - <listitem> - <para> - if the object is versioned (by a <literal><version></literal> or - <literal><timestamp></literal>), and the version property value - is the same value assigned to a newly instantiated object, - <literal>save()</literal> it - </para> - </listitem> - <listitem> - <para> - otherwise <literal>update()</literal> the object - </para> - </listitem> - </itemizedlist> - - <para> - and <literal>merge()</literal> is very different: - </para> - - <itemizedlist spacing="compact"> - <listitem> - <para> - if there is a persistent instance with the same identifier currently - associated with the session, copy the state of the given object onto - the persistent instance - </para> - </listitem> - <listitem> - <para> - if there is no persistent instance currently associated with the session, - try to load it from the database, or create a new persistent instance - </para> - </listitem> - <listitem> - <para> - the persistent instance is returned - </para> - </listitem> - <listitem> - <para> - the given instance does not become associated with the session, it - remains detached - </para> - </listitem> - </itemizedlist> - - </sect1> - - <sect1 id="objectstate-deleting" revision="1"> - <title>Deleting persistent objects</title> - - <para> - <literal>Session.delete()</literal> will remove an object's state from the database. - Of course, your application might still hold a reference to a deleted object. - It's best to think of <literal>delete()</literal> as making a persistent instance - transient. - </para> - - <programlisting><![CDATA[sess.delete(cat);]]></programlisting> - - <para> - You may delete objects in any order you like, without risk of foreign key - constraint violations. It is still possible to violate a <literal>NOT - NULL</literal> constraint on a foreign key column by deleting objects in - the wrong order, e.g. if you delete the parent, but forget to delete the - children. - </para> - - </sect1> - - <sect1 id="objectstate-replicating" revision="1"> - <title>Replicating object between two different datastores</title> - - <para> - It is occasionally useful to be able to take a graph of persistent instances - and make them persistent in a different datastore, without regenerating identifier - values. - </para> - - <programlisting><![CDATA[//retrieve a cat from one database -Session session1 = factory1.openSession(); -Transaction tx1 = session1.beginTransaction(); -Cat cat = session1.get(Cat.class, catId); -tx1.commit(); -session1.close(); - -//reconcile with a second database -Session session2 = factory2.openSession(); -Transaction tx2 = session2.beginTransaction(); -session2.replicate(cat, ReplicationMode.LATEST_VERSION); -tx2.commit(); -session2.close();]]></programlisting> - - <para> - The <literal>ReplicationMode</literal> determines how <literal>replicate()</literal> - will deal with conflicts with existing rows in the database. - </para> - - <itemizedlist spacing="compact"> - <listitem> - <para> - <literal>ReplicationMode.IGNORE</literal> - ignore the object when there is - an existing database row with the same identifier - </para> - </listitem> - <listitem> - <para> - <literal>ReplicationMode.OVERWRITE</literal> - overwrite any existing database - row with the same identifier - </para> - </listitem> - <listitem> - <para> - <literal>ReplicationMode.EXCEPTION</literal> - throw an exception if there is - an existing database row with the same identifier - </para> - </listitem> - <listitem> - <para> - <literal>ReplicationMode.LATEST_VERSION</literal> - overwrite the row if its - version number is earlier than the version number of the object, or ignore - the object otherwise - </para> - </listitem> - </itemizedlist> - - <para> - Usecases for this feature include reconciling data entered into different database - instances, upgrading system configuration information during product upgrades, - rolling back changes made during non-ACID transactions and more. - </para> - - </sect1> - - <sect1 id="objectstate-flushing"> - <title>Flushing the Session</title> - - <para> - From time to time the <literal>Session</literal> will execute the SQL statements - needed to synchronize the JDBC connection's state with the state of objects held in - memory. This process, <emphasis>flush</emphasis>, occurs by default at the following - points - </para> - - <itemizedlist spacing="compact"> - <listitem> - <para> - before some query executions - </para> - </listitem> - <listitem> - <para> - from <literal>org.hibernate.Transaction.commit()</literal> - </para> - </listitem> - <listitem> - <para> - from <literal>Session.flush()</literal> - </para> - </listitem> - </itemizedlist> - - <para> - The SQL statements are issued in the following order - </para> - - <orderedlist spacing="compact"> - <listitem> - <para> - all entity insertions, in the same order the corresponding objects - were saved using <literal>Session.save()</literal> - </para> - </listitem> - <listitem> - <para> - all entity updates - </para> - </listitem> - <listitem> - <para> - all collection deletions - </para> - </listitem> - <listitem> - <para> - all collection element deletions, updates and insertions - </para> - </listitem> - <listitem> - <para> - all collection insertions - </para> - </listitem> - <listitem> - <para> - all entity deletions, in the same order the corresponding objects - were deleted using <literal>Session.delete()</literal> - </para> - </listitem> - </orderedlist> - - <para> - (An exception is that objects using <literal>native</literal> ID generation are - inserted when they are saved.) - </para> - - <para> - Except when you explicity <literal>flush()</literal>, there are absolutely no - guarantees about <emphasis>when</emphasis> the <literal>Session</literal> executes - the JDBC calls, only the <emphasis>order</emphasis> in which they are executed. - However, Hibernate does guarantee that the <literal>Query.list(..)</literal> - will never return stale data; nor will they return the wrong data. - </para> - - <para> - It is possible to change the default behavior so that flush occurs less frequently. - The <literal>FlushMode</literal> class defines three different modes: only flush - at commit time (and only when the Hibernate <literal>Transaction</literal> API - is used), flush automatically using the explained routine, or never flush unless - <literal>flush()</literal> is called explicitly. The last mode is useful for long running - units of work, where a <literal>Session</literal> is kept open and disconnected for - a long time (see <xref linkend="transactions-optimistic-longsession"/>). - </para> - - <programlisting><![CDATA[sess = sf.openSession(); -Transaction tx = sess.beginTransaction(); -sess.setFlushMode(FlushMode.COMMIT); // allow queries to return stale state - -Cat izi = (Cat) sess.load(Cat.class, id); -izi.setName(iznizi); - -// might return stale data -sess.find("from Cat as cat left outer join cat.kittens kitten"); - -// change to izi is not flushed! -... -tx.commit(); // flush occurs -sess.close();]]></programlisting> - - <para> - During flush, an exception might occur (e.g. if a DML operation violates a constraint). - Since handling exceptions involves some understanding of Hibernate's transactional - behavior, we discuss it in <xref linkend="transactions"/>. - </para> - - </sect1> - - <sect1 id="objectstate-transitive" revision="1"> - <title>Transitive persistence</title> - - <para> - It is quite cumbersome to save, delete, or reattach individual objects, - especially if you deal with a graph of associated objects. A common case is - a parent/child relationship. Consider the following example: - </para> - - <para> - If the children in a parent/child relationship would be value typed (e.g. a collection - of addresses or strings), their life cycle would depend on the parent and no - further action would be required for convenient "cascading" of state changes. - When the parent is saved, the value-typed child objects are saved as - well, when the parent is deleted, the children will be deleted, etc. This - even works for operations such as the removal of a child from the collection; - Hibernate will detect this and, since value-typed objects can't have shared - references, delete the child from the database. - </para> - - <para> - Now consider the same scenario with parent and child objects being entities, - not value-types (e.g. categories and items, or parent and child cats). Entities - have their own life cycle, support shared references (so removing an entity from - the collection does not mean it can be deleted), and there is by default no - cascading of state from one entity to any other associated entities. Hibernate - does not implement <emphasis>persistence by reachability</emphasis> by default. - </para> - - <para> - For each basic operation of the Hibernate session - including <literal>persist(), merge(), - saveOrUpdate(), delete(), lock(), refresh(), evict(), replicate()</literal> - there is a - corresponding cascade style. Respectively, the cascade styles are named <literal>create, - merge, save-update, delete, lock, refresh, evict, replicate</literal>. If you want an - operation to be cascaded along an association, you must indicate that in the mapping - document. For example: - </para> - - <programlisting><![CDATA[<one-to-one name="person" cascade="persist"/>]]></programlisting> - - <para> - Cascade styles my be combined: - </para> - - <programlisting><![CDATA[<one-to-one name="person" cascade="persist,delete,lock"/>]]></programlisting> - - <para> - You may even use <literal>cascade="all"</literal> to specify that <emphasis>all</emphasis> - operations should be cascaded along the association. The default <literal>cascade="none"</literal> - specifies that no operations are to be cascaded. - </para> - - <para> - A special cascade style, <literal>delete-orphan</literal>, applies only to one-to-many - associations, and indicates that the <literal>delete()</literal> operation should - be applied to any child object that is removed from the association. - </para> - - - <para> - Recommendations: - </para> - - <itemizedlist spacing="compact"> - <listitem> - <para> - It doesn't usually make sense to enable cascade on a <literal><many-to-one></literal> - or <literal><many-to-many></literal> association. Cascade is often useful for - <literal><one-to-one></literal> and <literal><one-to-many></literal> - associations. - </para> - </listitem> - <listitem> - <para> - If the child object's lifespan is bounded by the lifespan of the parent - object, make it a <emphasis>life cycle object</emphasis> by specifying - <literal>cascade="all,delete-orphan"</literal>. - </para> - </listitem> - <listitem> - <para> - Otherwise, you might not need cascade at all. But if you think that you will often be - working with the parent and children together in the same transaction, and you want to save - yourself some typing, consider using <literal>cascade="persist,merge,save-update"</literal>. - </para> - </listitem> - </itemizedlist> - - <para> - Mapping an association (either a single valued association, or a collection) with - <literal>cascade="all"</literal> marks the association as a - <emphasis>parent/child</emphasis> style relationship where save/update/delete of the - parent results in save/update/delete of the child or children. - </para> - <para> - Futhermore, a mere reference to a child from a persistent parent will result in - save/update of the child. This metaphor is incomplete, however. A child which becomes - unreferenced by its parent is <emphasis>not</emphasis> automatically deleted, except - in the case of a <literal><one-to-many></literal> association mapped with - <literal>cascade="delete-orphan"</literal>. The precise semantics of cascading - operations for a parent/child relationship are as follows: - </para> - - <itemizedlist spacing="compact"> - <listitem> - <para> - If a parent is passed to <literal>persist()</literal>, all children are passed to - <literal>persist()</literal> - </para> - </listitem> - <listitem> - <para> - If a parent is passed to <literal>merge()</literal>, all children are passed to - <literal>merge()</literal> - </para> - </listitem> - <listitem> - <para> - If a parent is passed to <literal>save()</literal>, <literal>update()</literal> or - <literal>saveOrUpdate()</literal>, all children are passed to <literal>saveOrUpdate()</literal> - </para> - </listitem> - <listitem> - <para> - If a transient or detached child becomes referenced by a persistent parent, - it is passed to <literal>saveOrUpdate()</literal> - </para> - </listitem> - <listitem> - <para> - If a parent is deleted, all children are passed to <literal>delete()</literal> - </para> - </listitem> - <listitem> - <para> - If a child is dereferenced by a persistent parent, <emphasis>nothing - special happens</emphasis> - the application should explicitly delete - the child if necessary - unless <literal>cascade="delete-orphan"</literal>, - in which case the "orphaned" child is deleted. - </para> - </listitem> - </itemizedlist> - - <para> - Finally, note that cascading of operations can be applied to an object graph at - <emphasis>call time</emphasis> or at <emphasis>flush time</emphasis>. All operations, - if enabled, are cascaded to associated entities reachable when the operation is - executed. However, <literal>save-upate</literal> and <literal>delete-orphan</literal> - are transitive for all associated entities reachable during flush of the - <literal>Session</literal>. - </para> - - </sect1> - - <sect1 id="objectstate-metadata"> - <title>Usando metadados</title> - - <para> - O Hibernate requer um modelo muito rico a nível de metadados de todas as entidades e tipos de - valores. De tempos em tempos, este modelo é muito útil à própria aplicação. Por exemplo, a - aplicação pode usar o metadados do Hibernate que executa um algoritmo "inteligente" que - compreende quais objetos podem ser copiados (por exemplo, tipos de valores mutáveis) ou - não (por exemplo, tipos de valores imutáveis e, possivelmente, entidades associadas). - </para> - <para> - O Hibernate expõe o metadados via interfaces <literal>ClassMetadata</literal> - e <literal>CollectionMetadata</literal> e pela hierarquia <literal>Type</literal>. - Instâncias das interfaces de metadados podem ser obtidas a partir do - <literal>SessionFactory</literal>. - </para> - - <programlisting><![CDATA[Cat fritz = ......; -ClassMetadata catMeta = sessionfactory.getClassMetadata(Cat.class); - -Object[] propertyValues = catMeta.getPropertyValues(fritz); -String[] propertyNames = catMeta.getPropertyNames(); -Type[] propertyTypes = catMeta.getPropertyTypes(); - -// get a Map of all properties which are not collections or associations -Map namedValues = new HashMap(); -for ( int i=0; i<propertyNames.length; i++ ) { - if ( !propertyTypes[i].isEntityType() && !propertyTypes[i].isCollectionType() ) { - namedValues.put( propertyNames[i], propertyValues[i] ); - } -}]]></programlisting> - - </sect1> - -</chapter> - +<chapter id="objectstate"> + <title>Trabalhando com objetos</title> + + <para> + O Hibernate é uma solução completa de mapeamento objeto/relacional que não apenas + poupa o desenvolvedor dos detalhes de baixo nível do sistema de gerenciamento do + banco de dados, mas também oferece um <emphasis>gerenciamento de estado </emphasis> + para objetos. Isto é, ao contrário do gerenciamento de <literal>instruções </literal> + SQL em camadas de persistência JDBC/SQL comuns, uma visão natural da persistência + orientada a objetos em aplicações Java. + </para> + + <para> + Em outras palavras, desenvolvedores de aplicações Hibernate podem sempre pensar em + relação ao <emphasis>estado</emphasis> de seus objetos, e não necessariamente em + relação a execução de instruções SQL. Este parte é responsabilidade do Hibernate e + é relevante aos desenvolvedores de aplicações apenas quando estão ajustando + a performance do sistema. + </para> + + <sect1 id="objectstate-overview"> + <title>Estado dos objetos no Hibernate</title> + + <para> + O Hibernate define e suporta os seguintes estados de um objetos: + </para> + + <itemizedlist> + <listitem> + <para> + <emphasis>Transient</emphasis> - um objeto é transiente se ele foi instanciando + usando apenas o operador <literal>new</literal>, e não foi associado com uma + <literal>Session</literal> do Hibernate. Ele não terá uma representação + persistente no banco de dados e nenhum identificador será atribuído para ele. + Instâncias transientes serão destruídas pelo coletor de lixo se a aplicação + não manter sua referência. Use uma <literal>Session</literal> do Hibernate + para tornar o objeto persistente ( e deixe o Hibernate gerenciar as + instruções SQL que serão necessárias para executar esta transição). + </para> + </listitem> + <listitem> + <para> + <emphasis>Persistent</emphasis> -– uma instância persistente possui uma + representação no banco de dados e um identificador. Ele pode ter sido salvo + ou carregado, assim, ele está por definição no escopo de uma + <literal>Session</literal>. O Hibernate irá detectar qualquer mudança feita a + um objeto persistente e sincronizar o seu estado com o banco de dados quando + completar a unidade de trabalho. Desenvolvedores não executam instruções manuais + de <literal>UPDATE</literal>, ou instruções de <literal>DELETE</literal> + quando o objeto deve ser passado para transiente. + </para> + </listitem> + <listitem> + <para> + <emphasis>Detached</emphasis> – uma instância desaclopada é um objeto que + foi persistido, mas sua <literal>Session</literal> foi fechada. A referência + ao objeto continua válida, é claro, e a instância destacada desaclopada pode + ser acoplada a uma nova <literal>Session</literal> no futuro, fazendo-o + ( e todas as modificações sofridas) persistente novamente. Essa característica + possibilita um modelo de programação para unidades de trabalho que rodam + durante muito tempo que requer um pensamento por tempo do usuário. Podemos + chamar-las de <emphasis>transações da aplicação</emphasis>, i.e. uma unidade + de trabalho do ponto de vista do usuário. + </para> + </listitem> + </itemizedlist> + + <para> + Agora iremos discutir os estados e suas transições ( e os métodos do Hibernate que + disparam uma transição) em mais detalhes. + </para> + + </sect1> + + <sect1 id="objectstate-makingpersistent" revision="1"> + <title>Tornando os objetos persistentes</title> + + <para> + Instâncias recentemente instanciadas de uma classe persistente são + consideradas <emphasis>transientes </emphasis> pelo Hibernate. + Podemos tornar uma instância transiente em <emphasis>persistente</emphasis> + associando-a a uma sessão: + </para> + + <programlisting><![CDATA[DomesticCat fritz = new DomesticCat(); +fritz.setColor(Color.GINGER); +fritz.setSex('M'); +fritz.setName("Fritz"); +Long generatedId = (Long) sess.save(fritz);]]></programlisting> + + <para> + Se <literal>Cat</literal> possui um identificador gerado, o identificador + é gerado e atribuído a <literal>cat</literal> quando <literal>save()</literal> + for chamada. Se <literal>Cat</literal> possuir um identificador + <literal>Associado</literal>, ou uma chave composta, o identificador deve ser + atribuído à instância de <literal>cat</literal> antes que <literal>save()</literal> + seja chamado. Pode-se usar também <literal>persist()</literal> ao invés de + <literal>save()</literal>, com a semântica definada no novo esboço do EJB3. + </para> + + <itemizedlist spacing="compact"> + <listitem> + <para> + <literal>persist()</literal> makes a transient instance persistent. + However, it doesn't guarantee that the identifier value will be assigned to + the persistent instance immediately, the assignment might happen at flush time. + <literal>persist()</literal> also guarantees that it will not execute an + <literal>INSERT</literal> statement if it is called outside of transaction + boundaries. This is useful in long-running conversations with an extended + Session/persistence context. + </para> + </listitem> + <listitem> + <para> + <literal>save()</literal> does guarantee to return an identifier. If an INSERT + has to be executed to get the identifier ( e.g. "identity" generator, not + "sequence"), this INSERT happens immediately, no matter if you are inside or + outside of a transaction. This is problematic in a long-running conversation + with an extended Session/persistence context. + </para> + </listitem> + </itemizedlist> + <para> + Alternativamente, pode-se atribuir o identificador usando uma versão + sobrecarregada de <literal>save()</literal>. + </para> + +<programlisting><![CDATA[DomesticCat pk = new DomesticCat(); +pk.setColor(Color.TABBY); +pk.setSex('F'); +pk.setName("PK"); +pk.setKittens( new HashSet() ); +pk.addKitten(fritz); +sess.save( pk, new Long(1234) );]]></programlisting> + + <para> + Se o objeto persistido possuir objetos associados (e.g. a coleção + <literal>kittens</literal> no exemplo anterior), esses objetos podem ser + tornar persistente em qualquer ordem que se queira ao menos que se tenha uma + restrição <literal>NOT NULL</literal> em uma coluna de chave estrangeira. + Nunca há risco de violação de restrições de chave estrangeira. Assim, + pode-se violar uma restrição <literal>NOT NULL</literal> se + <literal>save()</literal> for usada nos objetos em uma ordem errada. + </para> + + <para> + Geralmente você não deve se importar com esses detalhes, muito provavelmente se + usará a característica de <emphasis>persistência transitiva </emphasis> do Hibernate + para salvar os objetos associados automaticamente. Então, enquanto uma restrição + <literal>NOT NULL</literal> não ocorrer – Hibernate tomará conta de tudo. + Persistência transitiva será discutida futuramente nesse capítulo. + </para> + + </sect1> + + <sect1 id="objectstate-loading"> + <title>Carregando o objetos</title> + + <para> + O método <literal>load()</literal> de uma <literal> Session</literal> nos + fornece um meio para recuperar uma instância persistente se o identificador + for conhecido. <literal>load()</literal> recebe uma classe do objeto e carregará + o estado em uma instância mais recente dessa classe, no estado persistente. + </para> + + <programlisting><![CDATA[Cat fritz = (Cat) sess.load(Cat.class, generatedId);]]></programlisting> + +<programlisting><![CDATA[// you need to wrap primitive identifiers +long id = 1234; +DomesticCat pk = (DomesticCat) sess.load( DomesticCat.class, new Long(id) );]]></programlisting> + + <para> + Alternatively, you can load state into a given instance: +Alternativamente, pode-se carregar um estado em uma instância dada: + </para> + +<programlisting><![CDATA[Cat cat = new DomesticCat(); +// load pk's state into cat +sess.load( cat, new Long(pkId) ); +Set kittens = cat.getKittens();]]></programlisting> + + <para> + Repare que <literal>load()</literal> irá lançar uma exceção irrecuperável + se não houver na tabela no banco de dados um registro que combine. + Se a classe for mapeada com um proxy, <literal>load()</literal> + simplesmente retorna um proxy não inicializado e realmente não chamará + o banco de dados até que um método do proxy seja invocado. + Esse comportamento é muito útil se deseja-se criar uma associação + com um objeto sem que realmente o carregue do bando de dados. + Isto também permite que sejam carregadas múltiplas instâncias como um + grupo se <literal>batch-size</literal> estiver para o mapeamento da + classe. + </para> + + <para> + Se você não tiver certeza da existencia do registro no banco, você deve + usar o metodo <literal>get()</literal>, que consulta o banco + imediantamente e retorna um null se não existir o registro. + </para> + + <programlisting><![CDATA[Cat cat = (Cat) sess.get(Cat.class, id); +if (cat==null) { + cat = new Cat(); + sess.save(cat, id); +} +return cat;]]></programlisting> + + <para> + Também pode-se carregar um objeto usando <literal>SELECT ... FOR UPDATE</literal>, + usando um <literal>LockMode</literal>. Veja a documentação da API para maiores + informações. + </para> + + <programlisting><![CDATA[Cat cat = (Cat) sess.get(Cat.class, id, LockMode.UPGRADE);]]></programlisting> + + <para> + Note that any associated instances or contained collections are + <emphasis>not</emphasis> selected <literal>FOR UPDATE</literal>, unless you decide + to specify <literal>lock</literal> or <literal>all</literal> as a + cascade style for the association. + </para> + + <para> + O recarregamento de um objeto e todas as suas coleções é possível a qualquer momento, + usando o método <literal>refresh()</literal>. Util quando as triggers do banco de + dados são usados para inicializar algumas propriedades do objeto. + </para> + + <programlisting><![CDATA[sess.save(cat); +sess.flush(); //force the SQL INSERT +sess.refresh(cat); //re-read the state (after the trigger executes)]]></programlisting> + + <para> + Uma importante questão geralmente aparece neste ponto: O quanto Hibernate carrega + do banco de dados e quantos SQL <literal>SELECT</literal> ele irá usar? Isto + depende da estratégia de <emphasis>recuperação</emphasis>usada e explicada na + <xref linkend="performance-fetching"/>. + </para> + + </sect1> + + <sect1 id="objectstate-querying" revision="1"> + <title>Consultando</title> + + <para> + Se o identificador do objeto que se está buscando não for conhecido, + uma consulta será necessária. O Hibernate suporta uma linguagem de consulta + (HQL) orientada a objetos fácil mas poderosa. Para criação via programação + de consultas, o Hibernate suporta características sofisticadas de consulta + por Critério e Exemplo (QBCe QBE). Pode-se também expressar a consulta + por meio de SQL nativa do banco de dados, com suporte opcional do Hibernate + para conversão do conjunto de reultados em objetos. + </para> + + <sect2 id="objectstate-querying-executing" revision="1"> + <title>Executando consultas</title> + + <para> + Consultas HQL e SQL nativa são representadas por uma instância de <literal>org.hibernate.Query</literal>. + Esta interface oferece métodos para associação de parâmetros, tratamento de conjunto de resultados, + e para a execução de consultas reais. Você pode obter uma <literal>Query</literal> usando a + <literal>Session</literal> atual: + </para> + + <programlisting><![CDATA[List cats = session.createQuery( + "from Cat as cat where cat.birthdate < ?") + .setDate(0, date) + .list(); + +List mothers = session.createQuery( + "select mother from Cat as cat join cat.mother as mother where cat.name = ?") + .setString(0, name) + .list(); + +List kittens = session.createQuery( + "from Cat as cat where cat.mother = ?") + .setEntity(0, pk) + .list(); + +Cat mother = (Cat) session.createQuery( + "select cat.mother from Cat as cat where cat = ?") + .setEntity(0, izi) + .uniqueResult();]] + +Query mothersWithKittens = (Cat) session.createQuery( + "select mother from Cat as mother left join fetch mother.kittens"); +Set uniqueMothers = new HashSet(mothersWithKittens.list());]]></programlisting> + + <para> + Geralmente uma consulta é executada ao invocar <literal>list()</literal>, + o resultado da consulta será carregado completamente em uma coleção na memória. + Instâncias de entidades recuperadas por uma consulta estão no estado persistente. + O <literal>uniqueResult()</literal> oferece um atalho se você souber de + previamente que a consulta retornará apenas um único objeto. Repare que consultas + que fazem uso de buscas de coleções de forma ansiosa (eager) geralmente retornam + duplicatas dos objetos raiz ( mas com suas coleções inicializadas ). Pode-se + filtrar estas duplicatas através de um simples <literal>Set</literal>. + </para> + + <sect3 id="objectstate-querying-executing-iterate"> + <title>Interagindo com resultados</title> + + <para> + Ocasionalmente, deves-se ser capaz de atingir performances melhores com + a execução de consultas usando o método <literal>iterate()</literal>. + Geralmente isso será o caso esperado apenas se as instâncias dos entidades + reais retornadas pela consulta já estiverem na sessão ou no caché de segundo + nível. Caso elas ainda não tenham sido armazenadas, <literal>iterate()</literal> + será mais devagar do que <literal>list()</literal> e pode ser necessário vários + acessos ao banco de dados para um simples consulta, geralmente <emphasis>1</emphasis> + para a seleção inicial que retorna apenas identificadores, e <emphasis>n</emphasis> + consultas adicionais para inicializar as instâncias reais. + </para> + + <programlisting><![CDATA[// fetch ids +Iterator iter = sess.createQuery("from eg.Qux q order by q.likeliness").iterate(); +while ( iter.hasNext() ) { + Qux qux = (Qux) iter.next(); // fetch the object + // something we couldnt express in the query + if ( qux.calculateComplicatedAlgorithm() ) { + // delete the current instance + iter.remove(); + // dont need to process the rest + break; + } +}]]></programlisting> + </sect3> + + <sect3 id="objectstate-querying-executing-tuples"> + <title>Consultas que retornam tuplas</title> + + <para> + Algumas vezes as consultas do Hibernate retornam tuplas de objetos, nesse caso + cada tupla é retornada como um array: + </para> + + <programlisting><![CDATA[Iterator kittensAndMothers = sess.createQuery( + "select kitten, mother from Cat kitten join kitten.mother mother") + .list() + .iterator(); + +while ( kittensAndMothers.hasNext() ) { + Object[] tuple = (Object[]) kittensAndMothers.next(); + Cat kitten = (Cat) tuple[0]; + Cat mother = (Cat) tuple[1]; + .... +}]]></programlisting> + + </sect3> + + <sect3 id="objectstate-querying-executing-scalar" revision="1"> + <title>Resultados escalares</title> + + <para> + Consultas devem especificar uma propriedade da classe na clausula + <literal>select</literal>. Elas também podem chamar funções SQL de agregaçãos. + Propriedades ou agregações são considerados resultados agregados + ( e não entidades no estado persistente). + </para> + + <programlisting><![CDATA[Iterator results = sess.createQuery( + "select cat.color, min(cat.birthdate), count(cat) from Cat cat " + + "group by cat.color") + .list() + .iterator(); + +while ( results.hasNext() ) { + Object[] row = (Object[]) results.next(); + Color type = (Color) row[0]; + Date oldest = (Date) row[1]; + Integer count = (Integer) row[2]; + ..... +}]]></programlisting> + + </sect3> + + <sect3 id="objectstate-querying-executing-parameters"> + <title>Bind parameters</title> + + <para> + Methods on <literal>Query</literal> are provided for binding values to + named parameters or JDBC-style <literal>?</literal> parameters. + <emphasis>Contrary to JDBC, Hibernate numbers parameters from zero.</emphasis> + Named parameters are identifiers of the form <literal>:name</literal> in + the query string. The advantages of named parameters are: + </para> + + <itemizedlist spacing="compact"> + <listitem> + <para> + named parameters are insensitive to the order they occur in the + query string + </para> + </listitem> + <listitem> + <para> + they may occur multiple times in the same query + </para> + </listitem> + <listitem> + <para> + they are self-documenting + </para> + </listitem> + </itemizedlist> + + <programlisting><![CDATA[//named parameter (preferred) +Query q = sess.createQuery("from DomesticCat cat where cat.name = :name"); +q.setString("name", "Fritz"); +Iterator cats = q.iterate();]]></programlisting> + + <programlisting><![CDATA[//positional parameter +Query q = sess.createQuery("from DomesticCat cat where cat.name = ?"); +q.setString(0, "Izi"); +Iterator cats = q.iterate();]]></programlisting> + + <programlisting><![CDATA[//named parameter list +List names = new ArrayList(); +names.add("Izi"); +names.add("Fritz"); +Query q = sess.createQuery("from DomesticCat cat where cat.name in (:namesList)"); +q.setParameterList("namesList", names); +List cats = q.list();]]></programlisting> + + </sect3> + + <sect3 id="objectstate-querying-executing-pagination"> + <title>Pagination</title> + + <para> + If you need to specify bounds upon your result set (the maximum number of rows + you want to retrieve and / or the first row you want to retrieve) you should + use methods of the <literal>Query</literal> interface: + </para> + + <programlisting><![CDATA[Query q = sess.createQuery("from DomesticCat cat"); +q.setFirstResult(20); +q.setMaxResults(10); +List cats = q.list();]]></programlisting> + + <para> + Hibernate knows how to translate this limit query into the native + SQL of your DBMS. + </para> + + </sect3> + + <sect3 id="objectstate-querying-executing-scrolling"> + <title>Scrollable iteration</title> + + <para> + If your JDBC driver supports scrollable <literal>ResultSet</literal>s, the + <literal>Query</literal> interface may be used to obtain a + <literal>ScrollableResults</literal> object, which allows flexible + navigation of the query results. + </para> + + <programlisting><![CDATA[Query q = sess.createQuery("select cat.name, cat from DomesticCat cat " + + "order by cat.name"); +ScrollableResults cats = q.scroll(); +if ( cats.first() ) { + + // find the first name on each page of an alphabetical list of cats by name + firstNamesOfPages = new ArrayList(); + do { + String name = cats.getString(0); + firstNamesOfPages.add(name); + } + while ( cats.scroll(PAGE_SIZE) ); + + // Now get the first page of cats + pageOfCats = new ArrayList(); + cats.beforeFirst(); + int i=0; + while( ( PAGE_SIZE > i++ ) && cats.next() ) pageOfCats.add( cats.get(1) ); + +} +cats.close()]]></programlisting> + + <para> + Note that an open database connection (and cursor) is required for this + functionality, use <literal>setMaxResult()</literal>/<literal>setFirstResult()</literal> + if you need offline pagination functionality. + </para> + + </sect3> + + <sect3 id="objectstate-querying-executing-named" revision="1"> + <title>Externalizing named queries</title> + + <para> + You may also define named queries in the mapping document. (Remember to use a + <literal>CDATA</literal> section if your query contains characters that could + be interpreted as markup.) + </para> + + <programlisting><![CDATA[<query name="ByNameAndMaximumWeight"><![CDATA[ + from eg.DomesticCat as cat + where cat.name = ? + and cat.weight > ? +] ]></query>]]></programlisting> + + <para> + Parameter binding and executing is done programatically: + </para> + + <programlisting><![CDATA[Query q = sess.getNamedQuery("ByNameAndMaximumWeight"); +q.setString(0, name); +q.setInt(1, minWeight); +List cats = q.list();]]></programlisting> + + <para> + Note that the actual program code is independent of the query language that + is used, you may also define native SQL queries in metadata, or migrate + existing queries to Hibernate by placing them in mapping files. + </para> + + <para> + Also note that a query declaration inside a <literal><hibernate-mapping></literal> + element requires a global unique name for the query, while a query declaration inside a + <literal><class></literal> element is made unique automatically by prepending the + fully qualified name of the class, for example + <literal>eg.Cat.ByNameAndMaximumWeight</literal>. + </para> + + </sect3> + + </sect2> + + <sect2 id="objectstate-filtering" revision="1"> + <title>Filtering collections</title> + <para> + A collection <emphasis>filter</emphasis> is a special type of query that may be applied to + a persistent collection or array. The query string may refer to <literal>this</literal>, + meaning the current collection element. + </para> + + <programlisting><![CDATA[Collection blackKittens = session.createFilter( + pk.getKittens(), + "where this.color = ?") + .setParameter( Color.BLACK, Hibernate.custom(ColorUserType.class) ) + .list() +);]]></programlisting> + + <para> + The returned collection is considered a bag, and it's a copy of the given + collection. The original collection is not modified (this is contrary to + the implication of the name "filter", but consistent with expected behavior). + </para> + + <para> + Observe that filters do not require a <literal>from</literal> clause (though they may have + one if required). Filters are not limited to returning the collection elements themselves. + </para> + + <programlisting><![CDATA[Collection blackKittenMates = session.createFilter( + pk.getKittens(), + "select this.mate where this.color = eg.Color.BLACK.intValue") + .list();]]></programlisting> + + <para> + Even an empty filter query is useful, e.g. to load a subset of elements in a + huge collection: + </para> + + <programlisting><![CDATA[Collection tenKittens = session.createFilter( + mother.getKittens(), "") + .setFirstResult(0).setMaxResults(10) + .list();]]></programlisting> + + </sect2> + + <sect2 id="objecstate-querying-criteria" revision="1"> + <title>Criteria queries</title> + + <para> + HQL is extremely powerful but some developers prefer to build queries dynamically, + using an object-oriented API, rather than building query strings. Hibernate provides + an intuitive <literal>Criteria</literal> query API for these cases: + </para> + + <programlisting><![CDATA[Criteria crit = session.createCriteria(Cat.class); +crit.add( Restrictions.eq( "color", eg.Color.BLACK ) ); +crit.setMaxResults(10); +List cats = crit.list();]]></programlisting> + + <para> + The <literal>Criteria</literal> and the associated <literal>Example</literal> + API are discussed in more detail in <xref linkend="querycriteria"/>. + </para> + + </sect2> + + <sect2 id="objectstate-querying-nativesql" revision="2"> + <title>Queries in native SQL</title> + + <para> + You may express a query in SQL, using <literal>createSQLQuery()</literal> and + let Hibernate take care of the mapping from result sets to objects. Note + that you may at any time call <literal>session.connection()</literal> and + use the JDBC <literal>Connection</literal> directly. If you chose to use the + Hibernate API, you must enclose SQL aliases in braces: + </para> + + <programlisting><![CDATA[List cats = session.createSQLQuery("SELECT {cat.*} FROM CAT {cat} WHERE ROWNUM<10") + .addEntity("cat", Cat.class) +.list();]]></programlisting> + + <programlisting><![CDATA[List cats = session.createSQLQuery( + "SELECT {cat}.ID AS {cat.id}, {cat}.SEX AS {cat.sex}, " + + "{cat}.MATE AS {cat.mate}, {cat}.SUBCLASS AS {cat.class}, ... " + + "FROM CAT {cat} WHERE ROWNUM<10") + .addEntity("cat", Cat.class) +.list()]]></programlisting> + + <para> + SQL queries may contain named and positional parameters, just like Hibernate queries. + More information about native SQL queries in Hibernate can be found in + <xref linkend="querysql"/>. + </para> + + </sect2> + + </sect1> + + <sect1 id="objectstate-modifying" revision="1"> + <title>Modifying persistent objects</title> + + <para> + <emphasis>Transactional persistent instances</emphasis> (ie. objects loaded, saved, created or + queried by the <literal>Session</literal>) may be manipulated by the application + and any changes to persistent state will be persisted when the <literal>Session</literal> + is <emphasis>flushed</emphasis> (discussed later in this chapter). There is no need + to call a particular method (like <literal>update()</literal>, which has a different + purpose) to make your modifications persistent. So the most straightforward way to update + the state of an object is to <literal>load()</literal> it, + and then manipulate it directly, while the <literal>Session</literal> is open: + </para> + + <programlisting><![CDATA[DomesticCat cat = (DomesticCat) sess.load( Cat.class, new Long(69) ); +cat.setName("PK"); +sess.flush(); // changes to cat are automatically detected and persisted]]></programlisting> + + <para> + Sometimes this programming model is inefficient since it would require both an SQL + <literal>SELECT</literal> (to load an object) and an SQL <literal>UPDATE</literal> + (to persist its updated state) in the same session. Therefore Hibernate offers an + alternate approach, using detached instances. + </para> + + <para> + <emphasis>Note that Hibernate does not offer its own API for direct execution of + <literal>UPDATE</literal> or <literal>DELETE</literal> statements. Hibernate is a + <emphasis>state management</emphasis> service, you don't have to think in + <emphasis>statements</emphasis> to use it. JDBC is a perfect API for executing + SQL statements, you can get a JDBC <literal>Connection</literal> at any time + by calling <literal>session.connection()</literal>. Furthermore, the notion + of mass operations conflicts with object/relational mapping for online + transaction processing-oriented applications. Future versions of Hibernate + may however provide special mass operation functions. See <xref linkend="batch"/> + for some possible batch operation tricks.</emphasis> + </para> + + </sect1> + + <sect1 id="objectstate-detached" revision="2"> + <title>Modifying detached objects</title> + + <para> + Many applications need to retrieve an object in one transaction, send it to the + UI layer for manipulation, then save the changes in a new transaction. + Applications that use this kind of approach in a high-concurrency environment + usually use versioned data to ensure isolation for the "long" unit of work. + </para> + + <para> + Hibernate supports this model by providing for reattachment of detached instances + using the <literal>Session.update()</literal> or <literal>Session.merge()</literal> + methods: + </para> + + <programlisting><![CDATA[// in the first session +Cat cat = (Cat) firstSession.load(Cat.class, catId); +Cat potentialMate = new Cat(); +firstSession.save(potentialMate); + +// in a higher layer of the application +cat.setMate(potentialMate); + +// later, in a new session +secondSession.update(cat); // update cat +secondSession.update(mate); // update mate]]></programlisting> + + <para> + If the <literal>Cat</literal> with identifier <literal>catId</literal> had already + been loaded by <literal>secondSession</literal> when the application tried to + reattach it, an exception would have been thrown. + </para> + + <para> + Use <literal>update()</literal> if you are sure that the session does + not contain an already persistent instance with the same identifier, and + <literal>merge()</literal> if you want to merge your modifications at any time + without consideration of the state of the session. In other words, <literal>update()</literal> + is usually the first method you would call in a fresh session, ensuring that + reattachment of your detached instances is the first operation that is executed. + </para> + + <para> + The application should individually <literal>update()</literal> detached instances + reachable from the given detached instance if and <emphasis>only</emphasis> if it wants + their state also updated. This can be automated of course, using <emphasis>transitive + persistence</emphasis>, see <xref linkend="objectstate-transitive"/>. + </para> + + <para> + The <literal>lock()</literal> method also allows an application to reassociate + an object with a new session. However, the detached instance has to be unmodified! + </para> + + <programlisting><![CDATA[//just reassociate: +sess.lock(fritz, LockMode.NONE); +//do a version check, then reassociate: +sess.lock(izi, LockMode.READ); +//do a version check, using SELECT ... FOR UPDATE, then reassociate: +sess.lock(pk, LockMode.UPGRADE);]]></programlisting> + + <para> + Note that <literal>lock()</literal> can be used with various + <literal>LockMode</literal>s, see the API documentation and the + chapter on transaction handling for more information. Reattachment is not + the only usecase for <literal>lock()</literal>. + </para> + + <para> + Other models for long units of work are discussed in <xref linkend="transactions-optimistic"/>. + </para> + + </sect1> + + <sect1 id="objectstate-saveorupdate"> + <title>Automatic state detection</title> + + <para> + Hibernate users have requested a general purpose method that either saves a + transient instance by generating a new identifier or updates/reattaches + the detached instances associated with its current identifier. + The <literal>saveOrUpdate()</literal> method implements this functionality. + </para> + + <programlisting><![CDATA[// in the first session +Cat cat = (Cat) firstSession.load(Cat.class, catID); + +// in a higher tier of the application +Cat mate = new Cat(); +cat.setMate(mate); + +// later, in a new session +secondSession.saveOrUpdate(cat); // update existing state (cat has a non-null id) +secondSession.saveOrUpdate(mate); // save the new instance (mate has a null id)]]></programlisting> + + <para> + The usage and semantics of <literal>saveOrUpdate()</literal> seems to be confusing + for new users. Firstly, so long as you are not trying to use instances from one session + in another new session, you should not need to use <literal>update()</literal>, + <literal>saveOrUpdate()</literal>, or <literal>merge()</literal>. Some whole + applications will never use either of these methods. + </para> + + <para> + Usually <literal>update()</literal> or <literal>saveOrUpdate()</literal> are used in + the following scenario: + </para> + + <itemizedlist spacing="compact"> + <listitem> + <para> + the application loads an object in the first session + </para> + </listitem> + <listitem> + <para> + the object is passed up to the UI tier + </para> + </listitem> + <listitem> + <para> + some modifications are made to the object + </para> + </listitem> + <listitem> + <para> + the object is passed back down to the business logic tier + </para> + </listitem> + <listitem> + <para> + the application persists these modifications by calling + <literal>update()</literal> in a second session + </para> + </listitem> + </itemizedlist> + + <para> + <literal>saveOrUpdate()</literal> does the following: + </para> + + <itemizedlist spacing="compact"> + <listitem> + <para> + if the object is already persistent in this session, do nothing + </para> + </listitem> + <listitem> + <para> + if another object associated with the session has the same identifier, + throw an exception + </para> + </listitem> + <listitem> + <para> + if the object has no identifier property, <literal>save()</literal> it + </para> + </listitem> + <listitem> + <para> + if the object's identifier has the value assigned to a newly instantiated + object, <literal>save()</literal> it + </para> + </listitem> + <listitem> + <para> + if the object is versioned (by a <literal><version></literal> or + <literal><timestamp></literal>), and the version property value + is the same value assigned to a newly instantiated object, + <literal>save()</literal> it + </para> + </listitem> + <listitem> + <para> + otherwise <literal>update()</literal> the object + </para> + </listitem> + </itemizedlist> + + <para> + and <literal>merge()</literal> is very different: + </para> + + <itemizedlist spacing="compact"> + <listitem> + <para> + if there is a persistent instance with the same identifier currently + associated with the session, copy the state of the given object onto + the persistent instance + </para> + </listitem> + <listitem> + <para> + if there is no persistent instance currently associated with the session, + try to load it from the database, or create a new persistent instance + </para> + </listitem> + <listitem> + <para> + the persistent instance is returned + </para> + </listitem> + <listitem> + <para> + the given instance does not become associated with the session, it + remains detached + </para> + </listitem> + </itemizedlist> + + </sect1> + + <sect1 id="objectstate-deleting" revision="1"> + <title>Deleting persistent objects</title> + + <para> + <literal>Session.delete()</literal> will remove an object's state from the database. + Of course, your application might still hold a reference to a deleted object. + It's best to think of <literal>delete()</literal> as making a persistent instance + transient. + </para> + + <programlisting><![CDATA[sess.delete(cat);]]></programlisting> + + <para> + You may delete objects in any order you like, without risk of foreign key + constraint violations. It is still possible to violate a <literal>NOT + NULL</literal> constraint on a foreign key column by deleting objects in + the wrong order, e.g. if you delete the parent, but forget to delete the + children. + </para> + + </sect1> + + <sect1 id="objectstate-replicating" revision="1"> + <title>Replicating object between two different datastores</title> + + <para> + It is occasionally useful to be able to take a graph of persistent instances + and make them persistent in a different datastore, without regenerating identifier + values. + </para> + + <programlisting><![CDATA[//retrieve a cat from one database +Session session1 = factory1.openSession(); +Transaction tx1 = session1.beginTransaction(); +Cat cat = session1.get(Cat.class, catId); +tx1.commit(); +session1.close(); + +//reconcile with a second database +Session session2 = factory2.openSession(); +Transaction tx2 = session2.beginTransaction(); +session2.replicate(cat, ReplicationMode.LATEST_VERSION); +tx2.commit(); +session2.close();]]></programlisting> + + <para> + The <literal>ReplicationMode</literal> determines how <literal>replicate()</literal> + will deal with conflicts with existing rows in the database. + </para> + + <itemizedlist spacing="compact"> + <listitem> + <para> + <literal>ReplicationMode.IGNORE</literal> - ignore the object when there is + an existing database row with the same identifier + </para> + </listitem> + <listitem> + <para> + <literal>ReplicationMode.OVERWRITE</literal> - overwrite any existing database + row with the same identifier + </para> + </listitem> + <listitem> + <para> + <literal>ReplicationMode.EXCEPTION</literal> - throw an exception if there is + an existing database row with the same identifier + </para> + </listitem> + <listitem> + <para> + <literal>ReplicationMode.LATEST_VERSION</literal> - overwrite the row if its + version number is earlier than the version number of the object, or ignore + the object otherwise + </para> + </listitem> + </itemizedlist> + + <para> + Usecases for this feature include reconciling data entered into different database + instances, upgrading system configuration information during product upgrades, + rolling back changes made during non-ACID transactions and more. + </para> + + </sect1> + + <sect1 id="objectstate-flushing"> + <title>Flushing the Session</title> + + <para> + From time to time the <literal>Session</literal> will execute the SQL statements + needed to synchronize the JDBC connection's state with the state of objects held in + memory. This process, <emphasis>flush</emphasis>, occurs by default at the following + points + </para> + + <itemizedlist spacing="compact"> + <listitem> + <para> + before some query executions + </para> + </listitem> + <listitem> + <para> + from <literal>org.hibernate.Transaction.commit()</literal> + </para> + </listitem> + <listitem> + <para> + from <literal>Session.flush()</literal> + </para> + </listitem> + </itemizedlist> + + <para> + The SQL statements are issued in the following order + </para> + + <orderedlist spacing="compact"> + <listitem> + <para> + all entity insertions, in the same order the corresponding objects + were saved using <literal>Session.save()</literal> + </para> + </listitem> + <listitem> + <para> + all entity updates + </para> + </listitem> + <listitem> + <para> + all collection deletions + </para> + </listitem> + <listitem> + <para> + all collection element deletions, updates and insertions + </para> + </listitem> + <listitem> + <para> + all collection insertions + </para> + </listitem> + <listitem> + <para> + all entity deletions, in the same order the corresponding objects + were deleted using <literal>Session.delete()</literal> + </para> + </listitem> + </orderedlist> + + <para> + (An exception is that objects using <literal>native</literal> ID generation are + inserted when they are saved.) + </para> + + <para> + Except when you explicity <literal>flush()</literal>, there are absolutely no + guarantees about <emphasis>when</emphasis> the <literal>Session</literal> executes + the JDBC calls, only the <emphasis>order</emphasis> in which they are executed. + However, Hibernate does guarantee that the <literal>Query.list(..)</literal> + will never return stale data; nor will they return the wrong data. + </para> + + <para> + It is possible to change the default behavior so that flush occurs less frequently. + The <literal>FlushMode</literal> class defines three different modes: only flush + at commit time (and only when the Hibernate <literal>Transaction</literal> API + is used), flush automatically using the explained routine, or never flush unless + <literal>flush()</literal> is called explicitly. The last mode is useful for long running + units of work, where a <literal>Session</literal> is kept open and disconnected for + a long time (see <xref linkend="transactions-optimistic-longsession"/>). + </para> + + <programlisting><![CDATA[sess = sf.openSession(); +Transaction tx = sess.beginTransaction(); +sess.setFlushMode(FlushMode.COMMIT); // allow queries to return stale state + +Cat izi = (Cat) sess.load(Cat.class, id); +izi.setName(iznizi); + +// might return stale data +sess.find("from Cat as cat left outer join cat.kittens kitten"); + +// change to izi is not flushed! +... +tx.commit(); // flush occurs +sess.close();]]></programlisting> + + <para> + During flush, an exception might occur (e.g. if a DML operation violates a constraint). + Since handling exceptions involves some understanding of Hibernate's transactional + behavior, we discuss it in <xref linkend="transactions"/>. + </para> + + </sect1> + + <sect1 id="objectstate-transitive" revision="1"> + <title>Transitive persistence</title> + + <para> + It is quite cumbersome to save, delete, or reattach individual objects, + especially if you deal with a graph of associated objects. A common case is + a parent/child relationship. Consider the following example: + </para> + + <para> + If the children in a parent/child relationship would be value typed (e.g. a collection + of addresses or strings), their life cycle would depend on the parent and no + further action would be required for convenient "cascading" of state changes. + When the parent is saved, the value-typed child objects are saved as + well, when the parent is deleted, the children will be deleted, etc. This + even works for operations such as the removal of a child from the collection; + Hibernate will detect this and, since value-typed objects can't have shared + references, delete the child from the database. + </para> + + <para> + Now consider the same scenario with parent and child objects being entities, + not value-types (e.g. categories and items, or parent and child cats). Entities + have their own life cycle, support shared references (so removing an entity from + the collection does not mean it can be deleted), and there is by default no + cascading of state from one entity to any other associated entities. Hibernate + does not implement <emphasis>persistence by reachability</emphasis> by default. + </para> + + <para> + For each basic operation of the Hibernate session - including <literal>persist(), merge(), + saveOrUpdate(), delete(), lock(), refresh(), evict(), replicate()</literal> - there is a + corresponding cascade style. Respectively, the cascade styles are named <literal>create, + merge, save-update, delete, lock, refresh, evict, replicate</literal>. If you want an + operation to be cascaded along an association, you must indicate that in the mapping + document. For example: + </para> + + <programlisting><![CDATA[<one-to-one name="person" cascade="persist"/>]]></programlisting> + + <para> + Cascade styles my be combined: + </para> + + <programlisting><![CDATA[<one-to-one name="person" cascade="persist,delete,lock"/>]]></programlisting> + + <para> + You may even use <literal>cascade="all"</literal> to specify that <emphasis>all</emphasis> + operations should be cascaded along the association. The default <literal>cascade="none"</literal> + specifies that no operations are to be cascaded. + </para> + + <para> + A special cascade style, <literal>delete-orphan</literal>, applies only to one-to-many + associations, and indicates that the <literal>delete()</literal> operation should + be applied to any child object that is removed from the association. + </para> + + + <para> + Recommendations: + </para> + + <itemizedlist spacing="compact"> + <listitem> + <para> + It doesn't usually make sense to enable cascade on a <literal><many-to-one></literal> + or <literal><many-to-many></literal> association. Cascade is often useful for + <literal><one-to-one></literal> and <literal><one-to-many></literal> + associations. + </para> + </listitem> + <listitem> + <para> + If the child object's lifespan is bounded by the lifespan of the parent + object, make it a <emphasis>life cycle object</emphasis> by specifying + <literal>cascade="all,delete-orphan"</literal>. + </para> + </listitem> + <listitem> + <para> + Otherwise, you might not need cascade at all. But if you think that you will often be + working with the parent and children together in the same transaction, and you want to save + yourself some typing, consider using <literal>cascade="persist,merge,save-update"</literal>. + </para> + </listitem> + </itemizedlist> + + <para> + Mapping an association (either a single valued association, or a collection) with + <literal>cascade="all"</literal> marks the association as a + <emphasis>parent/child</emphasis> style relationship where save/update/delete of the + parent results in save/update/delete of the child or children. + </para> + <para> + Futhermore, a mere reference to a child from a persistent parent will result in + save/update of the child. This metaphor is incomplete, however. A child which becomes + unreferenced by its parent is <emphasis>not</emphasis> automatically deleted, except + in the case of a <literal><one-to-many></literal> association mapped with + <literal>cascade="delete-orphan"</literal>. The precise semantics of cascading + operations for a parent/child relationship are as follows: + </para> + + <itemizedlist spacing="compact"> + <listitem> + <para> + If a parent is passed to <literal>persist()</literal>, all children are passed to + <literal>persist()</literal> + </para> + </listitem> + <listitem> + <para> + If a parent is passed to <literal>merge()</literal>, all children are passed to + <literal>merge()</literal> + </para> + </listitem> + <listitem> + <para> + If a parent is passed to <literal>save()</literal>, <literal>update()</literal> or + <literal>saveOrUpdate()</literal>, all children are passed to <literal>saveOrUpdate()</literal> + </para> + </listitem> + <listitem> + <para> + If a transient or detached child becomes referenced by a persistent parent, + it is passed to <literal>saveOrUpdate()</literal> + </para> + </listitem> + <listitem> + <para> + If a parent is deleted, all children are passed to <literal>delete()</literal> + </para> + </listitem> + <listitem> + <para> + If a child is dereferenced by a persistent parent, <emphasis>nothing + special happens</emphasis> - the application should explicitly delete + the child if necessary - unless <literal>cascade="delete-orphan"</literal>, + in which case the "orphaned" child is deleted. + </para> + </listitem> + </itemizedlist> + + <para> + Finally, note that cascading of operations can be applied to an object graph at + <emphasis>call time</emphasis> or at <emphasis>flush time</emphasis>. All operations, + if enabled, are cascaded to associated entities reachable when the operation is + executed. However, <literal>save-upate</literal> and <literal>delete-orphan</literal> + are transitive for all associated entities reachable during flush of the + <literal>Session</literal>. + </para> + + </sect1> + + <sect1 id="objectstate-metadata"> + <title>Usando metadados</title> + + <para> + O Hibernate requer um modelo muito rico a nível de metadados de todas as entidades e tipos de + valores. De tempos em tempos, este modelo é muito útil à própria aplicação. Por exemplo, a + aplicação pode usar o metadados do Hibernate que executa um algoritmo "inteligente" que + compreende quais objetos podem ser copiados (por exemplo, tipos de valores mutáveis) ou + não (por exemplo, tipos de valores imutáveis e, possivelmente, entidades associadas). + </para> + <para> + O Hibernate expõe o metadados via interfaces <literal>ClassMetadata</literal> + e <literal>CollectionMetadata</literal> e pela hierarquia <literal>Type</literal>. + Instâncias das interfaces de metadados podem ser obtidas a partir do + <literal>SessionFactory</literal>. + </para> + + <programlisting><![CDATA[Cat fritz = ......; +ClassMetadata catMeta = sessionfactory.getClassMetadata(Cat.class); + +Object[] propertyValues = catMeta.getPropertyValues(fritz); +String[] propertyNames = catMeta.getPropertyNames(); +Type[] propertyTypes = catMeta.getPropertyTypes(); + +// get a Map of all properties which are not collections or associations +Map namedValues = new HashMap(); +for ( int i=0; i<propertyNames.length; i++ ) { + if ( !propertyTypes[i].isEntityType() && !propertyTypes[i].isCollectionType() ) { + namedValues.put( propertyNames[i], propertyValues[i] ); + } +}]]></programlisting> + + </sect1> + +</chapter> + Modified: core/trunk/documentation/manual/pt-BR/src/main/docbook/content/toolset_guide.xml =================================================================== --- core/trunk/documentation/manual/pt-BR/src/main/docbook/content/toolset_guide.xml 2007-10-26 00:46:38 UTC (rev 14135) +++ core/trunk/documentation/manual/pt-BR/src/main/docbook/content/toolset_guide.xml 2007-10-26 00:48:48 UTC (rev 14136) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="toolsetguide" revision="2"> +<chapter id="toolsetguide" revision="2"> <title>Toolset Guide</title> <para> Modified: core/trunk/documentation/manual/pt-BR/src/main/docbook/content/transactions.xml =================================================================== --- core/trunk/documentation/manual/pt-BR/src/main/docbook/content/transactions.xml 2007-10-26 00:46:38 UTC (rev 14135) +++ core/trunk/documentation/manual/pt-BR/src/main/docbook/content/transactions.xml 2007-10-26 00:48:48 UTC (rev 14136) @@ -1,1150 +1,1148 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="transactions" revision="2"> - <title>Transações e Concorrência</title> - - <para> - O ponto o mais importante sobre o Hibernate e o controle de concorrência é que é muito - fácil de ser compreendido. O Hibernate usa diretamente conexões de JDBC e recursos de - JTA sem adicionar nenhum comportamento de bloqueio a mais. Nós altamente recomendamos - que você gaste algum tempo com o JDBC, o ANSI e a especificação de isolamento de transação - de seu sistema de gerência da base de dados. - </para> - - <para> - O Hibernate não bloqueia objetos na memória. Sua aplicação pode esperar o comportamento - tal qual definido pelo nível de isolamento de suas transações de banco de dados. - Note que graças ao <literal>Session</literal>, que também é um cache de escopo de - transação, o Hibernate fornece leituras repetíveis para procurar por identificadores - e consultas de entidade (não pesquisas de relatórios que retornam valores escalares). - </para> - - <para> - Além do versionamento para o controle automático de concorrência otimista, o Hibernate - oferece também uma API (menor) para bloqueio pessimista de linhas usando a sintaxe - <literal>SELECT FOR UPDATE</literal>. O controle de concorrência otimista e esta - API são discutidos mais tarde neste capítulo. - </para> - - <para> - Nós começamos a discussão do controle de concorrência no Hibernate com a granularidade - do <literal>Configuration</literal>, <literal>SessionFactory</literal>, e - <literal>Session</literal>, além de transações de base de dados e conversações longas. - </para> - - <sect1 id="transactions-basics" revision="1"> - <title>Session e escopos de transações</title> - - <para> - Um <literal>SessionFactory</literal> é objeto threadsafe compartilhado por - todas as threads da aplicação que consome muitos recursos na sua criação. - É criado uma unica vez no inicio da execução da aplicação a partir da - instância de uma <literal>Configuration</literal>. - </para> - - <para> - Uma <literal>Session</literal> é um objeto de baixo custo de criação, não é threadsafe, - deve ser usado uma vez, para uma única requisição, uma conversação, uma única unidade - do trabalho e então deve ser descartado. Um <literal>Session</literal> não obterá um - JDBC <literal>Connection</literal> (ou um <literal>Datasource</literal>) a menos que - necessite, conseqüentemente não consome nenhum recurso até ser usado. - </para> - - <para> - Para completar, você também tem que pensar sobre as transações de base de dados. - Uma transação tem que ser tão curta quanto possível, para reduzir a disputa pelo - bloqueio na base de dados. Transações longas impedirão que sua aplicação escale a - carga altamente concorrente. Por isso, em um projeto raramente é para manter - uma transação de base de dados aberta durante o tempo que o usuário pensa, - até que a unidade do trabalho esteja completa. - </para> - - <para> - Qual é o escopo de uma unidade de trabalho? Pode uma únicoa <literal>Session</literal> - do Hibernate gerenciar diversas transações ou é esta um o relacionamento um-para-um dos - escopos? Quando deve você abrir e fechar uma <literal>Session</literal> e como você - demarca os limites da transação? - </para> - - <sect2 id="transactions-basics-uow" revision="1"> - <title>Unidade de trabalho</title> - - <para> - Primeiro, não use o antipattern <emphasis>sessão-por-operação</emphasis>, - isto é, não abra e não feche uma <literal>Session</literal> para cada simples chamada - ao banco de de dados em uma única thread! Naturalmente, o mesmo é verdadeiro para - transações. As chamadas a banco de dados em uma aplicação são feitas usando uma - seqüência planejada, elas são agrupadas em unidades de trabalho atômicas. - (Veja que isso também significa que um auto-commit depois de cada sentença SQL é - inútil em uma aplicação, esta modalidade é ideal para o trabalho ad hoc do console - do SQL. O Hibernate impede, ou espera que o servidor de aplicação impessa isso, - o uso da modalidade de auto-commit.) As transações nunca são opcionais, toda a - comunicação com um banco de dados tem que ocorrer dentro de uma transação, não - importa se você vai ler ou escrever dados. Como explicado, o comportamento auto-commit - para leitura de dados deve ser evitado, como muitas transações pequenas são - improváveis de executar melhor do que uma unidade claramente definida do trabalho. A - última opção também muito mais manutenível e extensível. - </para> - - <para> - O pattern mais comum em uma aplicação multi-usuário cliente/servidor é - <emphasis>sessão-por-requisição</emphasis>. Neste modelo, uma requisição do cliente é - enviada ao servidor (onde a camada de persistência do Hibernate roda), uma - <literal>Session</literal> nova do Hibernate é aberta, e todas as operações da base de - dados são executadas nesta unidade do trabalho. Logo que o trabalho for completado - (e a resposta para o cliente for preparada), a sessão é descarregad e fechada. - Você usaria também uma única transação de base de dados para servir às requisições - dos clientes, começando e commitando-o quando você abre e fecha a <literal>Session</literal>. - O relacionamento entre os dois é um-para-um e este modelo é um ajuste perfeito para muitas - aplicações. - </para> - - <para> - O desafio encontra-se na implementação. O Hibernate fornece gerência integrada da "sessão atual" - para simplificar este pattern. Tudo que você tem que fazer é iniciar uma transação quando uma - requisição tem que ser processada e termina a transação antes que a resposta seja enviada ao - cliente. Você pode fazer onde quiser, soluções comuns são <literal>ServletFilter</literal>, - interceptador AOP com um pointcut (ponto de corte) nos métodos de serviço ou em um - container de proxy/interceptação. Um container de EJB é uma maneira padronizada para - implementar aspectos cross-cutting tais como a demarcação da transação em EJB session beans, - declarativamente com CMT. Se você se decidir usar demarcação programática de transação, - de preferencia a API <literal>Transaction</literal> do Hibernate mostrada mais adiante neste - capítulo, para fácilidade no uso e portabilidade de código. - </para> - - <para> - Seu código de aplicação pode acessar a "sessão atual" para processar a requisição - fazendo uma chamada simples a <literal>sessionFactory.getCurrentSession()</literal> em - qualquer lugar e com a frequencia necessária. Você sempre conseguirá uma - <literal>Session</literal> limitada a transação atual. Isto tem que ser configurado - para recurso local ou os ambientes JTA. Veja <xref linkend="architecture-current-session"/>. - </para> - - <para> - Às vezes é conveniente estender o escopo de uma <literal>Session</literal> e de - uma transação do banco de dados até que a "visão esteja renderizada". É especialmente - útil em aplicações servlet que utilizam uma fase de rendenderização separada depois - que a requisição ter sido processada. Estendendo a transação até que renderização da - visão esteja completa é fácil de fazer se você implementar seu próprio interceptador. - Entretanto, não se pode fazer facilmente se você confiar em EJBs com transações - gerenciadas por contêiner, porque uma transação será terminada quando um método de - EJB retornar, antes da renderização de toda visão puder começar. - Veja o website e o fórum do Hibernate para dicas e exemplos em torno deste - pattern <emphasis>Open Session in View</emphasis>. - - </para> - - </sect2> - - <sect2 id="transactions-basics-apptx" revision="1"> - <title>Longas conversações</title> - - <para> - O pattern sessão-por-requisição não é o único conceito útil que você pode usar ao projetar - unidades de trabalho. Muitos processos de negócio requerem uma totalidade de séries de - interações com o usuário intercaladas com acessos a uma base de dados. Em aplicações web - e corporativas não é aceitável para uma transação atrapalhe uma interação do usuário. - Considere o seguinte exemplo: - </para> - - <itemizedlist> - <listitem> - <para> - A primeira tela de um diálogo abre os dados carregado pelo usuário em através de - <literal>Session</literal> e transação particulares. O usuário está livre - modificar os objetos. - </para> - </listitem> - <listitem> - <para> - O usuário clica em "Salvar" após 5 minutos e espera suas modificações serem persistidas; - espera também que ele era a única pessoa que edita esta informação e que nenhuma - modificação conflitante possa ocorrer. - </para> - </listitem> - </itemizedlist> - - <para> - Nós chamamos esta unidade de trabalho, do ponto da visão do usuário, executando uma - longa <emphasis>conversação</emphasis> (ou <emphasis>transação da aplicação</emphasis>). - Há muitas maneiras de você pode implementar em sua aplicação. - - </para> - - <para> - Uma primeira implementação simples pode manter a<literal>Session</literal> e a transação - aberta durante o tempo de interação do usuário, com bloqueios na base de dados para impedir - a modificação concorrente e para garantir o isolamento e a atomicidade. Esse é naturalmente - um anti-pattern, desde que a disputa do bloqueio não permitiria o escalonameneto da - aplicação com o número de usuários concorrentes. - </para> - - <para> - Claramente, nós temos que usar diversas transações para implementar a conversação. - Neste caso, Manter o isolamento dos processos de negócio torna-se responsabilidade - parcial da camada da aplicação. Uma única conversação geralmente usa diversas transações. - Ela será atômica se somente uma destas transações (a última) armazenar os - dados atualizados, todas as outras simplesmente leram os dados (por exemplo em um - diálogo do estilo wizard que mede diversos ciclos de requisição/resposta). Isto é mais - fácil de implementar do que pode parecer, especialmente se você usar as - características do Hibernate: - </para> - - <itemizedlist> - <listitem> - <para> - <emphasis>Versionamento automático</emphasis> - O Hibernate pode fazer o - controle automático de concorrência otimista para você, ele pode - automaticamente detectar se uma modificação concorrente - ocorreu durante o tempo de interação do usuário. Geralmente nós verificamos - somente no fim da conversação. - </para> - </listitem> - <listitem> - <para> - <emphasis>Detached Objects</emphasis>- se você se decidir usar o já discutido - pattern <emphasis>session-per-request</emphasis>, todas as instâncias carregadas - estarão no estado destacado durante o tempo em que o usuário estiver pensando. - O Hibernate permite que você reatache os objetos e persita as modificações, - esse pattern é chamado - <emphasis>session-per-request-with-detached-objects</emphasis>. - É usado versionamento automatico para isolar as modificações concorrentes. - </para> - </listitem> - <listitem> - <para> - <emphasis>Extended (or Long) Session</emphasis> A <literal>Session</literal> - do Hibernate pode ser desligada da conexão básica do JDBC depois que a - transação foi commitada e ser reconectado quando uma nova requisição do - cliente ocorrer. Este pattern é conhecido como - <emphasis>session-per-conversation</emphasis> e faz o reatamento uniforme - desnecessário. Versionamento automático é usado para isolar modificações - concorrentes e a <emphasis>session-per-conversation</emphasis> usualmente - não é permitido para ser nivelado automaticamente, e sim explicitamente. - </para> - </listitem> - </itemizedlist> - - <para> - Ambos <emphasis>session-per-request-with-detached-objects</emphasis> e - <emphasis>session-per-conversation</emphasis> possuem vantagens e desvantagens, - nos discutiremos mais tarde neste capítulo no contexto do controle de - concorrência otimista. - </para> - - </sect2> - - <sect2 id="transactions-basics-identity"> - <title>Considerando a identidade do objeto</title> - - <para> - Uma aplicação pode acessar concorrentemente o mesmo estado persistente em duas - <literal>Session</literal>s diferentes. Entretanto, uma instância de uma classe - persistente nunca é compartilhada entre duas instâncias <literal>Session</literal>. - Por tanto, há duas noções diferentes da identidade: - </para> - - <variablelist spacing="compact"> - <varlistentry> - <term>Identidade da base de dados</term> - <listitem> - <para> - <literal>foo.getId().equals( bar.getId() )</literal> - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Identidade da JVM</term> - <listitem> - <para> - <literal>foo==bar</literal> - </para> - </listitem> - </varlistentry> - </variablelist> - - <para> - Então para os objetos acoplados a um <literal>Session</literal> em <literal>particular </literal> - (isto é no escopo de um <literal>Session</literal>), as duas noções são equivalentes e a - identidade da JVM para a identidade da base de dados é garantida pelo Hibernate. Entretanto, - quando a aplicação pode acessar concorrentemente o "mesmo" objeto do negócio (identidade - persistente) em duas sessões diferentes, as duas instâncias serão realmente "diferentes" - (identidade de JVM). Os conflitos são resolvidos usando (versionamento automático) no - flush/commit, usando abordagem otimista. - - </para> - - <para> - Este caminho deixa o Hibernate e o banco dedados se preocuparem com a concorrência; também - fornece uma escalabilidade melhor, garantindo que a identidade em unidades de trabalho - único-encadeadas não necessite de bloqueio dispendioso ou de outros meios de sincronização. - A aplicação nunca necessita sincronizar qualquer objeto de negócio tão longo que transpasse - uma única thread por <literal>Session</literal>. Dentro de uma <literal>Session</literal> a - aplicação pode usar com segurança o <literal>==</literal> para comparar objetos. - </para> - - <para> - Com tudo, uma aplicação que usa <literal>==</literal> fora de uma <literal>Session</literal>, - pode ver resultados inesperados. Isto pode ocorrer mesmo em alguns lugares inesperados, por - exemplo, se você colocar duas instâncias desacopladas em um mesmo <literal>Set</literal>. - Ambos podem ter a mesma identidade na base de dados (isto é eles representam a mesma linha - em uma tabela), mas a identidade da JVM pela definição não garantida para instâncias em estado - desacoplado. O desenvolvedor tem que sobrescrever os métodos <literal>equals()</literal> e - <literal>hashCode()</literal> em classes persistentes e implementar sua própria noção da - igualdade do objeto. Advertência: nunca use o identificador da base de dados para implementar - a igualdade, use atributos de negócio, uma combinação única, geralmente imutável. O - identificador da base de dados mudará se um objeto transiente passar para o estado persistente. - Se a instância transiente (geralmente junto com instâncias desacopladas) for inserida em um - <literal>Set</literal>, mudar o hashcode quebra o contrato do <literal>Set</literal>. - Atributos para chaves de negócio não têm que ser tão estável quanto às chaves primárias - da base de dados, você somente tem que garantir a estabilidade durante o tempo que - os objetos estiverem no mesmo Set. Veja o website do Hibernate para uma discussão mais - completa sobre o assunto. Note também que esta não é uma caracteristica do Hibernate, - mas simplesmente como a identidade e a igualdade do objeto de Java têm que ser implementadas. - </para> - - </sect2> - - <sect2 id="transactions-basics-issues"> - <title>Edições comuns</title> - - <para> - Nunca use o anti-patterns <emphasis>session-per-user-session</emphasis> ou - <emphasis>session-per-application</emphasis> (naturalmente, há umas exceções raras a - essa regra). Note que algumas das seguintes edições podem também aparecer com patterns - recomendados, certifique-se que tenha compreendido as implicações antes de fazer - uma decisão de projeto: - </para> - - <itemizedlist> - <listitem> - <para> - Uma <literal>Session</literal> não é threadsafe. As coisas que são supostas para trabalhar - concorrentemente, como requisições HTTP, session beans, ou Swing, causarão condições de - disputa se uma instância <literal>Session</literal> for compartilhada. Se você mantiver - sua <literal>Session</literal> do Hibernate em seu <literal>HttpSession</literal> - (discutido mais tarde), você deve considerar sincronizar o acesso a sua sessão do HTTP. - Caso contrário, um usuário que clica em reload várias muito rapidamente pode usar o - mesmo <literal>Session</literal> em duas threads executando concorrentemente. - </para> - </listitem> - <listitem> - <para> - Uma exceção lançada pelo Hibernate significa que você tem que dar rollback na sua - transação no banco de dados e fechar a <literal>Session</literal> imediatamente - (discutido mais tarde em maiores detalhes). Se sua <literal>Session</literal> é - limitado pela aplicação, você tem que parar a aplicação. Dando rollback na - transação no banco de dados não põe seus objetos do negócio em um estado anterior - que estavam no início da transação. Isto significa que o estado da base de dados - e os objetos de negócio perdem a sincronização. Geralmente não é um problema - porque as exceções não são recuperáveis e você tem que iniciar após o - rollback de qualquer maneira. - </para> - </listitem> - <listitem> - <para> - O <literal>Session</literal> guarda em cache cada objeto que está no estado persistente - (guardado e checado para estado "sujo" pelo Hibernate). Isto significa que ele cresce - infinitamente até que você obtenha uma OutOfMemoryException, se você o mantiver aberto - por muito tempo ou simplesmente carregar dados demais. Uma solução é chamar - <literal>clear()</literal> e <literal>evict()</literal> para controlar o cache - da <literal>Session</literal>, mas você deve considerar uma Store Procedure - se precisar de operações que envolvam grande volume de dados. Algumas soluções são - mostradas no <xref linkend="batch"/>. Manter uma <literal>Session</literal> aberta - durante uma sessão do usuário significa também uma probabilidade elevada de se acabar - com dados velhos. - </para> - </listitem> - </itemizedlist> - - </sect2> - - </sect1> - - <sect1 id="transactions-demarcation"> - <title>Demarcação de transações de bancos de dados</title> - - <para> - Os limites de uma transação de banco de dados (ou sistema) são sempre necessários. Nenhuma - comunicação com o banco de dados pode ocorrer fora de uma transação de banco de dados (isto - parece confundir muitos desenvolvedores que estão usados modo auto-commit). Sempre use os - limites desobstruídos da transação, até mesmo para operações somente leitura. Dependendo - de seu nível de isolamento e capacidade da base de dados isto pode não ser requerido, - mas não há nenhum aspecto negativo se você demarca sempre transações explicitamente. - Certamente, uma única transação será melhor executada do que muitas transações pequenas, - até mesmo para dados de leitura. - </para> - - <para> - Uma aplicação do Hibernate pode funcionar em ambientes não gerenciados (isto é aplicações standalone, Web - simples ou Swing) e ambientes gerenciados J2EE. Em um ambiente não gerenciado, o Hibernate é geralmente - responsável pelo seu próprio pool de conexões. O desenvolvedor tem que manualmente ajustar limites das - transaçãos, ou seja, começar, commitar, ou dar rollback nas transações ele mesmo. Um ambiente gerenciado - fornece transações gerenciadas por contêiner (CMT - container-managed transactions), com um conjunto - da transações definido declarativamente em descritores de deployment de EJB session beans, por exemplo. - A demarcação programática é então já não é necessário. - </para> - - <para> - Entretanto, é freqüentemente desejável manter sua camada de persistência portável entre ambientes - de recurso locais não gerenciados e sistemas que podem confiar em JTA, mas usar BMT em vez de CMT. - Em ambos os casos você usaria demarcação de transação programática. O Hibernate oferece uma API - chamada Transaction que traduz dentro do sistema de transação nativa de seu ambiente de deployment. - Esta API é realmente opcional, mas nós encorajamos fortemente seu uso a menos que você estiver - em um CMT session bean. - </para> - - <para> - Geralmente, finalizar um <literal>Session</literal>envolve quatro fases distintas: - </para> - - <itemizedlist spacing="compact"> - <listitem> - <para> - flush da sessão - </para> - </listitem> - <listitem> - <para> - commitar a transação - </para> - </listitem> - <listitem> - <para> - fechar a sessão - </para> - </listitem> - <listitem> - <para> - tratar as exceções - </para> - </listitem> - </itemizedlist> - - <para> - A limpeza da sessão já foi bem discutida, agora nós daremos uma olhada na demarcação da - transação e na manipulação de exceção em ambientes controlados e não controlados. - </para> - - - <sect2 id="transactions-demarcation-nonmanaged" revision="2"> - <title>Ambiente não gerenciado</title> - - <para> - Se uma camada de persistência do Hibernate roda em um ambiente não gerenciado, as conexões - do banco de dados são geralmente tratadas pelos pools de conexões simples - (isto é, não baseados em DataSource) dos quais o Hibernate obtém as conexões assim - que necessita. A maneira de se manipular uma sessão/transação é mais ou menos assim: - </para> - - <programlisting><![CDATA[// Non-managed environment idiom -Session sess = factory.openSession(); -Transaction tx = null; -try { - tx = sess.beginTransaction(); - - // do some work - ... - - tx.commit(); -} -catch (RuntimeException e) { - if (tx != null) tx.rollback(); - throw e; // or display error message -} -finally { - sess.close(); -}]]></programlisting> - - <para> - Você não pode chamar <literal>flush()</literal> do <literal>Session()</literal> - explicitamente - a chamada ao <literal>commit()</literal> dispara automaticamente - a sincronização para a sessão (dependendo do <xref linkend="objectstate-flushing"> - FlushMode</xref>). Uma chamada ao <literal>close()</literal> marca o fim de uma sessão. - A principal implicação do <literal>close()</literal> é que a conexão JDBC será abandonada - pela sessão. Este código Java é portável e funciona em ambientes não gerenciado e de JTA. - </para> - - <para> - Uma solução muito mais flexível é gerência integrada de contexto da "sessão atual" - do Hibernate, como descrito anteriormente: - </para> - - <programlisting><![CDATA[// Non-managed environment idiom with getCurrentSession() -try { - factory.getCurrentSession().beginTransaction(); - - // do some work - ... - - factory.getCurrentSession().getTransaction().commit(); -} -catch (RuntimeException e) { - factory.getCurrentSession().getTransaction().rollback(); - throw e; // or display error message -}]]></programlisting> - - <para> - Você muito provavelmente nunca verá estes fragmentos de código em uma aplicação - regular; as exceções fatais (do sistema) devem sempre ser pegas no "alto". - Ou seja, o código que executa chamadas do Hibernate (na camada de persistência) - e o código que trata <literal>RuntimeException</literal> (e geralmente pode - somente limpar acima e na saída) estão em camadas diferentes. O gerenciamento do - contexto atual feito pelo Hibernate pode significativamente simplificar este - projeto, como tudo que você necessita é do acesso a um <literal>SessionFactory</literal>. - A manipulação de exceção é discutida mais tarde neste capítulo. - </para> - - <para> - Note que você deve selecionar <literal>org.hibernate.transaction.JDBCTransactionFactory</literal> - (que é o padrão) e para o segundo exemplo <literal>"thread"</literal> como seu - <literal>hibernate.current_session_context_class</literal>. - </para> - - </sect2> - - <sect2 id="transactions-demarcation-jta" revision="3"> - <title>Usando JTA</title> - - <para> - Se sua camada de persistência funcionar em um servidor de aplicação (por exemplo, - dentro dos EJB session beans), cada conexão do datasource obtida pelo Hibernate - automaticamente fará parte da transação global de JTA. Você pode também instalar uma - implementação standalone de JTA e usá-la sem EJB. O Hibernate oferece duas estratégias - para a integração de JTA. - </para> - - <para> - Se você usar bean-managed transactions (BMT - transações gerenciadas por bean) o Hibernate dirá - ao servidor de aplicação para começar e para terminar uma transação de BMT se você usar a API - Transaction. Assim, o código de gerência de transação é idêntico ao ambiente não gerenciado. - </para> - - <programlisting><![CDATA[// BMT idiom -Session sess = factory.openSession(); -Transaction tx = null; -try { - tx = sess.beginTransaction(); - - // do some work - ... - - tx.commit(); -} -catch (RuntimeException e) { - if (tx != null) tx.rollback(); - throw e; // or display error message -} -finally { - sess.close(); -}]]></programlisting> - - <para> - Se você quiser usar um <literal>Session</literal> limitada por transação, isto é, - a funcionalidade do <literal>getCurrentSession()</literal> para a propagação fácil - do contexto, você terá que usar diretamente a API JTA <literal>UserTransaction</literal>: - </para> - - <programlisting><![CDATA[// BMT idiom with getCurrentSession() -try { - UserTransaction tx = (UserTransaction)new InitialContext() - .lookup("java:comp/UserTransaction"); - - tx.begin(); - - // Do some work on Session bound to transaction - factory.getCurrentSession().load(...); - factory.getCurrentSession().persist(...); - - tx.commit(); -} -catch (RuntimeException e) { - tx.rollback(); - throw e; // or display error message -}]]></programlisting> - - <para> - Com CMT, a demarcação da transação é feita em descritores de deployment do session beans, - não programaticamente, conseqüentemente, o código é reduzido a: - </para> - - <programlisting><![CDATA[// CMT idiom - Session sess = factory.getCurrentSession(); - - // do some work - ... -]]></programlisting> - - <para> - Em um CMT/EJB mesmo um rollback acontece automaticamente, desde que uma exeção <literal>RuntimeException</literal> - não tratável seja lançada por um método de um session bean que informa ao contêiner ajustar a - transação global ao rollback. <emphasis>Isto significa que você não necessita usar a API - <literal>Transaction</literal> do Hibernate em tudo com BMT ou CMT e você obtém a propagação - automática do Session "atual" limitada à transação.</emphasis> - </para> - - <para> - Veja que você deverá escolher <literal>org.hibernate.transaction.JTATransactionFactory</literal> - se você usar o JTA diretamente (BMT) e <literal>org.hibernate.transaction.CMTTransactionFactory</literal> - em um CMT session bean, quando você configura a fábrica de transação do Hibernate. Lembre-se também de - configurar o <literal>hibernate.transaction.manager_lookup_class</literal>. Além disso, certifique-se - que seu <literal>hibernate.current_session_context_class</literal> ou não é configurado (compatibilidade - com o legado) ou é definido para <literal>"jta"</literal>. - - </para> - - <para> - A operação <literal>getCurrentSession()</literal> tem um aspecto negativo em um ambiente JTA. - Há uma advertência para o uso do método liberado de conexão <literal>after_statement</literal>, - o qual é usado então por padrão. Devido a uma limitação simples da especificação JTA, não é - possível para o Hibernate automaticamente limpar quaisquer instâncias <literal>ScrollableResults</literal> - ou <literal>Iterator</literal> abertas retornadas pelo <literal>scroll()</literal> ou - <literal>iterate()</literal>. Você <emphasis>deve</emphasis> liberar o cursor subjacente da - base de dados chamando <literal>ScrollableResults.close()</literal> ou - <literal>Hibernate.close(Iterator)</literal> explicitamente de um bloco <literal>finally</literal>. - (Claro que a maioria de aplicações podem facilmente evitar o uso do <literal>scroll()</literal> ou - do <literal>iterate()</literal> em todo código provindo do JTA ou do CMT.) - - </para> - - </sect2> - - <sect2 id="transactions-demarcation-exceptions"> - <title>Tratamento de Exceção</title> - - <para> - Se a <literal>Session</literal> levantar uma exceção (incluindo qualquer - <literal>SQLException</literal>), você deve imediatamente dar um rollback - na transação do banco, chamando <literal>Session.close()</literal> e descartando - a instância da <literal>Session</literal>. Certos métodos da <literal>Session</literal> - <literal>não</literal> deixarão a sessão em um estado inconsistente. Nenhuma exceção - lançada pelo Hibernate pode ser recuperada. Certifique-se que a <literal>Session</literal> - será fechada chamando <literal>close()</literal> no bloco <literal>finally</literal>. - </para> - - <para> - A exceção <literal>HibernateException</literal>, a qual envolve a maioria dos erros - que podem ocorrer em uma camada de persistência do Hibernate, é uma exceção unchecked ( - não estava em umas versões mais antigas de Hibernate). Em nossa opinião, nós não devemos - forçar o desenvolvedor a tratar uma exceção irrecuperável em uma camada mais baixa. - Na maioria dos sistemas, as exceções unchecked e fatais são tratadas em um dos primeiros - frames da pilha da chamada do método (isto é, em umas camadas mais elevadas) e uma mensagem - de erro é apresentada ao usuário da aplicação (ou a alguma outra ação apropriada é feita). - Note que Hibernate pode também lançar outras exceções unchecked que não são um - <literal>HibernateException</literal>. Estas, também são, irrecuperáveis e uma ação - apropriada deve ser tomada. - </para> - - <para> - O Hibernate envolve <literal>SQLException</literal>s lançadas ao interagir com a base de dados - em um <literal>JDBCException</literal>. Na realidade, o Hibernate tentará converter a exceção em - em uma sub classe mais significativa da <literal>JDBCException</literal>. A - <literal>SQLException</literal> subjacente está sempre disponível através de - <literal>JDBCException.getCause()</literal>. - </para> - - <para> - O Hibernate converte a <literal>SQLException</literal> em uma sub classe - <literal>JDBCException</literal> apropriada usando <literal>SQLExceptionConverter</literal> - associado ao SessionFactory. Por padrão, o <literal>SQLExceptionConverter</literal> é definido - pelo dialeto configurado; entretanto, é também possível conectar em uma implementação customizada - (veja o javadoc para mais detalhes da classe <literal>SQLExceptionConverterFactory</literal>). - Os subtipos padrão de <literal>JDBCException</literal> são: - </para> - - <itemizedlist spacing="compact"> - <listitem> - <para> - <literal>JDBCConnectionException</literal> - indica um erro com a comunicação subjacente de JDBC. - </para> - </listitem> - <listitem> - <para> - <literal>SQLGrammarException</literal> - indica um problema da gramática ou da sintaxe com o SQL emitido. - </para> - </listitem> - <listitem> - <para> - <literal>ConstraintViolationException</literal> - indica algum forma de violação de confinamento de integridade. - </para> - </listitem> - <listitem> - <para> - <literal>LockAcquisitionException</literal> - indica um erro ao adquirir um nível de bloqueio necessário para realizar a operação de requisição. - </para> - </listitem> - <listitem> - <para> - <literal>GenericJDBCException</literal> - uma exceção genérica que não cai em algumas das outras categorias. - </para> - </listitem> - </itemizedlist> - - </sect2> - - <sect2 id="transactions-demarcation-timeout"> - <title>Timeout de Transação</title> - - <para> - Uma característica extremamente importante fornecida por um ambiente - gerenciado como EJB e que nunca é fornecido pelo código não gerenciado é o timeout - de transação. Timeouts de transação asseguram que nenhuma transação possa - reter indefinidamente recursos enquanto não retorna nenhuma resposta ao usuário. - Fora de um ambiente controlado (JTA), o Hibernate não pode fornecer inteiramente - esta funcionalidade. Entretanto, o Hibernate pode afinal controlar as operações - do acesso a dados, assegurando que o nível de deadlocks e queries do banco de - dados com imensos resultados definidos sejam limitados pelo timeout. Em um ambiente - gerenciado, o Hibernate pode delegar o timeout da transação ao JTA. Esta funcionalidade - é abstraída pelo objeto <literal>Transaction</literal> do Hibernate. - </para> - - <programlisting><![CDATA[ -Session sess = factory.openSession(); -try { - //set transaction timeout to 3 seconds - sess.getTransaction().setTimeout(3); - sess.getTransaction().begin(); - - // do some work - ... - - sess.getTransaction().commit() -} -catch (RuntimeException e) { - sess.getTransaction().rollback(); - throw e; // or display error message -} -finally { - sess.close(); -}]]></programlisting> - - <para> - Veja que <literal>setTimeout()</literal> não pode ser chamado em um CMT bean, - onde os timeouts das transações devem ser definidos declarativamente. - </para> - - </sect2> - - </sect1> - - <sect1 id="transactions-optimistic"> - <title>Controle de concorrência otimista</title> - - <para> - O único caminho que é consistente com a elevada concorrência e escalabilidade - é controle de concorrência otimista com versionamento. Checagem de versão usa - número de versão, ou timestamps, para detectar conflitos de atualizações (e para - impedir atualizações perdidas). O Hibernate fornece três caminhos possíveis para - escrever aplicações que usam concorrência otimista. Os casos de uso que nós mostramos - estão no contexto de conversações longas, mas a checagem de versão também tem o - benefício de impedir atualizações perdidas em únicas transações. - </para> - - <sect2 id="transactions-optimistic-manual"> - <title>Checagem de versão da aplicação</title> - - <para> - Em uma implementação sem muita ajuda do Hibernate, cada interação com o banco de dados - ocorre em uma nova <literal>Session</literal> e o desenvolvedor é responsável para - recarregar todas as instâncias persistentes da base de dados antes de manipulá-las. - Este caminho força a aplicação a realizar sua própria checagem de versão para assegurar - a conversação do isolamento da transação. Este caminho é menos eficiente em termos de - acesso ao banco de dados. É a caminho mais similar a EJBs entity. - </para> - - <programlisting><![CDATA[// foo is an instance loaded by a previous Session -session = factory.openSession(); -Transaction t = session.beginTransaction(); - -int oldVersion = foo.getVersion(); -session.load( foo, foo.getKey() ); // load the current state -if ( oldVersion != foo.getVersion() ) throw new StaleObjectStateException(); -foo.setProperty("bar"); - -t.commit(); -session.close();]]></programlisting> - - <para> - A propriedade <literal>version</literal> é mapeada usando <literal><version></literal>, - e o Hibernate vai incrementá-lo-á automaticamente durante o flush se a entidade - estiver alterada. - </para> - - <para> - Claro, se você se estiver operando em um ambiente de baixa concorrência de dados - e não requerer a checagem de versão, você pode usar este caminho e apenas saltar a - checagem de versão. Nesse caso, o <emphasis>ultimo commit realizdo </emphasis> é - a estratégia padrão para suas conversações longas. Mantenha em mente que isto pode - confundir os usuários da aplicação, assim como eles podem experimentar atualizações - perdidas sem mensagens de erro ou uma possibilidade ajustar mudanças de conflito. - - </para> - - <para> - Claro que, checagem manual da versão é somente praticável em circunstâncias triviais - e não para a maioria de aplicações. Freqüentemente, os grafos completos de objetos - modificados têm que ser verificados, não somente únicas instâncias. O Hibernate oferece - checagem de versão automática com uma <literal>Session</literal> estendida ou instâncias - desatachadas como o paradigma do projeto. - </para> - - </sect2> - - <sect2 id="transactions-optimistic-longsession"> - <title>Sessão estendida e versionamento automático</title> - - <para> - Uma única instância de <literal>Session</literal> e suas instâncias persistentes - são usadas para a conversação inteira, isto é conhecido como - <emphasis>session-per-conversation</emphasis>. O Hibernate verifica versões da instância - no momento dio flush, lançando uma exceção se a modificação concorrente for detectada. - Até o desenvolvedor pegar e tratar essa exceção (as opções comuns são a oportunidade - para que o usuário intercale as mudanças ou reinicie a conversação do negócio com - dados não antigos). - </para> - - <para> - The <literal>Session</literal> is disconnected from any underlying JDBC connection - when waiting for user interaction. This approach is the most efficient in terms - of database access. The application need not concern itself with version checking or - with reattaching detached instances, nor does it have to reload instances in every - database transaction. - A <literal>Session</literal> é desconectada de toda a conexão JDBC subjacente - enquanto espera a interação do usuário. Este caminho é a mais eficiente em termos - de acesso a bancos de dados. A aplicação não necessita concernir-se com a checagem - de versão ou com as instâncias destacadas reatadas, nem tem que recarregar instâncias - em cada transação. - </para> - - <programlisting><![CDATA[// foo is an instance loaded earlier by the old session -Transaction t = session.beginTransaction(); // Obtain a new JDBC connection, start transaction - -foo.setProperty("bar"); - -session.flush(); // Only for last transaction in conversation -t.commit(); // Also return JDBC connection -session.close(); // Only for last transaction in conversation]]></programlisting> - <para> - O objeto <literal>foo</literal> sabe que <literal>Session</literal> já foi carregada. Começando - uma nova transação em uma sessão velha obtém uma conexão nova e recomeça a sessão. Commitando - uma transação desconecta uma sessão da conexão JDBC e retorna a conexão ao pool. Após a reconexão, - forçar uma checagem de versão em dados que você não está atualizando, você pode chamar - <literal>Session.lock()</literal> com o <literal>LockMode.READ</literal> em todos os objetos - que possam ter sido atualizados por uma outra transação. Você não necessita bloquear nenhum - dado para atualizar. Geralmente você configuraria <literal>FlushMode.MANUAL</literal> em uma - <literal>Session</literal> estendida, de modo que somente o último ciclo da transação tenha - permissão de persistir todas as modificações feitas nesta conversação. Disso, somente esta última - transação incluiria a operação <literal>flush()</literal> e então chamar também <literal>close()</literal> - da sessão para terminar a conversação. - </para> - - <para> - Este pattern é problemático se a <literal>Session</literal> for demasiadamente grande para - ser armazenado durante o tempo que usuário pensar, por exemplo um <literal>HttpSession</literal> - estiver mantido tão pequeno quanto possível. Como o <literal>Session</literal> é também cache - de primeiro nível (imperativo) e contém todos os objetos carregados, nós podemos provavelmente - usar esta estratégia somente para alguns ciclos de requisição/resposta. Você deve usar a - <literal>Session</literal> somente para uma única conversação, porque ela logo também - estará com dados velhos. - </para> - - <para> - (Note que versões mais atuais de Hibernate requerem a desconexão e o reconexão explícitas de - uma <literal>Session</literal>. Estes métodos são desatualizados, como o início e término de - uma transação tem o mesmo efeito.) - </para> - - <para> - Note também que você deve manter a <literal>Session</literal> desconectada fechada - para a camada de persistência. Ou seja, use um EJB stateful session bean para - prender a <literal>Session</literal> em um ambiente do três camadas e não o - transferir à camada web (ou até serializá-lo para uma camada separada) - para armazená-lo no <literal>HttpSession</literal>. - - </para> - - <para> - O pattern sessão estendida, ou <emphasis>session-per-conversation</emphasis>, é mais - difícil de implementar com gerenciamento automático de sessão atual. Você precisa fornecer - sua própria implementação do <literal>CurrentSessionContext</literal> para isto - (veja o Hibernate Wiki para exemplos). - </para> - - </sect2> - - <sect2 id="transactions-optimistic-detached"> - <title>Objetos destacados e versionamento automático</title> - - <para> - Cada interação com o armazenamento persistente ocorre em uma <literal>Session</literal> nova. - Entretanto, as mesmas instâncias persistentes são reusadas para cada interação com o banco de dados. - A aplicação manipula o estado das instâncias desatachadas originalmente carregadas em um outro - <literal>Session</literal> e reata-os então usando <literal>Session.update()</literal>, - <literal>Session.saveOrUpdate()</literal> ou <literal>Session.merge()</literal>. - </para> - - <programlisting><![CDATA[// foo is an instance loaded by a previous Session -foo.setProperty("bar"); -session = factory.openSession(); -Transaction t = session.beginTransaction(); -session.saveOrUpdate(foo); // Use merge() if "foo" might have been loaded already -t.commit(); -session.close();]]></programlisting> - - <para> - Outra vez, o Hibernate verificará versões da instância durante o flush, - lançando uma exceção se ocorrer conflitos de atualizações. - </para> - - <para> - Você pode também chamar o <literal>lock()</literal> em vez de <literal>update()</literal> - e usar <literal>LockMode.READ</literal> (executando uma checagem de versão, ignorando - todos os caches) se você estiver certo de que o objeto não foi modificado. - </para> - - </sect2> - - <sect2 id="transactions-optimistic-customizing"> - <title>Versionamento automático customizado</title> - - <para> - Você pode desabilitar o incremento da versão automática de Hibernate para propriedades - e coleções particulares configurando o mapeamento do atributo <literal>optimistic-lock</literal> - para false. O Hibernate então não irá incrementa versões se a propriedade estiver - modificada. - </para> - - <para> - Os esquemas da base de dados legada são freqüentemente estáticos e não podem ser modificados. - Ou outras aplicações puderam também acessar a mesma base de dados e não sabem tratar a - versão dos números ou timestamps. Em ambos os casos, o versionamento não pode confiar em uma - coluna particular em uma tabela. Para forçar uma checagem de versão sem uma versão ou mapeamento - da propriedade do timestamp com uma comparação do estado de todos os campos em uma linha, - configure <literal>optimistic-lock="all"</literal> no mapeamento <literal><class></literal>. - Note que isto conceitualmente é somente feito em trabalhos se Hibernate puder comparar o estado - velho e novo, isto é, se você usa um único <literal>Session</literal> longo e não - session-per-request-with-detached-objects. - </para> - - <para> - Às vezes a modificação concorrente pode ser permitida tão longa quanto às mudanças que - tiveram sido feitas que não sobrepuseram. Se você configurar <literal>optimistic-lock="dirty"</literal> - ao mapear o <literal><class></literal>, o Hibernate comparará somente campos - modificados durante o flush. - </para> - - <para> - Em ambos os casos, com as colunas dedicadas da versão/timestamp ou com comparação do - campo cheio/modificados, o Hibernate usa uma única declaração UPDATE (com uma cláusula - WHERE apropriada ) por entidade para executar a checagem da versão e atualizar a informação. - Se você usa a persistência transitiva para cascatear o reatamento das entidades associadas, - o Hibernate pode executar atualizações desnecessárias. Isso não é geralmente um problema, - mas triggers <emphasis>on update</emphasis> em um banco de dados podem ser executados - mesmo quando nenhuma mudança foi feita nas instâncias destacadas. Você pode customizar - este comportamento configurando <literal>select-before-update="true"</literal> no - mapeamento <literal><class></literal>, forçando o Hibernate a dá um SELECT nas - instâncias para assegurar-se esse as mudanças ocorreram realmente, antes de atualizar - a linha. - </para> - - </sect2> - - </sect1> - - <sect1 id="transactions-locking"> - <title>Locking pessimista</title> - - <para> - Não se pretende que os usuários gastam muitas horas se preocupando com suas estratégias de - locking. Geralmente é o bastante para especificar um nível de isolamento para as conexões - JDBC e então deixar simplesmente o banco de dados fazer todo o trabalho. Entretanto, os - usuários avançados podem às vezes desejar obter locks pessimistas exclusivos, ou re-obter - locks no início de uma nova transação. - </para> - - <para> - O Hibernate usará sempre o mecanismo de lock da base de dados, nunca trava objetos - na memória! - </para> - - <para> - A classe <literal>LockMode</literal> define os diferentes níveis de lock que o Hibernate - pode adquirir. Um lock é obtido pelos seguintes mecanismos: - - </para> - - <itemizedlist spacing="compact"> - <listitem> - <para> - <literal>LockMode.WRITE</literal> é adquirido automaticamente quando o Hibernate atualiza - ou insere uma linha. - </para> - </listitem> - <listitem> - <para> - <literal>LockMode.UPGRADE</literal> pode ser adquirido explicitamente pelo usuário - usando <literal>SELECT ... FOR UPDATE</literal> em um banco de dados que suporte - esse sintaxe. - </para> - </listitem> - <listitem> - <para> - <literal>LockMode.UPGRADE_NOWAIT</literal> pode ser adquirido explicitamente pelo usuário - usando <literal>SELECT ... FOR UPDATE NOWAIT</literal> no Oracle. - - </para> - </listitem> - <listitem> - <para> - <literal>LockMode.READ</literal> é adquirido automaticamente quando o Hibernate lê - dados em um nível Repeatable Read ou Serializable isolation. Pode ser readquirido - explicitamente pelo usuário. - </para> - </listitem> - <listitem> - <para> - <literal>LockMode.NONE</literal> representa a ausência do lock. Todos os objetos mudam para - esse estado de lock no final da <literal>Transaction</literal>. Objetos associados com a sessão - através do método <literal>update()</literal> ou <literal>saveOrUpdate()</literal> também são - inicializados com esse lock mode. - </para> - </listitem> - </itemizedlist> - - <para> - O lock obtido "explicitamente pelo usuário" se dá em uma das seguintes maneiras: - </para> - - <itemizedlist spacing="compact"> - <listitem> - <para> - Uma chamada a <literal>Session.load()</literal>, especificando - o <literal>LockMode</literal>. - </para> - </listitem> - <listitem> - <para> - Uma chamada a <literal>Session.lock()</literal>. - </para> - </listitem> - <listitem> - <para> - Uma chamada a <literal>Query.setLockMode()</literal>. - </para> - </listitem> - </itemizedlist> - - <para> - Se uma <literal>Session.load()</literal> é invocada com <literal>UPGRADE</literal> ou - <literal>UPGRADE_NOWAIT</literal>, e o objeto requisitado ainda não foi carregado - pela sessão, o objeto é carregado usando <literal>SELECT ... FOR UPDATE</literal>. - Se <literal>load()</literal> for chamado para um objeto que já foi carregado - com um lock menos restritivo que o novo lock solicitado, o Hibernate invoca o - método <literal>lock()</literal> para aquele objeto. - </para> - - <para> - O método <literal>Session.lock()</literal> executa uma verificação no número da versão - se o modo de lock especificado for <literal>READ</literal>, <literal>UPGRADE</literal> ou - <literal>UPGRADE_NOWAIT</literal>.. (No caso do <literal>UPGRADE</literal> ou - <literal>UPGRADE_NOWAIT</literal>, é usado <literal>SELECT ... FOR UPDATE</literal>.) - </para> - - <para> - Se o banco de dados não suportar o lock mode solicitado, o Hibernate vai usar um modo - alternativo apropriado (ao invés de lançar uma exceção). Isso garante que a aplicação - vai ser portável. - </para> - - </sect1> - - <sect1 id="transactions-connection-release"> - <title>Modos de liberar a Connection</title> - - <para> - O comportamento legado do Hibernate (2.x) em consideração ao gerenciamento da conexão - via JDBC fez com que a <literal>Session</literal> precisasse obter uma conexão - quando ela precisasse pela primeira vez e depois manter a conexão enquanto - a sessão não fosse fechada. O Hibernate 3.x introduz a idéia de modos de liberar a - sessão, para informar a sessão a forma como deve manusear a sua conexão JDBC. - Veja que essa discussão só é pertinente para conexões fornecidas com um - <literal>ConnectionProvider</literal> configurado; conexões fornecidas pelo usuário - estão fora do escopo dessa discussão. Os diferentes modos de liberação estão definidos - pelos valores da enumeração - <literal>org.hibernate.ConnectionReleaseMode</literal>: - - </para> - - <itemizedlist spacing="compact"> - <listitem> - <para> - <literal>ON_CLOSE</literal> - essencialmente é o modo legado descrito acima. A sessão - do Hibernate obtêm a conexão quando precisar executar alguma operação JDBC pela - primeira vez e mantem enquanto a conexão não for fechada. - </para> - </listitem> - <listitem> - <para> - <literal>AFTER_TRANSACTION</literal> – informa que a conexão deve ser - liberada após a conclusão de uma <literal>org.hibernate.Transaction</literal>. - </para> - </listitem> - <listitem> - <para> - <literal>AFTER_STATEMENT</literal> (também conhecida com liberação agressiva) – informa - que a conexão deve ser liberada após a execução de cada statement. A liberação agressiva - não ocorre se o statement deixa pra trás algum recurso aberto associado com a sessão - obtida; atualmente, a única situação em que isso é possível é com o uso de - <literal>org.hibernate.ScrollableResults</literal>. - </para> - </listitem> - </itemizedlist> - - <para> - O parâmetro de configuração <literal>hibernate.connection.release_mode</literal> é usado - para especificar qual modo de liberação deve ser usado. Opções disponíveis: - </para> - - <itemizedlist spacing="compact"> - <listitem> - <para> - <literal>auto</literal> (padrão) – essa opção delega ao modo de liberação retornado pelo - método <literal>org.hibernate.transaction.TransactionFactory.getDefaultReleaseMode()</literal>. - Para JTATransactionFactory, ele retorna ConnectionReleaseMode.AFTER_STATEMENT; para - JDBCTransactionFactory, ele retorna ConnectionReleaseMode.AFTER_TRANSACTION. - Raramente é uma boa idéia alterar padrão, como frequencia ao se fazer isso temos falhas - que parecem bugs e/ou suposições inválidas no código do usuário. - </para> - </listitem> - <listitem> - <para> - <literal>on_close</literal> - indica o uso da ConnectionReleaseMode.ON_CLOSE. Essa opção - foi deixada para manter a compatibilidade, mas seu uso é fortemente desencorajado. - </para> - </listitem> - <listitem> - <para> - <literal>after_transaction</literal> – indica o uso da ConnectionReleaseMode.AFTER_TRANSACTION. - Essa opção nada deve ser usada com ambientes JTA. Também note que no caso da - ConnectionReleaseMode.AFTER_TRANSACTION, se a sessão foi colocada no modo auto-commit a - conexão vai ser liberada de forma similar ao modo AFTER_STATEMENT. - </para> - </listitem> - <listitem> - <para> - <literal>after_statement</literal> – indica o uso ConnectionReleaseMode.AFTER_STATEMENT. - Adicionalmente, o <literal>ConnectionProvider</literal> configurado é consultado para - verificar se suporta essa configuração ((<literal>supportsAggressiveRelease()</literal>). - Se não suportar, o modo de liberação é redefinido como ConnectionRelease-Mode.AFTER_TRANSACTION. - Essa configuração só é segura em ambientes onde podemos readquirir a mesma conexão JDBC - toda vez que o método <literal>ConnectionProvider.getConnection()</literal> for chamado ou - em um ambiente auto-commit onde não importa se nós recuperamos a mesma conexão. - </para> - </listitem> - </itemizedlist> - - </sect1> - -</chapter> - +<chapter id="transactions" revision="2"> + <title>Transações e Concorrência</title> + + <para> + O ponto o mais importante sobre o Hibernate e o controle de concorrência é que é muito + fácil de ser compreendido. O Hibernate usa diretamente conexões de JDBC e recursos de + JTA sem adicionar nenhum comportamento de bloqueio a mais. Nós altamente recomendamos + que você gaste algum tempo com o JDBC, o ANSI e a especificação de isolamento de transação + de seu sistema de gerência da base de dados. + </para> + + <para> + O Hibernate não bloqueia objetos na memória. Sua aplicação pode esperar o comportamento + tal qual definido pelo nível de isolamento de suas transações de banco de dados. + Note que graças ao <literal>Session</literal>, que também é um cache de escopo de + transação, o Hibernate fornece leituras repetíveis para procurar por identificadores + e consultas de entidade (não pesquisas de relatórios que retornam valores escalares). + </para> + + <para> + Além do versionamento para o controle automático de concorrência otimista, o Hibernate + oferece também uma API (menor) para bloqueio pessimista de linhas usando a sintaxe + <literal>SELECT FOR UPDATE</literal>. O controle de concorrência otimista e esta + API são discutidos mais tarde neste capítulo. + </para> + + <para> + Nós começamos a discussão do controle de concorrência no Hibernate com a granularidade + do <literal>Configuration</literal>, <literal>SessionFactory</literal>, e + <literal>Session</literal>, além de transações de base de dados e conversações longas. + </para> + + <sect1 id="transactions-basics" revision="1"> + <title>Session e escopos de transações</title> + + <para> + Um <literal>SessionFactory</literal> é objeto threadsafe compartilhado por + todas as threads da aplicação que consome muitos recursos na sua criação. + É criado uma unica vez no inicio da execução da aplicação a partir da + instância de uma <literal>Configuration</literal>. + </para> + + <para> + Uma <literal>Session</literal> é um objeto de baixo custo de criação, não é threadsafe, + deve ser usado uma vez, para uma única requisição, uma conversação, uma única unidade + do trabalho e então deve ser descartado. Um <literal>Session</literal> não obterá um + JDBC <literal>Connection</literal> (ou um <literal>Datasource</literal>) a menos que + necessite, conseqüentemente não consome nenhum recurso até ser usado. + </para> + + <para> + Para completar, você também tem que pensar sobre as transações de base de dados. + Uma transação tem que ser tão curta quanto possível, para reduzir a disputa pelo + bloqueio na base de dados. Transações longas impedirão que sua aplicação escale a + carga altamente concorrente. Por isso, em um projeto raramente é para manter + uma transação de base de dados aberta durante o tempo que o usuário pensa, + até que a unidade do trabalho esteja completa. + </para> + + <para> + Qual é o escopo de uma unidade de trabalho? Pode uma únicoa <literal>Session</literal> + do Hibernate gerenciar diversas transações ou é esta um o relacionamento um-para-um dos + escopos? Quando deve você abrir e fechar uma <literal>Session</literal> e como você + demarca os limites da transação? + </para> + + <sect2 id="transactions-basics-uow" revision="1"> + <title>Unidade de trabalho</title> + + <para> + Primeiro, não use o antipattern <emphasis>sessão-por-operação</emphasis>, + isto é, não abra e não feche uma <literal>Session</literal> para cada simples chamada + ao banco de de dados em uma única thread! Naturalmente, o mesmo é verdadeiro para + transações. As chamadas a banco de dados em uma aplicação são feitas usando uma + seqüência planejada, elas são agrupadas em unidades de trabalho atômicas. + (Veja que isso também significa que um auto-commit depois de cada sentença SQL é + inútil em uma aplicação, esta modalidade é ideal para o trabalho ad hoc do console + do SQL. O Hibernate impede, ou espera que o servidor de aplicação impessa isso, + o uso da modalidade de auto-commit.) As transações nunca são opcionais, toda a + comunicação com um banco de dados tem que ocorrer dentro de uma transação, não + importa se você vai ler ou escrever dados. Como explicado, o comportamento auto-commit + para leitura de dados deve ser evitado, como muitas transações pequenas são + improváveis de executar melhor do que uma unidade claramente definida do trabalho. A + última opção também muito mais manutenível e extensível. + </para> + + <para> + O pattern mais comum em uma aplicação multi-usuário cliente/servidor é + <emphasis>sessão-por-requisição</emphasis>. Neste modelo, uma requisição do cliente é + enviada ao servidor (onde a camada de persistência do Hibernate roda), uma + <literal>Session</literal> nova do Hibernate é aberta, e todas as operações da base de + dados são executadas nesta unidade do trabalho. Logo que o trabalho for completado + (e a resposta para o cliente for preparada), a sessão é descarregad e fechada. + Você usaria também uma única transação de base de dados para servir às requisições + dos clientes, começando e commitando-o quando você abre e fecha a <literal>Session</literal>. + O relacionamento entre os dois é um-para-um e este modelo é um ajuste perfeito para muitas + aplicações. + </para> + + <para> + O desafio encontra-se na implementação. O Hibernate fornece gerência integrada da "sessão atual" + para simplificar este pattern. Tudo que você tem que fazer é iniciar uma transação quando uma + requisição tem que ser processada e termina a transação antes que a resposta seja enviada ao + cliente. Você pode fazer onde quiser, soluções comuns são <literal>ServletFilter</literal>, + interceptador AOP com um pointcut (ponto de corte) nos métodos de serviço ou em um + container de proxy/interceptação. Um container de EJB é uma maneira padronizada para + implementar aspectos cross-cutting tais como a demarcação da transação em EJB session beans, + declarativamente com CMT. Se você se decidir usar demarcação programática de transação, + de preferencia a API <literal>Transaction</literal> do Hibernate mostrada mais adiante neste + capítulo, para fácilidade no uso e portabilidade de código. + </para> + + <para> + Seu código de aplicação pode acessar a "sessão atual" para processar a requisição + fazendo uma chamada simples a <literal>sessionFactory.getCurrentSession()</literal> em + qualquer lugar e com a frequencia necessária. Você sempre conseguirá uma + <literal>Session</literal> limitada a transação atual. Isto tem que ser configurado + para recurso local ou os ambientes JTA. Veja <xref linkend="architecture-current-session"/>. + </para> + + <para> + Às vezes é conveniente estender o escopo de uma <literal>Session</literal> e de + uma transação do banco de dados até que a "visão esteja renderizada". É especialmente + útil em aplicações servlet que utilizam uma fase de rendenderização separada depois + que a requisição ter sido processada. Estendendo a transação até que renderização da + visão esteja completa é fácil de fazer se você implementar seu próprio interceptador. + Entretanto, não se pode fazer facilmente se você confiar em EJBs com transações + gerenciadas por contêiner, porque uma transação será terminada quando um método de + EJB retornar, antes da renderização de toda visão puder começar. + Veja o website e o fórum do Hibernate para dicas e exemplos em torno deste + pattern <emphasis>Open Session in View</emphasis>. + + </para> + + </sect2> + + <sect2 id="transactions-basics-apptx" revision="1"> + <title>Longas conversações</title> + + <para> + O pattern sessão-por-requisição não é o único conceito útil que você pode usar ao projetar + unidades de trabalho. Muitos processos de negócio requerem uma totalidade de séries de + interações com o usuário intercaladas com acessos a uma base de dados. Em aplicações web + e corporativas não é aceitável para uma transação atrapalhe uma interação do usuário. + Considere o seguinte exemplo: + </para> + + <itemizedlist> + <listitem> + <para> + A primeira tela de um diálogo abre os dados carregado pelo usuário em através de + <literal>Session</literal> e transação particulares. O usuário está livre + modificar os objetos. + </para> + </listitem> + <listitem> + <para> + O usuário clica em "Salvar" após 5 minutos e espera suas modificações serem persistidas; + espera também que ele era a única pessoa que edita esta informação e que nenhuma + modificação conflitante possa ocorrer. + </para> + </listitem> + </itemizedlist> + + <para> + Nós chamamos esta unidade de trabalho, do ponto da visão do usuário, executando uma + longa <emphasis>conversação</emphasis> (ou <emphasis>transação da aplicação</emphasis>). + Há muitas maneiras de você pode implementar em sua aplicação. + + </para> + + <para> + Uma primeira implementação simples pode manter a<literal>Session</literal> e a transação + aberta durante o tempo de interação do usuário, com bloqueios na base de dados para impedir + a modificação concorrente e para garantir o isolamento e a atomicidade. Esse é naturalmente + um anti-pattern, desde que a disputa do bloqueio não permitiria o escalonameneto da + aplicação com o número de usuários concorrentes. + </para> + + <para> + Claramente, nós temos que usar diversas transações para implementar a conversação. + Neste caso, Manter o isolamento dos processos de negócio torna-se responsabilidade + parcial da camada da aplicação. Uma única conversação geralmente usa diversas transações. + Ela será atômica se somente uma destas transações (a última) armazenar os + dados atualizados, todas as outras simplesmente leram os dados (por exemplo em um + diálogo do estilo wizard que mede diversos ciclos de requisição/resposta). Isto é mais + fácil de implementar do que pode parecer, especialmente se você usar as + características do Hibernate: + </para> + + <itemizedlist> + <listitem> + <para> + <emphasis>Versionamento automático</emphasis> - O Hibernate pode fazer o + controle automático de concorrência otimista para você, ele pode + automaticamente detectar se uma modificação concorrente + ocorreu durante o tempo de interação do usuário. Geralmente nós verificamos + somente no fim da conversação. + </para> + </listitem> + <listitem> + <para> + <emphasis>Detached Objects</emphasis>- se você se decidir usar o já discutido + pattern <emphasis>session-per-request</emphasis>, todas as instâncias carregadas + estarão no estado destacado durante o tempo em que o usuário estiver pensando. + O Hibernate permite que você reatache os objetos e persita as modificações, + esse pattern é chamado + <emphasis>session-per-request-with-detached-objects</emphasis>. + É usado versionamento automatico para isolar as modificações concorrentes. + </para> + </listitem> + <listitem> + <para> + <emphasis>Extended (or Long) Session</emphasis> A <literal>Session</literal> + do Hibernate pode ser desligada da conexão básica do JDBC depois que a + transação foi commitada e ser reconectado quando uma nova requisição do + cliente ocorrer. Este pattern é conhecido como + <emphasis>session-per-conversation</emphasis> e faz o reatamento uniforme + desnecessário. Versionamento automático é usado para isolar modificações + concorrentes e a <emphasis>session-per-conversation</emphasis> usualmente + não é permitido para ser nivelado automaticamente, e sim explicitamente. + </para> + </listitem> + </itemizedlist> + + <para> + Ambos <emphasis>session-per-request-with-detached-objects</emphasis> e + <emphasis>session-per-conversation</emphasis> possuem vantagens e desvantagens, + nos discutiremos mais tarde neste capítulo no contexto do controle de + concorrência otimista. + </para> + + </sect2> + + <sect2 id="transactions-basics-identity"> + <title>Considerando a identidade do objeto</title> + + <para> + Uma aplicação pode acessar concorrentemente o mesmo estado persistente em duas + <literal>Session</literal>s diferentes. Entretanto, uma instância de uma classe + persistente nunca é compartilhada entre duas instâncias <literal>Session</literal>. + Por tanto, há duas noções diferentes da identidade: + </para> + + <variablelist spacing="compact"> + <varlistentry> + <term>Identidade da base de dados</term> + <listitem> + <para> + <literal>foo.getId().equals( bar.getId() )</literal> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Identidade da JVM</term> + <listitem> + <para> + <literal>foo==bar</literal> + </para> + </listitem> + </varlistentry> + </variablelist> + + <para> + Então para os objetos acoplados a um <literal>Session</literal> em <literal>particular </literal> + (isto é no escopo de um <literal>Session</literal>), as duas noções são equivalentes e a + identidade da JVM para a identidade da base de dados é garantida pelo Hibernate. Entretanto, + quando a aplicação pode acessar concorrentemente o "mesmo" objeto do negócio (identidade + persistente) em duas sessões diferentes, as duas instâncias serão realmente "diferentes" + (identidade de JVM). Os conflitos são resolvidos usando (versionamento automático) no + flush/commit, usando abordagem otimista. + + </para> + + <para> + Este caminho deixa o Hibernate e o banco dedados se preocuparem com a concorrência; também + fornece uma escalabilidade melhor, garantindo que a identidade em unidades de trabalho + único-encadeadas não necessite de bloqueio dispendioso ou de outros meios de sincronização. + A aplicação nunca necessita sincronizar qualquer objeto de negócio tão longo que transpasse + uma única thread por <literal>Session</literal>. Dentro de uma <literal>Session</literal> a + aplicação pode usar com segurança o <literal>==</literal> para comparar objetos. + </para> + + <para> + Com tudo, uma aplicação que usa <literal>==</literal> fora de uma <literal>Session</literal>, + pode ver resultados inesperados. Isto pode ocorrer mesmo em alguns lugares inesperados, por + exemplo, se você colocar duas instâncias desacopladas em um mesmo <literal>Set</literal>. + Ambos podem ter a mesma identidade na base de dados (isto é eles representam a mesma linha + em uma tabela), mas a identidade da JVM pela definição não garantida para instâncias em estado + desacoplado. O desenvolvedor tem que sobrescrever os métodos <literal>equals()</literal> e + <literal>hashCode()</literal> em classes persistentes e implementar sua própria noção da + igualdade do objeto. Advertência: nunca use o identificador da base de dados para implementar + a igualdade, use atributos de negócio, uma combinação única, geralmente imutável. O + identificador da base de dados mudará se um objeto transiente passar para o estado persistente. + Se a instância transiente (geralmente junto com instâncias desacopladas) for inserida em um + <literal>Set</literal>, mudar o hashcode quebra o contrato do <literal>Set</literal>. + Atributos para chaves de negócio não têm que ser tão estável quanto às chaves primárias + da base de dados, você somente tem que garantir a estabilidade durante o tempo que + os objetos estiverem no mesmo Set. Veja o website do Hibernate para uma discussão mais + completa sobre o assunto. Note também que esta não é uma caracteristica do Hibernate, + mas simplesmente como a identidade e a igualdade do objeto de Java têm que ser implementadas. + </para> + + </sect2> + + <sect2 id="transactions-basics-issues"> + <title>Edições comuns</title> + + <para> + Nunca use o anti-patterns <emphasis>session-per-user-session</emphasis> ou + <emphasis>session-per-application</emphasis> (naturalmente, há umas exceções raras a + essa regra). Note que algumas das seguintes edições podem também aparecer com patterns + recomendados, certifique-se que tenha compreendido as implicações antes de fazer + uma decisão de projeto: + </para> + + <itemizedlist> + <listitem> + <para> + Uma <literal>Session</literal> não é threadsafe. As coisas que são supostas para trabalhar + concorrentemente, como requisições HTTP, session beans, ou Swing, causarão condições de + disputa se uma instância <literal>Session</literal> for compartilhada. Se você mantiver + sua <literal>Session</literal> do Hibernate em seu <literal>HttpSession</literal> + (discutido mais tarde), você deve considerar sincronizar o acesso a sua sessão do HTTP. + Caso contrário, um usuário que clica em reload várias muito rapidamente pode usar o + mesmo <literal>Session</literal> em duas threads executando concorrentemente. + </para> + </listitem> + <listitem> + <para> + Uma exceção lançada pelo Hibernate significa que você tem que dar rollback na sua + transação no banco de dados e fechar a <literal>Session</literal> imediatamente + (discutido mais tarde em maiores detalhes). Se sua <literal>Session</literal> é + limitado pela aplicação, você tem que parar a aplicação. Dando rollback na + transação no banco de dados não põe seus objetos do negócio em um estado anterior + que estavam no início da transação. Isto significa que o estado da base de dados + e os objetos de negócio perdem a sincronização. Geralmente não é um problema + porque as exceções não são recuperáveis e você tem que iniciar após o + rollback de qualquer maneira. + </para> + </listitem> + <listitem> + <para> + O <literal>Session</literal> guarda em cache cada objeto que está no estado persistente + (guardado e checado para estado "sujo" pelo Hibernate). Isto significa que ele cresce + infinitamente até que você obtenha uma OutOfMemoryException, se você o mantiver aberto + por muito tempo ou simplesmente carregar dados demais. Uma solução é chamar + <literal>clear()</literal> e <literal>evict()</literal> para controlar o cache + da <literal>Session</literal>, mas você deve considerar uma Store Procedure + se precisar de operações que envolvam grande volume de dados. Algumas soluções são + mostradas no <xref linkend="batch"/>. Manter uma <literal>Session</literal> aberta + durante uma sessão do usuário significa também uma probabilidade elevada de se acabar + com dados velhos. + </para> + </listitem> + </itemizedlist> + + </sect2> + + </sect1> + + <sect1 id="transactions-demarcation"> + <title>Demarcação de transações de bancos de dados</title> + + <para> + Os limites de uma transação de banco de dados (ou sistema) são sempre necessários. Nenhuma + comunicação com o banco de dados pode ocorrer fora de uma transação de banco de dados (isto + parece confundir muitos desenvolvedores que estão usados modo auto-commit). Sempre use os + limites desobstruídos da transação, até mesmo para operações somente leitura. Dependendo + de seu nível de isolamento e capacidade da base de dados isto pode não ser requerido, + mas não há nenhum aspecto negativo se você demarca sempre transações explicitamente. + Certamente, uma única transação será melhor executada do que muitas transações pequenas, + até mesmo para dados de leitura. + </para> + + <para> + Uma aplicação do Hibernate pode funcionar em ambientes não gerenciados (isto é aplicações standalone, Web + simples ou Swing) e ambientes gerenciados J2EE. Em um ambiente não gerenciado, o Hibernate é geralmente + responsável pelo seu próprio pool de conexões. O desenvolvedor tem que manualmente ajustar limites das + transaçãos, ou seja, começar, commitar, ou dar rollback nas transações ele mesmo. Um ambiente gerenciado + fornece transações gerenciadas por contêiner (CMT - container-managed transactions), com um conjunto + da transações definido declarativamente em descritores de deployment de EJB session beans, por exemplo. + A demarcação programática é então já não é necessário. + </para> + + <para> + Entretanto, é freqüentemente desejável manter sua camada de persistência portável entre ambientes + de recurso locais não gerenciados e sistemas que podem confiar em JTA, mas usar BMT em vez de CMT. + Em ambos os casos você usaria demarcação de transação programática. O Hibernate oferece uma API + chamada Transaction que traduz dentro do sistema de transação nativa de seu ambiente de deployment. + Esta API é realmente opcional, mas nós encorajamos fortemente seu uso a menos que você estiver + em um CMT session bean. + </para> + + <para> + Geralmente, finalizar um <literal>Session</literal>envolve quatro fases distintas: + </para> + + <itemizedlist spacing="compact"> + <listitem> + <para> + flush da sessão + </para> + </listitem> + <listitem> + <para> + commitar a transação + </para> + </listitem> + <listitem> + <para> + fechar a sessão + </para> + </listitem> + <listitem> + <para> + tratar as exceções + </para> + </listitem> + </itemizedlist> + + <para> + A limpeza da sessão já foi bem discutida, agora nós daremos uma olhada na demarcação da + transação e na manipulação de exceção em ambientes controlados e não controlados. + </para> + + + <sect2 id="transactions-demarcation-nonmanaged" revision="2"> + <title>Ambiente não gerenciado</title> + + <para> + Se uma camada de persistência do Hibernate roda em um ambiente não gerenciado, as conexões + do banco de dados são geralmente tratadas pelos pools de conexões simples + (isto é, não baseados em DataSource) dos quais o Hibernate obtém as conexões assim + que necessita. A maneira de se manipular uma sessão/transação é mais ou menos assim: + </para> + + <programlisting><![CDATA[// Non-managed environment idiom +Session sess = factory.openSession(); +Transaction tx = null; +try { + tx = sess.beginTransaction(); + + // do some work + ... + + tx.commit(); +} +catch (RuntimeException e) { + if (tx != null) tx.rollback(); + throw e; // or display error message +} +finally { + sess.close(); +}]]></programlisting> + + <para> + Você não pode chamar <literal>flush()</literal> do <literal>Session()</literal> + explicitamente - a chamada ao <literal>commit()</literal> dispara automaticamente + a sincronização para a sessão (dependendo do <xref linkend="objectstate-flushing"> + FlushMode</xref>). Uma chamada ao <literal>close()</literal> marca o fim de uma sessão. + A principal implicação do <literal>close()</literal> é que a conexão JDBC será abandonada + pela sessão. Este código Java é portável e funciona em ambientes não gerenciado e de JTA. + </para> + + <para> + Uma solução muito mais flexível é gerência integrada de contexto da "sessão atual" + do Hibernate, como descrito anteriormente: + </para> + + <programlisting><![CDATA[// Non-managed environment idiom with getCurrentSession() +try { + factory.getCurrentSession().beginTransaction(); + + // do some work + ... + + factory.getCurrentSession().getTransaction().commit(); +} +catch (RuntimeException e) { + factory.getCurrentSession().getTransaction().rollback(); + throw e; // or display error message +}]]></programlisting> + + <para> + Você muito provavelmente nunca verá estes fragmentos de código em uma aplicação + regular; as exceções fatais (do sistema) devem sempre ser pegas no "alto". + Ou seja, o código que executa chamadas do Hibernate (na camada de persistência) + e o código que trata <literal>RuntimeException</literal> (e geralmente pode + somente limpar acima e na saída) estão em camadas diferentes. O gerenciamento do + contexto atual feito pelo Hibernate pode significativamente simplificar este + projeto, como tudo que você necessita é do acesso a um <literal>SessionFactory</literal>. + A manipulação de exceção é discutida mais tarde neste capítulo. + </para> + + <para> + Note que você deve selecionar <literal>org.hibernate.transaction.JDBCTransactionFactory</literal> + (que é o padrão) e para o segundo exemplo <literal>"thread"</literal> como seu + <literal>hibernate.current_session_context_class</literal>. + </para> + + </sect2> + + <sect2 id="transactions-demarcation-jta" revision="3"> + <title>Usando JTA</title> + + <para> + Se sua camada de persistência funcionar em um servidor de aplicação (por exemplo, + dentro dos EJB session beans), cada conexão do datasource obtida pelo Hibernate + automaticamente fará parte da transação global de JTA. Você pode também instalar uma + implementação standalone de JTA e usá-la sem EJB. O Hibernate oferece duas estratégias + para a integração de JTA. + </para> + + <para> + Se você usar bean-managed transactions (BMT - transações gerenciadas por bean) o Hibernate dirá + ao servidor de aplicação para começar e para terminar uma transação de BMT se você usar a API + Transaction. Assim, o código de gerência de transação é idêntico ao ambiente não gerenciado. + </para> + + <programlisting><![CDATA[// BMT idiom +Session sess = factory.openSession(); +Transaction tx = null; +try { + tx = sess.beginTransaction(); + + // do some work + ... + + tx.commit(); +} +catch (RuntimeException e) { + if (tx != null) tx.rollback(); + throw e; // or display error message +} +finally { + sess.close(); +}]]></programlisting> + + <para> + Se você quiser usar um <literal>Session</literal> limitada por transação, isto é, + a funcionalidade do <literal>getCurrentSession()</literal> para a propagação fácil + do contexto, você terá que usar diretamente a API JTA <literal>UserTransaction</literal>: + </para> + + <programlisting><![CDATA[// BMT idiom with getCurrentSession() +try { + UserTransaction tx = (UserTransaction)new InitialContext() + .lookup("java:comp/UserTransaction"); + + tx.begin(); + + // Do some work on Session bound to transaction + factory.getCurrentSession().load(...); + factory.getCurrentSession().persist(...); + + tx.commit(); +} +catch (RuntimeException e) { + tx.rollback(); + throw e; // or display error message +}]]></programlisting> + + <para> + Com CMT, a demarcação da transação é feita em descritores de deployment do session beans, + não programaticamente, conseqüentemente, o código é reduzido a: + </para> + + <programlisting><![CDATA[// CMT idiom + Session sess = factory.getCurrentSession(); + + // do some work + ... +]]></programlisting> + + <para> + Em um CMT/EJB mesmo um rollback acontece automaticamente, desde que uma exeção <literal>RuntimeException</literal> + não tratável seja lançada por um método de um session bean que informa ao contêiner ajustar a + transação global ao rollback. <emphasis>Isto significa que você não necessita usar a API + <literal>Transaction</literal> do Hibernate em tudo com BMT ou CMT e você obtém a propagação + automática do Session "atual" limitada à transação.</emphasis> + </para> + + <para> + Veja que você deverá escolher <literal>org.hibernate.transaction.JTATransactionFactory</literal> + se você usar o JTA diretamente (BMT) e <literal>org.hibernate.transaction.CMTTransactionFactory</literal> + em um CMT session bean, quando você configura a fábrica de transação do Hibernate. Lembre-se também de + configurar o <literal>hibernate.transaction.manager_lookup_class</literal>. Além disso, certifique-se + que seu <literal>hibernate.current_session_context_class</literal> ou não é configurado (compatibilidade + com o legado) ou é definido para <literal>"jta"</literal>. + + </para> + + <para> + A operação <literal>getCurrentSession()</literal> tem um aspecto negativo em um ambiente JTA. + Há uma advertência para o uso do método liberado de conexão <literal>after_statement</literal>, + o qual é usado então por padrão. Devido a uma limitação simples da especificação JTA, não é + possível para o Hibernate automaticamente limpar quaisquer instâncias <literal>ScrollableResults</literal> + ou <literal>Iterator</literal> abertas retornadas pelo <literal>scroll()</literal> ou + <literal>iterate()</literal>. Você <emphasis>deve</emphasis> liberar o cursor subjacente da + base de dados chamando <literal>ScrollableResults.close()</literal> ou + <literal>Hibernate.close(Iterator)</literal> explicitamente de um bloco <literal>finally</literal>. + (Claro que a maioria de aplicações podem facilmente evitar o uso do <literal>scroll()</literal> ou + do <literal>iterate()</literal> em todo código provindo do JTA ou do CMT.) + + </para> + + </sect2> + + <sect2 id="transactions-demarcation-exceptions"> + <title>Tratamento de Exceção</title> + + <para> + Se a <literal>Session</literal> levantar uma exceção (incluindo qualquer + <literal>SQLException</literal>), você deve imediatamente dar um rollback + na transação do banco, chamando <literal>Session.close()</literal> e descartando + a instância da <literal>Session</literal>. Certos métodos da <literal>Session</literal> + <literal>não</literal> deixarão a sessão em um estado inconsistente. Nenhuma exceção + lançada pelo Hibernate pode ser recuperada. Certifique-se que a <literal>Session</literal> + será fechada chamando <literal>close()</literal> no bloco <literal>finally</literal>. + </para> + + <para> + A exceção <literal>HibernateException</literal>, a qual envolve a maioria dos erros + que podem ocorrer em uma camada de persistência do Hibernate, é uma exceção unchecked ( + não estava em umas versões mais antigas de Hibernate). Em nossa opinião, nós não devemos + forçar o desenvolvedor a tratar uma exceção irrecuperável em uma camada mais baixa. + Na maioria dos sistemas, as exceções unchecked e fatais são tratadas em um dos primeiros + frames da pilha da chamada do método (isto é, em umas camadas mais elevadas) e uma mensagem + de erro é apresentada ao usuário da aplicação (ou a alguma outra ação apropriada é feita). + Note que Hibernate pode também lançar outras exceções unchecked que não são um + <literal>HibernateException</literal>. Estas, também são, irrecuperáveis e uma ação + apropriada deve ser tomada. + </para> + + <para> + O Hibernate envolve <literal>SQLException</literal>s lançadas ao interagir com a base de dados + em um <literal>JDBCException</literal>. Na realidade, o Hibernate tentará converter a exceção em + em uma sub classe mais significativa da <literal>JDBCException</literal>. A + <literal>SQLException</literal> subjacente está sempre disponível através de + <literal>JDBCException.getCause()</literal>. + + O Hibernate converte a <literal>SQLException</literal> em uma sub classe + <literal>JDBCException</literal> apropriada usando <literal>SQLExceptionConverter</literal> + associado ao SessionFactory. Por padrão, o <literal>SQLExceptionConverter</literal> é definido + pelo dialeto configurado; entretanto, é também possível conectar em uma implementação customizada + (veja o javadoc para mais detalhes da classe <literal>SQLExceptionConverterFactory</literal>). + Os subtipos padrão de <literal>JDBCException</literal> são: + </para> + + <itemizedlist spacing="compact"> + <listitem> + <para> + <literal>JDBCConnectionException</literal> - indica um erro com a comunicação subjacente de JDBC. + </para> + </listitem> + <listitem> + <para> + <literal>SQLGrammarException</literal> - indica um problema da gramática ou da sintaxe com o SQL emitido. + </para> + </listitem> + <listitem> + <para> + <literal>ConstraintViolationException</literal> - indica algum forma de violação de confinamento de integridade. + </para> + </listitem> + <listitem> + <para> + <literal>LockAcquisitionException</literal> - indica um erro ao adquirir um nível de bloqueio necessário para realizar a operação de requisição. + </para> + </listitem> + <listitem> + <para> + <literal>GenericJDBCException</literal> - uma exceção genérica que não cai em algumas das outras categorias. + </para> + </listitem> + </itemizedlist> + + </sect2> + + <sect2 id="transactions-demarcation-timeout"> + <title>Timeout de Transação</title> + + <para> + Uma característica extremamente importante fornecida por um ambiente + gerenciado como EJB e que nunca é fornecido pelo código não gerenciado é o timeout + de transação. Timeouts de transação asseguram que nenhuma transação possa + reter indefinidamente recursos enquanto não retorna nenhuma resposta ao usuário. + Fora de um ambiente controlado (JTA), o Hibernate não pode fornecer inteiramente + esta funcionalidade. Entretanto, o Hibernate pode afinal controlar as operações + do acesso a dados, assegurando que o nível de deadlocks e queries do banco de + dados com imensos resultados definidos sejam limitados pelo timeout. Em um ambiente + gerenciado, o Hibernate pode delegar o timeout da transação ao JTA. Esta funcionalidade + é abstraída pelo objeto <literal>Transaction</literal> do Hibernate. + </para> + + <programlisting><![CDATA[ +Session sess = factory.openSession(); +try { + //set transaction timeout to 3 seconds + sess.getTransaction().setTimeout(3); + sess.getTransaction().begin(); + + // do some work + ... + + sess.getTransaction().commit() +} +catch (RuntimeException e) { + sess.getTransaction().rollback(); + throw e; // or display error message +} +finally { + sess.close(); +}]]></programlisting> + + <para> + Veja que <literal>setTimeout()</literal> não pode ser chamado em um CMT bean, + onde os timeouts das transações devem ser definidos declarativamente. + </para> + + </sect2> + + </sect1> + + <sect1 id="transactions-optimistic"> + <title>Controle de concorrência otimista</title> + + <para> + O único caminho que é consistente com a elevada concorrência e escalabilidade + é controle de concorrência otimista com versionamento. Checagem de versão usa + número de versão, ou timestamps, para detectar conflitos de atualizações (e para + impedir atualizações perdidas). O Hibernate fornece três caminhos possíveis para + escrever aplicações que usam concorrência otimista. Os casos de uso que nós mostramos + estão no contexto de conversações longas, mas a checagem de versão também tem o + benefício de impedir atualizações perdidas em únicas transações. + </para> + + <sect2 id="transactions-optimistic-manual"> + <title>Checagem de versão da aplicação</title> + + <para> + Em uma implementação sem muita ajuda do Hibernate, cada interação com o banco de dados + ocorre em uma nova <literal>Session</literal> e o desenvolvedor é responsável para + recarregar todas as instâncias persistentes da base de dados antes de manipulá-las. + Este caminho força a aplicação a realizar sua própria checagem de versão para assegurar + a conversação do isolamento da transação. Este caminho é menos eficiente em termos de + acesso ao banco de dados. É a caminho mais similar a EJBs entity. + </para> + + <programlisting><![CDATA[// foo is an instance loaded by a previous Session +session = factory.openSession(); +Transaction t = session.beginTransaction(); + +int oldVersion = foo.getVersion(); +session.load( foo, foo.getKey() ); // load the current state +if ( oldVersion != foo.getVersion() ) throw new StaleObjectStateException(); +foo.setProperty("bar"); + +t.commit(); +session.close();]]></programlisting> + + <para> + A propriedade <literal>version</literal> é mapeada usando <literal><version></literal>, + e o Hibernate vai incrementá-lo-á automaticamente durante o flush se a entidade + estiver alterada. + </para> + + <para> + Claro, se você se estiver operando em um ambiente de baixa concorrência de dados + e não requerer a checagem de versão, você pode usar este caminho e apenas saltar a + checagem de versão. Nesse caso, o <emphasis>ultimo commit realizdo </emphasis> é + a estratégia padrão para suas conversações longas. Mantenha em mente que isto pode + confundir os usuários da aplicação, assim como eles podem experimentar atualizações + perdidas sem mensagens de erro ou uma possibilidade ajustar mudanças de conflito. + + </para> + + <para> + Claro que, checagem manual da versão é somente praticável em circunstâncias triviais + e não para a maioria de aplicações. Freqüentemente, os grafos completos de objetos + modificados têm que ser verificados, não somente únicas instâncias. O Hibernate oferece + checagem de versão automática com uma <literal>Session</literal> estendida ou instâncias + desatachadas como o paradigma do projeto. + </para> + + </sect2> + + <sect2 id="transactions-optimistic-longsession"> + <title>Sessão estendida e versionamento automático</title> + + <para> + Uma única instância de <literal>Session</literal> e suas instâncias persistentes + são usadas para a conversação inteira, isto é conhecido como + <emphasis>session-per-conversation</emphasis>. O Hibernate verifica versões da instância + no momento dio flush, lançando uma exceção se a modificação concorrente for detectada. + Até o desenvolvedor pegar e tratar essa exceção (as opções comuns são a oportunidade + para que o usuário intercale as mudanças ou reinicie a conversação do negócio com + dados não antigos). + </para> + + <para> + The <literal>Session</literal> is disconnected from any underlying JDBC connection + when waiting for user interaction. This approach is the most efficient in terms + of database access. The application need not concern itself with version checking or + with reattaching detached instances, nor does it have to reload instances in every + database transaction. + A <literal>Session</literal> é desconectada de toda a conexão JDBC subjacente + enquanto espera a interação do usuário. Este caminho é a mais eficiente em termos + de acesso a bancos de dados. A aplicação não necessita concernir-se com a checagem + de versão ou com as instâncias destacadas reatadas, nem tem que recarregar instâncias + em cada transação. + </para> + + <programlisting><![CDATA[// foo is an instance loaded earlier by the old session +Transaction t = session.beginTransaction(); // Obtain a new JDBC connection, start transaction + +foo.setProperty("bar"); + +session.flush(); // Only for last transaction in conversation +t.commit(); // Also return JDBC connection +session.close(); // Only for last transaction in conversation]]></programlisting> + <para> + O objeto <literal>foo</literal> sabe que <literal>Session</literal> já foi carregada. Começando + uma nova transação em uma sessão velha obtém uma conexão nova e recomeça a sessão. Commitando + uma transação desconecta uma sessão da conexão JDBC e retorna a conexão ao pool. Após a reconexão, + forçar uma checagem de versão em dados que você não está atualizando, você pode chamar + <literal>Session.lock()</literal> com o <literal>LockMode.READ</literal> em todos os objetos + que possam ter sido atualizados por uma outra transação. Você não necessita bloquear nenhum + dado para atualizar. Geralmente você configuraria <literal>FlushMode.MANUAL</literal> em uma + <literal>Session</literal> estendida, de modo que somente o último ciclo da transação tenha + permissão de persistir todas as modificações feitas nesta conversação. Disso, somente esta última + transação incluiria a operação <literal>flush()</literal> e então chamar também <literal>close()</literal> + da sessão para terminar a conversação. + </para> + + <para> + Este pattern é problemático se a <literal>Session</literal> for demasiadamente grande para + ser armazenado durante o tempo que usuário pensar, por exemplo um <literal>HttpSession</literal> + estiver mantido tão pequeno quanto possível. Como o <literal>Session</literal> é também cache + de primeiro nível (imperativo) e contém todos os objetos carregados, nós podemos provavelmente + usar esta estratégia somente para alguns ciclos de requisição/resposta. Você deve usar a + <literal>Session</literal> somente para uma única conversação, porque ela logo também + estará com dados velhos. + </para> + + <para> + (Note que versões mais atuais de Hibernate requerem a desconexão e o reconexão explícitas de + uma <literal>Session</literal>. Estes métodos são desatualizados, como o início e término de + uma transação tem o mesmo efeito.) + </para> + + <para> + Note também que você deve manter a <literal>Session</literal> desconectada fechada + para a camada de persistência. Ou seja, use um EJB stateful session bean para + prender a <literal>Session</literal> em um ambiente do três camadas e não o + transferir à camada web (ou até serializá-lo para uma camada separada) + para armazená-lo no <literal>HttpSession</literal>. + + </para> + + <para> + O pattern sessão estendida, ou <emphasis>session-per-conversation</emphasis>, é mais + difícil de implementar com gerenciamento automático de sessão atual. Você precisa fornecer + sua própria implementação do <literal>CurrentSessionContext</literal> para isto + (veja o Hibernate Wiki para exemplos). + </para> + + </sect2> + + <sect2 id="transactions-optimistic-detached"> + <title>Objetos destacados e versionamento automático</title> + + <para> + Cada interação com o armazenamento persistente ocorre em uma <literal>Session</literal> nova. + Entretanto, as mesmas instâncias persistentes são reusadas para cada interação com o banco de dados. + A aplicação manipula o estado das instâncias desatachadas originalmente carregadas em um outro + <literal>Session</literal> e reata-os então usando <literal>Session.update()</literal>, + <literal>Session.saveOrUpdate()</literal> ou <literal>Session.merge()</literal>. + </para> + + <programlisting><![CDATA[// foo is an instance loaded by a previous Session +foo.setProperty("bar"); +session = factory.openSession(); +Transaction t = session.beginTransaction(); +session.saveOrUpdate(foo); // Use merge() if "foo" might have been loaded already +t.commit(); +session.close();]]></programlisting> + + <para> + Outra vez, o Hibernate verificará versões da instância durante o flush, + lançando uma exceção se ocorrer conflitos de atualizações. + </para> + + <para> + Você pode também chamar o <literal>lock()</literal> em vez de <literal>update()</literal> + e usar <literal>LockMode.READ</literal> (executando uma checagem de versão, ignorando + todos os caches) se você estiver certo de que o objeto não foi modificado. + </para> + + </sect2> + + <sect2 id="transactions-optimistic-customizing"> + <title>Versionamento automático customizado</title> + + <para> + Você pode desabilitar o incremento da versão automática de Hibernate para propriedades + e coleções particulares configurando o mapeamento do atributo <literal>optimistic-lock</literal> + para false. O Hibernate então não irá incrementa versões se a propriedade estiver + modificada. + </para> + + <para> + Os esquemas da base de dados legada são freqüentemente estáticos e não podem ser modificados. + Ou outras aplicações puderam também acessar a mesma base de dados e não sabem tratar a + versão dos números ou timestamps. Em ambos os casos, o versionamento não pode confiar em uma + coluna particular em uma tabela. Para forçar uma checagem de versão sem uma versão ou mapeamento + da propriedade do timestamp com uma comparação do estado de todos os campos em uma linha, + configure <literal>optimistic-lock="all"</literal> no mapeamento <literal><class></literal>. + Note que isto conceitualmente é somente feito em trabalhos se Hibernate puder comparar o estado + velho e novo, isto é, se você usa um único <literal>Session</literal> longo e não + session-per-request-with-detached-objects. + </para> + + <para> + Às vezes a modificação concorrente pode ser permitida tão longa quanto às mudanças que + tiveram sido feitas que não sobrepuseram. Se você configurar <literal>optimistic-lock="dirty"</literal> + ao mapear o <literal><class></literal>, o Hibernate comparará somente campos + modificados durante o flush. + </para> + + <para> + Em ambos os casos, com as colunas dedicadas da versão/timestamp ou com comparação do + campo cheio/modificados, o Hibernate usa uma única declaração UPDATE (com uma cláusula + WHERE apropriada ) por entidade para executar a checagem da versão e atualizar a informação. + Se você usa a persistência transitiva para cascatear o reatamento das entidades associadas, + o Hibernate pode executar atualizações desnecessárias. Isso não é geralmente um problema, + mas triggers <emphasis>on update</emphasis> em um banco de dados podem ser executados + mesmo quando nenhuma mudança foi feita nas instâncias destacadas. Você pode customizar + este comportamento configurando <literal>select-before-update="true"</literal> no + mapeamento <literal><class></literal>, forçando o Hibernate a dá um SELECT nas + instâncias para assegurar-se esse as mudanças ocorreram realmente, antes de atualizar + a linha. + </para> + + </sect2> + + </sect1> + + <sect1 id="transactions-locking"> + <title>Locking pessimista</title> + + <para> + Não se pretende que os usuários gastam muitas horas se preocupando com suas estratégias de + locking. Geralmente é o bastante para especificar um nível de isolamento para as conexões + JDBC e então deixar simplesmente o banco de dados fazer todo o trabalho. Entretanto, os + usuários avançados podem às vezes desejar obter locks pessimistas exclusivos, ou re-obter + locks no início de uma nova transação. + </para> + + <para> + O Hibernate usará sempre o mecanismo de lock da base de dados, nunca trava objetos + na memória! + </para> + + <para> + A classe <literal>LockMode</literal> define os diferentes níveis de lock que o Hibernate + pode adquirir. Um lock é obtido pelos seguintes mecanismos: + + </para> + + <itemizedlist spacing="compact"> + <listitem> + <para> + <literal>LockMode.WRITE</literal> é adquirido automaticamente quando o Hibernate atualiza + ou insere uma linha. + </para> + </listitem> + <listitem> + <para> + <literal>LockMode.UPGRADE</literal> pode ser adquirido explicitamente pelo usuário + usando <literal>SELECT ... FOR UPDATE</literal> em um banco de dados que suporte + esse sintaxe. + </para> + </listitem> + <listitem> + <para> + <literal>LockMode.UPGRADE_NOWAIT</literal> pode ser adquirido explicitamente pelo usuário + usando <literal>SELECT ... FOR UPDATE NOWAIT</literal> no Oracle. + + </para> + </listitem> + <listitem> + <para> + <literal>LockMode.READ</literal> é adquirido automaticamente quando o Hibernate lê + dados em um nível Repeatable Read ou Serializable isolation. Pode ser readquirido + explicitamente pelo usuário. + </para> + </listitem> + <listitem> + <para> + <literal>LockMode.NONE</literal> representa a ausência do lock. Todos os objetos mudam para + esse estado de lock no final da <literal>Transaction</literal>. Objetos associados com a sessão + através do método <literal>update()</literal> ou <literal>saveOrUpdate()</literal> também são + inicializados com esse lock mode. + </para> + </listitem> + </itemizedlist> + + <para> + O lock obtido "explicitamente pelo usuário" se dá em uma das seguintes maneiras: + </para> + + <itemizedlist spacing="compact"> + <listitem> + <para> + Uma chamada a <literal>Session.load()</literal>, especificando + o <literal>LockMode</literal>. + </para> + </listitem> + <listitem> + <para> + Uma chamada a <literal>Session.lock()</literal>. + </para> + </listitem> + <listitem> + <para> + Uma chamada a <literal>Query.setLockMode()</literal>. + </para> + </listitem> + </itemizedlist> + + <para> + Se uma <literal>Session.load()</literal> é invocada com <literal>UPGRADE</literal> ou + <literal>UPGRADE_NOWAIT</literal>, e o objeto requisitado ainda não foi carregado + pela sessão, o objeto é carregado usando <literal>SELECT ... FOR UPDATE</literal>. + Se <literal>load()</literal> for chamado para um objeto que já foi carregado + com um lock menos restritivo que o novo lock solicitado, o Hibernate invoca o + método <literal>lock()</literal> para aquele objeto. + </para> + + <para> + O método <literal>Session.lock()</literal> executa uma verificação no número da versão + se o modo de lock especificado for <literal>READ</literal>, <literal>UPGRADE</literal> ou + <literal>UPGRADE_NOWAIT</literal>.. (No caso do <literal>UPGRADE</literal> ou + <literal>UPGRADE_NOWAIT</literal>, é usado <literal>SELECT ... FOR UPDATE</literal>.) + </para> + + <para> + Se o banco de dados não suportar o lock mode solicitado, o Hibernate vai usar um modo + alternativo apropriado (ao invés de lançar uma exceção). Isso garante que a aplicação + vai ser portável. + </para> + + </sect1> + + <sect1 id="transactions-connection-release"> + <title>Modos de liberar a Connection</title> + + <para> + O comportamento legado do Hibernate (2.x) em consideração ao gerenciamento da conexão + via JDBC fez com que a <literal>Session</literal> precisasse obter uma conexão + quando ela precisasse pela primeira vez e depois manter a conexão enquanto + a sessão não fosse fechada. O Hibernate 3.x introduz a idéia de modos de liberar a + sessão, para informar a sessão a forma como deve manusear a sua conexão JDBC. + Veja que essa discussão só é pertinente para conexões fornecidas com um + <literal>ConnectionProvider</literal> configurado; conexões fornecidas pelo usuário + estão fora do escopo dessa discussão. Os diferentes modos de liberação estão definidos + pelos valores da enumeração + <literal>org.hibernate.ConnectionReleaseMode</literal>: + + </para> + + <itemizedlist spacing="compact"> + <listitem> + <para> + <literal>ON_CLOSE</literal> - essencialmente é o modo legado descrito acima. A sessão + do Hibernate obtêm a conexão quando precisar executar alguma operação JDBC pela + primeira vez e mantem enquanto a conexão não for fechada. + </para> + </listitem> + <listitem> + <para> + <literal>AFTER_TRANSACTION</literal> – informa que a conexão deve ser + liberada após a conclusão de uma <literal>org.hibernate.Transaction</literal>. + </para> + </listitem> + <listitem> + <para> + <literal>AFTER_STATEMENT</literal> (também conhecida com liberação agressiva) – informa + que a conexão deve ser liberada após a execução de cada statement. A liberação agressiva + não ocorre se o statement deixa pra trás algum recurso aberto associado com a sessão + obtida; atualmente, a única situação em que isso é possível é com o uso de + <literal>org.hibernate.ScrollableResults</literal>. + </para> + </listitem> + </itemizedlist> + + <para> + O parâmetro de configuração <literal>hibernate.connection.release_mode</literal> é usado + para especificar qual modo de liberação deve ser usado. Opções disponíveis: + </para> + + <itemizedlist spacing="compact"> + <listitem> + <para> + <literal>auto</literal> (padrão) – essa opção delega ao modo de liberação retornado pelo + método <literal>org.hibernate.transaction.TransactionFactory.getDefaultReleaseMode()</literal>. + Para JTATransactionFactory, ele retorna ConnectionReleaseMode.AFTER_STATEMENT; para + JDBCTransactionFactory, ele retorna ConnectionReleaseMode.AFTER_TRANSACTION. + Raramente é uma boa idéia alterar padrão, como frequencia ao se fazer isso temos falhas + que parecem bugs e/ou suposições inválidas no código do usuário. + </para> + </listitem> + <listitem> + <para> + <literal>on_close</literal> - indica o uso da ConnectionReleaseMode.ON_CLOSE. Essa opção + foi deixada para manter a compatibilidade, mas seu uso é fortemente desencorajado. + </para> + </listitem> + <listitem> + <para> + <literal>after_transaction</literal> – indica o uso da ConnectionReleaseMode.AFTER_TRANSACTION. + Essa opção nada deve ser usada com ambientes JTA. Também note que no caso da + ConnectionReleaseMode.AFTER_TRANSACTION, se a sessão foi colocada no modo auto-commit a + conexão vai ser liberada de forma similar ao modo AFTER_STATEMENT. + </para> + </listitem> + <listitem> + <para> + <literal>after_statement</literal> – indica o uso ConnectionReleaseMode.AFTER_STATEMENT. + Adicionalmente, o <literal>ConnectionProvider</literal> configurado é consultado para + verificar se suporta essa configuração ((<literal>supportsAggressiveRelease()</literal>). + Se não suportar, o modo de liberação é redefinido como ConnectionRelease-Mode.AFTER_TRANSACTION. + Essa configuração só é segura em ambientes onde podemos readquirir a mesma conexão JDBC + toda vez que o método <literal>ConnectionProvider.getConnection()</literal> for chamado ou + em um ambiente auto-commit onde não importa se nós recuperamos a mesma conexão. + </para> + </listitem> + </itemizedlist> + + </sect1> + +</chapter> + Modified: core/trunk/documentation/manual/pt-BR/src/main/docbook/content/tutorial.xml =================================================================== --- core/trunk/documentation/manual/pt-BR/src/main/docbook/content/tutorial.xml 2007-10-26 00:46:38 UTC (rev 14135) +++ core/trunk/documentation/manual/pt-BR/src/main/docbook/content/tutorial.xml 2007-10-26 00:48:48 UTC (rev 14136) @@ -1,1533 +1,1550 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="tutorial"> - <title>Introdução ao Hibernate</title> - - <sect1 id="tutorial-intro" revision="1"> - <title>Prefácio</title> - - <para> - Este capítulo é um tutorial introdutório para novos usuários do Hibernate. Nós iniciaremos com uma simples linha de comando em uma aplicação usando uma base de dados em memória tornando isto um passo de fácil de compreender. - </para> - - <para> - Este tutorial é voltado para novos usuários do Hibernate, mas requer um conhecimento de Java e SQL. Este tutorial é baseado no tutorial de Michael Gloegl, as bibliotecas Third Party foram nomeadas para JDK 1.4 e 5.0. Você pode precisar de outras bibliotecas para JDK 1.3. - </para> - - <para> - O código fonte para o tutorial está incluído no diretório da distribuição - <literal>doc/reference/tutorial/</literal>. - </para> - - </sect1> - - <sect1 id="tutorial-firstapp" revision="2"> - <title>Parte 1 – A primeira aplicação Hibernate</title> - - <para> - Primeiro, iremos criar uma simples aplicação Hibernate baseada em console. Usaremos uma base de dados Java (HSQL DB), então não teremos que instalar nenhum servidor de base de dados. - </para> - - <para> - Vamos supor que precisemos de uma aplicação com um banco de dados pequeno que possa armazenar e atender os eventos que queremos, e as informaççes sobre os hosts destes eventos. - </para> - - <para> - A primeira coisa que devemos fazer é configurar nosso diretório de desenvolvimento, - e colocar todas as bibliotecas Java que precisamos dentro dele. Faça o download da - distribuição do Hibernate no site do Hibernate. Descompacte o pacote e coloque todas - as bibliotecas necessárias encontradas no diretório <literal>/lib</literal>, dentro do - diretório <literal>/lib</literal> do seu novo projeto. Você deverá ter algo parecido - com isso: - </para> - - <programlisting><![CDATA[. -+lib - antlr.jar - cglib.jar - asm.jar - asm-attrs.jars - commons-collections.jar - commons-logging.jar - hibernate3.jar - jta.jar - dom4j.jar - log4j.jar ]]></programlisting> - - <para> - Esta é a configuração mínima requerida das bibliotecas (observe que também foi copiado - o hibernate3.jar da pasta principal do Hibernate) para o Hibernate <emphasis>na hora do desenvolvimento</emphasis>. O Hibernate permite que você utilize mais ou menos bibliotecas. - Veja o arquivo <literal>README.txt</literal> no diretório <literal>lib/</literal> da distribuição - do Hibernate para maiores informaççes sobre bibliotecas requeridas e opcionais. - (Atualmente, a biblioteca Log4j não é requerida, mas é preferida por muitos desenvolvedores.) - </para> - - <para> - Agora, iremos criar uma classe que representa o evento que queremos armazenar na base de dados.. - </para> - - <sect2 id="tutorial-firstapp-firstclass" revision="1"> - <title>A primeira Classe</title> - - <para> - Nossa primeira classe de persistência é uma simples classe JavaBean com algumas propriedades: - </para> - - <programlisting><![CDATA[package events; - -import java.util.Date; - -public class Event { - private Long id; - - private String title; - private Date date; - - public Event() {} - - public Long getId() { - return id; - } - - private void setId(Long id) { - this.id = id; - } - - public Date getDate() { - return date; - } - - public void setDate(Date date) { - this.date = date; - } - - public String getTitle() { - return title; - } - - public void setTitle(String title) { - this.title = title; - } -}]]></programlisting> - - <para> - Você pode ver que esta classe usa o padrão JavaBean para o nomeamento convencional da propriedade getter e dos métodos setter, como também a visibilidade private dos campos. Este é um padrão de projeto recomendado, mas não requerido. O Hibernate pode também acessar campos diretamente, o benefício para os métodos de acesso é a robustez para o Refactoring. O construtor sem argumento é requerido para instanciar um objeto desta classe com a reflexão. - </para> - - <para> - A propriedade <literal>id</literal> mantém um único valor de identificação para um evento - particular. Todas as classes persistentes da entidade (bem como aquelas classes dependentes - de menos importância) precisam de uma propriedade de identificação, caso nós queiramos usar o - conjunto completo de características do Hibernate. De fato, a maioria das aplicações - (esp. aplicações web) precisam destinguir os objetos pelo identificador, então você deverá - considerar esta, uma característica em lugar de uma limitação. Porém, nós normalmente não - manipulamos a identidade de um objeto, consequentemente o método setter deverá ser privado. - O Hibernate somente nomeará os identificadores quando um objeto for salvo. Você pode ver como - o Hibernate pode acessar métodos públicos, privados, e protegidos, como também campos - (públicos, privados, protegidos) diretamente. A escolha está até você, e você pode combinar - isso para adaptar seu projeto de aplicação - </para> - - <para> - O construtor sem argumentos é um requerimento para todas as classes persistentes; - O Hibernate tem que criar para você os objetos usando Java Reflection. O construtor - pode ser privado, porém, a visibilidade do pacote é requerida para a procuração da - geração em tempo de execução e recuperação eficiente dos dados sem a instrumentação - de bytecode - </para> - - <para> - Coloque este fonte Java no diretório chamado <literal>src</literal> na pasta de desenvolvimento, - e em seu pacote correto. O diretório deverá ser parecido como este: - </para> - - <programlisting><![CDATA[. -+lib - <Hibernate and third-party libraries> -+src - +events - Event.java]]></programlisting> - - <para> - No próximo passo, iremos falar sobre as classes de persistência do Hibernate.. - </para> - - </sect2> - - <sect2 id="tutorial-firstapp-mapping" revision="1"> - <title>O mapeamento do arquivo</title> - - <para> - O Hibernate precisa saber como carregar e armazenar objetos da classe de - persistência. Isto será onde o mapeamento do arquivo do Hibernate entrará em - jogo. O arquivo mapeado informa ao Hibernate, qual tabela no banco de dados - ele deverá acessar, e quais as colunas na tabela ele deverá usar. - </para> - - <para> - A estrutura básica de um arquivo de mapeamento é parecida com: - </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"> - -<hibernate-mapping> -[...] -</hibernate-mapping>]]></programlisting> - - <para> - Note que o Hibernate DTD é muito sofisticado. Você pode usar isso para auto-conclusão - no mapeamento XML dos elementos e atributos no seu editor ou IDE. Você também pode - abrir o arquivo DTD no seu editor – é a maneira mais fácil de ter uma visão geral - de todos os elementos e atributos e dos padrões, como também alguns comentários. - Note que o Hibernate não irá carregar o arquivo DTD da web, e sim do diretório - da aplicação (classpath). O arquivo DTD está incluído no <literal>hibernate3.jar</literal> como - também no diretório <literal>src/</literal> da distribuição do Hibernate. - </para> - - <para> - Nós omitiremos a declaração do DTD nos exemplos futuros para encurtar o código. Isto, é claro, não é opcional. - </para> - - <para> - Entre os dois tags <literal>hibernate-mapping</literal>, inclua um elemento <literal>class</literal>. - Todas as classes persistentes da entidade (novamente, poderá haver - mais tarde, dependências sobre as classes que não são classes-primárias - de entidades) necessitam do tal mapeamento, para uma tabela na base - de dados SQL - </para> - - <programlisting><![CDATA[<hibernate-mapping> - - <class name="events.Event" table="EVENTS"> - - </class> - -</hibernate-mapping>]]></programlisting> - - <para> - Mais adiante iremos dizer ao Hibernate como fazer para persistir e carregar objetos da classe - <literal>Event</literal> da tabela <literal>EVENTS</literal>, cada instancia representada por - uma coluna na tabela. Agora, continuaremos com o mapeamento de uma única propriedade identificadora - para as chaves primárias da tabela. Além disso, nós não iremos se importar com esta propriedade - identificadora, nós iremos configurar uma estratégia de geração de id’s para uma chave primária - de uma surrogate key: - </para> - - <programlisting><![CDATA[<hibernate-mapping> - - <class name="events.Event" table="EVENTS"> - <id name="id" column="EVENT_ID"> - <generator class="native"/> - </id> - </class> - -</hibernate-mapping>]]></programlisting> - - <para> - O elemento <literal>id</literal> é a declaração da propriedade identificadora, - o <literal>name="id"</literal> declara o nome da propriedade Java – - o Hibernate irá usar os métodos getter e setter para acessar a propriedade. - O atributo da coluna informa ao Hibernate qual coluna da tabela <literal>EVENTS</literal> nós - iremos usar como chave primária. O elemento <literal>generator</literal> especifica - a estratégia de geração do identificador, neste caso usaremos <literal>native</literal>, que - escolhe a melhor estratégia dependendo da base de dados (dialeto) configurada. - O Hibernate suporta a base de dados gerada, globalmente única, bem como a atribuição - aos identificadores da aplicação (ou toda estratégia escrita para uma extensão). - </para> - - <para> - Finalmente incluiremos as declarações para as propriedades persistentes da classe - no arquivo mapeado. Por default, nenhuma das propriedades da classe é considerada persistente: - </para> - - <programlisting><![CDATA[ -<hibernate-mapping> - - <class name="events.Event" table="EVENTS"> - <id name="id" column="EVENT_ID"> - <generator class="native"/> - </id> - <property name="date" type="timestamp" column="EVENT_DATE"/> - <property name="title"/> - </class> - -</hibernate-mapping>]]></programlisting> - - <para> - Da mesma maneira que com o elemento <literal>id</literal>, o atributo <literal>name</literal> do elemento - <literal>property</literal> informa ao Hibernate qual método getter e setter deverá usar. - Assim, neste caso, o Hibernate irá procurar pelo <literal>getDate()/setDate()</literal>, - como também pelo <literal>getTitle()/setTitle()</literal>. - </para> - - <para> - Porque fazer o mapeamento da propriedade <literal>date</literal> incluído no - atributo <literal>column</literal>, e no title não fazer? - Sem o atributo <literal>column</literal> o Hibernate por padrão usa o nome - da propriedade como o nome da coluna. Isto trabalha muito - bem para o <literal>title</literal>. Entretanto o <literal>date</literal> é uma palavra-chave reservada - na maioria dos bancos de dados, assim nós melhoramos o mapeamentos - disto com um nome diferente. - </para> - - <para> - A próxima coisa interessante é que mapemanto do <literal>title</literal> - também falta o atributo <literal>type</literal>. O tipo que declaramos e o uso nos - arquivos mapeados, não são como você pôde esperar, atributos de dados Java. - Eles não são como os tipos de base de dados SQL. - Esses tipos podem ser chamados de <emphasis>Tipos de mapeamento Hibernate</emphasis>, que são conversores - que podem traduzir tipos de dados do Java para os tipos de dados SQL e vice-versa. - Novamente, o Hibernate irá tentar determinar a conversão correta e mapeará o <literal>type</literal> - próprio, caso o tipo do atributo não estiver presente no mapeamento. - Em alguns casos, esta detecção automática (que usa Reflection sobre as classes Java) - poderá não ter padrão que você espera ou necessita. - Este é o caso com a propriedade <literal>date</literal>. O Hibernate não pode saber se a propriedade - (que é do <literal>java.util.Date</literal>) pode mapear para uma coluna do tipo <literal>date</literal> - do SQL, <literal>timestamp</literal>, ou <literal>time</literal> . - Nós preservamos a informação cheia de datas e horas pelo mapeamento da propriedade com um conversor - <literal>timestamp</literal>. - </para> - - <para> - Este arquivo de mapeamento deve ser salvo como <literal>Event.hbm.xml</literal>, - corretamente no diretório próximo ao arquivo fonte da Classe Java <literal>Event</literal>. - O nomeamento dos arquivos de mapeamento podem ser arbitrários, porém o sufixo - <literal>hbm.xml</literal> é uma convenção da comunidade dos desenvolvedores do Hibernate. - Esta estrutura do diretório deve agora se parecer com isso: - </para> - - <programlisting><![CDATA[. -+lib - <Hibernate and third-party libraries> -+src - +events - Event.java - Event.hbm.xml]]></programlisting> - - <para> - Nós iremos continuar com a configuração principal do Hibernate. - </para> - - </sect2> - - <sect2 id="tutorial-firstapp-configuration" revision="2"> - <title>Configuração do Hibernate</title> - - <para> - Agora nós temos uma classe persistente e este arquivo de mapeamento no lugar. - Está na hora de configurar o Hibernate. Antes de fazermos isso, iremos precisar de uma base de dados. - O HSQL DB, um SQL DBMS feito em java, pode ser baixado através do site do HSQL DB(http://hsqldb.org/). - Atualmente, você só precisa baixar o <literal>hsqldb.jar</literal>. - Coloque este arquivo no diretório da pasta de desenvolvimento <literal>lib/</literal>. - </para> - - <para> - Crie um diretório chamado <literal>data</literal> no diretório root de desenvolvimento – - Isto será onde o HSQL DB irá armazenar arquivos de dados. Agora iremos iniciar o banco de dados - executando <literal>java -classpath ../lib/hsqldb.jar org.hsqldb.Server</literal> neste diretório de dados. - Você pode ver ele iniciando e conectando ao socket TCP/IP, isto será onde nossa aplicação irá se - conectar depois. Se você deseja iniciar uma nova base de dados durante este tutorial, - finalize o HSQL DB(pressionando o <literal>CTRL + C</literal> na janela), delete todos os - arquivos no diretório <literal>data/</literal>, e inicie o HSQL BD novamente. - </para> - - <para> - O Hibernate é uma camada na sua aplicação na qual se conecta com a base de dados, para isso - necessita de informação da conexão. As conexões são feitas através de um pool de conexão JDBC, - na qual teremos que configurar. A distribuição do Hibernate contém diversas ferramentas de pooling - da conexão JDBC de fonte aberta, mas iremos usar o pool de conexão interna para este tutorial. - Note que você tem que copiar a biblioteca necessária em seu classpath e use configurações - diferentes para pooling de conexão caso você deseje utilizar um software de pooling JDBC terceirizado - para qualidade de produção. - </para> - - <para> - Para as configurações do Hibernate, nós podemos usar um arquivo simples <literal>hibernate.properties</literal>, - um arquivo mais ligeiramente sofisticado <literal>hibernate.cfg.xml</literal> ou até mesmo uma - instalação programática completa. A maioria dos usuários preferem utilizar o arquivo de configuração XML - </para> - - <programlisting><![CDATA[<?xml version='1.0' encoding='utf-8'?> -<!DOCTYPE hibernate-configuration PUBLIC - "-//Hibernate/Hibernate Configuration DTD 3.0//EN" - "http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd"> - -<hibernate-configuration> - - <session-factory> - -  - <property name="connection.driver_class">org.hsqldb.jdbcDriver</property> - <property name="connection.url">jdbc:hsqldb:hsql://localhost</property> - <property name="connection.username">sa</property> - <property name="connection.password"></property> - -  - <property name="connection.pool_size">1</property> - -  - <property name="dialect">org.hibernate.dialect.HSQLDialect</property> - -  - <property name="current_session_context_class">thread</property> - -  - <property name="cache.provider_class">org.hibernate.cache.NoCacheProvider</property> - -  - <property name="show_sql">true</property> - -  - <property name="hbm2ddl.auto">create</property> - - <mapping resource="events/Event.hbm.xml"/> - - </session-factory> - -</hibernate-configuration>]]></programlisting> - - <para> - Note que esta configuração XML usa um diferente DTD. Nós configuraremos - as <literal>SessionFactory</literal> do Hibernate – uma factory global responsável - por uma base de dedados particular. Se você tiver diversas bases de dados, - use diversas configurações <literal><session-factory></literal>, geralmente - em diversos arquivos de configuração (para uma partida mais fácil). - </para> - - <para> - As primeiras quatro <literal>propriedades</literal> do elemento contém a configuração - necessária para a conexão ao JDBC. A propriedade <literal>propriedade</literal> dialect - do elemento especifica a variante particular do SQL que o Hibernate gera. - O gerenciamento automático de sessão do Hibernate para contextos de persistência - estará disponível em breve. A opção <literal>hbm2ddl.auto</literal> habilita a geração - automática de schemas da base de dados – diretamente na base de dados. - Isto também pode ser naturalmente desligado (removendo a opção de configuração) ou redirecionando - para um arquivo com ajuda do <literal>SchemaExport</literal> nas tarefas do Ant. - Finalmente, iremos adicionar os arquivos das classes de persistência mapeadas na configuração. - </para> - - <para> - Copie este arquivo no diretório fonte, assim isto irá terminar na raiz (root) do - classpath. O Hibernate automaticamente procura por um arquivo chamado - <literal>hibernate.cfg.xml</literal> na raiz do classpath, no startup. - </para> - - </sect2> - - <sect2 id="tutorial-firstapp-ant" revision="1"> - <title>Construindo com o Ant</title> - - <para> - Nos iremos, agora, construir o tutorial com Ant. Você ira precisar o Ant instalado – - se encontra disponível <ulink url="http://ant.apache.org/bindownload.cgi">na página de download do Ant</ulink>. - Como instalar o Ant, não será abordado aqui. Caso tenha alguma dúvida, por favor, - vá ao <ulink url="http://ant.apache.org/manual/index.html">Ant manual</ulink>. - Depois que tiver instalado o Ant, podemos começar a criar o arquivo de construção <literal>build.xml</literal>. - Este arquivo será chamado de <literal>build.xml</literal> e posto diretamente no diretório de desenvolvimento. - </para> - - <para> - Um arquivo básico de build, se parece com isto: - </para> - - <programlisting><![CDATA[<project name="hibernate-tutorial" default="compile"> - - <property name="sourcedir" value="${basedir}/src"/> - <property name="targetdir" value="${basedir}/bin"/> - <property name="librarydir" value="${basedir}/lib"/> - - <path id="libraries"> - <fileset dir="${librarydir}"> - <include name="*.jar"/> - </fileset> - </path> - - <target name="clean"> - <delete dir="${targetdir}"/> - <mkdir dir="${targetdir}"/> - </target> - - <target name="compile" depends="clean, copy-resources"> - <javac srcdir="${sourcedir}" - destdir="${targetdir}" - classpathref="libraries"/> - </target> - - <target name="copy-resources"> - <copy todir="${targetdir}"> - <fileset dir="${sourcedir}"> - <exclude name="**/*.java"/> - </fileset> - </copy> - </target> - -</project>]]></programlisting> - - <para> - Isto irá avisar ao Ant para adicionar todos os arquivos no diretório lib terminando com - <literal>.jar</literal>, para o classpath usado para compilação. Irá também copiar todos os - arquivos não-java para o diretório alvo (arquivos de configuração, mapeamento). Se você rodar - o ant agora, deverá ter esta saída. - </para> - - <programlisting><![CDATA[C:\hibernateTutorial\>ant -Buildfile: build.xml - -copy-resources: - [copy] Copying 2 files to C:\hibernateTutorial\bin - -compile: - [javac] Compiling 1 source file to C:\hibernateTutorial\bin - -BUILD SUCCESSFUL -Total time: 1 second ]]></programlisting> - - </sect2> - - <sect2 id="tutorial-firstapp-helpers" revision="3"> - <title>Startup and helpers</title> - - <para> - É hora de carregar e arquivar alguns objetos <literal>Event</literal>, mas primeiro - nós temos de completar o setup com algum código de infraestrutura. Este startup - inclui a construção de um objeto <literal>SessionFactory</literal> global e armazenar - isto em algum lugar de fácil acesso para o código da aplicação. - Uma <literal>SessionFactory</literal> pode abrir novas <literal>Session</literal>'s. - Uma <literal>Session</literal> representa uma unidade single-theaded do trabalho, a - <literal>SessionFactory</literal> é um objeto global thread-safe, instanciado uma vez. - </para> - - <para> - Nos iremos criar uma classe de ajuda <literal>HibernateUtil</literal>, que toma - conta do startup e faz acesso a uma <literal>SessionFactory</literal> conveniente. - Vamos dar uma olhada na implementação: - </para> - - <programlisting><![CDATA[package util; - -import org.hibernate.*; -import org.hibernate.cfg.*; - -public class HibernateUtil { - - private static final SessionFactory sessionFactory; - - static { - try { - // Create the SessionFactory from hibernate.cfg.xml - sessionFactory = new Configuration().configure().buildSessionFactory(); - } catch (Throwable ex) { - // Make sure you log the exception, as it might be swallowed - System.err.println("Initial SessionFactory creation failed." + ex); - throw new ExceptionInInitializerError(ex); - } - } - - public static SessionFactory getSessionFactory() { - return sessionFactory; - } - -}]]></programlisting> - - <para> - Esta classe não só produz a global <literal>SessionFactory</literal> no seu static initializer - (chamado uma vez pela JVM quando a classe é carregada), mas também esconde o fato - de que isto usa um static singleton. Ela pode muito bem, enxergar a - <literal>SessionFactory</literal> do JNDI em um application server. - </para> - - <para> - Se você der à <literal>SessionFactory</literal> um nome, no seu arquivo de configuração. - O Hibernate irá, de fato, tentar uni-lo ao JNDI depois que estiver construído. - Para evitar este completamente este código, você também poderia usar JMX deployment - e deixar o contêiner JMX capaz, instanciar e unir um <literal>HibernateService</literal> - no JNDI. Essas opções avançadas são discutidas no documento de referência do Hibernate. - </para> - - <para> - Coloque o <literal>HibernateUtil.java</literal> no diretório de arquivos - de desenvolvimento(source), em um pacote após o <literal>events</literal>: - </para> - - <programlisting><![CDATA[. -+lib - <Hibernate and third-party libraries> -+src - +events - Event.java - Event.hbm.xml - +util - HibernateUtil.java - hibernate.cfg.xml -+data -build.xml]]></programlisting> - - <para> - Novamente, isto deve compilar sem problemas. Finalmente, nós precisamos configurar - um sistema de logging – o Hibernate usa commons logging e deixa você escolher entre o - Log4j e o logging do JDK 1.4 . A maioria dos desenvolvedores preferem o Log4j: copie - <literal>log4j.properties</literal> da distribuição do Hibernate (está no diretório - <literal>etc/</literal>), para seu diretório <literal>src</literal>, - depois vá em hibernate.cfg.xml. Dê uma olhada no exemplo de configuração e mude as - configurações se você quizer ter uma saída mais detalhada. Por default, apenas as - mensagems de startup e shwwn do Hibernate é mostrada no stdout. - </para> - - <para> - O tutorial de infra-estrutura está completo - e nós já estamos preparados para algum - trabalho de verdade com o Hibernate. - </para> - - </sect2> - - <sect2 id="tutorial-firstapp-workingpersistence" revision="4"> - <title>Carregando e salvando objetos</title> - - <para> - Finalmente, nós podemos usar o Hibernate para carregar e armazenar objetos. - Nós escrevemos uma classe <literal>EventManager</literal> com um método main(): - </para> - - <programlisting><![CDATA[package events; -import org.hibernate.Session; - -import java.util.Date; - -import util.HibernateUtil; - -public class EventManager { - - public static void main(String[] args) { - EventManager mgr = new EventManager(); - - if (args[0].equals("store")) { - mgr.createAndStoreEvent("My Event", new Date()); - } - - HibernateUtil.getSessionFactory().close(); - } - - private void createAndStoreEvent(String title, Date theDate) { - - Session session = HibernateUtil.getSessionFactory().getCurrentSession(); - - session.beginTransaction(); - - Event theEvent = new Event(); - theEvent.setTitle(title); - theEvent.setDate(theDate); - - session.save(theEvent); - - session.getTransaction().commit(); - } - -}]]></programlisting> - - <para> - Nós criamos um novo objeto <literal>Event</literal>, e passamos para o Hibernate. - O Hibernate sabe como tomar conta do SQL e executa <literal>INSERT</literal>s - no banco de dados. Vamos dar uma olhada na <literal>Session</literal> e no - código <literal>Transaction</literal>-handling antes de executarmos. - </para> - - <para> - Um <literal>Session</literal> é uma unidade simples de trabalho. Por agora nós - iremos pegar coisas simples e assumir uma granularidade de um-pra-um entre uma - <literal>Session</literal> do Hibernate e uma transação de banco de dados. - Para proteger nosso código de um atual sistema subjacente de transação (nesse - caso puro JDBC, mas também poderia rodar com JTA), nos usamos a API - <literal>Transaction</literal>, que está disponível na <literal>Session</literal> do Hibernate. - </para> - - <para> - O que a <literal>sessionFactory.getCurrentSession()</literal> faz? Primeiro, você pode - chamar quantas vezes e de onde quiser, uma vez você recebe sua <literal>SessionFactory</literal> - (fácil graças ao <literal>HibernateUtil</literal>). O método <literal>getCurrentSession()</literal> - sempre retorna a unidade de trabalho "corrente". Lembra de que nós mudamos a opção - de configuração desse mecanismo para thread no <literal>hibernate.cfg.xml</literal>? Daqui em - diante, o escopo da unidade de trabalho corrente é a thread Java - corrente que executa nossa aplicação. Entretanto, esta não é toda a verdade. Uma - <literal>Session</literal> começa quando é primeiramente necessária, quando é feita a - primeira chamada à <literal>getCurrentSession()</literal>. É então limitado pelo Hibernate - para thread corrente. Quando a transação termina, tanto com commit quanto rollback, - o Hibernate também desune a <literal>Session</literal> da thread e fecha isso pra você. - Se você chamar <literal>getCurrentSession()</literal> novamente, você receberá uma nova - <literal>Session</literal> e pode começar uma nova unidade de trabalho. Esse modelo de - programação de limite de thread <emphasis>thread-bound</emphasis>, é o modo mais popular - de se usar o Hibernate. - </para> - - <para> - Dê uma olhada no <xref linkend="transactions"/> para mais informações a - respeito de manipulação de transação e demarcação. Nós também pulamos qualquer - manipulação de erro e rollback no exemplo anterior. - </para> - - <para> - Para executar esta primeira rotina, nos teremos que adicionar um ponto de chamada - para o arquivo de build do Ant: - </para> - - <programlisting><![CDATA[<target name="run" depends="compile"> - <java fork="true" classname="events.EventManager" classpathref="libraries"> - <classpath path="${targetdir}"/> - <arg value="${action}"/> - </java> -</target>]]></programlisting> - - <para> - O valor do argumento <literal>action</literal>, é setado na linha de comando quando chamando esse ponto: - </para> - - <programlisting><![CDATA[C:\hibernateTutorial\>ant run -Daction=store]]></programlisting> - - <para> - Você deverá ver, após a compilação, o startup do Hibernate e, dependendo da sua - configuração, muito log de saída. No final você verá a seguinte linha: - </para> - - <programlisting><![CDATA[[java] Hibernate: insert into EVENTS (EVENT_DATE, title, EVENT_ID) values (?, ?, ?)]]></programlisting> - - <para> - Este é o <literal>INSERT</literal> executado pelo Hibernate, os pontos de interrogação - representam parêmetros de união do JDBC. Para ver os valores substituídos, ou para diminuir a - verbalidade do log, check seu l<literal>log4j.properties</literal>. - </para> - - <para> - Agora nós gostaríamos de listar os eventos arquivados, então nós adicionamos uma - opção para o método main: - </para> - - <programlisting><![CDATA[if (args[0].equals("store")) { - mgr.createAndStoreEvent("My Event", new Date()); -} -else if (args[0].equals("list")) { - List events = mgr.listEvents(); - for (int i = 0; i < events.size(); i++) { - Event theEvent = (Event) events.get(i); - System.out.println("Event: " + theEvent.getTitle() + - " Time: " + theEvent.getDate()); - } -}]]></programlisting> - - <para> - Nos também adicionamos um novo <literal>método listEvents()</literal>: - </para> - - <programlisting><![CDATA[private List listEvents() { - - Session session = HibernateUtil.getSessionFactory().getCurrentSession(); - - session.beginTransaction(); - - List result = session.createQuery("from Event").list(); - - session.getTransaction().commit(); - - return result; -}]]></programlisting> - - <para> - O que nós fazemos aqui, é usar uma query HQL (Hibernate Query Language), - para carregar todos os objetos <literal>Event</literal> exitentes no banco de dados. - O Hibernate irá gerar o SQL apropriado, enviar para o banco de dados e popular objetos - <literal>Event</literal> com os dados. Você pode criar queries mais complexas com - HQL, claro. - </para> - - <para> - Agora, para executar e testar tudo isso, siga os passos a seguir: - </para> - - <itemizedlist> - <listitem> - <para> - Execute <literal>ant run -Daction=store</literal> para armazenar algo no banco de dados - e, claro, gerar o esquema do banco de dados antes pelo hbm2ddl. - </para> - </listitem> - <listitem> - <para> - Agora desabilite hbm2ddl comentando a propriedade no seu arquivo <literal>hibernate.cfg.xml</literal>. - Normalmente só se deixa habilitado em teste unitários contínuos, mas outra carga de hbm2ddl - pode <emphasis>remover</emphasis> tudo que você já tenha arquivado. Sa configuração - <literal>create</literal>, atualmente são traduzidas para "apague todas as tabelas do esquema, - então recrie todas quando a SessionFactory estiver pronta". - </para> - </listitem> - </itemizedlist> - - <para> - Se você agora chamar o Ant com <literal>-Daction=list</literal>, você deverá ver os - eventos que você acabou de criar. Você pode também chamar a ação <literal>store</literal> - mais algumas vezes. - </para> - - <para> - Nota: A maioria dos novos usuários do Hibernate falha nesse ponto e nós regularmente, vemos - questões sobre mensagens de erro de <emphasis>tabela não encontrada </emphasis> . - Entretanto, se você seguir os passos marcados acima, você não terá esse problema, - com o hbm2ddl criando o esquema do banco de dados na primeira execução, e restarts - subsequentes da aplicação irão usar este esquema. Se você mudar o mapeamento e/ou - o esquema do banco de dados, terá de re-habilitar o hbm2ddl mais uma vez. - </para> - - </sect2> - - </sect1> - - <sect1 id="tutorial-associations"> - <title>Part 2 - Mapeando associações</title> - - <para> - Nós mapeamos uma classe de entidade de persistência para uma tabela. Agora vamos continuar - e adicionar algumas associações de classe. Primeiro nos iremos adicionar pessoas a nossa aplicação, - e armazenar os eventos de que elas participam. - </para> - - <sect2 id="tutorial-associations-mappinguser" revision="1"> - <title>Mapeando a classe Person</title> - - <para> - O primeiro código da classe <literal>Person</literal> é simples: - </para> - - <programlisting><![CDATA[package events; - -public class Person { - - private Long id; - private int age; - private String firstname; - private String lastname; - - public Person() {} - - // Accessor methods for all properties, private setter for 'id' - -}]]></programlisting> - - <para> - Crie um novo arquivo de mapeamento, chamado <literal>Person.hbm.xml</literal> (não - esqueça a referencia ao DTD no topo) - </para> - - <programlisting><![CDATA[<hibernate-mapping> - - <class name="events.Person" table="PERSON"> - <id name="id" column="PERSON_ID"> - <generator class="native"/> - </id> - <property name="age"/> - <property name="firstname"/> - <property name="lastname"/> - </class> - -</hibernate-mapping>]]></programlisting> - - <para> - Finalmente, adicione o novo mapeamento a configuração do Hibernate: - </para> - - <programlisting><![CDATA[<mapping resource="events/Event.hbm.xml"/> -<mapping resource="events/Person.hbm.xml"/>]]></programlisting> - - <para> - Nos iremos agora criar uma associação entre estas duas entidades. Obviamente, - pessoas (Person) podem participar de eventos, e eventos possuem participantes. - As questões de design com que teremos de lidar são: direcionalidade, multiplicidade e - comportamento de coleção. - </para> - - </sect2> - - <sect2 id="tutorial-associations-unidirset" revision="3"> - <title>Uma associação Set-based unidirectional</title> - - <para> - Nos iremos adicionar uma coleção de eventos na classe <literal>Person</literal>. Desse jeito - poderemos navegar pelos eventos de uma pessoa em particular, sem executar uma query explicitamente – - apenas chamando <literal>aPerson.getEvents()</literal>. Nos usaremos uma coleção Java, um - <literal>Set</literal>, porquê a coleção não conterá elementos duplicados e a ordem não é - relevante para nós. - </para> - - <para> - Vamos escrever o código para isto nas classes Java e então mapear: - </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> - Antes de mapearmos esta associação, pense no outro lado. Claramente, poderíamos apenas fazer isto de - forma unidirecional. Ou poderíamos criar outra coleção no <literal>Event</literal>, se quisermos - ser capaz de navegar bidirecionalmente, i.e. um - <literal>anEvent.getParticipants()</literal>. - Isto não é necessário, de perspectiva funcional. Você poderia sempre executar uma query explicita - que retornasse os participantes de um evento em particular. Esta é uma escolha de design que cabe - a você, mas o que é claro nessa discussão é a multiplicidade da associação: "muitos" valores em ambos - os lados, nós chamamos isto uma associação <emphasis>muitos-para-muitos</emphasis>. Daqui pra frente, - nos usaremos o mapeamento muitos-para-muitos do Hibernate: - </para> - - <programlisting><![CDATA[<class name="events.Person" table="PERSON"> - <id name="id" column="PERSON_ID"> - <generator class="native"/> - </id> - <property name="age"/> - <property name="firstname"/> - <property name="lastname"/> - - <set name="events" table="PERSON_EVENT"> - <key column="PERSON_ID"/> - <many-to-many column="EVENT_ID" class="events.Event"/> - </set> - -</class>]]></programlisting> - - <para> - O Hibernate suporta todo tipo de mapeamento de coleção , sendo um <literal><set></literal> mais comum. - Para uma associação muitos-para-muitos (ou relacionamento de entidade <emphasis>n:m</emphasis> ), - uma tabela de associação é necessária. Cada linha nessa tabela representa um link entre uma pessoa e um - evento. O nome da tabela é configurado com o atributo <literal>table</literal> do elemento - <literal>set</literal>. O nome da coluna identificadora na associção, peloo lado da pessoa, - é definido com o elemento <literal><key></literal> , o nome da coluna pelo lado dos eventos, - e definido com o atributo <literal>column</literal> do <literal><many-to-many></literal>. - Você também precisa dizer para o Hibernate a classe dos objetos na sua coleção (a classe do outro - lado das coleções de referência). - </para> - - <para> - O esquema de mapeamento para o banco de dados está a seguir: - </para> - - <programlisting><![CDATA[ - _____________ __________________ - | | | | _____________ - | EVENTS | | PERSON_EVENT | | | - |_____________| |__________________| | PERSON | - | | | | |_____________| - | *EVENT_ID | <--> | *EVENT_ID | | | - | EVENT_DATE | | *PERSON_ID | <--> | *PERSON_ID | - | TITLE | |__________________| | AGE | - |_____________| | FIRSTNAME | - | LASTNAME | - |_____________| - ]]></programlisting> - - </sect2> - - <sect2 id="tutorial-associations-working" revision="1"> - <title>Trabalhando a associação</title> - - <para> - Vamos trazer juntos algumas pessoas e eventos em um novo método na classe <literal>EventManager</literal>:: - </para> - - <programlisting><![CDATA[private void addPersonToEvent(Long personId, Long eventId) { - - 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); - - session.getTransaction().commit(); -}]]></programlisting> - - <para> - Após carregar um <literal>Person</literal> e um <literal>Event</literal>, simplesmente - modifique a coleção usando os métodos normais de uma coleção. Como você pode ver, não há chamada explícita - para <literal>update()</literal> ou <literal>save()</literal>, o Hibernate detecta automaticamente - que a coleção foi modificada e necessita ser atualizada. Isso é chamado de <emphasis>checagem - suja automática</emphasis>, e você também pode usá-la modificando o nome ou a data de qualquer um dos - seus objetos. Assim que eles estiverem no estado <emphasis>persistent</emphasis>, ou seja, - limitado por uma <literal>Session</literal> do Hibernate em particular (i.e. eles foram carregados ou - salvos dentro de uma unidade de trabalho), o Hibernate monitora qualquer alteração e executa o SQL - em modo de escrita em segundo plano. O processo de sincronização do estado da memória com o banco de - dados, geralmente apenas no final de uma unidade de trabalho, é chamado de <emphasis>flushing</emphasis>. - No nosso código, a unidade de trabalho termina com o commit da transação do banco de dados – - como definido pela opção de configuração da <literal>thread</literal> da classe <literal>CurrentSessionContext</literal>. - </para> - - <para> - Você pode também querer carregar pessoas e eventos em diferentes unidades de trabalho. - Ou você modifica um objeto fora de uma <literal>Session</literal>, quando não se encontra no - estado persistent (se já esteve neste estado anteriormente, chamamos esse estado de - <emphasis>detached</emphasis>). Você pode até mesmo modificar uma coleção quando esta - se encontrar no estado detached. - </para> - - <programlisting><![CDATA[private void addPersonToEvent(Long personId, Long eventId) { - - Session session = HibernateUtil.getSessionFactory().getCurrentSession(); - session.beginTransaction(); - - 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 - - Event anEvent = (Event) session.load(Event.class, eventId); - - session.getTransaction().commit(); - - // End of first unit of work - - aPerson.getEvents().add(anEvent); // aPerson (and its collection) is detached - - // Begin second unit of work - - Session session2 = HibernateUtil.getSessionFactory().getCurrentSession(); - session2.beginTransaction(); - - session2.update(aPerson); // Reattachment of aPerson - - session2.getTransaction().commit(); -}]]></programlisting> - - <para> - A chamada <literal>update</literal> cria um objeto persistent novamente, você poderia - dizer que ele liga o objeto a uma nova unidade de trabalho, assim qualquer modificação - que você faça neste objeto enquanto estiver no estado detached pode ser salvo no banco de dados. - Isso inclui qualquer modificação (adição/exclusão) que você faça em uma coleção da entidade deste objeto. - </para> - - <para> - Bom, isso não foi muito usado na nossa situação, porém, é um importante conceito que você - pode aplicar em seus aplicativos. Agora, complete este exercício adicionando uma nova ação - ao método main( ) da classe <literal>EventManager</literal> e chame-o pela linha de comando. - Se você precisar dos identificadores de uma pessoa ou evento – o método <literal>save()</literal> - retorna estes identificadores (você poderá modificar alguns dos métodos anteriores para retornar aquele - identificador): - </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> - Este foi um exemplo de uma associação entre duas classes igualmente importantes, duas entidades. - Como mencionado anteriormente, há outras classes e tipos dentro de um modelo típico, - geralmente "menos importante". Alguns você já viu, como um <literal>int</literal> ou uma <literal>String</literal>. - Nós chamamos essas classes de <emphasis>value types</emphasis>, e suas instâncias <emphasis>depend</emphasis> - de uma entidade particular. As instâncias desses tipos não possuem sua própria identidade, nem são - compartilhados entre entidades (duas pessoas não referenciam o mesmo objeto <literal>firstname</literal> - mesmo se elas tiverem o mesmo objeto firstname). Naturalmente, os value types não são apenas encontrados - dentro da JDK (de fato, em um aplicativo Hibernate todas as classes JDK são consideradas como value types), - mas você pode também criar suas classes como, por exemplo, <literal>Address</literal> ou <literal>MonetaryAmount</literal>. - - </para> - - <para> - Você também pode criar uma coleção de value types. Isso é conceitualmente muito diferente - de uma coleção de referências para outras entidades, mas em Java parece ser quase a mesma coisa. - </para> - - </sect2> - - <sect2 id="tutorial-associations-valuecollections"> - <title>Coleção de valores</title> - - <para> - Nós adicionamos uma coleção de objetos de tipo de valores à entidade <literal>Person</literal>. - Nós querermos armazenar endereços de e-mail, para isso utilizamos o tipo <literal>String</literal>, - e a coleção novamente será um <literal>Set</literal>: - </para> - <programlisting><![CDATA[private Set emailAddresses = new HashSet(); - -public Set getEmailAddresses() { - return emailAddresses; -} - -public void setEmailAddresses(Set emailAddresses) { - this.emailAddresses = emailAddresses; -}]]></programlisting> - - <para> - O mapeamento deste <literal>Set</literal>: - </para> - - <programlisting><![CDATA[<set name="emailAddresses" table="PERSON_EMAIL_ADDR"> - <key column="PERSON_ID"/> - <element type="string" column="EMAIL_ADDR"/> -</set>]]></programlisting> - - <para> - A diferença comparada com o mapeamento anterior se encontra na parte <literal>element</literal>, - que indica ao Hibernate que a coleção não contém referências à outra entidade, mas uma coleção de - elementos do tipo <literal>String</literal> (a tag name em miniscula indica que se trata de um - mapeamento do Hibernate para conversão de tipos). Mais uma vez, o atributo <literal>table</literal> - do elemento <literal>set</literal> determina o nome da tabela para a coleção. O elemento - <literal>key</literal> define o nome da coluna de chave estrangeira na tabela de coleção. - O atributo <literal>column</literal> dentro do elemento <literal>element</literal> define o - nome da coluna onde os valores da <literal>String</literal> serão armazenados. - </para> - - <para> - Dê uma olhada no esquema atualizado: - </para> - - <programlisting><![CDATA[ - _____________ __________________ - | | | | _____________ - | EVENTS | | PERSON_EVENT | | | ___________________ - |_____________| |__________________| | PERSON | | | - | | | | |_____________| | PERSON_EMAIL_ADDR | - | *EVENT_ID | <--> | *EVENT_ID | | | |___________________| - | EVENT_DATE | | *PERSON_ID | <--> | *PERSON_ID | <--> | *PERSON_ID | - | TITLE | |__________________| | AGE | | *EMAIL_ADDR | - |_____________| | FIRSTNAME | |___________________| - | LASTNAME | - |_____________| - ]]></programlisting> - - <para> - Você pode observar que a chave primária da tabela da coleção é de na verdade uma chave composta, - usando ambas colunas. Isso também implica que cada pessoa não pode ter endereços de e-mail - duplicados, o que é exatamente a semântica que precisamos para um set em Java. - </para> - - <para> - Você pode agora tentar adicionar elementos a essa coleção, do mesmo modo que fizemos - anteriormente ligando pessoas e eventos. È o mesmo código em 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> - This time we didnt' use a <emphasis>fetch</emphasis> query to initialize the collection. - Hence, the call to its getter method will trigger an additional select to initialize - it, so we can add an element to it. Monitor the SQL log and try to optimize this with - an eager fetch. - </para> - - </sect2> - - <sect2 id="tutorial-associations-bidirectional" revision="1"> - <title>Associações bidirecionais</title> - - <para> - Agora iremos mapear uma associação bidirecional – fazendo a associação entre pessoas e - eventos, de ambos os lados, em Java. Logicamente, o esquema do banco de dados não muda, - nós continuamos tendo multiplicidades muitos-para-muitos. Um banco de dados é mais flexível do que - uma linguagem de programação para redes, ele não precisa de nenhuma direção de navegação – os - dados podem ser acessados em qualquer caminho possível. - </para> - - <para> - Primeiramente, adicione uma coleção de participantes à classe <literal>Event</literal>: - </para> - - <programlisting><![CDATA[private Set participants = new HashSet(); - -public Set getParticipants() { - return participants; -} - -public void setParticipants(Set participants) { - this.participants = participants; -}]]></programlisting> - - <para> - Agora mapeie este lado da associação em <literal>Event.hbm.xml</literal>. - </para> - - <programlisting><![CDATA[<set name="participants" table="PERSON_EVENT" inverse="true"> - <key column="EVENT_ID"/> - <many-to-many column="PERSON_ID" class="events.Person"/> -</set>]]></programlisting> - - <para> - Como você pode ver, esses é uma mapeamento normal usando <literal>set</literal> em ambos documenentos - de mapeamento. Observe que o nome das colunas em <literal>key</literal> e <literal>many-to-many</literal> - estão trocados em ambos os documentos de mapeamento. A adição mais importante feita está no atributo - <literal>inverse="true"</literal> no elemento set do mapeamento da coleção da classe <literal>Event</literal>. - </para> - - <para> - Isso significa que o Hibernate deve pegar o outro lado – a classe <literal>Person</literal> – - quando necessitar encontrar informação sobre a relação entre as duas entidades. Isso será muito - mais facilmente compreendido quando você analisar como a relação bidirecional entre as entidades é criada. - </para> - - </sect2> - - <sect2 id="tutorial-associations-usingbidir"> - <title>Trabalhando com links bidirecionais</title> - - <para> - Primeiro tenha em mente que o Hibernate não afeta a semântica normal do Java. Como nós criamos - um link entre uma <literal>Person</literal> e um <literal>Event</literal> no exemplo unidirecional? - Nós adicionamos uma instância de <literal>Event</literal>, da coleção de referências de eventos, - a uma instância de <literal>Person</literal>. Então, obviamente, se nós queremos que este link funcione - bidirecionalmente, nós devemos fazer a mesma coisa para o outro lado – adicionando uma referência de - <literal>Person</literal> na coleção de um <literal>Event</literal>. Esse acerto de link de ambos - os lados é absolutamente necessário e você nunca deve esquecer de faze-lo. - </para> - - <para> - Muitos desenvolvedores programam de maneira defensiva e criam métodos - gerenciador de associações que ajusta corretamente ambos os lados: - </para> - - <programlisting><![CDATA[protected Set getEvents() { - return events; -} - -protected void setEvents(Set events) { - this.events = events; -} - -public void addToEvent(Event event) { - this.getEvents().add(event); - event.getParticipants().add(this); -} - -public void removeFromEvent(Event event) { - this.getEvents().remove(event); - event.getParticipants().remove(this); -}]]></programlisting> - - <para> - Observe que os métodos set e get da a coleção estão protegidos – isso permite que classes e - subclasses do mesmo pacote continuem acessando os métodos, mas previne que qualquer outra classe, - que não esteja no mesmo pacote, acesse a coleção diretamente. Você provavelmente deve fazer a mesma - coisa para a coleção do outro lado. - </para> - - <para> - E sobre o mapeamento do atributo <literal>inverse</literal>? Pra você, e para o Java, um link bidirecional - é simplesmente o fato de ajustar corretamente as referências de ambos os lados. O Hibernate, entretanto - não possui informação necessária para corretamente adaptar os estados <literal>INSERT</literal> e - <literal>UPDATE</literal> do SQL, e precisa de ajuda para manipular as propriedades das associações - bidirecionais. Fazer um lado da associação com o atributo <literal>inverse</literal> instrui o Hibernate - para basicamente ignora-lo, considerando-o uma <emphasis>cópia</emphasis> do outro lado. Isso é todo o - necessário para o Hibernate trabalhar com todas as possibilidades quando transformando um modelo de - navegação bidirecional em esquema de banco de dados do SQL. As regras que você possui para lembrar são - diretas: Todas associações bidirecionais necessitam que um lado possua o atributo inverse. Em uma - associação de um-para-muitos, o lado de "muitos" deve conter o atributo <literal>inverse</literal>, - já em uma associação de muitos-para-muitos você pode pegar qualquer lado, não há diferença. - </para> - - </sect2> - - <para> - Agora, vamos portar este exemplo para um pequeno aplicativo para internet. - - </para> - - </sect1> - - <sect1 id="tutorial-webapp"> - <title>EventManager um aplicativo para internet</title> - - <para> - Um aplicativo para internet do Hibernate usa uma <literal>Session</literal> e uma <literal>Transaction</literal> - quase do mesmo modo que um aplicativo standalone. Entretanto, alguns patterns comuns são úteis. - Nós agora criaremos um <literal>EventManagerServlet</literal>. Esse servlet lista todos os eventos - salvos no banco de dados, e cria um formulário HTML para entrada de novos eventos. - </para> - - <sect2 id="tutorial-webapp-servlet" revision="1"> - <title>Criando um servlet básico</title> - - <para> - Crie uma nova classe no seu diretório fonte, no pacote <literal>events</literal>: - </para> - - <programlisting><![CDATA[package events; - -// Imports - -public class EventManagerServlet extends HttpServlet { - - // Servlet code -}]]></programlisting> - - <para> - O servlet manuseia somente requisições <literal>GET</literal> do HTTP, - portanto o método que iremos implementar é <literal>doGet()</literal>: - </para> - - <programlisting><![CDATA[protected void doGet(HttpServletRequest request, - HttpServletResponse response) - throws ServletException, IOException { - - SimpleDateFormat dateFormatter = new SimpleDateFormat("dd.MM.yyyy"); - - try { - // Begin unit of work - HibernateUtil.getSessionFactory() - .getCurrentSession().beginTransaction(); - - // Process request and render page... - - // End unit of work - HibernateUtil.getSessionFactory() - .getCurrentSession().getTransaction().commit(); - - } catch (Exception ex) { - HibernateUtil.getSessionFactory() - .getCurrentSession().getTransaction().rollback(); - throw new ServletException(ex); - } - -}]]></programlisting> - - <para> - O pattern que estamos aplicando neste código é chamado <emphasis>session-per-request</emphasis>. - Quando uma requisição chega ao servlet, uma nova <literal>Session</literal> do Hibernate é - aberta através da primeira chamada para <literal>getCurrentSession()</literal> em - <literal>SessionFactory</literal>. Então uma transação do banco de dados é inicializada - - todo acesso a dados deve ocorrer dentro de uma transação, não importando se o dado é de leitura ou escrita. - (nós não devemos usar o modo auto-commit em aplicações). - - </para> - - <para> - Agora, as possibilidades de ações de uma requisição serão processadas e uma resposta HTML será renderizada. - Nós já iremos chegar nesta parte. - </para> - - <para> - Finalmente, a unidade de trabalho termina quando o processamento e a restituição são completados. - Se ocorrer algum erro durante o processamento ou a restituição, uma exceção será lançada e a - transação do banco de dados encerrada. Isso completa o pattern <literal>session-per-request</literal>. - Em vez de usar código de demarcação de transação em todo servlet você pode também criar um filtro servlet. - Dê uma olhada no site do Hibernate e do Wiki para maiores informações sobre esse pattern, - chamado <emphasis>Open Session in View</emphasis>. - </para> - - </sect2> - - <sect2 id="tutorial-webapp-processing" revision="1"> - <title>Processando e renderizando</title> - - <para> - Vamos implementar o processamento da requisição e a restituição da página HTML. - </para> - -<programlisting><![CDATA[// Write HTML header -PrintWriter out = response.getWriter(); -out.println("<html><head><title>Event Manager</title></head><body>"); - -// Handle actions -if ( "store".equals(request.getParameter("action")) ) { - - String eventTitle = request.getParameter("eventTitle"); - String eventDate = request.getParameter("eventDate"); - - if ( "".equals(eventTitle) || "".equals(eventDate) ) { - out.println("<b><i>Please enter event title and date.</i></b>"); - } else { - createAndStoreEvent(eventTitle, dateFormatter.parse(eventDate)); - out.println("<b><i>Added event.</i></b>"); - } -} - -// Print page -printEventForm(out); -listEvents(out, dateFormatter); - -// Write HTML footer -out.println("</body></html>"); -out.flush(); -out.close();]]></programlisting> - - <para> - O estilo de código acima, misturando linguagem HTML e Java não será funcional em um aplicativo - mais complexo—tenha em mente que neste manual nós estamos apenas ilustrando conceitos - básicos do Hibernate. O código imprime um cabeçalho HTML e um rodapé. Dentro desta página, - é mostrado um formulário em HTML, para entrada de novos eventos, e uma lista de todos - os eventos contidos no banco de dados. O primeiro método é trivial e apenas imprime - uma página HTML: - </para> - - <programlisting><![CDATA[private void printEventForm(PrintWriter out) { - out.println("<h2>Add new event:</h2>"); - out.println("<form>"); - out.println("Title: <input name='eventTitle' length='50'/><br/>"); - out.println("Date (e.g. 24.12.2009): <input name='eventDate' length='10'/><br/>"); - out.println("<input type='submit' name='action' value='store'/>"); - out.println("</form>"); -}]]></programlisting> - - <para> - O método <literal>listEvents()</literal> usa a <literal>Session</literal> do Hibernate - associada a thread atual para executar um query: - </para> - - <programlisting><![CDATA[private void listEvents(PrintWriter out, SimpleDateFormat dateFormatter) { - - List result = HibernateUtil.getSessionFactory() - .getCurrentSession().createCriteria(Event.class).list(); - if (result.size() > 0) { - out.println("<h2>Events in database:</h2>"); - out.println("<table border='1'>"); - out.println("<tr>"); - out.println("<th>Event title</th>"); - out.println("<th>Event date</th>"); - out.println("</tr>"); - for (Iterator it = result.iterator(); it.hasNext();) { - Event event = (Event) it.next(); - out.println("<tr>"); - out.println("<td>" + event.getTitle() + "</td>"); - out.println("<td>" + dateFormatter.format(event.getDate()) + "</td>"); - out.println("</tr>"); - } - out.println("</table>"); - } -}]]></programlisting> - - <para> - Finalmente, a action <literal>store</literal> é passada pra o método - <literal>createAndStoreEvent()</literal>, que também usa a - <literal>Session</literal> da thread atual: - </para> - - <programlisting><![CDATA[protected void createAndStoreEvent(String title, Date theDate) { - Event theEvent = new Event(); - theEvent.setTitle(title); - theEvent.setDate(theDate); - - HibernateUtil.getSessionFactory() - .getCurrentSession().save(theEvent); -}]]></programlisting> - - <para> - Pronto, o servlet está completo. Uma requisição para o servlet será processada - em uma <literal>Session</literal> e uma <literal>Transaction</literal> simples. - Como anteriormente, no aplicativo standalone, o Hibernate pode automaticamente - associar esses objetos a thread atual em execução. Isso possibilita a liberdade - de você modelar seu código e acessar o método <literal>SessionFactory</literal> - do jeito que achar melhor. Geralmente você irá usar um design mais sofisticado - e mover o código de acesso a dados para dentro de objetos de acesso a dados - (o patter DAO). Leia o Hibernate Wiki para maiores exemplos. - </para> - - </sect2> - - <sect2 id="tutorial-webapp-deploy"> - <title>Instalando e testando</title> - - <para> - Para fazer o deploy desta aplicação você tem que criar um arquivo para web, um WAR. - Adicione o alvo Ant abaixo em seu <literal>build.xml</literal>: - </para> - -<programlisting><![CDATA[<target name="war" depends="compile"> - <war destfile="hibernate-tutorial.war" webxml="web.xml"> - <lib dir="${librarydir}"> - <exclude name="jsdk*.jar"/> - </lib> - - <classes dir="${targetdir}"/> - </war> -</target>]]></programlisting> - - <para> - Esta target cria um arquivo chamado <literal>hibernate-tutorial.war</literal> - no diretório do seu projeto. Ele empacota todas as bibliotecas e o arquivo de - descrição <literal>web.xml</literal>, o qual é esperado no diretório base do seu projeto: - </para> - - <programlisting><![CDATA[<?xml version="1.0" encoding="UTF-8"?> -<web-app version="2.4" - xmlns="http://java.sun.com/xml/ns/j2ee" - xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" - xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"> - - <servlet> - <servlet-name>Event Manager</servlet-name> - <servlet-class>events.EventManagerServlet</servlet-class> - </servlet> - - <servlet-mapping> - <servlet-name>Event Manager</servlet-name> - <url-pattern>/eventmanager</url-pattern> - </servlet-mapping> -</web-app>]]></programlisting> - - <para> - Antes de você compilar e fazer o deploy desta aplicação web, note que uma biblioteca - adicional é requerida: <literal>jsdk.jar</literal>. Esse é o Java servlet development kit, - se você não possui esta biblioteca, faça seu download na página da Sun e copie-a - para seu diretório de bibliotecas. Entretanto, será usado somente para a compilação e - excluído do pacote WAR. - </para> - - <para> - Para compilar e instalar execute <literal>ant war</literal> no seu diretório do projeto - e copie o arquivo <literal>hibernate-tutorial.war</literal> para o diretório - <literal>webapp</literal> do Tomcat. Se você não possui o Tomcat instalado faça - o download e siga as instruções de instalação. Você não precisa modificar - nenhuma configuração do Tomcat para rodar este aplicativo. - </para> - - <para> - Uma vez feito o deploy e com Tomcat rodando, acesse o aplicativo em - <literal>http://localhost:8080/hibernate-tutorial/eventmanager</literal>. - Veja o log do Tomcat para observar a inicialização do Hibernate quando a - primeira requisição chega ao servlet (o inicializador estático dentro de - <literal>HibernateUtil</literal> é chamado) e para ter uma depuração - detalhada se ocorrer alguma exceção. - </para> - - </sect2> - - </sect1> - - <sect1 id="tutorial-summary" revision="1"> - <title>Sumário</title> - - <para> - Este manual cobriu os princípios básicos para criação de uma aplicação simples do Hibernate - e uma pequena aplicação web. - </para> - - <para> - Se você já se sente seguro com o Hibernate, continue navegando na documentação de referência - por tópicos que você acha interessante – os tópicos mais questionados são: - processo de transação (<xref linkend="transactions"/>), uso da API (<xref linkend="objectstate"/>) - e características de consulta (<xref linkend="objectstate-querying"/>). - </para> - - <para> - Não esqueça de visitar o site do Hibernate para obter mais tutoriais especializados. - </para> - - </sect1> - -</chapter> +<chapter id="tutorial"> + <title>Introdução ao Hibernate</title> + + <sect1 id="tutorial-intro" revision="1"> + <title>Prefácio</title> + + <para> + Este capítulo é um tutorial introdutório para novos usuários do Hibernate. Nós iniciaremos com uma simples linha de comando em uma aplicação usando uma base de dados em memória tornando isto um passo de fácil de compreender. + </para> + + <para> + Este tutorial é voltado para novos usuários do Hibernate, mas requer um conhecimento de Java e SQL. Este tutorial é baseado no tutorial de Michael Gloegl, as bibliotecas Third Party foram nomeadas para JDK 1.4 e 5.0. Você pode precisar de outras bibliotecas para JDK 1.3. + </para> + + <para> + O código fonte para o tutorial está incluído no diretório da distribuição + <literal>doc/reference/tutorial/</literal>. + </para> + + </sect1> + + <sect1 id="tutorial-firstapp" revision="2"> + <title>Parte 1 – A primeira aplicação Hibernate</title> + + <para> + Primeiro, iremos criar uma simples aplicação Hibernate baseada em console. Usaremos uma base de dados Java (HSQL DB), então não teremos que instalar nenhum servidor de base de dados. + </para> + + <para> + Vamos supor que precisemos de uma aplicação com um banco de dados pequeno que possa armazenar e atender os eventos que queremos, e as informaççes sobre os hosts destes eventos. + </para> + + <para> + A primeira coisa que devemos fazer é configurar nosso diretório de desenvolvimento, + e colocar todas as bibliotecas Java que precisamos dentro dele. Faça o download da + distribuição do Hibernate no site do Hibernate. Descompacte o pacote e coloque todas + as bibliotecas necessárias encontradas no diretório <literal>/lib</literal>, dentro do + diretório <literal>/lib</literal> do seu novo projeto. Você deverá ter algo parecido + com isso: + </para> + + <programlisting><![CDATA[. ++lib + antlr.jar + cglib.jar + asm.jar + asm-attrs.jars + commons-collections.jar + commons-logging.jar + hibernate3.jar + jta.jar + dom4j.jar + log4j.jar ]]></programlisting> + + <para> + Esta é a configuração mínima requerida das bibliotecas (observe que também foi copiado + o hibernate3.jar da pasta principal do Hibernate) para o Hibernate <emphasis>na hora do desenvolvimento</emphasis>. O Hibernate permite que você utilize mais ou menos bibliotecas. + Veja o arquivo <literal>README.txt</literal> no diretório <literal>lib/</literal> da distribuição + do Hibernate para maiores informaççes sobre bibliotecas requeridas e opcionais. + (Atualmente, a biblioteca Log4j não é requerida, mas é preferida por muitos desenvolvedores.) + </para> + + <para> + Agora, iremos criar uma classe que representa o evento que queremos armazenar na base de dados.. + </para> + + <sect2 id="tutorial-firstapp-firstclass" revision="1"> + <title>A primeira Classe</title> + + <para> + Nossa primeira classe de persistência é uma simples classe JavaBean com algumas propriedades: + </para> + + <programlisting><![CDATA[package events; + +import java.util.Date; + +public class Event { + private Long id; + + private String title; + private Date date; + + public Event() {} + + public Long getId() { + return id; + } + + private void setId(Long id) { + this.id = id; + } + + public Date getDate() { + return date; + } + + public void setDate(Date date) { + this.date = date; + } + + public String getTitle() { + return title; + } + + public void setTitle(String title) { + this.title = title; + } +}]]></programlisting> + + <para> + Você pode ver que esta classe usa o padrão JavaBean para o nomeamento convencional da propriedade getter e dos métodos setter, como também a visibilidade private dos campos. Este é um padrão de projeto recomendado, mas não requerido. O Hibernate pode também acessar campos diretamente, o benefício para os métodos de acesso é a robustez para o Refactoring. O construtor sem argumento é requerido para instanciar um objeto desta classe com a reflexão. + </para> + + <para> + A propriedade <literal>id</literal> mantém um único valor de identificação para um evento + particular. Todas as classes persistentes da entidade (bem como aquelas classes dependentes + de menos importância) precisam de uma propriedade de identificação, caso nós queiramos usar o + conjunto completo de características do Hibernate. De fato, a maioria das aplicações + (esp. aplicações web) precisam destinguir os objetos pelo identificador, então você deverá + considerar esta, uma característica em lugar de uma limitação. Porém, nós normalmente não + manipulamos a identidade de um objeto, consequentemente o método setter deverá ser privado. + O Hibernate somente nomeará os identificadores quando um objeto for salvo. Você pode ver como + o Hibernate pode acessar métodos públicos, privados, e protegidos, como também campos + (públicos, privados, protegidos) diretamente. A escolha está até você, e você pode combinar + isso para adaptar seu projeto de aplicação + </para> + + <para> + O construtor sem argumentos é um requerimento para todas as classes persistentes; + O Hibernate tem que criar para você os objetos usando Java Reflection. O construtor + pode ser privado, porém, a visibilidade do pacote é requerida para a procuração da + geração em tempo de execução e recuperação eficiente dos dados sem a instrumentação + de bytecode + </para> + + <para> + Coloque este fonte Java no diretório chamado <literal>src</literal> na pasta de desenvolvimento, + e em seu pacote correto. O diretório deverá ser parecido como este: + </para> + + <programlisting><![CDATA[. ++lib + <Hibernate and third-party libraries> ++src + +events + Event.java]]></programlisting> + + <para> + No próximo passo, iremos falar sobre as classes de persistência do Hibernate.. + </para> + + </sect2> + + <sect2 id="tutorial-firstapp-mapping" revision="1"> + <title>O mapeamento do arquivo</title> + + <para> + O Hibernate precisa saber como carregar e armazenar objetos da classe de + persistência. Isto será onde o mapeamento do arquivo do Hibernate entrará em + jogo. O arquivo mapeado informa ao Hibernate, qual tabela no banco de dados + ele deverá acessar, e quais as colunas na tabela ele deverá usar. + </para> + + <para> + A estrutura básica de um arquivo de mapeamento é parecida com: + </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"> + +<hibernate-mapping> +[...] +</hibernate-mapping>]]></programlisting> + + <para> + Note que o Hibernate DTD é muito sofisticado. Você pode usar isso para auto-conclusão + no mapeamento XML dos elementos e atributos no seu editor ou IDE. Você também pode + abrir o arquivo DTD no seu editor – é a maneira mais fácil de ter uma visão geral + de todos os elementos e atributos e dos padrões, como também alguns comentários. + Note que o Hibernate não irá carregar o arquivo DTD da web, e sim do diretório + da aplicação (classpath). O arquivo DTD está incluído no <literal>hibernate3.jar</literal> como + também no diretório <literal>src/</literal> da distribuição do Hibernate. + </para> + + <para> + Nós omitiremos a declaração do DTD nos exemplos futuros para encurtar o código. Isto, é claro, não é opcional. + </para> + + <para> + Entre os dois tags <literal>hibernate-mapping</literal>, inclua um elemento <literal>class</literal>. + Todas as classes persistentes da entidade (novamente, poderá haver + mais tarde, dependências sobre as classes que não são classes-primárias + de entidades) necessitam do tal mapeamento, para uma tabela na base + de dados SQL + </para> + + <programlisting><![CDATA[<hibernate-mapping> + + <class name="events.Event" table="EVENTS"> + + </class> + +</hibernate-mapping>]]></programlisting> + + <para> + Mais adiante iremos dizer ao Hibernate como fazer para persistir e carregar objetos da classe + <literal>Event</literal> da tabela <literal>EVENTS</literal>, cada instancia representada por + uma coluna na tabela. Agora, continuaremos com o mapeamento de uma única propriedade identificadora + para as chaves primárias da tabela. Além disso, nós não iremos se importar com esta propriedade + identificadora, nós iremos configurar uma estratégia de geração de id’s para uma chave primária + de uma surrogate key: + </para> + + <programlisting><![CDATA[<hibernate-mapping> + + <class name="events.Event" table="EVENTS"> + <id name="id" column="EVENT_ID"> + <generator class="native"/> + </id> + </class> + +</hibernate-mapping>]]></programlisting> + + <para> + O elemento <literal>id</literal> é a declaração da propriedade identificadora, + o <literal>name="id"</literal> declara o nome da propriedade Java – + o Hibernate irá usar os métodos getter e setter para acessar a propriedade. + O atributo da coluna informa ao Hibernate qual coluna da tabela <literal>EVENTS</literal> nós + iremos usar como chave primária. O elemento <literal>generator</literal> especifica + a estratégia de geração do identificador, neste caso usaremos <literal>native</literal>, que + escolhe a melhor estratégia dependendo da base de dados (dialeto) configurada. + O Hibernate suporta a base de dados gerada, globalmente única, bem como a atribuição + aos identificadores da aplicação (ou toda estratégia escrita para uma extensão). + </para> + + <para> + Finalmente incluiremos as declarações para as propriedades persistentes da classe + no arquivo mapeado. Por default, nenhuma das propriedades da classe é considerada persistente: + </para> + + <programlisting><![CDATA[ +<hibernate-mapping> + + <class name="events.Event" table="EVENTS"> + <id name="id" column="EVENT_ID"> + <generator class="native"/> + </id> + <property name="date" type="timestamp" column="EVENT_DATE"/> + <property name="title"/> + </class> + +</hibernate-mapping>]]></programlisting> + + <para> + Da mesma maneira que com o elemento <literal>id</literal>, o atributo <literal>name</literal> do elemento + <literal>property</literal> informa ao Hibernate qual método getter e setter deverá usar. + Assim, neste caso, o Hibernate irá procurar pelo <literal>getDate()/setDate()</literal>, + como também pelo <literal>getTitle()/setTitle()</literal>. + </para> + + <para> + Porque fazer o mapeamento da propriedade <literal>date</literal> incluído no + atributo <literal>column</literal>, e no title não fazer? + Sem o atributo <literal>column</literal> o Hibernate por padrão usa o nome + da propriedade como o nome da coluna. Isto trabalha muito + bem para o <literal>title</literal>. Entretanto o <literal>date</literal> é uma palavra-chave reservada + na maioria dos bancos de dados, assim nós melhoramos o mapeamentos + disto com um nome diferente. + </para> + + <para> + A próxima coisa interessante é que mapemanto do <literal>title</literal> + também falta o atributo <literal>type</literal>. O tipo que declaramos e o uso nos + arquivos mapeados, não são como você pôde esperar, atributos de dados Java. + Eles não são como os tipos de base de dados SQL. + Esses tipos podem ser chamados de <emphasis>Tipos de mapeamento Hibernate</emphasis>, que são conversores + que podem traduzir tipos de dados do Java para os tipos de dados SQL e vice-versa. + Novamente, o Hibernate irá tentar determinar a conversão correta e mapeará o <literal>type</literal> + próprio, caso o tipo do atributo não estiver presente no mapeamento. + Em alguns casos, esta detecção automática (que usa Reflection sobre as classes Java) + poderá não ter padrão que você espera ou necessita. + Este é o caso com a propriedade <literal>date</literal>. O Hibernate não pode saber se a propriedade + (que é do <literal>java.util.Date</literal>) pode mapear para uma coluna do tipo <literal>date</literal> + do SQL, <literal>timestamp</literal>, ou <literal>time</literal> . + Nós preservamos a informação cheia de datas e horas pelo mapeamento da propriedade com um conversor + <literal>timestamp</literal>. + </para> + + <para> + Este arquivo de mapeamento deve ser salvo como <literal>Event.hbm.xml</literal>, + corretamente no diretório próximo ao arquivo fonte da Classe Java <literal>Event</literal>. + O nomeamento dos arquivos de mapeamento podem ser arbitrários, porém o sufixo + <literal>hbm.xml</literal> é uma convenção da comunidade dos desenvolvedores do Hibernate. + Esta estrutura do diretório deve agora se parecer com isso: + </para> + + <programlisting><![CDATA[. ++lib + <Hibernate and third-party libraries> ++src + +events + Event.java + Event.hbm.xml]]></programlisting> + + <para> + Nós iremos continuar com a configuração principal do Hibernate. + </para> + + </sect2> + + <sect2 id="tutorial-firstapp-configuration" revision="2"> + <title>Configuração do Hibernate</title> + + <para> + Agora nós temos uma classe persistente e este arquivo de mapeamento no lugar. + Está na hora de configurar o Hibernate. Antes de fazermos isso, iremos precisar de uma base de dados. + O HSQL DB, um SQL DBMS feito em java, pode ser baixado através do site do HSQL DB(http://hsqldb.org/). + Atualmente, você só precisa baixar o <literal>hsqldb.jar</literal>. + Coloque este arquivo no diretório da pasta de desenvolvimento <literal>lib/</literal>. + </para> + + <para> + Crie um diretório chamado <literal>data</literal> no diretório root de desenvolvimento – + Isto será onde o HSQL DB irá armazenar arquivos de dados. Agora iremos iniciar o banco de dados + executando <literal>java -classpath ../lib/hsqldb.jar org.hsqldb.Server</literal> neste diretório de dados. + Você pode ver ele iniciando e conectando ao socket TCP/IP, isto será onde nossa aplicação irá se + conectar depois. Se você deseja iniciar uma nova base de dados durante este tutorial, + finalize o HSQL DB(pressionando o <literal>CTRL + C</literal> na janela), delete todos os + arquivos no diretório <literal>data/</literal>, e inicie o HSQL BD novamente. + </para> + + <para> + O Hibernate é uma camada na sua aplicação na qual se conecta com a base de dados, para isso + necessita de informação da conexão. As conexões são feitas através de um pool de conexão JDBC, + na qual teremos que configurar. A distribuição do Hibernate contém diversas ferramentas de pooling + da conexão JDBC de fonte aberta, mas iremos usar o pool de conexão interna para este tutorial. + Note que você tem que copiar a biblioteca necessária em seu classpath e use configurações + diferentes para pooling de conexão caso você deseje utilizar um software de pooling JDBC terceirizado + para qualidade de produção. + </para> + + <para> + Para as configurações do Hibernate, nós podemos usar um arquivo simples <literal>hibernate.properties</literal>, + um arquivo mais ligeiramente sofisticado <literal>hibernate.cfg.xml</literal> ou até mesmo uma + instalação programática completa. A maioria dos usuários preferem utilizar o arquivo de configuração XML + </para> + + <programlisting><![CDATA[<?xml version='1.0' encoding='utf-8'?> +<!DOCTYPE hibernate-configuration PUBLIC + "-//Hibernate/Hibernate Configuration DTD 3.0//EN" + "http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd"> + +<hibernate-configuration> + + <session-factory> + +  + <property name="connection.driver_class">org.hsqldb.jdbcDriver</property> + <property name="connection.url">jdbc:hsqldb:hsql://localhost</property> + <property name="connection.username">sa</property> + <property name="connection.password"></property> + +  + <property name="connection.pool_size">1</property> + +  + <property name="dialect">org.hibernate.dialect.HSQLDialect</property> + +  + <property name="current_session_context_class">thread</property> + +  + <property name="cache.provider_class">org.hibernate.cache.NoCacheProvider</property> + +  + <property name="show_sql">true</property> + +  + <property name="hbm2ddl.auto">create</property> + + <mapping resource="events/Event.hbm.xml"/> + + </session-factory> + +</hibernate-configuration>]]></programlisting> + + <para> + Note que esta configuração XML usa um diferente DTD. Nós configuraremos + as <literal>SessionFactory</literal> do Hibernate – uma factory global responsável + por uma base de dedados particular. Se você tiver diversas bases de dados, + use diversas configurações <literal><session-factory></literal>, geralmente + em diversos arquivos de configuração (para uma partida mais fácil). + </para> + + <para> + As primeiras quatro <literal>propriedades</literal> do elemento contém a configuração + necessária para a conexão ao JDBC. A propriedade <literal>propriedade</literal> dialect + do elemento especifica a variante particular do SQL que o Hibernate gera. + O gerenciamento automático de sessão do Hibernate para contextos de persistência + estará disponível em breve. A opção <literal>hbm2ddl.auto</literal> habilita a geração + automática de schemas da base de dados – diretamente na base de dados. + Isto também pode ser naturalmente desligado (removendo a opção de configuração) ou redirecionando + para um arquivo com ajuda do <literal>SchemaExport</literal> nas tarefas do Ant. + Finalmente, iremos adicionar os arquivos das classes de persistência mapeadas na configuração. + </para> + + <para> + Copie este arquivo no diretório fonte, assim isto irá terminar na raiz (root) do + classpath. O Hibernate automaticamente procura por um arquivo chamado + <literal>hibernate.cfg.xml</literal> na raiz do classpath, no startup. + </para> + + </sect2> + + <sect2 id="tutorial-firstapp-ant" revision="1"> + <title>Construindo com o Ant</title> + + <para> + Nos iremos, agora, construir o tutorial com Ant. Você ira precisar o Ant instalado – + se encontra disponível <ulink url="http://ant.apache.org/bindownload.cgi">na página de download do Ant</ulink>. + Como instalar o Ant, não será abordado aqui. Caso tenha alguma dúvida, por favor, + vá ao <ulink url="http://ant.apache.org/manual/index.html">Ant manual</ulink>. + Depois que tiver instalado o Ant, podemos começar a criar o arquivo de construção <literal>build.xml</literal>. + Este arquivo será chamado de <literal>build.xml</literal> e posto diretamente no diretório de desenvolvimento. + </para> + + <para> + Um arquivo básico de build, se parece com isto: + </para> + + <programlisting><![CDATA[<project name="hibernate-tutorial" default="compile"> + + <property name="sourcedir" value="${basedir}/src"/> + <property name="targetdir" value="${basedir}/bin"/> + <property name="librarydir" value="${basedir}/lib"/> + + <path id="libraries"> + <fileset dir="${librarydir}"> + <include name="*.jar"/> + </fileset> + </path> + + <target name="clean"> + <delete dir="${targetdir}"/> + <mkdir dir="${targetdir}"/> + </target> + + <target name="compile" depends="clean, copy-resources"> + <javac srcdir="${sourcedir}" + destdir="${targetdir}" + classpathref="libraries"/> + </target> + + <target name="copy-resources"> + <copy todir="${targetdir}"> + <fileset dir="${sourcedir}"> + <exclude name="**/*.java"/> + </fileset> + </copy> + </target> + +</project>]]></programlisting> + + <para> + Isto irá avisar ao Ant para adicionar todos os arquivos no diretório lib terminando com + <literal>.jar</literal>, para o classpath usado para compilação. Irá também copiar todos os + arquivos não-java para o diretório alvo (arquivos de configuração, mapeamento). Se você rodar + o ant agora, deverá ter esta saída. + </para> + + <programlisting><![CDATA[C:\hibernateTutorial\>ant +Buildfile: build.xml + +copy-resources: + [copy] Copying 2 files to C:\hibernateTutorial\bin + +compile: + [javac] Compiling 1 source file to C:\hibernateTutorial\bin + +BUILD SUCCESSFUL +Total time: 1 second ]]></programlisting> + + </sect2> + + <sect2 id="tutorial-firstapp-helpers" revision="3"> + <title>Startup and helpers</title> + + <para> + É hora de carregar e arquivar alguns objetos <literal>Event</literal>, mas primeiro + nós temos de completar o setup com algum código de infraestrutura. Este startup + inclui a construção de um objeto <literal>SessionFactory</literal> global e armazenar + isto em algum lugar de fácil acesso para o código da aplicação. + Uma <literal>SessionFactory</literal> pode abrir novas <literal>Session</literal>'s. + Uma <literal>Session</literal> representa uma unidade single-theaded do trabalho, a + <literal>SessionFactory</literal> é um objeto global thread-safe, instanciado uma vez. + </para> + + <para> + Nos iremos criar uma classe de ajuda <literal>HibernateUtil</literal>, que toma + conta do startup e faz acesso a uma <literal>SessionFactory</literal> conveniente. + Vamos dar uma olhada na implementação: + </para> + + <programlisting><![CDATA[package util; + +import org.hibernate.*; +import org.hibernate.cfg.*; + +public class HibernateUtil { + + private static final SessionFactory sessionFactory; + + static { + try { + // Create the SessionFactory from hibernate.cfg.xml + sessionFactory = new Configuration().configure().buildSessionFactory(); + } catch (Throwable ex) { + // Make sure you log the exception, as it might be swallowed + System.err.println("Initial SessionFactory creation failed." + ex); + throw new ExceptionInInitializerError(ex); + } + } + + public static SessionFactory getSessionFactory() { + return sessionFactory; + } + +}]]></programlisting> + + <para> + Esta classe não só produz a global <literal>SessionFactory</literal> no seu static initializer + (chamado uma vez pela JVM quando a classe é carregada), mas também esconde o fato + de que isto usa um static singleton. Ela pode muito bem, enxergar a + <literal>SessionFactory</literal> do JNDI em um application server. + </para> + + <para> + Se você der à <literal>SessionFactory</literal> um nome, no seu arquivo de configuração. + O Hibernate irá, de fato, tentar uni-lo ao JNDI depois que estiver construído. + Para evitar este completamente este código, você também poderia usar JMX deployment + e deixar o contêiner JMX capaz, instanciar e unir um <literal>HibernateService</literal> + no JNDI. Essas opções avançadas são discutidas no documento de referência do Hibernate. + </para> + + <para> + Coloque o <literal>HibernateUtil.java</literal> no diretório de arquivos + de desenvolvimento(source), em um pacote após o <literal>events</literal>: + </para> + + <programlisting><![CDATA[. ++lib + <Hibernate and third-party libraries> ++src + +events + Event.java + Event.hbm.xml + +util + HibernateUtil.java + hibernate.cfg.xml ++data +build.xml]]></programlisting> + + <para> + Novamente, isto deve compilar sem problemas. Finalmente, nós precisamos configurar + um sistema de logging – o Hibernate usa commons logging e deixa você escolher entre o + Log4j e o logging do JDK 1.4 . A maioria dos desenvolvedores preferem o Log4j: copie + <literal>log4j.properties</literal> da distribuição do Hibernate (está no diretório + <literal>etc/</literal>), para seu diretório <literal>src</literal>, + depois vá em hibernate.cfg.xml. Dê uma olhada no exemplo de configuração e mude as + configurações se você quizer ter uma saída mais detalhada. Por default, apenas as + mensagems de startup e shwwn do Hibernate é mostrada no stdout. + </para> + + <para> + O tutorial de infra-estrutura está completo - e nós já estamos preparados para algum + trabalho de verdade com o Hibernate. + </para> + + </sect2> + + <sect2 id="tutorial-firstapp-workingpersistence" revision="4"> + <title>Carregando e salvando objetos</title> + + <para> + Finalmente, nós podemos usar o Hibernate para carregar e armazenar objetos. + Nós escrevemos uma classe <literal>EventManager</literal> com um método main(): + </para> + + <programlisting><![CDATA[package events; +import org.hibernate.Session; + +import java.util.Date; + +import util.HibernateUtil; + +public class EventManager { + + public static void main(String[] args) { + EventManager mgr = new EventManager(); + + if (args[0].equals("store")) { + mgr.createAndStoreEvent("My Event", new Date()); + } + + HibernateUtil.getSessionFactory().close(); + } + + private void createAndStoreEvent(String title, Date theDate) { + + Session session = HibernateUtil.getSessionFactory().getCurrentSession(); + + session.beginTransaction(); + + Event theEvent = new Event(); + theEvent.setTitle(title); + theEvent.setDate(theDate); + + session.save(theEvent); + + session.getTransaction().commit(); + } + +}]]></programlisting> + + <para> + Nós criamos um novo objeto <literal>Event</literal>, e passamos para o Hibernate. + O Hibernate sabe como tomar conta do SQL e executa <literal>INSERT</literal>s + no banco de dados. Vamos dar uma olhada na <literal>Session</literal> e no + código <literal>Transaction</literal>-handling antes de executarmos. + </para> + + <para> + Um <literal>Session</literal> é uma unidade simples de trabalho. Por agora nós + iremos pegar coisas simples e assumir uma granularidade de um-pra-um entre uma + <literal>Session</literal> do Hibernate e uma transação de banco de dados. + Para proteger nosso código de um atual sistema subjacente de transação (nesse + caso puro JDBC, mas também poderia rodar com JTA), nos usamos a API + <literal>Transaction</literal>, que está disponível na <literal>Session</literal> do Hibernate. + </para> + + <para> + O que a <literal>sessionFactory.getCurrentSession()</literal> faz? Primeiro, você pode + chamar quantas vezes e de onde quiser, uma vez você recebe sua <literal>SessionFactory</literal> + (fácil graças ao <literal>HibernateUtil</literal>). O método <literal>getCurrentSession()</literal> + sempre retorna a unidade de trabalho "corrente". Lembra de que nós mudamos a opção + de configuração desse mecanismo para thread no <literal>hibernate.cfg.xml</literal>? Daqui em + diante, o escopo da unidade de trabalho corrente é a thread Java + corrente que executa nossa aplicação. Entretanto, esta não é toda a verdade. Uma + </para> + + <para> + <literal>Session</literal> começa quando é primeiramente necessária, quando é feita a + primeira chamada à <literal>getCurrentSession()</literal>. É então limitado pelo Hibernate + para thread corrente. Quando a transação termina, tanto com commit quanto rollback, + o Hibernate também desune a <literal>Session</literal> da thread e fecha isso pra você. + Se você chamar <literal>getCurrentSession()</literal> novamente, você receberá uma nova + <literal>Session</literal> e pode começar uma nova unidade de trabalho. Esse modelo de + programação de limite de thread <emphasis>thread-bound</emphasis>, é o modo mais popular + de se usar o Hibernate. + </para> + <para> + Related to the unit of work scope, should the Hibernate <literal>Session</literal> be used to + execute one or several database operations? The above example uses one <literal>Session</literal> + for one operation. This is pure coincidence, the example is just not complex enough to show any + other approach. The scope of a Hibernate <literal>Session</literal> is flexible but you should + never design your application to use a new Hibernate <literal>Session</literal> for + <emphasis>every</emphasis> database operation. So even if you see it a few more times in + the following (very trivial) examples, consider <emphasis>session-per-operation</emphasis> + an anti-pattern. A real (web) application is shown later in this tutorial. + </para> + <para> + Dê uma olhada no <xref linkend="transactions"/> para mais informações a + respeito de manipulação de transação e demarcação. Nós também pulamos qualquer + manipulação de erro e rollback no exemplo anterior. + </para> + + <para> + Para executar esta primeira rotina, nos teremos que adicionar um ponto de chamada + para o arquivo de build do Ant: + </para> + + <programlisting><![CDATA[<target name="run" depends="compile"> + <java fork="true" classname="events.EventManager" classpathref="libraries"> + <classpath path="${targetdir}"/> + <arg value="${action}"/> + </java> +</target>]]></programlisting> + + <para> + O valor do argumento <literal>action</literal>, é setado na linha de comando quando chamando esse ponto: + </para> + + <programlisting><![CDATA[C:\hibernateTutorial\>ant run -Daction=store]]></programlisting> + + <para> + Você deverá ver, após a compilação, o startup do Hibernate e, dependendo da sua + configuração, muito log de saída. No final você verá a seguinte linha: + </para> + + <programlisting><![CDATA[[java] Hibernate: insert into EVENTS (EVENT_DATE, title, EVENT_ID) values (?, ?, ?)]]></programlisting> + + <para> + Este é o <literal>INSERT</literal> executado pelo Hibernate, os pontos de interrogação + representam parêmetros de união do JDBC. Para ver os valores substituídos, ou para diminuir a + verbalidade do log, check seu l<literal>log4j.properties</literal>. + </para> + + <para> + Agora nós gostaríamos de listar os eventos arquivados, então nós adicionamos uma + opção para o método main: + </para> + + <programlisting><![CDATA[if (args[0].equals("store")) { + mgr.createAndStoreEvent("My Event", new Date()); +} +else if (args[0].equals("list")) { + List events = mgr.listEvents(); + for (int i = 0; i < events.size(); i++) { + Event theEvent = (Event) events.get(i); + System.out.println("Event: " + theEvent.getTitle() + + " Time: " + theEvent.getDate()); + } +}]]></programlisting> + + <para> + Nos também adicionamos um novo <literal>método listEvents()</literal>: + </para> + + <programlisting><![CDATA[private List listEvents() { + + Session session = HibernateUtil.getSessionFactory().getCurrentSession(); + + session.beginTransaction(); + + List result = session.createQuery("from Event").list(); + + session.getTransaction().commit(); + + return result; +}]]></programlisting> + + <para> + O que nós fazemos aqui, é usar uma query HQL (Hibernate Query Language), + para carregar todos os objetos <literal>Event</literal> exitentes no banco de dados. + O Hibernate irá gerar o SQL apropriado, enviar para o banco de dados e popular objetos + <literal>Event</literal> com os dados. Você pode criar queries mais complexas com + HQL, claro. + </para> + + <para> + Agora, para executar e testar tudo isso, siga os passos a seguir: + </para> + + <itemizedlist> + <listitem> + <para> + Execute <literal>ant run -Daction=store</literal> para armazenar algo no banco de dados + e, claro, gerar o esquema do banco de dados antes pelo hbm2ddl. + </para> + </listitem> + <listitem> + <para> + Agora desabilite hbm2ddl comentando a propriedade no seu arquivo <literal>hibernate.cfg.xml</literal>. + Normalmente só se deixa habilitado em teste unitários contínuos, mas outra carga de hbm2ddl + pode <emphasis>remover</emphasis> tudo que você já tenha arquivado. Sa configuração + <literal>create</literal>, atualmente são traduzidas para "apague todas as tabelas do esquema, + então recrie todas quando a SessionFactory estiver pronta". + </para> + </listitem> + </itemizedlist> + + <para> + Se você agora chamar o Ant com <literal>-Daction=list</literal>, você deverá ver os + eventos que você acabou de criar. Você pode também chamar a ação <literal>store</literal> + mais algumas vezes. + </para> + + <para> + Nota: A maioria dos novos usuários do Hibernate falha nesse ponto e nós regularmente, vemos + questões sobre mensagens de erro de <emphasis>tabela não encontrada </emphasis> . + Entretanto, se você seguir os passos marcados acima, você não terá esse problema, + com o hbm2ddl criando o esquema do banco de dados na primeira execução, e restarts + subsequentes da aplicação irão usar este esquema. Se você mudar o mapeamento e/ou + o esquema do banco de dados, terá de re-habilitar o hbm2ddl mais uma vez. + </para> + + </sect2> + + </sect1> + + <sect1 id="tutorial-associations"> + <title>Part 2 - Mapeando associações</title> + + <para> + Nós mapeamos uma classe de entidade de persistência para uma tabela. Agora vamos continuar + e adicionar algumas associações de classe. Primeiro nos iremos adicionar pessoas a nossa aplicação, + e armazenar os eventos de que elas participam. + </para> + + <sect2 id="tutorial-associations-mappinguser" revision="1"> + <title>Mapeando a classe Person</title> + + <para> + O primeiro código da classe <literal>Person</literal> é simples: + </para> + + <programlisting><![CDATA[package events; + +public class Person { + + private Long id; + private int age; + private String firstname; + private String lastname; + + public Person() {} + + // Accessor methods for all properties, private setter for 'id' + +}]]></programlisting> + + <para> + Crie um novo arquivo de mapeamento, chamado <literal>Person.hbm.xml</literal> (não + esqueça a referencia ao DTD no topo) + </para> + + <programlisting><![CDATA[<hibernate-mapping> + + <class name="events.Person" table="PERSON"> + <id name="id" column="PERSON_ID"> + <generator class="native"/> + </id> + <property name="age"/> + <property name="firstname"/> + <property name="lastname"/> + </class> + +</hibernate-mapping>]]></programlisting> + + <para> + Finalmente, adicione o novo mapeamento a configuração do Hibernate: + </para> + + <programlisting><![CDATA[<mapping resource="events/Event.hbm.xml"/> +<mapping resource="events/Person.hbm.xml"/>]]></programlisting> + + <para> + Nos iremos agora criar uma associação entre estas duas entidades. Obviamente, + pessoas (Person) podem participar de eventos, e eventos possuem participantes. + As questões de design com que teremos de lidar são: direcionalidade, multiplicidade e + comportamento de coleção. + </para> + + </sect2> + + <sect2 id="tutorial-associations-unidirset" revision="3"> + <title>Uma associação Set-based unidirectional</title> + + <para> + Nos iremos adicionar uma coleção de eventos na classe <literal>Person</literal>. Desse jeito + poderemos navegar pelos eventos de uma pessoa em particular, sem executar uma query explicitamente – + apenas chamando <literal>aPerson.getEvents()</literal>. Nos usaremos uma coleção Java, um + <literal>Set</literal>, porquê a coleção não conterá elementos duplicados e a ordem não é + relevante para nós. + </para> + + <para> + Vamos escrever o código para isto nas classes Java e então mapear: + </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> + Antes de mapearmos esta associação, pense no outro lado. Claramente, poderíamos apenas fazer isto de + forma unidirecional. Ou poderíamos criar outra coleção no <literal>Event</literal>, se quisermos + ser capaz de navegar bidirecionalmente, i.e. um - <literal>anEvent.getParticipants()</literal>. + Isto não é necessário, de perspectiva funcional. Você poderia sempre executar uma query explicita + que retornasse os participantes de um evento em particular. Esta é uma escolha de design que cabe + a você, mas o que é claro nessa discussão é a multiplicidade da associação: "muitos" valores em ambos + os lados, nós chamamos isto uma associação <emphasis>muitos-para-muitos</emphasis>. Daqui pra frente, + nos usaremos o mapeamento muitos-para-muitos do Hibernate: + </para> + + <programlisting><![CDATA[<class name="events.Person" table="PERSON"> + <id name="id" column="PERSON_ID"> + <generator class="native"/> + </id> + <property name="age"/> + <property name="firstname"/> + <property name="lastname"/> + + <set name="events" table="PERSON_EVENT"> + <key column="PERSON_ID"/> + <many-to-many column="EVENT_ID" class="events.Event"/> + </set> + +</class>]]></programlisting> + + <para> + O Hibernate suporta todo tipo de mapeamento de coleção , sendo um <literal><set></literal> mais comum. + Para uma associação muitos-para-muitos (ou relacionamento de entidade <emphasis>n:m</emphasis> ), + uma tabela de associação é necessária. Cada linha nessa tabela representa um link entre uma pessoa e um + evento. O nome da tabela é configurado com o atributo <literal>table</literal> do elemento + <literal>set</literal>. O nome da coluna identificadora na associção, peloo lado da pessoa, + é definido com o elemento <literal><key></literal> , o nome da coluna pelo lado dos eventos, + e definido com o atributo <literal>column</literal> do <literal><many-to-many></literal>. + Você também precisa dizer para o Hibernate a classe dos objetos na sua coleção (a classe do outro + lado das coleções de referência). + </para> + + <para> + O esquema de mapeamento para o banco de dados está a seguir: + </para> + + <programlisting><![CDATA[ + _____________ __________________ + | | | | _____________ + | EVENTS | | PERSON_EVENT | | | + |_____________| |__________________| | PERSON | + | | | | |_____________| + | *EVENT_ID | <--> | *EVENT_ID | | | + | EVENT_DATE | | *PERSON_ID | <--> | *PERSON_ID | + | TITLE | |__________________| | AGE | + |_____________| | FIRSTNAME | + | LASTNAME | + |_____________| + ]]></programlisting> + + </sect2> + + <sect2 id="tutorial-associations-working" revision="1"> + <title>Trabalhando a associação</title> + + <para> + Vamos trazer juntos algumas pessoas e eventos em um novo método na classe <literal>EventManager</literal>:: + </para> + + <programlisting><![CDATA[private void addPersonToEvent(Long personId, Long eventId) { + + 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); + + session.getTransaction().commit(); +}]]></programlisting> + + <para> + Após carregar um <literal>Person</literal> e um <literal>Event</literal>, simplesmente + modifique a coleção usando os métodos normais de uma coleção. Como você pode ver, não há chamada explícita + para <literal>update()</literal> ou <literal>save()</literal>, o Hibernate detecta automaticamente + que a coleção foi modificada e necessita ser atualizada. Isso é chamado de <emphasis>checagem + suja automática</emphasis>, e você também pode usá-la modificando o nome ou a data de qualquer um dos + seus objetos. Assim que eles estiverem no estado <emphasis>persistent</emphasis>, ou seja, + limitado por uma <literal>Session</literal> do Hibernate em particular (i.e. eles foram carregados ou + salvos dentro de uma unidade de trabalho), o Hibernate monitora qualquer alteração e executa o SQL + em modo de escrita em segundo plano. O processo de sincronização do estado da memória com o banco de + dados, geralmente apenas no final de uma unidade de trabalho, é chamado de <emphasis>flushing</emphasis>. + No nosso código, a unidade de trabalho termina com o commit da transação do banco de dados – + como definido pela opção de configuração da <literal>thread</literal> da classe <literal>CurrentSessionContext</literal>. + </para> + + <para> + Você pode também querer carregar pessoas e eventos em diferentes unidades de trabalho. + Ou você modifica um objeto fora de uma <literal>Session</literal>, quando não se encontra no + estado persistent (se já esteve neste estado anteriormente, chamamos esse estado de + <emphasis>detached</emphasis>). Você pode até mesmo modificar uma coleção quando esta + se encontrar no estado detached. + </para> + + <programlisting><![CDATA[private void addPersonToEvent(Long personId, Long eventId) { + + Session session = HibernateUtil.getSessionFactory().getCurrentSession(); + session.beginTransaction(); + + 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 + + Event anEvent = (Event) session.load(Event.class, eventId); + + session.getTransaction().commit(); + + // End of first unit of work + + aPerson.getEvents().add(anEvent); // aPerson (and its collection) is detached + + // Begin second unit of work + + Session session2 = HibernateUtil.getSessionFactory().getCurrentSession(); + session2.beginTransaction(); + + session2.update(aPerson); // Reattachment of aPerson + + session2.getTransaction().commit(); +}]]></programlisting> + + <para> + A chamada <literal>update</literal> cria um objeto persistent novamente, você poderia + dizer que ele liga o objeto a uma nova unidade de trabalho, assim qualquer modificação + que você faça neste objeto enquanto estiver no estado detached pode ser salvo no banco de dados. + Isso inclui qualquer modificação (adição/exclusão) que você faça em uma coleção da entidade deste objeto. + </para> + + <para> + Bom, isso não foi muito usado na nossa situação, porém, é um importante conceito que você + pode aplicar em seus aplicativos. Agora, complete este exercício adicionando uma nova ação + ao método main( ) da classe <literal>EventManager</literal> e chame-o pela linha de comando. + Se você precisar dos identificadores de uma pessoa ou evento – o método <literal>save()</literal> + retorna estes identificadores (você poderá modificar alguns dos métodos anteriores para retornar aquele + identificador): + </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> + Este foi um exemplo de uma associação entre duas classes igualmente importantes, duas entidades. + Como mencionado anteriormente, há outras classes e tipos dentro de um modelo típico, + geralmente "menos importante". Alguns você já viu, como um <literal>int</literal> ou uma <literal>String</literal>. + Nós chamamos essas classes de <emphasis>value types</emphasis>, e suas instâncias <emphasis>depend</emphasis> + de uma entidade particular. As instâncias desses tipos não possuem sua própria identidade, nem são + compartilhados entre entidades (duas pessoas não referenciam o mesmo objeto <literal>firstname</literal> + mesmo se elas tiverem o mesmo objeto firstname). Naturalmente, os value types não são apenas encontrados + dentro da JDK (de fato, em um aplicativo Hibernate todas as classes JDK são consideradas como value types), + mas você pode também criar suas classes como, por exemplo, <literal>Address</literal> ou <literal>MonetaryAmount</literal>. + + </para> + + <para> + Você também pode criar uma coleção de value types. Isso é conceitualmente muito diferente + de uma coleção de referências para outras entidades, mas em Java parece ser quase a mesma coisa. + </para> + + </sect2> + + <sect2 id="tutorial-associations-valuecollections"> + <title>Coleção de valores</title> + + <para> + Nós adicionamos uma coleção de objetos de tipo de valores à entidade <literal>Person</literal>. + Nós querermos armazenar endereços de e-mail, para isso utilizamos o tipo <literal>String</literal>, + e a coleção novamente será um <literal>Set</literal>: + </para> + <programlisting><![CDATA[private Set emailAddresses = new HashSet(); + +public Set getEmailAddresses() { + return emailAddresses; +} + +public void setEmailAddresses(Set emailAddresses) { + this.emailAddresses = emailAddresses; +}]]></programlisting> + + <para> + O mapeamento deste <literal>Set</literal>: + </para> + + <programlisting><![CDATA[<set name="emailAddresses" table="PERSON_EMAIL_ADDR"> + <key column="PERSON_ID"/> + <element type="string" column="EMAIL_ADDR"/> +</set>]]></programlisting> + + <para> + A diferença comparada com o mapeamento anterior se encontra na parte <literal>element</literal>, + que indica ao Hibernate que a coleção não contém referências à outra entidade, mas uma coleção de + elementos do tipo <literal>String</literal> (a tag name em miniscula indica que se trata de um + mapeamento do Hibernate para conversão de tipos). Mais uma vez, o atributo <literal>table</literal> + do elemento <literal>set</literal> determina o nome da tabela para a coleção. O elemento + <literal>key</literal> define o nome da coluna de chave estrangeira na tabela de coleção. + O atributo <literal>column</literal> dentro do elemento <literal>element</literal> define o + nome da coluna onde os valores da <literal>String</literal> serão armazenados. + </para> + + <para> + Dê uma olhada no esquema atualizado: + </para> + + <programlisting><![CDATA[ + _____________ __________________ + | | | | _____________ + | EVENTS | | PERSON_EVENT | | | ___________________ + |_____________| |__________________| | PERSON | | | + | | | | |_____________| | PERSON_EMAIL_ADDR | + | *EVENT_ID | <--> | *EVENT_ID | | | |___________________| + | EVENT_DATE | | *PERSON_ID | <--> | *PERSON_ID | <--> | *PERSON_ID | + | TITLE | |__________________| | AGE | | *EMAIL_ADDR | + |_____________| | FIRSTNAME | |___________________| + | LASTNAME | + |_____________| + ]]></programlisting> + + <para> + Você pode observar que a chave primária da tabela da coleção é de na verdade uma chave composta, + usando ambas colunas. Isso também implica que cada pessoa não pode ter endereços de e-mail + duplicados, o que é exatamente a semântica que precisamos para um set em Java. + </para> + + <para> + Você pode agora tentar adicionar elementos a essa coleção, do mesmo modo que fizemos + anteriormente ligando pessoas e eventos. È o mesmo código em 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> + This time we didnt' use a <emphasis>fetch</emphasis> query to initialize the collection. + Hence, the call to its getter method will trigger an additional select to initialize + it, so we can add an element to it. Monitor the SQL log and try to optimize this with + an eager fetch. + </para> + + </sect2> + + <sect2 id="tutorial-associations-bidirectional" revision="1"> + <title>Associações bidirecionais</title> + + <para> + Agora iremos mapear uma associação bidirecional – fazendo a associação entre pessoas e + eventos, de ambos os lados, em Java. Logicamente, o esquema do banco de dados não muda, + nós continuamos tendo multiplicidades muitos-para-muitos. Um banco de dados é mais flexível do que + uma linguagem de programação para redes, ele não precisa de nenhuma direção de navegação – os + dados podem ser acessados em qualquer caminho possível. + </para> + + <para> + Primeiramente, adicione uma coleção de participantes à classe <literal>Event</literal>: + </para> + + <programlisting><![CDATA[private Set participants = new HashSet(); + +public Set getParticipants() { + return participants; +} + +public void setParticipants(Set participants) { + this.participants = participants; +}]]></programlisting> + + <para> + Agora mapeie este lado da associação em <literal>Event.hbm.xml</literal>. + </para> + + <programlisting><![CDATA[<set name="participants" table="PERSON_EVENT" inverse="true"> + <key column="EVENT_ID"/> + <many-to-many column="PERSON_ID" class="events.Person"/> +</set>]]></programlisting> + + <para> + Como você pode ver, esses é uma mapeamento normal usando <literal>set</literal> em ambos documenentos + de mapeamento. Observe que o nome das colunas em <literal>key</literal> e <literal>many-to-many</literal> + estão trocados em ambos os documentos de mapeamento. A adição mais importante feita está no atributo + <literal>inverse="true"</literal> no elemento set do mapeamento da coleção da classe <literal>Event</literal>. + </para> + + <para> + Isso significa que o Hibernate deve pegar o outro lado – a classe <literal>Person</literal> – + quando necessitar encontrar informação sobre a relação entre as duas entidades. Isso será muito + mais facilmente compreendido quando você analisar como a relação bidirecional entre as entidades é criada. + </para> + + </sect2> + + <sect2 id="tutorial-associations-usingbidir"> + <title>Trabalhando com links bidirecionais</title> + + <para> + Primeiro tenha em mente que o Hibernate não afeta a semântica normal do Java. Como nós criamos + um link entre uma <literal>Person</literal> e um <literal>Event</literal> no exemplo unidirecional? + Nós adicionamos uma instância de <literal>Event</literal>, da coleção de referências de eventos, + a uma instância de <literal>Person</literal>. Então, obviamente, se nós queremos que este link funcione + bidirecionalmente, nós devemos fazer a mesma coisa para o outro lado – adicionando uma referência de + <literal>Person</literal> na coleção de um <literal>Event</literal>. Esse acerto de link de ambos + os lados é absolutamente necessário e você nunca deve esquecer de faze-lo. + </para> + + <para> + Muitos desenvolvedores programam de maneira defensiva e criam métodos + gerenciador de associações que ajusta corretamente ambos os lados: + </para> + + <programlisting><![CDATA[protected Set getEvents() { + return events; +} + +protected void setEvents(Set events) { + this.events = events; +} + +public void addToEvent(Event event) { + this.getEvents().add(event); + event.getParticipants().add(this); +} + +public void removeFromEvent(Event event) { + this.getEvents().remove(event); + event.getParticipants().remove(this); +}]]></programlisting> + + <para> + Observe que os métodos set e get da a coleção estão protegidos – isso permite que classes e + subclasses do mesmo pacote continuem acessando os métodos, mas previne que qualquer outra classe, + que não esteja no mesmo pacote, acesse a coleção diretamente. Você provavelmente deve fazer a mesma + coisa para a coleção do outro lado. + </para> + + <para> + E sobre o mapeamento do atributo <literal>inverse</literal>? Pra você, e para o Java, um link bidirecional + é simplesmente o fato de ajustar corretamente as referências de ambos os lados. O Hibernate, entretanto + não possui informação necessária para corretamente adaptar os estados <literal>INSERT</literal> e + <literal>UPDATE</literal> do SQL, e precisa de ajuda para manipular as propriedades das associações + bidirecionais. Fazer um lado da associação com o atributo <literal>inverse</literal> instrui o Hibernate + para basicamente ignora-lo, considerando-o uma <emphasis>cópia</emphasis> do outro lado. Isso é todo o + necessário para o Hibernate trabalhar com todas as possibilidades quando transformando um modelo de + navegação bidirecional em esquema de banco de dados do SQL. As regras que você possui para lembrar são + diretas: Todas associações bidirecionais necessitam que um lado possua o atributo inverse. Em uma + associação de um-para-muitos, o lado de "muitos" deve conter o atributo <literal>inverse</literal>, + já em uma associação de muitos-para-muitos você pode pegar qualquer lado, não há diferença. + </para> + + </sect2> + + <para> + Agora, vamos portar este exemplo para um pequeno aplicativo para internet. + + </para> + + </sect1> + + <sect1 id="tutorial-webapp"> + <title>EventManager um aplicativo para internet</title> + + <para> + Um aplicativo para internet do Hibernate usa uma <literal>Session</literal> e uma <literal>Transaction</literal> + quase do mesmo modo que um aplicativo standalone. Entretanto, alguns patterns comuns são úteis. + Nós agora criaremos um <literal>EventManagerServlet</literal>. Esse servlet lista todos os eventos + salvos no banco de dados, e cria um formulário HTML para entrada de novos eventos. + </para> + + <sect2 id="tutorial-webapp-servlet" revision="1"> + <title>Criando um servlet básico</title> + + <para> + Crie uma nova classe no seu diretório fonte, no pacote <literal>events</literal>: + </para> + + <programlisting><![CDATA[package events; + +// Imports + +public class EventManagerServlet extends HttpServlet { + + // Servlet code +}]]></programlisting> + + <para> + O servlet manuseia somente requisições <literal>GET</literal> do HTTP, + portanto o método que iremos implementar é <literal>doGet()</literal>: + </para> + + <programlisting><![CDATA[protected void doGet(HttpServletRequest request, + HttpServletResponse response) + throws ServletException, IOException { + + SimpleDateFormat dateFormatter = new SimpleDateFormat("dd.MM.yyyy"); + + try { + // Begin unit of work + HibernateUtil.getSessionFactory() + .getCurrentSession().beginTransaction(); + + // Process request and render page... + + // End unit of work + HibernateUtil.getSessionFactory() + .getCurrentSession().getTransaction().commit(); + + } catch (Exception ex) { + HibernateUtil.getSessionFactory() + .getCurrentSession().getTransaction().rollback(); + throw new ServletException(ex); + } + +}]]></programlisting> + + <para> + O pattern que estamos aplicando neste código é chamado <emphasis>session-per-request</emphasis>. + Quando uma requisição chega ao servlet, uma nova <literal>Session</literal> do Hibernate é + aberta através da primeira chamada para <literal>getCurrentSession()</literal> em + <literal>SessionFactory</literal>. Então uma transação do banco de dados é inicializada - + todo acesso a dados deve ocorrer dentro de uma transação, não importando se o dado é de leitura ou escrita. + (nós não devemos usar o modo auto-commit em aplicações). + + </para> + <para> + Do <emphasis>not</emphasis> use a new Hibernate <literal>Session</literal> for + every database operation. Use one Hibernate <literal>Session</literal> that is + scoped to the whole request. Use <literal>getCurrentSession()</literal>, so that + it is automatically bound to the current Java thread. + </para> + <para> + Agora, as possibilidades de ações de uma requisição serão processadas e uma resposta HTML será renderizada. + Nós já iremos chegar nesta parte. + </para> + + <para> + Finalmente, a unidade de trabalho termina quando o processamento e a restituição são completados. + Se ocorrer algum erro durante o processamento ou a restituição, uma exceção será lançada e a + transação do banco de dados encerrada. Isso completa o pattern <literal>session-per-request</literal>. + Em vez de usar código de demarcação de transação em todo servlet você pode também criar um filtro servlet. + Dê uma olhada no site do Hibernate e do Wiki para maiores informações sobre esse pattern, + chamado <emphasis>Open Session in View</emphasis>. + </para> + + </sect2> + + <sect2 id="tutorial-webapp-processing" revision="1"> + <title>Processando e renderizando</title> + + <para> + Vamos implementar o processamento da requisição e a restituição da página HTML. + </para> + +<programlisting><![CDATA[// Write HTML header +PrintWriter out = response.getWriter(); +out.println("<html><head><title>Event Manager</title></head><body>"); + +// Handle actions +if ( "store".equals(request.getParameter("action")) ) { + + String eventTitle = request.getParameter("eventTitle"); + String eventDate = request.getParameter("eventDate"); + + if ( "".equals(eventTitle) || "".equals(eventDate) ) { + out.println("<b><i>Please enter event title and date.</i></b>"); + } else { + createAndStoreEvent(eventTitle, dateFormatter.parse(eventDate)); + out.println("<b><i>Added event.</i></b>"); + } +} + +// Print page +printEventForm(out); +listEvents(out, dateFormatter); + +// Write HTML footer +out.println("</body></html>"); +out.flush(); +out.close();]]></programlisting> + + <para> + O estilo de código acima, misturando linguagem HTML e Java não será funcional em um aplicativo + mais complexo—tenha em mente que neste manual nós estamos apenas ilustrando conceitos + básicos do Hibernate. O código imprime um cabeçalho HTML e um rodapé. Dentro desta página, + é mostrado um formulário em HTML, para entrada de novos eventos, e uma lista de todos + os eventos contidos no banco de dados. O primeiro método é trivial e apenas imprime + uma página HTML: + </para> + + <programlisting><![CDATA[private void printEventForm(PrintWriter out) { + out.println("<h2>Add new event:</h2>"); + out.println("<form>"); + out.println("Title: <input name='eventTitle' length='50'/><br/>"); + out.println("Date (e.g. 24.12.2009): <input name='eventDate' length='10'/><br/>"); + out.println("<input type='submit' name='action' value='store'/>"); + out.println("</form>"); +}]]></programlisting> + + <para> + O método <literal>listEvents()</literal> usa a <literal>Session</literal> do Hibernate + associada a thread atual para executar um query: + </para> + + <programlisting><![CDATA[private void listEvents(PrintWriter out, SimpleDateFormat dateFormatter) { + + List result = HibernateUtil.getSessionFactory() + .getCurrentSession().createCriteria(Event.class).list(); + if (result.size() > 0) { + out.println("<h2>Events in database:</h2>"); + out.println("<table border='1'>"); + out.println("<tr>"); + out.println("<th>Event title</th>"); + out.println("<th>Event date</th>"); + out.println("</tr>"); + for (Iterator it = result.iterator(); it.hasNext();) { + Event event = (Event) it.next(); + out.println("<tr>"); + out.println("<td>" + event.getTitle() + "</td>"); + out.println("<td>" + dateFormatter.format(event.getDate()) + "</td>"); + out.println("</tr>"); + } + out.println("</table>"); + } +}]]></programlisting> + + <para> + Finalmente, a action <literal>store</literal> é passada pra o método + <literal>createAndStoreEvent()</literal>, que também usa a + <literal>Session</literal> da thread atual: + </para> + + <programlisting><![CDATA[protected void createAndStoreEvent(String title, Date theDate) { + Event theEvent = new Event(); + theEvent.setTitle(title); + theEvent.setDate(theDate); + + HibernateUtil.getSessionFactory() + .getCurrentSession().save(theEvent); +}]]></programlisting> + + <para> + Pronto, o servlet está completo. Uma requisição para o servlet será processada + em uma <literal>Session</literal> e uma <literal>Transaction</literal> simples. + Como anteriormente, no aplicativo standalone, o Hibernate pode automaticamente + associar esses objetos a thread atual em execução. Isso possibilita a liberdade + de você modelar seu código e acessar o método <literal>SessionFactory</literal> + do jeito que achar melhor. Geralmente você irá usar um design mais sofisticado + e mover o código de acesso a dados para dentro de objetos de acesso a dados + (o patter DAO). Leia o Hibernate Wiki para maiores exemplos. + </para> + + </sect2> + + <sect2 id="tutorial-webapp-deploy"> + <title>Instalando e testando</title> + + <para> + Para fazer o deploy desta aplicação você tem que criar um arquivo para web, um WAR. + Adicione o alvo Ant abaixo em seu <literal>build.xml</literal>: + </para> + +<programlisting><![CDATA[<target name="war" depends="compile"> + <war destfile="hibernate-tutorial.war" webxml="web.xml"> + <lib dir="${librarydir}"> + <exclude name="jsdk*.jar"/> + </lib> + + <classes dir="${targetdir}"/> + </war> +</target>]]></programlisting> + + <para> + Esta target cria um arquivo chamado <literal>hibernate-tutorial.war</literal> + no diretório do seu projeto. Ele empacota todas as bibliotecas e o arquivo de + descrição <literal>web.xml</literal>, o qual é esperado no diretório base do seu projeto: + </para> + + <programlisting><![CDATA[<?xml version="1.0" encoding="UTF-8"?> +<web-app version="2.4" + xmlns="http://java.sun.com/xml/ns/j2ee" + xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"> + + <servlet> + <servlet-name>Event Manager</servlet-name> + <servlet-class>events.EventManagerServlet</servlet-class> + </servlet> + + <servlet-mapping> + <servlet-name>Event Manager</servlet-name> + <url-pattern>/eventmanager</url-pattern> + </servlet-mapping> +</web-app>]]></programlisting> + + <para> + Antes de você compilar e fazer o deploy desta aplicação web, note que uma biblioteca + adicional é requerida: <literal>jsdk.jar</literal>. Esse é o Java servlet development kit, + se você não possui esta biblioteca, faça seu download na página da Sun e copie-a + para seu diretório de bibliotecas. Entretanto, será usado somente para a compilação e + excluído do pacote WAR. + </para> + + <para> + Para compilar e instalar execute <literal>ant war</literal> no seu diretório do projeto + e copie o arquivo <literal>hibernate-tutorial.war</literal> para o diretório + <literal>webapp</literal> do Tomcat. Se você não possui o Tomcat instalado faça + o download e siga as instruções de instalação. Você não precisa modificar + nenhuma configuração do Tomcat para rodar este aplicativo. + </para> + + <para> + Uma vez feito o deploy e com Tomcat rodando, acesse o aplicativo em + <literal>http://localhost:8080/hibernate-tutorial/eventmanager</literal>. + Veja o log do Tomcat para observar a inicialização do Hibernate quando a + primeira requisição chega ao servlet (o inicializador estático dentro de + <literal>HibernateUtil</literal> é chamado) e para ter uma depuração + detalhada se ocorrer alguma exceção. + </para> + + </sect2> + + </sect1> + + <sect1 id="tutorial-summary" revision="1"> + <title>Sumário</title> + + <para> + Este manual cobriu os princípios básicos para criação de uma aplicação simples do Hibernate + e uma pequena aplicação web. + </para> + + <para> + Se você já se sente seguro com o Hibernate, continue navegando na documentação de referência + por tópicos que você acha interessante – os tópicos mais questionados são: + processo de transação (<xref linkend="transactions"/>), uso da API (<xref linkend="objectstate"/>) + e características de consulta (<xref linkend="objectstate-querying"/>). + </para> + + <para> + Não esqueça de visitar o site do Hibernate para obter mais tutoriais especializados. + </para> + + </sect1> + +</chapter> Modified: core/trunk/documentation/manual/pt-BR/src/main/docbook/content/xml.xml =================================================================== --- core/trunk/documentation/manual/pt-BR/src/main/docbook/content/xml.xml 2007-10-26 00:46:38 UTC (rev 14135) +++ core/trunk/documentation/manual/pt-BR/src/main/docbook/content/xml.xml 2007-10-26 00:48:48 UTC (rev 14136) @@ -1,7 +1,7 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> -<chapter id="xml"> +<chapter id="xml"> <title>Mapeamento XML</title> <para><emphasis>

18 years, 3 months

1
0
0 / 0

Hibernate SVN: r14135 - core/trunk/documentation/manual/translations/pt-BR/content.

by hibernate-commits＠lists.jboss.org

Author: xhuang(a)jboss.com Date: 2007-10-25 20:46:38 -0400 (Thu, 25 Oct 2007) New Revision: 14135 Modified: core/trunk/documentation/manual/translations/pt-BR/content/architecture.po core/trunk/documentation/manual/translations/pt-BR/content/association_mapping.po core/trunk/documentation/manual/translations/pt-BR/content/basic_mapping.po core/trunk/documentation/manual/translations/pt-BR/content/batch.po core/trunk/documentation/manual/translations/pt-BR/content/best_practices.po core/trunk/documentation/manual/translations/pt-BR/content/collection_mapping.po core/trunk/documentation/manual/translations/pt-BR/content/component_mapping.po core/trunk/documentation/manual/translations/pt-BR/content/configuration.po core/trunk/documentation/manual/translations/pt-BR/content/events.po core/trunk/documentation/manual/translations/pt-BR/content/example_mappings.po core/trunk/documentation/manual/translations/pt-BR/content/example_parentchild.po core/trunk/documentation/manual/translations/pt-BR/content/example_weblog.po core/trunk/documentation/manual/translations/pt-BR/content/filters.po core/trunk/documentation/manual/translations/pt-BR/content/inheritance_mapping.po core/trunk/documentation/manual/translations/pt-BR/content/performance.po core/trunk/documentation/manual/translations/pt-BR/content/persistent_classes.po core/trunk/documentation/manual/translations/pt-BR/content/preface.po core/trunk/documentation/manual/translations/pt-BR/content/query_criteria.po core/trunk/documentation/manual/translations/pt-BR/content/query_hql.po core/trunk/documentation/manual/translations/pt-BR/content/query_sql.po core/trunk/documentation/manual/translations/pt-BR/content/session_api.po core/trunk/documentation/manual/translations/pt-BR/content/toolset_guide.po core/trunk/documentation/manual/translations/pt-BR/content/transactions.po core/trunk/documentation/manual/translations/pt-BR/content/tutorial.po core/trunk/documentation/manual/translations/pt-BR/content/xml.po Log: Convert from pt-BR XML and merge with latest English XML Modified: core/trunk/documentation/manual/translations/pt-BR/content/architecture.po =================================================================== --- core/trunk/documentation/manual/translations/pt-BR/content/architecture.po 2007-10-25 22:34:46 UTC (rev 14134) +++ core/trunk/documentation/manual/translations/pt-BR/content/architecture.po 2007-10-26 00:46:38 UTC (rev 14135) @@ -1,216 +1,644 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:21 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: architecture.xml:21 +#, no-c-format msgid "Architecture" msgstr "Arquitetura" -#: index.docbook:24 +#. Tag: title +#: architecture.xml:24 +#, no-c-format msgid "Overview" -msgstr "Visão Geral" +msgstr "Visão Geral" -#: index.docbook:26 +#. Tag: para +#: architecture.xml:26 +#, no-c-format msgid "A (very) high-level view of the Hibernate architecture:" -msgstr "Uma visão bem ampla da arquitetura do Hibernate:" +msgstr "Uma visão bem ampla da arquitetura do Hibernate:" -#: index.docbook:39 -msgid "This diagram shows Hibernate using the database and configuration data to provide persistence services (and persistent objects) to the application." -msgstr "Esse diagrama mostra o Hibernate usando o banco de dados e a configuração de dados para prover persistência de serviços (e persistência de objetos) para o aplicativo." +#. Tag: para +#: architecture.xml:39 +#, no-c-format +msgid "" +"This diagram shows Hibernate using the database and configuration data to " +"provide persistence services (and persistent objects) to the application." +msgstr "" +"Esse diagrama mostra o Hibernate usando o banco de dados e a configuração de " +"dados para prover persistência de serviços (e persistência de objetos) para " +"o aplicativo." -#: index.docbook:44 -msgid "We would like to show a more detailed view of the runtime architecture. Unfortunately, Hibernate is flexible and supports several approaches. We will show the two extremes. The \"lite\" architecture has the application provide its own JDBC connections and manage its own transactions. This approach uses a minimal subset of Hibernate's APIs:" -msgstr "Nós gostaríamos de mostrar uma visão mais detalhada da arquitetura em execução. Infelizmente, o Hibernate é muito flexível e suporta várias aproximações. Nós iremos mostrar os dois extremos. Na arquitetura mais simples o aplicativo fornece suas próprias conexões JDBC e gerencia suas transações. Esta abordagem usa o mínimo de subconjuntos das APIs do Hibernate:" +#. Tag: para +#: architecture.xml:44 +#, no-c-format +msgid "" +"We would like to show a more detailed view of the runtime architecture. " +"Unfortunately, Hibernate is flexible and supports several approaches. We " +"will show the two extremes. The \"lite\" architecture has the application " +"provide its own JDBC connections and manage its own transactions. This " +"approach uses a minimal subset of Hibernate's APIs:" +msgstr "" +"Nós gostaríamos de mostrar uma visão mais detalhada da arquitetura em " +"execução. Infelizmente, o Hibernate é muito flexível e suporta várias " +"aproximações. Nós iremos mostrar os dois extremos. Na arquitetura mais " +"simples o aplicativo fornece suas próprias conexões JDBC e gerencia suas " +"transações. Esta abordagem usa o mínimo de subconjuntos das APIs do " +"Hibernate:" -#: index.docbook:61 -msgid "The \"full cream\" architecture abstracts the application away from the underlying JDBC/JTA APIs and lets Hibernate take care of the details." -msgstr "A arquitetura \"completa\" abstrai a aplicação de ter de lidar diretamente com JDBC/JTA e APIs e deixa o Hibernate tomar conta dos detalhes." +#. Tag: para +#: architecture.xml:61 +#, no-c-format +msgid "" +"The \"full cream\" architecture abstracts the application away from the " +"underlying JDBC/JTA APIs and lets Hibernate take care of the details." +msgstr "" +"A arquitetura \"completa\" abstrai a aplicação de ter de lidar diretamente " +"com JDBC/JTA e APIs e deixa o Hibernate tomar conta dos detalhes." -#: index.docbook:75 +#. Tag: para +#: architecture.xml:75 +#, fuzzy, no-c-format msgid "Heres some definitions of the objects in the diagrams:" -msgstr "Algumas definições dos objetos do diagrama:" +msgstr "Algumas definições dos objetos do diagrama: <placeholder-1/>" -#: index.docbook:80 +#. Tag: term +#: architecture.xml:80 +#, no-c-format msgid "SessionFactory (<literal>org.hibernate.SessionFactory</literal>)" msgstr "SessionFactory (<literal>org.hibernate.SessionFactory</literal>)" -#: index.docbook:82 -msgid "A threadsafe (immutable) cache of compiled mappings for a single database. A factory for <literal>Session</literal> and a client of <literal>ConnectionProvider</literal>. Might hold an optional (second-level) cache of data that is reusable between transactions, at a process- or cluster-level." -msgstr "Um cache threadsafe (imutáveis) composto de identidades compiladas para um único banco de dados. Uma fabrica para <literal>Session</literal> e um cliente de <literal>ConnectionProvider</literal>. Pode conter um cachê opcional de dados (segundo nível) reutilizáveis entre transações, no nível de processo- ou cluster." +#. Tag: para +#: architecture.xml:82 +#, no-c-format +msgid "" +"A threadsafe (immutable) cache of compiled mappings for a single database. A " +"factory for <literal>Session</literal> and a client of " +"<literal>ConnectionProvider</literal>. Might hold an optional (second-level) " +"cache of data that is reusable between transactions, at a process- or " +"cluster-level." +msgstr "" +"Um cache threadsafe (imutáveis) composto de identidades compiladas para um " +"único banco de dados. Uma fabrica para <literal>Session</literal> e um " +"cliente de <literal>ConnectionProvider</literal>. Pode conter um cachê " +"opcional de dados (segundo nível) reutilizáveis entre transações, no nível " +"de processo- ou cluster." -#: index.docbook:92 +#. Tag: term +#: architecture.xml:92 +#, no-c-format msgid "Session (<literal>org.hibernate.Session</literal>)" msgstr "Session (<literal>org.hibernate.Session</literal>)" -#: index.docbook:94 -msgid "A single-threaded, short-lived object representing a conversation between the application and the persistent store. Wraps a JDBC connection. Factory for <literal>Transaction</literal>. Holds a mandatory (first-level) cache of persistent objects, used when navigating the object graph or looking up objects by identifier." -msgstr "Objeto single-threaded, de vida curta, representando uma conversação entre o aplicativo e o armazenamento persistente. Cria uma camada sobre uma conexão JDBC. É uma fabrica de <literal>Transaction</literal>. Possui um cachê obrigatório (primeiro nível) de objetos persistentes, usado para navegação no gráficos de objetos e pesquisa de objetos pelo identificador." +#. Tag: para +#: architecture.xml:94 +#, no-c-format +msgid "" +"A single-threaded, short-lived object representing a conversation between " +"the application and the persistent store. Wraps a JDBC connection. Factory " +"for <literal>Transaction</literal>. Holds a mandatory (first-level) cache of " +"persistent objects, used when navigating the object graph or looking up " +"objects by identifier." +msgstr "" +"Objeto single-threaded, de vida curta, representando uma conversação entre o " +"aplicativo e o armazenamento persistente. Cria uma camada sobre uma conexão " +"JDBC. É uma fabrica de <literal>Transaction</literal>. Possui um cachê " +"obrigatório (primeiro nível) de objetos persistentes, usado para navegação " +"no gráficos de objetos e pesquisa de objetos pelo identificador." -#: index.docbook:104 +#. Tag: term +#: architecture.xml:104 +#, no-c-format msgid "Persistent objects and collections" msgstr "Objetos persistentes e coleções" -#: index.docbook:106 -msgid "Short-lived, single threaded objects containing persistent state and business function. These might be ordinary JavaBeans/POJOs, the only special thing about them is that they are currently associated with (exactly one) <literal>Session</literal>. As soon as the <literal>Session</literal> is closed, they will be detached and free to use in any application layer (e.g. directly as data transfer objects to and from presentation)." -msgstr "Objetos, de vida curta, single threaded contendo estado persistente e função de negócios. Esses podem ser JavaBeans/POJOs, onde única coisa especial sobre eles é que são associados a (exatamente uma) <literal>Session</literal>. Quando a <literal>Session</literal> é fechada, eles são separados e liberados para serem usados dentro de qualquer camada da aplicacao (Ex. diretamente como data transfer objects de e para a camada de apresentação)" +#. Tag: para +#: architecture.xml:106 +#, no-c-format +msgid "" +"Short-lived, single threaded objects containing persistent state and " +"business function. These might be ordinary JavaBeans/POJOs, the only special " +"thing about them is that they are currently associated with (exactly one) " +"<literal>Session</literal>. As soon as the <literal>Session</literal> is " +"closed, they will be detached and free to use in any application layer (e.g. " +"directly as data transfer objects to and from presentation)." +msgstr "" +"Objetos, de vida curta, single threaded contendo estado persistente e função " +"de negócios. Esses podem ser JavaBeans/POJOs, onde única coisa especial " +"sobre eles é que são associados a (exatamente uma) <literal>Session</" +"literal>. Quando a <literal>Session</literal> é fechada, eles são separados " +"e liberados para serem usados dentro de qualquer camada da aplicacao (Ex. " +"diretamente como data transfer objects de e para a camada de apresentação)" -#: index.docbook:117 +#. Tag: term +#: architecture.xml:117 +#, no-c-format msgid "Transient and detached objects and collections" msgstr "Objetos e coleções desatachados e transientes" -#: index.docbook:119 -msgid "Instances of persistent classes that are not currently associated with a <literal>Session</literal>. They may have been instantiated by the application and not (yet) persisted or they may have been instantiated by a closed <literal>Session</literal>." -msgstr "Instâncias de classes persistentes que ainda não estão associadas a uma <literal>Session</literal>. Eles podem ter sido instanciados pela aplicação e não persistido (ainda) ou eles foram instanciados por uma <literal>Session</literal> que foi encerrada." +#. Tag: para +#: architecture.xml:119 +#, no-c-format +msgid "" +"Instances of persistent classes that are not currently associated with a " +"<literal>Session</literal>. They may have been instantiated by the " +"application and not (yet) persisted or they may have been instantiated by a " +"closed <literal>Session</literal>." +msgstr "" +"Instâncias de classes persistentes que ainda não estão associadas a uma " +"<literal>Session</literal>. Eles podem ter sido instanciados pela aplicação " +"e não persistido (ainda) ou eles foram instanciados por uma " +"<literal>Session</literal> que foi encerrada." -#: index.docbook:128 +#. Tag: term +#: architecture.xml:128 +#, no-c-format msgid "Transaction (<literal>org.hibernate.Transaction</literal>)" msgstr "Transaction (<literal>org.hibernate.Transaction</literal>)" -#: index.docbook:130 -msgid "(Optional) A single-threaded, short-lived object used by the application to specify atomic units of work. Abstracts application from underlying JDBC, JTA or CORBA transaction. A <literal>Session</literal> might span several <literal>Transaction</literal>s in some cases. However, transaction demarcation, either using the underlying API or <literal>Transaction</literal>, is never optional!" -msgstr "(Opcional) Objeto de vida curta, single threaded, usado pela aplicação para especificar unidades atômicas de trabalho. Abstrai o aplicativo de lidar diretamente com transações JDBC, JTA ou CORBA. Uma <literal>Session</literal> pode, em alguns casos, iniciar várias <literal>Transaction</literal>s. Entretanto, a demarcação da transação, mesmo utilizando API ou Transaction subjacentes, nunca é opcional!" +#. Tag: para +#: architecture.xml:130 +#, no-c-format +msgid "" +"(Optional) A single-threaded, short-lived object used by the application to " +"specify atomic units of work. Abstracts application from underlying JDBC, " +"JTA or CORBA transaction. A <literal>Session</literal> might span several " +"<literal>Transaction</literal>s in some cases. However, transaction " +"demarcation, either using the underlying API or <literal>Transaction</" +"literal>, is never optional!" +msgstr "" +"(Opcional) Objeto de vida curta, single threaded, usado pela aplicação para " +"especificar unidades atômicas de trabalho. Abstrai o aplicativo de lidar " +"diretamente com transações JDBC, JTA ou CORBA. Uma <literal>Session</" +"literal> pode, em alguns casos, iniciar várias <literal>Transaction</" +"literal>s. Entretanto, a demarcação da transação, mesmo utilizando API ou " +"Transaction subjacentes, nunca é opcional!" -#: index.docbook:141 -msgid "ConnectionProvider (<literal>org.hibernate.connection.ConnectionProvider</literal>)" -msgstr "ConnectionProvider (<literal>org.hibernate.connection.ConnectionProvider</literal>)" +#. Tag: term +#: architecture.xml:141 +#, no-c-format +msgid "" +"ConnectionProvider (<literal>org.hibernate.connection.ConnectionProvider</" +"literal>)" +msgstr "" +"ConnectionProvider (<literal>org.hibernate.connection.ConnectionProvider</" +"literal>)" -#: index.docbook:143 -msgid "(Optional) A factory for (and pool of) JDBC connections. Abstracts application from underlying <literal>Datasource</literal> or <literal>DriverManager</literal>. Not exposed to application, but can be extended/implemented by the developer." -msgstr "(Opcional) Uma fábrica de (e combinações de) conexões JDBC. Abstrai a aplicação de lidar diretamente com <literal>Datasource</literal> ou <literal>DriverManager</literal>. Não exposto para a aplicação, mas pode ser implementado ou estendido pelo programador." +#. Tag: para +#: architecture.xml:143 +#, no-c-format +msgid "" +"(Optional) A factory for (and pool of) JDBC connections. Abstracts " +"application from underlying <literal>Datasource</literal> or " +"<literal>DriverManager</literal>. Not exposed to application, but can be " +"extended/implemented by the developer." +msgstr "" +"(Opcional) Uma fábrica de (e combinações de) conexões JDBC. Abstrai a " +"aplicação de lidar diretamente com <literal>Datasource</literal> ou " +"<literal>DriverManager</literal>. Não exposto para a aplicação, mas pode ser " +"implementado ou estendido pelo programador." -#: index.docbook:151 -msgid "TransactionFactory (<literal>org.hibernate.TransactionFactory</literal>)" -msgstr "TransactionFactory (<literal>org.hibernate.TransactionFactory</literal>)" +#. Tag: term +#: architecture.xml:151 +#, no-c-format +msgid "" +"TransactionFactory (<literal>org.hibernate.TransactionFactory</literal>)" +msgstr "" +"TransactionFactory (<literal>org.hibernate.TransactionFactory</literal>)" -#: index.docbook:153 -msgid "(Optional) A factory for <literal>Transaction</literal> instances. Not exposed to the application, but can be extended/implemented by the developer." -msgstr "(Opcional) Uma fábrica para instâncias de <literal>Transaction</literal>. Não exposta a aplicação, mas pode ser extendida/implementada pelo programador." +#. Tag: para +#: architecture.xml:153 +#, no-c-format +msgid "" +"(Optional) A factory for <literal>Transaction</literal> instances. Not " +"exposed to the application, but can be extended/implemented by the developer." +msgstr "" +"(Opcional) Uma fábrica para instâncias de <literal>Transaction</literal>. " +"Não exposta a aplicação, mas pode ser extendida/implementada pelo " +"programador." -#: index.docbook:160 +#. Tag: emphasis +#: architecture.xml:160 +#, no-c-format msgid "Extension Interfaces" msgstr "Extension Interfaces" -#: index.docbook:162 -msgid "Hibernate offers many optional extension interfaces you can implement to customize the behavior of your persistence layer. See the API documentation for details." -msgstr "O Hibernate oferece várias opções de interfaces estendidas que você pode implementar para customizar sua camada persistente. Veja a documentação da API para maiores detalhes." +#. Tag: para +#: architecture.xml:162 +#, no-c-format +msgid "" +"Hibernate offers many optional extension interfaces you can implement to " +"customize the behavior of your persistence layer. See the API documentation " +"for details." +msgstr "" +"O Hibernate oferece várias opções de interfaces estendidas que você pode " +"implementar para customizar sua camada persistente. Veja a documentação da " +"API para maiores detalhes." -#: index.docbook:171 -msgid "Given a \"lite\" architecture, the application bypasses the <literal>Transaction</literal>/<literal>TransactionFactory</literal> and/or <literal>ConnectionProvider</literal> APIs to talk to JTA or JDBC directly." -msgstr "Dada uma arquitetura simples, o aplicativo passa pelas APIs <literal>Transaction</literal>/<literal>TransactionFactory</literal> e/ou <literal>ConnectionProvider</literal> para se comunicar diretamente com a transação JTA ou JDBC." +#. Tag: para +#: architecture.xml:171 +#, no-c-format +msgid "" +"Given a \"lite\" architecture, the application bypasses the " +"<literal>Transaction</literal>/<literal>TransactionFactory</literal> and/or " +"<literal>ConnectionProvider</literal> APIs to talk to JTA or JDBC directly." +msgstr "" +"Dada uma arquitetura simples, o aplicativo passa pelas APIs " +"<literal>Transaction</literal>/<literal>TransactionFactory</literal> e/ou " +"<literal>ConnectionProvider</literal> para se comunicar diretamente com a " +"transação JTA ou JDBC." -#: index.docbook:179 +#. Tag: title +#: architecture.xml:179 +#, no-c-format msgid "Instance states" msgstr "Estados de instância" -#: index.docbook:180 -msgid "An instance of a persistent classes may be in one of three different states, which are defined with respect to a <emphasis>persistence context</emphasis>. The Hibernate <literal>Session</literal> object is the persistence context:" -msgstr "Uma instância de classes persistentes pode estar em um dos três diferentes estados, que são definidos respeitando um <emphasis>contexto persistente</emphasis>. O objeto <literal>Session</literal> do Hibernate é o contexto persistente:" +#. Tag: para +#: architecture.xml:180 +#, no-c-format +msgid "" +"An instance of a persistent classes may be in one of three different states, " +"which are defined with respect to a <emphasis>persistence context</" +"emphasis>. The Hibernate <literal>Session</literal> object is the " +"persistence context:" +msgstr "" +"Uma instância de classes persistentes pode estar em um dos três diferentes " +"estados, que são definidos respeitando um <emphasis>contexto persistente</" +"emphasis>. O objeto <literal>Session</literal> do Hibernate é o contexto " +"persistente:" -#: index.docbook:188 +#. Tag: term +#: architecture.xml:188 +#, no-c-format msgid "transient" msgstr "transiente" -#: index.docbook:190 -msgid "The instance is not, and has never been associated with any persistence context. It has no persistent identity (primary key value)." -msgstr "A instância não é, e nunca foi associada com nenhum contexto persistente. Não possui uma identidade persistente (valor de chave primária)." +#. Tag: para +#: architecture.xml:190 +#, no-c-format +msgid "" +"The instance is not, and has never been associated with any persistence " +"context. It has no persistent identity (primary key value)." +msgstr "" +"A instância não é, e nunca foi associada com nenhum contexto persistente. " +"Não possui uma identidade persistente (valor de chave primária)." -#: index.docbook:198 +#. Tag: term +#: architecture.xml:198 +#, no-c-format msgid "persistent" msgstr "persistente" -#: index.docbook:200 -msgid "The instance is currently associated with a persistence context. It has a persistent identity (primary key value) and, perhaps, a corresponding row in the database. For a particular persistence context, Hibernate <emphasis>guarantees</emphasis> that persistent identity is equivalent to Java identity (in-memory location of the object)." -msgstr "A instância está atualmente associada a um contexto persistente. Possui uma identidade persistente (valor de chave primária) e, talvez, correspondente a um registro no banco de dados. Para um contexto persistente em particular, o Hibernate <emphasis>guarantees</emphasis> que a identidade persistente é equivalente a identidade Java (na localização em memória do objeto)." +#. Tag: para +#: architecture.xml:200 +#, no-c-format +msgid "" +"The instance is currently associated with a persistence context. It has a " +"persistent identity (primary key value) and, perhaps, a corresponding row in " +"the database. For a particular persistence context, Hibernate " +"<emphasis>guarantees</emphasis> that persistent identity is equivalent to " +"Java identity (in-memory location of the object)." +msgstr "" +"A instância está atualmente associada a um contexto persistente. Possui uma " +"identidade persistente (valor de chave primária) e, talvez, correspondente a " +"um registro no banco de dados. Para um contexto persistente em particular, o " +"Hibernate <emphasis>guarantees</emphasis> que a identidade persistente é " +"equivalente a identidade Java (na localização em memória do objeto)." -#: index.docbook:212 +#. Tag: term +#: architecture.xml:212 +#, no-c-format msgid "detached" msgstr "desatachado" -#: index.docbook:214 -msgid "The instance was once associated with a persistence context, but that context was closed, or the instance was serialized to another process. It has a persistent identity and, perhaps, a corrsponding row in the database. For detached instances, Hibernate makes no guarantees about the relationship between persistent identity and Java identity." -msgstr "A instância foi associada com um contexto persistente, porém este contexto foi fechado, ou a instância foi serializada por outro processo. Possui uma identidade persistente, e, talvez, correspondenta a um registro no banco de dados. Para instâncias desatachadas, o Hibernate não garante o relacionamento entre identidade persistente e identidade Java." +#. Tag: para +#: architecture.xml:214 +#, no-c-format +msgid "" +"The instance was once associated with a persistence context, but that " +"context was closed, or the instance was serialized to another process. It " +"has a persistent identity and, perhaps, a corrsponding row in the database. " +"For detached instances, Hibernate makes no guarantees about the relationship " +"between persistent identity and Java identity." +msgstr "" +"A instância foi associada com um contexto persistente, porém este contexto " +"foi fechado, ou a instância foi serializada por outro processo. Possui uma " +"identidade persistente, e, talvez, correspondenta a um registro no banco de " +"dados. Para instâncias desatachadas, o Hibernate não garante o " +"relacionamento entre identidade persistente e identidade Java." -#: index.docbook:229 +#. Tag: title +#: architecture.xml:229 +#, no-c-format msgid "JMX Integration" msgstr "Integração JMX" -#: index.docbook:231 -msgid "JMX is the J2EE standard for management of Java components. Hibernate may be managed via a JMX standard service. We provide an MBean implementation in the distribution, <literal>org.hibernate.jmx.HibernateService</literal>." -msgstr "JMX é padrão J2EE para manipulação de componentes Java. O Hibernate pode ser manipulado por um serviço JMX padrão. Nós fornecemos uma implementação do MBean na distribuição, <literal>org.hibernate.jmx.HibernateService</literal>." +#. Tag: para +#: architecture.xml:231 +#, no-c-format +msgid "" +"JMX is the J2EE standard for management of Java components. Hibernate may be " +"managed via a JMX standard service. We provide an MBean implementation in " +"the distribution, <literal>org.hibernate.jmx.HibernateService</literal>." +msgstr "" +"JMX é padrão J2EE para manipulação de componentes Java. O Hibernate pode ser " +"manipulado por um serviço JMX padrão. Nós fornecemos uma implementação do " +"MBean na distribuição, <literal>org.hibernate.jmx.HibernateService</literal>." -#: index.docbook:237 -msgid "For an example how to deploy Hibernate as a JMX service on the JBoss Application Server, please see the JBoss User Guide. On JBoss AS, you also get these benefits if you deploy using JMX:" -msgstr "Para um exemplo de como instalar o Hibernate como um serviço JMX em um servidor de aplicativo JBoss, por favor, consulte o manual do usuário do JBoss. No JBoss As, você poderá ver os benefícios de de se fazer o deploy usando JMX:" +#. Tag: para +#: architecture.xml:237 +#, no-c-format +msgid "" +"For an example how to deploy Hibernate as a JMX service on the JBoss " +"Application Server, please see the JBoss User Guide. On JBoss AS, you also " +"get these benefits if you deploy using JMX:" +msgstr "" +"Para um exemplo de como instalar o Hibernate como um serviço JMX em um " +"servidor de aplicativo JBoss, por favor, consulte o manual do usuário do " +"JBoss. No JBoss As, você poderá ver os benefícios de de se fazer o deploy " +"usando JMX:" -#: index.docbook:245 -msgid "<emphasis>Session Management:</emphasis> The Hibernate <literal>Session</literal>'s life cycle can be automatically bound to the scope of a JTA transaction. This means you no longer have to manually open and close the <literal>Session</literal>, this becomes the job of a JBoss EJB interceptor. You also don't have to worry about transaction demarcation in your code anymore (unless you'd like to write a portable persistence layer of course, use the optional Hibernate <literal>Transaction</literal> API for this). You call the <literal>HibernateContext</literal> to access a <literal>Session</literal>." -msgstr "<emphasis>Session Management:</emphasis> O ciclo de vida de uma <literal>Session</literal> do Hibernate pode ser automaticamente conectada a um escopo de transação JTA. Isso significa que você não precisará mais abrir e fechar manualmente uma <literal>Session</literal>, isso se torna trabalho para um interceptor EJB do JBoss . Você também não precisa se preocupar, nunca mais, com demarcação de transação em seu código (a não ser que você prefira escrever uma camada persistente portável, para isso, use a API opcional do Hibernate <literal>Transaction</literal>). Você deve chamar <literal>HibernateContext</literal> para acessar uma <literal>Session</literal>." +#. Tag: para +#: architecture.xml:245 +#, no-c-format +msgid "" +"<emphasis>Session Management:</emphasis> The Hibernate <literal>Session</" +"literal>'s life cycle can be automatically bound to the scope of a JTA " +"transaction. This means you no longer have to manually open and close the " +"<literal>Session</literal>, this becomes the job of a JBoss EJB interceptor. " +"You also don't have to worry about transaction demarcation in your code " +"anymore (unless you'd like to write a portable persistence layer of course, " +"use the optional Hibernate <literal>Transaction</literal> API for this). You " +"call the <literal>HibernateContext</literal> to access a <literal>Session</" +"literal>." +msgstr "" +"<emphasis>Session Management:</emphasis> O ciclo de vida de uma " +"<literal>Session</literal> do Hibernate pode ser automaticamente conectada a " +"um escopo de transação JTA. Isso significa que você não precisará mais abrir " +"e fechar manualmente uma <literal>Session</literal>, isso se torna trabalho " +"para um interceptor EJB do JBoss . Você também não precisa se preocupar, " +"nunca mais, com demarcação de transação em seu código (a não ser que você " +"prefira escrever uma camada persistente portável, para isso, use a API " +"opcional do Hibernate <literal>Transaction</literal>). Você deve chamar " +"<literal>HibernateContext</literal> para acessar uma <literal>Session</" +"literal>." -#: index.docbook:257 -msgid "<emphasis>HAR deployment:</emphasis> Usually you deploy the Hibernate JMX service using a JBoss service deployment descriptor (in an EAR and/or SAR file), it supports all the usual configuration options of a Hibernate <literal>SessionFactory</literal>. However, you still have to name all your mapping files in the deployment descriptor. If you decide to use the optional HAR deployment, JBoss will automatically detect all mapping files in your HAR file." -msgstr "<emphasis>HAR deployment:</emphasis>: Normalmente você faz o deploy de um serviço JMX do Hibernate usando um serviço descritor de deploy do JBoss (em um EAR e/ou arquivo SAR), que suporta todas as configurações usuais de uma <literal>SessionFactory</literal> do Hibernate. Entretanto, você ainda precisa nomear todos os seus arquivos de mapeamento no descritor de deploração. Se você decidir usar o deploy opcional HAR, o JBoss irá automaticamente detectar todos os seus arquivos de mapeamento no seu arquivo HAR." +#. Tag: para +#: architecture.xml:257 +#, no-c-format +msgid "" +"<emphasis>HAR deployment:</emphasis> Usually you deploy the Hibernate JMX " +"service using a JBoss service deployment descriptor (in an EAR and/or SAR " +"file), it supports all the usual configuration options of a Hibernate " +"<literal>SessionFactory</literal>. However, you still have to name all your " +"mapping files in the deployment descriptor. If you decide to use the " +"optional HAR deployment, JBoss will automatically detect all mapping files " +"in your HAR file." +msgstr "" +"<emphasis>HAR deployment:</emphasis>: Normalmente você faz o deploy de um " +"serviço JMX do Hibernate usando um serviço descritor de deploy do JBoss (em " +"um EAR e/ou arquivo SAR), que suporta todas as configurações usuais de uma " +"<literal>SessionFactory</literal> do Hibernate. Entretanto, você ainda " +"precisa nomear todos os seus arquivos de mapeamento no descritor de " +"deploração. Se você decidir usar o deploy opcional HAR, o JBoss irá " +"automaticamente detectar todos os seus arquivos de mapeamento no seu arquivo " +"HAR." -#: index.docbook:268 -msgid "Consult the JBoss AS user guide for more information about these options." -msgstr "Consulte o manual do usuário do JBoss AS, para obter maiores informações sobre essas opções." +#. Tag: para +#: architecture.xml:268 +#, no-c-format +msgid "" +"Consult the JBoss AS user guide for more information about these options." +msgstr "" +"Consulte o manual do usuário do JBoss AS, para obter maiores informações " +"sobre essas opções." -#: index.docbook:272 -msgid "Another feature available as a JMX service are runtime Hibernate statistics. See <xref linkend=\"configuration-optional-statistics\"/>." -msgstr "Another feature available as a JMX service are runtime Hibernate statistics. See <xref linkend=\"configuration-optional-statistics\"/>. Outra opção disponível como um serviço JMX são as estatísticas de execução do Hibernate. Veja a <xref linkend=\"configuration-optional-statistics\"/>." +#. Tag: para +#: architecture.xml:272 +#, no-c-format +msgid "" +"Another feature available as a JMX service are runtime Hibernate statistics. " +"See <xref linkend=\"configuration-optional-statistics\"/>." +msgstr "" +"Another feature available as a JMX service are runtime Hibernate statistics. " +"See <xref linkend=\"configuration-optional-statistics\"/>. Outra opção " +"disponível como um serviço JMX são as estatísticas de execução do Hibernate. " +"Veja a <xref linkend=\"configuration-optional-statistics\"/>." -#: index.docbook:279 +#. Tag: title +#: architecture.xml:279 +#, no-c-format msgid "JCA Support" msgstr "Suporte JCA" -#: index.docbook:280 -msgid "Hibernate may also be configured as a JCA connector. Please see the website for more details. Please note that Hibernate JCA support is still considered experimental." -msgstr "Hibernate may also be configured as a JCA connector. Please see the website for more details. Please note that Hibernate JCA support is still considered experimental. O Hibernate pode também ser configurado como um conector JCA. Por favor, visite o website para maiores detalhes. Entretanto, note que o suporte JCA do Hibernate ainda é considerado experimental." +#. Tag: para +#: architecture.xml:280 +#, no-c-format +msgid "" +"Hibernate may also be configured as a JCA connector. Please see the website " +"for more details. Please note that Hibernate JCA support is still considered " +"experimental." +msgstr "" +"Hibernate may also be configured as a JCA connector. Please see the website " +"for more details. Please note that Hibernate JCA support is still considered " +"experimental. O Hibernate pode também ser configurado como um conector JCA. " +"Por favor, visite o website para maiores detalhes. Entretanto, note que o " +"suporte JCA do Hibernate ainda é considerado experimental." -#: index.docbook:287 +#. Tag: title +#: architecture.xml:287 +#, no-c-format msgid "Contextual Sessions" msgstr "Sessões contextuais" -#: index.docbook:288 -msgid "Most applications using Hibernate need some form of \"contextual\" sessions, where a given session is in effect throughout the scope of a given context. However, across applications the definition of what constitutes a context is typically different; and different contexts define different scopes to the notion of current. Applications using Hibernate prior to version 3.0 tended to utilize either home-grown <literal>ThreadLocal</literal>-based contextual sessions, helper classes such as <literal>HibernateUtil</literal>, or utilized third-party frameworks (such as Spring or Pico) which provided proxy/interception-based contextual sessions." -msgstr "Muitas aplicações que usam o Hibernate necessita de algum tipo de sessão \"contextual\", onde uma sessão dada é na verdade um escopo de um contexto. Entretanto, através de aplicações a definição sobre um contexto é geralmente diferente; e contextos diferentes definem escopos diferentes. Aplicações usando versões anteriores ao Hibernate 3.0 tendem a utilizar tanto sessões contextuais baseadas em <literal>ThreadLocal</literal>, classes utilitárias como <literal>HibernateUtil</literal>, ou utilizar frameworks de terceiros(como Spring ou Pico) que provê sessões contextuais baseadas em proxy." +#. Tag: para +#: architecture.xml:288 +#, no-c-format +msgid "" +"Most applications using Hibernate need some form of \"contextual\" sessions, " +"where a given session is in effect throughout the scope of a given context. " +"However, across applications the definition of what constitutes a context is " +"typically different; and different contexts define different scopes to the " +"notion of current. Applications using Hibernate prior to version 3.0 tended " +"to utilize either home-grown <literal>ThreadLocal</literal>-based contextual " +"sessions, helper classes such as <literal>HibernateUtil</literal>, or " +"utilized third-party frameworks (such as Spring or Pico) which provided " +"proxy/interception-based contextual sessions." +msgstr "" +"Muitas aplicações que usam o Hibernate necessita de algum tipo de sessão " +"\"contextual\", onde uma sessão dada é na verdade um escopo de um contexto. " +"Entretanto, através de aplicações a definição sobre um contexto é geralmente " +"diferente; e contextos diferentes definem escopos diferentes. Aplicações " +"usando versões anteriores ao Hibernate 3.0 tendem a utilizar tanto sessões " +"contextuais baseadas em <literal>ThreadLocal</literal>, classes utilitárias " +"como <literal>HibernateUtil</literal>, ou utilizar frameworks de terceiros" +"(como Spring ou Pico) que provê sessões contextuais baseadas em proxy." -#: index.docbook:297 -msgid "Starting with version 3.0.1, Hibernate added the <literal>SessionFactory.getCurrentSession()</literal> method. Initially, this assumed usage of <literal>JTA</literal> transactions, where the <literal>JTA</literal> transaction defined both the scope and context of a current session. The Hibernate team maintains that, given the maturity of the numerous stand-alone <literal>JTA TransactionManager</literal> implementations out there, most (if not all) applications should be using <literal>JTA</literal> transaction management whether or not they are deployed into a <literal>J2EE</literal> container. Based on that, the <literal>JTA</literal>-based contextual sessions is all you should ever need to use." -msgstr "A partir da versão 3.0.1, o Hibernate adicionou o método <literal>SessionFactory.getCurrentSession()</literal>. Inicialmente, este assume o uso de transações <literal>JTA</literal>, onde a transação <literal>JTA</literal> define tanto o escopo quanto o contexto de uma sessão atual. O time do Hibernate mantém este recurso, desenvolvendo as diversas implementações do <literal>JTA TransactionManager</literal>, a maioria (se não todos) aplicativos deveria utilizar o gerenciador de transações <literal>JTA</literal> sendo ou não instalados dentro de um container <literal>J2EE</literal>. Baseado neste recurso, você deveria sempre utilizar sessões contextuais baseadas em <literal>JTA</literal>." +#. Tag: para +#: architecture.xml:297 +#, no-c-format +msgid "" +"Starting with version 3.0.1, Hibernate added the <literal>SessionFactory." +"getCurrentSession()</literal> method. Initially, this assumed usage of " +"<literal>JTA</literal> transactions, where the <literal>JTA</literal> " +"transaction defined both the scope and context of a current session. The " +"Hibernate team maintains that, given the maturity of the numerous stand-" +"alone <literal>JTA TransactionManager</literal> implementations out there, " +"most (if not all) applications should be using <literal>JTA</literal> " +"transaction management whether or not they are deployed into a " +"<literal>J2EE</literal> container. Based on that, the <literal>JTA</literal>-" +"based contextual sessions is all you should ever need to use." +msgstr "" +"A partir da versão 3.0.1, o Hibernate adicionou o método " +"<literal>SessionFactory.getCurrentSession()</literal>. Inicialmente, este " +"assume o uso de transações <literal>JTA</literal>, onde a transação " +"<literal>JTA</literal> define tanto o escopo quanto o contexto de uma sessão " +"atual. O time do Hibernate mantém este recurso, desenvolvendo as diversas " +"implementações do <literal>JTA TransactionManager</literal>, a maioria (se " +"não todos) aplicativos deveria utilizar o gerenciador de transações " +"<literal>JTA</literal> sendo ou não instalados dentro de um container " +"<literal>J2EE</literal>. Baseado neste recurso, você deveria sempre utilizar " +"sessões contextuais baseadas em <literal>JTA</literal>." -#: index.docbook:307 -msgid "However, as of version 3.1, the processing behind <literal>SessionFactory.getCurrentSession()</literal> is now pluggable. To that end, a new extension interface (<literal>org.hibernate.context.CurrentSessionContext</literal>) and a new configuration parameter (<literal>hibernate.current_session_context_class</literal>) have been added to allow pluggability of the scope and context of defining current sessions." -msgstr "Entretanto, na versão 3.1, o processo por trás do método <literal>SessionFactory.getCurrentSession()</literal> é agora plugavel. Com isso, uma nova interface (<literal>org.hibernate.context.CurrentSessionContext</literal>) e um novo parâmetro de configuração (<literal>hibernate.current_session_context_class</literal>) foram adicionados para possibilitar a compatibilidade do contexto e do escopo na definição de sessões correntes." +#. Tag: para +#: architecture.xml:307 +#, no-c-format +msgid "" +"However, as of version 3.1, the processing behind <literal>SessionFactory." +"getCurrentSession()</literal> is now pluggable. To that end, a new extension " +"interface (<literal>org.hibernate.context.CurrentSessionContext</literal>) " +"and a new configuration parameter (<literal>hibernate." +"current_session_context_class</literal>) have been added to allow " +"pluggability of the scope and context of defining current sessions." +msgstr "" +"Entretanto, na versão 3.1, o processo por trás do método " +"<literal>SessionFactory.getCurrentSession()</literal> é agora plugavel. Com " +"isso, uma nova interface (<literal>org.hibernate.context." +"CurrentSessionContext</literal>) e um novo parâmetro de configuração " +"(<literal>hibernate.current_session_context_class</literal>) foram " +"adicionados para possibilitar a compatibilidade do contexto e do escopo na " +"definição de sessões correntes." -#: index.docbook:314 -msgid "See the Javadocs for the <literal>org.hibernate.context.CurrentSessionContext</literal> interface for a detailed discussion of its contract. It defines a single method, <literal>currentSession()</literal>, by which the implementation is responsible for tracking the current contextual session. Out-of-the-box, Hibernate comes with three implementations of this interface." -msgstr "De uma olhada em Javadocs sobre a interface <literal>org.hibernate.context.CurrentSessionContext</literal> para uma discussão detalhada. Ela define um método único, <literal>currentSession()</literal>, com o qual a implementação é responsável por rastrear a sessão contextual corrente. Por fora do \"encapsulamento\", o Hibernate possui duas implementações dessa interface." +#. Tag: para +#: architecture.xml:314 +#, no-c-format +msgid "" +"See the Javadocs for the <literal>org.hibernate.context." +"CurrentSessionContext</literal> interface for a detailed discussion of its " +"contract. It defines a single method, <literal>currentSession()</literal>, " +"by which the implementation is responsible for tracking the current " +"contextual session. Out-of-the-box, Hibernate comes with three " +"implementations of this interface." +msgstr "" +"De uma olhada em Javadocs sobre a interface <literal>org.hibernate.context." +"CurrentSessionContext</literal> para uma discussão detalhada. Ela define um " +"método único, <literal>currentSession()</literal>, com o qual a " +"implementação é responsável por rastrear a sessão contextual corrente. Por " +"fora do \"encapsulamento\", o Hibernate possui duas implementações dessa " +"interface." -#: index.docbook:324 -msgid "<literal>org.hibernate.context.JTASessionContext</literal> - current sessions are tracked and scoped by a <literal>JTA</literal> transaction. The processing here is exactly the same as in the older JTA-only approach. See the Javadocs for details." -msgstr "<literal>org.hibernate.context.JTASessionContext</literal> - As sessões correntes são rastreadas e recebem um escopo por uma transação <literal>JTA</literal>. O processamento aqui é exatamente igual ao antigo processo JTA. Consulte em Javadocs para maiores detalhes." +#. Tag: para +#: architecture.xml:324 +#, no-c-format +msgid "" +"<literal>org.hibernate.context.JTASessionContext</literal> - current " +"sessions are tracked and scoped by a <literal>JTA</literal> transaction. The " +"processing here is exactly the same as in the older JTA-only approach. See " +"the Javadocs for details." +msgstr "" +"<literal>org.hibernate.context.JTASessionContext</literal> - As sessões " +"correntes são rastreadas e recebem um escopo por uma transação <literal>JTA</" +"literal>. O processamento aqui é exatamente igual ao antigo processo JTA. " +"Consulte em Javadocs para maiores detalhes." -#: index.docbook:332 -msgid "<literal>org.hibernate.context.ThreadLocalSessionContext</literal> - current sessions are tracked by thread of execution. Again, see the Javadocs for details." -msgstr "<literal>org.hibernate.context.ThreadLocalSessionContext</literal> - As sessões correntes são rastreadas por uma thread de execução. Novamente, consulte em Javadocs para maiores detalhes." +#. Tag: para +#: architecture.xml:332 +#, no-c-format +msgid "" +"<literal>org.hibernate.context.ThreadLocalSessionContext</literal> - current " +"sessions are tracked by thread of execution. Again, see the Javadocs for " +"details." +msgstr "" +"<literal>org.hibernate.context.ThreadLocalSessionContext</literal> - As " +"sessões correntes são rastreadas por uma thread de execução. Novamente, " +"consulte em Javadocs para maiores detalhes." -#: index.docbook:338 -msgid "<literal>org.hibernate.context.ManagedSessionContext</literal> - current sessions are tracked by thread of execution. However, you are responsible to bind and unbind a <literal>Session</literal> instance with static methods on this class, it does never open, flush, or close a <literal>Session</literal>." -msgstr "<literal>org.hibernate.context.ManagedSessionContext</literal> - current sessions are tracked by thread of execution. However, you are responsible to bind and unbind a <literal>Session</literal> instance with static methods on this class, it does never open, flush, or close a <literal>Session</literal>." +#. Tag: para +#: architecture.xml:338 +#, no-c-format +msgid "" +"<literal>org.hibernate.context.ManagedSessionContext</literal> - current " +"sessions are tracked by thread of execution. However, you are responsible to " +"bind and unbind a <literal>Session</literal> instance with static methods on " +"this class, it does never open, flush, or close a <literal>Session</literal>." +msgstr "" +"<literal>org.hibernate.context.ManagedSessionContext</literal> - current " +"sessions are tracked by thread of execution. However, you are responsible to " +"bind and unbind a <literal>Session</literal> instance with static methods on " +"this class, it does never open, flush, or close a <literal>Session</literal>." -#: index.docbook:347 -msgid "The first two implementations provide a \"one session - one database transaction\" programming model, also known and used as <emphasis>session-per-request</emphasis>. The beginning and end of a Hibernate session is defined by the duration of a database transaction. If you use programatic transaction demarcation in plain JSE without JTA, you are adviced to use the Hibernate <literal>Transaction</literal> API to hide the underlying transaction system from your code. If you use JTA, use the JTA interfaces to demarcate transactions. If you execute in an EJB container that supports CMT, transaction boundaries are defined declaratively and you don't need any transaction or session demarcation operations in your code. Refer to <xref linkend=\"transactions\"/> for more information and code examples." -msgstr "As duas primeiras implementações usam o modelo de programação \"uma sessão – uma transação do banco de dados\", também conhecida e usado como <emphasis>sessão por requisição</emphasis>. O começo e o fim de uma sessão Hibernate é definida pela duração da transação do banco de dados. Se você usa demarcação programática de transação (por exemplo. em J2SE puro ou com JTA /UserTransaction/BMT), você é recomendado a usar a API Hibernate <literal>Transaction</literal> para esconder a base do sistema de transação do seu código. Se você executa em um container EJB que suporta CMT, os limites das transações são definidas declarativamente e você não necessita de qualquer transação ou operação de demarcação de sessão no seu código. Consulte o <xref linkend=\"transactions\"/> para mais informações exemplos de código." +#. Tag: para +#: architecture.xml:347 +#, no-c-format +msgid "" +"The first two implementations provide a \"one session - one database " +"transaction\" programming model, also known and used as <emphasis>session-" +"per-request</emphasis>. The beginning and end of a Hibernate session is " +"defined by the duration of a database transaction. If you use programatic " +"transaction demarcation in plain JSE without JTA, you are adviced to use the " +"Hibernate <literal>Transaction</literal> API to hide the underlying " +"transaction system from your code. If you use JTA, use the JTA interfaces to " +"demarcate transactions. If you execute in an EJB container that supports " +"CMT, transaction boundaries are defined declaratively and you don't need any " +"transaction or session demarcation operations in your code. Refer to <xref " +"linkend=\"transactions\"/> for more information and code examples." +msgstr "" +"As duas primeiras implementações usam o modelo de programação \"uma sessão – " +"uma transação do banco de dados\", também conhecida e usado como " +"<emphasis>sessão por requisição</emphasis>. O começo e o fim de uma sessão " +"Hibernate é definida pela duração da transação do banco de dados. Se você " +"usa demarcação programática de transação (por exemplo. em J2SE puro ou com " +"JTA /UserTransaction/BMT), você é recomendado a usar a API Hibernate " +"<literal>Transaction</literal> para esconder a base do sistema de transação " +"do seu código. Se você executa em um container EJB que suporta CMT, os " +"limites das transações são definidas declarativamente e você não necessita " +"de qualquer transação ou operação de demarcação de sessão no seu código. " +"Consulte o <xref linkend=\"transactions\"/> para mais informações exemplos " +"de código." -#: index.docbook:359 -msgid "The <literal>hibernate.current_session_context_class</literal> configuration parameter defines which <literal>org.hibernate.context.CurrentSessionContext</literal> implementation should be used. Note that for backwards compatibility, if this config param is not set but a <literal>org.hibernate.transaction.TransactionManagerLookup</literal> is configured, Hibernate will use the <literal>org.hibernate.context.JTASessionContext</literal>. Typically, the value of this parameter would just name the implementation class to use; for the three out-of-the-box implementations, however, there are three corresponding short names, \"jta\", \"thread\", and \"managed\"." -msgstr "O parâmetro de configuração <literal>hibernate.current_session_context_class</literal> define que a implementação <literal>org.hibernate.context.CurrentSessionContext</literal> deve ser usada. Note que para compatibilidade anterior, se este parâmetro de configuração não é determinado mas um <literal>org.hibernate.transaction.TransactionManagerLookup</literal> é configurado, Hibernate usará o <literal>org.hibernate.context.JTASessionContext</literal>. Tipicamente, o valor deste parâmetro nomearia apenas a classe de implementação para usar; para as duas implementações out-of-the-box, entretanto, há três pequenos nomes correspondentes, \"jta\", \"thread\", and \"managed\"." - -msgid "ROLES_OF_TRANSLATORS" -msgstr "" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "" - +#. Tag: para +#: architecture.xml:359 +#, no-c-format +msgid "" +"The <literal>hibernate.current_session_context_class</literal> configuration " +"parameter defines which <literal>org.hibernate.context." +"CurrentSessionContext</literal> implementation should be used. Note that for " +"backwards compatibility, if this config param is not set but a <literal>org." +"hibernate.transaction.TransactionManagerLookup</literal> is configured, " +"Hibernate will use the <literal>org.hibernate.context.JTASessionContext</" +"literal>. Typically, the value of this parameter would just name the " +"implementation class to use; for the three out-of-the-box implementations, " +"however, there are three corresponding short names, \"jta\", \"thread\", and " +"\"managed\"." +msgstr "" +"O parâmetro de configuração <literal>hibernate." +"current_session_context_class</literal> define que a implementação " +"<literal>org.hibernate.context.CurrentSessionContext</literal> deve ser " +"usada. Note que para compatibilidade anterior, se este parâmetro de " +"configuração não é determinado mas um <literal>org.hibernate.transaction." +"TransactionManagerLookup</literal> é configurado, Hibernate usará o " +"<literal>org.hibernate.context.JTASessionContext</literal>. Tipicamente, o " +"valor deste parâmetro nomearia apenas a classe de implementação para usar; " +"para as duas implementações out-of-the-box, entretanto, há três pequenos " +"nomes correspondentes, \"jta\", \"thread\", and \"managed\"." Modified: core/trunk/documentation/manual/translations/pt-BR/content/association_mapping.po =================================================================== --- core/trunk/documentation/manual/translations/pt-BR/content/association_mapping.po 2007-10-25 22:34:46 UTC (rev 14134) +++ core/trunk/documentation/manual/translations/pt-BR/content/association_mapping.po 2007-10-26 00:46:38 UTC (rev 14135) @@ -1,608 +1,914 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:6 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: association_mapping.xml:6 +#, no-c-format msgid "Association Mappings" -msgstr "" +msgstr "Mapeamento de Associações" -#: index.docbook:9 +#. Tag: title +#: association_mapping.xml:9 +#, no-c-format msgid "Introduction" -msgstr "" +msgstr "Introdução" -#: index.docbook:11 -msgid "Association mappings are the often most difficult thing to get right. In this section we'll go through the canonical cases one by one, starting with unidirectional mappings, and then considering the bidirectional cases. We'll use <literal>Person</literal> and <literal>Address</literal> in all the examples." +#. Tag: para +#: association_mapping.xml:11 +#, no-c-format +msgid "" +"Association mappings are the often most difficult thing to get right. In " +"this section we'll go through the canonical cases one by one, starting with " +"unidirectional mappings, and then considering the bidirectional cases. We'll " +"use <literal>Person</literal> and <literal>Address</literal> in all the " +"examples." msgstr "" +"Mapeamentos de associações são freqüentemente a coisa mais difícil de se " +"acertar. Nesta seção nós passaremos pêlos casos canônicos um pôr um, " +"começando com mapeamentos unidirecionais e considerando os casos " +"bidirecionais. Nos vamos usar <literal>Person</literal> e <literal>Address</" +"literal> em todos os exemplos." -#: index.docbook:19 -msgid "We'll classify associations by whether or not they map to an intervening join table, and by multiplicity." +#. Tag: para +#: association_mapping.xml:19 +#, no-c-format +msgid "" +"We'll classify associations by whether or not they map to an intervening " +"join table, and by multiplicity." msgstr "" +"Nós classificaremos as associações pelo seu mapeamento ou a falta do mesmo, " +"sua intervenção na tabela associativa, e pela sua multiplicidade." -#: index.docbook:24 -msgid "Nullable foreign keys are not considered good practice in traditional data modelling, so all our examples use not null foreign keys. This is not a requirement of Hibernate, and the mappings will all work if you drop the nullability constraints." +#. Tag: para +#: association_mapping.xml:24 +#, no-c-format +msgid "" +"Nullable foreign keys are not considered good practice in traditional data " +"modelling, so all our examples use not null foreign keys. This is not a " +"requirement of Hibernate, and the mappings will all work if you drop the " +"nullability constraints." msgstr "" +"O uso de chaves estrangeiras não obrigatórias não é considerada uma boa " +"prática na modelagem de dados tradicional, assim todos nossos exemplos usam " +"chaves estrangeiras obrigatórias. Esta não é uma exigência do Hibernate, e " +"todas as mapeamentos funcionarão se você remover as constraints de " +"obrigatoriedade." -#: index.docbook:34 +#. Tag: title +#: association_mapping.xml:34 +#, no-c-format msgid "Unidirectional associations" -msgstr "" +msgstr "Associações Unidirecionais" -#: index.docbook:37, index.docbook:108 +#. Tag: title +#: association_mapping.xml:37 association_mapping.xml:108 +#, no-c-format msgid "many to one" -msgstr "" +msgstr "muitos para um" -#: index.docbook:39 -msgid "A <emphasis>unidirectional many-to-one association</emphasis> is the most common kind of unidirectional association." +#. Tag: para +#: association_mapping.xml:39 +#, no-c-format +msgid "" +"A <emphasis>unidirectional many-to-one association</emphasis> is the most " +"common kind of unidirectional association." msgstr "" +"Uma <emphasis>associação unidirecional muitos-para-um</emphasis> é o tipo " +"mais comum de associação unidirecional." -#: index.docbook:44 +#. Tag: programlisting +#: association_mapping.xml:44 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <many-to-one name=\"address\" \n" - " column=\"addressId\"\n" - " not-null=\"true\"/>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <many-to-one name=\"address\" \n" +" column=\"addressId\"\n" +" not-null=\"true\"/>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +"</class>]]>" msgstr "" -#: index.docbook:45, index.docbook:161 +#. Tag: programlisting +#: association_mapping.xml:45 association_mapping.xml:161 +#, no-c-format msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key, addressId bigint not null )\n" - "create table Address ( addressId bigint not null primary key )\n" - " ]]>" +"<![CDATA[\n" +"create table Person ( personId bigint not null primary key, addressId bigint " +"not null )\n" +"create table Address ( addressId bigint not null primary key )\n" +" ]]>" msgstr "" -#: index.docbook:50, index.docbook:121, index.docbook:185, index.docbook:225 +#. Tag: title +#: association_mapping.xml:50 association_mapping.xml:121 +#: association_mapping.xml:185 association_mapping.xml:225 +#, fuzzy, no-c-format msgid "one to one" msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"um para um\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"um para um\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"um para um\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"one to one" -#: index.docbook:52 -msgid "A <emphasis>unidirectional one-to-one association on a foreign key</emphasis> is almost identical. The only difference is the column unique constraint." +#. Tag: para +#: association_mapping.xml:52 +#, no-c-format +msgid "" +"A <emphasis>unidirectional one-to-one association on a foreign key</" +"emphasis> is almost identical. The only difference is the column unique " +"constraint." msgstr "" +"Uma <emphasis>associação unidirecional um-para-um em uma chave estrangeira </" +"emphasis> é quase idêntica. A única diferença é a constraint unique na " +"coluna." -#: index.docbook:57 +#. Tag: programlisting +#: association_mapping.xml:57 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <many-to-one name=\"address\" \n" - " column=\"addressId\" \n" - " unique=\"true\"\n" - " not-null=\"true\"/>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <many-to-one name=\"address\" \n" +" column=\"addressId\" \n" +" unique=\"true\"\n" +" not-null=\"true\"/>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +"</class>]]>" msgstr "" -#: index.docbook:58, index.docbook:193 +#. Tag: programlisting +#: association_mapping.xml:58 association_mapping.xml:193 +#, no-c-format msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key, addressId bigint not null unique )\n" - "create table Address ( addressId bigint not null primary key )\n" - " ]]>" +"<![CDATA[\n" +"create table Person ( personId bigint not null primary key, addressId bigint " +"not null unique )\n" +"create table Address ( addressId bigint not null primary key )\n" +" ]]>" msgstr "" -#: index.docbook:60 -msgid "A <emphasis>unidirectional one-to-one association on a primary key</emphasis> usually uses a special id generator. (Notice that we've reversed the direction of the association in this example.)" +#. Tag: para +#: association_mapping.xml:60 +#, no-c-format +msgid "" +"A <emphasis>unidirectional one-to-one association on a primary key</" +"emphasis> usually uses a special id generator. (Notice that we've reversed " +"the direction of the association in this example.)" msgstr "" +"Uma <emphasis>associação unidirecional um-para-um na chave primaria</" +"emphasis> geralmente usa um gerador de id special. ( Note que nós invertemos " +"a direção da associação nesse exemplo)." -#: index.docbook:66 +#. Tag: programlisting +#: association_mapping.xml:66 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"foreign\">\n" - " <param name=\"property\">person</param>\n" - " </generator>\n" - " </id>\n" - " <one-to-one name=\"person\" constrained=\"true\"/>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"foreign\">\n" +" <param name=\"property\">person</param>\n" +" </generator>\n" +" </id>\n" +" <one-to-one name=\"person\" constrained=\"true\"/>\n" +"</class>]]>" msgstr "" -#: index.docbook:67, index.docbook:201 +#. Tag: programlisting +#: association_mapping.xml:67 association_mapping.xml:201 +#, no-c-format msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key )\n" - "create table Address ( personId bigint not null primary key )\n" - " ]]>" +"<![CDATA[\n" +"create table Person ( personId bigint not null primary key )\n" +"create table Address ( personId bigint not null primary key )\n" +" ]]>" msgstr "" -#: index.docbook:72, index.docbook:94 +#. Tag: title +#: association_mapping.xml:72 association_mapping.xml:94 +#, no-c-format msgid "one to many" -msgstr "" +msgstr "um para muitos" -#: index.docbook:74 -msgid "A <emphasis>unidirectional one-to-many association on a foreign key</emphasis> is a very unusual case, and is not really recommended." +#. Tag: para +#: association_mapping.xml:74 +#, no-c-format +msgid "" +"A <emphasis>unidirectional one-to-many association on a foreign key</" +"emphasis> is a very unusual case, and is not really recommended." msgstr "" +"Uma <emphasis>associação unidirecional um-para-muitos em uma chave " +"estrangeira</emphasis> é um caso muito incomum, e realmente não é " +"recomendada." -#: index.docbook:79 +#. Tag: programlisting +#: association_mapping.xml:79 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <set name=\"addresses\">\n" - " <key column=\"personId\" \n" - " not-null=\"true\"/>\n" - " <one-to-many class=\"Address\"/>\n" - " </set>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <set name=\"addresses\">\n" +" <key column=\"personId\" \n" +" not-null=\"true\"/>\n" +" <one-to-many class=\"Address\"/>\n" +" </set>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +"</class>]]>" msgstr "" -#: index.docbook:80 +#. Tag: programlisting +#: association_mapping.xml:80 +#, no-c-format msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key )\n" - "create table Address ( addressId bigint not null primary key, personId bigint not null )\n" - " ]]>" +"<![CDATA[\n" +"create table Person ( personId bigint not null primary key )\n" +"create table Address ( addressId bigint not null primary key, personId " +"bigint not null )\n" +" ]]>" msgstr "" -#: index.docbook:82 +#. Tag: para +#: association_mapping.xml:82 +#, no-c-format msgid "We think it's better to use a join table for this kind of association." msgstr "" +"Nós achamos que é melhor usar uma tabela associativa para este tipo de " +"associação." -#: index.docbook:91 +#. Tag: title +#: association_mapping.xml:91 +#, no-c-format msgid "Unidirectional associations with join tables" -msgstr "" +msgstr "Associações Unidirecionais com tabelas associativas" -#: index.docbook:96 -msgid "A <emphasis>unidirectional one-to-many association on a join table</emphasis> is much preferred. Notice that by specifying <literal>unique=\"true\"</literal>, we have changed the multiplicity from many-to-many to one-to-many." +#. Tag: para +#: association_mapping.xml:96 +#, no-c-format +msgid "" +"A <emphasis>unidirectional one-to-many association on a join table</" +"emphasis> is much preferred. Notice that by specifying <literal>unique=\"true" +"\"</literal>, we have changed the multiplicity from many-to-many to one-to-" +"many." msgstr "" +"Uma <emphasis>associação um-para-muitos unidirecional usando uma tabela " +"associativa</emphasis> e o mais comum. Note que se especificarmos " +"<literal>unique=\"true\"</literal>, estaremos modificando a cardinalidade de " +"muitos-para-muitos para um-para-muitos." -#: index.docbook:102 +#. Tag: programlisting +#: association_mapping.xml:102 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <set name=\"addresses\" table=\"PersonAddress\">\n" - " <key column=\"personId\"/>\n" - " <many-to-many column=\"addressId\"\n" - " unique=\"true\"\n" - " class=\"Address\"/>\n" - " </set>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <set name=\"addresses\" table=\"PersonAddress\">\n" +" <key column=\"personId\"/>\n" +" <many-to-many column=\"addressId\"\n" +" unique=\"true\"\n" +" class=\"Address\"/>\n" +" </set>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +"</class>]]>" msgstr "" -#: index.docbook:103 +#. Tag: programlisting +#: association_mapping.xml:103 +#, no-c-format msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key )\n" - "create table PersonAddress ( personId not null, addressId bigint not null primary key )\n" - "create table Address ( addressId bigint not null primary key )\n" - " ]]>" +"<![CDATA[\n" +"create table Person ( personId bigint not null primary key )\n" +"create table PersonAddress ( personId not null, addressId bigint not null " +"primary key )\n" +"create table Address ( addressId bigint not null primary key )\n" +" ]]>" msgstr "" -#: index.docbook:110 -msgid "A <emphasis>unidirectional many-to-one association on a join table</emphasis> is quite common when the association is optional." +#. Tag: para +#: association_mapping.xml:110 +#, no-c-format +msgid "" +"A <emphasis>unidirectional many-to-one association on a join table</" +"emphasis> is quite common when the association is optional." msgstr "" +"Uma <emphasis>associação unidirecional muitos-para-um em uma tabela " +"associativa</emphasis> é bastante comum quando a associação for opcional." -#: index.docbook:115 +#. Tag: programlisting +#: association_mapping.xml:115 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <join table=\"PersonAddress\" \n" - " optional=\"true\">\n" - " <key column=\"personId\" unique=\"true\"/>\n" - " <many-to-one name=\"address\"\n" - " column=\"addressId\" \n" - " not-null=\"true\"/>\n" - " </join>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <join table=\"PersonAddress\" \n" +" optional=\"true\">\n" +" <key column=\"personId\" unique=\"true\"/>\n" +" <many-to-one name=\"address\"\n" +" column=\"addressId\" \n" +" not-null=\"true\"/>\n" +" </join>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +"</class>]]>" msgstr "" -#: index.docbook:116 +#. Tag: programlisting +#: association_mapping.xml:116 +#, no-c-format msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key )\n" - "create table PersonAddress ( personId bigint not null primary key, addressId bigint not null )\n" - "create table Address ( addressId bigint not null primary key )\n" - " ]]>" +"<![CDATA[\n" +"create table Person ( personId bigint not null primary key )\n" +"create table PersonAddress ( personId bigint not null primary key, addressId " +"bigint not null )\n" +"create table Address ( addressId bigint not null primary key )\n" +" ]]>" msgstr "" -#: index.docbook:123 -msgid "A <emphasis>unidirectional one-to-one association on a join table</emphasis> is extremely unusual, but possible." +#. Tag: para +#: association_mapping.xml:123 +#, no-c-format +msgid "" +"A <emphasis>unidirectional one-to-one association on a join table</emphasis> " +"is extremely unusual, but possible." msgstr "" +"Uma <emphasis>associação unidirecional um-para-um em uma tabela associativa</" +"emphasis> é extremamente incomum, mas possível." -#: index.docbook:128 +#. Tag: programlisting +#: association_mapping.xml:128 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <join table=\"PersonAddress\" \n" - " optional=\"true\">\n" - " <key column=\"personId\" \n" - " unique=\"true\"/>\n" - " <many-to-one name=\"address\"\n" - " column=\"addressId\" \n" - " not-null=\"true\"\n" - " unique=\"true\"/>\n" - " </join>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <join table=\"PersonAddress\" \n" +" optional=\"true\">\n" +" <key column=\"personId\" \n" +" unique=\"true\"/>\n" +" <many-to-one name=\"address\"\n" +" column=\"addressId\" \n" +" not-null=\"true\"\n" +" unique=\"true\"/>\n" +" </join>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +"</class>]]>" msgstr "" -#: index.docbook:129, index.docbook:233 +#. Tag: programlisting +#: association_mapping.xml:129 association_mapping.xml:233 +#, no-c-format msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key )\n" - "create table PersonAddress ( personId bigint not null primary key, addressId bigint not null unique )\n" - "create table Address ( addressId bigint not null primary key )\n" - " ]]>" +"<![CDATA[\n" +"create table Person ( personId bigint not null primary key )\n" +"create table PersonAddress ( personId bigint not null primary key, addressId " +"bigint not null unique )\n" +"create table Address ( addressId bigint not null primary key )\n" +" ]]>" msgstr "" -#: index.docbook:134, index.docbook:238 +#. Tag: title +#: association_mapping.xml:134 association_mapping.xml:238 +#, no-c-format msgid "many to many" -msgstr "" +msgstr "muitos para muitos" -#: index.docbook:136 -msgid "Finally, we have a <emphasis>unidirectional many-to-many association</emphasis>." +#. Tag: para +#: association_mapping.xml:136 +#, no-c-format +msgid "" +"Finally, we have a <emphasis>unidirectional many-to-many association</" +"emphasis>." msgstr "" +"Finalmente, nós temos a <emphasis>associação unidirecional muitos-para- " +"muitos</emphasis>." -#: index.docbook:140 +#. Tag: programlisting +#: association_mapping.xml:140 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <set name=\"addresses\" table=\"PersonAddress\">\n" - " <key column=\"personId\"/>\n" - " <many-to-many column=\"addressId\"\n" - " class=\"Address\"/>\n" - " </set>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <set name=\"addresses\" table=\"PersonAddress\">\n" +" <key column=\"personId\"/>\n" +" <many-to-many column=\"addressId\"\n" +" class=\"Address\"/>\n" +" </set>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +"</class>]]>" msgstr "" -#: index.docbook:141, index.docbook:246 +#. Tag: programlisting +#: association_mapping.xml:141 association_mapping.xml:246 +#, no-c-format msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key )\n" - "create table PersonAddress ( personId bigint not null, addressId bigint not null, primary key (personId, addressId) )\n" - "create table Address ( addressId bigint not null primary key )\n" - " ]]>" +"<![CDATA[\n" +"create table Person ( personId bigint not null primary key )\n" +"create table PersonAddress ( personId bigint not null, addressId bigint not " +"null, primary key (personId, addressId) )\n" +"create table Address ( addressId bigint not null primary key )\n" +" ]]>" msgstr "" -#: index.docbook:148 +#. Tag: title +#: association_mapping.xml:148 +#, no-c-format msgid "Bidirectional associations" -msgstr "" +msgstr "Associações Bidirecionais" -#: index.docbook:151, index.docbook:211 +#. Tag: title +#: association_mapping.xml:151 association_mapping.xml:211 +#, no-c-format msgid "one to many / many to one" -msgstr "" +msgstr "um para muitos / muitos para um" -#: index.docbook:153 -msgid "A <emphasis>bidirectional many-to-one association</emphasis> is the most common kind of association. (This is the standard parent/child relationship.)" +#. Tag: para +#: association_mapping.xml:153 +#, no-c-format +msgid "" +"A <emphasis>bidirectional many-to-one association</emphasis> is the most " +"common kind of association. (This is the standard parent/child relationship.)" msgstr "" +"Uma <emphasis>associação bidirecional muitos-para-um</emphasis> é o tipo " +"mais comum de associação. (Esse é o relacionamento padrão pai / filho. )" -#: index.docbook:159 +#. Tag: programlisting +#: association_mapping.xml:159 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <many-to-one name=\"address\" \n" - " column=\"addressId\"\n" - " not-null=\"true\"/>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <set name=\"people\" inverse=\"true\">\n" - " <key column=\"addressId\"/>\n" - " <one-to-many class=\"Person\"/>\n" - " </set>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <many-to-one name=\"address\" \n" +" column=\"addressId\"\n" +" not-null=\"true\"/>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <set name=\"people\" inverse=\"true\">\n" +" <key column=\"addressId\"/>\n" +" <one-to-many class=\"Person\"/>\n" +" </set>\n" +"</class>]]>" msgstr "" -#: index.docbook:163 -msgid "If you use a <literal>List</literal> (or other indexed collection) you need to set the <literal>key</literal> column of the foreign key to <literal>not null</literal>, and let Hibernate manage the association from the collections side to maintain the index of each element (making the other side virtually inverse by setting <literal>update=\"false\"</literal> and <literal>insert=\"false\"</literal>):" +#. Tag: para +#: association_mapping.xml:163 +#, no-c-format +msgid "" +"If you use a <literal>List</literal> (or other indexed collection) you need " +"to set the <literal>key</literal> column of the foreign key to <literal>not " +"null</literal>, and let Hibernate manage the association from the " +"collections side to maintain the index of each element (making the other " +"side virtually inverse by setting <literal>update=\"false\"</literal> and " +"<literal>insert=\"false\"</literal>):" msgstr "" +"Se você usar uma <literal>List</literal> ( ou outra coleção indexada ), você " +"precisa especificar a coluna <literal>chave</literal> estrangeira como not " +"null, e deixar o Hibernate administrar a associação do lado da coleção para " +"que seja mantido o índice de cada elemento da coleção (fazendo com que o " +"outro lado seja virtualmente inverso setando <literal>update=\"false\"</" +"literal> e <literal>insert=\"false\"</literal>):" -#: index.docbook:171 +#. Tag: programlisting +#: association_mapping.xml:171 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\"/>\n" - " ...\n" - " <many-to-one name=\"address\"\n" - " column=\"addressId\"\n" - " not-null=\"true\"\n" - " insert=\"false\"\n" - " update=\"false\"/>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\"/>\n" - " ...\n" - " <list name=\"people\">\n" - " <key column=\"addressId\" not-null=\"true\"/>\n" - " <list-index column=\"peopleIdx\"/>\n" - " <one-to-many class=\"Person\"/>\n" - " </list>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\"/>\n" +" ...\n" +" <many-to-one name=\"address\"\n" +" column=\"addressId\"\n" +" not-null=\"true\"\n" +" insert=\"false\"\n" +" update=\"false\"/>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\"/>\n" +" ...\n" +" <list name=\"people\">\n" +" <key column=\"addressId\" not-null=\"true\"/>\n" +" <list-index column=\"peopleIdx\"/>\n" +" <one-to-many class=\"Person\"/>\n" +" </list>\n" +"</class>]]>" msgstr "" -#: index.docbook:173 -msgid "It is important that you define <literal>not-null=\"true\"</literal> on the <literal><key></literal> element of the collection mapping if the underlying foreign key column is <literal>NOT NULL</literal>. Don't only declare <literal>not-null=\"true\"</literal> on a possible nested <literal><column></literal> element, but on the <literal><key></literal> element." +#. Tag: para +#: association_mapping.xml:173 +#, no-c-format +msgid "" +"It is important that you define <literal>not-null=\"true\"</literal> on the " +"<literal><key></literal> element of the collection mapping if the " +"underlying foreign key column is <literal>NOT NULL</literal>. Don't only " +"declare <literal>not-null=\"true\"</literal> on a possible nested " +"<literal><column></literal> element, but on the <literal><key></" +"literal> element." msgstr "" +"É importante que você defina <literal>not-null=\"true\"</literal> no " +"elemento <literal><key></literal> no mapeamento na coleção se a coluna " +"de chave estrangeira for <literal>NOT NULL</literal>. Não declare como " +"<literal>not-null=\"true\"</literal> apenas um elemento aninhado " +"<literal><column></literal>, mas sim o elemento <literal><key></" +"literal>." -#: index.docbook:187 -msgid "A <emphasis>bidirectional one-to-one association on a foreign key</emphasis> is quite common." +#. Tag: para +#: association_mapping.xml:187 +#, no-c-format +msgid "" +"A <emphasis>bidirectional one-to-one association on a foreign key</emphasis> " +"is quite common." msgstr "" +"Uma <emphasis>associação bidirecional um para um em uma chave estrangeira</" +"emphasis> é bastante comum." -#: index.docbook:192 +#. Tag: programlisting +#: association_mapping.xml:192 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <many-to-one name=\"address\" \n" - " column=\"addressId\" \n" - " unique=\"true\"\n" - " not-null=\"true\"/>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <one-to-one name=\"person\" \n" - " property-ref=\"address\"/>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <many-to-one name=\"address\" \n" +" column=\"addressId\" \n" +" unique=\"true\"\n" +" not-null=\"true\"/>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <one-to-one name=\"person\" \n" +" property-ref=\"address\"/>\n" +"</class>]]>" msgstr "" -#: index.docbook:195 -msgid "A <emphasis>bidirectional one-to-one association on a primary key</emphasis> uses the special id generator." +#. Tag: para +#: association_mapping.xml:195 +#, no-c-format +msgid "" +"A <emphasis>bidirectional one-to-one association on a primary key</emphasis> " +"uses the special id generator." msgstr "" +"Uma <emphasis>associação bidirecional um para um em uma chave primária</" +"emphasis> usa um gerador de id especial." -#: index.docbook:200 +#. Tag: programlisting +#: association_mapping.xml:200 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <one-to-one name=\"address\"/>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"foreign\">\n" - " <param name=\"property\">person</param>\n" - " </generator>\n" - " </id>\n" - " <one-to-one name=\"person\" \n" - " constrained=\"true\"/>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <one-to-one name=\"address\"/>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"foreign\">\n" +" <param name=\"property\">person</param>\n" +" </generator>\n" +" </id>\n" +" <one-to-one name=\"person\" \n" +" constrained=\"true\"/>\n" +"</class>]]>" msgstr "" -#: index.docbook:208 +#. Tag: title +#: association_mapping.xml:208 +#, no-c-format msgid "Bidirectional associations with join tables" -msgstr "" +msgstr "Associações Bidirecionais com tabelas associativas" -#: index.docbook:213 -msgid "A <emphasis>bidirectional one-to-many association on a join table</emphasis>. Note that the <literal>inverse=\"true\"</literal> can go on either end of the association, on the collection, or on the join." +#. Tag: para +#: association_mapping.xml:213 +#, no-c-format +msgid "" +"A <emphasis>bidirectional one-to-many association on a join table</" +"emphasis>. Note that the <literal>inverse=\"true\"</literal> can go on " +"either end of the association, on the collection, or on the join." msgstr "" +"Uma <emphasis>associação bidirecional um para muitos em uma tabela " +"associativa</emphasis>. Veja que <literal>inverse=\"true\"</literal> pode " +"ser colocado em qualquer ponta associação, na coleção, ou no join." -#: index.docbook:219 +#. Tag: programlisting +#: association_mapping.xml:219 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <set name=\"addresses\" \n" - " table=\"PersonAddress\">\n" - " <key column=\"personId\"/>\n" - " <many-to-many column=\"addressId\"\n" - " unique=\"true\"\n" - " class=\"Address\"/>\n" - " </set>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <join table=\"PersonAddress\" \n" - " inverse=\"true\" \n" - " optional=\"true\">\n" - " <key column=\"addressId\"/>\n" - " <many-to-one name=\"person\"\n" - " column=\"personId\"\n" - " not-null=\"true\"/>\n" - " </join>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <set name=\"addresses\" \n" +" table=\"PersonAddress\">\n" +" <key column=\"personId\"/>\n" +" <many-to-many column=\"addressId\"\n" +" unique=\"true\"\n" +" class=\"Address\"/>\n" +" </set>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <join table=\"PersonAddress\" \n" +" inverse=\"true\" \n" +" optional=\"true\">\n" +" <key column=\"addressId\"/>\n" +" <many-to-one name=\"person\"\n" +" column=\"personId\"\n" +" not-null=\"true\"/>\n" +" </join>\n" +"</class>]]>" msgstr "" -#: index.docbook:220 +#. Tag: programlisting +#: association_mapping.xml:220 +#, no-c-format msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key )\n" - "create table PersonAddress ( personId bigint not null, addressId bigint not null primary key )\n" - "create table Address ( addressId bigint not null primary key )\n" - " ]]>" +"<![CDATA[\n" +"create table Person ( personId bigint not null primary key )\n" +"create table PersonAddress ( personId bigint not null, addressId bigint not " +"null primary key )\n" +"create table Address ( addressId bigint not null primary key )\n" +" ]]>" msgstr "" -#: index.docbook:227 -msgid "A <emphasis>bidirectional one-to-one association on a join table</emphasis> is extremely unusual, but possible." +#. Tag: para +#: association_mapping.xml:227 +#, no-c-format +msgid "" +"A <emphasis>bidirectional one-to-one association on a join table</emphasis> " +"is extremely unusual, but possible." msgstr "" +"Uma <emphasis>associação bidirecional um-para-um em uma tabela de " +"associação</emphasis> é algo bastante incomum, mas possivel." -#: index.docbook:232 +#. Tag: programlisting +#: association_mapping.xml:232 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <join table=\"PersonAddress\" \n" - " optional=\"true\">\n" - " <key column=\"personId\" \n" - " unique=\"true\"/>\n" - " <many-to-one name=\"address\"\n" - " column=\"addressId\" \n" - " not-null=\"true\"\n" - " unique=\"true\"/>\n" - " </join>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <join table=\"PersonAddress\" \n" - " optional=\"true\"\n" - " inverse=\"true\">\n" - " <key column=\"addressId\" \n" - " unique=\"true\"/>\n" - " <many-to-one name=\"person\"\n" - " column=\"personId\" \n" - " not-null=\"true\"\n" - " unique=\"true\"/>\n" - " </join>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <join table=\"PersonAddress\" \n" +" optional=\"true\">\n" +" <key column=\"personId\" \n" +" unique=\"true\"/>\n" +" <many-to-one name=\"address\"\n" +" column=\"addressId\" \n" +" not-null=\"true\"\n" +" unique=\"true\"/>\n" +" </join>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <join table=\"PersonAddress\" \n" +" optional=\"true\"\n" +" inverse=\"true\">\n" +" <key column=\"addressId\" \n" +" unique=\"true\"/>\n" +" <many-to-one name=\"person\"\n" +" column=\"personId\" \n" +" not-null=\"true\"\n" +" unique=\"true\"/>\n" +" </join>\n" +"</class>]]>" msgstr "" -#: index.docbook:240 -msgid "Finally, we have a <emphasis>bidirectional many-to-many association</emphasis>." +#. Tag: para +#: association_mapping.xml:240 +#, no-c-format +msgid "" +"Finally, we have a <emphasis>bidirectional many-to-many association</" +"emphasis>." msgstr "" +"Finally, we have a <emphasis>bidirectional many-to-many association</" +"emphasis>. Finalmente, nós temos uma associação bidirecional de muitos para " +"muitos." -#: index.docbook:244 +#. Tag: programlisting +#: association_mapping.xml:244 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <set name=\"addresses\" table=\"PersonAddress\">\n" - " <key column=\"personId\"/>\n" - " <many-to-many column=\"addressId\"\n" - " class=\"Address\"/>\n" - " </set>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <set name=\"people\" inverse=\"true\" table=\"PersonAddress\">\n" - " <key column=\"addressId\"/>\n" - " <many-to-many column=\"personId\"\n" - " class=\"Person\"/>\n" - " </set>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <set name=\"addresses\" table=\"PersonAddress\">\n" +" <key column=\"personId\"/>\n" +" <many-to-many column=\"addressId\"\n" +" class=\"Address\"/>\n" +" </set>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <set name=\"people\" inverse=\"true\" table=\"PersonAddress\">\n" +" <key column=\"addressId\"/>\n" +" <many-to-many column=\"personId\"\n" +" class=\"Person\"/>\n" +" </set>\n" +"</class>]]>" msgstr "" -#: index.docbook:253 +#. Tag: title +#: association_mapping.xml:253 +#, no-c-format msgid "More complex association mappings" -msgstr "" +msgstr "Mapeamento de associações mais complexas" -#: index.docbook:255 -msgid "More complex association joins are <emphasis>extremely</emphasis> rare. Hibernate makes it possible to handle more complex situations using SQL fragments embedded in the mapping document. For example, if a table with historical account information data defines <literal>accountNumber</literal>, <literal>effectiveEndDate</literal> and <literal>effectiveStartDate</literal>columns, mapped as follows:" +#. Tag: para +#: association_mapping.xml:255 +#, no-c-format +msgid "" +"More complex association joins are <emphasis>extremely</emphasis> rare. " +"Hibernate makes it possible to handle more complex situations using SQL " +"fragments embedded in the mapping document. For example, if a table with " +"historical account information data defines <literal>accountNumber</" +"literal>, <literal>effectiveEndDate</literal> and " +"<literal>effectiveStartDate</literal>columns, mapped as follows:" msgstr "" +"More complex association joins are <emphasis>extremely</emphasis> rare. " +"Hibernate makes it possible to handle more complex situations using SQL " +"fragments embedded in the mapping document. For example, if a table with " +"historical account information data defines <literal>accountNumber</" +"literal>, <literal>effectiveEndDate</literal> and " +"<literal>effectiveStartDate</literal>columns, mapped as follows: Joins de " +"associações mais complexas são extremamente raros. O Hibernate torna " +"possível tratar mapeamentos mais complexos usando fragmentos de SQL " +"embutidos no documento de mapeamento. Por exemplo, se uma tabela com " +"informações de dados históricos de uma conta define a coluna accountNumber, " +"effectiveEndDate e effectiveStartDate, mapeadas assim como segue:" -#: index.docbook:264 +#. Tag: programlisting +#: association_mapping.xml:264 +#, no-c-format msgid "" - "<![CDATA[<properties name=\"currentAccountKey\">\n" - " <property name=\"accountNumber\" type=\"string\" not-null=\"true\"/>\n" - " <property name=\"currentAccount\" type=\"boolean\">\n" - " <formula>case when effectiveEndDate is null then 1 else 0 end</formula>\n" - " </property>\n" - "</properties>\n" - "<property name=\"effectiveEndDate\" type=\"date\"/>\n" - "<property name=\"effectiveStateDate\" type=\"date\" not-null=\"true\"/>]]>" +"<![CDATA[<properties name=\"currentAccountKey\">\n" +" <property name=\"accountNumber\" type=\"string\" not-null=\"true\"/>\n" +" <property name=\"currentAccount\" type=\"boolean\">\n" +" <formula>case when effectiveEndDate is null then 1 else 0 end</" +"formula>\n" +" </property>\n" +"</properties>\n" +"<property name=\"effectiveEndDate\" type=\"date\"/>\n" +"<property name=\"effectiveStateDate\" type=\"date\" not-null=\"true\"/>]]>" msgstr "" -#: index.docbook:266 -msgid "Then we can map an association to the <emphasis>current</emphasis> instance (the one with null <literal>effectiveEndDate</literal>) using:" +#. Tag: para +#: association_mapping.xml:266 +#, no-c-format +msgid "" +"Then we can map an association to the <emphasis>current</emphasis> instance " +"(the one with null <literal>effectiveEndDate</literal>) using:" msgstr "" +"Then we can map an association to the <emphasis>current</emphasis> instance " +"(the one with null <literal>effectiveEndDate</literal>) using: Então nós " +"podemos mapear uma associação para a instância corrente (aquela com a " +"effectiveEndDate igual a null) usando:" -#: index.docbook:271 +#. Tag: programlisting +#: association_mapping.xml:271 +#, no-c-format msgid "" - "<![CDATA[<many-to-one name=\"currentAccountInfo\" \n" - " property-ref=\"currentAccountKey\"\n" - " class=\"AccountInfo\">\n" - " <column name=\"accountNumber\"/>\n" - " <formula>'1'</formula>\n" - "</many-to-one>]]>" +"<![CDATA[<many-to-one name=\"currentAccountInfo\" \n" +" property-ref=\"currentAccountKey\"\n" +" class=\"AccountInfo\">\n" +" <column name=\"accountNumber\"/>\n" +" <formula>'1'</formula>\n" +"</many-to-one>]]>" msgstr "" -#: index.docbook:273 -msgid "In a more complex example, imagine that the association between <literal>Employee</literal> and <literal>Organization</literal> is maintained in an <literal>Employment</literal> table full of historical employment data. Then an association to the employee's <emphasis>most recent</emphasis> employer (the one with the most recent <literal>startDate</literal>) might be mapped this way:" +#. Tag: para +#: association_mapping.xml:273 +#, no-c-format +msgid "" +"In a more complex example, imagine that the association between " +"<literal>Employee</literal> and <literal>Organization</literal> is " +"maintained in an <literal>Employment</literal> table full of historical " +"employment data. Then an association to the employee's <emphasis>most " +"recent</emphasis> employer (the one with the most recent <literal>startDate</" +"literal>) might be mapped this way:" msgstr "" +"In a more complex example, imagine that the association between " +"<literal>Employee</literal> and <literal>Organization</literal> is " +"maintained in an <literal>Employment</literal> table full of historical " +"employment data. Then an association to the employee's <emphasis>most " +"recent</emphasis> employer (the one with the most recent <literal>startDate</" +"literal>) might be mapped this way: Em um exemplo mais complexo, imagine que " +"a associação entre Employee e Organization é mantida em uma tabela " +"Employment cheia de dados históricos do trabalho. Então a associação do " +"funcionário mais recentemente empregado (aquele com a mais recente " +"startDate) deve ser mapeado desta maneira:" -#: index.docbook:281 +#. Tag: programlisting +#: association_mapping.xml:281 +#, no-c-format msgid "" - "<![CDATA[<join>\n" - " <key column=\"employeeId\"/>\n" - " <subselect>\n" - " select employeeId, orgId \n" - " from Employments \n" - " group by orgId \n" - " having startDate = max(startDate)\n" - " </subselect>\n" - " <many-to-one name=\"mostRecentEmployer\" \n" - " class=\"Organization\" \n" - " column=\"orgId\"/>\n" - "</join>]]>" +"<![CDATA[<join>\n" +" <key column=\"employeeId\"/>\n" +" <subselect>\n" +" select employeeId, orgId \n" +" from Employments \n" +" group by orgId \n" +" having startDate = max(startDate)\n" +" </subselect>\n" +" <many-to-one name=\"mostRecentEmployer\" \n" +" class=\"Organization\" \n" +" column=\"orgId\"/>\n" +"</join>]]>" msgstr "" -#: index.docbook:283 -msgid "You can get quite creative with this functionality, but it is usually more practical to handle these kinds of cases using HQL or a criteria query." +#. Tag: para +#: association_mapping.xml:283 +#, no-c-format +msgid "" +"You can get quite creative with this functionality, but it is usually more " +"practical to handle these kinds of cases using HQL or a criteria query." msgstr "" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "" - +"You can get quite creative with this functionality, but it is usually more " +"practical to handle these kinds of cases using HQL or a criteria query. Você " +"pode ser criativo com esta funcionalidade, mas geralmente é mais prático " +"tratar estes tipos de casos, usando uma pesquisa HQL ou uma pesquisa por " +"criteria." Modified: core/trunk/documentation/manual/translations/pt-BR/content/basic_mapping.po =================================================================== --- core/trunk/documentation/manual/translations/pt-BR/content/basic_mapping.po 2007-10-25 22:34:46 UTC (rev 14134) +++ core/trunk/documentation/manual/translations/pt-BR/content/basic_mapping.po 2007-10-26 00:46:38 UTC (rev 14135) @@ -1,2459 +1,5778 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: basic_mapping.xml:5 +#, no-c-format msgid "Basic O/R Mapping" -msgstr "" +msgstr "Mapeamento O/R Bassico" -#: index.docbook:8 +#. Tag: title +#: basic_mapping.xml:8 +#, no-c-format msgid "Mapping declaration" -msgstr "" +msgstr "Declaração de mapeamento" -#: index.docbook:10 -msgid "Object/relational mappings are usually defined in an XML document. The mapping document is designed to be readable and hand-editable. The mapping language is Java-centric, meaning that mappings are constructed around persistent class declarations, not table declarations." +#. Tag: para +#: basic_mapping.xml:10 +#, no-c-format +msgid "" +"Object/relational mappings are usually defined in an XML document. The " +"mapping document is designed to be readable and hand-editable. The mapping " +"language is Java-centric, meaning that mappings are constructed around " +"persistent class declarations, not table declarations." msgstr "" +"Object/relational mappings are usually defined in an XML document. The " +"mapping document is designed to be readable and hand-editable. The mapping " +"language is Java-centric, meaning that mappings are constructed around " +"persistent class declarations, not table declarations." -#: index.docbook:17 -msgid "Note that, even though many Hibernate users choose to write the XML by hand, a number of tools exist to generate the mapping document, including XDoclet, Middlegen and AndroMDA." +#. Tag: para +#: basic_mapping.xml:17 +#, no-c-format +msgid "" +"Note that, even though many Hibernate users choose to write the XML by hand, " +"a number of tools exist to generate the mapping document, including XDoclet, " +"Middlegen and AndroMDA." msgstr "" +"Note that, even though many Hibernate users choose to write the XML by hand, " +"a number of tools exist to generate the mapping document, including XDoclet, " +"Middlegen and AndroMDA." -#: index.docbook:23 +#. Tag: para +#: basic_mapping.xml:23 +#, no-c-format msgid "Lets kick off with an example mapping:" -msgstr "" +msgstr "Lets kick off with an example mapping:" -#: index.docbook:27 +#. Tag: programlisting +#: basic_mapping.xml:27 +#, no-c-format msgid "" - "<![CDATA[<?xml version=\"1.0\"?>\n" - "<!DOCTYPE hibernate-mapping PUBLIC\n" - " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" - " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" - "\n" - "<hibernate-mapping package=\"eg\">\n" - "\n" - " <class name=\"Cat\"\n" - " table=\"cats\"\n" - " discriminator-value=\"C\">\n" - "\n" - " <id name=\"id\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "\n" - " <discriminator column=\"subclass\"\n" - " type=\"character\"/>\n" - "\n" - " <property name=\"weight\"/>\n" - "\n" - " <property name=\"birthdate\"\n" - " type=\"date\"\n" - " not-null=\"true\"\n" - " update=\"false\"/>\n" - "\n" - " <property name=\"color\"\n" - " type=\"eg.types.ColorUserType\"\n" - " not-null=\"true\"\n" - " update=\"false\"/>\n" - "\n" - " <property name=\"sex\"\n" - " not-null=\"true\"\n" - " update=\"false\"/>\n" - "\n" - " <property name=\"litterId\"\n" - " column=\"litterId\"\n" - " update=\"false\"/>\n" - "\n" - " <many-to-one name=\"mother\"\n" - " column=\"mother_id\"\n" - " update=\"false\"/>\n" - "\n" - " <set name=\"kittens\"\n" - " inverse=\"true\"\n" - " order-by=\"litter_id\">\n" - " <key column=\"mother_id\"/>\n" - " <one-to-many class=\"Cat\"/>\n" - " </set>\n" - "\n" - " <subclass name=\"DomesticCat\"\n" - " discriminator-value=\"D\">\n" - "\n" - " <property name=\"name\"\n" - " type=\"string\"/>\n" - "\n" - " </subclass>\n" - "\n" - " </class>\n" - "\n" - " <class name=\"Dog\">\n" - " \n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<?xml version=\"1.0\"?>\n" +"<!DOCTYPE hibernate-mapping PUBLIC\n" +" \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" +" \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" +"\n" +"<hibernate-mapping package=\"eg\">\n" +"\n" +" <class name=\"Cat\"\n" +" table=\"cats\"\n" +" discriminator-value=\"C\">\n" +"\n" +" <id name=\"id\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +"\n" +" <discriminator column=\"subclass\"\n" +" type=\"character\"/>\n" +"\n" +" <property name=\"weight\"/>\n" +"\n" +" <property name=\"birthdate\"\n" +" type=\"date\"\n" +" not-null=\"true\"\n" +" update=\"false\"/>\n" +"\n" +" <property name=\"color\"\n" +" type=\"eg.types.ColorUserType\"\n" +" not-null=\"true\"\n" +" update=\"false\"/>\n" +"\n" +" <property name=\"sex\"\n" +" not-null=\"true\"\n" +" update=\"false\"/>\n" +"\n" +" <property name=\"litterId\"\n" +" column=\"litterId\"\n" +" update=\"false\"/>\n" +"\n" +" <many-to-one name=\"mother\"\n" +" column=\"mother_id\"\n" +" update=\"false\"/>\n" +"\n" +" <set name=\"kittens\"\n" +" inverse=\"true\"\n" +" order-by=\"litter_id\">\n" +" <key column=\"mother_id\"/>\n" +" <one-to-many class=\"Cat\"/>\n" +" </set>\n" +"\n" +" <subclass name=\"DomesticCat\"\n" +" discriminator-value=\"D\">\n" +"\n" +" <property name=\"name\"\n" +" type=\"string\"/>\n" +"\n" +" </subclass>\n" +"\n" +" </class>\n" +"\n" +" <class name=\"Dog\">\n" +" \n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" -#: index.docbook:29 -msgid "We will now discuss the content of the mapping document. We will only describe the document elements and attributes that are used by Hibernate at runtime. The mapping document also contains some extra optional attributes and elements that affect the database schemas exported by the schema export tool. (For example the <literal> not-null</literal> attribute.)" +#. Tag: para +#: basic_mapping.xml:29 +#, no-c-format +msgid "" +"We will now discuss the content of the mapping document. We will only " +"describe the document elements and attributes that are used by Hibernate at " +"runtime. The mapping document also contains some extra optional attributes " +"and elements that affect the database schemas exported by the schema export " +"tool. (For example the <literal> not-null</literal> attribute.)" msgstr "" +"Discutir agora o conteúdo deste documento de mapeamento. Iremos apenas " +"descrever os elementos do documento e atributos que são utilizados pelo " +"Hibernate em tempo de execução. O documento de mapeamento também contém " +"alguns atributos adicionais e opcionais além de elementos que afetam os " +"esquemas de banco de dados exportados pela ferramenta de exportação de " +"esquemas. (Por exemplo, o atributo <literal>not-null</literal>)." -#: index.docbook:40 +#. Tag: title +#: basic_mapping.xml:40 +#, no-c-format msgid "Doctype" -msgstr "" +msgstr "Doctype" -#: index.docbook:42 -msgid "All XML mappings should declare the doctype shown. The actual DTD may be found at the URL above, in the directory <literal>hibernate-x.x.x/src/org/hibernate </literal> or in <literal>hibernate3.jar</literal>. Hibernate will always look for the DTD in its classpath first. If you experience lookups of the DTD using an Internet connection, check your DTD declaration against the contents of your claspath." +#. Tag: para +#: basic_mapping.xml:42 +#, no-c-format +msgid "" +"All XML mappings should declare the doctype shown. The actual DTD may be " +"found at the URL above, in the directory <literal>hibernate-x.x.x/src/org/" +"hibernate </literal> or in <literal>hibernate3.jar</literal>. Hibernate will " +"always look for the DTD in its classpath first. If you experience lookups of " +"the DTD using an Internet connection, check your DTD declaration against the " +"contents of your claspath." msgstr "" +"Todos os mapeamentos de XML devem declarar o doctype exibido. O DTD atual " +"pode ser encontrado na URL abaixo, no diretório <literal>hibernate-x.x.x/src/" +"org/ hibernate </literal> ou no <literal>hibernate3.jar</literal>. O " +"Hibernate sempre irá procurar pelo DTD inicialmente no seu classpath. Se " +"você tentar localizar o DTD usando uma conexão de internet, compare a " +"declaração do seu DTD com o conteúdo do seu classpath" -#: index.docbook:52 +#. Tag: title +#: basic_mapping.xml:52 +#, no-c-format msgid "EntityResolver" -msgstr "" +msgstr "EntityResolver" -#: index.docbook:53 -msgid "As mentioned previously, Hibernate will first attempt to resolve DTDs in its classpath. The manner in which it does this is by registering a custom <literal>org.xml.sax.EntityResolver</literal> implementation with the SAXReader it uses to read in the xml files. This custom <literal>EntityResolver</literal> recognizes two different systemId namespaces." +#. Tag: para +#: basic_mapping.xml:53 +#, no-c-format +msgid "" +"As mentioned previously, Hibernate will first attempt to resolve DTDs in its " +"classpath. The manner in which it does this is by registering a custom " +"<literal>org.xml.sax.EntityResolver</literal> implementation with the " +"SAXReader it uses to read in the xml files. This custom " +"<literal>EntityResolver</literal> recognizes two different systemId " +"namespaces." msgstr "" +"As mentioned previously, Hibernate will first attempt to resolve DTDs in its " +"classpath. The manner in which it does this is by registering a custom " +"<literal>org.xml.sax.EntityResolver</literal> implementation with the " +"SAXReader it uses to read in the xml files. This custom " +"<literal>EntityResolver</literal> recognizes two different systemId " +"namespaces." -#: index.docbook:61 -msgid "a <literal>hibernate namespace</literal> is recognized whenever the resolver encounteres a systemId starting with <literal>http://hibernate.sourceforge.net/</literal>; the resolver attempts to resolve these entities via the classlaoder which loaded the Hibernate classes." +#. Tag: para +#: basic_mapping.xml:61 +#, no-c-format +msgid "" +"a <literal>hibernate namespace</literal> is recognized whenever the resolver " +"encounteres a systemId starting with <literal>http://hibernate.sourceforge." +"net/</literal>; the resolver attempts to resolve these entities via the " +"classlaoder which loaded the Hibernate classes." msgstr "" +"a <literal>hibernate namespace</literal> is recognized whenever the resolver " +"encounteres a systemId starting with <literal>http://hibernate.sourceforge." +"net/</literal>; the resolver attempts to resolve these entities via the " +"classlaoder which loaded the Hibernate classes." -#: index.docbook:70 -msgid "a <literal>user namespace</literal> is recognized whenever the resolver encounteres a systemId using a <literal>classpath://</literal> URL protocol; the resolver will attempt to resolve these entities via (1) the current thread context classloader and (2) the classloader which loaded the Hibernate classes." +#. Tag: para +#: basic_mapping.xml:70 +#, no-c-format +msgid "" +"a <literal>user namespace</literal> is recognized whenever the resolver " +"encounteres a systemId using a <literal>classpath://</literal> URL protocol; " +"the resolver will attempt to resolve these entities via (1) the current " +"thread context classloader and (2) the classloader which loaded the " +"Hibernate classes." msgstr "" +"a <literal>user namespace</literal> is recognized whenever the resolver " +"encounteres a systemId using a <literal>classpath://</literal> URL protocol; " +"the resolver will attempt to resolve these entities via (1) the current " +"thread context classloader and (2) the classloader which loaded the " +"Hibernate classes." -#: index.docbook:79 +#. Tag: para +#: basic_mapping.xml:79 +#, no-c-format msgid "An example of utilizing user namespacing:" -msgstr "" +msgstr "An example of utilizing user namespacing:" -#: index.docbook:82 +#. Tag: programlisting +#: basic_mapping.xml:82 +#, no-c-format msgid "" - "<![CDATA[<?xml version=\"1.0\"?>\n" - "<!DOCTYPE hibernate-mapping PUBLIC\n" - " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" - " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\" [\n" - " <!ENTITY types SYSTEM \"classpath://your/domain/types.xml\">\n" - "]>\n" - "\n" - "<hibernate-mapping package=\"your.domain\">\n" - " <class name=\"MyEntity\">\n" - " <id name=\"id\" type=\"my-custom-id-type\">\n" - " ...\n" - " </id>\n" - " <class>\n" - " &types;\n" - "</hibernate-mapping>]]>" +"<![CDATA[<?xml version=\"1.0\"?>\n" +"<!DOCTYPE hibernate-mapping PUBLIC\n" +" \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" +" \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\" [\n" +" <!ENTITY types SYSTEM \"classpath://your/domain/types.xml\">\n" +"]>\n" +"\n" +"<hibernate-mapping package=\"your.domain\">\n" +" <class name=\"MyEntity\">\n" +" <id name=\"id\" type=\"my-custom-id-type\">\n" +" ...\n" +" </id>\n" +" <class>\n" +" &types;\n" +"</hibernate-mapping>]]>" msgstr "" -#: index.docbook:83 -msgid "Where <literal>types.xml</literal> is a resource in the <literal>your.domain</literal> package and contains a custom <xref linkend=\"mapping-types-custom\"/>typedef." +#. Tag: para +#: basic_mapping.xml:83 +#, no-c-format +msgid "" +"Where <literal>types.xml</literal> is a resource in the <literal>your." +"domain</literal> package and contains a custom <link linkend=\"mapping-types-" +"custom\">typedef</link>." msgstr "" +"Where <literal>types.xml</literal> is a resource in the <literal>your." +"domain</literal> package and contains a custom <xref linkend=\"mapping-types-" +"custom\">typedef</xref>." -#: index.docbook:91 +#. Tag: title +#: basic_mapping.xml:91 +#, no-c-format msgid "hibernate-mapping" -msgstr "" +msgstr "hibernate-mapping" -#: index.docbook:93 -msgid "This element has several optional attributes. The <literal>schema</literal> and <literal>catalog</literal> attributes specify that tables referred to in this mapping belong to the named schema and/or catalog. If specified, tablenames will be qualified by the given schema and catalog names. If missing, tablenames will be unqualified. The <literal>default-cascade</literal> attribute specifies what cascade style should be assumed for properties and collections which do not specify a <literal>cascade</literal> attribute. The <literal>auto-import</literal> attribute lets us use unqualified class names in the query language, by default." +#. Tag: para +#: basic_mapping.xml:93 +#, no-c-format +msgid "" +"This element has several optional attributes. The <literal>schema</literal> " +"and <literal>catalog</literal> attributes specify that tables referred to in " +"this mapping belong to the named schema and/or catalog. If specified, " +"tablenames will be qualified by the given schema and catalog names. If " +"missing, tablenames will be unqualified. The <literal>default-cascade</" +"literal> attribute specifies what cascade style should be assumed for " +"properties and collections which do not specify a <literal>cascade</literal> " +"attribute. The <literal>auto-import</literal> attribute lets us use " +"unqualified class names in the query language, by default." msgstr "" +"Este elemento tem diversos atributos opcionais. Os atributos " +"<literal>schema</literal> e <literal>catalog</literal> especificam que " +"tabelas referenciadas neste mapeamento pertencem ao esquema e/ou ao catalogo " +"nomeado. Se especificados, os nomes das tabelas irão ser qualificados no " +"schema ou catalog dado. Se não, os nomes das tabelas não serão qualificados. " +"O atributo <literal>default-cascade </literal> especifica qual estilo de " +"cascata será assumido pelas propriedades e coleções que não especificarm um " +"atributo <literal>cascade</literal>. O atributo <literal>auto-import</" +"literal> nos deixa utilizar nomes de classes não qualificados na linguagem " +"de consulta, por default." -#: index.docbook:114 +#. Tag: programlisting +#: basic_mapping.xml:114 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping\n" - " schema=\"schemaName\"\n" - " catalog=\"catalogName\"\n" - " default-cascade=\"cascade_style\"\n" - " default-access=\"field|property|ClassName\"\n" - " default-lazy=\"true|false\"\n" - " auto-import=\"true|false\"\n" - " package=\"package.name\"\n" - " />]]>" +"<![CDATA[<hibernate-mapping\n" +" schema=\"schemaName\"\n" +" catalog=\"catalogName\"\n" +" default-cascade=\"cascade_style\"\n" +" default-access=\"field|property|ClassName\"\n" +" default-lazy=\"true|false\"\n" +" auto-import=\"true|false\"\n" +" package=\"package.name\"\n" +" />]]>" msgstr "" -#: index.docbook:117 +#. Tag: para +#: basic_mapping.xml:117 +#, no-c-format msgid "<literal>schema</literal> (optional): The name of a database schema." msgstr "" +"<literal>schema</literal> (opcional): O nome do esquema do banco de dados." -#: index.docbook:122 +#. Tag: para +#: basic_mapping.xml:122 +#, no-c-format msgid "<literal>catalog</literal> (optional): The name of a database catalog." msgstr "" +"<literal>catalog</literal> (opcional): O nome do catálogo do banco de dados." -#: index.docbook:127 -msgid "<literal>default-cascade</literal> (optional - defaults to <literal>none</literal>): A default cascade style." +#. Tag: para +#: basic_mapping.xml:127 +#, no-c-format +msgid "" +"<literal>default-cascade</literal> (optional - defaults to <literal>none</" +"literal>): A default cascade style." msgstr "" +"<literal>default-cascade</literal> (opcional – default é <literal>nenhum </" +"literal>): Um estilo cascata default." -#: index.docbook:133 -msgid "<literal>default-access</literal> (optional - defaults to <literal>property</literal>): The strategy Hibernate should use for accessing all properties. Can be a custom implementation of <literal>PropertyAccessor</literal>." +#. Tag: para +#: basic_mapping.xml:133 +#, no-c-format +msgid "" +"<literal>default-access</literal> (optional - defaults to <literal>property</" +"literal>): The strategy Hibernate should use for accessing all properties. " +"Can be a custom implementation of <literal>PropertyAccessor</literal>." msgstr "" +"<literal>default-access</literal> (opcional – default é <literal>property</" +"literal>): A estratégia que o Hibernate deve utilizar para acessar todas as " +"propridades. Pode ser uma implementação própria de " +"<literal>PropertyAccessor</literal>." -#: index.docbook:140 -msgid "<literal>default-lazy</literal> (optional - defaults to <literal>true</literal>): The default value for unspecifed <literal>lazy</literal> attributes of class and collection mappings." +#. Tag: para +#: basic_mapping.xml:140 +#, no-c-format +msgid "" +"<literal>default-lazy</literal> (optional - defaults to <literal>true</" +"literal>): The default value for unspecifed <literal>lazy</literal> " +"attributes of class and collection mappings." msgstr "" +"<literal>default-lazy</literal> (opcional - default é <literal>true</" +"literal>): O valor default para atributos <literal>lazy</literal> da classe " +"e dos mapeamentos de coleções." -#: index.docbook:147 -msgid "<literal>auto-import</literal> (optional - defaults to <literal>true</literal>): Specifies whether we can use unqualified class names (of classes in this mapping) in the query language." +#. Tag: para +#: basic_mapping.xml:147 +#, no-c-format +msgid "" +"<literal>auto-import</literal> (optional - defaults to <literal>true</" +"literal>): Specifies whether we can use unqualified class names (of classes " +"in this mapping) in the query language." msgstr "" +"<literal>auto-import</literal> ((opcional - default é <literal>true</" +"literal>): Especifica se nós podemos usar nomes de classess não qualificados " +"(das classes deste mapeamento) na linguagem de consulta." -#: index.docbook:154 -msgid "<literal>package</literal> (optional): Specifies a package prefix to assume for unqualified class names in the mapping document." +#. Tag: para +#: basic_mapping.xml:154 +#, no-c-format +msgid "" +"<literal>package</literal> (optional): Specifies a package prefix to assume " +"for unqualified class names in the mapping document." msgstr "" +"<literal>package</literal> (opcional): Especifica um prefixo da package para " +"assumir para nomes de classes não qualificadas no documento de mapeamento." -#: index.docbook:162 -msgid "If you have two persistent classes with the same (unqualified) name, you should set <literal>auto-import=\"false\"</literal>. Hibernate will throw an exception if you attempt to assign two classes to the same \"imported\" name." +#. Tag: para +#: basic_mapping.xml:162 +#, no-c-format +msgid "" +"If you have two persistent classes with the same (unqualified) name, you " +"should set <literal>auto-import=\"false\"</literal>. Hibernate will throw an " +"exception if you attempt to assign two classes to the same \"imported\" name." msgstr "" +"Se voce tem duas classes persistentes com o mesmo nome (não qualificadas), " +"você deve setar <literal>auto-import=\"false\"</literal>. O Hibernate irá " +"gerar uma exceção se você tentar setar duas classes para o mesmo nome " +"\"importado\"." -#: index.docbook:168 -msgid "Note that the <literal>hibernate-mapping</literal> element allows you to nest several persistent <literal><class></literal> mappings, as shown above. It is however good practice (and expected by some tools) to map only a single persistent class (or a single class hierarchy) in one mapping file and name it after the persistent superclass, e.g. <literal>Cat.hbm.xml</literal>, <literal>Dog.hbm.xml</literal>, or if using inheritance, <literal>Animal.hbm.xml</literal>." +#. Tag: para +#: basic_mapping.xml:168 +#, no-c-format +msgid "" +"Note that the <literal>hibernate-mapping</literal> element allows you to " +"nest several persistent <literal><class></literal> mappings, as shown " +"above. It is however good practice (and expected by some tools) to map only " +"a single persistent class (or a single class hierarchy) in one mapping file " +"and name it after the persistent superclass, e.g. <literal>Cat.hbm.xml</" +"literal>, <literal>Dog.hbm.xml</literal>, or if using inheritance, " +"<literal>Animal.hbm.xml</literal>." msgstr "" +"Observe que o elemento <literal>hibernate-mapping</literal> permite a você " +"aninhar diversos mapeamentos de <literal><class></literal> " +"persistentes, como mostrado abaixo. Entretanto, é uma boa prática (e " +"esperado por algumas ferramentas)o mapeamento de apenas uma classe " +"persistente simples (ou uma hierarquia de classes simples) em um arquivo de " +"mapeamento e nomea-la após a superclasse persistente, por exemplo: " +"<literal>Cat.hbm.xml</literal>, <literal>Dog.hbm.xml</literal>, ou se " +"estiver usando herança, <literal>Animal.hbm.xml</literal>." -#: index.docbook:181 +#. Tag: title +#: basic_mapping.xml:181 +#, no-c-format msgid "<title>class</title>" msgstr "" -#: index.docbook:183 -msgid "You may declare a persistent class using the <literal>class</literal> element:" +#. Tag: para +#: basic_mapping.xml:183 +#, no-c-format +msgid "" +"You may declare a persistent class using the <literal>class</literal> " +"element:" msgstr "" +"Você pode declarar uma classe persistente utilizando o elemento " +"<literal>class</literal>:" -#: index.docbook:211 +#. Tag: programlisting +#: basic_mapping.xml:211 +#, no-c-format msgid "" - "<![CDATA[<class\n" - " name=\"ClassName\"\n" - " table=\"tableName\"\n" - " discriminator-value=\"discriminator_value\"\n" - " mutable=\"true|false\"\n" - " schema=\"owner\"\n" - " catalog=\"catalog\"\n" - " proxy=\"ProxyInterface\"\n" - " dynamic-update=\"true|false\"\n" - " dynamic-insert=\"true|false\"\n" - " select-before-update=\"true|false\"\n" - " polymorphism=\"implicit|explicit\"\n" - " where=\"arbitrary sql where condition\"\n" - " persister=\"PersisterClass\"\n" - " batch-size=\"N\"\n" - " optimistic-lock=\"none|version|dirty|all\"\n" - " lazy=\"true|false\"\n" - " entity-name=\"EntityName\"\n" - " check=\"arbitrary sql check condition\"\n" - " rowid=\"rowid\"\n" - " subselect=\"SQL expression\"\n" - " abstract=\"true|false\"\n" - " node=\"element-name\"\n" - "/>]]>" +"<![CDATA[<class\n" +" name=\"ClassName\"\n" +" table=\"tableName\"\n" +" discriminator-value=\"discriminator_value\"\n" +" mutable=\"true|false\"\n" +" schema=\"owner\"\n" +" catalog=\"catalog\"\n" +" proxy=\"ProxyInterface\"\n" +" dynamic-update=\"true|false\"\n" +" dynamic-insert=\"true|false\"\n" +" select-before-update=\"true|false\"\n" +" polymorphism=\"implicit|explicit\"\n" +" where=\"arbitrary sql where condition\"\n" +" persister=\"PersisterClass\"\n" +" batch-size=\"N\"\n" +" optimistic-lock=\"none|version|dirty|all\"\n" +" lazy=\"true|false\"\n" +" entity-name=\"EntityName\"\n" +" check=\"arbitrary sql check condition\"\n" +" rowid=\"rowid\"\n" +" subselect=\"SQL expression\"\n" +" abstract=\"true|false\"\n" +" node=\"element-name\"\n" +"/>]]>" msgstr "" -#: index.docbook:214 -msgid "<literal>name</literal> (optional): The fully qualified Java class name of the persistent class (or interface). If this attribute is missing, it is assumed that the mapping is for a non-POJO entity." +#. Tag: para +#: basic_mapping.xml:214 +#, no-c-format +msgid "" +"<literal>name</literal> (optional): The fully qualified Java class name of " +"the persistent class (or interface). If this attribute is missing, it is " +"assumed that the mapping is for a non-POJO entity." msgstr "" +"<literal>name</literal> (opcional): O nome da classe Java inteiramente " +"qualificado da classe persistente (ou interface); Se o atributo é ausente, " +"assume-se que o mapeamento é para intidades não-POJO." -#: index.docbook:221 -msgid "<literal>table</literal> (optional - defaults to the unqualified class name): The name of its database table." +#. Tag: para +#: basic_mapping.xml:221 +#, no-c-format +msgid "" +"<literal>table</literal> (optional - defaults to the unqualified class " +"name): The name of its database table." msgstr "" +"<literal>table</literal> (opcional – default para nomes de classes não " +"qualificadas) O nome da sua tabela do banco de dados." -#: index.docbook:227 -msgid "<literal>discriminator-value</literal> (optional - defaults to the class name): A value that distiguishes individual subclasses, used for polymorphic behaviour. Acceptable values include <literal>null</literal> and <literal>not null</literal>." +#. Tag: para +#: basic_mapping.xml:227 +#, no-c-format +msgid "" +"<literal>discriminator-value</literal> (optional - defaults to the class " +"name): A value that distiguishes individual subclasses, used for polymorphic " +"behaviour. Acceptable values include <literal>null</literal> and " +"<literal>not null</literal>." msgstr "" +"<literal>discriminator-value</literal> (opcional – default para o nome da " +"classe): Um valor que distingue subclasses individuais, usadas para o " +"comportamento polimorfico. Valores aceitos incluem <literal>null</literal> e " +"<literal>not null</literal>" -#: index.docbook:234 -msgid "<literal>mutable</literal> (optional, defaults to <literal>true</literal>): Specifies that instances of the class are (not) mutable." +#. Tag: para +#: basic_mapping.xml:234 +#, no-c-format +msgid "" +"<literal>mutable</literal> (optional, defaults to <literal>true</literal>): " +"Specifies that instances of the class are (not) mutable." msgstr "" +"<literal>mutable</literal> (opcional - valor default <literal>true</" +"literal>): Especifica que instancias da classe são (ou não) mutáveis" -#: index.docbook:240, index.docbook:2204 -msgid "<literal>schema</literal> (optional): Override the schema name specified by the root <literal><hibernate-mapping></literal> element." +#. Tag: para +#: basic_mapping.xml:240 basic_mapping.xml:2204 +#, fuzzy, no-c-format +msgid "" +"<literal>schema</literal> (optional): Override the schema name specified by " +"the root <literal><hibernate-mapping></literal> element." msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>schema</literal> (opcional): Sobrepõe o nome do esquema " +"especificado pelo elemento root <literal><hibernate-mapping></" +"literal>.\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>schema</literal> (opcional): Sobrepõe o nome do esquema " +"especificado pelo elemento raiz <literal><hibernate-mapping></literal>." -#: index.docbook:246, index.docbook:2210 -msgid "<literal>catalog</literal> (optional): Override the catalog name specified by the root <literal><hibernate-mapping></literal> element." +#. Tag: para +#: basic_mapping.xml:246 basic_mapping.xml:2210 +#, fuzzy, no-c-format +msgid "" +"<literal>catalog</literal> (optional): Override the catalog name specified " +"by the root <literal><hibernate-mapping></literal> element." msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>catalog</literal> (opcional): Sobrepõe o nome do catálogo " +"especificado pelo elemento root <literal><hibernate-mapping></" +"literal>.\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>catalog</literal> (opcional): Sobrepõe o nome do catálogo " +"especificado pelo elemento raiz<literal><hibernate-mapping></literal>." -#: index.docbook:252 -msgid "<literal>proxy</literal> (optional): Specifies an interface to use for lazy initializing proxies. You may specify the name of the class itself." +#. Tag: para +#: basic_mapping.xml:252 +#, no-c-format +msgid "" +"<literal>proxy</literal> (optional): Specifies an interface to use for lazy " +"initializing proxies. You may specify the name of the class itself." msgstr "" +"<literal>proxy</literal> (opcional): Especifica um interface para ser " +"utilizada pelos proxies de inicialização tardia. Você pode especificar o " +"nome da própria classe." -#: index.docbook:258 -msgid "<literal>dynamic-update</literal> (optional, defaults to <literal>false</literal>): Specifies that <literal>UPDATE</literal> SQL should be generated at runtime and contain only those columns whose values have changed." +#. Tag: para +#: basic_mapping.xml:258 +#, no-c-format +msgid "" +"<literal>dynamic-update</literal> (optional, defaults to <literal>false</" +"literal>): Specifies that <literal>UPDATE</literal> SQL should be generated " +"at runtime and contain only those columns whose values have changed." msgstr "" +"<literal>dynamic-update</literal> (opcional, valor default <literal>false</" +"literal>): Especifica que o SQL de <literal>UPDATE</literal> deve ser gerado " +"em tempo de execução e conter apenas aquelas colunas cujos valores foram " +"alterados." -#: index.docbook:265 -msgid "<literal>dynamic-insert</literal> (optional, defaults to <literal>false</literal>): Specifies that <literal>INSERT</literal> SQL should be generated at runtime and contain only the columns whose values are not null." +#. Tag: para +#: basic_mapping.xml:265 +#, no-c-format +msgid "" +"<literal>dynamic-insert</literal> (optional, defaults to <literal>false</" +"literal>): Specifies that <literal>INSERT</literal> SQL should be generated " +"at runtime and contain only the columns whose values are not null." msgstr "" +"<literal>dynamic-insert</literal> (opcional, valor default <literal>false</" +"literal>): Especifica que o SQL de <literal>INSERT</literal> deve ser gerado " +"em tempo de execução e conter apenas aquelas colunas cujos valores não estão " +"nulos." -#: index.docbook:272 -msgid "<literal>select-before-update</literal> (optional, defaults to <literal>false</literal>): Specifies that Hibernate should <emphasis>never</emphasis> perform an SQL <literal>UPDATE</literal> unless it is certain that an object is actually modified. In certain cases (actually, only when a transient object has been associated with a new session using <literal>update()</literal>), this means that Hibernate will perform an extra SQL <literal>SELECT</literal> to determine if an <literal>UPDATE</literal> is actually required." +#. Tag: para +#: basic_mapping.xml:272 +#, no-c-format +msgid "" +"<literal>select-before-update</literal> (optional, defaults to " +"<literal>false</literal>): Specifies that Hibernate should <emphasis>never</" +"emphasis> perform an SQL <literal>UPDATE</literal> unless it is certain that " +"an object is actually modified. In certain cases (actually, only when a " +"transient object has been associated with a new session using <literal>update" +"()</literal>), this means that Hibernate will perform an extra SQL " +"<literal>SELECT</literal> to determine if an <literal>UPDATE</literal> is " +"actually required." msgstr "" +"<literal>select-before-update</literal> (opcional, valor default " +"<literal>false</literal>): Especifica que o Hibernate <emphasis>never</" +"emphasis> deve executar um SQL de <literal>UPDATE</literal> a não ser que " +"com certeza um objeto está atualmente modificado. Em certos casos " +"(atualmente, apenas quando um objeto transiente foi associado com uma nova " +"sessão utilizando <literal>update()</literal>), isto significa que o " +"Hibernate ira executar uma instrução SQL de <literal>SELECT</literal> " +"adicional para determinar se um <literal>UPDATE</literal> é necessário nesse " +"momento." -#: index.docbook:282 -msgid "<literal>polymorphism</literal> (optional, defaults to <literal>implicit</literal>): Determines whether implicit or explicit query polymorphism is used." +#. Tag: para +#: basic_mapping.xml:282 +#, no-c-format +msgid "" +"<literal>polymorphism</literal> (optional, defaults to <literal>implicit</" +"literal>): Determines whether implicit or explicit query polymorphism is " +"used." msgstr "" +"<literal>polymorphism</literal> (opcional, default para <literal>implicit</" +"literal>): Determina se deve ser utilizado a query polimorfica implicita ou " +"explicitamente." -#: index.docbook:288 -msgid "<literal>where</literal> (optional) specify an arbitrary SQL <literal>WHERE</literal> condition to be used when retrieving objects of this class" +#. Tag: para +#: basic_mapping.xml:288 +#, no-c-format +msgid "" +"<literal>where</literal> (optional) specify an arbitrary SQL <literal>WHERE</" +"literal> condition to be used when retrieving objects of this class" msgstr "" +"<literal>where</literal> (opicional) especifica um comando SQL " +"<literal>WHERE</literal> arbitrário para ser usado quando da recuperação de " +"objetos desta classe." -#: index.docbook:294 -msgid "<literal>persister</literal> (optional): Specifies a custom <literal>ClassPersister</literal>." +#. Tag: para +#: basic_mapping.xml:294 +#, no-c-format +msgid "" +"<literal>persister</literal> (optional): Specifies a custom " +"<literal>ClassPersister</literal>." msgstr "" +"<literal>persister</literal> (opcional): Espeicifca uma " +"<literal>ClassPersister</literal> customizada." -#: index.docbook:299 -msgid "<literal>batch-size</literal> (optional, defaults to <literal>1</literal>) specify a \"batch size\" for fetching instances of this class by identifier." +#. Tag: para +#: basic_mapping.xml:299 +#, no-c-format +msgid "" +"<literal>batch-size</literal> (optional, defaults to <literal>1</literal>) " +"specify a \"batch size\" for fetching instances of this class by identifier." msgstr "" +"<literal>batch-size</literal> (opcional, valor default <literal>1</literal>) " +"especifica um \"tamanho de lote\" para a recuperação de instancias desta " +"classe pelo identificador." -#: index.docbook:305 -msgid "<literal>optimistic-lock</literal> (optional, defaults to <literal>version</literal>): Determines the optimistic locking strategy." +#. Tag: para +#: basic_mapping.xml:305 +#, no-c-format +msgid "" +"<literal>optimistic-lock</literal> (optional, defaults to <literal>version</" +"literal>): Determines the optimistic locking strategy." msgstr "" +"<literal>optimistic-lock</literal> (octional, valor default " +"<literal>version</literal>): Determina a estratégia de bloqueio." -#: index.docbook:311 -msgid "<literal>lazy</literal> (optional): Lazy fetching may be completely disabled by setting <literal>lazy=\"false\"</literal>." +#. Tag: para +#: basic_mapping.xml:311 +#, no-c-format +msgid "" +"<literal>lazy</literal> (optional): Lazy fetching may be completely disabled " +"by setting <literal>lazy=\"false\"</literal>." msgstr "" +"<literal>lazy</literal> (opcional): A recuperação tardia pode ser " +"completamente desabilitada, setando <literal>lazy=\"false\"</literal>." -#: index.docbook:317 -msgid "<literal>entity-name</literal> (optional, defaults to the class name): Hibernate3 allows a class to be mapped multiple times (to different tables, potentially), and allows entity mappings that are represented by Maps or XML at the Java level. In these cases, you should provide an explicit arbitrary name for the entity. See <xref linkend=\"persistent-classes-dynamicmodels\"/> and <xref linkend=\"xml\"/> for more information." +#. Tag: para +#: basic_mapping.xml:317 +#, no-c-format +msgid "" +"<literal>entity-name</literal> (optional, defaults to the class name): " +"Hibernate3 allows a class to be mapped multiple times (to different tables, " +"potentially), and allows entity mappings that are represented by Maps or XML " +"at the Java level. In these cases, you should provide an explicit arbitrary " +"name for the entity. See <xref linkend=\"persistent-classes-dynamicmodels\"/" +"> and <xref linkend=\"xml\"/> for more information." msgstr "" +"<literal>entity-name</literal> (opcional, default para o nome da classe): O " +"Hibernate3 permite uma classe ser mapeada multiplas vezes, (potencialmente," +"para diferentes tabelas), e permite mapeamentos de entidades que são " +"representadas por Maps ou XML no nível Java. Nestes casos, você deve " +"especificar um nome arbitrário explicitamente para a entidade. Veja <xref " +"linkend=\"persistent-classes-dynamicmodels\"/> e <xref linkend=\"xml\"/> " +"para maiores informações." -#: index.docbook:327 -msgid "<literal>check</literal> (optional): A SQL expression used to generate a multi-row <emphasis>check</emphasis> constraint for automatic schema generation." +#. Tag: para +#: basic_mapping.xml:327 +#, no-c-format +msgid "" +"<literal>check</literal> (optional): A SQL expression used to generate a " +"multi-row <emphasis>check</emphasis> constraint for automatic schema " +"generation." msgstr "" +"<literal>check</literal> (opcional): Uma expressão SQL utilizada para gerar " +"uma constraint de <emphasis>verificação</emphasis> de múltiplas linhas para " +"a geração automática do esquema." -#: index.docbook:333 -msgid "<literal>rowid</literal> (optional): Hibernate can use so called ROWIDs on databases which support. E.g. on Oracle, Hibernate can use the <literal>rowid</literal> extra column for fast updates if you set this option to <literal>rowid</literal>. A ROWID is an implementation detail and represents the physical location of a stored tuple." +#. Tag: para +#: basic_mapping.xml:333 +#, no-c-format +msgid "" +"<literal>rowid</literal> (optional): Hibernate can use so called ROWIDs on " +"databases which support. E.g. on Oracle, Hibernate can use the " +"<literal>rowid</literal> extra column for fast updates if you set this " +"option to <literal>rowid</literal>. A ROWID is an implementation detail and " +"represents the physical location of a stored tuple." msgstr "" +"<literal>rowid</literal> (opcional): O Hibernate poder usar as assim " +"chamadas ROWIDs em bancos de dados que a suportam. Por exemplo, no Oracle, o " +"Hibernate pode utilizar a coluna extra rowid para atualizações mais rápidas " +"se você configurar esta opção para <literal>rowid</literal>. Um ROWID é uma " +"implementação que representa de maneira detalhada a localização física de " +"uma determinada tupla armazenado." -#: index.docbook:341 -msgid "<literal>subselect</literal> (optional): Maps an immutable and read-only entity to a database subselect. Useful if you want to have a view instead of a base table, but don't. See below for more information." +#. Tag: para +#: basic_mapping.xml:341 +#, no-c-format +msgid "" +"<literal>subselect</literal> (optional): Maps an immutable and read-only " +"entity to a database subselect. Useful if you want to have a view instead of " +"a base table, but don't. See below for more information." msgstr "" +"<literal>subselect</literal> (optional): Maps an immutable and read-only " +"entity to a database subselect. Useful if you want to have a view instead of " +"a base table, but don't. See below for more information. <literal>subselect</" +"literal> (opcional): Mapeia uma entidade imutavel e somente de leitura para " +"um subconjunto do banco de dados. Útil se você quiser ter uma view em vez de " +"uma tabela. Veja abaixo para mais informações." -#: index.docbook:348 -msgid "<literal>abstract</literal> (optional): Used to mark abstract superclasses in <literal><union-subclass></literal> hierarchies." +#. Tag: para +#: basic_mapping.xml:348 +#, no-c-format +msgid "" +"<literal>abstract</literal> (optional): Used to mark abstract superclasses " +"in <literal><union-subclass></literal> hierarchies." msgstr "" +"<literal>abstract</literal> (opcional): Utilizada para marcar superclasses " +"abstratas em hierarquias <literal><union-subclass></literal>." -#: index.docbook:356 -msgid "It is perfectly acceptable for the named persistent class to be an interface. You would then declare implementing classes of that interface using the <literal><subclass></literal> element. You may persist any <emphasis>static</emphasis> inner class. You should specify the class name using the standard form ie. <literal>eg.Foo$Bar</literal>." +#. Tag: para +#: basic_mapping.xml:356 +#, no-c-format +msgid "" +"It is perfectly acceptable for the named persistent class to be an " +"interface. You would then declare implementing classes of that interface " +"using the <literal><subclass></literal> element. You may persist any " +"<emphasis>static</emphasis> inner class. You should specify the class name " +"using the standard form ie. <literal>eg.Foo$Bar</literal>." msgstr "" +"É perfeitamente aceitável para uma classe persitente nomeada ser uma " +"interface. Você deverá então declarar as classes implementadas desta " +"interface utilizando o elemento <literal><subclass></literal>. Você " +"pode persistir qualquer classe de aninhada <emphasis>estatica</emphasis>. " +"Você deverá especificar o nome da classe usando a forma padrão, por exemplo: " +"<literal>eg.Foo$Bar</literal>." -#: index.docbook:363 -msgid "Immutable classes, <literal>mutable=\"false\"</literal>, may not be updated or deleted by the application. This allows Hibernate to make some minor performance optimizations." +#. Tag: para +#: basic_mapping.xml:363 +#, no-c-format +msgid "" +"Immutable classes, <literal>mutable=\"false\"</literal>, may not be updated " +"or deleted by the application. This allows Hibernate to make some minor " +"performance optimizations." msgstr "" +"Classes imutáveis, <literal>mutable=\"false\"</literal>, não podem ser " +"modificadas ou excluídas pela aplicação. Isso permite ao Hibernate fazer " +"alguns aperfeiçoamentos de performance." -#: index.docbook:368 -msgid "The optional <literal>proxy</literal> attribute enables lazy initialization of persistent instances of the class. Hibernate will initially return CGLIB proxies which implement the named interface. The actual persistent object will be loaded when a method of the proxy is invoked. See \"Initializing collections and proxies\" below." +#. Tag: para +#: basic_mapping.xml:368 +#, no-c-format +msgid "" +"The optional <literal>proxy</literal> attribute enables lazy initialization " +"of persistent instances of the class. Hibernate will initially return CGLIB " +"proxies which implement the named interface. The actual persistent object " +"will be loaded when a method of the proxy is invoked. See \"Initializing " +"collections and proxies\" below." msgstr "" +"O atributo opcional <literal>proxy</literal> habilita a inicialização tardia " +"das instâncias persistentes da classe. O Hibernate irá retornar CGLIB " +"proxies como implementado na interface nomeada. O objeto persistente atual " +"será carregado quando um método do proxy for invocado. Veja \"Inicializando " +"coleções e proxies\" abaixo." -#: index.docbook:375 -msgid "<emphasis>Implicit</emphasis> polymorphism means that instances of the class will be returned by a query that names any superclass or implemented interface or the class and that instances of any subclass of the class will be returned by a query that names the class itself. <emphasis>Explicit</emphasis> polymorphism means that class instances will be returned only by queries that explicitly name that class and that queries that name the class will return only instances of subclasses mapped inside this <literal><class></literal> declaration as a <literal><subclass></literal> or <literal><joined-subclass></literal>. For most purposes the default, <literal>polymorphism=\"implicit\"</literal>, is appropriate. Explicit polymorphism is useful when two different classes are mapped to the same table (this allows a \"lightweight\" class that contains a subset of the table columns)." +#. Tag: para +#: basic_mapping.xml:375 +#, no-c-format +msgid "" +"<emphasis>Implicit</emphasis> polymorphism means that instances of the class " +"will be returned by a query that names any superclass or implemented " +"interface or the class and that instances of any subclass of the class will " +"be returned by a query that names the class itself. <emphasis>Explicit</" +"emphasis> polymorphism means that class instances will be returned only by " +"queries that explicitly name that class and that queries that name the class " +"will return only instances of subclasses mapped inside this <literal><" +"class></literal> declaration as a <literal><subclass></literal> or " +"<literal><joined-subclass></literal>. For most purposes the default, " +"<literal>polymorphism=\"implicit\"</literal>, is appropriate. Explicit " +"polymorphism is useful when two different classes are mapped to the same " +"table (this allows a \"lightweight\" class that contains a subset of the " +"table columns)." msgstr "" +"Polimorfismo <emphasis>implícito</emphasis> significa que instâncias de uma " +"classe serão retornada por uma query que dá nome a qualquer superclasse ou " +"interface implementada, ou a classe e as instancias de qualquer subclasse da " +"classe será retornada por umq query que nomeia a classe por si. Polimorfismo " +"<emphasis>explícito</emphasis> significa que instancias da classe serão " +"retornadas apenas por queries que explicitamente nomeiam a classe e que " +"queries que nomeiam as classes irão retornar apenas instancias de subclasses " +"mapeadas dentro da declaração <literal><class></literal> como uma " +"<literal><subclass></literal> ou <literal><joined-subclass></" +"literal>. Para a maioria dos casos, o valor default <literal>polymorphism=" +"\"implicit\"</literal>, é apropriado. Polimorfismo explicito é útil quando " +"duas classes distintas estão mapeadas para a mesma tabela (isso permite um " +"classe \"peso leve\" que contem um subconjunto de colunas da tabela)." -#: index.docbook:387 -msgid "The <literal>persister</literal> attribute lets you customize the persistence strategy used for the class. You may, for example, specify your own subclass of <literal>org.hibernate.persister.EntityPersister</literal> or you might even provide a completely new implementation of the interface <literal>org.hibernate.persister.ClassPersister</literal> that implements persistence via, for example, stored procedure calls, serialization to flat files or LDAP. See <literal>org.hibernate.test.CustomPersister</literal> for a simple example (of \"persistence\" to a <literal>Hashtable</literal>)." +#. Tag: para +#: basic_mapping.xml:387 +#, no-c-format +msgid "" +"The <literal>persister</literal> attribute lets you customize the " +"persistence strategy used for the class. You may, for example, specify your " +"own subclass of <literal>org.hibernate.persister.EntityPersister</literal> " +"or you might even provide a completely new implementation of the interface " +"<literal>org.hibernate.persister.ClassPersister</literal> that implements " +"persistence via, for example, stored procedure calls, serialization to flat " +"files or LDAP. See <literal>org.hibernate.test.CustomPersister</literal> for " +"a simple example (of \"persistence\" to a <literal>Hashtable</literal>)." msgstr "" +"O atributo <literal>persister</literal> deixa você customizar a estratégia " +"de persistência utilizada para a classe. Você pode, por exemplo, especificar " +"sua prórpia subclasse do <literal>org.hibernate.persister.EntityPersister</" +"literal> ou você pode criar uma implementação completamente nova da " +"interface <literal>org.hibernate.persister.ClassPersister</literal> que " +"implementa a persistência através de, por exemplo, chamadas a stored " +"procedeures, serialização de arquivos flat ou LDAP. Veja <literal>org." +"hibernate.test.CustomPersister</literal> para um exemplo simples (de " +"\"persistencia\" para uma <literal>Hashtable</literal>)." -#: index.docbook:398 -msgid "Note that the <literal>dynamic-update</literal> and <literal>dynamic-insert</literal> settings are not inherited by subclasses and so may also be specified on the <literal><subclass></literal> or <literal><joined-subclass></literal> elements. These settings may increase performance in some cases, but might actually decrease performance in others. Use judiciously." +#. Tag: para +#: basic_mapping.xml:398 +#, no-c-format +msgid "" +"Note that the <literal>dynamic-update</literal> and <literal>dynamic-insert</" +"literal> settings are not inherited by subclasses and so may also be " +"specified on the <literal><subclass></literal> or <literal><joined-" +"subclass></literal> elements. These settings may increase performance in " +"some cases, but might actually decrease performance in others. Use " +"judiciously." msgstr "" +"Observe que as configurações <literal>dynamic-update</literal> e " +"<literal>dynamic-insert</literal> não sao herdadas pelas subclasses e assim " +"podem tambem ser especificadas em elementos <literal><subclass></" +"literal> or <literal><joined-subclass></literal>. Estas configurações " +"podem incrementar a performance em alguns casos, mas pode realmente diminuir " +"a performance em outras. Use-as de forma bastante criteriosa." -#: index.docbook:406 -msgid "Use of <literal>select-before-update</literal> will usually decrease performance. It is very useful to prevent a database update trigger being called unnecessarily if you reattach a graph of detached instances to a <literal>Session</literal>." +#. Tag: para +#: basic_mapping.xml:406 +#, no-c-format +msgid "" +"Use of <literal>select-before-update</literal> will usually decrease " +"performance. It is very useful to prevent a database update trigger being " +"called unnecessarily if you reattach a graph of detached instances to a " +"<literal>Session</literal>." msgstr "" +"O uso de <literal>select-before-update</literal> geralmente irá diminuir a " +"performance. Ela é muito útil para prevenir que uma trigger de atualização " +"no banco de dados seja ativada desnecessariamente, se você reconectar um nó " +"de uma instancia desconectada em uma <literal>Session</literal>." -#: index.docbook:412 -msgid "If you enable <literal>dynamic-update</literal>, you will have a choice of optimistic locking strategies:" +#. Tag: para +#: basic_mapping.xml:412 +#, no-c-format +msgid "" +"If you enable <literal>dynamic-update</literal>, you will have a choice of " +"optimistic locking strategies:" msgstr "" +"Se você ativar <literal>dynamic-update</literal>, você terá de escolher a " +"estratégia de bloqueio otimista:" -#: index.docbook:418 +#. Tag: para +#: basic_mapping.xml:418 +#, no-c-format msgid "<literal>version</literal> check the version/timestamp columns" -msgstr "" +msgstr "<literal>version</literal> verifica a versão e a hora das colunas" -#: index.docbook:423 +#. Tag: para +#: basic_mapping.xml:423 +#, no-c-format msgid "<literal>all</literal> check all columns" -msgstr "" +msgstr "<literal>all</literal> cverifica todas as colunas" -#: index.docbook:428 -msgid "<literal>dirty</literal> check the changed columns, allowing some concurrent updates" +#. Tag: para +#: basic_mapping.xml:428 +#, no-c-format +msgid "" +"<literal>dirty</literal> check the changed columns, allowing some concurrent " +"updates" msgstr "" +"<literal>dirty</literal> verifica as colunas modificadas, permitindo alguns " +"updates concorrentes" -#: index.docbook:433 +#. Tag: para +#: basic_mapping.xml:433 +#, no-c-format msgid "<literal>none</literal> do not use optimistic locking" -msgstr "" +msgstr "<literal>none</literal> não utiliza o bloqueio otimista" -#: index.docbook:438 -msgid "We <emphasis>very</emphasis> strongly recommend that you use version/timestamp columns for optimistic locking with Hibernate. This is the optimal strategy with respect to performance and is the only strategy that correctly handles modifications made to detached instances (ie. when <literal>Session.merge()</literal> is used)." +#. Tag: para +#: basic_mapping.xml:438 +#, no-c-format +msgid "" +"We <emphasis>very</emphasis> strongly recommend that you use version/" +"timestamp columns for optimistic locking with Hibernate. This is the optimal " +"strategy with respect to performance and is the only strategy that correctly " +"handles modifications made to detached instances (ie. when <literal>Session." +"merge()</literal> is used)." msgstr "" +"Nós <emphasis>recomendamos</emphasis> com muita enfase que você utilize a " +"versão e a hora das colunas para o bloqueio otimista com o Hibernate. Esta é " +"a melhor estratégia com respeito a performance e é a única estratégia que " +"trata corretamente as modificações efetuadas em instancias desconectadas " +"(por exemplo, quando <literal>Session.merge()</literal> é utilizado)." -#: index.docbook:445 -msgid "There is no difference between a view and a base table for a Hibernate mapping, as expected this is transparent at the database level (note that some DBMS don't support views properly, especially with updates). Sometimes you want to use a view, but can't create one in the database (ie. with a legacy schema). In this case, you can map an immutable and read-only entity to a given SQL subselect expression:" +#. Tag: para +#: basic_mapping.xml:445 +#, no-c-format +msgid "" +"There is no difference between a view and a base table for a Hibernate " +"mapping, as expected this is transparent at the database level (note that " +"some DBMS don't support views properly, especially with updates). Sometimes " +"you want to use a view, but can't create one in the database (ie. with a " +"legacy schema). In this case, you can map an immutable and read-only entity " +"to a given SQL subselect expression:" msgstr "" +"Não ha diferença entre uma view e uma tabela para o mapeamento do Hibernate, " +"e como esperado isto é transparente no nível do banco de dados (observe que " +"alguns bancos de dados não suportam views apropriadamente, especialmente com " +"updates). Algumas vezes, você quer utilizar uma view, ma snão pode cria-la " +"no banco de dados (por exemplo, com um esquema legado). Neste caso, você " +"pode mapear uma entidade imutável e de somente leitura, para uma dada " +"expressão SQL, que representa um subselect:" -#: index.docbook:453 +#. Tag: programlisting +#: basic_mapping.xml:453 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Summary\">\n" - " <subselect>\n" - " select item.name, max(bid.amount), count(*)\n" - " from item\n" - " join bid on bid.item_id = item.id\n" - " group by item.name\n" - " </subselect>\n" - " <synchronize table=\"item\"/>\n" - " <synchronize table=\"bid\"/>\n" - " <id name=\"name\"/>\n" - " ...\n" - "</class>]]>" +"<![CDATA[<class name=\"Summary\">\n" +" <subselect>\n" +" select item.name, max(bid.amount), count(*)\n" +" from item\n" +" join bid on bid.item_id = item.id\n" +" group by item.name\n" +" </subselect>\n" +" <synchronize table=\"item\"/>\n" +" <synchronize table=\"bid\"/>\n" +" <id name=\"name\"/>\n" +" ...\n" +"</class>]]>" msgstr "" -#: index.docbook:455 -msgid "Declare the tables to synchronize this entity with, ensuring that auto-flush happens correctly, and that queries against the derived entity do not return stale data. The <literal><subselect></literal> is available as both as an attribute and a nested mapping element." +#. Tag: para +#: basic_mapping.xml:455 +#, no-c-format +msgid "" +"Declare the tables to synchronize this entity with, ensuring that auto-flush " +"happens correctly, and that queries against the derived entity do not return " +"stale data. The <literal><subselect></literal> is available as both as " +"an attribute and a nested mapping element." msgstr "" +"Declare as tabelas para sincronizar com esta entidade, garantindo que o auto-" +"flush ocorra corretamente, e que as queries para esta entidade derivada não " +"retornem dados desatualizados. O <literal><subselect></literal> está " +"disponível tanto como um atributo como um elemento mapeado nested." -#: index.docbook:465 +#. Tag: title +#: basic_mapping.xml:465 +#, no-c-format msgid "<title>id</title>" msgstr "" -#: index.docbook:467 -msgid "Mapped classes <emphasis>must</emphasis> declare the primary key column of the database table. Most classes will also have a JavaBeans-style property holding the unique identifier of an instance. The <literal><id></literal> element defines the mapping from that property to the primary key column." +#. Tag: para +#: basic_mapping.xml:467 +#, no-c-format +msgid "" +"Mapped classes <emphasis>must</emphasis> declare the primary key column of " +"the database table. Most classes will also have a JavaBeans-style property " +"holding the unique identifier of an instance. The <literal><id></" +"literal> element defines the mapping from that property to the primary key " +"column." msgstr "" +"Classes mapeadas <emphasis>precisam</emphasis> declarar a coluna de chave " +"primaria da tabela do banco de dados. Muitas classes irão tambem ter uma " +"propriedade ao estilo Java-Beans declarando o identificador unico de uma " +"instancia. O elemento <literal><id></literal> define o mapeamento " +"desta propriedade para a chave primária." -#: index.docbook:482 +#. Tag: programlisting +#: basic_mapping.xml:482 +#, no-c-format msgid "" - "<![CDATA[<id\n" - " name=\"propertyName\"\n" - " type=\"typename\"\n" - " column=\"column_name\"\n" - " unsaved-value=\"null|any|none|undefined|id_value\"\n" - " access=\"field|property|ClassName\">\n" - " node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" - "\n" - " <generator class=\"generatorClass\"/>\n" - "</id>]]>" +"<![CDATA[<id\n" +" name=\"propertyName\"\n" +" type=\"typename\"\n" +" column=\"column_name\"\n" +" unsaved-value=\"null|any|none|undefined|id_value\"\n" +" access=\"field|property|ClassName\">\n" +" node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" +"\n" +" <generator class=\"generatorClass\"/>\n" +"</id>]]>" msgstr "" -#: index.docbook:485 -msgid "<literal>name</literal> (optional): The name of the identifier property." -msgstr "" +#. Tag: para +#: basic_mapping.xml:485 +#, no-c-format +msgid "" +"<literal>name</literal> (optional): The name of the identifier property." +msgstr "<literal>name</literal> (opcional): O nome do identificador." -#: index.docbook:490 -msgid "<literal>type</literal> (optional): A name that indicates the Hibernate type." +#. Tag: para +#: basic_mapping.xml:490 +#, no-c-format +msgid "" +"<literal>type</literal> (optional): A name that indicates the Hibernate type." msgstr "" +"<literal>type</literal> (opcional): Um nome que indica o tipo no Hibernate." -#: index.docbook:495 -msgid "<literal>column</literal> (optional - defaults to the property name): The name of the primary key column." +#. Tag: para +#: basic_mapping.xml:495 +#, no-c-format +msgid "" +"<literal>column</literal> (optional - defaults to the property name): The " +"name of the primary key column." msgstr "" +"<literal>column</literal> (opcional – default para o a propridade name): O " +"nome coluna chave primaria." -#: index.docbook:501 -msgid "<literal>unsaved-value</literal> (optional - defaults to a \"sensible\" value): An identifier property value that indicates that an instance is newly instantiated (unsaved), distinguishing it from detached instances that were saved or loaded in a previous session." +#. Tag: para +#: basic_mapping.xml:501 +#, no-c-format +msgid "" +"<literal>unsaved-value</literal> (optional - defaults to a \"sensible\" " +"value): An identifier property value that indicates that an instance is " +"newly instantiated (unsaved), distinguishing it from detached instances that " +"were saved or loaded in a previous session." msgstr "" +"<literal>unsaved-value</literal> (opcional - default para um valor \"sensível" +"\"): Uma propriedade de identificação que indica que a instancia foi " +"novamente instanciada (unsaved), diferenciando de instancias desconectadas " +"que foram salvas ou carregadas em uma sessão anterior." -#: index.docbook:509, index.docbook:1017, index.docbook:1156, index.docbook:1238, index.docbook:1345, index.docbook:1534, index.docbook:1708, index.docbook:1878, index.docbook:2457 -msgid "<literal>access</literal> (optional - defaults to <literal>property</literal>): The strategy Hibernate should use for accessing the property value." +#. Tag: para +#: basic_mapping.xml:509 basic_mapping.xml:1017 basic_mapping.xml:1156 +#: basic_mapping.xml:1238 basic_mapping.xml:1345 basic_mapping.xml:1534 +#: basic_mapping.xml:1708 basic_mapping.xml:1878 basic_mapping.xml:2457 +#, fuzzy, no-c-format +msgid "" +"<literal>access</literal> (optional - defaults to <literal>property</" +"literal>): The strategy Hibernate should use for accessing the property " +"value." msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>access</literal> (opcional - valor default <literal>property</" +"literal>): A estratégia que o Hiberante deve utilizar para acessar o valor " +"da propriedade\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>access</literal> (opcional - valor default <literal>property</" +"literal>): A estartégia Hibernate que deve ser utilizada para acessar o " +"valor da propriedade.\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>access</literal> (opcional - valor default <literal>property</" +"literal>): A estratégia Hibernate que deve ser usada para acessar o valor da " +"propriedade.\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>access</literal> (opcional - valor default para <literal>property</" +"literal>): A estretagia Hibernate que deve ser utilizada para acessar o " +"valor da propriedade.\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>access</literal> (opcional – valor default <literal>property</" +"literal>): A estratégia que o Hibernate deve utilizar para acessar o valor " +"da propriedade\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>access</literal> (opcional - valor default <literal>property</" +"literal>): A estrategia que o Hibernate deve utilizar para acessar o valor " +"da propriedade.\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>access</literal> (opcional - valor default padrão " +"<literal>property</literal>): A estratégia que o Hibernate pode usar para " +"acessar o valor da propriedade.\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>access</literal> (opcional – valor default <literal>property</" +"literal>): A estratégia que o Hibernate pode usar para acessar o valor da " +"propriedade.\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>access</literal> (opcional – valor default <literal>property</" +"literal>): A estratégia que o hibernate deve usar para acessar o valor da " +"propriedade." -#: index.docbook:517 -msgid "If the <literal>name</literal> attribute is missing, it is assumed that the class has no identifier property." +#. Tag: para +#: basic_mapping.xml:517 +#, no-c-format +msgid "" +"If the <literal>name</literal> attribute is missing, it is assumed that the " +"class has no identifier property." msgstr "" +"Se o atributo <literal>name</literal> não for declarado, assume-se que a " +"classe não tem a propriedade de identificação." -#: index.docbook:522 -msgid "The <literal>unsaved-value</literal> attribute is almost never needed in Hibernate3." +#. Tag: para +#: basic_mapping.xml:522 +#, no-c-format +msgid "" +"The <literal>unsaved-value</literal> attribute is almost never needed in " +"Hibernate3." msgstr "" +"O atributo <literal>unsaved-value</literal> não é mais necessário no " +"Hibernate 3." -#: index.docbook:526 -msgid "There is an alternative <literal><composite-id></literal> declaration to allow access to legacy data with composite keys. We strongly discourage its use for anything else." +#. Tag: para +#: basic_mapping.xml:526 +#, no-c-format +msgid "" +"There is an alternative <literal><composite-id></literal> declaration " +"to allow access to legacy data with composite keys. We strongly discourage " +"its use for anything else." msgstr "" +"Há declaração alternativa <literal><composite-id></literal> permite o " +"acesso a dados legados com chaves compostas. Nós desencorajamos fortemente o " +"seu uso por qualquer pessoa." -#: index.docbook:532 +#. Tag: title +#: basic_mapping.xml:532 +#, no-c-format msgid "Generator" -msgstr "" +msgstr "Generator" -#: index.docbook:534 -msgid "The optional <literal><generator></literal> child element names a Java class used to generate unique identifiers for instances of the persistent class. If any parameters are required to configure or initialize the generator instance, they are passed using the <literal><param></literal> element." +#. Tag: para +#: basic_mapping.xml:534 +#, no-c-format +msgid "" +"The optional <literal><generator></literal> child element names a Java " +"class used to generate unique identifiers for instances of the persistent " +"class. If any parameters are required to configure or initialize the " +"generator instance, they are passed using the <literal><param></" +"literal> element." msgstr "" +"O elemento filho opcional <literal><generator></literal> nomeia uma " +"classe Java usada para gerar identificadores unicos para instancias de uma " +"classe persistente. Se algum parâmetro é requerido para configurar ou " +"inicializar a instancia geradora, eles são passados utilizando o elemento " +"<literal><param></literal>." -#: index.docbook:541 +#. Tag: programlisting +#: basic_mapping.xml:541 +#, no-c-format msgid "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"cat_id\">\n" - " <generator class=\"org.hibernate.id.TableHiLoGenerator\">\n" - " <param name=\"table\">uid_table</param>\n" - " <param name=\"column\">next_hi_value_column</param>\n" - " </generator>\n" - "</id>]]>" +"<![CDATA[<id name=\"id\" type=\"long\" column=\"cat_id\">\n" +" <generator class=\"org.hibernate.id.TableHiLoGenerator\">\n" +" <param name=\"table\">uid_table</param>\n" +" <param name=\"column\">next_hi_value_column</param>\n" +" </generator>\n" +"</id>]]>" msgstr "" -#: index.docbook:543 -msgid "All generators implement the interface <literal>org.hibernate.id.IdentifierGenerator</literal>. This is a very simple interface; some applications may choose to provide their own specialized implementations. However, Hibernate provides a range of built-in implementations. There are shortcut names for the built-in generators:" +#. Tag: para +#: basic_mapping.xml:543 +#, fuzzy, no-c-format +msgid "" +"All generators implement the interface <literal>org.hibernate.id." +"IdentifierGenerator</literal>. This is a very simple interface; some " +"applications may choose to provide their own specialized implementations. " +"However, Hibernate provides a range of built-in implementations. There are " +"shortcut names for the built-in generators:" msgstr "" +"Todos os generators implementam a interface <literal>org.hibernate.id." +"IdentifierGenerator</literal>. Esta é uma interface bem simples; algumas " +"aplicações podem prover sua própria implementação esepecializada. " +"Entretanto, o Hibernate disponibiliza um conjunto de implementações " +"internamente. Há nomes de atalhos para estes generators próprios: " +"<placeholder-1/>" -#: index.docbook:551 +#. Tag: literal +#: basic_mapping.xml:551 +#, no-c-format msgid "increment" -msgstr "" +msgstr "increment" -#: index.docbook:553 -msgid "generates identifiers of type <literal>long</literal>, <literal>short</literal> or <literal>int</literal> that are unique only when no other process is inserting data into the same table. <emphasis>Do not use in a cluster.</emphasis>" +#. Tag: para +#: basic_mapping.xml:553 +#, no-c-format +msgid "" +"generates identifiers of type <literal>long</literal>, <literal>short</" +"literal> or <literal>int</literal> that are unique only when no other " +"process is inserting data into the same table. <emphasis>Do not use in a " +"cluster.</emphasis>" msgstr "" +"gera identificadores dos tipos <literal>long</literal>, <literal>short</" +"literal> ou <literal>int</literal> que são unicos apenas quando nenhum outro " +"processo está inserindo dados na mesma tabela. <emphasis>Não utilize em " +"ambientes de cluster.</emphasis>" -#: index.docbook:562 +#. Tag: literal +#: basic_mapping.xml:562 +#, no-c-format msgid "identity" -msgstr "" +msgstr "identity" -#: index.docbook:564 -msgid "supports identity columns in DB2, MySQL, MS SQL Server, Sybase and HypersonicSQL. The returned identifier is of type <literal>long</literal>, <literal>short</literal> or <literal>int</literal>." +#. Tag: para +#: basic_mapping.xml:564 +#, no-c-format +msgid "" +"supports identity columns in DB2, MySQL, MS SQL Server, Sybase and " +"HypersonicSQL. The returned identifier is of type <literal>long</literal>, " +"<literal>short</literal> or <literal>int</literal>." msgstr "" +"suporta colunas de identidade em DB2, MySQL, MS SQL Server, Sybase e " +"HypersonicSQL. O identificador retornado é do tipo <literal>long</literal>, " +"<literal>short</literal> ou <literal>int</literal>." -#: index.docbook:572 +#. Tag: literal +#: basic_mapping.xml:572 +#, no-c-format msgid "sequence" -msgstr "" +msgstr "sequence" -#: index.docbook:574 -msgid "uses a sequence in DB2, PostgreSQL, Oracle, SAP DB, McKoi or a generator in Interbase. The returned identifier is of type <literal>long</literal>, <literal>short</literal> or <literal>int</literal>" +#. Tag: para +#: basic_mapping.xml:574 +#, no-c-format +msgid "" +"uses a sequence in DB2, PostgreSQL, Oracle, SAP DB, McKoi or a generator in " +"Interbase. The returned identifier is of type <literal>long</literal>, " +"<literal>short</literal> or <literal>int</literal>" msgstr "" +"utiliza uma sequence em DB2, PostgreSQL, Oracle, SAP DB, McKoi ou um " +"generator no Interbase. O identificador de retorno é do tipo <literal> long</" +"literal>, <literal>short</literal> ou <literal>int</literal>." -#: index.docbook:582 +#. Tag: literal +#: basic_mapping.xml:582 +#, no-c-format msgid "hilo" -msgstr "" +msgstr "hilo" -#: index.docbook:584 -msgid "uses a hi/lo algorithm to efficiently generate identifiers of type <literal>long</literal>, <literal>short</literal> or <literal>int</literal>, given a table and column (by default <literal>hibernate_unique_key</literal> and <literal>next_hi</literal> respectively) as a source of hi values. The hi/lo algorithm generates identifiers that are unique only for a particular database." +#. Tag: para +#: basic_mapping.xml:584 +#, no-c-format +msgid "" +"uses a hi/lo algorithm to efficiently generate identifiers of type " +"<literal>long</literal>, <literal>short</literal> or <literal>int</literal>, " +"given a table and column (by default <literal>hibernate_unique_key</literal> " +"and <literal>next_hi</literal> respectively) as a source of hi values. The " +"hi/lo algorithm generates identifiers that are unique only for a particular " +"database." msgstr "" +"utiliza um algoritmo hi/lo para gerar de forma eficiente identificadores do " +"tipo <literal>long</literal>, <literal>short</literal> ou <literal>int</" +"literal>, a partir de uma tabela e coluna fornecida (por default " +"<literal>hibernate_unique_key</literal> e <literal>next_hi</literal>) como " +"fonte para os valores hi. O algoritmo hi/lo gera identificadores que são " +"únicos apenas para um banco de dados particular." -#: index.docbook:594 +#. Tag: literal +#: basic_mapping.xml:594 +#, no-c-format msgid "seqhilo" -msgstr "" +msgstr "seqhilo" -#: index.docbook:596 -msgid "uses a hi/lo algorithm to efficiently generate identifiers of type <literal>long</literal>, <literal>short</literal> or <literal>int</literal>, given a named database sequence." +#. Tag: para +#: basic_mapping.xml:596 +#, no-c-format +msgid "" +"uses a hi/lo algorithm to efficiently generate identifiers of type " +"<literal>long</literal>, <literal>short</literal> or <literal>int</literal>, " +"given a named database sequence." msgstr "" +"utiliza um algoritmo hi/lo para gerar de forma eficinete identificadores do " +"tipo <literal>long</literal>, <literal>short</literal> ou <literal>int</" +"literal>, a partir de uma sequence de banco de dados fornecida." -#: index.docbook:604 +#. Tag: literal +#: basic_mapping.xml:604 +#, no-c-format msgid "uuid" -msgstr "" +msgstr "uuid" -#: index.docbook:606 -msgid "uses a 128-bit UUID algorithm to generate identifiers of type string, unique within a network (the IP address is used). The UUID is encoded as a string of hexadecimal digits of length 32." +#. Tag: para +#: basic_mapping.xml:606 +#, no-c-format +msgid "" +"uses a 128-bit UUID algorithm to generate identifiers of type string, unique " +"within a network (the IP address is used). The UUID is encoded as a string " +"of hexadecimal digits of length 32." msgstr "" +"utiliza um algortimo UUID de 128-bits para gerar identificadores do tipo " +"string, unicos em uma rede(o endereço IP é utilizado). O UUID é codificado " +"como um string de digitos hexadecimais de tamanho 32." -#: index.docbook:614 +#. Tag: literal +#: basic_mapping.xml:614 +#, no-c-format msgid "guid" -msgstr "" +msgstr "guid" -#: index.docbook:616 +#. Tag: para +#: basic_mapping.xml:616 +#, no-c-format msgid "uses a database-generated GUID string on MS SQL Server and MySQL." msgstr "" +"utiliza um string GUID gerado pelo banco de dados no MS SQL Server e MySQL." -#: index.docbook:622 +#. Tag: literal +#: basic_mapping.xml:622 +#, no-c-format msgid "native" -msgstr "" +msgstr "native" -#: index.docbook:624 -msgid "picks <literal>identity</literal>, <literal>sequence</literal> or <literal>hilo</literal> depending upon the capabilities of the underlying database." +#. Tag: para +#: basic_mapping.xml:624 +#, no-c-format +msgid "" +"picks <literal>identity</literal>, <literal>sequence</literal> or " +"<literal>hilo</literal> depending upon the capabilities of the underlying " +"database." msgstr "" +"seleciona entre <literal>identity</literal>, <literal>sequence</literal> ou " +"<literal>hilo</literal> dependendo das capacidades do banco de dados " +"utilizado." -#: index.docbook:632 +#. Tag: literal +#: basic_mapping.xml:632 +#, no-c-format msgid "assigned" -msgstr "" +msgstr "assigned" -#: index.docbook:634 -msgid "lets the application to assign an identifier to the object before <literal>save()</literal> is called. This is the default strategy if no <literal><generator></literal> element is specified." +#. Tag: para +#: basic_mapping.xml:634 +#, no-c-format +msgid "" +"lets the application to assign an identifier to the object before " +"<literal>save()</literal> is called. This is the default strategy if no " +"<literal><generator></literal> element is specified." msgstr "" +"deixa a aplicação definir um identificador para o objeto antes que o " +"<literal>save()</literal> seja chamado. Esta é a estratégia default se " +"nenhum elemento <literal><generator></literal> é especificado." -#: index.docbook:642 +#. Tag: literal +#: basic_mapping.xml:642 +#, no-c-format msgid "select" -msgstr "" +msgstr "select" -#: index.docbook:644 -msgid "retrieves a primary key assigned by a database trigger by selecting the row by some unique key and retrieving the primary key value." +#. Tag: para +#: basic_mapping.xml:644 +#, no-c-format +msgid "" +"retrieves a primary key assigned by a database trigger by selecting the row " +"by some unique key and retrieving the primary key value." msgstr "" +"retorna a chave primaria recuperada por uma trigger do banco de dados, " +"selecionado uma linha pela chave única e recuperando o valor da chave " +"primária." -#: index.docbook:651 +#. Tag: literal +#: basic_mapping.xml:651 +#, no-c-format msgid "foreign" -msgstr "" +msgstr "foreign" -#: index.docbook:653 -msgid "uses the identifier of another associated object. Usually used in conjunction with a <literal><one-to-one></literal> primary key association." +#. Tag: para +#: basic_mapping.xml:653 +#, no-c-format +msgid "" +"uses the identifier of another associated object. Usually used in " +"conjunction with a <literal><one-to-one></literal> primary key " +"association." msgstr "" +"utiliza o identificador de um outro objeto associado. Normalmente utilizado " +"em conjunto com uma associaçõa de chave primária do tipo <literal><one-to-" +"one></literal>." -#: index.docbook:660 +#. Tag: literal +#: basic_mapping.xml:660 +#, no-c-format msgid "sequence-identity" -msgstr "" +msgstr "sequence-identity" -#: index.docbook:662 -msgid "a specialized sequence generation strategy which utilizes a database sequence for the actual value generation, but combines this with JDBC3 getGeneratedKeys to actually return the generated identifier value as part of the insert statement execution. This strategy is only known to be supported on Oracle 10g drivers targetted for JDK 1.4. Note comments on these insert statements are disabled due to a bug in the Oracle drivers." +#. Tag: para +#: basic_mapping.xml:662 +#, no-c-format +msgid "" +"a specialized sequence generation strategy which utilizes a database " +"sequence for the actual value generation, but combines this with JDBC3 " +"getGeneratedKeys to actually return the generated identifier value as part " +"of the insert statement execution. This strategy is only known to be " +"supported on Oracle 10g drivers targetted for JDK 1.4. Note comments on " +"these insert statements are disabled due to a bug in the Oracle drivers." msgstr "" +"a specialized sequence generation strategy which utilizes a database " +"sequence for the actual value generation, but combines this with JDBC3 " +"getGeneratedKeys to actually return the generated identifier value as part " +"of the insert statement execution. This strategy is only known to be " +"supported on Oracle 10g drivers targetted for JDK 1.4. Note comments on " +"these insert statements are disabled due to a bug in the Oracle drivers." -#: index.docbook:679 +#. Tag: title +#: basic_mapping.xml:679 +#, no-c-format msgid "Hi/lo algorithm" -msgstr "" +msgstr "Algoritmo Hi/lo" -#: index.docbook:680 -msgid "The <literal>hilo</literal> and <literal>seqhilo</literal> generators provide two alternate implementations of the hi/lo algorithm, a favorite approach to identifier generation. The first implementation requires a \"special\" database table to hold the next available \"hi\" value. The second uses an Oracle-style sequence (where supported)." +#. Tag: para +#: basic_mapping.xml:680 +#, no-c-format +msgid "" +"The <literal>hilo</literal> and <literal>seqhilo</literal> generators " +"provide two alternate implementations of the hi/lo algorithm, a favorite " +"approach to identifier generation. The first implementation requires a " +"\"special\" database table to hold the next available \"hi\" value. The " +"second uses an Oracle-style sequence (where supported)." msgstr "" +"Os geradores <literal>hilo</literal> e <literal>seqhilo</literal> fornecem " +"duas implementações alternativas do algoritmo hi/lo, uma solução " +"preferencial para a geração de identificadores. A primeira implementação " +"requer uma tabela especial do banco de dados para manter o proximo valor \"hi" +"\" disponível. A segunda utiliza uma seqüência do estilo Oracle (quando " +"suportado)." -#: index.docbook:687 +#. Tag: programlisting +#: basic_mapping.xml:687 +#, no-c-format msgid "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"cat_id\">\n" - " <generator class=\"hilo\">\n" - " <param name=\"table\">hi_value</param>\n" - " <param name=\"column\">next_value</param>\n" - " <param name=\"max_lo\">100</param>\n" - " </generator>\n" - "</id>]]>" +"<![CDATA[<id name=\"id\" type=\"long\" column=\"cat_id\">\n" +" <generator class=\"hilo\">\n" +" <param name=\"table\">hi_value</param>\n" +" <param name=\"column\">next_value</param>\n" +" <param name=\"max_lo\">100</param>\n" +" </generator>\n" +"</id>]]>" msgstr "" -#: index.docbook:689 +#. Tag: programlisting +#: basic_mapping.xml:689 +#, no-c-format msgid "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"cat_id\">\n" - " <generator class=\"seqhilo\">\n" - " <param name=\"sequence\">hi_value</param>\n" - " <param name=\"max_lo\">100</param>\n" - " </generator>\n" - "</id>]]>" +"<![CDATA[<id name=\"id\" type=\"long\" column=\"cat_id\">\n" +" <generator class=\"seqhilo\">\n" +" <param name=\"sequence\">hi_value</param>\n" +" <param name=\"max_lo\">100</param>\n" +" </generator>\n" +"</id>]]>" msgstr "" -#: index.docbook:691 -msgid "Unfortunately, you can't use <literal>hilo</literal> when supplying your own <literal>Connection</literal> to Hibernate. When Hibernate is using an application server datasource to obtain connections enlisted with JTA, you must properly configure the <literal>hibernate.transaction.manager_lookup_class</literal>." +#. Tag: para +#: basic_mapping.xml:691 +#, no-c-format +msgid "" +"Unfortunately, you can't use <literal>hilo</literal> when supplying your own " +"<literal>Connection</literal> to Hibernate. When Hibernate is using an " +"application server datasource to obtain connections enlisted with JTA, you " +"must properly configure the <literal>hibernate.transaction." +"manager_lookup_class</literal>." msgstr "" +"Infelizemente, voce não pode utilizar <literal>hilo</literal> quando estiver " +"fornecendo sia propria <literal>Connection</literal> para o Hibernate. " +"Quando o Hibernate está usando um datasource do servidor de aplicações para " +"obter conexões suportadas com JTA, você precisa configurar adequadamente o " +"<literal>hibernate.transaction.manager_lookup_class</literal>." -#: index.docbook:700 +#. Tag: title +#: basic_mapping.xml:700 +#, no-c-format msgid "UUID algorithm" -msgstr "" +msgstr "UUID algorithm" -#: index.docbook:701 -msgid "The UUID contains: IP address, startup time of the JVM (accurate to a quarter second), system time and a counter value (unique within the JVM). It's not possible to obtain a MAC address or memory address from Java code, so this is the best we can do without using JNI." +#. Tag: para +#: basic_mapping.xml:701 +#, no-c-format +msgid "" +"The UUID contains: IP address, startup time of the JVM (accurate to a " +"quarter second), system time and a counter value (unique within the JVM). " +"It's not possible to obtain a MAC address or memory address from Java code, " +"so this is the best we can do without using JNI." msgstr "" +"O UUID contem: o endereço IP, hora de inicio da JVM (com precisão de um " +"quarto de segundo), a hora do sistema e um valor contador (unico dentro da " +"JVM). Não é possivel obter o endereço MAC ou um endereço de memória do " +"código Java, assim este é o melhor que pode ser feito sem utilizar JNI." -#: index.docbook:710 +#. Tag: title +#: basic_mapping.xml:710 +#, no-c-format msgid "Identity columns and sequences" -msgstr "" +msgstr "Colunas de identidade e sequencias" -#: index.docbook:711 -msgid "For databases which support identity columns (DB2, MySQL, Sybase, MS SQL), you may use <literal>identity</literal> key generation. For databases that support sequences (DB2, Oracle, PostgreSQL, Interbase, McKoi, SAP DB) you may use <literal>sequence</literal> style key generation. Both these strategies require two SQL queries to insert a new object." +#. Tag: para +#: basic_mapping.xml:711 +#, no-c-format +msgid "" +"For databases which support identity columns (DB2, MySQL, Sybase, MS SQL), " +"you may use <literal>identity</literal> key generation. For databases that " +"support sequences (DB2, Oracle, PostgreSQL, Interbase, McKoi, SAP DB) you " +"may use <literal>sequence</literal> style key generation. Both these " +"strategies require two SQL queries to insert a new object." msgstr "" +"Para bancos de dados que suportam colunas de identidade (DB2, MySQL, Sybase, " +"MS SQL), você pode utilizar uma geração de chave <literal>identity</" +"literal>. Para bancos de dados que suportam sequencias (DB2, Oracle, " +"PostgreSQL, Interbase, McKoi, SAP DB) voce pode utilizar a geração de chaves " +"no estilo <literal>sequence</literal>. As duas estratégias requerem duas " +"consultas SQL para inserir um novo objeto." -#: index.docbook:719 +#. Tag: programlisting +#: basic_mapping.xml:719 +#, no-c-format msgid "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"person_id\">\n" - " <generator class=\"sequence\">\n" - " <param name=\"sequence\">person_id_sequence</param>\n" - " </generator>\n" - "</id>]]>" +"<![CDATA[<id name=\"id\" type=\"long\" column=\"person_id\">\n" +" <generator class=\"sequence\">\n" +" <param name=\"sequence\">person_id_sequence</param>\n" +" </generator>\n" +"</id>]]>" msgstr "" -#: index.docbook:721 +#. Tag: programlisting +#: basic_mapping.xml:721 +#, no-c-format msgid "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"person_id\" unsaved-value=\"0\">\n" - " <generator class=\"identity\"/>\n" - "</id>]]>" +"<![CDATA[<id name=\"id\" type=\"long\" column=\"person_id\" unsaved-value=\"0" +"\">\n" +" <generator class=\"identity\"/>\n" +"</id>]]>" msgstr "" -#: index.docbook:723 -msgid "For cross-platform development, the <literal>native</literal> strategy will choose from the <literal>identity</literal>, <literal>sequence</literal> and <literal>hilo</literal> strategies, dependant upon the capabilities of the underlying database." +#. Tag: para +#: basic_mapping.xml:723 +#, no-c-format +msgid "" +"For cross-platform development, the <literal>native</literal> strategy will " +"choose from the <literal>identity</literal>, <literal>sequence</literal> and " +"<literal>hilo</literal> strategies, dependant upon the capabilities of the " +"underlying database." msgstr "" +"Para desenvolvimento multi-plataforma, a estratégia <literal>native</" +"literal> irá escolher entre as estratégias i <literal>identity</literal>, " +"<literal>sequence</literal> e <literal>hilo</literal>, dependendo das " +"capacidades do banco de dados utilizado." -#: index.docbook:732 +#. Tag: title +#: basic_mapping.xml:732 +#, no-c-format msgid "Assigned identifiers" -msgstr "" +msgstr "Identificadores especificados" -#: index.docbook:733 -msgid "If you want the application to assign identifiers (as opposed to having Hibernate generate them), you may use the <literal>assigned</literal> generator. This special generator will use the identifier value already assigned to the object's identifier property. This generator is used when the primary key is a natural key instead of a surrogate key. This is the default behavior if you do no specify a <literal><generator></literal> element." +#. Tag: para +#: basic_mapping.xml:733 +#, no-c-format +msgid "" +"If you want the application to assign identifiers (as opposed to having " +"Hibernate generate them), you may use the <literal>assigned</literal> " +"generator. This special generator will use the identifier value already " +"assigned to the object's identifier property. This generator is used when " +"the primary key is a natural key instead of a surrogate key. This is the " +"default behavior if you do no specify a <literal><generator></literal> " +"element." msgstr "" +"Se você quer que a aplicação especifique os identificadores (em vez do " +"Hibernate gerá-los) você deve utilizar o gerador <literal>assigned</" +"literal>. Este gerador especial irá utilizar o valor do identificador " +"especificado para a propriedade de identificação do objeto. Este gerador é " +"usado quando a chave primaria é a chave natural em vez de uma surrogate key. " +"Este é o comportamento padrão se você não especificar um elemento " +"<literal><generator></literal>." -#: index.docbook:742 -msgid "Choosing the <literal>assigned</literal> generator makes Hibernate use <literal>unsaved-value=\"undefined\"</literal>, forcing Hibernate to go to the database to determine if an instance is transient or detached, unless there is a version or timestamp property, or you define <literal>Interceptor.isUnsaved()</literal>." +#. Tag: para +#: basic_mapping.xml:742 +#, no-c-format +msgid "" +"Choosing the <literal>assigned</literal> generator makes Hibernate use " +"<literal>unsaved-value=\"undefined\"</literal>, forcing Hibernate to go to " +"the database to determine if an instance is transient or detached, unless " +"there is a version or timestamp property, or you define <literal>Interceptor." +"isUnsaved()</literal>." msgstr "" +"Escolher o gerador <literal>assigned</literal> faz com que o Hibernate " +"utilize <literal>unsaved-value=\"undefined\"</literal>, forçando o Hibernate " +"ir até o banco de dados para determinar se uma instância está transiente ou " +"desasociada, a menos que haja uma versão ou uma propriedade timestamp, ou " +"você pode definir <literal>Interceptor.isUnsaved()</literal>." -#: index.docbook:752 +#. Tag: title +#: basic_mapping.xml:752 +#, no-c-format msgid "Primary keys assigned by triggers" -msgstr "" +msgstr "Chaves primárias geradas por triggers" -#: index.docbook:753 -msgid "For legacy schemas only (Hibernate does not generate DDL with triggers)." -msgstr "" +#. Tag: para +#: basic_mapping.xml:753 +#, no-c-format +msgid "" +"For legacy schemas only (Hibernate does not generate DDL with triggers)." +msgstr "Apenas para sistemas legados (o Hibernate nao gera DDL com triggers)." -#: index.docbook:757 +#. Tag: programlisting +#: basic_mapping.xml:757 +#, no-c-format msgid "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"person_id\">\n" - " <generator class=\"select\">\n" - " <param name=\"key\">socialSecurityNumber</param>\n" - " </generator>\n" - "</id>]]>" +"<![CDATA[<id name=\"id\" type=\"long\" column=\"person_id\">\n" +" <generator class=\"select\">\n" +" <param name=\"key\">socialSecurityNumber</param>\n" +" </generator>\n" +"</id>]]>" msgstr "" -#: index.docbook:759 -msgid "In the above example, there is a unique valued property named <literal>socialSecurityNumber</literal> defined by the class, as a natural key, and a surrogate key named <literal>person_id</literal> whose value is generated by a trigger." +#. Tag: para +#: basic_mapping.xml:759 +#, no-c-format +msgid "" +"In the above example, there is a unique valued property named " +"<literal>socialSecurityNumber</literal> defined by the class, as a natural " +"key, and a surrogate key named <literal>person_id</literal> whose value is " +"generated by a trigger." msgstr "" +"No exemplo acima, há uma única propriedade com valor nomeada " +"<literal>socialSecurityNumber</literal> definida pela classe, uma chave " +"natural, e uma surrogate key nomeada <literal>person_id</literal> cujo valor " +"é gerado pro uma trigger." -#: index.docbook:771 +#. Tag: title +#: basic_mapping.xml:771 +#, no-c-format msgid "Enhanced identifier generators" -msgstr "" +msgstr "Enhanced identifier generators" -#: index.docbook:773 -msgid "Starting with release 3.2.3, there are 2 new generators which represent a re-thinking of 2 different aspects of identifier generation. The first aspect is database portability; the second is optimization (not having to query the database for every request for a new identifier value). These two new generators are intended to take the place of some of the named generators described above (starting in 3.3.x); however, they are included in the current releases and can be referenced by FQN." +#. Tag: para +#: basic_mapping.xml:773 +#, no-c-format +msgid "" +"Starting with release 3.2.3, there are 2 new generators which represent a re-" +"thinking of 2 different aspects of identifier generation. The first aspect " +"is database portability; the second is optimization (not having to query the " +"database for every request for a new identifier value). These two new " +"generators are intended to take the place of some of the named generators " +"described above (starting in 3.3.x); however, they are included in the " +"current releases and can be referenced by FQN." msgstr "" +"Starting with release 3.2.3, there are 2 new generators which represent a re-" +"thinking of 2 different aspects of identifier generation. The first aspect " +"is database portability; the second is optimization (not having to query the " +"database for every request for a new identifier value). These two new " +"generators are intended to take the place of some of the named generators " +"described above (starting in 3.3.x); however, they are included in the " +"current releases and can be referenced by FQN." -#: index.docbook:781 -msgid "The first of these new generators is <literal>org.hibernate.id.enhanced.SequenceStyleGenerator</literal> which is intended firstly as a replacement for the <literal>sequence</literal> generator and secondly as a better portability generator than <literal>native</literal> (because <literal>native</literal> (generally) chooses between <literal>identity</literal> and <literal>sequence</literal> which have largely different semantics which can cause subtle isssues in applications eyeing portability). <literal>org.hibernate.id.enhanced.SequenceStyleGenerator</literal> however achieves portability in a different manner. It chooses between using a table or a sequence in the database to store its incrementing values depending on the capabilities of the dialect being used. The difference between this and <literal>native</literal> is that table-based and sequence-based storage have the same exact semantic (in fact sequences are exactly what Hibernate tries to emmulate with its! table-based generators). This generator has a number of configuration parameters:" +#. Tag: para +#: basic_mapping.xml:781 +#, fuzzy, no-c-format +msgid "" +"The first of these new generators is <literal>org.hibernate.id.enhanced." +"SequenceStyleGenerator</literal> which is intended firstly as a replacement " +"for the <literal>sequence</literal> generator and secondly as a better " +"portability generator than <literal>native</literal> (because " +"<literal>native</literal> (generally) chooses between <literal>identity</" +"literal> and <literal>sequence</literal> which have largely different " +"semantics which can cause subtle isssues in applications eyeing " +"portability). <literal>org.hibernate.id.enhanced.SequenceStyleGenerator</" +"literal> however achieves portability in a different manner. It chooses " +"between using a table or a sequence in the database to store its " +"incrementing values depending on the capabilities of the dialect being used. " +"The difference between this and <literal>native</literal> is that table-" +"based and sequence-based storage have the same exact semantic (in fact " +"sequences are exactly what Hibernate tries to emmulate with its table-based " +"generators). This generator has a number of configuration parameters:" msgstr "" +"The first of these new generators is <literal>org.hibernate.id.enhanced." +"SequenceStyleGenerator</literal> which is intended firstly as a replacement " +"for the <literal>sequence</literal> generator and secondly as a better " +"portability generator than <literal>native</literal> (because " +"<literal>native</literal> (generally) chooses between <literal>identity</" +"literal> and <literal>sequence</literal> which have largely different " +"semantics which can cause subtle isssues in applications eyeing " +"portability). <literal>org.hibernate.id.enhanced.SequenceStyleGenerator</" +"literal> however achieves portability in a different manner. It chooses " +"between using a table or a sequence in the database to store its " +"incrementing values depending on the capabilities of the dialect being used. " +"The difference between this and <literal>native</literal> is that table-" +"based and sequence-based storage have the same exact semantic (in fact " +"sequences are exactly what Hibernate tries to emmulate with its table-based " +"generators). This generator has a number of configuration parameters: " +"<placeholder-1/>" -#: index.docbook:795 -msgid "<literal>sequence_name</literal> (optional, defaults to <literal>hibernate_sequence</literal>): The name of the sequence (or table) to be used." +#. Tag: para +#: basic_mapping.xml:795 +#, no-c-format +msgid "" +"<literal>sequence_name</literal> (optional, defaults to " +"<literal>hibernate_sequence</literal>): The name of the sequence (or table) " +"to be used." msgstr "" +"<literal>sequence_name</literal> (optional, defaults to " +"<literal>hibernate_sequence</literal>): The name of the sequence (or table) " +"to be used." -#: index.docbook:801 -msgid "<literal>initial_value</literal> (optional, defaults to <literal>1</literal>): The initial value to be retrieved from the sequence/table. In sequence creation terms, this is analogous to the clause typical named \"STARTS WITH\"." +#. Tag: para +#: basic_mapping.xml:801 +#, no-c-format +msgid "" +"<literal>initial_value</literal> (optional, defaults to <literal>1</" +"literal>): The initial value to be retrieved from the sequence/table. In " +"sequence creation terms, this is analogous to the clause typical named " +"\"STARTS WITH\"." msgstr "" +"<literal>initial_value</literal> (optional, defaults to <literal>1</" +"literal>): The initial value to be retrieved from the sequence/table. In " +"sequence creation terms, this is analogous to the clause typical named " +"\"STARTS WITH\"." -#: index.docbook:808 -msgid "<literal>increment_size</literal> (optional, defaults to <literal>1</literal>): The value by which subsequent calls to the sequence/table should differ. In sequence creation terms, this is analogous to the clause typical named \"INCREMENT BY\"." +#. Tag: para +#: basic_mapping.xml:808 +#, no-c-format +msgid "" +"<literal>increment_size</literal> (optional, defaults to <literal>1</" +"literal>): The value by which subsequent calls to the sequence/table should " +"differ. In sequence creation terms, this is analogous to the clause typical " +"named \"INCREMENT BY\"." msgstr "" +"<literal>increment_size</literal> (optional, defaults to <literal>1</" +"literal>): The value by which subsequent calls to the sequence/table should " +"differ. In sequence creation terms, this is analogous to the clause typical " +"named \"INCREMENT BY\"." -#: index.docbook:815 -msgid "<literal>force_table_use</literal> (optional, defaults to <literal>false</literal>): Should we force the use of a table as the backing structure even though the dialect might support sequence?" +#. Tag: para +#: basic_mapping.xml:815 +#, no-c-format +msgid "" +"<literal>force_table_use</literal> (optional, defaults to <literal>false</" +"literal>): Should we force the use of a table as the backing structure even " +"though the dialect might support sequence?" msgstr "" +"<literal>force_table_use</literal> (optional, defaults to <literal>false</" +"literal>): Should we force the use of a table as the backing structure even " +"though the dialect might support sequence?" -#: index.docbook:822 -msgid "<literal>value_column</literal> (optional, defaults to <literal>next_val</literal>): Only relevant for table structures! The name of the column on the table which is used to hold the value." +#. Tag: para +#: basic_mapping.xml:822 +#, no-c-format +msgid "" +"<literal>value_column</literal> (optional, defaults to <literal>next_val</" +"literal>): Only relevant for table structures! The name of the column on the " +"table which is used to hold the value." msgstr "" +"<literal>value_column</literal> (optional, defaults to <literal>next_val</" +"literal>): Only relevant for table structures! The name of the column on the " +"table which is used to hold the value." -#: index.docbook:829 -msgid "<literal>optimizer</literal> (optional, defaults to <literal>none</literal>): See" +#. Tag: para +#: basic_mapping.xml:829 +#, fuzzy, no-c-format +msgid "" +"<literal>optimizer</literal> (optional, defaults to <literal>none</" +"literal>): See" msgstr "" +"<literal>cascade</literal> (opcional – valor default <literal>none</" +"literal>): o estilo do cascade." -#: index.docbook:836 -msgid "The second of these new generators is <literal>org.hibernate.id.enhanced.TableGenerator</literal> which is intended firstly as a replacement for the <literal>table</literal> generator (although it actually functions much more like <literal>org.hibernate.id.MultipleHiLoPerTableGenerator</literal>) and secondly as a re-implementation of <literal>org.hibernate.id.MultipleHiLoPerTableGenerator</literal> utilizing the notion of pluggable optimiziers. Essentially this generator defines a table capable of holding a number of different increment values simultaneously by using multiple distinctly keyed rows. This generator has a number of configuration parameters:" +#. Tag: para +#: basic_mapping.xml:836 +#, fuzzy, no-c-format +msgid "" +"The second of these new generators is <literal>org.hibernate.id.enhanced." +"TableGenerator</literal> which is intended firstly as a replacement for the " +"<literal>table</literal> generator (although it actually functions much more " +"like <literal>org.hibernate.id.MultipleHiLoPerTableGenerator</literal>) and " +"secondly as a re-implementation of <literal>org.hibernate.id." +"MultipleHiLoPerTableGenerator</literal> utilizing the notion of pluggable " +"optimiziers. Essentially this generator defines a table capable of holding a " +"number of different increment values simultaneously by using multiple " +"distinctly keyed rows. This generator has a number of configuration " +"parameters:" msgstr "" +"The second of these new generators is <literal>org.hibernate.id.enhanced." +"TableGenerator</literal> which is intended firstly as a replacement for the " +"<literal>table</literal> generator (although it actually functions much more " +"like <literal>org.hibernate.id.MultipleHiLoPerTableGenerator</literal>) and " +"secondly as a re-implementation of <literal>org.hibernate.id." +"MultipleHiLoPerTableGenerator</literal> utilizing the notion of pluggable " +"optimiziers. Essentially this generator defines a table capable of holding a " +"number of different increment values simultaneously by using multiple " +"distinctly keyed rows. This generator has a number of configuration " +"parameters: <placeholder-1/>" -#: index.docbook:846 -msgid "<literal>table_name</literal> (optional, defaults to <literal>hibernate_sequences</literal>): The name of the table to be used." +#. Tag: para +#: basic_mapping.xml:846 +#, no-c-format +msgid "" +"<literal>table_name</literal> (optional, defaults to " +"<literal>hibernate_sequences</literal>): The name of the table to be used." msgstr "" +"<literal>table_name</literal> (optional, defaults to " +"<literal>hibernate_sequences</literal>): The name of the table to be used." -#: index.docbook:852 -msgid "<literal>value_column_name</literal> (optional, defaults to <literal>next_val</literal>): The name of the column on the table which is used to hold the value." +#. Tag: para +#: basic_mapping.xml:852 +#, no-c-format +msgid "" +"<literal>value_column_name</literal> (optional, defaults to " +"<literal>next_val</literal>): The name of the column on the table which is " +"used to hold the value." msgstr "" +"<literal>value_column_name</literal> (optional, defaults to " +"<literal>next_val</literal>): The name of the column on the table which is " +"used to hold the value." -#: index.docbook:858 -msgid "<literal>segment_column_name</literal> (optional, defaults to <literal>sequence_name</literal>): The name of the column on the table which is used to hold the \"segement key\". This is the value which distinctly identifies which increment value to use." +#. Tag: para +#: basic_mapping.xml:858 +#, no-c-format +msgid "" +"<literal>segment_column_name</literal> (optional, defaults to " +"<literal>sequence_name</literal>): The name of the column on the table which " +"is used to hold the \"segement key\". This is the value which distinctly " +"identifies which increment value to use." msgstr "" +"<literal>segment_column_name</literal> (optional, defaults to " +"<literal>sequence_name</literal>): The name of the column on the table which " +"is used to hold the \"segement key\". This is the value which distinctly " +"identifies which increment value to use." -#: index.docbook:865 -msgid "<literal>segment_value</literal> (optional, defaults to <literal>default</literal>): The \"segment key\" value for the segment from which we want to pull increment values for this generator." +#. Tag: para +#: basic_mapping.xml:865 +#, no-c-format +msgid "" +"<literal>segment_value</literal> (optional, defaults to <literal>default</" +"literal>): The \"segment key\" value for the segment from which we want to " +"pull increment values for this generator." msgstr "" +"<literal>segment_value</literal> (optional, defaults to <literal>default</" +"literal>): The \"segment key\" value for the segment from which we want to " +"pull increment values for this generator." -#: index.docbook:872 -msgid "<literal>segment_value_length</literal> (optional, defaults to <literal>255</literal>): Used for schema generation; the column size to create this segment key column." +#. Tag: para +#: basic_mapping.xml:872 +#, no-c-format +msgid "" +"<literal>segment_value_length</literal> (optional, defaults to <literal>255</" +"literal>): Used for schema generation; the column size to create this " +"segment key column." msgstr "" +"<literal>segment_value_length</literal> (optional, defaults to <literal>255</" +"literal>): Used for schema generation; the column size to create this " +"segment key column." -#: index.docbook:878 -msgid "<literal>initial_value</literal> (optional, defaults to <literal>1</literal>): The initial value to be retrieved from the table." +#. Tag: para +#: basic_mapping.xml:878 +#, no-c-format +msgid "" +"<literal>initial_value</literal> (optional, defaults to <literal>1</" +"literal>): The initial value to be retrieved from the table." msgstr "" +"<literal>initial_value</literal> (optional, defaults to <literal>1</" +"literal>): The initial value to be retrieved from the table." -#: index.docbook:884 -msgid "<literal>increment_size</literal> (optional, defaults to <literal>1</literal>): The value by which subsequent calls to the table should differ." +#. Tag: para +#: basic_mapping.xml:884 +#, no-c-format +msgid "" +"<literal>increment_size</literal> (optional, defaults to <literal>1</" +"literal>): The value by which subsequent calls to the table should differ." msgstr "" +"<literal>increment_size</literal> (optional, defaults to <literal>1</" +"literal>): The value by which subsequent calls to the table should differ." -#: index.docbook:890 -msgid "<literal>optimizer</literal> (optional, defaults to <literal></literal>): See" +#. Tag: para +#: basic_mapping.xml:890 +#, fuzzy, no-c-format +msgid "" +"<literal>optimizer</literal> (optional, defaults to <literal></literal>): See" msgstr "" +"<literal>cascade</literal> (opcional – valor default <literal>none</" +"literal>): o estilo do cascade." -#: index.docbook:900 +#. Tag: title +#: basic_mapping.xml:900 +#, no-c-format msgid "Identifier generator optimization" -msgstr "" +msgstr "Identifier generator optimization" -#: index.docbook:901 -msgid "For identifier generators which store values in the database, it is inefficient for them to hit the database on each and every call to generate a new identifier value. Instead, you'd ideally want to group a bunch of them in memory and only hit the database when you have exhausted your in-memory value group. This is the role of the pluggable optimizers. Currently only the two enhanced generators (<xref linkend=\"mapping-declaration-id-enhanced\"/> support this notion." +#. Tag: para +#: basic_mapping.xml:901 +#, fuzzy, no-c-format +msgid "" +"For identifier generators which store values in the database, it is " +"inefficient for them to hit the database on each and every call to generate " +"a new identifier value. Instead, you'd ideally want to group a bunch of them " +"in memory and only hit the database when you have exhausted your in-memory " +"value group. This is the role of the pluggable optimizers. Currently only " +"the two enhanced generators (<xref linkend=\"mapping-declaration-id-enhanced" +"\"/> support this notion." msgstr "" +"For identifier generators which store values in the database, it is " +"inefficient for them to hit the database on each and every call to generate " +"a new identifier value. Instead, you'd ideally want to group a bunch of them " +"in memory and only hit the database when you have exhausted your in-memory " +"value group. This is the role of the pluggable optimizers. Currently only " +"the two enhanced generators (<xref linkend=\"mapping-declaration-id-enhanced" +"\"/> support this notion. <placeholder-1/>" -#: index.docbook:909 -msgid "<literal>none</literal> (generally this is the default if no optimizer was specified): This says to not perform any optimizations, and hit the database each and every request." +#. Tag: para +#: basic_mapping.xml:909 +#, no-c-format +msgid "" +"<literal>none</literal> (generally this is the default if no optimizer was " +"specified): This says to not perform any optimizations, and hit the database " +"each and every request." msgstr "" +"<literal>none</literal> (generally this is the default if no optimizer was " +"specified): This says to not perform any optimizations, and hit the database " +"each and every request." -#: index.docbook:915 -msgid "<literal>hilo</literal>: applies a hi/lo algorithm around the database retrieved values. The values from the database for this optimizer are expected to be sequential. The values retrieved from the database structure for this optimizer indicates the \"group number\"; the <literal>increment_size</literal> is multiplied by that value in memory to define a group \"hi value\"." +#. Tag: para +#: basic_mapping.xml:915 +#, no-c-format +msgid "" +"<literal>hilo</literal>: applies a hi/lo algorithm around the database " +"retrieved values. The values from the database for this optimizer are " +"expected to be sequential. The values retrieved from the database structure " +"for this optimizer indicates the \"group number\"; the " +"<literal>increment_size</literal> is multiplied by that value in memory to " +"define a group \"hi value\"." msgstr "" +"<literal>hilo</literal>: applies a hi/lo algorithm around the database " +"retrieved values. The values from the database for this optimizer are " +"expected to be sequential. The values retrieved from the database structure " +"for this optimizer indicates the \"group number\"; the " +"<literal>increment_size</literal> is multiplied by that value in memory to " +"define a group \"hi value\"." -#: index.docbook:924 -msgid "<literal>pooled</literal>: like was discussed for <literal>hilo</literal>, this optimizers attempts to minimize the number of hits to the database. Here, however, we simply store the starting value for the \"next group\" into the database structure rather than a sequential value in combination with an in-memory grouping algorithm. <literal>increment_size</literal> here refers to the values coming from the database." +#. Tag: para +#: basic_mapping.xml:924 +#, no-c-format +msgid "" +"<literal>pooled</literal>: like was discussed for <literal>hilo</literal>, " +"this optimizers attempts to minimize the number of hits to the database. " +"Here, however, we simply store the starting value for the \"next group\" " +"into the database structure rather than a sequential value in combination " +"with an in-memory grouping algorithm. <literal>increment_size</literal> here " +"refers to the values coming from the database." msgstr "" +"<literal>pooled</literal>: like was discussed for <literal>hilo</literal>, " +"this optimizers attempts to minimize the number of hits to the database. " +"Here, however, we simply store the starting value for the \"next group\" " +"into the database structure rather than a sequential value in combination " +"with an in-memory grouping algorithm. <literal>increment_size</literal> here " +"refers to the values coming from the database." -#: index.docbook:937 +#. Tag: title +#: basic_mapping.xml:937 +#, no-c-format msgid "composite-id" -msgstr "" +msgstr "composite-id" -#: index.docbook:939 +#. Tag: programlisting +#: basic_mapping.xml:939 +#, no-c-format msgid "" - "<![CDATA[<composite-id\n" - " name=\"propertyName\"\n" - " class=\"ClassName\"\n" - " mapped=\"true|false\"\n" - " access=\"field|property|ClassName\">\n" - " node=\"element-name|.\"\n" - "\n" - " <key-property name=\"propertyName\" type=\"typename\" column=\"column_name\"/>\n" - " <key-many-to-one name=\"propertyName class=\"ClassName\" column=\"column_name\"/>\n" - " ......\n" - "</composite-id>]]>" +"<![CDATA[<composite-id\n" +" name=\"propertyName\"\n" +" class=\"ClassName\"\n" +" mapped=\"true|false\"\n" +" access=\"field|property|ClassName\">\n" +" node=\"element-name|.\"\n" +"\n" +" <key-property name=\"propertyName\" type=\"typename\" column=" +"\"column_name\"/>\n" +" <key-many-to-one name=\"propertyName class=\"ClassName\" column=" +"\"column_name\"/>\n" +" ......\n" +"</composite-id>]]>" msgstr "" -#: index.docbook:941 -msgid "For a table with a composite key, you may map multiple properties of the class as identifier properties. The <literal><composite-id></literal> element accepts <literal><key-property></literal> property mappings and <literal><key-many-to-one></literal> mappings as child elements." +#. Tag: para +#: basic_mapping.xml:941 +#, no-c-format +msgid "" +"For a table with a composite key, you may map multiple properties of the " +"class as identifier properties. The <literal><composite-id></literal> " +"element accepts <literal><key-property></literal> property mappings " +"and <literal><key-many-to-one></literal> mappings as child elements." msgstr "" +"Para tabelas com uma chave composta, você pode mapear múltiplas propriedades " +"da classe como propriedades de identificação. O elemento <literal><" +"composite-id></literal> aceita o mapeamento da propriedade <literal><" +"key-property></literal> e mapeamentos <literal><key-many-to-one></" +"literal>como elements filhos." -#: index.docbook:948 +#. Tag: programlisting +#: basic_mapping.xml:948 +#, no-c-format msgid "" - "<![CDATA[<composite-id>\n" - " <key-property name=\"medicareNumber\"/>\n" - " <key-property name=\"dependent\"/>\n" - "</composite-id>]]>" +"<![CDATA[<composite-id>\n" +" <key-property name=\"medicareNumber\"/>\n" +" <key-property name=\"dependent\"/>\n" +"</composite-id>]]>" msgstr "" -#: index.docbook:950 -msgid "Your persistent class <emphasis>must</emphasis> override <literal>equals()</literal> and <literal>hashCode()</literal> to implement composite identifier equality. It must also implements <literal>Serializable</literal>." +#. Tag: para +#: basic_mapping.xml:950 +#, no-c-format +msgid "" +"Your persistent class <emphasis>must</emphasis> override <literal>equals()</" +"literal> and <literal>hashCode()</literal> to implement composite identifier " +"equality. It must also implements <literal>Serializable</literal>." msgstr "" +"Sua classe persistente <emphasis>precisa</emphasis> sobre escrever " +"<literal>equals()</literal> e <literal>hashCode()</literal> para implementar " +"identificadores compostos igualmente. E precisa também implementar " +"<literal>Serializable</literal>." -#: index.docbook:956 -msgid "Unfortunately, this approach to composite identifiers means that a persistent object is its own identifier. There is no convenient \"handle\" other than the object itself. You must instantiate an instance of the persistent class itself and populate its identifier properties before you can <literal>load()</literal> the persistent state associated with a composite key. We call this approach an <emphasis>embedded</emphasis> composite identifier, and discourage it for serious applications." +#. Tag: para +#: basic_mapping.xml:956 +#, no-c-format +msgid "" +"Unfortunately, this approach to composite identifiers means that a " +"persistent object is its own identifier. There is no convenient \"handle\" " +"other than the object itself. You must instantiate an instance of the " +"persistent class itself and populate its identifier properties before you " +"can <literal>load()</literal> the persistent state associated with a " +"composite key. We call this approach an <emphasis>embedded</emphasis> " +"composite identifier, and discourage it for serious applications." msgstr "" +"Infelizmente, esta solução para um identificador composto significa que um " +"objeto persistente é seu próprio identificador. Não há outro \"handle\" que " +"o próprio objeto. Você mesmo precisa instanciar uma instância de outra " +"classe persistente e preencher suas propriedades de identificação antes que " +"você possa dar um <literal>load()</literal> para o estado persistente " +"associado com uma chave composta. Nos chamamos esta solução de identificador " +"composto <emphasis>embedded</emphasis> e não aconselhamos para aplicações " +"sérias." -#: index.docbook:965 -msgid "A second approach is what we call a <emphasis>mapped</emphasis> composite identifier, where the identifier properties named inside the <literal><composite-id></literal> element are duplicated on both the persistent class and a separate identifier class." +#. Tag: para +#: basic_mapping.xml:965 +#, no-c-format +msgid "" +"A second approach is what we call a <emphasis>mapped</emphasis> composite " +"identifier, where the identifier properties named inside the <literal><" +"composite-id></literal> element are duplicated on both the persistent " +"class and a separate identifier class." msgstr "" +"Uma segunda solução é o que podemos chamar de identificador composto " +"<emphasis>mapped</emphasis> quando a propriedades de identificação nomeadas " +"dentro do elemento <literal><composite-id></literal> estão duplicadas " +"tando na classe persistente como em uma classe de identificação separada." -#: index.docbook:971 +#. Tag: programlisting +#: basic_mapping.xml:971 +#, no-c-format msgid "" - "<![CDATA[<composite-id class=\"MedicareId\" mapped=\"true\">\n" - " <key-property name=\"medicareNumber\"/>\n" - " <key-property name=\"dependent\"/>\n" - "</composite-id>]]>" +"<![CDATA[<composite-id class=\"MedicareId\" mapped=\"true\">\n" +" <key-property name=\"medicareNumber\"/>\n" +" <key-property name=\"dependent\"/>\n" +"</composite-id>]]>" msgstr "" -#: index.docbook:973 -msgid "In this example, both the composite identifier class, <literal>MedicareId</literal>, and the entity class itself have properties named <literal>medicareNumber</literal> and <literal>dependent</literal>. The identifier class must override <literal>equals()</literal> and <literal>hashCode()</literal> and implement. <literal>Serializable</literal>. The disadvantage of this approach is quite obvious—code duplication." +#. Tag: para +#: basic_mapping.xml:973 +#, no-c-format +msgid "" +"In this example, both the composite identifier class, <literal>MedicareId</" +"literal>, and the entity class itself have properties named " +"<literal>medicareNumber</literal> and <literal>dependent</literal>. The " +"identifier class must override <literal>equals()</literal> and " +"<literal>hashCode()</literal> and implement. <literal>Serializable</" +"literal>. The disadvantage of this approach is quite obvious—code " +"duplication." msgstr "" +"No exemplo, ambas as classes de identificação compostas, " +"<literal>MedicareId</literal>, e a própria classe entidade tem propriedades " +"nomeadas <literal>medicareNumber</literal> e <literal>dependent</literal>. A " +"classe identificadora precisa sobrepor <literal>equals()</literal> e " +"<literal>hashCode()</literal> e implementar <literal>Serializable</literal>. " +"A desvantagem desta solução é obvia – duplicação de código." -#: index.docbook:982 -msgid "The following attributes are used to specify a mapped composite identifier:" +#. Tag: para +#: basic_mapping.xml:982 +#, no-c-format +msgid "" +"The following attributes are used to specify a mapped composite identifier:" msgstr "" +"Os seguintes atributos ão utilizados para especificar o mapeamento de um " +"identificador composto:" -#: index.docbook:988 -msgid "<literal>mapped</literal> (optional, defaults to <literal>false</literal>): indicates that a mapped composite identifier is used, and that the contained property mappings refer to both the entity class and the composite identifier class." +#. Tag: para +#: basic_mapping.xml:988 +#, no-c-format +msgid "" +"<literal>mapped</literal> (optional, defaults to <literal>false</literal>): " +"indicates that a mapped composite identifier is used, and that the contained " +"property mappings refer to both the entity class and the composite " +"identifier class." msgstr "" +"<literal>mapped</literal> mapped (opcional, valor default <literal>false </" +"literal>): indica que um identificar composto mapeado é usado, e que as " +"propriedades de mapeamento contidas refere-se tanto a classe entidade e a " +"classe de identificação composta." -#: index.docbook:996 -msgid "<literal>class</literal> (optional, but required for a mapped composite identifier): The class used as a composite identifier." +#. Tag: para +#: basic_mapping.xml:996 +#, no-c-format +msgid "" +"<literal>class</literal> (optional, but required for a mapped composite " +"identifier): The class used as a composite identifier." msgstr "" +"<literal>class</literal> (opcional, mas requerida para um identificar " +"composto mapeado): A classe usada como um identificador composto." -#: index.docbook:1003 -msgid "We will describe a third, even more convenient approach where the composite identifier is implemented as a component class in <xref linkend=\"components-compositeid\"/>. The attributes described below apply only to this alternative approach:" +#. Tag: para +#: basic_mapping.xml:1003 +#, no-c-format +msgid "" +"We will describe a third, even more convenient approach where the composite " +"identifier is implemented as a component class in <xref linkend=\"components-" +"compositeid\"/>. The attributes described below apply only to this " +"alternative approach:" msgstr "" +"Nós iremos descrever uma terceira e as vezes mais conveniente solução, onde " +"o identificador composto é implementado como uma classe componente na <xref " +"linkend=\"components-compositeid\"/>. Os atributos descritos abaixo aplicam-" +"se apenas para esta solução:" -#: index.docbook:1011 -msgid "<literal>name</literal> (optional, required for this approach): A property of component type that holds the composite identifier (see chapter 9)." +#. Tag: para +#: basic_mapping.xml:1011 +#, no-c-format +msgid "" +"<literal>name</literal> (optional, required for this approach): A property " +"of component type that holds the composite identifier (see chapter 9)." msgstr "" +"<literal>name</literal> (opcional, requerida para esta solução): Uma " +"propriedade do tipo componente que armazena o identificador composto (veja " +"capítulo 9)" -#: index.docbook:1023 -msgid "<literal>class</literal> (optional - defaults to the property type determined by reflection): The component class used as a composite identifier (see next section)." +#. Tag: para +#: basic_mapping.xml:1023 +#, no-c-format +msgid "" +"<literal>class</literal> (optional - defaults to the property type " +"determined by reflection): The component class used as a composite " +"identifier (see next section)." msgstr "" +"<literal>class</literal> (opcional - valor default para o tipo de " +"propriedade determiando por reflexão) : A classe componente utilizada como " +"um identificador composto (veja a próxima sessão)." -#: index.docbook:1030 -msgid "This third approach, an <emphasis>identifier component</emphasis> is the one we recommend for almost all applications." +#. Tag: para +#: basic_mapping.xml:1030 +#, no-c-format +msgid "" +"This third approach, an <emphasis>identifier component</emphasis> is the one " +"we recommend for almost all applications." msgstr "" +"Esta terceira solução, um <emphasis>componente de identificação</emphasis>, " +"é o que nós recomendamos para a maioria das aplicações." -#: index.docbook:1038 +#. Tag: title +#: basic_mapping.xml:1038 +#, no-c-format msgid "discriminator" -msgstr "" +msgstr "discriminator" -#: index.docbook:1040 -msgid "The <literal><discriminator></literal> element is required for polymorphic persistence using the table-per-class-hierarchy mapping strategy and declares a discriminator column of the table. The discriminator column contains marker values that tell the persistence layer what subclass to instantiate for a particular row. A restricted set of types may be used: <literal>string</literal>, <literal>character</literal>, <literal>integer</literal>, <literal>byte</literal>, <literal>short</literal>, <literal>boolean</literal>, <literal>yes_no</literal>, <literal>true_false</literal>." +#. Tag: para +#: basic_mapping.xml:1040 +#, no-c-format +msgid "" +"The <literal><discriminator></literal> element is required for " +"polymorphic persistence using the table-per-class-hierarchy mapping strategy " +"and declares a discriminator column of the table. The discriminator column " +"contains marker values that tell the persistence layer what subclass to " +"instantiate for a particular row. A restricted set of types may be used: " +"<literal>string</literal>, <literal>character</literal>, <literal>integer</" +"literal>, <literal>byte</literal>, <literal>short</literal>, " +"<literal>boolean</literal>, <literal>yes_no</literal>, <literal>true_false</" +"literal>." msgstr "" +"O elemento <literal><discriminator></literal> é necessário para " +"persistência polimórfica utilizando a estratégia de mapeamento table-per-" +"class-hierarchy e declara uma coluna discriminadora da tabela. A coluna " +"discriminadora contem valores de marcação que dizem a camada de persistência " +"qual subclasse instanciar para uma linha particular. Um restrito conjunto de " +"tipos que podem ser utilizados: <literal>string</literal>, " +"<literal>character</literal>, <literal>integer</literal>, <literal>byte</" +"literal>, <literal>short</literal>, <literal>boolean</literal>, " +"<literal>yes_no</literal>, <literal>true_false</literal>." -#: index.docbook:1058 +#. Tag: programlisting +#: basic_mapping.xml:1058 +#, no-c-format msgid "" - "<![CDATA[<discriminator\n" - " column=\"discriminator_column\"\n" - " type=\"discriminator_type\"\n" - " force=\"true|false\"\n" - " insert=\"true|false\"\n" - " formula=\"arbitrary sql expression\"\n" - "/>]]>" +"<![CDATA[<discriminator\n" +" column=\"discriminator_column\"\n" +" type=\"discriminator_type\"\n" +" force=\"true|false\"\n" +" insert=\"true|false\"\n" +" formula=\"arbitrary sql expression\"\n" +"/>]]>" msgstr "" -#: index.docbook:1061 -msgid "<literal>column</literal> (optional - defaults to <literal>class</literal>) the name of the discriminator column." +#. Tag: para +#: basic_mapping.xml:1061 +#, no-c-format +msgid "" +"<literal>column</literal> (optional - defaults to <literal>class</literal>) " +"the name of the discriminator column." msgstr "" +"<literal>column</literal> (opcional - valor default <literal>class</" +"literal>) o nome da coluna discriminadora" -#: index.docbook:1067 -msgid "<literal>type</literal> (optional - defaults to <literal>string</literal>) a name that indicates the Hibernate type" +#. Tag: para +#: basic_mapping.xml:1067 +#, no-c-format +msgid "" +"<literal>type</literal> (optional - defaults to <literal>string</literal>) a " +"name that indicates the Hibernate type" msgstr "" +"<literal>type</literal> (opcional - valor default <literal>string</literal>) " +"o nome que indica o tipo Hibernate" -#: index.docbook:1073 -msgid "<literal>force</literal> (optional - defaults to <literal>false</literal>) \"force\" Hibernate to specify allowed discriminator values even when retrieving all instances of the root class." +#. Tag: para +#: basic_mapping.xml:1073 +#, no-c-format +msgid "" +"<literal>force</literal> (optional - defaults to <literal>false</literal>) " +"\"force\" Hibernate to specify allowed discriminator values even when " +"retrieving all instances of the root class." msgstr "" +"<literal>force</literal> (opcional - valor default <literal>false</literal>) " +"\"força\" o Hibernate a especificar valores discriminadores permitidos mesmo " +"quando recuperando todas as instancias da classe root." -#: index.docbook:1080 -msgid "<literal>insert</literal> (optional - defaults to <literal>true</literal>) set this to <literal>false</literal> if your discriminator column is also part of a mapped composite identifier. (Tells Hibernate to not include the column in SQL <literal>INSERT</literal>s.)" +#. Tag: para +#: basic_mapping.xml:1080 +#, no-c-format +msgid "" +"<literal>insert</literal> (optional - defaults to <literal>true</literal>) " +"set this to <literal>false</literal> if your discriminator column is also " +"part of a mapped composite identifier. (Tells Hibernate to not include the " +"column in SQL <literal>INSERT</literal>s.)" msgstr "" +"<literal>insert</literal> (opcional - valor default para <literal>true</" +"literal>) sete isto para <literal>false</literal> se sua coluna " +"discriminadora é também parte do identificador composto mapeado. (Diz ao " +"Hibernate para não incluir a coluna em comandos SQL <literal>INSERT</" +"literal>s)." -#: index.docbook:1088 -msgid "<literal>formula</literal> (optional) an arbitrary SQL expression that is executed when a type has to be evaluated. Allows content-based discrimination." +#. Tag: para +#: basic_mapping.xml:1088 +#, no-c-format +msgid "" +"<literal>formula</literal> (optional) an arbitrary SQL expression that is " +"executed when a type has to be evaluated. Allows content-based " +"discrimination." msgstr "" +"<literal>formula</literal> (opcional) uma expressão SQL arbitraria que é e " +"xecutada quando um tipo tem que ser avaliado. Permite discriminação baseada " +"em conteúdo." -#: index.docbook:1096 -msgid "Actual values of the discriminator column are specified by the <literal>discriminator-value</literal> attribute of the <literal><class></literal> and <literal><subclass></literal> elements." +#. Tag: para +#: basic_mapping.xml:1096 +#, no-c-format +msgid "" +"Actual values of the discriminator column are specified by the " +"<literal>discriminator-value</literal> attribute of the <literal><" +"class></literal> and <literal><subclass></literal> elements." msgstr "" +"Valores atuais de uma coluna discriminada são especificados pelo atributo " +"<literal>discriminator-value</literal> da <literal><class></literal> e " +"elementos da <literal><subclass></literal>." -#: index.docbook:1102 -msgid "The <literal>force</literal> attribute is (only) useful if the table contains rows with \"extra\" discriminator values that are not mapped to a persistent class. This will not usually be the case." +#. Tag: para +#: basic_mapping.xml:1102 +#, no-c-format +msgid "" +"The <literal>force</literal> attribute is (only) useful if the table " +"contains rows with \"extra\" discriminator values that are not mapped to a " +"persistent class. This will not usually be the case." msgstr "" +"O atributo <literal>force</literal> é util (apenas) em tabelas contendo " +"linhas com valores discriminadores \"extras\" que não estão mapeados para " +"uma classe persistente. Este não é geralmente o caso." -#: index.docbook:1108 -msgid "Using the <literal>formula</literal> attribute you can declare an arbitrary SQL expression that will be used to evaluate the type of a row:" +#. Tag: para +#: basic_mapping.xml:1108 +#, no-c-format +msgid "" +"Using the <literal>formula</literal> attribute you can declare an arbitrary " +"SQL expression that will be used to evaluate the type of a row:" msgstr "" +"Usando o atributo <literal>formula</literal> voce pode declarar uma " +"expressão SQL arbitrária que sera utilizada para avaliar o tipo de uma " +"linha :" -#: index.docbook:1113 +#. Tag: programlisting +#: basic_mapping.xml:1113 +#, no-c-format msgid "" - "<![CDATA[<discriminator\n" - " formula=\"case when CLASS_TYPE in ('a', 'b', 'c') then 0 else 1 end\"\n" - " type=\"integer\"/>]]>" +"<![CDATA[<discriminator\n" +" formula=\"case when CLASS_TYPE in ('a', 'b', 'c') then 0 else 1 end\"\n" +" type=\"integer\"/>]]>" msgstr "" -#: index.docbook:1118 +#. Tag: title +#: basic_mapping.xml:1118 +#, no-c-format msgid "version (optional)" -msgstr "" +msgstr "version (optional)" -#: index.docbook:1120 -msgid "The <literal><version></literal> element is optional and indicates that the table contains versioned data. This is particularly useful if you plan to use <emphasis>long transactions</emphasis> (see below)." +#. Tag: para +#: basic_mapping.xml:1120 +#, no-c-format +msgid "" +"The <literal><version></literal> element is optional and indicates " +"that the table contains versioned data. This is particularly useful if you " +"plan to use <emphasis>long transactions</emphasis> (see below)." msgstr "" +"O elemento <literal><version></literal> é opcional e indica que a " +"tabela possui dados versionados. Isto é particularmente útil se você planeja " +"utilizar <emphasis>transações longas</emphasis> (veja abaixo):" -#: index.docbook:1136 +#. Tag: programlisting +#: basic_mapping.xml:1136 +#, no-c-format msgid "" - "<![CDATA[<version\n" - " column=\"version_column\"\n" - " name=\"propertyName\"\n" - " type=\"typename\"\n" - " access=\"field|property|ClassName\"\n" - " unsaved-value=\"null|negative|undefined\"\n" - " generated=\"never|always\"\n" - " insert=\"true|false\"\n" - " node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" - "/>]]>" +"<![CDATA[<version\n" +" column=\"version_column\"\n" +" name=\"propertyName\"\n" +" type=\"typename\"\n" +" access=\"field|property|ClassName\"\n" +" unsaved-value=\"null|negative|undefined\"\n" +" generated=\"never|always\"\n" +" insert=\"true|false\"\n" +" node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" +"/>]]>" msgstr "" -#: index.docbook:1139 -msgid "<literal>column</literal> (optional - defaults to the property name): The name of the column holding the version number." +#. Tag: para +#: basic_mapping.xml:1139 +#, no-c-format +msgid "" +"<literal>column</literal> (optional - defaults to the property name): The " +"name of the column holding the version number." msgstr "" +"<literal>column</literal> (opcional - default a a propriedade name): O nome " +"da coluna mantendo o numero da versão" -#: index.docbook:1145 -msgid "<literal>name</literal>: The name of a property of the persistent class." -msgstr "" +#. Tag: para +#: basic_mapping.xml:1145 +#, no-c-format +msgid "" +"<literal>name</literal>: The name of a property of the persistent class." +msgstr "<literal>name</literal>: O nome da propriedade da classe persistente." -#: index.docbook:1150 -msgid "<literal>type</literal> (optional - defaults to <literal>integer</literal>): The type of the version number." +#. Tag: para +#: basic_mapping.xml:1150 +#, no-c-format +msgid "" +"<literal>type</literal> (optional - defaults to <literal>integer</literal>): " +"The type of the version number." msgstr "" +"<literal>type</literal> (opcional - valor default para <literal>integer</" +"literal>): O tipo do numero da versão" -#: index.docbook:1162 -msgid "<literal>unsaved-value</literal> (optional - defaults to <literal>undefined</literal>): A version property value that indicates that an instance is newly instantiated (unsaved), distinguishing it from detached instances that were saved or loaded in a previous session. (<literal>undefined</literal> specifies that the identifier property value should be used.)" +#. Tag: para +#: basic_mapping.xml:1162 +#, no-c-format +msgid "" +"<literal>unsaved-value</literal> (optional - defaults to <literal>undefined</" +"literal>): A version property value that indicates that an instance is newly " +"instantiated (unsaved), distinguishing it from detached instances that were " +"saved or loaded in a previous session. (<literal>undefined</literal> " +"specifies that the identifier property value should be used.)" msgstr "" +"<literal>unsaved-value</literal> (opcional – valor default para " +"<literal>undefined </literal>): Um valor para a propriedade versão que " +"indica que uma instancia é uma nova instanciada (unsaved), distinguindo de " +"instancias desconectadas que foram salvas ou carregadas em sessões " +"anteriores. ((<literal>undefined</literal> especifica que o valor da " +"propriedade de identificação deve ser utilizado)." -#: index.docbook:1171 -msgid "<literal>generated</literal> (optional - defaults to <literal>never</literal>): Specifies that this version property value is actually generated by the database. See the discussion of <xref linkend=\"mapping-generated\"/>generated properties." +#. Tag: para +#: basic_mapping.xml:1171 +#, no-c-format +msgid "" +"<literal>generated</literal> (optional - defaults to <literal>never</" +"literal>): Specifies that this version property value is actually generated " +"by the database. See the discussion of <link linkend=\"mapping-generated" +"\">generated properties</link>." msgstr "" +"<literal>generated</literal> (optional - defaults to <literal>never</" +"literal>): Specifies that this version property value is actually generated " +"by the database. See the discussion of <xref linkend=\"mapping-generated" +"\">generated properties</xref>. <literal>generated</literal> (opcional - " +"valor default <literal>never</literal>): Especifica que valor para a " +"propriedade versão é na verdade gerado pelo banco de dados. Veja a discussão " +"da Seção <xref linkend=\"mapping-generated\">generated properties</xref>." -#: index.docbook:1178 -msgid "<literal>insert</literal> (optional - defaults to <literal>true</literal>): Specifies whether the version column should be included in SQL insert statements. May be set to <literal>false</literal> if and only if the database column is defined with a default value of <literal>0</literal>." +#. Tag: para +#: basic_mapping.xml:1178 +#, no-c-format +msgid "" +"<literal>insert</literal> (optional - defaults to <literal>true</literal>): " +"Specifies whether the version column should be included in SQL insert " +"statements. May be set to <literal>false</literal> if and only if the " +"database column is defined with a default value of <literal>0</literal>." msgstr "" +"<literal>insert</literal> (opcional - valor default para <literal>true</" +"literal>): Especifica se a coluna de versão deve ser incluída no comando SQL " +"de insert. Pode ser configurado como <literal>false</literal> se a coluna do " +"banco de dados está definida com um valor default de <literal>0</literal>." -#: index.docbook:1188 -msgid "Version numbers may be of Hibernate type <literal>long</literal>, <literal>integer</literal>, <literal>short</literal>, <literal>timestamp</literal> or <literal>calendar</literal>." +#. Tag: para +#: basic_mapping.xml:1188 +#, no-c-format +msgid "" +"Version numbers may be of Hibernate type <literal>long</literal>, " +"<literal>integer</literal>, <literal>short</literal>, <literal>timestamp</" +"literal> or <literal>calendar</literal>." msgstr "" +"Números de versão podem ser dos tipos Hibernate <literal>long</literal>, " +"<literal>integer</literal>, <literal>short</literal>, <literal>timestamp</" +"literal> ou <literal>calendar</literal>." -#: index.docbook:1193 -msgid "A version or timestamp property should never be null for a detached instance, so Hibernate will detect any instance with a null version or timestamp as transient, no matter what other <literal>unsaved-value</literal> strategies are specified. <emphasis>Declaring a nullable version or timestamp property is an easy way to avoid any problems with transitive reattachment in Hibernate, especially useful for people using assigned identifiers or composite keys!</emphasis>" +#. Tag: para +#: basic_mapping.xml:1193 +#, no-c-format +msgid "" +"A version or timestamp property should never be null for a detached " +"instance, so Hibernate will detect any instance with a null version or " +"timestamp as transient, no matter what other <literal>unsaved-value</" +"literal> strategies are specified. <emphasis>Declaring a nullable version or " +"timestamp property is an easy way to avoid any problems with transitive " +"reattachment in Hibernate, especially useful for people using assigned " +"identifiers or composite keys!</emphasis>" msgstr "" +"A versão de uma propriedade timestamp nunca deve ser nula para uma instancia " +"desconectada, assim o Hibernate irá identificar qualquer instância com uma " +"versão nula ou timestamp como transiente, não importando qual estratégia " +"para foi especificada para <literal>unsaved-value</literal>. " +"<emphasis>Declarando uma versão nula ou a propriedade timestamp é um caminho " +"fácil para tratar problemas com reconexões transitivas no Hibernate, " +"especialmente úteis para pessoas utilizando identificadores assinaldados ou " +"chaves compostas!</emphasis>" -#: index.docbook:1204 +#. Tag: title +#: basic_mapping.xml:1204 +#, no-c-format msgid "timestamp (optional)" -msgstr "" +msgstr "timestamp (optional)" -#: index.docbook:1206 -msgid "The optional <literal><timestamp></literal> element indicates that the table contains timestamped data. This is intended as an alternative to versioning. Timestamps are by nature a less safe implementation of optimistic locking. However, sometimes the application might use the timestamps in other ways." +#. Tag: para +#: basic_mapping.xml:1206 +#, no-c-format +msgid "" +"The optional <literal><timestamp></literal> element indicates that the " +"table contains timestamped data. This is intended as an alternative to " +"versioning. Timestamps are by nature a less safe implementation of " +"optimistic locking. However, sometimes the application might use the " +"timestamps in other ways." msgstr "" +"O elemento opcional <literal><timestamp></literal> indica que uma " +"tabela contém dados timestamped. Isso tem por objetivo dar uma alternativa " +"para versionamento. Timestamps são por natureza uma implementação menos " +"segura do locking otimista. Entretanto, algumas vezes a aplicação pode usar " +"timestamps em outros caminhos." -#: index.docbook:1222 +#. Tag: programlisting +#: basic_mapping.xml:1222 +#, no-c-format msgid "" - "<![CDATA[<timestamp\n" - " column=\"timestamp_column\"\n" - " name=\"propertyName\"\n" - " access=\"field|property|ClassName\"\n" - " unsaved-value=\"null|undefined\"\n" - " source=\"vm|db\"\n" - " generated=\"never|always\"\n" - " node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" - "/>]]>" +"<![CDATA[<timestamp\n" +" column=\"timestamp_column\"\n" +" name=\"propertyName\"\n" +" access=\"field|property|ClassName\"\n" +" unsaved-value=\"null|undefined\"\n" +" source=\"vm|db\"\n" +" generated=\"never|always\"\n" +" node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" +"/>]]>" msgstr "" -#: index.docbook:1225 -msgid "<literal>column</literal> (optional - defaults to the property name): The name of a column holding the timestamp." +#. Tag: para +#: basic_mapping.xml:1225 +#, no-c-format +msgid "" +"<literal>column</literal> (optional - defaults to the property name): The " +"name of a column holding the timestamp." msgstr "" +"<literal>column</literal> (opcional - valor default para a propriedade " +"name): O nome da coluna que mantem o timestamp." -#: index.docbook:1231 -msgid "<literal>name</literal>: The name of a JavaBeans style property of Java type <literal>Date</literal> or <literal>Timestamp</literal> of the persistent class." +#. Tag: para +#: basic_mapping.xml:1231 +#, no-c-format +msgid "" +"<literal>name</literal>: The name of a JavaBeans style property of Java type " +"<literal>Date</literal> or <literal>Timestamp</literal> of the persistent " +"class." msgstr "" +"<literal>name</literal>: O nome da propriedade no estilo JavaBeans do tipo " +"<literal>Date</literal> ou <literal>Timestamp</literal> da classe " +"persistente Java." -#: index.docbook:1244 -msgid "<literal>unsaved-value</literal> (optional - defaults to <literal>null</literal>): A version property value that indicates that an instance is newly instantiated (unsaved), distinguishing it from detached instances that were saved or loaded in a previous session. (<literal>undefined</literal> specifies that the identifier property value should be used.)" +#. Tag: para +#: basic_mapping.xml:1244 +#, no-c-format +msgid "" +"<literal>unsaved-value</literal> (optional - defaults to <literal>null</" +"literal>): A version property value that indicates that an instance is newly " +"instantiated (unsaved), distinguishing it from detached instances that were " +"saved or loaded in a previous session. (<literal>undefined</literal> " +"specifies that the identifier property value should be used.)" msgstr "" +"<literal>unsaved-value</literal> (opcional - valor default <literal>null</" +"literal>): Uma propriedade para a versão de que indica que uma instância é " +"uma nova instanciada (unsaved), distinguindo-a de instancias desconectadas " +"que foram salvas ou carregadas em sessões previas. (<literal>undefined</" +"literal> especifica que um valor de propriedade de identificação deve ser " +"utilizado)" -#: index.docbook:1253 -msgid "<literal>source</literal> (optional - defaults to <literal>vm</literal>): From where should Hibernate retrieve the timestamp value? From the database, or from the current JVM? Database-based timestamps incur an overhead because Hibernate must hit the database in order to determine the \"next value\", but will be safer for use in clustered environments. Note also, that not all <literal>Dialect</literal>s are known to support retrieving of the database's current timestamp, while others might be unsafe for usage in locking due to lack of precision (Oracle 8 for example)." +#. Tag: para +#: basic_mapping.xml:1253 +#, no-c-format +msgid "" +"<literal>source</literal> (optional - defaults to <literal>vm</literal>): " +"From where should Hibernate retrieve the timestamp value? From the database, " +"or from the current JVM? Database-based timestamps incur an overhead because " +"Hibernate must hit the database in order to determine the \"next value\", " +"but will be safer for use in clustered environments. Note also, that not all " +"<literal>Dialect</literal>s are known to support retrieving of the " +"database's current timestamp, while others might be unsafe for usage in " +"locking due to lack of precision (Oracle 8 for example)." msgstr "" +"<literal>source</literal> (opcional - valor default para <literal>vm</" +"literal>): De onde o Hibernate deve recuperar o valor timestamp? Do banco de " +"dados ou da JVM corrente? Timestamps baseados em banco de dados levam a um " +"overhead porque o Hibernate precisa acessar o banco de dados para determinar " +"o \"próximo valor\", mas é mais seguro para uso em ambientes de \"cluster\". " +"Observe também, que nem todos <literal>Dialect</literal>s suportam a " +"recuperação do timestamp corrente do banco de dados, enquando outros podem " +"não ser seguros para utilização em bloqueios pela falta de precisão (Oracle " +"8 por exemplo)" -#: index.docbook:1265 -msgid "<literal>generated</literal> (optional - defaults to <literal>never</literal>): Specifies that this timestamp property value is actually generated by the database. See the discussion of <xref linkend=\"mapping-generated\"/>generated properties." +#. Tag: para +#: basic_mapping.xml:1265 +#, no-c-format +msgid "" +"<literal>generated</literal> (optional - defaults to <literal>never</" +"literal>): Specifies that this timestamp property value is actually " +"generated by the database. See the discussion of <link linkend=\"mapping-" +"generated\">generated properties</link>." msgstr "" +"<literal>generated</literal> (opcional - valor default <literal>never</" +"literal>): Especifica que o valor da propriedade timestamp é gerado pelo " +"banco de dados. Veja a discussão <xref linkend=\"mapping-generated" +"\">generated properties</xref>." -#: index.docbook:1274 -msgid "Note that <literal><timestamp></literal> is equivalent to <literal><version type=\"timestamp\"></literal>. And <literal><timestamp source=\"db\"></literal> is equivalent to <literal><version type=\"dbtimestamp\"></literal>" +#. Tag: para +#: basic_mapping.xml:1274 +#, no-c-format +msgid "" +"Note that <literal><timestamp></literal> is equivalent to <literal><" +"version type=\"timestamp\"></literal>. And <literal><timestamp source=" +"\"db\"></literal> is equivalent to <literal><version type=\"dbtimestamp" +"\"></literal>" msgstr "" +"Observe que <literal><timestamp></literal> é equivalente a " +"<literal><version type=\"timestamp\"></literal>. E <literal><" +"timestamp source=\"db\"></literal> é equivalente a <literal><version " +"type=\"dbtimestamp\"></literal>." -#: index.docbook:1284 +#. Tag: title +#: basic_mapping.xml:1284 +#, no-c-format msgid "property" -msgstr "" +msgstr "property" -#: index.docbook:1286 -msgid "The <literal><property></literal> element declares a persistent, JavaBean style property of the class." +#. Tag: para +#: basic_mapping.xml:1286 +#, no-c-format +msgid "" +"The <literal><property></literal> element declares a persistent, " +"JavaBean style property of the class." msgstr "" +"O elemento <literal><property></literal> declara uma propriedade " +"persistente de uma classe, no estilo JavaBean." -#: index.docbook:1308 +#. Tag: programlisting +#: basic_mapping.xml:1308 +#, no-c-format msgid "" - "<![CDATA[<property\n" - " name=\"propertyName\"\n" - " column=\"column_name\"\n" - " type=\"typename\"\n" - " update=\"true|false\"\n" - " insert=\"true|false\"\n" - " formula=\"arbitrary SQL expression\"\n" - " access=\"field|property|ClassName\"\n" - " lazy=\"true|false\"\n" - " unique=\"true|false\"\n" - " not-null=\"true|false\"\n" - " optimistic-lock=\"true|false\"\n" - " generated=\"never|insert|always\"\n" - " node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" - " index=\"index_name\"\n" - " unique_key=\"unique_key_id\"\n" - " length=\"L\"\n" - " precision=\"P\"\n" - " scale=\"S\"\n" - "/>]]>" +"<![CDATA[<property\n" +" name=\"propertyName\"\n" +" column=\"column_name\"\n" +" type=\"typename\"\n" +" update=\"true|false\"\n" +" insert=\"true|false\"\n" +" formula=\"arbitrary SQL expression\"\n" +" access=\"field|property|ClassName\"\n" +" lazy=\"true|false\"\n" +" unique=\"true|false\"\n" +" not-null=\"true|false\"\n" +" optimistic-lock=\"true|false\"\n" +" generated=\"never|insert|always\"\n" +" node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" +" index=\"index_name\"\n" +" unique_key=\"unique_key_id\"\n" +" length=\"L\"\n" +" precision=\"P\"\n" +" scale=\"S\"\n" +"/>]]>" msgstr "" -#: index.docbook:1311 -msgid "<literal>name</literal>: the name of the property, with an initial lowercase letter." +#. Tag: para +#: basic_mapping.xml:1311 +#, no-c-format +msgid "" +"<literal>name</literal>: the name of the property, with an initial lowercase " +"letter." msgstr "" +"<literal>name</literal>: o nome da propriedade, iniciando com letra " +"minúscula." -#: index.docbook:1317 -msgid "<literal>column</literal> (optional - defaults to the property name): the name of the mapped database table column. This may also be specified by nested <literal><column></literal> element(s)." +#. Tag: para +#: basic_mapping.xml:1317 +#, no-c-format +msgid "" +"<literal>column</literal> (optional - defaults to the property name): the " +"name of the mapped database table column. This may also be specified by " +"nested <literal><column></literal> element(s)." msgstr "" +"<literal>column</literal> (opcional - default para a propriedade name): o " +"nome da coluna mapeada do banco de dados, Isto pode também ser especificado " +"pelo(s) elemento(s) <literal><column></literal> aninhados." -#: index.docbook:1324 -msgid "<literal>type</literal> (optional): a name that indicates the Hibernate type." +#. Tag: para +#: basic_mapping.xml:1324 +#, no-c-format +msgid "" +"<literal>type</literal> (optional): a name that indicates the Hibernate type." msgstr "" +"<literal>type</literal> (opcional): um nome que indica o tipo Hibernate." -#: index.docbook:1329 -msgid "<literal>update, insert</literal> (optional - defaults to <literal>true</literal>) : specifies that the mapped columns should be included in SQL <literal>UPDATE</literal> and/or <literal>INSERT</literal> statements. Setting both to <literal>false</literal> allows a pure \"derived\" property whose value is initialized from some other property that maps to the same colum(s) or by a trigger or other application." +#. Tag: para +#: basic_mapping.xml:1329 +#, no-c-format +msgid "" +"<literal>update, insert</literal> (optional - defaults to <literal>true</" +"literal>) : specifies that the mapped columns should be included in SQL " +"<literal>UPDATE</literal> and/or <literal>INSERT</literal> statements. " +"Setting both to <literal>false</literal> allows a pure \"derived\" property " +"whose value is initialized from some other property that maps to the same " +"colum(s) or by a trigger or other application." msgstr "" +"<literal>update, insert</literal> (opcional - valor default <literal>true</" +"literal>): especifica que as colunas mapeadas devem ser incluidas nas " +"instruções SQL de <literal>UPDATE</literal> e/ou <literal>INSERT</literal> . " +"Setar ambas para to <literal>false</literal> permite uma propridade " +"\"derivada\" pura cujo valor é inicializado de outra propriedade que mapeie " +"a mesma coluna(s) ou por uma trigger ou outra aplicação." -#: index.docbook:1338 -msgid "<literal>formula</literal> (optional): an SQL expression that defines the value for a <emphasis>computed</emphasis> property. Computed properties do not have a column mapping of their own." +#. Tag: para +#: basic_mapping.xml:1338 +#, no-c-format +msgid "" +"<literal>formula</literal> (optional): an SQL expression that defines the " +"value for a <emphasis>computed</emphasis> property. Computed properties do " +"not have a column mapping of their own." msgstr "" +"<literal>formula</literal> (opcional): uma expressão SQL que definie o valor " +"para uma propriedade <emphasis>calculada</emphasis>. Propriedades calculadas " +"nao tem uma coluna de mapeamento para elas." -#: index.docbook:1351 -msgid "<literal>lazy</literal> (optional - defaults to <literal>false</literal>): Specifies that this property should be fetched lazily when the instance variable is first accessed (requires build-time bytecode instrumentation)." +#. Tag: para +#: basic_mapping.xml:1351 +#, no-c-format +msgid "" +"<literal>lazy</literal> (optional - defaults to <literal>false</literal>): " +"Specifies that this property should be fetched lazily when the instance " +"variable is first accessed (requires build-time bytecode instrumentation)." msgstr "" +"<literal>lazy</literal> (opcional - valor default para <literal>false</" +"literal>): Especifica que esta propriedade deve ser trazida de forma \"lazy" +"\" quando a instancia da variável é acessada pela primeira vez (requer " +"instrumentação bytecode em tempo de criação)." -#: index.docbook:1358 -msgid "<literal>unique</literal> (optional): Enable the DDL generation of a unique constraint for the columns. Also, allow this to be the target of a <literal>property-ref</literal>." +#. Tag: para +#: basic_mapping.xml:1358 +#, no-c-format +msgid "" +"<literal>unique</literal> (optional): Enable the DDL generation of a unique " +"constraint for the columns. Also, allow this to be the target of a " +"<literal>property-ref</literal>." msgstr "" +"<literal>unique</literal> (opcional): Habilita a geração de DDL de uma unica " +"constraint para as colunas. Assim, permite que isto seja o alvo de uma " +"<literal>property-ref</literal>." -#: index.docbook:1365 -msgid "<literal>not-null</literal> (optional): Enable the DDL generation of a nullability constraint for the columns." +#. Tag: para +#: basic_mapping.xml:1365 +#, no-c-format +msgid "" +"<literal>not-null</literal> (optional): Enable the DDL generation of a " +"nullability constraint for the columns." msgstr "" +"<literal>not-null</literal> (opcional): Habilita a geração de DDL de uma " +"constraint de nulidade para as colunas." -#: index.docbook:1371 -msgid "<literal>optimistic-lock</literal> (optional - defaults to <literal>true</literal>): Specifies that updates to this property do or do not require acquisition of the optimistic lock. In other words, determines if a version increment should occur when this property is dirty." +#. Tag: para +#: basic_mapping.xml:1371 +#, no-c-format +msgid "" +"<literal>optimistic-lock</literal> (optional - defaults to <literal>true</" +"literal>): Specifies that updates to this property do or do not require " +"acquisition of the optimistic lock. In other words, determines if a version " +"increment should occur when this property is dirty." msgstr "" +"<literal>optimistic-lock</literal> (opcional - valor default <literal>true</" +"literal>): Especifica se mudanças para esta propriedade requerem ou não " +"bloqueio otimista. Em outras palavras, determina se um incremento de versão " +"deve ocorrer quando esta propriedade está suja." -#: index.docbook:1379 -msgid "<literal>generated</literal> (optional - defaults to <literal>never</literal>): Specifies that this property value is actually generated by the database. See the discussion of <xref linkend=\"mapping-generated\"/>generated properties." +#. Tag: para +#: basic_mapping.xml:1379 +#, no-c-format +msgid "" +"<literal>generated</literal> (optional - defaults to <literal>never</" +"literal>): Specifies that this property value is actually generated by the " +"database. See the discussion of <link linkend=\"mapping-generated" +"\">generated properties</link>." msgstr "" +"<literal>generated</literal> (opcional - valor default <literal>never</" +"literal>): Especifica que o valor da propriedade é na verdade gerado pelo " +"banco de dados. Veja a discussão da seção <xref linkend=\"mapping-generated" +"\">generated properties</xref>." -#: index.docbook:1388 +#. Tag: para +#: basic_mapping.xml:1388 +#, no-c-format msgid "<emphasis>typename</emphasis> could be:" -msgstr "" +msgstr "<emphasis>typename</emphasis> pode ser:" -#: index.docbook:1394 -msgid "The name of a Hibernate basic type (eg. <literal>integer, string, character, date, timestamp, float, binary, serializable, object, blob</literal>)." +#. Tag: para +#: basic_mapping.xml:1394 +#, no-c-format +msgid "" +"The name of a Hibernate basic type (eg. <literal>integer, string, character, " +"date, timestamp, float, binary, serializable, object, blob</literal>)." msgstr "" +"The name of a Hibernate basic type (eg. <literal>integer, string, character, " +"date, timestamp, float, binary, serializable, object, blob</literal>). O " +"nome do tipo basico do Hibernate (ex., <literal>integer, string, character, " +"date, timestamp, float, binary, serializable, object, blob</literal>)." -#: index.docbook:1400 -msgid "The name of a Java class with a default basic type (eg. <literal>int, float, char, java.lang.String, java.util.Date, java.lang.Integer, java.sql.Clob</literal>)." +#. Tag: para +#: basic_mapping.xml:1400 +#, no-c-format +msgid "" +"The name of a Java class with a default basic type (eg. <literal>int, float, " +"char, java.lang.String, java.util.Date, java.lang.Integer, java.sql.Clob</" +"literal>)." msgstr "" +"O nome da classe Java com um tipo básico default (ex. <literal>int, float, " +"char, java.lang.String, java.util.Date, java.lang.Integer, java.sql.Clob</" +"literal>)." -#: index.docbook:1406 +#. Tag: para +#: basic_mapping.xml:1406 +#, no-c-format msgid "The name of a serializable Java class." -msgstr "" +msgstr "O nome da classe Java serializable" -#: index.docbook:1411 -msgid "The class name of a custom type (eg. <literal>com.illflow.type.MyCustomType</literal>)." +#. Tag: para +#: basic_mapping.xml:1411 +#, no-c-format +msgid "" +"The class name of a custom type (eg. <literal>com.illflow.type.MyCustomType</" +"literal>)." msgstr "" +"O nome da classe de um tipo customizado (ex. <literal>com.illflow.type." +"MyCustomType</literal>)." -#: index.docbook:1417 -msgid "If you do not specify a type, Hibernate will use reflection upon the named property to take a guess at the correct Hibernate type. Hibernate will try to interpret the name of the return class of the property getter using rules 2, 3, 4 in that order. However, this is not always enough. In certain cases you will still need the <literal>type</literal> attribute. (For example, to distinguish between <literal>Hibernate.DATE</literal> and <literal>Hibernate.TIMESTAMP</literal>, or to specify a custom type.)" +#. Tag: para +#: basic_mapping.xml:1417 +#, no-c-format +msgid "" +"If you do not specify a type, Hibernate will use reflection upon the named " +"property to take a guess at the correct Hibernate type. Hibernate will try " +"to interpret the name of the return class of the property getter using rules " +"2, 3, 4 in that order. However, this is not always enough. In certain cases " +"you will still need the <literal>type</literal> attribute. (For example, to " +"distinguish between <literal>Hibernate.DATE</literal> and <literal>Hibernate." +"TIMESTAMP</literal>, or to specify a custom type.)" msgstr "" +"Se você não especificar um tipo, o Hibernate ira utilizar reflexão sobre a " +"propriedade nomeada para ter uma idéia do tipo Hibernate correto. O " +"Hibernate ira tentar interpretar o nome da classe retornada, usando as " +"regras 2, 3 e 4 nesta ordem. Entretanto, isto não é sempre suficiente Em " +"certos casos, você ainda irá necessitar do atributo <literal>type</literal>. " +"(Por exemplo, para distinguir entre <literal>Hibernate.DATE</literal> ou " +"<literal>Hibernate.TIMESTAMP</literal>, ou para espcificar uma tipo " +"ciustomizado.)" -#: index.docbook:1427 -msgid "The <literal>access</literal> attribute lets you control how Hibernate will access the property at runtime. By default, Hibernate will call the property get/set pair. If you specify <literal>access=\"field\"</literal>, Hibernate will bypass the get/set pair and access the field directly, using reflection. You may specify your own strategy for property access by naming a class that implements the interface <literal>org.hibernate.property.PropertyAccessor</literal>." +#. Tag: para +#: basic_mapping.xml:1427 +#, no-c-format +msgid "" +"The <literal>access</literal> attribute lets you control how Hibernate will " +"access the property at runtime. By default, Hibernate will call the property " +"get/set pair. If you specify <literal>access=\"field\"</literal>, Hibernate " +"will bypass the get/set pair and access the field directly, using " +"reflection. You may specify your own strategy for property access by naming " +"a class that implements the interface <literal>org.hibernate.property." +"PropertyAccessor</literal>." msgstr "" +"O atributo <literal>access</literal> permite voce controlar como o Hibernate " +"irá acessar a propriedade em tempo de execução. Por default, o Hibernate irá " +"chamar os métodos get/set da propriedades. Se voce especificar " +"<literal>access=\"field\"</literal>, o Hibernate ira bipassar os metodos get/" +"set, acessnado o campo diretamente, usando reflexão. Voc epode especificar " +"sua própria estratégia para acesso da propriedade criando uma classe que " +"implemente a interface <literal>org.hibernate.property.PropertyAccessor</" +"literal>." -#: index.docbook:1436 -msgid "An especially powerful feature are derived properties. These properties are by definition read-only, the property value is computed at load time. You declare the computation as a SQL expression, this translates to a <literal>SELECT</literal> clause subquery in the SQL query that loads an instance:" +#. Tag: para +#: basic_mapping.xml:1436 +#, no-c-format +msgid "" +"An especially powerful feature are derived properties. These properties are " +"by definition read-only, the property value is computed at load time. You " +"declare the computation as a SQL expression, this translates to a " +"<literal>SELECT</literal> clause subquery in the SQL query that loads an " +"instance:" msgstr "" +"Um recurso especialmente poderoso é o de propriedades derivadas. Estas " +"propriedades são por definição read-only, e o valor da propriedade é " +"calculado em tempo de execução. Você declara este calculo como uma expressão " +"SQL, que traduz para clausula <literal>SELECT</literal> de uma subquery " +"daquery SQL que carrega a instancia:" -#: index.docbook:1443 +#. Tag: programlisting +#: basic_mapping.xml:1443 +#, no-c-format msgid "" - "<![CDATA[\n" - "<property name=\"totalPrice\"\n" - " formula=\"( SELECT SUM (li.quantity*p.price) FROM LineItem li, Product p\n" - " WHERE li.productId = p.productId\n" - " AND li.customerId = customerId\n" - " AND li.orderNumber = orderNumber )\"/>]]>" +"<![CDATA[\n" +"<property name=\"totalPrice\"\n" +" formula=\"( SELECT SUM (li.quantity*p.price) FROM LineItem li, Product " +"p\n" +" WHERE li.productId = p.productId\n" +" AND li.customerId = customerId\n" +" AND li.orderNumber = orderNumber )\"/>]]>" msgstr "" -#: index.docbook:1445 -msgid "Note that you can reference the entities own table by not declaring an alias on a particular column (<literal>customerId</literal> in the given example). Also note that you can use the nested <literal><formula></literal> mapping element if you don't like to use the attribute." +#. Tag: para +#: basic_mapping.xml:1445 +#, no-c-format +msgid "" +"Note that you can reference the entities own table by not declaring an alias " +"on a particular column (<literal>customerId</literal> in the given example). " +"Also note that you can use the nested <literal><formula></literal> " +"mapping element if you don't like to use the attribute." msgstr "" +"Observe que você pode referenciar as entidades da própria tabela, através da " +"não declaração de um alias para uma coluna particular ( <literal>customerId</" +"literal> no exemplo dado). Observe tambem que voce pode usar o mapeamento de " +"elemento aninhado <literal><formula></literal>, se você não gostar de " +"usar o atributo." -#: index.docbook:1455 +#. Tag: title +#: basic_mapping.xml:1455 +#, no-c-format msgid "many-to-one" -msgstr "" +msgstr "many-to-one" -#: index.docbook:1457 -msgid "An ordinary association to another persistent class is declared using a <literal>many-to-one</literal> element. The relational model is a many-to-one association: a foreign key in one table is referencing the primary key column(s) of the target table." +#. Tag: para +#: basic_mapping.xml:1457 +#, no-c-format +msgid "" +"An ordinary association to another persistent class is declared using a " +"<literal>many-to-one</literal> element. The relational model is a many-to-" +"one association: a foreign key in one table is referencing the primary key " +"column(s) of the target table." msgstr "" +"Uma associação ordinária para outra classe persistente é declarada usando o " +"elemento <literal>many-to-one</literal>. O modelo relacional é uma " +"associação many-to-one: a uma chave estrangeira de uma tabela referenciando " +"a chave primaria da tabela destino." -#: index.docbook:1485 +#. Tag: programlisting +#: basic_mapping.xml:1485 +#, no-c-format msgid "" - "<![CDATA[<many-to-one\n" - " name=\"propertyName\"\n" - " column=\"column_name\"\n" - " class=\"ClassName\"\n" - " cascade=\"cascade_style\"\n" - " fetch=\"join|select\"\n" - " update=\"true|false\"\n" - " insert=\"true|false\"\n" - " property-ref=\"propertyNameFromAssociatedClass\"\n" - " access=\"field|property|ClassName\"\n" - " unique=\"true|false\"\n" - " not-null=\"true|false\"\n" - " optimistic-lock=\"true|false\"\n" - " lazy=\"proxy|no-proxy|false\"\n" - " not-found=\"ignore|exception\"\n" - " entity-name=\"EntityName\"\n" - " formula=\"arbitrary SQL expression\"\n" - " node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" - " embed-xml=\"true|false\"\n" - " index=\"index_name\"\n" - " unique_key=\"unique_key_id\"\n" - " foreign-key=\"foreign_key_name\"\n" - "/>]]>" +"<![CDATA[<many-to-one\n" +" name=\"propertyName\"\n" +" column=\"column_name\"\n" +" class=\"ClassName\"\n" +" cascade=\"cascade_style\"\n" +" fetch=\"join|select\"\n" +" update=\"true|false\"\n" +" insert=\"true|false\"\n" +" property-ref=\"propertyNameFromAssociatedClass\"\n" +" access=\"field|property|ClassName\"\n" +" unique=\"true|false\"\n" +" not-null=\"true|false\"\n" +" optimistic-lock=\"true|false\"\n" +" lazy=\"proxy|no-proxy|false\"\n" +" not-found=\"ignore|exception\"\n" +" entity-name=\"EntityName\"\n" +" formula=\"arbitrary SQL expression\"\n" +" node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" +" embed-xml=\"true|false\"\n" +" index=\"index_name\"\n" +" unique_key=\"unique_key_id\"\n" +" foreign-key=\"foreign_key_name\"\n" +"/>]]>" msgstr "" -#: index.docbook:1488, index.docbook:1669, index.docbook:1855 +#. Tag: para +#: basic_mapping.xml:1488 basic_mapping.xml:1669 basic_mapping.xml:1855 +#, no-c-format msgid "<literal>name</literal>: The name of the property." -msgstr "" +msgstr "<literal>name</literal>: O nome da propriedade." -#: index.docbook:1493, index.docbook:2284 -msgid "<literal>column</literal> (optional): The name of the foreign key column. This may also be specified by nested <literal><column></literal> element(s)." +#. Tag: para +#: basic_mapping.xml:1493 basic_mapping.xml:2284 +#, fuzzy, no-c-format +msgid "" +"<literal>column</literal> (optional): The name of the foreign key column. " +"This may also be specified by nested <literal><column></literal> " +"element(s)." msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>column</literal> (opcional): O nome da coluna foreign key. Isto " +"pode também ser especificado através de elementos aninhados <literal><" +"column></literal>.\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +". <literal>column</literal> (opcional): O nome da coluna da chave " +"estrangeira. Isto também pode ser especificado por aninhamento de elemento" +"(s) <literal><column></literal>." -#: index.docbook:1500, index.docbook:1674 -msgid "<literal>class</literal> (optional - defaults to the property type determined by reflection): The name of the associated class." +#. Tag: para +#: basic_mapping.xml:1500 basic_mapping.xml:1674 +#, fuzzy, no-c-format +msgid "" +"<literal>class</literal> (optional - defaults to the property type " +"determined by reflection): The name of the associated class." msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>class</literal> (opcional – default para o tipo de propriedade " +"determinado pela reflexão). O nome da classe associada.\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>class</literal> (opcional – default para o tipo da propriedade " +"definido via reflection): O nome da classe associada." -#: index.docbook:1506 -msgid "<literal>cascade</literal> (optional): Specifies which operations should be cascaded from the parent object to the associated object." +#. Tag: para +#: basic_mapping.xml:1506 +#, no-c-format +msgid "" +"<literal>cascade</literal> (optional): Specifies which operations should be " +"cascaded from the parent object to the associated object." msgstr "" +"<literal>cascade</literal> (opcional): Especifica quais operações dever ser " +"em cascata do objeto pai para o objeto associado." -#: index.docbook:1512, index.docbook:1695 -msgid "<literal>fetch</literal> (optional - defaults to <literal>select</literal>): Chooses between outer-join fetching or sequential select fetching." +#. Tag: para +#: basic_mapping.xml:1512 basic_mapping.xml:1695 +#, fuzzy, no-c-format +msgid "" +"<literal>fetch</literal> (optional - defaults to <literal>select</literal>): " +"Chooses between outer-join fetching or sequential select fetching." msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>fetch</literal> (opcional - default para <literal>select</" +"literal>): Escolhe entre recuperação outer-join ou recuperação seqüencial.\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>fetch</literal> ((opcional – valor default <literal>select</" +"literal>): Escolhe entre outer-join fetching ou sequential select fetching." -#: index.docbook:1518 -msgid "<literal>update, insert</literal> (optional - defaults to <literal>true</literal>) specifies that the mapped columns should be included in SQL <literal>UPDATE</literal> and/or <literal>INSERT</literal> statements. Setting both to <literal>false</literal> allows a pure \"derived\" association whose value is initialized from some other property that maps to the same colum(s) or by a trigger or other application." +#. Tag: para +#: basic_mapping.xml:1518 +#, no-c-format +msgid "" +"<literal>update, insert</literal> (optional - defaults to <literal>true</" +"literal>) specifies that the mapped columns should be included in SQL " +"<literal>UPDATE</literal> and/or <literal>INSERT</literal> statements. " +"Setting both to <literal>false</literal> allows a pure \"derived\" " +"association whose value is initialized from some other property that maps to " +"the same colum(s) or by a trigger or other application." msgstr "" +"<literal>update, insert</literal> (opcional - valor default <literal>true</" +"literal>): especifica que as colunas mapeadas dever ser incluidas em " +"instruções SQL de <literal>UPDATE</literal> e/ou <literal>INSERT</literal>. " +"Setando ambas para <literal>false</literal> você permite uma associação " +"\"derivada\" pura cujos valores são inicializados de algumas outras " +"propriedades que mapeiam a mesma coluna ou por uma trigger ou outra " +"aplicação." -#: index.docbook:1527 -msgid "<literal>property-ref</literal>: (optional) The name of a property of the associated class that is joined to this foreign key. If not specified, the primary key of the associated class is used." +#. Tag: para +#: basic_mapping.xml:1527 +#, no-c-format +msgid "" +"<literal>property-ref</literal>: (optional) The name of a property of the " +"associated class that is joined to this foreign key. If not specified, the " +"primary key of the associated class is used." msgstr "" +"<literal>property-ref</literal>: (opcional) O nome da propriedade da classe " +"associada que faz a junção desta foreign key. Se não especificada, a chave " +"primaria da classe associada será utilizada." -#: index.docbook:1540 -msgid "<literal>unique</literal> (optional): Enable the DDL generation of a unique constraint for the foreign-key column. Also, allow this to be the target of a <literal>property-ref</literal>. This makes the association multiplicity effectively one to one." +#. Tag: para +#: basic_mapping.xml:1540 +#, no-c-format +msgid "" +"<literal>unique</literal> (optional): Enable the DDL generation of a unique " +"constraint for the foreign-key column. Also, allow this to be the target of " +"a <literal>property-ref</literal>. This makes the association multiplicity " +"effectively one to one." msgstr "" +"<literal>unique</literal> (opcional): Habilita a geração DDL de uma " +"constraint unique para a coluna foreign-key. Alem disso, permite ser o alvo " +"de uma <literal>property-ref</literal>. Isso torna a associação multipla " +"efetivamente um para um." -#: index.docbook:1548 -msgid "<literal>not-null</literal> (optional): Enable the DDL generation of a nullability constraint for the foreign key columns." +#. Tag: para +#: basic_mapping.xml:1548 +#, no-c-format +msgid "" +"<literal>not-null</literal> (optional): Enable the DDL generation of a " +"nullability constraint for the foreign key columns." msgstr "" +"<literal>not-null</literal> (opcional): Habilita a geração DDL de uma " +"constraint de nulidade para as foreign keys." -#: index.docbook:1554 -msgid "<literal>optimistic-lock</literal> (optional - defaults to <literal>true</literal>): Specifies that updates to this property do or do not require acquisition of the optimistic lock. In other words, dertermines if a version increment should occur when this property is dirty." +#. Tag: para +#: basic_mapping.xml:1554 +#, no-c-format +msgid "" +"<literal>optimistic-lock</literal> (optional - defaults to <literal>true</" +"literal>): Specifies that updates to this property do or do not require " +"acquisition of the optimistic lock. In other words, dertermines if a version " +"increment should occur when this property is dirty." msgstr "" +"<literal>optimistic-lock</literal> (opcional - valor default <literal>true</" +"literal>): Especifica se mudanças desta propriedade requerem ou não " +"travamento otimista. Em outras palavras, determina se um incremento de " +"versão deve ocorrer quando esta propriedade está suja." -#: index.docbook:1562 -msgid "<literal>lazy</literal> (optional - defaults to <literal>proxy</literal>): By default, single point associations are proxied. <literal>lazy=\"no-proxy\"</literal> specifies that the property should be fetched lazily when the instance variable is first accessed (requires build-time bytecode instrumentation). <literal>lazy=\"false\"</literal> specifies that the association will always be eagerly fetched." +#. Tag: para +#: basic_mapping.xml:1562 +#, no-c-format +msgid "" +"<literal>lazy</literal> (optional - defaults to <literal>proxy</literal>): " +"By default, single point associations are proxied. <literal>lazy=\"no-proxy" +"\"</literal> specifies that the property should be fetched lazily when the " +"instance variable is first accessed (requires build-time bytecode " +"instrumentation). <literal>lazy=\"false\"</literal> specifies that the " +"association will always be eagerly fetched." msgstr "" +"<literal>lazy</literal>(opcional – valor default <literal>proxy</literal>): " +"Por default, associações de ponto unico são envoltas em um proxie. " +"<literal>lazy=\"no-proxy\"</literal> especifica que a propriedade deve ser " +"trazida de forma tardia quando a instancia da variável é acessada pela " +"primeira vez (requer instrumentação bytecode em tempo de criação) " +"<literal>lazy=\"false\"</literal> especifica que a associação será sempre " +"recuperada fortemente." -#: index.docbook:1572 -msgid "<literal>not-found</literal> (optional - defaults to <literal>exception</literal>): Specifies how foreign keys that reference missing rows will be handled: <literal>ignore</literal> will treat a missing row as a null association." +#. Tag: para +#: basic_mapping.xml:1572 +#, no-c-format +msgid "" +"<literal>not-found</literal> (optional - defaults to <literal>exception</" +"literal>): Specifies how foreign keys that reference missing rows will be " +"handled: <literal>ignore</literal> will treat a missing row as a null " +"association." msgstr "" +"<literal>not-found</literal> (opcional - valor default <literal>exception</" +"literal>): Especifica como as foreign keys que referenciam linhas ausentes " +"serão tratadas: <literal>ignore</literal> irá tratar a linha ausente como " +"ama associaççao de null" -#: index.docbook:1579, index.docbook:1733 -msgid "<literal>entity-name</literal> (optional): The entity name of the associated class." +#. Tag: para +#: basic_mapping.xml:1579 basic_mapping.xml:1733 +#, no-c-format +msgid "" +"<literal>entity-name</literal> (optional): The entity name of the associated " +"class." msgstr "" +"<literal>entity-name</literal> (opcional): O nome da entidade da classe " +"associada." -#: index.docbook:1585 -msgid "<literal>formula</literal> (optional): an SQL expression that defines the value for a <emphasis>computed</emphasis> foreign key." +#. Tag: para +#: basic_mapping.xml:1585 +#, no-c-format +msgid "" +"<literal>formula</literal> (optional): an SQL expression that defines the " +"value for a <emphasis>computed</emphasis> foreign key." msgstr "" +"<literal>formula</literal> (optional): Uma expressão SQL que define um valor " +"para um foreign key <emphasis>computed</emphasis>." -#: index.docbook:1592 -msgid "Setting a value of the <literal>cascade</literal> attribute to any meaningful value other than <literal>none</literal> will propagate certain operations to the associated object. The meaningful values are the names of Hibernate's basic operations, <literal>persist, merge, delete, save-update, evict, replicate, lock, refresh</literal>, as well as the special values <literal>delete-orphan</literal> and <literal>all</literal> and comma-separated combinations of operation names, for example, <literal>cascade=\"persist,merge,evict\"</literal> or <literal>cascade=\"all,delete-orphan\"</literal>. See <xref linkend=\"objectstate-transitive\"/> for a full explanation. Note that single valued associations (many-to-one and one-to-one associations) do not support orphan delete." +#. Tag: para +#: basic_mapping.xml:1592 +#, no-c-format +msgid "" +"Setting a value of the <literal>cascade</literal> attribute to any " +"meaningful value other than <literal>none</literal> will propagate certain " +"operations to the associated object. The meaningful values are the names of " +"Hibernate's basic operations, <literal>persist, merge, delete, save-update, " +"evict, replicate, lock, refresh</literal>, as well as the special values " +"<literal>delete-orphan</literal> and <literal>all</literal> and comma-" +"separated combinations of operation names, for example, <literal>cascade=" +"\"persist,merge,evict\"</literal> or <literal>cascade=\"all,delete-orphan\"</" +"literal>. See <xref linkend=\"objectstate-transitive\"/> for a full " +"explanation. Note that single valued associations (many-to-one and one-to-" +"one associations) do not support orphan delete." msgstr "" +"Setar o valor do atributo <literal>cascade</literal> para qualquer valor " +"significativo diferente de <literal>none</literal> irá propagar certas " +"operações ao objeto associado. Os valores significativos são os nomes das " +"operações básicas do Hibernate, <literal>persist, merge, delete, save-" +"update, evict, replicate, lock, refresh</literal>, assim como os valores " +"especiais <literal>delete-orphan</literal> e <literal>all</literal> e " +"combinações de nomes de operações separadas por vírgula, como por exemplo, " +"<literal>cascade=\"persist,merge,evict\"</literal> ou <literal>cascade=\"all," +"delete-orphan\"</literal>. Veja a seção <xref linkend=\"objectstate-" +"transitive\"/> para uma explicação completa. Note que associações valoradas " +"simples (associações muitos-pra-um, e um-pra-um) não suportam orphan delete." -#: index.docbook:1605 -msgid "A typical <literal>many-to-one</literal> declaration looks as simple as this:" +#. Tag: para +#: basic_mapping.xml:1605 +#, no-c-format +msgid "" +"A typical <literal>many-to-one</literal> declaration looks as simple as this:" msgstr "" +"Uma típica declaração <literal>muitos-pra-um</literal> se parece com esta:" -#: index.docbook:1609 -msgid "<![CDATA[<many-to-one name=\"product\" class=\"Product\" column=\"PRODUCT_ID\"/>]]>" +#. Tag: programlisting +#: basic_mapping.xml:1609 +#, no-c-format +msgid "" +"<![CDATA[<many-to-one name=\"product\" class=\"Product\" column=\"PRODUCT_ID" +"\"/>]]>" msgstr "" -#: index.docbook:1611 -msgid "The <literal>property-ref</literal> attribute should only be used for mapping legacy data where a foreign key refers to a unique key of the associated table other than the primary key. This is an ugly relational model. For example, suppose the <literal>Product</literal> class had a unique serial number, that is not the primary key. (The <literal>unique</literal> attribute controls Hibernate's DDL generation with the SchemaExport tool.)" +#. Tag: para +#: basic_mapping.xml:1611 +#, no-c-format +msgid "" +"The <literal>property-ref</literal> attribute should only be used for " +"mapping legacy data where a foreign key refers to a unique key of the " +"associated table other than the primary key. This is an ugly relational " +"model. For example, suppose the <literal>Product</literal> class had a " +"unique serial number, that is not the primary key. (The <literal>unique</" +"literal> attribute controls Hibernate's DDL generation with the SchemaExport " +"tool.)" msgstr "" +"O atributo <literal>property-ref</literal> deve apenas ser usado para mapear " +"dados legados onde uma chave estrangeira se referencia a uma chave exclusiva " +"da tabela associada que não seja à chave primária. Este é um modelo " +"relacional desagradável. Por exemplo, suponha que a classe <literal>Product</" +"literal> tenha um número seqüencial exclusivo, que não é a chave primária. " +"(O atributo <literal>unique</literal> controla a geração de DDL do Hibernate " +"com a ferramenta SchemaExport.)" -#: index.docbook:1620 -msgid "<![CDATA[<property name=\"serialNumber\" unique=\"true\" type=\"string\" column=\"SERIAL_NUMBER\"/>]]>" +#. Tag: programlisting +#: basic_mapping.xml:1620 +#, no-c-format +msgid "" +"<![CDATA[<property name=\"serialNumber\" unique=\"true\" type=\"string\" " +"column=\"SERIAL_NUMBER\"/>]]>" msgstr "" -#: index.docbook:1622 +#. Tag: para +#: basic_mapping.xml:1622 +#, no-c-format msgid "Then the mapping for <literal>OrderItem</literal> might use:" -msgstr "" +msgstr "Então o mapeamento para <literal>OrderItem</literal> poderia usar:" -#: index.docbook:1626 -msgid "<![CDATA[<many-to-one name=\"product\" property-ref=\"serialNumber\" column=\"PRODUCT_SERIAL_NUMBER\"/>]]>" +#. Tag: programlisting +#: basic_mapping.xml:1626 +#, no-c-format +msgid "" +"<![CDATA[<many-to-one name=\"product\" property-ref=\"serialNumber\" column=" +"\"PRODUCT_SERIAL_NUMBER\"/>]]>" msgstr "" -#: index.docbook:1628 +#. Tag: para +#: basic_mapping.xml:1628 +#, no-c-format msgid "This is certainly not encouraged, however." -msgstr "" +msgstr "Porém, isto obviamente não é indicado, nunca." -#: index.docbook:1632 -msgid "If the referenced unique key comprises multiple properties of the associated entity, you should map the referenced properties inside a named <literal><properties></literal> element." +#. Tag: para +#: basic_mapping.xml:1632 +#, no-c-format +msgid "" +"If the referenced unique key comprises multiple properties of the associated " +"entity, you should map the referenced properties inside a named <literal><" +"properties></literal> element." msgstr "" +"Se a chave exclusiva referenciada engloba múltiplas propriedades da entidade " +"associada, você deve mapear as propriedades referenciadas dentro de um " +"elemento chamado <literal><properties></literal>" -#: index.docbook:1637 -msgid "If the referenced unique key is the property of a component, you may specify a property path:" +#. Tag: para +#: basic_mapping.xml:1637 +#, no-c-format +msgid "" +"If the referenced unique key is the property of a component, you may specify " +"a property path:" msgstr "" +"Se a chave exclusiva referenciada é a propriedade de um componente, você " +"pode especificar um caminho para a propriedade." -#: index.docbook:1641 -msgid "<![CDATA[<many-to-one name=\"owner\" property-ref=\"identity.ssn\" column=\"OWNER_SSN\"/>]]>" +#. Tag: programlisting +#: basic_mapping.xml:1641 +#, no-c-format +msgid "" +"<![CDATA[<many-to-one name=\"owner\" property-ref=\"identity.ssn\" column=" +"\"OWNER_SSN\"/>]]>" msgstr "" -#: index.docbook:1646 +#. Tag: title +#: basic_mapping.xml:1646 +#, no-c-format msgid "one-to-one" -msgstr "" +msgstr "one-to-one (um-pra-um)" -#: index.docbook:1648 -msgid "A one-to-one association to another persistent class is declared using a <literal>one-to-one</literal> element." +#. Tag: para +#: basic_mapping.xml:1648 +#, no-c-format +msgid "" +"A one-to-one association to another persistent class is declared using a " +"<literal>one-to-one</literal> element." msgstr "" +"Uma associação um-pra-um para outra classe persistente é declarada usando um " +"elemento <literal>one-to-one </literal>." -#: index.docbook:1666 +#. Tag: programlisting +#: basic_mapping.xml:1666 +#, no-c-format msgid "" - "<![CDATA[<one-to-one\n" - " name=\"propertyName\"\n" - " class=\"ClassName\"\n" - " cascade=\"cascade_style\"\n" - " constrained=\"true|false\"\n" - " fetch=\"join|select\"\n" - " property-ref=\"propertyNameFromAssociatedClass\"\n" - " access=\"field|property|ClassName\"\n" - " formula=\"any SQL expression\"\n" - " lazy=\"proxy|no-proxy|false\"\n" - " entity-name=\"EntityName\"\n" - " node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" - " embed-xml=\"true|false\"\n" - " foreign-key=\"foreign_key_name\"\n" - "/>]]>" +"<![CDATA[<one-to-one\n" +" name=\"propertyName\"\n" +" class=\"ClassName\"\n" +" cascade=\"cascade_style\"\n" +" constrained=\"true|false\"\n" +" fetch=\"join|select\"\n" +" property-ref=\"propertyNameFromAssociatedClass\"\n" +" access=\"field|property|ClassName\"\n" +" formula=\"any SQL expression\"\n" +" lazy=\"proxy|no-proxy|false\"\n" +" entity-name=\"EntityName\"\n" +" node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" +" embed-xml=\"true|false\"\n" +" foreign-key=\"foreign_key_name\"\n" +"/>]]>" msgstr "" -#: index.docbook:1680 -msgid "<literal>cascade</literal> (optional) specifies which operations should be cascaded from the parent object to the associated object." +#. Tag: para +#: basic_mapping.xml:1680 +#, no-c-format +msgid "" +"<literal>cascade</literal> (optional) specifies which operations should be " +"cascaded from the parent object to the associated object." msgstr "" +"<literal>cascade</literal> (opcional): Especifica qual operação deve ser " +"cascateada do objeto pai para o objeto associado." -#: index.docbook:1686 -msgid "<literal>constrained</literal> (optional) specifies that a foreign key constraint on the primary key of the mapped table references the table of the associated class. This option affects the order in which <literal>save()</literal> and <literal>delete()</literal> are cascaded, and determines whether the association may be proxied (it is also used by the schema export tool)." +#. Tag: para +#: basic_mapping.xml:1686 +#, no-c-format +msgid "" +"<literal>constrained</literal> (optional) specifies that a foreign key " +"constraint on the primary key of the mapped table references the table of " +"the associated class. This option affects the order in which <literal>save()" +"</literal> and <literal>delete()</literal> are cascaded, and determines " +"whether the association may be proxied (it is also used by the schema export " +"tool)." msgstr "" +"<literal>constrained</literal> (opcional): Especifica que uma chave " +"estrangeira constraint na chave primária da tabela mapeada referencia a " +"tabela da classe associada, Esta opção afeta a ordem em queh <literal>save()" +"</literal> e <literal>delete()</literal> são cascateadas, e determina se a " +"associação pode ser substituída (isto também é usado pela ferramenta schema " +"export)." -#: index.docbook:1701 -msgid "<literal>property-ref</literal>: (optional) The name of a property of the associated class that is joined to the primary key of this class. If not specified, the primary key of the associated class is used." +#. Tag: para +#: basic_mapping.xml:1701 +#, no-c-format +msgid "" +"<literal>property-ref</literal>: (optional) The name of a property of the " +"associated class that is joined to the primary key of this class. If not " +"specified, the primary key of the associated class is used." msgstr "" +"<literal>property-ref</literal>(opcional): O nome da propriedade da classe " +"associada que é ligada a chave primária desta classe. Se não for " +"especificada, a chave primária da classe associada é utilizada." -#: index.docbook:1714 -msgid "<literal>formula</literal> (optional): Almost all one to one associations map to the primary key of the owning entity. In the rare case that this is not the case, you may specify a some other column, columns or expression to join on using an SQL formula. (See <literal>org.hibernate.test.onetooneformula</literal> for an example.)" +#. Tag: para +#: basic_mapping.xml:1714 +#, no-c-format +msgid "" +"<literal>formula</literal> (optional): Almost all one to one associations " +"map to the primary key of the owning entity. In the rare case that this is " +"not the case, you may specify a some other column, columns or expression to " +"join on using an SQL formula. (See <literal>org.hibernate.test." +"onetooneformula</literal> for an example.)" msgstr "" +"<literal>formula</literal> (opcional): Quase todas associações um-pra-um " +"mapeiam para a chave primária da entidade dona. No caso raro, que não é o " +"caso, você pode especificar uma outra coluna, colunas ou expressões para " +"juntar utilizando uma formula SQL. (Veja <literal>org.hibernate.test." +"onetooneformula</literal> para exemplo)." -#: index.docbook:1722 -msgid "<literal>lazy</literal> (optional - defaults to <literal>proxy</literal>): By default, single point associations are proxied. <literal>lazy=\"no-proxy\"</literal> specifies that the property should be fetched lazily when the instance variable is first accessed (requires build-time bytecode instrumentation). <literal>lazy=\"false\"</literal> specifies that the association will always be eagerly fetched. <emphasis>Note that if <literal>constrained=\"false\"</literal>, proxying is impossible and Hibernate will eager fetch the association!</emphasis>" +#. Tag: para +#: basic_mapping.xml:1722 +#, no-c-format +msgid "" +"<literal>lazy</literal> (optional - defaults to <literal>proxy</literal>): " +"By default, single point associations are proxied. <literal>lazy=\"no-proxy" +"\"</literal> specifies that the property should be fetched lazily when the " +"instance variable is first accessed (requires build-time bytecode " +"instrumentation). <literal>lazy=\"false\"</literal> specifies that the " +"association will always be eagerly fetched. <emphasis>Note that if " +"<literal>constrained=\"false\"</literal>, proxying is impossible and " +"Hibernate will eager fetch the association!</emphasis>" msgstr "" +"<literal>lazy</literal> (opcional – valor default <literal>proxy</literal>): " +"Por default, associações single point são proxied. <literal>lazy=\"no-proxy" +"\"</literal> especifica que a propriedade deve ser fetched lazily quando o " +"atributo é acessado pela primeira vez (requer build-time bytecode " +"instrumentation). <literal>lazy=\"false\"</literal> especifica que a " +"associação vai sempre ser avidamente fetched. <emphasis>Note que se " +"<literal>constrained=\"false\"</literal>, proxing é impossível e o Hibernate " +"vai ávido fetch a associação!</emphasis>" -#: index.docbook:1740 +#. Tag: para +#: basic_mapping.xml:1740 +#, no-c-format msgid "There are two varieties of one-to-one association:" -msgstr "" +msgstr "Existem duas variedades de associações um-pra-um:" -#: index.docbook:1744 +#. Tag: para +#: basic_mapping.xml:1744 +#, no-c-format msgid "primary key associations" -msgstr "" +msgstr "associações de chave primária" -#: index.docbook:1747 +#. Tag: para +#: basic_mapping.xml:1747 +#, no-c-format msgid "unique foreign key associations" -msgstr "" +msgstr "associações de chave estrangeira exclusiva" -#: index.docbook:1752 -msgid "Primary key associations don't need an extra table column; if two rows are related by the association then the two table rows share the same primary key value. So if you want two objects to be related by a primary key association, you must make sure that they are assigned the same identifier value!" +#. Tag: para +#: basic_mapping.xml:1752 +#, no-c-format +msgid "" +"Primary key associations don't need an extra table column; if two rows are " +"related by the association then the two table rows share the same primary " +"key value. So if you want two objects to be related by a primary key " +"association, you must make sure that they are assigned the same identifier " +"value!" msgstr "" +"Associações de chave primária não necessitam de uma coluna extra de tabela; " +"se duas linhas são relacionadas pela associação então as duas linhas da " +"tabela dividem a mesmo valor da chave primária. Assim, se você quer que dois " +"objetos sejam relacionados por uma associação de chave primária, você deve " +"ter certeza que eles são assinados com o mesmo valor identificador!" -#: index.docbook:1759 -msgid "For a primary key association, add the following mappings to <literal>Employee</literal> and <literal>Person</literal>, respectively." +#. Tag: para +#: basic_mapping.xml:1759 +#, no-c-format +msgid "" +"For a primary key association, add the following mappings to " +"<literal>Employee</literal> and <literal>Person</literal>, respectively." msgstr "" +"Para uma associação de chave primária, adicione os seguintes mapeamentos em " +"<literal>Employee</literal> e <literal>Person</literal>, respectivamente." -#: index.docbook:1764 +#. Tag: programlisting +#: basic_mapping.xml:1764 +#, no-c-format msgid "<![CDATA[<one-to-one name=\"person\" class=\"Person\"/>]]>" msgstr "" -#: index.docbook:1765 -msgid "<![CDATA[<one-to-one name=\"employee\" class=\"Employee\" constrained=\"true\"/>]]>" +#. Tag: programlisting +#: basic_mapping.xml:1765 +#, no-c-format +msgid "" +"<![CDATA[<one-to-one name=\"employee\" class=\"Employee\" constrained=\"true" +"\"/>]]>" msgstr "" -#: index.docbook:1767 -msgid "Now we must ensure that the primary keys of related rows in the PERSON and EMPLOYEE tables are equal. We use a special Hibernate identifier generation strategy called <literal>foreign</literal>:" +#. Tag: para +#: basic_mapping.xml:1767 +#, no-c-format +msgid "" +"Now we must ensure that the primary keys of related rows in the PERSON and " +"EMPLOYEE tables are equal. We use a special Hibernate identifier generation " +"strategy called <literal>foreign</literal>:" msgstr "" +"Agora nós devemos assegurar que as chaves primárias de linhas relacionadas " +"nas tabelas PERSON e EMPLOYEE são iguais. Nós usamos uma estratégia especial " +"de geração de identificador do Hibernate chamada <literal>foreign</literal>:" -#: index.docbook:1773 +#. Tag: programlisting +#: basic_mapping.xml:1773 +#, no-c-format msgid "" - "<![CDATA[<class name=\"person\" table=\"PERSON\">\n" - " <id name=\"id\" column=\"PERSON_ID\">\n" - " <generator class=\"foreign\">\n" - " <param name=\"property\">employee</param>\n" - " </generator>\n" - " </id>\n" - " ...\n" - " <one-to-one name=\"employee\"\n" - " class=\"Employee\"\n" - " constrained=\"true\"/>\n" - "</class>]]>" +"<![CDATA[<class name=\"person\" table=\"PERSON\">\n" +" <id name=\"id\" column=\"PERSON_ID\">\n" +" <generator class=\"foreign\">\n" +" <param name=\"property\">employee</param>\n" +" </generator>\n" +" </id>\n" +" ...\n" +" <one-to-one name=\"employee\"\n" +" class=\"Employee\"\n" +" constrained=\"true\"/>\n" +"</class>]]>" msgstr "" -#: index.docbook:1775 -msgid "A newly saved instance of <literal>Person</literal> is then assigned the same primary key value as the <literal>Employee</literal> instance refered with the <literal>employee</literal> property of that <literal>Person</literal>." +#. Tag: para +#: basic_mapping.xml:1775 +#, no-c-format +msgid "" +"A newly saved instance of <literal>Person</literal> is then assigned the " +"same primary key value as the <literal>Employee</literal> instance refered " +"with the <literal>employee</literal> property of that <literal>Person</" +"literal>." msgstr "" +"Uma nova instância de <literal>Person</literal> salva recentemente é então " +"assinada com o mesmo valor da chave primária da instância de " +"<literal>employee</literal> referenciada com a propriedade " +"<literal>employee</literal> daquela <literal>Person</literal>." -#: index.docbook:1781 -msgid "Alternatively, a foreign key with a unique constraint, from <literal>Employee</literal> to <literal>Person</literal>, may be expressed as:" +#. Tag: para +#: basic_mapping.xml:1781 +#, no-c-format +msgid "" +"Alternatively, a foreign key with a unique constraint, from " +"<literal>Employee</literal> to <literal>Person</literal>, may be expressed " +"as:" msgstr "" +"Alternativamente, uma chave estrangeira com uma unique constraint, de " +"<literal>Employee</literal> para <literal>Person</literal>, pode ser " +"expressa como:" -#: index.docbook:1786 -msgid "<![CDATA[<many-to-one name=\"person\" class=\"Person\" column=\"PERSON_ID\" unique=\"true\"/>]]>" +#. Tag: programlisting +#: basic_mapping.xml:1786 +#, no-c-format +msgid "" +"<![CDATA[<many-to-one name=\"person\" class=\"Person\" column=\"PERSON_ID\" " +"unique=\"true\"/>]]>" msgstr "" -#: index.docbook:1788 -msgid "And this association may be made bidirectional by adding the following to the <literal>Person</literal> mapping:" +#. Tag: para +#: basic_mapping.xml:1788 +#, no-c-format +msgid "" +"And this association may be made bidirectional by adding the following to " +"the <literal>Person</literal> mapping:" msgstr "" +"E esta associação pode ser feita de forma bi-direcional adicionando o " +"seguinte no mapeamento de <literal>Person</literal>:" -#: index.docbook:1793 -msgid "<![CDATA[<one-to-one name=\"employee\" class=\"Employee\" property-ref=\"person\"/>]]>" +#. Tag: programlisting +#: basic_mapping.xml:1793 +#, no-c-format +msgid "" +"<![CDATA[<one-to-one name=\"employee\" class=\"Employee\" property-ref=" +"\"person\"/>]]>" msgstr "" -#: index.docbook:1798 +#. Tag: title +#: basic_mapping.xml:1798 +#, no-c-format msgid "natural-id" -msgstr "" +msgstr "natural-id" -#: index.docbook:1800 +#. Tag: programlisting +#: basic_mapping.xml:1800 +#, no-c-format msgid "" - "<![CDATA[<natural-id mutable=\"true|false\"/>\n" - " <property ... />\n" - " <many-to-one ... />\n" - " ......\n" - "</natural-id>]]>" +"<![CDATA[<natural-id mutable=\"true|false\"/>\n" +" <property ... />\n" +" <many-to-one ... />\n" +" ......\n" +"</natural-id>]]>" msgstr "" -#: index.docbook:1802 -msgid "Even though we recommend the use of surrogate keys as primary keys, you should still try to identify natural keys for all entities. A natural key is a property or combination of properties that is unique and non-null. If it is also immutable, even better. Map the properties of the natural key inside the <literal><natural-id></literal> element. Hibernate will generate the necessary unique key and nullability constraints, and your mapping will be more self-documenting." +#. Tag: para +#: basic_mapping.xml:1802 +#, no-c-format +msgid "" +"Even though we recommend the use of surrogate keys as primary keys, you " +"should still try to identify natural keys for all entities. A natural key is " +"a property or combination of properties that is unique and non-null. If it " +"is also immutable, even better. Map the properties of the natural key inside " +"the <literal><natural-id></literal> element. Hibernate will generate " +"the necessary unique key and nullability constraints, and your mapping will " +"be more self-documenting." msgstr "" +"Embora nós recomendemos o uso de surrogate keys como chaves primárias, você " +"deve ainda identificar chaves naturais para todas as entidades. Uma chave " +"natural é uma propriedade ou combinação de propriedades que é exclusiva e " +"não nula. Se não pude ser modificada, melhor ainda. Mapeie as propriedades " +"da chave natural dentro do elemento <literal><natural-id></literal>. O " +"Hibernate irá gerar a chave exclusiva necessária e as constraints de " +"nullability , e seu mapeamento será apropriadamente auto documentado." -#: index.docbook:1811 -msgid "We strongly recommend that you implement <literal>equals()</literal> and <literal>hashCode()</literal> to compare the natural key properties of the entity." +#. Tag: para +#: basic_mapping.xml:1811 +#, no-c-format +msgid "" +"We strongly recommend that you implement <literal>equals()</literal> and " +"<literal>hashCode()</literal> to compare the natural key properties of the " +"entity." msgstr "" +"Nós recomendamos com enfase que você implemente <literal>equals()</literal> " +"e <literal>hashCode()</literal> para comparar as propriedades da chave " +"natural da entidade." -#: index.docbook:1816 -msgid "This mapping is not intended for use with entities with natural primary keys." +#. Tag: para +#: basic_mapping.xml:1816 +#, no-c-format +msgid "" +"This mapping is not intended for use with entities with natural primary keys." msgstr "" +"Este mapeamento não tem o objetivo de uso com entidades com natural chaves " +"primárias." -#: index.docbook:1822 -msgid "<literal>mutable</literal> (optional, defaults to <literal>false</literal>): By default, natural identifier properties as assumed to be immutable (constant)." +#. Tag: para +#: basic_mapping.xml:1822 +#, no-c-format +msgid "" +"<literal>mutable</literal> (optional, defaults to <literal>false</literal>): " +"By default, natural identifier properties as assumed to be immutable " +"(constant)." msgstr "" +"<literal>mutable</literal> mutable (opcional, valor default<literal>false</" +"literal>): Por default, propriedades naturais identificadoras são " +"consideradas imutáveis (constante)." -#: index.docbook:1832 +#. Tag: title +#: basic_mapping.xml:1832 +#, no-c-format msgid "component, dynamic-component" -msgstr "" +msgstr "componente, componente dinâmico" -#: index.docbook:1834 -msgid "The <literal><component></literal> element maps properties of a child object to columns of the table of a parent class. Components may, in turn, declare their own properties, components or collections. See \"Components\" below." +#. Tag: para +#: basic_mapping.xml:1834 +#, no-c-format +msgid "" +"The <literal><component></literal> element maps properties of a child " +"object to columns of the table of a parent class. Components may, in turn, " +"declare their own properties, components or collections. See \"Components\" " +"below." msgstr "" +"O elemento<literal><component></literal> mapeia propriedades de um " +"objeto filho para colunas da tabela de uma classe pai. Componentes podem, um " +"após o outro, declarar suas próprias propriedades, componentes ou coleções. " +"Veja \"Components\" abaixo." -#: index.docbook:1852 +#. Tag: programlisting +#: basic_mapping.xml:1852 +#, no-c-format msgid "" - "<![CDATA[<component\n" - " name=\"propertyName\"\n" - " class=\"className\"\n" - " insert=\"true|false\"\n" - " update=\"true|false\"\n" - " access=\"field|property|ClassName\"\n" - " lazy=\"true|false\"\n" - " optimistic-lock=\"true|false\"\n" - " unique=\"true|false\"\n" - " node=\"element-name|.\"\n" - ">\n" - "\n" - " <property ...../>\n" - " <many-to-one .... />\n" - " ........\n" - "</component>]]>" +"<![CDATA[<component\n" +" name=\"propertyName\"\n" +" class=\"className\"\n" +" insert=\"true|false\"\n" +" update=\"true|false\"\n" +" access=\"field|property|ClassName\"\n" +" lazy=\"true|false\"\n" +" optimistic-lock=\"true|false\"\n" +" unique=\"true|false\"\n" +" node=\"element-name|.\"\n" +">\n" +"\n" +" <property ...../>\n" +" <many-to-one .... />\n" +" ........\n" +"</component>]]>" msgstr "" -#: index.docbook:1860 -msgid "<literal>class</literal> (optional - defaults to the property type determined by reflection): The name of the component (child) class." +#. Tag: para +#: basic_mapping.xml:1860 +#, no-c-format +msgid "" +"<literal>class</literal> (optional - defaults to the property type " +"determined by reflection): The name of the component (child) class." msgstr "" +"<literal>class</literal> (opcional – valor default para o tipo de " +"propriedade determinada por reflection): O nome da classe (filha) do " +"componente." -#: index.docbook:1866, index.docbook:1955 -msgid "<literal>insert</literal>: Do the mapped columns appear in SQL <literal>INSERT</literal>s?" +#. Tag: para +#: basic_mapping.xml:1866 basic_mapping.xml:1955 +#, no-c-format +msgid "" +"<literal>insert</literal>: Do the mapped columns appear in SQL " +"<literal>INSERT</literal>s?" msgstr "" +"<literal>insert</literal>: As colunas mapeadas aparecem nos SQL de " +"<literal>INSERT</literal>s?" -#: index.docbook:1872, index.docbook:1961 -msgid "<literal>update</literal>: Do the mapped columns appear in SQL <literal>UPDATE</literal>s?" +#. Tag: para +#: basic_mapping.xml:1872 basic_mapping.xml:1961 +#, no-c-format +msgid "" +"<literal>update</literal>: Do the mapped columns appear in SQL " +"<literal>UPDATE</literal>s?" msgstr "" +"<literal>update</literal>: As colunas mapeadas aparecem nos SQL de " +"<literal>UPDATE</literal>s?" -#: index.docbook:1884 -msgid "<literal>lazy</literal> (optional - defaults to <literal>false</literal>): Specifies that this component should be fetched lazily when the instance variable is first accessed (requires build-time bytecode instrumentation)." +#. Tag: para +#: basic_mapping.xml:1884 +#, no-c-format +msgid "" +"<literal>lazy</literal> (optional - defaults to <literal>false</literal>): " +"Specifies that this component should be fetched lazily when the instance " +"variable is first accessed (requires build-time bytecode instrumentation)." msgstr "" +"<literal>lazy</literal> (opcional - valor default <literal>false</literal>): " +"Especifica que este componente deve ser fetched lazily quando o atributo for " +"acessado pela primeira vez (requer build-time bytecode instrumentation)." -#: index.docbook:1891 -msgid "<literal>optimistic-lock</literal> (optional - defaults to <literal>true</literal>): Specifies that updates to this component do or do not require acquisition of the optimistic lock. In other words, determines if a version increment should occur when this property is dirty." +#. Tag: para +#: basic_mapping.xml:1891 +#, no-c-format +msgid "" +"<literal>optimistic-lock</literal> (optional - defaults to <literal>true</" +"literal>): Specifies that updates to this component do or do not require " +"acquisition of the optimistic lock. In other words, determines if a version " +"increment should occur when this property is dirty." msgstr "" +"<literal>optimistic-lock</literal> (opcional – valor default <literal>true</" +"literal>): Especifica que atualizações para este componente requerem ou não " +"aquisição de um lock otimista. Em outras palavras, determina se uma versão " +"de incremento deve ocorrer quando esta propriedade estiver modificada." -#: index.docbook:1899, index.docbook:1975 -msgid "<literal>unique</literal> (optional - defaults to <literal>false</literal>): Specifies that a unique constraint exists upon all mapped columns of the component." +#. Tag: para +#: basic_mapping.xml:1899 basic_mapping.xml:1975 +#, fuzzy, no-c-format +msgid "" +"<literal>unique</literal> (optional - defaults to <literal>false</literal>): " +"Specifies that a unique constraint exists upon all mapped columns of the " +"component." msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>unique</literal> (opcional – valor default <literal>false</" +"literal>): Especifica que existe uma unique constraint em todas as colunas " +"mapeadas do componente.\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>unique</literal> (opcional – valor defautl <literal>false</" +"literal>): Especifica que uma unique constraint existe em todas as colunas " +"mapeadas do componente." -#: index.docbook:1908 -msgid "The child <literal><property></literal> tags map properties of the child class to table columns." +#. Tag: para +#: basic_mapping.xml:1908 +#, no-c-format +msgid "" +"The child <literal><property></literal> tags map properties of the " +"child class to table columns." msgstr "" +"A tag filha <literal><property></literal> acrescenta a propriedade de " +"mapeamento da classe filha para colunas de uma tabela." -#: index.docbook:1913 -msgid "The <literal><component></literal> element allows a <literal><parent></literal> subelement that maps a property of the component class as a reference back to the containing entity." +#. Tag: para +#: basic_mapping.xml:1913 +#, no-c-format +msgid "" +"The <literal><component></literal> element allows a <literal><" +"parent></literal> subelement that maps a property of the component class " +"as a reference back to the containing entity." msgstr "" +"O elemento <literal><component></literal> permite um sub-elemento " +"<literal><parent></literal> mapeie uma propriedade da classe do " +"componente como uma referencia de volta para a entidade que o contém." -#: index.docbook:1919 -msgid "The <literal><dynamic-component></literal> element allows a <literal>Map</literal> to be mapped as a component, where the property names refer to keys of the map, see <xref linkend=\"components-dynamic\"/>." +#. Tag: para +#: basic_mapping.xml:1919 +#, no-c-format +msgid "" +"The <literal><dynamic-component></literal> element allows a " +"<literal>Map</literal> to be mapped as a component, where the property names " +"refer to keys of the map, see <xref linkend=\"components-dynamic\"/>." msgstr "" +"O elemento <literal><dynamic-component></literal> permite que um " +"<literal>Map</literal> possa ser mapeado como um componente onde os nomes " +"das propriedades referem-se para as chaves no mapa, veja <xref linkend=" +"\"components-dynamic\"/>." -#: index.docbook:1928 +#. Tag: title +#: basic_mapping.xml:1928 +#, no-c-format msgid "properties" -msgstr "" +msgstr "propriedades" -#: index.docbook:1930 -msgid "The <literal><properties></literal> element allows the definition of a named, logical grouping of properties of a class. The most important use of the construct is that it allows a combination of properties to be the target of a <literal>property-ref</literal>. It is also a convenient way to define a multi-column unique constraint." +#. Tag: para +#: basic_mapping.xml:1930 +#, no-c-format +msgid "" +"The <literal><properties></literal> element allows the definition of a " +"named, logical grouping of properties of a class. The most important use of " +"the construct is that it allows a combination of properties to be the target " +"of a <literal>property-ref</literal>. It is also a convenient way to define " +"a multi-column unique constraint." msgstr "" +"O elemento <literal><properties></literal> permite a definição de um " +"grupo com nome, lógico de propriedades de uma classe. O uso mais importante " +"do construtor é que este permite uma combinação de propriedades para ser o " +"objetivo de uma <literal>property-ref</literal>. É também um modo " +"conveninente para definir uma unique constraint de múltiplas colunas." -#: index.docbook:1946 +#. Tag: programlisting +#: basic_mapping.xml:1946 +#, no-c-format msgid "" - "<![CDATA[<properties\n" - " name=\"logicalName\"\n" - " insert=\"true|false\"\n" - " update=\"true|false\"\n" - " optimistic-lock=\"true|false\"\n" - " unique=\"true|false\"\n" - ">\n" - "\n" - " <property ...../>\n" - " <many-to-one .... />\n" - " ........\n" - "</properties>]]>" +"<![CDATA[<properties\n" +" name=\"logicalName\"\n" +" insert=\"true|false\"\n" +" update=\"true|false\"\n" +" optimistic-lock=\"true|false\"\n" +" unique=\"true|false\"\n" +">\n" +"\n" +" <property ...../>\n" +" <many-to-one .... />\n" +" ........\n" +"</properties>]]>" msgstr "" -#: index.docbook:1949 -msgid "<literal>name</literal>: The logical name of the grouping - <emphasis>not</emphasis> an actual property name." +#. Tag: para +#: basic_mapping.xml:1949 +#, no-c-format +msgid "" +"<literal>name</literal>: The logical name of the grouping - <emphasis>not</" +"emphasis> an actual property name." msgstr "" +"<literal>name</literal>:: O nome lógico do agrupamento – <emphasis>não </" +"emphasis> é o nome atual de propriedade." -#: index.docbook:1967 -msgid "<literal>optimistic-lock</literal> (optional - defaults to <literal>true</literal>): Specifies that updates to these properties do or do not require acquisition of the optimistic lock. In other words, determines if a version increment should occur when these properties are dirty." +#. Tag: para +#: basic_mapping.xml:1967 +#, no-c-format +msgid "" +"<literal>optimistic-lock</literal> (optional - defaults to <literal>true</" +"literal>): Specifies that updates to these properties do or do not require " +"acquisition of the optimistic lock. In other words, determines if a version " +"increment should occur when these properties are dirty." msgstr "" +"<literal>optimistic-lock</literal> (opcional – valor default <literal>true</" +"literal>): Especifica que atualizações para estes componentes requerem ou " +"não aquisição de um lock otimista. Em outras palavras, determina se uma " +"versão de incremento deve ocorrer quando estas propriedades estiverem " +"modificadas." -#: index.docbook:1984 -msgid "For example, if we have the following <literal><properties></literal> mapping:" +#. Tag: para +#: basic_mapping.xml:1984 +#, no-c-format +msgid "" +"For example, if we have the following <literal><properties></literal> " +"mapping:" msgstr "" +"Por exemplo, se nós temos o seguinte mapeamento de <literal><" +"properties></literal>:" -#: index.docbook:1988 +#. Tag: programlisting +#: basic_mapping.xml:1988 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"personNumber\"/>\n" - " ...\n" - " <properties name=\"name\"\n" - " unique=\"true\" update=\"false\">\n" - " <property name=\"firstName\"/>\n" - " <property name=\"initial\"/>\n" - " <property name=\"lastName\"/>\n" - " </properties>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"personNumber\"/>\n" +" ...\n" +" <properties name=\"name\"\n" +" unique=\"true\" update=\"false\">\n" +" <property name=\"firstName\"/>\n" +" <property name=\"initial\"/>\n" +" <property name=\"lastName\"/>\n" +" </properties>\n" +"</class>]]>" msgstr "" -#: index.docbook:1990 -msgid "Then we might have some legacy data association which refers to this unique key of the <literal>Person</literal> table, instead of to the primary key:" +#. Tag: para +#: basic_mapping.xml:1990 +#, no-c-format +msgid "" +"Then we might have some legacy data association which refers to this unique " +"key of the <literal>Person</literal> table, instead of to the primary key:" msgstr "" +"Então nós podemos ter uma associação de dados herdados que referem a esta " +"chave exclusiva da tabela <literal>Person</literal>, ao invés de se " +"referirem a chave primária:" -#: index.docbook:1995 +#. Tag: programlisting +#: basic_mapping.xml:1995 +#, no-c-format msgid "" - "<![CDATA[<many-to-one name=\"person\"\n" - " class=\"Person\" property-ref=\"name\">\n" - " <column name=\"firstName\"/>\n" - " <column name=\"initial\"/>\n" - " <column name=\"lastName\"/>\n" - "</many-to-one>]]>" +"<![CDATA[<many-to-one name=\"person\"\n" +" class=\"Person\" property-ref=\"name\">\n" +" <column name=\"firstName\"/>\n" +" <column name=\"initial\"/>\n" +" <column name=\"lastName\"/>\n" +"</many-to-one>]]>" msgstr "" -#: index.docbook:1997 -msgid "We don't recommend the use of this kind of thing outside the context of mapping legacy data." +#. Tag: para +#: basic_mapping.xml:1997 +#, no-c-format +msgid "" +"We don't recommend the use of this kind of thing outside the context of " +"mapping legacy data." msgstr "" +"Nós não recomendamos o uso deste tipo de coisa fora do contexto de " +"mapeamento de dados herdados." -#: index.docbook:2005 +#. Tag: title +#: basic_mapping.xml:2005 +#, no-c-format msgid "subclass" -msgstr "" +msgstr "subclass (subclasse)" -#: index.docbook:2007 -msgid "Finally, polymorphic persistence requires the declaration of each subclass of the root persistent class. For the table-per-class-hierarchy mapping strategy, the <literal><subclass></literal> declaration is used." +#. Tag: para +#: basic_mapping.xml:2007 +#, no-c-format +msgid "" +"Finally, polymorphic persistence requires the declaration of each subclass " +"of the root persistent class. For the table-per-class-hierarchy mapping " +"strategy, the <literal><subclass></literal> declaration is used." msgstr "" +"Finalmente, a persistência polimórfica requer a declaração de cada subclasse " +"da classe de persistência raiz. Para a estratégia de mapeamento table-per-" +"class-hierarchy, a declaração <literal><subclass></literal> deve ser " +"usada." -#: index.docbook:2020 +#. Tag: programlisting +#: basic_mapping.xml:2020 +#, no-c-format msgid "" - "<![CDATA[<subclass\n" - " name=\"ClassName\"\n" - " discriminator-value=\"discriminator_value\"\n" - " proxy=\"ProxyInterface\"\n" - " lazy=\"true|false\"\n" - " dynamic-update=\"true|false\"\n" - " dynamic-insert=\"true|false\"\n" - " entity-name=\"EntityName\"\n" - " node=\"element-name\"\n" - " extends=\"SuperclassName\">\n" - "\n" - " <property .... />\n" - " .....\n" - "</subclass>]]>" +"<![CDATA[<subclass\n" +" name=\"ClassName\"\n" +" discriminator-value=\"discriminator_value\"\n" +" proxy=\"ProxyInterface\"\n" +" lazy=\"true|false\"\n" +" dynamic-update=\"true|false\"\n" +" dynamic-insert=\"true|false\"\n" +" entity-name=\"EntityName\"\n" +" node=\"element-name\"\n" +" extends=\"SuperclassName\">\n" +"\n" +" <property .... />\n" +" .....\n" +"</subclass>]]>" msgstr "" -#: index.docbook:2023, index.docbook:2081, index.docbook:2144 -msgid "<literal>name</literal>: The fully qualified class name of the subclass." +#. Tag: para +#: basic_mapping.xml:2023 basic_mapping.xml:2081 basic_mapping.xml:2144 +#, fuzzy, no-c-format +msgid "" +"<literal>name</literal>: The fully qualified class name of the subclass." msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>name</literal>: O nome de classe completamente qualificada da " +"subclasse.\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>name</literal>: O nome da classe completamente qualificada da " +"subclasse.\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>name</literal>: O nome da subclasse completamente qualificada." -#: index.docbook:2028 -msgid "<literal>discriminator-value</literal> (optional - defaults to the class name): A value that distiguishes individual subclasses." +#. Tag: para +#: basic_mapping.xml:2028 +#, no-c-format +msgid "" +"<literal>discriminator-value</literal> (optional - defaults to the class " +"name): A value that distiguishes individual subclasses." msgstr "" +"<literal>discriminator-value</literal> (opcional – valor default o nome da " +"classe): Um valor que distingue subclasses individuais." -#: index.docbook:2034, index.docbook:2091, index.docbook:2154 -msgid "<literal>proxy</literal> (optional): Specifies a class or interface to use for lazy initializing proxies." +#. Tag: para +#: basic_mapping.xml:2034 basic_mapping.xml:2091 basic_mapping.xml:2154 +#, fuzzy, no-c-format +msgid "" +"<literal>proxy</literal> (optional): Specifies a class or interface to use " +"for lazy initializing proxies." msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>proxy</literal> (opcional): Especifica a classe ou interface que " +"usará os proxies de inicialização atrasada.\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>proxy</literal> (opcional): Especifica a classe ou interface para " +"usar os proxies de recuperação atrasada.\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>proxy</literal> (optional): Specifies a class or interface to use " +"for lazy initializing proxies. <literal>proxy</literal> (opcional): " +"Especifica a classe ou interface para usar os proxies de recuperação " +"atrasada." -#: index.docbook:2040, index.docbook:2097, index.docbook:2160 -msgid "<literal>lazy</literal> (optional, defaults to <literal>true</literal>): Setting <literal>lazy=\"false\"</literal> disables the use of lazy fetching." +#. Tag: para +#: basic_mapping.xml:2040 basic_mapping.xml:2097 basic_mapping.xml:2160 +#, fuzzy, no-c-format +msgid "" +"<literal>lazy</literal> (optional, defaults to <literal>true</literal>): " +"Setting <literal>lazy=\"false\"</literal> disables the use of lazy fetching." msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>lazy</literal> (opcional, valor default <literal>true</literal>): " +"Configurar <literal>lazy=\"false\"</literal> desabilitará o uso de " +"inicialização atrasada.\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>lazy</literal> (opcional, valor default <literal>true</literal>): " +"Fixanr <literal>lazy=\"false\"</literal> desabilita o uso recuperação " +"atrasada.\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>lazy</literal> (optional, defaults to <literal>true</literal>): " +"Setting <literal>lazy=\"false\"</literal> disables the use of lazy fetching. " +"<literal>lazy</literal> (opcional, valor default p<literal>true</literal>): " +"Fixando <literal>lazy=\"false\"</literal> desabilita o uso da recuperação " +"atrasada." -#: index.docbook:2048 -msgid "Each subclass should declare its own persistent properties and subclasses. <literal><version></literal> and <literal><id></literal> properties are assumed to be inherited from the root class. Each subclass in a heirarchy must define a unique <literal>discriminator-value</literal>. If none is specified, the fully qualified Java class name is used." +#. Tag: para +#: basic_mapping.xml:2048 +#, no-c-format +msgid "" +"Each subclass should declare its own persistent properties and subclasses. " +"<literal><version></literal> and <literal><id></literal> " +"properties are assumed to be inherited from the root class. Each subclass in " +"a heirarchy must define a unique <literal>discriminator-value</literal>. If " +"none is specified, the fully qualified Java class name is used." msgstr "" +"Cada subclasse deve declarar suas próprias propriedades persistentes e " +"subclasses. As propriedades <literal><version></literal> e " +"<literal><id></literal> são configuradas para serem herdades da classe " +"raiz. Cada subclasse numa hierarquia deve definir um único " +"<literal>discriminator-value</literal>. Se nenhum for especificado, o nome " +"da classe Java completamente qualificada será usada." -#: index.docbook:2056, index.docbook:2114, index.docbook:2172 -msgid "For information about inheritance mappings, see <xref linkend=\"inheritance\"/>." +#. Tag: para +#: basic_mapping.xml:2056 basic_mapping.xml:2114 basic_mapping.xml:2172 +#, fuzzy, no-c-format +msgid "" +"For information about inheritance mappings, see <xref linkend=\"inheritance" +"\"/>." msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"Para informações sobre mapeamento de heranças, veja o <xref linkend=" +"\"inheritance\"/>.\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"Para informações de mapeamentos de herança, veja <xref linkend=\"inheritance" +"\"/>.\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"Para informações sobre mapeamentos de herança, veja <xref linkend=" +"\"inheritance\"/>." -#: index.docbook:2063 +#. Tag: title +#: basic_mapping.xml:2063 +#, no-c-format msgid "joined-subclass" -msgstr "" +msgstr "joined-subclass" -#: index.docbook:2065 -msgid "Alternatively, each subclass may be mapped to its own table (table-per-subclass mapping strategy). Inherited state is retrieved by joining with the table of the superclass. We use the <literal><joined-subclass></literal> element." +#. Tag: para +#: basic_mapping.xml:2065 +#, no-c-format +msgid "" +"Alternatively, each subclass may be mapped to its own table (table-per-" +"subclass mapping strategy). Inherited state is retrieved by joining with the " +"table of the superclass. We use the <literal><joined-subclass></" +"literal> element." msgstr "" +"Alternativamente, cada subclasse pode ser mapeada para sua própria tabela " +"(Estratégia de mapeamento table-per-subclass). O estado herdado é devolvido " +"por associação com a tabela da superclasse. Nós usamos o elemento " +"<literal><joined-subclass></literal>." -#: index.docbook:2078 +#. Tag: programlisting +#: basic_mapping.xml:2078 +#, no-c-format msgid "" - "<![CDATA[<joined-subclass\n" - " name=\"ClassName\"\n" - " table=\"tablename\"\n" - " proxy=\"ProxyInterface\"\n" - " lazy=\"true|false\"\n" - " dynamic-update=\"true|false\"\n" - " dynamic-insert=\"true|false\"\n" - " schema=\"schema\"\n" - " catalog=\"catalog\"\n" - " extends=\"SuperclassName\"\n" - " persister=\"ClassName\"\n" - " subselect=\"SQL expression\"\n" - " entity-name=\"EntityName\"\n" - " node=\"element-name\">\n" - "\n" - " <key .... >\n" - "\n" - " <property .... />\n" - " .....\n" - "</joined-subclass>]]>" +"<![CDATA[<joined-subclass\n" +" name=\"ClassName\"\n" +" table=\"tablename\"\n" +" proxy=\"ProxyInterface\"\n" +" lazy=\"true|false\"\n" +" dynamic-update=\"true|false\"\n" +" dynamic-insert=\"true|false\"\n" +" schema=\"schema\"\n" +" catalog=\"catalog\"\n" +" extends=\"SuperclassName\"\n" +" persister=\"ClassName\"\n" +" subselect=\"SQL expression\"\n" +" entity-name=\"EntityName\"\n" +" node=\"element-name\">\n" +"\n" +" <key .... >\n" +"\n" +" <property .... />\n" +" .....\n" +"</joined-subclass>]]>" msgstr "" -#: index.docbook:2086, index.docbook:2149 +#. Tag: para +#: basic_mapping.xml:2086 basic_mapping.xml:2149 +#, no-c-format msgid "<literal>table</literal>: The name of the subclass table." -msgstr "" +msgstr "<literal>table</literal>: O nome da tabela da subclasse." -#: index.docbook:2105 -msgid "No discriminator column is required for this mapping strategy. Each subclass must, however, declare a table column holding the object identifier using the <literal><key></literal> element. The mapping at the start of the chapter would be re-written as:" +#. Tag: para +#: basic_mapping.xml:2105 +#, no-c-format +msgid "" +"No discriminator column is required for this mapping strategy. Each subclass " +"must, however, declare a table column holding the object identifier using " +"the <literal><key></literal> element. The mapping at the start of the " +"chapter would be re-written as:" msgstr "" +"A coluna discriminator requerida para esta estratégia de mapeamento. Porém, " +"cada subclasse deve declarar uma coluna de tabela com o identificador do " +"objeto usando o elemento <literal><key></literal>. O mapeamento no " +"início do capítulo poderia ser re-escrito assim:" -#: index.docbook:2112 +#. Tag: programlisting +#: basic_mapping.xml:2112 +#, no-c-format msgid "" - "<![CDATA[<?xml version=\"1.0\"?>\n" - "<!DOCTYPE hibernate-mapping PUBLIC\n" - " \"-//Hibernate/Hibernate Mapping DTD//EN\"\n" - " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" - "\n" - "<hibernate-mapping package=\"eg\">\n" - "\n" - " <class name=\"Cat\" table=\"CATS\">\n" - " <id name=\"id\" column=\"uid\" type=\"long\">\n" - " <generator class=\"hilo\"/>\n" - " </id>\n" - " <property name=\"birthdate\" type=\"date\"/>\n" - " <property name=\"color\" not-null=\"true\"/>\n" - " <property name=\"sex\" not-null=\"true\"/>\n" - " <property name=\"weight\"/>\n" - " <many-to-one name=\"mate\"/>\n" - " <set name=\"kittens\">\n" - " <key column=\"MOTHER\"/>\n" - " <one-to-many class=\"Cat\"/>\n" - " </set>\n" - " <joined-subclass name=\"DomesticCat\" table=\"DOMESTIC_CATS\">\n" - " <key column=\"CAT\"/>\n" - " <property name=\"name\" type=\"string\"/>\n" - " </joined-subclass>\n" - " </class>\n" - "\n" - " <class name=\"eg.Dog\">\n" - " \n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<?xml version=\"1.0\"?>\n" +"<!DOCTYPE hibernate-mapping PUBLIC\n" +" \"-//Hibernate/Hibernate Mapping DTD//EN\"\n" +" \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" +"\n" +"<hibernate-mapping package=\"eg\">\n" +"\n" +" <class name=\"Cat\" table=\"CATS\">\n" +" <id name=\"id\" column=\"uid\" type=\"long\">\n" +" <generator class=\"hilo\"/>\n" +" </id>\n" +" <property name=\"birthdate\" type=\"date\"/>\n" +" <property name=\"color\" not-null=\"true\"/>\n" +" <property name=\"sex\" not-null=\"true\"/>\n" +" <property name=\"weight\"/>\n" +" <many-to-one name=\"mate\"/>\n" +" <set name=\"kittens\">\n" +" <key column=\"MOTHER\"/>\n" +" <one-to-many class=\"Cat\"/>\n" +" </set>\n" +" <joined-subclass name=\"DomesticCat\" table=\"DOMESTIC_CATS" +"\">\n" +" <key column=\"CAT\"/>\n" +" <property name=\"name\" type=\"string\"/>\n" +" </joined-subclass>\n" +" </class>\n" +"\n" +" <class name=\"eg.Dog\">\n" +" \n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" -#: index.docbook:2121 +#. Tag: title +#: basic_mapping.xml:2121 +#, no-c-format msgid "union-subclass" -msgstr "" +msgstr "union-subclass" -#: index.docbook:2123 -msgid "A third option is to map only the concrete classes of an inheritance hierarchy to tables, (the table-per-concrete-class strategy) where each table defines all persistent state of the class, including inherited state. In Hibernate, it is not absolutely necessary to explicitly map such inheritance hierarchies. You can simply map each class with a separate <literal><class></literal> declaration. However, if you wish use polymorphic associations (e.g. an association to the superclass of your hierarchy), you need to use the <literal><union-subclass></literal> mapping." +#. Tag: para +#: basic_mapping.xml:2123 +#, no-c-format +msgid "" +"A third option is to map only the concrete classes of an inheritance " +"hierarchy to tables, (the table-per-concrete-class strategy) where each " +"table defines all persistent state of the class, including inherited state. " +"In Hibernate, it is not absolutely necessary to explicitly map such " +"inheritance hierarchies. You can simply map each class with a separate " +"<literal><class></literal> declaration. However, if you wish use " +"polymorphic associations (e.g. an association to the superclass of your " +"hierarchy), you need to use the <literal><union-subclass></literal> " +"mapping." msgstr "" +"Uma terceira opção é mapear para tabelas apenas as classes concretas de uma " +"hierarquia de heranças, (a estratégia table-per-concrete-class) onde cada " +"tabela define todos os estados persistentes da classe, incluindo estados " +"herdados. No Hibernate, não é absolutamente necessário mapear explicitamente " +"como hierarquia de heranças. Você pode simplesmente mapear cada classe com " +"uma declaração <literal><class></literal> separada. Porém, se você " +"deseja usar associações polimórficas (por exemplo: uma associação para a " +"superclasse de sua hierarquia), você precisa usar o mapeamento <literal><" +"union-subclass></literal>." -#: index.docbook:2141 +#. Tag: programlisting +#: basic_mapping.xml:2141 +#, no-c-format msgid "" - "<![CDATA[<union-subclass\n" - " name=\"ClassName\"\n" - " table=\"tablename\"\n" - " proxy=\"ProxyInterface\"\n" - " lazy=\"true|false\"\n" - " dynamic-update=\"true|false\"\n" - " dynamic-insert=\"true|false\"\n" - " schema=\"schema\"\n" - " catalog=\"catalog\"\n" - " extends=\"SuperclassName\"\n" - " abstract=\"true|false\"\n" - " persister=\"ClassName\"\n" - " subselect=\"SQL expression\"\n" - " entity-name=\"EntityName\"\n" - " node=\"element-name\">\n" - "\n" - " <property .... />\n" - " .....\n" - "</union-subclass>]]>" +"<![CDATA[<union-subclass\n" +" name=\"ClassName\"\n" +" table=\"tablename\"\n" +" proxy=\"ProxyInterface\"\n" +" lazy=\"true|false\"\n" +" dynamic-update=\"true|false\"\n" +" dynamic-insert=\"true|false\"\n" +" schema=\"schema\"\n" +" catalog=\"catalog\"\n" +" extends=\"SuperclassName\"\n" +" abstract=\"true|false\"\n" +" persister=\"ClassName\"\n" +" subselect=\"SQL expression\"\n" +" entity-name=\"EntityName\"\n" +" node=\"element-name\">\n" +"\n" +" <property .... />\n" +" .....\n" +"</union-subclass>]]>" msgstr "" -#: index.docbook:2168 -msgid "No discriminator column or key column is required for this mapping strategy." +#. Tag: para +#: basic_mapping.xml:2168 +#, no-c-format +msgid "" +"No discriminator column or key column is required for this mapping strategy." msgstr "" +"A coluna discriminatõria não é requerida para esta estratégia de mapeamento." -#: index.docbook:2179 +#. Tag: title +#: basic_mapping.xml:2179 +#, no-c-format msgid "join" -msgstr "" +msgstr "join" -#: index.docbook:2181 -msgid "Using the <literal><join></literal> element, it is possible to map properties of one class to several tables, when there's a 1-to-1 relationship between the tables." +#. Tag: para +#: basic_mapping.xml:2181 +#, no-c-format +msgid "" +"Using the <literal><join></literal> element, it is possible to map " +"properties of one class to several tables, when there's a 1-to-1 " +"relationship between the tables." msgstr "" +"Usando o elemento <literal><join></literal>>, é possível mapear " +"propriedades de uma classe para várias tabelas." -#: index.docbook:2195 +#. Tag: programlisting +#: basic_mapping.xml:2195 +#, no-c-format msgid "" - "<![CDATA[<join\n" - " table=\"tablename\"\n" - " schema=\"owner\"\n" - " catalog=\"catalog\"\n" - " fetch=\"join|select\"\n" - " inverse=\"true|false\"\n" - " optional=\"true|false\">\n" - "\n" - " <key ... />\n" - "\n" - " <property ... />\n" - " ...\n" - "</join>]]>" +"<![CDATA[<join\n" +" table=\"tablename\"\n" +" schema=\"owner\"\n" +" catalog=\"catalog\"\n" +" fetch=\"join|select\"\n" +" inverse=\"true|false\"\n" +" optional=\"true|false\">\n" +"\n" +" <key ... />\n" +"\n" +" <property ... />\n" +" ...\n" +"</join>]]>" msgstr "" -#: index.docbook:2199 +#. Tag: para +#: basic_mapping.xml:2199 +#, no-c-format msgid "<literal>table</literal>: The name of the joined table." -msgstr "" +msgstr "<literal>table</literal>: O nome da tabela associada." -#: index.docbook:2216 -msgid "<literal>fetch</literal> (optional - defaults to <literal>join</literal>): If set to <literal>join</literal>, the default, Hibernate will use an inner join to retrieve a <literal><join></literal> defined by a class or its superclasses and an outer join for a <literal><join></literal> defined by a subclass. If set to <literal>select</literal> then Hibernate will use a sequential select for a <literal><join></literal> defined on a subclass, which will be issued only if a row turns out to represent an instance of the subclass. Inner joins will still be used to retrieve a <literal><join></literal> defined by the class and its superclasses." +#. Tag: para +#: basic_mapping.xml:2216 +#, no-c-format +msgid "" +"<literal>fetch</literal> (optional - defaults to <literal>join</literal>): " +"If set to <literal>join</literal>, the default, Hibernate will use an inner " +"join to retrieve a <literal><join></literal> defined by a class or its " +"superclasses and an outer join for a <literal><join></literal> defined " +"by a subclass. If set to <literal>select</literal> then Hibernate will use a " +"sequential select for a <literal><join></literal> defined on a " +"subclass, which will be issued only if a row turns out to represent an " +"instance of the subclass. Inner joins will still be used to retrieve a " +"<literal><join></literal> defined by the class and its superclasses." msgstr "" +"<literal>fetch</literal>(opcional – valor default <literal>join</literal>): " +"Se setado para <literal>join</literal>, o padrão, o Hibernate irá usar um " +"inner join para restaurar um <literal>join</literal> definido por uma classe " +"ou suas subclasses e uma outer join para um <literal>join</literal> definido " +"por uma subclasse. Se setado para <literal>select</literal>, então o " +"Hibernate irá usar uma seleção seqüencial para um <literal><join></" +"literal> definida numa subclasse, que irá ser emitido apenas se uma linha se " +"concentrar para representar uma instância da subclasse. Inner joins irá " +"ainda ser usado para restaurar um <literal><join></literal> definido " +"pela classe e suas superclasses." -#: index.docbook:2229 -msgid "<literal>inverse</literal> (optional - defaults to <literal>false</literal>): If enabled, Hibernate will not try to insert or update the properties defined by this join." +#. Tag: para +#: basic_mapping.xml:2229 +#, no-c-format +msgid "" +"<literal>inverse</literal> (optional - defaults to <literal>false</" +"literal>): If enabled, Hibernate will not try to insert or update the " +"properties defined by this join." msgstr "" +"<literal>inverse</literal> (opcional – valor default <literal>false</" +"literal>): Se habilitado, o Hibernate não irá tentar inserir ou atualizar as " +"propriedades definidas por este join." -#: index.docbook:2236 -msgid "<literal>optional</literal> (optional - defaults to <literal>false</literal>): If enabled, Hibernate will insert a row only if the properties defined by this join are non-null and will always use an outer join to retrieve the properties." +#. Tag: para +#: basic_mapping.xml:2236 +#, no-c-format +msgid "" +"<literal>optional</literal> (optional - defaults to <literal>false</" +"literal>): If enabled, Hibernate will insert a row only if the properties " +"defined by this join are non-null and will always use an outer join to " +"retrieve the properties." msgstr "" +"<literal>optional</literal> (opcional – valor default <literal>false</" +"literal>): Se habilitado, o Hibernate irá inserir uma linha apenas se as " +"propriedades definidas por esta junção não forem nulas e irá sempre usar uma " +"outer join para recuperar as propriedades." -#: index.docbook:2245 -msgid "For example, the address information for a person can be mapped to a separate table (while preserving value type semantics for all properties):" +#. Tag: para +#: basic_mapping.xml:2245 +#, no-c-format +msgid "" +"For example, the address information for a person can be mapped to a " +"separate table (while preserving value type semantics for all properties):" msgstr "" +"Por exemplo, a informação de endereço para uma pessoa pode ser mapeada para " +"uma tabela separada (enquanto preservando o valor da semântica de tipos para " +"todas as propriedades):" -#: index.docbook:2250 +#. Tag: programlisting +#: basic_mapping.xml:2250 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\"\n" - " table=\"PERSON\">\n" - "\n" - " <id name=\"id\" column=\"PERSON_ID\">...</id>\n" - "\n" - " <join table=\"ADDRESS\">\n" - " <key column=\"ADDRESS_ID\"/>\n" - " <property name=\"address\"/>\n" - " <property name=\"zip\"/>\n" - " <property name=\"country\"/>\n" - " </join>\n" - " ...]]>" +"<![CDATA[<class name=\"Person\"\n" +" table=\"PERSON\">\n" +"\n" +" <id name=\"id\" column=\"PERSON_ID\">...</id>\n" +"\n" +" <join table=\"ADDRESS\">\n" +" <key column=\"ADDRESS_ID\"/>\n" +" <property name=\"address\"/>\n" +" <property name=\"zip\"/>\n" +" <property name=\"country\"/>\n" +" </join>\n" +" ...]]>" msgstr "" -#: index.docbook:2252 -msgid "This feature is often only useful for legacy data models, we recommend fewer tables than classes and a fine-grained domain model. However, it is useful for switching between inheritance mapping strategies in a single hierarchy, as explained later." +#. Tag: para +#: basic_mapping.xml:2252 +#, no-c-format +msgid "" +"This feature is often only useful for legacy data models, we recommend fewer " +"tables than classes and a fine-grained domain model. However, it is useful " +"for switching between inheritance mapping strategies in a single hierarchy, " +"as explained later." msgstr "" +"Esta característica é útil apenas para modelos de dados legados, nós " +"recomendamos menos tabelas do que classes e um modelo de domínio bem " +"granulado. Porém, é útil para ficar trocando entre estratégias de mapeamento " +"de herança numa hierarquia simples, como explicado mais a frente." -#: index.docbook:2262 +#. Tag: title +#: basic_mapping.xml:2262 +#, no-c-format msgid "<title>key</title>" msgstr "" -#: index.docbook:2264 -msgid "We've seen the <literal><key></literal> element crop up a few times now. It appears anywhere the parent mapping element defines a join to a new table, and defines the foreign key in the joined table, that references the primary key of the original table." +#. Tag: para +#: basic_mapping.xml:2264 +#, no-c-format +msgid "" +"We've seen the <literal><key></literal> element crop up a few times " +"now. It appears anywhere the parent mapping element defines a join to a new " +"table, and defines the foreign key in the joined table, that references the " +"primary key of the original table." msgstr "" +"Nós vimos que o elemento <literal><key></literal> surgiu algumas vezes " +"até agora. Ele aparece em qualquer lugar que o elemento pai define uma " +"junção para a nova tabela, e define a chave estrangeira para a tabela " +"associada, que referencia a chave primária da tabela original." -#: index.docbook:2280 +#. Tag: programlisting +#: basic_mapping.xml:2280 +#, no-c-format msgid "" - "<![CDATA[<key\n" - " column=\"columnname\"\n" - " on-delete=\"noaction|cascade\"\n" - " property-ref=\"propertyName\"\n" - " not-null=\"true|false\"\n" - " update=\"true|false\"\n" - " unique=\"true|false\"\n" - "/>]]>" +"<![CDATA[<key\n" +" column=\"columnname\"\n" +" on-delete=\"noaction|cascade\"\n" +" property-ref=\"propertyName\"\n" +" not-null=\"true|false\"\n" +" update=\"true|false\"\n" +" unique=\"true|false\"\n" +"/>]]>" msgstr "" -#: index.docbook:2291 -msgid "<literal>on-delete</literal> (optional, defaults to <literal>noaction</literal>): Specifies whether the foreign key constraint has database-level cascade delete enabled." +#. Tag: para +#: basic_mapping.xml:2291 +#, no-c-format +msgid "" +"<literal>on-delete</literal> (optional, defaults to <literal>noaction</" +"literal>): Specifies whether the foreign key constraint has database-level " +"cascade delete enabled." msgstr "" +"<literal>on-delete</literal> (opcional, valor default <literal>noaction</" +"literal>): Especifica se a constraint da chave estrangeira no banco de dados " +"esta habilitada para cascade delete ." -#: index.docbook:2298 -msgid "<literal>property-ref</literal> (optional): Specifies that the foreign key refers to columns that are not the primary key of the orginal table. (Provided for legacy data.)" +#. Tag: para +#: basic_mapping.xml:2298 +#, no-c-format +msgid "" +"<literal>property-ref</literal> (optional): Specifies that the foreign key " +"refers to columns that are not the primary key of the orginal table. " +"(Provided for legacy data.)" msgstr "" +"<literal>property-ref</literal> (opcional): Especifica que a chave " +"estrangeira se refere a colunas que não são chave primária da tabela " +"original. (Util para base de dados legadas.)" -#: index.docbook:2305 -msgid "<literal>not-null</literal> (optional): Specifies that the foreign key columns are not nullable (this is implied whenever the foreign key is also part of the primary key)." +#. Tag: para +#: basic_mapping.xml:2305 +#, no-c-format +msgid "" +"<literal>not-null</literal> (optional): Specifies that the foreign key " +"columns are not nullable (this is implied whenever the foreign key is also " +"part of the primary key)." msgstr "" +"<literal>not-null</literal> (opcional): Especifica que a coluna da chave " +"estrangeira não aceita valores nulos (isto é implícito em qualquer momento " +"que a chave estrangeira também fizer parte da chave primária)." -#: index.docbook:2312 -msgid "<literal>update</literal> (optional): Specifies that the foreign key should never be updated (this is implied whenever the foreign key is also part of the primary key)." +#. Tag: para +#: basic_mapping.xml:2312 +#, no-c-format +msgid "" +"<literal>update</literal> (optional): Specifies that the foreign key should " +"never be updated (this is implied whenever the foreign key is also part of " +"the primary key)." msgstr "" +"<literal>update</literal> (optional): Specifies that the foreign key should " +"never be updated (this is implied whenever the foreign key is also part of " +"the primary key). <literal>update</literal> (opcional): Especifica que a " +"chave estrangeira nunca deve ser atualizada (isto é implícito em qualquer " +"momento que a chave estrangeira também fizer parte da chave primária)." -#: index.docbook:2319 -msgid "<literal>unique</literal> (optional): Specifies that the foreign key should have a unique constraint (this is implied whenever the foreign key is also the primary key)." +#. Tag: para +#: basic_mapping.xml:2319 +#, no-c-format +msgid "" +"<literal>unique</literal> (optional): Specifies that the foreign key should " +"have a unique constraint (this is implied whenever the foreign key is also " +"the primary key)." msgstr "" +"<literal>unique</literal> (opcional): Especifica que a chave estrangeira " +"deve ter uma constraint unique (sto é implícito em qualquer momento que a " +"chave estrangeira também fizer parte da chave primária)." -#: index.docbook:2327 -msgid "We recommend that for systems where delete performance is important, all keys should be defined <literal>on-delete=\"cascade\"</literal>, and Hibernate will use a database-level <literal>ON CASCADE DELETE</literal> constraint, instead of many individual <literal>DELETE</literal> statements. Be aware that this feature bypasses Hibernate's usual optimistic locking strategy for versioned data." +#. Tag: para +#: basic_mapping.xml:2327 +#, no-c-format +msgid "" +"We recommend that for systems where delete performance is important, all " +"keys should be defined <literal>on-delete=\"cascade\"</literal>, and " +"Hibernate will use a database-level <literal>ON CASCADE DELETE</literal> " +"constraint, instead of many individual <literal>DELETE</literal> statements. " +"Be aware that this feature bypasses Hibernate's usual optimistic locking " +"strategy for versioned data." msgstr "" +"Nós recomendamos que para sistemas que a performance de delete seja " +"importante, todas as chaves deve ser definida <literal>on-delete=\"cascade" +"\"</literal>, e o Hibernate irá usar uma constraint a nível de banco de " +"dados <literal>ON CASCADE DELETE</literal>, ao invés de muitas instruções " +"<literal>DELETE</literal>. Esteja ciente que esta característica é um atalho " +"da estratégia usual de optimistic locking do Hibernate para dados " +"versionados." -#: index.docbook:2335 -msgid "The <literal>not-null</literal> and <literal>update</literal> attributes are useful when mapping a unidirectional one to many association. If you map a unidirectional one to many to a non-nullable foreign key, you <emphasis>must</emphasis> declare the key column using <literal><key not-null=\"true\"></literal>." +#. Tag: para +#: basic_mapping.xml:2335 +#, no-c-format +msgid "" +"The <literal>not-null</literal> and <literal>update</literal> attributes are " +"useful when mapping a unidirectional one to many association. If you map a " +"unidirectional one to many to a non-nullable foreign key, you " +"<emphasis>must</emphasis> declare the key column using <literal><key not-" +"null=\"true\"></literal>." msgstr "" +"Os atributos <literal>not-null</literal> e <literal>update</literal> são " +"úteis quando estamos mapeamos uma associação unidirecional um para muitos. " +"Se você mapear uma asociação unidirecional um para muitos para uma chave " +"estrangeira non-nullable, você <emphasis>deve</emphasis> declarar a coluna " +"chave usando <literal><key not-null=\"true\"></literal>." -#: index.docbook:2345 +#. Tag: title +#: basic_mapping.xml:2345 +#, no-c-format msgid "column and formula elements" -msgstr "" +msgstr "elementos column e formula" -#: index.docbook:2346 -msgid "Any mapping element which accepts a <literal>column</literal> attribute will alternatively accept a <literal><column></literal> subelement. Likewise, <literal><formula></literal> is an alternative to the <literal>formula</literal> attribute." +#. Tag: para +#: basic_mapping.xml:2346 +#, no-c-format +msgid "" +"Any mapping element which accepts a <literal>column</literal> attribute will " +"alternatively accept a <literal><column></literal> subelement. " +"Likewise, <literal><formula></literal> is an alternative to the " +"<literal>formula</literal> attribute." msgstr "" +"Qualquer elemento de mapeamente que aceita um atributo <literal>column</" +"literal> irá aceitar alternativamente um subelemento <literal><column>" +"</literal>. Da mesma forma, <literal>formula</literal> é uma alternativa " +"para o atributo <literal>formula</literal>." -#: index.docbook:2352 +#. Tag: programlisting +#: basic_mapping.xml:2352 +#, no-c-format msgid "" - "<![CDATA[<column\n" - " name=\"column_name\"\n" - " length=\"N\"\n" - " precision=\"N\"\n" - " scale=\"N\"\n" - " not-null=\"true|false\"\n" - " unique=\"true|false\"\n" - " unique-key=\"multicolumn_unique_key_name\"\n" - " index=\"index_name\"\n" - " sql-type=\"sql_type_name\"\n" - " check=\"SQL expression\"\n" - " default=\"SQL expression\"/>]]>" +"<![CDATA[<column\n" +" name=\"column_name\"\n" +" length=\"N\"\n" +" precision=\"N\"\n" +" scale=\"N\"\n" +" not-null=\"true|false\"\n" +" unique=\"true|false\"\n" +" unique-key=\"multicolumn_unique_key_name\"\n" +" index=\"index_name\"\n" +" sql-type=\"sql_type_name\"\n" +" check=\"SQL expression\"\n" +" default=\"SQL expression\"/>]]>" msgstr "" -#: index.docbook:2354 +#. Tag: programlisting +#: basic_mapping.xml:2354 +#, no-c-format msgid "<![CDATA[<formula>SQL expression</formula>]]>" msgstr "" -#: index.docbook:2356 -msgid "<literal>column</literal> and <literal>formula</literal> attributes may even be combined within the same property or association mapping to express, for example, exotic join conditions." +#. Tag: para +#: basic_mapping.xml:2356 +#, no-c-format +msgid "" +"<literal>column</literal> and <literal>formula</literal> attributes may even " +"be combined within the same property or association mapping to express, for " +"example, exotic join conditions." msgstr "" +"O atributo <literal>column</literal> e <literal>formula</literal> podem até " +"ser combinados dentro da mesma propriedade ou associação mapeando para " +"expressar, por exemplo, associações exóticas." -#: index.docbook:2362 +#. Tag: programlisting +#: basic_mapping.xml:2362 +#, no-c-format msgid "" - "<![CDATA[<many-to-one name=\"homeAddress\" class=\"Address\"\n" - " insert=\"false\" update=\"false\">\n" - " <column name=\"person_id\" not-null=\"true\" length=\"10\"/>\n" - " <formula>'MAILING'</formula>\n" - "</many-to-one>]]>" +"<![CDATA[<many-to-one name=\"homeAddress\" class=\"Address\"\n" +" insert=\"false\" update=\"false\">\n" +" <column name=\"person_id\" not-null=\"true\" length=\"10\"/>\n" +" <formula>'MAILING'</formula>\n" +"</many-to-one>]]>" msgstr "" -#: index.docbook:2367 +#. Tag: title +#: basic_mapping.xml:2367 +#, no-c-format msgid "import" -msgstr "" +msgstr "import" -#: index.docbook:2369 -msgid "Suppose your application has two persistent classes with the same name, and you don't want to specify the fully qualified (package) name in Hibernate queries. Classes may be \"imported\" explicitly, rather than relying upon <literal>auto-import=\"true\"</literal>. You may even import classes and interfaces that are not explicitly mapped." +#. Tag: para +#: basic_mapping.xml:2369 +#, no-c-format +msgid "" +"Suppose your application has two persistent classes with the same name, and " +"you don't want to specify the fully qualified (package) name in Hibernate " +"queries. Classes may be \"imported\" explicitly, rather than relying upon " +"<literal>auto-import=\"true\"</literal>. You may even import classes and " +"interfaces that are not explicitly mapped." msgstr "" +"Suponha que a sua aplicação tem duas classes persistentes com o mesmo nome, " +"e você não quer especificar o nome qualificado (do pacote) nas queries do " +"Hibernate. As Classes devem ser \"importadas\" explicitamente, de " +"preferência contando com <literal>auto-import=\"true\"</literal>. Você pode " +"até importar classes e interfaces que não estão explicitamente mapeadas." -#: index.docbook:2376 +#. Tag: programlisting +#: basic_mapping.xml:2376 +#, no-c-format msgid "<![CDATA[<import class=\"java.lang.Object\" rename=\"Universe\"/>]]>" msgstr "" -#: index.docbook:2383 +#. Tag: programlisting +#: basic_mapping.xml:2383 +#, no-c-format msgid "" - "<![CDATA[<import\n" - " class=\"ClassName\"\n" - " rename=\"ShortName\"\n" - "/>]]>" +"<![CDATA[<import\n" +" class=\"ClassName\"\n" +" rename=\"ShortName\"\n" +"/>]]>" msgstr "" -#: index.docbook:2386 -msgid "<literal>class</literal>: The fully qualified class name of of any Java class." +#. Tag: para +#: basic_mapping.xml:2386 +#, no-c-format +msgid "" +"<literal>class</literal>: The fully qualified class name of of any Java " +"class." msgstr "" +"<literal>class</literal>: O nome qualificado (do pacote) de qualquer classe " +"Java." -#: index.docbook:2391 -msgid "<literal>rename</literal> (optional - defaults to the unqualified class name): A name that may be used in the query language." +#. Tag: para +#: basic_mapping.xml:2391 +#, no-c-format +msgid "" +"<literal>rename</literal> (optional - defaults to the unqualified class " +"name): A name that may be used in the query language." msgstr "" +"<literal>rename</literal> (opcional – valor default, o nome da classe não " +"qualificada): Um nome que pode ser usado numa linguagem de consulta." -#: index.docbook:2402 +#. Tag: title +#: basic_mapping.xml:2402 +#, no-c-format msgid "<title>any</title>" msgstr "" -#: index.docbook:2404 -msgid "There is one further type of property mapping. The <literal><any></literal> mapping element defines a polymorphic association to classes from multiple tables. This type of mapping always requires more than one column. The first column holds the type of the associated entity. The remaining columns hold the identifier. It is impossible to specify a foreign key constraint for this kind of association, so this is most certainly not meant as the usual way of mapping (polymorphic) associations. You should use this only in very special cases (eg. audit logs, user session data, etc)." +#. Tag: para +#: basic_mapping.xml:2404 +#, no-c-format +msgid "" +"There is one further type of property mapping. The <literal><any></" +"literal> mapping element defines a polymorphic association to classes from " +"multiple tables. This type of mapping always requires more than one column. " +"The first column holds the type of the associated entity. The remaining " +"columns hold the identifier. It is impossible to specify a foreign key " +"constraint for this kind of association, so this is most certainly not meant " +"as the usual way of mapping (polymorphic) associations. You should use this " +"only in very special cases (eg. audit logs, user session data, etc)." msgstr "" +"Existe mais um tipo de propriedade de mapeamento. O elemento de mapeamento " +"<literal><any></literal> define uma associação polimórfica para " +"classes de múltiplas tabelas. Este tipo de mapeamento sempre requer mais de " +"uma coluna. A primeira coluna possui o tipo da entidade associada. A outra " +"coluna que ficou possui o identificador. É impossível especificar uma " +"restrição de chave estrangeira para este tipo de associação, assim isto " +"claramente não é visto como um caminho usual para associações (polimórficas) " +"de mapeamento. Você deve usar este mapeamento apenas em casos muito " +"especiais (exemplo: audit logs, dados de sessão do usuário, etc)." -#: index.docbook:2414 -msgid "The <literal>meta-type</literal> attribute lets the application specify a custom type that maps database column values to persistent classes which have identifier properties of the type specified by <literal>id-type</literal>. You must specify the mapping from values of the meta-type to class names." +#. Tag: para +#: basic_mapping.xml:2414 +#, no-c-format +msgid "" +"The <literal>meta-type</literal> attribute lets the application specify a " +"custom type that maps database column values to persistent classes which " +"have identifier properties of the type specified by <literal>id-type</" +"literal>. You must specify the mapping from values of the meta-type to class " +"names." msgstr "" +"O atributo <literal>meta-type</literal> permite a aplicação especificar um " +"tipo adaptado que mapeia valores de colunas de banco de dados para classes " +"persistentes que tem propriedades identificadoras do tipo especificado " +"através do <literal>id-type</literal>. Você deve especificar o mapeamento de " +"valores do meta-type para nome de classes." -#: index.docbook:2421 +#. Tag: programlisting +#: basic_mapping.xml:2421 +#, no-c-format msgid "" - "<![CDATA[<any name=\"being\" id-type=\"long\" meta-type=\"string\">\n" - " <meta-value value=\"TBL_ANIMAL\" class=\"Animal\"/>\n" - " <meta-value value=\"TBL_HUMAN\" class=\"Human\"/>\n" - " <meta-value value=\"TBL_ALIEN\" class=\"Alien\"/>\n" - " <column name=\"table_name\"/>\n" - " <column name=\"id\"/>\n" - "</any>]]>" +"<![CDATA[<any name=\"being\" id-type=\"long\" meta-type=\"string\">\n" +" <meta-value value=\"TBL_ANIMAL\" class=\"Animal\"/>\n" +" <meta-value value=\"TBL_HUMAN\" class=\"Human\"/>\n" +" <meta-value value=\"TBL_ALIEN\" class=\"Alien\"/>\n" +" <column name=\"table_name\"/>\n" +" <column name=\"id\"/>\n" +"</any>]]>" msgstr "" -#: index.docbook:2432 +#. Tag: programlisting +#: basic_mapping.xml:2432 +#, no-c-format msgid "" - "<![CDATA[<any\n" - " name=\"propertyName\"\n" - " id-type=\"idtypename\"\n" - " meta-type=\"metatypename\"\n" - " cascade=\"cascade_style\"\n" - " access=\"field|property|ClassName\"\n" - " optimistic-lock=\"true|false\"\n" - ">\n" - " <meta-value ... />\n" - " <meta-value ... />\n" - " .....\n" - " <column .... />\n" - " <column .... />\n" - " .....\n" - "</any>]]>" +"<![CDATA[<any\n" +" name=\"propertyName\"\n" +" id-type=\"idtypename\"\n" +" meta-type=\"metatypename\"\n" +" cascade=\"cascade_style\"\n" +" access=\"field|property|ClassName\"\n" +" optimistic-lock=\"true|false\"\n" +">\n" +" <meta-value ... />\n" +" <meta-value ... />\n" +" .....\n" +" <column .... />\n" +" <column .... />\n" +" .....\n" +"</any>]]>" msgstr "" -#: index.docbook:2435 +#. Tag: para +#: basic_mapping.xml:2435 +#, no-c-format msgid "<literal>name</literal>: the property name." -msgstr "" +msgstr "<literal>name</literal>: o nome da propriedade." -#: index.docbook:2440 +#. Tag: para +#: basic_mapping.xml:2440 +#, no-c-format msgid "<literal>id-type</literal>: the identifier type." -msgstr "" +msgstr "<literal>id-type</literal>: o tipo identificador." -#: index.docbook:2445 -msgid "<literal>meta-type</literal> (optional - defaults to <literal>string</literal>): Any type that is allowed for a discriminator mapping." +#. Tag: para +#: basic_mapping.xml:2445 +#, no-c-format +msgid "" +"<literal>meta-type</literal> (optional - defaults to <literal>string</" +"literal>): Any type that is allowed for a discriminator mapping." msgstr "" +"<literal>meta-type</literal> (opcional – valor default <literal>string</" +"literal>): Qualquer tipo que é permitido para um mapeamento discriminador." -#: index.docbook:2451 -msgid "<literal>cascade</literal> (optional- defaults to <literal>none</literal>): the cascade style." +#. Tag: para +#: basic_mapping.xml:2451 +#, no-c-format +msgid "" +"<literal>cascade</literal> (optional- defaults to <literal>none</literal>): " +"the cascade style." msgstr "" +"<literal>cascade</literal> (opcional – valor default <literal>none</" +"literal>): o estilo do cascade." -#: index.docbook:2463 -msgid "<literal>optimistic-lock</literal> (optional - defaults to <literal>true</literal>): Specifies that updates to this property do or do not require acquisition of the optimistic lock. In other words, define if a version increment should occur if this property is dirty." +#. Tag: para +#: basic_mapping.xml:2463 +#, no-c-format +msgid "" +"<literal>optimistic-lock</literal> (optional - defaults to <literal>true</" +"literal>): Specifies that updates to this property do or do not require " +"acquisition of the optimistic lock. In other words, define if a version " +"increment should occur if this property is dirty." msgstr "" +"<literal>optimistic-lock</literal> (opcional - valor default<literal>true</" +"literal>): Especifica que as atualizações para esta propriedade requerem ou " +"não aquisição da trava otimista. Em outras palavras, define se uma versão de " +"incremento deve ocorrer se esta propriedade está modificada." -#: index.docbook:2478 +#. Tag: title +#: basic_mapping.xml:2478 +#, no-c-format msgid "Hibernate Types" -msgstr "" +msgstr "Tipos do Hibernate" -#: index.docbook:2481 +#. Tag: title +#: basic_mapping.xml:2481 +#, no-c-format msgid "Entities and values" -msgstr "" +msgstr "Entidades e valores" -#: index.docbook:2483 -msgid "To understand the behaviour of various Java language-level objects with respect to the persistence service, we need to classify them into two groups:" +#. Tag: para +#: basic_mapping.xml:2483 +#, no-c-format +msgid "" +"To understand the behaviour of various Java language-level objects with " +"respect to the persistence service, we need to classify them into two groups:" msgstr "" +"Para entender o comportamento de vários objetos em nível de linguagem de " +"Java a respeito do serviço de persistência, nós precisamos classificá-los em " +"dois grupos." -#: index.docbook:2488 -msgid "An <emphasis>entity</emphasis> exists independently of any other objects holding references to the entity. Contrast this with the usual Java model where an unreferenced object is garbage collected. Entities must be explicitly saved and deleted (except that saves and deletions may be <emphasis>cascaded</emphasis> from a parent entity to its children). This is different from the ODMG model of object persistence by reachablity - and corresponds more closely to how application objects are usually used in large systems. Entities support circular and shared references. They may also be versioned." +#. Tag: para +#: basic_mapping.xml:2488 +#, no-c-format +msgid "" +"An <emphasis>entity</emphasis> exists independently of any other objects " +"holding references to the entity. Contrast this with the usual Java model " +"where an unreferenced object is garbage collected. Entities must be " +"explicitly saved and deleted (except that saves and deletions may be " +"<emphasis>cascaded</emphasis> from a parent entity to its children). This is " +"different from the ODMG model of object persistence by reachablity - and " +"corresponds more closely to how application objects are usually used in " +"large systems. Entities support circular and shared references. They may " +"also be versioned." msgstr "" +"Uma <emphasis>entidade </emphasis> existe independentemente de qualquer " +"outro objeto guardando referências para a entidade. Em contraste com o " +"modelo usual de Java que um objeto não referenciado é coletado pelo garbage " +"collector. Entidades devem ser explicitamente salvas ou deletada (exceto em " +"operações de salvamento ou deleção que possam ser executada em " +"<emphasis>cascata</emphasis> de uma entidade pai para seus filhos). Isto é " +"diferente do modelo ODMG de persistência do objeto por acessibilidade – e " +"corresponde quase a como objetos de aplicações são geralmente usados em " +"grandes sistemas. Entidades suportam referências circulares e comuns. Eles " +"podem ser versionadas." -#: index.docbook:2499 -msgid "An entity's persistent state consists of references to other entities and instances of <emphasis>value</emphasis> types. Values are primitives, collections (not what's inside a collection), components and certain immutable objects. Unlike entities, values (in particular collections and components) <emphasis>are</emphasis> persisted and deleted by reachability. Since value objects (and primitives) are persisted and deleted along with their containing entity they may not be independently versioned. Values have no independent identity, so they cannot be shared by two entities or collections." +#. Tag: para +#: basic_mapping.xml:2499 +#, no-c-format +msgid "" +"An entity's persistent state consists of references to other entities and " +"instances of <emphasis>value</emphasis> types. Values are primitives, " +"collections (not what's inside a collection), components and certain " +"immutable objects. Unlike entities, values (in particular collections and " +"components) <emphasis>are</emphasis> persisted and deleted by reachability. " +"Since value objects (and primitives) are persisted and deleted along with " +"their containing entity they may not be independently versioned. Values have " +"no independent identity, so they cannot be shared by two entities or " +"collections." msgstr "" +"Uma entidade em estado persistente consiste de referências para outras " +"entidades e instâncias de tipos de <emphasis>valor</emphasis>. Valores são " +"primitivos, coleções (não o que tem dentro de uma coleção), componentes e " +"certos objetos imutáveis. Entidades distintas, valores (em coleções e " +"componentes particulares) <emphasis>são </emphasis> persistidos e apagados " +"por acessibilidade. Visto que objetos value (e primitivos) são persistidos e " +"apagados junto com as entidades que os contém e não podem ser versionados " +"independentemente. Valores têm identidade não independente, assim eles não " +"podem ser comuns para duas entidades ou coleções." -#: index.docbook:2510 -msgid "Up until now, we've been using the term \"persistent class\" to refer to entities. We will continue to do that. Strictly speaking, however, not all user-defined classes with persistent state are entities. A <emphasis>component</emphasis> is a user defined class with value semantics. A Java property of type <literal>java.lang.String</literal> also has value semantics. Given this definition, we can say that all types (classes) provided by the JDK have value type semantics in Java, while user-defined types may be mapped with entity or value type semantics. This decision is up to the application developer. A good hint for an entity class in a domain model are shared references to a single instance of that class, while composition or aggregation usually translates to a value type." +#. Tag: para +#: basic_mapping.xml:2510 +#, no-c-format +msgid "" +"Up until now, we've been using the term \"persistent class\" to refer to " +"entities. We will continue to do that. Strictly speaking, however, not all " +"user-defined classes with persistent state are entities. A " +"<emphasis>component</emphasis> is a user defined class with value semantics. " +"A Java property of type <literal>java.lang.String</literal> also has value " +"semantics. Given this definition, we can say that all types (classes) " +"provided by the JDK have value type semantics in Java, while user-defined " +"types may be mapped with entity or value type semantics. This decision is up " +"to the application developer. A good hint for an entity class in a domain " +"model are shared references to a single instance of that class, while " +"composition or aggregation usually translates to a value type." msgstr "" +"Até agora, nós estivemos usando o termo \"classe persistente\" para referir " +"a entidades. Nós iremos continuar a fazer isto. Falando a rigor, porém, nem " +"todas as classes definidas pelo usuário com estados persistentes são " +"entidades. Um <emphasis>componente</emphasis> é uma classe de usuário " +"definida com valores semânticos. Uma propriedade de Java de tipo " +"<literal>java.lang.String</literal> também tem um valor semêntico. Dada esta " +"definição, nós podemos dizer que todos os tipos (classes) fornecida pelo JDK " +"tem tipo de valor semântico em Java, enquanto que tipos definidos pelo " +"usuário pode ser mapeados com entidade ou valor de tipo semântico. Esta " +"decisão pertence ao desenvolvedor da aplicação. Uma boa dica para uma classe " +"entidade em um modelo de domínio são referências comuns para uma instância " +"simples daquela classe, enquanto a composição ou agregação geralmente se " +"traduz para um valor de tipo." -#: index.docbook:2524 +#. Tag: para +#: basic_mapping.xml:2524 +#, no-c-format msgid "We'll revisit both concepts throughout the documentation." -msgstr "" +msgstr "Nós iremos rever ambos os conceitos durante toda a documentação." -#: index.docbook:2528 -msgid "The challenge is to map the Java type system (and the developers' definition of entities and value types) to the SQL/database type system. The bridge between both systems is provided by Hibernate: for entities we use <literal><class></literal>, <literal><subclass></literal> and so on. For value types we use <literal><property></literal>, <literal><component></literal>, etc, usually with a <literal>type</literal> attribute. The value of this attribute is the name of a Hibernate <emphasis>mapping type</emphasis>. Hibernate provides many mappings (for standard JDK value types) out of the box. You can write your own mapping types and implement your custom conversion strategies as well, as you'll see later." +#. Tag: para +#: basic_mapping.xml:2528 +#, no-c-format +msgid "" +"The challenge is to map the Java type system (and the developers' definition " +"of entities and value types) to the SQL/database type system. The bridge " +"between both systems is provided by Hibernate: for entities we use " +"<literal><class></literal>, <literal><subclass></literal> and so " +"on. For value types we use <literal><property></literal>, <literal><" +"component></literal>, etc, usually with a <literal>type</literal> " +"attribute. The value of this attribute is the name of a Hibernate " +"<emphasis>mapping type</emphasis>. Hibernate provides many mappings (for " +"standard JDK value types) out of the box. You can write your own mapping " +"types and implement your custom conversion strategies as well, as you'll see " +"later." msgstr "" +"O desafio pe mapear o sistema de tipo de Java (e a definição do " +"desenvolvedor de entidades e tipos de valor) para o sistema de tipo SQL/" +"banco de dados. A ponte entre ambos os sistemas é fornecido pelo Hibernate: " +"para entidades que usam <literal><class></literal>, <literal><" +"subclass></literal> e assim por diante. Para tipos de valores nós usamos " +"<literal><property></literal>, <literal><component></literal>, " +"etc, geralmente com um atributo <literal>type</literal>. O valor deste " +"atributo é o nome de um <emphasis>tipo de mapeamento</emphasis> do " +"Hibernate. O Hibernate fornece muitos mapeamentos (para tipos de valores do " +"JDK padrão) ut of the box. Você pode escrever os seus próprios tipos de " +"mapeamentos e implementar sua estratégia de conversão adaptada, como você " +"verá adiante." -#: index.docbook:2541 +#. Tag: para +#: basic_mapping.xml:2541 +#, no-c-format msgid "All built-in Hibernate types except collections support null semantics." msgstr "" +"Todos os tipos internos do hibernate exceto coleções suportam semânticas " +"nulas." -#: index.docbook:2548 +#. Tag: title +#: basic_mapping.xml:2548 +#, no-c-format msgid "Basic value types" -msgstr "" +msgstr "Valores de tipos básicos" -#: index.docbook:2550 -msgid "The built-in <emphasis>basic mapping types</emphasis> may be roughly categorized into" +#. Tag: para +#: basic_mapping.xml:2550 +#, fuzzy, no-c-format +msgid "" +"The built-in <emphasis>basic mapping types</emphasis> may be roughly " +"categorized into" msgstr "" +"O tipos internos de mapeamentos básicos podem ser a grosso modo categorizado " +"como: <placeholder-1/>" -#: index.docbook:2555 -msgid "integer, long, short, float, double, character, byte, boolean, yes_no, true_false" +#. Tag: literal +#: basic_mapping.xml:2555 +#, no-c-format +msgid "" +"integer, long, short, float, double, character, byte, boolean, yes_no, " +"true_false" msgstr "" +"integer, long, short, float, double, character, byte, boolean, yes_no, " +"true_false" -#: index.docbook:2558 -msgid "Type mappings from Java primitives or wrapper classes to appropriate (vendor-specific) SQL column types. <literal>boolean, yes_no</literal> and <literal>true_false</literal> are all alternative encodings for a Java <literal>boolean</literal> or <literal>java.lang.Boolean</literal>." +#. Tag: para +#: basic_mapping.xml:2558 +#, no-c-format +msgid "" +"Type mappings from Java primitives or wrapper classes to appropriate (vendor-" +"specific) SQL column types. <literal>boolean, yes_no</literal> and " +"<literal>true_false</literal> are all alternative encodings for a Java " +"<literal>boolean</literal> or <literal>java.lang.Boolean</literal>." msgstr "" +"Tipos de mapeamentos de classes primitivas ou wrapper Java especificos " +"(vendor-specific) para tipos de coluna SQL. Boolean, <literal>boolean, " +"yes_no</literal> são todas codificações alternativas para um " +"<literal>boolean</literal> ou <literal>java.lang.Boolean</literal> do Java." -#: index.docbook:2567 +#. Tag: literal +#: basic_mapping.xml:2567 +#, no-c-format msgid "string" -msgstr "" +msgstr "string" -#: index.docbook:2569 -msgid "A type mapping from <literal>java.lang.String</literal> to <literal>VARCHAR</literal> (or Oracle <literal>VARCHAR2</literal>)." +#. Tag: para +#: basic_mapping.xml:2569 +#, no-c-format +msgid "" +"A type mapping from <literal>java.lang.String</literal> to <literal>VARCHAR</" +"literal> (or Oracle <literal>VARCHAR2</literal>)." msgstr "" +"Um tipo de mapeamento de <literal>java.lang.String</literal> para " +"<literal>VARCHAR</literal> (ou <literal>VARCHAR2</literal> no Oracle)." -#: index.docbook:2576 +#. Tag: literal +#: basic_mapping.xml:2576 +#, no-c-format msgid "date, time, timestamp" -msgstr "" +msgstr "date, time, timestamp" -#: index.docbook:2578 -msgid "Type mappings from <literal>java.util.Date</literal> and its subclasses to SQL types <literal>DATE</literal>, <literal>TIME</literal> and <literal>TIMESTAMP</literal> (or equivalent)." +#. Tag: para +#: basic_mapping.xml:2578 +#, no-c-format +msgid "" +"Type mappings from <literal>java.util.Date</literal> and its subclasses to " +"SQL types <literal>DATE</literal>, <literal>TIME</literal> and " +"<literal>TIMESTAMP</literal> (or equivalent)." msgstr "" +"Tipos de mapeamento de <literal>java.util.Date</literal> e suas subclasses " +"para os tipos SQL <literal>DATE</literal>, <literal>TIME</literal> e " +"<literal>TIMESTAMP</literal> (ou equivalente)." -#: index.docbook:2586 +#. Tag: literal +#: basic_mapping.xml:2586 +#, no-c-format msgid "calendar, calendar_date" -msgstr "" +msgstr "calendar, calendar_date" -#: index.docbook:2588 -msgid "Type mappings from <literal>java.util.Calendar</literal> to SQL types <literal>TIMESTAMP</literal> and <literal>DATE</literal> (or equivalent)." +#. Tag: para +#: basic_mapping.xml:2588 +#, no-c-format +msgid "" +"Type mappings from <literal>java.util.Calendar</literal> to SQL types " +"<literal>TIMESTAMP</literal> and <literal>DATE</literal> (or equivalent)." msgstr "" +"Tipo de mapeamento de <literal>java.util.Calendar</literal> para os tipos " +"SQL <literal>TIMESTAMP</literal> e <literal>DATE</literal> (ou equivalente)." -#: index.docbook:2596 +#. Tag: literal +#: basic_mapping.xml:2596 +#, no-c-format msgid "big_decimal, big_integer" -msgstr "" +msgstr "big_decimal, big_integer" -#: index.docbook:2598 -msgid "Type mappings from <literal>java.math.BigDecimal</literal> and <literal>java.math.BigInteger</literal> to <literal>NUMERIC</literal> (or Oracle <literal>NUMBER</literal>)." +#. Tag: para +#: basic_mapping.xml:2598 +#, no-c-format +msgid "" +"Type mappings from <literal>java.math.BigDecimal</literal> and <literal>java." +"math.BigInteger</literal> to <literal>NUMERIC</literal> (or Oracle " +"<literal>NUMBER</literal>)." msgstr "" +"Tipo de mapeamento de <literal>java.math.BigDecimal</literal> and " +"<literal>java.math.BigInteger</literal> para <literal>NUMERIC</literal> (ou " +"<literal>NUMBER</literal> no Oracle)." -#: index.docbook:2606 +#. Tag: literal +#: basic_mapping.xml:2606 +#, no-c-format msgid "locale, timezone, currency" -msgstr "" +msgstr "locale, timezone, currency" -#: index.docbook:2608 -msgid "Type mappings from <literal>java.util.Locale</literal>, <literal>java.util.TimeZone</literal> and <literal>java.util.Currency</literal> to <literal>VARCHAR</literal> (or Oracle <literal>VARCHAR2</literal>). Instances of <literal>Locale</literal> and <literal>Currency</literal> are mapped to their ISO codes. Instances of <literal>TimeZone</literal> are mapped to their <literal>ID</literal>." +#. Tag: para +#: basic_mapping.xml:2608 +#, no-c-format +msgid "" +"Type mappings from <literal>java.util.Locale</literal>, <literal>java.util." +"TimeZone</literal> and <literal>java.util.Currency</literal> to " +"<literal>VARCHAR</literal> (or Oracle <literal>VARCHAR2</literal>). " +"Instances of <literal>Locale</literal> and <literal>Currency</literal> are " +"mapped to their ISO codes. Instances of <literal>TimeZone</literal> are " +"mapped to their <literal>ID</literal>." msgstr "" +"Tipos de mapeamentos de <literal>java.util.Locale</literal>, <literal>java." +"util.TimeZone</literal> e <literal>java.util.Currency</literal> para " +"<literal>VARCHAR</literal> (ou <literal>VARCHAR2</literal> no Oracle). " +"Instâncias de f <literal>Locale</literal> e <literal>Currency</literal> são " +"mapeados para seus códigos ISO. Instâncias de <literal>TimeZone</literal> " +"são mapeados para seu <literal>ID</literal>." -#: index.docbook:2620 +#. Tag: literal +#: basic_mapping.xml:2620 +#, fuzzy, no-c-format msgid "<literal>class</literal>" -msgstr "" +msgstr "<literal>all</literal> cverifica todas as colunas" -#: index.docbook:2622 -msgid "A type mapping from <literal>java.lang.Class</literal> to <literal>VARCHAR</literal> (or Oracle <literal>VARCHAR2</literal>). A <literal>Class</literal> is mapped to its fully qualified name." +#. Tag: para +#: basic_mapping.xml:2622 +#, no-c-format +msgid "" +"A type mapping from <literal>java.lang.Class</literal> to <literal>VARCHAR</" +"literal> (or Oracle <literal>VARCHAR2</literal>). A <literal>Class</literal> " +"is mapped to its fully qualified name." msgstr "" +"um tipo de mapeamento de <literal>java.lang.Class</literal> para " +"<literal>VARCHAR</literal> (ou <literal>VARCHAR2</literal> no Oracle). Uma " +"<literal>Class</literal> é mapeada pelo seu nome qualificado (completo)." -#: index.docbook:2630 +#. Tag: literal +#: basic_mapping.xml:2630 +#, no-c-format msgid "binary" -msgstr "" +msgstr "binary" -#: index.docbook:2632 +#. Tag: para +#: basic_mapping.xml:2632 +#, no-c-format msgid "Maps byte arrays to an appropriate SQL binary type." -msgstr "" +msgstr "Mapeia arrays de bytes para um tipo binário de SQL apropriado." -#: index.docbook:2638 +#. Tag: literal +#: basic_mapping.xml:2638 +#, no-c-format msgid "text" -msgstr "" +msgstr "text" -#: index.docbook:2640 -msgid "Maps long Java strings to a SQL <literal>CLOB</literal> or <literal>TEXT</literal> type." +#. Tag: para +#: basic_mapping.xml:2640 +#, no-c-format +msgid "" +"Maps long Java strings to a SQL <literal>CLOB</literal> or <literal>TEXT</" +"literal> type." msgstr "" +"Maps long Java strings to a SQL <literal>CLOB</literal> or <literal>TEXT</" +"literal> type. Mapeia strings longas de Java para um tipo SQL <literal>CLOB</" +"literal> ou <literal>TEXT</literal>." -#: index.docbook:2647 +#. Tag: literal +#: basic_mapping.xml:2647 +#, no-c-format msgid "serializable" -msgstr "" +msgstr "serializable" -#: index.docbook:2649 -msgid "Maps serializable Java types to an appropriate SQL binary type. You may also indicate the Hibernate type <literal>serializable</literal> with the name of a serializable Java class or interface that does not default to a basic type." +#. Tag: para +#: basic_mapping.xml:2649 +#, no-c-format +msgid "" +"Maps serializable Java types to an appropriate SQL binary type. You may also " +"indicate the Hibernate type <literal>serializable</literal> with the name of " +"a serializable Java class or interface that does not default to a basic type." msgstr "" +"Mapeia tipos Java serializáveis para um tipo binário SQL apropriado. Você " +"pode também indicar o tipo <literal>serializable</literal> do Hibernate com " +"o nome da classe ou interface Java serializável que não é padrão para um " +"tipo básico." -#: index.docbook:2658 +#. Tag: literal +#: basic_mapping.xml:2658 +#, no-c-format msgid "clob, blob" -msgstr "" +msgstr "clob, blob" -#: index.docbook:2660 -msgid "Type mappings for the JDBC classes <literal>java.sql.Clob</literal> and <literal>java.sql.Blob</literal>. These types may be inconvenient for some applications, since the blob or clob object may not be reused outside of a transaction. (Furthermore, driver support is patchy and inconsistent.)" +#. Tag: para +#: basic_mapping.xml:2660 +#, no-c-format +msgid "" +"Type mappings for the JDBC classes <literal>java.sql.Clob</literal> and " +"<literal>java.sql.Blob</literal>. These types may be inconvenient for some " +"applications, since the blob or clob object may not be reused outside of a " +"transaction. (Furthermore, driver support is patchy and inconsistent.)" msgstr "" +"Tipos de mapeamentos para as classes JDBC <literal>java.sql.Clob</literal> " +"and <literal>java.sql.Blob</literal>. Estes tipos podem ser inconveniente " +"para algumas aplicações, visto que o objeto blob ou clob pode não ser " +"reusado fora de uma transação. (Além disso, o suporte de driver é imcompleto " +"e inconsistente.)" -#: index.docbook:2670 -msgid "imm_date, imm_time, imm_timestamp, imm_calendar, imm_calendar_date, imm_serializable, imm_binary" +#. Tag: literal +#: basic_mapping.xml:2670 +#, no-c-format +msgid "" +"imm_date, imm_time, imm_timestamp, imm_calendar, imm_calendar_date, " +"imm_serializable, imm_binary" msgstr "" +"imm_date, imm_time, imm_timestamp, imm_calendar, imm_calendar_date, " +"imm_serializable, imm_binary" -#: index.docbook:2674 -msgid "Type mappings for what are usually considered mutable Java types, where Hibernate makes certain optimizations appropriate only for immutable Java types, and the application treats the object as immutable. For example, you should not call <literal>Date.setTime()</literal> for an instance mapped as <literal>imm_timestamp</literal>. To change the value of the property, and have that change made persistent, the application must assign a new (nonidentical) object to the property." +#. Tag: para +#: basic_mapping.xml:2674 +#, no-c-format +msgid "" +"Type mappings for what are usually considered mutable Java types, where " +"Hibernate makes certain optimizations appropriate only for immutable Java " +"types, and the application treats the object as immutable. For example, you " +"should not call <literal>Date.setTime()</literal> for an instance mapped as " +"<literal>imm_timestamp</literal>. To change the value of the property, and " +"have that change made persistent, the application must assign a new " +"(nonidentical) object to the property." msgstr "" +"Mapeando tipos para o que geralmente são consideradas tipos mutáveis de " +"Java, onde o Hibernate faz determinadas otimizações apropriadas somente para " +"tipos imutáveis de Java, e a aplicação trata o objeto como imutável. Por " +"exemplo, você não deve chamar <literal>Date.setTime()</literal> para uma " +"instância mapeada como <literal>imm_timestamp</literal>. Para mudar o valor " +"da propriedade, e ter a mudança feita persistente, a aplicação deve atribuir " +"um novo objeto (nonidentical) à propriedade." -#: index.docbook:2689 -msgid "Unique identifiers of entities and collections may be of any basic type except <literal>binary</literal>, <literal>blob</literal> and <literal>clob</literal>. (Composite identifiers are also allowed, see below.)" +#. Tag: para +#: basic_mapping.xml:2689 +#, no-c-format +msgid "" +"Unique identifiers of entities and collections may be of any basic type " +"except <literal>binary</literal>, <literal>blob</literal> and <literal>clob</" +"literal>. (Composite identifiers are also allowed, see below.)" msgstr "" +"Identificadores únicos das entidades e coleções podem ser de qualquer tipo " +"básico exceto <literal>binary</literal>, <literal>blob</literal> ou " +"<literal>clob</literal>. (Identificadores compostos também são permitidos, " +"veja abaixo.)" -#: index.docbook:2695 -msgid "The basic value types have corresponding <literal>Type</literal> constants defined on <literal>org.hibernate.Hibernate</literal>. For example, <literal>Hibernate.STRING</literal> represents the <literal>string</literal> type." +#. Tag: para +#: basic_mapping.xml:2695 +#, no-c-format +msgid "" +"The basic value types have corresponding <literal>Type</literal> constants " +"defined on <literal>org.hibernate.Hibernate</literal>. For example, " +"<literal>Hibernate.STRING</literal> represents the <literal>string</literal> " +"type." msgstr "" +"Os tipos de valores básicos têm suas constantes <literal>Type</literal> " +"correspondentes definidas em <literal>org.hibernate.Hibernate</literal>. Por " +"exemplo, <literal>Hibernate.STRING</literal> representa o tipo " +"<literal>string</literal>." -#: index.docbook:2704 +#. Tag: title +#: basic_mapping.xml:2704 +#, no-c-format msgid "Custom value types" -msgstr "" +msgstr "Tipos de valores personalizados" -#: index.docbook:2706 -msgid "It is relatively easy for developers to create their own value types. For example, you might want to persist properties of type <literal>java.lang.BigInteger</literal> to <literal>VARCHAR</literal> columns. Hibernate does not provide a built-in type for this. But custom types are not limited to mapping a property (or collection element) to a single table column. So, for example, you might have a Java property <literal>getName()</literal>/<literal>setName()</literal> of type <literal>java.lang.String</literal> that is persisted to the columns <literal>FIRST_NAME</literal>, <literal>INITIAL</literal>, <literal>SURNAME</literal>." +#. Tag: para +#: basic_mapping.xml:2706 +#, no-c-format +msgid "" +"It is relatively easy for developers to create their own value types. For " +"example, you might want to persist properties of type <literal>java.lang." +"BigInteger</literal> to <literal>VARCHAR</literal> columns. Hibernate does " +"not provide a built-in type for this. But custom types are not limited to " +"mapping a property (or collection element) to a single table column. So, for " +"example, you might have a Java property <literal>getName()</literal>/" +"<literal>setName()</literal> of type <literal>java.lang.String</literal> " +"that is persisted to the columns <literal>FIRST_NAME</literal>, " +"<literal>INITIAL</literal>, <literal>SURNAME</literal>." msgstr "" +"É relativamente fácil para desenvolvedores criar seus próprios tipos de " +"valor. Por exemplo, você pode querer persistir propriedades do tipo " +"<literal>java.lang.BigInteger</literal> para colunas <literal>VARCHAR</" +"literal>. O Hibernate não fornece um tipo correspondente para isso. Mas os " +"tipos adaptados não são limitados a mapeamento de uma propriedade (ou " +"elemento de coleção) a uma única coluna da tabela. Assim, por exemplo, você " +"pôde ter uma propriedade Java <literal>getName()</literal>/<literal>setName()" +"</literal> do tipo <literal>java.lang.String</literal> que é persistido para " +"colunas <literal>FIRST_NAME</literal>, <literal>INITIAL</literal>, " +"<literal>SURNAME</literal>." -#: index.docbook:2717 -msgid "To implement a custom type, implement either <literal>org.hibernate.UserType</literal> or <literal>org.hibernate.CompositeUserType</literal> and declare properties using the fully qualified classname of the type. Check out <literal>org.hibernate.test.DoubleStringType</literal> to see the kind of things that are possible." +#. Tag: para +#: basic_mapping.xml:2717 +#, no-c-format +msgid "" +"To implement a custom type, implement either <literal>org.hibernate." +"UserType</literal> or <literal>org.hibernate.CompositeUserType</literal> and " +"declare properties using the fully qualified classname of the type. Check " +"out <literal>org.hibernate.test.DoubleStringType</literal> to see the kind " +"of things that are possible." msgstr "" +"Para implementar um tipo personalizado, implemente <literal>org.hibernate." +"UserType</literal> or <literal>org.hibernate.CompositeUserType</literal> e " +"declare propriedades usando o nome qualificado da classe do tipo. Veja " +"<literal>org.hibernate.test.DoubleStringType</literal> para ver o tipo das " +"coisas que são possíveis." -#: index.docbook:2725 +#. Tag: programlisting +#: basic_mapping.xml:2725 +#, no-c-format msgid "" - "<![CDATA[<property name=\"twoStrings\" type=\"org.hibernate.test.DoubleStringType\">\n" - " <column name=\"first_string\"/>\n" - " <column name=\"second_string\"/>\n" - "</property>]]>" +"<![CDATA[<property name=\"twoStrings\" type=\"org.hibernate.test." +"DoubleStringType\">\n" +" <column name=\"first_string\"/>\n" +" <column name=\"second_string\"/>\n" +"</property>]]>" msgstr "" -#: index.docbook:2727 -msgid "Notice the use of <literal><column></literal> tags to map a property to multiple columns." +#. Tag: para +#: basic_mapping.xml:2727 +#, no-c-format +msgid "" +"Notice the use of <literal><column></literal> tags to map a property " +"to multiple columns." msgstr "" +"Observe o uso da tag <literal><column></literal> para mapear uma " +"propriedade para colunas múltiplas." -#: index.docbook:2732 -msgid "The <literal>CompositeUserType</literal>, <literal>EnhancedUserType</literal>, <literal>UserCollectionType</literal>, and <literal>UserVersionType</literal> interfaces provide support for more specialized uses." +#. Tag: para +#: basic_mapping.xml:2732 +#, no-c-format +msgid "" +"The <literal>CompositeUserType</literal>, <literal>EnhancedUserType</" +"literal>, <literal>UserCollectionType</literal>, and " +"<literal>UserVersionType</literal> interfaces provide support for more " +"specialized uses." msgstr "" +"As interfaces <literal>CompositeUserType</literal>, " +"<literal>EnhancedUserType</literal>, <literal>UserCollectionType</literal>, " +"e <literal>UserVersionType</literal> fornecem suporte para usos mais " +"especializados." -#: index.docbook:2738 -msgid "You may even supply parameters to a <literal>UserType</literal> in the mapping file. To do this, your <literal>UserType</literal> must implement the <literal>org.hibernate.usertype.ParameterizedType</literal> interface. To supply parameters to your custom type, you can use the <literal><type></literal> element in your mapping files." +#. Tag: para +#: basic_mapping.xml:2738 +#, no-c-format +msgid "" +"You may even supply parameters to a <literal>UserType</literal> in the " +"mapping file. To do this, your <literal>UserType</literal> must implement " +"the <literal>org.hibernate.usertype.ParameterizedType</literal> interface. " +"To supply parameters to your custom type, you can use the <literal><" +"type></literal> element in your mapping files." msgstr "" +"Você pode mesmo fornecer parâmetros a um <literal>UserType</literal> no " +"arquivo de mapeamento. Para isto, seu <literal>UserType</literal> deve " +"implementar a interface <literal>org.hibernate.usertype.ParameterizedType</" +"literal>. Para fornecer parâmetros a seu tipo personalizado, você pode usar " +"o elemento <literal><type></literal> em seus arquivos de mapeamento." -#: index.docbook:2746 +#. Tag: programlisting +#: basic_mapping.xml:2746 +#, no-c-format msgid "" - "<![CDATA[<property name=\"priority\">\n" - " <type name=\"com.mycompany.usertypes.DefaultValueIntegerType\">\n" - " <param name=\"default\">0</param>\n" - " </type>\n" - "</property>]]>" +"<![CDATA[<property name=\"priority\">\n" +" <type name=\"com.mycompany.usertypes.DefaultValueIntegerType\">\n" +" <param name=\"default\">0</param>\n" +" </type>\n" +"</property>]]>" msgstr "" -#: index.docbook:2748 -msgid "The <literal>UserType</literal> can now retrieve the value for the parameter named <literal>default</literal> from the <literal>Properties</literal> object passed to it." +#. Tag: para +#: basic_mapping.xml:2748 +#, no-c-format +msgid "" +"The <literal>UserType</literal> can now retrieve the value for the parameter " +"named <literal>default</literal> from the <literal>Properties</literal> " +"object passed to it." msgstr "" +"O <literal>UserType</literal> pode agora recuperar o valor para o parâmetro " +"chamado <literal>default</literal> da <literal>Propriedade</literal> do " +"passado a ele." -#: index.docbook:2753 -msgid "If you use a certain <literal>UserType</literal> very often, it may be useful to define a shorter name for it. You can do this using the <literal><typedef></literal> element. Typedefs assign a name to a custom type, and may also contain a list of default parameter values if the type is parameterized." +#. Tag: para +#: basic_mapping.xml:2753 +#, no-c-format +msgid "" +"If you use a certain <literal>UserType</literal> very often, it may be " +"useful to define a shorter name for it. You can do this using the " +"<literal><typedef></literal> element. Typedefs assign a name to a " +"custom type, and may also contain a list of default parameter values if the " +"type is parameterized." msgstr "" +"Se você usar freqüentemente um determinado <literal>UserType</literal>, pode " +"ser útil definir um nome mais curto para ele. Você pode fazer isto usando o " +"elemento <literal><typedef></literal>. Typedefs atribui um nome a um " +"tipo personalizado, e pode também conter uma lista de valores default de " +"parâmetro se o tipo for parametrizado." -#: index.docbook:2760 +#. Tag: programlisting +#: basic_mapping.xml:2760 +#, no-c-format msgid "" - "<![CDATA[<typedef class=\"com.mycompany.usertypes.DefaultValueIntegerType\" name=\"default_zero\">\n" - " <param name=\"default\">0</param>\n" - "</typedef>]]>" +"<![CDATA[<typedef class=\"com.mycompany.usertypes.DefaultValueIntegerType\" " +"name=\"default_zero\">\n" +" <param name=\"default\">0</param>\n" +"</typedef>]]>" msgstr "" -#: index.docbook:2762 +#. Tag: programlisting +#: basic_mapping.xml:2762 +#, no-c-format msgid "<![CDATA[<property name=\"priority\" type=\"default_zero\"/>]]>" msgstr "" -#: index.docbook:2764 -msgid "It is also possible to override the parameters supplied in a typedef on a case-by-case basis by using type parameters on the property mapping." +#. Tag: para +#: basic_mapping.xml:2764 +#, no-c-format +msgid "" +"It is also possible to override the parameters supplied in a typedef on a " +"case-by-case basis by using type parameters on the property mapping." msgstr "" +"It is also possible to override the parameters supplied in a typedef on a " +"case-by-case basis by using type parameters on the property mapping." -#: index.docbook:2769 -msgid "Even though Hibernate's rich range of built-in types and support for components means you will very rarely <emphasis>need</emphasis> to use a custom type, it is nevertheless considered good form to use custom types for (non-entity) classes that occur frequently in your application. For example, a <literal>MonetaryAmount</literal> class is a good candidate for a <literal>CompositeUserType</literal>, even though it could easily be mapped as a component. One motivation for this is abstraction. With a custom type, your mapping documents would be future-proofed against possible changes in your way of representing monetary values." +#. Tag: para +#: basic_mapping.xml:2769 +#, no-c-format +msgid "" +"Even though Hibernate's rich range of built-in types and support for " +"components means you will very rarely <emphasis>need</emphasis> to use a " +"custom type, it is nevertheless considered good form to use custom types for " +"(non-entity) classes that occur frequently in your application. For example, " +"a <literal>MonetaryAmount</literal> class is a good candidate for a " +"<literal>CompositeUserType</literal>, even though it could easily be mapped " +"as a component. One motivation for this is abstraction. With a custom type, " +"your mapping documents would be future-proofed against possible changes in " +"your way of representing monetary values." msgstr "" +"Even though Hibernate's rich range of built-in types and support for " +"components means you will very rarely <emphasis>need</emphasis> to use a " +"custom type, it is nevertheless considered good form to use custom types for " +"(non-entity) classes that occur frequently in your application. For example, " +"a <literal>MonetaryAmount</literal> class is a good candidate for a " +"<literal>CompositeUserType</literal>, even though it could easily be mapped " +"as a component. One motivation for this is abstraction. With a custom type, " +"your mapping documents would be future-proofed against possible changes in " +"your way of representing monetary values." -#: index.docbook:2785 +#. Tag: title +#: basic_mapping.xml:2785 +#, no-c-format msgid "Mapping a class more than once" -msgstr "" +msgstr "Mapping a class more than once" -#: index.docbook:2786 -msgid "It is possible to provide more than one mapping for a particular persistent class. In this case you must specify an <emphasis>entity name</emphasis> do disambiguate between instances of the two mapped entities. (By default, the entity name is the same as the class name.) Hibernate lets you specify the entity name when working with persistent objects, when writing queries, or when mapping associations to the named entity." +#. Tag: para +#: basic_mapping.xml:2786 +#, no-c-format +msgid "" +"It is possible to provide more than one mapping for a particular persistent " +"class. In this case you must specify an <emphasis>entity name</emphasis> do " +"disambiguate between instances of the two mapped entities. (By default, the " +"entity name is the same as the class name.) Hibernate lets you specify the " +"entity name when working with persistent objects, when writing queries, or " +"when mapping associations to the named entity." msgstr "" +"It is possible to provide more than one mapping for a particular persistent " +"class. In this case you must specify an <emphasis>entity name</emphasis> do " +"disambiguate between instances of the two mapped entities. (By default, the " +"entity name is the same as the class name.) Hibernate lets you specify the " +"entity name when working with persistent objects, when writing queries, or " +"when mapping associations to the named entity." -#: index.docbook:2794 +#. Tag: programlisting +#: basic_mapping.xml:2794 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Contract\" table=\"Contracts\"\n" - " entity-name=\"CurrentContract\">\n" - " ...\n" - " <set name=\"history\" inverse=\"true\"\n" - " order-by=\"effectiveEndDate desc\">\n" - " <key column=\"currentContractId\"/>\n" - " <one-to-many entity-name=\"HistoricalContract\"/>\n" - " </set>\n" - "</class>\n" - "\n" - "<class name=\"Contract\" table=\"ContractHistory\"\n" - " entity-name=\"HistoricalContract\">\n" - " ...\n" - " <many-to-one name=\"currentContract\"\n" - " column=\"currentContractId\"\n" - " entity-name=\"CurrentContract\"/>\n" - "</class>]]>" +"<![CDATA[<class name=\"Contract\" table=\"Contracts\"\n" +" entity-name=\"CurrentContract\">\n" +" ...\n" +" <set name=\"history\" inverse=\"true\"\n" +" order-by=\"effectiveEndDate desc\">\n" +" <key column=\"currentContractId\"/>\n" +" <one-to-many entity-name=\"HistoricalContract\"/>\n" +" </set>\n" +"</class>\n" +"\n" +"<class name=\"Contract\" table=\"ContractHistory\"\n" +" entity-name=\"HistoricalContract\">\n" +" ...\n" +" <many-to-one name=\"currentContract\"\n" +" column=\"currentContractId\"\n" +" entity-name=\"CurrentContract\"/>\n" +"</class>]]>" msgstr "" -#: index.docbook:2796 -msgid "Notice how associations are now specified using <literal>entity-name</literal> instead of <literal>class</literal>." +#. Tag: para +#: basic_mapping.xml:2796 +#, no-c-format +msgid "" +"Notice how associations are now specified using <literal>entity-name</" +"literal> instead of <literal>class</literal>." msgstr "" +"Notice how associations are now specified using <literal>entity-name</" +"literal> instead of <literal>class</literal>." -#: index.docbook:2804 +#. Tag: title +#: basic_mapping.xml:2804 +#, no-c-format msgid "SQL quoted identifiers" -msgstr "" +msgstr "SQL quoted identifiers" -#: index.docbook:2805 -msgid "You may force Hibernate to quote an identifier in the generated SQL by enclosing the table or column name in backticks in the mapping document. Hibernate will use the correct quotation style for the SQL <literal>Dialect</literal> (usually double quotes, but brackets for SQL Server and backticks for MySQL)." +#. Tag: para +#: basic_mapping.xml:2805 +#, no-c-format +msgid "" +"You may force Hibernate to quote an identifier in the generated SQL by " +"enclosing the table or column name in backticks in the mapping document. " +"Hibernate will use the correct quotation style for the SQL <literal>Dialect</" +"literal> (usually double quotes, but brackets for SQL Server and backticks " +"for MySQL)." msgstr "" +"You may force Hibernate to quote an identifier in the generated SQL by " +"enclosing the table or column name in backticks in the mapping document. " +"Hibernate will use the correct quotation style for the SQL <literal>Dialect</" +"literal> (usually double quotes, but brackets for SQL Server and backticks " +"for MySQL)." -#: index.docbook:2812 +#. Tag: programlisting +#: basic_mapping.xml:2812 +#, no-c-format msgid "" - "<![CDATA[<class name=\"LineItem\" table=\"`Line Item`\">\n" - " <id name=\"id\" column=\"`Item Id`\"/><generator class=\"assigned\"/></id>\n" - " <property name=\"itemNumber\" column=\"`Item #`\"/>\n" - " ...\n" - "</class>]]>" +"<![CDATA[<class name=\"LineItem\" table=\"`Line Item`\">\n" +" <id name=\"id\" column=\"`Item Id`\"/><generator class=\"assigned\"/></" +"id>\n" +" <property name=\"itemNumber\" column=\"`Item #`\"/>\n" +" ...\n" +"</class>]]>" msgstr "" -#: index.docbook:2818 +#. Tag: title +#: basic_mapping.xml:2818 +#, no-c-format msgid "Metadata alternatives" -msgstr "" +msgstr "Metadata alternatives" -#: index.docbook:2820 -msgid "XML isn't for everyone, and so there are some alternative ways to define O/R mapping metadata in Hibernate." +#. Tag: para +#: basic_mapping.xml:2820 +#, no-c-format +msgid "" +"XML isn't for everyone, and so there are some alternative ways to define O/R " +"mapping metadata in Hibernate." msgstr "" +"XML isn't for everyone, and so there are some alternative ways to define O/R " +"mapping metadata in Hibernate." -#: index.docbook:2825 +#. Tag: title +#: basic_mapping.xml:2825 +#, no-c-format msgid "Using XDoclet markup" -msgstr "" +msgstr "Using XDoclet markup" -#: index.docbook:2827 -msgid "Many Hibernate users prefer to embed mapping information directly in sourcecode using XDoclet <literal>@hibernate.tags</literal>. We will not cover this approach in this document, since strictly it is considered part of XDoclet. However, we include the following example of the <literal>Cat</literal> class with XDoclet mappings." +#. Tag: para +#: basic_mapping.xml:2827 +#, no-c-format +msgid "" +"Many Hibernate users prefer to embed mapping information directly in " +"sourcecode using XDoclet <literal>@hibernate.tags</literal>. We will not " +"cover this approach in this document, since strictly it is considered part " +"of XDoclet. However, we include the following example of the <literal>Cat</" +"literal> class with XDoclet mappings." msgstr "" +"Many Hibernate users prefer to embed mapping information directly in " +"sourcecode using XDoclet <literal>@hibernate.tags</literal>. We will not " +"cover this approach in this document, since strictly it is considered part " +"of XDoclet. However, we include the following example of the <literal>Cat</" +"literal> class with XDoclet mappings." -#: index.docbook:2834 +#. Tag: programlisting +#: basic_mapping.xml:2834 +#, no-c-format msgid "" - "<![CDATA[package eg;\n" - "import java.util.Set;\n" - "import java.util.Date;\n" - "\n" - "/**\n" - " * @hibernate.class\n" - " * table=\"CATS\"\n" - " */\n" - "public class Cat {\n" - " private Long id; // identifier\n" - " private Date birthdate;\n" - " private Cat mother;\n" - " private Set kittens\n" - " private Color color;\n" - " private char sex;\n" - " private float weight;\n" - "\n" - " /*\n" - " * @hibernate.id\n" - " * generator-class=\"native\"\n" - " * column=\"CAT_ID\"\n" - " */\n" - " public Long getId() {\n" - " return id;\n" - " }\n" - " private void setId(Long id) {\n" - " this.id=id;\n" - " }\n" - "\n" - " /**\n" - " * @hibernate.many-to-one\n" - " * column=\"PARENT_ID\"\n" - " */\n" - " public Cat getMother() {\n" - " return mother;\n" - " }\n" - " void setMother(Cat mother) {\n" - " this.mother = mother;\n" - " }\n" - "\n" - " /**\n" - " * @hibernate.property\n" - " * column=\"BIRTH_DATE\"\n" - " */\n" - " public Date getBirthdate() {\n" - " return birthdate;\n" - " }\n" - " void setBirthdate(Date date) {\n" - " birthdate = date;\n" - " }\n" - " /**\n" - " * @hibernate.property\n" - " * column=\"WEIGHT\"\n" - " */\n" - " public float getWeight() {\n" - " return weight;\n" - " }\n" - " void setWeight(float weight) {\n" - " this.weight = weight;\n" - " }\n" - "\n" - " /**\n" - " * @hibernate.property\n" - " * column=\"COLOR\"\n" - " * not-null=\"true\"\n" - " */\n" - " public Color getColor() {\n" - " return color;\n" - " }\n" - " void setColor(Color color) {\n" - " this.color = color;\n" - " }\n" - " /**\n" - " * @hibernate.set\n" - " * inverse=\"true\"\n" - " * order-by=\"BIRTH_DATE\"\n" - " * @hibernate.collection-key\n" - " * column=\"PARENT_ID\"\n" - " * @hibernate.collection-one-to-many\n" - " */\n" - " public Set getKittens() {\n" - " return kittens;\n" - " }\n" - " void setKittens(Set kittens) {\n" - " this.kittens = kittens;\n" - " }\n" - " // addKitten not needed by Hibernate\n" - " public void addKitten(Cat kitten) {\n" - " kittens.add(kitten);\n" - " }\n" - "\n" - " /**\n" - " * @hibernate.property\n" - " * column=\"SEX\"\n" - " * not-null=\"true\"\n" - " * update=\"false\"\n" - " */\n" - " public char getSex() {\n" - " return sex;\n" - " }\n" - " void setSex(char sex) {\n" - " this.sex=sex;\n" - " }\n" - "}]]>" +"<![CDATA[package eg;\n" +"import java.util.Set;\n" +"import java.util.Date;\n" +"\n" +"/**\n" +" * @hibernate.class\n" +" * table=\"CATS\"\n" +" */\n" +"public class Cat {\n" +" private Long id; // identifier\n" +" private Date birthdate;\n" +" private Cat mother;\n" +" private Set kittens\n" +" private Color color;\n" +" private char sex;\n" +" private float weight;\n" +"\n" +" /*\n" +" * @hibernate.id\n" +" * generator-class=\"native\"\n" +" * column=\"CAT_ID\"\n" +" */\n" +" public Long getId() {\n" +" return id;\n" +" }\n" +" private void setId(Long id) {\n" +" this.id=id;\n" +" }\n" +"\n" +" /**\n" +" * @hibernate.many-to-one\n" +" * column=\"PARENT_ID\"\n" +" */\n" +" public Cat getMother() {\n" +" return mother;\n" +" }\n" +" void setMother(Cat mother) {\n" +" this.mother = mother;\n" +" }\n" +"\n" +" /**\n" +" * @hibernate.property\n" +" * column=\"BIRTH_DATE\"\n" +" */\n" +" public Date getBirthdate() {\n" +" return birthdate;\n" +" }\n" +" void setBirthdate(Date date) {\n" +" birthdate = date;\n" +" }\n" +" /**\n" +" * @hibernate.property\n" +" * column=\"WEIGHT\"\n" +" */\n" +" public float getWeight() {\n" +" return weight;\n" +" }\n" +" void setWeight(float weight) {\n" +" this.weight = weight;\n" +" }\n" +"\n" +" /**\n" +" * @hibernate.property\n" +" * column=\"COLOR\"\n" +" * not-null=\"true\"\n" +" */\n" +" public Color getColor() {\n" +" return color;\n" +" }\n" +" void setColor(Color color) {\n" +" this.color = color;\n" +" }\n" +" /**\n" +" * @hibernate.set\n" +" * inverse=\"true\"\n" +" * order-by=\"BIRTH_DATE\"\n" +" * @hibernate.collection-key\n" +" * column=\"PARENT_ID\"\n" +" * @hibernate.collection-one-to-many\n" +" */\n" +" public Set getKittens() {\n" +" return kittens;\n" +" }\n" +" void setKittens(Set kittens) {\n" +" this.kittens = kittens;\n" +" }\n" +" // addKitten not needed by Hibernate\n" +" public void addKitten(Cat kitten) {\n" +" kittens.add(kitten);\n" +" }\n" +"\n" +" /**\n" +" * @hibernate.property\n" +" * column=\"SEX\"\n" +" * not-null=\"true\"\n" +" * update=\"false\"\n" +" */\n" +" public char getSex() {\n" +" return sex;\n" +" }\n" +" void setSex(char sex) {\n" +" this.sex=sex;\n" +" }\n" +"}]]>" msgstr "" -#: index.docbook:2836 +#. Tag: para +#: basic_mapping.xml:2836 +#, no-c-format msgid "See the Hibernate web site for more examples of XDoclet and Hibernate." -msgstr "" +msgstr "See the Hibernate web site for more examples of XDoclet and Hibernate." -#: index.docbook:2843 +#. Tag: title +#: basic_mapping.xml:2843 +#, no-c-format msgid "Using JDK 5.0 Annotations" -msgstr "" +msgstr "Using JDK 5.0 Annotations" -#: index.docbook:2845 -msgid "JDK 5.0 introduced XDoclet-style annotations at the language level, type-safe and checked at compile time. This mechnism is more powerful than XDoclet annotations and better supported by tools and IDEs. IntelliJ IDEA, for example, supports auto-completion and syntax highlighting of JDK 5.0 annotations. The new revision of the EJB specification (JSR-220) uses JDK 5.0 annotations as the primary metadata mechanism for entity beans. Hibernate3 implements the <literal>EntityManager</literal> of JSR-220 (the persistence API), support for mapping metadata is available via the <emphasis>Hibernate Annotations</emphasis> package, as a separate download. Both EJB3 (JSR-220) and Hibernate3 metadata is supported." +#. Tag: para +#: basic_mapping.xml:2845 +#, no-c-format +msgid "" +"JDK 5.0 introduced XDoclet-style annotations at the language level, type-" +"safe and checked at compile time. This mechnism is more powerful than " +"XDoclet annotations and better supported by tools and IDEs. IntelliJ IDEA, " +"for example, supports auto-completion and syntax highlighting of JDK 5.0 " +"annotations. The new revision of the EJB specification (JSR-220) uses JDK " +"5.0 annotations as the primary metadata mechanism for entity beans. " +"Hibernate3 implements the <literal>EntityManager</literal> of JSR-220 (the " +"persistence API), support for mapping metadata is available via the " +"<emphasis>Hibernate Annotations</emphasis> package, as a separate download. " +"Both EJB3 (JSR-220) and Hibernate3 metadata is supported." msgstr "" +"JDK 5.0 introduced XDoclet-style annotations at the language level, type-" +"safe and checked at compile time. This mechnism is more powerful than " +"XDoclet annotations and better supported by tools and IDEs. IntelliJ IDEA, " +"for example, supports auto-completion and syntax highlighting of JDK 5.0 " +"annotations. The new revision of the EJB specification (JSR-220) uses JDK " +"5.0 annotations as the primary metadata mechanism for entity beans. " +"Hibernate3 implements the <literal>EntityManager</literal> of JSR-220 (the " +"persistence API), support for mapping metadata is available via the " +"<emphasis>Hibernate Annotations</emphasis> package, as a separate download. " +"Both EJB3 (JSR-220) and Hibernate3 metadata is supported." -#: index.docbook:2856 +#. Tag: para +#: basic_mapping.xml:2856 +#, no-c-format msgid "This is an example of a POJO class annotated as an EJB entity bean:" -msgstr "" +msgstr "This is an example of a POJO class annotated as an EJB entity bean:" -#: index.docbook:2860 +#. Tag: programlisting +#: basic_mapping.xml:2860 +#, no-c-format msgid "" - "<![CDATA[@Entity(access = AccessType.FIELD)\n" - "public class Customer implements Serializable {\n" - "\n" - " @Id;\n" - " Long id;\n" - "\n" - " String firstName;\n" - " String lastName;\n" - " Date birthday;\n" - "\n" - " @Transient\n" - " Integer age;\n" - "\n" - " @Embedded\n" - " private Address homeAddress;\n" - "\n" - " @OneToMany(cascade=CascadeType.ALL)\n" - " @JoinColumn(name=\"CUSTOMER_ID\")\n" - " Set<Order> orders;\n" - "\n" - " // Getter/setter and business methods\n" - "}]]>" +"<![CDATA[@Entity(access = AccessType.FIELD)\n" +"public class Customer implements Serializable {\n" +"\n" +" @Id;\n" +" Long id;\n" +"\n" +" String firstName;\n" +" String lastName;\n" +" Date birthday;\n" +"\n" +" @Transient\n" +" Integer age;\n" +"\n" +" @Embedded\n" +" private Address homeAddress;\n" +"\n" +" @OneToMany(cascade=CascadeType.ALL)\n" +" @JoinColumn(name=\"CUSTOMER_ID\")\n" +" Set<Order> orders;\n" +"\n" +" // Getter/setter and business methods\n" +"}]]>" msgstr "" -#: index.docbook:2862 -msgid "Note that support for JDK 5.0 Annotations (and JSR-220) is still work in progress and not completed. Please refer to the Hibernate Annotations module for more details." +#. Tag: para +#: basic_mapping.xml:2862 +#, no-c-format +msgid "" +"Note that support for JDK 5.0 Annotations (and JSR-220) is still work in " +"progress and not completed. Please refer to the Hibernate Annotations module " +"for more details." msgstr "" +"Note that support for JDK 5.0 Annotations (and JSR-220) is still work in " +"progress and not completed. Please refer to the Hibernate Annotations module " +"for more details." -#: index.docbook:2871 +#. Tag: title +#: basic_mapping.xml:2871 +#, no-c-format msgid "Generated Properties" -msgstr "" +msgstr "Generated Properties" -#: index.docbook:2872 -msgid "Generated properties are properties which have their values generated by the database. Typically, Hibernate applications needed to <literal>refresh</literal> objects which contain any properties for which the database was generating values. Marking properties as generated, however, lets the application delegate this responsibility to Hibernate. Essentially, whenever Hibernate issues an SQL INSERT or UPDATE for an entity which has defined generated properties, it immediately issues a select afterwards to retrieve the generated values." +#. Tag: para +#: basic_mapping.xml:2872 +#, no-c-format +msgid "" +"Generated properties are properties which have their values generated by the " +"database. Typically, Hibernate applications needed to <literal>refresh</" +"literal> objects which contain any properties for which the database was " +"generating values. Marking properties as generated, however, lets the " +"application delegate this responsibility to Hibernate. Essentially, whenever " +"Hibernate issues an SQL INSERT or UPDATE for an entity which has defined " +"generated properties, it immediately issues a select afterwards to retrieve " +"the generated values." msgstr "" +"Generated properties are properties which have their values generated by the " +"database. Typically, Hibernate applications needed to <literal>refresh</" +"literal> objects which contain any properties for which the database was " +"generating values. Marking properties as generated, however, lets the " +"application delegate this responsibility to Hibernate. Essentially, whenever " +"Hibernate issues an SQL INSERT or UPDATE for an entity which has defined " +"generated properties, it immediately issues a select afterwards to retrieve " +"the generated values." -#: index.docbook:2881 -msgid "Properties marked as generated must additionally be non-insertable and non-updateable. Only <xref linkend=\"mapping-declaration-version\"/>versions, <xref linkend=\"mapping-declaration-timestamp\"/>timestamps, and <xref linkend=\"mapping-declaration-property\"/>simple properties can be marked as generated." +#. Tag: para +#: basic_mapping.xml:2881 +#, no-c-format +msgid "" +"Properties marked as generated must additionally be non-insertable and non-" +"updateable. Only <link linkend=\"mapping-declaration-version\">versions</" +"link>, <link linkend=\"mapping-declaration-timestamp\">timestamps</link>, " +"and <link linkend=\"mapping-declaration-property\">simple properties</link> " +"can be marked as generated." msgstr "" +"Properties marked as generated must additionally be non-insertable and non-" +"updateable. Only <xref linkend=\"mapping-declaration-version\">versions</" +"xref>, <xref linkend=\"mapping-declaration-timestamp\">timestamps</xref>, " +"and <xref linkend=\"mapping-declaration-property\">simple properties</xref> " +"can be marked as generated." -#: index.docbook:2888 -msgid "<literal>never</literal> (the default) - means that the given property value is not generated within the database." +#. Tag: para +#: basic_mapping.xml:2888 +#, no-c-format +msgid "" +"<literal>never</literal> (the default) - means that the given property value " +"is not generated within the database." msgstr "" +"<literal>never</literal> (the default) - means that the given property value " +"is not generated within the database." -#: index.docbook:2892 -msgid "<literal>insert</literal> - states that the given property value is generated on insert, but is not regenerated on subsequent updates. Things like created-date would fall into this category. Note that even thought <xref linkend=\"mapping-declaration-version\"/>version and <xref linkend=\"mapping-declaration-timestamp\"/>timestamp properties can be marked as generated, this option is not available there..." +#. Tag: para +#: basic_mapping.xml:2892 +#, no-c-format +msgid "" +"<literal>insert</literal> - states that the given property value is " +"generated on insert, but is not regenerated on subsequent updates. Things " +"like created-date would fall into this category. Note that even thought " +"<link linkend=\"mapping-declaration-version\">version</link> and <link " +"linkend=\"mapping-declaration-timestamp\">timestamp</link> properties can be " +"marked as generated, this option is not available there..." msgstr "" +"<literal>insert</literal> - states that the given property value is " +"generated on insert, but is not regenerated on subsequent updates. Things " +"like created-date would fall into this category. Note that even thought " +"<xref linkend=\"mapping-declaration-version\">version</xref> and <xref " +"linkend=\"mapping-declaration-timestamp\">timestamp</xref> properties can be " +"marked as generated, this option is not available there..." -#: index.docbook:2900 -msgid "<literal>always</literal> - states that the property value is generated both on insert and on update." +#. Tag: para +#: basic_mapping.xml:2900 +#, no-c-format +msgid "" +"<literal>always</literal> - states that the property value is generated both " +"on insert and on update." msgstr "" +"<literal>always</literal> - states that the property value is generated both " +"on insert and on update." -#: index.docbook:2907 +#. Tag: title +#: basic_mapping.xml:2907 +#, no-c-format msgid "Auxiliary Database Objects" -msgstr "" +msgstr "Auxiliary Database Objects" -#: index.docbook:2908 -msgid "Allows CREATE and DROP of arbitrary database objects, in conjunction with Hibernate's schema evolution tools, to provide the ability to fully define a user schema within the Hibernate mapping files. Although designed specifically for creating and dropping things like triggers or stored procedures, really any SQL command that can be run via a <literal>java.sql.Statement.execute()</literal> method is valid here (ALTERs, INSERTS, etc). There are essentially two modes for defining auxiliary database objects..." +#. Tag: para +#: basic_mapping.xml:2908 +#, no-c-format +msgid "" +"Allows CREATE and DROP of arbitrary database objects, in conjunction with " +"Hibernate's schema evolution tools, to provide the ability to fully define a " +"user schema within the Hibernate mapping files. Although designed " +"specifically for creating and dropping things like triggers or stored " +"procedures, really any SQL command that can be run via a <literal>java.sql." +"Statement.execute()</literal> method is valid here (ALTERs, INSERTS, etc). " +"There are essentially two modes for defining auxiliary database objects..." msgstr "" +"Allows CREATE and DROP of arbitrary database objects, in conjunction with " +"Hibernate's schema evolution tools, to provide the ability to fully define a " +"user schema within the Hibernate mapping files. Although designed " +"specifically for creating and dropping things like triggers or stored " +"procedures, really any SQL command that can be run via a <literal>java.sql." +"Statement.execute()</literal> method is valid here (ALTERs, INSERTS, etc). " +"There are essentially two modes for defining auxiliary database objects..." -#: index.docbook:2917 -msgid "The first mode is to explicitly list the CREATE and DROP commands out in the mapping file:" +#. Tag: para +#: basic_mapping.xml:2917 +#, no-c-format +msgid "" +"The first mode is to explicitly list the CREATE and DROP commands out in the " +"mapping file:" msgstr "" +"The first mode is to explicitly list the CREATE and DROP commands out in the " +"mapping file:" -#: index.docbook:2921 +#. Tag: programlisting +#: basic_mapping.xml:2921 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - " ...\n" - " <database-object>\n" - " <create>CREATE TRIGGER my_trigger ...</create>\n" - " <drop>DROP TRIGGER my_trigger</drop>\n" - " </database-object>\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +" ...\n" +" <database-object>\n" +" <create>CREATE TRIGGER my_trigger ...</create>\n" +" <drop>DROP TRIGGER my_trigger</drop>\n" +" </database-object>\n" +"</hibernate-mapping>]]>" msgstr "" -#: index.docbook:2922 -msgid "The second mode is to supply a custom class which knows how to construct the CREATE and DROP commands. This custom class must implement the <literal>org.hibernate.mapping.AuxiliaryDatabaseObject</literal> interface." +#. Tag: para +#: basic_mapping.xml:2922 +#, no-c-format +msgid "" +"The second mode is to supply a custom class which knows how to construct the " +"CREATE and DROP commands. This custom class must implement the <literal>org." +"hibernate.mapping.AuxiliaryDatabaseObject</literal> interface." msgstr "" +"The second mode is to supply a custom class which knows how to construct the " +"CREATE and DROP commands. This custom class must implement the <literal>org." +"hibernate.mapping.AuxiliaryDatabaseObject</literal> interface." -#: index.docbook:2927 +#. Tag: programlisting +#: basic_mapping.xml:2927 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - " ...\n" - " <database-object>\n" - " <definition class=\"MyTriggerDefinition\"/>\n" - " </database-object>\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +" ...\n" +" <database-object>\n" +" <definition class=\"MyTriggerDefinition\"/>\n" +" </database-object>\n" +"</hibernate-mapping>]]>" msgstr "" -#: index.docbook:2928 -msgid "Additionally, these database objects can be optionally scoped such that they only apply when certain dialects are used." +#. Tag: para +#: basic_mapping.xml:2928 +#, no-c-format +msgid "" +"Additionally, these database objects can be optionally scoped such that they " +"only apply when certain dialects are used." msgstr "" +"Additionally, these database objects can be optionally scoped such that they " +"only apply when certain dialects are used." -#: index.docbook:2932 +#. Tag: programlisting +#: basic_mapping.xml:2932 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - " ...\n" - " <database-object>\n" - " <definition class=\"MyTriggerDefinition\"/>\n" - " <dialect-scope name=\"org.hibernate.dialect.Oracle9Dialect\"/>\n" - " <dialect-scope name=\"org.hibernate.dialect.OracleDialect\"/>\n" - " </database-object>\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +" ...\n" +" <database-object>\n" +" <definition class=\"MyTriggerDefinition\"/>\n" +" <dialect-scope name=\"org.hibernate.dialect.Oracle9Dialect\"/>\n" +" <dialect-scope name=\"org.hibernate.dialect.OracleDialect\"/>\n" +" </database-object>\n" +"</hibernate-mapping>]]>" msgstr "" -msgid "ROLES_OF_TRANSLATORS" -msgstr "" +#~ msgid "class" +#~ msgstr "class" -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "" +#~ msgid "id" +#~ msgstr "id" +#~ msgid "" +#~ "<literal>optimizer</literal> (optional, defaults to <literal>none</" +#~ "literal>): See <xref linkend=\"mapping-declaration-id-enhanced-optimizers" +#~ "\"/>" +#~ msgstr "" +#~ "<literal>optimizer</literal> (optional, defaults to <literal>none</" +#~ "literal>): See <xref linkend=\"mapping-declaration-id-enhanced-optimizers" +#~ "\"/>" + +#~ msgid "" +#~ "<literal>optimizer</literal> (optional, defaults to <literal/>): See " +#~ "<xref linkend=\"mapping-declaration-id-enhanced-optimizers\"/>" +#~ msgstr "" +#~ "<literal>optimizer</literal> (optional, defaults to <literal/>): See " +#~ "<xref linkend=\"mapping-declaration-id-enhanced-optimizers\"/>" + +#~ msgid "key" +#~ msgstr "key" + +#~ msgid "any" +#~ msgstr "any" Modified: core/trunk/documentation/manual/translations/pt-BR/content/batch.po =================================================================== --- core/trunk/documentation/manual/translations/pt-BR/content/batch.po 2007-10-25 22:34:46 UTC (rev 14134) +++ core/trunk/documentation/manual/translations/pt-BR/content/batch.po 2007-10-26 00:46:38 UTC (rev 14135) @@ -1,281 +1,650 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: batch.xml:5 +#, no-c-format msgid "Batch processing" -msgstr "" +msgstr "Processamento de lotes" -#: index.docbook:7 -msgid "A naive approach to inserting 100 000 rows in the database using Hibernate might look like this:" +#. Tag: para +#: batch.xml:7 +#, no-c-format +msgid "" +"A naive approach to inserting 100 000 rows in the database using Hibernate " +"might look like this:" msgstr "" +"Uma alternativa para inserir 100.000 linhas no banco de dados usando o " +"Hibernate pode ser a seguinte:" -#: index.docbook:12 +#. Tag: programlisting +#: batch.xml:12 +#, no-c-format msgid "" - "<![CDATA[Session session = sessionFactory.openSession();\n" - "Transaction tx = session.beginTransaction();\n" - "for ( int i=0; i<100000; i++ ) {\n" - " Customer customer = new Customer(.....);\n" - " session.save(customer);\n" - "}\n" - "tx.commit();\n" - "session.close();]]>" +"<![CDATA[Session session = sessionFactory.openSession();\n" +"Transaction tx = session.beginTransaction();\n" +"for ( int i=0; i<100000; i++ ) {\n" +" Customer customer = new Customer(.....);\n" +" session.save(customer);\n" +"}\n" +"tx.commit();\n" +"session.close();]]>" msgstr "" -#: index.docbook:14 -msgid "This would fall over with an <literal>OutOfMemoryException</literal> somewhere around the 50 000th row. That's because Hibernate caches all the newly inserted <literal>Customer</literal> instances in the session-level cache." +#. Tag: para +#: batch.xml:14 +#, no-c-format +msgid "" +"This would fall over with an <literal>OutOfMemoryException</literal> " +"somewhere around the 50 000th row. That's because Hibernate caches all the " +"newly inserted <literal>Customer</literal> instances in the session-level " +"cache." msgstr "" +"Isto irá falhar em algum lugar próximo a linha 50.000, lançando uma " +"<literal>OutOfMemoryException</literal>. Isso ocorre devido ao fato do " +"Hibernate fazer cache de todas as instâncias de <literal>Customer</literal> " +"inseridas num cachê em nível de sessão." -#: index.docbook:20 -msgid "In this chapter we'll show you how to avoid this problem. First, however, if you are doing batch processing, it is absolutely critical that you enable the use of JDBC batching, if you intend to achieve reasonable performance. Set the JDBC batch size to a reasonable number (say, 10-50):" +#. Tag: para +#: batch.xml:20 +#, no-c-format +msgid "" +"In this chapter we'll show you how to avoid this problem. First, however, if " +"you are doing batch processing, it is absolutely critical that you enable " +"the use of JDBC batching, if you intend to achieve reasonable performance. " +"Set the JDBC batch size to a reasonable number (say, 10-50):" msgstr "" +"Neste capítulo veremos como contornar esse problema. Entretanto, se você vai " +"realizar processamento de lotes, é muito importante que você habilite o uso " +"de lotes JDBC, se você pretende obter um desempenho razoável. Defina o " +"tamanho do lote JDBC em um valor razoável (algo entre 10-50):" -#: index.docbook:27 +#. Tag: programlisting +#: batch.xml:27 +#, no-c-format msgid "<![CDATA[hibernate.jdbc.batch_size 20]]>" msgstr "" -#: index.docbook:29 -msgid "Note that Hibernate disables insert batching at the JDBC level transparently if you use an <literal>identiy</literal> identifier generator." +#. Tag: para +#: batch.xml:29 +#, no-c-format +msgid "" +"Note that Hibernate disables insert batching at the JDBC level transparently " +"if you use an <literal>identiy</literal> identifier generator." msgstr "" +"Você também pode querer rodar esse tipo de processamento de lotes com o " +"cache secundário completamente desabilitado:" -#: index.docbook:34 -msgid "You also might like to do this kind of work in a process where interaction with the second-level cache is completely disabled:" +#. Tag: para +#: batch.xml:34 +#, no-c-format +msgid "" +"You also might like to do this kind of work in a process where interaction " +"with the second-level cache is completely disabled:" msgstr "" +"Note that Hibernate disables insert batching at the JDBC level transparently " +"if you use an <literal>identiy</literal> identifier generator." -#: index.docbook:39 +#. Tag: programlisting +#: batch.xml:39 +#, no-c-format msgid "<![CDATA[hibernate.cache.use_second_level_cache false]]>" msgstr "" -#: index.docbook:41 -msgid "However, this is not absolutely necessary, since we can explicitly set the <literal>CacheMode</literal> to disable interaction with the second-level cache." +#. Tag: para +#: batch.xml:41 +#, no-c-format +msgid "" +"However, this is not absolutely necessary, since we can explicitly set the " +"<literal>CacheMode</literal> to disable interaction with the second-level " +"cache." msgstr "" +"Mas isto não é absolutamente necessário, desde que nós possamos ajustar o " +"<literal>CacheMode</literal> para desabilitar a interação com o cache " +"secundário." -#: index.docbook:47 +#. Tag: title +#: batch.xml:47 +#, no-c-format msgid "Batch inserts" -msgstr "" +msgstr "Inserção de lotes" -#: index.docbook:49 -msgid "When making new objects persistent, you must <literal>flush()</literal> and then <literal>clear()</literal> the session regularly, to control the size of the first-level cache." +#. Tag: para +#: batch.xml:49 +#, no-c-format +msgid "" +"When making new objects persistent, you must <literal>flush()</literal> and " +"then <literal>clear()</literal> the session regularly, to control the size " +"of the first-level cache." msgstr "" +"Quando você estiver inserindo novos objetos persistentes, vocês deve " +"executar os métodos <literal>flush()</literal> e <literal>clear()</literal> " +"regularmente na sessão, para controlar o tamanho do cache primário." -#: index.docbook:55 +#. Tag: programlisting +#: batch.xml:55 +#, no-c-format msgid "" - "<![CDATA[Session session = sessionFactory.openSession();\n" - "Transaction tx = session.beginTransaction();\n" - " \n" - "for ( int i=0; i<100000; i++ ) {\n" - " Customer customer = new Customer(.....);\n" - " session.save(customer);\n" - " if ( i % 20 == 0 ) { //20, same as the JDBC batch size\n" - " //flush a batch of inserts and release memory:\n" - " session.flush();\n" - " session.clear();\n" - " }\n" - "}\n" - " \n" - "tx.commit();\n" - "session.close();]]>" +"<![CDATA[Session session = sessionFactory.openSession();\n" +"Transaction tx = session.beginTransaction();\n" +" \n" +"for ( int i=0; i<100000; i++ ) {\n" +" Customer customer = new Customer(.....);\n" +" session.save(customer);\n" +" if ( i % 20 == 0 ) { //20, same as the JDBC batch size\n" +" //flush a batch of inserts and release memory:\n" +" session.flush();\n" +" session.clear();\n" +" }\n" +"}\n" +" \n" +"tx.commit();\n" +"session.close();]]>" msgstr "" -#: index.docbook:60 +#. Tag: title +#: batch.xml:60 +#, no-c-format msgid "Batch updates" -msgstr "" +msgstr "Batch updates" -#: index.docbook:62 -msgid "For retrieving and updating data the same ideas apply. In addition, you need to use <literal>scroll()</literal> to take advantage of server-side cursors for queries that return many rows of data." +#. Tag: para +#: batch.xml:62 +#, no-c-format +msgid "" +"For retrieving and updating data the same ideas apply. In addition, you need " +"to use <literal>scroll()</literal> to take advantage of server-side cursors " +"for queries that return many rows of data." msgstr "" +"Para recuperar e atualizar informações a mesma idéia é válida. " +"Adicionalmente, pode precisar usar o <literal>scroll()</literal> para usar " +"recursos no lado do servidor em queries que retornam muita informação." -#: index.docbook:68 +#. Tag: programlisting +#: batch.xml:68 +#, no-c-format msgid "" - "<![CDATA[Session session = sessionFactory.openSession();\n" - "Transaction tx = session.beginTransaction();\n" - " \n" - "ScrollableResults customers = session.getNamedQuery(\"GetCustomers\")\n" - " .setCacheMode(CacheMode.IGNORE)\n" - " .scroll(ScrollMode.FORWARD_ONLY);\n" - "int count=0;\n" - "while ( customers.next() ) {\n" - " Customer customer = (Customer) customers.get(0);\n" - " customer.updateStuff(...);\n" - " if ( ++count % 20 == 0 ) {\n" - " //flush a batch of updates and release memory:\n" - " session.flush();\n" - " session.clear();\n" - " }\n" - "}\n" - " \n" - "tx.commit();\n" - "session.close();]]>" +"<![CDATA[Session session = sessionFactory.openSession();\n" +"Transaction tx = session.beginTransaction();\n" +" \n" +"ScrollableResults customers = session.getNamedQuery(\"GetCustomers\")\n" +" .setCacheMode(CacheMode.IGNORE)\n" +" .scroll(ScrollMode.FORWARD_ONLY);\n" +"int count=0;\n" +"while ( customers.next() ) {\n" +" Customer customer = (Customer) customers.get(0);\n" +" customer.updateStuff(...);\n" +" if ( ++count % 20 == 0 ) {\n" +" //flush a batch of updates and release memory:\n" +" session.flush();\n" +" session.clear();\n" +" }\n" +"}\n" +" \n" +"tx.commit();\n" +"session.close();]]>" msgstr "" -#: index.docbook:73 +#. Tag: title +#: batch.xml:73 +#, no-c-format msgid "The StatelessSession interface" -msgstr "" +msgstr "A interface StatelessSession" -#: index.docbook:74 -msgid "Alternatively, Hibernate provides a command-oriented API that may be used for streaming data to and from the database in the form of detached objects. A <literal>StatelessSession</literal> has no persistence context associated with it and does not provide many of the higher-level life cycle semantics. In particular, a stateless session does not implement a first-level cache nor interact with any second-level or query cache. It does not implement transactional write-behind or automatic dirty checking. Operations performed using a stateless session do not ever cascade to associated instances. Collections are ignored by a stateless session. Operations performed via a stateless session bypass Hibernate's event model and interceptors. Stateless sessions are vulnerable to data aliasing effects, due to the lack of a first-level cache. A stateless session is a lower-level abstraction, much closer to the underlying JDBC." +#. Tag: para +#: batch.xml:74 +#, no-c-format +msgid "" +"Alternatively, Hibernate provides a command-oriented API that may be used " +"for streaming data to and from the database in the form of detached objects. " +"A <literal>StatelessSession</literal> has no persistence context associated " +"with it and does not provide many of the higher-level life cycle semantics. " +"In particular, a stateless session does not implement a first-level cache " +"nor interact with any second-level or query cache. It does not implement " +"transactional write-behind or automatic dirty checking. Operations performed " +"using a stateless session do not ever cascade to associated instances. " +"Collections are ignored by a stateless session. Operations performed via a " +"stateless session bypass Hibernate's event model and interceptors. Stateless " +"sessions are vulnerable to data aliasing effects, due to the lack of a first-" +"level cache. A stateless session is a lower-level abstraction, much closer " +"to the underlying JDBC." msgstr "" +"Alternativamente, o Hibernate provê uma API orientada à comandos, usada para " +"transmitir um fluxo de dados de e para o banco de dados na forma de objetos " +"soltos. Uma <literal>StatelessSession</literal> não tem um contexto " +"persistente associado e não fornece muito das semânticas de alto nível para " +"controle do ciclo de vida. Em especial, uma StatelessSession não implemente " +"o cache primário e nem interage com o cache secundário ou query cache. Ele " +"não implementa salvamento transacional automatico ou checagem automática de " +"mudanças. Operação realizadas usando uma StatelessSession não fazem nenhum " +"tipo de cascade com as instancias associadas. As coleções são ignoradas por " +"uma StatelessSession. Operações realizadas com um StatelessSession ignoram a " +"arquitetura de eventos e os interceptadores. StatelessSession são " +"vulneráveis aos efeitos do aliasing dos dados, devido a falta do cache " +"primário. Uma StatelessSession é uma abstração de baixo nível, muito mais " +"próxima do JDBC." -#: index.docbook:89 +#. Tag: programlisting +#: batch.xml:89 +#, no-c-format msgid "" - "<![CDATA[StatelessSession session = sessionFactory.openStatelessSession();\n" - "Transaction tx = session.beginTransaction();\n" - " \n" - "ScrollableResults customers = session.getNamedQuery(\"GetCustomers\")\n" - " .scroll(ScrollMode.FORWARD_ONLY);\n" - "while ( customers.next() ) {\n" - " Customer customer = (Customer) customers.get(0);\n" - " customer.updateStuff(...);\n" - " session.update(customer);\n" - "}\n" - " \n" - "tx.commit();\n" - "session.close();]]>" +"<![CDATA[StatelessSession session = sessionFactory.openStatelessSession();\n" +"Transaction tx = session.beginTransaction();\n" +" \n" +"ScrollableResults customers = session.getNamedQuery(\"GetCustomers\")\n" +" .scroll(ScrollMode.FORWARD_ONLY);\n" +"while ( customers.next() ) {\n" +" Customer customer = (Customer) customers.get(0);\n" +" customer.updateStuff(...);\n" +" session.update(customer);\n" +"}\n" +" \n" +"tx.commit();\n" +"session.close();]]>" msgstr "" -#: index.docbook:91 -msgid "Note that in this code example, the <literal>Customer</literal> instances returned by the query are immediately detached. They are never associated with any persistence context." +#. Tag: para +#: batch.xml:91 +#, no-c-format +msgid "" +"Note that in this code example, the <literal>Customer</literal> instances " +"returned by the query are immediately detached. They are never associated " +"with any persistence context." msgstr "" +"Veja neste exempo, as instancias de <literal>Customer</literal> retornadas " +"pela query são imediatamente desvinculadas. Elas nunca serão assossiadas à " +"um contexto persistente." -#: index.docbook:97 -msgid "The <literal>insert(), update()</literal> and <literal>delete()</literal> operations defined by the <literal>StatelessSession</literal> interface are considered to be direct database row-level operations, which result in immediate execution of a SQL <literal>INSERT, UPDATE</literal> or <literal>DELETE</literal> respectively. Thus, they have very different semantics to the <literal>save(), saveOrUpdate()</literal> and <literal>delete()</literal> operations defined by the <literal>Session</literal> interface." +#. Tag: para +#: batch.xml:97 +#, no-c-format +msgid "" +"The <literal>insert(), update()</literal> and <literal>delete()</literal> " +"operations defined by the <literal>StatelessSession</literal> interface are " +"considered to be direct database row-level operations, which result in " +"immediate execution of a SQL <literal>INSERT, UPDATE</literal> or " +"<literal>DELETE</literal> respectively. Thus, they have very different " +"semantics to the <literal>save(), saveOrUpdate()</literal> and " +"<literal>delete()</literal> operations defined by the <literal>Session</" +"literal> interface." msgstr "" +"As operações <literal>insert(), update()</literal> e <literal>delete()</" +"literal> definidos pela interface <literal>StatelessSession</literal> são " +"considerados operações diretas no banco de dados (row-level operations), " +"isso resulta em uma execução imediata de comandos SQL <literal>INSERT, " +"UPDATE</literal> ou <literal>DELETE</literal> respectivamente. Devido a " +"isso, eles possuem uma semântica bem diferente das operações <literal>save" +"(), saveOrUpdate()</literal> ou <literal>delete()</literal> definidas na " +"interface <literal>Session</literal>." -#: index.docbook:110 +#. Tag: title +#: batch.xml:110 +#, no-c-format msgid "DML-style operations" -msgstr "" +msgstr "Operações no estilo DML" -#: index.docbook:112 -msgid "As already discussed, automatic and transparent object/relational mapping is concerned with the management of object state. This implies that the object state is available in memory, hence manipulating (using the SQL <literal>Data Manipulation Language</literal> (DML) statements: <literal>INSERT</literal>, <literal>UPDATE</literal>, <literal>DELETE</literal>) data directly in the database will not affect in-memory state. However, Hibernate provides methods for bulk SQL-style DML statement execution which are performed through the Hibernate Query Language (<xref linkend=\"queryhql\"/>HQL)." +#. Tag: para +#: batch.xml:112 +#, no-c-format +msgid "" +"As already discussed, automatic and transparent object/relational mapping is " +"concerned with the management of object state. This implies that the object " +"state is available in memory, hence manipulating (using the SQL " +"<literal>Data Manipulation Language</literal> (DML) statements: " +"<literal>INSERT</literal>, <literal>UPDATE</literal>, <literal>DELETE</" +"literal>) data directly in the database will not affect in-memory state. " +"However, Hibernate provides methods for bulk SQL-style DML statement " +"execution which are performed through the Hibernate Query Language (<link " +"linkend=\"queryhql\">HQL</link>)." msgstr "" +"Como já discutido, mapeamento objeto/relacional automático e transparente é " +"conseguido com a gerência do estado do objeto. Com isto o estado daquele " +"objeto fica disponível na memória, manipulando(usando as expressões SQL " +"<literal>Data Manipulation Language</literal> (SQL-style DML): " +"<literal>INSERT</literal>, <literal>UPDATE</literal>, <literal>DELETE</" +"literal>) os dados diretamente no banco de dados não irá afetar o estado " +"registrado em memória. Entretanto, o Hibernate provê métodos para executar " +"queries SQL-style DML, que são totalmente executas com HQL (Hibernate Query " +"Language) (<xref linkend=\"queryhql\">HQL</xref>)." -#: index.docbook:122 -msgid "The pseudo-syntax for <literal>UPDATE</literal> and <literal>DELETE</literal> statements is: <literal>( UPDATE | DELETE ) FROM? EntityName (WHERE where_conditions)?</literal>. Some points to note:" +#. Tag: para +#: batch.xml:122 +#, no-c-format +msgid "" +"The pseudo-syntax for <literal>UPDATE</literal> and <literal>DELETE</" +"literal> statements is: <literal>( UPDATE | DELETE ) FROM? EntityName (WHERE " +"where_conditions)?</literal>. Some points to note:" msgstr "" +"A pseudo-sintaxe para expressões <literal>UPDATE</literal> e " +"<literal>DELETE</literal> é: <literal>( UPDATE | DELETE ) FROM? NomeEntidade " +"(WHERE condições_where)?</literal>. Algumas observações:" -#: index.docbook:130 +#. Tag: para +#: batch.xml:130 +#, no-c-format msgid "In the from-clause, the FROM keyword is optional" -msgstr "" +msgstr "Na clausula from, a palavra chave FROM é opcional;" -#: index.docbook:135 -msgid "There can only be a single entity named in the from-clause; it can optionally be aliased. If the entity name is aliased, then any property references must be qualified using that alias; if the entity name is not aliased, then it is illegal for any property references to be qualified." +#. Tag: para +#: batch.xml:135 +#, no-c-format +msgid "" +"There can only be a single entity named in the from-clause; it can " +"optionally be aliased. If the entity name is aliased, then any property " +"references must be qualified using that alias; if the entity name is not " +"aliased, then it is illegal for any property references to be qualified." msgstr "" +"Somente uma entidade pode ser chamada na clausula from; opcionalmente pode " +"ter um alias. Se o nome da entidade for possuir um alias, então qualquer " +"propriedade referenciada deve usar esse alias qualificado; se o nome da " +"entidade não possuir um alias, então nenhuma das propriedade precisa usar o " +"acesso qualificado." -#: index.docbook:143 -msgid "No <xref linkend=\"queryhql-joins-forms\"/>joins (either implicit or explicit) can be specified in a bulk HQL query. Sub-queries may be used in the where-clause; the subqueries, themselves, may contain joins." +#. Tag: para +#: batch.xml:143 +#, no-c-format +msgid "" +"No <link linkend=\"queryhql-joins-forms\">joins</link> (either implicit or " +"explicit) can be specified in a bulk HQL query. Sub-queries may be used in " +"the where-clause; the subqueries, themselves, may contain joins." msgstr "" +"Na <xref linkend=\"queryhql-joins-forms\">joins</xref> (ambas implícita ou " +"explicita) pode ser especificada em um bulk HQL query. Sub-queries podem ser " +"usadas na clausula where; as subqueries podem conter joins." -#: index.docbook:150 +#. Tag: para +#: batch.xml:150 +#, no-c-format msgid "The where-clause is also optional." -msgstr "" +msgstr "A clausula where também é opcional." -#: index.docbook:156 -msgid "As an example, to execute an HQL <literal>UPDATE</literal>, use the <literal>Query.executeUpdate()</literal> method (the method is named for those familiar with JDBC's <literal>PreparedStatement.executeUpdate()</literal>):" +#. Tag: para +#: batch.xml:156 +#, no-c-format +msgid "" +"As an example, to execute an HQL <literal>UPDATE</literal>, use the " +"<literal>Query.executeUpdate()</literal> method (the method is named for " +"those familiar with JDBC's <literal>PreparedStatement.executeUpdate()</" +"literal>):" msgstr "" +"Como exemplo para executar um HQL <literal>UPDATE</literal>, use o método " +"<literal>Query.executeUpdate()</literal>(o método ganhou o nome devido a sua " +"familiaridade com o do JDBC <literal>PreparedStatement.executeUpdate()</" +"literal>):" -#: index.docbook:162 +#. Tag: programlisting +#: batch.xml:162 +#, no-c-format msgid "" - "<![CDATA[Session session = sessionFactory.openSession();\n" - "Transaction tx = session.beginTransaction();\n" - "\n" - "String hqlUpdate = \"update Customer c set c.name = :newName where c.name = :oldName\";\n" - "// or String hqlUpdate = \"update Customer set name = :newName where name = :oldName\";\n" - "int updatedEntities = s.createQuery( hqlUpdate )\n" - " .setString( \"newName\", newName )\n" - " .setString( \"oldName\", oldName )\n" - " .executeUpdate();\n" - "tx.commit();\n" - "session.close();]]>" +"<![CDATA[Session session = sessionFactory.openSession();\n" +"Transaction tx = session.beginTransaction();\n" +"\n" +"String hqlUpdate = \"update Customer c set c.name = :newName where c.name = :" +"oldName\";\n" +"// or String hqlUpdate = \"update Customer set name = :newName where name = :" +"oldName\";\n" +"int updatedEntities = s.createQuery( hqlUpdate )\n" +" .setString( \"newName\", newName )\n" +" .setString( \"oldName\", oldName )\n" +" .executeUpdate();\n" +"tx.commit();\n" +"session.close();]]>" msgstr "" -#: index.docbook:164 -msgid "HQL <literal>UPDATE</literal> statements, by default do not effect the <xref linkend=\"mapping-declaration-version\"/>version or the <xref linkend=\"mapping-declaration-timestamp\"/>timestamp property values for the affected entities; this is in keeping with the EJB3 specification. However, you can force Hibernate to properly reset the <literal>version</literal> or <literal>timestamp</literal> property values through the use of a <literal>versioned update</literal>. This is achieved by adding the <literal>VERSIONED</literal> keyword after the <literal>UPDATE</literal> keyword." +#. Tag: para +#: batch.xml:164 +#, no-c-format +msgid "" +"HQL <literal>UPDATE</literal> statements, by default do not effect the <link " +"linkend=\"mapping-declaration-version\">version</link> or the <link linkend=" +"\"mapping-declaration-timestamp\">timestamp</link> property values for the " +"affected entities; this is in keeping with the EJB3 specification. However, " +"you can force Hibernate to properly reset the <literal>version</literal> or " +"<literal>timestamp</literal> property values through the use of a " +"<literal>versioned update</literal>. This is achieved by adding the " +"<literal>VERSIONED</literal> keyword after the <literal>UPDATE</literal> " +"keyword." msgstr "" +"HQL <literal>UPDATE</literal> statements, by default do not effect the <xref " +"linkend=\"mapping-declaration-version\">version</xref> or the <xref linkend=" +"\"mapping-declaration-timestamp\">timestamp</xref> property values for the " +"affected entities; this is in keeping with the EJB3 specification. However, " +"you can force Hibernate to properly reset the <literal>version</literal> or " +"<literal>timestamp</literal> property values through the use of a " +"<literal>versioned update</literal>. This is achieved by adding the " +"<literal>VERSIONED</literal> keyword after the <literal>UPDATE</literal> " +"keyword." -#: index.docbook:174 +#. Tag: programlisting +#: batch.xml:174 +#, no-c-format msgid "" - "<![CDATA[Session session = sessionFactory.openSession();\n" - "Transaction tx = session.beginTransaction();\n" - "String hqlVersionedUpdate = \"update versioned Customer set name = :newName where name = :oldName\";\n" - "int updatedEntities = s.createQuery( hqlUpdate )\n" - " .setString( \"newName\", newName )\n" - " .setString( \"oldName\", oldName )\n" - " .executeUpdate();\n" - "tx.commit();\n" - "session.close();]]>" +"<![CDATA[Session session = sessionFactory.openSession();\n" +"Transaction tx = session.beginTransaction();\n" +"String hqlVersionedUpdate = \"update versioned Customer set name = :newName " +"where name = :oldName\";\n" +"int updatedEntities = s.createQuery( hqlUpdate )\n" +" .setString( \"newName\", newName )\n" +" .setString( \"oldName\", oldName )\n" +" .executeUpdate();\n" +"tx.commit();\n" +"session.close();]]>" msgstr "" -#: index.docbook:176 -msgid "Note that custom version types (<literal>org.hibernate.usertype.UserVersionType</literal>) are not allowed in conjunction with a <literal>update versioned</literal> statement." +#. Tag: para +#: batch.xml:176 +#, no-c-format +msgid "" +"Note that custom version types (<literal>org.hibernate.usertype." +"UserVersionType</literal>) are not allowed in conjunction with a " +"<literal>update versioned</literal> statement." msgstr "" +"Note that custom version types (<literal>org.hibernate.usertype." +"UserVersionType</literal>) are not allowed in conjunction with a " +"<literal>update versioned</literal> statement." -#: index.docbook:181 -msgid "To execute an HQL <literal>DELETE</literal>, use the same <literal>Query.executeUpdate()</literal> method:" +#. Tag: para +#: batch.xml:181 +#, no-c-format +msgid "" +"To execute an HQL <literal>DELETE</literal>, use the same <literal>Query." +"executeUpdate()</literal> method:" msgstr "" +"Para executar um HQL <literal>DELETE</literal>, use o mesmo método " +"<literal>Query.executeUpdate()</literal>:" -#: index.docbook:186 +#. Tag: programlisting +#: batch.xml:186 +#, no-c-format msgid "" - "<![CDATA[Session session = sessionFactory.openSession();\n" - "Transaction tx = session.beginTransaction();\n" - "\n" - "String hqlDelete = \"delete Customer c where c.name = :oldName\";\n" - "// or String hqlDelete = \"delete Customer where name = :oldName\";\n" - "int deletedEntities = s.createQuery( hqlDelete )\n" - " .setString( \"oldName\", oldName )\n" - " .executeUpdate();\n" - "tx.commit();\n" - "session.close();]]>" +"<![CDATA[Session session = sessionFactory.openSession();\n" +"Transaction tx = session.beginTransaction();\n" +"\n" +"String hqlDelete = \"delete Customer c where c.name = :oldName\";\n" +"// or String hqlDelete = \"delete Customer where name = :oldName\";\n" +"int deletedEntities = s.createQuery( hqlDelete )\n" +" .setString( \"oldName\", oldName )\n" +" .executeUpdate();\n" +"tx.commit();\n" +"session.close();]]>" msgstr "" -#: index.docbook:188 -msgid "The <literal>int</literal> value returned by the <literal>Query.executeUpdate()</literal> method indicate the number of entities effected by the operation. Consider this may or may not correlate to the number of rows effected in the database. An HQL bulk operation might result in multiple actual SQL statements being executed, for joined-subclass, for example. The returned number indicates the number of actual entities affected by the statement. Going back to the example of joined-subclass, a delete against one of the subclasses may actually result in deletes against not just the table to which that subclass is mapped, but also the \"root\" table and potentially joined-subclass tables further down the inheritence hierarchy." +#. Tag: para +#: batch.xml:188 +#, no-c-format +msgid "" +"The <literal>int</literal> value returned by the <literal>Query.executeUpdate" +"()</literal> method indicate the number of entities effected by the " +"operation. Consider this may or may not correlate to the number of rows " +"effected in the database. An HQL bulk operation might result in multiple " +"actual SQL statements being executed, for joined-subclass, for example. The " +"returned number indicates the number of actual entities affected by the " +"statement. Going back to the example of joined-subclass, a delete against " +"one of the subclasses may actually result in deletes against not just the " +"table to which that subclass is mapped, but also the \"root\" table and " +"potentially joined-subclass tables further down the inheritence hierarchy." msgstr "" +"O valor <literal>int</literal> retornado pelo método <literal>Query." +"executeUpdate()</literal> indica o numero de entidade afetadas pela " +"operação. Lembre-se que isso pode estar ou não relacionado ao número de " +"linhas alteradas no banco de dados. Uma operação bulk HQL pode resultar em " +"várias expressões SQL reais a serem executadas, por exemplo, no caso de " +"joined-subclass. O número retornado indica a quantidade real de entidades " +"afetadas pela expressão. Voltando ao exemplo da joined-subclass, a exclusão " +"de uma das subclasses pode resultar numa exclusão em outra tabelas, não " +"apenas na tabela para qual a subclasses está mapeada, mas também tabela " +"\"root\" e possivelmente nas tabelas joined-subclass num nível hierárquico " +"imediatamente abaixo." -#: index.docbook:199 -msgid "The pseudo-syntax for <literal>INSERT</literal> statements is: <literal>INSERT INTO EntityName properties_list select_statement</literal>. Some points to note:" +#. Tag: para +#: batch.xml:199 +#, no-c-format +msgid "" +"The pseudo-syntax for <literal>INSERT</literal> statements is: " +"<literal>INSERT INTO EntityName properties_list select_statement</literal>. " +"Some points to note:" msgstr "" +"A pseudo-sintaxe para o comando <literal>INSERT</literal> é: <literal>INSERT " +"INTO EntityName properties_list select_statement</literal>. Alguns pontos a " +"observar:" -#: index.docbook:207 -msgid "Only the INSERT INTO ... SELECT ... form is supported; not the INSERT INTO ... VALUES ... form." +#. Tag: para +#: batch.xml:207 +#, no-c-format +msgid "" +"Only the INSERT INTO ... SELECT ... form is supported; not the INSERT " +"INTO ... VALUES ... form." msgstr "" +"Apenas a forma INSERT INTO ... SELECT ... é suportada; INSERT INTO ... " +"VALUES ... não é suportada." -#: index.docbook:210 -msgid "The properties_list is analogous to the <literal>column speficiation</literal> in the SQL <literal>INSERT</literal> statement. For entities involved in mapped inheritence, only properties directly defined on that given class-level can be used in the properties_list. Superclass properties are not allowed; and subclass properties do not make sense. In other words, <literal>INSERT</literal> statements are inherently non-polymorphic." +#. Tag: para +#: batch.xml:210 +#, no-c-format +msgid "" +"The properties_list is analogous to the <literal>column speficiation</" +"literal> in the SQL <literal>INSERT</literal> statement. For entities " +"involved in mapped inheritence, only properties directly defined on that " +"given class-level can be used in the properties_list. Superclass properties " +"are not allowed; and subclass properties do not make sense. In other words, " +"<literal>INSERT</literal> statements are inherently non-polymorphic." msgstr "" +"A lista de propriedade é análoga à <literal>especificação da coluna</" +"literal> do comando SQL <literal>INSERT</literal>. Para entidades envolvidas " +"em mapeamentos, apenas a propriedades definidas diretamente a nível da " +"classe podem ser usandas na properties_list. Propriedades da superclass não " +"são permitidas; e as propriedades da subclasse não faz sentido. Em outras " +"palavras, os comandos <literal>INSERT</literal> não são polimorficos." -#: index.docbook:220 -msgid "select_statement can be any valid HQL select query, with the caveat that the return types must match the types expected by the insert. Currently, this is checked during query compilation rather than allowing the check to relegate to the database. Note however that this might cause problems between Hibernate <literal>Type</literal>s which are <emphasis>equivalent</emphasis> as opposed to <emphasis>equal</emphasis>. This might cause issues with mismatches between a property defined as a <literal>org.hibernate.type.DateType</literal> and a property defined as a <literal>org.hibernate.type.TimestampType</literal>, even though the database might not make a distinction or might be able to handle the conversion." +#. Tag: para +#: batch.xml:220 +#, no-c-format +msgid "" +"select_statement can be any valid HQL select query, with the caveat that the " +"return types must match the types expected by the insert. Currently, this is " +"checked during query compilation rather than allowing the check to relegate " +"to the database. Note however that this might cause problems between " +"Hibernate <literal>Type</literal>s which are <emphasis>equivalent</emphasis> " +"as opposed to <emphasis>equal</emphasis>. This might cause issues with " +"mismatches between a property defined as a <literal>org.hibernate.type." +"DateType</literal> and a property defined as a <literal>org.hibernate.type." +"TimestampType</literal>, even though the database might not make a " +"distinction or might be able to handle the conversion." msgstr "" +"O camando select pode ser qualquer query HQL válida, que tenha um retorno " +"compatível com o tipo com o esperado pela inclusão. Atualmente, isto é " +"verificado durante a compilação da query, isto é melhor do que permitir que " +"a verificação chegue ao banco de dados. Entretanto perceba que isso pode " +"causar problemas entre os <literal>Tipo</literal> do Hibernate que são " +"<emphasis>equivalentes</emphasis> em oposição a <emphasis>equal</emphasis>. " +"Isso pode causar problemas nas combinações entre a propriedade definida como " +"<literal>org.hibernate.type.DateType</literal>e um propriedade definida como " +"<literal>org.hibernate.type.TimestampType</literal>, embora o banco de dados " +"não possa fazer uma distinção ou possa ser capaz de manusear a conversão." -#: index.docbook:232 -msgid "For the id property, the insert statement gives you two options. You can either explicitly specify the id property in the properties_list (in which case its value is taken from the corresponding select expression) or omit it from the properties_list (in which case a generated value is used). This later option is only available when using id generators that operate in the database; attempting to use this option with any \"in memory\" type generators will cause an exception during parsing. Note that for the purposes of this discussion, in-database generators are considered to be <literal>org.hibernate.id.SequenceGenerator</literal> (and its subclasses) and any implementors of <literal>org.hibernate.id.PostInsertIdentifierGenerator</literal>. The most notable exception here is <literal>org.hibernate.id.TableHiLoGenerator</literal>, which cannot be used because it does not expose a selectable way to get its values." +#. Tag: para +#: batch.xml:232 +#, no-c-format +msgid "" +"For the id property, the insert statement gives you two options. You can " +"either explicitly specify the id property in the properties_list (in which " +"case its value is taken from the corresponding select expression) or omit it " +"from the properties_list (in which case a generated value is used). This " +"later option is only available when using id generators that operate in the " +"database; attempting to use this option with any \"in memory\" type " +"generators will cause an exception during parsing. Note that for the " +"purposes of this discussion, in-database generators are considered to be " +"<literal>org.hibernate.id.SequenceGenerator</literal> (and its subclasses) " +"and any implementors of <literal>org.hibernate.id." +"PostInsertIdentifierGenerator</literal>. The most notable exception here is " +"<literal>org.hibernate.id.TableHiLoGenerator</literal>, which cannot be used " +"because it does not expose a selectable way to get its values." msgstr "" +"Para a propriedade id, a expressão insert oferece duas opções. Você pode " +"especificar qualquer propriedade id explicitamente no properties_list (em " +"alguns casos esse valor é obtido diretamente da expressão select) ou pode " +"omitir do properties_list (nesse caso, um valor gerado é usado). Essa ultima " +"opção só é válida quando são usados geradores de ids que operam no banco de " +"dados; a tentativa de usar essa opção com geradores do tipo \"em memória\" " +"vai causar um exceção durante a etapa de parser. Veja a finalidades desta " +"discussão, os seguintes geradores operam com o banco de dados <literal>org." +"hibernate.id.SequenceGenerator</literal> (e suas subclasses) e qualquer " +"implementação de <literal>org.hibernate.id.PostInsertIdentifierGenerator</" +"literal>. Aqui, a exceção mais notável é o <literal>org.hibernate.id." +"TableHiLoGenerator</literal>, que não pode ser usado porque ele não dispõe " +"de mecanismos para recuperar o seu valor." -#: index.docbook:247 -msgid "For properties mapped as either <literal>version</literal> or <literal>timestamp</literal>, the insert statement gives you two options. You can either specify the property in the properties_list (in which case its value is taken from the corresponding select expressions) or omit it from the properties_list (in which case the <literal>seed value</literal> defined by the <literal>org.hibernate.type.VersionType</literal> is used)." +#. Tag: para +#: batch.xml:247 +#, no-c-format +msgid "" +"For properties mapped as either <literal>version</literal> or " +"<literal>timestamp</literal>, the insert statement gives you two options. " +"You can either specify the property in the properties_list (in which case " +"its value is taken from the corresponding select expressions) or omit it " +"from the properties_list (in which case the <literal>seed value</literal> " +"defined by the <literal>org.hibernate.type.VersionType</literal> is used)." msgstr "" +"For properties mapped as either <literal>version</literal> or " +"<literal>timestamp</literal>, the insert statement gives you two options. " +"You can either specify the property in the properties_list (in which case " +"its value is taken from the corresponding select expressions) or omit it " +"from the properties_list (in which case the <literal>seed value</literal> " +"defined by the <literal>org.hibernate.type.VersionType</literal> is used). " +"Para propriedades mapeadas como <literal>version</literal> ou " +"<literal>timestamp</literal>, a expressão insert oferece a você duas opções. " +"Você pode especificar a propriedade na properties_list (nesse caso o seu " +"valor é obtido a partir da expressão select correspondente) ou ele pode ser " +"omitido da properties_list (neste caso o usa o <literal>valor semente</" +"literal> definido pela classe <literal>org.hibernate.type.VersionType</" +"literal>)." -#: index.docbook:257 +#. Tag: para +#: batch.xml:257 +#, no-c-format msgid "An example HQL <literal>INSERT</literal> statement execution:" -msgstr "" +msgstr "Exemplo da execução de um HQL <literal>INSERT</literal>:" -#: index.docbook:261 +#. Tag: programlisting +#: batch.xml:261 +#, no-c-format msgid "" - "<![CDATA[Session session = sessionFactory.openSession();\n" - "Transaction tx = session.beginTransaction();\n" - "\n" - "String hqlInsert = \"insert into DelinquentAccount (id, name) select c.id, c.name from Customer c where ...\";\n" - "int createdEntities = s.createQuery( hqlInsert )\n" - " .executeUpdate();\n" - "tx.commit();\n" - "session.close();]]>" +"<![CDATA[Session session = sessionFactory.openSession();\n" +"Transaction tx = session.beginTransaction();\n" +"\n" +"String hqlInsert = \"insert into DelinquentAccount (id, name) select c.id, c." +"name from Customer c where ...\";\n" +"int createdEntities = s.createQuery( hqlInsert )\n" +" .executeUpdate();\n" +"tx.commit();\n" +"session.close();]]>" msgstr "" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "" - Modified: core/trunk/documentation/manual/translations/pt-BR/content/best_practices.po =================================================================== --- core/trunk/documentation/manual/translations/pt-BR/content/best_practices.po 2007-10-25 22:34:46 UTC (rev 14134) +++ core/trunk/documentation/manual/translations/pt-BR/content/best_practices.po 2007-10-26 00:46:38 UTC (rev 14135) @@ -1,168 +1,454 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: best_practices.xml:5 +#, no-c-format msgid "Best Practices" -msgstr "" +msgstr "Boas práticas" -#: index.docbook:9 -msgid "Write fine-grained classes and map them using <literal><component></literal>." +#. Tag: term +#: best_practices.xml:9 +#, no-c-format +msgid "" +"Write fine-grained classes and map them using <literal><component></" +"literal>." msgstr "" +"Escreva classes compactas e mapeie-as usando <literal><component></" +"literal>." -#: index.docbook:11 -msgid "Use an <literal>Address</literal> class to encapsulate <literal>street</literal>, <literal>suburb</literal>, <literal>state</literal>, <literal>postcode</literal>. This encourages code reuse and simplifies refactoring." +#. Tag: para +#: best_practices.xml:11 +#, no-c-format +msgid "" +"Use an <literal>Address</literal> class to encapsulate <literal>street</" +"literal>, <literal>suburb</literal>, <literal>state</literal>, " +"<literal>postcode</literal>. This encourages code reuse and simplifies " +"refactoring." msgstr "" +"Use uma classe <literal>Endereco</literal> para encapsular <literal>rua</" +"literal>, <literal>bairro</literal>, <literal>estado</literal>, " +"<literal>CEP</literal>. Isto promove a reutilização de código e simplifica o " +"refactoring." -#: index.docbook:19 +#. Tag: term +#: best_practices.xml:19 +#, no-c-format msgid "Declare identifier properties on persistent classes." -msgstr "" +msgstr "Declare propriedades identificadoras em classes persistentes." -#: index.docbook:21 -msgid "Hibernate makes identifier properties optional. There are all sorts of reasons why you should use them. We recommend that identifiers be 'synthetic' (generated, with no business meaning)." +#. Tag: para +#: best_practices.xml:21 +#, no-c-format +msgid "" +"Hibernate makes identifier properties optional. There are all sorts of " +"reasons why you should use them. We recommend that identifiers be " +"'synthetic' (generated, with no business meaning)." msgstr "" +"O Hibernate constrói propriedades identificadoras opcionais. Existem todos " +"os tipos de razões que explicam porquê você deveria utilizá-las. Nós " +"recomendamos que os identificadores sejam 'sintéticos' (gerados, sem " +"significado para o negocio)." -#: index.docbook:29 +#. Tag: term +#: best_practices.xml:29 +#, no-c-format msgid "Identify natural keys." -msgstr "" +msgstr "Identifique chaves naturais." -#: index.docbook:31 -msgid "Identify natural keys for all entities, and map them using <literal><natural-id></literal>. Implement <literal>equals()</literal> and <literal>hashCode()</literal> to compare the properties that make up the natural key." +#. Tag: para +#: best_practices.xml:31 +#, no-c-format +msgid "" +"Identify natural keys for all entities, and map them using <literal><" +"natural-id></literal>. Implement <literal>equals()</literal> and " +"<literal>hashCode()</literal> to compare the properties that make up the " +"natural key." msgstr "" +"Identifique chaves naturais para todas as entidades, e mapeie-as usando " +"<literal><natural-id></literal>. Implemente <literal>equals()</" +"literal> e <literal>hashCode()</literal> para comparar as propriedades que " +"compõem a chave natural." -#: index.docbook:39 +#. Tag: term +#: best_practices.xml:39 +#, no-c-format msgid "Place each class mapping in its own file." -msgstr "" +msgstr "Coloque cada classe de mapeamento em seu próprio arquivo." -#: index.docbook:41 -msgid "Don't use a single monolithic mapping document. Map <literal>com.eg.Foo</literal> in the file <literal>com/eg/Foo.hbm.xml</literal>. This makes particularly good sense in a team environment." +#. Tag: para +#: best_practices.xml:41 +#, no-c-format +msgid "" +"Don't use a single monolithic mapping document. Map <literal>com.eg.Foo</" +"literal> in the file <literal>com/eg/Foo.hbm.xml</literal>. This makes " +"particularly good sense in a team environment." msgstr "" +"Não use um único código de mapeamento monolítico. Mapeie <literal>com.eg." +"Foo</literal> no arquivo <literal>com/eg/Foo.hbm.xml</literal>. Isto promove " +"particularmente o bom senso no time de desenvolvimento." -#: index.docbook:49 +#. Tag: term +#: best_practices.xml:49 +#, no-c-format msgid "Load mappings as resources." -msgstr "" +msgstr "Carregue os mapeamentos como recursos." -#: index.docbook:51 +#. Tag: para +#: best_practices.xml:51 +#, no-c-format msgid "Deploy the mappings along with the classes they map." -msgstr "" +msgstr "Faça o deploy dos mapeamentos junto com as classes que eles mapeiam." -#: index.docbook:57 +#. Tag: term +#: best_practices.xml:57 +#, no-c-format msgid "Consider externalising query strings." -msgstr "" +msgstr "Considere externalizar as strings de consultas." -#: index.docbook:59 -msgid "This is a good practice if your queries call non-ANSI-standard SQL functions. Externalising the query strings to mapping files will make the application more portable." +#. Tag: para +#: best_practices.xml:59 +#, no-c-format +msgid "" +"This is a good practice if your queries call non-ANSI-standard SQL " +"functions. Externalising the query strings to mapping files will make the " +"application more portable." msgstr "" +"Esta é uma boa prática se suas consultas chamam funções SQL que não sejam " +"ANSI. Externalizar as strings de consultas para mapear arquivos irão tornar " +"a aplicação mais portável." -#: index.docbook:67 +#. Tag: term +#: best_practices.xml:67 +#, no-c-format msgid "Use bind variables." -msgstr "" +msgstr "Use bind variables." -#: index.docbook:69 -msgid "As in JDBC, always replace non-constant values by \"?\". Never use string manipulation to bind a non-constant value in a query! Even better, consider using named parameters in queries." +#. Tag: para +#: best_practices.xml:69 +#, no-c-format +msgid "" +"As in JDBC, always replace non-constant values by \"?\". Never use string " +"manipulation to bind a non-constant value in a query! Even better, consider " +"using named parameters in queries." msgstr "" +"Assim como em JDBC, sempre substitua valores não constantes por \"?\". Nunca " +"use a manipulação de strings para concatenar valores não constantes em uma " +"consulta! Até melhor, considere usar parâmetros nomeados nas consultas." -#: index.docbook:77 +#. Tag: term +#: best_practices.xml:77 +#, no-c-format msgid "Don't manage your own JDBC connections." -msgstr "" +msgstr "Não gerencie suas conexões JDBC." -#: index.docbook:79 -msgid "Hibernate lets the application manage JDBC connections. This approach should be considered a last-resort. If you can't use the built-in connections providers, consider providing your own implementation of <literal>org.hibernate.connection.ConnectionProvider</literal>." +#. Tag: para +#: best_practices.xml:79 +#, no-c-format +msgid "" +"Hibernate lets the application manage JDBC connections. This approach should " +"be considered a last-resort. If you can't use the built-in connections " +"providers, consider providing your own implementation of <literal>org." +"hibernate.connection.ConnectionProvider</literal>." msgstr "" +"O Hibernate permite que a aplicação gerencie conexões JDBC. Esta abordagem " +"deve ser considerada um último recurso. Se você não pode usar os provedores " +"de conexão embutidos, considere fazer sua implementação a partir de " +"<literal>org.hibernate.connection.ConnectionProvider</literal>." -#: index.docbook:87 +#. Tag: term +#: best_practices.xml:87 +#, no-c-format msgid "Consider using a custom type." -msgstr "" +msgstr "Considere usar tipos customizados." -#: index.docbook:89 -msgid "Suppose you have a Java type, say from some library, that needs to be persisted but doesn't provide the accessors needed to map it as a component. You should consider implementing <literal>org.hibernate.UserType</literal>. This approach frees the application code from implementing transformations to / from a Hibernate type." +#. Tag: para +#: best_practices.xml:89 +#, no-c-format +msgid "" +"Suppose you have a Java type, say from some library, that needs to be " +"persisted but doesn't provide the accessors needed to map it as a component. " +"You should consider implementing <literal>org.hibernate.UserType</literal>. " +"This approach frees the application code from implementing transformations " +"to / from a Hibernate type." msgstr "" +"Suponha que você tenha um tipo Java, de alguma biblioteca, que precisa ser " +"persistido mas não provê os acessórios necessários para mapeá-lo como um " +"componente. Você deve implementar <literal>org.hibernate.UserType</literal>. " +"Esta abordagem livra o código da aplicação de implementar transformações de/" +"para o tipo Hibernate." -#: index.docbook:98 +#. Tag: term +#: best_practices.xml:98 +#, no-c-format msgid "Use hand-coded JDBC in bottlenecks." -msgstr "" +msgstr "Use código manual JDBC nos gargalos." -#: index.docbook:100 -msgid "In performance-critical areas of the system, some kinds of operations might benefit from direct JDBC. But please, wait until you <emphasis>know</emphasis> something is a bottleneck. And don't assume that direct JDBC is necessarily faster. If you need to use direct JDBC, it might be worth opening a Hibernate <literal>Session</literal> and using that JDBC connection. That way you can still use the same transaction strategy and underlying connection provider." +#. Tag: para +#: best_practices.xml:100 +#, no-c-format +msgid "" +"In performance-critical areas of the system, some kinds of operations might " +"benefit from direct JDBC. But please, wait until you <emphasis>know</" +"emphasis> something is a bottleneck. And don't assume that direct JDBC is " +"necessarily faster. If you need to use direct JDBC, it might be worth " +"opening a Hibernate <literal>Session</literal> and using that JDBC " +"connection. That way you can still use the same transaction strategy and " +"underlying connection provider." msgstr "" +"Nas áreas de desempenho crítico do sistema, alguns tipos de operações podem " +"se beneficiar do uso direto do JDBC. Mas por favor, espere até você " +"<emphasis>saber </emphasis> se é um gargalo. E não suponha que o uso direto " +"do JDBC é necessariamente mais rápido. Se você precisar usar diretamente o " +"JDBC, vale a pena abrir uma <literal>Session</literal> do Hibernate e usar " +"uma conexão JDBC. De modo que você possa ainda usar a mesma estratégia de " +"transação e ocultar o provedor a conexão" -#: index.docbook:110 +#. Tag: term +#: best_practices.xml:110 +#, no-c-format msgid "Understand <literal>Session</literal> flushing." -msgstr "" +msgstr "Entenda o <literal>Session</literal> flushing." -#: index.docbook:112 -msgid "From time to time the Session synchronizes its persistent state with the database. Performance will be affected if this process occurs too often. You may sometimes minimize unnecessary flushing by disabling automatic flushing or even by changing the order of queries and other operations within a particular transaction." +#. Tag: para +#: best_practices.xml:112 +#, no-c-format +msgid "" +"From time to time the Session synchronizes its persistent state with the " +"database. Performance will be affected if this process occurs too often. You " +"may sometimes minimize unnecessary flushing by disabling automatic flushing " +"or even by changing the order of queries and other operations within a " +"particular transaction." msgstr "" +"De tempos em tempos a sessão sincroniza seu estado persistente com o banco " +"de dados. O desempenho será afetado se este processo ocorrer frequentemente. " +"Você pode algumas vezes minimizar o fluxo desnecessário desabilitando o " +"fluxo automático ou até mesmo mudando a ordem das consultas e outras " +"operações em uma transação particular." -#: index.docbook:121 +#. Tag: term +#: best_practices.xml:121 +#, no-c-format msgid "In a three tiered architecture, consider using detached objects." msgstr "" +"Em uma arquitetura de três camadas, considere o uso de objetos separados." -#: index.docbook:123 -msgid "When using a servlet / session bean architecture, you could pass persistent objects loaded in the session bean to and from the servlet / JSP layer. Use a new session to service each request. Use <literal>Session.merge()</literal> or <literal>Session.saveOrUpdate()</literal> to synchronize objects with the database." +#. Tag: para +#: best_practices.xml:123 +#, no-c-format +msgid "" +"When using a servlet / session bean architecture, you could pass persistent " +"objects loaded in the session bean to and from the servlet / JSP layer. Use " +"a new session to service each request. Use <literal>Session.merge()</" +"literal> or <literal>Session.saveOrUpdate()</literal> to synchronize objects " +"with the database." msgstr "" +"When using a servlet / session bean architecture, you could pass persistent " +"objects loaded in the session bean to and from the servlet / JSP layer. Use " +"a new session to service each request. Use <literal>Session.merge()</" +"literal> or <literal>Session.saveOrUpdate()</literal> to synchronize objects " +"with the database." -#: index.docbook:132 +#. Tag: term +#: best_practices.xml:132 +#, no-c-format msgid "In a two tiered architecture, consider using long persistence contexts." msgstr "" +"In a two tiered architecture, consider using long persistence contexts." -#: index.docbook:134 -msgid "Database Transactions have to be as short as possible for best scalability. However, it is often neccessary to implement long running <emphasis>application transactions</emphasis>, a single unit-of-work from the point of view of a user. An application transaction might span several client request/response cycles. It is common to use detached objects to implement application transactions. An alternative, extremely appropriate in two tiered architecture, is to maintain a single open persistence contact (session) for the whole life cycle of the application transaction and simply disconnect from the JDBC connection at the end of each request and reconnect at the beginning of the subsequent request. Never share a single session across more than one application transaction, or you will be working with stale data." +#. Tag: para +#: best_practices.xml:134 +#, no-c-format +msgid "" +"Database Transactions have to be as short as possible for best scalability. " +"However, it is often neccessary to implement long running " +"<emphasis>application transactions</emphasis>, a single unit-of-work from " +"the point of view of a user. An application transaction might span several " +"client request/response cycles. It is common to use detached objects to " +"implement application transactions. An alternative, extremely appropriate in " +"two tiered architecture, is to maintain a single open persistence contact " +"(session) for the whole life cycle of the application transaction and simply " +"disconnect from the JDBC connection at the end of each request and reconnect " +"at the beginning of the subsequent request. Never share a single session " +"across more than one application transaction, or you will be working with " +"stale data." msgstr "" +"Database Transactions have to be as short as possible for best scalability. " +"However, it is often necessary to implement long running " +"<emphasis>application transactions</emphasis>, a single unit-of-work from " +"the point of view of a user. An application transaction might span several " +"client request/response cycles. It is common to use detached objects to " +"implement application transactions. An alternative, extremely appropriate in " +"two tiered architecture, is to maintain a single open persistence contact " +"(session) for the whole life cycle of the application transaction and simply " +"disconnect from the JDBC connection at the end of each request and reconnect " +"at the beginning of the subsequent request. Never share a single session " +"across more than one application transaction, or you will be working with " +"stale data." -#: index.docbook:148 +#. Tag: term +#: best_practices.xml:148 +#, no-c-format msgid "Don't treat exceptions as recoverable." -msgstr "" +msgstr "Don't treat exceptions as recoverable." -#: index.docbook:150 -msgid "This is more of a necessary practice than a \"best\" practice. When an exception occurs, roll back the <literal>Transaction</literal> and close the <literal>Session</literal>. If you don't, Hibernate can't guarantee that in-memory state accurately represents persistent state. As a special case of this, do not use <literal>Session.load()</literal> to determine if an instance with the given identifier exists on the database; use <literal>Session.get()</literal> or a query instead." +#. Tag: para +#: best_practices.xml:150 +#, no-c-format +msgid "" +"This is more of a necessary practice than a \"best\" practice. When an " +"exception occurs, roll back the <literal>Transaction</literal> and close the " +"<literal>Session</literal>. If you don't, Hibernate can't guarantee that in-" +"memory state accurately represents persistent state. As a special case of " +"this, do not use <literal>Session.load()</literal> to determine if an " +"instance with the given identifier exists on the database; use " +"<literal>Session.get()</literal> or a query instead." msgstr "" +"This is more of a necessary practice than a \"best\" practice. When an " +"exception occurs, roll back the <literal>Transaction</literal> and close the " +"<literal>Session</literal>. If you don't, Hibernate can't guarantee that in-" +"memory state accurately represents persistent state. As a special case of " +"this, do not use <literal>Session.load()</literal> to determine if an " +"instance with the given identifier exists on the database; use " +"<literal>Session.get()</literal> or a query instead." -#: index.docbook:160 +#. Tag: term +#: best_practices.xml:160 +#, no-c-format msgid "Prefer lazy fetching for associations." -msgstr "" +msgstr "Prefer lazy fetching for associations." -#: index.docbook:162 -msgid "Use eager fetching sparingly. Use proxies and lazy collections for most associations to classes that are not likely to be completely held in the second-level cache. For associations to cached classes, where there is an a extremely high probability of a cache hit, explicitly disable eager fetching using <literal>lazy=\"false\"</literal>. When an join fetching is appropriate to a particular use case, use a query with a <literal>left join fetch</literal>." +#. Tag: para +#: best_practices.xml:162 +#, no-c-format +msgid "" +"Use eager fetching sparingly. Use proxies and lazy collections for most " +"associations to classes that are not likely to be completely held in the " +"second-level cache. For associations to cached classes, where there is an a " +"extremely high probability of a cache hit, explicitly disable eager fetching " +"using <literal>lazy=\"false\"</literal>. When an join fetching is " +"appropriate to a particular use case, use a query with a <literal>left join " +"fetch</literal>." msgstr "" +"Use eager fetching sparingly. Use proxies and lazy collections for most " +"associations to classes that are not likely to be completely held in the " +"second-level cache. For associations to cached classes, where there is an a " +"extremely high probability of a cache hit, explicitly disable eager fetching " +"using <literal>lazy=\"false\"</literal>. When an join fetching is " +"appropriate to a particular use case, use a query with a <literal>left join " +"fetch</literal>." -#: index.docbook:172 -msgid "Use the <emphasis>open session in view</emphasis> pattern, or a disciplined <emphasis>assembly phase</emphasis> to avoid problems with unfetched data." +#. Tag: term +#: best_practices.xml:172 +#, no-c-format +msgid "" +"Use the <emphasis>open session in view</emphasis> pattern, or a disciplined " +"<emphasis>assembly phase</emphasis> to avoid problems with unfetched data." msgstr "" +"Use the <emphasis>open session in view</emphasis> pattern, or a disciplined " +"<emphasis>assembly phase</emphasis> to avoid problems with unfetched data." -#: index.docbook:177 -msgid "Hibernate frees the developer from writing tedious <emphasis>Data Transfer Objects</emphasis> (DTO). In a traditional EJB architecture, DTOs serve dual purposes: first, they work around the problem that entity beans are not serializable; second, they implicitly define an assembly phase where all data to be used by the view is fetched and marshalled into the DTOs before returning control to the presentation tier. Hibernate eliminates the first purpose. However, you will still need an assembly phase (think of your business methods as having a strict contract with the presentation tier about what data is available in the detached objects) unless you are prepared to hold the persistence context (the session) open across the view rendering process. This is not a limitation of Hibernate! It is a fundamental requirement of safe transactional data access." +#. Tag: para +#: best_practices.xml:177 +#, no-c-format +msgid "" +"Hibernate frees the developer from writing tedious <emphasis>Data Transfer " +"Objects</emphasis> (DTO). In a traditional EJB architecture, DTOs serve dual " +"purposes: first, they work around the problem that entity beans are not " +"serializable; second, they implicitly define an assembly phase where all " +"data to be used by the view is fetched and marshalled into the DTOs before " +"returning control to the presentation tier. Hibernate eliminates the first " +"purpose. However, you will still need an assembly phase (think of your " +"business methods as having a strict contract with the presentation tier " +"about what data is available in the detached objects) unless you are " +"prepared to hold the persistence context (the session) open across the view " +"rendering process. This is not a limitation of Hibernate! It is a " +"fundamental requirement of safe transactional data access." msgstr "" +"Hibernate frees the developer from writing tedious <emphasis>Data Transfer " +"Objects</emphasis> (DTO). In a traditional EJB architecture, DTOs serve dual " +"purposes: first, they work around the problem that entity beans are not " +"serializable; second, they implicitly define an assembly phase where all " +"data to be used by the view is fetched and marshalled into the DTOs before " +"returning control to the presentation tier. Hibernate eliminates the first " +"purpose. However, you will still need an assembly phase (think of your " +"business methods as having a strict contract with the presentation tier " +"about what data is available in the detached objects) unless you are " +"prepared to hold the persistence context (the session) open across the view " +"rendering process. This is not a limitation of Hibernate! It is a " +"fundamental requirement of safe transactional data access." -#: index.docbook:191 +#. Tag: term +#: best_practices.xml:191 +#, no-c-format msgid "Consider abstracting your business logic from Hibernate." -msgstr "" +msgstr "Consider abstracting your business logic from Hibernate." -#: index.docbook:193 -msgid "Hide (Hibernate) data-access code behind an interface. Combine the <emphasis>DAO</emphasis> and <emphasis>Thread Local Session</emphasis> patterns. You can even have some classes persisted by handcoded JDBC, associated to Hibernate via a <literal>UserType</literal>. (This advice is intended for \"sufficiently large\" applications; it is not appropriate for an application with five tables!)" +#. Tag: para +#: best_practices.xml:193 +#, no-c-format +msgid "" +"Hide (Hibernate) data-access code behind an interface. Combine the " +"<emphasis>DAO</emphasis> and <emphasis>Thread Local Session</emphasis> " +"patterns. You can even have some classes persisted by handcoded JDBC, " +"associated to Hibernate via a <literal>UserType</literal>. (This advice is " +"intended for \"sufficiently large\" applications; it is not appropriate for " +"an application with five tables!)" msgstr "" +"Hide (Hibernate) data-access code behind an interface. Combine the " +"<emphasis>DAO</emphasis> and <emphasis>Thread Local Session</emphasis> " +"patterns. You can even have some classes persisted by handcoded JDBC, " +"associated to Hibernate via a <literal>UserType</literal>. (This advice is " +"intended for \"sufficiently large\" applications; it is not appropriate for " +"an application with five tables!)" -#: index.docbook:203 +#. Tag: term +#: best_practices.xml:203 +#, no-c-format msgid "Don't use exotic association mappings." -msgstr "" +msgstr "Don't use exotic association mappings." -#: index.docbook:205 -msgid "Good usecases for a real many-to-many associations are rare. Most of the time you need additional information stored in the \"link table\". In this case, it is much better to use two one-to-many associations to an intermediate link class. In fact, we think that most associations are one-to-many and many-to-one, you should be careful when using any other association style and ask yourself if it is really neccessary." +#. Tag: para +#: best_practices.xml:205 +#, no-c-format +msgid "" +"Good usecases for a real many-to-many associations are rare. Most of the " +"time you need additional information stored in the \"link table\". In this " +"case, it is much better to use two one-to-many associations to an " +"intermediate link class. In fact, we think that most associations are one-to-" +"many and many-to-one, you should be careful when using any other association " +"style and ask yourself if it is really neccessary." msgstr "" +"Good usecases for a real many-to-many associations are rare. Most of the " +"time you need additional information stored in the \"link table\". In this " +"case, it is much better to use two one-to-many associations to an " +"intermediate link class. In fact, we think that most associations are one-to-" +"many and many-to-one, you should be careful when using any other association " +"style and ask yourself if it is really neccessary." -#: index.docbook:215 +#. Tag: term +#: best_practices.xml:215 +#, no-c-format msgid "Prefer bidirectional associations." -msgstr "" +msgstr "Prefer bidirectional associations." -#: index.docbook:217 -msgid "Unidirectional associations are more difficult to query. In a large application, almost all associations must be navigable in both directions in queries." +#. Tag: para +#: best_practices.xml:217 +#, no-c-format +msgid "" +"Unidirectional associations are more difficult to query. In a large " +"application, almost all associations must be navigable in both directions in " +"queries." msgstr "" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "" - +"Unidirectional associations are more difficult to query. In a large " +"application, almost all associations must be navigable in both directions in " +"queries." Modified: core/trunk/documentation/manual/translations/pt-BR/content/collection_mapping.po =================================================================== --- core/trunk/documentation/manual/translations/pt-BR/content/collection_mapping.po 2007-10-25 22:34:46 UTC (rev 14134) +++ core/trunk/documentation/manual/translations/pt-BR/content/collection_mapping.po 2007-10-26 00:46:38 UTC (rev 14135) @@ -1,919 +1,1915 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: collection_mapping.xml:5 +#, no-c-format msgid "Collection Mapping" -msgstr "" +msgstr "Mapeamento de Coleções" -#: index.docbook:8 +#. Tag: title +#: collection_mapping.xml:8 +#, no-c-format msgid "Persistent collections" -msgstr "" +msgstr "Persistent collections" -#: index.docbook:10 -msgid "Hibernate requires that persistent collection-valued fields be declared as an interface type, for example:" +#. Tag: para +#: collection_mapping.xml:10 +#, no-c-format +msgid "" +"Hibernate requires that persistent collection-valued fields be declared as " +"an interface type, for example:" msgstr "" +"Hibernate requires that persistent collection-valued fields be declared as " +"an interface type, for example:" -#: index.docbook:15 +#. Tag: programlisting +#: collection_mapping.xml:15 +#, no-c-format msgid "" - "<![CDATA[public class Product {\n" - " private String serialNumber;\n" - " private Set parts = new HashSet();\n" - " \n" - " public Set getParts() { return parts; }\n" - " void setParts(Set parts) { this.parts = parts; }\n" - " public String getSerialNumber() { return serialNumber; }\n" - " void setSerialNumber(String sn) { serialNumber = sn; }\n" - "}]]>" +"<![CDATA[public class Product {\n" +" private String serialNumber;\n" +" private Set parts = new HashSet();\n" +" \n" +" public Set getParts() { return parts; }\n" +" void setParts(Set parts) { this.parts = parts; }\n" +" public String getSerialNumber() { return serialNumber; }\n" +" void setSerialNumber(String sn) { serialNumber = sn; }\n" +"}]]>" msgstr "" -#: index.docbook:17 -msgid "The actual interface might be <literal>java.util.Set</literal>, <literal>java.util.Collection</literal>, <literal>java.util.List</literal>, <literal>java.util.Map</literal>, <literal>java.util.SortedSet</literal>, <literal>java.util.SortedMap</literal> or ... anything you like! (Where \"anything you like\" means you will have to write an implementation of <literal>org.hibernate.usertype.UserCollectionType</literal>.)" +#. Tag: para +#: collection_mapping.xml:17 +#, no-c-format +msgid "" +"The actual interface might be <literal>java.util.Set</literal>, " +"<literal>java.util.Collection</literal>, <literal>java.util.List</literal>, " +"<literal>java.util.Map</literal>, <literal>java.util.SortedSet</literal>, " +"<literal>java.util.SortedMap</literal> or ... anything you like! (Where " +"\"anything you like\" means you will have to write an implementation of " +"<literal>org.hibernate.usertype.UserCollectionType</literal>.)" msgstr "" +"The actual interface might be <literal>java.util.Set</literal>, " +"<literal>java.util.Collection</literal>, <literal>java.util.List</literal>, " +"<literal>java.util.Map</literal>, <literal>java.util.SortedSet</literal>, " +"<literal>java.util.SortedMap</literal> or ... anything you like! (Where " +"\"anything you like\" means you will have to write an implementation of " +"<literal>org.hibernate.usertype.UserCollectionType</literal>.)" -#: index.docbook:26 -msgid "Notice how we initialized the instance variable with an instance of <literal>HashSet</literal>. This is the best way to initialize collection valued properties of newly instantiated (non-persistent) instances. When you make the instance persistent - by calling <literal>persist()</literal>, for example - Hibernate will actually replace the <literal>HashSet</literal> with an instance of Hibernate's own implementation of <literal>Set</literal>. Watch out for errors like this:" +#. Tag: para +#: collection_mapping.xml:26 +#, no-c-format +msgid "" +"Notice how we initialized the instance variable with an instance of " +"<literal>HashSet</literal>. This is the best way to initialize collection " +"valued properties of newly instantiated (non-persistent) instances. When you " +"make the instance persistent - by calling <literal>persist()</literal>, for " +"example - Hibernate will actually replace the <literal>HashSet</literal> " +"with an instance of Hibernate's own implementation of <literal>Set</" +"literal>. Watch out for errors like this:" msgstr "" +"Notice how we initialized the instance variable with an instance of " +"<literal>HashSet</literal>. This is the best way to initialize collection " +"valued properties of newly instantiated (non-persistent) instances. When you " +"make the instance persistent - by calling <literal>persist()</literal>, for " +"example - Hibernate will actually replace the <literal>HashSet</literal> " +"with an instance of Hibernate's own implementation of <literal>Set</" +"literal>. Watch out for errors like this:" -#: index.docbook:36 +#. Tag: programlisting +#: collection_mapping.xml:36 +#, no-c-format msgid "" - "<![CDATA[Cat cat = new DomesticCat();\n" - "Cat kitten = new DomesticCat();\n" - "....\n" - "Set kittens = new HashSet();\n" - "kittens.add(kitten);\n" - "cat.setKittens(kittens);\n" - "session.persist(cat);\n" - "kittens = cat.getKittens(); // Okay, kittens collection is a Set\n" - "(HashSet) cat.getKittens(); // Error!]]>" +"<![CDATA[Cat cat = new DomesticCat();\n" +"Cat kitten = new DomesticCat();\n" +"....\n" +"Set kittens = new HashSet();\n" +"kittens.add(kitten);\n" +"cat.setKittens(kittens);\n" +"session.persist(cat);\n" +"kittens = cat.getKittens(); // Okay, kittens collection is a Set\n" +"(HashSet) cat.getKittens(); // Error!]]>" msgstr "" -#: index.docbook:38 -msgid "The persistent collections injected by Hibernate behave like <literal>HashMap</literal>, <literal>HashSet</literal>, <literal>TreeMap</literal>, <literal>TreeSet</literal> or <literal>ArrayList</literal>, depending upon the interface type." +#. Tag: para +#: collection_mapping.xml:38 +#, no-c-format +msgid "" +"The persistent collections injected by Hibernate behave like " +"<literal>HashMap</literal>, <literal>HashSet</literal>, <literal>TreeMap</" +"literal>, <literal>TreeSet</literal> or <literal>ArrayList</literal>, " +"depending upon the interface type." msgstr "" +"The persistent collections injected by Hibernate behave like " +"<literal>HashMap</literal>, <literal>HashSet</literal>, <literal>TreeMap</" +"literal>, <literal>TreeSet</literal> or <literal>ArrayList</literal>, " +"depending upon the interface type." -#: index.docbook:45 -msgid "Collections instances have the usual behavior of value types. They are automatically persisted when referenced by a persistent object and automatically deleted when unreferenced. If a collection is passed from one persistent object to another, its elements might be moved from one table to another. Two entities may not share a reference to the same collection instance. Due to the underlying relational model, collection-valued properties do not support null value semantics; Hibernate does not distinguish between a null collection reference and an empty collection." +#. Tag: para +#: collection_mapping.xml:45 +#, no-c-format +msgid "" +"Collections instances have the usual behavior of value types. They are " +"automatically persisted when referenced by a persistent object and " +"automatically deleted when unreferenced. If a collection is passed from one " +"persistent object to another, its elements might be moved from one table to " +"another. Two entities may not share a reference to the same collection " +"instance. Due to the underlying relational model, collection-valued " +"properties do not support null value semantics; Hibernate does not " +"distinguish between a null collection reference and an empty collection." msgstr "" +"Collections instances have the usual behavior of value types. They are " +"automatically persisted when referenced by a persistent object and " +"automatically deleted when unreferenced. If a collection is passed from one " +"persistent object to another, its elements might be moved from one table to " +"another. Two entities may not share a reference to the same collection " +"instance. Due to the underlying relational model, collection-valued " +"properties do not support null value semantics; Hibernate does not " +"distinguish between a null collection reference and an empty collection." -#: index.docbook:56 -msgid "You shouldn't have to worry much about any of this. Use persistent collections the same way you use ordinary Java collections. Just make sure you understand the semantics of bidirectional associations (discussed later)." +#. Tag: para +#: collection_mapping.xml:56 +#, no-c-format +msgid "" +"You shouldn't have to worry much about any of this. Use persistent " +"collections the same way you use ordinary Java collections. Just make sure " +"you understand the semantics of bidirectional associations (discussed later)." msgstr "" +"You shouldn't have to worry much about any of this. Use persistent " +"collections the same way you use ordinary Java collections. Just make sure " +"you understand the semantics of bidirectional associations (discussed later)." -#: index.docbook:65 +#. Tag: title +#: collection_mapping.xml:65 +#, no-c-format msgid "Collection mappings" -msgstr "" +msgstr "Collection mappings" -#: index.docbook:67 -msgid "The Hibernate mapping element used for mapping a collection depends upon the type of the interface. For example, a <literal><set></literal> element is used for mapping properties of type <literal>Set</literal>." +#. Tag: para +#: collection_mapping.xml:67 +#, no-c-format +msgid "" +"The Hibernate mapping element used for mapping a collection depends upon the " +"type of the interface. For example, a <literal><set></literal> element " +"is used for mapping properties of type <literal>Set</literal>." msgstr "" +"The Hibernate mapping element used for mapping a collection depends upon the " +"type of the interface. For example, a <literal><set></literal> element " +"is used for mapping properties of type <literal>Set</literal>." -#: index.docbook:73 +#. Tag: programlisting +#: collection_mapping.xml:73 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Product\">\n" - " <id name=\"serialNumber\" column=\"productSerialNumber\"/>\n" - " <set name=\"parts\">\n" - " <key column=\"productSerialNumber\" not-null=\"true\"/>\n" - " <one-to-many class=\"Part\"/>\n" - " </set>\n" - "</class>]]>" +"<![CDATA[<class name=\"Product\">\n" +" <id name=\"serialNumber\" column=\"productSerialNumber\"/>\n" +" <set name=\"parts\">\n" +" <key column=\"productSerialNumber\" not-null=\"true\"/>\n" +" <one-to-many class=\"Part\"/>\n" +" </set>\n" +"</class>]]>" msgstr "" -#: index.docbook:75 -msgid "Apart from <literal><set></literal>, there is also <literal><list></literal>, <literal><map></literal>, <literal><bag></literal>, <literal><array></literal> and <literal><primitive-array></literal> mapping elements. The <literal><map></literal> element is representative:" +#. Tag: para +#: collection_mapping.xml:75 +#, no-c-format +msgid "" +"Apart from <literal><set></literal>, there is also <literal><" +"list></literal>, <literal><map></literal>, <literal><bag></" +"literal>, <literal><array></literal> and <literal><primitive-" +"array></literal> mapping elements. The <literal><map></literal> " +"element is representative:" msgstr "" +"Apart from <literal><set></literal>, there is also <literal><" +"list></literal>, <literal><map></literal>, <literal><bag></" +"literal>, <literal><array></literal> and <literal><primitive-" +"array></literal> mapping elements. The <literal><map></literal> " +"element is representative:" -#: index.docbook:100 +#. Tag: programlisting +#: collection_mapping.xml:100 +#, no-c-format msgid "" - "<![CDATA[<map\n" - " name=\"propertyName\"\n" - " table=\"table_name\"\n" - " schema=\"schema_name\"\n" - " lazy=\"true|extra|false\"\n" - " inverse=\"true|false\"\n" - " cascade=\"all|none|save-update|delete|all-delete-orphan|delete-orphan\"\n" - " sort=\"unsorted|natural|comparatorClass\"\n" - " order-by=\"column_name asc|desc\"\n" - " where=\"arbitrary sql where condition\"\n" - " fetch=\"join|select|subselect\"\n" - " batch-size=\"N\"\n" - " access=\"field|property|ClassName\"\n" - " optimistic-lock=\"true|false\"\n" - " mutable=\"true|false\"\n" - " node=\"element-name|.\"\n" - " embed-xml=\"true|false\"\n" - ">\n" - "\n" - " <key .... />\n" - " <map-key .... />\n" - " <element .... />\n" - "</map>]]>" +"<![CDATA[<map\n" +" name=\"propertyName\"\n" +" table=\"table_name\"\n" +" schema=\"schema_name\"\n" +" lazy=\"true|extra|false\"\n" +" inverse=\"true|false\"\n" +" cascade=\"all|none|save-update|delete|all-delete-orphan|delete-orphan\"\n" +" sort=\"unsorted|natural|comparatorClass\"\n" +" order-by=\"column_name asc|desc\"\n" +" where=\"arbitrary sql where condition\"\n" +" fetch=\"join|select|subselect\"\n" +" batch-size=\"N\"\n" +" access=\"field|property|ClassName\"\n" +" optimistic-lock=\"true|false\"\n" +" mutable=\"true|false\"\n" +" node=\"element-name|.\"\n" +" embed-xml=\"true|false\"\n" +">\n" +"\n" +" <key .... />\n" +" <map-key .... />\n" +" <element .... />\n" +"</map>]]>" msgstr "" -#: index.docbook:103 +#. Tag: para +#: collection_mapping.xml:103 +#, no-c-format msgid "<literal>name</literal> the collection property name" -msgstr "" +msgstr "<literal>name</literal> the collection property name" -#: index.docbook:108 -msgid "<literal>table</literal> (optional - defaults to property name) the name of the collection table (not used for one-to-many associations)" +#. Tag: para +#: collection_mapping.xml:108 +#, no-c-format +msgid "" +"<literal>table</literal> (optional - defaults to property name) the name of " +"the collection table (not used for one-to-many associations)" msgstr "" +"<literal>table</literal> (optional - defaults to property name) the name of " +"the collection table (not used for one-to-many associations)" -#: index.docbook:114 -msgid "<literal>schema</literal> (optional) the name of a table schema to override the schema declared on the root element" +#. Tag: para +#: collection_mapping.xml:114 +#, no-c-format +msgid "" +"<literal>schema</literal> (optional) the name of a table schema to override " +"the schema declared on the root element" msgstr "" +"<literal>schema</literal> (optional) the name of a table schema to override " +"the schema declared on the root element" -#: index.docbook:120 -msgid "<literal>lazy</literal> (optional - defaults to <literal>true</literal>) may be used to disable lazy fetching and specify that the association is always eagerly fetched, or to enable \"extra-lazy\" fetching where most operations do not initialize the collection (suitable for very large collections)" +#. Tag: para +#: collection_mapping.xml:120 +#, no-c-format +msgid "" +"<literal>lazy</literal> (optional - defaults to <literal>true</literal>) may " +"be used to disable lazy fetching and specify that the association is always " +"eagerly fetched, or to enable \"extra-lazy\" fetching where most operations " +"do not initialize the collection (suitable for very large collections)" msgstr "" +"<literal>lazy</literal> (optional - defaults to <literal>true</literal>) may " +"be used to disable lazy fetching and specify that the association is always " +"eagerly fetched, or to enable \"extra-lazy\" fetching where most operations " +"do not initialize the collection (suitable for very large collections)" -#: index.docbook:129 -msgid "<literal>inverse</literal> (optional - defaults to <literal>false</literal>) mark this collection as the \"inverse\" end of a bidirectional association" +#. Tag: para +#: collection_mapping.xml:129 +#, no-c-format +msgid "" +"<literal>inverse</literal> (optional - defaults to <literal>false</literal>) " +"mark this collection as the \"inverse\" end of a bidirectional association" msgstr "" +"<literal>inverse</literal> (optional - defaults to <literal>false</literal>) " +"mark this collection as the \"inverse\" end of a bidirectional association" -#: index.docbook:135 -msgid "<literal>cascade</literal> (optional - defaults to <literal>none</literal>) enable operations to cascade to child entities" +#. Tag: para +#: collection_mapping.xml:135 +#, no-c-format +msgid "" +"<literal>cascade</literal> (optional - defaults to <literal>none</literal>) " +"enable operations to cascade to child entities" msgstr "" +"<literal>cascade</literal> (optional - defaults to <literal>none</literal>) " +"enable operations to cascade to child entities" -#: index.docbook:141 -msgid "<literal>sort</literal> (optional) specify a sorted collection with <literal>natural</literal> sort order, or a given comparator class" +#. Tag: para +#: collection_mapping.xml:141 +#, no-c-format +msgid "" +"<literal>sort</literal> (optional) specify a sorted collection with " +"<literal>natural</literal> sort order, or a given comparator class" msgstr "" +"<literal>sort</literal> (optional) specify a sorted collection with " +"<literal>natural</literal> sort order, or a given comparator class" -#: index.docbook:147 -msgid "<literal>order-by</literal> (optional, JDK1.4 only) specify a table column (or columns) that define the iteration order of the <literal>Map</literal>, <literal>Set</literal> or bag, together with an optional <literal>asc</literal> or <literal>desc</literal>" +#. Tag: para +#: collection_mapping.xml:147 +#, no-c-format +msgid "" +"<literal>order-by</literal> (optional, JDK1.4 only) specify a table column " +"(or columns) that define the iteration order of the <literal>Map</literal>, " +"<literal>Set</literal> or bag, together with an optional <literal>asc</" +"literal> or <literal>desc</literal>" msgstr "" +"<literal>order-by</literal> (optional, JDK1.4 only) specify a table column " +"(or columns) that define the iteration order of the <literal>Map</literal>, " +"<literal>Set</literal> or bag, together with an optional <literal>asc</" +"literal> or <literal>desc</literal>" -#: index.docbook:154 -msgid "<literal>where</literal> (optional) specify an arbitrary SQL <literal>WHERE</literal> condition to be used when retrieving or removing the collection (useful if the collection should contain only a subset of the available data)" +#. Tag: para +#: collection_mapping.xml:154 +#, no-c-format +msgid "" +"<literal>where</literal> (optional) specify an arbitrary SQL <literal>WHERE</" +"literal> condition to be used when retrieving or removing the collection " +"(useful if the collection should contain only a subset of the available data)" msgstr "" +"<literal>where</literal> (optional) specify an arbitrary SQL <literal>WHERE</" +"literal> condition to be used when retrieving or removing the collection " +"(useful if the collection should contain only a subset of the available data)" -#: index.docbook:161 -msgid "<literal>fetch</literal> (optional, defaults to <literal>select</literal>) Choose between outer-join fetching, fetching by sequential select, and fetching by sequential subselect." +#. Tag: para +#: collection_mapping.xml:161 +#, no-c-format +msgid "" +"<literal>fetch</literal> (optional, defaults to <literal>select</literal>) " +"Choose between outer-join fetching, fetching by sequential select, and " +"fetching by sequential subselect." msgstr "" +"<literal>fetch</literal> (optional, defaults to <literal>select</literal>) " +"Choose between outer-join fetching, fetching by sequential select, and " +"fetching by sequential subselect." -#: index.docbook:168 -msgid "<literal>batch-size</literal> (optional, defaults to <literal>1</literal>) specify a \"batch size\" for lazily fetching instances of this collection." +#. Tag: para +#: collection_mapping.xml:168 +#, no-c-format +msgid "" +"<literal>batch-size</literal> (optional, defaults to <literal>1</literal>) " +"specify a \"batch size\" for lazily fetching instances of this collection." msgstr "" +"<literal>batch-size</literal> (optional, defaults to <literal>1</literal>) " +"specify a \"batch size\" for lazily fetching instances of this collection." -#: index.docbook:174 -msgid "<literal>access</literal> (optional - defaults to <literal>property</literal>): The strategy Hibernate should use for accessing the collection property value." +#. Tag: para +#: collection_mapping.xml:174 +#, no-c-format +msgid "" +"<literal>access</literal> (optional - defaults to <literal>property</" +"literal>): The strategy Hibernate should use for accessing the collection " +"property value." msgstr "" +"<literal>access</literal> (optional - defaults to <literal>property</" +"literal>): The strategy Hibernate should use for accessing the collection " +"property value." -#: index.docbook:180 -msgid "<literal>optimistic-lock</literal> (optional - defaults to <literal>true</literal>): Species that changes to the state of the collection results in increment of the owning entity's version. (For one to many associations, it is often reasonable to disable this setting.)" +#. Tag: para +#: collection_mapping.xml:180 +#, no-c-format +msgid "" +"<literal>optimistic-lock</literal> (optional - defaults to <literal>true</" +"literal>): Species that changes to the state of the collection results in " +"increment of the owning entity's version. (For one to many associations, it " +"is often reasonable to disable this setting.)" msgstr "" +"<literal>optimistic-lock</literal> (optional - defaults to <literal>true</" +"literal>): Species that changes to the state of the collection results in " +"increment of the owning entity's version. (For one to many associations, it " +"is often reasonable to disable this setting.)" -#: index.docbook:188 -msgid "<literal>mutable</literal> (optional - defaults to <literal>true</literal>): A value of <literal>false</literal> specifies that the elements of the collection never change (a minor performance optimization in some cases)." +#. Tag: para +#: collection_mapping.xml:188 +#, no-c-format +msgid "" +"<literal>mutable</literal> (optional - defaults to <literal>true</literal>): " +"A value of <literal>false</literal> specifies that the elements of the " +"collection never change (a minor performance optimization in some cases)." msgstr "" +"<literal>mutable</literal> (optional - defaults to <literal>true</literal>): " +"A value of <literal>false</literal> specifies that the elements of the " +"collection never change (a minor performance optimization in some cases)." -#: index.docbook:198 +#. Tag: title +#: collection_mapping.xml:198 +#, no-c-format msgid "Collection foreign keys" -msgstr "" +msgstr "Collection foreign keys" -#: index.docbook:200 -msgid "Collection instances are distinguished in the database by the foreign key of the entity that owns the collection. This foreign key is referred to as the <emphasis>collection key column</emphasis> (or columns) of the collection table. The collection key column is mapped by the <literal><key></literal> element." +#. Tag: para +#: collection_mapping.xml:200 +#, no-c-format +msgid "" +"Collection instances are distinguished in the database by the foreign key of " +"the entity that owns the collection. This foreign key is referred to as the " +"<emphasis>collection key column</emphasis> (or columns) of the collection " +"table. The collection key column is mapped by the <literal><key></" +"literal> element." msgstr "" +"Collection instances are distinguished in the database by the foreign key of " +"the entity that owns the collection. This foreign key is referred to as the " +"<emphasis>collection key column</emphasis> (or columns) of the collection " +"table. The collection key column is mapped by the <literal><key></" +"literal> element." -#: index.docbook:208 -msgid "There may be a nullability constraint on the foreign key column. For most collections, this is implied. For unidirectional one to many associations, the foreign key column is nullable by default, so you might need to specify <literal>not-null=\"true\"</literal>." +#. Tag: para +#: collection_mapping.xml:208 +#, no-c-format +msgid "" +"There may be a nullability constraint on the foreign key column. For most " +"collections, this is implied. For unidirectional one to many associations, " +"the foreign key column is nullable by default, so you might need to specify " +"<literal>not-null=\"true\"</literal>." msgstr "" +"There may be a nullability constraint on the foreign key column. For most " +"collections, this is implied. For unidirectional one to many associations, " +"the foreign key column is nullable by default, so you might need to specify " +"<literal>not-null=\"true\"</literal>." -#: index.docbook:215 +#. Tag: programlisting +#: collection_mapping.xml:215 +#, no-c-format msgid "<![CDATA[<key column=\"productSerialNumber\" not-null=\"true\"/>]]>" msgstr "" -#: index.docbook:217 -msgid "The foreign key constraint may use <literal>ON DELETE CASCADE</literal>." +#. Tag: para +#: collection_mapping.xml:217 +#, no-c-format +msgid "" +"The foreign key constraint may use <literal>ON DELETE CASCADE</literal>." msgstr "" +"The foreign key constraint may use <literal>ON DELETE CASCADE</literal>." -#: index.docbook:221 +#. Tag: programlisting +#: collection_mapping.xml:221 +#, no-c-format msgid "<![CDATA[<key column=\"productSerialNumber\" on-delete=\"cascade\"/>]]>" msgstr "" -#: index.docbook:223 -msgid "See the previous chapter for a full definition of the <literal><key></literal> element." +#. Tag: para +#: collection_mapping.xml:223 +#, no-c-format +msgid "" +"See the previous chapter for a full definition of the <literal><key></" +"literal> element." msgstr "" +"See the previous chapter for a full definition of the <literal><key></" +"literal> element." -#: index.docbook:231 +#. Tag: title +#: collection_mapping.xml:231 +#, no-c-format msgid "Collection elements" -msgstr "" +msgstr "Collection elements" -#: index.docbook:233 -msgid "Collections may contain almost any other Hibernate type, including all basic types, custom types, components, and of course, references to other entities. This is an important distinction: an object in a collection might be handled with \"value\" semantics (its life cycle fully depends on the collection owner) or it might be a reference to another entity, with its own life cycle. In the latter case, only the \"link\" between the two objects is considered to be state held by the collection." +#. Tag: para +#: collection_mapping.xml:233 +#, no-c-format +msgid "" +"Collections may contain almost any other Hibernate type, including all basic " +"types, custom types, components, and of course, references to other " +"entities. This is an important distinction: an object in a collection might " +"be handled with \"value\" semantics (its life cycle fully depends on the " +"collection owner) or it might be a reference to another entity, with its own " +"life cycle. In the latter case, only the \"link\" between the two objects is " +"considered to be state held by the collection." msgstr "" +"Collections may contain almost any other Hibernate type, including all basic " +"types, custom types, components, and of course, references to other " +"entities. This is an important distinction: an object in a collection might " +"be handled with \"value\" semantics (its life cycle fully depends on the " +"collection owner) or it might be a reference to another entity, with its own " +"life cycle. In the latter case, only the \"link\" between the two objects is " +"considered to be state held by the collection." -#: index.docbook:242 -msgid "The contained type is referred to as the <emphasis>collection element type</emphasis>. Collection elements are mapped by <literal><element></literal> or <literal><composite-element></literal>, or in the case of entity references, with <literal><one-to-many></literal> or <literal><many-to-many></literal>. The first two map elements with value semantics, the next two are used to map entity associations." +#. Tag: para +#: collection_mapping.xml:242 +#, no-c-format +msgid "" +"The contained type is referred to as the <emphasis>collection element type</" +"emphasis>. Collection elements are mapped by <literal><element></" +"literal> or <literal><composite-element></literal>, or in the case of " +"entity references, with <literal><one-to-many></literal> or " +"<literal><many-to-many></literal>. The first two map elements with " +"value semantics, the next two are used to map entity associations." msgstr "" +"The contained type is referred to as the <emphasis>collection element type</" +"emphasis>. Collection elements are mapped by <literal><element></" +"literal> or <literal><composite-element></literal>, or in the case of " +"entity references, with <literal><one-to-many></literal> or " +"<literal><many-to-many></literal>. The first two map elements with " +"value semantics, the next two are used to map entity associations." -#: index.docbook:254 +#. Tag: title +#: collection_mapping.xml:254 +#, no-c-format msgid "Indexed collections" -msgstr "" +msgstr "Indexed collections" -#: index.docbook:256 -msgid "All collection mappings, except those with set and bag semantics, need an <emphasis>index column</emphasis> in the collection table - a column that maps to an array index, or <literal>List</literal> index, or <literal>Map</literal> key. The index of a <literal>Map</literal> may be of any basic type, mapped with <literal><map-key></literal>, it may be an entity reference mapped with <literal><map-key-many-to-many></literal>, or it may be a composite type, mapped with <literal><composite-map-key></literal>. The index of an array or list is always of type <literal>integer</literal> and is mapped using the <literal><list-index></literal> element. The mapped column contains sequential integers (numbered from zero, by default)." +#. Tag: para +#: collection_mapping.xml:256 +#, no-c-format +msgid "" +"All collection mappings, except those with set and bag semantics, need an " +"<emphasis>index column</emphasis> in the collection table - a column that " +"maps to an array index, or <literal>List</literal> index, or <literal>Map</" +"literal> key. The index of a <literal>Map</literal> may be of any basic " +"type, mapped with <literal><map-key></literal>, it may be an entity " +"reference mapped with <literal><map-key-many-to-many></literal>, or it " +"may be a composite type, mapped with <literal><composite-map-key></" +"literal>. The index of an array or list is always of type <literal>integer</" +"literal> and is mapped using the <literal><list-index></literal> " +"element. The mapped column contains sequential integers (numbered from zero, " +"by default)." msgstr "" +"All collection mappings, except those with set and bag semantics, need an " +"<emphasis>index column</emphasis> in the collection table - a column that " +"maps to an array index, or <literal>List</literal> index, or <literal>Map</" +"literal> key. The index of a <literal>Map</literal> may be of any basic " +"type, mapped with <literal><map-key></literal>, it may be an entity " +"reference mapped with <literal><map-key-many-to-many></literal>, or it " +"may be a composite type, mapped with <literal><composite-map-key></" +"literal>. The index of an array or list is always of type <literal>integer</" +"literal> and is mapped using the <literal><list-index></literal> " +"element. The mapped column contains sequential integers (numbered from zero, " +"by default)." -#: index.docbook:267 +#. Tag: sect2 +#: collection_mapping.xml:267 +#, no-c-format msgid "" - "<programlistingco> <areaspec> <area id=\"index1\" coords=\"2 45\"/> <area id=\"index2\" coords=\"3 45\"/> </areaspec> <programlisting><![CDATA[<list-index \n" - " column=\"column_name\"\n" - " base=\"0|1|...\"/>]]></programlisting> <calloutlist> <callout arearefs=\"index1\"> <para> <literal>column_name</literal> (required): The name of the column holding the collection index values. </para> </callout> <callout arearefs=\"index1\"> <para> <literal>base</literal> (optional, defaults to <literal>0</literal>): The value of the index column that corresponds to the first element of the list or array. </para> </callout> </calloutlist> </programlistingco> <programlistingco> <areaspec> <area id=\"mapkey1\" coords=\"2 45\"/> <area id=\"mapkey2\" coords=\"3 45\"/> <area id=\"mapkey3\" coords=\"4 45\"/> </areaspec> <programlisting><![CDATA[<map-key \n" - " column=\"column_name\"\n" - " formula=\"any SQL expression\"\n" - " type=\"type_name\"\n" - " node=\"@attribute-name\"\n" - " length=\"N\"/>]]></programlisting> <calloutlist> <callout arearefs=\"mapkey1\"> <para> <literal>column</literal> (optional): The name of the column holding the collection index values. </para> </callout> <callout arearefs=\"mapkey2\"> <para> <literal>formula</literal> (optional): A SQL formula used to evaluate the key of the map. </para> </callout> <callout arearefs=\"mapkey3\"> <para> <literal>type</literal> (reguired): The type of the map keys. </para> </callout> </calloutlist> </programlistingco> <programlistingco> <areaspec> <area id=\"indexmanytomany1\" coords=\"2 45\"/> <area id=\"indexmanytomany2\" coords=\"3 45\"/> <area id=\"indexmanytomany3\" coords=\"3 45\"/> </areaspec> <programlisting><![CDATA[<map-key-many-to-many\n" - " column=\"column_name\"\n" - " formula=\"any SQL expression\"\n" - " class=\"ClassName\"\n" - "/>]]></programlisting> <calloutlist> <callout arearefs=\"indexmanytomany1\"> <para> <literal>column</literal> (optional): The name of the foreign key column for the collection index values. </para> </callout> <callout arearefs=\"indexmanytomany2\"> <para> <literal>formula</literal> (optional): A SQL formula used to evaluate the foreign key of the map key. </para> </callout> <callout arearefs=\"indexmanytomany3\"> <para> <literal>class</literal> (required): The entity class used as the map key. </para> </callout> </calloutlist> </programlistingco>" +"<programlistingco> <areaspec> <area id=\"index1\" coords=\"2 45\"/> <area id=" +"\"index2\" coords=\"3 45\"/> </areaspec> <programlisting><![CDATA[<list-" +"index \n" +" column=\"column_name\"\n" +" base=\"0|1|...\"/>]]></programlisting> <calloutlist> <callout " +"arearefs=\"index1\"> <para> <literal>column_name</literal> (required): The " +"name of the column holding the collection index values. </para> </callout> " +"<callout arearefs=\"index1\"> <para> <literal>base</literal> (optional, " +"defaults to <literal>0</literal>): The value of the index column that " +"corresponds to the first element of the list or array. </para> </callout> </" +"calloutlist> </programlistingco> <programlistingco> <areaspec> <area id=" +"\"mapkey1\" coords=\"2 45\"/> <area id=\"mapkey2\" coords=\"3 45\"/> <area " +"id=\"mapkey3\" coords=\"4 45\"/> </areaspec> <programlisting><![CDATA[<map-" +"key \n" +" column=\"column_name\"\n" +" formula=\"any SQL expression\"\n" +" type=\"type_name\"\n" +" node=\"@attribute-name\"\n" +" length=\"N\"/>]]></programlisting> <calloutlist> <callout arearefs=" +"\"mapkey1\"> <para> <literal>column</literal> (optional): The name of the " +"column holding the collection index values. </para> </callout> <callout " +"arearefs=\"mapkey2\"> <para> <literal>formula</literal> (optional): A SQL " +"formula used to evaluate the key of the map. </para> </callout> <callout " +"arearefs=\"mapkey3\"> <para> <literal>type</literal> (reguired): The type of " +"the map keys. </para> </callout> </calloutlist> </programlistingco> " +"<programlistingco> <areaspec> <area id=\"indexmanytomany1\" coords=\"2 45\"/" +"> <area id=\"indexmanytomany2\" coords=\"3 45\"/> <area id=\"indexmanytomany3" +"\" coords=\"3 45\"/> </areaspec> <programlisting><![CDATA[<map-key-many-to-" +"many\n" +" column=\"column_name\"\n" +" formula=\"any SQL expression\"\n" +" class=\"ClassName\"\n" +"/>]]></programlisting> <calloutlist> <callout arearefs=\"indexmanytomany1\"> " +"<para> <literal>column</literal> (optional): The name of the foreign key " +"column for the collection index values. </para> </callout> <callout arearefs=" +"\"indexmanytomany2\"> <para> <literal>formula</literal> (optional): A SQL " +"formula used to evaluate the foreign key of the map key. </para> </callout> " +"<callout arearefs=\"indexmanytomany3\"> <para> <literal>class</literal> " +"(required): The entity class used as the map key. </para> </callout> </" +"calloutlist> </programlistingco>" msgstr "" -#: index.docbook:348 -msgid "If your table doesn't have an index column, and you still wish to use <literal>List</literal> as the property type, you should map the property as a Hibernate <emphasis><bag></emphasis>. A bag does not retain its order when it is retrieved from the database, but it may be optionally sorted or ordered." +#. Tag: para +#: collection_mapping.xml:348 +#, no-c-format +msgid "" +"If your table doesn't have an index column, and you still wish to use " +"<literal>List</literal> as the property type, you should map the property as " +"a Hibernate <emphasis><bag></emphasis>. A bag does not retain its " +"order when it is retrieved from the database, but it may be optionally " +"sorted or ordered." msgstr "" +"If your table doesn't have an index column, and you still wish to use " +"<literal>List</literal> as the property type, you should map the property as " +"a Hibernate <emphasis><bag></emphasis>. A bag does not retain its " +"order when it is retrieved from the database, but it may be optionally " +"sorted or ordered." -#: index.docbook:357 -msgid "There are quite a range of mappings that can be generated for collections, covering many common relational models. We suggest you experiment with the schema generation tool to get a feeling for how various mapping declarations translate to database tables." +#. Tag: para +#: collection_mapping.xml:357 +#, no-c-format +msgid "" +"There are quite a range of mappings that can be generated for collections, " +"covering many common relational models. We suggest you experiment with the " +"schema generation tool to get a feeling for how various mapping declarations " +"translate to database tables." msgstr "" +"There are quite a range of mappings that can be generated for collections, " +"covering many common relational models. We suggest you experiment with the " +"schema generation tool to get a feeling for how various mapping declarations " +"translate to database tables." -#: index.docbook:364 +#. Tag: title +#: collection_mapping.xml:364 +#, no-c-format msgid "Collections of values and many-to-many associations" -msgstr "" +msgstr "Collections of values and many-to-many associations" -#: index.docbook:366 -msgid "Any collection of values or many-to-many association requires a dedicated <emphasis>collection table</emphasis> with a foreign key column or columns, <emphasis>collection element column</emphasis> or columns and possibly an index column or columns." +#. Tag: para +#: collection_mapping.xml:366 +#, no-c-format +msgid "" +"Any collection of values or many-to-many association requires a dedicated " +"<emphasis>collection table</emphasis> with a foreign key column or columns, " +"<emphasis>collection element column</emphasis> or columns and possibly an " +"index column or columns." msgstr "" +"Any collection of values or many-to-many association requires a dedicated " +"<emphasis>collection table</emphasis> with a foreign key column or columns, " +"<emphasis>collection element column</emphasis> or columns and possibly an " +"index column or columns." -#: index.docbook:373 -msgid "For a collection of values, we use the <literal><element></literal> tag." +#. Tag: para +#: collection_mapping.xml:373 +#, no-c-format +msgid "" +"For a collection of values, we use the <literal><element></literal> " +"tag." msgstr "" +"For a collection of values, we use the <literal><element></literal> " +"tag." -#: index.docbook:375 +#. Tag: sect2 +#: collection_mapping.xml:375 +#, no-c-format msgid "" - "<programlistingco> <areaspec> <area id=\"element1b\" coords=\"2 50\"/> <area id=\"element2b\" coords=\"3 50\"/> <area id=\"element3b\" coords=\"4 50\"/> </areaspec> <programlisting><![CDATA[<element\n" - " column=\"column_name\"\n" - " formula=\"any SQL expression\"\n" - " type=\"typename\"\n" - " length=\"L\"\n" - " precision=\"P\"\n" - " scale=\"S\"\n" - " not-null=\"true|false\"\n" - " unique=\"true|false\"\n" - " node=\"element-name\"\n" - "/>]]></programlisting> <calloutlist> <callout arearefs=\"element1b\"> <para> <literal>column</literal> (optional): The name of the column holding the collection element values. </para> </callout> <callout arearefs=\"element2b\"> <para> <literal>formula</literal> (optional): An SQL formula used to evaluate the element. </para> </callout> <callout arearefs=\"element3b\"> <para> <literal>type</literal> (required): The type of the collection element. </para> </callout> </calloutlist> </programlistingco> <para> A <emphasis>many-to-many association</emphasis> is specified using the <literal><many-to-many></literal> element. </para> <programlistingco> <areaspec> <area id=\"manytomany1\" coords=\"2 60\"/> <area id=\"manytomany2\" coords=\"3 60\"/> <area id=\"manytomany3\" coords=\"4 60\"/> <area id=\"manytomany4\" coords=\"5 60\"/> <area id=\"manytomany5\" coords=\"6 60\"/> <area id=\"manytomany6\" coords=\"7 60\"/> <area id=\"manytomany7\" coords=\"8 60\"/> <area id=\! "manytomany8\" coords=\"9 60\"/> </areaspec> <programlisting><![CDATA[<many-to-many\n" - " column=\"column_name\"\n" - " formula=\"any SQL expression\"\n" - " class=\"ClassName\"\n" - " fetch=\"select|join\"\n" - " unique=\"true|false\"\n" - " not-found=\"ignore|exception\"\n" - " entity-name=\"EntityName\"\n" - " property-ref=\"propertyNameFromAssociatedClass\"\n" - " node=\"element-name\"\n" - " embed-xml=\"true|false\"\n" - " />]]></programlisting> <calloutlist> <callout arearefs=\"manytomany1\"> <para> <literal>column</literal> (optional): The name of the element foreign key column. </para> </callout> <callout arearefs=\"manytomany2\"> <para> <literal>formula</literal> (optional): An SQL formula used to evaluate the element foreign key value. </para> </callout> <callout arearefs=\"manytomany3\"> <para> <literal>class</literal> (required): The name of the associated class. </para> </callout> <callout arearefs=\"manytomany4\"> <para> <literal>fetch</literal> (optional - defaults to <literal>join</literal>): enables outer-join or sequential select fetching for this association. This is a special case; for full eager fetching (in a single <literal>SELECT</literal>) of an entity and its many-to-many relationships to other entities, you would enable <literal>join</literal> fetching not only of the collection itself, but also with this attribute on the <literal><many-to-many></literal! > nested element. </para> </callout> <callout arearefs=\"manytomany5\"> <para> <literal>unique</literal> (optional): Enable the DDL generation of a unique constraint for the foreign-key column. This makes the association multiplicity effectively one to many. </para> </callout> <callout arearefs=\"manytomany6\"> <para> <literal>not-found</literal> (optional - defaults to <literal>exception</literal>): Specifies how foreign keys that reference missing rows will be handled: <literal>ignore</literal> will treat a missing row as a null association. </para> </callout> <callout arearefs=\"manytomany7\"> <para> <literal>entity-name</literal> (optional): The entity name of the associated class, as an alternative to <literal>class</literal>. </para> </callout> <callout arearefs=\"manytomany8\"> <para> <literal>property-ref</literal>: (optional) The name of a property of the associated class that is joined to this foreign key. If not specified, the primary key of the associated class ! is used. </para> </callout> </calloutlist> </programlistingco>" +"<programlistingco> <areaspec> <area id=\"element1b\" coords=\"2 50\"/> <area " +"id=\"element2b\" coords=\"3 50\"/> <area id=\"element3b\" coords=\"4 50\"/> " +"</areaspec> <programlisting><![CDATA[<element\n" +" column=\"column_name\"\n" +" formula=\"any SQL expression\"\n" +" type=\"typename\"\n" +" length=\"L\"\n" +" precision=\"P\"\n" +" scale=\"S\"\n" +" not-null=\"true|false\"\n" +" unique=\"true|false\"\n" +" node=\"element-name\"\n" +"/>]]></programlisting> <calloutlist> <callout arearefs=\"element1b\"> <para> " +"<literal>column</literal> (optional): The name of the column holding the " +"collection element values. </para> </callout> <callout arearefs=\"element2b" +"\"> <para> <literal>formula</literal> (optional): An SQL formula used to " +"evaluate the element. </para> </callout> <callout arearefs=\"element3b\"> " +"<para> <literal>type</literal> (required): The type of the collection " +"element. </para> </callout> </calloutlist> </programlistingco> <para> A " +"<emphasis>many-to-many association</emphasis> is specified using the " +"<literal><many-to-many></literal> element. </para> <programlistingco> " +"<areaspec> <area id=\"manytomany1\" coords=\"2 60\"/> <area id=\"manytomany2" +"\" coords=\"3 60\"/> <area id=\"manytomany3\" coords=\"4 60\"/> <area id=" +"\"manytomany4\" coords=\"5 60\"/> <area id=\"manytomany5\" coords=\"6 60\"/> " +"<area id=\"manytomany6\" coords=\"7 60\"/> <area id=\"manytomany7\" coords=" +"\"8 60\"/> <area id=\"manytomany8\" coords=\"9 60\"/> </areaspec> " +"<programlisting><![CDATA[<many-to-many\n" +" column=\"column_name\"\n" +" formula=\"any SQL expression\"\n" +" class=\"ClassName\"\n" +" fetch=\"select|join\"\n" +" unique=\"true|false\"\n" +" not-found=\"ignore|exception\"\n" +" entity-name=\"EntityName\"\n" +" property-ref=\"propertyNameFromAssociatedClass\"\n" +" node=\"element-name\"\n" +" embed-xml=\"true|false\"\n" +" />]]></programlisting> <calloutlist> <callout arearefs=\"manytomany1\"> " +"<para> <literal>column</literal> (optional): The name of the element foreign " +"key column. </para> </callout> <callout arearefs=\"manytomany2\"> <para> " +"<literal>formula</literal> (optional): An SQL formula used to evaluate the " +"element foreign key value. </para> </callout> <callout arearefs=\"manytomany3" +"\"> <para> <literal>class</literal> (required): The name of the associated " +"class. </para> </callout> <callout arearefs=\"manytomany4\"> <para> " +"<literal>fetch</literal> (optional - defaults to <literal>join</literal>): " +"enables outer-join or sequential select fetching for this association. This " +"is a special case; for full eager fetching (in a single <literal>SELECT</" +"literal>) of an entity and its many-to-many relationships to other entities, " +"you would enable <literal>join</literal> fetching not only of the collection " +"itself, but also with this attribute on the <literal><many-to-many></" +"literal> nested element. </para> </callout> <callout arearefs=\"manytomany5" +"\"> <para> <literal>unique</literal> (optional): Enable the DDL generation " +"of a unique constraint for the foreign-key column. This makes the " +"association multiplicity effectively one to many. </para> </callout> " +"<callout arearefs=\"manytomany6\"> <para> <literal>not-found</literal> " +"(optional - defaults to <literal>exception</literal>): Specifies how foreign " +"keys that reference missing rows will be handled: <literal>ignore</literal> " +"will treat a missing row as a null association. </para> </callout> <callout " +"arearefs=\"manytomany7\"> <para> <literal>entity-name</literal> (optional): " +"The entity name of the associated class, as an alternative to " +"<literal>class</literal>. </para> </callout> <callout arearefs=\"manytomany8" +"\"> <para> <literal>property-ref</literal>: (optional) The name of a " +"property of the associated class that is joined to this foreign key. If not " +"specified, the primary key of the associated class is used. </para> </" +"callout> </calloutlist> </programlistingco>" msgstr "" -#: index.docbook:480 +#. Tag: para +#: collection_mapping.xml:480 +#, no-c-format msgid "Some examples, first, a set of strings:" -msgstr "" +msgstr "Some examples, first, a set of strings:" -#: index.docbook:484 +#. Tag: programlisting +#: collection_mapping.xml:484 +#, no-c-format msgid "" - "<![CDATA[<set name=\"names\" table=\"person_names\">\n" - " <key column=\"person_id\"/>\n" - " <element column=\"person_name\" type=\"string\"/>\n" - "</set>]]>" +"<![CDATA[<set name=\"names\" table=\"person_names\">\n" +" <key column=\"person_id\"/>\n" +" <element column=\"person_name\" type=\"string\"/>\n" +"</set>]]>" msgstr "" -#: index.docbook:486 -msgid "A bag containing integers (with an iteration order determined by the <literal>order-by</literal> attribute):" +#. Tag: para +#: collection_mapping.xml:486 +#, no-c-format +msgid "" +"A bag containing integers (with an iteration order determined by the " +"<literal>order-by</literal> attribute):" msgstr "" +"A bag containing integers (with an iteration order determined by the " +"<literal>order-by</literal> attribute):" -#: index.docbook:491 +#. Tag: programlisting +#: collection_mapping.xml:491 +#, no-c-format msgid "" - "<![CDATA[<bag name=\"sizes\" \n" - " table=\"item_sizes\" \n" - " order-by=\"size asc\">\n" - " <key column=\"item_id\"/>\n" - " <element column=\"size\" type=\"integer\"/>\n" - "</bag>]]>" +"<![CDATA[<bag name=\"sizes\" \n" +" table=\"item_sizes\" \n" +" order-by=\"size asc\">\n" +" <key column=\"item_id\"/>\n" +" <element column=\"size\" type=\"integer\"/>\n" +"</bag>]]>" msgstr "" -#: index.docbook:493 +#. Tag: para +#: collection_mapping.xml:493 +#, no-c-format msgid "An array of entities - in this case, a many to many association:" -msgstr "" +msgstr "An array of entities - in this case, a many to many association:" -#: index.docbook:497 +#. Tag: programlisting +#: collection_mapping.xml:497 +#, no-c-format msgid "" - "<![CDATA[<array name=\"addresses\" \n" - " table=\"PersonAddress\" \n" - " cascade=\"persist\">\n" - " <key column=\"personId\"/>\n" - " <list-index column=\"sortOrder\"/>\n" - " <many-to-many column=\"addressId\" class=\"Address\"/>\n" - "</array>]]>" +"<![CDATA[<array name=\"addresses\" \n" +" table=\"PersonAddress\" \n" +" cascade=\"persist\">\n" +" <key column=\"personId\"/>\n" +" <list-index column=\"sortOrder\"/>\n" +" <many-to-many column=\"addressId\" class=\"Address\"/>\n" +"</array>]]>" msgstr "" -#: index.docbook:499 +#. Tag: para +#: collection_mapping.xml:499 +#, no-c-format msgid "A map from string indices to dates:" -msgstr "" +msgstr "A map from string indices to dates:" -#: index.docbook:503 +#. Tag: programlisting +#: collection_mapping.xml:503 +#, no-c-format msgid "" - "<![CDATA[<map name=\"holidays\" \n" - " table=\"holidays\" \n" - " schema=\"dbo\" \n" - " order-by=\"hol_name asc\">\n" - " <key column=\"id\"/>\n" - " <map-key column=\"hol_name\" type=\"string\"/>\n" - " <element column=\"hol_date\" type=\"date\"/>\n" - "</map>]]>" +"<![CDATA[<map name=\"holidays\" \n" +" table=\"holidays\" \n" +" schema=\"dbo\" \n" +" order-by=\"hol_name asc\">\n" +" <key column=\"id\"/>\n" +" <map-key column=\"hol_name\" type=\"string\"/>\n" +" <element column=\"hol_date\" type=\"date\"/>\n" +"</map>]]>" msgstr "" -#: index.docbook:505 +#. Tag: para +#: collection_mapping.xml:505 +#, no-c-format msgid "A list of components (discussed in the next chapter):" -msgstr "" +msgstr "A list of components (discussed in the next chapter):" -#: index.docbook:509 +#. Tag: programlisting +#: collection_mapping.xml:509 +#, no-c-format msgid "" - "<![CDATA[<list name=\"carComponents\" \n" - " table=\"CarComponents\">\n" - " <key column=\"carId\"/>\n" - " <list-index column=\"sortOrder\"/>\n" - " <composite-element class=\"CarComponent\">\n" - " <property name=\"price\"/>\n" - " <property name=\"type\"/>\n" - " <property name=\"serialNumber\" column=\"serialNum\"/>\n" - " </composite-element>\n" - "</list>]]>" +"<![CDATA[<list name=\"carComponents\" \n" +" table=\"CarComponents\">\n" +" <key column=\"carId\"/>\n" +" <list-index column=\"sortOrder\"/>\n" +" <composite-element class=\"CarComponent\">\n" +" <property name=\"price\"/>\n" +" <property name=\"type\"/>\n" +" <property name=\"serialNumber\" column=\"serialNum\"/>\n" +" </composite-element>\n" +"</list>]]>" msgstr "" -#: index.docbook:514 +#. Tag: title +#: collection_mapping.xml:514 +#, no-c-format msgid "One-to-many associations" -msgstr "" +msgstr "One-to-many associations" -#: index.docbook:516 -msgid "A <emphasis>one to many association</emphasis> links the tables of two classes via a foreign key, with no intervening collection table. This mapping loses certain semantics of normal Java collections:" +#. Tag: para +#: collection_mapping.xml:516 +#, no-c-format +msgid "" +"A <emphasis>one to many association</emphasis> links the tables of two " +"classes via a foreign key, with no intervening collection table. This " +"mapping loses certain semantics of normal Java collections:" msgstr "" +"A <emphasis>one to many association</emphasis> links the tables of two " +"classes via a foreign key, with no intervening collection table. This " +"mapping loses certain semantics of normal Java collections:" -#: index.docbook:524 -msgid "An instance of the contained entity class may not belong to more than one instance of the collection" +#. Tag: para +#: collection_mapping.xml:524 +#, no-c-format +msgid "" +"An instance of the contained entity class may not belong to more than one " +"instance of the collection" msgstr "" +"An instance of the contained entity class may not belong to more than one " +"instance of the collection" -#: index.docbook:530 -msgid "An instance of the contained entity class may not appear at more than one value of the collection index" +#. Tag: para +#: collection_mapping.xml:530 +#, no-c-format +msgid "" +"An instance of the contained entity class may not appear at more than one " +"value of the collection index" msgstr "" +"An instance of the contained entity class may not appear at more than one " +"value of the collection index" -#: index.docbook:537 -msgid "An association from <literal>Product</literal> to <literal>Part</literal> requires existence of a foreign key column and possibly an index column to the <literal>Part</literal> table. A <literal><one-to-many></literal> tag indicates that this is a one to many association." +#. Tag: para +#: collection_mapping.xml:537 +#, no-c-format +msgid "" +"An association from <literal>Product</literal> to <literal>Part</literal> " +"requires existence of a foreign key column and possibly an index column to " +"the <literal>Part</literal> table. A <literal><one-to-many></literal> " +"tag indicates that this is a one to many association." msgstr "" +"An association from <literal>Product</literal> to <literal>Part</literal> " +"requires existence of a foreign key column and possibly an index column to " +"the <literal>Part</literal> table. A <literal><one-to-many></literal> " +"tag indicates that this is a one to many association." -#: index.docbook:550 +#. Tag: programlisting +#: collection_mapping.xml:550 +#, no-c-format msgid "" - "<![CDATA[<one-to-many \n" - " class=\"ClassName\"\n" - " not-found=\"ignore|exception\"\n" - " entity-name=\"EntityName\"\n" - " node=\"element-name\"\n" - " embed-xml=\"true|false\"\n" - " />]]>" +"<![CDATA[<one-to-many \n" +" class=\"ClassName\"\n" +" not-found=\"ignore|exception\"\n" +" entity-name=\"EntityName\"\n" +" node=\"element-name\"\n" +" embed-xml=\"true|false\"\n" +" />]]>" msgstr "" -#: index.docbook:553 +#. Tag: para +#: collection_mapping.xml:553 +#, no-c-format msgid "<literal>class</literal> (required): The name of the associated class." -msgstr "" +msgstr "<literal>class</literal> (required): The name of the associated class." -#: index.docbook:558 -msgid "<literal>not-found</literal> (optional - defaults to <literal>exception</literal>): Specifies how cached identifiers that reference missing rows will be handled: <literal>ignore</literal> will treat a missing row as a null association." +#. Tag: para +#: collection_mapping.xml:558 +#, no-c-format +msgid "" +"<literal>not-found</literal> (optional - defaults to <literal>exception</" +"literal>): Specifies how cached identifiers that reference missing rows will " +"be handled: <literal>ignore</literal> will treat a missing row as a null " +"association." msgstr "" +"<literal>not-found</literal> (optional - defaults to <literal>exception</" +"literal>): Specifies how cached identifiers that reference missing rows will " +"be handled: <literal>ignore</literal> will treat a missing row as a null " +"association." -#: index.docbook:565 -msgid "<literal>entity-name</literal> (optional): The entity name of the associated class, as an alternative to <literal>class</literal>." +#. Tag: para +#: collection_mapping.xml:565 +#, no-c-format +msgid "" +"<literal>entity-name</literal> (optional): The entity name of the associated " +"class, as an alternative to <literal>class</literal>." msgstr "" +"<literal>entity-name</literal> (optional): The entity name of the associated " +"class, as an alternative to <literal>class</literal>." -#: index.docbook:573 -msgid "Notice that the <literal><one-to-many></literal> element does not need to declare any columns. Nor is it necessary to specify the <literal>table</literal> name anywhere." +#. Tag: para +#: collection_mapping.xml:573 +#, no-c-format +msgid "" +"Notice that the <literal><one-to-many></literal> element does not need " +"to declare any columns. Nor is it necessary to specify the <literal>table</" +"literal> name anywhere." msgstr "" +"Notice that the <literal><one-to-many></literal> element does not need " +"to declare any columns. Nor is it necessary to specify the <literal>table</" +"literal> name anywhere." -#: index.docbook:579 -msgid "<emphasis>Very important note:</emphasis> If the foreign key column of a <literal><one-to-many></literal> association is declared <literal>NOT NULL</literal>, you must declare the <literal><key></literal> mapping <literal>not-null=\"true\"</literal> or <emphasis>use a bidirectional association</emphasis> with the collection mapping marked <literal>inverse=\"true\"</literal>. See the discussion of bidirectional associations later in this chapter." +#. Tag: para +#: collection_mapping.xml:579 +#, no-c-format +msgid "" +"<emphasis>Very important note:</emphasis> If the foreign key column of a " +"<literal><one-to-many></literal> association is declared <literal>NOT " +"NULL</literal>, you must declare the <literal><key></literal> mapping " +"<literal>not-null=\"true\"</literal> or <emphasis>use a bidirectional " +"association</emphasis> with the collection mapping marked <literal>inverse=" +"\"true\"</literal>. See the discussion of bidirectional associations later " +"in this chapter." msgstr "" +"<emphasis>Very important note:</emphasis> If the foreign key column of a " +"<literal><one-to-many></literal> association is declared <literal>NOT " +"NULL</literal>, you must declare the <literal><key></literal> mapping " +"<literal>not-null=\"true\"</literal> or <emphasis>use a bidirectional " +"association</emphasis> with the collection mapping marked <literal>inverse=" +"\"true\"</literal>. See the discussion of bidirectional associations later " +"in this chapter." -#: index.docbook:588 -msgid "This example shows a map of <literal>Part</literal> entities by name (where <literal>partName</literal> is a persistent property of <literal>Part</literal>). Notice the use of a formula-based index." +#. Tag: para +#: collection_mapping.xml:588 +#, no-c-format +msgid "" +"This example shows a map of <literal>Part</literal> entities by name (where " +"<literal>partName</literal> is a persistent property of <literal>Part</" +"literal>). Notice the use of a formula-based index." msgstr "" +"This example shows a map of <literal>Part</literal> entities by name (where " +"<literal>partName</literal> is a persistent property of <literal>Part</" +"literal>). Notice the use of a formula-based index." -#: index.docbook:594 +#. Tag: programlisting +#: collection_mapping.xml:594 +#, no-c-format msgid "" - "<![CDATA[<map name=\"parts\"\n" - " cascade=\"all\">\n" - " <key column=\"productId\" not-null=\"true\"/>\n" - " <map-key formula=\"partName\"/>\n" - " <one-to-many class=\"Part\"/>\n" - "</map>]]>" +"<![CDATA[<map name=\"parts\"\n" +" cascade=\"all\">\n" +" <key column=\"productId\" not-null=\"true\"/>\n" +" <map-key formula=\"partName\"/>\n" +" <one-to-many class=\"Part\"/>\n" +"</map>]]>" msgstr "" -#: index.docbook:600 +#. Tag: title +#: collection_mapping.xml:600 +#, no-c-format msgid "Advanced collection mappings" -msgstr "" +msgstr "Advanced collection mappings" -#: index.docbook:603 +#. Tag: title +#: collection_mapping.xml:603 +#, no-c-format msgid "Sorted collections" -msgstr "" +msgstr "Sorted collections" -#: index.docbook:605 -msgid "Hibernate supports collections implementing <literal>java.util.SortedMap</literal> and <literal>java.util.SortedSet</literal>. You must specify a comparator in the mapping file:" +#. Tag: para +#: collection_mapping.xml:605 +#, no-c-format +msgid "" +"Hibernate supports collections implementing <literal>java.util.SortedMap</" +"literal> and <literal>java.util.SortedSet</literal>. You must specify a " +"comparator in the mapping file:" msgstr "" +"Hibernate supports collections implementing <literal>java.util.SortedMap</" +"literal> and <literal>java.util.SortedSet</literal>. You must specify a " +"comparator in the mapping file:" -#: index.docbook:610 +#. Tag: programlisting +#: collection_mapping.xml:610 +#, no-c-format msgid "" - "<![CDATA[<set name=\"aliases\" \n" - " table=\"person_aliases\" \n" - " sort=\"natural\">\n" - " <key column=\"person\"/>\n" - " <element column=\"name\" type=\"string\"/>\n" - "</set>\n" - "\n" - "<map name=\"holidays\" sort=\"my.custom.HolidayComparator\">\n" - " <key column=\"year_id\"/>\n" - " <map-key column=\"hol_name\" type=\"string\"/>\n" - " <element column=\"hol_date\" type=\"date\"/>\n" - "</map>]]>" +"<![CDATA[<set name=\"aliases\" \n" +" table=\"person_aliases\" \n" +" sort=\"natural\">\n" +" <key column=\"person\"/>\n" +" <element column=\"name\" type=\"string\"/>\n" +"</set>\n" +"\n" +"<map name=\"holidays\" sort=\"my.custom.HolidayComparator\">\n" +" <key column=\"year_id\"/>\n" +" <map-key column=\"hol_name\" type=\"string\"/>\n" +" <element column=\"hol_date\" type=\"date\"/>\n" +"</map>]]>" msgstr "" -#: index.docbook:612 -msgid "Allowed values of the <literal>sort</literal> attribute are <literal>unsorted</literal>, <literal>natural</literal> and the name of a class implementing <literal>java.util.Comparator</literal>." +#. Tag: para +#: collection_mapping.xml:612 +#, no-c-format +msgid "" +"Allowed values of the <literal>sort</literal> attribute are " +"<literal>unsorted</literal>, <literal>natural</literal> and the name of a " +"class implementing <literal>java.util.Comparator</literal>." msgstr "" +"Allowed values of the <literal>sort</literal> attribute are " +"<literal>unsorted</literal>, <literal>natural</literal> and the name of a " +"class implementing <literal>java.util.Comparator</literal>." -#: index.docbook:618 -msgid "Sorted collections actually behave like <literal>java.util.TreeSet</literal> or <literal>java.util.TreeMap</literal>." +#. Tag: para +#: collection_mapping.xml:618 +#, no-c-format +msgid "" +"Sorted collections actually behave like <literal>java.util.TreeSet</literal> " +"or <literal>java.util.TreeMap</literal>." msgstr "" +"Sorted collections actually behave like <literal>java.util.TreeSet</literal> " +"or <literal>java.util.TreeMap</literal>." -#: index.docbook:623 -msgid "If you want the database itself to order the collection elements use the <literal>order-by</literal> attribute of <literal>set</literal>, <literal>bag</literal> or <literal>map</literal> mappings. This solution is only available under JDK 1.4 or higher (it is implemented using <literal>LinkedHashSet</literal> or <literal>LinkedHashMap</literal>). This performs the ordering in the SQL query, not in memory." +#. Tag: para +#: collection_mapping.xml:623 +#, no-c-format +msgid "" +"If you want the database itself to order the collection elements use the " +"<literal>order-by</literal> attribute of <literal>set</literal>, " +"<literal>bag</literal> or <literal>map</literal> mappings. This solution is " +"only available under JDK 1.4 or higher (it is implemented using " +"<literal>LinkedHashSet</literal> or <literal>LinkedHashMap</literal>). This " +"performs the ordering in the SQL query, not in memory." msgstr "" +"If you want the database itself to order the collection elements use the " +"<literal>order-by</literal> attribute of <literal>set</literal>, " +"<literal>bag</literal> or <literal>map</literal> mappings. This solution is " +"only available under JDK 1.4 or higher (it is implemented using " +"<literal>LinkedHashSet</literal> or <literal>LinkedHashMap</literal>). This " +"performs the ordering in the SQL query, not in memory." -#: index.docbook:632 +#. Tag: programlisting +#: collection_mapping.xml:632 +#, no-c-format msgid "" - "<![CDATA[<set name=\"aliases\" table=\"person_aliases\" order-by=\"lower(name) asc\">\n" - " <key column=\"person\"/>\n" - " <element column=\"name\" type=\"string\"/>\n" - "</set>\n" - "\n" - "<map name=\"holidays\" order-by=\"hol_date, hol_name\">\n" - " <key column=\"year_id\"/>\n" - " <map-key column=\"hol_name\" type=\"string\"/>\n" - " <element column=\"hol_date type=\"date\"/>\n" - "</map>]]>" +"<![CDATA[<set name=\"aliases\" table=\"person_aliases\" order-by=\"lower" +"(name) asc\">\n" +" <key column=\"person\"/>\n" +" <element column=\"name\" type=\"string\"/>\n" +"</set>\n" +"\n" +"<map name=\"holidays\" order-by=\"hol_date, hol_name\">\n" +" <key column=\"year_id\"/>\n" +" <map-key column=\"hol_name\" type=\"string\"/>\n" +" <element column=\"hol_date type=\"date\"/>\n" +"</map>]]>" msgstr "" -#: index.docbook:634 -msgid "Note that the value of the <literal>order-by</literal> attribute is an SQL ordering, not a HQL ordering!" +#. Tag: para +#: collection_mapping.xml:634 +#, no-c-format +msgid "" +"Note that the value of the <literal>order-by</literal> attribute is an SQL " +"ordering, not a HQL ordering!" msgstr "" +"Note that the value of the <literal>order-by</literal> attribute is an SQL " +"ordering, not a HQL ordering!" -#: index.docbook:639 -msgid "Associations may even be sorted by some arbitrary criteria at runtime using a collection <literal>filter()</literal>." +#. Tag: para +#: collection_mapping.xml:639 +#, no-c-format +msgid "" +"Associations may even be sorted by some arbitrary criteria at runtime using " +"a collection <literal>filter()</literal>." msgstr "" +"Associations may even be sorted by some arbitrary criteria at runtime using " +"a collection <literal>filter()</literal>." -#: index.docbook:644 -msgid "<![CDATA[sortedUsers = s.createFilter( group.getUsers(), \"order by this.name\" ).list();]]>" +#. Tag: programlisting +#: collection_mapping.xml:644 +#, no-c-format +msgid "" +"<![CDATA[sortedUsers = s.createFilter( group.getUsers(), \"order by this.name" +"\" ).list();]]>" msgstr "" -#: index.docbook:649 +#. Tag: title +#: collection_mapping.xml:649 +#, no-c-format msgid "Bidirectional associations" -msgstr "" +msgstr "Bidirectional associations" -#: index.docbook:651 -msgid "A <emphasis>bidirectional association</emphasis> allows navigation from both \"ends\" of the association. Two kinds of bidirectional association are supported:" +#. Tag: para +#: collection_mapping.xml:651 +#, fuzzy, no-c-format +msgid "" +"A <emphasis>bidirectional association</emphasis> allows navigation from both " +"\"ends\" of the association. Two kinds of bidirectional association are " +"supported:" msgstr "" +"A <emphasis>bidirectional association</emphasis> allows navigation from both " +"\"ends\" of the association. Two kinds of bidirectional association are " +"supported: <placeholder-1/>" -#: index.docbook:658 +#. Tag: term +#: collection_mapping.xml:658 +#, no-c-format msgid "one-to-many" -msgstr "" +msgstr "one-to-many" -#: index.docbook:660 +#. Tag: para +#: collection_mapping.xml:660 +#, no-c-format msgid "set or bag valued at one end, single-valued at the other" -msgstr "" +msgstr "set or bag valued at one end, single-valued at the other" -#: index.docbook:666 +#. Tag: term +#: collection_mapping.xml:666 +#, no-c-format msgid "many-to-many" -msgstr "" +msgstr "many-to-many" -#: index.docbook:668 +#. Tag: para +#: collection_mapping.xml:668 +#, no-c-format msgid "set or bag valued at both ends" -msgstr "" +msgstr "set or bag valued at both ends" -#: index.docbook:677 -msgid "You may specify a bidirectional many-to-many association simply by mapping two many-to-many associations to the same database table and declaring one end as <emphasis>inverse</emphasis> (which one is your choice, but it can not be an indexed collection)." +#. Tag: para +#: collection_mapping.xml:677 +#, no-c-format +msgid "" +"You may specify a bidirectional many-to-many association simply by mapping " +"two many-to-many associations to the same database table and declaring one " +"end as <emphasis>inverse</emphasis> (which one is your choice, but it can " +"not be an indexed collection)." msgstr "" +"You may specify a bidirectional many-to-many association simply by mapping " +"two many-to-many associations to the same database table and declaring one " +"end as <emphasis>inverse</emphasis> (which one is your choice, but it can " +"not be an indexed collection)." -#: index.docbook:684 -msgid "Here's an example of a bidirectional many-to-many association; each category can have many items and each item can be in many categories:" +#. Tag: para +#: collection_mapping.xml:684 +#, no-c-format +msgid "" +"Here's an example of a bidirectional many-to-many association; each category " +"can have many items and each item can be in many categories:" msgstr "" +"Here's an example of a bidirectional many-to-many association; each category " +"can have many items and each item can be in many categories:" -#: index.docbook:689 +#. Tag: programlisting +#: collection_mapping.xml:689 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Category\">\n" - " <id name=\"id\" column=\"CATEGORY_ID\"/>\n" - " ...\n" - " <bag name=\"items\" table=\"CATEGORY_ITEM\">\n" - " <key column=\"CATEGORY_ID\"/>\n" - " <many-to-many class=\"Item\" column=\"ITEM_ID\"/>\n" - " </bag>\n" - "</class>\n" - "\n" - "<class name=\"Item\">\n" - " <id name=\"id\" column=\"ITEM_ID\"/>\n" - " ...\n" - "\n" - " \n" - " <bag name=\"categories\" table=\"CATEGORY_ITEM\" inverse=\"true\">\n" - " <key column=\"ITEM_ID\"/>\n" - " <many-to-many class=\"Category\" column=\"CATEGORY_ID\"/>\n" - " </bag>\n" - "</class>]]>" +"<![CDATA[<class name=\"Category\">\n" +" <id name=\"id\" column=\"CATEGORY_ID\"/>\n" +" ...\n" +" <bag name=\"items\" table=\"CATEGORY_ITEM\">\n" +" <key column=\"CATEGORY_ID\"/>\n" +" <many-to-many class=\"Item\" column=\"ITEM_ID\"/>\n" +" </bag>\n" +"</class>\n" +"\n" +"<class name=\"Item\">\n" +" <id name=\"id\" column=\"ITEM_ID\"/>\n" +" ...\n" +"\n" +" \n" +" <bag name=\"categories\" table=\"CATEGORY_ITEM\" inverse=\"true\">\n" +" <key column=\"ITEM_ID\"/>\n" +" <many-to-many class=\"Category\" column=\"CATEGORY_ID\"/>\n" +" </bag>\n" +"</class>]]>" msgstr "" -#: index.docbook:691 -msgid "Changes made only to the inverse end of the association are <emphasis>not</emphasis> persisted. This means that Hibernate has two representations in memory for every bidirectional association, one link from A to B and another link from B to A. This is easier to understand if you think about the Java object model and how we create a many-to-many relationship in Java:" +#. Tag: para +#: collection_mapping.xml:691 +#, no-c-format +msgid "" +"Changes made only to the inverse end of the association are <emphasis>not</" +"emphasis> persisted. This means that Hibernate has two representations in " +"memory for every bidirectional association, one link from A to B and another " +"link from B to A. This is easier to understand if you think about the Java " +"object model and how we create a many-to-many relationship in Java:" msgstr "" +"As mudanças feitas somente de um lado da associação <emphasis>não</emphasis> " +"são persistidas. Isto significa que o Hibernate tem duas representações na " +"memória para cada associação bidirecional, uma associação de A para B e uma " +"outra associação de B para A. Isto é mais fácil de compreender se você pensa " +"sobre o modelo do objetos do Java e como nós criamos um relacionamento " +"muitos para muitos em Java:" -#: index.docbook:699 +#. Tag: programlisting +#: collection_mapping.xml:699 +#, no-c-format msgid "" - "<![CDATA[\n" - "category.getItems().add(item); // The category now \"knows\" about the relationship\n" - "item.getCategories().add(category); // The item now \"knows\" about the relationship\n" - "\n" - "session.persist(item); // The relationship won't be saved!\n" - "session.persist(category); // The relationship will be saved]]>" +"<![CDATA[\n" +"category.getItems().add(item); // The category now \"knows\" about " +"the relationship\n" +"item.getCategories().add(category); // The item now \"knows\" about the " +"relationship\n" +"\n" +"session.persist(item); // The relationship won't be " +"saved!\n" +"session.persist(category); // The relationship will be saved]]>" msgstr "" -#: index.docbook:701 -msgid "The non-inverse side is used to save the in-memory representation to the database." +#. Tag: para +#: collection_mapping.xml:701 +#, no-c-format +msgid "" +"The non-inverse side is used to save the in-memory representation to the " +"database." msgstr "" +"A outra ponta é usada salvar a representação em memória à base de dados." -#: index.docbook:705 -msgid "You may define a bidirectional one-to-many association by mapping a one-to-many association to the same table column(s) as a many-to-one association and declaring the many-valued end <literal>inverse=\"true\"</literal>." +#. Tag: para +#: collection_mapping.xml:705 +#, no-c-format +msgid "" +"You may define a bidirectional one-to-many association by mapping a one-to-" +"many association to the same table column(s) as a many-to-one association " +"and declaring the many-valued end <literal>inverse=\"true\"</literal>." msgstr "" +"Você pode definir uma associação bidirecional um para muitos através de uma " +"associação um-para-muitos indicando as mesmas colunas da tabela que à " +"associação muitos-para-um e declarando a propriedade <literal>inverse=\"true" +"\"</literal>" -#: index.docbook:711 +#. Tag: programlisting +#: collection_mapping.xml:711 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Parent\">\n" - " <id name=\"id\" column=\"parent_id\"/>\n" - " ....\n" - " <set name=\"children\" inverse=\"true\">\n" - " <key column=\"parent_id\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </set>\n" - "</class>\n" - "\n" - "<class name=\"Child\">\n" - " <id name=\"id\" column=\"child_id\"/>\n" - " ....\n" - " <many-to-one name=\"parent\" \n" - " class=\"Parent\" \n" - " column=\"parent_id\"\n" - " not-null=\"true\"/>\n" - "</class>]]>" +"<![CDATA[<class name=\"Parent\">\n" +" <id name=\"id\" column=\"parent_id\"/>\n" +" ....\n" +" <set name=\"children\" inverse=\"true\">\n" +" <key column=\"parent_id\"/>\n" +" <one-to-many class=\"Child\"/>\n" +" </set>\n" +"</class>\n" +"\n" +"<class name=\"Child\">\n" +" <id name=\"id\" column=\"child_id\"/>\n" +" ....\n" +" <many-to-one name=\"parent\" \n" +" class=\"Parent\" \n" +" column=\"parent_id\"\n" +" not-null=\"true\"/>\n" +"</class>]]>" msgstr "" -#: index.docbook:713 -msgid "Mapping one end of an association with <literal>inverse=\"true\"</literal> doesn't affect the operation of cascades, these are orthogonal concepts!" +#. Tag: para +#: collection_mapping.xml:713 +#, no-c-format +msgid "" +"Mapping one end of an association with <literal>inverse=\"true\"</literal> " +"doesn't affect the operation of cascades, these are orthogonal concepts!" msgstr "" +"Mapear apenas uma das pontas da associação com <literal>inverse=\"true\"</" +"literal> não afeta as operações em cascata, isso é um conceito ortogonal." -#: index.docbook:721 +#. Tag: title +#: collection_mapping.xml:721 +#, no-c-format msgid "Bidirectional associations with indexed collections" -msgstr "" +msgstr "Associações bidirecionais com coleções indexadas" -#: index.docbook:722 -msgid "A bidirectional association where one end is represented as a <literal><list></literal> or <literal><map></literal> requires special consideration. If there is a property of the child class which maps to the index column, no problem, we can continue using <literal>inverse=\"true\"</literal> on the collection mapping:" +#. Tag: para +#: collection_mapping.xml:722 +#, no-c-format +msgid "" +"A bidirectional association where one end is represented as a <literal><" +"list></literal> or <literal><map></literal> requires special " +"consideration. If there is a property of the child class which maps to the " +"index column, no problem, we can continue using <literal>inverse=\"true\"</" +"literal> on the collection mapping:" msgstr "" +"Uma associação bidirecional onde uma dos lados e representa pôr uma " +"<literal><list></literal> ou <literal><map></literal> requer uma " +"consideração especial. Se houver uma propriedade da classe filha que faça o " +"mapeamento da coluna do índice, sem problema, pode-se continuar usando " +"<literal>inverse=\"true\"</literal> no mapeamento da coleção." -#: index.docbook:729 +#. Tag: programlisting +#: collection_mapping.xml:729 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Parent\">\n" - " <id name=\"id\" column=\"parent_id\"/>\n" - " ....\n" - " <map name=\"children\" inverse=\"true\">\n" - " <key column=\"parent_id\"/>\n" - " <map-key column=\"name\" \n" - " type=\"string\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </map>\n" - "</class>\n" - "\n" - "<class name=\"Child\">\n" - " <id name=\"id\" column=\"child_id\"/>\n" - " ....\n" - " <property name=\"name\" \n" - " not-null=\"true\"/>\n" - " <many-to-one name=\"parent\" \n" - " class=\"Parent\" \n" - " column=\"parent_id\"\n" - " not-null=\"true\"/>\n" - "</class>]]>" +"<![CDATA[<class name=\"Parent\">\n" +" <id name=\"id\" column=\"parent_id\"/>\n" +" ....\n" +" <map name=\"children\" inverse=\"true\">\n" +" <key column=\"parent_id\"/>\n" +" <map-key column=\"name\" \n" +" type=\"string\"/>\n" +" <one-to-many class=\"Child\"/>\n" +" </map>\n" +"</class>\n" +"\n" +"<class name=\"Child\">\n" +" <id name=\"id\" column=\"child_id\"/>\n" +" ....\n" +" <property name=\"name\" \n" +" not-null=\"true\"/>\n" +" <many-to-one name=\"parent\" \n" +" class=\"Parent\" \n" +" column=\"parent_id\"\n" +" not-null=\"true\"/>\n" +"</class>]]>" msgstr "" -#: index.docbook:731 -msgid "But, if there is no such property on the child class, we can't think of the association as truly bidirectional (there is information available at one end of the association that is not available at the other end). In this case, we can't map the collection <literal>inverse=\"true\"</literal>. Instead, we could use the following mapping:" +#. Tag: para +#: collection_mapping.xml:731 +#, no-c-format +msgid "" +"But, if there is no such property on the child class, we can't think of the " +"association as truly bidirectional (there is information available at one " +"end of the association that is not available at the other end). In this " +"case, we can't map the collection <literal>inverse=\"true\"</literal>. " +"Instead, we could use the following mapping:" msgstr "" +"Mas, se não houver nenhuma propriedade na classe filha, não podemos ver essa " +"associação como verdadeiramente bidirecional (há uma informação disponível " +"em um lado da associação que não está disponível no extremo oposto). Nesse " +"caso, nos não podemos mapear a coleção usando <literal>inverse=\"true\"</" +"literal>. Nos devemos usar o seguinte mapeamento:" -#: index.docbook:738 +#. Tag: programlisting +#: collection_mapping.xml:738 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Parent\">\n" - " <id name=\"id\" column=\"parent_id\"/>\n" - " ....\n" - " <map name=\"children\">\n" - " <key column=\"parent_id\"\n" - " not-null=\"true\"/>\n" - " <map-key column=\"name\" \n" - " type=\"string\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </map>\n" - "</class>\n" - "\n" - "<class name=\"Child\">\n" - " <id name=\"id\" column=\"child_id\"/>\n" - " ....\n" - " <many-to-one name=\"parent\" \n" - " class=\"Parent\" \n" - " column=\"parent_id\"\n" - " insert=\"false\"\n" - " update=\"false\"\n" - " not-null=\"true\"/>\n" - "</class>]]>" +"<![CDATA[<class name=\"Parent\">\n" +" <id name=\"id\" column=\"parent_id\"/>\n" +" ....\n" +" <map name=\"children\">\n" +" <key column=\"parent_id\"\n" +" not-null=\"true\"/>\n" +" <map-key column=\"name\" \n" +" type=\"string\"/>\n" +" <one-to-many class=\"Child\"/>\n" +" </map>\n" +"</class>\n" +"\n" +"<class name=\"Child\">\n" +" <id name=\"id\" column=\"child_id\"/>\n" +" ....\n" +" <many-to-one name=\"parent\" \n" +" class=\"Parent\" \n" +" column=\"parent_id\"\n" +" insert=\"false\"\n" +" update=\"false\"\n" +" not-null=\"true\"/>\n" +"</class>]]>" msgstr "" -#: index.docbook:740 -msgid "Note that in this mapping, the collection-valued end of the association is responsible for updates to the foreign key. TODO: Does this really result in some unnecessary update statements?" +#. Tag: para +#: collection_mapping.xml:740 +#, no-c-format +msgid "" +"Note that in this mapping, the collection-valued end of the association is " +"responsible for updates to the foreign key. TODO: Does this really result in " +"some unnecessary update statements?" msgstr "" +"Veja que neste mapeamento, que um dos lado da associação, a coleção, é " +"responsável pela atualização da chave estrangeira. TODO: Isso realmente " +"resulta em updates desnecessários ?." -#: index.docbook:748 +#. Tag: title +#: collection_mapping.xml:748 +#, no-c-format msgid "Ternary associations" -msgstr "" +msgstr "Associações Ternárias" -#: index.docbook:750 -msgid "There are three possible approaches to mapping a ternary association. One is to use a <literal>Map</literal> with an association as its index:" +#. Tag: para +#: collection_mapping.xml:750 +#, no-c-format +msgid "" +"There are three possible approaches to mapping a ternary association. One is " +"to use a <literal>Map</literal> with an association as its index:" msgstr "" +"Há três meios possíveis de se mapear uma associação ternária. Uma é usar um " +"<literal>Map</literal> com uma associação como seu índice:" -#: index.docbook:755 +#. Tag: programlisting +#: collection_mapping.xml:755 +#, no-c-format msgid "" - "<![CDATA[<map name=\"contracts\">\n" - " <key column=\"employer_id\" not-null=\"true\"/>\n" - " <map-key-many-to-many column=\"employee_id\" class=\"Employee\"/>\n" - " <one-to-many class=\"Contract\"/>\n" - "</map>]]>" +"<![CDATA[<map name=\"contracts\">\n" +" <key column=\"employer_id\" not-null=\"true\"/>\n" +" <map-key-many-to-many column=\"employee_id\" class=\"Employee\"/>\n" +" <one-to-many class=\"Contract\"/>\n" +"</map>]]>" msgstr "" -#: index.docbook:757 +#. Tag: programlisting +#: collection_mapping.xml:757 +#, no-c-format msgid "" - "<![CDATA[<map name=\"connections\">\n" - " <key column=\"incoming_node_id\"/>\n" - " <map-key-many-to-many column=\"outgoing_node_id\" class=\"Node\"/>\n" - " <many-to-many column=\"connection_id\" class=\"Connection\"/>\n" - "</map>]]>" +"<![CDATA[<map name=\"connections\">\n" +" <key column=\"incoming_node_id\"/>\n" +" <map-key-many-to-many column=\"outgoing_node_id\" class=\"Node\"/>\n" +" <many-to-many column=\"connection_id\" class=\"Connection\"/>\n" +"</map>]]>" msgstr "" -#: index.docbook:759 -msgid "A second approach is to simply remodel the association as an entity class. This is the approach we use most commonly." +#. Tag: para +#: collection_mapping.xml:759 +#, no-c-format +msgid "" +"A second approach is to simply remodel the association as an entity class. " +"This is the approach we use most commonly." msgstr "" +"A segunda maneira é simplesmente remodelar a associação das classes da " +"entidade. Esta é a maneira que nós usamos de uma maneira geral." -#: index.docbook:764 -msgid "A final alternative is to use composite elements, which we will discuss later." +#. Tag: para +#: collection_mapping.xml:764 +#, no-c-format +msgid "" +"A final alternative is to use composite elements, which we will discuss " +"later." msgstr "" +"Uma alternativa final é usar os elementos compostos, que nós discutiremos " +"mais tarde." -#: index.docbook:771 +#. Tag: literal +#: collection_mapping.xml:771 +#, no-c-format msgid "Using an <idbag>" -msgstr "" +msgstr "Usando o <idbag>" -#: index.docbook:773 -msgid "If you've fully embraced our view that composite keys are a bad thing and that entities should have synthetic identifiers (surrogate keys), then you might find it a bit odd that the many to many associations and collections of values that we've shown so far all map to tables with composite keys! Now, this point is quite arguable; a pure association table doesn't seem to benefit much from a surrogate key (though a collection of composite values <emphasis>might</emphasis>). Nevertheless, Hibernate provides a feature that allows you to map many to many associations and collections of values to a table with a surrogate key." +#. Tag: para +#: collection_mapping.xml:773 +#, no-c-format +msgid "" +"If you've fully embraced our view that composite keys are a bad thing and " +"that entities should have synthetic identifiers (surrogate keys), then you " +"might find it a bit odd that the many to many associations and collections " +"of values that we've shown so far all map to tables with composite keys! " +"Now, this point is quite arguable; a pure association table doesn't seem to " +"benefit much from a surrogate key (though a collection of composite values " +"<emphasis>might</emphasis>). Nevertheless, Hibernate provides a feature that " +"allows you to map many to many associations and collections of values to a " +"table with a surrogate key." msgstr "" +"Se você concorda com nossa visão que chaves compostas são uma coisa ruim e " +"que as entidades devem ter identificadores sintéticos (surrogate keys), " +"então você deve estar achando um pouco estranho que as associações muitos " +"para muitos usando coleções de valores que nós mostramos estejam mapeadas " +"com chaves compostas! Bem, este ponto é bastante discutível; um simples " +"tabela de associação não parece se beneficiar muito de uma surrogate key " +"(entretanto uma coleção de valores compostos <emphasis>sim</emphasis>). " +"Opcionalmente, o Hibernate prove uma maneira de mapear uma associação muitos " +"para muitos com uma coleção de valores para uma tabela com uma surrogate key." -#: index.docbook:784 -msgid "The <literal><idbag></literal> element lets you map a <literal>List</literal> (or <literal>Collection</literal>) with bag semantics." +#. Tag: para +#: collection_mapping.xml:784 +#, no-c-format +msgid "" +"The <literal><idbag></literal> element lets you map a <literal>List</" +"literal> (or <literal>Collection</literal>) with bag semantics." msgstr "" +"O elemento <literal><idbag></literal> permite mapear um <literal>List</" +"literal> (ou uma <literal>Collection</literal> com uma semântica de bag." -#: index.docbook:789 +#. Tag: programlisting +#: collection_mapping.xml:789 +#, no-c-format msgid "" - "<![CDATA[<idbag name=\"lovers\" table=\"LOVERS\">\n" - " <collection-id column=\"ID\" type=\"long\">\n" - " <generator class=\"sequence\"/>\n" - " </collection-id>\n" - " <key column=\"PERSON1\"/>\n" - " <many-to-many column=\"PERSON2\" class=\"Person\" fetch=\"join\"/>\n" - "</idbag>]]>" +"<![CDATA[<idbag name=\"lovers\" table=\"LOVERS\">\n" +" <collection-id column=\"ID\" type=\"long\">\n" +" <generator class=\"sequence\"/>\n" +" </collection-id>\n" +" <key column=\"PERSON1\"/>\n" +" <many-to-many column=\"PERSON2\" class=\"Person\" fetch=\"join\"/>\n" +"</idbag>]]>" msgstr "" -#: index.docbook:791 -msgid "As you can see, an <literal><idbag></literal> has a synthetic id generator, just like an entity class! A different surrogate key is assigned to each collection row. Hibernate does not provide any mechanism to discover the surrogate key value of a particular row, however." +#. Tag: para +#: collection_mapping.xml:791 +#, no-c-format +msgid "" +"As you can see, an <literal><idbag></literal> has a synthetic id " +"generator, just like an entity class! A different surrogate key is assigned " +"to each collection row. Hibernate does not provide any mechanism to discover " +"the surrogate key value of a particular row, however." msgstr "" +"Como você pode ver, um <literal><idbag></literal> possui um gerador de " +"id sintético, igual uma classe de entidade! Uma surrogate key diferente é " +"associada para cada elemento de coleção. Porém, o Hibernate não prove nenhum " +"mecanismo para descobrir qual a surrogate key de uma linha em particular." -#: index.docbook:798 -msgid "Note that the update performance of an <literal><idbag></literal> is <emphasis>much</emphasis> better than a regular <literal><bag></literal>! Hibernate can locate individual rows efficiently and update or delete them individually, just like a list, map or set." +#. Tag: para +#: collection_mapping.xml:798 +#, no-c-format +msgid "" +"Note that the update performance of an <literal><idbag></literal> is " +"<emphasis>much</emphasis> better than a regular <literal><bag></" +"literal>! Hibernate can locate individual rows efficiently and update or " +"delete them individually, just like a list, map or set." msgstr "" +"Note que o desempenho de atualização de um <literal><idbag></literal> " +"é <emphasis>much</emphasis> melhor que um <literal><bag></literal> " +"normal! O Hibernate pode localizar uma linha individual eficazmente e " +"atualizar ou deletar individualmente, como um list, map ou set." -#: index.docbook:805 -msgid "In the current implementation, the <literal>native</literal> identifier generation strategy is not supported for <literal><idbag></literal> collection identifiers." +#. Tag: para +#: collection_mapping.xml:805 +#, no-c-format +msgid "" +"In the current implementation, the <literal>native</literal> identifier " +"generation strategy is not supported for <literal><idbag></literal> " +"collection identifiers." msgstr "" +"Na implementação atual, a estratégia de geração de identificador " +"<literal>native</literal> não é suportada para identificadores de coleção " +"usando o <literal><idbag></literal>." -#: index.docbook:829 +#. Tag: title +#: collection_mapping.xml:829 +#, no-c-format msgid "Collection examples" -msgstr "" +msgstr "Exemplos de coleções" -#: index.docbook:831 -msgid "The previous sections are pretty confusing. So lets look at an example. This class:" +#. Tag: para +#: collection_mapping.xml:831 +#, no-c-format +msgid "" +"The previous sections are pretty confusing. So lets look at an example. This " +"class:" msgstr "" +"As seções anteriores são uma grande confusão. Assim sendo vejamos uma " +"exemplo. Essa classe:" -#: index.docbook:836 +#. Tag: programlisting +#: collection_mapping.xml:836 +#, no-c-format msgid "" - "<![CDATA[package eg;\n" - "import java.util.Set;\n" - "\n" - "public class Parent {\n" - " private long id;\n" - " private Set children;\n" - "\n" - " public long getId() { return id; }\n" - " private void setId(long id) { this.id=id; }\n" - "\n" - " private Set getChildren() { return children; }\n" - " private void setChildren(Set children) { this.children=children; }\n" - "\n" - " ....\n" - " ....\n" - "}]]>" +"<![CDATA[package eg;\n" +"import java.util.Set;\n" +"\n" +"public class Parent {\n" +" private long id;\n" +" private Set children;\n" +"\n" +" public long getId() { return id; }\n" +" private void setId(long id) { this.id=id; }\n" +"\n" +" private Set getChildren() { return children; }\n" +" private void setChildren(Set children) { this.children=children; }\n" +"\n" +" ....\n" +" ....\n" +"}]]>" msgstr "" -#: index.docbook:838 -msgid "has a collection of <literal>Child</literal> instances. If each child has at most one parent, the most natural mapping is a one-to-many association:" +#. Tag: para +#: collection_mapping.xml:838 +#, no-c-format +msgid "" +"has a collection of <literal>Child</literal> instances. If each child has at " +"most one parent, the most natural mapping is a one-to-many association:" msgstr "" +"tem uma coleção de instancias de <literal>Child</literal>. Se cada Child " +"tiver no máximo um parent, o mapeamento natural é uma associação um para " +"muitos:" -#: index.docbook:844 +#. Tag: programlisting +#: collection_mapping.xml:844 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"Parent\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <set name=\"children\">\n" - " <key column=\"parent_id\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </set>\n" - " </class>\n" - "\n" - " <class name=\"Child\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +"\n" +" <class name=\"Parent\">\n" +" <id name=\"id\">\n" +" <generator class=\"sequence\"/>\n" +" </id>\n" +" <set name=\"children\">\n" +" <key column=\"parent_id\"/>\n" +" <one-to-many class=\"Child\"/>\n" +" </set>\n" +" </class>\n" +"\n" +" <class name=\"Child\">\n" +" <id name=\"id\">\n" +" <generator class=\"sequence\"/>\n" +" </id>\n" +" <property name=\"name\"/>\n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" -#: index.docbook:846 +#. Tag: para +#: collection_mapping.xml:846 +#, no-c-format msgid "This maps to the following table definitions:" -msgstr "" +msgstr "Esse mapeamento gera a seguinte definição de tabelas" -#: index.docbook:850 +#. Tag: programlisting +#: collection_mapping.xml:850 +#, no-c-format msgid "" - "<![CDATA[create table parent ( id bigint not null primary key )\n" - "create table child ( id bigint not null primary key, name varchar(255), parent_id bigint )\n" - "alter table child add constraint childfk0 (parent_id) references parent]]>" +"<![CDATA[create table parent ( id bigint not null primary key )\n" +"create table child ( id bigint not null primary key, name varchar(255), " +"parent_id bigint )\n" +"alter table child add constraint childfk0 (parent_id) references parent]]>" msgstr "" -#: index.docbook:852 -msgid "If the parent is <emphasis>required</emphasis>, use a bidirectional one-to-many association:" +#. Tag: para +#: collection_mapping.xml:852 +#, no-c-format +msgid "" +"If the parent is <emphasis>required</emphasis>, use a bidirectional one-to-" +"many association:" msgstr "" +"Se o parent for <emphasis>obrigatório</emphasis>, use uma associação " +"bidirecional um para muitos:" -#: index.docbook:857 +#. Tag: programlisting +#: collection_mapping.xml:857 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"Parent\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <set name=\"children\" inverse=\"true\">\n" - " <key column=\"parent_id\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </set>\n" - " </class>\n" - "\n" - " <class name=\"Child\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " <many-to-one name=\"parent\" class=\"Parent\" column=\"parent_id\" not-null=\"true\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +"\n" +" <class name=\"Parent\">\n" +" <id name=\"id\">\n" +" <generator class=\"sequence\"/>\n" +" </id>\n" +" <set name=\"children\" inverse=\"true\">\n" +" <key column=\"parent_id\"/>\n" +" <one-to-many class=\"Child\"/>\n" +" </set>\n" +" </class>\n" +"\n" +" <class name=\"Child\">\n" +" <id name=\"id\">\n" +" <generator class=\"sequence\"/>\n" +" </id>\n" +" <property name=\"name\"/>\n" +" <many-to-one name=\"parent\" class=\"Parent\" column=\"parent_id\" " +"not-null=\"true\"/>\n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" -#: index.docbook:859 +#. Tag: para +#: collection_mapping.xml:859 +#, no-c-format msgid "Notice the <literal>NOT NULL</literal> constraint:" -msgstr "" +msgstr "Repare na constraint <literal>NOT NULL</literal>:" -#: index.docbook:863 +#. Tag: programlisting +#: collection_mapping.xml:863 +#, no-c-format msgid "" - "<![CDATA[create table parent ( id bigint not null primary key )\n" - "create table child ( id bigint not null\n" - " primary key,\n" - " name varchar(255),\n" - " parent_id bigint not null )\n" - "alter table child add constraint childfk0 (parent_id) references parent]]>" +"<![CDATA[create table parent ( id bigint not null primary key )\n" +"create table child ( id bigint not null\n" +" primary key,\n" +" name varchar(255),\n" +" parent_id bigint not null )\n" +"alter table child add constraint childfk0 (parent_id) references parent]]>" msgstr "" -#: index.docbook:865 -msgid "Alternatively, if you absolutely insist that this association should be unidirectional, you can declare the <literal>NOT NULL</literal> constraint on the <literal><key></literal> mapping:" +#. Tag: para +#: collection_mapping.xml:865 +#, no-c-format +msgid "" +"Alternatively, if you absolutely insist that this association should be " +"unidirectional, you can declare the <literal>NOT NULL</literal> constraint " +"on the <literal><key></literal> mapping:" msgstr "" +"Uma outra alternativa, no caso de você insistir que esta associação devea " +"ser unidirecional, você pode declarar a constraint como <literal>NOT NULL</" +"literal> na tag <literal><key></literal> do mapeamento:" -#: index.docbook:871 +#. Tag: programlisting +#: collection_mapping.xml:871 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"Parent\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <set name=\"children\">\n" - " <key column=\"parent_id\" not-null=\"true\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </set>\n" - " </class>\n" - "\n" - " <class name=\"Child\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +"\n" +" <class name=\"Parent\">\n" +" <id name=\"id\">\n" +" <generator class=\"sequence\"/>\n" +" </id>\n" +" <set name=\"children\">\n" +" <key column=\"parent_id\" not-null=\"true\"/>\n" +" <one-to-many class=\"Child\"/>\n" +" </set>\n" +" </class>\n" +"\n" +" <class name=\"Child\">\n" +" <id name=\"id\">\n" +" <generator class=\"sequence\"/>\n" +" </id>\n" +" <property name=\"name\"/>\n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" -#: index.docbook:873 -msgid "On the other hand, if a child might have multiple parents, a many-to-many association is appropriate:" +#. Tag: para +#: collection_mapping.xml:873 +#, no-c-format +msgid "" +"On the other hand, if a child might have multiple parents, a many-to-many " +"association is appropriate:" msgstr "" +"Por outro lado, se uma child puder ter os múltiplos parents, a associação " +"apropriada é muitos-para-muitos:" -#: index.docbook:878 +#. Tag: programlisting +#: collection_mapping.xml:878 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"Parent\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <set name=\"children\" table=\"childset\">\n" - " <key column=\"parent_id\"/>\n" - " <many-to-many class=\"Child\" column=\"child_id\"/>\n" - " </set>\n" - " </class>\n" - "\n" - " <class name=\"Child\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +"\n" +" <class name=\"Parent\">\n" +" <id name=\"id\">\n" +" <generator class=\"sequence\"/>\n" +" </id>\n" +" <set name=\"children\" table=\"childset\">\n" +" <key column=\"parent_id\"/>\n" +" <many-to-many class=\"Child\" column=\"child_id\"/>\n" +" </set>\n" +" </class>\n" +"\n" +" <class name=\"Child\">\n" +" <id name=\"id\">\n" +" <generator class=\"sequence\"/>\n" +" </id>\n" +" <property name=\"name\"/>\n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" -#: index.docbook:880 +#. Tag: para +#: collection_mapping.xml:880 +#, no-c-format msgid "Table definitions:" -msgstr "" +msgstr "Definições das tabelas:" -#: index.docbook:884 +#. Tag: programlisting +#: collection_mapping.xml:884 +#, no-c-format msgid "" - "<![CDATA[create table parent ( id bigint not null primary key )\n" - "create table child ( id bigint not null primary key, name varchar(255) )\n" - "create table childset ( parent_id bigint not null,\n" - " child_id bigint not null,\n" - " primary key ( parent_id, child_id ) )\n" - "alter table childset add constraint childsetfk0 (parent_id) references parent\n" - "alter table childset add constraint childsetfk1 (child_id) references child]]>" +"<![CDATA[create table parent ( id bigint not null primary key )\n" +"create table child ( id bigint not null primary key, name varchar(255) )\n" +"create table childset ( parent_id bigint not null,\n" +" child_id bigint not null,\n" +" primary key ( parent_id, child_id ) )\n" +"alter table childset add constraint childsetfk0 (parent_id) references " +"parent\n" +"alter table childset add constraint childsetfk1 (child_id) references child]]" +">" msgstr "" -#: index.docbook:886 -msgid "For more examples and a complete walk-through a parent/child relationship mapping, see <xref linkend=\"example-parentchild\"/>." +#. Tag: para +#: collection_mapping.xml:886 +#, no-c-format +msgid "" +"For more examples and a complete walk-through a parent/child relationship " +"mapping, see <xref linkend=\"example-parentchild\"/>." msgstr "" +"For more examples and a complete walk-through a parent/child relationship " +"mapping, see <xref linkend=\"example-parentchild\"/>. Para mais exemplos e " +"um exemplo completo de mapeamento de relacionamento de mestre/detalhe, veja " +"<xref linkend=\"example-parentchild\"/>." -#: index.docbook:891 -msgid "Even more exotic association mappings are possible, we will catalog all possibilities in the next chapter." +#. Tag: para +#: collection_mapping.xml:891 +#, no-c-format +msgid "" +"Even more exotic association mappings are possible, we will catalog all " +"possibilities in the next chapter." msgstr "" +"Até mesmo o mapeamento de associações mais exóticas são possíveis, nós " +"catalogaremos todas as possibilidades no próximo capítulo." -msgid "ROLES_OF_TRANSLATORS" -msgstr "" +#~ msgid "" +#~ "<literal>column_name</literal> (required): The name of the column holding " +#~ "the collection index values." +#~ msgstr "" +#~ "<literal>column_name</literal> (required): The name of the column holding " +#~ "the collection index values." -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "" +#~ msgid "" +#~ "<literal>base</literal> (optional, defaults to <literal>0</literal>): The " +#~ "value of the index column that corresponds to the first element of the " +#~ "list or array." +#~ msgstr "" +#~ "<literal>base</literal> (optional, defaults to <literal>0</literal>): The " +#~ "value of the index column that corresponds to the first element of the " +#~ "list or array." +#~ msgid "" +#~ "<literal>column</literal> (optional): The name of the column holding the " +#~ "collection index values." +#~ msgstr "" +#~ "<literal>column</literal> (optional): The name of the column holding the " +#~ "collection index values." + +#~ msgid "" +#~ "<literal>formula</literal> (optional): A SQL formula used to evaluate the " +#~ "key of the map." +#~ msgstr "" +#~ "<literal>formula</literal> (optional): A SQL formula used to evaluate the " +#~ "key of the map." + +#~ msgid "<literal>type</literal> (reguired): The type of the map keys." +#~ msgstr "<literal>type</literal> (reguired): The type of the map keys." + +#~ msgid "" +#~ "<literal>column</literal> (optional): The name of the foreign key column " +#~ "for the collection index values." +#~ msgstr "" +#~ "<literal>column</literal> (optional): The name of the foreign key column " +#~ "for the collection index values." + +#~ msgid "" +#~ "<literal>formula</literal> (optional): A SQL formula used to evaluate the " +#~ "foreign key of the map key." +#~ msgstr "" +#~ "<literal>formula</literal> (optional): A SQL formula used to evaluate the " +#~ "foreign key of the map key." + +#~ msgid "" +#~ "<literal>class</literal> (required): The entity class used as the map key." +#~ msgstr "" +#~ "<literal>class</literal> (required): The entity class used as the map key." + +#~ msgid "" +#~ "<literal>column</literal> (optional): The name of the column holding the " +#~ "collection element values." +#~ msgstr "" +#~ "<literal>column</literal> (optional): The name of the column holding the " +#~ "collection element values." + +#~ msgid "" +#~ "<literal>formula</literal> (optional): An SQL formula used to evaluate " +#~ "the element." +#~ msgstr "" +#~ "<literal>formula</literal> (optional): An SQL formula used to evaluate " +#~ "the element." + +#~ msgid "" +#~ "<literal>type</literal> (required): The type of the collection element." +#~ msgstr "" +#~ "<literal>type</literal> (required): The type of the collection element." + +#~ msgid "" +#~ "A <emphasis>many-to-many association</emphasis> is specified using the " +#~ "<literal><many-to-many></literal> element." +#~ msgstr "" +#~ "A <emphasis>many-to-many association</emphasis> is specified using the " +#~ "<literal><many-to-many></literal> element." + +#~ msgid "" +#~ "<literal>column</literal> (optional): The name of the element foreign key " +#~ "column." +#~ msgstr "" +#~ "<literal>column</literal> (optional): The name of the element foreign key " +#~ "column." + +#~ msgid "" +#~ "<literal>formula</literal> (optional): An SQL formula used to evaluate " +#~ "the element foreign key value." +#~ msgstr "" +#~ "<literal>formula</literal> (optional): An SQL formula used to evaluate " +#~ "the element foreign key value." + +#~ msgid "" +#~ "<literal>fetch</literal> (optional - defaults to <literal>join</" +#~ "literal>): enables outer-join or sequential select fetching for this " +#~ "association. This is a special case; for full eager fetching (in a single " +#~ "<literal>SELECT</literal>) of an entity and its many-to-many " +#~ "relationships to other entities, you would enable <literal>join</literal> " +#~ "fetching not only of the collection itself, but also with this attribute " +#~ "on the <literal><many-to-many></literal> nested element." +#~ msgstr "" +#~ "<literal>fetch</literal> (optional - defaults to <literal>join</" +#~ "literal>): enables outer-join or sequential select fetching for this " +#~ "association. This is a special case; for full eager fetching (in a single " +#~ "<literal>SELECT</literal>) of an entity and its many-to-many " +#~ "relationships to other entities, you would enable <literal>join</literal> " +#~ "fetching not only of the collection itself, but also with this attribute " +#~ "on the <literal><many-to-many></literal> nested element." + +#~ msgid "" +#~ "<literal>unique</literal> (optional): Enable the DDL generation of a " +#~ "unique constraint for the foreign-key column. This makes the association " +#~ "multiplicity effectively one to many." +#~ msgstr "" +#~ "<literal>unique</literal> (optional): Enable the DDL generation of a " +#~ "unique constraint for the foreign-key column. This makes the association " +#~ "multiplicity effectively one to many." + +#~ msgid "" +#~ "<literal>not-found</literal> (optional - defaults to <literal>exception</" +#~ "literal>): Specifies how foreign keys that reference missing rows will be " +#~ "handled: <literal>ignore</literal> will treat a missing row as a null " +#~ "association." +#~ msgstr "" +#~ "<literal>not-found</literal> (optional - defaults to <literal>exception</" +#~ "literal>): Specifies how foreign keys that reference missing rows will be " +#~ "handled: <literal>ignore</literal> will treat a missing row as a null " +#~ "association." + +#~ msgid "" +#~ "<literal>property-ref</literal>: (optional) The name of a property of the " +#~ "associated class that is joined to this foreign key. If not specified, " +#~ "the primary key of the associated class is used." +#~ msgstr "" +#~ "<literal>property-ref</literal>: (optional) The name of a property of the " +#~ "associated class that is joined to this foreign key. If not specified, " +#~ "the primary key of the associated class is used." Modified: core/trunk/documentation/manual/translations/pt-BR/content/component_mapping.po =================================================================== --- core/trunk/documentation/manual/translations/pt-BR/content/component_mapping.po 2007-10-25 22:34:46 UTC (rev 14134) +++ core/trunk/documentation/manual/translations/pt-BR/content/component_mapping.po 2007-10-26 00:46:38 UTC (rev 14135) @@ -1,372 +1,685 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: component_mapping.xml:5 +#, no-c-format msgid "Component Mapping" -msgstr "" +msgstr "Mapeamento de Componentes" -#: index.docbook:7 -msgid "The notion of a <emphasis>component</emphasis> is re-used in several different contexts, for different purposes, throughout Hibernate." +#. Tag: para +#: component_mapping.xml:7 +#, no-c-format +msgid "" +"The notion of a <emphasis>component</emphasis> is re-used in several " +"different contexts, for different purposes, throughout Hibernate." msgstr "" +"A noção de <emphasis>componente</emphasis> é reusada em vários contextos " +"diferentes, para propósitos diferentes, pelo Hibernate." -#: index.docbook:13 +#. Tag: title +#: component_mapping.xml:13 +#, no-c-format msgid "Dependent objects" -msgstr "" +msgstr "Objetos dependentes" -#: index.docbook:15 -msgid "A component is a contained object that is persisted as a value type, not an entity reference. The term \"component\" refers to the object-oriented notion of composition (not to architecture-level components). For example, you might model a person like this:" +#. Tag: para +#: component_mapping.xml:15 +#, no-c-format +msgid "" +"A component is a contained object that is persisted as a value type, not an " +"entity reference. The term \"component\" refers to the object-oriented " +"notion of composition (not to architecture-level components). For example, " +"you might model a person like this:" msgstr "" +"Um componente é um objeto contido que é persistido como um tipo de valor, " +"não uma referência de entidade. O termo \"componente\" refere-se à noção de " +"composição da orientação a objetos (não a componentes no nível de " +"arquitetura). Por exemplo, você pode modelar uma pessoa desta maneira:" -#: index.docbook:21 +#. Tag: programlisting +#: component_mapping.xml:21 +#, no-c-format msgid "" - "<![CDATA[public class Person {\n" - " private java.util.Date birthday;\n" - " private Name name;\n" - " private String key;\n" - " public String getKey() {\n" - " return key;\n" - " }\n" - " private void setKey(String key) {\n" - " this.key=key;\n" - " }\n" - " public java.util.Date getBirthday() {\n" - " return birthday;\n" - " }\n" - " public void setBirthday(java.util.Date birthday) {\n" - " this.birthday = birthday;\n" - " }\n" - " public Name getName() {\n" - " return name;\n" - " }\n" - " public void setName(Name name) {\n" - " this.name = name;\n" - " }\n" - " ......\n" - " ......\n" - "}]]>" +"<![CDATA[public class Person {\n" +" private java.util.Date birthday;\n" +" private Name name;\n" +" private String key;\n" +" public String getKey() {\n" +" return key;\n" +" }\n" +" private void setKey(String key) {\n" +" this.key=key;\n" +" }\n" +" public java.util.Date getBirthday() {\n" +" return birthday;\n" +" }\n" +" public void setBirthday(java.util.Date birthday) {\n" +" this.birthday = birthday;\n" +" }\n" +" public Name getName() {\n" +" return name;\n" +" }\n" +" public void setName(Name name) {\n" +" this.name = name;\n" +" }\n" +" ......\n" +" ......\n" +"}]]>" msgstr "" -#: index.docbook:23 +#. Tag: programlisting +#: component_mapping.xml:23 +#, no-c-format msgid "" - "<![CDATA[public class Name {\n" - " char initial;\n" - " String first;\n" - " String last;\n" - " public String getFirst() {\n" - " return first;\n" - " }\n" - " void setFirst(String first) {\n" - " this.first = first;\n" - " }\n" - " public String getLast() {\n" - " return last;\n" - " }\n" - " void setLast(String last) {\n" - " this.last = last;\n" - " }\n" - " public char getInitial() {\n" - " return initial;\n" - " }\n" - " void setInitial(char initial) {\n" - " this.initial = initial;\n" - " }\n" - "}]]>" +"<![CDATA[public class Name {\n" +" char initial;\n" +" String first;\n" +" String last;\n" +" public String getFirst() {\n" +" return first;\n" +" }\n" +" void setFirst(String first) {\n" +" this.first = first;\n" +" }\n" +" public String getLast() {\n" +" return last;\n" +" }\n" +" void setLast(String last) {\n" +" this.last = last;\n" +" }\n" +" public char getInitial() {\n" +" return initial;\n" +" }\n" +" void setInitial(char initial) {\n" +" this.initial = initial;\n" +" }\n" +"}]]>" msgstr "" -#: index.docbook:25 -msgid "Now <literal>Name</literal> may be persisted as a component of <literal>Person</literal>. Notice that <literal>Name</literal> defines getter and setter methods for its persistent properties, but doesn't need to declare any interfaces or identifier properties." +#. Tag: para +#: component_mapping.xml:25 +#, no-c-format +msgid "" +"Now <literal>Name</literal> may be persisted as a component of " +"<literal>Person</literal>. Notice that <literal>Name</literal> defines " +"getter and setter methods for its persistent properties, but doesn't need to " +"declare any interfaces or identifier properties." msgstr "" +"Agora <literal>Name</literal> pode ser persistido como um componente de " +"<literal>Person</literal>. Note que <literal>Name</literal> define métodos " +"getter e setter para suas propriedades persistentes, mas não necessita " +"declarar nenhuma interface ou propriedades identificadoras." -#: index.docbook:32 +#. Tag: para +#: component_mapping.xml:32 +#, no-c-format msgid "Our Hibernate mapping would look like:" -msgstr "" +msgstr "Nosso mapeamento do Hibernate seria semelhante a isso" -#: index.docbook:36 +#. Tag: programlisting +#: component_mapping.xml:36 +#, no-c-format msgid "" - "<![CDATA[<class name=\"eg.Person\" table=\"person\">\n" - " <id name=\"Key\" column=\"pid\" type=\"string\">\n" - " <generator class=\"uuid\"/>\n" - " </id>\n" - " <property name=\"birthday\" type=\"date\"/>\n" - " <component name=\"Name\" class=\"eg.Name\"> \n" - " <property name=\"initial\"/>\n" - " <property name=\"first\"/>\n" - " <property name=\"last\"/>\n" - " </component>\n" - "</class>]]>" +"<![CDATA[<class name=\"eg.Person\" table=\"person\">\n" +" <id name=\"Key\" column=\"pid\" type=\"string\">\n" +" <generator class=\"uuid\"/>\n" +" </id>\n" +" <property name=\"birthday\" type=\"date\"/>\n" +" <component name=\"Name\" class=\"eg.Name\"> \n" +" <property name=\"initial\"/>\n" +" <property name=\"first\"/>\n" +" <property name=\"last\"/>\n" +" </component>\n" +"</class>]]>" msgstr "" -#: index.docbook:38 -msgid "The person table would have the columns <literal>pid</literal>, <literal>birthday</literal>, <literal>initial</literal>, <literal>first</literal> and <literal>last</literal>." +#. Tag: para +#: component_mapping.xml:38 +#, no-c-format +msgid "" +"The person table would have the columns <literal>pid</literal>, " +"<literal>birthday</literal>, <literal>initial</literal>, <literal>first</" +"literal> and <literal>last</literal>." msgstr "" +"A tabela pessoa teria as seguintes colunas <literal>pid</literal>, " +"<literal>birthday</literal>, <literal>initial</literal>, <literal>first</" +"literal> and <literal>last</literal>." -#: index.docbook:46 -msgid "Like all value types, components do not support shared references. In other words, two persons could have the same name, but the two person objects would contain two independent name ojects, only \"the same\" by value. The null value semantics of a component are <emphasis>ad hoc</emphasis>. When reloading the containing object, Hibernate will assume that if all component columns are null, then the entire component is null. This should be okay for most purposes." +#. Tag: para +#: component_mapping.xml:46 +#, no-c-format +msgid "" +"Like all value types, components do not support shared references. In other " +"words, two persons could have the same name, but the two person objects " +"would contain two independent name ojects, only \"the same\" by value. The " +"null value semantics of a component are <emphasis>ad hoc</emphasis>. When " +"reloading the containing object, Hibernate will assume that if all component " +"columns are null, then the entire component is null. This should be okay for " +"most purposes." msgstr "" +"Assim como todos tipos por valor, componentes não suportam referencias " +"cruzadas. Em outras palavras, duas pessoas poderiam possuir o mesmo nome, " +"mas os dois objetos pessoa poderiam conter dois objetos nome independentes, " +"apenas com \"o mesmo\" por valor. A semântica dos valores null de um " +"componente são <emphasis>ad hoc</emphasis>. No recarregameno do conteúdo do " +"objeto, O Hibernate assumira que se todas as colunas do componente são null, " +"então todo o componente é null. Isto seria o certo para a maioria dos " +"propósitos." -#: index.docbook:55 -msgid "The properties of a component may be of any Hibernate type (collections, many-to-one associations, other components, etc). Nested components should <emphasis>not</emphasis> be considered an exotic usage. Hibernate is intended to support a very fine-grained object model." +#. Tag: para +#: component_mapping.xml:55 +#, no-c-format +msgid "" +"The properties of a component may be of any Hibernate type (collections, " +"many-to-one associations, other components, etc). Nested components should " +"<emphasis>not</emphasis> be considered an exotic usage. Hibernate is " +"intended to support a very fine-grained object model." msgstr "" +"As propriedades de um componente podem ser de qualquer tipo do Hibernate" +"(collections, associações muitos-para-um, outros componentes, etc). " +"Componentes agrupados <emphasis>não </emphasis> devem ser consideros um uso " +"exótico. O Hibernate tem a intenção de suportar um modelo de objetos muito " +"bem granulado." -#: index.docbook:62 -msgid "The <literal><component></literal> element allows a <literal><parent></literal> subelement that maps a property of the component class as a reference back to the containing entity." +#. Tag: para +#: component_mapping.xml:62 +#, no-c-format +msgid "" +"The <literal><component></literal> element allows a <literal><" +"parent></literal> subelement that maps a property of the component class " +"as a reference back to the containing entity." msgstr "" +"O elemento <literal><component></literal> permite um subelemento " +"<literal><parent></literal> que mapeia uma propriedade da classe " +"componente como uma referência de volta para a entidade que a contém." -#: index.docbook:68 +#. Tag: programlisting +#: component_mapping.xml:68 +#, no-c-format msgid "" - "<![CDATA[<class name=\"eg.Person\" table=\"person\">\n" - " <id name=\"Key\" column=\"pid\" type=\"string\">\n" - " <generator class=\"uuid\"/>\n" - " </id>\n" - " <property name=\"birthday\" type=\"date\"/>\n" - " <component name=\"Name\" class=\"eg.Name\" unique=\"true\">\n" - " <parent name=\"namedPerson\"/> \n" - " <property name=\"initial\"/>\n" - " <property name=\"first\"/>\n" - " <property name=\"last\"/>\n" - " </component>\n" - "</class>]]>" +"<![CDATA[<class name=\"eg.Person\" table=\"person\">\n" +" <id name=\"Key\" column=\"pid\" type=\"string\">\n" +" <generator class=\"uuid\"/>\n" +" </id>\n" +" <property name=\"birthday\" type=\"date\"/>\n" +" <component name=\"Name\" class=\"eg.Name\" unique=\"true\">\n" +" <parent name=\"namedPerson\"/> \n" - " <property name=\"initial\"/>\n" - " <property name=\"first\"/>\n" - " <property name=\"last\"/>\n" - " </composite-element>\n" - "</set>]]>" +"<![CDATA[<set name=\"someNames\" table=\"some_names\" lazy=\"true\">\n" +" <key column=\"id\"/>\n" +" <composite-element class=\"eg.Name\"> \n" +" <property name=\"initial\"/>\n" +" <property name=\"first\"/>\n" +" <property name=\"last\"/>\n" +" </composite-element>\n" +"</set>]]>" msgstr "" -#: index.docbook:84 -msgid "Note: if you define a <literal>Set</literal> of composite elements, it is very important to implement <literal>equals()</literal> and <literal>hashCode()</literal> correctly." +#. Tag: para +#: component_mapping.xml:84 +#, no-c-format +msgid "" +"Note: if you define a <literal>Set</literal> of composite elements, it is " +"very important to implement <literal>equals()</literal> and <literal>hashCode" +"()</literal> correctly." msgstr "" +"Nota: se você definir um <literal>Set</literal> de elementos compostos, é " +"muito importante implementar <literal>equals()</literal> e <literal>hashCode" +"()</literal> corretamente." -#: index.docbook:90 -msgid "Composite elements may contain components but not collections. If your composite element itself contains components, use the <literal><nested-composite-element></literal> tag. This is a pretty exotic case - a collection of components which themselves have components. By this stage you should be asking yourself if a one-to-many association is more appropriate. Try remodelling the composite element as an entity - but note that even though the Java model is the same, the relational model and persistence semantics are still slightly different." +#. Tag: para +#: component_mapping.xml:90 +#, no-c-format +msgid "" +"Composite elements may contain components but not collections. If your " +"composite element itself contains components, use the <literal><nested-" +"composite-element></literal> tag. This is a pretty exotic case - a " +"collection of components which themselves have components. By this stage you " +"should be asking yourself if a one-to-many association is more appropriate. " +"Try remodelling the composite element as an entity - but note that even " +"though the Java model is the same, the relational model and persistence " +"semantics are still slightly different." msgstr "" +"Elementos compostos podem conter componentes mas não collections. Se o seu " +"elemento composto contiver componentes , use a tag <literal><nested-" +"composite-element></literal> . Este é um caso bastante exótico – uma " +"collections de componentes que por si própria possui componentes. Neste " +"momento você deve estar se perguntando se uma associação de um-para-muitos " +"seria mais apropriada. Tente remodelar o elemento composto como uma entidade " +"– mas note que mesmo pensando que o modelo Java é o mesmo, o modelo " +"relacional e a semântica de persistência ainda são diferentes." -#: index.docbook:102 -msgid "Please note that a composite element mapping doesn't support null-able properties if you're using a <literal><set></literal>. Hibernate has to use each columns value to identify a record when deleting objects (there is no separate primary key column in the composite element table), which is not possible with null values. You have to either use only not-null properties in a composite-element or choose a <literal><list></literal>, <literal><map></literal>, <literal><bag></literal> or <literal><idbag></literal>." +#. Tag: para +#: component_mapping.xml:102 +#, no-c-format +msgid "" +"Please note that a composite element mapping doesn't support null-able " +"properties if you're using a <literal><set></literal>. Hibernate has " +"to use each columns value to identify a record when deleting objects (there " +"is no separate primary key column in the composite element table), which is " +"not possible with null values. You have to either use only not-null " +"properties in a composite-element or choose a <literal><list></" +"literal>, <literal><map></literal>, <literal><bag></literal> or " +"<literal><idbag></literal>." msgstr "" +"Por favor, note que um mapeamento de elemento composto não suporta " +"propriedades capazes de serem null se você estiver usando um <literal><" +"set></literal>. O Hibernate tem que usar cada valor das colunas para " +"identificar um registro quando estiver deletando objetos (não existe coluna " +"chave primária separada na tabela de elemento composto), que não é possível " +"com valores null. Você tem que usar um dos dois, ou apenas propriedades não " +"null em um elemento composto ou escolher uma <literal><list></" +"literal>, <literal><map></literal>, <literal><bag></literal> ou " +"<literal><idbag></literal>." -#: index.docbook:113 -msgid "A special case of a composite element is a composite element with a nested <literal><many-to-one></literal> element. A mapping like this allows you to map extra columns of a many-to-many association table to the composite element class. The following is a many-to-many association from <literal>Order</literal> to <literal>Item</literal> where <literal>purchaseDate</literal>, <literal>price</literal> and <literal>quantity</literal> are properties of the association:" +#. Tag: para +#: component_mapping.xml:113 +#, no-c-format +msgid "" +"A special case of a composite element is a composite element with a nested " +"<literal><many-to-one></literal> element. A mapping like this allows " +"you to map extra columns of a many-to-many association table to the " +"composite element class. The following is a many-to-many association from " +"<literal>Order</literal> to <literal>Item</literal> where " +"<literal>purchaseDate</literal>, <literal>price</literal> and " +"<literal>quantity</literal> are properties of the association:" msgstr "" +"Um caso especial de elemento composto é um elemento composto com um elemento " +"<literal><many-to-one></literal> aninhado. Um mapeamento como este " +"permite você a mapear colunas extras de uma tabela de associação de muitos-" +"para-muitos para a classe de elemento composto. A seguinte associação de " +"muitos-para-muitos de <literal>Order</literal> para um <literal>Item</" +"literal> onde <literal>purchaseDate</literal>, <literal>price</literal> e " +"<literal>quantity</literal> são propriedades da associação:" -#: index.docbook:123 +#. Tag: programlisting +#: component_mapping.xml:123 +#, no-c-format msgid "" - "<![CDATA[<class name=\"eg.Order\" .... >\n" - " ....\n" - " <set name=\"purchasedItems\" table=\"purchase_items\" lazy=\"true\">\n" - " <key column=\"order_id\">\n" - " <composite-element class=\"eg.Purchase\">\n" - " <property name=\"purchaseDate\"/>\n" - " <property name=\"price\"/>\n" - " <property name=\"quantity\"/>\n" - " <many-to-one name=\"item\" class=\"eg.Item\"/> \n" - " </composite-element>\n" - " </set>\n" - "</class>]]>" +"<![CDATA[<class name=\"eg.Order\" .... >\n" +" ....\n" +" <set name=\"purchasedItems\" table=\"purchase_items\" lazy=\"true\">\n" +" <key column=\"order_id\">\n" +" <composite-element class=\"eg.Purchase\">\n" +" <property name=\"purchaseDate\"/>\n" +" <property name=\"price\"/>\n" +" <property name=\"quantity\"/>\n" +" <many-to-one name=\"item\" class=\"eg.Item\"/> \n" +" </composite-element>\n" +" </set>\n" +"</class>]]>" msgstr "" -#: index.docbook:125 -msgid "Of course, there can't be a reference to the purchae on the other side, for bidirectional association navigation. Remember that components are value types and don't allow shared references. A single <literal>Purchase</literal> can be in the set of an <literal>Order</literal>, but it can't be referenced by the <literal>Item</literal> at the same time." +#. Tag: para +#: component_mapping.xml:125 +#, no-c-format +msgid "" +"Of course, there can't be a reference to the purchae on the other side, for " +"bidirectional association navigation. Remember that components are value " +"types and don't allow shared references. A single <literal>Purchase</" +"literal> can be in the set of an <literal>Order</literal>, but it can't be " +"referenced by the <literal>Item</literal> at the same time." msgstr "" +"Claro, que não pode ter uma referência para purchase no outro lado, para a " +"navegação da associação bidirecional. Lembre-se que componentes são tipos " +"por valor e não permitem referências compartilhadas. Uma classe " +"<literal>Purchase</literal> simples pode estar no set de uma classe " +"<literal>Order</literal>, mas ela não pode ser referenciada por " +"<literal>Item</literal> no mesmo momento." -#: index.docbook:133 +#. Tag: para +#: component_mapping.xml:133 +#, no-c-format msgid "Even ternary (or quaternary, etc) associations are possible:" -msgstr "" +msgstr "Até mesmo associações ternárias (ou quaternária, etc) são possíveis:" -#: index.docbook:135 +#. Tag: programlisting +#: component_mapping.xml:135 +#, no-c-format msgid "" - "<![CDATA[<class name=\"eg.Order\" .... >\n" - " ....\n" - " <set name=\"purchasedItems\" table=\"purchase_items\" lazy=\"true\">\n" - " <key column=\"order_id\">\n" - " <composite-element class=\"eg.OrderLine\">\n" - " <many-to-one name=\"purchaseDetails class=\"eg.Purchase\"/>\n" - " <many-to-one name=\"item\" class=\"eg.Item\"/>\n" - " </composite-element>\n" - " </set>\n" - "</class>]]>" +"<![CDATA[<class name=\"eg.Order\" .... >\n" +" ....\n" +" <set name=\"purchasedItems\" table=\"purchase_items\" lazy=\"true\">\n" +" <key column=\"order_id\">\n" +" <composite-element class=\"eg.OrderLine\">\n" +" <many-to-one name=\"purchaseDetails class=\"eg.Purchase\"/>\n" +" <many-to-one name=\"item\" class=\"eg.Item\"/>\n" +" </composite-element>\n" +" </set>\n" +"</class>]]>" msgstr "" -#: index.docbook:137 -msgid "Composite elements may appear in queries using the same syntax as associations to other entities." +#. Tag: para +#: component_mapping.xml:137 +#, no-c-format +msgid "" +"Composite elements may appear in queries using the same syntax as " +"associations to other entities." msgstr "" +"Elementos compostos podem aparecer em pesquisas usando a mesma sintaxe assim " +"como associações para outras entidades." -#: index.docbook:145 +#. Tag: title +#: component_mapping.xml:145 +#, no-c-format msgid "Components as Map indices" -msgstr "" +msgstr "Componentes como índices de Map" -#: index.docbook:147 -msgid "The <literal><composite-map-key></literal> element lets you map a component class as the key of a <literal>Map</literal>. Make sure you override <literal>hashCode()</literal> and <literal>equals()</literal> correctly on the component class." +#. Tag: para +#: component_mapping.xml:147 +#, no-c-format +msgid "" +"The <literal><composite-map-key></literal> element lets you map a " +"component class as the key of a <literal>Map</literal>. Make sure you " +"override <literal>hashCode()</literal> and <literal>equals()</literal> " +"correctly on the component class." msgstr "" +"O elemento <literal><composite-map-key></literal> permite você mapear " +"uma classe componente como uma chave de um <literal>Map</literal>. Tenha " +"certeza que você sobrescreveu <literal>hashCode()</literal> e <literal>equals" +"()</literal> corretamente na classe componente." -#: index.docbook:156 +#. Tag: title +#: component_mapping.xml:156 +#, no-c-format msgid "Components as composite identifiers" -msgstr "" +msgstr ". Componentes como identificadores compostos" -#: index.docbook:158 -msgid "You may use a component as an identifier of an entity class. Your component class must satisfy certain requirements:" +#. Tag: para +#: component_mapping.xml:158 +#, no-c-format +msgid "" +"You may use a component as an identifier of an entity class. Your component " +"class must satisfy certain requirements:" msgstr "" +"Você pode usar um componente como um identificador de uma classe entidade. " +"Sua classe componente deve satisfazer certos requisitos:" -#: index.docbook:165 +#. Tag: para +#: component_mapping.xml:165 +#, no-c-format msgid "It must implement <literal>java.io.Serializable</literal>." -msgstr "" +msgstr "Ele deve implementar <literal>java.io.Serializable</literal>." -#: index.docbook:170 -msgid "It must re-implement <literal>equals()</literal> and <literal>hashCode()</literal>, consistently with the database's notion of composite key equality." +#. Tag: para +#: component_mapping.xml:170 +#, no-c-format +msgid "" +"It must re-implement <literal>equals()</literal> and <literal>hashCode()</" +"literal>, consistently with the database's notion of composite key equality." msgstr "" +"Ele deve re-implementar <literal>equals()</literal> e <literal>hashCode()</" +"literal>, consistentemente com a noção de igualdade de chave composta do " +"banco de dados." -#: index.docbook:179 -msgid "Note: in Hibernate3, the second requirement is not an absolutely hard requirement of Hibernate. But do it anyway." +#. Tag: emphasis +#: component_mapping.xml:179 +#, no-c-format +msgid "" +"Note: in Hibernate3, the second requirement is not an absolutely hard " +"requirement of Hibernate. But do it anyway." msgstr "" +"Nota: no Hibernate 3, o segundo requisito não é um requisito absolutamente " +"necessário. Mas atenda ele de qualquer forma." -#: index.docbook:183 -msgid "You can't use an <literal>IdentifierGenerator</literal> to generate composite keys. Instead the application must assign its own identifiers." +#. Tag: para +#: component_mapping.xml:183 +#, no-c-format +msgid "" +"You can't use an <literal>IdentifierGenerator</literal> to generate " +"composite keys. Instead the application must assign its own identifiers." msgstr "" +"Você não pode usar um <literal>IdentifierGenerator</literal> para gerar " +"chaves compostas. Ao invés disso o aplicativo deve gerenciar seus próprios " +"identificadores." -#: index.docbook:188 -msgid "Use the <literal><composite-id></literal> tag (with nested <literal><key-property></literal> elements) in place of the usual <literal><id></literal> declaration. For example, the <literal>OrderLine</literal> class has a primary key that depends upon the (composite) primary key of <literal>Order</literal>." +#. Tag: para +#: component_mapping.xml:188 +#, no-c-format +msgid "" +"Use the <literal><composite-id></literal> tag (with nested " +"<literal><key-property></literal> elements) in place of the usual " +"<literal><id></literal> declaration. For example, the " +"<literal>OrderLine</literal> class has a primary key that depends upon the " +"(composite) primary key of <literal>Order</literal>." msgstr "" +"Use a tag <literal><composite-id></literal> (com elementos " +"<literal><key-property></literal> aninhados) no lugar da declaração " +"<literal><id></literal> de costume. Por exemplo, a classe " +"<literal>OrderLine</literal> possui uma chave primária que depende da chave " +"primária (composta) de <literal>Order</literal>." -#: index.docbook:196 +#. Tag: programlisting +#: component_mapping.xml:196 +#, no-c-format msgid "" - "<![CDATA[<class name=\"OrderLine\">\n" - " \n" - " <composite-id name=\"id\" class=\"OrderLineId\">\n" - " <key-property name=\"lineId\"/>\n" - " <key-property name=\"orderId\"/>\n" - " <key-property name=\"customerId\"/>\n" - " </composite-id>\n" - " \n" - " <property name=\"name\"/>\n" - " \n" - " <many-to-one name=\"order\" class=\"Order\"\n" - " insert=\"false\" update=\"false\">\n" - " <column name=\"orderId\"/>\n" - " <column name=\"customerId\"/>\n" - " </many-to-one>\n" - " ....\n" - " \n" - "</class>]]>" +"<![CDATA[<class name=\"OrderLine\">\n" +" \n" +" <composite-id name=\"id\" class=\"OrderLineId\">\n" +" <key-property name=\"lineId\"/>\n" +" <key-property name=\"orderId\"/>\n" +" <key-property name=\"customerId\"/>\n" +" </composite-id>\n" +" \n" +" <property name=\"name\"/>\n" +" \n" +" <many-to-one name=\"order\" class=\"Order\"\n" +" insert=\"false\" update=\"false\">\n" +" <column name=\"orderId\"/>\n" +" <column name=\"customerId\"/>\n" +" </many-to-one>\n" +" ....\n" +" \n" +"</class>]]>" msgstr "" -#: index.docbook:198 -msgid "Now, any foreign keys referencing the <literal>OrderLine</literal> table are also composite. You must declare this in your mappings for other classes. An association to <literal>OrderLine</literal> would be mapped like this:" +#. Tag: para +#: component_mapping.xml:198 +#, no-c-format +msgid "" +"Now, any foreign keys referencing the <literal>OrderLine</literal> table are " +"also composite. You must declare this in your mappings for other classes. An " +"association to <literal>OrderLine</literal> would be mapped like this:" msgstr "" +"Agora, qualquer chave estrangeira referenciando a tabela <literal>OrderLine</" +"literal> também serão compostas. Você deve declarar isto em seus mapeamentos " +"para outras classes. Uma associação para <literal>OrderLine</literal> seria " +"mapeada dessa forma:" -#: index.docbook:204 +#. Tag: programlisting +#: component_mapping.xml:204 +#, no-c-format msgid "" - "<![CDATA[<many-to-one name=\"orderLine\" class=\"OrderLine\">\n" - "\n" - " <column name=\"lineId\"/>\n" - " <column name=\"orderId\"/>\n" - " <column name=\"customerId\"/>\n" - "</many-to-one>]]>" +"<![CDATA[<many-to-one name=\"orderLine\" class=\"OrderLine\">\n" +"\n" +" <column name=\"lineId\"/>\n" +" <column name=\"orderId\"/>\n" +" <column name=\"customerId\"/>\n" +"</many-to-one>]]>" msgstr "" -#: index.docbook:206 -msgid "(Note that the <literal><column></literal> tag is an alternative to the <literal>column</literal> attribute everywhere.)" +#. Tag: para +#: component_mapping.xml:206 +#, no-c-format +msgid "" +"(Note that the <literal><column></literal> tag is an alternative to " +"the <literal>column</literal> attribute everywhere.)" msgstr "" +"(Note que a tag <literal><column></literal> é uma alternativa para o " +"atributo <literal>column</literal> por toda a parte.)" -#: index.docbook:211 -msgid "A <literal>many-to-many</literal> association to <literal>OrderLine</literal> also uses the composite foreign key:" +#. Tag: para +#: component_mapping.xml:211 +#, no-c-format +msgid "" +"A <literal>many-to-many</literal> association to <literal>OrderLine</" +"literal> also uses the composite foreign key:" msgstr "" +"Uma associação <literal>many-to-many</literal> para <literal>many-to-many</" +"literal> também usa a chave estrangeira composta:" -#: index.docbook:216 +#. Tag: programlisting +#: component_mapping.xml:216 +#, no-c-format msgid "" - "<![CDATA[<set name=\"undeliveredOrderLines\">\n" - " <key column name=\"warehouseId\"/>\n" - " <many-to-many class=\"OrderLine\">\n" - " <column name=\"lineId\"/>\n" - " <column name=\"orderId\"/>\n" - " <column name=\"customerId\"/>\n" - " </many-to-many>\n" - "</set>]]>" +"<![CDATA[<set name=\"undeliveredOrderLines\">\n" +" <key column name=\"warehouseId\"/>\n" +" <many-to-many class=\"OrderLine\">\n" +" <column name=\"lineId\"/>\n" +" <column name=\"orderId\"/>\n" +" <column name=\"customerId\"/>\n" +" </many-to-many>\n" +"</set>]]>" msgstr "" -#: index.docbook:218 -msgid "The collection of <literal>OrderLine</literal>s in <literal>Order</literal> would use:" +#. Tag: para +#: component_mapping.xml:218 +#, no-c-format +msgid "" +"The collection of <literal>OrderLine</literal>s in <literal>Order</literal> " +"would use:" msgstr "" +"A collection de <literal>OrderLine</literal>s em <literal>Order</literal> " +"usaria:" -#: index.docbook:223 +#. Tag: programlisting +#: component_mapping.xml:223 +#, no-c-format msgid "" - "<![CDATA[<set name=\"orderLines\" inverse=\"true\">\n" - " <key>\n" - " <column name=\"orderId\"/>\n" - " <column name=\"customerId\"/>\n" - " </key>\n" - " <one-to-many class=\"OrderLine\"/>\n" - "</set>]]>" +"<![CDATA[<set name=\"orderLines\" inverse=\"true\">\n" +" <key>\n" +" <column name=\"orderId\"/>\n" +" <column name=\"customerId\"/>\n" +" </key>\n" +" <one-to-many class=\"OrderLine\"/>\n" +"</set>]]>" msgstr "" -#: index.docbook:225 -msgid "(The <literal><one-to-many></literal> element, as usual, declares no columns.)" +#. Tag: para +#: component_mapping.xml:225 +#, no-c-format +msgid "" +"(The <literal><one-to-many></literal> element, as usual, declares no " +"columns.)" msgstr "" +"(O elemento <literal><one-to-many></literal>, como de costume, não " +"declara colunas.)" -#: index.docbook:229 -msgid "If <literal>OrderLine</literal> itself owns a collection, it also has a composite foreign key." +#. Tag: para +#: component_mapping.xml:229 +#, no-c-format +msgid "" +"If <literal>OrderLine</literal> itself owns a collection, it also has a " +"composite foreign key." msgstr "" +"Se <literal>OrderLine</literal> possui uma collection, ela também tem uma " +"chave estrangeira composta." -#: index.docbook:234 +#. Tag: programlisting +#: component_mapping.xml:234 +#, no-c-format msgid "" - "<![CDATA[<class name=\"OrderLine\">\n" - " ....\n" - " ....\n" - " <list name=\"deliveryAttempts\">\n" - " <key> \n" - " <column name=\"lineId\"/>\n" - " <column name=\"orderId\"/>\n" - " <column name=\"customerId\"/>\n" - " </key>\n" - " <list-index column=\"attemptId\" base=\"1\"/>\n" - " <composite-element class=\"DeliveryAttempt\">\n" - " ...\n" - " </composite-element>\n" - " </set>\n" - "</class>]]>" +"<![CDATA[<class name=\"OrderLine\">\n" +" ....\n" +" ....\n" +" <list name=\"deliveryAttempts\">\n" +" <key> \n" +" <column name=\"lineId\"/>\n" +" <column name=\"orderId\"/>\n" +" <column name=\"customerId\"/>\n" +" </key>\n" +" <list-index column=\"attemptId\" base=\"1\"/>\n" +" <composite-element class=\"DeliveryAttempt\">\n" +" ...\n" +" </composite-element>\n" +" </set>\n" +"</class>]]>" msgstr "" -#: index.docbook:239 +#. Tag: title +#: component_mapping.xml:239 +#, no-c-format msgid "Dynamic components" -msgstr "" +msgstr "Componentes Dinâmicos" -#: index.docbook:241 +#. Tag: para +#: component_mapping.xml:241 +#, no-c-format msgid "You may even map a property of type <literal>Map</literal>:" msgstr "" +"Você pode até mesmo mapear uma propriedade do tipo <literal>Map</literal>:" -#: index.docbook:245 +#. Tag: programlisting +#: component_mapping.xml:245 +#, no-c-format msgid "" - "<![CDATA[<dynamic-component name=\"userAttributes\">\n" - " <property name=\"foo\" column=\"FOO\" type=\"string\"/>\n" - " <property name=\"bar\" column=\"BAR\" type=\"integer\"/>\n" - " <many-to-one name=\"baz\" class=\"Baz\" column=\"BAZ_ID\"/>\n" - "</dynamic-component>]]>" +"<![CDATA[<dynamic-component name=\"userAttributes\">\n" +" <property name=\"foo\" column=\"FOO\" type=\"string\"/>\n" +" <property name=\"bar\" column=\"BAR\" type=\"integer\"/>\n" +" <many-to-one name=\"baz\" class=\"Baz\" column=\"BAZ_ID\"/>\n" +"</dynamic-component>]]>" msgstr "" -#: index.docbook:247 -msgid "The semantics of a <literal><dynamic-component></literal> mapping are identical to <literal><component></literal>. The advantage of this kind of mapping is the ability to determine the actual properties of the bean at deployment time, just by editing the mapping document. Runtime manipulation of the mapping document is also possible, using a DOM parser. Even better, you can access (and change) Hibernate's configuration-time metamodel via the <literal>Configuration</literal> object." +#. Tag: para +#: component_mapping.xml:247 +#, no-c-format +msgid "" +"The semantics of a <literal><dynamic-component></literal> mapping are " +"identical to <literal><component></literal>. The advantage of this " +"kind of mapping is the ability to determine the actual properties of the " +"bean at deployment time, just by editing the mapping document. Runtime " +"manipulation of the mapping document is also possible, using a DOM parser. " +"Even better, you can access (and change) Hibernate's configuration-time " +"metamodel via the <literal>Configuration</literal> object." msgstr "" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "" - +"A semântica de um mapeamento <literal><dynamic-component></literal> é " +"idêntica à <literal><component></literal>. A vantagem deste tipo de " +"mapeamento é a habilidade de determinar as propriedades atuais do bean no " +"momento de deploy, apenas editando o documento de mapeamento. A Manipulação " +"em tempo de execução do documento de mapeamento também é possível, usando o " +"parser DOM. Até melhor, você pode acessar (e mudar) o metamodelo " +"configuration-time do Hibernate através do objeto <literal>Configuration</" +"literal>." Modified: core/trunk/documentation/manual/translations/pt-BR/content/configuration.po =================================================================== --- core/trunk/documentation/manual/translations/pt-BR/content/configuration.po 2007-10-25 22:34:46 UTC (rev 14134) +++ core/trunk/documentation/manual/translations/pt-BR/content/configuration.po 2007-10-26 00:46:38 UTC (rev 14135) @@ -1,1489 +1,3888 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: configuration.xml:5 +#, no-c-format msgid "Configuration" -msgstr "" +msgstr "Configuração" -#: index.docbook:7 -msgid "Because Hibernate is designed to operate in many different environments, there are a large number of configuration parameters. Fortunately, most have sensible default values and Hibernate is distributed with an example <literal>hibernate.properties</literal> file in <literal>etc/</literal> that shows the various options. Just put the example file in your classpath and customize it." +#. Tag: para +#: configuration.xml:7 +#, no-c-format +msgid "" +"Because Hibernate is designed to operate in many different environments, " +"there are a large number of configuration parameters. Fortunately, most have " +"sensible default values and Hibernate is distributed with an example " +"<literal>hibernate.properties</literal> file in <literal>etc/</literal> that " +"shows the various options. Just put the example file in your classpath and " +"customize it." msgstr "" +"Devido ao fato de o Hibernate ser projetado para operar em vários ambientes " +"diferentes, há um grande número de parâmetros de configuração. Felizmente, a " +"maioria tem valores default lógicos e o Hibernate é distribuído com um " +"arquivo <literal>hibernate.properties</literal> de exemplo no <literal>etc/</" +"literal> que mostra várias opções. Apenas coloque o arquivo de exemplo no " +"seu classpath e personalize-o." -#: index.docbook:16 +#. Tag: title +#: configuration.xml:16 +#, no-c-format msgid "Programmatic configuration" -msgstr "" +msgstr "1.11 Configuração programática" -#: index.docbook:18 -msgid "An instance of <literal>org.hibernate.cfg.Configuration</literal> represents an entire set of mappings of an application's Java types to an SQL database. The <literal>Configuration</literal> is used to build an (immutable) <literal>SessionFactory</literal>. The mappings are compiled from various XML mapping files." +#. Tag: para +#: configuration.xml:18 +#, no-c-format +msgid "" +"An instance of <literal>org.hibernate.cfg.Configuration</literal> represents " +"an entire set of mappings of an application's Java types to an SQL database. " +"The <literal>Configuration</literal> is used to build an (immutable) " +"<literal>SessionFactory</literal>. The mappings are compiled from various " +"XML mapping files." msgstr "" +"Uma instância de <literal>org.hibernate.cfg.Configuration</literal> " +"representa um conjunto inteiro de mapeamentos de tipos Java da aplicação " +"para um banco de dados SQL. O <literal>Configuration</literal> é usado para " +"construir uma <literal>SessionFactory</literal> (imutável). Os mapeamentos " +"são compilados a partir de arquivos de mapeamento XML." -#: index.docbook:26 -msgid "You may obtain a <literal>Configuration</literal> instance by instantiating it directly and specifying XML mapping documents. If the mapping files are in the classpath, use <literal>addResource()</literal>:" +#. Tag: para +#: configuration.xml:26 +#, no-c-format +msgid "" +"You may obtain a <literal>Configuration</literal> instance by instantiating " +"it directly and specifying XML mapping documents. If the mapping files are " +"in the classpath, use <literal>addResource()</literal>:" msgstr "" +"Você pode obter uma instância <literal>Configuration</literal> intanciando- " +"o diretamente e especificando documentos de mapeamento XML. Se o arquivo de " +"mapeamento estão no classpath, use use <literal>addResource()</literal>:" -#: index.docbook:32 +#. Tag: programlisting +#: configuration.xml:32 +#, no-c-format msgid "" - "<![CDATA[Configuration cfg = new Configuration()\n" - " .addResource(\"Item.hbm.xml\")\n" - " .addResource(\"Bid.hbm.xml\");]]>" +"<![CDATA[Configuration cfg = new Configuration()\n" +" .addResource(\"Item.hbm.xml\")\n" +" .addResource(\"Bid.hbm.xml\");]]>" msgstr "" -#: index.docbook:34 -msgid "An alternative (sometimes better) way is to specify the mapped class, and let Hibernate find the mapping document for you:" +#. Tag: para +#: configuration.xml:34 +#, no-c-format +msgid "" +"An alternative (sometimes better) way is to specify the mapped class, and " +"let Hibernate find the mapping document for you:" msgstr "" +"Uma alternativa (às vezes melhor) é especificar a classe mapeada, e permitir " +"que o Hibernate encontre o documento de mapeamento para você:" -#: index.docbook:39 +#. Tag: programlisting +#: configuration.xml:39 +#, no-c-format msgid "" - "<![CDATA[Configuration cfg = new Configuration()\n" - " .addClass(org.hibernate.auction.Item.class)\n" - " .addClass(org.hibernate.auction.Bid.class);]]>" +"<![CDATA[Configuration cfg = new Configuration()\n" +" .addClass(org.hibernate.auction.Item.class)\n" +" .addClass(org.hibernate.auction.Bid.class);]]>" msgstr "" -#: index.docbook:41 -msgid "Then Hibernate will look for mapping files named <literal>/org/hibernate/auction/Item.hbm.xml</literal> and <literal>/org/hibernate/auction/Bid.hbm.xml</literal> in the classpath. This approach eliminates any hardcoded filenames." +#. Tag: para +#: configuration.xml:41 +#, no-c-format +msgid "" +"Then Hibernate will look for mapping files named <literal>/org/hibernate/" +"auction/Item.hbm.xml</literal> and <literal>/org/hibernate/auction/Bid.hbm." +"xml</literal> in the classpath. This approach eliminates any hardcoded " +"filenames." msgstr "" +"Então o Hibernate procurará pelos arquivos de mapeamento chamados <literal>/" +"org/hibernate/auction/Item.hbm.xml</literal> e <literal>/org/hibernate/" +"auction/Bid.hbm.xml</literal> no classpath. Esta abordagem elimina qualquer " +"nome de arquivo de difícil compreensão." -#: index.docbook:48 -msgid "A <literal>Configuration</literal> also allows you to specify configuration properties:" +#. Tag: para +#: configuration.xml:48 +#, no-c-format +msgid "" +"A <literal>Configuration</literal> also allows you to specify configuration " +"properties:" msgstr "" +"Uma <literal>Configuration</literal> também permite você especificar " +"propriedades de configuração:" -#: index.docbook:53 +#. Tag: programlisting +#: configuration.xml:53 +#, no-c-format msgid "" - "<![CDATA[Configuration cfg = new Configuration()\n" - " .addClass(org.hibernate.auction.Item.class)\n" - " .addClass(org.hibernate.auction.Bid.class)\n" - " .setProperty(\"hibernate.dialect\", \"org.hibernate.dialect.MySQLInnoDBDialect\")\n" - " .setProperty(\"hibernate.connection.datasource\", \"java:comp/env/jdbc/test\")\n" - " .setProperty(\"hibernate.order_updates\", \"true\");]]>" +"<![CDATA[Configuration cfg = new Configuration()\n" +" .addClass(org.hibernate.auction.Item.class)\n" +" .addClass(org.hibernate.auction.Bid.class)\n" +" .setProperty(\"hibernate.dialect\", \"org.hibernate.dialect." +"MySQLInnoDBDialect\")\n" +" .setProperty(\"hibernate.connection.datasource\", \"java:comp/env/jdbc/" +"test\")\n" +" .setProperty(\"hibernate.order_updates\", \"true\");]]>" msgstr "" -#: index.docbook:55 -msgid "This is not the only way to pass configuration properties to Hibernate. The various options include:" +#. Tag: para +#: configuration.xml:55 +#, no-c-format +msgid "" +"This is not the only way to pass configuration properties to Hibernate. The " +"various options include:" msgstr "" +"Este não é o único caminho para passar as propriedades de configuração para " +"o Hibernate. As várias opções incluem:" -#: index.docbook:62 -msgid "Pass an instance of <literal>java.util.Properties</literal> to <literal>Configuration.setProperties()</literal>." +#. Tag: para +#: configuration.xml:62 +#, no-c-format +msgid "" +"Pass an instance of <literal>java.util.Properties</literal> to " +"<literal>Configuration.setProperties()</literal>." msgstr "" +"Passar uma instância de <literal>java.util.Properties</literal> para " +"<literal>Configuration.setProperties()</literal>." -#: index.docbook:68 -msgid "Place <literal>hibernate.properties</literal> in a root directory of the classpath." +#. Tag: para +#: configuration.xml:68 +#, no-c-format +msgid "" +"Place <literal>hibernate.properties</literal> in a root directory of the " +"classpath." msgstr "" +"Colocar <literal>hibernate.properties</literal> no diretório raiz do " +"classpath." -#: index.docbook:74 -msgid "Set <literal>System</literal> properties using <literal>java -Dproperty=value</literal>." +#. Tag: para +#: configuration.xml:74 +#, no-c-format +msgid "" +"Set <literal>System</literal> properties using <literal>java -" +"Dproperty=value</literal>." msgstr "" +"Determinar as propriedades do <literal>System</literal> usando <literal>java " +"-Dproperty=value</literal>." -#: index.docbook:80 -msgid "Include <literal><property></literal> elements in <literal>hibernate.cfg.xml</literal> (discussed later)." +#. Tag: para +#: configuration.xml:80 +#, no-c-format +msgid "" +"Include <literal><property></literal> elements in <literal>hibernate." +"cfg.xml</literal> (discussed later)." msgstr "" +"Include <literal><property></literal> elements in <literal>hibernate." +"cfg.xml</literal> (discussed later). Incluir elementos <literal><" +"property></literal> no <literal>hibernate.cfg.xml</literal> (discutido " +"mais tarde)." -#: index.docbook:87 -msgid "<literal>hibernate.properties</literal> is the easiest approach if you want to get started quickly." +#. Tag: para +#: configuration.xml:87 +#, no-c-format +msgid "" +"<literal>hibernate.properties</literal> is the easiest approach if you want " +"to get started quickly." msgstr "" +"<literal>hibernate.properties</literal> é o caminho mais facil se você quer " +"começar mais rápido." -#: index.docbook:92 -msgid "The <literal>Configuration</literal> is intended as a startup-time object, to be discarded once a <literal>SessionFactory</literal> is created." +#. Tag: para +#: configuration.xml:92 +#, no-c-format +msgid "" +"The <literal>Configuration</literal> is intended as a startup-time object, " +"to be discarded once a <literal>SessionFactory</literal> is created." msgstr "" +"O <literal>Configuration</literal> é entendido como um objeto startup-time, " +"é descartado uma vez que a <literal>SessionFactory</literal> é criada." -#: index.docbook:100 +#. Tag: title +#: configuration.xml:100 +#, no-c-format msgid "Obtaining a SessionFactory" -msgstr "" +msgstr "Obtendo uma SessionFactory" -#: index.docbook:102 -msgid "When all mappings have been parsed by the <literal>Configuration</literal>, the application must obtain a factory for <literal>Session</literal> instances. This factory is intended to be shared by all application threads:" +#. Tag: para +#: configuration.xml:102 +#, no-c-format +msgid "" +"When all mappings have been parsed by the <literal>Configuration</literal>, " +"the application must obtain a factory for <literal>Session</literal> " +"instances. This factory is intended to be shared by all application threads:" msgstr "" +"Quando todos os mapeamentos têm sido analisados pelo <literal>Configuration</" +"literal>, a aplicação deve obter uma factory para as instâncias da " +"<literal>Session</literal>. O objetivo desta factory é ser compartilhado por " +"todas as threads da aplicação:" -#: index.docbook:108 +#. Tag: programlisting +#: configuration.xml:108 +#, no-c-format msgid "<![CDATA[SessionFactory sessions = cfg.buildSessionFactory();]]>" msgstr "" -#: index.docbook:110 -msgid "Hibernate does allow your application to instantiate more than one <literal>SessionFactory</literal>. This is useful if you are using more than one database." +#. Tag: para +#: configuration.xml:110 +#, no-c-format +msgid "" +"Hibernate does allow your application to instantiate more than one " +"<literal>SessionFactory</literal>. This is useful if you are using more than " +"one database." msgstr "" +"Hibernate permite sua aplicação instanciar mais do que uma " +"<literal>SessionFactory</literal>. Isto é útil se você está usando mais do " +"que um banco de dados." -#: index.docbook:119 +#. Tag: title +#: configuration.xml:119 +#, no-c-format msgid "JDBC connections" -msgstr "" +msgstr "Conexões JDBC" -#: index.docbook:121 -msgid "Usually, you want to have the <literal>SessionFactory</literal> create and pool JDBC connections for you. If you take this approach, opening a <literal>Session</literal> is as simple as:" +#. Tag: para +#: configuration.xml:121 +#, no-c-format +msgid "" +"Usually, you want to have the <literal>SessionFactory</literal> create and " +"pool JDBC connections for you. If you take this approach, opening a " +"<literal>Session</literal> is as simple as:" msgstr "" +"Normalmente, você quer mandar criar a <literal>SessionFactory</literal> " +"criar um pool de conexões JDBC para você. Se você seguir essa abordagem, a " +"abertura de uma <literal>Session</literal> é tão simples quanto:" -#: index.docbook:127 -msgid "<![CDATA[Session session = sessions.openSession(); // open a new Session]]>" +#. Tag: programlisting +#: configuration.xml:127 +#, no-c-format +msgid "" +"<![CDATA[Session session = sessions.openSession(); // open a new Session]]>" msgstr "" -#: index.docbook:129 -msgid "As soon as you do something that requires access to the database, a JDBC connection will be obtained from the pool." +#. Tag: para +#: configuration.xml:129 +#, no-c-format +msgid "" +"As soon as you do something that requires access to the database, a JDBC " +"connection will be obtained from the pool." msgstr "" +"Assim que você fizer algo que requer o acesso ao banco de dados, uma conexão " +"JDBC será obtida do pool." -#: index.docbook:134 -msgid "For this to work, we need to pass some JDBC connection properties to Hibernate. All Hibernate property names and semantics are defined on the class <literal>org.hibernate.cfg.Environment</literal>. We will now describe the most important settings for JDBC connection configuration." +#. Tag: para +#: configuration.xml:134 +#, no-c-format +msgid "" +"For this to work, we need to pass some JDBC connection properties to " +"Hibernate. All Hibernate property names and semantics are defined on the " +"class <literal>org.hibernate.cfg.Environment</literal>. We will now describe " +"the most important settings for JDBC connection configuration." msgstr "" +"Para esse trabalho, nós necessitamos passar algumas propriedades da conexão " +"JDBC para o Hibernate. Todos os nomes de propriedades Hibernate e semânticas " +"são definidas <literal>org.hibernate.cfg.Environment</literal>. Nós iremos " +"descrever agora o mais importantes configurações de conexão JDBC." -#: index.docbook:141 -msgid "Hibernate will obtain (and pool) connections using <literal>java.sql.DriverManager</literal> if you set the following properties:" +#. Tag: para +#: configuration.xml:141 +#, no-c-format +msgid "" +"Hibernate will obtain (and pool) connections using <literal>java.sql." +"DriverManager</literal> if you set the following properties:" msgstr "" +"O Hibernate obterá conexões( e pool) usando <literal>java.sql.DriverManager</" +"literal> se você determinar as seguintes propriedades:" -#: index.docbook:147 +#. Tag: title +#: configuration.xml:147 +#, no-c-format msgid "Hibernate JDBC Properties" -msgstr "" +msgstr "Propriedades JDBC Hibernate" -#: index.docbook:153, index.docbook:241, index.docbook:338, index.docbook:529, index.docbook:725, index.docbook:832, index.docbook:920 +#. Tag: entry +#: configuration.xml:153 configuration.xml:241 configuration.xml:338 +#: configuration.xml:529 configuration.xml:725 configuration.xml:832 +#: configuration.xml:920 +#, no-c-format msgid "Property name" -msgstr "" +msgstr "Nome da Propriedade" -#: index.docbook:154, index.docbook:242, index.docbook:339, index.docbook:530, index.docbook:726, index.docbook:833, index.docbook:921 +#. Tag: entry +#: configuration.xml:154 configuration.xml:242 configuration.xml:339 +#: configuration.xml:530 configuration.xml:726 configuration.xml:833 +#: configuration.xml:921 +#, no-c-format msgid "Purpose" -msgstr "" +msgstr "Propósito" -#: index.docbook:160 +#. Tag: literal +#: configuration.xml:160 +#, no-c-format msgid "hibernate.connection.driver_class" -msgstr "" +msgstr "hibernate.connection.driver_class" -#: index.docbook:163 +#. Tag: emphasis +#: configuration.xml:163 +#, no-c-format msgid "JDBC driver class" -msgstr "" +msgstr "Classe driver jdbc" -#: index.docbook:168 +#. Tag: literal +#: configuration.xml:168 +#, no-c-format msgid "hibernate.connection.url" -msgstr "" +msgstr "hibernate.connection.url" -#: index.docbook:171 +#. Tag: emphasis +#: configuration.xml:171 +#, no-c-format msgid "JDBC URL" -msgstr "" +msgstr "URL jdbc" -#: index.docbook:176, index.docbook:272 +#. Tag: literal +#: configuration.xml:176 configuration.xml:272 +#, no-c-format msgid "hibernate.connection.username" -msgstr "" +msgstr "hibernate.connection.username" -#: index.docbook:179 +#. Tag: emphasis +#: configuration.xml:179 +#, no-c-format msgid "database user" -msgstr "" +msgstr "Usuário do banco de dados" -#: index.docbook:184, index.docbook:280 +#. Tag: literal +#: configuration.xml:184 configuration.xml:280 +#, no-c-format msgid "hibernate.connection.password" -msgstr "" +msgstr "hibernate.connection.password" -#: index.docbook:187 +#. Tag: emphasis +#: configuration.xml:187 +#, no-c-format msgid "database user password" -msgstr "" +msgstr "Senha do usuário do banco de dados" -#: index.docbook:192 +#. Tag: literal +#: configuration.xml:192 +#, no-c-format msgid "hibernate.connection.pool_size" -msgstr "" +msgstr "hibernate.connection.pool_size" -#: index.docbook:195 +#. Tag: emphasis +#: configuration.xml:195 +#, no-c-format msgid "maximum number of pooled connections" -msgstr "" +msgstr "Número máximo de connecxões no pool" -#: index.docbook:202 -msgid "Hibernate's own connection pooling algorithm is however quite rudimentary. It is intended to help you get started and is <emphasis>not intended for use in a production system</emphasis> or even for performance testing. You should use a third party pool for best performance and stability. Just replace the <literal>hibernate.connection.pool_size</literal> property with connection pool specific settings. This will turn off Hibernate's internal pool. For example, you might like to use C3P0." +#. Tag: para +#: configuration.xml:202 +#, no-c-format +msgid "" +"Hibernate's own connection pooling algorithm is however quite rudimentary. " +"It is intended to help you get started and is <emphasis>not intended for use " +"in a production system</emphasis> or even for performance testing. You " +"should use a third party pool for best performance and stability. Just " +"replace the <literal>hibernate.connection.pool_size</literal> property with " +"connection pool specific settings. This will turn off Hibernate's internal " +"pool. For example, you might like to use C3P0." msgstr "" +"O algoritmo de pool de conexões do próprio Hibernate entretanto é " +"completamente rudimentar. A intenção dele e ajudar a iniciar e <emphasis>não " +"para usar em um sistema de produção</emphasis> ou até para testar " +"desempenho. Você deveria usar uma ferramente de pool de terceiros para " +"conseguir melhor desempenho e estabilidade. Apenas especifique a propriedade " +"<literal>hibernate.connection.pool_size</literal> com a definição do pool de " +"conexões. Isto irá desligar o pool interno do Hibernate. Por exemplo, você " +"pode gostar de usar C3P0." -#: index.docbook:212 -msgid "C3P0 is an open source JDBC connection pool distributed along with Hibernate in the <literal>lib</literal> directory. Hibernate will use its <literal>C3P0ConnectionProvider</literal> for connection pooling if you set <literal>hibernate.c3p0.*</literal> properties. If you'd like to use Proxool refer to the packaged <literal>hibernate.properties</literal> and the Hibernate web site for more information." +#. Tag: para +#: configuration.xml:212 +#, no-c-format +msgid "" +"C3P0 is an open source JDBC connection pool distributed along with Hibernate " +"in the <literal>lib</literal> directory. Hibernate will use its " +"<literal>C3P0ConnectionProvider</literal> for connection pooling if you set " +"<literal>hibernate.c3p0.*</literal> properties. If you'd like to use Proxool " +"refer to the packaged <literal>hibernate.properties</literal> and the " +"Hibernate web site for more information." msgstr "" +"O C3P0 é um pool conexão JDBC de código aberto distribuído junto com " +"Hibernate no diretório <literal>lib</literal>. O Hibernate usará o " +"<literal>C3P0ConnectionProvider</literal> para o pool de conexão se você " +"configurar a propriedade <literal>hibernate.c3p0.*</literal>. Se você gostar " +"de usar Proxool consulte ao pacote <literal>hibernate.properties</literal> e " +"o web site do Hibernate para mais informações." -#: index.docbook:221 -msgid "Here is an example <literal>hibernate.properties</literal> file for C3P0:" +#. Tag: para +#: configuration.xml:221 +#, no-c-format +msgid "" +"Here is an example <literal>hibernate.properties</literal> file for C3P0:" msgstr "" +"Aqui é um exemplo de arquivo <literal>hibernate.properties</literal> para " +"C3P0:" -#: index.docbook:225 +#. Tag: programlisting +#: configuration.xml:225 +#, no-c-format msgid "" - "<![CDATA[hibernate.connection.driver_class = org.postgresql.Driver\n" - "hibernate.connection.url = jdbc:postgresql://localhost/mydatabase\n" - "hibernate.connection.username = myuser\n" - "hibernate.connection.password = secret\n" - "hibernate.c3p0.min_size=5\n" - "hibernate.c3p0.max_size=20\n" - "hibernate.c3p0.timeout=1800\n" - "hibernate.c3p0.max_statements=50\n" - "hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect]]>" +"<![CDATA[hibernate.connection.driver_class = org.postgresql.Driver\n" +"hibernate.connection.url = jdbc:postgresql://localhost/mydatabase\n" +"hibernate.connection.username = myuser\n" +"hibernate.connection.password = secret\n" +"hibernate.c3p0.min_size=5\n" +"hibernate.c3p0.max_size=20\n" +"hibernate.c3p0.timeout=1800\n" +"hibernate.c3p0.max_statements=50\n" +"hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect]]>" msgstr "" -#: index.docbook:227 -msgid "For use inside an application server, you should almost always configure Hibernate to obtain connections from an application server <literal>Datasource</literal> registered in JNDI. You'll need to set at least one of the following properties:" +#. Tag: para +#: configuration.xml:227 +#, no-c-format +msgid "" +"For use inside an application server, you should almost always configure " +"Hibernate to obtain connections from an application server " +"<literal>Datasource</literal> registered in JNDI. You'll need to set at " +"least one of the following properties:" msgstr "" +"Para usar dentro de um servidor de aplicação, você deve configurar o " +"Hibernate para obter conexões de um application server <literal>Datasource</" +"literal> registrado no JNDI. Você necessitará determinar pelo menos uma das " +"seguintes propriedades:" -#: index.docbook:235 +#. Tag: title +#: configuration.xml:235 +#, no-c-format msgid "Hibernate Datasource Properties" -msgstr "" +msgstr "Propriedades do Datasource do Hibernate" -#: index.docbook:248 +#. Tag: literal +#: configuration.xml:248 +#, no-c-format msgid "hibernate.connection.datasource" -msgstr "" +msgstr "hibernate.connection.datasource" -#: index.docbook:251 +#. Tag: emphasis +#: configuration.xml:251 +#, no-c-format msgid "datasource JNDI name" -msgstr "" +msgstr "Nome datasource JNDI" -#: index.docbook:256 +#. Tag: literal +#: configuration.xml:256 +#, no-c-format msgid "hibernate.jndi.url" -msgstr "" +msgstr "hibernate.jndi.url" -#: index.docbook:258 +#. Tag: entry +#: configuration.xml:258 +#, fuzzy, no-c-format msgid "<emphasis>URL of the JNDI provider</emphasis> (optional)" -msgstr "" +msgstr "URL do fornecedor JNDI" -#: index.docbook:264 +#. Tag: literal +#: configuration.xml:264 +#, no-c-format msgid "hibernate.jndi.class" -msgstr "" +msgstr "hibernate.jndi.class" -#: index.docbook:266 -msgid "<emphasis>class of the JNDI <literal>InitialContextFactory</literal></emphasis> (optional)" +#. Tag: entry +#: configuration.xml:266 +#, no-c-format +msgid "" +"<emphasis>class of the JNDI <literal>InitialContextFactory</literal></" +"emphasis> (optional)" msgstr "" -#: index.docbook:274 +#. Tag: entry +#: configuration.xml:274 +#, no-c-format msgid "<emphasis>database user</emphasis> (optional)" msgstr "" -#: index.docbook:282 +#. Tag: entry +#: configuration.xml:282 +#, no-c-format msgid "<emphasis>database user password</emphasis> (optional)" msgstr "" -#: index.docbook:290 -msgid "Here's an example <literal>hibernate.properties</literal> file for an application server provided JNDI datasource:" +#. Tag: para +#: configuration.xml:290 +#, no-c-format +msgid "" +"Here's an example <literal>hibernate.properties</literal> file for an " +"application server provided JNDI datasource:" msgstr "" +"Eis um exemplo de arquivo <literal>hibernate.properties</literal> para um " +"servidor de aplicação fornecedor de datasources JNDI:" -#: index.docbook:295 +#. Tag: programlisting +#: configuration.xml:295 +#, no-c-format msgid "" - "<![CDATA[hibernate.connection.datasource = java:/comp/env/jdbc/test\n" - "hibernate.transaction.factory_class = \\\n" - " org.hibernate.transaction.JTATransactionFactory\n" - "hibernate.transaction.manager_lookup_class = \\\n" - " org.hibernate.transaction.JBossTransactionManagerLookup\n" - "hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect]]>" +"<![CDATA[hibernate.connection.datasource = java:/comp/env/jdbc/test\n" +"hibernate.transaction.factory_class = \\\n" +" org.hibernate.transaction.JTATransactionFactory\n" +"hibernate.transaction.manager_lookup_class = \\\n" +" org.hibernate.transaction.JBossTransactionManagerLookup\n" +"hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect]]>" msgstr "" -#: index.docbook:297 -msgid "JDBC connections obtained from a JNDI datasource will automatically participate in the container-managed transactions of the application server." +#. Tag: para +#: configuration.xml:297 +#, no-c-format +msgid "" +"JDBC connections obtained from a JNDI datasource will automatically " +"participate in the container-managed transactions of the application server." msgstr "" +"Conexões JDBC obtidas de um datasource JNDI irão automaticamente irão " +"participar das transações gerenciadas pelo container no servidor de " +"aplicação." -#: index.docbook:302 -msgid "Arbitrary connection properties may be given by prepending \"<literal>hibernate.connection</literal>\" to the property name. For example, you may specify a <literal>charSet</literal> using <literal>hibernate.connection.charSet</literal>." +#. Tag: para +#: configuration.xml:302 +#, no-c-format +msgid "" +"Arbitrary connection properties may be given by prepending " +"\"<literal>hibernate.connection</literal>\" to the property name. For " +"example, you may specify a <literal>charSet</literal> using " +"<literal>hibernate.connection.charSet</literal>." msgstr "" +"Arbitrariamente as propriedades de conexão podem ser acrescentandas ao " +"\"<literal>hibernate.connnection</literal>\" ao nome da propriedade. Por " +"exemplo, você deve especificar o <literal>charSet</literal> usando " +"<literal>hibernate.connection.charSet</literal>.t." -#: index.docbook:308 -msgid "You may define your own plugin strategy for obtaining JDBC connections by implementing the interface <literal>org.hibernate.connection.ConnectionProvider</literal>. You may select a custom implementation by setting <literal>hibernate.connection.provider_class</literal>." +#. Tag: para +#: configuration.xml:308 +#, no-c-format +msgid "" +"You may define your own plugin strategy for obtaining JDBC connections by " +"implementing the interface <literal>org.hibernate.connection." +"ConnectionProvider</literal>. You may select a custom implementation by " +"setting <literal>hibernate.connection.provider_class</literal>." msgstr "" +"Você pode definir sua própria estratégia de plugin para obter conexões JDBC " +"implementando a interface <literal>org.hibernate.connection." +"ConnectionProvider</literal>. Você pode escolher uma implementação " +"customizada setando <literal>hibernate.connection.provider_class</literal>." -#: index.docbook:317 +#. Tag: title +#: configuration.xml:317 +#, no-c-format msgid "Optional configuration properties" -msgstr "" +msgstr "Propriedades opcionais de configuração" -#: index.docbook:319 -msgid "There are a number of other properties that control the behaviour of Hibernate at runtime. All are optional and have reasonable default values." +#. Tag: para +#: configuration.xml:319 +#, no-c-format +msgid "" +"There are a number of other properties that control the behaviour of " +"Hibernate at runtime. All are optional and have reasonable default values." msgstr "" +"Há um grande número de outras propriedades que controlam o comportamento do " +"Hibernate em tempo de execução. Todos são opcionais e tem valores default " +"lógicos." -#: index.docbook:324 -msgid "<emphasis>Warning: some of these properties are \"system-level\" only.</emphasis> System-level properties can be set only via <literal>java -Dproperty=value</literal> or <literal>hibernate.properties</literal>. They may <emphasis>not</emphasis> be set by the other techniques described above." +#. Tag: para +#: configuration.xml:324 +#, no-c-format +msgid "" +"<emphasis>Warning: some of these properties are \"system-level\" only.</" +"emphasis> System-level properties can be set only via <literal>java -" +"Dproperty=value</literal> or <literal>hibernate.properties</literal>. They " +"may <emphasis>not</emphasis> be set by the other techniques described above." msgstr "" +"<emphasis>Aviso: algumas destas propriedades são somente a \"nível de sistema" +"\".</emphasis> Propriedades nível de sistema podem ser determinados somente " +"via <literal>java -Dproperty=value</literal> ou <literal>hibernate." +"properties</literal>. Elas <emphasis>não</emphasis>podem ser configuradas " +"por outras técnicas descritas abaixo." -#: index.docbook:332 +#. Tag: title +#: configuration.xml:332 +#, no-c-format msgid "Hibernate Configuration Properties" -msgstr "" +msgstr "Hibernate Configuration Properties" -#: index.docbook:345 +#. Tag: literal +#: configuration.xml:345 +#, no-c-format msgid "hibernate.dialect" -msgstr "" +msgstr "hibernate.dialect" -#: index.docbook:347 -msgid "The classname of a Hibernate <literal>Dialect</literal> which allows Hibernate to generate SQL optimized for a particular relational database." +#. Tag: entry +#: configuration.xml:347 +#, fuzzy, no-c-format +msgid "" +"The classname of a Hibernate <literal>Dialect</literal> which allows " +"Hibernate to generate SQL optimized for a particular relational database." msgstr "" +"O nome da classe de um <placeholder-1/> que permite o Hibernate gerar SQL " +"otimizado para um banco de dados relacional em particular. <placeholder-2/>" -#: index.docbook:351 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>full.classname.of.Dialect</literal>" +#. Tag: para +#: configuration.xml:351 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>full.classname.of.Dialect</" +"literal>" msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">eg.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:359 +#. Tag: literal +#: configuration.xml:359 +#, no-c-format msgid "hibernate.show_sql" -msgstr "" +msgstr "hibernate.show_sql" -#: index.docbook:361 -msgid "Write all SQL statements to console. This is an alternative to setting the log category <literal>org.hibernate.SQL</literal> to <literal>debug</literal>." +#. Tag: entry +#: configuration.xml:361 +#, fuzzy, no-c-format +msgid "" +"Write all SQL statements to console. This is an alternative to setting the " +"log category <literal>org.hibernate.SQL</literal> to <literal>debug</" +"literal>." msgstr "" +"Escreve todas as instruções SQL no console. Esta é uma alternativa a " +"configurar a categoria de log <placeholder-1/> para <placeholder-2/>. " +"<placeholder-3/>" -#: index.docbook:365, index.docbook:377, index.docbook:471, index.docbook:484, index.docbook:497, index.docbook:510, index.docbook:564, index.docbook:591, index.docbook:605, index.docbook:660, index.docbook:888, index.docbook:903, index.docbook:993 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>true</literal> | <literal>false</literal>" +#. Tag: para +#: configuration.xml:365 configuration.xml:377 configuration.xml:471 +#: configuration.xml:484 configuration.xml:497 configuration.xml:510 +#: configuration.xml:564 configuration.xml:591 configuration.xml:605 +#: configuration.xml:660 configuration.xml:888 configuration.xml:903 +#: configuration.xml:993 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>true</literal> | " +"<literal>false</literal>" msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">eg.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:373 +#. Tag: literal +#: configuration.xml:373 +#, no-c-format msgid "hibernate.format_sql" -msgstr "" +msgstr "hibernate.format_sql" -#: index.docbook:375 +#. Tag: entry +#: configuration.xml:375 +#, fuzzy, no-c-format msgid "Pretty print the SQL in the log and console." -msgstr "" +msgstr "Imprime o SQL formatado no log e console. <placeholder-1/>" -#: index.docbook:385 +#. Tag: literal +#: configuration.xml:385 +#, no-c-format msgid "hibernate.default_schema" -msgstr "" +msgstr "hibernate.default_schema" -#: index.docbook:387 -msgid "Qualify unqualified table names with the given schema/tablespace in generated SQL." +#. Tag: entry +#: configuration.xml:387 +#, fuzzy, no-c-format +msgid "" +"Qualify unqualified table names with the given schema/tablespace in " +"generated SQL." msgstr "" +"Qualifica no sql gerado, os nome das tabelas sem qualificar com schena/" +"tablespace dado <placeholder-1/>" -#: index.docbook:390 +#. Tag: para +#: configuration.xml:390 +#, fuzzy, no-c-format msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>SCHEMA_NAME</literal>" msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">eg.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:398 +#. Tag: literal +#: configuration.xml:398 +#, no-c-format msgid "hibernate.default_catalog" -msgstr "" +msgstr "hibernate.default_catalog" -#: index.docbook:400 -msgid "Qualify unqualified table names with the given catalog in generated SQL." +#. Tag: entry +#: configuration.xml:400 +#, fuzzy, no-c-format +msgid "" +"Qualify unqualified table names with the given catalog in generated SQL." msgstr "" +"Qualifica no sql gerado, os nome das tabelas sem qualificar com catálogo " +"dado <placeholder-1/>" -#: index.docbook:403 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>CATALOG_NAME</literal>" +#. Tag: para +#: configuration.xml:403 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>CATALOG_NAME</literal>" msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">eg.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:411 +#. Tag: literal +#: configuration.xml:411 +#, no-c-format msgid "hibernate.session_factory_name" -msgstr "" +msgstr "hibernate.session_factory_name" -#: index.docbook:413 -msgid "The <literal>SessionFactory</literal> will be automatically bound to this name in JNDI after it has been created." +#. Tag: entry +#: configuration.xml:413 +#, fuzzy, no-c-format +msgid "" +"The <literal>SessionFactory</literal> will be automatically bound to this " +"name in JNDI after it has been created." msgstr "" +"O <placeholder-1/> irá automaticamente se ligar a este nome no JNDI depois " +"de ter sido criado. <placeholder-2/>" -#: index.docbook:416, index.docbook:859 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>jndi/composite/name</literal>" +#. Tag: para +#: configuration.xml:416 configuration.xml:859 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>jndi/composite/name</" +"literal>" msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">eg.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:424 +#. Tag: literal +#: configuration.xml:424 +#, no-c-format msgid "hibernate.max_fetch_depth" -msgstr "" +msgstr "hibernate.max_fetch_depth" -#: index.docbook:426 -msgid "Set a maximum \"depth\" for the outer join fetch tree for single-ended associations (one-to-one, many-to-one). A <literal>0</literal> disables default outer join fetching." +#. Tag: entry +#: configuration.xml:426 +#, fuzzy, no-c-format +msgid "" +"Set a maximum \"depth\" for the outer join fetch tree for single-ended " +"associations (one-to-one, many-to-one). A <literal>0</literal> disables " +"default outer join fetching." msgstr "" +"Estabelece a \"profundidade\" máxima para árvore outer join fetch para " +"associações finais únicas(one-to-one,many-to-one). Um <placeholder-1/> " +"desativa por default a busca outer join. <placeholder-2/>" -#: index.docbook:430 -msgid "<emphasis role=\"strong\">eg.</emphasis> recommended values between <literal>0</literal> and <literal>3</literal>" +#. Tag: para +#: configuration.xml:430 +#, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> recommended values between " +"<literal>0</literal> and <literal>3</literal>" msgstr "" +"<emphasis role=\"strong\">eg.</emphasis> Valores recomendados " +"entre<literal>0</literal> e <literal>3</literal>" -#: index.docbook:439 +#. Tag: literal +#: configuration.xml:439 +#, no-c-format msgid "hibernate.default_batch_fetch_size" -msgstr "" +msgstr "hibernate.default_batch_fetch_size" -#: index.docbook:441 +#. Tag: entry +#: configuration.xml:441 +#, fuzzy, no-c-format msgid "Set a default size for Hibernate batch fetching of associations." msgstr "" +"Determina um tamanho default para busca de associações em lotes do Hibernate " +"<placeholder-1/>" -#: index.docbook:443 -msgid "<emphasis role=\"strong\">eg.</emphasis> recommended values <literal>4</literal>, <literal>8</literal>, <literal>16</literal>" +#. Tag: para +#: configuration.xml:443 +#, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> recommended values <literal>4</" +"literal>, <literal>8</literal>, <literal>16</literal>" msgstr "" +"<emphasis role=\"strong\">eg.</emphasis> Valores recomendados <literal>4</" +"literal>, <literal>8</literal>, <literal>16</literal>" -#: index.docbook:452 +#. Tag: literal +#: configuration.xml:452 +#, no-c-format msgid "hibernate.default_entity_mode" -msgstr "" +msgstr "hibernate.default_entity_mode" -#: index.docbook:454 -msgid "Set a default mode for entity representation for all sessions opened from this <literal>SessionFactory</literal>" +#. Tag: entry +#: configuration.xml:454 +#, fuzzy, no-c-format +msgid "" +"Set a default mode for entity representation for all sessions opened from " +"this <literal>SessionFactory</literal>" msgstr "" +"Determina um modo default para representação de entidades para todas as " +"sessões abertas desta <placeholder-1/><placeholder-2/>" -#: index.docbook:457 -msgid "<literal>dynamic-map</literal>, <literal>dom4j</literal>, <literal>pojo</literal>" +#. Tag: para +#: configuration.xml:457 +#, no-c-format +msgid "" +"<literal>dynamic-map</literal>, <literal>dom4j</literal>, <literal>pojo</" +"literal>" msgstr "" +"<literal>dynamic-map</literal>, <literal>dom4j</literal>, <literal>pojo</" +"literal>" -#: index.docbook:465 +#. Tag: literal +#: configuration.xml:465 +#, no-c-format msgid "hibernate.order_updates" -msgstr "" +msgstr "hibernate.order_updates" -#: index.docbook:467 -msgid "Force Hibernate to order SQL updates by the primary key value of the items being updated. This will result in fewer transaction deadlocks in highly concurrent systems." +#. Tag: entry +#: configuration.xml:467 +#, fuzzy, no-c-format +msgid "" +"Force Hibernate to order SQL updates by the primary key value of the items " +"being updated. This will result in fewer transaction deadlocks in highly " +"concurrent systems." msgstr "" +"Força o Hibernate a ordenar os updates SQL pelo valor da chave primária dos " +"itens a serem atualizados. Isto resultará em menos deadlocks nas transações " +"em sistemas altamente concorrente. <placeholder-1/>" -#: index.docbook:479 +#. Tag: literal +#: configuration.xml:479 +#, no-c-format msgid "hibernate.generate_statistics" -msgstr "" +msgstr "hibernate.generate_statistics" -#: index.docbook:481 -msgid "If enabled, Hibernate will collect statistics useful for performance tuning." +#. Tag: entry +#: configuration.xml:481 +#, fuzzy, no-c-format +msgid "" +"If enabled, Hibernate will collect statistics useful for performance tuning." msgstr "" +"If enabled, Hibernate will collect statistics useful for performance tuning. " +"Se habilitado, o Hibernate coletará estatísticas úties para performance " +"tuning dos bancos. <placeholder-1/>" -#: index.docbook:492 +#. Tag: literal +#: configuration.xml:492 +#, no-c-format msgid "hibernate.use_identifier_rollback" -msgstr "" +msgstr "hibernate.use_identifer_rollback" -#: index.docbook:494 -msgid "If enabled, generated identifier properties will be reset to default values when objects are deleted." +#. Tag: entry +#: configuration.xml:494 +#, fuzzy, no-c-format +msgid "" +"If enabled, generated identifier properties will be reset to default values " +"when objects are deleted." msgstr "" +"Se habilitado, propriedades identificadoras geradas serão zeradas para os " +"valores default quando os objetos forem apagados. <placeholder-1/>" -#: index.docbook:505 +#. Tag: literal +#: configuration.xml:505 +#, no-c-format msgid "hibernate.use_sql_comments" -msgstr "" +msgstr "hibernate.use_sql_comments" -#: index.docbook:507 -msgid "If turned on, Hibernate will generate comments inside the SQL, for easier debugging, defaults to <literal>false</literal>." +#. Tag: entry +#: configuration.xml:507 +#, fuzzy, no-c-format +msgid "" +"If turned on, Hibernate will generate comments inside the SQL, for easier " +"debugging, defaults to <literal>false</literal>." msgstr "" +"Se ligado, o Hibernate irá gerar comentários dentro do SQL, para facilitar o " +"debugging, o valor default é <placeholder-1/>. <placeholder-2/>" -#: index.docbook:521 +#. Tag: title +#: configuration.xml:521 +#, no-c-format msgid "Hibernate JDBC and Connection Properties" -msgstr "" +msgstr "JDBC Hibernate e Propriedades de Conexão" -#: index.docbook:536 +#. Tag: literal +#: configuration.xml:536 +#, no-c-format msgid "hibernate.jdbc.fetch_size" -msgstr "" +msgstr "hibernate.jdbc.fetch_size" -#: index.docbook:538 -msgid "A non-zero value determines the JDBC fetch size (calls <literal>Statement.setFetchSize()</literal>)." +#. Tag: entry +#: configuration.xml:538 +#, fuzzy, no-c-format +msgid "" +"A non-zero value determines the JDBC fetch size (calls <literal>Statement." +"setFetchSize()</literal>)." msgstr "" +"Um valor maior que zero determina o tamanho do fetch do JDBC( chamadas " +"<placeholder-1/>)." -#: index.docbook:545 +#. Tag: literal +#: configuration.xml:545 +#, no-c-format msgid "hibernate.jdbc.batch_size" -msgstr "" +msgstr "hibernate.jdbc.batch_size" -#: index.docbook:547 +#. Tag: entry +#: configuration.xml:547 +#, fuzzy, no-c-format msgid "A non-zero value enables use of JDBC2 batch updates by Hibernate." msgstr "" +"Um valor maior que zero habilita uso de batch updates JDBC2 pelo Hibernate. " +"<placeholder-1/>" -#: index.docbook:549 -msgid "<emphasis role=\"strong\">eg.</emphasis> recommended values between <literal>5</literal> and <literal>30</literal>" +#. Tag: para +#: configuration.xml:549 +#, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> recommended values between " +"<literal>5</literal> and <literal>30</literal>" msgstr "" +"<emphasis role=\"strong\">Ex.</emphasis> valores recomentados entre " +"<literal>5</literal> e <literal>30</literal>" -#: index.docbook:557 +#. Tag: literal +#: configuration.xml:557 +#, no-c-format msgid "hibernate.jdbc.batch_versioned_data" -msgstr "" +msgstr "hibernate.jdbc.batch_versioned_data" -#: index.docbook:559 -msgid "Set this property to <literal>true</literal> if your JDBC driver returns correct row counts from <literal>executeBatch()</literal> (it is usually safe to turn this option on). Hibernate will then use batched DML for automatically versioned data. Defaults to <literal>false</literal>." +#. Tag: entry +#: configuration.xml:559 +#, fuzzy, no-c-format +msgid "" +"Set this property to <literal>true</literal> if your JDBC driver returns " +"correct row counts from <literal>executeBatch()</literal> (it is usually " +"safe to turn this option on). Hibernate will then use batched DML for " +"automatically versioned data. Defaults to <literal>false</literal>." msgstr "" +"Sete esta propriedade como <placeholder-1/> se seu driver JDBC retorna o " +"número correto de linhas no <placeholder-2/> ( É usualmente seguro tornar " +"esta opção ligada). O Hibernate então irá usar betched DML para " +"automaticamente versionar dados. <placeholder-3/> por default. <placeholder-" +"4/>" -#: index.docbook:572 +#. Tag: literal +#: configuration.xml:572 +#, no-c-format msgid "hibernate.jdbc.factory_class" -msgstr "" +msgstr "hibernate.jdbc.factory_class" -#: index.docbook:574 -msgid "Select a custom <literal>Batcher</literal>. Most applications will not need this configuration property." +#. Tag: entry +#: configuration.xml:574 +#, fuzzy, no-c-format +msgid "" +"Select a custom <literal>Batcher</literal>. Most applications will not need " +"this configuration property." msgstr "" +"Escolher um <placeholder-1/> customizado. Muitas aplicações não irão " +"necessitar desta propriedade de configuração <placeholder-2/>" -#: index.docbook:577 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>classname.of.BatcherFactory</literal>" +#. Tag: para +#: configuration.xml:577 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>classname.of." +"BatcherFactory</literal>" msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">eg.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:585 +#. Tag: literal +#: configuration.xml:585 +#, no-c-format msgid "hibernate.jdbc.use_scrollable_resultset" -msgstr "" +msgstr "hibernate.jdbc.use_scrollable_resultset" -#: index.docbook:587 -msgid "Enables use of JDBC2 scrollable resultsets by Hibernate. This property is only necessary when using user supplied JDBC connections, Hibernate uses connection metadata otherwise." +#. Tag: entry +#: configuration.xml:587 +#, fuzzy, no-c-format +msgid "" +"Enables use of JDBC2 scrollable resultsets by Hibernate. This property is " +"only necessary when using user supplied JDBC connections, Hibernate uses " +"connection metadata otherwise." msgstr "" +"Habilita o uso de JDBC2 scrollable resultsets pelo Hibernate. Essa " +"propriedade somente é necessaria quando se usa Conexeções JDBC providas pelo " +"usuário, caso contrário o Hibernate os os metadados da conexão. <placeholder-" +"1/>" -#: index.docbook:599 +#. Tag: literal +#: configuration.xml:599 +#, no-c-format msgid "hibernate.jdbc.use_streams_for_binary" -msgstr "" +msgstr "hibernate.jdbc.use_streams_for_binary" -#: index.docbook:601 -msgid "Use streams when writing/reading <literal>binary</literal> or <literal>serializable</literal> types to/from JDBC (system-level property)." +#. Tag: entry +#: configuration.xml:601 +#, fuzzy, no-c-format +msgid "" +"Use streams when writing/reading <literal>binary</literal> or " +"<literal>serializable</literal> types to/from JDBC (system-level property)." msgstr "" +"Use streams para escrever/ler tipos <placeholder-1/> ou <placeholder-2/> " +"para/a o JDBC( propriedade a nível de sistema). <placeholder-3/>" -#: index.docbook:613 +#. Tag: literal +#: configuration.xml:613 +#, no-c-format msgid "hibernate.jdbc.use_get_generated_keys" -msgstr "" +msgstr "hibernate.jdbc.use_get_generated_keys" -#: index.docbook:615 -msgid "Enable use of JDBC3 <literal>PreparedStatement.getGeneratedKeys()</literal> to retrieve natively generated keys after insert. Requires JDBC3+ driver and JRE1.4+, set to false if your driver has problems with the Hibernate identifier generators. By default, tries to determine the driver capabilities using connection metadata." +#. Tag: entry +#: configuration.xml:615 +#, fuzzy, no-c-format +msgid "" +"Enable use of JDBC3 <literal>PreparedStatement.getGeneratedKeys()</literal> " +"to retrieve natively generated keys after insert. Requires JDBC3+ driver and " +"JRE1.4+, set to false if your driver has problems with the Hibernate " +"identifier generators. By default, tries to determine the driver " +"capabilities using connection metadata." msgstr "" +"Possibilita o uso <placeholder-1/> do JDBC3 para recuperar chaves geradas " +"nativamente depois da inserçãp. Requer driver JDBC3+ e JRE1.4+, determine " +"para false se seu driver tem problemas com gerador de indentificadores " +"Hibernate. Por default, tente determinar o driver capaz de usar metadados da " +"conexão. <placeholder-2/>" -#: index.docbook:621, index.docbook:751, index.docbook:763, index.docbook:777, index.docbook:815 +#. Tag: para +#: configuration.xml:621 configuration.xml:751 configuration.xml:763 +#: configuration.xml:777 configuration.xml:815 +#, fuzzy, no-c-format msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>true|false</literal>" msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">eg.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:629 +#. Tag: literal +#: configuration.xml:629 +#, no-c-format msgid "hibernate.connection.provider_class" -msgstr "" +msgstr "hibernate.connection.provider_class" -#: index.docbook:631 -msgid "The classname of a custom <literal>ConnectionProvider</literal> which provides JDBC connections to Hibernate." +#. Tag: entry +#: configuration.xml:631 +#, fuzzy, no-c-format +msgid "" +"The classname of a custom <literal>ConnectionProvider</literal> which " +"provides JDBC connections to Hibernate." msgstr "" +"O nome da classe de um <placeholder-1/> personalizado o qual proverá " +"conexões JDBC para o Hibernate. <placeholder-2/>" -#: index.docbook:634 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>classname.of.ConnectionProvider</literal>" +#. Tag: para +#: configuration.xml:634 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>classname.of." +"ConnectionProvider</literal>" msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">eg.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:642 +#. Tag: literal +#: configuration.xml:642 +#, no-c-format msgid "hibernate.connection.isolation" -msgstr "" +msgstr "hibernate.connection.isolation" -#: index.docbook:644 -msgid "Set the JDBC transaction isolation level. Check <literal>java.sql.Connection</literal> for meaningful values but note that most databases do not support all isolation levels." +#. Tag: entry +#: configuration.xml:644 +#, fuzzy, no-c-format +msgid "" +"Set the JDBC transaction isolation level. Check <literal>java.sql." +"Connection</literal> for meaningful values but note that most databases do " +"not support all isolation levels." msgstr "" +"Determina o nível de isolamento de uma transação JDBC. Verifique " +"<placeholder-1/> para valores siginificativos mas note que a maior parte dos " +"bancos de dados não suportam todos os níveis de isolamento. <placeholder-2/>" -#: index.docbook:648 +#. Tag: para +#: configuration.xml:648 +#, fuzzy, no-c-format msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>1, 2, 4, 8</literal>" msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">eg.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:656 +#. Tag: literal +#: configuration.xml:656 +#, no-c-format msgid "hibernate.connection.autocommit" -msgstr "" +msgstr "hibernate.connection.autocommit" -#: index.docbook:658 +#. Tag: entry +#: configuration.xml:658 +#, fuzzy, no-c-format msgid "Enables autocommit for JDBC pooled connections (not recommended)." msgstr "" +"Habilita autocommit para conexões no pool JDBC( não recomendado). " +"<placeholder-1/>" -#: index.docbook:668 +#. Tag: literal +#: configuration.xml:668 +#, no-c-format msgid "hibernate.connection.release_mode" -msgstr "" +msgstr "hibernate.connection.release_mode" -#: index.docbook:670 -msgid "Specify when Hibernate should release JDBC connections. By default, a JDBC connection is held until the session is explicitly closed or disconnected. For an application server JTA datasource, you should use <literal>after_statement</literal> to aggressively release connections after every JDBC call. For a non-JTA connection, it often makes sense to release the connection at the end of each transaction, by using <literal>after_transaction</literal>. <literal>auto</literal> will choose <literal>after_statement</literal> for the JTA and CMT transaction strategies and <literal>after_transaction</literal> for the JDBC transaction strategy." +#. Tag: entry +#: configuration.xml:670 +#, fuzzy, no-c-format +msgid "" +"Specify when Hibernate should release JDBC connections. By default, a JDBC " +"connection is held until the session is explicitly closed or disconnected. " +"For an application server JTA datasource, you should use " +"<literal>after_statement</literal> to aggressively release connections after " +"every JDBC call. For a non-JTA connection, it often makes sense to release " +"the connection at the end of each transaction, by using " +"<literal>after_transaction</literal>. <literal>auto</literal> will choose " +"<literal>after_statement</literal> for the JTA and CMT transaction " +"strategies and <literal>after_transaction</literal> for the JDBC transaction " +"strategy." msgstr "" +"Especifica quando o Hibernate deve liberar conexões JDBC. Por default, uma " +"conexão JDBC é retida até a sessão está explicitamente fechada ou " +"desconectada. Para um datasource JTA do servidor de aplicação, você deve " +"usar <placeholder-1/> para forçar s liberação da conexões depois de todas as " +"chamadas JDBC. Para uma conexão não-JTA, freqüentemente faz sentido liberar " +"a conexão ao fim de cada transação, usando <placeholder-2/>. <placeholder-3/" +"> escolheremos <placeholder-4/> para as estratégias de transaçãoes JTA e CMT " +"e <placeholder-5/> para as estratégias de transação JDBC <placeholder-6/" +"><placeholder-7/>" -#: index.docbook:681 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>auto</literal> (default) | <literal>on_close</literal> | <literal>after_transaction</literal> | <literal>after_statement</literal>" +#. Tag: para +#: configuration.xml:681 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>auto</literal> (default) | " +"<literal>on_close</literal> | <literal>after_transaction</literal> | " +"<literal>after_statement</literal>" msgstr "" +"<emphasis role=\"strong\">Ex.</emphasis><literal>auto</literal> (default) | " +"<literal>on_close</literal> | <literal>after_transaction</literal> | " +"<literal>after_statement</literal>" -#: index.docbook:686 -msgid "Note that this setting only affects <literal>Session</literal>s returned from <literal>SessionFactory.openSession</literal>. For <literal>Session</literal>s obtained through <literal>SessionFactory.getCurrentSession</literal>, the <literal>CurrentSessionContext</literal> implementation configured for use controls the connection release mode for those <literal>Session</literal>s. See" +#. Tag: para +#: configuration.xml:686 +#, fuzzy, no-c-format +msgid "" +"Note that this setting only affects <literal>Session</literal>s returned " +"from <literal>SessionFactory.openSession</literal>. For <literal>Session</" +"literal>s obtained through <literal>SessionFactory.getCurrentSession</" +"literal>, the <literal>CurrentSessionContext</literal> implementation " +"configured for use controls the connection release mode for those " +"<literal>Session</literal>s. See" msgstr "" +"Note that this setting only affects <literal>Session</literal>s returned " +"from <literal>SessionFactory.openSession</literal>. For <literal>Session</" +"literal>s obtained through <literal>SessionFactory.getCurrentSession</" +"literal>, the <literal>CurrentSessionContext</literal> implementation " +"configured for use controls the connection release mode for those " +"<literal>Session</literal>s. See <xref linkend=\"architecture-current-session" +"\"/>" -#: index.docbook:698 -msgid "hibernate.connection.<emphasis><propertyName></emphasis>" +#. Tag: entry +#: configuration.xml:697 +#, no-c-format +msgid "" +"<literal>hibernate.connection.</literal><emphasis><propertyName></" +"emphasis>" msgstr "" -#: index.docbook:700 -msgid "Pass the JDBC property <literal>propertyName</literal> to <literal>DriverManager.getConnection()</literal>." +#. Tag: entry +#: configuration.xml:700 +#, no-c-format +msgid "" +"Pass the JDBC property <emphasis><propertyName></emphasis> to " +"<literal>DriverManager.getConnection()</literal>." msgstr "" -#: index.docbook:707 -msgid "hibernate.jndi.<emphasis><propertyName></emphasis>" +#. Tag: entry +#: configuration.xml:706 +#, no-c-format +msgid "" +"<literal>hibernate.jndi.</literal><emphasis><propertyName></emphasis>" msgstr "" -#: index.docbook:709 -msgid "Pass the property <literal>propertyName</literal> to the JNDI <literal>InitialContextFactory</literal>." +#. Tag: entry +#: configuration.xml:709 +#, no-c-format +msgid "" +"Pass the property <emphasis><propertyName></emphasis> to the JNDI " +"<literal>InitialContextFactory</literal>." msgstr "" -#: index.docbook:719 +#. Tag: title +#: configuration.xml:719 +#, no-c-format msgid "Hibernate Cache Properties" -msgstr "" +msgstr "Propriedades de Cachê do Hibernate" -#: index.docbook:732 +#. Tag: literal +#: configuration.xml:732 +#, no-c-format msgid "hibernate.cache.provider_class" -msgstr "" +msgstr "hibernate.cache.provider_class" -#: index.docbook:734 +#. Tag: entry +#: configuration.xml:734 +#, fuzzy, no-c-format msgid "The classname of a custom <literal>CacheProvider</literal>." -msgstr "" +msgstr "O nome da classe de um <placeholder-1/> customizado. <placeholder-2/>" -#: index.docbook:736 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>classname.of.CacheProvider</literal>" +#. Tag: para +#: configuration.xml:736 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>classname.of." +"CacheProvider</literal>" msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">eg.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:744 +#. Tag: literal +#: configuration.xml:744 +#, no-c-format msgid "hibernate.cache.use_minimal_puts" -msgstr "" +msgstr "hibernate.cache.use_minimal_puts" -#: index.docbook:746 -msgid "Optimize second-level cache operation to minimize writes, at the cost of more frequent reads. This setting is most useful for clustered caches and, in Hibernate3, is enabled by default for clustered cache implementations." +#. Tag: entry +#: configuration.xml:746 +#, fuzzy, no-c-format +msgid "" +"Optimize second-level cache operation to minimize writes, at the cost of " +"more frequent reads. This setting is most useful for clustered caches and, " +"in Hibernate3, is enabled by default for clustered cache implementations." msgstr "" +"Otimizar operação de cachê de segundo nível para minimizar escritas, ao " +"custo de leituras mais frequantes. Esta configuração é mais útil para cachês " +"clusterizados e, no Hibernate3, é habilitado por default para implementações " +"de cachê clusterizar. <placeholder-1/>" -#: index.docbook:759 +#. Tag: literal +#: configuration.xml:759 +#, no-c-format msgid "hibernate.cache.use_query_cache" -msgstr "" +msgstr "hibernate.cache.use_query_cache" -#: index.docbook:761 -msgid "Enable the query cache, individual queries still have to be set cachable." +#. Tag: entry +#: configuration.xml:761 +#, fuzzy, no-c-format +msgid "" +"Enable the query cache, individual queries still have to be set cachable." msgstr "" +"Habilita a cache de consultas, Mesmo assim, consultas individuais ainda tem " +"que ser habilitadas para o cache. <placeholder-1/>" -#: index.docbook:771 +#. Tag: literal +#: configuration.xml:771 +#, no-c-format msgid "hibernate.cache.use_second_level_cache" -msgstr "" +msgstr "hibernate.cache.use_second_level_cache" -#: index.docbook:773 -msgid "May be used to completely disable the second level cache, which is enabled by default for classes which specify a <literal><cache></literal> mapping." +#. Tag: entry +#: configuration.xml:773 +#, fuzzy, no-c-format +msgid "" +"May be used to completely disable the second level cache, which is enabled " +"by default for classes which specify a <literal><cache></literal> " +"mapping." msgstr "" +"Pode ser usada para desabilitar completamente ocache de segundo nível, o " +"qual está habilitado por default para classes que especificam um mapeamento " +"<placeholder-1/>. <placeholder-2/>" -#: index.docbook:785 +#. Tag: literal +#: configuration.xml:785 +#, no-c-format msgid "hibernate.cache.query_cache_factory" -msgstr "" +msgstr "hibernate.cache.query_cache_factory" -#: index.docbook:787 -msgid "The classname of a custom <literal>QueryCache</literal> interface, defaults to the built-in <literal>StandardQueryCache</literal>." +#. Tag: entry +#: configuration.xml:787 +#, fuzzy, no-c-format +msgid "" +"The classname of a custom <literal>QueryCache</literal> interface, defaults " +"to the built-in <literal>StandardQueryCache</literal>." msgstr "" +"O nome de uma classe que implementa a interface <placeholder-1/> " +"personalizada, por default, um <placeholder-2/> criado automaticamente. " +"<placeholder-3/>" -#: index.docbook:790 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>classname.of.QueryCache</literal>" +#. Tag: para +#: configuration.xml:790 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>classname.of.QueryCache</" +"literal>" msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">eg.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:798 +#. Tag: literal +#: configuration.xml:798 +#, no-c-format msgid "hibernate.cache.region_prefix" -msgstr "" +msgstr "hibernate.cache.region_prefix" -#: index.docbook:800 +#. Tag: entry +#: configuration.xml:800 +#, fuzzy, no-c-format msgid "A prefix to use for second-level cache region names." msgstr "" +"Um prefixo para usar nos nomes da área especial do cachê de segundo nível. " +"<placeholder-1/>" -#: index.docbook:802 +#. Tag: para +#: configuration.xml:802 +#, fuzzy, no-c-format msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>prefix</literal>" msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">eg.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:810 +#. Tag: literal +#: configuration.xml:810 +#, no-c-format msgid "hibernate.cache.use_structured_entries" -msgstr "" +msgstr "hibernate.cache.use_structured_entries" -#: index.docbook:812 -msgid "Forces Hibernate to store data in the second-level cache in a more human-friendly format." +#. Tag: entry +#: configuration.xml:812 +#, fuzzy, no-c-format +msgid "" +"Forces Hibernate to store data in the second-level cache in a more human-" +"friendly format." msgstr "" +"Forces Hibernate to store data in the second-level cache in a more human-" +"friendly format. Força o Hibernate armazenar dados no cachê se segundo nível " +"em um formato mais legivel. <placeholder-1/>" -#: index.docbook:826 +#. Tag: title +#: configuration.xml:826 +#, no-c-format msgid "Hibernate Transaction Properties" -msgstr "" +msgstr "Propriedades de Transação do Hibernate" -#: index.docbook:839 +#. Tag: literal +#: configuration.xml:839 +#, no-c-format msgid "hibernate.transaction.factory_class" -msgstr "" +msgstr "hibernate.transaction.factory_class" -#: index.docbook:841 -msgid "The classname of a <literal>TransactionFactory</literal> to use with Hibernate <literal>Transaction</literal> API (defaults to <literal>JDBCTransactionFactory</literal>)." +#. Tag: entry +#: configuration.xml:841 +#, fuzzy, no-c-format +msgid "" +"The classname of a <literal>TransactionFactory</literal> to use with " +"Hibernate <literal>Transaction</literal> API (defaults to " +"<literal>JDBCTransactionFactory</literal>)." msgstr "" +"O nome da clase de um a <placeholder-1/> para usar com API <placeholder-2/> " +"( por default <placeholder-3/>). <placeholder-4/>" -#: index.docbook:845 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>classname.of.TransactionFactory</literal>" +#. Tag: para +#: configuration.xml:845 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>classname.of." +"TransactionFactory</literal>" msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">eg.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:853 +#. Tag: literal +#: configuration.xml:853 +#, no-c-format msgid "jta.UserTransaction" -msgstr "" +msgstr "jta.UserTransaction" -#: index.docbook:855 -msgid "A JNDI name used by <literal>JTATransactionFactory</literal> to obtain the JTA <literal>UserTransaction</literal> from the application server." +#. Tag: entry +#: configuration.xml:855 +#, fuzzy, no-c-format +msgid "" +"A JNDI name used by <literal>JTATransactionFactory</literal> to obtain the " +"JTA <literal>UserTransaction</literal> from the application server." msgstr "" +"Um nome JNDI usado pelo <placeholder-1/> para obter uma <placeholder-2/> JTA " +"a partir do servidor de aplicação. <placeholder-3/>" -#: index.docbook:867 +#. Tag: literal +#: configuration.xml:867 +#, no-c-format msgid "hibernate.transaction.manager_lookup_class" -msgstr "" +msgstr "hibernate.transaction.manager_lookup_class" -#: index.docbook:869 -msgid "The classname of a <literal>TransactionManagerLookup</literal> - required when JVM-level caching is enabled or when using hilo generator in a JTA environment." +#. Tag: entry +#: configuration.xml:869 +#, fuzzy, no-c-format +msgid "" +"The classname of a <literal>TransactionManagerLookup</literal> - required " +"when JVM-level caching is enabled or when using hilo generator in a JTA " +"environment." msgstr "" +"O nome da classe de um <placeholder-1/> – requerido quando caching a nível " +"JVM esta habilitado ou quando estivermos usando um generator hilo em um " +"ambiente JTA. <placeholder-2/>" -#: index.docbook:873 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>classname.of.TransactionManagerLookup</literal>" +#. Tag: para +#: configuration.xml:873 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>classname.of." +"TransactionManagerLookup</literal>" msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">eg.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:881 +#. Tag: literal +#: configuration.xml:881 +#, no-c-format msgid "hibernate.transaction.flush_before_completion" -msgstr "" +msgstr "hibernate.transaction.flush_before_completion" -#: index.docbook:883 -msgid "If enabled, the session will be automatically flushed during the before completion phase of the transaction. Built-in and automatic session context management is preferred, see <xref linkend=\"architecture-current-session\"/>." +#. Tag: entry +#: configuration.xml:883 +#, fuzzy, no-c-format +msgid "" +"If enabled, the session will be automatically flushed during the before " +"completion phase of the transaction. Built-in and automatic session context " +"management is preferred, see <xref linkend=\"architecture-current-session\"/" +">." msgstr "" +"Se habilitado, a sessão será automaticamente limpa antes da fase de " +"conclusão da transação. É preferivel a gerência interna e automática do " +"contexto da sessão, veja <xref linkend=\"architecture-current-session\"/" +"><placeholder-1/>" -#: index.docbook:896 +#. Tag: literal +#: configuration.xml:896 +#, no-c-format msgid "hibernate.transaction.auto_close_session" -msgstr "" +msgstr "hibernate.transaction.auto_close_session" -#: index.docbook:898 -msgid "If enabled, the session will be automatically closed during the after completion phase of the transaction. Built-in and utomatic session context management is preferred, see <xref linkend=\"architecture-current-session\"/>." +#. Tag: entry +#: configuration.xml:898 +#, fuzzy, no-c-format +msgid "" +"If enabled, the session will be automatically closed during the after " +"completion phase of the transaction. Built-in and utomatic session context " +"management is preferred, see <xref linkend=\"architecture-current-session\"/" +">." msgstr "" +"Se habilitado, a sessão será automaticamente fechada após a fase de " +"conclusão da transação. É preferivel a gerência interna e automática do " +"contexto da sessão, veja <xref linkend=\"architecture-current-session\"/" +"><placeholder-1/>" -#: index.docbook:914 +#. Tag: title +#: configuration.xml:914 +#, no-c-format msgid "Miscellaneous Properties" -msgstr "" +msgstr "Propriedades Variadas" -#: index.docbook:927 +#. Tag: literal +#: configuration.xml:927 +#, no-c-format msgid "hibernate.current_session_context_class" -msgstr "" +msgstr "hibernate.current_session_context_class" -#: index.docbook:929 -msgid "Supply a (custom) strategy for the scoping of the \"current\" <literal>Session</literal>. See <xref linkend=\"architecture-current-session\"/> for more information about the built-in strategies." +#. Tag: entry +#: configuration.xml:929 +#, fuzzy, no-c-format +msgid "" +"Supply a (custom) strategy for the scoping of the \"current\" " +"<literal>Session</literal>. See <xref linkend=\"architecture-current-session" +"\"/> for more information about the built-in strategies." msgstr "" +"Forneçe uma estratégia (personalizada) para extensão da <placeholder-1/> " +"\"corrente\". Veja <xref linkend=\"architecture-current-session\"/> para " +"mais informação sobre estratégias internas. <placeholder-2/>" -#: index.docbook:934 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>jta</literal> | <literal>thread</literal> | <literal>managed</literal> | <literal>custom.Class</literal>" +#. Tag: para +#: configuration.xml:934 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>jta</literal> | " +"<literal>thread</literal> | <literal>managed</literal> | <literal>custom." +"Class</literal>" msgstr "" +"<emphasis role=\"strong\">Ex.</emphasis><literal>jta</literal> | " +"<literal>thread</literal> | <literal>managed</literal> | <literal>custom." +"Class</literal>" -#: index.docbook:943 +#. Tag: literal +#: configuration.xml:943 +#, no-c-format msgid "hibernate.query.factory_class" -msgstr "" +msgstr "hibernate.query.factory_class" -#: index.docbook:945 +#. Tag: entry +#: configuration.xml:945 +#, fuzzy, no-c-format msgid "Chooses the HQL parser implementation." -msgstr "" +msgstr "Escolha a implementação de análise HQL. <placeholder-1/>" -#: index.docbook:947 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>org.hibernate.hql.ast.ASTQueryTranslatorFactory</literal> or <literal>org.hibernate.hql.classic.ClassicQueryTranslatorFactory</literal>" +#. Tag: para +#: configuration.xml:947 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>org.hibernate.hql.ast." +"ASTQueryTranslatorFactory</literal> or <literal>org.hibernate.hql.classic." +"ClassicQueryTranslatorFactory</literal>" msgstr "" +"<emphasis role=\"strong\">eg.</emphasis><literal>org.hibernate.hql.ast." +"ASTQueryTranslatorFactory</literal> or <literal>org.hibernate.hql.classic." +"ClassicQueryTranslatorFactory</literal>" -#: index.docbook:956 +#. Tag: literal +#: configuration.xml:956 +#, no-c-format msgid "hibernate.query.substitutions" -msgstr "" +msgstr "hibernate.query.substitutions" -#: index.docbook:958 -msgid "Mapping from tokens in Hibernate queries to SQL tokens (tokens might be function or literal names, for example)." +#. Tag: entry +#: configuration.xml:958 +#, fuzzy, no-c-format +msgid "" +"Mapping from tokens in Hibernate queries to SQL tokens (tokens might be " +"function or literal names, for example)." msgstr "" +"Mapeamento a partir de símbolos em consultas HQL para símbolos SQL( símbolos " +"devem ser funções ou nome literais , por exemplo). <placeholder-1/>" -#: index.docbook:961 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>hqlLiteral=SQL_LITERAL, hqlFunction=SQLFUNC</literal>" +#. Tag: para +#: configuration.xml:961 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>hqlLiteral=SQL_LITERAL, " +"hqlFunction=SQLFUNC</literal>" msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">eg.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:969 +#. Tag: literal +#: configuration.xml:969 +#, no-c-format msgid "hibernate.hbm2ddl.auto" -msgstr "" +msgstr "hibernate.hbm2ddl.auto" -#: index.docbook:971 -msgid "Automatically validate or export schema DDL to the database when the <literal>SessionFactory</literal> is created. With <literal>create-drop</literal>, the database schema will be dropped when the <literal>SessionFactory</literal> is closed explicitly." +#. Tag: entry +#: configuration.xml:971 +#, fuzzy, no-c-format +msgid "" +"Automatically validate or export schema DDL to the database when the " +"<literal>SessionFactory</literal> is created. With <literal>create-drop</" +"literal>, the database schema will be dropped when the " +"<literal>SessionFactory</literal> is closed explicitly." msgstr "" +"Automaticamente valida ou exporta schema DDL para o banco de dados quando o " +"<placeholder-1/> é criads. Com <placeholder-2/>, o schema do banco de dados " +"será excluido quando a <placeholder-3/> for fechada esplicitamente. " +"<placeholder-4/>" -#: index.docbook:977 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>validate</literal> | <literal>update</literal> | <literal>create</literal> | <literal>create-drop</literal>" +#. Tag: para +#: configuration.xml:977 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>validate</literal> | " +"<literal>update</literal> | <literal>create</literal> | <literal>create-" +"drop</literal>" msgstr "" +"<emphasis role=\"strong\">Ex.</emphasis><literal>validate</literal> | " +"<literal>update</literal> | <literal>create</literal> | <literal>create-" +"drop</literal>" -#: index.docbook:986 +#. Tag: literal +#: configuration.xml:986 +#, no-c-format msgid "hibernate.cglib.use_reflection_optimizer" -msgstr "" +msgstr "hibernate.cglib.use_reflection_optimizer" -#: index.docbook:988 -msgid "Enables use of CGLIB instead of runtime reflection (System-level property). Reflection can sometimes be useful when troubleshooting, note that Hibernate always requires CGLIB even if you turn off the optimizer. You can not set this property in <literal>hibernate.cfg.xml</literal>." +#. Tag: entry +#: configuration.xml:988 +#, fuzzy, no-c-format +msgid "" +"Enables use of CGLIB instead of runtime reflection (System-level property). " +"Reflection can sometimes be useful when troubleshooting, note that Hibernate " +"always requires CGLIB even if you turn off the optimizer. You can not set " +"this property in <literal>hibernate.cfg.xml</literal>." msgstr "" +"Habilita o uso de CGLIB em vez de reflexão em tempo de execução " +"( propriedade a nível de sistema). Reflexão pode algumas vezes ser ú til " +"quando controlar erros, note que o Hibernate sempre irá requerer a CGLIB " +"mesmo se você desligar o otimizador. Você não pode determinar esta " +"propriedade no <placeholder-1/>. <placeholder-2/>" -#: index.docbook:1004 +#. Tag: title +#: configuration.xml:1004 +#, no-c-format msgid "SQL Dialects" -msgstr "" +msgstr "Dialetos SQL" -#: index.docbook:1006 -msgid "You should always set the <literal>hibernate.dialect</literal> property to the correct <literal>org.hibernate.dialect.Dialect</literal> subclass for your database. If you specify a dialect, Hibernate will use sensible defaults for some of the other properties listed above, saving you the effort of specifying them manually." +#. Tag: para +#: configuration.xml:1006 +#, no-c-format +msgid "" +"You should always set the <literal>hibernate.dialect</literal> property to " +"the correct <literal>org.hibernate.dialect.Dialect</literal> subclass for " +"your database. If you specify a dialect, Hibernate will use sensible " +"defaults for some of the other properties listed above, saving you the " +"effort of specifying them manually." msgstr "" +"Você deve sempre determinar a propriedade <literal>hibernate.dialect</" +"literal> para a subclasse de <literal>org.hibernate.dialect.Dialect</" +"literal> correta de seu banco de dados. Se você especificar um dialeto, " +"Hibernate usará defaults lógicos para qualquer um das outras propriedades " +"listadas abaixo, reduzindo o esforço de especificá-los manualmente." -#: index.docbook:1014 +#. Tag: title +#: configuration.xml:1014 +#, no-c-format msgid "Hibernate SQL Dialects (<literal>hibernate.dialect</literal>)" -msgstr "" +msgstr "Hibernate SQL Dialects (<literal>hibernate.dialect</literal>)" -#: index.docbook:1022 +#. Tag: entry +#: configuration.xml:1022 +#, no-c-format msgid "RDBMS" -msgstr "" +msgstr "RDBMS" -#: index.docbook:1023 +#. Tag: entry +#: configuration.xml:1023 +#, fuzzy, no-c-format msgid "Dialect" msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"Dialeto\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"Dialect" -#: index.docbook:1028 +#. Tag: entry +#: configuration.xml:1028 +#, no-c-format msgid "<entry>DB2</entry>" msgstr "" -#: index.docbook:1028 +#. Tag: literal +#: configuration.xml:1028 +#, no-c-format msgid "org.hibernate.dialect.DB2Dialect" -msgstr "" +msgstr "org.hibernate.dialect.DB2Dialect" -#: index.docbook:1031 +#. Tag: entry +#: configuration.xml:1031 +#, no-c-format msgid "DB2 AS/400" -msgstr "" +msgstr "DB2 AS/400" -#: index.docbook:1031 +#. Tag: literal +#: configuration.xml:1031 +#, no-c-format msgid "org.hibernate.dialect.DB2400Dialect" -msgstr "" +msgstr "org.hibernate.dialect.DB2400Dialect" -#: index.docbook:1034 +#. Tag: entry +#: configuration.xml:1034 +#, no-c-format msgid "DB2 OS390" -msgstr "" +msgstr "DB2 OS390" -#: index.docbook:1034 +#. Tag: literal +#: configuration.xml:1034 +#, no-c-format msgid "org.hibernate.dialect.DB2390Dialect" -msgstr "" +msgstr "org.hibernate.dialect.DB2390Dialect" -#: index.docbook:1037 +#. Tag: entry +#: configuration.xml:1037 +#, no-c-format msgid "PostgreSQL" -msgstr "" +msgstr "PostgreSQL" -#: index.docbook:1037 +#. Tag: literal +#: configuration.xml:1037 +#, no-c-format msgid "org.hibernate.dialect.PostgreSQLDialect" -msgstr "" +msgstr "org.hibernate.dialect.PostgreSQLDialect" -#: index.docbook:1040 +#. Tag: entry +#: configuration.xml:1040 +#, no-c-format msgid "MySQL" -msgstr "" +msgstr "MySQL" -#: index.docbook:1040 +#. Tag: literal +#: configuration.xml:1040 +#, no-c-format msgid "org.hibernate.dialect.MySQLDialect" -msgstr "" +msgstr "org.hibernate.dialect.MySQLDialect" -#: index.docbook:1043 +#. Tag: entry +#: configuration.xml:1043 +#, no-c-format msgid "MySQL with InnoDB" -msgstr "" +msgstr "MySQL with InnoDB" -#: index.docbook:1043 +#. Tag: literal +#: configuration.xml:1043 +#, no-c-format msgid "org.hibernate.dialect.MySQLInnoDBDialect" -msgstr "" +msgstr "org.hibernate.dialect.MySQLInnoDBDialect" -#: index.docbook:1046 +#. Tag: entry +#: configuration.xml:1046 +#, no-c-format msgid "MySQL with MyISAM" -msgstr "" +msgstr "MySQL with MyISAM" -#: index.docbook:1046 +#. Tag: literal +#: configuration.xml:1046 +#, no-c-format msgid "org.hibernate.dialect.MySQLMyISAMDialect" -msgstr "" +msgstr "org.hibernate.dialect.MySQLMyISAMDialect" -#: index.docbook:1049 +#. Tag: entry +#: configuration.xml:1049 +#, no-c-format msgid "Oracle (any version)" -msgstr "" +msgstr "Oracle (any version)" -#: index.docbook:1049 +#. Tag: literal +#: configuration.xml:1049 +#, no-c-format msgid "org.hibernate.dialect.OracleDialect" -msgstr "" +msgstr "org.hibernate.dialect.OracleDialect" -#: index.docbook:1052 +#. Tag: entry +#: configuration.xml:1052 +#, no-c-format msgid "Oracle 9i/10g" -msgstr "" +msgstr "Oracle 9i/10g" -#: index.docbook:1052 +#. Tag: literal +#: configuration.xml:1052 +#, no-c-format msgid "org.hibernate.dialect.Oracle9Dialect" -msgstr "" +msgstr "org.hibernate.dialect.Oracle9Dialect" -#: index.docbook:1055 +#. Tag: entry +#: configuration.xml:1055 +#, no-c-format msgid "Sybase" -msgstr "" +msgstr "Sybase" -#: index.docbook:1055 +#. Tag: literal +#: configuration.xml:1055 +#, no-c-format msgid "org.hibernate.dialect.SybaseDialect" -msgstr "" +msgstr "org.hibernate.dialect.SybaseDialect" -#: index.docbook:1058 +#. Tag: entry +#: configuration.xml:1058 +#, no-c-format msgid "Sybase Anywhere" -msgstr "" +msgstr "Sybase Anywhere" -#: index.docbook:1058 +#. Tag: literal +#: configuration.xml:1058 +#, no-c-format msgid "org.hibernate.dialect.SybaseAnywhereDialect" -msgstr "" +msgstr "org.hibernate.dialect.SybaseAnywhereDialect" -#: index.docbook:1061 +#. Tag: entry +#: configuration.xml:1061 +#, no-c-format msgid "Microsoft SQL Server" -msgstr "" +msgstr "Microsoft SQL Server" -#: index.docbook:1061 +#. Tag: literal +#: configuration.xml:1061 +#, no-c-format msgid "org.hibernate.dialect.SQLServerDialect" -msgstr "" +msgstr "org.hibernate.dialect.SQLServerDialect" -#: index.docbook:1064 +#. Tag: entry +#: configuration.xml:1064 +#, no-c-format msgid "SAP DB" -msgstr "" +msgstr "SAP DB" -#: index.docbook:1064 +#. Tag: literal +#: configuration.xml:1064 +#, no-c-format msgid "org.hibernate.dialect.SAPDBDialect" -msgstr "" +msgstr "org.hibernate.dialect.SAPDBDialect" -#: index.docbook:1067 +#. Tag: entry +#: configuration.xml:1067 +#, no-c-format msgid "Informix" -msgstr "" +msgstr "Informix" -#: index.docbook:1067 +#. Tag: literal +#: configuration.xml:1067 +#, no-c-format msgid "org.hibernate.dialect.InformixDialect" -msgstr "" +msgstr "org.hibernate.dialect.InformixDialect" -#: index.docbook:1070 +#. Tag: entry +#: configuration.xml:1070 +#, no-c-format msgid "HypersonicSQL" -msgstr "" +msgstr "HypersonicSQL" -#: index.docbook:1070 +#. Tag: literal +#: configuration.xml:1070 +#, no-c-format msgid "org.hibernate.dialect.HSQLDialect" -msgstr "" +msgstr "org.hibernate.dialect.HSQLDialect" -#: index.docbook:1073 +#. Tag: entry +#: configuration.xml:1073 +#, no-c-format msgid "Ingres" -msgstr "" +msgstr "Ingres" -#: index.docbook:1073 +#. Tag: literal +#: configuration.xml:1073 +#, no-c-format msgid "org.hibernate.dialect.IngresDialect" -msgstr "" +msgstr "org.hibernate.dialect.IngresDialect" -#: index.docbook:1076 +#. Tag: entry +#: configuration.xml:1076 +#, no-c-format msgid "Progress" -msgstr "" +msgstr "Progress" -#: index.docbook:1076 +#. Tag: literal +#: configuration.xml:1076 +#, no-c-format msgid "org.hibernate.dialect.ProgressDialect" -msgstr "" +msgstr "org.hibernate.dialect.ProgressDialect" -#: index.docbook:1079 +#. Tag: entry +#: configuration.xml:1079 +#, no-c-format msgid "Mckoi SQL" -msgstr "" +msgstr "Mckoi SQL" -#: index.docbook:1079 +#. Tag: literal +#: configuration.xml:1079 +#, no-c-format msgid "org.hibernate.dialect.MckoiDialect" -msgstr "" +msgstr "org.hibernate.dialect.MckoiDialect" -#: index.docbook:1082 +#. Tag: entry +#: configuration.xml:1082 +#, no-c-format msgid "Interbase" -msgstr "" +msgstr "Interbase" -#: index.docbook:1082 +#. Tag: literal +#: configuration.xml:1082 +#, no-c-format msgid "org.hibernate.dialect.InterbaseDialect" -msgstr "" +msgstr "org.hibernate.dialect.InterbaseDialect" -#: index.docbook:1085 +#. Tag: entry +#: configuration.xml:1085 +#, no-c-format msgid "Pointbase" -msgstr "" +msgstr "Pointbase" -#: index.docbook:1085 +#. Tag: literal +#: configuration.xml:1085 +#, no-c-format msgid "org.hibernate.dialect.PointbaseDialect" -msgstr "" +msgstr "org.hibernate.dialect.PointbaseDialect" -#: index.docbook:1088 +#. Tag: entry +#: configuration.xml:1088 +#, no-c-format msgid "FrontBase" -msgstr "" +msgstr "FrontBase" -#: index.docbook:1088 +#. Tag: literal +#: configuration.xml:1088 +#, no-c-format msgid "org.hibernate.dialect.FrontbaseDialect" -msgstr "" +msgstr "org.hibernate.dialect.FrontbaseDialect" -#: index.docbook:1091 +#. Tag: entry +#: configuration.xml:1091 +#, no-c-format msgid "Firebird" -msgstr "" +msgstr "Firebird" -#: index.docbook:1091 +#. Tag: literal +#: configuration.xml:1091 +#, no-c-format msgid "org.hibernate.dialect.FirebirdDialect" -msgstr "" +msgstr "org.hibernate.dialect.FirebirdDialect" -#: index.docbook:1100 +#. Tag: title +#: configuration.xml:1100 +#, no-c-format msgid "Outer Join Fetching" -msgstr "" +msgstr "Recuperação por união externa (Outer Join Fetching)" -#: index.docbook:1102 -msgid "If your database supports ANSI, Oracle or Sybase style outer joins, <emphasis>outer join fetching</emphasis> will often increase performance by limiting the number of round trips to and from the database (at the cost of possibly more work performed by the database itself). Outer join fetching allows a whole graph of objects connected by many-to-one, one-to-many, many-to-many and one-to-one associations to be retrieved in a single SQL <literal>SELECT</literal>." +#. Tag: para +#: configuration.xml:1102 +#, no-c-format +msgid "" +"If your database supports ANSI, Oracle or Sybase style outer joins, " +"<emphasis>outer join fetching</emphasis> will often increase performance by " +"limiting the number of round trips to and from the database (at the cost of " +"possibly more work performed by the database itself). Outer join fetching " +"allows a whole graph of objects connected by many-to-one, one-to-many, many-" +"to-many and one-to-one associations to be retrieved in a single SQL " +"<literal>SELECT</literal>." msgstr "" +"Se seu banco de dados suporta Recuperação por união externa (Outer Join " +"Fetching) no estilo ANSI, Oracle ou Sybase, A recuperação por união externa " +"(Outer Join Fetching) frequentemente aumentará o desempenho limitando o " +"número de chamadas (round trips) ao banco de dados( ao custo de " +"possivelmente mais trabalho desempenhado pelo próprio banco de dados). A " +"recuperação por união externa (Outer Join Fetching)permite um gráfico " +"completo de objetos conectados por muitos-para-um, um-para-muitos, muitos-" +"para-muitos e associações um-para-um para ser recuperadas em um simples " +"instrução SQL SELECT ." -#: index.docbook:1111 -msgid "Outer join fetching may be disabled <emphasis>globally</emphasis> by setting the property <literal>hibernate.max_fetch_depth</literal> to <literal>0</literal>. A setting of <literal>1</literal> or higher enables outer join fetching for one-to-one and many-to-one associations which have been mapped with <literal>fetch=\"join\"</literal>." +#. Tag: para +#: configuration.xml:1111 +#, no-c-format +msgid "" +"Outer join fetching may be disabled <emphasis>globally</emphasis> by setting " +"the property <literal>hibernate.max_fetch_depth</literal> to <literal>0</" +"literal>. A setting of <literal>1</literal> or higher enables outer join " +"fetching for one-to-one and many-to-one associations which have been mapped " +"with <literal>fetch=\"join\"</literal>." msgstr "" +"A recuperação por união externa (Outer Join Fetching) pode ser desabilitado " +"<emphasis>globalmente</emphasis> setando a propriedade <literal>hibernate." +"max_fetch_depth</literal> para <literal>0</literal>. Uma valor 1 ou maior " +"habilita o outer join fetching para associações um-para-um e muitos-para-" +"umos cujos quais tem sido mapeado com <literal>fetch=\"join\"</literal>." -#: index.docbook:1119 +#. Tag: para +#: configuration.xml:1119 +#, no-c-format msgid "See <xref linkend=\"performance-fetching\"/> for more information." -msgstr "" +msgstr "Veja <xref linkend=\"performance-fetching\"/> para mais informações." -#: index.docbook:1126 +#. Tag: title +#: configuration.xml:1126 +#, no-c-format msgid "Binary Streams" -msgstr "" +msgstr "Fluxos Binários (Binary Streams)" -#: index.docbook:1128 -msgid "Oracle limits the size of <literal>byte</literal> arrays that may be passed to/from its JDBC driver. If you wish to use large instances of <literal>binary</literal> or <literal>serializable</literal> type, you should enable <literal>hibernate.jdbc.use_streams_for_binary</literal>. <emphasis>This is a system-level setting only.</emphasis>" +#. Tag: para +#: configuration.xml:1128 +#, no-c-format +msgid "" +"Oracle limits the size of <literal>byte</literal> arrays that may be passed " +"to/from its JDBC driver. If you wish to use large instances of " +"<literal>binary</literal> or <literal>serializable</literal> type, you " +"should enable <literal>hibernate.jdbc.use_streams_for_binary</literal>. " +"<emphasis>This is a system-level setting only.</emphasis>" msgstr "" +"O Oracle limita o tamanho de arrays de <literal>byte</literal> que pode ser " +"passado para/de o driver JDBC. Se você desejar usar grandes instâncias de " +"tipos <literal>binary</literal> ou <literal>serializable</literal>, você " +"deve habilitar <literal>hibernate.jdbc.use_streams_for_binary</literal>. " +"<emphasis>Essa é uma configuração que só pode ser feita a nível de sistema.</" +"emphasis>" -#: index.docbook:1139 +#. Tag: title +#: configuration.xml:1139 +#, no-c-format msgid "Second-level and query cache" -msgstr "" +msgstr "Cachê de segundo nível e query" -#: index.docbook:1141 -msgid "The properties prefixed by <literal>hibernate.cache</literal> allow you to use a process or cluster scoped second-level cache system with Hibernate. See the <xref linkend=\"performance-cache\"/> for more details." +#. Tag: para +#: configuration.xml:1141 +#, no-c-format +msgid "" +"The properties prefixed by <literal>hibernate.cache</literal> allow you to " +"use a process or cluster scoped second-level cache system with Hibernate. " +"See the <xref linkend=\"performance-cache\"/> for more details." msgstr "" +"As propriedades prefixadas pelo <literal>hibernate.cache</literal> permite " +"você usar um sistema de cachê de segundo nível em um processo executado em " +"clustercom Hibernate. Veja <xref linkend=\"performance-cache\"/> para mais " +"detalhes." -#: index.docbook:1151 +#. Tag: title +#: configuration.xml:1151 +#, no-c-format msgid "Query Language Substitution" -msgstr "" +msgstr "Substituições na Linguagem de Consulta" -#: index.docbook:1153 -msgid "You may define new Hibernate query tokens using <literal>hibernate.query.substitutions</literal>. For example:" +#. Tag: para +#: configuration.xml:1153 +#, no-c-format +msgid "" +"You may define new Hibernate query tokens using <literal>hibernate.query." +"substitutions</literal>. For example:" msgstr "" +"Você pode definir novos símbolos de consulta Hibernate usando " +"<literal>hibernate.query.substitutions</literal>. Por exemplo:" -#: index.docbook:1158 +#. Tag: programlisting +#: configuration.xml:1158 +#, no-c-format msgid "hibernate.query.substitutions true=1, false=0" -msgstr "" +msgstr "hibernate.query.substitutions true=1, false=0" -#: index.docbook:1160 -msgid "would cause the tokens <literal>true</literal> and <literal>false</literal> to be translated to integer literals in the generated SQL." +#. Tag: para +#: configuration.xml:1160 +#, no-c-format +msgid "" +"would cause the tokens <literal>true</literal> and <literal>false</literal> " +"to be translated to integer literals in the generated SQL." msgstr "" +"Faria com que os símbolos <literal>true</literal> e <literal>false</literal> " +"passasem a ser traduzidos para literais inteiro no SQL gerado." -#: index.docbook:1165 +#. Tag: programlisting +#: configuration.xml:1165 +#, no-c-format msgid "hibernate.query.substitutions toLowercase=LOWER" -msgstr "" +msgstr "hibernate.query.substitutions toLowercase=LOWER" -#: index.docbook:1167 +#. Tag: para +#: configuration.xml:1167 +#, no-c-format msgid "would allow you to rename the SQL <literal>LOWER</literal> function." -msgstr "" +msgstr "permitirá você renomear a função <literal>LOWER</literal> no SQL." -#: index.docbook:1174 +#. Tag: title +#: configuration.xml:1174 +#, no-c-format msgid "Hibernate statistics" -msgstr "" +msgstr "Estatísticas do Hibernate" -#: index.docbook:1176 -msgid "If you enable <literal>hibernate.generate_statistics</literal>, Hibernate will expose a number of metrics that are useful when tuning a running system via <literal>SessionFactory.getStatistics()</literal>. Hibernate can even be configured to expose these statistics via JMX. Read the Javadoc of the interfaces in <literal>org.hibernate.stats</literal> for more information." +#. Tag: para +#: configuration.xml:1176 +#, no-c-format +msgid "" +"If you enable <literal>hibernate.generate_statistics</literal>, Hibernate " +"will expose a number of metrics that are useful when tuning a running system " +"via <literal>SessionFactory.getStatistics()</literal>. Hibernate can even be " +"configured to expose these statistics via JMX. Read the Javadoc of the " +"interfaces in <literal>org.hibernate.stats</literal> for more information." msgstr "" +"If you enable <literal>hibernate.generate_statistics</literal>, Hibernate " +"will expose a number of metrics that are useful when tuning a running system " +"via <literal>SessionFactory.getStatistics()</literal>. Hibernate can even be " +"configured to expose these statistics via JMX. Read the Javadoc of the " +"interfaces in <literal>org.hibernate.stats</literal> for more information. " +"Se você habilitar <literal>hibernate.generate_statistics</literal>, o " +"Hibernate exibirá um número de métricas bastante útil ao ajustar um sistema " +"via <literal>SessionFactory.getStatistics()</literal>. O Hibernate pode até " +"ser configurado para exibir essas estatísticas via JMX. Leia o Javadoc da " +"interface <literal>org.hibernate.stats</literal> para mais informações." -#: index.docbook:1188 +#. Tag: title +#: configuration.xml:1188 +#, no-c-format msgid "Logging" -msgstr "" +msgstr "Logging" -#: index.docbook:1190 +#. Tag: para +#: configuration.xml:1190 +#, no-c-format msgid "Hibernate logs various events using Apache commons-logging." -msgstr "" +msgstr "Hibernate registra vários eventos usando Apache commons-logging." -#: index.docbook:1194 -msgid "The commons-logging service will direct output to either Apache Log4j (if you include <literal>log4j.jar</literal> in your classpath) or JDK1.4 logging (if running under JDK1.4 or above). You may download Log4j from <literal>http://jakarta.apache.org</literal>. To use Log4j you will need to place a <literal>log4j.properties</literal> file in your classpath, an example properties file is distributed with Hibernate in the <literal>src/</literal> directory." +#. Tag: para +#: configuration.xml:1194 +#, no-c-format +msgid "" +"The commons-logging service will direct output to either Apache Log4j (if " +"you include <literal>log4j.jar</literal> in your classpath) or JDK1.4 " +"logging (if running under JDK1.4 or above). You may download Log4j from " +"<literal>http://jakarta.apache.org</literal>. To use Log4j you will need to " +"place a <literal>log4j.properties</literal> file in your classpath, an " +"example properties file is distributed with Hibernate in the <literal>src/</" +"literal> directory." msgstr "" +"O serviço commons-logging direcionará a saída para o Apache Log4j ( se você " +"incluir <literal>log4j.jar</literal>r no seu classpath) ou JDK1.4 logging" +"( se estiver em uso JDK1.4 ou maior). Você pode fazer o download do Log4j a " +"partir de <literal>http://jakarta.apache.org</literal>. Para usar Log4j você " +"necessitará colocar um arquivo <literal>log4j.properties</literal> no seu " +"classpath, um exemplo de arquivo de propriedades é distribuído com o " +"Hibernate no diretório <literal>src/</literal>." -#: index.docbook:1204 -msgid "We strongly recommend that you familiarize yourself with Hibernate's log messages. A lot of work has been put into making the Hibernate log as detailed as possible, without making it unreadable. It is an essential troubleshooting device. The most interesting log categories are the following:" +#. Tag: para +#: configuration.xml:1204 +#, no-c-format +msgid "" +"We strongly recommend that you familiarize yourself with Hibernate's log " +"messages. A lot of work has been put into making the Hibernate log as " +"detailed as possible, without making it unreadable. It is an essential " +"troubleshooting device. The most interesting log categories are the " +"following:" msgstr "" +"We strongly recommend that you familiarize yourself with Hibernate's log " +"messages. A lot of work has been put into making the Hibernate log as " +"detailed as possible, without making it unreadable. It is an essential " +"troubleshooting device. The most interesting log categories are the " +"following: Nós recomendamos enfaticamente que você se familiarize-se com " +"mensagens de log do Hibernate. Uma parte do trabalho tem sido posto em fazer " +"o log Hibernate tão detalhado quanto possível, sem fazê-lo ilegível. É um " +"essencial dispositivos de controle de erros. As categorias de log mais " +"interessantes são as seguintes:" -#: index.docbook:1213 +#. Tag: title +#: configuration.xml:1213 +#, no-c-format msgid "Hibernate Log Categories" -msgstr "" +msgstr "Categorias de Log do Hibernate" -#: index.docbook:1219 +#. Tag: entry +#: configuration.xml:1219 +#, no-c-format msgid "Category" -msgstr "" +msgstr "Categoria" -#: index.docbook:1220 +#. Tag: entry +#: configuration.xml:1220 +#, no-c-format msgid "Function" -msgstr "" +msgstr "Função" -#: index.docbook:1225 +#. Tag: literal +#: configuration.xml:1225 +#, no-c-format msgid "org.hibernate.SQL" -msgstr "" +msgstr "org.hibernate.SQL" -#: index.docbook:1226 +#. Tag: entry +#: configuration.xml:1226 +#, no-c-format msgid "Log all SQL DML statements as they are executed" -msgstr "" +msgstr "Registra todas as instruções SQL DML a medida que elas são executadas" -#: index.docbook:1229 +#. Tag: literal +#: configuration.xml:1229 +#, no-c-format msgid "org.hibernate.type" -msgstr "" +msgstr "org.hibernate.type" -#: index.docbook:1230 +#. Tag: entry +#: configuration.xml:1230 +#, no-c-format msgid "Log all JDBC parameters" -msgstr "" +msgstr "Registra todos os parâmetros JDBC" -#: index.docbook:1233 +#. Tag: literal +#: configuration.xml:1233 +#, no-c-format msgid "org.hibernate.tool.hbm2ddl" -msgstr "" +msgstr "org.hibernate.tool.hbm2ddl" -#: index.docbook:1234 +#. Tag: entry +#: configuration.xml:1234 +#, no-c-format msgid "Log all SQL DDL statements as they are executed" -msgstr "" +msgstr "Registra todas as instruções SQL DDL a medida que elas são executadas" -#: index.docbook:1237 +#. Tag: literal +#: configuration.xml:1237 +#, no-c-format msgid "org.hibernate.pretty" -msgstr "" +msgstr "org.hibernate.pretty" -#: index.docbook:1238 -msgid "Log the state of all entities (max 20 entities) associated with the session at flush time" +#. Tag: entry +#: configuration.xml:1238 +#, no-c-format +msgid "" +"Log the state of all entities (max 20 entities) associated with the session " +"at flush time" msgstr "" +"Log the state of all entities (max 20 entities) associated with the session " +"at flush time Registra o estado de todas as entidades (máximo 20 entidades) " +"associadas a session no momento da limpeza (flush)." -#: index.docbook:1244 +#. Tag: literal +#: configuration.xml:1244 +#, no-c-format msgid "org.hibernate.cache" -msgstr "" +msgstr "org.hibernate.cache" -#: index.docbook:1245 +#. Tag: entry +#: configuration.xml:1245 +#, no-c-format msgid "Log all second-level cache activity" -msgstr "" +msgstr "Registra todas as atividades de cachê de segundo nível" -#: index.docbook:1248 +#. Tag: literal +#: configuration.xml:1248 +#, no-c-format msgid "org.hibernate.transaction" -msgstr "" +msgstr "org.hibernate.transaction" -#: index.docbook:1249 +#. Tag: entry +#: configuration.xml:1249 +#, no-c-format msgid "Log transaction related activity" -msgstr "" +msgstr "Registra atividades relacionada a transação" -#: index.docbook:1252 +#. Tag: literal +#: configuration.xml:1252 +#, no-c-format msgid "org.hibernate.jdbc" -msgstr "" +msgstr "org.hibernate.jdbc" -#: index.docbook:1253 +#. Tag: entry +#: configuration.xml:1253 +#, no-c-format msgid "Log all JDBC resource acquisition" -msgstr "" +msgstr "Registra todas as requisições de recursos JDBC" -#: index.docbook:1256 +#. Tag: literal +#: configuration.xml:1256 +#, no-c-format msgid "org.hibernate.hql.ast.AST" -msgstr "" +msgstr "org.hibernate.hql.ast.AST" -#: index.docbook:1257 +#. Tag: entry +#: configuration.xml:1257 +#, no-c-format msgid "Log HQL and SQL ASTs during query parsing" -msgstr "" +msgstr "Registra instruções SQL e HQL durante a análise da consultas" -#: index.docbook:1262 +#. Tag: literal +#: configuration.xml:1262 +#, no-c-format msgid "org.hibernate.secure" -msgstr "" +msgstr "org.hibernate.secure" -#: index.docbook:1263 +#. Tag: entry +#: configuration.xml:1263 +#, no-c-format msgid "Log all JAAS authorization requests" -msgstr "" +msgstr "Registra todas as requisições de autorização JAAS" -#: index.docbook:1266 +#. Tag: literal +#: configuration.xml:1266 +#, no-c-format msgid "org.hibernate" -msgstr "" +msgstr "org.hibernate" -#: index.docbook:1267 -msgid "Log everything (a lot of information, but very useful for troubleshooting)" +#. Tag: entry +#: configuration.xml:1267 +#, no-c-format +msgid "" +"Log everything (a lot of information, but very useful for troubleshooting)" msgstr "" +"Registra tudo ( uma parte das informações, mas muito útil para controle de " +"erros )" -#: index.docbook:1276 -msgid "When developing applications with Hibernate, you should almost always work with <literal>debug</literal> enabled for the category <literal>org.hibernate.SQL</literal>, or, alternatively, the property <literal>hibernate.show_sql</literal> enabled." +#. Tag: para +#: configuration.xml:1276 +#, no-c-format +msgid "" +"When developing applications with Hibernate, you should almost always work " +"with <literal>debug</literal> enabled for the category <literal>org." +"hibernate.SQL</literal>, or, alternatively, the property <literal>hibernate." +"show_sql</literal> enabled." msgstr "" +"Quando desenvolver aplicações com Hibernate, você deve quase sempre " +"trabalhar com debug <literal>debug</literal> para a categoria <literal>org." +"hibernate.SQL</literal>, ou, alternativamente, a com a propriedade " +"<literal>hibernate.show_sql</literal> habilitada." -#: index.docbook:1286 +#. Tag: title +#: configuration.xml:1286 +#, no-c-format msgid "Implementing a <literal>NamingStrategy</literal>" -msgstr "" +msgstr "Implementado uma <literal>NamingStrategy</literal>" -#: index.docbook:1288 -msgid "The interface <literal>org.hibernate.cfg.NamingStrategy</literal> allows you to specify a \"naming standard\" for database objects and schema elements." +#. Tag: para +#: configuration.xml:1288 +#, no-c-format +msgid "" +"The interface <literal>org.hibernate.cfg.NamingStrategy</literal> allows you " +"to specify a \"naming standard\" for database objects and schema elements." msgstr "" +"A interface <literal>org.hibernate.cfg.NamingStrategy</literal> permite você " +"especificar um \"padrão de nomeação\" para objetos do banco de dados e " +"elementos schema." -#: index.docbook:1293 -msgid "You may provide rules for automatically generating database identifiers from Java identifiers or for processing \"logical\" column and table names given in the mapping file into \"physical\" table and column names. This feature helps reduce the verbosity of the mapping document, eliminating repetitive noise (<literal>TBL_</literal> prefixes, for example). The default strategy used by Hibernate is quite minimal." +#. Tag: para +#: configuration.xml:1293 +#, no-c-format +msgid "" +"You may provide rules for automatically generating database identifiers from " +"Java identifiers or for processing \"logical\" column and table names given " +"in the mapping file into \"physical\" table and column names. This feature " +"helps reduce the verbosity of the mapping document, eliminating repetitive " +"noise (<literal>TBL_</literal> prefixes, for example). The default strategy " +"used by Hibernate is quite minimal." msgstr "" +"Você deve criar regras para a geração automaticamente de identificadores do " +"banco de dados a partir de identificadores Java ou para processar colunas " +"\"computadas\" e nomes de tabelas dado o arquivo de mapeamento para nomes " +"\"físicos\" de tabelas e colunas. Esta característica ajuda a reduzir a " +"verbosidade do documento de mapeamento, eliminando interferências repetitivas" +"( <literal>TBL_</literal>prefixos, por exemplo). A estratégia default usada " +"pelo Hibernate é completamente mínima." -#: index.docbook:1302 -msgid "You may specify a different strategy by calling <literal>Configuration.setNamingStrategy()</literal> before adding mappings:" +#. Tag: para +#: configuration.xml:1302 +#, no-c-format +msgid "" +"You may specify a different strategy by calling <literal>Configuration." +"setNamingStrategy()</literal> before adding mappings:" msgstr "" +"Você pode especificar uma estratégia diferente ao chamar " +"<literal>Configuration.setNamingStrategy()</literal> antes de adicionar os " +"mapeamentos:" -#: index.docbook:1307 +#. Tag: programlisting +#: configuration.xml:1307 +#, no-c-format msgid "" - "<![CDATA[SessionFactory sf = new Configuration()\n" - " .setNamingStrategy(ImprovedNamingStrategy.INSTANCE)\n" - " .addFile(\"Item.hbm.xml\")\n" - " .addFile(\"Bid.hbm.xml\")\n" - " .buildSessionFactory();]]>" +"<![CDATA[SessionFactory sf = new Configuration()\n" +" .setNamingStrategy(ImprovedNamingStrategy.INSTANCE)\n" +" .addFile(\"Item.hbm.xml\")\n" +" .addFile(\"Bid.hbm.xml\")\n" +" .buildSessionFactory();]]>" msgstr "" -#: index.docbook:1309 -msgid "<literal>org.hibernate.cfg.ImprovedNamingStrategy</literal> is a built-in strategy that might be a useful starting point for some applications." +#. Tag: para +#: configuration.xml:1309 +#, no-c-format +msgid "" +"<literal>org.hibernate.cfg.ImprovedNamingStrategy</literal> is a built-in " +"strategy that might be a useful starting point for some applications." msgstr "" +"<literal>org.hibernate.cfg.ImprovedNamingStrategy</literal> é uma estratégia " +"interna que pode ser um ponto de começo útil para algumas aplicações." -#: index.docbook:1317 +#. Tag: title +#: configuration.xml:1317 +#, no-c-format msgid "XML configuration file" -msgstr "" +msgstr "Arquivo de configuração XML" -#: index.docbook:1319 -msgid "An alternative approach to configuration is to specify a full configuration in a file named <literal>hibernate.cfg.xml</literal>. This file can be used as a replacement for the <literal>hibernate.properties</literal> file or, if both are present, to override properties." +#. Tag: para +#: configuration.xml:1319 +#, no-c-format +msgid "" +"An alternative approach to configuration is to specify a full configuration " +"in a file named <literal>hibernate.cfg.xml</literal>. This file can be used " +"as a replacement for the <literal>hibernate.properties</literal> file or, if " +"both are present, to override properties." msgstr "" +"Uma maneira alternativa de configuração é especificar uma configuração " +"completa em um arquivo chamado <literal>hibernate.cfg.xml</literal>. Este " +"arquivo pode ser usado como um substituto para o arquivo <literal>hibernate." +"properties</literal> ou, se ambos estão presentes, sobrescrever propriedades." -#: index.docbook:1326 -msgid "The XML configuration file is by default expected to be in the root o your <literal>CLASSPATH</literal>. Here is an example:" +#. Tag: para +#: configuration.xml:1326 +#, no-c-format +msgid "" +"The XML configuration file is by default expected to be in the root o your " +"<literal>CLASSPATH</literal>. Here is an example:" msgstr "" +"The XML configuration file is by default expected to be in the root o your " +"<literal>CLASSPATH</literal>. Here is an example: O arquivo XML de " +"configuração é por default esperado para estar na raiz do seu " +"<literal>CLASSPATH</literal>. Veja um exemplo:" -#: index.docbook:1331 +#. Tag: programlisting +#: configuration.xml:1331 +#, no-c-format msgid "" - "<![CDATA[<?xml version='1.0' encoding='utf-8'?>\n" - "<!DOCTYPE hibernate-configuration PUBLIC\n" - " \"-//Hibernate/Hibernate Configuration DTD//EN\"\n" - " \"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd\">\n" - "\n" - "<hibernate-configuration>\n" - "\n" - " \n" - " <session-factory\n" - " name=\"java:hibernate/SessionFactory\">\n" - "\n" - " \n" - " <property name=\"connection.datasource\">java:/comp/env/jdbc/MyDB</property>\n" - " <property name=\"dialect\">org.hibernate.dialect.MySQLDialect</property>\n" - " <property name=\"show_sql\">false</property>\n" - " <property name=\"transaction.factory_class\">\n" - " org.hibernate.transaction.JTATransactionFactory\n" - " </property>\n" - " <property name=\"jta.UserTransaction\">java:comp/UserTransaction</property>\n" - "\n" - " \n" - " <mapping resource=\"org/hibernate/auction/Item.hbm.xml\"/>\n" - " <mapping resource=\"org/hibernate/auction/Bid.hbm.xml\"/>\n" - "\n" - " \n" - " <class-cache class=\"org.hibernate.auction.Item\" usage=\"read-write\"/>\n" - " <class-cache class=\"org.hibernate.auction.Bid\" usage=\"read-only\"/>\n" - " <collection-cache collection=\"org.hibernate.auction.Item.bids\" usage=\"read-write\"/>\n" - "\n" - " </session-factory>\n" - "\n" - "</hibernate-configuration>]]>" +"<![CDATA[<?xml version='1.0' encoding='utf-8'?>\n" +"<!DOCTYPE hibernate-configuration PUBLIC\n" +" \"-//Hibernate/Hibernate Configuration DTD//EN\"\n" +" \"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd\">\n" +"\n" +"<hibernate-configuration>\n" +"\n" +" \n" +" <session-factory\n" +" name=\"java:hibernate/SessionFactory\">\n" +"\n" +" \n" +" <property name=\"connection.datasource\">java:/comp/env/jdbc/MyDB</" +"property>\n" +" <property name=\"dialect\">org.hibernate.dialect.MySQLDialect</" +"property>\n" +" <property name=\"show_sql\">false</property>\n" +" <property name=\"transaction.factory_class\">\n" +" org.hibernate.transaction.JTATransactionFactory\n" +" </property>\n" +" <property name=\"jta.UserTransaction\">java:comp/UserTransaction</" +"property>\n" +"\n" +" \n" +" <mapping resource=\"org/hibernate/auction/Item.hbm.xml\"/>\n" +" <mapping resource=\"org/hibernate/auction/Bid.hbm.xml\"/>\n" +"\n" +" \n" +" <class-cache class=\"org.hibernate.auction.Item\" usage=\"read-write" +"\"/>\n" +" <class-cache class=\"org.hibernate.auction.Bid\" usage=\"read-only\"/" +">\n" +" <collection-cache collection=\"org.hibernate.auction.Item.bids\" " +"usage=\"read-write\"/>\n" +"\n" +" </session-factory>\n" +"\n" +"</hibernate-configuration>]]>" msgstr "" -#: index.docbook:1333 -msgid "As you can see, the advantage of this approach is the externalization of the mapping file names to configuration. The <literal>hibernate.cfg.xml</literal> is also more convenient once you have to tune the Hibernate cache. Note that is your choice to use either <literal>hibernate.properties</literal> or <literal>hibernate.cfg.xml</literal>, both are equivalent, except for the above mentioned benefits of using the XML syntax." +#. Tag: para +#: configuration.xml:1333 +#, no-c-format +msgid "" +"As you can see, the advantage of this approach is the externalization of the " +"mapping file names to configuration. The <literal>hibernate.cfg.xml</" +"literal> is also more convenient once you have to tune the Hibernate cache. " +"Note that is your choice to use either <literal>hibernate.properties</" +"literal> or <literal>hibernate.cfg.xml</literal>, both are equivalent, " +"except for the above mentioned benefits of using the XML syntax." msgstr "" +"Como você pode ver, a vantagem deste enfoque é a externalização dos nomes " +"dos arquivos de mapeamento para configuração. O <literal>hibernate.cfg.xml</" +"literal> também é mais conveniente caso você tenha que ajustar o cache do " +"Hibernate. Note que a escolha é sua em usar <literal>hibernate.properties</" +"literal> ou <literal>hibernate.cfg.xml</literal>, ambos são equivalente, à " +"exceção dos benefícios acima mencionados de usar a sintaxe de XML." -#: index.docbook:1342 +#. Tag: para +#: configuration.xml:1342 +#, no-c-format msgid "With the XML configuration, starting Hibernate is then as simple as" msgstr "" +"Com a configuração do XML, iniciar o Hibernate é então tão simples como" -#: index.docbook:1346 -msgid "<![CDATA[SessionFactory sf = new Configuration().configure().buildSessionFactory();]]>" +#. Tag: programlisting +#: configuration.xml:1346 +#, no-c-format +msgid "" +"<![CDATA[SessionFactory sf = new Configuration().configure()." +"buildSessionFactory();]]>" msgstr "" -#: index.docbook:1348 +#. Tag: para +#: configuration.xml:1348 +#, no-c-format msgid "You can pick a different XML configuration file using" -msgstr "" +msgstr "You can pick a different XML configuration file using" -#: index.docbook:1352 +#. Tag: programlisting +#: configuration.xml:1352 +#, no-c-format msgid "" - "<![CDATA[SessionFactory sf = new Configuration()\n" - " .configure(\"catdb.cfg.xml\")\n" - " .buildSessionFactory();]]>" +"<![CDATA[SessionFactory sf = new Configuration()\n" +" .configure(\"catdb.cfg.xml\")\n" +" .buildSessionFactory();]]>" msgstr "" -#: index.docbook:1357 +#. Tag: title +#: configuration.xml:1357 +#, no-c-format msgid "J2EE Application Server integration" -msgstr "" +msgstr "Integração com servidores de aplicação J2EE" -#: index.docbook:1359 +#. Tag: para +#: configuration.xml:1359 +#, no-c-format msgid "Hibernate has the following integration points for J2EE infrastructure:" msgstr "" +"O Hibernate tem os seguintes pontos da integração para o infraestrutura de " +"J2EE:" -#: index.docbook:1365 -msgid "<emphasis>Container-managed datasources</emphasis>: Hibernate can use JDBC connections managed by the container and provided through JNDI. Usually, a JTA compatible <literal>TransactionManager</literal> and a <literal>ResourceManager</literal> take care of transaction management (CMT), esp. distributed transaction handling across several datasources. You may of course also demarcate transaction boundaries programmatically (BMT) or you might want to use the optional Hibernate <literal>Transaction</literal> API for this to keep your code portable." +#. Tag: para +#: configuration.xml:1365 +#, no-c-format +msgid "" +"<emphasis>Container-managed datasources</emphasis>: Hibernate can use JDBC " +"connections managed by the container and provided through JNDI. Usually, a " +"JTA compatible <literal>TransactionManager</literal> and a " +"<literal>ResourceManager</literal> take care of transaction management " +"(CMT), esp. distributed transaction handling across several datasources. You " +"may of course also demarcate transaction boundaries programmatically (BMT) " +"or you might want to use the optional Hibernate <literal>Transaction</" +"literal> API for this to keep your code portable." msgstr "" +"<emphasis>DataSources gerenciados pelo container</emphasis>: O Hibernate " +"pode usar conexões JDBC gerenciadas pelo Container e fornecidas pela JNDI. " +"Geralmente, um <literal>TransactionManager</literal> compatível com JTA e um " +"<literal>ResourceManager</literal> cuidam do gerenciamento da transação " +"( CMT ), especialmente em transações distribuídas manipuladas através de " +"vários DataSources. Naturalmente, você também pode demarcar os limites das " +"transações programaticamente (BMT) ou você poderia querer usar a API " +"opcional do Hibernate <literal>Transaction</literal> para esta manter seu " +"código portável." -#: index.docbook:1380 -msgid "<emphasis>Automatic JNDI binding</emphasis>: Hibernate can bind its <literal>SessionFactory</literal> to JNDI after startup." +#. Tag: para +#: configuration.xml:1380 +#, no-c-format +msgid "" +"<emphasis>Automatic JNDI binding</emphasis>: Hibernate can bind its " +"<literal>SessionFactory</literal> to JNDI after startup." msgstr "" +"<emphasis>Ligação (binding) automática a JNDI</emphasis>: O Hibernate pode " +"associar sua <literal>SessionFactory</literal> a JNDI depois de iniciado." -#: index.docbook:1389 -msgid "<emphasis>JTA Session binding:</emphasis> The Hibernate <literal>Session</literal> may be automatically bound to the scope of JTA transactions. Simply lookup the <literal>SessionFactory</literal> from JNDI and get the current <literal>Session</literal>. Let Hibernate take care of flushing and closing the <literal>Session</literal> when your JTA transaction completes. Transaction demarcation is either declarative (CMT) or programmatic (BMT/UserTransaction)." +#. Tag: para +#: configuration.xml:1389 +#, no-c-format +msgid "" +"<emphasis>JTA Session binding:</emphasis> The Hibernate <literal>Session</" +"literal> may be automatically bound to the scope of JTA transactions. Simply " +"lookup the <literal>SessionFactory</literal> from JNDI and get the current " +"<literal>Session</literal>. Let Hibernate take care of flushing and closing " +"the <literal>Session</literal> when your JTA transaction completes. " +"Transaction demarcation is either declarative (CMT) or programmatic (BMT/" +"UserTransaction)." msgstr "" +"<emphasis>Ligação (binding) Session na JTA:</emphasis> A <literal>Session</" +"literal> do Hibernate pode automaticamente ser ligada ao escopo da " +"transações JTA. Simplesmente localizando a <literal>SessionFactory</literal> " +"da JNDI e obtendo a<literal>Session</literal> corrente. Deixe o Hibernate " +"cuidar da limpeza e encerramento da <literal>Session</literal> quando as " +"transações JTA terminarem. A Demarcação de transação pode ser declarativa " +"(CMT) ou programática(BMT/Transação do usuário)." -#: index.docbook:1402 -msgid "<emphasis>JMX deployment:</emphasis> If you have a JMX capable application server (e.g. JBoss AS), you can chose to deploy Hibernate as a managed MBean. This saves you the one line startup code to build your <literal>SessionFactory</literal> from a <literal>Configuration</literal>. The container will startup your <literal>HibernateService</literal>, and ideally also take care of service dependencies (Datasource has to be available before Hibernate starts, etc)." +#. Tag: para +#: configuration.xml:1402 +#, no-c-format +msgid "" +"<emphasis>JMX deployment:</emphasis> If you have a JMX capable application " +"server (e.g. JBoss AS), you can chose to deploy Hibernate as a managed " +"MBean. This saves you the one line startup code to build your " +"<literal>SessionFactory</literal> from a <literal>Configuration</literal>. " +"The container will startup your <literal>HibernateService</literal>, and " +"ideally also take care of service dependencies (Datasource has to be " +"available before Hibernate starts, etc)." msgstr "" +"<emphasis>JMX deployment:</emphasis> Se você usa um JMX servidor de " +"aplicações capaz (ex. Jboss AS), você pode fazer a instação do Hibernate " +"como um Mbean controlado. Isto evita ter que iniciar uma linha de código " +"para construir sua <literal>SessionFactory</literal> de uma " +"<literal>Configuration</literal>. O container iniciará seu " +"<literal>HibernateService</literal>, e idealmente também cuidará das " +"dependências de serviços (DataSources, têm que estar disponíveis antes do " +"Hibernate iniciar, etc.)." -#: index.docbook:1413 -msgid "Depending on your environment, you might have to set the configuration option <literal>hibernate.connection.aggressive_release</literal> to true if your application server shows \"connection containment\" exceptions." +#. Tag: para +#: configuration.xml:1413 +#, no-c-format +msgid "" +"Depending on your environment, you might have to set the configuration " +"option <literal>hibernate.connection.aggressive_release</literal> to true if " +"your application server shows \"connection containment\" exceptions." msgstr "" +"Dependendo em seu ambiente, você poderia ter que ajustar a opção de " +"configuração <literal>hibernate.connection.aggressive_release</literal> para " +"verdadeiro ( true ), se seu servidor de aplicações lançar exeções \"retenção " +"de conecção\"." -#: index.docbook:1420 +#. Tag: title +#: configuration.xml:1420 +#, no-c-format msgid "Transaction strategy configuration" -msgstr "" +msgstr "Configuração de estratégia de transação" -#: index.docbook:1422 -msgid "The Hibernate <literal>Session</literal> API is independent of any transaction demarcation system in your architecture. If you let Hibernate use JDBC directly, through a connection pool, you may begin and end your transactions by calling the JDBC API. If you run in a J2EE application server, you might want to use bean-managed transactions and call the JTA API and <literal>UserTransaction</literal> when needed." +#. Tag: para +#: configuration.xml:1422 +#, no-c-format +msgid "" +"The Hibernate <literal>Session</literal> API is independent of any " +"transaction demarcation system in your architecture. If you let Hibernate " +"use JDBC directly, through a connection pool, you may begin and end your " +"transactions by calling the JDBC API. If you run in a J2EE application " +"server, you might want to use bean-managed transactions and call the JTA API " +"and <literal>UserTransaction</literal> when needed." msgstr "" +"A API Hibernate <literal>Session</literal> é independente de qualquer " +"sistema de demarcação de transação em sua arquitetura. Se você deixar o " +"Hibernate usar a JDBC diretamente, através de um pool de conexões, você pode " +"inicializar e encerrar suas transações chamando a API JDBC. Se você rodar em " +"um servidor de aplicações J2EE, você poderá usar transações controladas por " +"beans e chamar a API JTA e <literal>UserTransaction</literal> quando " +"necessário." -#: index.docbook:1430 -msgid "To keep your code portable between these two (and other) environments we recommend the optional Hibernate <literal>Transaction</literal> API, which wraps and hides the underlying system. You have to specify a factory class for <literal>Transaction</literal> instances by setting the Hibernate configuration property <literal>hibernate.transaction.factory_class</literal>." +#. Tag: para +#: configuration.xml:1430 +#, no-c-format +msgid "" +"To keep your code portable between these two (and other) environments we " +"recommend the optional Hibernate <literal>Transaction</literal> API, which " +"wraps and hides the underlying system. You have to specify a factory class " +"for <literal>Transaction</literal> instances by setting the Hibernate " +"configuration property <literal>hibernate.transaction.factory_class</" +"literal>." msgstr "" +"Para manter seu código portável entre estes dois ( e outros ) ambientes, " +"recomendamos a API Hibernate <literal>Transaction</literal>, que envolve e " +"esconde o sistema subjacente. Você tem que especificar um classe construtora " +"para <literal>Transaction</literal> instanciar ajustando a propriedade de " +"configuração do <literal>hibernate.transaction.factory_class</literal>." -#: index.docbook:1437 +#. Tag: para +#: configuration.xml:1437 +#, no-c-format msgid "There are three standard (built-in) choices:" -msgstr "" +msgstr "Existem três escolhas (internas) padrões:" -#: index.docbook:1443 +#. Tag: literal +#: configuration.xml:1443 +#, no-c-format msgid "org.hibernate.transaction.JDBCTransactionFactory" -msgstr "" +msgstr "org.hibernate.transaction.JDBCTransactionFactory" -#: index.docbook:1445 +#. Tag: para +#: configuration.xml:1445 +#, no-c-format msgid "delegates to database (JDBC) transactions (default)" -msgstr "" +msgstr "delegada as transações (JDBC)a bases de dados (Padrão)" -#: index.docbook:1449 +#. Tag: literal +#: configuration.xml:1449 +#, no-c-format msgid "org.hibernate.transaction.JTATransactionFactory" -msgstr "" +msgstr "org.hibernate.transaction.JTATransactionFactory" -#: index.docbook:1451 -msgid "delegates to container-managed transaction if an existing transaction is underway in this context (e.g. EJB session bean method), otherwise a new transaction is started and bean-managed transaction are used." +#. Tag: para +#: configuration.xml:1451 +#, no-c-format +msgid "" +"delegates to container-managed transaction if an existing transaction is " +"underway in this context (e.g. EJB session bean method), otherwise a new " +"transaction is started and bean-managed transaction are used." msgstr "" +"delegada a transação a um container gerenciador se a transação existente " +"estiver de acordo neste contexto (ex: método bean sessão EJB), se não uma " +"nova transação é iniciada e uma transação controlado por um bean é usada." -#: index.docbook:1459 +#. Tag: literal +#: configuration.xml:1459 +#, no-c-format msgid "org.hibernate.transaction.CMTTransactionFactory" -msgstr "" +msgstr "org.hibernate.transaction.CMTTransactionFactory" -#: index.docbook:1461 +#. Tag: para +#: configuration.xml:1461 +#, no-c-format msgid "delegates to container-managed JTA transactions" -msgstr "" +msgstr "delega para um container gerenciador de transações JTA" -#: index.docbook:1466 -msgid "You may also define your own transaction strategies (for a CORBA transaction service, for example)." +#. Tag: para +#: configuration.xml:1466 +#, no-c-format +msgid "" +"You may also define your own transaction strategies (for a CORBA transaction " +"service, for example)." msgstr "" +"Você também pode definir suas próprias estratégias de transação ( para um " +"serviço de transação CORBA por exemplo)." -#: index.docbook:1471 -msgid "Some features in Hibernate (i.e. the second level cache, Contextual Sessions with JTA, etc.) require access to the JTA <literal>TransactionManager</literal> in a managed environment. In an application server you have to specify how Hibernate should obtain a reference to the <literal>TransactionManager</literal>, since J2EE does not standardize a single mechanism:" +#. Tag: para +#: configuration.xml:1471 +#, no-c-format +msgid "" +"Some features in Hibernate (i.e. the second level cache, Contextual Sessions " +"with JTA, etc.) require access to the JTA <literal>TransactionManager</" +"literal> in a managed environment. In an application server you have to " +"specify how Hibernate should obtain a reference to the " +"<literal>TransactionManager</literal>, since J2EE does not standardize a " +"single mechanism:" msgstr "" +"Algumas características no Hibernate (ex., o cache de segundo nível, sessões " +"contextuais com JTA, etc.) requerem acesso a JTA " +"<literal>TransactionManager</literal> em um ambiente controlado. Em um " +"servidor de aplicação você tem que especificar como o Hibernate pode obter " +"uma referência para a <literal>TransactionManager</literal>, pois o J2EE não " +"padronize um mecanismo simples :" -#: index.docbook:1479 +#. Tag: title +#: configuration.xml:1479 +#, no-c-format msgid "JTA TransactionManagers" -msgstr "" +msgstr "Gerenciadores de transações JTA" -#: index.docbook:1485 +#. Tag: entry +#: configuration.xml:1485 +#, no-c-format msgid "Transaction Factory" -msgstr "" +msgstr "Transaction Factory" -#: index.docbook:1486 +#. Tag: entry +#: configuration.xml:1486 +#, no-c-format msgid "Application Server" -msgstr "" +msgstr "Application Server" -#: index.docbook:1491 +#. Tag: literal +#: configuration.xml:1491 +#, no-c-format msgid "org.hibernate.transaction.JBossTransactionManagerLookup" -msgstr "" +msgstr "org.hibernate.transaction.JBossTransactionManagerLookup" -#: index.docbook:1492 +#. Tag: entry +#: configuration.xml:1492 +#, no-c-format msgid "JBoss" -msgstr "" +msgstr "JBoss" -#: index.docbook:1495 +#. Tag: literal +#: configuration.xml:1495 +#, no-c-format msgid "org.hibernate.transaction.WeblogicTransactionManagerLookup" -msgstr "" +msgstr "org.hibernate.transaction.WeblogicTransactionManagerLookup" -#: index.docbook:1496 +#. Tag: entry +#: configuration.xml:1496 +#, no-c-format msgid "Weblogic" -msgstr "" +msgstr "Weblogic" -#: index.docbook:1499 +#. Tag: literal +#: configuration.xml:1499 +#, no-c-format msgid "org.hibernate.transaction.WebSphereTransactionManagerLookup" -msgstr "" +msgstr "org.hibernate.transaction.WebSphereTransactionManagerLookup" -#: index.docbook:1500 +#. Tag: entry +#: configuration.xml:1500 +#, no-c-format msgid "WebSphere" -msgstr "" +msgstr "WebSphere" -#: index.docbook:1503 +#. Tag: literal +#: configuration.xml:1503 +#, no-c-format msgid "org.hibernate.transaction.WebSphereExtendedJTATransactionLookup" -msgstr "" +msgstr "org.hibernate.transaction.WebSphereExtendedJTATransactionLookup" -#: index.docbook:1504 +#. Tag: entry +#: configuration.xml:1504 +#, no-c-format msgid "WebSphere 6" -msgstr "" +msgstr "WebSphere 6" -#: index.docbook:1507 +#. Tag: literal +#: configuration.xml:1507 +#, no-c-format msgid "org.hibernate.transaction.OrionTransactionManagerLookup" -msgstr "" +msgstr "org.hibernate.transaction.OrionTransactionManagerLookup" -#: index.docbook:1508 +#. Tag: entry +#: configuration.xml:1508 +#, no-c-format msgid "Orion" -msgstr "" +msgstr "Orion" -#: index.docbook:1511 +#. Tag: literal +#: configuration.xml:1511 +#, no-c-format msgid "org.hibernate.transaction.ResinTransactionManagerLookup" -msgstr "" +msgstr "org.hibernate.transaction.ResinTransactionManagerLookup" -#: index.docbook:1512 +#. Tag: entry +#: configuration.xml:1512 +#, no-c-format msgid "Resin" -msgstr "" +msgstr "Resin" -#: index.docbook:1515 +#. Tag: literal +#: configuration.xml:1515 +#, no-c-format msgid "org.hibernate.transaction.JOTMTransactionManagerLookup" -msgstr "" +msgstr "org.hibernate.transaction.JOTMTransactionManagerLookup" -#: index.docbook:1516 +#. Tag: entry +#: configuration.xml:1516 +#, no-c-format msgid "JOTM" -msgstr "" +msgstr "JOTM" -#: index.docbook:1519 +#. Tag: literal +#: configuration.xml:1519 +#, no-c-format msgid "org.hibernate.transaction.JOnASTransactionManagerLookup" -msgstr "" +msgstr "org.hibernate.transaction.JOnASTransactionManagerLookup" -#: index.docbook:1520 +#. Tag: entry +#: configuration.xml:1520 +#, no-c-format msgid "JOnAS" -msgstr "" +msgstr "JOnAS" -#: index.docbook:1523 +#. Tag: literal +#: configuration.xml:1523 +#, no-c-format msgid "org.hibernate.transaction.JRun4TransactionManagerLookup" -msgstr "" +msgstr "org.hibernate.transaction.JRun4TransactionManagerLookup" -#: index.docbook:1524 +#. Tag: entry +#: configuration.xml:1524 +#, no-c-format msgid "JRun4" -msgstr "" +msgstr "JRun4" -#: index.docbook:1527 +#. Tag: literal +#: configuration.xml:1527 +#, no-c-format msgid "org.hibernate.transaction.BESTransactionManagerLookup" -msgstr "" +msgstr "org.hibernate.transaction.BESTransactionManagerLookup" -#: index.docbook:1528 +#. Tag: entry +#: configuration.xml:1528 +#, no-c-format msgid "Borland ES" -msgstr "" +msgstr "Borland ES" -#: index.docbook:1537 +#. Tag: title +#: configuration.xml:1537 +#, no-c-format msgid "JNDI-bound <literal>SessionFactory</literal>" -msgstr "" +msgstr "<literal>SessionFactory</literal> ligada a JNDI" -#: index.docbook:1539 -msgid "A JNDI bound Hibernate <literal>SessionFactory</literal> can simplify the lookup of the factory and the creation of new <literal>Session</literal>s. Note that this is not related to a JNDI bound <literal>Datasource</literal>, both simply use the same registry!" +#. Tag: para +#: configuration.xml:1539 +#, no-c-format +msgid "" +"A JNDI bound Hibernate <literal>SessionFactory</literal> can simplify the " +"lookup of the factory and the creation of new <literal>Session</literal>s. " +"Note that this is not related to a JNDI bound <literal>Datasource</literal>, " +"both simply use the same registry!" msgstr "" +"Uma <literal>SessionFactory</literal> de Hibernate ligada a JNDI pode " +"simplificar a localização da fabrica e a criação de novas <literal>Session</" +"literal>s. Observe que isto não relacionado a um <literal>Datasource</" +"literal> ligado a JNDI, simplemente ambos usam o mesmo registro!" -#: index.docbook:1546 -msgid "If you wish to have the <literal>SessionFactory</literal> bound to a JNDI namespace, specify a name (eg. <literal>java:hibernate/SessionFactory</literal>) using the property <literal>hibernate.session_factory_name</literal>. If this property is omitted, the <literal>SessionFactory</literal> will not be bound to JNDI. (This is especially useful in environments with a read-only JNDI default implementation, e.g. Tomcat.)" +#. Tag: para +#: configuration.xml:1546 +#, no-c-format +msgid "" +"If you wish to have the <literal>SessionFactory</literal> bound to a JNDI " +"namespace, specify a name (eg. <literal>java:hibernate/SessionFactory</" +"literal>) using the property <literal>hibernate.session_factory_name</" +"literal>. If this property is omitted, the <literal>SessionFactory</literal> " +"will not be bound to JNDI. (This is especially useful in environments with a " +"read-only JNDI default implementation, e.g. Tomcat.)" msgstr "" +"If you wish to have the <literal>SessionFactory</literal> bound to a JNDI " +"namespace, specify a name (eg. <literal>java:hibernate/SessionFactory</" +"literal>) using the property <literal>hibernate.session_factory_name</" +"literal>. If this property is omitted, the <literal>SessionFactory</literal> " +"will not be bound to JNDI. (This is especially useful in environments with a " +"read-only JNDI default implementation, e.g. Tomcat.)" -#: index.docbook:1554 -msgid "When binding the <literal>SessionFactory</literal> to JNDI, Hibernate will use the values of <literal>hibernate.jndi.url</literal>, <literal>hibernate.jndi.class</literal> to instantiate an initial context. If they are not specified, the default <literal>InitialContext</literal> will be used." +#. Tag: para +#: configuration.xml:1554 +#, no-c-format +msgid "" +"When binding the <literal>SessionFactory</literal> to JNDI, Hibernate will " +"use the values of <literal>hibernate.jndi.url</literal>, <literal>hibernate." +"jndi.class</literal> to instantiate an initial context. If they are not " +"specified, the default <literal>InitialContext</literal> will be used." msgstr "" +"When binding the <literal>SessionFactory</literal> to JNDI, Hibernate will " +"use the values of <literal>hibernate.jndi.url</literal>, <literal>hibernate." +"jndi.class</literal> to instantiate an initial context. If they are not " +"specified, the default <literal>InitialContext</literal> will be used." -#: index.docbook:1561 -msgid "Hibernate will automatically place the <literal>SessionFactory</literal> in JNDI after you call <literal>cfg.buildSessionFactory()</literal>. This means you will at least have this call in some startup code (or utility class) in your application, unless you use JMX deployment with the <literal>HibernateService</literal> (discussed later)." +#. Tag: para +#: configuration.xml:1561 +#, no-c-format +msgid "" +"Hibernate will automatically place the <literal>SessionFactory</literal> in " +"JNDI after you call <literal>cfg.buildSessionFactory()</literal>. This means " +"you will at least have this call in some startup code (or utility class) in " +"your application, unless you use JMX deployment with the " +"<literal>HibernateService</literal> (discussed later)." msgstr "" +"Hibernate will automatically place the <literal>SessionFactory</literal> in " +"JNDI after you call <literal>cfg.buildSessionFactory()</literal>. This means " +"you will at least have this call in some startup code (or utility class) in " +"your application, unless you use JMX deployment with the " +"<literal>HibernateService</literal> (discussed later)." -#: index.docbook:1568 -msgid "If you use a JNDI <literal>SessionFactory</literal>, an EJB or any other class may obtain the <literal>SessionFactory</literal> using a JNDI lookup." +#. Tag: para +#: configuration.xml:1568 +#, no-c-format +msgid "" +"If you use a JNDI <literal>SessionFactory</literal>, an EJB or any other " +"class may obtain the <literal>SessionFactory</literal> using a JNDI lookup." msgstr "" +"If you use a JNDI <literal>SessionFactory</literal>, an EJB or any other " +"class may obtain the <literal>SessionFactory</literal> using a JNDI lookup." -#: index.docbook:1573 -msgid "We recommend that you bind the <literal>SessionFactory</literal> to JNDI in a managed environment and use a <literal>static</literal> singleton otherwise. To shield your application code from these details, we also recommend to hide the actual lookup code for a <literal>SessionFactory</literal> in a helper class, such as <literal>HibernateUtil.getSessionFactory()</literal>. Note that such a class is also a convenient way to startup Hibernate—see chapter 1." +#. Tag: para +#: configuration.xml:1573 +#, no-c-format +msgid "" +"We recommend that you bind the <literal>SessionFactory</literal> to JNDI in " +"a managed environment and use a <literal>static</literal> singleton " +"otherwise. To shield your application code from these details, we also " +"recommend to hide the actual lookup code for a <literal>SessionFactory</" +"literal> in a helper class, such as <literal>HibernateUtil.getSessionFactory" +"()</literal>. Note that such a class is also a convenient way to startup " +"Hibernate—see chapter 1." msgstr "" +"We recommend that you bind the <literal>SessionFactory</literal> to JNDI in " +"a managend environment and use a <literal>static</literal> singleton " +"otherwise. To shield your application code from these details, we also " +"recommend to hide the actual lookup code for a <literal>SessionFactory</" +"literal> in a helper class, such as <literal>HibernateUtil.getSessionFactory" +"()</literal>. Note that such a class is also a convenient way to startup " +"Hibernate—see chapter 1." -#: index.docbook:1585 +#. Tag: title +#: configuration.xml:1585 +#, no-c-format msgid "Current Session context management with JTA" -msgstr "" +msgstr "Current Session context management with JTA" -#: index.docbook:1587 -msgid "The easiest way to handle <literal>Session</literal>s and transactions is Hibernates automatic \"current\" <literal>Session</literal> management. See the discussion of <xref linkend=\"architecture-current-session\"/>current sessions. Using the <literal>\"jta\"</literal> session context, if there is no Hibernate <literal>Session</literal> associated with the current JTA transaction, one will be started and associated with that JTA transaction the first time you call <literal>sessionFactory.getCurrentSession()</literal>. The <literal>Session</literal>s retrieved via <literal>getCurrentSession()</literal> in <literal>\"jta\"</literal> context will be set to automatically flush before the transaction completes, close after the transaction completes, and aggressively release JDBC connections after each statement. This allows the <literal>Session</literal>s to be managed by the life cycle of the JTA transaction to which it is associated, keeping user code clean of such man! agement concerns. Your code can either use JTA programmatically through <literal>UserTransaction</literal>, or (recommended for portable code) use the Hibernate <literal>Transaction</literal> API to set transaction boundaries. If you run in an EJB container, declarative transaction demarcation with CMT is preferred." +#. Tag: para +#: configuration.xml:1587 +#, no-c-format +msgid "" +"The easiest way to handle <literal>Session</literal>s and transactions is " +"Hibernates automatic \"current\" <literal>Session</literal> management. See " +"the discussion of <link linkend=\"architecture-current-session\">current " +"sessions</link>. Using the <literal>\"jta\"</literal> session context, if " +"there is no Hibernate <literal>Session</literal> associated with the current " +"JTA transaction, one will be started and associated with that JTA " +"transaction the first time you call <literal>sessionFactory.getCurrentSession" +"()</literal>. The <literal>Session</literal>s retrieved via " +"<literal>getCurrentSession()</literal> in <literal>\"jta\"</literal> context " +"will be set to automatically flush before the transaction completes, close " +"after the transaction completes, and aggressively release JDBC connections " +"after each statement. This allows the <literal>Session</literal>s to be " +"managed by the life cycle of the JTA transaction to which it is associated, " +"keeping user code clean of such management concerns. Your code can either " +"use JTA programmatically through <literal>UserTransaction</literal>, or " +"(recommended for portable code) use the Hibernate <literal>Transaction</" +"literal> API to set transaction boundaries. If you run in an EJB container, " +"declarative transaction demarcation with CMT is preferred." msgstr "" +"The easiest way to handle <literal>Session</literal>s and transactions is " +"Hibernates automatic \"current\" <literal>Session</literal> management. See " +"the discussion of <xref linkend=\"architecture-current-session\">current " +"sessions</xref>. Using the <literal>\"jta\"</literal> session context, if " +"there is no Hibernate <literal>Session</literal> associated with the current " +"JTA transaction, one will be started and associated with that JTA " +"transaction the first time you call <literal>sessionFactory.getCurrentSession" +"()</literal>. The <literal>Session</literal>s retrieved via " +"<literal>getCurrentSession()</literal> in <literal>\"jta\"</literal> context " +"will be set to automatically flush before the transaction completes, close " +"after the transaction completes, and aggressively release JDBC connections " +"after each statement. This allows the <literal>Session</literal>s to be " +"managed by the life cycle of the JTA transaction to which it is associated, " +"keeping user code clean of such management concerns. Your code can either " +"use JTA programmatically through <literal>UserTransaction</literal>, or " +"(recommended for portable code) use the Hibernate <literal>Transaction</" +"literal> API to set transaction boundaries. If you run in an EJB container, " +"declarative transaction demarcation with CMT is preferred." -#: index.docbook:1610 +#. Tag: title +#: configuration.xml:1610 +#, no-c-format msgid "JMX deployment" -msgstr "" +msgstr "JMX deployment" -#: index.docbook:1612 -msgid "The line <literal>cfg.buildSessionFactory()</literal> still has to be executed somewhere to get a <literal>SessionFactory</literal> into JNDI. You can do this either in a <literal>static</literal> initializer block (like the one in <literal>HibernateUtil</literal>) or you deploy Hibernate as a <emphasis>managed service</emphasis>." +#. Tag: para +#: configuration.xml:1612 +#, no-c-format +msgid "" +"The line <literal>cfg.buildSessionFactory()</literal> still has to be " +"executed somewhere to get a <literal>SessionFactory</literal> into JNDI. You " +"can do this either in a <literal>static</literal> initializer block (like " +"the one in <literal>HibernateUtil</literal>) or you deploy Hibernate as a " +"<emphasis>managed service</emphasis>." msgstr "" +"The line <literal>cfg.buildSessionFactory()</literal> still has to be " +"executed somewhere to get a <literal>SessionFactory</literal> into JNDI. You " +"can do this either in a <literal>static</literal> initializer block (like " +"the one in <literal>HibernateUtil</literal>) or you deploy Hibernate as a " +"<emphasis>managed service</emphasis>." -#: index.docbook:1620 -msgid "Hibernate is distributed with <literal>org.hibernate.jmx.HibernateService</literal> for deployment on an application server with JMX capabilities, such as JBoss AS. The actual deployment and configuration is vendor specific. Here is an example <literal>jboss-service.xml</literal> for JBoss 4.0.x:" +#. Tag: para +#: configuration.xml:1620 +#, no-c-format +msgid "" +"Hibernate is distributed with <literal>org.hibernate.jmx.HibernateService</" +"literal> for deployment on an application server with JMX capabilities, such " +"as JBoss AS. The actual deployment and configuration is vendor specific. " +"Here is an example <literal>jboss-service.xml</literal> for JBoss 4.0.x:" msgstr "" +"Hibernate is distributed with <literal>org.hibernate.jmx.HibernateService</" +"literal> for deployment on an application server with JMX capabilities, such " +"as JBoss AS. The actual deployment and configuration is vendor specific. " +"Here is an example <literal>jboss-service.xml</literal> for JBoss 4.0.x:" -#: index.docbook:1627 +#. Tag: programlisting +#: configuration.xml:1627 +#, no-c-format msgid "" - "<![CDATA[<?xml version=\"1.0\"?>\n" - "<server>\n" - "\n" - "<mbean code=\"org.hibernate.jmx.HibernateService\"\n" - " name=\"jboss.jca:service=HibernateFactory,name=HibernateFactory\">\n" - "\n" - " \n" - " <depends>jboss.jca:service=RARDeployer</depends>\n" - " <depends>jboss.jca:service=LocalTxCM,name=HsqlDS</depends>\n" - "\n" - " \n" - " <attribute name=\"JndiName\">java:/hibernate/SessionFactory</attribute>\n" - "\n" - " \n" - " <attribute name=\"Datasource\">java:HsqlDS</attribute>\n" - " <attribute name=\"Dialect\">org.hibernate.dialect.HSQLDialect</attribute>\n" - "\n" - " \n" - " <attribute name=\"TransactionStrategy\">\n" - " org.hibernate.transaction.JTATransactionFactory</attribute>\n" - " <attribute name=\"TransactionManagerLookupStrategy\">\n" - " org.hibernate.transaction.JBossTransactionManagerLookup</attribute>\n" - " <attribute name=\"FlushBeforeCompletionEnabled\">true</attribute>\n" - " <attribute name=\"AutoCloseSessionEnabled\">true</attribute>\n" - "\n" - " \n" - " <attribute name=\"MaximumFetchDepth\">5</attribute>\n" - "\n" - " \n" - " <attribute name=\"SecondLevelCacheEnabled\">true</attribute>\n" - " <attribute name=\"CacheProviderClass\">org.hibernate.cache.EhCacheProvider</attribute>\n" - " <attribute name=\"QueryCacheEnabled\">true</attribute>\n" - "\n" - " \n" - " <attribute name=\"ShowSqlEnabled\">true</attribute>\n" - "\n" - " \n" - " <attribute name=\"MapResources\">auction/Item.hbm.xml,auction/Category.hbm.xml</attribute>\n" - "\n" - "</mbean>\n" - "\n" - "</server>]]>" +"<![CDATA[<?xml version=\"1.0\"?>\n" +"<server>\n" +"\n" +"<mbean code=\"org.hibernate.jmx.HibernateService\"\n" +" name=\"jboss.jca:service=HibernateFactory,name=HibernateFactory\">\n" +"\n" +" \n" +" <depends>jboss.jca:service=RARDeployer</depends>\n" +" <depends>jboss.jca:service=LocalTxCM,name=HsqlDS</depends>\n" +"\n" +" \n" +" <attribute name=\"JndiName\">java:/hibernate/SessionFactory</attribute>\n" +"\n" +" \n" +" <attribute name=\"Datasource\">java:HsqlDS</attribute>\n" +" <attribute name=\"Dialect\">org.hibernate.dialect.HSQLDialect</" +"attribute>\n" +"\n" +" \n" +" <attribute name=\"TransactionStrategy\">\n" +" org.hibernate.transaction.JTATransactionFactory</attribute>\n" +" <attribute name=\"TransactionManagerLookupStrategy\">\n" +" org.hibernate.transaction.JBossTransactionManagerLookup</attribute>\n" +" <attribute name=\"FlushBeforeCompletionEnabled\">true</attribute>\n" +" <attribute name=\"AutoCloseSessionEnabled\">true</attribute>\n" +"\n" +" \n" +" <attribute name=\"MaximumFetchDepth\">5</attribute>\n" +"\n" +" \n" +" <attribute name=\"SecondLevelCacheEnabled\">true</attribute>\n" +" <attribute name=\"CacheProviderClass\">org.hibernate.cache." +"EhCacheProvider</attribute>\n" +" <attribute name=\"QueryCacheEnabled\">true</attribute>\n" +"\n" +" \n" +" <attribute name=\"ShowSqlEnabled\">true</attribute>\n" +"\n" +" \n" +" <attribute name=\"MapResources\">auction/Item.hbm.xml,auction/Category." +"hbm.xml</attribute>\n" +"\n" +"</mbean>\n" +"\n" +"</server>]]>" msgstr "" -#: index.docbook:1629 -msgid "This file is deployed in a directory called <literal>META-INF</literal> and packaged in a JAR file with the extension <literal>.sar</literal> (service archive). You also need to package Hibernate, its required third-party libraries, your compiled persistent classes, as well as your mapping files in the same archive. Your enterprise beans (usually session beans) may be kept in their own JAR file, but you may include this EJB JAR file in the main service archive to get a single (hot-)deployable unit. Consult the JBoss AS documentation for more information about JMX service and EJB deployment." +#. Tag: para +#: configuration.xml:1629 +#, no-c-format +msgid "" +"This file is deployed in a directory called <literal>META-INF</literal> and " +"packaged in a JAR file with the extension <literal>.sar</literal> (service " +"archive). You also need to package Hibernate, its required third-party " +"libraries, your compiled persistent classes, as well as your mapping files " +"in the same archive. Your enterprise beans (usually session beans) may be " +"kept in their own JAR file, but you may include this EJB JAR file in the " +"main service archive to get a single (hot-)deployable unit. Consult the " +"JBoss AS documentation for more information about JMX service and EJB " +"deployment." msgstr "" +"This file is deployed in a directory called <literal>META-INF</literal> and " +"packaged in a JAR file with the extension <literal>.sar</literal> (service " +"archive). You also need to package Hibernate, its required third-party " +"libraries, your compiled persistent classes, as well as your mapping files " +"in the same archive. Your enterprise beans (usually session beans) may be " +"kept in their own JAR file, but you may include this EJB JAR file in the " +"main service archive to get a single (hot-)deployable unit. Consult the " +"JBoss AS documentation for more information about JMX service and EJB " +"deployment." -msgid "ROLES_OF_TRANSLATORS" -msgstr "" +#~ msgid "<placeholder-1/> (optional)" +#~ msgstr "<placeholder-1/> (opcional)" -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "" +#~ msgid "InitialContextFactory" +#~ msgstr "InitialContextFactory" +#~ msgid "class of the JNDI <placeholder-1/>" +#~ msgstr "Classe do JNDI <placeholder-1/>" + +#, fuzzy +#~ msgid "eg." +#~ msgstr "" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "Ex.\n" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "Ex.\n" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "Ex.\n" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "Ex.\n" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "Ex.\n" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "Ex.\n" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "Ex.\n" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "Ex.\n" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "Ex.\n" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "Ex.\n" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "Ex.\n" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "Ex.\n" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "Ex.\n" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "Ex.\n" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "Ex.\n" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "Ex.\n" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "Ex.\n" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "Ex.\n" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "eg." + +#~ msgid "full.classname.of.Dialect" +#~ msgstr "full.classname.of.Dialect" + +#~ msgid "debug" +#~ msgstr "debug" + +#~ msgid "SCHEMA_NAME" +#~ msgstr "SCHEMA_NAME" + +#~ msgid "CATALOG_NAME" +#~ msgstr "CATALOG_NAME" + +#, fuzzy +#~ msgid "SessionFactory" +#~ msgstr "" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "SessionFactory\n" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "SessionFactory\n" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "SessionFactory\n" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "create-drop" + +#~ msgid "jndi/composite/name" +#~ msgstr "jndi/composite/name" + +#~ msgid "0" +#~ msgstr "0" + +#~ msgid "false" +#~ msgstr "false" + +#~ msgid "Statement.setFetchSize()" +#~ msgstr "Statement.setFetchSize()" + +#~ msgid "true" +#~ msgstr "true" + +#~ msgid "executeBatch()" +#~ msgstr "executeBatch()" + +#~ msgid "Batcher" +#~ msgstr "Batcher" + +#~ msgid "classname.of.BatcherFactory" +#~ msgstr "classname.of.BatcherFactory" + +#~ msgid "binary" +#~ msgstr "binary" + +#~ msgid "serializable" +#~ msgstr "serializable" + +#~ msgid "PreparedStatement.getGeneratedKeys()" +#~ msgstr "PreparedStatement.getGeneratedKeys()" + +#~ msgid "true|false" +#~ msgstr "true|false" + +#~ msgid "ConnectionProvider" +#~ msgstr "ConnectionProvider" + +#~ msgid "classname.of.ConnectionProvider" +#~ msgstr "classname.of.ConnectionProvider" + +#~ msgid "java.sql.Connection" +#~ msgstr "java.sql.Connection" + +#~ msgid "1, 2, 4, 8" +#~ msgstr "1, 2, 4, 8" + +#~ msgid "after_statement" +#~ msgstr "after_statement" + +#~ msgid "after_transaction" +#~ msgstr "after_transaction" + +#~ msgid "auto" +#~ msgstr "auto" + +#~ msgid "hibernate.connection." +#~ msgstr "<propertyName>" + +#, fuzzy +#~ msgid "<propertyName>" +#~ msgstr "" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "hibernate.connection.<placeholder-1/>\n" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "propertyName\n" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "hibernate.jndi.<placeholder-1/>\n" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "propertyName" + +#~ msgid "DriverManager.getConnection()" +#~ msgstr "DriverManager.getConnection()" + +#~ msgid "Pass the JDBC property <placeholder-1/> to <placeholder-2/>." +#~ msgstr "Passa a propriedade JDBC <placeholder-1/> para <placeholder-2/>." + +#~ msgid "hibernate.jndi." +#~ msgstr "<propertyName>" + +#~ msgid "Pass the property <placeholder-1/> to the JNDI <placeholder-2/>." +#~ msgstr "Passar a propriedade <placeholder-1/> para o <placeholder-2/> JNDI." + +#~ msgid "CacheProvider" +#~ msgstr "CacheProvider" + +#~ msgid "classname.of.CacheProvider" +#~ msgstr "classname.of.CacheProvider" + +#~ msgid "<cache>" +#~ msgstr "<cache>" + +#~ msgid "QueryCache" +#~ msgstr "QueryCache" + +#~ msgid "StandardQueryCache" +#~ msgstr "StandardQueryCache" + +#~ msgid "classname.of.QueryCache" +#~ msgstr "classname.of.QueryCache" + +#~ msgid "prefix" +#~ msgstr "prefix" + +#~ msgid "TransactionFactory" +#~ msgstr "TransactionFactory" + +#~ msgid "Transaction" +#~ msgstr "Transaction" + +#~ msgid "JDBCTransactionFactory" +#~ msgstr "JDBCTransactionFactory" + +#~ msgid "classname.of.TransactionFactory" +#~ msgstr "classname.of.TransactionFactory" + +#~ msgid "JTATransactionFactory" +#~ msgstr "JTATransactionFactory" + +#~ msgid "UserTransaction" +#~ msgstr "UserTransaction" + +#~ msgid "TransactionManagerLookup" +#~ msgstr "TransactionManagerLookup" + +#~ msgid "classname.of.TransactionManagerLookup" +#~ msgstr "classname.of.TransactionManagerLookup" + +#~ msgid "Session" +#~ msgstr "Session" + +#~ msgid "hqlLiteral=SQL_LITERAL, hqlFunction=SQLFUNC" +#~ msgstr "hqlLiteral=SQL_LITERAL, hqlFunction=SQLFUNC" + +#~ msgid "create-drop" +#~ msgstr "create-drop" + +#~ msgid "hibernate.cfg.xml" +#~ msgstr "hibernate.cfg.xml" + +#~ msgid "DB2" +#~ msgstr "DB2" Modified: core/trunk/documentation/manual/translations/pt-BR/content/events.po =================================================================== --- core/trunk/documentation/manual/translations/pt-BR/content/events.po 2007-10-25 22:34:46 UTC (rev 14134) +++ core/trunk/documentation/manual/translations/pt-BR/content/events.po 2007-10-26 00:46:38 UTC (rev 14135) @@ -1,245 +1,481 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: events.xml:5 +#, no-c-format msgid "Interceptors and events" -msgstr "" +msgstr "Interceptadores e Eventos" -#: index.docbook:7 -msgid "It is often useful for the application to react to certain events that occur inside Hibernate. This allows implementation of certain kinds of generic functionality, and extension of Hibernate functionality." +#. Tag: para +#: events.xml:7 +#, no-c-format +msgid "" +"It is often useful for the application to react to certain events that occur " +"inside Hibernate. This allows implementation of certain kinds of generic " +"functionality, and extension of Hibernate functionality." msgstr "" +"É muito útil quando a aplicação precisa executar alguma \"coisa\" no momento " +"em que o Hibernate executa uma de suas ações. Isso permite a implementação " +"de certas funções genéricas, assim como permite estender as funcionalidades " +"do Hibernate" -#: index.docbook:14 +#. Tag: title +#: events.xml:14 +#, no-c-format msgid "Interceptors" -msgstr "" +msgstr "Interceptadores" -#: index.docbook:16 -msgid "The <literal>Interceptor</literal> interface provides callbacks from the session to the application allowing the application to inspect and/or manipulate properties of a persistent object before it is saved, updated, deleted or loaded. One possible use for this is to track auditing information. For example, the following <literal>Interceptor</literal> automatically sets the <literal>createTimestamp</literal> when an <literal>Auditable</literal> is created and updates the <literal>lastUpdateTimestamp</literal> property when an <literal>Auditable</literal> is updated." +#. Tag: para +#: events.xml:16 +#, no-c-format +msgid "" +"The <literal>Interceptor</literal> interface provides callbacks from the " +"session to the application allowing the application to inspect and/or " +"manipulate properties of a persistent object before it is saved, updated, " +"deleted or loaded. One possible use for this is to track auditing " +"information. For example, the following <literal>Interceptor</literal> " +"automatically sets the <literal>createTimestamp</literal> when an " +"<literal>Auditable</literal> is created and updates the " +"<literal>lastUpdateTimestamp</literal> property when an <literal>Auditable</" +"literal> is updated." msgstr "" +"A interface <literal>Interceptor</literal> permite fornecer informações da " +"session para o aplicativo, permitindo ao aplicativo inspecionar e/ou " +"manipular as propriedades de um objeto persistente antes de ser salvo, " +"atualizado, excluído ou salvo. Um dos possíveis usos é gerar informações de " +"auditoria. Por exemplo, o seguinte <literal>Interceptor</literal> seta " +"automaticamente o atributo <literal>createTimestamp</literal> quando um " +"<literal>Auditable</literal> é criada e atualiza o atributo " +"<literal>lastUpdateTimestamp</literal> quando um <literal>Auditable</" +"literal> é atualizado." -#: index.docbook:27 -msgid "You may either implement <literal>Interceptor</literal> directly or (better) extend <literal>EmptyInterceptor</literal>." +#. Tag: para +#: events.xml:27 +#, no-c-format +msgid "" +"You may either implement <literal>Interceptor</literal> directly or (better) " +"extend <literal>EmptyInterceptor</literal>." msgstr "" +"Você pode implementar <literal>Auditable</literal> diretamente ou pode " +"estender <literal>EmptyInterceptor</literal>, sendo que a segunda é " +"considerada a melhor opção." -#: index.docbook:32 +#. Tag: programlisting +#: events.xml:32 +#, no-c-format msgid "" - "<![CDATA[package org.hibernate.test;\n" - "\n" - "import java.io.Serializable;\n" - "import java.util.Date;\n" - "import java.util.Iterator;\n" - "\n" - "import org.hibernate.EmptyInterceptor;\n" - "import org.hibernate.Transaction;\n" - "import org.hibernate.type.Type;\n" - "\n" - "public class AuditInterceptor extends EmptyInterceptor {\n" - "\n" - " private int updates;\n" - " private int creates;\n" - " private int loads;\n" - "\n" - " public void onDelete(Object entity,\n" - " Serializable id,\n" - " Object[] state,\n" - " String[] propertyNames,\n" - " Type[] types) {\n" - " // do nothing\n" - " }\n" - "\n" - " public boolean onFlushDirty(Object entity,\n" - " Serializable id,\n" - " Object[] currentState,\n" - " Object[] previousState,\n" - " String[] propertyNames,\n" - " Type[] types) {\n" - "\n" - " if ( entity instanceof Auditable ) {\n" - " updates++;\n" - " for ( int i=0; i < propertyNames.length; i++ ) {\n" - " if ( \"lastUpdateTimestamp\".equals( propertyNames[i] ) ) {\n" - " currentState[i] = new Date();\n" - " return true;\n" - " }\n" - " }\n" - " }\n" - " return false;\n" - " }\n" - "\n" - " public boolean onLoad(Object entity,\n" - " Serializable id,\n" - " Object[] state,\n" - " String[] propertyNames,\n" - " Type[] types) {\n" - " if ( entity instanceof Auditable ) {\n" - " loads++;\n" - " }\n" - " return false;\n" - " }\n" - "\n" - " public boolean onSave(Object entity,\n" - " Serializable id,\n" - " Object[] state,\n" - " String[] propertyNames,\n" - " Type[] types) {\n" - "\n" - " if ( entity instanceof Auditable ) {\n" - " creates++;\n" - " for ( int i=0; i<propertyNames.length; i++ ) {\n" - " if ( \"createTimestamp\".equals( propertyNames[i] ) ) {\n" - " state[i] = new Date();\n" - " return true;\n" - " }\n" - " }\n" - " }\n" - " return false;\n" - " }\n" - "\n" - " public void afterTransactionCompletion(Transaction tx) {\n" - " if ( tx.wasCommitted() ) {\n" - " System.out.println(\"Creations: \" + creates + \", Updates: \" + updates, \"Loads: \" + loads);\n" - " }\n" - " updates=0;\n" - " creates=0;\n" - " loads=0;\n" - " }\n" - "\n" - "}]]>" +"<![CDATA[package org.hibernate.test;\n" +"\n" +"import java.io.Serializable;\n" +"import java.util.Date;\n" +"import java.util.Iterator;\n" +"\n" +"import org.hibernate.EmptyInterceptor;\n" +"import org.hibernate.Transaction;\n" +"import org.hibernate.type.Type;\n" +"\n" +"public class AuditInterceptor extends EmptyInterceptor {\n" +"\n" +" private int updates;\n" +" private int creates;\n" +" private int loads;\n" +"\n" +" public void onDelete(Object entity,\n" +" Serializable id,\n" +" Object[] state,\n" +" String[] propertyNames,\n" +" Type[] types) {\n" +" // do nothing\n" +" }\n" +"\n" +" public boolean onFlushDirty(Object entity,\n" +" Serializable id,\n" +" Object[] currentState,\n" +" Object[] previousState,\n" +" String[] propertyNames,\n" +" Type[] types) {\n" +"\n" +" if ( entity instanceof Auditable ) {\n" +" updates++;\n" +" for ( int i=0; i < propertyNames.length; i++ ) {\n" +" if ( \"lastUpdateTimestamp\".equals( propertyNames[i] ) ) {\n" +" currentState[i] = new Date();\n" +" return true;\n" +" }\n" +" }\n" +" }\n" +" return false;\n" +" }\n" +"\n" +" public boolean onLoad(Object entity,\n" +" Serializable id,\n" +" Object[] state,\n" +" String[] propertyNames,\n" +" Type[] types) {\n" +" if ( entity instanceof Auditable ) {\n" +" loads++;\n" +" }\n" +" return false;\n" +" }\n" +"\n" +" public boolean onSave(Object entity,\n" +" Serializable id,\n" +" Object[] state,\n" +" String[] propertyNames,\n" +" Type[] types) {\n" +"\n" +" if ( entity instanceof Auditable ) {\n" +" creates++;\n" +" for ( int i=0; i<propertyNames.length; i++ ) {\n" +" if ( \"createTimestamp\".equals( propertyNames[i] ) ) {\n" +" state[i] = new Date();\n" +" return true;\n" +" }\n" +" }\n" +" }\n" +" return false;\n" +" }\n" +"\n" +" public void afterTransactionCompletion(Transaction tx) {\n" +" if ( tx.wasCommitted() ) {\n" +" System.out.println(\"Creations: \" + creates + \", Updates: \" + " +"updates, \"Loads: \" + loads);\n" +" }\n" +" updates=0;\n" +" creates=0;\n" +" loads=0;\n" +" }\n" +"\n" +"}]]>" msgstr "" -#: index.docbook:34 -msgid "Interceptors come in two flavors: <literal>Session</literal>-scoped and <literal>SessionFactory</literal>-scoped." +#. Tag: para +#: events.xml:34 +#, no-c-format +msgid "" +"Interceptors come in two flavors: <literal>Session</literal>-scoped and " +"<literal>SessionFactory</literal>-scoped." msgstr "" +"Os interceptadores podem ser aplicados em dois diferentes escopos: No escopo " +"da <literal>Session</literal> e no escopo <literal>SessionFactory</literal>." -#: index.docbook:39 -msgid "A <literal>Session</literal>-scoped interceptor is specified when a session is opened using one of the overloaded SessionFactory.openSession() methods accepting an <literal>Interceptor</literal>." +#. Tag: para +#: events.xml:39 +#, no-c-format +msgid "" +"A <literal>Session</literal>-scoped interceptor is specified when a session " +"is opened using one of the overloaded SessionFactory.openSession() methods " +"accepting an <literal>Interceptor</literal>." msgstr "" +"Um interceptador no escopo da <literal>Session</literal> é definido quando " +"uma sessão é aberta usando o método sobrecarregado da SessionFactory." +"openSession() que aceita um <literal>Interceptor</literal> como parâmetro." -#: index.docbook:45 +#. Tag: programlisting +#: events.xml:45 +#, no-c-format msgid "<![CDATA[Session session = sf.openSession( new AuditInterceptor() );]]>" msgstr "" -#: index.docbook:47 -msgid "A <literal>SessionFactory</literal>-scoped interceptor is registered with the <literal>Configuration</literal> object prior to building the <literal>SessionFactory</literal>. In this case, the supplied interceptor will be applied to all sessions opened from that <literal>SessionFactory</literal>; this is true unless a session is opened explicitly specifying the interceptor to use. <literal>SessionFactory</literal>-scoped interceptors must be thread safe, taking care to not store session-specific state since multiple sessions will use this interceptor (potentially) concurrently." +#. Tag: para +#: events.xml:47 +#, no-c-format +msgid "" +"A <literal>SessionFactory</literal>-scoped interceptor is registered with " +"the <literal>Configuration</literal> object prior to building the " +"<literal>SessionFactory</literal>. In this case, the supplied interceptor " +"will be applied to all sessions opened from that <literal>SessionFactory</" +"literal>; this is true unless a session is opened explicitly specifying the " +"interceptor to use. <literal>SessionFactory</literal>-scoped interceptors " +"must be thread safe, taking care to not store session-specific state since " +"multiple sessions will use this interceptor (potentially) concurrently." msgstr "" +"Um interceptador no escopo da <literal>SessionFactory</literal> é definido " +"no objeto <literal>Configuration</literal> antes da <literal>SessionFactory</" +"literal> ser instanciada. Nesse caso, o interceptador fornecido será " +"aplicado para todas as sessões abertas por aquela <literal>SessionFactory</" +"literal>; Isso apenas não ocorrerá caso seja especificado um interceptador " +"no momento em que a sessão for aberta. Um interceptador no escopo de " +"<literal>SessionFactory</literal> deve ser thread safe, tomando-se o cuidado " +"de não armazenar atributos de estado específicos da sessão, pois, " +"provavelmente, múltiplas sessões irão utilizar esse interceptador " +"simultaneamente." -#: index.docbook:56 -msgid "<![CDATA[new Configuration().setInterceptor( new AuditInterceptor() );]]>" +#. Tag: programlisting +#: events.xml:56 +#, no-c-format +msgid "" +"<![CDATA[new Configuration().setInterceptor( new AuditInterceptor() );]]>" msgstr "" -#: index.docbook:61 +#. Tag: title +#: events.xml:61 +#, no-c-format msgid "Event system" -msgstr "" +msgstr "Sistema de Eventos" -#: index.docbook:63 -msgid "If you have to react to particular events in your persistence layer, you may also use the Hibernate3 <emphasis>event</emphasis> architecture. The event system can be used in addition or as a replacement for interceptors." +#. Tag: para +#: events.xml:63 +#, no-c-format +msgid "" +"If you have to react to particular events in your persistence layer, you may " +"also use the Hibernate3 <emphasis>event</emphasis> architecture. The event " +"system can be used in addition or as a replacement for interceptors." msgstr "" +"Se você precisa executar uma ação em determinados eventos da camada de " +"persistência, você também pode usar a arquitetura de <emphasis>event</" +"emphasis> do Hibernate3. Um evento do sistema pode ser utilizado como " +"complemento ou em substituição a um interceptador." -#: index.docbook:69 -msgid "Essentially all of the methods of the <literal>Session</literal> interface correlate to an event. You have a <literal>LoadEvent</literal>, a <literal>FlushEvent</literal>, etc (consult the XML configuration-file DTD or the <literal>org.hibernate.event</literal> package for the full list of defined event types). When a request is made of one of these methods, the Hibernate <literal>Session</literal> generates an appropriate event and passes it to the configured event listeners for that type. Out-of-the-box, these listeners implement the same processing in which those methods always resulted. However, you are free to implement a customization of one of the listener interfaces (i.e., the <literal>LoadEvent</literal> is processed by the registered implemenation of the <literal>LoadEventListener</literal> interface), in which case their implementation would be responsible for processing any <literal>load()</literal> requests made of the <literal>Session</literal>." +#. Tag: para +#: events.xml:69 +#, no-c-format +msgid "" +"Essentially all of the methods of the <literal>Session</literal> interface " +"correlate to an event. You have a <literal>LoadEvent</literal>, a " +"<literal>FlushEvent</literal>, etc (consult the XML configuration-file DTD " +"or the <literal>org.hibernate.event</literal> package for the full list of " +"defined event types). When a request is made of one of these methods, the " +"Hibernate <literal>Session</literal> generates an appropriate event and " +"passes it to the configured event listeners for that type. Out-of-the-box, " +"these listeners implement the same processing in which those methods always " +"resulted. However, you are free to implement a customization of one of the " +"listener interfaces (i.e., the <literal>LoadEvent</literal> is processed by " +"the registered implemenation of the <literal>LoadEventListener</literal> " +"interface), in which case their implementation would be responsible for " +"processing any <literal>load()</literal> requests made of the " +"<literal>Session</literal>." msgstr "" +"Essencialmente todos os métodos da interface <literal>Session</literal> " +"possuem um evento correlacionado. Se você tiver um <literal>LoadEvent</" +"literal>, um <literal>LoadEvent</literal>, etc (consulte o DTD do XML de " +"configuração ou o pacote <literal>org.hibernate.event</literal> para a lista " +"completa dos tipos de eventos). Quando uma requisição é feita em um desses " +"métodos, a <literal>Session</literal> do hibernate gera um evento apropriado " +"e o envia para o listener de evento correspondente àquele tipo de evento. " +"Esses listeners implementam a mesma lógica que aqueles métodos, trazendo os " +"mesmos resultados. Entretanto, você é livre para implementar uma " +"customização de um desses listeners (isto é, o <literal>LoadEvent</literal> " +"é processado pela implementação registrada da interface " +"<literal>LoadEventListener</literal>), então sua implementação vai ficar " +"responsável por processar qualquer requisição <literal>load()</literal> " +"feita pela <literal>Session</literal>." -#: index.docbook:84 -msgid "The listeners should be considered effectively singletons; meaning, they are shared between requests, and thus should not save any state as instance variables." +#. Tag: para +#: events.xml:84 +#, no-c-format +msgid "" +"The listeners should be considered effectively singletons; meaning, they are " +"shared between requests, and thus should not save any state as instance " +"variables." msgstr "" +"Para todos os efeitos esses listeners deve ser considerados singletons; ou " +"seja, eles são compartilhados entre as requisições, e assim sendo, não devem " +"salvar nenhum estado das variáveis instanciadas." -#: index.docbook:89 -msgid "A custom listener should implement the appropriate interface for the event it wants to process and/or extend one of the convenience base classes (or even the default event listeners used by Hibernate out-of-the-box as these are declared non-final for this purpose). Custom listeners can either be registered programmatically through the <literal>Configuration</literal> object, or specified in the Hibernate configuration XML (declarative configuration through the properties file is not supported). Here's an example of a custom load event listener:" +#. Tag: para +#: events.xml:89 +#, no-c-format +msgid "" +"A custom listener should implement the appropriate interface for the event " +"it wants to process and/or extend one of the convenience base classes (or " +"even the default event listeners used by Hibernate out-of-the-box as these " +"are declared non-final for this purpose). Custom listeners can either be " +"registered programmatically through the <literal>Configuration</literal> " +"object, or specified in the Hibernate configuration XML (declarative " +"configuration through the properties file is not supported). Here's an " +"example of a custom load event listener:" msgstr "" +"Um listener personalizado deve implementar a interface referente ao evento a " +"ser processado e/ou deve estender a classes base equivalente (ou mesmo os " +"listeners padrões usados pelo Hibernate, eles não são declarados como finais " +"com esse objetivo). O listener personalizado pode ser registrado " +"programaticamente no objeto <literal>Configuration</literal>, ou " +"declarativamente no XML de configuração do Hibernate (o registro do listener " +"no propertie de configuração não é suportado). Aqui temos um exemplo de como " +"carregar um listener personalizado:" -#: index.docbook:99 +#. Tag: programlisting +#: events.xml:99 +#, no-c-format msgid "" - "<![CDATA[public class MyLoadListener implements LoadEventListener {\n" - " // this is the single method defined by the LoadEventListener interface\n" - " public void onLoad(LoadEvent event, LoadEventListener.LoadType loadType)\n" - " throws HibernateException {\n" - " if ( !MySecurity.isAuthorized( event.getEntityClassName(), event.getEntityId() ) ) {\n" - " throw MySecurityException(\"Unauthorized access\");\n" - " }\n" - " }\n" - "}]]>" +"<![CDATA[public class MyLoadListener implements LoadEventListener {\n" +" // this is the single method defined by the LoadEventListener interface\n" +" public void onLoad(LoadEvent event, LoadEventListener.LoadType " +"loadType)\n" +" throws HibernateException {\n" +" if ( !MySecurity.isAuthorized( event.getEntityClassName(), event." +"getEntityId() ) ) {\n" +" throw MySecurityException(\"Unauthorized access\");\n" +" }\n" +" }\n" +"}]]>" msgstr "" -#: index.docbook:101 -msgid "You also need a configuration entry telling Hibernate to use the listener in addition to the default listener:" +#. Tag: para +#: events.xml:101 +#, no-c-format +msgid "" +"You also need a configuration entry telling Hibernate to use the listener in " +"addition to the default listener:" msgstr "" +"Você também precisa adicionar uma entrada no XML de configuração do " +"Hibernate para registrar declarativamente qual listener deve se utilizado em " +"conjunto com o listener padrão:" -#: index.docbook:106 +#. Tag: programlisting +#: events.xml:106 +#, no-c-format msgid "" - "<![CDATA[<hibernate-configuration>\n" - " <session-factory>\n" - " ...\n" - " <event type=\"load\">\n" - " <listener class=\"com.eg.MyLoadListener\"/>\n" - " <listener class=\"org.hibernate.event.def.DefaultLoadEventListener\"/>\n" - " </event>\n" - " </session-factory>\n" - "</hibernate-configuration>]]>" +"<![CDATA[<hibernate-configuration>\n" +" <session-factory>\n" +" ...\n" +" <event type=\"load\">\n" +" <listener class=\"com.eg.MyLoadListener\"/>\n" +" <listener class=\"org.hibernate.event.def." +"DefaultLoadEventListener\"/>\n" +" </event>\n" +" </session-factory>\n" +"</hibernate-configuration>]]>" msgstr "" -#: index.docbook:108 +#. Tag: para +#: events.xml:108 +#, no-c-format msgid "Instead, you may register it programmatically:" -msgstr "" +msgstr "Ou, você pode registrar o listener programaticamente:" -#: index.docbook:112 +#. Tag: programlisting +#: events.xml:112 +#, no-c-format msgid "" - "<![CDATA[Configuration cfg = new Configuration();\n" - "LoadEventListener[] stack = { new MyLoadListener(), new DefaultLoadEventListener() };\n" - "cfg.EventListeners().setLoadEventListeners(stack);]]>" +"<![CDATA[Configuration cfg = new Configuration();\n" +"LoadEventListener[] stack = { new MyLoadListener(), new " +"DefaultLoadEventListener() };\n" +"cfg.EventListeners().setLoadEventListeners(stack);]]>" msgstr "" -#: index.docbook:114 -msgid "Listeners registered declaratively cannot share instances. If the same class name is used in multiple <literal><listener/></literal> elements, each reference will result in a separate instance of that class. If you need the capability to share listener instances between listener types you must use the programmatic registration approach." +#. Tag: para +#: events.xml:114 +#, no-c-format +msgid "" +"Listeners registered declaratively cannot share instances. If the same class " +"name is used in multiple <literal><listener/></literal> elements, each " +"reference will result in a separate instance of that class. If you need the " +"capability to share listener instances between listener types you must use " +"the programmatic registration approach." msgstr "" +"Listeners registrados declarativamente não compartilham da mesma instancia. " +"Se o mesmo nome da classe é utilizado em vários elementos e <literal><" +"listener/></literal>, cada um vai resultar em uma instancia separada " +"dessa classe. Se você tem a necessidade de compartilhar uma instancia de um " +"listener entre diversos tipos de listeners você deve registrar o listener " +"programaticamente." -#: index.docbook:122 -msgid "Why implement an interface and define the specific type during configuration? Well, a listener implementation could implement multiple event listener interfaces. Having the type additionally defined during registration makes it easier to turn custom listeners on or off during configuration." +#. Tag: para +#: events.xml:122 +#, no-c-format +msgid "" +"Why implement an interface and define the specific type during " +"configuration? Well, a listener implementation could implement multiple " +"event listener interfaces. Having the type additionally defined during " +"registration makes it easier to turn custom listeners on or off during " +"configuration." msgstr "" +"Mas porque implementar uma interface e definir o tipo específico durante a " +"configuração? Bem, um listener pode implementar vários listeners de evento. " +"Com o tipo sendo definido durante o registro, fica fácil ligar ou desligar " +"listeners personalizados durante a configuração." -#: index.docbook:132 +#. Tag: title +#: events.xml:132 +#, no-c-format msgid "Hibernate declarative security" -msgstr "" +msgstr "Hibernate declarative security" -#: index.docbook:133 -msgid "Usually, declarative security in Hibernate applications is managed in a session facade layer. Now, Hibernate3 allows certain actions to be permissioned via JACC, and authorized via JAAS. This is optional functionality built on top of the event architecture." +#. Tag: para +#: events.xml:133 +#, no-c-format +msgid "" +"Usually, declarative security in Hibernate applications is managed in a " +"session facade layer. Now, Hibernate3 allows certain actions to be " +"permissioned via JACC, and authorized via JAAS. This is optional " +"functionality built on top of the event architecture." msgstr "" +"Usually, declarative security in Hibernate applications is managed in a " +"session facade layer. Now, Hibernate3 allows certain actions to be " +"permissioned via JACC, and authorized via JAAS. This is optional " +"functionality built on top of the event architecture." -#: index.docbook:139 -msgid "First, you must configure the appropriate event listeners, to enable the use of JAAS authorization." +#. Tag: para +#: events.xml:139 +#, no-c-format +msgid "" +"First, you must configure the appropriate event listeners, to enable the use " +"of JAAS authorization." msgstr "" +"First, you must configure the appropriate event listeners, to enable the use " +"of JAAS authorization." -#: index.docbook:144 +#. Tag: programlisting +#: events.xml:144 +#, no-c-format msgid "" - "<![CDATA[<listener type=\"pre-delete\" class=\"org.hibernate.secure.JACCPreDeleteEventListener\"/>\n" - "<listener type=\"pre-update\" class=\"org.hibernate.secure.JACCPreUpdateEventListener\"/>\n" - "<listener type=\"pre-insert\" class=\"org.hibernate.secure.JACCPreInsertEventListener\"/>\n" - "<listener type=\"pre-load\" class=\"org.hibernate.secure.JACCPreLoadEventListener\"/>]]>" +"<![CDATA[<listener type=\"pre-delete\" class=\"org.hibernate.secure." +"JACCPreDeleteEventListener\"/>\n" +"<listener type=\"pre-update\" class=\"org.hibernate.secure." +"JACCPreUpdateEventListener\"/>\n" +"<listener type=\"pre-insert\" class=\"org.hibernate.secure." +"JACCPreInsertEventListener\"/>\n" +"<listener type=\"pre-load\" class=\"org.hibernate.secure." +"JACCPreLoadEventListener\"/>]]>" msgstr "" -#: index.docbook:146 -msgid "Note that <literal><listener type=\"...\" class=\"...\"/></literal> is just a shorthand for <literal><event type=\"...\"><listener class=\"...\"/></event></literal> when there is exactly one listener for a particular event type." +#. Tag: para +#: events.xml:146 +#, no-c-format +msgid "" +"Note that <literal><listener type=\"...\" class=\"...\"/></literal> is " +"just a shorthand for <literal><event type=\"...\"><listener class=" +"\"...\"/></event></literal> when there is exactly one listener for " +"a particular event type." msgstr "" +"Note that <literal><listener type=\"...\" class=\"...\"/></literal> is " +"just a shorthand for <literal><event type=\"...\"><listener class=" +"\"...\"/></event></literal> when there is exactly one listener for " +"a particular event type." -#: index.docbook:152 -msgid "Next, still in <literal>hibernate.cfg.xml</literal>, bind the permissions to roles:" +#. Tag: para +#: events.xml:152 +#, no-c-format +msgid "" +"Next, still in <literal>hibernate.cfg.xml</literal>, bind the permissions to " +"roles:" msgstr "" +"Next, still in <literal>hibernate.cfg.xml</literal>, bind the permissions to " +"roles:" -#: index.docbook:156 +#. Tag: programlisting +#: events.xml:156 +#, no-c-format msgid "" - "<![CDATA[<grant role=\"admin\" entity-name=\"User\" actions=\"insert,update,read\"/>\n" - "<grant role=\"su\" entity-name=\"User\" actions=\"*\"/>]]>" +"<![CDATA[<grant role=\"admin\" entity-name=\"User\" actions=\"insert,update," +"read\"/>\n" +"<grant role=\"su\" entity-name=\"User\" actions=\"*\"/>]]>" msgstr "" -#: index.docbook:158 +#. Tag: para +#: events.xml:158 +#, no-c-format msgid "The role names are the roles understood by your JACC provider." -msgstr "" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "" - +msgstr "The role names are the roles understood by your JACC provider." Modified: core/trunk/documentation/manual/translations/pt-BR/content/example_mappings.po =================================================================== --- core/trunk/documentation/manual/translations/pt-BR/content/example_mappings.po 2007-10-25 22:34:46 UTC (rev 14134) +++ core/trunk/documentation/manual/translations/pt-BR/content/example_mappings.po 2007-10-26 00:46:38 UTC (rev 14135) @@ -1,653 +1,802 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:20 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: example_mappings.xml:20 +#, no-c-format msgid "Example: Various Mappings" -msgstr "" +msgstr "Exemplo: Vários Mapeamentos" -#: index.docbook:22 +#. Tag: para +#: example_mappings.xml:22 +#, no-c-format msgid "This chapters shows off some more complex association mappings." -msgstr "" +msgstr "Este capitulo mostra algums mapeamentos de associações mais complexos." -#: index.docbook:27 +#. Tag: title +#: example_mappings.xml:27 +#, no-c-format msgid "Employer/Employee" -msgstr "" +msgstr "Employer/Employee" -#: index.docbook:29 -msgid "The following model of the relationship between <literal>Employer</literal> and <literal>Employee</literal> uses an actual entity class (<literal>Employment</literal>) to represent the association. This is done because there might be more than one period of employment for the same two parties. Components are used to model monetary values and employee names." +#. Tag: para +#: example_mappings.xml:29 +#, no-c-format +msgid "" +"The following model of the relationship between <literal>Employer</literal> " +"and <literal>Employee</literal> uses an actual entity class " +"(<literal>Employment</literal>) to represent the association. This is done " +"because there might be more than one period of employment for the same two " +"parties. Components are used to model monetary values and employee names." msgstr "" +"O modelo de seguinte relacionamento entre <literal>Employer</literal> e " +"<literal>Employee</literal> utiliza uma entidade de classe atual " +"(<literal>Employment</literal>) para representar a associação. Isto é feito " +"porque pode-ser ter mais do que um período de trabalho para as duas partes " +"envolvidas. Outros Componentes são usados para modelar valores monetários e " +"os nomes do empregado." -#: index.docbook:46 +#. Tag: para +#: example_mappings.xml:46 +#, no-c-format msgid "Heres a possible mapping document:" -msgstr "" +msgstr "Abaixo o código de um possível mapeamento:" -#: index.docbook:50 +#. Tag: programlisting +#: example_mappings.xml:50 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - " \n" - " <class name=\"Employer\" table=\"employers\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\">\n" - " <param name=\"sequence\">employer_id_seq</param>\n" - " </generator>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " </class>\n" - "\n" - " <class name=\"Employment\" table=\"employment_periods\">\n" - "\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\">\n" - " <param name=\"sequence\">employment_id_seq</param>\n" - " </generator>\n" - " </id>\n" - " <property name=\"startDate\" column=\"start_date\"/>\n" - " <property name=\"endDate\" column=\"end_date\"/>\n" - "\n" - " <component name=\"hourlyRate\" class=\"MonetaryAmount\">\n" - " <property name=\"amount\">\n" - " <column name=\"hourly_rate\" sql-type=\"NUMERIC(12, 2)\"/>\n" - " </property>\n" - " <property name=\"currency\" length=\"12\"/>\n" - " </component>\n" - "\n" - " <many-to-one name=\"employer\" column=\"employer_id\" not-null=\"true\"/>\n" - " <many-to-one name=\"employee\" column=\"employee_id\" not-null=\"true\"/>\n" - "\n" - " </class>\n" - "\n" - " <class name=\"Employee\" table=\"employees\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\">\n" - " <param name=\"sequence\">employee_id_seq</param>\n" - " </generator>\n" - " </id>\n" - " <property name=\"taxfileNumber\"/>\n" - " <component name=\"name\" class=\"Name\">\n" - " <property name=\"firstName\"/>\n" - " <property name=\"initial\"/>\n" - " <property name=\"lastName\"/>\n" - " </component>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +" \n" +" <class name=\"Employer\" table=\"employers\">\n" +" <id name=\"id\">\n" +" <generator class=\"sequence\">\n" +" <param name=\"sequence\">employer_id_seq</param>\n" +" </generator>\n" +" </id>\n" +" <property name=\"name\"/>\n" +" </class>\n" +"\n" +" <class name=\"Employment\" table=\"employment_periods\">\n" +"\n" +" <id name=\"id\">\n" +" <generator class=\"sequence\">\n" +" <param name=\"sequence\">employment_id_seq</param>\n" +" </generator>\n" +" </id>\n" +" <property name=\"startDate\" column=\"start_date\"/>\n" +" <property name=\"endDate\" column=\"end_date\"/>\n" +"\n" +" <component name=\"hourlyRate\" class=\"MonetaryAmount\">\n" +" <property name=\"amount\">\n" +" <column name=\"hourly_rate\" sql-type=\"NUMERIC(12, 2)\"/>\n" +" </property>\n" +" <property name=\"currency\" length=\"12\"/>\n" +" </component>\n" +"\n" +" <many-to-one name=\"employer\" column=\"employer_id\" not-null=\"true" +"\"/>\n" +" <many-to-one name=\"employee\" column=\"employee_id\" not-null=\"true" +"\"/>\n" +"\n" +" </class>\n" +"\n" +" <class name=\"Employee\" table=\"employees\">\n" +" <id name=\"id\">\n" +" <generator class=\"sequence\">\n" +" <param name=\"sequence\">employee_id_seq</param>\n" +" </generator>\n" +" </id>\n" +" <property name=\"taxfileNumber\"/>\n" +" <component name=\"name\" class=\"Name\">\n" +" <property name=\"firstName\"/>\n" +" <property name=\"initial\"/>\n" +" <property name=\"lastName\"/>\n" +" </component>\n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" -#: index.docbook:52 -msgid "And heres the table schema generated by <literal>SchemaExport</literal>." +#. Tag: para +#: example_mappings.xml:52 +#, no-c-format +msgid "" +"And heres the table schema generated by <literal>SchemaExport</literal>." msgstr "" +"E abaixo o esquema da tabela gerado pelo <literal>SchemaExport</literal>." -#: index.docbook:56 +#. Tag: programlisting +#: example_mappings.xml:56 +#, no-c-format msgid "" - "<![CDATA[create table employers (\n" - " id BIGINT not null, \n" - " name VARCHAR(255), \n" - " primary key (id)\n" - ")\n" - "\n" - "create table employment_periods (\n" - " id BIGINT not null,\n" - " hourly_rate NUMERIC(12, 2),\n" - " currency VARCHAR(12), \n" - " employee_id BIGINT not null, \n" - " employer_id BIGINT not null, \n" - " end_date TIMESTAMP, \n" - " start_date TIMESTAMP, \n" - " primary key (id)\n" - ")\n" - "\n" - "create table employees (\n" - " id BIGINT not null, \n" - " firstName VARCHAR(255), \n" - " initial CHAR(1), \n" - " lastName VARCHAR(255), \n" - " taxfileNumber VARCHAR(255), \n" - " primary key (id)\n" - ")\n" - "\n" - "alter table employment_periods \n" - " add constraint employment_periodsFK0 foreign key (employer_id) references employers\n" - "alter table employment_periods \n" - " add constraint employment_periodsFK1 foreign key (employee_id) references employees\n" - "create sequence employee_id_seq\n" - "create sequence employment_id_seq\n" - "create sequence employer_id_seq]]>" +"<![CDATA[create table employers (\n" +" id BIGINT not null, \n" +" name VARCHAR(255), \n" +" primary key (id)\n" +")\n" +"\n" +"create table employment_periods (\n" +" id BIGINT not null,\n" +" hourly_rate NUMERIC(12, 2),\n" +" currency VARCHAR(12), \n" +" employee_id BIGINT not null, \n" +" employer_id BIGINT not null, \n" +" end_date TIMESTAMP, \n" +" start_date TIMESTAMP, \n" +" primary key (id)\n" +")\n" +"\n" +"create table employees (\n" +" id BIGINT not null, \n" +" firstName VARCHAR(255), \n" +" initial CHAR(1), \n" +" lastName VARCHAR(255), \n" +" taxfileNumber VARCHAR(255), \n" +" primary key (id)\n" +")\n" +"\n" +"alter table employment_periods \n" +" add constraint employment_periodsFK0 foreign key (employer_id) " +"references employers\n" +"alter table employment_periods \n" +" add constraint employment_periodsFK1 foreign key (employee_id) " +"references employees\n" +"create sequence employee_id_seq\n" +"create sequence employment_id_seq\n" +"create sequence employer_id_seq]]>" msgstr "" -#: index.docbook:61 +#. Tag: title +#: example_mappings.xml:61 +#, no-c-format msgid "Author/Work" -msgstr "" +msgstr "Author/Work" -#: index.docbook:63 -msgid "Consider the following model of the relationships between <literal>Work</literal>, <literal>Author</literal> and <literal>Person</literal>. We represent the relationship between <literal>Work</literal> and <literal>Author</literal> as a many-to-many association. We choose to represent the relationship between <literal>Author</literal> and <literal>Person</literal> as one-to-one association. Another possibility would be to have <literal>Author</literal> extend <literal>Person</literal>." +#. Tag: para +#: example_mappings.xml:63 +#, no-c-format +msgid "" +"Consider the following model of the relationships between <literal>Work</" +"literal>, <literal>Author</literal> and <literal>Person</literal>. We " +"represent the relationship between <literal>Work</literal> and " +"<literal>Author</literal> as a many-to-many association. We choose to " +"represent the relationship between <literal>Author</literal> and " +"<literal>Person</literal> as one-to-one association. Another possibility " +"would be to have <literal>Author</literal> extend <literal>Person</literal>." msgstr "" +"Considere o seguinte modelo de relacionamento entre <literal>Work</literal>, " +"<literal>Author</literal> e <literal>Person</literal>. Nós representamos o " +"relacionamento entre <literal>Work</literal> e <literal>Author</literal> " +"como uma associação muitos-para-muitos. Nós escolhemos representar o " +"relacionamento entre <literal>Author</literal> e <literal>Person</literal> " +"como uma associação um-para-um. Outra possibilidade seria ter " +"<literal>Author</literal> extendendo <literal>Person</literal>." -#: index.docbook:81 -msgid "The following mapping document correctly represents these relationships:" +#. Tag: para +#: example_mappings.xml:81 +#, no-c-format +msgid "" +"The following mapping document correctly represents these relationships:" msgstr "" +"O mapeamento do código seguinte representa corretamente estes " +"relacionamentos:" -#: index.docbook:85 +#. Tag: programlisting +#: example_mappings.xml:85 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"Work\" table=\"works\" discriminator-value=\"W\">\n" - "\n" - " <id name=\"id\" column=\"id\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <discriminator column=\"type\" type=\"character\"/>\n" - "\n" - " <property name=\"title\"/>\n" - " <set name=\"authors\" table=\"author_work\">\n" - " <key column name=\"work_id\"/>\n" - " <many-to-many class=\"Author\" column name=\"author_id\"/>\n" - " </set>\n" - "\n" - " <subclass name=\"Book\" discriminator-value=\"B\">\n" - " <property name=\"text\"/>\n" - " </subclass>\n" - "\n" - " <subclass name=\"Song\" discriminator-value=\"S\">\n" - " <property name=\"tempo\"/>\n" - " <property name=\"genre\"/>\n" - " </subclass>\n" - "\n" - " </class>\n" - "\n" - " <class name=\"Author\" table=\"authors\">\n" - "\n" - " <id name=\"id\" column=\"id\">\n" - " \n" - " <generator class=\"assigned\"/> \n" - " </id>\n" - "\n" - " <property name=\"alias\"/>\n" - " <one-to-one name=\"person\" constrained=\"true\"/>\n" - "\n" - " <set name=\"works\" table=\"author_work\" inverse=\"true\">\n" - " <key column=\"author_id\"/>\n" - " <many-to-many class=\"Work\" column=\"work_id\"/>\n" - " </set>\n" - "\n" - " </class>\n" - "\n" - " <class name=\"Person\" table=\"persons\">\n" - " <id name=\"id\" column=\"id\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +"\n" +" <class name=\"Work\" table=\"works\" discriminator-value=\"W\">\n" +"\n" +" <id name=\"id\" column=\"id\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <discriminator column=\"type\" type=\"character\"/>\n" +"\n" +" <property name=\"title\"/>\n" +" <set name=\"authors\" table=\"author_work\">\n" +" <key column name=\"work_id\"/>\n" +" <many-to-many class=\"Author\" column name=\"author_id\"/>\n" +" </set>\n" +"\n" +" <subclass name=\"Book\" discriminator-value=\"B\">\n" +" <property name=\"text\"/>\n" +" </subclass>\n" +"\n" +" <subclass name=\"Song\" discriminator-value=\"S\">\n" +" <property name=\"tempo\"/>\n" +" <property name=\"genre\"/>\n" +" </subclass>\n" +"\n" +" </class>\n" +"\n" +" <class name=\"Author\" table=\"authors\">\n" +"\n" +" <id name=\"id\" column=\"id\">\n" +" \n" +" <generator class=\"assigned\"/> \n" +" </id>\n" +"\n" +" <property name=\"alias\"/>\n" +" <one-to-one name=\"person\" constrained=\"true\"/>\n" +"\n" +" <set name=\"works\" table=\"author_work\" inverse=\"true\">\n" +" <key column=\"author_id\"/>\n" +" <many-to-many class=\"Work\" column=\"work_id\"/>\n" +" </set>\n" +"\n" +" </class>\n" +"\n" +" <class name=\"Person\" table=\"persons\">\n" +" <id name=\"id\" column=\"id\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <property name=\"name\"/>\n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" -#: index.docbook:87 -msgid "There are four tables in this mapping. <literal>works</literal>, <literal>authors</literal> and <literal>persons</literal> hold work, author and person data respectively. <literal>author_work</literal> is an association table linking authors to works. Heres the table schema, as generated by <literal>SchemaExport</literal>." +#. Tag: para +#: example_mappings.xml:87 +#, no-c-format +msgid "" +"There are four tables in this mapping. <literal>works</literal>, " +"<literal>authors</literal> and <literal>persons</literal> hold work, author " +"and person data respectively. <literal>author_work</literal> is an " +"association table linking authors to works. Heres the table schema, as " +"generated by <literal>SchemaExport</literal>." msgstr "" +"There are four tables in this mapping. <literal>works</literal>, " +"<literal>authors</literal> and <literal>persons</literal> hold work, author " +"and person data respectively. <literal>author_work</literal> is an " +"association table linking authors to works. Heres the table schema, as " +"generated by <literal>SchemaExport</literal>. Existem quatro tabelas neste " +"mapeamento. <literal>works</literal>, <literal>authors</literal> e " +"<literal>persons</literal> recebem os dados de work, author e person, " +"respectivamente. <literal>author_work</literal> é uma tabela de associação " +"que liga authors à works. Abaixo o esquema das tabelas, gerados pelo " +"<literal>SchemaExport</literal>." -#: index.docbook:95 +#. Tag: programlisting +#: example_mappings.xml:95 +#, no-c-format msgid "" - "<![CDATA[create table works (\n" - " id BIGINT not null generated by default as identity, \n" - " tempo FLOAT, \n" - " genre VARCHAR(255), \n" - " text INTEGER, \n" - " title VARCHAR(255), \n" - " type CHAR(1) not null, \n" - " primary key (id)\n" - ")\n" - "\n" - "create table author_work (\n" - " author_id BIGINT not null, \n" - " work_id BIGINT not null, \n" - " primary key (work_id, author_id)\n" - ")\n" - "\n" - "create table authors (\n" - " id BIGINT not null generated by default as identity, \n" - " alias VARCHAR(255), \n" - " primary key (id)\n" - ")\n" - "\n" - "create table persons (\n" - " id BIGINT not null generated by default as identity, \n" - " name VARCHAR(255), \n" - " primary key (id)\n" - ")\n" - "\n" - "alter table authors \n" - " add constraint authorsFK0 foreign key (id) references persons\n" - "alter table author_work \n" - " add constraint author_workFK0 foreign key (author_id) references authors\n" - "alter table author_work\n" - " add constraint author_workFK1 foreign key (work_id) references works]]>" +"<![CDATA[create table works (\n" +" id BIGINT not null generated by default as identity, \n" +" tempo FLOAT, \n" +" genre VARCHAR(255), \n" +" text INTEGER, \n" +" title VARCHAR(255), \n" +" type CHAR(1) not null, \n" +" primary key (id)\n" +")\n" +"\n" +"create table author_work (\n" +" author_id BIGINT not null, \n" +" work_id BIGINT not null, \n" +" primary key (work_id, author_id)\n" +")\n" +"\n" +"create table authors (\n" +" id BIGINT not null generated by default as identity, \n" +" alias VARCHAR(255), \n" +" primary key (id)\n" +")\n" +"\n" +"create table persons (\n" +" id BIGINT not null generated by default as identity, \n" +" name VARCHAR(255), \n" +" primary key (id)\n" +")\n" +"\n" +"alter table authors \n" +" add constraint authorsFK0 foreign key (id) references persons\n" +"alter table author_work \n" +" add constraint author_workFK0 foreign key (author_id) references " +"authors\n" +"alter table author_work\n" +" add constraint author_workFK1 foreign key (work_id) references works]]>" msgstr "" -#: index.docbook:100 +#. Tag: title +#: example_mappings.xml:100 +#, no-c-format msgid "Customer/Order/Product" -msgstr "" +msgstr "Customer/Order/Product" -#: index.docbook:102 -msgid "Now consider a model of the relationships between <literal>Customer</literal>, <literal>Order</literal> and <literal>LineItem</literal> and <literal>Product</literal>. There is a one-to-many association between <literal>Customer</literal> and <literal>Order</literal>, but how should we represent <literal>Order</literal> / <literal>LineItem</literal> / <literal>Product</literal>? I've chosen to map <literal>LineItem</literal> as an association class representing the many-to-many association between <literal>Order</literal> and <literal>Product</literal>. In Hibernate, this is called a composite element." +#. Tag: para +#: example_mappings.xml:102 +#, no-c-format +msgid "" +"Now consider a model of the relationships between <literal>Customer</" +"literal>, <literal>Order</literal> and <literal>LineItem</literal> and " +"<literal>Product</literal>. There is a one-to-many association between " +"<literal>Customer</literal> and <literal>Order</literal>, but how should we " +"represent <literal>Order</literal> / <literal>LineItem</literal> / " +"<literal>Product</literal>? I've chosen to map <literal>LineItem</literal> " +"as an association class representing the many-to-many association between " +"<literal>Order</literal> and <literal>Product</literal>. In Hibernate, this " +"is called a composite element." msgstr "" +"Agora considere um modelo de relacionamento entre <literal>Customer</" +"literal>, <literal>Order</literal> e <literal>LineItem</literal> e " +"<literal>Product</literal>. Existe uma associação um-para-muitos entre " +"<literal>Customer</literal> e <literal>Order</literal>, mas como devemos " +"representar <literal>Order</literal> / <literal>LineItem</literal> / " +"<literal>Product</literal>? Eu escolhi mapear LineItem como uma classe de " +"associação representando a associação muitos-para-muitos entre " +"<literal>Order</literal> and <literal>Product</literal>. No Hibernate, isto " +"é conhecido como um elemento composto." -#: index.docbook:122 +#. Tag: para +#: example_mappings.xml:122 +#, no-c-format msgid "The mapping document:" -msgstr "" +msgstr "O código do mapeamento:" -#: index.docbook:126 +#. Tag: programlisting +#: example_mappings.xml:126 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"Customer\" table=\"customers\">\n" - " <id name=\"id\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " <set name=\"orders\" inverse=\"true\">\n" - " <key column=\"customer_id\"/>\n" - " <one-to-many class=\"Order\"/>\n" - " </set>\n" - " </class>\n" - "\n" - " <class name=\"Order\" table=\"orders\">\n" - " <id name=\"id\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"date\"/>\n" - " <many-to-one name=\"customer\" column=\"customer_id\"/>\n" - " <list name=\"lineItems\" table=\"line_items\">\n" - " <key column=\"order_id\"/>\n" - " <list-index column=\"line_number\"/>\n" - " <composite-element class=\"LineItem\">\n" - " <property name=\"quantity\"/>\n" - " <many-to-one name=\"product\" column=\"product_id\"/>\n" - " </composite-element>\n" - " </list>\n" - " </class>\n" - "\n" - " <class name=\"Product\" table=\"products\">\n" - " <id name=\"id\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"serialNumber\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +"\n" +" <class name=\"Customer\" table=\"customers\">\n" +" <id name=\"id\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <property name=\"name\"/>\n" +" <set name=\"orders\" inverse=\"true\">\n" +" <key column=\"customer_id\"/>\n" +" <one-to-many class=\"Order\"/>\n" +" </set>\n" +" </class>\n" +"\n" +" <class name=\"Order\" table=\"orders\">\n" +" <id name=\"id\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <property name=\"date\"/>\n" +" <many-to-one name=\"customer\" column=\"customer_id\"/>\n" +" <list name=\"lineItems\" table=\"line_items\">\n" +" <key column=\"order_id\"/>\n" +" <list-index column=\"line_number\"/>\n" +" <composite-element class=\"LineItem\">\n" +" <property name=\"quantity\"/>\n" +" <many-to-one name=\"product\" column=\"product_id\"/>\n" +" </composite-element>\n" +" </list>\n" +" </class>\n" +"\n" +" <class name=\"Product\" table=\"products\">\n" +" <id name=\"id\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <property name=\"serialNumber\"/>\n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" -#: index.docbook:128 -msgid "<literal>customers</literal>, <literal>orders</literal>, <literal>line_items</literal> and <literal>products</literal> hold customer, order, order line item and product data respectively. <literal>line_items</literal> also acts as an association table linking orders with products." +#. Tag: para +#: example_mappings.xml:128 +#, no-c-format +msgid "" +"<literal>customers</literal>, <literal>orders</literal>, " +"<literal>line_items</literal> and <literal>products</literal> hold customer, " +"order, order line item and product data respectively. <literal>line_items</" +"literal> also acts as an association table linking orders with products." msgstr "" +"<literal>customers</literal>, <literal>orders</literal>, " +"<literal>line_items</literal> e <literal>products</literal> recebem os dados " +"de customer, order, line_item e product, respectivamente. " +"<literal>line_items</literal> também atua como uma tabela de associação " +"ligando orders com products." -#: index.docbook:135 +#. Tag: programlisting +#: example_mappings.xml:135 +#, no-c-format msgid "" - "<![CDATA[create table customers (\n" - " id BIGINT not null generated by default as identity, \n" - " name VARCHAR(255), \n" - " primary key (id)\n" - ")\n" - "\n" - "create table orders (\n" - " id BIGINT not null generated by default as identity, \n" - " customer_id BIGINT, \n" - " date TIMESTAMP, \n" - " primary key (id)\n" - ")\n" - "\n" - "create table line_items (\n" - " line_number INTEGER not null, \n" - " order_id BIGINT not null, \n" - " product_id BIGINT, \n" - " quantity INTEGER, \n" - " primary key (order_id, line_number)\n" - ")\n" - "\n" - "create table products (\n" - " id BIGINT not null generated by default as identity, \n" - " serialNumber VARCHAR(255), \n" - " primary key (id)\n" - ")\n" - "\n" - "alter table orders \n" - " add constraint ordersFK0 foreign key (customer_id) references customers\n" - "alter table line_items\n" - " add constraint line_itemsFK0 foreign key (product_id) references products\n" - "alter table line_items\n" - " add constraint line_itemsFK1 foreign key (order_id) references orders]]>" +"<![CDATA[create table customers (\n" +" id BIGINT not null generated by default as identity, \n" +" name VARCHAR(255), \n" +" primary key (id)\n" +")\n" +"\n" +"create table orders (\n" +" id BIGINT not null generated by default as identity, \n" +" customer_id BIGINT, \n" +" date TIMESTAMP, \n" +" primary key (id)\n" +")\n" +"\n" +"create table line_items (\n" +" line_number INTEGER not null, \n" +" order_id BIGINT not null, \n" +" product_id BIGINT, \n" +" quantity INTEGER, \n" +" primary key (order_id, line_number)\n" +")\n" +"\n" +"create table products (\n" +" id BIGINT not null generated by default as identity, \n" +" serialNumber VARCHAR(255), \n" +" primary key (id)\n" +")\n" +"\n" +"alter table orders \n" +" add constraint ordersFK0 foreign key (customer_id) references customers\n" +"alter table line_items\n" +" add constraint line_itemsFK0 foreign key (product_id) references " +"products\n" +"alter table line_items\n" +" add constraint line_itemsFK1 foreign key (order_id) references orders]]>" msgstr "" -#: index.docbook:140 +#. Tag: title +#: example_mappings.xml:140 +#, no-c-format msgid "Miscellaneous example mappings" -msgstr "" +msgstr "Exemplos variados de mapeamento" -#: index.docbook:142 -msgid "These examples are all taken from the Hibernate test suite. You will find many other useful example mappings there. Look in the <literal>test</literal> folder of the Hibernate distribution." +#. Tag: para +#: example_mappings.xml:142 +#, no-c-format +msgid "" +"These examples are all taken from the Hibernate test suite. You will find " +"many other useful example mappings there. Look in the <literal>test</" +"literal> folder of the Hibernate distribution." msgstr "" +"Todos estes exemplos são retirados do conjunto de testes do Hibernate. Lá, " +"você encontrará vários outros exemplos úteis de mapeamentos. Verifique o " +"diretorio <literal>test</literal> da distribuição do Hibernate." -#: index.docbook:148 +#. Tag: para +#: example_mappings.xml:148 +#, no-c-format msgid "TODO: put words around this stuff" -msgstr "" +msgstr "TODO: put words around this stuff" -#: index.docbook:151 +#. Tag: title +#: example_mappings.xml:151 +#, no-c-format msgid "\"Typed\" one-to-one association" -msgstr "" +msgstr "Associação um-para-um \"Tipadas\"" -#: index.docbook:152 +#. Tag: programlisting +#: example_mappings.xml:152 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"name\"/>\n" - " <one-to-one name=\"address\" \n" - " cascade=\"all\">\n" - " <formula>name</formula>\n" - " <formula>'HOME'</formula>\n" - " </one-to-one>\n" - " <one-to-one name=\"mailingAddress\" \n" - " cascade=\"all\">\n" - " <formula>name</formula>\n" - " <formula>'MAILING'</formula>\n" - " </one-to-one>\n" - "</class>\n" - "\n" - "<class name=\"Address\" batch-size=\"2\" \n" - " check=\"addressType in ('MAILING', 'HOME', 'BUSINESS')\">\n" - " <composite-id>\n" - " <key-many-to-one name=\"person\" \n" - " column=\"personName\"/>\n" - " <key-property name=\"type\" \n" - " column=\"addressType\"/>\n" - " </composite-id>\n" - " <property name=\"street\" type=\"text\"/>\n" - " <property name=\"state\"/>\n" - " <property name=\"zip\"/>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"name\"/>\n" +" <one-to-one name=\"address\" \n" +" cascade=\"all\">\n" +" <formula>name</formula>\n" +" <formula>'HOME'</formula>\n" +" </one-to-one>\n" +" <one-to-one name=\"mailingAddress\" \n" +" cascade=\"all\">\n" +" <formula>name</formula>\n" +" <formula>'MAILING'</formula>\n" +" </one-to-one>\n" +"</class>\n" +"\n" +"<class name=\"Address\" batch-size=\"2\" \n" +" check=\"addressType in ('MAILING', 'HOME', 'BUSINESS')\">\n" +" <composite-id>\n" +" <key-many-to-one name=\"person\" \n" +" column=\"personName\"/>\n" +" <key-property name=\"type\" \n" +" column=\"addressType\"/>\n" +" </composite-id>\n" +" <property name=\"street\" type=\"text\"/>\n" +" <property name=\"state\"/>\n" +" <property name=\"zip\"/>\n" +"</class>]]>" msgstr "" -#: index.docbook:156 +#. Tag: title +#: example_mappings.xml:156 +#, no-c-format msgid "Composite key example" -msgstr "" +msgstr "Exemplo de chave composta" -#: index.docbook:157 +#. Tag: programlisting +#: example_mappings.xml:157 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Customer\">\n" - "\n" - " <id name=\"customerId\"\n" - " length=\"10\">\n" - " <generator class=\"assigned\"/>\n" - " </id>\n" - "\n" - " <property name=\"name\" not-null=\"true\" length=\"100\"/>\n" - " <property name=\"address\" not-null=\"true\" length=\"200\"/>\n" - "\n" - " <list name=\"orders\"\n" - " inverse=\"true\"\n" - " cascade=\"save-update\">\n" - " <key column=\"customerId\"/>\n" - " <index column=\"orderNumber\"/>\n" - " <one-to-many class=\"Order\"/>\n" - " </list>\n" - "\n" - "</class>\n" - "\n" - "<class name=\"Order\" table=\"CustomerOrder\" lazy=\"true\">\n" - " <synchronize table=\"LineItem\"/>\n" - " <synchronize table=\"Product\"/>\n" - " \n" - " <composite-id name=\"id\" \n" - " class=\"Order$Id\">\n" - " <key-property name=\"customerId\" length=\"10\"/>\n" - " <key-property name=\"orderNumber\"/>\n" - " </composite-id>\n" - " \n" - " <property name=\"orderDate\" \n" - " type=\"calendar_date\"\n" - " not-null=\"true\"/>\n" - " \n" - " <property name=\"total\">\n" - " <formula>\n" - " ( select sum(li.quantity*p.price) \n" - " from LineItem li, Product p \n" - " where li.productId = p.productId \n" - " and li.customerId = customerId \n" - " and li.orderNumber = orderNumber )\n" - " </formula>\n" - " </property>\n" - " \n" - " <many-to-one name=\"customer\"\n" - " column=\"customerId\"\n" - " insert=\"false\"\n" - " update=\"false\" \n" - " not-null=\"true\"/>\n" - " \n" - " <bag name=\"lineItems\"\n" - " fetch=\"join\" \n" - " inverse=\"true\"\n" - " cascade=\"save-update\">\n" - " <key>\n" - " <column name=\"customerId\"/>\n" - " <column name=\"orderNumber\"/>\n" - " </key>\n" - " <one-to-many class=\"LineItem\"/>\n" - " </bag>\n" - " \n" - "</class>\n" - " \n" - "<class name=\"LineItem\">\n" - " \n" - " <composite-id name=\"id\" \n" - " class=\"LineItem$Id\">\n" - " <key-property name=\"customerId\" length=\"10\"/>\n" - " <key-property name=\"orderNumber\"/>\n" - " <key-property name=\"productId\" length=\"10\"/>\n" - " </composite-id>\n" - " \n" - " <property name=\"quantity\"/>\n" - " \n" - " <many-to-one name=\"order\"\n" - " insert=\"false\"\n" - " update=\"false\" \n" - " not-null=\"true\">\n" - " <column name=\"customerId\"/>\n" - " <column name=\"orderNumber\"/>\n" - " </many-to-one>\n" - " \n" - " <many-to-one name=\"product\"\n" - " insert=\"false\"\n" - " update=\"false\" \n" - " not-null=\"true\"\n" - " column=\"productId\"/>\n" - " \n" - "</class>\n" - "\n" - "<class name=\"Product\">\n" - " <synchronize table=\"LineItem\"/>\n" - "\n" - " <id name=\"productId\"\n" - " length=\"10\">\n" - " <generator class=\"assigned\"/>\n" - " </id>\n" - " \n" - " <property name=\"description\" \n" - " not-null=\"true\" \n" - " length=\"200\"/>\n" - " <property name=\"price\" length=\"3\"/>\n" - " <property name=\"numberAvailable\"/>\n" - " \n" - " <property name=\"numberOrdered\">\n" - " <formula>\n" - " ( select sum(li.quantity) \n" - " from LineItem li \n" - " where li.productId = productId )\n" - " </formula>\n" - " </property>\n" - " \n" - "</class>]]>" +"<![CDATA[<class name=\"Customer\">\n" +"\n" +" <id name=\"customerId\"\n" +" length=\"10\">\n" +" <generator class=\"assigned\"/>\n" +" </id>\n" +"\n" +" <property name=\"name\" not-null=\"true\" length=\"100\"/>\n" +" <property name=\"address\" not-null=\"true\" length=\"200\"/>\n" +"\n" +" <list name=\"orders\"\n" +" inverse=\"true\"\n" +" cascade=\"save-update\">\n" +" <key column=\"customerId\"/>\n" +" <index column=\"orderNumber\"/>\n" +" <one-to-many class=\"Order\"/>\n" +" </list>\n" +"\n" +"</class>\n" +"\n" +"<class name=\"Order\" table=\"CustomerOrder\" lazy=\"true\">\n" +" <synchronize table=\"LineItem\"/>\n" +" <synchronize table=\"Product\"/>\n" +" \n" +" <composite-id name=\"id\" \n" +" class=\"Order$Id\">\n" +" <key-property name=\"customerId\" length=\"10\"/>\n" +" <key-property name=\"orderNumber\"/>\n" +" </composite-id>\n" +" \n" +" <property name=\"orderDate\" \n" +" type=\"calendar_date\"\n" +" not-null=\"true\"/>\n" +" \n" +" <property name=\"total\">\n" +" <formula>\n" +" ( select sum(li.quantity*p.price) \n" +" from LineItem li, Product p \n" +" where li.productId = p.productId \n" +" and li.customerId = customerId \n" +" and li.orderNumber = orderNumber )\n" +" </formula>\n" +" </property>\n" +" \n" +" <many-to-one name=\"customer\"\n" +" column=\"customerId\"\n" +" insert=\"false\"\n" +" update=\"false\" \n" +" not-null=\"true\"/>\n" +" \n" +" <bag name=\"lineItems\"\n" +" fetch=\"join\" \n" +" inverse=\"true\"\n" +" cascade=\"save-update\">\n" +" <key>\n" +" <column name=\"customerId\"/>\n" +" <column name=\"orderNumber\"/>\n" +" </key>\n" +" <one-to-many class=\"LineItem\"/>\n" +" </bag>\n" +" \n" +"</class>\n" +" \n" +"<class name=\"LineItem\">\n" +" \n" +" <composite-id name=\"id\" \n" +" class=\"LineItem$Id\">\n" +" <key-property name=\"customerId\" length=\"10\"/>\n" +" <key-property name=\"orderNumber\"/>\n" +" <key-property name=\"productId\" length=\"10\"/>\n" +" </composite-id>\n" +" \n" +" <property name=\"quantity\"/>\n" +" \n" +" <many-to-one name=\"order\"\n" +" insert=\"false\"\n" +" update=\"false\" \n" +" not-null=\"true\">\n" +" <column name=\"customerId\"/>\n" +" <column name=\"orderNumber\"/>\n" +" </many-to-one>\n" +" \n" +" <many-to-one name=\"product\"\n" +" insert=\"false\"\n" +" update=\"false\" \n" +" not-null=\"true\"\n" +" column=\"productId\"/>\n" +" \n" +"</class>\n" +"\n" +"<class name=\"Product\">\n" +" <synchronize table=\"LineItem\"/>\n" +"\n" +" <id name=\"productId\"\n" +" length=\"10\">\n" +" <generator class=\"assigned\"/>\n" +" </id>\n" +" \n" +" <property name=\"description\" \n" +" not-null=\"true\" \n" +" length=\"200\"/>\n" +" <property name=\"price\" length=\"3\"/>\n" +" <property name=\"numberAvailable\"/>\n" +" \n" +" <property name=\"numberOrdered\">\n" +" <formula>\n" +" ( select sum(li.quantity) \n" +" from LineItem li \n" +" where li.productId = productId )\n" +" </formula>\n" +" </property>\n" +" \n" +"</class>]]>" msgstr "" -#: index.docbook:161 +#. Tag: title +#: example_mappings.xml:161 +#, no-c-format msgid "Many-to-many with shared composite key attribute" -msgstr "" +msgstr "Mmuitos-para-muitos com atributo de chave composta compartilhada" -#: index.docbook:162 +#. Tag: programlisting +#: example_mappings.xml:162 +#, no-c-format msgid "" - "<![CDATA[<class name=\"User\" table=\"`User`\">\n" - " <composite-id>\n" - " <key-property name=\"name\"/>\n" - " <key-property name=\"org\"/>\n" - " </composite-id>\n" - " <set name=\"groups\" table=\"UserGroup\">\n" - " <key>\n" - " <column name=\"userName\"/>\n" - " <column name=\"org\"/>\n" - " </key>\n" - " <many-to-many class=\"Group\">\n" - " <column name=\"groupName\"/>\n" - " <formula>org</formula>\n" - " </many-to-many>\n" - " </set>\n" - "</class>\n" - " \n" - "<class name=\"Group\" table=\"`Group`\">\n" - " <composite-id>\n" - " <key-property name=\"name\"/>\n" - " <key-property name=\"org\"/>\n" - " </composite-id>\n" - " <property name=\"description\"/>\n" - " <set name=\"users\" table=\"UserGroup\" inverse=\"true\">\n" - " <key>\n" - " <column name=\"groupName\"/>\n" - " <column name=\"org\"/>\n" - " </key>\n" - " <many-to-many class=\"User\">\n" - " <column name=\"userName\"/>\n" - " <formula>org</formula>\n" - " </many-to-many>\n" - " </set>\n" - "</class>\n" - "]]>" +"<![CDATA[<class name=\"User\" table=\"`User`\">\n" +" <composite-id>\n" +" <key-property name=\"name\"/>\n" +" <key-property name=\"org\"/>\n" +" </composite-id>\n" +" <set name=\"groups\" table=\"UserGroup\">\n" +" <key>\n" +" <column name=\"userName\"/>\n" +" <column name=\"org\"/>\n" +" </key>\n" +" <many-to-many class=\"Group\">\n" +" <column name=\"groupName\"/>\n" +" <formula>org</formula>\n" +" </many-to-many>\n" +" </set>\n" +"</class>\n" +" \n" +"<class name=\"Group\" table=\"`Group`\">\n" +" <composite-id>\n" +" <key-property name=\"name\"/>\n" +" <key-property name=\"org\"/>\n" +" </composite-id>\n" +" <property name=\"description\"/>\n" +" <set name=\"users\" table=\"UserGroup\" inverse=\"true\">\n" +" <key>\n" +" <column name=\"groupName\"/>\n" +" <column name=\"org\"/>\n" +" </key>\n" +" <many-to-many class=\"User\">\n" +" <column name=\"userName\"/>\n" +" <formula>org</formula>\n" +" </many-to-many>\n" +" </set>\n" +"</class>\n" +"]]>" msgstr "" -#: index.docbook:166 +#. Tag: title +#: example_mappings.xml:166 +#, no-c-format msgid "Content based discrimination" -msgstr "" +msgstr "Conteúdo baseado em descriminação" -#: index.docbook:167 +#. Tag: programlisting +#: example_mappings.xml:167 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\"\n" - " discriminator-value=\"P\">\n" - " \n" - " <id name=\"id\" \n" - " column=\"person_id\" \n" - " unsaved-value=\"0\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " \n" - " \n" - " <discriminator \n" - " type=\"character\">\n" - " <formula>\n" - " case \n" - " when title is not null then 'E' \n" - " when salesperson is not null then 'C' \n" - " else 'P' \n" - " end\n" - " </formula>\n" - " </discriminator>\n" - "\n" - " <property name=\"name\" \n" - " not-null=\"true\"\n" - " length=\"80\"/>\n" - " \n" - " <property name=\"sex\" \n" - " not-null=\"true\"\n" - " update=\"false\"/>\n" - " \n" - " <component name=\"address\">\n" - " <property name=\"address\"/>\n" - " <property name=\"zip\"/>\n" - " <property name=\"country\"/>\n" - " </component>\n" - " \n" - " <subclass name=\"Employee\" \n" - " discriminator-value=\"E\">\n" - " <property name=\"title\"\n" - " length=\"20\"/>\n" - " <property name=\"salary\"/>\n" - " <many-to-one name=\"manager\"/>\n" - " </subclass>\n" - " \n" - " <subclass name=\"Customer\" \n" - " discriminator-value=\"C\">\n" - " <property name=\"comments\"/>\n" - " <many-to-one name=\"salesperson\"/>\n" - " </subclass>\n" - " \n" - "</class>]]>" +"<![CDATA[<class name=\"Person\"\n" +" discriminator-value=\"P\">\n" +" \n" +" <id name=\"id\" \n" +" column=\"person_id\" \n" +" unsaved-value=\"0\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" \n" +" \n" +" <discriminator \n" +" type=\"character\">\n" +" <formula>\n" +" case \n" +" when title is not null then 'E' \n" +" when salesperson is not null then 'C' \n" +" else 'P' \n" +" end\n" +" </formula>\n" +" </discriminator>\n" +"\n" +" <property name=\"name\" \n" +" not-null=\"true\"\n" +" length=\"80\"/>\n" +" \n" +" <property name=\"sex\" \n" +" not-null=\"true\"\n" +" update=\"false\"/>\n" +" \n" +" <component name=\"address\">\n" +" <property name=\"address\"/>\n" +" <property name=\"zip\"/>\n" +" <property name=\"country\"/>\n" +" </component>\n" +" \n" +" <subclass name=\"Employee\" \n" +" discriminator-value=\"E\">\n" +" <property name=\"title\"\n" +" length=\"20\"/>\n" +" <property name=\"salary\"/>\n" +" <many-to-one name=\"manager\"/>\n" +" </subclass>\n" +" \n" +" <subclass name=\"Customer\" \n" +" discriminator-value=\"C\">\n" +" <property name=\"comments\"/>\n" +" <many-to-one name=\"salesperson\"/>\n" +" </subclass>\n" +" \n" +"</class>]]>" msgstr "" -#: index.docbook:171 +#. Tag: title +#: example_mappings.xml:171 +#, no-c-format msgid "Associations on alternate keys" -msgstr "" +msgstr "Associações em chaves alternativas" -#: index.docbook:172 +#. Tag: programlisting +#: example_mappings.xml:172 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " \n" - " <id name=\"id\">\n" - " <generator class=\"hilo\"/>\n" - " </id>\n" - " \n" - " <property name=\"name\" length=\"100\"/>\n" - " \n" - " <one-to-one name=\"address\" \n" - " property-ref=\"person\"\n" - " cascade=\"all\"\n" - " fetch=\"join\"/>\n" - " \n" - " <set name=\"accounts\" \n" - " inverse=\"true\">\n" - " <key column=\"userId\"\n" - " property-ref=\"userId\"/>\n" - " <one-to-many class=\"Account\"/>\n" - " </set>\n" - " \n" - " <property name=\"userId\" length=\"8\"/>\n" - "\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - "\n" - " <id name=\"id\">\n" - " <generator class=\"hilo\"/>\n" - " </id>\n" - "\n" - " <property name=\"address\" length=\"300\"/>\n" - " <property name=\"zip\" length=\"5\"/>\n" - " <property name=\"country\" length=\"25\"/>\n" - " <many-to-one name=\"person\" unique=\"true\" not-null=\"true\"/>\n" - "\n" - "</class>\n" - "\n" - "<class name=\"Account\">\n" - " <id name=\"accountId\" length=\"32\">\n" - " <generator class=\"uuid\"/>\n" - " </id>\n" - " \n" - " <many-to-one name=\"user\"\n" - " column=\"userId\"\n" - " property-ref=\"userId\"/>\n" - " \n" - " <property name=\"type\" not-null=\"true\"/>\n" - " \n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" \n" +" <id name=\"id\">\n" +" <generator class=\"hilo\"/>\n" +" </id>\n" +" \n" +" <property name=\"name\" length=\"100\"/>\n" +" \n" +" <one-to-one name=\"address\" \n" +" property-ref=\"person\"\n" +" cascade=\"all\"\n" +" fetch=\"join\"/>\n" +" \n" +" <set name=\"accounts\" \n" +" inverse=\"true\">\n" +" <key column=\"userId\"\n" +" property-ref=\"userId\"/>\n" +" <one-to-many class=\"Account\"/>\n" +" </set>\n" +" \n" +" <property name=\"userId\" length=\"8\"/>\n" +"\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +"\n" +" <id name=\"id\">\n" +" <generator class=\"hilo\"/>\n" +" </id>\n" +"\n" +" <property name=\"address\" length=\"300\"/>\n" +" <property name=\"zip\" length=\"5\"/>\n" +" <property name=\"country\" length=\"25\"/>\n" +" <many-to-one name=\"person\" unique=\"true\" not-null=\"true\"/>\n" +"\n" +"</class>\n" +"\n" +"<class name=\"Account\">\n" +" <id name=\"accountId\" length=\"32\">\n" +" <generator class=\"uuid\"/>\n" +" </id>\n" +" \n" +" <many-to-one name=\"user\"\n" +" column=\"userId\"\n" +" property-ref=\"userId\"/>\n" +" \n" +" <property name=\"type\" not-null=\"true\"/>\n" +" \n" +"</class>]]>" msgstr "" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "" - Modified: core/trunk/documentation/manual/translations/pt-BR/content/example_parentchild.po =================================================================== --- core/trunk/documentation/manual/translations/pt-BR/content/example_parentchild.po 2007-10-25 22:34:46 UTC (rev 14134) +++ core/trunk/documentation/manual/translations/pt-BR/content/example_parentchild.po 2007-10-26 00:46:38 UTC (rev 14135) @@ -1,287 +1,605 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: example_parentchild.xml:5 +#, no-c-format msgid "Example: Parent/Child" -msgstr "" +msgstr "Example: Parent/Child" -#: index.docbook:7 -msgid "One of the very first things that new users try to do with Hibernate is to model a parent / child type relationship. There are two different approaches to this. For various reasons the most convenient approach, especially for new users, is to model both <literal>Parent</literal> and <literal>Child</literal> as entity classes with a <literal><one-to-many></literal> association from <literal>Parent</literal> to <literal>Child</literal>. (The alternative approach is to declare the <literal>Child</literal> as a <literal><composite-element></literal>.) Now, it turns out that default semantics of a one to many association (in Hibernate) are much less close to the usual semantics of a parent / child relationship than those of a composite element mapping. We will explain how to use a <emphasis>bidirectional one to many association with cascades</emphasis> to model a parent / child relationship efficiently and elegantly. It's not at all difficult!" +#. Tag: para +#: example_parentchild.xml:7 +#, no-c-format +msgid "" +"One of the very first things that new users try to do with Hibernate is to " +"model a parent / child type relationship. There are two different approaches " +"to this. For various reasons the most convenient approach, especially for " +"new users, is to model both <literal>Parent</literal> and <literal>Child</" +"literal> as entity classes with a <literal><one-to-many></literal> " +"association from <literal>Parent</literal> to <literal>Child</literal>. (The " +"alternative approach is to declare the <literal>Child</literal> as a " +"<literal><composite-element></literal>.) Now, it turns out that " +"default semantics of a one to many association (in Hibernate) are much less " +"close to the usual semantics of a parent / child relationship than those of " +"a composite element mapping. We will explain how to use a " +"<emphasis>bidirectional one to many association with cascades</emphasis> to " +"model a parent / child relationship efficiently and elegantly. It's not at " +"all difficult!" msgstr "" +"One of the very first things that new users try to do with Hibernate is to " +"model a parent / child type relationship. There are two different approaches " +"to this. For various reasons the most convenient approach, especially for " +"new users, is to model both <literal>Parent</literal> and <literal>Child</" +"literal> as entity classes with a <literal><one-to-many></literal> " +"association from <literal>Parent</literal> to <literal>Child</literal>. (The " +"alternative approach is to declare the <literal>Child</literal> as a " +"<literal><composite-element></literal>.) Now, it turns out that " +"default semantics of a one to many association (in Hibernate) are much less " +"close to the usual semantics of a parent / child relationship than those of " +"a composite element mapping. We will explain how to use a " +"<emphasis>bidirectional one to many association with cascades</emphasis> to " +"model a parent / child relationship efficiently and elegantly. It's not at " +"all difficult!" -#: index.docbook:21 +#. Tag: title +#: example_parentchild.xml:21 +#, no-c-format msgid "A note about collections" -msgstr "" +msgstr "A note about collections" -#: index.docbook:23 -msgid "Hibernate collections are considered to be a logical part of their owning entity; never of the contained entities. This is a crucial distinction! It has the following consequences:" +#. Tag: para +#: example_parentchild.xml:23 +#, no-c-format +msgid "" +"Hibernate collections are considered to be a logical part of their owning " +"entity; never of the contained entities. This is a crucial distinction! It " +"has the following consequences:" msgstr "" +"Hibernate collections are considered to be a logical part of their owning " +"entity; never of the contained entities. This is a crucial distinction! It " +"has the following consequences:" -#: index.docbook:30 -msgid "When we remove / add an object from / to a collection, the version number of the collection owner is incremented." +#. Tag: para +#: example_parentchild.xml:30 +#, no-c-format +msgid "" +"When we remove / add an object from / to a collection, the version number of " +"the collection owner is incremented." msgstr "" +"When we remove / add an object from / to a collection, the version number of " +"the collection owner is incremented." -#: index.docbook:36 -msgid "If an object that was removed from a collection is an instance of a value type (eg, a composite element), that object will cease to be persistent and its state will be completely removed from the database. Likewise, adding a value type instance to the collection will cause its state to be immediately persistent." +#. Tag: para +#: example_parentchild.xml:36 +#, no-c-format +msgid "" +"If an object that was removed from a collection is an instance of a value " +"type (eg, a composite element), that object will cease to be persistent and " +"its state will be completely removed from the database. Likewise, adding a " +"value type instance to the collection will cause its state to be immediately " +"persistent." msgstr "" +"If an object that was removed from a collection is an instance of a value " +"type (eg, a composite element), that object will cease to be persistent and " +"its state will be completely removed from the database. Likewise, adding a " +"value type instance to the collection will cause its state to be immediately " +"persistent." -#: index.docbook:44 -msgid "On the other hand, if an entity is removed from a collection (a one-to-many or many-to-many association), it will not be deleted, by default. This behaviour is completely consistent - a change to the internal state of another entity should not cause the associated entity to vanish! Likewise, adding an entity to a collection does not cause that entity to become persistent, by default." +#. Tag: para +#: example_parentchild.xml:44 +#, no-c-format +msgid "" +"On the other hand, if an entity is removed from a collection (a one-to-many " +"or many-to-many association), it will not be deleted, by default. This " +"behaviour is completely consistent - a change to the internal state of " +"another entity should not cause the associated entity to vanish! Likewise, " +"adding an entity to a collection does not cause that entity to become " +"persistent, by default." msgstr "" +"On the other hand, if an entity is removed from a collection (a one-to-many " +"or many-to-many association), it will not be deleted, by default. This " +"behaviour is completely consistent - a change to the internal state of " +"another entity should not cause the associated entity to vanish! Likewise, " +"adding an entity to a collection does not cause that entity to become " +"persistent, by default." -#: index.docbook:54 -msgid "Instead, the default behaviour is that adding an entity to a collection merely creates a link between the two entities, while removing it removes the link. This is very appropriate for all sorts of cases. Where it is not appropriate at all is the case of a parent / child relationship, where the life of the child is bound to the life cycle of the parent." +#. Tag: para +#: example_parentchild.xml:54 +#, no-c-format +msgid "" +"Instead, the default behaviour is that adding an entity to a collection " +"merely creates a link between the two entities, while removing it removes " +"the link. This is very appropriate for all sorts of cases. Where it is not " +"appropriate at all is the case of a parent / child relationship, where the " +"life of the child is bound to the life cycle of the parent." msgstr "" +"Instead, the default behaviour is that adding an entity to a collection " +"merely creates a link between the two entities, while removing it removes " +"the link. This is very appropriate for all sorts of cases. Where it is not " +"appropriate at all is the case of a parent / child relationship, where the " +"life of the child is bound to the life cycle of the parent." -#: index.docbook:64 +#. Tag: title +#: example_parentchild.xml:64 +#, no-c-format msgid "Bidirectional one-to-many" -msgstr "" +msgstr "Bidirectional one-to-many" -#: index.docbook:66 -msgid "Suppose we start with a simple <literal><one-to-many></literal> association from <literal>Parent</literal> to <literal>Child</literal>." +#. Tag: para +#: example_parentchild.xml:66 +#, no-c-format +msgid "" +"Suppose we start with a simple <literal><one-to-many></literal> " +"association from <literal>Parent</literal> to <literal>Child</literal>." msgstr "" +"Suppose we start with a simple <literal><one-to-many></literal> " +"association from <literal>Parent</literal> to <literal>Child</literal>." -#: index.docbook:71 +#. Tag: programlisting +#: example_parentchild.xml:71 +#, no-c-format msgid "" - "<![CDATA[<set name=\"children\">\n" - " <key column=\"parent_id\"/>\n" - " <one-to-many class=\"Child\"/>\n" - "</set>]]>" +"<![CDATA[<set name=\"children\">\n" +" <key column=\"parent_id\"/>\n" +" <one-to-many class=\"Child\"/>\n" +"</set>]]>" msgstr "" -#: index.docbook:73 +#. Tag: para +#: example_parentchild.xml:73 +#, no-c-format msgid "If we were to execute the following code" -msgstr "" +msgstr "If we were to execute the following code" -#: index.docbook:77 +#. Tag: programlisting +#: example_parentchild.xml:77 +#, no-c-format msgid "" - "<![CDATA[Parent p = .....;\n" - "Child c = new Child();\n" - "p.getChildren().add(c);\n" - "session.save(c);\n" - "session.flush();]]>" +"<![CDATA[Parent p = .....;\n" +"Child c = new Child();\n" +"p.getChildren().add(c);\n" +"session.save(c);\n" +"session.flush();]]>" msgstr "" -#: index.docbook:79 +#. Tag: para +#: example_parentchild.xml:79 +#, no-c-format msgid "Hibernate would issue two SQL statements:" -msgstr "" +msgstr "Hibernate would issue two SQL statements:" -#: index.docbook:85 -msgid "an <literal>INSERT</literal> to create the record for <literal>c</literal>" +#. Tag: para +#: example_parentchild.xml:85 +#, no-c-format +msgid "" +"an <literal>INSERT</literal> to create the record for <literal>c</literal>" msgstr "" +"an <literal>INSERT</literal> to create the record for <literal>c</literal>" -#: index.docbook:88 -msgid "an <literal>UPDATE</literal> to create the link from <literal>p</literal> to <literal>c</literal>" +#. Tag: para +#: example_parentchild.xml:88 +#, no-c-format +msgid "" +"an <literal>UPDATE</literal> to create the link from <literal>p</literal> to " +"<literal>c</literal>" msgstr "" +"an <literal>UPDATE</literal> to create the link from <literal>p</literal> to " +"<literal>c</literal>" -#: index.docbook:95 -msgid "This is not only inefficient, but also violates any <literal>NOT NULL</literal> constraint on the <literal>parent_id</literal> column. We can fix the nullability constraint violation by specifying <literal>not-null=\"true\"</literal> in the collection mapping:" +#. Tag: para +#: example_parentchild.xml:95 +#, no-c-format +msgid "" +"This is not only inefficient, but also violates any <literal>NOT NULL</" +"literal> constraint on the <literal>parent_id</literal> column. We can fix " +"the nullability constraint violation by specifying <literal>not-null=\"true" +"\"</literal> in the collection mapping:" msgstr "" +"This is not only inefficient, but also violates any <literal>NOT NULL</" +"literal> constraint on the <literal>parent_id</literal> column. We can fix " +"the nullability constraint violation by specifying <literal>not-null=\"true" +"\"</literal> in the collection mapping:" -#: index.docbook:101 +#. Tag: programlisting +#: example_parentchild.xml:101 +#, no-c-format msgid "" - "<![CDATA[<set name=\"children\">\n" - " <key column=\"parent_id\" not-null=\"true\"/>\n" - " <one-to-many class=\"Child\"/>\n" - "</set>]]>" +"<![CDATA[<set name=\"children\">\n" +" <key column=\"parent_id\" not-null=\"true\"/>\n" +" <one-to-many class=\"Child\"/>\n" +"</set>]]>" msgstr "" -#: index.docbook:103 +#. Tag: para +#: example_parentchild.xml:103 +#, no-c-format msgid "However, this is not the recommended solution." -msgstr "" +msgstr "However, this is not the recommended solution." -#: index.docbook:106 -msgid "The underlying cause of this behaviour is that the link (the foreign key <literal>parent_id</literal>) from <literal>p</literal> to <literal>c</literal> is not considered part of the state of the <literal>Child</literal> object and is therefore not created in the <literal>INSERT</literal>. So the solution is to make the link part of the <literal>Child</literal> mapping." +#. Tag: para +#: example_parentchild.xml:106 +#, no-c-format +msgid "" +"The underlying cause of this behaviour is that the link (the foreign key " +"<literal>parent_id</literal>) from <literal>p</literal> to <literal>c</" +"literal> is not considered part of the state of the <literal>Child</literal> " +"object and is therefore not created in the <literal>INSERT</literal>. So the " +"solution is to make the link part of the <literal>Child</literal> mapping." msgstr "" +"The underlying cause of this behaviour is that the link (the foreign key " +"<literal>parent_id</literal>) from <literal>p</literal> to <literal>c</" +"literal> is not considered part of the state of the <literal>Child</literal> " +"object and is therefore not created in the <literal>INSERT</literal>. So the " +"solution is to make the link part of the <literal>Child</literal> mapping." -#: index.docbook:113 -msgid "<![CDATA[<many-to-one name=\"parent\" column=\"parent_id\" not-null=\"true\"/>]]>" +#. Tag: programlisting +#: example_parentchild.xml:113 +#, no-c-format +msgid "" +"<![CDATA[<many-to-one name=\"parent\" column=\"parent_id\" not-null=\"true\"/" +">]]>" msgstr "" -#: index.docbook:115 -msgid "(We also need to add the <literal>parent</literal> property to the <literal>Child</literal> class.)" +#. Tag: para +#: example_parentchild.xml:115 +#, no-c-format +msgid "" +"(We also need to add the <literal>parent</literal> property to the " +"<literal>Child</literal> class.)" msgstr "" +"(We also need to add the <literal>parent</literal> property to the " +"<literal>Child</literal> class.)" -#: index.docbook:119 -msgid "Now that the <literal>Child</literal> entity is managing the state of the link, we tell the collection not to update the link. We use the <literal>inverse</literal> attribute." +#. Tag: para +#: example_parentchild.xml:119 +#, no-c-format +msgid "" +"Now that the <literal>Child</literal> entity is managing the state of the " +"link, we tell the collection not to update the link. We use the " +"<literal>inverse</literal> attribute." msgstr "" +"Now that the <literal>Child</literal> entity is managing the state of the " +"link, we tell the collection not to update the link. We use the " +"<literal>inverse</literal> attribute." -#: index.docbook:124 +#. Tag: programlisting +#: example_parentchild.xml:124 +#, no-c-format msgid "" - "<![CDATA[<set name=\"children\" inverse=\"true\">\n" - " <key column=\"parent_id\"/>\n" - " <one-to-many class=\"Child\"/>\n" - "</set>]]>" +"<![CDATA[<set name=\"children\" inverse=\"true\">\n" +" <key column=\"parent_id\"/>\n" +" <one-to-many class=\"Child\"/>\n" +"</set>]]>" msgstr "" -#: index.docbook:126 +#. Tag: para +#: example_parentchild.xml:126 +#, no-c-format msgid "The following code would be used to add a new <literal>Child</literal>" -msgstr "" +msgstr "The following code would be used to add a new <literal>Child</literal>" -#: index.docbook:130 +#. Tag: programlisting +#: example_parentchild.xml:130 +#, no-c-format msgid "" - "<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" - "Child c = new Child();\n" - "c.setParent(p);\n" - "p.getChildren().add(c);\n" - "session.save(c);\n" - "session.flush();]]>" +"<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" +"Child c = new Child();\n" +"c.setParent(p);\n" +"p.getChildren().add(c);\n" +"session.save(c);\n" +"session.flush();]]>" msgstr "" -#: index.docbook:132 +#. Tag: para +#: example_parentchild.xml:132 +#, no-c-format msgid "And now, only one SQL <literal>INSERT</literal> would be issued!" -msgstr "" +msgstr "And now, only one SQL <literal>INSERT</literal> would be issued!" -#: index.docbook:136 -msgid "To tighten things up a bit, we could create an <literal>addChild()</literal> method of <literal>Parent</literal>." +#. Tag: para +#: example_parentchild.xml:136 +#, no-c-format +msgid "" +"To tighten things up a bit, we could create an <literal>addChild()</literal> " +"method of <literal>Parent</literal>." msgstr "" +"To tighten things up a bit, we could create an <literal>addChild()</literal> " +"method of <literal>Parent</literal>." -#: index.docbook:141 +#. Tag: programlisting +#: example_parentchild.xml:141 +#, no-c-format msgid "" - "<![CDATA[public void addChild(Child c) {\n" - " c.setParent(this);\n" - " children.add(c);\n" - "}]]>" +"<![CDATA[public void addChild(Child c) {\n" +" c.setParent(this);\n" +" children.add(c);\n" +"}]]>" msgstr "" -#: index.docbook:143 +#. Tag: para +#: example_parentchild.xml:143 +#, no-c-format msgid "Now, the code to add a <literal>Child</literal> looks like" -msgstr "" +msgstr "Now, the code to add a <literal>Child</literal> looks like" -#: index.docbook:147 +#. Tag: programlisting +#: example_parentchild.xml:147 +#, no-c-format msgid "" - "<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" - "Child c = new Child();\n" - "p.addChild(c);\n" - "session.save(c);\n" - "session.flush();]]>" +"<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" +"Child c = new Child();\n" +"p.addChild(c);\n" +"session.save(c);\n" +"session.flush();]]>" msgstr "" -#: index.docbook:152 +#. Tag: title +#: example_parentchild.xml:152 +#, no-c-format msgid "Cascading life cycle" -msgstr "" +msgstr "Cascading life cycle" -#: index.docbook:154 -msgid "The explicit call to <literal>save()</literal> is still annoying. We will address this by using cascades." +#. Tag: para +#: example_parentchild.xml:154 +#, no-c-format +msgid "" +"The explicit call to <literal>save()</literal> is still annoying. We will " +"address this by using cascades." msgstr "" +"The explicit call to <literal>save()</literal> is still annoying. We will " +"address this by using cascades." -#: index.docbook:159 +#. Tag: programlisting +#: example_parentchild.xml:159 +#, no-c-format msgid "" - "<![CDATA[<set name=\"children\" inverse=\"true\" cascade=\"all\">\n" - " <key column=\"parent_id\"/>\n" - " <one-to-many class=\"Child\"/>\n" - "</set>]]>" +"<![CDATA[<set name=\"children\" inverse=\"true\" cascade=\"all\">\n" +" <key column=\"parent_id\"/>\n" +" <one-to-many class=\"Child\"/>\n" +"</set>]]>" msgstr "" -#: index.docbook:161 +#. Tag: para +#: example_parentchild.xml:161 +#, no-c-format msgid "This simplifies the code above to" -msgstr "" +msgstr "This simplifies the code above to" -#: index.docbook:165 +#. Tag: programlisting +#: example_parentchild.xml:165 +#, no-c-format msgid "" - "<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" - "Child c = new Child();\n" - "p.addChild(c);\n" - "session.flush();]]>" +"<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" +"Child c = new Child();\n" +"p.addChild(c);\n" +"session.flush();]]>" msgstr "" -#: index.docbook:167 -msgid "Similarly, we don't need to iterate over the children when saving or deleting a <literal>Parent</literal>. The following removes <literal>p</literal> and all its children from the database." +#. Tag: para +#: example_parentchild.xml:167 +#, no-c-format +msgid "" +"Similarly, we don't need to iterate over the children when saving or " +"deleting a <literal>Parent</literal>. The following removes <literal>p</" +"literal> and all its children from the database." msgstr "" +"Similarly, we don't need to iterate over the children when saving or " +"deleting a <literal>Parent</literal>. The following removes <literal>p</" +"literal> and all its children from the database." -#: index.docbook:172 +#. Tag: programlisting +#: example_parentchild.xml:172 +#, no-c-format msgid "" - "<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" - "session.delete(p);\n" - "session.flush();]]>" +"<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" +"session.delete(p);\n" +"session.flush();]]>" msgstr "" -#: index.docbook:174 +#. Tag: para +#: example_parentchild.xml:174 +#, no-c-format msgid "However, this code" -msgstr "" +msgstr "However, this code" -#: index.docbook:178 +#. Tag: programlisting +#: example_parentchild.xml:178 +#, no-c-format msgid "" - "<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" - "Child c = (Child) p.getChildren().iterator().next();\n" - "p.getChildren().remove(c);\n" - "c.setParent(null);\n" - "session.flush();]]>" +"<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" +"Child c = (Child) p.getChildren().iterator().next();\n" +"p.getChildren().remove(c);\n" +"c.setParent(null);\n" +"session.flush();]]>" msgstr "" -#: index.docbook:180 -msgid "will not remove <literal>c</literal> from the database; it will ony remove the link to <literal>p</literal> (and cause a <literal>NOT NULL</literal> constraint violation, in this case). You need to explicitly <literal>delete()</literal> the <literal>Child</literal>." +#. Tag: para +#: example_parentchild.xml:180 +#, no-c-format +msgid "" +"will not remove <literal>c</literal> from the database; it will ony remove " +"the link to <literal>p</literal> (and cause a <literal>NOT NULL</literal> " +"constraint violation, in this case). You need to explicitly <literal>delete()" +"</literal> the <literal>Child</literal>." msgstr "" +"will not remove <literal>c</literal> from the database; it will ony remove " +"the link to <literal>p</literal> (and cause a <literal>NOT NULL</literal> " +"constraint violation, in this case). You need to explicitly <literal>delete()" +"</literal> the <literal>Child</literal>." -#: index.docbook:186 +#. Tag: programlisting +#: example_parentchild.xml:186 +#, no-c-format msgid "" - "<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" - "Child c = (Child) p.getChildren().iterator().next();\n" - "p.getChildren().remove(c);\n" - "session.delete(c);\n" - "session.flush();]]>" +"<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" +"Child c = (Child) p.getChildren().iterator().next();\n" +"p.getChildren().remove(c);\n" +"session.delete(c);\n" +"session.flush();]]>" msgstr "" -#: index.docbook:188 -msgid "Now, in our case, a <literal>Child</literal> can't really exist without its parent. So if we remove a <literal>Child</literal> from the collection, we really do want it to be deleted. For this, we must use <literal>cascade=\"all-delete-orphan\"</literal>." +#. Tag: para +#: example_parentchild.xml:188 +#, no-c-format +msgid "" +"Now, in our case, a <literal>Child</literal> can't really exist without its " +"parent. So if we remove a <literal>Child</literal> from the collection, we " +"really do want it to be deleted. For this, we must use <literal>cascade=" +"\"all-delete-orphan\"</literal>." msgstr "" +"Now, in our case, a <literal>Child</literal> can't really exist without its " +"parent. So if we remove a <literal>Child</literal> from the collection, we " +"really do want it to be deleted. For this, we must use <literal>cascade=" +"\"all-delete-orphan\"</literal>." -#: index.docbook:194 +#. Tag: programlisting +#: example_parentchild.xml:194 +#, no-c-format msgid "" - "<![CDATA[<set name=\"children\" inverse=\"true\" cascade=\"all-delete-orphan\">\n" - " <key column=\"parent_id\"/>\n" - " <one-to-many class=\"Child\"/>\n" - "</set>]]>" +"<![CDATA[<set name=\"children\" inverse=\"true\" cascade=\"all-delete-orphan" +"\">\n" +" <key column=\"parent_id\"/>\n" +" <one-to-many class=\"Child\"/>\n" +"</set>]]>" msgstr "" -#: index.docbook:196 -msgid "Note: even though the collection mapping specifies <literal>inverse=\"true\"</literal>, cascades are still processed by iterating the collection elements. So if you require that an object be saved, deleted or updated by cascade, you must add it to the collection. It is not enough to simply call <literal>setParent()</literal>." +#. Tag: para +#: example_parentchild.xml:196 +#, no-c-format +msgid "" +"Note: even though the collection mapping specifies <literal>inverse=\"true" +"\"</literal>, cascades are still processed by iterating the collection " +"elements. So if you require that an object be saved, deleted or updated by " +"cascade, you must add it to the collection. It is not enough to simply call " +"<literal>setParent()</literal>." msgstr "" +"Note: even though the collection mapping specifies <literal>inverse=\"true" +"\"</literal>, cascades are still processed by iterating the collection " +"elements. So if you require that an object be saved, deleted or updated by " +"cascade, you must add it to the collection. It is not enough to simply call " +"<literal>setParent()</literal>." -#: index.docbook:206 +#. Tag: title +#: example_parentchild.xml:206 +#, no-c-format msgid "Cascades and <literal>unsaved-value</literal>" -msgstr "" +msgstr "Cascades and <literal>unsaved-value</literal>" -#: index.docbook:208 -msgid "Suppose we loaded up a <literal>Parent</literal> in one <literal>Session</literal>, made some changes in a UI action and wish to persist these changes in a new session by calling <literal>update()</literal>. The <literal>Parent</literal> will contain a collection of childen and, since cascading update is enabled, Hibernate needs to know which children are newly instantiated and which represent existing rows in the database. Lets assume that both <literal>Parent</literal> and <literal>Child</literal> have genenerated identifier properties of type <literal>Long</literal>. Hibernate will use the identifier and version/timestamp property value to determine which of the children are new. (See <xref linkend=\"objectstate-saveorupdate\"/>.) <emphasis>In Hibernate3, it is no longer necessary to specify an <literal>unsaved-value</literal> explicitly.</emphasis>" +#. Tag: para +#: example_parentchild.xml:208 +#, no-c-format +msgid "" +"Suppose we loaded up a <literal>Parent</literal> in one <literal>Session</" +"literal>, made some changes in a UI action and wish to persist these changes " +"in a new session by calling <literal>update()</literal>. The " +"<literal>Parent</literal> will contain a collection of childen and, since " +"cascading update is enabled, Hibernate needs to know which children are " +"newly instantiated and which represent existing rows in the database. Lets " +"assume that both <literal>Parent</literal> and <literal>Child</literal> have " +"genenerated identifier properties of type <literal>Long</literal>. Hibernate " +"will use the identifier and version/timestamp property value to determine " +"which of the children are new. (See <xref linkend=\"objectstate-saveorupdate" +"\"/>.) <emphasis>In Hibernate3, it is no longer necessary to specify an " +"<literal>unsaved-value</literal> explicitly.</emphasis>" msgstr "" +"Suppose we loaded up a <literal>Parent</literal> in one <literal>Session</" +"literal>, made some changes in a UI action and wish to persist these changes " +"in a new session by calling <literal>update()</literal>. The " +"<literal>Parent</literal> will contain a collection of childen and, since " +"cascading update is enabled, Hibernate needs to know which children are " +"newly instantiated and which represent existing rows in the database. Lets " +"assume that both <literal>Parent</literal> and <literal>Child</literal> have " +"genenerated identifier properties of type <literal>Long</literal>. Hibernate " +"will use the identifier and version/timestamp property value to determine " +"which of the children are new. (See <xref linkend=\"objectstate-saveorupdate" +"\"/>.) <emphasis>In Hibernate3, it is no longer necessary to specify an " +"<literal>unsaved-value</literal> explicitly.</emphasis>" -#: index.docbook:220 -msgid "The following code will update <literal>parent</literal> and <literal>child</literal> and insert <literal>newChild</literal>." +#. Tag: para +#: example_parentchild.xml:220 +#, no-c-format +msgid "" +"The following code will update <literal>parent</literal> and <literal>child</" +"literal> and insert <literal>newChild</literal>." msgstr "" +"The following code will update <literal>parent</literal> and <literal>child</" +"literal> and insert <literal>newChild</literal>." -#: index.docbook:225 +#. Tag: programlisting +#: example_parentchild.xml:225 +#, no-c-format msgid "" - "<![CDATA[//parent and child were both loaded in a previous session\n" - "parent.addChild(child);\n" - "Child newChild = new Child();\n" - "parent.addChild(newChild);\n" - "session.update(parent);\n" - "session.flush();]]>" +"<![CDATA[//parent and child were both loaded in a previous session\n" +"parent.addChild(child);\n" +"Child newChild = new Child();\n" +"parent.addChild(newChild);\n" +"session.update(parent);\n" +"session.flush();]]>" msgstr "" -#: index.docbook:227 -msgid "Well, that's all very well for the case of a generated identifier, but what about assigned identifiers and composite identifiers? This is more difficult, since Hibernate can't use the identifier property to distinguish between a newly instantiated object (with an identifier assigned by the user) and an object loaded in a previous session. In this case, Hibernate will either use the timestamp or version property, or will actually query the second-level cache or, worst case, the database, to see if the row exists." +#. Tag: para +#: example_parentchild.xml:227 +#, no-c-format +msgid "" +"Well, that's all very well for the case of a generated identifier, but what " +"about assigned identifiers and composite identifiers? This is more " +"difficult, since Hibernate can't use the identifier property to distinguish " +"between a newly instantiated object (with an identifier assigned by the " +"user) and an object loaded in a previous session. In this case, Hibernate " +"will either use the timestamp or version property, or will actually query " +"the second-level cache or, worst case, the database, to see if the row " +"exists." msgstr "" +"Well, that's all very well for the case of a generated identifier, but what " +"about assigned identifiers and composite identifiers? This is more " +"difficult, since Hibernate can't use the identifier property to distinguish " +"between a newly instantiated object (with an identifier assigned by the " +"user) and an object loaded in a previous session. In this case, Hibernate " +"will either use the timestamp or version property, or will actually query " +"the second-level cache or, worst case, the database, to see if the row " +"exists." -#: index.docbook:260 +#. Tag: title +#: example_parentchild.xml:260 +#, no-c-format msgid "Conclusion" -msgstr "" +msgstr "Conclusion" -#: index.docbook:262 -msgid "There is quite a bit to digest here and it might look confusing first time around. However, in practice, it all works out very nicely. Most Hibernate applications use the parent / child pattern in many places." +#. Tag: para +#: example_parentchild.xml:262 +#, no-c-format +msgid "" +"There is quite a bit to digest here and it might look confusing first time " +"around. However, in practice, it all works out very nicely. Most Hibernate " +"applications use the parent / child pattern in many places." msgstr "" +"There is quite a bit to digest here and it might look confusing first time " +"around. However, in practice, it all works out very nicely. Most Hibernate " +"applications use the parent / child pattern in many places." -#: index.docbook:267 -msgid "We mentioned an alternative in the first paragraph. None of the above issues exist in the case of <literal><composite-element></literal> mappings, which have exactly the semantics of a parent / child relationship. Unfortunately, there are two big limitations to composite element classes: composite elements may not own collections, and they should not be the child of any entity other than the unique parent." +#. Tag: para +#: example_parentchild.xml:267 +#, no-c-format +msgid "" +"We mentioned an alternative in the first paragraph. None of the above issues " +"exist in the case of <literal><composite-element></literal> mappings, " +"which have exactly the semantics of a parent / child relationship. " +"Unfortunately, there are two big limitations to composite element classes: " +"composite elements may not own collections, and they should not be the child " +"of any entity other than the unique parent." msgstr "" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "" - +"We mentioned an alternative in the first paragraph. None of the above issues " +"exist in the case of <literal><composite-element></literal> mappings, " +"which have exactly the semantics of a parent / child relationship. " +"Unfortunately, there are two big limitations to composite element classes: " +"composite elements may not own collections, and they should not be the child " +"of any entity other than the unique parent." Modified: core/trunk/documentation/manual/translations/pt-BR/content/example_weblog.po =================================================================== --- core/trunk/documentation/manual/translations/pt-BR/content/example_weblog.po 2007-10-25 22:34:46 UTC (rev 14134) +++ core/trunk/documentation/manual/translations/pt-BR/content/example_weblog.po 2007-10-26 00:46:38 UTC (rev 14135) @@ -1,450 +1,484 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: example_weblog.xml:5 +#, no-c-format msgid "Example: Weblog Application" -msgstr "" +msgstr "Example: Weblog Application" -#: index.docbook:8 +#. Tag: title +#: example_weblog.xml:8 +#, no-c-format msgid "Persistent Classes" -msgstr "" +msgstr "Persistent Classes" -#: index.docbook:10 -msgid "The persistent classes represent a weblog, and an item posted in a weblog. They are to be modelled as a standard parent/child relationship, but we will use an ordered bag, instead of a set." +#. Tag: para +#: example_weblog.xml:10 +#, no-c-format +msgid "" +"The persistent classes represent a weblog, and an item posted in a weblog. " +"They are to be modelled as a standard parent/child relationship, but we will " +"use an ordered bag, instead of a set." msgstr "" +"The persistent classes represent a weblog, and an item posted in a weblog. " +"They are to be modelled as a standard parent/child relationship, but we will " +"use an ordered bag, instead of a set." -#: index.docbook:16 +#. Tag: programlisting +#: example_weblog.xml:16 +#, no-c-format msgid "" - "<![CDATA[package eg;\n" - "\n" - "import java.util.List;\n" - "\n" - "public class Blog {\n" - " private Long _id;\n" - " private String _name;\n" - " private List _items;\n" - "\n" - " public Long getId() {\n" - " return _id;\n" - " }\n" - " public List getItems() {\n" - " return _items;\n" - " }\n" - " public String getName() {\n" - " return _name;\n" - " }\n" - " public void setId(Long long1) {\n" - " _id = long1;\n" - " }\n" - " public void setItems(List list) {\n" - " _items = list;\n" - " }\n" - " public void setName(String string) {\n" - " _name = string;\n" - " }\n" - "}]]>" +"<![CDATA[package eg;\n" +"\n" +"import java.util.List;\n" +"\n" +"public class Blog {\n" +" private Long _id;\n" +" private String _name;\n" +" private List _items;\n" +"\n" +" public Long getId() {\n" +" return _id;\n" +" }\n" +" public List getItems() {\n" +" return _items;\n" +" }\n" +" public String getName() {\n" +" return _name;\n" +" }\n" +" public void setId(Long long1) {\n" +" _id = long1;\n" +" }\n" +" public void setItems(List list) {\n" +" _items = list;\n" +" }\n" +" public void setName(String string) {\n" +" _name = string;\n" +" }\n" +"}]]>" msgstr "" -#: index.docbook:18 +#. Tag: programlisting +#: example_weblog.xml:18 +#, no-c-format msgid "" - "<![CDATA[package eg;\n" - "\n" - "import java.text.DateFormat;\n" - "import java.util.Calendar;\n" - "\n" - "public class BlogItem {\n" - " private Long _id;\n" - " private Calendar _datetime;\n" - " private String _text;\n" - " private String _title;\n" - " private Blog _blog;\n" - "\n" - " public Blog getBlog() {\n" - " return _blog;\n" - " }\n" - " public Calendar getDatetime() {\n" - " return _datetime;\n" - " }\n" - " public Long getId() {\n" - " return _id;\n" - " }\n" - " public String getText() {\n" - " return _text;\n" - " }\n" - " public String getTitle() {\n" - " return _title;\n" - " }\n" - " public void setBlog(Blog blog) {\n" - " _blog = blog;\n" - " }\n" - " public void setDatetime(Calendar calendar) {\n" - " _datetime = calendar;\n" - " }\n" - " public void setId(Long long1) {\n" - " _id = long1;\n" - " }\n" - " public void setText(String string) {\n" - " _text = string;\n" - " }\n" - " public void setTitle(String string) {\n" - " _title = string;\n" - " }\n" - "}]]>" +"<![CDATA[package eg;\n" +"\n" +"import java.text.DateFormat;\n" +"import java.util.Calendar;\n" +"\n" +"public class BlogItem {\n" +" private Long _id;\n" +" private Calendar _datetime;\n" +" private String _text;\n" +" private String _title;\n" +" private Blog _blog;\n" +"\n" +" public Blog getBlog() {\n" +" return _blog;\n" +" }\n" +" public Calendar getDatetime() {\n" +" return _datetime;\n" +" }\n" +" public Long getId() {\n" +" return _id;\n" +" }\n" +" public String getText() {\n" +" return _text;\n" +" }\n" +" public String getTitle() {\n" +" return _title;\n" +" }\n" +" public void setBlog(Blog blog) {\n" +" _blog = blog;\n" +" }\n" +" public void setDatetime(Calendar calendar) {\n" +" _datetime = calendar;\n" +" }\n" +" public void setId(Long long1) {\n" +" _id = long1;\n" +" }\n" +" public void setText(String string) {\n" +" _text = string;\n" +" }\n" +" public void setTitle(String string) {\n" +" _title = string;\n" +" }\n" +"}]]>" msgstr "" -#: index.docbook:23 +#. Tag: title +#: example_weblog.xml:23 +#, no-c-format msgid "Hibernate Mappings" -msgstr "" +msgstr "Hibernate Mappings" -#: index.docbook:25 +#. Tag: para +#: example_weblog.xml:25 +#, no-c-format msgid "The XML mappings should now be quite straightforward." -msgstr "" +msgstr "The XML mappings should now be quite straightforward." -#: index.docbook:29 +#. Tag: programlisting +#: example_weblog.xml:29 +#, no-c-format msgid "" - "<![CDATA[<?xml version=\"1.0\"?>\n" - "<!DOCTYPE hibernate-mapping PUBLIC\n" - " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" - " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" - "\n" - "<hibernate-mapping package=\"eg\">\n" - "\n" - " <class\n" - " name=\"Blog\"\n" - " table=\"BLOGS\">\n" - "\n" - " <id\n" - " name=\"id\"\n" - " column=\"BLOG_ID\">\n" - "\n" - " <generator class=\"native\"/>\n" - "\n" - " </id>\n" - "\n" - " <property\n" - " name=\"name\"\n" - " column=\"NAME\"\n" - " not-null=\"true\"\n" - " unique=\"true\"/>\n" - "\n" - " <bag\n" - " name=\"items\"\n" - " inverse=\"true\"\n" - " order-by=\"DATE_TIME\"\n" - " cascade=\"all\">\n" - "\n" - " <key column=\"BLOG_ID\"/>\n" - " <one-to-many class=\"BlogItem\"/>\n" - "\n" - " </bag>\n" - "\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<?xml version=\"1.0\"?>\n" +"<!DOCTYPE hibernate-mapping PUBLIC\n" +" \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" +" \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" +"\n" +"<hibernate-mapping package=\"eg\">\n" +"\n" +" <class\n" +" name=\"Blog\"\n" +" table=\"BLOGS\">\n" +"\n" +" <id\n" +" name=\"id\"\n" +" column=\"BLOG_ID\">\n" +"\n" +" <generator class=\"native\"/>\n" +"\n" +" </id>\n" +"\n" +" <property\n" +" name=\"name\"\n" +" column=\"NAME\"\n" +" not-null=\"true\"\n" +" unique=\"true\"/>\n" +"\n" +" <bag\n" +" name=\"items\"\n" +" inverse=\"true\"\n" +" order-by=\"DATE_TIME\"\n" +" cascade=\"all\">\n" +"\n" +" <key column=\"BLOG_ID\"/>\n" +" <one-to-many class=\"BlogItem\"/>\n" +"\n" +" </bag>\n" +"\n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" -#: index.docbook:31 +#. Tag: programlisting +#: example_weblog.xml:31 +#, no-c-format msgid "" - "<![CDATA[<?xml version=\"1.0\"?>\n" - "<!DOCTYPE hibernate-mapping PUBLIC\n" - " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" - " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" - "\n" - "<hibernate-mapping package=\"eg\">\n" - "\n" - " <class\n" - " name=\"BlogItem\"\n" - " table=\"BLOG_ITEMS\"\n" - " dynamic-update=\"true\">\n" - "\n" - " <id\n" - " name=\"id\"\n" - " column=\"BLOG_ITEM_ID\">\n" - "\n" - " <generator class=\"native\"/>\n" - "\n" - " </id>\n" - "\n" - " <property\n" - " name=\"title\"\n" - " column=\"TITLE\"\n" - " not-null=\"true\"/>\n" - "\n" - " <property\n" - " name=\"text\"\n" - " column=\"TEXT\"\n" - " not-null=\"true\"/>\n" - "\n" - " <property\n" - " name=\"datetime\"\n" - " column=\"DATE_TIME\"\n" - " not-null=\"true\"/>\n" - "\n" - " <many-to-one\n" - " name=\"blog\"\n" - " column=\"BLOG_ID\"\n" - " not-null=\"true\"/>\n" - "\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<?xml version=\"1.0\"?>\n" +"<!DOCTYPE hibernate-mapping PUBLIC\n" +" \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" +" \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" +"\n" +"<hibernate-mapping package=\"eg\">\n" +"\n" +" <class\n" +" name=\"BlogItem\"\n" +" table=\"BLOG_ITEMS\"\n" +" dynamic-update=\"true\">\n" +"\n" +" <id\n" +" name=\"id\"\n" +" column=\"BLOG_ITEM_ID\">\n" +"\n" +" <generator class=\"native\"/>\n" +"\n" +" </id>\n" +"\n" +" <property\n" +" name=\"title\"\n" +" column=\"TITLE\"\n" +" not-null=\"true\"/>\n" +"\n" +" <property\n" +" name=\"text\"\n" +" column=\"TEXT\"\n" +" not-null=\"true\"/>\n" +"\n" +" <property\n" +" name=\"datetime\"\n" +" column=\"DATE_TIME\"\n" +" not-null=\"true\"/>\n" +"\n" +" <many-to-one\n" +" name=\"blog\"\n" +" column=\"BLOG_ID\"\n" +" not-null=\"true\"/>\n" +"\n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" -#: index.docbook:36 +#. Tag: title +#: example_weblog.xml:36 +#, no-c-format msgid "Hibernate Code" -msgstr "" +msgstr "Hibernate Code" -#: index.docbook:38 -msgid "The following class demonstrates some of the kinds of things we can do with these classes, using Hibernate." +#. Tag: para +#: example_weblog.xml:38 +#, no-c-format +msgid "" +"The following class demonstrates some of the kinds of things we can do with " +"these classes, using Hibernate." msgstr "" +"The following class demonstrates some of the kinds of things we can do with " +"these classes, using Hibernate." -#: index.docbook:43 +#. Tag: programlisting +#: example_weblog.xml:43 +#, no-c-format msgid "" - "<![CDATA[package eg;\n" - "\n" - "import java.util.ArrayList;\n" - "import java.util.Calendar;\n" - "import java.util.Iterator;\n" - "import java.util.List;\n" - "\n" - "import org.hibernate.HibernateException;\n" - "import org.hibernate.Query;\n" - "import org.hibernate.Session;\n" - "import org.hibernate.SessionFactory;\n" - "import org.hibernate.Transaction;\n" - "import org.hibernate.cfg.Configuration;\n" - "import org.hibernate.tool.hbm2ddl.SchemaExport;\n" - "\n" - "public class BlogMain {\n" - " \n" - " private SessionFactory _sessions;\n" - " \n" - " public void configure() throws HibernateException {\n" - " _sessions = new Configuration()\n" - " .addClass(Blog.class)\n" - " .addClass(BlogItem.class)\n" - " .buildSessionFactory();\n" - " }\n" - " \n" - " public void exportTables() throws HibernateException {\n" - " Configuration cfg = new Configuration()\n" - " .addClass(Blog.class)\n" - " .addClass(BlogItem.class);\n" - " new SchemaExport(cfg).create(true, true);\n" - " }\n" - " \n" - " public Blog createBlog(String name) throws HibernateException {\n" - " \n" - " Blog blog = new Blog();\n" - " blog.setName(name);\n" - " blog.setItems( new ArrayList() );\n" - " \n" - " Session session = _sessions.openSession();\n" - " Transaction tx = null;\n" - " try {\n" - " tx = session.beginTransaction();\n" - " session.persist(blog);\n" - " tx.commit();\n" - " }\n" - " catch (HibernateException he) {\n" - " if (tx!=null) tx.rollback();\n" - " throw he;\n" - " }\n" - " finally {\n" - " session.close();\n" - " }\n" - " return blog;\n" - " }\n" - " \n" - " public BlogItem createBlogItem(Blog blog, String title, String text)\n" - " throws HibernateException {\n" - " \n" - " BlogItem item = new BlogItem();\n" - " item.setTitle(title);\n" - " item.setText(text);\n" - " item.setBlog(blog);\n" - " item.setDatetime( Calendar.getInstance() );\n" - " blog.getItems().add(item);\n" - " \n" - " Session session = _sessions.openSession();\n" - " Transaction tx = null;\n" - " try {\n" - " tx = session.beginTransaction();\n" - " session.update(blog);\n" - " tx.commit();\n" - " }\n" - " catch (HibernateException he) {\n" - " if (tx!=null) tx.rollback();\n" - " throw he;\n" - " }\n" - " finally {\n" - " session.close();\n" - " }\n" - " return item;\n" - " }\n" - " \n" - " public BlogItem createBlogItem(Long blogid, String title, String text)\n" - " throws HibernateException {\n" - " \n" - " BlogItem item = new BlogItem();\n" - " item.setTitle(title);\n" - " item.setText(text);\n" - " item.setDatetime( Calendar.getInstance() );\n" - " \n" - " Session session = _sessions.openSession();\n" - " Transaction tx = null;\n" - " try {\n" - " tx = session.beginTransaction();\n" - " Blog blog = (Blog) session.load(Blog.class, blogid);\n" - " item.setBlog(blog);\n" - " blog.getItems().add(item);\n" - " tx.commit();\n" - " }\n" - " catch (HibernateException he) {\n" - " if (tx!=null) tx.rollback();\n" - " throw he;\n" - " }\n" - " finally {\n" - " session.close();\n" - " }\n" - " return item;\n" - " }\n" - " \n" - " public void updateBlogItem(BlogItem item, String text)\n" - " throws HibernateException {\n" - " \n" - " item.setText(text);\n" - " \n" - " Session session = _sessions.openSession();\n" - " Transaction tx = null;\n" - " try {\n" - " tx = session.beginTransaction();\n" - " session.update(item);\n" - " tx.commit();\n" - " }\n" - " catch (HibernateException he) {\n" - " if (tx!=null) tx.rollback();\n" - " throw he;\n" - " }\n" - " finally {\n" - " session.close();\n" - " }\n" - " }\n" - " \n" - " public void updateBlogItem(Long itemid, String text)\n" - " throws HibernateException {\n" - " \n" - " Session session = _sessions.openSession();\n" - " Transaction tx = null;\n" - " try {\n" - " tx = session.beginTransaction();\n" - " BlogItem item = (BlogItem) session.load(BlogItem.class, itemid);\n" - " item.setText(text);\n" - " tx.commit();\n" - " }\n" - " catch (HibernateException he) {\n" - " if (tx!=null) tx.rollback();\n" - " throw he;\n" - " }\n" - " finally {\n" - " session.close();\n" - " }\n" - " }\n" - " \n" - " public List listAllBlogNamesAndItemCounts(int max)\n" - " throws HibernateException {\n" - " \n" - " Session session = _sessions.openSession();\n" - " Transaction tx = null;\n" - " List result = null;\n" - " try {\n" - " tx = session.beginTransaction();\n" - " Query q = session.createQuery(\n" - " \"select blog.id, blog.name, count(blogItem) \" +\n" - " \"from Blog as blog \" +\n" - " \"left outer join blog.items as blogItem \" +\n" - " \"group by blog.name, blog.id \" +\n" - " \"order by max(blogItem.datetime)\"\n" - " );\n" - " q.setMaxResults(max);\n" - " result = q.list();\n" - " tx.commit();\n" - " }\n" - " catch (HibernateException he) {\n" - " if (tx!=null) tx.rollback();\n" - " throw he;\n" - " }\n" - " finally {\n" - " session.close();\n" - " }\n" - " return result;\n" - " }\n" - " \n" - " public Blog getBlogAndAllItems(Long blogid)\n" - " throws HibernateException {\n" - " \n" - " Session session = _sessions.openSession();\n" - " Transaction tx = null;\n" - " Blog blog = null;\n" - " try {\n" - " tx = session.beginTransaction();\n" - " Query q = session.createQuery(\n" - " \"from Blog as blog \" +\n" - " \"left outer join fetch blog.items \" +\n" - " \"where blog.id = :blogid\"\n" - " );\n" - " q.setParameter(\"blogid\", blogid);\n" - " blog = (Blog) q.uniqueResult();\n" - " tx.commit();\n" - " }\n" - " catch (HibernateException he) {\n" - " if (tx!=null) tx.rollback();\n" - " throw he;\n" - " }\n" - " finally {\n" - " session.close();\n" - " }\n" - " return blog;\n" - " }\n" - " \n" - " public List listBlogsAndRecentItems() throws HibernateException {\n" - " \n" - " Session session = _sessions.openSession();\n" - " Transaction tx = null;\n" - " List result = null;\n" - " try {\n" - " tx = session.beginTransaction();\n" - " Query q = session.createQuery(\n" - " \"from Blog as blog \" +\n" - " \"inner join blog.items as blogItem \" +\n" - " \"where blogItem.datetime > :minDate\"\n" - " );\n" - "\n" - " Calendar cal = Calendar.getInstance();\n" - " cal.roll(Calendar.MONTH, false);\n" - " q.setCalendar(\"minDate\", cal);\n" - " \n" - " result = q.list();\n" - " tx.commit();\n" - " }\n" - " catch (HibernateException he) {\n" - " if (tx!=null) tx.rollback();\n" - " throw he;\n" - " }\n" - " finally {\n" - " session.close();\n" - " }\n" - " return result;\n" - " }\n" - "}]]>" +"<![CDATA[package eg;\n" +"\n" +"import java.util.ArrayList;\n" +"import java.util.Calendar;\n" +"import java.util.Iterator;\n" +"import java.util.List;\n" +"\n" +"import org.hibernate.HibernateException;\n" +"import org.hibernate.Query;\n" +"import org.hibernate.Session;\n" +"import org.hibernate.SessionFactory;\n" +"import org.hibernate.Transaction;\n" +"import org.hibernate.cfg.Configuration;\n" +"import org.hibernate.tool.hbm2ddl.SchemaExport;\n" +"\n" +"public class BlogMain {\n" +" \n" +" private SessionFactory _sessions;\n" +" \n" +" public void configure() throws HibernateException {\n" +" _sessions = new Configuration()\n" +" .addClass(Blog.class)\n" +" .addClass(BlogItem.class)\n" +" .buildSessionFactory();\n" +" }\n" +" \n" +" public void exportTables() throws HibernateException {\n" +" Configuration cfg = new Configuration()\n" +" .addClass(Blog.class)\n" +" .addClass(BlogItem.class);\n" +" new SchemaExport(cfg).create(true, true);\n" +" }\n" +" \n" +" public Blog createBlog(String name) throws HibernateException {\n" +" \n" +" Blog blog = new Blog();\n" +" blog.setName(name);\n" +" blog.setItems( new ArrayList() );\n" +" \n" +" Session session = _sessions.openSession();\n" +" Transaction tx = null;\n" +" try {\n" +" tx = session.beginTransaction();\n" +" session.persist(blog);\n" +" tx.commit();\n" +" }\n" +" catch (HibernateException he) {\n" +" if (tx!=null) tx.rollback();\n" +" throw he;\n" +" }\n" +" finally {\n" +" session.close();\n" +" }\n" +" return blog;\n" +" }\n" +" \n" +" public BlogItem createBlogItem(Blog blog, String title, String text)\n" +" throws HibernateException {\n" +" \n" +" BlogItem item = new BlogItem();\n" +" item.setTitle(title);\n" +" item.setText(text);\n" +" item.setBlog(blog);\n" +" item.setDatetime( Calendar.getInstance() );\n" +" blog.getItems().add(item);\n" +" \n" +" Session session = _sessions.openSession();\n" +" Transaction tx = null;\n" +" try {\n" +" tx = session.beginTransaction();\n" +" session.update(blog);\n" +" tx.commit();\n" +" }\n" +" catch (HibernateException he) {\n" +" if (tx!=null) tx.rollback();\n" +" throw he;\n" +" }\n" +" finally {\n" +" session.close();\n" +" }\n" +" return item;\n" +" }\n" +" \n" +" public BlogItem createBlogItem(Long blogid, String title, String text)\n" +" throws HibernateException {\n" +" \n" +" BlogItem item = new BlogItem();\n" +" item.setTitle(title);\n" +" item.setText(text);\n" +" item.setDatetime( Calendar.getInstance() );\n" +" \n" +" Session session = _sessions.openSession();\n" +" Transaction tx = null;\n" +" try {\n" +" tx = session.beginTransaction();\n" +" Blog blog = (Blog) session.load(Blog.class, blogid);\n" +" item.setBlog(blog);\n" +" blog.getItems().add(item);\n" +" tx.commit();\n" +" }\n" +" catch (HibernateException he) {\n" +" if (tx!=null) tx.rollback();\n" +" throw he;\n" +" }\n" +" finally {\n" +" session.close();\n" +" }\n" +" return item;\n" +" }\n" +" \n" +" public void updateBlogItem(BlogItem item, String text)\n" +" throws HibernateException {\n" +" \n" +" item.setText(text);\n" +" \n" +" Session session = _sessions.openSession();\n" +" Transaction tx = null;\n" +" try {\n" +" tx = session.beginTransaction();\n" +" session.update(item);\n" +" tx.commit();\n" +" }\n" +" catch (HibernateException he) {\n" +" if (tx!=null) tx.rollback();\n" +" throw he;\n" +" }\n" +" finally {\n" +" session.close();\n" +" }\n" +" }\n" +" \n" +" public void updateBlogItem(Long itemid, String text)\n" +" throws HibernateException {\n" +" \n" +" Session session = _sessions.openSession();\n" +" Transaction tx = null;\n" +" try {\n" +" tx = session.beginTransaction();\n" +" BlogItem item = (BlogItem) session.load(BlogItem.class, " +"itemid);\n" +" item.setText(text);\n" +" tx.commit();\n" +" }\n" +" catch (HibernateException he) {\n" +" if (tx!=null) tx.rollback();\n" +" throw he;\n" +" }\n" +" finally {\n" +" session.close();\n" +" }\n" +" }\n" +" \n" +" public List listAllBlogNamesAndItemCounts(int max)\n" +" throws HibernateException {\n" +" \n" +" Session session = _sessions.openSession();\n" +" Transaction tx = null;\n" +" List result = null;\n" +" try {\n" +" tx = session.beginTransaction();\n" +" Query q = session.createQuery(\n" +" \"select blog.id, blog.name, count(blogItem) \" +\n" +" \"from Blog as blog \" +\n" +" \"left outer join blog.items as blogItem \" +\n" +" \"group by blog.name, blog.id \" +\n" +" \"order by max(blogItem.datetime)\"\n" +" );\n" +" q.setMaxResults(max);\n" +" result = q.list();\n" +" tx.commit();\n" +" }\n" +" catch (HibernateException he) {\n" +" if (tx!=null) tx.rollback();\n" +" throw he;\n" +" }\n" +" finally {\n" +" session.close();\n" +" }\n" +" return result;\n" +" }\n" +" \n" +" public Blog getBlogAndAllItems(Long blogid)\n" +" throws HibernateException {\n" +" \n" +" Session session = _sessions.openSession();\n" +" Transaction tx = null;\n" +" Blog blog = null;\n" +" try {\n" +" tx = session.beginTransaction();\n" +" Query q = session.createQuery(\n" +" \"from Blog as blog \" +\n" +" \"left outer join fetch blog.items \" +\n" +" \"where blog.id = :blogid\"\n" +" );\n" +" q.setParameter(\"blogid\", blogid);\n" +" blog = (Blog) q.uniqueResult();\n" +" tx.commit();\n" +" }\n" +" catch (HibernateException he) {\n" +" if (tx!=null) tx.rollback();\n" +" throw he;\n" +" }\n" +" finally {\n" +" session.close();\n" +" }\n" +" return blog;\n" +" }\n" +" \n" +" public List listBlogsAndRecentItems() throws HibernateException {\n" +" \n" +" Session session = _sessions.openSession();\n" +" Transaction tx = null;\n" +" List result = null;\n" +" try {\n" +" tx = session.beginTransaction();\n" +" Query q = session.createQuery(\n" +" \"from Blog as blog \" +\n" +" \"inner join blog.items as blogItem \" +\n" +" \"where blogItem.datetime > :minDate\"\n" +" );\n" +"\n" +" Calendar cal = Calendar.getInstance();\n" +" cal.roll(Calendar.MONTH, false);\n" +" q.setCalendar(\"minDate\", cal);\n" +" \n" +" result = q.list();\n" +" tx.commit();\n" +" }\n" +" catch (HibernateException he) {\n" +" if (tx!=null) tx.rollback();\n" +" throw he;\n" +" }\n" +" finally {\n" +" session.close();\n" +" }\n" +" return result;\n" +" }\n" +"}]]>" msgstr "" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "" - Modified: core/trunk/documentation/manual/translations/pt-BR/content/filters.po =================================================================== --- core/trunk/documentation/manual/translations/pt-BR/content/filters.po 2007-10-25 22:34:46 UTC (rev 14134) +++ core/trunk/documentation/manual/translations/pt-BR/content/filters.po 2007-10-26 00:46:38 UTC (rev 14135) @@ -1,149 +1,290 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: filters.xml:5 +#, no-c-format msgid "Filtering data" -msgstr "" +msgstr "Filtrando dados" -#: index.docbook:7 -msgid "Hibernate3 provides an innovative new approach to handling data with \"visibility\" rules. A <emphasis>Hibernate filter</emphasis> is a global, named, parameterized filter that may be enabled or disabled for a particular Hibernate session." +#. Tag: para +#: filters.xml:7 +#, no-c-format +msgid "" +"Hibernate3 provides an innovative new approach to handling data with " +"\"visibility\" rules. A <emphasis>Hibernate filter</emphasis> is a global, " +"named, parameterized filter that may be enabled or disabled for a particular " +"Hibernate session." msgstr "" +"O Hibernate3 provê um novo método inovador para manusear dados com regras de " +"\"visibilidade\". Um <emphasis>Filtro do Hibernate</emphasis> é um filtro " +"global, nomeado e parametrizado que pode se habilitado ou não dentro de um " +"Session do Hibernate." -#: index.docbook:14 +#. Tag: title +#: filters.xml:14 +#, no-c-format msgid "Hibernate filters" -msgstr "" +msgstr "Filtros do Hibernate" -#: index.docbook:16 -msgid "Hibernate3 adds the ability to pre-define filter criteria and attach those filters at both a class and a collection level. A filter criteria is the ability to define a restriction clause very similiar to the existing \"where\" attribute available on the class and various collection elements. Except these filter conditions can be parameterized. The application can then make the decision at runtime whether given filters should be enabled and what their parameter values should be. Filters can be used like database views, but parameterized inside the application." +#. Tag: para +#: filters.xml:16 +#, no-c-format +msgid "" +"Hibernate3 adds the ability to pre-define filter criteria and attach those " +"filters at both a class and a collection level. A filter criteria is the " +"ability to define a restriction clause very similiar to the existing \"where" +"\" attribute available on the class and various collection elements. Except " +"these filter conditions can be parameterized. The application can then make " +"the decision at runtime whether given filters should be enabled and what " +"their parameter values should be. Filters can be used like database views, " +"but parameterized inside the application." msgstr "" +"O Hibernate tem a habilidade de pré definir os critérios do filtro e anexar " +"esses filtros no nível da classe e no nível da coleção. Um critério do " +"filtro é a habilidade de definir uma cláusula restritiva muito semelhante ao " +"atributo \"where\" disponível para a classe e várias coleções. A não ser que " +"essas condições de filtros podem ser parametrizadas. A aplicação pode, " +"então, fazer uma decisão em tempo de execução se os filtros definidos devem " +"estar habilitados e quais valores seus parâmetros devem ter. Os filtros " +"podem ser usados como Views de bancos de dados, mas com parametros internos " +"à aplicação." -#: index.docbook:26 -msgid "In order to use filters, they must first be defined and then attached to the appropriate mapping elements. To define a filter, use the <literal><filter-def/></literal> element within a <literal><hibernate-mapping/></literal> element:" +#. Tag: para +#: filters.xml:26 +#, no-c-format +msgid "" +"In order to use filters, they must first be defined and then attached to the " +"appropriate mapping elements. To define a filter, use the <literal><" +"filter-def/></literal> element within a <literal><hibernate-mapping/" +"></literal> element:" msgstr "" +"Para usar esses filtros, eles primeiramente devem ser definidos e anexados " +"aos elementos do mapeamento apropriados. Para definir um filtro, use o " +"elemento <literal><filter-def/></literal> dentro do elemento " +"<literal><hibernate-mapping/></literal>:" -#: index.docbook:32 +#. Tag: programlisting +#: filters.xml:32 +#, no-c-format msgid "" - "<![CDATA[<filter-def name=\"myFilter\">\n" - " <filter-param name=\"myFilterParam\" type=\"string\"/>\n" - "</filter-def>]]>" +"<![CDATA[<filter-def name=\"myFilter\">\n" +" <filter-param name=\"myFilterParam\" type=\"string\"/>\n" +"</filter-def>]]>" msgstr "" -#: index.docbook:34 +#. Tag: para +#: filters.xml:34 +#, no-c-format msgid "Then, this filter can be attached to a class:" -msgstr "" +msgstr "Então esse filtro pode ser anexo à uma classe:" -#: index.docbook:38 +#. Tag: programlisting +#: filters.xml:38 +#, no-c-format msgid "" - "<![CDATA[<class name=\"myClass\" ...>\n" - " ...\n" - " <filter name=\"myFilter\" condition=\":myFilterParam = MY_FILTERED_COLUMN\"/>\n" - "</class>]]>" +"<![CDATA[<class name=\"myClass\" ...>\n" +" ...\n" +" <filter name=\"myFilter\" condition=\":myFilterParam = MY_FILTERED_COLUMN" +"\"/>\n" +"</class>]]>" msgstr "" -#: index.docbook:40 +#. Tag: para +#: filters.xml:40 +#, no-c-format msgid "or, to a collection:" -msgstr "" +msgstr "ou em uma coleção:" -#: index.docbook:44 +#. Tag: programlisting +#: filters.xml:44 +#, no-c-format msgid "" - "<![CDATA[<set ...>\n" - " <filter name=\"myFilter\" condition=\":myFilterParam = MY_FILTERED_COLUMN\"/>\n" - "</set>]]>" +"<![CDATA[<set ...>\n" +" <filter name=\"myFilter\" condition=\":myFilterParam = MY_FILTERED_COLUMN" +"\"/>\n" +"</set>]]>" msgstr "" -#: index.docbook:46 +#. Tag: para +#: filters.xml:46 +#, no-c-format msgid "or, even to both (or multiples of each) at the same time." -msgstr "" +msgstr "ou mesmo para ambos (ou muitos de cada) ao mesmo tempo." -#: index.docbook:50 -msgid "The methods on <literal>Session</literal> are: <literal>enableFilter(String filterName)</literal>, <literal>getEnabledFilter(String filterName)</literal>, and <literal>disableFilter(String filterName)</literal>. By default, filters are <emphasis>not</emphasis> enabled for a given session; they must be explcitly enabled through use of the <literal>Session.enabledFilter()</literal> method, which returns an instance of the <literal>Filter</literal> interface. Using the simple filter defined above, this would look like:" +#. Tag: para +#: filters.xml:50 +#, no-c-format +msgid "" +"The methods on <literal>Session</literal> are: <literal>enableFilter(String " +"filterName)</literal>, <literal>getEnabledFilter(String filterName)</" +"literal>, and <literal>disableFilter(String filterName)</literal>. By " +"default, filters are <emphasis>not</emphasis> enabled for a given session; " +"they must be explcitly enabled through use of the <literal>Session." +"enabledFilter()</literal> method, which returns an instance of the " +"<literal>Filter</literal> interface. Using the simple filter defined above, " +"this would look like:" msgstr "" +"Os métodos na <literal>Session</literal> são: <literal>enableFilter(String " +"filterName)</literal>, <literal>getEnabledFilter(String filterName)</" +"literal>, e <literal>disableFilter(String filterName)</literal>. Por padrão, " +"os filtros não são habilitados dentro de qualquer session; Eles devem ser " +"explicitamente habilitados usando o método <literal>Session.enabledFilter()</" +"literal>, que retorna uma instância da interface <literal>Filter</literal>. " +"Usando o filtro simples definido acima, o código se pareceria com o seguinte:" -#: index.docbook:59 -msgid "<![CDATA[session.enableFilter(\"myFilter\").setParameter(\"myFilterParam\", \"some-value\");]]>" +#. Tag: programlisting +#: filters.xml:59 +#, no-c-format +msgid "" +"<![CDATA[session.enableFilter(\"myFilter\").setParameter(\"myFilterParam\", " +"\"some-value\");]]>" msgstr "" -#: index.docbook:61 -msgid "Note that methods on the org.hibernate.Filter interface do allow the method-chaining common to much of Hibernate." +#. Tag: para +#: filters.xml:61 +#, no-c-format +msgid "" +"Note that methods on the org.hibernate.Filter interface do allow the method-" +"chaining common to much of Hibernate." msgstr "" +"Veja que os métodos da interface org.hibernate.Filter permite o encadeamento " +"de funções, comum à maioria das funções do Hibernate." -#: index.docbook:65 -msgid "A full example, using temporal data with an effective record date pattern:" +#. Tag: para +#: filters.xml:65 +#, no-c-format +msgid "" +"A full example, using temporal data with an effective record date pattern:" msgstr "" +"Um exemplo completo, usando dados temporais com um padrão efetivo de " +"registro de datas:" -#: index.docbook:69 +#. Tag: programlisting +#: filters.xml:69 +#, no-c-format msgid "" - "<![CDATA[<filter-def name=\"effectiveDate\">\n" - " <filter-param name=\"asOfDate\" type=\"date\"/>\n" - "</filter-def>\n" - "\n" - "<class name=\"Employee\" ...>\n" - "...\n" - " <many-to-one name=\"department\" column=\"dept_id\" class=\"Department\"/>\n" - " <property name=\"effectiveStartDate\" type=\"date\" column=\"eff_start_dt\"/>\n" - " <property name=\"effectiveEndDate\" type=\"date\" column=\"eff_end_dt\"/>\n" - "...\n" - " \n" - " <filter name=\"effectiveDate\"\n" - " condition=\":asOfDate BETWEEN eff_start_dt and eff_end_dt\"/>\n" - "</class>\n" - "\n" - "<class name=\"Department\" ...>\n" - "...\n" - " <set name=\"employees\" lazy=\"true\">\n" - " <key column=\"dept_id\"/>\n" - " <one-to-many class=\"Employee\"/>\n" - " <filter name=\"effectiveDate\"\n" - " condition=\":asOfDate BETWEEN eff_start_dt and eff_end_dt\"/>\n" - " </set>\n" - "</class>]]>" +"<![CDATA[<filter-def name=\"effectiveDate\">\n" +" <filter-param name=\"asOfDate\" type=\"date\"/>\n" +"</filter-def>\n" +"\n" +"<class name=\"Employee\" ...>\n" +"...\n" +" <many-to-one name=\"department\" column=\"dept_id\" class=\"Department\"/" +">\n" +" <property name=\"effectiveStartDate\" type=\"date\" column=\"eff_start_dt" +"\"/>\n" +" <property name=\"effectiveEndDate\" type=\"date\" column=\"eff_end_dt\"/" +">\n" +"...\n" +" \n" +" <filter name=\"effectiveDate\"\n" +" condition=\":asOfDate BETWEEN eff_start_dt and eff_end_dt\"/>\n" +"</class>\n" +"\n" +"<class name=\"Department\" ...>\n" +"...\n" +" <set name=\"employees\" lazy=\"true\">\n" +" <key column=\"dept_id\"/>\n" +" <one-to-many class=\"Employee\"/>\n" +" <filter name=\"effectiveDate\"\n" +" condition=\":asOfDate BETWEEN eff_start_dt and eff_end_dt\"/" +">\n" +" </set>\n" +"</class>]]>" msgstr "" -#: index.docbook:71 -msgid "Then, in order to ensure that you always get back currently effective records, simply enable the filter on the session prior to retrieving employee data:" +#. Tag: para +#: filters.xml:71 +#, no-c-format +msgid "" +"Then, in order to ensure that you always get back currently effective " +"records, simply enable the filter on the session prior to retrieving " +"employee data:" msgstr "" +"Para garantir que você sempre tenha registro efetivos, simplesmente habilite " +"o filtro na session antes de recuperar os dados dos empregados:" -#: index.docbook:76 +#. Tag: programlisting +#: filters.xml:76 +#, no-c-format msgid "" - "<![CDATA[Session session = ...;\n" - "session.enabledFilter(\"effectiveDate\").setParameter(\"asOfDate\", new Date());\n" - "List results = session.createQuery(\"from Employee as e where e.salary > :targetSalary\")\n" - " .setLong(\"targetSalary\", new Long(1000000))\n" - " .list();\n" - "]]>" +"<![CDATA[Session session = ...;\n" +"session.enabledFilter(\"effectiveDate\").setParameter(\"asOfDate\", new Date" +"());\n" +"List results = session.createQuery(\"from Employee as e where e.salary > :" +"targetSalary\")\n" +" .setLong(\"targetSalary\", new Long(1000000))\n" +" .list();\n" +"]]>" msgstr "" -#: index.docbook:78 -msgid "In the HQL above, even though we only explicitly mentioned a salary constraint on the results, because of the enabled filter the query will return only currently active employees who have a salary greater than a million dollars." +#. Tag: para +#: filters.xml:78 +#, no-c-format +msgid "" +"In the HQL above, even though we only explicitly mentioned a salary " +"constraint on the results, because of the enabled filter the query will " +"return only currently active employees who have a salary greater than a " +"million dollars." msgstr "" +"No HQL acima, mesmo que mencionamos apenas uma restrição de salário nos " +"resultados, por causa do filtro habilitado, a consulta retornará apenas os " +"funcionários ativos cujo salário é maior que um milhão de dólares." -#: index.docbook:84 -msgid "Note: if you plan on using filters with outer joining (either through HQL or load fetching) be careful of the direction of the condition expression. Its safest to set this up for left outer joining; in general, place the parameter first followed by the column name(s) after the operator." +#. Tag: para +#: filters.xml:84 +#, no-c-format +msgid "" +"Note: if you plan on using filters with outer joining (either through HQL or " +"load fetching) be careful of the direction of the condition expression. Its " +"safest to set this up for left outer joining; in general, place the " +"parameter first followed by the column name(s) after the operator." msgstr "" +"Nota: se você planeja usar filtros com outer join (por HQL ou por load " +"fetching) seja cuidadoso na direção da expressão de condição. É mais seguro " +"configura-lo com para um left outer join; geralmente, coloque o parâmetro " +"primeiro seguido pelo nome da coluna após o operador." -#: index.docbook:91 -msgid "After being defined a filter might be attached to multiple entities and/or collections each with its own condition. That can be tedious when the conditions are the same each time. Thus <literal><filter-def/></literal> allows defining a default condition, either as an attribute or CDATA:" -msgstr "" +#. Tag: para +#: filters.xml:91 +#, no-c-format +msgid "" +"After being defined a filter might be attached to multiple entities and/or " +"collections each with its own condition. That can be tedious when the " +"conditions are the same each time. Thus <literal><filter-def/></" +"literal> allows defining a default condition, either as an attribute or " +"CDATA:" +msgstr "translator-credits" -#: index.docbook:98 +#. Tag: programlisting +#: filters.xml:98 +#, no-c-format msgid "" - "<![CDATA[<filter-def name=\"myFilter\" condition=\"abc > xyz\">...</filter-def>\n" - "<filter-def name=\"myOtherFilter\">abc=xyz</filter-def>]]>" +"<![CDATA[<filter-def name=\"myFilter\" condition=\"abc > xyz\">...</filter-" +"def>\n" +"<filter-def name=\"myOtherFilter\">abc=xyz</filter-def>]]>" msgstr "" -#: index.docbook:100 -msgid "This default condition will then be used whenever the filter is attached to something without specifying a condition. Note that this means you can give a specific condition as part of the attachment of the filter which overrides the default condition in that particular case." +#. Tag: para +#: filters.xml:100 +#, no-c-format +msgid "" +"This default condition will then be used whenever the filter is attached to " +"something without specifying a condition. Note that this means you can give " +"a specific condition as part of the attachment of the filter which overrides " +"the default condition in that particular case." msgstr "" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "" - Modified: core/trunk/documentation/manual/translations/pt-BR/content/inheritance_mapping.po =================================================================== --- core/trunk/documentation/manual/translations/pt-BR/content/inheritance_mapping.po 2007-10-25 22:34:46 UTC (rev 14134) +++ core/trunk/documentation/manual/translations/pt-BR/content/inheritance_mapping.po 2007-10-26 00:46:38 UTC (rev 14135) @@ -1,477 +1,851 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: inheritance_mapping.xml:5 +#, no-c-format msgid "Inheritance Mapping" -msgstr "" +msgstr "Mapeamento de Herança" -#: index.docbook:8 +#. Tag: title +#: inheritance_mapping.xml:8 +#, no-c-format msgid "The Three Strategies" -msgstr "" +msgstr "As três estratégias" -#: index.docbook:10 +#. Tag: para +#: inheritance_mapping.xml:10 +#, no-c-format msgid "Hibernate supports the three basic inheritance mapping strategies:" msgstr "" +"O Hibernate suporta as três estratégias básicas de mapeamento de herança:" -#: index.docbook:16 +#. Tag: para +#: inheritance_mapping.xml:16 +#, no-c-format msgid "table per class hierarchy" -msgstr "" +msgstr "tabela por hierarquia de classes" -#: index.docbook:21 +#. Tag: para +#: inheritance_mapping.xml:21 +#, fuzzy, no-c-format msgid "<para>table per subclass</para>" msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"tabela por subclasse\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"table per subclass" -#: index.docbook:26 +#. Tag: para +#: inheritance_mapping.xml:26 +#, no-c-format msgid "table per concrete class" -msgstr "" +msgstr "tabela por classe concreta" -#: index.docbook:32 -msgid "In addition, Hibernate supports a fourth, slightly different kind of polymorphism:" +#. Tag: para +#: inheritance_mapping.xml:32 +#, no-c-format +msgid "" +"In addition, Hibernate supports a fourth, slightly different kind of " +"polymorphism:" msgstr "" +"Adicionalmente, o Hibernate suporta uma quarta, um tipo levemente diferente " +"de polimorfismo:" -#: index.docbook:39 +#. Tag: para +#: inheritance_mapping.xml:39 +#, no-c-format msgid "implicit polymorphism" -msgstr "" +msgstr "polimorfismo implícito" -#: index.docbook:45 -msgid "It is possible to use different mapping strategies for different branches of the same inheritance hierarchy, and then make use of implicit polymorphism to achieve polymorphism across the whole hierarchy. However, Hibernate does not support mixing <literal><subclass></literal>, and <literal><joined-subclass></literal> and <literal><union-subclass></literal> mappings under the same root <literal><class></literal> element. It is possible to mix together the table per hierarchy and table per subclass strategies, under the the same <literal><class></literal> element, by combining the <literal><subclass></literal> and <literal><join></literal> elements (see below)." +#. Tag: para +#: inheritance_mapping.xml:45 +#, no-c-format +msgid "" +"It is possible to use different mapping strategies for different branches of " +"the same inheritance hierarchy, and then make use of implicit polymorphism " +"to achieve polymorphism across the whole hierarchy. However, Hibernate does " +"not support mixing <literal><subclass></literal>, and <literal><" +"joined-subclass></literal> and <literal><union-subclass></literal> " +"mappings under the same root <literal><class></literal> element. It is " +"possible to mix together the table per hierarchy and table per subclass " +"strategies, under the the same <literal><class></literal> element, by " +"combining the <literal><subclass></literal> and <literal><join></" +"literal> elements (see below)." msgstr "" +"É possível usar diferentes estratégias de mapeamento para diferentes " +"ramificações da mesma hierarquia de herança, e então fazer uso do " +"polimorfismo implícito para alcançar polimorfismo através da hierarquia " +"completa. De qualquer forma, O Hibernate não suporta a mistura de " +"mapeamentos <literal><subclass></literal>, and <literal><joined-" +"subclass></literal> e <literal><union-subclass></literal> dentro do " +"mesmo elemento raiz <literal><class></literal>. É possível usar junto " +"às estratégias tabela por hierarquia e a tabela por subclasse, abaixo do " +"mesmo elemento <literal><class></literal>, combinando os elementos " +"<literal><subclass></literal> e <literal><join></literal> (veja " +"abaixo)." -#: index.docbook:59 -msgid "It is possible to define <literal>subclass</literal>, <literal>union-subclass</literal>, and <literal>joined-subclass</literal> mappings in separate mapping documents, directly beneath <literal>hibernate-mapping</literal>. This allows you to extend a class hierachy just by adding a new mapping file. You must specify an <literal>extends</literal> attribute in the subclass mapping, naming a previously mapped superclass. Note: Previously this feature made the ordering of the mapping documents important. Since Hibernate3, the ordering of mapping files does not matter when using the extends keyword. The ordering inside a single mapping file still needs to be defined as superclasses before subclasses." +#. Tag: para +#: inheritance_mapping.xml:59 +#, no-c-format +msgid "" +"It is possible to define <literal>subclass</literal>, <literal>union-" +"subclass</literal>, and <literal>joined-subclass</literal> mappings in " +"separate mapping documents, directly beneath <literal>hibernate-mapping</" +"literal>. This allows you to extend a class hierachy just by adding a new " +"mapping file. You must specify an <literal>extends</literal> attribute in " +"the subclass mapping, naming a previously mapped superclass. Note: " +"Previously this feature made the ordering of the mapping documents " +"important. Since Hibernate3, the ordering of mapping files does not matter " +"when using the extends keyword. The ordering inside a single mapping file " +"still needs to be defined as superclasses before subclasses." msgstr "" +"É possível definir mapeamentos <literal>subclass</literal>, <literal>union-" +"subclass</literal>, e <literal>joined-subclass</literal> em documentos de " +"mapeamento separados, diretamente abaixo de <literal>hibernate-mapping</" +"literal>. Isso permite a você estender uma hierarquia de classes apenas " +"adicionando um novo arquivo de mapeamento. Você deve especificar um atributo " +"<literal>extends</literal> no mapeamento da subclasse, nomeando uma " +"superclasse previamente mapeada. Nota: Anteriormente esta característica " +"fazia o ordenamento dos documentos de mapeamento importantes. Desde o " +"Hibernate3, o ordenamento dos arquivos de mapeamento não importa quando " +"usamos a palavra chave extends. O ordenamento dentro de um arquivo de " +"mapeamento simples ainda necessita ser definido como superclasse antes de " +"subclasse." -#: index.docbook:70 +#. Tag: programlisting +#: inheritance_mapping.xml:70 +#, no-c-format msgid "" - "<![CDATA[\n" - " <hibernate-mapping>\n" - " <subclass name=\"DomesticCat\" extends=\"Cat\" discriminator-value=\"D\">\n" - " <property name=\"name\" type=\"string\"/>\n" - " </subclass>\n" - " </hibernate-mapping>]]>" +"<![CDATA[\n" +" <hibernate-mapping>\n" +" <subclass name=\"DomesticCat\" extends=\"Cat\" discriminator-value=\"D" +"\">\n" +" <property name=\"name\" type=\"string\"/>\n" +" </subclass>\n" +" </hibernate-mapping>]]>" msgstr "" -#: index.docbook:74 +#. Tag: title +#: inheritance_mapping.xml:74 +#, no-c-format msgid "Table per class hierarchy" -msgstr "" +msgstr "Tabela por hierarquia de classes" -#: index.docbook:76 -msgid "Suppose we have an interface <literal>Payment</literal>, with implementors <literal>CreditCardPayment</literal>, <literal>CashPayment</literal>, <literal>ChequePayment</literal>. The table per hierarchy mapping would look like:" +#. Tag: para +#: inheritance_mapping.xml:76 +#, no-c-format +msgid "" +"Suppose we have an interface <literal>Payment</literal>, with implementors " +"<literal>CreditCardPayment</literal>, <literal>CashPayment</literal>, " +"<literal>ChequePayment</literal>. The table per hierarchy mapping would look " +"like:" msgstr "" +"Suponha que tenhamos uma interface <literal>Payment</literal>, com sua " +"implementação <literal>CreditCardPayment</literal>, <literal>CashPayment</" +"literal>, <literal>ChequePayment</literal>. O mapeamento da tabela por " +"hierarquia seria parecido com:" -#: index.docbook:83 +#. Tag: programlisting +#: inheritance_mapping.xml:83 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Payment\" table=\"PAYMENT\">\n" - " <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <discriminator column=\"PAYMENT_TYPE\" type=\"string\"/>\n" - " <property name=\"amount\" column=\"AMOUNT\"/>\n" - " ...\n" - " <subclass name=\"CreditCardPayment\" discriminator-value=\"CREDIT\">\n" - " <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" - " ...\n" - " </subclass>\n" - " <subclass name=\"CashPayment\" discriminator-value=\"CASH\">\n" - " ...\n" - " </subclass>\n" - " <subclass name=\"ChequePayment\" discriminator-value=\"CHEQUE\">\n" - " ...\n" - " </subclass>\n" - "</class>]]>" +"<![CDATA[<class name=\"Payment\" table=\"PAYMENT\">\n" +" <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <discriminator column=\"PAYMENT_TYPE\" type=\"string\"/>\n" +" <property name=\"amount\" column=\"AMOUNT\"/>\n" +" ...\n" +" <subclass name=\"CreditCardPayment\" discriminator-value=\"CREDIT\">\n" +" <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" +" ...\n" +" </subclass>\n" +" <subclass name=\"CashPayment\" discriminator-value=\"CASH\">\n" +" ...\n" +" </subclass>\n" +" <subclass name=\"ChequePayment\" discriminator-value=\"CHEQUE\">\n" +" ...\n" +" </subclass>\n" +"</class>]]>" msgstr "" -#: index.docbook:85 -msgid "Exactly one table is required. There is one big limitation of this mapping strategy: columns declared by the subclasses, such as <literal>CCTYPE</literal>, may not have <literal>NOT NULL</literal> constraints." +#. Tag: para +#: inheritance_mapping.xml:85 +#, no-c-format +msgid "" +"Exactly one table is required. There is one big limitation of this mapping " +"strategy: columns declared by the subclasses, such as <literal>CCTYPE</" +"literal>, may not have <literal>NOT NULL</literal> constraints." msgstr "" +"Exactly one table is required. There is one big limitation of this mapping " +"strategy: columns declared by the subclasses, such as <literal>CCTYPE</" +"literal>, may not have <literal>NOT NULL</literal> constraints." -#: index.docbook:94 +#. Tag: title +#: inheritance_mapping.xml:94 +#, no-c-format msgid "Table per subclass" -msgstr "" +msgstr "Tabela por subclasse" -#: index.docbook:96 +#. Tag: para +#: inheritance_mapping.xml:96 +#, no-c-format msgid "A table per subclass mapping would look like:" -msgstr "" +msgstr "Um mapeamento de tabela por subclasse seria parecido com:" -#: index.docbook:100 +#. Tag: programlisting +#: inheritance_mapping.xml:100 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Payment\" table=\"PAYMENT\">\n" - " <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"amount\" column=\"AMOUNT\"/>\n" - " ...\n" - " <joined-subclass name=\"CreditCardPayment\" table=\"CREDIT_PAYMENT\">\n" - " <key column=\"PAYMENT_ID\"/>\n" - " <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" - " ...\n" - " </joined-subclass>\n" - " <joined-subclass name=\"CashPayment\" table=\"CASH_PAYMENT\">\n" - " <key column=\"PAYMENT_ID\"/>\n" - " ...\n" - " </joined-subclass>\n" - " <joined-subclass name=\"ChequePayment\" table=\"CHEQUE_PAYMENT\">\n" - " <key column=\"PAYMENT_ID\"/>\n" - " ...\n" - " </joined-subclass>\n" - "</class>]]>" +"<![CDATA[<class name=\"Payment\" table=\"PAYMENT\">\n" +" <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <property name=\"amount\" column=\"AMOUNT\"/>\n" +" ...\n" +" <joined-subclass name=\"CreditCardPayment\" table=\"CREDIT_PAYMENT\">\n" +" <key column=\"PAYMENT_ID\"/>\n" +" <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" +" ...\n" +" </joined-subclass>\n" +" <joined-subclass name=\"CashPayment\" table=\"CASH_PAYMENT\">\n" +" <key column=\"PAYMENT_ID\"/>\n" +" ...\n" +" </joined-subclass>\n" +" <joined-subclass name=\"ChequePayment\" table=\"CHEQUE_PAYMENT\">\n" +" <key column=\"PAYMENT_ID\"/>\n" +" ...\n" +" </joined-subclass>\n" +"</class>]]>" msgstr "" -#: index.docbook:102 -msgid "Four tables are required. The three subclass tables have primary key associations to the superclass table (so the relational model is actually a one-to-one association)." +#. Tag: para +#: inheritance_mapping.xml:102 +#, no-c-format +msgid "" +"Four tables are required. The three subclass tables have primary key " +"associations to the superclass table (so the relational model is actually a " +"one-to-one association)." msgstr "" +"Quatro tabelas são necessárias. As três tabelas subclasses possuem " +"associação de chave primária para a tabela de superclasse (então o modelo " +"relacional é atualmente uma associação de um-para-um)." -#: index.docbook:111 +#. Tag: title +#: inheritance_mapping.xml:111 +#, no-c-format msgid "Table per subclass, using a discriminator" -msgstr "" +msgstr "Tabela por subclasse, usando um discriminador" -#: index.docbook:113 -msgid "Note that Hibernate's implementation of table per subclass requires no discriminator column. Other object/relational mappers use a different implementation of table per subclass which requires a type discriminator column in the superclass table. The approach taken by Hibernate is much more difficult to implement but arguably more correct from a relational point of view. If you would like to use a discriminator column with the table per subclass strategy, you may combine the use of <literal><subclass></literal> and <literal><join></literal>, as follow:" +#. Tag: para +#: inheritance_mapping.xml:113 +#, no-c-format +msgid "" +"Note that Hibernate's implementation of table per subclass requires no " +"discriminator column. Other object/relational mappers use a different " +"implementation of table per subclass which requires a type discriminator " +"column in the superclass table. The approach taken by Hibernate is much more " +"difficult to implement but arguably more correct from a relational point of " +"view. If you would like to use a discriminator column with the table per " +"subclass strategy, you may combine the use of <literal><subclass></" +"literal> and <literal><join></literal>, as follow:" msgstr "" +"Note que a implementação de tabela por subclasse do Hibernate não necessita " +"de coluna de discriminador. Outro mapeador objeto/relacional usa uma " +"implementação diferente de tabela por subclasse, que necessita uma coluna " +"com o tipo discriminador na tabela da superclasse. A abordagem escolhida " +"pelo Hibernate é muito mais difícil de implementar, porém de forma " +"argumentável mais correto de um ponto de vista relacional. Se você deseja " +"utilizar uma coluna discriminadora com a estratégia tabela por subclasse, " +"você pode combinar o uso de <literal><subclass></literal> e " +"<literal><join></literal>, dessa maneira:" -#: index.docbook:125 +#. Tag: programlisting +#: inheritance_mapping.xml:125 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Payment\" table=\"PAYMENT\">\n" - " <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <discriminator column=\"PAYMENT_TYPE\" type=\"string\"/>\n" - " <property name=\"amount\" column=\"AMOUNT\"/>\n" - " ...\n" - " <subclass name=\"CreditCardPayment\" discriminator-value=\"CREDIT\">\n" - " <join table=\"CREDIT_PAYMENT\">\n" - " <key column=\"PAYMENT_ID\"/>\n" - " <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" - " ...\n" - " </join>\n" - " </subclass>\n" - " <subclass name=\"CashPayment\" discriminator-value=\"CASH\">\n" - " <join table=\"CASH_PAYMENT\">\n" - " <key column=\"PAYMENT_ID\"/>\n" - " ...\n" - " </join>\n" - " </subclass>\n" - " <subclass name=\"ChequePayment\" discriminator-value=\"CHEQUE\">\n" - " <join table=\"CHEQUE_PAYMENT\" fetch=\"select\">\n" - " <key column=\"PAYMENT_ID\"/>\n" - " ...\n" - " </join>\n" - " </subclass>\n" - "</class>]]>" +"<![CDATA[<class name=\"Payment\" table=\"PAYMENT\">\n" +" <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <discriminator column=\"PAYMENT_TYPE\" type=\"string\"/>\n" +" <property name=\"amount\" column=\"AMOUNT\"/>\n" +" ...\n" +" <subclass name=\"CreditCardPayment\" discriminator-value=\"CREDIT\">\n" +" <join table=\"CREDIT_PAYMENT\">\n" +" <key column=\"PAYMENT_ID\"/>\n" +" <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" +" ...\n" +" </join>\n" +" </subclass>\n" +" <subclass name=\"CashPayment\" discriminator-value=\"CASH\">\n" +" <join table=\"CASH_PAYMENT\">\n" +" <key column=\"PAYMENT_ID\"/>\n" +" ...\n" +" </join>\n" +" </subclass>\n" +" <subclass name=\"ChequePayment\" discriminator-value=\"CHEQUE\">\n" +" <join table=\"CHEQUE_PAYMENT\" fetch=\"select\">\n" +" <key column=\"PAYMENT_ID\"/>\n" +" ...\n" +" </join>\n" +" </subclass>\n" +"</class>]]>" msgstr "" -#: index.docbook:127 -msgid "The optional <literal>fetch=\"select\"</literal> declaration tells Hibernate not to fetch the <literal>ChequePayment</literal> subclass data using an outer join when querying the superclass." +#. Tag: para +#: inheritance_mapping.xml:127 +#, no-c-format +msgid "" +"The optional <literal>fetch=\"select\"</literal> declaration tells Hibernate " +"not to fetch the <literal>ChequePayment</literal> subclass data using an " +"outer join when querying the superclass." msgstr "" +"The optional <literal>fetch=\"select\"</literal> declaration tells Hibernate " +"not to fetch the <literal>ChequePayment</literal> subclass data using an " +"outer join when querying the superclass. A declaração opcional " +"fetch=”select” diz ao Hibernate para não buscar os dados da subclasse " +"ChequePayment, quando usar um outer join pesquisando pela superclasse." -#: index.docbook:136 +#. Tag: title +#: inheritance_mapping.xml:136 +#, no-c-format msgid "Mixing table per class hierarchy with table per subclass" -msgstr "" +msgstr ". Misturando tabela por hierarquia de classes com tabela por subclasse" -#: index.docbook:138 -msgid "You may even mix the table per hierarchy and table per subclass strategies using this approach:" +#. Tag: para +#: inheritance_mapping.xml:138 +#, no-c-format +msgid "" +"You may even mix the table per hierarchy and table per subclass strategies " +"using this approach:" msgstr "" +"Você pode até mesmo misturar a estratégia de tabela por hierarquia e tabela " +"por subclasse usando esta abordagem:" -#: index.docbook:143 +#. Tag: programlisting +#: inheritance_mapping.xml:143 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Payment\" table=\"PAYMENT\">\n" - " <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <discriminator column=\"PAYMENT_TYPE\" type=\"string\"/>\n" - " <property name=\"amount\" column=\"AMOUNT\"/>\n" - " ...\n" - " <subclass name=\"CreditCardPayment\" discriminator-value=\"CREDIT\">\n" - " <join table=\"CREDIT_PAYMENT\">\n" - " <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" - " ...\n" - " </join>\n" - " </subclass>\n" - " <subclass name=\"CashPayment\" discriminator-value=\"CASH\">\n" - " ...\n" - " </subclass>\n" - " <subclass name=\"ChequePayment\" discriminator-value=\"CHEQUE\">\n" - " ...\n" - " </subclass>\n" - "</class>]]>" +"<![CDATA[<class name=\"Payment\" table=\"PAYMENT\">\n" +" <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <discriminator column=\"PAYMENT_TYPE\" type=\"string\"/>\n" +" <property name=\"amount\" column=\"AMOUNT\"/>\n" +" ...\n" +" <subclass name=\"CreditCardPayment\" discriminator-value=\"CREDIT\">\n" +" <join table=\"CREDIT_PAYMENT\">\n" +" <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" +" ...\n" +" </join>\n" +" </subclass>\n" +" <subclass name=\"CashPayment\" discriminator-value=\"CASH\">\n" +" ...\n" +" </subclass>\n" +" <subclass name=\"ChequePayment\" discriminator-value=\"CHEQUE\">\n" +" ...\n" +" </subclass>\n" +"</class>]]>" msgstr "" -#: index.docbook:145 -msgid "For any of these mapping strategies, a polymorphic association to the root <literal>Payment</literal> class is mapped using <literal><many-to-one></literal>." +#. Tag: para +#: inheritance_mapping.xml:145 +#, no-c-format +msgid "" +"For any of these mapping strategies, a polymorphic association to the root " +"<literal>Payment</literal> class is mapped using <literal><many-to-one>" +"</literal>." msgstr "" +"Para qualquer uma dessas estratégias de mapeamento, uma associação " +"polimórfica para a classe raiz <literal>Payment</literal> deve ser mapeada " +"usando <literal><many-to-one></literal>." -#: index.docbook:151 -msgid "<![CDATA[<many-to-one name=\"payment\" column=\"PAYMENT_ID\" class=\"Payment\"/>]]>" +#. Tag: programlisting +#: inheritance_mapping.xml:151 +#, no-c-format +msgid "" +"<![CDATA[<many-to-one name=\"payment\" column=\"PAYMENT_ID\" class=\"Payment" +"\"/>]]>" msgstr "" -#: index.docbook:156 +#. Tag: title +#: inheritance_mapping.xml:156 +#, no-c-format msgid "Table per concrete class" -msgstr "" +msgstr "Tabela por classe concreta" -#: index.docbook:158 -msgid "There are two ways we could go about mapping the table per concrete class strategy. The first is to use <literal><union-subclass></literal>." +#. Tag: para +#: inheritance_mapping.xml:158 +#, no-c-format +msgid "" +"There are two ways we could go about mapping the table per concrete class " +"strategy. The first is to use <literal><union-subclass></literal>." msgstr "" +"Existem duas formas que poderíamos usar a respeito da estratégia de " +"mapeamento de tabela por classe concreta. A primeira é usar <literal><" +"union-subclass></literal>.." -#: index.docbook:163 +#. Tag: programlisting +#: inheritance_mapping.xml:163 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Payment\">\n" - " <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <property name=\"amount\" column=\"AMOUNT\"/>\n" - " ...\n" - " <union-subclass name=\"CreditCardPayment\" table=\"CREDIT_PAYMENT\">\n" - " <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" - " ...\n" - " </union-subclass>\n" - " <union-subclass name=\"CashPayment\" table=\"CASH_PAYMENT\">\n" - " ...\n" - " </union-subclass>\n" - " <union-subclass name=\"ChequePayment\" table=\"CHEQUE_PAYMENT\">\n" - " ...\n" - " </union-subclass>\n" - "</class>]]>" +"<![CDATA[<class name=\"Payment\">\n" +" <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" +" <generator class=\"sequence\"/>\n" +" </id>\n" +" <property name=\"amount\" column=\"AMOUNT\"/>\n" +" ...\n" +" <union-subclass name=\"CreditCardPayment\" table=\"CREDIT_PAYMENT\">\n" +" <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" +" ...\n" +" </union-subclass>\n" +" <union-subclass name=\"CashPayment\" table=\"CASH_PAYMENT\">\n" +" ...\n" +" </union-subclass>\n" +" <union-subclass name=\"ChequePayment\" table=\"CHEQUE_PAYMENT\">\n" +" ...\n" +" </union-subclass>\n" +"</class>]]>" msgstr "" -#: index.docbook:165 -msgid "Three tables are involved for the subclasses. Each table defines columns for all properties of the class, including inherited properties." +#. Tag: para +#: inheritance_mapping.xml:165 +#, no-c-format +msgid "" +"Three tables are involved for the subclasses. Each table defines columns for " +"all properties of the class, including inherited properties." msgstr "" +"Três tabelas estão envolvidas para as subclasses. Cada tabela define colunas " +"para todas as propriedades da classe, incluindo propriedades herdadas." -#: index.docbook:170 -msgid "The limitation of this approach is that if a property is mapped on the superclass, the column name must be the same on all subclass tables. (We might relax this in a future release of Hibernate.) The identity generator strategy is not allowed in union subclass inheritance, indeed the primary key seed has to be shared accross all unioned subclasses of a hierarchy." +#. Tag: para +#: inheritance_mapping.xml:170 +#, no-c-format +msgid "" +"The limitation of this approach is that if a property is mapped on the " +"superclass, the column name must be the same on all subclass tables. (We " +"might relax this in a future release of Hibernate.) The identity generator " +"strategy is not allowed in union subclass inheritance, indeed the primary " +"key seed has to be shared accross all unioned subclasses of a hierarchy." msgstr "" +"A limitação dessa abordagem é que se uma propriedade é mapeada na " +"superclasse, o nome da coluna deve ser o mesmo em todas as tabelas das " +"subclasses. (Nós devemos melhorar isto em um futuro release do Hibernate). A " +"estratégia do gerador de identidade não é permitida em união de subclasses" +"(union-subclass) herdadas, na verdade a fonte de chave primária deve ser " +"compartilhada através de todas subclasses unidas da hierarquia." -#: index.docbook:179 -msgid "If your superclass is abstract, map it with <literal>abstract=\"true\"</literal>. Of course, if it is not abstract, an additional table (defaults to <literal>PAYMENT</literal> in the example above) is needed to hold instances of the superclass." +#. Tag: para +#: inheritance_mapping.xml:179 +#, no-c-format +msgid "" +"If your superclass is abstract, map it with <literal>abstract=\"true\"</" +"literal>. Of course, if it is not abstract, an additional table (defaults to " +"<literal>PAYMENT</literal> in the example above) is needed to hold instances " +"of the superclass." msgstr "" +"Se sua superclasse é abstrata, mapeie ela com <literal>abstract=\"true\"</" +"literal>. Claro, que se ela não for abstrata, uma tabela (padrão para " +"<literal>PAYMENT</literal> no exemplo acima) adicional é necessária para " +"segurar as instâncias da superclasse." -#: index.docbook:189 +#. Tag: title +#: inheritance_mapping.xml:189 +#, no-c-format msgid "Table per concrete class, using implicit polymorphism" -msgstr "" +msgstr "Tabela por classe concreta, usando polimorfismo implícito" -#: index.docbook:191 +#. Tag: para +#: inheritance_mapping.xml:191 +#, no-c-format msgid "An alternative approach is to make use of implicit polymorphism:" -msgstr "" +msgstr "Uma abordagem alternativa é fazer uso de polimorfismo implícito:" -#: index.docbook:195 +#. Tag: programlisting +#: inheritance_mapping.xml:195 +#, no-c-format msgid "" - "<![CDATA[<class name=\"CreditCardPayment\" table=\"CREDIT_PAYMENT\">\n" - " <id name=\"id\" type=\"long\" column=\"CREDIT_PAYMENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"amount\" column=\"CREDIT_AMOUNT\"/>\n" - " ...\n" - "</class>\n" - "\n" - "<class name=\"CashPayment\" table=\"CASH_PAYMENT\">\n" - " <id name=\"id\" type=\"long\" column=\"CASH_PAYMENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"amount\" column=\"CASH_AMOUNT\"/>\n" - " ...\n" - "</class>\n" - "\n" - "<class name=\"ChequePayment\" table=\"CHEQUE_PAYMENT\">\n" - " <id name=\"id\" type=\"long\" column=\"CHEQUE_PAYMENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"amount\" column=\"CHEQUE_AMOUNT\"/>\n" - " ...\n" - "</class>]]>" +"<![CDATA[<class name=\"CreditCardPayment\" table=\"CREDIT_PAYMENT\">\n" +" <id name=\"id\" type=\"long\" column=\"CREDIT_PAYMENT_ID\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <property name=\"amount\" column=\"CREDIT_AMOUNT\"/>\n" +" ...\n" +"</class>\n" +"\n" +"<class name=\"CashPayment\" table=\"CASH_PAYMENT\">\n" +" <id name=\"id\" type=\"long\" column=\"CASH_PAYMENT_ID\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <property name=\"amount\" column=\"CASH_AMOUNT\"/>\n" +" ...\n" +"</class>\n" +"\n" +"<class name=\"ChequePayment\" table=\"CHEQUE_PAYMENT\">\n" +" <id name=\"id\" type=\"long\" column=\"CHEQUE_PAYMENT_ID\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <property name=\"amount\" column=\"CHEQUE_AMOUNT\"/>\n" +" ...\n" +"</class>]]>" msgstr "" -#: index.docbook:197 -msgid "Notice that nowhere do we mention the <literal>Payment</literal> interface explicitly. Also notice that properties of <literal>Payment</literal> are mapped in each of the subclasses. If you want to avoid duplication, consider using XML entities (e.g. <literal>[ <!ENTITY allproperties SYSTEM \"allproperties.xml\"> ]</literal> in the <literal>DOCTYPE</literal> declartion and <literal>&allproperties;</literal> in the mapping)." +#. Tag: para +#: inheritance_mapping.xml:197 +#, no-c-format +msgid "" +"Notice that nowhere do we mention the <literal>Payment</literal> interface " +"explicitly. Also notice that properties of <literal>Payment</literal> are " +"mapped in each of the subclasses. If you want to avoid duplication, consider " +"using XML entities (e.g. <literal>[ <!ENTITY allproperties SYSTEM " +"\"allproperties.xml\"> ]</literal> in the <literal>DOCTYPE</literal> " +"declartion and <literal>&allproperties;</literal> in the mapping)." msgstr "" +"Veja que em nenhum lugar mencionamos a interface <literal>Payment</literal> " +"explicitamente. Também preste atenção que propriedades de <literal>Payment</" +"literal> são mapeadas em cada uma das subclasses. Se você quer evitar " +"duplicação, considere usar entidades de XML (ex. (e.g. <literal>[ <!" +"ENTITY allproperties SYSTEM \"allproperties.xml\"> ]</literal> na " +"declaração do <literal>DOCTYPE</literal> e <literal>&allproperties;</" +"literal> no mapeamento)." -#: index.docbook:207 -msgid "The disadvantage of this approach is that Hibernate does not generate SQL <literal>UNION</literal>s when performing polymorphic queries." +#. Tag: para +#: inheritance_mapping.xml:207 +#, no-c-format +msgid "" +"The disadvantage of this approach is that Hibernate does not generate SQL " +"<literal>UNION</literal>s when performing polymorphic queries." msgstr "" +"A desvantagem dessa abordagem é que o Hibernate não gera <literal>UNION</" +"literal>s SQL quando executa pesquisas polimórficas." -#: index.docbook:212 -msgid "For this mapping strategy, a polymorphic association to <literal>Payment</literal> is usually mapped using <literal><any></literal>." +#. Tag: para +#: inheritance_mapping.xml:212 +#, no-c-format +msgid "" +"For this mapping strategy, a polymorphic association to <literal>Payment</" +"literal> is usually mapped using <literal><any></literal>." msgstr "" +"Para essa estratégia, uma associação polimórfica para <literal>Payment</" +"literal> geralmente é mapeada usando <literal><any></literal>." -#: index.docbook:217 +#. Tag: programlisting +#: inheritance_mapping.xml:217 +#, no-c-format msgid "" - "<![CDATA[<any name=\"payment\" meta-type=\"string\" id-type=\"long\">\n" - " <meta-value value=\"CREDIT\" class=\"CreditCardPayment\"/>\n" - " <meta-value value=\"CASH\" class=\"CashPayment\"/>\n" - " <meta-value value=\"CHEQUE\" class=\"ChequePayment\"/>\n" - " <column name=\"PAYMENT_CLASS\"/>\n" - " <column name=\"PAYMENT_ID\"/>\n" - "</any>]]>" +"<![CDATA[<any name=\"payment\" meta-type=\"string\" id-type=\"long\">\n" +" <meta-value value=\"CREDIT\" class=\"CreditCardPayment\"/>\n" +" <meta-value value=\"CASH\" class=\"CashPayment\"/>\n" +" <meta-value value=\"CHEQUE\" class=\"ChequePayment\"/>\n" +" <column name=\"PAYMENT_CLASS\"/>\n" +" <column name=\"PAYMENT_ID\"/>\n" +"</any>]]>" msgstr "" -#: index.docbook:222 +#. Tag: title +#: inheritance_mapping.xml:222 +#, no-c-format msgid "Mixing implicit polymorphism with other inheritance mappings" -msgstr "" +msgstr "Misturando polimorfismo implícito com outros mapeamentos de herança" -#: index.docbook:224 -msgid "There is one further thing to notice about this mapping. Since the subclasses are each mapped in their own <literal><class></literal> element (and since <literal>Payment</literal> is just an interface), each of the subclasses could easily be part of another inheritance hierarchy! (And you can still use polymorphic queries against the <literal>Payment</literal> interface.)" +#. Tag: para +#: inheritance_mapping.xml:224 +#, no-c-format +msgid "" +"There is one further thing to notice about this mapping. Since the " +"subclasses are each mapped in their own <literal><class></literal> " +"element (and since <literal>Payment</literal> is just an interface), each of " +"the subclasses could easily be part of another inheritance hierarchy! (And " +"you can still use polymorphic queries against the <literal>Payment</literal> " +"interface.)" msgstr "" +"Ainda existe uma coisa para ser observada com respeito a este mapeamento. " +"Desde que as subclasses sejam mapeadas em seu próprio elemento <literal><" +"class></literal> (e desde que <literal>Payment</literal> seja apenas uma " +"interface), cada uma das subclasses pode ser facilmente parte de uma outra " +"hierarquia de herança! (E você ainda pode usar pesquisas polimórficas em " +"cima da interface <literal>Payment</literal>.)" -#: index.docbook:232 +#. Tag: programlisting +#: inheritance_mapping.xml:232 +#, no-c-format msgid "" - "<![CDATA[<class name=\"CreditCardPayment\" table=\"CREDIT_PAYMENT\">\n" - " <id name=\"id\" type=\"long\" column=\"CREDIT_PAYMENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <discriminator column=\"CREDIT_CARD\" type=\"string\"/>\n" - " <property name=\"amount\" column=\"CREDIT_AMOUNT\"/>\n" - " ...\n" - " <subclass name=\"MasterCardPayment\" discriminator-value=\"MDC\"/>\n" - " <subclass name=\"VisaPayment\" discriminator-value=\"VISA\"/>\n" - "</class>\n" - "\n" - "<class name=\"NonelectronicTransaction\" table=\"NONELECTRONIC_TXN\">\n" - " <id name=\"id\" type=\"long\" column=\"TXN_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " ...\n" - " <joined-subclass name=\"CashPayment\" table=\"CASH_PAYMENT\">\n" - " <key column=\"PAYMENT_ID\"/>\n" - " <property name=\"amount\" column=\"CASH_AMOUNT\"/>\n" - " ...\n" - " </joined-subclass>\n" - " <joined-subclass name=\"ChequePayment\" table=\"CHEQUE_PAYMENT\">\n" - " <key column=\"PAYMENT_ID\"/>\n" - " <property name=\"amount\" column=\"CHEQUE_AMOUNT\"/>\n" - " ...\n" - " </joined-subclass>\n" - "</class>]]>" +"<![CDATA[<class name=\"CreditCardPayment\" table=\"CREDIT_PAYMENT\">\n" +" <id name=\"id\" type=\"long\" column=\"CREDIT_PAYMENT_ID\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <discriminator column=\"CREDIT_CARD\" type=\"string\"/>\n" +" <property name=\"amount\" column=\"CREDIT_AMOUNT\"/>\n" +" ...\n" +" <subclass name=\"MasterCardPayment\" discriminator-value=\"MDC\"/>\n" +" <subclass name=\"VisaPayment\" discriminator-value=\"VISA\"/>\n" +"</class>\n" +"\n" +"<class name=\"NonelectronicTransaction\" table=\"NONELECTRONIC_TXN\">\n" +" <id name=\"id\" type=\"long\" column=\"TXN_ID\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" ...\n" +" <joined-subclass name=\"CashPayment\" table=\"CASH_PAYMENT\">\n" +" <key column=\"PAYMENT_ID\"/>\n" +" <property name=\"amount\" column=\"CASH_AMOUNT\"/>\n" +" ...\n" +" </joined-subclass>\n" +" <joined-subclass name=\"ChequePayment\" table=\"CHEQUE_PAYMENT\">\n" +" <key column=\"PAYMENT_ID\"/>\n" +" <property name=\"amount\" column=\"CHEQUE_AMOUNT\"/>\n" +" ...\n" +" </joined-subclass>\n" +"</class>]]>" msgstr "" -#: index.docbook:234 -msgid "Once again, we don't mention <literal>Payment</literal> explicitly. If we execute a query against the <literal>Payment</literal> interface - for example, <literal>from Payment</literal> - Hibernate automatically returns instances of <literal>CreditCardPayment</literal> (and its subclasses, since they also implement <literal>Payment</literal>), <literal>CashPayment</literal> and <literal>ChequePayment</literal> but not instances of <literal>NonelectronicTransaction</literal>." +#. Tag: para +#: inheritance_mapping.xml:234 +#, no-c-format +msgid "" +"Once again, we don't mention <literal>Payment</literal> explicitly. If we " +"execute a query against the <literal>Payment</literal> interface - for " +"example, <literal>from Payment</literal> - Hibernate automatically returns " +"instances of <literal>CreditCardPayment</literal> (and its subclasses, since " +"they also implement <literal>Payment</literal>), <literal>CashPayment</" +"literal> and <literal>ChequePayment</literal> but not instances of " +"<literal>NonelectronicTransaction</literal>." msgstr "" +"Mais uma vez, nós não mencionamos <literal>Payment</literal> explicitamente. " +"Se nós executarmos uma pesquisa em cima da interface <literal>Payment</" +"literal> – por exemplo, <literal>from Payment</literal> – o Hibernate " +"retorna automaticamente instâncias de <literal>CreditCardPayment</literal> " +"(e suas subclasses, desde que elas também implementem <literal>Payment</" +"literal>), <literal>CashPayment</literal> e <literal>ChequePayment</literal> " +"mas não as instâncias de <literal>NonelectronicTransaction</literal>." -#: index.docbook:249 +#. Tag: title +#: inheritance_mapping.xml:249 +#, no-c-format msgid "Limitations" -msgstr "" +msgstr "Limitações" -#: index.docbook:251 -msgid "There are certain limitations to the \"implicit polymorphism\" approach to the table per concrete-class mapping strategy. There are somewhat less restrictive limitations to <literal><union-subclass></literal> mappings." +#. Tag: para +#: inheritance_mapping.xml:251 +#, no-c-format +msgid "" +"There are certain limitations to the \"implicit polymorphism\" approach to " +"the table per concrete-class mapping strategy. There are somewhat less " +"restrictive limitations to <literal><union-subclass></literal> " +"mappings." msgstr "" +"Existem certas limitações para a abordagem do \"polimorfismo implícito\" " +"comparada com a estratégia de mapeamento da tabela por classe concreta. " +"Existe uma limitação um tanto menos restritiva para mapeamentos <literal><" +"union-subclass></literal>." -#: index.docbook:258 -msgid "The following table shows the limitations of table per concrete-class mappings, and of implicit polymorphism, in Hibernate." +#. Tag: para +#: inheritance_mapping.xml:258 +#, no-c-format +msgid "" +"The following table shows the limitations of table per concrete-class " +"mappings, and of implicit polymorphism, in Hibernate." msgstr "" +"A tabela seguinte demonstra as limitações do mapeamento de tabela por classe " +"concreta e do polimorfismo implícito no Hibernate." -#: index.docbook:264 +#. Tag: title +#: inheritance_mapping.xml:264 +#, no-c-format msgid "Features of inheritance mappings" -msgstr "" +msgstr "Features of inheritance mappings" -#: index.docbook:276 +#. Tag: entry +#: inheritance_mapping.xml:276 +#, no-c-format msgid "Inheritance strategy" -msgstr "" +msgstr "Estratégia de Herança" -#: index.docbook:277 +#. Tag: entry +#: inheritance_mapping.xml:277 +#, no-c-format msgid "Polymorphic many-to-one" -msgstr "" +msgstr "muitos-para-um Polimórfico" -#: index.docbook:278 +#. Tag: entry +#: inheritance_mapping.xml:278 +#, no-c-format msgid "Polymorphic one-to-one" -msgstr "" +msgstr "um-para-um Polimórfico" -#: index.docbook:279 +#. Tag: entry +#: inheritance_mapping.xml:279 +#, no-c-format msgid "Polymorphic one-to-many" -msgstr "" +msgstr "um-para-muitos Polimórfico" -#: index.docbook:280 +#. Tag: entry +#: inheritance_mapping.xml:280 +#, no-c-format msgid "Polymorphic many-to-many" -msgstr "" +msgstr "muitos-para-muitos Polimórfico" -#: index.docbook:281 +#. Tag: entry +#: inheritance_mapping.xml:281 +#, no-c-format msgid "Polymorphic <literal>load()/get()</literal>" msgstr "" -#: index.docbook:282 +#. Tag: entry +#: inheritance_mapping.xml:282 +#, no-c-format msgid "Polymorphic queries" -msgstr "" +msgstr "Pesquisas Polimórficas" -#: index.docbook:283 +#. Tag: entry +#: inheritance_mapping.xml:283 +#, no-c-format msgid "Polymorphic joins" -msgstr "" +msgstr "Joins polimórficos" -#: index.docbook:284 +#. Tag: entry +#: inheritance_mapping.xml:284 +#, no-c-format msgid "Outer join fetching" -msgstr "" +msgstr "Outer join fetching" -#: index.docbook:289 +#. Tag: entry +#: inheritance_mapping.xml:289 +#, no-c-format msgid "table per class-hierarchy" -msgstr "" +msgstr "table per class-hierarchy" -#: index.docbook:290, index.docbook:301, index.docbook:312 +#. Tag: literal +#: inheritance_mapping.xml:290 inheritance_mapping.xml:301 +#: inheritance_mapping.xml:312 +#, no-c-format msgid "<many-to-one>" -msgstr "" +msgstr "<many-to-one>" -#: index.docbook:291, index.docbook:302, index.docbook:313 +#. Tag: literal +#: inheritance_mapping.xml:291 inheritance_mapping.xml:302 +#: inheritance_mapping.xml:313 +#, no-c-format msgid "<one-to-one>" -msgstr "" +msgstr "<one-to-one>" -#: index.docbook:292, index.docbook:303 +#. Tag: literal +#: inheritance_mapping.xml:292 inheritance_mapping.xml:303 +#, no-c-format msgid "<one-to-many>" -msgstr "" +msgstr "<one-to-many>" -#: index.docbook:293, index.docbook:304, index.docbook:315 +#. Tag: literal +#: inheritance_mapping.xml:293 inheritance_mapping.xml:304 +#: inheritance_mapping.xml:315 +#, no-c-format msgid "<many-to-many>" -msgstr "" +msgstr "<many-to-many>" -#: index.docbook:294, index.docbook:305, index.docbook:316 +#. Tag: literal +#: inheritance_mapping.xml:294 inheritance_mapping.xml:305 +#: inheritance_mapping.xml:316 +#, no-c-format msgid "s.get(Payment.class, id)" -msgstr "" +msgstr "s.get(Payment.class, id)" -#: index.docbook:295, index.docbook:306, index.docbook:317, index.docbook:328 +#. Tag: literal +#: inheritance_mapping.xml:295 inheritance_mapping.xml:306 +#: inheritance_mapping.xml:317 inheritance_mapping.xml:328 +#, no-c-format msgid "from Payment p" -msgstr "" +msgstr "from Payment p" -#: index.docbook:296, index.docbook:307, index.docbook:318 +#. Tag: literal +#: inheritance_mapping.xml:296 inheritance_mapping.xml:307 +#: inheritance_mapping.xml:318 +#, no-c-format msgid "from Order o join o.payment p" -msgstr "" +msgstr "from Order o join o.payment p" -#: index.docbook:297, index.docbook:308, index.docbook:319 +#. Tag: emphasis +#: inheritance_mapping.xml:297 inheritance_mapping.xml:308 +#: inheritance_mapping.xml:319 +#, no-c-format msgid "supported" -msgstr "" +msgstr "supported" -#: index.docbook:300 +#. Tag: entry +#: inheritance_mapping.xml:300 +#, fuzzy, no-c-format msgid "<entry>table per subclass</entry>" msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"tabela por subclasse\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"table per subclass" -#: index.docbook:311 +#. Tag: entry +#: inheritance_mapping.xml:311 +#, no-c-format msgid "table per concrete-class (union-subclass)" -msgstr "" +msgstr "table per concrete-class (union-subclass)" -#: index.docbook:314 -msgid "<literal><one-to-many></literal> (for <literal>inverse=\"true\"</literal> only)" +#. Tag: entry +#: inheritance_mapping.xml:314 +#, no-c-format +msgid "" +"<literal><one-to-many></literal> (for <literal>inverse=\"true\"</" +"literal> only)" msgstr "" -#: index.docbook:322 +#. Tag: entry +#: inheritance_mapping.xml:322 +#, no-c-format msgid "table per concrete class (implicit polymorphism)" -msgstr "" +msgstr "table per concrete class (implicit polymorphism)" -#: index.docbook:323 +#. Tag: literal +#: inheritance_mapping.xml:323 +#, no-c-format msgid "<any>" -msgstr "" +msgstr "<any>" -#: index.docbook:324, index.docbook:325, index.docbook:329, index.docbook:330 +#. Tag: emphasis +#: inheritance_mapping.xml:324 inheritance_mapping.xml:325 +#: inheritance_mapping.xml:329 inheritance_mapping.xml:330 +#, no-c-format msgid "not supported" -msgstr "" +msgstr "not supported" -#: index.docbook:326 +#. Tag: literal +#: inheritance_mapping.xml:326 +#, no-c-format msgid "<many-to-any>" -msgstr "" +msgstr "<many-to-any>" -#: index.docbook:327 -msgid "s.createCriteria(Payment.class).add( Restrictions.idEq(id) ).uniqueResult()" +#. Tag: literal +#: inheritance_mapping.xml:327 +#, no-c-format +msgid "" +"s.createCriteria(Payment.class).add( Restrictions.idEq(id) ).uniqueResult()" msgstr "" +"s.createCriteria(Payment.class).add( Restrictions.idEq(id) ).uniqueResult()" -msgid "ROLES_OF_TRANSLATORS" -msgstr "" +#~ msgid "load()/get()" +#~ msgstr "load()/get()" -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "" +#~ msgid "Polymorphic <placeholder-1/>" +#~ msgstr "<placeholder-1/> Polimórfico" +#~ msgid "inverse=\"true\"" +#~ msgstr "inverse=\"true\"" + +#~ msgid "<placeholder-1/> (for <placeholder-2/> only)" +#~ msgstr "<placeholder-1/> (for <placeholder-2/> only)" Modified: core/trunk/documentation/manual/translations/pt-BR/content/performance.po =================================================================== --- core/trunk/documentation/manual/translations/pt-BR/content/performance.po 2007-10-25 22:34:46 UTC (rev 14134) +++ core/trunk/documentation/manual/translations/pt-BR/content/performance.po 2007-10-26 00:46:38 UTC (rev 14135) @@ -1,1068 +1,2584 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: performance.xml:5 +#, no-c-format msgid "Improving performance" -msgstr "" +msgstr "Aumentando a performance" -#: index.docbook:8 +#. Tag: title +#: performance.xml:8 +#, no-c-format msgid "Fetching strategies" -msgstr "" +msgstr "Estratégias de Fetching" -#: index.docbook:10 -msgid "A <emphasis>fetching strategy</emphasis> is the strategy Hibernate will use for retrieving associated objects if the application needs to navigate the association. Fetch strategies may be declared in the O/R mapping metadata, or over-ridden by a particular HQL or <literal>Criteria</literal> query." +#. Tag: para +#: performance.xml:10 +#, no-c-format +msgid "" +"A <emphasis>fetching strategy</emphasis> is the strategy Hibernate will use " +"for retrieving associated objects if the application needs to navigate the " +"association. Fetch strategies may be declared in the O/R mapping metadata, " +"or over-ridden by a particular HQL or <literal>Criteria</literal> query." msgstr "" +"Uma <emphasis>estratégia de fetching</emphasis> é a estratégia que o " +"Hibernate irá usar para buscar objetos associados se a aplicação precisar " +"navegar pela associação. Estratégias de Fetch podem ser declaradas nos " +"metadados de mapeamento O/R, ou sobrescritos por uma query HQL ou query com " +"<literal>Criteria</literal>." -#: index.docbook:17 +#. Tag: para +#: performance.xml:17 +#, no-c-format msgid "Hibernate3 defines the following fetching strategies:" -msgstr "" +msgstr "Hibernate3 define as seguintes estratégias de fetching:" -#: index.docbook:23 -msgid "<emphasis>Join fetching</emphasis> - Hibernate retrieves the associated instance or collection in the same <literal>SELECT</literal>, using an <literal>OUTER JOIN</literal>." +#. Tag: para +#: performance.xml:23 +#, no-c-format +msgid "" +"<emphasis>Join fetching</emphasis> - Hibernate retrieves the associated " +"instance or collection in the same <literal>SELECT</literal>, using an " +"<literal>OUTER JOIN</literal>." msgstr "" +"<emphasis>Join fetching</emphasis> - o Hibernate busca o objeto ou coleção " +"associada no mesmo <literal>SELECT</literal>, usando um <literal>OUTER JOIN</" +"literal>." -#: index.docbook:30 -msgid "<emphasis>Select fetching</emphasis> - a second <literal>SELECT</literal> is used to retrieve the associated entity or collection. Unless you explicitly disable lazy fetching by specifying <literal>lazy=\"false\"</literal>, this second select will only be executed when you actually access the association." +#. Tag: para +#: performance.xml:30 +#, no-c-format +msgid "" +"<emphasis>Select fetching</emphasis> - a second <literal>SELECT</literal> is " +"used to retrieve the associated entity or collection. Unless you explicitly " +"disable lazy fetching by specifying <literal>lazy=\"false\"</literal>, this " +"second select will only be executed when you actually access the association." msgstr "" +"<emphasis>Select fetching</emphasis> - um segundo <literal>SELECT</literal> " +"é usado para buscar a entidade ou coleção associada. A menos que você " +"desabilite lazy fetching especificando <literal>lazy=\"false\"</literal>, " +"esse segundo SELECT será executado apenas quando você acessar a associação." -#: index.docbook:39 -msgid "<emphasis>Subselect fetching</emphasis> - a second <literal>SELECT</literal> is used to retrieve the associated collections for all entities retrieved in a previous query or fetch. Unless you explicitly disable lazy fetching by specifying <literal>lazy=\"false\"</literal>, this second select will only be executed when you actually access the association." +#. Tag: para +#: performance.xml:39 +#, no-c-format +msgid "" +"<emphasis>Subselect fetching</emphasis> - a second <literal>SELECT</literal> " +"is used to retrieve the associated collections for all entities retrieved in " +"a previous query or fetch. Unless you explicitly disable lazy fetching by " +"specifying <literal>lazy=\"false\"</literal>, this second select will only " +"be executed when you actually access the association." msgstr "" +"<emphasis>Subselect fetching</emphasis> - um segundo <literal>SELECT</" +"literal> será usado para buscar as coleções associadas de todas as entidades " +"buscadas na query ou fetch anterior. A menos que você desabilite lazy " +"fetching especificando <literal>lazy=\"false\"</literal>, esse segundo " +"SELECT será executado apenas quando você acessar a associação." -#: index.docbook:48 -msgid "<emphasis>Batch fetching</emphasis> - an optimization strategy for select fetching - Hibernate retrieves a batch of entity instances or collections in a single <literal>SELECT</literal>, by specifying a list of primary keys or foreign keys." +#. Tag: para +#: performance.xml:48 +#, no-c-format +msgid "" +"<emphasis>Batch fetching</emphasis> - an optimization strategy for select " +"fetching - Hibernate retrieves a batch of entity instances or collections in " +"a single <literal>SELECT</literal>, by specifying a list of primary keys or " +"foreign keys." msgstr "" +"<emphasis>Batch fetching</emphasis> - uma opção de otimização para o Select " +"Fetching – O Hibernate busca um lote de instâncias ou entidades usando um " +"único <literal>SELECT</literal>, especificando uma lista de chaves primárias " +"ou chaves estrangeiras." -#: index.docbook:57 +#. Tag: para +#: performance.xml:57 +#, no-c-format msgid "Hibernate also distinguishes between:" -msgstr "" +msgstr "O Hibernate distingue também entre:" -#: index.docbook:63 -msgid "<emphasis>Immediate fetching</emphasis> - an association, collection or attribute is fetched immediately, when the owner is loaded." +#. Tag: para +#: performance.xml:63 +#, no-c-format +msgid "" +"<emphasis>Immediate fetching</emphasis> - an association, collection or " +"attribute is fetched immediately, when the owner is loaded." msgstr "" +"<emphasis>Immediate fetching</emphasis> - uma associação, coleção ou " +"atributo é buscado como ela é carregada (Qual SQL é usado). Não se confuda " +"com eles! Nós usamos fetch para melhorar a performance. Nós podemos usar " +"lazy para definir um contrato para qual dado é sempre disponível em qualquer " +"instância desanexada de uma classe qualquer. imediatamente, quando o pai é " +"carregado." -#: index.docbook:69 -msgid "<emphasis>Lazy collection fetching</emphasis> - a collection is fetched when the application invokes an operation upon that collection. (This is the default for collections.)" +#. Tag: para +#: performance.xml:69 +#, no-c-format +msgid "" +"<emphasis>Lazy collection fetching</emphasis> - a collection is fetched when " +"the application invokes an operation upon that collection. (This is the " +"default for collections.)" msgstr "" +"<emphasis>Lazy collection fetching</emphasis> - a coleção é buscada quando a " +"aplicação invoca uma operação sobre aquela coleção (Esse é o padrão para " +"coleções)" -#: index.docbook:76 -msgid "<emphasis>\"Extra-lazy\" collection fetching</emphasis> - individual elements of the collection are accessed from the database as needed. Hibernate tries not to fetch the whole collection into memory unless absolutely needed (suitable for very large collections)" +#. Tag: para +#: performance.xml:76 +#, no-c-format +msgid "" +"<emphasis>\"Extra-lazy\" collection fetching</emphasis> - individual " +"elements of the collection are accessed from the database as needed. " +"Hibernate tries not to fetch the whole collection into memory unless " +"absolutely needed (suitable for very large collections)" msgstr "" +"<emphasis>\"Extra-lazy\" collection fetching</emphasis> - elementos " +"individuais de uma coleção são acessados do banco de dados quando preciso. O " +"Hibernate tenta não buscar a coleção inteira dentro da memória ao menos que " +"seja absolutamente preciso. (indicado para coleções muito grandes)" -#: index.docbook:84 -msgid "<emphasis>Proxy fetching</emphasis> - a single-valued association is fetched when a method other than the identifier getter is invoked upon the associated object." +#. Tag: para +#: performance.xml:84 +#, no-c-format +msgid "" +"<emphasis>Proxy fetching</emphasis> - a single-valued association is fetched " +"when a method other than the identifier getter is invoked upon the " +"associated object." msgstr "" +"<emphasis>Proxy fetching</emphasis> - uma associação de um valor é carregada " +"quando um método diferente do getter do identificador é invocado sobre o " +"objeto associado." -#: index.docbook:91 -msgid "<emphasis>\"No-proxy\" fetching</emphasis> - a single-valued association is fetched when the instance variable is accessed. Compared to proxy fetching, this approach is less lazy (the association is fetched even when only the identifier is accessed) but more transparent, since no proxy is visible to the application. This approach requires buildtime bytecode instrumentation and is rarely necessary." +#. Tag: para +#: performance.xml:91 +#, no-c-format +msgid "" +"<emphasis>\"No-proxy\" fetching</emphasis> - a single-valued association is " +"fetched when the instance variable is accessed. Compared to proxy fetching, " +"this approach is less lazy (the association is fetched even when only the " +"identifier is accessed) but more transparent, since no proxy is visible to " +"the application. This approach requires buildtime bytecode instrumentation " +"and is rarely necessary." msgstr "" +"<emphasis>\"No-proxy\" fetching</emphasis> - uma associação de um valor é " +"carregada quando a variável da instância é carregada. Comparada com a proxy " +"fetching, esse método é menos preguiçoso (lazy)(a associação é carregada " +"somente quando o identificador é acessada) mas é mais transparente, já que " +"não há proxies visíveis para a aplicação. Esse método requer instrumentação " +"de bytecodes em build-time e é raramente necessário." -#: index.docbook:101 -msgid "<emphasis>Lazy attribute fetching</emphasis> - an attribute or single valued association is fetched when the instance variable is accessed. This approach requires buildtime bytecode instrumentation and is rarely necessary." +#. Tag: para +#: performance.xml:101 +#, no-c-format +msgid "" +"<emphasis>Lazy attribute fetching</emphasis> - an attribute or single valued " +"association is fetched when the instance variable is accessed. This approach " +"requires buildtime bytecode instrumentation and is rarely necessary." msgstr "" +"<emphasis>Lazy attribute fetching</emphasis> - um atributo ou associação de " +"um valor é carregada quanto a varíavel da instância é acessada. Esse método " +"requer instrumentação de bytecodes em build-time e é raramente necessário." -#: index.docbook:110 -msgid "We have two orthogonal notions here: <emphasis>when</emphasis> is the association fetched, and <emphasis>how</emphasis> is it fetched (what SQL is used). Don't confuse them! We use <literal>fetch</literal> to tune performance. We may use <literal>lazy</literal> to define a contract for what data is always available in any detached instance of a particular class." +#. Tag: para +#: performance.xml:110 +#, no-c-format +msgid "" +"We have two orthogonal notions here: <emphasis>when</emphasis> is the " +"association fetched, and <emphasis>how</emphasis> is it fetched (what SQL is " +"used). Don't confuse them! We use <literal>fetch</literal> to tune " +"performance. We may use <literal>lazy</literal> to define a contract for " +"what data is always available in any detached instance of a particular class." msgstr "" +"Nós temos aqui duas noções ortogonais: <emphasis>quando</emphasis> a " +"associação é carregada e <emphasis>como </emphasis> ela é carregada (Qual " +"SQL é usado). Não se confuda com eles! Nós usamos <literal>fetch</literal> " +"para melhorar a performance. Nós podemos usar lazy para definir um contrato " +"para qual dado é sempre disponível em qualquer instância desconectada de uma " +"classe qualquer." -#: index.docbook:119 +#. Tag: title +#: performance.xml:119 +#, no-c-format msgid "Working with lazy associations" -msgstr "" +msgstr "Inicializando coleções e proxies" -#: index.docbook:121 -msgid "By default, Hibernate3 uses lazy select fetching for collections and lazy proxy fetching for single-valued associations. These defaults make sense for almost all associations in almost all applications." +#. Tag: para +#: performance.xml:121 +#, no-c-format +msgid "" +"By default, Hibernate3 uses lazy select fetching for collections and lazy " +"proxy fetching for single-valued associations. These defaults make sense for " +"almost all associations in almost all applications." msgstr "" +"Por padrão, o Hibernate3 usa busca preguiçosa para coleções e busca " +"preguiçosa com proxy para associações de um valor. Esses padrões fazem " +"sentido para quase todas as associações em quase todas a aplicações." -#: index.docbook:127 -msgid "<emphasis>Note:</emphasis> if you set <literal>hibernate.default_batch_fetch_size</literal>, Hibernate will use the batch fetch optimization for lazy fetching (this optimization may also be enabled at a more granular level)." +#. Tag: para +#: performance.xml:127 +#, no-c-format +msgid "" +"<emphasis>Note:</emphasis> if you set <literal>hibernate." +"default_batch_fetch_size</literal>, Hibernate will use the batch fetch " +"optimization for lazy fetching (this optimization may also be enabled at a " +"more granular level)." msgstr "" +"<emphasis>Veja:</emphasis> se voce setar <literal>hibernate." +"default_batch_fetch_size</literal>, O Hibernate irá usar otimização de " +"carregamento em lote para o carregamento preguiçoso(Essa otimização pode ser " +"também habilitada em um nível mais fino)." -#: index.docbook:134 -msgid "However, lazy fetching poses one problem that you must be aware of. Access to a lazy association outside of the context of an open Hibernate session will result in an exception. For example:" +#. Tag: para +#: performance.xml:134 +#, no-c-format +msgid "" +"However, lazy fetching poses one problem that you must be aware of. Access " +"to a lazy association outside of the context of an open Hibernate session " +"will result in an exception. For example:" msgstr "" +"Porém, a busca preguiçosa tem um problema que você precisar saber. Acesso a " +"associações preguiçosas fora do contexto de uma sessão aberta do Hibernate " +"irá resultar numa exceção. Por exemplo:" -#: index.docbook:140 +#. Tag: programlisting +#: performance.xml:140 +#, no-c-format msgid "" - "<![CDATA[s = sessions.openSession();\n" - "Transaction tx = s.beginTransaction();\n" - " \n" - "User u = (User) s.createQuery(\"from User u where u.name=:userName\")\n" - " .setString(\"userName\", userName).uniqueResult();\n" - "Map permissions = u.getPermissions();\n" - "\n" - "tx.commit();\n" - "s.close();\n" - "\n" - "Integer accessLevel = (Integer) permissions.get(\"accounts\"); // Error!]]>" +"<![CDATA[s = sessions.openSession();\n" +"Transaction tx = s.beginTransaction();\n" +" \n" +"User u = (User) s.createQuery(\"from User u where u.name=:userName\")\n" +" .setString(\"userName\", userName).uniqueResult();\n" +"Map permissions = u.getPermissions();\n" +"\n" +"tx.commit();\n" +"s.close();\n" +"\n" +"Integer accessLevel = (Integer) permissions.get(\"accounts\"); // Error!]]>" msgstr "" -#: index.docbook:142 -msgid "Since the permissions collection was not initialized when the <literal>Session</literal> was closed, the collection will not be able to load its state. <emphasis>Hibernate does not support lazy initialization for detached objects</emphasis>. The fix is to move the code that reads from the collection to just before the transaction is committed." +#. Tag: para +#: performance.xml:142 +#, no-c-format +msgid "" +"Since the permissions collection was not initialized when the " +"<literal>Session</literal> was closed, the collection will not be able to " +"load its state. <emphasis>Hibernate does not support lazy initialization for " +"detached objects</emphasis>. The fix is to move the code that reads from the " +"collection to just before the transaction is committed." msgstr "" +"Como a coleção de permissões não foi inicializada quando a <literal>Session</" +"literal> foi fechada, a coleção não poderá carregar o seu estado. O " +"Hibernate não suporta inicialização preguiçosa para objetos desconectados. " +"Para consertar isso, é necessário mover o código que carrega a coleção para " +"antes da transação ser comitada." -#: index.docbook:150 -msgid "Alternatively, we could use a non-lazy collection or association, by specifying <literal>lazy=\"false\"</literal> for the association mapping. However, it is intended that lazy initialization be used for almost all collections and associations. If you define too many non-lazy associations in your object model, Hibernate will end up needing to fetch the entire database into memory in every transaction!" +#. Tag: para +#: performance.xml:150 +#, no-c-format +msgid "" +"Alternatively, we could use a non-lazy collection or association, by " +"specifying <literal>lazy=\"false\"</literal> for the association mapping. " +"However, it is intended that lazy initialization be used for almost all " +"collections and associations. If you define too many non-lazy associations " +"in your object model, Hibernate will end up needing to fetch the entire " +"database into memory in every transaction!" msgstr "" +"Alternativamente, nós podemos usar uma coleção ou associação não preguiçosa, " +"especificando <literal>lazy=\"false\"</literal> para o mapeamento da " +"associação. Porém, é pretendido que a inicialização preguiçosa seja usada " +"por quase todas as coleções e associações. Se você definir muitas " +"associações não preguiçosas em seu modelo de objetos, o Hibernate irá " +"precisar carregar o banco de dados inteiro na memória em cada transação!" -#: index.docbook:159 -msgid "On the other hand, we often want to choose join fetching (which is non-lazy by nature) instead of select fetching in a particular transaction. We'll now see how to customize the fetching strategy. In Hibernate3, the mechanisms for choosing a fetch strategy are identical for single-valued associations and collections." +#. Tag: para +#: performance.xml:159 +#, no-c-format +msgid "" +"On the other hand, we often want to choose join fetching (which is non-lazy " +"by nature) instead of select fetching in a particular transaction. We'll now " +"see how to customize the fetching strategy. In Hibernate3, the mechanisms " +"for choosing a fetch strategy are identical for single-valued associations " +"and collections." msgstr "" +"Por outro lado, nós geralmente escolhemos join fetching (que é não " +"preguiçosa por natureza) ao invés de select fetching em uma transação " +"particular. Nós iremos ver como customizar a estratégoa de busca. No " +"Hibernate3, os mecanismos para escolher a estratégia de fetching são " +"identicos para as associações simples e para coleções." -#: index.docbook:170 +#. Tag: title +#: performance.xml:170 +#, no-c-format msgid "Tuning fetch strategies" -msgstr "" +msgstr "Personalizando as estratégias de busca" -#: index.docbook:172 -msgid "Select fetching (the default) is extremely vulnerable to N+1 selects problems, so we might want to enable join fetching in the mapping document:" +#. Tag: para +#: performance.xml:172 +#, no-c-format +msgid "" +"Select fetching (the default) is extremely vulnerable to N+1 selects " +"problems, so we might want to enable join fetching in the mapping document:" msgstr "" +"O select fetching (o padrão) é extremamente vunerável para N+1 problemas em " +"select, então nós iremos querer habilitar o join fetching no documento de " +"mapeamento:" -#: index.docbook:177 +#. Tag: programlisting +#: performance.xml:177 +#, no-c-format msgid "" - "<![CDATA[<set name=\"permissions\" \n" - " fetch=\"join\">\n" - " <key column=\"userId\"/>\n" - " <one-to-many class=\"Permission\"/>\n" - "</set]]>" +"<![CDATA[<set name=\"permissions\" \n" +" fetch=\"join\">\n" +" <key column=\"userId\"/>\n" +" <one-to-many class=\"Permission\"/>\n" +"</set]]>" msgstr "" -#: index.docbook:179 +#. Tag: programlisting +#: performance.xml:179 +#, no-c-format msgid "<![CDATA[<many-to-one name=\"mother\" class=\"Cat\" fetch=\"join\"/>]]>" msgstr "" -#: index.docbook:181 -msgid "The <literal>fetch</literal> strategy defined in the mapping document affects:" +#. Tag: para +#: performance.xml:181 +#, no-c-format +msgid "" +"The <literal>fetch</literal> strategy defined in the mapping document " +"affects:" msgstr "" +"A estratégia de <literal>fetch</literal> definida no documento de mapeamento " +"afeta:" -#: index.docbook:187 +#. Tag: para +#: performance.xml:187 +#, no-c-format msgid "retrieval via <literal>get()</literal> or <literal>load()</literal>" -msgstr "" +msgstr "recupera via <literal>get()</literal> ou <literal>load()</literal>" -#: index.docbook:192 +#. Tag: para +#: performance.xml:192 +#, no-c-format msgid "retrieval that happens implicitly when an association is navigated" msgstr "" +"Recuperações que acontecem implicitamente quando navegamos por uma associação" -#: index.docbook:197 +#. Tag: para +#: performance.xml:197 +#, no-c-format msgid "<literal>Criteria</literal> queries" -msgstr "" +msgstr "<literal>Criteria</literal> queries" -#: index.docbook:202 +#. Tag: para +#: performance.xml:202 +#, no-c-format msgid "HQL queries if <literal>subselect</literal> fetching is used" -msgstr "" +msgstr "buscas por HQL se buscar por <literal>subselect</literal> for usado" -#: index.docbook:208 -msgid "No matter what fetching strategy you use, the defined non-lazy graph is guaranteed to be loaded into memory. Note that this might result in several immediate selects being used to execute a particular HQL query." +#. Tag: para +#: performance.xml:208 +#, no-c-format +msgid "" +"No matter what fetching strategy you use, the defined non-lazy graph is " +"guaranteed to be loaded into memory. Note that this might result in several " +"immediate selects being used to execute a particular HQL query." msgstr "" +"Independentemente da estratégia de busca que você usar, o grafo não " +"preguiçoso definido será garantidamente carregado na memória. Note que isso " +"irá resultar em diversos selects imediatos sendo usados em um HQL em " +"particular." -#: index.docbook:214 -msgid "Usually, we don't use the mapping document to customize fetching. Instead, we keep the default behavior, and override it for a particular transaction, using <literal>left join fetch</literal> in HQL. This tells Hibernate to fetch the association eagerly in the first select, using an outer join. In the <literal>Criteria</literal> query API, you would use <literal>setFetchMode(FetchMode.JOIN)</literal>." +#. Tag: para +#: performance.xml:214 +#, no-c-format +msgid "" +"Usually, we don't use the mapping document to customize fetching. Instead, " +"we keep the default behavior, and override it for a particular transaction, " +"using <literal>left join fetch</literal> in HQL. This tells Hibernate to " +"fetch the association eagerly in the first select, using an outer join. In " +"the <literal>Criteria</literal> query API, you would use " +"<literal>setFetchMode(FetchMode.JOIN)</literal>." msgstr "" +"Usualmente não usamos documentos de mapeamento para customizar as buscas. Ao " +"invés disso, nós deixamos o comportamento padrão e sobrescrevemos isso em " +"uma transação em particular, usando <literal>left join fetch</literal> no " +"HQL. Isso diz ao Hibernate para buscar a associação inteira no primeiro " +"select, usando um outer join. Na API de busca <literal>Criteria</literal>, " +"você irá usar <literal>setFetchMode(FetchMode.JOIN)</literal>." -#: index.docbook:223 -msgid "If you ever feel like you wish you could change the fetching strategy used by <literal>get()</literal> or <literal>load()</literal>, simply use a <literal>Criteria</literal> query, for example:" +#. Tag: para +#: performance.xml:223 +#, no-c-format +msgid "" +"If you ever feel like you wish you could change the fetching strategy used " +"by <literal>get()</literal> or <literal>load()</literal>, simply use a " +"<literal>Criteria</literal> query, for example:" msgstr "" +"Se você quiser mudar a estratégia de busca usada pelo <literal>get()</" +"literal> ou <literal>load()</literal>, simplesmente use uma query " +"<literal>Criteria</literal>, por exemplo:" -#: index.docbook:229 +#. Tag: programlisting +#: performance.xml:229 +#, no-c-format msgid "" - "<![CDATA[User user = (User) session.createCriteria(User.class)\n" - " .setFetchMode(\"permissions\", FetchMode.JOIN)\n" - " .add( Restrictions.idEq(userId) )\n" - " .uniqueResult();]]>" +"<![CDATA[User user = (User) session.createCriteria(User.class)\n" +" .setFetchMode(\"permissions\", FetchMode.JOIN)\n" +" .add( Restrictions.idEq(userId) )\n" +" .uniqueResult();]]>" msgstr "" -#: index.docbook:231 -msgid "(This is Hibernate's equivalent of what some ORM solutions call a \"fetch plan\".)" +#. Tag: para +#: performance.xml:231 +#, no-c-format +msgid "" +"(This is Hibernate's equivalent of what some ORM solutions call a \"fetch " +"plan\".)" msgstr "" +"(Isto é o equivalente do Hibernate para o que algumas soluções ORM chamam de " +"\"plano de busca\")" -#: index.docbook:235 -msgid "A completely different way to avoid problems with N+1 selects is to use the second-level cache." +#. Tag: para +#: performance.xml:235 +#, no-c-format +msgid "" +"A completely different way to avoid problems with N+1 selects is to use the " +"second-level cache." msgstr "" +"Um meio totalmente diferente de evitar problemas com selects N+1 é usar um " +"cache de segundo nível." -#: index.docbook:243 +#. Tag: title +#: performance.xml:243 +#, no-c-format msgid "Single-ended association proxies" -msgstr "" +msgstr "Proxies de associação single-ended" -#: index.docbook:245 -msgid "Lazy fetching for collections is implemented using Hibernate's own implementation of persistent collections. However, a different mechanism is needed for lazy behavior in single-ended associations. The target entity of the association must be proxied. Hibernate implements lazy initializing proxies for persistent objects using runtime bytecode enhancement (via the excellent CGLIB library)." +#. Tag: para +#: performance.xml:245 +#, no-c-format +msgid "" +"Lazy fetching for collections is implemented using Hibernate's own " +"implementation of persistent collections. However, a different mechanism is " +"needed for lazy behavior in single-ended associations. The target entity of " +"the association must be proxied. Hibernate implements lazy initializing " +"proxies for persistent objects using runtime bytecode enhancement (via the " +"excellent CGLIB library)." msgstr "" +"A recuperação preguiçosa para coleções é implementada usando uma " +"implementação própria do Hibernate para coleções persistentes. Porém, um " +"mecanismo diferente é necessário para comportamento preguiçoso para " +"associações de um lado só. A entidade alvo da associação precisa usar um " +"proxy. O Hibernate implementa proxies para inicialização preguiçosa em " +"objetos persistentes usando manipulação de bytecode (via a excelente " +"biblioteca CGLIB)." -#: index.docbook:253 -msgid "By default, Hibernate3 generates proxies (at startup) for all persistent classes and uses them to enable lazy fetching of <literal>many-to-one</literal> and <literal>one-to-one</literal> associations." +#. Tag: para +#: performance.xml:253 +#, no-c-format +msgid "" +"By default, Hibernate3 generates proxies (at startup) for all persistent " +"classes and uses them to enable lazy fetching of <literal>many-to-one</" +"literal> and <literal>one-to-one</literal> associations." msgstr "" +"Por padrão, o Hibernate3 gera proxies (na inicialização) para todas as " +"classes persistentes que usem eles para habilitar recuperaçãopreguiçosa de " +"associações <literal>many-to-one</literal> e <literal>one-to-one</literal>." -#: index.docbook:259 -msgid "The mapping file may declare an interface to use as the proxy interface for that class, with the <literal>proxy</literal> attribute. By default, Hibernate uses a subclass of the class. <emphasis>Note that the proxied class must implement a default constructor with at least package visibility. We recommend this constructor for all persistent classes!</emphasis>" +#. Tag: para +#: performance.xml:259 +#, no-c-format +msgid "" +"The mapping file may declare an interface to use as the proxy interface for " +"that class, with the <literal>proxy</literal> attribute. By default, " +"Hibernate uses a subclass of the class. <emphasis>Note that the proxied " +"class must implement a default constructor with at least package visibility. " +"We recommend this constructor for all persistent classes!</emphasis>" msgstr "" +"O arquivo de mapeamento deve declaram uma interface para usar como interface " +"de proxy para aquela classe, com o atributo <literal>proxy</literal>. Por " +"padrão, o Hibernate usa uma subclasse dessa classe. <emphasis>Note que a " +"classe a ser usada via proxy precisa implementar o construtor padrão com " +"pelo menos visibilidade de package. Nós recomendamos esse construtor para " +"todas as classes persistentes!</emphasis>" -#: index.docbook:266 -msgid "There are some gotchas to be aware of when extending this approach to polymorphic classes, eg." +#. Tag: para +#: performance.xml:266 +#, no-c-format +msgid "" +"There are some gotchas to be aware of when extending this approach to " +"polymorphic classes, eg." msgstr "" +"Existe alguns truques que você deve saber quando extender esse comportamento " +"para classes polimórficas, dessa maneira:" -#: index.docbook:271 +#. Tag: programlisting +#: performance.xml:271 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Cat\" proxy=\"Cat\">\n" - " ......\n" - " <subclass name=\"DomesticCat\">\n" - " .....\n" - " </subclass>\n" - "</class>]]>" +"<![CDATA[<class name=\"Cat\" proxy=\"Cat\">\n" +" ......\n" +" <subclass name=\"DomesticCat\">\n" +" .....\n" +" </subclass>\n" +"</class>]]>" msgstr "" -#: index.docbook:273 -msgid "Firstly, instances of <literal>Cat</literal> will never be castable to <literal>DomesticCat</literal>, even if the underlying instance is an instance of <literal>DomesticCat</literal>:" +#. Tag: para +#: performance.xml:273 +#, no-c-format +msgid "" +"Firstly, instances of <literal>Cat</literal> will never be castable to " +"<literal>DomesticCat</literal>, even if the underlying instance is an " +"instance of <literal>DomesticCat</literal>:" msgstr "" +"Primeiramente, instâncias de <literal>Cat</literal> nunca seráo convertidas " +"para <literal>DomesticCat</literal>, mesmo que a instância em questão seja " +"uma estância de <literal>DomesticCat</literal>:" -#: index.docbook:279 +#. Tag: programlisting +#: performance.xml:279 +#, no-c-format msgid "" - "<![CDATA[Cat cat = (Cat) session.load(Cat.class, id); // instantiate a proxy (does not hit the db)\n" - "if ( cat.isDomesticCat() ) { // hit the db to initialize the proxy\n" - " DomesticCat dc = (DomesticCat) cat; // Error!\n" - " ....\n" - "}]]>" +"<![CDATA[Cat cat = (Cat) session.load(Cat.class, id); // instantiate a " +"proxy (does not hit the db)\n" +"if ( cat.isDomesticCat() ) { // hit the db to initialize " +"the proxy\n" +" DomesticCat dc = (DomesticCat) cat; // Error!\n" +" ....\n" +"}]]>" msgstr "" -#: index.docbook:281 +#. Tag: para +#: performance.xml:281 +#, no-c-format msgid "Secondly, it is possible to break proxy <literal>==</literal>." -msgstr "" +msgstr "É possível quebrar o proxy <literal>==</literal>." -#: index.docbook:285 +#. Tag: programlisting +#: performance.xml:285 +#, no-c-format msgid "" - "<![CDATA[Cat cat = (Cat) session.load(Cat.class, id); // instantiate a Cat proxy\n" - "DomesticCat dc = \n" - " (DomesticCat) session.load(DomesticCat.class, id); // acquire new DomesticCat proxy!\n" - "System.out.println(cat==dc); // false]]>" +"<![CDATA[Cat cat = (Cat) session.load(Cat.class, id); // " +"instantiate a Cat proxy\n" +"DomesticCat dc = \n" +" (DomesticCat) session.load(DomesticCat.class, id); // acquire new " +"DomesticCat proxy!\n" +"System.out.println(cat==dc); // false]]>" msgstr "" -#: index.docbook:287 -msgid "However, the situation is not quite as bad as it looks. Even though we now have two references to different proxy objects, the underlying instance will still be the same object:" +#. Tag: para +#: performance.xml:287 +#, no-c-format +msgid "" +"However, the situation is not quite as bad as it looks. Even though we now " +"have two references to different proxy objects, the underlying instance will " +"still be the same object:" msgstr "" +"Porém a situação não é tão ruim como parece. Mesmo quando temos duas " +"referências para objetos proxies diferentes, a instância deles será o mesmo " +"objeto" -#: index.docbook:292 +#. Tag: programlisting +#: performance.xml:292 +#, no-c-format msgid "" - "<![CDATA[cat.setWeight(11.0); // hit the db to initialize the proxy\n" - "System.out.println( dc.getWeight() ); // 11.0]]>" +"<![CDATA[cat.setWeight(11.0); // hit the db to initialize the proxy\n" +"System.out.println( dc.getWeight() ); // 11.0]]>" msgstr "" -#: index.docbook:294 -msgid "Third, you may not use a CGLIB proxy for a <literal>final</literal> class or a class with any <literal>final</literal> methods." +#. Tag: para +#: performance.xml:294 +#, no-c-format +msgid "" +"Third, you may not use a CGLIB proxy for a <literal>final</literal> class or " +"a class with any <literal>final</literal> methods." msgstr "" +"Terceiro, Você não pode usar um proxy CGLIB em uma classe <literal>final</" +"literal> ou com qualquer método <literal>final</literal>." -#: index.docbook:299 -msgid "Finally, if your persistent object acquires any resources upon instantiation (eg. in initializers or default constructor), then those resources will also be acquired by the proxy. The proxy class is an actual subclass of the persistent class." +#. Tag: para +#: performance.xml:299 +#, no-c-format +msgid "" +"Finally, if your persistent object acquires any resources upon instantiation " +"(eg. in initializers or default constructor), then those resources will also " +"be acquired by the proxy. The proxy class is an actual subclass of the " +"persistent class." msgstr "" +"Finalmente, se o seu objeto persistente adquirir qualquer recursto durante a " +"instanciação (em inicializadores ou construtor padrão), então esses recursos " +"serão adquiridos pelo proxy também. A classe de proxy é uma subclasse da " +"classe persistente." -#: index.docbook:305 -msgid "These problems are all due to fundamental limitations in Java's single inheritance model. If you wish to avoid these problems your persistent classes must each implement an interface that declares its business methods. You should specify these interfaces in the mapping file. eg." +#. Tag: para +#: performance.xml:305 +#, no-c-format +msgid "" +"These problems are all due to fundamental limitations in Java's single " +"inheritance model. If you wish to avoid these problems your persistent " +"classes must each implement an interface that declares its business methods. " +"You should specify these interfaces in the mapping file. eg." msgstr "" +"Esses problemas são todos devido a limitação fundamental do modelo de " +"herança simples do Java. Se você quiser evitar esse problemas em suas " +"classes persistentes você deve imeplementar uma interface que declare seus " +"métodos de negócio. Você deve especificar essas interfaces no arquivo de " +"mapeamento. Ex:" -#: index.docbook:311 +#. Tag: programlisting +#: performance.xml:311 +#, no-c-format msgid "" - "<![CDATA[<class name=\"CatImpl\" proxy=\"Cat\">\n" - " ......\n" - " <subclass name=\"DomesticCatImpl\" proxy=\"DomesticCat\">\n" - " .....\n" - " </subclass>\n" - "</class>]]>" +"<![CDATA[<class name=\"CatImpl\" proxy=\"Cat\">\n" +" ......\n" +" <subclass name=\"DomesticCatImpl\" proxy=\"DomesticCat\">\n" +" .....\n" +" </subclass>\n" +"</class>]]>" msgstr "" -#: index.docbook:313 -msgid "where <literal>CatImpl</literal> implements the interface <literal>Cat</literal> and <literal>DomesticCatImpl</literal> implements the interface <literal>DomesticCat</literal>. Then proxies for instances of <literal>Cat</literal> and <literal>DomesticCat</literal> may be returned by <literal>load()</literal> or <literal>iterate()</literal>. (Note that <literal>list()</literal> does not usually return proxies.)" +#. Tag: para +#: performance.xml:313 +#, no-c-format +msgid "" +"where <literal>CatImpl</literal> implements the interface <literal>Cat</" +"literal> and <literal>DomesticCatImpl</literal> implements the interface " +"<literal>DomesticCat</literal>. Then proxies for instances of <literal>Cat</" +"literal> and <literal>DomesticCat</literal> may be returned by <literal>load" +"()</literal> or <literal>iterate()</literal>. (Note that <literal>list()</" +"literal> does not usually return proxies.)" msgstr "" +"onde <literal>CatImpl</literal> implementa a interface <literal>Cat</" +"literal> e <literal>DomesticCatImpl</literal> implementa a interface " +"<literal>DomesticCat</literal>. Então proxies para instâncias de " +"<literal>Cat</literal> e <literal>DomesticCat</literal> serão retornadas por " +"<literal>load()</literal> ou <literal>iterate()</literal>. (Note que " +"<literal>list()</literal> geralmente não retorna proxies)." -#: index.docbook:321 +#. Tag: programlisting +#: performance.xml:321 +#, no-c-format msgid "" - "<![CDATA[Cat cat = (Cat) session.load(CatImpl.class, catid);\n" - "Iterator iter = session.createQuery(\"from CatImpl as cat where cat.name='fritz'\").iterate();\n" - "Cat fritz = (Cat) iter.next();]]>" +"<![CDATA[Cat cat = (Cat) session.load(CatImpl.class, catid);\n" +"Iterator iter = session.createQuery(\"from CatImpl as cat where cat." +"name='fritz'\").iterate();\n" +"Cat fritz = (Cat) iter.next();]]>" msgstr "" -#: index.docbook:323 -msgid "Relationships are also lazily initialized. This means you must declare any properties to be of type <literal>Cat</literal>, not <literal>CatImpl</literal>." +#. Tag: para +#: performance.xml:323 +#, no-c-format +msgid "" +"Relationships are also lazily initialized. This means you must declare any " +"properties to be of type <literal>Cat</literal>, not <literal>CatImpl</" +"literal>." msgstr "" +"Relacionamentos são também carregados preguiçosamente. Isso significa que " +"você precisa declarar qualquer propriedade como sendo do tipo <literal>Cat</" +"literal>, e não <literal>CatImpl</literal>." -#: index.docbook:328 -msgid "Certain operations do <emphasis>not</emphasis> require proxy initialization" +#. Tag: para +#: performance.xml:328 +#, no-c-format +msgid "" +"Certain operations do <emphasis>not</emphasis> require proxy initialization" msgstr "" +"Algumas operações <emphasis>não</emphasis> requerem inicialização por proxy:" -#: index.docbook:334 -msgid "<literal>equals()</literal>, if the persistent class does not override <literal>equals()</literal>" +#. Tag: para +#: performance.xml:334 +#, no-c-format +msgid "" +"<literal>equals()</literal>, if the persistent class does not override " +"<literal>equals()</literal>" msgstr "" +"<literal>equals()</literal>, se a classe persistente não sobrescrever " +"<literal>equals()</literal>" -#: index.docbook:340 -msgid "<literal>hashCode()</literal>, if the persistent class does not override <literal>hashCode()</literal>" +#. Tag: para +#: performance.xml:340 +#, no-c-format +msgid "" +"<literal>hashCode()</literal>, if the persistent class does not override " +"<literal>hashCode()</literal>" msgstr "" +"<literal>hashCode()</literal>, se a classe persistente não sobrescrever " +"<literal>hashCode()</literal>" -#: index.docbook:346 +#. Tag: para +#: performance.xml:346 +#, no-c-format msgid "The identifier getter method" -msgstr "" +msgstr "O método getter do identificador" -#: index.docbook:352 -msgid "Hibernate will detect persistent classes that override <literal>equals()</literal> or <literal>hashCode()</literal>." +#. Tag: para +#: performance.xml:352 +#, no-c-format +msgid "" +"Hibernate will detect persistent classes that override <literal>equals()</" +"literal> or <literal>hashCode()</literal>." msgstr "" +"O Hibernate irá detectar classes persistentes que sobrescrevem " +"<literal>equals()</literal> ou <literal>hashCode()</literal>." -#: index.docbook:357 -msgid "By choosing <literal>lazy=\"no-proxy\"</literal> instead of the default <literal>lazy=\"proxy\"</literal>, we can avoid the problems associated with typecasting. However, we will require buildtime bytecode instrumentation, and all operations will result in immediate proxy initialization." +#. Tag: para +#: performance.xml:357 +#, no-c-format +msgid "" +"By choosing <literal>lazy=\"no-proxy\"</literal> instead of the default " +"<literal>lazy=\"proxy\"</literal>, we can avoid the problems associated with " +"typecasting. However, we will require buildtime bytecode instrumentation, " +"and all operations will result in immediate proxy initialization." msgstr "" +"Escolhendo <literal>lazy=\"no-proxy\"</literal> ao invés do padrão " +"<literal>lazy=\"proxy\"</literal>, podemos evitar problemas associados com " +"typecasting. Porém, iremos precisar de instrumentação de bytecode em tempo " +"de compilação e todas as operações irão resultar em iniciazações de proxy " +"imediatas." -#: index.docbook:367 +#. Tag: title +#: performance.xml:367 +#, no-c-format msgid "Initializing collections and proxies" -msgstr "" +msgstr "Inicializando coleções e proxies" -#: index.docbook:369 -msgid "A <literal>LazyInitializationException</literal> will be thrown by Hibernate if an uninitialized collection or proxy is accessed outside of the scope of the <literal>Session</literal>, ie. when the entity owning the collection or having the reference to the proxy is in the detached state." +#. Tag: para +#: performance.xml:369 +#, no-c-format +msgid "" +"A <literal>LazyInitializationException</literal> will be thrown by Hibernate " +"if an uninitialized collection or proxy is accessed outside of the scope of " +"the <literal>Session</literal>, ie. when the entity owning the collection or " +"having the reference to the proxy is in the detached state." msgstr "" +"Será lançada uma <literal>LazyInitializationException</literal> se uma " +"coleção não inicializada ou proxy é acessado fora do escopo da " +"<literal>Session</literal>, isto é, quando a entidade que contém a coleção " +"ou tem a referência ao proxy estiver no estado destachado." -#: index.docbook:375 -msgid "Sometimes we need to ensure that a proxy or collection is initialized before closing the <literal>Session</literal>. Of course, we can alway force initialization by calling <literal>cat.getSex()</literal> or <literal>cat.getKittens().size()</literal>, for example. But that is confusing to readers of the code and is not convenient for generic code." +#. Tag: para +#: performance.xml:375 +#, no-c-format +msgid "" +"Sometimes we need to ensure that a proxy or collection is initialized before " +"closing the <literal>Session</literal>. Of course, we can alway force " +"initialization by calling <literal>cat.getSex()</literal> or <literal>cat." +"getKittens().size()</literal>, for example. But that is confusing to readers " +"of the code and is not convenient for generic code." msgstr "" +"Algumas vezes precisamos garantir qie o proxy ou coleção é inicializado " +"antes de se fechar a <literal>Session</literal>. Claro que sempre podemos " +"forçar a inicialização chamando <literal>cat.getSex()</literal> ou " +"<literal>cat.getKittens().size()</literal>, por exemplo. Mas isto parece " +"confuso para quem lê o código e não é conveniente para códigos genéricos." -#: index.docbook:382 -msgid "The static methods <literal>Hibernate.initialize()</literal> and <literal>Hibernate.isInitialized()</literal> provide the application with a convenient way of working with lazily initialized collections or proxies. <literal>Hibernate.initialize(cat)</literal> will force the initialization of a proxy, <literal>cat</literal>, as long as its <literal>Session</literal> is still open. <literal>Hibernate.initialize( cat.getKittens() )</literal> has a similar effect for the collection of kittens." +#. Tag: para +#: performance.xml:382 +#, no-c-format +msgid "" +"The static methods <literal>Hibernate.initialize()</literal> and " +"<literal>Hibernate.isInitialized()</literal> provide the application with a " +"convenient way of working with lazily initialized collections or proxies. " +"<literal>Hibernate.initialize(cat)</literal> will force the initialization " +"of a proxy, <literal>cat</literal>, as long as its <literal>Session</" +"literal> is still open. <literal>Hibernate.initialize( cat.getKittens() )</" +"literal> has a similar effect for the collection of kittens." msgstr "" +"Os métodos estáticos <literal>Hibernate.initialize()</literal> e " +"<literal>Hibernate.isInitialized()</literal> possibilitam a aplicação uma " +"maneira conveniente de trabalhar com coleções inicializadas preguiçosamente " +"e proxies. <literal>Hibernate.initialize(cat)</literal> irá forçar a " +"inicialização de um proxy, <literal>cat</literal>, contanto que a " +"<literal>Session</literal> esteja ainda aberta. <literal>Hibernate.initialize" +"( cat.getKittens() )</literal> tem um efeito similar para a coleção de " +"kittens." -#: index.docbook:391 -msgid "Another option is to keep the <literal>Session</literal> open until all needed collections and proxies have been loaded. In some application architectures, particularly where the code that accesses data using Hibernate, and the code that uses it are in different application layers or different physical processes, it can be a problem to ensure that the <literal>Session</literal> is open when a collection is initialized. There are two basic ways to deal with this issue:" +#. Tag: para +#: performance.xml:391 +#, no-c-format +msgid "" +"Another option is to keep the <literal>Session</literal> open until all " +"needed collections and proxies have been loaded. In some application " +"architectures, particularly where the code that accesses data using " +"Hibernate, and the code that uses it are in different application layers or " +"different physical processes, it can be a problem to ensure that the " +"<literal>Session</literal> is open when a collection is initialized. There " +"are two basic ways to deal with this issue:" msgstr "" +"Outra opção é manter a <literal>Session</literal> aberta até que todas as " +"coleções e proxies necessários sejam carregados. Em algumas arquiteturas de " +"aplicações, particularmente onde o código que acessa os dados usando " +"Hibernate e o código que usa os dados estão em diferentes camadas da " +"aplicação ou diferentes processos físicos, será um problema garantir que a " +"<literal>Session</literal> esteja aberta quando uma coleção for " +"inicializada. Existem dois caminhos básicos para lidar com esse problema:" -#: index.docbook:402 -msgid "In a web-based application, a servlet filter can be used to close the <literal>Session</literal> only at the very end of a user request, once the rendering of the view is complete (the <emphasis>Open Session in View</emphasis> pattern). Of course, this places heavy demands on the correctness of the exception handling of your application infrastructure. It is vitally important that the <literal>Session</literal> is closed and the transaction ended before returning to the user, even when an exception occurs during rendering of the view. See the Hibernate Wiki for examples of this \"Open Session in View\" pattern." +#. Tag: para +#: performance.xml:402 +#, no-c-format +msgid "" +"In a web-based application, a servlet filter can be used to close the " +"<literal>Session</literal> only at the very end of a user request, once the " +"rendering of the view is complete (the <emphasis>Open Session in View</" +"emphasis> pattern). Of course, this places heavy demands on the correctness " +"of the exception handling of your application infrastructure. It is vitally " +"important that the <literal>Session</literal> is closed and the transaction " +"ended before returning to the user, even when an exception occurs during " +"rendering of the view. See the Hibernate Wiki for examples of this \"Open " +"Session in View\" pattern." msgstr "" +"Em aplicações web, um filtro servlet pode ser usado para fechar a " +"<literal>Session</literal> somente no final da requisição do usuário, já que " +"a renderização da visão estará completa (o pattern <emphasis>Open Session In " +"View</emphasis>). Claro, que isto cria a necessidade de um correto manuseio " +"de exceções na infraestrutura de sua aplicação. É vitalmente importante que " +"a <literal>Session</literal> esteja fechada e a transação terminada antes de " +"retornar para o usuário, mesmo que uma exceção ocorra durante a renderização " +"da view. Veja o Wiki do Hibernate para exemplos do pattern \"Open Session In " +"View\"" -#: index.docbook:415 -msgid "In an application with a separate business tier, the business logic must \"prepare\" all collections that will be needed by the web tier before returning. This means that the business tier should load all the data and return all the data already initialized to the presentation/web tier that is required for a particular use case. Usually, the application calls <literal>Hibernate.initialize()</literal> for each collection that will be needed in the web tier (this call must occur before the session is closed) or retrieves the collection eagerly using a Hibernate query with a <literal>FETCH</literal> clause or a <literal>FetchMode.JOIN</literal> in <literal>Criteria</literal>. This is usually easier if you adopt the <emphasis>Command</emphasis> pattern instead of a <emphasis>Session Facade</emphasis>." +#. Tag: para +#: performance.xml:415 +#, no-c-format +msgid "" +"In an application with a separate business tier, the business logic must " +"\"prepare\" all collections that will be needed by the web tier before " +"returning. This means that the business tier should load all the data and " +"return all the data already initialized to the presentation/web tier that is " +"required for a particular use case. Usually, the application calls " +"<literal>Hibernate.initialize()</literal> for each collection that will be " +"needed in the web tier (this call must occur before the session is closed) " +"or retrieves the collection eagerly using a Hibernate query with a " +"<literal>FETCH</literal> clause or a <literal>FetchMode.JOIN</literal> in " +"<literal>Criteria</literal>. This is usually easier if you adopt the " +"<emphasis>Command</emphasis> pattern instead of a <emphasis>Session Facade</" +"emphasis>." msgstr "" +"Em uma aplicação com uma camada de negócios separada, a lógica de negócios " +"deve \"preparar\" todas as coleções que serão usadas pela camada web antes " +"de retornar. Isto sgnifica que a camada de negócios deve carregar todos os " +"dados e retorná-los já inicializados para a camada de apresentação. " +"Usualmente a aplicação chama <literal>Hibernate.initialize()</literal> para " +"cada coleção que será usada pela camada web (essa chamada de método deve " +"ocorrer antes da sessão ser fechada ou retornar a coleção usando uma " +"consulta Hibernate com uma cláusula <literal>FETCH</literal> ou um " +"<literal>FetchMode.JOIN</literal> na <literal>Criteria</literal>. Fica muito " +"mais fácil se você adotar o pattern <emphasis>Command</emphasis> ao invés do " +"<emphasis>Session Facade</emphasis>." -#: index.docbook:430 -msgid "You may also attach a previously loaded object to a new <literal>Session</literal> with <literal>merge()</literal> or <literal>lock()</literal> before accessing uninitialized collections (or other proxies). No, Hibernate does not, and certainly <emphasis>should</emphasis> not do this automatically, since it would introduce ad hoc transaction semantics!" +#. Tag: para +#: performance.xml:430 +#, no-c-format +msgid "" +"You may also attach a previously loaded object to a new <literal>Session</" +"literal> with <literal>merge()</literal> or <literal>lock()</literal> before " +"accessing uninitialized collections (or other proxies). No, Hibernate does " +"not, and certainly <emphasis>should</emphasis> not do this automatically, " +"since it would introduce ad hoc transaction semantics!" msgstr "" +"Você também pode anexar um objeto prevaimente carregado em uma nova " +"<literal>Session</literal><literal>merge()</literal> or <literal>lock()</" +"literal> antes de acessar coleções não inicializadas (ou outros proxies). O " +"Hibernate não faz e certamente <literal>não deve</literal> isso " +"automaticamente pois isso introduziria semantica em transações ad hoc." -#: index.docbook:440 -msgid "Sometimes you don't want to initialize a large collection, but still need some information about it (like its size) or a subset of the data." +#. Tag: para +#: performance.xml:440 +#, no-c-format +msgid "" +"Sometimes you don't want to initialize a large collection, but still need " +"some information about it (like its size) or a subset of the data." msgstr "" +"As vezes você não quer inicializar uma coleção muito grande, mas precisa de " +"algumas informações (como o tamanho) ou alguns de seus dados." -#: index.docbook:445 -msgid "You can use a collection filter to get the size of a collection without initializing it:" +#. Tag: para +#: performance.xml:445 +#, no-c-format +msgid "" +"You can use a collection filter to get the size of a collection without " +"initializing it:" msgstr "" +"Você pode usar um filtro de coleção para saber seu tamanho sem a inicializar:" -#: index.docbook:449 -msgid "<![CDATA[( (Integer) s.createFilter( collection, \"select count(*)\" ).list().get(0) ).intValue()]]>" +#. Tag: programlisting +#: performance.xml:449 +#, no-c-format +msgid "" +"<![CDATA[( (Integer) s.createFilter( collection, \"select count(*)\" ).list" +"().get(0) ).intValue()]]>" msgstr "" -#: index.docbook:451 -msgid "The <literal>createFilter()</literal> method is also used to efficiently retrieve subsets of a collection without needing to initialize the whole collection:" +#. Tag: para +#: performance.xml:451 +#, no-c-format +msgid "" +"The <literal>createFilter()</literal> method is also used to efficiently " +"retrieve subsets of a collection without needing to initialize the whole " +"collection:" msgstr "" +"O método <literal>createFilter()</literal> é usado também para retornar " +"algus dados de uma coleção eficientemente sem precisar inicializar a coleção " +"inteira:" -#: index.docbook:456 -msgid "<![CDATA[s.createFilter( lazyCollection, \"\").setFirstResult(0).setMaxResults(10).list();]]>" +#. Tag: programlisting +#: performance.xml:456 +#, no-c-format +msgid "" +"<![CDATA[s.createFilter( lazyCollection, \"\").setFirstResult(0)." +"setMaxResults(10).list();]]>" msgstr "" -#: index.docbook:461 +#. Tag: title +#: performance.xml:461 +#, no-c-format msgid "Using batch fetching" -msgstr "" +msgstr "Usando busca em lote" -#: index.docbook:463 -msgid "Hibernate can make efficient use of batch fetching, that is, Hibernate can load several uninitialized proxies if one proxy is accessed (or collections. Batch fetching is an optimization of the lazy select fetching strategy. There are two ways you can tune batch fetching: on the class and the collection level." +#. Tag: para +#: performance.xml:463 +#, no-c-format +msgid "" +"Hibernate can make efficient use of batch fetching, that is, Hibernate can " +"load several uninitialized proxies if one proxy is accessed (or collections. " +"Batch fetching is an optimization of the lazy select fetching strategy. " +"There are two ways you can tune batch fetching: on the class and the " +"collection level." msgstr "" +"O Hibernate pode fazer uso eficiente de busca em lote, isto é, o Hibernate " +"pode carregar diversos proxies não inicializados se um proxy é acessado (ou " +"coleções. A busca em lote é uma otimização da estratégia de select " +"fetching). Existe duas maneiras em que você pode usar busca em lote: no " +"nível da classe ou no nível da coleção." -#: index.docbook:469 -msgid "Batch fetching for classes/entities is easier to understand. Imagine you have the following situation at runtime: You have 25 <literal>Cat</literal> instances loaded in a <literal>Session</literal>, each <literal>Cat</literal> has a reference to its <literal>owner</literal>, a <literal>Person</literal>. The <literal>Person</literal> class is mapped with a proxy, <literal>lazy=\"true\"</literal>. If you now iterate through all cats and call <literal>getOwner()</literal> on each, Hibernate will by default execute 25 <literal>SELECT</literal> statements, to retrieve the proxied owners. You can tune this behavior by specifying a <literal>batch-size</literal> in the mapping of <literal>Person</literal>:" +#. Tag: para +#: performance.xml:469 +#, no-c-format +msgid "" +"Batch fetching for classes/entities is easier to understand. Imagine you " +"have the following situation at runtime: You have 25 <literal>Cat</literal> " +"instances loaded in a <literal>Session</literal>, each <literal>Cat</" +"literal> has a reference to its <literal>owner</literal>, a <literal>Person</" +"literal>. The <literal>Person</literal> class is mapped with a proxy, " +"<literal>lazy=\"true\"</literal>. If you now iterate through all cats and " +"call <literal>getOwner()</literal> on each, Hibernate will by default " +"execute 25 <literal>SELECT</literal> statements, to retrieve the proxied " +"owners. You can tune this behavior by specifying a <literal>batch-size</" +"literal> in the mapping of <literal>Person</literal>:" msgstr "" +"A recuperação em lote para classes/entidades é mais fácil de entender. " +"Imagine que você tem a seguinte situação em tempo de execução: Você tem 25 " +"instâncias de <literal>Cat</literal> carregadas em uma <literal>Session</" +"literal>, cada <literal>Cat</literal> tem uma referência ao seu " +"<literal>owner</literal>, que é da classe <literal>Person</literal>. A " +"classe <literal>Person</literal> é mapeada com um proxy, <literal>lazy=\"true" +"\"</literal>. Se você iterar sobre todos os Cat's e chamar <literal>getOwner" +"()</literal> em cada, o Hibernate irá por padrão executar 25 comandos " +"<literal>SELECT()</literal>, para buscar os proxies de owners. Você pode " +"melhorar esse comportamento especificando um <literal>batch-size</literal> " +"no mapeamento da classe <literal>Person</literal>:" -#: index.docbook:479 +#. Tag: programlisting +#: performance.xml:479 +#, no-c-format msgid "<![CDATA[<class name=\"Person\" batch-size=\"10\">...</class>]]>" msgstr "" -#: index.docbook:481 -msgid "Hibernate will now execute only three queries, the pattern is 10, 10, 5." +#. Tag: para +#: performance.xml:481 +#, no-c-format +msgid "" +"Hibernate will now execute only three queries, the pattern is 10, 10, 5." msgstr "" +"O Hibernate irá executar agora apenas três consultas, buscando por vez, 10, " +"10 e 5 Person." -#: index.docbook:485 -msgid "You may also enable batch fetching of collections. For example, if each <literal>Person</literal> has a lazy collection of <literal>Cat</literal>s, and 10 persons are currently loaded in the <literal>Sesssion</literal>, iterating through all persons will generate 10 <literal>SELECT</literal>s, one for every call to <literal>getCats()</literal>. If you enable batch fetching for the <literal>cats</literal> collection in the mapping of <literal>Person</literal>, Hibernate can pre-fetch collections:" +#. Tag: para +#: performance.xml:485 +#, no-c-format +msgid "" +"You may also enable batch fetching of collections. For example, if each " +"<literal>Person</literal> has a lazy collection of <literal>Cat</literal>s, " +"and 10 persons are currently loaded in the <literal>Sesssion</literal>, " +"iterating through all persons will generate 10 <literal>SELECT</literal>s, " +"one for every call to <literal>getCats()</literal>. If you enable batch " +"fetching for the <literal>cats</literal> collection in the mapping of " +"<literal>Person</literal>, Hibernate can pre-fetch collections:" msgstr "" +"Você também pode habilitar busca em lote de uma coleção. Por exemplo, se " +"cada <literal>Person</literal> tem uma coleção preguiçosa de <literal>Cat</" +"literal>s, e 10 pessoas estão já carregados em uma <literal>Sesssion</" +"literal>, serão gerados 10 <literal>SELECT</literal>s ao se iterar todas as " +"pessoas, um para cada chamada de <literal>getCats()</literal>.. Se você " +"habilitar busca em lote para a coleção de <literal>cats</literal> no " +"mapeamento da classe <literal>Person</literal>, o Hibernate pode fazer uma " +"pré carga das coleções:" -#: index.docbook:494 +#. Tag: programlisting +#: performance.xml:494 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <set name=\"cats\" batch-size=\"3\">\n" - " ...\n" - " </set>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <set name=\"cats\" batch-size=\"3\">\n" +" ...\n" +" </set>\n" +"</class>]]>" msgstr "" -#: index.docbook:496 -msgid "With a <literal>batch-size</literal> of 3, Hibernate will load 3, 3, 3, 1 collections in four <literal>SELECT</literal>s. Again, the value of the attribute depends on the expected number of uninitialized collections in a particular <literal>Session</literal>." +#. Tag: para +#: performance.xml:496 +#, no-c-format +msgid "" +"With a <literal>batch-size</literal> of 3, Hibernate will load 3, 3, 3, 1 " +"collections in four <literal>SELECT</literal>s. Again, the value of the " +"attribute depends on the expected number of uninitialized collections in a " +"particular <literal>Session</literal>." msgstr "" +"Com um <literal>batch-size</literal> de 3, o Hibernate irá carregar 3, 3, 3, " +"1 coleções em 4 <literal>SELECT</literal>s. Novamente, o valor do atributo " +"depende do número esperado de coleções não inicialiadas em determinada " +"<literal>Session</literal>." -#: index.docbook:502 -msgid "Batch fetching of collections is particularly useful if you have a nested tree of items, ie. the typical bill-of-materials pattern. (Although a <emphasis>nested set</emphasis> or a <emphasis>materialized path</emphasis> might be a better option for read-mostly trees.)" +#. Tag: para +#: performance.xml:502 +#, no-c-format +msgid "" +"Batch fetching of collections is particularly useful if you have a nested " +"tree of items, ie. the typical bill-of-materials pattern. (Although a " +"<emphasis>nested set</emphasis> or a <emphasis>materialized path</emphasis> " +"might be a better option for read-mostly trees.)" msgstr "" +"A busca em lote de coleções é particularmente útil quando você tem uma " +"árvore encadeada de items, ex. o típico padrão bill-of-materials (Se bem que " +"um <emphasis>conjunto encadeado</emphasis> ou <emphasis>caminho " +"materializado </emphasis> pode ser uma opção melhor para árvores com mais " +"leitura)" -#: index.docbook:511 +#. Tag: title +#: performance.xml:511 +#, no-c-format msgid "Using subselect fetching" -msgstr "" +msgstr "Usando subselect fetching" -#: index.docbook:513 -msgid "If one lazy collection or single-valued proxy has to be fetched, Hibernate loads all of them, re-running the original query in a subselect. This works in the same way as batch-fetching, without the piecemeal loading." +#. Tag: para +#: performance.xml:513 +#, no-c-format +msgid "" +"If one lazy collection or single-valued proxy has to be fetched, Hibernate " +"loads all of them, re-running the original query in a subselect. This works " +"in the same way as batch-fetching, without the piecemeal loading." msgstr "" +"Se uma coleção ou proxy simples precisa ser recuperado, o Hibernate carrega " +"todos eles rodando novamente a query original em um subselect. Isso funciona " +"da mesma maneira que busca em lote, sem carregar tanto." -#: index.docbook:524 +#. Tag: title +#: performance.xml:524 +#, no-c-format msgid "Using lazy property fetching" -msgstr "" +msgstr "Usando busca preguiçosa de propriedade" -#: index.docbook:526 -msgid "Hibernate3 supports the lazy fetching of individual properties. This optimization technique is also known as <emphasis>fetch groups</emphasis>. Please note that this is mostly a marketing feature, as in practice, optimizing row reads is much more important than optimization of column reads. However, only loading some properties of a class might be useful in extreme cases, when legacy tables have hundreds of columns and the data model can not be improved." +#. Tag: para +#: performance.xml:526 +#, no-c-format +msgid "" +"Hibernate3 supports the lazy fetching of individual properties. This " +"optimization technique is also known as <emphasis>fetch groups</emphasis>. " +"Please note that this is mostly a marketing feature, as in practice, " +"optimizing row reads is much more important than optimization of column " +"reads. However, only loading some properties of a class might be useful in " +"extreme cases, when legacy tables have hundreds of columns and the data " +"model can not be improved." msgstr "" +"O Hibernate3 suporta a carga posterior de propriedades individuais. Essa " +"técnica de otimização também conhecida como <emphasis>fetch groups</" +"emphasis>. Veja que isso é mais uma funcionalidade de marketing já que na " +"prática, é mais importante otimização nas leituras dos registros do que na " +"leitura das colunas. Porém, carregar apenas algumas propriedades de uma " +"classe pode ser útil em casos extremos, onde tabelas legadas podem ter " +"centenas de colunas e o modelo de dados não pode ser melhorado." -#: index.docbook:535 -msgid "To enable lazy property loading, set the <literal>lazy</literal> attribute on your particular property mappings:" +#. Tag: para +#: performance.xml:535 +#, no-c-format +msgid "" +"To enable lazy property loading, set the <literal>lazy</literal> attribute " +"on your particular property mappings:" msgstr "" +"Para habilitar a carga posterior de propriedade, é preciso setar o atributo " +"<literal>lazy</literal> no seu mapeamento de propriedade:" -#: index.docbook:540 +#. Tag: programlisting +#: performance.xml:540 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Document\">\n" - " <id name=\"id\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"name\" not-null=\"true\" length=\"50\"/>\n" - " <property name=\"summary\" not-null=\"true\" length=\"200\" lazy=\"true\"/>\n" - " <property name=\"text\" not-null=\"true\" length=\"2000\" lazy=\"true\"/>\n" - "</class>]]>" +"<![CDATA[<class name=\"Document\">\n" +" <id name=\"id\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <property name=\"name\" not-null=\"true\" length=\"50\"/>\n" +" <property name=\"summary\" not-null=\"true\" length=\"200\" lazy=\"true" +"\"/>\n" +" <property name=\"text\" not-null=\"true\" length=\"2000\" lazy=\"true\"/" +">\n" +"</class>]]>" msgstr "" -#: index.docbook:542 -msgid "Lazy property loading requires buildtime bytecode instrumentation! If your persistent classes are not enhanced, Hibernate will silently ignore lazy property settings and fall back to immediate fetching." +#. Tag: para +#: performance.xml:542 +#, no-c-format +msgid "" +"Lazy property loading requires buildtime bytecode instrumentation! If your " +"persistent classes are not enhanced, Hibernate will silently ignore lazy " +"property settings and fall back to immediate fetching." msgstr "" +"A carga posterior de propriedades requer instrumentação de bytecode! Se suas " +"classes persistentes não forem melhoradas, o Hibernate irá ignorar " +"silenciosamente essa configuração e usará busca imediatamente." -#: index.docbook:548 +#. Tag: para +#: performance.xml:548 +#, no-c-format msgid "For bytecode instrumentation, use the following Ant task:" -msgstr "" +msgstr "Para instrumentação de bytecode, use a seguinte tarefa do Ant:" -#: index.docbook:552 +#. Tag: programlisting +#: performance.xml:552 +#, no-c-format msgid "" - "<![CDATA[<target name=\"instrument\" depends=\"compile\">\n" - " <taskdef name=\"instrument\" classname=\"org.hibernate.tool.instrument.InstrumentTask\">\n" - " <classpath path=\"${jar.path}\"/>\n" - " <classpath path=\"${classes.dir}\"/>\n" - " <classpath refid=\"lib.class.path\"/>\n" - " </taskdef>\n" - "\n" - " <instrument verbose=\"true\">\n" - " <fileset dir=\"${testclasses.dir}/org/hibernate/auction/model\">\n" - " <include name=\"*.class\"/>\n" - " </fileset>\n" - " </instrument>\n" - "</target>]]>" +"<![CDATA[<target name=\"instrument\" depends=\"compile\">\n" +" <taskdef name=\"instrument\" classname=\"org.hibernate.tool.instrument." +"InstrumentTask\">\n" +" <classpath path=\"${jar.path}\"/>\n" +" <classpath path=\"${classes.dir}\"/>\n" +" <classpath refid=\"lib.class.path\"/>\n" +" </taskdef>\n" +"\n" +" <instrument verbose=\"true\">\n" +" <fileset dir=\"${testclasses.dir}/org/hibernate/auction/model\">\n" +" <include name=\"*.class\"/>\n" +" </fileset>\n" +" </instrument>\n" +"</target>]]>" msgstr "" -#: index.docbook:554 -msgid "A different (better?) way to avoid unnecessary column reads, at least for read-only transactions is to use the projection features of HQL or Criteria queries. This avoids the need for buildtime bytecode processing and is certainly a prefered solution." +#. Tag: para +#: performance.xml:554 +#, no-c-format +msgid "" +"A different (better?) way to avoid unnecessary column reads, at least for " +"read-only transactions is to use the projection features of HQL or Criteria " +"queries. This avoids the need for buildtime bytecode processing and is " +"certainly a prefered solution." msgstr "" +"A different (better?) way to avoid unnecessary column reads, at least for " +"read-only transactions is to use the projection features of HQL or Criteria " +"queries. This avoids the need for buildtime bytecode processing and is " +"certainly a prefered solution." -#: index.docbook:561 -msgid "You may force the usual eager fetching of properties using <literal>fetch all properties</literal> in HQL." +#. Tag: para +#: performance.xml:561 +#, no-c-format +msgid "" +"You may force the usual eager fetching of properties using <literal>fetch " +"all properties</literal> in HQL." msgstr "" +"You may force the usual eager fetching of properties using <literal>fetch " +"all properties</literal> in HQL." -#: index.docbook:571 +#. Tag: title +#: performance.xml:571 +#, no-c-format msgid "The Second Level Cache" -msgstr "" +msgstr "The Second Level Cache" -#: index.docbook:573 -msgid "A Hibernate <literal>Session</literal> is a transaction-level cache of persistent data. It is possible to configure a cluster or JVM-level (<literal>SessionFactory</literal>-level) cache on a class-by-class and collection-by-collection basis. You may even plug in a clustered cache. Be careful. Caches are never aware of changes made to the persistent store by another application (though they may be configured to regularly expire cached data)." +#. Tag: para +#: performance.xml:573 +#, no-c-format +msgid "" +"A Hibernate <literal>Session</literal> is a transaction-level cache of " +"persistent data. It is possible to configure a cluster or JVM-level " +"(<literal>SessionFactory</literal>-level) cache on a class-by-class and " +"collection-by-collection basis. You may even plug in a clustered cache. Be " +"careful. Caches are never aware of changes made to the persistent store by " +"another application (though they may be configured to regularly expire " +"cached data)." msgstr "" +"A Hibernate <literal>Session</literal> is a transaction-level cache of " +"persistent data. It is possible to configure a cluster or JVM-level " +"(<literal>SessionFactory</literal>-level) cache on a class-by-class and " +"collection-by-collection basis. You may even plug in a clustered cache. Be " +"careful. Caches are never aware of changes made to the persistent store by " +"another application (though they may be configured to regularly expire " +"cached data)." -#: index.docbook:581 -msgid "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." +#. Tag: para +#: performance.xml:581 +#, no-c-format +msgid "" +"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." msgstr "" +"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." -#: index.docbook:592 +#. Tag: title +#: performance.xml:592 +#, no-c-format msgid "Cache Providers" -msgstr "" +msgstr "Cache Providers" -#: index.docbook:601, index.docbook:774 +#. Tag: entry +#: performance.xml:601 performance.xml:774 +#, no-c-format msgid "Cache" -msgstr "" +msgstr "Cache" -#: index.docbook:602 +#. Tag: entry +#: performance.xml:602 +#, no-c-format msgid "Provider class" -msgstr "" +msgstr "Provider class" -#: index.docbook:603 +#. Tag: entry +#: performance.xml:603 +#, no-c-format msgid "Type" -msgstr "" +msgstr "Type" -#: index.docbook:604 +#. Tag: entry +#: performance.xml:604 +#, no-c-format msgid "Cluster Safe" -msgstr "" +msgstr "Cluster Safe" -#: index.docbook:605 +#. Tag: entry +#: performance.xml:605 +#, no-c-format msgid "Query Cache Supported" -msgstr "" +msgstr "Query Cache Supported" -#: index.docbook:610, index.docbook:783 +#. Tag: entry +#: performance.xml:610 performance.xml:783 +#, no-c-format msgid "Hashtable (not intended for production use)" -msgstr "" +msgstr "Hashtable (not intended for production use)" -#: index.docbook:611 +#. Tag: literal +#: performance.xml:611 +#, no-c-format msgid "org.hibernate.cache.HashtableCacheProvider" -msgstr "" +msgstr "org.hibernate.cache.HashtableCacheProvider" -#: index.docbook:612 +#. Tag: entry +#: performance.xml:612 +#, no-c-format msgid "memory" -msgstr "" +msgstr "memory" -#: index.docbook:614, index.docbook:621, index.docbook:628, index.docbook:784, index.docbook:785, index.docbook:786, index.docbook:791, index.docbook:792, index.docbook:793, index.docbook:798, index.docbook:799, index.docbook:800, index.docbook:805, index.docbook:806, index.docbook:812, index.docbook:815 +#. Tag: entry +#: performance.xml:614 performance.xml:621 performance.xml:628 +#: performance.xml:784 performance.xml:785 performance.xml:786 +#: performance.xml:791 performance.xml:792 performance.xml:793 +#: performance.xml:798 performance.xml:799 performance.xml:800 +#: performance.xml:805 performance.xml:806 performance.xml:812 +#: performance.xml:815 +#, no-c-format msgid "<entry>yes</entry>" msgstr "" -#: index.docbook:617, index.docbook:790 +#. Tag: entry +#: performance.xml:617 performance.xml:790 +#, no-c-format msgid "EHCache" -msgstr "" +msgstr "EHCache" -#: index.docbook:618 +#. Tag: literal +#: performance.xml:618 +#, no-c-format msgid "org.hibernate.cache.EhCacheProvider" -msgstr "" +msgstr "org.hibernate.cache.EhCacheProvider" -#: index.docbook:619, index.docbook:626 +#. Tag: entry +#: performance.xml:619 performance.xml:626 +#, no-c-format msgid "memory, disk" -msgstr "" +msgstr "memory, disk" -#: index.docbook:624, index.docbook:797 +#. Tag: entry +#: performance.xml:624 performance.xml:797 +#, no-c-format msgid "OSCache" -msgstr "" +msgstr "OSCache" -#: index.docbook:625 +#. Tag: literal +#: performance.xml:625 +#, no-c-format msgid "org.hibernate.cache.OSCacheProvider" -msgstr "" +msgstr "org.hibernate.cache.OSCacheProvider" -#: index.docbook:631, index.docbook:804 +#. Tag: entry +#: performance.xml:631 performance.xml:804 +#, no-c-format msgid "SwarmCache" -msgstr "" +msgstr "SwarmCache" -#: index.docbook:632 +#. Tag: literal +#: performance.xml:632 +#, no-c-format msgid "org.hibernate.cache.SwarmCacheProvider" -msgstr "" +msgstr "org.hibernate.cache.SwarmCacheProvider" -#: index.docbook:633 +#. Tag: entry +#: performance.xml:633 +#, no-c-format msgid "clustered (ip multicast)" -msgstr "" +msgstr "clustered (ip multicast)" -#: index.docbook:634 +#. Tag: entry +#: performance.xml:634 +#, no-c-format msgid "yes (clustered invalidation)" -msgstr "" +msgstr "yes (clustered invalidation)" -#: index.docbook:638, index.docbook:811 +#. Tag: entry +#: performance.xml:638 performance.xml:811 +#, no-c-format msgid "JBoss TreeCache" -msgstr "" +msgstr "JBoss TreeCache" -#: index.docbook:639 +#. Tag: literal +#: performance.xml:639 +#, no-c-format msgid "org.hibernate.cache.TreeCacheProvider" -msgstr "" +msgstr "org.hibernate.cache.TreeCacheProvider" -#: index.docbook:640 +#. Tag: entry +#: performance.xml:640 +#, no-c-format msgid "clustered (ip multicast), transactional" -msgstr "" +msgstr "clustered (ip multicast), transactional" -#: index.docbook:641 +#. Tag: entry +#: performance.xml:641 +#, no-c-format msgid "yes (replication)" -msgstr "" +msgstr "yes (replication)" -#: index.docbook:642 +#. Tag: entry +#: performance.xml:642 +#, no-c-format msgid "yes (clock sync req.)" -msgstr "" +msgstr "yes (clock sync req.)" -#: index.docbook:649 +#. Tag: title +#: performance.xml:649 +#, no-c-format msgid "Cache mappings" -msgstr "" +msgstr "Cache mappings" -#: index.docbook:651 -msgid "The <literal><cache></literal> element of a class or collection mapping has the following form:" +#. Tag: para +#: performance.xml:651 +#, no-c-format +msgid "" +"The <literal><cache></literal> element of a class or collection " +"mapping has the following form:" msgstr "" +"The <literal><cache></literal> element of a class or collection " +"mapping has the following form:" -#: index.docbook:662 +#. Tag: programlisting +#: performance.xml:662 +#, no-c-format msgid "" - "<![CDATA[<cache \n" - " usage=\"transactional|read-write|nonstrict-read-write|read-only\"\n" - " region=\"RegionName\"\n" - " include=\"all|non-lazy\"\n" - "/>]]>" +"<![CDATA[<cache \n" +" usage=\"transactional|read-write|nonstrict-read-write|read-only\"\n" +" region=\"RegionName\"\n" +" include=\"all|non-lazy\"\n" +"/>]]>" msgstr "" -#: index.docbook:665 -msgid "<literal>usage</literal> (required) specifies the caching strategy: <literal>transactional</literal>, <literal>read-write</literal>, <literal>nonstrict-read-write</literal> or <literal>read-only</literal>" +#. Tag: para +#: performance.xml:665 +#, no-c-format +msgid "" +"<literal>usage</literal> (required) specifies the caching strategy: " +"<literal>transactional</literal>, <literal>read-write</literal>, " +"<literal>nonstrict-read-write</literal> or <literal>read-only</literal>" msgstr "" +"<literal>usage</literal> (required) specifies the caching strategy: " +"<literal>transactional</literal>, <literal>read-write</literal>, " +"<literal>nonstrict-read-write</literal> or <literal>read-only</literal>" -#: index.docbook:674 -msgid "<literal>region</literal> (optional, defaults to the class or collection role name) specifies the name of the second level cache region" +#. Tag: para +#: performance.xml:674 +#, no-c-format +msgid "" +"<literal>region</literal> (optional, defaults to the class or collection " +"role name) specifies the name of the second level cache region" msgstr "" +"<literal>region</literal> (optional, defaults to the class or collection " +"role name) specifies the name of the second level cache region" -#: index.docbook:681 -msgid "<literal>include</literal> (optional, defaults to <literal>all</literal>) <literal>non-lazy</literal> specifies that properties of the entity mapped with <literal>lazy=\"true\"</literal> may not be cached when attribute-level lazy fetching is enabled" +#. Tag: para +#: performance.xml:681 +#, no-c-format +msgid "" +"<literal>include</literal> (optional, defaults to <literal>all</literal>) " +"<literal>non-lazy</literal> specifies that properties of the entity mapped " +"with <literal>lazy=\"true\"</literal> may not be cached when attribute-level " +"lazy fetching is enabled" msgstr "" +"<literal>include</literal> (optional, defaults to <literal>all</literal>) " +"<literal>non-lazy</literal> specifies that properties of the entity mapped " +"with <literal>lazy=\"true\"</literal> may not be cached when attribute-level " +"lazy fetching is enabled" -#: index.docbook:691 -msgid "Alternatively (preferrably?), you may specify <literal><class-cache></literal> and <literal><collection-cache></literal> elements in <literal>hibernate.cfg.xml</literal>." +#. Tag: para +#: performance.xml:691 +#, no-c-format +msgid "" +"Alternatively (preferrably?), you may specify <literal><class-cache></" +"literal> and <literal><collection-cache></literal> elements in " +"<literal>hibernate.cfg.xml</literal>." msgstr "" +"Alternatively (preferrably?), you may specify <literal><class-cache></" +"literal> and <literal><collection-cache></literal> elements in " +"<literal>hibernate.cfg.xml</literal>." -#: index.docbook:696 -msgid "The <literal>usage</literal> attribute specifies a <emphasis>cache concurrency strategy</emphasis>." +#. Tag: para +#: performance.xml:696 +#, no-c-format +msgid "" +"The <literal>usage</literal> attribute specifies a <emphasis>cache " +"concurrency strategy</emphasis>." msgstr "" +"The <literal>usage</literal> attribute specifies a <emphasis>cache " +"concurrency strategy</emphasis>." -#: index.docbook:703 +#. Tag: title +#: performance.xml:703 +#, no-c-format msgid "Strategy: read only" -msgstr "" +msgstr "Strategy: read only" -#: index.docbook:705 -msgid "If your application needs to read but never modify instances of a persistent class, a <literal>read-only</literal> cache may be used. This is the simplest and best performing strategy. It's even perfectly safe for use in a cluster." +#. Tag: para +#: performance.xml:705 +#, no-c-format +msgid "" +"If your application needs to read but never modify instances of a persistent " +"class, a <literal>read-only</literal> cache may be used. This is the " +"simplest and best performing strategy. It's even perfectly safe for use in a " +"cluster." msgstr "" +"If your application needs to read but never modify instances of a persistent " +"class, a <literal>read-only</literal> cache may be used. This is the " +"simplest and best performing strategy. It's even perfectly safe for use in a " +"cluster." -#: index.docbook:711 +#. Tag: programlisting +#: performance.xml:711 +#, no-c-format msgid "" - "<![CDATA[<class name=\"eg.Immutable\" mutable=\"false\">\n" - " <cache usage=\"read-only\"/>\n" - " ....\n" - "</class>]]>" +"<![CDATA[<class name=\"eg.Immutable\" mutable=\"false\">\n" +" <cache usage=\"read-only\"/>\n" +" ....\n" +"</class>]]>" msgstr "" -#: index.docbook:717 +#. Tag: title +#: performance.xml:717 +#, no-c-format msgid "Strategy: read/write" -msgstr "" +msgstr "Strategy: read/write" -#: index.docbook:719 -msgid "If the application needs to update data, a <literal>read-write</literal> cache might be appropriate. This cache strategy should never be used if serializable transaction isolation level is required. If the cache is used in a JTA environment, you must specify the property <literal>hibernate.transaction.manager_lookup_class</literal>, naming a strategy for obtaining the JTA <literal>TransactionManager</literal>. In other environments, you should ensure that the transaction is completed when <literal>Session.close()</literal> or <literal>Session.disconnect()</literal> is called. If you wish to use this strategy in a cluster, you should ensure that the underlying cache implementation supports locking. The built-in cache providers do <emphasis>not</emphasis>." +#. Tag: para +#: performance.xml:719 +#, no-c-format +msgid "" +"If the application needs to update data, a <literal>read-write</literal> " +"cache might be appropriate. This cache strategy should never be used if " +"serializable transaction isolation level is required. If the cache is used " +"in a JTA environment, you must specify the property <literal>hibernate." +"transaction.manager_lookup_class</literal>, naming a strategy for obtaining " +"the JTA <literal>TransactionManager</literal>. In other environments, you " +"should ensure that the transaction is completed when <literal>Session.close()" +"</literal> or <literal>Session.disconnect()</literal> is called. If you wish " +"to use this strategy in a cluster, you should ensure that the underlying " +"cache implementation supports locking. The built-in cache providers do " +"<emphasis>not</emphasis>." msgstr "" +"If the application needs to update data, a <literal>read-write</literal> " +"cache might be appropriate. This cache strategy should never be used if " +"serializable transaction isolation level is required. If the cache is used " +"in a JTA environment, you must specify the property <literal>hibernate." +"transaction.manager_lookup_class</literal>, naming a strategy for obtaining " +"the JTA <literal>TransactionManager</literal>. In other environments, you " +"should ensure that the transaction is completed when <literal>Session.close()" +"</literal> or <literal>Session.disconnect()</literal> is called. If you wish " +"to use this strategy in a cluster, you should ensure that the underlying " +"cache implementation supports locking. The built-in cache providers do " +"<emphasis>not</emphasis>." -#: index.docbook:730 +#. Tag: programlisting +#: performance.xml:730 +#, no-c-format msgid "" - "<![CDATA[<class name=\"eg.Cat\" .... >\n" - " <cache usage=\"read-write\"/>\n" - " ....\n" - " <set name=\"kittens\" ... >\n" - " <cache usage=\"read-write\"/>\n" - " ....\n" - " </set>\n" - "</class>]]>" +"<![CDATA[<class name=\"eg.Cat\" .... >\n" +" <cache usage=\"read-write\"/>\n" +" ....\n" +" <set name=\"kittens\" ... >\n" +" <cache usage=\"read-write\"/>\n" +" ....\n" +" </set>\n" +"</class>]]>" msgstr "" -#: index.docbook:735 +#. Tag: title +#: performance.xml:735 +#, no-c-format msgid "Strategy: nonstrict read/write" -msgstr "" +msgstr "Strategy: nonstrict read/write" -#: index.docbook:737 -msgid "If the application only occasionally needs to update data (ie. if it is extremely unlikely that two transactions would try to update the same item simultaneously) and strict transaction isolation is not required, a <literal>nonstrict-read-write</literal> cache might be appropriate. If the cache is used in a JTA environment, you must specify <literal>hibernate.transaction.manager_lookup_class</literal>. In other environments, you should ensure that the transaction is completed when <literal>Session.close()</literal> or <literal>Session.disconnect()</literal> is called." +#. Tag: para +#: performance.xml:737 +#, no-c-format +msgid "" +"If the application only occasionally needs to update data (ie. if it is " +"extremely unlikely that two transactions would try to update the same item " +"simultaneously) and strict transaction isolation is not required, a " +"<literal>nonstrict-read-write</literal> cache might be appropriate. If the " +"cache is used in a JTA environment, you must specify <literal>hibernate." +"transaction.manager_lookup_class</literal>. In other environments, you " +"should ensure that the transaction is completed when <literal>Session.close()" +"</literal> or <literal>Session.disconnect()</literal> is called." msgstr "" +"If the application only occasionally needs to update data (ie. if it is " +"extremely unlikely that two transactions would try to update the same item " +"simultaneously) and strict transaction isolation is not required, a " +"<literal>nonstrict-read-write</literal> cache might be appropriate. If the " +"cache is used in a JTA environment, you must specify <literal>hibernate." +"transaction.manager_lookup_class</literal>. In other environments, you " +"should ensure that the transaction is completed when <literal>Session.close()" +"</literal> or <literal>Session.disconnect()</literal> is called." -#: index.docbook:749 +#. Tag: title +#: performance.xml:749 +#, no-c-format msgid "Strategy: transactional" -msgstr "" +msgstr "Strategy: transactional" -#: index.docbook:751 -msgid "The <literal>transactional</literal> cache strategy provides support for fully transactional cache providers such as JBoss TreeCache. Such a cache may only be used in a JTA environment and you must specify <literal>hibernate.transaction.manager_lookup_class</literal>." +#. Tag: para +#: performance.xml:751 +#, no-c-format +msgid "" +"The <literal>transactional</literal> cache strategy provides support for " +"fully transactional cache providers such as JBoss TreeCache. Such a cache " +"may only be used in a JTA environment and you must specify " +"<literal>hibernate.transaction.manager_lookup_class</literal>." msgstr "" +"The <literal>transactional</literal> cache strategy provides support for " +"fully transactional cache providers such as JBoss TreeCache. Such a cache " +"may only be used in a JTA environment and you must specify " +"<literal>hibernate.transaction.manager_lookup_class</literal>." -#: index.docbook:759 -msgid "None of the cache providers support all of the cache concurrency strategies. The following table shows which providers are compatible with which concurrency strategies." +#. Tag: para +#: performance.xml:759 +#, no-c-format +msgid "" +"None of the cache providers support all of the cache concurrency strategies. " +"The following table shows which providers are compatible with which " +"concurrency strategies." msgstr "" +"None of the cache providers support all of the cache concurrency strategies. " +"The following table shows which providers are compatible with which " +"concurrency strategies." -#: index.docbook:765 +#. Tag: title +#: performance.xml:765 +#, no-c-format msgid "Cache Concurrency Strategy Support" -msgstr "" +msgstr "Cache Concurrency Strategy Support" -#: index.docbook:775 +#. Tag: entry +#: performance.xml:775 +#, no-c-format msgid "read-only" -msgstr "" +msgstr "read-only" -#: index.docbook:776 +#. Tag: entry +#: performance.xml:776 +#, no-c-format msgid "nonstrict-read-write" -msgstr "" +msgstr "nonstrict-read-write" -#: index.docbook:777 +#. Tag: entry +#: performance.xml:777 +#, no-c-format msgid "read-write" -msgstr "" +msgstr "read-write" -#: index.docbook:778 +#. Tag: entry +#: performance.xml:778 +#, no-c-format msgid "transactional" -msgstr "" +msgstr "transactional" -#: index.docbook:824 +#. Tag: title +#: performance.xml:824 +#, no-c-format msgid "Managing the caches" -msgstr "" +msgstr "Managing the caches" -#: index.docbook:826 -msgid "Whenever you pass an object to <literal>save()</literal>, <literal>update()</literal> or <literal>saveOrUpdate()</literal> and whenever you retrieve an object using <literal>load()</literal>, <literal>get()</literal>, <literal>list()</literal>, <literal>iterate()</literal> or <literal>scroll()</literal>, that object is added to the internal cache of the <literal>Session</literal>." +#. Tag: para +#: performance.xml:826 +#, no-c-format +msgid "" +"Whenever you pass an object to <literal>save()</literal>, <literal>update()</" +"literal> or <literal>saveOrUpdate()</literal> and whenever you retrieve an " +"object using <literal>load()</literal>, <literal>get()</literal>, " +"<literal>list()</literal>, <literal>iterate()</literal> or <literal>scroll()" +"</literal>, that object is added to the internal cache of the " +"<literal>Session</literal>." msgstr "" +"Whenever you pass an object to <literal>save()</literal>, <literal>update()</" +"literal> or <literal>saveOrUpdate()</literal> and whenever you retrieve an " +"object using <literal>load()</literal>, <literal>get()</literal>, " +"<literal>list()</literal>, <literal>iterate()</literal> or <literal>scroll()" +"</literal>, that object is added to the internal cache of the " +"<literal>Session</literal>." -#: index.docbook:833 -msgid "When <literal>flush()</literal> is subsequently called, the state of that object will be synchronized with the database. If you do not want this synchronization to occur or if you are processing a huge number of objects and need to manage memory efficiently, the <literal>evict()</literal> method may be used to remove the object and its collections from the first-level cache." +#. Tag: para +#: performance.xml:833 +#, no-c-format +msgid "" +"When <literal>flush()</literal> is subsequently called, the state of that " +"object will be synchronized with the database. If you do not want this " +"synchronization to occur or if you are processing a huge number of objects " +"and need to manage memory efficiently, the <literal>evict()</literal> method " +"may be used to remove the object and its collections from the first-level " +"cache." msgstr "" +"When <literal>flush()</literal> is subsequently called, the state of that " +"object will be synchronized with the database. If you do not want this " +"synchronization to occur or if you are processing a huge number of objects " +"and need to manage memory efficiently, the <literal>evict()</literal> method " +"may be used to remove the object and its collections from the first-level " +"cache." -#: index.docbook:841 +#. Tag: programlisting +#: performance.xml:841 +#, no-c-format msgid "" - "<![CDATA[ScrollableResult cats = sess.createQuery(\"from Cat as cat\").scroll(); //a huge result set\n" - "while ( cats.next() ) {\n" - " Cat cat = (Cat) cats.get(0);\n" - " doSomethingWithACat(cat);\n" - " sess.evict(cat);\n" - "}]]>" +"<![CDATA[ScrollableResult cats = sess.createQuery(\"from Cat as cat\").scroll" +"(); //a huge result set\n" +"while ( cats.next() ) {\n" +" Cat cat = (Cat) cats.get(0);\n" +" doSomethingWithACat(cat);\n" +" sess.evict(cat);\n" +"}]]>" msgstr "" -#: index.docbook:843 -msgid "The <literal>Session</literal> also provides a <literal>contains()</literal> method to determine if an instance belongs to the session cache." +#. Tag: para +#: performance.xml:843 +#, no-c-format +msgid "" +"The <literal>Session</literal> also provides a <literal>contains()</literal> " +"method to determine if an instance belongs to the session cache." msgstr "" +"The <literal>Session</literal> also provides a <literal>contains()</literal> " +"method to determine if an instance belongs to the session cache." -#: index.docbook:848 -msgid "To completely evict all objects from the session cache, call <literal>Session.clear()</literal>" +#. Tag: para +#: performance.xml:848 +#, no-c-format +msgid "" +"To completely evict all objects from the session cache, call " +"<literal>Session.clear()</literal>" msgstr "" +"To completely evict all objects from the session cache, call " +"<literal>Session.clear()</literal>" -#: index.docbook:852 -msgid "For the second-level cache, there are methods defined on <literal>SessionFactory</literal> for evicting the cached state of an instance, entire class, collection instance or entire collection role." +#. Tag: para +#: performance.xml:852 +#, no-c-format +msgid "" +"For the second-level cache, there are methods defined on " +"<literal>SessionFactory</literal> for evicting the cached state of an " +"instance, entire class, collection instance or entire collection role." msgstr "" +"For the second-level cache, there are methods defined on " +"<literal>SessionFactory</literal> for evicting the cached state of an " +"instance, entire class, collection instance or entire collection role." -#: index.docbook:858 +#. Tag: programlisting +#: performance.xml:858 +#, no-c-format msgid "" - "<![CDATA[sessionFactory.evict(Cat.class, catId); //evict a particular Cat\n" - "sessionFactory.evict(Cat.class); //evict all Cats\n" - "sessionFactory.evictCollection(\"Cat.kittens\", catId); //evict a particular collection of kittens\n" - "sessionFactory.evictCollection(\"Cat.kittens\"); //evict all kitten collections]]>" +"<![CDATA[sessionFactory.evict(Cat.class, catId); //evict a particular Cat\n" +"sessionFactory.evict(Cat.class); //evict all Cats\n" +"sessionFactory.evictCollection(\"Cat.kittens\", catId); //evict a particular " +"collection of kittens\n" +"sessionFactory.evictCollection(\"Cat.kittens\"); //evict all kitten " +"collections]]>" msgstr "" -#: index.docbook:860 -msgid "The <literal>CacheMode</literal> controls how a particular session interacts with the second-level cache." +#. Tag: para +#: performance.xml:860 +#, no-c-format +msgid "" +"The <literal>CacheMode</literal> controls how a particular session interacts " +"with the second-level cache." msgstr "" +"The <literal>CacheMode</literal> controls how a particular session interacts " +"with the second-level cache." -#: index.docbook:867 -msgid "<literal>CacheMode.NORMAL</literal> - read items from and write items to the second-level cache" +#. Tag: para +#: performance.xml:867 +#, no-c-format +msgid "" +"<literal>CacheMode.NORMAL</literal> - read items from and write items to the " +"second-level cache" msgstr "" +"<literal>CacheMode.NORMAL</literal> - read items from and write items to the " +"second-level cache" -#: index.docbook:872 -msgid "<literal>CacheMode.GET</literal> - read items from the second-level cache, but don't write to the second-level cache except when updating data" +#. Tag: para +#: performance.xml:872 +#, no-c-format +msgid "" +"<literal>CacheMode.GET</literal> - read items from the second-level cache, " +"but don't write to the second-level cache except when updating data" msgstr "" +"<literal>CacheMode.GET</literal> - read items from the second-level cache, " +"but don't write to the second-level cache except when updating data" -#: index.docbook:878 -msgid "<literal>CacheMode.PUT</literal> - write items to the second-level cache, but don't read from the second-level cache" +#. Tag: para +#: performance.xml:878 +#, no-c-format +msgid "" +"<literal>CacheMode.PUT</literal> - write items to the second-level cache, " +"but don't read from the second-level cache" msgstr "" +"<literal>CacheMode.PUT</literal> - write items to the second-level cache, " +"but don't read from the second-level cache" -#: index.docbook:884 -msgid "<literal>CacheMode.REFRESH</literal> - write items to the second-level cache, but don't read from the second-level cache, bypass the effect of <literal>hibernate.cache.use_minimal_puts</literal>, forcing a refresh of the second-level cache for all items read from the database" +#. Tag: para +#: performance.xml:884 +#, no-c-format +msgid "" +"<literal>CacheMode.REFRESH</literal> - write items to the second-level " +"cache, but don't read from the second-level cache, bypass the effect of " +"<literal>hibernate.cache.use_minimal_puts</literal>, forcing a refresh of " +"the second-level cache for all items read from the database" msgstr "" +"<literal>CacheMode.REFRESH</literal> - write items to the second-level " +"cache, but don't read from the second-level cache, bypass the effect of " +"<literal>hibernate.cache.use_minimal_puts</literal>, forcing a refresh of " +"the second-level cache for all items read from the database" -#: index.docbook:892 -msgid "To browse the contents of a second-level or query cache region, use the <literal>Statistics</literal> API:" +#. Tag: para +#: performance.xml:892 +#, no-c-format +msgid "" +"To browse the contents of a second-level or query cache region, use the " +"<literal>Statistics</literal> API:" msgstr "" +"To browse the contents of a second-level or query cache region, use the " +"<literal>Statistics</literal> API:" -#: index.docbook:897 +#. Tag: programlisting +#: performance.xml:897 +#, no-c-format msgid "" - "<![CDATA[Map cacheEntries = sessionFactory.getStatistics()\n" - " .getSecondLevelCacheStatistics(regionName)\n" - " .getEntries();]]>" +"<![CDATA[Map cacheEntries = sessionFactory.getStatistics()\n" +" .getSecondLevelCacheStatistics(regionName)\n" +" .getEntries();]]>" msgstr "" -#: index.docbook:899 -msgid "You'll need to enable statistics, and, optionally, force Hibernate to keep the cache entries in a more human-understandable format:" +#. Tag: para +#: performance.xml:899 +#, no-c-format +msgid "" +"You'll need to enable statistics, and, optionally, force Hibernate to keep " +"the cache entries in a more human-understandable format:" msgstr "" +"You'll need to enable statistics, and, optionally, force Hibernate to keep " +"the cache entries in a more human-understandable format:" -#: index.docbook:904 +#. Tag: programlisting +#: performance.xml:904 +#, no-c-format msgid "" - "<![CDATA[hibernate.generate_statistics true\n" - "hibernate.cache.use_structured_entries true]]>" +"<![CDATA[hibernate.generate_statistics true\n" +"hibernate.cache.use_structured_entries true]]>" msgstr "" -#: index.docbook:909 +#. Tag: title +#: performance.xml:909 +#, no-c-format msgid "The Query Cache" -msgstr "" +msgstr "The Query Cache" -#: index.docbook:911 -msgid "Query result sets may also be cached. This is only useful for queries that are run frequently with the same parameters. To use the query cache you must first enable it:" +#. Tag: para +#: performance.xml:911 +#, no-c-format +msgid "" +"Query result sets may also be cached. This is only useful for queries that " +"are run frequently with the same parameters. To use the query cache you must " +"first enable it:" msgstr "" +"Query result sets may also be cached. This is only useful for queries that " +"are run frequently with the same parameters. To use the query cache you must " +"first enable it:" -#: index.docbook:916 +#. Tag: programlisting +#: performance.xml:916 +#, no-c-format msgid "<![CDATA[hibernate.cache.use_query_cache true]]>" msgstr "" -#: index.docbook:918 -msgid "This setting causes the creation of two new cache regions - one holding cached query result sets (<literal>org.hibernate.cache.StandardQueryCache</literal>), the other holding timestamps of the most recent updates to queryable tables (<literal>org.hibernate.cache.UpdateTimestampsCache</literal>). Note that the query cache does not cache the state of the actual entities in the result set; it caches only identifier values and results of value type. So the query cache should always be used in conjunction with the second-level cache." +#. Tag: para +#: performance.xml:918 +#, no-c-format +msgid "" +"This setting causes the creation of two new cache regions - one holding " +"cached query result sets (<literal>org.hibernate.cache.StandardQueryCache</" +"literal>), the other holding timestamps of the most recent updates to " +"queryable tables (<literal>org.hibernate.cache.UpdateTimestampsCache</" +"literal>). Note that the query cache does not cache the state of the actual " +"entities in the result set; it caches only identifier values and results of " +"value type. So the query cache should always be used in conjunction with the " +"second-level cache." msgstr "" +"This setting causes the creation of two new cache regions - one holding " +"cached query result sets (<literal>org.hibernate.cache.StandardQueryCache</" +"literal>), the other holding timestamps of the most recent updates to " +"queryable tables (<literal>org.hibernate.cache.UpdateTimestampsCache</" +"literal>). Note that the query cache does not cache the state of the actual " +"entities in the result set; it caches only identifier values and results of " +"value type. So the query cache should always be used in conjunction with the " +"second-level cache." -#: index.docbook:928 -msgid "Most queries do not benefit from caching, so by default queries are not cached. To enable caching, call <literal>Query.setCacheable(true)</literal>. This call allows the query to look for existing cache results or add its results to the cache when it is executed." +#. Tag: para +#: performance.xml:928 +#, no-c-format +msgid "" +"Most queries do not benefit from caching, so by default queries are not " +"cached. To enable caching, call <literal>Query.setCacheable(true)</literal>. " +"This call allows the query to look for existing cache results or add its " +"results to the cache when it is executed." msgstr "" +"Most queries do not benefit from caching, so by default queries are not " +"cached. To enable caching, call <literal>Query.setCacheable(true)</literal>. " +"This call allows the query to look for existing cache results or add its " +"results to the cache when it is executed." -#: index.docbook:935 -msgid "If you require fine-grained control over query cache expiration policies, you may specify a named cache region for a particular query by calling <literal>Query.setCacheRegion()</literal>." +#. Tag: para +#: performance.xml:935 +#, no-c-format +msgid "" +"If you require fine-grained control over query cache expiration policies, " +"you may specify a named cache region for a particular query by calling " +"<literal>Query.setCacheRegion()</literal>." msgstr "" +"If you require fine-grained control over query cache expiration policies, " +"you may specify a named cache region for a particular query by calling " +"<literal>Query.setCacheRegion()</literal>." -#: index.docbook:941 +#. Tag: programlisting +#: performance.xml:941 +#, no-c-format msgid "" - "<![CDATA[List blogs = sess.createQuery(\"from Blog blog where blog.blogger = :blogger\")\n" - " .setEntity(\"blogger\", blogger)\n" - " .setMaxResults(15)\n" - " .setCacheable(true)\n" - " .setCacheRegion(\"frontpages\")\n" - " .list();]]>" +"<![CDATA[List blogs = sess.createQuery(\"from Blog blog where blog.blogger " +"= :blogger\")\n" +" .setEntity(\"blogger\", blogger)\n" +" .setMaxResults(15)\n" +" .setCacheable(true)\n" +" .setCacheRegion(\"frontpages\")\n" +" .list();]]>" msgstr "" -#: index.docbook:943 -msgid "If the query should force a refresh of its query cache region, you should call <literal>Query.setCacheMode(CacheMode.REFRESH)</literal>. This is particularly useful in cases where underlying data may have been updated via a separate process (i.e., not modified through Hibernate) and allows the application to selectively refresh particular query result sets. This is a more efficient alternative to eviction of a query cache region via <literal>SessionFactory.evictQueries()</literal>." +#. Tag: para +#: performance.xml:943 +#, no-c-format +msgid "" +"If the query should force a refresh of its query cache region, you should " +"call <literal>Query.setCacheMode(CacheMode.REFRESH)</literal>. This is " +"particularly useful in cases where underlying data may have been updated via " +"a separate process (i.e., not modified through Hibernate) and allows the " +"application to selectively refresh particular query result sets. This is a " +"more efficient alternative to eviction of a query cache region via " +"<literal>SessionFactory.evictQueries()</literal>." msgstr "" +"If the query should force a refresh of its query cache region, you should " +"call <literal>Query.setCacheMode(CacheMode.REFRESH)</literal>. This is " +"particularly useful in cases where underlying data may have been updated via " +"a separate process (i.e., not modified through Hibernate) and allows the " +"application to selectively refresh particular query result sets. This is a " +"more efficient alternative to eviction of a query cache region via " +"<literal>SessionFactory.evictQueries()</literal>." -#: index.docbook:955 +#. Tag: title +#: performance.xml:955 +#, no-c-format msgid "Understanding Collection performance" -msgstr "" +msgstr "Understanding Collection performance" -#: index.docbook:957 -msgid "We've already spent quite some time talking about collections. In this section we will highlight a couple more issues about how collections behave at runtime." +#. Tag: para +#: performance.xml:957 +#, no-c-format +msgid "" +"We've already spent quite some time talking about collections. In this " +"section we will highlight a couple more issues about how collections behave " +"at runtime." msgstr "" +"We've already spent quite some time talking about collections. In this " +"section we will highlight a couple more issues about how collections behave " +"at runtime." -#: index.docbook:964 +#. Tag: title +#: performance.xml:964 +#, no-c-format msgid "Taxonomy" -msgstr "" +msgstr "Taxonomy" -#: index.docbook:966 +#. Tag: para +#: performance.xml:966 +#, no-c-format msgid "Hibernate defines three basic kinds of collections:" -msgstr "" +msgstr "Hibernate defines three basic kinds of collections:" -#: index.docbook:970 +#. Tag: para +#: performance.xml:970 +#, no-c-format msgid "collections of values" -msgstr "" +msgstr "collections of values" -#: index.docbook:973 +#. Tag: para +#: performance.xml:973 +#, no-c-format msgid "one to many associations" -msgstr "" +msgstr "one to many associations" -#: index.docbook:976 +#. Tag: para +#: performance.xml:976 +#, no-c-format msgid "many to many associations" -msgstr "" +msgstr "many to many associations" -#: index.docbook:980 -msgid "This classification distinguishes the various table and foreign key relationships but does not tell us quite everything we need to know about the relational model. To fully understand the relational structure and performance characteristics, we must also consider the structure of the primary key that is used by Hibernate to update or delete collection rows. This suggests the following classification:" +#. Tag: para +#: performance.xml:980 +#, no-c-format +msgid "" +"This classification distinguishes the various table and foreign key " +"relationships but does not tell us quite everything we need to know about " +"the relational model. To fully understand the relational structure and " +"performance characteristics, we must also consider the structure of the " +"primary key that is used by Hibernate to update or delete collection rows. " +"This suggests the following classification:" msgstr "" +"This classification distinguishes the various table and foreign key " +"relationships but does not tell us quite everything we need to know about " +"the relational model. To fully understand the relational structure and " +"performance characteristics, we must also consider the structure of the " +"primary key that is used by Hibernate to update or delete collection rows. " +"This suggests the following classification:" -#: index.docbook:991 +#. Tag: para +#: performance.xml:991 +#, no-c-format msgid "indexed collections" -msgstr "" +msgstr "indexed collections" -#: index.docbook:994 +#. Tag: para +#: performance.xml:994 +#, no-c-format msgid "sets" -msgstr "" +msgstr "sets" -#: index.docbook:997 +#. Tag: para +#: performance.xml:997 +#, no-c-format msgid "bags" -msgstr "" +msgstr "bags" -#: index.docbook:1001 -msgid "All indexed collections (maps, lists, arrays) have a primary key consisting of the <literal><key></literal> and <literal><index></literal> columns. In this case collection updates are usually extremely efficient - the primary key may be efficiently indexed and a particular row may be efficiently located when Hibernate tries to update or delete it." +#. Tag: para +#: performance.xml:1001 +#, no-c-format +msgid "" +"All indexed collections (maps, lists, arrays) have a primary key consisting " +"of the <literal><key></literal> and <literal><index></literal> " +"columns. In this case collection updates are usually extremely efficient - " +"the primary key may be efficiently indexed and a particular row may be " +"efficiently located when Hibernate tries to update or delete it." msgstr "" +"All indexed collections (maps, lists, arrays) have a primary key consisting " +"of the <literal><key></literal> and <literal><index></literal> " +"columns. In this case collection updates are usually extremely efficient - " +"the primary key may be efficiently indexed and a particular row may be " +"efficiently located when Hibernate tries to update or delete it." -#: index.docbook:1009 -msgid "Sets have a primary key consisting of <literal><key></literal> and element columns. This may be less efficient for some types of collection element, particularly composite elements or large text or binary fields; the database may not be able to index a complex primary key as efficently. On the other hand, for one to many or many to many associations, particularly in the case of synthetic identifiers, it is likely to be just as efficient. (Side-note: if you want <literal>SchemaExport</literal> to actually create the primary key of a <literal><set></literal> for you, you must declare all columns as <literal>not-null=\"true\"</literal>.)" +#. Tag: para +#: performance.xml:1009 +#, no-c-format +msgid "" +"Sets have a primary key consisting of <literal><key></literal> and " +"element columns. This may be less efficient for some types of collection " +"element, particularly composite elements or large text or binary fields; the " +"database may not be able to index a complex primary key as efficently. On " +"the other hand, for one to many or many to many associations, particularly " +"in the case of synthetic identifiers, it is likely to be just as efficient. " +"(Side-note: if you want <literal>SchemaExport</literal> to actually create " +"the primary key of a <literal><set></literal> for you, you must " +"declare all columns as <literal>not-null=\"true\"</literal>.)" msgstr "" +"Sets have a primary key consisting of <literal><key></literal> and " +"element columns. This may be less efficient for some types of collection " +"element, particularly composite elements or large text or binary fields; the " +"database may not be able to index a complex primary key as efficently. On " +"the other hand, for one to many or many to many associations, particularly " +"in the case of synthetic identifiers, it is likely to be just as efficient. " +"(Side-note: if you want <literal>SchemaExport</literal> to actually create " +"the primary key of a <literal><set></literal> for you, you must " +"declare all columns as <literal>not-null=\"true\"</literal>.)" -#: index.docbook:1020 -msgid "<literal><idbag></literal> mappings define a surrogate key, so they are always very efficient to update. In fact, they are the best case." +#. Tag: para +#: performance.xml:1020 +#, no-c-format +msgid "" +"<literal><idbag></literal> mappings define a surrogate key, so they " +"are always very efficient to update. In fact, they are the best case." msgstr "" +"<literal><idbag></literal> mappings define a surrogate key, so they " +"are always very efficient to update. In fact, they are the best case." -#: index.docbook:1025 -msgid "Bags are the worst case. Since a bag permits duplicate element values and has no index column, no primary key may be defined. Hibernate has no way of distinguishing between duplicate rows. Hibernate resolves this problem by completely removing (in a single <literal>DELETE</literal>) and recreating the collection whenever it changes. This might be very inefficient." +#. Tag: para +#: performance.xml:1025 +#, no-c-format +msgid "" +"Bags are the worst case. Since a bag permits duplicate element values and " +"has no index column, no primary key may be defined. Hibernate has no way of " +"distinguishing between duplicate rows. Hibernate resolves this problem by " +"completely removing (in a single <literal>DELETE</literal>) and recreating " +"the collection whenever it changes. This might be very inefficient." msgstr "" +"Bags are the worst case. Since a bag permits duplicate element values and " +"has no index column, no primary key may be defined. Hibernate has no way of " +"distinguishing between duplicate rows. Hibernate resolves this problem by " +"completely removing (in a single <literal>DELETE</literal>) and recreating " +"the collection whenever it changes. This might be very inefficient." -#: index.docbook:1033 -msgid "Note that for a one-to-many association, the \"primary key\" may not be the physical primary key of the database table - but even in this case, the above classification is still useful. (It still reflects how Hibernate \"locates\" individual rows of the collection.)" +#. Tag: para +#: performance.xml:1033 +#, no-c-format +msgid "" +"Note that for a one-to-many association, the \"primary key\" may not be the " +"physical primary key of the database table - but even in this case, the " +"above classification is still useful. (It still reflects how Hibernate " +"\"locates\" individual rows of the collection.)" msgstr "" +"Note that for a one-to-many association, the \"primary key\" may not be the " +"physical primary key of the database table - but even in this case, the " +"above classification is still useful. (It still reflects how Hibernate " +"\"locates\" individual rows of the collection.)" -#: index.docbook:1043 -msgid "Lists, maps, idbags and sets are the most efficient collections to update" +#. Tag: title +#: performance.xml:1043 +#, no-c-format +msgid "" +"Lists, maps, idbags and sets are the most efficient collections to update" msgstr "" +"Lists, maps, idbags and sets are the most efficient collections to update" -#: index.docbook:1045 -msgid "From the discussion above, it should be clear that indexed collections and (usually) sets allow the most efficient operation in terms of adding, removing and updating elements." +#. Tag: para +#: performance.xml:1045 +#, no-c-format +msgid "" +"From the discussion above, it should be clear that indexed collections and " +"(usually) sets allow the most efficient operation in terms of adding, " +"removing and updating elements." msgstr "" +"From the discussion above, it should be clear that indexed collections and " +"(usually) sets allow the most efficient operation in terms of adding, " +"removing and updating elements." -#: index.docbook:1051 -msgid "There is, arguably, one more advantage that indexed collections have over sets for many to many associations or collections of values. Because of the structure of a <literal>Set</literal>, Hibernate doesn't ever <literal>UPDATE</literal> a row when an element is \"changed\". Changes to a <literal>Set</literal> always work via <literal>INSERT</literal> and <literal>DELETE</literal> (of individual rows). Once again, this consideration does not apply to one to many associations." +#. Tag: para +#: performance.xml:1051 +#, no-c-format +msgid "" +"There is, arguably, one more advantage that indexed collections have over " +"sets for many to many associations or collections of values. Because of the " +"structure of a <literal>Set</literal>, Hibernate doesn't ever " +"<literal>UPDATE</literal> a row when an element is \"changed\". Changes to a " +"<literal>Set</literal> always work via <literal>INSERT</literal> and " +"<literal>DELETE</literal> (of individual rows). Once again, this " +"consideration does not apply to one to many associations." msgstr "" +"There is, arguably, one more advantage that indexed collections have over " +"sets for many to many associations or collections of values. Because of the " +"structure of a <literal>Set</literal>, Hibernate doesn't ever " +"<literal>UPDATE</literal> a row when an element is \"changed\". Changes to a " +"<literal>Set</literal> always work via <literal>INSERT</literal> and " +"<literal>DELETE</literal> (of individual rows). Once again, this " +"consideration does not apply to one to many associations." -#: index.docbook:1060 -msgid "After observing that arrays cannot be lazy, we would conclude that lists, maps and idbags are the most performant (non-inverse) collection types, with sets not far behind. Sets are expected to be the most common kind of collection in Hibernate applications. This is because the \"set\" semantics are most natural in the relational model." +#. Tag: para +#: performance.xml:1060 +#, no-c-format +msgid "" +"After observing that arrays cannot be lazy, we would conclude that lists, " +"maps and idbags are the most performant (non-inverse) collection types, with " +"sets not far behind. Sets are expected to be the most common kind of " +"collection in Hibernate applications. This is because the \"set\" semantics " +"are most natural in the relational model." msgstr "" +"After observing that arrays cannot be lazy, we would conclude that lists, " +"maps and idbags are the most performant (non-inverse) collection types, with " +"sets not far behind. Sets are expected to be the most common kind of " +"collection in Hibernate applications. This is because the \"set\" semantics " +"are most natural in the relational model." -#: index.docbook:1068 -msgid "However, in well-designed Hibernate domain models, we usually see that most collections are in fact one-to-many associations with <literal>inverse=\"true\"</literal>. For these associations, the update is handled by the many-to-one end of the association, and so considerations of collection update performance simply do not apply." +#. Tag: para +#: performance.xml:1068 +#, no-c-format +msgid "" +"However, in well-designed Hibernate domain models, we usually see that most " +"collections are in fact one-to-many associations with <literal>inverse=\"true" +"\"</literal>. For these associations, the update is handled by the many-to-" +"one end of the association, and so considerations of collection update " +"performance simply do not apply." msgstr "" +"However, in well-designed Hibernate domain models, we usually see that most " +"collections are in fact one-to-many associations with <literal>inverse=\"true" +"\"</literal>. For these associations, the update is handled by the many-to-" +"one end of the association, and so considerations of collection update " +"performance simply do not apply." -#: index.docbook:1078 +#. Tag: title +#: performance.xml:1078 +#, no-c-format msgid "Bags and lists are the most efficient inverse collections" -msgstr "" +msgstr "Bags and lists are the most efficient inverse collections" -#: index.docbook:1080 -msgid "Just before you ditch bags forever, there is a particular case in which bags (and also lists) are much more performant than sets. For a collection with <literal>inverse=\"true\"</literal> (the standard bidirectional one-to-many relationship idiom, for example) we can add elements to a bag or list without needing to initialize (fetch) the bag elements! This is because <literal>Collection.add()</literal> or <literal>Collection.addAll()</literal> must always return true for a bag or <literal>List</literal> (unlike a <literal>Set</literal>). This can make the following common code much faster." +#. Tag: para +#: performance.xml:1080 +#, no-c-format +msgid "" +"Just before you ditch bags forever, there is a particular case in which bags " +"(and also lists) are much more performant than sets. For a collection with " +"<literal>inverse=\"true\"</literal> (the standard bidirectional one-to-many " +"relationship idiom, for example) we can add elements to a bag or list " +"without needing to initialize (fetch) the bag elements! This is because " +"<literal>Collection.add()</literal> or <literal>Collection.addAll()</" +"literal> must always return true for a bag or <literal>List</literal> " +"(unlike a <literal>Set</literal>). This can make the following common code " +"much faster." msgstr "" +"Just before you ditch bags forever, there is a particular case in which bags " +"(and also lists) are much more performant than sets. For a collection with " +"<literal>inverse=\"true\"</literal> (the standard bidirectional one-to-many " +"relationship idiom, for example) we can add elements to a bag or list " +"without needing to initialize (fetch) the bag elements! This is because " +"<literal>Collection.add()</literal> or <literal>Collection.addAll()</" +"literal> must always return true for a bag or <literal>List</literal> " +"(unlike a <literal>Set</literal>). This can make the following common code " +"much faster." -#: index.docbook:1090 +#. Tag: programlisting +#: performance.xml:1090 +#, no-c-format msgid "" - "<![CDATA[Parent p = (Parent) sess.load(Parent.class, id);\n" - "Child c = new Child();\n" - "c.setParent(p);\n" - "p.getChildren().add(c); //no need to fetch the collection!\n" - "sess.flush();]]>" +"<![CDATA[Parent p = (Parent) sess.load(Parent.class, id);\n" +"Child c = new Child();\n" +"c.setParent(p);\n" +"p.getChildren().add(c); //no need to fetch the collection!\n" +"sess.flush();]]>" msgstr "" -#: index.docbook:1095 +#. Tag: title +#: performance.xml:1095 +#, no-c-format msgid "One shot delete" -msgstr "" +msgstr "One shot delete" -#: index.docbook:1097 -msgid "Occasionally, deleting collection elements one by one can be extremely inefficient. Hibernate isn't completely stupid, so it knows not to do that in the case of an newly-empty collection (if you called <literal>list.clear()</literal>, for example). In this case, Hibernate will issue a single <literal>DELETE</literal> and we are done!" +#. Tag: para +#: performance.xml:1097 +#, no-c-format +msgid "" +"Occasionally, deleting collection elements one by one can be extremely " +"inefficient. Hibernate isn't completely stupid, so it knows not to do that " +"in the case of an newly-empty collection (if you called <literal>list.clear()" +"</literal>, for example). In this case, Hibernate will issue a single " +"<literal>DELETE</literal> and we are done!" msgstr "" +"Occasionally, deleting collection elements one by one can be extremely " +"inefficient. Hibernate isn't completely stupid, so it knows not to do that " +"in the case of an newly-empty collection (if you called <literal>list.clear()" +"</literal>, for example). In this case, Hibernate will issue a single " +"<literal>DELETE</literal> and we are done!" -#: index.docbook:1104 -msgid "Suppose we add a single element to a collection of size twenty and then remove two elements. Hibernate will issue one <literal>INSERT</literal> statement and two <literal>DELETE</literal> statements (unless the collection is a bag). This is certainly desirable." +#. Tag: para +#: performance.xml:1104 +#, no-c-format +msgid "" +"Suppose we add a single element to a collection of size twenty and then " +"remove two elements. Hibernate will issue one <literal>INSERT</literal> " +"statement and two <literal>DELETE</literal> statements (unless the " +"collection is a bag). This is certainly desirable." msgstr "" +"Suppose we add a single element to a collection of size twenty and then " +"remove two elements. Hibernate will issue one <literal>INSERT</literal> " +"statement and two <literal>DELETE</literal> statements (unless the " +"collection is a bag). This is certainly desirable." -#: index.docbook:1110 -msgid "However, suppose that we remove eighteen elements, leaving two and then add thee new elements. There are two possible ways to proceed" +#. Tag: para +#: performance.xml:1110 +#, no-c-format +msgid "" +"However, suppose that we remove eighteen elements, leaving two and then add " +"thee new elements. There are two possible ways to proceed" msgstr "" +"However, suppose that we remove eighteen elements, leaving two and then add " +"thee new elements. There are two possible ways to proceed" -#: index.docbook:1117 +#. Tag: para +#: performance.xml:1117 +#, no-c-format msgid "delete eighteen rows one by one and then insert three rows" -msgstr "" +msgstr "delete eighteen rows one by one and then insert three rows" -#: index.docbook:1120 -msgid "remove the whole collection (in one SQL <literal>DELETE</literal>) and insert all five current elements (one by one)" +#. Tag: para +#: performance.xml:1120 +#, no-c-format +msgid "" +"remove the whole collection (in one SQL <literal>DELETE</literal>) and " +"insert all five current elements (one by one)" msgstr "" +"remove the whole collection (in one SQL <literal>DELETE</literal>) and " +"insert all five current elements (one by one)" -#: index.docbook:1125 -msgid "Hibernate isn't smart enough to know that the second option is probably quicker in this case. (And it would probably be undesirable for Hibernate to be that smart; such behaviour might confuse database triggers, etc.)" +#. Tag: para +#: performance.xml:1125 +#, no-c-format +msgid "" +"Hibernate isn't smart enough to know that the second option is probably " +"quicker in this case. (And it would probably be undesirable for Hibernate to " +"be that smart; such behaviour might confuse database triggers, etc.)" msgstr "" +"Hibernate isn't smart enough to know that the second option is probably " +"quicker in this case. (And it would probably be undesirable for Hibernate to " +"be that smart; such behaviour might confuse database triggers, etc.)" -#: index.docbook:1131 -msgid "Fortunately, you can force this behaviour (ie. the second strategy) at any time by discarding (ie. dereferencing) the original collection and returning a newly instantiated collection with all the current elements. This can be very useful and powerful from time to time." +#. Tag: para +#: performance.xml:1131 +#, no-c-format +msgid "" +"Fortunately, you can force this behaviour (ie. the second strategy) at any " +"time by discarding (ie. dereferencing) the original collection and returning " +"a newly instantiated collection with all the current elements. This can be " +"very useful and powerful from time to time." msgstr "" +"Fortunately, you can force this behaviour (ie. the second strategy) at any " +"time by discarding (ie. dereferencing) the original collection and returning " +"a newly instantiated collection with all the current elements. This can be " +"very useful and powerful from time to time." -#: index.docbook:1137 -msgid "Of course, one-shot-delete does not apply to collections mapped <literal>inverse=\"true\"</literal>." +#. Tag: para +#: performance.xml:1137 +#, no-c-format +msgid "" +"Of course, one-shot-delete does not apply to collections mapped " +"<literal>inverse=\"true\"</literal>." msgstr "" +"Of course, one-shot-delete does not apply to collections mapped " +"<literal>inverse=\"true\"</literal>." -#: index.docbook:1146 +#. Tag: title +#: performance.xml:1146 +#, no-c-format msgid "Monitoring performance" -msgstr "" +msgstr "Monitoring performance" -#: index.docbook:1148 -msgid "Optimization is not much use without monitoring and access to performance numbers. Hibernate provides a full range of figures about its internal operations. Statistics in Hibernate are available per <literal>SessionFactory</literal>." +#. Tag: para +#: performance.xml:1148 +#, no-c-format +msgid "" +"Optimization is not much use without monitoring and access to performance " +"numbers. Hibernate provides a full range of figures about its internal " +"operations. Statistics in Hibernate are available per " +"<literal>SessionFactory</literal>." msgstr "" +"Optimization is not much use without monitoring and access to performance " +"numbers. Hibernate provides a full range of figures about its internal " +"operations. Statistics in Hibernate are available per " +"<literal>SessionFactory</literal>." -#: index.docbook:1155 +#. Tag: title +#: performance.xml:1155 +#, no-c-format msgid "Monitoring a SessionFactory" -msgstr "" +msgstr "Monitoring a SessionFactory" -#: index.docbook:1157 -msgid "You can access <literal>SessionFactory</literal> metrics in two ways. Your first option is to call <literal>sessionFactory.getStatistics()</literal> and read or display the <literal>Statistics</literal> yourself." +#. Tag: para +#: performance.xml:1157 +#, no-c-format +msgid "" +"You can access <literal>SessionFactory</literal> metrics in two ways. Your " +"first option is to call <literal>sessionFactory.getStatistics()</literal> " +"and read or display the <literal>Statistics</literal> yourself." msgstr "" +"You can access <literal>SessionFactory</literal> metrics in two ways. Your " +"first option is to call <literal>sessionFactory.getStatistics()</literal> " +"and read or display the <literal>Statistics</literal> yourself." -#: index.docbook:1163 -msgid "Hibernate can also use JMX to publish metrics if you enable the <literal>StatisticsService</literal> MBean. You may enable a single MBean for all your <literal>SessionFactory</literal> or one per factory. See the following code for minimalistic configuration examples:" +#. Tag: para +#: performance.xml:1163 +#, no-c-format +msgid "" +"Hibernate can also use JMX to publish metrics if you enable the " +"<literal>StatisticsService</literal> MBean. You may enable a single MBean " +"for all your <literal>SessionFactory</literal> or one per factory. See the " +"following code for minimalistic configuration examples:" msgstr "" +"Hibernate can also use JMX to publish metrics if you enable the " +"<literal>StatisticsService</literal> MBean. You may enable a single MBean " +"for all your <literal>SessionFactory</literal> or one per factory. See the " +"following code for minimalistic configuration examples:" -#: index.docbook:1170 +#. Tag: programlisting +#: performance.xml:1170 +#, no-c-format msgid "" - "<![CDATA[// MBean service registration for a specific SessionFactory\n" - "Hashtable tb = new Hashtable();\n" - "tb.put(\"type\", \"statistics\");\n" - "tb.put(\"sessionFactory\", \"myFinancialApp\");\n" - "ObjectName on = new ObjectName(\"hibernate\", tb); // MBean object name\n" - "\n" - "StatisticsService stats = new StatisticsService(); // MBean implementation\n" - "stats.setSessionFactory(sessionFactory); // Bind the stats to a SessionFactory\n" - "server.registerMBean(stats, on); // Register the Mbean on the server]]>" +"<![CDATA[// MBean service registration for a specific SessionFactory\n" +"Hashtable tb = new Hashtable();\n" +"tb.put(\"type\", \"statistics\");\n" +"tb.put(\"sessionFactory\", \"myFinancialApp\");\n" +"ObjectName on = new ObjectName(\"hibernate\", tb); // MBean object name\n" +"\n" +"StatisticsService stats = new StatisticsService(); // MBean implementation\n" +"stats.setSessionFactory(sessionFactory); // Bind the stats to a " +"SessionFactory\n" +"server.registerMBean(stats, on); // Register the Mbean on the server]]>" msgstr "" -#: index.docbook:1173 +#. Tag: programlisting +#: performance.xml:1173 +#, no-c-format msgid "" - "<![CDATA[// MBean service registration for all SessionFactory's\n" - "Hashtable tb = new Hashtable();\n" - "tb.put(\"type\", \"statistics\");\n" - "tb.put(\"sessionFactory\", \"all\");\n" - "ObjectName on = new ObjectName(\"hibernate\", tb); // MBean object name\n" - "\n" - "StatisticsService stats = new StatisticsService(); // MBean implementation\n" - "server.registerMBean(stats, on); // Register the MBean on the server]]>" +"<![CDATA[// MBean service registration for all SessionFactory's\n" +"Hashtable tb = new Hashtable();\n" +"tb.put(\"type\", \"statistics\");\n" +"tb.put(\"sessionFactory\", \"all\");\n" +"ObjectName on = new ObjectName(\"hibernate\", tb); // MBean object name\n" +"\n" +"StatisticsService stats = new StatisticsService(); // MBean implementation\n" +"server.registerMBean(stats, on); // Register the MBean on the server]]>" msgstr "" -#: index.docbook:1175 -msgid "TODO: This doesn't make sense: In the first case, we retrieve and use the MBean directly. In the second one, we must give the JNDI name in which the session factory is held before using it. Use <literal>hibernateStatsBean.setSessionFactoryJNDIName(\"my/JNDI/Name\")</literal>" +#. Tag: para +#: performance.xml:1175 +#, no-c-format +msgid "" +"TODO: This doesn't make sense: In the first case, we retrieve and use the " +"MBean directly. In the second one, we must give the JNDI name in which the " +"session factory is held before using it. Use <literal>hibernateStatsBean." +"setSessionFactoryJNDIName(\"my/JNDI/Name\")</literal>" msgstr "" +"TODO: This doesn't make sense: In the first case, we retrieve and use the " +"MBean directly. In the second one, we must give the JNDI name in which the " +"session factory is held before using it. Use <literal>hibernateStatsBean." +"setSessionFactoryJNDIName(\"my/JNDI/Name\")</literal>" -#: index.docbook:1180 -msgid "You can (de)activate the monitoring for a <literal>SessionFactory</literal>" +#. Tag: para +#: performance.xml:1180 +#, no-c-format +msgid "" +"You can (de)activate the monitoring for a <literal>SessionFactory</literal>" msgstr "" +"You can (de)activate the monitoring for a <literal>SessionFactory</literal>" -#: index.docbook:1185 -msgid "at configuration time, set <literal>hibernate.generate_statistics</literal> to <literal>false</literal>" +#. Tag: para +#: performance.xml:1185 +#, no-c-format +msgid "" +"at configuration time, set <literal>hibernate.generate_statistics</literal> " +"to <literal>false</literal>" msgstr "" +"at configuration time, set <literal>hibernate.generate_statistics</literal> " +"to <literal>false</literal>" -#: index.docbook:1192 -msgid "at runtime: <literal>sf.getStatistics().setStatisticsEnabled(true)</literal> or <literal>hibernateStatsBean.setStatisticsEnabled(true)</literal>" +#. Tag: para +#: performance.xml:1192 +#, no-c-format +msgid "" +"at runtime: <literal>sf.getStatistics().setStatisticsEnabled(true)</literal> " +"or <literal>hibernateStatsBean.setStatisticsEnabled(true)</literal>" msgstr "" +"at runtime: <literal>sf.getStatistics().setStatisticsEnabled(true)</literal> " +"or <literal>hibernateStatsBean.setStatisticsEnabled(true)</literal>" -#: index.docbook:1199 -msgid "Statistics can be reset programatically using the <literal>clear()</literal> method. A summary can be sent to a logger (info level) using the <literal>logSummary()</literal> method." +#. Tag: para +#: performance.xml:1199 +#, no-c-format +msgid "" +"Statistics can be reset programatically using the <literal>clear()</literal> " +"method. A summary can be sent to a logger (info level) using the " +"<literal>logSummary()</literal> method." msgstr "" +"Statistics can be reset programatically using the <literal>clear()</literal> " +"method. A summary can be sent to a logger (info level) using the " +"<literal>logSummary()</literal> method." -#: index.docbook:1208 +#. Tag: title +#: performance.xml:1208 +#, no-c-format msgid "Metrics" -msgstr "" +msgstr "Metrics" -#: index.docbook:1210 -msgid "Hibernate provides a number of metrics, from very basic to the specialized information only relevant in certain scenarios. All available counters are described in the <literal>Statistics</literal> interface API, in three categories:" +#. Tag: para +#: performance.xml:1210 +#, no-c-format +msgid "" +"Hibernate provides a number of metrics, from very basic to the specialized " +"information only relevant in certain scenarios. All available counters are " +"described in the <literal>Statistics</literal> interface API, in three " +"categories:" msgstr "" +"Hibernate provides a number of metrics, from very basic to the specialized " +"information only relevant in certain scenarios. All available counters are " +"described in the <literal>Statistics</literal> interface API, in three " +"categories:" -#: index.docbook:1217 -msgid "Metrics related to the general <literal>Session</literal> usage, such as number of open sessions, retrieved JDBC connections, etc." +#. Tag: para +#: performance.xml:1217 +#, no-c-format +msgid "" +"Metrics related to the general <literal>Session</literal> usage, such as " +"number of open sessions, retrieved JDBC connections, etc." msgstr "" +"Metrics related to the general <literal>Session</literal> usage, such as " +"number of open sessions, retrieved JDBC connections, etc." -#: index.docbook:1223 -msgid "Metrics related to he entities, collections, queries, and caches as a whole (aka global metrics)," +#. Tag: para +#: performance.xml:1223 +#, no-c-format +msgid "" +"Metrics related to he entities, collections, queries, and caches as a whole " +"(aka global metrics)," msgstr "" +"Metrics related to he entities, collections, queries, and caches as a whole " +"(aka global metrics)," -#: index.docbook:1229 -msgid "Detailed metrics related to a particular entity, collection, query or cache region." +#. Tag: para +#: performance.xml:1229 +#, no-c-format +msgid "" +"Detailed metrics related to a particular entity, collection, query or cache " +"region." msgstr "" +"Detailed metrics related to a particular entity, collection, query or cache " +"region." -#: index.docbook:1236 -msgid "For exampl,e you can check the cache hit, miss, and put ratio of entities, collections and queries, and the average time a query needs. Beware that the number of milliseconds is subject to approximation in Java. Hibernate is tied to the JVM precision, on some platforms this might even only be accurate to 10 seconds." +#. Tag: para +#: performance.xml:1236 +#, no-c-format +msgid "" +"For exampl,e you can check the cache hit, miss, and put ratio of entities, " +"collections and queries, and the average time a query needs. Beware that the " +"number of milliseconds is subject to approximation in Java. Hibernate is " +"tied to the JVM precision, on some platforms this might even only be " +"accurate to 10 seconds." msgstr "" +"For exampl,e you can check the cache hit, miss, and put ratio of entities, " +"collections and queries, and the average time a query needs. Beware that the " +"number of milliseconds is subject to approximation in Java. Hibernate is " +"tied to the JVM precision, on some platforms this might even only be " +"accurate to 10 seconds." -#: index.docbook:1243 -msgid "Simple getters are used to access the global metrics (i.e. not tied to a particular entity, collection, cache region, etc.). You can access the metrics of a particular entity, collection or cache region through its name, and through its HQL or SQL representation for queries. Please refer to the <literal>Statistics</literal>, <literal>EntityStatistics</literal>, <literal>CollectionStatistics</literal>, <literal>SecondLevelCacheStatistics</literal>, and <literal>QueryStatistics</literal> API Javadoc for more information. The following code shows a simple example:" +#. Tag: para +#: performance.xml:1243 +#, no-c-format +msgid "" +"Simple getters are used to access the global metrics (i.e. not tied to a " +"particular entity, collection, cache region, etc.). You can access the " +"metrics of a particular entity, collection or cache region through its name, " +"and through its HQL or SQL representation for queries. Please refer to the " +"<literal>Statistics</literal>, <literal>EntityStatistics</literal>, " +"<literal>CollectionStatistics</literal>, " +"<literal>SecondLevelCacheStatistics</literal>, and <literal>QueryStatistics</" +"literal> API Javadoc for more information. The following code shows a simple " +"example:" msgstr "" +"Simple getters are used to access the global metrics (i.e. not tied to a " +"particular entity, collection, cache region, etc.). You can access the " +"metrics of a particular entity, collection or cache region through its name, " +"and through its HQL or SQL representation for queries. Please refer to the " +"<literal>Statistics</literal>, <literal>EntityStatistics</literal>, " +"<literal>CollectionStatistics</literal>, " +"<literal>SecondLevelCacheStatistics</literal>, and <literal>QueryStatistics</" +"literal> API Javadoc for more information. The following code shows a simple " +"example:" -#: index.docbook:1253 +#. Tag: programlisting +#: performance.xml:1253 +#, no-c-format msgid "" - "<![CDATA[Statistics stats = HibernateUtil.sessionFactory.getStatistics();\n" - "\n" - "double queryCacheHitCount = stats.getQueryCacheHitCount();\n" - "double queryCacheMissCount = stats.getQueryCacheMissCount();\n" - "double queryCacheHitRatio =\n" - " queryCacheHitCount / (queryCacheHitCount + queryCacheMissCount);\n" - "\n" - "log.info(\"Query Hit ratio:\" + queryCacheHitRatio);\n" - "\n" - "EntityStatistics entityStats =\n" - " stats.getEntityStatistics( Cat.class.getName() );\n" - "long changes =\n" - " entityStats.getInsertCount()\n" - " + entityStats.getUpdateCount()\n" - " + entityStats.getDeleteCount();\n" - "log.info(Cat.class.getName() + \" changed \" + changes + \"times\" );]]>" +"<![CDATA[Statistics stats = HibernateUtil.sessionFactory.getStatistics();\n" +"\n" +"double queryCacheHitCount = stats.getQueryCacheHitCount();\n" +"double queryCacheMissCount = stats.getQueryCacheMissCount();\n" +"double queryCacheHitRatio =\n" +" queryCacheHitCount / (queryCacheHitCount + queryCacheMissCount);\n" +"\n" +"log.info(\"Query Hit ratio:\" + queryCacheHitRatio);\n" +"\n" +"EntityStatistics entityStats =\n" +" stats.getEntityStatistics( Cat.class.getName() );\n" +"long changes =\n" +" entityStats.getInsertCount()\n" +" + entityStats.getUpdateCount()\n" +" + entityStats.getDeleteCount();\n" +"log.info(Cat.class.getName() + \" changed \" + changes + \"times\" );]]>" msgstr "" -#: index.docbook:1255 -msgid "To work on all entities, collections, queries and region caches, you can retrieve the list of names of entities, collections, queries and region caches with the following methods: <literal>getQueries()</literal>, <literal>getEntityNames()</literal>, <literal>getCollectionRoleNames()</literal>, and <literal>getSecondLevelCacheRegionNames()</literal>." +#. Tag: para +#: performance.xml:1255 +#, no-c-format +msgid "" +"To work on all entities, collections, queries and region caches, you can " +"retrieve the list of names of entities, collections, queries and region " +"caches with the following methods: <literal>getQueries()</literal>, " +"<literal>getEntityNames()</literal>, <literal>getCollectionRoleNames()</" +"literal>, and <literal>getSecondLevelCacheRegionNames()</literal>." msgstr "" +"To work on all entities, collections, queries and region caches, you can " +"retrieve the list of names of entities, collections, queries and region " +"caches with the following methods: <literal>getQueries()</literal>, " +"<literal>getEntityNames()</literal>, <literal>getCollectionRoleNames()</" +"literal>, and <literal>getSecondLevelCacheRegionNames()</literal>." -msgid "ROLES_OF_TRANSLATORS" -msgstr "" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "" - +#~ msgid "yes" +#~ msgstr "yes" Modified: core/trunk/documentation/manual/translations/pt-BR/content/persistent_classes.po =================================================================== --- core/trunk/documentation/manual/translations/pt-BR/content/persistent_classes.po 2007-10-25 22:34:46 UTC (rev 14134) +++ core/trunk/documentation/manual/translations/pt-BR/content/persistent_classes.po 2007-10-26 00:46:38 UTC (rev 14135) @@ -1,446 +1,858 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: persistent_classes.xml:5 +#, no-c-format msgid "Persistent Classes" -msgstr "" +msgstr "Persistent Classes" -#: index.docbook:7 -msgid "Persistent classes are classes in an application that implement the entities of the business problem (e.g. Customer and Order in an E-commerce application). Not all instances of a persistent class are considered to be in the persistent state - an instance may instead be transient or detached." +#. Tag: para +#: persistent_classes.xml:7 +#, no-c-format +msgid "" +"Persistent classes are classes in an application that implement the entities " +"of the business problem (e.g. Customer and Order in an E-commerce " +"application). Not all instances of a persistent class are considered to be " +"in the persistent state - an instance may instead be transient or detached." msgstr "" +"Persistent classes are classes in an application that implement the entities " +"of the business problem (e.g. Customer and Order in an E-commerce " +"application). Not all instances of a persistent class are considered to be " +"in the persistent state - an instance may instead be transient or detached." -#: index.docbook:14 -msgid "Hibernate works best if these classes follow some simple rules, also known as the Plain Old Java Object (POJO) programming model. However, none of these rules are hard requirements. Indeed, Hibernate3 assumes very little about the nature of your persistent objects. You may express a domain model in other ways: using trees of <literal>Map</literal> instances, for example." +#. Tag: para +#: persistent_classes.xml:14 +#, no-c-format +msgid "" +"Hibernate works best if these classes follow some simple rules, also known " +"as the Plain Old Java Object (POJO) programming model. However, none of " +"these rules are hard requirements. Indeed, Hibernate3 assumes very little " +"about the nature of your persistent objects. You may express a domain model " +"in other ways: using trees of <literal>Map</literal> instances, for example." msgstr "" +"Hibernate works best if these classes follow some simple rules, also known " +"as the Plain Old Java Object (POJO) programming model. However, none of " +"these rules are hard requirements. Indeed, Hibernate3 assumes very little " +"about the nature of your persistent objects. You may express a domain model " +"in other ways: using trees of <literal>Map</literal> instances, for example." -#: index.docbook:23 +#. Tag: title +#: persistent_classes.xml:23 +#, no-c-format msgid "A simple POJO example" -msgstr "" +msgstr "A simple POJO example" -#: index.docbook:25 +#. Tag: para +#: persistent_classes.xml:25 +#, no-c-format msgid "Most Java applications require a persistent class representing felines." msgstr "" +"Most Java applications require a persistent class representing felines." -#: index.docbook:29 +#. Tag: programlisting +#: persistent_classes.xml:29 +#, no-c-format msgid "" - "<![CDATA[package eg;\n" - "import java.util.Set;\n" - "import java.util.Date;\n" - "\n" - "public class Cat {\n" - " private Long id; // identifier\n" - "\n" - " private Date birthdate;\n" - " private Color color;\n" - " private char sex;\n" - " private float weight;\n" - " private int litterId;\n" - "\n" - " private Cat mother;\n" - " private Set kittens = new HashSet();\n" - "\n" - " private void setId(Long id) {\n" - " this.id=id;\n" - " }\n" - " public Long getId() {\n" - " return id;\n" - " }\n" - "\n" - " void setBirthdate(Date date) {\n" - " birthdate = date;\n" - " }\n" - " public Date getBirthdate() {\n" - " return birthdate;\n" - " }\n" - "\n" - " void setWeight(float weight) {\n" - " this.weight = weight;\n" - " }\n" - " public float getWeight() {\n" - " return weight;\n" - " }\n" - "\n" - " public Color getColor() {\n" - " return color;\n" - " }\n" - " void setColor(Color color) {\n" - " this.color = color;\n" - " }\n" - "\n" - " void setSex(char sex) {\n" - " this.sex=sex;\n" - " }\n" - " public char getSex() {\n" - " return sex;\n" - " }\n" - "\n" - " void setLitterId(int id) {\n" - " this.litterId = id;\n" - " }\n" - " public int getLitterId() {\n" - " return litterId;\n" - " }\n" - "\n" - " void setMother(Cat mother) {\n" - " this.mother = mother;\n" - " }\n" - " public Cat getMother() {\n" - " return mother;\n" - " }\n" - " void setKittens(Set kittens) {\n" - " this.kittens = kittens;\n" - " }\n" - " public Set getKittens() {\n" - " return kittens;\n" - " }\n" - " \n" - " // addKitten not needed by Hibernate\n" - " public void addKitten(Cat kitten) {\n" - " kitten.setMother(this);\n" - " kitten.setLitterId( kittens.size() ); \n" - " kittens.add(kitten);\n" - " }\n" - "}]]>" +"<![CDATA[package eg;\n" +"import java.util.Set;\n" +"import java.util.Date;\n" +"\n" +"public class Cat {\n" +" private Long id; // identifier\n" +"\n" +" private Date birthdate;\n" +" private Color color;\n" +" private char sex;\n" +" private float weight;\n" +" private int litterId;\n" +"\n" +" private Cat mother;\n" +" private Set kittens = new HashSet();\n" +"\n" +" private void setId(Long id) {\n" +" this.id=id;\n" +" }\n" +" public Long getId() {\n" +" return id;\n" +" }\n" +"\n" +" void setBirthdate(Date date) {\n" +" birthdate = date;\n" +" }\n" +" public Date getBirthdate() {\n" +" return birthdate;\n" +" }\n" +"\n" +" void setWeight(float weight) {\n" +" this.weight = weight;\n" +" }\n" +" public float getWeight() {\n" +" return weight;\n" +" }\n" +"\n" +" public Color getColor() {\n" +" return color;\n" +" }\n" +" void setColor(Color color) {\n" +" this.color = color;\n" +" }\n" +"\n" +" void setSex(char sex) {\n" +" this.sex=sex;\n" +" }\n" +" public char getSex() {\n" +" return sex;\n" +" }\n" +"\n" +" void setLitterId(int id) {\n" +" this.litterId = id;\n" +" }\n" +" public int getLitterId() {\n" +" return litterId;\n" +" }\n" +"\n" +" void setMother(Cat mother) {\n" +" this.mother = mother;\n" +" }\n" +" public Cat getMother() {\n" +" return mother;\n" +" }\n" +" void setKittens(Set kittens) {\n" +" this.kittens = kittens;\n" +" }\n" +" public Set getKittens() {\n" +" return kittens;\n" +" }\n" +" \n" +" // addKitten not needed by Hibernate\n" +" public void addKitten(Cat kitten) {\n" +" kitten.setMother(this);\n" +" kitten.setLitterId( kittens.size() ); \n" +" kittens.add(kitten);\n" +" }\n" +"}]]>" msgstr "" -#: index.docbook:31 +#. Tag: para +#: persistent_classes.xml:31 +#, no-c-format msgid "There are four main rules to follow here:" -msgstr "" +msgstr "There are four main rules to follow here:" -#: index.docbook:37 +#. Tag: title +#: persistent_classes.xml:37 +#, no-c-format msgid "Implement a no-argument constructor" -msgstr "" +msgstr "Implement a no-argument constructor" -#: index.docbook:39 -msgid "<literal>Cat</literal> has a no-argument constructor. All persistent classes must have a default constructor (which may be non-public) so that Hibernate can instantiate them using <literal>Constructor.newInstance()</literal>. We strongly recommend having a default constructor with at least <emphasis>package</emphasis> visibility for runtime proxy generation in Hibernate." +#. Tag: para +#: persistent_classes.xml:39 +#, no-c-format +msgid "" +"<literal>Cat</literal> has a no-argument constructor. All persistent classes " +"must have a default constructor (which may be non-public) so that Hibernate " +"can instantiate them using <literal>Constructor.newInstance()</literal>. We " +"strongly recommend having a default constructor with at least " +"<emphasis>package</emphasis> visibility for runtime proxy generation in " +"Hibernate." msgstr "" +"<literal>Cat</literal> has a no-argument constructor. All persistent classes " +"must have a default constructor (which may be non-public) so that Hibernate " +"can instantiate them using <literal>Constructor.newInstance()</literal>. We " +"strongly recommend having a default constructor with at least " +"<emphasis>package</emphasis> visibility for runtime proxy generation in " +"Hibernate." -#: index.docbook:49 +#. Tag: title +#: persistent_classes.xml:49 +#, no-c-format msgid "Provide an identifier property (optional)" -msgstr "" +msgstr "Provide an identifier property (optional)" -#: index.docbook:51 -msgid "<literal>Cat</literal> has a property called <literal>id</literal>. This property maps to the primary key column of a database table. The property might have been called anything, and its type might have been any primitive type, any primitive \"wrapper\" type, <literal>java.lang.String</literal> or <literal>java.util.Date</literal>. (If your legacy database table has composite keys, you can even use a user-defined class with properties of these types - see the section on composite identifiers later.)" +#. Tag: para +#: persistent_classes.xml:51 +#, no-c-format +msgid "" +"<literal>Cat</literal> has a property called <literal>id</literal>. This " +"property maps to the primary key column of a database table. The property " +"might have been called anything, and its type might have been any primitive " +"type, any primitive \"wrapper\" type, <literal>java.lang.String</literal> or " +"<literal>java.util.Date</literal>. (If your legacy database table has " +"composite keys, you can even use a user-defined class with properties of " +"these types - see the section on composite identifiers later.)" msgstr "" +"<literal>Cat</literal> has a property called <literal>id</literal>. This " +"property maps to the primary key column of a database table. The property " +"might have been called anything, and its type might have been any primitive " +"type, any primitive \"wrapper\" type, <literal>java.lang.String</literal> or " +"<literal>java.util.Date</literal>. (If your legacy database table has " +"composite keys, you can even use a user-defined class with properties of " +"these types - see the section on composite identifiers later.)" -#: index.docbook:60 -msgid "The identifier property is strictly optional. You can leave them off and let Hibernate keep track of object identifiers internally. We do not recommend this, however." +#. Tag: para +#: persistent_classes.xml:60 +#, no-c-format +msgid "" +"The identifier property is strictly optional. You can leave them off and let " +"Hibernate keep track of object identifiers internally. We do not recommend " +"this, however." msgstr "" +"The identifier property is strictly optional. You can leave them off and let " +"Hibernate keep track of object identifiers internally. We do not recommend " +"this, however." -#: index.docbook:65 -msgid "In fact, some functionality is available only to classes which declare an identifier property:" +#. Tag: para +#: persistent_classes.xml:65 +#, no-c-format +msgid "" +"In fact, some functionality is available only to classes which declare an " +"identifier property:" msgstr "" +"In fact, some functionality is available only to classes which declare an " +"identifier property:" -#: index.docbook:72 -msgid "Transitive reattachment for detached objects (cascade update or cascade merge) - see" +#. Tag: para +#: persistent_classes.xml:72 +#, fuzzy, no-c-format +msgid "" +"Transitive reattachment for detached objects (cascade update or cascade " +"merge) - see" msgstr "" +"Transitive reattachment for detached objects (cascade update or cascade " +"merge) - see <xref linkend=\"objectstate-transitive\"/>" -#: index.docbook:79 +#. Tag: literal +#: persistent_classes.xml:79 +#, no-c-format msgid "Session.saveOrUpdate()" -msgstr "" +msgstr "Session.saveOrUpdate()" -#: index.docbook:84 +#. Tag: literal +#: persistent_classes.xml:84 +#, no-c-format msgid "Session.merge()" -msgstr "" +msgstr "Session.merge()" -#: index.docbook:89 -msgid "We recommend you declare consistently-named identifier properties on persistent classes. We further recommend that you use a nullable (ie. non-primitive) type." +#. Tag: para +#: persistent_classes.xml:89 +#, no-c-format +msgid "" +"We recommend you declare consistently-named identifier properties on " +"persistent classes. We further recommend that you use a nullable (ie. non-" +"primitive) type." msgstr "" +"We recommend you declare consistently-named identifier properties on " +"persistent classes. We further recommend that you use a nullable (ie. non-" +"primitive) type." -#: index.docbook:96 +#. Tag: title +#: persistent_classes.xml:96 +#, no-c-format msgid "Prefer non-final classes (optional)" -msgstr "" +msgstr "Prefer non-final classes (optional)" -#: index.docbook:97 -msgid "A central feature of Hibernate, <emphasis>proxies</emphasis>, depends upon the persistent class being either non-final, or the implementation of an interface that declares all public methods." +#. Tag: para +#: persistent_classes.xml:97 +#, no-c-format +msgid "" +"A central feature of Hibernate, <emphasis>proxies</emphasis>, depends upon " +"the persistent class being either non-final, or the implementation of an " +"interface that declares all public methods." msgstr "" +"A central feature of Hibernate, <emphasis>proxies</emphasis>, depends upon " +"the persistent class being either non-final, or the implementation of an " +"interface that declares all public methods." -#: index.docbook:102 -msgid "You can persist <literal>final</literal> classes that do not implement an interface with Hibernate, but you won't be able to use proxies for lazy association fetching - which will limit your options for performance tuning." +#. Tag: para +#: persistent_classes.xml:102 +#, no-c-format +msgid "" +"You can persist <literal>final</literal> classes that do not implement an " +"interface with Hibernate, but you won't be able to use proxies for lazy " +"association fetching - which will limit your options for performance tuning." msgstr "" +"You can persist <literal>final</literal> classes that do not implement an " +"interface with Hibernate, but you won't be able to use proxies for lazy " +"association fetching - which will limit your options for performance tuning." -#: index.docbook:107 -msgid "You should also avoid declaring <literal>public final</literal> methods on the non-final classes. If you want to use a class with a <literal>public final</literal> method, you must explicitly disable proxying by setting <literal>lazy=\"false\"</literal>." +#. Tag: para +#: persistent_classes.xml:107 +#, no-c-format +msgid "" +"You should also avoid declaring <literal>public final</literal> methods on " +"the non-final classes. If you want to use a class with a <literal>public " +"final</literal> method, you must explicitly disable proxying by setting " +"<literal>lazy=\"false\"</literal>." msgstr "" +"You should also avoid declaring <literal>public final</literal> methods on " +"the non-final classes. If you want to use a class with a <literal>public " +"final</literal> method, you must explicitly disable proying by setting " +"<literal>lazy=\"false\"</literal>." -#: index.docbook:115 +#. Tag: title +#: persistent_classes.xml:115 +#, no-c-format msgid "Declare accessors and mutators for persistent fields (optional)" -msgstr "" +msgstr "Declare accessors and mutators for persistent fields (optional)" -#: index.docbook:117 -msgid "<literal>Cat</literal> declares accessor methods for all its persistent fields. Many other ORM tools directly persist instance variables. We believe it is better to provide an indirection between the relational schema and internal data structures of the class. By default, Hibernate persists JavaBeans style properties, and recognizes method names of the form <literal>getFoo</literal>, <literal>isFoo</literal> and <literal>setFoo</literal>. You may switch to direct field access for particular properties, if needed." +#. Tag: para +#: persistent_classes.xml:117 +#, no-c-format +msgid "" +"<literal>Cat</literal> declares accessor methods for all its persistent " +"fields. Many other ORM tools directly persist instance variables. We believe " +"it is better to provide an indirection between the relational schema and " +"internal data structures of the class. By default, Hibernate persists " +"JavaBeans style properties, and recognizes method names of the form " +"<literal>getFoo</literal>, <literal>isFoo</literal> and <literal>setFoo</" +"literal>. You may switch to direct field access for particular properties, " +"if needed." msgstr "" +"<literal>Cat</literal> declares accessor methods for all its persistent " +"fields. Many other ORM tools directly persist instance variables. We believe " +"it is better to provide an indirection between the relational schema and " +"internal data structures of the class. By default, Hibernate persists " +"JavaBeans style properties, and recognizes method names of the form " +"<literal>getFoo</literal>, <literal>isFoo</literal> and <literal>setFoo</" +"literal>. You may switch to direct field access for particular properties, " +"if needed." -#: index.docbook:127 -msgid "Properties need <emphasis>not</emphasis> be declared public - Hibernate can persist a property with a default, <literal>protected</literal> or <literal>private</literal> get / set pair." +#. Tag: para +#: persistent_classes.xml:127 +#, no-c-format +msgid "" +"Properties need <emphasis>not</emphasis> be declared public - Hibernate can " +"persist a property with a default, <literal>protected</literal> or " +"<literal>private</literal> get / set pair." msgstr "" +"Properties need <emphasis>not</emphasis> be declared public - Hibernate can " +"persist a property with a default, <literal>protected</literal> or " +"<literal>private</literal> get / set pair." -#: index.docbook:138 +#. Tag: title +#: persistent_classes.xml:138 +#, no-c-format msgid "Implementing inheritance" -msgstr "" +msgstr "Implementing inheritance" -#: index.docbook:140 -msgid "A subclass must also observe the first and second rules. It inherits its identifier property from the superclass, <literal>Cat</literal>." +#. Tag: para +#: persistent_classes.xml:140 +#, no-c-format +msgid "" +"A subclass must also observe the first and second rules. It inherits its " +"identifier property from the superclass, <literal>Cat</literal>." msgstr "" +"A subclass must also observe the first and second rules. It inherits its " +"identifier property from the superclass, <literal>Cat</literal>." -#: index.docbook:145 +#. Tag: programlisting +#: persistent_classes.xml:145 +#, no-c-format msgid "" - "<![CDATA[package eg;\n" - "\n" - "public class DomesticCat extends Cat {\n" - " private String name;\n" - "\n" - " public String getName() {\n" - " return name;\n" - " }\n" - " protected void setName(String name) {\n" - " this.name=name;\n" - " }\n" - "}]]>" +"<![CDATA[package eg;\n" +"\n" +"public class DomesticCat extends Cat {\n" +" private String name;\n" +"\n" +" public String getName() {\n" +" return name;\n" +" }\n" +" protected void setName(String name) {\n" +" this.name=name;\n" +" }\n" +"}]]>" msgstr "" -#: index.docbook:149 -msgid "Implementing <literal>equals()</literal> and <literal>hashCode()</literal>" +#. Tag: title +#: persistent_classes.xml:149 +#, no-c-format +msgid "" +"Implementing <literal>equals()</literal> and <literal>hashCode()</literal>" msgstr "" +"Implementing <literal>equals()</literal> and <literal>hashCode()</literal>" -#: index.docbook:151 -msgid "You have to override the <literal>equals()</literal> and <literal>hashCode()</literal> methods if you" +#. Tag: para +#: persistent_classes.xml:151 +#, no-c-format +msgid "" +"You have to override the <literal>equals()</literal> and <literal>hashCode()" +"</literal> methods if you" msgstr "" +"You have to override the <literal>equals()</literal> and <literal>hashCode()" +"</literal> methods if you" -#: index.docbook:157 -msgid "intend to put instances of persistent classes in a <literal>Set</literal> (the recommended way to represent many-valued associations) <emphasis>and</emphasis>" +#. Tag: para +#: persistent_classes.xml:157 +#, no-c-format +msgid "" +"intend to put instances of persistent classes in a <literal>Set</literal> " +"(the recommended way to represent many-valued associations) <emphasis>and</" +"emphasis>" msgstr "" +"intend to put instances of persistent classes in a <literal>Set</literal> " +"(the recommended way to represent many-valued associations) <emphasis>and</" +"emphasis>" -#: index.docbook:164 +#. Tag: para +#: persistent_classes.xml:164 +#, no-c-format msgid "intend to use reattachment of detached instances" -msgstr "" +msgstr "intend to use reattachment of detached instances" -#: index.docbook:170 -msgid "Hibernate guarantees equivalence of persistent identity (database row) and Java identity only inside a particular session scope. So as soon as we mix instances retrieved in different sessions, we must implement <literal>equals()</literal> and <literal>hashCode()</literal> if we wish to have meaningful semantics for <literal>Set</literal>s." +#. Tag: para +#: persistent_classes.xml:170 +#, no-c-format +msgid "" +"Hibernate guarantees equivalence of persistent identity (database row) and " +"Java identity only inside a particular session scope. So as soon as we mix " +"instances retrieved in different sessions, we must implement <literal>equals" +"()</literal> and <literal>hashCode()</literal> if we wish to have meaningful " +"semantics for <literal>Set</literal>s." msgstr "" +"Hibernate guarantees equivalence of persistent identity (database row) and " +"Java identity only inside a particular session scope. So as soon as we mix " +"instances retrieved in different sessions, we must implement <literal>equals" +"()</literal> and <literal>hashCode()</literal> if we wish to have meaningful " +"semantics for <literal>Set</literal>s." -#: index.docbook:178 -msgid "The most obvious way is to implement <literal>equals()</literal>/<literal>hashCode()</literal> by comparing the identifier value of both objects. If the value is the same, both must be the same database row, they are therefore equal (if both are added to a <literal>Set</literal>, we will only have one element in the <literal>Set</literal>). Unfortunately, we can't use that approach with generated identifiers! Hibernate will only assign identifier values to objects that are persistent, a newly created instance will not have any identifier value! Furthermore, if an instance is unsaved and currently in a <literal>Set</literal>, saving it will assign an identifier value to the object. If <literal>equals()</literal> and <literal>hashCode()</literal> are based on the identifier value, the hash code would change, breaking the contract of the <literal>Set</literal>. See the Hibernate website for a full discussion of this problem. Note that this is not a Hibernate issue, but ! normal Java semantics of object identity and equality." +#. Tag: para +#: persistent_classes.xml:178 +#, no-c-format +msgid "" +"The most obvious way is to implement <literal>equals()</literal>/" +"<literal>hashCode()</literal> by comparing the identifier value of both " +"objects. If the value is the same, both must be the same database row, they " +"are therefore equal (if both are added to a <literal>Set</literal>, we will " +"only have one element in the <literal>Set</literal>). Unfortunately, we " +"can't use that approach with generated identifiers! Hibernate will only " +"assign identifier values to objects that are persistent, a newly created " +"instance will not have any identifier value! Furthermore, if an instance is " +"unsaved and currently in a <literal>Set</literal>, saving it will assign an " +"identifier value to the object. If <literal>equals()</literal> and " +"<literal>hashCode()</literal> are based on the identifier value, the hash " +"code would change, breaking the contract of the <literal>Set</literal>. See " +"the Hibernate website for a full discussion of this problem. Note that this " +"is not a Hibernate issue, but normal Java semantics of object identity and " +"equality." msgstr "" +"The most obvious way is to implement <literal>equals()</literal>/" +"<literal>hashCode()</literal> by comparing the identifier value of both " +"objects. If the value is the same, both must be the same database row, they " +"are therefore equal (if both are added to a <literal>Set</literal>, we will " +"only have one element in the <literal>Set</literal>). Unfortunately, we " +"can't use that approach with generated identifiers! Hibernate will only " +"assign identifier values to objects that are persistent, a newly created " +"instance will not have any identifier value! Furthermore, if an instance is " +"unsaved and currently in a <literal>Set</literal>, saving it will assign an " +"identifier value to the object. If <literal>equals()</literal> and " +"<literal>hashCode()</literal> are based on the identifier value, the hash " +"code would change, breaking the contract of the <literal>Set</literal>. See " +"the Hibernate website for a full discussion of this problem. Note that this " +"is not a Hibernate issue, but normal Java semantics of object identity and " +"equality." -#: index.docbook:192 -msgid "We recommend implementing <literal>equals()</literal> and <literal>hashCode()</literal> using <emphasis>Business key equality</emphasis>. Business key equality means that the <literal>equals()</literal> method compares only the properties that form the business key, a key that would identify our instance in the real world (a <emphasis>natural</emphasis> candidate key):" +#. Tag: para +#: persistent_classes.xml:192 +#, no-c-format +msgid "" +"We recommend implementing <literal>equals()</literal> and <literal>hashCode()" +"</literal> using <emphasis>Business key equality</emphasis>. Business key " +"equality means that the <literal>equals()</literal> method compares only the " +"properties that form the business key, a key that would identify our " +"instance in the real world (a <emphasis>natural</emphasis> candidate key):" msgstr "" +"We recommend implementing <literal>equals()</literal> and <literal>hashCode()" +"</literal> using <emphasis>Business key equality</emphasis>. Business key " +"equality means that the <literal>equals()</literal> method compares only the " +"properties that form the business key, a key that would identify our " +"instance in the real world (a <emphasis>natural</emphasis> candidate key):" -#: index.docbook:200 +#. Tag: programlisting +#: persistent_classes.xml:200 +#, no-c-format msgid "" - "<![CDATA[public class Cat {\n" - "\n" - " ...\n" - " public boolean equals(Object other) {\n" - " if (this == other) return true;\n" - " if ( !(other instanceof Cat) ) return false;\n" - "\n" - " final Cat cat = (Cat) other;\n" - "\n" - " if ( !cat.getLitterId().equals( getLitterId() ) ) return false;\n" - " if ( !cat.getMother().equals( getMother() ) ) return false;\n" - "\n" - " return true;\n" - " }\n" - "\n" - " public int hashCode() {\n" - " int result;\n" - " result = getMother().hashCode();\n" - " result = 29 * result + getLitterId();\n" - " return result;\n" - " }\n" - "\n" - "}]]>" +"<![CDATA[public class Cat {\n" +"\n" +" ...\n" +" public boolean equals(Object other) {\n" +" if (this == other) return true;\n" +" if ( !(other instanceof Cat) ) return false;\n" +"\n" +" final Cat cat = (Cat) other;\n" +"\n" +" if ( !cat.getLitterId().equals( getLitterId() ) ) return false;\n" +" if ( !cat.getMother().equals( getMother() ) ) return false;\n" +"\n" +" return true;\n" +" }\n" +"\n" +" public int hashCode() {\n" +" int result;\n" +" result = getMother().hashCode();\n" +" result = 29 * result + getLitterId();\n" +" return result;\n" +" }\n" +"\n" +"}]]>" msgstr "" -#: index.docbook:202 -msgid "Note that a business key does not have to be as solid as a database primary key candidate (see <xref linkend=\"transactions-basics-identity\"/>). Immutable or unique properties are usually good candidates for a business key." +#. Tag: para +#: persistent_classes.xml:202 +#, no-c-format +msgid "" +"Note that a business key does not have to be as solid as a database primary " +"key candidate (see <xref linkend=\"transactions-basics-identity\"/>). " +"Immutable or unique properties are usually good candidates for a business " +"key." msgstr "" +"Note that a business key does not have to be as solid as a database primary " +"key candidate (see <xref linkend=\"transactions-basics-identity\"/>). " +"Immutable or unique properties are usually good candidates for a business " +"key." -#: index.docbook:212 +#. Tag: title +#: persistent_classes.xml:212 +#, no-c-format msgid "Dynamic models" -msgstr "" +msgstr "Dynamic models" -#: index.docbook:215 -msgid "Note that the following features are currently considered experimental and may change in the near future." +#. Tag: emphasis +#: persistent_classes.xml:215 +#, no-c-format +msgid "" +"Note that the following features are currently considered experimental and " +"may change in the near future." msgstr "" +"Note that the following features are currently considered experimental and " +"may change in the near future." -#: index.docbook:219 -msgid "Persistent entities don't necessarily have to be represented as POJO classes or as JavaBean objects at runtime. Hibernate also supports dynamic models (using <literal>Map</literal>s of <literal>Map</literal>s at runtime) and the representation of entities as DOM4J trees. With this approach, you don't write persistent classes, only mapping files." +#. Tag: para +#: persistent_classes.xml:219 +#, no-c-format +msgid "" +"Persistent entities don't necessarily have to be represented as POJO classes " +"or as JavaBean objects at runtime. Hibernate also supports dynamic models " +"(using <literal>Map</literal>s of <literal>Map</literal>s at runtime) and " +"the representation of entities as DOM4J trees. With this approach, you don't " +"write persistent classes, only mapping files." msgstr "" +"Persistent entities don't necessarily have to be represented as POJO classes " +"or as JavaBean objects at runtime. Hibernate also supports dynamic models " +"(using <literal>Map</literal>s of <literal>Map</literal>s at runtime) and " +"the representation of entities as DOM4J trees. With this approach, you don't " +"write persistent classes, only mapping files." -#: index.docbook:227 -msgid "By default, Hibernate works in normal POJO mode. You may set a default entity representation mode for a particular <literal>SessionFactory</literal> using the <literal>default_entity_mode</literal> configuration option (see <xref linkend=\"configuration-optional-properties\"/>." +#. Tag: para +#: persistent_classes.xml:227 +#, no-c-format +msgid "" +"By default, Hibernate works in normal POJO mode. You may set a default " +"entity representation mode for a particular <literal>SessionFactory</" +"literal> using the <literal>default_entity_mode</literal> configuration " +"option (see <xref linkend=\"configuration-optional-properties\"/>." msgstr "" +"By default, Hibernate works in normal POJO mode. You may set a default " +"entity representation mode for a particular <literal>SessionFactory</" +"literal> using the <literal>default_entity_mode</literal> configuration " +"option (see <xref linkend=\"configuration-optional-properties\"/>." -#: index.docbook:234 -msgid "The following examples demonstrates the representation using <literal>Map</literal>s. First, in the mapping file, an <literal>entity-name</literal> has to be declared instead of (or in addition to) a class name:" +#. Tag: para +#: persistent_classes.xml:234 +#, no-c-format +msgid "" +"The following examples demonstrates the representation using <literal>Map</" +"literal>s. First, in the mapping file, an <literal>entity-name</literal> has " +"to be declared instead of (or in addition to) a class name:" msgstr "" +"The following examples demonstrates the representation using <literal>Map</" +"literal>s. First, in the mapping file, an <literal>entity-name</literal> has " +"to be declared instead of (or in addition to) a class name:" -#: index.docbook:240 +#. Tag: programlisting +#: persistent_classes.xml:240 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class entity-name=\"Customer\">\n" - "\n" - " <id name=\"id\"\n" - " type=\"long\"\n" - " column=\"ID\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - "\n" - " <property name=\"name\"\n" - " column=\"NAME\"\n" - " type=\"string\"/>\n" - "\n" - " <property name=\"address\"\n" - " column=\"ADDRESS\"\n" - " type=\"string\"/>\n" - "\n" - " <many-to-one name=\"organization\"\n" - " column=\"ORGANIZATION_ID\"\n" - " class=\"Organization\"/>\n" - "\n" - " <bag name=\"orders\"\n" - " inverse=\"true\"\n" - " lazy=\"false\"\n" - " cascade=\"all\">\n" - " <key column=\"CUSTOMER_ID\"/>\n" - " <one-to-many class=\"Order\"/>\n" - " </bag>\n" - "\n" - " </class>\n" - " \n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +"\n" +" <class entity-name=\"Customer\">\n" +"\n" +" <id name=\"id\"\n" +" type=\"long\"\n" +" column=\"ID\">\n" +" <generator class=\"sequence\"/>\n" +" </id>\n" +"\n" +" <property name=\"name\"\n" +" column=\"NAME\"\n" +" type=\"string\"/>\n" +"\n" +" <property name=\"address\"\n" +" column=\"ADDRESS\"\n" +" type=\"string\"/>\n" +"\n" +" <many-to-one name=\"organization\"\n" +" column=\"ORGANIZATION_ID\"\n" +" class=\"Organization\"/>\n" +"\n" +" <bag name=\"orders\"\n" +" inverse=\"true\"\n" +" lazy=\"false\"\n" +" cascade=\"all\">\n" +" <key column=\"CUSTOMER_ID\"/>\n" +" <one-to-many class=\"Order\"/>\n" +" </bag>\n" +"\n" +" </class>\n" +" \n" +"</hibernate-mapping>]]>" msgstr "" -#: index.docbook:242 -msgid "Note that even though associations are declared using target class names, the target type of an associations may also be a dynamic entity instead of a POJO." +#. Tag: para +#: persistent_classes.xml:242 +#, no-c-format +msgid "" +"Note that even though associations are declared using target class names, " +"the target type of an associations may also be a dynamic entity instead of a " +"POJO." msgstr "" +"Note that even though associations are declared using target class names, " +"the target type of an associations may also be a dynamic entity instead of a " +"POJO." -#: index.docbook:249 -msgid "After setting the default entity mode to <literal>dynamic-map</literal> for the <literal>SessionFactory</literal>, we can at runtime work with <literal>Map</literal>s of <literal>Map</literal>s:" +#. Tag: para +#: persistent_classes.xml:249 +#, no-c-format +msgid "" +"After setting the default entity mode to <literal>dynamic-map</literal> for " +"the <literal>SessionFactory</literal>, we can at runtime work with " +"<literal>Map</literal>s of <literal>Map</literal>s:" msgstr "" +"After setting the default entity mode to <literal>dynamic-map</literal> for " +"the <literal>SessionFactory</literal>, we can at runtime work with " +"<literal>Map</literal>s of <literal>Map</literal>s:" -#: index.docbook:255 +#. Tag: programlisting +#: persistent_classes.xml:255 +#, no-c-format msgid "" - "<![CDATA[Session s = openSession();\n" - "Transaction tx = s.beginTransaction();\n" - "Session s = openSession();\n" - "\n" - "// Create a customer\n" - "Map david = new HashMap();\n" - "david.put(\"name\", \"David\");\n" - "\n" - "// Create an organization\n" - "Map foobar = new HashMap();\n" - "foobar.put(\"name\", \"Foobar Inc.\");\n" - "\n" - "// Link both\n" - "david.put(\"organization\", foobar);\n" - "\n" - "// Save both\n" - "s.save(\"Customer\", david);\n" - "s.save(\"Organization\", foobar);\n" - "\n" - "tx.commit();\n" - "s.close();]]>" +"<![CDATA[Session s = openSession();\n" +"Transaction tx = s.beginTransaction();\n" +"Session s = openSession();\n" +"\n" +"// Create a customer\n" +"Map david = new HashMap();\n" +"david.put(\"name\", \"David\");\n" +"\n" +"// Create an organization\n" +"Map foobar = new HashMap();\n" +"foobar.put(\"name\", \"Foobar Inc.\");\n" +"\n" +"// Link both\n" +"david.put(\"organization\", foobar);\n" +"\n" +"// Save both\n" +"s.save(\"Customer\", david);\n" +"s.save(\"Organization\", foobar);\n" +"\n" +"tx.commit();\n" +"s.close();]]>" msgstr "" -#: index.docbook:257 -msgid "The advantages of a dynamic mapping are quick turnaround time for prototyping without the need for entity class implementation. However, you lose compile-time type checking and will very likely deal with many exceptions at runtime. Thanks to the Hibernate mapping, the database schema can easily be normalized and sound, allowing to add a proper domain model implementation on top later on." +#. Tag: para +#: persistent_classes.xml:257 +#, no-c-format +msgid "" +"The advantages of a dynamic mapping are quick turnaround time for " +"prototyping without the need for entity class implementation. However, you " +"lose compile-time type checking and will very likely deal with many " +"exceptions at runtime. Thanks to the Hibernate mapping, the database schema " +"can easily be normalized and sound, allowing to add a proper domain model " +"implementation on top later on." msgstr "" +"The advantages of a dynamic mapping are quick turnaround time for " +"prototyping without the need for entity class implementation. However, you " +"lose compile-time type checking and will very likely deal with many " +"exceptions at runtime. Thanks to the Hibernate mapping, the database schema " +"can easily be normalized and sound, allowing to add a proper domain model " +"implementation on top later on." -#: index.docbook:265 -msgid "Entity representation modes can also be set on a per <literal>Session</literal> basis:" +#. Tag: para +#: persistent_classes.xml:265 +#, no-c-format +msgid "" +"Entity representation modes can also be set on a per <literal>Session</" +"literal> basis:" msgstr "" +"Entity representation modes can also be set on a per <literal>Session</" +"literal> basis:" -#: index.docbook:270 +#. Tag: programlisting +#: persistent_classes.xml:270 +#, no-c-format msgid "" - "<![CDATA[Session dynamicSession = pojoSession.getSession(EntityMode.MAP);\n" - "\n" - "// Create a customer\n" - "Map david = new HashMap();\n" - "david.put(\"name\", \"David\");\n" - "dynamicSession.save(\"Customer\", david);\n" - "...\n" - "dynamicSession.flush();\n" - "dynamicSession.close()\n" - "...\n" - "// Continue on pojoSession\n" - "]]>" +"<![CDATA[Session dynamicSession = pojoSession.getSession(EntityMode.MAP);\n" +"\n" +"// Create a customer\n" +"Map david = new HashMap();\n" +"david.put(\"name\", \"David\");\n" +"dynamicSession.save(\"Customer\", david);\n" +"...\n" +"dynamicSession.flush();\n" +"dynamicSession.close()\n" +"...\n" +"// Continue on pojoSession\n" +"]]>" msgstr "" -#: index.docbook:273 -msgid "Please note that the call to <literal>getSession()</literal> using an <literal>EntityMode</literal> is on the <literal>Session</literal> API, not the <literal>SessionFactory</literal>. That way, the new <literal>Session</literal> shares the underlying JDBC connection, transaction, and other context information. This means you don't have tocall <literal>flush()</literal> and <literal>close()</literal> on the secondary <literal>Session</literal>, and also leave the transaction and connection handling to the primary unit of work." +#. Tag: para +#: persistent_classes.xml:273 +#, no-c-format +msgid "" +"Please note that the call to <literal>getSession()</literal> using an " +"<literal>EntityMode</literal> is on the <literal>Session</literal> API, not " +"the <literal>SessionFactory</literal>. That way, the new <literal>Session</" +"literal> shares the underlying JDBC connection, transaction, and other " +"context information. This means you don't have tocall <literal>flush()</" +"literal> and <literal>close()</literal> on the secondary <literal>Session</" +"literal>, and also leave the transaction and connection handling to the " +"primary unit of work." msgstr "" +"Please note that the call to <literal>getSession()</literal> using an " +"<literal>EntityMode</literal> is on the <literal>Session</literal> API, not " +"the <literal>SessionFactory</literal>. That way, the new <literal>Session</" +"literal> shares the underlying JDBC connection, transaction, and other " +"context information. This means you don't have tocall <literal>flush()</" +"literal> and <literal>close()</literal> on the secondary <literal>Session</" +"literal>, and also leave the transaction and connection handling to the " +"primary unit of work." -#: index.docbook:283 -msgid "More information about the XML representation capabilities can be found in <xref linkend=\"xml\"/>." +#. Tag: para +#: persistent_classes.xml:283 +#, no-c-format +msgid "" +"More information about the XML representation capabilities can be found in " +"<xref linkend=\"xml\"/>." msgstr "" +"More information about the XML representation capabilities can be found in " +"<xref linkend=\"xml\"/>." -#: index.docbook:291 +#. Tag: title +#: persistent_classes.xml:291 +#, no-c-format msgid "Tuplizers" -msgstr "" +msgstr "Tuplizers" -#: index.docbook:293 -msgid "<literal>org.hibernate.tuple.Tuplizer</literal>, and its sub-interfaces, are responsible for managing a particular representation of a piece of data, given that representation's <literal>org.hibernate.EntityMode</literal>. If a given piece of data is thought of as a data structure, then a tuplizer is the thing which knows how to create such a data structure and how to extract values from and inject values into such a data structure. For example, for the POJO entity mode, the correpsonding tuplizer knows how create the POJO through its constructor and how to access the POJO properties using the defined property accessors. There are two high-level types of Tuplizers, represented by the <literal>org.hibernate.tuple.entity.EntityTuplizer</literal> and <literal>org.hibernate.tuple.component.ComponentTuplizer</literal> interfaces. <literal>EntityTuplizer</literal>s are responsible for managing the above mentioned contracts in regards to entities, while <literal>ComponentTu! plizer</literal>s do the same for components." +#. Tag: para +#: persistent_classes.xml:293 +#, no-c-format +msgid "" +"<literal>org.hibernate.tuple.Tuplizer</literal>, and its sub-interfaces, are " +"responsible for managing a particular representation of a piece of data, " +"given that representation's <literal>org.hibernate.EntityMode</literal>. If " +"a given piece of data is thought of as a data structure, then a tuplizer is " +"the thing which knows how to create such a data structure and how to extract " +"values from and inject values into such a data structure. For example, for " +"the POJO entity mode, the correpsonding tuplizer knows how create the POJO " +"through its constructor and how to access the POJO properties using the " +"defined property accessors. There are two high-level types of Tuplizers, " +"represented by the <literal>org.hibernate.tuple.entity.EntityTuplizer</" +"literal> and <literal>org.hibernate.tuple.component.ComponentTuplizer</" +"literal> interfaces. <literal>EntityTuplizer</literal>s are responsible for " +"managing the above mentioned contracts in regards to entities, while " +"<literal>ComponentTuplizer</literal>s do the same for components." msgstr "" +"<literal>org.hibernate.tuple.Tuplizer</literal>, and its sub-interfaces, are " +"responsible for managing a particular representation of a piece of data, " +"given that representation's <literal>org.hibernate.EntityMode</literal>. If " +"a given piece of data is thought of as a data structure, then a tuplizer is " +"the thing which knows how to create such a data structure and how to extract " +"values from and inject values into such a data structure. For example, for " +"the POJO entity mode, the correpsonding tuplizer knows how create the POJO " +"through its constructor and how to access the POJO properties using the " +"defined property accessors. There are two high-level types of Tuplizers, " +"represented by the <literal>org.hibernate.tuple.EntityTuplizer</literal> and " +"<literal>org.hibernate.tuple.ComponentTuplizer</literal> interfaces. " +"<literal>EntityTuplizer</literal>s are responsible for managing the above " +"mentioned contracts in regards to entities, while " +"<literal>ComponentTuplizer</literal>s do the same for components." -#: index.docbook:308 -msgid "Users may also plug in their own tuplizers. Perhaps you require that a <literal>java.util.Map</literal> implementation other than <literal>java.util.HashMap</literal> be used while in the dynamic-map entity-mode; or perhaps you need to define a different proxy generation strategy than the one used by default. Both would be achieved by defining a custom tuplizer implementation. Tuplizers definitions are attached to the entity or component mapping they are meant to manage. Going back to the example of our customer entity:" +#. Tag: para +#: persistent_classes.xml:308 +#, no-c-format +msgid "" +"Users may also plug in their own tuplizers. Perhaps you require that a " +"<literal>java.util.Map</literal> implementation other than <literal>java." +"util.HashMap</literal> be used while in the dynamic-map entity-mode; or " +"perhaps you need to define a different proxy generation strategy than the " +"one used by default. Both would be achieved by defining a custom tuplizer " +"implementation. Tuplizers definitions are attached to the entity or " +"component mapping they are meant to manage. Going back to the example of our " +"customer entity:" msgstr "" +"Users may also plug in their own tuplizers. Perhaps you require that a " +"<literal>java.util.Map</literal> implementation other than <literal>java." +"util.HashMap</literal> be used while in the dynamic-map entity-mode; or " +"perhaps you need to define a different proxy generation strategy than the " +"one used by default. Both would be achieved by defining a custom tuplizer " +"implementation. Tuplizers definitions are attached to the entity or " +"component mapping they are meant to manage. Going back to the example of our " +"customer entity:" -#: index.docbook:317 +#. Tag: programlisting +#: persistent_classes.xml:317 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - " <class entity-name=\"Customer\">\n" - " \n" - " <tuplizer entity-mode=\"dynamic-map\"\n" - " class=\"CustomMapTuplizerImpl\"/>\n" - "\n" - " <id name=\"id\" type=\"long\" column=\"ID\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - "\n" - " \n" - " ...\n" - " </class>\n" - "</hibernate-mapping>\n" - "\n" - "\n" - "public class CustomMapTuplizerImpl\n" - " extends org.hibernate.tuple.entity.DynamicMapEntityTuplizer {\n" - " // override the buildInstantiator() method to plug in our custom map...\n" - " protected final Instantiator buildInstantiator(\n" - " org.hibernate.mapping.PersistentClass mappingInfo) {\n" - " return new CustomMapInstantiator( mappingInfo );\n" - " }\n" - "\n" - " private static final class CustomMapInstantiator\n" - " extends org.hibernate.tuple.DynamicMapInstantitor {\n" - " // override the generateMap() method to return our custom map...\n" - " protected final Map generateMap() {\n" - " return new CustomMap();\n" - " }\n" - " }\n" - "}]]>" +"<![CDATA[<hibernate-mapping>\n" +" <class entity-name=\"Customer\">\n" +" \n" +" <tuplizer entity-mode=\"dynamic-map\"\n" +" class=\"CustomMapTuplizerImpl\"/>\n" +"\n" +" <id name=\"id\" type=\"long\" column=\"ID\">\n" +" <generator class=\"sequence\"/>\n" +" </id>\n" +"\n" +" \n" +" ...\n" +" </class>\n" +"</hibernate-mapping>\n" +"\n" +"\n" +"public class CustomMapTuplizerImpl\n" +" extends org.hibernate.tuple.entity.DynamicMapEntityTuplizer {\n" +" // override the buildInstantiator() method to plug in our custom map...\n" +" protected final Instantiator buildInstantiator(\n" +" org.hibernate.mapping.PersistentClass mappingInfo) {\n" +" return new CustomMapInstantiator( mappingInfo );\n" +" }\n" +"\n" +" private static final class CustomMapInstantiator\n" +" extends org.hibernate.tuple.DynamicMapInstantitor {\n" +" // override the generateMap() method to return our custom map...\n" +" protected final Map generateMap() {\n" +" return new CustomMap();\n" +" }\n" +" }\n" +"}]]>" msgstr "" -#: index.docbook:322 -msgid "TODO: Document user-extension framework in the property and proxy packages" +#. Tag: para +#: persistent_classes.xml:322 +#, no-c-format +msgid "" +"TODO: Document user-extension framework in the property and proxy packages" msgstr "" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "" - +"TODO: Document user-extension framework in the property and proxy packages" Modified: core/trunk/documentation/manual/translations/pt-BR/content/preface.po =================================================================== --- core/trunk/documentation/manual/translations/pt-BR/content/preface.po 2007-10-25 22:34:46 UTC (rev 14134) +++ core/trunk/documentation/manual/translations/pt-BR/content/preface.po 2007-10-26 00:46:38 UTC (rev 14135) @@ -1,68 +1,204 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:21 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: preface.xml:21 +#, no-c-format msgid "Preface" -msgstr "" +msgstr "Prefácio" -#: index.docbook:23 -msgid "Working with object-oriented software and a relational database can be cumbersome and time consuming in today's enterprise environments. Hibernate is an object/relational mapping tool for Java environments. The term object/relational mapping (ORM) refers to the technique of mapping a data representation from an object model to a relational data model with a SQL-based schema." +#. Tag: para +#: preface.xml:23 +#, no-c-format +msgid "" +"Working with object-oriented software and a relational database can be " +"cumbersome and time consuming in today's enterprise environments. Hibernate " +"is an object/relational mapping tool for Java environments. The term object/" +"relational mapping (ORM) refers to the technique of mapping a data " +"representation from an object model to a relational data model with a SQL-" +"based schema." msgstr "" +"Trabalhando com software orientado a objetos e banco de dados relacional, " +"podemos ter alguns incômodos hoje em dia em ambientes empresariais. " +"Hibernate é uma ferramenta que mapeia o objeto/relacional para o ambiente " +"Java. O termo de mapeamento de objeto/relacional (ou ORM Object/Relational " +"Mapping) se refere a técnica de mapear uma representação de dados de um " +"modelo de objeto para dados de modelo relacional com o esquema baseado em SQL" -#: index.docbook:31 -msgid "Hibernate not only takes care of the mapping from Java classes to database tables (and from Java data types to SQL data types), but also provides data query and retrieval facilities and can significantly reduce development time otherwise spent with manual data handling in SQL and JDBC." +#. Tag: para +#: preface.xml:31 +#, no-c-format +msgid "" +"Hibernate not only takes care of the mapping from Java classes to database " +"tables (and from Java data types to SQL data types), but also provides data " +"query and retrieval facilities and can significantly reduce development time " +"otherwise spent with manual data handling in SQL and JDBC." msgstr "" +"O Hibernate não somente cuida do mapeamento de classes em Java para tabelas " +"de banco de dados (e de tipos de dados em Java para tipos de dados em SQL), " +"como também fornece facilidade de consultas e recuperação de dados, podendo " +"também reduzir significantemente o tempo de desenvolvimento gasto com a " +"manipulação manual de dados no SQL e JDBC." -#: index.docbook:38 -msgid "Hibernates goal is to relieve the developer from 95 percent of common data persistence related programming tasks. Hibernate may not be the best solution for data-centric applications that only use stored-procedures to implement the business logic in the database, it is most useful with object-oriented domain models and business logic in the Java-based middle-tier. However, Hibernate can certainly help you to remove or encapsulate vendor-specific SQL code and will help with the common task of result set translation from a tabular representation to a graph of objects." +#. Tag: para +#: preface.xml:38 +#, no-c-format +msgid "" +"Hibernates goal is to relieve the developer from 95 percent of common data " +"persistence related programming tasks. Hibernate may not be the best " +"solution for data-centric applications that only use stored-procedures to " +"implement the business logic in the database, it is most useful with object-" +"oriented domain models and business logic in the Java-based middle-tier. " +"However, Hibernate can certainly help you to remove or encapsulate vendor-" +"specific SQL code and will help with the common task of result set " +"translation from a tabular representation to a graph of objects." msgstr "" +"O objetivo do Hibernate é de aliviar o desenvolvedor de 95 por cento das " +"tarefas de programação relacionadas aos dados comuns de persistência. O " +"Hibernate talvez não seja a melhor solução para aplicações de dados-data-" +"centric que somente usa stored-procedures para implementar a lógica de " +"negócio no banco de dados, isto é muito utilizado com o domínio de modelos " +"orientado a objetos e lógicas de negócio em camadas do meio (middle-tier) " +"baseadas em Java. Porém, o Hibernate poderá certamente ajuda-lo a remover ou " +"encapsular o código SQL de um vendedor específico, ajudando também com a " +"tarefa comum da tradução do resultado ajustado de uma representação para um " +"gráfico de objetos." -#: index.docbook:48 -msgid "If you are new to Hibernate and Object/Relational Mapping or even Java, please follow these steps:" +#. Tag: para +#: preface.xml:48 +#, no-c-format +msgid "" +"If you are new to Hibernate and Object/Relational Mapping or even Java, " +"please follow these steps:" msgstr "" +"Se você for novo no Hibernate e no mapeamento Objeto/Relacional, ou até " +"mesmo em Java, por favor, siga os seguintes passos." -#: index.docbook:55 -msgid "Read <xref linkend=\"tutorial\"/> for a tutorial with step-by-step instructions. The source code for the tutorial is included in the distribution in the <literal>doc/reference/tutorial/</literal> directory." +#. Tag: para +#: preface.xml:55 +#, no-c-format +msgid "" +"Read <xref linkend=\"tutorial\"/> for a tutorial with step-by-step " +"instructions. The source code for the tutorial is included in the " +"distribution in the <literal>doc/reference/tutorial/</literal> directory." msgstr "" +"Leia <xref linkend=\"tutorial\"/> para um tutorial com instruções passo-a-" +"passo. O código fonte para do tutorial está incluído na distribuição no " +"diretório <literal>doc/reference/tutorial/</literal>." -#: index.docbook:63 -msgid "Read <xref linkend=\"architecture\"/> to understand the environments where Hibernate can be used." +#. Tag: para +#: preface.xml:63 +#, no-c-format +msgid "" +"Read <xref linkend=\"architecture\"/> to understand the environments where " +"Hibernate can be used." msgstr "" +"Leia o <xref linkend=\"architecture\"/> para entender o ambiente onde o " +"Hibernate pode ser utilizado." -#: index.docbook:69 -msgid "Have a look at the <literal>eg/</literal> directory in the Hibernate distribution, it contains a simple standalone application. Copy your JDBC driver to the <literal>lib/</literal> directory and edit <literal>etc/hibernate.properties</literal>, specifying correct values for your database. From a command prompt in the distribution directory, type <literal>ant eg</literal> (using Ant), or under Windows, type <literal>build eg</literal>." +#. Tag: para +#: preface.xml:69 +#, no-c-format +msgid "" +"Have a look at the <literal>eg/</literal> directory in the Hibernate " +"distribution, it contains a simple standalone application. Copy your JDBC " +"driver to the <literal>lib/</literal> directory and edit <literal>etc/" +"hibernate.properties</literal>, specifying correct values for your database. " +"From a command prompt in the distribution directory, type <literal>ant eg</" +"literal> (using Ant), or under Windows, type <literal>build eg</literal>." msgstr "" +"Dê uma olhada no diretório de exemplo <literal>eg/</literal> da distribuição " +"do Hibernate, ele contém uma simples aplicação standalone. Copie seu driver " +"JDBC para o diretório <literal>lib/</literal> e edite o arquivo <literal>etc/" +"hibernate.properties</literal>, especificando corretamente os valores para " +"seu banco de dados. Usando o prompt de commando no diretorio de " +"distribuicao, digite <literal>ant eg</literal> (usando Ant), ou no Windows, " +"digite <literal>build eg</literal>." -#: index.docbook:80 -msgid "Use this reference documentation as your primary source of information. Consider reading <emphasis>Java Persistence with Hibernate</emphasis> (http://www.manning.com/bauer2) if you need more help with application design or if you prefer a step-by-step tutorial. Also visit http://caveatemptor.hibernate.org and download the example application for Java Persistence with Hibernate." +#. Tag: para +#: preface.xml:80 +#, no-c-format +msgid "" +"Use this reference documentation as your primary source of information. " +"Consider reading <emphasis>Java Persistence with Hibernate</emphasis> " +"(http://www.manning.com/bauer2) if you need more help with application " +"design or if you prefer a step-by-step tutorial. Also visit http://" +"caveatemptor.hibernate.org and download the example application for Java " +"Persistence with Hibernate." msgstr "" +"Use esta documentação de referencia como sua fonte primaria de informação. " +"Considere ler também o livro <emphasis>Java Persistence with Hibernate</" +"emphasis> (http://www.manning.com/bauer2) caso você precise de mais ajuda " +"com o desenvolvimento de aplicações ou caso prefira um tutorial passo-a-" +"passo. Também visite o site http://caveatemptor.hibernate.org e faça o " +"download da aplicação de exemplo do Java Persistence with Hibernate." -#: index.docbook:90 +#. Tag: para +#: preface.xml:90 +#, no-c-format msgid "FAQs are answered on the Hibernate website." msgstr "" +"FAQs (perguntas feitas com mais freqüência) estão respondidas no site do " +"Hibernate" -#: index.docbook:95 -msgid "Third party demos, examples, and tutorials are linked on the Hibernate website." +#. Tag: para +#: preface.xml:95 +#, no-c-format +msgid "" +"Third party demos, examples, and tutorials are linked on the Hibernate " +"website." msgstr "" +"Demonstrações, exemplos e tutorials estão disponíveis no site do Hibernate." -#: index.docbook:101 -msgid "The Community Area on the Hibernate website is a good resource for design patterns and various integration solutions (Tomcat, JBoss AS, Struts, EJB, etc.)." +#. Tag: para +#: preface.xml:101 +#, no-c-format +msgid "" +"The Community Area on the Hibernate website is a good resource for design " +"patterns and various integration solutions (Tomcat, JBoss AS, Struts, EJB, " +"etc.)." msgstr "" +"A Área da comunidade no site do Hibernate é uma boa fonte de recursos para " +"padrões de projeto e várias soluções de integração (Tomcat, JBoss AS, " +"Struts, EJB, etc.)." -#: index.docbook:109 -msgid "If you have questions, use the user forum linked on the Hibernate website. We also provide a JIRA issue trackings system for bug reports and feature requests. If you are interested in the development of Hibernate, join the developer mailing list. If you are interested in translating this documentation into your language, contact us on the developer mailing list." +#. Tag: para +#: preface.xml:109 +#, no-c-format +msgid "" +"If you have questions, use the user forum linked on the Hibernate website. " +"We also provide a JIRA issue trackings system for bug reports and feature " +"requests. If you are interested in the development of Hibernate, join the " +"developer mailing list. If you are interested in translating this " +"documentation into your language, contact us on the developer mailing list." msgstr "" +"Caso você tenha dúvidas, use o fórum dos usuários encontrado no site do " +"Hibernate. Nós também fornecemos um sistema para controle de bugs (JIRA) " +"para relatórios de erros e requisições de features. Se você está interessado " +"no desenvolvimento do Hibernate, junte-se a lista de e-mail dos " +"desenvolvedores." -#: index.docbook:117 -msgid "Commercial development support, production support, and training for Hibernate is available through JBoss Inc. (see http://www.hibernate.org/SupportTraining/). Hibernate is a Professional Open Source project and a critical component of the JBoss Enterprise Middleware System (JEMS) suite of products." +#. Tag: para +#: preface.xml:117 +#, no-c-format +msgid "" +"Commercial development support, production support, and training for " +"Hibernate is available through JBoss Inc. (see http://www.hibernate.org/" +"SupportTraining/). Hibernate is a Professional Open Source project and a " +"critical component of the JBoss Enterprise Middleware System (JEMS) suite of " +"products." msgstr "" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "" - +"Suporte comercial de desenvolvimento, suporte de produção e treinamento para " +"o Hibernate está disponível através do JBoss Inc. (veja http://www.hibernate." +"org/SupportTraining). O Hibernate é um Projeto Profissional de Código Aberto " +"e um componente crítico da suíte de produtos JBoss Enterprise Middleware " +"System (JEMS)." Modified: core/trunk/documentation/manual/translations/pt-BR/content/query_criteria.po =================================================================== --- core/trunk/documentation/manual/translations/pt-BR/content/query_criteria.po 2007-10-25 22:34:46 UTC (rev 14134) +++ core/trunk/documentation/manual/translations/pt-BR/content/query_criteria.po 2007-10-26 00:46:38 UTC (rev 14135) @@ -1,484 +1,772 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: query_criteria.xml:5 +#, no-c-format msgid "Criteria Queries" -msgstr "" +msgstr "Consultas por critérios" -#: index.docbook:7 +#. Tag: para +#: query_criteria.xml:7 +#, no-c-format msgid "Hibernate features an intuitive, extensible criteria query API." -msgstr "" +msgstr "O Hibernate provê uma intuitiva e extensível API de critério de query." -#: index.docbook:12 +#. Tag: title +#: query_criteria.xml:12 +#, no-c-format msgid "Creating a <literal>Criteria</literal> instance" -msgstr "" +msgstr "Criando uma instancia <literal>Criteria</literal>" -#: index.docbook:14 -msgid "The interface <literal>org.hibernate.Criteria</literal> represents a query against a particular persistent class. The <literal>Session</literal> is a factory for <literal>Criteria</literal> instances." +#. Tag: para +#: query_criteria.xml:14 +#, no-c-format +msgid "" +"The interface <literal>org.hibernate.Criteria</literal> represents a query " +"against a particular persistent class. The <literal>Session</literal> is a " +"factory for <literal>Criteria</literal> instances." msgstr "" +"A interface <literal>org.hibernate.Criteria</literal> representa a query ao " +"invés de uma classe persistente particular. A sessão é uma fábrica para " +"intancias de <literal>Criteria</literal> ." -#: index.docbook:20 +#. Tag: programlisting +#: query_criteria.xml:20 +#, no-c-format msgid "" - "<![CDATA[Criteria crit = sess.createCriteria(Cat.class);\n" - "crit.setMaxResults(50);\n" - "List cats = crit.list();]]>" +"<![CDATA[Criteria crit = sess.createCriteria(Cat.class);\n" +"crit.setMaxResults(50);\n" +"List cats = crit.list();]]>" msgstr "" -#: index.docbook:25 +#. Tag: title +#: query_criteria.xml:25 +#, no-c-format msgid "Narrowing the result set" -msgstr "" +msgstr "Limitando o result set" -#: index.docbook:27 -msgid "An individual query criterion is an instance of the interface <literal>org.hibernate.criterion.Criterion</literal>. The class <literal>org.hibernate.criterion.Restrictions</literal> defines factory methods for obtaining certain built-in <literal>Criterion</literal> types." +#. Tag: para +#: query_criteria.xml:27 +#, no-c-format +msgid "" +"An individual query criterion is an instance of the interface <literal>org." +"hibernate.criterion.Criterion</literal>. The class <literal>org.hibernate." +"criterion.Restrictions</literal> defines factory methods for obtaining " +"certain built-in <literal>Criterion</literal> types." msgstr "" +"Um critério individual de query é uma instancia da interface <literal>org." +"hibernate.criterion.Criterion</literal>. A classe <literal>org.hibernate." +"criterion.Restrictions</literal> define os métodos da fábrica para obter " +"certos tipos pré fabricados de <literal>Criterion</literal>." -#: index.docbook:35 +#. Tag: programlisting +#: query_criteria.xml:35 +#, no-c-format msgid "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .add( Restrictions.like(\"name\", \"Fritz%\") )\n" - " .add( Restrictions.between(\"weight\", minWeight, maxWeight) )\n" - " .list();]]>" +"<![CDATA[List cats = sess.createCriteria(Cat.class)\n" +" .add( Restrictions.like(\"name\", \"Fritz%\") )\n" +" .add( Restrictions.between(\"weight\", minWeight, maxWeight) )\n" +" .list();]]>" msgstr "" -#: index.docbook:37 +#. Tag: para +#: query_criteria.xml:37 +#, no-c-format msgid "Restrictions may be grouped logically." -msgstr "" +msgstr "Restrições podem ser logicamente agrupadas." -#: index.docbook:41 +#. Tag: programlisting +#: query_criteria.xml:41 +#, no-c-format msgid "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .add( Restrictions.like(\"name\", \"Fritz%\") )\n" - " .add( Restrictions.or(\n" - " Restrictions.eq( \"age\", new Integer(0) ),\n" - " Restrictions.isNull(\"age\")\n" - " ) )\n" - " .list();]]>" +"<![CDATA[List cats = sess.createCriteria(Cat.class)\n" +" .add( Restrictions.like(\"name\", \"Fritz%\") )\n" +" .add( Restrictions.or(\n" +" Restrictions.eq( \"age\", new Integer(0) ),\n" +" Restrictions.isNull(\"age\")\n" +" ) )\n" +" .list();]]>" msgstr "" -#: index.docbook:43 +#. Tag: programlisting +#: query_criteria.xml:43 +#, no-c-format msgid "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .add( Restrictions.in( \"name\", new String[] { \"Fritz\", \"Izi\", \"Pk\" } ) )\n" - " .add( Restrictions.disjunction()\n" - " .add( Restrictions.isNull(\"age\") )\n" - " .add( Restrictions.eq(\"age\", new Integer(0) ) )\n" - " .add( Restrictions.eq(\"age\", new Integer(1) ) )\n" - " .add( Restrictions.eq(\"age\", new Integer(2) ) )\n" - " ) )\n" - " .list();]]>" +"<![CDATA[List cats = sess.createCriteria(Cat.class)\n" +" .add( Restrictions.in( \"name\", new String[] { \"Fritz\", \"Izi\", \"Pk" +"\" } ) )\n" +" .add( Restrictions.disjunction()\n" +" .add( Restrictions.isNull(\"age\") )\n" +" .add( Restrictions.eq(\"age\", new Integer(0) ) )\n" +" .add( Restrictions.eq(\"age\", new Integer(1) ) )\n" +" .add( Restrictions.eq(\"age\", new Integer(2) ) )\n" +" ) )\n" +" .list();]]>" msgstr "" -#: index.docbook:45 -msgid "There are quite a range of built-in criterion types (<literal>Restrictions</literal> subclasses), but one that is especially useful lets you specify SQL directly." +#. Tag: para +#: query_criteria.xml:45 +#, no-c-format +msgid "" +"There are quite a range of built-in criterion types (<literal>Restrictions</" +"literal> subclasses), but one that is especially useful lets you specify SQL " +"directly." msgstr "" +"Existe um grande número de critérios pré fabricados (subclasses de " +"<literal>Restrictions</literal>), mas um é especialmente útil pois permite " +"especificar o SQL diretamente." -#: index.docbook:50 +#. Tag: programlisting +#: query_criteria.xml:50 +#, no-c-format msgid "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .add( Restrictions.sqlRestriction(\"lower({alias}.name) like lower(?)\", \"Fritz%\", Hibernate.STRING) )\n" - " .list();]]>" +"<![CDATA[List cats = sess.createCriteria(Cat.class)\n" +" .add( Restrictions.sqlRestriction(\"lower({alias}.name) like lower(?)\", " +"\"Fritz%\", Hibernate.STRING) )\n" +" .list();]]>" msgstr "" -#: index.docbook:52 -msgid "The <literal>{alias}</literal> placeholder with be replaced by the row alias of the queried entity." +#. Tag: para +#: query_criteria.xml:52 +#, no-c-format +msgid "" +"The <literal>{alias}</literal> placeholder with be replaced by the row alias " +"of the queried entity." msgstr "" +"O parametro <literal>{alias}</literal> será substituido pelo alias da " +"entidade procurada." -#: index.docbook:57 -msgid "An alternative approach to obtaining a criterion is to get it from a <literal>Property</literal> instance. You can create a <literal>Property</literal> by calling <literal>Property.forName()</literal>." +#. Tag: para +#: query_criteria.xml:57 +#, no-c-format +msgid "" +"An alternative approach to obtaining a criterion is to get it from a " +"<literal>Property</literal> instance. You can create a <literal>Property</" +"literal> by calling <literal>Property.forName()</literal>." msgstr "" +"Uma maneira alternativa de obter um critério é pegá-lo de uma instancia de " +"<literal>Property</literal>. Você pode criar uma <literal>Property</literal> " +"chamando <literal>Property.forName()</literal>." -#: index.docbook:63 +#. Tag: programlisting +#: query_criteria.xml:63 +#, no-c-format msgid "" - "<![CDATA[\n" - "Property age = Property.forName(\"age\");\n" - "List cats = sess.createCriteria(Cat.class)\n" - " .add( Restrictions.disjunction()\n" - " .add( age.isNull() )\n" - " .add( age.eq( new Integer(0) ) )\n" - " .add( age.eq( new Integer(1) ) )\n" - " .add( age.eq( new Integer(2) ) )\n" - " ) )\n" - " .add( Property.forName(\"name\").in( new String[] { \"Fritz\", \"Izi\", \"Pk\" } ) )\n" - " .list();]]>" +"<![CDATA[\n" +"Property age = Property.forName(\"age\");\n" +"List cats = sess.createCriteria(Cat.class)\n" +" .add( Restrictions.disjunction()\n" +" .add( age.isNull() )\n" +" .add( age.eq( new Integer(0) ) )\n" +" .add( age.eq( new Integer(1) ) )\n" +" .add( age.eq( new Integer(2) ) )\n" +" ) )\n" +" .add( Property.forName(\"name\").in( new String[] { \"Fritz\", \"Izi\", " +"\"Pk\" } ) )\n" +" .list();]]>" msgstr "" -#: index.docbook:68 +#. Tag: title +#: query_criteria.xml:68 +#, no-c-format msgid "Ordering the results" -msgstr "" +msgstr "Ordering the results" -#: index.docbook:70 -msgid "You may order the results using <literal>org.hibernate.criterion.Order</literal>." +#. Tag: para +#: query_criteria.xml:70 +#, no-c-format +msgid "" +"You may order the results using <literal>org.hibernate.criterion.Order</" +"literal>." msgstr "" +"You may order the results using <literal>org.hibernate.criterion.Order</" +"literal>." -#: index.docbook:74 +#. Tag: programlisting +#: query_criteria.xml:74 +#, no-c-format msgid "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .add( Restrictions.like(\"name\", \"F%\")\n" - " .addOrder( Order.asc(\"name\") )\n" - " .addOrder( Order.desc(\"age\") )\n" - " .setMaxResults(50)\n" - " .list();]]>" +"<![CDATA[List cats = sess.createCriteria(Cat.class)\n" +" .add( Restrictions.like(\"name\", \"F%\")\n" +" .addOrder( Order.asc(\"name\") )\n" +" .addOrder( Order.desc(\"age\") )\n" +" .setMaxResults(50)\n" +" .list();]]>" msgstr "" -#: index.docbook:76 +#. Tag: programlisting +#: query_criteria.xml:76 +#, no-c-format msgid "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .add( Property.forName(\"name\").like(\"F%\") )\n" - " .addOrder( Property.forName(\"name\").asc() )\n" - " .addOrder( Property.forName(\"age\").desc() )\n" - " .setMaxResults(50)\n" - " .list();]]>" +"<![CDATA[List cats = sess.createCriteria(Cat.class)\n" +" .add( Property.forName(\"name\").like(\"F%\") )\n" +" .addOrder( Property.forName(\"name\").asc() )\n" +" .addOrder( Property.forName(\"age\").desc() )\n" +" .setMaxResults(50)\n" +" .list();]]>" msgstr "" -#: index.docbook:81 +#. Tag: title +#: query_criteria.xml:81 +#, no-c-format msgid "Associations" -msgstr "" +msgstr "Associations" -#: index.docbook:83 -msgid "You may easily specify constraints upon related entities by navigating associations using <literal>createCriteria()</literal>." +#. Tag: para +#: query_criteria.xml:83 +#, no-c-format +msgid "" +"You may easily specify constraints upon related entities by navigating " +"associations using <literal>createCriteria()</literal>." msgstr "" +"You may easily specify constraints upon related entities by navigating " +"associations using <literal>createCriteria()</literal>." -#: index.docbook:88 +#. Tag: programlisting +#: query_criteria.xml:88 +#, no-c-format msgid "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .add( Restrictions.like(\"name\", \"F%\") )\n" - " .createCriteria(\"kittens\")\n" - " .add( Restrictions.like(\"name\", \"F%\") )\n" - " .list();]]>" +"<![CDATA[List cats = sess.createCriteria(Cat.class)\n" +" .add( Restrictions.like(\"name\", \"F%\") )\n" +" .createCriteria(\"kittens\")\n" +" .add( Restrictions.like(\"name\", \"F%\") )\n" +" .list();]]>" msgstr "" -#: index.docbook:90 -msgid "note that the second <literal>createCriteria()</literal> returns a new instance of <literal>Criteria</literal>, which refers to the elements of the <literal>kittens</literal> collection." +#. Tag: para +#: query_criteria.xml:90 +#, no-c-format +msgid "" +"note that the second <literal>createCriteria()</literal> returns a new " +"instance of <literal>Criteria</literal>, which refers to the elements of the " +"<literal>kittens</literal> collection." msgstr "" +"note that the second <literal>createCriteria()</literal> returns a new " +"instance of <literal>Criteria</literal>, which refers to the elements of the " +"<literal>kittens</literal> collection." -#: index.docbook:96 +#. Tag: para +#: query_criteria.xml:96 +#, no-c-format msgid "The following, alternate form is useful in certain circumstances." -msgstr "" +msgstr "The following, alternate form is useful in certain circumstances." -#: index.docbook:100 +#. Tag: programlisting +#: query_criteria.xml:100 +#, no-c-format msgid "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .createAlias(\"kittens\", \"kt\")\n" - " .createAlias(\"mate\", \"mt\")\n" - " .add( Restrictions.eqProperty(\"kt.name\", \"mt.name\") )\n" - " .list();]]>" +"<![CDATA[List cats = sess.createCriteria(Cat.class)\n" +" .createAlias(\"kittens\", \"kt\")\n" +" .createAlias(\"mate\", \"mt\")\n" +" .add( Restrictions.eqProperty(\"kt.name\", \"mt.name\") )\n" +" .list();]]>" msgstr "" -#: index.docbook:102 -msgid "(<literal>createAlias()</literal> does not create a new instance of <literal>Criteria</literal>.)" +#. Tag: para +#: query_criteria.xml:102 +#, no-c-format +msgid "" +"(<literal>createAlias()</literal> does not create a new instance of " +"<literal>Criteria</literal>.)" msgstr "" +"(<literal>createAlias()</literal> does not create a new instance of " +"<literal>Criteria</literal>.)" -#: index.docbook:107 -msgid "Note that the kittens collections held by the <literal>Cat</literal> instances returned by the previous two queries are <emphasis>not</emphasis> pre-filtered by the criteria! If you wish to retrieve just the kittens that match the criteria, you must use a <literal>ResultTransformer</literal>." +#. Tag: para +#: query_criteria.xml:107 +#, no-c-format +msgid "" +"Note that the kittens collections held by the <literal>Cat</literal> " +"instances returned by the previous two queries are <emphasis>not</emphasis> " +"pre-filtered by the criteria! If you wish to retrieve just the kittens that " +"match the criteria, you must use a <literal>ResultTransformer</literal>." msgstr "" +"Note that the kittens collections held by the <literal>Cat</literal> " +"instances returned by the previous two queries are <emphasis>not</emphasis> " +"pre-filtered by the criteria! If you wish to retrieve just the kittens that " +"match the criteria, you must use a <literal>ResultTransformer</literal>." -#: index.docbook:114 +#. Tag: programlisting +#: query_criteria.xml:114 +#, no-c-format msgid "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .createCriteria(\"kittens\", \"kt\")\n" - " .add( Restrictions.eq(\"name\", \"F%\") )\n" - " .setResultTransformer(Criteria.ALIAS_TO_ENTITY_MAP)\n" - " .list();\n" - "Iterator iter = cats.iterator();\n" - "while ( iter.hasNext() ) {\n" - " Map map = (Map) iter.next();\n" - " Cat cat = (Cat) map.get(Criteria.ROOT_ALIAS);\n" - " Cat kitten = (Cat) map.get(\"kt\");\n" - "}]]>" +"<![CDATA[List cats = sess.createCriteria(Cat.class)\n" +" .createCriteria(\"kittens\", \"kt\")\n" +" .add( Restrictions.eq(\"name\", \"F%\") )\n" +" .setResultTransformer(Criteria.ALIAS_TO_ENTITY_MAP)\n" +" .list();\n" +"Iterator iter = cats.iterator();\n" +"while ( iter.hasNext() ) {\n" +" Map map = (Map) iter.next();\n" +" Cat cat = (Cat) map.get(Criteria.ROOT_ALIAS);\n" +" Cat kitten = (Cat) map.get(\"kt\");\n" +"}]]>" msgstr "" -#: index.docbook:119 +#. Tag: title +#: query_criteria.xml:119 +#, no-c-format msgid "Dynamic association fetching" -msgstr "" +msgstr "Dynamic association fetching" -#: index.docbook:121 -msgid "You may specify association fetching semantics at runtime using <literal>setFetchMode()</literal>." +#. Tag: para +#: query_criteria.xml:121 +#, no-c-format +msgid "" +"You may specify association fetching semantics at runtime using " +"<literal>setFetchMode()</literal>." msgstr "" +"You may specify association fetching semantics at runtime using " +"<literal>setFetchMode()</literal>." -#: index.docbook:126 +#. Tag: programlisting +#: query_criteria.xml:126 +#, no-c-format msgid "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .add( Restrictions.like(\"name\", \"Fritz%\") )\n" - " .setFetchMode(\"mate\", FetchMode.EAGER)\n" - " .setFetchMode(\"kittens\", FetchMode.EAGER)\n" - " .list();]]>" +"<![CDATA[List cats = sess.createCriteria(Cat.class)\n" +" .add( Restrictions.like(\"name\", \"Fritz%\") )\n" +" .setFetchMode(\"mate\", FetchMode.EAGER)\n" +" .setFetchMode(\"kittens\", FetchMode.EAGER)\n" +" .list();]]>" msgstr "" -#: index.docbook:128 -msgid "This query will fetch both <literal>mate</literal> and <literal>kittens</literal> by outer join. See <xref linkend=\"performance-fetching\"/> for more information." +#. Tag: para +#: query_criteria.xml:128 +#, no-c-format +msgid "" +"This query will fetch both <literal>mate</literal> and <literal>kittens</" +"literal> by outer join. See <xref linkend=\"performance-fetching\"/> for " +"more information." msgstr "" +"This query will fetch both <literal>mate</literal> and <literal>kittens</" +"literal> by outer join. See <xref linkend=\"performance-fetching\"/> for " +"more information." -#: index.docbook:136 +#. Tag: title +#: query_criteria.xml:136 +#, no-c-format msgid "Example queries" -msgstr "" +msgstr "Example queries" -#: index.docbook:138 -msgid "The class <literal>org.hibernate.criterion.Example</literal> allows you to construct a query criterion from a given instance." +#. Tag: para +#: query_criteria.xml:138 +#, no-c-format +msgid "" +"The class <literal>org.hibernate.criterion.Example</literal> allows you to " +"construct a query criterion from a given instance." msgstr "" +"The class <literal>org.hibernate.criterion.Example</literal> allows you to " +"construct a query criterion from a given instance." -#: index.docbook:143 +#. Tag: programlisting +#: query_criteria.xml:143 +#, no-c-format msgid "" - "<![CDATA[Cat cat = new Cat();\n" - "cat.setSex('F');\n" - "cat.setColor(Color.BLACK);\n" - "List results = session.createCriteria(Cat.class)\n" - " .add( Example.create(cat) )\n" - " .list();]]>" +"<![CDATA[Cat cat = new Cat();\n" +"cat.setSex('F');\n" +"cat.setColor(Color.BLACK);\n" +"List results = session.createCriteria(Cat.class)\n" +" .add( Example.create(cat) )\n" +" .list();]]>" msgstr "" -#: index.docbook:145 -msgid "Version properties, identifiers and associations are ignored. By default, null valued properties are excluded." +#. Tag: para +#: query_criteria.xml:145 +#, no-c-format +msgid "" +"Version properties, identifiers and associations are ignored. By default, " +"null valued properties are excluded." msgstr "" +"Version properties, identifiers and associations are ignored. By default, " +"null valued properties are excluded." -#: index.docbook:150 +#. Tag: para +#: query_criteria.xml:150 +#, no-c-format msgid "You can adjust how the <literal>Example</literal> is applied." -msgstr "" +msgstr "You can adjust how the <literal>Example</literal> is applied." -#: index.docbook:154 +#. Tag: programlisting +#: query_criteria.xml:154 +#, no-c-format msgid "" - "<![CDATA[Example example = Example.create(cat)\n" - " .excludeZeroes() //exclude zero valued properties\n" - " .excludeProperty(\"color\") //exclude the property named \"color\"\n" - " .ignoreCase() //perform case insensitive string comparisons\n" - " .enableLike(); //use like for string comparisons\n" - "List results = session.createCriteria(Cat.class)\n" - " .add(example)\n" - " .list();]]>" +"<![CDATA[Example example = Example.create(cat)\n" +" .excludeZeroes() //exclude zero valued properties\n" +" .excludeProperty(\"color\") //exclude the property named \"color\"\n" +" .ignoreCase() //perform case insensitive string " +"comparisons\n" +" .enableLike(); //use like for string comparisons\n" +"List results = session.createCriteria(Cat.class)\n" +" .add(example)\n" +" .list();]]>" msgstr "" -#: index.docbook:156 +#. Tag: para +#: query_criteria.xml:156 +#, no-c-format msgid "You can even use examples to place criteria upon associated objects." -msgstr "" +msgstr "You can even use examples to place criteria upon associated objects." -#: index.docbook:160 +#. Tag: programlisting +#: query_criteria.xml:160 +#, no-c-format msgid "" - "<![CDATA[List results = session.createCriteria(Cat.class)\n" - " .add( Example.create(cat) )\n" - " .createCriteria(\"mate\")\n" - " .add( Example.create( cat.getMate() ) )\n" - " .list();]]>" +"<![CDATA[List results = session.createCriteria(Cat.class)\n" +" .add( Example.create(cat) )\n" +" .createCriteria(\"mate\")\n" +" .add( Example.create( cat.getMate() ) )\n" +" .list();]]>" msgstr "" -#: index.docbook:165 +#. Tag: title +#: query_criteria.xml:165 +#, no-c-format msgid "Projections, aggregation and grouping" -msgstr "" +msgstr "Projections, aggregation and grouping" -#: index.docbook:166 -msgid "The class <literal>org.hibernate.criterion.Projections</literal> is a factory for <literal>Projection</literal> instances. We apply a projection to a query by calling <literal>setProjection()</literal>." +#. Tag: para +#: query_criteria.xml:166 +#, no-c-format +msgid "" +"The class <literal>org.hibernate.criterion.Projections</literal> is a " +"factory for <literal>Projection</literal> instances. We apply a projection " +"to a query by calling <literal>setProjection()</literal>." msgstr "" +"The class <literal>org.hibernate.criterion.Projections</literal> is a " +"factory for <literal>Projection</literal> instances. We apply a projection " +"to a query by calling <literal>setProjection()</literal>." -#: index.docbook:172 +#. Tag: programlisting +#: query_criteria.xml:172 +#, no-c-format msgid "" - "<![CDATA[List results = session.createCriteria(Cat.class)\n" - " .setProjection( Projections.rowCount() )\n" - " .add( Restrictions.eq(\"color\", Color.BLACK) )\n" - " .list();]]>" +"<![CDATA[List results = session.createCriteria(Cat.class)\n" +" .setProjection( Projections.rowCount() )\n" +" .add( Restrictions.eq(\"color\", Color.BLACK) )\n" +" .list();]]>" msgstr "" -#: index.docbook:174 +#. Tag: programlisting +#: query_criteria.xml:174 +#, no-c-format msgid "" - "<![CDATA[List results = session.createCriteria(Cat.class)\n" - " .setProjection( Projections.projectionList()\n" - " .add( Projections.rowCount() )\n" - " .add( Projections.avg(\"weight\") )\n" - " .add( Projections.max(\"weight\") )\n" - " .add( Projections.groupProperty(\"color\") )\n" - " )\n" - " .list();]]>" +"<![CDATA[List results = session.createCriteria(Cat.class)\n" +" .setProjection( Projections.projectionList()\n" +" .add( Projections.rowCount() )\n" +" .add( Projections.avg(\"weight\") )\n" +" .add( Projections.max(\"weight\") )\n" +" .add( Projections.groupProperty(\"color\") )\n" +" )\n" +" .list();]]>" msgstr "" -#: index.docbook:176 -msgid "There is no explicit \"group by\" necessary in a criteria query. Certain projection types are defined to be <emphasis>grouping projections</emphasis>, which also appear in the SQL <literal>group by</literal> clause." +#. Tag: para +#: query_criteria.xml:176 +#, no-c-format +msgid "" +"There is no explicit \"group by\" necessary in a criteria query. Certain " +"projection types are defined to be <emphasis>grouping projections</" +"emphasis>, which also appear in the SQL <literal>group by</literal> clause." msgstr "" +"There is no explicit \"group by\" necessary in a criteria query. Certain " +"projection types are defined to be <emphasis>grouping projections</" +"emphasis>, which also appear in the SQL <literal>group by</literal> clause." -#: index.docbook:182 -msgid "An alias may optionally be assigned to a projection, so that the projected value may be referred to in restrictions or orderings. Here are two different ways to do this:" +#. Tag: para +#: query_criteria.xml:182 +#, no-c-format +msgid "" +"An alias may optionally be assigned to a projection, so that the projected " +"value may be referred to in restrictions or orderings. Here are two " +"different ways to do this:" msgstr "" +"An alias may optionally be assigned to a projection, so that the projected " +"value may be referred to in restrictions or orderings. Here are two " +"different ways to do this:" -#: index.docbook:188 +#. Tag: programlisting +#: query_criteria.xml:188 +#, no-c-format msgid "" - "<![CDATA[List results = session.createCriteria(Cat.class)\n" - " .setProjection( Projections.alias( Projections.groupProperty(\"color\"), \"colr\" ) )\n" - " .addOrder( Order.asc(\"colr\") )\n" - " .list();]]>" +"<![CDATA[List results = session.createCriteria(Cat.class)\n" +" .setProjection( Projections.alias( Projections.groupProperty(\"color\"), " +"\"colr\" ) )\n" +" .addOrder( Order.asc(\"colr\") )\n" +" .list();]]>" msgstr "" -#: index.docbook:190 +#. Tag: programlisting +#: query_criteria.xml:190 +#, no-c-format msgid "" - "<![CDATA[List results = session.createCriteria(Cat.class)\n" - " .setProjection( Projections.groupProperty(\"color\").as(\"colr\") )\n" - " .addOrder( Order.asc(\"colr\") )\n" - " .list();]]>" +"<![CDATA[List results = session.createCriteria(Cat.class)\n" +" .setProjection( Projections.groupProperty(\"color\").as(\"colr\") )\n" +" .addOrder( Order.asc(\"colr\") )\n" +" .list();]]>" msgstr "" -#: index.docbook:192 -msgid "The <literal>alias()</literal> and <literal>as()</literal> methods simply wrap a projection instance in another, aliased, instance of <literal>Projection</literal>. As a shortcut, you can assign an alias when you add the projection to a projection list:" +#. Tag: para +#: query_criteria.xml:192 +#, no-c-format +msgid "" +"The <literal>alias()</literal> and <literal>as()</literal> methods simply " +"wrap a projection instance in another, aliased, instance of " +"<literal>Projection</literal>. As a shortcut, you can assign an alias when " +"you add the projection to a projection list:" msgstr "" +"The <literal>alias()</literal> and <literal>as()</literal> methods simply " +"wrap a projection instance in another, aliased, instance of " +"<literal>Projection</literal>. As a shortcut, you can assign an alias when " +"you add the projection to a projection list:" -#: index.docbook:199 +#. Tag: programlisting +#: query_criteria.xml:199 +#, no-c-format msgid "" - "<![CDATA[List results = session.createCriteria(Cat.class)\n" - " .setProjection( Projections.projectionList()\n" - " .add( Projections.rowCount(), \"catCountByColor\" )\n" - " .add( Projections.avg(\"weight\"), \"avgWeight\" )\n" - " .add( Projections.max(\"weight\"), \"maxWeight\" )\n" - " .add( Projections.groupProperty(\"color\"), \"color\" )\n" - " )\n" - " .addOrder( Order.desc(\"catCountByColor\") )\n" - " .addOrder( Order.desc(\"avgWeight\") )\n" - " .list();]]>" +"<![CDATA[List results = session.createCriteria(Cat.class)\n" +" .setProjection( Projections.projectionList()\n" +" .add( Projections.rowCount(), \"catCountByColor\" )\n" +" .add( Projections.avg(\"weight\"), \"avgWeight\" )\n" +" .add( Projections.max(\"weight\"), \"maxWeight\" )\n" +" .add( Projections.groupProperty(\"color\"), \"color\" )\n" +" )\n" +" .addOrder( Order.desc(\"catCountByColor\") )\n" +" .addOrder( Order.desc(\"avgWeight\") )\n" +" .list();]]>" msgstr "" -#: index.docbook:201 +#. Tag: programlisting +#: query_criteria.xml:201 +#, no-c-format msgid "" - "<![CDATA[List results = session.createCriteria(Domestic.class, \"cat\")\n" - " .createAlias(\"kittens\", \"kit\")\n" - " .setProjection( Projections.projectionList()\n" - " .add( Projections.property(\"cat.name\"), \"catName\" )\n" - " .add( Projections.property(\"kit.name\"), \"kitName\" )\n" - " )\n" - " .addOrder( Order.asc(\"catName\") )\n" - " .addOrder( Order.asc(\"kitName\") )\n" - " .list();]]>" +"<![CDATA[List results = session.createCriteria(Domestic.class, \"cat\")\n" +" .createAlias(\"kittens\", \"kit\")\n" +" .setProjection( Projections.projectionList()\n" +" .add( Projections.property(\"cat.name\"), \"catName\" )\n" +" .add( Projections.property(\"kit.name\"), \"kitName\" )\n" +" )\n" +" .addOrder( Order.asc(\"catName\") )\n" +" .addOrder( Order.asc(\"kitName\") )\n" +" .list();]]>" msgstr "" -#: index.docbook:203 -msgid "You can also use <literal>Property.forName()</literal> to express projections:" +#. Tag: para +#: query_criteria.xml:203 +#, no-c-format +msgid "" +"You can also use <literal>Property.forName()</literal> to express " +"projections:" msgstr "" +"You can also use <literal>Property.forName()</literal> to express " +"projections:" -#: index.docbook:207 +#. Tag: programlisting +#: query_criteria.xml:207 +#, no-c-format msgid "" - "<![CDATA[List results = session.createCriteria(Cat.class)\n" - " .setProjection( Property.forName(\"name\") )\n" - " .add( Property.forName(\"color\").eq(Color.BLACK) )\n" - " .list();]]>" +"<![CDATA[List results = session.createCriteria(Cat.class)\n" +" .setProjection( Property.forName(\"name\") )\n" +" .add( Property.forName(\"color\").eq(Color.BLACK) )\n" +" .list();]]>" msgstr "" -#: index.docbook:209 +#. Tag: programlisting +#: query_criteria.xml:209 +#, no-c-format msgid "" - "<![CDATA[List results = session.createCriteria(Cat.class)\n" - " .setProjection( Projections.projectionList()\n" - " .add( Projections.rowCount().as(\"catCountByColor\") )\n" - " .add( Property.forName(\"weight\").avg().as(\"avgWeight\") )\n" - " .add( Property.forName(\"weight\").max().as(\"maxWeight\") )\n" - " .add( Property.forName(\"color\").group().as(\"color\" )\n" - " )\n" - " .addOrder( Order.desc(\"catCountByColor\") )\n" - " .addOrder( Order.desc(\"avgWeight\") )\n" - " .list();]]>" +"<![CDATA[List results = session.createCriteria(Cat.class)\n" +" .setProjection( Projections.projectionList()\n" +" .add( Projections.rowCount().as(\"catCountByColor\") )\n" +" .add( Property.forName(\"weight\").avg().as(\"avgWeight\") )\n" +" .add( Property.forName(\"weight\").max().as(\"maxWeight\") )\n" +" .add( Property.forName(\"color\").group().as(\"color\" )\n" +" )\n" +" .addOrder( Order.desc(\"catCountByColor\") )\n" +" .addOrder( Order.desc(\"avgWeight\") )\n" +" .list();]]>" msgstr "" -#: index.docbook:214 +#. Tag: title +#: query_criteria.xml:214 +#, no-c-format msgid "Detached queries and subqueries" -msgstr "" +msgstr "Detached queries and subqueries" -#: index.docbook:215 -msgid "The <literal>DetachedCriteria</literal> class lets you create a query outside the scope of a session, and then later execute it using some arbitrary <literal>Session</literal>." +#. Tag: para +#: query_criteria.xml:215 +#, no-c-format +msgid "" +"The <literal>DetachedCriteria</literal> class lets you create a query " +"outside the scope of a session, and then later execute it using some " +"arbitrary <literal>Session</literal>." msgstr "" +"The <literal>DetachedCriteria</literal> class lets you create a query " +"outside the scope of a session, and then later execute it using some " +"arbitrary <literal>Session</literal>." -#: index.docbook:220 +#. Tag: programlisting +#: query_criteria.xml:220 +#, no-c-format msgid "" - "<![CDATA[DetachedCriteria query = DetachedCriteria.forClass(Cat.class)\n" - " .add( Property.forName(\"sex\").eq('F') );\n" - " \n" - "Session session = ....;\n" - "Transaction txn = session.beginTransaction();\n" - "List results = query.getExecutableCriteria(session).setMaxResults(100).list();\n" - "txn.commit();\n" - "session.close();]]>" +"<![CDATA[DetachedCriteria query = DetachedCriteria.forClass(Cat.class)\n" +" .add( Property.forName(\"sex\").eq('F') );\n" +" \n" +"Session session = ....;\n" +"Transaction txn = session.beginTransaction();\n" +"List results = query.getExecutableCriteria(session).setMaxResults(100).list" +"();\n" +"txn.commit();\n" +"session.close();]]>" msgstr "" -#: index.docbook:222 -msgid "A <literal>DetachedCriteria</literal> may also be used to express a subquery. Criterion instances involving subqueries may be obtained via <literal>Subqueries</literal> or <literal>Property</literal>." +#. Tag: para +#: query_criteria.xml:222 +#, no-c-format +msgid "" +"A <literal>DetachedCriteria</literal> may also be used to express a " +"subquery. Criterion instances involving subqueries may be obtained via " +"<literal>Subqueries</literal> or <literal>Property</literal>." msgstr "" +"A <literal>DetachedCriteria</literal> may also be used to express a " +"subquery. Criterion instances involving subqueries may be obtained via " +"<literal>Subqueries</literal> or <literal>Property</literal>." -#: index.docbook:228 +#. Tag: programlisting +#: query_criteria.xml:228 +#, no-c-format msgid "" - "<![CDATA[DetachedCriteria avgWeight = DetachedCriteria.forClass(Cat.class)\n" - " .setProjection( Property.forName(\"weight\").avg() );\n" - "session.createCriteria(Cat.class)\n" - " .add( Property.forName(\"weight\").gt(avgWeight) )\n" - " .list();]]>" +"<![CDATA[DetachedCriteria avgWeight = DetachedCriteria.forClass(Cat.class)\n" +" .setProjection( Property.forName(\"weight\").avg() );\n" +"session.createCriteria(Cat.class)\n" +" .add( Property.forName(\"weight\").gt(avgWeight) )\n" +" .list();]]>" msgstr "" -#: index.docbook:230 +#. Tag: programlisting +#: query_criteria.xml:230 +#, no-c-format msgid "" - "<![CDATA[DetachedCriteria weights = DetachedCriteria.forClass(Cat.class)\n" - " .setProjection( Property.forName(\"weight\") );\n" - "session.createCriteria(Cat.class)\n" - " .add( Subqueries.geAll(\"weight\", weights) )\n" - " .list();]]>" +"<![CDATA[DetachedCriteria weights = DetachedCriteria.forClass(Cat.class)\n" +" .setProjection( Property.forName(\"weight\") );\n" +"session.createCriteria(Cat.class)\n" +" .add( Subqueries.geAll(\"weight\", weights) )\n" +" .list();]]>" msgstr "" -#: index.docbook:232 +#. Tag: para +#: query_criteria.xml:232 +#, no-c-format msgid "Even correlated subqueries are possible:" -msgstr "" +msgstr "Even correlated subqueries are possible:" -#: index.docbook:236 +#. Tag: programlisting +#: query_criteria.xml:236 +#, no-c-format msgid "" - "<![CDATA[DetachedCriteria avgWeightForSex = DetachedCriteria.forClass(Cat.class, \"cat2\")\n" - " .setProjection( Property.forName(\"weight\").avg() )\n" - " .add( Property.forName(\"cat2.sex\").eqProperty(\"cat.sex\") );\n" - "session.createCriteria(Cat.class, \"cat\")\n" - " .add( Property.forName(\"weight\").gt(avgWeightForSex) )\n" - " .list();]]>" +"<![CDATA[DetachedCriteria avgWeightForSex = DetachedCriteria.forClass(Cat." +"class, \"cat2\")\n" +" .setProjection( Property.forName(\"weight\").avg() )\n" +" .add( Property.forName(\"cat2.sex\").eqProperty(\"cat.sex\") );\n" +"session.createCriteria(Cat.class, \"cat\")\n" +" .add( Property.forName(\"weight\").gt(avgWeightForSex) )\n" +" .list();]]>" msgstr "" -#: index.docbook:245 +#. Tag: title +#: query_criteria.xml:245 +#, no-c-format msgid "Queries by natural identifier" -msgstr "" +msgstr "Queries by natural identifier" -#: index.docbook:247 -msgid "For most queries, including criteria queries, the query cache is not very efficient, because query cache invalidation occurs too frequently. However, there is one special kind of query where we can optimize the cache invalidation algorithm: lookups by a constant natural key. In some applications, this kind of query occurs frequently. The criteria API provides special provision for this use case." +#. Tag: para +#: query_criteria.xml:247 +#, no-c-format +msgid "" +"For most queries, including criteria queries, the query cache is not very " +"efficient, because query cache invalidation occurs too frequently. However, " +"there is one special kind of query where we can optimize the cache " +"invalidation algorithm: lookups by a constant natural key. In some " +"applications, this kind of query occurs frequently. The criteria API " +"provides special provision for this use case." msgstr "" +"For most queries, including criteria queries, the query cache is not very " +"efficient, because query cache invalidation occurs too frequently. However, " +"there is one special kind of query where we can optimize the cache " +"invalidation algorithm: lookups by a constant natural key. In some " +"applications, this kind of query occurs frequently. The criteria API " +"provides special provision for this use case." -#: index.docbook:255 -msgid "First, you should map the natural key of your entity using <literal><natural-id></literal>, and enable use of the second-level cache." +#. Tag: para +#: query_criteria.xml:255 +#, no-c-format +msgid "" +"First, you should map the natural key of your entity using <literal><" +"natural-id></literal>, and enable use of the second-level cache." msgstr "" +"First, you should map the natural key of your entity using <literal><" +"natural-id></literal>, and enable use of the second-level cache." -#: index.docbook:260 +#. Tag: programlisting +#: query_criteria.xml:260 +#, no-c-format msgid "" - "<![CDATA[<class name=\"User\">\n" - " <cache usage=\"read-write\"/>\n" - " <id name=\"id\">\n" - " <generator class=\"increment\"/>\n" - " </id>\n" - " <natural-id>\n" - " <property name=\"name\"/>\n" - " <property name=\"org\"/>\n" - " </natural-id>\n" - " <property name=\"password\"/>\n" - "</class>]]>" +"<![CDATA[<class name=\"User\">\n" +" <cache usage=\"read-write\"/>\n" +" <id name=\"id\">\n" +" <generator class=\"increment\"/>\n" +" </id>\n" +" <natural-id>\n" +" <property name=\"name\"/>\n" +" <property name=\"org\"/>\n" +" </natural-id>\n" +" <property name=\"password\"/>\n" +"</class>]]>" msgstr "" -#: index.docbook:262 -msgid "Note that this functionality is not intended for use with entities with <emphasis>mutable</emphasis> natural keys." +#. Tag: para +#: query_criteria.xml:262 +#, no-c-format +msgid "" +"Note that this functionality is not intended for use with entities with " +"<emphasis>mutable</emphasis> natural keys." msgstr "" +"Note that this functionality is not intended for use with entities with " +"<emphasis>mutable</emphasis> natural keys." -#: index.docbook:267 +#. Tag: para +#: query_criteria.xml:267 +#, no-c-format msgid "Next, enable the Hibernate query cache." -msgstr "" +msgstr "Next, enable the Hibernate query cache." -#: index.docbook:271 -msgid "Now, <literal>Restrictions.naturalId()</literal> allows us to make use of the more efficient cache algorithm." +#. Tag: para +#: query_criteria.xml:271 +#, no-c-format +msgid "" +"Now, <literal>Restrictions.naturalId()</literal> allows us to make use of " +"the more efficient cache algorithm." msgstr "" +"Now, <literal>Restrictions.naturalId()</literal> allows us to make use of " +"the more efficient cache algorithm." -#: index.docbook:276 +#. Tag: programlisting +#: query_criteria.xml:276 +#, no-c-format msgid "" - "<![CDATA[session.createCriteria(User.class)\n" - " .add( Restrictions.naturalId()\n" - " .set(\"name\", \"gavin\")\n" - " .set(\"org\", \"hb\") \n" - " ).setCacheable(true)\n" - " .uniqueResult();]]>" +"<![CDATA[session.createCriteria(User.class)\n" +" .add( Restrictions.naturalId()\n" +" .set(\"name\", \"gavin\")\n" +" .set(\"org\", \"hb\") \n" +" ).setCacheable(true)\n" +" .uniqueResult();]]>" msgstr "" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "" - Modified: core/trunk/documentation/manual/translations/pt-BR/content/query_hql.po =================================================================== --- core/trunk/documentation/manual/translations/pt-BR/content/query_hql.po 2007-10-25 22:34:46 UTC (rev 14134) +++ core/trunk/documentation/manual/translations/pt-BR/content/query_hql.po 2007-10-26 00:46:38 UTC (rev 14135) @@ -1,1275 +1,2437 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: query_hql.xml:5 +#, no-c-format msgid "HQL: The Hibernate Query Language" -msgstr "" +msgstr "HQL: A linguagem de Queries do Hibernate" -#: index.docbook:7 -msgid "Hibernate is equipped with an extremely powerful query language that (quite intentionally) looks very much like SQL. But don't be fooled by the syntax; HQL is fully object-oriented, understanding notions like inheritence, polymorphism and association." +#. Tag: para +#: query_hql.xml:7 +#, no-c-format +msgid "" +"Hibernate is equipped with an extremely powerful query language that (quite " +"intentionally) looks very much like SQL. But don't be fooled by the syntax; " +"HQL is fully object-oriented, understanding notions like inheritence, " +"polymorphism and association." msgstr "" +"O Hibernate vem com uma poderosa linguagem que é (intencionalmente) muito " +"parecida com o SQL. Mas não seja enganado pela sintaxe; a HQL é totalmente " +"orientada à objetos, requer conhecimentos de herança, polimorfismo e " +"associações." -#: index.docbook:14 +#. Tag: title +#: query_hql.xml:14 +#, no-c-format msgid "Case Sensitivity" -msgstr "" +msgstr "Case Sensitíve" -#: index.docbook:16 -msgid "Queries are case-insensitive, except for names of Java classes and properties. So <literal>SeLeCT</literal> is the same as <literal>sELEct</literal> is the same as <literal>SELECT</literal> but <literal>org.hibernate.eg.FOO</literal> is not <literal>org.hibernate.eg.Foo</literal> and <literal>foo.barSet</literal> is not <literal>foo.BARSET</literal>." +#. Tag: para +#: query_hql.xml:16 +#, no-c-format +msgid "" +"Queries are case-insensitive, except for names of Java classes and " +"properties. So <literal>SeLeCT</literal> is the same as <literal>sELEct</" +"literal> is the same as <literal>SELECT</literal> but <literal>org.hibernate." +"eg.FOO</literal> is not <literal>org.hibernate.eg.Foo</literal> and " +"<literal>foo.barSet</literal> is not <literal>foo.BARSET</literal>." msgstr "" +"As Queries não são case-sensitive, exceto pelo nomes das classes e " +"propriedades Java. <literal>sELEct</literal> e o mesmo que <literal>SELECT</" +"literal> mas <literal>org.hibernate.eg.FOO</literal> não é <literal>org." +"hibernate.eg.Foo</literal> e <literal>foo.barSet</literal> não é " +"<literal>foo.BARSET</literal>." -#: index.docbook:27 -msgid "This manual uses lowercase HQL keywords. Some users find queries with uppercase keywords more readable, but we find this convention ugly when embedded in Java code." +#. Tag: para +#: query_hql.xml:27 +#, no-c-format +msgid "" +"This manual uses lowercase HQL keywords. Some users find queries with " +"uppercase keywords more readable, but we find this convention ugly when " +"embedded in Java code." msgstr "" +"Esse manual usa as palavras chave HQL em letras minúsculas. Alguns usuários " +"acham que com letras maiúsculas as queries ficam mais legíveis, mas nós " +"achamos essa convenção feia dentro do código Java." -#: index.docbook:35 +#. Tag: title +#: query_hql.xml:35 +#, no-c-format msgid "The from clause" -msgstr "" +msgstr "A clausula from" -#: index.docbook:37 +#. Tag: para +#: query_hql.xml:37 +#, no-c-format msgid "The simplest possible Hibernate query is of the form:" -msgstr "" +msgstr "A mais simples query possível do Hibernate é a assim:" -#: index.docbook:41 +#. Tag: programlisting +#: query_hql.xml:41 +#, no-c-format msgid "<![CDATA[from eg.Cat]]>" msgstr "" -#: index.docbook:43 -msgid "which simply returns all instances of the class <literal>eg.Cat</literal>. We don't usually need to qualify the class name, since <literal>auto-import</literal> is the default. So we almost always just write:" +#. Tag: para +#: query_hql.xml:43 +#, no-c-format +msgid "" +"which simply returns all instances of the class <literal>eg.Cat</literal>. " +"We don't usually need to qualify the class name, since <literal>auto-import</" +"literal> is the default. So we almost always just write:" msgstr "" +"Ela irá retornar todas as instancias da classe <literal>eg.Cat</literal>. " +"Necessariamente não precisamos qualificar o nome da classe, pois é realizado " +"<literal>auto-import</literal> por padrão. Por isso na maior parte do tempos " +"nós simplesmente escrevemos:" -#: index.docbook:49 +#. Tag: programlisting +#: query_hql.xml:49 +#, no-c-format msgid "<![CDATA[from Cat]]>" msgstr "" -#: index.docbook:51 -msgid "Most of the time, you will need to assign an <emphasis>alias</emphasis>, since you will want to refer to the <literal>Cat</literal> in other parts of the query." +#. Tag: para +#: query_hql.xml:51 +#, no-c-format +msgid "" +"Most of the time, you will need to assign an <emphasis>alias</emphasis>, " +"since you will want to refer to the <literal>Cat</literal> in other parts of " +"the query." msgstr "" +"Na maior parte do tempo, você precisará atribuir um <emphasis>alias</" +"emphasis>, desde que você queira se referia ao <literal>Cat</literal> em " +"outras partes da query." -#: index.docbook:57, index.docbook:372 +#. Tag: programlisting +#: query_hql.xml:57 query_hql.xml:372 +#, no-c-format msgid "<![CDATA[from Cat as cat]]>" msgstr "" -#: index.docbook:59 -msgid "This query assigns the alias <literal>cat</literal> to <literal>Cat</literal> instances, so we could use that alias later in the query. The <literal>as</literal> keyword is optional; we could also write:" +#. Tag: para +#: query_hql.xml:59 +#, no-c-format +msgid "" +"This query assigns the alias <literal>cat</literal> to <literal>Cat</" +"literal> instances, so we could use that alias later in the query. The " +"<literal>as</literal> keyword is optional; we could also write:" msgstr "" +"Essa query atribui um alias a <literal>cat</literal> para as instancias de " +"<literal>Cat</literal>, então nós podemos usar esse alias depois na query. A " +"palavra chave as é opcional; poderíamos escrever assim:" -#: index.docbook:65 +#. Tag: programlisting +#: query_hql.xml:65 +#, no-c-format msgid "<![CDATA[from Cat cat]]>" msgstr "" -#: index.docbook:67 -msgid "Multiple classes may appear, resulting in a cartesian product or \"cross\" join." +#. Tag: para +#: query_hql.xml:67 +#, no-c-format +msgid "" +"Multiple classes may appear, resulting in a cartesian product or \"cross\" " +"join." msgstr "" +"Múltiplas classes pode ser envolvidas, resultando em um produto cartesiano " +"ou \"cross\" join." -#: index.docbook:71 +#. Tag: programlisting +#: query_hql.xml:71 +#, no-c-format msgid "<![CDATA[from Formula, Parameter]]>" msgstr "" -#: index.docbook:72 +#. Tag: programlisting +#: query_hql.xml:72 +#, no-c-format msgid "<![CDATA[from Formula as form, Parameter as param]]>" msgstr "" -#: index.docbook:74 -msgid "It is considered good practice to name query aliases using an initial lowercase, consistent with Java naming standards for local variables (eg. <literal>domesticCat</literal>)." +#. Tag: para +#: query_hql.xml:74 +#, no-c-format +msgid "" +"It is considered good practice to name query aliases using an initial " +"lowercase, consistent with Java naming standards for local variables (eg. " +"<literal>domesticCat</literal>)." msgstr "" +"É considerada uma boa prática os nomes dos aliases começarem com letra " +"minúscula, aderente com os padrões Java para variáveis locais (ex: " +"<literal>domesticCat</literal>)." -#: index.docbook:83 +#. Tag: title +#: query_hql.xml:83 +#, no-c-format msgid "Associations and joins" -msgstr "" +msgstr "Associações e joins" -#: index.docbook:85 -msgid "We may also assign aliases to associated entities, or even to elements of a collection of values, using a <literal>join</literal>." +#. Tag: para +#: query_hql.xml:85 +#, no-c-format +msgid "" +"We may also assign aliases to associated entities, or even to elements of a " +"collection of values, using a <literal>join</literal>." msgstr "" +"Nós também podemos querer atribuir aliases em uma entidade associada, ou " +"mesmo em elementos de uma coleção de valores, usando um <literal>join</" +"literal>." -#: index.docbook:90 +#. Tag: programlisting +#: query_hql.xml:90 +#, no-c-format msgid "" - "<![CDATA[from Cat as cat\n" - " inner join cat.mate as mate\n" - " left outer join cat.kittens as kitten]]>" +"<![CDATA[from Cat as cat\n" +" inner join cat.mate as mate\n" +" left outer join cat.kittens as kitten]]>" msgstr "" -#: index.docbook:92 +#. Tag: programlisting +#: query_hql.xml:92 +#, no-c-format msgid "<![CDATA[from Cat as cat left join cat.mate.kittens as kittens]]>" msgstr "" -#: index.docbook:94 +#. Tag: programlisting +#: query_hql.xml:94 +#, no-c-format msgid "<![CDATA[from Formula form full join form.parameter param]]>" msgstr "" -#: index.docbook:96 +#. Tag: para +#: query_hql.xml:96 +#, no-c-format msgid "The supported join types are borrowed from ANSI SQL" -msgstr "" +msgstr "Os tipos de joins suportados foram inspirados no SQL ANSI:" -#: index.docbook:103 +#. Tag: literal +#: query_hql.xml:103 +#, no-c-format msgid "inner join" -msgstr "" +msgstr "inner join" -#: index.docbook:108 +#. Tag: literal +#: query_hql.xml:108 +#, no-c-format msgid "left outer join" -msgstr "" +msgstr "left outer join" -#: index.docbook:113 +#. Tag: literal +#: query_hql.xml:113 +#, no-c-format msgid "right outer join" -msgstr "" +msgstr "right outer join" -#: index.docbook:117 +#. Tag: para +#: query_hql.xml:117 +#, no-c-format msgid "<literal>full join</literal> (not usually useful)" -msgstr "" +msgstr "<literal>full join</literal> (geralmente não é útil)" -#: index.docbook:123 -msgid "The <literal>inner join</literal>, <literal>left outer join</literal> and <literal>right outer join</literal> constructs may be abbreviated." +#. Tag: para +#: query_hql.xml:123 +#, no-c-format +msgid "" +"The <literal>inner join</literal>, <literal>left outer join</literal> and " +"<literal>right outer join</literal> constructs may be abbreviated." msgstr "" +"The <literal>inner join</literal>, <literal>left outer join</literal> and " +"<literal>right outer join</literal> constructs may be abbreviated. As " +"construções <literal>inner join</literal>, <literal>left outer join</" +"literal> e <literal>right outer join</literal> podem ser abreviadas." -#: index.docbook:128 +#. Tag: programlisting +#: query_hql.xml:128 +#, no-c-format msgid "" - "<![CDATA[from Cat as cat\n" - " join cat.mate as mate\n" - " left join cat.kittens as kitten]]>" +"<![CDATA[from Cat as cat\n" +" join cat.mate as mate\n" +" left join cat.kittens as kitten]]>" msgstr "" -#: index.docbook:130 -msgid "You may supply extra join conditions using the HQL <literal>with</literal> keyword." +#. Tag: para +#: query_hql.xml:130 +#, no-c-format +msgid "" +"You may supply extra join conditions using the HQL <literal>with</literal> " +"keyword." msgstr "" +"Você pode fornecer condições extras de join usando a palavra chave do HQL " +"<literal>with</literal>." -#: index.docbook:135 +#. Tag: programlisting +#: query_hql.xml:135 +#, no-c-format msgid "" - "<![CDATA[from Cat as cat\n" - " left join cat.kittens as kitten\n" - " with kitten.bodyWeight > 10.0]]>" +"<![CDATA[from Cat as cat\n" +" left join cat.kittens as kitten\n" +" with kitten.bodyWeight > 10.0]]>" msgstr "" -#: index.docbook:137 -msgid "In addition, a \"fetch\" join allows associations or collections of values to be initialized along with their parent objects, using a single select. This is particularly useful in the case of a collection. It effectively overrides the outer join and lazy declarations of the mapping file for associations and collections. See <xref linkend=\"performance-fetching\"/> for more information." +#. Tag: para +#: query_hql.xml:137 +#, no-c-format +msgid "" +"In addition, a \"fetch\" join allows associations or collections of values " +"to be initialized along with their parent objects, using a single select. " +"This is particularly useful in the case of a collection. It effectively " +"overrides the outer join and lazy declarations of the mapping file for " +"associations and collections. See <xref linkend=\"performance-fetching\"/> " +"for more information." msgstr "" +"Adicionalmente, um \"fetch\" join permite que associações ou coleções de " +"valores sejam inicializadas junto com o objeto pai, usando apenas um select. " +"Isso é muito útil no caso das coleções. Isso efetivamente sobre escreve as " +"declarações outer join e lazy do arquivo mapeamento para associações e " +"coleções. Veja a seção <xref linkend=\"performance-fetching\"/> para mais " +"informações." -#: index.docbook:145 +#. Tag: programlisting +#: query_hql.xml:145 +#, no-c-format msgid "" - "<![CDATA[from Cat as cat\n" - " inner join fetch cat.mate\n" - " left join fetch cat.kittens]]>" +"<![CDATA[from Cat as cat\n" +" inner join fetch cat.mate\n" +" left join fetch cat.kittens]]>" msgstr "" -#: index.docbook:147 -msgid "A fetch join does not usually need to assign an alias, because the associated objects should not be used in the <literal>where</literal> clause (or any other clause). Also, the associated objects are not returned directly in the query results. Instead, they may be accessed via the parent object. The only reason we might need an alias is if we are recursively join fetching a further collection:" +#. Tag: para +#: query_hql.xml:147 +#, no-c-format +msgid "" +"A fetch join does not usually need to assign an alias, because the " +"associated objects should not be used in the <literal>where</literal> clause " +"(or any other clause). Also, the associated objects are not returned " +"directly in the query results. Instead, they may be accessed via the parent " +"object. The only reason we might need an alias is if we are recursively join " +"fetching a further collection:" msgstr "" +"Usualmente, um <literal>fetch</literal>join não precisa atribuir um alias, " +"pois o objeto associado não deve ser usado na clausula <literal>where</" +"literal> (ou em qualquer outra clausula). Também, os objetos associados não " +"são retornados diretamente nos resultados da query. Ao invés disso, eles " +"devem ser acessados usando o objeto pai. A única razão que nós podemos " +"necessitar de um alias é quando fazemos um fech join recursivamente em uma " +"coleção adicional:" -#: index.docbook:155 +#. Tag: programlisting +#: query_hql.xml:155 +#, no-c-format msgid "" - "<![CDATA[from Cat as cat\n" - " inner join fetch cat.mate\n" - " left join fetch cat.kittens child\n" - " left join fetch child.kittens]]>" +"<![CDATA[from Cat as cat\n" +" inner join fetch cat.mate\n" +" left join fetch cat.kittens child\n" +" left join fetch child.kittens]]>" msgstr "" -#: index.docbook:157 -msgid "Note that the <literal>fetch</literal> construct may not be used in queries called using <literal>iterate()</literal> (though <literal>scroll()</literal> can be used). Nor should <literal>fetch</literal> be used together with <literal>setMaxResults()</literal> or <literal>setFirstResult()</literal> as these operations are based on the result rows, which usually contain duplicates for eager collection fetching, hence, the number of rows is not what you'd expect. Nor may <literal>fetch</literal> be used together with an ad hoc <literal>with</literal> condition. It is possible to create a cartesian product by join fetching more than one collection in a query, so take care in this case. Join fetching multiple collection roles also sometimes gives unexpected results for bag mappings, so be careful about how you formulate your queries in this case. Finally, note that <literal>full join fetch</literal> and <literal>right join fetch</literal> are not meaningful." +#. Tag: para +#: query_hql.xml:157 +#, no-c-format +msgid "" +"Note that the <literal>fetch</literal> construct may not be used in queries " +"called using <literal>iterate()</literal> (though <literal>scroll()</" +"literal> can be used). Nor should <literal>fetch</literal> be used together " +"with <literal>setMaxResults()</literal> or <literal>setFirstResult()</" +"literal> as these operations are based on the result rows, which usually " +"contain duplicates for eager collection fetching, hence, the number of rows " +"is not what you'd expect. Nor may <literal>fetch</literal> be used together " +"with an ad hoc <literal>with</literal> condition. It is possible to create a " +"cartesian product by join fetching more than one collection in a query, so " +"take care in this case. Join fetching multiple collection roles also " +"sometimes gives unexpected results for bag mappings, so be careful about how " +"you formulate your queries in this case. Finally, note that <literal>full " +"join fetch</literal> and <literal>right join fetch</literal> are not " +"meaningful." msgstr "" +"Observe que a construção <literal>fetch</literal> não deve ser usada em " +"queries invocadas usando <literal>iterate()</literal> (embora possa ser " +"usado com <literal>scroll()</literal>). O <literal>fetch</literal> também " +"não deve ser usado junto com o <literal>setMaxResults()</literal> ou " +"<literal>setFirstResult()</literal> pois essas operações são baseadas nas " +"linhas retornadas, que normalmente contem duplicidade devido ao fetching das " +"coleções, então o número de linhas pode não ser o que você espera. O " +"<literal>fetch</literal> não deve ser usado junto com uma condição " +"<literal>with</literal> em uma condição <literal>with</literal> ad hoc. É " +"possível que seja criado um produto cartesiano pelo join fetching em mais do " +"que uma coleção em uma query, então tome cuidado nesses casos. Um join " +"fetching em varias coleções pode trazer resultados inesperados para " +"mapeamentos do tipo bag, tome cuidado na hora de formular queries como " +"essas. Finalmente, observe o seguinte, o <literal>full join fetch</literal> " +"e <literal>right join fetch</literal> não são significativos." -#: index.docbook:172 -msgid "If you are using property-level lazy fetching (with bytecode instrumentation), it is possible to force Hibernate to fetch the lazy properties immediately (in the first query) using <literal>fetch all properties</literal>." +#. Tag: para +#: query_hql.xml:172 +#, no-c-format +msgid "" +"If you are using property-level lazy fetching (with bytecode " +"instrumentation), it is possible to force Hibernate to fetch the lazy " +"properties immediately (in the first query) using <literal>fetch all " +"properties</literal>." msgstr "" +"Se está usando o nível de propriedade lazy (<literal>com</literal> " +"instrumentação de bytecode), é possível forçar o Hibernate a " +"<literal>buscar</literal> as propriedades lazy imediatamente (na primeira " +"query), usando <literal>fetch all properties </literal>." -#: index.docbook:178 +#. Tag: programlisting +#: query_hql.xml:178 +#, no-c-format msgid "<![CDATA[from Document fetch all properties order by name]]>" msgstr "" -#: index.docbook:179 -msgid "<![CDATA[from Document doc fetch all properties where lower(doc.name) like '%cats%']]>" +#. Tag: programlisting +#: query_hql.xml:179 +#, no-c-format +msgid "" +"<![CDATA[from Document doc fetch all properties where lower(doc.name) like '%" +"cats%']]>" msgstr "" -#: index.docbook:184 +#. Tag: title +#: query_hql.xml:184 +#, no-c-format msgid "Forms of join syntax" -msgstr "" +msgstr "Formas e sintaxe de joins" -#: index.docbook:186 -msgid "HQL supports two forms of association joining: <literal>implicit</literal> and <literal>explicit</literal>." +#. Tag: para +#: query_hql.xml:186 +#, no-c-format +msgid "" +"HQL supports two forms of association joining: <literal>implicit</literal> " +"and <literal>explicit</literal>." msgstr "" +"O HQL suporta duas formas de associação para união: <literal>implícita</" +"literal> e <literal>explicita</literal>." -#: index.docbook:190 -msgid "The queries shown in the previous section all use the <literal>explicit</literal> form where the join keyword is explicitly used in the from clause. This is the recommended form." +#. Tag: para +#: query_hql.xml:190 +#, no-c-format +msgid "" +"The queries shown in the previous section all use the <literal>explicit</" +"literal> form where the join keyword is explicitly used in the from clause. " +"This is the recommended form." msgstr "" +"As queries apresentadas na seção anterior usam a forma <literal>explicita</" +"literal>, onde a palavra chave \"join\" é explicitamente usada na clausula " +"\"from\". Essa é a forma recomendada." -#: index.docbook:195 -msgid "The <literal>implicit</literal> form does not use the join keyword. Instead, the associations are \"dereferenced\" using dot-notation. <literal>implicit</literal> joins can appear in any of the HQL clauses. <literal>implicit</literal> join result in inner joins in the resulting SQL statement." +#. Tag: para +#: query_hql.xml:195 +#, no-c-format +msgid "" +"The <literal>implicit</literal> form does not use the join keyword. Instead, " +"the associations are \"dereferenced\" using dot-notation. <literal>implicit</" +"literal> joins can appear in any of the HQL clauses. <literal>implicit</" +"literal> join result in inner joins in the resulting SQL statement." msgstr "" +"A forma <literal>implícita</literal> não usa a palavra chave \"join\". " +"Entretanto, as associações são diferenciadas usando pontuação (\".\" - " +"dotnation). Uniões implícitas podem aparecer em qualquer das clausulas HQL. " +"A união <literal>implícita</literal> resulta em declarações SQL que contem " +"inner joins." -#: index.docbook:202 +#. Tag: programlisting +#: query_hql.xml:202 +#, no-c-format msgid "<![CDATA[from Cat as cat where cat.mate.name like '%s%']]>" msgstr "" -#: index.docbook:206 +#. Tag: title +#: query_hql.xml:206 +#, no-c-format msgid "Refering to identifier property" -msgstr "" +msgstr "Refering to identifier property" -#: index.docbook:208 -msgid "There are, generally speaking, 2 ways to refer to an entity's identifier property:" +#. Tag: para +#: query_hql.xml:208 +#, no-c-format +msgid "" +"There are, generally speaking, 2 ways to refer to an entity's identifier " +"property:" msgstr "" +"There are, generally speaking, 2 ways to refer to an entity's identifier " +"property:" -#: index.docbook:213 -msgid "The special property (lowercase) <literal>id</literal> may be used to reference the identifier property of an entity <emphasis>provided that entity does not define a non-identifier property named id</emphasis>." +#. Tag: para +#: query_hql.xml:213 +#, no-c-format +msgid "" +"The special property (lowercase) <literal>id</literal> may be used to " +"reference the identifier property of an entity <emphasis>provided that " +"entity does not define a non-identifier property named id</emphasis>." msgstr "" +"The special property (lowercase) <literal>id</literal> may be used to " +"reference the identifier property of an entity <emphasis>provided that " +"entity does not define a non-identifier property named id</emphasis>." -#: index.docbook:220 -msgid "If the entity defines a named identifier property, you may use that property name." +#. Tag: para +#: query_hql.xml:220 +#, no-c-format +msgid "" +"If the entity defines a named identifier property, you may use that property " +"name." msgstr "" +"If the entity defines a named identifier property, you may use that property " +"name." -#: index.docbook:226 -msgid "References to composite identifier properties follow the same naming rules. If the entity has a non-identifier property named id, the composite identifier property can only be referenced by its defined named; otherwise, the special <literal>id</literal> property can be used to rerference the identifier property." +#. Tag: para +#: query_hql.xml:226 +#, no-c-format +msgid "" +"References to composite identifier properties follow the same naming rules. " +"If the entity has a non-identifier property named id, the composite " +"identifier property can only be referenced by its defined named; otherwise, " +"the special <literal>id</literal> property can be used to rerference the " +"identifier property." msgstr "" +"References to composite identifier properties follow the same naming rules. " +"If the entity has a non-identifier property named id, the composite " +"identifier property can only be referenced by its defined named; otherwise, " +"the special <literal>id</literal> property can be used to rerference the " +"identifier property." -#: index.docbook:233 -msgid "Note: this has changed significantly starting in version 3.2.2. In previous versions, <literal>id</literal> <emphasis>always</emphasis> referred to the identifier property no matter what its actual name. A ramification of that decision was that non-identifier properties named <literal>id</literal> could never be referenced in Hibernate queries." +#. Tag: para +#: query_hql.xml:233 +#, fuzzy, no-c-format +msgid "" +"Note: this has changed significantly starting in version 3.2.2. In previous " +"versions, <literal>id</literal> <emphasis>always</emphasis> referred to the " +"identifier property no matter what its actual name. A ramification of that " +"decision was that non-identifier properties named <literal>id</literal> " +"could never be referenced in Hibernate queries." msgstr "" +"Note: this has changed significantly starting in version 3.2.2. In previous " +"versions, <literal>id</literal><emphasis>always</emphasis> referred to the " +"identifier property no matter what its actual name. A ramification of that " +"decision was that non-identifier properties named <literal>id</literal> " +"could never be referenced in Hibernate queries." -#: index.docbook:242 +#. Tag: title +#: query_hql.xml:242 +#, no-c-format msgid "The select clause" -msgstr "" +msgstr "Clausula select" -#: index.docbook:244 -msgid "The <literal>select</literal> clause picks which objects and properties to return in the query result set. Consider:" +#. Tag: para +#: query_hql.xml:244 +#, no-c-format +msgid "" +"The <literal>select</literal> clause picks which objects and properties to " +"return in the query result set. Consider:" msgstr "" +"A clausula <literal>select</literal> seleciona quais obetos e propriedades " +"retornam no resultado da query. Considere:" -#: index.docbook:249 +#. Tag: programlisting +#: query_hql.xml:249 +#, no-c-format msgid "" - "<![CDATA[select mate\n" - "from Cat as cat\n" - " inner join cat.mate as mate]]>" +"<![CDATA[select mate\n" +"from Cat as cat\n" +" inner join cat.mate as mate]]>" msgstr "" -#: index.docbook:251 -msgid "The query will select <literal>mate</literal>s of other <literal>Cat</literal>s. Actually, you may express this query more compactly as:" +#. Tag: para +#: query_hql.xml:251 +#, no-c-format +msgid "" +"The query will select <literal>mate</literal>s of other <literal>Cat</" +"literal>s. Actually, you may express this query more compactly as:" msgstr "" +"A query selecionará <literal>mate</literal>s (companheiros), de outros " +"<literal>Cat</literal>s. Atualmente, podemos expressar a query de forma mais " +"compacta como:" -#: index.docbook:256 +#. Tag: programlisting +#: query_hql.xml:256 +#, no-c-format msgid "<![CDATA[select cat.mate from Cat cat]]>" msgstr "" -#: index.docbook:258 -msgid "Queries may return properties of any value type including properties of component type:" +#. Tag: para +#: query_hql.xml:258 +#, no-c-format +msgid "" +"Queries may return properties of any value type including properties of " +"component type:" msgstr "" +"Queries podem retornar propriedades de qualquer tipo de valor, incluindo " +"propriedades de tipo de componente:" -#: index.docbook:262 +#. Tag: programlisting +#: query_hql.xml:262 +#, no-c-format msgid "" - "<![CDATA[select cat.name from DomesticCat cat\n" - "where cat.name like 'fri%']]>" +"<![CDATA[select cat.name from DomesticCat cat\n" +"where cat.name like 'fri%']]>" msgstr "" -#: index.docbook:264 +#. Tag: programlisting +#: query_hql.xml:264 +#, no-c-format msgid "<![CDATA[select cust.name.firstName from Customer as cust]]>" msgstr "" -#: index.docbook:266 -msgid "Queries may return multiple objects and/or properties as an array of type <literal>Object[]</literal>," +#. Tag: para +#: query_hql.xml:266 +#, no-c-format +msgid "" +"Queries may return multiple objects and/or properties as an array of type " +"<literal>Object[]</literal>," msgstr "" +"Queries podem retornar múltiplos objetos e/ou propriedades como um array do " +"tipo Object[]," -#: index.docbook:271 +#. Tag: programlisting +#: query_hql.xml:271 +#, no-c-format msgid "" - "<![CDATA[select mother, offspr, mate.name\n" - "from DomesticCat as mother\n" - " inner join mother.mate as mate\n" - " left outer join mother.kittens as offspr]]>" +"<![CDATA[select mother, offspr, mate.name\n" +"from DomesticCat as mother\n" +" inner join mother.mate as mate\n" +" left outer join mother.kittens as offspr]]>" msgstr "" -#: index.docbook:273 +#. Tag: para +#: query_hql.xml:273 +#, no-c-format msgid "or as a <literal>List</literal>," -msgstr "" +msgstr "ou como um <literal>List</literal>," -#: index.docbook:277 +#. Tag: programlisting +#: query_hql.xml:277 +#, no-c-format msgid "" - "<![CDATA[select new list(mother, offspr, mate.name)\n" - "from DomesticCat as mother\n" - " inner join mother.mate as mate\n" - " left outer join mother.kittens as offspr]]>" +"<![CDATA[select new list(mother, offspr, mate.name)\n" +"from DomesticCat as mother\n" +" inner join mother.mate as mate\n" +" left outer join mother.kittens as offspr]]>" msgstr "" -#: index.docbook:279 +#. Tag: para +#: query_hql.xml:279 +#, no-c-format msgid "or as an actual typesafe Java object," -msgstr "" +msgstr "ou como um objeto Java typesafe," -#: index.docbook:283 +#. Tag: programlisting +#: query_hql.xml:283 +#, no-c-format msgid "" - "<![CDATA[select new Family(mother, mate, offspr)\n" - "from DomesticCat as mother\n" - " join mother.mate as mate\n" - " left join mother.kittens as offspr]]>" +"<![CDATA[select new Family(mother, mate, offspr)\n" +"from DomesticCat as mother\n" +" join mother.mate as mate\n" +" left join mother.kittens as offspr]]>" msgstr "" -#: index.docbook:285 -msgid "assuming that the class <literal>Family</literal> has an appropriate constructor." +#. Tag: para +#: query_hql.xml:285 +#, no-c-format +msgid "" +"assuming that the class <literal>Family</literal> has an appropriate " +"constructor." msgstr "" +"assumindo que a classe <literal>Family</literal> tenha um construtor " +"apropriado." -#: index.docbook:289 -msgid "You may assign aliases to selected expressions using <literal>as</literal>:" +#. Tag: para +#: query_hql.xml:289 +#, no-c-format +msgid "" +"You may assign aliases to selected expressions using <literal>as</literal>:" msgstr "" +"Pode-se designar referencias a expressões selecionadas, <literal>as</" +"literal>:" -#: index.docbook:293 +#. Tag: programlisting +#: query_hql.xml:293 +#, no-c-format msgid "" - "<![CDATA[select max(bodyWeight) as max, min(bodyWeight) as min, count(*) as n\n" - "from Cat cat]]>" +"<![CDATA[select max(bodyWeight) as max, min(bodyWeight) as min, count(*) as " +"n\n" +"from Cat cat]]>" msgstr "" -#: index.docbook:295 -msgid "This is most useful when used together with <literal>select new map</literal>:" +#. Tag: para +#: query_hql.xml:295 +#, no-c-format +msgid "" +"This is most useful when used together with <literal>select new map</" +"literal>:" msgstr "" +"Isto é bem mais útil quando usado junto <literal>com</" +"literal><literal>select new map</literal>:" -#: index.docbook:299 +#. Tag: programlisting +#: query_hql.xml:299 +#, no-c-format msgid "" - "<![CDATA[select new map( max(bodyWeight) as max, min(bodyWeight) as min, count(*) as n )\n" - "from Cat cat]]>" +"<![CDATA[select new map( max(bodyWeight) as max, min(bodyWeight) as min, " +"count(*) as n )\n" +"from Cat cat]]>" msgstr "" -#: index.docbook:301 -msgid "This query returns a <literal>Map</literal> from aliases to selected values." +#. Tag: para +#: query_hql.xml:301 +#, no-c-format +msgid "" +"This query returns a <literal>Map</literal> from aliases to selected values." msgstr "" +"Esta query retorna um <literal>Map</literal> de referencias para valores " +"selecionados." -#: index.docbook:308 +#. Tag: title +#: query_hql.xml:308 +#, no-c-format msgid "Aggregate functions" -msgstr "" +msgstr "Funções de agregação" -#: index.docbook:310 -msgid "HQL queries may even return the results of aggregate functions on properties:" +#. Tag: para +#: query_hql.xml:310 +#, no-c-format +msgid "" +"HQL queries may even return the results of aggregate functions on properties:" msgstr "" +"As queries HQL podem retornar o resultado de funções agregadas nas " +"propriedades." -#: index.docbook:314 +#. Tag: programlisting +#: query_hql.xml:314 +#, no-c-format msgid "" - "<![CDATA[select avg(cat.weight), sum(cat.weight), max(cat.weight), count(cat)\n" - "from Cat cat]]>" +"<![CDATA[select avg(cat.weight), sum(cat.weight), max(cat.weight), count" +"(cat)\n" +"from Cat cat]]>" msgstr "" -#: index.docbook:325 +#. Tag: para +#: query_hql.xml:325 +#, no-c-format msgid "The supported aggregate functions are" -msgstr "" +msgstr "As funções agregadas suportadas são:" -#: index.docbook:332 +#. Tag: literal +#: query_hql.xml:332 +#, no-c-format msgid "avg(...), sum(...), min(...), max(...)" -msgstr "" +msgstr "avg(...), sum(...), min(...), max(...)" -#: index.docbook:337 +#. Tag: literal +#: query_hql.xml:337 +#, no-c-format msgid "count(*)" -msgstr "" +msgstr "count(*)" -#: index.docbook:342 +#. Tag: literal +#: query_hql.xml:342 +#, no-c-format msgid "count(...), count(distinct ...), count(all...)" -msgstr "" +msgstr "count(...), count(distinct ...), count(all...)" -#: index.docbook:347 -msgid "You may use arithmetic operators, concatenation, and recognized SQL functions in the select clause:" +#. Tag: para +#: query_hql.xml:347 +#, no-c-format +msgid "" +"You may use arithmetic operators, concatenation, and recognized SQL " +"functions in the select clause:" msgstr "" +"Pode-se usar operadores aritiméticos, concatenação e funções SQL " +"reconhecidas na clausula select:" -#: index.docbook:352 +#. Tag: programlisting +#: query_hql.xml:352 +#, no-c-format msgid "" - "<![CDATA[select cat.weight + sum(kitten.weight)\n" - "from Cat cat\n" - " join cat.kittens kitten\n" - "group by cat.id, cat.weight]]>" +"<![CDATA[select cat.weight + sum(kitten.weight)\n" +"from Cat cat\n" +" join cat.kittens kitten\n" +"group by cat.id, cat.weight]]>" msgstr "" -#: index.docbook:354 -msgid "<![CDATA[select firstName||' '||initial||' '||upper(lastName) from Person]]>" +#. Tag: programlisting +#: query_hql.xml:354 +#, no-c-format +msgid "" +"<![CDATA[select firstName||' '||initial||' '||upper(lastName) from Person]]>" msgstr "" -#: index.docbook:356 -msgid "The <literal>distinct</literal> and <literal>all</literal> keywords may be used and have the same semantics as in SQL." +#. Tag: para +#: query_hql.xml:356 +#, no-c-format +msgid "" +"The <literal>distinct</literal> and <literal>all</literal> keywords may be " +"used and have the same semantics as in SQL." msgstr "" +"As palavras <literal>distinct</literal> e <literal>all</literal> podem ser " +"usadas e têm a mesma semântica como no SQL." -#: index.docbook:361 +#. Tag: programlisting +#: query_hql.xml:361 +#, no-c-format msgid "" - "<![CDATA[select distinct cat.name from Cat cat\n" - "\n" - "select count(distinct cat.name), count(cat) from Cat cat]]>" +"<![CDATA[select distinct cat.name from Cat cat\n" +"\n" +"select count(distinct cat.name), count(cat) from Cat cat]]>" msgstr "" -#: index.docbook:366 +#. Tag: title +#: query_hql.xml:366 +#, no-c-format msgid "Polymorphic queries" -msgstr "" +msgstr "Queries polimórficas" -#: index.docbook:368 +#. Tag: para +#: query_hql.xml:368 +#, no-c-format msgid "A query like:" -msgstr "" +msgstr "A query:" -#: index.docbook:374 -msgid "returns instances not only of <literal>Cat</literal>, but also of subclasses like <literal>DomesticCat</literal>. Hibernate queries may name <emphasis>any</emphasis> Java class or interface in the <literal>from</literal> clause. The query will return instances of all persistent classes that extend that class or implement the interface. The following query would return all persistent objects:" +#. Tag: para +#: query_hql.xml:374 +#, no-c-format +msgid "" +"returns instances not only of <literal>Cat</literal>, but also of subclasses " +"like <literal>DomesticCat</literal>. Hibernate queries may name " +"<emphasis>any</emphasis> Java class or interface in the <literal>from</" +"literal> clause. The query will return instances of all persistent classes " +"that extend that class or implement the interface. The following query would " +"return all persistent objects:" msgstr "" +"retorna instancias não só de <literal>Cat</literal>, mas também de " +"subclasses como <literal>DomesticCat</literal>. As queries do Hibernate " +"podem nomear qualquer classe Java ou interface na clausula <literal>from</" +"literal>. A query retornará instancias de toda classe persistente que " +"extenda a determinada classe ou implemente a determinada interface. A " +"query , a seguir, pode retornar todo objeto persistente:" -#: index.docbook:382 +#. Tag: programlisting +#: query_hql.xml:382 +#, no-c-format msgid "<![CDATA[from java.lang.Object o]]>" msgstr "" -#: index.docbook:384 -msgid "The interface <literal>Named</literal> might be implemented by various persistent classes:" +#. Tag: para +#: query_hql.xml:384 +#, no-c-format +msgid "" +"The interface <literal>Named</literal> might be implemented by various " +"persistent classes:" msgstr "" +"A interface <literal>Named</literal> pode ser implementada por várias " +"classes persistentes:" -#: index.docbook:389 +#. Tag: programlisting +#: query_hql.xml:389 +#, no-c-format msgid "<![CDATA[from Named n, Named m where n.name = m.name]]>" msgstr "" -#: index.docbook:391 -msgid "Note that these last two queries will require more than one SQL <literal>SELECT</literal>. This means that the <literal>order by</literal> clause does not correctly order the whole result set. (It also means you can't call these queries using <literal>Query.scroll()</literal>.)" +#. Tag: para +#: query_hql.xml:391 +#, no-c-format +msgid "" +"Note that these last two queries will require more than one SQL " +"<literal>SELECT</literal>. This means that the <literal>order by</literal> " +"clause does not correctly order the whole result set. (It also means you " +"can't call these queries using <literal>Query.scroll()</literal>.)" msgstr "" +"Note que as duas últimas queries requerem mais de um SQL SELECT . Isto " +"significa que a clausula <literal>order by</literal> não ordena corretamente " +"todo o resultado. (Isso também significa que você não pode chamar essas " +"queries usando <literal>Query.scroll()</literal>.)" -#: index.docbook:400 +#. Tag: title +#: query_hql.xml:400 +#, no-c-format msgid "The where clause" -msgstr "" +msgstr "A clausula where" -#: index.docbook:402 -msgid "The <literal>where</literal> clause allows you to narrow the list of instances returned. If no alias exists, you may refer to properties by name:" +#. Tag: para +#: query_hql.xml:402 +#, no-c-format +msgid "" +"The <literal>where</literal> clause allows you to narrow the list of " +"instances returned. If no alias exists, you may refer to properties by name:" msgstr "" +"A clausula <literal>where</literal> permite estreitar a lista de instancias " +"retornada. Se não houver referencia alguma, pode-se referir a propriedades " +"pelo nome:" -#: index.docbook:407 +#. Tag: programlisting +#: query_hql.xml:407 +#, no-c-format msgid "<![CDATA[from Cat where name='Fritz']]>" msgstr "" -#: index.docbook:409 +#. Tag: para +#: query_hql.xml:409 +#, no-c-format msgid "If there is an alias, use a qualified property name:" -msgstr "" +msgstr "Se houver uma referência, use o nome da propriedade qualificada:" -#: index.docbook:413 +#. Tag: programlisting +#: query_hql.xml:413 +#, no-c-format msgid "<![CDATA[from Cat as cat where cat.name='Fritz']]>" msgstr "" -#: index.docbook:415 +#. Tag: para +#: query_hql.xml:415 +#, no-c-format msgid "returns instances of <literal>Cat</literal> named 'Fritz'." -msgstr "" +msgstr "retorna instancias de <literal>Cat</literal> com nome ‘Fritz’." -#: index.docbook:419 +#. Tag: programlisting +#: query_hql.xml:419 +#, no-c-format msgid "" - "<![CDATA[select foo\n" - "from Foo foo, Bar bar\n" - "where foo.startDate = bar.date]]>" +"<![CDATA[select foo\n" +"from Foo foo, Bar bar\n" +"where foo.startDate = bar.date]]>" msgstr "" -#: index.docbook:421 -msgid "will return all instances of <literal>Foo</literal> for which there exists an instance of <literal>bar</literal> with a <literal>date</literal> property equal to the <literal>startDate</literal> property of the <literal>Foo</literal>. Compound path expressions make the <literal>where</literal> clause extremely powerful. Consider:" +#. Tag: para +#: query_hql.xml:421 +#, no-c-format +msgid "" +"will return all instances of <literal>Foo</literal> for which there exists " +"an instance of <literal>bar</literal> with a <literal>date</literal> " +"property equal to the <literal>startDate</literal> property of the " +"<literal>Foo</literal>. Compound path expressions make the <literal>where</" +"literal> clause extremely powerful. Consider:" msgstr "" +"retornará todas as instancias de <literal>Foo</literal>, para cada um que " +"tiver uma instancia de <literal>bar</literal> com a propriedade " +"<literal>date</literal> igual a propriedade <literal>startDate</literal> de " +"<literal>Foo</literal>. Expressões de filtro compostas fazem da clausula " +"<literal>where</literal>, extremamente poderosa. Consideremos:" -#: index.docbook:430 +#. Tag: programlisting +#: query_hql.xml:430 +#, no-c-format msgid "<![CDATA[from Cat cat where cat.mate.name is not null]]>" msgstr "" -#: index.docbook:432 -msgid "This query translates to an SQL query with a table (inner) join. If you were to write something like" +#. Tag: para +#: query_hql.xml:432 +#, no-c-format +msgid "" +"This query translates to an SQL query with a table (inner) join. If you were " +"to write something like" msgstr "" +"Esta query traduzida para uma query SQL <literal>com</literal> uma tabela " +"(inner) join. Se fosse escrever algo como:" -#: index.docbook:437 +#. Tag: programlisting +#: query_hql.xml:437 +#, no-c-format msgid "" - "<![CDATA[from Foo foo\n" - "where foo.bar.baz.customer.address.city is not null]]>" +"<![CDATA[from Foo foo\n" +"where foo.bar.baz.customer.address.city is not null]]>" msgstr "" -#: index.docbook:439 -msgid "you would end up with a query that would require four table joins in SQL." +#. Tag: para +#: query_hql.xml:439 +#, no-c-format +msgid "" +"you would end up with a query that would require four table joins in SQL." msgstr "" +"Poderia-se terminar <literal>com</literal> uma query que necessitasse de " +"join de quatro tabelas, no SQL." -#: index.docbook:443 -msgid "The <literal>=</literal> operator may be used to compare not only properties, but also instances:" +#. Tag: para +#: query_hql.xml:443 +#, no-c-format +msgid "" +"The <literal>=</literal> operator may be used to compare not only " +"properties, but also instances:" msgstr "" +"O operador <literal>=</literal> pode ser uasdo para comparar não apenas " +"propriedades, mas também instancias:" -#: index.docbook:448 +#. Tag: programlisting +#: query_hql.xml:448 +#, no-c-format msgid "<![CDATA[from Cat cat, Cat rival where cat.mate = rival.mate]]>" msgstr "" -#: index.docbook:450 +#. Tag: programlisting +#: query_hql.xml:450 +#, no-c-format msgid "" - "<![CDATA[select cat, mate\n" - "from Cat cat, Cat mate\n" - "where cat.mate = mate]]>" +"<![CDATA[select cat, mate\n" +"from Cat cat, Cat mate\n" +"where cat.mate = mate]]>" msgstr "" -#: index.docbook:452 -msgid "The special property (lowercase) <literal>id</literal> may be used to reference the unique identifier of an object. See <xref linkend=\"queryhql-identifier-property\"/> for more information." +#. Tag: para +#: query_hql.xml:452 +#, no-c-format +msgid "" +"The special property (lowercase) <literal>id</literal> may be used to " +"reference the unique identifier of an object. See <xref linkend=\"queryhql-" +"identifier-property\"/> for more information." msgstr "" +"A propriedade especial (lowercase) <literal>id</literal> pode ser usada para " +"referenciar o identificador único de um objeto. (Pode-se usar também o nome " +"de sua propriedade)" -#: index.docbook:458 +#. Tag: programlisting +#: query_hql.xml:458 +#, no-c-format msgid "" - "<![CDATA[from Cat as cat where cat.id = 123\n" - "\n" - "from Cat as cat where cat.mate.id = 69]]>" +"<![CDATA[from Cat as cat where cat.id = 123\n" +"\n" +"from Cat as cat where cat.mate.id = 69]]>" msgstr "" -#: index.docbook:460 +#. Tag: para +#: query_hql.xml:460 +#, no-c-format msgid "The second query is efficient. No table join is required!" -msgstr "" +msgstr "A Segunda query é eficiente. Nenhuma união de tabelas é necessária!" -#: index.docbook:464 -msgid "Properties of composite identifiers may also be used. Suppose <literal>Person</literal> has a composite identifier consisting of <literal>country</literal> and <literal>medicareNumber</literal>. Again, see <xref linkend=\"queryhql-identifier-property\"/> for more information regarding referencing identifier properties." +#. Tag: para +#: query_hql.xml:464 +#, no-c-format +msgid "" +"Properties of composite identifiers may also be used. Suppose " +"<literal>Person</literal> has a composite identifier consisting of " +"<literal>country</literal> and <literal>medicareNumber</literal>. Again, see " +"<xref linkend=\"queryhql-identifier-property\"/> for more information " +"regarding referencing identifier properties." msgstr "" +"As propriedades de identificadores compostas também podem ser usadas. " +"Suponha que <literal>Person</literal> tenha um identificador composto que " +"consiste de <literal>country</literal> e <literal>medicareNumber</literal>." -#: index.docbook:471 +#. Tag: programlisting +#: query_hql.xml:471 +#, no-c-format msgid "" - "<![CDATA[from bank.Person person\n" - "where person.id.country = 'AU'\n" - " and person.id.medicareNumber = 123456]]>" +"<![CDATA[from bank.Person person\n" +"where person.id.country = 'AU'\n" +" and person.id.medicareNumber = 123456]]>" msgstr "" -#: index.docbook:473 +#. Tag: programlisting +#: query_hql.xml:473 +#, no-c-format msgid "" - "<![CDATA[from bank.Account account\n" - "where account.owner.id.country = 'AU'\n" - " and account.owner.id.medicareNumber = 123456]]>" +"<![CDATA[from bank.Account account\n" +"where account.owner.id.country = 'AU'\n" +" and account.owner.id.medicareNumber = 123456]]>" msgstr "" -#: index.docbook:475 +#. Tag: para +#: query_hql.xml:475 +#, no-c-format msgid "Once again, the second query requires no table join." -msgstr "" +msgstr "Mais uma vez, a Segunda query não precisa de nenhum join de tabela." -#: index.docbook:479 -msgid "Likewise, the special property <literal>class</literal> accesses the discriminator value of an instance in the case of polymorphic persistence. A Java class name embedded in the where clause will be translated to its discriminator value." +#. Tag: para +#: query_hql.xml:479 +#, no-c-format +msgid "" +"Likewise, the special property <literal>class</literal> accesses the " +"discriminator value of an instance in the case of polymorphic persistence. A " +"Java class name embedded in the where clause will be translated to its " +"discriminator value." msgstr "" +"Assim mesmo, a propriedade especial <literal>class</literal> acessa o valor " +"discriminador da instancia, no caso de persistência polimórfica. O nome de " +"uma classe Java inclusa em uma clausula \"where\", será traduzida para seu " +"valor descriminante." -#: index.docbook:485 +#. Tag: programlisting +#: query_hql.xml:485 +#, no-c-format msgid "<![CDATA[from Cat cat where cat.class = DomesticCat]]>" msgstr "" -#: index.docbook:487 -msgid "You may also use components or composite user types, or properties of said component types. See <xref linkend=\"queryhql-coomponents\"/> for more details." +#. Tag: para +#: query_hql.xml:487 +#, no-c-format +msgid "" +"You may also use components or composite user types, or properties of said " +"component types. See <xref linkend=\"queryhql-components\"/> for more " +"details." msgstr "" +"Pode-se também especificar as propriedades dos components ou tipos de " +"usuário composto (e de componentes de componentes). Nunca tente usar uma " +"expressão de filtro que termine na propriedade de um tipo de componente (ao " +"contrário de uma propriedade de um componente). Por exemplo, se store.owner " +"é uma entidade <literal>com</literal> um componente <literal>address</" +"literal>." -#: index.docbook:492 -msgid "An \"any\" type has the special properties <literal>id</literal> and <literal>class</literal>, allowing us to express a join in the following way (where <literal>AuditLog.item</literal> is a property mapped with <literal><any></literal>)." +#. Tag: para +#: query_hql.xml:492 +#, no-c-format +msgid "" +"An \"any\" type has the special properties <literal>id</literal> and " +"<literal>class</literal>, allowing us to express a join in the following way " +"(where <literal>AuditLog.item</literal> is a property mapped with " +"<literal><any></literal>)." msgstr "" +"Um tipo \"any\" tem as propriedades <literal>id</literal> e <literal>class</" +"literal> especiais, nôs permitindo expressar um join da seguinte forma (onde " +"<literal>AuditLog.item</literal> é uma propriedade mapeada <literal>com</" +"literal><literal><any></literal>)" -#: index.docbook:498 +#. Tag: programlisting +#: query_hql.xml:498 +#, no-c-format msgid "" - "<![CDATA[from AuditLog log, Payment payment\n" - "where log.item.class = 'Payment' and log.item.id = payment.id]]>" +"<![CDATA[from AuditLog log, Payment payment\n" +"where log.item.class = 'Payment' and log.item.id = payment.id]]>" msgstr "" -#: index.docbook:500 -msgid "Notice that <literal>log.item.class</literal> and <literal>payment.class</literal> would refer to the values of completely different database columns in the above query." +#. Tag: para +#: query_hql.xml:500 +#, no-c-format +msgid "" +"Notice that <literal>log.item.class</literal> and <literal>payment.class</" +"literal> would refer to the values of completely different database columns " +"in the above query." msgstr "" +"Veja que <literal>log.item.class</literal> e <literal>payment.class</" +"literal> podem referir-se a valores de colunas de banco de dados " +"completamente diferentes, na query acima." -#: index.docbook:508 +#. Tag: title +#: query_hql.xml:508 +#, no-c-format msgid "Expressions" -msgstr "" +msgstr "Expressões" -#: index.docbook:510 -msgid "Expressions allowed in the <literal>where</literal> clause include most of the kind of things you could write in SQL:" +#. Tag: para +#: query_hql.xml:510 +#, no-c-format +msgid "" +"Expressions allowed in the <literal>where</literal> clause include most of " +"the kind of things you could write in SQL:" msgstr "" +"As expressões permitidas na cláusula <literal>where</literal> inclui a " +"maioria das coisas que você poderia escrever no SQL:" -#: index.docbook:517 +#. Tag: para +#: query_hql.xml:517 +#, no-c-format msgid "mathematical operators <literal>+, -, *, /</literal>" -msgstr "" +msgstr "operadores matemáticos <literal>+, -, *, /</literal>" -#: index.docbook:522 -msgid "binary comparison operators <literal>=, >=, <=, <>, !=, like</literal>" +#. Tag: para +#: query_hql.xml:522 +#, no-c-format +msgid "" +"binary comparison operators <literal>=, >=, <=, <>, !=, like</" +"literal>" msgstr "" +"operadores de comparação binários <literal>=, >=, <=, <>, !=, " +"like</literal>" -#: index.docbook:527 +#. Tag: para +#: query_hql.xml:527 +#, no-c-format msgid "logical operations <literal>and, or, not</literal>" -msgstr "" +msgstr "operadores lógicos <literal>and, or, not</literal>" -#: index.docbook:532 +#. Tag: para +#: query_hql.xml:532 +#, no-c-format msgid "Parentheses <literal>( )</literal>, indicating grouping" -msgstr "" +msgstr "parenteses <literal>( )</literal>, indicating grouping" -#: index.docbook:537 -msgid "<literal>in</literal>, <literal>not in</literal>, <literal>between</literal>, <literal>is null</literal>, <literal>is not null</literal>, <literal>is empty</literal>, <literal>is not empty</literal>, <literal>member of</literal> and <literal>not member of</literal>" +#. Tag: para +#: query_hql.xml:537 +#, no-c-format +msgid "" +"<literal>in</literal>, <literal>not in</literal>, <literal>between</" +"literal>, <literal>is null</literal>, <literal>is not null</literal>, " +"<literal>is empty</literal>, <literal>is not empty</literal>, " +"<literal>member of</literal> and <literal>not member of</literal>" msgstr "" +"<literal>in</literal>, <literal>not in</literal>, <literal>between</" +"literal>, <literal>is null</literal>, <literal>is not null</literal>, " +"<literal>is empty</literal>, <literal>is not empty</literal>, " +"<literal>member of</literal> and <literal>not member of</literal>" -#: index.docbook:550 -msgid "\"Simple\" case, <literal>case ... when ... then ... else ... end</literal>, and \"searched\" case, <literal>case when ... then ... else ... end</literal>" +#. Tag: para +#: query_hql.xml:550 +#, no-c-format +msgid "" +"\"Simple\" case, <literal>case ... when ... then ... else ... end</literal>, " +"and \"searched\" case, <literal>case when ... then ... else ... end</literal>" msgstr "" +"case \"simples\" , <literal>case ... when ... then ... else ... end</" +"literal>, and \"searched\" case, <literal>case when ... then ... else ... " +"end</literal>" -#: index.docbook:556 -msgid "string concatenation <literal>...||...</literal> or <literal>concat(...,...)</literal>" +#. Tag: para +#: query_hql.xml:556 +#, no-c-format +msgid "" +"string concatenation <literal>...||...</literal> or <literal>concat(...,...)" +"</literal>" msgstr "" +"concatenação de string <literal>...||...</literal> ou <literal>concat" +"(...,...)</literal>" -#: index.docbook:561 -msgid "<literal>current_date()</literal>, <literal>current_time()</literal>, <literal>current_timestamp()</literal>" +#. Tag: para +#: query_hql.xml:561 +#, no-c-format +msgid "" +"<literal>current_date()</literal>, <literal>current_time()</literal>, " +"<literal>current_timestamp()</literal>" msgstr "" +"<literal>current_date()</literal>, <literal>current_time()</literal>, " +"<literal>current_timestamp()</literal>" -#: index.docbook:567 -msgid "<literal>second(...)</literal>, <literal>minute(...)</literal>, <literal>hour(...)</literal>, <literal>day(...)</literal>, <literal>month(...)</literal>, <literal>year(...)</literal>," +#. Tag: para +#: query_hql.xml:567 +#, no-c-format +msgid "" +"<literal>second(...)</literal>, <literal>minute(...)</literal>, <literal>hour" +"(...)</literal>, <literal>day(...)</literal>, <literal>month(...)</literal>, " +"<literal>year(...)</literal>," msgstr "" +"<literal>second(...)</literal>, <literal>minute(...)</literal>, <literal>hour" +"(...)</literal>, <literal>day(...)</literal>, <literal>month(...)</literal>, " +"<literal>year(...)</literal>," -#: index.docbook:574 -msgid "Any function or operator defined by EJB-QL 3.0: <literal>substring(), trim(), lower(), upper(), length(), locate(), abs(), sqrt(), bit_length(), mod()</literal>" +#. Tag: para +#: query_hql.xml:574 +#, no-c-format +msgid "" +"Any function or operator defined by EJB-QL 3.0: <literal>substring(), trim" +"(), lower(), upper(), length(), locate(), abs(), sqrt(), bit_length(), mod()" +"</literal>" msgstr "" +"qualquer funcao ou operador definida pela EJB-QL 3.0: <literal>substring(), " +"trim(), lower(), upper(), length(), locate(), abs(), sqrt(), bit_length(), " +"mod()</literal>" -#: index.docbook:580 +#. Tag: para +#: query_hql.xml:580 +#, no-c-format msgid "<literal>coalesce()</literal> and <literal>nullif()</literal>" -msgstr "" +msgstr "<literal>coalesce()</literal> and <literal>nullif()</literal>" -#: index.docbook:585 -msgid "<literal>str()</literal> for converting numeric or temporal values to a readable string" +#. Tag: para +#: query_hql.xml:585 +#, no-c-format +msgid "" +"<literal>str()</literal> for converting numeric or temporal values to a " +"readable string" msgstr "" +"<literal>str()</literal> para converter valores numericos ou temporais para " +"string" -#: index.docbook:591 -msgid "<literal>cast(... as ...)</literal>, where the second argument is the name of a Hibernate type, and <literal>extract(... from ...)</literal> if ANSI <literal>cast()</literal> and <literal>extract()</literal> is supported by the underlying database" +#. Tag: para +#: query_hql.xml:591 +#, no-c-format +msgid "" +"<literal>cast(... as ...)</literal>, where the second argument is the name " +"of a Hibernate type, and <literal>extract(... from ...)</literal> if ANSI " +"<literal>cast()</literal> and <literal>extract()</literal> is supported by " +"the underlying database" msgstr "" +"<literal>cast(... as ...)</literal>, onde o segundo argumento é o nome do " +"tipo hibernate, e<literal>extract(... from ...)</literal> se ANSI " +"<literal>cast()</literal> e <literal>extract()</literal> é suportado pele " +"banco de dados usado" -#: index.docbook:599 -msgid "the HQL <literal>index()</literal> function, that applies to aliases of a joined indexed collection" +#. Tag: para +#: query_hql.xml:599 +#, no-c-format +msgid "" +"the HQL <literal>index()</literal> function, that applies to aliases of a " +"joined indexed collection" msgstr "" +"A função HQL <literal>index()</literal> , que se aplicam a referencias de " +"coleçôes associadas e indexadas" -#: index.docbook:605 -msgid "HQL functions that take collection-valued path expressions: <literal>size(), minelement(), maxelement(), minindex(), maxindex()</literal>, along with the special <literal>elements()</literal> and <literal>indices</literal> functions which may be quantified using <literal>some, all, exists, any, in</literal>." +#. Tag: para +#: query_hql.xml:605 +#, no-c-format +msgid "" +"HQL functions that take collection-valued path expressions: <literal>size(), " +"minelement(), maxelement(), minindex(), maxindex()</literal>, along with the " +"special <literal>elements()</literal> and <literal>indices</literal> " +"functions which may be quantified using <literal>some, all, exists, any, in</" +"literal>." msgstr "" +"As funções hql que retornam expressões de coleções de valores: <literal>size" +"(), minelement(), maxelement(), minindex(), maxindex()</literal>, " +"<literal>junto</literal> com o elemento especial, <literal>elements()</" +"literal>, e funções de <literal>índice</literal> que podem ser quantificadas " +"usando <literal>some, all, exists, any, in</literal>." -#: index.docbook:613 -msgid "Any database-supported SQL scalar function like <literal>sign()</literal>, <literal>trunc()</literal>, <literal>rtrim()</literal>, <literal>sin()</literal>" +#. Tag: para +#: query_hql.xml:613 +#, no-c-format +msgid "" +"Any database-supported SQL scalar function like <literal>sign()</literal>, " +"<literal>trunc()</literal>, <literal>rtrim()</literal>, <literal>sin()</" +"literal>" msgstr "" +"Qualquer funçâo escalar pelo bando de dados como <literal>sign()</literal>, " +"<literal>trunc()</literal>, <literal>rtrim()</literal>, <literal>sin()</" +"literal>" -#: index.docbook:619 +#. Tag: para +#: query_hql.xml:619 +#, no-c-format msgid "JDBC-style positional parameters <literal>?</literal>" -msgstr "" +msgstr "Parametros posicionais ao estilo JDBC <literal>?</literal>" -#: index.docbook:624 -msgid "named parameters <literal>:name</literal>, <literal>:start_date</literal>, <literal>:x1</literal>" +#. Tag: para +#: query_hql.xml:624 +#, no-c-format +msgid "" +"named parameters <literal>:name</literal>, <literal>:start_date</literal>, " +"<literal>:x1</literal>" msgstr "" +"Parametros nomeados <literal>:name</literal>, <literal>:start_date</" +"literal>, <literal>:x1</literal>" -#: index.docbook:629 -msgid "SQL literals <literal>'foo'</literal>, <literal>69</literal>, <literal>6.66E+2</literal>, <literal>'1970-01-01 10:00:01.0'</literal>" +#. Tag: para +#: query_hql.xml:629 +#, no-c-format +msgid "" +"SQL literals <literal>'foo'</literal>, <literal>69</literal>, <literal>6.66E" +"+2</literal>, <literal>'1970-01-01 10:00:01.0'</literal>" msgstr "" +"Literais SQL <literal>'foo'</literal>, <literal>69</literal>, <literal>6.66E" +"+2</literal>, <literal>'1970-01-01 10:00:01.0'</literal>" -#: index.docbook:635 -msgid "Java <literal>public static final</literal> constants <literal>eg.Color.TABBY</literal>" +#. Tag: para +#: query_hql.xml:635 +#, no-c-format +msgid "" +"Java <literal>public static final</literal> constants <literal>eg.Color." +"TABBY</literal>" msgstr "" +"Constantes Java <literal>public static final</literal><literal>ex: Color." +"TABBY</literal>" -#: index.docbook:641 -msgid "<literal>in</literal> and <literal>between</literal> may be used as follows:" +#. Tag: para +#: query_hql.xml:641 +#, no-c-format +msgid "" +"<literal>in</literal> and <literal>between</literal> may be used as follows:" msgstr "" +"<literal>in</literal> e <literal>between</literal> podem ser usadas da " +"seguinte maneira:" -#: index.docbook:645 +#. Tag: programlisting +#: query_hql.xml:645 +#, no-c-format msgid "<![CDATA[from DomesticCat cat where cat.name between 'A' and 'B']]>" msgstr "" -#: index.docbook:647 -msgid "<![CDATA[from DomesticCat cat where cat.name in ( 'Foo', 'Bar', 'Baz' )]]>" +#. Tag: programlisting +#: query_hql.xml:647 +#, no-c-format +msgid "" +"<![CDATA[from DomesticCat cat where cat.name in ( 'Foo', 'Bar', 'Baz' )]]>" msgstr "" -#: index.docbook:649 +#. Tag: para +#: query_hql.xml:649 +#, no-c-format msgid "and the negated forms may be written" -msgstr "" +msgstr "e as formas negativas podem ser escritas" -#: index.docbook:653 +#. Tag: programlisting +#: query_hql.xml:653 +#, no-c-format msgid "<![CDATA[from DomesticCat cat where cat.name not between 'A' and 'B']]>" msgstr "" -#: index.docbook:655 -msgid "<![CDATA[from DomesticCat cat where cat.name not in ( 'Foo', 'Bar', 'Baz' )]]>" +#. Tag: programlisting +#: query_hql.xml:655 +#, no-c-format +msgid "" +"<![CDATA[from DomesticCat cat where cat.name not in ( 'Foo', 'Bar', 'Baz' )]]" +">" msgstr "" -#: index.docbook:657 -msgid "Likewise, <literal>is null</literal> and <literal>is not null</literal> may be used to test for null values." +#. Tag: para +#: query_hql.xml:657 +#, no-c-format +msgid "" +"Likewise, <literal>is null</literal> and <literal>is not null</literal> may " +"be used to test for null values." msgstr "" +"Likewise, <literal>is null</literal> and <literal>is not null</literal> may " +"be used to test for null values. Assim mesmo, , <literal>is null</literal> e " +"<literal>is not null</literal> podem ser usados para testar valores nulos." -#: index.docbook:662 -msgid "Booleans may be easily used in expressions by declaring HQL query substitutions in Hibernate configuration:" +#. Tag: para +#: query_hql.xml:662 +#, no-c-format +msgid "" +"Booleans may be easily used in expressions by declaring HQL query " +"substitutions in Hibernate configuration:" msgstr "" +"Booleanos podem ser facilmente usados em expressões, declarando as " +"substituições da HQL query, na configuração do Hibernate" -#: index.docbook:667 -msgid "<![CDATA[<property name=\"hibernate.query.substitutions\">true 1, false 0</property>]]>" +#. Tag: programlisting +#: query_hql.xml:667 +#, no-c-format +msgid "" +"<![CDATA[<property name=\"hibernate.query.substitutions\">true 1, false 0</" +"property>]]>" msgstr "" -#: index.docbook:669 -msgid "This will replace the keywords <literal>true</literal> and <literal>false</literal> with the literals <literal>1</literal> and <literal>0</literal> in the translated SQL from this HQL:" +#. Tag: para +#: query_hql.xml:669 +#, no-c-format +msgid "" +"This will replace the keywords <literal>true</literal> and <literal>false</" +"literal> with the literals <literal>1</literal> and <literal>0</literal> in " +"the translated SQL from this HQL:" msgstr "" +"Isso irá substituir as palavras chave <literal>true</literal> e " +"<literal>false</literal><literal>pelos</literal> literais <literal>1</" +"literal> e <literal>0</literal> na tradução do HQL para SQL." -#: index.docbook:674 +#. Tag: programlisting +#: query_hql.xml:674 +#, no-c-format msgid "<![CDATA[from Cat cat where cat.alive = true]]>" msgstr "" -#: index.docbook:676 -msgid "You may test the size of a collection with the special property <literal>size</literal>, or the special <literal>size()</literal> function." +#. Tag: para +#: query_hql.xml:676 +#, no-c-format +msgid "" +"You may test the size of a collection with the special property " +"<literal>size</literal>, or the special <literal>size()</literal> function." msgstr "" +"Pode-se testar o tamanho de uma coleção <literal>com</literal> a propriedade " +"especial <literal>size</literal>, ou a função especial <literal>size()</" +"literal>." -#: index.docbook:681 +#. Tag: programlisting +#: query_hql.xml:681 +#, no-c-format msgid "<![CDATA[from Cat cat where cat.kittens.size > 0]]>" msgstr "" -#: index.docbook:683 +#. Tag: programlisting +#: query_hql.xml:683 +#, no-c-format msgid "<![CDATA[from Cat cat where size(cat.kittens) > 0]]>" msgstr "" -#: index.docbook:685 -msgid "For indexed collections, you may refer to the minimum and maximum indices using <literal>minindex</literal> and <literal>maxindex</literal> functions. Similarly, you may refer to the minimum and maximum elements of a collection of basic type using the <literal>minelement</literal> and <literal>maxelement</literal> functions." +#. Tag: para +#: query_hql.xml:685 +#, no-c-format +msgid "" +"For indexed collections, you may refer to the minimum and maximum indices " +"using <literal>minindex</literal> and <literal>maxindex</literal> functions. " +"Similarly, you may refer to the minimum and maximum elements of a collection " +"of basic type using the <literal>minelement</literal> and " +"<literal>maxelement</literal> functions." msgstr "" +"Para coleções indexadas, você pode se referir aos índices máximo e mínimo, " +"usando as funções <literal>minindex</literal> e <literal>maxindex</literal>. " +"Similarmente, pode-se referir aos elementos máximo e mínimo de uma coleção " +"de tipos básicos usando as funções <literal>minelement</literal> e " +"<literal>maxelement</literal>." -#: index.docbook:693 -msgid "<![CDATA[from Calendar cal where maxelement(cal.holidays) > current_date]]>" +#. Tag: programlisting +#: query_hql.xml:693 +#, no-c-format +msgid "" +"<![CDATA[from Calendar cal where maxelement(cal.holidays) > current_date]]>" msgstr "" -#: index.docbook:695 +#. Tag: programlisting +#: query_hql.xml:695 +#, no-c-format msgid "<![CDATA[from Order order where maxindex(order.items) > 100]]>" msgstr "" -#: index.docbook:697 +#. Tag: programlisting +#: query_hql.xml:697 +#, no-c-format msgid "<![CDATA[from Order order where minelement(order.items) > 10000]]>" msgstr "" -#: index.docbook:699 -msgid "The SQL functions <literal>any, some, all, exists, in</literal> are supported when passed the element or index set of a collection (<literal>elements</literal> and <literal>indices</literal> functions) or the result of a subquery (see below)." +#. Tag: para +#: query_hql.xml:699 +#, no-c-format +msgid "" +"The SQL functions <literal>any, some, all, exists, in</literal> are " +"supported when passed the element or index set of a collection " +"(<literal>elements</literal> and <literal>indices</literal> functions) or " +"the result of a subquery (see below)." msgstr "" +"As funções SQL <literal>any, some, all, exists, in</literal> são suportadas " +"quando passado o elemento ou o conjunto de índices de uma coleção " +"(<literal>elements</literal> e <literal>indices</literal> de funções), ou o " +"resultado de uma subquery (veja abaixo)." -#: index.docbook:705 +#. Tag: programlisting +#: query_hql.xml:705 +#, no-c-format msgid "" - "<![CDATA[select mother from Cat as mother, Cat as kit\n" - "where kit in elements(foo.kittens)]]>" +"<![CDATA[select mother from Cat as mother, Cat as kit\n" +"where kit in elements(foo.kittens)]]>" msgstr "" -#: index.docbook:707 +#. Tag: programlisting +#: query_hql.xml:707 +#, no-c-format msgid "" - "<![CDATA[select p from NameList list, Person p\n" - "where p.name = some elements(list.names)]]>" +"<![CDATA[select p from NameList list, Person p\n" +"where p.name = some elements(list.names)]]>" msgstr "" -#: index.docbook:709 +#. Tag: programlisting +#: query_hql.xml:709 +#, no-c-format msgid "<![CDATA[from Cat cat where exists elements(cat.kittens)]]>" msgstr "" -#: index.docbook:711 +#. Tag: programlisting +#: query_hql.xml:711 +#, no-c-format msgid "<![CDATA[from Player p where 3 > all elements(p.scores)]]>" msgstr "" -#: index.docbook:713 +#. Tag: programlisting +#: query_hql.xml:713 +#, no-c-format msgid "<![CDATA[from Show show where 'fizard' in indices(show.acts)]]>" msgstr "" -#: index.docbook:715 -msgid "Note that these constructs - <literal>size</literal>, <literal>elements</literal>, <literal>indices</literal>, <literal>minindex</literal>, <literal>maxindex</literal>, <literal>minelement</literal>, <literal>maxelement</literal> - may only be used in the where clause in Hibernate3." +#. Tag: para +#: query_hql.xml:715 +#, no-c-format +msgid "" +"Note that these constructs - <literal>size</literal>, <literal>elements</" +"literal>, <literal>indices</literal>, <literal>minindex</literal>, " +"<literal>maxindex</literal>, <literal>minelement</literal>, " +"<literal>maxelement</literal> - may only be used in the where clause in " +"Hibernate3." msgstr "" +"Note que essas construções - <literal>size</literal>, <literal>elements</" +"literal>, <literal>indices</literal>, <literal>minindex</literal>, " +"<literal>maxindex</literal>, <literal>minelement</literal>, " +"<literal>maxelement</literal>– só podem ser usados na clausula where do " +"Hibernate3." -#: index.docbook:722 -msgid "Elements of indexed collections (arrays, lists, maps) may be referred to by index (in a where clause only):" +#. Tag: para +#: query_hql.xml:722 +#, no-c-format +msgid "" +"Elements of indexed collections (arrays, lists, maps) may be referred to by " +"index (in a where clause only):" msgstr "" +"Elementos de coleções com índice (arrays, lists, maps), podem ser " +"referenciadas pelo índice (apenas na clausula where):" -#: index.docbook:727 +#. Tag: programlisting +#: query_hql.xml:727 +#, no-c-format msgid "<![CDATA[from Order order where order.items[0].id = 1234]]>" msgstr "" -#: index.docbook:729 +#. Tag: programlisting +#: query_hql.xml:729 +#, no-c-format msgid "" - "<![CDATA[select person from Person person, Calendar calendar\n" - "where calendar.holidays['national day'] = person.birthDay\n" - " and person.nationality.calendar = calendar]]>" +"<![CDATA[select person from Person person, Calendar calendar\n" +"where calendar.holidays['national day'] = person.birthDay\n" +" and person.nationality.calendar = calendar]]>" msgstr "" -#: index.docbook:731 +#. Tag: programlisting +#: query_hql.xml:731 +#, no-c-format msgid "" - "<![CDATA[select item from Item item, Order order\n" - "where order.items[ order.deliveredItemIndices[0] ] = item and order.id = 11]]>" +"<![CDATA[select item from Item item, Order order\n" +"where order.items[ order.deliveredItemIndices[0] ] = item and order.id = 11]]" +">" msgstr "" -#: index.docbook:733 +#. Tag: programlisting +#: query_hql.xml:733 +#, no-c-format msgid "" - "<![CDATA[select item from Item item, Order order\n" - "where order.items[ maxindex(order.items) ] = item and order.id = 11]]>" +"<![CDATA[select item from Item item, Order order\n" +"where order.items[ maxindex(order.items) ] = item and order.id = 11]]>" msgstr "" -#: index.docbook:735 -msgid "The expression inside <literal>[]</literal> may even be an arithmetic expression." +#. Tag: para +#: query_hql.xml:735 +#, no-c-format +msgid "" +"The expression inside <literal>[]</literal> may even be an arithmetic " +"expression." msgstr "" +"A expressão entre colchetes <literal>[]</literal>, pode ser até uma " +"expressão aritimética." -#: index.docbook:739 +#. Tag: programlisting +#: query_hql.xml:739 +#, no-c-format msgid "" - "<![CDATA[select item from Item item, Order order\n" - "where order.items[ size(order.items) - 1 ] = item]]>" +"<![CDATA[select item from Item item, Order order\n" +"where order.items[ size(order.items) - 1 ] = item]]>" msgstr "" -#: index.docbook:741 -msgid "HQL also provides the built-in <literal>index()</literal> function, for elements of a one-to-many association or collection of values." +#. Tag: para +#: query_hql.xml:741 +#, no-c-format +msgid "" +"HQL also provides the built-in <literal>index()</literal> function, for " +"elements of a one-to-many association or collection of values." msgstr "" +"O HQL também provê a função interna <literal>index()</literal>, para " +"elementos de associação um-pra-muitos ou coleção de valores." -#: index.docbook:746 +#. Tag: programlisting +#: query_hql.xml:746 +#, no-c-format msgid "" - "<![CDATA[select item, index(item) from Order order\n" - " join order.items item\n" - "where index(item) < 5]]>" +"<![CDATA[select item, index(item) from Order order\n" +" join order.items item\n" +"where index(item) < 5]]>" msgstr "" -#: index.docbook:748 +#. Tag: para +#: query_hql.xml:748 +#, no-c-format msgid "Scalar SQL functions supported by the underlying database may be used" -msgstr "" +msgstr "Funções escalares SQL, suportadas pelo banco de dados subjacente." -#: index.docbook:752 +#. Tag: programlisting +#: query_hql.xml:752 +#, no-c-format msgid "<![CDATA[from DomesticCat cat where upper(cat.name) like 'FRI%']]>" msgstr "" -#: index.docbook:754 -msgid "If you are not yet convinced by all this, think how much longer and less readable the following query would be in SQL:" +#. Tag: para +#: query_hql.xml:754 +#, no-c-format +msgid "" +"If you are not yet convinced by all this, think how much longer and less " +"readable the following query would be in SQL:" msgstr "" +"Se ainda ainda não está totalmente convencido, pense o quão maior e menos " +"legível poderia ser a query a seguir, em SQL:" -#: index.docbook:759 +#. Tag: programlisting +#: query_hql.xml:759 +#, no-c-format msgid "" - "<![CDATA[select cust\n" - "from Product prod,\n" - " Store store\n" - " inner join store.customers cust\n" - "where prod.name = 'widget'\n" - " and store.location.name in ( 'Melbourne', 'Sydney' )\n" - " and prod = all elements(cust.currentOrder.lineItems)]]>" +"<![CDATA[select cust\n" +"from Product prod,\n" +" Store store\n" +" inner join store.customers cust\n" +"where prod.name = 'widget'\n" +" and store.location.name in ( 'Melbourne', 'Sydney' )\n" +" and prod = all elements(cust.currentOrder.lineItems)]]>" msgstr "" -#: index.docbook:761 +#. Tag: para +#: query_hql.xml:761 +#, no-c-format msgid "<emphasis>Hint:</emphasis> something like" -msgstr "" +msgstr "<emphasis>Hint:</emphasis> something like" -#: index.docbook:765 +#. Tag: programlisting +#: query_hql.xml:765 +#, no-c-format msgid "" - "<![CDATA[SELECT cust.name, cust.address, cust.phone, cust.id, cust.current_order\n" - "FROM customers cust,\n" - " stores store,\n" - " locations loc,\n" - " store_customers sc,\n" - " product prod\n" - "WHERE prod.name = 'widget'\n" - " AND store.loc_id = loc.id\n" - " AND loc.name IN ( 'Melbourne', 'Sydney' )\n" - " AND sc.store_id = store.id\n" - " AND sc.cust_id = cust.id\n" - " AND prod.id = ALL(\n" - " SELECT item.prod_id\n" - " FROM line_items item, orders o\n" - " WHERE item.order_id = o.id\n" - " AND cust.current_order = o.id\n" - " )]]>" +"<![CDATA[SELECT cust.name, cust.address, cust.phone, cust.id, cust." +"current_order\n" +"FROM customers cust,\n" +" stores store,\n" +" locations loc,\n" +" store_customers sc,\n" +" product prod\n" +"WHERE prod.name = 'widget'\n" +" AND store.loc_id = loc.id\n" +" AND loc.name IN ( 'Melbourne', 'Sydney' )\n" +" AND sc.store_id = store.id\n" +" AND sc.cust_id = cust.id\n" +" AND prod.id = ALL(\n" +" SELECT item.prod_id\n" +" FROM line_items item, orders o\n" +" WHERE item.order_id = o.id\n" +" AND cust.current_order = o.id\n" +" )]]>" msgstr "" -#: index.docbook:770 +#. Tag: title +#: query_hql.xml:770 +#, no-c-format msgid "The order by clause" -msgstr "" +msgstr "A clausula order by" -#: index.docbook:772 -msgid "The list returned by a query may be ordered by any property of a returned class or components:" +#. Tag: para +#: query_hql.xml:772 +#, no-c-format +msgid "" +"The list returned by a query may be ordered by any property of a returned " +"class or components:" msgstr "" +"A lista retornada pela query pode ser ordenada por qualquer propriedade da " +"classe ou componente retornado:" -#: index.docbook:776 +#. Tag: programlisting +#: query_hql.xml:776 +#, no-c-format msgid "" - "<![CDATA[from DomesticCat cat\n" - "order by cat.name asc, cat.weight desc, cat.birthdate]]>" +"<![CDATA[from DomesticCat cat\n" +"order by cat.name asc, cat.weight desc, cat.birthdate]]>" msgstr "" -#: index.docbook:778 -msgid "The optional <literal>asc</literal> or <literal>desc</literal> indicate ascending or descending order respectively." +#. Tag: para +#: query_hql.xml:778 +#, no-c-format +msgid "" +"The optional <literal>asc</literal> or <literal>desc</literal> indicate " +"ascending or descending order respectively." msgstr "" +"As opções <literal>asc</literal> ou <literal>desc</literal> indicam ordem " +"crescente ou decrescente, respectivamente." -#: index.docbook:785 +#. Tag: title +#: query_hql.xml:785 +#, no-c-format msgid "The group by clause" -msgstr "" +msgstr "A clausula group by" -#: index.docbook:787 -msgid "A query that returns aggregate values may be grouped by any property of a returned class or components:" +#. Tag: para +#: query_hql.xml:787 +#, no-c-format +msgid "" +"A query that returns aggregate values may be grouped by any property of a " +"returned class or components:" msgstr "" +"Uma query que retorne valores agregados, podem ser agrupados por qualquer " +"propriedade de uma classe ou componente retornado:" -#: index.docbook:791 +#. Tag: programlisting +#: query_hql.xml:791 +#, no-c-format msgid "" - "<![CDATA[select cat.color, sum(cat.weight), count(cat)\n" - "from Cat cat\n" - "group by cat.color]]>" +"<![CDATA[select cat.color, sum(cat.weight), count(cat)\n" +"from Cat cat\n" +"group by cat.color]]>" msgstr "" -#: index.docbook:793 +#. Tag: programlisting +#: query_hql.xml:793 +#, no-c-format msgid "" - "<![CDATA[select foo.id, avg(name), max(name)\n" - "from Foo foo join foo.names name\n" - "group by foo.id]]>" +"<![CDATA[select foo.id, avg(name), max(name)\n" +"from Foo foo join foo.names name\n" +"group by foo.id]]>" msgstr "" -#: index.docbook:795 +#. Tag: para +#: query_hql.xml:795 +#, no-c-format msgid "A <literal>having</literal> clause is also allowed." -msgstr "" +msgstr "Uma clausula <literal>having</literal> também é permitida." -#: index.docbook:799 +#. Tag: programlisting +#: query_hql.xml:799 +#, no-c-format msgid "" - "<![CDATA[select cat.color, sum(cat.weight), count(cat)\n" - "from Cat cat\n" - "group by cat.color\n" - "having cat.color in (eg.Color.TABBY, eg.Color.BLACK)]]>" +"<![CDATA[select cat.color, sum(cat.weight), count(cat)\n" +"from Cat cat\n" +"group by cat.color\n" +"having cat.color in (eg.Color.TABBY, eg.Color.BLACK)]]>" msgstr "" -#: index.docbook:801 -msgid "SQL functions and aggregate functions are allowed in the <literal>having</literal> and <literal>order by</literal> clauses, if supported by the underlying database (eg. not in MySQL)." +#. Tag: para +#: query_hql.xml:801 +#, no-c-format +msgid "" +"SQL functions and aggregate functions are allowed in the <literal>having</" +"literal> and <literal>order by</literal> clauses, if supported by the " +"underlying database (eg. not in MySQL)." msgstr "" +"Funções SQL e funções agregadas são permitidas nas clausulas " +"<literal>having</literal> e <literal>order by</literal>, se suportadas pelo " +"banco de dados subjacente (ex: não no MySQL)." -#: index.docbook:807 +#. Tag: programlisting +#: query_hql.xml:807 +#, no-c-format msgid "" - "<![CDATA[select cat\n" - "from Cat cat\n" - " join cat.kittens kitten\n" - "group by cat.id, cat.name, cat.other, cat.properties\n" - "having avg(kitten.weight) > 100\n" - "order by count(kitten) asc, sum(kitten.weight) desc]]>" +"<![CDATA[select cat\n" +"from Cat cat\n" +" join cat.kittens kitten\n" +"group by cat.id, cat.name, cat.other, cat.properties\n" +"having avg(kitten.weight) > 100\n" +"order by count(kitten) asc, sum(kitten.weight) desc]]>" msgstr "" -#: index.docbook:809 -msgid "Note that neither the <literal>group by</literal> clause nor the <literal>order by</literal> clause may contain arithmetic expressions. Also note that Hibernate currently does not expand a grouped entity, so you can't write <literal>group by cat</literal> if all properties of <literal>cat</literal> are non-aggregated. You have to list all non-aggregated properties explicitly." +#. Tag: para +#: query_hql.xml:809 +#, no-c-format +msgid "" +"Note that neither the <literal>group by</literal> clause nor the " +"<literal>order by</literal> clause may contain arithmetic expressions. Also " +"note that Hibernate currently does not expand a grouped entity, so you can't " +"write <literal>group by cat</literal> if all properties of <literal>cat</" +"literal> are non-aggregated. You have to list all non-aggregated properties " +"explicitly." msgstr "" +"Note que, nem a clausula <literal>group by</literal> ou <literal>order by</" +"literal>, podem conter expressões aritiméticas." -#: index.docbook:821 +#. Tag: title +#: query_hql.xml:821 +#, no-c-format msgid "Subqueries" -msgstr "" +msgstr "Subqueries" -#: index.docbook:823 -msgid "For databases that support subselects, Hibernate supports subqueries within queries. A subquery must be surrounded by parentheses (often by an SQL aggregate function call). Even correlated subqueries (subqueries that refer to an alias in the outer query) are allowed." +#. Tag: para +#: query_hql.xml:823 +#, no-c-format +msgid "" +"For databases that support subselects, Hibernate supports subqueries within " +"queries. A subquery must be surrounded by parentheses (often by an SQL " +"aggregate function call). Even correlated subqueries (subqueries that refer " +"to an alias in the outer query) are allowed." msgstr "" +"Para bancos de dados que suportem subselects, o Hibernate suporta subqueries " +"dentro de queries. Uma subquery precisa estar entre parênteses (normalmente " +"uma chamada de função agregada SQL). Mesmo subqueries co-relacionadas " +"(subqueries que fazem referência à alias de outras queries), são aceitas." -#: index.docbook:829 +#. Tag: programlisting +#: query_hql.xml:829 +#, no-c-format msgid "" - "<![CDATA[from Cat as fatcat\n" - "where fatcat.weight > (\n" - " select avg(cat.weight) from DomesticCat cat\n" - ")]]>" +"<![CDATA[from Cat as fatcat\n" +"where fatcat.weight > (\n" +" select avg(cat.weight) from DomesticCat cat\n" +")]]>" msgstr "" -#: index.docbook:831 +#. Tag: programlisting +#: query_hql.xml:831 +#, no-c-format msgid "" - "<![CDATA[from DomesticCat as cat\n" - "where cat.name = some (\n" - " select name.nickName from Name as name\n" - ")]]>" +"<![CDATA[from DomesticCat as cat\n" +"where cat.name = some (\n" +" select name.nickName from Name as name\n" +")]]>" msgstr "" -#: index.docbook:833 +#. Tag: programlisting +#: query_hql.xml:833 +#, no-c-format msgid "" - "<![CDATA[from Cat as cat\n" - "where not exists (\n" - " from Cat as mate where mate.mate = cat\n" - ")]]>" +"<![CDATA[from Cat as cat\n" +"where not exists (\n" +" from Cat as mate where mate.mate = cat\n" +")]]>" msgstr "" -#: index.docbook:835 +#. Tag: programlisting +#: query_hql.xml:835 +#, no-c-format msgid "" - "<![CDATA[from DomesticCat as cat\n" - "where cat.name not in (\n" - " select name.nickName from Name as name\n" - ")]]>" +"<![CDATA[from DomesticCat as cat\n" +"where cat.name not in (\n" +" select name.nickName from Name as name\n" +")]]>" msgstr "" -#: index.docbook:837 +#. Tag: programlisting +#: query_hql.xml:837 +#, no-c-format msgid "" - "<![CDATA[select cat.id, (select max(kit.weight) from cat.kitten kit)\n" - "from Cat as cat]]>" +"<![CDATA[select cat.id, (select max(kit.weight) from cat.kitten kit)\n" +"from Cat as cat]]>" msgstr "" -#: index.docbook:839 +#. Tag: para +#: query_hql.xml:839 +#, no-c-format msgid "Note that HQL subqueries may occur only in the select or where clauses." msgstr "" +"Note que HQL subqueries podem aparecer apenas dentro de clausulas select ou " +"where." -#: index.docbook:843 -msgid "Note that subqueries can also utilize <literal>row value constructor</literal> syntax. See <xref linkend=\"queryhql-tuple\"/> for more details." +#. Tag: para +#: query_hql.xml:843 +#, no-c-format +msgid "" +"Note that subqueries can also utilize <literal>row value constructor</" +"literal> syntax. See <xref linkend=\"queryhql-tuple\"/> for more details." msgstr "" +"Note that subqueries can also utilize <literal>row value constructor</" +"literal> syntax. See <xref linkend=\"queryhql-tuple\"/> for more details." -#: index.docbook:851 +#. Tag: title +#: query_hql.xml:851 +#, no-c-format msgid "HQL examples" -msgstr "" +msgstr "Exemplos de HQL" -#: index.docbook:853 -msgid "Hibernate queries can be quite powerful and complex. In fact, the power of the query language is one of Hibernate's main selling points. Here are some example queries very similar to queries that I used on a recent project. Note that most queries you will write are much simpler than these!" +#. Tag: para +#: query_hql.xml:853 +#, no-c-format +msgid "" +"Hibernate queries can be quite powerful and complex. In fact, the power of " +"the query language is one of Hibernate's main selling points. Here are some " +"example queries very similar to queries that I used on a recent project. " +"Note that most queries you will write are much simpler than these!" msgstr "" +"As queries do Hibernate, podem ser muito poderosas e complexas. De fato, o " +"poder da linguagem de querie é um dos pontos principais na distribuição do " +"Hibernate. Aqui temos algumas queries de exemplo, muito similares a queries " +"que usei em um projeto recente. Note que a maioria das queries que você irá " +"escrever, são mais simples que estas." -#: index.docbook:859 -msgid "The following query returns the order id, number of items and total value of the order for all unpaid orders for a particular customer and given minimum total value, ordering the results by total value. In determining the prices, it uses the current catalog. The resulting SQL query, against the <literal>ORDER</literal>, <literal>ORDER_LINE</literal>, <literal>PRODUCT</literal>, <literal>CATALOG</literal> and <literal>PRICE</literal> tables has four inner joins and an (uncorrelated) subselect." +#. Tag: para +#: query_hql.xml:859 +#, no-c-format +msgid "" +"The following query returns the order id, number of items and total value of " +"the order for all unpaid orders for a particular customer and given minimum " +"total value, ordering the results by total value. In determining the prices, " +"it uses the current catalog. The resulting SQL query, against the " +"<literal>ORDER</literal>, <literal>ORDER_LINE</literal>, <literal>PRODUCT</" +"literal>, <literal>CATALOG</literal> and <literal>PRICE</literal> tables has " +"four inner joins and an (uncorrelated) subselect." msgstr "" +"A query a seguir retorna o id de order, numero de itens e o valor total do " +"order para todos os orders não pagos para um freguês particular e valor " +"total mínimo dado, ordenando os resultados por valor total. Ao determinar os " +"preços, é usado o catalogo corrente. A query SQL resultante, usando tabelas " +"<literal>ORDER</literal>, <literal>ORDER_LINE</literal>, <literal>PRODUCT</" +"literal>, <literal>CATALOG</literal> e <literal>PRICE</literal>, tem quatro " +"inner joins e um (não correlacionado) subselect." -#: index.docbook:868 +#. Tag: programlisting +#: query_hql.xml:868 +#, no-c-format msgid "" - "<![CDATA[select order.id, sum(price.amount), count(item)\n" - "from Order as order\n" - " join order.lineItems as item\n" - " join item.product as product,\n" - " Catalog as catalog\n" - " join catalog.prices as price\n" - "where order.paid = false\n" - " and order.customer = :customer\n" - " and price.product = product\n" - " and catalog.effectiveDate < sysdate\n" - " and catalog.effectiveDate >= all (\n" - " select cat.effectiveDate\n" - " from Catalog as cat\n" - " where cat.effectiveDate < sysdate\n" - " )\n" - "group by order\n" - "having sum(price.amount) > :minAmount\n" - "order by sum(price.amount) desc]]>" +"<![CDATA[select order.id, sum(price.amount), count(item)\n" +"from Order as order\n" +" join order.lineItems as item\n" +" join item.product as product,\n" +" Catalog as catalog\n" +" join catalog.prices as price\n" +"where order.paid = false\n" +" and order.customer = :customer\n" +" and price.product = product\n" +" and catalog.effectiveDate < sysdate\n" +" and catalog.effectiveDate >= all (\n" +" select cat.effectiveDate\n" +" from Catalog as cat\n" +" where cat.effectiveDate < sysdate\n" +" )\n" +"group by order\n" +"having sum(price.amount) > :minAmount\n" +"order by sum(price.amount) desc]]>" msgstr "" -#: index.docbook:870 -msgid "What a monster! Actually, in real life, I'm not very keen on subqueries, so my query was really more like this:" +#. Tag: para +#: query_hql.xml:870 +#, no-c-format +msgid "" +"What a monster! Actually, in real life, I'm not very keen on subqueries, so " +"my query was really more like this:" msgstr "" +"Que monstro! Atualmente, na vida real, eu não sou muito afeiçoado a " +"subqueries, então minha query seria mais parecida com isto:" -#: index.docbook:875 +#. Tag: programlisting +#: query_hql.xml:875 +#, no-c-format msgid "" - "<![CDATA[select order.id, sum(price.amount), count(item)\n" - "from Order as order\n" - " join order.lineItems as item\n" - " join item.product as product,\n" - " Catalog as catalog\n" - " join catalog.prices as price\n" - "where order.paid = false\n" - " and order.customer = :customer\n" - " and price.product = product\n" - " and catalog = :currentCatalog\n" - "group by order\n" - "having sum(price.amount) > :minAmount\n" - "order by sum(price.amount) desc]]>" +"<![CDATA[select order.id, sum(price.amount), count(item)\n" +"from Order as order\n" +" join order.lineItems as item\n" +" join item.product as product,\n" +" Catalog as catalog\n" +" join catalog.prices as price\n" +"where order.paid = false\n" +" and order.customer = :customer\n" +" and price.product = product\n" +" and catalog = :currentCatalog\n" +"group by order\n" +"having sum(price.amount) > :minAmount\n" +"order by sum(price.amount) desc]]>" msgstr "" -#: index.docbook:877 -msgid "The next query counts the number of payments in each status, excluding all payments in the <literal>AWAITING_APPROVAL</literal> status where the most recent status change was made by the current user. It translates to an SQL query with two inner joins and a correlated subselect against the <literal>PAYMENT</literal>, <literal>PAYMENT_STATUS</literal> and <literal>PAYMENT_STATUS_CHANGE</literal> tables." +#. Tag: para +#: query_hql.xml:877 +#, no-c-format +msgid "" +"The next query counts the number of payments in each status, excluding all " +"payments in the <literal>AWAITING_APPROVAL</literal> status where the most " +"recent status change was made by the current user. It translates to an SQL " +"query with two inner joins and a correlated subselect against the " +"<literal>PAYMENT</literal>, <literal>PAYMENT_STATUS</literal> and " +"<literal>PAYMENT_STATUS_CHANGE</literal> tables." msgstr "" +"A próxima query conta o número de pagamentos em cada status, tirando todos " +"os pagamentos com status <literal>AWAITING_APPROVAL</literal>, onde a mais " +"recente mudança de status foi feita pelo usuário corrente. Traduz-se para " +"uma query SQL <literal>com</literal> dois inner joins e um subselect " +"correlacionado, nas tabelas <literal>PAYMENT</literal>, " +"<literal>PAYMENT_STATUS</literal> e <literal>PAYMENT_STATUS_CHANGE</" +"literal> ." -#: index.docbook:885 +#. Tag: programlisting +#: query_hql.xml:885 +#, no-c-format msgid "" - "<![CDATA[select count(payment), status.name\n" - "from Payment as payment\n" - " join payment.currentStatus as status\n" - " join payment.statusChanges as statusChange\n" - "where payment.status.name <> PaymentStatus.AWAITING_APPROVAL\n" - " or (\n" - " statusChange.timeStamp = (\n" - " select max(change.timeStamp)\n" - " from PaymentStatusChange change\n" - " where change.payment = payment\n" - " )\n" - " and statusChange.user <> :currentUser\n" - " )\n" - "group by status.name, status.sortOrder\n" - "order by status.sortOrder]]>" +"<![CDATA[select count(payment), status.name\n" +"from Payment as payment\n" +" join payment.currentStatus as status\n" +" join payment.statusChanges as statusChange\n" +"where payment.status.name <> PaymentStatus.AWAITING_APPROVAL\n" +" or (\n" +" statusChange.timeStamp = (\n" +" select max(change.timeStamp)\n" +" from PaymentStatusChange change\n" +" where change.payment = payment\n" +" )\n" +" and statusChange.user <> :currentUser\n" +" )\n" +"group by status.name, status.sortOrder\n" +"order by status.sortOrder]]>" msgstr "" -#: index.docbook:887 -msgid "If I would have mapped the <literal>statusChanges</literal> collection as a list, instead of a set, the query would have been much simpler to write." +#. Tag: para +#: query_hql.xml:887 +#, no-c-format +msgid "" +"If I would have mapped the <literal>statusChanges</literal> collection as a " +"list, instead of a set, the query would have been much simpler to write." msgstr "" +"Se eu tivesse mapeado a Collection <literal>statusChanges</literal> como um " +"List, ao invés de um Set, a query teria sido muito mais simples de escrever." -#: index.docbook:892 +#. Tag: programlisting +#: query_hql.xml:892 +#, no-c-format msgid "" - "<![CDATA[select count(payment), status.name\n" - "from Payment as payment\n" - " join payment.currentStatus as status\n" - "where payment.status.name <> PaymentStatus.AWAITING_APPROVAL\n" - " or payment.statusChanges[ maxIndex(payment.statusChanges) ].user <> :currentUser\n" - "group by status.name, status.sortOrder\n" - "order by status.sortOrder]]>" +"<![CDATA[select count(payment), status.name\n" +"from Payment as payment\n" +" join payment.currentStatus as status\n" +"where payment.status.name <> PaymentStatus.AWAITING_APPROVAL\n" +" or payment.statusChanges[ maxIndex(payment.statusChanges) ].user <> :" +"currentUser\n" +"group by status.name, status.sortOrder\n" +"order by status.sortOrder]]>" msgstr "" -#: index.docbook:894 -msgid "The next query uses the MS SQL Server <literal>isNull()</literal> function to return all the accounts and unpaid payments for the organization to which the current user belongs. It translates to an SQL query with three inner joins, an outer join and a subselect against the <literal>ACCOUNT</literal>, <literal>PAYMENT</literal>, <literal>PAYMENT_STATUS</literal>, <literal>ACCOUNT_TYPE</literal>, <literal>ORGANIZATION</literal> and <literal>ORG_USER</literal> tables." +#. Tag: para +#: query_hql.xml:894 +#, no-c-format +msgid "" +"The next query uses the MS SQL Server <literal>isNull()</literal> function " +"to return all the accounts and unpaid payments for the organization to which " +"the current user belongs. It translates to an SQL query with three inner " +"joins, an outer join and a subselect against the <literal>ACCOUNT</literal>, " +"<literal>PAYMENT</literal>, <literal>PAYMENT_STATUS</literal>, " +"<literal>ACCOUNT_TYPE</literal>, <literal>ORGANIZATION</literal> and " +"<literal>ORG_USER</literal> tables." msgstr "" +"A próxima query usa a função <literal>isNull()</literal> do MS SQL Server, " +"para retornar todas as contas e pagamentos não pagos para a organização, " +"para cada usuário corrente pertencente. Traduz-se para uma query SQL " +"<literal>com</literal> três inner joins, um outer join e um subselect nas " +"tabelas <literal>ACCOUNT</literal>, <literal>PAYMENT</literal>, " +"<literal>PAYMENT_STATUS</literal>,<literal>ACCOUNT_TYPE</literal>, " +"<literal>ORGANIZATION</literal> e <literal>ORG_USER</literal> ." -#: index.docbook:903 +#. Tag: programlisting +#: query_hql.xml:903 +#, no-c-format msgid "" - "<![CDATA[select account, payment\n" - "from Account as account\n" - " left outer join account.payments as payment\n" - "where :currentUser in elements(account.holder.users)\n" - " and PaymentStatus.UNPAID = isNull(payment.currentStatus.name, PaymentStatus.UNPAID)\n" - "order by account.type.sortOrder, account.accountNumber, payment.dueDate]]>" +"<![CDATA[select account, payment\n" +"from Account as account\n" +" left outer join account.payments as payment\n" +"where :currentUser in elements(account.holder.users)\n" +" and PaymentStatus.UNPAID = isNull(payment.currentStatus.name, " +"PaymentStatus.UNPAID)\n" +"order by account.type.sortOrder, account.accountNumber, payment.dueDate]]>" msgstr "" -#: index.docbook:905 -msgid "For some databases, we would need to do away with the (correlated) subselect." +#. Tag: para +#: query_hql.xml:905 +#, no-c-format +msgid "" +"For some databases, we would need to do away with the (correlated) subselect." msgstr "" +"Para alguns bancos de dados, precisaremos eleminar o subselect " +"(correlacionado)." -#: index.docbook:909 +#. Tag: programlisting +#: query_hql.xml:909 +#, no-c-format msgid "" - "<![CDATA[select account, payment\n" - "from Account as account\n" - " join account.holder.users as user\n" - " left outer join account.payments as payment\n" - "where :currentUser = user\n" - " and PaymentStatus.UNPAID = isNull(payment.currentStatus.name, PaymentStatus.UNPAID)\n" - "order by account.type.sortOrder, account.accountNumber, payment.dueDate]]>" +"<![CDATA[select account, payment\n" +"from Account as account\n" +" join account.holder.users as user\n" +" left outer join account.payments as payment\n" +"where :currentUser = user\n" +" and PaymentStatus.UNPAID = isNull(payment.currentStatus.name, " +"PaymentStatus.UNPAID)\n" +"order by account.type.sortOrder, account.accountNumber, payment.dueDate]]>" msgstr "" -#: index.docbook:914 +#. Tag: title +#: query_hql.xml:914 +#, no-c-format msgid "Bulk update and delete" -msgstr "" +msgstr "update e delete em lote" -#: index.docbook:916 -msgid "HQL now supports <literal>update</literal>, <literal>delete</literal> and <literal>insert ... select ...</literal> statements. See <xref linkend=\"batch-direct\"/> for details." +#. Tag: para +#: query_hql.xml:916 +#, no-c-format +msgid "" +"HQL now supports <literal>update</literal>, <literal>delete</literal> and " +"<literal>insert ... select ...</literal> statements. See <xref linkend=" +"\"batch-direct\"/> for details." msgstr "" +"Agora o HQL suporta declarações, <literal>update</literal>, <literal>delete</" +"literal> e <literal>insert ... select ...</literal> Veja <xref linkend=" +"\"batch-direct\"/>, para mais detalhes." -#: index.docbook:924 +#. Tag: title +#: query_hql.xml:924 +#, no-c-format msgid "Tips & Tricks" -msgstr "" +msgstr "Dicas e Truques" -#: index.docbook:926 -msgid "You can count the number of query results without actually returning them:" +#. Tag: para +#: query_hql.xml:926 +#, no-c-format +msgid "" +"You can count the number of query results without actually returning them:" msgstr "" +"Pode-se contar o número de resultados da query, sem realmente retorna-los." -#: index.docbook:930 -msgid "<![CDATA[( (Integer) session.createQuery(\"select count(*) from ....\").iterate().next() ).intValue()]]>" +#. Tag: programlisting +#: query_hql.xml:930 +#, no-c-format +msgid "" +"<![CDATA[( (Integer) session.createQuery(\"select count(*) from ....\")." +"iterate().next() ).intValue()]]>" msgstr "" -#: index.docbook:932 +#. Tag: para +#: query_hql.xml:932 +#, no-c-format msgid "To order a result by the size of a collection, use the following query:" msgstr "" +"Para ordenar um resultado pelo tamanho de uma Collection, use a query a " +"seguir." -#: index.docbook:936 +#. Tag: programlisting +#: query_hql.xml:936 +#, no-c-format msgid "" - "<![CDATA[select usr.id, usr.name\n" - "from User as usr\n" - " left join usr.messages as msg\n" - "group by usr.id, usr.name\n" - "order by count(msg)]]>" +"<![CDATA[select usr.id, usr.name\n" +"from User as usr\n" +" left join usr.messages as msg\n" +"group by usr.id, usr.name\n" +"order by count(msg)]]>" msgstr "" -#: index.docbook:938 -msgid "If your database supports subselects, you can place a condition upon selection size in the where clause of your query:" +#. Tag: para +#: query_hql.xml:938 +#, no-c-format +msgid "" +"If your database supports subselects, you can place a condition upon " +"selection size in the where clause of your query:" msgstr "" +"Se seu banco de dados suporta subselects, pode-se colocar uma condição sobre " +"tamanho de seleção na cláusula where da sua query:" -#: index.docbook:943 +#. Tag: programlisting +#: query_hql.xml:943 +#, no-c-format msgid "<![CDATA[from User usr where size(usr.messages) >= 1]]>" msgstr "" -#: index.docbook:945 +#. Tag: para +#: query_hql.xml:945 +#, no-c-format msgid "If your database doesn't support subselects, use the following query:" -msgstr "" +msgstr "Se seu banco de dados não suporta subselects, use a query a seguir:" -#: index.docbook:949 +#. Tag: programlisting +#: query_hql.xml:949 +#, no-c-format msgid "" - "<![CDATA[select usr.id, usr.name\n" - "from User usr.name\n" - " join usr.messages msg\n" - "group by usr.id, usr.name\n" - "having count(msg) >= 1]]>" +"<![CDATA[select usr.id, usr.name\n" +"from User usr.name\n" +" join usr.messages msg\n" +"group by usr.id, usr.name\n" +"having count(msg) >= 1]]>" msgstr "" -#: index.docbook:951 -msgid "As this solution can't return a <literal>User</literal> with zero messages because of the inner join, the following form is also useful:" +#. Tag: para +#: query_hql.xml:951 +#, no-c-format +msgid "" +"As this solution can't return a <literal>User</literal> with zero messages " +"because of the inner join, the following form is also useful:" msgstr "" +"Com essa solução não se pode retornar um <literal>User</" +"literal><literal>com</literal> sem nenhuma menssagem, por causa do \"inner " +"join\", a forma a seguir também é útil." -#: index.docbook:956 +#. Tag: programlisting +#: query_hql.xml:956 +#, no-c-format msgid "" - "<![CDATA[select usr.id, usr.name\n" - "from User as usr\n" - " left join usr.messages as msg\n" - "group by usr.id, usr.name\n" - "having count(msg) = 0]]>" +"<![CDATA[select usr.id, usr.name\n" +"from User as usr\n" +" left join usr.messages as msg\n" +"group by usr.id, usr.name\n" +"having count(msg) = 0]]>" msgstr "" -#: index.docbook:958 +#. Tag: para +#: query_hql.xml:958 +#, no-c-format msgid "Properties of a JavaBean can be bound to named query parameters:" msgstr "" +"As propriedades de um JavaBean podem ser limitadas à parâmetros nomeados da " +"query:" -#: index.docbook:962 +#. Tag: programlisting +#: query_hql.xml:962 +#, no-c-format msgid "" - "<![CDATA[Query q = s.createQuery(\"from foo Foo as foo where foo.name=:name and foo.size=:size\");\n" - "q.setProperties(fooBean); // fooBean has getName() and getSize()\n" - "List foos = q.list();]]>" +"<![CDATA[Query q = s.createQuery(\"from foo Foo as foo where foo.name=:name " +"and foo.size=:size\");\n" +"q.setProperties(fooBean); // fooBean has getName() and getSize()\n" +"List foos = q.list();]]>" msgstr "" -#: index.docbook:964 -msgid "Collections are pageable by using the <literal>Query</literal> interface with a filter:" +#. Tag: para +#: query_hql.xml:964 +#, no-c-format +msgid "" +"Collections are pageable by using the <literal>Query</literal> interface " +"with a filter:" msgstr "" +"As Collections são paginaveis, usando a interface <literal>Query</" +"literal><literal>com</literal> um filtro:" -#: index.docbook:968 +#. Tag: programlisting +#: query_hql.xml:968 +#, no-c-format msgid "" - "<![CDATA[Query q = s.createFilter( collection, \"\" ); // the trivial filter\n" - "q.setMaxResults(PAGE_SIZE);\n" - "q.setFirstResult(PAGE_SIZE * pageNumber);\n" - "List page = q.list();]]>" +"<![CDATA[Query q = s.createFilter( collection, \"\" ); // the trivial " +"filter\n" +"q.setMaxResults(PAGE_SIZE);\n" +"q.setFirstResult(PAGE_SIZE * pageNumber);\n" +"List page = q.list();]]>" msgstr "" -#: index.docbook:970 +#. Tag: para +#: query_hql.xml:970 +#, no-c-format msgid "Collection elements may be ordered or grouped using a query filter:" msgstr "" +"Os elementos da Collection podem ser ordenados ou agrupados usando um filtro " +"de query:" -#: index.docbook:974 +#. Tag: programlisting +#: query_hql.xml:974 +#, no-c-format msgid "" - "<![CDATA[Collection orderedCollection = s.filter( collection, \"order by this.amount\" );\n" - "Collection counts = s.filter( collection, \"select this.type, count(this) group by this.type\" );]]>" +"<![CDATA[Collection orderedCollection = s.filter( collection, \"order by " +"this.amount\" );\n" +"Collection counts = s.filter( collection, \"select this.type, count(this) " +"group by this.type\" );]]>" msgstr "" -#: index.docbook:976 +#. Tag: para +#: query_hql.xml:976 +#, no-c-format msgid "You can find the size of a collection without initializing it:" -msgstr "" +msgstr "Pode-se achar o tamanho de uma Collection sem inicializa-la:" -#: index.docbook:980 -msgid "<![CDATA[( (Integer) session.createQuery(\"select count(*) from ....\").iterate().next() ).intValue();]]>" +#. Tag: programlisting +#: query_hql.xml:980 +#, no-c-format +msgid "" +"<![CDATA[( (Integer) session.createQuery(\"select count(*) from ....\")." +"iterate().next() ).intValue();]]>" msgstr "" -#: index.docbook:985 +#. Tag: title +#: query_hql.xml:985 +#, no-c-format msgid "Components" -msgstr "" +msgstr "translator-credits" -#: index.docbook:987 -msgid "Components might be used in just about every way that simple value types can be used in HQL queries. They can appear in the <literal>select</literal> clause:" +#. Tag: para +#: query_hql.xml:987 +#, no-c-format +msgid "" +"Components might be used in just about every way that simple value types can " +"be used in HQL queries. They can appear in the <literal>select</literal> " +"clause:" msgstr "" -#: index.docbook:992, index.docbook:1038 +#. Tag: programlisting +#: query_hql.xml:992 query_hql.xml:1038 +#, no-c-format msgid "<![CDATA[select p.name from from Person p]]>" msgstr "" -#: index.docbook:993 +#. Tag: programlisting +#: query_hql.xml:993 +#, no-c-format msgid "<![CDATA[select p.name.first from from Person p]]>" msgstr "" -#: index.docbook:995 -msgid "where the Person's name property is a component. Components can also be used in the <literal>where</literal> clause:" +#. Tag: para +#: query_hql.xml:995 +#, no-c-format +msgid "" +"where the Person's name property is a component. Components can also be used " +"in the <literal>where</literal> clause:" msgstr "" -#: index.docbook:1000 +#. Tag: programlisting +#: query_hql.xml:1000 +#, no-c-format msgid "<![CDATA[from from Person p where p.name = :name]]>" msgstr "" -#: index.docbook:1001 +#. Tag: programlisting +#: query_hql.xml:1001 +#, no-c-format msgid "<![CDATA[from from Person p where p.name.first = :firstName]]>" msgstr "" -#: index.docbook:1003 +#. Tag: para +#: query_hql.xml:1003 +#, no-c-format msgid "Components can also be used in the <literal>order by</literal> clause:" msgstr "" -#: index.docbook:1007 +#. Tag: programlisting +#: query_hql.xml:1007 +#, no-c-format msgid "<![CDATA[from from Person p order by p.name]]>" msgstr "" -#: index.docbook:1008 +#. Tag: programlisting +#: query_hql.xml:1008 +#, no-c-format msgid "<![CDATA[from from Person p order by p.name.first]]>" msgstr "" -#: index.docbook:1010 -msgid "Another common use of components is in <xref linkend=\"queryhql-tuple\"/>row value constructors." +#. Tag: para +#: query_hql.xml:1010 +#, no-c-format +msgid "" +"Another common use of components is in <link linkend=\"queryhql-tuple\">row " +"value constructors</link>." msgstr "" -#: index.docbook:1016 +#. Tag: title +#: query_hql.xml:1016 +#, no-c-format msgid "Row value constructor syntax" msgstr "" -#: index.docbook:1018 -msgid "HQL supports the use of ANSI SQL <literal>row value constructor</literal> syntax (sometimes called <literal>tuple</literal> syntax), even though the underlying database may not support that notion. Here we are generally referring to multi-valued comparisons, typically associated with components. Consider an entity Person which defines a name component:" +#. Tag: para +#: query_hql.xml:1018 +#, no-c-format +msgid "" +"HQL supports the use of ANSI SQL <literal>row value constructor</literal> " +"syntax (sometimes called <literal>tuple</literal> syntax), even though the " +"underlying database may not support that notion. Here we are generally " +"referring to multi-valued comparisons, typically associated with components. " +"Consider an entity Person which defines a name component:" msgstr "" -#: index.docbook:1025 -msgid "<![CDATA[from Person p where p.name.first='John' and p.name.last='Jingleheimer-Schmidt']]>" +#. Tag: programlisting +#: query_hql.xml:1025 +#, no-c-format +msgid "" +"<![CDATA[from Person p where p.name.first='John' and p.name." +"last='Jingleheimer-Schmidt']]>" msgstr "" -#: index.docbook:1027 -msgid "That's valid syntax, although a little verbose. It be nice to make this a bit more concise and use <literal>row value constructor</literal> syntax:" +#. Tag: para +#: query_hql.xml:1027 +#, no-c-format +msgid "" +"That's valid syntax, although a little verbose. It be nice to make this a " +"bit more concise and use <literal>row value constructor</literal> syntax:" msgstr "" -#: index.docbook:1032 +#. Tag: programlisting +#: query_hql.xml:1032 +#, no-c-format msgid "<![CDATA[from Person p where p.name=('John', 'Jingleheimer-Schmidt')]]>" msgstr "" -#: index.docbook:1034 -msgid "It can also be useful to specify this in the <literal>select</literal> clause:" +#. Tag: para +#: query_hql.xml:1034 +#, no-c-format +msgid "" +"It can also be useful to specify this in the <literal>select</literal> " +"clause:" msgstr "" -#: index.docbook:1040 -msgid "Another time using <literal>row value constructor</literal> syntax can be beneficial is when using subqueries needing to compare against multiple values:" +#. Tag: para +#: query_hql.xml:1040 +#, no-c-format +msgid "" +"Another time using <literal>row value constructor</literal> syntax can be " +"beneficial is when using subqueries needing to compare against multiple " +"values:" msgstr "" -#: index.docbook:1045 +#. Tag: programlisting +#: query_hql.xml:1045 +#, no-c-format msgid "" - "<![CDATA[from Cat as cat\n" - "where not ( cat.name, cat.color ) in (\n" - " select cat.name, cat.color from DomesticCat cat\n" - ")]]>" +"<![CDATA[from Cat as cat\n" +"where not ( cat.name, cat.color ) in (\n" +" select cat.name, cat.color from DomesticCat cat\n" +")]]>" msgstr "" -#: index.docbook:1047 -msgid "One thing to consider when deciding if you want to use this syntax is that the query will be dependent upon the ordering of the component sub-properties in the metadata." +#. Tag: para +#: query_hql.xml:1047 +#, no-c-format +msgid "" +"One thing to consider when deciding if you want to use this syntax is that " +"the query will be dependent upon the ordering of the component sub-" +"properties in the metadata." msgstr "" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "" - Modified: core/trunk/documentation/manual/translations/pt-BR/content/query_sql.po =================================================================== --- core/trunk/documentation/manual/translations/pt-BR/content/query_sql.po 2007-10-25 22:34:46 UTC (rev 14134) +++ core/trunk/documentation/manual/translations/pt-BR/content/query_sql.po 2007-10-26 00:46:38 UTC (rev 14135) @@ -1,818 +1,1485 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: query_sql.xml:5 +#, no-c-format msgid "Native SQL" -msgstr "" +msgstr "Native SQL" -#: index.docbook:7 -msgid "You may also express queries in the native SQL dialect of your database. This is useful if you want to utilize database specific features such as query hints or the <literal>CONNECT</literal> keyword in Oracle. It also provides a clean migration path from a direct SQL/JDBC based application to Hibernate." +#. Tag: para +#: query_sql.xml:7 +#, no-c-format +msgid "" +"You may also express queries in the native SQL dialect of your database. " +"This is useful if you want to utilize database specific features such as " +"query hints or the <literal>CONNECT</literal> keyword in Oracle. It also " +"provides a clean migration path from a direct SQL/JDBC based application to " +"Hibernate." msgstr "" +"You may also express queries in the native SQL dialect of your database. " +"This is useful if you want to utilize database specific features such as " +"query hints or the <literal>CONNECT</literal> keyword in Oracle. It also " +"provides a clean migration path from a direct SQL/JDBC based application to " +"Hibernate." -#: index.docbook:13 -msgid "Hibernate3 allows you to specify handwritten SQL (including stored procedures) for all create, update, delete, and load operations." +#. Tag: para +#: query_sql.xml:13 +#, no-c-format +msgid "" +"Hibernate3 allows you to specify handwritten SQL (including stored " +"procedures) for all create, update, delete, and load operations." msgstr "" +"Hibernate3 allows you to specify handwritten SQL (including stored " +"procedures) for all create, update, delete, and load operations." -#: index.docbook:17 +#. Tag: title +#: query_sql.xml:17 +#, no-c-format msgid "Using a <literal>SQLQuery</literal>" -msgstr "" +msgstr "Using a <literal>SQLQuery</literal>" -#: index.docbook:19 -msgid "Execution of native SQL queries is controlled via the <literal>SQLQuery</literal> interface, which is obtained by calling <literal>Session.createSQLQuery()</literal>. The following describes how to use this API for querying." +#. Tag: para +#: query_sql.xml:19 +#, no-c-format +msgid "" +"Execution of native SQL queries is controlled via the <literal>SQLQuery</" +"literal> interface, which is obtained by calling <literal>Session." +"createSQLQuery()</literal>. The following describes how to use this API for " +"querying." msgstr "" +"Execution of native SQL queries is controlled via the <literal>SQLQuery</" +"literal> interface, which is obtained by calling <literal>Session." +"createSQLQuery()</literal>. The following describes how to use this API for " +"querying." -#: index.docbook:25 +#. Tag: title +#: query_sql.xml:25 +#, no-c-format msgid "Scalar queries" -msgstr "" +msgstr "Scalar queries" -#: index.docbook:27 +#. Tag: para +#: query_sql.xml:27 +#, no-c-format msgid "The most basic SQL query is to get a list of scalars (values)." -msgstr "" +msgstr "The most basic SQL query is to get a list of scalars (values)." -#: index.docbook:30 +#. Tag: programlisting +#: query_sql.xml:30 +#, no-c-format msgid "" - "<![CDATA[sess.createSQLQuery(\"SELECT * FROM CATS\").list();\n" - "sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE FROM CATS\").list();\n" - "]]>" +"<![CDATA[sess.createSQLQuery(\"SELECT * FROM CATS\").list();\n" +"sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE FROM CATS\").list();\n" +"]]>" msgstr "" -#: index.docbook:32 -msgid "These will both return a List of Object arrays (Object[]) with scalar values for each column in the CATS table. Hibernate will use ResultSetMetadata to deduce the actual order and types of the returned scalar values." +#. Tag: para +#: query_sql.xml:32 +#, no-c-format +msgid "" +"These will both return a List of Object arrays (Object[]) with scalar values " +"for each column in the CATS table. Hibernate will use ResultSetMetadata to " +"deduce the actual order and types of the returned scalar values." msgstr "" +"These will both return a List of Object arrays (Object[]) with scalar values " +"for each column in the CATS table. Hibernate will use ResultSetMetadata to " +"deduce the actual order and types of the returned scalar values." -#: index.docbook:37 -msgid "To avoid the overhead of using <literal>ResultSetMetadata</literal> or simply to be more explicit in what is returned one can use <literal>addScalar()</literal>." +#. Tag: para +#: query_sql.xml:37 +#, no-c-format +msgid "" +"To avoid the overhead of using <literal>ResultSetMetadata</literal> or " +"simply to be more explicit in what is returned one can use <literal>addScalar" +"()</literal>." msgstr "" +"To avoid the overhead of using <literal>ResultSetMetadata</literal> or " +"simply to be more explicit in what is returned one can use <literal>addScalar" +"()</literal>." -#: index.docbook:41 +#. Tag: programlisting +#: query_sql.xml:41 +#, no-c-format msgid "" - "<![CDATA[sess.createSQLQuery(\"SELECT * FROM CATS\")\n" - " .addScalar(\"ID\", Hibernate.LONG)\n" - " .addScalar(\"NAME\", Hibernate.STRING)\n" - " .addScalar(\"BIRTHDATE\", Hibernate.DATE)\n" - "]]>" +"<![CDATA[sess.createSQLQuery(\"SELECT * FROM CATS\")\n" +" .addScalar(\"ID\", Hibernate.LONG)\n" +" .addScalar(\"NAME\", Hibernate.STRING)\n" +" .addScalar(\"BIRTHDATE\", Hibernate.DATE)\n" +"]]>" msgstr "" -#: index.docbook:43, index.docbook:89, index.docbook:170, index.docbook:321 +#. Tag: para +#: query_sql.xml:43 query_sql.xml:89 query_sql.xml:170 query_sql.xml:321 +#, no-c-format msgid "This query specified:" -msgstr "" +msgstr "This query specified:" -#: index.docbook:47, index.docbook:93, index.docbook:325 +#. Tag: para +#: query_sql.xml:47 query_sql.xml:93 query_sql.xml:325 +#, no-c-format msgid "the SQL query string" -msgstr "" +msgstr "the SQL query string" -#: index.docbook:51 +#. Tag: para +#: query_sql.xml:51 +#, no-c-format msgid "the columns and types to return" -msgstr "" +msgstr "the columns and types to return" -#: index.docbook:55 -msgid "This will still return Object arrays, but now it will not use <literal>ResultSetMetdata</literal> but will instead explicitly get the ID, NAME and BIRTHDATE column as respectively a Long, String and a Short from the underlying resultset. This also means that only these three columns will be returned, even though the query is using <literal>*</literal> and could return more than the three listed columns." +#. Tag: para +#: query_sql.xml:55 +#, no-c-format +msgid "" +"This will still return Object arrays, but now it will not use " +"<literal>ResultSetMetdata</literal> but will instead explicitly get the ID, " +"NAME and BIRTHDATE column as respectively a Long, String and a Short from " +"the underlying resultset. This also means that only these three columns will " +"be returned, even though the query is using <literal>*</literal> and could " +"return more than the three listed columns." msgstr "" +"This will still return Object arrays, but now it will not use " +"<literal>ResultSetMetdata</literal> but will instead explicitly get the ID, " +"NAME and BIRTHDATE column as respectively a Long, String and a Short from " +"the underlying resultset. This also means that only these three columns will " +"be returned, even though the query is using <literal>*</literal> and could " +"return more than the three listed columns." -#: index.docbook:63 -msgid "It is possible to leave out the type information for all or some of the scalars." +#. Tag: para +#: query_sql.xml:63 +#, no-c-format +msgid "" +"It is possible to leave out the type information for all or some of the " +"scalars." msgstr "" +"It is possible to leave out the type information for all or some of the " +"scalars." -#: index.docbook:66 +#. Tag: programlisting +#: query_sql.xml:66 +#, no-c-format msgid "" - "<![CDATA[sess.createSQLQuery(\"SELECT * FROM CATS\")\n" - " .addScalar(\"ID\", Hibernate.LONG)\n" - " .addScalar(\"NAME\")\n" - " .addScalar(\"BIRTHDATE\")\n" - "]]>" +"<![CDATA[sess.createSQLQuery(\"SELECT * FROM CATS\")\n" +" .addScalar(\"ID\", Hibernate.LONG)\n" +" .addScalar(\"NAME\")\n" +" .addScalar(\"BIRTHDATE\")\n" +"]]>" msgstr "" -#: index.docbook:68 -msgid "This is essentially the same query as before, but now <literal>ResultSetMetaData</literal> is used to decide the type of NAME and BIRTHDATE where as the type of ID is explicitly specified." +#. Tag: para +#: query_sql.xml:68 +#, no-c-format +msgid "" +"This is essentially the same query as before, but now " +"<literal>ResultSetMetaData</literal> is used to decide the type of NAME and " +"BIRTHDATE where as the type of ID is explicitly specified." msgstr "" +"This is essentially the same query as before, but now " +"<literal>ResultSetMetaData</literal> is used to decide the type of NAME and " +"BIRTHDATE where as the type of ID is explicitly specified." -#: index.docbook:72 -msgid "How the java.sql.Types returned from ResultSetMetaData is mapped to Hibernate types is controlled by the Dialect. If a specific type is not mapped or does not result in the expected type it is possible to customize it via calls to <literal>registerHibernateType</literal> in the Dialect." +#. Tag: para +#: query_sql.xml:72 +#, no-c-format +msgid "" +"How the java.sql.Types returned from ResultSetMetaData is mapped to " +"Hibernate types is controlled by the Dialect. If a specific type is not " +"mapped or does not result in the expected type it is possible to customize " +"it via calls to <literal>registerHibernateType</literal> in the Dialect." msgstr "" +"How the java.sql.Types returned from ResultSetMetaData is mapped to " +"Hibernate types is controlled by the Dialect. If a specific type is not " +"mapped or does not result in the expected type it is possible to customize " +"it via calls to <literal>registerHibernateType</literal> in the Dialect." -#: index.docbook:80 +#. Tag: title +#: query_sql.xml:80 +#, no-c-format msgid "Entity queries" -msgstr "" +msgstr "Entity queries" -#: index.docbook:82 -msgid "The above queries were all about returning scalar values, basically returning the \"raw\" values from the resultset. The following shows how to get entity objects from a native sql query via <literal>addEntity()</literal>." +#. Tag: para +#: query_sql.xml:82 +#, no-c-format +msgid "" +"The above queries were all about returning scalar values, basically " +"returning the \"raw\" values from the resultset. The following shows how to " +"get entity objects from a native sql query via <literal>addEntity()</" +"literal>." msgstr "" +"The above queries were all about returning scalar values, basically " +"returning the \"raw\" values from the resultset. The following shows how to " +"get entity objects from a native sql query via <literal>addEntity()</" +"literal>." -#: index.docbook:87 +#. Tag: programlisting +#: query_sql.xml:87 +#, no-c-format msgid "" - "<![CDATA[sess.createSQLQuery(\"SELECT * FROM CATS\").addEntity(Cat.class);\n" - "sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE FROM CATS\").addEntity(Cat.class);\n" - "]]>" +"<![CDATA[sess.createSQLQuery(\"SELECT * FROM CATS\").addEntity(Cat.class);\n" +"sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE FROM CATS\").addEntity(Cat." +"class);\n" +"]]>" msgstr "" -#: index.docbook:97 +#. Tag: para +#: query_sql.xml:97 +#, no-c-format msgid "the entity returned by the query" -msgstr "" +msgstr "the entity returned by the query" -#: index.docbook:101 -msgid "Assuming that Cat is mapped as a class with the columns ID, NAME and BIRTHDATE the above queries will both return a List where each element is a Cat entity." +#. Tag: para +#: query_sql.xml:101 +#, no-c-format +msgid "" +"Assuming that Cat is mapped as a class with the columns ID, NAME and " +"BIRTHDATE the above queries will both return a List where each element is a " +"Cat entity." msgstr "" +"Assuming that Cat is mapped as a class with the columns ID, NAME and " +"BIRTHDATE the above queries will both return a List where each element is a " +"Cat entity." -#: index.docbook:105 -msgid "If the entity is mapped with a <literal>many-to-one</literal> to another entity it is required to also return this when performing the native query, otherwise a database specific \"column not found\" error will occur. The additional columns will automatically be returned when using the * notation, but we prefer to be explicit as in the following example for a <literal>many-to-one</literal> to a <literal>Dog</literal>:" +#. Tag: para +#: query_sql.xml:105 +#, no-c-format +msgid "" +"If the entity is mapped with a <literal>many-to-one</literal> to another " +"entity it is required to also return this when performing the native query, " +"otherwise a database specific \"column not found\" error will occur. The " +"additional columns will automatically be returned when using the * notation, " +"but we prefer to be explicit as in the following example for a <literal>many-" +"to-one</literal> to a <literal>Dog</literal>:" msgstr "" +"If the entity is mapped with a <literal>many-to-one</literal> to another " +"entity it is required to also return this when performing the native query, " +"otherwise a database specific \"column not found\" error will occur. The " +"additional columns will automatically be returned when using the * notation, " +"but we prefer to be explicit as in the following example for a <literal>many-" +"to-one</literal> to a <literal>Dog</literal>:" -#: index.docbook:113 +#. Tag: programlisting +#: query_sql.xml:113 +#, no-c-format msgid "" - "<![CDATA[sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE, DOG_ID FROM CATS\").addEntity(Cat.class);\n" - "]]>" +"<![CDATA[sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE, DOG_ID FROM CATS" +"\").addEntity(Cat.class);\n" +"]]>" msgstr "" -#: index.docbook:115 +#. Tag: para +#: query_sql.xml:115 +#, no-c-format msgid "This will allow cat.getDog() to function properly." -msgstr "" +msgstr "This will allow cat.getDog() to function properly." -#: index.docbook:119 +#. Tag: title +#: query_sql.xml:119 +#, no-c-format msgid "Handling associations and collections" -msgstr "" +msgstr "Handling associations and collections" -#: index.docbook:121 -msgid "It is possible to eagerly join in the <literal>Dog</literal> to avoid the possible extra roundtrip for initializing the proxy. This is done via the <literal>addJoin()</literal> method, which allows you to join in an association or collection." +#. Tag: para +#: query_sql.xml:121 +#, no-c-format +msgid "" +"It is possible to eagerly join in the <literal>Dog</literal> to avoid the " +"possible extra roundtrip for initializing the proxy. This is done via the " +"<literal>addJoin()</literal> method, which allows you to join in an " +"association or collection." msgstr "" +"It is possible to eagerly join in the <literal>Dog</literal> to avoid the " +"possible extra roundtrip for initializing the proxy. This is done via the " +"<literal>addJoin()</literal> method, which allows you to join in an " +"association or collection." -#: index.docbook:126 +#. Tag: programlisting +#: query_sql.xml:126 +#, no-c-format msgid "" - "<![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\")\n" - " .addEntity(\"cat\", Cat.class)\n" - " .addJoin(\"cat.dog\");\n" - "]]>" +"<![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\")\n" +" .addEntity(\"cat\", Cat.class)\n" +" .addJoin(\"cat.dog\");\n" +"]]>" msgstr "" -#: index.docbook:128 -msgid "In this example the returned <literal>Cat</literal>'s will have their <literal>dog</literal> property fully initialized without any extra roundtrip to the database. Notice that we added a alias name (\"cat\") to be able to specify the target property path of the join. It is possible to do the same eager joining for collections, e.g. if the <literal>Cat</literal> had a one-to-many to <literal>Dog</literal> instead." +#. Tag: para +#: query_sql.xml:128 +#, no-c-format +msgid "" +"In this example the returned <literal>Cat</literal>'s will have their " +"<literal>dog</literal> property fully initialized without any extra " +"roundtrip to the database. Notice that we added a alias name (\"cat\") to be " +"able to specify the target property path of the join. It is possible to do " +"the same eager joining for collections, e.g. if the <literal>Cat</literal> " +"had a one-to-many to <literal>Dog</literal> instead." msgstr "" +"In this example the returned <literal>Cat</literal>'s will have their " +"<literal>dog</literal> property fully initialized without any extra " +"roundtrip to the database. Notice that we added a alias name (\"cat\") to be " +"able to specify the target property path of the join. It is possible to do " +"the same eager joining for collections, e.g. if the <literal>Cat</literal> " +"had a one-to-many to <literal>Dog</literal> instead." -#: index.docbook:136 +#. Tag: programlisting +#: query_sql.xml:136 +#, no-c-format msgid "" - "<![CDATA[sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE, D_ID, D_NAME, CAT_ID FROM CATS c, DOGS d WHERE c.ID = d.CAT_ID\")\n" - " .addEntity(\"cat\", Cat.class)\n" - " .addJoin(\"cat.dogs\");\n" - "]]>" +"<![CDATA[sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE, D_ID, D_NAME, " +"CAT_ID FROM CATS c, DOGS d WHERE c.ID = d.CAT_ID\")\n" +" .addEntity(\"cat\", Cat.class)\n" +" .addJoin(\"cat.dogs\");\n" +"]]>" msgstr "" -#: index.docbook:138 -msgid "At this stage we are reaching the limits of what is possible with native queries without starting to enhance the sql queries to make them usable in Hibernate; the problems starts to arise when returning multiple entities of the same type or when the default alias/column names are not enough." +#. Tag: para +#: query_sql.xml:138 +#, no-c-format +msgid "" +"At this stage we are reaching the limits of what is possible with native " +"queries without starting to enhance the sql queries to make them usable in " +"Hibernate; the problems starts to arise when returning multiple entities of " +"the same type or when the default alias/column names are not enough." msgstr "" +"At this stage we are reaching the limits of what is possible with native " +"queries without starting to enhance the sql queries to make them usable in " +"Hibernate; the problems starts to arise when returning multiple entities of " +"the same type or when the default alias/column names are not enough." -#: index.docbook:146 +#. Tag: title +#: query_sql.xml:146 +#, no-c-format msgid "Returning multiple entities" -msgstr "" +msgstr "Returning multiple entities" -#: index.docbook:148 -msgid "Until now the result set column names are assumed to be the same as the column names specified in the mapping document. This can be problematic for SQL queries which join multiple tables, since the same column names may appear in more than one table." +#. Tag: para +#: query_sql.xml:148 +#, no-c-format +msgid "" +"Until now the result set column names are assumed to be the same as the " +"column names specified in the mapping document. This can be problematic for " +"SQL queries which join multiple tables, since the same column names may " +"appear in more than one table." msgstr "" +"Until now the result set column names are assumed to be the same as the " +"column names specified in the mapping document. This can be problematic for " +"SQL queries which join multiple tables, since the same column names may " +"appear in more than one table." -#: index.docbook:153 -msgid "Column alias injection is needed in the following query (which most likely will fail):" +#. Tag: para +#: query_sql.xml:153 +#, no-c-format +msgid "" +"Column alias injection is needed in the following query (which most likely " +"will fail):" msgstr "" +"Column alias injection is needed in the following query (which most likely " +"will fail):" -#: index.docbook:156 +#. Tag: programlisting +#: query_sql.xml:156 +#, no-c-format msgid "" - "<![CDATA[sess.createSQLQuery(\"SELECT c.*, m.* FROM CATS c, CATS m WHERE c.MOTHER_ID = c.ID\")\n" - " .addEntity(\"cat\", Cat.class)\n" - " .addEntity(\"mother\", Cat.class)\n" - "]]>" +"<![CDATA[sess.createSQLQuery(\"SELECT c.*, m.* FROM CATS c, CATS m WHERE c." +"MOTHER_ID = c.ID\")\n" +" .addEntity(\"cat\", Cat.class)\n" +" .addEntity(\"mother\", Cat.class)\n" +"]]>" msgstr "" -#: index.docbook:158 -msgid "The intention for this query is to return two Cat instances per row, a cat and its mother. This will fail since there is a conflict of names since they are mapped to the same column names and on some databases the returned column aliases will most likely be on the form \"c.ID\", \"c.NAME\", etc. which are not equal to the columns specificed in the mappings (\"ID\" and \"NAME\")." +#. Tag: para +#: query_sql.xml:158 +#, no-c-format +msgid "" +"The intention for this query is to return two Cat instances per row, a cat " +"and its mother. This will fail since there is a conflict of names since they " +"are mapped to the same column names and on some databases the returned " +"column aliases will most likely be on the form \"c.ID\", \"c.NAME\", etc. " +"which are not equal to the columns specificed in the mappings (\"ID\" and " +"\"NAME\")." msgstr "" +"The intention for this query is to return two Cat instances per row, a cat " +"and its mother. This will fail since there is a conflict of names since they " +"are mapped to the same column names and on some databases the returned " +"column aliases will most likely be on the form \"c.ID\", \"c.NAME\", etc. " +"which are not equal to the columns specificed in the mappings (\"ID\" and " +"\"NAME\")." -#: index.docbook:165 +#. Tag: para +#: query_sql.xml:165 +#, no-c-format msgid "The following form is not vulnerable to column name duplication:" -msgstr "" +msgstr "The following form is not vulnerable to column name duplication:" -#: index.docbook:168 +#. Tag: programlisting +#: query_sql.xml:168 +#, no-c-format msgid "" - "<![CDATA[sess.createSQLQuery(\"SELECT {cat.*}, {mother.*} FROM CATS c, CATS m WHERE c.MOTHER_ID = c.ID\")\n" - " .addEntity(\"cat\", Cat.class)\n" - " .addEntity(\"mother\", Cat.class)\n" - "]]>" +"<![CDATA[sess.createSQLQuery(\"SELECT {cat.*}, {mother.*} FROM CATS c, CATS " +"m WHERE c.MOTHER_ID = c.ID\")\n" +" .addEntity(\"cat\", Cat.class)\n" +" .addEntity(\"mother\", Cat.class)\n" +"]]>" msgstr "" -#: index.docbook:174 -msgid "the SQL query string, with placeholders for Hibernate to inject column aliases" +#. Tag: para +#: query_sql.xml:174 +#, no-c-format +msgid "" +"the SQL query string, with placeholders for Hibernate to inject column " +"aliases" msgstr "" +"the SQL query string, with placeholders for Hibernate to inject column " +"aliases" -#: index.docbook:179 +#. Tag: para +#: query_sql.xml:179 +#, no-c-format msgid "the entities returned by the query" -msgstr "" +msgstr "the entities returned by the query" -#: index.docbook:183 -msgid "The {cat.*} and {mother.*} notation used above is a shorthand for \"all properties\". Alternatively, you may list the columns explicity, but even in this case we let Hibernate inject the SQL column aliases for each property. The placeholder for a column alias is just the property name qualified by the table alias. In the following example, we retrieve Cats and their mothers from a different table (cat_log) to the one declared in the mapping metadata. Notice that we may even use the property aliases in the where clause if we like." +#. Tag: para +#: query_sql.xml:183 +#, no-c-format +msgid "" +"The {cat.*} and {mother.*} notation used above is a shorthand for \"all " +"properties\". Alternatively, you may list the columns explicity, but even in " +"this case we let Hibernate inject the SQL column aliases for each property. " +"The placeholder for a column alias is just the property name qualified by " +"the table alias. In the following example, we retrieve Cats and their " +"mothers from a different table (cat_log) to the one declared in the mapping " +"metadata. Notice that we may even use the property aliases in the where " +"clause if we like." msgstr "" +"The {cat.*} and {mother.*} notation used above is a shorthand for \"all " +"properties\". Alternatively, you may list the columns explicity, but even in " +"this case we let Hibernate inject the SQL column aliases for each property. " +"The placeholder for a column alias is just the property name qualified by " +"the table alias. In the following example, we retrieve Cats and their " +"mothers from a different table (cat_log) to the one declared in the mapping " +"metadata. Notice that we may even use the property aliases in the where " +"clause if we like." -#: index.docbook:192 +#. Tag: programlisting +#: query_sql.xml:192 +#, no-c-format msgid "" - "<![CDATA[String sql = \"SELECT ID as {c.id}, NAME as {c.name}, \" + \n" - " \"BIRTHDATE as {c.birthDate}, MOTHER_ID as {c.mother}, {mother.*} \" +\n" - " \"FROM CAT_LOG c, CAT_LOG m WHERE {c.mother} = c.ID\";\n" - "\n" - "List loggedCats = sess.createSQLQuery(sql)\n" - " .addEntity(\"cat\", Cat.class)\n" - " .addEntity(\"mother\", Cat.class).list()\n" - "]]>" +"<![CDATA[String sql = \"SELECT ID as {c.id}, NAME as {c.name}, \" + \n" +" \"BIRTHDATE as {c.birthDate}, MOTHER_ID as {c.mother}, {mother.*} " +"\" +\n" +" \"FROM CAT_LOG c, CAT_LOG m WHERE {c.mother} = c.ID\";\n" +"\n" +"List loggedCats = sess.createSQLQuery(sql)\n" +" .addEntity(\"cat\", Cat.class)\n" +" .addEntity(\"mother\", Cat.class).list()\n" +"]]>" msgstr "" -#: index.docbook:195 +#. Tag: title +#: query_sql.xml:195 +#, no-c-format msgid "Alias and property references" -msgstr "" +msgstr "Alias and property references" -#: index.docbook:197 -msgid "For most cases the above alias injection is needed, but for queries relating to more complex mappings like composite properties, inheritance discriminators, collections etc. there are some specific aliases to use to allow Hibernate to inject the proper aliases." +#. Tag: para +#: query_sql.xml:197 +#, no-c-format +msgid "" +"For most cases the above alias injection is needed, but for queries relating " +"to more complex mappings like composite properties, inheritance " +"discriminators, collections etc. there are some specific aliases to use to " +"allow Hibernate to inject the proper aliases." msgstr "" +"For most cases the above alias injection is needed, but for queries relating " +"to more complex mappings like composite properties, inheritance " +"discriminators, collections etc. there are some specific aliases to use to " +"allow Hibernate to inject the proper aliases." -#: index.docbook:202 -msgid "The following table shows the different possibilities of using the alias injection. Note: the alias names in the result are examples, each alias will have a unique and probably different name when used." +#. Tag: para +#: query_sql.xml:202 +#, no-c-format +msgid "" +"The following table shows the different possibilities of using the alias " +"injection. Note: the alias names in the result are examples, each alias will " +"have a unique and probably different name when used." msgstr "" +"The following table shows the different possibilities of using the alias " +"injection. Note: the alias names in the result are examples, each alias will " +"have a unique and probably different name when used." -#: index.docbook:208 +#. Tag: title +#: query_sql.xml:208 +#, no-c-format msgid "Alias injection names" -msgstr "" +msgstr "Alias injection names" -#: index.docbook:219 +#. Tag: entry +#: query_sql.xml:219 +#, no-c-format msgid "Description" -msgstr "" +msgstr "Description" -#: index.docbook:221 +#. Tag: entry +#: query_sql.xml:221 +#, no-c-format msgid "Syntax" -msgstr "" +msgstr "Syntax" -#: index.docbook:223 +#. Tag: entry +#: query_sql.xml:223 +#, no-c-format msgid "Example" -msgstr "" +msgstr "Example" -#: index.docbook:229 +#. Tag: entry +#: query_sql.xml:229 +#, no-c-format msgid "A simple property" -msgstr "" +msgstr "A simple property" -#: index.docbook:231 +#. Tag: literal +#: query_sql.xml:231 +#, no-c-format msgid "{[aliasname].[propertyname]" -msgstr "" +msgstr "{[aliasname].[propertyname]" -#: index.docbook:233 +#. Tag: literal +#: query_sql.xml:233 +#, no-c-format msgid "A_NAME as {item.name}" -msgstr "" +msgstr "A_NAME as {item.name}" -#: index.docbook:237 +#. Tag: entry +#: query_sql.xml:237 +#, no-c-format msgid "A composite property" -msgstr "" +msgstr "A composite property" -#: index.docbook:239 +#. Tag: literal +#: query_sql.xml:239 +#, no-c-format msgid "{[aliasname].[componentname].[propertyname]}" -msgstr "" +msgstr "{[aliasname].[componentname].[propertyname]}" -#: index.docbook:241 +#. Tag: literal +#: query_sql.xml:241 +#, no-c-format msgid "CURRENCY as {item.amount.currency}, VALUE as {item.amount.value}" -msgstr "" +msgstr "CURRENCY as {item.amount.currency}, VALUE as {item.amount.value}" -#: index.docbook:246 +#. Tag: entry +#: query_sql.xml:246 +#, no-c-format msgid "Discriminator of an entity" -msgstr "" +msgstr "Discriminator of an entity" -#: index.docbook:248 +#. Tag: literal +#: query_sql.xml:248 +#, no-c-format msgid "{[aliasname].class}" -msgstr "" +msgstr "{[aliasname].class}" -#: index.docbook:250 +#. Tag: literal +#: query_sql.xml:250 +#, no-c-format msgid "DISC as {item.class}" -msgstr "" +msgstr "DISC as {item.class}" -#: index.docbook:254 +#. Tag: entry +#: query_sql.xml:254 +#, no-c-format msgid "All properties of an entity" -msgstr "" +msgstr "All properties of an entity" -#: index.docbook:256, index.docbook:304 +#. Tag: literal +#: query_sql.xml:256 query_sql.xml:304 +#, no-c-format msgid "{[aliasname].*}" -msgstr "" +msgstr "{[aliasname].*}" -#: index.docbook:258 +#. Tag: literal +#: query_sql.xml:258 +#, no-c-format msgid "{item.*}" -msgstr "" +msgstr "{item.*}" -#: index.docbook:262 +#. Tag: entry +#: query_sql.xml:262 +#, no-c-format msgid "A collection key" -msgstr "" +msgstr "A collection key" -#: index.docbook:264 +#. Tag: literal +#: query_sql.xml:264 +#, no-c-format msgid "{[aliasname].key}" -msgstr "" +msgstr "{[aliasname].key}" -#: index.docbook:266 +#. Tag: literal +#: query_sql.xml:266 +#, no-c-format msgid "ORGID as {coll.key}" -msgstr "" +msgstr "ORGID as {coll.key}" -#: index.docbook:270 +#. Tag: entry +#: query_sql.xml:270 +#, no-c-format msgid "The id of an collection" -msgstr "" +msgstr "The id of an collection" -#: index.docbook:272 +#. Tag: literal +#: query_sql.xml:272 +#, no-c-format msgid "{[aliasname].id}" -msgstr "" +msgstr "{[aliasname].id}" -#: index.docbook:274 +#. Tag: literal +#: query_sql.xml:274 +#, no-c-format msgid "EMPID as {coll.id}" -msgstr "" +msgstr "EMPID as {coll.id}" -#: index.docbook:278 +#. Tag: entry +#: query_sql.xml:278 +#, no-c-format msgid "The element of an collection" -msgstr "" +msgstr "The element of an collection" -#: index.docbook:280 +#. Tag: literal +#: query_sql.xml:280 +#, no-c-format msgid "{[aliasname].element}" -msgstr "" +msgstr "{[aliasname].element}" -#: index.docbook:282 +#. Tag: literal +#: query_sql.xml:282 +#, no-c-format msgid "XID as {coll.element}" -msgstr "" +msgstr "XID as {coll.element}" -#: index.docbook:286 +#. Tag: entry +#: query_sql.xml:286 +#, no-c-format msgid "roperty of the element in the collection" -msgstr "" +msgstr "roperty of the element in the collection" -#: index.docbook:288 +#. Tag: literal +#: query_sql.xml:288 +#, no-c-format msgid "{[aliasname].element.[propertyname]}" -msgstr "" +msgstr "{[aliasname].element.[propertyname]}" -#: index.docbook:290 +#. Tag: literal +#: query_sql.xml:290 +#, no-c-format msgid "NAME as {coll.element.name}" -msgstr "" +msgstr "NAME as {coll.element.name}" -#: index.docbook:294 +#. Tag: entry +#: query_sql.xml:294 +#, no-c-format msgid "All properties of the element in the collection" -msgstr "" +msgstr "All properties of the element in the collection" -#: index.docbook:296 +#. Tag: literal +#: query_sql.xml:296 +#, no-c-format msgid "{[aliasname].element.*}" -msgstr "" +msgstr "{[aliasname].element.*}" -#: index.docbook:298 +#. Tag: literal +#: query_sql.xml:298 +#, no-c-format msgid "{coll.element.*}" -msgstr "" +msgstr "{coll.element.*}" -#: index.docbook:302 +#. Tag: entry +#: query_sql.xml:302 +#, no-c-format msgid "All properties of the the collection" -msgstr "" +msgstr "All properties of the the collection" -#: index.docbook:306 +#. Tag: literal +#: query_sql.xml:306 +#, no-c-format msgid "{coll.*}" -msgstr "" +msgstr "{coll.*}" -#: index.docbook:315 +#. Tag: title +#: query_sql.xml:315 +#, no-c-format msgid "Returning non-managed entities" -msgstr "" +msgstr "Returning non-managed entities" -#: index.docbook:317 -msgid "It is possible to apply a ResultTransformer to native sql queries. Allowing it to e.g. return non-managed entities." +#. Tag: para +#: query_sql.xml:317 +#, no-c-format +msgid "" +"It is possible to apply a ResultTransformer to native sql queries. Allowing " +"it to e.g. return non-managed entities." msgstr "" +"It is possible to apply a ResultTransformer to native sql queries. Allowing " +"it to e.g. return non-managed entities." -#: index.docbook:319 +#. Tag: programlisting +#: query_sql.xml:319 +#, no-c-format msgid "" - "<![CDATA[sess.createSQLQuery(\"SELECT NAME, BIRTHDATE FROM CATS\")\n" - " .setResultTransformer(Transformers.aliasToBean(CatDTO.class))]]>" +"<![CDATA[sess.createSQLQuery(\"SELECT NAME, BIRTHDATE FROM CATS\")\n" +" .setResultTransformer(Transformers.aliasToBean(CatDTO.class))]]>" msgstr "" -#: index.docbook:329 +#. Tag: para +#: query_sql.xml:329 +#, no-c-format msgid "a result transformer" -msgstr "" +msgstr "a result transformer" -#: index.docbook:333 -msgid "The above query will return a list of <literal>CatDTO</literal> which has been instantiated and injected the values of NAME and BIRTHNAME into its corresponding properties or fields." +#. Tag: para +#: query_sql.xml:333 +#, no-c-format +msgid "" +"The above query will return a list of <literal>CatDTO</literal> which has " +"been instantiated and injected the values of NAME and BIRTHNAME into its " +"corresponding properties or fields." msgstr "" +"The above query will return a list of <literal>CatDTO</literal> which has " +"been instantiated and injected the values of NAME and BIRTHNAME into its " +"corresponding properties or fields." -#: index.docbook:340 +#. Tag: title +#: query_sql.xml:340 +#, no-c-format msgid "Handling inheritance" -msgstr "" +msgstr "Handling inheritance" -#: index.docbook:342 -msgid "Native sql queries which query for entities that is mapped as part of an inheritance must include all properties for the baseclass and all it subclasses." +#. Tag: para +#: query_sql.xml:342 +#, no-c-format +msgid "" +"Native sql queries which query for entities that is mapped as part of an " +"inheritance must include all properties for the baseclass and all it " +"subclasses." msgstr "" +"Native sql queries which query for entities that is mapped as part of an " +"inheritance must include all properties for the baseclass and all it " +"subclasses." -#: index.docbook:348 +#. Tag: title +#: query_sql.xml:348 +#, no-c-format msgid "Parameters" -msgstr "" +msgstr "Parameters" -#: index.docbook:350 +#. Tag: para +#: query_sql.xml:350 +#, no-c-format msgid "Native sql queries support positional as well as named parameters:" -msgstr "" +msgstr "Native sql queries support positional as well as named parameters:" -#: index.docbook:353 +#. Tag: programlisting +#: query_sql.xml:353 +#, no-c-format msgid "" - "<![CDATA[Query query = sess.createSQLQuery(\"SELECT * FROM CATS WHERE NAME like ?\").addEntity(Cat.class);\n" - "List pusList = query.setString(0, \"Pus%\").list();\n" - " \n" - "query = sess.createSQLQuery(\"SELECT * FROM CATS WHERE NAME like :name\").addEntity(Cat.class);\n" - "List pusList = query.setString(\"name\", \"Pus%\").list(); ]]>" +"<![CDATA[Query query = sess.createSQLQuery(\"SELECT * FROM CATS WHERE NAME " +"like ?\").addEntity(Cat.class);\n" +"List pusList = query.setString(0, \"Pus%\").list();\n" +" \n" +"query = sess.createSQLQuery(\"SELECT * FROM CATS WHERE NAME like :name\")." +"addEntity(Cat.class);\n" +"List pusList = query.setString(\"name\", \"Pus%\").list(); ]]>" msgstr "" -#: index.docbook:361 +#. Tag: title +#: query_sql.xml:361 +#, no-c-format msgid "Named SQL queries" -msgstr "" +msgstr "Named SQL queries" -#: index.docbook:363 -msgid "Named SQL queries may be defined in the mapping document and called in exactly the same way as a named HQL query. In this case, we do <emphasis>not</emphasis> need to call <literal>addEntity()</literal>." +#. Tag: para +#: query_sql.xml:363 +#, no-c-format +msgid "" +"Named SQL queries may be defined in the mapping document and called in " +"exactly the same way as a named HQL query. In this case, we do " +"<emphasis>not</emphasis> need to call <literal>addEntity()</literal>." msgstr "" +"Named SQL queries may be defined in the mapping document and called in " +"exactly the same way as a named HQL query. In this case, we do " +"<emphasis>not</emphasis> need to call <literal>addEntity()</literal>." -#: index.docbook:368 +#. Tag: programlisting +#: query_sql.xml:368 +#, no-c-format msgid "" - "<![CDATA[<sql-query name=\"persons\">\n" - " <return alias=\"person\" class=\"eg.Person\"/>\n" - " SELECT person.NAME AS {person.name},\n" - " person.AGE AS {person.age},\n" - " person.SEX AS {person.sex}\n" - " FROM PERSON person\n" - " WHERE person.NAME LIKE :namePattern\n" - "</sql-query>]]>" +"<![CDATA[<sql-query name=\"persons\">\n" +" <return alias=\"person\" class=\"eg.Person\"/>\n" +" SELECT person.NAME AS {person.name},\n" +" person.AGE AS {person.age},\n" +" person.SEX AS {person.sex}\n" +" FROM PERSON person\n" +" WHERE person.NAME LIKE :namePattern\n" +"</sql-query>]]>" msgstr "" -#: index.docbook:370 +#. Tag: programlisting +#: query_sql.xml:370 +#, no-c-format msgid "" - "<![CDATA[List people = sess.getNamedQuery(\"persons\")\n" - " .setString(\"namePattern\", namePattern)\n" - " .setMaxResults(50)\n" - " .list();]]>" +"<![CDATA[List people = sess.getNamedQuery(\"persons\")\n" +" .setString(\"namePattern\", namePattern)\n" +" .setMaxResults(50)\n" +" .list();]]>" msgstr "" -#: index.docbook:372 -msgid "The <literal><return-join></literal> and <literal><load-collection></literal> elements are used to join associations and define queries which initialize collections, respectively." +#. Tag: para +#: query_sql.xml:372 +#, no-c-format +msgid "" +"The <literal><return-join></literal> and <literal><load-" +"collection></literal> elements are used to join associations and define " +"queries which initialize collections, respectively." msgstr "" +"The <literal><return-join></literal> and <literal><load-" +"collection></literal> elements are used to join associations and define " +"queries which initialize collections, respectively." -#: index.docbook:377 +#. Tag: programlisting +#: query_sql.xml:377 +#, no-c-format msgid "" - "<![CDATA[<sql-query name=\"personsWith\">\n" - " <return alias=\"person\" class=\"eg.Person\"/>\n" - " <return-join alias=\"address\" property=\"person.mailingAddress\"/>\n" - " SELECT person.NAME AS {person.name},\n" - " person.AGE AS {person.age},\n" - " person.SEX AS {person.sex},\n" - " address.STREET AS {address.street},\n" - " address.CITY AS {address.city},\n" - " address.STATE AS {address.state},\n" - " address.ZIP AS {address.zip}\n" - " FROM PERSON person\n" - " JOIN ADDRESS address\n" - " ON person.ID = address.PERSON_ID AND address.TYPE='MAILING'\n" - " WHERE person.NAME LIKE :namePattern\n" - "</sql-query>]]>" +"<![CDATA[<sql-query name=\"personsWith\">\n" +" <return alias=\"person\" class=\"eg.Person\"/>\n" +" <return-join alias=\"address\" property=\"person.mailingAddress\"/>\n" +" SELECT person.NAME AS {person.name},\n" +" person.AGE AS {person.age},\n" +" person.SEX AS {person.sex},\n" +" address.STREET AS {address.street},\n" +" address.CITY AS {address.city},\n" +" address.STATE AS {address.state},\n" +" address.ZIP AS {address.zip}\n" +" FROM PERSON person\n" +" JOIN ADDRESS address\n" +" ON person.ID = address.PERSON_ID AND address.TYPE='MAILING'\n" +" WHERE person.NAME LIKE :namePattern\n" +"</sql-query>]]>" msgstr "" -#: index.docbook:379 -msgid "A named SQL query may return a scalar value. You must declare the column alias and Hibernate type using the <literal><return-scalar></literal> element:" +#. Tag: para +#: query_sql.xml:379 +#, no-c-format +msgid "" +"A named SQL query may return a scalar value. You must declare the column " +"alias and Hibernate type using the <literal><return-scalar></literal> " +"element:" msgstr "" +"A named SQL query may return a scalar value. You must declare the column " +"alias and Hibernate type using the <literal><return-scalar></literal> " +"element:" -#: index.docbook:383 +#. Tag: programlisting +#: query_sql.xml:383 +#, no-c-format msgid "" - "<![CDATA[<sql-query name=\"mySqlQuery\">\n" - " <return-scalar column=\"name\" type=\"string\"/>\n" - " <return-scalar column=\"age\" type=\"long\"/>\n" - " SELECT p.NAME AS name,\n" - " p.AGE AS age,\n" - " FROM PERSON p WHERE p.NAME LIKE 'Hiber%'\n" - "</sql-query>]]>" +"<![CDATA[<sql-query name=\"mySqlQuery\">\n" +" <return-scalar column=\"name\" type=\"string\"/>\n" +" <return-scalar column=\"age\" type=\"long\"/>\n" +" SELECT p.NAME AS name,\n" +" p.AGE AS age,\n" +" FROM PERSON p WHERE p.NAME LIKE 'Hiber%'\n" +"</sql-query>]]>" msgstr "" -#: index.docbook:385 -msgid "You can externalize the resultset mapping informations in a <literal><resultset></literal> element to either reuse them accross several named queries or through the <literal>setResultSetMapping()</literal> API." +#. Tag: para +#: query_sql.xml:385 +#, no-c-format +msgid "" +"You can externalize the resultset mapping informations in a <literal><" +"resultset></literal> element to either reuse them accross several named " +"queries or through the <literal>setResultSetMapping()</literal> API." msgstr "" +"You can externalize the resultset mapping informations in a <literal><" +"resultset></literal> element to either reuse them accross several named " +"queries or through the <literal>setResultSetMapping()</literal> API." -#: index.docbook:390 +#. Tag: programlisting +#: query_sql.xml:390 +#, no-c-format msgid "" - "<![CDATA[<resultset name=\"personAddress\">\n" - " <return alias=\"person\" class=\"eg.Person\"/>\n" - " <return-join alias=\"address\" property=\"person.mailingAddress\"/>\n" - "</resultset>\n" - "\n" - "<sql-query name=\"personsWith\" resultset-ref=\"personAddress\">\n" - " SELECT person.NAME AS {person.name},\n" - " person.AGE AS {person.age},\n" - " person.SEX AS {person.sex},\n" - " address.STREET AS {address.street},\n" - " address.CITY AS {address.city},\n" - " address.STATE AS {address.state},\n" - " address.ZIP AS {address.zip}\n" - " FROM PERSON person\n" - " JOIN ADDRESS address\n" - " ON person.ID = address.PERSON_ID AND address.TYPE='MAILING'\n" - " WHERE person.NAME LIKE :namePattern\n" - "</sql-query>]]>" +"<![CDATA[<resultset name=\"personAddress\">\n" +" <return alias=\"person\" class=\"eg.Person\"/>\n" +" <return-join alias=\"address\" property=\"person.mailingAddress\"/>\n" +"</resultset>\n" +"\n" +"<sql-query name=\"personsWith\" resultset-ref=\"personAddress\">\n" +" SELECT person.NAME AS {person.name},\n" +" person.AGE AS {person.age},\n" +" person.SEX AS {person.sex},\n" +" address.STREET AS {address.street},\n" +" address.CITY AS {address.city},\n" +" address.STATE AS {address.state},\n" +" address.ZIP AS {address.zip}\n" +" FROM PERSON person\n" +" JOIN ADDRESS address\n" +" ON person.ID = address.PERSON_ID AND address.TYPE='MAILING'\n" +" WHERE person.NAME LIKE :namePattern\n" +"</sql-query>]]>" msgstr "" -#: index.docbook:392 -msgid "You can alternatively use the resultset mapping information in your hbm files directly in java code." +#. Tag: para +#: query_sql.xml:392 +#, no-c-format +msgid "" +"You can alternatively use the resultset mapping information in your hbm " +"files directly in java code." msgstr "" +"You can alternatively use the resultset mapping information in your hbm " +"files directly in java code." -#: index.docbook:395 +#. Tag: programlisting +#: query_sql.xml:395 +#, no-c-format msgid "" - "<![CDATA[List cats = sess.createSQLQuery(\n" - " \"select {cat.*}, {kitten.*} from cats cat, cats kitten where kitten.mother = cat.id\"\n" - " )\n" - " .setResultSetMapping(\"catAndKitten\")\n" - " .list();]]>" +"<![CDATA[List cats = sess.createSQLQuery(\n" +" \"select {cat.*}, {kitten.*} from cats cat, cats kitten where kitten." +"mother = cat.id\"\n" +" )\n" +" .setResultSetMapping(\"catAndKitten\")\n" +" .list();]]>" msgstr "" -#: index.docbook:398 +#. Tag: title +#: query_sql.xml:398 +#, no-c-format msgid "Using return-property to explicitly specify column/alias names" -msgstr "" +msgstr "Using return-property to explicitly specify column/alias names" -#: index.docbook:401 -msgid "With <literal><return-property></literal> you can explicitly tell Hibernate what column aliases to use, instead of using the <literal>{}</literal>-syntax to let Hibernate inject its own aliases." +#. Tag: para +#: query_sql.xml:401 +#, no-c-format +msgid "" +"With <literal><return-property></literal> you can explicitly tell " +"Hibernate what column aliases to use, instead of using the <literal>{}</" +"literal>-syntax to let Hibernate inject its own aliases." msgstr "" +"With <literal><return-property></literal> you can explicitly tell " +"Hibernate what column aliases to use, instead of using the <literal>{}</" +"literal>-syntax to let Hibernate inject its own aliases." -#: index.docbook:406 +#. Tag: programlisting +#: query_sql.xml:406 +#, no-c-format msgid "" - "<![CDATA[<sql-query name=\"mySqlQuery\">\n" - " <return alias=\"person\" class=\"eg.Person\">\n" - " <return-property name=\"name\" column=\"myName\"/>\n" - " <return-property name=\"age\" column=\"myAge\"/>\n" - " <return-property name=\"sex\" column=\"mySex\"/>\n" - " </return>\n" - " SELECT person.NAME AS myName,\n" - " person.AGE AS myAge,\n" - " person.SEX AS mySex,\n" - " FROM PERSON person WHERE person.NAME LIKE :name\n" - "</sql-query>\n" - "]]>" +"<![CDATA[<sql-query name=\"mySqlQuery\">\n" +" <return alias=\"person\" class=\"eg.Person\">\n" +" <return-property name=\"name\" column=\"myName\"/>\n" +" <return-property name=\"age\" column=\"myAge\"/>\n" +" <return-property name=\"sex\" column=\"mySex\"/>\n" +" </return>\n" +" SELECT person.NAME AS myName,\n" +" person.AGE AS myAge,\n" +" person.SEX AS mySex,\n" +" FROM PERSON person WHERE person.NAME LIKE :name\n" +"</sql-query>\n" +"]]>" msgstr "" -#: index.docbook:408 -msgid "<literal><return-property></literal> also works with multiple columns. This solves a limitation with the <literal>{}</literal>-syntax which can not allow fine grained control of multi-column properties." +#. Tag: para +#: query_sql.xml:408 +#, no-c-format +msgid "" +"<literal><return-property></literal> also works with multiple columns. " +"This solves a limitation with the <literal>{}</literal>-syntax which can not " +"allow fine grained control of multi-column properties." msgstr "" +"<literal><return-property></literal> also works with multiple columns. " +"This solves a limitation with the <literal>{}</literal>-syntax which can not " +"allow fine grained control of multi-column properties." -#: index.docbook:413 +#. Tag: programlisting +#: query_sql.xml:413 +#, no-c-format msgid "" - "<![CDATA[<sql-query name=\"organizationCurrentEmployments\">\n" - " <return alias=\"emp\" class=\"Employment\">\n" - " <return-property name=\"salary\">\n" - " <return-column name=\"VALUE\"/>\n" - " <return-column name=\"CURRENCY\"/>\n" - " </return-property>\n" - " <return-property name=\"endDate\" column=\"myEndDate\"/>\n" - " </return>\n" - " SELECT EMPLOYEE AS {emp.employee}, EMPLOYER AS {emp.employer},\n" - " STARTDATE AS {emp.startDate}, ENDDATE AS {emp.endDate},\n" - " REGIONCODE as {emp.regionCode}, EID AS {emp.id}, VALUE, CURRENCY\n" - " FROM EMPLOYMENT\n" - " WHERE EMPLOYER = :id AND ENDDATE IS NULL\n" - " ORDER BY STARTDATE ASC\n" - "</sql-query>]]>" +"<![CDATA[<sql-query name=\"organizationCurrentEmployments\">\n" +" <return alias=\"emp\" class=\"Employment\">\n" +" <return-property name=\"salary\">\n" +" <return-column name=\"VALUE\"/>\n" +" <return-column name=\"CURRENCY\"/>\n" +" </return-property>\n" +" <return-property name=\"endDate\" column=\"myEndDate\"/>\n" +" </return>\n" +" SELECT EMPLOYEE AS {emp.employee}, EMPLOYER AS {emp.employer},\n" +" STARTDATE AS {emp.startDate}, ENDDATE AS {emp.endDate},\n" +" REGIONCODE as {emp.regionCode}, EID AS {emp.id}, VALUE, CURRENCY\n" +" FROM EMPLOYMENT\n" +" WHERE EMPLOYER = :id AND ENDDATE IS NULL\n" +" ORDER BY STARTDATE ASC\n" +"</sql-query>]]>" msgstr "" -#: index.docbook:415 -msgid "Notice that in this example we used <literal><return-property></literal> in combination with the <literal>{}</literal>-syntax for injection. Allowing users to choose how they want to refer column and properties." +#. Tag: para +#: query_sql.xml:415 +#, no-c-format +msgid "" +"Notice that in this example we used <literal><return-property></" +"literal> in combination with the <literal>{}</literal>-syntax for injection. " +"Allowing users to choose how they want to refer column and properties." msgstr "" +"Notice that in this example we used <literal><return-property></" +"literal> in combination with the <literal>{}</literal>-syntax for injection. " +"Allowing users to choose how they want to refer column and properties." -#: index.docbook:420 -msgid "If your mapping has a discriminator you must use <literal><return-discriminator></literal> to specify the discriminator column." +#. Tag: para +#: query_sql.xml:420 +#, no-c-format +msgid "" +"If your mapping has a discriminator you must use <literal><return-" +"discriminator></literal> to specify the discriminator column." msgstr "" +"If your mapping has a discriminator you must use <literal><return-" +"discriminator></literal> to specify the discriminator column." -#: index.docbook:426 +#. Tag: title +#: query_sql.xml:426 +#, no-c-format msgid "Using stored procedures for querying" -msgstr "" +msgstr "Using stored procedures for querying" -#: index.docbook:428 -msgid "Hibernate 3 introduces support for queries via stored procedures and functions. Most of the following documentation is equivalent for both. The stored procedure/function must return a resultset as the first out-parameter to be able to work with Hibernate. An example of such a stored function in Oracle 9 and higher is as follows:" +#. Tag: para +#: query_sql.xml:428 +#, no-c-format +msgid "" +"Hibernate 3 introduces support for queries via stored procedures and " +"functions. Most of the following documentation is equivalent for both. The " +"stored procedure/function must return a resultset as the first out-parameter " +"to be able to work with Hibernate. An example of such a stored function in " +"Oracle 9 and higher is as follows:" msgstr "" +"Hibernate 3 introduces support for queries via stored procedures and " +"functions. Most of the following documentation is equivalent for both. The " +"stored procedure/function must return a resultset as the first out-parameter " +"to be able to work with Hibernate. An example of such a stored function in " +"Oracle 9 and higher is as follows:" -#: index.docbook:434 +#. Tag: programlisting +#: query_sql.xml:434 +#, no-c-format msgid "" - "<![CDATA[CREATE OR REPLACE FUNCTION selectAllEmployments\n" - " RETURN SYS_REFCURSOR\n" - "AS\n" - " st_cursor SYS_REFCURSOR;\n" - "BEGIN\n" - " OPEN st_cursor FOR\n" - " SELECT EMPLOYEE, EMPLOYER,\n" - " STARTDATE, ENDDATE,\n" - " REGIONCODE, EID, VALUE, CURRENCY\n" - " FROM EMPLOYMENT;\n" - " RETURN st_cursor;\n" - " END;]]>" +"<![CDATA[CREATE OR REPLACE FUNCTION selectAllEmployments\n" +" RETURN SYS_REFCURSOR\n" +"AS\n" +" st_cursor SYS_REFCURSOR;\n" +"BEGIN\n" +" OPEN st_cursor FOR\n" +" SELECT EMPLOYEE, EMPLOYER,\n" +" STARTDATE, ENDDATE,\n" +" REGIONCODE, EID, VALUE, CURRENCY\n" +" FROM EMPLOYMENT;\n" +" RETURN st_cursor;\n" +" END;]]>" msgstr "" -#: index.docbook:436 +#. Tag: para +#: query_sql.xml:436 +#, no-c-format msgid "To use this query in Hibernate you need to map it via a named query." -msgstr "" +msgstr "To use this query in Hibernate you need to map it via a named query." -#: index.docbook:439 +#. Tag: programlisting +#: query_sql.xml:439 +#, no-c-format msgid "" - "<![CDATA[<sql-query name=\"selectAllEmployees_SP\" callable=\"true\">\n" - " <return alias=\"emp\" class=\"Employment\">\n" - " <return-property name=\"employee\" column=\"EMPLOYEE\"/>\n" - " <return-property name=\"employer\" column=\"EMPLOYER\"/>\n" - " <return-property name=\"startDate\" column=\"STARTDATE\"/>\n" - " <return-property name=\"endDate\" column=\"ENDDATE\"/>\n" - " <return-property name=\"regionCode\" column=\"REGIONCODE\"/>\n" - " <return-property name=\"id\" column=\"EID\"/>\n" - " <return-property name=\"salary\">\n" - " <return-column name=\"VALUE\"/>\n" - " <return-column name=\"CURRENCY\"/>\n" - " </return-property>\n" - " </return>\n" - " { ? = call selectAllEmployments() }\n" - "</sql-query>]]>" +"<![CDATA[<sql-query name=\"selectAllEmployees_SP\" callable=\"true\">\n" +" <return alias=\"emp\" class=\"Employment\">\n" +" <return-property name=\"employee\" column=\"EMPLOYEE\"/>\n" +" <return-property name=\"employer\" column=\"EMPLOYER\"/>\n" +" <return-property name=\"startDate\" column=\"STARTDATE\"/>\n" +" <return-property name=\"endDate\" column=\"ENDDATE\"/>\n" +" <return-property name=\"regionCode\" column=\"REGIONCODE\"/>\n" +" <return-property name=\"id\" column=\"EID\"/>\n" +" <return-property name=\"salary\">\n" +" <return-column name=\"VALUE\"/>\n" +" <return-column name=\"CURRENCY\"/>\n" +" </return-property>\n" +" </return>\n" +" { ? = call selectAllEmployments() }\n" +"</sql-query>]]>" msgstr "" -#: index.docbook:441 -msgid "Notice stored procedures currently only return scalars and entities. <literal><return-join></literal> and <literal><load-collection></literal> are not supported." +#. Tag: para +#: query_sql.xml:441 +#, no-c-format +msgid "" +"Notice stored procedures currently only return scalars and entities. " +"<literal><return-join></literal> and <literal><load-collection></" +"literal> are not supported." msgstr "" +"Notice stored procedures currently only return scalars and entities. " +"<literal><return-join></literal> and <literal><load-collection></" +"literal> are not supported." -#: index.docbook:446 +#. Tag: title +#: query_sql.xml:446 +#, no-c-format msgid "Rules/limitations for using stored procedures" -msgstr "" +msgstr "Rules/limitations for using stored procedures" -#: index.docbook:448 -msgid "To use stored procedures with Hibernate the procedures/functions have to follow some rules. If they do not follow those rules they are not usable with Hibernate. If you still want to use these procedures you have to execute them via <literal>session.connection()</literal>. The rules are different for each database, since database vendors have different stored procedure semantics/syntax." +#. Tag: para +#: query_sql.xml:448 +#, no-c-format +msgid "" +"To use stored procedures with Hibernate the procedures/functions have to " +"follow some rules. If they do not follow those rules they are not usable " +"with Hibernate. If you still want to use these procedures you have to " +"execute them via <literal>session.connection()</literal>. The rules are " +"different for each database, since database vendors have different stored " +"procedure semantics/syntax." msgstr "" +"To use stored procedures with Hibernate the procedures/functions have to " +"follow some rules. If they do not follow those rules they are not usable " +"with Hibernate. If you still want to use these procedures you have to " +"execute them via <literal>session.connection()</literal>. The rules are " +"different for each database, since database vendors have different stored " +"procedure semantics/syntax." -#: index.docbook:455 -msgid "Stored procedure queries can't be paged with <literal>setFirstResult()/setMaxResults()</literal>." +#. Tag: para +#: query_sql.xml:455 +#, no-c-format +msgid "" +"Stored procedure queries can't be paged with <literal>setFirstResult()/" +"setMaxResults()</literal>." msgstr "" +"Stored procedure queries can't be paged with <literal>setFirstResult()/" +"setMaxResults()</literal>." -#: index.docbook:458 -msgid "Recommended call form is standard SQL92: <literal>{ ? = call functionName(<parameters>) }</literal> or <literal>{ ? = call procedureName(<parameters>}</literal>. Native call syntax is not supported." +#. Tag: para +#: query_sql.xml:458 +#, no-c-format +msgid "" +"Recommended call form is standard SQL92: <literal>{ ? = call functionName" +"(<parameters>) }</literal> or <literal>{ ? = call procedureName(<" +"parameters>}</literal>. Native call syntax is not supported." msgstr "" +"Recommended call form is standard SQL92: <literal>{ ? = call functionName" +"(<parameters>) }</literal> or <literal>{ ? = call procedureName(<" +"parameters>}</literal>. Native call syntax is not supported." -#: index.docbook:463 +#. Tag: para +#: query_sql.xml:463 +#, no-c-format msgid "For Oracle the following rules apply:" -msgstr "" +msgstr "For Oracle the following rules apply:" -#: index.docbook:467 -msgid "A function must return a result set. The first parameter of a procedure must be an <literal>OUT</literal> that returns a result set. This is done by using a <literal>SYS_REFCURSOR</literal> type in Oracle 9 or 10. In Oracle you need to define a <literal>REF CURSOR</literal> type, see Oracle literature." +#. Tag: para +#: query_sql.xml:467 +#, no-c-format +msgid "" +"A function must return a result set. The first parameter of a procedure must " +"be an <literal>OUT</literal> that returns a result set. This is done by " +"using a <literal>SYS_REFCURSOR</literal> type in Oracle 9 or 10. In Oracle " +"you need to define a <literal>REF CURSOR</literal> type, see Oracle " +"literature." msgstr "" +"A funçãp deve retornar um result set. O primeiro parâmetro da procedure " +"dever ser uma <literal>SAÍDA</literal> que retorne um result set. Isto é " +"feito usando o tipo a <literal>SYS_REFCURSOR</literal> no Oracle 9 ou 10. No " +"Oracle é necessário definir o tipo <literal>REF CURSOR</literal>, veja a " +"documentação do Oracle." -#: index.docbook:476 +#. Tag: para +#: query_sql.xml:476 +#, no-c-format msgid "For Sybase or MS SQL server the following rules apply:" -msgstr "" +msgstr "For Sybase or MS SQL server the following rules apply:" -#: index.docbook:480 -msgid "The procedure must return a result set. Note that since these servers can/will return multiple result sets and update counts, Hibernate will iterate the results and take the first result that is a result set as its return value. Everything else will be discarded." +#. Tag: para +#: query_sql.xml:480 +#, no-c-format +msgid "" +"The procedure must return a result set. Note that since these servers can/" +"will return multiple result sets and update counts, Hibernate will iterate " +"the results and take the first result that is a result set as its return " +"value. Everything else will be discarded." msgstr "" +"A procedure deve retornar um result set. Veja que este servidor pode " +"retornar múltiplos result sets e update counts. O Hibernate ira iterar os " +"resultados e pegar o primeiro resultado que é o valor de retorno do result " +"set. O resto será descartado." -#: index.docbook:488 -msgid "If you can enable <literal>SET NOCOUNT ON</literal> in your procedure it will probably be more efficient, but this is not a requirement." +#. Tag: para +#: query_sql.xml:488 +#, no-c-format +msgid "" +"If you can enable <literal>SET NOCOUNT ON</literal> in your procedure it " +"will probably be more efficient, but this is not a requirement." msgstr "" +"Se você habilitar <literal>SET NOCOUNT ON</literal> na sua procedure, ela " +"provavelmente será mais eficiente. Mas, isto não é obrigatório" -#: index.docbook:498 +#. Tag: title +#: query_sql.xml:498 +#, no-c-format msgid "Custom SQL for create, update and delete" -msgstr "" +msgstr "SQL customizado para create, update e delete" -#: index.docbook:500 -msgid "Hibernate3 can use custom SQL statements for create, update, and delete operations. The class and collection persisters in Hibernate already contain a set of configuration time generated strings (insertsql, deletesql, updatesql etc.). The mapping tags <literal><sql-insert></literal>, <literal><sql-delete></literal>, and <literal><sql-update></literal> override these strings:" +#. Tag: para +#: query_sql.xml:500 +#, no-c-format +msgid "" +"Hibernate3 can use custom SQL statements for create, update, and delete " +"operations. The class and collection persisters in Hibernate already contain " +"a set of configuration time generated strings (insertsql, deletesql, " +"updatesql etc.). The mapping tags <literal><sql-insert></literal>, " +"<literal><sql-delete></literal>, and <literal><sql-update></" +"literal> override these strings:" msgstr "" +"Hibernate3 can use custom SQL statements for create, update, and delete " +"operations. The class and collection persisters in Hibernate already contain " +"a set of configuration time generated strings (insertsql, deletesql, " +"updatesql etc.). The mapping tags <literal><sql-insert></literal>, " +"<literal><sql-delete></literal>, and <literal><sql-update></" +"literal> override these strings: Hibernate3 pode usar SQL customizado para " +"operações de create, update e delete. A persistência de classe e collection " +"no hibernate já contem alguma strings de configurações (insertsql, " +"deletesql, updatesql etc.). O mapaemento das tags <literal><sql-insert>" +"</literal>, <literal><sql-delete></literal>, e <literal><sql-" +"update></literal> sobreecreve essas strings:" -#: index.docbook:508 +#. Tag: programlisting +#: query_sql.xml:508 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\">\n" - " <generator class=\"increment\"/>\n" - " </id>\n" - " <property name=\"name\" not-null=\"true\"/>\n" - " <sql-insert>INSERT INTO PERSON (NAME, ID) VALUES ( UPPER(?), ? )</sql-insert>\n" - " <sql-update>UPDATE PERSON SET NAME=UPPER(?) WHERE ID=?</sql-update>\n" - " <sql-delete>DELETE FROM PERSON WHERE ID=?</sql-delete>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\">\n" +" <generator class=\"increment\"/>\n" +" </id>\n" +" <property name=\"name\" not-null=\"true\"/>\n" +" <sql-insert>INSERT INTO PERSON (NAME, ID) VALUES ( UPPER(?), ? )</sql-" +"insert>\n" +" <sql-update>UPDATE PERSON SET NAME=UPPER(?) WHERE ID=?</sql-update>\n" +" <sql-delete>DELETE FROM PERSON WHERE ID=?</sql-delete>\n" +"</class>]]>" msgstr "" -#: index.docbook:510 -msgid "The SQL is directly executed in your database, so you are free to use any dialect you like. This will of course reduce the portability of your mapping if you use database specific SQL." +#. Tag: para +#: query_sql.xml:510 +#, no-c-format +msgid "" +"The SQL is directly executed in your database, so you are free to use any " +"dialect you like. This will of course reduce the portability of your mapping " +"if you use database specific SQL." msgstr "" +"O SQL é executado diretamente no seu banco de dados, então você pode usar " +"qualquer linguagem que quiser. Isto com certeza reduzira a portabilidade do " +"seu mapeamento se você utilizar um SQL para um banco de dados especifico." -#: index.docbook:514 -msgid "Stored procedures are supported if the <literal>callable</literal> attribute is set:" +#. Tag: para +#: query_sql.xml:514 +#, no-c-format +msgid "" +"Stored procedures are supported if the <literal>callable</literal> attribute " +"is set:" msgstr "" +"Stored Procedures são suportadas se o atributo the <literal>callable</" +"literal> estiver ativado:" -#: index.docbook:517 +#. Tag: programlisting +#: query_sql.xml:517 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\">\n" - " <generator class=\"increment\"/>\n" - " </id>\n" - " <property name=\"name\" not-null=\"true\"/>\n" - " <sql-insert callable=\"true\">{call createPerson (?, ?)}</sql-insert>\n" - " <sql-delete callable=\"true\">{? = call deletePerson (?)}</sql-delete>\n" - " <sql-update callable=\"true\">{? = call updatePerson (?, ?)}</sql-update>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\">\n" +" <generator class=\"increment\"/>\n" +" </id>\n" +" <property name=\"name\" not-null=\"true\"/>\n" +" <sql-insert callable=\"true\">{call createPerson (?, ?)}</sql-insert>\n" +" <sql-delete callable=\"true\">{? = call deletePerson (?)}</sql-delete>\n" +" <sql-update callable=\"true\">{? = call updatePerson (?, ?)}</sql-" +"update>\n" +"</class>]]>" msgstr "" -#: index.docbook:519 -msgid "The order of the positional parameters are currently vital, as they must be in the same sequence as Hibernate expects them." +#. Tag: para +#: query_sql.xml:519 +#, no-c-format +msgid "" +"The order of the positional parameters are currently vital, as they must be " +"in the same sequence as Hibernate expects them." msgstr "" +"A ordem de posições dos parâmetros são vitais, pois eles devem estar na " +"mesma seqüência esperada pelo Hibernate." -#: index.docbook:522 -msgid "You can see the expected order by enabling debug logging for the <literal>org.hibernate.persister.entity</literal> level. With this level enabled Hibernate will print out the static SQL that is used to create, update, delete etc. entities. (To see the expected sequence, remember to not include your custom SQL in the mapping files as that will override the Hibernate generated static sql.)" +#. Tag: para +#: query_sql.xml:522 +#, no-c-format +msgid "" +"You can see the expected order by enabling debug logging for the " +"<literal>org.hibernate.persister.entity</literal> level. With this level " +"enabled Hibernate will print out the static SQL that is used to create, " +"update, delete etc. entities. (To see the expected sequence, remember to not " +"include your custom SQL in the mapping files as that will override the " +"Hibernate generated static sql.)" msgstr "" +"Você pode ver a ordem esperada ativando o debug logging no nível " +"<literal>org.hibernate.persister.entity</literal>. Com este nível ativado, o " +"Hibernate irá imprimir o SQL estático que foi usado para create, update, " +"delete, etc. Entidades. (Para ver a seqüência esperada, lembre-se de não " +"incluir seu SQL customizado no arquivo de mapeamento, pois ele irá " +"sobreecreve o SQL estático gerado pelo Hibernate)." -#: index.docbook:529 -msgid "The stored procedures are in most cases (read: better do it than not) required to return the number of rows inserted/updated/deleted, as Hibernate has some runtime checks for the success of the statement. Hibernate always registers the first statement parameter as a numeric output parameter for the CUD operations:" +#. Tag: para +#: query_sql.xml:529 +#, no-c-format +msgid "" +"The stored procedures are in most cases (read: better do it than not) " +"required to return the number of rows inserted/updated/deleted, as Hibernate " +"has some runtime checks for the success of the statement. Hibernate always " +"registers the first statement parameter as a numeric output parameter for " +"the CUD operations:" msgstr "" +"As stored procedures são na maioria dos casos (leia: melhor não fazer) " +"requeridas para retornar o numero de linhas inseridas/atualizadas/deletadas. " +"O hibernate tem algumas verificações em tempo de execução para o sucesso da " +"declaração. Hibernate sempre registra o primeiro parâmetro da declaração " +"como uma saída numérica para operações CRUD." -#: index.docbook:535 +#. Tag: programlisting +#: query_sql.xml:535 +#, no-c-format msgid "" - "<![CDATA[CREATE OR REPLACE FUNCTION updatePerson (uid IN NUMBER, uname IN VARCHAR2)\n" - " RETURN NUMBER IS\n" - "BEGIN\n" - "\n" - " update PERSON\n" - " set\n" - " NAME = uname,\n" - " where\n" - " ID = uid;\n" - "\n" - " return SQL%ROWCOUNT;\n" - "\n" - "END updatePerson;]]>" +"<![CDATA[CREATE OR REPLACE FUNCTION updatePerson (uid IN NUMBER, uname IN " +"VARCHAR2)\n" +" RETURN NUMBER IS\n" +"BEGIN\n" +"\n" +" update PERSON\n" +" set\n" +" NAME = uname,\n" +" where\n" +" ID = uid;\n" +"\n" +" return SQL%ROWCOUNT;\n" +"\n" +"END updatePerson;]]>" msgstr "" -#: index.docbook:539 +#. Tag: title +#: query_sql.xml:539 +#, no-c-format msgid "Custom SQL for loading" -msgstr "" +msgstr "SQL customizado para carga" -#: index.docbook:541 +#. Tag: para +#: query_sql.xml:541 +#, no-c-format msgid "You may also declare your own SQL (or HQL) queries for entity loading:" msgstr "" +"Você pode declarar sua própria query SQL (ou HQL) para iniciar entidades:" -#: index.docbook:544 +#. Tag: programlisting +#: query_sql.xml:544 +#, no-c-format msgid "" - "<![CDATA[<sql-query name=\"person\">\n" - " <return alias=\"pers\" class=\"Person\" lock-mode=\"upgrade\"/>\n" - " SELECT NAME AS {pers.name}, ID AS {pers.id}\n" - " FROM PERSON\n" - " WHERE ID=?\n" - " FOR UPDATE\n" - "</sql-query>]]>" +"<![CDATA[<sql-query name=\"person\">\n" +" <return alias=\"pers\" class=\"Person\" lock-mode=\"upgrade\"/>\n" +" SELECT NAME AS {pers.name}, ID AS {pers.id}\n" +" FROM PERSON\n" +" WHERE ID=?\n" +" FOR UPDATE\n" +"</sql-query>]]>" msgstr "" -#: index.docbook:546 -msgid "This is just a named query declaration, as discussed earlier. You may reference this named query in a class mapping:" +#. Tag: para +#: query_sql.xml:546 +#, no-c-format +msgid "" +"This is just a named query declaration, as discussed earlier. You may " +"reference this named query in a class mapping:" msgstr "" +"Este é apenas uma declaração de query com nome, como discutido " +"anteriormente. Você pode referenciar esta query com nome em um mapeamento de " +"classe:" -#: index.docbook:549 +#. Tag: programlisting +#: query_sql.xml:549 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\">\n" - " <generator class=\"increment\"/>\n" - " </id>\n" - " <property name=\"name\" not-null=\"true\"/>\n" - " <loader query-ref=\"person\"/>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\">\n" +" <generator class=\"increment\"/>\n" +" </id>\n" +" <property name=\"name\" not-null=\"true\"/>\n" +" <loader query-ref=\"person\"/>\n" +"</class>]]>" msgstr "" -#: index.docbook:551 +#. Tag: para +#: query_sql.xml:551 +#, no-c-format msgid "This even works with stored procedures." -msgstr "" +msgstr "Isto também funciona com stored procedures." -#: index.docbook:553 +#. Tag: para +#: query_sql.xml:553 +#, no-c-format msgid "You may even define a query for collection loading:" -msgstr "" +msgstr "Você pode tembém definir uma query para iniciar collection:" -#: index.docbook:555 +#. Tag: programlisting +#: query_sql.xml:555 +#, no-c-format msgid "" - "<![CDATA[<set name=\"employments\" inverse=\"true\">\n" - " <key/>\n" - " <one-to-many class=\"Employment\"/>\n" - " <loader query-ref=\"employments\"/>\n" - "</set>]]>" +"<![CDATA[<set name=\"employments\" inverse=\"true\">\n" +" <key/>\n" +" <one-to-many class=\"Employment\"/>\n" +" <loader query-ref=\"employments\"/>\n" +"</set>]]>" msgstr "" -#: index.docbook:557 +#. Tag: programlisting +#: query_sql.xml:557 +#, no-c-format msgid "" - "<![CDATA[<sql-query name=\"employments\">\n" - " <load-collection alias=\"emp\" role=\"Person.employments\"/>\n" - " SELECT {emp.*}\n" - " FROM EMPLOYMENT emp\n" - " WHERE EMPLOYER = :id\n" - " ORDER BY STARTDATE ASC, EMPLOYEE ASC\n" - "</sql-query>]]>" +"<![CDATA[<sql-query name=\"employments\">\n" +" <load-collection alias=\"emp\" role=\"Person.employments\"/>\n" +" SELECT {emp.*}\n" +" FROM EMPLOYMENT emp\n" +" WHERE EMPLOYER = :id\n" +" ORDER BY STARTDATE ASC, EMPLOYEE ASC\n" +"</sql-query>]]>" msgstr "" -#: index.docbook:559 -msgid "You could even define an entity loader that loads a collection by join fetching:" +#. Tag: para +#: query_sql.xml:559 +#, no-c-format +msgid "" +"You could even define an entity loader that loads a collection by join " +"fetching:" msgstr "" +"You could even define an entity loader that loads a collection by join " +"fetching:" -#: index.docbook:562 +#. Tag: programlisting +#: query_sql.xml:562 +#, no-c-format msgid "" - "<![CDATA[<sql-query name=\"person\">\n" - " <return alias=\"pers\" class=\"Person\"/>\n" - " <return-join alias=\"emp\" property=\"pers.employments\"/>\n" - " SELECT NAME AS {pers.*}, {emp.*}\n" - " FROM PERSON pers\n" - " LEFT OUTER JOIN EMPLOYMENT emp\n" - " ON pers.ID = emp.PERSON_ID\n" - " WHERE ID=?\n" - "</sql-query>]]>" +"<![CDATA[<sql-query name=\"person\">\n" +" <return alias=\"pers\" class=\"Person\"/>\n" +" <return-join alias=\"emp\" property=\"pers.employments\"/>\n" +" SELECT NAME AS {pers.*}, {emp.*}\n" +" FROM PERSON pers\n" +" LEFT OUTER JOIN EMPLOYMENT emp\n" +" ON pers.ID = emp.PERSON_ID\n" +" WHERE ID=?\n" +"</sql-query>]]>" msgstr "" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "" - Modified: core/trunk/documentation/manual/translations/pt-BR/content/session_api.po =================================================================== --- core/trunk/documentation/manual/translations/pt-BR/content/session_api.po 2007-10-25 22:34:46 UTC (rev 14134) +++ core/trunk/documentation/manual/translations/pt-BR/content/session_api.po 2007-10-26 00:46:38 UTC (rev 14135) @@ -1,982 +1,2231 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: session_api.xml:5 +#, no-c-format msgid "Working with objects" -msgstr "" +msgstr "Trabalhando com objetos" -#: index.docbook:7 -msgid "Hibernate is a full object/relational mapping solution that not only shields the developer from the details of the underlying database management system, but also offers <emphasis>state management</emphasis> of objects. This is, contrary to the management of SQL <literal>statements</literal> in common JDBC/SQL persistence layers, a very natural object-oriented view of persistence in Java applications." +#. Tag: para +#: session_api.xml:7 +#, no-c-format +msgid "" +"Hibernate is a full object/relational mapping solution that not only shields " +"the developer from the details of the underlying database management system, " +"but also offers <emphasis>state management</emphasis> of objects. This is, " +"contrary to the management of SQL <literal>statements</literal> in common " +"JDBC/SQL persistence layers, a very natural object-oriented view of " +"persistence in Java applications." msgstr "" +"O Hibernate é uma solução completa de mapeamento objeto/relacional que não " +"apenas poupa o desenvolvedor dos detalhes de baixo nível do sistema de " +"gerenciamento do banco de dados, mas também oferece um " +"<emphasis>gerenciamento de estado </emphasis> para objetos. Isto é, ao " +"contrário do gerenciamento de <literal>instruções </literal> SQL em camadas " +"de persistência JDBC/SQL comuns, uma visão natural da persistência orientada " +"a objetos em aplicações Java." -#: index.docbook:16 -msgid "In other words, Hibernate application developers should always think about the <emphasis>state</emphasis> of their objects, and not necessarily about the execution of SQL statements. This part is taken care of by Hibernate and is only relevant for the application developer when tuning the performance of the system." +#. Tag: para +#: session_api.xml:16 +#, no-c-format +msgid "" +"In other words, Hibernate application developers should always think about " +"the <emphasis>state</emphasis> of their objects, and not necessarily about " +"the execution of SQL statements. This part is taken care of by Hibernate and " +"is only relevant for the application developer when tuning the performance " +"of the system." msgstr "" +"Em outras palavras, desenvolvedores de aplicações Hibernate podem sempre " +"pensar em relação ao <emphasis>estado</emphasis> de seus objetos, e não " +"necessariamente em relação a execução de instruções SQL. Este parte é " +"responsabilidade do Hibernate e é relevante aos desenvolvedores de " +"aplicações apenas quando estão ajustando a performance do sistema." -#: index.docbook:24 +#. Tag: title +#: session_api.xml:24 +#, no-c-format msgid "Hibernate object states" -msgstr "" +msgstr "Estado dos objetos no Hibernate" -#: index.docbook:26 +#. Tag: para +#: session_api.xml:26 +#, no-c-format msgid "Hibernate defines and supports the following object states:" -msgstr "" +msgstr "O Hibernate define e suporta os seguintes estados de um objetos:" -#: index.docbook:32 -msgid "<emphasis>Transient</emphasis> - an object is transient if it has just been instantiated using the <literal>new</literal> operator, and it is not associated with a Hibernate <literal>Session</literal>. It has no persistent representation in the database and no identifier value has been assigned. Transient instances will be destroyed by the garbage collector if the application doesn't hold a reference anymore. Use the Hibernate <literal>Session</literal> to make an object persistent (and let Hibernate take care of the SQL statements that need to be executed for this transition)." +#. Tag: para +#: session_api.xml:32 +#, no-c-format +msgid "" +"<emphasis>Transient</emphasis> - an object is transient if it has just been " +"instantiated using the <literal>new</literal> operator, and it is not " +"associated with a Hibernate <literal>Session</literal>. It has no persistent " +"representation in the database and no identifier value has been assigned. " +"Transient instances will be destroyed by the garbage collector if the " +"application doesn't hold a reference anymore. Use the Hibernate " +"<literal>Session</literal> to make an object persistent (and let Hibernate " +"take care of the SQL statements that need to be executed for this " +"transition)." msgstr "" +"<emphasis>Transient</emphasis> - um objeto é transiente se ele foi " +"instanciando usando apenas o operador <literal>new</literal>, e não foi " +"associado com uma <literal>Session</literal> do Hibernate. Ele não terá uma " +"representação persistente no banco de dados e nenhum identificador será " +"atribuído para ele. Instâncias transientes serão destruídas pelo coletor de " +"lixo se a aplicação não manter sua referência. Use uma <literal>Session</" +"literal> do Hibernate para tornar o objeto persistente ( e deixe o Hibernate " +"gerenciar as instruções SQL que serão necessárias para executar esta " +"transição)." -#: index.docbook:44 -msgid "<emphasis>Persistent</emphasis> - a persistent instance has a representation in the database and an identifier value. It might just have been saved or loaded, however, it is by definition in the scope of a <literal>Session</literal>. Hibernate will detect any changes made to an object in persistent state and synchronize the state with the database when the unit of work completes. Developers don't execute manual <literal>UPDATE</literal> statements, or <literal>DELETE</literal> statements when an object should be made transient." +#. Tag: para +#: session_api.xml:44 +#, no-c-format +msgid "" +"<emphasis>Persistent</emphasis> - a persistent instance has a representation " +"in the database and an identifier value. It might just have been saved or " +"loaded, however, it is by definition in the scope of a <literal>Session</" +"literal>. Hibernate will detect any changes made to an object in persistent " +"state and synchronize the state with the database when the unit of work " +"completes. Developers don't execute manual <literal>UPDATE</literal> " +"statements, or <literal>DELETE</literal> statements when an object should be " +"made transient." msgstr "" +"<emphasis>Persistent</emphasis> -– uma instância persistente possui uma " +"representação no banco de dados e um identificador. Ele pode ter sido salvo " +"ou carregado, assim, ele está por definição no escopo de uma " +"<literal>Session</literal>. O Hibernate irá detectar qualquer mudança feita " +"a um objeto persistente e sincronizar o seu estado com o banco de dados " +"quando completar a unidade de trabalho. Desenvolvedores não executam " +"instruções manuais de <literal>UPDATE</literal>, ou instruções de " +"<literal>DELETE</literal> quando o objeto deve ser passado para transiente." -#: index.docbook:55 -msgid "<emphasis>Detached</emphasis> - a detached instance is an object that has been persistent, but its <literal>Session</literal> has been closed. The reference to the object is still valid, of course, and the detached instance might even be modified in this state. A detached instance can be reattached to a new <literal>Session</literal> at a later point in time, making it (and all the modifications) persistent again. This feature enables a programming model for long running units of work that require user think-time. We call them <emphasis>application transactions</emphasis>, i.e. a unit of work from the point of view of the user." +#. Tag: para +#: session_api.xml:55 +#, no-c-format +msgid "" +"<emphasis>Detached</emphasis> - a detached instance is an object that has " +"been persistent, but its <literal>Session</literal> has been closed. The " +"reference to the object is still valid, of course, and the detached instance " +"might even be modified in this state. A detached instance can be reattached " +"to a new <literal>Session</literal> at a later point in time, making it (and " +"all the modifications) persistent again. This feature enables a programming " +"model for long running units of work that require user think-time. We call " +"them <emphasis>application transactions</emphasis>, i.e. a unit of work from " +"the point of view of the user." msgstr "" +"<emphasis>Detached</emphasis> – uma instância desaclopada é um objeto que " +"foi persistido, mas sua <literal>Session</literal> foi fechada. A referência " +"ao objeto continua válida, é claro, e a instância destacada desaclopada pode " +"ser acoplada a uma nova <literal>Session</literal> no futuro, fazendo-o ( e " +"todas as modificações sofridas) persistente novamente. Essa característica " +"possibilita um modelo de programação para unidades de trabalho que rodam " +"durante muito tempo que requer um pensamento por tempo do usuário. Podemos " +"chamar-las de <emphasis>transações da aplicação</emphasis>, i.e. uma unidade " +"de trabalho do ponto de vista do usuário." -#: index.docbook:69 -msgid "We'll now discuss the states and state transitions (and the Hibernate methods that trigger a transition) in more detail." +#. Tag: para +#: session_api.xml:69 +#, no-c-format +msgid "" +"We'll now discuss the states and state transitions (and the Hibernate " +"methods that trigger a transition) in more detail." msgstr "" +"Agora iremos discutir os estados e suas transições ( e os métodos do " +"Hibernate que disparam uma transição) em mais detalhes." -#: index.docbook:77 +#. Tag: title +#: session_api.xml:77 +#, no-c-format msgid "Making objects persistent" -msgstr "" +msgstr "Tornando os objetos persistentes" -#: index.docbook:79 -msgid "Newly instantiated instances of a a persistent class are considered <emphasis>transient</emphasis> by Hibernate. We can make a transient instance <emphasis>persistent</emphasis> by associating it with a session:" +#. Tag: para +#: session_api.xml:79 +#, no-c-format +msgid "" +"Newly instantiated instances of a a persistent class are considered " +"<emphasis>transient</emphasis> by Hibernate. We can make a transient " +"instance <emphasis>persistent</emphasis> by associating it with a session:" msgstr "" +"Instâncias recentemente instanciadas de uma classe persistente são " +"consideradas <emphasis>transientes </emphasis> pelo Hibernate. Podemos " +"tornar uma instância transiente em <emphasis>persistente</emphasis> " +"associando-a a uma sessão:" -#: index.docbook:86 +#. Tag: programlisting +#: session_api.xml:86 +#, no-c-format msgid "" - "<![CDATA[DomesticCat fritz = new DomesticCat();\n" - "fritz.setColor(Color.GINGER);\n" - "fritz.setSex('M');\n" - "fritz.setName(\"Fritz\");\n" - "Long generatedId = (Long) sess.save(fritz);]]>" +"<![CDATA[DomesticCat fritz = new DomesticCat();\n" +"fritz.setColor(Color.GINGER);\n" +"fritz.setSex('M');\n" +"fritz.setName(\"Fritz\");\n" +"Long generatedId = (Long) sess.save(fritz);]]>" msgstr "" -#: index.docbook:88 -msgid "If <literal>Cat</literal> has a generated identifier, the identifier is generated and assigned to the <literal>cat</literal> when <literal>save()</literal> is called. If <literal>Cat</literal> has an <literal>assigned</literal> identifier, or a composite key, the identifier should be assigned to the <literal>cat</literal> instance before calling <literal>save()</literal>. You may also use <literal>persist()</literal> instead of <literal>save()</literal>, with the semantics defined in the EJB3 early draft." +#. Tag: para +#: session_api.xml:88 +#, no-c-format +msgid "" +"If <literal>Cat</literal> has a generated identifier, the identifier is " +"generated and assigned to the <literal>cat</literal> when <literal>save()</" +"literal> is called. If <literal>Cat</literal> has an <literal>assigned</" +"literal> identifier, or a composite key, the identifier should be assigned " +"to the <literal>cat</literal> instance before calling <literal>save()</" +"literal>. You may also use <literal>persist()</literal> instead of " +"<literal>save()</literal>, with the semantics defined in the EJB3 early " +"draft." msgstr "" +"Se <literal>Cat</literal> possui um identificador gerado, o identificador é " +"gerado e atribuído a <literal>cat</literal> quando <literal>save()</literal> " +"for chamada. Se <literal>Cat</literal> possuir um identificador " +"<literal>Associado</literal>, ou uma chave composta, o identificador deve " +"ser atribuído à instância de <literal>cat</literal> antes que <literal>save()" +"</literal> seja chamado. Pode-se usar também <literal>persist()</literal> ao " +"invés de <literal>save()</literal>, com a semântica definada no novo esboço " +"do EJB3." -#: index.docbook:100 -msgid "<literal>persist()</literal> makes a transient instance persistent. However, it doesn't guarantee that the identifier value will be assigned to the persistent instance immediately, the assignment might happen at flush time. <literal>persist()</literal> also guarantees that it will not execute an <literal>INSERT</literal> statement if it is called outside of transaction boundaries. This is useful in long-running conversations with an extended Session/persistence context." +#. Tag: para +#: session_api.xml:100 +#, no-c-format +msgid "" +"<literal>persist()</literal> makes a transient instance persistent. However, " +"it doesn't guarantee that the identifier value will be assigned to the " +"persistent instance immediately, the assignment might happen at flush time. " +"<literal>persist()</literal> also guarantees that it will not execute an " +"<literal>INSERT</literal> statement if it is called outside of transaction " +"boundaries. This is useful in long-running conversations with an extended " +"Session/persistence context." msgstr "" +"<literal>persist()</literal> makes a transient instance persistent. However, " +"it doesn't guarantee that the identifier value will be assigned to the " +"persistent instance immediately, the assignment might happen at flush time. " +"<literal>persist()</literal> also guarantees that it will not execute an " +"<literal>INSERT</literal> statement if it is called outside of transaction " +"boundaries. This is useful in long-running conversations with an extended " +"Session/persistence context." -#: index.docbook:111 -msgid "<literal>save()</literal> does guarantee to return an identifier. If an INSERT has to be executed to get the identifier ( e.g. \"identity\" generator, not \"sequence\"), this INSERT happens immediately, no matter if you are inside or outside of a transaction. This is problematic in a long-running conversation with an extended Session/persistence context." +#. Tag: para +#: session_api.xml:111 +#, no-c-format +msgid "" +"<literal>save()</literal> does guarantee to return an identifier. If an " +"INSERT has to be executed to get the identifier ( e.g. \"identity\" " +"generator, not \"sequence\"), this INSERT happens immediately, no matter if " +"you are inside or outside of a transaction. This is problematic in a long-" +"running conversation with an extended Session/persistence context." msgstr "" +"<literal>save()</literal> does guarantee to return an identifier. If an " +"INSERT has to be executed to get the identifier ( e.g. \"identity\" " +"generator, not \"sequence\"), this INSERT happens immediately, no matter if " +"you are inside or outside of a transaction. This is problematic in a long-" +"running conversation with an extended Session/persistence context." -#: index.docbook:121 -msgid "Alternatively, you may assign the identifier using an overloaded version of <literal>save()</literal>." +#. Tag: para +#: session_api.xml:121 +#, no-c-format +msgid "" +"Alternatively, you may assign the identifier using an overloaded version of " +"<literal>save()</literal>." msgstr "" +"Alternativamente, pode-se atribuir o identificador usando uma versão " +"sobrecarregada de <literal>save()</literal>." -#: index.docbook:126 +#. Tag: programlisting +#: session_api.xml:126 +#, no-c-format msgid "" - "<![CDATA[DomesticCat pk = new DomesticCat();\n" - "pk.setColor(Color.TABBY);\n" - "pk.setSex('F');\n" - "pk.setName(\"PK\");\n" - "pk.setKittens( new HashSet() );\n" - "pk.addKitten(fritz);\n" - "sess.save( pk, new Long(1234) );]]>" +"<![CDATA[DomesticCat pk = new DomesticCat();\n" +"pk.setColor(Color.TABBY);\n" +"pk.setSex('F');\n" +"pk.setName(\"PK\");\n" +"pk.setKittens( new HashSet() );\n" +"pk.addKitten(fritz);\n" +"sess.save( pk, new Long(1234) );]]>" msgstr "" -#: index.docbook:128 -msgid "If the object you make persistent has associated objects (e.g. the <literal>kittens</literal> collection in the previous example), these objects may be made persistent in any order you like unless you have a <literal>NOT NULL</literal> constraint upon a foreign key column. There is never a risk of violating foreign key constraints. However, you might violate a <literal>NOT NULL</literal> constraint if you <literal>save()</literal> the objects in the wrong order." +#. Tag: para +#: session_api.xml:128 +#, no-c-format +msgid "" +"If the object you make persistent has associated objects (e.g. the " +"<literal>kittens</literal> collection in the previous example), these " +"objects may be made persistent in any order you like unless you have a " +"<literal>NOT NULL</literal> constraint upon a foreign key column. There is " +"never a risk of violating foreign key constraints. However, you might " +"violate a <literal>NOT NULL</literal> constraint if you <literal>save()</" +"literal> the objects in the wrong order." msgstr "" +"Se o objeto persistido possuir objetos associados (e.g. a coleção " +"<literal>kittens</literal> no exemplo anterior), esses objetos podem ser " +"tornar persistente em qualquer ordem que se queira ao menos que se tenha uma " +"restrição <literal>NOT NULL</literal> em uma coluna de chave estrangeira. " +"Nunca há risco de violação de restrições de chave estrangeira. Assim, pode-" +"se violar uma restrição <literal>NOT NULL</literal> se <literal>save()</" +"literal> for usada nos objetos em uma ordem errada." -#: index.docbook:138 -msgid "Usually you don't bother with this detail, as you'll very likely use Hibernate's <emphasis>transitive persistence</emphasis> feature to save the associated objects automatically. Then, even <literal>NOT NULL</literal> constraint violations don't occur - Hibernate will take care of everything. Transitive persistence is discussed later in this chapter." +#. Tag: para +#: session_api.xml:138 +#, no-c-format +msgid "" +"Usually you don't bother with this detail, as you'll very likely use " +"Hibernate's <emphasis>transitive persistence</emphasis> feature to save the " +"associated objects automatically. Then, even <literal>NOT NULL</literal> " +"constraint violations don't occur - Hibernate will take care of everything. " +"Transitive persistence is discussed later in this chapter." msgstr "" +"Geralmente você não deve se importar com esses detalhes, muito provavelmente " +"se usará a característica de <emphasis>persistência transitiva </emphasis> " +"do Hibernate para salvar os objetos associados automaticamente. Então, " +"enquanto uma restrição <literal>NOT NULL</literal> não ocorrer – Hibernate " +"tomará conta de tudo. Persistência transitiva será discutida futuramente " +"nesse capítulo." -#: index.docbook:149 +#. Tag: title +#: session_api.xml:149 +#, no-c-format msgid "Loading an object" -msgstr "" +msgstr "Carregando o objetos" -#: index.docbook:151 -msgid "The <literal>load()</literal> methods of <literal>Session</literal> gives you a way to retrieve a persistent instance if you already know its identifier. <literal>load()</literal> takes a class object and will load the state into a newly instantiated instance of that class, in persistent state." +#. Tag: para +#: session_api.xml:151 +#, no-c-format +msgid "" +"The <literal>load()</literal> methods of <literal>Session</literal> gives " +"you a way to retrieve a persistent instance if you already know its " +"identifier. <literal>load()</literal> takes a class object and will load the " +"state into a newly instantiated instance of that class, in persistent state." msgstr "" +"O método <literal>load()</literal> de uma <literal> Session</literal> nos " +"fornece um meio para recuperar uma instância persistente se o identificador " +"for conhecido. <literal>load()</literal> recebe uma classe do objeto e " +"carregará o estado em uma instância mais recente dessa classe, no estado " +"persistente." -#: index.docbook:158 +#. Tag: programlisting +#: session_api.xml:158 +#, no-c-format msgid "<![CDATA[Cat fritz = (Cat) sess.load(Cat.class, generatedId);]]>" msgstr "" -#: index.docbook:160 +#. Tag: programlisting +#: session_api.xml:160 +#, no-c-format msgid "" - "<![CDATA[// you need to wrap primitive identifiers\n" - "long id = 1234;\n" - "DomesticCat pk = (DomesticCat) sess.load( DomesticCat.class, new Long(id) );]]>" +"<![CDATA[// you need to wrap primitive identifiers\n" +"long id = 1234;\n" +"DomesticCat pk = (DomesticCat) sess.load( DomesticCat.class, new Long" +"(id) );]]>" msgstr "" -#: index.docbook:162 +#. Tag: para +#: session_api.xml:162 +#, no-c-format msgid "Alternatively, you can load state into a given instance:" msgstr "" +"Alternatively, you can load state into a given instance: Alternativamente, " +"pode-se carregar um estado em uma instância dada:" -#: index.docbook:166 +#. Tag: programlisting +#: session_api.xml:166 +#, no-c-format msgid "" - "<![CDATA[Cat cat = new DomesticCat();\n" - "// load pk's state into cat\n" - "sess.load( cat, new Long(pkId) );\n" - "Set kittens = cat.getKittens();]]>" +"<![CDATA[Cat cat = new DomesticCat();\n" +"// load pk's state into cat\n" +"sess.load( cat, new Long(pkId) );\n" +"Set kittens = cat.getKittens();]]>" msgstr "" -#: index.docbook:168 -msgid "Note that <literal>load()</literal> will throw an unrecoverable exception if there is no matching database row. If the class is mapped with a proxy, <literal>load()</literal> just returns an uninitialized proxy and does not actually hit the database until you invoke a method of the proxy. This behaviour is very useful if you wish to create an association to an object without actually loading it from the database. It also allows multiple instances to be loaded as a batch if <literal>batch-size</literal> is defined for the class mapping." +#. Tag: para +#: session_api.xml:168 +#, no-c-format +msgid "" +"Note that <literal>load()</literal> will throw an unrecoverable exception if " +"there is no matching database row. If the class is mapped with a proxy, " +"<literal>load()</literal> just returns an uninitialized proxy and does not " +"actually hit the database until you invoke a method of the proxy. This " +"behaviour is very useful if you wish to create an association to an object " +"without actually loading it from the database. It also allows multiple " +"instances to be loaded as a batch if <literal>batch-size</literal> is " +"defined for the class mapping." msgstr "" +"Repare que <literal>load()</literal> irá lançar uma exceção irrecuperável se " +"não houver na tabela no banco de dados um registro que combine. Se a classe " +"for mapeada com um proxy, <literal>load()</literal> simplesmente retorna um " +"proxy não inicializado e realmente não chamará o banco de dados até que um " +"método do proxy seja invocado. Esse comportamento é muito útil se deseja-se " +"criar uma associação com um objeto sem que realmente o carregue do bando de " +"dados. Isto também permite que sejam carregadas múltiplas instâncias como um " +"grupo se <literal>batch-size</literal> estiver para o mapeamento da classe." -#: index.docbook:179 -msgid "If you are not certain that a matching row exists, you should use the <literal>get()</literal> method, which hits the database immediately and returns null if there is no matching row." +#. Tag: para +#: session_api.xml:179 +#, no-c-format +msgid "" +"If you are not certain that a matching row exists, you should use the " +"<literal>get()</literal> method, which hits the database immediately and " +"returns null if there is no matching row." msgstr "" +"Se você não tiver certeza da existencia do registro no banco, você deve usar " +"o metodo <literal>get()</literal>, que consulta o banco imediantamente e " +"retorna um null se não existir o registro." -#: index.docbook:185 +#. Tag: programlisting +#: session_api.xml:185 +#, no-c-format msgid "" - "<![CDATA[Cat cat = (Cat) sess.get(Cat.class, id);\n" - "if (cat==null) {\n" - " cat = new Cat();\n" - " sess.save(cat, id);\n" - "}\n" - "return cat;]]>" +"<![CDATA[Cat cat = (Cat) sess.get(Cat.class, id);\n" +"if (cat==null) {\n" +" cat = new Cat();\n" +" sess.save(cat, id);\n" +"}\n" +"return cat;]]>" msgstr "" -#: index.docbook:187 -msgid "You may even load an object using an SQL <literal>SELECT ... FOR UPDATE</literal>, using a <literal>LockMode</literal>. See the API documentation for more information." +#. Tag: para +#: session_api.xml:187 +#, no-c-format +msgid "" +"You may even load an object using an SQL <literal>SELECT ... FOR UPDATE</" +"literal>, using a <literal>LockMode</literal>. See the API documentation for " +"more information." msgstr "" +"Também pode-se carregar um objeto usando <literal>SELECT ... FOR UPDATE</" +"literal>, usando um <literal>LockMode</literal>. Veja a documentação da API " +"para maiores informações." -#: index.docbook:192 +#. Tag: programlisting +#: session_api.xml:192 +#, no-c-format msgid "<![CDATA[Cat cat = (Cat) sess.get(Cat.class, id, LockMode.UPGRADE);]]>" msgstr "" -#: index.docbook:194 -msgid "Note that any associated instances or contained collections are <emphasis>not</emphasis> selected <literal>FOR UPDATE</literal>, unless you decide to specify <literal>lock</literal> or <literal>all</literal> as a cascade style for the association." +#. Tag: para +#: session_api.xml:194 +#, no-c-format +msgid "" +"Note that any associated instances or contained collections are " +"<emphasis>not</emphasis> selected <literal>FOR UPDATE</literal>, unless you " +"decide to specify <literal>lock</literal> or <literal>all</literal> as a " +"cascade style for the association." msgstr "" +"Note that any associated instances or contained collections are " +"<emphasis>not</emphasis> selected <literal>FOR UPDATE</literal>, unless you " +"decide to specify <literal>lock</literal> or <literal>all</literal> as a " +"cascade style for the association." -#: index.docbook:201 -msgid "It is possible to re-load an object and all its collections at any time, using the <literal>refresh()</literal> method. This is useful when database triggers are used to initialize some of the properties of the object." +#. Tag: para +#: session_api.xml:201 +#, no-c-format +msgid "" +"It is possible to re-load an object and all its collections at any time, " +"using the <literal>refresh()</literal> method. This is useful when database " +"triggers are used to initialize some of the properties of the object." msgstr "" +"O recarregamento de um objeto e todas as suas coleções é possível a qualquer " +"momento, usando o método <literal>refresh()</literal>. Util quando as " +"triggers do banco de dados são usados para inicializar algumas propriedades " +"do objeto." -#: index.docbook:207 +#. Tag: programlisting +#: session_api.xml:207 +#, no-c-format msgid "" - "<![CDATA[sess.save(cat);\n" - "sess.flush(); //force the SQL INSERT\n" - "sess.refresh(cat); //re-read the state (after the trigger executes)]]>" +"<![CDATA[sess.save(cat);\n" +"sess.flush(); //force the SQL INSERT\n" +"sess.refresh(cat); //re-read the state (after the trigger executes)]]>" msgstr "" -#: index.docbook:209 -msgid "An important question usually appears at this point: How much does Hibernate load from the database and how many SQL <literal>SELECT</literal>s will it use? This depends on the <emphasis>fetching strategy</emphasis> and is explained in <xref linkend=\"performance-fetching\"/>." +#. Tag: para +#: session_api.xml:209 +#, no-c-format +msgid "" +"An important question usually appears at this point: How much does Hibernate " +"load from the database and how many SQL <literal>SELECT</literal>s will it " +"use? This depends on the <emphasis>fetching strategy</emphasis> and is " +"explained in <xref linkend=\"performance-fetching\"/>." msgstr "" +"Uma importante questão geralmente aparece neste ponto: O quanto Hibernate " +"carrega do banco de dados e quantos SQL <literal>SELECT</literal> ele irá " +"usar? Isto depende da estratégia de <emphasis>recuperação</emphasis>usada e " +"explicada na <xref linkend=\"performance-fetching\"/>." -#: index.docbook:219 +#. Tag: title +#: session_api.xml:219 +#, no-c-format msgid "Querying" -msgstr "" +msgstr "Consultando" -#: index.docbook:221 -msgid "If you don't know the identifiers of the objects you are looking for, you need a query. Hibernate supports an easy-to-use but powerful object oriented query language (HQL). For programmatic query creation, Hibernate supports a sophisticated Criteria and Example query feature (QBC and QBE). You may also express your query in the native SQL of your database, with optional support from Hibernate for result set conversion into objects." +#. Tag: para +#: session_api.xml:221 +#, no-c-format +msgid "" +"If you don't know the identifiers of the objects you are looking for, you " +"need a query. Hibernate supports an easy-to-use but powerful object oriented " +"query language (HQL). For programmatic query creation, Hibernate supports a " +"sophisticated Criteria and Example query feature (QBC and QBE). You may also " +"express your query in the native SQL of your database, with optional support " +"from Hibernate for result set conversion into objects." msgstr "" +"Se o identificador do objeto que se está buscando não for conhecido, uma " +"consulta será necessária. O Hibernate suporta uma linguagem de consulta " +"(HQL) orientada a objetos fácil mas poderosa. Para criação via programação " +"de consultas, o Hibernate suporta características sofisticadas de consulta " +"por Critério e Exemplo (QBCe QBE). Pode-se também expressar a consulta por " +"meio de SQL nativa do banco de dados, com suporte opcional do Hibernate para " +"conversão do conjunto de reultados em objetos." -#: index.docbook:231 +#. Tag: title +#: session_api.xml:231 +#, no-c-format msgid "Executing queries" -msgstr "" +msgstr "Executando consultas" -#: index.docbook:233 -msgid "HQL and native SQL queries are represented with an instance of <literal>org.hibernate.Query</literal>. This interface offers methods for parameter binding, result set handling, and for the execution of the actual query. You always obtain a <literal>Query</literal> using the current <literal>Session</literal>:" +#. Tag: para +#: session_api.xml:233 +#, no-c-format +msgid "" +"HQL and native SQL queries are represented with an instance of <literal>org." +"hibernate.Query</literal>. This interface offers methods for parameter " +"binding, result set handling, and for the execution of the actual query. You " +"always obtain a <literal>Query</literal> using the current <literal>Session</" +"literal>:" msgstr "" +"Consultas HQL e SQL nativa são representadas por uma instância de " +"<literal>org.hibernate.Query</literal>. Esta interface oferece métodos para " +"associação de parâmetros, tratamento de conjunto de resultados, e para a " +"execução de consultas reais. Você pode obter uma <literal>Query</literal> " +"usando a <literal>Session</literal> atual:" -#: index.docbook:240 +#. Tag: programlisting +#: session_api.xml:240 +#, no-c-format msgid "" - "<![CDATA[List cats = session.createQuery(\n" - " \"from Cat as cat where cat.birthdate < ?\")\n" - " .setDate(0, date)\n" - " .list();\n" - "\n" - "List mothers = session.createQuery(\n" - " \"select mother from Cat as cat join cat.mother as mother where cat.name = ?\")\n" - " .setString(0, name)\n" - " .list();\n" - "\n" - "List kittens = session.createQuery(\n" - " \"from Cat as cat where cat.mother = ?\")\n" - " .setEntity(0, pk)\n" - " .list();\n" - "\n" - "Cat mother = (Cat) session.createQuery(\n" - " \"select cat.mother from Cat as cat where cat = ?\")\n" - " .setEntity(0, izi)\n" - " .uniqueResult();]]\n" - "\n" - "Query mothersWithKittens = (Cat) session.createQuery(\n" - " \"select mother from Cat as mother left join fetch mother.kittens\");\n" - "Set uniqueMothers = new HashSet(mothersWithKittens.list());]]>" +"<![CDATA[List cats = session.createQuery(\n" +" \"from Cat as cat where cat.birthdate < ?\")\n" +" .setDate(0, date)\n" +" .list();\n" +"\n" +"List mothers = session.createQuery(\n" +" \"select mother from Cat as cat join cat.mother as mother where cat.name " +"= ?\")\n" +" .setString(0, name)\n" +" .list();\n" +"\n" +"List kittens = session.createQuery(\n" +" \"from Cat as cat where cat.mother = ?\")\n" +" .setEntity(0, pk)\n" +" .list();\n" +"\n" +"Cat mother = (Cat) session.createQuery(\n" +" \"select cat.mother from Cat as cat where cat = ?\")\n" +" .setEntity(0, izi)\n" +" .uniqueResult();]]\n" +"\n" +"Query mothersWithKittens = (Cat) session.createQuery(\n" +" \"select mother from Cat as mother left join fetch mother.kittens\");\n" +"Set uniqueMothers = new HashSet(mothersWithKittens.list());]]>" msgstr "" -#: index.docbook:242 -msgid "A query is usually executed by invoking <literal>list()</literal>, the result of the query will be loaded completely into a collection in memory. Entity instances retrieved by a query are in persistent state. The <literal>uniqueResult()</literal> method offers a shortcut if you know your query will only return a single object. Note that queries that make use of eager fetching of collections usually return duplicates of the root objects (but with their collections initialized). You can filter these duplicates simply through a <literal>Set</literal>." +#. Tag: para +#: session_api.xml:242 +#, no-c-format +msgid "" +"A query is usually executed by invoking <literal>list()</literal>, the " +"result of the query will be loaded completely into a collection in memory. " +"Entity instances retrieved by a query are in persistent state. The " +"<literal>uniqueResult()</literal> method offers a shortcut if you know your " +"query will only return a single object. Note that queries that make use of " +"eager fetching of collections usually return duplicates of the root objects " +"(but with their collections initialized). You can filter these duplicates " +"simply through a <literal>Set</literal>." msgstr "" +"Geralmente uma consulta é executada ao invocar <literal>list()</literal>, o " +"resultado da consulta será carregado completamente em uma coleção na " +"memória. Instâncias de entidades recuperadas por uma consulta estão no " +"estado persistente. O <literal>uniqueResult()</literal> oferece um atalho se " +"você souber de previamente que a consulta retornará apenas um único objeto. " +"Repare que consultas que fazem uso de buscas de coleções de forma ansiosa " +"(eager) geralmente retornam duplicatas dos objetos raiz ( mas com suas " +"coleções inicializadas ). Pode-se filtrar estas duplicatas através de um " +"simples <literal>Set</literal>." -#: index.docbook:254 +#. Tag: title +#: session_api.xml:254 +#, no-c-format msgid "Iterating results" -msgstr "" +msgstr "Interagindo com resultados" -#: index.docbook:256 -msgid "Occasionally, you might be able to achieve better performance by executing the query using the <literal>iterate()</literal> method. This will only usually be the case if you expect that the actual entity instances returned by the query will already be in the session or second-level cache. If they are not already cached, <literal>iterate()</literal> will be slower than <literal>list()</literal> and might require many database hits for a simple query, usually <emphasis>1</emphasis> for the initial select which only returns identifiers, and <emphasis>n</emphasis> additional selects to initialize the actual instances." +#. Tag: para +#: session_api.xml:256 +#, no-c-format +msgid "" +"Occasionally, you might be able to achieve better performance by executing " +"the query using the <literal>iterate()</literal> method. This will only " +"usually be the case if you expect that the actual entity instances returned " +"by the query will already be in the session or second-level cache. If they " +"are not already cached, <literal>iterate()</literal> will be slower than " +"<literal>list()</literal> and might require many database hits for a simple " +"query, usually <emphasis>1</emphasis> for the initial select which only " +"returns identifiers, and <emphasis>n</emphasis> additional selects to " +"initialize the actual instances." msgstr "" +"Ocasionalmente, deves-se ser capaz de atingir performances melhores com a " +"execução de consultas usando o método <literal>iterate()</literal>. " +"Geralmente isso será o caso esperado apenas se as instâncias dos entidades " +"reais retornadas pela consulta já estiverem na sessão ou no caché de segundo " +"nível. Caso elas ainda não tenham sido armazenadas, <literal>iterate()</" +"literal> será mais devagar do que <literal>list()</literal> e pode ser " +"necessário vários acessos ao banco de dados para um simples consulta, " +"geralmente <emphasis>1</emphasis> para a seleção inicial que retorna apenas " +"identificadores, e <emphasis>n</emphasis> consultas adicionais para " +"inicializar as instâncias reais." -#: index.docbook:268 +#. Tag: programlisting +#: session_api.xml:268 +#, no-c-format msgid "" - "<![CDATA[// fetch ids\n" - "Iterator iter = sess.createQuery(\"from eg.Qux q order by q.likeliness\").iterate();\n" - "while ( iter.hasNext() ) {\n" - " Qux qux = (Qux) iter.next(); // fetch the object\n" - " // something we couldnt express in the query\n" - " if ( qux.calculateComplicatedAlgorithm() ) {\n" - " // delete the current instance\n" - " iter.remove();\n" - " // dont need to process the rest\n" - " break;\n" - " }\n" - "}]]>" +"<![CDATA[// fetch ids\n" +"Iterator iter = sess.createQuery(\"from eg.Qux q order by q.likeliness\")." +"iterate();\n" +"while ( iter.hasNext() ) {\n" +" Qux qux = (Qux) iter.next(); // fetch the object\n" +" // something we couldnt express in the query\n" +" if ( qux.calculateComplicatedAlgorithm() ) {\n" +" // delete the current instance\n" +" iter.remove();\n" +" // dont need to process the rest\n" +" break;\n" +" }\n" +"}]]>" msgstr "" -#: index.docbook:272 +#. Tag: title +#: session_api.xml:272 +#, no-c-format msgid "Queries that return tuples" -msgstr "" +msgstr "Consultas que retornam tuplas" -#: index.docbook:274 -msgid "Hibernate queries sometimes return tuples of objects, in which case each tuple is returned as an array:" +#. Tag: para +#: session_api.xml:274 +#, no-c-format +msgid "" +"Hibernate queries sometimes return tuples of objects, in which case each " +"tuple is returned as an array:" msgstr "" +"Algumas vezes as consultas do Hibernate retornam tuplas de objetos, nesse " +"caso cada tupla é retornada como um array:" -#: index.docbook:279 +#. Tag: programlisting +#: session_api.xml:279 +#, no-c-format msgid "" - "<![CDATA[Iterator kittensAndMothers = sess.createQuery(\n" - " \"select kitten, mother from Cat kitten join kitten.mother mother\")\n" - " .list()\n" - " .iterator();\n" - "\n" - "while ( kittensAndMothers.hasNext() ) {\n" - " Object[] tuple = (Object[]) kittensAndMothers.next();\n" - " Cat kitten = (Cat) tuple[0];\n" - " Cat mother = (Cat) tuple[1];\n" - " ....\n" - "}]]>" +"<![CDATA[Iterator kittensAndMothers = sess.createQuery(\n" +" \"select kitten, mother from Cat kitten join kitten.mother mother" +"\")\n" +" .list()\n" +" .iterator();\n" +"\n" +"while ( kittensAndMothers.hasNext() ) {\n" +" Object[] tuple = (Object[]) kittensAndMothers.next();\n" +" Cat kitten = (Cat) tuple[0];\n" +" Cat mother = (Cat) tuple[1];\n" +" ....\n" +"}]]>" msgstr "" -#: index.docbook:284 +#. Tag: title +#: session_api.xml:284 +#, no-c-format msgid "Scalar results" -msgstr "" +msgstr "Resultados escalares" -#: index.docbook:286 -msgid "Queries may specify a property of a class in the <literal>select</literal> clause. They may even call SQL aggregate functions. Properties or aggregates are considered \"scalar\" results (and not entities in persistent state)." +#. Tag: para +#: session_api.xml:286 +#, no-c-format +msgid "" +"Queries may specify a property of a class in the <literal>select</literal> " +"clause. They may even call SQL aggregate functions. Properties or aggregates " +"are considered \"scalar\" results (and not entities in persistent state)." msgstr "" +"Consultas devem especificar uma propriedade da classe na clausula " +"<literal>select</literal>. Elas também podem chamar funções SQL de " +"agregaçãos. Propriedades ou agregações são considerados resultados agregados " +"( e não entidades no estado persistente)." -#: index.docbook:292 +#. Tag: programlisting +#: session_api.xml:292 +#, no-c-format msgid "" - "<![CDATA[Iterator results = sess.createQuery(\n" - " \"select cat.color, min(cat.birthdate), count(cat) from Cat cat \" +\n" - " \"group by cat.color\")\n" - " .list()\n" - " .iterator();\n" - "\n" - "while ( results.hasNext() ) {\n" - " Object[] row = (Object[]) results.next();\n" - " Color type = (Color) row[0];\n" - " Date oldest = (Date) row[1];\n" - " Integer count = (Integer) row[2];\n" - " .....\n" - "}]]>" +"<![CDATA[Iterator results = sess.createQuery(\n" +" \"select cat.color, min(cat.birthdate), count(cat) from Cat cat \" " +"+\n" +" \"group by cat.color\")\n" +" .list()\n" +" .iterator();\n" +"\n" +"while ( results.hasNext() ) {\n" +" Object[] row = (Object[]) results.next();\n" +" Color type = (Color) row[0];\n" +" Date oldest = (Date) row[1];\n" +" Integer count = (Integer) row[2];\n" +" .....\n" +"}]]>" msgstr "" -#: index.docbook:297 +#. Tag: title +#: session_api.xml:297 +#, no-c-format msgid "Bind parameters" -msgstr "" +msgstr "Bind parameters" -#: index.docbook:299 -msgid "Methods on <literal>Query</literal> are provided for binding values to named parameters or JDBC-style <literal>?</literal> parameters. <emphasis>Contrary to JDBC, Hibernate numbers parameters from zero.</emphasis> Named parameters are identifiers of the form <literal>:name</literal> in the query string. The advantages of named parameters are:" +#. Tag: para +#: session_api.xml:299 +#, no-c-format +msgid "" +"Methods on <literal>Query</literal> are provided for binding values to named " +"parameters or JDBC-style <literal>?</literal> parameters. <emphasis>Contrary " +"to JDBC, Hibernate numbers parameters from zero.</emphasis> Named parameters " +"are identifiers of the form <literal>:name</literal> in the query string. " +"The advantages of named parameters are:" msgstr "" +"Methods on <literal>Query</literal> are provided for binding values to named " +"parameters or JDBC-style <literal>?</literal> parameters. <emphasis>Contrary " +"to JDBC, Hibernate numbers parameters from zero.</emphasis> Named parameters " +"are identifiers of the form <literal>:name</literal> in the query string. " +"The advantages of named parameters are:" -#: index.docbook:309 -msgid "named parameters are insensitive to the order they occur in the query string" +#. Tag: para +#: session_api.xml:309 +#, no-c-format +msgid "" +"named parameters are insensitive to the order they occur in the query string" msgstr "" +"named parameters are insensitive to the order they occur in the query string" -#: index.docbook:315 +#. Tag: para +#: session_api.xml:315 +#, no-c-format msgid "they may occur multiple times in the same query" -msgstr "" +msgstr "they may occur multiple times in the same query" -#: index.docbook:320 +#. Tag: para +#: session_api.xml:320 +#, no-c-format msgid "they are self-documenting" -msgstr "" +msgstr "they are self-documenting" -#: index.docbook:326 +#. Tag: programlisting +#: session_api.xml:326 +#, no-c-format msgid "" - "<![CDATA[//named parameter (preferred)\n" - "Query q = sess.createQuery(\"from DomesticCat cat where cat.name = :name\");\n" - "q.setString(\"name\", \"Fritz\");\n" - "Iterator cats = q.iterate();]]>" +"<![CDATA[//named parameter (preferred)\n" +"Query q = sess.createQuery(\"from DomesticCat cat where cat.name = :name" +"\");\n" +"q.setString(\"name\", \"Fritz\");\n" +"Iterator cats = q.iterate();]]>" msgstr "" -#: index.docbook:328 +#. Tag: programlisting +#: session_api.xml:328 +#, no-c-format msgid "" - "<![CDATA[//positional parameter\n" - "Query q = sess.createQuery(\"from DomesticCat cat where cat.name = ?\");\n" - "q.setString(0, \"Izi\");\n" - "Iterator cats = q.iterate();]]>" +"<![CDATA[//positional parameter\n" +"Query q = sess.createQuery(\"from DomesticCat cat where cat.name = ?\");\n" +"q.setString(0, \"Izi\");\n" +"Iterator cats = q.iterate();]]>" msgstr "" -#: index.docbook:330 +#. Tag: programlisting +#: session_api.xml:330 +#, no-c-format msgid "" - "<![CDATA[//named parameter list\n" - "List names = new ArrayList();\n" - "names.add(\"Izi\");\n" - "names.add(\"Fritz\");\n" - "Query q = sess.createQuery(\"from DomesticCat cat where cat.name in (:namesList)\");\n" - "q.setParameterList(\"namesList\", names);\n" - "List cats = q.list();]]>" +"<![CDATA[//named parameter list\n" +"List names = new ArrayList();\n" +"names.add(\"Izi\");\n" +"names.add(\"Fritz\");\n" +"Query q = sess.createQuery(\"from DomesticCat cat where cat.name in (:" +"namesList)\");\n" +"q.setParameterList(\"namesList\", names);\n" +"List cats = q.list();]]>" msgstr "" -#: index.docbook:335 +#. Tag: title +#: session_api.xml:335 +#, no-c-format msgid "Pagination" -msgstr "" +msgstr "Pagination" -#: index.docbook:337 -msgid "If you need to specify bounds upon your result set (the maximum number of rows you want to retrieve and / or the first row you want to retrieve) you should use methods of the <literal>Query</literal> interface:" +#. Tag: para +#: session_api.xml:337 +#, no-c-format +msgid "" +"If you need to specify bounds upon your result set (the maximum number of " +"rows you want to retrieve and / or the first row you want to retrieve) you " +"should use methods of the <literal>Query</literal> interface:" msgstr "" +"If you need to specify bounds upon your result set (the maximum number of " +"rows you want to retrieve and / or the first row you want to retrieve) you " +"should use methods of the <literal>Query</literal> interface:" -#: index.docbook:343 +#. Tag: programlisting +#: session_api.xml:343 +#, no-c-format msgid "" - "<![CDATA[Query q = sess.createQuery(\"from DomesticCat cat\");\n" - "q.setFirstResult(20);\n" - "q.setMaxResults(10);\n" - "List cats = q.list();]]>" +"<![CDATA[Query q = sess.createQuery(\"from DomesticCat cat\");\n" +"q.setFirstResult(20);\n" +"q.setMaxResults(10);\n" +"List cats = q.list();]]>" msgstr "" -#: index.docbook:345 -msgid "Hibernate knows how to translate this limit query into the native SQL of your DBMS." +#. Tag: para +#: session_api.xml:345 +#, no-c-format +msgid "" +"Hibernate knows how to translate this limit query into the native SQL of " +"your DBMS." msgstr "" +"Hibernate knows how to translate this limit query into the native SQL of " +"your DBMS." -#: index.docbook:353 +#. Tag: title +#: session_api.xml:353 +#, no-c-format msgid "Scrollable iteration" -msgstr "" +msgstr "Scrollable iteration" -#: index.docbook:355 -msgid "If your JDBC driver supports scrollable <literal>ResultSet</literal>s, the <literal>Query</literal> interface may be used to obtain a <literal>ScrollableResults</literal> object, which allows flexible navigation of the query results." +#. Tag: para +#: session_api.xml:355 +#, no-c-format +msgid "" +"If your JDBC driver supports scrollable <literal>ResultSet</literal>s, the " +"<literal>Query</literal> interface may be used to obtain a " +"<literal>ScrollableResults</literal> object, which allows flexible " +"navigation of the query results." msgstr "" +"If your JDBC driver supports scrollable <literal>ResultSet</literal>s, the " +"<literal>Query</literal> interface may be used to obtain a " +"<literal>ScrollableResults</literal> object, which allows flexible " +"navigation of the query results." -#: index.docbook:362 +#. Tag: programlisting +#: session_api.xml:362 +#, no-c-format msgid "" - "<![CDATA[Query q = sess.createQuery(\"select cat.name, cat from DomesticCat cat \" +\n" - " \"order by cat.name\");\n" - "ScrollableResults cats = q.scroll();\n" - "if ( cats.first() ) {\n" - "\n" - " // find the first name on each page of an alphabetical list of cats by name\n" - " firstNamesOfPages = new ArrayList();\n" - " do {\n" - " String name = cats.getString(0);\n" - " firstNamesOfPages.add(name);\n" - " }\n" - " while ( cats.scroll(PAGE_SIZE) );\n" - "\n" - " // Now get the first page of cats\n" - " pageOfCats = new ArrayList();\n" - " cats.beforeFirst();\n" - " int i=0;\n" - " while( ( PAGE_SIZE > i++ ) && cats.next() ) pageOfCats.add( cats.get(1) );\n" - "\n" - "}\n" - "cats.close()]]>" +"<![CDATA[Query q = sess.createQuery(\"select cat.name, cat from DomesticCat " +"cat \" +\n" +" \"order by cat.name\");\n" +"ScrollableResults cats = q.scroll();\n" +"if ( cats.first() ) {\n" +"\n" +" // find the first name on each page of an alphabetical list of cats by " +"name\n" +" firstNamesOfPages = new ArrayList();\n" +" do {\n" +" String name = cats.getString(0);\n" +" firstNamesOfPages.add(name);\n" +" }\n" +" while ( cats.scroll(PAGE_SIZE) );\n" +"\n" +" // Now get the first page of cats\n" +" pageOfCats = new ArrayList();\n" +" cats.beforeFirst();\n" +" int i=0;\n" +" while( ( PAGE_SIZE > i++ ) && cats.next() ) pageOfCats.add( cats.get" +"(1) );\n" +"\n" +"}\n" +"cats.close()]]>" msgstr "" -#: index.docbook:364 -msgid "Note that an open database connection (and cursor) is required for this functionality, use <literal>setMaxResult()</literal>/<literal>setFirstResult()</literal> if you need offline pagination functionality." +#. Tag: para +#: session_api.xml:364 +#, no-c-format +msgid "" +"Note that an open database connection (and cursor) is required for this " +"functionality, use <literal>setMaxResult()</literal>/<literal>setFirstResult" +"()</literal> if you need offline pagination functionality." msgstr "" +"Note that an open database connection (and cursor) is required for this " +"functionality, use <literal>setMaxResult()</literal>/<literal>setFirstResult" +"()</literal> if you need offline pagination functionality." -#: index.docbook:373 +#. Tag: title +#: session_api.xml:373 +#, no-c-format msgid "Externalizing named queries" -msgstr "" +msgstr "Externalizing named queries" -#: index.docbook:375 -msgid "You may also define named queries in the mapping document. (Remember to use a <literal>CDATA</literal> section if your query contains characters that could be interpreted as markup.)" +#. Tag: para +#: session_api.xml:375 +#, no-c-format +msgid "" +"You may also define named queries in the mapping document. (Remember to use " +"a <literal>CDATA</literal> section if your query contains characters that " +"could be interpreted as markup.)" msgstr "" +"You may also define named queries in the mapping document. (Remember to use " +"a <literal>CDATA</literal> section if your query contains characters that " +"could be interpreted as markup.)" -#: index.docbook:381 +#. Tag: programlisting +#: session_api.xml:381 +#, no-c-format msgid "" - "<![CDATA[<query name=\"ByNameAndMaximumWeight\"><![CDATA[\n" - " from eg.DomesticCat as cat\n" - " where cat.name = ?\n" - " and cat.weight > ?\n" - "] ]></query>]]>" +"<![CDATA[<query name=\"ByNameAndMaximumWeight\"><![CDATA[\n" +" from eg.DomesticCat as cat\n" +" where cat.name = ?\n" +" and cat.weight > ?\n" +"] ]></query>]]>" msgstr "" -#: index.docbook:383 +#. Tag: para +#: session_api.xml:383 +#, no-c-format msgid "Parameter binding and executing is done programatically:" -msgstr "" +msgstr "Parameter binding and executing is done programatically:" -#: index.docbook:387 +#. Tag: programlisting +#: session_api.xml:387 +#, no-c-format msgid "" - "<![CDATA[Query q = sess.getNamedQuery(\"ByNameAndMaximumWeight\");\n" - "q.setString(0, name);\n" - "q.setInt(1, minWeight);\n" - "List cats = q.list();]]>" +"<![CDATA[Query q = sess.getNamedQuery(\"ByNameAndMaximumWeight\");\n" +"q.setString(0, name);\n" +"q.setInt(1, minWeight);\n" +"List cats = q.list();]]>" msgstr "" -#: index.docbook:389 -msgid "Note that the actual program code is independent of the query language that is used, you may also define native SQL queries in metadata, or migrate existing queries to Hibernate by placing them in mapping files." +#. Tag: para +#: session_api.xml:389 +#, no-c-format +msgid "" +"Note that the actual program code is independent of the query language that " +"is used, you may also define native SQL queries in metadata, or migrate " +"existing queries to Hibernate by placing them in mapping files." msgstr "" +"Note that the actual program code is independent of the query language that " +"is used, you may also define native SQL queries in metadata, or migrate " +"existing queries to Hibernate by placing them in mapping files." -#: index.docbook:395 -msgid "Also note that a query declaration inside a <literal><hibernate-mapping></literal> element requires a global unique name for the query, while a query declaration inside a <literal><class></literal> element is made unique automatically by prepending the fully qualified name of the class, for example <literal>eg.Cat.ByNameAndMaximumWeight</literal>." +#. Tag: para +#: session_api.xml:395 +#, no-c-format +msgid "" +"Also note that a query declaration inside a <literal><hibernate-" +"mapping></literal> element requires a global unique name for the query, " +"while a query declaration inside a <literal><class></literal> element " +"is made unique automatically by prepending the fully qualified name of the " +"class, for example <literal>eg.Cat.ByNameAndMaximumWeight</literal>." msgstr "" +"Also note that a query declaration inside a <literal><hibernate-" +"mapping></literal> element requires a global unique name for the query, " +"while a query declaration inside a <literal><class></literal> element " +"is made unique automatically by prepending the fully qualified name of the " +"class, for example <literal>eg.Cat.ByNameAndMaximumWeight</literal>." -#: index.docbook:408 +#. Tag: title +#: session_api.xml:408 +#, no-c-format msgid "Filtering collections" -msgstr "" +msgstr "Filtering collections" -#: index.docbook:409 -msgid "A collection <emphasis>filter</emphasis> is a special type of query that may be applied to a persistent collection or array. The query string may refer to <literal>this</literal>, meaning the current collection element." +#. Tag: para +#: session_api.xml:409 +#, no-c-format +msgid "" +"A collection <emphasis>filter</emphasis> is a special type of query that may " +"be applied to a persistent collection or array. The query string may refer " +"to <literal>this</literal>, meaning the current collection element." msgstr "" +"A collection <emphasis>filter</emphasis> is a special type of query that may " +"be applied to a persistent collection or array. The query string may refer " +"to <literal>this</literal>, meaning the current collection element." -#: index.docbook:415 +#. Tag: programlisting +#: session_api.xml:415 +#, no-c-format msgid "" - "<![CDATA[Collection blackKittens = session.createFilter(\n" - " pk.getKittens(), \n" - " \"where this.color = ?\")\n" - " .setParameter( Color.BLACK, Hibernate.custom(ColorUserType.class) )\n" - " .list()\n" - ");]]>" +"<![CDATA[Collection blackKittens = session.createFilter(\n" +" pk.getKittens(), \n" +" \"where this.color = ?\")\n" +" .setParameter( Color.BLACK, Hibernate.custom(ColorUserType.class) )\n" +" .list()\n" +");]]>" msgstr "" -#: index.docbook:417 -msgid "The returned collection is considered a bag, and it's a copy of the given collection. The original collection is not modified (this is contrary to the implication of the name \"filter\", but consistent with expected behavior)." +#. Tag: para +#: session_api.xml:417 +#, no-c-format +msgid "" +"The returned collection is considered a bag, and it's a copy of the given " +"collection. The original collection is not modified (this is contrary to the " +"implication of the name \"filter\", but consistent with expected behavior)." msgstr "" +"The returned collection is considered a bag, and it's a copy of the given " +"collection. The original collection is not modified (this is contrary to the " +"implication of the name \"filter\", but consistent with expected behavior)." -#: index.docbook:423 -msgid "Observe that filters do not require a <literal>from</literal> clause (though they may have one if required). Filters are not limited to returning the collection elements themselves." +#. Tag: para +#: session_api.xml:423 +#, no-c-format +msgid "" +"Observe that filters do not require a <literal>from</literal> clause (though " +"they may have one if required). Filters are not limited to returning the " +"collection elements themselves." msgstr "" +"Observe that filters do not require a <literal>from</literal> clause (though " +"they may have one if required). Filters are not limited to returning the " +"collection elements themselves." -#: index.docbook:428 +#. Tag: programlisting +#: session_api.xml:428 +#, no-c-format msgid "" - "<![CDATA[Collection blackKittenMates = session.createFilter(\n" - " pk.getKittens(), \n" - " \"select this.mate where this.color = eg.Color.BLACK.intValue\")\n" - " .list();]]>" +"<![CDATA[Collection blackKittenMates = session.createFilter(\n" +" pk.getKittens(), \n" +" \"select this.mate where this.color = eg.Color.BLACK.intValue\")\n" +" .list();]]>" msgstr "" -#: index.docbook:430 -msgid "Even an empty filter query is useful, e.g. to load a subset of elements in a huge collection:" +#. Tag: para +#: session_api.xml:430 +#, no-c-format +msgid "" +"Even an empty filter query is useful, e.g. to load a subset of elements in a " +"huge collection:" msgstr "" +"Even an empty filter query is useful, e.g. to load a subset of elements in a " +"huge collection:" -#: index.docbook:435 +#. Tag: programlisting +#: session_api.xml:435 +#, no-c-format msgid "" - "<![CDATA[Collection tenKittens = session.createFilter(\n" - " mother.getKittens(), \"\")\n" - " .setFirstResult(0).setMaxResults(10)\n" - " .list();]]>" +"<![CDATA[Collection tenKittens = session.createFilter(\n" +" mother.getKittens(), \"\")\n" +" .setFirstResult(0).setMaxResults(10)\n" +" .list();]]>" msgstr "" -#: index.docbook:440 +#. Tag: title +#: session_api.xml:440 +#, no-c-format msgid "Criteria queries" -msgstr "" +msgstr "Criteria queries" -#: index.docbook:442 -msgid "HQL is extremely powerful but some developers prefer to build queries dynamically, using an object-oriented API, rather than building query strings. Hibernate provides an intuitive <literal>Criteria</literal> query API for these cases:" +#. Tag: para +#: session_api.xml:442 +#, no-c-format +msgid "" +"HQL is extremely powerful but some developers prefer to build queries " +"dynamically, using an object-oriented API, rather than building query " +"strings. Hibernate provides an intuitive <literal>Criteria</literal> query " +"API for these cases:" msgstr "" +"HQL is extremely powerful but some developers prefer to build queries " +"dynamically, using an object-oriented API, rather than building query " +"strings. Hibernate provides an intuitive <literal>Criteria</literal> query " +"API for these cases:" -#: index.docbook:448 +#. Tag: programlisting +#: session_api.xml:448 +#, no-c-format msgid "" - "<![CDATA[Criteria crit = session.createCriteria(Cat.class);\n" - "crit.add( Restrictions.eq( \"color\", eg.Color.BLACK ) );\n" - "crit.setMaxResults(10);\n" - "List cats = crit.list();]]>" +"<![CDATA[Criteria crit = session.createCriteria(Cat.class);\n" +"crit.add( Restrictions.eq( \"color\", eg.Color.BLACK ) );\n" +"crit.setMaxResults(10);\n" +"List cats = crit.list();]]>" msgstr "" -#: index.docbook:450 -msgid "The <literal>Criteria</literal> and the associated <literal>Example</literal> API are discussed in more detail in <xref linkend=\"querycriteria\"/>." +#. Tag: para +#: session_api.xml:450 +#, no-c-format +msgid "" +"The <literal>Criteria</literal> and the associated <literal>Example</" +"literal> API are discussed in more detail in <xref linkend=\"querycriteria\"/" +">." msgstr "" +"The <literal>Criteria</literal> and the associated <literal>Example</" +"literal> API are discussed in more detail in <xref linkend=\"querycriteria\"/" +">." -#: index.docbook:458 +#. Tag: title +#: session_api.xml:458 +#, no-c-format msgid "Queries in native SQL" -msgstr "" +msgstr "Queries in native SQL" -#: index.docbook:460 -msgid "You may express a query in SQL, using <literal>createSQLQuery()</literal> and let Hibernate take care of the mapping from result sets to objects. Note that you may at any time call <literal>session.connection()</literal> and use the JDBC <literal>Connection</literal> directly. If you chose to use the Hibernate API, you must enclose SQL aliases in braces:" +#. Tag: para +#: session_api.xml:460 +#, no-c-format +msgid "" +"You may express a query in SQL, using <literal>createSQLQuery()</literal> " +"and let Hibernate take care of the mapping from result sets to objects. Note " +"that you may at any time call <literal>session.connection()</literal> and " +"use the JDBC <literal>Connection</literal> directly. If you chose to use the " +"Hibernate API, you must enclose SQL aliases in braces:" msgstr "" +"You may express a query in SQL, using <literal>createSQLQuery()</literal> " +"and let Hibernate take care of the mapping from result sets to objects. Note " +"that you may at any time call <literal>session.connection()</literal> and " +"use the JDBC <literal>Connection</literal> directly. If you chose to use the " +"Hibernate API, you must enclose SQL aliases in braces:" -#: index.docbook:468 +#. Tag: programlisting +#: session_api.xml:468 +#, no-c-format msgid "" - "<![CDATA[List cats = session.createSQLQuery(\"SELECT {cat.*} FROM CAT {cat} WHERE ROWNUM<10\")\n" - " .addEntity(\"cat\", Cat.class)\n" - ".list();]]>" +"<![CDATA[List cats = session.createSQLQuery(\"SELECT {cat.*} FROM CAT {cat} " +"WHERE ROWNUM<10\")\n" +" .addEntity(\"cat\", Cat.class)\n" +".list();]]>" msgstr "" -#: index.docbook:470 +#. Tag: programlisting +#: session_api.xml:470 +#, no-c-format msgid "" - "<![CDATA[List cats = session.createSQLQuery(\n" - " \"SELECT {cat}.ID AS {cat.id}, {cat}.SEX AS {cat.sex}, \" +\n" - " \"{cat}.MATE AS {cat.mate}, {cat}.SUBCLASS AS {cat.class}, ... \" +\n" - " \"FROM CAT {cat} WHERE ROWNUM<10\")\n" - " .addEntity(\"cat\", Cat.class)\n" - ".list()]]>" +"<![CDATA[List cats = session.createSQLQuery(\n" +" \"SELECT {cat}.ID AS {cat.id}, {cat}.SEX AS {cat.sex}, \" +\n" +" \"{cat}.MATE AS {cat.mate}, {cat}.SUBCLASS AS {cat.class}, ... \" " +"+\n" +" \"FROM CAT {cat} WHERE ROWNUM<10\")\n" +" .addEntity(\"cat\", Cat.class)\n" +".list()]]>" msgstr "" -#: index.docbook:472 -msgid "SQL queries may contain named and positional parameters, just like Hibernate queries. More information about native SQL queries in Hibernate can be found in <xref linkend=\"querysql\"/>." +#. Tag: para +#: session_api.xml:472 +#, no-c-format +msgid "" +"SQL queries may contain named and positional parameters, just like Hibernate " +"queries. More information about native SQL queries in Hibernate can be found " +"in <xref linkend=\"querysql\"/>." msgstr "" +"SQL queries may contain named and positional parameters, just like Hibernate " +"queries. More information about native SQL queries in Hibernate can be found " +"in <xref linkend=\"querysql\"/>." -#: index.docbook:483 +#. Tag: title +#: session_api.xml:483 +#, no-c-format msgid "Modifying persistent objects" -msgstr "" +msgstr "Modifying persistent objects" -#: index.docbook:485 -msgid "<emphasis>Transactional persistent instances</emphasis> (ie. objects loaded, saved, created or queried by the <literal>Session</literal>) may be manipulated by the application and any changes to persistent state will be persisted when the <literal>Session</literal> is <emphasis>flushed</emphasis> (discussed later in this chapter). There is no need to call a particular method (like <literal>update()</literal>, which has a different purpose) to make your modifications persistent. So the most straightforward way to update the state of an object is to <literal>load()</literal> it, and then manipulate it directly, while the <literal>Session</literal> is open:" +#. Tag: para +#: session_api.xml:485 +#, no-c-format +msgid "" +"<emphasis>Transactional persistent instances</emphasis> (ie. objects loaded, " +"saved, created or queried by the <literal>Session</literal>) may be " +"manipulated by the application and any changes to persistent state will be " +"persisted when the <literal>Session</literal> is <emphasis>flushed</" +"emphasis> (discussed later in this chapter). There is no need to call a " +"particular method (like <literal>update()</literal>, which has a different " +"purpose) to make your modifications persistent. So the most straightforward " +"way to update the state of an object is to <literal>load()</literal> it, and " +"then manipulate it directly, while the <literal>Session</literal> is open:" msgstr "" +"<emphasis>Transactional persistent instances</emphasis> (ie. objects loaded, " +"saved, created or queried by the <literal>Session</literal>) may be " +"manipulated by the application and any changes to persistent state will be " +"persisted when the <literal>Session</literal> is <emphasis>flushed</" +"emphasis> (discussed later in this chapter). There is no need to call a " +"particular method (like <literal>update()</literal>, which has a different " +"purpose) to make your modifications persistent. So the most straightforward " +"way to update the state of an object is to <literal>load()</literal> it, and " +"then manipulate it directly, while the <literal>Session</literal> is open:" -#: index.docbook:496 +#. Tag: programlisting +#: session_api.xml:496 +#, no-c-format msgid "" - "<![CDATA[DomesticCat cat = (DomesticCat) sess.load( Cat.class, new Long(69) );\n" - "cat.setName(\"PK\");\n" - "sess.flush(); // changes to cat are automatically detected and persisted]]>" +"<![CDATA[DomesticCat cat = (DomesticCat) sess.load( Cat.class, new Long" +"(69) );\n" +"cat.setName(\"PK\");\n" +"sess.flush(); // changes to cat are automatically detected and persisted]]>" msgstr "" -#: index.docbook:498 -msgid "Sometimes this programming model is inefficient since it would require both an SQL <literal>SELECT</literal> (to load an object) and an SQL <literal>UPDATE</literal> (to persist its updated state) in the same session. Therefore Hibernate offers an alternate approach, using detached instances." +#. Tag: para +#: session_api.xml:498 +#, no-c-format +msgid "" +"Sometimes this programming model is inefficient since it would require both " +"an SQL <literal>SELECT</literal> (to load an object) and an SQL " +"<literal>UPDATE</literal> (to persist its updated state) in the same " +"session. Therefore Hibernate offers an alternate approach, using detached " +"instances." msgstr "" +"Sometimes this programming model is inefficient since it would require both " +"an SQL <literal>SELECT</literal> (to load an object) and an SQL " +"<literal>UPDATE</literal> (to persist its updated state) in the same " +"session. Therefore Hibernate offers an alternate approach, using detached " +"instances." -#: index.docbook:506 -msgid "Note that Hibernate does not offer its own API for direct execution of <literal>UPDATE</literal> or <literal>DELETE</literal> statements. Hibernate is a <emphasis>state management</emphasis> service, you don't have to think in <emphasis>statements</emphasis> to use it. JDBC is a perfect API for executing SQL statements, you can get a JDBC <literal>Connection</literal> at any time by calling <literal>session.connection()</literal>. Furthermore, the notion of mass operations conflicts with object/relational mapping for online transaction processing-oriented applications. Future versions of Hibernate may however provide special mass operation functions. See <xref linkend=\"batch\"/> for some possible batch operation tricks." +#. Tag: emphasis +#: session_api.xml:506 +#, fuzzy, no-c-format +msgid "" +"Note that Hibernate does not offer its own API for direct execution of " +"<literal>UPDATE</literal> or <literal>DELETE</literal> statements. Hibernate " +"is a <emphasis>state management</emphasis> service, you don't have to think " +"in <emphasis>statements</emphasis> to use it. JDBC is a perfect API for " +"executing SQL statements, you can get a JDBC <literal>Connection</literal> " +"at any time by calling <literal>session.connection()</literal>. Furthermore, " +"the notion of mass operations conflicts with object/relational mapping for " +"online transaction processing-oriented applications. Future versions of " +"Hibernate may however provide special mass operation functions. See <xref " +"linkend=\"batch\"/> for some possible batch operation tricks." msgstr "" +"Note that Hibernate does not offer its own API for direct execution of " +"<placeholder-1/> or <placeholder-2/> statements. Hibernate is a <placeholder-" +"3/> service, you don't have to think in <placeholder-4/> to use it. JDBC is " +"a perfect API for executing SQL statements, you can get a JDBC <placeholder-" +"5/> at any time by calling <placeholder-6/>. Furthermore, the notion of mass " +"operations conflicts with object/relational mapping for online transaction " +"processing-oriented applications. Future versions of Hibernate may however " +"provide special mass operation functions. See <xref linkend=\"batch\"/> for " +"some possible batch operation tricks." -#: index.docbook:521 +#. Tag: title +#: session_api.xml:521 +#, no-c-format msgid "Modifying detached objects" -msgstr "" +msgstr "Modifying detached objects" -#: index.docbook:523 -msgid "Many applications need to retrieve an object in one transaction, send it to the UI layer for manipulation, then save the changes in a new transaction. Applications that use this kind of approach in a high-concurrency environment usually use versioned data to ensure isolation for the \"long\" unit of work." +#. Tag: para +#: session_api.xml:523 +#, no-c-format +msgid "" +"Many applications need to retrieve an object in one transaction, send it to " +"the UI layer for manipulation, then save the changes in a new transaction. " +"Applications that use this kind of approach in a high-concurrency " +"environment usually use versioned data to ensure isolation for the \"long\" " +"unit of work." msgstr "" +"Many applications need to retrieve an object in one transaction, send it to " +"the UI layer for manipulation, then save the changes in a new transaction. " +"Applications that use this kind of approach in a high-concurrency " +"environment usually use versioned data to ensure isolation for the \"long\" " +"unit of work." -#: index.docbook:530 -msgid "Hibernate supports this model by providing for reattachment of detached instances using the <literal>Session.update()</literal> or <literal>Session.merge()</literal> methods:" +#. Tag: para +#: session_api.xml:530 +#, no-c-format +msgid "" +"Hibernate supports this model by providing for reattachment of detached " +"instances using the <literal>Session.update()</literal> or <literal>Session." +"merge()</literal> methods:" msgstr "" +"Hibernate supports this model by providing for reattachment of detached " +"instances using the <literal>Session.update()</literal> or <literal>Session." +"merge()</literal> methods:" -#: index.docbook:536 +#. Tag: programlisting +#: session_api.xml:536 +#, no-c-format msgid "" - "<![CDATA[// in the first session\n" - "Cat cat = (Cat) firstSession.load(Cat.class, catId);\n" - "Cat potentialMate = new Cat();\n" - "firstSession.save(potentialMate);\n" - "\n" - "// in a higher layer of the application\n" - "cat.setMate(potentialMate);\n" - "\n" - "// later, in a new session\n" - "secondSession.update(cat); // update cat\n" - "secondSession.update(mate); // update mate]]>" +"<![CDATA[// in the first session\n" +"Cat cat = (Cat) firstSession.load(Cat.class, catId);\n" +"Cat potentialMate = new Cat();\n" +"firstSession.save(potentialMate);\n" +"\n" +"// in a higher layer of the application\n" +"cat.setMate(potentialMate);\n" +"\n" +"// later, in a new session\n" +"secondSession.update(cat); // update cat\n" +"secondSession.update(mate); // update mate]]>" msgstr "" -#: index.docbook:538 -msgid "If the <literal>Cat</literal> with identifier <literal>catId</literal> had already been loaded by <literal>secondSession</literal> when the application tried to reattach it, an exception would have been thrown." +#. Tag: para +#: session_api.xml:538 +#, no-c-format +msgid "" +"If the <literal>Cat</literal> with identifier <literal>catId</literal> had " +"already been loaded by <literal>secondSession</literal> when the application " +"tried to reattach it, an exception would have been thrown." msgstr "" +"If the <literal>Cat</literal> with identifier <literal>catId</literal> had " +"already been loaded by <literal>secondSession</literal> when the application " +"tried to reattach it, an exception would have been thrown." -#: index.docbook:544 -msgid "Use <literal>update()</literal> if you are sure that the session does not contain an already persistent instance with the same identifier, and <literal>merge()</literal> if you want to merge your modifications at any time without consideration of the state of the session. In other words, <literal>update()</literal> is usually the first method you would call in a fresh session, ensuring that reattachment of your detached instances is the first operation that is executed." +#. Tag: para +#: session_api.xml:544 +#, no-c-format +msgid "" +"Use <literal>update()</literal> if you are sure that the session does not " +"contain an already persistent instance with the same identifier, and " +"<literal>merge()</literal> if you want to merge your modifications at any " +"time without consideration of the state of the session. In other words, " +"<literal>update()</literal> is usually the first method you would call in a " +"fresh session, ensuring that reattachment of your detached instances is the " +"first operation that is executed." msgstr "" +"Use <literal>update()</literal> if you are sure that the session does not " +"contain an already persistent instance with the same identifier, and " +"<literal>merge()</literal> if you want to merge your modifications at any " +"time without consideration of the state of the session. In other words, " +"<literal>update()</literal> is usually the first method you would call in a " +"fresh session, ensuring that reattachment of your detached instances is the " +"first operation that is executed." -#: index.docbook:553 -msgid "The application should individually <literal>update()</literal> detached instances reachable from the given detached instance if and <emphasis>only</emphasis> if it wants their state also updated. This can be automated of course, using <emphasis>transitive persistence</emphasis>, see <xref linkend=\"objectstate-transitive\"/>." +#. Tag: para +#: session_api.xml:553 +#, no-c-format +msgid "" +"The application should individually <literal>update()</literal> detached " +"instances reachable from the given detached instance if and <emphasis>only</" +"emphasis> if it wants their state also updated. This can be automated of " +"course, using <emphasis>transitive persistence</emphasis>, see <xref linkend=" +"\"objectstate-transitive\"/>." msgstr "" +"The application should individually <literal>update()</literal> detached " +"instances reachable from the given detached instance if and <emphasis>only</" +"emphasis> if it wants their state also updated. This can be automated of " +"course, using <emphasis>transitive persistence</emphasis>, see <xref linkend=" +"\"objectstate-transitive\"/>." -#: index.docbook:560 -msgid "The <literal>lock()</literal> method also allows an application to reassociate an object with a new session. However, the detached instance has to be unmodified!" +#. Tag: para +#: session_api.xml:560 +#, no-c-format +msgid "" +"The <literal>lock()</literal> method also allows an application to " +"reassociate an object with a new session. However, the detached instance has " +"to be unmodified!" msgstr "" +"The <literal>lock()</literal> method also allows an application to " +"reassociate an object with a new session. However, the detached instance has " +"to be unmodified!" -#: index.docbook:565 +#. Tag: programlisting +#: session_api.xml:565 +#, no-c-format msgid "" - "<![CDATA[//just reassociate:\n" - "sess.lock(fritz, LockMode.NONE);\n" - "//do a version check, then reassociate:\n" - "sess.lock(izi, LockMode.READ);\n" - "//do a version check, using SELECT ... FOR UPDATE, then reassociate:\n" - "sess.lock(pk, LockMode.UPGRADE);]]>" +"<![CDATA[//just reassociate:\n" +"sess.lock(fritz, LockMode.NONE);\n" +"//do a version check, then reassociate:\n" +"sess.lock(izi, LockMode.READ);\n" +"//do a version check, using SELECT ... FOR UPDATE, then reassociate:\n" +"sess.lock(pk, LockMode.UPGRADE);]]>" msgstr "" -#: index.docbook:567 -msgid "Note that <literal>lock()</literal> can be used with various <literal>LockMode</literal>s, see the API documentation and the chapter on transaction handling for more information. Reattachment is not the only usecase for <literal>lock()</literal>." +#. Tag: para +#: session_api.xml:567 +#, no-c-format +msgid "" +"Note that <literal>lock()</literal> can be used with various " +"<literal>LockMode</literal>s, see the API documentation and the chapter on " +"transaction handling for more information. Reattachment is not the only " +"usecase for <literal>lock()</literal>." msgstr "" +"Note that <literal>lock()</literal> can be used with various " +"<literal>LockMode</literal>s, see the API documentation and the chapter on " +"transaction handling for more information. Reattachment is not the only " +"usecase for <literal>lock()</literal>." -#: index.docbook:574 -msgid "Other models for long units of work are discussed in <xref linkend=\"transactions-optimistic\"/>." +#. Tag: para +#: session_api.xml:574 +#, no-c-format +msgid "" +"Other models for long units of work are discussed in <xref linkend=" +"\"transactions-optimistic\"/>." msgstr "" +"Other models for long units of work are discussed in <xref linkend=" +"\"transactions-optimistic\"/>." -#: index.docbook:581 +#. Tag: title +#: session_api.xml:581 +#, no-c-format msgid "Automatic state detection" -msgstr "" +msgstr "Automatic state detection" -#: index.docbook:583 -msgid "Hibernate users have requested a general purpose method that either saves a transient instance by generating a new identifier or updates/reattaches the detached instances associated with its current identifier. The <literal>saveOrUpdate()</literal> method implements this functionality." +#. Tag: para +#: session_api.xml:583 +#, no-c-format +msgid "" +"Hibernate users have requested a general purpose method that either saves a " +"transient instance by generating a new identifier or updates/reattaches the " +"detached instances associated with its current identifier. The " +"<literal>saveOrUpdate()</literal> method implements this functionality." msgstr "" +"Hibernate users have requested a general purpose method that either saves a " +"transient instance by generating a new identifier or updates/reattaches the " +"detached instances associated with its current identifier. The " +"<literal>saveOrUpdate()</literal> method implements this functionality." -#: index.docbook:590 +#. Tag: programlisting +#: session_api.xml:590 +#, no-c-format msgid "" - "<![CDATA[// in the first session\n" - "Cat cat = (Cat) firstSession.load(Cat.class, catID);\n" - "\n" - "// in a higher tier of the application\n" - "Cat mate = new Cat();\n" - "cat.setMate(mate);\n" - "\n" - "// later, in a new session\n" - "secondSession.saveOrUpdate(cat); // update existing state (cat has a non-null id)\n" - "secondSession.saveOrUpdate(mate); // save the new instance (mate has a null id)]]>" +"<![CDATA[// in the first session\n" +"Cat cat = (Cat) firstSession.load(Cat.class, catID);\n" +"\n" +"// in a higher tier of the application\n" +"Cat mate = new Cat();\n" +"cat.setMate(mate);\n" +"\n" +"// later, in a new session\n" +"secondSession.saveOrUpdate(cat); // update existing state (cat has a non-" +"null id)\n" +"secondSession.saveOrUpdate(mate); // save the new instance (mate has a null " +"id)]]>" msgstr "" -#: index.docbook:592 -msgid "The usage and semantics of <literal>saveOrUpdate()</literal> seems to be confusing for new users. Firstly, so long as you are not trying to use instances from one session in another new session, you should not need to use <literal>update()</literal>, <literal>saveOrUpdate()</literal>, or <literal>merge()</literal>. Some whole applications will never use either of these methods." +#. Tag: para +#: session_api.xml:592 +#, no-c-format +msgid "" +"The usage and semantics of <literal>saveOrUpdate()</literal> seems to be " +"confusing for new users. Firstly, so long as you are not trying to use " +"instances from one session in another new session, you should not need to " +"use <literal>update()</literal>, <literal>saveOrUpdate()</literal>, or " +"<literal>merge()</literal>. Some whole applications will never use either of " +"these methods." msgstr "" +"The usage and semantics of <literal>saveOrUpdate()</literal> seems to be " +"confusing for new users. Firstly, so long as you are not trying to use " +"instances from one session in another new session, you should not need to " +"use <literal>update()</literal>, <literal>saveOrUpdate()</literal>, or " +"<literal>merge()</literal>. Some whole applications will never use either of " +"these methods." -#: index.docbook:600 -msgid "Usually <literal>update()</literal> or <literal>saveOrUpdate()</literal> are used in the following scenario:" +#. Tag: para +#: session_api.xml:600 +#, no-c-format +msgid "" +"Usually <literal>update()</literal> or <literal>saveOrUpdate()</literal> are " +"used in the following scenario:" msgstr "" +"Usually <literal>update()</literal> or <literal>saveOrUpdate()</literal> are " +"used in the following scenario:" -#: index.docbook:607 +#. Tag: para +#: session_api.xml:607 +#, no-c-format msgid "the application loads an object in the first session" -msgstr "" +msgstr "the application loads an object in the first session" -#: index.docbook:612 +#. Tag: para +#: session_api.xml:612 +#, no-c-format msgid "the object is passed up to the UI tier" -msgstr "" +msgstr "the object is passed up to the UI tier" -#: index.docbook:617 +#. Tag: para +#: session_api.xml:617 +#, no-c-format msgid "some modifications are made to the object" -msgstr "" +msgstr "some modifications are made to the object" -#: index.docbook:622 +#. Tag: para +#: session_api.xml:622 +#, no-c-format msgid "the object is passed back down to the business logic tier" -msgstr "" +msgstr "the object is passed back down to the business logic tier" -#: index.docbook:627 -msgid "the application persists these modifications by calling <literal>update()</literal> in a second session" +#. Tag: para +#: session_api.xml:627 +#, no-c-format +msgid "" +"the application persists these modifications by calling <literal>update()</" +"literal> in a second session" msgstr "" +"the application persists these modifications by calling <literal>update()</" +"literal> in a second session" -#: index.docbook:634 +#. Tag: para +#: session_api.xml:634 +#, no-c-format msgid "<literal>saveOrUpdate()</literal> does the following:" -msgstr "" +msgstr "<literal>saveOrUpdate()</literal> does the following:" -#: index.docbook:640 +#. Tag: para +#: session_api.xml:640 +#, no-c-format msgid "if the object is already persistent in this session, do nothing" -msgstr "" +msgstr "if the object is already persistent in this session, do nothing" -#: index.docbook:645 -msgid "if another object associated with the session has the same identifier, throw an exception" +#. Tag: para +#: session_api.xml:645 +#, no-c-format +msgid "" +"if another object associated with the session has the same identifier, throw " +"an exception" msgstr "" +"if another object associated with the session has the same identifier, throw " +"an exception" -#: index.docbook:651 +#. Tag: para +#: session_api.xml:651 +#, no-c-format msgid "if the object has no identifier property, <literal>save()</literal> it" -msgstr "" +msgstr "if the object has no identifier property, <literal>save()</literal> it" -#: index.docbook:656 -msgid "if the object's identifier has the value assigned to a newly instantiated object, <literal>save()</literal> it" +#. Tag: para +#: session_api.xml:656 +#, no-c-format +msgid "" +"if the object's identifier has the value assigned to a newly instantiated " +"object, <literal>save()</literal> it" msgstr "" +"if the object's identifier has the value assigned to a newly instantiated " +"object, <literal>save()</literal> it" -#: index.docbook:662 -msgid "if the object is versioned (by a <literal><version></literal> or <literal><timestamp></literal>), and the version property value is the same value assigned to a newly instantiated object, <literal>save()</literal> it" +#. Tag: para +#: session_api.xml:662 +#, no-c-format +msgid "" +"if the object is versioned (by a <literal><version></literal> or " +"<literal><timestamp></literal>), and the version property value is the " +"same value assigned to a newly instantiated object, <literal>save()</" +"literal> it" msgstr "" +"if the object is versioned (by a <literal><version></literal> or " +"<literal><timestamp></literal>), and the version property value is the " +"same value assigned to a newly instantiated object, <literal>save()</" +"literal> it" -#: index.docbook:670 +#. Tag: para +#: session_api.xml:670 +#, no-c-format msgid "otherwise <literal>update()</literal> the object" -msgstr "" +msgstr "otherwise <literal>update()</literal> the object" -#: index.docbook:676 +#. Tag: para +#: session_api.xml:676 +#, no-c-format msgid "and <literal>merge()</literal> is very different:" -msgstr "" +msgstr "and <literal>merge()</literal> is very different:" -#: index.docbook:682 -msgid "if there is a persistent instance with the same identifier currently associated with the session, copy the state of the given object onto the persistent instance" +#. Tag: para +#: session_api.xml:682 +#, no-c-format +msgid "" +"if there is a persistent instance with the same identifier currently " +"associated with the session, copy the state of the given object onto the " +"persistent instance" msgstr "" +"if there is a persistent instance with the same identifier currently " +"associated with the session, copy the state of the given object onto the " +"persistent instance" -#: index.docbook:689 -msgid "if there is no persistent instance currently associated with the session, try to load it from the database, or create a new persistent instance" +#. Tag: para +#: session_api.xml:689 +#, no-c-format +msgid "" +"if there is no persistent instance currently associated with the session, " +"try to load it from the database, or create a new persistent instance" msgstr "" +"if there is no persistent instance currently associated with the session, " +"try to load it from the database, or create a new persistent instance" -#: index.docbook:695 +#. Tag: para +#: session_api.xml:695 +#, no-c-format msgid "the persistent instance is returned" -msgstr "" +msgstr "the persistent instance is returned" -#: index.docbook:700 -msgid "the given instance does not become associated with the session, it remains detached" +#. Tag: para +#: session_api.xml:700 +#, no-c-format +msgid "" +"the given instance does not become associated with the session, it remains " +"detached" msgstr "" +"the given instance does not become associated with the session, it remains " +"detached" -#: index.docbook:710 +#. Tag: title +#: session_api.xml:710 +#, no-c-format msgid "Deleting persistent objects" -msgstr "" +msgstr "Deleting persistent objects" -#: index.docbook:712 -msgid "<literal>Session.delete()</literal> will remove an object's state from the database. Of course, your application might still hold a reference to a deleted object. It's best to think of <literal>delete()</literal> as making a persistent instance transient." +#. Tag: para +#: session_api.xml:712 +#, no-c-format +msgid "" +"<literal>Session.delete()</literal> will remove an object's state from the " +"database. Of course, your application might still hold a reference to a " +"deleted object. It's best to think of <literal>delete()</literal> as making " +"a persistent instance transient." msgstr "" +"<literal>Session.delete()</literal> will remove an object's state from the " +"database. Of course, your application might still hold a reference to a " +"deleted object. It's best to think of <literal>delete()</literal> as making " +"a persistent instance transient." -#: index.docbook:719 +#. Tag: programlisting +#: session_api.xml:719 +#, no-c-format msgid "<![CDATA[sess.delete(cat);]]>" msgstr "" -#: index.docbook:721 -msgid "You may delete objects in any order you like, without risk of foreign key constraint violations. It is still possible to violate a <literal>NOT NULL</literal> constraint on a foreign key column by deleting objects in the wrong order, e.g. if you delete the parent, but forget to delete the children." +#. Tag: para +#: session_api.xml:721 +#, no-c-format +msgid "" +"You may delete objects in any order you like, without risk of foreign key " +"constraint violations. It is still possible to violate a <literal>NOT NULL</" +"literal> constraint on a foreign key column by deleting objects in the wrong " +"order, e.g. if you delete the parent, but forget to delete the children." msgstr "" +"You may delete objects in any order you like, without risk of foreign key " +"constraint violations. It is still possible to violate a <literal>NOT NULL</" +"literal> constraint on a foreign key column by deleting objects in the wrong " +"order, e.g. if you delete the parent, but forget to delete the children." -#: index.docbook:732 +#. Tag: title +#: session_api.xml:732 +#, no-c-format msgid "Replicating object between two different datastores" -msgstr "" +msgstr "Replicating object between two different datastores" -#: index.docbook:734 -msgid "It is occasionally useful to be able to take a graph of persistent instances and make them persistent in a different datastore, without regenerating identifier values." +#. Tag: para +#: session_api.xml:734 +#, no-c-format +msgid "" +"It is occasionally useful to be able to take a graph of persistent instances " +"and make them persistent in a different datastore, without regenerating " +"identifier values." msgstr "" +"It is occasionally useful to be able to take a graph of persistent instances " +"and make them persistent in a different datastore, without regenerating " +"identifier values." -#: index.docbook:740 +#. Tag: programlisting +#: session_api.xml:740 +#, no-c-format msgid "" - "<![CDATA[//retrieve a cat from one database\n" - "Session session1 = factory1.openSession();\n" - "Transaction tx1 = session1.beginTransaction();\n" - "Cat cat = session1.get(Cat.class, catId);\n" - "tx1.commit();\n" - "session1.close();\n" - "\n" - "//reconcile with a second database\n" - "Session session2 = factory2.openSession();\n" - "Transaction tx2 = session2.beginTransaction();\n" - "session2.replicate(cat, ReplicationMode.LATEST_VERSION);\n" - "tx2.commit();\n" - "session2.close();]]>" +"<![CDATA[//retrieve a cat from one database\n" +"Session session1 = factory1.openSession();\n" +"Transaction tx1 = session1.beginTransaction();\n" +"Cat cat = session1.get(Cat.class, catId);\n" +"tx1.commit();\n" +"session1.close();\n" +"\n" +"//reconcile with a second database\n" +"Session session2 = factory2.openSession();\n" +"Transaction tx2 = session2.beginTransaction();\n" +"session2.replicate(cat, ReplicationMode.LATEST_VERSION);\n" +"tx2.commit();\n" +"session2.close();]]>" msgstr "" -#: index.docbook:742 -msgid "The <literal>ReplicationMode</literal> determines how <literal>replicate()</literal> will deal with conflicts with existing rows in the database." +#. Tag: para +#: session_api.xml:742 +#, no-c-format +msgid "" +"The <literal>ReplicationMode</literal> determines how <literal>replicate()</" +"literal> will deal with conflicts with existing rows in the database." msgstr "" +"The <literal>ReplicationMode</literal> determines how <literal>replicate()</" +"literal> will deal with conflicts with existing rows in the database." -#: index.docbook:749 -msgid "<literal>ReplicationMode.IGNORE</literal> - ignore the object when there is an existing database row with the same identifier" +#. Tag: para +#: session_api.xml:749 +#, no-c-format +msgid "" +"<literal>ReplicationMode.IGNORE</literal> - ignore the object when there is " +"an existing database row with the same identifier" msgstr "" +"<literal>ReplicationMode.IGNORE</literal> - ignore the object when there is " +"an existing database row with the same identifier" -#: index.docbook:755 -msgid "<literal>ReplicationMode.OVERWRITE</literal> - overwrite any existing database row with the same identifier" +#. Tag: para +#: session_api.xml:755 +#, no-c-format +msgid "" +"<literal>ReplicationMode.OVERWRITE</literal> - overwrite any existing " +"database row with the same identifier" msgstr "" +"<literal>ReplicationMode.OVERWRITE</literal> - overwrite any existing " +"database row with the same identifier" -#: index.docbook:761 -msgid "<literal>ReplicationMode.EXCEPTION</literal> - throw an exception if there is an existing database row with the same identifier" +#. Tag: para +#: session_api.xml:761 +#, no-c-format +msgid "" +"<literal>ReplicationMode.EXCEPTION</literal> - throw an exception if there " +"is an existing database row with the same identifier" msgstr "" +"<literal>ReplicationMode.EXCEPTION</literal> - throw an exception if there " +"is an existing database row with the same identifier" -#: index.docbook:767 -msgid "<literal>ReplicationMode.LATEST_VERSION</literal> - overwrite the row if its version number is earlier than the version number of the object, or ignore the object otherwise" +#. Tag: para +#: session_api.xml:767 +#, no-c-format +msgid "" +"<literal>ReplicationMode.LATEST_VERSION</literal> - overwrite the row if its " +"version number is earlier than the version number of the object, or ignore " +"the object otherwise" msgstr "" +"<literal>ReplicationMode.LATEST_VERSION</literal> - overwrite the row if its " +"version number is earlier than the version number of the object, or ignore " +"the object otherwise" -#: index.docbook:775 -msgid "Usecases for this feature include reconciling data entered into different database instances, upgrading system configuration information during product upgrades, rolling back changes made during non-ACID transactions and more." +#. Tag: para +#: session_api.xml:775 +#, no-c-format +msgid "" +"Usecases for this feature include reconciling data entered into different " +"database instances, upgrading system configuration information during " +"product upgrades, rolling back changes made during non-ACID transactions and " +"more." msgstr "" +"Usecases for this feature include reconciling data entered into different " +"database instances, upgrading system configuration information during " +"product upgrades, rolling back changes made during non-ACID transactions and " +"more." -#: index.docbook:784 +#. Tag: title +#: session_api.xml:784 +#, no-c-format msgid "Flushing the Session" -msgstr "" +msgstr "Flushing the Session" -#: index.docbook:786 -msgid "From time to time the <literal>Session</literal> will execute the SQL statements needed to synchronize the JDBC connection's state with the state of objects held in memory. This process, <emphasis>flush</emphasis>, occurs by default at the following points" +#. Tag: para +#: session_api.xml:786 +#, no-c-format +msgid "" +"From time to time the <literal>Session</literal> will execute the SQL " +"statements needed to synchronize the JDBC connection's state with the state " +"of objects held in memory. This process, <emphasis>flush</emphasis>, occurs " +"by default at the following points" msgstr "" +"From time to time the <literal>Session</literal> will execute the SQL " +"statements needed to synchronize the JDBC connection's state with the state " +"of objects held in memory. This process, <emphasis>flush</emphasis>, occurs " +"by default at the following points" -#: index.docbook:795 +#. Tag: para +#: session_api.xml:795 +#, no-c-format msgid "before some query executions" -msgstr "" +msgstr "before some query executions" -#: index.docbook:800 +#. Tag: para +#: session_api.xml:800 +#, no-c-format msgid "from <literal>org.hibernate.Transaction.commit()</literal>" -msgstr "" +msgstr "from <literal>org.hibernate.Transaction.commit()</literal>" -#: index.docbook:805 +#. Tag: para +#: session_api.xml:805 +#, no-c-format msgid "from <literal>Session.flush()</literal>" -msgstr "" +msgstr "from <literal>Session.flush()</literal>" -#: index.docbook:811 +#. Tag: para +#: session_api.xml:811 +#, no-c-format msgid "The SQL statements are issued in the following order" -msgstr "" +msgstr "The SQL statements are issued in the following order" -#: index.docbook:817 -msgid "all entity insertions, in the same order the corresponding objects were saved using <literal>Session.save()</literal>" +#. Tag: para +#: session_api.xml:817 +#, no-c-format +msgid "" +"all entity insertions, in the same order the corresponding objects were " +"saved using <literal>Session.save()</literal>" msgstr "" +"all entity insertions, in the same order the corresponding objects were " +"saved using <literal>Session.save()</literal>" -#: index.docbook:823 +#. Tag: para +#: session_api.xml:823 +#, no-c-format msgid "all entity updates" -msgstr "" +msgstr "all entity updates" -#: index.docbook:828 +#. Tag: para +#: session_api.xml:828 +#, no-c-format msgid "all collection deletions" -msgstr "" +msgstr "all collection deletions" -#: index.docbook:833 +#. Tag: para +#: session_api.xml:833 +#, no-c-format msgid "all collection element deletions, updates and insertions" -msgstr "" +msgstr "all collection element deletions, updates and insertions" -#: index.docbook:838 +#. Tag: para +#: session_api.xml:838 +#, no-c-format msgid "all collection insertions" -msgstr "" +msgstr "all collection insertions" -#: index.docbook:843 -msgid "all entity deletions, in the same order the corresponding objects were deleted using <literal>Session.delete()</literal>" +#. Tag: para +#: session_api.xml:843 +#, no-c-format +msgid "" +"all entity deletions, in the same order the corresponding objects were " +"deleted using <literal>Session.delete()</literal>" msgstr "" +"all entity deletions, in the same order the corresponding objects were " +"deleted using <literal>Session.delete()</literal>" -#: index.docbook:850 -msgid "(An exception is that objects using <literal>native</literal> ID generation are inserted when they are saved.)" +#. Tag: para +#: session_api.xml:850 +#, no-c-format +msgid "" +"(An exception is that objects using <literal>native</literal> ID generation " +"are inserted when they are saved.)" msgstr "" +"(An exception is that objects using <literal>native</literal> ID generation " +"are inserted when they are saved.)" -#: index.docbook:855 -msgid "Except when you explicity <literal>flush()</literal>, there are absolutely no guarantees about <emphasis>when</emphasis> the <literal>Session</literal> executes the JDBC calls, only the <emphasis>order</emphasis> in which they are executed. However, Hibernate does guarantee that the <literal>Query.list(..)</literal> will never return stale data; nor will they return the wrong data." +#. Tag: para +#: session_api.xml:855 +#, no-c-format +msgid "" +"Except when you explicity <literal>flush()</literal>, there are absolutely " +"no guarantees about <emphasis>when</emphasis> the <literal>Session</literal> " +"executes the JDBC calls, only the <emphasis>order</emphasis> in which they " +"are executed. However, Hibernate does guarantee that the <literal>Query.list" +"(..)</literal> will never return stale data; nor will they return the wrong " +"data." msgstr "" +"Except when you explicity <literal>flush()</literal>, there are absolutely " +"no guarantees about <emphasis>when</emphasis> the <literal>Session</literal> " +"executes the JDBC calls, only the <emphasis>order</emphasis> in which they " +"are executed. However, Hibernate does guarantee that the <literal>Query.list" +"(..)</literal> will never return stale data; nor will they return the wrong " +"data." -#: index.docbook:863 -msgid "It is possible to change the default behavior so that flush occurs less frequently. The <literal>FlushMode</literal> class defines three different modes: only flush at commit time (and only when the Hibernate <literal>Transaction</literal> API is used), flush automatically using the explained routine, or never flush unless <literal>flush()</literal> is called explicitly. The last mode is useful for long running units of work, where a <literal>Session</literal> is kept open and disconnected for a long time (see <xref linkend=\"transactions-optimistic-longsession\"/>)." +#. Tag: para +#: session_api.xml:863 +#, no-c-format +msgid "" +"It is possible to change the default behavior so that flush occurs less " +"frequently. The <literal>FlushMode</literal> class defines three different " +"modes: only flush at commit time (and only when the Hibernate " +"<literal>Transaction</literal> API is used), flush automatically using the " +"explained routine, or never flush unless <literal>flush()</literal> is " +"called explicitly. The last mode is useful for long running units of work, " +"where a <literal>Session</literal> is kept open and disconnected for a long " +"time (see <xref linkend=\"transactions-optimistic-longsession\"/>)." msgstr "" +"It is possible to change the default behavior so that flush occurs less " +"frequently. The <literal>FlushMode</literal> class defines three different " +"modes: only flush at commit time (and only when the Hibernate " +"<literal>Transaction</literal> API is used), flush automatically using the " +"explained routine, or never flush unless <literal>flush()</literal> is " +"called explicitly. The last mode is useful for long running units of work, " +"where a <literal>Session</literal> is kept open and disconnected for a long " +"time (see <xref linkend=\"transactions-optimistic-longsession\"/>)." -#: index.docbook:873 +#. Tag: programlisting +#: session_api.xml:873 +#, no-c-format msgid "" - "<![CDATA[sess = sf.openSession();\n" - "Transaction tx = sess.beginTransaction();\n" - "sess.setFlushMode(FlushMode.COMMIT); // allow queries to return stale state\n" - "\n" - "Cat izi = (Cat) sess.load(Cat.class, id);\n" - "izi.setName(iznizi);\n" - "\n" - "// might return stale data\n" - "sess.find(\"from Cat as cat left outer join cat.kittens kitten\");\n" - "\n" - "// change to izi is not flushed!\n" - "...\n" - "tx.commit(); // flush occurs\n" - "sess.close();]]>" +"<![CDATA[sess = sf.openSession();\n" +"Transaction tx = sess.beginTransaction();\n" +"sess.setFlushMode(FlushMode.COMMIT); // allow queries to return stale state\n" +"\n" +"Cat izi = (Cat) sess.load(Cat.class, id);\n" +"izi.setName(iznizi);\n" +"\n" +"// might return stale data\n" +"sess.find(\"from Cat as cat left outer join cat.kittens kitten\");\n" +"\n" +"// change to izi is not flushed!\n" +"...\n" +"tx.commit(); // flush occurs\n" +"sess.close();]]>" msgstr "" -#: index.docbook:875 -msgid "During flush, an exception might occur (e.g. if a DML operation violates a constraint). Since handling exceptions involves some understanding of Hibernate's transactional behavior, we discuss it in <xref linkend=\"transactions\"/>." +#. Tag: para +#: session_api.xml:875 +#, no-c-format +msgid "" +"During flush, an exception might occur (e.g. if a DML operation violates a " +"constraint). Since handling exceptions involves some understanding of " +"Hibernate's transactional behavior, we discuss it in <xref linkend=" +"\"transactions\"/>." msgstr "" +"During flush, an exception might occur (e.g. if a DML operation violates a " +"constraint). Since handling exceptions involves some understanding of " +"Hibernate's transactional behavior, we discuss it in <xref linkend=" +"\"transactions\"/>." -#: index.docbook:884 +#. Tag: title +#: session_api.xml:884 +#, no-c-format msgid "Transitive persistence" -msgstr "" +msgstr "Transitive persistence" -#: index.docbook:886 -msgid "It is quite cumbersome to save, delete, or reattach individual objects, especially if you deal with a graph of associated objects. A common case is a parent/child relationship. Consider the following example:" +#. Tag: para +#: session_api.xml:886 +#, no-c-format +msgid "" +"It is quite cumbersome to save, delete, or reattach individual objects, " +"especially if you deal with a graph of associated objects. A common case is " +"a parent/child relationship. Consider the following example:" msgstr "" +"It is quite cumbersome to save, delete, or reattach individual objects, " +"especially if you deal with a graph of associated objects. A common case is " +"a parent/child relationship. Consider the following example:" -#: index.docbook:892 -msgid "If the children in a parent/child relationship would be value typed (e.g. a collection of addresses or strings), their life cycle would depend on the parent and no further action would be required for convenient \"cascading\" of state changes. When the parent is saved, the value-typed child objects are saved as well, when the parent is deleted, the children will be deleted, etc. This even works for operations such as the removal of a child from the collection; Hibernate will detect this and, since value-typed objects can't have shared references, delete the child from the database." +#. Tag: para +#: session_api.xml:892 +#, no-c-format +msgid "" +"If the children in a parent/child relationship would be value typed (e.g. a " +"collection of addresses or strings), their life cycle would depend on the " +"parent and no further action would be required for convenient \"cascading\" " +"of state changes. When the parent is saved, the value-typed child objects " +"are saved as well, when the parent is deleted, the children will be deleted, " +"etc. This even works for operations such as the removal of a child from the " +"collection; Hibernate will detect this and, since value-typed objects can't " +"have shared references, delete the child from the database." msgstr "" +"If the children in a parent/child relationship would be value typed (e.g. a " +"collection of addresses or strings), their life cycle would depend on the " +"parent and no further action would be required for convenient \"cascading\" " +"of state changes. When the parent is saved, the value-typed child objects " +"are saved as well, when the parent is deleted, the children will be deleted, " +"etc. This even works for operations such as the removal of a child from the " +"collection; Hibernate will detect this and, since value-typed objects can't " +"have shared references, delete the child from the database." -#: index.docbook:903 -msgid "Now consider the same scenario with parent and child objects being entities, not value-types (e.g. categories and items, or parent and child cats). Entities have their own life cycle, support shared references (so removing an entity from the collection does not mean it can be deleted), and there is by default no cascading of state from one entity to any other associated entities. Hibernate does not implement <emphasis>persistence by reachability</emphasis> by default." +#. Tag: para +#: session_api.xml:903 +#, no-c-format +msgid "" +"Now consider the same scenario with parent and child objects being entities, " +"not value-types (e.g. categories and items, or parent and child cats). " +"Entities have their own life cycle, support shared references (so removing " +"an entity from the collection does not mean it can be deleted), and there is " +"by default no cascading of state from one entity to any other associated " +"entities. Hibernate does not implement <emphasis>persistence by " +"reachability</emphasis> by default." msgstr "" +"Now consider the same scenario with parent and child objects being entities, " +"not value-types (e.g. categories and items, or parent and child cats). " +"Entities have their own life cycle, support shared references (so removing " +"an entity from the collection does not mean it can be deleted), and there is " +"by default no cascading of state from one entity to any other associated " +"entities. Hibernate does not implement <emphasis>persistence by " +"reachability</emphasis> by default." -#: index.docbook:912 -msgid "For each basic operation of the Hibernate session - including <literal>persist(), merge(), saveOrUpdate(), delete(), lock(), refresh(), evict(), replicate()</literal> - there is a corresponding cascade style. Respectively, the cascade styles are named <literal>create, merge, save-update, delete, lock, refresh, evict, replicate</literal>. If you want an operation to be cascaded along an association, you must indicate that in the mapping document. For example:" +#. Tag: para +#: session_api.xml:912 +#, no-c-format +msgid "" +"For each basic operation of the Hibernate session - including " +"<literal>persist(), merge(), saveOrUpdate(), delete(), lock(), refresh(), " +"evict(), replicate()</literal> - there is a corresponding cascade style. " +"Respectively, the cascade styles are named <literal>create, merge, save-" +"update, delete, lock, refresh, evict, replicate</literal>. If you want an " +"operation to be cascaded along an association, you must indicate that in the " +"mapping document. For example:" msgstr "" +"For each basic operation of the Hibernate session - including " +"<literal>persist(), merge(), saveOrUpdate(), delete(), lock(), refresh(), " +"evict(), replicate()</literal> - there is a corresponding cascade style. " +"Respectively, the cascade styles are named <literal>create, merge, save-" +"update, delete, lock, refresh, evict, replicate</literal>. If you want an " +"operation to be cascaded along an association, you must indicate that in the " +"mapping document. For example:" -#: index.docbook:921 +#. Tag: programlisting +#: session_api.xml:921 +#, no-c-format msgid "<![CDATA[<one-to-one name=\"person\" cascade=\"persist\"/>]]>" msgstr "" -#: index.docbook:923 +#. Tag: para +#: session_api.xml:923 +#, no-c-format msgid "Cascade styles my be combined:" -msgstr "" +msgstr "Cascade styles my be combined:" -#: index.docbook:927 -msgid "<![CDATA[<one-to-one name=\"person\" cascade=\"persist,delete,lock\"/>]]>" +#. Tag: programlisting +#: session_api.xml:927 +#, no-c-format +msgid "" +"<![CDATA[<one-to-one name=\"person\" cascade=\"persist,delete,lock\"/>]]>" msgstr "" -#: index.docbook:929 -msgid "You may even use <literal>cascade=\"all\"</literal> to specify that <emphasis>all</emphasis> operations should be cascaded along the association. The default <literal>cascade=\"none\"</literal> specifies that no operations are to be cascaded." +#. Tag: para +#: session_api.xml:929 +#, no-c-format +msgid "" +"You may even use <literal>cascade=\"all\"</literal> to specify that " +"<emphasis>all</emphasis> operations should be cascaded along the " +"association. The default <literal>cascade=\"none\"</literal> specifies that " +"no operations are to be cascaded." msgstr "" +"You may even use <literal>cascade=\"all\"</literal> to specify that " +"<emphasis>all</emphasis> operations should be cascaded along the " +"association. The default <literal>cascade=\"none\"</literal> specifies that " +"no operations are to be cascaded." -#: index.docbook:935 -msgid "A special cascade style, <literal>delete-orphan</literal>, applies only to one-to-many associations, and indicates that the <literal>delete()</literal> operation should be applied to any child object that is removed from the association." +#. Tag: para +#: session_api.xml:935 +#, no-c-format +msgid "" +"A special cascade style, <literal>delete-orphan</literal>, applies only to " +"one-to-many associations, and indicates that the <literal>delete()</literal> " +"operation should be applied to any child object that is removed from the " +"association." msgstr "" +"A special cascade style, <literal>delete-orphan</literal>, applies only to " +"one-to-many associations, and indicates that the <literal>delete()</literal> " +"operation should be applied to any child object that is removed from the " +"association." -#: index.docbook:942 +#. Tag: para +#: session_api.xml:942 +#, no-c-format msgid "Recommendations:" -msgstr "" +msgstr "Recommendations:" -#: index.docbook:948 -msgid "It doesn't usually make sense to enable cascade on a <literal><many-to-one></literal> or <literal><many-to-many></literal> association. Cascade is often useful for <literal><one-to-one></literal> and <literal><one-to-many></literal> associations." +#. Tag: para +#: session_api.xml:948 +#, no-c-format +msgid "" +"It doesn't usually make sense to enable cascade on a <literal><many-to-" +"one></literal> or <literal><many-to-many></literal> association. " +"Cascade is often useful for <literal><one-to-one></literal> and " +"<literal><one-to-many></literal> associations." msgstr "" +"It doesn't usually make sense to enable cascade on a <literal><many-to-" +"one></literal> or <literal><many-to-many></literal> association. " +"Cascade is often useful for <literal><one-to-one></literal> and " +"<literal><one-to-many></literal> associations." -#: index.docbook:956 -msgid "If the child object's lifespan is bounded by the lifespan of the parent object, make it a <emphasis>life cycle object</emphasis> by specifying <literal>cascade=\"all,delete-orphan\"</literal>." +#. Tag: para +#: session_api.xml:956 +#, no-c-format +msgid "" +"If the child object's lifespan is bounded by the lifespan of the parent " +"object, make it a <emphasis>life cycle object</emphasis> by specifying " +"<literal>cascade=\"all,delete-orphan\"</literal>." msgstr "" +"If the child object's lifespan is bounded by the lifespan of the parent " +"object, make it a <emphasis>life cycle object</emphasis> by specifying " +"<literal>cascade=\"all,delete-orphan\"</literal>." -#: index.docbook:963 -msgid "Otherwise, you might not need cascade at all. But if you think that you will often be working with the parent and children together in the same transaction, and you want to save yourself some typing, consider using <literal>cascade=\"persist,merge,save-update\"</literal>." +#. Tag: para +#: session_api.xml:963 +#, no-c-format +msgid "" +"Otherwise, you might not need cascade at all. But if you think that you will " +"often be working with the parent and children together in the same " +"transaction, and you want to save yourself some typing, consider using " +"<literal>cascade=\"persist,merge,save-update\"</literal>." msgstr "" +"Otherwise, you might not need cascade at all. But if you think that you will " +"often be working with the parent and children together in the same " +"transaction, and you want to save yourself some typing, consider using " +"<literal>cascade=\"persist,merge,save-update\"</literal>." -#: index.docbook:971 -msgid "Mapping an association (either a single valued association, or a collection) with <literal>cascade=\"all\"</literal> marks the association as a <emphasis>parent/child</emphasis> style relationship where save/update/delete of the parent results in save/update/delete of the child or children." +#. Tag: para +#: session_api.xml:971 +#, no-c-format +msgid "" +"Mapping an association (either a single valued association, or a collection) " +"with <literal>cascade=\"all\"</literal> marks the association as a " +"<emphasis>parent/child</emphasis> style relationship where save/update/" +"delete of the parent results in save/update/delete of the child or children." msgstr "" +"Mapping an association (either a single valued association, or a collection) " +"with <literal>cascade=\"all\"</literal> marks the association as a " +"<emphasis>parent/child</emphasis> style relationship where save/update/" +"delete of the parent results in save/update/delete of the child or children." -#: index.docbook:977 -msgid "Futhermore, a mere reference to a child from a persistent parent will result in save/update of the child. This metaphor is incomplete, however. A child which becomes unreferenced by its parent is <emphasis>not</emphasis> automatically deleted, except in the case of a <literal><one-to-many></literal> association mapped with <literal>cascade=\"delete-orphan\"</literal>. The precise semantics of cascading operations for a parent/child relationship are as follows:" +#. Tag: para +#: session_api.xml:977 +#, no-c-format +msgid "" +"Futhermore, a mere reference to a child from a persistent parent will result " +"in save/update of the child. This metaphor is incomplete, however. A child " +"which becomes unreferenced by its parent is <emphasis>not</emphasis> " +"automatically deleted, except in the case of a <literal><one-to-many></" +"literal> association mapped with <literal>cascade=\"delete-orphan\"</" +"literal>. The precise semantics of cascading operations for a parent/child " +"relationship are as follows:" msgstr "" +"Futhermore, a mere reference to a child from a persistent parent will result " +"in save/update of the child. This metaphor is incomplete, however. A child " +"which becomes unreferenced by its parent is <emphasis>not</emphasis> " +"automatically deleted, except in the case of a <literal><one-to-many></" +"literal> association mapped with <literal>cascade=\"delete-orphan\"</" +"literal>. The precise semantics of cascading operations for a parent/child " +"relationship are as follows:" -#: index.docbook:988 -msgid "If a parent is passed to <literal>persist()</literal>, all children are passed to <literal>persist()</literal>" +#. Tag: para +#: session_api.xml:988 +#, no-c-format +msgid "" +"If a parent is passed to <literal>persist()</literal>, all children are " +"passed to <literal>persist()</literal>" msgstr "" +"If a parent is passed to <literal>persist()</literal>, all children are " +"passed to <literal>persist()</literal>" -#: index.docbook:994 -msgid "If a parent is passed to <literal>merge()</literal>, all children are passed to <literal>merge()</literal>" +#. Tag: para +#: session_api.xml:994 +#, no-c-format +msgid "" +"If a parent is passed to <literal>merge()</literal>, all children are passed " +"to <literal>merge()</literal>" msgstr "" +"If a parent is passed to <literal>merge()</literal>, all children are passed " +"to <literal>merge()</literal>" -#: index.docbook:1000 -msgid "If a parent is passed to <literal>save()</literal>, <literal>update()</literal> or <literal>saveOrUpdate()</literal>, all children are passed to <literal>saveOrUpdate()</literal>" +#. Tag: para +#: session_api.xml:1000 +#, no-c-format +msgid "" +"If a parent is passed to <literal>save()</literal>, <literal>update()</" +"literal> or <literal>saveOrUpdate()</literal>, all children are passed to " +"<literal>saveOrUpdate()</literal>" msgstr "" +"If a parent is passed to <literal>save()</literal>, <literal>update()</" +"literal> or <literal>saveOrUpdate()</literal>, all children are passed to " +"<literal>saveOrUpdate()</literal>" -#: index.docbook:1006 -msgid "If a transient or detached child becomes referenced by a persistent parent, it is passed to <literal>saveOrUpdate()</literal>" +#. Tag: para +#: session_api.xml:1006 +#, no-c-format +msgid "" +"If a transient or detached child becomes referenced by a persistent parent, " +"it is passed to <literal>saveOrUpdate()</literal>" msgstr "" +"If a transient or detached child becomes referenced by a persistent parent, " +"it is passed to <literal>saveOrUpdate()</literal>" -#: index.docbook:1012 -msgid "If a parent is deleted, all children are passed to <literal>delete()</literal>" +#. Tag: para +#: session_api.xml:1012 +#, no-c-format +msgid "" +"If a parent is deleted, all children are passed to <literal>delete()</" +"literal>" msgstr "" +"If a parent is deleted, all children are passed to <literal>delete()</" +"literal>" -#: index.docbook:1017 -msgid "If a child is dereferenced by a persistent parent, <emphasis>nothing special happens</emphasis> - the application should explicitly delete the child if necessary - unless <literal>cascade=\"delete-orphan\"</literal>, in which case the \"orphaned\" child is deleted." +#. Tag: para +#: session_api.xml:1017 +#, no-c-format +msgid "" +"If a child is dereferenced by a persistent parent, <emphasis>nothing special " +"happens</emphasis> - the application should explicitly delete the child if " +"necessary - unless <literal>cascade=\"delete-orphan\"</literal>, in which " +"case the \"orphaned\" child is deleted." msgstr "" +"If a child is dereferenced by a persistent parent, <emphasis>nothing special " +"happens</emphasis> - the application should explicitly delete the child if " +"necessary - unless <literal>cascade=\"delete-orphan\"</literal>, in which " +"case the \"orphaned\" child is deleted." -#: index.docbook:1026 -msgid "Finally, note that cascading of operations can be applied to an object graph at <emphasis>call time</emphasis> or at <emphasis>flush time</emphasis>. All operations, if enabled, are cascaded to associated entities reachable when the operation is executed. However, <literal>save-upate</literal> and <literal>delete-orphan</literal> are transitive for all associated entities reachable during flush of the <literal>Session</literal>." +#. Tag: para +#: session_api.xml:1026 +#, no-c-format +msgid "" +"Finally, note that cascading of operations can be applied to an object graph " +"at <emphasis>call time</emphasis> or at <emphasis>flush time</emphasis>. All " +"operations, if enabled, are cascaded to associated entities reachable when " +"the operation is executed. However, <literal>save-upate</literal> and " +"<literal>delete-orphan</literal> are transitive for all associated entities " +"reachable during flush of the <literal>Session</literal>." msgstr "" +"Finally, note that cascading of operations can be applied to an object graph " +"at <emphasis>call time</emphasis> or at <emphasis>flush time</emphasis>. All " +"operations, if enabled, are cascaded to associated entities reachable when " +"the operation is executed. However, <literal>save-upate</literal> and " +"<literal>delete-orphan</literal> are transitive for all associated entities " +"reachable during flush of the <literal>Session</literal>." -#: index.docbook:1038 +#. Tag: title +#: session_api.xml:1038 +#, no-c-format msgid "Using metadata" -msgstr "" +msgstr "Usando metadados" -#: index.docbook:1040 -msgid "Hibernate requires a very rich meta-level model of all entity and value types. From time to time, this model is very useful to the application itself. For example, the application might use Hibernate's metadata to implement a \"smart\" deep-copy algorithm that understands which objects should be copied (eg. mutable value types) and which should not (eg. immutable value types and, possibly, associated entities)." +#. Tag: para +#: session_api.xml:1040 +#, no-c-format +msgid "" +"Hibernate requires a very rich meta-level model of all entity and value " +"types. From time to time, this model is very useful to the application " +"itself. For example, the application might use Hibernate's metadata to " +"implement a \"smart\" deep-copy algorithm that understands which objects " +"should be copied (eg. mutable value types) and which should not (eg. " +"immutable value types and, possibly, associated entities)." msgstr "" +"O Hibernate requer um modelo muito rico a nível de metadados de todas as " +"entidades e tipos de valores. De tempos em tempos, este modelo é muito útil " +"à própria aplicação. Por exemplo, a aplicação pode usar o metadados do " +"Hibernate que executa um algoritmo \"inteligente\" que compreende quais " +"objetos podem ser copiados (por exemplo, tipos de valores mutáveis) ou não " +"(por exemplo, tipos de valores imutáveis e, possivelmente, entidades " +"associadas)." -#: index.docbook:1047 -msgid "Hibernate exposes metadata via the <literal>ClassMetadata</literal> and <literal>CollectionMetadata</literal> interfaces and the <literal>Type</literal> hierarchy. Instances of the metadata interfaces may be obtained from the <literal>SessionFactory</literal>." +#. Tag: para +#: session_api.xml:1047 +#, no-c-format +msgid "" +"Hibernate exposes metadata via the <literal>ClassMetadata</literal> and " +"<literal>CollectionMetadata</literal> interfaces and the <literal>Type</" +"literal> hierarchy. Instances of the metadata interfaces may be obtained " +"from the <literal>SessionFactory</literal>." msgstr "" +"O Hibernate expõe o metadados via interfaces <literal>ClassMetadata</" +"literal> e <literal>CollectionMetadata</literal> e pela hierarquia " +"<literal>Type</literal>. Instâncias das interfaces de metadados podem ser " +"obtidas a partir do <literal>SessionFactory</literal>." -#: index.docbook:1054 +#. Tag: programlisting +#: session_api.xml:1054 +#, no-c-format msgid "" - "<![CDATA[Cat fritz = ......;\n" - "ClassMetadata catMeta = sessionfactory.getClassMetadata(Cat.class);\n" - "\n" - "Object[] propertyValues = catMeta.getPropertyValues(fritz);\n" - "String[] propertyNames = catMeta.getPropertyNames();\n" - "Type[] propertyTypes = catMeta.getPropertyTypes();\n" - "\n" - "// get a Map of all properties which are not collections or associations\n" - "Map namedValues = new HashMap();\n" - "for ( int i=0; i<propertyNames.length; i++ ) {\n" - " if ( !propertyTypes[i].isEntityType() && !propertyTypes[i].isCollectionType() ) {\n" - " namedValues.put( propertyNames[i], propertyValues[i] );\n" - " }\n" - "}]]>" +"<![CDATA[Cat fritz = ......;\n" +"ClassMetadata catMeta = sessionfactory.getClassMetadata(Cat.class);\n" +"\n" +"Object[] propertyValues = catMeta.getPropertyValues(fritz);\n" +"String[] propertyNames = catMeta.getPropertyNames();\n" +"Type[] propertyTypes = catMeta.getPropertyTypes();\n" +"\n" +"// get a Map of all properties which are not collections or associations\n" +"Map namedValues = new HashMap();\n" +"for ( int i=0; i<propertyNames.length; i++ ) {\n" +" if ( !propertyTypes[i].isEntityType() && !propertyTypes[i]." +"isCollectionType() ) {\n" +" namedValues.put( propertyNames[i], propertyValues[i] );\n" +" }\n" +"}]]>" msgstr "" -msgid "ROLES_OF_TRANSLATORS" -msgstr "" +#~ msgid "UPDATE" +#~ msgstr "UPDATE" -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "" +#~ msgid "DELETE" +#~ msgstr "DELETE" +#~ msgid "state management" +#~ msgstr "state management" + +#~ msgid "statements" +#~ msgstr "statements" + +#~ msgid "Connection" +#~ msgstr "Connection" + +#~ msgid "session.connection()" +#~ msgstr "session.connection()" Modified: core/trunk/documentation/manual/translations/pt-BR/content/toolset_guide.po =================================================================== --- core/trunk/documentation/manual/translations/pt-BR/content/toolset_guide.po 2007-10-25 22:34:46 UTC (rev 14134) +++ core/trunk/documentation/manual/translations/pt-BR/content/toolset_guide.po 2007-10-26 00:46:38 UTC (rev 14135) @@ -1,662 +1,1179 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: toolset_guide.xml:5 +#, no-c-format msgid "Toolset Guide" -msgstr "" +msgstr "Toolset Guide" -#: index.docbook:7 -msgid "Roundtrip engineering with Hibernate is possible using a set of Eclipse plugins, commandline tools, as well as Ant tasks." +#. Tag: para +#: toolset_guide.xml:7 +#, no-c-format +msgid "" +"Roundtrip engineering with Hibernate is possible using a set of Eclipse " +"plugins, commandline tools, as well as Ant tasks." msgstr "" +"Roundtrip engineering with Hibernate is possible using a set of Eclipse " +"plugins, commandline tools, as well as Ant tasks." -#: index.docbook:12 -msgid "The <emphasis>Hibernate Tools</emphasis> currently include plugins for the Eclipse IDE as well as Ant tasks for reverse engineering of existing databases:" +#. Tag: para +#: toolset_guide.xml:12 +#, no-c-format +msgid "" +"The <emphasis>Hibernate Tools</emphasis> currently include plugins for the " +"Eclipse IDE as well as Ant tasks for reverse engineering of existing " +"databases:" msgstr "" +"The <emphasis>Hibernate Tools</emphasis> currently include plugins for the " +"Eclipse IDE as well as Ant tasks for reverse engineering of existing " +"databases:" -#: index.docbook:18 -msgid "<emphasis>Mapping Editor:</emphasis> An editor for Hibernate XML mapping files, supporting auto-completion and syntax highlighting. It also supports semantic auto-completion for class names and property/field names, making it much more versatile than a normal XML editor." +#. Tag: para +#: toolset_guide.xml:18 +#, no-c-format +msgid "" +"<emphasis>Mapping Editor:</emphasis> An editor for Hibernate XML mapping " +"files, supporting auto-completion and syntax highlighting. It also supports " +"semantic auto-completion for class names and property/field names, making it " +"much more versatile than a normal XML editor." msgstr "" +"<emphasis>Mapping Editor:</emphasis> An editor for Hibernate XML mapping " +"files, supporting auto-completion and syntax highlighting. It also supports " +"semantic auto-completion for class names and property/field names, making it " +"much more versatile than a normal XML editor." -#: index.docbook:23 -msgid "<emphasis>Console:</emphasis> The console is a new view in Eclipse. In addition to a tree overview of your console configurations, you also get an interactive view of your persistent classes and their relationships. The console allows you to execute HQL queries against your database and browse the result directly in Eclipse." +#. Tag: para +#: toolset_guide.xml:23 +#, no-c-format +msgid "" +"<emphasis>Console:</emphasis> The console is a new view in Eclipse. In " +"addition to a tree overview of your console configurations, you also get an " +"interactive view of your persistent classes and their relationships. The " +"console allows you to execute HQL queries against your database and browse " +"the result directly in Eclipse." msgstr "" +"<emphasis>Console:</emphasis> The console is a new view in Eclipse. In " +"addition to a tree overview of your console configurations, you also get an " +"interactive view of your persistent classes and their relationships. The " +"console allows you to execute HQL queries against your database and browse " +"the result directly in Eclipse." -#: index.docbook:30 -msgid "<emphasis>Development Wizards:</emphasis> Several wizards are provided with the Hibernate Eclipse tools; you can use a wizard to quickly generate Hibernate configuration (cfg.xml) files, or you may even completely reverse engineer an existing database schema into POJO source files and Hibernate mapping files. The reverse engineering wizard supports customizable templates." +#. Tag: para +#: toolset_guide.xml:30 +#, no-c-format +msgid "" +"<emphasis>Development Wizards:</emphasis> Several wizards are provided with " +"the Hibernate Eclipse tools; you can use a wizard to quickly generate " +"Hibernate configuration (cfg.xml) files, or you may even completely reverse " +"engineer an existing database schema into POJO source files and Hibernate " +"mapping files. The reverse engineering wizard supports customizable " +"templates." msgstr "" +"<emphasis>Development Wizards:</emphasis> Several wizards are provided with " +"the Hibernate Eclipse tools; you can use a wizard to quickly generate " +"Hibernate configuration (cfg.xml) files, or you may even completely reverse " +"engineer an existing database schema into POJO source files and Hibernate " +"mapping files. The reverse engineering wizard supports customizable " +"templates." -#: index.docbook:38 +#. Tag: emphasis +#: toolset_guide.xml:38 +#, no-c-format msgid "Ant Tasks:" -msgstr "" +msgstr "Ant Tasks:" -#: index.docbook:43 -msgid "Please refer to the <emphasis>Hibernate Tools</emphasis> package and it's documentation for more information." +#. Tag: para +#: toolset_guide.xml:43 +#, no-c-format +msgid "" +"Please refer to the <emphasis>Hibernate Tools</emphasis> package and it's " +"documentation for more information." msgstr "" +"Please refer to the <emphasis>Hibernate Tools</emphasis> package and it's " +"documentation for more information." -#: index.docbook:48 -msgid "However, the Hibernate main package comes bundled with an integrated tool (it can even be used from \"inside\" Hibernate on-the-fly): <emphasis>SchemaExport</emphasis> aka <literal>hbm2ddl</literal>." +#. Tag: para +#: toolset_guide.xml:48 +#, no-c-format +msgid "" +"However, the Hibernate main package comes bundled with an integrated tool " +"(it can even be used from \"inside\" Hibernate on-the-fly): " +"<emphasis>SchemaExport</emphasis> aka <literal>hbm2ddl</literal>." msgstr "" +"However, the Hibernate main package comes bundled with an integrated tool " +"(it can even be used from \"inside\" Hibernate on-the-fly): " +"<emphasis>SchemaExport</emphasis> aka <literal>hbm2ddl</literal>." -#: index.docbook:55 +#. Tag: title +#: toolset_guide.xml:55 +#, no-c-format msgid "Automatic schema generation" -msgstr "" +msgstr "Automatic schema generation" -#: index.docbook:57 -msgid "DDL may be generated from your mapping files by a Hibernate utility. The generated schema includes referential integrity constraints (primary and foreign keys) for entity and collection tables. Tables and sequences are also created for mapped identifier generators." +#. Tag: para +#: toolset_guide.xml:57 +#, no-c-format +msgid "" +"DDL may be generated from your mapping files by a Hibernate utility. The " +"generated schema includes referential integrity constraints (primary and " +"foreign keys) for entity and collection tables. Tables and sequences are " +"also created for mapped identifier generators." msgstr "" +"DDL may be generated from your mapping files by a Hibernate utility. The " +"generated schema includes referential integrity constraints (primary and " +"foreign keys) for entity and collection tables. Tables and sequences are " +"also created for mapped identifier generators." -#: index.docbook:64 -msgid "You <emphasis>must</emphasis> specify a SQL <literal>Dialect</literal> via the <literal>hibernate.dialect</literal> property when using this tool, as DDL is highly vendor specific." +#. Tag: para +#: toolset_guide.xml:64 +#, no-c-format +msgid "" +"You <emphasis>must</emphasis> specify a SQL <literal>Dialect</literal> via " +"the <literal>hibernate.dialect</literal> property when using this tool, as " +"DDL is highly vendor specific." msgstr "" +"You <emphasis>must</emphasis> specify a SQL <literal>Dialect</literal> via " +"the <literal>hibernate.dialect</literal> property when using this tool, as " +"DDL is highly vendor specific." -#: index.docbook:70 +#. Tag: para +#: toolset_guide.xml:70 +#, no-c-format msgid "First, customize your mapping files to improve the generated schema." -msgstr "" +msgstr "First, customize your mapping files to improve the generated schema." -#: index.docbook:75 +#. Tag: title +#: toolset_guide.xml:75 +#, no-c-format msgid "Customizing the schema" -msgstr "" +msgstr "Customizing the schema" -#: index.docbook:77 -msgid "Many Hibernate mapping elements define optional attributes named <literal>length</literal>, <literal>precision</literal> and <literal>scale</literal>. You may set the length, precision and scale of a column with this attribute." +#. Tag: para +#: toolset_guide.xml:77 +#, no-c-format +msgid "" +"Many Hibernate mapping elements define optional attributes named " +"<literal>length</literal>, <literal>precision</literal> and <literal>scale</" +"literal>. You may set the length, precision and scale of a column with this " +"attribute." msgstr "" +"Many Hibernate mapping elements define optional attributes named " +"<literal>length</literal>, <literal>precision</literal> and <literal>scale</" +"literal>. You may set the length, precision and scale of a column with this " +"attribute." -#: index.docbook:84 +#. Tag: programlisting +#: toolset_guide.xml:84 +#, no-c-format msgid "<![CDATA[<property name=\"zip\" length=\"5\"/>]]>" msgstr "" -#: index.docbook:85 +#. Tag: programlisting +#: toolset_guide.xml:85 +#, no-c-format msgid "<![CDATA[<property name=\"balance\" precision=\"12\" scale=\"2\"/>]]>" msgstr "" -#: index.docbook:87 -msgid "Some tags also accept a <literal>not-null</literal> attribute (for generating a <literal>NOT NULL</literal> constraint on table columns) and a <literal>unique</literal> attribute (for generating <literal>UNIQUE</literal> constraint on table columns)." +#. Tag: para +#: toolset_guide.xml:87 +#, no-c-format +msgid "" +"Some tags also accept a <literal>not-null</literal> attribute (for " +"generating a <literal>NOT NULL</literal> constraint on table columns) and a " +"<literal>unique</literal> attribute (for generating <literal>UNIQUE</" +"literal> constraint on table columns)." msgstr "" +"Some tags also accept a <literal>not-null</literal> attribute (for " +"generating a <literal>NOT NULL</literal> constraint on table columns) and a " +"<literal>unique</literal> attribute (for generating <literal>UNIQUE</" +"literal> constraint on table columns)." -#: index.docbook:93 -msgid "<![CDATA[<many-to-one name=\"bar\" column=\"barId\" not-null=\"true\"/>]]>" +#. Tag: programlisting +#: toolset_guide.xml:93 +#, no-c-format +msgid "" +"<![CDATA[<many-to-one name=\"bar\" column=\"barId\" not-null=\"true\"/>]]>" msgstr "" -#: index.docbook:95 -msgid "<![CDATA[<element column=\"serialNumber\" type=\"long\" not-null=\"true\" unique=\"true\"/>]]>" +#. Tag: programlisting +#: toolset_guide.xml:95 +#, no-c-format +msgid "" +"<![CDATA[<element column=\"serialNumber\" type=\"long\" not-null=\"true\" " +"unique=\"true\"/>]]>" msgstr "" -#: index.docbook:97 -msgid "A <literal>unique-key</literal> attribute may be used to group columns in a single unique key constraint. Currently, the specified value of the <literal>unique-key</literal> attribute is <emphasis>not</emphasis> used to name the constraint in the generated DDL, only to group the columns in the mapping file." +#. Tag: para +#: toolset_guide.xml:97 +#, no-c-format +msgid "" +"A <literal>unique-key</literal> attribute may be used to group columns in a " +"single unique key constraint. Currently, the specified value of the " +"<literal>unique-key</literal> attribute is <emphasis>not</emphasis> used to " +"name the constraint in the generated DDL, only to group the columns in the " +"mapping file." msgstr "" +"A <literal>unique-key</literal> attribute may be used to group columns in a " +"single unique key constraint. Currently, the specified value of the " +"<literal>unique-key</literal> attribute is <emphasis>not</emphasis> used to " +"name the constraint in the generated DDL, only to group the columns in the " +"mapping file." -#: index.docbook:105 +#. Tag: programlisting +#: toolset_guide.xml:105 +#, no-c-format msgid "" - "<![CDATA[<many-to-one name=\"org\" column=\"orgId\" unique-key=\"OrgEmployeeId\"/>\n" - "<property name=\"employeeId\" unique-key=\"OrgEmployee\"/>]]>" +"<![CDATA[<many-to-one name=\"org\" column=\"orgId\" unique-key=" +"\"OrgEmployeeId\"/>\n" +"<property name=\"employeeId\" unique-key=\"OrgEmployee\"/>]]>" msgstr "" -#: index.docbook:107 -msgid "An <literal>index</literal> attribute specifies the name of an index that will be created using the mapped column or columns. Multiple columns may be grouped into the same index, simply by specifying the same index name." +#. Tag: para +#: toolset_guide.xml:107 +#, no-c-format +msgid "" +"An <literal>index</literal> attribute specifies the name of an index that " +"will be created using the mapped column or columns. Multiple columns may be " +"grouped into the same index, simply by specifying the same index name." msgstr "" +"An <literal>index</literal> attribute specifies the name of an index that " +"will be created using the mapped column or columns. Multiple columns may be " +"grouped into the same index, simply by specifying the same index name." -#: index.docbook:113 +#. Tag: programlisting +#: toolset_guide.xml:113 +#, no-c-format msgid "" - "<![CDATA[<property name=\"lastName\" index=\"CustName\"/>\n" - "<property name=\"firstName\" index=\"CustName\"/>]]>" +"<![CDATA[<property name=\"lastName\" index=\"CustName\"/>\n" +"<property name=\"firstName\" index=\"CustName\"/>]]>" msgstr "" -#: index.docbook:115 -msgid "A <literal>foreign-key</literal> attribute may be used to override the name of any generated foreign key constraint." +#. Tag: para +#: toolset_guide.xml:115 +#, no-c-format +msgid "" +"A <literal>foreign-key</literal> attribute may be used to override the name " +"of any generated foreign key constraint." msgstr "" +"A <literal>foreign-key</literal> attribute may be used to override the name " +"of any generated foreign key constraint." -#: index.docbook:120 -msgid "<![CDATA[<many-to-one name=\"bar\" column=\"barId\" foreign-key=\"FKFooBar\"/>]]>" +#. Tag: programlisting +#: toolset_guide.xml:120 +#, no-c-format +msgid "" +"<![CDATA[<many-to-one name=\"bar\" column=\"barId\" foreign-key=\"FKFooBar\"/" +">]]>" msgstr "" -#: index.docbook:122 -msgid "Many mapping elements also accept a child <literal><column></literal> element. This is particularly useful for mapping multi-column types:" +#. Tag: para +#: toolset_guide.xml:122 +#, no-c-format +msgid "" +"Many mapping elements also accept a child <literal><column></literal> " +"element. This is particularly useful for mapping multi-column types:" msgstr "" +"Many mapping elements also accept a child <literal><column></literal> " +"element. This is particularly useful for mapping multi-column types:" -#: index.docbook:127 +#. Tag: programlisting +#: toolset_guide.xml:127 +#, no-c-format msgid "" - "<![CDATA[<property name=\"name\" type=\"my.customtypes.Name\"/>\n" - " <column name=\"last\" not-null=\"true\" index=\"bar_idx\" length=\"30\"/>\n" - " <column name=\"first\" not-null=\"true\" index=\"bar_idx\" length=\"20\"/>\n" - " <column name=\"initial\"/>\n" - "</property>]]>" +"<![CDATA[<property name=\"name\" type=\"my.customtypes.Name\"/>\n" +" <column name=\"last\" not-null=\"true\" index=\"bar_idx\" length=\"30\"/" +">\n" +" <column name=\"first\" not-null=\"true\" index=\"bar_idx\" length=\"20\"/" +">\n" +" <column name=\"initial\"/>\n" +"</property>]]>" msgstr "" -#: index.docbook:129 -msgid "The <literal>default</literal> attribute lets you specify a default value for a column (you should assign the same value to the mapped property before saving a new instance of the mapped class)." +#. Tag: para +#: toolset_guide.xml:129 +#, no-c-format +msgid "" +"The <literal>default</literal> attribute lets you specify a default value " +"for a column (you should assign the same value to the mapped property before " +"saving a new instance of the mapped class)." msgstr "" +"The <literal>default</literal> attribute lets you specify a default value " +"for a column (you should assign the same value to the mapped property before " +"saving a new instance of the mapped class)." -#: index.docbook:135 +#. Tag: programlisting +#: toolset_guide.xml:135 +#, no-c-format msgid "" - "<![CDATA[<property name=\"credits\" type=\"integer\" insert=\"false\">\n" - " <column name=\"credits\" default=\"10\"/>\n" - "</property>]]>" +"<![CDATA[<property name=\"credits\" type=\"integer\" insert=\"false\">\n" +" <column name=\"credits\" default=\"10\"/>\n" +"</property>]]>" msgstr "" -#: index.docbook:137 +#. Tag: programlisting +#: toolset_guide.xml:137 +#, no-c-format msgid "" - "<![CDATA[<version name=\"version\" type=\"integer\" insert=\"false\">\n" - " <column name=\"version\" default=\"0\"/>\n" - "</property>]]>" +"<![CDATA[<version name=\"version\" type=\"integer\" insert=\"false\">\n" +" <column name=\"version\" default=\"0\"/>\n" +"</property>]]>" msgstr "" -#: index.docbook:139 -msgid "The <literal>sql-type</literal> attribute allows the user to override the default mapping of a Hibernate type to SQL datatype." +#. Tag: para +#: toolset_guide.xml:139 +#, no-c-format +msgid "" +"The <literal>sql-type</literal> attribute allows the user to override the " +"default mapping of a Hibernate type to SQL datatype." msgstr "" +"The <literal>sql-type</literal> attribute allows the user to override the " +"default mapping of a Hibernate type to SQL datatype." -#: index.docbook:144 +#. Tag: programlisting +#: toolset_guide.xml:144 +#, no-c-format msgid "" - "<![CDATA[<property name=\"balance\" type=\"float\">\n" - " <column name=\"balance\" sql-type=\"decimal(13,3)\"/>\n" - "</property>]]>" +"<![CDATA[<property name=\"balance\" type=\"float\">\n" +" <column name=\"balance\" sql-type=\"decimal(13,3)\"/>\n" +"</property>]]>" msgstr "" -#: index.docbook:146 -msgid "The <literal>check</literal> attribute allows you to specify a check constraint." +#. Tag: para +#: toolset_guide.xml:146 +#, no-c-format +msgid "" +"The <literal>check</literal> attribute allows you to specify a check " +"constraint." msgstr "" +"The <literal>check</literal> attribute allows you to specify a check " +"constraint." -#: index.docbook:150 +#. Tag: programlisting +#: toolset_guide.xml:150 +#, no-c-format msgid "" - "<![CDATA[<property name=\"foo\" type=\"integer\">\n" - " <column name=\"foo\" check=\"foo > 10\"/>\n" - "</property>]]>" +"<![CDATA[<property name=\"foo\" type=\"integer\">\n" +" <column name=\"foo\" check=\"foo > 10\"/>\n" +"</property>]]>" msgstr "" -#: index.docbook:152 +#. Tag: programlisting +#: toolset_guide.xml:152 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Foo\" table=\"foos\" check=\"bar < 100.0\">\n" - " ...\n" - " <property name=\"bar\" type=\"float\"/>\n" - "</class>]]>" +"<![CDATA[<class name=\"Foo\" table=\"foos\" check=\"bar < 100.0\">\n" +" ...\n" +" <property name=\"bar\" type=\"float\"/>\n" +"</class>]]>" msgstr "" -#: index.docbook:156 +#. Tag: title +#: toolset_guide.xml:156 +#, no-c-format msgid "Summary" -msgstr "" +msgstr "Summary" -#: index.docbook:163 +#. Tag: entry +#: toolset_guide.xml:163 +#, no-c-format msgid "Attribute" -msgstr "" +msgstr "Attribute" -#: index.docbook:164 +#. Tag: entry +#: toolset_guide.xml:164 +#, no-c-format msgid "Values" -msgstr "" +msgstr "Values" -#: index.docbook:165 +#. Tag: entry +#: toolset_guide.xml:165 +#, no-c-format msgid "Interpretation" -msgstr "" +msgstr "Interpretation" -#: index.docbook:170 +#. Tag: literal +#: toolset_guide.xml:170 +#, no-c-format msgid "length" -msgstr "" +msgstr "length" -#: index.docbook:171, index.docbook:176, index.docbook:181 +#. Tag: entry +#: toolset_guide.xml:171 toolset_guide.xml:176 toolset_guide.xml:181 +#, no-c-format msgid "number" -msgstr "" +msgstr "number" -#: index.docbook:172 +#. Tag: entry +#: toolset_guide.xml:172 +#, no-c-format msgid "column length" -msgstr "" +msgstr "column length" -#: index.docbook:175 +#. Tag: literal +#: toolset_guide.xml:175 +#, no-c-format msgid "precision" -msgstr "" +msgstr "precision" -#: index.docbook:177 +#. Tag: entry +#: toolset_guide.xml:177 +#, no-c-format msgid "column decimal precision" -msgstr "" +msgstr "column decimal precision" -#: index.docbook:180 +#. Tag: literal +#: toolset_guide.xml:180 +#, no-c-format msgid "scale" -msgstr "" +msgstr "scale" -#: index.docbook:182 +#. Tag: entry +#: toolset_guide.xml:182 +#, no-c-format msgid "column decimal scale" -msgstr "" +msgstr "column decimal scale" -#: index.docbook:185 +#. Tag: literal +#: toolset_guide.xml:185 +#, no-c-format msgid "not-null" -msgstr "" +msgstr "not-null" -#: index.docbook:186, index.docbook:191 +#. Tag: literal +#: toolset_guide.xml:186 toolset_guide.xml:191 +#, no-c-format msgid "true|false" -msgstr "" +msgstr "true|false" -#: index.docbook:187 +#. Tag: entry +#: toolset_guide.xml:187 +#, no-c-format msgid "specfies that the column should be non-nullable" -msgstr "" +msgstr "specfies that the column should be non-nullable" -#: index.docbook:190 +#. Tag: literal +#: toolset_guide.xml:190 +#, no-c-format msgid "unique" -msgstr "" +msgstr "unique" -#: index.docbook:192 +#. Tag: entry +#: toolset_guide.xml:192 +#, no-c-format msgid "specifies that the column should have a unique constraint" -msgstr "" +msgstr "specifies that the column should have a unique constraint" -#: index.docbook:195 +#. Tag: literal +#: toolset_guide.xml:195 +#, no-c-format msgid "index" -msgstr "" +msgstr "index" -#: index.docbook:196 +#. Tag: literal +#: toolset_guide.xml:196 +#, no-c-format msgid "index_name" -msgstr "" +msgstr "index_name" -#: index.docbook:197 +#. Tag: entry +#: toolset_guide.xml:197 +#, no-c-format msgid "specifies the name of a (multi-column) index" -msgstr "" +msgstr "specifies the name of a (multi-column) index" -#: index.docbook:200 +#. Tag: literal +#: toolset_guide.xml:200 +#, no-c-format msgid "unique-key" -msgstr "" +msgstr "unique-key" -#: index.docbook:201 +#. Tag: literal +#: toolset_guide.xml:201 +#, no-c-format msgid "unique_key_name" -msgstr "" +msgstr "unique_key_name" -#: index.docbook:202 +#. Tag: entry +#: toolset_guide.xml:202 +#, no-c-format msgid "specifies the name of a multi-column unique constraint" -msgstr "" +msgstr "specifies the name of a multi-column unique constraint" -#: index.docbook:205 +#. Tag: literal +#: toolset_guide.xml:205 +#, no-c-format msgid "foreign-key" -msgstr "" +msgstr "foreign-key" -#: index.docbook:206 +#. Tag: literal +#: toolset_guide.xml:206 +#, no-c-format msgid "foreign_key_name" -msgstr "" +msgstr "foreign_key_name" -#: index.docbook:207 -msgid "specifies the name of the foreign key constraint generated for an association, for a <literal><one-to-one></literal>, <literal><many-to-one></literal>, <literal><key></literal>, or <literal><many-to-many></literal> mapping element. Note that <literal>inverse=\"true\"</literal> sides will not be considered by <literal>SchemaExport</literal>." +#. Tag: entry +#: toolset_guide.xml:207 +#, fuzzy, no-c-format +msgid "" +"specifies the name of the foreign key constraint generated for an " +"association, for a <literal><one-to-one></literal>, <literal><many-" +"to-one></literal>, <literal><key></literal>, or <literal><many-" +"to-many></literal> mapping element. Note that <literal>inverse=\"true\"</" +"literal> sides will not be considered by <literal>SchemaExport</literal>." msgstr "" +"specifies the name of the foreign key constraint generated for an " +"association, for a <placeholder-1/>, <placeholder-2/>, <placeholder-3/>, or " +"<placeholder-4/> mapping element. Note that <placeholder-5/> sides will not " +"be considered by <placeholder-6/>." -#: index.docbook:217 +#. Tag: literal +#: toolset_guide.xml:217 +#, no-c-format msgid "sql-type" -msgstr "" +msgstr "sql-type" -#: index.docbook:218 +#. Tag: literal +#: toolset_guide.xml:218 +#, no-c-format msgid "SQL column type" -msgstr "" +msgstr "SQL column type" -#: index.docbook:219 -msgid "overrides the default column type (attribute of <literal><column></literal> element only)" +#. Tag: entry +#: toolset_guide.xml:219 +#, fuzzy, no-c-format +msgid "" +"overrides the default column type (attribute of <literal><column></" +"literal> element only)" msgstr "" +"overrides the default column type (attribute of <placeholder-1/> element " +"only)" -#: index.docbook:225 +#. Tag: literal +#: toolset_guide.xml:225 +#, no-c-format msgid "default" -msgstr "" +msgstr "default" -#: index.docbook:226, index.docbook:233 +#. Tag: entry +#: toolset_guide.xml:226 toolset_guide.xml:233 +#, no-c-format msgid "SQL expression" -msgstr "" +msgstr "SQL expression" -#: index.docbook:227 +#. Tag: entry +#: toolset_guide.xml:227 +#, no-c-format msgid "specify a default value for the column" -msgstr "" +msgstr "specify a default value for the column" -#: index.docbook:232 +#. Tag: literal +#: toolset_guide.xml:232 +#, no-c-format msgid "check" -msgstr "" +msgstr "check" -#: index.docbook:234 +#. Tag: entry +#: toolset_guide.xml:234 +#, no-c-format msgid "create an SQL check constraint on either column or table" -msgstr "" +msgstr "create an SQL check constraint on either column or table" -#: index.docbook:242 -msgid "The <literal><comment></literal> element allows you to specify comments for the generated schema." +#. Tag: para +#: toolset_guide.xml:242 +#, no-c-format +msgid "" +"The <literal><comment></literal> element allows you to specify " +"comments for the generated schema." msgstr "" +"The <literal><comment></literal> element allows you to specify " +"comments for the generated schema." -#: index.docbook:247 +#. Tag: programlisting +#: toolset_guide.xml:247 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Customer\" table=\"CurCust\">\n" - " <comment>Current customers only</comment>\n" - " ...\n" - "</class>]]>" +"<![CDATA[<class name=\"Customer\" table=\"CurCust\">\n" +" <comment>Current customers only</comment>\n" +" ...\n" +"</class>]]>" msgstr "" -#: index.docbook:249 +#. Tag: programlisting +#: toolset_guide.xml:249 +#, no-c-format msgid "" - "<![CDATA[<property name=\"balance\">\n" - " <column name=\"bal\">\n" - " <comment>Balance in USD</comment>\n" - " </column>\n" - "</property>]]>" +"<![CDATA[<property name=\"balance\">\n" +" <column name=\"bal\">\n" +" <comment>Balance in USD</comment>\n" +" </column>\n" +"</property>]]>" msgstr "" -#: index.docbook:251 -msgid "This results in a <literal>comment on table</literal> or <literal>comment on column</literal> statement in the generated DDL (where supported)." +#. Tag: para +#: toolset_guide.xml:251 +#, no-c-format +msgid "" +"This results in a <literal>comment on table</literal> or <literal>comment on " +"column</literal> statement in the generated DDL (where supported)." msgstr "" +"This results in a <literal>comment on table</literal> or <literal>comment on " +"column</literal> statement in the generated DDL (where supported)." -#: index.docbook:260 +#. Tag: title +#: toolset_guide.xml:260 +#, no-c-format msgid "Running the tool" -msgstr "" +msgstr "Running the tool" -#: index.docbook:262 -msgid "The <literal>SchemaExport</literal> tool writes a DDL script to standard out and/or executes the DDL statements." +#. Tag: para +#: toolset_guide.xml:262 +#, no-c-format +msgid "" +"The <literal>SchemaExport</literal> tool writes a DDL script to standard out " +"and/or executes the DDL statements." msgstr "" +"The <literal>SchemaExport</literal> tool writes a DDL script to standard out " +"and/or executes the DDL statements." -#: index.docbook:267 -msgid "<literal>java -cp </literal><emphasis>hibernate_classpaths</emphasis> <literal>org.hibernate.tool.hbm2ddl.SchemaExport</literal> <emphasis>options mapping_files</emphasis>" +#. Tag: para +#: toolset_guide.xml:267 +#, no-c-format +msgid "" +"<literal>java -cp </literal><emphasis>hibernate_classpaths</emphasis> " +"<literal>org.hibernate.tool.hbm2ddl.SchemaExport</literal> <emphasis>options " +"mapping_files</emphasis>" msgstr "" -#: index.docbook:273 +#. Tag: title +#: toolset_guide.xml:273 +#, no-c-format msgid "<literal>SchemaExport</literal> Command Line Options" -msgstr "" +msgstr "<literal>SchemaExport</literal> Command Line Options" -#: index.docbook:279, index.docbook:429, index.docbook:498 +#. Tag: entry +#: toolset_guide.xml:279 toolset_guide.xml:429 toolset_guide.xml:498 +#, no-c-format msgid "Option" -msgstr "" +msgstr "Option" -#: index.docbook:280, index.docbook:367, index.docbook:430, index.docbook:499 +#. Tag: entry +#: toolset_guide.xml:280 toolset_guide.xml:367 toolset_guide.xml:430 +#: toolset_guide.xml:499 +#, no-c-format msgid "Description" -msgstr "" +msgstr "Description" -#: index.docbook:285, index.docbook:435 +#. Tag: literal +#: toolset_guide.xml:285 toolset_guide.xml:435 +#, no-c-format msgid "--quiet" -msgstr "" +msgstr "--quiet" -#: index.docbook:286, index.docbook:436 +#. Tag: entry +#: toolset_guide.xml:286 toolset_guide.xml:436 +#, no-c-format msgid "don't output the script to stdout" -msgstr "" +msgstr "don't output the script to stdout" -#: index.docbook:289 +#. Tag: literal +#: toolset_guide.xml:289 +#, no-c-format msgid "--drop" -msgstr "" +msgstr "--drop" -#: index.docbook:290 +#. Tag: entry +#: toolset_guide.xml:290 +#, no-c-format msgid "only drop the tables" -msgstr "" +msgstr "only drop the tables" -#: index.docbook:293 +#. Tag: literal +#: toolset_guide.xml:293 +#, no-c-format msgid "--create" -msgstr "" +msgstr "--create" -#: index.docbook:294 +#. Tag: entry +#: toolset_guide.xml:294 +#, no-c-format msgid "only create the tables" -msgstr "" +msgstr "only create the tables" -#: index.docbook:297, index.docbook:439 +#. Tag: literal +#: toolset_guide.xml:297 toolset_guide.xml:439 +#, no-c-format msgid "--text" -msgstr "" +msgstr "--text" -#: index.docbook:298 +#. Tag: entry +#: toolset_guide.xml:298 +#, no-c-format msgid "don't export to the database" -msgstr "" +msgstr "don't export to the database" -#: index.docbook:301 +#. Tag: literal +#: toolset_guide.xml:301 +#, no-c-format msgid "--output=my_schema.ddl" -msgstr "" +msgstr "--output=my_schema.ddl" -#: index.docbook:302 +#. Tag: entry +#: toolset_guide.xml:302 +#, no-c-format msgid "output the ddl script to a file" -msgstr "" +msgstr "output the ddl script to a file" -#: index.docbook:305, index.docbook:443, index.docbook:504 +#. Tag: literal +#: toolset_guide.xml:305 toolset_guide.xml:443 toolset_guide.xml:504 +#, no-c-format msgid "--naming=eg.MyNamingStrategy" -msgstr "" +msgstr "--naming=eg.MyNamingStrategy" -#: index.docbook:306, index.docbook:444, index.docbook:505 +#. Tag: entry +#: toolset_guide.xml:306 toolset_guide.xml:444 toolset_guide.xml:505 +#, fuzzy, no-c-format msgid "select a <literal>NamingStrategy</literal>" -msgstr "" +msgstr "in <literal>hibernate.properties</literal>" -#: index.docbook:309, index.docbook:451, index.docbook:512 +#. Tag: literal +#: toolset_guide.xml:309 toolset_guide.xml:451 toolset_guide.xml:512 +#, no-c-format msgid "--config=hibernate.cfg.xml" -msgstr "" +msgstr "--config=hibernate.cfg.xml" -#: index.docbook:310 +#. Tag: entry +#: toolset_guide.xml:310 +#, no-c-format msgid "read Hibernate configuration from an XML file" -msgstr "" +msgstr "read Hibernate configuration from an XML file" -#: index.docbook:313, index.docbook:447, index.docbook:508 +#. Tag: literal +#: toolset_guide.xml:313 toolset_guide.xml:447 toolset_guide.xml:508 +#, no-c-format msgid "--properties=hibernate.properties" -msgstr "" +msgstr "--properties=hibernate.properties" -#: index.docbook:314, index.docbook:448, index.docbook:509 +#. Tag: entry +#: toolset_guide.xml:314 toolset_guide.xml:448 toolset_guide.xml:509 +#, no-c-format msgid "read database properties from a file" -msgstr "" +msgstr "read database properties from a file" -#: index.docbook:317 +#. Tag: literal +#: toolset_guide.xml:317 +#, no-c-format msgid "--format" -msgstr "" +msgstr "--format" -#: index.docbook:318 +#. Tag: entry +#: toolset_guide.xml:318 +#, no-c-format msgid "format the generated SQL nicely in the script" -msgstr "" +msgstr "format the generated SQL nicely in the script" -#: index.docbook:321 +#. Tag: literal +#: toolset_guide.xml:321 +#, no-c-format msgid "--delimiter=;" -msgstr "" +msgstr "--delimiter=;" -#: index.docbook:322 +#. Tag: entry +#: toolset_guide.xml:322 +#, no-c-format msgid "set an end of line delimiter for the script" -msgstr "" +msgstr "set an end of line delimiter for the script" -#: index.docbook:328 +#. Tag: para +#: toolset_guide.xml:328 +#, no-c-format msgid "You may even embed <literal>SchemaExport</literal> in your application:" msgstr "" +"You may even embed <literal>SchemaExport</literal> in your application:" -#: index.docbook:332 +#. Tag: programlisting +#: toolset_guide.xml:332 +#, no-c-format msgid "" - "<![CDATA[Configuration cfg = ....;\n" - "new SchemaExport(cfg).create(false, true);]]>" +"<![CDATA[Configuration cfg = ....;\n" +"new SchemaExport(cfg).create(false, true);]]>" msgstr "" -#: index.docbook:337 +#. Tag: title +#: toolset_guide.xml:337 +#, no-c-format msgid "Properties" -msgstr "" +msgstr "Properties" -#: index.docbook:339 +#. Tag: para +#: toolset_guide.xml:339 +#, no-c-format msgid "Database properties may be specified" -msgstr "" +msgstr "Database properties may be specified" -#: index.docbook:345 -msgid "as system properties with <literal>-D</literal><emphasis><property></emphasis>" +#. Tag: para +#: toolset_guide.xml:345 +#, no-c-format +msgid "" +"as system properties with <literal>-D</literal><emphasis><property></" +"emphasis>" msgstr "" +"as system properties with <literal>-D</literal><emphasis><property></" +"emphasis>" -#: index.docbook:348 +#. Tag: para +#: toolset_guide.xml:348 +#, no-c-format msgid "in <literal>hibernate.properties</literal>" -msgstr "" +msgstr "in <literal>hibernate.properties</literal>" -#: index.docbook:351 +#. Tag: para +#: toolset_guide.xml:351 +#, no-c-format msgid "in a named properties file with <literal>--properties</literal>" -msgstr "" +msgstr "in a named properties file with <literal>--properties</literal>" -#: index.docbook:355 +#. Tag: para +#: toolset_guide.xml:355 +#, no-c-format msgid "The needed properties are:" -msgstr "" +msgstr "The needed properties are:" -#: index.docbook:360 +#. Tag: title +#: toolset_guide.xml:360 +#, no-c-format msgid "SchemaExport Connection Properties" -msgstr "" +msgstr "SchemaExport Connection Properties" -#: index.docbook:366 +#. Tag: entry +#: toolset_guide.xml:366 +#, no-c-format msgid "Property Name" -msgstr "" +msgstr "Property Name" -#: index.docbook:372 +#. Tag: literal +#: toolset_guide.xml:372 +#, no-c-format msgid "hibernate.connection.driver_class" -msgstr "" +msgstr "hibernate.connection.driver_class" -#: index.docbook:373 +#. Tag: entry +#: toolset_guide.xml:373 +#, no-c-format msgid "jdbc driver class" -msgstr "" +msgstr "jdbc driver class" -#: index.docbook:376 +#. Tag: literal +#: toolset_guide.xml:376 +#, no-c-format msgid "hibernate.connection.url" -msgstr "" +msgstr "hibernate.connection.url" -#: index.docbook:377 +#. Tag: entry +#: toolset_guide.xml:377 +#, no-c-format msgid "jdbc url" -msgstr "" +msgstr "jdbc url" -#: index.docbook:380 +#. Tag: literal +#: toolset_guide.xml:380 +#, no-c-format msgid "hibernate.connection.username" -msgstr "" +msgstr "hibernate.connection.username" -#: index.docbook:381 +#. Tag: entry +#: toolset_guide.xml:381 +#, no-c-format msgid "database user" -msgstr "" +msgstr "database user" -#: index.docbook:384 +#. Tag: literal +#: toolset_guide.xml:384 +#, no-c-format msgid "hibernate.connection.password" -msgstr "" +msgstr "hibernate.connection.password" -#: index.docbook:385 +#. Tag: entry +#: toolset_guide.xml:385 +#, no-c-format msgid "user password" -msgstr "" +msgstr "user password" -#: index.docbook:388 +#. Tag: literal +#: toolset_guide.xml:388 +#, no-c-format msgid "hibernate.dialect" -msgstr "" +msgstr "hibernate.dialect" -#: index.docbook:389 +#. Tag: entry +#: toolset_guide.xml:389 +#, no-c-format msgid "dialect" -msgstr "" +msgstr "dialect" -#: index.docbook:398 +#. Tag: title +#: toolset_guide.xml:398 +#, no-c-format msgid "Using Ant" -msgstr "" +msgstr "Using Ant" -#: index.docbook:400 -msgid "You can call <literal>SchemaExport</literal> from your Ant build script:" +#. Tag: para +#: toolset_guide.xml:400 +#, no-c-format +msgid "" +"You can call <literal>SchemaExport</literal> from your Ant build script:" msgstr "" +"You can call <literal>SchemaExport</literal> from your Ant build script:" -#: index.docbook:404 +#. Tag: programlisting +#: toolset_guide.xml:404 +#, no-c-format msgid "" - "<![CDATA[<target name=\"schemaexport\">\n" - " <taskdef name=\"schemaexport\"\n" - " classname=\"org.hibernate.tool.hbm2ddl.SchemaExportTask\"\n" - " classpathref=\"class.path\"/>\n" - " \n" - " <schemaexport\n" - " properties=\"hibernate.properties\"\n" - " quiet=\"no\"\n" - " text=\"no\"\n" - " drop=\"no\"\n" - " delimiter=\";\"\n" - " output=\"schema-export.sql\">\n" - " <fileset dir=\"src\">\n" - " <include name=\"**/*.hbm.xml\"/>\n" - " </fileset>\n" - " </schemaexport>\n" - "</target>]]>" +"<![CDATA[<target name=\"schemaexport\">\n" +" <taskdef name=\"schemaexport\"\n" +" classname=\"org.hibernate.tool.hbm2ddl.SchemaExportTask\"\n" +" classpathref=\"class.path\"/>\n" +" \n" +" <schemaexport\n" +" properties=\"hibernate.properties\"\n" +" quiet=\"no\"\n" +" text=\"no\"\n" +" drop=\"no\"\n" +" delimiter=\";\"\n" +" output=\"schema-export.sql\">\n" +" <fileset dir=\"src\">\n" +" <include name=\"**/*.hbm.xml\"/>\n" +" </fileset>\n" +" </schemaexport>\n" +"</target>]]>" msgstr "" -#: index.docbook:409 +#. Tag: title +#: toolset_guide.xml:409 +#, no-c-format msgid "Incremental schema updates" -msgstr "" +msgstr "Incremental schema updates" -#: index.docbook:411 -msgid "The <literal>SchemaUpdate</literal> tool will update an existing schema with \"incremental\" changes. Note that <literal>SchemaUpdate</literal> depends heavily upon the JDBC metadata API, so it will not work with all JDBC drivers." +#. Tag: para +#: toolset_guide.xml:411 +#, no-c-format +msgid "" +"The <literal>SchemaUpdate</literal> tool will update an existing schema with " +"\"incremental\" changes. Note that <literal>SchemaUpdate</literal> depends " +"heavily upon the JDBC metadata API, so it will not work with all JDBC " +"drivers." msgstr "" +"The <literal>SchemaUpdate</literal> tool will update an existing schema with " +"\"incremental\" changes. Note that <literal>SchemaUpdate</literal> depends " +"heavily upon the JDBC metadata API, so it will not work with all JDBC " +"drivers." -#: index.docbook:417 -msgid "<literal>java -cp </literal><emphasis>hibernate_classpaths</emphasis> <literal>org.hibernate.tool.hbm2ddl.SchemaUpdate</literal> <emphasis>options mapping_files</emphasis>" +#. Tag: para +#: toolset_guide.xml:417 +#, no-c-format +msgid "" +"<literal>java -cp </literal><emphasis>hibernate_classpaths</emphasis> " +"<literal>org.hibernate.tool.hbm2ddl.SchemaUpdate</literal> <emphasis>options " +"mapping_files</emphasis>" msgstr "" -#: index.docbook:423 +#. Tag: title +#: toolset_guide.xml:423 +#, no-c-format msgid "<literal>SchemaUpdate</literal> Command Line Options" -msgstr "" +msgstr "<literal>SchemaUpdate</literal> Command Line Options" -#: index.docbook:440 +#. Tag: entry +#: toolset_guide.xml:440 +#, no-c-format msgid "don't export the script to the database" -msgstr "" +msgstr "don't export the script to the database" -#: index.docbook:452, index.docbook:513 +#. Tag: entry +#: toolset_guide.xml:452 toolset_guide.xml:513 +#, fuzzy, no-c-format msgid "specify a <literal>.cfg.xml</literal> file" -msgstr "" +msgstr "specify a <placeholder-1/> file" -#: index.docbook:458 +#. Tag: para +#: toolset_guide.xml:458 +#, no-c-format msgid "You may embed <literal>SchemaUpdate</literal> in your application:" -msgstr "" +msgstr "You may embed <literal>SchemaUpdate</literal> in your application:" -#: index.docbook:462 +#. Tag: programlisting +#: toolset_guide.xml:462 +#, no-c-format msgid "" - "<![CDATA[Configuration cfg = ....;\n" - "new SchemaUpdate(cfg).execute(false);]]>" +"<![CDATA[Configuration cfg = ....;\n" +"new SchemaUpdate(cfg).execute(false);]]>" msgstr "" -#: index.docbook:467 +#. Tag: title +#: toolset_guide.xml:467 +#, no-c-format msgid "Using Ant for incremental schema updates" -msgstr "" +msgstr "Using Ant for incremental schema updates" -#: index.docbook:469 +#. Tag: para +#: toolset_guide.xml:469 +#, no-c-format msgid "You can call <literal>SchemaUpdate</literal> from the Ant script:" -msgstr "" +msgstr "You can call <literal>SchemaUpdate</literal> from the Ant script:" -#: index.docbook:473 +#. Tag: programlisting +#: toolset_guide.xml:473 +#, no-c-format msgid "" - "<![CDATA[<target name=\"schemaupdate\">\n" - " <taskdef name=\"schemaupdate\"\n" - " classname=\"org.hibernate.tool.hbm2ddl.SchemaUpdateTask\"\n" - " classpathref=\"class.path\"/>\n" - " \n" - " <schemaupdate\n" - " properties=\"hibernate.properties\"\n" - " quiet=\"no\">\n" - " <fileset dir=\"src\">\n" - " <include name=\"**/*.hbm.xml\"/>\n" - " </fileset>\n" - " </schemaupdate>\n" - "</target>]]>" +"<![CDATA[<target name=\"schemaupdate\">\n" +" <taskdef name=\"schemaupdate\"\n" +" classname=\"org.hibernate.tool.hbm2ddl.SchemaUpdateTask\"\n" +" classpathref=\"class.path\"/>\n" +" \n" +" <schemaupdate\n" +" properties=\"hibernate.properties\"\n" +" quiet=\"no\">\n" +" <fileset dir=\"src\">\n" +" <include name=\"**/*.hbm.xml\"/>\n" +" </fileset>\n" +" </schemaupdate>\n" +"</target>]]>" msgstr "" -#: index.docbook:478 +#. Tag: title +#: toolset_guide.xml:478 +#, no-c-format msgid "Schema validation" -msgstr "" +msgstr "Schema validation" -#: index.docbook:480 -msgid "The <literal>SchemaValidator</literal> tool will validate that the existing database schema \"matches\" your mapping documents. Note that <literal>SchemaValidator</literal> depends heavily upon the JDBC metadata API, so it will not work with all JDBC drivers. This tool is extremely useful for testing." +#. Tag: para +#: toolset_guide.xml:480 +#, no-c-format +msgid "" +"The <literal>SchemaValidator</literal> tool will validate that the existing " +"database schema \"matches\" your mapping documents. Note that " +"<literal>SchemaValidator</literal> depends heavily upon the JDBC metadata " +"API, so it will not work with all JDBC drivers. This tool is extremely " +"useful for testing." msgstr "" +"The <literal>SchemaValidator</literal> tool will validate that the existing " +"database schema \"matches\" your mapping documents. Note that " +"<literal>SchemaValidator</literal> depends heavily upon the JDBC metadata " +"API, so it will not work with all JDBC drivers. This tool is extremely " +"useful for testing." -#: index.docbook:486 -msgid "<literal>java -cp </literal><emphasis>hibernate_classpaths</emphasis> <literal>org.hibernate.tool.hbm2ddl.SchemaValidator</literal> <emphasis>options mapping_files</emphasis>" +#. Tag: para +#: toolset_guide.xml:486 +#, no-c-format +msgid "" +"<literal>java -cp </literal><emphasis>hibernate_classpaths</emphasis> " +"<literal>org.hibernate.tool.hbm2ddl.SchemaValidator</literal> " +"<emphasis>options mapping_files</emphasis>" msgstr "" -#: index.docbook:492 +#. Tag: title +#: toolset_guide.xml:492 +#, no-c-format msgid "<literal>SchemaValidator</literal> Command Line Options" -msgstr "" +msgstr "<literal>SchemaValidator</literal> Command Line Options" -#: index.docbook:519 +#. Tag: para +#: toolset_guide.xml:519 +#, no-c-format msgid "You may embed <literal>SchemaValidator</literal> in your application:" -msgstr "" +msgstr "You may embed <literal>SchemaValidator</literal> in your application:" -#: index.docbook:523 +#. Tag: programlisting +#: toolset_guide.xml:523 +#, no-c-format msgid "" - "<![CDATA[Configuration cfg = ....;\n" - "new SchemaValidator(cfg).validate();]]>" +"<![CDATA[Configuration cfg = ....;\n" +"new SchemaValidator(cfg).validate();]]>" msgstr "" -#: index.docbook:528 +#. Tag: title +#: toolset_guide.xml:528 +#, no-c-format msgid "Using Ant for schema validation" -msgstr "" +msgstr "Using Ant for schema validation" -#: index.docbook:530 +#. Tag: para +#: toolset_guide.xml:530 +#, no-c-format msgid "You can call <literal>SchemaValidator</literal> from the Ant script:" -msgstr "" +msgstr "You can call <literal>SchemaValidator</literal> from the Ant script:" -#: index.docbook:534 +#. Tag: programlisting +#: toolset_guide.xml:534 +#, no-c-format msgid "" - "<![CDATA[<target name=\"schemavalidate\">\n" - " <taskdef name=\"schemavalidator\"\n" - " classname=\"org.hibernate.tool.hbm2ddl.SchemaValidatorTask\"\n" - " classpathref=\"class.path\"/>\n" - " \n" - " <schemavalidator\n" - " properties=\"hibernate.properties\">\n" - " <fileset dir=\"src\">\n" - " <include name=\"**/*.hbm.xml\"/>\n" - " </fileset>\n" - " </schemavalidator>\n" - "</target>]]>" +"<![CDATA[<target name=\"schemavalidate\">\n" +" <taskdef name=\"schemavalidator\"\n" +" classname=\"org.hibernate.tool.hbm2ddl.SchemaValidatorTask\"\n" +" classpathref=\"class.path\"/>\n" +" \n" +" <schemavalidator\n" +" properties=\"hibernate.properties\">\n" +" <fileset dir=\"src\">\n" +" <include name=\"**/*.hbm.xml\"/>\n" +" </fileset>\n" +" </schemavalidator>\n" +"</target>]]>" msgstr "" -msgid "ROLES_OF_TRANSLATORS" -msgstr "" +#~ msgid "<one-to-one>" +#~ msgstr "<one-to-one>" -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "" +#~ msgid "<many-to-one>" +#~ msgstr "<many-to-one>" +#~ msgid "<key>" +#~ msgstr "<key>" + +#~ msgid "<many-to-many>" +#~ msgstr "<many-to-many>" + +#~ msgid "inverse=\"true\"" +#~ msgstr "inverse=\"true\"" + +#~ msgid "SchemaExport" +#~ msgstr "SchemaExport" + +#~ msgid "<column>" +#~ msgstr "<column>" + +#~ msgid "java -cp" +#~ msgstr "java -cp" + +#~ msgid "hibernate_classpaths" +#~ msgstr "hibernate_classpaths" + +#~ msgid "org.hibernate.tool.hbm2ddl.SchemaExport" +#~ msgstr "org.hibernate.tool.hbm2ddl.SchemaExport" + +#~ msgid "options mapping_files" +#~ msgstr "options mapping_files" + +#~ msgid "NamingStrategy" +#~ msgstr "NamingStrategy" + +#~ msgid "select a <placeholder-1/>" +#~ msgstr "select a <placeholder-1/>" + +#~ msgid "org.hibernate.tool.hbm2ddl.SchemaUpdate" +#~ msgstr "org.hibernate.tool.hbm2ddl.SchemaUpdate" + +#~ msgid ".cfg.xml" +#~ msgstr ".cfg.xml" + +#~ msgid "org.hibernate.tool.hbm2ddl.SchemaValidator" +#~ msgstr "org.hibernate.tool.hbm2ddl.SchemaValidator" Modified: core/trunk/documentation/manual/translations/pt-BR/content/transactions.po =================================================================== --- core/trunk/documentation/manual/translations/pt-BR/content/transactions.po 2007-10-25 22:34:46 UTC (rev 14134) +++ core/trunk/documentation/manual/translations/pt-BR/content/transactions.po 2007-10-26 00:46:38 UTC (rev 14135) @@ -1,673 +1,2126 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: transactions.xml:5 +#, no-c-format msgid "Transactions And Concurrency" -msgstr "" +msgstr "Transações e Concorrência" -#: index.docbook:7 -msgid "The most important point about Hibernate and concurrency control is that it is very easy to understand. Hibernate directly uses JDBC connections and JTA resources without adding any additional locking behavior. We highly recommend you spend some time with the JDBC, ANSI, and transaction isolation specification of your database management system." +#. Tag: para +#: transactions.xml:7 +#, no-c-format +msgid "" +"The most important point about Hibernate and concurrency control is that it " +"is very easy to understand. Hibernate directly uses JDBC connections and JTA " +"resources without adding any additional locking behavior. We highly " +"recommend you spend some time with the JDBC, ANSI, and transaction isolation " +"specification of your database management system." msgstr "" +"O ponto o mais importante sobre o Hibernate e o controle de concorrência é " +"que é muito fácil de ser compreendido. O Hibernate usa diretamente conexões " +"de JDBC e recursos de JTA sem adicionar nenhum comportamento de bloqueio a " +"mais. Nós altamente recomendamos que você gaste algum tempo com o JDBC, o " +"ANSI e a especificação de isolamento de transação de seu sistema de gerência " +"da base de dados." -#: index.docbook:14 -msgid "Hibernate does not lock objects in memory. Your application can expect the behavior as defined by the isolation level of your database transactions. Note that thanks to the <literal>Session</literal>, which is also a transaction-scoped cache, Hibernate provides repeatable reads for lookup by identifier and entity queries (not reporting queries that return scalar values)." +#. Tag: para +#: transactions.xml:14 +#, no-c-format +msgid "" +"Hibernate does not lock objects in memory. Your application can expect the " +"behavior as defined by the isolation level of your database transactions. " +"Note that thanks to the <literal>Session</literal>, which is also a " +"transaction-scoped cache, Hibernate provides repeatable reads for lookup by " +"identifier and entity queries (not reporting queries that return scalar " +"values)." msgstr "" +"O Hibernate não bloqueia objetos na memória. Sua aplicação pode esperar o " +"comportamento tal qual definido pelo nível de isolamento de suas transações " +"de banco de dados. Note que graças ao <literal>Session</literal>, que também " +"é um cache de escopo de transação, o Hibernate fornece leituras repetíveis " +"para procurar por identificadores e consultas de entidade (não pesquisas de " +"relatórios que retornam valores escalares)." -#: index.docbook:22 -msgid "In addition to versioning for automatic optimistic concurrency control, Hibernate also offers a (minor) API for pessimistic locking of rows, using the <literal>SELECT FOR UPDATE</literal> syntax. Optimistic concurrency control and this API are discussed later in this chapter." +#. Tag: para +#: transactions.xml:22 +#, no-c-format +msgid "" +"In addition to versioning for automatic optimistic concurrency control, " +"Hibernate also offers a (minor) API for pessimistic locking of rows, using " +"the <literal>SELECT FOR UPDATE</literal> syntax. Optimistic concurrency " +"control and this API are discussed later in this chapter." msgstr "" +"Além do versionamento para o controle automático de concorrência otimista, o " +"Hibernate oferece também uma API (menor) para bloqueio pessimista de linhas " +"usando a sintaxe <literal>SELECT FOR UPDATE</literal>. O controle de " +"concorrência otimista e esta API são discutidos mais tarde neste capítulo." -#: index.docbook:29 -msgid "We start the discussion of concurrency control in Hibernate with the granularity of <literal>Configuration</literal>, <literal>SessionFactory</literal>, and <literal>Session</literal>, as well as database transactions and long conversations." +#. Tag: para +#: transactions.xml:29 +#, no-c-format +msgid "" +"We start the discussion of concurrency control in Hibernate with the " +"granularity of <literal>Configuration</literal>, <literal>SessionFactory</" +"literal>, and <literal>Session</literal>, as well as database transactions " +"and long conversations." msgstr "" +"Nós começamos a discussão do controle de concorrência no Hibernate com a " +"granularidade do <literal>Configuration</literal>, <literal>SessionFactory</" +"literal>, e <literal>Session</literal>, além de transações de base de dados " +"e conversações longas." -#: index.docbook:36 +#. Tag: title +#: transactions.xml:36 +#, no-c-format msgid "Session and transaction scopes" -msgstr "" +msgstr "Session e escopos de transações" -#: index.docbook:38 -msgid "A <literal>SessionFactory</literal> is an expensive-to-create, threadsafe object intended to be shared by all application threads. It is created once, usually on application startup, from a <literal>Configuration</literal> instance." +#. Tag: para +#: transactions.xml:38 +#, no-c-format +msgid "" +"A <literal>SessionFactory</literal> is an expensive-to-create, threadsafe " +"object intended to be shared by all application threads. It is created once, " +"usually on application startup, from a <literal>Configuration</literal> " +"instance." msgstr "" +"Um <literal>SessionFactory</literal> é objeto threadsafe compartilhado por " +"todas as threads da aplicação que consome muitos recursos na sua criação. É " +"criado uma unica vez no inicio da execução da aplicação a partir da " +"instância de uma <literal>Configuration</literal>." -#: index.docbook:44 -msgid "A <literal>Session</literal> is an inexpensive, non-threadsafe object that should be used once, for a single request, a conversation, single unit of work, and then discarded. A <literal>Session</literal> will not obtain a JDBC <literal>Connection</literal> (or a <literal>Datasource</literal>) unless it is needed, hence consume no resources until used." +#. Tag: para +#: transactions.xml:44 +#, no-c-format +msgid "" +"A <literal>Session</literal> is an inexpensive, non-threadsafe object that " +"should be used once, for a single request, a conversation, single unit of " +"work, and then discarded. A <literal>Session</literal> will not obtain a " +"JDBC <literal>Connection</literal> (or a <literal>Datasource</literal>) " +"unless it is needed, hence consume no resources until used." msgstr "" +"Uma <literal>Session</literal> é um objeto de baixo custo de criação, não é " +"threadsafe, deve ser usado uma vez, para uma única requisição, uma " +"conversação, uma única unidade do trabalho e então deve ser descartado. Um " +"<literal>Session</literal> não obterá um JDBC <literal>Connection</literal> " +"(ou um <literal>Datasource</literal>) a menos que necessite, " +"conseqüentemente não consome nenhum recurso até ser usado." -#: index.docbook:52 -msgid "To complete this picture you also have to think about database transactions. A database transaction has to be as short as possible, to reduce lock contention in the database. Long database transactions will prevent your application from scaling to highly concurrent load. Hence, it is almost never good design to hold a database transaction open during user think time, until the unit of work is complete." +#. Tag: para +#: transactions.xml:52 +#, no-c-format +msgid "" +"To complete this picture you also have to think about database transactions. " +"A database transaction has to be as short as possible, to reduce lock " +"contention in the database. Long database transactions will prevent your " +"application from scaling to highly concurrent load. Hence, it is almost " +"never good design to hold a database transaction open during user think " +"time, until the unit of work is complete." msgstr "" +"Para completar, você também tem que pensar sobre as transações de base de " +"dados. Uma transação tem que ser tão curta quanto possível, para reduzir a " +"disputa pelo bloqueio na base de dados. Transações longas impedirão que sua " +"aplicação escale a carga altamente concorrente. Por isso, em um projeto " +"raramente é para manter uma transação de base de dados aberta durante o " +"tempo que o usuário pensa, até que a unidade do trabalho esteja completa." -#: index.docbook:61 -msgid "What is the scope of a unit of work? Can a single Hibernate <literal>Session</literal> span several database transactions or is this a one-to-one relationship of scopes? When should you open and close a <literal>Session</literal> and how do you demarcate the database transaction boundaries?" +#. Tag: para +#: transactions.xml:61 +#, no-c-format +msgid "" +"What is the scope of a unit of work? Can a single Hibernate " +"<literal>Session</literal> span several database transactions or is this a " +"one-to-one relationship of scopes? When should you open and close a " +"<literal>Session</literal> and how do you demarcate the database transaction " +"boundaries?" msgstr "" +"Qual é o escopo de uma unidade de trabalho? Pode uma únicoa " +"<literal>Session</literal> do Hibernate gerenciar diversas transações ou é " +"esta um o relacionamento um-para-um dos escopos? Quando deve você abrir e " +"fechar uma <literal>Session</literal> e como você demarca os limites da " +"transação?" -#: index.docbook:69 +#. Tag: title +#: transactions.xml:69 +#, no-c-format msgid "Unit of work" -msgstr "" +msgstr "Unidade de trabalho" -#: index.docbook:71 -msgid "First, don't use the <emphasis>session-per-operation</emphasis> antipattern, that is, don't open and close a <literal>Session</literal> for every simple database call in a single thread! Of course, the same is true for database transactions. Database calls in an application are made using a planned sequence, they are grouped into atomic units of work. (Note that this also means that auto-commit after every single SQL statement is useless in an application, this mode is intended for ad-hoc SQL console work. Hibernate disables, or expects the application server to do so, auto-commit mode immediately.) Database transactions are never optional, all communication with a database has to occur inside a transaction, no matter if you read or write data. As explained, auto-commit behavior for reading data should be avoided, as many small transactions are unlikely to perform better than one clearly defined unit of work. The latter is also much more maintainable and extensible." +#. Tag: para +#: transactions.xml:71 +#, no-c-format +msgid "" +"First, don't use the <emphasis>session-per-operation</emphasis> antipattern, " +"that is, don't open and close a <literal>Session</literal> for every simple " +"database call in a single thread! Of course, the same is true for database " +"transactions. Database calls in an application are made using a planned " +"sequence, they are grouped into atomic units of work. (Note that this also " +"means that auto-commit after every single SQL statement is useless in an " +"application, this mode is intended for ad-hoc SQL console work. Hibernate " +"disables, or expects the application server to do so, auto-commit mode " +"immediately.) Database transactions are never optional, all communication " +"with a database has to occur inside a transaction, no matter if you read or " +"write data. As explained, auto-commit behavior for reading data should be " +"avoided, as many small transactions are unlikely to perform better than one " +"clearly defined unit of work. The latter is also much more maintainable and " +"extensible." msgstr "" +"Primeiro, não use o antipattern <emphasis>sessão-por-operação</emphasis>, " +"isto é, não abra e não feche uma <literal>Session</literal> para cada " +"simples chamada ao banco de de dados em uma única thread! Naturalmente, o " +"mesmo é verdadeiro para transações. As chamadas a banco de dados em uma " +"aplicação são feitas usando uma seqüência planejada, elas são agrupadas em " +"unidades de trabalho atômicas. (Veja que isso também significa que um auto-" +"commit depois de cada sentença SQL é inútil em uma aplicação, esta " +"modalidade é ideal para o trabalho ad hoc do console do SQL. O Hibernate " +"impede, ou espera que o servidor de aplicação impessa isso, o uso da " +"modalidade de auto-commit.) As transações nunca são opcionais, toda a " +"comunicação com um banco de dados tem que ocorrer dentro de uma transação, " +"não importa se você vai ler ou escrever dados. Como explicado, o " +"comportamento auto-commit para leitura de dados deve ser evitado, como " +"muitas transações pequenas são improváveis de executar melhor do que uma " +"unidade claramente definida do trabalho. A última opção também muito mais " +"manutenível e extensível." -#: index.docbook:87 -msgid "The most common pattern in a multi-user client/server application is <emphasis>session-per-request</emphasis>. In this model, a request from the client is send to the server (where the Hibernate persistence layer runs), a new Hibernate <literal>Session</literal> is opened, and all database operations are executed in this unit of work. Once the work has been completed (and the response for the client has been prepared), the session is flushed and closed. You would also use a single database transaction to serve the clients request, starting and committing it when you open and close the <literal>Session</literal>. The relationship between the two is one-to-one and this model is a perfect fit for many applications." +#. Tag: para +#: transactions.xml:87 +#, no-c-format +msgid "" +"The most common pattern in a multi-user client/server application is " +"<emphasis>session-per-request</emphasis>. In this model, a request from the " +"client is send to the server (where the Hibernate persistence layer runs), a " +"new Hibernate <literal>Session</literal> is opened, and all database " +"operations are executed in this unit of work. Once the work has been " +"completed (and the response for the client has been prepared), the session " +"is flushed and closed. You would also use a single database transaction to " +"serve the clients request, starting and committing it when you open and " +"close the <literal>Session</literal>. The relationship between the two is " +"one-to-one and this model is a perfect fit for many applications." msgstr "" +"O pattern mais comum em uma aplicação multi-usuário cliente/servidor é " +"<emphasis>sessão-por-requisição</emphasis>. Neste modelo, uma requisição do " +"cliente é enviada ao servidor (onde a camada de persistência do Hibernate " +"roda), uma <literal>Session</literal> nova do Hibernate é aberta, e todas as " +"operações da base de dados são executadas nesta unidade do trabalho. Logo " +"que o trabalho for completado (e a resposta para o cliente for preparada), a " +"sessão é descarregad e fechada. Você usaria também uma única transação de " +"base de dados para servir às requisições dos clientes, começando e " +"commitando-o quando você abre e fecha a <literal>Session</literal>. O " +"relacionamento entre os dois é um-para-um e este modelo é um ajuste perfeito " +"para muitas aplicações." -#: index.docbook:99 -msgid "The challenge lies in the implementation. Hibernate provides built-in management of the \"current session\" to simplify this pattern. All you have to do is start a transaction when a server request has to be processed, and end the transaction before the response is send to the client. You can do this in any way you like, common solutions are <literal>ServletFilter</literal>, AOP interceptor with a pointcut on the service methods, or a proxy/interception container. An EJB container is a standardized way to implement cross-cutting aspects such as transaction demarcation on EJB session beans, declaratively with CMT. If you decide to use programmatic transaction demarcation, prefer the Hibernate <literal>Transaction</literal> API shown later in this chapter, for ease of use and code portability." +#. Tag: para +#: transactions.xml:99 +#, no-c-format +msgid "" +"The challenge lies in the implementation. Hibernate provides built-in " +"management of the \"current session\" to simplify this pattern. All you have " +"to do is start a transaction when a server request has to be processed, and " +"end the transaction before the response is send to the client. You can do " +"this in any way you like, common solutions are <literal>ServletFilter</" +"literal>, AOP interceptor with a pointcut on the service methods, or a proxy/" +"interception container. An EJB container is a standardized way to implement " +"cross-cutting aspects such as transaction demarcation on EJB session beans, " +"declaratively with CMT. If you decide to use programmatic transaction " +"demarcation, prefer the Hibernate <literal>Transaction</literal> API shown " +"later in this chapter, for ease of use and code portability." msgstr "" +"O desafio encontra-se na implementação. O Hibernate fornece gerência " +"integrada da \"sessão atual\" para simplificar este pattern. Tudo que você " +"tem que fazer é iniciar uma transação quando uma requisição tem que ser " +"processada e termina a transação antes que a resposta seja enviada ao " +"cliente. Você pode fazer onde quiser, soluções comuns são " +"<literal>ServletFilter</literal>, interceptador AOP com um pointcut (ponto " +"de corte) nos métodos de serviço ou em um container de proxy/interceptação. " +"Um container de EJB é uma maneira padronizada para implementar aspectos " +"cross-cutting tais como a demarcação da transação em EJB session beans, " +"declarativamente com CMT. Se você se decidir usar demarcação programática de " +"transação, de preferencia a API <literal>Transaction</literal> do Hibernate " +"mostrada mais adiante neste capítulo, para fácilidade no uso e portabilidade " +"de código." -#: index.docbook:112 -msgid "Your application code can access a \"current session\" to process the request by simply calling <literal>sessionFactory.getCurrentSession()</literal> anywhere and as often as needed. You will always get a <literal>Session</literal> scoped to the current database transaction. This has to be configured for either resource-local or JTA environments, see <xref linkend=\"architecture-current-session\"/>." +#. Tag: para +#: transactions.xml:112 +#, no-c-format +msgid "" +"Your application code can access a \"current session\" to process the " +"request by simply calling <literal>sessionFactory.getCurrentSession()</" +"literal> anywhere and as often as needed. You will always get a " +"<literal>Session</literal> scoped to the current database transaction. This " +"has to be configured for either resource-local or JTA environments, see " +"<xref linkend=\"architecture-current-session\"/>." msgstr "" +"Seu código de aplicação pode acessar a \"sessão atual\" para processar a " +"requisição fazendo uma chamada simples a <literal>sessionFactory." +"getCurrentSession()</literal> em qualquer lugar e com a frequencia " +"necessária. Você sempre conseguirá uma <literal>Session</literal> limitada a " +"transação atual. Isto tem que ser configurado para recurso local ou os " +"ambientes JTA. Veja <xref linkend=\"architecture-current-session\"/>." -#: index.docbook:120 -msgid "Sometimes it is convenient to extend the scope of a <literal>Session</literal> and database transaction until the \"view has been rendered\". This is especially useful in servlet applications that utilize a separate rendering phase after the request has been processed. Extending the database transaction until view rendering is complete is easy to do if you implement your own interceptor. However, it is not easily doable if you rely on EJBs with container-managed transactions, as a transaction will be completed when an EJB method returns, before rendering of any view can start. See the Hibernate website and forum for tips and examples around this <emphasis>Open Session in View</emphasis> pattern." +#. Tag: para +#: transactions.xml:120 +#, no-c-format +msgid "" +"Sometimes it is convenient to extend the scope of a <literal>Session</" +"literal> and database transaction until the \"view has been rendered\". This " +"is especially useful in servlet applications that utilize a separate " +"rendering phase after the request has been processed. Extending the database " +"transaction until view rendering is complete is easy to do if you implement " +"your own interceptor. However, it is not easily doable if you rely on EJBs " +"with container-managed transactions, as a transaction will be completed when " +"an EJB method returns, before rendering of any view can start. See the " +"Hibernate website and forum for tips and examples around this <emphasis>Open " +"Session in View</emphasis> pattern." msgstr "" +"Às vezes é conveniente estender o escopo de uma <literal>Session</literal> e " +"de uma transação do banco de dados até que a \"visão esteja renderizada\". É " +"especialmente útil em aplicações servlet que utilizam uma fase de " +"rendenderização separada depois que a requisição ter sido processada. " +"Estendendo a transação até que renderização da visão esteja completa é fácil " +"de fazer se você implementar seu próprio interceptador. Entretanto, não se " +"pode fazer facilmente se você confiar em EJBs com transações gerenciadas por " +"contêiner, porque uma transação será terminada quando um método de EJB " +"retornar, antes da renderização de toda visão puder começar. Veja o website " +"e o fórum do Hibernate para dicas e exemplos em torno deste pattern " +"<emphasis>Open Session in View</emphasis>." -#: index.docbook:135 +#. Tag: title +#: transactions.xml:135 +#, no-c-format msgid "Long conversations" -msgstr "" +msgstr "Longas conversações" -#: index.docbook:137 -msgid "The session-per-request pattern is not the only useful concept you can use to design units of work. Many business processes require a whole series of interactions with the user interleaved with database accesses. In web and enterprise applications it is not acceptable for a database transaction to span a user interaction. Consider the following example:" +#. Tag: para +#: transactions.xml:137 +#, no-c-format +msgid "" +"The session-per-request pattern is not the only useful concept you can use " +"to design units of work. Many business processes require a whole series of " +"interactions with the user interleaved with database accesses. In web and " +"enterprise applications it is not acceptable for a database transaction to " +"span a user interaction. Consider the following example:" msgstr "" +"O pattern sessão-por-requisição não é o único conceito útil que você pode " +"usar ao projetar unidades de trabalho. Muitos processos de negócio requerem " +"uma totalidade de séries de interações com o usuário intercaladas com " +"acessos a uma base de dados. Em aplicações web e corporativas não é " +"aceitável para uma transação atrapalhe uma interação do usuário. Considere o " +"seguinte exemplo:" -#: index.docbook:147 -msgid "The first screen of a dialog opens, the data seen by the user has been loaded in a particular <literal>Session</literal> and database transaction. The user is free to modify the objects." +#. Tag: para +#: transactions.xml:147 +#, no-c-format +msgid "" +"The first screen of a dialog opens, the data seen by the user has been " +"loaded in a particular <literal>Session</literal> and database transaction. " +"The user is free to modify the objects." msgstr "" +"A primeira tela de um diálogo abre os dados carregado pelo usuário em " +"através de <literal>Session</literal> e transação particulares. O usuário " +"está livre modificar os objetos." -#: index.docbook:154 -msgid "The user clicks \"Save\" after 5 minutes and expects his modifications to be made persistent; he also expects that he was the only person editing this information and that no conflicting modification can occur." +#. Tag: para +#: transactions.xml:154 +#, no-c-format +msgid "" +"The user clicks \"Save\" after 5 minutes and expects his modifications to be " +"made persistent; he also expects that he was the only person editing this " +"information and that no conflicting modification can occur." msgstr "" +"O usuário clica em \"Salvar\" após 5 minutos e espera suas modificações " +"serem persistidas; espera também que ele era a única pessoa que edita esta " +"informação e que nenhuma modificação conflitante possa ocorrer." -#: index.docbook:162 -msgid "We call this unit of work, from the point of view of the user, a long running <emphasis>conversation</emphasis> (or <emphasis>application transaction</emphasis>). There are many ways how you can implement this in your application." +#. Tag: para +#: transactions.xml:162 +#, no-c-format +msgid "" +"We call this unit of work, from the point of view of the user, a long " +"running <emphasis>conversation</emphasis> (or <emphasis>application " +"transaction</emphasis>). There are many ways how you can implement this in " +"your application." msgstr "" +"Nós chamamos esta unidade de trabalho, do ponto da visão do usuário, " +"executando uma longa <emphasis>conversação</emphasis> (ou " +"<emphasis>transação da aplicação</emphasis>). Há muitas maneiras de você " +"pode implementar em sua aplicação." -#: index.docbook:168 -msgid "A first naive implementation might keep the <literal>Session</literal> and database transaction open during user think time, with locks held in the database to prevent concurrent modification, and to guarantee isolation and atomicity. This is of course an anti-pattern, since lock contention would not allow the application to scale with the number of concurrent users." +#. Tag: para +#: transactions.xml:168 +#, no-c-format +msgid "" +"A first naive implementation might keep the <literal>Session</literal> and " +"database transaction open during user think time, with locks held in the " +"database to prevent concurrent modification, and to guarantee isolation and " +"atomicity. This is of course an anti-pattern, since lock contention would " +"not allow the application to scale with the number of concurrent users." msgstr "" +"Uma primeira implementação simples pode manter a<literal>Session</literal> e " +"a transação aberta durante o tempo de interação do usuário, com bloqueios na " +"base de dados para impedir a modificação concorrente e para garantir o " +"isolamento e a atomicidade. Esse é naturalmente um anti-pattern, desde que a " +"disputa do bloqueio não permitiria o escalonameneto da aplicação com o " +"número de usuários concorrentes." -#: index.docbook:176 -msgid "Clearly, we have to use several database transactions to implement the converastion. In this case, maintaining isolation of business processes becomes the partial responsibility of the application tier. A single conversation usually spans several database transactions. It will be atomic if only one of these database transactions (the last one) stores the updated data, all others simply read data (e.g. in a wizard-style dialog spanning several request/response cycles). This is easier to implement than it might sound, especially if you use Hibernate's features:" +#. Tag: para +#: transactions.xml:176 +#, no-c-format +msgid "" +"Clearly, we have to use several database transactions to implement the " +"converastion. In this case, maintaining isolation of business processes " +"becomes the partial responsibility of the application tier. A single " +"conversation usually spans several database transactions. It will be atomic " +"if only one of these database transactions (the last one) stores the updated " +"data, all others simply read data (e.g. in a wizard-style dialog spanning " +"several request/response cycles). This is easier to implement than it might " +"sound, especially if you use Hibernate's features:" msgstr "" +"Claramente, nós temos que usar diversas transações para implementar a " +"conversação. Neste caso, Manter o isolamento dos processos de negócio torna-" +"se responsabilidade parcial da camada da aplicação. Uma única conversação " +"geralmente usa diversas transações. Ela será atômica se somente uma destas " +"transações (a última) armazenar os dados atualizados, todas as outras " +"simplesmente leram os dados (por exemplo em um diálogo do estilo wizard que " +"mede diversos ciclos de requisição/resposta). Isto é mais fácil de " +"implementar do que pode parecer, especialmente se você usar as " +"características do Hibernate:" -#: index.docbook:189 -msgid "<emphasis>Automatic Versioning</emphasis> - Hibernate can do automatic optimistic concurrency control for you, it can automatically detect if a concurrent modification occured during user think time. Usually we only check at the end of the conversation." +#. Tag: para +#: transactions.xml:189 +#, no-c-format +msgid "" +"<emphasis>Automatic Versioning</emphasis> - Hibernate can do automatic " +"optimistic concurrency control for you, it can automatically detect if a " +"concurrent modification occured during user think time. Usually we only " +"check at the end of the conversation." msgstr "" +"<emphasis>Versionamento automático</emphasis> - O Hibernate pode fazer o " +"controle automático de concorrência otimista para você, ele pode " +"automaticamente detectar se uma modificação concorrente ocorreu durante o " +"tempo de interação do usuário. Geralmente nós verificamos somente no fim da " +"conversação." -#: index.docbook:197 -msgid "<emphasis>Detached Objects</emphasis> - If you decide to use the already discussed <emphasis>session-per-request</emphasis> pattern, all loaded instances will be in detached state during user think time. Hibernate allows you to reattach the objects and persist the modifications, the pattern is called <emphasis>session-per-request-with-detached-objects</emphasis>. Automatic versioning is used to isolate concurrent modifications." +#. Tag: para +#: transactions.xml:197 +#, no-c-format +msgid "" +"<emphasis>Detached Objects</emphasis> - If you decide to use the already " +"discussed <emphasis>session-per-request</emphasis> pattern, all loaded " +"instances will be in detached state during user think time. Hibernate allows " +"you to reattach the objects and persist the modifications, the pattern is " +"called <emphasis>session-per-request-with-detached-objects</emphasis>. " +"Automatic versioning is used to isolate concurrent modifications." msgstr "" +"<emphasis>Detached Objects</emphasis>- se você se decidir usar o já " +"discutido pattern <emphasis>session-per-request</emphasis>, todas as " +"instâncias carregadas estarão no estado destacado durante o tempo em que o " +"usuário estiver pensando. O Hibernate permite que você reatache os objetos e " +"persita as modificações, esse pattern é chamado <emphasis>session-per-" +"request-with-detached-objects</emphasis>. É usado versionamento automatico " +"para isolar as modificações concorrentes." -#: index.docbook:207 -msgid "<emphasis>Extended (or Long) Session</emphasis> - The Hibernate <literal>Session</literal> may be disconnected from the underlying JDBC connection after the database transaction has been committed, and reconnected when a new client request occurs. This pattern is known as <emphasis>session-per-conversation</emphasis> and makes even reattachment unnecessary. Automatic versioning is used to isolate concurrent modifications and the <literal>Session</literal> is usually not allowed to be flushed automatically, but explicitely." +#. Tag: para +#: transactions.xml:207 +#, no-c-format +msgid "" +"<emphasis>Extended (or Long) Session</emphasis> - The Hibernate " +"<literal>Session</literal> may be disconnected from the underlying JDBC " +"connection after the database transaction has been committed, and " +"reconnected when a new client request occurs. This pattern is known as " +"<emphasis>session-per-conversation</emphasis> and makes even reattachment " +"unnecessary. Automatic versioning is used to isolate concurrent " +"modifications and the <literal>Session</literal> is usually not allowed to " +"be flushed automatically, but explicitely." msgstr "" +"<emphasis>Extended (or Long) Session</emphasis> A <literal>Session</literal> " +"do Hibernate pode ser desligada da conexão básica do JDBC depois que a " +"transação foi commitada e ser reconectado quando uma nova requisição do " +"cliente ocorrer. Este pattern é conhecido como <emphasis>session-per-" +"conversation</emphasis> e faz o reatamento uniforme desnecessário. " +"Versionamento automático é usado para isolar modificações concorrentes e a " +"<emphasis>session-per-conversation</emphasis> usualmente não é permitido " +"para ser nivelado automaticamente, e sim explicitamente." -#: index.docbook:220 -msgid "Both <emphasis>session-per-request-with-detached-objects</emphasis> and <emphasis>session-per-conversation</emphasis> have advantages and disadvantages, we discuss them later in this chapter in the context of optimistic concurrency control." +#. Tag: para +#: transactions.xml:220 +#, no-c-format +msgid "" +"Both <emphasis>session-per-request-with-detached-objects</emphasis> and " +"<emphasis>session-per-conversation</emphasis> have advantages and " +"disadvantages, we discuss them later in this chapter in the context of " +"optimistic concurrency control." msgstr "" +"Ambos <emphasis>session-per-request-with-detached-objects</emphasis> e " +"<emphasis>session-per-conversation</emphasis> possuem vantagens e " +"desvantagens, nos discutiremos mais tarde neste capítulo no contexto do " +"controle de concorrência otimista." -#: index.docbook:229 +#. Tag: title +#: transactions.xml:229 +#, no-c-format msgid "Considering object identity" -msgstr "" +msgstr "Considerando a identidade do objeto" -#: index.docbook:231 -msgid "An application may concurrently access the same persistent state in two different <literal>Session</literal>s. However, an instance of a persistent class is never shared between two <literal>Session</literal> instances. Hence there are two different notions of identity:" +#. Tag: para +#: transactions.xml:231 +#, no-c-format +msgid "" +"An application may concurrently access the same persistent state in two " +"different <literal>Session</literal>s. However, an instance of a persistent " +"class is never shared between two <literal>Session</literal> instances. " +"Hence there are two different notions of identity:" msgstr "" +"Uma aplicação pode acessar concorrentemente o mesmo estado persistente em " +"duas <literal>Session</literal>s diferentes. Entretanto, uma instância de " +"uma classe persistente nunca é compartilhada entre duas instâncias " +"<literal>Session</literal>. Por tanto, há duas noções diferentes da " +"identidade:" -#: index.docbook:240 +#. Tag: term +#: transactions.xml:240 +#, no-c-format msgid "Database Identity" -msgstr "" +msgstr "Identidade da base de dados" -#: index.docbook:243 +#. Tag: literal +#: transactions.xml:243 +#, no-c-format msgid "foo.getId().equals( bar.getId() )" -msgstr "" +msgstr "foo.getId().equals( bar.getId() )" -#: index.docbook:248 +#. Tag: term +#: transactions.xml:248 +#, no-c-format msgid "JVM Identity" -msgstr "" +msgstr "Identidade da JVM" -#: index.docbook:251 +#. Tag: literal +#: transactions.xml:251 +#, no-c-format msgid "foo==bar" -msgstr "" +msgstr "foo==bar" -#: index.docbook:257 -msgid "Then for objects attached to a <emphasis>particular</emphasis> <literal>Session</literal> (i.e. in the scope of a <literal>Session</literal>) the two notions are equivalent, and JVM identity for database identity is guaranteed by Hibernate. However, while the application might concurrently access the \"same\" (persistent identity) business object in two different sessions, the two instances will actually be \"different\" (JVM identity). Conflicts are resolved using (automatic versioning) at flush/commit time, using an optimistic approach." +#. Tag: para +#: transactions.xml:257 +#, fuzzy, no-c-format +msgid "" +"Then for objects attached to a <emphasis>particular</emphasis> " +"<literal>Session</literal> (i.e. in the scope of a <literal>Session</" +"literal>) the two notions are equivalent, and JVM identity for database " +"identity is guaranteed by Hibernate. However, while the application might " +"concurrently access the \"same\" (persistent identity) business object in " +"two different sessions, the two instances will actually be \"different" +"\" (JVM identity). Conflicts are resolved using (automatic versioning) at " +"flush/commit time, using an optimistic approach." msgstr "" +"Então para os objetos acoplados a um <literal>Session</literal> em " +"<literal>particular </literal> (isto é no escopo de um <literal>Session</" +"literal>), as duas noções são equivalentes e a identidade da JVM para a " +"identidade da base de dados é garantida pelo Hibernate. Entretanto, quando a " +"aplicação pode acessar concorrentemente o \"mesmo\" objeto do negócio " +"(identidade persistente) em duas sessões diferentes, as duas instâncias " +"serão realmente \"diferentes\" (identidade de JVM). Os conflitos são " +"resolvidos usando (versionamento automático) no flush/commit, usando " +"abordagem otimista." -#: index.docbook:266 -msgid "This approach leaves Hibernate and the database to worry about concurrency; it also provides the best scalability, since guaranteeing identity in single-threaded units of work only doesn't need expensive locking or other means of synchronization. The application never needs to synchronize on any business object, as long as it sticks to a single thread per <literal>Session</literal>. Within a <literal>Session</literal> the application may safely use <literal>==</literal> to compare objects." +#. Tag: para +#: transactions.xml:266 +#, no-c-format +msgid "" +"This approach leaves Hibernate and the database to worry about concurrency; " +"it also provides the best scalability, since guaranteeing identity in single-" +"threaded units of work only doesn't need expensive locking or other means of " +"synchronization. The application never needs to synchronize on any business " +"object, as long as it sticks to a single thread per <literal>Session</" +"literal>. Within a <literal>Session</literal> the application may safely use " +"<literal>==</literal> to compare objects." msgstr "" +"Este caminho deixa o Hibernate e o banco dedados se preocuparem com a " +"concorrência; também fornece uma escalabilidade melhor, garantindo que a " +"identidade em unidades de trabalho único-encadeadas não necessite de " +"bloqueio dispendioso ou de outros meios de sincronização. A aplicação nunca " +"necessita sincronizar qualquer objeto de negócio tão longo que transpasse " +"uma única thread por <literal>Session</literal>. Dentro de uma " +"<literal>Session</literal> a aplicação pode usar com segurança o " +"<literal>==</literal> para comparar objetos." -#: index.docbook:275 -msgid "However, an application that uses <literal>==</literal> outside of a <literal>Session</literal>, might see unexpected results. This might occur even in some unexpected places, for example, if you put two detached instances into the same <literal>Set</literal>. Both might have the same database identity (i.e. they represent the same row), but JVM identity is by definition not guaranteed for instances in detached state. The developer has to override the <literal>equals()</literal> and <literal>hashCode()</literal> methods in persistent classes and implement his own notion of object equality. There is one caveat: Never use the database identifier to implement equality, use a business key, a combination of unique, usually immutable, attributes. The database identifier will change if a transient object is made persistent. If the transient instance (usually together with detached instances) is held in a <literal>Set</literal>, changing the hashcode breaks the contract of t! he <literal>Set</literal>. Attributes for business keys don't have to be as stable as database primary keys, you only have to guarantee stability as long as the objects are in the same <literal>Set</literal>. See the Hibernate website for a more thorough discussion of this issue. Also note that this is not a Hibernate issue, but simply how Java object identity and equality has to be implemented." +#. Tag: para +#: transactions.xml:275 +#, no-c-format +msgid "" +"However, an application that uses <literal>==</literal> outside of a " +"<literal>Session</literal>, might see unexpected results. This might occur " +"even in some unexpected places, for example, if you put two detached " +"instances into the same <literal>Set</literal>. Both might have the same " +"database identity (i.e. they represent the same row), but JVM identity is by " +"definition not guaranteed for instances in detached state. The developer has " +"to override the <literal>equals()</literal> and <literal>hashCode()</" +"literal> methods in persistent classes and implement his own notion of " +"object equality. There is one caveat: Never use the database identifier to " +"implement equality, use a business key, a combination of unique, usually " +"immutable, attributes. The database identifier will change if a transient " +"object is made persistent. If the transient instance (usually together with " +"detached instances) is held in a <literal>Set</literal>, changing the " +"hashcode breaks the contract of the <literal>Set</literal>. Attributes for " +"business keys don't have to be as stable as database primary keys, you only " +"have to guarantee stability as long as the objects are in the same " +"<literal>Set</literal>. See the Hibernate website for a more thorough " +"discussion of this issue. Also note that this is not a Hibernate issue, but " +"simply how Java object identity and equality has to be implemented." msgstr "" +"Com tudo, uma aplicação que usa <literal>==</literal> fora de uma " +"<literal>Session</literal>, pode ver resultados inesperados. Isto pode " +"ocorrer mesmo em alguns lugares inesperados, por exemplo, se você colocar " +"duas instâncias desacopladas em um mesmo <literal>Set</literal>. Ambos podem " +"ter a mesma identidade na base de dados (isto é eles representam a mesma " +"linha em uma tabela), mas a identidade da JVM pela definição não garantida " +"para instâncias em estado desacoplado. O desenvolvedor tem que sobrescrever " +"os métodos <literal>equals()</literal> e <literal>hashCode()</literal> em " +"classes persistentes e implementar sua própria noção da igualdade do objeto. " +"Advertência: nunca use o identificador da base de dados para implementar a " +"igualdade, use atributos de negócio, uma combinação única, geralmente " +"imutável. O identificador da base de dados mudará se um objeto transiente " +"passar para o estado persistente. Se a instância transiente (geralmente " +"junto com instâncias desacopladas) for inserida em um <literal>Set</" +"literal>, mudar o hashcode quebra o contrato do <literal>Set</literal>. " +"Atributos para chaves de negócio não têm que ser tão estável quanto às " +"chaves primárias da base de dados, você somente tem que garantir a " +"estabilidade durante o tempo que os objetos estiverem no mesmo Set. Veja o " +"website do Hibernate para uma discussão mais completa sobre o assunto. Note " +"também que esta não é uma caracteristica do Hibernate, mas simplesmente como " +"a identidade e a igualdade do objeto de Java têm que ser implementadas." -#: index.docbook:296 +#. Tag: title +#: transactions.xml:296 +#, no-c-format msgid "Common issues" -msgstr "" +msgstr "Edições comuns" -#: index.docbook:298 -msgid "Never use the anti-patterns <emphasis>session-per-user-session</emphasis> or <emphasis>session-per-application</emphasis> (of course, there are rare exceptions to this rule). Note that some of the following issues might also appear with the recommended patterns, make sure you understand the implications before making a design decision:" +#. Tag: para +#: transactions.xml:298 +#, no-c-format +msgid "" +"Never use the anti-patterns <emphasis>session-per-user-session</emphasis> or " +"<emphasis>session-per-application</emphasis> (of course, there are rare " +"exceptions to this rule). Note that some of the following issues might also " +"appear with the recommended patterns, make sure you understand the " +"implications before making a design decision:" msgstr "" +"Nunca use o anti-patterns <emphasis>session-per-user-session</emphasis> ou " +"<emphasis>session-per-application</emphasis> (naturalmente, há umas exceções " +"raras a essa regra). Note que algumas das seguintes edições podem também " +"aparecer com patterns recomendados, certifique-se que tenha compreendido as " +"implicações antes de fazer uma decisão de projeto:" -#: index.docbook:307 -msgid "A <literal>Session</literal> is not thread-safe. Things which are supposed to work concurrently, like HTTP requests, session beans, or Swing workers, will cause race conditions if a <literal>Session</literal> instance would be shared. If you keep your Hibernate <literal>Session</literal> in your <literal>HttpSession</literal> (discussed later), you should consider synchronizing access to your Http session. Otherwise, a user that clicks reload fast enough may use the same <literal>Session</literal> in two concurrently running threads." +#. Tag: para +#: transactions.xml:307 +#, no-c-format +msgid "" +"A <literal>Session</literal> is not thread-safe. Things which are supposed " +"to work concurrently, like HTTP requests, session beans, or Swing workers, " +"will cause race conditions if a <literal>Session</literal> instance would be " +"shared. If you keep your Hibernate <literal>Session</literal> in your " +"<literal>HttpSession</literal> (discussed later), you should consider " +"synchronizing access to your Http session. Otherwise, a user that clicks " +"reload fast enough may use the same <literal>Session</literal> in two " +"concurrently running threads." msgstr "" +"Uma <literal>Session</literal> não é threadsafe. As coisas que são supostas " +"para trabalhar concorrentemente, como requisições HTTP, session beans, ou " +"Swing, causarão condições de disputa se uma instância <literal>Session</" +"literal> for compartilhada. Se você mantiver sua <literal>Session</literal> " +"do Hibernate em seu <literal>HttpSession</literal> (discutido mais tarde), " +"você deve considerar sincronizar o acesso a sua sessão do HTTP. Caso " +"contrário, um usuário que clica em reload várias muito rapidamente pode usar " +"o mesmo <literal>Session</literal> em duas threads executando " +"concorrentemente." -#: index.docbook:318 -msgid "An exception thrown by Hibernate means you have to rollback your database transaction and close the <literal>Session</literal> immediately (discussed later in more detail). If your <literal>Session</literal> is bound to the application, you have to stop the application. Rolling back the database transaction doesn't put your business objects back into the state they were at the start of the transaction. This means the database state and the business objects do get out of sync. Usually this is not a problem, because exceptions are not recoverable and you have to start over after rollback anyway." +#. Tag: para +#: transactions.xml:318 +#, no-c-format +msgid "" +"An exception thrown by Hibernate means you have to rollback your database " +"transaction and close the <literal>Session</literal> immediately (discussed " +"later in more detail). If your <literal>Session</literal> is bound to the " +"application, you have to stop the application. Rolling back the database " +"transaction doesn't put your business objects back into the state they were " +"at the start of the transaction. This means the database state and the " +"business objects do get out of sync. Usually this is not a problem, because " +"exceptions are not recoverable and you have to start over after rollback " +"anyway." msgstr "" +"Uma exceção lançada pelo Hibernate significa que você tem que dar rollback " +"na sua transação no banco de dados e fechar a <literal>Session</literal> " +"imediatamente (discutido mais tarde em maiores detalhes). Se sua " +"<literal>Session</literal> é limitado pela aplicação, você tem que parar a " +"aplicação. Dando rollback na transação no banco de dados não põe seus " +"objetos do negócio em um estado anterior que estavam no início da transação. " +"Isto significa que o estado da base de dados e os objetos de negócio perdem " +"a sincronização. Geralmente não é um problema porque as exceções não são " +"recuperáveis e você tem que iniciar após o rollback de qualquer maneira." -#: index.docbook:330 -msgid "The <literal>Session</literal> caches every object that is in persistent state (watched and checked for dirty state by Hibernate). This means it grows endlessly until you get an OutOfMemoryException, if you keep it open for a long time or simply load too much data. One solution for this is to call <literal>clear()</literal> and <literal>evict()</literal> to manage the <literal>Session</literal> cache, but you most likely should consider a Stored Procedure if you need mass data operations. Some solutions are shown in <xref linkend=\"batch\"/>. Keeping a <literal>Session</literal> open for the duration of a user session also means a high probability of stale data." +#. Tag: para +#: transactions.xml:330 +#, no-c-format +msgid "" +"The <literal>Session</literal> caches every object that is in persistent " +"state (watched and checked for dirty state by Hibernate). This means it " +"grows endlessly until you get an OutOfMemoryException, if you keep it open " +"for a long time or simply load too much data. One solution for this is to " +"call <literal>clear()</literal> and <literal>evict()</literal> to manage the " +"<literal>Session</literal> cache, but you most likely should consider a " +"Stored Procedure if you need mass data operations. Some solutions are shown " +"in <xref linkend=\"batch\"/>. Keeping a <literal>Session</literal> open for " +"the duration of a user session also means a high probability of stale data." msgstr "" +"O <literal>Session</literal> guarda em cache cada objeto que está no estado " +"persistente (guardado e checado para estado \"sujo\" pelo Hibernate). Isto " +"significa que ele cresce infinitamente até que você obtenha uma " +"OutOfMemoryException, se você o mantiver aberto por muito tempo ou " +"simplesmente carregar dados demais. Uma solução é chamar <literal>clear()</" +"literal> e <literal>evict()</literal> para controlar o cache da " +"<literal>Session</literal>, mas você deve considerar uma Store Procedure se " +"precisar de operações que envolvam grande volume de dados. Algumas soluções " +"são mostradas no <xref linkend=\"batch\"/>. Manter uma <literal>Session</" +"literal> aberta durante uma sessão do usuário significa também uma " +"probabilidade elevada de se acabar com dados velhos." -#: index.docbook:348 +#. Tag: title +#: transactions.xml:348 +#, no-c-format msgid "Database transaction demarcation" -msgstr "" +msgstr "Demarcação de transações de bancos de dados" -#: index.docbook:350 -msgid "Datatabase (or system) transaction boundaries are always necessary. No communication with the database can occur outside of a database transaction (this seems to confuse many developers who are used to the auto-commit mode). Always use clear transaction boundaries, even for read-only operations. Depending on your isolation level and database capabilities this might not be required but there is no downside if you always demarcate transactions explicitly. Certainly, a single database transaction is going to perform better than many small transactions, even for reading data." +#. Tag: para +#: transactions.xml:350 +#, no-c-format +msgid "" +"Datatabase (or system) transaction boundaries are always necessary. No " +"communication with the database can occur outside of a database transaction " +"(this seems to confuse many developers who are used to the auto-commit " +"mode). Always use clear transaction boundaries, even for read-only " +"operations. Depending on your isolation level and database capabilities this " +"might not be required but there is no downside if you always demarcate " +"transactions explicitly. Certainly, a single database transaction is going " +"to perform better than many small transactions, even for reading data." msgstr "" +"Os limites de uma transação de banco de dados (ou sistema) são sempre " +"necessários. Nenhuma comunicação com o banco de dados pode ocorrer fora de " +"uma transação de banco de dados (isto parece confundir muitos " +"desenvolvedores que estão usados modo auto-commit). Sempre use os limites " +"desobstruídos da transação, até mesmo para operações somente leitura. " +"Dependendo de seu nível de isolamento e capacidade da base de dados isto " +"pode não ser requerido, mas não há nenhum aspecto negativo se você demarca " +"sempre transações explicitamente. Certamente, uma única transação será " +"melhor executada do que muitas transações pequenas, até mesmo para dados de " +"leitura." -#: index.docbook:360 -msgid "A Hibernate application can run in non-managed (i.e. standalone, simple Web- or Swing applications) and managed J2EE environments. In a non-managed environment, Hibernate is usually responsible for its own database connection pool. The application developer has to manually set transaction boundaries, in other words, begin, commit, or rollback database transactions himself. A managed environment usually provides container-managed transactions (CMT), with the transaction assembly defined declaratively in deployment descriptors of EJB session beans, for example. Programmatic transaction demarcation is then no longer necessary." +#. Tag: para +#: transactions.xml:360 +#, no-c-format +msgid "" +"A Hibernate application can run in non-managed (i.e. standalone, simple Web- " +"or Swing applications) and managed J2EE environments. In a non-managed " +"environment, Hibernate is usually responsible for its own database " +"connection pool. The application developer has to manually set transaction " +"boundaries, in other words, begin, commit, or rollback database transactions " +"himself. A managed environment usually provides container-managed " +"transactions (CMT), with the transaction assembly defined declaratively in " +"deployment descriptors of EJB session beans, for example. Programmatic " +"transaction demarcation is then no longer necessary." msgstr "" +"Uma aplicação do Hibernate pode funcionar em ambientes não gerenciados (isto " +"é aplicações standalone, Web simples ou Swing) e ambientes gerenciados J2EE. " +"Em um ambiente não gerenciado, o Hibernate é geralmente responsável pelo seu " +"próprio pool de conexões. O desenvolvedor tem que manualmente ajustar " +"limites das transaçãos, ou seja, começar, commitar, ou dar rollback nas " +"transações ele mesmo. Um ambiente gerenciado fornece transações gerenciadas " +"por contêiner (CMT - container-managed transactions), com um conjunto da " +"transações definido declarativamente em descritores de deployment de EJB " +"session beans, por exemplo. A demarcação programática é então já não é " +"necessário." -#: index.docbook:370 -msgid "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. Hibernate offers a wrapper API called <literal>Transaction</literal> that translates into the native transaction system of your deployment environment. This API is actually optional, but we strongly encourage its use unless you are in a CMT session bean." +#. Tag: para +#: transactions.xml:370 +#, no-c-format +msgid "" +"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. Hibernate offers a wrapper API called " +"<literal>Transaction</literal> that translates into the native transaction " +"system of your deployment environment. This API is actually optional, but we " +"strongly encourage its use unless you are in a CMT session bean." msgstr "" +"Entretanto, é freqüentemente desejável manter sua camada de persistência " +"portável entre ambientes de recurso locais não gerenciados e sistemas que " +"podem confiar em JTA, mas usar BMT em vez de CMT. Em ambos os casos você " +"usaria demarcação de transação programática. O Hibernate oferece uma API " +"chamada Transaction que traduz dentro do sistema de transação nativa de seu " +"ambiente de deployment. Esta API é realmente opcional, mas nós encorajamos " +"fortemente seu uso a menos que você estiver em um CMT session bean." -#: index.docbook:379 -msgid "Usually, ending a <literal>Session</literal> involves four distinct phases:" +#. Tag: para +#: transactions.xml:379 +#, no-c-format +msgid "" +"Usually, ending a <literal>Session</literal> involves four distinct phases:" msgstr "" +"Geralmente, finalizar um <literal>Session</literal>envolve quatro fases " +"distintas:" -#: index.docbook:385 +#. Tag: para +#: transactions.xml:385 +#, no-c-format msgid "flush the session" -msgstr "" +msgstr "flush da sessão" -#: index.docbook:390 +#. Tag: para +#: transactions.xml:390 +#, no-c-format msgid "commit the transaction" -msgstr "" +msgstr "commitar a transação" -#: index.docbook:395 +#. Tag: para +#: transactions.xml:395 +#, no-c-format msgid "close the session" -msgstr "" +msgstr "fechar a sessão" -#: index.docbook:400 +#. Tag: para +#: transactions.xml:400 +#, no-c-format msgid "handle exceptions" -msgstr "" +msgstr "tratar as exceções" -#: index.docbook:406 -msgid "Flushing the session has been discussed earlier, we'll now have a closer look at transaction demarcation and exception handling in both managed- and non-managed environments." +#. Tag: para +#: transactions.xml:406 +#, no-c-format +msgid "" +"Flushing the session has been discussed earlier, we'll now have a closer " +"look at transaction demarcation and exception handling in both managed- and " +"non-managed environments." msgstr "" +"A limpeza da sessão já foi bem discutida, agora nós daremos uma olhada na " +"demarcação da transação e na manipulação de exceção em ambientes controlados " +"e não controlados." -#: index.docbook:413 +#. Tag: title +#: transactions.xml:413 +#, no-c-format msgid "Non-managed environment" -msgstr "" +msgstr "Ambiente não gerenciado" -#: index.docbook:415 -msgid "If a Hibernate persistence layer runs in a non-managed environment, database connections are usually handled by simple (i.e. non-DataSource) connection pools from which Hibernate obtains connections as needed. The session/transaction handling idiom looks like this:" +#. Tag: para +#: transactions.xml:415 +#, no-c-format +msgid "" +"If a Hibernate persistence layer runs in a non-managed environment, database " +"connections are usually handled by simple (i.e. non-DataSource) connection " +"pools from which Hibernate obtains connections as needed. The session/" +"transaction handling idiom looks like this:" msgstr "" +"Se uma camada de persistência do Hibernate roda em um ambiente não " +"gerenciado, as conexões do banco de dados são geralmente tratadas pelos " +"pools de conexões simples (isto é, não baseados em DataSource) dos quais o " +"Hibernate obtém as conexões assim que necessita. A maneira de se manipular " +"uma sessão/transação é mais ou menos assim:" -#: index.docbook:422 +#. Tag: programlisting +#: transactions.xml:422 +#, no-c-format msgid "" - "<![CDATA[// Non-managed environment idiom\n" - "Session sess = factory.openSession();\n" - "Transaction tx = null;\n" - "try {\n" - " tx = sess.beginTransaction();\n" - "\n" - " // do some work\n" - " ...\n" - "\n" - " tx.commit();\n" - "}\n" - "catch (RuntimeException e) {\n" - " if (tx != null) tx.rollback();\n" - " throw e; // or display error message\n" - "}\n" - "finally {\n" - " sess.close();\n" - "}]]>" +"<![CDATA[// Non-managed environment idiom\n" +"Session sess = factory.openSession();\n" +"Transaction tx = null;\n" +"try {\n" +" tx = sess.beginTransaction();\n" +"\n" +" // do some work\n" +" ...\n" +"\n" +" tx.commit();\n" +"}\n" +"catch (RuntimeException e) {\n" +" if (tx != null) tx.rollback();\n" +" throw e; // or display error message\n" +"}\n" +"finally {\n" +" sess.close();\n" +"}]]>" msgstr "" -#: index.docbook:424 -msgid "You don't have to <literal>flush()</literal> the <literal>Session</literal> explicitly - the call to <literal>commit()</literal> automatically triggers the synchronization (depending upon the <xref linkend=\"objectstate-flushing\"/>FlushMode for the session. A call to <literal>close()</literal> marks the end of a session. The main implication of <literal>close()</literal> is that the JDBC connection will be relinquished by the session. This Java code is portable and runs in both non-managed and JTA environments." +#. Tag: para +#: transactions.xml:424 +#, no-c-format +msgid "" +"You don't have to <literal>flush()</literal> the <literal>Session</literal> " +"explicitly - the call to <literal>commit()</literal> automatically triggers " +"the synchronization (depending upon the <link linkend=\"objectstate-flushing" +"\">FlushMode</link> for the session. A call to <literal>close()</literal> " +"marks the end of a session. The main implication of <literal>close()</" +"literal> is that the JDBC connection will be relinquished by the session. " +"This Java code is portable and runs in both non-managed and JTA environments." msgstr "" +"Você não pode chamar <literal>flush()</literal> do <literal>Session()</" +"literal> explicitamente - a chamada ao <literal>commit()</literal> dispara " +"automaticamente a sincronização para a sessão (dependendo do <xref linkend=" +"\"objectstate-flushing\"> FlushMode</xref>). Uma chamada ao <literal>close()" +"</literal> marca o fim de uma sessão. A principal implicação do " +"<literal>close()</literal> é que a conexão JDBC será abandonada pela sessão. " +"Este código Java é portável e funciona em ambientes não gerenciado e de JTA." -#: index.docbook:433 -msgid "A much more flexible solution is Hibernate's built-in \"current session\" context management, as described earlier:" +#. Tag: para +#: transactions.xml:433 +#, no-c-format +msgid "" +"A much more flexible solution is Hibernate's built-in \"current session\" " +"context management, as described earlier:" msgstr "" +"Uma solução muito mais flexível é gerência integrada de contexto da \"sessão " +"atual\" do Hibernate, como descrito anteriormente:" -#: index.docbook:438 +#. Tag: programlisting +#: transactions.xml:438 +#, no-c-format msgid "" - "<![CDATA[// Non-managed environment idiom with getCurrentSession()\n" - "try {\n" - " factory.getCurrentSession().beginTransaction();\n" - "\n" - " // do some work\n" - " ...\n" - "\n" - " factory.getCurrentSession().getTransaction().commit();\n" - "}\n" - "catch (RuntimeException e) {\n" - " factory.getCurrentSession().getTransaction().rollback();\n" - " throw e; // or display error message\n" - "}]]>" +"<![CDATA[// Non-managed environment idiom with getCurrentSession()\n" +"try {\n" +" factory.getCurrentSession().beginTransaction();\n" +"\n" +" // do some work\n" +" ...\n" +"\n" +" factory.getCurrentSession().getTransaction().commit();\n" +"}\n" +"catch (RuntimeException e) {\n" +" factory.getCurrentSession().getTransaction().rollback();\n" +" throw e; // or display error message\n" +"}]]>" msgstr "" -#: index.docbook:440 -msgid "You will very likely never see these code snippets in a regular application; fatal (system) exceptions should always be caught at the \"top\". In other words, the code that executes Hibernate calls (in the persistence layer) and the code that handles <literal>RuntimeException</literal> (and usually can only clean up and exit) are in different layers. The current context management by Hibernate can significantly simplify this design, as all you need is access to a <literal>SessionFactory</literal>. Exception handling is discussed later in this chapter." +#. Tag: para +#: transactions.xml:440 +#, no-c-format +msgid "" +"You will very likely never see these code snippets in a regular application; " +"fatal (system) exceptions should always be caught at the \"top\". In other " +"words, the code that executes Hibernate calls (in the persistence layer) and " +"the code that handles <literal>RuntimeException</literal> (and usually can " +"only clean up and exit) are in different layers. The current context " +"management by Hibernate can significantly simplify this design, as all you " +"need is access to a <literal>SessionFactory</literal>. Exception handling is " +"discussed later in this chapter." msgstr "" +"Você muito provavelmente nunca verá estes fragmentos de código em uma " +"aplicação regular; as exceções fatais (do sistema) devem sempre ser pegas no " +"\"alto\". Ou seja, o código que executa chamadas do Hibernate (na camada de " +"persistência) e o código que trata <literal>RuntimeException</literal> (e " +"geralmente pode somente limpar acima e na saída) estão em camadas " +"diferentes. O gerenciamento do contexto atual feito pelo Hibernate pode " +"significativamente simplificar este projeto, como tudo que você necessita é " +"do acesso a um <literal>SessionFactory</literal>. A manipulação de exceção é " +"discutida mais tarde neste capítulo." -#: index.docbook:450 -msgid "Note that you should select <literal>org.hibernate.transaction.JDBCTransactionFactory</literal> (which is the default), and for the second example <literal>\"thread\"</literal> as your <literal>hibernate.current_session_context_class</literal>." +#. Tag: para +#: transactions.xml:450 +#, no-c-format +msgid "" +"Note that you should select <literal>org.hibernate.transaction." +"JDBCTransactionFactory</literal> (which is the default), and for the second " +"example <literal>\"thread\"</literal> as your <literal>hibernate." +"current_session_context_class</literal>." msgstr "" +"Note que você deve selecionar <literal>org.hibernate.transaction." +"JDBCTransactionFactory</literal> (que é o padrão) e para o segundo exemplo " +"<literal>\"thread\"</literal> como seu <literal>hibernate." +"current_session_context_class</literal>." -#: index.docbook:459 +#. Tag: title +#: transactions.xml:459 +#, no-c-format msgid "Using JTA" -msgstr "" +msgstr "Usando JTA" -#: index.docbook:461 -msgid "If your persistence layer runs in an application server (e.g. behind EJB session beans), every datasource connection obtained by Hibernate will automatically be part of the global JTA transaction. You can also install a standalone JTA implementation and use it without EJB. Hibernate offers two strategies for JTA integration." +#. Tag: para +#: transactions.xml:461 +#, no-c-format +msgid "" +"If your persistence layer runs in an application server (e.g. behind EJB " +"session beans), every datasource connection obtained by Hibernate will " +"automatically be part of the global JTA transaction. You can also install a " +"standalone JTA implementation and use it without EJB. Hibernate offers two " +"strategies for JTA integration." msgstr "" +"Se sua camada de persistência funcionar em um servidor de aplicação (por " +"exemplo, dentro dos EJB session beans), cada conexão do datasource obtida " +"pelo Hibernate automaticamente fará parte da transação global de JTA. Você " +"pode também instalar uma implementação standalone de JTA e usá-la sem EJB. O " +"Hibernate oferece duas estratégias para a integração de JTA." -#: index.docbook:468 -msgid "If you use bean-managed transactions (BMT) Hibernate will tell the application server to start and end a BMT transaction if you use the <literal>Transaction</literal> API. So, the transaction management code is identical to the non-managed environment." +#. Tag: para +#: transactions.xml:468 +#, no-c-format +msgid "" +"If you use bean-managed transactions (BMT) Hibernate will tell the " +"application server to start and end a BMT transaction if you use the " +"<literal>Transaction</literal> API. So, the transaction management code is " +"identical to the non-managed environment." msgstr "" +"Se você usar bean-managed transactions (BMT - transações gerenciadas por " +"bean) o Hibernate dirá ao servidor de aplicação para começar e para terminar " +"uma transação de BMT se você usar a API Transaction. Assim, o código de " +"gerência de transação é idêntico ao ambiente não gerenciado." -#: index.docbook:474 +#. Tag: programlisting +#: transactions.xml:474 +#, no-c-format msgid "" - "<![CDATA[// BMT idiom\n" - "Session sess = factory.openSession();\n" - "Transaction tx = null;\n" - "try {\n" - " tx = sess.beginTransaction();\n" - "\n" - " // do some work\n" - " ...\n" - "\n" - " tx.commit();\n" - "}\n" - "catch (RuntimeException e) {\n" - " if (tx != null) tx.rollback();\n" - " throw e; // or display error message\n" - "}\n" - "finally {\n" - " sess.close();\n" - "}]]>" +"<![CDATA[// BMT idiom\n" +"Session sess = factory.openSession();\n" +"Transaction tx = null;\n" +"try {\n" +" tx = sess.beginTransaction();\n" +"\n" +" // do some work\n" +" ...\n" +"\n" +" tx.commit();\n" +"}\n" +"catch (RuntimeException e) {\n" +" if (tx != null) tx.rollback();\n" +" throw e; // or display error message\n" +"}\n" +"finally {\n" +" sess.close();\n" +"}]]>" msgstr "" -#: index.docbook:476 -msgid "If you want to use a transaction-bound <literal>Session</literal>, that is, the <literal>getCurrentSession()</literal> functionality for easy context propagation, you will have to use the JTA <literal>UserTransaction</literal> API directly:" +#. Tag: para +#: transactions.xml:476 +#, no-c-format +msgid "" +"If you want to use a transaction-bound <literal>Session</literal>, that is, " +"the <literal>getCurrentSession()</literal> functionality for easy context " +"propagation, you will have to use the JTA <literal>UserTransaction</literal> " +"API directly:" msgstr "" +"Se você quiser usar um <literal>Session</literal> limitada por transação, " +"isto é, a funcionalidade do <literal>getCurrentSession()</literal> para a " +"propagação fácil do contexto, você terá que usar diretamente a API JTA " +"<literal>UserTransaction</literal>:" -#: index.docbook:482 +#. Tag: programlisting +#: transactions.xml:482 +#, no-c-format msgid "" - "<![CDATA[// BMT idiom with getCurrentSession()\n" - "try {\n" - " UserTransaction tx = (UserTransaction)new InitialContext()\n" - " .lookup(\"java:comp/UserTransaction\");\n" - "\n" - " tx.begin();\n" - "\n" - " // Do some work on Session bound to transaction\n" - " factory.getCurrentSession().load(...);\n" - " factory.getCurrentSession().persist(...);\n" - "\n" - " tx.commit();\n" - "}\n" - "catch (RuntimeException e) {\n" - " tx.rollback();\n" - " throw e; // or display error message\n" - "}]]>" +"<![CDATA[// BMT idiom with getCurrentSession()\n" +"try {\n" +" UserTransaction tx = (UserTransaction)new InitialContext()\n" +" .lookup(\"java:comp/UserTransaction\");\n" +"\n" +" tx.begin();\n" +"\n" +" // Do some work on Session bound to transaction\n" +" factory.getCurrentSession().load(...);\n" +" factory.getCurrentSession().persist(...);\n" +"\n" +" tx.commit();\n" +"}\n" +"catch (RuntimeException e) {\n" +" tx.rollback();\n" +" throw e; // or display error message\n" +"}]]>" msgstr "" -#: index.docbook:484 -msgid "With CMT, transaction demarcation is done in session bean deployment descriptors, not programatically, hence, the code is reduced to:" +#. Tag: para +#: transactions.xml:484 +#, no-c-format +msgid "" +"With CMT, transaction demarcation is done in session bean deployment " +"descriptors, not programatically, hence, the code is reduced to:" msgstr "" +"Com CMT, a demarcação da transação é feita em descritores de deployment do " +"session beans, não programaticamente, conseqüentemente, o código é reduzido " +"a:" -#: index.docbook:489 +#. Tag: programlisting +#: transactions.xml:489 +#, no-c-format msgid "" - "<![CDATA[// CMT idiom\n" - " Session sess = factory.getCurrentSession();\n" - "\n" - " // do some work\n" - " ...\n" - "]]>" +"<![CDATA[// CMT idiom\n" +" Session sess = factory.getCurrentSession();\n" +"\n" +" // do some work\n" +" ...\n" +"]]>" msgstr "" -#: index.docbook:491 -msgid "In a CMT/EJB even rollback happens automatically, since an unhandled <literal>RuntimeException</literal> thrown by a session bean method tells the container to set the global transaction to rollback. <emphasis>This means you do not need to use the Hibernate <literal>Transaction</literal> API at all with BMT or CMT, and you get automatic propagation of the \"current\" Session bound to the transaction.</emphasis>" +#. Tag: para +#: transactions.xml:491 +#, no-c-format +msgid "" +"In a CMT/EJB even rollback happens automatically, since an unhandled " +"<literal>RuntimeException</literal> thrown by a session bean method tells " +"the container to set the global transaction to rollback. <emphasis>This " +"means you do not need to use the Hibernate <literal>Transaction</literal> " +"API at all with BMT or CMT, and you get automatic propagation of the " +"\"current\" Session bound to the transaction.</emphasis>" msgstr "" +"Em um CMT/EJB mesmo um rollback acontece automaticamente, desde que uma " +"exeção <literal>RuntimeException</literal> não tratável seja lançada por um " +"método de um session bean que informa ao contêiner ajustar a transação " +"global ao rollback. <emphasis>Isto significa que você não necessita usar a " +"API <literal>Transaction</literal> do Hibernate em tudo com BMT ou CMT e " +"você obtém a propagação automática do Session \"atual\" limitada à transação." +"</emphasis>" -#: index.docbook:499 -msgid "Note that you should choose <literal>org.hibernate.transaction.JTATransactionFactory</literal> if you use JTA directly (BMT), and <literal>org.hibernate.transaction.CMTTransactionFactory</literal> in a CMT session bean, when you configure Hibernate's transaction factory. Remember to also set <literal>hibernate.transaction.manager_lookup_class</literal>. Furthermore, make sure that your <literal>hibernate.current_session_context_class</literal> is either unset (backwards compatiblity), or set to <literal>\"jta\"</literal>." +#. Tag: para +#: transactions.xml:499 +#, no-c-format +msgid "" +"Note that you should choose <literal>org.hibernate.transaction." +"JTATransactionFactory</literal> if you use JTA directly (BMT), and " +"<literal>org.hibernate.transaction.CMTTransactionFactory</literal> in a CMT " +"session bean, when you configure Hibernate's transaction factory. Remember " +"to also set <literal>hibernate.transaction.manager_lookup_class</literal>. " +"Furthermore, make sure that your <literal>hibernate." +"current_session_context_class</literal> is either unset (backwards " +"compatiblity), or set to <literal>\"jta\"</literal>." msgstr "" +"Veja que você deverá escolher <literal>org.hibernate.transaction." +"JTATransactionFactory</literal> se você usar o JTA diretamente (BMT) e " +"<literal>org.hibernate.transaction.CMTTransactionFactory</literal> em um CMT " +"session bean, quando você configura a fábrica de transação do Hibernate. " +"Lembre-se também de configurar o <literal>hibernate.transaction." +"manager_lookup_class</literal>. Além disso, certifique-se que seu " +"<literal>hibernate.current_session_context_class</literal> ou não é " +"configurado (compatibilidade com o legado) ou é definido para <literal>\"jta" +"\"</literal>." -#: index.docbook:508 -msgid "The <literal>getCurrentSession()</literal> operation has one downside in a JTA environment. There is one caveat to the use of <literal>after_statement</literal> connection release mode, which is then used by default. Due to a silly limitation of the JTA spec, it is not possible for Hibernate to automatically clean up any unclosed <literal>ScrollableResults</literal> or <literal>Iterator</literal> instances returned by <literal>scroll()</literal> or <literal>iterate()</literal>. You <emphasis>must</emphasis> release the underlying database cursor by calling <literal>ScrollableResults.close()</literal> or <literal>Hibernate.close(Iterator)</literal> explicity from a <literal>finally</literal> block. (Of course, most applications can easily avoid using <literal>scroll()</literal> or <literal>iterate()</literal> at all from the JTA or CMT code.)" +#. Tag: para +#: transactions.xml:508 +#, no-c-format +msgid "" +"The <literal>getCurrentSession()</literal> operation has one downside in a " +"JTA environment. There is one caveat to the use of <literal>after_statement</" +"literal> connection release mode, which is then used by default. Due to a " +"silly limitation of the JTA spec, it is not possible for Hibernate to " +"automatically clean up any unclosed <literal>ScrollableResults</literal> or " +"<literal>Iterator</literal> instances returned by <literal>scroll()</" +"literal> or <literal>iterate()</literal>. You <emphasis>must</emphasis> " +"release the underlying database cursor by calling <literal>ScrollableResults." +"close()</literal> or <literal>Hibernate.close(Iterator)</literal> explicity " +"from a <literal>finally</literal> block. (Of course, most applications can " +"easily avoid using <literal>scroll()</literal> or <literal>iterate()</" +"literal> at all from the JTA or CMT code.)" msgstr "" +"A operação <literal>getCurrentSession()</literal> tem um aspecto negativo em " +"um ambiente JTA. Há uma advertência para o uso do método liberado de conexão " +"<literal>after_statement</literal>, o qual é usado então por padrão. Devido " +"a uma limitação simples da especificação JTA, não é possível para o " +"Hibernate automaticamente limpar quaisquer instâncias " +"<literal>ScrollableResults</literal> ou <literal>Iterator</literal> abertas " +"retornadas pelo <literal>scroll()</literal> ou <literal>iterate()</literal>. " +"Você <emphasis>deve</emphasis> liberar o cursor subjacente da base de dados " +"chamando <literal>ScrollableResults.close()</literal> ou <literal>Hibernate." +"close(Iterator)</literal> explicitamente de um bloco <literal>finally</" +"literal>. (Claro que a maioria de aplicações podem facilmente evitar o uso " +"do <literal>scroll()</literal> ou do <literal>iterate()</literal> em todo " +"código provindo do JTA ou do CMT.)" -#: index.docbook:524 +#. Tag: title +#: transactions.xml:524 +#, no-c-format msgid "Exception handling" -msgstr "" +msgstr "Tratamento de Exceção" -#: index.docbook:526 -msgid "If the <literal>Session</literal> throws an exception (including any <literal>SQLException</literal>), you should immediately rollback the database transaction, call <literal>Session.close()</literal> and discard the <literal>Session</literal> instance. Certain methods of <literal>Session</literal> will <emphasis>not</emphasis> leave the session in a consistent state. No exception thrown by Hibernate can be treated as recoverable. Ensure that the <literal>Session</literal> will be closed by calling <literal>close()</literal> in a <literal>finally</literal> block." +#. Tag: para +#: transactions.xml:526 +#, no-c-format +msgid "" +"If the <literal>Session</literal> throws an exception (including any " +"<literal>SQLException</literal>), you should immediately rollback the " +"database transaction, call <literal>Session.close()</literal> and discard " +"the <literal>Session</literal> instance. Certain methods of " +"<literal>Session</literal> will <emphasis>not</emphasis> leave the session " +"in a consistent state. No exception thrown by Hibernate can be treated as " +"recoverable. Ensure that the <literal>Session</literal> will be closed by " +"calling <literal>close()</literal> in a <literal>finally</literal> block." msgstr "" +"Se a <literal>Session</literal> levantar uma exceção (incluindo qualquer " +"<literal>SQLException</literal>), você deve imediatamente dar um rollback na " +"transação do banco, chamando <literal>Session.close()</literal> e " +"descartando a instância da <literal>Session</literal>. Certos métodos da " +"<literal>Session</literal><literal>não</literal> deixarão a sessão em um " +"estado inconsistente. Nenhuma exceção lançada pelo Hibernate pode ser " +"recuperada. Certifique-se que a <literal>Session</literal> será fechada " +"chamando <literal>close()</literal> no bloco <literal>finally</literal>." -#: index.docbook:537 -msgid "The <literal>HibernateException</literal>, which wraps most of the errors that can occur in a Hibernate persistence layer, is an unchecked exception (it wasn't in older versions of Hibernate). In our opinion, we shouldn't force the application developer to catch an unrecoverable exception at a low layer. In most systems, unchecked and fatal exceptions are handled in one of the first frames of the method call stack (i.e. in higher layers) and an error message is presented to the application user (or some other appropriate action is taken). Note that Hibernate might also throw other unchecked exceptions which are not a <literal>HibernateException</literal>. These are, again, not recoverable and appropriate action should be taken." +#. Tag: para +#: transactions.xml:537 +#, no-c-format +msgid "" +"The <literal>HibernateException</literal>, which wraps most of the errors " +"that can occur in a Hibernate persistence layer, is an unchecked exception " +"(it wasn't in older versions of Hibernate). In our opinion, we shouldn't " +"force the application developer to catch an unrecoverable exception at a low " +"layer. In most systems, unchecked and fatal exceptions are handled in one of " +"the first frames of the method call stack (i.e. in higher layers) and an " +"error message is presented to the application user (or some other " +"appropriate action is taken). Note that Hibernate might also throw other " +"unchecked exceptions which are not a <literal>HibernateException</literal>. " +"These are, again, not recoverable and appropriate action should be taken." msgstr "" +"A exceção <literal>HibernateException</literal>, a qual envolve a maioria " +"dos erros que podem ocorrer em uma camada de persistência do Hibernate, é " +"uma exceção unchecked ( não estava em umas versões mais antigas de " +"Hibernate). Em nossa opinião, nós não devemos forçar o desenvolvedor a " +"tratar uma exceção irrecuperável em uma camada mais baixa. Na maioria dos " +"sistemas, as exceções unchecked e fatais são tratadas em um dos primeiros " +"frames da pilha da chamada do método (isto é, em umas camadas mais elevadas) " +"e uma mensagem de erro é apresentada ao usuário da aplicação (ou a alguma " +"outra ação apropriada é feita). Note que Hibernate pode também lançar outras " +"exceções unchecked que não são um <literal>HibernateException</literal>. " +"Estas, também são, irrecuperáveis e uma ação apropriada deve ser tomada." -#: index.docbook:549 -msgid "Hibernate wraps <literal>SQLException</literal>s thrown while interacting with the database in a <literal>JDBCException</literal>. In fact, Hibernate will attempt to convert the eexception into a more meningful subclass of <literal>JDBCException</literal>. The underlying <literal>SQLException</literal> is always available via <literal>JDBCException.getCause()</literal>. Hibernate converts the <literal>SQLException</literal> into an appropriate <literal>JDBCException</literal> subclass using the <literal>SQLExceptionConverter</literal> attached to the <literal>SessionFactory</literal>. By default, the <literal>SQLExceptionConverter</literal> is defined by the configured dialect; however, it is also possible to plug in a custom implementation (see the javadocs for the <literal>SQLExceptionConverterFactory</literal> class for details). The standard <literal>JDBCException</literal> subtypes are:" +#. Tag: para +#: transactions.xml:549 +#, no-c-format +msgid "" +"Hibernate wraps <literal>SQLException</literal>s thrown while interacting " +"with the database in a <literal>JDBCException</literal>. In fact, Hibernate " +"will attempt to convert the eexception into a more meningful subclass of " +"<literal>JDBCException</literal>. The underlying <literal>SQLException</" +"literal> is always available via <literal>JDBCException.getCause()</" +"literal>. Hibernate converts the <literal>SQLException</literal> into an " +"appropriate <literal>JDBCException</literal> subclass using the " +"<literal>SQLExceptionConverter</literal> attached to the " +"<literal>SessionFactory</literal>. By default, the " +"<literal>SQLExceptionConverter</literal> is defined by the configured " +"dialect; however, it is also possible to plug in a custom implementation " +"(see the javadocs for the <literal>SQLExceptionConverterFactory</literal> " +"class for details). The standard <literal>JDBCException</literal> subtypes " +"are:" msgstr "" +"O Hibernate envolve <literal>SQLException</literal>s lançadas ao interagir " +"com a base de dados em um <literal>JDBCException</literal>. Na realidade, o " +"Hibernate tentará converter a exceção em em uma sub classe mais " +"significativa da <literal>JDBCException</literal>. A <literal>SQLException</" +"literal> subjacente está sempre disponível através de <literal>JDBCException." +"getCause()</literal>. O Hibernate converte a <literal>SQLException</literal> " +"em uma sub classe <literal>JDBCException</literal> apropriada usando " +"<literal>SQLExceptionConverter</literal> associado ao SessionFactory. Por " +"padrão, o <literal>SQLExceptionConverter</literal> é definido pelo dialeto " +"configurado; entretanto, é também possível conectar em uma implementação " +"customizada (veja o javadoc para mais detalhes da classe " +"<literal>SQLExceptionConverterFactory</literal>). Os subtipos padrão de " +"<literal>JDBCException</literal> são:" -#: index.docbook:565 -msgid "<literal>JDBCConnectionException</literal> - indicates an error with the underlying JDBC communication." +#. Tag: para +#: transactions.xml:565 +#, no-c-format +msgid "" +"<literal>JDBCConnectionException</literal> - indicates an error with the " +"underlying JDBC communication." msgstr "" +"<literal>JDBCConnectionException</literal> - indica um erro com a " +"comunicação subjacente de JDBC." -#: index.docbook:571 -msgid "<literal>SQLGrammarException</literal> - indicates a grammar or syntax problem with the issued SQL." +#. Tag: para +#: transactions.xml:571 +#, no-c-format +msgid "" +"<literal>SQLGrammarException</literal> - indicates a grammar or syntax " +"problem with the issued SQL." msgstr "" +"<literal>SQLGrammarException</literal> - indica um problema da gramática ou " +"da sintaxe com o SQL emitido." -#: index.docbook:577 -msgid "<literal>ConstraintViolationException</literal> - indicates some form of integrity constraint violation." +#. Tag: para +#: transactions.xml:577 +#, no-c-format +msgid "" +"<literal>ConstraintViolationException</literal> - indicates some form of " +"integrity constraint violation." msgstr "" +"<literal>ConstraintViolationException</literal> - indica algum forma de " +"violação de confinamento de integridade." -#: index.docbook:583 -msgid "<literal>LockAcquisitionException</literal> - indicates an error acquiring a lock level necessary to perform the requested operation." +#. Tag: para +#: transactions.xml:583 +#, no-c-format +msgid "" +"<literal>LockAcquisitionException</literal> - indicates an error acquiring a " +"lock level necessary to perform the requested operation." msgstr "" +"<literal>LockAcquisitionException</literal> - indica um erro ao adquirir um " +"nível de bloqueio necessário para realizar a operação de requisição." -#: index.docbook:589 -msgid "<literal>GenericJDBCException</literal> - a generic exception which did not fall into any of the other categories." +#. Tag: para +#: transactions.xml:589 +#, no-c-format +msgid "" +"<literal>GenericJDBCException</literal> - a generic exception which did not " +"fall into any of the other categories." msgstr "" +"<literal>GenericJDBCException</literal> - uma exceção genérica que não cai " +"em algumas das outras categorias." -#: index.docbook:599 +#. Tag: title +#: transactions.xml:599 +#, no-c-format msgid "Transaction timeout" -msgstr "" +msgstr "Timeout de Transação" -#: index.docbook:601 -msgid "One extremely important feature provided by a managed environment like EJB that is never provided for non-managed code is transaction timeout. Transaction timeouts ensure that no misbehaving transaction can indefinitely tie up resources while returning no response to the user. Outside a managed (JTA) environment, Hibernate cannot fully provide this functionality. However, Hibernate can at least control data access operations, ensuring that database level deadlocks and queries with huge result sets are limited by a defined timeout. In a managed environment, Hibernate can delegate transaction timeout to JTA. This functioanlity is abstracted by the Hibernate <literal>Transaction</literal> object." +#. Tag: para +#: transactions.xml:601 +#, no-c-format +msgid "" +"One extremely important feature provided by a managed environment like EJB " +"that is never provided for non-managed code is transaction timeout. " +"Transaction timeouts ensure that no misbehaving transaction can indefinitely " +"tie up resources while returning no response to the user. Outside a managed " +"(JTA) environment, Hibernate cannot fully provide this functionality. " +"However, Hibernate can at least control data access operations, ensuring " +"that database level deadlocks and queries with huge result sets are limited " +"by a defined timeout. In a managed environment, Hibernate can delegate " +"transaction timeout to JTA. This functioanlity is abstracted by the " +"Hibernate <literal>Transaction</literal> object." msgstr "" +"Uma característica extremamente importante fornecida por um ambiente " +"gerenciado como EJB e que nunca é fornecido pelo código não gerenciado é o " +"timeout de transação. Timeouts de transação asseguram que nenhuma transação " +"possa reter indefinidamente recursos enquanto não retorna nenhuma resposta " +"ao usuário. Fora de um ambiente controlado (JTA), o Hibernate não pode " +"fornecer inteiramente esta funcionalidade. Entretanto, o Hibernate pode " +"afinal controlar as operações do acesso a dados, assegurando que o nível de " +"deadlocks e queries do banco de dados com imensos resultados definidos sejam " +"limitados pelo timeout. Em um ambiente gerenciado, o Hibernate pode delegar " +"o timeout da transação ao JTA. Esta funcionalidade é abstraída pelo objeto " +"<literal>Transaction</literal> do Hibernate." -#: index.docbook:614 +#. Tag: programlisting +#: transactions.xml:614 +#, no-c-format msgid "" - "<![CDATA[\n" - "Session sess = factory.openSession();\n" - "try {\n" - " //set transaction timeout to 3 seconds\n" - " sess.getTransaction().setTimeout(3);\n" - " sess.getTransaction().begin();\n" - "\n" - " // do some work\n" - " ...\n" - "\n" - " sess.getTransaction().commit()\n" - "}\n" - "catch (RuntimeException e) {\n" - " sess.getTransaction().rollback();\n" - " throw e; // or display error message\n" - "}\n" - "finally {\n" - " sess.close();\n" - "}]]>" +"<![CDATA[\n" +"Session sess = factory.openSession();\n" +"try {\n" +" //set transaction timeout to 3 seconds\n" +" sess.getTransaction().setTimeout(3);\n" +" sess.getTransaction().begin();\n" +"\n" +" // do some work\n" +" ...\n" +"\n" +" sess.getTransaction().commit()\n" +"}\n" +"catch (RuntimeException e) {\n" +" sess.getTransaction().rollback();\n" +" throw e; // or display error message\n" +"}\n" +"finally {\n" +" sess.close();\n" +"}]]>" msgstr "" -#: index.docbook:616 -msgid "Note that <literal>setTimeout()</literal> may not be called in a CMT bean, where transaction timeouts must be defined declaratively." +#. Tag: para +#: transactions.xml:616 +#, no-c-format +msgid "" +"Note that <literal>setTimeout()</literal> may not be called in a CMT bean, " +"where transaction timeouts must be defined declaratively." msgstr "" +"Veja que <literal>setTimeout()</literal> não pode ser chamado em um CMT " +"bean, onde os timeouts das transações devem ser definidos declarativamente." -#: index.docbook:626 +#. Tag: title +#: transactions.xml:626 +#, no-c-format msgid "Optimistic concurrency control" -msgstr "" +msgstr "Controle de concorrência otimista" -#: index.docbook:628 -msgid "The only approach that is consistent with high concurrency and high scalability is optimistic concurrency control with versioning. Version checking uses version numbers, or timestamps, to detect conflicting updates (and to prevent lost updates). Hibernate provides for three possible approaches to writing application code that uses optimistic concurrency. The use cases we show are in the context of long conversations, but version checking also has the benefit of preventing lost updates in single database transactions." +#. Tag: para +#: transactions.xml:628 +#, no-c-format +msgid "" +"The only approach that is consistent with high concurrency and high " +"scalability is optimistic concurrency control with versioning. Version " +"checking uses version numbers, or timestamps, to detect conflicting updates " +"(and to prevent lost updates). Hibernate provides for three possible " +"approaches to writing application code that uses optimistic concurrency. The " +"use cases we show are in the context of long conversations, but version " +"checking also has the benefit of preventing lost updates in single database " +"transactions." msgstr "" +"O único caminho que é consistente com a elevada concorrência e " +"escalabilidade é controle de concorrência otimista com versionamento. " +"Checagem de versão usa número de versão, ou timestamps, para detectar " +"conflitos de atualizações (e para impedir atualizações perdidas). O " +"Hibernate fornece três caminhos possíveis para escrever aplicações que usam " +"concorrência otimista. Os casos de uso que nós mostramos estão no contexto " +"de conversações longas, mas a checagem de versão também tem o benefício de " +"impedir atualizações perdidas em únicas transações." -#: index.docbook:639 +#. Tag: title +#: transactions.xml:639 +#, no-c-format msgid "Application version checking" -msgstr "" +msgstr "Checagem de versão da aplicação" -#: index.docbook:641 -msgid "In an implementation without much help from Hibernate, each interaction with the database occurs in a new <literal>Session</literal> and the developer is responsible for reloading all persistent instances from the database before manipulating them. This approach forces the application to carry out its own version checking to ensure conversation transaction isolation. This approach is the least efficient in terms of database access. It is the approach most similar to entity EJBs." +#. Tag: para +#: transactions.xml:641 +#, no-c-format +msgid "" +"In an implementation without much help from Hibernate, each interaction with " +"the database occurs in a new <literal>Session</literal> and the developer is " +"responsible for reloading all persistent instances from the database before " +"manipulating them. This approach forces the application to carry out its own " +"version checking to ensure conversation transaction isolation. This approach " +"is the least efficient in terms of database access. It is the approach most " +"similar to entity EJBs." msgstr "" +"Em uma implementação sem muita ajuda do Hibernate, cada interação com o " +"banco de dados ocorre em uma nova <literal>Session</literal> e o " +"desenvolvedor é responsável para recarregar todas as instâncias persistentes " +"da base de dados antes de manipulá-las. Este caminho força a aplicação a " +"realizar sua própria checagem de versão para assegurar a conversação do " +"isolamento da transação. Este caminho é menos eficiente em termos de acesso " +"ao banco de dados. É a caminho mais similar a EJBs entity." -#: index.docbook:650 +#. Tag: programlisting +#: transactions.xml:650 +#, no-c-format msgid "" - "<![CDATA[// foo is an instance loaded by a previous Session\n" - "session = factory.openSession();\n" - "Transaction t = session.beginTransaction();\n" - "\n" - "int oldVersion = foo.getVersion();\n" - "session.load( foo, foo.getKey() ); // load the current state\n" - "if ( oldVersion != foo.getVersion() ) throw new StaleObjectStateException();\n" - "foo.setProperty(\"bar\");\n" - "\n" - "t.commit();\n" - "session.close();]]>" +"<![CDATA[// foo is an instance loaded by a previous Session\n" +"session = factory.openSession();\n" +"Transaction t = session.beginTransaction();\n" +"\n" +"int oldVersion = foo.getVersion();\n" +"session.load( foo, foo.getKey() ); // load the current state\n" +"if ( oldVersion != foo.getVersion() ) throw new StaleObjectStateException" +"();\n" +"foo.setProperty(\"bar\");\n" +"\n" +"t.commit();\n" +"session.close();]]>" msgstr "" -#: index.docbook:652 -msgid "The <literal>version</literal> property is mapped using <literal><version></literal>, and Hibernate will automatically increment it during flush if the entity is dirty." +#. Tag: para +#: transactions.xml:652 +#, no-c-format +msgid "" +"The <literal>version</literal> property is mapped using <literal><" +"version></literal>, and Hibernate will automatically increment it during " +"flush if the entity is dirty." msgstr "" +"A propriedade <literal>version</literal> é mapeada usando <literal><" +"version></literal>, e o Hibernate vai incrementá-lo-á automaticamente " +"durante o flush se a entidade estiver alterada." -#: index.docbook:658 -msgid "Of course, if you are operating in a low-data-concurrency environment and don't require version checking, you may use this approach and just skip the version check. In that case, <emphasis>last commit wins</emphasis> will be the default strategy for your long conversations. Keep in mind that this might confuse the users of the application, as they might experience lost updates without error messages or a chance to merge conflicting changes." +#. Tag: para +#: transactions.xml:658 +#, no-c-format +msgid "" +"Of course, if you are operating in a low-data-concurrency environment and " +"don't require version checking, you may use this approach and just skip the " +"version check. In that case, <emphasis>last commit wins</emphasis> will be " +"the default strategy for your long conversations. Keep in mind that this " +"might confuse the users of the application, as they might experience lost " +"updates without error messages or a chance to merge conflicting changes." msgstr "" +"Claro, se você se estiver operando em um ambiente de baixa concorrência de " +"dados e não requerer a checagem de versão, você pode usar este caminho e " +"apenas saltar a checagem de versão. Nesse caso, o <emphasis>ultimo commit " +"realizdo </emphasis> é a estratégia padrão para suas conversações longas. " +"Mantenha em mente que isto pode confundir os usuários da aplicação, assim " +"como eles podem experimentar atualizações perdidas sem mensagens de erro ou " +"uma possibilidade ajustar mudanças de conflito." -#: index.docbook:667 -msgid "Clearly, manual version checking is only feasible in very trivial circumstances and not practical for most applications. Often not only single instances, but complete graphs of modified ojects have to be checked. Hibernate offers automatic version checking with either an extended <literal>Session</literal> or detached instances as the design paradigm." +#. Tag: para +#: transactions.xml:667 +#, no-c-format +msgid "" +"Clearly, manual version checking is only feasible in very trivial " +"circumstances and not practical for most applications. Often not only single " +"instances, but complete graphs of modified ojects have to be checked. " +"Hibernate offers automatic version checking with either an extended " +"<literal>Session</literal> or detached instances as the design paradigm." msgstr "" +"Claro que, checagem manual da versão é somente praticável em circunstâncias " +"triviais e não para a maioria de aplicações. Freqüentemente, os grafos " +"completos de objetos modificados têm que ser verificados, não somente únicas " +"instâncias. O Hibernate oferece checagem de versão automática com uma " +"<literal>Session</literal> estendida ou instâncias desatachadas como o " +"paradigma do projeto." -#: index.docbook:678 +#. Tag: title +#: transactions.xml:678 +#, no-c-format msgid "Extended session and automatic versioning" -msgstr "" +msgstr "Sessão estendida e versionamento automático" -#: index.docbook:680 -msgid "A single <literal>Session</literal> instance and its persistent instances are used for the whole conversation, known as <emphasis>session-per-conversation</emphasis>. Hibernate checks instance versions at flush time, throwing an exception if concurrent modification is detected. It's up to the developer to catch and handle this exception (common options are the opportunity for the user to merge changes or to restart the business conversation with non-stale data)." +#. Tag: para +#: transactions.xml:680 +#, no-c-format +msgid "" +"A single <literal>Session</literal> instance and its persistent instances " +"are used for the whole conversation, known as <emphasis>session-per-" +"conversation</emphasis>. Hibernate checks instance versions at flush time, " +"throwing an exception if concurrent modification is detected. It's up to the " +"developer to catch and handle this exception (common options are the " +"opportunity for the user to merge changes or to restart the business " +"conversation with non-stale data)." msgstr "" +"Uma única instância de <literal>Session</literal> e suas instâncias " +"persistentes são usadas para a conversação inteira, isto é conhecido como " +"<emphasis>session-per-conversation</emphasis>. O Hibernate verifica versões " +"da instância no momento dio flush, lançando uma exceção se a modificação " +"concorrente for detectada. Até o desenvolvedor pegar e tratar essa exceção " +"(as opções comuns são a oportunidade para que o usuário intercale as " +"mudanças ou reinicie a conversação do negócio com dados não antigos)." -#: index.docbook:689 -msgid "The <literal>Session</literal> is disconnected from any underlying JDBC connection when waiting for user interaction. This approach is the most efficient in terms of database access. The application need not concern itself with version checking or with reattaching detached instances, nor does it have to reload instances in every database transaction." +#. Tag: para +#: transactions.xml:689 +#, no-c-format +msgid "" +"The <literal>Session</literal> is disconnected from any underlying JDBC " +"connection when waiting for user interaction. This approach is the most " +"efficient in terms of database access. The application need not concern " +"itself with version checking or with reattaching detached instances, nor " +"does it have to reload instances in every database transaction." msgstr "" +"The <literal>Session</literal> is disconnected from any underlying JDBC " +"connection when waiting for user interaction. This approach is the most " +"efficient in terms of database access. The application need not concern " +"itself with version checking or with reattaching detached instances, nor " +"does it have to reload instances in every database transaction. A " +"<literal>Session</literal> é desconectada de toda a conexão JDBC subjacente " +"enquanto espera a interação do usuário. Este caminho é a mais eficiente em " +"termos de acesso a bancos de dados. A aplicação não necessita concernir-se " +"com a checagem de versão ou com as instâncias destacadas reatadas, nem tem " +"que recarregar instâncias em cada transação." -#: index.docbook:697 +#. Tag: programlisting +#: transactions.xml:697 +#, no-c-format msgid "" - "<![CDATA[// foo is an instance loaded earlier by the old session\n" - "Transaction t = session.beginTransaction(); // Obtain a new JDBC connection, start transaction\n" - "\n" - "foo.setProperty(\"bar\");\n" - "\n" - "session.flush(); // Only for last transaction in conversation\n" - "t.commit(); // Also return JDBC connection\n" - "session.close(); // Only for last transaction in conversation]]>" +"<![CDATA[// foo is an instance loaded earlier by the old session\n" +"Transaction t = session.beginTransaction(); // Obtain a new JDBC connection, " +"start transaction\n" +"\n" +"foo.setProperty(\"bar\");\n" +"\n" +"session.flush(); // Only for last transaction in conversation\n" +"t.commit(); // Also return JDBC connection\n" +"session.close(); // Only for last transaction in conversation]]>" msgstr "" -#: index.docbook:698 -msgid "The <literal>foo</literal> object still knows which <literal>Session</literal> it was loaded in. Beginning a new database transaction on an old session obtains a new connection and resumes the session. Committing a database transaction disconnects a session from the JDBC connection and returns the connection to the pool. After reconnection, to force a version check on data you aren't updating, you may call <literal>Session.lock()</literal> with <literal>LockMode.READ</literal> on any objects that might have been updated by another transaction. You don't need to lock any data that you <emphasis>are</emphasis> updating. Usually you would set <literal>FlushMode.MANUAL</literal> on an extended <literal>Session</literal>, so that only the last database transaction cycle is allowed to actually persist all modifications made in this conversation. Hence, only this last database transaction would include the <literal>flush()</literal> operation, and then also <literal>close()! </literal> the session to end the conversation." +#. Tag: para +#: transactions.xml:698 +#, no-c-format +msgid "" +"The <literal>foo</literal> object still knows which <literal>Session</" +"literal> it was loaded in. Beginning a new database transaction on an old " +"session obtains a new connection and resumes the session. Committing a " +"database transaction disconnects a session from the JDBC connection and " +"returns the connection to the pool. After reconnection, to force a version " +"check on data you aren't updating, you may call <literal>Session.lock()</" +"literal> with <literal>LockMode.READ</literal> on any objects that might " +"have been updated by another transaction. You don't need to lock any data " +"that you <emphasis>are</emphasis> updating. Usually you would set " +"<literal>FlushMode.MANUAL</literal> on an extended <literal>Session</" +"literal>, so that only the last database transaction cycle is allowed to " +"actually persist all modifications made in this conversation. Hence, only " +"this last database transaction would include the <literal>flush()</literal> " +"operation, and then also <literal>close()</literal> the session to end the " +"conversation." msgstr "" +"O objeto <literal>foo</literal> sabe que <literal>Session</literal> já foi " +"carregada. Começando uma nova transação em uma sessão velha obtém uma " +"conexão nova e recomeça a sessão. Commitando uma transação desconecta uma " +"sessão da conexão JDBC e retorna a conexão ao pool. Após a reconexão, forçar " +"uma checagem de versão em dados que você não está atualizando, você pode " +"chamar <literal>Session.lock()</literal> com o <literal>LockMode.READ</" +"literal> em todos os objetos que possam ter sido atualizados por uma outra " +"transação. Você não necessita bloquear nenhum dado para atualizar. " +"Geralmente você configuraria <literal>FlushMode.MANUAL</literal> em uma " +"<literal>Session</literal> estendida, de modo que somente o último ciclo da " +"transação tenha permissão de persistir todas as modificações feitas nesta " +"conversação. Disso, somente esta última transação incluiria a operação " +"<literal>flush()</literal> e então chamar também <literal>close()</literal> " +"da sessão para terminar a conversação." -#: index.docbook:713 -msgid "This pattern is problematic if the <literal>Session</literal> is too big to be stored during user think time, e.g. an <literal>HttpSession</literal> should be kept as small as possible. As the <literal>Session</literal> is also the (mandatory) first-level cache and contains all loaded objects, we can probably use this strategy only for a few request/response cycles. You should use a <literal>Session</literal> only for a single conversation, as it will soon also have stale data." +#. Tag: para +#: transactions.xml:713 +#, no-c-format +msgid "" +"This pattern is problematic if the <literal>Session</literal> is too big to " +"be stored during user think time, e.g. an <literal>HttpSession</literal> " +"should be kept as small as possible. As the <literal>Session</literal> is " +"also the (mandatory) first-level cache and contains all loaded objects, we " +"can probably use this strategy only for a few request/response cycles. You " +"should use a <literal>Session</literal> only for a single conversation, as " +"it will soon also have stale data." msgstr "" +"Este pattern é problemático se a <literal>Session</literal> for " +"demasiadamente grande para ser armazenado durante o tempo que usuário " +"pensar, por exemplo um <literal>HttpSession</literal> estiver mantido tão " +"pequeno quanto possível. Como o <literal>Session</literal> é também cache de " +"primeiro nível (imperativo) e contém todos os objetos carregados, nós " +"podemos provavelmente usar esta estratégia somente para alguns ciclos de " +"requisição/resposta. Você deve usar a <literal>Session</literal> somente " +"para uma única conversação, porque ela logo também estará com dados velhos." -#: index.docbook:723 -msgid "(Note that earlier Hibernate versions required explicit disconnection and reconnection of a <literal>Session</literal>. These methods are deprecated, as beginning and ending a transaction has the same effect.)" +#. Tag: para +#: transactions.xml:723 +#, no-c-format +msgid "" +"(Note that earlier Hibernate versions required explicit disconnection and " +"reconnection of a <literal>Session</literal>. These methods are deprecated, " +"as beginning and ending a transaction has the same effect.)" msgstr "" +"(Note que versões mais atuais de Hibernate requerem a desconexão e o " +"reconexão explícitas de uma <literal>Session</literal>. Estes métodos são " +"desatualizados, como o início e término de uma transação tem o mesmo efeito.)" -#: index.docbook:729 -msgid "Also note that you should keep the disconnected <literal>Session</literal> close to the persistence layer. In other words, use an EJB stateful session bean to hold the <literal>Session</literal> in a three-tier environment, and don't transfer it to the web layer (or even serialize it to a separate tier) to store it in the <literal>HttpSession</literal>." +#. Tag: para +#: transactions.xml:729 +#, no-c-format +msgid "" +"Also note that you should keep the disconnected <literal>Session</literal> " +"close to the persistence layer. In other words, use an EJB stateful session " +"bean to hold the <literal>Session</literal> in a three-tier environment, and " +"don't transfer it to the web layer (or even serialize it to a separate tier) " +"to store it in the <literal>HttpSession</literal>." msgstr "" +"Note também que você deve manter a <literal>Session</literal> desconectada " +"fechada para a camada de persistência. Ou seja, use um EJB stateful session " +"bean para prender a <literal>Session</literal> em um ambiente do três " +"camadas e não o transferir à camada web (ou até serializá-lo para uma camada " +"separada) para armazená-lo no <literal>HttpSession</literal>." -#: index.docbook:737 -msgid "The extended session pattern, or <emphasis>session-per-conversation</emphasis>, is more difficult to implement with automatic current session context management. You need to supply your own implementation of the <literal>CurrentSessionContext</literal> for this, see the Hibernate Wiki for examples." +#. Tag: para +#: transactions.xml:737 +#, no-c-format +msgid "" +"The extended session pattern, or <emphasis>session-per-conversation</" +"emphasis>, is more difficult to implement with automatic current session " +"context management. You need to supply your own implementation of the " +"<literal>CurrentSessionContext</literal> for this, see the Hibernate Wiki " +"for examples." msgstr "" +"O pattern sessão estendida, ou <emphasis>session-per-conversation</" +"emphasis>, é mais difícil de implementar com gerenciamento automático de " +"sessão atual. Você precisa fornecer sua própria implementação do " +"<literal>CurrentSessionContext</literal> para isto (veja o Hibernate Wiki " +"para exemplos)." -#: index.docbook:747 +#. Tag: title +#: transactions.xml:747 +#, no-c-format msgid "Detached objects and automatic versioning" -msgstr "" +msgstr "Objetos destacados e versionamento automático" -#: index.docbook:749 -msgid "Each interaction with the persistent store occurs in a new <literal>Session</literal>. However, the same persistent instances are reused for each interaction with the database. The application manipulates the state of detached instances originally loaded in another <literal>Session</literal> and then reattaches them using <literal>Session.update()</literal>, <literal>Session.saveOrUpdate()</literal>, or <literal>Session.merge()</literal>." +#. Tag: para +#: transactions.xml:749 +#, no-c-format +msgid "" +"Each interaction with the persistent store occurs in a new <literal>Session</" +"literal>. However, the same persistent instances are reused for each " +"interaction with the database. The application manipulates the state of " +"detached instances originally loaded in another <literal>Session</literal> " +"and then reattaches them using <literal>Session.update()</literal>, " +"<literal>Session.saveOrUpdate()</literal>, or <literal>Session.merge()</" +"literal>." msgstr "" +"Cada interação com o armazenamento persistente ocorre em uma " +"<literal>Session</literal> nova. Entretanto, as mesmas instâncias " +"persistentes são reusadas para cada interação com o banco de dados. A " +"aplicação manipula o estado das instâncias desatachadas originalmente " +"carregadas em um outro <literal>Session</literal> e reata-os então usando " +"<literal>Session.update()</literal>, <literal>Session.saveOrUpdate()</" +"literal> ou <literal>Session.merge()</literal>." -#: index.docbook:757 +#. Tag: programlisting +#: transactions.xml:757 +#, no-c-format msgid "" - "<![CDATA[// foo is an instance loaded by a previous Session\n" - "foo.setProperty(\"bar\");\n" - "session = factory.openSession();\n" - "Transaction t = session.beginTransaction();\n" - "session.saveOrUpdate(foo); // Use merge() if \"foo\" might have been loaded already\n" - "t.commit();\n" - "session.close();]]>" +"<![CDATA[// foo is an instance loaded by a previous Session\n" +"foo.setProperty(\"bar\");\n" +"session = factory.openSession();\n" +"Transaction t = session.beginTransaction();\n" +"session.saveOrUpdate(foo); // Use merge() if \"foo\" might have been loaded " +"already\n" +"t.commit();\n" +"session.close();]]>" msgstr "" -#: index.docbook:759 -msgid "Again, Hibernate will check instance versions during flush, throwing an exception if conflicting updates occured." +#. Tag: para +#: transactions.xml:759 +#, no-c-format +msgid "" +"Again, Hibernate will check instance versions during flush, throwing an " +"exception if conflicting updates occured." msgstr "" +"Outra vez, o Hibernate verificará versões da instância durante o flush, " +"lançando uma exceção se ocorrer conflitos de atualizações." -#: index.docbook:764 -msgid "You may also call <literal>lock()</literal> instead of <literal>update()</literal> and use <literal>LockMode.READ</literal> (performing a version check, bypassing all caches) if you are sure that the object has not been modified." +#. Tag: para +#: transactions.xml:764 +#, no-c-format +msgid "" +"You may also call <literal>lock()</literal> instead of <literal>update()</" +"literal> and use <literal>LockMode.READ</literal> (performing a version " +"check, bypassing all caches) if you are sure that the object has not been " +"modified." msgstr "" +"Você pode também chamar o <literal>lock()</literal> em vez de <literal>update" +"()</literal> e usar <literal>LockMode.READ</literal> (executando uma " +"checagem de versão, ignorando todos os caches) se você estiver certo de que " +"o objeto não foi modificado." -#: index.docbook:773 +#. Tag: title +#: transactions.xml:773 +#, no-c-format msgid "Customizing automatic versioning" -msgstr "" +msgstr "Versionamento automático customizado" -#: index.docbook:775 -msgid "You may disable Hibernate's automatic version increment for particular properties and collections by setting the <literal>optimistic-lock</literal> mapping attribute to <literal>false</literal>. Hibernate will then no longer increment versions if the property is dirty." +#. Tag: para +#: transactions.xml:775 +#, no-c-format +msgid "" +"You may disable Hibernate's automatic version increment for particular " +"properties and collections by setting the <literal>optimistic-lock</literal> " +"mapping attribute to <literal>false</literal>. Hibernate will then no longer " +"increment versions if the property is dirty." msgstr "" +"Você pode desabilitar o incremento da versão automática de Hibernate para " +"propriedades e coleções particulares configurando o mapeamento do atributo " +"<literal>optimistic-lock</literal> para false. O Hibernate então não irá " +"incrementa versões se a propriedade estiver modificada." -#: index.docbook:782 -msgid "Legacy database schemas are often static and can't be modified. Or, other applications might also access the same database and don't know how to handle version numbers or even timestamps. In both cases, versioning can't rely on a particular column in a table. To force a version check without a version or timestamp property mapping, with a comparison of the state of all fields in a row, turn on <literal>optimistic-lock=\"all\"</literal> in the <literal><class></literal> mapping. Note that this concepetually only works if Hibernate can compare the old and new state, i.e. if you use a single long <literal>Session</literal> and not session-per-request-with-detached-objects." +#. Tag: para +#: transactions.xml:782 +#, no-c-format +msgid "" +"Legacy database schemas are often static and can't be modified. Or, other " +"applications might also access the same database and don't know how to " +"handle version numbers or even timestamps. In both cases, versioning can't " +"rely on a particular column in a table. To force a version check without a " +"version or timestamp property mapping, with a comparison of the state of all " +"fields in a row, turn on <literal>optimistic-lock=\"all\"</literal> in the " +"<literal><class></literal> mapping. Note that this concepetually only " +"works if Hibernate can compare the old and new state, i.e. if you use a " +"single long <literal>Session</literal> and not session-per-request-with-" +"detached-objects." msgstr "" +"Os esquemas da base de dados legada são freqüentemente estáticos e não podem " +"ser modificados. Ou outras aplicações puderam também acessar a mesma base de " +"dados e não sabem tratar a versão dos números ou timestamps. Em ambos os " +"casos, o versionamento não pode confiar em uma coluna particular em uma " +"tabela. Para forçar uma checagem de versão sem uma versão ou mapeamento da " +"propriedade do timestamp com uma comparação do estado de todos os campos em " +"uma linha, configure <literal>optimistic-lock=\"all\"</literal> no " +"mapeamento <literal><class></literal>. Note que isto conceitualmente é " +"somente feito em trabalhos se Hibernate puder comparar o estado velho e " +"novo, isto é, se você usa um único <literal>Session</literal> longo e não " +"session-per-request-with-detached-objects." -#: index.docbook:793 -msgid "Sometimes concurrent modification can be permitted as long as the changes that have been made don't overlap. If you set <literal>optimistic-lock=\"dirty\"</literal> when mapping the <literal><class></literal>, Hibernate will only compare dirty fields during flush." +#. Tag: para +#: transactions.xml:793 +#, no-c-format +msgid "" +"Sometimes concurrent modification can be permitted as long as the changes " +"that have been made don't overlap. If you set <literal>optimistic-lock=" +"\"dirty\"</literal> when mapping the <literal><class></literal>, " +"Hibernate will only compare dirty fields during flush." msgstr "" +"Às vezes a modificação concorrente pode ser permitida tão longa quanto às " +"mudanças que tiveram sido feitas que não sobrepuseram. Se você configurar " +"<literal>optimistic-lock=\"dirty\"</literal> ao mapear o <literal><" +"class></literal>, o Hibernate comparará somente campos modificados " +"durante o flush." -#: index.docbook:799 -msgid "In both cases, with dedicated version/timestamp columns or with full/dirty field comparison, Hibernate uses a single <literal>UPDATE</literal> statement (with an appropriate <literal>WHERE</literal> clause) per entity to execute the version check and update the information. If you use transitive persistence to cascade reattachment to associated entities, Hibernate might execute uneccessary updates. This is usually not a problem, but <emphasis>on update</emphasis> triggers in the database might be executed even when no changes have been made to detached instances. You can customize this behavior by setting <literal>select-before-update=\"true\"</literal> in the <literal><class></literal> mapping, forcing Hibernate to <literal>SELECT</literal> the instance to ensure that changes did actually occur, before updating the row." +#. Tag: para +#: transactions.xml:799 +#, no-c-format +msgid "" +"In both cases, with dedicated version/timestamp columns or with full/dirty " +"field comparison, Hibernate uses a single <literal>UPDATE</literal> " +"statement (with an appropriate <literal>WHERE</literal> clause) per entity " +"to execute the version check and update the information. If you use " +"transitive persistence to cascade reattachment to associated entities, " +"Hibernate might execute uneccessary updates. This is usually not a problem, " +"but <emphasis>on update</emphasis> triggers in the database might be " +"executed even when no changes have been made to detached instances. You can " +"customize this behavior by setting <literal>select-before-update=\"true\"</" +"literal> in the <literal><class></literal> mapping, forcing Hibernate " +"to <literal>SELECT</literal> the instance to ensure that changes did " +"actually occur, before updating the row." msgstr "" +"Em ambos os casos, com as colunas dedicadas da versão/timestamp ou com " +"comparação do campo cheio/modificados, o Hibernate usa uma única declaração " +"UPDATE (com uma cláusula WHERE apropriada ) por entidade para executar a " +"checagem da versão e atualizar a informação. Se você usa a persistência " +"transitiva para cascatear o reatamento das entidades associadas, o Hibernate " +"pode executar atualizações desnecessárias. Isso não é geralmente um " +"problema, mas triggers <emphasis>on update</emphasis> em um banco de dados " +"podem ser executados mesmo quando nenhuma mudança foi feita nas instâncias " +"destacadas. Você pode customizar este comportamento configurando " +"<literal>select-before-update=\"true\"</literal> no mapeamento <literal><" +"class></literal>, forçando o Hibernate a dá um SELECT nas instâncias para " +"assegurar-se esse as mudanças ocorreram realmente, antes de atualizar a " +"linha." -#: index.docbook:817 +#. Tag: title +#: transactions.xml:817 +#, no-c-format msgid "Pessimistic Locking" -msgstr "" +msgstr "Locking pessimista" -#: index.docbook:819 -msgid "It is not intended that users spend much time worring about locking strategies. Its usually enough to specify an isolation level for the JDBC connections and then simply let the database do all the work. However, advanced users may sometimes wish to obtain exclusive pessimistic locks, or re-obtain locks at the start of a new transaction." +#. Tag: para +#: transactions.xml:819 +#, no-c-format +msgid "" +"It is not intended that users spend much time worring about locking " +"strategies. Its usually enough to specify an isolation level for the JDBC " +"connections and then simply let the database do all the work. However, " +"advanced users may sometimes wish to obtain exclusive pessimistic locks, or " +"re-obtain locks at the start of a new transaction." msgstr "" +"Não se pretende que os usuários gastam muitas horas se preocupando com suas " +"estratégias de locking. Geralmente é o bastante para especificar um nível de " +"isolamento para as conexões JDBC e então deixar simplesmente o banco de " +"dados fazer todo o trabalho. Entretanto, os usuários avançados podem às " +"vezes desejar obter locks pessimistas exclusivos, ou re-obter locks no " +"início de uma nova transação." -#: index.docbook:826 -msgid "Hibernate will always use the locking mechanism of the database, never lock objects in memory!" +#. Tag: para +#: transactions.xml:826 +#, no-c-format +msgid "" +"Hibernate will always use the locking mechanism of the database, never lock " +"objects in memory!" msgstr "" +"O Hibernate usará sempre o mecanismo de lock da base de dados, nunca trava " +"objetos na memória!" -#: index.docbook:831 -msgid "The <literal>LockMode</literal> class defines the different lock levels that may be acquired by Hibernate. A lock is obtained by the following mechanisms:" +#. Tag: para +#: transactions.xml:831 +#, no-c-format +msgid "" +"The <literal>LockMode</literal> class defines the different lock levels that " +"may be acquired by Hibernate. A lock is obtained by the following mechanisms:" msgstr "" +"A classe <literal>LockMode</literal> define os diferentes níveis de lock que " +"o Hibernate pode adquirir. Um lock é obtido pelos seguintes mecanismos:" -#: index.docbook:838 -msgid "<literal>LockMode.WRITE</literal> is acquired automatically when Hibernate updates or inserts a row." +#. Tag: para +#: transactions.xml:838 +#, no-c-format +msgid "" +"<literal>LockMode.WRITE</literal> is acquired automatically when Hibernate " +"updates or inserts a row." msgstr "" +"<literal>LockMode.WRITE</literal> é adquirido automaticamente quando o " +"Hibernate atualiza ou insere uma linha." -#: index.docbook:844 -msgid "<literal>LockMode.UPGRADE</literal> may be acquired upon explicit user request using <literal>SELECT ... FOR UPDATE</literal> on databases which support that syntax." +#. Tag: para +#: transactions.xml:844 +#, no-c-format +msgid "" +"<literal>LockMode.UPGRADE</literal> may be acquired upon explicit user " +"request using <literal>SELECT ... FOR UPDATE</literal> on databases which " +"support that syntax." msgstr "" +"<literal>LockMode.UPGRADE</literal> pode ser adquirido explicitamente pelo " +"usuário usando <literal>SELECT ... FOR UPDATE</literal> em um banco de dados " +"que suporte esse sintaxe." -#: index.docbook:850 -msgid "<literal>LockMode.UPGRADE_NOWAIT</literal> may be acquired upon explicit user request using a <literal>SELECT ... FOR UPDATE NOWAIT</literal> under Oracle." +#. Tag: para +#: transactions.xml:850 +#, no-c-format +msgid "" +"<literal>LockMode.UPGRADE_NOWAIT</literal> may be acquired upon explicit " +"user request using a <literal>SELECT ... FOR UPDATE NOWAIT</literal> under " +"Oracle." msgstr "" +"<literal>LockMode.UPGRADE_NOWAIT</literal> pode ser adquirido explicitamente " +"pelo usuário usando <literal>SELECT ... FOR UPDATE NOWAIT</literal> no " +"Oracle." -#: index.docbook:856 -msgid "<literal>LockMode.READ</literal> is acquired automatically when Hibernate reads data under Repeatable Read or Serializable isolation level. May be re-acquired by explicit user request." +#. Tag: para +#: transactions.xml:856 +#, no-c-format +msgid "" +"<literal>LockMode.READ</literal> is acquired automatically when Hibernate " +"reads data under Repeatable Read or Serializable isolation level. May be re-" +"acquired by explicit user request." msgstr "" +"<literal>LockMode.READ</literal> é adquirido automaticamente quando o " +"Hibernate lê dados em um nível Repeatable Read ou Serializable isolation. " +"Pode ser readquirido explicitamente pelo usuário." -#: index.docbook:863 -msgid "<literal>LockMode.NONE</literal> represents the absence of a lock. All objects switch to this lock mode at the end of a <literal>Transaction</literal>. Objects associated with the session via a call to <literal>update()</literal> or <literal>saveOrUpdate()</literal> also start out in this lock mode." +#. Tag: para +#: transactions.xml:863 +#, no-c-format +msgid "" +"<literal>LockMode.NONE</literal> represents the absence of a lock. All " +"objects switch to this lock mode at the end of a <literal>Transaction</" +"literal>. Objects associated with the session via a call to <literal>update()" +"</literal> or <literal>saveOrUpdate()</literal> also start out in this lock " +"mode." msgstr "" +"<literal>LockMode.NONE</literal> representa a ausência do lock. Todos os " +"objetos mudam para esse estado de lock no final da <literal>Transaction</" +"literal>. Objetos associados com a sessão através do método <literal>update()" +"</literal> ou <literal>saveOrUpdate()</literal> também são inicializados com " +"esse lock mode." -#: index.docbook:872 -msgid "The \"explicit user request\" is expressed in one of the following ways:" +#. Tag: para +#: transactions.xml:872 +#, no-c-format +msgid "" +"The \"explicit user request\" is expressed in one of the following ways:" msgstr "" +"O lock obtido \"explicitamente pelo usuário\" se dá em uma das seguintes " +"maneiras:" -#: index.docbook:878 -msgid "A call to <literal>Session.load()</literal>, specifying a <literal>LockMode</literal>." +#. Tag: para +#: transactions.xml:878 +#, no-c-format +msgid "" +"A call to <literal>Session.load()</literal>, specifying a <literal>LockMode</" +"literal>." msgstr "" +"Uma chamada a <literal>Session.load()</literal>, especificando o " +"<literal>LockMode</literal>." -#: index.docbook:883 +#. Tag: para +#: transactions.xml:883 +#, no-c-format msgid "A call to <literal>Session.lock()</literal>." -msgstr "" +msgstr "Uma chamada a <literal>Session.lock()</literal>." -#: index.docbook:888 +#. Tag: para +#: transactions.xml:888 +#, no-c-format msgid "A call to <literal>Query.setLockMode()</literal>." -msgstr "" +msgstr "Uma chamada a <literal>Query.setLockMode()</literal>." -#: index.docbook:894 -msgid "If <literal>Session.load()</literal> is called with <literal>UPGRADE</literal> or <literal>UPGRADE_NOWAIT</literal>, and the requested object was not yet loaded by the session, the object is loaded using <literal>SELECT ... FOR UPDATE</literal>. If <literal>load()</literal> is called for an object that is already loaded with a less restrictive lock than the one requested, Hibernate calls <literal>lock()</literal> for that object." +#. Tag: para +#: transactions.xml:894 +#, no-c-format +msgid "" +"If <literal>Session.load()</literal> is called with <literal>UPGRADE</" +"literal> or <literal>UPGRADE_NOWAIT</literal>, and the requested object was " +"not yet loaded by the session, the object is loaded using " +"<literal>SELECT ... FOR UPDATE</literal>. If <literal>load()</literal> is " +"called for an object that is already loaded with a less restrictive lock " +"than the one requested, Hibernate calls <literal>lock()</literal> for that " +"object." msgstr "" +"Se uma <literal>Session.load()</literal> é invocada com <literal>UPGRADE</" +"literal> ou <literal>UPGRADE_NOWAIT</literal>, e o objeto requisitado ainda " +"não foi carregado pela sessão, o objeto é carregado usando " +"<literal>SELECT ... FOR UPDATE</literal>. Se <literal>load()</literal> for " +"chamado para um objeto que já foi carregado com um lock menos restritivo que " +"o novo lock solicitado, o Hibernate invoca o método <literal>lock()</" +"literal> para aquele objeto." -#: index.docbook:903 -msgid "<literal>Session.lock()</literal> performs a version number check if the specified lock mode is <literal>READ</literal>, <literal>UPGRADE</literal> or <literal>UPGRADE_NOWAIT</literal>. (In the case of <literal>UPGRADE</literal> or <literal>UPGRADE_NOWAIT</literal>, <literal>SELECT ... FOR UPDATE</literal> is used.)" +#. Tag: para +#: transactions.xml:903 +#, no-c-format +msgid "" +"<literal>Session.lock()</literal> performs a version number check if the " +"specified lock mode is <literal>READ</literal>, <literal>UPGRADE</literal> " +"or <literal>UPGRADE_NOWAIT</literal>. (In the case of <literal>UPGRADE</" +"literal> or <literal>UPGRADE_NOWAIT</literal>, <literal>SELECT ... FOR " +"UPDATE</literal> is used.)" msgstr "" +"O método <literal>Session.lock()</literal> executa uma verificação no número " +"da versão se o modo de lock especificado for <literal>READ</literal>, " +"<literal>UPGRADE</literal> ou <literal>UPGRADE_NOWAIT</literal>.. (No caso " +"do <literal>UPGRADE</literal> ou <literal>UPGRADE_NOWAIT</literal>, é usado " +"<literal>SELECT ... FOR UPDATE</literal>.)" -#: index.docbook:910 -msgid "If the database does not support the requested lock mode, Hibernate will use an appropriate alternate mode (instead of throwing an exception). This ensures that applications will be portable." +#. Tag: para +#: transactions.xml:910 +#, no-c-format +msgid "" +"If the database does not support the requested lock mode, Hibernate will use " +"an appropriate alternate mode (instead of throwing an exception). This " +"ensures that applications will be portable." msgstr "" +"Se o banco de dados não suportar o lock mode solicitado, o Hibernate vai " +"usar um modo alternativo apropriado (ao invés de lançar uma exceção). Isso " +"garante que a aplicação vai ser portável." -#: index.docbook:919 +#. Tag: title +#: transactions.xml:919 +#, no-c-format msgid "Connection Release Modes" -msgstr "" +msgstr "Modos de liberar a Connection" -#: index.docbook:921 -msgid "The legacy (2.x) behavior of Hibernate in regards to JDBC connection management was that a <literal>Session</literal> would obtain a connection when it was first needed and then hold unto that connection until the session was closed. Hibernate 3.x introduced the notion of connection release modes to tell a session how to handle its JDBC connections. Note that the following discussion is pertinent only to connections provided through a configured <literal>ConnectionProvider</literal>; user-supplied connections are outside the breadth of this discussion. The different release modes are identified by the enumerated values of <literal>org.hibernate.ConnectionReleaseMode</literal>:" +#. Tag: para +#: transactions.xml:921 +#, no-c-format +msgid "" +"The legacy (2.x) behavior of Hibernate in regards to JDBC connection " +"management was that a <literal>Session</literal> would obtain a connection " +"when it was first needed and then hold unto that connection until the " +"session was closed. Hibernate 3.x introduced the notion of connection " +"release modes to tell a session how to handle its JDBC connections. Note " +"that the following discussion is pertinent only to connections provided " +"through a configured <literal>ConnectionProvider</literal>; user-supplied " +"connections are outside the breadth of this discussion. The different " +"release modes are identified by the enumerated values of <literal>org." +"hibernate.ConnectionReleaseMode</literal>:" msgstr "" +"O comportamento legado do Hibernate (2.x) em consideração ao gerenciamento " +"da conexão via JDBC fez com que a <literal>Session</literal> precisasse " +"obter uma conexão quando ela precisasse pela primeira vez e depois manter a " +"conexão enquanto a sessão não fosse fechada. O Hibernate 3.x introduz a " +"idéia de modos de liberar a sessão, para informar a sessão a forma como deve " +"manusear a sua conexão JDBC. Veja que essa discussão só é pertinente para " +"conexões fornecidas com um <literal>ConnectionProvider</literal> " +"configurado; conexões fornecidas pelo usuário estão fora do escopo dessa " +"discussão. Os diferentes modos de liberação estão definidos pelos valores da " +"enumeração <literal>org.hibernate.ConnectionReleaseMode</literal>:" -#: index.docbook:935 -msgid "<literal>ON_CLOSE</literal> - is essentially the legacy behavior described above. The Hibernate session obatins a connection when it first needs to perform some JDBC access and holds unto that connection until the session is closed." +#. Tag: para +#: transactions.xml:935 +#, no-c-format +msgid "" +"<literal>ON_CLOSE</literal> - is essentially the legacy behavior described " +"above. The Hibernate session obatins a connection when it first needs to " +"perform some JDBC access and holds unto that connection until the session is " +"closed." msgstr "" +"<literal>ON_CLOSE</literal> - essencialmente é o modo legado descrito acima. " +"A sessão do Hibernate obtêm a conexão quando precisar executar alguma " +"operação JDBC pela primeira vez e mantem enquanto a conexão não for fechada." -#: index.docbook:942 -msgid "<literal>AFTER_TRANSACTION</literal> - says to release connections after a <literal>org.hibernate.Transaction</literal> has completed." +#. Tag: para +#: transactions.xml:942 +#, no-c-format +msgid "" +"<literal>AFTER_TRANSACTION</literal> - says to release connections after a " +"<literal>org.hibernate.Transaction</literal> has completed." msgstr "" +"<literal>AFTER_TRANSACTION</literal> – informa que a conexão deve ser " +"liberada após a conclusão de uma <literal>org.hibernate.Transaction</" +"literal>." -#: index.docbook:948 -msgid "<literal>AFTER_STATEMENT</literal> (also referred to as aggressive release) - says to release connections after each and every statement execution. This aggressive releasing is skipped if that statement leaves open resources associated with the given session; currently the only situation where this occurs is through the use of <literal>org.hibernate.ScrollableResults</literal>." +#. Tag: para +#: transactions.xml:948 +#, no-c-format +msgid "" +"<literal>AFTER_STATEMENT</literal> (also referred to as aggressive release) " +"- says to release connections after each and every statement execution. This " +"aggressive releasing is skipped if that statement leaves open resources " +"associated with the given session; currently the only situation where this " +"occurs is through the use of <literal>org.hibernate.ScrollableResults</" +"literal>." msgstr "" +"<literal>AFTER_STATEMENT</literal> (também conhecida com liberação " +"agressiva) – informa que a conexão deve ser liberada após a execução de cada " +"statement. A liberação agressiva não ocorre se o statement deixa pra trás " +"algum recurso aberto associado com a sessão obtida; atualmente, a única " +"situação em que isso é possível é com o uso de <literal>org.hibernate." +"ScrollableResults</literal>." -#: index.docbook:958 -msgid "The configuration parameter <literal>hibernate.connection.release_mode</literal> is used to specify which release mode to use. The possible values:" +#. Tag: para +#: transactions.xml:958 +#, no-c-format +msgid "" +"The configuration parameter <literal>hibernate.connection.release_mode</" +"literal> is used to specify which release mode to use. The possible values:" msgstr "" +"O parâmetro de configuração <literal>hibernate.connection.release_mode</" +"literal> é usado para especificar qual modo de liberação deve ser usado. " +"Opções disponíveis:" -#: index.docbook:965 -msgid "<literal>auto</literal> (the default) - this choice delegates to the release mode returned by the <literal>org.hibernate.transaction.TransactionFactory.getDefaultReleaseMode()</literal> method. For JTATransactionFactory, this returns ConnectionReleaseMode.AFTER_STATEMENT; for JDBCTransactionFactory, this returns ConnectionReleaseMode.AFTER_TRANSACTION. It is rarely a good idea to change this default behavior as failures due to the value of this setting tend to indicate bugs and/or invalid assumptions in user code." +#. Tag: para +#: transactions.xml:965 +#, no-c-format +msgid "" +"<literal>auto</literal> (the default) - this choice delegates to the release " +"mode returned by the <literal>org.hibernate.transaction.TransactionFactory." +"getDefaultReleaseMode()</literal> method. For JTATransactionFactory, this " +"returns ConnectionReleaseMode.AFTER_STATEMENT; for JDBCTransactionFactory, " +"this returns ConnectionReleaseMode.AFTER_TRANSACTION. It is rarely a good " +"idea to change this default behavior as failures due to the value of this " +"setting tend to indicate bugs and/or invalid assumptions in user code." msgstr "" +"<literal>auto</literal> (padrão) – essa opção delega ao modo de liberação " +"retornado pelo método <literal>org.hibernate.transaction.TransactionFactory." +"getDefaultReleaseMode()</literal>. Para JTATransactionFactory, ele retorna " +"ConnectionReleaseMode.AFTER_STATEMENT; para JDBCTransactionFactory, ele " +"retorna ConnectionReleaseMode.AFTER_TRANSACTION. Raramente é uma boa idéia " +"alterar padrão, como frequencia ao se fazer isso temos falhas que parecem " +"bugs e/ou suposições inválidas no código do usuário." -#: index.docbook:975 -msgid "<literal>on_close</literal> - says to use ConnectionReleaseMode.ON_CLOSE. This setting is left for backwards compatibility, but its use is highly discouraged." +#. Tag: para +#: transactions.xml:975 +#, no-c-format +msgid "" +"<literal>on_close</literal> - says to use ConnectionReleaseMode.ON_CLOSE. " +"This setting is left for backwards compatibility, but its use is highly " +"discouraged." msgstr "" +"<literal>on_close</literal> - indica o uso da ConnectionReleaseMode." +"ON_CLOSE. Essa opção foi deixada para manter a compatibilidade, mas seu uso " +"é fortemente desencorajado." -#: index.docbook:981 -msgid "<literal>after_transaction</literal> - says to use ConnectionReleaseMode.AFTER_TRANSACTION. This setting should not be used in JTA environments. Also note that with ConnectionReleaseMode.AFTER_TRANSACTION, if a session is considered to be in auto-commit mode connections will be released as if the release mode were AFTER_STATEMENT." +#. Tag: para +#: transactions.xml:981 +#, no-c-format +msgid "" +"<literal>after_transaction</literal> - says to use ConnectionReleaseMode." +"AFTER_TRANSACTION. This setting should not be used in JTA environments. Also " +"note that with ConnectionReleaseMode.AFTER_TRANSACTION, if a session is " +"considered to be in auto-commit mode connections will be released as if the " +"release mode were AFTER_STATEMENT." msgstr "" +"<literal>after_transaction</literal> – indica o uso da ConnectionReleaseMode." +"AFTER_TRANSACTION. Essa opção nada deve ser usada com ambientes JTA. Também " +"note que no caso da ConnectionReleaseMode.AFTER_TRANSACTION, se a sessão foi " +"colocada no modo auto-commit a conexão vai ser liberada de forma similar ao " +"modo AFTER_STATEMENT." -#: index.docbook:989 -msgid "<literal>after_statement</literal> - says to use ConnectionReleaseMode.AFTER_STATEMENT. Additionally, the configured <literal>ConnectionProvider</literal> is consulted to see if it supports this setting (<literal>supportsAggressiveRelease()</literal>). If not, the release mode is reset to ConnectionReleaseMode.AFTER_TRANSACTION. This setting is only safe in environments where we can either re-acquire the same underlying JDBC connection each time we make a call into <literal>ConnectionProvider.getConnection()</literal> or in auto-commit environments where it does not matter whether we get back the same connection." +#. Tag: para +#: transactions.xml:989 +#, no-c-format +msgid "" +"<literal>after_statement</literal> - says to use ConnectionReleaseMode." +"AFTER_STATEMENT. Additionally, the configured <literal>ConnectionProvider</" +"literal> is consulted to see if it supports this setting " +"(<literal>supportsAggressiveRelease()</literal>). If not, the release mode " +"is reset to ConnectionReleaseMode.AFTER_TRANSACTION. This setting is only " +"safe in environments where we can either re-acquire the same underlying JDBC " +"connection each time we make a call into <literal>ConnectionProvider." +"getConnection()</literal> or in auto-commit environments where it does not " +"matter whether we get back the same connection." msgstr "" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "" - +"<literal>after_statement</literal> – indica o uso ConnectionReleaseMode." +"AFTER_STATEMENT. Adicionalmente, o <literal>ConnectionProvider</literal> " +"configurado é consultado para verificar se suporta essa configuração " +"((<literal>supportsAggressiveRelease()</literal>). Se não suportar, o modo " +"de liberação é redefinido como ConnectionRelease-Mode.AFTER_TRANSACTION. " +"Essa configuração só é segura em ambientes onde podemos readquirir a mesma " +"conexão JDBC toda vez que o método <literal>ConnectionProvider.getConnection" +"()</literal> for chamado ou em um ambiente auto-commit onde não importa se " +"nós recuperamos a mesma conexão." Modified: core/trunk/documentation/manual/translations/pt-BR/content/tutorial.po =================================================================== --- core/trunk/documentation/manual/translations/pt-BR/content/tutorial.po 2007-10-25 22:34:46 UTC (rev 14134) +++ core/trunk/documentation/manual/translations/pt-BR/content/tutorial.po 2007-10-26 00:46:38 UTC (rev 14135) @@ -1,1315 +1,2829 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:48+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:7 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: tutorial.xml:7 +#, no-c-format msgid "Introduction to Hibernate" -msgstr "" +msgstr "Introdução ao Hibernate" -#: index.docbook:10 +#. Tag: title +#: tutorial.xml:10 +#, no-c-format msgid "Preface" -msgstr "" +msgstr "Prefácio" -#: index.docbook:12 -msgid "This chapter is an introductory tutorial for new users of Hibernate. We start with a simple command line application using an in-memory database and develop it in easy to understand steps." +#. Tag: para +#: tutorial.xml:12 +#, no-c-format +msgid "" +"This chapter is an introductory tutorial for new users of Hibernate. We " +"start with a simple command line application using an in-memory database and " +"develop it in easy to understand steps." msgstr "" +"Este capítulo é um tutorial introdutório para novos usuários do Hibernate. " +"Nós iniciaremos com uma simples linha de comando em uma aplicação usando uma " +"base de dados em memória tornando isto um passo de fácil de compreender." -#: index.docbook:18 -msgid "This tutorial is intended for new users of Hibernate but requires Java and SQL knowledge. It is based on a tutorial by Michael Gloegl, the third-party libraries we name are for JDK 1.4 and 5.0. You might need others for JDK 1.3." +#. Tag: para +#: tutorial.xml:18 +#, no-c-format +msgid "" +"This tutorial is intended for new users of Hibernate but requires Java and " +"SQL knowledge. It is based on a tutorial by Michael Gloegl, the third-party " +"libraries we name are for JDK 1.4 and 5.0. You might need others for JDK 1.3." msgstr "" +"Este tutorial é voltado para novos usuários do Hibernate, mas requer um " +"conhecimento de Java e SQL. Este tutorial é baseado no tutorial de Michael " +"Gloegl, as bibliotecas Third Party foram nomeadas para JDK 1.4 e 5.0. Você " +"pode precisar de outras bibliotecas para JDK 1.3." -#: index.docbook:24 -msgid "The source code for the tutorial is included in the distribution in the <literal>doc/reference/tutorial/</literal> directory." +#. Tag: para +#: tutorial.xml:24 +#, no-c-format +msgid "" +"The source code for the tutorial is included in the distribution in the " +"<literal>doc/reference/tutorial/</literal> directory." msgstr "" +"O código fonte para o tutorial está incluído no diretório da distribuição " +"<literal>doc/reference/tutorial/</literal>." -#: index.docbook:32 +#. Tag: title +#: tutorial.xml:32 +#, no-c-format msgid "Part 1 - The first Hibernate Application" -msgstr "" +msgstr "Parte 1 – A primeira aplicação Hibernate" -#: index.docbook:34 -msgid "First, we'll create a simple console-based Hibernate application. We use an Java database (HSQL DB), so we do not have to install any database server." +#. Tag: para +#: tutorial.xml:34 +#, no-c-format +msgid "" +"First, we'll create a simple console-based Hibernate application. We use an " +"Java database (HSQL DB), so we do not have to install any database server." msgstr "" +"Primeiro, iremos criar uma simples aplicação Hibernate baseada em console. " +"Usaremos uma base de dados Java (HSQL DB), então não teremos que instalar " +"nenhum servidor de base de dados." -#: index.docbook:39 -msgid "Let's assume we need a small database application that can store events we want to attend, and information about the hosts of these events." +#. Tag: para +#: tutorial.xml:39 +#, no-c-format +msgid "" +"Let's assume we need a small database application that can store events we " +"want to attend, and information about the hosts of these events." msgstr "" +"Vamos supor que precisemos de uma aplicação com um banco de dados pequeno " +"que possa armazenar e atender os eventos que queremos, e as informaççes " +"sobre os hosts destes eventos." -#: index.docbook:44 -msgid "The first thing we do, is set up our development directory and put all the Java libraries we need into it. Download the Hibernate distribution from the Hibernate website. Extract the package and place all required libraries found in <literal>/lib</literal> into into the <literal>/lib</literal> directory of your new development working directory. It should look like this:" +#. Tag: para +#: tutorial.xml:44 +#, no-c-format +msgid "" +"The first thing we do, is set up our development directory and put all the " +"Java libraries we need into it. Download the Hibernate distribution from the " +"Hibernate website. Extract the package and place all required libraries " +"found in <literal>/lib</literal> into into the <literal>/lib</literal> " +"directory of your new development working directory. It should look like " +"this:" msgstr "" +"A primeira coisa que devemos fazer é configurar nosso diretório de " +"desenvolvimento, e colocar todas as bibliotecas Java que precisamos dentro " +"dele. Faça o download da distribuição do Hibernate no site do Hibernate. " +"Descompacte o pacote e coloque todas as bibliotecas necessárias encontradas " +"no diretório <literal>/lib</literal>, dentro do diretório <literal>/lib</" +"literal> do seu novo projeto. Você deverá ter algo parecido com isso:" -#: index.docbook:52 +#. Tag: programlisting +#: tutorial.xml:52 +#, no-c-format msgid "" - "<![CDATA[.\n" - "+lib\n" - " antlr.jar\n" - " cglib.jar\n" - " asm.jar\n" - " asm-attrs.jars\n" - " commons-collections.jar\n" - " commons-logging.jar\n" - " hibernate3.jar\n" - " jta.jar\n" - " dom4j.jar\n" - " log4j.jar ]]>" +"<![CDATA[.\n" +"+lib\n" +" antlr.jar\n" +" cglib.jar\n" +" asm.jar\n" +" asm-attrs.jars\n" +" commons-collections.jar\n" +" commons-logging.jar\n" +" hibernate3.jar\n" +" jta.jar\n" +" dom4j.jar\n" +" log4j.jar ]]>" msgstr "" -#: index.docbook:54 -msgid "This is the minimum set of required libraries (note that we also copied hibernate3.jar, the main archive) for Hibernate <emphasis>at the time of writing</emphasis>. The Hibernate release you are using might require more or less libraries. See the <literal>README.txt</literal> file in the <literal>lib/</literal> directory of the Hibernate distribution for more information about required and optional third-party libraries. (Actually, Log4j is not required but preferred by many developers.)" +#. Tag: para +#: tutorial.xml:54 +#, no-c-format +msgid "" +"This is the minimum set of required libraries (note that we also copied " +"hibernate3.jar, the main archive) for Hibernate <emphasis>at the time of " +"writing</emphasis>. The Hibernate release you are using might require more " +"or less libraries. See the <literal>README.txt</literal> file in the " +"<literal>lib/</literal> directory of the Hibernate distribution for more " +"information about required and optional third-party libraries. (Actually, " +"Log4j is not required but preferred by many developers.)" msgstr "" +"Esta é a configuração mínima requerida das bibliotecas (observe que também " +"foi copiado o hibernate3.jar da pasta principal do Hibernate) para o " +"Hibernate <emphasis>na hora do desenvolvimento</emphasis>. O Hibernate " +"permite que você utilize mais ou menos bibliotecas. Veja o arquivo " +"<literal>README.txt</literal> no diretório <literal>lib/</literal> da " +"distribuição do Hibernate para maiores informaççes sobre bibliotecas " +"requeridas e opcionais. (Atualmente, a biblioteca Log4j não é requerida, mas " +"é preferida por muitos desenvolvedores.)" -#: index.docbook:63 -msgid "Next we create a class that represents the event we want to store in database." +#. Tag: para +#: tutorial.xml:63 +#, no-c-format +msgid "" +"Next we create a class that represents the event we want to store in " +"database." msgstr "" +"Agora, iremos criar uma classe que representa o evento que queremos " +"armazenar na base de dados.." -#: index.docbook:68 +#. Tag: title +#: tutorial.xml:68 +#, no-c-format msgid "The first class" -msgstr "" +msgstr "A primeira Classe" -#: index.docbook:70 -msgid "Our first persistent class is a simple JavaBean class with some properties:" +#. Tag: para +#: tutorial.xml:70 +#, no-c-format +msgid "" +"Our first persistent class is a simple JavaBean class with some properties:" msgstr "" +"Nossa primeira classe de persistência é uma simples classe JavaBean com " +"algumas propriedades:" -#: index.docbook:74 +#. Tag: programlisting +#: tutorial.xml:74 +#, no-c-format msgid "" - "<![CDATA[package events;\n" - "\n" - "import java.util.Date;\n" - "\n" - "public class Event {\n" - " private Long id;\n" - "\n" - " private String title;\n" - " private Date date;\n" - "\n" - " public Event() {}\n" - "\n" - " public Long getId() {\n" - " return id;\n" - " }\n" - "\n" - " private void setId(Long id) {\n" - " this.id = id;\n" - " }\n" - "\n" - " public Date getDate() {\n" - " return date;\n" - " }\n" - "\n" - " public void setDate(Date date) {\n" - " this.date = date;\n" - " }\n" - "\n" - " public String getTitle() {\n" - " return title;\n" - " }\n" - "\n" - " public void setTitle(String title) {\n" - " this.title = title;\n" - " }\n" - "}]]>" +"<![CDATA[package events;\n" +"\n" +"import java.util.Date;\n" +"\n" +"public class Event {\n" +" private Long id;\n" +"\n" +" private String title;\n" +" private Date date;\n" +"\n" +" public Event() {}\n" +"\n" +" public Long getId() {\n" +" return id;\n" +" }\n" +"\n" +" private void setId(Long id) {\n" +" this.id = id;\n" +" }\n" +"\n" +" public Date getDate() {\n" +" return date;\n" +" }\n" +"\n" +" public void setDate(Date date) {\n" +" this.date = date;\n" +" }\n" +"\n" +" public String getTitle() {\n" +" return title;\n" +" }\n" +"\n" +" public void setTitle(String title) {\n" +" this.title = title;\n" +" }\n" +"}]]>" msgstr "" -#: index.docbook:76 -msgid "You can see that this class uses standard JavaBean naming conventions for property getter and setter methods, as well as private visibility for the fields. This is a recommended design - but not required. Hibernate can also access fields directly, the benefit of accessor methods is robustness for refactoring. The no-argument constructor is required to instantiate an object of this class through reflection." +#. Tag: para +#: tutorial.xml:76 +#, no-c-format +msgid "" +"You can see that this class uses standard JavaBean naming conventions for " +"property getter and setter methods, as well as private visibility for the " +"fields. This is a recommended design - but not required. Hibernate can also " +"access fields directly, the benefit of accessor methods is robustness for " +"refactoring. The no-argument constructor is required to instantiate an " +"object of this class through reflection." msgstr "" +"Você pode ver que esta classe usa o padrão JavaBean para o nomeamento " +"convencional da propriedade getter e dos métodos setter, como também a " +"visibilidade private dos campos. Este é um padrão de projeto recomendado, " +"mas não requerido. O Hibernate pode também acessar campos diretamente, o " +"benefício para os métodos de acesso é a robustez para o Refactoring. O " +"construtor sem argumento é requerido para instanciar um objeto desta classe " +"com a reflexão." -#: index.docbook:84 -msgid "The <literal>id</literal> property holds a unique identifier value for a particular event. All persistent entity classes (there are less important dependent classes as well) will need such an identifier property if we want to use the full feature set of Hibernate. In fact, most applications (esp. web applications) need to distinguish objects by identifier, so you should consider this a feature rather than a limitation. However, we usually don't manipulate the identity of an object, hence the setter method should be private. Only Hibernate will assign identifiers when an object is saved. You can see that Hibernate can access public, private, and protected accessor methods, as well as (public, private, protected) fields directly. The choice is up to you and you can match it to fit your application design." +#. Tag: para +#: tutorial.xml:84 +#, no-c-format +msgid "" +"The <literal>id</literal> property holds a unique identifier value for a " +"particular event. All persistent entity classes (there are less important " +"dependent classes as well) will need such an identifier property if we want " +"to use the full feature set of Hibernate. In fact, most applications (esp. " +"web applications) need to distinguish objects by identifier, so you should " +"consider this a feature rather than a limitation. However, we usually don't " +"manipulate the identity of an object, hence the setter method should be " +"private. Only Hibernate will assign identifiers when an object is saved. You " +"can see that Hibernate can access public, private, and protected accessor " +"methods, as well as (public, private, protected) fields directly. The choice " +"is up to you and you can match it to fit your application design." msgstr "" +"A propriedade <literal>id</literal> mantém um único valor de identificação " +"para um evento particular. Todas as classes persistentes da entidade (bem " +"como aquelas classes dependentes de menos importância) precisam de uma " +"propriedade de identificação, caso nós queiramos usar o conjunto completo de " +"características do Hibernate. De fato, a maioria das aplicações (esp. " +"aplicações web) precisam destinguir os objetos pelo identificador, então " +"você deverá considerar esta, uma característica em lugar de uma limitação. " +"Porém, nós normalmente não manipulamos a identidade de um objeto, " +"consequentemente o método setter deverá ser privado. O Hibernate somente " +"nomeará os identificadores quando um objeto for salvo. Você pode ver como o " +"Hibernate pode acessar métodos públicos, privados, e protegidos, como também " +"campos (públicos, privados, protegidos) diretamente. A escolha está até " +"você, e você pode combinar isso para adaptar seu projeto de aplicação" -#: index.docbook:96 -msgid "The no-argument constructor is a requirement for all persistent classes; Hibernate has to create objects for you, using Java Reflection. The constructor can be private, however, package visibility is required for runtime proxy generation and efficient data retrieval without bytecode instrumentation." +#. Tag: para +#: tutorial.xml:96 +#, no-c-format +msgid "" +"The no-argument constructor is a requirement for all persistent classes; " +"Hibernate has to create objects for you, using Java Reflection. The " +"constructor can be private, however, package visibility is required for " +"runtime proxy generation and efficient data retrieval without bytecode " +"instrumentation." msgstr "" +"O construtor sem argumentos é um requerimento para todas as classes " +"persistentes; O Hibernate tem que criar para você os objetos usando Java " +"Reflection. O construtor pode ser privado, porém, a visibilidade do pacote é " +"requerida para a procuração da geração em tempo de execução e recuperação " +"eficiente dos dados sem a instrumentação de bytecode" -#: index.docbook:103 -msgid "Place this Java source file in a directory called <literal>src</literal> in the development folder, and in its correct package. The directory should now look like this:" +#. Tag: para +#: tutorial.xml:103 +#, no-c-format +msgid "" +"Place this Java source file in a directory called <literal>src</literal> in " +"the development folder, and in its correct package. The directory should now " +"look like this:" msgstr "" +"Coloque este fonte Java no diretório chamado <literal>src</literal> na pasta " +"de desenvolvimento, e em seu pacote correto. O diretório deverá ser parecido " +"como este:" -#: index.docbook:108 +#. Tag: programlisting +#: tutorial.xml:108 +#, no-c-format msgid "" - "<![CDATA[.\n" - "+lib\n" - " <Hibernate and third-party libraries>\n" - "+src\n" - " +events\n" - " Event.java]]>" +"<![CDATA[.\n" +"+lib\n" +" <Hibernate and third-party libraries>\n" +"+src\n" +" +events\n" +" Event.java]]>" msgstr "" -#: index.docbook:110 +#. Tag: para +#: tutorial.xml:110 +#, no-c-format msgid "In the next step, we tell Hibernate about this persistent class." msgstr "" +"No próximo passo, iremos falar sobre as classes de persistência do " +"Hibernate.." -#: index.docbook:117 +#. Tag: title +#: tutorial.xml:117 +#, no-c-format msgid "The mapping file" -msgstr "" +msgstr "O mapeamento do arquivo" -#: index.docbook:119 -msgid "Hibernate needs to know how to load and store objects of the persistent class. This is where the Hibernate mapping file comes into play. The mapping file tells Hibernate what table in the database it has to access, and what columns in that table it should use." +#. Tag: para +#: tutorial.xml:119 +#, no-c-format +msgid "" +"Hibernate needs to know how to load and store objects of the persistent " +"class. This is where the Hibernate mapping file comes into play. The mapping " +"file tells Hibernate what table in the database it has to access, and what " +"columns in that table it should use." msgstr "" +"O Hibernate precisa saber como carregar e armazenar objetos da classe de " +"persistência. Isto será onde o mapeamento do arquivo do Hibernate entrará em " +"jogo. O arquivo mapeado informa ao Hibernate, qual tabela no banco de dados " +"ele deverá acessar, e quais as colunas na tabela ele deverá usar." -#: index.docbook:126 +#. Tag: para +#: tutorial.xml:126 +#, no-c-format msgid "The basic structure of a mapping file looks like this:" -msgstr "" +msgstr "A estrutura básica de um arquivo de mapeamento é parecida com:" -#: index.docbook:130 +#. Tag: programlisting +#: tutorial.xml:130 +#, no-c-format msgid "" - "<![CDATA[<?xml version=\"1.0\"?>\n" - "<!DOCTYPE hibernate-mapping PUBLIC\n" - " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" - " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" - "\n" - "<hibernate-mapping>\n" - "[...]\n" - "</hibernate-mapping>]]>" +"<![CDATA[<?xml version=\"1.0\"?>\n" +"<!DOCTYPE hibernate-mapping PUBLIC\n" +" \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" +" \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" +"\n" +"<hibernate-mapping>\n" +"[...]\n" +"</hibernate-mapping>]]>" msgstr "" -#: index.docbook:132 -msgid "Note that the Hibernate DTD is very sophisticated. You can use it for auto-completion of XML mapping elements and attributes in your editor or IDE. You also should open up the DTD file in your text editor - it's the easiest way to get an overview of all elements and attributes and to see the defaults, as well as some comments. Note that Hibernate will not load the DTD file from the web, but first look it up from the classpath of the application. The DTD file is included in <literal>hibernate3.jar</literal> as well as in the <literal>src/</literal> directory of the Hibernate distribution." +#. Tag: para +#: tutorial.xml:132 +#, no-c-format +msgid "" +"Note that the Hibernate DTD is very sophisticated. You can use it for auto-" +"completion of XML mapping elements and attributes in your editor or IDE. You " +"also should open up the DTD file in your text editor - it's the easiest way " +"to get an overview of all elements and attributes and to see the defaults, " +"as well as some comments. Note that Hibernate will not load the DTD file " +"from the web, but first look it up from the classpath of the application. " +"The DTD file is included in <literal>hibernate3.jar</literal> as well as in " +"the <literal>src/</literal> directory of the Hibernate distribution." msgstr "" +"Note que o Hibernate DTD é muito sofisticado. Você pode usar isso para auto-" +"conclusão no mapeamento XML dos elementos e atributos no seu editor ou IDE. " +"Você também pode abrir o arquivo DTD no seu editor – é a maneira mais fácil " +"de ter uma visão geral de todos os elementos e atributos e dos padrões, como " +"também alguns comentários. Note que o Hibernate não irá carregar o arquivo " +"DTD da web, e sim do diretório da aplicação (classpath). O arquivo DTD está " +"incluído no <literal>hibernate3.jar</literal> como também no diretório " +"<literal>src/</literal> da distribuição do Hibernate." -#: index.docbook:143 -msgid "We will omit the DTD declaration in future examples to shorten the code. It is of course not optional." +#. Tag: para +#: tutorial.xml:143 +#, no-c-format +msgid "" +"We will omit the DTD declaration in future examples to shorten the code. It " +"is of course not optional." msgstr "" +"Nós omitiremos a declaração do DTD nos exemplos futuros para encurtar o " +"código. Isto, é claro, não é opcional." -#: index.docbook:148 -msgid "Between the two <literal>hibernate-mapping</literal> tags, include a <literal>class</literal> element. All persistent entity classes (again, there might be dependent classes later on, which are not first-class entities) need such a mapping, to a table in the SQL database:" +#. Tag: para +#: tutorial.xml:148 +#, no-c-format +msgid "" +"Between the two <literal>hibernate-mapping</literal> tags, include a " +"<literal>class</literal> element. All persistent entity classes (again, " +"there might be dependent classes later on, which are not first-class " +"entities) need such a mapping, to a table in the SQL database:" msgstr "" +"Entre os dois tags <literal>hibernate-mapping</literal>, inclua um elemento " +"<literal>class</literal>. Todas as classes persistentes da entidade " +"(novamente, poderá haver mais tarde, dependências sobre as classes que não " +"são classes-primárias de entidades) necessitam do tal mapeamento, para uma " +"tabela na base de dados SQL" -#: index.docbook:155 +#. Tag: programlisting +#: tutorial.xml:155 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"events.Event\" table=\"EVENTS\">\n" - "\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +"\n" +" <class name=\"events.Event\" table=\"EVENTS\">\n" +"\n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" -#: index.docbook:157 -msgid "So far we told Hibernate how to persist and load object of class <literal>Event</literal> to the table <literal>EVENTS</literal>, each instance represented by a row in that table. Now we continue with a mapping of the unique identifier property to the tables primary key. In addition, as we don't want to care about handling this identifier, we configure Hibernate's identifier generation strategy for a surrogate primary key column:" +#. Tag: para +#: tutorial.xml:157 +#, no-c-format +msgid "" +"So far we told Hibernate how to persist and load object of class " +"<literal>Event</literal> to the table <literal>EVENTS</literal>, each " +"instance represented by a row in that table. Now we continue with a mapping " +"of the unique identifier property to the tables primary key. In addition, as " +"we don't want to care about handling this identifier, we configure " +"Hibernate's identifier generation strategy for a surrogate primary key " +"column:" msgstr "" +"Mais adiante iremos dizer ao Hibernate como fazer para persistir e carregar " +"objetos da classe <literal>Event</literal> da tabela <literal>EVENTS</" +"literal>, cada instancia representada por uma coluna na tabela. Agora, " +"continuaremos com o mapeamento de uma única propriedade identificadora para " +"as chaves primárias da tabela. Além disso, nós não iremos se importar com " +"esta propriedade identificadora, nós iremos configurar uma estratégia de " +"geração de id’s para uma chave primária de uma surrogate key:" -#: index.docbook:165 +#. Tag: programlisting +#: tutorial.xml:165 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"events.Event\" table=\"EVENTS\">\n" - " <id name=\"id\" column=\"EVENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +"\n" +" <class name=\"events.Event\" table=\"EVENTS\">\n" +" <id name=\"id\" column=\"EVENT_ID\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" -#: index.docbook:167 -msgid "The <literal>id</literal> element is the declaration of the identifer property, <literal>name=\"id\"</literal> declares the name of the Java property - Hibernate will use the getter and setter methods to access the property. The column attribute tells Hibernate which column of the <literal>EVENTS</literal> table we use for this primary key. The nested <literal>generator</literal> element specifies the identifier generation strategy, in this case we used <literal>native</literal>, which picks the best strategy depending on the configured database (dialect). Hibernate supports database generated, globally unique, as well as application assigned identifiers (or any strategy you have written an extension for)." +#. Tag: para +#: tutorial.xml:167 +#, no-c-format +msgid "" +"The <literal>id</literal> element is the declaration of the identifer " +"property, <literal>name=\"id\"</literal> declares the name of the Java " +"property - Hibernate will use the getter and setter methods to access the " +"property. The column attribute tells Hibernate which column of the " +"<literal>EVENTS</literal> table we use for this primary key. The nested " +"<literal>generator</literal> element specifies the identifier generation " +"strategy, in this case we used <literal>native</literal>, which picks the " +"best strategy depending on the configured database (dialect). Hibernate " +"supports database generated, globally unique, as well as application " +"assigned identifiers (or any strategy you have written an extension for)." msgstr "" +"O elemento <literal>id</literal> é a declaração da propriedade " +"identificadora, o <literal>name=\"id\"</literal> declara o nome da " +"propriedade Java – o Hibernate irá usar os métodos getter e setter para " +"acessar a propriedade. O atributo da coluna informa ao Hibernate qual coluna " +"da tabela <literal>EVENTS</literal> nós iremos usar como chave primária. O " +"elemento <literal>generator</literal> especifica a estratégia de geração do " +"identificador, neste caso usaremos <literal>native</literal>, que escolhe a " +"melhor estratégia dependendo da base de dados (dialeto) configurada. O " +"Hibernate suporta a base de dados gerada, globalmente única, bem como a " +"atribuição aos identificadores da aplicação (ou toda estratégia escrita para " +"uma extensão)." -#: index.docbook:180 -msgid "Finally we include declarations for the persistent properties of the class in the mapping file. By default, no properties of the class are considered persistent:" +#. Tag: para +#: tutorial.xml:180 +#, no-c-format +msgid "" +"Finally we include declarations for the persistent properties of the class " +"in the mapping file. By default, no properties of the class are considered " +"persistent:" msgstr "" +"Finalmente incluiremos as declarações para as propriedades persistentes da " +"classe no arquivo mapeado. Por default, nenhuma das propriedades da classe é " +"considerada persistente:" -#: index.docbook:186 +#. Tag: programlisting +#: tutorial.xml:186 +#, no-c-format msgid "" - "<![CDATA[\n" - "<hibernate-mapping>\n" - "\n" - " <class name=\"events.Event\" table=\"EVENTS\">\n" - " <id name=\"id\" column=\"EVENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"date\" type=\"timestamp\" column=\"EVENT_DATE\"/>\n" - " <property name=\"title\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[\n" +"<hibernate-mapping>\n" +"\n" +" <class name=\"events.Event\" table=\"EVENTS\">\n" +" <id name=\"id\" column=\"EVENT_ID\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <property name=\"date\" type=\"timestamp\" column=\"EVENT_DATE\"/>\n" +" <property name=\"title\"/>\n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" -#: index.docbook:188 -msgid "Just as with the <literal>id</literal> element, the <literal>name</literal> attribute of the <literal>property</literal> element tells Hibernate which getter and setter methods to use. So, in this case, Hibernate will look for <literal>getDate()/setDate()</literal>, as well as <literal>getTitle()/setTitle()</literal>." +#. Tag: para +#: tutorial.xml:188 +#, no-c-format +msgid "" +"Just as with the <literal>id</literal> element, the <literal>name</literal> " +"attribute of the <literal>property</literal> element tells Hibernate which " +"getter and setter methods to use. So, in this case, Hibernate will look for " +"<literal>getDate()/setDate()</literal>, as well as <literal>getTitle()/" +"setTitle()</literal>." msgstr "" +"Da mesma maneira que com o elemento <literal>id</literal>, o atributo " +"<literal>name</literal> do elemento <literal>property</literal> informa ao " +"Hibernate qual método getter e setter deverá usar. Assim, neste caso, o " +"Hibernate irá procurar pelo <literal>getDate()/setDate()</literal>, como " +"também pelo <literal>getTitle()/setTitle()</literal>." -#: index.docbook:195 -msgid "Why does the <literal>date</literal> property mapping include the <literal>column</literal> attribute, but the <literal>title</literal> doesn't? Without the <literal>column</literal> attribute Hibernate by default uses the property name as the column name. This works fine for <literal>title</literal>. However, <literal>date</literal> is a reserved keyword in most database, so we better map it to a different name." +#. Tag: para +#: tutorial.xml:195 +#, no-c-format +msgid "" +"Why does the <literal>date</literal> property mapping include the " +"<literal>column</literal> attribute, but the <literal>title</literal> " +"doesn't? Without the <literal>column</literal> attribute Hibernate by " +"default uses the property name as the column name. This works fine for " +"<literal>title</literal>. However, <literal>date</literal> is a reserved " +"keyword in most database, so we better map it to a different name." msgstr "" +"Porque fazer o mapeamento da propriedade <literal>date</literal> incluído no " +"atributo <literal>column</literal>, e no title não fazer? Sem o atributo " +"<literal>column</literal> o Hibernate por padrão usa o nome da propriedade " +"como o nome da coluna. Isto trabalha muito bem para o <literal>title</" +"literal>. Entretanto o <literal>date</literal> é uma palavra-chave reservada " +"na maioria dos bancos de dados, assim nós melhoramos o mapeamentos disto com " +"um nome diferente." -#: index.docbook:204 -msgid "The next interesting thing is that the <literal>title</literal> mapping also lacks a <literal>type</literal> attribute. The types we declare and use in the mapping files are not, as you might expect, Java data types. They are also not SQL database types. These types are so called <emphasis>Hibernate mapping types</emphasis>, converters which can translate from Java to SQL data types and vice versa. Again, Hibernate will try to determine the correct conversion and mapping type itself if the <literal>type</literal> attribute is not present in the mapping. In some cases this automatic detection (using Reflection on the Java class) might not have the default you expect or need. This is the case with the <literal>date</literal> property. Hibernate can't know if the property (which is of <literal>java.util.Date</literal>) should map to a SQL <literal>date</literal>, <literal>timestamp</literal>, or <literal>time</literal> column. We preserve full date and time information ! by mapping the property with a <literal>timestamp</literal> converter." +#. Tag: para +#: tutorial.xml:204 +#, no-c-format +msgid "" +"The next interesting thing is that the <literal>title</literal> mapping also " +"lacks a <literal>type</literal> attribute. The types we declare and use in " +"the mapping files are not, as you might expect, Java data types. They are " +"also not SQL database types. These types are so called <emphasis>Hibernate " +"mapping types</emphasis>, converters which can translate from Java to SQL " +"data types and vice versa. Again, Hibernate will try to determine the " +"correct conversion and mapping type itself if the <literal>type</literal> " +"attribute is not present in the mapping. In some cases this automatic " +"detection (using Reflection on the Java class) might not have the default " +"you expect or need. This is the case with the <literal>date</literal> " +"property. Hibernate can't know if the property (which is of <literal>java." +"util.Date</literal>) should map to a SQL <literal>date</literal>, " +"<literal>timestamp</literal>, or <literal>time</literal> column. We preserve " +"full date and time information by mapping the property with a " +"<literal>timestamp</literal> converter." msgstr "" +"A próxima coisa interessante é que mapemanto do <literal>title</literal> " +"também falta o atributo <literal>type</literal>. O tipo que declaramos e o " +"uso nos arquivos mapeados, não são como você pôde esperar, atributos de " +"dados Java. Eles não são como os tipos de base de dados SQL. Esses tipos " +"podem ser chamados de <emphasis>Tipos de mapeamento Hibernate</emphasis>, " +"que são conversores que podem traduzir tipos de dados do Java para os tipos " +"de dados SQL e vice-versa. Novamente, o Hibernate irá tentar determinar a " +"conversão correta e mapeará o <literal>type</literal> próprio, caso o tipo " +"do atributo não estiver presente no mapeamento. Em alguns casos, esta " +"detecção automática (que usa Reflection sobre as classes Java) poderá não " +"ter padrão que você espera ou necessita. Este é o caso com a propriedade " +"<literal>date</literal>. O Hibernate não pode saber se a propriedade (que é " +"do <literal>java.util.Date</literal>) pode mapear para uma coluna do tipo " +"<literal>date</literal> do SQL, <literal>timestamp</literal>, ou " +"<literal>time</literal> . Nós preservamos a informação cheia de datas e " +"horas pelo mapeamento da propriedade com um conversor <literal>timestamp</" +"literal>." -#: index.docbook:220 -msgid "This mapping file should be saved as <literal>Event.hbm.xml</literal>, right in the directory next to the <literal>Event</literal> Java class source file. The naming of mapping files can be arbitrary, however the <literal>hbm.xml</literal> suffix is a convention in the Hibernate developer community. The directory structure should now look like this:" +#. Tag: para +#: tutorial.xml:220 +#, no-c-format +msgid "" +"This mapping file should be saved as <literal>Event.hbm.xml</literal>, right " +"in the directory next to the <literal>Event</literal> Java class source " +"file. The naming of mapping files can be arbitrary, however the <literal>hbm." +"xml</literal> suffix is a convention in the Hibernate developer community. " +"The directory structure should now look like this:" msgstr "" +"Este arquivo de mapeamento deve ser salvo como <literal>Event.hbm.xml</" +"literal>, corretamente no diretório próximo ao arquivo fonte da Classe Java " +"<literal>Event</literal>. O nomeamento dos arquivos de mapeamento podem ser " +"arbitrários, porém o sufixo <literal>hbm.xml</literal> é uma convenção da " +"comunidade dos desenvolvedores do Hibernate. Esta estrutura do diretório " +"deve agora se parecer com isso:" -#: index.docbook:228 +#. Tag: programlisting +#: tutorial.xml:228 +#, no-c-format msgid "" - "<![CDATA[.\n" - "+lib\n" - " <Hibernate and third-party libraries>\n" - "+src\n" - " +events\n" - " Event.java\n" - " Event.hbm.xml]]>" +"<![CDATA[.\n" +"+lib\n" +" <Hibernate and third-party libraries>\n" +"+src\n" +" +events\n" +" Event.java\n" +" Event.hbm.xml]]>" msgstr "" -#: index.docbook:230 +#. Tag: para +#: tutorial.xml:230 +#, no-c-format msgid "We continue with the main configuration of Hibernate." -msgstr "" +msgstr "Nós iremos continuar com a configuração principal do Hibernate." -#: index.docbook:237 +#. Tag: title +#: tutorial.xml:237 +#, no-c-format msgid "Hibernate configuration" -msgstr "" +msgstr "Configuração do Hibernate" -#: index.docbook:239 -msgid "We now have a persistent class and its mapping file in place. It is time to configure Hibernate. Before we do this, we will need a database. HSQL DB, a java-based SQL DBMS, can be downloaded from the HSQL DB website(http://hsqldb.org/). Actually, you only need the <literal>hsqldb.jar</literal> from this download. Place this file in the <literal>lib/</literal> directory of the development folder." +#. Tag: para +#: tutorial.xml:239 +#, no-c-format +msgid "" +"We now have a persistent class and its mapping file in place. It is time to " +"configure Hibernate. Before we do this, we will need a database. HSQL DB, a " +"java-based SQL DBMS, can be downloaded from the HSQL DB website(http://" +"hsqldb.org/). Actually, you only need the <literal>hsqldb.jar</literal> from " +"this download. Place this file in the <literal>lib/</literal> directory of " +"the development folder." msgstr "" +"Agora nós temos uma classe persistente e este arquivo de mapeamento no " +"lugar. Está na hora de configurar o Hibernate. Antes de fazermos isso, " +"iremos precisar de uma base de dados. O HSQL DB, um SQL DBMS feito em java, " +"pode ser baixado através do site do HSQL DB(http://hsqldb.org/). Atualmente, " +"você só precisa baixar o <literal>hsqldb.jar</literal>. Coloque este arquivo " +"no diretório da pasta de desenvolvimento <literal>lib/</literal>." -#: index.docbook:247 -msgid "Create a directory called <literal>data</literal> in the root of the development directory - this is where HSQL DB will store its data files. Now start the database by running <literal>java -classpath ../lib/hsqldb.jar org.hsqldb.Server</literal> in this data directory. You can see it start up and bind to a TCP/IP socket, this is where our application will connect later. If you want to start with a fresh database during this tutorial, shutdown HSQL DB (press <literal>CTRL + C</literal> in the window), delete all files in the <literal>data/</literal> directory, and start HSQL DB again." +#. Tag: para +#: tutorial.xml:247 +#, no-c-format +msgid "" +"Create a directory called <literal>data</literal> in the root of the " +"development directory - this is where HSQL DB will store its data files. Now " +"start the database by running <literal>java -classpath ../lib/hsqldb.jar org." +"hsqldb.Server</literal> in this data directory. You can see it start up and " +"bind to a TCP/IP socket, this is where our application will connect later. " +"If you want to start with a fresh database during this tutorial, shutdown " +"HSQL DB (press <literal>CTRL + C</literal> in the window), delete all files " +"in the <literal>data/</literal> directory, and start HSQL DB again." msgstr "" +"Crie um diretório chamado <literal>data</literal> no diretório root de " +"desenvolvimento – Isto será onde o HSQL DB irá armazenar arquivos de dados. " +"Agora iremos iniciar o banco de dados executando <literal>java -classpath ../" +"lib/hsqldb.jar org.hsqldb.Server</literal> neste diretório de dados. Você " +"pode ver ele iniciando e conectando ao socket TCP/IP, isto será onde nossa " +"aplicação irá se conectar depois. Se você deseja iniciar uma nova base de " +"dados durante este tutorial, finalize o HSQL DB(pressionando o <literal>CTRL " +"+ C</literal> na janela), delete todos os arquivos no diretório " +"<literal>data/</literal>, e inicie o HSQL BD novamente." -#: index.docbook:257 -msgid "Hibernate is the layer in your application which connects to this database, so it needs connection information. The connections are made through a JDBC connection pool, which we also have to configure. The Hibernate distribution contains several open source JDBC connection pooling tools, but will use the Hibernate built-in connection pool for this tutorial. Note that you have to copy the required library into your classpath and use different connection pooling settings if you want to use a production-quality third party JDBC pooling software." +#. Tag: para +#: tutorial.xml:257 +#, no-c-format +msgid "" +"Hibernate is the layer in your application which connects to this database, " +"so it needs connection information. The connections are made through a JDBC " +"connection pool, which we also have to configure. The Hibernate distribution " +"contains several open source JDBC connection pooling tools, but will use the " +"Hibernate built-in connection pool for this tutorial. Note that you have to " +"copy the required library into your classpath and use different connection " +"pooling settings if you want to use a production-quality third party JDBC " +"pooling software." msgstr "" +"O Hibernate é uma camada na sua aplicação na qual se conecta com a base de " +"dados, para isso necessita de informação da conexão. As conexões são feitas " +"através de um pool de conexão JDBC, na qual teremos que configurar. A " +"distribuição do Hibernate contém diversas ferramentas de pooling da conexão " +"JDBC de fonte aberta, mas iremos usar o pool de conexão interna para este " +"tutorial. Note que você tem que copiar a biblioteca necessária em seu " +"classpath e use configurações diferentes para pooling de conexão caso você " +"deseje utilizar um software de pooling JDBC terceirizado para qualidade de " +"produção." -#: index.docbook:267 -msgid "For Hibernate's configuration, we can use a simple <literal>hibernate.properties</literal> file, a slightly more sophisticated <literal>hibernate.cfg.xml</literal> file, or even complete programmatic setup. Most users prefer the XML configuration file:" +#. Tag: para +#: tutorial.xml:267 +#, no-c-format +msgid "" +"For Hibernate's configuration, we can use a simple <literal>hibernate." +"properties</literal> file, a slightly more sophisticated <literal>hibernate." +"cfg.xml</literal> file, or even complete programmatic setup. Most users " +"prefer the XML configuration file:" msgstr "" +"Para as configurações do Hibernate, nós podemos usar um arquivo simples " +"<literal>hibernate.properties</literal>, um arquivo mais ligeiramente " +"sofisticado <literal>hibernate.cfg.xml</literal> ou até mesmo uma instalação " +"programática completa. A maioria dos usuários preferem utilizar o arquivo de " +"configuração XML" -#: index.docbook:273 +#. Tag: programlisting +#: tutorial.xml:273 +#, no-c-format msgid "" - "<![CDATA[<?xml version='1.0' encoding='utf-8'?>\n" - "<!DOCTYPE hibernate-configuration PUBLIC\n" - " \"-//Hibernate/Hibernate Configuration DTD 3.0//EN\"\n" - " \"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd\">\n" - "\n" - "<hibernate-configuration>\n" - "\n" - " <session-factory>\n" - "\n" - " \n" - " <property name=\"connection.driver_class\">org.hsqldb.jdbcDriver</property>\n" - " <property name=\"connection.url\">jdbc:hsqldb:hsql://localhost</property>\n" - " <property name=\"connection.username\">sa</property>\n" - " <property name=\"connection.password\"></property>\n" - "\n" - " \n" - " <property name=\"connection.pool_size\">1</property>\n" - "\n" - " \n" - " <property name=\"dialect\">org.hibernate.dialect.HSQLDialect</property>\n" - "\n" - " \n" - " <property name=\"current_session_context_class\">thread</property>\n" - "\n" - " \n" - " <property name=\"cache.provider_class\">org.hibernate.cache.NoCacheProvider</property>\n" - "\n" - " \n" - " <property name=\"show_sql\">true</property>\n" - "\n" - " \n" - " <property name=\"hbm2ddl.auto\">create</property>\n" - "\n" - " <mapping resource=\"events/Event.hbm.xml\"/>\n" - "\n" - " </session-factory>\n" - "\n" - "</hibernate-configuration>]]>" +"<![CDATA[<?xml version='1.0' encoding='utf-8'?>\n" +"<!DOCTYPE hibernate-configuration PUBLIC\n" +" \"-//Hibernate/Hibernate Configuration DTD 3.0//EN\"\n" +" \"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd" +"\">\n" +"\n" +"<hibernate-configuration>\n" +"\n" +" <session-factory>\n" +"\n" +" \n" +" <property name=\"connection.driver_class\">org.hsqldb.jdbcDriver</" +"property>\n" +" <property name=\"connection.url\">jdbc:hsqldb:hsql://localhost</" +"property>\n" +" <property name=\"connection.username\">sa</property>\n" +" <property name=\"connection.password\"></property>\n" +"\n" +" \n" +" <property name=\"connection.pool_size\">1</property>\n" +"\n" +" \n" +" <property name=\"dialect\">org.hibernate.dialect.HSQLDialect</" +"property>\n" +"\n" +" \n" +" <property name=\"current_session_context_class\">thread</property>\n" +"\n" +" \n" +" <property name=\"cache.provider_class\">org.hibernate.cache." +"NoCacheProvider</property>\n" +"\n" +" \n" +" <property name=\"show_sql\">true</property>\n" +"\n" +" \n" +" <property name=\"hbm2ddl.auto\">create</property>\n" +"\n" +" <mapping resource=\"events/Event.hbm.xml\"/>\n" +"\n" +" </session-factory>\n" +"\n" +"</hibernate-configuration>]]>" msgstr "" -#: index.docbook:275 -msgid "Note that this XML configuration uses a different DTD. We configure Hibernate's <literal>SessionFactory</literal> - a global factory responsible for a particular database. If you have several databases, use several <literal><session-factory></literal> configurations, usually in several configuration files (for easier startup)." +#. Tag: para +#: tutorial.xml:275 +#, no-c-format +msgid "" +"Note that this XML configuration uses a different DTD. We configure " +"Hibernate's <literal>SessionFactory</literal> - a global factory responsible " +"for a particular database. If you have several databases, use several " +"<literal><session-factory></literal> configurations, usually in " +"several configuration files (for easier startup)." msgstr "" +"Note que esta configuração XML usa um diferente DTD. Nós configuraremos as " +"<literal>SessionFactory</literal> do Hibernate – uma factory global " +"responsável por uma base de dedados particular. Se você tiver diversas bases " +"de dados, use diversas configurações <literal><session-factory></" +"literal>, geralmente em diversos arquivos de configuração (para uma partida " +"mais fácil)." -#: index.docbook:283 -msgid "The first four <literal>property</literal> elements contain the necessary configuration for the JDBC connection. The dialect <literal>property</literal> element specifies the particular SQL variant Hibernate generates. Hibernate's automatic session management for persistence contexts will come in handy as you will soon see. The <literal>hbm2ddl.auto</literal> option turns on automatic generation of database schemas - directly into the database. This can of course also be turned off (by removing the config option) or redirected to a file with the help of the <literal>SchemaExport</literal> Ant task. Finally, we add the mapping file(s) for persistent classes to the configuration." +#. Tag: para +#: tutorial.xml:283 +#, no-c-format +msgid "" +"The first four <literal>property</literal> elements contain the necessary " +"configuration for the JDBC connection. The dialect <literal>property</" +"literal> element specifies the particular SQL variant Hibernate generates. " +"Hibernate's automatic session management for persistence contexts will come " +"in handy as you will soon see. The <literal>hbm2ddl.auto</literal> option " +"turns on automatic generation of database schemas - directly into the " +"database. This can of course also be turned off (by removing the config " +"option) or redirected to a file with the help of the <literal>SchemaExport</" +"literal> Ant task. Finally, we add the mapping file(s) for persistent " +"classes to the configuration." msgstr "" +"As primeiras quatro <literal>propriedades</literal> do elemento contém a " +"configuração necessária para a conexão ao JDBC. A propriedade " +"<literal>propriedade</literal> dialect do elemento especifica a variante " +"particular do SQL que o Hibernate gera. O gerenciamento automático de sessão " +"do Hibernate para contextos de persistência estará disponível em breve. A " +"opção <literal>hbm2ddl.auto</literal> habilita a geração automática de " +"schemas da base de dados – diretamente na base de dados. Isto também pode " +"ser naturalmente desligado (removendo a opção de configuração) ou " +"redirecionando para um arquivo com ajuda do <literal>SchemaExport</literal> " +"nas tarefas do Ant. Finalmente, iremos adicionar os arquivos das classes de " +"persistência mapeadas na configuração." -#: index.docbook:296 -msgid "Copy this file into the source directory, so it will end up in the root of the classpath. Hibernate automatically looks for a file called <literal>hibernate.cfg.xml</literal> in the root of the classpath, on startup." +#. Tag: para +#: tutorial.xml:296 +#, no-c-format +msgid "" +"Copy this file into the source directory, so it will end up in the root of " +"the classpath. Hibernate automatically looks for a file called " +"<literal>hibernate.cfg.xml</literal> in the root of the classpath, on " +"startup." msgstr "" +"Copie este arquivo no diretório fonte, assim isto irá terminar na raiz " +"(root) do classpath. O Hibernate automaticamente procura por um arquivo " +"chamado <literal>hibernate.cfg.xml</literal> na raiz do classpath, no " +"startup." -#: index.docbook:305 +#. Tag: title +#: tutorial.xml:305 +#, no-c-format msgid "Building with Ant" -msgstr "" +msgstr "Construindo com o Ant" -#: index.docbook:307 -msgid "We'll now build the tutorial with Ant. You will need to have Ant installed - get it from the <ulink url=\"http://ant.apache.org/bindownload.cgi\">Ant download page</ulink>. How to install Ant will not be covered here. Please refer to the <ulink url=\"http://ant.apache.org/manual/index.html\">Ant manual</ulink>. After you have installed Ant, we can start to create the buildfile. It will be called <literal>build.xml</literal> and placed directly in the development directory." +#. Tag: para +#: tutorial.xml:307 +#, no-c-format +msgid "" +"We'll now build the tutorial with Ant. You will need to have Ant installed - " +"get it from the <ulink url=\"http://ant.apache.org/bindownload.cgi\">Ant " +"download page</ulink>. How to install Ant will not be covered here. Please " +"refer to the <ulink url=\"http://ant.apache.org/manual/index.html\">Ant " +"manual</ulink>. After you have installed Ant, we can start to create the " +"buildfile. It will be called <literal>build.xml</literal> and placed " +"directly in the development directory." msgstr "" +"Nos iremos, agora, construir o tutorial com Ant. Você ira precisar o Ant " +"instalado – se encontra disponível <ulink url=\"http://ant.apache.org/" +"bindownload.cgi\">na página de download do Ant</ulink>. Como instalar o Ant, " +"não será abordado aqui. Caso tenha alguma dúvida, por favor, vá ao <ulink " +"url=\"http://ant.apache.org/manual/index.html\">Ant manual</ulink>. Depois " +"que tiver instalado o Ant, podemos começar a criar o arquivo de construção " +"<literal>build.xml</literal>. Este arquivo será chamado de <literal>build." +"xml</literal> e posto diretamente no diretório de desenvolvimento." -#: index.docbook:316 +#. Tag: para +#: tutorial.xml:316 +#, no-c-format msgid "A basic build file looks like this:" -msgstr "" +msgstr "Um arquivo básico de build, se parece com isto:" -#: index.docbook:320 +#. Tag: programlisting +#: tutorial.xml:320 +#, no-c-format msgid "" - "<![CDATA[<project name=\"hibernate-tutorial\" default=\"compile\">\n" - "\n" - " <property name=\"sourcedir\" value=\"${basedir}/src\"/>\n" - " <property name=\"targetdir\" value=\"${basedir}/bin\"/>\n" - " <property name=\"librarydir\" value=\"${basedir}/lib\"/>\n" - "\n" - " <path id=\"libraries\">\n" - " <fileset dir=\"${librarydir}\">\n" - " <include name=\"*.jar\"/>\n" - " </fileset>\n" - " </path>\n" - "\n" - " <target name=\"clean\">\n" - " <delete dir=\"${targetdir}\"/>\n" - " <mkdir dir=\"${targetdir}\"/>\n" - " </target>\n" - "\n" - " <target name=\"compile\" depends=\"clean, copy-resources\">\n" - " <javac srcdir=\"${sourcedir}\"\n" - " destdir=\"${targetdir}\"\n" - " classpathref=\"libraries\"/>\n" - " </target>\n" - "\n" - " <target name=\"copy-resources\">\n" - " <copy todir=\"${targetdir}\">\n" - " <fileset dir=\"${sourcedir}\">\n" - " <exclude name=\"**/*.java\"/>\n" - " </fileset>\n" - " </copy>\n" - " </target>\n" - "\n" - "</project>]]>" +"<![CDATA[<project name=\"hibernate-tutorial\" default=\"compile\">\n" +"\n" +" <property name=\"sourcedir\" value=\"${basedir}/src\"/>\n" +" <property name=\"targetdir\" value=\"${basedir}/bin\"/>\n" +" <property name=\"librarydir\" value=\"${basedir}/lib\"/>\n" +"\n" +" <path id=\"libraries\">\n" +" <fileset dir=\"${librarydir}\">\n" +" <include name=\"*.jar\"/>\n" +" </fileset>\n" +" </path>\n" +"\n" +" <target name=\"clean\">\n" +" <delete dir=\"${targetdir}\"/>\n" +" <mkdir dir=\"${targetdir}\"/>\n" +" </target>\n" +"\n" +" <target name=\"compile\" depends=\"clean, copy-resources\">\n" +" <javac srcdir=\"${sourcedir}\"\n" +" destdir=\"${targetdir}\"\n" +" classpathref=\"libraries\"/>\n" +" </target>\n" +"\n" +" <target name=\"copy-resources\">\n" +" <copy todir=\"${targetdir}\">\n" +" <fileset dir=\"${sourcedir}\">\n" +" <exclude name=\"**/*.java\"/>\n" +" </fileset>\n" +" </copy>\n" +" </target>\n" +"\n" +"</project>]]>" msgstr "" -#: index.docbook:322 -msgid "This will tell Ant to add all files in the lib directory ending with <literal>.jar</literal> to the classpath used for compilation. It will also copy all non-Java source files to the target directory, e.g. configuration and Hibernate mapping files. If you now run Ant, you should get this output:" +#. Tag: para +#: tutorial.xml:322 +#, no-c-format +msgid "" +"This will tell Ant to add all files in the lib directory ending with " +"<literal>.jar</literal> to the classpath used for compilation. It will also " +"copy all non-Java source files to the target directory, e.g. configuration " +"and Hibernate mapping files. If you now run Ant, you should get this output:" msgstr "" +"Isto irá avisar ao Ant para adicionar todos os arquivos no diretório lib " +"terminando com <literal>.jar</literal>, para o classpath usado para " +"compilação. Irá também copiar todos os arquivos não-java para o diretório " +"alvo (arquivos de configuração, mapeamento). Se você rodar o ant agora, " +"deverá ter esta saída." -#: index.docbook:329 +#. Tag: programlisting +#: tutorial.xml:329 +#, no-c-format msgid "" - "<![CDATA[C:\\hibernateTutorial\\>ant\n" - "Buildfile: build.xml\n" - "\n" - "copy-resources:\n" - " [copy] Copying 2 files to C:\\hibernateTutorial\\bin\n" - "\n" - "compile:\n" - " [javac] Compiling 1 source file to C:\\hibernateTutorial\\bin\n" - "\n" - "BUILD SUCCESSFUL\n" - "Total time: 1 second ]]>" +"<![CDATA[C:\\hibernateTutorial\\>ant\n" +"Buildfile: build.xml\n" +"\n" +"copy-resources:\n" +" [copy] Copying 2 files to C:\\hibernateTutorial\\bin\n" +"\n" +"compile:\n" +" [javac] Compiling 1 source file to C:\\hibernateTutorial\\bin\n" +"\n" +"BUILD SUCCESSFUL\n" +"Total time: 1 second ]]>" msgstr "" -#: index.docbook:334 +#. Tag: title +#: tutorial.xml:334 +#, no-c-format msgid "Startup and helpers" -msgstr "" +msgstr "Startup and helpers" -#: index.docbook:336 -msgid "It's time to load and store some <literal>Event</literal> objects, but first we have to complete the setup with some infrastructure code. We have to startup Hibernate. This startup includes building a global <literal>SessionFactory</literal> object and to store it somewhere for easy access in application code. A <literal>SessionFactory</literal> can open up new <literal>Session</literal>'s. A <literal>Session</literal> represents a single-threaded unit of work, the <literal>SessionFactory</literal> is a thread-safe global object, instantiated once." +#. Tag: para +#: tutorial.xml:336 +#, no-c-format +msgid "" +"It's time to load and store some <literal>Event</literal> objects, but first " +"we have to complete the setup with some infrastructure code. We have to " +"startup Hibernate. This startup includes building a global " +"<literal>SessionFactory</literal> object and to store it somewhere for easy " +"access in application code. A <literal>SessionFactory</literal> can open up " +"new <literal>Session</literal>'s. A <literal>Session</literal> represents a " +"single-threaded unit of work, the <literal>SessionFactory</literal> is a " +"thread-safe global object, instantiated once." msgstr "" +"É hora de carregar e arquivar alguns objetos <literal>Event</literal>, mas " +"primeiro nós temos de completar o setup com algum código de infraestrutura. " +"Este startup inclui a construção de um objeto <literal>SessionFactory</" +"literal> global e armazenar isto em algum lugar de fácil acesso para o " +"código da aplicação. Uma <literal>SessionFactory</literal> pode abrir novas " +"<literal>Session</literal>'s. Uma <literal>Session</literal> representa uma " +"unidade single-theaded do trabalho, a <literal>SessionFactory</literal> é um " +"objeto global thread-safe, instanciado uma vez." -#: index.docbook:346 -msgid "We'll create a <literal>HibernateUtil</literal> helper class which takes care of startup and makes accessing a <literal>SessionFactory</literal> convenient. Let's have a look at the implementation:" +#. Tag: para +#: tutorial.xml:346 +#, no-c-format +msgid "" +"We'll create a <literal>HibernateUtil</literal> helper class which takes " +"care of startup and makes accessing a <literal>SessionFactory</literal> " +"convenient. Let's have a look at the implementation:" msgstr "" +"Nos iremos criar uma classe de ajuda <literal>HibernateUtil</literal>, que " +"toma conta do startup e faz acesso a uma <literal>SessionFactory</literal> " +"conveniente. Vamos dar uma olhada na implementação:" -#: index.docbook:352 +#. Tag: programlisting +#: tutorial.xml:352 +#, no-c-format msgid "" - "<![CDATA[package util;\n" - "\n" - "import org.hibernate.*;\n" - "import org.hibernate.cfg.*;\n" - "\n" - "public class HibernateUtil {\n" - "\n" - " private static final SessionFactory sessionFactory;\n" - "\n" - " static {\n" - " try {\n" - " // Create the SessionFactory from hibernate.cfg.xml\n" - " sessionFactory = new Configuration().configure().buildSessionFactory();\n" - " } catch (Throwable ex) {\n" - " // Make sure you log the exception, as it might be swallowed\n" - " System.err.println(\"Initial SessionFactory creation failed.\" + ex);\n" - " throw new ExceptionInInitializerError(ex);\n" - " }\n" - " }\n" - "\n" - " public static SessionFactory getSessionFactory() {\n" - " return sessionFactory;\n" - " }\n" - "\n" - "}]]>" +"<![CDATA[package util;\n" +"\n" +"import org.hibernate.*;\n" +"import org.hibernate.cfg.*;\n" +"\n" +"public class HibernateUtil {\n" +"\n" +" private static final SessionFactory sessionFactory;\n" +"\n" +" static {\n" +" try {\n" +" // Create the SessionFactory from hibernate.cfg.xml\n" +" sessionFactory = new Configuration().configure()." +"buildSessionFactory();\n" +" } catch (Throwable ex) {\n" +" // Make sure you log the exception, as it might be swallowed\n" +" System.err.println(\"Initial SessionFactory creation failed.\" + " +"ex);\n" +" throw new ExceptionInInitializerError(ex);\n" +" }\n" +" }\n" +"\n" +" public static SessionFactory getSessionFactory() {\n" +" return sessionFactory;\n" +" }\n" +"\n" +"}]]>" msgstr "" -#: index.docbook:354 -msgid "This class does not only produce the global <literal>SessionFactory</literal> in its static initializer (called once by the JVM when the class is loaded), but also hides the fact that it uses a static singleton. It might as well lookup the <literal>SessionFactory</literal> from JNDI in an application server." +#. Tag: para +#: tutorial.xml:354 +#, no-c-format +msgid "" +"This class does not only produce the global <literal>SessionFactory</" +"literal> in its static initializer (called once by the JVM when the class is " +"loaded), but also hides the fact that it uses a static singleton. It might " +"as well lookup the <literal>SessionFactory</literal> from JNDI in an " +"application server." msgstr "" +"Esta classe não só produz a global <literal>SessionFactory</literal> no seu " +"static initializer (chamado uma vez pela JVM quando a classe é carregada), " +"mas também esconde o fato de que isto usa um static singleton. Ela pode " +"muito bem, enxergar a <literal>SessionFactory</literal> do JNDI em um " +"application server." -#: index.docbook:361 -msgid "If you give the <literal>SessionFactory</literal> a name in your configuration file, Hibernate will in fact try to bind it to JNDI after it has been built. To avoid this code completely you could also use JMX deployment and let the JMX-capable container instantiate and bind a <literal>HibernateService</literal> to JNDI. These advanced options are discussed in the Hibernate reference documentation." +#. Tag: para +#: tutorial.xml:361 +#, no-c-format +msgid "" +"If you give the <literal>SessionFactory</literal> a name in your " +"configuration file, Hibernate will in fact try to bind it to JNDI after it " +"has been built. To avoid this code completely you could also use JMX " +"deployment and let the JMX-capable container instantiate and bind a " +"<literal>HibernateService</literal> to JNDI. These advanced options are " +"discussed in the Hibernate reference documentation." msgstr "" +"Se você der à <literal>SessionFactory</literal> um nome, no seu arquivo de " +"configuração. O Hibernate irá, de fato, tentar uni-lo ao JNDI depois que " +"estiver construído. Para evitar este completamente este código, você também " +"poderia usar JMX deployment e deixar o contêiner JMX capaz, instanciar e " +"unir um <literal>HibernateService</literal> no JNDI. Essas opções avançadas " +"são discutidas no documento de referência do Hibernate." -#: index.docbook:370 -msgid "Place <literal>HibernateUtil.java</literal> in the development source directory, in a package next to <literal>events</literal>:" +#. Tag: para +#: tutorial.xml:370 +#, no-c-format +msgid "" +"Place <literal>HibernateUtil.java</literal> in the development source " +"directory, in a package next to <literal>events</literal>:" msgstr "" +"Coloque o <literal>HibernateUtil.java</literal> no diretório de arquivos de " +"desenvolvimento(source), em um pacote após o <literal>events</literal>:" -#: index.docbook:375 +#. Tag: programlisting +#: tutorial.xml:375 +#, no-c-format msgid "" - "<![CDATA[.\n" - "+lib\n" - " <Hibernate and third-party libraries>\n" - "+src\n" - " +events\n" - " Event.java\n" - " Event.hbm.xml\n" - " +util\n" - " HibernateUtil.java\n" - " hibernate.cfg.xml\n" - "+data\n" - "build.xml]]>" +"<![CDATA[.\n" +"+lib\n" +" <Hibernate and third-party libraries>\n" +"+src\n" +" +events\n" +" Event.java\n" +" Event.hbm.xml\n" +" +util\n" +" HibernateUtil.java\n" +" hibernate.cfg.xml\n" +"+data\n" +"build.xml]]>" msgstr "" -#: index.docbook:377 -msgid "This should again compile without problems. We finally need to configure a logging system - Hibernate uses commons logging and leaves you the choice between Log4j and JDK 1.4 logging. Most developers prefer Log4j: copy <literal>log4j.properties</literal> from the Hibernate distribution (it's in the <literal>etc/</literal> directory) to your <literal>src</literal> directory, next to <literal>hibernate.cfg.xml</literal>. Have a look at the example configuration and change the settings if you like to have more verbose output. By default, only Hibernate startup message are shown on stdout." +#. Tag: para +#: tutorial.xml:377 +#, no-c-format +msgid "" +"This should again compile without problems. We finally need to configure a " +"logging system - Hibernate uses commons logging and leaves you the choice " +"between Log4j and JDK 1.4 logging. Most developers prefer Log4j: copy " +"<literal>log4j.properties</literal> from the Hibernate distribution (it's in " +"the <literal>etc/</literal> directory) to your <literal>src</literal> " +"directory, next to <literal>hibernate.cfg.xml</literal>. Have a look at the " +"example configuration and change the settings if you like to have more " +"verbose output. By default, only Hibernate startup message are shown on " +"stdout." msgstr "" +"Novamente, isto deve compilar sem problemas. Finalmente, nós precisamos " +"configurar um sistema de logging – o Hibernate usa commons logging e deixa " +"você escolher entre o Log4j e o logging do JDK 1.4 . A maioria dos " +"desenvolvedores preferem o Log4j: copie <literal>log4j.properties</literal> " +"da distribuição do Hibernate (está no diretório <literal>etc/</literal>), " +"para seu diretório <literal>src</literal>, depois vá em hibernate.cfg.xml. " +"Dê uma olhada no exemplo de configuração e mude as configurações se você " +"quizer ter uma saída mais detalhada. Por default, apenas as mensagems de " +"startup e shwwn do Hibernate é mostrada no stdout." -#: index.docbook:387 -msgid "The tutorial infrastructure is complete - and we are ready to do some real work with Hibernate." +#. Tag: para +#: tutorial.xml:387 +#, no-c-format +msgid "" +"The tutorial infrastructure is complete - and we are ready to do some real " +"work with Hibernate." msgstr "" +"O tutorial de infra-estrutura está completo - e nós já estamos preparados " +"para algum trabalho de verdade com o Hibernate." -#: index.docbook:395 +#. Tag: title +#: tutorial.xml:395 +#, no-c-format msgid "Loading and storing objects" -msgstr "" +msgstr "Carregando e salvando objetos" -#: index.docbook:397 -msgid "Finally, we can use Hibernate to load and store objects. We write an <literal>EventManager</literal> class with a <literal>main()</literal> method:" +#. Tag: para +#: tutorial.xml:397 +#, no-c-format +msgid "" +"Finally, we can use Hibernate to load and store objects. We write an " +"<literal>EventManager</literal> class with a <literal>main()</literal> " +"method:" msgstr "" +"Finalmente, nós podemos usar o Hibernate para carregar e armazenar objetos. " +"Nós escrevemos uma classe <literal>EventManager</literal> com um método main" +"():" -#: index.docbook:402 +#. Tag: programlisting +#: tutorial.xml:402 +#, no-c-format msgid "" - "<![CDATA[package events;\n" - "import org.hibernate.Session;\n" - "\n" - "import java.util.Date;\n" - "\n" - "import util.HibernateUtil;\n" - "\n" - "public class EventManager {\n" - "\n" - " public static void main(String[] args) {\n" - " EventManager mgr = new EventManager();\n" - "\n" - " if (args[0].equals(\"store\")) {\n" - " mgr.createAndStoreEvent(\"My Event\", new Date());\n" - " }\n" - "\n" - " HibernateUtil.getSessionFactory().close();\n" - " }\n" - "\n" - " private void createAndStoreEvent(String title, Date theDate) {\n" - "\n" - " Session session = HibernateUtil.getSessionFactory().getCurrentSession();\n" - "\n" - " session.beginTransaction();\n" - "\n" - " Event theEvent = new Event();\n" - " theEvent.setTitle(title);\n" - " theEvent.setDate(theDate);\n" - "\n" - " session.save(theEvent);\n" - "\n" - " session.getTransaction().commit();\n" - " }\n" - "\n" - "}]]>" +"<![CDATA[package events;\n" +"import org.hibernate.Session;\n" +"\n" +"import java.util.Date;\n" +"\n" +"import util.HibernateUtil;\n" +"\n" +"public class EventManager {\n" +"\n" +" public static void main(String[] args) {\n" +" EventManager mgr = new EventManager();\n" +"\n" +" if (args[0].equals(\"store\")) {\n" +" mgr.createAndStoreEvent(\"My Event\", new Date());\n" +" }\n" +"\n" +" HibernateUtil.getSessionFactory().close();\n" +" }\n" +"\n" +" private void createAndStoreEvent(String title, Date theDate) {\n" +"\n" +" Session session = HibernateUtil.getSessionFactory().getCurrentSession" +"();\n" +"\n" +" session.beginTransaction();\n" +"\n" +" Event theEvent = new Event();\n" +" theEvent.setTitle(title);\n" +" theEvent.setDate(theDate);\n" +"\n" +" session.save(theEvent);\n" +"\n" +" session.getTransaction().commit();\n" +" }\n" +"\n" +"}]]>" msgstr "" -#: index.docbook:404 -msgid "We create a new <literal>Event</literal> object, and hand it over to Hibernate. Hibernate now takes care of the SQL and executes <literal>INSERT</literal>s on the database. Let's have a look at the <literal>Session</literal> and <literal>Transaction</literal>-handling code before we run this." +#. Tag: para +#: tutorial.xml:404 +#, no-c-format +msgid "" +"We create a new <literal>Event</literal> object, and hand it over to " +"Hibernate. Hibernate now takes care of the SQL and executes <literal>INSERT</" +"literal>s on the database. Let's have a look at the <literal>Session</" +"literal> and <literal>Transaction</literal>-handling code before we run this." msgstr "" +"Nós criamos um novo objeto <literal>Event</literal>, e passamos para o " +"Hibernate. O Hibernate sabe como tomar conta do SQL e executa " +"<literal>INSERT</literal>s no banco de dados. Vamos dar uma olhada na " +"<literal>Session</literal> e no código <literal>Transaction</literal>-" +"handling antes de executarmos." -#: index.docbook:411 -msgid "A <literal>Session</literal> is a single unit of work. For now we'll keep things simple and assume a one-to-one granularity between a Hibernate <literal>Session</literal> and a database transaction. To shield our code from the actual underlying transaction system (in this case plain JDBC, but it could also run with JTA) we use the <literal>Transaction</literal> API that is available on the Hibernate <literal>Session</literal>." +#. Tag: para +#: tutorial.xml:411 +#, no-c-format +msgid "" +"A <literal>Session</literal> is a single unit of work. For now we'll keep " +"things simple and assume a one-to-one granularity between a Hibernate " +"<literal>Session</literal> and a database transaction. To shield our code " +"from the actual underlying transaction system (in this case plain JDBC, but " +"it could also run with JTA) we use the <literal>Transaction</literal> API " +"that is available on the Hibernate <literal>Session</literal>." msgstr "" +"Um <literal>Session</literal> é uma unidade simples de trabalho. Por agora " +"nós iremos pegar coisas simples e assumir uma granularidade de um-pra-um " +"entre uma <literal>Session</literal> do Hibernate e uma transação de banco " +"de dados. Para proteger nosso código de um atual sistema subjacente de " +"transação (nesse caso puro JDBC, mas também poderia rodar com JTA), nos " +"usamos a API <literal>Transaction</literal>, que está disponível na " +"<literal>Session</literal> do Hibernate." -#: index.docbook:419 -msgid "What does <literal>sessionFactory.getCurrentSession()</literal> do? First, you can call it as many times and anywhere you like, once you get hold of your <literal>SessionFactory</literal> (easy thanks to <literal>HibernateUtil</literal>). The <literal>getCurrentSession()</literal> method always returns the \"current\" unit of work. Remember that we switched the configuration option for this mechanism to \"thread\" in <literal>hibernate.cfg.xml</literal>? Hence, the current unit of work is bound to the current Java thread that executes our application. However, this is not the full picture, you also have to consider scope, when a unit of work begins and when it ends." +#. Tag: para +#: tutorial.xml:419 +#, no-c-format +msgid "" +"What does <literal>sessionFactory.getCurrentSession()</literal> do? First, " +"you can call it as many times and anywhere you like, once you get hold of " +"your <literal>SessionFactory</literal> (easy thanks to " +"<literal>HibernateUtil</literal>). The <literal>getCurrentSession()</" +"literal> method always returns the \"current\" unit of work. Remember that " +"we switched the configuration option for this mechanism to \"thread\" in " +"<literal>hibernate.cfg.xml</literal>? Hence, the current unit of work is " +"bound to the current Java thread that executes our application. However, " +"this is not the full picture, you also have to consider scope, when a unit " +"of work begins and when it ends." msgstr "" +"O que a <literal>sessionFactory.getCurrentSession()</literal> faz? Primeiro, " +"você pode chamar quantas vezes e de onde quiser, uma vez você recebe sua " +"<literal>SessionFactory</literal> (fácil graças ao <literal>HibernateUtil</" +"literal>). O método <literal>getCurrentSession()</literal> sempre retorna a " +"unidade de trabalho \"corrente\". Lembra de que nós mudamos a opção de " +"configuração desse mecanismo para thread no <literal>hibernate.cfg.xml</" +"literal>? Daqui em diante, o escopo da unidade de trabalho corrente é a " +"thread Java corrente que executa nossa aplicação. Entretanto, esta não é " +"toda a verdade. Uma" -#: index.docbook:430 -msgid "A <literal>Session</literal> begins when it is first needed, when the first call to <literal>getCurrentSession()</literal> is made. It is then bound by Hibernate to the current thread. When the transaction ends, either through commit or rollback, Hibernate automatically unbinds the <literal>Session</literal> from the thread and closes it for you. If you call <literal>getCurrentSession()</literal> again, you get a new <literal>Session</literal> and can start a new unit of work. This <emphasis>thread-bound</emphasis> programming model is the most popular way of using Hibernate, as it allows flexible layering of your code (transaction demarcation code can be separated from data access code, we'll do this later in this tutorial)." +#. Tag: para +#: tutorial.xml:430 +#, no-c-format +msgid "" +"A <literal>Session</literal> begins when it is first needed, when the first " +"call to <literal>getCurrentSession()</literal> is made. It is then bound by " +"Hibernate to the current thread. When the transaction ends, either through " +"commit or rollback, Hibernate automatically unbinds the <literal>Session</" +"literal> from the thread and closes it for you. If you call " +"<literal>getCurrentSession()</literal> again, you get a new " +"<literal>Session</literal> and can start a new unit of work. This " +"<emphasis>thread-bound</emphasis> programming model is the most popular way " +"of using Hibernate, as it allows flexible layering of your code (transaction " +"demarcation code can be separated from data access code, we'll do this later " +"in this tutorial)." msgstr "" +"<literal>Session</literal> começa quando é primeiramente necessária, quando " +"é feita a primeira chamada à <literal>getCurrentSession()</literal>. É então " +"limitado pelo Hibernate para thread corrente. Quando a transação termina, " +"tanto com commit quanto rollback, o Hibernate também desune a " +"<literal>Session</literal> da thread e fecha isso pra você. Se você chamar " +"<literal>getCurrentSession()</literal> novamente, você receberá uma nova " +"<literal>Session</literal> e pode começar uma nova unidade de trabalho. Esse " +"modelo de programação de limite de thread <emphasis>thread-bound</emphasis>, " +"é o modo mais popular de se usar o Hibernate." -#: index.docbook:441 -msgid "Related to the unit of work scope, should the Hibernate <literal>Session</literal> be used to execute one or several database operations? The above example uses one <literal>Session</literal> for one operation. This is pure coincidence, the example is just not complex enough to show any other approach. The scope of a Hibernate <literal>Session</literal> is flexible but you should never design your application to use a new Hibernate <literal>Session</literal> for <emphasis>every</emphasis> database operation. So even if you see it a few more times in the following (very trivial) examples, consider <emphasis>session-per-operation</emphasis> an anti-pattern. A real (web) application is shown later in this tutorial." +#. Tag: para +#: tutorial.xml:441 +#, no-c-format +msgid "" +"Related to the unit of work scope, should the Hibernate <literal>Session</" +"literal> be used to execute one or several database operations? The above " +"example uses one <literal>Session</literal> for one operation. This is pure " +"coincidence, the example is just not complex enough to show any other " +"approach. The scope of a Hibernate <literal>Session</literal> is flexible " +"but you should never design your application to use a new Hibernate " +"<literal>Session</literal> for <emphasis>every</emphasis> database " +"operation. So even if you see it a few more times in the following (very " +"trivial) examples, consider <emphasis>session-per-operation</emphasis> an " +"anti-pattern. A real (web) application is shown later in this tutorial." msgstr "" +"Related to the unit of work scope, should the Hibernate <literal>Session</" +"literal> be used to execute one or several database operations? The above " +"example uses one <literal>Session</literal> for one operation. This is pure " +"coincidence, the example is just not complex enough to show any other " +"approach. The scope of a Hibernate <literal>Session</literal> is flexible " +"but you should never design your application to use a new Hibernate " +"<literal>Session</literal> for <emphasis>every</emphasis> database " +"operation. So even if you see it a few more times in the following (very " +"trivial) examples, consider <emphasis>session-per-operation</emphasis> an " +"anti-pattern. A real (web) application is shown later in this tutorial." -#: index.docbook:452 -msgid "Have a look at <xref linkend=\"transactions\"/> for more information about transaction handling and demarcation. We also skipped any error handling and rollback in the previous example." +#. Tag: para +#: tutorial.xml:452 +#, no-c-format +msgid "" +"Have a look at <xref linkend=\"transactions\"/> for more information about " +"transaction handling and demarcation. We also skipped any error handling and " +"rollback in the previous example." msgstr "" +"Dê uma olhada no <xref linkend=\"transactions\"/> para mais informações a " +"respeito de manipulação de transação e demarcação. Nós também pulamos " +"qualquer manipulação de erro e rollback no exemplo anterior." -#: index.docbook:458 -msgid "To run this first routine we have to add a callable target to the Ant build file:" +#. Tag: para +#: tutorial.xml:458 +#, no-c-format +msgid "" +"To run this first routine we have to add a callable target to the Ant build " +"file:" msgstr "" +"Para executar esta primeira rotina, nos teremos que adicionar um ponto de " +"chamada para o arquivo de build do Ant:" -#: index.docbook:462 +#. Tag: programlisting +#: tutorial.xml:462 +#, no-c-format msgid "" - "<![CDATA[<target name=\"run\" depends=\"compile\">\n" - " <java fork=\"true\" classname=\"events.EventManager\" classpathref=\"libraries\">\n" - " <classpath path=\"${targetdir}\"/>\n" - " <arg value=\"${action}\"/>\n" - " </java>\n" - "</target>]]>" +"<![CDATA[<target name=\"run\" depends=\"compile\">\n" +" <java fork=\"true\" classname=\"events.EventManager\" classpathref=" +"\"libraries\">\n" +" <classpath path=\"${targetdir}\"/>\n" +" <arg value=\"${action}\"/>\n" +" </java>\n" +"</target>]]>" msgstr "" -#: index.docbook:464 -msgid "The value of the <literal>action</literal> argument is set on the command line when calling the target:" +#. Tag: para +#: tutorial.xml:464 +#, no-c-format +msgid "" +"The value of the <literal>action</literal> argument is set on the command " +"line when calling the target:" msgstr "" +"O valor do argumento <literal>action</literal>, é setado na linha de comando " +"quando chamando esse ponto:" -#: index.docbook:469 +#. Tag: programlisting +#: tutorial.xml:469 +#, no-c-format msgid "<![CDATA[C:\\hibernateTutorial\\>ant run -Daction=store]]>" msgstr "" -#: index.docbook:471 -msgid "You should see, after compilation, Hibernate starting up and, depending on your configuration, lots of log output. At the end you will find the following line:" +#. Tag: para +#: tutorial.xml:471 +#, no-c-format +msgid "" +"You should see, after compilation, Hibernate starting up and, depending on " +"your configuration, lots of log output. At the end you will find the " +"following line:" msgstr "" +"Você deverá ver, após a compilação, o startup do Hibernate e, dependendo da " +"sua configuração, muito log de saída. No final você verá a seguinte linha:" -#: index.docbook:476 -msgid "<![CDATA[[java] Hibernate: insert into EVENTS (EVENT_DATE, title, EVENT_ID) values (?, ?, ?)]]>" +#. Tag: programlisting +#: tutorial.xml:476 +#, no-c-format +msgid "" +"<![CDATA[[java] Hibernate: insert into EVENTS (EVENT_DATE, title, EVENT_ID) " +"values (?, ?, ?)]]>" msgstr "" -#: index.docbook:478 -msgid "This is the <literal>INSERT</literal> executed by Hibernate, the question marks represent JDBC bind parameters. To see the values bound as arguments, or to reduce the verbosity of the log, check your <literal>log4j.properties</literal>." +#. Tag: para +#: tutorial.xml:478 +#, no-c-format +msgid "" +"This is the <literal>INSERT</literal> executed by Hibernate, the question " +"marks represent JDBC bind parameters. To see the values bound as arguments, " +"or to reduce the verbosity of the log, check your <literal>log4j.properties</" +"literal>." msgstr "" +"Este é o <literal>INSERT</literal> executado pelo Hibernate, os pontos de " +"interrogação representam parêmetros de união do JDBC. Para ver os valores " +"substituídos, ou para diminuir a verbalidade do log, check seu " +"l<literal>log4j.properties</literal>." -#: index.docbook:484 -msgid "Now we'd like to list stored events as well, so we add an option to the main method:" +#. Tag: para +#: tutorial.xml:484 +#, no-c-format +msgid "" +"Now we'd like to list stored events as well, so we add an option to the main " +"method:" msgstr "" +"Agora nós gostaríamos de listar os eventos arquivados, então nós adicionamos " +"uma opção para o método main:" -#: index.docbook:488 +#. Tag: programlisting +#: tutorial.xml:488 +#, no-c-format msgid "" - "<![CDATA[if (args[0].equals(\"store\")) {\n" - " mgr.createAndStoreEvent(\"My Event\", new Date());\n" - "}\n" - "else if (args[0].equals(\"list\")) {\n" - " List events = mgr.listEvents();\n" - " for (int i = 0; i < events.size(); i++) {\n" - " Event theEvent = (Event) events.get(i);\n" - " System.out.println(\"Event: \" + theEvent.getTitle() +\n" - " \" Time: \" + theEvent.getDate());\n" - " }\n" - "}]]>" +"<![CDATA[if (args[0].equals(\"store\")) {\n" +" mgr.createAndStoreEvent(\"My Event\", new Date());\n" +"}\n" +"else if (args[0].equals(\"list\")) {\n" +" List events = mgr.listEvents();\n" +" for (int i = 0; i < events.size(); i++) {\n" +" Event theEvent = (Event) events.get(i);\n" +" System.out.println(\"Event: \" + theEvent.getTitle() +\n" +" \" Time: \" + theEvent.getDate());\n" +" }\n" +"}]]>" msgstr "" -#: index.docbook:490 +#. Tag: para +#: tutorial.xml:490 +#, no-c-format msgid "We also add a new <literal>listEvents() method</literal>:" -msgstr "" +msgstr "Nos também adicionamos um novo <literal>método listEvents()</literal>:" -#: index.docbook:494 +#. Tag: programlisting +#: tutorial.xml:494 +#, no-c-format msgid "" - "<![CDATA[private List listEvents() {\n" - "\n" - " Session session = HibernateUtil.getSessionFactory().getCurrentSession();\n" - "\n" - " session.beginTransaction();\n" - "\n" - " List result = session.createQuery(\"from Event\").list();\n" - "\n" - " session.getTransaction().commit();\n" - "\n" - " return result;\n" - "}]]>" +"<![CDATA[private List listEvents() {\n" +"\n" +" Session session = HibernateUtil.getSessionFactory().getCurrentSession" +"();\n" +"\n" +" session.beginTransaction();\n" +"\n" +" List result = session.createQuery(\"from Event\").list();\n" +"\n" +" session.getTransaction().commit();\n" +"\n" +" return result;\n" +"}]]>" msgstr "" -#: index.docbook:496 -msgid "What we do here is use an HQL (Hibernate Query Language) query to load all existing <literal>Event</literal> objects from the database. Hibernate will generate the appropriate SQL, send it to the database and populate <literal>Event</literal> objects with the data. You can create more complex queries with HQL, of course." +#. Tag: para +#: tutorial.xml:496 +#, no-c-format +msgid "" +"What we do here is use an HQL (Hibernate Query Language) query to load all " +"existing <literal>Event</literal> objects from the database. Hibernate will " +"generate the appropriate SQL, send it to the database and populate " +"<literal>Event</literal> objects with the data. You can create more complex " +"queries with HQL, of course." msgstr "" +"O que nós fazemos aqui, é usar uma query HQL (Hibernate Query Language), " +"para carregar todos os objetos <literal>Event</literal> exitentes no banco " +"de dados. O Hibernate irá gerar o SQL apropriado, enviar para o banco de " +"dados e popular objetos <literal>Event</literal> com os dados. Você pode " +"criar queries mais complexas com HQL, claro." -#: index.docbook:503 +#. Tag: para +#: tutorial.xml:503 +#, no-c-format msgid "Now, to execute and test all of this, follow these steps:" -msgstr "" +msgstr "Agora, para executar e testar tudo isso, siga os passos a seguir:" -#: index.docbook:509 -msgid "Run <literal>ant run -Daction=store</literal> to store something into the database and, of course, to generate the database schema before through hbm2ddl." +#. Tag: para +#: tutorial.xml:509 +#, no-c-format +msgid "" +"Run <literal>ant run -Daction=store</literal> to store something into the " +"database and, of course, to generate the database schema before through " +"hbm2ddl." msgstr "" +"Execute <literal>ant run -Daction=store</literal> para armazenar algo no " +"banco de dados e, claro, gerar o esquema do banco de dados antes pelo " +"hbm2ddl." -#: index.docbook:515 -msgid "Now disable hbm2ddl by commenting out the property in your <literal>hibernate.cfg.xml</literal> file. Usually you only leave it turned on in continous unit testing, but another run of hbm2ddl would <emphasis>drop</emphasis> everything you have stored - the <literal>create</literal> configuration setting actually translates into \"drop all tables from the schema, then re-create all tables, when the SessionFactory is build\"." +#. Tag: para +#: tutorial.xml:515 +#, no-c-format +msgid "" +"Now disable hbm2ddl by commenting out the property in your " +"<literal>hibernate.cfg.xml</literal> file. Usually you only leave it turned " +"on in continous unit testing, but another run of hbm2ddl would " +"<emphasis>drop</emphasis> everything you have stored - the <literal>create</" +"literal> configuration setting actually translates into \"drop all tables " +"from the schema, then re-create all tables, when the SessionFactory is build" +"\"." msgstr "" +"Agora desabilite hbm2ddl comentando a propriedade no seu arquivo " +"<literal>hibernate.cfg.xml</literal>. Normalmente só se deixa habilitado em " +"teste unitários contínuos, mas outra carga de hbm2ddl pode " +"<emphasis>remover</emphasis> tudo que você já tenha arquivado. Sa " +"configuração <literal>create</literal>, atualmente são traduzidas para " +"\"apague todas as tabelas do esquema, então recrie todas quando a " +"SessionFactory estiver pronta\"." -#: index.docbook:525 -msgid "If you now call Ant with <literal>-Daction=list</literal>, you should see the events you have stored so far. You can of course also call the <literal>store</literal> action a few times more." +#. Tag: para +#: tutorial.xml:525 +#, no-c-format +msgid "" +"If you now call Ant with <literal>-Daction=list</literal>, you should see " +"the events you have stored so far. You can of course also call the " +"<literal>store</literal> action a few times more." msgstr "" +"Se você agora chamar o Ant com <literal>-Daction=list</literal>, você deverá " +"ver os eventos que você acabou de criar. Você pode também chamar a ação " +"<literal>store</literal> mais algumas vezes." -#: index.docbook:531 -msgid "Note: Most new Hibernate users fail at this point and we see questions about <emphasis>Table not found</emphasis> error messages regularly. However, if you follow the steps outlined above you will not have this problem, as hbm2ddl creates the database schema on the first run, and subsequent application restarts will use this schema. If you change the mapping and/or database schema, you have to re-enable hbm2ddl once again." +#. Tag: para +#: tutorial.xml:531 +#, no-c-format +msgid "" +"Note: Most new Hibernate users fail at this point and we see questions about " +"<emphasis>Table not found</emphasis> error messages regularly. However, if " +"you follow the steps outlined above you will not have this problem, as " +"hbm2ddl creates the database schema on the first run, and subsequent " +"application restarts will use this schema. If you change the mapping and/or " +"database schema, you have to re-enable hbm2ddl once again." msgstr "" +"Nota: A maioria dos novos usuários do Hibernate falha nesse ponto e nós " +"regularmente, vemos questões sobre mensagens de erro de <emphasis>tabela não " +"encontrada </emphasis> . Entretanto, se você seguir os passos marcados " +"acima, você não terá esse problema, com o hbm2ddl criando o esquema do banco " +"de dados na primeira execução, e restarts subsequentes da aplicação irão " +"usar este esquema. Se você mudar o mapeamento e/ou o esquema do banco de " +"dados, terá de re-habilitar o hbm2ddl mais uma vez." -#: index.docbook:544 +#. Tag: title +#: tutorial.xml:544 +#, no-c-format msgid "Part 2 - Mapping associations" -msgstr "" +msgstr "Part 2 - Mapeando associações" -#: index.docbook:546 -msgid "We mapped a persistent entity class to a table. Let's build on this and add some class associations. First we'll add people to our application, and store a list of events they participate in." +#. Tag: para +#: tutorial.xml:546 +#, no-c-format +msgid "" +"We mapped a persistent entity class to a table. Let's build on this and add " +"some class associations. First we'll add people to our application, and " +"store a list of events they participate in." msgstr "" +"Nós mapeamos uma classe de entidade de persistência para uma tabela. Agora " +"vamos continuar e adicionar algumas associações de classe. Primeiro nos " +"iremos adicionar pessoas a nossa aplicação, e armazenar os eventos de que " +"elas participam." -#: index.docbook:552 +#. Tag: title +#: tutorial.xml:552 +#, no-c-format msgid "Mapping the Person class" -msgstr "" +msgstr "Mapeando a classe Person" -#: index.docbook:554 +#. Tag: para +#: tutorial.xml:554 +#, no-c-format msgid "The first cut of the <literal>Person</literal> class is simple:" -msgstr "" +msgstr "O primeiro código da classe <literal>Person</literal> é simples:" -#: index.docbook:558 +#. Tag: programlisting +#: tutorial.xml:558 +#, no-c-format msgid "" - "<![CDATA[package events;\n" - "\n" - "public class Person {\n" - "\n" - " private Long id;\n" - " private int age;\n" - " private String firstname;\n" - " private String lastname;\n" - "\n" - " public Person() {}\n" - "\n" - " // Accessor methods for all properties, private setter for 'id'\n" - "\n" - "}]]>" +"<![CDATA[package events;\n" +"\n" +"public class Person {\n" +"\n" +" private Long id;\n" +" private int age;\n" +" private String firstname;\n" +" private String lastname;\n" +"\n" +" public Person() {}\n" +"\n" +" // Accessor methods for all properties, private setter for 'id'\n" +"\n" +"}]]>" msgstr "" -#: index.docbook:560 -msgid "Create a new mapping file called <literal>Person.hbm.xml</literal> (don't forget the DTD reference at the top):" +#. Tag: para +#: tutorial.xml:560 +#, no-c-format +msgid "" +"Create a new mapping file called <literal>Person.hbm.xml</literal> (don't " +"forget the DTD reference at the top):" msgstr "" +"Crie um novo arquivo de mapeamento, chamado <literal>Person.hbm.xml</" +"literal> (não esqueça a referencia ao DTD no topo)" -#: index.docbook:565 +#. Tag: programlisting +#: tutorial.xml:565 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"events.Person\" table=\"PERSON\">\n" - " <id name=\"id\" column=\"PERSON_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"age\"/>\n" - " <property name=\"firstname\"/>\n" - " <property name=\"lastname\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +"\n" +" <class name=\"events.Person\" table=\"PERSON\">\n" +" <id name=\"id\" column=\"PERSON_ID\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <property name=\"age\"/>\n" +" <property name=\"firstname\"/>\n" +" <property name=\"lastname\"/>\n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" -#: index.docbook:567 +#. Tag: para +#: tutorial.xml:567 +#, no-c-format msgid "Finally, add the new mapping to Hibernate's configuration:" -msgstr "" +msgstr "Finalmente, adicione o novo mapeamento a configuração do Hibernate:" -#: index.docbook:571 +#. Tag: programlisting +#: tutorial.xml:571 +#, no-c-format msgid "" - "<![CDATA[<mapping resource=\"events/Event.hbm.xml\"/>\n" - "<mapping resource=\"events/Person.hbm.xml\"/>]]>" +"<![CDATA[<mapping resource=\"events/Event.hbm.xml\"/>\n" +"<mapping resource=\"events/Person.hbm.xml\"/>]]>" msgstr "" -#: index.docbook:573 -msgid "We'll now create an association between these two entities. Obviously, persons can participate in events, and events have participants. The design questions we have to deal with are: directionality, multiplicity, and collection behavior." +#. Tag: para +#: tutorial.xml:573 +#, no-c-format +msgid "" +"We'll now create an association between these two entities. Obviously, " +"persons can participate in events, and events have participants. The design " +"questions we have to deal with are: directionality, multiplicity, and " +"collection behavior." msgstr "" +"Nos iremos agora criar uma associação entre estas duas entidades. " +"Obviamente, pessoas (Person) podem participar de eventos, e eventos possuem " +"participantes. As questões de design com que teremos de lidar são: " +"direcionalidade, multiplicidade e comportamento de coleção." -#: index.docbook:583 +#. Tag: title +#: tutorial.xml:583 +#, no-c-format msgid "A unidirectional Set-based association" -msgstr "" +msgstr "Uma associação Set-based unidirectional" -#: index.docbook:585 -msgid "We'll add a collection of events to the <literal>Person</literal> class. That way we can easily navigate to the events for a particular person, without executing an explicit query - by calling <literal>aPerson.getEvents()</literal>. We use a Java collection, a <literal>Set</literal>, because the collection will not contain duplicate elements and the ordering is not relevant for us." +#. Tag: para +#: tutorial.xml:585 +#, no-c-format +msgid "" +"We'll add a collection of events to the <literal>Person</literal> class. " +"That way we can easily navigate to the events for a particular person, " +"without executing an explicit query - by calling <literal>aPerson.getEvents()" +"</literal>. We use a Java collection, a <literal>Set</literal>, because the " +"collection will not contain duplicate elements and the ordering is not " +"relevant for us." msgstr "" +"Nos iremos adicionar uma coleção de eventos na classe <literal>Person</" +"literal>. Desse jeito poderemos navegar pelos eventos de uma pessoa em " +"particular, sem executar uma query explicitamente – apenas chamando " +"<literal>aPerson.getEvents()</literal>. Nos usaremos uma coleção Java, um " +"<literal>Set</literal>, porquê a coleção não conterá elementos duplicados e " +"a ordem não é relevante para nós." -#: index.docbook:592 -msgid "We need a unidirectional, many-valued associations, implemented with a <literal>Set</literal>. Let's write the code for this in the Java classes and then map it:" -msgstr "" +#. Tag: para +#: tutorial.xml:592 +#, no-c-format +msgid "" +"We need a unidirectional, many-valued associations, implemented with a " +"<literal>Set</literal>. Let's write the code for this in the Java classes " +"and then map it:" +msgstr "Vamos escrever o código para isto nas classes Java e então mapear:" -#: index.docbook:597 +#. Tag: programlisting +#: tutorial.xml:597 +#, no-c-format msgid "" - "<![CDATA[public class Person {\n" - "\n" - " private Set events = new HashSet();\n" - "\n" - " public Set getEvents() {\n" - " return events;\n" - " }\n" - "\n" - " public void setEvents(Set events) {\n" - " this.events = events;\n" - " }\n" - "}]]>" +"<![CDATA[public class Person {\n" +"\n" +" private Set events = new HashSet();\n" +"\n" +" public Set getEvents() {\n" +" return events;\n" +" }\n" +"\n" +" public void setEvents(Set events) {\n" +" this.events = events;\n" +" }\n" +"}]]>" msgstr "" -#: index.docbook:599 -msgid "Before we map this association, think about the other side. Clearly, we could just keep this unidirectional. Or, we could create another collection on the <literal>Event</literal>, if we want to be able to navigate it bi-directional, i.e. <literal>anEvent.getParticipants()</literal>. This is not necessary, from a functional perspective. You could always execute an explicit query to retrieve the participants for a particular event. This is a design choice left to you, but what is clear from this discussion is the multiplicity of the association: \"many\" valued on both sides, we call this a <emphasis>many-to-many</emphasis> association. Hence, we use Hibernate's many-to-many mapping:" +#. Tag: para +#: tutorial.xml:599 +#, no-c-format +msgid "" +"Before we map this association, think about the other side. Clearly, we " +"could just keep this unidirectional. Or, we could create another collection " +"on the <literal>Event</literal>, if we want to be able to navigate it bi-" +"directional, i.e. <literal>anEvent.getParticipants()</literal>. This is not " +"necessary, from a functional perspective. You could always execute an " +"explicit query to retrieve the participants for a particular event. This is " +"a design choice left to you, but what is clear from this discussion is the " +"multiplicity of the association: \"many\" valued on both sides, we call this " +"a <emphasis>many-to-many</emphasis> association. Hence, we use Hibernate's " +"many-to-many mapping:" msgstr "" +"Antes de mapearmos esta associação, pense no outro lado. Claramente, " +"poderíamos apenas fazer isto de forma unidirecional. Ou poderíamos criar " +"outra coleção no <literal>Event</literal>, se quisermos ser capaz de navegar " +"bidirecionalmente, i.e. um - <literal>anEvent.getParticipants()</literal>. " +"Isto não é necessário, de perspectiva funcional. Você poderia sempre " +"executar uma query explicita que retornasse os participantes de um evento em " +"particular. Esta é uma escolha de design que cabe a você, mas o que é claro " +"nessa discussão é a multiplicidade da associação: \"muitos\" valores em " +"ambos os lados, nós chamamos isto uma associação <emphasis>muitos-para-" +"muitos</emphasis>. Daqui pra frente, nos usaremos o mapeamento muitos-para-" +"muitos do Hibernate:" -#: index.docbook:610 +#. Tag: programlisting +#: tutorial.xml:610 +#, no-c-format msgid "" - "<![CDATA[<class name=\"events.Person\" table=\"PERSON\">\n" - " <id name=\"id\" column=\"PERSON_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"age\"/>\n" - " <property name=\"firstname\"/>\n" - " <property name=\"lastname\"/>\n" - "\n" - " <set name=\"events\" table=\"PERSON_EVENT\">\n" - " <key column=\"PERSON_ID\"/>\n" - " <many-to-many column=\"EVENT_ID\" class=\"events.Event\"/>\n" - " </set>\n" - "\n" - "</class>]]>" +"<![CDATA[<class name=\"events.Person\" table=\"PERSON\">\n" +" <id name=\"id\" column=\"PERSON_ID\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <property name=\"age\"/>\n" +" <property name=\"firstname\"/>\n" +" <property name=\"lastname\"/>\n" +"\n" +" <set name=\"events\" table=\"PERSON_EVENT\">\n" +" <key column=\"PERSON_ID\"/>\n" +" <many-to-many column=\"EVENT_ID\" class=\"events.Event\"/>\n" +" </set>\n" +"\n" +"</class>]]>" msgstr "" -#: index.docbook:612 -msgid "Hibernate supports all kinds of collection mappings, a <literal><set></literal> being most common. For a many-to-many association (or <emphasis>n:m</emphasis> entity relationship), an association table is needed. Each row in this table represents a link between a person and an event. The table name is configured with the <literal>table</literal> attribute of the <literal>set</literal> element. The identifier column name in the association, for the person's side, is defined with the <literal><key></literal> element, the column name for the event's side with the <literal>column</literal> attribute of the <literal><many-to-many></literal>. You also have to tell Hibernate the class of the objects in your collection (correct: the class on the other side of the collection of references)." +#. Tag: para +#: tutorial.xml:612 +#, no-c-format +msgid "" +"Hibernate supports all kinds of collection mappings, a <literal><set></" +"literal> being most common. For a many-to-many association (or <emphasis>n:" +"m</emphasis> entity relationship), an association table is needed. Each row " +"in this table represents a link between a person and an event. The table " +"name is configured with the <literal>table</literal> attribute of the " +"<literal>set</literal> element. The identifier column name in the " +"association, for the person's side, is defined with the <literal><key>" +"</literal> element, the column name for the event's side with the " +"<literal>column</literal> attribute of the <literal><many-to-many></" +"literal>. You also have to tell Hibernate the class of the objects in your " +"collection (correct: the class on the other side of the collection of " +"references)." msgstr "" +"O Hibernate suporta todo tipo de mapeamento de coleção , sendo um " +"<literal><set></literal> mais comum. Para uma associação muitos-para-" +"muitos (ou relacionamento de entidade <emphasis>n:m</emphasis> ), uma tabela " +"de associação é necessária. Cada linha nessa tabela representa um link entre " +"uma pessoa e um evento. O nome da tabela é configurado com o atributo " +"<literal>table</literal> do elemento <literal>set</literal>. O nome da " +"coluna identificadora na associção, peloo lado da pessoa, é definido com o " +"elemento <literal><key></literal> , o nome da coluna pelo lado dos " +"eventos, e definido com o atributo <literal>column</literal> do <literal><" +"many-to-many></literal>. Você também precisa dizer para o Hibernate a " +"classe dos objetos na sua coleção (a classe do outro lado das coleções de " +"referência)." -#: index.docbook:624 +#. Tag: para +#: tutorial.xml:624 +#, no-c-format msgid "The database schema for this mapping is therefore:" -msgstr "" +msgstr "O esquema de mapeamento para o banco de dados está a seguir:" -#: index.docbook:628 +#. Tag: programlisting +#: tutorial.xml:628 +#, no-c-format msgid "" - "<![CDATA[\n" - " _____________ __________________\n" - " | | | | _____________\n" - " | EVENTS | | PERSON_EVENT | | |\n" - " |_____________| |__________________| | PERSON |\n" - " | | | | |_____________|\n" - " | *EVENT_ID | <--> | *EVENT_ID | | |\n" - " | EVENT_DATE | | *PERSON_ID | <--> | *PERSON_ID |\n" - " | TITLE | |__________________| | AGE |\n" - " |_____________| | FIRSTNAME |\n" - " | LASTNAME |\n" - " |_____________|\n" - " ]]>" +"<![CDATA[\n" +" _____________ __________________\n" +" | | | | _____________\n" +" | EVENTS | | PERSON_EVENT | | |\n" +" |_____________| |__________________| | PERSON |\n" +" | | | | |_____________|\n" +" | *EVENT_ID | <--> | *EVENT_ID | | |\n" +" | EVENT_DATE | | *PERSON_ID | <--> | *PERSON_ID |\n" +" | TITLE | |__________________| | AGE |\n" +" |_____________| | FIRSTNAME |\n" +" | LASTNAME |\n" +" |_____________|\n" +" ]]>" msgstr "" -#: index.docbook:633 +#. Tag: title +#: tutorial.xml:633 +#, no-c-format msgid "Working the association" -msgstr "" +msgstr "Trabalhando a associação" -#: index.docbook:635 -msgid "Let's bring some people and events together in a new method in <literal>EventManager</literal>:" +#. Tag: para +#: tutorial.xml:635 +#, no-c-format +msgid "" +"Let's bring some people and events together in a new method in " +"<literal>EventManager</literal>:" msgstr "" +"Vamos trazer juntos algumas pessoas e eventos em um novo método na classe " +"<literal>EventManager</literal>::" -#: index.docbook:639 +#. Tag: programlisting +#: tutorial.xml:639 +#, no-c-format msgid "" - "<![CDATA[private void addPersonToEvent(Long personId, Long eventId) {\n" - "\n" - " Session session = HibernateUtil.getSessionFactory().getCurrentSession();\n" - " session.beginTransaction();\n" - "\n" - " Person aPerson = (Person) session.load(Person.class, personId);\n" - " Event anEvent = (Event) session.load(Event.class, eventId);\n" - "\n" - " aPerson.getEvents().add(anEvent);\n" - "\n" - " session.getTransaction().commit();\n" - "}]]>" +"<![CDATA[private void addPersonToEvent(Long personId, Long eventId) {\n" +"\n" +" Session session = HibernateUtil.getSessionFactory().getCurrentSession" +"();\n" +" session.beginTransaction();\n" +"\n" +" Person aPerson = (Person) session.load(Person.class, personId);\n" +" Event anEvent = (Event) session.load(Event.class, eventId);\n" +"\n" +" aPerson.getEvents().add(anEvent);\n" +"\n" +" session.getTransaction().commit();\n" +"}]]>" msgstr "" -#: index.docbook:641 -msgid "After loading a <literal>Person</literal> and an <literal>Event</literal>, simply modify the collection using the normal collection methods. As you can see, there is no explicit call to <literal>update()</literal> or <literal>save()</literal>, Hibernate automatically detects that the collection has been modified and needs to be updated. This is called <emphasis>automatic dirty checking</emphasis>, and you can also try it by modifying the name or the date property of any of your objects. As long as they are in <emphasis>persistent</emphasis> state, that is, bound to a particular Hibernate <literal>Session</literal> (i.e. they have been just loaded or saved in a unit of work), Hibernate monitors any changes and executes SQL in a write-behind fashion. The process of synchronizing the memory state with the database, usually only at the end of a unit of work, is called <emphasis>flushing</emphasis>. In our code, the unit of work ends with a commit (or rollback) of the dat! abase transaction - as defined by the <literal>thread</literal> configuration option for the <literal>CurrentSessionContext</literal> class." +#. Tag: para +#: tutorial.xml:641 +#, no-c-format +msgid "" +"After loading a <literal>Person</literal> and an <literal>Event</literal>, " +"simply modify the collection using the normal collection methods. As you can " +"see, there is no explicit call to <literal>update()</literal> or " +"<literal>save()</literal>, Hibernate automatically detects that the " +"collection has been modified and needs to be updated. This is called " +"<emphasis>automatic dirty checking</emphasis>, and you can also try it by " +"modifying the name or the date property of any of your objects. As long as " +"they are in <emphasis>persistent</emphasis> state, that is, bound to a " +"particular Hibernate <literal>Session</literal> (i.e. they have been just " +"loaded or saved in a unit of work), Hibernate monitors any changes and " +"executes SQL in a write-behind fashion. The process of synchronizing the " +"memory state with the database, usually only at the end of a unit of work, " +"is called <emphasis>flushing</emphasis>. In our code, the unit of work ends " +"with a commit (or rollback) of the database transaction - as defined by the " +"<literal>thread</literal> configuration option for the " +"<literal>CurrentSessionContext</literal> class." msgstr "" +"Após carregar um <literal>Person</literal> e um <literal>Event</literal>, " +"simplesmente modifique a coleção usando os métodos normais de uma coleção. " +"Como você pode ver, não há chamada explícita para <literal>update()</" +"literal> ou <literal>save()</literal>, o Hibernate detecta automaticamente " +"que a coleção foi modificada e necessita ser atualizada. Isso é chamado de " +"<emphasis>checagem suja automática</emphasis>, e você também pode usá-la " +"modificando o nome ou a data de qualquer um dos seus objetos. Assim que eles " +"estiverem no estado <emphasis>persistent</emphasis>, ou seja, limitado por " +"uma <literal>Session</literal> do Hibernate em particular (i.e. eles foram " +"carregados ou salvos dentro de uma unidade de trabalho), o Hibernate " +"monitora qualquer alteração e executa o SQL em modo de escrita em segundo " +"plano. O processo de sincronização do estado da memória com o banco de " +"dados, geralmente apenas no final de uma unidade de trabalho, é chamado de " +"<emphasis>flushing</emphasis>. No nosso código, a unidade de trabalho " +"termina com o commit da transação do banco de dados – como definido pela " +"opção de configuração da <literal>thread</literal> da classe " +"<literal>CurrentSessionContext</literal>." -#: index.docbook:656 -msgid "You might of course load person and event in different units of work. Or you modify an object outside of a <literal>Session</literal>, when it is not in persistent state (if it was persistent before, we call this state <emphasis>detached</emphasis>). You can even modify a collection when it is detached:" +#. Tag: para +#: tutorial.xml:656 +#, no-c-format +msgid "" +"You might of course load person and event in different units of work. Or you " +"modify an object outside of a <literal>Session</literal>, when it is not in " +"persistent state (if it was persistent before, we call this state " +"<emphasis>detached</emphasis>). You can even modify a collection when it is " +"detached:" msgstr "" +"Você pode também querer carregar pessoas e eventos em diferentes unidades de " +"trabalho. Ou você modifica um objeto fora de uma <literal>Session</literal>, " +"quando não se encontra no estado persistent (se já esteve neste estado " +"anteriormente, chamamos esse estado de <emphasis>detached</emphasis>). Você " +"pode até mesmo modificar uma coleção quando esta se encontrar no estado " +"detached." -#: index.docbook:663 +#. Tag: programlisting +#: tutorial.xml:663 +#, no-c-format msgid "" - "<![CDATA[private void addPersonToEvent(Long personId, Long eventId) {\n" - "\n" - " Session session = HibernateUtil.getSessionFactory().getCurrentSession();\n" - " session.beginTransaction();\n" - "\n" - " Person aPerson = (Person) session\n" - " .createQuery(\"select p from Person p left join fetch p.events where p.id = :pid\")\n" - " .setParameter(\"pid\", personId)\n" - " .uniqueResult(); // Eager fetch the collection so we can use it detached\n" - "\n" - " Event anEvent = (Event) session.load(Event.class, eventId);\n" - "\n" - " session.getTransaction().commit();\n" - "\n" - " // End of first unit of work\n" - "\n" - " aPerson.getEvents().add(anEvent); // aPerson (and its collection) is detached\n" - "\n" - " // Begin second unit of work\n" - "\n" - " Session session2 = HibernateUtil.getSessionFactory().getCurrentSession();\n" - " session2.beginTransaction();\n" - "\n" - " session2.update(aPerson); // Reattachment of aPerson\n" - "\n" - " session2.getTransaction().commit();\n" - "}]]>" +"<![CDATA[private void addPersonToEvent(Long personId, Long eventId) {\n" +"\n" +" Session session = HibernateUtil.getSessionFactory().getCurrentSession" +"();\n" +" session.beginTransaction();\n" +"\n" +" Person aPerson = (Person) session\n" +" .createQuery(\"select p from Person p left join fetch p.events " +"where p.id = :pid\")\n" +" .setParameter(\"pid\", personId)\n" +" .uniqueResult(); // Eager fetch the collection so we can use it " +"detached\n" +"\n" +" Event anEvent = (Event) session.load(Event.class, eventId);\n" +"\n" +" session.getTransaction().commit();\n" +"\n" +" // End of first unit of work\n" +"\n" +" aPerson.getEvents().add(anEvent); // aPerson (and its collection) is " +"detached\n" +"\n" +" // Begin second unit of work\n" +"\n" +" Session session2 = HibernateUtil.getSessionFactory().getCurrentSession" +"();\n" +" session2.beginTransaction();\n" +"\n" +" session2.update(aPerson); // Reattachment of aPerson\n" +"\n" +" session2.getTransaction().commit();\n" +"}]]>" msgstr "" -#: index.docbook:665 -msgid "The call to <literal>update</literal> makes a detached object persistent again, you could say it binds it to a new unit of work, so any modifications you made to it while detached can be saved to the database. This includes any modifications (additions/deletions) you made to a collection of that entity object." +#. Tag: para +#: tutorial.xml:665 +#, no-c-format +msgid "" +"The call to <literal>update</literal> makes a detached object persistent " +"again, you could say it binds it to a new unit of work, so any modifications " +"you made to it while detached can be saved to the database. This includes " +"any modifications (additions/deletions) you made to a collection of that " +"entity object." msgstr "" +"A chamada <literal>update</literal> cria um objeto persistent novamente, " +"você poderia dizer que ele liga o objeto a uma nova unidade de trabalho, " +"assim qualquer modificação que você faça neste objeto enquanto estiver no " +"estado detached pode ser salvo no banco de dados. Isso inclui qualquer " +"modificação (adição/exclusão) que você faça em uma coleção da entidade deste " +"objeto." -#: index.docbook:672 -msgid "Well, this is not much use in our current situation, but it's an important concept you can design into your own application. For now, complete this exercise by adding a new action to the <literal>EventManager</literal>'s main method and call it from the command line. If you need the identifiers of a person and an event - the <literal>save()</literal> method returns it (you might have to modify some of the previous methods to return that identifier):" +#. Tag: para +#: tutorial.xml:672 +#, no-c-format +msgid "" +"Well, this is not much use in our current situation, but it's an important " +"concept you can design into your own application. For now, complete this " +"exercise by adding a new action to the <literal>EventManager</literal>'s " +"main method and call it from the command line. If you need the identifiers " +"of a person and an event - the <literal>save()</literal> method returns it " +"(you might have to modify some of the previous methods to return that " +"identifier):" msgstr "" +"Bom, isso não foi muito usado na nossa situação, porém, é um importante " +"conceito que você pode aplicar em seus aplicativos. Agora, complete este " +"exercício adicionando uma nova ação ao método main( ) da classe " +"<literal>EventManager</literal> e chame-o pela linha de comando. Se você " +"precisar dos identificadores de uma pessoa ou evento – o método <literal>save" +"()</literal> retorna estes identificadores (você poderá modificar alguns dos " +"métodos anteriores para retornar aquele identificador):" -#: index.docbook:680 +#. Tag: programlisting +#: tutorial.xml:680 +#, no-c-format msgid "" - "<![CDATA[else if (args[0].equals(\"addpersontoevent\")) {\n" - " Long eventId = mgr.createAndStoreEvent(\"My Event\", new Date());\n" - " Long personId = mgr.createAndStorePerson(\"Foo\", \"Bar\");\n" - " mgr.addPersonToEvent(personId, eventId);\n" - " System.out.println(\"Added person \" + personId + \" to event \" + eventId);\n" - "}]]>" +"<![CDATA[else if (args[0].equals(\"addpersontoevent\")) {\n" +" Long eventId = mgr.createAndStoreEvent(\"My Event\", new Date());\n" +" Long personId = mgr.createAndStorePerson(\"Foo\", \"Bar\");\n" +" mgr.addPersonToEvent(personId, eventId);\n" +" System.out.println(\"Added person \" + personId + \" to event \" + " +"eventId);\n" +"}]]>" msgstr "" -#: index.docbook:682 -msgid "This was an example of an association between two equally important classes, two entities. As mentioned earlier, there are other classes and types in a typical model, usually \"less important\". Some you have already seen, like an <literal>int</literal> or a <literal>String</literal>. We call these classes <emphasis>value types</emphasis>, and their instances <emphasis>depend</emphasis> on a particular entity. Instances of these types don't have their own identity, nor are they shared between entities (two persons don't reference the same <literal>firstname</literal> object, even if they have the same first name). Of course, value types can not only be found in the JDK (in fact, in a Hibernate application all JDK classes are considered value types), but you can also write dependent classes yourself, <literal>Address</literal> or <literal>MonetaryAmount</literal>, for example." +#. Tag: para +#: tutorial.xml:682 +#, no-c-format +msgid "" +"This was an example of an association between two equally important classes, " +"two entities. As mentioned earlier, there are other classes and types in a " +"typical model, usually \"less important\". Some you have already seen, like " +"an <literal>int</literal> or a <literal>String</literal>. We call these " +"classes <emphasis>value types</emphasis>, and their instances " +"<emphasis>depend</emphasis> on a particular entity. Instances of these types " +"don't have their own identity, nor are they shared between entities (two " +"persons don't reference the same <literal>firstname</literal> object, even " +"if they have the same first name). Of course, value types can not only be " +"found in the JDK (in fact, in a Hibernate application all JDK classes are " +"considered value types), but you can also write dependent classes yourself, " +"<literal>Address</literal> or <literal>MonetaryAmount</literal>, for example." msgstr "" +"Este foi um exemplo de uma associação entre duas classes igualmente " +"importantes, duas entidades. Como mencionado anteriormente, há outras " +"classes e tipos dentro de um modelo típico, geralmente \"menos importante\". " +"Alguns você já viu, como um <literal>int</literal> ou uma <literal>String</" +"literal>. Nós chamamos essas classes de <emphasis>value types</emphasis>, e " +"suas instâncias <emphasis>depend</emphasis> de uma entidade particular. As " +"instâncias desses tipos não possuem sua própria identidade, nem são " +"compartilhados entre entidades (duas pessoas não referenciam o mesmo objeto " +"<literal>firstname</literal> mesmo se elas tiverem o mesmo objeto " +"firstname). Naturalmente, os value types não são apenas encontrados dentro " +"da JDK (de fato, em um aplicativo Hibernate todas as classes JDK são " +"consideradas como value types), mas você pode também criar suas classes " +"como, por exemplo, <literal>Address</literal> ou <literal>MonetaryAmount</" +"literal>." -#: index.docbook:695 -msgid "You can also design a collection of value types. This is conceptually very different from a collection of references to other entities, but looks almost the same in Java." +#. Tag: para +#: tutorial.xml:695 +#, no-c-format +msgid "" +"You can also design a collection of value types. This is conceptually very " +"different from a collection of references to other entities, but looks " +"almost the same in Java." msgstr "" +"Você também pode criar uma coleção de value types. Isso é conceitualmente " +"muito diferente de uma coleção de referências para outras entidades, mas em " +"Java parece ser quase a mesma coisa." -#: index.docbook:703 +#. Tag: title +#: tutorial.xml:703 +#, no-c-format msgid "Collection of values" -msgstr "" +msgstr "Coleção de valores" -#: index.docbook:705 -msgid "We add a collection of value typed objects to the <literal>Person</literal> entity. We want to store email addresses, so the type we use is <literal>String</literal>, and the collection is again a <literal>Set</literal>:" +#. Tag: para +#: tutorial.xml:705 +#, no-c-format +msgid "" +"We add a collection of value typed objects to the <literal>Person</literal> " +"entity. We want to store email addresses, so the type we use is " +"<literal>String</literal>, and the collection is again a <literal>Set</" +"literal>:" msgstr "" +"Nós adicionamos uma coleção de objetos de tipo de valores à entidade " +"<literal>Person</literal>. Nós querermos armazenar endereços de e-mail, para " +"isso utilizamos o tipo <literal>String</literal>, e a coleção novamente será " +"um <literal>Set</literal>:" -#: index.docbook:710 +#. Tag: programlisting +#: tutorial.xml:710 +#, no-c-format msgid "" - "<![CDATA[private Set emailAddresses = new HashSet();\n" - "\n" - "public Set getEmailAddresses() {\n" - " return emailAddresses;\n" - "}\n" - "\n" - "public void setEmailAddresses(Set emailAddresses) {\n" - " this.emailAddresses = emailAddresses;\n" - "}]]>" +"<![CDATA[private Set emailAddresses = new HashSet();\n" +"\n" +"public Set getEmailAddresses() {\n" +" return emailAddresses;\n" +"}\n" +"\n" +"public void setEmailAddresses(Set emailAddresses) {\n" +" this.emailAddresses = emailAddresses;\n" +"}]]>" msgstr "" -#: index.docbook:712 +#. Tag: para +#: tutorial.xml:712 +#, no-c-format msgid "The mapping of this <literal>Set</literal>:" -msgstr "" +msgstr "O mapeamento deste <literal>Set</literal>:" -#: index.docbook:716 +#. Tag: programlisting +#: tutorial.xml:716 +#, no-c-format msgid "" - "<![CDATA[<set name=\"emailAddresses\" table=\"PERSON_EMAIL_ADDR\">\n" - " <key column=\"PERSON_ID\"/>\n" - " <element type=\"string\" column=\"EMAIL_ADDR\"/>\n" - "</set>]]>" +"<![CDATA[<set name=\"emailAddresses\" table=\"PERSON_EMAIL_ADDR\">\n" +" <key column=\"PERSON_ID\"/>\n" +" <element type=\"string\" column=\"EMAIL_ADDR\"/>\n" +"</set>]]>" msgstr "" -#: index.docbook:718 -msgid "The difference compared with the earlier mapping is the <literal>element</literal> part, which tells Hibernate that the collection does not contain references to another entity, but a collection of elements of type <literal>String</literal> (the lowercase name tells you it's a Hibernate mapping type/converter). Once again, the <literal>table</literal> attribute of the <literal>set</literal> element determines the table name for the collection. The <literal>key</literal> element defines the foreign-key column name in the collection table. The <literal>column</literal> attribute in the <literal>element</literal> element defines the column name where the <literal>String</literal> values will actually be stored." +#. Tag: para +#: tutorial.xml:718 +#, no-c-format +msgid "" +"The difference compared with the earlier mapping is the <literal>element</" +"literal> part, which tells Hibernate that the collection does not contain " +"references to another entity, but a collection of elements of type " +"<literal>String</literal> (the lowercase name tells you it's a Hibernate " +"mapping type/converter). Once again, the <literal>table</literal> attribute " +"of the <literal>set</literal> element determines the table name for the " +"collection. The <literal>key</literal> element defines the foreign-key " +"column name in the collection table. The <literal>column</literal> attribute " +"in the <literal>element</literal> element defines the column name where the " +"<literal>String</literal> values will actually be stored." msgstr "" +"A diferença comparada com o mapeamento anterior se encontra na parte " +"<literal>element</literal>, que indica ao Hibernate que a coleção não contém " +"referências à outra entidade, mas uma coleção de elementos do tipo " +"<literal>String</literal> (a tag name em miniscula indica que se trata de um " +"mapeamento do Hibernate para conversão de tipos). Mais uma vez, o atributo " +"<literal>table</literal> do elemento <literal>set</literal> determina o nome " +"da tabela para a coleção. O elemento <literal>key</literal> define o nome da " +"coluna de chave estrangeira na tabela de coleção. O atributo " +"<literal>column</literal> dentro do elemento <literal>element</literal> " +"define o nome da coluna onde os valores da <literal>String</literal> serão " +"armazenados." -#: index.docbook:728 +#. Tag: para +#: tutorial.xml:728 +#, no-c-format msgid "Have a look at the updated schema:" -msgstr "" +msgstr "Dê uma olhada no esquema atualizado:" -#: index.docbook:732 +#. Tag: programlisting +#: tutorial.xml:732 +#, no-c-format msgid "" - "<![CDATA[\n" - " _____________ __________________\n" - " | | | | _____________\n" - " | EVENTS | | PERSON_EVENT | | | ___________________\n" - " |_____________| |__________________| | PERSON | | |\n" - " | | | | |_____________| | PERSON_EMAIL_ADDR |\n" - " | *EVENT_ID | <--> | *EVENT_ID | | | |___________________|\n" - " | EVENT_DATE | | *PERSON_ID | <--> | *PERSON_ID | <--> | *PERSON_ID |\n" - " | TITLE | |__________________| | AGE | | *EMAIL_ADDR |\n" - " |_____________| | FIRSTNAME | |___________________|\n" - " | LASTNAME |\n" - " |_____________|\n" - " ]]>" +"<![CDATA[\n" +" _____________ __________________\n" +" | | | | _____________\n" +" | EVENTS | | PERSON_EVENT | | | " +"___________________\n" +" |_____________| |__________________| | PERSON | " +"| |\n" +" | | | | |_____________| | " +"PERSON_EMAIL_ADDR |\n" +" | *EVENT_ID | <--> | *EVENT_ID | | | |" +"___________________|\n" +" | EVENT_DATE | | *PERSON_ID | <--> | *PERSON_ID | <--> | " +"*PERSON_ID |\n" +" | TITLE | |__________________| | AGE | | " +"*EMAIL_ADDR |\n" +" |_____________| | FIRSTNAME | |" +"___________________|\n" +" | LASTNAME |\n" +" |_____________|\n" +" ]]>" msgstr "" -#: index.docbook:734 -msgid "You can see that the primary key of the collection table is in fact a composite key, using both columns. This also implies that there can't be duplicate email addresses per person, which is exactly the semantics we need for a set in Java." +#. Tag: para +#: tutorial.xml:734 +#, no-c-format +msgid "" +"You can see that the primary key of the collection table is in fact a " +"composite key, using both columns. This also implies that there can't be " +"duplicate email addresses per person, which is exactly the semantics we need " +"for a set in Java." msgstr "" +"Você pode observar que a chave primária da tabela da coleção é de na verdade " +"uma chave composta, usando ambas colunas. Isso também implica que cada " +"pessoa não pode ter endereços de e-mail duplicados, o que é exatamente a " +"semântica que precisamos para um set em Java." -#: index.docbook:740 -msgid "You can now try and add elements to this collection, just like we did before by linking persons and events. It's the same code in Java:" +#. Tag: para +#: tutorial.xml:740 +#, no-c-format +msgid "" +"You can now try and add elements to this collection, just like we did before " +"by linking persons and events. It's the same code in Java:" msgstr "" +"Você pode agora tentar adicionar elementos a essa coleção, do mesmo modo que " +"fizemos anteriormente ligando pessoas e eventos. È o mesmo código em Java:" -#: index.docbook:745 +#. Tag: programlisting +#: tutorial.xml:745 +#, no-c-format msgid "" - "<![CDATA[private void addEmailToPerson(Long personId, String emailAddress) {\n" - "\n" - " Session session = HibernateUtil.getSessionFactory().getCurrentSession();\n" - " session.beginTransaction();\n" - "\n" - " Person aPerson = (Person) session.load(Person.class, personId);\n" - "\n" - " // The getEmailAddresses() might trigger a lazy load of the collection\n" - " aPerson.getEmailAddresses().add(emailAddress);\n" - "\n" - " session.getTransaction().commit();\n" - "}]]>" +"<![CDATA[private void addEmailToPerson(Long personId, String emailAddress) " +"{\n" +"\n" +" Session session = HibernateUtil.getSessionFactory().getCurrentSession" +"();\n" +" session.beginTransaction();\n" +"\n" +" Person aPerson = (Person) session.load(Person.class, personId);\n" +"\n" +" // The getEmailAddresses() might trigger a lazy load of the collection\n" +" aPerson.getEmailAddresses().add(emailAddress);\n" +"\n" +" session.getTransaction().commit();\n" +"}]]>" msgstr "" -#: index.docbook:747 -msgid "This time we didnt' use a <emphasis>fetch</emphasis> query to initialize the collection. Hence, the call to its getter method will trigger an additional select to initialize it, so we can add an element to it. Monitor the SQL log and try to optimize this with an eager fetch." +#. Tag: para +#: tutorial.xml:747 +#, no-c-format +msgid "" +"This time we didnt' use a <emphasis>fetch</emphasis> query to initialize the " +"collection. Hence, the call to its getter method will trigger an additional " +"select to initialize it, so we can add an element to it. Monitor the SQL log " +"and try to optimize this with an eager fetch." msgstr "" +"This time we didnt' use a <emphasis>fetch</emphasis> query to initialize the " +"collection. Hence, the call to its getter method will trigger an additional " +"select to initialize it, so we can add an element to it. Monitor the SQL log " +"and try to optimize this with an eager fetch." -#: index.docbook:757 +#. Tag: title +#: tutorial.xml:757 +#, no-c-format msgid "Bi-directional associations" -msgstr "" +msgstr "Associações bidirecionais" -#: index.docbook:759 -msgid "Next we are going to map a bi-directional association - making the association between person and event work from both sides in Java. Of course, the database schema doesn't change, we still have many-to-many multiplicity. A relational database is more flexible than a network programming language, so it doesn't need anything like a navigation direction - data can be viewed and retrieved in any possible way." +#. Tag: para +#: tutorial.xml:759 +#, no-c-format +msgid "" +"Next we are going to map a bi-directional association - making the " +"association between person and event work from both sides in Java. Of " +"course, the database schema doesn't change, we still have many-to-many " +"multiplicity. A relational database is more flexible than a network " +"programming language, so it doesn't need anything like a navigation " +"direction - data can be viewed and retrieved in any possible way." msgstr "" +"Agora iremos mapear uma associação bidirecional – fazendo a associação entre " +"pessoas e eventos, de ambos os lados, em Java. Logicamente, o esquema do " +"banco de dados não muda, nós continuamos tendo multiplicidades muitos-para-" +"muitos. Um banco de dados é mais flexível do que uma linguagem de " +"programação para redes, ele não precisa de nenhuma direção de navegação – os " +"dados podem ser acessados em qualquer caminho possível." -#: index.docbook:767 -msgid "First, add a collection of participants to the <literal>Event</literal> Event class:" +#. Tag: para +#: tutorial.xml:767 +#, no-c-format +msgid "" +"First, add a collection of participants to the <literal>Event</literal> " +"Event class:" msgstr "" +"Primeiramente, adicione uma coleção de participantes à classe " +"<literal>Event</literal>:" -#: index.docbook:771 +#. Tag: programlisting +#: tutorial.xml:771 +#, no-c-format msgid "" - "<![CDATA[private Set participants = new HashSet();\n" - "\n" - "public Set getParticipants() {\n" - " return participants;\n" - "}\n" - "\n" - "public void setParticipants(Set participants) {\n" - " this.participants = participants;\n" - "}]]>" +"<![CDATA[private Set participants = new HashSet();\n" +"\n" +"public Set getParticipants() {\n" +" return participants;\n" +"}\n" +"\n" +"public void setParticipants(Set participants) {\n" +" this.participants = participants;\n" +"}]]>" msgstr "" -#: index.docbook:773 -msgid "Now map this side of the association too, in <literal>Event.hbm.xml</literal>." +#. Tag: para +#: tutorial.xml:773 +#, no-c-format +msgid "" +"Now map this side of the association too, in <literal>Event.hbm.xml</" +"literal>." msgstr "" +"Agora mapeie este lado da associação em <literal>Event.hbm.xml</literal>." -#: index.docbook:777 +#. Tag: programlisting +#: tutorial.xml:777 +#, no-c-format msgid "" - "<![CDATA[<set name=\"participants\" table=\"PERSON_EVENT\" inverse=\"true\">\n" - " <key column=\"EVENT_ID\"/>\n" - " <many-to-many column=\"PERSON_ID\" class=\"events.Person\"/>\n" - "</set>]]>" +"<![CDATA[<set name=\"participants\" table=\"PERSON_EVENT\" inverse=\"true" +"\">\n" +" <key column=\"EVENT_ID\"/>\n" +" <many-to-many column=\"PERSON_ID\" class=\"events.Person\"/>\n" +"</set>]]>" msgstr "" -#: index.docbook:779 -msgid "As you see, these are normal <literal>set</literal> mappings in both mapping documents. Notice that the column names in <literal>key</literal> and <literal>many-to-many</literal> are swapped in both mapping documents. The most important addition here is the <literal>inverse=\"true\"</literal> attribute in the <literal>set</literal> element of the <literal>Event</literal>'s collection mapping." +#. Tag: para +#: tutorial.xml:779 +#, no-c-format +msgid "" +"As you see, these are normal <literal>set</literal> mappings in both mapping " +"documents. Notice that the column names in <literal>key</literal> and " +"<literal>many-to-many</literal> are swapped in both mapping documents. The " +"most important addition here is the <literal>inverse=\"true\"</literal> " +"attribute in the <literal>set</literal> element of the <literal>Event</" +"literal>'s collection mapping." msgstr "" +"Como você pode ver, esses é uma mapeamento normal usando <literal>set</" +"literal> em ambos documenentos de mapeamento. Observe que o nome das colunas " +"em <literal>key</literal> e <literal>many-to-many</literal> estão trocados " +"em ambos os documentos de mapeamento. A adição mais importante feita está no " +"atributo <literal>inverse=\"true\"</literal> no elemento set do mapeamento " +"da coleção da classe <literal>Event</literal>." -#: index.docbook:787 -msgid "What this means is that Hibernate should take the other side - the <literal>Person</literal> class - when it needs to find out information about the link between the two. This will be a lot easier to understand once you see how the bi-directional link between our two entities is created ." +#. Tag: para +#: tutorial.xml:787 +#, no-c-format +msgid "" +"What this means is that Hibernate should take the other side - the " +"<literal>Person</literal> class - when it needs to find out information " +"about the link between the two. This will be a lot easier to understand once " +"you see how the bi-directional link between our two entities is created ." msgstr "" +"Isso significa que o Hibernate deve pegar o outro lado – a classe " +"<literal>Person</literal> – quando necessitar encontrar informação sobre a " +"relação entre as duas entidades. Isso será muito mais facilmente " +"compreendido quando você analisar como a relação bidirecional entre as " +"entidades é criada." -#: index.docbook:796 +#. Tag: title +#: tutorial.xml:796 +#, no-c-format msgid "Working bi-directional links" -msgstr "" +msgstr "Trabalhando com links bidirecionais" -#: index.docbook:798 -msgid "First, keep in mind that Hibernate does not affect normal Java semantics. How did we create a link between a <literal>Person</literal> and an <literal>Event</literal> in the unidirectional example? We added an instance of <literal>Event</literal> to the collection of event references, of an instance of <literal>Person</literal>. So, obviously, if we want to make this link working bi-directional, we have to do the same on the other side - adding a <literal>Person</literal> reference to the collection in an <literal>Event</literal>. This \"setting the link on both sides\" is absolutely necessary and you should never forget doing it." +#. Tag: para +#: tutorial.xml:798 +#, no-c-format +msgid "" +"First, keep in mind that Hibernate does not affect normal Java semantics. " +"How did we create a link between a <literal>Person</literal> and an " +"<literal>Event</literal> in the unidirectional example? We added an instance " +"of <literal>Event</literal> to the collection of event references, of an " +"instance of <literal>Person</literal>. So, obviously, if we want to make " +"this link working bi-directional, we have to do the same on the other side - " +"adding a <literal>Person</literal> reference to the collection in an " +"<literal>Event</literal>. This \"setting the link on both sides\" is " +"absolutely necessary and you should never forget doing it." msgstr "" +"Primeiro tenha em mente que o Hibernate não afeta a semântica normal do " +"Java. Como nós criamos um link entre uma <literal>Person</literal> e um " +"<literal>Event</literal> no exemplo unidirecional? Nós adicionamos uma " +"instância de <literal>Event</literal>, da coleção de referências de eventos, " +"a uma instância de <literal>Person</literal>. Então, obviamente, se nós " +"queremos que este link funcione bidirecionalmente, nós devemos fazer a mesma " +"coisa para o outro lado – adicionando uma referência de <literal>Person</" +"literal> na coleção de um <literal>Event</literal>. Esse acerto de link de " +"ambos os lados é absolutamente necessário e você nunca deve esquecer de faze-" +"lo." -#: index.docbook:808 -msgid "Many developers program defensive and create link management methods to correctly set both sides, e.g. in <literal>Person</literal>:" +#. Tag: para +#: tutorial.xml:808 +#, no-c-format +msgid "" +"Many developers program defensive and create link management methods to " +"correctly set both sides, e.g. in <literal>Person</literal>:" msgstr "" +"Muitos desenvolvedores programam de maneira defensiva e criam métodos " +"gerenciador de associações que ajusta corretamente ambos os lados:" -#: index.docbook:813 +#. Tag: programlisting +#: tutorial.xml:813 +#, no-c-format msgid "" - "<![CDATA[protected Set getEvents() {\n" - " return events;\n" - "}\n" - "\n" - "protected void setEvents(Set events) {\n" - " this.events = events;\n" - "}\n" - "\n" - "public void addToEvent(Event event) {\n" - " this.getEvents().add(event);\n" - " event.getParticipants().add(this);\n" - "}\n" - "\n" - "public void removeFromEvent(Event event) {\n" - " this.getEvents().remove(event);\n" - " event.getParticipants().remove(this);\n" - "}]]>" +"<![CDATA[protected Set getEvents() {\n" +" return events;\n" +"}\n" +"\n" +"protected void setEvents(Set events) {\n" +" this.events = events;\n" +"}\n" +"\n" +"public void addToEvent(Event event) {\n" +" this.getEvents().add(event);\n" +" event.getParticipants().add(this);\n" +"}\n" +"\n" +"public void removeFromEvent(Event event) {\n" +" this.getEvents().remove(event);\n" +" event.getParticipants().remove(this);\n" +"}]]>" msgstr "" -#: index.docbook:815 -msgid "Notice that the get and set methods for the collection are now protected - this allows classes in the same package and subclasses to still access the methods, but prevents everybody else from messing with the collections directly (well, almost). You should probably do the same with the collection on the other side." +#. Tag: para +#: tutorial.xml:815 +#, no-c-format +msgid "" +"Notice that the get and set methods for the collection are now protected - " +"this allows classes in the same package and subclasses to still access the " +"methods, but prevents everybody else from messing with the collections " +"directly (well, almost). You should probably do the same with the collection " +"on the other side." msgstr "" +"Observe que os métodos set e get da a coleção estão protegidos – isso " +"permite que classes e subclasses do mesmo pacote continuem acessando os " +"métodos, mas previne que qualquer outra classe, que não esteja no mesmo " +"pacote, acesse a coleção diretamente. Você provavelmente deve fazer a mesma " +"coisa para a coleção do outro lado." -#: index.docbook:822 -msgid "What about the <literal>inverse</literal> mapping attribute? For you, and for Java, a bi-directional link is simply a matter of setting the references on both sides correctly. Hibernate however doesn't have enough information to correctly arrange SQL <literal>INSERT</literal> and <literal>UPDATE</literal> statements (to avoid constraint violations), and needs some help to handle bi-directional associations properly. Making one side of the association <literal>inverse</literal> tells Hibernate to basically ignore it, to consider it a <emphasis>mirror</emphasis> of the other side. That's all that is necessary for Hibernate to work out all of the issues when transformation a directional navigation model to a SQL database schema. The rules you have to remember are straightforward: All bi-directional associations need one side as <literal>inverse</literal>. In a one-to-many association it has to be the many-side, in many-to-many association you can pick either side, there! is no difference." +#. Tag: para +#: tutorial.xml:822 +#, no-c-format +msgid "" +"What about the <literal>inverse</literal> mapping attribute? For you, and " +"for Java, a bi-directional link is simply a matter of setting the references " +"on both sides correctly. Hibernate however doesn't have enough information " +"to correctly arrange SQL <literal>INSERT</literal> and <literal>UPDATE</" +"literal> statements (to avoid constraint violations), and needs some help to " +"handle bi-directional associations properly. Making one side of the " +"association <literal>inverse</literal> tells Hibernate to basically ignore " +"it, to consider it a <emphasis>mirror</emphasis> of the other side. That's " +"all that is necessary for Hibernate to work out all of the issues when " +"transformation a directional navigation model to a SQL database schema. The " +"rules you have to remember are straightforward: All bi-directional " +"associations need one side as <literal>inverse</literal>. In a one-to-many " +"association it has to be the many-side, in many-to-many association you can " +"pick either side, there is no difference." msgstr "" +"E sobre o mapeamento do atributo <literal>inverse</literal>? Pra você, e " +"para o Java, um link bidirecional é simplesmente o fato de ajustar " +"corretamente as referências de ambos os lados. O Hibernate, entretanto não " +"possui informação necessária para corretamente adaptar os estados " +"<literal>INSERT</literal> e <literal>UPDATE</literal> do SQL, e precisa de " +"ajuda para manipular as propriedades das associações bidirecionais. Fazer um " +"lado da associação com o atributo <literal>inverse</literal> instrui o " +"Hibernate para basicamente ignora-lo, considerando-o uma <emphasis>cópia</" +"emphasis> do outro lado. Isso é todo o necessário para o Hibernate trabalhar " +"com todas as possibilidades quando transformando um modelo de navegação " +"bidirecional em esquema de banco de dados do SQL. As regras que você possui " +"para lembrar são diretas: Todas associações bidirecionais necessitam que um " +"lado possua o atributo inverse. Em uma associação de um-para-muitos, o lado " +"de \"muitos\" deve conter o atributo <literal>inverse</literal>, já em uma " +"associação de muitos-para-muitos você pode pegar qualquer lado, não há " +"diferença." -#: index.docbook:837 +#. Tag: para +#: tutorial.xml:837 +#, no-c-format msgid "Let's turn this into a small web application." msgstr "" +"Agora, vamos portar este exemplo para um pequeno aplicativo para internet." -#: index.docbook:844 +#. Tag: title +#: tutorial.xml:844 +#, no-c-format msgid "Part 3 - The EventManager web application" -msgstr "" +msgstr "EventManager um aplicativo para internet" -#: index.docbook:846 -msgid "A Hibernate web application uses <literal>Session</literal> and <literal>Transaction</literal> almost like a standalone application. However, some common patterns are useful. We now write an <literal>EventManagerServlet</literal>. This servlet can list all events stored in the database, and it provides an HTML form to enter new events." +#. Tag: para +#: tutorial.xml:846 +#, no-c-format +msgid "" +"A Hibernate web application uses <literal>Session</literal> and " +"<literal>Transaction</literal> almost like a standalone application. " +"However, some common patterns are useful. We now write an " +"<literal>EventManagerServlet</literal>. This servlet can list all events " +"stored in the database, and it provides an HTML form to enter new events." msgstr "" +"Um aplicativo para internet do Hibernate usa uma <literal>Session</literal> " +"e uma <literal>Transaction</literal> quase do mesmo modo que um aplicativo " +"standalone. Entretanto, alguns patterns comuns são úteis. Nós agora " +"criaremos um <literal>EventManagerServlet</literal>. Esse servlet lista " +"todos os eventos salvos no banco de dados, e cria um formulário HTML para " +"entrada de novos eventos." -#: index.docbook:854 +#. Tag: title +#: tutorial.xml:854 +#, no-c-format msgid "Writing the basic servlet" -msgstr "" +msgstr "Criando um servlet básico" -#: index.docbook:856 -msgid "Create a new class in your source directory, in the <literal>events</literal> package:" +#. Tag: para +#: tutorial.xml:856 +#, no-c-format +msgid "" +"Create a new class in your source directory, in the <literal>events</" +"literal> package:" msgstr "" +"Crie uma nova classe no seu diretório fonte, no pacote <literal>events</" +"literal>:" -#: index.docbook:861 +#. Tag: programlisting +#: tutorial.xml:861 +#, no-c-format msgid "" - "<![CDATA[package events;\n" - "\n" - "// Imports\n" - "\n" - "public class EventManagerServlet extends HttpServlet {\n" - "\n" - " // Servlet code\n" - "}]]>" +"<![CDATA[package events;\n" +"\n" +"// Imports\n" +"\n" +"public class EventManagerServlet extends HttpServlet {\n" +"\n" +" // Servlet code\n" +"}]]>" msgstr "" -#: index.docbook:863 -msgid "The servlet handles HTTP <literal>GET</literal> requests only, hence, the method we implement is <literal>doGet()</literal>:" +#. Tag: para +#: tutorial.xml:863 +#, no-c-format +msgid "" +"The servlet handles HTTP <literal>GET</literal> requests only, hence, the " +"method we implement is <literal>doGet()</literal>:" msgstr "" +"O servlet manuseia somente requisições <literal>GET</literal> do HTTP, " +"portanto o método que iremos implementar é <literal>doGet()</literal>:" -#: index.docbook:868 +#. Tag: programlisting +#: tutorial.xml:868 +#, no-c-format msgid "" - "<![CDATA[protected void doGet(HttpServletRequest request,\n" - " HttpServletResponse response)\n" - " throws ServletException, IOException {\n" - "\n" - " SimpleDateFormat dateFormatter = new SimpleDateFormat(\"dd.MM.yyyy\");\n" - "\n" - " try {\n" - " // Begin unit of work\n" - " HibernateUtil.getSessionFactory()\n" - " .getCurrentSession().beginTransaction();\n" - "\n" - " // Process request and render page...\n" - "\n" - " // End unit of work\n" - " HibernateUtil.getSessionFactory()\n" - " .getCurrentSession().getTransaction().commit();\n" - "\n" - " } catch (Exception ex) {\n" - " HibernateUtil.getSessionFactory()\n" - " .getCurrentSession().getTransaction().rollback();\n" - " throw new ServletException(ex);\n" - " }\n" - "\n" - "}]]>" +"<![CDATA[protected void doGet(HttpServletRequest request,\n" +" HttpServletResponse response)\n" +" throws ServletException, IOException {\n" +"\n" +" SimpleDateFormat dateFormatter = new SimpleDateFormat(\"dd.MM.yyyy\");\n" +"\n" +" try {\n" +" // Begin unit of work\n" +" HibernateUtil.getSessionFactory()\n" +" .getCurrentSession().beginTransaction();\n" +"\n" +" // Process request and render page...\n" +"\n" +" // End unit of work\n" +" HibernateUtil.getSessionFactory()\n" +" .getCurrentSession().getTransaction().commit();\n" +"\n" +" } catch (Exception ex) {\n" +" HibernateUtil.getSessionFactory()\n" +" .getCurrentSession().getTransaction().rollback();\n" +" throw new ServletException(ex);\n" +" }\n" +"\n" +"}]]>" msgstr "" -#: index.docbook:870 -msgid "The pattern we are applying here is called <emphasis>session-per-request</emphasis>. When a request hits the servlet, a new Hibernate <literal>Session</literal> is opened through the first call to <literal>getCurrentSession()</literal> on the <literal>SessionFactory</literal>. Then a database transaction is started—all data access as to occur inside a transaction, no matter if data is read or written (we don't use the auto-commit mode in applications)." +#. Tag: para +#: tutorial.xml:870 +#, fuzzy, no-c-format +msgid "" +"The pattern we are applying here is called <emphasis>session-per-request</" +"emphasis>. When a request hits the servlet, a new Hibernate " +"<literal>Session</literal> is opened through the first call to " +"<literal>getCurrentSession()</literal> on the <literal>SessionFactory</" +"literal>. Then a database transaction is started—all data access as to " +"occur inside a transaction, no matter if data is read or written (we don't " +"use the auto-commit mode in applications)." msgstr "" +"O pattern que estamos aplicando neste código é chamado <emphasis>session-per-" +"request</emphasis>. Quando uma requisição chega ao servlet, uma nova " +"<literal>Session</literal> do Hibernate é aberta através da primeira chamada " +"para <literal>getCurrentSession()</literal> em <literal>SessionFactory</" +"literal>. Então uma transação do banco de dados é inicializada - todo acesso " +"a dados deve ocorrer dentro de uma transação, não importando se o dado é de " +"leitura ou escrita. (nós não devemos usar o modo auto-commit em aplicações)." -#: index.docbook:879 -msgid "Do <emphasis>not</emphasis> use a new Hibernate <literal>Session</literal> for every database operation. Use one Hibernate <literal>Session</literal> that is scoped to the whole request. Use <literal>getCurrentSession()</literal>, so that it is automatically bound to the current Java thread." +#. Tag: para +#: tutorial.xml:879 +#, no-c-format +msgid "" +"Do <emphasis>not</emphasis> use a new Hibernate <literal>Session</literal> " +"for every database operation. Use one Hibernate <literal>Session</literal> " +"that is scoped to the whole request. Use <literal>getCurrentSession()</" +"literal>, so that it is automatically bound to the current Java thread." msgstr "" +"Do <emphasis>not</emphasis> use a new Hibernate <literal>Session</literal> " +"for every database operation. Use one Hibernate <literal>Session</literal> " +"that is scoped to the whole request. Use <literal>getCurrentSession()</" +"literal>, so that it is automatically bound to the current Java thread." -#: index.docbook:886 -msgid "Next, the possible actions of the request are processed and the response HTML is rendered. We'll get to that part soon." +#. Tag: para +#: tutorial.xml:886 +#, no-c-format +msgid "" +"Next, the possible actions of the request are processed and the response " +"HTML is rendered. We'll get to that part soon." msgstr "" +"Agora, as possibilidades de ações de uma requisição serão processadas e uma " +"resposta HTML será renderizada. Nós já iremos chegar nesta parte." -#: index.docbook:891 -msgid "Finally, the unit of work ends when processing and rendering is complete. If any problem occured during processing or rendering, an exception will be thrown and the database transaction rolled back. This completes the <literal>session-per-request</literal> pattern. Instead of the transaction demarcation code in every servlet you could also write a servlet filter. See the Hibernate website and Wiki for more information about this pattern, called <emphasis>Open Session in View</emphasis>—you'll need it as soon as you consider rendering your view in JSP, not in a servlet." +#. Tag: para +#: tutorial.xml:891 +#, fuzzy, no-c-format +msgid "" +"Finally, the unit of work ends when processing and rendering is complete. If " +"any problem occured during processing or rendering, an exception will be " +"thrown and the database transaction rolled back. This completes the " +"<literal>session-per-request</literal> pattern. Instead of the transaction " +"demarcation code in every servlet you could also write a servlet filter. See " +"the Hibernate website and Wiki for more information about this pattern, " +"called <emphasis>Open Session in View</emphasis>—you'll need it as " +"soon as you consider rendering your view in JSP, not in a servlet." msgstr "" +"Finalmente, a unidade de trabalho termina quando o processamento e a " +"restituição são completados. Se ocorrer algum erro durante o processamento " +"ou a restituição, uma exceção será lançada e a transação do banco de dados " +"encerrada. Isso completa o pattern <literal>session-per-request</literal>. " +"Em vez de usar código de demarcação de transação em todo servlet você pode " +"também criar um filtro servlet. Dê uma olhada no site do Hibernate e do Wiki " +"para maiores informações sobre esse pattern, chamado <emphasis>Open Session " +"in View</emphasis>." -#: index.docbook:905 +#. Tag: title +#: tutorial.xml:905 +#, no-c-format msgid "Processing and rendering" -msgstr "" +msgstr "Processando e renderizando" -#: index.docbook:907 -msgid "Let's implement the processing of the request and rendering of the page." +#. Tag: para +#: tutorial.xml:907 +#, no-c-format +msgid "" +"Let's implement the processing of the request and rendering of the page." msgstr "" +"Vamos implementar o processamento da requisição e a restituição da página " +"HTML." -#: index.docbook:911 +#. Tag: programlisting +#: tutorial.xml:911 +#, no-c-format msgid "" - "<![CDATA[// Write HTML header\n" - "PrintWriter out = response.getWriter();\n" - "out.println(\"<html><head><title>Event Manager</title></head><body>\");\n" - "\n" - "// Handle actions\n" - "if ( \"store\".equals(request.getParameter(\"action\")) ) {\n" - "\n" - " String eventTitle = request.getParameter(\"eventTitle\");\n" - " String eventDate = request.getParameter(\"eventDate\");\n" - "\n" - " if ( \"\".equals(eventTitle) || \"\".equals(eventDate) ) {\n" - " out.println(\"<b><i>Please enter event title and date.</i></b>\");\n" - " } else {\n" - " createAndStoreEvent(eventTitle, dateFormatter.parse(eventDate));\n" - " out.println(\"<b><i>Added event.</i></b>\");\n" - " }\n" - "}\n" - "\n" - "// Print page\n" - "printEventForm(out);\n" - "listEvents(out, dateFormatter);\n" - "\n" - "// Write HTML footer\n" - "out.println(\"</body></html>\");\n" - "out.flush();\n" - "out.close();]]>" +"<![CDATA[// Write HTML header\n" +"PrintWriter out = response.getWriter();\n" +"out.println(\"<html><head><title>Event Manager</title></head><body>\");\n" +"\n" +"// Handle actions\n" +"if ( \"store\".equals(request.getParameter(\"action\")) ) {\n" +"\n" +" String eventTitle = request.getParameter(\"eventTitle\");\n" +" String eventDate = request.getParameter(\"eventDate\");\n" +"\n" +" if ( \"\".equals(eventTitle) || \"\".equals(eventDate) ) {\n" +" out.println(\"<b><i>Please enter event title and date.</i></b>\");\n" +" } else {\n" +" createAndStoreEvent(eventTitle, dateFormatter.parse(eventDate));\n" +" out.println(\"<b><i>Added event.</i></b>\");\n" +" }\n" +"}\n" +"\n" +"// Print page\n" +"printEventForm(out);\n" +"listEvents(out, dateFormatter);\n" +"\n" +"// Write HTML footer\n" +"out.println(\"</body></html>\");\n" +"out.flush();\n" +"out.close();]]>" msgstr "" -#: index.docbook:913 -msgid "Granted, this coding style with a mix of Java and HTML would not scale in a more complex application—keep in mind that we are only illustrating basic Hibernate concepts in this tutorial. The code prints an HTML header and a footer. Inside this page, an HTML form for event entry and a list of all events in the database are printed. The first method is trivial and only outputs HTML:" +#. Tag: para +#: tutorial.xml:913 +#, fuzzy, no-c-format +msgid "" +"Granted, this coding style with a mix of Java and HTML would not scale in a " +"more complex application—keep in mind that we are only illustrating " +"basic Hibernate concepts in this tutorial. The code prints an HTML header " +"and a footer. Inside this page, an HTML form for event entry and a list of " +"all events in the database are printed. The first method is trivial and only " +"outputs HTML:" msgstr "" +"O estilo de código acima, misturando linguagem HTML e Java não será " +"funcional em um aplicativo mais complexo—tenha em mente que neste " +"manual nós estamos apenas ilustrando conceitos básicos do Hibernate. O " +"código imprime um cabeçalho HTML e um rodapé. Dentro desta página, é " +"mostrado um formulário em HTML, para entrada de novos eventos, e uma lista " +"de todos os eventos contidos no banco de dados. O primeiro método é trivial " +"e apenas imprime uma página HTML:" -#: index.docbook:922 +#. Tag: programlisting +#: tutorial.xml:922 +#, no-c-format msgid "" - "<![CDATA[private void printEventForm(PrintWriter out) {\n" - " out.println(\"<h2>Add new event:</h2>\");\n" - " out.println(\"<form>\");\n" - " out.println(\"Title: <input name='eventTitle' length='50'/><br/>\");\n" - " out.println(\"Date (e.g. 24.12.2009): <input name='eventDate' length='10'/><br/>\");\n" - " out.println(\"<input type='submit' name='action' value='store'/>\");\n" - " out.println(\"</form>\");\n" - "}]]>" +"<![CDATA[private void printEventForm(PrintWriter out) {\n" +" out.println(\"<h2>Add new event:</h2>\");\n" +" out.println(\"<form>\");\n" +" out.println(\"Title: <input name='eventTitle' length='50'/><br/>\");\n" +" out.println(\"Date (e.g. 24.12.2009): <input name='eventDate' " +"length='10'/><br/>\");\n" +" out.println(\"<input type='submit' name='action' value='store'/>\");\n" +" out.println(\"</form>\");\n" +"}]]>" msgstr "" -#: index.docbook:924 -msgid "The <literal>listEvents()</literal> method uses the Hibernate <literal>Session</literal> bound to the current thread to execute a query:" +#. Tag: para +#: tutorial.xml:924 +#, no-c-format +msgid "" +"The <literal>listEvents()</literal> method uses the Hibernate " +"<literal>Session</literal> bound to the current thread to execute a query:" msgstr "" +"O método <literal>listEvents()</literal> usa a <literal>Session</literal> do " +"Hibernate associada a thread atual para executar um query:" -#: index.docbook:930 +#. Tag: programlisting +#: tutorial.xml:930 +#, no-c-format msgid "" - "<![CDATA[private void listEvents(PrintWriter out, SimpleDateFormat dateFormatter) {\n" - "\n" - " List result = HibernateUtil.getSessionFactory()\n" - " .getCurrentSession().createCriteria(Event.class).list();\n" - " if (result.size() > 0) {\n" - " out.println(\"<h2>Events in database:</h2>\");\n" - " out.println(\"<table border='1'>\");\n" - " out.println(\"<tr>\");\n" - " out.println(\"<th>Event title</th>\");\n" - " out.println(\"<th>Event date</th>\");\n" - " out.println(\"</tr>\");\n" - " for (Iterator it = result.iterator(); it.hasNext();) {\n" - " Event event = (Event) it.next();\n" - " out.println(\"<tr>\");\n" - " out.println(\"<td>\" + event.getTitle() + \"</td>\");\n" - " out.println(\"<td>\" + dateFormatter.format(event.getDate()) + \"</td>\");\n" - " out.println(\"</tr>\");\n" - " }\n" - " out.println(\"</table>\");\n" - " }\n" - "}]]>" +"<![CDATA[private void listEvents(PrintWriter out, SimpleDateFormat " +"dateFormatter) {\n" +"\n" +" List result = HibernateUtil.getSessionFactory()\n" +" .getCurrentSession().createCriteria(Event.class).list" +"();\n" +" if (result.size() > 0) {\n" +" out.println(\"<h2>Events in database:</h2>\");\n" +" out.println(\"<table border='1'>\");\n" +" out.println(\"<tr>\");\n" +" out.println(\"<th>Event title</th>\");\n" +" out.println(\"<th>Event date</th>\");\n" +" out.println(\"</tr>\");\n" +" for (Iterator it = result.iterator(); it.hasNext();) {\n" +" Event event = (Event) it.next();\n" +" out.println(\"<tr>\");\n" +" out.println(\"<td>\" + event.getTitle() + \"</td>\");\n" +" out.println(\"<td>\" + dateFormatter.format(event.getDate()) + " +"\"</td>\");\n" +" out.println(\"</tr>\");\n" +" }\n" +" out.println(\"</table>\");\n" +" }\n" +"}]]>" msgstr "" -#: index.docbook:932 -msgid "Finally, the <literal>store</literal> action is dispatched to the <literal>createAndStoreEvent()</literal> method, which also uses the <literal>Session</literal> of the current thread:" +#. Tag: para +#: tutorial.xml:932 +#, no-c-format +msgid "" +"Finally, the <literal>store</literal> action is dispatched to the " +"<literal>createAndStoreEvent()</literal> method, which also uses the " +"<literal>Session</literal> of the current thread:" msgstr "" +"Finalmente, a action <literal>store</literal> é passada pra o método " +"<literal>createAndStoreEvent()</literal>, que também usa a <literal>Session</" +"literal> da thread atual:" -#: index.docbook:938 +#. Tag: programlisting +#: tutorial.xml:938 +#, no-c-format msgid "" - "<![CDATA[protected void createAndStoreEvent(String title, Date theDate) {\n" - " Event theEvent = new Event();\n" - " theEvent.setTitle(title);\n" - " theEvent.setDate(theDate);\n" - "\n" - " HibernateUtil.getSessionFactory()\n" - " .getCurrentSession().save(theEvent);\n" - "}]]>" +"<![CDATA[protected void createAndStoreEvent(String title, Date theDate) {\n" +" Event theEvent = new Event();\n" +" theEvent.setTitle(title);\n" +" theEvent.setDate(theDate);\n" +"\n" +" HibernateUtil.getSessionFactory()\n" +" .getCurrentSession().save(theEvent);\n" +"}]]>" msgstr "" -#: index.docbook:940 -msgid "That's it, the servlet is complete. A request to the servlet will be processed in a single <literal>Session</literal> and <literal>Transaction</literal>. As earlier in the standalone application, Hibernate can automatically bind these ojects to the current thread of execution. This gives you the freedom to layer your code and access the <literal>SessionFactory</literal> in any way you like. Usually you'd use a more sophisticated design and move the data access code into data access objects (the DAO pattern). See the Hibernate Wiki for more examples." +#. Tag: para +#: tutorial.xml:940 +#, no-c-format +msgid "" +"That's it, the servlet is complete. A request to the servlet will be " +"processed in a single <literal>Session</literal> and <literal>Transaction</" +"literal>. As earlier in the standalone application, Hibernate can " +"automatically bind these ojects to the current thread of execution. This " +"gives you the freedom to layer your code and access the " +"<literal>SessionFactory</literal> in any way you like. Usually you'd use a " +"more sophisticated design and move the data access code into data access " +"objects (the DAO pattern). See the Hibernate Wiki for more examples." msgstr "" +"Pronto, o servlet está completo. Uma requisição para o servlet será " +"processada em uma <literal>Session</literal> e uma <literal>Transaction</" +"literal> simples. Como anteriormente, no aplicativo standalone, o Hibernate " +"pode automaticamente associar esses objetos a thread atual em execução. Isso " +"possibilita a liberdade de você modelar seu código e acessar o método " +"<literal>SessionFactory</literal> do jeito que achar melhor. Geralmente você " +"irá usar um design mais sofisticado e mover o código de acesso a dados para " +"dentro de objetos de acesso a dados (o patter DAO). Leia o Hibernate Wiki " +"para maiores exemplos." -#: index.docbook:954 +#. Tag: title +#: tutorial.xml:954 +#, no-c-format msgid "Deploying and testing" -msgstr "" +msgstr "Instalando e testando" -#: index.docbook:956 -msgid "To deploy this application you have to create a web archive, a WAR. Add the following Ant target to your <literal>build.xml</literal>:" +#. Tag: para +#: tutorial.xml:956 +#, no-c-format +msgid "" +"To deploy this application you have to create a web archive, a WAR. Add the " +"following Ant target to your <literal>build.xml</literal>:" msgstr "" +"Para fazer o deploy desta aplicação você tem que criar um arquivo para web, " +"um WAR. Adicione o alvo Ant abaixo em seu <literal>build.xml</literal>:" -#: index.docbook:961 +#. Tag: programlisting +#: tutorial.xml:961 +#, no-c-format msgid "" - "<![CDATA[<target name=\"war\" depends=\"compile\">\n" - " <war destfile=\"hibernate-tutorial.war\" webxml=\"web.xml\">\n" - " <lib dir=\"${librarydir}\">\n" - " <exclude name=\"jsdk*.jar\"/>\n" - " </lib>\n" - "\n" - " <classes dir=\"${targetdir}\"/>\n" - " </war>\n" - "</target>]]>" +"<![CDATA[<target name=\"war\" depends=\"compile\">\n" +" <war destfile=\"hibernate-tutorial.war\" webxml=\"web.xml\">\n" +" <lib dir=\"${librarydir}\">\n" +" <exclude name=\"jsdk*.jar\"/>\n" +" </lib>\n" +"\n" +" <classes dir=\"${targetdir}\"/>\n" +" </war>\n" +"</target>]]>" msgstr "" -#: index.docbook:963 -msgid "This target creates a file called <literal>hibernate-tutorial.war</literal> in your project directory. It packages all libraries and the <literal>web.xml</literal> descriptor, which is expected in the base directory of your project:" +#. Tag: para +#: tutorial.xml:963 +#, no-c-format +msgid "" +"This target creates a file called <literal>hibernate-tutorial.war</literal> " +"in your project directory. It packages all libraries and the <literal>web." +"xml</literal> descriptor, which is expected in the base directory of your " +"project:" msgstr "" +"Esta target cria um arquivo chamado <literal>hibernate-tutorial.war</" +"literal> no diretório do seu projeto. Ele empacota todas as bibliotecas e o " +"arquivo de descrição <literal>web.xml</literal>, o qual é esperado no " +"diretório base do seu projeto:" -#: index.docbook:969 +#. Tag: programlisting +#: tutorial.xml:969 +#, no-c-format msgid "" - "<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" - "<web-app version=\"2.4\"\n" - " xmlns=\"http://java.sun.com/xml/ns/j2ee\"\n" - " xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" - " xsi:schemaLocation=\"http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd\">\n" - "\n" - " <servlet>\n" - " <servlet-name>Event Manager</servlet-name>\n" - " <servlet-class>events.EventManagerServlet</servlet-class>\n" - " </servlet>\n" - "\n" - " <servlet-mapping>\n" - " <servlet-name>Event Manager</servlet-name>\n" - " <url-pattern>/eventmanager</url-pattern>\n" - " </servlet-mapping>\n" - "</web-app>]]>" +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<web-app version=\"2.4\"\n" +" xmlns=\"http://java.sun.com/xml/ns/j2ee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://java.sun.com/xml/ns/j2ee http://java.sun.com/" +"xml/ns/j2ee/web-app_2_4.xsd\">\n" +"\n" +" <servlet>\n" +" <servlet-name>Event Manager</servlet-name>\n" +" <servlet-class>events.EventManagerServlet</servlet-class>\n" +" </servlet>\n" +"\n" +" <servlet-mapping>\n" +" <servlet-name>Event Manager</servlet-name>\n" +" <url-pattern>/eventmanager</url-pattern>\n" +" </servlet-mapping>\n" +"</web-app>]]>" msgstr "" -#: index.docbook:971 -msgid "Before you compile and deploy the web application, note that an additional library is required: <literal>jsdk.jar</literal>. This is the Java servlet development kit, if you don't have this library already, get it from the Sun website and copy it to your library directory. However, it will be only used for compliation and excluded from the WAR package." +#. Tag: para +#: tutorial.xml:971 +#, no-c-format +msgid "" +"Before you compile and deploy the web application, note that an additional " +"library is required: <literal>jsdk.jar</literal>. This is the Java servlet " +"development kit, if you don't have this library already, get it from the Sun " +"website and copy it to your library directory. However, it will be only used " +"for compliation and excluded from the WAR package." msgstr "" +"Antes de você compilar e fazer o deploy desta aplicação web, note que uma " +"biblioteca adicional é requerida: <literal>jsdk.jar</literal>. Esse é o Java " +"servlet development kit, se você não possui esta biblioteca, faça seu " +"download na página da Sun e copie-a para seu diretório de bibliotecas. " +"Entretanto, será usado somente para a compilação e excluído do pacote WAR." -#: index.docbook:979 -msgid "To build and deploy call <literal>ant war</literal> in your project directory and copy the <literal>hibernate-tutorial.war</literal> file into your Tomcat <literal>webapp</literal> directory. If you don't have Tomcat installed, download it and follow the installation instructions. You don't have to change any Tomcat configuration to deploy this application though." +#. Tag: para +#: tutorial.xml:979 +#, no-c-format +msgid "" +"To build and deploy call <literal>ant war</literal> in your project " +"directory and copy the <literal>hibernate-tutorial.war</literal> file into " +"your Tomcat <literal>webapp</literal> directory. If you don't have Tomcat " +"installed, download it and follow the installation instructions. You don't " +"have to change any Tomcat configuration to deploy this application though." msgstr "" +"Para compilar e instalar execute <literal>ant war</literal> no seu diretório " +"do projeto e copie o arquivo <literal>hibernate-tutorial.war</literal> para " +"o diretório <literal>webapp</literal> do Tomcat. Se você não possui o Tomcat " +"instalado faça o download e siga as instruções de instalação. Você não " +"precisa modificar nenhuma configuração do Tomcat para rodar este aplicativo." -#: index.docbook:987 -msgid "Once deployed and Tomcat is running, access the application at <literal>http://localhost:8080/hibernate-tutorial/eventmanager</literal>. Make sure you watch the Tomcat log to see Hibernate initialize when the first request hits your servlet (the static initializer in <literal>HibernateUtil</literal> is called) and to get the detailed output if any exceptions occurs." +#. Tag: para +#: tutorial.xml:987 +#, no-c-format +msgid "" +"Once deployed and Tomcat is running, access the application at " +"<literal>http://localhost:8080/hibernate-tutorial/eventmanager</literal>. " +"Make sure you watch the Tomcat log to see Hibernate initialize when the " +"first request hits your servlet (the static initializer in " +"<literal>HibernateUtil</literal> is called) and to get the detailed output " +"if any exceptions occurs." msgstr "" +"Uma vez feito o deploy e com Tomcat rodando, acesse o aplicativo em " +"<literal>http://localhost:8080/hibernate-tutorial/eventmanager</literal>. " +"Veja o log do Tomcat para observar a inicialização do Hibernate quando a " +"primeira requisição chega ao servlet (o inicializador estático dentro de " +"<literal>HibernateUtil</literal> é chamado) e para ter uma depuração " +"detalhada se ocorrer alguma exceção." -#: index.docbook:1000 +#. Tag: title +#: tutorial.xml:1000 +#, no-c-format msgid "Summary" -msgstr "" +msgstr "Sumário" -#: index.docbook:1002 -msgid "This tutorial covered the basics of writing a simple standalone Hibernate application and a small web application." +#. Tag: para +#: tutorial.xml:1002 +#, no-c-format +msgid "" +"This tutorial covered the basics of writing a simple standalone Hibernate " +"application and a small web application." msgstr "" +"Este manual cobriu os princípios básicos para criação de uma aplicação " +"simples do Hibernate e uma pequena aplicação web." -#: index.docbook:1007 -msgid "If you already feel confident with Hibernate, continue browsing through the reference documentation table of contents for topics you find interesting - most asked are transactional processing (<xref linkend=\"transactions\"/>), fetch performance (<xref linkend=\"performance\"/>), or the usage of the API (<xref linkend=\"objectstate\"/>) and the query features (<xref linkend=\"objectstate-querying\"/>)." +#. Tag: para +#: tutorial.xml:1007 +#, no-c-format +msgid "" +"If you already feel confident with Hibernate, continue browsing through the " +"reference documentation table of contents for topics you find interesting - " +"most asked are transactional processing (<xref linkend=\"transactions\"/>), " +"fetch performance (<xref linkend=\"performance\"/>), or the usage of the API " +"(<xref linkend=\"objectstate\"/>) and the query features (<xref linkend=" +"\"objectstate-querying\"/>)." msgstr "" +"Se você já se sente seguro com o Hibernate, continue navegando na " +"documentação de referência por tópicos que você acha interessante – os " +"tópicos mais questionados são: processo de transação (<xref linkend=" +"\"transactions\"/>), uso da API (<xref linkend=\"objectstate\"/>) e " +"características de consulta (<xref linkend=\"objectstate-querying\"/>)." -#: index.docbook:1015 -msgid "Don't forget to check the Hibernate website for more (specialized) tutorials." +#. Tag: para +#: tutorial.xml:1015 +#, no-c-format +msgid "" +"Don't forget to check the Hibernate website for more (specialized) tutorials." msgstr "" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "" - +"Não esqueça de visitar o site do Hibernate para obter mais tutoriais " +"especializados." Modified: core/trunk/documentation/manual/translations/pt-BR/content/xml.po =================================================================== --- core/trunk/documentation/manual/translations/pt-BR/content/xml.po 2007-10-25 22:34:46 UTC (rev 14134) +++ core/trunk/documentation/manual/translations/pt-BR/content/xml.po 2007-10-26 00:46:38 UTC (rev 14135) @@ -1,284 +1,456 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:48+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: xml.xml:5 +#, no-c-format msgid "XML Mapping" -msgstr "" +msgstr "Mapeamento XML" -#: index.docbook:7 -msgid "Note that this is an experimental feature in Hibernate 3.0 and is under extremely active development." +#. Tag: emphasis +#: xml.xml:7 +#, no-c-format +msgid "" +"Note that this is an experimental feature in Hibernate 3.0 and is under " +"extremely active development." msgstr "" +"Note that this is an experimental feature in Hibernate 3.0 and is under " +"extremely active development. Veja que essa é uma feature experimental no " +"Hibernate 3.0 e o desenvolvimento esta bastante ativo." -#: index.docbook:13 +#. Tag: title +#: xml.xml:13 +#, no-c-format msgid "Working with XML data" -msgstr "" +msgstr "Trabalhando com dados em XML" -#: index.docbook:15 -msgid "Hibernate lets you work with persistent XML data in much the same way you work with persistent POJOs. A parsed XML tree can be thought of as just another way to represent the relational data at the object level, instead of POJOs." +#. Tag: para +#: xml.xml:15 +#, no-c-format +msgid "" +"Hibernate lets you work with persistent XML data in much the same way you " +"work with persistent POJOs. A parsed XML tree can be thought of as just " +"another way to represent the relational data at the object level, instead of " +"POJOs." msgstr "" +"O Hibernate permite que se trabalhe com dados persistentes em XML quase da " +"mesma maneira como você trabalhar com POJOs persistentes. Uma árvore XML " +"parseada, pode ser imaginada como apenas uma maneira de representar os dados " +"relacionais como objetos, ao invés dos POJOs." -#: index.docbook:22 -msgid "Hibernate supports dom4j as API for manipulating XML trees. You can write queries that retrieve dom4j trees from the database and have any modification you make to the tree automatically synchronized to the database. You can even take an XML document, parse it using dom4j, and write it to the database with any of Hibernate's basic operations: <literal>persist(), saveOrUpdate(), merge(), delete(), replicate()</literal> (merging is not yet supported)." +#. Tag: para +#: xml.xml:22 +#, no-c-format +msgid "" +"Hibernate supports dom4j as API for manipulating XML trees. You can write " +"queries that retrieve dom4j trees from the database and have any " +"modification you make to the tree automatically synchronized to the " +"database. You can even take an XML document, parse it using dom4j, and write " +"it to the database with any of Hibernate's basic operations: <literal>persist" +"(), saveOrUpdate(), merge(), delete(), replicate()</literal> (merging is not " +"yet supported)." msgstr "" +"O Hibernate suporta a API dom4j para manipular árvores XML. Você pode " +"escrever queries que retornem árvores dom4j do banco de dados e " +"automaticamente sincronizar com o banco de dados qualquer modificação feita " +"nessas árvores. Você pode até mesmo pegar um documento XML, parsear usando o " +"dom4j, e escrever as alterações no banco de dados usando quaisquer operações " +"básicas do Hibernate: <literal>persist(), saveOrUpdate(),merge(), delete(), " +"replicate()</literal> (merging ainda não é suportado)" -#: index.docbook:32 -msgid "This feature has many applications including data import/export, externalization of entity data via JMS or SOAP and XSLT-based reporting." +#. Tag: para +#: xml.xml:32 +#, no-c-format +msgid "" +"This feature has many applications including data import/export, " +"externalization of entity data via JMS or SOAP and XSLT-based reporting." msgstr "" +"Essa funcionalidade tem várias aplicações incluindo importação/exportação de " +"dados, externalização de dados de entidade via JMS or SOAP e relatórios " +"usando XSLT." -#: index.docbook:37 -msgid "A single mapping may be used to simultaneously map properties of a class and nodes of an XML document to the database, or, if there is no class to map, it may be used to map just the XML." +#. Tag: para +#: xml.xml:37 +#, no-c-format +msgid "" +"A single mapping may be used to simultaneously map properties of a class and " +"nodes of an XML document to the database, or, if there is no class to map, " +"it may be used to map just the XML." msgstr "" +"Um mapeamento simples pode ser usado para simultaneamente mapear " +"propriedades da classe e nós de um documento XML para um banco de dados ou, " +"se não houver classe para mapear, pode ser usado simplesmente para mapear o " +"XML." -#: index.docbook:44 +#. Tag: title +#: xml.xml:44 +#, no-c-format msgid "Specifying XML and class mapping together" msgstr "" +"Especificando o mapeamento de uma classe e de um arquivo XML simultaneamente" -#: index.docbook:46 +#. Tag: para +#: xml.xml:46 +#, no-c-format msgid "Here is an example of mapping a POJO and XML simultaneously:" -msgstr "" +msgstr "Segue um exemplo de como mapear um POJO e um XML ao mesmo tempo:" -#: index.docbook:50 +#. Tag: programlisting +#: xml.xml:50 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Account\" \n" - " table=\"ACCOUNTS\" \n" - " node=\"account\">\n" - " \n" - " <id name=\"accountId\" \n" - " column=\"ACCOUNT_ID\" \n" - " node=\"@id\"/>\n" - " \n" - " <many-to-one name=\"customer\" \n" - " column=\"CUSTOMER_ID\" \n" - " node=\"customer/@id\" \n" - " embed-xml=\"false\"/>\n" - " \n" - " <property name=\"balance\" \n" - " column=\"BALANCE\" \n" - " node=\"balance\"/>\n" - " \n" - " ...\n" - " \n" - "</class>]]>" +"<![CDATA[<class name=\"Account\" \n" +" table=\"ACCOUNTS\" \n" +" node=\"account\">\n" +" \n" +" <id name=\"accountId\" \n" +" column=\"ACCOUNT_ID\" \n" +" node=\"@id\"/>\n" +" \n" +" <many-to-one name=\"customer\" \n" +" column=\"CUSTOMER_ID\" \n" +" node=\"customer/@id\" \n" +" embed-xml=\"false\"/>\n" +" \n" +" <property name=\"balance\" \n" +" column=\"BALANCE\" \n" +" node=\"balance\"/>\n" +" \n" +" ...\n" +" \n" +"</class>]]>" msgstr "" -#: index.docbook:54 +#. Tag: title +#: xml.xml:54 +#, no-c-format msgid "Specifying only an XML mapping" -msgstr "" +msgstr "Especificando somente um mapeamento XML" -#: index.docbook:56 +#. Tag: para +#: xml.xml:56 +#, no-c-format msgid "Here is an example where there is no POJO class:" -msgstr "" +msgstr "Segue um exemplo que não contém uma classe POJO:" -#: index.docbook:60 +#. Tag: programlisting +#: xml.xml:60 +#, no-c-format msgid "" - "<![CDATA[<class entity-name=\"Account\" \n" - " table=\"ACCOUNTS\" \n" - " node=\"account\">\n" - " \n" - " <id name=\"id\" \n" - " column=\"ACCOUNT_ID\" \n" - " node=\"@id\" \n" - " type=\"string\"/>\n" - " \n" - " <many-to-one name=\"customerId\" \n" - " column=\"CUSTOMER_ID\" \n" - " node=\"customer/@id\" \n" - " embed-xml=\"false\" \n" - " entity-name=\"Customer\"/>\n" - " \n" - " <property name=\"balance\" \n" - " column=\"BALANCE\" \n" - " node=\"balance\" \n" - " type=\"big_decimal\"/>\n" - " \n" - " ...\n" - " \n" - "</class>]]>" +"<![CDATA[<class entity-name=\"Account\" \n" +" table=\"ACCOUNTS\" \n" +" node=\"account\">\n" +" \n" +" <id name=\"id\" \n" +" column=\"ACCOUNT_ID\" \n" +" node=\"@id\" \n" +" type=\"string\"/>\n" +" \n" +" <many-to-one name=\"customerId\" \n" +" column=\"CUSTOMER_ID\" \n" +" node=\"customer/@id\" \n" +" embed-xml=\"false\" \n" +" entity-name=\"Customer\"/>\n" +" \n" +" <property name=\"balance\" \n" +" column=\"BALANCE\" \n" +" node=\"balance\" \n" +" type=\"big_decimal\"/>\n" +" \n" +" ...\n" +" \n" +"</class>]]>" msgstr "" -#: index.docbook:62 -msgid "This mapping allows you to access the data as a dom4j tree, or as a graph of property name/value pairs (java <literal>Map</literal>s). The property names are purely logical constructs that may be referred to in HQL queries." +#. Tag: para +#: xml.xml:62 +#, no-c-format +msgid "" +"This mapping allows you to access the data as a dom4j tree, or as a graph of " +"property name/value pairs (java <literal>Map</literal>s). The property names " +"are purely logical constructs that may be referred to in HQL queries." msgstr "" +"Esse mapeamento permite que você acesse os dados como uma árvore dom4j ou um " +"grafo de de pares nome de propriedade/valor (<literal>Map</literal>s do " +"Java). Os nomes de propriedades são somente construções lógicas que podem " +"ser referenciadas em consultas HQL." -#: index.docbook:73 +#. Tag: title +#: xml.xml:73 +#, no-c-format msgid "XML mapping metadata" -msgstr "" +msgstr "Mapeando metadados com XML" -#: index.docbook:75 -msgid "Many Hibernate mapping elements accept the <literal>node</literal> attribute. This let's you specify the name of an XML attribute or element that holds the property or entity data. The format of the <literal>node</literal> attribute must be one of the following:" +#. Tag: para +#: xml.xml:75 +#, no-c-format +msgid "" +"Many Hibernate mapping elements accept the <literal>node</literal> " +"attribute. This let's you specify the name of an XML attribute or element " +"that holds the property or entity data. The format of the <literal>node</" +"literal> attribute must be one of the following:" msgstr "" +"Muitos elementos do mapeamento do Hibernate aceitam o atributo " +"<literal>node</literal>. Por meio dele, você pode especificar o nome de um " +"atributo ou elemento XML que contém a propriedade ou os dados da entidade. O " +"formato do atributo <literal>node</literal> deve ser o seguinte:" -#: index.docbook:84 +#. Tag: para +#: xml.xml:84 +#, no-c-format msgid "<literal>\"element-name\"</literal> - map to the named XML element" msgstr "" +"<literal>\"element-name\"</literal> - mapeia para o elemento XML com " +"determinado nome" -#: index.docbook:87 +#. Tag: para +#: xml.xml:87 +#, no-c-format msgid "<literal>\"@attribute-name\"</literal> - map to the named XML attribute" msgstr "" +"<literal>\"@attribute-name\"</literal> - mapeia para o atributo XML com " +"determinado nome" -#: index.docbook:90 +#. Tag: para +#: xml.xml:90 +#, no-c-format msgid "<literal>\".\"</literal> - map to the parent element" -msgstr "" +msgstr "<literal>\".\"</literal> - mapeia para o elemento pai" -#: index.docbook:93 -msgid "<literal>\"element-name/@attribute-name\"</literal> - map to the named attribute of the named element" +#. Tag: para +#: xml.xml:93 +#, no-c-format +msgid "" +"<literal>\"element-name/@attribute-name\"</literal> - map to the named " +"attribute of the named element" msgstr "" +"<literal>\"element-name/@attribute-name\"</literal> - mapeia para para o " +"atributo com determinado nome do elemento com determinado nome" -#: index.docbook:100 -msgid "For collections and single valued associations, there is an additional <literal>embed-xml</literal> attribute. If <literal>embed-xml=\"true\"</literal>, the default, the XML tree for the associated entity (or collection of value type) will be embedded directly in the XML tree for the entity that owns the association. Otherwise, if <literal>embed-xml=\"false\"</literal>, then only the referenced identifier value will appear in the XML for single point associations and collections will simply not appear at all." +#. Tag: para +#: xml.xml:100 +#, no-c-format +msgid "" +"For collections and single valued associations, there is an additional " +"<literal>embed-xml</literal> attribute. If <literal>embed-xml=\"true\"</" +"literal>, the default, the XML tree for the associated entity (or collection " +"of value type) will be embedded directly in the XML tree for the entity that " +"owns the association. Otherwise, if <literal>embed-xml=\"false\"</literal>, " +"then only the referenced identifier value will appear in the XML for single " +"point associations and collections will simply not appear at all." msgstr "" +"Para coleções e associações simples, existe o atributo adicional " +"<literal>embed-xml</literal>. Se o atributo <literal>embed-xml=\"true\"</" +"literal>, que é o valor padrão, a árvore XML para a entidade associada (ou " +"coleção de determinado tipo de valor) será embutida diretamente na árvore " +"XML que contém a associação. Por outro lado, se <literal>embed-xml=\"false" +"\"</literal>, então apenas o valor do identificador referenciado irá " +"aparecer no XML para associações simples e coleções simplesmentenão irão " +"aparecer." -#: index.docbook:110 -msgid "You should be careful not to leave <literal>embed-xml=\"true\"</literal> for too many associations, since XML does not deal well with circularity!" +#. Tag: para +#: xml.xml:110 +#, no-c-format +msgid "" +"You should be careful not to leave <literal>embed-xml=\"true\"</literal> for " +"too many associations, since XML does not deal well with circularity!" msgstr "" +"Você precisa tomar cuidado em não deixar o<literal>embed-xml=\"true\"</" +"literal> para muitas associações, pois o XML não suporta bem referências " +"circulares." -#: index.docbook:115 +#. Tag: programlisting +#: xml.xml:115 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Customer\" \n" - " table=\"CUSTOMER\" \n" - " node=\"customer\">\n" - " \n" - " <id name=\"id\" \n" - " column=\"CUST_ID\" \n" - " node=\"@id\"/>\n" - " \n" - " <map name=\"accounts\" \n" - " node=\".\" \n" - " embed-xml=\"true\">\n" - " <key column=\"CUSTOMER_ID\" \n" - " not-null=\"true\"/>\n" - " <map-key column=\"SHORT_DESC\" \n" - " node=\"@short-desc\" \n" - " type=\"string\"/>\n" - " <one-to-many entity-name=\"Account\"\n" - " embed-xml=\"false\" \n" - " node=\"account\"/>\n" - " </map>\n" - " \n" - " <component name=\"name\" \n" - " node=\"name\">\n" - " <property name=\"firstName\" \n" - " node=\"first-name\"/>\n" - " <property name=\"initial\" \n" - " node=\"initial\"/>\n" - " <property name=\"lastName\" \n" - " node=\"last-name\"/>\n" - " </component>\n" - " \n" - " ...\n" - " \n" - "</class>]]>" +"<![CDATA[<class name=\"Customer\" \n" +" table=\"CUSTOMER\" \n" +" node=\"customer\">\n" +" \n" +" <id name=\"id\" \n" +" column=\"CUST_ID\" \n" +" node=\"@id\"/>\n" +" \n" +" <map name=\"accounts\" \n" +" node=\".\" \n" +" embed-xml=\"true\">\n" +" <key column=\"CUSTOMER_ID\" \n" +" not-null=\"true\"/>\n" +" <map-key column=\"SHORT_DESC\" \n" +" node=\"@short-desc\" \n" +" type=\"string\"/>\n" +" <one-to-many entity-name=\"Account\"\n" +" embed-xml=\"false\" \n" +" node=\"account\"/>\n" +" </map>\n" +" \n" +" <component name=\"name\" \n" +" node=\"name\">\n" +" <property name=\"firstName\" \n" +" node=\"first-name\"/>\n" +" <property name=\"initial\" \n" +" node=\"initial\"/>\n" +" <property name=\"lastName\" \n" +" node=\"last-name\"/>\n" +" </component>\n" +" \n" +" ...\n" +" \n" +"</class>]]>" msgstr "" -#: index.docbook:117 -msgid "in this case, we have decided to embed the collection of account ids, but not the actual account data. The following HQL query:" +#. Tag: para +#: xml.xml:117 +#, no-c-format +msgid "" +"in this case, we have decided to embed the collection of account ids, but " +"not the actual account data. The following HQL query:" msgstr "" +"Nesse caso, decidimos embutir a colenção de account ids, e não os dados de " +"accounts. A query HQL a seguir:" -#: index.docbook:122 -msgid "<![CDATA[from Customer c left join fetch c.accounts where c.lastName like :lastName]]>" +#. Tag: programlisting +#: xml.xml:122 +#, no-c-format +msgid "" +"<![CDATA[from Customer c left join fetch c.accounts where c.lastName like :" +"lastName]]>" msgstr "" -#: index.docbook:124 +#. Tag: para +#: xml.xml:124 +#, no-c-format msgid "Would return datasets such as this:" -msgstr "" +msgstr "Retornaria um conjunto de dados como esse:" -#: index.docbook:128 +#. Tag: programlisting +#: xml.xml:128 +#, no-c-format msgid "" - "<![CDATA[<customer id=\"123456789\">\n" - " <account short-desc=\"Savings\">987632567</account>\n" - " <account short-desc=\"Credit Card\">985612323</account>\n" - " <name>\n" - " <first-name>Gavin</first-name>\n" - " <initial>A</initial>\n" - " <last-name>King</last-name>\n" - " </name>\n" - " ...\n" - "</customer>]]>" +"<![CDATA[<customer id=\"123456789\">\n" +" <account short-desc=\"Savings\">987632567</account>\n" +" <account short-desc=\"Credit Card\">985612323</account>\n" +" <name>\n" +" <first-name>Gavin</first-name>\n" +" <initial>A</initial>\n" +" <last-name>King</last-name>\n" +" </name>\n" +" ...\n" +"</customer>]]>" msgstr "" -#: index.docbook:130 -msgid "If you set <literal>embed-xml=\"true\"</literal> on the <literal><one-to-many></literal> mapping, the data might look more like this:" +#. Tag: para +#: xml.xml:130 +#, no-c-format +msgid "" +"If you set <literal>embed-xml=\"true\"</literal> on the <literal><one-to-" +"many></literal> mapping, the data might look more like this:" msgstr "" +"Se você setar <literal>embed-xml=\"true\"</literal> em um mapeamento " +"<literal><one-to-many></literal>, os dados se pareceriam com o " +"seguinte:" -#: index.docbook:135 +#. Tag: programlisting +#: xml.xml:135 +#, no-c-format msgid "" - "<![CDATA[<customer id=\"123456789\">\n" - " <account id=\"987632567\" short-desc=\"Savings\">\n" - " <customer id=\"123456789\"/>\n" - " <balance>100.29</balance>\n" - " </account>\n" - " <account id=\"985612323\" short-desc=\"Credit Card\">\n" - " <customer id=\"123456789\"/>\n" - " <balance>-2370.34</balance>\n" - " </account>\n" - " <name>\n" - " <first-name>Gavin</first-name>\n" - " <initial>A</initial>\n" - " <last-name>King</last-name>\n" - " </name>\n" - " ...\n" - "</customer>]]>" +"<![CDATA[<customer id=\"123456789\">\n" +" <account id=\"987632567\" short-desc=\"Savings\">\n" +" <customer id=\"123456789\"/>\n" +" <balance>100.29</balance>\n" +" </account>\n" +" <account id=\"985612323\" short-desc=\"Credit Card\">\n" +" <customer id=\"123456789\"/>\n" +" <balance>-2370.34</balance>\n" +" </account>\n" +" <name>\n" +" <first-name>Gavin</first-name>\n" +" <initial>A</initial>\n" +" <last-name>King</last-name>\n" +" </name>\n" +" ...\n" +"</customer>]]>" msgstr "" -#: index.docbook:141 +#. Tag: title +#: xml.xml:141 +#, no-c-format msgid "Manipulating XML data" -msgstr "" +msgstr "Manipulando dados em XML" -#: index.docbook:143 -msgid "Let's rearead and update XML documents in the application. We do this by obtaining a dom4j session:" +#. Tag: para +#: xml.xml:143 +#, no-c-format +msgid "" +"Let's rearead and update XML documents in the application. We do this by " +"obtaining a dom4j session:" msgstr "" +"Vamos reler e atualizar documentos em XML em nossa aplicação. Nós fazemos " +"isso obtendo uma session do dom4j:" -#: index.docbook:148 +#. Tag: programlisting +#: xml.xml:148 +#, no-c-format msgid "" - "<![CDATA[Document doc = ....;\n" - " \n" - "Session session = factory.openSession();\n" - "Session dom4jSession = session.getSession(EntityMode.DOM4J);\n" - "Transaction tx = session.beginTransaction();\n" - "\n" - "List results = dom4jSession\n" - " .createQuery(\"from Customer c left join fetch c.accounts where c.lastName like :lastName\")\n" - " .list();\n" - "for ( int i=0; i<results.size(); i++ ) {\n" - " //add the customer data to the XML document\n" - " Element customer = (Element) results.get(i);\n" - " doc.add(customer);\n" - "}\n" - "\n" - "tx.commit();\n" - "session.close();]]>" +"<![CDATA[Document doc = ....;\n" +" \n" +"Session session = factory.openSession();\n" +"Session dom4jSession = session.getSession(EntityMode.DOM4J);\n" +"Transaction tx = session.beginTransaction();\n" +"\n" +"List results = dom4jSession\n" +" .createQuery(\"from Customer c left join fetch c.accounts where c." +"lastName like :lastName\")\n" +" .list();\n" +"for ( int i=0; i<results.size(); i++ ) {\n" +" //add the customer data to the XML document\n" +" Element customer = (Element) results.get(i);\n" +" doc.add(customer);\n" +"}\n" +"\n" +"tx.commit();\n" +"session.close();]]>" msgstr "" -#: index.docbook:150 +#. Tag: programlisting +#: xml.xml:150 +#, no-c-format msgid "" - "<![CDATA[Session session = factory.openSession();\n" - "Session dom4jSession = session.getSession(EntityMode.DOM4J);\n" - "Transaction tx = session.beginTransaction();\n" - "\n" - "Element cust = (Element) dom4jSession.get(\"Customer\", customerId);\n" - "for ( int i=0; i<results.size(); i++ ) {\n" - " Element customer = (Element) results.get(i);\n" - " //change the customer name in the XML and database\n" - " Element name = customer.element(\"name\");\n" - " name.element(\"first-name\").setText(firstName);\n" - " name.element(\"initial\").setText(initial);\n" - " name.element(\"last-name\").setText(lastName);\n" - "}\n" - "\n" - "tx.commit();\n" - "session.close();]]>" +"<![CDATA[Session session = factory.openSession();\n" +"Session dom4jSession = session.getSession(EntityMode.DOM4J);\n" +"Transaction tx = session.beginTransaction();\n" +"\n" +"Element cust = (Element) dom4jSession.get(\"Customer\", customerId);\n" +"for ( int i=0; i<results.size(); i++ ) {\n" +" Element customer = (Element) results.get(i);\n" +" //change the customer name in the XML and database\n" +" Element name = customer.element(\"name\");\n" +" name.element(\"first-name\").setText(firstName);\n" +" name.element(\"initial\").setText(initial);\n" +" name.element(\"last-name\").setText(lastName);\n" +"}\n" +"\n" +"tx.commit();\n" +"session.close();]]>" msgstr "" -#: index.docbook:152 -msgid "It is extremely useful to combine this feature with Hibernate's <literal>replicate()</literal> operation to implement XML-based data import/export." +#. Tag: para +#: xml.xml:152 +#, no-c-format +msgid "" +"It is extremely useful to combine this feature with Hibernate's " +"<literal>replicate()</literal> operation to implement XML-based data import/" +"export." msgstr "" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "" - +"É extremamente útil combinar essa funcionalidade com a operação " +"<literal>replicate()</literal> do Hibernate para implementar importação/" +"exportação baseadas em XML."

18 years, 3 months

1
0
0 / 0

Hibernate SVN: r14134 - jpa-api/trunk/src/javax/persistence.

by hibernate-commits＠lists.jboss.org

Author: epbernard Date: 2007-10-25 18:34:46 -0400 (Thu, 25 Oct 2007) New Revision: 14134 Modified: jpa-api/trunk/src/javax/persistence/Persistence.java Log: EJB-321 add typo to complain to the faulty TCK. Year I know, lame... Modified: jpa-api/trunk/src/javax/persistence/Persistence.java =================================================================== --- jpa-api/trunk/src/javax/persistence/Persistence.java 2007-10-25 13:57:58 UTC (rev 14133) +++ jpa-api/trunk/src/javax/persistence/Persistence.java 2007-10-25 22:34:46 UTC (rev 14134) @@ -19,7 +19,8 @@ */ public class Persistence { - public static final String PERSISTENCE_PROVIDER = PersistenceProvider.class.getName(); + //typo intended because it leaked into the JPA 1 spec. Do not use this constant. + public static final java.lang.String PERSISTENCE_PROVIDER = "javax.persistence.spi.PeristenceProvider"; protected static final Set<PersistenceProvider> providers = new HashSet<PersistenceProvider>();

18 years, 3 months

1
0
0 / 0

Hibernate SVN: r14133 - core/branches/Branch_3_2/src/org/hibernate/stat.

by hibernate-commits＠lists.jboss.org

Author: scottmarlownovell Date: 2007-10-25 09:57:58 -0400 (Thu, 25 Oct 2007) New Revision: 14133 Modified: core/branches/Branch_3_2/src/org/hibernate/stat/StatisticsImplementor.java Log: remove todo for adding beginTransaction as it probably wont happen. Modified: core/branches/Branch_3_2/src/org/hibernate/stat/StatisticsImplementor.java =================================================================== --- core/branches/Branch_3_2/src/org/hibernate/stat/StatisticsImplementor.java 2007-10-25 07:57:28 UTC (rev 14132) +++ core/branches/Branch_3_2/src/org/hibernate/stat/StatisticsImplementor.java 2007-10-25 13:57:58 UTC (rev 14133) @@ -28,7 +28,7 @@ public void queryCacheHit(String hql, String regionName); public void queryCacheMiss(String hql, String regionName); public void queryCachePut(String hql, String regionName); - public void endTransaction(boolean success); // TODO: add beginTransaction method + public void endTransaction(boolean success); public void closeStatement(); public void prepareStatement(); public void optimisticFailure(String entityName);

18 years, 3 months

1
0
0 / 0

Hibernate SVN: r14132 - core/trunk/documentation/manual/translations/ja-JP/content.

by hibernate-commits＠lists.jboss.org

Author: xhuang(a)jboss.com Date: 2007-10-25 03:57:28 -0400 (Thu, 25 Oct 2007) New Revision: 14132 Modified: core/trunk/documentation/manual/translations/ja-JP/content/architecture.po core/trunk/documentation/manual/translations/ja-JP/content/association_mapping.po core/trunk/documentation/manual/translations/ja-JP/content/basic_mapping.po core/trunk/documentation/manual/translations/ja-JP/content/batch.po core/trunk/documentation/manual/translations/ja-JP/content/best_practices.po core/trunk/documentation/manual/translations/ja-JP/content/collection_mapping.po core/trunk/documentation/manual/translations/ja-JP/content/component_mapping.po core/trunk/documentation/manual/translations/ja-JP/content/configuration.po core/trunk/documentation/manual/translations/ja-JP/content/events.po core/trunk/documentation/manual/translations/ja-JP/content/example_mappings.po core/trunk/documentation/manual/translations/ja-JP/content/example_parentchild.po core/trunk/documentation/manual/translations/ja-JP/content/example_weblog.po core/trunk/documentation/manual/translations/ja-JP/content/filters.po core/trunk/documentation/manual/translations/ja-JP/content/inheritance_mapping.po core/trunk/documentation/manual/translations/ja-JP/content/performance.po core/trunk/documentation/manual/translations/ja-JP/content/persistent_classes.po core/trunk/documentation/manual/translations/ja-JP/content/preface.po core/trunk/documentation/manual/translations/ja-JP/content/query_criteria.po core/trunk/documentation/manual/translations/ja-JP/content/query_hql.po core/trunk/documentation/manual/translations/ja-JP/content/query_sql.po core/trunk/documentation/manual/translations/ja-JP/content/session_api.po core/trunk/documentation/manual/translations/ja-JP/content/toolset_guide.po core/trunk/documentation/manual/translations/ja-JP/content/transactions.po core/trunk/documentation/manual/translations/ja-JP/content/tutorial.po core/trunk/documentation/manual/translations/ja-JP/content/xml.po Log: merge with latest English XML Modified: core/trunk/documentation/manual/translations/ja-JP/content/architecture.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/architecture.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/architecture.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,216 +1,634 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:21 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: architecture.xml:21 +#, no-c-format msgid "Architecture" -msgstr "" +msgstr "アーキテクチャ" -#: index.docbook:24 +#. Tag: title +#: architecture.xml:24 +#, no-c-format msgid "Overview" -msgstr "" +msgstr "概観" -#: index.docbook:26 +#. Tag: para +#: architecture.xml:26 +#, no-c-format msgid "A (very) high-level view of the Hibernate architecture:" -msgstr "" +msgstr "Hibernateアーキテクチャの（非常に）高いレベルからのビュー：" -#: index.docbook:39 -msgid "This diagram shows Hibernate using the database and configuration data to provide persistence services (and persistent objects) to the application." +#. Tag: para +#: architecture.xml:39 +#, no-c-format +msgid "" +"This diagram shows Hibernate using the database and configuration data to " +"provide persistence services (and persistent objects) to the application." msgstr "" +"この図はHibernateが、アプリケーションに対して永続化サービス（と永続オブジェ" +"クト）を提供するために、データベースと設定データを使うことを示しています。" -#: index.docbook:44 -msgid "We would like to show a more detailed view of the runtime architecture. Unfortunately, Hibernate is flexible and supports several approaches. We will show the two extremes. The \"lite\" architecture has the application provide its own JDBC connections and manage its own transactions. This approach uses a minimal subset of Hibernate's APIs:" +#. Tag: para +#: architecture.xml:44 +#, no-c-format +msgid "" +"We would like to show a more detailed view of the runtime architecture. " +"Unfortunately, Hibernate is flexible and supports several approaches. We " +"will show the two extremes. The \"lite\" architecture has the application " +"provide its own JDBC connections and manage its own transactions. This " +"approach uses a minimal subset of Hibernate's APIs:" msgstr "" +"ここで実行時アーキテクチャのより詳細なビューをお見せしましょう。あいにく、" +"Hibernateは柔軟であり、いろいろなアプローチをサポートしています。ここでは、2" +"つの極端な例をお見せします。「軽い」アーキテクチャでは、アプリケーションが自" +"前のJDBCコネクションを用意し、アプリケーション自身がトランザクションを管理し" +"ます。この方法は、Hibernate APIの最小限のサブセットを使います：" -#: index.docbook:61 -msgid "The \"full cream\" architecture abstracts the application away from the underlying JDBC/JTA APIs and lets Hibernate take care of the details." +#. Tag: para +#: architecture.xml:61 +#, no-c-format +msgid "" +"The \"full cream\" architecture abstracts the application away from the " +"underlying JDBC/JTA APIs and lets Hibernate take care of the details." msgstr "" +"「重い」アーキテクチャは、アプリケーションから、その下に位置するJDBCやJTAの" +"APIを取り払って抽象化し、その詳細の面倒をHibernateに見させます。" -#: index.docbook:75 +#. Tag: para +#: architecture.xml:75 +#, fuzzy, no-c-format msgid "Heres some definitions of the objects in the diagrams:" -msgstr "" +msgstr "以下は、上の図に含まれるオブジェクトの定義です： <placeholder-1/>" -#: index.docbook:80 +#. Tag: term +#: architecture.xml:80 +#, no-c-format msgid "SessionFactory (<literal>org.hibernate.SessionFactory</literal>)" -msgstr "" +msgstr "SessionFactory (<literal>org.hibernate.SessionFactory</literal>)" -#: index.docbook:82 -msgid "A threadsafe (immutable) cache of compiled mappings for a single database. A factory for <literal>Session</literal> and a client of <literal>ConnectionProvider</literal>. Might hold an optional (second-level) cache of data that is reusable between transactions, at a process- or cluster-level." +#. Tag: para +#: architecture.xml:82 +#, no-c-format +msgid "" +"A threadsafe (immutable) cache of compiled mappings for a single database. A " +"factory for <literal>Session</literal> and a client of " +"<literal>ConnectionProvider</literal>. Might hold an optional (second-level) " +"cache of data that is reusable between transactions, at a process- or " +"cluster-level." msgstr "" +"1つのデータベースに対するコンパイルされたマッピングのスレッドセーフな（更新" +"不能の）キャッシュ。 <literal>Session</literal> のファクトリであり、 " +"<literal>ConnectionProvider</literal> のクライアント。オプションとして、プロ" +"セスまたはクラスタレベルにおいて、トランザクション間で再利用可能なデータの" +"（二次）キャッシュを持ちます。" -#: index.docbook:92 +#. Tag: term +#: architecture.xml:92 +#, no-c-format msgid "Session (<literal>org.hibernate.Session</literal>)" -msgstr "" +msgstr "Session (<literal>org.hibernate.Session</literal>)" -#: index.docbook:94 -msgid "A single-threaded, short-lived object representing a conversation between the application and the persistent store. Wraps a JDBC connection. Factory for <literal>Transaction</literal>. Holds a mandatory (first-level) cache of persistent objects, used when navigating the object graph or looking up objects by identifier." +#. Tag: para +#: architecture.xml:94 +#, no-c-format +msgid "" +"A single-threaded, short-lived object representing a conversation between " +"the application and the persistent store. Wraps a JDBC connection. Factory " +"for <literal>Transaction</literal>. Holds a mandatory (first-level) cache of " +"persistent objects, used when navigating the object graph or looking up " +"objects by identifier." msgstr "" +"アプリケーションと永続ストアとの対話を表す、シングルスレッドで短命のオブジェ" +"クト。 JDBCコネクションをラップします。 <literal>Transaction</literal> のファ" +"クトリです。永続オブジェクトの必須の（一次）キャッシュを保持します。この" +"キャッシュはオブジェクトグラフをナビゲーションする時や、識別子でオブジェクト" +"を検索する時に使われます。" -#: index.docbook:104 +#. Tag: term +#: architecture.xml:104 +#, no-c-format msgid "Persistent objects and collections" -msgstr "" +msgstr "Persistent objects と Collections" -#: index.docbook:106 -msgid "Short-lived, single threaded objects containing persistent state and business function. These might be ordinary JavaBeans/POJOs, the only special thing about them is that they are currently associated with (exactly one) <literal>Session</literal>. As soon as the <literal>Session</literal> is closed, they will be detached and free to use in any application layer (e.g. directly as data transfer objects to and from presentation)." +#. Tag: para +#: architecture.xml:106 +#, no-c-format +msgid "" +"Short-lived, single threaded objects containing persistent state and " +"business function. These might be ordinary JavaBeans/POJOs, the only special " +"thing about them is that they are currently associated with (exactly one) " +"<literal>Session</literal>. As soon as the <literal>Session</literal> is " +"closed, they will be detached and free to use in any application layer (e.g. " +"directly as data transfer objects to and from presentation)." msgstr "" +"永続化状態とビジネスメソッドを持つ、短命でシングルスレッドのオブジェクト。こ" +"れは通常のJavaBeans/POJOのこともありますが、特徴的なことは、その時点での（た" +"だ1つの） <literal>Session</literal> と関連していることです。 " +"<literal>Session</literal> がクローズされるとすぐに、それらは切り離されて他" +"のアプリケーション層から自由に使うことができます。（例えばデータ・トランス" +"ファ・オブジェクトとして、プレゼンテーション層から、またはプレゼンテーション" +"層へ直接使用できます。）" -#: index.docbook:117 +#. Tag: term +#: architecture.xml:117 +#, no-c-format msgid "Transient and detached objects and collections" -msgstr "" +msgstr "Transient と detached な objects と Collections" -#: index.docbook:119 -msgid "Instances of persistent classes that are not currently associated with a <literal>Session</literal>. They may have been instantiated by the application and not (yet) persisted or they may have been instantiated by a closed <literal>Session</literal>." +#. Tag: para +#: architecture.xml:119 +#, no-c-format +msgid "" +"Instances of persistent classes that are not currently associated with a " +"<literal>Session</literal>. They may have been instantiated by the " +"application and not (yet) persisted or they may have been instantiated by a " +"closed <literal>Session</literal>." msgstr "" +"現時点では <literal>Session</literal> と関連していない、永続クラスのインスタ" +"ンス。すでにアプリケーション側でインスタンス化されていて、まだ永続化されてい" +"ないか、クローズされた <literal>Session</literal> でインスタンス化されたかの" +"どちらかです。" -#: index.docbook:128 +#. Tag: term +#: architecture.xml:128 +#, no-c-format msgid "Transaction (<literal>org.hibernate.Transaction</literal>)" -msgstr "" +msgstr "Transaction (<literal>org.hibernate.Transaction</literal>)" -#: index.docbook:130 -msgid "(Optional) A single-threaded, short-lived object used by the application to specify atomic units of work. Abstracts application from underlying JDBC, JTA or CORBA transaction. A <literal>Session</literal> might span several <literal>Transaction</literal>s in some cases. However, transaction demarcation, either using the underlying API or <literal>Transaction</literal>, is never optional!" +#. Tag: para +#: architecture.xml:130 +#, no-c-format +msgid "" +"(Optional) A single-threaded, short-lived object used by the application to " +"specify atomic units of work. Abstracts application from underlying JDBC, " +"JTA or CORBA transaction. A <literal>Session</literal> might span several " +"<literal>Transaction</literal>s in some cases. However, transaction " +"demarcation, either using the underlying API or <literal>Transaction</" +"literal>, is never optional!" msgstr "" +"(オプション)原子性を持つ作業単位(Unit of Work)を指定するために、アプリケー" +"ションが使用する、シングルスレッドで短命なオブジェクト。下に位置するJDBC、" +"JTA、CORBAトランザクションからアプリケーションを抽象化します。 " +"<literal>Session</literal> は、時にはいくつかの <literal>Transaction</" +"literal> をまたがるかもしれません。しかし、下の層のAPIを使うにせよ、 " +"<literal>Transaction</literal> を使うにせよ、トランザクション境界を設定する" +"ことは、決してオプションではありません！。" -#: index.docbook:141 -msgid "ConnectionProvider (<literal>org.hibernate.connection.ConnectionProvider</literal>)" +#. Tag: term +#: architecture.xml:141 +#, no-c-format +msgid "" +"ConnectionProvider (<literal>org.hibernate.connection.ConnectionProvider</" +"literal>)" msgstr "" +"ConnectionProvider (<literal>org.hibernate.connection.ConnectionProvider</" +"literal>)" -#: index.docbook:143 -msgid "(Optional) A factory for (and pool of) JDBC connections. Abstracts application from underlying <literal>Datasource</literal> or <literal>DriverManager</literal>. Not exposed to application, but can be extended/implemented by the developer." +#. Tag: para +#: architecture.xml:143 +#, no-c-format +msgid "" +"(Optional) A factory for (and pool of) JDBC connections. Abstracts " +"application from underlying <literal>Datasource</literal> or " +"<literal>DriverManager</literal>. Not exposed to application, but can be " +"extended/implemented by the developer." msgstr "" +"(オプション)JDBCコネクション（とそのプール）のファクトリ。下の層に位置する " +"<literal>Datasource</literal> や <literal>DriverManager</literal> からアプリ" +"ケーションを抽象化します。アプリケーションには公開されませんが、開発者が継承" +"または実装することは可能です。" -#: index.docbook:151 -msgid "TransactionFactory (<literal>org.hibernate.TransactionFactory</literal>)" +#. Tag: term +#: architecture.xml:151 +#, no-c-format +msgid "" +"TransactionFactory (<literal>org.hibernate.TransactionFactory</literal>)" msgstr "" +"TransactionFactory (<literal>org.hibernate.TransactionFactory</literal>)" -#: index.docbook:153 -msgid "(Optional) A factory for <literal>Transaction</literal> instances. Not exposed to the application, but can be extended/implemented by the developer." +#. Tag: para +#: architecture.xml:153 +#, no-c-format +msgid "" +"(Optional) A factory for <literal>Transaction</literal> instances. Not " +"exposed to the application, but can be extended/implemented by the developer." msgstr "" +"(オプション) <literal>Transaction</literal> インスタンスのファクトリ。アプリ" +"ケーションには公開されませんが、開発者が継承または実装することは可能です。" -#: index.docbook:160 +#. Tag: emphasis +#: architecture.xml:160 +#, no-c-format msgid "Extension Interfaces" -msgstr "" +msgstr "Extension Interfaces" -#: index.docbook:162 -msgid "Hibernate offers many optional extension interfaces you can implement to customize the behavior of your persistence layer. See the API documentation for details." +#. Tag: para +#: architecture.xml:162 +#, no-c-format +msgid "" +"Hibernate offers many optional extension interfaces you can implement to " +"customize the behavior of your persistence layer. See the API documentation " +"for details." msgstr "" +"Hibernateは、永続層の振る舞いをカスタマイズするために、多くのオプション拡張" +"インタフェースを用意しています。詳細はAPIドキュメントを参照してください。" -#: index.docbook:171 -msgid "Given a \"lite\" architecture, the application bypasses the <literal>Transaction</literal>/<literal>TransactionFactory</literal> and/or <literal>ConnectionProvider</literal> APIs to talk to JTA or JDBC directly." +#. Tag: para +#: architecture.xml:171 +#, no-c-format +msgid "" +"Given a \"lite\" architecture, the application bypasses the " +"<literal>Transaction</literal>/<literal>TransactionFactory</literal> and/or " +"<literal>ConnectionProvider</literal> APIs to talk to JTA or JDBC directly." msgstr "" +"「軽い」アーキテクチャでは、アプリケーションは直接JTAやJDBCと対話するため" +"に、 <literal>Transaction</literal> や <literal>TransactionFactory</literal> " +"や <literal>ConnectionProvider</literal> をバイパスします。" -#: index.docbook:179 +#. Tag: title +#: architecture.xml:179 +#, no-c-format msgid "Instance states" -msgstr "" +msgstr "インスタンスの状態" -#: index.docbook:180 -msgid "An instance of a persistent classes may be in one of three different states, which are defined with respect to a <emphasis>persistence context</emphasis>. The Hibernate <literal>Session</literal> object is the persistence context:" +#. Tag: para +#: architecture.xml:180 +#, no-c-format +msgid "" +"An instance of a persistent classes may be in one of three different states, " +"which are defined with respect to a <emphasis>persistence context</" +"emphasis>. The Hibernate <literal>Session</literal> object is the " +"persistence context:" msgstr "" +"永続クラスのインスタンスは、次の３つの異なる状態のどれかになります。それ" +"は、 <emphasis>永続コンテキスト</emphasis> によって決まります。 Hibernateの " +"<literal>Session</literal> オブジェクトが、永続コンテキストになります。" -#: index.docbook:188 +#. Tag: term +#: architecture.xml:188 +#, no-c-format msgid "transient" -msgstr "" +msgstr "transient" -#: index.docbook:190 -msgid "The instance is not, and has never been associated with any persistence context. It has no persistent identity (primary key value)." +#. Tag: para +#: architecture.xml:190 +#, no-c-format +msgid "" +"The instance is not, and has never been associated with any persistence " +"context. It has no persistent identity (primary key value)." msgstr "" +"この状態のインスタンスは、現在もそして過去においても、永続コンテキストに関連" +"づいていません。また、永続ID（主キーの値）を持っていません。" -#: index.docbook:198 +#. Tag: term +#: architecture.xml:198 +#, no-c-format msgid "persistent" -msgstr "" +msgstr "persistent" -#: index.docbook:200 -msgid "The instance is currently associated with a persistence context. It has a persistent identity (primary key value) and, perhaps, a corresponding row in the database. For a particular persistence context, Hibernate <emphasis>guarantees</emphasis> that persistent identity is equivalent to Java identity (in-memory location of the object)." +#. Tag: para +#: architecture.xml:200 +#, no-c-format +msgid "" +"The instance is currently associated with a persistence context. It has a " +"persistent identity (primary key value) and, perhaps, a corresponding row in " +"the database. For a particular persistence context, Hibernate " +"<emphasis>guarantees</emphasis> that persistent identity is equivalent to " +"Java identity (in-memory location of the object)." msgstr "" +"この状態のインスタンスは、その時点で永続コンテキストに関連づいています。ま" +"た、永続ID（主キーの値）を持ち、たいていはデータベースに対応する行を持ってい" +"るでしょう。個々の永続コンテキストのなかでは、永続IDが JavaのID（オブジェク" +"トのメモリ上の位置）と同じであることを Hibernateが <emphasis>保証</emphasis> " +"します。" -#: index.docbook:212 +#. Tag: term +#: architecture.xml:212 +#, no-c-format msgid "detached" -msgstr "" +msgstr "detached" -#: index.docbook:214 -msgid "The instance was once associated with a persistence context, but that context was closed, or the instance was serialized to another process. It has a persistent identity and, perhaps, a corrsponding row in the database. For detached instances, Hibernate makes no guarantees about the relationship between persistent identity and Java identity." +#. Tag: para +#: architecture.xml:214 +#, no-c-format +msgid "" +"The instance was once associated with a persistence context, but that " +"context was closed, or the instance was serialized to another process. It " +"has a persistent identity and, perhaps, a corrsponding row in the database. " +"For detached instances, Hibernate makes no guarantees about the relationship " +"between persistent identity and Java identity." msgstr "" +"この状態のインスタンスは、かつて永続コンテキストに関連づけられたが、そのコン" +"テキストがクローズされたか、あるいは、他のプロセスにそのインスタンスがシリア" +"ライズされたかです。このインスタンスは、永続IDを持ち、たいていはデータベース" +"に対応する行を持っているでしょう。分離インスタンスに対しては、永続IDとJava" +"のIDとの関連は、Hibernateが保証しません。" -#: index.docbook:229 +#. Tag: title +#: architecture.xml:229 +#, no-c-format msgid "JMX Integration" -msgstr "" +msgstr "JMXとの統合" -#: index.docbook:231 -msgid "JMX is the J2EE standard for management of Java components. Hibernate may be managed via a JMX standard service. We provide an MBean implementation in the distribution, <literal>org.hibernate.jmx.HibernateService</literal>." +#. Tag: para +#: architecture.xml:231 +#, no-c-format +msgid "" +"JMX is the J2EE standard for management of Java components. Hibernate may be " +"managed via a JMX standard service. We provide an MBean implementation in " +"the distribution, <literal>org.hibernate.jmx.HibernateService</literal>." msgstr "" +"JMXはJavaコンポーネント管理のJ2EE標準です。 JMX標準サービスを通して、" +"Hibernateは管理されます。ディストリビューションの中に <literal>org." +"hibernate.jmx.HibernateService</literal> という MBean実装を用意しています。" -#: index.docbook:237 -msgid "For an example how to deploy Hibernate as a JMX service on the JBoss Application Server, please see the JBoss User Guide. On JBoss AS, you also get these benefits if you deploy using JMX:" +#. Tag: para +#: architecture.xml:237 +#, no-c-format +msgid "" +"For an example how to deploy Hibernate as a JMX service on the JBoss " +"Application Server, please see the JBoss User Guide. On JBoss AS, you also " +"get these benefits if you deploy using JMX:" msgstr "" +"JBoss アプリケーションサーバー上にHibernateをJMXサービスとしてデプロイする方" +"法の例としては、 JBoss ユーザガイドを参照してください。 JBoss アプリケーショ" +"ンサーバーにおいて、 JMXを使ってデプロイすると、次のメリットが得られます。" -#: index.docbook:245 -msgid "<emphasis>Session Management:</emphasis> The Hibernate <literal>Session</literal>'s life cycle can be automatically bound to the scope of a JTA transaction. This means you no longer have to manually open and close the <literal>Session</literal>, this becomes the job of a JBoss EJB interceptor. You also don't have to worry about transaction demarcation in your code anymore (unless you'd like to write a portable persistence layer of course, use the optional Hibernate <literal>Transaction</literal> API for this). You call the <literal>HibernateContext</literal> to access a <literal>Session</literal>." +#. Tag: para +#: architecture.xml:245 +#, no-c-format +msgid "" +"<emphasis>Session Management:</emphasis> The Hibernate <literal>Session</" +"literal>'s life cycle can be automatically bound to the scope of a JTA " +"transaction. This means you no longer have to manually open and close the " +"<literal>Session</literal>, this becomes the job of a JBoss EJB interceptor. " +"You also don't have to worry about transaction demarcation in your code " +"anymore (unless you'd like to write a portable persistence layer of course, " +"use the optional Hibernate <literal>Transaction</literal> API for this). You " +"call the <literal>HibernateContext</literal> to access a <literal>Session</" +"literal>." msgstr "" +"<emphasis>セッション管理:</emphasis> Hibernateの <literal>Session</literal> " +"のライフサイクルは、自動的にJTAトランザクションのスコープに結びつけられま" +"す。これは、もはや手動で <literal>Session</literal> をオープンしたり、クロー" +"ズしたりする必要がないことを意味します。これは、JBoss EJB インターセプタの仕" +"事になります。また、コードのどこでトランザクション境界を設定するかについ" +"て、もはや悩む必要がありません（もちろん移植可能な永続層を書かかなくていいの" +"ならば、オプションのHibernateの <literal>Transaction</literal> を使用してく" +"ださい。） <literal>Session</literal> にアクセスするためには、 " +"<literal>HibernateContext</literal> をコールしてください。" -#: index.docbook:257 -msgid "<emphasis>HAR deployment:</emphasis> Usually you deploy the Hibernate JMX service using a JBoss service deployment descriptor (in an EAR and/or SAR file), it supports all the usual configuration options of a Hibernate <literal>SessionFactory</literal>. However, you still have to name all your mapping files in the deployment descriptor. If you decide to use the optional HAR deployment, JBoss will automatically detect all mapping files in your HAR file." +#. Tag: para +#: architecture.xml:257 +#, no-c-format +msgid "" +"<emphasis>HAR deployment:</emphasis> Usually you deploy the Hibernate JMX " +"service using a JBoss service deployment descriptor (in an EAR and/or SAR " +"file), it supports all the usual configuration options of a Hibernate " +"<literal>SessionFactory</literal>. However, you still have to name all your " +"mapping files in the deployment descriptor. If you decide to use the " +"optional HAR deployment, JBoss will automatically detect all mapping files " +"in your HAR file." msgstr "" +"<emphasis>HAR デプロイ:</emphasis> 通常、(EAR または SAR ファイルにある）" +"JBoss サービスデプロイメントディスクリプタを使って、Hibernate JMX サービスを" +"デプロイします。それは、Hibernateの <literal>SessionFactory</literal> の全て" +"の一般的な設定オプションをサポートします。しかし依然としてデプロイメントディ" +"スクリプタのなかにすべてのマッピングファイルの名前を挙げる必要があります。 " +"もし、オプションのHARデプロイメントを使うことを決めたなら、 JBossは自動的に" +"HARファイルのなかの全てのマッピングファイルを検出します。" -#: index.docbook:268 -msgid "Consult the JBoss AS user guide for more information about these options." +#. Tag: para +#: architecture.xml:268 +#, no-c-format +msgid "" +"Consult the JBoss AS user guide for more information about these options." msgstr "" +"これらのオプションについての詳細な情報は、JBossアプリケーションサーバユーザガ" +"イドを参考にしてください。" -#: index.docbook:272 -msgid "Another feature available as a JMX service are runtime Hibernate statistics. See <xref linkend=\"configuration-optional-statistics\"/>." +#. Tag: para +#: architecture.xml:272 +#, no-c-format +msgid "" +"Another feature available as a JMX service are runtime Hibernate statistics. " +"See <xref linkend=\"configuration-optional-statistics\"/>." msgstr "" +"JMXサービスとして利用可能な他の機能に、Hibernate実行時統計情報があります。 " +"<xref linkend=\"configuration-optional-statistics\"/> を見てください。" -#: index.docbook:279 +#. Tag: title +#: architecture.xml:279 +#, no-c-format msgid "JCA Support" -msgstr "" +msgstr "JCA サポート" -#: index.docbook:280 -msgid "Hibernate may also be configured as a JCA connector. Please see the website for more details. Please note that Hibernate JCA support is still considered experimental." +#. Tag: para +#: architecture.xml:280 +#, no-c-format +msgid "" +"Hibernate may also be configured as a JCA connector. Please see the website " +"for more details. Please note that Hibernate JCA support is still considered " +"experimental." msgstr "" +"Hibernate は JCA コネクタとしても設定できます。詳細については、Webサイトを見" +"てください。 Hibernate JCA サポートは、今のところ実験段階として考えられている" +"ことに注意してください。" -#: index.docbook:287 +#. Tag: title +#: architecture.xml:287 +#, no-c-format msgid "Contextual Sessions" -msgstr "" +msgstr "コンテキスト上のセッション" -#: index.docbook:288 -msgid "Most applications using Hibernate need some form of \"contextual\" sessions, where a given session is in effect throughout the scope of a given context. However, across applications the definition of what constitutes a context is typically different; and different contexts define different scopes to the notion of current. Applications using Hibernate prior to version 3.0 tended to utilize either home-grown <literal>ThreadLocal</literal>-based contextual sessions, helper classes such as <literal>HibernateUtil</literal>, or utilized third-party frameworks (such as Spring or Pico) which provided proxy/interception-based contextual sessions." +#. Tag: para +#: architecture.xml:288 +#, no-c-format +msgid "" +"Most applications using Hibernate need some form of \"contextual\" sessions, " +"where a given session is in effect throughout the scope of a given context. " +"However, across applications the definition of what constitutes a context is " +"typically different; and different contexts define different scopes to the " +"notion of current. Applications using Hibernate prior to version 3.0 tended " +"to utilize either home-grown <literal>ThreadLocal</literal>-based contextual " +"sessions, helper classes such as <literal>HibernateUtil</literal>, or " +"utilized third-party frameworks (such as Spring or Pico) which provided " +"proxy/interception-based contextual sessions." msgstr "" +"Hibernate を使ったアプリケーションは、ほとんど、なんらかの形で\"コンテキスト" +"上の\"セッションが必要になります。「コンテキスト上のセッション」は、特定のコ" +"ンテキストのスコープのなかで有効なセッションのことです。しかし、通常アプリ" +"ケーションごとにコンテキストを構成するものの定義は異なります。しかも、異なる" +"複数のコンテキストは、現時点に対して異なるスコープを定義します。バージョン" +"3.0より前の Hibernate では、自作の <literal>ThreadLocal</literal> ベースの" +"「コンテキスト上のセッション」を利用するか、 <literal>HibernateUtil</" +"literal> のようなヘルパークラスを利用するか、 proxy/interception ベースの「コ" +"ンテキスト上のセッション」を提供する（Spring や Pico のような）サードパー" +"ティのフレームワークを利用するかのいずれかでした。" -#: index.docbook:297 -msgid "Starting with version 3.0.1, Hibernate added the <literal>SessionFactory.getCurrentSession()</literal> method. Initially, this assumed usage of <literal>JTA</literal> transactions, where the <literal>JTA</literal> transaction defined both the scope and context of a current session. The Hibernate team maintains that, given the maturity of the numerous stand-alone <literal>JTA TransactionManager</literal> implementations out there, most (if not all) applications should be using <literal>JTA</literal> transaction management whether or not they are deployed into a <literal>J2EE</literal> container. Based on that, the <literal>JTA</literal>-based contextual sessions is all you should ever need to use." +#. Tag: para +#: architecture.xml:297 +#, no-c-format +msgid "" +"Starting with version 3.0.1, Hibernate added the <literal>SessionFactory." +"getCurrentSession()</literal> method. Initially, this assumed usage of " +"<literal>JTA</literal> transactions, where the <literal>JTA</literal> " +"transaction defined both the scope and context of a current session. The " +"Hibernate team maintains that, given the maturity of the numerous stand-" +"alone <literal>JTA TransactionManager</literal> implementations out there, " +"most (if not all) applications should be using <literal>JTA</literal> " +"transaction management whether or not they are deployed into a " +"<literal>J2EE</literal> container. Based on that, the <literal>JTA</literal>-" +"based contextual sessions is all you should ever need to use." msgstr "" +"バージョン 3.0.1 から、Hibernate には <literal>SessionFactory." +"getCurrentSession()</literal> が加わりました。これは、 <literal>JTA</" +"literal> トランザクションの使用を前提にしています。 <literal>JTA</literal> ト" +"ランザクションは、現在のセッションのスコープとコンテキストの両方を定義しま" +"す。 Hibernate チームは、次のことを主張します。巨大なスタンドアロンの " +"<literal>JTA TransactionManager</literal> 実装が成熟したら、 <literal>J2EE</" +"literal> コンテナ上にデプロイされるかどうかにかかわらず、ほとんどの（すべて" +"とは言わないが）アプリケーションが、 <literal>JTA</literal> トランザクション" +"管理を使用すべきであると。この考えに基づくと、 <literal>JTA</literal> ベース" +"の「コンテキスト上のセッション」を使うしかないでしょう。" -#: index.docbook:307 -msgid "However, as of version 3.1, the processing behind <literal>SessionFactory.getCurrentSession()</literal> is now pluggable. To that end, a new extension interface (<literal>org.hibernate.context.CurrentSessionContext</literal>) and a new configuration parameter (<literal>hibernate.current_session_context_class</literal>) have been added to allow pluggability of the scope and context of defining current sessions." +#. Tag: para +#: architecture.xml:307 +#, no-c-format +msgid "" +"However, as of version 3.1, the processing behind <literal>SessionFactory." +"getCurrentSession()</literal> is now pluggable. To that end, a new extension " +"interface (<literal>org.hibernate.context.CurrentSessionContext</literal>) " +"and a new configuration parameter (<literal>hibernate." +"current_session_context_class</literal>) have been added to allow " +"pluggability of the scope and context of defining current sessions." msgstr "" +"しかし、バージョン 3.1 からは、 <literal>SessionFactory.getCurrentSession()</" +"literal> の後の処理が、プラガブルになりました。これを受けて、現在のセッショ" +"ンを定義するスコープとコンテキストのプラガビリティを可能にするために、新しい" +"拡張インタフェース ( <literal>org.hibernate.context.CurrentSessionContext</" +"literal> ) と新しい構成パラメータ ( <literal>hibernate." +"current_session_context_class</literal> ) が追加されました。" -#: index.docbook:314 -msgid "See the Javadocs for the <literal>org.hibernate.context.CurrentSessionContext</literal> interface for a detailed discussion of its contract. It defines a single method, <literal>currentSession()</literal>, by which the implementation is responsible for tracking the current contextual session. Out-of-the-box, Hibernate comes with three implementations of this interface." +#. Tag: para +#: architecture.xml:314 +#, no-c-format +msgid "" +"See the Javadocs for the <literal>org.hibernate.context." +"CurrentSessionContext</literal> interface for a detailed discussion of its " +"contract. It defines a single method, <literal>currentSession()</literal>, " +"by which the implementation is responsible for tracking the current " +"contextual session. Out-of-the-box, Hibernate comes with three " +"implementations of this interface." msgstr "" +"<literal>org.hibernate.context.CurrentSessionContext</literal> インタフェース" +"の規約についての詳細な内容は Javadoc を参照してください。それには、 " +"<literal>currentSession()</literal> という1つのメソッドが定義されており、そ" +"の実装は、現在の「コンテキスト上のセッション」を追跡することに責任を持ちま" +"す。そのまま使えるように、Hibernateはこのインタフェースの実装を2つ提供してい" +"ます。" -#: index.docbook:324 -msgid "<literal>org.hibernate.context.JTASessionContext</literal> - current sessions are tracked and scoped by a <literal>JTA</literal> transaction. The processing here is exactly the same as in the older JTA-only approach. See the Javadocs for details." +#. Tag: para +#: architecture.xml:324 +#, no-c-format +msgid "" +"<literal>org.hibernate.context.JTASessionContext</literal> - current " +"sessions are tracked and scoped by a <literal>JTA</literal> transaction. The " +"processing here is exactly the same as in the older JTA-only approach. See " +"the Javadocs for details." msgstr "" +"<literal>org.hibernate.context.JTASessionContext</literal> - <literal>JTA</" +"literal> トランザクションによって、現在のセッションが追跡され、スコープを決" +"められます。この処理は、古いJTAだけのアプローチとまったく同じです。詳細は" +"Javadocを参照してください。" -#: index.docbook:332 -msgid "<literal>org.hibernate.context.ThreadLocalSessionContext</literal> - current sessions are tracked by thread of execution. Again, see the Javadocs for details." +#. Tag: para +#: architecture.xml:332 +#, no-c-format +msgid "" +"<literal>org.hibernate.context.ThreadLocalSessionContext</literal> - current " +"sessions are tracked by thread of execution. Again, see the Javadocs for " +"details." msgstr "" +"<literal>org.hibernate.context.ThreadLocalSessionContext</literal> - スレッド" +"の実行によって、現在のセッションが追跡されます。詳細はJavadocを参照してくだ" +"さい。" -#: index.docbook:338 -msgid "<literal>org.hibernate.context.ManagedSessionContext</literal> - current sessions are tracked by thread of execution. However, you are responsible to bind and unbind a <literal>Session</literal> instance with static methods on this class, it does never open, flush, or close a <literal>Session</literal>." +#. Tag: para +#: architecture.xml:338 +#, no-c-format +msgid "" +"<literal>org.hibernate.context.ManagedSessionContext</literal> - current " +"sessions are tracked by thread of execution. However, you are responsible to " +"bind and unbind a <literal>Session</literal> instance with static methods on " +"this class, it does never open, flush, or close a <literal>Session</literal>." msgstr "" +"<literal>org.hibernate.context.ManagedSessionContext</literal> - スレッドの実" +"行によって、現在のセッションが追跡されます。しかし、このクラスのstaticメソッ" +"ドで <literal>Session</literal> インスタンスをバインド/アンバインドする責任" +"はあなたにあります。これは決して <literal>Session</literal> をオープン、フ" +"ラッシュ、クローズしません。" -#: index.docbook:347 -msgid "The first two implementations provide a \"one session - one database transaction\" programming model, also known and used as <emphasis>session-per-request</emphasis>. The beginning and end of a Hibernate session is defined by the duration of a database transaction. If you use programatic transaction demarcation in plain JSE without JTA, you are adviced to use the Hibernate <literal>Transaction</literal> API to hide the underlying transaction system from your code. If you use JTA, use the JTA interfaces to demarcate transactions. If you execute in an EJB container that supports CMT, transaction boundaries are defined declaratively and you don't need any transaction or session demarcation operations in your code. Refer to <xref linkend=\"transactions\"/> for more information and code examples." +#. Tag: para +#: architecture.xml:347 +#, no-c-format +msgid "" +"The first two implementations provide a \"one session - one database " +"transaction\" programming model, also known and used as <emphasis>session-" +"per-request</emphasis>. The beginning and end of a Hibernate session is " +"defined by the duration of a database transaction. If you use programatic " +"transaction demarcation in plain JSE without JTA, you are adviced to use the " +"Hibernate <literal>Transaction</literal> API to hide the underlying " +"transaction system from your code. If you use JTA, use the JTA interfaces to " +"demarcate transactions. If you execute in an EJB container that supports " +"CMT, transaction boundaries are defined declaratively and you don't need any " +"transaction or session demarcation operations in your code. Refer to <xref " +"linkend=\"transactions\"/> for more information and code examples." msgstr "" +"始めの2つの実装は、\"1セッション - 1データベーストランザクション\" プログラミ" +"ングモデルを提供します。これは <emphasis>リクエストごとのセッション" +"（session-per-request）</emphasis> としても知られており、使われています。 " +"Hibernate セッションの開始と終了は、データベーストランザクションの期間で決ま" +"ります。 JTAを使わない普通のJSEで、プログラム上のトランザクション境界設定を行" +"うなら、コードから基礎のトランザクションシステムを隠蔽するために、 " +"Hibernate <literal>Transaction</literal> APIを使うとよいでしょう。 JTAを使う" +"なら、トランザクションの境界設定には、JTAインターフェイスを使ってください。 " +"CMTをサポートするEJBコンテナで実行するつもりなら、トランザクション境界は宣言" +"的に定義できるため、コード上でトランザクションやセッションの境界を設定する必" +"要はありません。さらに詳細な情報やコードの例は、 <xref linkend=" +"\"transactions\"/> を参照してください。" -#: index.docbook:359 -msgid "The <literal>hibernate.current_session_context_class</literal> configuration parameter defines which <literal>org.hibernate.context.CurrentSessionContext</literal> implementation should be used. Note that for backwards compatibility, if this config param is not set but a <literal>org.hibernate.transaction.TransactionManagerLookup</literal> is configured, Hibernate will use the <literal>org.hibernate.context.JTASessionContext</literal>. Typically, the value of this parameter would just name the implementation class to use; for the three out-of-the-box implementations, however, there are three corresponding short names, \"jta\", \"thread\", and \"managed\"." +#. Tag: para +#: architecture.xml:359 +#, no-c-format +msgid "" +"The <literal>hibernate.current_session_context_class</literal> configuration " +"parameter defines which <literal>org.hibernate.context." +"CurrentSessionContext</literal> implementation should be used. Note that for " +"backwards compatibility, if this config param is not set but a <literal>org." +"hibernate.transaction.TransactionManagerLookup</literal> is configured, " +"Hibernate will use the <literal>org.hibernate.context.JTASessionContext</" +"literal>. Typically, the value of this parameter would just name the " +"implementation class to use; for the three out-of-the-box implementations, " +"however, there are three corresponding short names, \"jta\", \"thread\", and " +"\"managed\"." msgstr "" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "" - +"<literal>hibernate.current_session_context_class</literal> 設定パラメータ" +"は、 <literal>org.hibernate.context.CurrentSessionContext</literal> のどの実" +"装を使うかを指定します。下位互換性のため、このパラメータが設定されず " +"<literal>org.hibernate.transaction.TransactionManagerLookup</literal> が設定" +"されていた場合、 Hibernateは <literal>org.hibernate.context." +"JTASessionContext</literal> を使うことに注意してください。通常このパラメータ" +"の値には、3つの実装の中から使用する実装クラスの名前を直接指定します。しか" +"し、\"jta\", \"thread\", \"managed\"というそれぞれの省略名も用意されていま" +"す。" Modified: core/trunk/documentation/manual/translations/ja-JP/content/association_mapping.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/association_mapping.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/association_mapping.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,1269 +1,874 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:6 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: association_mapping.xml:6 +#, no-c-format msgid "Association Mappings" msgstr "関連マッピング" -#: index.docbook:9 +#. Tag: title +#: association_mapping.xml:9 +#, no-c-format msgid "Introduction" msgstr "イントロダクション" -#: index.docbook:11 -msgid "Association mappings are the often most difficult thing to get right. In this section we'll go through the canonical cases one by one, starting with unidirectional mappings, and then considering the bidirectional cases. We'll use <literal>Person</literal> and <literal>Address</literal> in all the examples." -msgstr "関連マッピングはしばしば理解が最も難しいものになります。この章では、基本的な一つ一つのケースについて述べます。単方向のマッピングから始め、それから双方向のケースについて考えていきます。例として、<literal>Person</literal> と <literal>Address</literal> を用います。" +#. Tag: para +#: association_mapping.xml:11 +#, no-c-format +msgid "" +"Association mappings are the often most difficult thing to get right. In " +"this section we'll go through the canonical cases one by one, starting with " +"unidirectional mappings, and then considering the bidirectional cases. We'll " +"use <literal>Person</literal> and <literal>Address</literal> in all the " +"examples." +msgstr "" +"関連マッピングはしばしば理解が最も難しいものになります。この章では、基本的な" +"一つ一つのケースについて述べます。単方向のマッピングから始め、それから双方向" +"のケースについて考えていきます。例として、<literal>Person</literal> と " +"<literal>Address</literal> を用います。" -#: index.docbook:19 -msgid "We'll classify associations by whether or not they map to an intervening join table, and by multiplicity." -msgstr "関連は、結合テーブルを入れるかかどうかと、多重度によって分類することにします。" +#. Tag: para +#: association_mapping.xml:19 +#, no-c-format +msgid "" +"We'll classify associations by whether or not they map to an intervening " +"join table, and by multiplicity." +msgstr "" +"関連は、結合テーブルを入れるかかどうかと、多重度によって分類することにしま" +"す。" -#: index.docbook:24 -msgid "Nullable foreign keys are not considered good practice in traditional data modelling, so all our examples use not null foreign keys. This is not a requirement of Hibernate, and the mappings will all work if you drop the nullability constraints." -msgstr "すべての例でnot nullの外部キーを使用します。これはHibernateの要件ではありません。 not null制約を外したとしても、マッピングは問題なく動作します。" +#. Tag: para +#: association_mapping.xml:24 +#, no-c-format +msgid "" +"Nullable foreign keys are not considered good practice in traditional data " +"modelling, so all our examples use not null foreign keys. This is not a " +"requirement of Hibernate, and the mappings will all work if you drop the " +"nullability constraints." +msgstr "" +"すべての例でnot nullの外部キーを使用します。これはHibernateの要件ではありま" +"せん。 not null制約を外したとしても、マッピングは問題なく動作します。" -#: index.docbook:34 +#. Tag: title +#: association_mapping.xml:34 +#, no-c-format msgid "Unidirectional associations" msgstr "単方向関連" -#: index.docbook:37, index.docbook:108 +#. Tag: title +#: association_mapping.xml:37 association_mapping.xml:108 +#, no-c-format msgid "many to one" -msgstr "<title>多対一</title>" +msgstr "多対一" -#: index.docbook:39 -msgid "A <emphasis>unidirectional many-to-one association</emphasis> is the most common kind of unidirectional association." -msgstr "<emphasis>単方向多対一関連</emphasis> は単方向関連の中で最も一般的なものです。" +#. Tag: para +#: association_mapping.xml:39 +#, no-c-format +msgid "" +"A <emphasis>unidirectional many-to-one association</emphasis> is the most " +"common kind of unidirectional association." +msgstr "" +"<emphasis>単方向多対一関連</emphasis> は単方向関連の中で最も一般的なもので" +"す。" -#: index.docbook:44 +#. Tag: programlisting +#: association_mapping.xml:44 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <many-to-one name=\"address\" \n" - " column=\"addressId\"\n" - " not-null=\"true\"/>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <many-to-one name=\"address\" \n" +" column=\"addressId\"\n" +" not-null=\"true\"/>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"id\" column=\"personId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <many-to-one name=\"address\" -\n" - " column=\"addressId\" -\n" - " not-null=\"true\"/> -\n" - "</class> -\n" - " -\n" - "<class name=\"Address\"> -\n" - " <id name=\"id\" column=\"addressId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - "</class>]]>" -#: index.docbook:45, index.docbook:161 +#. Tag: programlisting +#: association_mapping.xml:45 association_mapping.xml:161 +#, no-c-format msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key, addressId bigint not null )\n" - "create table Address ( addressId bigint not null primary key )\n" - " ]]>" +"<![CDATA[\n" +"create table Person ( personId bigint not null primary key, addressId bigint " +"not null )\n" +"create table Address ( addressId bigint not null primary key )\n" +" ]]>" msgstr "" - "<![CDATA[ -\n" - "create table Person ( personId bigint not null primary key, addressId bigint not null ) -\n" - "create table Address ( addressId bigint not null primary key ) -\n" - " ]]>" -#: index.docbook:50, index.docbook:121, index.docbook:185, index.docbook:225 +#. Tag: title +#: association_mapping.xml:50 association_mapping.xml:121 +#: association_mapping.xml:185 association_mapping.xml:225 +#, no-c-format msgid "one to one" -msgstr "<title>一対一</title>" +msgstr "一対一" -#: index.docbook:52 -msgid "A <emphasis>unidirectional one-to-one association on a foreign key</emphasis> is almost identical. The only difference is the column unique constraint." -msgstr "<emphasis>外部キーの単方向一対一関連</emphasis> はほとんど同じものです。唯一違うのは、カラムのユニークな制約です。" +#. Tag: para +#: association_mapping.xml:52 +#, no-c-format +msgid "" +"A <emphasis>unidirectional one-to-one association on a foreign key</" +"emphasis> is almost identical. The only difference is the column unique " +"constraint." +msgstr "" +"<emphasis>外部キーの単方向一対一関連</emphasis> はほとんど同じものです。唯一" +"違うのは、カラムのユニークな制約です。" -#: index.docbook:57 +#. Tag: programlisting +#: association_mapping.xml:57 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <many-to-one name=\"address\" \n" - " column=\"addressId\" \n" - " unique=\"true\"\n" - " not-null=\"true\"/>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <many-to-one name=\"address\" \n" +" column=\"addressId\" \n" +" unique=\"true\"\n" +" not-null=\"true\"/>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"id\" column=\"personId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <many-to-one name=\"address\" -\n" - " column=\"addressId\" -\n" - " unique=\"true\" -\n" - " not-null=\"true\"/> -\n" - "</class> -\n" - " -\n" - "<class name=\"Address\"> -\n" - " <id name=\"id\" column=\"addressId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - "</class>]]>" -#: index.docbook:58, index.docbook:193 +#. Tag: programlisting +#: association_mapping.xml:58 association_mapping.xml:193 +#, no-c-format msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key, addressId bigint not null unique )\n" - "create table Address ( addressId bigint not null primary key )\n" - " ]]>" +"<![CDATA[\n" +"create table Person ( personId bigint not null primary key, addressId bigint " +"not null unique )\n" +"create table Address ( addressId bigint not null primary key )\n" +" ]]>" msgstr "" - "<![CDATA[ -\n" - "create table Person ( personId bigint not null primary key, addressId bigint not null unique ) -\n" - "create table Address ( addressId bigint not null primary key ) -\n" - " ]]>" -#: index.docbook:60 -msgid "A <emphasis>unidirectional one-to-one association on a primary key</emphasis> usually uses a special id generator. (Notice that we've reversed the direction of the association in this example.)" -msgstr "<emphasis>主キーの単方向一対一関連</emphasis> は通常、特別なIDジェネレータを使います。（この例では関連の方向が逆になっていることに注意してください）" +#. Tag: para +#: association_mapping.xml:60 +#, no-c-format +msgid "" +"A <emphasis>unidirectional one-to-one association on a primary key</" +"emphasis> usually uses a special id generator. (Notice that we've reversed " +"the direction of the association in this example.)" +msgstr "" +"<emphasis>主キーの単方向一対一関連</emphasis> は通常、特別なIDジェネレータを" +"使います。（この例では関連の方向が逆になっていることに注意してください）" -#: index.docbook:66 +#. Tag: programlisting +#: association_mapping.xml:66 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"foreign\">\n" - " <param name=\"property\">person</param>\n" - " </generator>\n" - " </id>\n" - " <one-to-one name=\"person\" constrained=\"true\"/>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"foreign\">\n" +" <param name=\"property\">person</param>\n" +" </generator>\n" +" </id>\n" +" <one-to-one name=\"person\" constrained=\"true\"/>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"id\" column=\"personId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - "</class> -\n" - " -\n" - "<class name=\"Address\"> -\n" - " <id name=\"id\" column=\"personId\"> -\n" - " <generator class=\"foreign\"> -\n" - " <param name=\"property\">person</param> -\n" - " </generator> -\n" - " </id> -\n" - " <one-to-one name=\"person\" constrained=\"true\"/> -\n" - "</class>]]>" -#: index.docbook:67, index.docbook:201 +#. Tag: programlisting +#: association_mapping.xml:67 association_mapping.xml:201 +#, no-c-format msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key )\n" - "create table Address ( personId bigint not null primary key )\n" - " ]]>" +"<![CDATA[\n" +"create table Person ( personId bigint not null primary key )\n" +"create table Address ( personId bigint not null primary key )\n" +" ]]>" msgstr "" - "<![CDATA[ -\n" - "create table Person ( personId bigint not null primary key ) -\n" - "create table Address ( personId bigint not null primary key ) -\n" - " ]]>" -#: index.docbook:72, index.docbook:94 +#. Tag: title +#: association_mapping.xml:72 association_mapping.xml:94 +#, no-c-format msgid "one to many" -msgstr "<title>一対多</title>" +msgstr "一対多" -#: index.docbook:74 -msgid "A <emphasis>unidirectional one-to-many association on a foreign key</emphasis> is a very unusual case, and is not really recommended." -msgstr "<emphasis>外部キーの単方向一対多関連</emphasis> はとても特殊なケースで、あまり推奨されていません。" +#. Tag: para +#: association_mapping.xml:74 +#, no-c-format +msgid "" +"A <emphasis>unidirectional one-to-many association on a foreign key</" +"emphasis> is a very unusual case, and is not really recommended." +msgstr "" +"<emphasis>外部キーの単方向一対多関連</emphasis> はとても特殊なケースで、あま" +"り推奨されていません。" -#: index.docbook:79 +#. Tag: programlisting +#: association_mapping.xml:79 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <set name=\"addresses\">\n" - " <key column=\"personId\" \n" - " not-null=\"true\"/>\n" - " <one-to-many class=\"Address\"/>\n" - " </set>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <set name=\"addresses\">\n" +" <key column=\"personId\" \n" +" not-null=\"true\"/>\n" +" <one-to-many class=\"Address\"/>\n" +" </set>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"id\" column=\"personId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <set name=\"addresses\"> -\n" - " <key column=\"personId\" -\n" - " not-null=\"true\"/> -\n" - " <one-to-many class=\"Address\"/> -\n" - " </set> -\n" - "</class> -\n" - " -\n" - "<class name=\"Address\"> -\n" - " <id name=\"id\" column=\"addressId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - "</class>]]>" -#: index.docbook:80 +#. Tag: programlisting +#: association_mapping.xml:80 +#, no-c-format msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key )\n" - "create table Address ( addressId bigint not null primary key, personId bigint not null )\n" - " ]]>" +"<![CDATA[\n" +"create table Person ( personId bigint not null primary key )\n" +"create table Address ( addressId bigint not null primary key, personId " +"bigint not null )\n" +" ]]>" msgstr "" - "<![CDATA[ -\n" - "create table Person ( personId bigint not null primary key ) -\n" - "create table Address ( addressId bigint not null primary key, personId bigint not null ) -\n" - " ]]>" -#: index.docbook:82 +#. Tag: para +#: association_mapping.xml:82 +#, no-c-format msgid "We think it's better to use a join table for this kind of association." msgstr "このような関連のために結合テーブルを使うことをお薦めします。" -#: index.docbook:91 +#. Tag: title +#: association_mapping.xml:91 +#, no-c-format msgid "Unidirectional associations with join tables" msgstr "結合テーブルを使った単方向関連" -#: index.docbook:96 -msgid "A <emphasis>unidirectional one-to-many association on a join table</emphasis> is much preferred. Notice that by specifying <literal>unique=\"true\"</literal>, we have changed the multiplicity from many-to-many to one-to-many." -msgstr "<emphasis>結合テーブルを使った単方向一対多関連</emphasis> はより好ましいです。 <literal>unique=\"true\"</literal> の指定により、多重度が多対多から一対多に変わったことに注意して下さい。" +#. Tag: para +#: association_mapping.xml:96 +#, no-c-format +msgid "" +"A <emphasis>unidirectional one-to-many association on a join table</" +"emphasis> is much preferred. Notice that by specifying <literal>unique=\"true" +"\"</literal>, we have changed the multiplicity from many-to-many to one-to-" +"many." +msgstr "" +"<emphasis>結合テーブルを使った単方向一対多関連</emphasis> はより好ましいで" +"す。 <literal>unique=\"true\"</literal> の指定により、多重度が多対多から一対" +"多に変わったことに注意して下さい。" -#: index.docbook:102 +#. Tag: programlisting +#: association_mapping.xml:102 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <set name=\"addresses\" table=\"PersonAddress\">\n" - " <key column=\"personId\"/>\n" - " <many-to-many column=\"addressId\"\n" - " unique=\"true\"\n" - " class=\"Address\"/>\n" - " </set>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <set name=\"addresses\" table=\"PersonAddress\">\n" +" <key column=\"personId\"/>\n" +" <many-to-many column=\"addressId\"\n" +" unique=\"true\"\n" +" class=\"Address\"/>\n" +" </set>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"id\" column=\"personId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <set name=\"addresses\" table=\"PersonAddress\"> -\n" - " <key column=\"personId\"/> -\n" - " <many-to-many column=\"addressId\" -\n" - " unique=\"true\" -\n" - " class=\"Address\"/> -\n" - " </set> -\n" - "</class> -\n" - " -\n" - "<class name=\"Address\"> -\n" - " <id name=\"id\" column=\"addressId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - "</class>]]>" -#: index.docbook:103 +#. Tag: programlisting +#: association_mapping.xml:103 +#, no-c-format msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key )\n" - "create table PersonAddress ( personId not null, addressId bigint not null primary key )\n" - "create table Address ( addressId bigint not null primary key )\n" - " ]]>" +"<![CDATA[\n" +"create table Person ( personId bigint not null primary key )\n" +"create table PersonAddress ( personId not null, addressId bigint not null " +"primary key )\n" +"create table Address ( addressId bigint not null primary key )\n" +" ]]>" msgstr "" - "<![CDATA[ -\n" - "create table Person ( personId bigint not null primary key ) -\n" - "create table PersonAddress ( personId not null, addressId bigint not null primary key ) -\n" - "create table Address ( addressId bigint not null primary key ) -\n" - " ]]>" -#: index.docbook:110 -msgid "A <emphasis>unidirectional many-to-one association on a join table</emphasis> is quite common when the association is optional." -msgstr "<emphasis>結合テーブルの単方向多対一関連</emphasis> は関連が任意であるときに非常に一般的なものです。" +#. Tag: para +#: association_mapping.xml:110 +#, no-c-format +msgid "" +"A <emphasis>unidirectional many-to-one association on a join table</" +"emphasis> is quite common when the association is optional." +msgstr "" +"<emphasis>結合テーブルの単方向多対一関連</emphasis> は関連が任意であるときに" +"非常に一般的なものです。" -#: index.docbook:115 +#. Tag: programlisting +#: association_mapping.xml:115 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <join table=\"PersonAddress\" \n" - " optional=\"true\">\n" - " <key column=\"personId\" unique=\"true\"/>\n" - " <many-to-one name=\"address\"\n" - " column=\"addressId\" \n" - " not-null=\"true\"/>\n" - " </join>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <join table=\"PersonAddress\" \n" +" optional=\"true\">\n" +" <key column=\"personId\" unique=\"true\"/>\n" +" <many-to-one name=\"address\"\n" +" column=\"addressId\" \n" +" not-null=\"true\"/>\n" +" </join>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"id\" column=\"personId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <join table=\"PersonAddress\" -\n" - " optional=\"true\"> -\n" - " <key column=\"personId\" unique=\"true\"/> -\n" - " <many-to-one name=\"address\" -\n" - " column=\"addressId\" -\n" - " not-null=\"true\"/> -\n" - " </join> -\n" - "</class> -\n" - " -\n" - "<class name=\"Address\"> -\n" - " <id name=\"id\" column=\"addressId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - "</class>]]>" -#: index.docbook:116 +#. Tag: programlisting +#: association_mapping.xml:116 +#, no-c-format msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key )\n" - "create table PersonAddress ( personId bigint not null primary key, addressId bigint not null )\n" - "create table Address ( addressId bigint not null primary key )\n" - " ]]>" +"<![CDATA[\n" +"create table Person ( personId bigint not null primary key )\n" +"create table PersonAddress ( personId bigint not null primary key, addressId " +"bigint not null )\n" +"create table Address ( addressId bigint not null primary key )\n" +" ]]>" msgstr "" - "<![CDATA[ -\n" - "create table Person ( personId bigint not null primary key ) -\n" - "create table PersonAddress ( personId bigint not null primary key, addressId bigint not null ) -\n" - "create table Address ( addressId bigint not null primary key ) -\n" - " ]]>" -#: index.docbook:123 -msgid "A <emphasis>unidirectional one-to-one association on a join table</emphasis> is extremely unusual, but possible." -msgstr "<emphasis>結合テーブルの単方向一対一関連</emphasis> は、本当に特殊ですが不可能ではありません。" +#. Tag: para +#: association_mapping.xml:123 +#, no-c-format +msgid "" +"A <emphasis>unidirectional one-to-one association on a join table</emphasis> " +"is extremely unusual, but possible." +msgstr "" +"<emphasis>結合テーブルの単方向一対一関連</emphasis> は、本当に特殊ですが不可" +"能ではありません。" -#: index.docbook:128 +#. Tag: programlisting +#: association_mapping.xml:128 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <join table=\"PersonAddress\" \n" - " optional=\"true\">\n" - " <key column=\"personId\" \n" - " unique=\"true\"/>\n" - " <many-to-one name=\"address\"\n" - " column=\"addressId\" \n" - " not-null=\"true\"\n" - " unique=\"true\"/>\n" - " </join>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <join table=\"PersonAddress\" \n" +" optional=\"true\">\n" +" <key column=\"personId\" \n" +" unique=\"true\"/>\n" +" <many-to-one name=\"address\"\n" +" column=\"addressId\" \n" +" not-null=\"true\"\n" +" unique=\"true\"/>\n" +" </join>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"id\" column=\"personId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <join table=\"PersonAddress\" -\n" - " optional=\"true\"> -\n" - " <key column=\"personId\" -\n" - " unique=\"true\"/> -\n" - " <many-to-one name=\"address\" -\n" - " column=\"addressId\" -\n" - " not-null=\"true\" -\n" - " unique=\"true\"/> -\n" - " </join> -\n" - "</class> -\n" - " -\n" - "<class name=\"Address\"> -\n" - " <id name=\"id\" column=\"addressId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - "</class>]]>" -#: index.docbook:129, index.docbook:233 +#. Tag: programlisting +#: association_mapping.xml:129 association_mapping.xml:233 +#, no-c-format msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key )\n" - "create table PersonAddress ( personId bigint not null primary key, addressId bigint not null unique )\n" - "create table Address ( addressId bigint not null primary key )\n" - " ]]>" +"<![CDATA[\n" +"create table Person ( personId bigint not null primary key )\n" +"create table PersonAddress ( personId bigint not null primary key, addressId " +"bigint not null unique )\n" +"create table Address ( addressId bigint not null primary key )\n" +" ]]>" msgstr "" - "<![CDATA[ -\n" - "create table Person ( personId bigint not null primary key ) -\n" - "create table PersonAddress ( personId bigint not null primary key, addressId bigint not null unique ) -\n" - "create table Address ( addressId bigint not null primary key ) -\n" - " ]]>" -#: index.docbook:134, index.docbook:238 +#. Tag: title +#: association_mapping.xml:134 association_mapping.xml:238 +#, no-c-format msgid "many to many" -msgstr "<title>多対多</title>" +msgstr "多対多" -#: index.docbook:136 -msgid "Finally, we have a <emphasis>unidirectional many-to-many association</emphasis>." +#. Tag: para +#: association_mapping.xml:136 +#, no-c-format +msgid "" +"Finally, we have a <emphasis>unidirectional many-to-many association</" +"emphasis>." msgstr "最後に、<emphasis>単方向多対多関連</emphasis> を示します。" -#: index.docbook:140 +#. Tag: programlisting +#: association_mapping.xml:140 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <set name=\"addresses\" table=\"PersonAddress\">\n" - " <key column=\"personId\"/>\n" - " <many-to-many column=\"addressId\"\n" - " class=\"Address\"/>\n" - " </set>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <set name=\"addresses\" table=\"PersonAddress\">\n" +" <key column=\"personId\"/>\n" +" <many-to-many column=\"addressId\"\n" +" class=\"Address\"/>\n" +" </set>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"id\" column=\"personId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <set name=\"addresses\" table=\"PersonAddress\"> -\n" - " <key column=\"personId\"/> -\n" - " <many-to-many column=\"addressId\" -\n" - " class=\"Address\"/> -\n" - " </set> -\n" - "</class> -\n" - " -\n" - "<class name=\"Address\"> -\n" - " <id name=\"id\" column=\"addressId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - "</class>]]>" -#: index.docbook:141, index.docbook:246 +#. Tag: programlisting +#: association_mapping.xml:141 association_mapping.xml:246 +#, no-c-format msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key )\n" - "create table PersonAddress ( personId bigint not null, addressId bigint not null, primary key (personId, addressId) )\n" - "create table Address ( addressId bigint not null primary key )\n" - " ]]>" +"<![CDATA[\n" +"create table Person ( personId bigint not null primary key )\n" +"create table PersonAddress ( personId bigint not null, addressId bigint not " +"null, primary key (personId, addressId) )\n" +"create table Address ( addressId bigint not null primary key )\n" +" ]]>" msgstr "" - "<![CDATA[ -\n" - "create table Person ( personId bigint not null primary key ) -\n" - "create table PersonAddress ( personId bigint not null, addressId bigint not null, primary key (personId, addressId) ) -\n" - "create table Address ( addressId bigint not null primary key ) -\n" - " ]]>" -#: index.docbook:148 +#. Tag: title +#: association_mapping.xml:148 +#, no-c-format msgid "Bidirectional associations" msgstr "双方向関連" -#: index.docbook:151, index.docbook:211 +#. Tag: title +#: association_mapping.xml:151 association_mapping.xml:211 +#, no-c-format msgid "one to many / many to one" msgstr "一対多/多対一" -#: index.docbook:153 -msgid "A <emphasis>bidirectional many-to-one association</emphasis> is the most common kind of association. (This is the standard parent/child relationship.)" -msgstr "<emphasis>双方向多対一関連</emphasis> は最も一般的な関連です。（標準的な親子関係です）" +#. Tag: para +#: association_mapping.xml:153 +#, no-c-format +msgid "" +"A <emphasis>bidirectional many-to-one association</emphasis> is the most " +"common kind of association. (This is the standard parent/child relationship.)" +msgstr "" +"<emphasis>双方向多対一関連</emphasis> は最も一般的な関連です。（標準的な親子" +"関係です）" -#: index.docbook:159 +#. Tag: programlisting +#: association_mapping.xml:159 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <many-to-one name=\"address\" \n" - " column=\"addressId\"\n" - " not-null=\"true\"/>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <set name=\"people\" inverse=\"true\">\n" - " <key column=\"addressId\"/>\n" - " <one-to-many class=\"Person\"/>\n" - " </set>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <many-to-one name=\"address\" \n" +" column=\"addressId\"\n" +" not-null=\"true\"/>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <set name=\"people\" inverse=\"true\">\n" +" <key column=\"addressId\"/>\n" +" <one-to-many class=\"Person\"/>\n" +" </set>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"id\" column=\"personId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <many-to-one name=\"address\" -\n" - " column=\"addressId\" -\n" - " not-null=\"true\"/> -\n" - "</class> -\n" - " -\n" - "<class name=\"Address\"> -\n" - " <id name=\"id\" column=\"addressId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <set name=\"people\" inverse=\"true\"> -\n" - " <key column=\"addressId\"/> -\n" - " <one-to-many class=\"Person\"/> -\n" - " </set> -\n" - "</class>]]>" -#: index.docbook:163 -msgid "If you use a <literal>List</literal> (or other indexed collection) you need to set the <literal>key</literal> column of the foreign key to <literal>not null</literal>, and let Hibernate manage the association from the collections side to maintain the index of each element (making the other side virtually inverse by setting <literal>update=\"false\"</literal> and <literal>insert=\"false\"</literal>):" -msgstr "<literal>List</literal> （または他のインデックス付きのコレクション）を使うなら、外部キーの <literal>key</literal> カラムを <literal>not null</literal> に設定し、コレクション側が各要素のインデックスをメンテナンスするように、関連を扱う必要があります（<literal>update=\"false\"</literal> かつ <literal>insert=\"false\"</literal> と設定して、反対側を仮想的にinverseにします）：" +#. Tag: para +#: association_mapping.xml:163 +#, no-c-format +msgid "" +"If you use a <literal>List</literal> (or other indexed collection) you need " +"to set the <literal>key</literal> column of the foreign key to <literal>not " +"null</literal>, and let Hibernate manage the association from the " +"collections side to maintain the index of each element (making the other " +"side virtually inverse by setting <literal>update=\"false\"</literal> and " +"<literal>insert=\"false\"</literal>):" +msgstr "" +"<literal>List</literal> （または他のインデックス付きのコレクション）を使うな" +"ら、外部キーの <literal>key</literal> カラムを <literal>not null</literal> " +"に設定し、コレクション側が各要素のインデックスをメンテナンスするように、関" +"連を扱う必要があります（<literal>update=\"false\"</literal> かつ " +"<literal>insert=\"false\"</literal> と設定して、反対側を仮想的にinverseにしま" +"す）：" -#: index.docbook:171 +#. Tag: programlisting +#: association_mapping.xml:171 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\"/>\n" - " ...\n" - " <many-to-one name=\"address\"\n" - " column=\"addressId\"\n" - " not-null=\"true\"\n" - " insert=\"false\"\n" - " update=\"false\"/>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\"/>\n" - " ...\n" - " <list name=\"people\">\n" - " <key column=\"addressId\" not-null=\"true\"/>\n" - " <list-index column=\"peopleIdx\"/>\n" - " <one-to-many class=\"Person\"/>\n" - " </list>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\"/>\n" +" ...\n" +" <many-to-one name=\"address\"\n" +" column=\"addressId\"\n" +" not-null=\"true\"\n" +" insert=\"false\"\n" +" update=\"false\"/>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\"/>\n" +" ...\n" +" <list name=\"people\">\n" +" <key column=\"addressId\" not-null=\"true\"/>\n" +" <list-index column=\"peopleIdx\"/>\n" +" <one-to-many class=\"Person\"/>\n" +" </list>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"id\"/> -\n" - " ... -\n" - " <many-to-one name=\"address\" -\n" - " column=\"addressId\" -\n" - " not-null=\"true\" -\n" - " insert=\"false\" -\n" - " update=\"false\"/> -\n" - "</class> -\n" - " -\n" - "<class name=\"Address\"> -\n" - " <id name=\"id\"/> -\n" - " ... -\n" - " <list name=\"people\"> -\n" - " <key column=\"addressId\" not-null=\"true\"/> -\n" - " <list-index column=\"peopleIdx\"/> -\n" - " <one-to-many class=\"Person\"/> -\n" - " </list> -\n" - "</class>]]>" -#: index.docbook:173 -msgid "It is important that you define <literal>not-null=\"true\"</literal> on the <literal><key></literal> element of the collection mapping if the underlying foreign key column is <literal>NOT NULL</literal>. Don't only declare <literal>not-null=\"true\"</literal> on a possible nested <literal><column></literal> element, but on the <literal><key></literal> element." -msgstr "もし外部キーカラムが <literal>NOT NULL</literal> であるならば、コレクションマッピングの <literal><key></literal> 要素を <literal>not-null=\"true\"</literal> にすることは重要です。入れ子になった <literal><column></literal> 要素だけではなく、 <literal><key></literal> 要素も <literal>not-null=\"true\"</literal> と定義しないようにしてください。" +#. Tag: para +#: association_mapping.xml:173 +#, no-c-format +msgid "" +"It is important that you define <literal>not-null=\"true\"</literal> on the " +"<literal><key></literal> element of the collection mapping if the " +"underlying foreign key column is <literal>NOT NULL</literal>. Don't only " +"declare <literal>not-null=\"true\"</literal> on a possible nested " +"<literal><column></literal> element, but on the <literal><key></" +"literal> element." +msgstr "" +"もし外部キーカラムが <literal>NOT NULL</literal> であるならば、コレクション" +"マッピングの <literal><key></literal> 要素を <literal>not-null=\"true" +"\"</literal> にすることは重要です。入れ子になった <literal><column></" +"literal> 要素だけではなく、 <literal><key></literal> 要素も " +"<literal>not-null=\"true\"</literal> と定義しないようにしてください。" -#: index.docbook:187 -msgid "A <emphasis>bidirectional one-to-one association on a foreign key</emphasis> is quite common." +#. Tag: para +#: association_mapping.xml:187 +#, no-c-format +msgid "" +"A <emphasis>bidirectional one-to-one association on a foreign key</emphasis> " +"is quite common." msgstr "<emphasis>外部キーの双方向一対一関連</emphasis> は非常に一般的です。" -#: index.docbook:192 +#. Tag: programlisting +#: association_mapping.xml:192 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <many-to-one name=\"address\" \n" - " column=\"addressId\" \n" - " unique=\"true\"\n" - " not-null=\"true\"/>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <one-to-one name=\"person\" \n" - " property-ref=\"address\"/>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <many-to-one name=\"address\" \n" +" column=\"addressId\" \n" +" unique=\"true\"\n" +" not-null=\"true\"/>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <one-to-one name=\"person\" \n" +" property-ref=\"address\"/>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"id\" column=\"personId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <many-to-one name=\"address\" -\n" - " column=\"addressId\" -\n" - " unique=\"true\" -\n" - " not-null=\"true\"/> -\n" - "</class> -\n" - " -\n" - "<class name=\"Address\"> -\n" - " <id name=\"id\" column=\"addressId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <one-to-one name=\"person\" -\n" - " property-ref=\"address\"/> -\n" - "</class>]]>" -#: index.docbook:195 -msgid "A <emphasis>bidirectional one-to-one association on a primary key</emphasis> uses the special id generator." -msgstr "<emphasis>主キーの双方向一対一関連</emphasis> は特殊なIDジェネレータを使います。" +#. Tag: para +#: association_mapping.xml:195 +#, no-c-format +msgid "" +"A <emphasis>bidirectional one-to-one association on a primary key</emphasis> " +"uses the special id generator." +msgstr "" +"<emphasis>主キーの双方向一対一関連</emphasis> は特殊なIDジェネレータを使いま" +"す。" -#: index.docbook:200 +#. Tag: programlisting +#: association_mapping.xml:200 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <one-to-one name=\"address\"/>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"foreign\">\n" - " <param name=\"property\">person</param>\n" - " </generator>\n" - " </id>\n" - " <one-to-one name=\"person\" \n" - " constrained=\"true\"/>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <one-to-one name=\"address\"/>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"foreign\">\n" +" <param name=\"property\">person</param>\n" +" </generator>\n" +" </id>\n" +" <one-to-one name=\"person\" \n" +" constrained=\"true\"/>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"id\" column=\"personId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <one-to-one name=\"address\"/> -\n" - "</class> -\n" - " -\n" - "<class name=\"Address\"> -\n" - " <id name=\"id\" column=\"personId\"> -\n" - " <generator class=\"foreign\"> -\n" - " <param name=\"property\">person</param> -\n" - " </generator> -\n" - " </id> -\n" - " <one-to-one name=\"person\" -\n" - " constrained=\"true\"/> -\n" - "</class>]]>" -#: index.docbook:208 +#. Tag: title +#: association_mapping.xml:208 +#, no-c-format msgid "Bidirectional associations with join tables" msgstr "結合テーブルを使った双方向関連" -#: index.docbook:213 -msgid "A <emphasis>bidirectional one-to-many association on a join table</emphasis>. Note that the <literal>inverse=\"true\"</literal> can go on either end of the association, on the collection, or on the join." -msgstr "<emphasis>結合テーブルの双方向一対多関連</emphasis> です。 <literal>inverse=\"true\"</literal> が関連端、コレクション、結合のいずれかに設定できることに注意してください。" +#. Tag: para +#: association_mapping.xml:213 +#, no-c-format +msgid "" +"A <emphasis>bidirectional one-to-many association on a join table</" +"emphasis>. Note that the <literal>inverse=\"true\"</literal> can go on " +"either end of the association, on the collection, or on the join." +msgstr "" +"<emphasis>結合テーブルの双方向一対多関連</emphasis> です。 <literal>inverse=" +"\"true\"</literal> が関連端、コレクション、結合のいずれかに設定できることに" +"注意してください。" -#: index.docbook:219 +#. Tag: programlisting +#: association_mapping.xml:219 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <set name=\"addresses\" \n" - " table=\"PersonAddress\">\n" - " <key column=\"personId\"/>\n" - " <many-to-many column=\"addressId\"\n" - " unique=\"true\"\n" - " class=\"Address\"/>\n" - " </set>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <join table=\"PersonAddress\" \n" - " inverse=\"true\" \n" - " optional=\"true\">\n" - " <key column=\"addressId\"/>\n" - " <many-to-one name=\"person\"\n" - " column=\"personId\"\n" - " not-null=\"true\"/>\n" - " </join>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <set name=\"addresses\" \n" +" table=\"PersonAddress\">\n" +" <key column=\"personId\"/>\n" +" <many-to-many column=\"addressId\"\n" +" unique=\"true\"\n" +" class=\"Address\"/>\n" +" </set>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <join table=\"PersonAddress\" \n" +" inverse=\"true\" \n" +" optional=\"true\">\n" +" <key column=\"addressId\"/>\n" +" <many-to-one name=\"person\"\n" +" column=\"personId\"\n" +" not-null=\"true\"/>\n" +" </join>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"id\" column=\"personId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <set name=\"addresses\" -\n" - " table=\"PersonAddress\"> -\n" - " <key column=\"personId\"/> -\n" - " <many-to-many column=\"addressId\" -\n" - " unique=\"true\" -\n" - " class=\"Address\"/> -\n" - " </set> -\n" - "</class> -\n" - " -\n" - "<class name=\"Address\"> -\n" - " <id name=\"id\" column=\"addressId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <join table=\"PersonAddress\" -\n" - " inverse=\"true\" -\n" - " optional=\"true\"> -\n" - " <key column=\"addressId\"/> -\n" - " <many-to-one name=\"person\" -\n" - " column=\"personId\" -\n" - " not-null=\"true\"/> -\n" - " </join> -\n" - "</class>]]>" -#: index.docbook:220 +#. Tag: programlisting +#: association_mapping.xml:220 +#, no-c-format msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key )\n" - "create table PersonAddress ( personId bigint not null, addressId bigint not null primary key )\n" - "create table Address ( addressId bigint not null primary key )\n" - " ]]>" +"<![CDATA[\n" +"create table Person ( personId bigint not null primary key )\n" +"create table PersonAddress ( personId bigint not null, addressId bigint not " +"null primary key )\n" +"create table Address ( addressId bigint not null primary key )\n" +" ]]>" msgstr "" - "<![CDATA[ -\n" - "create table Person ( personId bigint not null primary key ) -\n" - "create table PersonAddress ( personId bigint not null, addressId bigint not null primary key ) -\n" - "create table Address ( addressId bigint not null primary key ) -\n" - " ]]>" -#: index.docbook:227 -msgid "A <emphasis>bidirectional one-to-one association on a join table</emphasis> is extremely unusual, but possible." -msgstr "<emphasis>結合テーブルの双方向一対一関連</emphasis> は非常に特殊ですが、可能です。" +#. Tag: para +#: association_mapping.xml:227 +#, no-c-format +msgid "" +"A <emphasis>bidirectional one-to-one association on a join table</emphasis> " +"is extremely unusual, but possible." +msgstr "" +"<emphasis>結合テーブルの双方向一対一関連</emphasis> は非常に特殊ですが、可能" +"です。" -#: index.docbook:232 +#. Tag: programlisting +#: association_mapping.xml:232 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <join table=\"PersonAddress\" \n" - " optional=\"true\">\n" - " <key column=\"personId\" \n" - " unique=\"true\"/>\n" - " <many-to-one name=\"address\"\n" - " column=\"addressId\" \n" - " not-null=\"true\"\n" - " unique=\"true\"/>\n" - " </join>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <join table=\"PersonAddress\" \n" - " optional=\"true\"\n" - " inverse=\"true\">\n" - " <key column=\"addressId\" \n" - " unique=\"true\"/>\n" - " <many-to-one name=\"person\"\n" - " column=\"personId\" \n" - " not-null=\"true\"\n" - " unique=\"true\"/>\n" - " </join>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <join table=\"PersonAddress\" \n" +" optional=\"true\">\n" +" <key column=\"personId\" \n" +" unique=\"true\"/>\n" +" <many-to-one name=\"address\"\n" +" column=\"addressId\" \n" +" not-null=\"true\"\n" +" unique=\"true\"/>\n" +" </join>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <join table=\"PersonAddress\" \n" +" optional=\"true\"\n" +" inverse=\"true\">\n" +" <key column=\"addressId\" \n" +" unique=\"true\"/>\n" +" <many-to-one name=\"person\"\n" +" column=\"personId\" \n" +" not-null=\"true\"\n" +" unique=\"true\"/>\n" +" </join>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"id\" column=\"personId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <join table=\"PersonAddress\" -\n" - " optional=\"true\"> -\n" - " <key column=\"personId\" -\n" - " unique=\"true\"/> -\n" - " <many-to-one name=\"address\" -\n" - " column=\"addressId\" -\n" - " not-null=\"true\" -\n" - " unique=\"true\"/> -\n" - " </join> -\n" - "</class> -\n" - " -\n" - "<class name=\"Address\"> -\n" - " <id name=\"id\" column=\"addressId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <join table=\"PersonAddress\" -\n" - " optional=\"true\" -\n" - " inverse=\"true\"> -\n" - " <key column=\"addressId\" -\n" - " unique=\"true\"/> -\n" - " <many-to-one name=\"address\" -\n" - " column=\"personId\" -\n" - " not-null=\"true\" -\n" - " unique=\"true\"/> -\n" - " </join> -\n" - "</class>]]>" -#: index.docbook:240 -msgid "Finally, we have a <emphasis>bidirectional many-to-many association</emphasis>." +#. Tag: para +#: association_mapping.xml:240 +#, no-c-format +msgid "" +"Finally, we have a <emphasis>bidirectional many-to-many association</" +"emphasis>." msgstr "最後に、<emphasis>双方向多対多関連</emphasis> を示します。" -#: index.docbook:244 +#. Tag: programlisting +#: association_mapping.xml:244 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <set name=\"addresses\" table=\"PersonAddress\">\n" - " <key column=\"personId\"/>\n" - " <many-to-many column=\"addressId\"\n" - " class=\"Address\"/>\n" - " </set>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <set name=\"people\" inverse=\"true\" table=\"PersonAddress\">\n" - " <key column=\"addressId\"/>\n" - " <many-to-many column=\"personId\"\n" - " class=\"Person\"/>\n" - " </set>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <set name=\"addresses\" table=\"PersonAddress\">\n" +" <key column=\"personId\"/>\n" +" <many-to-many column=\"addressId\"\n" +" class=\"Address\"/>\n" +" </set>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <set name=\"people\" inverse=\"true\" table=\"PersonAddress\">\n" +" <key column=\"addressId\"/>\n" +" <many-to-many column=\"personId\"\n" +" class=\"Person\"/>\n" +" </set>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"id\" column=\"personId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <set name=\"addresses\" table=\"PersonAddress\"> -\n" - " <key column=\"personId\"/> -\n" - " <many-to-many column=\"addressId\" -\n" - " class=\"Address\"/> -\n" - " </set> -\n" - "</class> -\n" - " -\n" - "<class name=\"Address\"> -\n" - " <id name=\"id\" column=\"addressId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <set name=\"people\" inverse=\"true\" table=\"PersonAddress\"> -\n" - " <key column=\"addressId\"/> -\n" - " <many-to-many column=\"personId\" -\n" - " class=\"Person\"/> -\n" - " </set> -\n" - "</class>]]>" -#: index.docbook:253 +#. Tag: title +#: association_mapping.xml:253 +#, no-c-format msgid "More complex association mappings" msgstr "より複雑な関連マッピング" -#: index.docbook:255 -msgid "More complex association joins are <emphasis>extremely</emphasis> rare. Hibernate makes it possible to handle more complex situations using SQL fragments embedded in the mapping document. For example, if a table with historical account information data defines <literal>accountNumber</literal>, <literal>effectiveEndDate</literal> and <literal>effectiveStartDate</literal>columns, mapped as follows:" -msgstr "より複雑な関連結合は <emphasis>極めて</emphasis> 稀です。マッピングドキュメントにSQL文を埋め込むことで、さらに複雑な状況を扱うことができます。例えば、<literal>accountNumber</literal>, <literal>effectiveEndDate</literal>, <literal>effectiveStartDate</literal> カラムを持つaccount（口座）情報の履歴を扱うテーブルは、以下のようにマッピングします。" +#. Tag: para +#: association_mapping.xml:255 +#, no-c-format +msgid "" +"More complex association joins are <emphasis>extremely</emphasis> rare. " +"Hibernate makes it possible to handle more complex situations using SQL " +"fragments embedded in the mapping document. For example, if a table with " +"historical account information data defines <literal>accountNumber</" +"literal>, <literal>effectiveEndDate</literal> and " +"<literal>effectiveStartDate</literal>columns, mapped as follows:" +msgstr "" +"より複雑な関連結合は <emphasis>極めて</emphasis> 稀です。マッピングドキュメ" +"ントにSQL文を埋め込むことで、さらに複雑な状況を扱うことができます。例えば、" +"<literal>accountNumber</literal>, <literal>effectiveEndDate</literal>, " +"<literal>effectiveStartDate</literal> カラムを持つaccount（口座）情報の履歴を" +"扱うテーブルは、以下のようにマッピングします。" -#: index.docbook:264 +#. Tag: programlisting +#: association_mapping.xml:264 +#, no-c-format msgid "" - "<![CDATA[<properties name=\"currentAccountKey\">\n" - " <property name=\"accountNumber\" type=\"string\" not-null=\"true\"/>\n" - " <property name=\"currentAccount\" type=\"boolean\">\n" - " <formula>case when effectiveEndDate is null then 1 else 0 end</formula>\n" - " </property>\n" - "</properties>\n" - "<property name=\"effectiveEndDate\" type=\"date\"/>\n" - "<property name=\"effectiveStateDate\" type=\"date\" not-null=\"true\"/>]]>" +"<![CDATA[<properties name=\"currentAccountKey\">\n" +" <property name=\"accountNumber\" type=\"string\" not-null=\"true\"/>\n" +" <property name=\"currentAccount\" type=\"boolean\">\n" +" <formula>case when effectiveEndDate is null then 1 else 0 end</" +"formula>\n" +" </property>\n" +"</properties>\n" +"<property name=\"effectiveEndDate\" type=\"date\"/>\n" +"<property name=\"effectiveStateDate\" type=\"date\" not-null=\"true\"/>]]>" msgstr "" - "<![CDATA[<properties name=\"currentAccountKey\"> -\n" - " <property name=\"accountNumber\" type=\"string\" not-null=\"true\"/> -\n" - " <property name=\"currentAccount\" type=\"boolean\"> -\n" - " <formula>case when effectiveEndDate is null then 1 else 0 end</formula> -\n" - " </property> -\n" - "</properties> -\n" - "<property name=\"effectiveEndDate\" type=\"date\"/> -\n" - "<property name=\"effectiveStateDate\" type=\"date\" not-null=\"true\"/>]]>" -#: index.docbook:266 -msgid "Then we can map an association to the <emphasis>current</emphasis> instance (the one with null <literal>effectiveEndDate</literal>) using:" -msgstr "そして、関連を <emphasis>現時点の</emphasis> インスタンス（<literal>effectiveEndDate</literal> がnullであるもの）にマッピングします。以下のようになります：" +#. Tag: para +#: association_mapping.xml:266 +#, no-c-format +msgid "" +"Then we can map an association to the <emphasis>current</emphasis> instance " +"(the one with null <literal>effectiveEndDate</literal>) using:" +msgstr "" +"そして、関連を <emphasis>現時点の</emphasis> インスタンス " +"（<literal>effectiveEndDate</literal> がnullであるもの）にマッピングします。 " +"以下のようになります：" -#: index.docbook:271 +#. Tag: programlisting +#: association_mapping.xml:271 +#, no-c-format msgid "" - "<![CDATA[<many-to-one name=\"currentAccountInfo\" \n" - " property-ref=\"currentAccountKey\"\n" - " class=\"AccountInfo\">\n" - " <column name=\"accountNumber\"/>\n" - " <formula>'1'</formula>\n" - "</many-to-one>]]>" +"<![CDATA[<many-to-one name=\"currentAccountInfo\" \n" +" property-ref=\"currentAccountKey\"\n" +" class=\"AccountInfo\">\n" +" <column name=\"accountNumber\"/>\n" +" <formula>'1'</formula>\n" +"</many-to-one>]]>" msgstr "" - "<![CDATA[<many-to-one name=\"currentAccountInfo\" -\n" - " property-ref=\"currentAccountKey\" -\n" - " class=\"AccountInfo\"> -\n" - " <column name=\"accountNumber\"/> -\n" - " <formula>'1'</formula> -\n" - "</many-to-one>]]>" -#: index.docbook:273 -msgid "In a more complex example, imagine that the association between <literal>Employee</literal> and <literal>Organization</literal> is maintained in an <literal>Employment</literal> table full of historical employment data. Then an association to the employee's <emphasis>most recent</emphasis> employer (the one with the most recent <literal>startDate</literal>) might be mapped this way:" -msgstr "さらに複雑な例では、<literal>Employee（従業員）</literal> と <literal>Organization（組織）</literal> 間の関連が <literal>Employment（雇用）</literal> テーブルで保持される場合を想像してください。このテーブルには雇用データの履歴がすべて含まれます。すると従業員の <emphasis>最も最近の</emphasis> 雇用者を表す関連（最も最近の <literal>startDate</literal> を持つもの）は、このようにマッピングできます：" +#. Tag: para +#: association_mapping.xml:273 +#, no-c-format +msgid "" +"In a more complex example, imagine that the association between " +"<literal>Employee</literal> and <literal>Organization</literal> is " +"maintained in an <literal>Employment</literal> table full of historical " +"employment data. Then an association to the employee's <emphasis>most " +"recent</emphasis> employer (the one with the most recent <literal>startDate</" +"literal>) might be mapped this way:" +msgstr "" +"さらに複雑な例では、<literal>Employee（従業員）</literal> と " +"<literal>Organization（組織）</literal> 間の関連が <literal>Employment（雇" +"用）</literal> テーブルで保持される場合を想像してください。このテーブルには" +"雇用データの履歴がすべて含まれます。すると従業員の <emphasis>最も最近の</" +"emphasis> 雇用者を表す関連（最も最近の <literal>startDate</literal> を持つも" +"の）は、このようにマッピングできます：" -#: index.docbook:281 +#. Tag: programlisting +#: association_mapping.xml:281 +#, no-c-format msgid "" - "<![CDATA[<join>\n" - " <key column=\"employeeId\"/>\n" - " <subselect>\n" - " select employeeId, orgId \n" - " from Employments \n" - " group by orgId \n" - " having startDate = max(startDate)\n" - " </subselect>\n" - " <many-to-one name=\"mostRecentEmployer\" \n" - " class=\"Organization\" \n" - " column=\"orgId\"/>\n" - "</join>]]>" +"<![CDATA[<join>\n" +" <key column=\"employeeId\"/>\n" +" <subselect>\n" +" select employeeId, orgId \n" +" from Employments \n" +" group by orgId \n" +" having startDate = max(startDate)\n" +" </subselect>\n" +" <many-to-one name=\"mostRecentEmployer\" \n" +" class=\"Organization\" \n" +" column=\"orgId\"/>\n" +"</join>]]>" msgstr "" - "<![CDATA[<join> -\n" - " <key column=\"employeeId\"/> -\n" - " <subselect> -\n" - " select employeeId, orgId -\n" - " from Employments -\n" - " group by orgId -\n" - " having startDate = max(startDate) -\n" - " </subselect> -\n" - " <many-to-one name=\"mostRecentEmployer\" -\n" - " class=\"Organization\" -\n" - " column=\"orgId\"/> -\n" - "</join>]]>" -#: index.docbook:283 -msgid "You can get quite creative with this functionality, but it is usually more practical to handle these kinds of cases using HQL or a criteria query." -msgstr "この機能は非常に強力です。しかしこのような場合、普通はHQLやcriteriaクエリを使う方がより実践的です。" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "" - +#. Tag: para +#: association_mapping.xml:283 +#, no-c-format +msgid "" +"You can get quite creative with this functionality, but it is usually more " +"practical to handle these kinds of cases using HQL or a criteria query." +msgstr "" +"この機能は非常に強力です。しかしこのような場合、普通はHQLやcriteriaクエリを" +"使う方がより実践的です。" Modified: core/trunk/documentation/manual/translations/ja-JP/content/basic_mapping.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/basic_mapping.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/basic_mapping.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,3698 +1,5651 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: basic_mapping.xml:5 +#, no-c-format msgid "Basic O/R Mapping" msgstr "基本的なO/Rマッピング" -#: index.docbook:8 +#. Tag: title +#: basic_mapping.xml:8 +#, no-c-format msgid "Mapping declaration" msgstr "マッピング定義" -#: index.docbook:10 -msgid "Object/relational mappings are usually defined in an XML document. The mapping document is designed to be readable and hand-editable. The mapping language is Java-centric, meaning that mappings are constructed around persistent class declarations, not table declarations." -msgstr "オブジェクト/リレーショナルマッピングは通常XMLドキュメントで定義します。マッピングドキュメントは、読みやすく手作業で編集しやすいようにデザインされています。マッピング言語はJava中心、つまりテーブル定義ではなく永続クラスの定義に基づいて構築されています。" +#. Tag: para +#: basic_mapping.xml:10 +#, no-c-format +msgid "" +"Object/relational mappings are usually defined in an XML document. The " +"mapping document is designed to be readable and hand-editable. The mapping " +"language is Java-centric, meaning that mappings are constructed around " +"persistent class declarations, not table declarations." +msgstr "" +"オブジェクト/リレーショナルマッピングは通常XMLドキュメントで定義します。マッ" +"ピングドキュメントは、読みやすく手作業で編集しやすいようにデザインされていま" +"す。マッピング言語はJava中心、つまりテーブル定義ではなく永続クラスの定義に基" +"づいて構築されています。" -#: index.docbook:17 -msgid "Note that, even though many Hibernate users choose to write the XML by hand, a number of tools exist to generate the mapping document, including XDoclet, Middlegen and AndroMDA." -msgstr "多くのHibernateユーザはXMLマッピングの記述を手作業で行いますが、 XDoclet, Middlegen, AndroMDAというようなマッピングドキュメントを生成するツールがいくつか存在します。" +#. Tag: para +#: basic_mapping.xml:17 +#, no-c-format +msgid "" +"Note that, even though many Hibernate users choose to write the XML by hand, " +"a number of tools exist to generate the mapping document, including XDoclet, " +"Middlegen and AndroMDA." +msgstr "" +"多くのHibernateユーザはXMLマッピングの記述を手作業で行いますが、 XDoclet, " +"Middlegen, AndroMDAというようなマッピングドキュメントを生成するツールがいく" +"つか存在します。" -#: index.docbook:23 +#. Tag: para +#: basic_mapping.xml:23 +#, no-c-format msgid "Lets kick off with an example mapping:" msgstr "サンプルのマッピングから始めましょう：" -#: index.docbook:27 +#. Tag: programlisting +#: basic_mapping.xml:27 +#, no-c-format msgid "" - "<![CDATA[<?xml version=\"1.0\"?>\n" - "<!DOCTYPE hibernate-mapping PUBLIC\n" - " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" - " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" - "\n" - "<hibernate-mapping package=\"eg\">\n" - "\n" - " <class name=\"Cat\"\n" - " table=\"cats\"\n" - " discriminator-value=\"C\">\n" - "\n" - " <id name=\"id\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "\n" - " <discriminator column=\"subclass\"\n" - " type=\"character\"/>\n" - "\n" - " <property name=\"weight\"/>\n" - "\n" - " <property name=\"birthdate\"\n" - " type=\"date\"\n" - " not-null=\"true\"\n" - " update=\"false\"/>\n" - "\n" - " <property name=\"color\"\n" - " type=\"eg.types.ColorUserType\"\n" - " not-null=\"true\"\n" - " update=\"false\"/>\n" - "\n" - " <property name=\"sex\"\n" - " not-null=\"true\"\n" - " update=\"false\"/>\n" - "\n" - " <property name=\"litterId\"\n" - " column=\"litterId\"\n" - " update=\"false\"/>\n" - "\n" - " <many-to-one name=\"mother\"\n" - " column=\"mother_id\"\n" - " update=\"false\"/>\n" - "\n" - " <set name=\"kittens\"\n" - " inverse=\"true\"\n" - " order-by=\"litter_id\">\n" - " <key column=\"mother_id\"/>\n" - " <one-to-many class=\"Cat\"/>\n" - " </set>\n" - "\n" - " <subclass name=\"DomesticCat\"\n" - " discriminator-value=\"D\">\n" - "\n" - " <property name=\"name\"\n" - " type=\"string\"/>\n" - "\n" - " </subclass>\n" - "\n" - " </class>\n" - "\n" - " <class name=\"Dog\">\n" - " \n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<?xml version=\"1.0\"?>\n" +"<!DOCTYPE hibernate-mapping PUBLIC\n" +" \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" +" \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" +"\n" +"<hibernate-mapping package=\"eg\">\n" +"\n" +" <class name=\"Cat\"\n" +" table=\"cats\"\n" +" discriminator-value=\"C\">\n" +"\n" +" <id name=\"id\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +"\n" +" <discriminator column=\"subclass\"\n" +" type=\"character\"/>\n" +"\n" +" <property name=\"weight\"/>\n" +"\n" +" <property name=\"birthdate\"\n" +" type=\"date\"\n" +" not-null=\"true\"\n" +" update=\"false\"/>\n" +"\n" +" <property name=\"color\"\n" +" type=\"eg.types.ColorUserType\"\n" +" not-null=\"true\"\n" +" update=\"false\"/>\n" +"\n" +" <property name=\"sex\"\n" +" not-null=\"true\"\n" +" update=\"false\"/>\n" +"\n" +" <property name=\"litterId\"\n" +" column=\"litterId\"\n" +" update=\"false\"/>\n" +"\n" +" <many-to-one name=\"mother\"\n" +" column=\"mother_id\"\n" +" update=\"false\"/>\n" +"\n" +" <set name=\"kittens\"\n" +" inverse=\"true\"\n" +" order-by=\"litter_id\">\n" +" <key column=\"mother_id\"/>\n" +" <one-to-many class=\"Cat\"/>\n" +" </set>\n" +"\n" +" <subclass name=\"DomesticCat\"\n" +" discriminator-value=\"D\">\n" +"\n" +" <property name=\"name\"\n" +" type=\"string\"/>\n" +"\n" +" </subclass>\n" +"\n" +" </class>\n" +"\n" +" <class name=\"Dog\">\n" +" \n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" - "<![CDATA[<?xml version=\"1.0\"?> -\n" - "<!DOCTYPE hibernate-mapping PUBLIC -\n" - " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\" -\n" - " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\"> -\n" - " -\n" - "<hibernate-mapping package=\"eg\"> -\n" - " -\n" - " <class name=\"Cat\" -\n" - " table=\"cats\" -\n" - " discriminator-value=\"C\"> -\n" - " -\n" - " <id name=\"id\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " -\n" - " <discriminator column=\"subclass\" -\n" - " type=\"character\"/> -\n" - " -\n" - " <property name=\"weight\"/> -\n" - " -\n" - " <property name=\"birthdate\" -\n" - " type=\"date\" -\n" - " not-null=\"true\" -\n" - " update=\"false\"/> -\n" - " -\n" - " <property name=\"color\" -\n" - " type=\"eg.types.ColorUserType\" -\n" - " not-null=\"true\" -\n" - " update=\"false\"/> -\n" - " -\n" - " <property name=\"sex\" -\n" - " not-null=\"true\" -\n" - " update=\"false\"/> -\n" - " -\n" - " <property name=\"litterId\" -\n" - " column=\"litterId\" -\n" - " update=\"false\"/> -\n" - " -\n" - " <many-to-one name=\"mother\" -\n" - " column=\"mother_id\" -\n" - " update=\"false\"/> -\n" - " -\n" - " <set name=\"kittens\" -\n" - " inverse=\"true\" -\n" - " order-by=\"litter_id\"> -\n" - " <key column=\"mother_id\"/> -\n" - " <one-to-many class=\"Cat\"/> -\n" - " </set> -\n" - " -\n" - " <subclass name=\"DomesticCat\" -\n" - " discriminator-value=\"D\"> -\n" - " -\n" - " <property name=\"name\" -\n" - " type=\"string\"/> -\n" - " -\n" - " </subclass> -\n" - " -\n" - " </class> -\n" - " -\n" - " <class name=\"Dog\"> -\n" - "  -\n" - " </class> -\n" - " -\n" - "</hibernate-mapping>]]>" -#: index.docbook:29 -msgid "We will now discuss the content of the mapping document. We will only describe the document elements and attributes that are used by Hibernate at runtime. The mapping document also contains some extra optional attributes and elements that affect the database schemas exported by the schema export tool. (For example the <literal> not-null</literal> attribute.)" -msgstr "マッピングドキュメントの内容を説明します。。ただし、ここではHibernateが実行時に使うドキュメント要素と属性についてのみ説明します。マッピングドキュメントは、いくつかのオプション属性と要素を含んでいます（例えば <literal>not-null</literal> 属性）。それらはスキーマエクスポートツールが出力するデータベーススキーマに影響を与えるものです。" +#. Tag: para +#: basic_mapping.xml:29 +#, no-c-format +msgid "" +"We will now discuss the content of the mapping document. We will only " +"describe the document elements and attributes that are used by Hibernate at " +"runtime. The mapping document also contains some extra optional attributes " +"and elements that affect the database schemas exported by the schema export " +"tool. (For example the <literal> not-null</literal> attribute.)" +msgstr "" +"マッピングドキュメントの内容を説明します。。ただし、ここではHibernateが実行" +"時に使うドキュメント要素と属性についてのみ説明します。マッピングドキュメント" +"は、いくつかのオプション属性と要素を含んでいます（例えば <literal>not-null</" +"literal> 属性）。それらはスキーマエクスポートツールが出力するデータベースス" +"キーマに影響を与えるものです。" -#: index.docbook:40 +#. Tag: title +#: basic_mapping.xml:40 +#, no-c-format msgid "Doctype" msgstr "Doctype" -#: index.docbook:42 -msgid "All XML mappings should declare the doctype shown. The actual DTD may be found at the URL above, in the directory <literal>hibernate-x.x.x/src/org/hibernate </literal> or in <literal>hibernate3.jar</literal>. Hibernate will always look for the DTD in its classpath first. If you experience lookups of the DTD using an Internet connection, check your DTD declaration against the contents of your claspath." -msgstr "XMLマッピングでは、お見せしたようなドキュメント型を必ず定義すべきです。実際のDTDは、上記のURLの <literal>hibernate-x.x.x/src/org/hibernate</literal> ディレクトリ、または <literal>hibernate.jar</literal> 内にあります。 Hibernateは常に、そのクラスパス内でDTDを探し始めます。インターネットにあるDTDファイルを探そうとしたなら、クラスパスの内容を見て、DTD宣言を確認してください。" +#. Tag: para +#: basic_mapping.xml:42 +#, no-c-format +msgid "" +"All XML mappings should declare the doctype shown. The actual DTD may be " +"found at the URL above, in the directory <literal>hibernate-x.x.x/src/org/" +"hibernate </literal> or in <literal>hibernate3.jar</literal>. Hibernate will " +"always look for the DTD in its classpath first. If you experience lookups of " +"the DTD using an Internet connection, check your DTD declaration against the " +"contents of your claspath." +msgstr "" +"XMLマッピングでは、お見せしたようなドキュメント型を必ず定義すべきです。実際" +"のDTDは、上記のURLの <literal>hibernate-x.x.x/src/org/hibernate</literal> " +"ディレクトリ、または <literal>hibernate.jar</literal> 内にあります。 " +"Hibernateは常に、そのクラスパス内でDTDを探し始めます。インターネットにある" +"DTDファイルを探そうとしたなら、クラスパスの内容を見て、DTD宣言を確認してくだ" +"さい。" -#: index.docbook:52 +#. Tag: title +#: basic_mapping.xml:52 +#, no-c-format msgid "EntityResolver" msgstr "エンティティ・リゾルバ" -#: index.docbook:53 -msgid "As mentioned previously, Hibernate will first attempt to resolve DTDs in its classpath. The manner in which it does this is by registering a custom <literal>org.xml.sax.EntityResolver</literal> implementation with the SAXReader it uses to read in the xml files. This custom <literal>EntityResolver</literal> recognizes two different systemId namespaces." -msgstr "前述したように、Hibernateはまずクラスパス内でDTDを解決しようとします。 <literal>org.xml.sax.EntityResolver</literal> のカスタム実装を XMLファイルを読み込むためのSAXReaderに登録することによって、DTDを解決します。このカスタムの <literal>EntityResolver</literal> は2つの異なるシステムID名前空間を認識します。" +#. Tag: para +#: basic_mapping.xml:53 +#, no-c-format +msgid "" +"As mentioned previously, Hibernate will first attempt to resolve DTDs in its " +"classpath. The manner in which it does this is by registering a custom " +"<literal>org.xml.sax.EntityResolver</literal> implementation with the " +"SAXReader it uses to read in the xml files. This custom " +"<literal>EntityResolver</literal> recognizes two different systemId " +"namespaces." +msgstr "" +"前述したように、Hibernateはまずクラスパス内でDTDを解決しようとします。 " +"<literal>org.xml.sax.EntityResolver</literal> のカスタム実装を XMLファイルを" +"読み込むためのSAXReaderに登録することによって、DTDを解決します。このカスタム" +"の <literal>EntityResolver</literal> は2つの異なるシステムID名前空間を認識し" +"ます。" -#: index.docbook:61 -msgid "a <literal>hibernate namespace</literal> is recognized whenever the resolver encounteres a systemId starting with <literal>http://hibernate.sourceforge.net/</literal>; the resolver attempts to resolve these entities via the classlaoder which loaded the Hibernate classes." -msgstr "<literal>Hibernate名前空間</literal> は、リゾルバが <literal>http://hibernate.sourceforge.net/</literal> で始まるシステムIDに到達したときに、認識されます。そしてリゾルバは、Hibernateのクラスをロードしたクラスローダを用いて、これらのエンティティを解決しようとします。" +#. Tag: para +#: basic_mapping.xml:61 +#, no-c-format +msgid "" +"a <literal>hibernate namespace</literal> is recognized whenever the resolver " +"encounteres a systemId starting with <literal>http://hibernate.sourceforge." +"net/</literal>; the resolver attempts to resolve these entities via the " +"classlaoder which loaded the Hibernate classes." +msgstr "" +"<literal>Hibernate名前空間</literal> は、リゾルバが <literal>http://" +"hibernate.sourceforge.net/</literal> で始まるシステムIDに到達したときに、認" +"識されます。そしてリゾルバは、Hibernateのクラスをロードしたクラスローダを用" +"いて、これらのエンティティを解決しようとします。" -#: index.docbook:70 -msgid "a <literal>user namespace</literal> is recognized whenever the resolver encounteres a systemId using a <literal>classpath://</literal> URL protocol; the resolver will attempt to resolve these entities via (1) the current thread context classloader and (2) the classloader which loaded the Hibernate classes." -msgstr "<literal>ユーザ名前空間</literal> は、リゾルバが URLプロトコルの <literal>classpath://</literal> を使ったシステムIDに到達したときに、認識されます。そしてリゾルバは、(1)カレントスレッドのコンテキストクラスローダー、または(2)Hibernateのクラスをロードしたクラスローダを使って、これらのエンティティを解決しようとします。" +#. Tag: para +#: basic_mapping.xml:70 +#, no-c-format +msgid "" +"a <literal>user namespace</literal> is recognized whenever the resolver " +"encounteres a systemId using a <literal>classpath://</literal> URL protocol; " +"the resolver will attempt to resolve these entities via (1) the current " +"thread context classloader and (2) the classloader which loaded the " +"Hibernate classes." +msgstr "" +"<literal>ユーザ名前空間</literal> は、リゾルバが URLプロトコルの " +"<literal>classpath://</literal> を使ったシステムIDに到達したときに、認識され" +"ます。そしてリゾルバは、(1)カレントスレッドのコンテキストクラスローダー、ま" +"たは(2)Hibernateのクラスをロードしたクラスローダを使って、これらのエンティ" +"ティを解決しようとします。" -#: index.docbook:79 +#. Tag: para +#: basic_mapping.xml:79 +#, no-c-format msgid "An example of utilizing user namespacing:" msgstr "下記は、ユーザ名前空間を使った例です：" -#: index.docbook:82 +#. Tag: programlisting +#: basic_mapping.xml:82 +#, no-c-format msgid "" - "<![CDATA[<?xml version=\"1.0\"?>\n" - "<!DOCTYPE hibernate-mapping PUBLIC\n" - " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" - " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\" [\n" - " <!ENTITY types SYSTEM \"classpath://your/domain/types.xml\">\n" - "]>\n" - "\n" - "<hibernate-mapping package=\"your.domain\">\n" - " <class name=\"MyEntity\">\n" - " <id name=\"id\" type=\"my-custom-id-type\">\n" - " ...\n" - " </id>\n" - " <class>\n" - " &types;\n" - "</hibernate-mapping>]]>" +"<![CDATA[<?xml version=\"1.0\"?>\n" +"<!DOCTYPE hibernate-mapping PUBLIC\n" +" \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" +" \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\" [\n" +" <!ENTITY types SYSTEM \"classpath://your/domain/types.xml\">\n" +"]>\n" +"\n" +"<hibernate-mapping package=\"your.domain\">\n" +" <class name=\"MyEntity\">\n" +" <id name=\"id\" type=\"my-custom-id-type\">\n" +" ...\n" +" </id>\n" +" <class>\n" +" &types;\n" +"</hibernate-mapping>]]>" msgstr "" - "<![CDATA[<?xml version=\"1.0\"?> -\n" - "<!DOCTYPE hibernate-mapping PUBLIC -\n" - " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\" -\n" - " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\" [ -\n" - " <!ENTITY types SYSTEM \"classpath://your/domain/types.xml\"> -\n" - "]> -\n" - " -\n" - "<hibernate-mapping package=\"your.domain\"> -\n" - " <class name=\"MyEntity\"> -\n" - " <id name=\"id\" type=\"my-custom-id-type\"> -\n" - " ... -\n" - " </id> -\n" - " <class> -\n" - " &types; -\n" - "</hibernate-mapping>]]>" -#: index.docbook:83 -msgid "Where <literal>types.xml</literal> is a resource in the <literal>your.domain</literal> package and contains a custom <xref linkend=\"mapping-types-custom\"/>typedef." -msgstr "ここで <literal>types.xml</literal> は <literal>your.domain</literal> パッケージ内のリソースであり、カスタム <xref linkend=\"mapping-types-custom\"/>typedef を含むます。" +#. Tag: para +#: basic_mapping.xml:83 +#, no-c-format +msgid "" +"Where <literal>types.xml</literal> is a resource in the <literal>your." +"domain</literal> package and contains a custom <link linkend=\"mapping-types-" +"custom\">typedef</link>." +msgstr "" +"ここで <literal>types.xml</literal> は <literal>your.domain</literal> パッ" +"ケージ内のリソースであり、カスタム <xref linkend=\"mapping-types-custom" +"\">typedef</xref> を含むます。" -#: index.docbook:91 +#. Tag: title +#: basic_mapping.xml:91 +#, no-c-format msgid "hibernate-mapping" msgstr "hibernate-mapping" -#: index.docbook:93 -msgid "This element has several optional attributes. The <literal>schema</literal> and <literal>catalog</literal> attributes specify that tables referred to in this mapping belong to the named schema and/or catalog. If specified, tablenames will be qualified by the given schema and catalog names. If missing, tablenames will be unqualified. The <literal>default-cascade</literal> attribute specifies what cascade style should be assumed for properties and collections which do not specify a <literal>cascade</literal> attribute. The <literal>auto-import</literal> attribute lets us use unqualified class names in the query language, by default." -msgstr "この要素にはいくつかオプション属性があります。<literal>schema</literal> 属性と <literal>catalog</literal> 属性は、このマッピングが参照するテーブルが、この属性によって指定されたスキーマと(または)カタログに属することを指定します。この属性が指定されると、テーブル名は与えられたスキーマ名とカタログ名で修飾されます。これらの属性が指定されていなければ、テーブル名は修飾されません。<literal>default-cascade</literal> 属性は、 <literal>cascade</literal> 属性を指定していないプロパティやコレクションに、どのカスケードスタイルを割り当てるかを指定します。 <literal>auto-import</literal> 属性は、クエリ言語内で修飾されていないクラス名を、デフォルトで使えるようにします。" +#. Tag: para +#: basic_mapping.xml:93 +#, no-c-format +msgid "" +"This element has several optional attributes. The <literal>schema</literal> " +"and <literal>catalog</literal> attributes specify that tables referred to in " +"this mapping belong to the named schema and/or catalog. If specified, " +"tablenames will be qualified by the given schema and catalog names. If " +"missing, tablenames will be unqualified. The <literal>default-cascade</" +"literal> attribute specifies what cascade style should be assumed for " +"properties and collections which do not specify a <literal>cascade</literal> " +"attribute. The <literal>auto-import</literal> attribute lets us use " +"unqualified class names in the query language, by default." +msgstr "" +"この要素にはいくつかオプション属性があります。<literal>schema</literal> 属性" +"と <literal>catalog</literal> 属性は、このマッピングが参照するテーブルが、こ" +"の属性によって指定されたスキーマと(または)カタログに属することを指定します。 " +"この属性が指定されると、テーブル名は与えられたスキーマ名とカタログ名で修飾さ" +"れます。これらの属性が指定されていなければ、テーブル名は修飾されません。" +"<literal>default-cascade</literal> 属性は、 <literal>cascade</literal> 属性を" +"指定していないプロパティやコレクションに、どのカスケードスタイルを割り当てる" +"かを指定します。 <literal>auto-import</literal> 属性は、クエリ言語内で修飾さ" +"れていないクラス名を、デフォルトで使えるようにします。" -#: index.docbook:114 +#. Tag: programlisting +#: basic_mapping.xml:114 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping\n" - " schema=\"schemaName\"\n" - " catalog=\"catalogName\"\n" - " default-cascade=\"cascade_style\"\n" - " default-access=\"field|property|ClassName\"\n" - " default-lazy=\"true|false\"\n" - " auto-import=\"true|false\"\n" - " package=\"package.name\"\n" - " />]]>" +"<![CDATA[<hibernate-mapping\n" +" schema=\"schemaName\"\n" +" catalog=\"catalogName\"\n" +" default-cascade=\"cascade_style\"\n" +" default-access=\"field|property|ClassName\"\n" +" default-lazy=\"true|false\"\n" +" auto-import=\"true|false\"\n" +" package=\"package.name\"\n" +" />]]>" msgstr "" - "<![CDATA[<hibernate-mapping -\n" - " schema=\"schemaName\" -\n" - " catalog=\"catalogName\" -\n" - " default-cascade=\"cascade_style\" -\n" - " default-access=\"field|property|ClassName\" -\n" - " default-lazy=\"true|false\" -\n" - " auto-import=\"true|false\" -\n" - " package=\"package.name\" -\n" - " />]]>" -#: index.docbook:117 +#. Tag: para +#: basic_mapping.xml:117 +#, no-c-format msgid "<literal>schema</literal> (optional): The name of a database schema." msgstr "<literal>schema</literal>（オプション）：データベーススキーマの名前。" -#: index.docbook:122 +#. Tag: para +#: basic_mapping.xml:122 +#, no-c-format msgid "<literal>catalog</literal> (optional): The name of a database catalog." -msgstr "<literal>catalog</literal> （オプション）：データベースカタログの名前。" +msgstr "" +"<literal>catalog</literal> （オプション）：データベースカタログの名前。" -#: index.docbook:127 -msgid "<literal>default-cascade</literal> (optional - defaults to <literal>none</literal>): A default cascade style." -msgstr "<literal>default-cascade</literal> （オプション - デフォルトは <literal>none</literal>）：デフォルトのカスケードスタイル。" +#. Tag: para +#: basic_mapping.xml:127 +#, no-c-format +msgid "" +"<literal>default-cascade</literal> (optional - defaults to <literal>none</" +"literal>): A default cascade style." +msgstr "" +"<literal>default-cascade</literal> （オプション - デフォルトは " +"<literal>none</literal>）：デフォルトのカスケードスタイル。" -#: index.docbook:133 -msgid "<literal>default-access</literal> (optional - defaults to <literal>property</literal>): The strategy Hibernate should use for accessing all properties. Can be a custom implementation of <literal>PropertyAccessor</literal>." -msgstr "<literal>default-access</literal> (オプション - デフォルトは <literal>property</literal> ）： Hibernateがプロパティにアクセスする際に採るべき戦略。 <literal>PropertyAccessor</literal> を実装することでカスタマイズ可能。" +#. Tag: para +#: basic_mapping.xml:133 +#, no-c-format +msgid "" +"<literal>default-access</literal> (optional - defaults to <literal>property</" +"literal>): The strategy Hibernate should use for accessing all properties. " +"Can be a custom implementation of <literal>PropertyAccessor</literal>." +msgstr "" +"<literal>default-access</literal> (オプション - デフォルトは " +"<literal>property</literal> ）： Hibernateがプロパティにアクセスする際に採る" +"べき戦略。 <literal>PropertyAccessor</literal> を実装することでカスタマイズ可" +"能。" -#: index.docbook:140 -msgid "<literal>default-lazy</literal> (optional - defaults to <literal>true</literal>): The default value for unspecifed <literal>lazy</literal> attributes of class and collection mappings." -msgstr "<literal>default-lazy</literal> (オプション - デフォルトは <literal>true</literal> )： <literal>lazy</literal> 属性が指定されていないクラスやコレクションマッピングに対するデフォルト値。" +#. Tag: para +#: basic_mapping.xml:140 +#, no-c-format +msgid "" +"<literal>default-lazy</literal> (optional - defaults to <literal>true</" +"literal>): The default value for unspecifed <literal>lazy</literal> " +"attributes of class and collection mappings." +msgstr "" +"<literal>default-lazy</literal> (オプション - デフォルトは <literal>true</" +"literal> )： <literal>lazy</literal> 属性が指定されていないクラスやコレクショ" +"ンマッピングに対するデフォルト値。" -#: index.docbook:147 -msgid "<literal>auto-import</literal> (optional - defaults to <literal>true</literal>): Specifies whether we can use unqualified class names (of classes in this mapping) in the query language." -msgstr "<literal>auto-import</literal> （オプション - デフォルトは <literal>true</literal>）：クエリ言語内で、（このマッピング内のクラスの）修飾されていないクラス名を使えるかどうかを指定します。" +#. Tag: para +#: basic_mapping.xml:147 +#, no-c-format +msgid "" +"<literal>auto-import</literal> (optional - defaults to <literal>true</" +"literal>): Specifies whether we can use unqualified class names (of classes " +"in this mapping) in the query language." +msgstr "" +"<literal>auto-import</literal> （オプション - デフォルトは <literal>true</" +"literal>）：クエリ言語内で、（このマッピング内のクラスの）修飾されていないク" +"ラス名を使えるかどうかを指定します。" -#: index.docbook:154 -msgid "<literal>package</literal> (optional): Specifies a package prefix to assume for unqualified class names in the mapping document." -msgstr "<literal>package</literal> (オプション): マッピングドキュメント内で修飾されていないクラス名に対して割り当てる、パッケージの接頭辞(prefix)を指定します。" +#. Tag: para +#: basic_mapping.xml:154 +#, no-c-format +msgid "" +"<literal>package</literal> (optional): Specifies a package prefix to assume " +"for unqualified class names in the mapping document." +msgstr "" +"<literal>package</literal> (オプション): マッピングドキュメント内で修飾されて" +"いないクラス名に対して割り当てる、パッケージの接頭辞(prefix)を指定します。" -#: index.docbook:162 -msgid "If you have two persistent classes with the same (unqualified) name, you should set <literal>auto-import=\"false\"</literal>. Hibernate will throw an exception if you attempt to assign two classes to the same \"imported\" name." -msgstr "（修飾されていない）同じ名前の永続クラスが2つあるなら、 <literal>auto-import=\"false\"</literal> を設定すべきです。 2つのクラスに”インポートされた”同じ名前を割り当てようとすると、Hibernateは例外を投げます。" +#. Tag: para +#: basic_mapping.xml:162 +#, no-c-format +msgid "" +"If you have two persistent classes with the same (unqualified) name, you " +"should set <literal>auto-import=\"false\"</literal>. Hibernate will throw an " +"exception if you attempt to assign two classes to the same \"imported\" name." +msgstr "" +"（修飾されていない）同じ名前の永続クラスが2つあるなら、 <literal>auto-import=" +"\"false\"</literal> を設定すべきです。 2つのクラスに”インポートされた”同じ名" +"前を割り当てようとすると、Hibernateは例外を投げます。" -#: index.docbook:168 -msgid "Note that the <literal>hibernate-mapping</literal> element allows you to nest several persistent <literal><class></literal> mappings, as shown above. It is however good practice (and expected by some tools) to map only a single persistent class (or a single class hierarchy) in one mapping file and name it after the persistent superclass, e.g. <literal>Cat.hbm.xml</literal>, <literal>Dog.hbm.xml</literal>, or if using inheritance, <literal>Animal.hbm.xml</literal>." -msgstr "<literal>hibernate-mapping</literal> 要素は、最初の例で示したようにいくつかの永続 <literal><class></literal> マッピングをネストできます。しかし、１つのマッピングファイルではただひとつの永続クラス(またはひとつのクラス階層)にマッピングするようにし、さらに永続スーパークラスの後で指定するべきでしょう(いくつかのツールはこのようなマッピングファイルを想定しています)。例えば次のようになります。： <literal>Cat.hbm.xml</literal> , <literal>Dog.hbm.xml</literal> , または継承を使うなら <literal>Animal.hbm.xml</literal> 。" +#. Tag: para +#: basic_mapping.xml:168 +#, no-c-format +msgid "" +"Note that the <literal>hibernate-mapping</literal> element allows you to " +"nest several persistent <literal><class></literal> mappings, as shown " +"above. It is however good practice (and expected by some tools) to map only " +"a single persistent class (or a single class hierarchy) in one mapping file " +"and name it after the persistent superclass, e.g. <literal>Cat.hbm.xml</" +"literal>, <literal>Dog.hbm.xml</literal>, or if using inheritance, " +"<literal>Animal.hbm.xml</literal>." +msgstr "" +"<literal>hibernate-mapping</literal> 要素は、最初の例で示したようにいくつかの" +"永続 <literal><class></literal> マッピングをネストできます。しかし、１" +"つのマッピングファイルではただひとつの永続クラス(またはひとつのクラス階層)に" +"マッピングするようにし、さらに永続スーパークラスの後で指定するべきでしょう" +"(いくつかのツールはこのようなマッピングファイルを想定しています)。例えば次の" +"ようになります。： <literal>Cat.hbm.xml</literal> , <literal>Dog.hbm.xml</" +"literal> , または継承を使うなら <literal>Animal.hbm.xml</literal> 。" -#: index.docbook:181 +#. Tag: title +#: basic_mapping.xml:181 +#, no-c-format msgid "<title>class</title>" -msgstr "<title>class</title>" +msgstr "" -#: index.docbook:183 -msgid "You may declare a persistent class using the <literal>class</literal> element:" +#. Tag: para +#: basic_mapping.xml:183 +#, no-c-format +msgid "" +"You may declare a persistent class using the <literal>class</literal> " +"element:" msgstr "<literal>class</literal> 要素を使って、永続クラスを宣言できます。" -#: index.docbook:211 +#. Tag: programlisting +#: basic_mapping.xml:211 +#, no-c-format msgid "" - "<![CDATA[<class\n" - " name=\"ClassName\"\n" - " table=\"tableName\"\n" - " discriminator-value=\"discriminator_value\"\n" - " mutable=\"true|false\"\n" - " schema=\"owner\"\n" - " catalog=\"catalog\"\n" - " proxy=\"ProxyInterface\"\n" - " dynamic-update=\"true|false\"\n" - " dynamic-insert=\"true|false\"\n" - " select-before-update=\"true|false\"\n" - " polymorphism=\"implicit|explicit\"\n" - " where=\"arbitrary sql where condition\"\n" - " persister=\"PersisterClass\"\n" - " batch-size=\"N\"\n" - " optimistic-lock=\"none|version|dirty|all\"\n" - " lazy=\"true|false\"\n" - " entity-name=\"EntityName\"\n" - " check=\"arbitrary sql check condition\"\n" - " rowid=\"rowid\"\n" - " subselect=\"SQL expression\"\n" - " abstract=\"true|false\"\n" - " node=\"element-name\"\n" - "/>]]>" +"<![CDATA[<class\n" +" name=\"ClassName\"\n" +" table=\"tableName\"\n" +" discriminator-value=\"discriminator_value\"\n" +" mutable=\"true|false\"\n" +" schema=\"owner\"\n" +" catalog=\"catalog\"\n" +" proxy=\"ProxyInterface\"\n" +" dynamic-update=\"true|false\"\n" +" dynamic-insert=\"true|false\"\n" +" select-before-update=\"true|false\"\n" +" polymorphism=\"implicit|explicit\"\n" +" where=\"arbitrary sql where condition\"\n" +" persister=\"PersisterClass\"\n" +" batch-size=\"N\"\n" +" optimistic-lock=\"none|version|dirty|all\"\n" +" lazy=\"true|false\"\n" +" entity-name=\"EntityName\"\n" +" check=\"arbitrary sql check condition\"\n" +" rowid=\"rowid\"\n" +" subselect=\"SQL expression\"\n" +" abstract=\"true|false\"\n" +" node=\"element-name\"\n" +"/>]]>" msgstr "" - "<![CDATA[<class -\n" - " name=\"ClassName\" -\n" - " table=\"tableName\" -\n" - " discriminator-value=\"discriminator_value\" -\n" - " mutable=\"true|false\" -\n" - " schema=\"owner\" -\n" - " catalog=\"catalog\" -\n" - " proxy=\"ProxyInterface\" -\n" - " dynamic-update=\"true|false\" -\n" - " dynamic-insert=\"true|false\" -\n" - " select-before-update=\"true|false\" -\n" - " polymorphism=\"implicit|explicit\" -\n" - " where=\"arbitrary sql where condition\" -\n" - " persister=\"PersisterClass\" -\n" - " batch-size=\"N\" -\n" - " optimistic-lock=\"none|version|dirty|all\" -\n" - " lazy=\"true|false\" -\n" - " entity-name=\"EntityName\" -\n" - " check=\"arbitrary sql check condition\" -\n" - " rowid=\"rowid\" -\n" - " subselect=\"SQL expression\" -\n" - " abstract=\"true|false\" -\n" - " entity-name=\"EntityName\" -\n" - " node=\"element-name\" -\n" - "/>]]>" -#: index.docbook:214 -msgid "<literal>name</literal> (optional): The fully qualified Java class name of the persistent class (or interface). If this attribute is missing, it is assumed that the mapping is for a non-POJO entity." -msgstr "<literal>name</literal> (オプション)：永続クラス（またはインターフェイス）の完全修飾Javaクラス名。もしこの属性を指定しなければ、POJOではないエンティティに対するマッピングとして扱われます。" +#. Tag: para +#: basic_mapping.xml:214 +#, no-c-format +msgid "" +"<literal>name</literal> (optional): The fully qualified Java class name of " +"the persistent class (or interface). If this attribute is missing, it is " +"assumed that the mapping is for a non-POJO entity." +msgstr "" +"<literal>name</literal> (オプション)：永続クラス（またはインターフェイス）の" +"完全修飾Javaクラス名。もしこの属性を指定しなければ、POJOではないエンティティ" +"に対するマッピングとして扱われます。" -#: index.docbook:221 -msgid "<literal>table</literal> (optional - defaults to the unqualified class name): The name of its database table." -msgstr "<literal>table</literal> (オプション - デフォルトは修飾されていないクラス名)：データベーステーブルの名前" +#. Tag: para +#: basic_mapping.xml:221 +#, no-c-format +msgid "" +"<literal>table</literal> (optional - defaults to the unqualified class " +"name): The name of its database table." +msgstr "" +"<literal>table</literal> (オプション - デフォルトは修飾されていないクラス" +"名)：データベーステーブルの名前" -#: index.docbook:227 -msgid "<literal>discriminator-value</literal> (optional - defaults to the class name): A value that distiguishes individual subclasses, used for polymorphic behaviour. Acceptable values include <literal>null</literal> and <literal>not null</literal>." -msgstr "<literal>discriminator-value</literal> (オプション - デフォルトはクラス名)：ポリモーフィックな振る舞いに使われる個々のサブクラスを識別するための値。値は <literal>null</literal> か <literal>not null</literal> のいずれかを取ります。" +#. Tag: para +#: basic_mapping.xml:227 +#, no-c-format +msgid "" +"<literal>discriminator-value</literal> (optional - defaults to the class " +"name): A value that distiguishes individual subclasses, used for polymorphic " +"behaviour. Acceptable values include <literal>null</literal> and " +"<literal>not null</literal>." +msgstr "" +"<literal>discriminator-value</literal> (オプション - デフォルトはクラス名)： " +"ポリモーフィックな振る舞いに使われる個々のサブクラスを識別するための値。値" +"は <literal>null</literal> か <literal>not null</literal> のいずれかを取りま" +"す。" -#: index.docbook:234 -msgid "<literal>mutable</literal> (optional, defaults to <literal>true</literal>): Specifies that instances of the class are (not) mutable." -msgstr "<literal>mutable</literal> (オプション、デフォルトは <literal>true</literal> )：そのクラスのインスタンスが更新可能（または不可能）であることを指定します。" +#. Tag: para +#: basic_mapping.xml:234 +#, no-c-format +msgid "" +"<literal>mutable</literal> (optional, defaults to <literal>true</literal>): " +"Specifies that instances of the class are (not) mutable." +msgstr "" +"<literal>mutable</literal> (オプション、デフォルトは <literal>true</" +"literal> )：そのクラスのインスタンスが更新可能（または不可能）であることを指" +"定します。" -#: index.docbook:240, index.docbook:2204 -msgid "<literal>schema</literal> (optional): Override the schema name specified by the root <literal><hibernate-mapping></literal> element." -msgstr "<literal>schema</literal> （オプション）：ルートの <literal><hibernate-mapping></literal> 要素で指定されたスキーマ名をオーバーライドします。" +#. Tag: para +#: basic_mapping.xml:240 basic_mapping.xml:2204 +#, fuzzy, no-c-format +msgid "" +"<literal>schema</literal> (optional): Override the schema name specified by " +"the root <literal><hibernate-mapping></literal> element." +msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>schema</literal> （オプション）：ルートの <literal><hibernate-" +"mapping></literal> 要素で指定されたスキーマ名をオーバーライドします。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>schema</literal> (オプション): ルートの <literal><hibernate-" +"mapping></literal> 要素で指定したスキーマ名をオーバーライドします。" -#: index.docbook:246, index.docbook:2210 -msgid "<literal>catalog</literal> (optional): Override the catalog name specified by the root <literal><hibernate-mapping></literal> element." -msgstr "<literal>catalog</literal> （オプション）：ルートの <literal><hibernate-mapping></literal> 要素で指定されたカタログ名をオーバーライドします。" +#. Tag: para +#: basic_mapping.xml:246 basic_mapping.xml:2210 +#, fuzzy, no-c-format +msgid "" +"<literal>catalog</literal> (optional): Override the catalog name specified " +"by the root <literal><hibernate-mapping></literal> element." +msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>catalog</literal> （オプション）：ルートの <literal><hibernate-" +"mapping></literal> 要素で指定されたカタログ名をオーバーライドします。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>catalog</literal> (オプション): ルートの <literal><hibernate-" +"mapping></literal> 要素で指定したカタログ名をオーバーライドします。" -#: index.docbook:252 -msgid "<literal>proxy</literal> (optional): Specifies an interface to use for lazy initializing proxies. You may specify the name of the class itself." -msgstr "<literal>proxy</literal> （オプション）：遅延初期化プロキシに使うインターフェイスを指定します。永続化するクラス名そのものを指定することも可能です。" +#. Tag: para +#: basic_mapping.xml:252 +#, no-c-format +msgid "" +"<literal>proxy</literal> (optional): Specifies an interface to use for lazy " +"initializing proxies. You may specify the name of the class itself." +msgstr "" +"<literal>proxy</literal> （オプション）：遅延初期化プロキシに使うインターフェ" +"イスを指定します。永続化するクラス名そのものを指定することも可能です。" -#: index.docbook:258 -msgid "<literal>dynamic-update</literal> (optional, defaults to <literal>false</literal>): Specifies that <literal>UPDATE</literal> SQL should be generated at runtime and contain only those columns whose values have changed." -msgstr "<literal>dynamic-update</literal> （オプション、デフォルトは <literal>false</literal> ）：値が変更されたカラムだけを含むSQLの <literal>UPDATE</literal> 文を、実行時に生成することを指定します。" +#. Tag: para +#: basic_mapping.xml:258 +#, no-c-format +msgid "" +"<literal>dynamic-update</literal> (optional, defaults to <literal>false</" +"literal>): Specifies that <literal>UPDATE</literal> SQL should be generated " +"at runtime and contain only those columns whose values have changed." +msgstr "" +"<literal>dynamic-update</literal> （オプション、デフォルトは " +"<literal>false</literal> ）：値が変更されたカラムだけを含むSQLの " +"<literal>UPDATE</literal> 文を、実行時に生成することを指定します。" -#: index.docbook:265 -msgid "<literal>dynamic-insert</literal> (optional, defaults to <literal>false</literal>): Specifies that <literal>INSERT</literal> SQL should be generated at runtime and contain only the columns whose values are not null." -msgstr "<literal>dynamic-insert</literal> （オプション, デフォルトは <literal>false</literal> ）：値がnullではないカラムだけを含むSQLの <literal>INSERT</literal> 文を、実行時に生成することを指定します。" +#. Tag: para +#: basic_mapping.xml:265 +#, no-c-format +msgid "" +"<literal>dynamic-insert</literal> (optional, defaults to <literal>false</" +"literal>): Specifies that <literal>INSERT</literal> SQL should be generated " +"at runtime and contain only the columns whose values are not null." +msgstr "" +"<literal>dynamic-insert</literal> （オプション, デフォルトは <literal>false</" +"literal> ）：値がnullではないカラムだけを含むSQLの <literal>INSERT</" +"literal> 文を、実行時に生成することを指定します。" -#: index.docbook:272 -msgid "<literal>select-before-update</literal> (optional, defaults to <literal>false</literal>): Specifies that Hibernate should <emphasis>never</emphasis> perform an SQL <literal>UPDATE</literal> unless it is certain that an object is actually modified. In certain cases (actually, only when a transient object has been associated with a new session using <literal>update()</literal>), this means that Hibernate will perform an extra SQL <literal>SELECT</literal> to determine if an <literal>UPDATE</literal> is actually required." -msgstr "<literal>select-before-update</literal> (オプション, デフォルトは <literal>false</literal>): オブジェクトが変更されたのが確実でないならば、HibernateがSQLの <literal>UPDATE</literal> を <emphasis>決して実行しない</emphasis> ことを指定します。ある特定の場合(実際的には、一時オブジェクトが <literal>update()</literal> を使い、新しいセッションと関連付けられた時だけ)、<literal>UPDATE</literal> が実際に必要かどうかを決定するために、 Hibernateが余分なSQLの <literal>SELECT</literal> 文を実行することを意味します。" +#. Tag: para +#: basic_mapping.xml:272 +#, no-c-format +msgid "" +"<literal>select-before-update</literal> (optional, defaults to " +"<literal>false</literal>): Specifies that Hibernate should <emphasis>never</" +"emphasis> perform an SQL <literal>UPDATE</literal> unless it is certain that " +"an object is actually modified. In certain cases (actually, only when a " +"transient object has been associated with a new session using <literal>update" +"()</literal>), this means that Hibernate will perform an extra SQL " +"<literal>SELECT</literal> to determine if an <literal>UPDATE</literal> is " +"actually required." +msgstr "" +"<literal>select-before-update</literal> (オプション, デフォルトは " +"<literal>false</literal>): オブジェクトが変更されたのが確実でないならば、" +"HibernateがSQLの <literal>UPDATE</literal> を <emphasis>決して実行しない</" +"emphasis> ことを指定します。ある特定の場合(実際的には、一時オブジェクトが " +"<literal>update()</literal> を使い、新しいセッションと関連付けられた時だ" +"け)、<literal>UPDATE</literal> が実際に必要かどうかを決定するために、 " +"Hibernateが余分なSQLの <literal>SELECT</literal> 文を実行することを意味しま" +"す。" -#: index.docbook:282 -msgid "<literal>polymorphism</literal> (optional, defaults to <literal>implicit</literal>): Determines whether implicit or explicit query polymorphism is used." -msgstr "(optional, デフォルトでは <literal>implicit</literal> ): implicit（暗黙）かexplicit（明示）の、どちらのクエリポリモーフィズムを使うか決定します。" +#. Tag: para +#: basic_mapping.xml:282 +#, no-c-format +msgid "" +"<literal>polymorphism</literal> (optional, defaults to <literal>implicit</" +"literal>): Determines whether implicit or explicit query polymorphism is " +"used." +msgstr "" +"(optional, デフォルトでは <literal>implicit</literal> ): implicit（暗黙）か" +"explicit（明示）の、どちらのクエリポリモーフィズムを使うか決定します。" -#: index.docbook:288 -msgid "<literal>where</literal> (optional) specify an arbitrary SQL <literal>WHERE</literal> condition to be used when retrieving objects of this class" -msgstr "<literal>where</literal> （オプション）：このクラスのオブジェクトを検索するときに使用する、任意のSQLの <literal>WHERE</literal> 条件を指定します。" +#. Tag: para +#: basic_mapping.xml:288 +#, no-c-format +msgid "" +"<literal>where</literal> (optional) specify an arbitrary SQL <literal>WHERE</" +"literal> condition to be used when retrieving objects of this class" +msgstr "" +"<literal>where</literal> （オプション）：このクラスのオブジェクトを検索する" +"ときに使用する、任意のSQLの <literal>WHERE</literal> 条件を指定します。" -#: index.docbook:294 -msgid "<literal>persister</literal> (optional): Specifies a custom <literal>ClassPersister</literal>." -msgstr "<literal>persister</literal> （オプション）：カスタム <literal>ClassPersister</literal> を指定します。" +#. Tag: para +#: basic_mapping.xml:294 +#, no-c-format +msgid "" +"<literal>persister</literal> (optional): Specifies a custom " +"<literal>ClassPersister</literal>." +msgstr "" +"<literal>persister</literal> （オプション）：カスタム " +"<literal>ClassPersister</literal> を指定します。" -#: index.docbook:299 -msgid "<literal>batch-size</literal> (optional, defaults to <literal>1</literal>) specify a \"batch size\" for fetching instances of this class by identifier." -msgstr "<literal>batch-size</literal> （オプション, デフォルトは <literal>1</literal> ）：識別子でこのクラスのインスタンスを復元するときの「バッチサイズ」を指定します。" +#. Tag: para +#: basic_mapping.xml:299 +#, no-c-format +msgid "" +"<literal>batch-size</literal> (optional, defaults to <literal>1</literal>) " +"specify a \"batch size\" for fetching instances of this class by identifier." +msgstr "" +"<literal>batch-size</literal> （オプション, デフォルトは <literal>1</" +"literal> ）：識別子でこのクラスのインスタンスを復元するときの「バッチサイ" +"ズ」を指定します。" -#: index.docbook:305 -msgid "<literal>optimistic-lock</literal> (optional, defaults to <literal>version</literal>): Determines the optimistic locking strategy." -msgstr "<literal>optimistic-lock</literal> （オプション,デフォルトは <literal>version</literal> ）：楽観ロック戦略を決定します。" +#. Tag: para +#: basic_mapping.xml:305 +#, no-c-format +msgid "" +"<literal>optimistic-lock</literal> (optional, defaults to <literal>version</" +"literal>): Determines the optimistic locking strategy." +msgstr "" +"<literal>optimistic-lock</literal> （オプション,デフォルトは " +"<literal>version</literal> ）：楽観ロック戦略を決定します。" -#: index.docbook:311 -msgid "<literal>lazy</literal> (optional): Lazy fetching may be completely disabled by setting <literal>lazy=\"false\"</literal>." -msgstr "<literal>lazy</literal> （オプション）： <literal>lazy=\"false\"</literal> と設定することで、遅延フェッチができなくなります。" +#. Tag: para +#: basic_mapping.xml:311 +#, no-c-format +msgid "" +"<literal>lazy</literal> (optional): Lazy fetching may be completely disabled " +"by setting <literal>lazy=\"false\"</literal>." +msgstr "" +"<literal>lazy</literal> （オプション）： <literal>lazy=\"false\"</literal> と" +"設定することで、遅延フェッチができなくなります。" -#: index.docbook:317 -msgid "<literal>entity-name</literal> (optional, defaults to the class name): Hibernate3 allows a class to be mapped multiple times (to different tables, potentially), and allows entity mappings that are represented by Maps or XML at the Java level. In these cases, you should provide an explicit arbitrary name for the entity. See <xref linkend=\"persistent-classes-dynamicmodels\"/> and <xref linkend=\"xml\"/> for more information." -msgstr "<literal>entity-name</literal> （オプション、デフォルトはクラス名）： Hibernate3ではクラスが複数回マッピングでき（場合によっては違うテーブルに対しても）、 JavaレベルでMapやXMLで表現されるエンティティマッピングが可能です。これらの場合、エンティティに対して任意の名前を、明示的に付けなくてはなりません。詳しくは <xref linkend=\"persistent-classes-dynamicmodels\"/> と <xref linkend=\"xml\"/> を参照してください。" +#. Tag: para +#: basic_mapping.xml:317 +#, no-c-format +msgid "" +"<literal>entity-name</literal> (optional, defaults to the class name): " +"Hibernate3 allows a class to be mapped multiple times (to different tables, " +"potentially), and allows entity mappings that are represented by Maps or XML " +"at the Java level. In these cases, you should provide an explicit arbitrary " +"name for the entity. See <xref linkend=\"persistent-classes-dynamicmodels\"/" +"> and <xref linkend=\"xml\"/> for more information." +msgstr "" +"<literal>entity-name</literal> （オプション、デフォルトはクラス名）： " +"Hibernate3ではクラスが複数回マッピングでき（場合によっては違うテーブルに対し" +"ても）、 JavaレベルでMapやXMLで表現されるエンティティマッピングが可能です。 " +"これらの場合、エンティティに対して任意の名前を、明示的に付けなくてはなりませ" +"ん。詳しくは <xref linkend=\"persistent-classes-dynamicmodels\"/> と <xref " +"linkend=\"xml\"/> を参照してください。" -#: index.docbook:327 -msgid "<literal>check</literal> (optional): A SQL expression used to generate a multi-row <emphasis>check</emphasis> constraint for automatic schema generation." -msgstr "<literal>check</literal> （オプション）：自動的にスキーマを生成するために、複数行の <emphasis>check</emphasis> 制約を生成するSQL式。" +#. Tag: para +#: basic_mapping.xml:327 +#, no-c-format +msgid "" +"<literal>check</literal> (optional): A SQL expression used to generate a " +"multi-row <emphasis>check</emphasis> constraint for automatic schema " +"generation." +msgstr "" +"<literal>check</literal> （オプション）：自動的にスキーマを生成するために、 " +"複数行の <emphasis>check</emphasis> 制約を生成するSQL式。" -#: index.docbook:333 -msgid "<literal>rowid</literal> (optional): Hibernate can use so called ROWIDs on databases which support. E.g. on Oracle, Hibernate can use the <literal>rowid</literal> extra column for fast updates if you set this option to <literal>rowid</literal>. A ROWID is an implementation detail and represents the physical location of a stored tuple." -msgstr "<literal>rowid</literal> （オプション）：Hibernateは、それをサポートしているデータベースでROWIDと呼ばれるものを使うことができます。例えばOracleを使っているとき、このオプションに <literal>rowid</literal> を設定すれば、 Hiberanteはupdateを高速化するために <literal>rowid</literal> という特別なカラムを使うことができます。 ROWIDは詳細な実装であり、保存されたタプルの物理的な位置を表しています。" +#. Tag: para +#: basic_mapping.xml:333 +#, no-c-format +msgid "" +"<literal>rowid</literal> (optional): Hibernate can use so called ROWIDs on " +"databases which support. E.g. on Oracle, Hibernate can use the " +"<literal>rowid</literal> extra column for fast updates if you set this " +"option to <literal>rowid</literal>. A ROWID is an implementation detail and " +"represents the physical location of a stored tuple." +msgstr "" +"<literal>rowid</literal> （オプション）：Hibernateは、それをサポートしている" +"データベースでROWIDと呼ばれるものを使うことができます。例えばOracleを使って" +"いるとき、このオプションに <literal>rowid</literal> を設定すれば、 Hiberante" +"はupdateを高速化するために <literal>rowid</literal> という特別なカラムを使う" +"ことができます。 ROWIDは詳細な実装であり、保存されたタプルの物理的な位置を表" +"しています。" -#: index.docbook:341 -msgid "<literal>subselect</literal> (optional): Maps an immutable and read-only entity to a database subselect. Useful if you want to have a view instead of a base table, but don't. See below for more information." -msgstr "<literal>subselect</literal> （オプション）：不変かつ読み取り専用であるエンティティをデータベースの副問合せ（subselect）にマッピングします。もし元のテーブルの代わりにビューを持ちたければ有用ですが、そうでないのなら有用ではありません。より詳しい情報は下記を参照してください。" +#. Tag: para +#: basic_mapping.xml:341 +#, no-c-format +msgid "" +"<literal>subselect</literal> (optional): Maps an immutable and read-only " +"entity to a database subselect. Useful if you want to have a view instead of " +"a base table, but don't. See below for more information." +msgstr "" +"<literal>subselect</literal> （オプション）：不変かつ読み取り専用であるエン" +"ティティをデータベースの副問合せ（subselect）にマッピングします。もし元の" +"テーブルの代わりにビューを持ちたければ有用ですが、そうでないのなら有用ではあ" +"りません。より詳しい情報は下記を参照してください。" -#: index.docbook:348 -msgid "<literal>abstract</literal> (optional): Used to mark abstract superclasses in <literal><union-subclass></literal> hierarchies." -msgstr "<literal>abstract</literal> （オプション）： <literal><union-subclass></literal> 階層内の抽象スーパークラスにマークするために使います。" +#. Tag: para +#: basic_mapping.xml:348 +#, no-c-format +msgid "" +"<literal>abstract</literal> (optional): Used to mark abstract superclasses " +"in <literal><union-subclass></literal> hierarchies." +msgstr "" +"<literal>abstract</literal> （オプション）： <literal><union-subclass>" +"</literal> 階層内の抽象スーパークラスにマークするために使います。" -#: index.docbook:356 -msgid "It is perfectly acceptable for the named persistent class to be an interface. You would then declare implementing classes of that interface using the <literal><subclass></literal> element. You may persist any <emphasis>static</emphasis> inner class. You should specify the class name using the standard form ie. <literal>eg.Foo$Bar</literal>." -msgstr "永続クラスの名前にインターフェイスを指定してもまったく問題ありません。そのときは <literal><subclass></literal> 要素を使って、そのインターフェイスを実装するクラスを定義してください。 <emphasis>static</emphasis> な内部クラスでも永続化できます。そのときは標準形式、例えば <literal>eg.Foo$Bar</literal> を使ってクラス名を指定してください。" +#. Tag: para +#: basic_mapping.xml:356 +#, no-c-format +msgid "" +"It is perfectly acceptable for the named persistent class to be an " +"interface. You would then declare implementing classes of that interface " +"using the <literal><subclass></literal> element. You may persist any " +"<emphasis>static</emphasis> inner class. You should specify the class name " +"using the standard form ie. <literal>eg.Foo$Bar</literal>." +msgstr "" +"永続クラスの名前にインターフェイスを指定してもまったく問題ありません。そのと" +"きは <literal><subclass></literal> 要素を使って、そのインターフェイス" +"を実装するクラスを定義してください。 <emphasis>static</emphasis> な内部クラス" +"でも永続化できます。そのときは標準形式、例えば <literal>eg.Foo$Bar</" +"literal> を使ってクラス名を指定してください。" -#: index.docbook:363 -msgid "Immutable classes, <literal>mutable=\"false\"</literal>, may not be updated or deleted by the application. This allows Hibernate to make some minor performance optimizations." -msgstr "<literal>mutable=\"false\"</literal> 指定をした不変クラスは、アプリケーションによる更新や削除が出来ないことがあります。これにより、Hibernateがパフォーマンスを少し改善します。" +#. Tag: para +#: basic_mapping.xml:363 +#, no-c-format +msgid "" +"Immutable classes, <literal>mutable=\"false\"</literal>, may not be updated " +"or deleted by the application. This allows Hibernate to make some minor " +"performance optimizations." +msgstr "" +"<literal>mutable=\"false\"</literal> 指定をした不変クラスは、アプリケーショ" +"ンによる更新や削除が出来ないことがあります。これにより、Hibernateがパフォー" +"マンスを少し改善します。" -#: index.docbook:368 -msgid "The optional <literal>proxy</literal> attribute enables lazy initialization of persistent instances of the class. Hibernate will initially return CGLIB proxies which implement the named interface. The actual persistent object will be loaded when a method of the proxy is invoked. See \"Initializing collections and proxies\" below." -msgstr "オプションの <literal>proxy</literal> 属性により、クラスの永続インスタンスの遅延初期化が可能になります。 Hibernateは最初に、指定したインターフェイスを実装したCGLIBプロキシを返します。実際の永続オブジェクトはプロキシのメソッドを呼び出すときにロードします。以下の「遅延初期化のためのプロキシ」を参照してください。" +#. Tag: para +#: basic_mapping.xml:368 +#, no-c-format +msgid "" +"The optional <literal>proxy</literal> attribute enables lazy initialization " +"of persistent instances of the class. Hibernate will initially return CGLIB " +"proxies which implement the named interface. The actual persistent object " +"will be loaded when a method of the proxy is invoked. See \"Initializing " +"collections and proxies\" below." +msgstr "" +"オプションの <literal>proxy</literal> 属性により、クラスの永続インスタンスの" +"遅延初期化が可能になります。 Hibernateは最初に、指定したインターフェイスを実" +"装したCGLIBプロキシを返します。実際の永続オブジェクトはプロキシのメソッドを" +"呼び出すときにロードします。以下の「遅延初期化のためのプロキシ」を参照してく" +"ださい。" -#: index.docbook:375 -msgid "<emphasis>Implicit</emphasis> polymorphism means that instances of the class will be returned by a query that names any superclass or implemented interface or the class and that instances of any subclass of the class will be returned by a query that names the class itself. <emphasis>Explicit</emphasis> polymorphism means that class instances will be returned only by queries that explicitly name that class and that queries that name the class will return only instances of subclasses mapped inside this <literal><class></literal> declaration as a <literal><subclass></literal> or <literal><joined-subclass></literal>. For most purposes the default, <literal>polymorphism=\"implicit\"</literal>, is appropriate. Explicit polymorphism is useful when two different classes are mapped to the same table (this allows a \"lightweight\" class that contains a subset of the table columns)." -msgstr "<emphasis>暗黙的</emphasis> ポリモーフィズムとは、次の二つを意味しています。一つはクラスのインスタンスが、スーパークラスや実装したインターフェイス、またそのクラスを指定するクエリによって返されることで、もう一つはそのクラスのサブクラスのインスタンスが、そのクラス自身を指定したクエリによって返されることです。また、<emphasis>明示的</emphasis> ポリモーフィズムとは、次の二つを意味しています。一つはクラスのインスタンスが、そのクラスを明示的に指定したクエリによってのみ返されることで、もう一つはクラスを指定したクエリが、<literal><class></literal> 要素の中で <literal><subclass></literal> や <literal><joined-subclass></literal> とマッピングされているサブクラスのインスタンスだけを返すこ�! ��です。ほとんどの用途ではデフォルトの <literal>polymorphism=\"implicit\"</literal> が適切です。明示的なポリモーフィズムは、2つの違ったクラスが同じテーブルにマッピングされているときに有用です（これによってテーブルカラムのサブセットを含む、「軽量な」クラスが可能になります）。" +#. Tag: para +#: basic_mapping.xml:375 +#, no-c-format +msgid "" +"<emphasis>Implicit</emphasis> polymorphism means that instances of the class " +"will be returned by a query that names any superclass or implemented " +"interface or the class and that instances of any subclass of the class will " +"be returned by a query that names the class itself. <emphasis>Explicit</" +"emphasis> polymorphism means that class instances will be returned only by " +"queries that explicitly name that class and that queries that name the class " +"will return only instances of subclasses mapped inside this <literal><" +"class></literal> declaration as a <literal><subclass></literal> or " +"<literal><joined-subclass></literal>. For most purposes the default, " +"<literal>polymorphism=\"implicit\"</literal>, is appropriate. Explicit " +"polymorphism is useful when two different classes are mapped to the same " +"table (this allows a \"lightweight\" class that contains a subset of the " +"table columns)." +msgstr "" +"<emphasis>暗黙的</emphasis> ポリモーフィズムとは、次の二つを意味しています。 " +"一つはクラスのインスタンスが、スーパークラスや実装したインターフェイス、また" +"そのクラスを指定するクエリによって返されることで、もう一つはそのクラスのサブ" +"クラスのインスタンスが、そのクラス自身を指定したクエリによって返されることで" +"す。また、<emphasis>明示的</emphasis> ポリモーフィズムとは、次の二つを意味し" +"ています。一つはクラスのインスタンスが、そのクラスを明示的に指定したクエリに" +"よってのみ返されることで、もう一つはクラスを指定したクエリが、<literal><" +"class></literal> 要素の中で <literal><subclass></literal> や " +"<literal><joined-subclass></literal> とマッピングされているサブクラスの" +"インスタンスだけを返すことです。ほとんどの用途ではデフォルトの " +"<literal>polymorphism=\"implicit\"</literal> が適切です。明示的なポリモー" +"フィズムは、2つの違ったクラスが同じテーブルにマッピングされているときに有用で" +"す（これによってテーブルカラムのサブセットを含む、「軽量な」クラスが可能にな" +"ります）。" -#: index.docbook:387 -msgid "The <literal>persister</literal> attribute lets you customize the persistence strategy used for the class. You may, for example, specify your own subclass of <literal>org.hibernate.persister.EntityPersister</literal> or you might even provide a completely new implementation of the interface <literal>org.hibernate.persister.ClassPersister</literal> that implements persistence via, for example, stored procedure calls, serialization to flat files or LDAP. See <literal>org.hibernate.test.CustomPersister</literal> for a simple example (of \"persistence\" to a <literal>Hashtable</literal>)." -msgstr "<literal>persister</literal> 属性を指定することで、クラスの永続化戦略をカスタマイズできます。例えば <literal>org.hibernate.persister.EntityPersister</literal> 自身のサブクラスを指定したり、また例えばストアドプロシージャコール、フラットファイルへシリアライズ、 LDAPなどを通した永続性を実装する <literal>org.hibernate.persister.ClassPersister</literal> インターフェイスの完全に新しい実装を提供できます。簡単な例として <literal>org.hibernate.test.CustomPersister</literal> を見てください（これは <literal>Hashtable</literal> の「永続化」です）。" +#. Tag: para +#: basic_mapping.xml:387 +#, no-c-format +msgid "" +"The <literal>persister</literal> attribute lets you customize the " +"persistence strategy used for the class. You may, for example, specify your " +"own subclass of <literal>org.hibernate.persister.EntityPersister</literal> " +"or you might even provide a completely new implementation of the interface " +"<literal>org.hibernate.persister.ClassPersister</literal> that implements " +"persistence via, for example, stored procedure calls, serialization to flat " +"files or LDAP. See <literal>org.hibernate.test.CustomPersister</literal> for " +"a simple example (of \"persistence\" to a <literal>Hashtable</literal>)." +msgstr "" +"<literal>persister</literal> 属性を指定することで、クラスの永続化戦略をカスタ" +"マイズできます。例えば <literal>org.hibernate.persister.EntityPersister</" +"literal> 自身のサブクラスを指定したり、また例えばストアドプロシージャコー" +"ル、フラットファイルへシリアライズ、 LDAPなどを通した永続性を実装する " +"<literal>org.hibernate.persister.ClassPersister</literal> インターフェイスの" +"完全に新しい実装を提供できます。簡単な例として <literal>org.hibernate.test." +"CustomPersister</literal> を見てください（これは <literal>Hashtable</" +"literal> の「永続化」です）。" -#: index.docbook:398 -msgid "Note that the <literal>dynamic-update</literal> and <literal>dynamic-insert</literal> settings are not inherited by subclasses and so may also be specified on the <literal><subclass></literal> or <literal><joined-subclass></literal> elements. These settings may increase performance in some cases, but might actually decrease performance in others. Use judiciously." -msgstr "<literal>dynamic-update</literal> と <literal>dynamic-insert</literal> の設定はサブクラスに継承されません。そのため <literal><subclass></literal> や <literal><joined-subclass></literal> 要素を指定することも出来ます。これらの設定はパフォーマンスを向上させる事もありますが、落とすこともありますので、慎重に使用してください。" +#. Tag: para +#: basic_mapping.xml:398 +#, no-c-format +msgid "" +"Note that the <literal>dynamic-update</literal> and <literal>dynamic-insert</" +"literal> settings are not inherited by subclasses and so may also be " +"specified on the <literal><subclass></literal> or <literal><joined-" +"subclass></literal> elements. These settings may increase performance in " +"some cases, but might actually decrease performance in others. Use " +"judiciously." +msgstr "" +"<literal>dynamic-update</literal> と <literal>dynamic-insert</literal> の設定" +"はサブクラスに継承されません。そのため <literal><subclass></literal> " +"や <literal><joined-subclass></literal> 要素を指定することも出来ます。 " +"これらの設定はパフォーマンスを向上させる事もありますが、落とすこともあります" +"ので、慎重に使用してください。" -#: index.docbook:406 -msgid "Use of <literal>select-before-update</literal> will usually decrease performance. It is very useful to prevent a database update trigger being called unnecessarily if you reattach a graph of detached instances to a <literal>Session</literal>." -msgstr "<literal>select-before-update</literal> の使用は通常パフォーマンスを落とします。もし <literal>Session</literal> へ分離インスタンスのグラフを再追加するなら、データベース更新のトリガを不必要に呼び出すのを避けるという点で、非常に有用です。" +#. Tag: para +#: basic_mapping.xml:406 +#, no-c-format +msgid "" +"Use of <literal>select-before-update</literal> will usually decrease " +"performance. It is very useful to prevent a database update trigger being " +"called unnecessarily if you reattach a graph of detached instances to a " +"<literal>Session</literal>." +msgstr "" +"<literal>select-before-update</literal> の使用は通常パフォーマンスを落としま" +"す。もし <literal>Session</literal> へ分離インスタンスのグラフを再追加するな" +"ら、データベース更新のトリガを不必要に呼び出すのを避けるという点で、非常に有" +"用です。" -#: index.docbook:412 -msgid "If you enable <literal>dynamic-update</literal>, you will have a choice of optimistic locking strategies:" -msgstr "<literal>dynamic-update</literal> を有効にすれば、楽観ロック戦略を選ぶことになります。" +#. Tag: para +#: basic_mapping.xml:412 +#, no-c-format +msgid "" +"If you enable <literal>dynamic-update</literal>, you will have a choice of " +"optimistic locking strategies:" +msgstr "" +"<literal>dynamic-update</literal> を有効にすれば、楽観ロック戦略を選ぶことに" +"なります。" -#: index.docbook:418 +#. Tag: para +#: basic_mapping.xml:418 +#, no-c-format msgid "<literal>version</literal> check the version/timestamp columns" -msgstr "<literal>version</literal> バージョン/タイムスタンプカラムをチェックします" +msgstr "" +"<literal>version</literal> バージョン/タイムスタンプカラムをチェックします" -#: index.docbook:423 +#. Tag: para +#: basic_mapping.xml:423 +#, no-c-format msgid "<literal>all</literal> check all columns" msgstr "<literal>all</literal> すべてのカラムをチェックします。" -#: index.docbook:428 -msgid "<literal>dirty</literal> check the changed columns, allowing some concurrent updates" -msgstr "<literal>dirty</literal> 変更したカラムをチェックし、同時更新できるようにします。" +#. Tag: para +#: basic_mapping.xml:428 +#, no-c-format +msgid "" +"<literal>dirty</literal> check the changed columns, allowing some concurrent " +"updates" +msgstr "" +"<literal>dirty</literal> 変更したカラムをチェックし、同時更新できるようにしま" +"す。" -#: index.docbook:433 +#. Tag: para +#: basic_mapping.xml:433 +#, no-c-format msgid "<literal>none</literal> do not use optimistic locking" msgstr "<literal>none</literal> 楽観ロックを使用しません" -#: index.docbook:438 -msgid "We <emphasis>very</emphasis> strongly recommend that you use version/timestamp columns for optimistic locking with Hibernate. This is the optimal strategy with respect to performance and is the only strategy that correctly handles modifications made to detached instances (ie. when <literal>Session.merge()</literal> is used)." -msgstr "Hibernateで楽観的ロック戦略を使うなら、バージョン/タイムスタンプカラムを使うことを <emphasis> 非常に</emphasis> 強くお勧めします。楽観的ロックはパフォーマンスの観点からも最適であり、さらに分離インスタンスへの修正（つまり <literal>Session.marge()</literal> が使われるとき）を正確に扱うことのできる唯一の戦略でもあります。" +#. Tag: para +#: basic_mapping.xml:438 +#, no-c-format +msgid "" +"We <emphasis>very</emphasis> strongly recommend that you use version/" +"timestamp columns for optimistic locking with Hibernate. This is the optimal " +"strategy with respect to performance and is the only strategy that correctly " +"handles modifications made to detached instances (ie. when <literal>Session." +"merge()</literal> is used)." +msgstr "" +"Hibernateで楽観的ロック戦略を使うなら、バージョン/タイムスタンプカラムを使う" +"ことを <emphasis> 非常に</emphasis> 強くお勧めします。楽観的ロックはパフォー" +"マンスの観点からも最適であり、さらに分離インスタンスへの修正（つまり " +"<literal>Session.marge()</literal> が使われるとき）を正確に扱うことのできる" +"唯一の戦略でもあります。" -#: index.docbook:445 -msgid "There is no difference between a view and a base table for a Hibernate mapping, as expected this is transparent at the database level (note that some DBMS don't support views properly, especially with updates). Sometimes you want to use a view, but can't create one in the database (ie. with a legacy schema). In this case, you can map an immutable and read-only entity to a given SQL subselect expression:" -msgstr "Hibernateのマッピングにとってビューと普通のテーブルの間に違いはなく、データベースレベルでは透過的です（ただしビューを完全にはサポートしていないDBMSもあります。特に、更新のあるビューに対してはそうです）。ビューを使いたくても、データベースで作成できないことがあります（例えば、レガシースキーマの場合）。この場合には、不変かつ読み取り専用のエンティティに与えられたSQLの副問合せ文をマップできます。" +#. Tag: para +#: basic_mapping.xml:445 +#, no-c-format +msgid "" +"There is no difference between a view and a base table for a Hibernate " +"mapping, as expected this is transparent at the database level (note that " +"some DBMS don't support views properly, especially with updates). Sometimes " +"you want to use a view, but can't create one in the database (ie. with a " +"legacy schema). In this case, you can map an immutable and read-only entity " +"to a given SQL subselect expression:" +msgstr "" +"Hibernateのマッピングにとってビューと普通のテーブルの間に違いはなく、データ" +"ベースレベルでは透過的です（ただしビューを完全にはサポートしていないDBMSもあ" +"ります。特に、更新のあるビューに対してはそうです）。ビューを使いたくても、" +"データベースで作成できないことがあります（例えば、レガシースキーマの場" +"合）。この場合には、不変かつ読み取り専用のエンティティに与えられたSQLの副問" +"合せ文をマップできます。" -#: index.docbook:453 +#. Tag: programlisting +#: basic_mapping.xml:453 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Summary\">\n" - " <subselect>\n" - " select item.name, max(bid.amount), count(*)\n" - " from item\n" - " join bid on bid.item_id = item.id\n" - " group by item.name\n" - " </subselect>\n" - " <synchronize table=\"item\"/>\n" - " <synchronize table=\"bid\"/>\n" - " <id name=\"name\"/>\n" - " ...\n" - "</class>]]>" +"<![CDATA[<class name=\"Summary\">\n" +" <subselect>\n" +" select item.name, max(bid.amount), count(*)\n" +" from item\n" +" join bid on bid.item_id = item.id\n" +" group by item.name\n" +" </subselect>\n" +" <synchronize table=\"item\"/>\n" +" <synchronize table=\"bid\"/>\n" +" <id name=\"name\"/>\n" +" ...\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Summary\"> -\n" - " <subselect> -\n" - " select item.name, max(bid.amount), count(*) -\n" - " from item -\n" - " join bid on bid.item_id = item.id -\n" - " group by item.name -\n" - " </subselect> -\n" - " <synchronize table=\"item\"/> -\n" - " <synchronize table=\"bid\"/> -\n" - " <id name=\"name\"/> -\n" - " ... -\n" - "</class>]]>" -#: index.docbook:455 -msgid "Declare the tables to synchronize this entity with, ensuring that auto-flush happens correctly, and that queries against the derived entity do not return stale data. The <literal><subselect></literal> is available as both as an attribute and a nested mapping element." -msgstr "テーブルをこのエンティティと同期するように定義してください。オートフラッシュが確実に起こるように、また導出エンティティに対するクエリが古いデータを返さないようにするためです。 <literal><subselect></literal> は属性とネストしたマッピング属性のどちらでも利用できます。" +#. Tag: para +#: basic_mapping.xml:455 +#, no-c-format +msgid "" +"Declare the tables to synchronize this entity with, ensuring that auto-flush " +"happens correctly, and that queries against the derived entity do not return " +"stale data. The <literal><subselect></literal> is available as both as " +"an attribute and a nested mapping element." +msgstr "" +"テーブルをこのエンティティと同期するように定義してください。オートフラッシュ" +"が確実に起こるように、また導出エンティティに対するクエリが古いデータを返さな" +"いようにするためです。 <literal><subselect></literal> は属性とネストし" +"たマッピング属性のどちらでも利用できます。" -#: index.docbook:465 +#. Tag: title +#: basic_mapping.xml:465 +#, no-c-format msgid "<title>id</title>" -msgstr "<title>id</title>" +msgstr "" -#: index.docbook:467 -msgid "Mapped classes <emphasis>must</emphasis> declare the primary key column of the database table. Most classes will also have a JavaBeans-style property holding the unique identifier of an instance. The <literal><id></literal> element defines the mapping from that property to the primary key column." -msgstr "マップされたクラスはデータベーステーブルの主キーカラムを定義 <emphasis>しなければなりません</emphasis> 。ほとんどのクラスにはインスタンスのユニークな識別子を保持するJavaBeansスタイルのプロパティもあります。 <literal><id></literal> 要素は、そのプロパティから主キーカラムへのマッピングを定義します。" +#. Tag: para +#: basic_mapping.xml:467 +#, no-c-format +msgid "" +"Mapped classes <emphasis>must</emphasis> declare the primary key column of " +"the database table. Most classes will also have a JavaBeans-style property " +"holding the unique identifier of an instance. The <literal><id></" +"literal> element defines the mapping from that property to the primary key " +"column." +msgstr "" +"マップされたクラスはデータベーステーブルの主キーカラムを定義 <emphasis>しなけ" +"ればなりません</emphasis> 。ほとんどのクラスにはインスタンスのユニークな識別" +"子を保持するJavaBeansスタイルのプロパティもあります。 <literal><id></" +"literal> 要素は、そのプロパティから主キーカラムへのマッピングを定義します。" -#: index.docbook:482 +#. Tag: programlisting +#: basic_mapping.xml:482 +#, no-c-format msgid "" - "<![CDATA[<id\n" - " name=\"propertyName\"\n" - " type=\"typename\"\n" - " column=\"column_name\"\n" - " unsaved-value=\"null|any|none|undefined|id_value\"\n" - " access=\"field|property|ClassName\">\n" - " node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" - "\n" - " <generator class=\"generatorClass\"/>\n" - "</id>]]>" +"<![CDATA[<id\n" +" name=\"propertyName\"\n" +" type=\"typename\"\n" +" column=\"column_name\"\n" +" unsaved-value=\"null|any|none|undefined|id_value\"\n" +" access=\"field|property|ClassName\">\n" +" node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" +"\n" +" <generator class=\"generatorClass\"/>\n" +"</id>]]>" msgstr "" - "<![CDATA[<id -\n" - " name=\"propertyName\" -\n" - " type=\"typename\" -\n" - " column=\"column_name\" -\n" - " unsaved-value=\"null|any|none|undefined|id_value\" -\n" - " access=\"field|property|ClassName\"> -\n" - " node=\"element-name|@attribute-name|element/(a)attribute|.\" -\n" - " -\n" - " <generator class=\"generatorClass\"/> -\n" - "</id>]]>" -#: index.docbook:485 -msgid "<literal>name</literal> (optional): The name of the identifier property." +#. Tag: para +#: basic_mapping.xml:485 +#, no-c-format +msgid "" +"<literal>name</literal> (optional): The name of the identifier property." msgstr "<literal>name</literal>（オプション）：識別子プロパティの名前。" -#: index.docbook:490 -msgid "<literal>type</literal> (optional): A name that indicates the Hibernate type." +#. Tag: para +#: basic_mapping.xml:490 +#, no-c-format +msgid "" +"<literal>type</literal> (optional): A name that indicates the Hibernate type." msgstr "<literal>type</literal>（オプション）：Hibernateの型を示す名前。" -#: index.docbook:495 -msgid "<literal>column</literal> (optional - defaults to the property name): The name of the primary key column." -msgstr "<literal>column</literal>（オプション - デフォルトはプロパティ名）：主キーカラムの名前。" +#. Tag: para +#: basic_mapping.xml:495 +#, no-c-format +msgid "" +"<literal>column</literal> (optional - defaults to the property name): The " +"name of the primary key column." +msgstr "" +"<literal>column</literal>（オプション - デフォルトはプロパティ名）：主キーカ" +"ラムの名前。" -#: index.docbook:501 -msgid "<literal>unsaved-value</literal> (optional - defaults to a \"sensible\" value): An identifier property value that indicates that an instance is newly instantiated (unsaved), distinguishing it from detached instances that were saved or loaded in a previous session." -msgstr "<literal>unsaved-value</literal>（オプション - デフォルトの値はsensible）：インスタンスが新しくインスタンス化された（セーブされていない）ことを示す、識別子プロパティの値。以前のSessionでセーブまたはロードされた一時的インスタンスと区別するために使います。" +#. Tag: para +#: basic_mapping.xml:501 +#, no-c-format +msgid "" +"<literal>unsaved-value</literal> (optional - defaults to a \"sensible\" " +"value): An identifier property value that indicates that an instance is " +"newly instantiated (unsaved), distinguishing it from detached instances that " +"were saved or loaded in a previous session." +msgstr "" +"<literal>unsaved-value</literal>（オプション - デフォルトの値はsensible）： " +"インスタンスが新しくインスタンス化された（セーブされていない）ことを示す、識" +"別子プロパティの値。以前のSessionでセーブまたはロードされた一時的インスタン" +"スと区別するために使います。" -#: index.docbook:509, index.docbook:1017, index.docbook:1156, index.docbook:1238, index.docbook:1345, index.docbook:1534, index.docbook:1708, index.docbook:1878, index.docbook:2457 -msgid "<literal>access</literal> (optional - defaults to <literal>property</literal>): The strategy Hibernate should use for accessing the property value." -msgstr "<literal>access</literal>（オプション - デフォルトは <literal>property</literal> ）：プロパティの値へアクセスするためにHibernateが使う戦略です。" +#. Tag: para +#: basic_mapping.xml:509 basic_mapping.xml:1017 basic_mapping.xml:1156 +#: basic_mapping.xml:1238 basic_mapping.xml:1345 basic_mapping.xml:1534 +#: basic_mapping.xml:1708 basic_mapping.xml:1878 basic_mapping.xml:2457 +#, fuzzy, no-c-format +msgid "" +"<literal>access</literal> (optional - defaults to <literal>property</" +"literal>): The strategy Hibernate should use for accessing the property " +"value." +msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>access</literal>（オプション - デフォルトは <literal>property</" +"literal> ）：プロパティの値へアクセスするためにHibernateが使う戦略です。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>access</literal> (オプション - デフォルトは <literal>property</" +"literal> ): Hibernateがプロパティの値にアクセスするために使用すべき戦略。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>access</literal> （オプション - デフォルトは <literal>property</" +"literal> ）：プロパティの値へのアクセスにHibernateが使う戦略。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>access</literal> （オプション - デフォルトは <literal>property</" +"literal> ）：プロパティの値へのアクセスにHibernateが使う戦略。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>access</literal>（オプション - デフォルトは <literal>property</" +"literal> ）：プロパティの値へのアクセスにHibernateが使う戦略。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>access</literal>（オプション - デフォルトは <literal>property</" +"literal> ）：プロパティの値へのアクセスにHibernateが使う戦略。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>access</literal>（オプション - デフォルトは <literal>property</" +"literal> ）：プロパティの値へのアクセスにHibernateが使う戦略。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>access</literal> （オプション - デフォルトは <literal>property</" +"literal> ）：プロパティの値へのアクセスにHibernateが使う戦略。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>access</literal>（オプション - デフォルトは <literal>property</" +"literal> ）：プロパティの値へのアクセスにHibernateが使う戦略。" -#: index.docbook:517 -msgid "If the <literal>name</literal> attribute is missing, it is assumed that the class has no identifier property." -msgstr "<literal>name</literal> 属性がなければ、クラスには識別子プロパティがないものとみなされます。" +#. Tag: para +#: basic_mapping.xml:517 +#, no-c-format +msgid "" +"If the <literal>name</literal> attribute is missing, it is assumed that the " +"class has no identifier property." +msgstr "" +"<literal>name</literal> 属性がなければ、クラスには識別子プロパティがないもの" +"とみなされます。" -#: index.docbook:522 -msgid "The <literal>unsaved-value</literal> attribute is almost never needed in Hibernate3." -msgstr "<literal>unsaved-value</literal> 属性はHibernate3ではほとんどの場合、必要ではありません。" +#. Tag: para +#: basic_mapping.xml:522 +#, no-c-format +msgid "" +"The <literal>unsaved-value</literal> attribute is almost never needed in " +"Hibernate3." +msgstr "" +"<literal>unsaved-value</literal> 属性はHibernate3ではほとんどの場合、必要では" +"ありません。" -#: index.docbook:526 -msgid "There is an alternative <literal><composite-id></literal> declaration to allow access to legacy data with composite keys. We strongly discourage its use for anything else." -msgstr "複合キーを持つレガシーデータにアクセスできるように、 <literal><composite-id></literal> という代替のマッピング定義があります。しかし他の用途への使用は全くおすすめできません。" +#. Tag: para +#: basic_mapping.xml:526 +#, no-c-format +msgid "" +"There is an alternative <literal><composite-id></literal> declaration " +"to allow access to legacy data with composite keys. We strongly discourage " +"its use for anything else." +msgstr "" +"複合キーを持つレガシーデータにアクセスできるように、 <literal><composite-" +"id></literal> という代替のマッピング定義があります。しかし他の用途への使" +"用は全くおすすめできません。" -#: index.docbook:532 +#. Tag: title +#: basic_mapping.xml:532 +#, no-c-format msgid "Generator" msgstr "ジェネレータ" -#: index.docbook:534 -msgid "The optional <literal><generator></literal> child element names a Java class used to generate unique identifiers for instances of the persistent class. If any parameters are required to configure or initialize the generator instance, they are passed using the <literal><param></literal> element." -msgstr "オプションの <literal><generator></literal> 子要素は、永続クラスのインスタンスのユニークな識別子を生成するために使う、Javaクラスを指定します。ジェネレータインスタンスの設定、もしくは初期化にパラメータが必要であれば、<literal><param></literal> 要素を使って渡すことができます。" +#. Tag: para +#: basic_mapping.xml:534 +#, no-c-format +msgid "" +"The optional <literal><generator></literal> child element names a Java " +"class used to generate unique identifiers for instances of the persistent " +"class. If any parameters are required to configure or initialize the " +"generator instance, they are passed using the <literal><param></" +"literal> element." +msgstr "" +"オプションの <literal><generator></literal> 子要素は、永続クラスのイン" +"スタンスのユニークな識別子を生成するために使う、Javaクラスを指定します。ジェ" +"ネレータインスタンスの設定、もしくは初期化にパラメータが必要であれば、" +"<literal><param></literal> 要素を使って渡すことができます。" -#: index.docbook:541 +#. Tag: programlisting +#: basic_mapping.xml:541 +#, no-c-format msgid "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"cat_id\">\n" - " <generator class=\"org.hibernate.id.TableHiLoGenerator\">\n" - " <param name=\"table\">uid_table</param>\n" - " <param name=\"column\">next_hi_value_column</param>\n" - " </generator>\n" - "</id>]]>" +"<![CDATA[<id name=\"id\" type=\"long\" column=\"cat_id\">\n" +" <generator class=\"org.hibernate.id.TableHiLoGenerator\">\n" +" <param name=\"table\">uid_table</param>\n" +" <param name=\"column\">next_hi_value_column</param>\n" +" </generator>\n" +"</id>]]>" msgstr "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"cat_id\"> -\n" - " <generator class=\"org.hibernate.id.TableHiLoGenerator\"> -\n" - " <param name=\"table\">uid_table</param> -\n" - " <param name=\"column\">next_hi_value_column</param> -\n" - " </generator> -\n" - "</id>]]>" -#: index.docbook:543 -msgid "All generators implement the interface <literal>org.hibernate.id.IdentifierGenerator</literal>. This is a very simple interface; some applications may choose to provide their own specialized implementations. However, Hibernate provides a range of built-in implementations. There are shortcut names for the built-in generators:" -msgstr "すべてのジェネレータは、インターフェイス <literal>org.hibernate.id.IdentifierGenerator</literal> を実装します。これはとても単純なインターフェイスなので、特別な実装を独自に用意するアプリケーションもあるかもしれません。しかしHibernateは組み込みの実装をいくつも用意しています。組み込みのジェネレータには以下のショートカット名があります：" +#. Tag: para +#: basic_mapping.xml:543 +#, fuzzy, no-c-format +msgid "" +"All generators implement the interface <literal>org.hibernate.id." +"IdentifierGenerator</literal>. This is a very simple interface; some " +"applications may choose to provide their own specialized implementations. " +"However, Hibernate provides a range of built-in implementations. There are " +"shortcut names for the built-in generators:" +msgstr "" +"すべてのジェネレータは、インターフェイス <literal>org.hibernate.id." +"IdentifierGenerator</literal> を実装します。これはとても単純なインターフェイ" +"スなので、特別な実装を独自に用意するアプリケーションもあるかもしれません。し" +"かしHibernateは組み込みの実装をいくつも用意しています。組み込みのジェネレー" +"タには以下のショートカット名があります： <placeholder-1/>" -#: index.docbook:551 +#. Tag: literal +#: basic_mapping.xml:551 +#, no-c-format msgid "increment" msgstr "increment" -#: index.docbook:553 -msgid "generates identifiers of type <literal>long</literal>, <literal>short</literal> or <literal>int</literal> that are unique only when no other process is inserting data into the same table. <emphasis>Do not use in a cluster.</emphasis>" -msgstr "<literal>long</literal> , <literal>short</literal> , <literal>int</literal> 型の識別子を生成します。これらは他のプロセスが同じテーブルにデータを挿入しないときだけユニークです。 <emphasis>クラスタ内では使わないでください</emphasis> 。" +#. Tag: para +#: basic_mapping.xml:553 +#, no-c-format +msgid "" +"generates identifiers of type <literal>long</literal>, <literal>short</" +"literal> or <literal>int</literal> that are unique only when no other " +"process is inserting data into the same table. <emphasis>Do not use in a " +"cluster.</emphasis>" +msgstr "" +"<literal>long</literal> , <literal>short</literal> , <literal>int</literal> " +"型の識別子を生成します。これらは他のプロセスが同じテーブルにデータを挿入しな" +"いときだけユニークです。 <emphasis>クラスタ内では使わないでください</" +"emphasis> 。" -#: index.docbook:562 +#. Tag: literal +#: basic_mapping.xml:562 +#, no-c-format msgid "identity" msgstr "identity" -#: index.docbook:564 -msgid "supports identity columns in DB2, MySQL, MS SQL Server, Sybase and HypersonicSQL. The returned identifier is of type <literal>long</literal>, <literal>short</literal> or <literal>int</literal>." -msgstr "DB2, MySQL, MS SQL Server, Sybase, HypersonicSQLの識別子カラムをサポートします。返される識別子の型は <literal>long</literal> , <literal>short</literal> , <literal>int</literal> のいずれかです。" +#. Tag: para +#: basic_mapping.xml:564 +#, no-c-format +msgid "" +"supports identity columns in DB2, MySQL, MS SQL Server, Sybase and " +"HypersonicSQL. The returned identifier is of type <literal>long</literal>, " +"<literal>short</literal> or <literal>int</literal>." +msgstr "" +"DB2, MySQL, MS SQL Server, Sybase, HypersonicSQLの識別子カラムをサポートしま" +"す。返される識別子の型は <literal>long</literal> , <literal>short</" +"literal> , <literal>int</literal> のいずれかです。" -#: index.docbook:572 +#. Tag: literal +#: basic_mapping.xml:572 +#, no-c-format msgid "sequence" msgstr "sequence" -#: index.docbook:574 -msgid "uses a sequence in DB2, PostgreSQL, Oracle, SAP DB, McKoi or a generator in Interbase. The returned identifier is of type <literal>long</literal>, <literal>short</literal> or <literal>int</literal>" -msgstr "DB2, PostgreSQL, Oracle, SAP DB, McKoiのシーケンスや、Interbaseのジェネレータを使用します。返される識別子の型は <literal>long</literal> , <literal>short</literal> , <literal>int</literal> のいずれかです。" +#. Tag: para +#: basic_mapping.xml:574 +#, no-c-format +msgid "" +"uses a sequence in DB2, PostgreSQL, Oracle, SAP DB, McKoi or a generator in " +"Interbase. The returned identifier is of type <literal>long</literal>, " +"<literal>short</literal> or <literal>int</literal>" +msgstr "" +"DB2, PostgreSQL, Oracle, SAP DB, McKoiのシーケンスや、Interbaseのジェネレータ" +"を使用します。返される識別子の型は <literal>long</literal> , " +"<literal>short</literal> , <literal>int</literal> のいずれかです。" -#: index.docbook:582 +#. Tag: literal +#: basic_mapping.xml:582 +#, no-c-format msgid "hilo" msgstr "hilo" -#: index.docbook:584 -msgid "uses a hi/lo algorithm to efficiently generate identifiers of type <literal>long</literal>, <literal>short</literal> or <literal>int</literal>, given a table and column (by default <literal>hibernate_unique_key</literal> and <literal>next_hi</literal> respectively) as a source of hi values. The hi/lo algorithm generates identifiers that are unique only for a particular database." -msgstr "<literal>long</literal> , <literal>short</literal> , <literal>int</literal> 型の識別子を効率的に生成するhi/loアルゴリズムを使います。 hi値のソースとして、テーブルとカラムを与えます(デフォルトではそれぞれ <literal>hibernate_unique_key</literal> と <literal>next_hi</literal> )。 hi/loアルゴリズムは特定のデータベースに対してのみユニークな識別子を生成します。" +#. Tag: para +#: basic_mapping.xml:584 +#, no-c-format +msgid "" +"uses a hi/lo algorithm to efficiently generate identifiers of type " +"<literal>long</literal>, <literal>short</literal> or <literal>int</literal>, " +"given a table and column (by default <literal>hibernate_unique_key</literal> " +"and <literal>next_hi</literal> respectively) as a source of hi values. The " +"hi/lo algorithm generates identifiers that are unique only for a particular " +"database." +msgstr "" +"<literal>long</literal> , <literal>short</literal> , <literal>int</literal> " +"型の識別子を効率的に生成するhi/loアルゴリズムを使います。 hi値のソースとし" +"て、テーブルとカラムを与えます(デフォルトではそれぞれ " +"<literal>hibernate_unique_key</literal> と <literal>next_hi</literal> )。 hi/" +"loアルゴリズムは特定のデータベースに対してのみユニークな識別子を生成します。" -#: index.docbook:594 +#. Tag: literal +#: basic_mapping.xml:594 +#, no-c-format msgid "seqhilo" msgstr "seqhilo" -#: index.docbook:596 -msgid "uses a hi/lo algorithm to efficiently generate identifiers of type <literal>long</literal>, <literal>short</literal> or <literal>int</literal>, given a named database sequence." -msgstr "<literal>long</literal> , <literal>short</literal> , <literal>int</literal> 型の識別子を効率的に生成するhi/loアルゴリズムを使います。指定されたデータベースシーケンスを与えます。" +#. Tag: para +#: basic_mapping.xml:596 +#, no-c-format +msgid "" +"uses a hi/lo algorithm to efficiently generate identifiers of type " +"<literal>long</literal>, <literal>short</literal> or <literal>int</literal>, " +"given a named database sequence." +msgstr "" +"<literal>long</literal> , <literal>short</literal> , <literal>int</literal> " +"型の識別子を効率的に生成するhi/loアルゴリズムを使います。指定されたデータ" +"ベースシーケンスを与えます。" -#: index.docbook:604 +#. Tag: literal +#: basic_mapping.xml:604 +#, no-c-format msgid "uuid" msgstr "uuid" -#: index.docbook:606 -msgid "uses a 128-bit UUID algorithm to generate identifiers of type string, unique within a network (the IP address is used). The UUID is encoded as a string of hexadecimal digits of length 32." -msgstr "(IPアドレスが使用される)ネットワーク内でユニークな文字列型の識別子を生成するために、 128ビットのUUIDアルゴリズムを使用します。UUIDは長さ32の16進数字の文字列としてエンコードされます。" +#. Tag: para +#: basic_mapping.xml:606 +#, no-c-format +msgid "" +"uses a 128-bit UUID algorithm to generate identifiers of type string, unique " +"within a network (the IP address is used). The UUID is encoded as a string " +"of hexadecimal digits of length 32." +msgstr "" +"(IPアドレスが使用される)ネットワーク内でユニークな文字列型の識別子を生成する" +"ために、 128ビットのUUIDアルゴリズムを使用します。UUIDは長さ32の16進数字の文" +"字列としてエンコードされます。" -#: index.docbook:614 +#. Tag: literal +#: basic_mapping.xml:614 +#, no-c-format msgid "guid" msgstr "guid" -#: index.docbook:616 +#. Tag: para +#: basic_mapping.xml:616 +#, no-c-format msgid "uses a database-generated GUID string on MS SQL Server and MySQL." msgstr "MS SQLサーバとMySQLでデータベースが生成するGUID文字列を使用します。" -#: index.docbook:622 +#. Tag: literal +#: basic_mapping.xml:622 +#, no-c-format msgid "native" msgstr "native" -#: index.docbook:624 -msgid "picks <literal>identity</literal>, <literal>sequence</literal> or <literal>hilo</literal> depending upon the capabilities of the underlying database." -msgstr "使用するデータベースの性能により <literal>identity</literal> , <literal>sequence</literal> , <literal>hilo</literal> のいずれかが選ばれます。" +#. Tag: para +#: basic_mapping.xml:624 +#, no-c-format +msgid "" +"picks <literal>identity</literal>, <literal>sequence</literal> or " +"<literal>hilo</literal> depending upon the capabilities of the underlying " +"database." +msgstr "" +"使用するデータベースの性能により <literal>identity</literal> , " +"<literal>sequence</literal> , <literal>hilo</literal> のいずれかが選ばれま" +"す。" -#: index.docbook:632 +#. Tag: literal +#: basic_mapping.xml:632 +#, no-c-format msgid "assigned" msgstr "assigned" -#: index.docbook:634 -msgid "lets the application to assign an identifier to the object before <literal>save()</literal> is called. This is the default strategy if no <literal><generator></literal> element is specified." -msgstr "<literal>save()</literal> が呼ばれる前に、アプリケーションがオブジェクトに識別子を代入できるようにします。 <literal><generator></literal> が指定されていなければ、これがデフォルトの戦略になります。" +#. Tag: para +#: basic_mapping.xml:634 +#, no-c-format +msgid "" +"lets the application to assign an identifier to the object before " +"<literal>save()</literal> is called. This is the default strategy if no " +"<literal><generator></literal> element is specified." +msgstr "" +"<literal>save()</literal> が呼ばれる前に、アプリケーションがオブジェクトに識" +"別子を代入できるようにします。 <literal><generator></literal> が指定さ" +"れていなければ、これがデフォルトの戦略になります。" -#: index.docbook:642 +#. Tag: literal +#: basic_mapping.xml:642 +#, no-c-format msgid "select" msgstr "select" -#: index.docbook:644 -msgid "retrieves a primary key assigned by a database trigger by selecting the row by some unique key and retrieving the primary key value." -msgstr "あるユニークキーによる行の選択と主キーの値の復元により、データベーストリガが割り当てた主キーを取得します。" +#. Tag: para +#: basic_mapping.xml:644 +#, no-c-format +msgid "" +"retrieves a primary key assigned by a database trigger by selecting the row " +"by some unique key and retrieving the primary key value." +msgstr "" +"あるユニークキーによる行の選択と主キーの値の復元により、データベーストリガが" +"割り当てた主キーを取得します。" -#: index.docbook:651 +#. Tag: literal +#: basic_mapping.xml:651 +#, no-c-format msgid "foreign" msgstr "foreign" -#: index.docbook:653 -msgid "uses the identifier of another associated object. Usually used in conjunction with a <literal><one-to-one></literal> primary key association." -msgstr "他の関連オブジェクトの識別子を使います。普通は、<literal><one-to-one></literal> 主キー関連と組み合わせて使います。" +#. Tag: para +#: basic_mapping.xml:653 +#, no-c-format +msgid "" +"uses the identifier of another associated object. Usually used in " +"conjunction with a <literal><one-to-one></literal> primary key " +"association." +msgstr "" +"他の関連オブジェクトの識別子を使います。普通は、<literal><one-to-one>" +"</literal> 主キー関連と組み合わせて使います。" -#: index.docbook:660 +#. Tag: literal +#: basic_mapping.xml:660 +#, no-c-format msgid "sequence-identity" -msgstr "Hi/lo アルゴリズム" +msgstr "sequence-identity" -#: index.docbook:662 -msgid "a specialized sequence generation strategy which utilizes a database sequence for the actual value generation, but combines this with JDBC3 getGeneratedKeys to actually return the generated identifier value as part of the insert statement execution. This strategy is only known to be supported on Oracle 10g drivers targetted for JDK 1.4. Note comments on these insert statements are disabled due to a bug in the Oracle drivers." -msgstr "<literal>hilo</literal> と <literal>seqhilo</literal> ジェネレータは、識別子生成の代表的なアプローチであるhi/loアルゴリズムの2つの代替実装を提供します。 1番目の実装は、次回に利用される\"hi\"値を保持する「特別な」データベーステーブルを必要とします。 2番目の実装は、Oracleスタイルのシーケンスを使います（サポートされている場合）。" +#. Tag: para +#: basic_mapping.xml:662 +#, no-c-format +msgid "" +"a specialized sequence generation strategy which utilizes a database " +"sequence for the actual value generation, but combines this with JDBC3 " +"getGeneratedKeys to actually return the generated identifier value as part " +"of the insert statement execution. This strategy is only known to be " +"supported on Oracle 10g drivers targetted for JDK 1.4. Note comments on " +"these insert statements are disabled due to a bug in the Oracle drivers." +msgstr "" +"a specialized sequence generation strategy which utilizes a database " +"sequence for the actual value generation, but combines this with JDBC3 " +"getGeneratedKeys to actually return the generated identifier value as part " +"of the insert statement execution. This strategy is only known to be " +"supported on Oracle 10g drivers targetted for JDK 1.4. Note comments on " +"these insert statements are disabled due to a bug in the Oracle drivers." -#: index.docbook:679 +#. Tag: title +#: basic_mapping.xml:679 +#, no-c-format msgid "Hi/lo algorithm" +msgstr "Hi/lo アルゴリズム" + +#. Tag: para +#: basic_mapping.xml:680 +#, no-c-format +msgid "" +"The <literal>hilo</literal> and <literal>seqhilo</literal> generators " +"provide two alternate implementations of the hi/lo algorithm, a favorite " +"approach to identifier generation. The first implementation requires a " +"\"special\" database table to hold the next available \"hi\" value. The " +"second uses an Oracle-style sequence (where supported)." msgstr "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"cat_id\"> -\n" - " <generator class=\"hilo\"> -\n" - " <param name=\"table\">hi_value</param> -\n" - " <param name=\"column\">next_value</param> -\n" - " <param name=\"max_lo\">100</param> -\n" - " </generator> -\n" - "</id>]]>" +"<literal>hilo</literal> と <literal>seqhilo</literal> ジェネレータは、識別子" +"生成の代表的なアプローチであるhi/loアルゴリズムの2つの代替実装を提供します。 " +"1番目の実装は、次回に利用される\"hi\"値を保持する「特別な」データベーステーブ" +"ルを必要とします。 2番目の実装は、Oracleスタイルのシーケンスを使います（サ" +"ポートされている場合）。" -#: index.docbook:680 -msgid "The <literal>hilo</literal> and <literal>seqhilo</literal> generators provide two alternate implementations of the hi/lo algorithm, a favorite approach to identifier generation. The first implementation requires a \"special\" database table to hold the next available \"hi\" value. The second uses an Oracle-style sequence (where supported)." +#. Tag: programlisting +#: basic_mapping.xml:687 +#, no-c-format +msgid "" +"<![CDATA[<id name=\"id\" type=\"long\" column=\"cat_id\">\n" +" <generator class=\"hilo\">\n" +" <param name=\"table\">hi_value</param>\n" +" <param name=\"column\">next_value</param>\n" +" <param name=\"max_lo\">100</param>\n" +" </generator>\n" +"</id>]]>" msgstr "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"cat_id\"> -\n" - " <generator class=\"seqhilo\"> -\n" - " <param name=\"sequence\">hi_value</param> -\n" - " <param name=\"max_lo\">100</param> -\n" - " </generator> -\n" - "</id>]]>" -#: index.docbook:687 +#. Tag: programlisting +#: basic_mapping.xml:689 +#, no-c-format msgid "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"cat_id\">\n" - " <generator class=\"hilo\">\n" - " <param name=\"table\">hi_value</param>\n" - " <param name=\"column\">next_value</param>\n" - " <param name=\"max_lo\">100</param>\n" - " </generator>\n" - "</id>]]>" -msgstr "残念ながらHibernateへの独自の <literal>Connection</literal> を提供するときには、<literal>hilo</literal> を使えません。 HibernateがJTAでリストされている接続を取得するためにアプリケーションサーバーのデータソースを使用しているときには、 <literal>hibernate.transaction.manager_lookup_class</literal> を適切に設定しなければなりません。" +"<![CDATA[<id name=\"id\" type=\"long\" column=\"cat_id\">\n" +" <generator class=\"seqhilo\">\n" +" <param name=\"sequence\">hi_value</param>\n" +" <param name=\"max_lo\">100</param>\n" +" </generator>\n" +"</id>]]>" +msgstr "" -#: index.docbook:689 +#. Tag: para +#: basic_mapping.xml:691 +#, no-c-format msgid "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"cat_id\">\n" - " <generator class=\"seqhilo\">\n" - " <param name=\"sequence\">hi_value</param>\n" - " <param name=\"max_lo\">100</param>\n" - " </generator>\n" - "</id>]]>" +"Unfortunately, you can't use <literal>hilo</literal> when supplying your own " +"<literal>Connection</literal> to Hibernate. When Hibernate is using an " +"application server datasource to obtain connections enlisted with JTA, you " +"must properly configure the <literal>hibernate.transaction." +"manager_lookup_class</literal>." +msgstr "" +"残念ながらHibernateへの独自の <literal>Connection</literal> を提供するときに" +"は、<literal>hilo</literal> を使えません。 HibernateがJTAでリストされている接" +"続を取得するためにアプリケーションサーバーのデータソースを使用しているときに" +"は、 <literal>hibernate.transaction.manager_lookup_class</literal> を適切に設" +"定しなければなりません。" + +#. Tag: title +#: basic_mapping.xml:700 +#, no-c-format +msgid "UUID algorithm" msgstr "UUID アルゴリズム" -#: index.docbook:691 -msgid "Unfortunately, you can't use <literal>hilo</literal> when supplying your own <literal>Connection</literal> to Hibernate. When Hibernate is using an application server datasource to obtain connections enlisted with JTA, you must properly configure the <literal>hibernate.transaction.manager_lookup_class</literal>." -msgstr "UUIDには以下のものが含まれます： IPアドレス、JVMのスタートアップタイム（4分の1秒の正確さ）、システム時間、（JVMに対してユニークな）カウンタ値。 JavaコードからMACアドレスやメモリアドレスを取得することはできないので、 JNIが使えないときの最良の方法です。" +#. Tag: para +#: basic_mapping.xml:701 +#, no-c-format +msgid "" +"The UUID contains: IP address, startup time of the JVM (accurate to a " +"quarter second), system time and a counter value (unique within the JVM). " +"It's not possible to obtain a MAC address or memory address from Java code, " +"so this is the best we can do without using JNI." +msgstr "" +"UUIDには以下のものが含まれます： IPアドレス、JVMのスタートアップタイム（4分の" +"1秒の正確さ）、システム時間、（JVMに対してユニークな）カウンタ値。 Javaコー" +"ドからMACアドレスやメモリアドレスを取得することはできないので、 JNIが使えない" +"ときの最良の方法です。" -#: index.docbook:700 -msgid "UUID algorithm" +#. Tag: title +#: basic_mapping.xml:710 +#, no-c-format +msgid "Identity columns and sequences" msgstr "識別子カラムとシーケンス" -#: index.docbook:701 -msgid "The UUID contains: IP address, startup time of the JVM (accurate to a quarter second), system time and a counter value (unique within the JVM). It's not possible to obtain a MAC address or memory address from Java code, so this is the best we can do without using JNI." -msgstr "識別子カラムをサポートしているデータベース（DB2, MySQL, Sybase, MS SQL）では、 <literal>identity</literal> キー生成を使えます。シーケンスをサポートするデータベース（DB2, Oracle, PostgreSQL, Interbase, McKoi, SAP DB）では、 <literal>sequence</literal> スタイルのキー生成を使えます。どちらの戦略も、新しいオブジェクトを挿入するために、SQLクエリを2つ必要とします。" +#. Tag: para +#: basic_mapping.xml:711 +#, no-c-format +msgid "" +"For databases which support identity columns (DB2, MySQL, Sybase, MS SQL), " +"you may use <literal>identity</literal> key generation. For databases that " +"support sequences (DB2, Oracle, PostgreSQL, Interbase, McKoi, SAP DB) you " +"may use <literal>sequence</literal> style key generation. Both these " +"strategies require two SQL queries to insert a new object." +msgstr "" +"識別子カラムをサポートしているデータベース（DB2, MySQL, Sybase, MS SQL）で" +"は、 <literal>identity</literal> キー生成を使えます。シーケンスをサポートす" +"るデータベース（DB2, Oracle, PostgreSQL, Interbase, McKoi, SAP DB）では、 " +"<literal>sequence</literal> スタイルのキー生成を使えます。どちらの戦略も、新" +"しいオブジェクトを挿入するために、SQLクエリを2つ必要とします。" -#: index.docbook:710 -msgid "Identity columns and sequences" +#. Tag: programlisting +#: basic_mapping.xml:719 +#, no-c-format +msgid "" +"<![CDATA[<id name=\"id\" type=\"long\" column=\"person_id\">\n" +" <generator class=\"sequence\">\n" +" <param name=\"sequence\">person_id_sequence</param>\n" +" </generator>\n" +"</id>]]>" msgstr "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"person_id\"> -\n" - " <generator class=\"sequence\"> -\n" - " <param name=\"sequence\">person_id_sequence</param> -\n" - " </generator> -\n" - "</id>]]>" -#: index.docbook:711 -msgid "For databases which support identity columns (DB2, MySQL, Sybase, MS SQL), you may use <literal>identity</literal> key generation. For databases that support sequences (DB2, Oracle, PostgreSQL, Interbase, McKoi, SAP DB) you may use <literal>sequence</literal> style key generation. Both these strategies require two SQL queries to insert a new object." +#. Tag: programlisting +#: basic_mapping.xml:721 +#, no-c-format +msgid "" +"<![CDATA[<id name=\"id\" type=\"long\" column=\"person_id\" unsaved-value=\"0" +"\">\n" +" <generator class=\"identity\"/>\n" +"</id>]]>" msgstr "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"person_id\" unsaved-value=\"0\"> -\n" - " <generator class=\"identity\"/> -\n" - "</id>]]>" -#: index.docbook:719 +#. Tag: para +#: basic_mapping.xml:723 +#, no-c-format msgid "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"person_id\">\n" - " <generator class=\"sequence\">\n" - " <param name=\"sequence\">person_id_sequence</param>\n" - " </generator>\n" - "</id>]]>" -msgstr "クロスプラットフォームの開発では、<literal>native</literal> 戦略は <literal>identity</literal> , <literal>sequence</literal> , <literal>hilo</literal> 戦略の中から1つを選択しますが、これは使用しているデータベースの能力に依存します。" +"For cross-platform development, the <literal>native</literal> strategy will " +"choose from the <literal>identity</literal>, <literal>sequence</literal> and " +"<literal>hilo</literal> strategies, dependant upon the capabilities of the " +"underlying database." +msgstr "" +"クロスプラットフォームの開発では、<literal>native</literal> 戦略は " +"<literal>identity</literal> , <literal>sequence</literal> , <literal>hilo</" +"literal> 戦略の中から1つを選択しますが、これは使用しているデータベースの能力" +"に依存します。" -#: index.docbook:721 -msgid "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"person_id\" unsaved-value=\"0\">\n" - " <generator class=\"identity\"/>\n" - "</id>]]>" +#. Tag: title +#: basic_mapping.xml:732 +#, no-c-format +msgid "Assigned identifiers" msgstr "識別子の割り当て" -#: index.docbook:723 -msgid "For cross-platform development, the <literal>native</literal> strategy will choose from the <literal>identity</literal>, <literal>sequence</literal> and <literal>hilo</literal> strategies, dependant upon the capabilities of the underlying database." -msgstr "アプリケーションに識別子を割り当てさせたいのであれば(Hibernateが生成するものではなく）、 <literal>assigned</literal> ジェネレータを使うことができます。この特別なジェネレータは、すでにオブジェクトの識別子プロパティに代入された値を識別子に使います。このジェネレータは主キーが代理キーの代わりに自然キーである場合に使用します。 <literal><generator></literal> 要素を指定しない場合のデフォルトの動作になります。" +#. Tag: para +#: basic_mapping.xml:733 +#, no-c-format +msgid "" +"If you want the application to assign identifiers (as opposed to having " +"Hibernate generate them), you may use the <literal>assigned</literal> " +"generator. This special generator will use the identifier value already " +"assigned to the object's identifier property. This generator is used when " +"the primary key is a natural key instead of a surrogate key. This is the " +"default behavior if you do no specify a <literal><generator></literal> " +"element." +msgstr "" +"アプリケーションに識別子を割り当てさせたいのであれば(Hibernateが生成するもの" +"ではなく）、 <literal>assigned</literal> ジェネレータを使うことができます。 " +"この特別なジェネレータは、すでにオブジェクトの識別子プロパティに代入された値" +"を識別子に使います。このジェネレータは主キーが代理キーの代わりに自然キーであ" +"る場合に使用します。 <literal><generator></literal> 要素を指定しない場" +"合のデフォルトの動作になります。" -#: index.docbook:732 -msgid "Assigned identifiers" -msgstr "<literal>assigned</literal> ジェネレータを選択すると、 Hibernateは <literal>unsaved-value=\"undefined\"</literal> を使用します。そして、バージョンやタイムスタンプのプロパティがない場合や <literal>Interceptor.isUnsaved()</literal> を定義しなかった場合には、インスタンスが一時的(transient)なものであるのか、またはセッションから分離(detached)したものかどうかを決めるために、データベースを調べます。" +#. Tag: para +#: basic_mapping.xml:742 +#, no-c-format +msgid "" +"Choosing the <literal>assigned</literal> generator makes Hibernate use " +"<literal>unsaved-value=\"undefined\"</literal>, forcing Hibernate to go to " +"the database to determine if an instance is transient or detached, unless " +"there is a version or timestamp property, or you define <literal>Interceptor." +"isUnsaved()</literal>." +msgstr "" +"<literal>assigned</literal> ジェネレータを選択すると、 Hibernateは " +"<literal>unsaved-value=\"undefined\"</literal> を使用します。そして、バー" +"ジョンやタイムスタンプのプロパティがない場合や <literal>Interceptor.isUnsaved" +"()</literal> を定義しなかった場合には、インスタンスが一時的(transient)なもの" +"であるのか、またはセッションから分離(detached)したものかどうかを決めるため" +"に、データベースを調べます。" -#: index.docbook:733 -msgid "If you want the application to assign identifiers (as opposed to having Hibernate generate them), you may use the <literal>assigned</literal> generator. This special generator will use the identifier value already assigned to the object's identifier property. This generator is used when the primary key is a natural key instead of a surrogate key. This is the default behavior if you do no specify a <literal><generator></literal> element." +#. Tag: title +#: basic_mapping.xml:752 +#, no-c-format +msgid "Primary keys assigned by triggers" msgstr "トリガにより割り当てられた主キー" -#: index.docbook:742 -msgid "Choosing the <literal>assigned</literal> generator makes Hibernate use <literal>unsaved-value=\"undefined\"</literal>, forcing Hibernate to go to the database to determine if an instance is transient or detached, unless there is a version or timestamp property, or you define <literal>Interceptor.isUnsaved()</literal>." -msgstr "レガシースキーマのためにのみ指定します(Hibernateはトリガを使ってDDLを生成しません)。" +#. Tag: para +#: basic_mapping.xml:753 +#, no-c-format +msgid "" +"For legacy schemas only (Hibernate does not generate DDL with triggers)." +msgstr "" +"レガシースキーマのためにのみ指定します(Hibernateはトリガを使ってDDLを生成しま" +"せん)。" -#: index.docbook:752 -msgid "Primary keys assigned by triggers" +#. Tag: programlisting +#: basic_mapping.xml:757 +#, no-c-format +msgid "" +"<![CDATA[<id name=\"id\" type=\"long\" column=\"person_id\">\n" +" <generator class=\"select\">\n" +" <param name=\"key\">socialSecurityNumber</param>\n" +" </generator>\n" +"</id>]]>" msgstr "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"person_id\"> -\n" - " <generator class=\"select\"> -\n" - " <param name=\"key\">socialSecurityNumber</param> -\n" - " </generator> -\n" - "</id>]]>" -#: index.docbook:753 -msgid "For legacy schemas only (Hibernate does not generate DDL with triggers)." -msgstr "上の例の中で、クラスで自然キーとして定義された <literal>socialSecurityNumber</literal> という名前のユニークな値のプロパティと、値がトリガにより生成される <literal>person_id</literal> という名前の代理キーがあります。" - -#: index.docbook:757 +#. Tag: para +#: basic_mapping.xml:759 +#, no-c-format msgid "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"person_id\">\n" - " <generator class=\"select\">\n" - " <param name=\"key\">socialSecurityNumber</param>\n" - " </generator>\n" - "</id>]]>" -msgstr "composite-id" - -#: index.docbook:759 -msgid "In the above example, there is a unique valued property named <literal>socialSecurityNumber</literal> defined by the class, as a natural key, and a surrogate key named <literal>person_id</literal> whose value is generated by a trigger." +"In the above example, there is a unique valued property named " +"<literal>socialSecurityNumber</literal> defined by the class, as a natural " +"key, and a surrogate key named <literal>person_id</literal> whose value is " +"generated by a trigger." msgstr "" - "<![CDATA[<composite-id -\n" - " name=\"propertyName\" -\n" - " class=\"ClassName\" -\n" - " mapped=\"true|false\" -\n" - " access=\"field|property|ClassName\"> -\n" - " node=\"element-name|.\" -\n" - " -\n" - " <key-property name=\"propertyName\" type=\"typename\" column=\"column_name\"/> -\n" - " <key-many-to-one name=\"propertyName class=\"ClassName\" column=\"column_name\"/> -\n" - " ...... -\n" - "</composite-id>]]>" +"上の例の中で、クラスで自然キーとして定義された " +"<literal>socialSecurityNumber</literal> という名前のユニークな値のプロパティ" +"と、値がトリガにより生成される <literal>person_id</literal> という名前の代理" +"キーがあります。" -#: index.docbook:771 +#. Tag: title +#: basic_mapping.xml:771 +#, no-c-format msgid "Enhanced identifier generators" -msgstr "複合キーのあるテーブルに対し、識別子プロパティとしてクラスの複数のプロパティをマッピングすることができます。 <literal><composite-id></literal> 要素は、子要素として <literal><key-property></literal> プロパティマッピングと <literal><key-many-to-one></literal> マッピングを受け入れます。" +msgstr "Enhanced identifier generators" -#: index.docbook:773 -msgid "Starting with release 3.2.3, there are 2 new generators which represent a re-thinking of 2 different aspects of identifier generation. The first aspect is database portability; the second is optimization (not having to query the database for every request for a new identifier value). These two new generators are intended to take the place of some of the named generators described above (starting in 3.3.x); however, they are included in the current releases and can be referenced by FQN." +#. Tag: para +#: basic_mapping.xml:773 +#, no-c-format +msgid "" +"Starting with release 3.2.3, there are 2 new generators which represent a re-" +"thinking of 2 different aspects of identifier generation. The first aspect " +"is database portability; the second is optimization (not having to query the " +"database for every request for a new identifier value). These two new " +"generators are intended to take the place of some of the named generators " +"described above (starting in 3.3.x); however, they are included in the " +"current releases and can be referenced by FQN." msgstr "" - "<![CDATA[<composite-id> -\n" - " <key-property name=\"medicareNumber\"/> -\n" - " <key-property name=\"dependent\"/> -\n" - "</composite-id>]]>" +"Starting with release 3.2.3, there are 2 new generators which represent a re-" +"thinking of 2 different aspects of identifier generation. The first aspect " +"is database portability; the second is optimization (not having to query the " +"database for every request for a new identifier value). These two new " +"generators are intended to take the place of some of the named generators " +"described above (starting in 3.3.x); however, they are included in the " +"current releases and can be referenced by FQN." -#: index.docbook:781 -msgid "The first of these new generators is <literal>org.hibernate.id.enhanced.SequenceStyleGenerator</literal> which is intended firstly as a replacement for the <literal>sequence</literal> generator and secondly as a better portability generator than <literal>native</literal> (because <literal>native</literal> (generally) chooses between <literal>identity</literal> and <literal>sequence</literal> which have largely different semantics which can cause subtle isssues in applications eyeing portability). <literal>org.hibernate.id.enhanced.SequenceStyleGenerator</literal> however achieves portability in a different manner. It chooses between using a table or a sequence in the database to store its incrementing values depending on the capabilities of the dialect being used. The difference between this and <literal>native</literal> is that table-based and sequence-based storage have the same exact semantic (in fact sequences are exactly what Hibernate tries to emmulate with its! table-based generators). This generator has a number of configuration parameters:" -msgstr "複合識別子の等価性を実装するためには、永続クラスが <literal>equals()</literal> と <literal>hashCode()</literal> をオーバーライド <emphasis>しなければなりません</emphasis> 。また <literal>Serializable</literal> も実装しなければいけません。" +#. Tag: para +#: basic_mapping.xml:781 +#, fuzzy, no-c-format +msgid "" +"The first of these new generators is <literal>org.hibernate.id.enhanced." +"SequenceStyleGenerator</literal> which is intended firstly as a replacement " +"for the <literal>sequence</literal> generator and secondly as a better " +"portability generator than <literal>native</literal> (because " +"<literal>native</literal> (generally) chooses between <literal>identity</" +"literal> and <literal>sequence</literal> which have largely different " +"semantics which can cause subtle isssues in applications eyeing " +"portability). <literal>org.hibernate.id.enhanced.SequenceStyleGenerator</" +"literal> however achieves portability in a different manner. It chooses " +"between using a table or a sequence in the database to store its " +"incrementing values depending on the capabilities of the dialect being used. " +"The difference between this and <literal>native</literal> is that table-" +"based and sequence-based storage have the same exact semantic (in fact " +"sequences are exactly what Hibernate tries to emmulate with its table-based " +"generators). This generator has a number of configuration parameters:" +msgstr "" +"The first of these new generators is <literal>org.hibernate.id.enhanced." +"SequenceStyleGenerator</literal> which is intended firstly as a replacement " +"for the <literal>sequence</literal> generator and secondly as a better " +"portability generator than <literal>native</literal> (because " +"<literal>native</literal> (generally) chooses between <literal>identity</" +"literal> and <literal>sequence</literal> which have largely different " +"semantics which can cause subtle isssues in applications eyeing " +"portability). <literal>org.hibernate.id.enhanced.SequenceStyleGenerator</" +"literal> however achieves portability in a different manner. It chooses " +"between using a table or a sequence in the database to store its " +"incrementing values depending on the capabilities of the dialect being used. " +"The difference between this and <literal>native</literal> is that table-" +"based and sequence-based storage have the same exact semantic (in fact " +"sequences are exactly what Hibernate tries to emmulate with its table-based " +"generators). This generator has a number of configuration parameters: " +"<placeholder-1/>" -#: index.docbook:795 -msgid "<literal>sequence_name</literal> (optional, defaults to <literal>hibernate_sequence</literal>): The name of the sequence (or table) to be used." -msgstr "残念ながら複合識別子のためのこの方法は、永続オブジェクトが自身の識別子であることを意味しています。オブジェクト自身を識別子とする以上の便利な「扱い方」はありません。複合キーに関連した永続状態を <literal>load()</literal> 出来るようになる前に、永続クラス自身をインスタンス化し、識別子プロパティを設定しなければなりません。 <emphasis> 組み込みの</emphasis> 複合識別子と呼ばれるこのアプローチは、本格的なアプリケーションには向いていません。" +#. Tag: para +#: basic_mapping.xml:795 +#, no-c-format +msgid "" +"<literal>sequence_name</literal> (optional, defaults to " +"<literal>hibernate_sequence</literal>): The name of the sequence (or table) " +"to be used." +msgstr "" +"<literal>sequence_name</literal> (optional, defaults to " +"<literal>hibernate_sequence</literal>): The name of the sequence (or table) " +"to be used." -#: index.docbook:801 -msgid "<literal>initial_value</literal> (optional, defaults to <literal>1</literal>): The initial value to be retrieved from the sequence/table. In sequence creation terms, this is analogous to the clause typical named \"STARTS WITH\"." -msgstr "2つ目の方法は <emphasis> マップされた</emphasis> 複合識別子と呼ばれるもので、 <literal><composite-id></literal>エレメント内で指定した識別プロパティが永続クラスと分離した識別子クラスの両方に重複して存在します。" +#. Tag: para +#: basic_mapping.xml:801 +#, no-c-format +msgid "" +"<literal>initial_value</literal> (optional, defaults to <literal>1</" +"literal>): The initial value to be retrieved from the sequence/table. In " +"sequence creation terms, this is analogous to the clause typical named " +"\"STARTS WITH\"." +msgstr "" +"<literal>initial_value</literal> (optional, defaults to <literal>1</" +"literal>): The initial value to be retrieved from the sequence/table. In " +"sequence creation terms, this is analogous to the clause typical named " +"\"STARTS WITH\"." -#: index.docbook:808 -msgid "<literal>increment_size</literal> (optional, defaults to <literal>1</literal>): The value by which subsequent calls to the sequence/table should differ. In sequence creation terms, this is analogous to the clause typical named \"INCREMENT BY\"." +#. Tag: para +#: basic_mapping.xml:808 +#, no-c-format +msgid "" +"<literal>increment_size</literal> (optional, defaults to <literal>1</" +"literal>): The value by which subsequent calls to the sequence/table should " +"differ. In sequence creation terms, this is analogous to the clause typical " +"named \"INCREMENT BY\"." msgstr "" - "<![CDATA[<composite-id class=\"MedicareId\" mapped=\"true\"> -\n" - " <key-property name=\"medicareNumber\"/> -\n" - " <key-property name=\"dependent\"/> -\n" - "</composite-id>]]>" +"<literal>increment_size</literal> (optional, defaults to <literal>1</" +"literal>): The value by which subsequent calls to the sequence/table should " +"differ. In sequence creation terms, this is analogous to the clause typical " +"named \"INCREMENT BY\"." -#: index.docbook:815 -msgid "<literal>force_table_use</literal> (optional, defaults to <literal>false</literal>): Should we force the use of a table as the backing structure even though the dialect might support sequence?" -msgstr "この例では、複合識別子クラス（ <literal>MedicareId</literal> ）とエンティティクラス自身の両方が、 <literal>medicareNumber</literal> と <literal>dependent</literal> という名前のプロパティを持ちます。識別子クラスは、<literal>equals()</literal> と <literal>hashCode()</literal> をオーバライドし、 <literal>Serializable</literal> を実装しなくてはなりません。この方法には、明らかにコードが重複するという不都合があります。" +#. Tag: para +#: basic_mapping.xml:815 +#, no-c-format +msgid "" +"<literal>force_table_use</literal> (optional, defaults to <literal>false</" +"literal>): Should we force the use of a table as the backing structure even " +"though the dialect might support sequence?" +msgstr "" +"<literal>force_table_use</literal> (optional, defaults to <literal>false</" +"literal>): Should we force the use of a table as the backing structure even " +"though the dialect might support sequence?" -#: index.docbook:822 -msgid "<literal>value_column</literal> (optional, defaults to <literal>next_val</literal>): Only relevant for table structures! The name of the column on the table which is used to hold the value." -msgstr "次の属性はマッピングした複合識別子を指定するために使用します。" +#. Tag: para +#: basic_mapping.xml:822 +#, no-c-format +msgid "" +"<literal>value_column</literal> (optional, defaults to <literal>next_val</" +"literal>): Only relevant for table structures! The name of the column on the " +"table which is used to hold the value." +msgstr "" +"<literal>value_column</literal> (optional, defaults to <literal>next_val</" +"literal>): Only relevant for table structures! The name of the column on the " +"table which is used to hold the value." -#: index.docbook:829 -msgid "<literal>optimizer</literal> (optional, defaults to <literal>none</literal>): See" -msgstr "<literal>mapped</literal> (オプション、デフォルトは <literal>false</literal> ): マッピングした複合識別子が使用されることと、包含されたプロパティのマッピングが、エンティティクラスと複合識別子クラスの両方を参照することを示します。" +#. Tag: para +#: basic_mapping.xml:829 +#, fuzzy, no-c-format +msgid "" +"<literal>optimizer</literal> (optional, defaults to <literal>none</" +"literal>): See" +msgstr "" +"<literal>cascade</literal>（オプション - デフォルトは <literal>none</" +"literal> ）：カスケードのスタイル。" -#: index.docbook:836 -msgid "The second of these new generators is <literal>org.hibernate.id.enhanced.TableGenerator</literal> which is intended firstly as a replacement for the <literal>table</literal> generator (although it actually functions much more like <literal>org.hibernate.id.MultipleHiLoPerTableGenerator</literal>) and secondly as a re-implementation of <literal>org.hibernate.id.MultipleHiLoPerTableGenerator</literal> utilizing the notion of pluggable optimiziers. Essentially this generator defines a table capable of holding a number of different increment values simultaneously by using multiple distinctly keyed rows. This generator has a number of configuration parameters:" -msgstr "<literal>class</literal> (オプション,ただしマッピングした複合識別子には必須): 複合識別子として使用するクラス。" +#. Tag: para +#: basic_mapping.xml:836 +#, fuzzy, no-c-format +msgid "" +"The second of these new generators is <literal>org.hibernate.id.enhanced." +"TableGenerator</literal> which is intended firstly as a replacement for the " +"<literal>table</literal> generator (although it actually functions much more " +"like <literal>org.hibernate.id.MultipleHiLoPerTableGenerator</literal>) and " +"secondly as a re-implementation of <literal>org.hibernate.id." +"MultipleHiLoPerTableGenerator</literal> utilizing the notion of pluggable " +"optimiziers. Essentially this generator defines a table capable of holding a " +"number of different increment values simultaneously by using multiple " +"distinctly keyed rows. This generator has a number of configuration " +"parameters:" +msgstr "" +"The second of these new generators is <literal>org.hibernate.id.enhanced." +"TableGenerator</literal> which is intended firstly as a replacement for the " +"<literal>table</literal> generator (although it actually functions much more " +"like <literal>org.hibernate.id.MultipleHiLoPerTableGenerator</literal>) and " +"secondly as a re-implementation of <literal>org.hibernate.id." +"MultipleHiLoPerTableGenerator</literal> utilizing the notion of pluggable " +"optimiziers. Essentially this generator defines a table capable of holding a " +"number of different increment values simultaneously by using multiple " +"distinctly keyed rows. This generator has a number of configuration " +"parameters: <placeholder-1/>" -#: index.docbook:846 -msgid "<literal>table_name</literal> (optional, defaults to <literal>hibernate_sequences</literal>): The name of the table to be used." -msgstr "3つ目のさらに便利な方法は、複合識別子を<xref linkend=\"components-compositeid\"/>内のコンポーネントクラスとして実装することです。下で記述している属性は、この代替方法にのみ適用されます。" +#. Tag: para +#: basic_mapping.xml:846 +#, no-c-format +msgid "" +"<literal>table_name</literal> (optional, defaults to " +"<literal>hibernate_sequences</literal>): The name of the table to be used." +msgstr "" +"<literal>table_name</literal> (optional, defaults to " +"<literal>hibernate_sequences</literal>): The name of the table to be used." -#: index.docbook:852 -msgid "<literal>value_column_name</literal> (optional, defaults to <literal>next_val</literal>): The name of the column on the table which is used to hold the value." -msgstr "<literal>name</literal> (オプション, このアプローチでは必須): 複合識別子を保持するコンポーネントタイプのプロパティ(9章を参照してください)." +#. Tag: para +#: basic_mapping.xml:852 +#, no-c-format +msgid "" +"<literal>value_column_name</literal> (optional, defaults to " +"<literal>next_val</literal>): The name of the column on the table which is " +"used to hold the value." +msgstr "" +"<literal>value_column_name</literal> (optional, defaults to " +"<literal>next_val</literal>): The name of the column on the table which is " +"used to hold the value." -#: index.docbook:858 -msgid "<literal>segment_column_name</literal> (optional, defaults to <literal>sequence_name</literal>): The name of the column on the table which is used to hold the \"segement key\". This is the value which distinctly identifies which increment value to use." -msgstr "<literal>access</literal> (オプション - デフォルトは <literal>property</literal> ): Hibernateがプロパティの値にアクセスするために使用すべき戦略。" +#. Tag: para +#: basic_mapping.xml:858 +#, no-c-format +msgid "" +"<literal>segment_column_name</literal> (optional, defaults to " +"<literal>sequence_name</literal>): The name of the column on the table which " +"is used to hold the \"segement key\". This is the value which distinctly " +"identifies which increment value to use." +msgstr "" +"<literal>segment_column_name</literal> (optional, defaults to " +"<literal>sequence_name</literal>): The name of the column on the table which " +"is used to hold the \"segement key\". This is the value which distinctly " +"identifies which increment value to use." -#: index.docbook:865 -msgid "<literal>segment_value</literal> (optional, defaults to <literal>default</literal>): The \"segment key\" value for the segment from which we want to pull increment values for this generator." -msgstr "<literal>class</literal> （オプション - デフォルトはリフレクションにより決定されるプロパティの型）：複合識別子として使われるコンポーネントのクラス（次の節を見てください）。" +#. Tag: para +#: basic_mapping.xml:865 +#, no-c-format +msgid "" +"<literal>segment_value</literal> (optional, defaults to <literal>default</" +"literal>): The \"segment key\" value for the segment from which we want to " +"pull increment values for this generator." +msgstr "" +"<literal>segment_value</literal> (optional, defaults to <literal>default</" +"literal>): The \"segment key\" value for the segment from which we want to " +"pull increment values for this generator." -#: index.docbook:872 -msgid "<literal>segment_value_length</literal> (optional, defaults to <literal>255</literal>): Used for schema generation; the column size to create this segment key column." -msgstr "この3つ目の方法は <emphasis> 識別子コンポーネント</emphasis> と呼び、ほとんどすべてのアプリケーションに対して推奨する方法です。" +#. Tag: para +#: basic_mapping.xml:872 +#, no-c-format +msgid "" +"<literal>segment_value_length</literal> (optional, defaults to <literal>255</" +"literal>): Used for schema generation; the column size to create this " +"segment key column." +msgstr "" +"<literal>segment_value_length</literal> (optional, defaults to <literal>255</" +"literal>): Used for schema generation; the column size to create this " +"segment key column." -#: index.docbook:878 -msgid "<literal>initial_value</literal> (optional, defaults to <literal>1</literal>): The initial value to be retrieved from the table." -msgstr "discriminator" +#. Tag: para +#: basic_mapping.xml:878 +#, no-c-format +msgid "" +"<literal>initial_value</literal> (optional, defaults to <literal>1</" +"literal>): The initial value to be retrieved from the table." +msgstr "" +"<literal>initial_value</literal> (optional, defaults to <literal>1</" +"literal>): The initial value to be retrieved from the table." -#: index.docbook:884 -msgid "<literal>increment_size</literal> (optional, defaults to <literal>1</literal>): The value by which subsequent calls to the table should differ." -msgstr "<literal><discriminator></literal> 要素は、 table-per-class-hierarchyマッピング戦略を使うポリモーフィックな永続化に必要であり、テーブルの識別カラムを定義します。識別カラムは、ある行に対して永続層がどのサブクラスをインスタンス化するかを伝えるマーカー値を含んでいます。以下のような型に制限されます： <literal>string</literal> , <literal>character</literal> , <literal>integer</literal>, <literal>byte</literal> , <literal>short</literal> , <literal>boolean</literal> , <literal>yes_no</literal> , <literal>true_false</literal>." +#. Tag: para +#: basic_mapping.xml:884 +#, no-c-format +msgid "" +"<literal>increment_size</literal> (optional, defaults to <literal>1</" +"literal>): The value by which subsequent calls to the table should differ." +msgstr "" +"<literal>increment_size</literal> (optional, defaults to <literal>1</" +"literal>): The value by which subsequent calls to the table should differ." -#: index.docbook:890 -msgid "<literal>optimizer</literal> (optional, defaults to <literal></literal>): See" +#. Tag: para +#: basic_mapping.xml:890 +#, fuzzy, no-c-format +msgid "" +"<literal>optimizer</literal> (optional, defaults to <literal></literal>): See" msgstr "" - "<![CDATA[<discriminator -\n" - " column=\"discriminator_column\" -\n" - " type=\"discriminator_type\" -\n" - " force=\"true|false\" -\n" - " insert=\"true|false\" -\n" - " formula=\"arbitrary sql expression\" -\n" - "/>]]>" +"<literal>cascade</literal>（オプション - デフォルトは <literal>none</" +"literal> ）：カスケードのスタイル。" -#: index.docbook:900 +#. Tag: title +#: basic_mapping.xml:900 +#, no-c-format msgid "Identifier generator optimization" -msgstr "<literal>column</literal>（オプション - デフォルトは <literal>class</literal> ）：識別カラムの名前。" +msgstr "Identifier generator optimization" -#: index.docbook:901 -msgid "For identifier generators which store values in the database, it is inefficient for them to hit the database on each and every call to generate a new identifier value. Instead, you'd ideally want to group a bunch of them in memory and only hit the database when you have exhausted your in-memory value group. This is the role of the pluggable optimizers. Currently only the two enhanced generators (<xref linkend=\"mapping-declaration-id-enhanced\"/> support this notion." -msgstr "<literal>type</literal> （オプション - デフォルトは <literal>string</literal> ）：Hibernateの型を示す名前。" +#. Tag: para +#: basic_mapping.xml:901 +#, fuzzy, no-c-format +msgid "" +"For identifier generators which store values in the database, it is " +"inefficient for them to hit the database on each and every call to generate " +"a new identifier value. Instead, you'd ideally want to group a bunch of them " +"in memory and only hit the database when you have exhausted your in-memory " +"value group. This is the role of the pluggable optimizers. Currently only " +"the two enhanced generators (<xref linkend=\"mapping-declaration-id-enhanced" +"\"/> support this notion." +msgstr "" +"For identifier generators which store values in the database, it is " +"inefficient for them to hit the database on each and every call to generate " +"a new identifier value. Instead, you'd ideally want to group a bunch of them " +"in memory and only hit the database when you have exhausted your in-memory " +"value group. This is the role of the pluggable optimizers. Currently only " +"the two enhanced generators (<xref linkend=\"mapping-declaration-id-enhanced" +"\"/> support this notion. <placeholder-1/>" -#: index.docbook:909 -msgid "<literal>none</literal> (generally this is the default if no optimizer was specified): This says to not perform any optimizations, and hit the database each and every request." -msgstr "<literal>force</literal> （オプション - デフォルトは <literal>false</literal> ）：ルートクラスのすべてのインスタンスを検索する場合であっても、 Hibernateが使用できる識別カラムの指定を「強制」します。" +#. Tag: para +#: basic_mapping.xml:909 +#, no-c-format +msgid "" +"<literal>none</literal> (generally this is the default if no optimizer was " +"specified): This says to not perform any optimizations, and hit the database " +"each and every request." +msgstr "" +"<literal>none</literal> (generally this is the default if no optimizer was " +"specified): This says to not perform any optimizations, and hit the database " +"each and every request." -#: index.docbook:915 -msgid "<literal>hilo</literal>: applies a hi/lo algorithm around the database retrieved values. The values from the database for this optimizer are expected to be sequential. The values retrieved from the database structure for this optimizer indicates the \"group number\"; the <literal>increment_size</literal> is multiplied by that value in memory to define a group \"hi value\"." -msgstr "<literal>insert</literal> （オプション - デフォルトは <literal>true</literal> ）：もし識別カラムがマッピングする複合識別子の一部ならば、<literal>false</literal> と設定してください。 (HibernateにSQLの <literal>INSERT</literal> には含まれないことを知らせる)" +#. Tag: para +#: basic_mapping.xml:915 +#, no-c-format +msgid "" +"<literal>hilo</literal>: applies a hi/lo algorithm around the database " +"retrieved values. The values from the database for this optimizer are " +"expected to be sequential. The values retrieved from the database structure " +"for this optimizer indicates the \"group number\"; the " +"<literal>increment_size</literal> is multiplied by that value in memory to " +"define a group \"hi value\"." +msgstr "" +"<literal>hilo</literal>: applies a hi/lo algorithm around the database " +"retrieved values. The values from the database for this optimizer are " +"expected to be sequential. The values retrieved from the database structure " +"for this optimizer indicates the \"group number\"; the " +"<literal>increment_size</literal> is multiplied by that value in memory to " +"define a group \"hi value\"." -#: index.docbook:924 -msgid "<literal>pooled</literal>: like was discussed for <literal>hilo</literal>, this optimizers attempts to minimize the number of hits to the database. Here, however, we simply store the starting value for the \"next group\" into the database structure rather than a sequential value in combination with an in-memory grouping algorithm. <literal>increment_size</literal> here refers to the values coming from the database." -msgstr "<literal>formula</literal> (オプション)型が評価されるときに実行される任意のSQL式。コンテンツベースの識別を可能にします。" +#. Tag: para +#: basic_mapping.xml:924 +#, no-c-format +msgid "" +"<literal>pooled</literal>: like was discussed for <literal>hilo</literal>, " +"this optimizers attempts to minimize the number of hits to the database. " +"Here, however, we simply store the starting value for the \"next group\" " +"into the database structure rather than a sequential value in combination " +"with an in-memory grouping algorithm. <literal>increment_size</literal> here " +"refers to the values coming from the database." +msgstr "" +"<literal>pooled</literal>: like was discussed for <literal>hilo</literal>, " +"this optimizers attempts to minimize the number of hits to the database. " +"Here, however, we simply store the starting value for the \"next group\" " +"into the database structure rather than a sequential value in combination " +"with an in-memory grouping algorithm. <literal>increment_size</literal> here " +"refers to the values coming from the database." -#: index.docbook:937 +#. Tag: title +#: basic_mapping.xml:937 +#, no-c-format msgid "composite-id" -msgstr "識別カラムの実際の値は、 <literal><class></literal> と <literal><subclass></literal> 要素の <literal>discriminator-value</literal> 属性で指定されます。" +msgstr "composite-id" -#: index.docbook:939 +#. Tag: programlisting +#: basic_mapping.xml:939 +#, no-c-format msgid "" - "<![CDATA[<composite-id\n" - " name=\"propertyName\"\n" - " class=\"ClassName\"\n" - " mapped=\"true|false\"\n" - " access=\"field|property|ClassName\">\n" - " node=\"element-name|.\"\n" - "\n" - " <key-property name=\"propertyName\" type=\"typename\" column=\"column_name\"/>\n" - " <key-many-to-one name=\"propertyName class=\"ClassName\" column=\"column_name\"/>\n" - " ......\n" - "</composite-id>]]>" -msgstr "永続クラスへマッピングされない｢余分な」識別値を持つ行がテーブルにあれば、（そのときに限り）<literal>force</literal> 属性は有効です。ただし、普通はそういうことはありません。" +"<![CDATA[<composite-id\n" +" name=\"propertyName\"\n" +" class=\"ClassName\"\n" +" mapped=\"true|false\"\n" +" access=\"field|property|ClassName\">\n" +" node=\"element-name|.\"\n" +"\n" +" <key-property name=\"propertyName\" type=\"typename\" column=" +"\"column_name\"/>\n" +" <key-many-to-one name=\"propertyName class=\"ClassName\" column=" +"\"column_name\"/>\n" +" ......\n" +"</composite-id>]]>" +msgstr "" -#: index.docbook:941 -msgid "For a table with a composite key, you may map multiple properties of the class as identifier properties. The <literal><composite-id></literal> element accepts <literal><key-property></literal> property mappings and <literal><key-many-to-one></literal> mappings as child elements." -msgstr "<literal>formula</literal> 属性を使うと、行の型を評価するために任意のSQL式を宣言できます。" +#. Tag: para +#: basic_mapping.xml:941 +#, no-c-format +msgid "" +"For a table with a composite key, you may map multiple properties of the " +"class as identifier properties. The <literal><composite-id></literal> " +"element accepts <literal><key-property></literal> property mappings " +"and <literal><key-many-to-one></literal> mappings as child elements." +msgstr "" +"複合キーのあるテーブルに対し、識別子プロパティとしてクラスの複数のプロパティ" +"をマッピングすることができます。 <literal><composite-id></literal> 要素" +"は、子要素として <literal><key-property></literal> プロパティマッピング" +"と <literal><key-many-to-one></literal> マッピングを受け入れます。" -#: index.docbook:948 +#. Tag: programlisting +#: basic_mapping.xml:948 +#, no-c-format msgid "" - "<![CDATA[<composite-id>\n" - " <key-property name=\"medicareNumber\"/>\n" - " <key-property name=\"dependent\"/>\n" - "</composite-id>]]>" +"<![CDATA[<composite-id>\n" +" <key-property name=\"medicareNumber\"/>\n" +" <key-property name=\"dependent\"/>\n" +"</composite-id>]]>" msgstr "" - "<![CDATA[<discriminator -\n" - " formula=\"case when CLASS_TYPE in ('a', 'b', 'c') then 0 else 1 end\" -\n" - " type=\"integer\"/>]]>" -#: index.docbook:950 -msgid "Your persistent class <emphasis>must</emphasis> override <literal>equals()</literal> and <literal>hashCode()</literal> to implement composite identifier equality. It must also implements <literal>Serializable</literal>." -msgstr "version（オプション）" +#. Tag: para +#: basic_mapping.xml:950 +#, no-c-format +msgid "" +"Your persistent class <emphasis>must</emphasis> override <literal>equals()</" +"literal> and <literal>hashCode()</literal> to implement composite identifier " +"equality. It must also implements <literal>Serializable</literal>." +msgstr "" +"複合識別子の等価性を実装するためには、永続クラスが <literal>equals()</" +"literal> と <literal>hashCode()</literal> をオーバーライド <emphasis>しなけれ" +"ばなりません</emphasis> 。また <literal>Serializable</literal> も実装しなけ" +"ればいけません。" -#: index.docbook:956 -msgid "Unfortunately, this approach to composite identifiers means that a persistent object is its own identifier. There is no convenient \"handle\" other than the object itself. You must instantiate an instance of the persistent class itself and populate its identifier properties before you can <literal>load()</literal> the persistent state associated with a composite key. We call this approach an <emphasis>embedded</emphasis> composite identifier, and discourage it for serious applications." -msgstr "<literal><version></literal> 要素はオプションであり、テーブルがバージョンデータを含むことを示します。これは <emphasis>ロングトランザクション</emphasis> を使うつもりなら、特に役立ちます（以下を見てください）。" +#. Tag: para +#: basic_mapping.xml:956 +#, no-c-format +msgid "" +"Unfortunately, this approach to composite identifiers means that a " +"persistent object is its own identifier. There is no convenient \"handle\" " +"other than the object itself. You must instantiate an instance of the " +"persistent class itself and populate its identifier properties before you " +"can <literal>load()</literal> the persistent state associated with a " +"composite key. We call this approach an <emphasis>embedded</emphasis> " +"composite identifier, and discourage it for serious applications." +msgstr "" +"残念ながら複合識別子のためのこの方法は、永続オブジェクトが自身の識別子である" +"ことを意味しています。オブジェクト自身を識別子とする以上の便利な「扱い方」は" +"ありません。複合キーに関連した永続状態を <literal>load()</literal> 出来るよ" +"うになる前に、永続クラス自身をインスタンス化し、識別子プロパティを設定しなけ" +"ればなりません。 <emphasis> 組み込みの</emphasis> 複合識別子と呼ばれるこのア" +"プローチは、本格的なアプリケーションには向いていません。" -#: index.docbook:965 -msgid "A second approach is what we call a <emphasis>mapped</emphasis> composite identifier, where the identifier properties named inside the <literal><composite-id></literal> element are duplicated on both the persistent class and a separate identifier class." +#. Tag: para +#: basic_mapping.xml:965 +#, no-c-format +msgid "" +"A second approach is what we call a <emphasis>mapped</emphasis> composite " +"identifier, where the identifier properties named inside the <literal><" +"composite-id></literal> element are duplicated on both the persistent " +"class and a separate identifier class." msgstr "" - "<![CDATA[<version -\n" - " column=\"version_column\" -\n" - " name=\"propertyName\" -\n" - " type=\"typename\" -\n" - " access=\"field|property|ClassName\" -\n" - " unsaved-value=\"null|negative|undefined\" -\n" - " generated=\"never|always\" -\n" - " insert=\"true|false\" -\n" - " node=\"element-name|@attribute-name|element/(a)attribute|.\" -\n" - "/>]]>" +"2つ目の方法は <emphasis> マップされた</emphasis> 複合識別子と呼ばれるもの" +"で、 <literal><composite-id></literal>エレメント内で指定した識別プロパ" +"ティが永続クラスと分離した識別子クラスの両方に重複して存在します。" -#: index.docbook:971 +#. Tag: programlisting +#: basic_mapping.xml:971 +#, no-c-format msgid "" - "<![CDATA[<composite-id class=\"MedicareId\" mapped=\"true\">\n" - " <key-property name=\"medicareNumber\"/>\n" - " <key-property name=\"dependent\"/>\n" - "</composite-id>]]>" -msgstr "<literal>column</literal>（オプション - デフォルトはプロパティ名）: バージョン番号を保持するカラムの名前。" +"<![CDATA[<composite-id class=\"MedicareId\" mapped=\"true\">\n" +" <key-property name=\"medicareNumber\"/>\n" +" <key-property name=\"dependent\"/>\n" +"</composite-id>]]>" +msgstr "" -#: index.docbook:973 -msgid "In this example, both the composite identifier class, <literal>MedicareId</literal>, and the entity class itself have properties named <literal>medicareNumber</literal> and <literal>dependent</literal>. The identifier class must override <literal>equals()</literal> and <literal>hashCode()</literal> and implement. <literal>Serializable</literal>. The disadvantage of this approach is quite obvious—code duplication." -msgstr "<literal>name</literal> ：永続クラスのプロパティの名前。" +#. Tag: para +#: basic_mapping.xml:973 +#, no-c-format +msgid "" +"In this example, both the composite identifier class, <literal>MedicareId</" +"literal>, and the entity class itself have properties named " +"<literal>medicareNumber</literal> and <literal>dependent</literal>. The " +"identifier class must override <literal>equals()</literal> and " +"<literal>hashCode()</literal> and implement. <literal>Serializable</" +"literal>. The disadvantage of this approach is quite obvious—code " +"duplication." +msgstr "" +"この例では、複合識別子クラス（ <literal>MedicareId</literal> ）とエンティティ" +"クラス自身の両方が、 <literal>medicareNumber</literal> と " +"<literal>dependent</literal> という名前のプロパティを持ちます。識別子クラス" +"は、<literal>equals()</literal> と <literal>hashCode()</literal> をオーバライ" +"ドし、 <literal>Serializable</literal> を実装しなくてはなりません。この方法" +"には、明らかにコードが重複するという不都合があります。" -#: index.docbook:982 -msgid "The following attributes are used to specify a mapped composite identifier:" -msgstr "<literal>type</literal> （オプション - デフォルトは <literal>integer</literal> ）：バージョン番号の型。" +#. Tag: para +#: basic_mapping.xml:982 +#, no-c-format +msgid "" +"The following attributes are used to specify a mapped composite identifier:" +msgstr "次の属性はマッピングした複合識別子を指定するために使用します。" -#: index.docbook:988 -msgid "<literal>mapped</literal> (optional, defaults to <literal>false</literal>): indicates that a mapped composite identifier is used, and that the contained property mappings refer to both the entity class and the composite identifier class." -msgstr "<literal>access</literal> （オプション - デフォルトは <literal>property</literal> ）：プロパティの値へのアクセスにHibernateが使う戦略。" +#. Tag: para +#: basic_mapping.xml:988 +#, no-c-format +msgid "" +"<literal>mapped</literal> (optional, defaults to <literal>false</literal>): " +"indicates that a mapped composite identifier is used, and that the contained " +"property mappings refer to both the entity class and the composite " +"identifier class." +msgstr "" +"<literal>mapped</literal> (オプション、デフォルトは <literal>false</" +"literal> ): マッピングした複合識別子が使用されることと、包含されたプロパティ" +"のマッピングが、エンティティクラスと複合識別子クラスの両方を参照することを示" +"します。" -#: index.docbook:996 -msgid "<literal>class</literal> (optional, but required for a mapped composite identifier): The class used as a composite identifier." -msgstr "<literal>unsaved-value</literal> （オプション - デフォルトは <literal>undefined</literal> ）：インスタンスが新しくインスタンス化されたことを示す（セーブされていないことを示す）バージョンプロパティの値。以前のSessionでセーブまたはロードされた一時的なインスタンスと区別するために使います。（ <literal>undefined</literal> は識別子プロパティの値が使われることを指定します。）" +#. Tag: para +#: basic_mapping.xml:996 +#, no-c-format +msgid "" +"<literal>class</literal> (optional, but required for a mapped composite " +"identifier): The class used as a composite identifier." +msgstr "" +"<literal>class</literal> (オプション,ただしマッピングした複合識別子には必" +"須): 複合識別子として使用するクラス。" -#: index.docbook:1003 -msgid "We will describe a third, even more convenient approach where the composite identifier is implemented as a component class in <xref linkend=\"components-compositeid\"/>. The attributes described below apply only to this alternative approach:" -msgstr "<literal>generated</literal> (オプション - デフォルトは <literal>never</literal> ): このバージョンのプロパティの値が、データベースによって生成されたことを指定します。 <xref linkend=\"mapping-generated\"/>生成プロパティの議論を見てください。" +#. Tag: para +#: basic_mapping.xml:1003 +#, no-c-format +msgid "" +"We will describe a third, even more convenient approach where the composite " +"identifier is implemented as a component class in <xref linkend=\"components-" +"compositeid\"/>. The attributes described below apply only to this " +"alternative approach:" +msgstr "" +"3つ目のさらに便利な方法は、複合識別子を<xref linkend=\"components-compositeid" +"\"/>内のコンポーネントクラスとして実装することです。下で記述している属性" +"は、この代替方法にのみ適用されます。" -#: index.docbook:1011 -msgid "<literal>name</literal> (optional, required for this approach): A property of component type that holds the composite identifier (see chapter 9)." -msgstr "<literal>insert</literal> (オプション - デフォルトは <literal>true</literal> ): SQLのinsert文にバージョン・カラムを含めるべきかどうかを指定します。もしデータベース・カラムのデフォルト値が <literal>0</literal> と定義されるときには、 <literal>false</literal> に設定すると良いでしょう。" +#. Tag: para +#: basic_mapping.xml:1011 +#, no-c-format +msgid "" +"<literal>name</literal> (optional, required for this approach): A property " +"of component type that holds the composite identifier (see chapter 9)." +msgstr "" +"<literal>name</literal> (オプション, このアプローチでは必須): 複合識別子を保" +"持するコンポーネントタイプのプロパティ(9章を参照してください)." -#: index.docbook:1023 -msgid "<literal>class</literal> (optional - defaults to the property type determined by reflection): The component class used as a composite identifier (see next section)." -msgstr "バージョンやタイムスタンプのプロパティは、分離されたインスタンスに対してnullであってはなりません。そのためどのような <literal>unsaved-value</literal> 戦略が指定されても、 Hibernateはnullのバージョンやタイムスタンプを持ったすべてのインスタンスを、一時的なものであると判断します。 <emphasis> nullを許容するバージョンやタイムスタンプのプロパティを定義することは、過渡的に一時オブジェクトとすることを防ぐ簡単な方法です。特に識別子の割り当てや複合キーを使用しているときには特に有用です。</emphasis>" +#. Tag: para +#: basic_mapping.xml:1023 +#, no-c-format +msgid "" +"<literal>class</literal> (optional - defaults to the property type " +"determined by reflection): The component class used as a composite " +"identifier (see next section)." +msgstr "" +"<literal>class</literal> （オプション - デフォルトはリフレクションにより決定" +"されるプロパティの型）：複合識別子として使われるコンポーネントのクラス（次の" +"節を見てください）。" -#: index.docbook:1030 -msgid "This third approach, an <emphasis>identifier component</emphasis> is the one we recommend for almost all applications." -msgstr "timestamp（オプション）" +#. Tag: para +#: basic_mapping.xml:1030 +#, no-c-format +msgid "" +"This third approach, an <emphasis>identifier component</emphasis> is the one " +"we recommend for almost all applications." +msgstr "" +"この3つ目の方法は <emphasis> 識別子コンポーネント</emphasis> と呼び、ほとん" +"どすべてのアプリケーションに対して推奨する方法です。" -#: index.docbook:1038 +#. Tag: title +#: basic_mapping.xml:1038 +#, no-c-format msgid "discriminator" -msgstr "オプションの <literal><timestamp></literal> 要素は、テーブルがタイムスタンプデータを含むことを示します。これはバージョン付けの代わりの方法として用意されています。タイムスタンプはもともと楽観的ロックにおける安全性の低い実装です。しかしアプリケーションは異なる用途で使うこともあるかもしれません。" +msgstr "discriminator" -#: index.docbook:1040 -msgid "The <literal><discriminator></literal> element is required for polymorphic persistence using the table-per-class-hierarchy mapping strategy and declares a discriminator column of the table. The discriminator column contains marker values that tell the persistence layer what subclass to instantiate for a particular row. A restricted set of types may be used: <literal>string</literal>, <literal>character</literal>, <literal>integer</literal>, <literal>byte</literal>, <literal>short</literal>, <literal>boolean</literal>, <literal>yes_no</literal>, <literal>true_false</literal>." +#. Tag: para +#: basic_mapping.xml:1040 +#, no-c-format +msgid "" +"The <literal><discriminator></literal> element is required for " +"polymorphic persistence using the table-per-class-hierarchy mapping strategy " +"and declares a discriminator column of the table. The discriminator column " +"contains marker values that tell the persistence layer what subclass to " +"instantiate for a particular row. A restricted set of types may be used: " +"<literal>string</literal>, <literal>character</literal>, <literal>integer</" +"literal>, <literal>byte</literal>, <literal>short</literal>, " +"<literal>boolean</literal>, <literal>yes_no</literal>, <literal>true_false</" +"literal>." msgstr "" - "<![CDATA[<timestamp -\n" - " column=\"timestamp_column\" -\n" - " name=\"propertyName\" -\n" - " access=\"field|property|ClassName\" -\n" - " unsaved-value=\"null|undefined\" -\n" - " source=\"vm|db\" -\n" - " generated=\"never|always\" -\n" - " node=\"element-name|@attribute-name|element/(a)attribute|.\" -\n" - "/>]]>" +"<literal><discriminator></literal> 要素は、 table-per-class-hierarchy" +"マッピング戦略を使うポリモーフィックな永続化に必要であり、テーブルの識別カラ" +"ムを定義します。識別カラムは、ある行に対して永続層がどのサブクラスをインスタ" +"ンス化するかを伝えるマーカー値を含んでいます。以下のような型に制限されま" +"す： <literal>string</literal> , <literal>character</literal> , " +"<literal>integer</literal>, <literal>byte</literal> , <literal>short</" +"literal> , <literal>boolean</literal> , <literal>yes_no</literal> , " +"<literal>true_false</literal>." -#: index.docbook:1058 +#. Tag: programlisting +#: basic_mapping.xml:1058 +#, no-c-format msgid "" - "<![CDATA[<discriminator\n" - " column=\"discriminator_column\"\n" - " type=\"discriminator_type\"\n" - " force=\"true|false\"\n" - " insert=\"true|false\"\n" - " formula=\"arbitrary sql expression\"\n" - "/>]]>" -msgstr "<literal>column</literal>（オプション - デフォルトはプロパティ名）：タイムスタンプを保持するカラムの名前。" +"<![CDATA[<discriminator\n" +" column=\"discriminator_column\"\n" +" type=\"discriminator_type\"\n" +" force=\"true|false\"\n" +" insert=\"true|false\"\n" +" formula=\"arbitrary sql expression\"\n" +"/>]]>" +msgstr "" -#: index.docbook:1061 -msgid "<literal>column</literal> (optional - defaults to <literal>class</literal>) the name of the discriminator column." -msgstr "<literal>name</literal> ：永続クラスであるJava の <literal>Date</literal>型または <literal>Timestamp</literal> 型の、JavaBeansスタイルプロパティの名前。" +#. Tag: para +#: basic_mapping.xml:1061 +#, no-c-format +msgid "" +"<literal>column</literal> (optional - defaults to <literal>class</literal>) " +"the name of the discriminator column." +msgstr "" +"<literal>column</literal>（オプション - デフォルトは <literal>class</" +"literal> ）：識別カラムの名前。" -#: index.docbook:1067 -msgid "<literal>type</literal> (optional - defaults to <literal>string</literal>) a name that indicates the Hibernate type" -msgstr "<literal>access</literal> （オプション - デフォルトは <literal>property</literal> ）：プロパティの値へのアクセスにHibernateが使う戦略。" +#. Tag: para +#: basic_mapping.xml:1067 +#, no-c-format +msgid "" +"<literal>type</literal> (optional - defaults to <literal>string</literal>) a " +"name that indicates the Hibernate type" +msgstr "" +"<literal>type</literal> （オプション - デフォルトは <literal>string</" +"literal> ）：Hibernateの型を示す名前。" -#: index.docbook:1073 -msgid "<literal>force</literal> (optional - defaults to <literal>false</literal>) \"force\" Hibernate to specify allowed discriminator values even when retrieving all instances of the root class." -msgstr "<literal>unsaved-value</literal> （オプション - デフォルトは <literal>null</literal> ）：インスタンスが新しくインスタンス化された（セーブされていない）ことを示すバージョンプロパティの値。以前のSessionでセーブまたはロードされた一時的なインスタンスと区別するために使われます。（ <literal>undefined</literal> と指定すると、識別子プロパティの値が使われます。）" +#. Tag: para +#: basic_mapping.xml:1073 +#, no-c-format +msgid "" +"<literal>force</literal> (optional - defaults to <literal>false</literal>) " +"\"force\" Hibernate to specify allowed discriminator values even when " +"retrieving all instances of the root class." +msgstr "" +"<literal>force</literal> （オプション - デフォルトは <literal>false</" +"literal> ）：ルートクラスのすべてのインスタンスを検索する場合であっても、 " +"Hibernateが使用できる識別カラムの指定を「強制」します。" -#: index.docbook:1080 -msgid "<literal>insert</literal> (optional - defaults to <literal>true</literal>) set this to <literal>false</literal> if your discriminator column is also part of a mapped composite identifier. (Tells Hibernate to not include the column in SQL <literal>INSERT</literal>s.)" -msgstr "<literal>source</literal> (オプション - デフォルトは <literal>vm</literal> ): Hibernateはどこからタイムスタンプの値を取得するべきでしょうか？データベースからでしょうか、現在のJVMからでしょうか？データベースによるタイムスタンプは、Hibernateが\"次の値\"を決定するためにデータベースをヒットしなければならないため、オーバヘッドを招きます。しかしクラスタ環境ではJVMから取得するより安全です。データベースの現在のタイムスタンプの取得をサポートするすべての <literal>データベース方言</literal> が知られているわけではないことに注意してください。また一方で、精密さを欠くために、ロックで使用するには安全でないものもあります(例えばOracle 8)。" +#. Tag: para +#: basic_mapping.xml:1080 +#, no-c-format +msgid "" +"<literal>insert</literal> (optional - defaults to <literal>true</literal>) " +"set this to <literal>false</literal> if your discriminator column is also " +"part of a mapped composite identifier. (Tells Hibernate to not include the " +"column in SQL <literal>INSERT</literal>s.)" +msgstr "" +"<literal>insert</literal> （オプション - デフォルトは <literal>true</" +"literal> ）：もし識別カラムがマッピングする複合識別子の一部ならば、" +"<literal>false</literal> と設定してください。 (HibernateにSQLの " +"<literal>INSERT</literal> には含まれないことを知らせる)" -#: index.docbook:1088 -msgid "<literal>formula</literal> (optional) an arbitrary SQL expression that is executed when a type has to be evaluated. Allows content-based discrimination." -msgstr "<literal>generated</literal> (オプション - デフォルトは <literal>never</literal> ): このタイムスタンプ・プロパティの値が、データベースによって生成されることを指定します。 <xref linkend=\"mapping-generated\"/>生成プロパティを参照してください。" +#. Tag: para +#: basic_mapping.xml:1088 +#, no-c-format +msgid "" +"<literal>formula</literal> (optional) an arbitrary SQL expression that is " +"executed when a type has to be evaluated. Allows content-based " +"discrimination." +msgstr "" +"<literal>formula</literal> (オプション)型が評価されるときに実行される任意の" +"SQL式。コンテンツベースの識別を可能にします。" -#: index.docbook:1096 -msgid "Actual values of the discriminator column are specified by the <literal>discriminator-value</literal> attribute of the <literal><class></literal> and <literal><subclass></literal> elements." -msgstr "<literal><timestamp></literal> は <literal><version type=\"timestamp\"></literal> と等価であることに注意してください。 <literal><timestamp source=\"db\"></literal> は <literal><version type=\"dbtimestamp\"></literal> と等価であることに注意してください。" +#. Tag: para +#: basic_mapping.xml:1096 +#, no-c-format +msgid "" +"Actual values of the discriminator column are specified by the " +"<literal>discriminator-value</literal> attribute of the <literal><" +"class></literal> and <literal><subclass></literal> elements." +msgstr "" +"識別カラムの実際の値は、 <literal><class></literal> と <literal><" +"subclass></literal> 要素の <literal>discriminator-value</literal> 属性で指" +"定されます。" -#: index.docbook:1102 -msgid "The <literal>force</literal> attribute is (only) useful if the table contains rows with \"extra\" discriminator values that are not mapped to a persistent class. This will not usually be the case." -msgstr "property" +#. Tag: para +#: basic_mapping.xml:1102 +#, no-c-format +msgid "" +"The <literal>force</literal> attribute is (only) useful if the table " +"contains rows with \"extra\" discriminator values that are not mapped to a " +"persistent class. This will not usually be the case." +msgstr "" +"永続クラスへマッピングされない｢余分な」識別値を持つ行がテーブルにあれば、" +"（そのときに限り）<literal>force</literal> 属性は有効です。ただし、普通はそ" +"ういうことはありません。" -#: index.docbook:1108 -msgid "Using the <literal>formula</literal> attribute you can declare an arbitrary SQL expression that will be used to evaluate the type of a row:" -msgstr "<literal><property></literal> 要素は、クラスの永続的なJavaBeanスタイルのプロパティを定義します。" +#. Tag: para +#: basic_mapping.xml:1108 +#, no-c-format +msgid "" +"Using the <literal>formula</literal> attribute you can declare an arbitrary " +"SQL expression that will be used to evaluate the type of a row:" +msgstr "" +"<literal>formula</literal> 属性を使うと、行の型を評価するために任意のSQL式を" +"宣言できます。" -#: index.docbook:1113 +#. Tag: programlisting +#: basic_mapping.xml:1113 +#, no-c-format msgid "" - "<![CDATA[<discriminator\n" - " formula=\"case when CLASS_TYPE in ('a', 'b', 'c') then 0 else 1 end\"\n" - " type=\"integer\"/>]]>" +"<![CDATA[<discriminator\n" +" formula=\"case when CLASS_TYPE in ('a', 'b', 'c') then 0 else 1 end\"\n" +" type=\"integer\"/>]]>" msgstr "" - "<![CDATA[<property -\n" - " name=\"propertyName\" -\n" - " column=\"column_name\" -\n" - " type=\"typename\" -\n" - " update=\"true|false\" -\n" - " insert=\"true|false\" -\n" - " formula=\"arbitrary SQL expression\" -\n" - " access=\"field|property|ClassName\" -\n" - " lazy=\"true|false\" -\n" - " unique=\"true|false\" -\n" - " not-null=\"true|false\" -\n" - " optimistic-lock=\"true|false\" -\n" - " generated=\"never|insert|always\" -\n" - " node=\"element-name|@attribute-name|element/(a)attribute|.\" -\n" - " index=\"index_name\" -\n" - " unique_key=\"unique_key_id\" -\n" - " length=\"L\" -\n" - " precision=\"P\" -\n" - " scale=\"S\" -\n" - "/>]]>" -#: index.docbook:1118 +#. Tag: title +#: basic_mapping.xml:1118 +#, no-c-format msgid "version (optional)" -msgstr "<literal>name</literal>：小文字で始まるプロパティ名。" +msgstr "version（オプション）" -#: index.docbook:1120 -msgid "The <literal><version></literal> element is optional and indicates that the table contains versioned data. This is particularly useful if you plan to use <emphasis>long transactions</emphasis> (see below)." -msgstr "<literal>column</literal>（オプション - デフォルトはプロパティ名）：マッピングされたデータベーステーブルのカラムの名前。ネストした <literal><column></literal> 要素でも指定できます。" +#. Tag: para +#: basic_mapping.xml:1120 +#, no-c-format +msgid "" +"The <literal><version></literal> element is optional and indicates " +"that the table contains versioned data. This is particularly useful if you " +"plan to use <emphasis>long transactions</emphasis> (see below)." +msgstr "" +"<literal><version></literal> 要素はオプションであり、テーブルがバー" +"ジョンデータを含むことを示します。これは <emphasis>ロングトランザクション</" +"emphasis> を使うつもりなら、特に役立ちます（以下を見てください）。" -#: index.docbook:1136 +#. Tag: programlisting +#: basic_mapping.xml:1136 +#, no-c-format msgid "" - "<![CDATA[<version\n" - " column=\"version_column\"\n" - " name=\"propertyName\"\n" - " type=\"typename\"\n" - " access=\"field|property|ClassName\"\n" - " unsaved-value=\"null|negative|undefined\"\n" - " generated=\"never|always\"\n" - " insert=\"true|false\"\n" - " node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" - "/>]]>" -msgstr "<literal>type</literal>（オプション）：Hibernateの型を示す名前。" +"<![CDATA[<version\n" +" column=\"version_column\"\n" +" name=\"propertyName\"\n" +" type=\"typename\"\n" +" access=\"field|property|ClassName\"\n" +" unsaved-value=\"null|negative|undefined\"\n" +" generated=\"never|always\"\n" +" insert=\"true|false\"\n" +" node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" +"/>]]>" +msgstr "" -#: index.docbook:1139 -msgid "<literal>column</literal> (optional - defaults to the property name): The name of the column holding the version number." -msgstr "<literal>update, insert</literal> （オプション - デフォルトは <literal>true</literal> ）：マッピングされたカラムがSQLの <literal>UPDATE</literal> や <literal>INSERT</literal> に含まれることを指定します。両方とも <literal>false</literal> に設定すると、同じカラムにマッピングされた他のプロパティやトリガや他のアプリケーションによって初期化された純粋な「導出」プロパティが可能になります。" +#. Tag: para +#: basic_mapping.xml:1139 +#, no-c-format +msgid "" +"<literal>column</literal> (optional - defaults to the property name): The " +"name of the column holding the version number." +msgstr "" +"<literal>column</literal>（オプション - デフォルトはプロパティ名）: バージョ" +"ン番号を保持するカラムの名前。" -#: index.docbook:1145 -msgid "<literal>name</literal>: The name of a property of the persistent class." -msgstr "<literal>formula</literal>（オプション）： <emphasis>計算</emphasis> プロパティのための値を定義するSQL式。計算されたプロパティは自身のカラムへのマッピングがありません。" +#. Tag: para +#: basic_mapping.xml:1145 +#, no-c-format +msgid "" +"<literal>name</literal>: The name of a property of the persistent class." +msgstr "<literal>name</literal> ：永続クラスのプロパティの名前。" -#: index.docbook:1150 -msgid "<literal>type</literal> (optional - defaults to <literal>integer</literal>): The type of the version number." -msgstr "<literal>access</literal>（オプション - デフォルトは <literal>property</literal> ）：プロパティの値へのアクセスにHibernateが使う戦略。" +#. Tag: para +#: basic_mapping.xml:1150 +#, no-c-format +msgid "" +"<literal>type</literal> (optional - defaults to <literal>integer</literal>): " +"The type of the version number." +msgstr "" +"<literal>type</literal> （オプション - デフォルトは <literal>integer</" +"literal> ）：バージョン番号の型。" -#: index.docbook:1162 -msgid "<literal>unsaved-value</literal> (optional - defaults to <literal>undefined</literal>): A version property value that indicates that an instance is newly instantiated (unsaved), distinguishing it from detached instances that were saved or loaded in a previous session. (<literal>undefined</literal> specifies that the identifier property value should be used.)" -msgstr "<literal>unique</literal> (オプション):カラムにユニーク制約をつけるDDLの生成を可能にします。また、<literal>property-ref</literal> のターゲットとすることもできます。" +#. Tag: para +#: basic_mapping.xml:1162 +#, no-c-format +msgid "" +"<literal>unsaved-value</literal> (optional - defaults to <literal>undefined</" +"literal>): A version property value that indicates that an instance is newly " +"instantiated (unsaved), distinguishing it from detached instances that were " +"saved or loaded in a previous session. (<literal>undefined</literal> " +"specifies that the identifier property value should be used.)" +msgstr "" +"<literal>unsaved-value</literal> （オプション - デフォルトは " +"<literal>undefined</literal> ）：インスタンスが新しくインスタンス化されたこ" +"とを示す（セーブされていないことを示す）バージョンプロパティの値。以前の" +"Sessionでセーブまたはロードされた一時的なインスタンスと区別するために使いま" +"す。（ <literal>undefined</literal> は識別子プロパティの値が使われることを指" +"定します。）" -#: index.docbook:1171 -msgid "<literal>generated</literal> (optional - defaults to <literal>never</literal>): Specifies that this version property value is actually generated by the database. See the discussion of <xref linkend=\"mapping-generated\"/>generated properties." -msgstr "<literal>not-null</literal> (オプション):カラムにnull値を許可するDDLの生成を可能にします。" +#. Tag: para +#: basic_mapping.xml:1171 +#, no-c-format +msgid "" +"<literal>generated</literal> (optional - defaults to <literal>never</" +"literal>): Specifies that this version property value is actually generated " +"by the database. See the discussion of <link linkend=\"mapping-generated" +"\">generated properties</link>." +msgstr "" +"<literal>generated</literal> (オプション - デフォルトは <literal>never</" +"literal> ): このバージョンのプロパティの値が、データベースによって生成された" +"ことを指定します。 <xref linkend=\"mapping-generated\">生成プロパティ</xref> " +"の議論を見てください。" -#: index.docbook:1178 -msgid "<literal>insert</literal> (optional - defaults to <literal>true</literal>): Specifies whether the version column should be included in SQL insert statements. May be set to <literal>false</literal> if and only if the database column is defined with a default value of <literal>0</literal>." -msgstr "<literal>optimistic-lock</literal> (オプション - デフォルトは <literal>true</literal> ): このプロパティの更新に楽観ロックの取得を要求するかどうかを指定します。言い換えれば、このプロパティがダーティであるときにバージョンを増やすべきかを決定します。" +#. Tag: para +#: basic_mapping.xml:1178 +#, no-c-format +msgid "" +"<literal>insert</literal> (optional - defaults to <literal>true</literal>): " +"Specifies whether the version column should be included in SQL insert " +"statements. May be set to <literal>false</literal> if and only if the " +"database column is defined with a default value of <literal>0</literal>." +msgstr "" +"<literal>insert</literal> (オプション - デフォルトは <literal>true</" +"literal> ): SQLのinsert文にバージョン・カラムを含めるべきかどうかを指定しま" +"す。もしデータベース・カラムのデフォルト値が <literal>0</literal> と定義され" +"るときには、 <literal>false</literal> に設定すると良いでしょう。" -#: index.docbook:1188 -msgid "Version numbers may be of Hibernate type <literal>long</literal>, <literal>integer</literal>, <literal>short</literal>, <literal>timestamp</literal> or <literal>calendar</literal>." -msgstr "<literal>generated</literal> (オプション - デフォルトは <literal>never</literal> ): プロパティの値が、データベースによって生成されたことを指定します。 <xref linkend=\"mapping-generated\"/>生成プロパティを参照してください。" +#. Tag: para +#: basic_mapping.xml:1188 +#, no-c-format +msgid "" +"Version numbers may be of Hibernate type <literal>long</literal>, " +"<literal>integer</literal>, <literal>short</literal>, <literal>timestamp</" +"literal> or <literal>calendar</literal>." +msgstr "" +"バージョン番号は Hibernateの <literal>long</literal> , <literal>integer</" +"literal> , <literal>short</literal> , <literal>timestamp</literal> , " +"<literal>calendar</literal> 型のいずれかです。" -#: index.docbook:1193 -msgid "A version or timestamp property should never be null for a detached instance, so Hibernate will detect any instance with a null version or timestamp as transient, no matter what other <literal>unsaved-value</literal> strategies are specified. <emphasis>Declaring a nullable version or timestamp property is an easy way to avoid any problems with transitive reattachment in Hibernate, especially useful for people using assigned identifiers or composite keys!</emphasis>" -msgstr "<emphasis>typename</emphasis> には以下の値が可能です：" +#. Tag: para +#: basic_mapping.xml:1193 +#, no-c-format +msgid "" +"A version or timestamp property should never be null for a detached " +"instance, so Hibernate will detect any instance with a null version or " +"timestamp as transient, no matter what other <literal>unsaved-value</" +"literal> strategies are specified. <emphasis>Declaring a nullable version or " +"timestamp property is an easy way to avoid any problems with transitive " +"reattachment in Hibernate, especially useful for people using assigned " +"identifiers or composite keys!</emphasis>" +msgstr "" +"バージョンやタイムスタンプのプロパティは、分離されたインスタンスに対してnull" +"であってはなりません。そのためどのような <literal>unsaved-value</literal> 戦" +"略が指定されても、 Hibernateはnullのバージョンやタイムスタンプを持ったすべて" +"のインスタンスを、一時的なものであると判断します。 <emphasis> nullを許容する" +"バージョンやタイムスタンプのプロパティを定義することは、過渡的に一時オブジェ" +"クトとすることを防ぐ簡単な方法です。特に識別子の割り当てや複合キーを使用して" +"いるときには特に有用です。</emphasis>" -#: index.docbook:1204 +#. Tag: title +#: basic_mapping.xml:1204 +#, no-c-format msgid "timestamp (optional)" -msgstr "Hibernateの基本型の名前（例 <literal>integer, string, character, date, timestamp, float, binary, serializable, object, blob</literal> ）。" +msgstr "timestamp（オプション）" -#: index.docbook:1206 -msgid "The optional <literal><timestamp></literal> element indicates that the table contains timestamped data. This is intended as an alternative to versioning. Timestamps are by nature a less safe implementation of optimistic locking. However, sometimes the application might use the timestamps in other ways." -msgstr "デフォルトの基本型のJavaクラス名（例 <literal>int, float, char, java.lang.String, java.util.Date, java.lang.Integer, java.sql.Clob</literal> ）。" +#. Tag: para +#: basic_mapping.xml:1206 +#, no-c-format +msgid "" +"The optional <literal><timestamp></literal> element indicates that the " +"table contains timestamped data. This is intended as an alternative to " +"versioning. Timestamps are by nature a less safe implementation of " +"optimistic locking. However, sometimes the application might use the " +"timestamps in other ways." +msgstr "" +"オプションの <literal><timestamp></literal> 要素は、テーブルがタイムス" +"タンプデータを含むことを示します。これはバージョン付けの代わりの方法として用" +"意されています。タイムスタンプはもともと楽観的ロックにおける安全性の低い実装" +"です。しかしアプリケーションは異なる用途で使うこともあるかもしれません。" -#: index.docbook:1222 +#. Tag: programlisting +#: basic_mapping.xml:1222 +#, no-c-format msgid "" - "<![CDATA[<timestamp\n" - " column=\"timestamp_column\"\n" - " name=\"propertyName\"\n" - " access=\"field|property|ClassName\"\n" - " unsaved-value=\"null|undefined\"\n" - " source=\"vm|db\"\n" - " generated=\"never|always\"\n" - " node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" - "/>]]>" -msgstr "シリアライズ可能なJavaクラスの名前。" +"<![CDATA[<timestamp\n" +" column=\"timestamp_column\"\n" +" name=\"propertyName\"\n" +" access=\"field|property|ClassName\"\n" +" unsaved-value=\"null|undefined\"\n" +" source=\"vm|db\"\n" +" generated=\"never|always\"\n" +" node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" +"/>]]>" +msgstr "" -#: index.docbook:1225 -msgid "<literal>column</literal> (optional - defaults to the property name): The name of a column holding the timestamp." -msgstr "カスタム型のクラス名（例 <literal>com.illflow.type.MyCustomType</literal> ）。" +#. Tag: para +#: basic_mapping.xml:1225 +#, no-c-format +msgid "" +"<literal>column</literal> (optional - defaults to the property name): The " +"name of a column holding the timestamp." +msgstr "" +"<literal>column</literal>（オプション - デフォルトはプロパティ名）：タイムス" +"タンプを保持するカラムの名前。" -#: index.docbook:1231 -msgid "<literal>name</literal>: The name of a JavaBeans style property of Java type <literal>Date</literal> or <literal>Timestamp</literal> of the persistent class." -msgstr "型を指定しなければ、Hibernateは正しいHibernateの型を推測するために、指定されたプロパティに対してリフレクションを使います。 Hibernateはルール2, 3, 4をその順序に使い、 getterプロパティの返り値のクラスの名前を解釈しようとします。しかしこれで常に十分であるとは限りません。場合によっては、<literal>type</literal> 属性が必要な場合があります。（例えば <literal>Hibernate.DATE</literal> と <literal>Hibernate.TIMESTAMP</literal> を区別するため、またはカスタム型を指定するためなどです。）" +#. Tag: para +#: basic_mapping.xml:1231 +#, no-c-format +msgid "" +"<literal>name</literal>: The name of a JavaBeans style property of Java type " +"<literal>Date</literal> or <literal>Timestamp</literal> of the persistent " +"class." +msgstr "" +"<literal>name</literal> ：永続クラスであるJava の <literal>Date</literal>型 " +"または <literal>Timestamp</literal> 型の、JavaBeansスタイルプロパティの名" +"前。" -#: index.docbook:1244 -msgid "<literal>unsaved-value</literal> (optional - defaults to <literal>null</literal>): A version property value that indicates that an instance is newly instantiated (unsaved), distinguishing it from detached instances that were saved or loaded in a previous session. (<literal>undefined</literal> specifies that the identifier property value should be used.)" -msgstr "特に強力な特徴は生成プロパティです。これらのプロパティは当然読み取り専用であり、プロパティの値はロード時に計算されます。計算をSQL式として宣言すると、このプロパティはインスタンスをロードするSQLクエリの <literal>SELECT</literal> 句のサブクエリに変換されます。" +#. Tag: para +#: basic_mapping.xml:1244 +#, no-c-format +msgid "" +"<literal>unsaved-value</literal> (optional - defaults to <literal>null</" +"literal>): A version property value that indicates that an instance is newly " +"instantiated (unsaved), distinguishing it from detached instances that were " +"saved or loaded in a previous session. (<literal>undefined</literal> " +"specifies that the identifier property value should be used.)" +msgstr "" +"<literal>unsaved-value</literal> （オプション - デフォルトは <literal>null</" +"literal> ）：インスタンスが新しくインスタンス化された（セーブされていない）" +"ことを示すバージョンプロパティの値。以前のSessionでセーブまたはロードされた" +"一時的なインスタンスと区別するために使われます。（ <literal>undefined</" +"literal> と指定すると、識別子プロパティの値が使われます。）" -#: index.docbook:1253 -msgid "<literal>source</literal> (optional - defaults to <literal>vm</literal>): From where should Hibernate retrieve the timestamp value? From the database, or from the current JVM? Database-based timestamps incur an overhead because Hibernate must hit the database in order to determine the \"next value\", but will be safer for use in clustered environments. Note also, that not all <literal>Dialect</literal>s are known to support retrieving of the database's current timestamp, while others might be unsafe for usage in locking due to lack of precision (Oracle 8 for example)." +#. Tag: para +#: basic_mapping.xml:1253 +#, no-c-format +msgid "" +"<literal>source</literal> (optional - defaults to <literal>vm</literal>): " +"From where should Hibernate retrieve the timestamp value? From the database, " +"or from the current JVM? Database-based timestamps incur an overhead because " +"Hibernate must hit the database in order to determine the \"next value\", " +"but will be safer for use in clustered environments. Note also, that not all " +"<literal>Dialect</literal>s are known to support retrieving of the " +"database's current timestamp, while others might be unsafe for usage in " +"locking due to lack of precision (Oracle 8 for example)." msgstr "" - "<![CDATA[ -\n" - "<property name=\"totalPrice\" -\n" - " formula=\"( SELECT SUM (li.quantity*p.price) FROM LineItem li, Product p -\n" - " WHERE li.productId = p.productId -\n" - " AND li.customerId = customerId -\n" - " AND li.orderNumber = orderNumber )\"/>]]>" +"<literal>source</literal> (オプション - デフォルトは <literal>vm</" +"literal> ): Hibernateはどこからタイムスタンプの値を取得するべきでしょうか？ " +"データベースからでしょうか、現在のJVMからでしょうか？データベースによるタイ" +"ムスタンプは、Hibernateが\"次の値\"を決定するためにデータベースをヒットしな" +"ければならないため、オーバヘッドを招きます。しかしクラスタ環境ではJVMから取" +"得するより安全です。データベースの現在のタイムスタンプの取得をサポートする " +"すべての <literal>データベース方言</literal> が知られているわけではないこと" +"に注意してください。また一方で、精密さを欠くために、ロックで使用するには安" +"全でないものもあります(例えばOracle 8)。" -#: index.docbook:1265 -msgid "<literal>generated</literal> (optional - defaults to <literal>never</literal>): Specifies that this timestamp property value is actually generated by the database. See the discussion of <xref linkend=\"mapping-generated\"/>generated properties." -msgstr "特定のカラム(例では <literal>customerId</literal> がそれにあたります)のエイリアスを宣言することなく、エンティティ自身のテーブルを参照できることに注意してください。もし属性を使用したくなければ、ネストした <literal><formula></literal> マッピング要素を使えることにも注意してください。" +#. Tag: para +#: basic_mapping.xml:1265 +#, no-c-format +msgid "" +"<literal>generated</literal> (optional - defaults to <literal>never</" +"literal>): Specifies that this timestamp property value is actually " +"generated by the database. See the discussion of <link linkend=\"mapping-" +"generated\">generated properties</link>." +msgstr "" +"<literal>generated</literal> (オプション - デフォルトは <literal>never</" +"literal> ): このタイムスタンプ・プロパティの値が、データベースによって生成さ" +"れることを指定します。 <xref linkend=\"mapping-generated\">生成プロパティ</" +"xref> を参照してください。" -#: index.docbook:1274 -msgid "Note that <literal><timestamp></literal> is equivalent to <literal><version type=\"timestamp\"></literal>. And <literal><timestamp source=\"db\"></literal> is equivalent to <literal><version type=\"dbtimestamp\"></literal>" -msgstr "many-to-one" +#. Tag: para +#: basic_mapping.xml:1274 +#, no-c-format +msgid "" +"Note that <literal><timestamp></literal> is equivalent to <literal><" +"version type=\"timestamp\"></literal>. And <literal><timestamp source=" +"\"db\"></literal> is equivalent to <literal><version type=\"dbtimestamp" +"\"></literal>" +msgstr "" +"<literal><timestamp></literal> は <literal><version type=\"timestamp" +"\"></literal> と等価であることに注意してください。 <literal><timestamp " +"source=\"db\"></literal> は <literal><version type=\"dbtimestamp\">" +"</literal> と等価であることに注意してください。" -#: index.docbook:1284 +#. Tag: title +#: basic_mapping.xml:1284 +#, no-c-format msgid "property" -msgstr "他の永続クラスへの通常の関連は <literal>many-to-one</literal> 要素を使って定義します。リレーショナルモデルは多対一関連です。つまりあるテーブルの外部キーは、ターゲットとなるテーブルの主キーカラムを参照しています。" +msgstr "property" -#: index.docbook:1286 -msgid "The <literal><property></literal> element declares a persistent, JavaBean style property of the class." +#. Tag: para +#: basic_mapping.xml:1286 +#, no-c-format +msgid "" +"The <literal><property></literal> element declares a persistent, " +"JavaBean style property of the class." msgstr "" - "<![CDATA[<many-to-one -\n" - " name=\"propertyName\" -\n" - " column=\"column_name\" -\n" - " class=\"ClassName\" -\n" - " cascade=\"cascade_style\" -\n" - " fetch=\"join|select\" -\n" - " update=\"true|false\" -\n" - " insert=\"true|false\" -\n" - " property-ref=\"propertyNameFromAssociatedClass\" -\n" - " access=\"field|property|ClassName\" -\n" - " unique=\"true|false\" -\n" - " not-null=\"true|false\" -\n" - " optimistic-lock=\"true|false\" -\n" - " lazy=\"proxy|no-proxy|false\" -\n" - " not-found=\"ignore|exception\" -\n" - " entity-name=\"EntityName\" -\n" - " formula=\"arbitrary SQL expression\" -\n" - " node=\"element-name|@attribute-name|element/(a)attribute|.\" -\n" - " embed-xml=\"true|false\" -\n" - " index=\"index_name\" -\n" - " unique_key=\"unique_key_id\" -\n" - " foreign-key=\"foreign_key_name\" -\n" - "/>]]>" +"<literal><property></literal> 要素は、クラスの永続的なJavaBeanスタイル" +"のプロパティを定義します。" -#: index.docbook:1308 +#. Tag: programlisting +#: basic_mapping.xml:1308 +#, no-c-format msgid "" - "<![CDATA[<property\n" - " name=\"propertyName\"\n" - " column=\"column_name\"\n" - " type=\"typename\"\n" - " update=\"true|false\"\n" - " insert=\"true|false\"\n" - " formula=\"arbitrary SQL expression\"\n" - " access=\"field|property|ClassName\"\n" - " lazy=\"true|false\"\n" - " unique=\"true|false\"\n" - " not-null=\"true|false\"\n" - " optimistic-lock=\"true|false\"\n" - " generated=\"never|insert|always\"\n" - " node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" - " index=\"index_name\"\n" - " unique_key=\"unique_key_id\"\n" - " length=\"L\"\n" - " precision=\"P\"\n" - " scale=\"S\"\n" - "/>]]>" -msgstr "<literal>name</literal>：プロパティ名。" +"<![CDATA[<property\n" +" name=\"propertyName\"\n" +" column=\"column_name\"\n" +" type=\"typename\"\n" +" update=\"true|false\"\n" +" insert=\"true|false\"\n" +" formula=\"arbitrary SQL expression\"\n" +" access=\"field|property|ClassName\"\n" +" lazy=\"true|false\"\n" +" unique=\"true|false\"\n" +" not-null=\"true|false\"\n" +" optimistic-lock=\"true|false\"\n" +" generated=\"never|insert|always\"\n" +" node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" +" index=\"index_name\"\n" +" unique_key=\"unique_key_id\"\n" +" length=\"L\"\n" +" precision=\"P\"\n" +" scale=\"S\"\n" +"/>]]>" +msgstr "" -#: index.docbook:1311 -msgid "<literal>name</literal>: the name of the property, with an initial lowercase letter." -msgstr "<literal>column</literal> (オプション):外部キーカラムの名前。ネストした <literal><column></literal> 要素でも指定できます。" +#. Tag: para +#: basic_mapping.xml:1311 +#, no-c-format +msgid "" +"<literal>name</literal>: the name of the property, with an initial lowercase " +"letter." +msgstr "<literal>name</literal>：小文字で始まるプロパティ名。" -#: index.docbook:1317 -msgid "<literal>column</literal> (optional - defaults to the property name): the name of the mapped database table column. This may also be specified by nested <literal><column></literal> element(s)." -msgstr "<literal>class</literal>（オプション - デフォルトは、リフレクションにより決定されるプロパティの型）：関連クラスの名前。" +#. Tag: para +#: basic_mapping.xml:1317 +#, no-c-format +msgid "" +"<literal>column</literal> (optional - defaults to the property name): the " +"name of the mapped database table column. This may also be specified by " +"nested <literal><column></literal> element(s)." +msgstr "" +"<literal>column</literal>（オプション - デフォルトはプロパティ名）：マッピン" +"グされたデータベーステーブルのカラムの名前。ネストした <literal><" +"column></literal> 要素でも指定できます。" -#: index.docbook:1324 -msgid "<literal>type</literal> (optional): a name that indicates the Hibernate type." -msgstr "<literal>cascade</literal>（オプション）：どの操作を、親オブジェクトから関連オブジェクトへとカスケードさせるかを指定します。" +#. Tag: para +#: basic_mapping.xml:1324 +#, no-c-format +msgid "" +"<literal>type</literal> (optional): a name that indicates the Hibernate type." +msgstr "<literal>type</literal>（オプション）：Hibernateの型を示す名前。" -#: index.docbook:1329 -msgid "<literal>update, insert</literal> (optional - defaults to <literal>true</literal>) : specifies that the mapped columns should be included in SQL <literal>UPDATE</literal> and/or <literal>INSERT</literal> statements. Setting both to <literal>false</literal> allows a pure \"derived\" property whose value is initialized from some other property that maps to the same colum(s) or by a trigger or other application." -msgstr "<literal>fetch</literal> (オプション - デフォルトは <literal>select</literal> ): 外部結合フェッチか順次選択フェッチ（sequential select fetch）を選択します。" +#. Tag: para +#: basic_mapping.xml:1329 +#, no-c-format +msgid "" +"<literal>update, insert</literal> (optional - defaults to <literal>true</" +"literal>) : specifies that the mapped columns should be included in SQL " +"<literal>UPDATE</literal> and/or <literal>INSERT</literal> statements. " +"Setting both to <literal>false</literal> allows a pure \"derived\" property " +"whose value is initialized from some other property that maps to the same " +"colum(s) or by a trigger or other application." +msgstr "" +"<literal>update, insert</literal> （オプション - デフォルトは <literal>true</" +"literal> ）：マッピングされたカラムがSQLの <literal>UPDATE</literal> や " +"<literal>INSERT</literal> に含まれることを指定します。両方とも " +"<literal>false</literal> に設定すると、同じカラムにマッピングされた他のプロ" +"パティやトリガや他のアプリケーションによって初期化された純粋な「導出」プロパ" +"ティが可能になります。" -#: index.docbook:1338 -msgid "<literal>formula</literal> (optional): an SQL expression that defines the value for a <emphasis>computed</emphasis> property. Computed properties do not have a column mapping of their own." -msgstr "<literal>update, insert</literal>（オプション - デフォルトは <literal>true</literal> ）：マッピングされたカラムがSQLの <literal>UPDATE</literal> または <literal>INSERT</literal> 文に含まれることを指定します。両方とも <literal>false</literal> に設定すると、その値が同じカラムにマッピングされた他のプロパティやトリガや他のアプリケーションによって初期化された純粋な「導出」プロパティが可能になります。" +#. Tag: para +#: basic_mapping.xml:1338 +#, no-c-format +msgid "" +"<literal>formula</literal> (optional): an SQL expression that defines the " +"value for a <emphasis>computed</emphasis> property. Computed properties do " +"not have a column mapping of their own." +msgstr "" +"<literal>formula</literal>（オプション）： <emphasis>計算</emphasis> プロパ" +"ティのための値を定義するSQL式。計算されたプロパティは自身のカラムへのマッピ" +"ングがありません。" -#: index.docbook:1351 -msgid "<literal>lazy</literal> (optional - defaults to <literal>false</literal>): Specifies that this property should be fetched lazily when the instance variable is first accessed (requires build-time bytecode instrumentation)." -msgstr "<literal>access</literal>（オプション - デフォルトは <literal>property</literal> ）：プロパティの値へのアクセスにHibernateが使う戦略。" +#. Tag: para +#: basic_mapping.xml:1351 +#, no-c-format +msgid "" +"<literal>lazy</literal> (optional - defaults to <literal>false</literal>): " +"Specifies that this property should be fetched lazily when the instance " +"variable is first accessed (requires build-time bytecode instrumentation)." +msgstr "" +"<literal>lazy</literal> (optional - デフォルトは <literal>false</literal> ): " +"インスタンス変数に最初にアクセスしたときに、プロパティを遅延して取得するよう" +"指定します。 (バイトコード実装を作成する時間が必要になります)。" -#: index.docbook:1358 -msgid "<literal>unique</literal> (optional): Enable the DDL generation of a unique constraint for the columns. Also, allow this to be the target of a <literal>property-ref</literal>." -msgstr "<literal>unique</literal>（オプション）：外部キーカラムに対してユニーク制約をつけたDDLの生成を可能にします。また、<literal>property-ref</literal> のターゲットにすることもできます。これにより関連の多重度を効果的に一対一にします。" +#. Tag: para +#: basic_mapping.xml:1358 +#, no-c-format +msgid "" +"<literal>unique</literal> (optional): Enable the DDL generation of a unique " +"constraint for the columns. Also, allow this to be the target of a " +"<literal>property-ref</literal>." +msgstr "" +"<literal>unique</literal> (オプション):カラムにユニーク制約をつけるDDLの生成" +"を可能にします。また、<literal>property-ref</literal> のターゲットとすること" +"もできます。" -#: index.docbook:1365 -msgid "<literal>not-null</literal> (optional): Enable the DDL generation of a nullability constraint for the columns." -msgstr "<literal>not-null</literal> (オプション):外部キーカラムに対して、 null値を許可するDDLの生成を可能にします" +#. Tag: para +#: basic_mapping.xml:1365 +#, no-c-format +msgid "" +"<literal>not-null</literal> (optional): Enable the DDL generation of a " +"nullability constraint for the columns." +msgstr "" +"<literal>not-null</literal> (オプション):カラムにnull値を許可するDDLの生成を" +"可能にします。" -#: index.docbook:1371 -msgid "<literal>optimistic-lock</literal> (optional - defaults to <literal>true</literal>): Specifies that updates to this property do or do not require acquisition of the optimistic lock. In other words, determines if a version increment should occur when this property is dirty." -msgstr "<literal>optimistic-lock</literal> (オプション - デフォルトは <literal>true</literal> ): このプロパティの更新に楽観的ロックの取得を要求するかどうかを指定します。言い換えれば、このプロパティがダーティであるときにバージョンを増やすべきかを決定します。" +#. Tag: para +#: basic_mapping.xml:1371 +#, no-c-format +msgid "" +"<literal>optimistic-lock</literal> (optional - defaults to <literal>true</" +"literal>): Specifies that updates to this property do or do not require " +"acquisition of the optimistic lock. In other words, determines if a version " +"increment should occur when this property is dirty." +msgstr "" +"<literal>optimistic-lock</literal> (オプション - デフォルトは <literal>true</" +"literal> ): このプロパティの更新に楽観ロックの取得を要求するかどうかを指定し" +"ます。言い換えれば、このプロパティがダーティであるときにバージョンを増やすべ" +"きかを決定します。" -#: index.docbook:1379 -msgid "<literal>generated</literal> (optional - defaults to <literal>never</literal>): Specifies that this property value is actually generated by the database. See the discussion of <xref linkend=\"mapping-generated\"/>generated properties." -msgstr "<literal>lazy</literal> (オプション - デフォルトは <literal>proxy</literal> ): デフォルトでは、多重度１の関連がプロキシとなります。 <literal>lazy=\"no-proxy\"</literal> は、インスタンス変数に最初にアクセスしたときに、プロパティを遅延フェッチするよう指定します (ビルド時にバイトコード実装が必要になります)。 <literal>lazy=\"false\"</literal> は関連を常に即時にフェッチするよう指定します。" +#. Tag: para +#: basic_mapping.xml:1379 +#, no-c-format +msgid "" +"<literal>generated</literal> (optional - defaults to <literal>never</" +"literal>): Specifies that this property value is actually generated by the " +"database. See the discussion of <link linkend=\"mapping-generated" +"\">generated properties</link>." +msgstr "" +"<literal>generated</literal> (オプション - デフォルトは <literal>never</" +"literal> ): プロパティの値が、データベースによって生成されたことを指定しま" +"す。 <xref linkend=\"mapping-generated\">生成プロパティ</xref> を参照してくだ" +"さい。" -#: index.docbook:1388 +#. Tag: para +#: basic_mapping.xml:1388 +#, no-c-format msgid "<emphasis>typename</emphasis> could be:" -msgstr "<literal>not-found</literal> (オプション - デフォルトは <literal>exception</literal> ): 欠落した行を参照する外部キーをどのように扱うかを指定します。 <literal>ignore</literal> は欠落した行をnull関連として扱います。" +msgstr "<emphasis>typename</emphasis> には以下の値が可能です：" -#: index.docbook:1394 -msgid "The name of a Hibernate basic type (eg. <literal>integer, string, character, date, timestamp, float, binary, serializable, object, blob</literal>)." -msgstr "<literal>entity-name</literal> (オプション):関連したクラスのエンティティ名。" +#. Tag: para +#: basic_mapping.xml:1394 +#, no-c-format +msgid "" +"The name of a Hibernate basic type (eg. <literal>integer, string, character, " +"date, timestamp, float, binary, serializable, object, blob</literal>)." +msgstr "" +"Hibernateの基本型の名前（例 <literal>integer, string, character, date, " +"timestamp, float, binary, serializable, object, blob</literal> ）。" -#: index.docbook:1400 -msgid "The name of a Java class with a default basic type (eg. <literal>int, float, char, java.lang.String, java.util.Date, java.lang.Integer, java.sql.Clob</literal>)." -msgstr "<literal>formula</literal> (オプション): <emphasis> 計算された</emphasis> 外部キーに対して値を定義するSQL式" +#. Tag: para +#: basic_mapping.xml:1400 +#, no-c-format +msgid "" +"The name of a Java class with a default basic type (eg. <literal>int, float, " +"char, java.lang.String, java.util.Date, java.lang.Integer, java.sql.Clob</" +"literal>)." +msgstr "" +"デフォルトの基本型のJavaクラス名（例 <literal>int, float, char, java.lang." +"String, java.util.Date, java.lang.Integer, java.sql.Clob</literal> ）。" -#: index.docbook:1406 +#. Tag: para +#: basic_mapping.xml:1406 +#, no-c-format msgid "The name of a serializable Java class." -msgstr "<literal>cascade</literal> 属性に <literal>none</literal> 以外の意味のある値をを設定すると、関連オブジェクトへある操作が伝播することになります。意味のある値とはHibernateの基本操作の名前のことで、 <literal>delete-orphan</literal> と <literal>all</literal> 、操作名をカンマで区切った組み合わせ（例えば <literal>cascade=\"persist,merge,evict\"</literal> や <literal>cascade=\"all,delete-orphan\"</literal>）、またそれだけでなく <literal>persist, merge, delete, save-update, evict, replicate, lock, refresh</literal> のことを指します。詳しい説明は <xref linkend=\"objectstate-transitive\"/> を見てください。値が一つの関連(many-to-oneとone-to-one関連)は、単独での削除（orphan delete)をサポートしていないことに注意してください。" +msgstr "シリアライズ可能なJavaクラスの名前。" -#: index.docbook:1411 -msgid "The class name of a custom type (eg. <literal>com.illflow.type.MyCustomType</literal>)." -msgstr "典型的な <literal>many-to-one</literal> 宣言は次のようにシンプルです。：" +#. Tag: para +#: basic_mapping.xml:1411 +#, no-c-format +msgid "" +"The class name of a custom type (eg. <literal>com.illflow.type.MyCustomType</" +"literal>)." +msgstr "" +"カスタム型のクラス名（例 <literal>com.illflow.type.MyCustomType</" +"literal> ）。" -#: index.docbook:1417 -msgid "If you do not specify a type, Hibernate will use reflection upon the named property to take a guess at the correct Hibernate type. Hibernate will try to interpret the name of the return class of the property getter using rules 2, 3, 4 in that order. However, this is not always enough. In certain cases you will still need the <literal>type</literal> attribute. (For example, to distinguish between <literal>Hibernate.DATE</literal> and <literal>Hibernate.TIMESTAMP</literal>, or to specify a custom type.)" -msgstr "<![CDATA[<many-to-one name=\"product\" class=\"Product\" column=\"PRODUCT_ID\"/>]]>" +#. Tag: para +#: basic_mapping.xml:1417 +#, no-c-format +msgid "" +"If you do not specify a type, Hibernate will use reflection upon the named " +"property to take a guess at the correct Hibernate type. Hibernate will try " +"to interpret the name of the return class of the property getter using rules " +"2, 3, 4 in that order. However, this is not always enough. In certain cases " +"you will still need the <literal>type</literal> attribute. (For example, to " +"distinguish between <literal>Hibernate.DATE</literal> and <literal>Hibernate." +"TIMESTAMP</literal>, or to specify a custom type.)" +msgstr "" +"型を指定しなければ、Hibernateは正しいHibernateの型を推測するために、指定され" +"たプロパティに対してリフレクションを使います。 Hibernateはルール2, 3, 4をその" +"順序に使い、 getterプロパティの返り値のクラスの名前を解釈しようとします。し" +"かしこれで常に十分であるとは限りません。場合によっては、<literal>type</" +"literal> 属性が必要な場合があります。（例えば <literal>Hibernate.DATE</" +"literal> と <literal>Hibernate.TIMESTAMP</literal> を区別するため、またはカ" +"スタム型を指定するためなどです。）" -#: index.docbook:1427 -msgid "The <literal>access</literal> attribute lets you control how Hibernate will access the property at runtime. By default, Hibernate will call the property get/set pair. If you specify <literal>access=\"field\"</literal>, Hibernate will bypass the get/set pair and access the field directly, using reflection. You may specify your own strategy for property access by naming a class that implements the interface <literal>org.hibernate.property.PropertyAccessor</literal>." -msgstr "<literal>property-ref</literal> 属性は、外部キーが関連付けられたテーブルの、主キーでないユニークキーを参照しているレガシーデータをマップするためにだけ使うべきです。これは醜いリレーショナルモデルです。例えば <literal>Product</literal> クラスが、主キーでないユニークなシリアルナンバーを持っていると仮定してみてください。（ <literal>unique</literal> 属性はSchemaExportツールを使ったHibernateのDDL生成を制御します。）" +#. Tag: para +#: basic_mapping.xml:1427 +#, no-c-format +msgid "" +"The <literal>access</literal> attribute lets you control how Hibernate will " +"access the property at runtime. By default, Hibernate will call the property " +"get/set pair. If you specify <literal>access=\"field\"</literal>, Hibernate " +"will bypass the get/set pair and access the field directly, using " +"reflection. You may specify your own strategy for property access by naming " +"a class that implements the interface <literal>org.hibernate.property." +"PropertyAccessor</literal>." +msgstr "" +"<literal>access</literal> 属性で、実行時にHibernateがどのようにプロパティに" +"アクセスするかを制御できます。デフォルトではHibernateはプロパティのget/setの" +"ペアをコールします。 <literal>access=\"field\"</literal> と指定すれば、 " +"Hibernateはリフレクションを使いget/setのペアを介さずに、直接フィールドにアク" +"セスします。インターフェイス <literal>org.hibernate.property." +"PropertyAccessor</literal> を実装するクラスを指定することで、プロパティへの" +"アクセスに独自の戦略を指定することができます。" -#: index.docbook:1436 -msgid "An especially powerful feature are derived properties. These properties are by definition read-only, the property value is computed at load time. You declare the computation as a SQL expression, this translates to a <literal>SELECT</literal> clause subquery in the SQL query that loads an instance:" -msgstr "<![CDATA[<property name=\"serialNumber\" unique=\"true\" type=\"string\" column=\"SERIAL_NUMBER\"/>]]>" +#. Tag: para +#: basic_mapping.xml:1436 +#, no-c-format +msgid "" +"An especially powerful feature are derived properties. These properties are " +"by definition read-only, the property value is computed at load time. You " +"declare the computation as a SQL expression, this translates to a " +"<literal>SELECT</literal> clause subquery in the SQL query that loads an " +"instance:" +msgstr "" +"特に強力な特徴は生成プロパティです。これらのプロパティは当然読み取り専用であ" +"り、プロパティの値はロード時に計算されます。計算をSQL式として宣言すると、こ" +"のプロパティはインスタンスをロードするSQLクエリの <literal>SELECT</literal> " +"句のサブクエリに変換されます。" -#: index.docbook:1443 +#. Tag: programlisting +#: basic_mapping.xml:1443 +#, no-c-format msgid "" - "<![CDATA[\n" - "<property name=\"totalPrice\"\n" - " formula=\"( SELECT SUM (li.quantity*p.price) FROM LineItem li, Product p\n" - " WHERE li.productId = p.productId\n" - " AND li.customerId = customerId\n" - " AND li.orderNumber = orderNumber )\"/>]]>" -msgstr "以下のように <literal>OrderItem</literal> に対してマッピングを使えます：" +"<![CDATA[\n" +"<property name=\"totalPrice\"\n" +" formula=\"( SELECT SUM (li.quantity*p.price) FROM LineItem li, Product " +"p\n" +" WHERE li.productId = p.productId\n" +" AND li.customerId = customerId\n" +" AND li.orderNumber = orderNumber )\"/>]]>" +msgstr "" -#: index.docbook:1445 -msgid "Note that you can reference the entities own table by not declaring an alias on a particular column (<literal>customerId</literal> in the given example). Also note that you can use the nested <literal><formula></literal> mapping element if you don't like to use the attribute." -msgstr "<![CDATA[<many-to-one name=\"product\" property-ref=\"serialNumber\" column=\"PRODUCT_SERIAL_NUMBER\"/>]]>" +#. Tag: para +#: basic_mapping.xml:1445 +#, no-c-format +msgid "" +"Note that you can reference the entities own table by not declaring an alias " +"on a particular column (<literal>customerId</literal> in the given example). " +"Also note that you can use the nested <literal><formula></literal> " +"mapping element if you don't like to use the attribute." +msgstr "" +"特定のカラム(例では <literal>customerId</literal> がそれにあたります)のエイリ" +"アスを宣言することなく、エンティティ自身のテーブルを参照できることに注意して" +"ください。もし属性を使用したくなければ、ネストした <literal><formula>" +"</literal> マッピング要素を使えることにも注意してください。" -#: index.docbook:1455 +#. Tag: title +#: basic_mapping.xml:1455 +#, no-c-format msgid "many-to-one" -msgstr "しかし、これは決して推奨できません。" +msgstr "many-to-one" -#: index.docbook:1457 -msgid "An ordinary association to another persistent class is declared using a <literal>many-to-one</literal> element. The relational model is a many-to-one association: a foreign key in one table is referencing the primary key column(s) of the target table." -msgstr "参照したユニークキーが、関連するエンティティの多数のプロパティから構成される場合、指定した <literal><properties></literal> 要素内で、参照するプロパティをマッピングするべきです。" +#. Tag: para +#: basic_mapping.xml:1457 +#, no-c-format +msgid "" +"An ordinary association to another persistent class is declared using a " +"<literal>many-to-one</literal> element. The relational model is a many-to-" +"one association: a foreign key in one table is referencing the primary key " +"column(s) of the target table." +msgstr "" +"他の永続クラスへの通常の関連は <literal>many-to-one</literal> 要素を使って定" +"義します。リレーショナルモデルは多対一関連です。つまりあるテーブルの外部" +"キーは、ターゲットとなるテーブルの主キーカラムを参照しています。" -#: index.docbook:1485 +#. Tag: programlisting +#: basic_mapping.xml:1485 +#, no-c-format msgid "" - "<![CDATA[<many-to-one\n" - " name=\"propertyName\"\n" - " column=\"column_name\"\n" - " class=\"ClassName\"\n" - " cascade=\"cascade_style\"\n" - " fetch=\"join|select\"\n" - " update=\"true|false\"\n" - " insert=\"true|false\"\n" - " property-ref=\"propertyNameFromAssociatedClass\"\n" - " access=\"field|property|ClassName\"\n" - " unique=\"true|false\"\n" - " not-null=\"true|false\"\n" - " optimistic-lock=\"true|false\"\n" - " lazy=\"proxy|no-proxy|false\"\n" - " not-found=\"ignore|exception\"\n" - " entity-name=\"EntityName\"\n" - " formula=\"arbitrary SQL expression\"\n" - " node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" - " embed-xml=\"true|false\"\n" - " index=\"index_name\"\n" - " unique_key=\"unique_key_id\"\n" - " foreign-key=\"foreign_key_name\"\n" - "/>]]>" -msgstr "もし参照したユニークキーがコンポーネントのプロパティである場合は、プロパティのパスを指定できます。" +"<![CDATA[<many-to-one\n" +" name=\"propertyName\"\n" +" column=\"column_name\"\n" +" class=\"ClassName\"\n" +" cascade=\"cascade_style\"\n" +" fetch=\"join|select\"\n" +" update=\"true|false\"\n" +" insert=\"true|false\"\n" +" property-ref=\"propertyNameFromAssociatedClass\"\n" +" access=\"field|property|ClassName\"\n" +" unique=\"true|false\"\n" +" not-null=\"true|false\"\n" +" optimistic-lock=\"true|false\"\n" +" lazy=\"proxy|no-proxy|false\"\n" +" not-found=\"ignore|exception\"\n" +" entity-name=\"EntityName\"\n" +" formula=\"arbitrary SQL expression\"\n" +" node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" +" embed-xml=\"true|false\"\n" +" index=\"index_name\"\n" +" unique_key=\"unique_key_id\"\n" +" foreign-key=\"foreign_key_name\"\n" +"/>]]>" +msgstr "" -#: index.docbook:1488, index.docbook:1669, index.docbook:1855 +#. Tag: para +#: basic_mapping.xml:1488 basic_mapping.xml:1669 basic_mapping.xml:1855 +#, no-c-format msgid "<literal>name</literal>: The name of the property." -msgstr "<![CDATA[<many-to-one name=\"owner\" property-ref=\"identity.ssn\" column=\"OWNER_SSN\"/>]]>" +msgstr "<literal>name</literal>：プロパティ名。" -#: index.docbook:1493, index.docbook:2284 -msgid "<literal>column</literal> (optional): The name of the foreign key column. This may also be specified by nested <literal><column></literal> element(s)." -msgstr "one-to-one" +#. Tag: para +#: basic_mapping.xml:1493 basic_mapping.xml:2284 +#, fuzzy, no-c-format +msgid "" +"<literal>column</literal> (optional): The name of the foreign key column. " +"This may also be specified by nested <literal><column></literal> " +"element(s)." +msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>column</literal> (オプション):外部キーカラムの名前。ネストした " +"<literal><column></literal> 要素でも指定できます。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>column</literal> (オプション):外部キーカラムの名前。ネストした " +"<literal><column></literal> カラムによっても指定されます。" -#: index.docbook:1500, index.docbook:1674 -msgid "<literal>class</literal> (optional - defaults to the property type determined by reflection): The name of the associated class." -msgstr "他の永続クラスへの一対一関連は、<literal>one-to-one</literal> 要素で定義します。" +#. Tag: para +#: basic_mapping.xml:1500 basic_mapping.xml:1674 +#, fuzzy, no-c-format +msgid "" +"<literal>class</literal> (optional - defaults to the property type " +"determined by reflection): The name of the associated class." +msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>class</literal>（オプション - デフォルトは、リフレクションにより決" +"定されるプロパティの型）：関連クラスの名前。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>class</literal>（オプション - デフォルトはリフレクションにより決定さ" +"れるプロパティの型）：関連クラスの名前。" -#: index.docbook:1506 -msgid "<literal>cascade</literal> (optional): Specifies which operations should be cascaded from the parent object to the associated object." +#. Tag: para +#: basic_mapping.xml:1506 +#, no-c-format +msgid "" +"<literal>cascade</literal> (optional): Specifies which operations should be " +"cascaded from the parent object to the associated object." msgstr "" - "<![CDATA[<one-to-one -\n" - " name=\"propertyName\" -\n" - " class=\"ClassName\" -\n" - " cascade=\"cascade_style\" -\n" - " constrained=\"true|false\" -\n" - " fetch=\"join|select\" -\n" - " property-ref=\"propertyNameFromAssociatedClass\" -\n" - " access=\"field|property|ClassName\" -\n" - " formula=\"any SQL expression\" -\n" - " lazy=\"proxy|no-proxy|false\" -\n" - " entity-name=\"EntityName\" -\n" - " node=\"element-name|@attribute-name|element/(a)attribute|.\" -\n" - " embed-xml=\"true|false\" -\n" - " foreign-key=\"foreign_key_name\" -\n" - "/>]]>" +"<literal>cascade</literal>（オプション）：どの操作を、親オブジェクトから関連" +"オブジェクトへとカスケードさせるかを指定します。" -#: index.docbook:1512, index.docbook:1695 -msgid "<literal>fetch</literal> (optional - defaults to <literal>select</literal>): Chooses between outer-join fetching or sequential select fetching." -msgstr "<literal>name</literal>：プロパティ名。" +#. Tag: para +#: basic_mapping.xml:1512 basic_mapping.xml:1695 +#, fuzzy, no-c-format +msgid "" +"<literal>fetch</literal> (optional - defaults to <literal>select</literal>): " +"Chooses between outer-join fetching or sequential select fetching." +msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>fetch</literal> (オプション - デフォルトは <literal>select</" +"literal> ): 外部結合フェッチか順次選択フェッチ（sequential select fetch）を選" +"択します。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>fetch</literal>（オプション - デフォルトは <literal>select</" +"literal> ）：外部結合フェッチと順次選択フェッチ（sequential select fetch）の" +"どちらかを選択します。" -#: index.docbook:1518 -msgid "<literal>update, insert</literal> (optional - defaults to <literal>true</literal>) specifies that the mapped columns should be included in SQL <literal>UPDATE</literal> and/or <literal>INSERT</literal> statements. Setting both to <literal>false</literal> allows a pure \"derived\" association whose value is initialized from some other property that maps to the same colum(s) or by a trigger or other application." -msgstr "<literal>class</literal>（オプション - デフォルトはリフレクションにより決定されるプロパティの型）：関連クラスの名前。" +#. Tag: para +#: basic_mapping.xml:1518 +#, no-c-format +msgid "" +"<literal>update, insert</literal> (optional - defaults to <literal>true</" +"literal>) specifies that the mapped columns should be included in SQL " +"<literal>UPDATE</literal> and/or <literal>INSERT</literal> statements. " +"Setting both to <literal>false</literal> allows a pure \"derived\" " +"association whose value is initialized from some other property that maps to " +"the same colum(s) or by a trigger or other application." +msgstr "" +"<literal>update, insert</literal>（オプション - デフォルトは <literal>true</" +"literal> ）：マッピングされたカラムがSQLの <literal>UPDATE</literal> または " +"<literal>INSERT</literal> 文に含まれることを指定します。両方とも " +"<literal>false</literal> に設定すると、その値が同じカラムにマッピングされた" +"他のプロパティやトリガや他のアプリケーションによって初期化された純粋な「導" +"出」プロパティが可能になります。" -#: index.docbook:1527 -msgid "<literal>property-ref</literal>: (optional) The name of a property of the associated class that is joined to this foreign key. If not specified, the primary key of the associated class is used." -msgstr "<literal>cascade</literal>（オプション）：親オブジェクトから関連オブジェクトへ、どの操作をカスケードするかを指定します。" +#. Tag: para +#: basic_mapping.xml:1527 +#, no-c-format +msgid "" +"<literal>property-ref</literal>: (optional) The name of a property of the " +"associated class that is joined to this foreign key. If not specified, the " +"primary key of the associated class is used." +msgstr "" +"<literal>property-ref</literal>（オプション）：この外部キーに結合された関連" +"クラスのプロパティ名。何も指定しなければ、関連クラスの主キーが使われます。" -#: index.docbook:1540 -msgid "<literal>unique</literal> (optional): Enable the DDL generation of a unique constraint for the foreign-key column. Also, allow this to be the target of a <literal>property-ref</literal>. This makes the association multiplicity effectively one to one." -msgstr "<literal>fetch</literal>（オプション - デフォルトは <literal>select</literal> ）：外部結合フェッチと順次選択フェッチ（sequential select fetch）のどちらかを選択します。" +#. Tag: para +#: basic_mapping.xml:1540 +#, no-c-format +msgid "" +"<literal>unique</literal> (optional): Enable the DDL generation of a unique " +"constraint for the foreign-key column. Also, allow this to be the target of " +"a <literal>property-ref</literal>. This makes the association multiplicity " +"effectively one to one." +msgstr "" +"<literal>unique</literal>（オプション）：外部キーカラムに対してユニーク制約" +"をつけたDDLの生成を可能にします。また、<literal>property-ref</literal> の" +"ターゲットにすることもできます。これにより関連の多重度を効果的に一対一にしま" +"す。" -#: index.docbook:1548 -msgid "<literal>not-null</literal> (optional): Enable the DDL generation of a nullability constraint for the foreign key columns." -msgstr "<literal>property-ref</literal>（オプション）：このクラスの主キーに結合された関連クラスのプロパティ名。指定されなければ、関連クラスの主キーが使われます。" +#. Tag: para +#: basic_mapping.xml:1548 +#, no-c-format +msgid "" +"<literal>not-null</literal> (optional): Enable the DDL generation of a " +"nullability constraint for the foreign key columns." +msgstr "" +"<literal>not-null</literal> (オプション):外部キーカラムに対して、 null値を許" +"可するDDLの生成を可能にします" -#: index.docbook:1554 -msgid "<literal>optimistic-lock</literal> (optional - defaults to <literal>true</literal>): Specifies that updates to this property do or do not require acquisition of the optimistic lock. In other words, dertermines if a version increment should occur when this property is dirty." -msgstr "<literal>access</literal>（オプション - デフォルトは <literal>property</literal> ）：プロパティの値へのアクセスにHibernateが使う戦略。" +#. Tag: para +#: basic_mapping.xml:1554 +#, no-c-format +msgid "" +"<literal>optimistic-lock</literal> (optional - defaults to <literal>true</" +"literal>): Specifies that updates to this property do or do not require " +"acquisition of the optimistic lock. In other words, dertermines if a version " +"increment should occur when this property is dirty." +msgstr "" +"<literal>optimistic-lock</literal> (オプション - デフォルトは <literal>true</" +"literal> ): このプロパティの更新に楽観的ロックの取得を要求するかどうかを指定" +"します。言い換えれば、このプロパティがダーティであるときにバージョンを増やす" +"べきかを決定します。" -#: index.docbook:1562 -msgid "<literal>lazy</literal> (optional - defaults to <literal>proxy</literal>): By default, single point associations are proxied. <literal>lazy=\"no-proxy\"</literal> specifies that the property should be fetched lazily when the instance variable is first accessed (requires build-time bytecode instrumentation). <literal>lazy=\"false\"</literal> specifies that the association will always be eagerly fetched." -msgstr "<literal>formula</literal> (オプション): ほとんどすべての一対一関連はオーナーのエンティティの主キーへとマッピングされます。これ以外の稀な場合は、他のカラムや、複数のカラム、SQL構文を使った結合するための式を指定できます。（例は <literal>org.hibernate.test.onetooneformula</literal> を参照してください。）" +#. Tag: para +#: basic_mapping.xml:1562 +#, no-c-format +msgid "" +"<literal>lazy</literal> (optional - defaults to <literal>proxy</literal>): " +"By default, single point associations are proxied. <literal>lazy=\"no-proxy" +"\"</literal> specifies that the property should be fetched lazily when the " +"instance variable is first accessed (requires build-time bytecode " +"instrumentation). <literal>lazy=\"false\"</literal> specifies that the " +"association will always be eagerly fetched." +msgstr "" +"<literal>lazy</literal> (オプション - デフォルトは <literal>proxy</" +"literal> ): デフォルトでは、多重度１の関連がプロキシとなります。 " +"<literal>lazy=\"no-proxy\"</literal> は、インスタンス変数に最初にアクセスした" +"ときに、プロパティを遅延フェッチするよう指定します (ビルド時にバイトコード実" +"装が必要になります)。 <literal>lazy=\"false\"</literal> は関連を常に即時に" +"フェッチするよう指定します。" -#: index.docbook:1572 -msgid "<literal>not-found</literal> (optional - defaults to <literal>exception</literal>): Specifies how foreign keys that reference missing rows will be handled: <literal>ignore</literal> will treat a missing row as a null association." -msgstr "<literal>lazy</literal> (オプション - デフォルトは <literal>proxy</literal> ): デフォルトでは、多重度１の関連がプロキシとなります。 <literal>lazy=\"no-proxy\"</literal> は、インスタンス変数に最初にアクセスしたときに、プロパティを遅延フェッチするよう指定します (ビルド時にバイトコード実装が必要になります)。 <literal>lazy=\"false\"</literal> は関連を常に即時にフェッチするよう指定します。 <emphasis>もし <literal>constrained=\"false\"</literal> ならば、プロキシは使用不可能となり、関連を即時にフェッチすることに注意してください！</emphasis>" +#. Tag: para +#: basic_mapping.xml:1572 +#, no-c-format +msgid "" +"<literal>not-found</literal> (optional - defaults to <literal>exception</" +"literal>): Specifies how foreign keys that reference missing rows will be " +"handled: <literal>ignore</literal> will treat a missing row as a null " +"association." +msgstr "" +"<literal>not-found</literal> (オプション - デフォルトは <literal>exception</" +"literal> ): 欠落した行を参照する外部キーをどのように扱うかを指定します。 " +"<literal>ignore</literal> は欠落した行をnull関連として扱います。" -#: index.docbook:1579, index.docbook:1733 -msgid "<literal>entity-name</literal> (optional): The entity name of the associated class." -msgstr "<literal>entity-name</literal> (オプション):関連クラスのエンティティ名" +#. Tag: para +#: basic_mapping.xml:1579 basic_mapping.xml:1733 +#, fuzzy, no-c-format +msgid "" +"<literal>entity-name</literal> (optional): The entity name of the associated " +"class." +msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>entity-name</literal> (オプション):関連したクラスのエンティティ" +"名。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>entity-name</literal> (オプション):関連クラスのエンティティ名" -#: index.docbook:1585 -msgid "<literal>formula</literal> (optional): an SQL expression that defines the value for a <emphasis>computed</emphasis> foreign key." -msgstr "一対一関連には2種類あります：" +#. Tag: para +#: basic_mapping.xml:1585 +#, no-c-format +msgid "" +"<literal>formula</literal> (optional): an SQL expression that defines the " +"value for a <emphasis>computed</emphasis> foreign key." +msgstr "" +"<literal>formula</literal> (オプション): <emphasis> 計算された</emphasis> 外" +"部キーに対して値を定義するSQL式" -#: index.docbook:1592 -msgid "Setting a value of the <literal>cascade</literal> attribute to any meaningful value other than <literal>none</literal> will propagate certain operations to the associated object. The meaningful values are the names of Hibernate's basic operations, <literal>persist, merge, delete, save-update, evict, replicate, lock, refresh</literal>, as well as the special values <literal>delete-orphan</literal> and <literal>all</literal> and comma-separated combinations of operation names, for example, <literal>cascade=\"persist,merge,evict\"</literal> or <literal>cascade=\"all,delete-orphan\"</literal>. See <xref linkend=\"objectstate-transitive\"/> for a full explanation. Note that single valued associations (many-to-one and one-to-one associations) do not support orphan delete." -msgstr "主キー関連" +#. Tag: para +#: basic_mapping.xml:1592 +#, no-c-format +msgid "" +"Setting a value of the <literal>cascade</literal> attribute to any " +"meaningful value other than <literal>none</literal> will propagate certain " +"operations to the associated object. The meaningful values are the names of " +"Hibernate's basic operations, <literal>persist, merge, delete, save-update, " +"evict, replicate, lock, refresh</literal>, as well as the special values " +"<literal>delete-orphan</literal> and <literal>all</literal> and comma-" +"separated combinations of operation names, for example, <literal>cascade=" +"\"persist,merge,evict\"</literal> or <literal>cascade=\"all,delete-orphan\"</" +"literal>. See <xref linkend=\"objectstate-transitive\"/> for a full " +"explanation. Note that single valued associations (many-to-one and one-to-" +"one associations) do not support orphan delete." +msgstr "" +"<literal>cascade</literal> 属性に <literal>none</literal> 以外の意味のある値" +"をを設定すると、関連オブジェクトへある操作が伝播することになります。意味の" +"ある値とはHibernateの基本操作の名前のことで、 <literal>delete-orphan</" +"literal> と <literal>all</literal> 、操作名をカンマで区切った組み合わせ（例" +"えば <literal>cascade=\"persist,merge,evict\"</literal> や <literal>cascade=" +"\"all,delete-orphan\"</literal>）、またそれだけでなく <literal>persist, " +"merge, delete, save-update, evict, replicate, lock, refresh</literal> のこと" +"を指します。詳しい説明は <xref linkend=\"objectstate-transitive\"/> を見てく" +"ださい。値が一つの関連(many-to-oneとone-to-one関連)は、単独での削除" +"（orphan delete)をサポートしていないことに注意してください。" -#: index.docbook:1605 -msgid "A typical <literal>many-to-one</literal> declaration looks as simple as this:" -msgstr "ユニーク外部キー関連" +#. Tag: para +#: basic_mapping.xml:1605 +#, no-c-format +msgid "" +"A typical <literal>many-to-one</literal> declaration looks as simple as this:" +msgstr "" +"典型的な <literal>many-to-one</literal> 宣言は次のようにシンプルです。：" -#: index.docbook:1609 -msgid "<![CDATA[<many-to-one name=\"product\" class=\"Product\" column=\"PRODUCT_ID\"/>]]>" -msgstr "主キー関連には、特別なテーブルカラムは必要ありません。もし2つの行が関連により関係していれば、2つのテーブルは同じ主キーの値を共有します。そのため2つのオブジェクトを主キー関連によって関連付けたいのであれば、確実に同じ識別子の値を代入しなければなりません。" +#. Tag: programlisting +#: basic_mapping.xml:1609 +#, no-c-format +msgid "" +"<![CDATA[<many-to-one name=\"product\" class=\"Product\" column=\"PRODUCT_ID" +"\"/>]]>" +msgstr "" -#: index.docbook:1611 -msgid "The <literal>property-ref</literal> attribute should only be used for mapping legacy data where a foreign key refers to a unique key of the associated table other than the primary key. This is an ugly relational model. For example, suppose the <literal>Product</literal> class had a unique serial number, that is not the primary key. (The <literal>unique</literal> attribute controls Hibernate's DDL generation with the SchemaExport tool.)" -msgstr "主キー関連を行うためには、以下のマッピングを <literal>Employee</literal> と <literal>Person</literal> のそれぞれに追加してください。" +#. Tag: para +#: basic_mapping.xml:1611 +#, no-c-format +msgid "" +"The <literal>property-ref</literal> attribute should only be used for " +"mapping legacy data where a foreign key refers to a unique key of the " +"associated table other than the primary key. This is an ugly relational " +"model. For example, suppose the <literal>Product</literal> class had a " +"unique serial number, that is not the primary key. (The <literal>unique</" +"literal> attribute controls Hibernate's DDL generation with the SchemaExport " +"tool.)" +msgstr "" +"<literal>property-ref</literal> 属性は、外部キーが関連付けられたテーブルの、" +"主キーでないユニークキーを参照しているレガシーデータをマップするためにだけ使" +"うべきです。これは醜いリレーショナルモデルです。例えば <literal>Product</" +"literal> クラスが、主キーでないユニークなシリアルナンバーを持っていると仮定" +"してみてください。（ <literal>unique</literal> 属性はSchemaExportツールを" +"使ったHibernateのDDL生成を制御します。）" -#: index.docbook:1620 -msgid "<![CDATA[<property name=\"serialNumber\" unique=\"true\" type=\"string\" column=\"SERIAL_NUMBER\"/>]]>" -msgstr "<![CDATA[<one-to-one name=\"person\" class=\"Person\"/>]]>" +#. Tag: programlisting +#: basic_mapping.xml:1620 +#, no-c-format +msgid "" +"<![CDATA[<property name=\"serialNumber\" unique=\"true\" type=\"string\" " +"column=\"SERIAL_NUMBER\"/>]]>" +msgstr "" -#: index.docbook:1622 +#. Tag: para +#: basic_mapping.xml:1622 +#, no-c-format msgid "Then the mapping for <literal>OrderItem</literal> might use:" -msgstr "<![CDATA[<one-to-one name=\"employee\" class=\"Employee\" constrained=\"true\"/>]]>" +msgstr "" +"以下のように <literal>OrderItem</literal> に対してマッピングを使えます：" -#: index.docbook:1626 -msgid "<![CDATA[<many-to-one name=\"product\" property-ref=\"serialNumber\" column=\"PRODUCT_SERIAL_NUMBER\"/>]]>" -msgstr "ここで、PERSONとEMPLOYEEテーブルの関係する行の主キーが同じであることを確実にしなければいけません。ここでは、<literal>foreign</literal> という特殊なHibernate識別子生成戦略を使います：" +#. Tag: programlisting +#: basic_mapping.xml:1626 +#, no-c-format +msgid "" +"<![CDATA[<many-to-one name=\"product\" property-ref=\"serialNumber\" column=" +"\"PRODUCT_SERIAL_NUMBER\"/>]]>" +msgstr "" -#: index.docbook:1628 +#. Tag: para +#: basic_mapping.xml:1628 +#, no-c-format msgid "This is certainly not encouraged, however." +msgstr "しかし、これは決して推奨できません。" + +#. Tag: para +#: basic_mapping.xml:1632 +#, no-c-format +msgid "" +"If the referenced unique key comprises multiple properties of the associated " +"entity, you should map the referenced properties inside a named <literal><" +"properties></literal> element." msgstr "" - "<![CDATA[<class name=\"person\" table=\"PERSON\"> -\n" - " <id name=\"id\" column=\"PERSON_ID\"> -\n" - " <generator class=\"foreign\"> -\n" - " <param name=\"property\">employee</param> -\n" - " </generator> -\n" - " </id> -\n" - " ... -\n" - " <one-to-one name=\"employee\" -\n" - " class=\"Employee\" -\n" - " constrained=\"true\"/> -\n" - "</class>]]>" +"参照したユニークキーが、関連するエンティティの多数のプロパティから構成される" +"場合、指定した <literal><properties></literal> 要素内で、参照するプロ" +"パティをマッピングするべきです。" -#: index.docbook:1632 -msgid "If the referenced unique key comprises multiple properties of the associated entity, you should map the referenced properties inside a named <literal><properties></literal> element." -msgstr "<literal>Employee</literal> インスタンスが、<literal>Person</literal> の <literal>employee</literal> プロパティで参照されるように、新しくセーブされた <literal>Person</literal> のインスタンスには同じ主キーの値が代入されます。新しくセーブする <literal>Person</literal> インスタンスは、その <literal>Person</literal> の <literal>employee</literal> プロパティが参照する <literal>Employee</literal> インスタンスとして同じ主キーが割り当てられます。" +#. Tag: para +#: basic_mapping.xml:1637 +#, no-c-format +msgid "" +"If the referenced unique key is the property of a component, you may specify " +"a property path:" +msgstr "" +"もし参照したユニークキーがコンポーネントのプロパティである場合は、プロパティ" +"のパスを指定できます。" -#: index.docbook:1637 -msgid "If the referenced unique key is the property of a component, you may specify a property path:" -msgstr "もう1つの方法として、<literal>Employee</literal> から <literal>Person</literal> へのユニーク制約を使った外部キー関連は以下のように表現されます：" +#. Tag: programlisting +#: basic_mapping.xml:1641 +#, no-c-format +msgid "" +"<![CDATA[<many-to-one name=\"owner\" property-ref=\"identity.ssn\" column=" +"\"OWNER_SSN\"/>]]>" +msgstr "" -#: index.docbook:1641 -msgid "<![CDATA[<many-to-one name=\"owner\" property-ref=\"identity.ssn\" column=\"OWNER_SSN\"/>]]>" -msgstr "<![CDATA[<many-to-one name=\"person\" class=\"Person\" column=\"PERSON_ID\" unique=\"true\"/>]]>" - -#: index.docbook:1646 +#. Tag: title +#: basic_mapping.xml:1646 +#, no-c-format msgid "one-to-one" -msgstr "そしてこの関連は、以下の記述を <literal>Person</literal> のマッピングに追加することで双方向にすることができます：" +msgstr "one-to-one" -#: index.docbook:1648 -msgid "A one-to-one association to another persistent class is declared using a <literal>one-to-one</literal> element." -msgstr "<![CDATA[<one-to-one name=\"employee\" class=\"Employee\" property-ref=\"person\"/>]]>" +#. Tag: para +#: basic_mapping.xml:1648 +#, no-c-format +msgid "" +"A one-to-one association to another persistent class is declared using a " +"<literal>one-to-one</literal> element." +msgstr "" +"他の永続クラスへの一対一関連は、<literal>one-to-one</literal> 要素で定義しま" +"す。" -#: index.docbook:1666 +#. Tag: programlisting +#: basic_mapping.xml:1666 +#, no-c-format msgid "" - "<![CDATA[<one-to-one\n" - " name=\"propertyName\"\n" - " class=\"ClassName\"\n" - " cascade=\"cascade_style\"\n" - " constrained=\"true|false\"\n" - " fetch=\"join|select\"\n" - " property-ref=\"propertyNameFromAssociatedClass\"\n" - " access=\"field|property|ClassName\"\n" - " formula=\"any SQL expression\"\n" - " lazy=\"proxy|no-proxy|false\"\n" - " entity-name=\"EntityName\"\n" - " node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" - " embed-xml=\"true|false\"\n" - " foreign-key=\"foreign_key_name\"\n" - "/>]]>" -msgstr "natural-id" +"<![CDATA[<one-to-one\n" +" name=\"propertyName\"\n" +" class=\"ClassName\"\n" +" cascade=\"cascade_style\"\n" +" constrained=\"true|false\"\n" +" fetch=\"join|select\"\n" +" property-ref=\"propertyNameFromAssociatedClass\"\n" +" access=\"field|property|ClassName\"\n" +" formula=\"any SQL expression\"\n" +" lazy=\"proxy|no-proxy|false\"\n" +" entity-name=\"EntityName\"\n" +" node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" +" embed-xml=\"true|false\"\n" +" foreign-key=\"foreign_key_name\"\n" +"/>]]>" +msgstr "" -#: index.docbook:1680 -msgid "<literal>cascade</literal> (optional) specifies which operations should be cascaded from the parent object to the associated object." -msgstr "エンティティの自然キープロパティの比較には、 <literal>equals()</literal> と <literal>hashCode()</literal> の実装を強くお勧めします。" +#. Tag: para +#: basic_mapping.xml:1680 +#, no-c-format +msgid "" +"<literal>cascade</literal> (optional) specifies which operations should be " +"cascaded from the parent object to the associated object." +msgstr "" +"<literal>cascade</literal>（オプション）：親オブジェクトから関連オブジェクト" +"へ、どの操作をカスケードするかを指定します。" -#: index.docbook:1686 -msgid "<literal>constrained</literal> (optional) specifies that a foreign key constraint on the primary key of the mapped table references the table of the associated class. This option affects the order in which <literal>save()</literal> and <literal>delete()</literal> are cascaded, and determines whether the association may be proxied (it is also used by the schema export tool)." -msgstr "このマッピングは自然主キーを使ったエンティティでの使用を意図していません。" +#. Tag: para +#: basic_mapping.xml:1686 +#, no-c-format +msgid "" +"<literal>constrained</literal> (optional) specifies that a foreign key " +"constraint on the primary key of the mapped table references the table of " +"the associated class. This option affects the order in which <literal>save()" +"</literal> and <literal>delete()</literal> are cascaded, and determines " +"whether the association may be proxied (it is also used by the schema export " +"tool)." +msgstr "" +"<literal>constrained</literal>（オプション）：マッピングされたテーブルの主" +"キーに対する外部キー制約が、関連クラスのテーブルを参照することを指定しま" +"す。このオプションは <literal>save()</literal> と <literal>delete()</" +"literal> がカスケードされる順序に影響し、そして関連がプロキシされるかどうか" +"にも影響します（そしてスキーマエクスポートツールにも使われます）。" -#: index.docbook:1701 -msgid "<literal>property-ref</literal>: (optional) The name of a property of the associated class that is joined to the primary key of this class. If not specified, the primary key of the associated class is used." -msgstr "component, dynamic-component" +#. Tag: para +#: basic_mapping.xml:1701 +#, no-c-format +msgid "" +"<literal>property-ref</literal>: (optional) The name of a property of the " +"associated class that is joined to the primary key of this class. If not " +"specified, the primary key of the associated class is used." +msgstr "" +"<literal>property-ref</literal>（オプション）：このクラスの主キーに結合され" +"た関連クラスのプロパティ名。指定されなければ、関連クラスの主キーが使われま" +"す。" -#: index.docbook:1714 -msgid "<literal>formula</literal> (optional): Almost all one to one associations map to the primary key of the owning entity. In the rare case that this is not the case, you may specify a some other column, columns or expression to join on using an SQL formula. (See <literal>org.hibernate.test.onetooneformula</literal> for an example.)" +#. Tag: para +#: basic_mapping.xml:1714 +#, no-c-format +msgid "" +"<literal>formula</literal> (optional): Almost all one to one associations " +"map to the primary key of the owning entity. In the rare case that this is " +"not the case, you may specify a some other column, columns or expression to " +"join on using an SQL formula. (See <literal>org.hibernate.test." +"onetooneformula</literal> for an example.)" msgstr "" - "<![CDATA[<component -\n" - " name=\"propertyName\" -\n" - " class=\"className\" -\n" - " insert=\"true|false\" -\n" - " update=\"true|false\" -\n" - " access=\"field|property|ClassName\" -\n" - " lazy=\"true|false\" -\n" - " optimistic-lock=\"true|false\" -\n" - " unique=\"true|false\" -\n" - " node=\"element-name|.\" -\n" - "> -\n" - " -\n" - " <property ...../> -\n" - " <many-to-one .... /> -\n" - " ........ -\n" - "</component>]]>" +"<literal>formula</literal> (オプション): ほとんどすべての一対一関連はオーナー" +"のエンティティの主キーへとマッピングされます。これ以外の稀な場合は、他のカ" +"ラムや、複数のカラム、SQL構文を使った結合するための式を指定できます。（例は " +"<literal>org.hibernate.test.onetooneformula</literal> を参照してください。）" -#: index.docbook:1722 -msgid "<literal>lazy</literal> (optional - defaults to <literal>proxy</literal>): By default, single point associations are proxied. <literal>lazy=\"no-proxy\"</literal> specifies that the property should be fetched lazily when the instance variable is first accessed (requires build-time bytecode instrumentation). <literal>lazy=\"false\"</literal> specifies that the association will always be eagerly fetched. <emphasis>Note that if <literal>constrained=\"false\"</literal>, proxying is impossible and Hibernate will eager fetch the association!</emphasis>" -msgstr "<literal>name</literal>：プロパティ名。" +#. Tag: para +#: basic_mapping.xml:1722 +#, no-c-format +msgid "" +"<literal>lazy</literal> (optional - defaults to <literal>proxy</literal>): " +"By default, single point associations are proxied. <literal>lazy=\"no-proxy" +"\"</literal> specifies that the property should be fetched lazily when the " +"instance variable is first accessed (requires build-time bytecode " +"instrumentation). <literal>lazy=\"false\"</literal> specifies that the " +"association will always be eagerly fetched. <emphasis>Note that if " +"<literal>constrained=\"false\"</literal>, proxying is impossible and " +"Hibernate will eager fetch the association!</emphasis>" +msgstr "" +"<literal>lazy</literal> (オプション - デフォルトは <literal>proxy</" +"literal> ): デフォルトでは、多重度１の関連がプロキシとなります。 " +"<literal>lazy=\"no-proxy\"</literal> は、インスタンス変数に最初にアクセスした" +"ときに、プロパティを遅延フェッチするよう指定します (ビルド時にバイトコード実" +"装が必要になります)。 <literal>lazy=\"false\"</literal> は関連を常に即時に" +"フェッチするよう指定します。 <emphasis>もし <literal>constrained=\"false\"</" +"literal> ならば、プロキシは使用不可能となり、関連を即時にフェッチすることに" +"注意してください！</emphasis>" -#: index.docbook:1740 +#. Tag: para +#: basic_mapping.xml:1740 +#, no-c-format msgid "There are two varieties of one-to-one association:" -msgstr "<literal>insert</literal> ：マッピングされたカラムがSQLの <literal>INSERT</literal> に現れるようにするどうかを指定します。" +msgstr "一対一関連には2種類あります：" -#: index.docbook:1744 +#. Tag: para +#: basic_mapping.xml:1744 +#, no-c-format msgid "primary key associations" -msgstr "<literal>update</literal> : マッピングされたカラムがSQL の <literal>UPDATE</literal> に現れるようにするかどうかを指定します。" +msgstr "主キー関連" -#: index.docbook:1747 +#. Tag: para +#: basic_mapping.xml:1747 +#, no-c-format msgid "unique foreign key associations" -msgstr "<literal>access</literal> （オプション - デフォルトは <literal>property</literal> ）：プロパティの値へのアクセスにHibernateが使う戦略。" +msgstr "ユニーク外部キー関連" -#: index.docbook:1752 -msgid "Primary key associations don't need an extra table column; if two rows are related by the association then the two table rows share the same primary key value. So if you want two objects to be related by a primary key association, you must make sure that they are assigned the same identifier value!" -msgstr "<literal>lazy</literal> (optional - デフォルトは <literal>false</literal> ): インスタンス変数に最初にアクセスしたときに、コンポーネントを遅延してフェッチするよう指定します。 (バイトコード実装を作成する時間が必要になります)" +#. Tag: para +#: basic_mapping.xml:1752 +#, no-c-format +msgid "" +"Primary key associations don't need an extra table column; if two rows are " +"related by the association then the two table rows share the same primary " +"key value. So if you want two objects to be related by a primary key " +"association, you must make sure that they are assigned the same identifier " +"value!" +msgstr "" +"主キー関連には、特別なテーブルカラムは必要ありません。もし2つの行が関連によ" +"り関係していれば、2つのテーブルは同じ主キーの値を共有します。そのため2つのオ" +"ブジェクトを主キー関連によって関連付けたいのであれば、確実に同じ識別子の値を" +"代入しなければなりません。" -#: index.docbook:1759 -msgid "For a primary key association, add the following mappings to <literal>Employee</literal> and <literal>Person</literal>, respectively." -msgstr "<literal>optimistic-lock</literal> (オプション - デフォルトは <literal>true</literal> ): このプロパティの更新に、楽観ロックの取得を要求するかどうかを指定します。言い換えれば、このプロパティがダーティであるときにバージョンを増やすべきかを決定します。" +#. Tag: para +#: basic_mapping.xml:1759 +#, no-c-format +msgid "" +"For a primary key association, add the following mappings to " +"<literal>Employee</literal> and <literal>Person</literal>, respectively." +msgstr "" +"主キー関連を行うためには、以下のマッピングを <literal>Employee</literal> と " +"<literal>Person</literal> のそれぞれに追加してください。" -#: index.docbook:1764 +#. Tag: programlisting +#: basic_mapping.xml:1764 +#, no-c-format msgid "<![CDATA[<one-to-one name=\"person\" class=\"Person\"/>]]>" -msgstr "<literal>unique</literal> (オプション - デフォルトは <literal>false</literal> ): コンポーネントのすべてのマッピングするカラムに、ユニーク制約が存在するかを指定します。" +msgstr "" -#: index.docbook:1765 -msgid "<![CDATA[<one-to-one name=\"employee\" class=\"Employee\" constrained=\"true\"/>]]>" -msgstr "子の <literal><property></literal> タグで、子のクラスのプロパティをテーブルカラムにマッピングします。" +#. Tag: programlisting +#: basic_mapping.xml:1765 +#, no-c-format +msgid "" +"<![CDATA[<one-to-one name=\"employee\" class=\"Employee\" constrained=\"true" +"\"/>]]>" +msgstr "" -#: index.docbook:1767 -msgid "Now we must ensure that the primary keys of related rows in the PERSON and EMPLOYEE tables are equal. We use a special Hibernate identifier generation strategy called <literal>foreign</literal>:" -msgstr "<literal><component></literal> 要素は、親エンティティへ戻る参照として、コンポーネントのクラスのプロパティをマッピングする <literal><parent></literal> サブ要素を許可します。" +#. Tag: para +#: basic_mapping.xml:1767 +#, no-c-format +msgid "" +"Now we must ensure that the primary keys of related rows in the PERSON and " +"EMPLOYEE tables are equal. We use a special Hibernate identifier generation " +"strategy called <literal>foreign</literal>:" +msgstr "" +"ここで、PERSONとEMPLOYEEテーブルの関係する行の主キーが同じであることを確実に" +"しなければいけません。ここでは、<literal>foreign</literal> という特殊な" +"Hibernate識別子生成戦略を使います：" -#: index.docbook:1773 +#. Tag: programlisting +#: basic_mapping.xml:1773 +#, no-c-format msgid "" - "<![CDATA[<class name=\"person\" table=\"PERSON\">\n" - " <id name=\"id\" column=\"PERSON_ID\">\n" - " <generator class=\"foreign\">\n" - " <param name=\"property\">employee</param>\n" - " </generator>\n" - " </id>\n" - " ...\n" - " <one-to-one name=\"employee\"\n" - " class=\"Employee\"\n" - " constrained=\"true\"/>\n" - "</class>]]>" -msgstr "<literal><dynamic-component></literal> 要素は、 <literal>Map</literal> がコンポーネントとしてマッピングされることを可能にします。プロパティ名はmapのキーを参照します。<xref linkend=\"components-dynamic\"/> を参照してください。" +"<![CDATA[<class name=\"person\" table=\"PERSON\">\n" +" <id name=\"id\" column=\"PERSON_ID\">\n" +" <generator class=\"foreign\">\n" +" <param name=\"property\">employee</param>\n" +" </generator>\n" +" </id>\n" +" ...\n" +" <one-to-one name=\"employee\"\n" +" class=\"Employee\"\n" +" constrained=\"true\"/>\n" +"</class>]]>" +msgstr "" -#: index.docbook:1775 -msgid "A newly saved instance of <literal>Person</literal> is then assigned the same primary key value as the <literal>Employee</literal> instance refered with the <literal>employee</literal> property of that <literal>Person</literal>." -msgstr "properties" +#. Tag: para +#: basic_mapping.xml:1775 +#, no-c-format +msgid "" +"A newly saved instance of <literal>Person</literal> is then assigned the " +"same primary key value as the <literal>Employee</literal> instance refered " +"with the <literal>employee</literal> property of that <literal>Person</" +"literal>." +msgstr "" +"<literal>Employee</literal> インスタンスが、<literal>Person</literal> の " +"<literal>employee</literal> プロパティで参照されるように、新しくセーブされ" +"た <literal>Person</literal> のインスタンスには同じ主キーの値が代入されま" +"す。新しくセーブする <literal>Person</literal> インスタンスは、その " +"<literal>Person</literal> の <literal>employee</literal> プロパティが参照す" +"る <literal>Employee</literal> インスタンスとして同じ主キーが割り当てられま" +"す。" -#: index.docbook:1781 -msgid "Alternatively, a foreign key with a unique constraint, from <literal>Employee</literal> to <literal>Person</literal>, may be expressed as:" -msgstr "<literal><properties></literal> 要素はクラスのプロパティの指定された、論理的なグルーピングを可能にします。この構造の最も重要な使用方法は、 <literal>property-ref</literal> のターゲットになるプロパティの結合を許可することです。それはまた、複数カラムのユニーク制約を定義する簡単な方法でもあります。" +#. Tag: para +#: basic_mapping.xml:1781 +#, no-c-format +msgid "" +"Alternatively, a foreign key with a unique constraint, from " +"<literal>Employee</literal> to <literal>Person</literal>, may be expressed " +"as:" +msgstr "" +"もう1つの方法として、<literal>Employee</literal> から <literal>Person</" +"literal> へのユニーク制約を使った外部キー関連は以下のように表現されます：" -#: index.docbook:1786 -msgid "<![CDATA[<many-to-one name=\"person\" class=\"Person\" column=\"PERSON_ID\" unique=\"true\"/>]]>" +#. Tag: programlisting +#: basic_mapping.xml:1786 +#, no-c-format +msgid "" +"<![CDATA[<many-to-one name=\"person\" class=\"Person\" column=\"PERSON_ID\" " +"unique=\"true\"/>]]>" msgstr "" - "<![CDATA[<properties -\n" - " name=\"logicalName\" -\n" - " insert=\"true|false\" -\n" - " update=\"true|false\" -\n" - " optimistic-lock=\"true|false\" -\n" - " unique=\"true|false\" -\n" - "> -\n" - " -\n" - " <property ...../> -\n" - " <many-to-one .... /> -\n" - " ........ -\n" - "</properties>]]>" -#: index.docbook:1788 -msgid "And this association may be made bidirectional by adding the following to the <literal>Person</literal> mapping:" -msgstr "<literal>name</literal> : グルーピングの論理名。実際のプロパティ名では <emphasis>ありません</emphasis> 。" +#. Tag: para +#: basic_mapping.xml:1788 +#, no-c-format +msgid "" +"And this association may be made bidirectional by adding the following to " +"the <literal>Person</literal> mapping:" +msgstr "" +"そしてこの関連は、以下の記述を <literal>Person</literal> のマッピングに追加" +"することで双方向にすることができます：" -#: index.docbook:1793 -msgid "<![CDATA[<one-to-one name=\"employee\" class=\"Employee\" property-ref=\"person\"/>]]>" -msgstr "<literal>insert</literal>：マッピングされたカラムがSQLの <literal>INSERT</literal> に現れるようにするかどうかを指定します。" +#. Tag: programlisting +#: basic_mapping.xml:1793 +#, no-c-format +msgid "" +"<![CDATA[<one-to-one name=\"employee\" class=\"Employee\" property-ref=" +"\"person\"/>]]>" +msgstr "" -#: index.docbook:1798 +#. Tag: title +#: basic_mapping.xml:1798 +#, no-c-format msgid "natural-id" -msgstr "<literal>update</literal>：マッピングされたカラムがSQLの <literal>UPDATE</literal> に現れるようにするかどうかを指定します。" +msgstr "natural-id" -#: index.docbook:1800 +#. Tag: programlisting +#: basic_mapping.xml:1800 +#, no-c-format msgid "" - "<![CDATA[<natural-id mutable=\"true|false\"/>\n" - " <property ... />\n" - " <many-to-one ... />\n" - " ......\n" - "</natural-id>]]>" -msgstr "<literal>optimistic-lock</literal> (オプション - デフォルトは <literal>true</literal> ): これらのプロパティの更新に楽観的ロックの取得を要求するかどうかを指定します。言い換えれば、このプロパティがダーティであるときにバージョンを増やすべきかを決定します。" +"<![CDATA[<natural-id mutable=\"true|false\"/>\n" +" <property ... />\n" +" <many-to-one ... />\n" +" ......\n" +"</natural-id>]]>" +msgstr "" -#: index.docbook:1802 -msgid "Even though we recommend the use of surrogate keys as primary keys, you should still try to identify natural keys for all entities. A natural key is a property or combination of properties that is unique and non-null. If it is also immutable, even better. Map the properties of the natural key inside the <literal><natural-id></literal> element. Hibernate will generate the necessary unique key and nullability constraints, and your mapping will be more self-documenting." -msgstr "<literal>unique</literal> (オプション - デフォルトは <literal>false</literal> ): コンポーネントのすべてのマッピングするカラムに、ユニーク制約が存在するかを指定します。" +#. Tag: para +#: basic_mapping.xml:1802 +#, no-c-format +msgid "" +"Even though we recommend the use of surrogate keys as primary keys, you " +"should still try to identify natural keys for all entities. A natural key is " +"a property or combination of properties that is unique and non-null. If it " +"is also immutable, even better. Map the properties of the natural key inside " +"the <literal><natural-id></literal> element. Hibernate will generate " +"the necessary unique key and nullability constraints, and your mapping will " +"be more self-documenting." +msgstr "" +"主キーとして代理キーの使用を推奨しますが、すべてのエンティティに対して自然" +"キーを識別するようにすべきです。自然キーはユニークかつ非nullな一つのプロパ" +"ティ、またはプロパティの連結です。不変であればさらに良いです。 <literal><" +"natural-id></literal> 要素内で自然キーのプロパティをマッピングします。 " +"Hibernateは必然的にユニークかつnull値を許可する制約を生成し、こうしてマッピ" +"ングはより自己記述的になります。" -#: index.docbook:1811 -msgid "We strongly recommend that you implement <literal>equals()</literal> and <literal>hashCode()</literal> to compare the natural key properties of the entity." -msgstr "例えば、もし以下のような <literal><properties></literal> マッピングがあった場合：" +#. Tag: para +#: basic_mapping.xml:1811 +#, no-c-format +msgid "" +"We strongly recommend that you implement <literal>equals()</literal> and " +"<literal>hashCode()</literal> to compare the natural key properties of the " +"entity." +msgstr "" +"エンティティの自然キープロパティの比較には、 <literal>equals()</literal> と " +"<literal>hashCode()</literal> の実装を強くお勧めします。" -#: index.docbook:1816 -msgid "This mapping is not intended for use with entities with natural primary keys." +#. Tag: para +#: basic_mapping.xml:1816 +#, no-c-format +msgid "" +"This mapping is not intended for use with entities with natural primary keys." msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"personNumber\"/> -\n" - " ... -\n" - " <properties name=\"name\" -\n" - " unique=\"true\" update=\"false\"> -\n" - " <property name=\"firstName\"/> -\n" - " <property name=\"initial\"/> -\n" - " <property name=\"lastName\"/> -\n" - " </properties> -\n" - "</class>]]>" +"このマッピングは自然主キーを使ったエンティティでの使用を意図していません。" -#: index.docbook:1822 -msgid "<literal>mutable</literal> (optional, defaults to <literal>false</literal>): By default, natural identifier properties as assumed to be immutable (constant)." -msgstr "主キーの代わりに <literal>Person</literal> テーブルのユニークキーへの参照を持つ、レガシーデータの関連を持つかもしれません。：" +#. Tag: para +#: basic_mapping.xml:1822 +#, no-c-format +msgid "" +"<literal>mutable</literal> (optional, defaults to <literal>false</literal>): " +"By default, natural identifier properties as assumed to be immutable " +"(constant)." +msgstr "" +"<literal>mutable</literal> (オプション, デフォルトは <literal>false</" +"literal> ): デフォルトでは、自然識別子プロパティは不変(定数)と想定されていま" +"す。" -#: index.docbook:1832 +#. Tag: title +#: basic_mapping.xml:1832 +#, no-c-format msgid "component, dynamic-component" +msgstr "component, dynamic-component" + +#. Tag: para +#: basic_mapping.xml:1834 +#, no-c-format +msgid "" +"The <literal><component></literal> element maps properties of a child " +"object to columns of the table of a parent class. Components may, in turn, " +"declare their own properties, components or collections. See \"Components\" " +"below." msgstr "" - "<![CDATA[<many-to-one name=\"person\" -\n" - " class=\"Person\" property-ref=\"name\"> -\n" - " <column name=\"firstName\"/> -\n" - " <column name=\"initial\"/> -\n" - " <column name=\"lastName\"/> -\n" - "</many-to-one>]]>" +"<literal><component></literal> 要素は、子オブジェクトのプロパティを親" +"クラスのテーブルのカラムへマッピングします。コンポーネントは自分のプロパ" +"ティ、コンポーネント、コレクションの順に定義できます。以下の「コンポーネン" +"ト」を見てください。" -#: index.docbook:1834 -msgid "The <literal><component></literal> element maps properties of a child object to columns of the table of a parent class. Components may, in turn, declare their own properties, components or collections. See \"Components\" below." -msgstr "しかし、このようなレガシーデータマッピングのコンテキスト外への使用は推奨しません。" +#. Tag: programlisting +#: basic_mapping.xml:1852 +#, no-c-format +msgid "" +"<![CDATA[<component\n" +" name=\"propertyName\"\n" +" class=\"className\"\n" +" insert=\"true|false\"\n" +" update=\"true|false\"\n" +" access=\"field|property|ClassName\"\n" +" lazy=\"true|false\"\n" +" optimistic-lock=\"true|false\"\n" +" unique=\"true|false\"\n" +" node=\"element-name|.\"\n" +">\n" +"\n" +" <property ...../>\n" +" <many-to-one .... />\n" +" ........\n" +"</component>]]>" +msgstr "" -#: index.docbook:1852 +#. Tag: para +#: basic_mapping.xml:1860 +#, no-c-format msgid "" - "<![CDATA[<component\n" - " name=\"propertyName\"\n" - " class=\"className\"\n" - " insert=\"true|false\"\n" - " update=\"true|false\"\n" - " access=\"field|property|ClassName\"\n" - " lazy=\"true|false\"\n" - " optimistic-lock=\"true|false\"\n" - " unique=\"true|false\"\n" - " node=\"element-name|.\"\n" - ">\n" - "\n" - " <property ...../>\n" - " <many-to-one .... />\n" - " ........\n" - "</component>]]>" -msgstr "subclass" +"<literal>class</literal> (optional - defaults to the property type " +"determined by reflection): The name of the component (child) class." +msgstr "" +"<literal>class</literal> （オプション - デフォルトはリフレクションにより決定" +"されるプロパティの型）：コンポーネント（子）クラスの名前。" -#: index.docbook:1860 -msgid "<literal>class</literal> (optional - defaults to the property type determined by reflection): The name of the component (child) class." +#. Tag: para +#: basic_mapping.xml:1866 basic_mapping.xml:1955 +#, fuzzy, no-c-format +msgid "" +"<literal>insert</literal>: Do the mapped columns appear in SQL " +"<literal>INSERT</literal>s?" msgstr "" - "<![CDATA[<subclass -\n" - " name=\"ClassName\" -\n" - " discriminator-value=\"discriminator_value\" -\n" - " proxy=\"ProxyInterface\" -\n" - " lazy=\"true|false\" -\n" - " dynamic-update=\"true|false\" -\n" - " dynamic-insert=\"true|false\" -\n" - " entity-name=\"EntityName\" -\n" - " node=\"element-name\" -\n" - " extends=\"SuperclassName\"> -\n" - " -\n" - " <property .... /> -\n" - " ..... -\n" - "</subclass>]]>" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>insert</literal> ：マッピングされたカラムがSQLの <literal>INSERT</" +"literal> に現れるようにするどうかを指定します。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>insert</literal>：マッピングされたカラムがSQLの <literal>INSERT</" +"literal> に現れるようにするかどうかを指定します。" -#: index.docbook:1866, index.docbook:1955 -msgid "<literal>insert</literal>: Do the mapped columns appear in SQL <literal>INSERT</literal>s?" -msgstr "<literal>name</literal>：サブクラスの完全修飾されたクラス名。" +#. Tag: para +#: basic_mapping.xml:1872 basic_mapping.xml:1961 +#, fuzzy, no-c-format +msgid "" +"<literal>update</literal>: Do the mapped columns appear in SQL " +"<literal>UPDATE</literal>s?" +msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>update</literal> : マッピングされたカラムがSQL の <literal>UPDATE</" +"literal> に現れるようにするかどうかを指定します。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>update</literal>：マッピングされたカラムがSQLの <literal>UPDATE</" +"literal> に現れるようにするかどうかを指定します。" -#: index.docbook:1872, index.docbook:1961 -msgid "<literal>update</literal>: Do the mapped columns appear in SQL <literal>UPDATE</literal>s?" -msgstr "<literal>discriminator-value</literal>（オプション - デフォルトはクラス名）：個々のサブクラスを区別するための値。" +#. Tag: para +#: basic_mapping.xml:1884 +#, no-c-format +msgid "" +"<literal>lazy</literal> (optional - defaults to <literal>false</literal>): " +"Specifies that this component should be fetched lazily when the instance " +"variable is first accessed (requires build-time bytecode instrumentation)." +msgstr "" +"<literal>lazy</literal> (optional - デフォルトは <literal>false</literal> ): " +"インスタンス変数に最初にアクセスしたときに、コンポーネントを遅延してフェッチ" +"するよう指定します。 (バイトコード実装を作成する時間が必要になります)" -#: index.docbook:1884 -msgid "<literal>lazy</literal> (optional - defaults to <literal>false</literal>): Specifies that this component should be fetched lazily when the instance variable is first accessed (requires build-time bytecode instrumentation)." -msgstr "<literal>lazy</literal>（オプション, デフォルトは <literal>true</literal> ）： <literal>lazy=\"false\"</literal> と設定すると、遅延フェッチが使用できません。" +#. Tag: para +#: basic_mapping.xml:1891 +#, no-c-format +msgid "" +"<literal>optimistic-lock</literal> (optional - defaults to <literal>true</" +"literal>): Specifies that updates to this component do or do not require " +"acquisition of the optimistic lock. In other words, determines if a version " +"increment should occur when this property is dirty." +msgstr "" +"<literal>optimistic-lock</literal> (オプション - デフォルトは <literal>true</" +"literal> ): このプロパティの更新に、楽観ロックの取得を要求するかどうかを指定" +"します。言い換えれば、このプロパティがダーティであるときにバージョンを増やす" +"べきかを決定します。" -#: index.docbook:1891 -msgid "<literal>optimistic-lock</literal> (optional - defaults to <literal>true</literal>): Specifies that updates to this component do or do not require acquisition of the optimistic lock. In other words, determines if a version increment should occur when this property is dirty." -msgstr "各サブクラスでは、永続プロパティとサブクラスを定義します。 <literal><version></literal> と <literal><id></literal> プロパティは、ルートクラスから継承されると仮定されます。階層構造におけるサブクラスは、ユニークな <literal>discriminator-value</literal> を定義しなければなりません。 noneが指定されると、完全修飾されたJavaクラス名が使われます。" +#. Tag: para +#: basic_mapping.xml:1899 basic_mapping.xml:1975 +#, no-c-format +msgid "" +"<literal>unique</literal> (optional - defaults to <literal>false</literal>): " +"Specifies that a unique constraint exists upon all mapped columns of the " +"component." +msgstr "" +"<literal>unique</literal> (オプション - デフォルトは <literal>false</" +"literal> ): コンポーネントのすべてのマッピングするカラムに、ユニーク制約が存" +"在するかを指定します。" -#: index.docbook:1899, index.docbook:1975 -msgid "<literal>unique</literal> (optional - defaults to <literal>false</literal>): Specifies that a unique constraint exists upon all mapped columns of the component." -msgstr "継承のマッピングに関する情報は <xref linkend=\"inheritance\"/> を見てください。" +#. Tag: para +#: basic_mapping.xml:1908 +#, no-c-format +msgid "" +"The child <literal><property></literal> tags map properties of the " +"child class to table columns." +msgstr "" +"子の <literal><property></literal> タグで、子のクラスのプロパティを" +"テーブルカラムにマッピングします。" -#: index.docbook:1908 -msgid "The child <literal><property></literal> tags map properties of the child class to table columns." -msgstr "joined-subclass" +#. Tag: para +#: basic_mapping.xml:1913 +#, no-c-format +msgid "" +"The <literal><component></literal> element allows a <literal><" +"parent></literal> subelement that maps a property of the component class " +"as a reference back to the containing entity." +msgstr "" +"<literal><component></literal> 要素は、親エンティティへ戻る参照とし" +"て、コンポーネントのクラスのプロパティをマッピングする <literal><" +"parent></literal> サブ要素を許可します。" -#: index.docbook:1913 -msgid "The <literal><component></literal> element allows a <literal><parent></literal> subelement that maps a property of the component class as a reference back to the containing entity." -msgstr "もう1つの方法として、各サブクラスを自身のテーブルへマッピングすることができます (table-per-subclass mapping strategy)。継承した状態はスーパークラスのテーブルを使った結合で検索します。 <literal><joined-subclass></literal> 要素を使用します。" - -#: index.docbook:1919 -msgid "The <literal><dynamic-component></literal> element allows a <literal>Map</literal> to be mapped as a component, where the property names refer to keys of the map, see <xref linkend=\"components-dynamic\"/>." +#. Tag: para +#: basic_mapping.xml:1919 +#, no-c-format +msgid "" +"The <literal><dynamic-component></literal> element allows a " +"<literal>Map</literal> to be mapped as a component, where the property names " +"refer to keys of the map, see <xref linkend=\"components-dynamic\"/>." msgstr "" - "<![CDATA[<joined-subclass -\n" - " name=\"ClassName\" -\n" - " table=\"tablename\" -\n" - " proxy=\"ProxyInterface\" -\n" - " lazy=\"true|false\" -\n" - " dynamic-update=\"true|false\" -\n" - " dynamic-insert=\"true|false\" -\n" - " schema=\"schema\" -\n" - " catalog=\"catalog\" -\n" - " extends=\"SuperclassName\" -\n" - " persister=\"ClassName\" -\n" - " subselect=\"SQL expression\" -\n" - " entity-name=\"EntityName\" -\n" - " node=\"element-name\"> -\n" - " -\n" - " <key .... > -\n" - " -\n" - " <property .... /> -\n" - " ..... -\n" - "</joined-subclass>]]>" +"<literal><dynamic-component></literal> 要素は、 <literal>Map</literal> " +"がコンポーネントとしてマッピングされることを可能にします。プロパティ名はmap" +"のキーを参照します。<xref linkend=\"components-dynamic\"/> を参照してくださ" +"い。" -#: index.docbook:1928 +#. Tag: title +#: basic_mapping.xml:1928 +#, no-c-format msgid "properties" -msgstr "<literal>name</literal>：サブクラスの完全修飾されたクラス名。" +msgstr "properties" -#: index.docbook:1930 -msgid "The <literal><properties></literal> element allows the definition of a named, logical grouping of properties of a class. The most important use of the construct is that it allows a combination of properties to be the target of a <literal>property-ref</literal>. It is also a convenient way to define a multi-column unique constraint." -msgstr "<literal>table</literal> :サブクラステーブルの名前。" +#. Tag: para +#: basic_mapping.xml:1930 +#, no-c-format +msgid "" +"The <literal><properties></literal> element allows the definition of a " +"named, logical grouping of properties of a class. The most important use of " +"the construct is that it allows a combination of properties to be the target " +"of a <literal>property-ref</literal>. It is also a convenient way to define " +"a multi-column unique constraint." +msgstr "" +"<literal><properties></literal> 要素はクラスのプロパティの指定された、 " +"論理的なグルーピングを可能にします。この構造の最も重要な使用方法は、 " +"<literal>property-ref</literal> のターゲットになるプロパティの結合を許可する" +"ことです。それはまた、複数カラムのユニーク制約を定義する簡単な方法でもありま" +"す。" -#: index.docbook:1946 +#. Tag: programlisting +#: basic_mapping.xml:1946 +#, no-c-format msgid "" - "<![CDATA[<properties\n" - " name=\"logicalName\"\n" - " insert=\"true|false\"\n" - " update=\"true|false\"\n" - " optimistic-lock=\"true|false\"\n" - " unique=\"true|false\"\n" - ">\n" - "\n" - " <property ...../>\n" - " <many-to-one .... />\n" - " ........\n" - "</properties>]]>" -msgstr "<literal>proxy</literal> (オプション): 遅延初期化プロキシに使用するクラスやインターフェイスを指定します。" +"<![CDATA[<properties\n" +" name=\"logicalName\"\n" +" insert=\"true|false\"\n" +" update=\"true|false\"\n" +" optimistic-lock=\"true|false\"\n" +" unique=\"true|false\"\n" +">\n" +"\n" +" <property ...../>\n" +" <many-to-one .... />\n" +" ........\n" +"</properties>]]>" +msgstr "" -#: index.docbook:1949 -msgid "<literal>name</literal>: The logical name of the grouping - <emphasis>not</emphasis> an actual property name." -msgstr "<literal>lazy</literal> (オプション, デフォルトは <literal>true</literal> ): <literal>lazy=\"false\"</literal> とすると、遅延フェッチが使用できません。" +#. Tag: para +#: basic_mapping.xml:1949 +#, no-c-format +msgid "" +"<literal>name</literal>: The logical name of the grouping - <emphasis>not</" +"emphasis> an actual property name." +msgstr "" +"<literal>name</literal> : グルーピングの論理名。実際のプロパティ名では " +"<emphasis>ありません</emphasis> 。" -#: index.docbook:1967 -msgid "<literal>optimistic-lock</literal> (optional - defaults to <literal>true</literal>): Specifies that updates to these properties do or do not require acquisition of the optimistic lock. In other words, determines if a version increment should occur when these properties are dirty." -msgstr "継承のマッピングに関する情報は <xref linkend=\"inheritance\"/> を見てください。" +#. Tag: para +#: basic_mapping.xml:1967 +#, no-c-format +msgid "" +"<literal>optimistic-lock</literal> (optional - defaults to <literal>true</" +"literal>): Specifies that updates to these properties do or do not require " +"acquisition of the optimistic lock. In other words, determines if a version " +"increment should occur when these properties are dirty." +msgstr "" +"<literal>optimistic-lock</literal> (オプション - デフォルトは <literal>true</" +"literal> ): これらのプロパティの更新に楽観的ロックの取得を要求するかどうかを" +"指定します。言い換えれば、このプロパティがダーティであるときにバージョンを増" +"やすべきかを決定します。" -#: index.docbook:1984 -msgid "For example, if we have the following <literal><properties></literal> mapping:" -msgstr "3つ目の選択肢は、継承階層の具象クラスのみをテーブルにマッピングすることです (the table-per-concrete-class戦略)。それぞれのテーブルは継承の状態を含めすべてのクラスの永続状態を定義します。 Hibernateではその様な継承階層が必ずしも必要ではありません。単純にそれぞれのクラスを、別々の <literal><class></literal> 宣言を使ってマッピングすることができます。しかしポリモーフィックな関連(例えば階層のスーパークラスへの関連)を使いたいなら、 <literal><union-subclass></literal> マッピングを使う必要があります。" +#. Tag: para +#: basic_mapping.xml:1984 +#, no-c-format +msgid "" +"For example, if we have the following <literal><properties></literal> " +"mapping:" +msgstr "" +"例えば、もし以下のような <literal><properties></literal> マッピングが" +"あった場合：" -#: index.docbook:1988 +#. Tag: programlisting +#: basic_mapping.xml:1988 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"personNumber\"/>\n" - " ...\n" - " <properties name=\"name\"\n" - " unique=\"true\" update=\"false\">\n" - " <property name=\"firstName\"/>\n" - " <property name=\"initial\"/>\n" - " <property name=\"lastName\"/>\n" - " </properties>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"personNumber\"/>\n" +" ...\n" +" <properties name=\"name\"\n" +" unique=\"true\" update=\"false\">\n" +" <property name=\"firstName\"/>\n" +" <property name=\"initial\"/>\n" +" <property name=\"lastName\"/>\n" +" </properties>\n" +"</class>]]>" msgstr "" - "<![CDATA[<union-subclass -\n" - " name=\"ClassName\" -\n" - " table=\"tablename\" -\n" - " proxy=\"ProxyInterface\" -\n" - " lazy=\"true|false\" -\n" - " dynamic-update=\"true|false\" -\n" - " dynamic-insert=\"true|false\" -\n" - " schema=\"schema\" -\n" - " catalog=\"catalog\" -\n" - " extends=\"SuperclassName\" -\n" - " abstract=\"true|false\" -\n" - " persister=\"ClassName\" -\n" - " subselect=\"SQL expression\" -\n" - " entity-name=\"EntityName\" -\n" - " node=\"element-name\"> -\n" - " -\n" - " <property .... /> -\n" - " ..... -\n" - "</union-subclass>]]>" -#: index.docbook:1990 -msgid "Then we might have some legacy data association which refers to this unique key of the <literal>Person</literal> table, instead of to the primary key:" -msgstr "<literal>name</literal>：サブクラスの完全修飾されたクラス名。" +#. Tag: para +#: basic_mapping.xml:1990 +#, no-c-format +msgid "" +"Then we might have some legacy data association which refers to this unique " +"key of the <literal>Person</literal> table, instead of to the primary key:" +msgstr "" +"主キーの代わりに <literal>Person</literal> テーブルのユニークキーへの参照を持" +"つ、レガシーデータの関連を持つかもしれません。：" -#: index.docbook:1995 +#. Tag: programlisting +#: basic_mapping.xml:1995 +#, no-c-format msgid "" - "<![CDATA[<many-to-one name=\"person\"\n" - " class=\"Person\" property-ref=\"name\">\n" - " <column name=\"firstName\"/>\n" - " <column name=\"initial\"/>\n" - " <column name=\"lastName\"/>\n" - "</many-to-one>]]>" -msgstr "<literal>table</literal> :サブクラステーブルの名前。" +"<![CDATA[<many-to-one name=\"person\"\n" +" class=\"Person\" property-ref=\"name\">\n" +" <column name=\"firstName\"/>\n" +" <column name=\"initial\"/>\n" +" <column name=\"lastName\"/>\n" +"</many-to-one>]]>" +msgstr "" -#: index.docbook:1997 -msgid "We don't recommend the use of this kind of thing outside the context of mapping legacy data." -msgstr "<literal>proxy</literal> (オプション): 遅延初期化プロキシに使用するクラスやインターフェイスを指定します。" +#. Tag: para +#: basic_mapping.xml:1997 +#, no-c-format +msgid "" +"We don't recommend the use of this kind of thing outside the context of " +"mapping legacy data." +msgstr "" +"しかし、このようなレガシーデータマッピングのコンテキスト外への使用は推奨しま" +"せん。" -#: index.docbook:2005 +#. Tag: title +#: basic_mapping.xml:2005 +#, no-c-format msgid "subclass" -msgstr "<literal>lazy</literal> (オプション, デフォルトは <literal>true</literal> ): <literal>lazy=\"false\"</literal> とすると、遅延フェッチが使用できません。" +msgstr "subclass" -#: index.docbook:2007 -msgid "Finally, polymorphic persistence requires the declaration of each subclass of the root persistent class. For the table-per-class-hierarchy mapping strategy, the <literal><subclass></literal> declaration is used." -msgstr "このマッピング戦略では識別カラムやキーカラムは必要ありません。" +#. Tag: para +#: basic_mapping.xml:2007 +#, no-c-format +msgid "" +"Finally, polymorphic persistence requires the declaration of each subclass " +"of the root persistent class. For the table-per-class-hierarchy mapping " +"strategy, the <literal><subclass></literal> declaration is used." +msgstr "" +"最後にポリモーフィックな永続化には、ルートの永続クラスの各サブクラスの定義が" +"必要です。 table-per-class-hierarchyマッピング戦略では、 <literal><" +"subclass></literal> 定義が使われます。" -#: index.docbook:2020 +#. Tag: programlisting +#: basic_mapping.xml:2020 +#, no-c-format msgid "" - "<![CDATA[<subclass\n" - " name=\"ClassName\"\n" - " discriminator-value=\"discriminator_value\"\n" - " proxy=\"ProxyInterface\"\n" - " lazy=\"true|false\"\n" - " dynamic-update=\"true|false\"\n" - " dynamic-insert=\"true|false\"\n" - " entity-name=\"EntityName\"\n" - " node=\"element-name\"\n" - " extends=\"SuperclassName\">\n" - "\n" - " <property .... />\n" - " .....\n" - "</subclass>]]>" -msgstr "継承のマッピングに関する情報は <xref linkend=\"inheritance\"/> を見てください。" +"<![CDATA[<subclass\n" +" name=\"ClassName\"\n" +" discriminator-value=\"discriminator_value\"\n" +" proxy=\"ProxyInterface\"\n" +" lazy=\"true|false\"\n" +" dynamic-update=\"true|false\"\n" +" dynamic-insert=\"true|false\"\n" +" entity-name=\"EntityName\"\n" +" node=\"element-name\"\n" +" extends=\"SuperclassName\">\n" +"\n" +" <property .... />\n" +" .....\n" +"</subclass>]]>" +msgstr "" -#: index.docbook:2023, index.docbook:2081, index.docbook:2144 -msgid "<literal>name</literal>: The fully qualified class name of the subclass." -msgstr "join" +#. Tag: para +#: basic_mapping.xml:2023 basic_mapping.xml:2081 basic_mapping.xml:2144 +#, no-c-format +msgid "" +"<literal>name</literal>: The fully qualified class name of the subclass." +msgstr "<literal>name</literal>：サブクラスの完全修飾されたクラス名。" -#: index.docbook:2028 -msgid "<literal>discriminator-value</literal> (optional - defaults to the class name): A value that distiguishes individual subclasses." -msgstr "<literal><join></literal> 要素を使うことで、１つのクラスのプロパティをいくつものテーブルにマッピングすることができます。" +#. Tag: para +#: basic_mapping.xml:2028 +#, no-c-format +msgid "" +"<literal>discriminator-value</literal> (optional - defaults to the class " +"name): A value that distiguishes individual subclasses." +msgstr "" +"<literal>discriminator-value</literal>（オプション - デフォルトはクラス" +"名）：個々のサブクラスを区別するための値。" -#: index.docbook:2034, index.docbook:2091, index.docbook:2154 -msgid "<literal>proxy</literal> (optional): Specifies a class or interface to use for lazy initializing proxies." +#. Tag: para +#: basic_mapping.xml:2034 basic_mapping.xml:2091 basic_mapping.xml:2154 +#, fuzzy, no-c-format +msgid "" +"<literal>proxy</literal> (optional): Specifies a class or interface to use " +"for lazy initializing proxies." msgstr "" - "<![CDATA[<join -\n" - " table=\"tablename\" -\n" - " schema=\"owner\" -\n" - " catalog=\"catalog\" -\n" - " fetch=\"join|select\" -\n" - " inverse=\"true|false\" -\n" - " optional=\"true|false\"> -\n" - " -\n" - " <key ... /> -\n" - " -\n" - " <property ... /> -\n" - " ... -\n" - "</join>]]>" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>proxy</literal>（オプション）：遅延初期化プロキシに使うクラスやイン" +"ターフェイスを指定します。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>proxy</literal> (オプション): 遅延初期化プロキシに使用するクラスやイ" +"ンターフェイスを指定します。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>proxy</literal> (オプション): 遅延初期化プロキシに使用するクラスやイ" +"ンターフェイスを指定します。" -#: index.docbook:2040, index.docbook:2097, index.docbook:2160 -msgid "<literal>lazy</literal> (optional, defaults to <literal>true</literal>): Setting <literal>lazy=\"false\"</literal> disables the use of lazy fetching." -msgstr "<literal>table</literal> :結合したテーブルの名前" +#. Tag: para +#: basic_mapping.xml:2040 basic_mapping.xml:2097 basic_mapping.xml:2160 +#, fuzzy, no-c-format +msgid "" +"<literal>lazy</literal> (optional, defaults to <literal>true</literal>): " +"Setting <literal>lazy=\"false\"</literal> disables the use of lazy fetching." +msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>lazy</literal>（オプション, デフォルトは <literal>true</" +"literal> ）： <literal>lazy=\"false\"</literal> と設定すると、遅延フェッチが" +"使用できません。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>lazy</literal> (オプション, デフォルトは <literal>true</literal> ): " +"<literal>lazy=\"false\"</literal> とすると、遅延フェッチが使用できません。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>lazy</literal> (オプション, デフォルトは <literal>true</literal> ): " +"<literal>lazy=\"false\"</literal> とすると、遅延フェッチが使用できません。" -#: index.docbook:2048 -msgid "Each subclass should declare its own persistent properties and subclasses. <literal><version></literal> and <literal><id></literal> properties are assumed to be inherited from the root class. Each subclass in a heirarchy must define a unique <literal>discriminator-value</literal>. If none is specified, the fully qualified Java class name is used." -msgstr "<literal>schema</literal> (オプション): ルートの <literal><hibernate-mapping></literal> 要素で指定したスキーマ名をオーバーライドします。" +#. Tag: para +#: basic_mapping.xml:2048 +#, no-c-format +msgid "" +"Each subclass should declare its own persistent properties and subclasses. " +"<literal><version></literal> and <literal><id></literal> " +"properties are assumed to be inherited from the root class. Each subclass in " +"a heirarchy must define a unique <literal>discriminator-value</literal>. If " +"none is specified, the fully qualified Java class name is used." +msgstr "" +"各サブクラスでは、永続プロパティとサブクラスを定義します。 <literal><" +"version></literal> と <literal><id></literal> プロパティは、ルート" +"クラスから継承されると仮定されます。階層構造におけるサブクラスは、ユニーク" +"な <literal>discriminator-value</literal> を定義しなければなりません。 noneが" +"指定されると、完全修飾されたJavaクラス名が使われます。" -#: index.docbook:2056, index.docbook:2114, index.docbook:2172 -msgid "For information about inheritance mappings, see <xref linkend=\"inheritance\"/>." -msgstr "<literal>catalog</literal> (オプション): ルートの <literal><hibernate-mapping></literal> 要素で指定したカタログ名をオーバーライドします。" +#. Tag: para +#: basic_mapping.xml:2056 basic_mapping.xml:2114 basic_mapping.xml:2172 +#, no-c-format +msgid "" +"For information about inheritance mappings, see <xref linkend=\"inheritance" +"\"/>." +msgstr "" +"継承のマッピングに関する情報は <xref linkend=\"inheritance\"/> を見てくださ" +"い。" -#: index.docbook:2063 +#. Tag: title +#: basic_mapping.xml:2063 +#, no-c-format msgid "joined-subclass" -msgstr "<literal>fetch</literal> (オプション - デフォルトは <literal>join</literal> ): <literal>join</literal> を設定した場合、 Hibernateはデフォルトで、クラスやスーパークラスで定義された <literal><join></literal> を検索するのに内部結合を使い、サブクラスで定義された <literal><join></literal> を検索するのに外部結合を使います。 <literal>select</literal> を設定した場合には、 Hibernateはサブクラスで定義された <literal><join></literal> の選択に順次選択を使います。この場合、行がサブクラスのインスタンスを代表することがわかった場合にのみ発行されます。内部結合はクラスやそのスーパークラスで定義された <literal><join></literal> を検索するために使用します。" +msgstr "joined-subclass" -#: index.docbook:2065 -msgid "Alternatively, each subclass may be mapped to its own table (table-per-subclass mapping strategy). Inherited state is retrieved by joining with the table of the superclass. We use the <literal><joined-subclass></literal> element." -msgstr "<literal>inverse</literal> (オプション - デフォルトは <literal>false</literal> ): もし可能であれば、Hibernateはこの結合で定義されているプロパティに対し挿入や更新を行いません。" +#. Tag: para +#: basic_mapping.xml:2065 +#, no-c-format +msgid "" +"Alternatively, each subclass may be mapped to its own table (table-per-" +"subclass mapping strategy). Inherited state is retrieved by joining with the " +"table of the superclass. We use the <literal><joined-subclass></" +"literal> element." +msgstr "" +"もう1つの方法として、各サブクラスを自身のテーブルへマッピングすることができま" +"す (table-per-subclass mapping strategy)。継承した状態はスーパークラスのテー" +"ブルを使った結合で検索します。 <literal><joined-subclass></literal> 要" +"素を使用します。" -#: index.docbook:2078 +#. Tag: programlisting +#: basic_mapping.xml:2078 +#, no-c-format msgid "" - "<![CDATA[<joined-subclass\n" - " name=\"ClassName\"\n" - " table=\"tablename\"\n" - " proxy=\"ProxyInterface\"\n" - " lazy=\"true|false\"\n" - " dynamic-update=\"true|false\"\n" - " dynamic-insert=\"true|false\"\n" - " schema=\"schema\"\n" - " catalog=\"catalog\"\n" - " extends=\"SuperclassName\"\n" - " persister=\"ClassName\"\n" - " subselect=\"SQL expression\"\n" - " entity-name=\"EntityName\"\n" - " node=\"element-name\">\n" - "\n" - " <key .... >\n" - "\n" - " <property .... />\n" - " .....\n" - "</joined-subclass>]]>" -msgstr "<literal>optional</literal> (オプション - デフォルトは <literal>false</literal> ): もし可能であれば、Hibernateはこの結合で定義されたプロパティがnullでない場合にのみ行を挿入し、そのプロパティの検索には常に外部結合を使用します。" +"<![CDATA[<joined-subclass\n" +" name=\"ClassName\"\n" +" table=\"tablename\"\n" +" proxy=\"ProxyInterface\"\n" +" lazy=\"true|false\"\n" +" dynamic-update=\"true|false\"\n" +" dynamic-insert=\"true|false\"\n" +" schema=\"schema\"\n" +" catalog=\"catalog\"\n" +" extends=\"SuperclassName\"\n" +" persister=\"ClassName\"\n" +" subselect=\"SQL expression\"\n" +" entity-name=\"EntityName\"\n" +" node=\"element-name\">\n" +"\n" +" <key .... >\n" +"\n" +" <property .... />\n" +" .....\n" +"</joined-subclass>]]>" +msgstr "" -#: index.docbook:2086, index.docbook:2149 +#. Tag: para +#: basic_mapping.xml:2086 basic_mapping.xml:2149 +#, no-c-format msgid "<literal>table</literal>: The name of the subclass table." +msgstr "<literal>table</literal> :サブクラステーブルの名前。" + +#. Tag: para +#: basic_mapping.xml:2105 +#, no-c-format +msgid "" +"No discriminator column is required for this mapping strategy. Each subclass " +"must, however, declare a table column holding the object identifier using " +"the <literal><key></literal> element. The mapping at the start of the " +"chapter would be re-written as:" msgstr "" - "<![CDATA[<class name=\"Person\" -\n" - " table=\"PERSON\"> -\n" - " -\n" - " <id name=\"id\" column=\"PERSON_ID\">...</id> -\n" - " -\n" - " <join table=\"ADDRESS\"> -\n" - " <key column=\"ADDRESS_ID\"/> -\n" - " <property name=\"address\"/> -\n" - " <property name=\"zip\"/> -\n" - " <property name=\"country\"/> -\n" - " </join> -\n" - " ...]]>" +"このマッピング戦略には、識別カラムは必要ありません。しかし各サブクラスは " +"<literal><key></literal> 要素を使い、オブジェクト識別子を保持するテー" +"ブルカラムを定義しなければなりません。この章の初めのマッピングは以下のように" +"書き直せます：" -#: index.docbook:2105 -msgid "No discriminator column is required for this mapping strategy. Each subclass must, however, declare a table column holding the object identifier using the <literal><key></literal> element. The mapping at the start of the chapter would be re-written as:" -msgstr "今まで何度か <literal><key></literal> 要素が出てきました。この要素は新しいテーブルへの結合を定義したり、結合テーブルで外部キーを定義したりする親要素のどこにでも現れ、オリジナルテーブルの主キーを参照します。" - -#: index.docbook:2112 +#. Tag: programlisting +#: basic_mapping.xml:2112 +#, no-c-format msgid "" - "<![CDATA[<?xml version=\"1.0\"?>\n" - "<!DOCTYPE hibernate-mapping PUBLIC\n" - " \"-//Hibernate/Hibernate Mapping DTD//EN\"\n" - " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" - "\n" - "<hibernate-mapping package=\"eg\">\n" - "\n" - " <class name=\"Cat\" table=\"CATS\">\n" - " <id name=\"id\" column=\"uid\" type=\"long\">\n" - " <generator class=\"hilo\"/>\n" - " </id>\n" - " <property name=\"birthdate\" type=\"date\"/>\n" - " <property name=\"color\" not-null=\"true\"/>\n" - " <property name=\"sex\" not-null=\"true\"/>\n" - " <property name=\"weight\"/>\n" - " <many-to-one name=\"mate\"/>\n" - " <set name=\"kittens\">\n" - " <key column=\"MOTHER\"/>\n" - " <one-to-many class=\"Cat\"/>\n" - " </set>\n" - " <joined-subclass name=\"DomesticCat\" table=\"DOMESTIC_CATS\">\n" - " <key column=\"CAT\"/>\n" - " <property name=\"name\" type=\"string\"/>\n" - " </joined-subclass>\n" - " </class>\n" - "\n" - " <class name=\"eg.Dog\">\n" - " \n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<?xml version=\"1.0\"?>\n" +"<!DOCTYPE hibernate-mapping PUBLIC\n" +" \"-//Hibernate/Hibernate Mapping DTD//EN\"\n" +" \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" +"\n" +"<hibernate-mapping package=\"eg\">\n" +"\n" +" <class name=\"Cat\" table=\"CATS\">\n" +" <id name=\"id\" column=\"uid\" type=\"long\">\n" +" <generator class=\"hilo\"/>\n" +" </id>\n" +" <property name=\"birthdate\" type=\"date\"/>\n" +" <property name=\"color\" not-null=\"true\"/>\n" +" <property name=\"sex\" not-null=\"true\"/>\n" +" <property name=\"weight\"/>\n" +" <many-to-one name=\"mate\"/>\n" +" <set name=\"kittens\">\n" +" <key column=\"MOTHER\"/>\n" +" <one-to-many class=\"Cat\"/>\n" +" </set>\n" +" <joined-subclass name=\"DomesticCat\" table=\"DOMESTIC_CATS" +"\">\n" +" <key column=\"CAT\"/>\n" +" <property name=\"name\" type=\"string\"/>\n" +" </joined-subclass>\n" +" </class>\n" +"\n" +" <class name=\"eg.Dog\">\n" +" \n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" - "<![CDATA[<key -\n" - " column=\"columnname\" -\n" - " on-delete=\"noaction|cascade\" -\n" - " property-ref=\"propertyName\" -\n" - " not-null=\"true|false\" -\n" - " update=\"true|false\" -\n" - " unique=\"true|false\" -\n" - "/>]]>" -#: index.docbook:2121 +#. Tag: title +#: basic_mapping.xml:2121 +#, no-c-format msgid "union-subclass" -msgstr "<literal>on-delete</literal> (オプション, デフォルトは <literal>noaction</literal>): 外部キー制約がデータベースレベルでカスケード削除が可能かどうかを指定します。" +msgstr "union-subclass" -#: index.docbook:2123 -msgid "A third option is to map only the concrete classes of an inheritance hierarchy to tables, (the table-per-concrete-class strategy) where each table defines all persistent state of the class, including inherited state. In Hibernate, it is not absolutely necessary to explicitly map such inheritance hierarchies. You can simply map each class with a separate <literal><class></literal> declaration. However, if you wish use polymorphic associations (e.g. an association to the superclass of your hierarchy), you need to use the <literal><union-subclass></literal> mapping." -msgstr "<literal>property-ref</literal> (オプション): オリジナルテーブルの主キーではないカラムを参照する外部キーを指定します (レガシーデータに対して提供されます)。" +#. Tag: para +#: basic_mapping.xml:2123 +#, no-c-format +msgid "" +"A third option is to map only the concrete classes of an inheritance " +"hierarchy to tables, (the table-per-concrete-class strategy) where each " +"table defines all persistent state of the class, including inherited state. " +"In Hibernate, it is not absolutely necessary to explicitly map such " +"inheritance hierarchies. You can simply map each class with a separate " +"<literal><class></literal> declaration. However, if you wish use " +"polymorphic associations (e.g. an association to the superclass of your " +"hierarchy), you need to use the <literal><union-subclass></literal> " +"mapping." +msgstr "" +"3つ目の選択肢は、継承階層の具象クラスのみをテーブルにマッピングすることです " +"(the table-per-concrete-class戦略)。それぞれのテーブルは継承の状態を含めすべ" +"てのクラスの永続状態を定義します。 Hibernateではその様な継承階層が必ずしも必" +"要ではありません。単純にそれぞれのクラスを、別々の <literal><class></" +"literal> 宣言を使ってマッピングすることができます。しかしポリモーフィックな" +"関連(例えば階層のスーパークラスへの関連)を使いたいなら、 <literal><union-" +"subclass></literal> マッピングを使う必要があります。" -#: index.docbook:2141 +#. Tag: programlisting +#: basic_mapping.xml:2141 +#, no-c-format msgid "" - "<![CDATA[<union-subclass\n" - " name=\"ClassName\"\n" - " table=\"tablename\"\n" - " proxy=\"ProxyInterface\"\n" - " lazy=\"true|false\"\n" - " dynamic-update=\"true|false\"\n" - " dynamic-insert=\"true|false\"\n" - " schema=\"schema\"\n" - " catalog=\"catalog\"\n" - " extends=\"SuperclassName\"\n" - " abstract=\"true|false\"\n" - " persister=\"ClassName\"\n" - " subselect=\"SQL expression\"\n" - " entity-name=\"EntityName\"\n" - " node=\"element-name\">\n" - "\n" - " <property .... />\n" - " .....\n" - "</union-subclass>]]>" -msgstr "<literal>not-null</literal> (オプション): 外部キーカラムがnull値を許容しないことを指定します (このことは外部キーが主キーの一部であることを暗黙的に示します)。" +"<![CDATA[<union-subclass\n" +" name=\"ClassName\"\n" +" table=\"tablename\"\n" +" proxy=\"ProxyInterface\"\n" +" lazy=\"true|false\"\n" +" dynamic-update=\"true|false\"\n" +" dynamic-insert=\"true|false\"\n" +" schema=\"schema\"\n" +" catalog=\"catalog\"\n" +" extends=\"SuperclassName\"\n" +" abstract=\"true|false\"\n" +" persister=\"ClassName\"\n" +" subselect=\"SQL expression\"\n" +" entity-name=\"EntityName\"\n" +" node=\"element-name\">\n" +"\n" +" <property .... />\n" +" .....\n" +"</union-subclass>]]>" +msgstr "" -#: index.docbook:2168 -msgid "No discriminator column or key column is required for this mapping strategy." -msgstr "column と formula 要素" +#. Tag: para +#: basic_mapping.xml:2168 +#, no-c-format +msgid "" +"No discriminator column or key column is required for this mapping strategy." +msgstr "このマッピング戦略では識別カラムやキーカラムは必要ありません。" -#: index.docbook:2179 +#. Tag: title +#: basic_mapping.xml:2179 +#, no-c-format msgid "join" +msgstr "join" + +#. Tag: para +#: basic_mapping.xml:2181 +#, no-c-format +msgid "" +"Using the <literal><join></literal> element, it is possible to map " +"properties of one class to several tables, when there's a 1-to-1 " +"relationship between the tables." msgstr "" - "<![CDATA[<column -\n" - " name=\"column_name\" -\n" - " length=\"N\" -\n" - " precision=\"N\" -\n" - " scale=\"N\" -\n" - " not-null=\"true|false\" -\n" - " unique=\"true|false\" -\n" - " unique-key=\"multicolumn_unique_key_name\" -\n" - " index=\"index_name\" -\n" - " sql-type=\"sql_type_name\" -\n" - " check=\"SQL expression\" -\n" - " default=\"SQL expression\"/>]]>" +"<literal><join></literal> 要素を使うことで、１つのクラスのプロパティを" +"いくつものテーブルにマッピングすることができます。" -#: index.docbook:2181 -msgid "Using the <literal><join></literal> element, it is possible to map properties of one class to several tables, when there's a 1-to-1 relationship between the tables." -msgstr "<![CDATA[<formula>SQL expression</formula>]]>" - -#: index.docbook:2195 +#. Tag: programlisting +#: basic_mapping.xml:2195 +#, no-c-format msgid "" - "<![CDATA[<join\n" - " table=\"tablename\"\n" - " schema=\"owner\"\n" - " catalog=\"catalog\"\n" - " fetch=\"join|select\"\n" - " inverse=\"true|false\"\n" - " optional=\"true|false\">\n" - "\n" - " <key ... />\n" - "\n" - " <property ... />\n" - " ...\n" - "</join>]]>" -msgstr "同じプロパティや関連のマッピングの中で、 <literal>column</literal> と <literal>formula</literal> 属性を組み合わせることができます。例えば、特殊な結合条件などです。" +"<![CDATA[<join\n" +" table=\"tablename\"\n" +" schema=\"owner\"\n" +" catalog=\"catalog\"\n" +" fetch=\"join|select\"\n" +" inverse=\"true|false\"\n" +" optional=\"true|false\">\n" +"\n" +" <key ... />\n" +"\n" +" <property ... />\n" +" ...\n" +"</join>]]>" +msgstr "" -#: index.docbook:2199 +#. Tag: para +#: basic_mapping.xml:2199 +#, no-c-format msgid "<literal>table</literal>: The name of the joined table." +msgstr "<literal>table</literal> :結合したテーブルの名前" + +#. Tag: para +#: basic_mapping.xml:2216 +#, no-c-format +msgid "" +"<literal>fetch</literal> (optional - defaults to <literal>join</literal>): " +"If set to <literal>join</literal>, the default, Hibernate will use an inner " +"join to retrieve a <literal><join></literal> defined by a class or its " +"superclasses and an outer join for a <literal><join></literal> defined " +"by a subclass. If set to <literal>select</literal> then Hibernate will use a " +"sequential select for a <literal><join></literal> defined on a " +"subclass, which will be issued only if a row turns out to represent an " +"instance of the subclass. Inner joins will still be used to retrieve a " +"<literal><join></literal> defined by the class and its superclasses." msgstr "" - "<![CDATA[<many-to-one name=\"homeAddress\" class=\"Address\" -\n" - " insert=\"false\" update=\"false\"> -\n" - " <column name=\"person_id\" not-null=\"true\" length=\"10\"/> -\n" - " <formula>'MAILING'</formula> -\n" - "</many-to-one>]]>" +"<literal>fetch</literal> (オプション - デフォルトは <literal>join</" +"literal> ): <literal>join</literal> を設定した場合、 Hibernateはデフォルト" +"で、クラスやスーパークラスで定義された <literal><join></literal> を検索" +"するのに内部結合を使い、サブクラスで定義された <literal><join></" +"literal> を検索するのに外部結合を使います。 <literal>select</literal> を設定" +"した場合には、 Hibernateはサブクラスで定義された <literal><join></" +"literal> の選択に順次選択を使います。この場合、行がサブクラスのインスタンス" +"を代表することがわかった場合にのみ発行されます。内部結合はクラスやそのスー" +"パークラスで定義された <literal><join></literal> を検索するために使用" +"します。" -#: index.docbook:2216 -msgid "<literal>fetch</literal> (optional - defaults to <literal>join</literal>): If set to <literal>join</literal>, the default, Hibernate will use an inner join to retrieve a <literal><join></literal> defined by a class or its superclasses and an outer join for a <literal><join></literal> defined by a subclass. If set to <literal>select</literal> then Hibernate will use a sequential select for a <literal><join></literal> defined on a subclass, which will be issued only if a row turns out to represent an instance of the subclass. Inner joins will still be used to retrieve a <literal><join></literal> defined by the class and its superclasses." -msgstr "<![CDATA[<import class=\"java.lang.Object\" rename=\"Universe\"/>]]>" +#. Tag: para +#: basic_mapping.xml:2229 +#, no-c-format +msgid "" +"<literal>inverse</literal> (optional - defaults to <literal>false</" +"literal>): If enabled, Hibernate will not try to insert or update the " +"properties defined by this join." +msgstr "" +"<literal>inverse</literal> (オプション - デフォルトは <literal>false</" +"literal> ): もし可能であれば、Hibernateはこの結合で定義されているプロパティに" +"対し挿入や更新を行いません。" -#: index.docbook:2229 -msgid "<literal>inverse</literal> (optional - defaults to <literal>false</literal>): If enabled, Hibernate will not try to insert or update the properties defined by this join." +#. Tag: para +#: basic_mapping.xml:2236 +#, no-c-format +msgid "" +"<literal>optional</literal> (optional - defaults to <literal>false</" +"literal>): If enabled, Hibernate will insert a row only if the properties " +"defined by this join are non-null and will always use an outer join to " +"retrieve the properties." msgstr "" - "<![CDATA[<import -\n" - " class=\"ClassName\" -\n" - " rename=\"ShortName\" -\n" - "/>]]>" +"<literal>optional</literal> (オプション - デフォルトは <literal>false</" +"literal> ): もし可能であれば、Hibernateはこの結合で定義されたプロパティがnull" +"でない場合にのみ行を挿入し、そのプロパティの検索には常に外部結合を使用しま" +"す。" -#: index.docbook:2236 -msgid "<literal>optional</literal> (optional - defaults to <literal>false</literal>): If enabled, Hibernate will insert a row only if the properties defined by this join are non-null and will always use an outer join to retrieve the properties." -msgstr "<literal>class</literal>：Javaクラスの完全修飾されたクラス名。" +#. Tag: para +#: basic_mapping.xml:2245 +#, no-c-format +msgid "" +"For example, the address information for a person can be mapped to a " +"separate table (while preserving value type semantics for all properties):" +msgstr "" +"例えば人のアドレスの情報を分離したテーブルにマッピングすることが可能です (す" +"べてのプロパティに対して値型のセマンティクスを保持します)。" -#: index.docbook:2245 -msgid "For example, the address information for a person can be mapped to a separate table (while preserving value type semantics for all properties):" -msgstr "<literal>rename</literal>（オプション - デフォルトは修飾されていないクラス名）：クエリ言語で使われる名前。" +#. Tag: programlisting +#: basic_mapping.xml:2250 +#, no-c-format +msgid "" +"<![CDATA[<class name=\"Person\"\n" +" table=\"PERSON\">\n" +"\n" +" <id name=\"id\" column=\"PERSON_ID\">...</id>\n" +"\n" +" <join table=\"ADDRESS\">\n" +" <key column=\"ADDRESS_ID\"/>\n" +" <property name=\"address\"/>\n" +" <property name=\"zip\"/>\n" +" <property name=\"country\"/>\n" +" </join>\n" +" ...]]>" +msgstr "" -#: index.docbook:2250 +#. Tag: para +#: basic_mapping.xml:2252 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\"\n" - " table=\"PERSON\">\n" - "\n" - " <id name=\"id\" column=\"PERSON_ID\">...</id>\n" - "\n" - " <join table=\"ADDRESS\">\n" - " <key column=\"ADDRESS_ID\"/>\n" - " <property name=\"address\"/>\n" - " <property name=\"zip\"/>\n" - " <property name=\"country\"/>\n" - " </join>\n" - " ...]]>" -msgstr "<title>any</title>" +"This feature is often only useful for legacy data models, we recommend fewer " +"tables than classes and a fine-grained domain model. However, it is useful " +"for switching between inheritance mapping strategies in a single hierarchy, " +"as explained later." +msgstr "" +"この特徴はしばしばレガシーデータモデルに対してのみ有用ですが、クラスよりも少" +"ないテーブルと、きめの細かいドメインモデルを推奨します。しかし後で説明するよ" +"うに、１つのクラス階層で継承のマッピング戦略を切り替える時には有用です。" -#: index.docbook:2252 -msgid "This feature is often only useful for legacy data models, we recommend fewer tables than classes and a fine-grained domain model. However, it is useful for switching between inheritance mapping strategies in a single hierarchy, as explained later." -msgstr "プロパティマッピングにはさらにもう1つの型があります。 <literal><any></literal> マッピング要素は、複数のテーブルからクラスへのポリモーフィックな関連を定義します。この型のマッピングには必ず複数のカラムが必要です。1番目のカラムは関連エンティティの型を保持します。残りのカラムは識別子を保持します。この種類の関連には外部キー制約を指定することはできません。そのためこれは最も使われることのない（ポリモーフィックな）関連のマッピング方法です。非常に特別な場合（例えば、検査ログやユーザセッションデータなど)に限って、これを使うべきです。" - -#: index.docbook:2262 +#. Tag: title +#: basic_mapping.xml:2262 +#, no-c-format msgid "<title>key</title>" -msgstr "<literal>meta-type</literal> により、アプリケーションはカスタム型を指定できます。このカスタム型はデータベースカラムの値を、<literal>id-type</literal> で指定した型の識別子プロパティを持った永続クラスへマッピングします。 meta-typeの値からクラス名へのマッピングを指定しなければなりません。" +msgstr "" -#: index.docbook:2264 -msgid "We've seen the <literal><key></literal> element crop up a few times now. It appears anywhere the parent mapping element defines a join to a new table, and defines the foreign key in the joined table, that references the primary key of the original table." +#. Tag: para +#: basic_mapping.xml:2264 +#, no-c-format +msgid "" +"We've seen the <literal><key></literal> element crop up a few times " +"now. It appears anywhere the parent mapping element defines a join to a new " +"table, and defines the foreign key in the joined table, that references the " +"primary key of the original table." msgstr "" - "<![CDATA[<any name=\"being\" id-type=\"long\" meta-type=\"string\"> -\n" - " <meta-value value=\"TBL_ANIMAL\" class=\"Animal\"/> -\n" - " <meta-value value=\"TBL_HUMAN\" class=\"Human\"/> -\n" - " <meta-value value=\"TBL_ALIEN\" class=\"Alien\"/> -\n" - " <column name=\"table_name\"/> -\n" - " <column name=\"id\"/> -\n" - "</any>]]>" +"今まで何度か <literal><key></literal> 要素が出てきました。この要素は新" +"しいテーブルへの結合を定義したり、結合テーブルで外部キーを定義したりする親要" +"素のどこにでも現れ、オリジナルテーブルの主キーを参照します。" -#: index.docbook:2280 +#. Tag: programlisting +#: basic_mapping.xml:2280 +#, no-c-format msgid "" - "<![CDATA[<key\n" - " column=\"columnname\"\n" - " on-delete=\"noaction|cascade\"\n" - " property-ref=\"propertyName\"\n" - " not-null=\"true|false\"\n" - " update=\"true|false\"\n" - " unique=\"true|false\"\n" - "/>]]>" +"<![CDATA[<key\n" +" column=\"columnname\"\n" +" on-delete=\"noaction|cascade\"\n" +" property-ref=\"propertyName\"\n" +" not-null=\"true|false\"\n" +" update=\"true|false\"\n" +" unique=\"true|false\"\n" +"/>]]>" msgstr "" - "<![CDATA[<any -\n" - " name=\"propertyName\" -\n" - " id-type=\"idtypename\" -\n" - " meta-type=\"metatypename\" -\n" - " cascade=\"cascade_style\" -\n" - " access=\"field|property|ClassName\" -\n" - " optimistic-lock=\"true|false\" -\n" - "> -\n" - " <meta-value ... /> -\n" - " <meta-value ... /> -\n" - " ..... -\n" - " <column .... /> -\n" - " <column .... /> -\n" - " ..... -\n" - "</any>]]>" -#: index.docbook:2291 -msgid "<literal>on-delete</literal> (optional, defaults to <literal>noaction</literal>): Specifies whether the foreign key constraint has database-level cascade delete enabled." -msgstr "<literal>id-type</literal>：識別子の型。" +#. Tag: para +#: basic_mapping.xml:2291 +#, no-c-format +msgid "" +"<literal>on-delete</literal> (optional, defaults to <literal>noaction</" +"literal>): Specifies whether the foreign key constraint has database-level " +"cascade delete enabled." +msgstr "" +"<literal>on-delete</literal> (オプション, デフォルトは <literal>noaction</" +"literal>): 外部キー制約がデータベースレベルでカスケード削除が可能かどうかを指" +"定します。" -#: index.docbook:2298 -msgid "<literal>property-ref</literal> (optional): Specifies that the foreign key refers to columns that are not the primary key of the orginal table. (Provided for legacy data.)" -msgstr "<literal>meta-type</literal>（オプション - デフォルトは <literal>string</literal> ）：ディスクリミネータマッピングで許された型" +#. Tag: para +#: basic_mapping.xml:2298 +#, no-c-format +msgid "" +"<literal>property-ref</literal> (optional): Specifies that the foreign key " +"refers to columns that are not the primary key of the orginal table. " +"(Provided for legacy data.)" +msgstr "" +"<literal>property-ref</literal> (オプション): オリジナルテーブルの主キーでは" +"ないカラムを参照する外部キーを指定します (レガシーデータに対して提供されま" +"す)。" -#: index.docbook:2305 -msgid "<literal>not-null</literal> (optional): Specifies that the foreign key columns are not nullable (this is implied whenever the foreign key is also part of the primary key)." -msgstr "<literal>cascade</literal>（オプション - デフォルトは <literal>none</literal> ）：カスケードのスタイル。" +#. Tag: para +#: basic_mapping.xml:2305 +#, no-c-format +msgid "" +"<literal>not-null</literal> (optional): Specifies that the foreign key " +"columns are not nullable (this is implied whenever the foreign key is also " +"part of the primary key)." +msgstr "" +"<literal>not-null</literal> (オプション): 外部キーカラムがnull値を許容しない" +"ことを指定します (このことは外部キーが主キーの一部であることを暗黙的に示しま" +"す)。" -#: index.docbook:2312 -msgid "<literal>update</literal> (optional): Specifies that the foreign key should never be updated (this is implied whenever the foreign key is also part of the primary key)." -msgstr "<literal>access</literal>（オプション - デフォルトは <literal>property</literal> ）：プロパティの値へのアクセスにHibernateが使う戦略。" +#. Tag: para +#: basic_mapping.xml:2312 +#, no-c-format +msgid "" +"<literal>update</literal> (optional): Specifies that the foreign key should " +"never be updated (this is implied whenever the foreign key is also part of " +"the primary key)." +msgstr "" +"<literal>update</literal> (オプション): 外部キーを決して更新してはならないこ" +"とを指定します (このことは外部キーが主キーの一部であることを暗黙的に示しま" +"す)。" -#: index.docbook:2319 -msgid "<literal>unique</literal> (optional): Specifies that the foreign key should have a unique constraint (this is implied whenever the foreign key is also the primary key)." -msgstr "<literal>optimistic-lock</literal> (オプション - デフォルトは <literal>true</literal> ): このプロパティの更新に楽観ロックの取得を要求するかどうかを指定します。言い換えれば、このプロパティがダーティであるときにバージョンを増やすべきかを定義します。" +#. Tag: para +#: basic_mapping.xml:2319 +#, no-c-format +msgid "" +"<literal>unique</literal> (optional): Specifies that the foreign key should " +"have a unique constraint (this is implied whenever the foreign key is also " +"the primary key)." +msgstr "" +"<literal>unique</literal> (オプション): 外部キーがユニーク制約を持つべきであ" +"ることを指定します (このことは外部キーが主キーの一部であることを暗黙的に示し" +"ます)。" -#: index.docbook:2327 -msgid "We recommend that for systems where delete performance is important, all keys should be defined <literal>on-delete=\"cascade\"</literal>, and Hibernate will use a database-level <literal>ON CASCADE DELETE</literal> constraint, instead of many individual <literal>DELETE</literal> statements. Be aware that this feature bypasses Hibernate's usual optimistic locking strategy for versioned data." -msgstr "Hibernateの型" +#. Tag: para +#: basic_mapping.xml:2327 +#, no-c-format +msgid "" +"We recommend that for systems where delete performance is important, all " +"keys should be defined <literal>on-delete=\"cascade\"</literal>, and " +"Hibernate will use a database-level <literal>ON CASCADE DELETE</literal> " +"constraint, instead of many individual <literal>DELETE</literal> statements. " +"Be aware that this feature bypasses Hibernate's usual optimistic locking " +"strategy for versioned data." +msgstr "" +"削除のパフォーマンスが重要であるシステムには、すべてのキーを <literal>on-" +"delete=\"cascade\"</literal> と定義することを推奨します。そうすることで" +"Hibernateは、<literal>DELETE</literal> 文を毎回発行する代わりに、データベー" +"スレベルの <literal>ON CASCADE DELETE</literal> 制約を使用します。この特徴は" +"バージョン付けられたデータに対するHibernateの通常の楽観的ロック戦略を無視す" +"るということに注意してください。" -#: index.docbook:2335 -msgid "The <literal>not-null</literal> and <literal>update</literal> attributes are useful when mapping a unidirectional one to many association. If you map a unidirectional one to many to a non-nullable foreign key, you <emphasis>must</emphasis> declare the key column using <literal><key not-null=\"true\"></literal>." -msgstr "エンティティと値" +#. Tag: para +#: basic_mapping.xml:2335 +#, no-c-format +msgid "" +"The <literal>not-null</literal> and <literal>update</literal> attributes are " +"useful when mapping a unidirectional one to many association. If you map a " +"unidirectional one to many to a non-nullable foreign key, you " +"<emphasis>must</emphasis> declare the key column using <literal><key not-" +"null=\"true\"></literal>." +msgstr "" +"<literal>not-null</literal> と <literal>update</literal> 属性は、単方向一対多" +"関連の時には有用です。単方向一対多関連をnullを許容しない外部キーにマッピング" +"するときは、 <literal><key not-null=\"true\"></literal> を使ってキーカ" +"ラムを宣言 <emphasis> しなくてはなりません</emphasis> 。" -#: index.docbook:2345 +#. Tag: title +#: basic_mapping.xml:2345 +#, no-c-format msgid "column and formula elements" -msgstr "永続サービスに関わる様々なJava言語レベルのオブジェクトの振る舞いを理解するためには、オブジェクトを2つのグループに分ける必要があります：" +msgstr "column と formula 要素" -#: index.docbook:2346 -msgid "Any mapping element which accepts a <literal>column</literal> attribute will alternatively accept a <literal><column></literal> subelement. Likewise, <literal><formula></literal> is an alternative to the <literal>formula</literal> attribute." -msgstr "<emphasis> エンティティ</emphasis> はエンティティへの参照を保持する、他のすべてのオブジェクトから独立して存在します。参照されないオブジェクトがガベージコレクトされてしまう性質を持つ通常のJavaモデルと、これを比べてみてください。（親エンティティから子へ、セーブと削除が <emphasis>カスケード</emphasis> されうることを除いて）エンティティは明示的にセーブまたは削除されなければなりません。これは到達可能性によるオブジェクト永続化のODMGモデルとは異なっています。大規模なシステムでアプリケーションオブジェクトが普通どのように使われるかにより密接に対応します。エンティティは循環と参照の共有をサポートします。またそれらはバージョン付けすることもできます。" +#. Tag: para +#: basic_mapping.xml:2346 +#, no-c-format +msgid "" +"Any mapping element which accepts a <literal>column</literal> attribute will " +"alternatively accept a <literal><column></literal> subelement. " +"Likewise, <literal><formula></literal> is an alternative to the " +"<literal>formula</literal> attribute." +msgstr "" +"<literal>column</literal> 属性を記述できる任意のマッピング要素はまた、 " +"<literal><column></literal> サブ要素も記述できます。同様に " +"<literal><formula></literal> も <literal>formula</literal> 属性の代替手" +"段です。" -#: index.docbook:2352 +#. Tag: programlisting +#: basic_mapping.xml:2352 +#, no-c-format msgid "" - "<![CDATA[<column\n" - " name=\"column_name\"\n" - " length=\"N\"\n" - " precision=\"N\"\n" - " scale=\"N\"\n" - " not-null=\"true|false\"\n" - " unique=\"true|false\"\n" - " unique-key=\"multicolumn_unique_key_name\"\n" - " index=\"index_name\"\n" - " sql-type=\"sql_type_name\"\n" - " check=\"SQL expression\"\n" - " default=\"SQL expression\"/>]]>" -msgstr "エンティティの永続状態は他のエンティティや <emphasis>値</emphasis> 型のインスタンスへの参照から構成されます。値はプリミティブ、コレクション(コレクションの内部ではなく)、コンポーネント、不変オブジェクトです。エンティティとは違い、値は（特にコレクションとコンポーネントにおいて）、到達可能性による永続化や削除が <emphasis>行われます</emphasis> 。値オブジェクト（とプリミティブ）は、包含するエンティティと一緒に永続化や削除が行われるので、それらを独立にバージョン付けすることはできません。値には独立したアイデンティティがないので、複数のエンティティやコレクションがこれを共有することはできません。" +"<![CDATA[<column\n" +" name=\"column_name\"\n" +" length=\"N\"\n" +" precision=\"N\"\n" +" scale=\"N\"\n" +" not-null=\"true|false\"\n" +" unique=\"true|false\"\n" +" unique-key=\"multicolumn_unique_key_name\"\n" +" index=\"index_name\"\n" +" sql-type=\"sql_type_name\"\n" +" check=\"SQL expression\"\n" +" default=\"SQL expression\"/>]]>" +msgstr "" -#: index.docbook:2354 +#. Tag: programlisting +#: basic_mapping.xml:2354 +#, no-c-format msgid "<![CDATA[<formula>SQL expression</formula>]]>" -msgstr "これまで「永続クラス」という言葉をエンティティの意味で使ってきました。これからもそうしていきます。厳密に言うと、永続状態を持つユーザ定義のクラスのすべてがエンティティというわけではありません。 <emphasis>コンポーネント</emphasis> は値のセマンティクスを持つユーザ定義クラスです。 <literal>java.lang.String</literal> 型のプロパティもまた値のセマンティクスを持ちます。定義するなら、JDKで提供されているすべてのJavaの型(クラス)が値のセマンティクスを持つといえます。一方ユーザ定義型は、エンティティや値型のセマンティクスとともにマッピングできます。この決定はアプリケーション開発者次第です。そのクラスの１つのインスタンスへの共有参照は、ドメインモデル内のエンティティクラスに対す! る良いヒントになります。一方合成集約や集約は、通常値型へ変換されます。" +msgstr "" -#: index.docbook:2356 -msgid "<literal>column</literal> and <literal>formula</literal> attributes may even be combined within the same property or association mapping to express, for example, exotic join conditions." -msgstr "本ドキュメントを通して、何度もこの概念を取り上げます。" +#. Tag: para +#: basic_mapping.xml:2356 +#, no-c-format +msgid "" +"<literal>column</literal> and <literal>formula</literal> attributes may even " +"be combined within the same property or association mapping to express, for " +"example, exotic join conditions." +msgstr "" +"同じプロパティや関連のマッピングの中で、 <literal>column</literal> と " +"<literal>formula</literal> 属性を組み合わせることができます。例えば、特殊な" +"結合条件などです。" -#: index.docbook:2362 +#. Tag: programlisting +#: basic_mapping.xml:2362 +#, no-c-format msgid "" - "<![CDATA[<many-to-one name=\"homeAddress\" class=\"Address\"\n" - " insert=\"false\" update=\"false\">\n" - " <column name=\"person_id\" not-null=\"true\" length=\"10\"/>\n" - " <formula>'MAILING'</formula>\n" - "</many-to-one>]]>" -msgstr "Java型のシステム(もしくは開発者が定義したエンティティと値型)を SQL/データベース型のシステムにマッピングすることは難しいです。 Hibernateは２つのシステムの架け橋を提供します。エンティティに対しては <literal><class></literal> や <literal><subclass></literal> などを使用します。値型に対しては <literal><property></literal> や <literal><component></literal> などを、通常 <literal>type</literal> とともに使います。この属性の値はHibernateの <emphasis>マッピング型</emphasis> の名前です。 Hibernateは(標準JDKの値型に対して)多くの自由なマッピングを提供します。後で見るように、自身のマッピング型を記述し、同様にカスタムの変換戦略を実装することができます。" +"<![CDATA[<many-to-one name=\"homeAddress\" class=\"Address\"\n" +" insert=\"false\" update=\"false\">\n" +" <column name=\"person_id\" not-null=\"true\" length=\"10\"/>\n" +" <formula>'MAILING'</formula>\n" +"</many-to-one>]]>" +msgstr "" -#: index.docbook:2367 +#. Tag: title +#: basic_mapping.xml:2367 +#, no-c-format msgid "import" -msgstr "コレクションを除く組み込みのHibernateの型はすべて、nullセマンティクスをサポートします。" +msgstr "import" -#: index.docbook:2369 -msgid "Suppose your application has two persistent classes with the same name, and you don't want to specify the fully qualified (package) name in Hibernate queries. Classes may be \"imported\" explicitly, rather than relying upon <literal>auto-import=\"true\"</literal>. You may even import classes and interfaces that are not explicitly mapped." -msgstr "基本的な型" +#. Tag: para +#: basic_mapping.xml:2369 +#, no-c-format +msgid "" +"Suppose your application has two persistent classes with the same name, and " +"you don't want to specify the fully qualified (package) name in Hibernate " +"queries. Classes may be \"imported\" explicitly, rather than relying upon " +"<literal>auto-import=\"true\"</literal>. You may even import classes and " +"interfaces that are not explicitly mapped." +msgstr "" +"アプリケーションに同じ名前の2つの永続クラスがあり、 Hibernateクエリで完全修飾" +"された（パッケージの）名前を指定したくないと仮定します。そのような場合は " +"<literal>auto-import=\"true\"</literal> に頼らず、クラスが「インポート」され" +"たものであると明示できます。明示的にマッピングされていないクラスやインター" +"フェイスでさえもインポートできます。" -#: index.docbook:2376 +#. Tag: programlisting +#: basic_mapping.xml:2376 +#, no-c-format msgid "<![CDATA[<import class=\"java.lang.Object\" rename=\"Universe\"/>]]>" -msgstr "組み込みの <emphasis>基本的なマッピング型</emphasis> は大まかに以下のように分けられます。" +msgstr "" -#: index.docbook:2383 +#. Tag: programlisting +#: basic_mapping.xml:2383 +#, no-c-format msgid "" - "<![CDATA[<import\n" - " class=\"ClassName\"\n" - " rename=\"ShortName\"\n" - "/>]]>" -msgstr "integer, long, short, float, double, character, byte, boolean, yes_no, true_false" +"<![CDATA[<import\n" +" class=\"ClassName\"\n" +" rename=\"ShortName\"\n" +"/>]]>" +msgstr "" -#: index.docbook:2386 -msgid "<literal>class</literal>: The fully qualified class name of of any Java class." -msgstr "Javaのプリミティブやラッパークラスから適切な（ベンダー固有の） SQLカラム型への型マッピング。 <literal>boolean, yes_no</literal> と <literal>true_false</literal> は、すべてJavaの <literal>boolean</literal> または <literal>java.lang.Boolean</literal> の代替エンコードです。" +#. Tag: para +#: basic_mapping.xml:2386 +#, no-c-format +msgid "" +"<literal>class</literal>: The fully qualified class name of of any Java " +"class." +msgstr "<literal>class</literal>：Javaクラスの完全修飾されたクラス名。" -#: index.docbook:2391 -msgid "<literal>rename</literal> (optional - defaults to the unqualified class name): A name that may be used in the query language." -msgstr "string" +#. Tag: para +#: basic_mapping.xml:2391 +#, no-c-format +msgid "" +"<literal>rename</literal> (optional - defaults to the unqualified class " +"name): A name that may be used in the query language." +msgstr "" +"<literal>rename</literal>（オプション - デフォルトは修飾されていないクラス" +"名）：クエリ言語で使われる名前。" -#: index.docbook:2402 +#. Tag: title +#: basic_mapping.xml:2402 +#, no-c-format msgid "<title>any</title>" -msgstr "<literal>java.lang.String</literal> から <literal>VARCHAR</literal> （またはOracleの <literal>VARCHAR2</literal> ）への型マッピング。" +msgstr "" -#: index.docbook:2404 -msgid "There is one further type of property mapping. The <literal><any></literal> mapping element defines a polymorphic association to classes from multiple tables. This type of mapping always requires more than one column. The first column holds the type of the associated entity. The remaining columns hold the identifier. It is impossible to specify a foreign key constraint for this kind of association, so this is most certainly not meant as the usual way of mapping (polymorphic) associations. You should use this only in very special cases (eg. audit logs, user session data, etc)." -msgstr "date, time, timestamp" +#. Tag: para +#: basic_mapping.xml:2404 +#, no-c-format +msgid "" +"There is one further type of property mapping. The <literal><any></" +"literal> mapping element defines a polymorphic association to classes from " +"multiple tables. This type of mapping always requires more than one column. " +"The first column holds the type of the associated entity. The remaining " +"columns hold the identifier. It is impossible to specify a foreign key " +"constraint for this kind of association, so this is most certainly not meant " +"as the usual way of mapping (polymorphic) associations. You should use this " +"only in very special cases (eg. audit logs, user session data, etc)." +msgstr "" +"プロパティマッピングにはさらにもう1つの型があります。 <literal><any></" +"literal> マッピング要素は、複数のテーブルからクラスへのポリモーフィックな関" +"連を定義します。この型のマッピングには必ず複数のカラムが必要です。1番目のカ" +"ラムは関連エンティティの型を保持します。残りのカラムは識別子を保持します。こ" +"の種類の関連には外部キー制約を指定することはできません。そのためこれは最も使" +"われることのない（ポリモーフィックな）関連のマッピング方法です。非常に特別な" +"場合（例えば、検査ログやユーザセッションデータなど)に限って、これを使うべきで" +"す。" -#: index.docbook:2414 -msgid "The <literal>meta-type</literal> attribute lets the application specify a custom type that maps database column values to persistent classes which have identifier properties of the type specified by <literal>id-type</literal>. You must specify the mapping from values of the meta-type to class names." -msgstr "<literal>java.util.Date</literal> とそのサブクラスからSQL型の <literal>DATE</literal>, <literal>TIME</literal> , <literal>TIMESTAMP</literal> （またはそれらと等価なもの）への型マッピング。" +#. Tag: para +#: basic_mapping.xml:2414 +#, no-c-format +msgid "" +"The <literal>meta-type</literal> attribute lets the application specify a " +"custom type that maps database column values to persistent classes which " +"have identifier properties of the type specified by <literal>id-type</" +"literal>. You must specify the mapping from values of the meta-type to class " +"names." +msgstr "" +"<literal>meta-type</literal> により、アプリケーションはカスタム型を指定でき" +"ます。このカスタム型はデータベースカラムの値を、<literal>id-type</literal> " +"で指定した型の識別子プロパティを持った永続クラスへマッピングします。 meta-" +"typeの値からクラス名へのマッピングを指定しなければなりません。" -#: index.docbook:2421 +#. Tag: programlisting +#: basic_mapping.xml:2421 +#, no-c-format msgid "" - "<![CDATA[<any name=\"being\" id-type=\"long\" meta-type=\"string\">\n" - " <meta-value value=\"TBL_ANIMAL\" class=\"Animal\"/>\n" - " <meta-value value=\"TBL_HUMAN\" class=\"Human\"/>\n" - " <meta-value value=\"TBL_ALIEN\" class=\"Alien\"/>\n" - " <column name=\"table_name\"/>\n" - " <column name=\"id\"/>\n" - "</any>]]>" -msgstr "calendar, calendar_date" +"<![CDATA[<any name=\"being\" id-type=\"long\" meta-type=\"string\">\n" +" <meta-value value=\"TBL_ANIMAL\" class=\"Animal\"/>\n" +" <meta-value value=\"TBL_HUMAN\" class=\"Human\"/>\n" +" <meta-value value=\"TBL_ALIEN\" class=\"Alien\"/>\n" +" <column name=\"table_name\"/>\n" +" <column name=\"id\"/>\n" +"</any>]]>" +msgstr "" -#: index.docbook:2432 +#. Tag: programlisting +#: basic_mapping.xml:2432 +#, no-c-format msgid "" - "<![CDATA[<any\n" - " name=\"propertyName\"\n" - " id-type=\"idtypename\"\n" - " meta-type=\"metatypename\"\n" - " cascade=\"cascade_style\"\n" - " access=\"field|property|ClassName\"\n" - " optimistic-lock=\"true|false\"\n" - ">\n" - " <meta-value ... />\n" - " <meta-value ... />\n" - " .....\n" - " <column .... />\n" - " <column .... />\n" - " .....\n" - "</any>]]>" -msgstr "<literal>java.util.Calendar</literal> からSQL型の「 <literal>TIMESTAMP</literal> , <literal>DATE</literal> (またはそれらと等価なもの）への型マッピング。" +"<![CDATA[<any\n" +" name=\"propertyName\"\n" +" id-type=\"idtypename\"\n" +" meta-type=\"metatypename\"\n" +" cascade=\"cascade_style\"\n" +" access=\"field|property|ClassName\"\n" +" optimistic-lock=\"true|false\"\n" +">\n" +" <meta-value ... />\n" +" <meta-value ... />\n" +" .....\n" +" <column .... />\n" +" <column .... />\n" +" .....\n" +"</any>]]>" +msgstr "" -#: index.docbook:2435 +#. Tag: para +#: basic_mapping.xml:2435 +#, no-c-format msgid "<literal>name</literal>: the property name." -msgstr "big_decimal, big_integer" +msgstr "<literal>name</literal>：プロパティ名。" -#: index.docbook:2440 +#. Tag: para +#: basic_mapping.xml:2440 +#, no-c-format msgid "<literal>id-type</literal>: the identifier type." -msgstr "<literal>java.math.BigDecimal</literal> と <literal>java.math.BigInteger</literal> から <literal>NUMERIC</literal>（またはOracleの <literal>NUMBER</literal> ）への型マッピング。" +msgstr "<literal>id-type</literal>：識別子の型。" -#: index.docbook:2445 -msgid "<literal>meta-type</literal> (optional - defaults to <literal>string</literal>): Any type that is allowed for a discriminator mapping." -msgstr "locale, timezone, currency" +#. Tag: para +#: basic_mapping.xml:2445 +#, no-c-format +msgid "" +"<literal>meta-type</literal> (optional - defaults to <literal>string</" +"literal>): Any type that is allowed for a discriminator mapping." +msgstr "" +"<literal>meta-type</literal>（オプション - デフォルトは <literal>string</" +"literal> ）：ディスクリミネータマッピングで許された型" -#: index.docbook:2451 -msgid "<literal>cascade</literal> (optional- defaults to <literal>none</literal>): the cascade style." -msgstr "<literal>java.util.Locale</literal> , <literal>java.util.TimeZone</literal> , <literal>java.util.Currency</literal> から <literal>VARCHAR</literal> （またはOracleの <literal>VARCHAR2</literal> ）への型マッピング。 <literal>Locale</literal> と <literal>Currency</literal> のインスタンスは、それらのISOコードにマッピングされます。 <literal>TimeZone</literal> のインスタンスは、それらの <literal>ID</literal> にマッピングされます。" +#. Tag: para +#: basic_mapping.xml:2451 +#, no-c-format +msgid "" +"<literal>cascade</literal> (optional- defaults to <literal>none</literal>): " +"the cascade style." +msgstr "" +"<literal>cascade</literal>（オプション - デフォルトは <literal>none</" +"literal> ）：カスケードのスタイル。" -#: index.docbook:2463 -msgid "<literal>optimistic-lock</literal> (optional - defaults to <literal>true</literal>): Specifies that updates to this property do or do not require acquisition of the optimistic lock. In other words, define if a version increment should occur if this property is dirty." -msgstr "<literal>java.lang.Class</literal> から <literal>VARCHAR</literal> （またはOracleの <literal>VARCHAR2</literal> ）への型マッピング。 <literal>Class</literal> はその完全修飾された名前にマッピングされます。" +#. Tag: para +#: basic_mapping.xml:2463 +#, no-c-format +msgid "" +"<literal>optimistic-lock</literal> (optional - defaults to <literal>true</" +"literal>): Specifies that updates to this property do or do not require " +"acquisition of the optimistic lock. In other words, define if a version " +"increment should occur if this property is dirty." +msgstr "" +"<literal>optimistic-lock</literal> (オプション - デフォルトは <literal>true</" +"literal> ): このプロパティの更新に楽観ロックの取得を要求するかどうかを指定し" +"ます。言い換えれば、このプロパティがダーティであるときにバージョンを増やすべ" +"きかを定義します。" -#: index.docbook:2478 +#. Tag: title +#: basic_mapping.xml:2478 +#, no-c-format msgid "Hibernate Types" -msgstr "binary" +msgstr "Hibernateの型" -#: index.docbook:2481 +#. Tag: title +#: basic_mapping.xml:2481 +#, no-c-format msgid "Entities and values" -msgstr "バイト配列は、適切なSQLのバイナリ型にマッピングされます。" +msgstr "エンティティと値" -#: index.docbook:2483 -msgid "To understand the behaviour of various Java language-level objects with respect to the persistence service, we need to classify them into two groups:" -msgstr "text" +#. Tag: para +#: basic_mapping.xml:2483 +#, no-c-format +msgid "" +"To understand the behaviour of various Java language-level objects with " +"respect to the persistence service, we need to classify them into two groups:" +msgstr "" +"永続サービスに関わる様々なJava言語レベルのオブジェクトの振る舞いを理解するた" +"めには、オブジェクトを2つのグループに分ける必要があります：" -#: index.docbook:2488 -msgid "An <emphasis>entity</emphasis> exists independently of any other objects holding references to the entity. Contrast this with the usual Java model where an unreferenced object is garbage collected. Entities must be explicitly saved and deleted (except that saves and deletions may be <emphasis>cascaded</emphasis> from a parent entity to its children). This is different from the ODMG model of object persistence by reachablity - and corresponds more closely to how application objects are usually used in large systems. Entities support circular and shared references. They may also be versioned." -msgstr "長いJava文字列は、SQLの <literal>CLOB</literal> または <literal>TEXT</literal> 型にマッピングされます。" +#. Tag: para +#: basic_mapping.xml:2488 +#, no-c-format +msgid "" +"An <emphasis>entity</emphasis> exists independently of any other objects " +"holding references to the entity. Contrast this with the usual Java model " +"where an unreferenced object is garbage collected. Entities must be " +"explicitly saved and deleted (except that saves and deletions may be " +"<emphasis>cascaded</emphasis> from a parent entity to its children). This is " +"different from the ODMG model of object persistence by reachablity - and " +"corresponds more closely to how application objects are usually used in " +"large systems. Entities support circular and shared references. They may " +"also be versioned." +msgstr "" +"<emphasis> エンティティ</emphasis> はエンティティへの参照を保持する、他のす" +"べてのオブジェクトから独立して存在します。参照されないオブジェクトがガベージ" +"コレクトされてしまう性質を持つ通常のJavaモデルと、これを比べてみてくださ" +"い。（親エンティティから子へ、セーブと削除が <emphasis>カスケード</" +"emphasis> されうることを除いて）エンティティは明示的にセーブまたは削除されな" +"ければなりません。これは到達可能性によるオブジェクト永続化のODMGモデルとは異" +"なっています。大規模なシステムでアプリケーションオブジェクトが普通どのように" +"使われるかにより密接に対応します。エンティティは循環と参照の共有をサポートし" +"ます。またそれらはバージョン付けすることもできます。" -#: index.docbook:2499 -msgid "An entity's persistent state consists of references to other entities and instances of <emphasis>value</emphasis> types. Values are primitives, collections (not what's inside a collection), components and certain immutable objects. Unlike entities, values (in particular collections and components) <emphasis>are</emphasis> persisted and deleted by reachability. Since value objects (and primitives) are persisted and deleted along with their containing entity they may not be independently versioned. Values have no independent identity, so they cannot be shared by two entities or collections." -msgstr "serializable" +#. Tag: para +#: basic_mapping.xml:2499 +#, no-c-format +msgid "" +"An entity's persistent state consists of references to other entities and " +"instances of <emphasis>value</emphasis> types. Values are primitives, " +"collections (not what's inside a collection), components and certain " +"immutable objects. Unlike entities, values (in particular collections and " +"components) <emphasis>are</emphasis> persisted and deleted by reachability. " +"Since value objects (and primitives) are persisted and deleted along with " +"their containing entity they may not be independently versioned. Values have " +"no independent identity, so they cannot be shared by two entities or " +"collections." +msgstr "" +"エンティティの永続状態は他のエンティティや <emphasis>値</emphasis> 型のイン" +"スタンスへの参照から構成されます。値はプリミティブ、コレクション(コレクショ" +"ンの内部ではなく)、コンポーネント、不変オブジェクトです。エンティティとは違" +"い、値は（特にコレクションとコンポーネントにおいて）、到達可能性による永続化" +"や削除が <emphasis>行われます</emphasis> 。値オブジェクト（とプリミティブ）" +"は、包含するエンティティと一緒に永続化や削除が行われるので、それらを独立に" +"バージョン付けすることはできません。値には独立したアイデンティティがないの" +"で、複数のエンティティやコレクションがこれを共有することはできません。" -#: index.docbook:2510 -msgid "Up until now, we've been using the term \"persistent class\" to refer to entities. We will continue to do that. Strictly speaking, however, not all user-defined classes with persistent state are entities. A <emphasis>component</emphasis> is a user defined class with value semantics. A Java property of type <literal>java.lang.String</literal> also has value semantics. Given this definition, we can say that all types (classes) provided by the JDK have value type semantics in Java, while user-defined types may be mapped with entity or value type semantics. This decision is up to the application developer. A good hint for an entity class in a domain model are shared references to a single instance of that class, while composition or aggregation usually translates to a value type." -msgstr "シリアライズ可能なJava型は、適切なSQLのバイナリ型にマッピングされます。デフォルトで基本型ではないシリアライズ可能なJavaクラスやインターフェイスの名前を指定することで、 Hibernateの型を <literal>serializable</literal> とすることもできます。" +#. Tag: para +#: basic_mapping.xml:2510 +#, no-c-format +msgid "" +"Up until now, we've been using the term \"persistent class\" to refer to " +"entities. We will continue to do that. Strictly speaking, however, not all " +"user-defined classes with persistent state are entities. A " +"<emphasis>component</emphasis> is a user defined class with value semantics. " +"A Java property of type <literal>java.lang.String</literal> also has value " +"semantics. Given this definition, we can say that all types (classes) " +"provided by the JDK have value type semantics in Java, while user-defined " +"types may be mapped with entity or value type semantics. This decision is up " +"to the application developer. A good hint for an entity class in a domain " +"model are shared references to a single instance of that class, while " +"composition or aggregation usually translates to a value type." +msgstr "" +"これまで「永続クラス」という言葉をエンティティの意味で使ってきました。これか" +"らもそうしていきます。厳密に言うと、永続状態を持つユーザ定義のクラスのすべて" +"がエンティティというわけではありません。 <emphasis>コンポーネント</" +"emphasis> は値のセマンティクスを持つユーザ定義クラスです。 <literal>java." +"lang.String</literal> 型のプロパティもまた値のセマンティクスを持ちます。定義" +"するなら、JDKで提供されているすべてのJavaの型(クラス)が値のセマンティクスを持" +"つといえます。一方ユーザ定義型は、エンティティや値型のセマンティクスとともに" +"マッピングできます。この決定はアプリケーション開発者次第です。そのクラスの" +"１つのインスタンスへの共有参照は、ドメインモデル内のエンティティクラスに対す" +"る良いヒントになります。一方合成集約や集約は、通常値型へ変換されます。" -#: index.docbook:2524 +#. Tag: para +#: basic_mapping.xml:2524 +#, no-c-format msgid "We'll revisit both concepts throughout the documentation." -msgstr "clob, blob" +msgstr "本ドキュメントを通して、何度もこの概念を取り上げます。" -#: index.docbook:2528 -msgid "The challenge is to map the Java type system (and the developers' definition of entities and value types) to the SQL/database type system. The bridge between both systems is provided by Hibernate: for entities we use <literal><class></literal>, <literal><subclass></literal> and so on. For value types we use <literal><property></literal>, <literal><component></literal>, etc, usually with a <literal>type</literal> attribute. The value of this attribute is the name of a Hibernate <emphasis>mapping type</emphasis>. Hibernate provides many mappings (for standard JDK value types) out of the box. You can write your own mapping types and implement your custom conversion strategies as well, as you'll see later." -msgstr "JDBCクラス <literal>java.sql.Clob</literal> と <literal>java.sql.Blob</literal> に対する型マッピング。 blobやclobオブジェクトはトランザクションの外では再利用できないため、アプリケーションによっては不便かもしれません。（さらにはドライバサポートが一貫していません。）" +#. Tag: para +#: basic_mapping.xml:2528 +#, no-c-format +msgid "" +"The challenge is to map the Java type system (and the developers' definition " +"of entities and value types) to the SQL/database type system. The bridge " +"between both systems is provided by Hibernate: for entities we use " +"<literal><class></literal>, <literal><subclass></literal> and so " +"on. For value types we use <literal><property></literal>, <literal><" +"component></literal>, etc, usually with a <literal>type</literal> " +"attribute. The value of this attribute is the name of a Hibernate " +"<emphasis>mapping type</emphasis>. Hibernate provides many mappings (for " +"standard JDK value types) out of the box. You can write your own mapping " +"types and implement your custom conversion strategies as well, as you'll see " +"later." +msgstr "" +"Java型のシステム(もしくは開発者が定義したエンティティと値型)を SQL/データベー" +"ス型のシステムにマッピングすることは難しいです。 Hibernateは２つのシステムの" +"架け橋を提供します。エンティティに対しては <literal><class></literal> " +"や <literal><subclass></literal> などを使用します。値型に対しては " +"<literal><property></literal> や <literal><component></literal> " +"などを、通常 <literal>type</literal> とともに使います。この属性の値は" +"Hibernateの <emphasis>マッピング型</emphasis> の名前です。 Hibernateは(標準" +"JDKの値型に対して)多くの自由なマッピングを提供します。後で見るように、自身の" +"マッピング型を記述し、同様にカスタムの変換戦略を実装することができます。" -#: index.docbook:2541 +#. Tag: para +#: basic_mapping.xml:2541 +#, no-c-format msgid "All built-in Hibernate types except collections support null semantics." -msgstr "imm_date, imm_time, imm_timestamp, imm_calendar, imm_calendar_date, imm_serializable, imm_binary" +msgstr "" +"コレクションを除く組み込みのHibernateの型はすべて、nullセマンティクスをサポー" +"トします。" -#: index.docbook:2548 +#. Tag: title +#: basic_mapping.xml:2548 +#, no-c-format msgid "Basic value types" -msgstr "ほとんどの場合に可変であるJavaの型に対する型マッピング。 Hibernateは不変なJavaの型に対しては最適化を行い、アプリケーションはそれを不変オブジェクトとして扱います。例えば <literal>imm_timestamp</literal> としてマップしたインスタンスに対して、 <literal>Date.setTime()</literal> を呼び出してはなりません。プロパティの値を変更しその変更を永続化するためには、アプリケーションはプロパティに対して新しい(同一でない)オブジェクトを割り当てなければなりません。" +msgstr "基本的な型" -#: index.docbook:2550 -msgid "The built-in <emphasis>basic mapping types</emphasis> may be roughly categorized into" -msgstr "エンティティとコレクションのユニークな識別子は、<literal>binary</literal> , <literal>blob</literal> , <literal>clob</literal> を除く、どんな基本型でも構いません。（複合識別子でも構いません。以下を見てください。）" +#. Tag: para +#: basic_mapping.xml:2550 +#, fuzzy, no-c-format +msgid "" +"The built-in <emphasis>basic mapping types</emphasis> may be roughly " +"categorized into" +msgstr "" +"組み込みの <emphasis>基本的なマッピング型</emphasis> は大まかに以下のように分" +"けられます。 <placeholder-1/>" -#: index.docbook:2555 -msgid "integer, long, short, float, double, character, byte, boolean, yes_no, true_false" -msgstr "基本的な値型には、<literal>org.hibernate.Hibernate</literal> で定義された <literal>Type</literal> 定数がそれぞれあります。例えば、<literal>Hibernate.STRING</literal> は <literal>string</literal> 型を表現しています。" +#. Tag: literal +#: basic_mapping.xml:2555 +#, no-c-format +msgid "" +"integer, long, short, float, double, character, byte, boolean, yes_no, " +"true_false" +msgstr "" +"integer, long, short, float, double, character, byte, boolean, yes_no, " +"true_false" -#: index.docbook:2558 -msgid "Type mappings from Java primitives or wrapper classes to appropriate (vendor-specific) SQL column types. <literal>boolean, yes_no</literal> and <literal>true_false</literal> are all alternative encodings for a Java <literal>boolean</literal> or <literal>java.lang.Boolean</literal>." -msgstr "カスタム型" +#. Tag: para +#: basic_mapping.xml:2558 +#, no-c-format +msgid "" +"Type mappings from Java primitives or wrapper classes to appropriate (vendor-" +"specific) SQL column types. <literal>boolean, yes_no</literal> and " +"<literal>true_false</literal> are all alternative encodings for a Java " +"<literal>boolean</literal> or <literal>java.lang.Boolean</literal>." +msgstr "" +"Javaのプリミティブやラッパークラスから適切な（ベンダー固有の） SQLカラム型へ" +"の型マッピング。 <literal>boolean, yes_no</literal> と <literal>true_false</" +"literal> は、すべてJavaの <literal>boolean</literal> または <literal>java." +"lang.Boolean</literal> の代替エンコードです。" -#: index.docbook:2567 +#. Tag: literal +#: basic_mapping.xml:2567 +#, no-c-format msgid "string" -msgstr "開発者が独自の値型を作成することは、比較的簡単です。例えば、<literal>java.lang.BigInteger</literal> 型のプロパティを <literal>VARCHAR</literal> カラムに永続化したいかもしれません。 Hibernateはこのための組み込み型を用意していません。しかしカスタム型は、プロパティ（またはコレクションの要素）を1つのテーブルカラムにマッピングするのに制限はありません。そのため例えば、<literal>java.lang.String</literal> 型の <literal>getName()</literal> / <literal>setName()</literal> Javaプロパティを <literal>FIRST_NAME</literal> , <literal>INITIAL</literal>, <literal>SURNAME</literal> カラムに永続化できます。" +msgstr "string" -#: index.docbook:2569 -msgid "A type mapping from <literal>java.lang.String</literal> to <literal>VARCHAR</literal> (or Oracle <literal>VARCHAR2</literal>)." -msgstr "カスタム型を実装するには、<literal>org.hibernate.UserType</literal> または <literal>org.hibernate.CompositeUserType</literal> を実装し、型の完全修飾された名前を使ってプロパティを定義します。どのような種類のものが可能かを調べるには、 <literal>org.hibernate.test.DoubleStringType</literal> を確認してください。" +#. Tag: para +#: basic_mapping.xml:2569 +#, no-c-format +msgid "" +"A type mapping from <literal>java.lang.String</literal> to <literal>VARCHAR</" +"literal> (or Oracle <literal>VARCHAR2</literal>)." +msgstr "" +"<literal>java.lang.String</literal> から <literal>VARCHAR</literal> （または" +"Oracleの <literal>VARCHAR2</literal> ）への型マッピング。" -#: index.docbook:2576 +#. Tag: literal +#: basic_mapping.xml:2576 +#, no-c-format msgid "date, time, timestamp" +msgstr "date, time, timestamp" + +#. Tag: para +#: basic_mapping.xml:2578 +#, no-c-format +msgid "" +"Type mappings from <literal>java.util.Date</literal> and its subclasses to " +"SQL types <literal>DATE</literal>, <literal>TIME</literal> and " +"<literal>TIMESTAMP</literal> (or equivalent)." msgstr "" - "<![CDATA[<property name=\"twoStrings\" type=\"org.hibernate.test.DoubleStringType\"> -\n" - " <column name=\"first_string\"/> -\n" - " <column name=\"second_string\"/> -\n" - "</property>]]>" +"<literal>java.util.Date</literal> とそのサブクラスからSQL型の <literal>DATE</" +"literal>, <literal>TIME</literal> , <literal>TIMESTAMP</literal> （またはそれ" +"らと等価なもの）への型マッピング。" -#: index.docbook:2578 -msgid "Type mappings from <literal>java.util.Date</literal> and its subclasses to SQL types <literal>DATE</literal>, <literal>TIME</literal> and <literal>TIMESTAMP</literal> (or equivalent)." -msgstr "<literal><column></literal> タグで、プロパティを複数のカラムへマッピングできることに注目してください。" - -#: index.docbook:2586 +#. Tag: literal +#: basic_mapping.xml:2586 +#, no-c-format msgid "calendar, calendar_date" -msgstr "<literal>CompositeUserType</literal> , <literal>EnhancedUserType</literal> , <literal>UserCollectionType</literal> , <literal>UserVersionType</literal> インターフェイスは、より特殊な使用法に対してのサポートを提供します。" +msgstr "calendar, calendar_date" -#: index.docbook:2588 -msgid "Type mappings from <literal>java.util.Calendar</literal> to SQL types <literal>TIMESTAMP</literal> and <literal>DATE</literal> (or equivalent)." -msgstr "マッピングファイル内で <literal>UserType</literal> へパラメータを提供できます。このためには、<literal>UserType</literal> は <literal>org.hibernate.usertype.ParameterizedType</literal> を実装しなくてはなりません。カスタム型パラメータを提供するために、マッピングファイル内で <literal><type></literal> 要素を使用できます。" +#. Tag: para +#: basic_mapping.xml:2588 +#, no-c-format +msgid "" +"Type mappings from <literal>java.util.Calendar</literal> to SQL types " +"<literal>TIMESTAMP</literal> and <literal>DATE</literal> (or equivalent)." +msgstr "" +"<literal>java.util.Calendar</literal> からSQL型の「 <literal>TIMESTAMP</" +"literal> , <literal>DATE</literal> (またはそれらと等価なもの）への型マッピン" +"グ。" -#: index.docbook:2596 +#. Tag: literal +#: basic_mapping.xml:2596 +#, no-c-format msgid "big_decimal, big_integer" +msgstr "big_decimal, big_integer" + +#. Tag: para +#: basic_mapping.xml:2598 +#, no-c-format +msgid "" +"Type mappings from <literal>java.math.BigDecimal</literal> and <literal>java." +"math.BigInteger</literal> to <literal>NUMERIC</literal> (or Oracle " +"<literal>NUMBER</literal>)." msgstr "" - "<![CDATA[<property name=\"priority\"> -\n" - " <type name=\"com.mycompany.usertypes.DefaultValueIntegerType\"> -\n" - " <param name=\"default\">0</param> -\n" - " </type> -\n" - "</property>]]>" +"<literal>java.math.BigDecimal</literal> と <literal>java.math.BigInteger</" +"literal> から <literal>NUMERIC</literal>（またはOracleの <literal>NUMBER</" +"literal> ）への型マッピング。" -#: index.docbook:2598 -msgid "Type mappings from <literal>java.math.BigDecimal</literal> and <literal>java.math.BigInteger</literal> to <literal>NUMERIC</literal> (or Oracle <literal>NUMBER</literal>)." -msgstr "<literal>UserType</literal> は、引数として渡された <literal>Properties</literal> オブジェクトから、 <literal>default</literal> で指定したパラメータに対する値を検索することができます。" - -#: index.docbook:2606 +#. Tag: literal +#: basic_mapping.xml:2606 +#, no-c-format msgid "locale, timezone, currency" -msgstr "特定の <literal>UserType</literal> を頻繁に使用するならば、短い名前を定義すると便利になるでしょう。 <literal><typedef></literal> 要素を使ってこのようなことが行えます。 Typedefsはカスタム型に名前を割り当てます。その型がパラメータを持つならば、パラメータのデフォルト値のリストを含むこともできます。" +msgstr "locale, timezone, currency" -#: index.docbook:2608 -msgid "Type mappings from <literal>java.util.Locale</literal>, <literal>java.util.TimeZone</literal> and <literal>java.util.Currency</literal> to <literal>VARCHAR</literal> (or Oracle <literal>VARCHAR2</literal>). Instances of <literal>Locale</literal> and <literal>Currency</literal> are mapped to their ISO codes. Instances of <literal>TimeZone</literal> are mapped to their <literal>ID</literal>." +#. Tag: para +#: basic_mapping.xml:2608 +#, no-c-format +msgid "" +"Type mappings from <literal>java.util.Locale</literal>, <literal>java.util." +"TimeZone</literal> and <literal>java.util.Currency</literal> to " +"<literal>VARCHAR</literal> (or Oracle <literal>VARCHAR2</literal>). " +"Instances of <literal>Locale</literal> and <literal>Currency</literal> are " +"mapped to their ISO codes. Instances of <literal>TimeZone</literal> are " +"mapped to their <literal>ID</literal>." msgstr "" - "<![CDATA[<typedef class=\"com.mycompany.usertypes.DefaultValueIntegerType\" name=\"default_zero\"> -\n" - " <param name=\"default\">0</param> -\n" - "</typedef>]]>" +"<literal>java.util.Locale</literal> , <literal>java.util.TimeZone</" +"literal> , <literal>java.util.Currency</literal> から <literal>VARCHAR</" +"literal> （またはOracleの <literal>VARCHAR2</literal> ）への型マッピング。 " +"<literal>Locale</literal> と <literal>Currency</literal> のインスタンスは、 " +"それらのISOコードにマッピングされます。 <literal>TimeZone</literal> のインス" +"タンスは、それらの <literal>ID</literal> にマッピングされます。" -#: index.docbook:2620 +#. Tag: literal +#: basic_mapping.xml:2620 +#, fuzzy, no-c-format msgid "<literal>class</literal>" -msgstr "<![CDATA[<property name=\"priority\" type=\"default_zero\"/>]]>" +msgstr "<literal>all</literal> すべてのカラムをチェックします。" -#: index.docbook:2622 -msgid "A type mapping from <literal>java.lang.Class</literal> to <literal>VARCHAR</literal> (or Oracle <literal>VARCHAR2</literal>). A <literal>Class</literal> is mapped to its fully qualified name." -msgstr "プロパティのマッピングで型パラメータを使うことで、 typedefで提供されたパラメータをその都度オーバーライドすることが可能です。" +#. Tag: para +#: basic_mapping.xml:2622 +#, no-c-format +msgid "" +"A type mapping from <literal>java.lang.Class</literal> to <literal>VARCHAR</" +"literal> (or Oracle <literal>VARCHAR2</literal>). A <literal>Class</literal> " +"is mapped to its fully qualified name." +msgstr "" +"<literal>java.lang.Class</literal> から <literal>VARCHAR</literal> （または" +"Oracleの <literal>VARCHAR2</literal> ）への型マッピング。 <literal>Class</" +"literal> はその完全修飾された名前にマッピングされます。" -#: index.docbook:2630 +#. Tag: literal +#: basic_mapping.xml:2630 +#, no-c-format msgid "binary" -msgstr "Hibernateの幅広い組み込み型とコンポーネントに対するサポートは、カスタム型をめったに <emphasis>使わない</emphasis> ということを意味します。それでもなお、アプリケーションで頻出する(エンティティではない)クラスに対するカスタム型の使用は、よいやり方であるとみなされます。例えば <literal>MonetaryAmount</literal> クラスはコンポーネントとして簡単にマッピングできますが、 <literal>CompositeUserType</literal> の良い候補です。カスタム型を使用する動機の1つは抽象化です。カスタム型を使うことで、通貨をどのように表現しようともマッピングドキュメントは起こりうる変化に対応できます。" +msgstr "binary" -#: index.docbook:2632 +#. Tag: para +#: basic_mapping.xml:2632 +#, no-c-format msgid "Maps byte arrays to an appropriate SQL binary type." -msgstr "１つのクラスに１つ以上のマッピング" +msgstr "バイト配列は、適切なSQLのバイナリ型にマッピングされます。" -#: index.docbook:2638 +#. Tag: literal +#: basic_mapping.xml:2638 +#, no-c-format msgid "text" -msgstr "ある永続クラスに、一つ以上のマッピングを提供することが出来ます。この場合、マッピングする２つのエンティティのインスタンスを明確にするために、 <emphasis>エンティティ名</emphasis> を指定しなければなりません (デフォルトではエンティティ名はクラス名と同じです。)。永続オブジェクトを扱うとき、クエリを書き込むとき、指定されたエンティティへの関連をマッピングするときには、 Hibernateではエンティティ名を指定しなければなりません。" +msgstr "text" -#: index.docbook:2640 -msgid "Maps long Java strings to a SQL <literal>CLOB</literal> or <literal>TEXT</literal> type." +#. Tag: para +#: basic_mapping.xml:2640 +#, no-c-format +msgid "" +"Maps long Java strings to a SQL <literal>CLOB</literal> or <literal>TEXT</" +"literal> type." msgstr "" - "<![CDATA[<class name=\"Contract\" table=\"Contracts\" -\n" - " entity-name=\"CurrentContract\"> -\n" - " ... -\n" - " <set name=\"history\" inverse=\"true\" -\n" - " order-by=\"effectiveEndDate desc\"> -\n" - " <key column=\"currentContractId\"/> -\n" - " <one-to-many entity-name=\"HistoricalContract\"/> -\n" - " </set> -\n" - "</class> -\n" - " -\n" - "<class name=\"Contract\" table=\"ContractHistory\" -\n" - " entity-name=\"HistoricalContract\"> -\n" - " ... -\n" - " <many-to-one name=\"currentContract\" -\n" - " column=\"currentContractId\" -\n" - " entity-name=\"CurrentContract\"/> -\n" - "</class>]]>" +"長いJava文字列は、SQLの <literal>CLOB</literal> または <literal>TEXT</" +"literal> 型にマッピングされます。" -#: index.docbook:2647 +#. Tag: literal +#: basic_mapping.xml:2647 +#, no-c-format msgid "serializable" -msgstr "関連が<literal>class</literal> の代わりに <literal>entity-name</literal> を使って、どのように指定されるのかに注目してください。" +msgstr "serializable" -#: index.docbook:2649 -msgid "Maps serializable Java types to an appropriate SQL binary type. You may also indicate the Hibernate type <literal>serializable</literal> with the name of a serializable Java class or interface that does not default to a basic type." -msgstr "バッククォートで囲んだ SQL 識別子" +#. Tag: para +#: basic_mapping.xml:2649 +#, no-c-format +msgid "" +"Maps serializable Java types to an appropriate SQL binary type. You may also " +"indicate the Hibernate type <literal>serializable</literal> with the name of " +"a serializable Java class or interface that does not default to a basic type." +msgstr "" +"シリアライズ可能なJava型は、適切なSQLのバイナリ型にマッピングされます。デ" +"フォルトで基本型ではないシリアライズ可能なJavaクラスやインターフェイスの名前" +"を指定することで、 Hibernateの型を <literal>serializable</literal> とすること" +"もできます。" -#: index.docbook:2658 +#. Tag: literal +#: basic_mapping.xml:2658 +#, no-c-format msgid "clob, blob" -msgstr "マッピングドキュメントでテーブルやカラムの名前をバッククォートで囲むことで、 Hibernateで生成されたSQL中の識別子を引用させることができます。 HibernateはSQLの <literal>Dialect</literal> に対応する、正しい引用スタイルを使います（普通はダブルクォートですが、SQL Serverではかぎ括弧、MySQLではバッククォートです）。" +msgstr "clob, blob" -#: index.docbook:2660 -msgid "Type mappings for the JDBC classes <literal>java.sql.Clob</literal> and <literal>java.sql.Blob</literal>. These types may be inconvenient for some applications, since the blob or clob object may not be reused outside of a transaction. (Furthermore, driver support is patchy and inconsistent.)" +#. Tag: para +#: basic_mapping.xml:2660 +#, no-c-format +msgid "" +"Type mappings for the JDBC classes <literal>java.sql.Clob</literal> and " +"<literal>java.sql.Blob</literal>. These types may be inconvenient for some " +"applications, since the blob or clob object may not be reused outside of a " +"transaction. (Furthermore, driver support is patchy and inconsistent.)" msgstr "" - "<![CDATA[<class name=\"LineItem\" table=\"`Line Item`\"> -\n" - " <id name=\"id\" column=\"`Item Id`\"/><generator class=\"assigned\"/></id> -\n" - " <property name=\"itemNumber\" column=\"`Item #`\"/> -\n" - " ... -\n" - "</class>]]>" +"JDBCクラス <literal>java.sql.Clob</literal> と <literal>java.sql.Blob</" +"literal> に対する型マッピング。 blobやclobオブジェクトはトランザクションの外" +"では再利用できないため、アプリケーションによっては不便かもしれません。（さ" +"らにはドライバサポートが一貫していません。）" -#: index.docbook:2670 -msgid "imm_date, imm_time, imm_timestamp, imm_calendar, imm_calendar_date, imm_serializable, imm_binary" -msgstr "メタデータの代替手段" +#. Tag: literal +#: basic_mapping.xml:2670 +#, no-c-format +msgid "" +"imm_date, imm_time, imm_timestamp, imm_calendar, imm_calendar_date, " +"imm_serializable, imm_binary" +msgstr "" +"imm_date, imm_time, imm_timestamp, imm_calendar, imm_calendar_date, " +"imm_serializable, imm_binary" -#: index.docbook:2674 -msgid "Type mappings for what are usually considered mutable Java types, where Hibernate makes certain optimizations appropriate only for immutable Java types, and the application treats the object as immutable. For example, you should not call <literal>Date.setTime()</literal> for an instance mapped as <literal>imm_timestamp</literal>. To change the value of the property, and have that change made persistent, the application must assign a new (nonidentical) object to the property." -msgstr "XMLの記述以外に、 HibernateではO/Rマッピングのメタデータを定義する代替方法があります。" +#. Tag: para +#: basic_mapping.xml:2674 +#, no-c-format +msgid "" +"Type mappings for what are usually considered mutable Java types, where " +"Hibernate makes certain optimizations appropriate only for immutable Java " +"types, and the application treats the object as immutable. For example, you " +"should not call <literal>Date.setTime()</literal> for an instance mapped as " +"<literal>imm_timestamp</literal>. To change the value of the property, and " +"have that change made persistent, the application must assign a new " +"(nonidentical) object to the property." +msgstr "" +"ほとんどの場合に可変であるJavaの型に対する型マッピング。 Hibernateは不変な" +"Javaの型に対しては最適化を行い、アプリケーションはそれを不変オブジェクトとし" +"て扱います。例えば <literal>imm_timestamp</literal> としてマップしたインスタ" +"ンスに対して、 <literal>Date.setTime()</literal> を呼び出してはなりません。 " +"プロパティの値を変更しその変更を永続化するためには、アプリケーションはプロパ" +"ティに対して新しい(同一でない)オブジェクトを割り当てなければなりません。" -#: index.docbook:2689 -msgid "Unique identifiers of entities and collections may be of any basic type except <literal>binary</literal>, <literal>blob</literal> and <literal>clob</literal>. (Composite identifiers are also allowed, see below.)" -msgstr "XDoclet マークアップの使用" +#. Tag: para +#: basic_mapping.xml:2689 +#, no-c-format +msgid "" +"Unique identifiers of entities and collections may be of any basic type " +"except <literal>binary</literal>, <literal>blob</literal> and <literal>clob</" +"literal>. (Composite identifiers are also allowed, see below.)" +msgstr "" +"エンティティとコレクションのユニークな識別子は、<literal>binary</literal> , " +"<literal>blob</literal> , <literal>clob</literal> を除く、どんな基本型でも構" +"いません。（複合識別子でも構いません。以下を見てください。）" -#: index.docbook:2695 -msgid "The basic value types have corresponding <literal>Type</literal> constants defined on <literal>org.hibernate.Hibernate</literal>. For example, <literal>Hibernate.STRING</literal> represents the <literal>string</literal> type." -msgstr "多くのHibernateユーザはXDocletの <literal>@hibernate.tags</literal> を使って、ソースコード内に直接マッピング情報を埋め込むことを好みます。これは厳密に言えばXDocletの分野なので、本ドキュメントではこの方法を対象とはしません。しかしXDocletを使った以下の <literal>Cat</literal> マッピングの例を示します。" +#. Tag: para +#: basic_mapping.xml:2695 +#, no-c-format +msgid "" +"The basic value types have corresponding <literal>Type</literal> constants " +"defined on <literal>org.hibernate.Hibernate</literal>. For example, " +"<literal>Hibernate.STRING</literal> represents the <literal>string</literal> " +"type." +msgstr "" +"基本的な値型には、<literal>org.hibernate.Hibernate</literal> で定義された " +"<literal>Type</literal> 定数がそれぞれあります。例えば、<literal>Hibernate." +"STRING</literal> は <literal>string</literal> 型を表現しています。" -#: index.docbook:2704 +#. Tag: title +#: basic_mapping.xml:2704 +#, no-c-format msgid "Custom value types" +msgstr "カスタム型" + +#. Tag: para +#: basic_mapping.xml:2706 +#, no-c-format +msgid "" +"It is relatively easy for developers to create their own value types. For " +"example, you might want to persist properties of type <literal>java.lang." +"BigInteger</literal> to <literal>VARCHAR</literal> columns. Hibernate does " +"not provide a built-in type for this. But custom types are not limited to " +"mapping a property (or collection element) to a single table column. So, for " +"example, you might have a Java property <literal>getName()</literal>/" +"<literal>setName()</literal> of type <literal>java.lang.String</literal> " +"that is persisted to the columns <literal>FIRST_NAME</literal>, " +"<literal>INITIAL</literal>, <literal>SURNAME</literal>." msgstr "" - "<![CDATA[package eg; -\n" - "import java.util.Set; -\n" - "import java.util.Date; -\n" - " -\n" - "/** -\n" - " * @hibernate.class -\n" - " * table=\"CATS\" -\n" - " */ -\n" - "public class Cat { -\n" - " private Long id; // identifier -\n" - " private Date birthdate; -\n" - " private Cat mother; -\n" - " private Set kittens -\n" - " private Color color; -\n" - " private char sex; -\n" - " private float weight; -\n" - " -\n" - " /* -\n" - " * @hibernate.id -\n" - " * generator-class=\"native\" -\n" - " * column=\"CAT_ID\" -\n" - " */ -\n" - " public Long getId() { -\n" - " return id; -\n" - " } -\n" - " private void setId(Long id) { -\n" - " this.id=id; -\n" - " } -\n" - " -\n" - " /** -\n" - " * @hibernate.many-to-one -\n" - " * column=\"PARENT_ID\" -\n" - " */ -\n" - " public Cat getMother() { -\n" - " return mother; -\n" - " } -\n" - " void setMother(Cat mother) { -\n" - " this.mother = mother; -\n" - " } -\n" - " -\n" - " /** -\n" - " * @hibernate.property -\n" - " * column=\"BIRTH_DATE\" -\n" - " */ -\n" - " public Date getBirthdate() { -\n" - " return birthdate; -\n" - " } -\n" - " void setBirthdate(Date date) { -\n" - " birthdate = date; -\n" - " } -\n" - " /** -\n" - " * @hibernate.property -\n" - " * column=\"WEIGHT\" -\n" - " */ -\n" - " public float getWeight() { -\n" - " return weight; -\n" - " } -\n" - " void setWeight(float weight) { -\n" - " this.weight = weight; -\n" - " } -\n" - " -\n" - " /** -\n" - " * @hibernate.property -\n" - " * column=\"COLOR\" -\n" - " * not-null=\"true\" -\n" - " */ -\n" - " public Color getColor() { -\n" - " return color; -\n" - " } -\n" - " void setColor(Color color) { -\n" - " this.color = color; -\n" - " } -\n" - " /** -\n" - " * @hibernate.set -\n" - " * inverse=\"true\" -\n" - " * order-by=\"BIRTH_DATE\" -\n" - " * @hibernate.collection-key -\n" - " * column=\"PARENT_ID\" -\n" - " * @hibernate.collection-one-to-many -\n" - " */ -\n" - " public Set getKittens() { -\n" - " return kittens; -\n" - " } -\n" - " void setKittens(Set kittens) { -\n" - " this.kittens = kittens; -\n" - " } -\n" - " // addKitten not needed by Hibernate -\n" - " public void addKitten(Cat kitten) { -\n" - " kittens.add(kitten); -\n" - " } -\n" - " -\n" - " /** -\n" - " * @hibernate.property -\n" - " * column=\"SEX\" -\n" - " * not-null=\"true\" -\n" - " * update=\"false\" -\n" - " */ -\n" - " public char getSex() { -\n" - " return sex; -\n" - " } -\n" - " void setSex(char sex) { -\n" - " this.sex=sex; -\n" - " } -\n" - "}]]>" +"開発者が独自の値型を作成することは、比較的簡単です。例えば、<literal>java." +"lang.BigInteger</literal> 型のプロパティを <literal>VARCHAR</literal> カラム" +"に永続化したいかもしれません。 Hibernateはこのための組み込み型を用意していま" +"せん。しかしカスタム型は、プロパティ（またはコレクションの要素）を1つのテー" +"ブルカラムにマッピングするのに制限はありません。そのため例えば、" +"<literal>java.lang.String</literal> 型の <literal>getName()</literal> / " +"<literal>setName()</literal> Javaプロパティを <literal>FIRST_NAME</" +"literal> , <literal>INITIAL</literal>, <literal>SURNAME</literal> カラムに永" +"続化できます。" -#: index.docbook:2706 -msgid "It is relatively easy for developers to create their own value types. For example, you might want to persist properties of type <literal>java.lang.BigInteger</literal> to <literal>VARCHAR</literal> columns. Hibernate does not provide a built-in type for this. But custom types are not limited to mapping a property (or collection element) to a single table column. So, for example, you might have a Java property <literal>getName()</literal>/<literal>setName()</literal> of type <literal>java.lang.String</literal> that is persisted to the columns <literal>FIRST_NAME</literal>, <literal>INITIAL</literal>, <literal>SURNAME</literal>." -msgstr "Hibernateのウェブサイトには、XDocletとHibernateに関するサンプルが多数あります。" +#. Tag: para +#: basic_mapping.xml:2717 +#, no-c-format +msgid "" +"To implement a custom type, implement either <literal>org.hibernate." +"UserType</literal> or <literal>org.hibernate.CompositeUserType</literal> and " +"declare properties using the fully qualified classname of the type. Check " +"out <literal>org.hibernate.test.DoubleStringType</literal> to see the kind " +"of things that are possible." +msgstr "" +"カスタム型を実装するには、<literal>org.hibernate.UserType</literal> または " +"<literal>org.hibernate.CompositeUserType</literal> を実装し、型の完全修飾さ" +"れた名前を使ってプロパティを定義します。どのような種類のものが可能かを調べる" +"には、 <literal>org.hibernate.test.DoubleStringType</literal> を確認してくだ" +"さい。" -#: index.docbook:2717 -msgid "To implement a custom type, implement either <literal>org.hibernate.UserType</literal> or <literal>org.hibernate.CompositeUserType</literal> and declare properties using the fully qualified classname of the type. Check out <literal>org.hibernate.test.DoubleStringType</literal> to see the kind of things that are possible." -msgstr "JDK 5.0 アノテーションの使用" +#. Tag: programlisting +#: basic_mapping.xml:2725 +#, no-c-format +msgid "" +"<![CDATA[<property name=\"twoStrings\" type=\"org.hibernate.test." +"DoubleStringType\">\n" +" <column name=\"first_string\"/>\n" +" <column name=\"second_string\"/>\n" +"</property>]]>" +msgstr "" -#: index.docbook:2725 +#. Tag: para +#: basic_mapping.xml:2727 +#, no-c-format msgid "" - "<![CDATA[<property name=\"twoStrings\" type=\"org.hibernate.test.DoubleStringType\">\n" - " <column name=\"first_string\"/>\n" - " <column name=\"second_string\"/>\n" - "</property>]]>" -msgstr "JDK5.0ではタイプセーフかつコンパイル時にチェックできる、言語レベルのXDocletスタイルのアノテーションを導入しました。このメカニズムはXDocletのアノテーションよりも強力で、ツールやIDEも多くがサポートしています。例えばIntelliJ IDEAは、JDK5.0にアノテーションの自動補完と構文の強調表示をサポートしています。 EJB仕様 (JSR-220)の新しいバージョンでは、エンティティビーンに対する主要なメタデータメカニズムとして JDK5.0のアノテーションを使用しています。 Hibernate3ではJSR-220 (永続化API)の <literal>EntityManager</literal> を実装し、メタデータマッピングに対するサポートは、別ダウンロードの <emphasis>Hibernate Annotations</emphasis> パッケージにより利用可能です。これはEJB3(JSR-220)とHibernate3のメタデータをどちらもサポート! しています。" +"Notice the use of <literal><column></literal> tags to map a property " +"to multiple columns." +msgstr "" +"<literal><column></literal> タグで、プロパティを複数のカラムへマッピン" +"グできることに注目してください。" -#: index.docbook:2727 -msgid "Notice the use of <literal><column></literal> tags to map a property to multiple columns." -msgstr "以下はEJBのエンティティビーンとして注釈されたPOJOクラスの例です。" +#. Tag: para +#: basic_mapping.xml:2732 +#, no-c-format +msgid "" +"The <literal>CompositeUserType</literal>, <literal>EnhancedUserType</" +"literal>, <literal>UserCollectionType</literal>, and " +"<literal>UserVersionType</literal> interfaces provide support for more " +"specialized uses." +msgstr "" +"<literal>CompositeUserType</literal> , <literal>EnhancedUserType</literal> , " +"<literal>UserCollectionType</literal> , <literal>UserVersionType</literal> イ" +"ンターフェイスは、より特殊な使用法に対してのサポートを提供します。" -#: index.docbook:2732 -msgid "The <literal>CompositeUserType</literal>, <literal>EnhancedUserType</literal>, <literal>UserCollectionType</literal>, and <literal>UserVersionType</literal> interfaces provide support for more specialized uses." +#. Tag: para +#: basic_mapping.xml:2738 +#, no-c-format +msgid "" +"You may even supply parameters to a <literal>UserType</literal> in the " +"mapping file. To do this, your <literal>UserType</literal> must implement " +"the <literal>org.hibernate.usertype.ParameterizedType</literal> interface. " +"To supply parameters to your custom type, you can use the <literal><" +"type></literal> element in your mapping files." msgstr "" - "<![CDATA[@Entity(access = AccessType.FIELD) -\n" - "public class Customer implements Serializable { -\n" - " -\n" - " @Id; -\n" - " Long id; -\n" - " -\n" - " String firstName; -\n" - " String lastName; -\n" - " Date birthday; -\n" - " -\n" - " @Transient -\n" - " Integer age; -\n" - " -\n" - " @Embedded -\n" - " private Address homeAddress; -\n" - " -\n" - " @OneToMany(cascade=CascadeType.ALL) -\n" - " @JoinColumn(name=\"CUSTOMER_ID\") -\n" - " Set<Order> orders; -\n" - " -\n" - " // Getter/setter and business methods -\n" - "}]]>" +"マッピングファイル内で <literal>UserType</literal> へパラメータを提供できま" +"す。このためには、<literal>UserType</literal> は <literal>org.hibernate." +"usertype.ParameterizedType</literal> を実装しなくてはなりません。カスタム型" +"パラメータを提供するために、マッピングファイル内で <literal><type></" +"literal> 要素を使用できます。" -#: index.docbook:2738 -msgid "You may even supply parameters to a <literal>UserType</literal> in the mapping file. To do this, your <literal>UserType</literal> must implement the <literal>org.hibernate.usertype.ParameterizedType</literal> interface. To supply parameters to your custom type, you can use the <literal><type></literal> element in your mapping files." -msgstr "JDK5.0のアノテーション(とJSR-220)のサポートは進行中の作業であり、完全ではないことに注意してください。さらに詳しい情報はHibernateのアノテーション・モジュールを参照してください。" +#. Tag: programlisting +#: basic_mapping.xml:2746 +#, no-c-format +msgid "" +"<![CDATA[<property name=\"priority\">\n" +" <type name=\"com.mycompany.usertypes.DefaultValueIntegerType\">\n" +" <param name=\"default\">0</param>\n" +" </type>\n" +"</property>]]>" +msgstr "" -#: index.docbook:2746 +#. Tag: para +#: basic_mapping.xml:2748 +#, no-c-format msgid "" - "<![CDATA[<property name=\"priority\">\n" - " <type name=\"com.mycompany.usertypes.DefaultValueIntegerType\">\n" - " <param name=\"default\">0</param>\n" - " </type>\n" - "</property>]]>" -msgstr "生成プロパティ" +"The <literal>UserType</literal> can now retrieve the value for the parameter " +"named <literal>default</literal> from the <literal>Properties</literal> " +"object passed to it." +msgstr "" +"<literal>UserType</literal> は、引数として渡された <literal>Properties</" +"literal> オブジェクトから、 <literal>default</literal> で指定したパラメータに" +"対する値を検索することができます。" -#: index.docbook:2748 -msgid "The <literal>UserType</literal> can now retrieve the value for the parameter named <literal>default</literal> from the <literal>Properties</literal> object passed to it." -msgstr "生成プロパティとは、データベースによって生成された値を持つプロパティです。通常、Hibernateアプリケーションは、データベースが値を生成したプロパティを含むオブジェクトを <literal>リフレッシュ</literal> する必要がありました。しかし、プロパティが生成されたということをマークすることで、アプリケーションはリフレッシュの責任をHibernateに委譲します。基本的に、生成プロパティを持つと定義したエンティティに対して HibernateがINSERTやUPDATEのSQLを発行した後すぐに、生成された値を読み込むための SELECT SQL が発行されます。" +#. Tag: para +#: basic_mapping.xml:2753 +#, no-c-format +msgid "" +"If you use a certain <literal>UserType</literal> very often, it may be " +"useful to define a shorter name for it. You can do this using the " +"<literal><typedef></literal> element. Typedefs assign a name to a " +"custom type, and may also contain a list of default parameter values if the " +"type is parameterized." +msgstr "" +"特定の <literal>UserType</literal> を頻繁に使用するならば、短い名前を定義する" +"と便利になるでしょう。 <literal><typedef></literal> 要素を使ってこのよ" +"うなことが行えます。 Typedefsはカスタム型に名前を割り当てます。その型がパラ" +"メータを持つならば、パラメータのデフォルト値のリストを含むこともできます。" -#: index.docbook:2753 -msgid "If you use a certain <literal>UserType</literal> very often, it may be useful to define a shorter name for it. You can do this using the <literal><typedef></literal> element. Typedefs assign a name to a custom type, and may also contain a list of default parameter values if the type is parameterized." -msgstr "生成プロパティは、挿入不可能かつ更新不可能でなければなりません。 <xref linkend=\"mapping-declaration-version\"/>versions 、 <xref linkend=\"mapping-declaration-timestamp\"/>timestamps 、 <xref linkend=\"mapping-declaration-property\"/>simple properties だけが生成されたとマークできます。" - -#: index.docbook:2760 +#. Tag: programlisting +#: basic_mapping.xml:2760 +#, no-c-format msgid "" - "<![CDATA[<typedef class=\"com.mycompany.usertypes.DefaultValueIntegerType\" name=\"default_zero\">\n" - " <param name=\"default\">0</param>\n" - "</typedef>]]>" -msgstr "<literal>never</literal> (デフォルト) - 与えられたプロパティの値は、データベースから生成されないことを意味します。" +"<![CDATA[<typedef class=\"com.mycompany.usertypes.DefaultValueIntegerType\" " +"name=\"default_zero\">\n" +" <param name=\"default\">0</param>\n" +"</typedef>]]>" +msgstr "" -#: index.docbook:2762 +#. Tag: programlisting +#: basic_mapping.xml:2762 +#, no-c-format msgid "<![CDATA[<property name=\"priority\" type=\"default_zero\"/>]]>" -msgstr "<literal>insert</literal> - 与えられたプロパティの値は挿入時に生成されるが、続いて起こる更新時には生成されないこと示します。作成された日付などは、このカテゴリに分類されます。 <xref linkend=\"mapping-declaration-version\"/>version や <xref linkend=\"mapping-declaration-timestamp\"/>timestamp のプロパティは生成されたとマークできますが、このオプションは利用できないことに注意してください。" +msgstr "" -#: index.docbook:2764 -msgid "It is also possible to override the parameters supplied in a typedef on a case-by-case basis by using type parameters on the property mapping." -msgstr "<literal>always</literal> - 挿入時も更新時もプロパティの値が生成されることを示します。" +#. Tag: para +#: basic_mapping.xml:2764 +#, no-c-format +msgid "" +"It is also possible to override the parameters supplied in a typedef on a " +"case-by-case basis by using type parameters on the property mapping." +msgstr "" +"プロパティのマッピングで型パラメータを使うことで、 typedefで提供されたパラ" +"メータをその都度オーバーライドすることが可能です。" -#: index.docbook:2769 -msgid "Even though Hibernate's rich range of built-in types and support for components means you will very rarely <emphasis>need</emphasis> to use a custom type, it is nevertheless considered good form to use custom types for (non-entity) classes that occur frequently in your application. For example, a <literal>MonetaryAmount</literal> class is a good candidate for a <literal>CompositeUserType</literal>, even though it could easily be mapped as a component. One motivation for this is abstraction. With a custom type, your mapping documents would be future-proofed against possible changes in your way of representing monetary values." -msgstr "補助的なデータベース・オブジェクト" +#. Tag: para +#: basic_mapping.xml:2769 +#, no-c-format +msgid "" +"Even though Hibernate's rich range of built-in types and support for " +"components means you will very rarely <emphasis>need</emphasis> to use a " +"custom type, it is nevertheless considered good form to use custom types for " +"(non-entity) classes that occur frequently in your application. For example, " +"a <literal>MonetaryAmount</literal> class is a good candidate for a " +"<literal>CompositeUserType</literal>, even though it could easily be mapped " +"as a component. One motivation for this is abstraction. With a custom type, " +"your mapping documents would be future-proofed against possible changes in " +"your way of representing monetary values." +msgstr "" +"Hibernateの幅広い組み込み型とコンポーネントに対するサポートは、カスタム型を" +"めったに <emphasis>使わない</emphasis> ということを意味します。それでもな" +"お、アプリケーションで頻出する(エンティティではない)クラスに対するカスタム型" +"の使用は、よいやり方であるとみなされます。例えば <literal>MonetaryAmount</" +"literal> クラスはコンポーネントとして簡単にマッピングできますが、 " +"<literal>CompositeUserType</literal> の良い候補です。カスタム型を使用する動" +"機の1つは抽象化です。カスタム型を使うことで、通貨をどのように表現しようとも " +"マッピングドキュメントは起こりうる変化に対応できます。" -#: index.docbook:2785 +#. Tag: title +#: basic_mapping.xml:2785 +#, no-c-format msgid "Mapping a class more than once" -msgstr "Hibernateのスキーマ・エボリューションツールと連動することで、任意のデータベース・オブジェクト（トリガーやストアドプロシージャなど）のCREATEとDROPにより、 Hibernateのマッピングファイル内のユーザ・スキーマをすべて定義することが出来ます。主にトリガやストアドプロシージャのようなデータベース・オブジェクトを生成や削除することを意図していますが、実際には <literal>java.sql.Statement.execute()</literal> メソッドによって実行できる任意のSQLコマンド（ALTER、INSERTなど）が実行できます。補助的なデータベース・オブジェクトを定義するための、2つの基本的な方法があります。" +msgstr "１つのクラスに１つ以上のマッピング" -#: index.docbook:2786 -msgid "It is possible to provide more than one mapping for a particular persistent class. In this case you must specify an <emphasis>entity name</emphasis> do disambiguate between instances of the two mapped entities. (By default, the entity name is the same as the class name.) Hibernate lets you specify the entity name when working with persistent objects, when writing queries, or when mapping associations to the named entity." -msgstr "1つ目の方法は、CREATEとDROPコマンドをマッピングファイルの外に、明示的に記載することです。" +#. Tag: para +#: basic_mapping.xml:2786 +#, no-c-format +msgid "" +"It is possible to provide more than one mapping for a particular persistent " +"class. In this case you must specify an <emphasis>entity name</emphasis> do " +"disambiguate between instances of the two mapped entities. (By default, the " +"entity name is the same as the class name.) Hibernate lets you specify the " +"entity name when working with persistent objects, when writing queries, or " +"when mapping associations to the named entity." +msgstr "" +"ある永続クラスに、一つ以上のマッピングを提供することが出来ます。この場合、" +"マッピングする２つのエンティティのインスタンスを明確にするために、 <emphasis>" +"エンティティ名</emphasis> を指定しなければなりません (デフォルトではエンティ" +"ティ名はクラス名と同じです。)。永続オブジェクトを扱うとき、クエリを書き込む" +"とき、指定されたエンティティへの関連をマッピングするときには、 Hibernateでは" +"エンティティ名を指定しなければなりません。" -#: index.docbook:2794 +#. Tag: programlisting +#: basic_mapping.xml:2794 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Contract\" table=\"Contracts\"\n" - " entity-name=\"CurrentContract\">\n" - " ...\n" - " <set name=\"history\" inverse=\"true\"\n" - " order-by=\"effectiveEndDate desc\">\n" - " <key column=\"currentContractId\"/>\n" - " <one-to-many entity-name=\"HistoricalContract\"/>\n" - " </set>\n" - "</class>\n" - "\n" - "<class name=\"Contract\" table=\"ContractHistory\"\n" - " entity-name=\"HistoricalContract\">\n" - " ...\n" - " <many-to-one name=\"currentContract\"\n" - " column=\"currentContractId\"\n" - " entity-name=\"CurrentContract\"/>\n" - "</class>]]>" +"<![CDATA[<class name=\"Contract\" table=\"Contracts\"\n" +" entity-name=\"CurrentContract\">\n" +" ...\n" +" <set name=\"history\" inverse=\"true\"\n" +" order-by=\"effectiveEndDate desc\">\n" +" <key column=\"currentContractId\"/>\n" +" <one-to-many entity-name=\"HistoricalContract\"/>\n" +" </set>\n" +"</class>\n" +"\n" +"<class name=\"Contract\" table=\"ContractHistory\"\n" +" entity-name=\"HistoricalContract\">\n" +" ...\n" +" <many-to-one name=\"currentContract\"\n" +" column=\"currentContractId\"\n" +" entity-name=\"CurrentContract\"/>\n" +"</class>]]>" msgstr "" - "<![CDATA[<hibernate-mapping> -\n" - " ... -\n" - " <database-object> -\n" - " <create>CREATE TRIGGER my_trigger ...</create> -\n" - " <drop>DROP TRIGGER my_trigger</drop> -\n" - " </database-object> -\n" - "</hibernate-mapping>]]>" -#: index.docbook:2796 -msgid "Notice how associations are now specified using <literal>entity-name</literal> instead of <literal>class</literal>." -msgstr "2つ目の方法は、CREATEとDROPコマンドの組み立て方を知っているカスタムクラスを提供することです。このカスタムクラスは <literal>org.hibernate.mapping.AuxiliaryDatabaseObject</literal> インタフェースを実装しなければなりません。" +#. Tag: para +#: basic_mapping.xml:2796 +#, no-c-format +msgid "" +"Notice how associations are now specified using <literal>entity-name</" +"literal> instead of <literal>class</literal>." +msgstr "" +"関連が<literal>class</literal> の代わりに <literal>entity-name</literal> を" +"使って、どのように指定されるのかに注目してください。" -#: index.docbook:2804 +#. Tag: title +#: basic_mapping.xml:2804 +#, no-c-format msgid "SQL quoted identifiers" +msgstr "バッククォートで囲んだ SQL 識別子" + +#. Tag: para +#: basic_mapping.xml:2805 +#, no-c-format +msgid "" +"You may force Hibernate to quote an identifier in the generated SQL by " +"enclosing the table or column name in backticks in the mapping document. " +"Hibernate will use the correct quotation style for the SQL <literal>Dialect</" +"literal> (usually double quotes, but brackets for SQL Server and backticks " +"for MySQL)." msgstr "" - "<![CDATA[<hibernate-mapping> -\n" - " ... -\n" - " <database-object> -\n" - " <definition class=\"MyTriggerDefinition\"/> -\n" - " </database-object> -\n" - "</hibernate-mapping>]]>" +"マッピングドキュメントでテーブルやカラムの名前をバッククォートで囲むことで、 " +"Hibernateで生成されたSQL中の識別子を引用させることができます。 HibernateはSQL" +"の <literal>Dialect</literal> に対応する、正しい引用スタイルを使います（普通" +"はダブルクォートですが、SQL Serverではかぎ括弧、MySQLではバッククォートで" +"す）。" -#: index.docbook:2805 -msgid "You may force Hibernate to quote an identifier in the generated SQL by enclosing the table or column name in backticks in the mapping document. Hibernate will use the correct quotation style for the SQL <literal>Dialect</literal> (usually double quotes, but brackets for SQL Server and backticks for MySQL)." -msgstr "さらに、あるデータベース方言が使用される時にだけ適用するといったように、データベース・オブジェクトが使われるケースを限定できます。" - -#: index.docbook:2812 +#. Tag: programlisting +#: basic_mapping.xml:2812 +#, no-c-format msgid "" - "<![CDATA[<class name=\"LineItem\" table=\"`Line Item`\">\n" - " <id name=\"id\" column=\"`Item Id`\"/><generator class=\"assigned\"/></id>\n" - " <property name=\"itemNumber\" column=\"`Item #`\"/>\n" - " ...\n" - "</class>]]>" +"<![CDATA[<class name=\"LineItem\" table=\"`Line Item`\">\n" +" <id name=\"id\" column=\"`Item Id`\"/><generator class=\"assigned\"/></" +"id>\n" +" <property name=\"itemNumber\" column=\"`Item #`\"/>\n" +" ...\n" +"</class>]]>" msgstr "" - "<![CDATA[<hibernate-mapping> -\n" - " ... -\n" - " <database-object> -\n" - " <definition class=\"MyTriggerDefinition\"/> -\n" - " <dialect-scope name=\"org.hibernate.dialect.Oracle9Dialect\"/> -\n" - " <dialect-scope name=\"org.hibernate.dialect.OracleDialect\"/> -\n" - " </database-object> -\n" - "</hibernate-mapping>]]>" -#: index.docbook:2818 +#. Tag: title +#: basic_mapping.xml:2818 +#, no-c-format msgid "Metadata alternatives" -msgstr "" +msgstr "メタデータの代替手段" -#: index.docbook:2820 -msgid "XML isn't for everyone, and so there are some alternative ways to define O/R mapping metadata in Hibernate." +#. Tag: para +#: basic_mapping.xml:2820 +#, no-c-format +msgid "" +"XML isn't for everyone, and so there are some alternative ways to define O/R " +"mapping metadata in Hibernate." msgstr "" +"XMLの記述以外に、 HibernateではO/Rマッピングのメタデータを定義する代替方法が" +"あります。" -#: index.docbook:2825 +#. Tag: title +#: basic_mapping.xml:2825 +#, no-c-format msgid "Using XDoclet markup" -msgstr "" +msgstr "XDoclet マークアップの使用" -#: index.docbook:2827 -msgid "Many Hibernate users prefer to embed mapping information directly in sourcecode using XDoclet <literal>@hibernate.tags</literal>. We will not cover this approach in this document, since strictly it is considered part of XDoclet. However, we include the following example of the <literal>Cat</literal> class with XDoclet mappings." +#. Tag: para +#: basic_mapping.xml:2827 +#, no-c-format +msgid "" +"Many Hibernate users prefer to embed mapping information directly in " +"sourcecode using XDoclet <literal>@hibernate.tags</literal>. We will not " +"cover this approach in this document, since strictly it is considered part " +"of XDoclet. However, we include the following example of the <literal>Cat</" +"literal> class with XDoclet mappings." msgstr "" +"多くのHibernateユーザはXDocletの <literal>@hibernate.tags</literal> を使っ" +"て、ソースコード内に直接マッピング情報を埋め込むことを好みます。これは厳密" +"に言えばXDocletの分野なので、本ドキュメントではこの方法を対象とはしません。 " +"しかしXDocletを使った以下の <literal>Cat</literal> マッピングの例を示します。" -#: index.docbook:2834 +#. Tag: programlisting +#: basic_mapping.xml:2834 +#, no-c-format msgid "" - "<![CDATA[package eg;\n" - "import java.util.Set;\n" - "import java.util.Date;\n" - "\n" - "/**\n" - " * @hibernate.class\n" - " * table=\"CATS\"\n" - " */\n" - "public class Cat {\n" - " private Long id; // identifier\n" - " private Date birthdate;\n" - " private Cat mother;\n" - " private Set kittens\n" - " private Color color;\n" - " private char sex;\n" - " private float weight;\n" - "\n" - " /*\n" - " * @hibernate.id\n" - " * generator-class=\"native\"\n" - " * column=\"CAT_ID\"\n" - " */\n" - " public Long getId() {\n" - " return id;\n" - " }\n" - " private void setId(Long id) {\n" - " this.id=id;\n" - " }\n" - "\n" - " /**\n" - " * @hibernate.many-to-one\n" - " * column=\"PARENT_ID\"\n" - " */\n" - " public Cat getMother() {\n" - " return mother;\n" - " }\n" - " void setMother(Cat mother) {\n" - " this.mother = mother;\n" - " }\n" - "\n" - " /**\n" - " * @hibernate.property\n" - " * column=\"BIRTH_DATE\"\n" - " */\n" - " public Date getBirthdate() {\n" - " return birthdate;\n" - " }\n" - " void setBirthdate(Date date) {\n" - " birthdate = date;\n" - " }\n" - " /**\n" - " * @hibernate.property\n" - " * column=\"WEIGHT\"\n" - " */\n" - " public float getWeight() {\n" - " return weight;\n" - " }\n" - " void setWeight(float weight) {\n" - " this.weight = weight;\n" - " }\n" - "\n" - " /**\n" - " * @hibernate.property\n" - " * column=\"COLOR\"\n" - " * not-null=\"true\"\n" - " */\n" - " public Color getColor() {\n" - " return color;\n" - " }\n" - " void setColor(Color color) {\n" - " this.color = color;\n" - " }\n" - " /**\n" - " * @hibernate.set\n" - " * inverse=\"true\"\n" - " * order-by=\"BIRTH_DATE\"\n" - " * @hibernate.collection-key\n" - " * column=\"PARENT_ID\"\n" - " * @hibernate.collection-one-to-many\n" - " */\n" - " public Set getKittens() {\n" - " return kittens;\n" - " }\n" - " void setKittens(Set kittens) {\n" - " this.kittens = kittens;\n" - " }\n" - " // addKitten not needed by Hibernate\n" - " public void addKitten(Cat kitten) {\n" - " kittens.add(kitten);\n" - " }\n" - "\n" - " /**\n" - " * @hibernate.property\n" - " * column=\"SEX\"\n" - " * not-null=\"true\"\n" - " * update=\"false\"\n" - " */\n" - " public char getSex() {\n" - " return sex;\n" - " }\n" - " void setSex(char sex) {\n" - " this.sex=sex;\n" - " }\n" - "}]]>" +"<![CDATA[package eg;\n" +"import java.util.Set;\n" +"import java.util.Date;\n" +"\n" +"/**\n" +" * @hibernate.class\n" +" * table=\"CATS\"\n" +" */\n" +"public class Cat {\n" +" private Long id; // identifier\n" +" private Date birthdate;\n" +" private Cat mother;\n" +" private Set kittens\n" +" private Color color;\n" +" private char sex;\n" +" private float weight;\n" +"\n" +" /*\n" +" * @hibernate.id\n" +" * generator-class=\"native\"\n" +" * column=\"CAT_ID\"\n" +" */\n" +" public Long getId() {\n" +" return id;\n" +" }\n" +" private void setId(Long id) {\n" +" this.id=id;\n" +" }\n" +"\n" +" /**\n" +" * @hibernate.many-to-one\n" +" * column=\"PARENT_ID\"\n" +" */\n" +" public Cat getMother() {\n" +" return mother;\n" +" }\n" +" void setMother(Cat mother) {\n" +" this.mother = mother;\n" +" }\n" +"\n" +" /**\n" +" * @hibernate.property\n" +" * column=\"BIRTH_DATE\"\n" +" */\n" +" public Date getBirthdate() {\n" +" return birthdate;\n" +" }\n" +" void setBirthdate(Date date) {\n" +" birthdate = date;\n" +" }\n" +" /**\n" +" * @hibernate.property\n" +" * column=\"WEIGHT\"\n" +" */\n" +" public float getWeight() {\n" +" return weight;\n" +" }\n" +" void setWeight(float weight) {\n" +" this.weight = weight;\n" +" }\n" +"\n" +" /**\n" +" * @hibernate.property\n" +" * column=\"COLOR\"\n" +" * not-null=\"true\"\n" +" */\n" +" public Color getColor() {\n" +" return color;\n" +" }\n" +" void setColor(Color color) {\n" +" this.color = color;\n" +" }\n" +" /**\n" +" * @hibernate.set\n" +" * inverse=\"true\"\n" +" * order-by=\"BIRTH_DATE\"\n" +" * @hibernate.collection-key\n" +" * column=\"PARENT_ID\"\n" +" * @hibernate.collection-one-to-many\n" +" */\n" +" public Set getKittens() {\n" +" return kittens;\n" +" }\n" +" void setKittens(Set kittens) {\n" +" this.kittens = kittens;\n" +" }\n" +" // addKitten not needed by Hibernate\n" +" public void addKitten(Cat kitten) {\n" +" kittens.add(kitten);\n" +" }\n" +"\n" +" /**\n" +" * @hibernate.property\n" +" * column=\"SEX\"\n" +" * not-null=\"true\"\n" +" * update=\"false\"\n" +" */\n" +" public char getSex() {\n" +" return sex;\n" +" }\n" +" void setSex(char sex) {\n" +" this.sex=sex;\n" +" }\n" +"}]]>" msgstr "" -#: index.docbook:2836 +#. Tag: para +#: basic_mapping.xml:2836 +#, no-c-format msgid "See the Hibernate web site for more examples of XDoclet and Hibernate." msgstr "" +"Hibernateのウェブサイトには、XDocletとHibernateに関するサンプルが多数ありま" +"す。" -#: index.docbook:2843 +#. Tag: title +#: basic_mapping.xml:2843 +#, no-c-format msgid "Using JDK 5.0 Annotations" -msgstr "" +msgstr "JDK 5.0 アノテーションの使用" -#: index.docbook:2845 -msgid "JDK 5.0 introduced XDoclet-style annotations at the language level, type-safe and checked at compile time. This mechnism is more powerful than XDoclet annotations and better supported by tools and IDEs. IntelliJ IDEA, for example, supports auto-completion and syntax highlighting of JDK 5.0 annotations. The new revision of the EJB specification (JSR-220) uses JDK 5.0 annotations as the primary metadata mechanism for entity beans. Hibernate3 implements the <literal>EntityManager</literal> of JSR-220 (the persistence API), support for mapping metadata is available via the <emphasis>Hibernate Annotations</emphasis> package, as a separate download. Both EJB3 (JSR-220) and Hibernate3 metadata is supported." +#. Tag: para +#: basic_mapping.xml:2845 +#, no-c-format +msgid "" +"JDK 5.0 introduced XDoclet-style annotations at the language level, type-" +"safe and checked at compile time. This mechnism is more powerful than " +"XDoclet annotations and better supported by tools and IDEs. IntelliJ IDEA, " +"for example, supports auto-completion and syntax highlighting of JDK 5.0 " +"annotations. The new revision of the EJB specification (JSR-220) uses JDK " +"5.0 annotations as the primary metadata mechanism for entity beans. " +"Hibernate3 implements the <literal>EntityManager</literal> of JSR-220 (the " +"persistence API), support for mapping metadata is available via the " +"<emphasis>Hibernate Annotations</emphasis> package, as a separate download. " +"Both EJB3 (JSR-220) and Hibernate3 metadata is supported." msgstr "" +"JDK5.0ではタイプセーフかつコンパイル時にチェックできる、言語レベルのXDoclet" +"スタイルのアノテーションを導入しました。このメカニズムはXDocletのアノテー" +"ションよりも強力で、ツールやIDEも多くがサポートしています。例えばIntelliJ " +"IDEAは、JDK5.0にアノテーションの自動補完と構文の強調表示をサポートしていま" +"す。 EJB仕様 (JSR-220)の新しいバージョンでは、エンティティビーンに対する主要" +"なメタデータメカニズムとして JDK5.0のアノテーションを使用しています。 " +"Hibernate3ではJSR-220 (永続化API)の <literal>EntityManager</literal> を実装" +"し、メタデータマッピングに対するサポートは、別ダウンロードの " +"<emphasis>Hibernate Annotations</emphasis> パッケージにより利用可能です。こ" +"れはEJB3(JSR-220)とHibernate3のメタデータをどちらもサポートしています。" -#: index.docbook:2856 +#. Tag: para +#: basic_mapping.xml:2856 +#, no-c-format msgid "This is an example of a POJO class annotated as an EJB entity bean:" -msgstr "" +msgstr "以下はEJBのエンティティビーンとして注釈されたPOJOクラスの例です。" -#: index.docbook:2860 +#. Tag: programlisting +#: basic_mapping.xml:2860 +#, no-c-format msgid "" - "<![CDATA[@Entity(access = AccessType.FIELD)\n" - "public class Customer implements Serializable {\n" - "\n" - " @Id;\n" - " Long id;\n" - "\n" - " String firstName;\n" - " String lastName;\n" - " Date birthday;\n" - "\n" - " @Transient\n" - " Integer age;\n" - "\n" - " @Embedded\n" - " private Address homeAddress;\n" - "\n" - " @OneToMany(cascade=CascadeType.ALL)\n" - " @JoinColumn(name=\"CUSTOMER_ID\")\n" - " Set<Order> orders;\n" - "\n" - " // Getter/setter and business methods\n" - "}]]>" +"<![CDATA[@Entity(access = AccessType.FIELD)\n" +"public class Customer implements Serializable {\n" +"\n" +" @Id;\n" +" Long id;\n" +"\n" +" String firstName;\n" +" String lastName;\n" +" Date birthday;\n" +"\n" +" @Transient\n" +" Integer age;\n" +"\n" +" @Embedded\n" +" private Address homeAddress;\n" +"\n" +" @OneToMany(cascade=CascadeType.ALL)\n" +" @JoinColumn(name=\"CUSTOMER_ID\")\n" +" Set<Order> orders;\n" +"\n" +" // Getter/setter and business methods\n" +"}]]>" msgstr "" -#: index.docbook:2862 -msgid "Note that support for JDK 5.0 Annotations (and JSR-220) is still work in progress and not completed. Please refer to the Hibernate Annotations module for more details." +#. Tag: para +#: basic_mapping.xml:2862 +#, no-c-format +msgid "" +"Note that support for JDK 5.0 Annotations (and JSR-220) is still work in " +"progress and not completed. Please refer to the Hibernate Annotations module " +"for more details." msgstr "" +"JDK5.0のアノテーション(とJSR-220)のサポートは進行中の作業であり、完全ではない" +"ことに注意してください。さらに詳しい情報はHibernateのアノテーション・モ" +"ジュールを参照してください。" -#: index.docbook:2871 +#. Tag: title +#: basic_mapping.xml:2871 +#, no-c-format msgid "Generated Properties" -msgstr "" +msgstr "生成プロパティ" -#: index.docbook:2872 -msgid "Generated properties are properties which have their values generated by the database. Typically, Hibernate applications needed to <literal>refresh</literal> objects which contain any properties for which the database was generating values. Marking properties as generated, however, lets the application delegate this responsibility to Hibernate. Essentially, whenever Hibernate issues an SQL INSERT or UPDATE for an entity which has defined generated properties, it immediately issues a select afterwards to retrieve the generated values." +#. Tag: para +#: basic_mapping.xml:2872 +#, no-c-format +msgid "" +"Generated properties are properties which have their values generated by the " +"database. Typically, Hibernate applications needed to <literal>refresh</" +"literal> objects which contain any properties for which the database was " +"generating values. Marking properties as generated, however, lets the " +"application delegate this responsibility to Hibernate. Essentially, whenever " +"Hibernate issues an SQL INSERT or UPDATE for an entity which has defined " +"generated properties, it immediately issues a select afterwards to retrieve " +"the generated values." msgstr "" +"生成プロパティとは、データベースによって生成された値を持つプロパティです。通" +"常、Hibernateアプリケーションは、データベースが値を生成したプロパティを含むオ" +"ブジェクトを <literal>リフレッシュ</literal> する必要がありました。しかし、" +"プロパティが生成されたということをマークすることで、アプリケーションはリフ" +"レッシュの責任をHibernateに委譲します。基本的に、生成プロパティを持つと定義" +"したエンティティに対して HibernateがINSERTやUPDATEのSQLを発行した後すぐに、 " +"生成された値を読み込むための SELECT SQL が発行されます。" -#: index.docbook:2881 -msgid "Properties marked as generated must additionally be non-insertable and non-updateable. Only <xref linkend=\"mapping-declaration-version\"/>versions, <xref linkend=\"mapping-declaration-timestamp\"/>timestamps, and <xref linkend=\"mapping-declaration-property\"/>simple properties can be marked as generated." +#. Tag: para +#: basic_mapping.xml:2881 +#, no-c-format +msgid "" +"Properties marked as generated must additionally be non-insertable and non-" +"updateable. Only <link linkend=\"mapping-declaration-version\">versions</" +"link>, <link linkend=\"mapping-declaration-timestamp\">timestamps</link>, " +"and <link linkend=\"mapping-declaration-property\">simple properties</link> " +"can be marked as generated." msgstr "" +"生成プロパティは、挿入不可能かつ更新不可能でなければなりません。 <xref " +"linkend=\"mapping-declaration-version\">versions</xref> 、 <xref linkend=" +"\"mapping-declaration-timestamp\">timestamps</xref> 、 <xref linkend=" +"\"mapping-declaration-property\">simple properties</xref> だけが生成されたと" +"マークできます。" -#: index.docbook:2888 -msgid "<literal>never</literal> (the default) - means that the given property value is not generated within the database." +#. Tag: para +#: basic_mapping.xml:2888 +#, no-c-format +msgid "" +"<literal>never</literal> (the default) - means that the given property value " +"is not generated within the database." msgstr "" +"<literal>never</literal> (デフォルト) - 与えられたプロパティの値は、データ" +"ベースから生成されないことを意味します。" -#: index.docbook:2892 -msgid "<literal>insert</literal> - states that the given property value is generated on insert, but is not regenerated on subsequent updates. Things like created-date would fall into this category. Note that even thought <xref linkend=\"mapping-declaration-version\"/>version and <xref linkend=\"mapping-declaration-timestamp\"/>timestamp properties can be marked as generated, this option is not available there..." +#. Tag: para +#: basic_mapping.xml:2892 +#, no-c-format +msgid "" +"<literal>insert</literal> - states that the given property value is " +"generated on insert, but is not regenerated on subsequent updates. Things " +"like created-date would fall into this category. Note that even thought " +"<link linkend=\"mapping-declaration-version\">version</link> and <link " +"linkend=\"mapping-declaration-timestamp\">timestamp</link> properties can be " +"marked as generated, this option is not available there..." msgstr "" +"<literal>insert</literal> - 与えられたプロパティの値は挿入時に生成されるが、 " +"続いて起こる更新時には生成されないこと示します。作成された日付などは、このカ" +"テゴリに分類されます。 <xref linkend=\"mapping-declaration-version" +"\">version</xref> や <xref linkend=\"mapping-declaration-timestamp" +"\">timestamp</xref> のプロパティは生成されたとマークできますが、このオプショ" +"ンは利用できないことに注意してください。" -#: index.docbook:2900 -msgid "<literal>always</literal> - states that the property value is generated both on insert and on update." +#. Tag: para +#: basic_mapping.xml:2900 +#, no-c-format +msgid "" +"<literal>always</literal> - states that the property value is generated both " +"on insert and on update." msgstr "" +"<literal>always</literal> - 挿入時も更新時もプロパティの値が生成されることを" +"示します。" -#: index.docbook:2907 +#. Tag: title +#: basic_mapping.xml:2907 +#, no-c-format msgid "Auxiliary Database Objects" -msgstr "" +msgstr "補助的なデータベース・オブジェクト" -#: index.docbook:2908 -msgid "Allows CREATE and DROP of arbitrary database objects, in conjunction with Hibernate's schema evolution tools, to provide the ability to fully define a user schema within the Hibernate mapping files. Although designed specifically for creating and dropping things like triggers or stored procedures, really any SQL command that can be run via a <literal>java.sql.Statement.execute()</literal> method is valid here (ALTERs, INSERTS, etc). There are essentially two modes for defining auxiliary database objects..." +#. Tag: para +#: basic_mapping.xml:2908 +#, no-c-format +msgid "" +"Allows CREATE and DROP of arbitrary database objects, in conjunction with " +"Hibernate's schema evolution tools, to provide the ability to fully define a " +"user schema within the Hibernate mapping files. Although designed " +"specifically for creating and dropping things like triggers or stored " +"procedures, really any SQL command that can be run via a <literal>java.sql." +"Statement.execute()</literal> method is valid here (ALTERs, INSERTS, etc). " +"There are essentially two modes for defining auxiliary database objects..." msgstr "" +"Hibernateのスキーマ・エボリューションツールと連動することで、任意のデータ" +"ベース・オブジェクト（トリガーやストアドプロシージャなど）のCREATEとDROPによ" +"り、 Hibernateのマッピングファイル内のユーザ・スキーマをすべて定義することが" +"出来ます。主にトリガやストアドプロシージャのようなデータベース・オブジェクト" +"を生成や削除することを意図していますが、実際には <literal>java.sql." +"Statement.execute()</literal> メソッドによって実行できる任意のSQLコマンド" +"（ALTER、INSERTなど）が実行できます。補助的なデータベース・オブジェクトを定" +"義するための、2つの基本的な方法があります。" -#: index.docbook:2917 -msgid "The first mode is to explicitly list the CREATE and DROP commands out in the mapping file:" +#. Tag: para +#: basic_mapping.xml:2917 +#, no-c-format +msgid "" +"The first mode is to explicitly list the CREATE and DROP commands out in the " +"mapping file:" msgstr "" +"1つ目の方法は、CREATEとDROPコマンドをマッピングファイルの外に、明示的に記載す" +"ることです。" -#: index.docbook:2921 +#. Tag: programlisting +#: basic_mapping.xml:2921 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - " ...\n" - " <database-object>\n" - " <create>CREATE TRIGGER my_trigger ...</create>\n" - " <drop>DROP TRIGGER my_trigger</drop>\n" - " </database-object>\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +" ...\n" +" <database-object>\n" +" <create>CREATE TRIGGER my_trigger ...</create>\n" +" <drop>DROP TRIGGER my_trigger</drop>\n" +" </database-object>\n" +"</hibernate-mapping>]]>" msgstr "" -#: index.docbook:2922 -msgid "The second mode is to supply a custom class which knows how to construct the CREATE and DROP commands. This custom class must implement the <literal>org.hibernate.mapping.AuxiliaryDatabaseObject</literal> interface." +#. Tag: para +#: basic_mapping.xml:2922 +#, no-c-format +msgid "" +"The second mode is to supply a custom class which knows how to construct the " +"CREATE and DROP commands. This custom class must implement the <literal>org." +"hibernate.mapping.AuxiliaryDatabaseObject</literal> interface." msgstr "" +"2つ目の方法は、CREATEとDROPコマンドの組み立て方を知っているカスタムクラスを提" +"供することです。このカスタムクラスは <literal>org.hibernate.mapping." +"AuxiliaryDatabaseObject</literal> インタフェースを実装しなければなりません。" -#: index.docbook:2927 +#. Tag: programlisting +#: basic_mapping.xml:2927 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - " ...\n" - " <database-object>\n" - " <definition class=\"MyTriggerDefinition\"/>\n" - " </database-object>\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +" ...\n" +" <database-object>\n" +" <definition class=\"MyTriggerDefinition\"/>\n" +" </database-object>\n" +"</hibernate-mapping>]]>" msgstr "" -#: index.docbook:2928 -msgid "Additionally, these database objects can be optionally scoped such that they only apply when certain dialects are used." +#. Tag: para +#: basic_mapping.xml:2928 +#, no-c-format +msgid "" +"Additionally, these database objects can be optionally scoped such that they " +"only apply when certain dialects are used." msgstr "" +"さらに、あるデータベース方言が使用される時にだけ適用するといったように、デー" +"タベース・オブジェクトが使われるケースを限定できます。" -#: index.docbook:2932 +#. Tag: programlisting +#: basic_mapping.xml:2932 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - " ...\n" - " <database-object>\n" - " <definition class=\"MyTriggerDefinition\"/>\n" - " <dialect-scope name=\"org.hibernate.dialect.Oracle9Dialect\"/>\n" - " <dialect-scope name=\"org.hibernate.dialect.OracleDialect\"/>\n" - " </database-object>\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +" ...\n" +" <database-object>\n" +" <definition class=\"MyTriggerDefinition\"/>\n" +" <dialect-scope name=\"org.hibernate.dialect.Oracle9Dialect\"/>\n" +" <dialect-scope name=\"org.hibernate.dialect.OracleDialect\"/>\n" +" </database-object>\n" +"</hibernate-mapping>]]>" msgstr "" -msgid "ROLES_OF_TRANSLATORS" -msgstr "" +#~ msgid "class" +#~ msgstr "class" -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "" +#~ msgid "id" +#~ msgstr "id" +#~ msgid "" +#~ "<literal>optimizer</literal> (optional, defaults to <literal>none</" +#~ "literal>): See <xref linkend=\"mapping-declaration-id-enhanced-optimizers" +#~ "\"/>" +#~ msgstr "" +#~ "<literal>optimizer</literal> (optional, defaults to <literal>none</" +#~ "literal>): See <xref linkend=\"mapping-declaration-id-enhanced-optimizers" +#~ "\"/>" + +#~ msgid "" +#~ "<literal>optimizer</literal> (optional, defaults to <literal/>): See " +#~ "<xref linkend=\"mapping-declaration-id-enhanced-optimizers\"/>" +#~ msgstr "" +#~ "<literal>optimizer</literal> (optional, defaults to <literal/>): See " +#~ "<xref linkend=\"mapping-declaration-id-enhanced-optimizers\"/>" + +#~ msgid "key" +#~ msgstr "key" + +#~ msgid "any" +#~ msgstr "any" Modified: core/trunk/documentation/manual/translations/ja-JP/content/batch.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/batch.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/batch.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,459 +1,630 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: batch.xml:5 +#, no-c-format msgid "Batch processing" msgstr "バッチ処理" -#: index.docbook:7 -msgid "A naive approach to inserting 100 000 rows in the database using Hibernate might look like this:" -msgstr "Hibernateを使ってデータベースに100,000行を挿入する愚直な方法は、このようなものです：" +#. Tag: para +#: batch.xml:7 +#, no-c-format +msgid "" +"A naive approach to inserting 100 000 rows in the database using Hibernate " +"might look like this:" +msgstr "" +"Hibernateを使ってデータベースに100,000行を挿入する愚直な方法は、このようなも" +"のです：" -#: index.docbook:12 +#. Tag: programlisting +#: batch.xml:12 +#, no-c-format msgid "" - "<![CDATA[Session session = sessionFactory.openSession();\n" - "Transaction tx = session.beginTransaction();\n" - "for ( int i=0; i<100000; i++ ) {\n" - " Customer customer = new Customer(.....);\n" - " session.save(customer);\n" - "}\n" - "tx.commit();\n" - "session.close();]]>" +"<![CDATA[Session session = sessionFactory.openSession();\n" +"Transaction tx = session.beginTransaction();\n" +"for ( int i=0; i<100000; i++ ) {\n" +" Customer customer = new Customer(.....);\n" +" session.save(customer);\n" +"}\n" +"tx.commit();\n" +"session.close();]]>" msgstr "" - "<![CDATA[Session session = sessionFactory.openSession(); -\n" - "Transaction tx = session.beginTransaction(); -\n" - "for ( int i=0; i<100000; i++ ) { -\n" - " Customer customer = new Customer(.....); -\n" - " session.save(customer); -\n" - "} -\n" - "tx.commit(); -\n" - "session.close();]]>" -#: index.docbook:14 -msgid "This would fall over with an <literal>OutOfMemoryException</literal> somewhere around the 50 000th row. That's because Hibernate caches all the newly inserted <literal>Customer</literal> instances in the session-level cache." -msgstr "これは50,000番目の行のあたりで <literal>OutOfMemoryException</literal> で失敗するでしょう。 Hibernateがセッションレベルキャッシュで、新しく挿入されたすべての <literal>Customer</literal> インスタンスをキャッシュするからです。" +#. Tag: para +#: batch.xml:14 +#, no-c-format +msgid "" +"This would fall over with an <literal>OutOfMemoryException</literal> " +"somewhere around the 50 000th row. That's because Hibernate caches all the " +"newly inserted <literal>Customer</literal> instances in the session-level " +"cache." +msgstr "" +"これは50,000番目の行のあたりで <literal>OutOfMemoryException</literal> で失敗" +"するでしょう。 Hibernateがセッションレベルキャッシュで、新しく挿入されたすべ" +"ての <literal>Customer</literal> インスタンスをキャッシュするからです。" -#: index.docbook:20 -msgid "In this chapter we'll show you how to avoid this problem. First, however, if you are doing batch processing, it is absolutely critical that you enable the use of JDBC batching, if you intend to achieve reasonable performance. Set the JDBC batch size to a reasonable number (say, 10-50):" -msgstr "この章では、この問題を回避する方法を紹介します。しかしバッチ処理をするなら、JDBCバッチが使用可能であることが非常に重要です。そうでなければ手頃なパフォーマンスが得られません。 JDBCバッチサイズを手頃な数値（例えば、10から50）に設定してください：" +#. Tag: para +#: batch.xml:20 +#, no-c-format +msgid "" +"In this chapter we'll show you how to avoid this problem. First, however, if " +"you are doing batch processing, it is absolutely critical that you enable " +"the use of JDBC batching, if you intend to achieve reasonable performance. " +"Set the JDBC batch size to a reasonable number (say, 10-50):" +msgstr "" +"この章では、この問題を回避する方法を紹介します。しかしバッチ処理をするなら、" +"JDBCバッチが使用可能であることが非常に重要です。そうでなければ手頃なパフォー" +"マンスが得られません。 JDBCバッチサイズを手頃な数値（例えば、10から50）に設定" +"してください：" -#: index.docbook:27 +#. Tag: programlisting +#: batch.xml:27 +#, no-c-format msgid "<![CDATA[hibernate.jdbc.batch_size 20]]>" -msgstr "<![CDATA[hibernate.jdbc.batch_size 20]]>" +msgstr "" -#: index.docbook:29 -msgid "Note that Hibernate disables insert batching at the JDBC level transparently if you use an <literal>identiy</literal> identifier generator." -msgstr "また二次キャッシュが全く効かないプロセスで、このような作業をしたいと思うかもしれません：" +#. Tag: para +#: batch.xml:29 +#, no-c-format +msgid "" +"Note that Hibernate disables insert batching at the JDBC level transparently " +"if you use an <literal>identiy</literal> identifier generator." +msgstr "" +"Note that Hibernate disables insert batching at the JDBC level transparently " +"if you use an <literal>identiy</literal> identifier generator." -#: index.docbook:34 -msgid "You also might like to do this kind of work in a process where interaction with the second-level cache is completely disabled:" -msgstr "<![CDATA[hibernate.cache.use_second_level_cache false]]>" +#. Tag: para +#: batch.xml:34 +#, no-c-format +msgid "" +"You also might like to do this kind of work in a process where interaction " +"with the second-level cache is completely disabled:" +msgstr "" +"また二次キャッシュが全く効かないプロセスで、このような作業をしたいと思うかも" +"しれません：" -#: index.docbook:39 +#. Tag: programlisting +#: batch.xml:39 +#, no-c-format msgid "<![CDATA[hibernate.cache.use_second_level_cache false]]>" -msgstr "しかし、これは絶対に必要というわけではありません。なぜなら明示的に <literal>CacheMode</literal> を設定して、二次キャッシュとの相互作用を無効にすることができるからです。" +msgstr "" -#: index.docbook:41 -msgid "However, this is not absolutely necessary, since we can explicitly set the <literal>CacheMode</literal> to disable interaction with the second-level cache." -msgstr "バッチ挿入" +#. Tag: para +#: batch.xml:41 +#, no-c-format +msgid "" +"However, this is not absolutely necessary, since we can explicitly set the " +"<literal>CacheMode</literal> to disable interaction with the second-level " +"cache." +msgstr "" +"しかし、これは絶対に必要というわけではありません。なぜなら明示的に " +"<literal>CacheMode</literal> を設定して、二次キャッシュとの相互作用を無効に" +"することができるからです。" -#: index.docbook:47 +#. Tag: title +#: batch.xml:47 +#, no-c-format msgid "Batch inserts" -msgstr "新しいオブジェクトを永続化するとき、一次キャッシュのサイズを制限するため、セッションを <literal>flush()</literal> して <literal>clear()</literal> しなければなりません。" +msgstr "バッチ挿入" -#: index.docbook:49 -msgid "When making new objects persistent, you must <literal>flush()</literal> and then <literal>clear()</literal> the session regularly, to control the size of the first-level cache." +#. Tag: para +#: batch.xml:49 +#, no-c-format +msgid "" +"When making new objects persistent, you must <literal>flush()</literal> and " +"then <literal>clear()</literal> the session regularly, to control the size " +"of the first-level cache." msgstr "" - "<![CDATA[Session session = sessionFactory.openSession(); -\n" - "Transaction tx = session.beginTransaction(); -\n" - " -\n" - "for ( int i=0; i<100000; i++ ) { -\n" - " Customer customer = new Customer(.....); -\n" - " session.save(customer); -\n" - " if ( i % 20 == 0 ) { //20, same as the JDBC batch size -\n" - " //flush a batch of inserts and release memory: -\n" - " session.flush(); -\n" - " session.clear(); -\n" - " } -\n" - "} -\n" - " -\n" - "tx.commit(); -\n" - "session.close();]]>" +"新しいオブジェクトを永続化するとき、一次キャッシュのサイズを制限するため、 " +"セッションを <literal>flush()</literal> して <literal>clear()</literal> しな" +"ければなりません。" -#: index.docbook:55 +#. Tag: programlisting +#: batch.xml:55 +#, no-c-format msgid "" - "<![CDATA[Session session = sessionFactory.openSession();\n" - "Transaction tx = session.beginTransaction();\n" - " \n" - "for ( int i=0; i<100000; i++ ) {\n" - " Customer customer = new Customer(.....);\n" - " session.save(customer);\n" - " if ( i % 20 == 0 ) { //20, same as the JDBC batch size\n" - " //flush a batch of inserts and release memory:\n" - " session.flush();\n" - " session.clear();\n" - " }\n" - "}\n" - " \n" - "tx.commit();\n" - "session.close();]]>" -msgstr "バッチ更新" +"<![CDATA[Session session = sessionFactory.openSession();\n" +"Transaction tx = session.beginTransaction();\n" +" \n" +"for ( int i=0; i<100000; i++ ) {\n" +" Customer customer = new Customer(.....);\n" +" session.save(customer);\n" +" if ( i % 20 == 0 ) { //20, same as the JDBC batch size\n" +" //flush a batch of inserts and release memory:\n" +" session.flush();\n" +" session.clear();\n" +" }\n" +"}\n" +" \n" +"tx.commit();\n" +"session.close();]]>" +msgstr "" -#: index.docbook:60 +#. Tag: title +#: batch.xml:60 +#, no-c-format msgid "Batch updates" -msgstr "データを復元したり更新したりするには同じアイディアを適用します。それに加えて、データの行を多く返すクエリに対して有効なサーバーサイドのカーソルの利点を生かしたければ <literal>scroll()</literal> を使う必要があります。" +msgstr "バッチ更新" -#: index.docbook:62 -msgid "For retrieving and updating data the same ideas apply. In addition, you need to use <literal>scroll()</literal> to take advantage of server-side cursors for queries that return many rows of data." +#. Tag: para +#: batch.xml:62 +#, no-c-format +msgid "" +"For retrieving and updating data the same ideas apply. In addition, you need " +"to use <literal>scroll()</literal> to take advantage of server-side cursors " +"for queries that return many rows of data." msgstr "" - "<![CDATA[Session session = sessionFactory.openSession(); -\n" - "Transaction tx = session.beginTransaction(); -\n" - " -\n" - "ScrollableResults customers = session.getNamedQuery(\"GetCustomers\") -\n" - " .setCacheMode(CacheMode.IGNORE) -\n" - " .scroll(ScrollMode.FORWARD_ONLY); -\n" - "int count=0; -\n" - "while ( customers.next() ) { -\n" - " Customer customer = (Customer) customers.get(0); -\n" - " customer.updateStuff(...); -\n" - " if ( ++count % 20 == 0 ) { -\n" - " //flush a batch of updates and release memory: -\n" - " session.flush(); -\n" - " session.clear(); -\n" - " } -\n" - "} -\n" - " -\n" - "tx.commit(); -\n" - "session.close();]]>" +"データを復元したり更新したりするには同じアイディアを適用します。それに加え" +"て、データの行を多く返すクエリに対して有効なサーバーサイドのカーソルの利点を" +"生かしたければ <literal>scroll()</literal> を使う必要があります。" -#: index.docbook:68 +#. Tag: programlisting +#: batch.xml:68 +#, no-c-format msgid "" - "<![CDATA[Session session = sessionFactory.openSession();\n" - "Transaction tx = session.beginTransaction();\n" - " \n" - "ScrollableResults customers = session.getNamedQuery(\"GetCustomers\")\n" - " .setCacheMode(CacheMode.IGNORE)\n" - " .scroll(ScrollMode.FORWARD_ONLY);\n" - "int count=0;\n" - "while ( customers.next() ) {\n" - " Customer customer = (Customer) customers.get(0);\n" - " customer.updateStuff(...);\n" - " if ( ++count % 20 == 0 ) {\n" - " //flush a batch of updates and release memory:\n" - " session.flush();\n" - " session.clear();\n" - " }\n" - "}\n" - " \n" - "tx.commit();\n" - "session.close();]]>" -msgstr "StatelessSessionインターフェイス" +"<![CDATA[Session session = sessionFactory.openSession();\n" +"Transaction tx = session.beginTransaction();\n" +" \n" +"ScrollableResults customers = session.getNamedQuery(\"GetCustomers\")\n" +" .setCacheMode(CacheMode.IGNORE)\n" +" .scroll(ScrollMode.FORWARD_ONLY);\n" +"int count=0;\n" +"while ( customers.next() ) {\n" +" Customer customer = (Customer) customers.get(0);\n" +" customer.updateStuff(...);\n" +" if ( ++count % 20 == 0 ) {\n" +" //flush a batch of updates and release memory:\n" +" session.flush();\n" +" session.clear();\n" +" }\n" +"}\n" +" \n" +"tx.commit();\n" +"session.close();]]>" +msgstr "" -#: index.docbook:73 +#. Tag: title +#: batch.xml:73 +#, no-c-format msgid "The StatelessSession interface" -msgstr "また別の方法として、Hibernateはコマンド指向のAPIを用意しています。これは分離オブジェクトの形で、データベースとのデータストリームのやり取りに使うことができます。 <literal>StatelessSession</literal> は関連する永続コンテキストを持たず、高レベルのライフサイクルセマンティクスの多くを提供しません。特にステートレスセッションは、一時キャッシュを実装せず、またどのような二次キャッシュやクエリキャッシュとも相互作用しません。トランザクショナルなwrite-behindや自動ダーティチェックも実装しません。ステートレスセッションを使って行われる操作が、関連するインスタンスへカスケードされることは決してありません。コレクションは、ステートレスセッションからは無視されます。ステートレスセ! ッションを通して行われる操作は、 Hibernateのイベントモデルやインターセプタの影響を受けません。一時キャッシュを持たないため、ステートレスセッションは別名を持つデータに上手く対処できません。ステートレスセッションは低レベルの抽象化であり、JDBCに非常によく似ています。" +msgstr "StatelessSessionインターフェイス" -#: index.docbook:74 -msgid "Alternatively, Hibernate provides a command-oriented API that may be used for streaming data to and from the database in the form of detached objects. A <literal>StatelessSession</literal> has no persistence context associated with it and does not provide many of the higher-level life cycle semantics. In particular, a stateless session does not implement a first-level cache nor interact with any second-level or query cache. It does not implement transactional write-behind or automatic dirty checking. Operations performed using a stateless session do not ever cascade to associated instances. Collections are ignored by a stateless session. Operations performed via a stateless session bypass Hibernate's event model and interceptors. Stateless sessions are vulnerable to data aliasing effects, due to the lack of a first-level cache. A stateless session is a lower-level abstraction, much closer to the underlying JDBC." +#. Tag: para +#: batch.xml:74 +#, no-c-format +msgid "" +"Alternatively, Hibernate provides a command-oriented API that may be used " +"for streaming data to and from the database in the form of detached objects. " +"A <literal>StatelessSession</literal> has no persistence context associated " +"with it and does not provide many of the higher-level life cycle semantics. " +"In particular, a stateless session does not implement a first-level cache " +"nor interact with any second-level or query cache. It does not implement " +"transactional write-behind or automatic dirty checking. Operations performed " +"using a stateless session do not ever cascade to associated instances. " +"Collections are ignored by a stateless session. Operations performed via a " +"stateless session bypass Hibernate's event model and interceptors. Stateless " +"sessions are vulnerable to data aliasing effects, due to the lack of a first-" +"level cache. A stateless session is a lower-level abstraction, much closer " +"to the underlying JDBC." msgstr "" - "<![CDATA[StatelessSession session = sessionFactory.openStatelessSession(); -\n" - "Transaction tx = session.beginTransaction(); -\n" - " -\n" - "ScrollableResults customers = session.getNamedQuery(\"GetCustomers\") -\n" - " .scroll(ScrollMode.FORWARD_ONLY); -\n" - "while ( customers.next() ) { -\n" - " Customer customer = (Customer) customers.get(0); -\n" - " customer.updateStuff(...); -\n" - " session.update(customer); -\n" - "} -\n" - " -\n" - "tx.commit(); -\n" - "session.close();]]>" +"また別の方法として、Hibernateはコマンド指向のAPIを用意しています。これは分離" +"オブジェクトの形で、データベースとのデータストリームのやり取りに使うことがで" +"きます。 <literal>StatelessSession</literal> は関連する永続コンテキストを持た" +"ず、高レベルのライフサイクルセマンティクスの多くを提供しません。特にステー" +"トレスセッションは、一時キャッシュを実装せず、またどのような二次キャッシュや" +"クエリキャッシュとも相互作用しません。トランザクショナルなwrite-behindや自動" +"ダーティチェックも実装しません。ステートレスセッションを使って行われる操作" +"が、関連するインスタンスへカスケードされることは決してありません。コレク" +"ションは、ステートレスセッションからは無視されます。ステートレスセッションを" +"通して行われる操作は、 Hibernateのイベントモデルやインターセプタの影響を受け" +"ません。一時キャッシュを持たないため、ステートレスセッションは別名を持つ" +"データに上手く対処できません。ステートレスセッションは低レベルの抽象化であ" +"り、JDBCに非常によく似ています。" -#: index.docbook:89 +#. Tag: programlisting +#: batch.xml:89 +#, no-c-format msgid "" - "<![CDATA[StatelessSession session = sessionFactory.openStatelessSession();\n" - "Transaction tx = session.beginTransaction();\n" - " \n" - "ScrollableResults customers = session.getNamedQuery(\"GetCustomers\")\n" - " .scroll(ScrollMode.FORWARD_ONLY);\n" - "while ( customers.next() ) {\n" - " Customer customer = (Customer) customers.get(0);\n" - " customer.updateStuff(...);\n" - " session.update(customer);\n" - "}\n" - " \n" - "tx.commit();\n" - "session.close();]]>" -msgstr "このコード例では、クエリが返す <literal>Customer</literal> インスタンスは即座に（セッションから）分離されることに注意してください。これは、どのような永続コンテキストとも決して関連しません。" +"<![CDATA[StatelessSession session = sessionFactory.openStatelessSession();\n" +"Transaction tx = session.beginTransaction();\n" +" \n" +"ScrollableResults customers = session.getNamedQuery(\"GetCustomers\")\n" +" .scroll(ScrollMode.FORWARD_ONLY);\n" +"while ( customers.next() ) {\n" +" Customer customer = (Customer) customers.get(0);\n" +" customer.updateStuff(...);\n" +" session.update(customer);\n" +"}\n" +" \n" +"tx.commit();\n" +"session.close();]]>" +msgstr "" -#: index.docbook:91 -msgid "Note that in this code example, the <literal>Customer</literal> instances returned by the query are immediately detached. They are never associated with any persistence context." -msgstr "<literal>StatelessSession</literal> インターフェイスで定義されている <literal>insert(), update(), delete()</literal> は、低レベルの直接的なデータベース操作と考えられます。結果として、SQLの <literal>INSERT, UPDATE, DELETE</literal> がそれぞれ即座に実行されます。このように、これらは <literal>Session</literal> インターフェイスで定義されている <literal>save(), saveOrUpdate(), delete()</literal> とは非常に異なる意味を持ちます。" +#. Tag: para +#: batch.xml:91 +#, no-c-format +msgid "" +"Note that in this code example, the <literal>Customer</literal> instances " +"returned by the query are immediately detached. They are never associated " +"with any persistence context." +msgstr "" +"このコード例では、クエリが返す <literal>Customer</literal> インスタンスは即座" +"に（セッションから）分離されることに注意してください。これは、どのような永続" +"コンテキストとも決して関連しません。" -#: index.docbook:97 -msgid "The <literal>insert(), update()</literal> and <literal>delete()</literal> operations defined by the <literal>StatelessSession</literal> interface are considered to be direct database row-level operations, which result in immediate execution of a SQL <literal>INSERT, UPDATE</literal> or <literal>DELETE</literal> respectively. Thus, they have very different semantics to the <literal>save(), saveOrUpdate()</literal> and <literal>delete()</literal> operations defined by the <literal>Session</literal> interface." -msgstr "DMLスタイルの操作" +#. Tag: para +#: batch.xml:97 +#, no-c-format +msgid "" +"The <literal>insert(), update()</literal> and <literal>delete()</literal> " +"operations defined by the <literal>StatelessSession</literal> interface are " +"considered to be direct database row-level operations, which result in " +"immediate execution of a SQL <literal>INSERT, UPDATE</literal> or " +"<literal>DELETE</literal> respectively. Thus, they have very different " +"semantics to the <literal>save(), saveOrUpdate()</literal> and " +"<literal>delete()</literal> operations defined by the <literal>Session</" +"literal> interface." +msgstr "" +"<literal>StatelessSession</literal> インターフェイスで定義されている " +"<literal>insert(), update(), delete()</literal> は、低レベルの直接的なデータ" +"ベース操作と考えられます。結果として、SQLの <literal>INSERT, UPDATE, " +"DELETE</literal> がそれぞれ即座に実行されます。このように、これらは " +"<literal>Session</literal> インターフェイスで定義されている <literal>save(), " +"saveOrUpdate(), delete()</literal> とは非常に異なる意味を持ちます。" -#: index.docbook:110 +#. Tag: title +#: batch.xml:110 +#, no-c-format msgid "DML-style operations" -msgstr "すでに議論したように、自動的かつ透過的なオブジェクト/リレーショナルマッピングは、オブジェクトの状態の管理であると考えられます。これはメモリ内のオブジェクトの状態を利用できるということです。そのため（SQLの <literal>データ操作言語</literal> (DML) 文： <literal>INSERT</literal>, <literal>UPDATE</literal>, <literal>DELETE</literal> を使って）データベース内のデータを直接操作しても、メモリ内の状態には影響を与えません。しかしHibernateは、バルクSQLスタイルのDML文実行に対応するメソッドを用意しています。これはHibernateクエリ言語（<xref linkend=\"queryhql\"/>HQL）を通して実行されます。" +msgstr "DMLスタイルの操作" -#: index.docbook:112 -msgid "As already discussed, automatic and transparent object/relational mapping is concerned with the management of object state. This implies that the object state is available in memory, hence manipulating (using the SQL <literal>Data Manipulation Language</literal> (DML) statements: <literal>INSERT</literal>, <literal>UPDATE</literal>, <literal>DELETE</literal>) data directly in the database will not affect in-memory state. However, Hibernate provides methods for bulk SQL-style DML statement execution which are performed through the Hibernate Query Language (<xref linkend=\"queryhql\"/>HQL)." -msgstr "<literal>UPDATE</literal> と <literal>DELETE</literal> 文の疑似構文は： <literal>( UPDATE | DELETE ) FROM? エンティティ名 (WHERE 条件節)?</literal> です。注意すべき点がいくつかあります：" +#. Tag: para +#: batch.xml:112 +#, no-c-format +msgid "" +"As already discussed, automatic and transparent object/relational mapping is " +"concerned with the management of object state. This implies that the object " +"state is available in memory, hence manipulating (using the SQL " +"<literal>Data Manipulation Language</literal> (DML) statements: " +"<literal>INSERT</literal>, <literal>UPDATE</literal>, <literal>DELETE</" +"literal>) data directly in the database will not affect in-memory state. " +"However, Hibernate provides methods for bulk SQL-style DML statement " +"execution which are performed through the Hibernate Query Language (<link " +"linkend=\"queryhql\">HQL</link>)." +msgstr "" +"すでに議論したように、自動的かつ透過的なオブジェクト/リレーショナルマッピング" +"は、オブジェクトの状態の管理であると考えられます。これはメモリ内のオブジェ" +"クトの状態を利用できるということです。そのため（SQLの <literal>データ操作言" +"語</literal> (DML) 文： <literal>INSERT</literal>, <literal>UPDATE</" +"literal>, <literal>DELETE</literal> を使って）データベース内のデータを直接操" +"作しても、メモリ内の状態には影響を与えません。しかしHibernateは、バルクSQL" +"スタイルのDML文実行に対応するメソッドを用意しています。これはHibernateクエリ" +"言語（<xref linkend=\"queryhql\">HQL</xref>）を通して実行されます。" -#: index.docbook:122 -msgid "The pseudo-syntax for <literal>UPDATE</literal> and <literal>DELETE</literal> statements is: <literal>( UPDATE | DELETE ) FROM? EntityName (WHERE where_conditions)?</literal>. Some points to note:" -msgstr "from節において、FROMキーワードはオプションです。" +#. Tag: para +#: batch.xml:122 +#, no-c-format +msgid "" +"The pseudo-syntax for <literal>UPDATE</literal> and <literal>DELETE</" +"literal> statements is: <literal>( UPDATE | DELETE ) FROM? EntityName (WHERE " +"where_conditions)?</literal>. Some points to note:" +msgstr "" +"<literal>UPDATE</literal> と <literal>DELETE</literal> 文の疑似構文は： " +"<literal>( UPDATE | DELETE ) FROM? エンティティ名 (WHERE 条件節)?</literal> " +"です。注意すべき点がいくつかあります：" -#: index.docbook:130 +#. Tag: para +#: batch.xml:130 +#, no-c-format msgid "In the from-clause, the FROM keyword is optional" -msgstr "from節では単一のエンティティ名だけが可能で、任意で別名を付けることができます。エンティティ名に別名が与えられると、どのようなプロパティ参照も、その別名を使って修飾しなければなりません。もしエンティティ名に別名が与えられなければ、どのようなプロパティ参照も修飾してはなりません。" +msgstr "from節において、FROMキーワードはオプションです。" -#: index.docbook:135 -msgid "There can only be a single entity named in the from-clause; it can optionally be aliased. If the entity name is aliased, then any property references must be qualified using that alias; if the entity name is not aliased, then it is illegal for any property references to be qualified." -msgstr "（暗黙的であれ明示的であれ）<xref linkend=\"queryhql-joins-forms\"/>結合をバルクHQLクエリ内で指定することはできません。サブクエリはwhere節で使うことができますサブクエリそのものは、結合を含められます。" +#. Tag: para +#: batch.xml:135 +#, no-c-format +msgid "" +"There can only be a single entity named in the from-clause; it can " +"optionally be aliased. If the entity name is aliased, then any property " +"references must be qualified using that alias; if the entity name is not " +"aliased, then it is illegal for any property references to be qualified." +msgstr "" +"from節では単一のエンティティ名だけが可能で、任意で別名を付けることができま" +"す。エンティティ名に別名が与えられると、どのようなプロパティ参照も、その別" +"名を使って修飾しなければなりません。もしエンティティ名に別名が与えられなけれ" +"ば、どのようなプロパティ参照も修飾してはなりません。" -#: index.docbook:143 -msgid "No <xref linkend=\"queryhql-joins-forms\"/>joins (either implicit or explicit) can be specified in a bulk HQL query. Sub-queries may be used in the where-clause; the subqueries, themselves, may contain joins." -msgstr "where節はオプションです。" +#. Tag: para +#: batch.xml:143 +#, no-c-format +msgid "" +"No <link linkend=\"queryhql-joins-forms\">joins</link> (either implicit or " +"explicit) can be specified in a bulk HQL query. Sub-queries may be used in " +"the where-clause; the subqueries, themselves, may contain joins." +msgstr "" +"（暗黙的であれ明示的であれ）<xref linkend=\"queryhql-joins-forms\">結合</" +"xref> をバルクHQLクエリ内で指定することはできません。サブクエリはwhere節で使" +"うことができますサブクエリそのものは、結合を含められます。" -#: index.docbook:150 +#. Tag: para +#: batch.xml:150 +#, no-c-format msgid "The where-clause is also optional." -msgstr "例として、HQLの <literal>UPDATE</literal> を実行するには、 <literal>Query.executeUpdate()</literal> メソッドを使ってください。（このメソッドはおなじみのJDBC <literal>PreparedStatement.executeUpdate()</literal> から名付けられました）： d" +msgstr "where節はオプションです。" -#: index.docbook:156 -msgid "As an example, to execute an HQL <literal>UPDATE</literal>, use the <literal>Query.executeUpdate()</literal> method (the method is named for those familiar with JDBC's <literal>PreparedStatement.executeUpdate()</literal>):" +#. Tag: para +#: batch.xml:156 +#, no-c-format +msgid "" +"As an example, to execute an HQL <literal>UPDATE</literal>, use the " +"<literal>Query.executeUpdate()</literal> method (the method is named for " +"those familiar with JDBC's <literal>PreparedStatement.executeUpdate()</" +"literal>):" msgstr "" - "<![CDATA[Session session = sessionFactory.openSession(); -\n" - "Transaction tx = session.beginTransaction(); -\n" - " -\n" - "String hqlUpdate = \"update Customer c set c.name = :newName where c.name = :oldName\"; -\n" - "// or String hqlUpdate = \"update Customer set name = :newName where name = :oldName\"; -\n" - "int updatedEntities = s.createQuery( hqlUpdate ) -\n" - " .setString( \"newName\", newName ) -\n" - " .setString( \"oldName\", oldName ) -\n" - " .executeUpdate(); -\n" - "tx.commit(); -\n" - "session.close();]]>" +"例として、HQLの <literal>UPDATE</literal> を実行するには、 <literal>Query." +"executeUpdate()</literal> メソッドを使ってください。（このメソッドはおなじみ" +"のJDBC <literal>PreparedStatement.executeUpdate()</literal> から名付けられま" +"した）： d" -#: index.docbook:162 +#. Tag: programlisting +#: batch.xml:162 +#, no-c-format msgid "" - "<![CDATA[Session session = sessionFactory.openSession();\n" - "Transaction tx = session.beginTransaction();\n" - "\n" - "String hqlUpdate = \"update Customer c set c.name = :newName where c.name = :oldName\";\n" - "// or String hqlUpdate = \"update Customer set name = :newName where name = :oldName\";\n" - "int updatedEntities = s.createQuery( hqlUpdate )\n" - " .setString( \"newName\", newName )\n" - " .setString( \"oldName\", oldName )\n" - " .executeUpdate();\n" - "tx.commit();\n" - "session.close();]]>" -msgstr "HQLの <literal>UPDATE</literal> 文は、デフォルトでは、作用するエンティティの <xref linkend=\"mapping-declaration-version\"/>version や <xref linkend=\"mapping-declaration-timestamp\"/>timestamp プロパティの値には影響しません。これはEJB3の仕様にも受け継がれています。しかし <literal>versioned update</literal> を使って、 <literal>version</literal> や <literal>timestamp</literal> プロパティの値を強制的にリセットさせることができます。これは <literal>UPDATE</literal> キーワードの後に <literal>VERSIONED</literal> キーワードを追加することで行えます。" +"<![CDATA[Session session = sessionFactory.openSession();\n" +"Transaction tx = session.beginTransaction();\n" +"\n" +"String hqlUpdate = \"update Customer c set c.name = :newName where c.name = :" +"oldName\";\n" +"// or String hqlUpdate = \"update Customer set name = :newName where name = :" +"oldName\";\n" +"int updatedEntities = s.createQuery( hqlUpdate )\n" +" .setString( \"newName\", newName )\n" +" .setString( \"oldName\", oldName )\n" +" .executeUpdate();\n" +"tx.commit();\n" +"session.close();]]>" +msgstr "" -#: index.docbook:164 -msgid "HQL <literal>UPDATE</literal> statements, by default do not effect the <xref linkend=\"mapping-declaration-version\"/>version or the <xref linkend=\"mapping-declaration-timestamp\"/>timestamp property values for the affected entities; this is in keeping with the EJB3 specification. However, you can force Hibernate to properly reset the <literal>version</literal> or <literal>timestamp</literal> property values through the use of a <literal>versioned update</literal>. This is achieved by adding the <literal>VERSIONED</literal> keyword after the <literal>UPDATE</literal> keyword." +#. Tag: para +#: batch.xml:164 +#, no-c-format +msgid "" +"HQL <literal>UPDATE</literal> statements, by default do not effect the <link " +"linkend=\"mapping-declaration-version\">version</link> or the <link linkend=" +"\"mapping-declaration-timestamp\">timestamp</link> property values for the " +"affected entities; this is in keeping with the EJB3 specification. However, " +"you can force Hibernate to properly reset the <literal>version</literal> or " +"<literal>timestamp</literal> property values through the use of a " +"<literal>versioned update</literal>. This is achieved by adding the " +"<literal>VERSIONED</literal> keyword after the <literal>UPDATE</literal> " +"keyword." msgstr "" - "<![CDATA[Session session = sessionFactory.openSession(); -\n" - "Transaction tx = session.beginTransaction(); -\n" - "String hqlVersionedUpdate = \"update versioned Customer set name = :newName where name = :oldName\"; -\n" - "int updatedEntities = s.createQuery( hqlUpdate ) -\n" - " .setString( \"newName\", newName ) -\n" - " .setString( \"oldName\", oldName ) -\n" - " .executeUpdate(); -\n" - "tx.commit(); -\n" - "session.close();]]>" +"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> キーワードを追加することで行えます。" -#: index.docbook:174 +#. Tag: programlisting +#: batch.xml:174 +#, no-c-format msgid "" - "<![CDATA[Session session = sessionFactory.openSession();\n" - "Transaction tx = session.beginTransaction();\n" - "String hqlVersionedUpdate = \"update versioned Customer set name = :newName where name = :oldName\";\n" - "int updatedEntities = s.createQuery( hqlUpdate )\n" - " .setString( \"newName\", newName )\n" - " .setString( \"oldName\", oldName )\n" - " .executeUpdate();\n" - "tx.commit();\n" - "session.close();]]>" -msgstr "カスタムバージョン型（<literal>org.hibernate.usertype.UserVersionType</literal>）は <literal>update versioned</literal> 文と一緒に使えないことに注意してください。" +"<![CDATA[Session session = sessionFactory.openSession();\n" +"Transaction tx = session.beginTransaction();\n" +"String hqlVersionedUpdate = \"update versioned Customer set name = :newName " +"where name = :oldName\";\n" +"int updatedEntities = s.createQuery( hqlUpdate )\n" +" .setString( \"newName\", newName )\n" +" .setString( \"oldName\", oldName )\n" +" .executeUpdate();\n" +"tx.commit();\n" +"session.close();]]>" +msgstr "" -#: index.docbook:176 -msgid "Note that custom version types (<literal>org.hibernate.usertype.UserVersionType</literal>) are not allowed in conjunction with a <literal>update versioned</literal> statement." -msgstr "HQLの <literal>DELETE</literal> を実行するには、同じ <literal>Query.executeUpdate()</literal> メソッドを使ってください：" +#. Tag: para +#: batch.xml:176 +#, no-c-format +msgid "" +"Note that custom version types (<literal>org.hibernate.usertype." +"UserVersionType</literal>) are not allowed in conjunction with a " +"<literal>update versioned</literal> statement." +msgstr "" +"カスタムバージョン型（<literal>org.hibernate.usertype.UserVersionType</" +"literal>）は <literal>update versioned</literal> 文と一緒に使えないことに注" +"意してください。" -#: index.docbook:181 -msgid "To execute an HQL <literal>DELETE</literal>, use the same <literal>Query.executeUpdate()</literal> method:" +#. Tag: para +#: batch.xml:181 +#, no-c-format +msgid "" +"To execute an HQL <literal>DELETE</literal>, use the same <literal>Query." +"executeUpdate()</literal> method:" msgstr "" - "<![CDATA[Session session = sessionFactory.openSession(); -\n" - "Transaction tx = session.beginTransaction(); -\n" - " -\n" - "String hqlDelete = \"delete Customer c where c.name = :oldName\"; -\n" - "// or String hqlDelete = \"delete Customer where name = :oldName\"; -\n" - "int deletedEntities = s.createQuery( hqlDelete ) -\n" - " .setString( \"oldName\", oldName ) -\n" - " .executeUpdate(); -\n" - "tx.commit(); -\n" - "session.close();]]>" +"HQLの <literal>DELETE</literal> を実行するには、同じ <literal>Query." +"executeUpdate()</literal> メソッドを使ってください：" -#: index.docbook:186 +#. Tag: programlisting +#: batch.xml:186 +#, no-c-format msgid "" - "<![CDATA[Session session = sessionFactory.openSession();\n" - "Transaction tx = session.beginTransaction();\n" - "\n" - "String hqlDelete = \"delete Customer c where c.name = :oldName\";\n" - "// or String hqlDelete = \"delete Customer where name = :oldName\";\n" - "int deletedEntities = s.createQuery( hqlDelete )\n" - " .setString( \"oldName\", oldName )\n" - " .executeUpdate();\n" - "tx.commit();\n" - "session.close();]]>" -msgstr "<literal>Query.executeUpdate()</literal> メソッドが返す <literal>int</literal> の値は、この操作が影響を及ぼしたエンティティの数です。これが影響するデータベース内の行数と、相互に関係するかどうかを考えてみてください。 HQLバルク操作は、結果として、実際のSQL文が複数実行されることになります。例えばjoined-subclassです。返される数は、その文によって影響された実際のエンティティの数を示します。 joined-subclassの例に戻ると、サブクラスの一つに対する削除は、そのサブクラスがマッピングされたテーブルだけではなく、「ルート」テーブルと継承階層をさらに下ったjoined-subclassのテーブルの削除になります。" +"<![CDATA[Session session = sessionFactory.openSession();\n" +"Transaction tx = session.beginTransaction();\n" +"\n" +"String hqlDelete = \"delete Customer c where c.name = :oldName\";\n" +"// or String hqlDelete = \"delete Customer where name = :oldName\";\n" +"int deletedEntities = s.createQuery( hqlDelete )\n" +" .setString( \"oldName\", oldName )\n" +" .executeUpdate();\n" +"tx.commit();\n" +"session.close();]]>" +msgstr "" -#: index.docbook:188 -msgid "The <literal>int</literal> value returned by the <literal>Query.executeUpdate()</literal> method indicate the number of entities effected by the operation. Consider this may or may not correlate to the number of rows effected in the database. An HQL bulk operation might result in multiple actual SQL statements being executed, for joined-subclass, for example. The returned number indicates the number of actual entities affected by the statement. Going back to the example of joined-subclass, a delete against one of the subclasses may actually result in deletes against not just the table to which that subclass is mapped, but also the \"root\" table and potentially joined-subclass tables further down the inheritence hierarchy." -msgstr "<literal>INSERT</literal> 文の疑似構文は： <literal>INSERT INTO エンティティ名プロパティリスト select文</literal> です。注意すべき点がいくつかあります：" +#. Tag: para +#: batch.xml:188 +#, no-c-format +msgid "" +"The <literal>int</literal> value returned by the <literal>Query.executeUpdate" +"()</literal> method indicate the number of entities effected by the " +"operation. Consider this may or may not correlate to the number of rows " +"effected in the database. An HQL bulk operation might result in multiple " +"actual SQL statements being executed, for joined-subclass, for example. The " +"returned number indicates the number of actual entities affected by the " +"statement. Going back to the example of joined-subclass, a delete against " +"one of the subclasses may actually result in deletes against not just the " +"table to which that subclass is mapped, but also the \"root\" table and " +"potentially joined-subclass tables further down the inheritence hierarchy." +msgstr "" +"<literal>Query.executeUpdate()</literal> メソッドが返す <literal>int</" +"literal> の値は、この操作が影響を及ぼしたエンティティの数です。これが影響す" +"るデータベース内の行数と、相互に関係するかどうかを考えてみてください。 HQLバ" +"ルク操作は、結果として、実際のSQL文が複数実行されることになります。例えば" +"joined-subclassです。返される数は、その文によって影響された実際のエンティ" +"ティの数を示します。 joined-subclassの例に戻ると、サブクラスの一つに対する削" +"除は、そのサブクラスがマッピングされたテーブルだけではなく、「ルート」テー" +"ブルと継承階層をさらに下ったjoined-subclassのテーブルの削除になります。" -#: index.docbook:199 -msgid "The pseudo-syntax for <literal>INSERT</literal> statements is: <literal>INSERT INTO EntityName properties_list select_statement</literal>. Some points to note:" -msgstr "INSERT INTO ... SELECT ... の形式だけがサポートされています。 INSERT INTO ... VALUES ... の形式はサポートされていません。" +#. Tag: para +#: batch.xml:199 +#, no-c-format +msgid "" +"The pseudo-syntax for <literal>INSERT</literal> statements is: " +"<literal>INSERT INTO EntityName properties_list select_statement</literal>. " +"Some points to note:" +msgstr "" +"<literal>INSERT</literal> 文の疑似構文は： <literal>INSERT INTO エンティティ" +"名プロパティリスト select文</literal> です。注意すべき点がいくつかありま" +"す：" -#: index.docbook:207 -msgid "Only the INSERT INTO ... SELECT ... form is supported; not the INSERT INTO ... VALUES ... form." -msgstr "プロパティリストは、SQLの <literal>INSERT</literal> 文における <literal>カラムの仕様</literal> に類似しています。継承のマッピングに含まれるエンティティに対して、クラスレベルで直接定義されたプロパティだけが、プロパティリストに使えます。スーパークラスのプロパティは認められず、サブクラスのプロパティは効果がありません。言い換えると <literal>INSERT</literal> 文は、本質的にポリモーフィックではありません。" +#. Tag: para +#: batch.xml:207 +#, no-c-format +msgid "" +"Only the INSERT INTO ... SELECT ... form is supported; not the INSERT " +"INTO ... VALUES ... form." +msgstr "" +"INSERT INTO ... SELECT ... の形式だけがサポートされています。 INSERT " +"INTO ... VALUES ... の形式はサポートされていません。" -#: index.docbook:210 -msgid "The properties_list is analogous to the <literal>column speficiation</literal> in the SQL <literal>INSERT</literal> statement. For entities involved in mapped inheritence, only properties directly defined on that given class-level can be used in the properties_list. Superclass properties are not allowed; and subclass properties do not make sense. In other words, <literal>INSERT</literal> statements are inherently non-polymorphic." -msgstr "select文の返り値の型がinsert文が期待する型とマッチしていれば、そのselect文は妥当なHQL selectクエリとなりえます。現在このチェックをデータベースへ任せるのではなく、クエリのコンパイル時にチェックします。このことは、<emphasis>equal</emphasis>とは違い、 Hibernateの <literal>Type</literal> 間の <emphasis>equivalent</emphasis> に関する問題を引き起こすことに注意してください。これは <literal>org.hibernate.type.DataType</literal> として定義されたプロパティと、 <literal>org.hibernate.type.TimestampType</literal> として定義されたプロパティの間のミスマッチの問題を引き起こします。データベースがそれらを区別できなくても、変換することができても、この問題は発生します。" +#. Tag: para +#: batch.xml:210 +#, no-c-format +msgid "" +"The properties_list is analogous to the <literal>column speficiation</" +"literal> in the SQL <literal>INSERT</literal> statement. For entities " +"involved in mapped inheritence, only properties directly defined on that " +"given class-level can be used in the properties_list. Superclass properties " +"are not allowed; and subclass properties do not make sense. In other words, " +"<literal>INSERT</literal> statements are inherently non-polymorphic." +msgstr "" +"プロパティリストは、SQLの <literal>INSERT</literal> 文における <literal>カラ" +"ムの仕様</literal> に類似しています。継承のマッピングに含まれるエンティティ" +"に対して、クラスレベルで直接定義されたプロパティだけが、プロパティリストに使" +"えます。スーパークラスのプロパティは認められず、サブクラスのプロパティは効果" +"がありません。言い換えると <literal>INSERT</literal> 文は、本質的にポリモー" +"フィックではありません。" -#: index.docbook:220 -msgid "select_statement can be any valid HQL select query, with the caveat that the return types must match the types expected by the insert. Currently, this is checked during query compilation rather than allowing the check to relegate to the database. Note however that this might cause problems between Hibernate <literal>Type</literal>s which are <emphasis>equivalent</emphasis> as opposed to <emphasis>equal</emphasis>. This might cause issues with mismatches between a property defined as a <literal>org.hibernate.type.DateType</literal> and a property defined as a <literal>org.hibernate.type.TimestampType</literal>, even though the database might not make a distinction or might be able to handle the conversion." -msgstr "idプロパティに対して、insert文には二つの選択肢があります。プロパティリストで明示的にidプロパティを指定するか（この場合、対応するselect式から値が取られます）、プロパティリストから除外するか（この場合、生成される値が使われます）のいずれかです。後者の選択肢は、データベース内を操作するidジェネレータを使うときのみ、利用可能です。この選択肢を採る場合、「インメモリ」型のジェネレータを使うと、構文解析時に例外が発生します。この議論では、インデータベース型ジェネレータは <literal>org.hibernate.id.SequenceGenerator</literal> （とそのサブクラス）と、<literal>org.hibernate.id.PostInsertIdentifierGenerator</literal> の実装であると考えています。ここで最も注意すべき例外は、<literal>org.hibernate.id.TableHiLoGenerator! </literal> です。値を取得する選択可能な方法がないため、このジェネレータを使うことはできません。" +#. Tag: para +#: batch.xml:220 +#, no-c-format +msgid "" +"select_statement can be any valid HQL select query, with the caveat that the " +"return types must match the types expected by the insert. Currently, this is " +"checked during query compilation rather than allowing the check to relegate " +"to the database. Note however that this might cause problems between " +"Hibernate <literal>Type</literal>s which are <emphasis>equivalent</emphasis> " +"as opposed to <emphasis>equal</emphasis>. This might cause issues with " +"mismatches between a property defined as a <literal>org.hibernate.type." +"DateType</literal> and a property defined as a <literal>org.hibernate.type." +"TimestampType</literal>, even though the database might not make a " +"distinction or might be able to handle the conversion." +msgstr "" +"select文の返り値の型がinsert文が期待する型とマッチしていれば、そのselect文は" +"妥当なHQL selectクエリとなりえます。現在このチェックをデータベースへ任せるの" +"ではなく、クエリのコンパイル時にチェックします。このことは、" +"<emphasis>equal</emphasis>とは違い、 Hibernateの <literal>Type</literal> 間" +"の <emphasis>equivalent</emphasis> に関する問題を引き起こすことに注意してく" +"ださい。これは <literal>org.hibernate.type.DataType</literal> として定義され" +"たプロパティと、 <literal>org.hibernate.type.TimestampType</literal> として定" +"義されたプロパティの間のミスマッチの問題を引き起こします。データベースがそれ" +"らを区別できなくても、変換することができても、この問題は発生します。" -#: index.docbook:232 -msgid "For the id property, the insert statement gives you two options. You can either explicitly specify the id property in the properties_list (in which case its value is taken from the corresponding select expression) or omit it from the properties_list (in which case a generated value is used). This later option is only available when using id generators that operate in the database; attempting to use this option with any \"in memory\" type generators will cause an exception during parsing. Note that for the purposes of this discussion, in-database generators are considered to be <literal>org.hibernate.id.SequenceGenerator</literal> (and its subclasses) and any implementors of <literal>org.hibernate.id.PostInsertIdentifierGenerator</literal>. The most notable exception here is <literal>org.hibernate.id.TableHiLoGenerator</literal>, which cannot be used because it does not expose a selectable way to get its values." -msgstr "<literal>version</literal> や <literal>timestamp</literal> としてマッピングされるプロパティに対して、 insert文には二つの選択肢があります。プロパティリストで明示的にプロパティを指定するか（この場合、対応するselect式から値が取られます）、プロパティリストから除外するか（この場合、<literal>org.hibernate.type.VersionType</literal> で定義された <literal>シード値</literal> が使われます）のいずれかです。" +#. Tag: para +#: batch.xml:232 +#, no-c-format +msgid "" +"For the id property, the insert statement gives you two options. You can " +"either explicitly specify the id property in the properties_list (in which " +"case its value is taken from the corresponding select expression) or omit it " +"from the properties_list (in which case a generated value is used). This " +"later option is only available when using id generators that operate in the " +"database; attempting to use this option with any \"in memory\" type " +"generators will cause an exception during parsing. Note that for the " +"purposes of this discussion, in-database generators are considered to be " +"<literal>org.hibernate.id.SequenceGenerator</literal> (and its subclasses) " +"and any implementors of <literal>org.hibernate.id." +"PostInsertIdentifierGenerator</literal>. The most notable exception here is " +"<literal>org.hibernate.id.TableHiLoGenerator</literal>, which cannot be used " +"because it does not expose a selectable way to get its values." +msgstr "" +"idプロパティに対して、insert文には二つの選択肢があります。プロパティリストで" +"明示的にidプロパティを指定するか（この場合、対応するselect式から値が取られま" +"す）、プロパティリストから除外するか（この場合、生成される値が使われます）" +"のいずれかです。後者の選択肢は、データベース内を操作するidジェネレータを使う" +"ときのみ、利用可能です。この選択肢を採る場合、「インメモリ」型のジェネレータ" +"を使うと、構文解析時に例外が発生します。この議論では、インデータベース型ジェ" +"ネレータは <literal>org.hibernate.id.SequenceGenerator</literal> （とそのサブ" +"クラス）と、<literal>org.hibernate.id.PostInsertIdentifierGenerator</" +"literal> の実装であると考えています。ここで最も注意すべき例外は、" +"<literal>org.hibernate.id.TableHiLoGenerator</literal> です。値を取得する選" +"択可能な方法がないため、このジェネレータを使うことはできません。" -#: index.docbook:247 -msgid "For properties mapped as either <literal>version</literal> or <literal>timestamp</literal>, the insert statement gives you two options. You can either specify the property in the properties_list (in which case its value is taken from the corresponding select expressions) or omit it from the properties_list (in which case the <literal>seed value</literal> defined by the <literal>org.hibernate.type.VersionType</literal> is used)." -msgstr "HQLの <literal>INSERT</literal> 文の実行例です：" +#. Tag: para +#: batch.xml:247 +#, no-c-format +msgid "" +"For properties mapped as either <literal>version</literal> or " +"<literal>timestamp</literal>, the insert statement gives you two options. " +"You can either specify the property in the properties_list (in which case " +"its value is taken from the corresponding select expressions) or omit it " +"from the properties_list (in which case the <literal>seed value</literal> " +"defined by the <literal>org.hibernate.type.VersionType</literal> is used)." +msgstr "" +"<literal>version</literal> や <literal>timestamp</literal> としてマッピングさ" +"れるプロパティに対して、 insert文には二つの選択肢があります。プロパティリス" +"トで明示的にプロパティを指定するか（この場合、対応するselect式から値が取られ" +"ます）、プロパティリストから除外するか（この場合、<literal>org.hibernate." +"type.VersionType</literal> で定義された <literal>シード値</literal> が使われ" +"ます）のいずれかです。" -#: index.docbook:257 +#. Tag: para +#: batch.xml:257 +#, no-c-format msgid "An example HQL <literal>INSERT</literal> statement execution:" -msgstr "" - "<![CDATA[Session session = sessionFactory.openSession(); -\n" - "Transaction tx = session.beginTransaction(); -\n" - " -\n" - "String hqlInsert = \"insert into DelinquentAccount (id, name) select c.id, c.name from Customer c where ...\"; -\n" - "int createdEntities = s.createQuery( hqlInsert ) -\n" - " .executeUpdate(); -\n" - "tx.commit(); -\n" - "session.close();]]>" +msgstr "HQLの <literal>INSERT</literal> 文の実行例です：" -#: index.docbook:261 +#. Tag: programlisting +#: batch.xml:261 +#, no-c-format msgid "" - "<![CDATA[Session session = sessionFactory.openSession();\n" - "Transaction tx = session.beginTransaction();\n" - "\n" - "String hqlInsert = \"insert into DelinquentAccount (id, name) select c.id, c.name from Customer c where ...\";\n" - "int createdEntities = s.createQuery( hqlInsert )\n" - " .executeUpdate();\n" - "tx.commit();\n" - "session.close();]]>" +"<![CDATA[Session session = sessionFactory.openSession();\n" +"Transaction tx = session.beginTransaction();\n" +"\n" +"String hqlInsert = \"insert into DelinquentAccount (id, name) select c.id, c." +"name from Customer c where ...\";\n" +"int createdEntities = s.createQuery( hqlInsert )\n" +" .executeUpdate();\n" +"tx.commit();\n" +"session.close();]]>" msgstr "" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "" - Modified: core/trunk/documentation/manual/translations/ja-JP/content/best_practices.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/best_practices.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/best_practices.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,168 +1,447 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: best_practices.xml:5 +#, no-c-format msgid "Best Practices" msgstr "ベストプラクティス" -#: index.docbook:9 -msgid "Write fine-grained classes and map them using <literal><component></literal>." -msgstr "クラスは細かい粒度で書き <literal><component></literal> でマッピングしましょう。" +#. Tag: term +#: best_practices.xml:9 +#, no-c-format +msgid "" +"Write fine-grained classes and map them using <literal><component></" +"literal>." +msgstr "" +"クラスは細かい粒度で書き <literal><component></literal> でマッピングし" +"ましょう。" -#: index.docbook:11 -msgid "Use an <literal>Address</literal> class to encapsulate <literal>street</literal>, <literal>suburb</literal>, <literal>state</literal>, <literal>postcode</literal>. This encourages code reuse and simplifies refactoring." -msgstr "<literal>street</literal>（通り）, <literal>suburb</literal> （都市）, <literal>state</literal>（州）, <literal>postcode</literal> （郵便番号）をカプセル化する <literal>Address</literal>（住所）クラスを使いましょう。そうすればコードが再利用しやすくなり、リファクタリングも簡単になります。" +#. Tag: para +#: best_practices.xml:11 +#, no-c-format +msgid "" +"Use an <literal>Address</literal> class to encapsulate <literal>street</" +"literal>, <literal>suburb</literal>, <literal>state</literal>, " +"<literal>postcode</literal>. This encourages code reuse and simplifies " +"refactoring." +msgstr "" +"<literal>street</literal>（通り）, <literal>suburb</literal> （都市）, " +"<literal>state</literal>（州）, <literal>postcode</literal> （郵便番号）をカ" +"プセル化する <literal>Address</literal>（住所）クラスを使いましょう。そうす" +"ればコードが再利用しやすくなり、リファクタリングも簡単になります。" -#: index.docbook:19 +#. Tag: term +#: best_practices.xml:19 +#, no-c-format msgid "Declare identifier properties on persistent classes." msgstr "永続クラスには識別子プロパティを定義しましょう。" -#: index.docbook:21 -msgid "Hibernate makes identifier properties optional. There are all sorts of reasons why you should use them. We recommend that identifiers be 'synthetic' (generated, with no business meaning)." -msgstr "Hibernateでは識別子プロパティはオプションですが、使用すべき理由がたくさんあります。識別子は「人工的」（生成された、業務的な意味を持たない）なものにすることをおすすめします。" +#. Tag: para +#: best_practices.xml:21 +#, no-c-format +msgid "" +"Hibernate makes identifier properties optional. There are all sorts of " +"reasons why you should use them. We recommend that identifiers be " +"'synthetic' (generated, with no business meaning)." +msgstr "" +"Hibernateでは識別子プロパティはオプションですが、使用すべき理由がたくさんあ" +"ります。識別子は「人工的」（生成された、業務的な意味を持たない）なものにす" +"ることをおすすめします。" -#: index.docbook:29 +#. Tag: term +#: best_practices.xml:29 +#, no-c-format msgid "Identify natural keys." msgstr "自然キーを見つけましょう。" -#: index.docbook:31 -msgid "Identify natural keys for all entities, and map them using <literal><natural-id></literal>. Implement <literal>equals()</literal> and <literal>hashCode()</literal> to compare the properties that make up the natural key." -msgstr "すべてのエンティティに対して自然キーを見つけて、 <literal><natural-id></literal> でマッピングしましょう。自然キーを構成するプロパティを比較するために、 <literal>equals()</literal> と <literal>hashCode()</literal> を実装しましょう。" +#. Tag: para +#: best_practices.xml:31 +#, no-c-format +msgid "" +"Identify natural keys for all entities, and map them using <literal><" +"natural-id></literal>. Implement <literal>equals()</literal> and " +"<literal>hashCode()</literal> to compare the properties that make up the " +"natural key." +msgstr "" +"すべてのエンティティに対して自然キーを見つけて、 <literal><natural-id>" +"</literal> でマッピングしましょう。自然キーを構成するプロパティを比較するた" +"めに、 <literal>equals()</literal> と <literal>hashCode()</literal> を実装し" +"ましょう。" -#: index.docbook:39 +#. Tag: term +#: best_practices.xml:39 +#, no-c-format msgid "Place each class mapping in its own file." msgstr "クラスのマッピングはそれぞれのクラス専用のファイルに書きましょう。" -#: index.docbook:41 -msgid "Don't use a single monolithic mapping document. Map <literal>com.eg.Foo</literal> in the file <literal>com/eg/Foo.hbm.xml</literal>. This makes particularly good sense in a team environment." -msgstr "単一の巨大なマッピングドキュメントを使用しないでください。 <literal>com.eg.Foo</literal> クラスなら <literal>com/eg/Foo.hbm.xml</literal> ファイルにマッピングしましょう。このことは、特にチームでの開発に意味があります。" +#. Tag: para +#: best_practices.xml:41 +#, no-c-format +msgid "" +"Don't use a single monolithic mapping document. Map <literal>com.eg.Foo</" +"literal> in the file <literal>com/eg/Foo.hbm.xml</literal>. This makes " +"particularly good sense in a team environment." +msgstr "" +"単一の巨大なマッピングドキュメントを使用しないでください。 <literal>com.eg." +"Foo</literal> クラスなら <literal>com/eg/Foo.hbm.xml</literal> ファイルにマッ" +"ピングしましょう。このことは、特にチームでの開発に意味があります。" -#: index.docbook:49 +#. Tag: term +#: best_practices.xml:49 +#, no-c-format msgid "Load mappings as resources." msgstr "リソースとしてマッピングをロードしましょう。" -#: index.docbook:51 +#. Tag: para +#: best_practices.xml:51 +#, no-c-format msgid "Deploy the mappings along with the classes they map." msgstr "マッピングを、それらがマッピングするするクラスと一緒に配置しましょう。" -#: index.docbook:57 +#. Tag: term +#: best_practices.xml:57 +#, no-c-format msgid "Consider externalising query strings." msgstr "クエリ文字列を外部に置くことを考えましょう" -#: index.docbook:59 -msgid "This is a good practice if your queries call non-ANSI-standard SQL functions. Externalising the query strings to mapping files will make the application more portable." -msgstr "クエリがANSI標準でないSQL関数を呼んでいるなら、これはよいプラクティスです。クエリ文字列をマッピングファイルへ外出しすればアプリケーションがポータブルになります。" +#. Tag: para +#: best_practices.xml:59 +#, no-c-format +msgid "" +"This is a good practice if your queries call non-ANSI-standard SQL " +"functions. Externalising the query strings to mapping files will make the " +"application more portable." +msgstr "" +"クエリがANSI標準でないSQL関数を呼んでいるなら、これはよいプラクティスです。 " +"クエリ文字列をマッピングファイルへ外出しすればアプリケーションがポータブルに" +"なります。" -#: index.docbook:67 +#. Tag: term +#: best_practices.xml:67 +#, no-c-format msgid "Use bind variables." msgstr "バインド変数を使いましょう。" -#: index.docbook:69 -msgid "As in JDBC, always replace non-constant values by \"?\". Never use string manipulation to bind a non-constant value in a query! Even better, consider using named parameters in queries." -msgstr "JDBCの場合と同じように、定数でない値は必ず\"?\"で置き換えましょう。定数でない値をバインドするために、クエリで文字列操作を使ってはいけません。名前付きのパラメータを使うようにするとさらに良いです。" +#. Tag: para +#: best_practices.xml:69 +#, no-c-format +msgid "" +"As in JDBC, always replace non-constant values by \"?\". Never use string " +"manipulation to bind a non-constant value in a query! Even better, consider " +"using named parameters in queries." +msgstr "" +"JDBCの場合と同じように、定数でない値は必ず\"?\"で置き換えましょう。定数でな" +"い値をバインドするために、クエリで文字列操作を使ってはいけません。名前付きの" +"パラメータを使うようにするとさらに良いです。" -#: index.docbook:77 +#. Tag: term +#: best_practices.xml:77 +#, no-c-format msgid "Don't manage your own JDBC connections." msgstr "JDBCコネクションを管理してはいけません。" -#: index.docbook:79 -msgid "Hibernate lets the application manage JDBC connections. This approach should be considered a last-resort. If you can't use the built-in connections providers, consider providing your own implementation of <literal>org.hibernate.connection.ConnectionProvider</literal>." -msgstr "HibernateではアプリケーションがJDBCコネクションを管理することが許されています。しかしこれは最終手段だと思ってください。組み込みのコネクションプロバイダを使うことができなければ、 <literal>org.hibernate.connection.ConnectionProvider</literal> を実装することを考えてください。" +#. Tag: para +#: best_practices.xml:79 +#, no-c-format +msgid "" +"Hibernate lets the application manage JDBC connections. This approach should " +"be considered a last-resort. If you can't use the built-in connections " +"providers, consider providing your own implementation of <literal>org." +"hibernate.connection.ConnectionProvider</literal>." +msgstr "" +"HibernateではアプリケーションがJDBCコネクションを管理することが許されていま" +"す。しかしこれは最終手段だと思ってください。組み込みのコネクションプロバイ" +"ダを使うことができなければ、 <literal>org.hibernate.connection." +"ConnectionProvider</literal> を実装することを考えてください。" -#: index.docbook:87 +#. Tag: term +#: best_practices.xml:87 +#, no-c-format msgid "Consider using a custom type." msgstr "カスタム型の使用を考えましょう。" -#: index.docbook:89 -msgid "Suppose you have a Java type, say from some library, that needs to be persisted but doesn't provide the accessors needed to map it as a component. You should consider implementing <literal>org.hibernate.UserType</literal>. This approach frees the application code from implementing transformations to / from a Hibernate type." -msgstr "あるライブラリから持ってきたJava型を永続化する必要があるとしましょう。しかしその型には、コンポーネントとしてマッピングするために必要なアクセサがないとします。このような場合は <literal>org.hibernate.UserType</literal> の実装を考えるべきです。そうすればHibernate型との実装変換を心配せずにアプリケーションのコードを扱えます。" +#. Tag: para +#: best_practices.xml:89 +#, no-c-format +msgid "" +"Suppose you have a Java type, say from some library, that needs to be " +"persisted but doesn't provide the accessors needed to map it as a component. " +"You should consider implementing <literal>org.hibernate.UserType</literal>. " +"This approach frees the application code from implementing transformations " +"to / from a Hibernate type." +msgstr "" +"あるライブラリから持ってきたJava型を永続化する必要があるとしましょう。しかし" +"その型には、コンポーネントとしてマッピングするために必要なアクセサがないとし" +"ます。このような場合は <literal>org.hibernate.UserType</literal> の実装を考" +"えるべきです。そうすればHibernate型との実装変換を心配せずにアプリケーション" +"のコードを扱えます。" -#: index.docbook:98 +#. Tag: term +#: best_practices.xml:98 +#, no-c-format msgid "Use hand-coded JDBC in bottlenecks." msgstr "ボトルネックを解消するにはJDBCをハンドコードしましょう。" -#: index.docbook:100 -msgid "In performance-critical areas of the system, some kinds of operations might benefit from direct JDBC. But please, wait until you <emphasis>know</emphasis> something is a bottleneck. And don't assume that direct JDBC is necessarily faster. If you need to use direct JDBC, it might be worth opening a Hibernate <literal>Session</literal> and using that JDBC connection. That way you can still use the same transaction strategy and underlying connection provider." -msgstr "システムのパフォーマンスクリティカルな領域では、ある種の操作にJDBCを直接使うと良いかもしれません。しかし何がボトルネックになっているか <emphasis>はっきりする</emphasis> までは待ってください。またJDBCを直接使うからといって、必ずしも速くなるとは限らないことも理解してください。 JDBCを直接使う必要があれば、Hibernateの <literal>Session</literal> をオープンして、 JDBCコネクションを使うと良いかもしれません。依然として同じトランザクション戦略とコネクションプロバイダが使えるからです。" +#. Tag: para +#: best_practices.xml:100 +#, no-c-format +msgid "" +"In performance-critical areas of the system, some kinds of operations might " +"benefit from direct JDBC. But please, wait until you <emphasis>know</" +"emphasis> something is a bottleneck. And don't assume that direct JDBC is " +"necessarily faster. If you need to use direct JDBC, it might be worth " +"opening a Hibernate <literal>Session</literal> and using that JDBC " +"connection. That way you can still use the same transaction strategy and " +"underlying connection provider." +msgstr "" +"システムのパフォーマンスクリティカルな領域では、ある種の操作にJDBCを直接使う" +"と良いかもしれません。しかし何がボトルネックになっているか <emphasis>はっき" +"りする</emphasis> までは待ってください。またJDBCを直接使うからといって、必ず" +"しも速くなるとは限らないことも理解してください。 JDBCを直接使う必要があれば、" +"Hibernateの <literal>Session</literal> をオープンして、 JDBCコネクションを使" +"うと良いかもしれません。依然として同じトランザクション戦略とコネクションプロ" +"バイダが使えるからです。" -#: index.docbook:110 +#. Tag: term +#: best_practices.xml:110 +#, no-c-format msgid "Understand <literal>Session</literal> flushing." msgstr "<literal>Session</literal> のフラッシュを理解しましょう。" -#: index.docbook:112 -msgid "From time to time the Session synchronizes its persistent state with the database. Performance will be affected if this process occurs too often. You may sometimes minimize unnecessary flushing by disabling automatic flushing or even by changing the order of queries and other operations within a particular transaction." -msgstr "Sessionが永続状態をデータベースと同期させることがときどきあります。しかしこれがあまりに頻繁に起こるようだと、パフォーマンスに影響が出てきます。自動フラッシュを無効にしたり、特定のトランザクションのクエリや操作の順番を変更することで、不必要なフラッシュを最小限にできます。" +#. Tag: para +#: best_practices.xml:112 +#, no-c-format +msgid "" +"From time to time the Session synchronizes its persistent state with the " +"database. Performance will be affected if this process occurs too often. You " +"may sometimes minimize unnecessary flushing by disabling automatic flushing " +"or even by changing the order of queries and other operations within a " +"particular transaction." +msgstr "" +"Sessionが永続状態をデータベースと同期させることがときどきあります。しかしこ" +"れがあまりに頻繁に起こるようだと、パフォーマンスに影響が出てきます。自動フ" +"ラッシュを無効にしたり、特定のトランザクションのクエリや操作の順番を変更する" +"ことで、不必要なフラッシュを最小限にできます。" -#: index.docbook:121 +#. Tag: term +#: best_practices.xml:121 +#, no-c-format msgid "In a three tiered architecture, consider using detached objects." msgstr "3層アーキテクチャでは分離オブジェクトの使用を考えましょう。" -#: index.docbook:123 -msgid "When using a servlet / session bean architecture, you could pass persistent objects loaded in the session bean to and from the servlet / JSP layer. Use a new session to service each request. Use <literal>Session.merge()</literal> or <literal>Session.saveOrUpdate()</literal> to synchronize objects with the database." -msgstr "サーブレット / セッションビーンアーキテクチャを使うとき、サーブレット層 / JSP層間でセッションビーンでロードした永続オブジェクトをやり取りできます。その際リクエストごとに新しいSessionを使ってください。また <literal>Session.merge()</literal> や <literal>Session.saveOrUpdate()</literal> を使って、オブジェクトとデータベースを同期させてください。" +#. Tag: para +#: best_practices.xml:123 +#, no-c-format +msgid "" +"When using a servlet / session bean architecture, you could pass persistent " +"objects loaded in the session bean to and from the servlet / JSP layer. Use " +"a new session to service each request. Use <literal>Session.merge()</" +"literal> or <literal>Session.saveOrUpdate()</literal> to synchronize objects " +"with the database." +msgstr "" +"サーブレット / セッションビーンアーキテクチャを使うとき、サーブレット層 / " +"JSP層間でセッションビーンでロードした永続オブジェクトをやり取りできます。そ" +"の際リクエストごとに新しいSessionを使ってください。また <literal>Session." +"merge()</literal> や <literal>Session.saveOrUpdate()</literal> を使って、オブ" +"ジェクトとデータベースを同期させてください。" -#: index.docbook:132 +#. Tag: term +#: best_practices.xml:132 +#, no-c-format msgid "In a two tiered architecture, consider using long persistence contexts." msgstr "2層アーキテクチャでは長い永続コンテキストの使用を考えましょう。" -#: index.docbook:134 -msgid "Database Transactions have to be as short as possible for best scalability. However, it is often neccessary to implement long running <emphasis>application transactions</emphasis>, a single unit-of-work from the point of view of a user. An application transaction might span several client request/response cycles. It is common to use detached objects to implement application transactions. An alternative, extremely appropriate in two tiered architecture, is to maintain a single open persistence contact (session) for the whole life cycle of the application transaction and simply disconnect from the JDBC connection at the end of each request and reconnect at the beginning of the subsequent request. Never share a single session across more than one application transaction, or you will be working with stale data." -msgstr "最高のスケーラビリティを得るには、データベーストランザクションをできるだけ短くしなければなりません。しかし長い間実行する <emphasis>アプリケーショントランザクション</emphasis> の実装が必要なことはしばしばです。これはユーザの視点からは1個の作業単位（unit of work）になります。アプリケーショントランザクションはいくつかのクライアントのリクエスト/レスポンスサイクルにまたがります。アプリケーショントランザクションの実装に分離オブジェクトを使うのは一般的です。そうでなければ、2層アーキテクチャの場合は特に適切なことですが、アプリケーショントランザクションのライフサイクル全体に対して単一のオープンな永続化コンテキスト（セッション）を維持してください。そして単純にリ! クエストの最後にJDBCコネクションから切断し、次のリクエストの最初に再接続します。決して複数のアプリケーショントランザクションユースケースに渡って 1個のSessionを使い回さないでください。そうでなければ、古いデータで作業することになります。" +#. Tag: para +#: best_practices.xml:134 +#, no-c-format +msgid "" +"Database Transactions have to be as short as possible for best scalability. " +"However, it is often neccessary to implement long running " +"<emphasis>application transactions</emphasis>, a single unit-of-work from " +"the point of view of a user. An application transaction might span several " +"client request/response cycles. It is common to use detached objects to " +"implement application transactions. An alternative, extremely appropriate in " +"two tiered architecture, is to maintain a single open persistence contact " +"(session) for the whole life cycle of the application transaction and simply " +"disconnect from the JDBC connection at the end of each request and reconnect " +"at the beginning of the subsequent request. Never share a single session " +"across more than one application transaction, or you will be working with " +"stale data." +msgstr "" +"最高のスケーラビリティを得るには、データベーストランザクションをできるだけ短" +"くしなければなりません。しかし長い間実行する <emphasis>アプリケーショントラ" +"ンザクション</emphasis> の実装が必要なことはしばしばです。これはユーザの視点" +"からは1個の作業単位（unit of work）になります。アプリケーショントランザク" +"ションはいくつかのクライアントのリクエスト/レスポンスサイクルにまたがりま" +"す。アプリケーショントランザクションの実装に分離オブジェクトを使うのは一般的" +"です。そうでなければ、2層アーキテクチャの場合は特に適切なことですが、アプリ" +"ケーショントランザクションのライフサイクル全体に対して単一のオープンな永続化" +"コンテキスト（セッション）を維持してください。そして単純にリクエストの最後に" +"JDBCコネクションから切断し、次のリクエストの最初に再接続します。決して複数" +"のアプリケーショントランザクションユースケースに渡って 1個のSessionを使い回さ" +"ないでください。そうでなければ、古いデータで作業することになります。" -#: index.docbook:148 +#. Tag: term +#: best_practices.xml:148 +#, no-c-format msgid "Don't treat exceptions as recoverable." msgstr "例外を復帰可能なものとして扱ってはいけません。" -#: index.docbook:150 -msgid "This is more of a necessary practice than a \"best\" practice. When an exception occurs, roll back the <literal>Transaction</literal> and close the <literal>Session</literal>. If you don't, Hibernate can't guarantee that in-memory state accurately represents persistent state. As a special case of this, do not use <literal>Session.load()</literal> to determine if an instance with the given identifier exists on the database; use <literal>Session.get()</literal> or a query instead." -msgstr "これは「ベスト」プラクティス以上の、必須のプラクティスです。例外が発生したときは <literal>Transaction</literal> をロールバックして、 <literal>Session</literal> をクローズしてください。そうしないとHibernateはメモリの状態が永続状態を正確に表現していることを保証できません。この特別な場合として、与えられた識別子を持つインスタンスがデータベースに存在するかどうかを判定するために、 <literal>Session.load()</literal> を使うことはやめてください。その代わりに <literal>Session.get()</literal> かクエリを使ってください。" +#. Tag: para +#: best_practices.xml:150 +#, no-c-format +msgid "" +"This is more of a necessary practice than a \"best\" practice. When an " +"exception occurs, roll back the <literal>Transaction</literal> and close the " +"<literal>Session</literal>. If you don't, Hibernate can't guarantee that in-" +"memory state accurately represents persistent state. As a special case of " +"this, do not use <literal>Session.load()</literal> to determine if an " +"instance with the given identifier exists on the database; use " +"<literal>Session.get()</literal> or a query instead." +msgstr "" +"これは「ベスト」プラクティス以上の、必須のプラクティスです。例外が発生したと" +"きは <literal>Transaction</literal> をロールバックして、 <literal>Session</" +"literal> をクローズしてください。そうしないとHibernateはメモリの状態が永続状" +"態を正確に表現していることを保証できません。この特別な場合として、与えられた" +"識別子を持つインスタンスがデータベースに存在するかどうかを判定するために、 " +"<literal>Session.load()</literal> を使うことはやめてください。その代わりに " +"<literal>Session.get()</literal> かクエリを使ってください。" -#: index.docbook:160 +#. Tag: term +#: best_practices.xml:160 +#, no-c-format msgid "Prefer lazy fetching for associations." msgstr "関連にはなるべく遅延フェッチを使いましょう。" -#: index.docbook:162 -msgid "Use eager fetching sparingly. Use proxies and lazy collections for most associations to classes that are not likely to be completely held in the second-level cache. For associations to cached classes, where there is an a extremely high probability of a cache hit, explicitly disable eager fetching using <literal>lazy=\"false\"</literal>. When an join fetching is appropriate to a particular use case, use a query with a <literal>left join fetch</literal>." -msgstr "即時フェッチは控えめにしましょう。二次キャッシュには完全に保持されないようなクラスの関連には、プロキシと遅延コレクションを使ってください。キャッシュされるクラスの関連、つまりキャッシュがヒットする可能性が非常に高い関連は、 <literal>lazy=\"false\"</literal> で積極的なフェッチを明示的に無効にしてください。結合フェッチが適切な特定のユースケースには、クエリで <literal>left join fetch</literal> を使ってください。" +#. Tag: para +#: best_practices.xml:162 +#, no-c-format +msgid "" +"Use eager fetching sparingly. Use proxies and lazy collections for most " +"associations to classes that are not likely to be completely held in the " +"second-level cache. For associations to cached classes, where there is an a " +"extremely high probability of a cache hit, explicitly disable eager fetching " +"using <literal>lazy=\"false\"</literal>. When an join fetching is " +"appropriate to a particular use case, use a query with a <literal>left join " +"fetch</literal>." +msgstr "" +"即時フェッチは控えめにしましょう。二次キャッシュには完全に保持されないような" +"クラスの関連には、プロキシと遅延コレクションを使ってください。キャッシュさ" +"れるクラスの関連、つまりキャッシュがヒットする可能性が非常に高い関連は、 " +"<literal>lazy=\"false\"</literal> で積極的なフェッチを明示的に無効にしてくだ" +"さい。結合フェッチが適切な特定のユースケースには、クエリで <literal>left " +"join fetch</literal> を使ってください。" -#: index.docbook:172 -msgid "Use the <emphasis>open session in view</emphasis> pattern, or a disciplined <emphasis>assembly phase</emphasis> to avoid problems with unfetched data." -msgstr "フェッチされていないデータに関わる問題を避けるために、 <emphasis>ビューの中でオープンセッションを使う(open session in view)</emphasis> パターンか、統制された <emphasis>組み立てフェーズ(assembly phase)</emphasis> を使いましょう。" +#. Tag: term +#: best_practices.xml:172 +#, no-c-format +msgid "" +"Use the <emphasis>open session in view</emphasis> pattern, or a disciplined " +"<emphasis>assembly phase</emphasis> to avoid problems with unfetched data." +msgstr "" +"フェッチされていないデータに関わる問題を避けるために、 <emphasis>ビューの中で" +"オープンセッションを使う(open session in view)</emphasis> パターンか、統制さ" +"れた <emphasis>組み立てフェーズ(assembly phase)</emphasis> を使いましょう。" -#: index.docbook:177 -msgid "Hibernate frees the developer from writing tedious <emphasis>Data Transfer Objects</emphasis> (DTO). In a traditional EJB architecture, DTOs serve dual purposes: first, they work around the problem that entity beans are not serializable; second, they implicitly define an assembly phase where all data to be used by the view is fetched and marshalled into the DTOs before returning control to the presentation tier. Hibernate eliminates the first purpose. However, you will still need an assembly phase (think of your business methods as having a strict contract with the presentation tier about what data is available in the detached objects) unless you are prepared to hold the persistence context (the session) open across the view rendering process. This is not a limitation of Hibernate! It is a fundamental requirement of safe transactional data access." -msgstr "Hibernateは <emphasis>Data Transfer Objects</emphasis> (DTO)を書く退屈な作業から開発者を解放します。伝統的なEJBアーキテクチャではDTOは二つ目的があります： 1つ目は、エンティティビーンがシリアライズされない問題への対策です。 2つ目は、プレゼンテーション層に制御が戻る前に、ビューに使われるすべてのデータがフェッチされて、DTOに復元されるような組み立てフェーズを暗黙的に定義します。 Hibernateでは1つ目の目的が不要になります。しかしビューのレンダリング処理の間、永続コンテキスト（セッション）をオープンにしたままにしなければ、組み立てフェーズはまだ必要です（分離オブジェクトの中のどのデータが利用可能かについて、プレゼンテーション層と厳密な取り決めをしているビジネスメソッドを考えて�! �てください）。これはHibernate側の問題ではありません。トランザクション内で安全にデータアクセスするための基本的な要件です。" +#. Tag: para +#: best_practices.xml:177 +#, no-c-format +msgid "" +"Hibernate frees the developer from writing tedious <emphasis>Data Transfer " +"Objects</emphasis> (DTO). In a traditional EJB architecture, DTOs serve dual " +"purposes: first, they work around the problem that entity beans are not " +"serializable; second, they implicitly define an assembly phase where all " +"data to be used by the view is fetched and marshalled into the DTOs before " +"returning control to the presentation tier. Hibernate eliminates the first " +"purpose. However, you will still need an assembly phase (think of your " +"business methods as having a strict contract with the presentation tier " +"about what data is available in the detached objects) unless you are " +"prepared to hold the persistence context (the session) open across the view " +"rendering process. This is not a limitation of Hibernate! It is a " +"fundamental requirement of safe transactional data access." +msgstr "" +"Hibernateは <emphasis>Data Transfer Objects</emphasis> (DTO)を書く退屈な作業" +"から開発者を解放します。伝統的なEJBアーキテクチャではDTOは二つ目的がありま" +"す： 1つ目は、エンティティビーンがシリアライズされない問題への対策です。 2つ" +"目は、プレゼンテーション層に制御が戻る前に、ビューに使われるすべてのデータが" +"フェッチされて、DTOに復元されるような組み立てフェーズを暗黙的に定義します。 " +"Hibernateでは1つ目の目的が不要になります。しかしビューのレンダリング処理の" +"間、永続コンテキスト（セッション）をオープンにしたままにしなければ、組み立て" +"フェーズはまだ必要です（分離オブジェクトの中のどのデータが利用可能かについ" +"て、プレゼンテーション層と厳密な取り決めをしているビジネスメソッドを考えてみ" +"てください）。これはHibernate側の問題ではありません。トランザクション内で安" +"全にデータアクセスするための基本的な要件です。" -#: index.docbook:191 +#. Tag: term +#: best_practices.xml:191 +#, no-c-format msgid "Consider abstracting your business logic from Hibernate." msgstr "Hibernateからビジネスロジックを抽象化することを考えましょう。" -#: index.docbook:193 -msgid "Hide (Hibernate) data-access code behind an interface. Combine the <emphasis>DAO</emphasis> and <emphasis>Thread Local Session</emphasis> patterns. You can even have some classes persisted by handcoded JDBC, associated to Hibernate via a <literal>UserType</literal>. (This advice is intended for \"sufficiently large\" applications; it is not appropriate for an application with five tables!)" -msgstr "インターフェイスで（Hibernateの）データアクセスコードを隠蔽しましょう。 <emphasis>DAO</emphasis> と <emphasis>Thread Local Session</emphasis> パターンを組み合わせましょう。 <literal>UserType</literal> でHibernateに関連付けると、ハンドコードしたJDBCで永続化するクラスを持つこともできます。（このアドバイスは「十分大きな」アプリケーションに対してのものです。テーブルが5個しかないようなアプリケーションには当てはまりません。）" +#. Tag: para +#: best_practices.xml:193 +#, no-c-format +msgid "" +"Hide (Hibernate) data-access code behind an interface. Combine the " +"<emphasis>DAO</emphasis> and <emphasis>Thread Local Session</emphasis> " +"patterns. You can even have some classes persisted by handcoded JDBC, " +"associated to Hibernate via a <literal>UserType</literal>. (This advice is " +"intended for \"sufficiently large\" applications; it is not appropriate for " +"an application with five tables!)" +msgstr "" +"インターフェイスで（Hibernateの）データアクセスコードを隠蔽しましょう。 " +"<emphasis>DAO</emphasis> と <emphasis>Thread Local Session</emphasis> パター" +"ンを組み合わせましょう。 <literal>UserType</literal> でHibernateに関連付ける" +"と、ハンドコードしたJDBCで永続化するクラスを持つこともできます。（このアド" +"バイスは「十分大きな」アプリケーションに対してのものです。テーブルが5個しか" +"ないようなアプリケーションには当てはまりません。）" -#: index.docbook:203 +#. Tag: term +#: best_practices.xml:203 +#, no-c-format msgid "Don't use exotic association mappings." msgstr "珍しい関連マッピングは使わないようにしましょう。" -#: index.docbook:205 -msgid "Good usecases for a real many-to-many associations are rare. Most of the time you need additional information stored in the \"link table\". In this case, it is much better to use two one-to-many associations to an intermediate link class. In fact, we think that most associations are one-to-many and many-to-one, you should be careful when using any other association style and ask yourself if it is really neccessary." -msgstr "よいユースケースに本当の多対多関連があることは稀（まれ）です。ほとんどの場合「リンクテーブル」の付加的な情報が必要になります。この場合、リンククラスに2つの1対多関連を使う方がずっと良いです。実際ほとんどの場合関連は1対多と多対1なので、他のスタイルの関連を使うときは本当に必要かどうかを考えてみてください。" +#. Tag: para +#: best_practices.xml:205 +#, no-c-format +msgid "" +"Good usecases for a real many-to-many associations are rare. Most of the " +"time you need additional information stored in the \"link table\". In this " +"case, it is much better to use two one-to-many associations to an " +"intermediate link class. In fact, we think that most associations are one-to-" +"many and many-to-one, you should be careful when using any other association " +"style and ask yourself if it is really neccessary." +msgstr "" +"よいユースケースに本当の多対多関連があることは稀（まれ）です。ほとんどの場合" +"「リンクテーブル」の付加的な情報が必要になります。この場合、リンククラスに2" +"つの1対多関連を使う方がずっと良いです。実際ほとんどの場合関連は1対多と多対1" +"なので、他のスタイルの関連を使うときは本当に必要かどうかを考えてみてくださ" +"い。" -#: index.docbook:215 +#. Tag: term +#: best_practices.xml:215 +#, no-c-format msgid "Prefer bidirectional associations." msgstr "なるべく双方向関連にしましょう。" -#: index.docbook:217 -msgid "Unidirectional associations are more difficult to query. In a large application, almost all associations must be navigable in both directions in queries." -msgstr "単方向関連は双方向に比べて検索が難しくなります。大きなアプリケーションでは、ほとんどすべての関連が双方向にナビゲーションできなければなりません。" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "" - +#. Tag: para +#: best_practices.xml:217 +#, no-c-format +msgid "" +"Unidirectional associations are more difficult to query. In a large " +"application, almost all associations must be navigable in both directions in " +"queries." +msgstr "" +"単方向関連は双方向に比べて検索が難しくなります。大きなアプリケーションで" +"は、ほとんどすべての関連が双方向にナビゲーションできなければなりません。" Modified: core/trunk/documentation/manual/translations/ja-JP/content/collection_mapping.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/collection_mapping.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/collection_mapping.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,1287 +1,1899 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: collection_mapping.xml:5 +#, no-c-format msgid "Collection Mapping" msgstr "コレクションのマッピング" -#: index.docbook:8 +#. Tag: title +#: collection_mapping.xml:8 +#, no-c-format msgid "Persistent collections" msgstr "コレクションの永続化" -#: index.docbook:10 -msgid "Hibernate requires that persistent collection-valued fields be declared as an interface type, for example:" -msgstr "コレクション型のフィールドを永続化するには、そのコレクション型がインターフェイス型である必要があります。例えば、" +#. Tag: para +#: collection_mapping.xml:10 +#, no-c-format +msgid "" +"Hibernate requires that persistent collection-valued fields be declared as " +"an interface type, for example:" +msgstr "" +"コレクション型のフィールドを永続化するには、そのコレクション型がインターフェ" +"イス型である必要があります。例えば、" -#: index.docbook:15 +#. Tag: programlisting +#: collection_mapping.xml:15 +#, no-c-format msgid "" - "<![CDATA[public class Product {\n" - " private String serialNumber;\n" - " private Set parts = new HashSet();\n" - " \n" - " public Set getParts() { return parts; }\n" - " void setParts(Set parts) { this.parts = parts; }\n" - " public String getSerialNumber() { return serialNumber; }\n" - " void setSerialNumber(String sn) { serialNumber = sn; }\n" - "}]]>" +"<![CDATA[public class Product {\n" +" private String serialNumber;\n" +" private Set parts = new HashSet();\n" +" \n" +" public Set getParts() { return parts; }\n" +" void setParts(Set parts) { this.parts = parts; }\n" +" public String getSerialNumber() { return serialNumber; }\n" +" void setSerialNumber(String sn) { serialNumber = sn; }\n" +"}]]>" msgstr "" - "<![CDATA[public class Product {\n" - " private String serialNumber;\n" - " private Set parts = new HashSet();\n" - " \n" - " public Set getParts() { return parts; }\n" - " void setParts(Set parts) { this.parts = parts; }\n" - " public String getSerialNumber() { return serialNumber; }\n" - " void setSerialNumber(String sn) { serialNumber = sn; }\n" - "}]]>" -#: index.docbook:17 -msgid "The actual interface might be <literal>java.util.Set</literal>, <literal>java.util.Collection</literal>, <literal>java.util.List</literal>, <literal>java.util.Map</literal>, <literal>java.util.SortedSet</literal>, <literal>java.util.SortedMap</literal> or ... anything you like! (Where \"anything you like\" means you will have to write an implementation of <literal>org.hibernate.usertype.UserCollectionType</literal>.)" -msgstr "実在するインターフェイスには <literal>java.util.Set</literal>、 <literal>java.util.Collection</literal>、<literal>java.util.List</literal>、 <literal>java.util.Map</literal>、<literal>java.util.SortedSet</literal>、 <literal>java.util.SortedMap</literal> などがあります。または、任意のインターフェイスが使えます！（ただし、任意のインターフェイスを使用する場合は、 <literal>org.hibernate.usertype.UserCollectionType</literal> の実装クラスを作成する必要があります。）" +#. Tag: para +#: collection_mapping.xml:17 +#, no-c-format +msgid "" +"The actual interface might be <literal>java.util.Set</literal>, " +"<literal>java.util.Collection</literal>, <literal>java.util.List</literal>, " +"<literal>java.util.Map</literal>, <literal>java.util.SortedSet</literal>, " +"<literal>java.util.SortedMap</literal> or ... anything you like! (Where " +"\"anything you like\" means you will have to write an implementation of " +"<literal>org.hibernate.usertype.UserCollectionType</literal>.)" +msgstr "" +"実在するインターフェイスには <literal>java.util.Set</literal>、 " +"<literal>java.util.Collection</literal>、<literal>java.util.List</literal>、 " +"<literal>java.util.Map</literal>、<literal>java.util.SortedSet</literal>、 " +"<literal>java.util.SortedMap</literal> などがあります。または、任意のイン" +"ターフェイスが使えます！（ただし、任意のインターフェイスを使用する場合は、 " +"<literal>org.hibernate.usertype.UserCollectionType</literal> の実装クラスを作" +"成する必要があります。）" -#: index.docbook:26 -msgid "Notice how we initialized the instance variable with an instance of <literal>HashSet</literal>. This is the best way to initialize collection valued properties of newly instantiated (non-persistent) instances. When you make the instance persistent - by calling <literal>persist()</literal>, for example - Hibernate will actually replace the <literal>HashSet</literal> with an instance of Hibernate's own implementation of <literal>Set</literal>. Watch out for errors like this:" -msgstr "<literal>HashSet</literal> のインスタンスを持つインスタンス変数がどのように初期化されるかに注目してみましょう。これは新たに生成された（永続化されていない）コレクション型のプロパティを初期化する最適な方法です。（例えば <literal>persist()</literal> により）インスタンスを永続化しようとしたとき、 Hibernateは <literal>HashSet</literal> をHibernate独自の <literal>Set</literal> の実装クラスに置き換えます。このため、次のようなエラーには注意が必要です。" +#. Tag: para +#: collection_mapping.xml:26 +#, no-c-format +msgid "" +"Notice how we initialized the instance variable with an instance of " +"<literal>HashSet</literal>. This is the best way to initialize collection " +"valued properties of newly instantiated (non-persistent) instances. When you " +"make the instance persistent - by calling <literal>persist()</literal>, for " +"example - Hibernate will actually replace the <literal>HashSet</literal> " +"with an instance of Hibernate's own implementation of <literal>Set</" +"literal>. Watch out for errors like this:" +msgstr "" +"<literal>HashSet</literal> のインスタンスを持つインスタンス変数がどのように" +"初期化されるかに注目してみましょう。これは新たに生成された（永続化されていな" +"い）コレクション型のプロパティを初期化する最適な方法です。（例えば " +"<literal>persist()</literal> により）インスタンスを永続化しようとしたとき、 " +"Hibernateは <literal>HashSet</literal> をHibernate独自の <literal>Set</" +"literal> の実装クラスに置き換えます。このため、次のようなエラーには注意が必" +"要です。" -#: index.docbook:36 +#. Tag: programlisting +#: collection_mapping.xml:36 +#, no-c-format msgid "" - "<![CDATA[Cat cat = new DomesticCat();\n" - "Cat kitten = new DomesticCat();\n" - "....\n" - "Set kittens = new HashSet();\n" - "kittens.add(kitten);\n" - "cat.setKittens(kittens);\n" - "session.persist(cat);\n" - "kittens = cat.getKittens(); // Okay, kittens collection is a Set\n" - "(HashSet) cat.getKittens(); // Error!]]>" +"<![CDATA[Cat cat = new DomesticCat();\n" +"Cat kitten = new DomesticCat();\n" +"....\n" +"Set kittens = new HashSet();\n" +"kittens.add(kitten);\n" +"cat.setKittens(kittens);\n" +"session.persist(cat);\n" +"kittens = cat.getKittens(); // Okay, kittens collection is a Set\n" +"(HashSet) cat.getKittens(); // Error!]]>" msgstr "" - "<![CDATA[Cat cat = new DomesticCat();\n" - "Cat kitten = new DomesticCat();\n" - "....\n" - "Set kittens = new HashSet();\n" - "kittens.add(kitten);\n" - "cat.setKittens(kittens);\n" - "session.persist(cat);\n" - "kittens = cat.getKittens(); // Okay, kittens collection is a Set\n" - "(HashSet) cat.getKittens(); // Error!]]>" -#: index.docbook:38 -msgid "The persistent collections injected by Hibernate behave like <literal>HashMap</literal>, <literal>HashSet</literal>, <literal>TreeMap</literal>, <literal>TreeSet</literal> or <literal>ArrayList</literal>, depending upon the interface type." -msgstr "Hibernateにより注入された永続性コレクションは、インターフェイス型に応じて、 <literal>HashMap</literal> や <literal>HashSet</literal>、 <literal>TreeMap</literal>、 <literal>TreeSet</literal>、 <literal>ArrayList</literal> のように振舞います。" +#. Tag: para +#: collection_mapping.xml:38 +#, no-c-format +msgid "" +"The persistent collections injected by Hibernate behave like " +"<literal>HashMap</literal>, <literal>HashSet</literal>, <literal>TreeMap</" +"literal>, <literal>TreeSet</literal> or <literal>ArrayList</literal>, " +"depending upon the interface type." +msgstr "" +"Hibernateにより注入された永続性コレクションは、インターフェイス型に応じて、 " +"<literal>HashMap</literal> や <literal>HashSet</literal>、 <literal>TreeMap</" +"literal>、 <literal>TreeSet</literal>、 <literal>ArrayList</literal> のように" +"振舞います。" -#: index.docbook:45 -msgid "Collections instances have the usual behavior of value types. They are automatically persisted when referenced by a persistent object and automatically deleted when unreferenced. If a collection is passed from one persistent object to another, its elements might be moved from one table to another. Two entities may not share a reference to the same collection instance. Due to the underlying relational model, collection-valued properties do not support null value semantics; Hibernate does not distinguish between a null collection reference and an empty collection." -msgstr "コレクションインスタンスは、値型として普通に振舞います。永続化オブジェクトに参照されたときに自動的に永続化され、参照がなくなったときに自動的に削除されます。もしある永続化オブジェクトから別の永続化オブジェクトに渡されたら、その要素は現在のテーブルから別のテーブルに移動するかもしれません。２つのエンティティが同じコレクションインスタンスを共有してはいけません。リレーショナルモデルをベースにしているため、コレクション型のプロパティに null値を代入しても意味がありません。つまりHibernateは参照先のないコレクションと空のコレクションを区別しません。" +#. Tag: para +#: collection_mapping.xml:45 +#, no-c-format +msgid "" +"Collections instances have the usual behavior of value types. They are " +"automatically persisted when referenced by a persistent object and " +"automatically deleted when unreferenced. If a collection is passed from one " +"persistent object to another, its elements might be moved from one table to " +"another. Two entities may not share a reference to the same collection " +"instance. Due to the underlying relational model, collection-valued " +"properties do not support null value semantics; Hibernate does not " +"distinguish between a null collection reference and an empty collection." +msgstr "" +"コレクションインスタンスは、値型として普通に振舞います。永続化オブジェクトに" +"参照されたときに自動的に永続化され、参照がなくなったときに自動的に削除されま" +"す。もしある永続化オブジェクトから別の永続化オブジェクトに渡されたら、その" +"要素は現在のテーブルから別のテーブルに移動するかもしれません。２つのエンティ" +"ティが同じコレクションインスタンスを共有してはいけません。リレーショナルモデ" +"ルをベースにしているため、コレクション型のプロパティに null値を代入しても意味" +"がありません。つまりHibernateは参照先のないコレクションと空のコレクションを" +"区別しません。" -#: index.docbook:56 -msgid "You shouldn't have to worry much about any of this. Use persistent collections the same way you use ordinary Java collections. Just make sure you understand the semantics of bidirectional associations (discussed later)." -msgstr "しかしそれほど心配しなくても構いません。普段使っているJavaのコレクションと同じように、永続化コレクションを使ってください。双方向関連の意味を理解すればよいのです（これは後ほど説明します）。" +#. Tag: para +#: collection_mapping.xml:56 +#, no-c-format +msgid "" +"You shouldn't have to worry much about any of this. Use persistent " +"collections the same way you use ordinary Java collections. Just make sure " +"you understand the semantics of bidirectional associations (discussed later)." +msgstr "" +"しかしそれほど心配しなくても構いません。普段使っているJavaのコレクションと同" +"じように、永続化コレクションを使ってください。双方向関連の意味を理解すればよ" +"いのです（これは後ほど説明します）。" -#: index.docbook:65 +#. Tag: title +#: collection_mapping.xml:65 +#, no-c-format msgid "Collection mappings" msgstr "コレクションのマッピング" -#: index.docbook:67 -msgid "The Hibernate mapping element used for mapping a collection depends upon the type of the interface. For example, a <literal><set></literal> element is used for mapping properties of type <literal>Set</literal>." -msgstr "コレクションをマッピングするためのマッピング要素は、インターフェイスの型に依存します。例えば、<literal><set></literal> 要素は <literal>Set</literal> 型をマッピングするために使います。" +#. Tag: para +#: collection_mapping.xml:67 +#, no-c-format +msgid "" +"The Hibernate mapping element used for mapping a collection depends upon the " +"type of the interface. For example, a <literal><set></literal> element " +"is used for mapping properties of type <literal>Set</literal>." +msgstr "" +"コレクションをマッピングするためのマッピング要素は、インターフェイスの型に依" +"存します。例えば、<literal><set></literal> 要素は <literal>Set</" +"literal> 型をマッピングするために使います。" -#: index.docbook:73 +#. Tag: programlisting +#: collection_mapping.xml:73 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Product\">\n" - " <id name=\"serialNumber\" column=\"productSerialNumber\"/>\n" - " <set name=\"parts\">\n" - " <key column=\"productSerialNumber\" not-null=\"true\"/>\n" - " <one-to-many class=\"Part\"/>\n" - " </set>\n" - "</class>]]>" +"<![CDATA[<class name=\"Product\">\n" +" <id name=\"serialNumber\" column=\"productSerialNumber\"/>\n" +" <set name=\"parts\">\n" +" <key column=\"productSerialNumber\" not-null=\"true\"/>\n" +" <one-to-many class=\"Part\"/>\n" +" </set>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Product\">\n" - " <id name=\"serialNumber\" column=\"productSerialNumber\"/>\n" - " <set name=\"parts\">\n" - " <key column=\"productSerialNumber\" not-null=\"true\"/>\n" - " <one-to-many class=\"Part\"/>\n" - " </set>\n" - "</class>]]>" -#: index.docbook:75 -msgid "Apart from <literal><set></literal>, there is also <literal><list></literal>, <literal><map></literal>, <literal><bag></literal>, <literal><array></literal> and <literal><primitive-array></literal> mapping elements. The <literal><map></literal> element is representative:" -msgstr "マッピング要素には <literal><set></literal> の他に <literal><list></literal>、 <literal><map></literal>、<literal><bag></literal>、 <literal><array></literal>、<literal><primitive-array></literal> があります。代表として、<literal><map></literal> 要素を下記に示します。" +#. Tag: para +#: collection_mapping.xml:75 +#, no-c-format +msgid "" +"Apart from <literal><set></literal>, there is also <literal><" +"list></literal>, <literal><map></literal>, <literal><bag></" +"literal>, <literal><array></literal> and <literal><primitive-" +"array></literal> mapping elements. The <literal><map></literal> " +"element is representative:" +msgstr "" +"マッピング要素には <literal><set></literal> の他に <literal><" +"list></literal>、 <literal><map></literal>、<literal><bag></" +"literal>、 <literal><array></literal>、<literal><primitive-array>" +"</literal> があります。代表として、<literal><map></literal> 要素を下記" +"に示します。" -#: index.docbook:100 +#. Tag: programlisting +#: collection_mapping.xml:100 +#, no-c-format msgid "" - "<![CDATA[<map\n" - " name=\"propertyName\"\n" - " table=\"table_name\"\n" - " schema=\"schema_name\"\n" - " lazy=\"true|extra|false\"\n" - " inverse=\"true|false\"\n" - " cascade=\"all|none|save-update|delete|all-delete-orphan|delete-orphan\"\n" - " sort=\"unsorted|natural|comparatorClass\"\n" - " order-by=\"column_name asc|desc\"\n" - " where=\"arbitrary sql where condition\"\n" - " fetch=\"join|select|subselect\"\n" - " batch-size=\"N\"\n" - " access=\"field|property|ClassName\"\n" - " optimistic-lock=\"true|false\"\n" - " mutable=\"true|false\"\n" - " node=\"element-name|.\"\n" - " embed-xml=\"true|false\"\n" - ">\n" - "\n" - " <key .... />\n" - " <map-key .... />\n" - " <element .... />\n" - "</map>]]>" +"<![CDATA[<map\n" +" name=\"propertyName\"\n" +" table=\"table_name\"\n" +" schema=\"schema_name\"\n" +" lazy=\"true|extra|false\"\n" +" inverse=\"true|false\"\n" +" cascade=\"all|none|save-update|delete|all-delete-orphan|delete-orphan\"\n" +" sort=\"unsorted|natural|comparatorClass\"\n" +" order-by=\"column_name asc|desc\"\n" +" where=\"arbitrary sql where condition\"\n" +" fetch=\"join|select|subselect\"\n" +" batch-size=\"N\"\n" +" access=\"field|property|ClassName\"\n" +" optimistic-lock=\"true|false\"\n" +" mutable=\"true|false\"\n" +" node=\"element-name|.\"\n" +" embed-xml=\"true|false\"\n" +">\n" +"\n" +" <key .... />\n" +" <map-key .... />\n" +" <element .... />\n" +"</map>]]>" msgstr "" - "<![CDATA[<map\n" - " name=\"propertyName\"\n" - " table=\"table_name\"\n" - " schema=\"schema_name\"\n" - " lazy=\"true|extra|false\"\n" - " inverse=\"true|false\"\n" - " cascade=\"all|none|save-update|delete|all-delete-orphan|delete-orphan\"\n" - " sort=\"unsorted|natural|comparatorClass\"\n" - " order-by=\"column_name asc|desc\"\n" - " where=\"arbitrary sql where condition\"\n" - " fetch=\"join|select|subselect\"\n" - " batch-size=\"N\"\n" - " access=\"field|property|ClassName\"\n" - " optimistic-lock=\"true|false\"\n" - " mutable=\"true|false\"\n" - " node=\"element-name|.\"\n" - " embed-xml=\"true|false\"\n" - ">\n" - "\n" - " <key .... />\n" - " <map-key .... />\n" - " <element .... />\n" - "</map>]]>" -#: index.docbook:103 +#. Tag: para +#: collection_mapping.xml:103 +#, no-c-format msgid "<literal>name</literal> the collection property name" msgstr "<literal>name</literal> コレクション型であるプロパティの名前" -#: index.docbook:108 -msgid "<literal>table</literal> (optional - defaults to property name) the name of the collection table (not used for one-to-many associations)" -msgstr "<literal>table</literal> （オプション - デフォルトはプロパティ名）コレクションテーブルの名前（一対多関連では使用しません）。" +#. Tag: para +#: collection_mapping.xml:108 +#, no-c-format +msgid "" +"<literal>table</literal> (optional - defaults to property name) the name of " +"the collection table (not used for one-to-many associations)" +msgstr "" +"<literal>table</literal> （オプション - デフォルトはプロパティ名）コレクショ" +"ンテーブルの名前（一対多関連では使用しません）。" -#: index.docbook:114 -msgid "<literal>schema</literal> (optional) the name of a table schema to override the schema declared on the root element" -msgstr "<literal>schema</literal> （オプション）テーブルスキーマの名前。ルート要素で宣言されているスキーマより優先されます。" +#. Tag: para +#: collection_mapping.xml:114 +#, no-c-format +msgid "" +"<literal>schema</literal> (optional) the name of a table schema to override " +"the schema declared on the root element" +msgstr "" +"<literal>schema</literal> （オプション）テーブルスキーマの名前。ルート要素で" +"宣言されているスキーマより優先されます。" -#: index.docbook:120 -msgid "<literal>lazy</literal> (optional - defaults to <literal>true</literal>) may be used to disable lazy fetching and specify that the association is always eagerly fetched, or to enable \"extra-lazy\" fetching where most operations do not initialize the collection (suitable for very large collections)" -msgstr "<literal>lazy</literal> （オプション - デフォルトは <literal>true</literal>）遅延フェッチを無効にし、関連を常に即時にフェッチにするために使用します。または、「extra-lazy」フェッチを有効にするために使用します。「extra-lazy」フェッチは、ほとんどの操作ではコレクションを初期化しません（非常に大きなコレクションに適しています）。" +#. Tag: para +#: collection_mapping.xml:120 +#, no-c-format +msgid "" +"<literal>lazy</literal> (optional - defaults to <literal>true</literal>) may " +"be used to disable lazy fetching and specify that the association is always " +"eagerly fetched, or to enable \"extra-lazy\" fetching where most operations " +"do not initialize the collection (suitable for very large collections)" +msgstr "" +"<literal>lazy</literal> （オプション - デフォルトは <literal>true</" +"literal>）遅延フェッチを無効にし、関連を常に即時にフェッチにするために使用し" +"ます。または、「extra-lazy」フェッチを有効にするために使用します。「extra-" +"lazy」フェッチは、ほとんどの操作ではコレクションを初期化しません（非常に大き" +"なコレクションに適しています）。" -#: index.docbook:129 -msgid "<literal>inverse</literal> (optional - defaults to <literal>false</literal>) mark this collection as the \"inverse\" end of a bidirectional association" -msgstr "<literal>inverse</literal> （オプション - デフォルトは <literal>false</literal>）このコレクションが双方向関連の「逆」側であるとマークします。" +#. Tag: para +#: collection_mapping.xml:129 +#, no-c-format +msgid "" +"<literal>inverse</literal> (optional - defaults to <literal>false</literal>) " +"mark this collection as the \"inverse\" end of a bidirectional association" +msgstr "" +"<literal>inverse</literal> （オプション - デフォルトは <literal>false</" +"literal>）このコレクションが双方向関連の「逆」側であるとマークします。" -#: index.docbook:135 -msgid "<literal>cascade</literal> (optional - defaults to <literal>none</literal>) enable operations to cascade to child entities" -msgstr "<literal>cascade</literal> （オプション - デフォルトは <literal>none</literal>）子エンティティへのカスケード操作を有効にします。" +#. Tag: para +#: collection_mapping.xml:135 +#, no-c-format +msgid "" +"<literal>cascade</literal> (optional - defaults to <literal>none</literal>) " +"enable operations to cascade to child entities" +msgstr "" +"<literal>cascade</literal> （オプション - デフォルトは <literal>none</" +"literal>）子エンティティへのカスケード操作を有効にします。" -#: index.docbook:141 -msgid "<literal>sort</literal> (optional) specify a sorted collection with <literal>natural</literal> sort order, or a given comparator class" -msgstr "<literal>sort</literal> （オプション）コレクションを自然な順序でソートする場合は <literal>natural</literal> を指定します。あるいはComparatorクラスを指定します。" +#. Tag: para +#: collection_mapping.xml:141 +#, no-c-format +msgid "" +"<literal>sort</literal> (optional) specify a sorted collection with " +"<literal>natural</literal> sort order, or a given comparator class" +msgstr "" +"<literal>sort</literal> （オプション）コレクションを自然な順序でソートする場" +"合は <literal>natural</literal> を指定します。あるいはComparatorクラスを指定" +"します。" -#: index.docbook:147 -msgid "<literal>order-by</literal> (optional, JDK1.4 only) specify a table column (or columns) that define the iteration order of the <literal>Map</literal>, <literal>Set</literal> or bag, together with an optional <literal>asc</literal> or <literal>desc</literal>" -msgstr "<literal>order-by</literal> （オプション、JDK1.4のみ） <literal>Map</literal>、<literal>Set</literal>、bagのイテレーション順序を定義するテーブルカラムを指定すると共に、オプションとして <literal>asc</literal>、<literal>desc</literal> を指定します。" +#. Tag: para +#: collection_mapping.xml:147 +#, no-c-format +msgid "" +"<literal>order-by</literal> (optional, JDK1.4 only) specify a table column " +"(or columns) that define the iteration order of the <literal>Map</literal>, " +"<literal>Set</literal> or bag, together with an optional <literal>asc</" +"literal> or <literal>desc</literal>" +msgstr "" +"<literal>order-by</literal> （オプション、JDK1.4のみ） <literal>Map</" +"literal>、<literal>Set</literal>、bagのイテレーション順序を定義するテーブル" +"カラムを指定すると共に、オプションとして <literal>asc</literal>、" +"<literal>desc</literal> を指定します。" -#: index.docbook:154 -msgid "<literal>where</literal> (optional) specify an arbitrary SQL <literal>WHERE</literal> condition to be used when retrieving or removing the collection (useful if the collection should contain only a subset of the available data)" -msgstr "<literal>where</literal> （オプション）コレクションの検索や削除の際に使う任意のSQLの<literal>WHERE</literal> 条件を指定します（利用可能なデータの一部分だけをコレクションが含むべきときに、これは有用です）。" +#. Tag: para +#: collection_mapping.xml:154 +#, no-c-format +msgid "" +"<literal>where</literal> (optional) specify an arbitrary SQL <literal>WHERE</" +"literal> condition to be used when retrieving or removing the collection " +"(useful if the collection should contain only a subset of the available data)" +msgstr "" +"<literal>where</literal> （オプション）コレクションの検索や削除の際に使う任" +"意のSQLの<literal>WHERE</literal> 条件を指定します（利用可能なデータの一部分" +"だけをコレクションが含むべきときに、これは有用です）。" -#: index.docbook:161 -msgid "<literal>fetch</literal> (optional, defaults to <literal>select</literal>) Choose between outer-join fetching, fetching by sequential select, and fetching by sequential subselect." -msgstr "<literal>fetch</literal>（オプション - デフォルトは <literal>select</literal>）外部結合によるフェッチ、順次選択フェッチ（sequential select fetch）、順次サブセレクトフェッチ（sequential subselect fetch）のどれかを選択してください。" +#. Tag: para +#: collection_mapping.xml:161 +#, no-c-format +msgid "" +"<literal>fetch</literal> (optional, defaults to <literal>select</literal>) " +"Choose between outer-join fetching, fetching by sequential select, and " +"fetching by sequential subselect." +msgstr "" +"<literal>fetch</literal>（オプション - デフォルトは <literal>select</" +"literal>）外部結合によるフェッチ、順次選択フェッチ（sequential select " +"fetch）、順次サブセレクトフェッチ（sequential subselect fetch）のどれかを選" +"択してください。" -#: index.docbook:168 -msgid "<literal>batch-size</literal> (optional, defaults to <literal>1</literal>) specify a \"batch size\" for lazily fetching instances of this collection." -msgstr "<literal>batch-size</literal> （オプション - デフォルトは <literal>1</literal>）コレクションのインスタンスの遅延フェッチのための「バッチサイズ」を指定します。" +#. Tag: para +#: collection_mapping.xml:168 +#, no-c-format +msgid "" +"<literal>batch-size</literal> (optional, defaults to <literal>1</literal>) " +"specify a \"batch size\" for lazily fetching instances of this collection." +msgstr "" +"<literal>batch-size</literal> （オプション - デフォルトは <literal>1</" +"literal>）コレクションのインスタンスの遅延フェッチのための「バッチサイズ」を" +"指定します。" -#: index.docbook:174 -msgid "<literal>access</literal> (optional - defaults to <literal>property</literal>): The strategy Hibernate should use for accessing the collection property value." -msgstr "<literal>access</literal> （オプション - デフォルトは <literal>property</literal>）コレクション型プロパティの値にアクセスするために使用する戦略です。" +#. Tag: para +#: collection_mapping.xml:174 +#, no-c-format +msgid "" +"<literal>access</literal> (optional - defaults to <literal>property</" +"literal>): The strategy Hibernate should use for accessing the collection " +"property value." +msgstr "" +"<literal>access</literal> （オプション - デフォルトは <literal>property</" +"literal>）コレクション型プロパティの値にアクセスするために使用する戦略です。" -#: index.docbook:180 -msgid "<literal>optimistic-lock</literal> (optional - defaults to <literal>true</literal>): Species that changes to the state of the collection results in increment of the owning entity's version. (For one to many associations, it is often reasonable to disable this setting.)" -msgstr "<literal>optimistic-lock</literal>（オプション - デフォルトは <literal>true</literal>）コレクションの状態を変えることによって、そのオーナーであるエンティティのバージョンがインクリメントされるかを指定します。（一対多関連では、ほとんどの場合において無効に設定するのが妥当です。）" +#. Tag: para +#: collection_mapping.xml:180 +#, no-c-format +msgid "" +"<literal>optimistic-lock</literal> (optional - defaults to <literal>true</" +"literal>): Species that changes to the state of the collection results in " +"increment of the owning entity's version. (For one to many associations, it " +"is often reasonable to disable this setting.)" +msgstr "" +"<literal>optimistic-lock</literal>（オプション - デフォルトは <literal>true</" +"literal>）コレクションの状態を変えることによって、そのオーナーであるエン" +"ティティのバージョンがインクリメントされるかを指定します。（一対多関連では、" +"ほとんどの場合において無効に設定するのが妥当です。）" -#: index.docbook:188 -msgid "<literal>mutable</literal> (optional - defaults to <literal>true</literal>): A value of <literal>false</literal> specifies that the elements of the collection never change (a minor performance optimization in some cases)." -msgstr "<literal>mutable</literal>（オプション - デフォルトは <literal>true</literal>） <literal>false</literal> 値は、コレクションの要素が変更されないことを表します（ある場合には、少しパフォーマンスを高めます）。" +#. Tag: para +#: collection_mapping.xml:188 +#, no-c-format +msgid "" +"<literal>mutable</literal> (optional - defaults to <literal>true</literal>): " +"A value of <literal>false</literal> specifies that the elements of the " +"collection never change (a minor performance optimization in some cases)." +msgstr "" +"<literal>mutable</literal>（オプション - デフォルトは <literal>true</" +"literal>） <literal>false</literal> 値は、コレクションの要素が変更されないこ" +"とを表します（ある場合には、少しパフォーマンスを高めます）。" -#: index.docbook:198 +#. Tag: title +#: collection_mapping.xml:198 +#, no-c-format msgid "Collection foreign keys" msgstr "コレクションの外部キー" -#: index.docbook:200 -msgid "Collection instances are distinguished in the database by the foreign key of the entity that owns the collection. This foreign key is referred to as the <emphasis>collection key column</emphasis> (or columns) of the collection table. The collection key column is mapped by the <literal><key></literal> element." -msgstr "コレクションのインスタンスは、データベース内では、そのコレクションを所有するエンティティの外部キーによって識別されます。この外部キーはコレクションテーブルの <emphasis>コレクションキーカラム</emphasis> と呼ばれます。コレクションキーカラムは <literal><key></literal> 要素によりマッピングします。" +#. Tag: para +#: collection_mapping.xml:200 +#, no-c-format +msgid "" +"Collection instances are distinguished in the database by the foreign key of " +"the entity that owns the collection. This foreign key is referred to as the " +"<emphasis>collection key column</emphasis> (or columns) of the collection " +"table. The collection key column is mapped by the <literal><key></" +"literal> element." +msgstr "" +"コレクションのインスタンスは、データベース内では、そのコレクションを所有する" +"エンティティの外部キーによって識別されます。この外部キーはコレクションテーブ" +"ルの <emphasis>コレクションキーカラム</emphasis> と呼ばれます。コレクション" +"キーカラムは <literal><key></literal> 要素によりマッピングします。" -#: index.docbook:208 -msgid "There may be a nullability constraint on the foreign key column. For most collections, this is implied. For unidirectional one to many associations, the foreign key column is nullable by default, so you might need to specify <literal>not-null=\"true\"</literal>." -msgstr "外部キーカラムにはnull設定制約があるかもしれません。ほとんどのコレクションに当てはまるでしょう。単方向の一対多関連において、外部キーカラムはデフォルトでnullを許す設定になっています。よって、<literal>not-null=\"true\"</literal> を指定する必要があるかもしれません。" +#. Tag: para +#: collection_mapping.xml:208 +#, no-c-format +msgid "" +"There may be a nullability constraint on the foreign key column. For most " +"collections, this is implied. For unidirectional one to many associations, " +"the foreign key column is nullable by default, so you might need to specify " +"<literal>not-null=\"true\"</literal>." +msgstr "" +"外部キーカラムにはnull設定制約があるかもしれません。ほとんどのコレクションに" +"当てはまるでしょう。単方向の一対多関連において、外部キーカラムはデフォルトで" +"nullを許す設定になっています。よって、<literal>not-null=\"true\"</literal> " +"を指定する必要があるかもしれません。" -#: index.docbook:215 +#. Tag: programlisting +#: collection_mapping.xml:215 +#, no-c-format msgid "<![CDATA[<key column=\"productSerialNumber\" not-null=\"true\"/>]]>" -msgstr "<![CDATA[<key column=\"productSerialNumber\" not-null=\"true\"/>]]>" +msgstr "" -#: index.docbook:217 -msgid "The foreign key constraint may use <literal>ON DELETE CASCADE</literal>." -msgstr "外部キーの制約が <literal>ON DELETE CASCADE</literal> を使うかもしれません。" +#. Tag: para +#: collection_mapping.xml:217 +#, no-c-format +msgid "" +"The foreign key constraint may use <literal>ON DELETE CASCADE</literal>." +msgstr "" +"外部キーの制約が <literal>ON DELETE CASCADE</literal> を使うかもしれません。" -#: index.docbook:221 +#. Tag: programlisting +#: collection_mapping.xml:221 +#, no-c-format msgid "<![CDATA[<key column=\"productSerialNumber\" on-delete=\"cascade\"/>]]>" -msgstr "<![CDATA[<key column=\"productSerialNumber\" on-delete=\"cascade\"/>]]>" +msgstr "" -#: index.docbook:223 -msgid "See the previous chapter for a full definition of the <literal><key></literal> element." -msgstr "<literal><key></literal> 要素のすべての定義については前の章を参照してください。" +#. Tag: para +#: collection_mapping.xml:223 +#, no-c-format +msgid "" +"See the previous chapter for a full definition of the <literal><key></" +"literal> element." +msgstr "" +"<literal><key></literal> 要素のすべての定義については前の章を参照してく" +"ださい。" -#: index.docbook:231 +#. Tag: title +#: collection_mapping.xml:231 +#, no-c-format msgid "Collection elements" msgstr "コレクションの要素" -#: index.docbook:233 -msgid "Collections may contain almost any other Hibernate type, including all basic types, custom types, components, and of course, references to other entities. This is an important distinction: an object in a collection might be handled with \"value\" semantics (its life cycle fully depends on the collection owner) or it might be a reference to another entity, with its own life cycle. In the latter case, only the \"link\" between the two objects is considered to be state held by the collection." -msgstr "コレクションは他のHibernateの型のほとんど（すべての基本型、カスタム型、コンポーネント、他のエンティティへの参照）を格納することができます。次の点は重要な違いになります。コレクションに格納されたオブジェクトが「値」セマンティクスとして扱われるのか（ライフサイクルはコレクションのオーナーに完全に依存します）、もしくはそれ自身のライフサイクルを持った別のエンティティへの参照であるかのかという違いです。後者は、2つのオブジェクト間の「リンク」をコレクションに保持していると見なしているだけです。" +#. Tag: para +#: collection_mapping.xml:233 +#, no-c-format +msgid "" +"Collections may contain almost any other Hibernate type, including all basic " +"types, custom types, components, and of course, references to other " +"entities. This is an important distinction: an object in a collection might " +"be handled with \"value\" semantics (its life cycle fully depends on the " +"collection owner) or it might be a reference to another entity, with its own " +"life cycle. In the latter case, only the \"link\" between the two objects is " +"considered to be state held by the collection." +msgstr "" +"コレクションは他のHibernateの型のほとんど（すべての基本型、カスタム型、コン" +"ポーネント、他のエンティティへの参照）を格納することができます。次の点は重" +"要な違いになります。コレクションに格納されたオブジェクトが「値」セマンティク" +"スとして扱われるのか（ライフサイクルはコレクションのオーナーに完全に依存しま" +"す）、もしくはそれ自身のライフサイクルを持った別のエンティティへの参照である" +"かのかという違いです。後者は、2つのオブジェクト間の「リンク」をコレクション" +"に保持していると見なしているだけです。" -#: index.docbook:242 -msgid "The contained type is referred to as the <emphasis>collection element type</emphasis>. Collection elements are mapped by <literal><element></literal> or <literal><composite-element></literal>, or in the case of entity references, with <literal><one-to-many></literal> or <literal><many-to-many></literal>. The first two map elements with value semantics, the next two are used to map entity associations." -msgstr "格納される型は <emphasis>コレクション要素型</emphasis> と呼ばれます。コレクション要素は、<literal><element></literal> または <literal><composite-element></literal> によりマッピングされ、エンティティへの参照の場合には <literal><one-to-many></literal> または <literal><many-to-many></literal> によりマッピングされます。最初の二つは値として要素をマッピングし、次の二つはエンティティの関連をマッピングするのに使われます。" +#. Tag: para +#: collection_mapping.xml:242 +#, no-c-format +msgid "" +"The contained type is referred to as the <emphasis>collection element type</" +"emphasis>. Collection elements are mapped by <literal><element></" +"literal> or <literal><composite-element></literal>, or in the case of " +"entity references, with <literal><one-to-many></literal> or " +"<literal><many-to-many></literal>. The first two map elements with " +"value semantics, the next two are used to map entity associations." +msgstr "" +"格納される型は <emphasis>コレクション要素型</emphasis> と呼ばれます。コレク" +"ション要素は、<literal><element></literal> または <literal><" +"composite-element></literal> によりマッピングされ、エンティティへの参照の" +"場合には <literal><one-to-many></literal> または <literal><many-to-" +"many></literal> によりマッピングされます。最初の二つは値として要素をマッ" +"ピングし、次の二つはエンティティの関連をマッピングするのに使われます。" -#: index.docbook:254 +#. Tag: title +#: collection_mapping.xml:254 +#, no-c-format msgid "Indexed collections" msgstr "インデックス付きのコレクション" -#: index.docbook:256 -msgid "All collection mappings, except those with set and bag semantics, need an <emphasis>index column</emphasis> in the collection table - a column that maps to an array index, or <literal>List</literal> index, or <literal>Map</literal> key. The index of a <literal>Map</literal> may be of any basic type, mapped with <literal><map-key></literal>, it may be an entity reference mapped with <literal><map-key-many-to-many></literal>, or it may be a composite type, mapped with <literal><composite-map-key></literal>. The index of an array or list is always of type <literal>integer</literal> and is mapped using the <literal><list-index></literal> element. The mapped column contains sequential integers (numbered from zero, by default)." -msgstr "setとbagを除く全てのコレクションマッピングには、コレクションテーブルの中に <emphasis>インデックス用のカラム</emphasis> が必要です。そのカラムに、配列や <literal>List</literal> のインデックス、もしくは <literal>Map</literal> のキーをマッピングします。 <literal>Map</literal> のインデックスは、 <literal><map-key></literal> によりマッピングされた基本型か、 <literal><map-key-many-to-many></literal> によりマッピングされたエンティティの関連か、あるいは <literal><composite-map-key></literal> によりマッピングされたコンポジット型になります。配列かリストのインデックスは、常に <literal>integer</literal> 型で、 <literal><list-index></literal> 要素によりマッピングします。マッピングされたカラムにはシーケンシャルな整数を格納します�! �デフォルトでは0から番号が付けられます）。" +#. Tag: para +#: collection_mapping.xml:256 +#, no-c-format +msgid "" +"All collection mappings, except those with set and bag semantics, need an " +"<emphasis>index column</emphasis> in the collection table - a column that " +"maps to an array index, or <literal>List</literal> index, or <literal>Map</" +"literal> key. The index of a <literal>Map</literal> may be of any basic " +"type, mapped with <literal><map-key></literal>, it may be an entity " +"reference mapped with <literal><map-key-many-to-many></literal>, or it " +"may be a composite type, mapped with <literal><composite-map-key></" +"literal>. The index of an array or list is always of type <literal>integer</" +"literal> and is mapped using the <literal><list-index></literal> " +"element. The mapped column contains sequential integers (numbered from zero, " +"by default)." +msgstr "" +"setとbagを除く全てのコレクションマッピングには、コレクションテーブルの中に " +"<emphasis>インデックス用のカラム</emphasis> が必要です。そのカラムに、配列" +"や <literal>List</literal> のインデックス、もしくは <literal>Map</literal> " +"のキーをマッピングします。 <literal>Map</literal> のインデックスは、 " +"<literal><map-key></literal> によりマッピングされた基本型か、 " +"<literal><map-key-many-to-many></literal> によりマッピングされたエン" +"ティティの関連か、あるいは <literal><composite-map-key></literal> によ" +"りマッピングされたコンポジット型になります。配列かリストのインデックスは、常" +"に <literal>integer</literal> 型で、 <literal><list-index></literal> 要" +"素によりマッピングします。マッピングされたカラムにはシーケンシャルな整数を格" +"納します（デフォルトでは0から番号が付けられます）。" -#: index.docbook:267 +#. Tag: sect2 +#: collection_mapping.xml:267 +#, no-c-format msgid "" - "<programlistingco> <areaspec> <area id=\"index1\" coords=\"2 45\"/> <area id=\"index2\" coords=\"3 45\"/> </areaspec> <programlisting><![CDATA[<list-index \n" - " column=\"column_name\"\n" - " base=\"0|1|...\"/>]]></programlisting> <calloutlist> <callout arearefs=\"index1\"> <para> <literal>column_name</literal> (required): The name of the column holding the collection index values. </para> </callout> <callout arearefs=\"index1\"> <para> <literal>base</literal> (optional, defaults to <literal>0</literal>): The value of the index column that corresponds to the first element of the list or array. </para> </callout> </calloutlist> </programlistingco> <programlistingco> <areaspec> <area id=\"mapkey1\" coords=\"2 45\"/> <area id=\"mapkey2\" coords=\"3 45\"/> <area id=\"mapkey3\" coords=\"4 45\"/> </areaspec> <programlisting><![CDATA[<map-key \n" - " column=\"column_name\"\n" - " formula=\"any SQL expression\"\n" - " type=\"type_name\"\n" - " node=\"@attribute-name\"\n" - " length=\"N\"/>]]></programlisting> <calloutlist> <callout arearefs=\"mapkey1\"> <para> <literal>column</literal> (optional): The name of the column holding the collection index values. </para> </callout> <callout arearefs=\"mapkey2\"> <para> <literal>formula</literal> (optional): A SQL formula used to evaluate the key of the map. </para> </callout> <callout arearefs=\"mapkey3\"> <para> <literal>type</literal> (reguired): The type of the map keys. </para> </callout> </calloutlist> </programlistingco> <programlistingco> <areaspec> <area id=\"indexmanytomany1\" coords=\"2 45\"/> <area id=\"indexmanytomany2\" coords=\"3 45\"/> <area id=\"indexmanytomany3\" coords=\"3 45\"/> </areaspec> <programlisting><![CDATA[<map-key-many-to-many\n" - " column=\"column_name\"\n" - " formula=\"any SQL expression\"\n" - " class=\"ClassName\"\n" - "/>]]></programlisting> <calloutlist> <callout arearefs=\"indexmanytomany1\"> <para> <literal>column</literal> (optional): The name of the foreign key column for the collection index values. </para> </callout> <callout arearefs=\"indexmanytomany2\"> <para> <literal>formula</literal> (optional): A SQL formula used to evaluate the foreign key of the map key. </para> </callout> <callout arearefs=\"indexmanytomany3\"> <para> <literal>class</literal> (required): The entity class used as the map key. </para> </callout> </calloutlist> </programlistingco>" +"<programlistingco> <areaspec> <area id=\"index1\" coords=\"2 45\"/> <area id=" +"\"index2\" coords=\"3 45\"/> </areaspec> <programlisting><![CDATA[<list-" +"index \n" +" column=\"column_name\"\n" +" base=\"0|1|...\"/>]]></programlisting> <calloutlist> <callout " +"arearefs=\"index1\"> <para> <literal>column_name</literal> (required): The " +"name of the column holding the collection index values. </para> </callout> " +"<callout arearefs=\"index1\"> <para> <literal>base</literal> (optional, " +"defaults to <literal>0</literal>): The value of the index column that " +"corresponds to the first element of the list or array. </para> </callout> </" +"calloutlist> </programlistingco> <programlistingco> <areaspec> <area id=" +"\"mapkey1\" coords=\"2 45\"/> <area id=\"mapkey2\" coords=\"3 45\"/> <area " +"id=\"mapkey3\" coords=\"4 45\"/> </areaspec> <programlisting><![CDATA[<map-" +"key \n" +" column=\"column_name\"\n" +" formula=\"any SQL expression\"\n" +" type=\"type_name\"\n" +" node=\"@attribute-name\"\n" +" length=\"N\"/>]]></programlisting> <calloutlist> <callout arearefs=" +"\"mapkey1\"> <para> <literal>column</literal> (optional): The name of the " +"column holding the collection index values. </para> </callout> <callout " +"arearefs=\"mapkey2\"> <para> <literal>formula</literal> (optional): A SQL " +"formula used to evaluate the key of the map. </para> </callout> <callout " +"arearefs=\"mapkey3\"> <para> <literal>type</literal> (reguired): The type of " +"the map keys. </para> </callout> </calloutlist> </programlistingco> " +"<programlistingco> <areaspec> <area id=\"indexmanytomany1\" coords=\"2 45\"/" +"> <area id=\"indexmanytomany2\" coords=\"3 45\"/> <area id=\"indexmanytomany3" +"\" coords=\"3 45\"/> </areaspec> <programlisting><![CDATA[<map-key-many-to-" +"many\n" +" column=\"column_name\"\n" +" formula=\"any SQL expression\"\n" +" class=\"ClassName\"\n" +"/>]]></programlisting> <calloutlist> <callout arearefs=\"indexmanytomany1\"> " +"<para> <literal>column</literal> (optional): The name of the foreign key " +"column for the collection index values. </para> </callout> <callout arearefs=" +"\"indexmanytomany2\"> <para> <literal>formula</literal> (optional): A SQL " +"formula used to evaluate the foreign key of the map key. </para> </callout> " +"<callout arearefs=\"indexmanytomany3\"> <para> <literal>class</literal> " +"(required): The entity class used as the map key. </para> </callout> </" +"calloutlist> </programlistingco>" msgstr "" - "<programlistingco> <areaspec> <area id=\"index1\" coords=\"2 45\"/> <area id=\"index2\" coords=\"3 45\"/> </areaspec> <programlisting><![CDATA[<list-index \n" - " column=\"column_name\"\n" - " base=\"0|1|...\"/>]]></programlisting> <calloutlist> <callout arearefs=\"index1\"> <para> <literal>column_name</literal>（必須）:コレクションインデックスの値を保持するカラムの名前。 </para> </callout> <callout arearefs=\"index2\"> <para> <literal>base</literal>（オプション、デフォルトは <literal>0</literal>）: リストもしくは配列の最初の要素に該当するインデックスカラムの値。 </para> </callout> </calloutlist> </programlistingco> <programlistingco> <areaspec> <area id=\"mapkey1\" coords=\"2 45\"/> <area id=\"mapkey2\" coords=\"3 45\"/> <area id=\"mapkey3\" coords=\"4 45\"/> </areaspec> <programlisting><![CDATA[<map-key \n" - " column=\"column_name\"\n" - " formula=\"any SQL expression\"\n" - " type=\"type_name\"\n" - " node=\"@attribute-name\"\n" - " length=\"N\"/>]]></programlisting> <calloutlist> <callout arearefs=\"mapkey1\"> <para> <literal>column</literal>（オプション）: コレクションインデックスの値を保持するカラムの名前。 </para> </callout> <callout arearefs=\"mapkey2\"> <para> <literal>formula</literal>（オプション）: Mapのキーを評価するのに使われるSQL式。 </para> </callout> <callout arearefs=\"mapkey3\"> <para> <literal>type</literal>（必須）: Mapのキーの型。 </para> </callout> </calloutlist> </programlistingco> <programlistingco> <areaspec> <area id=\"indexmanytomany1\" coords=\"2 45\"/> <area id=\"indexmanytomany2\" coords=\"3 45\"/> <area id=\"indexmanytomany3\" coords=\"4 45\"/> </areaspec> <programlisting><![CDATA[<map-key-many-to-many\n" - " column=\"column_name\"\n" - " formula=\"any SQL expression\"\n" - " class=\"ClassName\"\n" - "/>]]></programlisting> <calloutlist> <callout arearefs=\"indexmanytomany1\"> <para> <literal>column</literal> （オプション）: コレクションインデックスの値のための外部キーカラムの名前。 </para> </callout> <callout arearefs=\"indexmanytomany2\"> <para> <literal>formula</literal> （オプション）: Mapのキーのための外部キーを評価するために使うSQL式。 </para> </callout> <callout arearefs=\"indexmanytomany3\"> <para> <literal>class</literal> （必須）: Mapのキーとして使われるエンティティクラス。 </para> </callout> </calloutlist> </programlistingco>" -#: index.docbook:348 -msgid "If your table doesn't have an index column, and you still wish to use <literal>List</literal> as the property type, you should map the property as a Hibernate <emphasis><bag></emphasis>. A bag does not retain its order when it is retrieved from the database, but it may be optionally sorted or ordered." -msgstr "もしテーブルにインデックスカラムがなくても、プロパティ型として <literal>List</literal> を使いたければ、 Hibernateの <emphasis><bag></emphasis> としてプロパティをマッピングします。 bagはデータベースから復元される時、順序を保持しません。しかし、（メモリ上で）ソートしたり、（SQLで）順序付けしたり（order by）することもできます。" +#. Tag: para +#: collection_mapping.xml:348 +#, no-c-format +msgid "" +"If your table doesn't have an index column, and you still wish to use " +"<literal>List</literal> as the property type, you should map the property as " +"a Hibernate <emphasis><bag></emphasis>. A bag does not retain its " +"order when it is retrieved from the database, but it may be optionally " +"sorted or ordered." +msgstr "" +"もしテーブルにインデックスカラムがなくても、プロパティ型として " +"<literal>List</literal> を使いたければ、 Hibernateの <emphasis><bag></" +"emphasis> としてプロパティをマッピングします。 bagはデータベースから復元され" +"る時、順序を保持しません。しかし、（メモリ上で）ソートしたり、（SQLで）順序" +"付けしたり（order by）することもできます。" -#: index.docbook:357 -msgid "There are quite a range of mappings that can be generated for collections, covering many common relational models. We suggest you experiment with the schema generation tool to get a feeling for how various mapping declarations translate to database tables." -msgstr "多くの一般的なリレーショナルモデルをカバーしたために、コレクションのために利用できるマッピングにはかなりの幅があります。様々なマッピング宣言がどのようにデータベーステーブルに変換されるかを知るために、スキーマ生成ツールを使ってみると良いでしょう。" +#. Tag: para +#: collection_mapping.xml:357 +#, no-c-format +msgid "" +"There are quite a range of mappings that can be generated for collections, " +"covering many common relational models. We suggest you experiment with the " +"schema generation tool to get a feeling for how various mapping declarations " +"translate to database tables." +msgstr "" +"多くの一般的なリレーショナルモデルをカバーしたために、コレクションのために利" +"用できるマッピングにはかなりの幅があります。様々なマッピング宣言がどのように" +"データベーステーブルに変換されるかを知るために、スキーマ生成ツールを使ってみ" +"ると良いでしょう。" -#: index.docbook:364 +#. Tag: title +#: collection_mapping.xml:364 +#, no-c-format msgid "Collections of values and many-to-many associations" msgstr "値のコレクションと多対多関連" -#: index.docbook:366 -msgid "Any collection of values or many-to-many association requires a dedicated <emphasis>collection table</emphasis> with a foreign key column or columns, <emphasis>collection element column</emphasis> or columns and possibly an index column or columns." -msgstr "値のコレクションや多対多関連は、専用の <emphasis>コレクションテーブル</emphasis> が必要です。このテーブルは、外部キーカラムと、 <emphasis>コレクション要素のカラム</emphasis> と、場合によってはインデックスカラムを持ちます。" +#. Tag: para +#: collection_mapping.xml:366 +#, no-c-format +msgid "" +"Any collection of values or many-to-many association requires a dedicated " +"<emphasis>collection table</emphasis> with a foreign key column or columns, " +"<emphasis>collection element column</emphasis> or columns and possibly an " +"index column or columns." +msgstr "" +"値のコレクションや多対多関連は、専用の <emphasis>コレクションテーブル</" +"emphasis> が必要です。このテーブルは、外部キーカラムと、 <emphasis>コレク" +"ション要素のカラム</emphasis> と、場合によってはインデックスカラムを持ちま" +"す。" -#: index.docbook:373 -msgid "For a collection of values, we use the <literal><element></literal> tag." -msgstr "値のコレクションのために、<literal><element></literal>タグを使用します。" +#. Tag: para +#: collection_mapping.xml:373 +#, no-c-format +msgid "" +"For a collection of values, we use the <literal><element></literal> " +"tag." +msgstr "" +"値のコレクションのために、<literal><element></literal>タグを使用しま" +"す。" -#: index.docbook:375 +#. Tag: sect2 +#: collection_mapping.xml:375 +#, no-c-format msgid "" - "<programlistingco> <areaspec> <area id=\"element1b\" coords=\"2 50\"/> <area id=\"element2b\" coords=\"3 50\"/> <area id=\"element3b\" coords=\"4 50\"/> </areaspec> <programlisting><![CDATA[<element\n" - " column=\"column_name\"\n" - " formula=\"any SQL expression\"\n" - " type=\"typename\"\n" - " length=\"L\"\n" - " precision=\"P\"\n" - " scale=\"S\"\n" - " not-null=\"true|false\"\n" - " unique=\"true|false\"\n" - " node=\"element-name\"\n" - "/>]]></programlisting> <calloutlist> <callout arearefs=\"element1b\"> <para> <literal>column</literal> (optional): The name of the column holding the collection element values. </para> </callout> <callout arearefs=\"element2b\"> <para> <literal>formula</literal> (optional): An SQL formula used to evaluate the element. </para> </callout> <callout arearefs=\"element3b\"> <para> <literal>type</literal> (required): The type of the collection element. </para> </callout> </calloutlist> </programlistingco> <para> A <emphasis>many-to-many association</emphasis> is specified using the <literal><many-to-many></literal> element. </para> <programlistingco> <areaspec> <area id=\"manytomany1\" coords=\"2 60\"/> <area id=\"manytomany2\" coords=\"3 60\"/> <area id=\"manytomany3\" coords=\"4 60\"/> <area id=\"manytomany4\" coords=\"5 60\"/> <area id=\"manytomany5\" coords=\"6 60\"/> <area id=\"manytomany6\" coords=\"7 60\"/> <area id=\"manytomany7\" coords=\"8 60\"/> <area id=\! "manytomany8\" coords=\"9 60\"/> </areaspec> <programlisting><![CDATA[<many-to-many\n" - " column=\"column_name\"\n" - " formula=\"any SQL expression\"\n" - " class=\"ClassName\"\n" - " fetch=\"select|join\"\n" - " unique=\"true|false\"\n" - " not-found=\"ignore|exception\"\n" - " entity-name=\"EntityName\"\n" - " property-ref=\"propertyNameFromAssociatedClass\"\n" - " node=\"element-name\"\n" - " embed-xml=\"true|false\"\n" - " />]]></programlisting> <calloutlist> <callout arearefs=\"manytomany1\"> <para> <literal>column</literal> (optional): The name of the element foreign key column. </para> </callout> <callout arearefs=\"manytomany2\"> <para> <literal>formula</literal> (optional): An SQL formula used to evaluate the element foreign key value. </para> </callout> <callout arearefs=\"manytomany3\"> <para> <literal>class</literal> (required): The name of the associated class. </para> </callout> <callout arearefs=\"manytomany4\"> <para> <literal>fetch</literal> (optional - defaults to <literal>join</literal>): enables outer-join or sequential select fetching for this association. This is a special case; for full eager fetching (in a single <literal>SELECT</literal>) of an entity and its many-to-many relationships to other entities, you would enable <literal>join</literal> fetching not only of the collection itself, but also with this attribute on the <literal><many-to-many></literal! > nested element. </para> </callout> <callout arearefs=\"manytomany5\"> <para> <literal>unique</literal> (optional): Enable the DDL generation of a unique constraint for the foreign-key column. This makes the association multiplicity effectively one to many. </para> </callout> <callout arearefs=\"manytomany6\"> <para> <literal>not-found</literal> (optional - defaults to <literal>exception</literal>): Specifies how foreign keys that reference missing rows will be handled: <literal>ignore</literal> will treat a missing row as a null association. </para> </callout> <callout arearefs=\"manytomany7\"> <para> <literal>entity-name</literal> (optional): The entity name of the associated class, as an alternative to <literal>class</literal>. </para> </callout> <callout arearefs=\"manytomany8\"> <para> <literal>property-ref</literal>: (optional) The name of a property of the associated class that is joined to this foreign key. If not specified, the primary key of the associated class ! is used. </para> </callout> </calloutlist> </programlistingco>" +"<programlistingco> <areaspec> <area id=\"element1b\" coords=\"2 50\"/> <area " +"id=\"element2b\" coords=\"3 50\"/> <area id=\"element3b\" coords=\"4 50\"/> " +"</areaspec> <programlisting><![CDATA[<element\n" +" column=\"column_name\"\n" +" formula=\"any SQL expression\"\n" +" type=\"typename\"\n" +" length=\"L\"\n" +" precision=\"P\"\n" +" scale=\"S\"\n" +" not-null=\"true|false\"\n" +" unique=\"true|false\"\n" +" node=\"element-name\"\n" +"/>]]></programlisting> <calloutlist> <callout arearefs=\"element1b\"> <para> " +"<literal>column</literal> (optional): The name of the column holding the " +"collection element values. </para> </callout> <callout arearefs=\"element2b" +"\"> <para> <literal>formula</literal> (optional): An SQL formula used to " +"evaluate the element. </para> </callout> <callout arearefs=\"element3b\"> " +"<para> <literal>type</literal> (required): The type of the collection " +"element. </para> </callout> </calloutlist> </programlistingco> <para> A " +"<emphasis>many-to-many association</emphasis> is specified using the " +"<literal><many-to-many></literal> element. </para> <programlistingco> " +"<areaspec> <area id=\"manytomany1\" coords=\"2 60\"/> <area id=\"manytomany2" +"\" coords=\"3 60\"/> <area id=\"manytomany3\" coords=\"4 60\"/> <area id=" +"\"manytomany4\" coords=\"5 60\"/> <area id=\"manytomany5\" coords=\"6 60\"/> " +"<area id=\"manytomany6\" coords=\"7 60\"/> <area id=\"manytomany7\" coords=" +"\"8 60\"/> <area id=\"manytomany8\" coords=\"9 60\"/> </areaspec> " +"<programlisting><![CDATA[<many-to-many\n" +" column=\"column_name\"\n" +" formula=\"any SQL expression\"\n" +" class=\"ClassName\"\n" +" fetch=\"select|join\"\n" +" unique=\"true|false\"\n" +" not-found=\"ignore|exception\"\n" +" entity-name=\"EntityName\"\n" +" property-ref=\"propertyNameFromAssociatedClass\"\n" +" node=\"element-name\"\n" +" embed-xml=\"true|false\"\n" +" />]]></programlisting> <calloutlist> <callout arearefs=\"manytomany1\"> " +"<para> <literal>column</literal> (optional): The name of the element foreign " +"key column. </para> </callout> <callout arearefs=\"manytomany2\"> <para> " +"<literal>formula</literal> (optional): An SQL formula used to evaluate the " +"element foreign key value. </para> </callout> <callout arearefs=\"manytomany3" +"\"> <para> <literal>class</literal> (required): The name of the associated " +"class. </para> </callout> <callout arearefs=\"manytomany4\"> <para> " +"<literal>fetch</literal> (optional - defaults to <literal>join</literal>): " +"enables outer-join or sequential select fetching for this association. This " +"is a special case; for full eager fetching (in a single <literal>SELECT</" +"literal>) of an entity and its many-to-many relationships to other entities, " +"you would enable <literal>join</literal> fetching not only of the collection " +"itself, but also with this attribute on the <literal><many-to-many></" +"literal> nested element. </para> </callout> <callout arearefs=\"manytomany5" +"\"> <para> <literal>unique</literal> (optional): Enable the DDL generation " +"of a unique constraint for the foreign-key column. This makes the " +"association multiplicity effectively one to many. </para> </callout> " +"<callout arearefs=\"manytomany6\"> <para> <literal>not-found</literal> " +"(optional - defaults to <literal>exception</literal>): Specifies how foreign " +"keys that reference missing rows will be handled: <literal>ignore</literal> " +"will treat a missing row as a null association. </para> </callout> <callout " +"arearefs=\"manytomany7\"> <para> <literal>entity-name</literal> (optional): " +"The entity name of the associated class, as an alternative to " +"<literal>class</literal>. </para> </callout> <callout arearefs=\"manytomany8" +"\"> <para> <literal>property-ref</literal>: (optional) The name of a " +"property of the associated class that is joined to this foreign key. If not " +"specified, the primary key of the associated class is used. </para> </" +"callout> </calloutlist> </programlistingco>" msgstr "" - "<programlistingco> <areaspec> <area id=\"element1b\" coords=\"2 50\"/> <area id=\"element2b\" coords=\"3 50\"/> <area id=\"element3b\" coords=\"4 50\"/> </areaspec> <programlisting><![CDATA[<element\n" - " column=\"column_name\"\n" - " formula=\"any SQL expression\"\n" - " type=\"typename\"\n" - " length=\"L\"\n" - " precision=\"P\"\n" - " scale=\"S\"\n" - " not-null=\"true|false\"\n" - " unique=\"true|false\"\n" - " node=\"element-name\"\n" - "/>]]></programlisting> <calloutlist> <callout arearefs=\"element1b\"> <para> <literal>column</literal> （オプション）: コレクションの要素の値を保持するカラムの名前。 </para> </callout> <callout arearefs=\"element2b\"> <para> <literal>formula</literal> （オプション）: 要素を評価するために使うSQL式。 </para> </callout> <callout arearefs=\"element3b\"> <para> <literal>type</literal> （必須）コレクションの要素の型。 </para> </callout> </calloutlist> </programlistingco> <para> <emphasis>多対多関連</emphasis> は <literal><many-to-many></literal> 要素で指定します。 </para> <programlistingco> <areaspec> <area id=\"manytomany1\" coords=\"2 60\"/> <area id=\"manytomany2\" coords=\"3 60\"/> <area id=\"manytomany3\" coords=\"4 60\"/> <area id=\"manytomany4\" coords=\"5 60\"/> <area id=\"manytomany5\" coords=\"6 60\"/> <area id=\"manytomany6\" coords=\"7 60\"/> <area id=\"manytomany7\" coords=! \"8 60\"/> <area id=\"manytomany8\" coords=\"9 60\"/> </areaspec> <programlisting><![CDATA[<many-to-many\n" - " column=\"column_name\"\n" - " formula=\"any SQL expression\"\n" - " class=\"ClassName\"\n" - " fetch=\"select|join\"\n" - " unique=\"true|false\"\n" - " not-found=\"ignore|exception\"\n" - " entity-name=\"EntityName\"\n" - " property-ref=\"propertyNameFromAssociatedClass\"\n" - " node=\"element-name\"\n" - " embed-xml=\"true|false\"\n" - " />]]></programlisting> <calloutlist> <callout arearefs=\"manytomany1\"> <para> <literal>column</literal> （オプション）: 外部キーカラムの要素の名前。 </para> </callout> <callout arearefs=\"manytomany2\"> <para> <literal>formula</literal> （オプション）: 外部キー値の要素を評価するために使うSQL式。 </para> </callout> <callout arearefs=\"manytomany3\"> <para> <literal>class</literal> （必須）: 関連クラスの名前。 </para> </callout> <callout arearefs=\"manytomany4\"> <para> <literal>fetch</literal> (オプション - デフォルトは <literal>join</literal>): 関連のために、外部結合か順次選択フェッチを有効にします。これは特殊なケースですが、エンティティと他のエンティティとの多対多関係を（１つの <literal>SELECT</literal> により）完全に即時にフェッチするためには、そのコレクション自体だけでなく、ネス�! ��した要素である <literal><many-to-many></literal> のこの属性についても <literal>join</literal> フェッチを有効する必要があります。 </para> </callout> <callout arearefs=\"manytomany5\"> <para> <literal>unique</literal> （オプション）: 外部キーカラムのユニーク制約のDDL生成を有効にします。これは、関連の多重度を事実上一対多にします。 </para> </callout> <callout arearefs=\"manytomany6\"> <para> <literal>not-found</literal> （オプション - デフォルトは <literal>exception</literal>）参照先の行がない外部キーをどのように扱うかを指定します。 <literal>ignore</literal> にすると、行がないことを関連が無いものとして扱います。 </para> </callout> <callout arearefs=\"manytomany7\"> <para> <literal>entity-name</literal> （オプション）: <literal>class</literal> の代替である関連クラスのエンティティ名。 <lite! ral>class</literal> の代わりに指定する、関連クラスの� �ンティティ名。 </para> </callout> <callout arearefs=\"manytomany8\"> <para> <literal>property-ref</literal>: （オプション）この外部キーに結合する関連クラスのプロパティ名。指定しなかった場合は、関連クラスの主キーを使います。 </para> </callout> </calloutlist> </programlistingco>" -#: index.docbook:480 +#. Tag: para +#: collection_mapping.xml:480 +#, no-c-format msgid "Some examples, first, a set of strings:" msgstr "以下にいくつか例を示します。まずはStringのsetに関しての例です。" -#: index.docbook:484 +#. Tag: programlisting +#: collection_mapping.xml:484 +#, no-c-format msgid "" - "<![CDATA[<set name=\"names\" table=\"person_names\">\n" - " <key column=\"person_id\"/>\n" - " <element column=\"person_name\" type=\"string\"/>\n" - "</set>]]>" +"<![CDATA[<set name=\"names\" table=\"person_names\">\n" +" <key column=\"person_id\"/>\n" +" <element column=\"person_name\" type=\"string\"/>\n" +"</set>]]>" msgstr "" - "<![CDATA[<set name=\"names\" table=\"person_names\">\n" - " <key column=\"person_id\"/>\n" - " <element column=\"person_name\" type=\"string\"/>\n" - "</set>]]>" -#: index.docbook:486 -msgid "A bag containing integers (with an iteration order determined by the <literal>order-by</literal> attribute):" -msgstr "整数値を含むbag（bagは <literal>order-by</literal> 属性によって反復順序が定義されています）" +#. Tag: para +#: collection_mapping.xml:486 +#, no-c-format +msgid "" +"A bag containing integers (with an iteration order determined by the " +"<literal>order-by</literal> attribute):" +msgstr "" +"整数値を含むbag（bagは <literal>order-by</literal> 属性によって反復順序が定義" +"されています）" -#: index.docbook:491 +#. Tag: programlisting +#: collection_mapping.xml:491 +#, no-c-format msgid "" - "<![CDATA[<bag name=\"sizes\" \n" - " table=\"item_sizes\" \n" - " order-by=\"size asc\">\n" - " <key column=\"item_id\"/>\n" - " <element column=\"size\" type=\"integer\"/>\n" - "</bag>]]>" +"<![CDATA[<bag name=\"sizes\" \n" +" table=\"item_sizes\" \n" +" order-by=\"size asc\">\n" +" <key column=\"item_id\"/>\n" +" <element column=\"size\" type=\"integer\"/>\n" +"</bag>]]>" msgstr "" - "<![CDATA[<bag name=\"sizes\" \n" - " table=\"item_sizes\" \n" - " order-by=\"size asc\">\n" - " <key column=\"item_id\"/>\n" - " <element column=\"size\" type=\"integer\"/>\n" - "</bag>]]>" -#: index.docbook:493 +#. Tag: para +#: collection_mapping.xml:493 +#, no-c-format msgid "An array of entities - in this case, a many to many association:" msgstr "エンティティの配列 - この場合、多対多の関連です。" -#: index.docbook:497 +#. Tag: programlisting +#: collection_mapping.xml:497 +#, no-c-format msgid "" - "<![CDATA[<array name=\"addresses\" \n" - " table=\"PersonAddress\" \n" - " cascade=\"persist\">\n" - " <key column=\"personId\"/>\n" - " <list-index column=\"sortOrder\"/>\n" - " <many-to-many column=\"addressId\" class=\"Address\"/>\n" - "</array>]]>" +"<![CDATA[<array name=\"addresses\" \n" +" table=\"PersonAddress\" \n" +" cascade=\"persist\">\n" +" <key column=\"personId\"/>\n" +" <list-index column=\"sortOrder\"/>\n" +" <many-to-many column=\"addressId\" class=\"Address\"/>\n" +"</array>]]>" msgstr "" - "<![CDATA[<array name=\"addresses\" \n" - " table=\"PersonAddress\" \n" - " cascade=\"persist\">\n" - " <key column=\"personId\"/>\n" - " <list-index column=\"sortOrder\"/>\n" - " <many-to-many column=\"addressId\" class=\"Address\"/>\n" - "</array>]]>" -#: index.docbook:499 +#. Tag: para +#: collection_mapping.xml:499 +#, no-c-format msgid "A map from string indices to dates:" msgstr "文字列と日付のmap" -#: index.docbook:503 +#. Tag: programlisting +#: collection_mapping.xml:503 +#, no-c-format msgid "" - "<![CDATA[<map name=\"holidays\" \n" - " table=\"holidays\" \n" - " schema=\"dbo\" \n" - " order-by=\"hol_name asc\">\n" - " <key column=\"id\"/>\n" - " <map-key column=\"hol_name\" type=\"string\"/>\n" - " <element column=\"hol_date\" type=\"date\"/>\n" - "</map>]]>" +"<![CDATA[<map name=\"holidays\" \n" +" table=\"holidays\" \n" +" schema=\"dbo\" \n" +" order-by=\"hol_name asc\">\n" +" <key column=\"id\"/>\n" +" <map-key column=\"hol_name\" type=\"string\"/>\n" +" <element column=\"hol_date\" type=\"date\"/>\n" +"</map>]]>" msgstr "" - "<![CDATA[<map name=\"holidays\" \n" - " table=\"holidays\" \n" - " schema=\"dbo\" \n" - " order-by=\"hol_name asc\">\n" - " <key column=\"id\"/>\n" - " <map-key column=\"hol_name\" type=\"string\"/>\n" - " <element column=\"hol_date\" type=\"date\"/>\n" - "</map>]]>" -#: index.docbook:505 +#. Tag: para +#: collection_mapping.xml:505 +#, no-c-format msgid "A list of components (discussed in the next chapter):" msgstr "コンポーネントのlist（次の章で詳しく説明します）" -#: index.docbook:509 +#. Tag: programlisting +#: collection_mapping.xml:509 +#, no-c-format msgid "" - "<![CDATA[<list name=\"carComponents\" \n" - " table=\"CarComponents\">\n" - " <key column=\"carId\"/>\n" - " <list-index column=\"sortOrder\"/>\n" - " <composite-element class=\"CarComponent\">\n" - " <property name=\"price\"/>\n" - " <property name=\"type\"/>\n" - " <property name=\"serialNumber\" column=\"serialNum\"/>\n" - " </composite-element>\n" - "</list>]]>" +"<![CDATA[<list name=\"carComponents\" \n" +" table=\"CarComponents\">\n" +" <key column=\"carId\"/>\n" +" <list-index column=\"sortOrder\"/>\n" +" <composite-element class=\"CarComponent\">\n" +" <property name=\"price\"/>\n" +" <property name=\"type\"/>\n" +" <property name=\"serialNumber\" column=\"serialNum\"/>\n" +" </composite-element>\n" +"</list>]]>" msgstr "" - "<![CDATA[<list name=\"carComponents\" \n" - " table=\"CarComponents\">\n" - " <key column=\"carId\"/>\n" - " <list-index column=\"sortOrder\"/>\n" - " <composite-element class=\"CarComponent\">\n" - " <property name=\"price\"/>\n" - " <property name=\"type\"/>\n" - " <property name=\"serialNumber\" column=\"serialNum\"/>\n" - " </composite-element>\n" - "</list>]]>" -#: index.docbook:514 +#. Tag: title +#: collection_mapping.xml:514 +#, no-c-format msgid "One-to-many associations" msgstr "一対多関連" -#: index.docbook:516 -msgid "A <emphasis>one to many association</emphasis> links the tables of two classes via a foreign key, with no intervening collection table. This mapping loses certain semantics of normal Java collections:" -msgstr "<emphasis>一対多関連</emphasis> は、コレクション･テーブルを介さず、外部キーにより2つのクラスのテーブルを関連付けます。このマッピングは標準的なJavaのコレクションのセマンティクスをいくつか失います。" +#. Tag: para +#: collection_mapping.xml:516 +#, no-c-format +msgid "" +"A <emphasis>one to many association</emphasis> links the tables of two " +"classes via a foreign key, with no intervening collection table. This " +"mapping loses certain semantics of normal Java collections:" +msgstr "" +"<emphasis>一対多関連</emphasis> は、コレクション･テーブルを介さず、外部キー" +"により2つのクラスのテーブルを関連付けます。このマッピングは標準的なJavaのコ" +"レクションのセマンティクスをいくつか失います。" -#: index.docbook:524 -msgid "An instance of the contained entity class may not belong to more than one instance of the collection" -msgstr "エンティティクラスのインスタンスは、 2つ以上のコレクションのインスタンスに属してはいけません。" +#. Tag: para +#: collection_mapping.xml:524 +#, no-c-format +msgid "" +"An instance of the contained entity class may not belong to more than one " +"instance of the collection" +msgstr "" +"エンティティクラスのインスタンスは、 2つ以上のコレクションのインスタンスに属" +"してはいけません。" -#: index.docbook:530 -msgid "An instance of the contained entity class may not appear at more than one value of the collection index" -msgstr "コレクションに含まれるエンティティクラスのインスタンスは、コレクションインデックスの値として2度以上現れてはいけません。" +#. Tag: para +#: collection_mapping.xml:530 +#, no-c-format +msgid "" +"An instance of the contained entity class may not appear at more than one " +"value of the collection index" +msgstr "" +"コレクションに含まれるエンティティクラスのインスタンスは、コレクションイン" +"デックスの値として2度以上現れてはいけません。" -#: index.docbook:537 -msgid "An association from <literal>Product</literal> to <literal>Part</literal> requires existence of a foreign key column and possibly an index column to the <literal>Part</literal> table. A <literal><one-to-many></literal> tag indicates that this is a one to many association." -msgstr "<literal>Product</literal> から <literal>Part</literal> への関連は、 <literal>Part</literal> テーブルへの外部キーカラムと、場合によってはインデックスカラムが必要です。 <literal><one-to-many></literal> タグは、これが一対多関連であることを表しています。" +#. Tag: para +#: collection_mapping.xml:537 +#, no-c-format +msgid "" +"An association from <literal>Product</literal> to <literal>Part</literal> " +"requires existence of a foreign key column and possibly an index column to " +"the <literal>Part</literal> table. A <literal><one-to-many></literal> " +"tag indicates that this is a one to many association." +msgstr "" +"<literal>Product</literal> から <literal>Part</literal> への関連は、 " +"<literal>Part</literal> テーブルへの外部キーカラムと、場合によってはインデッ" +"クスカラムが必要です。 <literal><one-to-many></literal> タグは、これが" +"一対多関連であることを表しています。" -#: index.docbook:550 +#. Tag: programlisting +#: collection_mapping.xml:550 +#, no-c-format msgid "" - "<![CDATA[<one-to-many \n" - " class=\"ClassName\"\n" - " not-found=\"ignore|exception\"\n" - " entity-name=\"EntityName\"\n" - " node=\"element-name\"\n" - " embed-xml=\"true|false\"\n" - " />]]>" +"<![CDATA[<one-to-many \n" +" class=\"ClassName\"\n" +" not-found=\"ignore|exception\"\n" +" entity-name=\"EntityName\"\n" +" node=\"element-name\"\n" +" embed-xml=\"true|false\"\n" +" />]]>" msgstr "" - "<![CDATA[<one-to-many \n" - " class=\"ClassName\"\n" - " not-found=\"ignore|exception\"\n" - " entity-name=\"EntityName\"\n" - " node=\"element-name\"\n" - " embed-xml=\"true|false\"\n" - " />]]>" -#: index.docbook:553 +#. Tag: para +#: collection_mapping.xml:553 +#, no-c-format msgid "<literal>class</literal> (required): The name of the associated class." msgstr "<literal>class</literal> （必須）: 関連クラスの名前。" -#: index.docbook:558 -msgid "<literal>not-found</literal> (optional - defaults to <literal>exception</literal>): Specifies how cached identifiers that reference missing rows will be handled: <literal>ignore</literal> will treat a missing row as a null association." -msgstr "<literal>not-found</literal> （オプション - デフォルトは <literal>exception</literal>）: 参照先の行がないキャッシュされた識別子をどのように扱うかを指定します。 <literal>ignore</literal> を指定すると、行がないことを関連がないものとして扱います。" +#. Tag: para +#: collection_mapping.xml:558 +#, no-c-format +msgid "" +"<literal>not-found</literal> (optional - defaults to <literal>exception</" +"literal>): Specifies how cached identifiers that reference missing rows will " +"be handled: <literal>ignore</literal> will treat a missing row as a null " +"association." +msgstr "" +"<literal>not-found</literal> （オプション - デフォルトは <literal>exception</" +"literal>）: 参照先の行がないキャッシュされた識別子をどのように扱うかを指定し" +"ます。 <literal>ignore</literal> を指定すると、行がないことを関連がないものと" +"して扱います。" -#: index.docbook:565 -msgid "<literal>entity-name</literal> (optional): The entity name of the associated class, as an alternative to <literal>class</literal>." -msgstr "<literal>entity-name</literal> （オプション）: <literal>class</literal> の代替である関連クラスのエンティティ名。 <literal>class</literal> の代わりに指定する、関連クラスのエンティティ名。" +#. Tag: para +#: collection_mapping.xml:565 +#, no-c-format +msgid "" +"<literal>entity-name</literal> (optional): The entity name of the associated " +"class, as an alternative to <literal>class</literal>." +msgstr "" +"<literal>entity-name</literal> （オプション）: <literal>class</literal> の代" +"替である関連クラスのエンティティ名。 <literal>class</literal> の代わりに指定" +"する、関連クラスのエンティティ名。" -#: index.docbook:573 -msgid "Notice that the <literal><one-to-many></literal> element does not need to declare any columns. Nor is it necessary to specify the <literal>table</literal> name anywhere." -msgstr "<literal><one-to-many></literal> 要素はカラムを宣言する必要がないことに注意してください。同様に <literal>テーブル</literal> 名を指定する必要もありません。" +#. Tag: para +#: collection_mapping.xml:573 +#, no-c-format +msgid "" +"Notice that the <literal><one-to-many></literal> element does not need " +"to declare any columns. Nor is it necessary to specify the <literal>table</" +"literal> name anywhere." +msgstr "" +"<literal><one-to-many></literal> 要素はカラムを宣言する必要がないことに" +"注意してください。同様に <literal>テーブル</literal> 名を指定する必要もあり" +"ません。" -#: index.docbook:579 -msgid "<emphasis>Very important note:</emphasis> If the foreign key column of a <literal><one-to-many></literal> association is declared <literal>NOT NULL</literal>, you must declare the <literal><key></literal> mapping <literal>not-null=\"true\"</literal> or <emphasis>use a bidirectional association</emphasis> with the collection mapping marked <literal>inverse=\"true\"</literal>. See the discussion of bidirectional associations later in this chapter." -msgstr "<emphasis>とても重要な注意:</emphasis> もし <literal><one-to-many></literal> 関連の外部キーカラムが <literal>NOT NULL</literal>と宣言された場合、 <literal><key></literal> マッピングに <literal>not-null=\"true\"</literal> を宣言するか、コレクションマッピングに <literal>inverse=\"true\"</literal> を付けた上で、 <emphasis>双方向関連を使う</emphasis> 必要があります。双方向関連についてはこの章の後のほうで説明します。" +#. Tag: para +#: collection_mapping.xml:579 +#, no-c-format +msgid "" +"<emphasis>Very important note:</emphasis> If the foreign key column of a " +"<literal><one-to-many></literal> association is declared <literal>NOT " +"NULL</literal>, you must declare the <literal><key></literal> mapping " +"<literal>not-null=\"true\"</literal> or <emphasis>use a bidirectional " +"association</emphasis> with the collection mapping marked <literal>inverse=" +"\"true\"</literal>. See the discussion of bidirectional associations later " +"in this chapter." +msgstr "" +"<emphasis>とても重要な注意:</emphasis> もし <literal><one-to-many></" +"literal> 関連の外部キーカラムが <literal>NOT NULL</literal>と宣言された場" +"合、 <literal><key></literal> マッピングに <literal>not-null=\"true\"</" +"literal> を宣言するか、コレクションマッピングに <literal>inverse=\"true\"</" +"literal> を付けた上で、 <emphasis>双方向関連を使う</emphasis> 必要がありま" +"す。双方向関連についてはこの章の後のほうで説明します。" -#: index.docbook:588 -msgid "This example shows a map of <literal>Part</literal> entities by name (where <literal>partName</literal> is a persistent property of <literal>Part</literal>). Notice the use of a formula-based index." -msgstr "次の例は、名称（<literal>Part</literal> の永続的なプロパティである <literal>partName</literal>）による <literal>Part</literal> エンティティのmapを表しています。 formulaによるインデックスを使っていることに注意してください。" +#. Tag: para +#: collection_mapping.xml:588 +#, no-c-format +msgid "" +"This example shows a map of <literal>Part</literal> entities by name (where " +"<literal>partName</literal> is a persistent property of <literal>Part</" +"literal>). Notice the use of a formula-based index." +msgstr "" +"次の例は、名称（<literal>Part</literal> の永続的なプロパティである " +"<literal>partName</literal>）による <literal>Part</literal> エンティティの" +"mapを表しています。 formulaによるインデックスを使っていることに注意してくださ" +"い。" -#: index.docbook:594 +#. Tag: programlisting +#: collection_mapping.xml:594 +#, no-c-format msgid "" - "<![CDATA[<map name=\"parts\"\n" - " cascade=\"all\">\n" - " <key column=\"productId\" not-null=\"true\"/>\n" - " <map-key formula=\"partName\"/>\n" - " <one-to-many class=\"Part\"/>\n" - "</map>]]>" +"<![CDATA[<map name=\"parts\"\n" +" cascade=\"all\">\n" +" <key column=\"productId\" not-null=\"true\"/>\n" +" <map-key formula=\"partName\"/>\n" +" <one-to-many class=\"Part\"/>\n" +"</map>]]>" msgstr "" - "<![CDATA[<map name=\"parts\"\n" - " cascade=\"all\">\n" - " <key column=\"productId\" not-null=\"true\"/>\n" - " <map-key formula=\"partName\"/>\n" - " <one-to-many class=\"Part\"/>\n" - "</map>]]>" -#: index.docbook:600 +#. Tag: title +#: collection_mapping.xml:600 +#, no-c-format msgid "Advanced collection mappings" msgstr "高度なコレクション･マッピング" -#: index.docbook:603 +#. Tag: title +#: collection_mapping.xml:603 +#, no-c-format msgid "Sorted collections" msgstr "ソートされたコレクション" -#: index.docbook:605 -msgid "Hibernate supports collections implementing <literal>java.util.SortedMap</literal> and <literal>java.util.SortedSet</literal>. You must specify a comparator in the mapping file:" -msgstr "Hibernateは <literal>java.util.SortedMap</literal> と <literal>java.util.SortedSet</literal> を実装したコレクションをサポートしています。開発者はマッピング定義ファイルにコンパレータを指定しなければなりません。" +#. Tag: para +#: collection_mapping.xml:605 +#, no-c-format +msgid "" +"Hibernate supports collections implementing <literal>java.util.SortedMap</" +"literal> and <literal>java.util.SortedSet</literal>. You must specify a " +"comparator in the mapping file:" +msgstr "" +"Hibernateは <literal>java.util.SortedMap</literal> と <literal>java.util." +"SortedSet</literal> を実装したコレクションをサポートしています。開発者はマッ" +"ピング定義ファイルにコンパレータを指定しなければなりません。" -#: index.docbook:610 +#. Tag: programlisting +#: collection_mapping.xml:610 +#, no-c-format msgid "" - "<![CDATA[<set name=\"aliases\" \n" - " table=\"person_aliases\" \n" - " sort=\"natural\">\n" - " <key column=\"person\"/>\n" - " <element column=\"name\" type=\"string\"/>\n" - "</set>\n" - "\n" - "<map name=\"holidays\" sort=\"my.custom.HolidayComparator\">\n" - " <key column=\"year_id\"/>\n" - " <map-key column=\"hol_name\" type=\"string\"/>\n" - " <element column=\"hol_date\" type=\"date\"/>\n" - "</map>]]>" +"<![CDATA[<set name=\"aliases\" \n" +" table=\"person_aliases\" \n" +" sort=\"natural\">\n" +" <key column=\"person\"/>\n" +" <element column=\"name\" type=\"string\"/>\n" +"</set>\n" +"\n" +"<map name=\"holidays\" sort=\"my.custom.HolidayComparator\">\n" +" <key column=\"year_id\"/>\n" +" <map-key column=\"hol_name\" type=\"string\"/>\n" +" <element column=\"hol_date\" type=\"date\"/>\n" +"</map>]]>" msgstr "" - "<![CDATA[<set name=\"aliases\" \n" - " table=\"person_aliases\" \n" - " sort=\"natural\">\n" - " <key column=\"person\"/>\n" - " <element column=\"name\" type=\"string\"/>\n" - "</set>\n" - "\n" - "<map name=\"holidays\" sort=\"my.custom.HolidayComparator\">\n" - " <key column=\"year_id\"/>\n" - " <map-key column=\"hol_name\" type=\"string\"/>\n" - " <element column=\"hol_date\" type=\"date\"/>\n" - "</map>]]>" -#: index.docbook:612 -msgid "Allowed values of the <literal>sort</literal> attribute are <literal>unsorted</literal>, <literal>natural</literal> and the name of a class implementing <literal>java.util.Comparator</literal>." -msgstr "<literal>sort</literal> 属性に設定できる値は <literal>unsorted</literal> と <literal>natural</literal> および、<literal>java.util.Comparator</literal> を実装したクラスの名前です。" +#. Tag: para +#: collection_mapping.xml:612 +#, no-c-format +msgid "" +"Allowed values of the <literal>sort</literal> attribute are " +"<literal>unsorted</literal>, <literal>natural</literal> and the name of a " +"class implementing <literal>java.util.Comparator</literal>." +msgstr "" +"<literal>sort</literal> 属性に設定できる値は <literal>unsorted</literal> と " +"<literal>natural</literal> および、<literal>java.util.Comparator</literal> を" +"実装したクラスの名前です。" -#: index.docbook:618 -msgid "Sorted collections actually behave like <literal>java.util.TreeSet</literal> or <literal>java.util.TreeMap</literal>." -msgstr "ソートされたコレクションは実質的には <literal>java.util.TreeSet</literal> や <literal>java.util.TreeMap</literal> のように振舞います。" +#. Tag: para +#: collection_mapping.xml:618 +#, no-c-format +msgid "" +"Sorted collections actually behave like <literal>java.util.TreeSet</literal> " +"or <literal>java.util.TreeMap</literal>." +msgstr "" +"ソートされたコレクションは実質的には <literal>java.util.TreeSet</literal> や " +"<literal>java.util.TreeMap</literal> のように振舞います。" -#: index.docbook:623 -msgid "If you want the database itself to order the collection elements use the <literal>order-by</literal> attribute of <literal>set</literal>, <literal>bag</literal> or <literal>map</literal> mappings. This solution is only available under JDK 1.4 or higher (it is implemented using <literal>LinkedHashSet</literal> or <literal>LinkedHashMap</literal>). This performs the ordering in the SQL query, not in memory." -msgstr "もしデータベース自身にコレクションの要素を並べさせたいなら、 <literal>set</literal> や <literal>bag</literal>、<literal>map</literal> の <literal>order-by</literal> 属性を使います。この解決法はJDK1.4、もしくはそれ以上のバージョンで利用可能です（<literal>LinkedHashSet</literal> または <literal>LinkedHashMap</literal>を使って実装されています）。整列はメモリ上ではなく、SQLクエリ内で実行されます。" +#. Tag: para +#: collection_mapping.xml:623 +#, no-c-format +msgid "" +"If you want the database itself to order the collection elements use the " +"<literal>order-by</literal> attribute of <literal>set</literal>, " +"<literal>bag</literal> or <literal>map</literal> mappings. This solution is " +"only available under JDK 1.4 or higher (it is implemented using " +"<literal>LinkedHashSet</literal> or <literal>LinkedHashMap</literal>). This " +"performs the ordering in the SQL query, not in memory." +msgstr "" +"もしデータベース自身にコレクションの要素を並べさせたいなら、 <literal>set</" +"literal> や <literal>bag</literal>、<literal>map</literal> の <literal>order-" +"by</literal> 属性を使います。この解決法はJDK1.4、もしくはそれ以上のバージョ" +"ンで利用可能です（<literal>LinkedHashSet</literal> または " +"<literal>LinkedHashMap</literal>を使って実装されています）。整列はメモリ上で" +"はなく、SQLクエリ内で実行されます。" -#: index.docbook:632 +#. Tag: programlisting +#: collection_mapping.xml:632 +#, no-c-format msgid "" - "<![CDATA[<set name=\"aliases\" table=\"person_aliases\" order-by=\"lower(name) asc\">\n" - " <key column=\"person\"/>\n" - " <element column=\"name\" type=\"string\"/>\n" - "</set>\n" - "\n" - "<map name=\"holidays\" order-by=\"hol_date, hol_name\">\n" - " <key column=\"year_id\"/>\n" - " <map-key column=\"hol_name\" type=\"string\"/>\n" - " <element column=\"hol_date type=\"date\"/>\n" - "</map>]]>" +"<![CDATA[<set name=\"aliases\" table=\"person_aliases\" order-by=\"lower" +"(name) asc\">\n" +" <key column=\"person\"/>\n" +" <element column=\"name\" type=\"string\"/>\n" +"</set>\n" +"\n" +"<map name=\"holidays\" order-by=\"hol_date, hol_name\">\n" +" <key column=\"year_id\"/>\n" +" <map-key column=\"hol_name\" type=\"string\"/>\n" +" <element column=\"hol_date type=\"date\"/>\n" +"</map>]]>" msgstr "" - "<![CDATA[<set name=\"aliases\" table=\"person_aliases\" order-by=\"lower(name) asc\">\n" - " <key column=\"person\"/>\n" - " <element column=\"name\" type=\"string\"/>\n" - "</set>\n" - "\n" - "<map name=\"holidays\" order-by=\"hol_date, hol_name\">\n" - " <key column=\"year_id\"/>\n" - " <map-key column=\"hol_name\" type=\"string\"/>\n" - " <element column=\"hol_date\" type=\"date\"/>\n" - "</map>]]>" -#: index.docbook:634 -msgid "Note that the value of the <literal>order-by</literal> attribute is an SQL ordering, not a HQL ordering!" -msgstr "<literal>order-by</literal> 属性の値がSQL命令であって、HQL命令ではないことに注意してください！" +#. Tag: para +#: collection_mapping.xml:634 +#, no-c-format +msgid "" +"Note that the value of the <literal>order-by</literal> attribute is an SQL " +"ordering, not a HQL ordering!" +msgstr "" +"<literal>order-by</literal> 属性の値がSQL命令であって、HQL命令ではないことに" +"注意してください！" -#: index.docbook:639 -msgid "Associations may even be sorted by some arbitrary criteria at runtime using a collection <literal>filter()</literal>." -msgstr "関連は、コレクションの <literal>filter()</literal> を使うことで、実行時に任意のcriteriaによってソートすることも可能です。" +#. Tag: para +#: collection_mapping.xml:639 +#, no-c-format +msgid "" +"Associations may even be sorted by some arbitrary criteria at runtime using " +"a collection <literal>filter()</literal>." +msgstr "" +"関連は、コレクションの <literal>filter()</literal> を使うことで、実行時に任" +"意のcriteriaによってソートすることも可能です。" -#: index.docbook:644 -msgid "<![CDATA[sortedUsers = s.createFilter( group.getUsers(), \"order by this.name\" ).list();]]>" -msgstr "<![CDATA[sortedUsers = s.createFilter( group.getUsers(), \"order by this.name\" ).list();]]>" +#. Tag: programlisting +#: collection_mapping.xml:644 +#, no-c-format +msgid "" +"<![CDATA[sortedUsers = s.createFilter( group.getUsers(), \"order by this.name" +"\" ).list();]]>" +msgstr "" -#: index.docbook:649 +#. Tag: title +#: collection_mapping.xml:649 +#, no-c-format msgid "Bidirectional associations" msgstr "双方向関連" -#: index.docbook:651 -msgid "A <emphasis>bidirectional association</emphasis> allows navigation from both \"ends\" of the association. Two kinds of bidirectional association are supported:" -msgstr "<emphasis>双方向関連</emphasis> は関連のどちら「側」からでもナビゲーションできます。 2種類の双方向関連がサポートされています。" +#. Tag: para +#: collection_mapping.xml:651 +#, fuzzy, no-c-format +msgid "" +"A <emphasis>bidirectional association</emphasis> allows navigation from both " +"\"ends\" of the association. Two kinds of bidirectional association are " +"supported:" +msgstr "" +"<emphasis>双方向関連</emphasis> は関連のどちら「側」からでもナビゲーションで" +"きます。 2種類の双方向関連がサポートされています。 <placeholder-1/>" -#: index.docbook:658 +#. Tag: term +#: collection_mapping.xml:658 +#, no-c-format msgid "one-to-many" msgstr "one-to-many" -#: index.docbook:660 +#. Tag: para +#: collection_mapping.xml:660 +#, no-c-format msgid "set or bag valued at one end, single-valued at the other" msgstr "片側がsetかbag、もう片方が単一値です。" -#: index.docbook:666 +#. Tag: term +#: collection_mapping.xml:666 +#, no-c-format msgid "many-to-many" msgstr "many-to-many" -#: index.docbook:668 +#. Tag: para +#: collection_mapping.xml:668 +#, no-c-format msgid "set or bag valued at both ends" msgstr "両側がsetかbagです。" -#: index.docbook:677 -msgid "You may specify a bidirectional many-to-many association simply by mapping two many-to-many associations to the same database table and declaring one end as <emphasis>inverse</emphasis> (which one is your choice, but it can not be an indexed collection)." -msgstr "2つの多対多関連で同じデータベーステーブルをマッピングし、片方を <emphasis>inverse</emphasis> として宣言することで、双方向の多対多関連を指定することが出来ます（どちらをinverseに選んだとしても、そちら側にはインデックス付きのコレクションは使えません）。" +#. Tag: para +#: collection_mapping.xml:677 +#, no-c-format +msgid "" +"You may specify a bidirectional many-to-many association simply by mapping " +"two many-to-many associations to the same database table and declaring one " +"end as <emphasis>inverse</emphasis> (which one is your choice, but it can " +"not be an indexed collection)." +msgstr "" +"2つの多対多関連で同じデータベーステーブルをマッピングし、片方を " +"<emphasis>inverse</emphasis> として宣言することで、双方向の多対多関連を指定" +"することが出来ます（どちらをinverseに選んだとしても、そちら側にはインデック" +"ス付きのコレクションは使えません）。" -#: index.docbook:684 -msgid "Here's an example of a bidirectional many-to-many association; each category can have many items and each item can be in many categories:" -msgstr "次に双方向の多対多関連の例を示します。各カテゴリは多数のアイテムを持つことができ、各アイテムは多くのカテゴリに属することが出来ます。" +#. Tag: para +#: collection_mapping.xml:684 +#, no-c-format +msgid "" +"Here's an example of a bidirectional many-to-many association; each category " +"can have many items and each item can be in many categories:" +msgstr "" +"次に双方向の多対多関連の例を示します。各カテゴリは多数のアイテムを持つことが" +"でき、各アイテムは多くのカテゴリに属することが出来ます。" -#: index.docbook:689 +#. Tag: programlisting +#: collection_mapping.xml:689 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Category\">\n" - " <id name=\"id\" column=\"CATEGORY_ID\"/>\n" - " ...\n" - " <bag name=\"items\" table=\"CATEGORY_ITEM\">\n" - " <key column=\"CATEGORY_ID\"/>\n" - " <many-to-many class=\"Item\" column=\"ITEM_ID\"/>\n" - " </bag>\n" - "</class>\n" - "\n" - "<class name=\"Item\">\n" - " <id name=\"id\" column=\"ITEM_ID\"/>\n" - " ...\n" - "\n" - " \n" - " <bag name=\"categories\" table=\"CATEGORY_ITEM\" inverse=\"true\">\n" - " <key column=\"ITEM_ID\"/>\n" - " <many-to-many class=\"Category\" column=\"CATEGORY_ID\"/>\n" - " </bag>\n" - "</class>]]>" +"<![CDATA[<class name=\"Category\">\n" +" <id name=\"id\" column=\"CATEGORY_ID\"/>\n" +" ...\n" +" <bag name=\"items\" table=\"CATEGORY_ITEM\">\n" +" <key column=\"CATEGORY_ID\"/>\n" +" <many-to-many class=\"Item\" column=\"ITEM_ID\"/>\n" +" </bag>\n" +"</class>\n" +"\n" +"<class name=\"Item\">\n" +" <id name=\"id\" column=\"ITEM_ID\"/>\n" +" ...\n" +"\n" +" \n" +" <bag name=\"categories\" table=\"CATEGORY_ITEM\" inverse=\"true\">\n" +" <key column=\"ITEM_ID\"/>\n" +" <many-to-many class=\"Category\" column=\"CATEGORY_ID\"/>\n" +" </bag>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Category\">\n" - " <id name=\"id\" column=\"CATEGORY_ID\"/>\n" - " ...\n" - " <bag name=\"items\" table=\"CATEGORY_ITEM\">\n" - " <key column=\"CATEGORY_ID\"/>\n" - " <many-to-many class=\"Item\" column=\"ITEM_ID\"/>\n" - " </bag>\n" - "</class>\n" - "\n" - "<class name=\"Item\">\n" - " <id name=\"id\" column=\"ITEM_ID\"/> -\n" - " ...\n" - "\n" - " \n" - " <bag name=\"categories\" table=\"CATEGORY_ITEM\" inverse=\"true\">\n" - " <key column=\"ITEM_ID\"/>\n" - " <many-to-many class=\"Category\" column=\"CATEGORY_ID\"/>\n" - " </bag>\n" - "</class>]]>" -#: index.docbook:691 -msgid "Changes made only to the inverse end of the association are <emphasis>not</emphasis> persisted. This means that Hibernate has two representations in memory for every bidirectional association, one link from A to B and another link from B to A. This is easier to understand if you think about the Java object model and how we create a many-to-many relationship in Java:" -msgstr "関連のinverse側にのみ行われた変更は永続化 <emphasis>されません</emphasis>。これは、Hibernateは全ての双方向関連について、メモリ上に２つの表現を持っているという意味です。つまり一つはAからBへのリンクで、もう一つはBからAへのリンクということです。 Javaのオブジェクトモデルについて考え、Javaで双方向関係をどうやって作るかを考えれば、これは理解しやすいです。下記に、Javaでの双方向関連を示します。" +#. Tag: para +#: collection_mapping.xml:691 +#, no-c-format +msgid "" +"Changes made only to the inverse end of the association are <emphasis>not</" +"emphasis> persisted. This means that Hibernate has two representations in " +"memory for every bidirectional association, one link from A to B and another " +"link from B to A. This is easier to understand if you think about the Java " +"object model and how we create a many-to-many relationship in Java:" +msgstr "" +"関連のinverse側にのみ行われた変更は永続化 <emphasis>されません</emphasis>。 " +"これは、Hibernateは全ての双方向関連について、メモリ上に２つの表現を持っている" +"という意味です。つまり一つはAからBへのリンクで、もう一つはBからAへのリンクと" +"いうことです。 Javaのオブジェクトモデルについて考え、Javaで双方向関係をどう" +"やって作るかを考えれば、これは理解しやすいです。下記に、Javaでの双方向関連を" +"示します。" -#: index.docbook:699 +#. Tag: programlisting +#: collection_mapping.xml:699 +#, no-c-format msgid "" - "<![CDATA[\n" - "category.getItems().add(item); // The category now \"knows\" about the relationship\n" - "item.getCategories().add(category); // The item now \"knows\" about the relationship\n" - "\n" - "session.persist(item); // The relationship won't be saved!\n" - "session.persist(category); // The relationship will be saved]]>" +"<![CDATA[\n" +"category.getItems().add(item); // The category now \"knows\" about " +"the relationship\n" +"item.getCategories().add(category); // The item now \"knows\" about the " +"relationship\n" +"\n" +"session.persist(item); // The relationship won't be " +"saved!\n" +"session.persist(category); // The relationship will be saved]]>" msgstr "" - "<![CDATA[\n" - "category.getItems().add(item); // The category now \"knows\" about the relationship\n" - "item.getCategories().add(category); // The item now \"knows\" about the relationship\n" - "\n" - "session.persist(item); // The relationship won't be saved!\n" - "session.persist(category); // The relationship will be saved]]>" -#: index.docbook:701 -msgid "The non-inverse side is used to save the in-memory representation to the database." -msgstr "関連のinverseではない側は、メモリ上の表現をデータベースに保存するのに使われます。" +#. Tag: para +#: collection_mapping.xml:701 +#, no-c-format +msgid "" +"The non-inverse side is used to save the in-memory representation to the " +"database." +msgstr "" +"関連のinverseではない側は、メモリ上の表現をデータベースに保存するのに使われま" +"す。" -#: index.docbook:705 -msgid "You may define a bidirectional one-to-many association by mapping a one-to-many association to the same table column(s) as a many-to-one association and declaring the many-valued end <literal>inverse=\"true\"</literal>." -msgstr "双方向の一対多関連を定義するには、一対多関連を多対一関連と同じテーブルのカラムにマッピングし、多側に <literal>inverse=\"true\"</literal> と宣言します。" +#. Tag: para +#: collection_mapping.xml:705 +#, no-c-format +msgid "" +"You may define a bidirectional one-to-many association by mapping a one-to-" +"many association to the same table column(s) as a many-to-one association " +"and declaring the many-valued end <literal>inverse=\"true\"</literal>." +msgstr "" +"双方向の一対多関連を定義するには、一対多関連を多対一関連と同じテーブルのカラ" +"ムにマッピングし、多側に <literal>inverse=\"true\"</literal> と宣言します。" -#: index.docbook:711 +#. Tag: programlisting +#: collection_mapping.xml:711 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Parent\">\n" - " <id name=\"id\" column=\"parent_id\"/>\n" - " ....\n" - " <set name=\"children\" inverse=\"true\">\n" - " <key column=\"parent_id\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </set>\n" - "</class>\n" - "\n" - "<class name=\"Child\">\n" - " <id name=\"id\" column=\"child_id\"/>\n" - " ....\n" - " <many-to-one name=\"parent\" \n" - " class=\"Parent\" \n" - " column=\"parent_id\"\n" - " not-null=\"true\"/>\n" - "</class>]]>" +"<![CDATA[<class name=\"Parent\">\n" +" <id name=\"id\" column=\"parent_id\"/>\n" +" ....\n" +" <set name=\"children\" inverse=\"true\">\n" +" <key column=\"parent_id\"/>\n" +" <one-to-many class=\"Child\"/>\n" +" </set>\n" +"</class>\n" +"\n" +"<class name=\"Child\">\n" +" <id name=\"id\" column=\"child_id\"/>\n" +" ....\n" +" <many-to-one name=\"parent\" \n" +" class=\"Parent\" \n" +" column=\"parent_id\"\n" +" not-null=\"true\"/>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Parent\">\n" - " <id name=\"id\" column=\"parent_id\"/>\n" - " ....\n" - " <set name=\"children\" inverse=\"true\">\n" - " <key column=\"parent_id\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </set>\n" - "</class>\n" - "\n" - "<class name=\"Child\">\n" - " <id name=\"id\" column=\"child_id\"/>\n" - " ....\n" - " <many-to-one name=\"parent\" \n" - " class=\"Parent\" \n" - " column=\"parent_id\"\n" - " not-null=\"true\"/>\n" - "</class>]]>" -#: index.docbook:713 -msgid "Mapping one end of an association with <literal>inverse=\"true\"</literal> doesn't affect the operation of cascades, these are orthogonal concepts!" -msgstr "関連の片側に <literal>inverse=\"true\"</literal> を設定しても、カスケード操作に影響を与えません。これらは直交した概念です！" +#. Tag: para +#: collection_mapping.xml:713 +#, no-c-format +msgid "" +"Mapping one end of an association with <literal>inverse=\"true\"</literal> " +"doesn't affect the operation of cascades, these are orthogonal concepts!" +msgstr "" +"関連の片側に <literal>inverse=\"true\"</literal> を設定しても、カスケード操" +"作に影響を与えません。これらは直交した概念です！" -#: index.docbook:721 +#. Tag: title +#: collection_mapping.xml:721 +#, no-c-format msgid "Bidirectional associations with indexed collections" msgstr "インデックス付きコレクションと双方向関連" -#: index.docbook:722 -msgid "A bidirectional association where one end is represented as a <literal><list></literal> or <literal><map></literal> requires special consideration. If there is a property of the child class which maps to the index column, no problem, we can continue using <literal>inverse=\"true\"</literal> on the collection mapping:" -msgstr "片側が <literal><list></literal> や <literal><map></literal> である双方向関連は、特によく考える必要があります。インデックスカラムにマップされる子クラスのプロパティがある場合は、問題ないです。コレクションのマッピングで <literal>inverse=\"true\"</literal> を使い続けられます。" +#. Tag: para +#: collection_mapping.xml:722 +#, no-c-format +msgid "" +"A bidirectional association where one end is represented as a <literal><" +"list></literal> or <literal><map></literal> requires special " +"consideration. If there is a property of the child class which maps to the " +"index column, no problem, we can continue using <literal>inverse=\"true\"</" +"literal> on the collection mapping:" +msgstr "" +"片側が <literal><list></literal> や <literal><map></literal> であ" +"る双方向関連は、特によく考える必要があります。インデックスカラムにマップさ" +"れる子クラスのプロパティがある場合は、問題ないです。コレクションのマッピング" +"で <literal>inverse=\"true\"</literal> を使い続けられます。" -#: index.docbook:729 +#. Tag: programlisting +#: collection_mapping.xml:729 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Parent\">\n" - " <id name=\"id\" column=\"parent_id\"/>\n" - " ....\n" - " <map name=\"children\" inverse=\"true\">\n" - " <key column=\"parent_id\"/>\n" - " <map-key column=\"name\" \n" - " type=\"string\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </map>\n" - "</class>\n" - "\n" - "<class name=\"Child\">\n" - " <id name=\"id\" column=\"child_id\"/>\n" - " ....\n" - " <property name=\"name\" \n" - " not-null=\"true\"/>\n" - " <many-to-one name=\"parent\" \n" - " class=\"Parent\" \n" - " column=\"parent_id\"\n" - " not-null=\"true\"/>\n" - "</class>]]>" +"<![CDATA[<class name=\"Parent\">\n" +" <id name=\"id\" column=\"parent_id\"/>\n" +" ....\n" +" <map name=\"children\" inverse=\"true\">\n" +" <key column=\"parent_id\"/>\n" +" <map-key column=\"name\" \n" +" type=\"string\"/>\n" +" <one-to-many class=\"Child\"/>\n" +" </map>\n" +"</class>\n" +"\n" +"<class name=\"Child\">\n" +" <id name=\"id\" column=\"child_id\"/>\n" +" ....\n" +" <property name=\"name\" \n" +" not-null=\"true\"/>\n" +" <many-to-one name=\"parent\" \n" +" class=\"Parent\" \n" +" column=\"parent_id\"\n" +" not-null=\"true\"/>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Parent\">\n" - " <id name=\"id\" column=\"parent_id\"/>\n" - " ....\n" - " <map name=\"children\" inverse=\"true\">\n" - " <key column=\"parent_id\"/>\n" - " <map-key column=\"name\" \n" - " type=\"string\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </map>\n" - "</class>\n" - "\n" - "<class name=\"Child\">\n" - " <id name=\"id\" column=\"child_id\"/>\n" - " ....\n" - " <property name=\"name\" \n" - " not-null=\"true\"/>\n" - " <many-to-one name=\"parent\" \n" - " class=\"Parent\" \n" - " column=\"parent_id\"\n" - " not-null=\"true\"/>\n" - "</class>]]>" -#: index.docbook:731 -msgid "But, if there is no such property on the child class, we can't think of the association as truly bidirectional (there is information available at one end of the association that is not available at the other end). In this case, we can't map the collection <literal>inverse=\"true\"</literal>. Instead, we could use the following mapping:" -msgstr "しかし、子クラスにそのようなプロパティがない場合は、関連を真に双方向であると考えることができません（関連の片側に利用できる情報がありますが、もう一方にはありません）。この場合は、コレクションに <literal>inverse=\"true\"</literal> をマッピングできません。代わりに、次のようなマッピングが使えます。" +#. Tag: para +#: collection_mapping.xml:731 +#, no-c-format +msgid "" +"But, if there is no such property on the child class, we can't think of the " +"association as truly bidirectional (there is information available at one " +"end of the association that is not available at the other end). In this " +"case, we can't map the collection <literal>inverse=\"true\"</literal>. " +"Instead, we could use the following mapping:" +msgstr "" +"しかし、子クラスにそのようなプロパティがない場合は、関連を真に双方向であると" +"考えることができません（関連の片側に利用できる情報がありますが、もう一方には" +"ありません）。この場合は、コレクションに <literal>inverse=\"true\"</" +"literal> をマッピングできません。代わりに、次のようなマッピングが使えます。" -#: index.docbook:738 +#. Tag: programlisting +#: collection_mapping.xml:738 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Parent\">\n" - " <id name=\"id\" column=\"parent_id\"/>\n" - " ....\n" - " <map name=\"children\">\n" - " <key column=\"parent_id\"\n" - " not-null=\"true\"/>\n" - " <map-key column=\"name\" \n" - " type=\"string\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </map>\n" - "</class>\n" - "\n" - "<class name=\"Child\">\n" - " <id name=\"id\" column=\"child_id\"/>\n" - " ....\n" - " <many-to-one name=\"parent\" \n" - " class=\"Parent\" \n" - " column=\"parent_id\"\n" - " insert=\"false\"\n" - " update=\"false\"\n" - " not-null=\"true\"/>\n" - "</class>]]>" +"<![CDATA[<class name=\"Parent\">\n" +" <id name=\"id\" column=\"parent_id\"/>\n" +" ....\n" +" <map name=\"children\">\n" +" <key column=\"parent_id\"\n" +" not-null=\"true\"/>\n" +" <map-key column=\"name\" \n" +" type=\"string\"/>\n" +" <one-to-many class=\"Child\"/>\n" +" </map>\n" +"</class>\n" +"\n" +"<class name=\"Child\">\n" +" <id name=\"id\" column=\"child_id\"/>\n" +" ....\n" +" <many-to-one name=\"parent\" \n" +" class=\"Parent\" \n" +" column=\"parent_id\"\n" +" insert=\"false\"\n" +" update=\"false\"\n" +" not-null=\"true\"/>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Parent\">\n" - " <id name=\"id\" column=\"parent_id\"/>\n" - " ....\n" - " <map name=\"children\">\n" - " <key column=\"parent_id\"\n" - " not-null=\"true\"/>\n" - " <map-key column=\"name\" \n" - " type=\"string\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </map>\n" - "</class>\n" - "\n" - "<class name=\"Child\">\n" - " <id name=\"id\" column=\"child_id\"/>\n" - " ....\n" - " <many-to-one name=\"parent\" \n" - " class=\"Parent\" \n" - " column=\"parent_id\"\n" - " insert=\"false\"\n" - " update=\"false\"\n" - " not-null=\"true\"/>\n" - "</class>]]>" -#: index.docbook:740 -msgid "Note that in this mapping, the collection-valued end of the association is responsible for updates to the foreign key. TODO: Does this really result in some unnecessary update statements?" -msgstr "注意：このマッピングでは、関連のコレクション値の側は、外部キーをアップデートする責任があります。" +#. Tag: para +#: collection_mapping.xml:740 +#, no-c-format +msgid "" +"Note that in this mapping, the collection-valued end of the association is " +"responsible for updates to the foreign key. TODO: Does this really result in " +"some unnecessary update statements?" +msgstr "" +"注意：このマッピングでは、関連のコレクション値の側は、外部キーをアップデー" +"トする責任があります。" -#: index.docbook:748 +#. Tag: title +#: collection_mapping.xml:748 +#, no-c-format msgid "Ternary associations" msgstr "3項関連" -#: index.docbook:750 -msgid "There are three possible approaches to mapping a ternary association. One is to use a <literal>Map</literal> with an association as its index:" -msgstr "3項関連のマッピングには3つのアプローチがあります。 1つ目は関連をインデックスとして <literal>Map</literal> を使用するアプローチです。" +#. Tag: para +#: collection_mapping.xml:750 +#, no-c-format +msgid "" +"There are three possible approaches to mapping a ternary association. One is " +"to use a <literal>Map</literal> with an association as its index:" +msgstr "" +"3項関連のマッピングには3つのアプローチがあります。 1つ目は関連をインデックス" +"として <literal>Map</literal> を使用するアプローチです。" -#: index.docbook:755 +#. Tag: programlisting +#: collection_mapping.xml:755 +#, no-c-format msgid "" - "<![CDATA[<map name=\"contracts\">\n" - " <key column=\"employer_id\" not-null=\"true\"/>\n" - " <map-key-many-to-many column=\"employee_id\" class=\"Employee\"/>\n" - " <one-to-many class=\"Contract\"/>\n" - "</map>]]>" +"<![CDATA[<map name=\"contracts\">\n" +" <key column=\"employer_id\" not-null=\"true\"/>\n" +" <map-key-many-to-many column=\"employee_id\" class=\"Employee\"/>\n" +" <one-to-many class=\"Contract\"/>\n" +"</map>]]>" msgstr "" - "<![CDATA[<map name=\"contracts\">\n" - " <key column=\"employer_id\" not-null=\"true\"/>\n" - " <map-key-many-to-many column=\"employee_id\" class=\"Employee\"/>\n" - " <one-to-many class=\"Contract\"/>\n" - "</map>]]>" -#: index.docbook:757 +#. Tag: programlisting +#: collection_mapping.xml:757 +#, no-c-format msgid "" - "<![CDATA[<map name=\"connections\">\n" - " <key column=\"incoming_node_id\"/>\n" - " <map-key-many-to-many column=\"outgoing_node_id\" class=\"Node\"/>\n" - " <many-to-many column=\"connection_id\" class=\"Connection\"/>\n" - "</map>]]>" +"<![CDATA[<map name=\"connections\">\n" +" <key column=\"incoming_node_id\"/>\n" +" <map-key-many-to-many column=\"outgoing_node_id\" class=\"Node\"/>\n" +" <many-to-many column=\"connection_id\" class=\"Connection\"/>\n" +"</map>]]>" msgstr "" - "<![CDATA[<map name=\"connections\">\n" - " <key column=\"incoming_node_id\"/>\n" - " <map-key-many-to-many column=\"outgoing_node_id\" class=\"Node\"/>\n" - " <many-to-many column=\"connection_id\" class=\"Connection\"/>\n" - "</map>]]>" -#: index.docbook:759 -msgid "A second approach is to simply remodel the association as an entity class. This is the approach we use most commonly." -msgstr "2つ目は単純に関連をエンティティ･クラスとしてモデルを作り直すアプローチで、頻繁に使われます。" +#. Tag: para +#: collection_mapping.xml:759 +#, no-c-format +msgid "" +"A second approach is to simply remodel the association as an entity class. " +"This is the approach we use most commonly." +msgstr "" +"2つ目は単純に関連をエンティティ･クラスとしてモデルを作り直すアプローチで、頻" +"繁に使われます。" -#: index.docbook:764 -msgid "A final alternative is to use composite elements, which we will discuss later." -msgstr "最後はcomposite要素を使うアプローチです。これに関する議論は後ほど行います。" +#. Tag: para +#: collection_mapping.xml:764 +#, no-c-format +msgid "" +"A final alternative is to use composite elements, which we will discuss " +"later." +msgstr "" +"最後はcomposite要素を使うアプローチです。これに関する議論は後ほど行います。" -#: index.docbook:771 +#. Tag: literal +#: collection_mapping.xml:771 +#, no-c-format msgid "Using an <idbag>" msgstr "<literal><idbag></literal>の使用" -#: index.docbook:773 -msgid "If you've fully embraced our view that composite keys are a bad thing and that entities should have synthetic identifiers (surrogate keys), then you might find it a bit odd that the many to many associations and collections of values that we've shown so far all map to tables with composite keys! Now, this point is quite arguable; a pure association table doesn't seem to benefit much from a surrogate key (though a collection of composite values <emphasis>might</emphasis>). Nevertheless, Hibernate provides a feature that allows you to map many to many associations and collections of values to a table with a surrogate key." -msgstr "複合キーは悪いもので、エンティティは人工の識別子(代理キー)を持つべきであるという考え方からは、多対多関連と値のコレクションを複合キーを用いたテーブルへマッピングするのは少し奇妙に感じるかもしれません！確かにこの考え方には議論の余地があります。純粋な関連テーブルは代理キーを使っても利益を得られないように思えるからです（合成値のコレクションは利益がある <emphasis>かも</emphasis> しれませんが）。とはいえ、Hibernateは代理キーを持つテーブルへ多対多関連と値のコレクションをマッピングする機能も備えています。" +#. Tag: para +#: collection_mapping.xml:773 +#, no-c-format +msgid "" +"If you've fully embraced our view that composite keys are a bad thing and " +"that entities should have synthetic identifiers (surrogate keys), then you " +"might find it a bit odd that the many to many associations and collections " +"of values that we've shown so far all map to tables with composite keys! " +"Now, this point is quite arguable; a pure association table doesn't seem to " +"benefit much from a surrogate key (though a collection of composite values " +"<emphasis>might</emphasis>). Nevertheless, Hibernate provides a feature that " +"allows you to map many to many associations and collections of values to a " +"table with a surrogate key." +msgstr "" +"複合キーは悪いもので、エンティティは人工の識別子(代理キー)を持つべきであると" +"いう考え方からは、多対多関連と値のコレクションを複合キーを用いたテーブルへ" +"マッピングするのは少し奇妙に感じるかもしれません！確かにこの考え方には議論の" +"余地があります。純粋な関連テーブルは代理キーを使っても利益を得られないように" +"思えるからです（合成値のコレクションは利益がある <emphasis>かも</emphasis> " +"しれませんが）。とはいえ、Hibernateは代理キーを持つテーブルへ多対多関連と値" +"のコレクションをマッピングする機能も備えています。" -#: index.docbook:784 -msgid "The <literal><idbag></literal> element lets you map a <literal>List</literal> (or <literal>Collection</literal>) with bag semantics." -msgstr "bagのセマンティックスを持った <literal>List</literal>（または <literal>Collection</literal>）を <literal><idbag></literal> 要素にマッピングできます。" +#. Tag: para +#: collection_mapping.xml:784 +#, no-c-format +msgid "" +"The <literal><idbag></literal> element lets you map a <literal>List</" +"literal> (or <literal>Collection</literal>) with bag semantics." +msgstr "" +"bagのセマンティックスを持った <literal>List</literal>（または " +"<literal>Collection</literal>）を <literal><idbag></literal> 要素にマッ" +"ピングできます。" -#: index.docbook:789 +#. Tag: programlisting +#: collection_mapping.xml:789 +#, no-c-format msgid "" - "<![CDATA[<idbag name=\"lovers\" table=\"LOVERS\">\n" - " <collection-id column=\"ID\" type=\"long\">\n" - " <generator class=\"sequence\"/>\n" - " </collection-id>\n" - " <key column=\"PERSON1\"/>\n" - " <many-to-many column=\"PERSON2\" class=\"Person\" fetch=\"join\"/>\n" - "</idbag>]]>" +"<![CDATA[<idbag name=\"lovers\" table=\"LOVERS\">\n" +" <collection-id column=\"ID\" type=\"long\">\n" +" <generator class=\"sequence\"/>\n" +" </collection-id>\n" +" <key column=\"PERSON1\"/>\n" +" <many-to-many column=\"PERSON2\" class=\"Person\" fetch=\"join\"/>\n" +"</idbag>]]>" msgstr "" - "<![CDATA[<idbag name=\"lovers\" table=\"LOVERS\">\n" - " <collection-id column=\"ID\" type=\"long\">\n" - " <generator class=\"sequence\"/>\n" - " </collection-id>\n" - " <key column=\"PERSON1\"/>\n" - " <many-to-many column=\"PERSON2\" class=\"Person\" fetch=\"join\"/>\n" - "</idbag>]]>" -#: index.docbook:791 -msgid "As you can see, an <literal><idbag></literal> has a synthetic id generator, just like an entity class! A different surrogate key is assigned to each collection row. Hibernate does not provide any mechanism to discover the surrogate key value of a particular row, however." -msgstr "ご存知のように <literal><idbag></literal> はエンティティ･クラスのように人工的なidジェネレータを持っています！異なる代理キーをそれぞれのコレクションの列に割り当てます。しかしながら、Hibernateはある行の代理キーの値を見つけ出す機構を持っていません。" +#. Tag: para +#: collection_mapping.xml:791 +#, no-c-format +msgid "" +"As you can see, an <literal><idbag></literal> has a synthetic id " +"generator, just like an entity class! A different surrogate key is assigned " +"to each collection row. Hibernate does not provide any mechanism to discover " +"the surrogate key value of a particular row, however." +msgstr "" +"ご存知のように <literal><idbag></literal> はエンティティ･クラスのよう" +"に人工的なidジェネレータを持っています！異なる代理キーをそれぞれのコレク" +"ションの列に割り当てます。しかしながら、Hibernateはある行の代理キーの値を見" +"つけ出す機構を持っていません。" -#: index.docbook:798 -msgid "Note that the update performance of an <literal><idbag></literal> is <emphasis>much</emphasis> better than a regular <literal><bag></literal>! Hibernate can locate individual rows efficiently and update or delete them individually, just like a list, map or set." -msgstr "<literal><idbag></literal> を更新するパフォーマンスは通常の <literal><bag></literal> よりも良いことに注目してください！ Hibernateは個々の行を効果的に見つけることができ、 listやmap、setのように個別にその行を更新、削除できます。" +#. Tag: para +#: collection_mapping.xml:798 +#, no-c-format +msgid "" +"Note that the update performance of an <literal><idbag></literal> is " +"<emphasis>much</emphasis> better than a regular <literal><bag></" +"literal>! Hibernate can locate individual rows efficiently and update or " +"delete them individually, just like a list, map or set." +msgstr "" +"<literal><idbag></literal> を更新するパフォーマンスは通常の " +"<literal><bag></literal> よりも良いことに注目してください！ Hibernateは" +"個々の行を効果的に見つけることができ、 listやmap、setのように個別にその行を更" +"新、削除できます。" -#: index.docbook:805 -msgid "In the current implementation, the <literal>native</literal> identifier generation strategy is not supported for <literal><idbag></literal> collection identifiers." -msgstr "現在の実装では、<literal>native</literal> というid生成戦略を <literal><idbag></literal> コレクションの識別子に対して使えません。" +#. Tag: para +#: collection_mapping.xml:805 +#, no-c-format +msgid "" +"In the current implementation, the <literal>native</literal> identifier " +"generation strategy is not supported for <literal><idbag></literal> " +"collection identifiers." +msgstr "" +"現在の実装では、<literal>native</literal> というid生成戦略を <literal><" +"idbag></literal> コレクションの識別子に対して使えません。" -#: index.docbook:829 +#. Tag: title +#: collection_mapping.xml:829 +#, no-c-format msgid "Collection examples" msgstr "コレクションの例" -#: index.docbook:831 -msgid "The previous sections are pretty confusing. So lets look at an example. This class:" +#. Tag: para +#: collection_mapping.xml:831 +#, no-c-format +msgid "" +"The previous sections are pretty confusing. So lets look at an example. This " +"class:" msgstr "これまでの節の説明では理解しにくいので、以下の例を見てください。" -#: index.docbook:836 +#. Tag: programlisting +#: collection_mapping.xml:836 +#, no-c-format msgid "" - "<![CDATA[package eg;\n" - "import java.util.Set;\n" - "\n" - "public class Parent {\n" - " private long id;\n" - " private Set children;\n" - "\n" - " public long getId() { return id; }\n" - " private void setId(long id) { this.id=id; }\n" - "\n" - " private Set getChildren() { return children; }\n" - " private void setChildren(Set children) { this.children=children; }\n" - "\n" - " ....\n" - " ....\n" - "}]]>" +"<![CDATA[package eg;\n" +"import java.util.Set;\n" +"\n" +"public class Parent {\n" +" private long id;\n" +" private Set children;\n" +"\n" +" public long getId() { return id; }\n" +" private void setId(long id) { this.id=id; }\n" +"\n" +" private Set getChildren() { return children; }\n" +" private void setChildren(Set children) { this.children=children; }\n" +"\n" +" ....\n" +" ....\n" +"}]]>" msgstr "" - "<![CDATA[package eg;\n" - "import java.util.Set;\n" - "\n" - "public class Parent {\n" - " private long id;\n" - " private Set children;\n" - "\n" - " public long getId() { return id; }\n" - " private void setId(long id) { this.id=id; }\n" - "\n" - " private Set getChildren() { return children; }\n" - " private void setChildren(Set children) { this.children=children; }\n" - "\n" - " ....\n" - " ....\n" - "}]]>" -#: index.docbook:838 -msgid "has a collection of <literal>Child</literal> instances. If each child has at most one parent, the most natural mapping is a one-to-many association:" -msgstr "このクラスは <literal>Child</literal> インスタンスのコレクションを持っています。もし各々のchildが最大でも一つのparentを持っているならば、最も自然なマッピングは一対多関連です。" +#. Tag: para +#: collection_mapping.xml:838 +#, no-c-format +msgid "" +"has a collection of <literal>Child</literal> instances. If each child has at " +"most one parent, the most natural mapping is a one-to-many association:" +msgstr "" +"このクラスは <literal>Child</literal> インスタンスのコレクションを持っていま" +"す。もし各々のchildが最大でも一つのparentを持っているならば、最も自然なマッ" +"ピングは一対多関連です。" -#: index.docbook:844 +#. Tag: programlisting +#: collection_mapping.xml:844 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"Parent\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <set name=\"children\">\n" - " <key column=\"parent_id\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </set>\n" - " </class>\n" - "\n" - " <class name=\"Child\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +"\n" +" <class name=\"Parent\">\n" +" <id name=\"id\">\n" +" <generator class=\"sequence\"/>\n" +" </id>\n" +" <set name=\"children\">\n" +" <key column=\"parent_id\"/>\n" +" <one-to-many class=\"Child\"/>\n" +" </set>\n" +" </class>\n" +"\n" +" <class name=\"Child\">\n" +" <id name=\"id\">\n" +" <generator class=\"sequence\"/>\n" +" </id>\n" +" <property name=\"name\"/>\n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"Parent\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <set name=\"children\">\n" - " <key column=\"parent_id\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </set>\n" - " </class>\n" - "\n" - " <class name=\"Child\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" -#: index.docbook:846 +#. Tag: para +#: collection_mapping.xml:846 +#, no-c-format msgid "This maps to the following table definitions:" msgstr "これは以下のテーブル定義にマッピングします。" -#: index.docbook:850 +#. Tag: programlisting +#: collection_mapping.xml:850 +#, no-c-format msgid "" - "<![CDATA[create table parent ( id bigint not null primary key )\n" - "create table child ( id bigint not null primary key, name varchar(255), parent_id bigint )\n" - "alter table child add constraint childfk0 (parent_id) references parent]]>" +"<![CDATA[create table parent ( id bigint not null primary key )\n" +"create table child ( id bigint not null primary key, name varchar(255), " +"parent_id bigint )\n" +"alter table child add constraint childfk0 (parent_id) references parent]]>" msgstr "" - "<![CDATA[create table parent ( id bigint not null primary key )\n" - "create table child ( id bigint not null primary key, name varchar(255), parent_id bigint )\n" - "alter table child add constraint childfk0 (parent_id) references parent]]>" -#: index.docbook:852 -msgid "If the parent is <emphasis>required</emphasis>, use a bidirectional one-to-many association:" -msgstr "もしparentが <emphasis>要求</emphasis> されるなら、双方向の一対多関連を使用してください。" +#. Tag: para +#: collection_mapping.xml:852 +#, no-c-format +msgid "" +"If the parent is <emphasis>required</emphasis>, use a bidirectional one-to-" +"many association:" +msgstr "" +"もしparentが <emphasis>要求</emphasis> されるなら、双方向の一対多関連を使用し" +"てください。" -#: index.docbook:857 +#. Tag: programlisting +#: collection_mapping.xml:857 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"Parent\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <set name=\"children\" inverse=\"true\">\n" - " <key column=\"parent_id\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </set>\n" - " </class>\n" - "\n" - " <class name=\"Child\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " <many-to-one name=\"parent\" class=\"Parent\" column=\"parent_id\" not-null=\"true\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +"\n" +" <class name=\"Parent\">\n" +" <id name=\"id\">\n" +" <generator class=\"sequence\"/>\n" +" </id>\n" +" <set name=\"children\" inverse=\"true\">\n" +" <key column=\"parent_id\"/>\n" +" <one-to-many class=\"Child\"/>\n" +" </set>\n" +" </class>\n" +"\n" +" <class name=\"Child\">\n" +" <id name=\"id\">\n" +" <generator class=\"sequence\"/>\n" +" </id>\n" +" <property name=\"name\"/>\n" +" <many-to-one name=\"parent\" class=\"Parent\" column=\"parent_id\" " +"not-null=\"true\"/>\n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"Parent\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <set name=\"children\" inverse=\"true\">\n" - " <key column=\"parent_id\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </set>\n" - " </class>\n" - "\n" - " <class name=\"Child\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " <many-to-one name=\"parent\" class=\"Parent\" column=\"parent_id\" not-null=\"true\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" -#: index.docbook:859 +#. Tag: para +#: collection_mapping.xml:859 +#, no-c-format msgid "Notice the <literal>NOT NULL</literal> constraint:" msgstr "<literal>NOT NULL</literal> 制約に注意してください。" -#: index.docbook:863 +#. Tag: programlisting +#: collection_mapping.xml:863 +#, no-c-format msgid "" - "<![CDATA[create table parent ( id bigint not null primary key )\n" - "create table child ( id bigint not null\n" - " primary key,\n" - " name varchar(255),\n" - " parent_id bigint not null )\n" - "alter table child add constraint childfk0 (parent_id) references parent]]>" +"<![CDATA[create table parent ( id bigint not null primary key )\n" +"create table child ( id bigint not null\n" +" primary key,\n" +" name varchar(255),\n" +" parent_id bigint not null )\n" +"alter table child add constraint childfk0 (parent_id) references parent]]>" msgstr "" - "<![CDATA[create table parent ( id bigint not null primary key )\n" - "create table child ( id bigint not null\n" - " primary key,\n" - " name varchar(255),\n" - " parent_id bigint not null )\n" - "alter table child add constraint childfk0 (parent_id) references parent]]>" -#: index.docbook:865 -msgid "Alternatively, if you absolutely insist that this association should be unidirectional, you can declare the <literal>NOT NULL</literal> constraint on the <literal><key></literal> mapping:" -msgstr "あるいは、もしこの関連は単方向であるべきと強く主張するのであれば、 <literal><key></literal> に <literal>NOT NULL</literal> 制約を宣言できます。" +#. Tag: para +#: collection_mapping.xml:865 +#, no-c-format +msgid "" +"Alternatively, if you absolutely insist that this association should be " +"unidirectional, you can declare the <literal>NOT NULL</literal> constraint " +"on the <literal><key></literal> mapping:" +msgstr "" +"あるいは、もしこの関連は単方向であるべきと強く主張するのであれば、 " +"<literal><key></literal> に <literal>NOT NULL</literal> 制約を宣言でき" +"ます。" -#: index.docbook:871 +#. Tag: programlisting +#: collection_mapping.xml:871 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"Parent\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <set name=\"children\">\n" - " <key column=\"parent_id\" not-null=\"true\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </set>\n" - " </class>\n" - "\n" - " <class name=\"Child\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +"\n" +" <class name=\"Parent\">\n" +" <id name=\"id\">\n" +" <generator class=\"sequence\"/>\n" +" </id>\n" +" <set name=\"children\">\n" +" <key column=\"parent_id\" not-null=\"true\"/>\n" +" <one-to-many class=\"Child\"/>\n" +" </set>\n" +" </class>\n" +"\n" +" <class name=\"Child\">\n" +" <id name=\"id\">\n" +" <generator class=\"sequence\"/>\n" +" </id>\n" +" <property name=\"name\"/>\n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"Parent\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <set name=\"children\">\n" - " <key column=\"parent_id\" not-null=\"true\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </set>\n" - " </class>\n" - "\n" - " <class name=\"Child\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" -#: index.docbook:873 -msgid "On the other hand, if a child might have multiple parents, a many-to-many association is appropriate:" +#. Tag: para +#: collection_mapping.xml:873 +#, no-c-format +msgid "" +"On the other hand, if a child might have multiple parents, a many-to-many " +"association is appropriate:" msgstr "一方で、もしchildが複数のparentを持てるならば、多対多関連が妥当です。" -#: index.docbook:878 +#. Tag: programlisting +#: collection_mapping.xml:878 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"Parent\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <set name=\"children\" table=\"childset\">\n" - " <key column=\"parent_id\"/>\n" - " <many-to-many class=\"Child\" column=\"child_id\"/>\n" - " </set>\n" - " </class>\n" - "\n" - " <class name=\"Child\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +"\n" +" <class name=\"Parent\">\n" +" <id name=\"id\">\n" +" <generator class=\"sequence\"/>\n" +" </id>\n" +" <set name=\"children\" table=\"childset\">\n" +" <key column=\"parent_id\"/>\n" +" <many-to-many class=\"Child\" column=\"child_id\"/>\n" +" </set>\n" +" </class>\n" +"\n" +" <class name=\"Child\">\n" +" <id name=\"id\">\n" +" <generator class=\"sequence\"/>\n" +" </id>\n" +" <property name=\"name\"/>\n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"Parent\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <set name=\"children\" table=\"childset\">\n" - " <key column=\"parent_id\"/>\n" - " <many-to-many class=\"Child\" column=\"child_id\"/>\n" - " </set>\n" - " </class>\n" - "\n" - " <class name=\"Child\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" -#: index.docbook:880 +#. Tag: para +#: collection_mapping.xml:880 +#, no-c-format msgid "Table definitions:" msgstr "テーブル定義は以下のようになります。" -#: index.docbook:884 +#. Tag: programlisting +#: collection_mapping.xml:884 +#, no-c-format msgid "" - "<![CDATA[create table parent ( id bigint not null primary key )\n" - "create table child ( id bigint not null primary key, name varchar(255) )\n" - "create table childset ( parent_id bigint not null,\n" - " child_id bigint not null,\n" - " primary key ( parent_id, child_id ) )\n" - "alter table childset add constraint childsetfk0 (parent_id) references parent\n" - "alter table childset add constraint childsetfk1 (child_id) references child]]>" +"<![CDATA[create table parent ( id bigint not null primary key )\n" +"create table child ( id bigint not null primary key, name varchar(255) )\n" +"create table childset ( parent_id bigint not null,\n" +" child_id bigint not null,\n" +" primary key ( parent_id, child_id ) )\n" +"alter table childset add constraint childsetfk0 (parent_id) references " +"parent\n" +"alter table childset add constraint childsetfk1 (child_id) references child]]" +">" msgstr "" - "<![CDATA[create table parent ( id bigint not null primary key )\n" - "create table child ( id bigint not null primary key, name varchar(255) )\n" - "create table childset ( parent_id bigint not null,\n" - " child_id bigint not null,\n" - " primary key ( parent_id, child_id ) )\n" - "alter table childset add constraint childsetfk0 (parent_id) references parent\n" - "alter table childset add constraint childsetfk1 (child_id) references child]]>" -#: index.docbook:886 -msgid "For more examples and a complete walk-through a parent/child relationship mapping, see <xref linkend=\"example-parentchild\"/>." -msgstr "parent/child関係のマッピングについてのより多くの例や完全な手順が必要であれば、 <xref linkend=\"example-parentchild\"/> をご覧ください。" +#. Tag: para +#: collection_mapping.xml:886 +#, no-c-format +msgid "" +"For more examples and a complete walk-through a parent/child relationship " +"mapping, see <xref linkend=\"example-parentchild\"/>." +msgstr "" +"parent/child関係のマッピングについてのより多くの例や完全な手順が必要であれ" +"ば、 <xref linkend=\"example-parentchild\"/> をご覧ください。" -#: index.docbook:891 -msgid "Even more exotic association mappings are possible, we will catalog all possibilities in the next chapter." +#. Tag: para +#: collection_mapping.xml:891 +#, no-c-format +msgid "" +"Even more exotic association mappings are possible, we will catalog all " +"possibilities in the next chapter." msgstr "また、さらに特殊な関連マッピングも可能です。次の章で詳しく述べます。" -msgid "ROLES_OF_TRANSLATORS" -msgstr "" +#~ msgid "" +#~ "<literal>column_name</literal> (required): The name of the column holding " +#~ "the collection index values." +#~ msgstr "" +#~ "<literal>column_name</literal>（必須）:コレクションインデックスの値を保持" +#~ "するカラムの名前。" -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "" +#~ msgid "" +#~ "<literal>base</literal> (optional, defaults to <literal>0</literal>): The " +#~ "value of the index column that corresponds to the first element of the " +#~ "list or array." +#~ msgstr "" +#~ "<literal>base</literal>（オプション、デフォルトは <literal>0</literal>）: " +#~ "リストもしくは配列の最初の要素に該当するインデックスカラムの値。" +#~ msgid "" +#~ "<literal>column</literal> (optional): The name of the column holding the " +#~ "collection index values." +#~ msgstr "" +#~ "<literal>column</literal>（オプション）: コレクションインデックスの値を保" +#~ "持するカラムの名前。" + +#~ msgid "" +#~ "<literal>formula</literal> (optional): A SQL formula used to evaluate the " +#~ "key of the map." +#~ msgstr "" +#~ "<literal>formula</literal>（オプション）: Mapのキーを評価するのに使われる" +#~ "SQL式。" + +#~ msgid "<literal>type</literal> (reguired): The type of the map keys." +#~ msgstr "<literal>type</literal>（必須）: Mapのキーの型。" + +#~ msgid "" +#~ "<literal>column</literal> (optional): The name of the foreign key column " +#~ "for the collection index values." +#~ msgstr "" +#~ "<literal>column</literal> （オプション）: コレクションインデックスの値のた" +#~ "めの外部キーカラムの名前。" + +#~ msgid "" +#~ "<literal>formula</literal> (optional): A SQL formula used to evaluate the " +#~ "foreign key of the map key." +#~ msgstr "" +#~ "<literal>formula</literal> （オプション）: Mapのキーのための外部キーを評価" +#~ "するために使うSQL式。" + +#~ msgid "" +#~ "<literal>class</literal> (required): The entity class used as the map key." +#~ msgstr "" +#~ "<literal>class</literal> （必須）: Mapのキーとして使われるエンティティクラ" +#~ "ス。" + +#~ msgid "" +#~ "<literal>column</literal> (optional): The name of the column holding the " +#~ "collection element values." +#~ msgstr "" +#~ "<literal>column</literal> （オプション）: コレクションの要素の値を保持する" +#~ "カラムの名前。" + +#~ msgid "" +#~ "<literal>formula</literal> (optional): An SQL formula used to evaluate " +#~ "the element." +#~ msgstr "" +#~ "<literal>formula</literal> （オプション）: 要素を評価するために使うSQL式。" + +#~ msgid "" +#~ "<literal>type</literal> (required): The type of the collection element." +#~ msgstr "<literal>type</literal> （必須）コレクションの要素の型。" + +#~ msgid "" +#~ "A <emphasis>many-to-many association</emphasis> is specified using the " +#~ "<literal><many-to-many></literal> element." +#~ msgstr "" +#~ "<emphasis>多対多関連</emphasis> は <literal><many-to-many></" +#~ "literal> 要素で指定します。" + +#~ msgid "" +#~ "<literal>column</literal> (optional): The name of the element foreign key " +#~ "column." +#~ msgstr "" +#~ "<literal>column</literal> （オプション）: 外部キーカラムの要素の名前。" + +#~ msgid "" +#~ "<literal>formula</literal> (optional): An SQL formula used to evaluate " +#~ "the element foreign key value." +#~ msgstr "" +#~ "<literal>formula</literal> （オプション）: 外部キー値の要素を評価するため" +#~ "に使うSQL式。" + +#~ msgid "" +#~ "<literal>fetch</literal> (optional - defaults to <literal>join</" +#~ "literal>): enables outer-join or sequential select fetching for this " +#~ "association. This is a special case; for full eager fetching (in a single " +#~ "<literal>SELECT</literal>) of an entity and its many-to-many " +#~ "relationships to other entities, you would enable <literal>join</literal> " +#~ "fetching not only of the collection itself, but also with this attribute " +#~ "on the <literal><many-to-many></literal> nested element." +#~ msgstr "" +#~ "<literal>fetch</literal> (オプション - デフォルトは <literal>join</" +#~ "literal>): 関連のために、外部結合か順次選択フェッチを有効にします。これは" +#~ "特殊なケースですが、エンティティと他のエンティティとの多対多関係を（１つ" +#~ "の <literal>SELECT</literal> により）完全に即時にフェッチするためには、そ" +#~ "のコレクション自体だけでなく、ネストした要素である <literal><many-to-" +#~ "many></literal> のこの属性についても <literal>join</literal> フェッチを" +#~ "有効する必要があります。" + +#~ msgid "" +#~ "<literal>unique</literal> (optional): Enable the DDL generation of a " +#~ "unique constraint for the foreign-key column. This makes the association " +#~ "multiplicity effectively one to many." +#~ msgstr "" +#~ "<literal>unique</literal> （オプション）: 外部キーカラムのユニーク制約の" +#~ "DDL生成を有効にします。これは、関連の多重度を事実上一対多にします。" + +#~ msgid "" +#~ "<literal>not-found</literal> (optional - defaults to <literal>exception</" +#~ "literal>): Specifies how foreign keys that reference missing rows will be " +#~ "handled: <literal>ignore</literal> will treat a missing row as a null " +#~ "association." +#~ msgstr "" +#~ "<literal>not-found</literal> （オプション - デフォルトは " +#~ "<literal>exception</literal>）参照先の行がない外部キーをどのように扱うか" +#~ "を指定します。 <literal>ignore</literal> にすると、行がないことを関連が無" +#~ "いものとして扱います。" + +#~ msgid "" +#~ "<literal>property-ref</literal>: (optional) The name of a property of the " +#~ "associated class that is joined to this foreign key. If not specified, " +#~ "the primary key of the associated class is used." +#~ msgstr "" +#~ "<literal>property-ref</literal>: （オプション）この外部キーに結合する関連" +#~ "クラスのプロパティ名。指定しなかった場合は、関連クラスの主キーを使いま" +#~ "す。" Modified: core/trunk/documentation/manual/translations/ja-JP/content/component_mapping.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/component_mapping.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/component_mapping.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,679 +1,676 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: component_mapping.xml:5 +#, no-c-format msgid "Component Mapping" msgstr "コンポーネントのマッピング" -#: index.docbook:7 -msgid "The notion of a <emphasis>component</emphasis> is re-used in several different contexts, for different purposes, throughout Hibernate." -msgstr "<emphasis>コンポーネント</emphasis> の概念は、Hibernateを通して様々な状況の中で異なる目的のために再利用されます。" +#. Tag: para +#: component_mapping.xml:7 +#, no-c-format +msgid "" +"The notion of a <emphasis>component</emphasis> is re-used in several " +"different contexts, for different purposes, throughout Hibernate." +msgstr "" +"<emphasis>コンポーネント</emphasis> の概念は、Hibernateを通して様々な状況の中" +"で異なる目的のために再利用されます。" -#: index.docbook:13 +#. Tag: title +#: component_mapping.xml:13 +#, no-c-format msgid "Dependent objects" msgstr "依存オブジェクト" -#: index.docbook:15 -msgid "A component is a contained object that is persisted as a value type, not an entity reference. The term \"component\" refers to the object-oriented notion of composition (not to architecture-level components). For example, you might model a person like this:" -msgstr "コンポーネントは、エンティティの参照ではなく値型として永続化された、包含されたオブジェクトです。コンポーネントという言葉については、コンポジションというオブジェクト指向の概念を参照してください（アーキテクチャレベルのコンポーネントではありません）。例えば、以下のPersonモデルのようなものです。" +#. Tag: para +#: component_mapping.xml:15 +#, no-c-format +msgid "" +"A component is a contained object that is persisted as a value type, not an " +"entity reference. The term \"component\" refers to the object-oriented " +"notion of composition (not to architecture-level components). For example, " +"you might model a person like this:" +msgstr "" +"コンポーネントは、エンティティの参照ではなく値型として永続化された、包含され" +"たオブジェクトです。コンポーネントという言葉については、コンポジションという " +"オブジェクト指向の概念を参照してください（アーキテクチャレベルのコンポーネン" +"トではありません）。例えば、以下のPersonモデルのようなものです。" -#: index.docbook:21 +#. Tag: programlisting +#: component_mapping.xml:21 +#, no-c-format msgid "" - "<![CDATA[public class Person {\n" - " private java.util.Date birthday;\n" - " private Name name;\n" - " private String key;\n" - " public String getKey() {\n" - " return key;\n" - " }\n" - " private void setKey(String key) {\n" - " this.key=key;\n" - " }\n" - " public java.util.Date getBirthday() {\n" - " return birthday;\n" - " }\n" - " public void setBirthday(java.util.Date birthday) {\n" - " this.birthday = birthday;\n" - " }\n" - " public Name getName() {\n" - " return name;\n" - " }\n" - " public void setName(Name name) {\n" - " this.name = name;\n" - " }\n" - " ......\n" - " ......\n" - "}]]>" +"<![CDATA[public class Person {\n" +" private java.util.Date birthday;\n" +" private Name name;\n" +" private String key;\n" +" public String getKey() {\n" +" return key;\n" +" }\n" +" private void setKey(String key) {\n" +" this.key=key;\n" +" }\n" +" public java.util.Date getBirthday() {\n" +" return birthday;\n" +" }\n" +" public void setBirthday(java.util.Date birthday) {\n" +" this.birthday = birthday;\n" +" }\n" +" public Name getName() {\n" +" return name;\n" +" }\n" +" public void setName(Name name) {\n" +" this.name = name;\n" +" }\n" +" ......\n" +" ......\n" +"}]]>" msgstr "" - "<![CDATA[public class Person { -\n" - " private java.util.Date birthday; -\n" - " private Name name; -\n" - " private String key; -\n" - " public String getKey() { -\n" - " return key; -\n" - " } -\n" - " private void setKey(String key) { -\n" - " this.key=key; -\n" - " } -\n" - " public java.util.Date getBirthday() { -\n" - " return birthday; -\n" - " } -\n" - " public void setBirthday(java.util.Date birthday) { -\n" - " this.birthday = birthday; -\n" - " } -\n" - " public Name getName() { -\n" - " return name; -\n" - " } -\n" - " public void setName(Name name) { -\n" - " this.name = name; -\n" - " } -\n" - " ...... -\n" - " ...... -\n" - "}]]>" -#: index.docbook:23 +#. Tag: programlisting +#: component_mapping.xml:23 +#, no-c-format msgid "" - "<![CDATA[public class Name {\n" - " char initial;\n" - " String first;\n" - " String last;\n" - " public String getFirst() {\n" - " return first;\n" - " }\n" - " void setFirst(String first) {\n" - " this.first = first;\n" - " }\n" - " public String getLast() {\n" - " return last;\n" - " }\n" - " void setLast(String last) {\n" - " this.last = last;\n" - " }\n" - " public char getInitial() {\n" - " return initial;\n" - " }\n" - " void setInitial(char initial) {\n" - " this.initial = initial;\n" - " }\n" - "}]]>" +"<![CDATA[public class Name {\n" +" char initial;\n" +" String first;\n" +" String last;\n" +" public String getFirst() {\n" +" return first;\n" +" }\n" +" void setFirst(String first) {\n" +" this.first = first;\n" +" }\n" +" public String getLast() {\n" +" return last;\n" +" }\n" +" void setLast(String last) {\n" +" this.last = last;\n" +" }\n" +" public char getInitial() {\n" +" return initial;\n" +" }\n" +" void setInitial(char initial) {\n" +" this.initial = initial;\n" +" }\n" +"}]]>" msgstr "" - "<![CDATA[public class Name { -\n" - " char initial; -\n" - " String first; -\n" - " String last; -\n" - " public String getFirst() { -\n" - " return first; -\n" - " } -\n" - " void setFirst(String first) { -\n" - " this.first = first; -\n" - " } -\n" - " public String getLast() { -\n" - " return last; -\n" - " } -\n" - " void setLast(String last) { -\n" - " this.last = last; -\n" - " } -\n" - " public char getInitial() { -\n" - " return initial; -\n" - " } -\n" - " void setInitial(char initial) { -\n" - " this.initial = initial; -\n" - " } -\n" - "}]]>" -#: index.docbook:25 -msgid "Now <literal>Name</literal> may be persisted as a component of <literal>Person</literal>. Notice that <literal>Name</literal> defines getter and setter methods for its persistent properties, but doesn't need to declare any interfaces or identifier properties." -msgstr "いま、<literal>Name</literal> は <literal>Person</literal> のコンポーネントとして永続化することが出来ます。ここで <literal>Name</literal> は永続化属性に対してgetter、 setterメソッドを定義しますが、インターフェイスや識別子プロパティを定義する必要がないことに注意して下さい。" +#. Tag: para +#: component_mapping.xml:25 +#, no-c-format +msgid "" +"Now <literal>Name</literal> may be persisted as a component of " +"<literal>Person</literal>. Notice that <literal>Name</literal> defines " +"getter and setter methods for its persistent properties, but doesn't need to " +"declare any interfaces or identifier properties." +msgstr "" +"いま、<literal>Name</literal> は <literal>Person</literal> のコンポーネントと" +"して永続化することが出来ます。ここで <literal>Name</literal> は永続化属性に" +"対してgetter、 setterメソッドを定義しますが、インターフェイスや識別子プロパ" +"ティを定義する必要がないことに注意して下さい。" -#: index.docbook:32 +#. Tag: para +#: component_mapping.xml:32 +#, no-c-format msgid "Our Hibernate mapping would look like:" msgstr "マッピング定義は以下のようになります。" -#: index.docbook:36 +#. Tag: programlisting +#: component_mapping.xml:36 +#, no-c-format msgid "" - "<![CDATA[<class name=\"eg.Person\" table=\"person\">\n" - " <id name=\"Key\" column=\"pid\" type=\"string\">\n" - " <generator class=\"uuid\"/>\n" - " </id>\n" - " <property name=\"birthday\" type=\"date\"/>\n" - " <component name=\"Name\" class=\"eg.Name\"> \n" - " <property name=\"initial\"/>\n" - " <property name=\"first\"/>\n" - " <property name=\"last\"/>\n" - " </component>\n" - "</class>]]>" +"<![CDATA[<class name=\"eg.Person\" table=\"person\">\n" +" <id name=\"Key\" column=\"pid\" type=\"string\">\n" +" <generator class=\"uuid\"/>\n" +" </id>\n" +" <property name=\"birthday\" type=\"date\"/>\n" +" <component name=\"Name\" class=\"eg.Name\"> \n" +" <property name=\"initial\"/>\n" +" <property name=\"first\"/>\n" +" <property name=\"last\"/>\n" +" </component>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"eg.Person\" table=\"person\"> -\n" - " <id name=\"Key\" column=\"pid\" type=\"string\"> -\n" - " <generator class=\"uuid\"/> -\n" - " </id> -\n" - " <property name=\"birthday\" type=\"date\"/> -\n" - " <component name=\"Name\" class=\"eg.Name\">  -\n" - " <property name=\"initial\"/> -\n" - " <property name=\"first\"/> -\n" - " <property name=\"last\"/> -\n" - " </component> -\n" - "</class>]]>" -#: index.docbook:38 -msgid "The person table would have the columns <literal>pid</literal>, <literal>birthday</literal>, <literal>initial</literal>, <literal>first</literal> and <literal>last</literal>." -msgstr "Personテーブルは <literal>pid</literal>、 <literal>birthday</literal>、 <literal>initial</literal>、 <literal>first</literal>、 <literal>last</literal> カラムを持ちます。" +#. Tag: para +#: component_mapping.xml:38 +#, no-c-format +msgid "" +"The person table would have the columns <literal>pid</literal>, " +"<literal>birthday</literal>, <literal>initial</literal>, <literal>first</" +"literal> and <literal>last</literal>." +msgstr "" +"Personテーブルは <literal>pid</literal>、 <literal>birthday</literal>、 " +"<literal>initial</literal>、 <literal>first</literal>、 <literal>last</" +"literal> カラムを持ちます。" -#: index.docbook:46 -msgid "Like all value types, components do not support shared references. In other words, two persons could have the same name, but the two person objects would contain two independent name ojects, only \"the same\" by value. The null value semantics of a component are <emphasis>ad hoc</emphasis>. When reloading the containing object, Hibernate will assume that if all component columns are null, then the entire component is null. This should be okay for most purposes." -msgstr "全ての値型のように、コンポーネントは参照の共有をすることができません。言い換えると、二人のPersonは同じ名前を持つことができますが、二つのPersonオブジェクトは \"値が同じだけ\"の別々のnameオブジェクトを含んでいるということです。コンポーネントのnull値のセマンティクスは <emphasis>アドホック</emphasis> です。コンポーネントのオブジェクトを再読み込みする際、Hibernateはコンポーネントのすべてのカラムが nullであるならコンポーネント自体がnullであると考えます。これは大抵の場合問題ありません。" +#. Tag: para +#: component_mapping.xml:46 +#, no-c-format +msgid "" +"Like all value types, components do not support shared references. In other " +"words, two persons could have the same name, but the two person objects " +"would contain two independent name ojects, only \"the same\" by value. The " +"null value semantics of a component are <emphasis>ad hoc</emphasis>. When " +"reloading the containing object, Hibernate will assume that if all component " +"columns are null, then the entire component is null. This should be okay for " +"most purposes." +msgstr "" +"全ての値型のように、コンポーネントは参照の共有をすることができません。言い換" +"えると、二人のPersonは同じ名前を持つことができますが、二つのPersonオブジェク" +"トは \"値が同じだけ\"の別々のnameオブジェクトを含んでいるということです。コ" +"ンポーネントのnull値のセマンティクスは <emphasis>アドホック</emphasis> で" +"す。コンポーネントのオブジェクトを再読み込みする際、Hibernateはコンポーネン" +"トのすべてのカラムが nullであるならコンポーネント自体がnullであると考えま" +"す。これは大抵の場合問題ありません。" -#: index.docbook:55 -msgid "The properties of a component may be of any Hibernate type (collections, many-to-one associations, other components, etc). Nested components should <emphasis>not</emphasis> be considered an exotic usage. Hibernate is intended to support a very fine-grained object model." -msgstr "コンポーネントの属性はどんなHibernateの型でも構いません（コレクション、many-to-one関連、他のコンポーネントなど）。ネストされたコンポーネントは滅多に使わないと考えるべきでは <emphasis>ありません</emphasis> 。Hibernateは非常にきめの細かいオブジェクトモデルをサポートするように意図されています。" +#. Tag: para +#: component_mapping.xml:55 +#, no-c-format +msgid "" +"The properties of a component may be of any Hibernate type (collections, " +"many-to-one associations, other components, etc). Nested components should " +"<emphasis>not</emphasis> be considered an exotic usage. Hibernate is " +"intended to support a very fine-grained object model." +msgstr "" +"コンポーネントの属性はどんなHibernateの型でも構いません（コレクション、many-" +"to-one関連、他のコンポーネントなど）。ネストされたコンポーネントは滅多に使わ" +"ないと考えるべきでは <emphasis>ありません</emphasis> 。Hibernateは非常にきめ" +"の細かいオブジェクトモデルをサポートするように意図されています。" -#: index.docbook:62 -msgid "The <literal><component></literal> element allows a <literal><parent></literal> subelement that maps a property of the component class as a reference back to the containing entity." -msgstr "<literal><component></literal> 要素は親エンティティへの逆参照として、コンポーネントクラスの属性をマッピングする <literal><parent></literal> サブ要素を使用できます。" +#. Tag: para +#: component_mapping.xml:62 +#, no-c-format +msgid "" +"The <literal><component></literal> element allows a <literal><" +"parent></literal> subelement that maps a property of the component class " +"as a reference back to the containing entity." +msgstr "" +"<literal><component></literal> 要素は親エンティティへの逆参照として、コ" +"ンポーネントクラスの属性をマッピングする <literal><parent></literal> " +"サブ要素を使用できます。" -#: index.docbook:68 +#. Tag: programlisting +#: component_mapping.xml:68 +#, no-c-format msgid "" - "<![CDATA[<class name=\"eg.Person\" table=\"person\">\n" - " <id name=\"Key\" column=\"pid\" type=\"string\">\n" - " <generator class=\"uuid\"/>\n" - " </id>\n" - " <property name=\"birthday\" type=\"date\"/>\n" - " <component name=\"Name\" class=\"eg.Name\" unique=\"true\">\n" - " <parent name=\"namedPerson\"/> \n" - " <property name=\"initial\"/>\n" - " <property name=\"first\"/>\n" - " <property name=\"last\"/>\n" - " </component>\n" - "</class>]]>" +"<![CDATA[<class name=\"eg.Person\" table=\"person\">\n" +" <id name=\"Key\" column=\"pid\" type=\"string\">\n" +" <generator class=\"uuid\"/>\n" +" </id>\n" +" <property name=\"birthday\" type=\"date\"/>\n" +" <component name=\"Name\" class=\"eg.Name\" unique=\"true\">\n" +" <parent name=\"namedPerson\"/>  -\n" - " <property name=\"initial\"/> -\n" - " <property name=\"first\"/> -\n" - " <property name=\"last\"/> -\n" - " </component> -\n" - "</class>]]>" -#: index.docbook:73 +#. Tag: title +#: component_mapping.xml:73 +#, no-c-format msgid "Collections of dependent objects" msgstr "従属するオブジェクトのコレクション" -#: index.docbook:75 -msgid "Collections of components are supported (eg. an array of type <literal>Name</literal>). Declare your component collection by replacing the <literal><element></literal> tag with a <literal><composite-element></literal> tag." -msgstr "Hibernateはコンポーネントのコレクションをサポートしています（例えば <literal>Name</literal> 型の配列）。 <literal><element></literal> タグを <literal><composite-element></literal> タグに取り替えることによりコンポーネントコレクションを宣言してください。" +#. Tag: para +#: component_mapping.xml:75 +#, no-c-format +msgid "" +"Collections of components are supported (eg. an array of type <literal>Name</" +"literal>). Declare your component collection by replacing the <literal><" +"element></literal> tag with a <literal><composite-element></" +"literal> tag." +msgstr "" +"Hibernateはコンポーネントのコレクションをサポートしています（例えば " +"<literal>Name</literal> 型の配列）。 <literal><element></literal> タグ" +"を <literal><composite-element></literal> タグに取り替えることによりコ" +"ンポーネントコレクションを宣言してください。" -#: index.docbook:82 +#. Tag: programlisting +#: component_mapping.xml:82 +#, no-c-format msgid "" - "<![CDATA[<set name=\"someNames\" table=\"some_names\" lazy=\"true\">\n" - " <key column=\"id\"/>\n" - " <composite-element class=\"eg.Name\"> \n" - " <property name=\"initial\"/>\n" - " <property name=\"first\"/>\n" - " <property name=\"last\"/>\n" - " </composite-element>\n" - "</set>]]>" +"<![CDATA[<set name=\"someNames\" table=\"some_names\" lazy=\"true\">\n" +" <key column=\"id\"/>\n" +" <composite-element class=\"eg.Name\"> \n" +" <property name=\"initial\"/>\n" +" <property name=\"first\"/>\n" +" <property name=\"last\"/>\n" +" </composite-element>\n" +"</set>]]>" msgstr "" - "<![CDATA[<set name=\"someNames\" table=\"some_names\" lazy=\"true\"> -\n" - " <key column=\"id\"/> -\n" - " <composite-element class=\"eg.Name\">  -\n" - " <property name=\"initial\"/> -\n" - " <property name=\"first\"/> -\n" - " <property name=\"last\"/> -\n" - " </composite-element> -\n" - "</set>]]>" -#: index.docbook:84 -msgid "Note: if you define a <literal>Set</literal> of composite elements, it is very important to implement <literal>equals()</literal> and <literal>hashCode()</literal> correctly." -msgstr "注意: コンポジットエレメントの <literal>Set</literal> を定義したなら、 <literal>equals()</literal> と <literal>hashCode()</literal> を正しく実装することが重要です。" +#. Tag: para +#: component_mapping.xml:84 +#, no-c-format +msgid "" +"Note: if you define a <literal>Set</literal> of composite elements, it is " +"very important to implement <literal>equals()</literal> and <literal>hashCode" +"()</literal> correctly." +msgstr "" +"注意: コンポジットエレメントの <literal>Set</literal> を定義したなら、 " +"<literal>equals()</literal> と <literal>hashCode()</literal> を正しく実装する" +"ことが重要です。" -#: index.docbook:90 -msgid "Composite elements may contain components but not collections. If your composite element itself contains components, use the <literal><nested-composite-element></literal> tag. This is a pretty exotic case - a collection of components which themselves have components. By this stage you should be asking yourself if a one-to-many association is more appropriate. Try remodelling the composite element as an entity - but note that even though the Java model is the same, the relational model and persistence semantics are still slightly different." -msgstr "コンポジットエレメントはコレクションを含まず、コンポーネントを含むこともあります。コンポジットエレメント自身がコンポーネントを含んでいる場合は <literal><nested-composite-element></literal> を使用してください。コンポーネントのコレクション自身がコンポーネントを持つというケースはめったにありません。この段階までに、one-to-many関連の方がより適切でないかと熟考してください。コンポジットエレメントをエンティティとして再度モデリングしてみてください。しかしこれはJavaのモデルとしては同じですが、リレーショナルモデルと永続動作はまだ若干異なることに注意してください。" +#. Tag: para +#: component_mapping.xml:90 +#, no-c-format +msgid "" +"Composite elements may contain components but not collections. If your " +"composite element itself contains components, use the <literal><nested-" +"composite-element></literal> tag. This is a pretty exotic case - a " +"collection of components which themselves have components. By this stage you " +"should be asking yourself if a one-to-many association is more appropriate. " +"Try remodelling the composite element as an entity - but note that even " +"though the Java model is the same, the relational model and persistence " +"semantics are still slightly different." +msgstr "" +"コンポジットエレメントはコレクションを含まず、コンポーネントを含むこともあり" +"ます。コンポジットエレメント自身がコンポーネントを含んでいる場合は " +"<literal><nested-composite-element></literal> を使用してください。コン" +"ポーネントのコレクション自身がコンポーネントを持つというケースはめったにあり" +"ません。この段階までに、one-to-many関連の方がより適切でないかと熟考してくだ" +"さい。コンポジットエレメントをエンティティとして再度モデリングしてみてくださ" +"い。しかしこれはJavaのモデルとしては同じですが、リレーショナルモデルと永続動" +"作はまだ若干異なることに注意してください。" -#: index.docbook:102 -msgid "Please note that a composite element mapping doesn't support null-able properties if you're using a <literal><set></literal>. Hibernate has to use each columns value to identify a record when deleting objects (there is no separate primary key column in the composite element table), which is not possible with null values. You have to either use only not-null properties in a composite-element or choose a <literal><list></literal>, <literal><map></literal>, <literal><bag></literal> or <literal><idbag></literal>." -msgstr "もし <literal><set></literal> を使用するのであれば、コンポジットエレメントのマッピングがnull値が可能な属性をサポートしていないことに注意してください。Hibernateはオブジェクトを削除するとき、レコードを識別するためにそれぞれのカラムの値を使用する必要があるため、null値を持つことが出来ません（コンポジットエレメントテーブルには別の主キーカラムはありません）。コンポジットエレメントにnot-nullの属性のみを使用するか、または <literal><list></literal>、<literal><map></literal>、 <literal><bag></literal>、<literal><idbag></literal> を選択する必要があります。" +#. Tag: para +#: component_mapping.xml:102 +#, no-c-format +msgid "" +"Please note that a composite element mapping doesn't support null-able " +"properties if you're using a <literal><set></literal>. Hibernate has " +"to use each columns value to identify a record when deleting objects (there " +"is no separate primary key column in the composite element table), which is " +"not possible with null values. You have to either use only not-null " +"properties in a composite-element or choose a <literal><list></" +"literal>, <literal><map></literal>, <literal><bag></literal> or " +"<literal><idbag></literal>." +msgstr "" +"もし <literal><set></literal> を使用するのであれば、コンポジットエレメ" +"ントのマッピングがnull値が可能な属性をサポートしていないことに注意してくださ" +"い。Hibernateはオブジェクトを削除するとき、レコードを識別するためにそれぞれ" +"のカラムの値を使用する必要があるため、null値を持つことが出来ません（コンポ" +"ジットエレメントテーブルには別の主キーカラムはありません）。コンポジットエレ" +"メントにnot-nullの属性のみを使用するか、または <literal><list></" +"literal>、<literal><map></literal>、 <literal><bag></literal>、" +"<literal><idbag></literal> を選択する必要があります。" -#: index.docbook:113 -msgid "A special case of a composite element is a composite element with a nested <literal><many-to-one></literal> element. A mapping like this allows you to map extra columns of a many-to-many association table to the composite element class. The following is a many-to-many association from <literal>Order</literal> to <literal>Item</literal> where <literal>purchaseDate</literal>, <literal>price</literal> and <literal>quantity</literal> are properties of the association:" -msgstr "コンポジットエレメントの特別なケースとして、ネストされた <literal><many-to-one></literal> 属性を持つコンポジットエレメントがあります。このマッピングは、コンポジットエレメントクラスを多対多関連テーブルの余分なカラムへマッピングします。次の例は <literal>Order</literal> から、<literal>Item</literal> への多対多関連です。 <literal>purchaseDate</literal>、<literal>price</literal>、<literal>quantity</literal> は関連の属性となります。" +#. Tag: para +#: component_mapping.xml:113 +#, no-c-format +msgid "" +"A special case of a composite element is a composite element with a nested " +"<literal><many-to-one></literal> element. A mapping like this allows " +"you to map extra columns of a many-to-many association table to the " +"composite element class. The following is a many-to-many association from " +"<literal>Order</literal> to <literal>Item</literal> where " +"<literal>purchaseDate</literal>, <literal>price</literal> and " +"<literal>quantity</literal> are properties of the association:" +msgstr "" +"コンポジットエレメントの特別なケースとして、ネストされた <literal><many-" +"to-one></literal> 属性を持つコンポジットエレメントがあります。このマッピ" +"ングは、コンポジットエレメントクラスを多対多関連テーブルの余分なカラムへマッ" +"ピングします。次の例は <literal>Order</literal> から、<literal>Item</" +"literal> への多対多関連です。 <literal>purchaseDate</literal>、" +"<literal>price</literal>、<literal>quantity</literal> は関連の属性となりま" +"す。" -#: index.docbook:123 +#. Tag: programlisting +#: component_mapping.xml:123 +#, no-c-format msgid "" - "<![CDATA[<class name=\"eg.Order\" .... >\n" - " ....\n" - " <set name=\"purchasedItems\" table=\"purchase_items\" lazy=\"true\">\n" - " <key column=\"order_id\">\n" - " <composite-element class=\"eg.Purchase\">\n" - " <property name=\"purchaseDate\"/>\n" - " <property name=\"price\"/>\n" - " <property name=\"quantity\"/>\n" - " <many-to-one name=\"item\" class=\"eg.Item\"/> \n" - " </composite-element>\n" - " </set>\n" - "</class>]]>" +"<![CDATA[<class name=\"eg.Order\" .... >\n" +" ....\n" +" <set name=\"purchasedItems\" table=\"purchase_items\" lazy=\"true\">\n" +" <key column=\"order_id\">\n" +" <composite-element class=\"eg.Purchase\">\n" +" <property name=\"purchaseDate\"/>\n" +" <property name=\"price\"/>\n" +" <property name=\"quantity\"/>\n" +" <many-to-one name=\"item\" class=\"eg.Item\"/> \n" +" </composite-element>\n" +" </set>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"eg.Order\" .... > -\n" - " .... -\n" - " <set name=\"purchasedItems\" table=\"purchase_items\" lazy=\"true\"> -\n" - " <key column=\"order_id\"> -\n" - " <composite-element class=\"eg.Purchase\"> -\n" - " <property name=\"purchaseDate\"/> -\n" - " <property name=\"price\"/> -\n" - " <property name=\"quantity\"/> -\n" - " <many-to-one name=\"item\" class=\"eg.Item\"/>  -\n" - " </composite-element> -\n" - " </set> -\n" - "</class>]]>" -#: index.docbook:125 -msgid "Of course, there can't be a reference to the purchae on the other side, for bidirectional association navigation. Remember that components are value types and don't allow shared references. A single <literal>Purchase</literal> can be in the set of an <literal>Order</literal>, but it can't be referenced by the <literal>Item</literal> at the same time." -msgstr "もちろん、双方向関連のナビゲーションのために反対側からpurchaseへの参照を作ることは出来ません。コンポーネントは値型であり、参照を共有できないことを覚えておいてください。一つの <literal>Purchase</literal> は一つの <literal>Order</literal> のsetに存在できますが、同時に <literal>Item</literal> から参照することは出来ません。" +#. Tag: para +#: component_mapping.xml:125 +#, no-c-format +msgid "" +"Of course, there can't be a reference to the purchae on the other side, for " +"bidirectional association navigation. Remember that components are value " +"types and don't allow shared references. A single <literal>Purchase</" +"literal> can be in the set of an <literal>Order</literal>, but it can't be " +"referenced by the <literal>Item</literal> at the same time." +msgstr "" +"もちろん、双方向関連のナビゲーションのために反対側からpurchaseへの参照を作る" +"ことは出来ません。コンポーネントは値型であり、参照を共有できないことを覚えて" +"おいてください。一つの <literal>Purchase</literal> は一つの <literal>Order</" +"literal> のsetに存在できますが、同時に <literal>Item</literal> から参照する" +"ことは出来ません。" -#: index.docbook:133 +#. Tag: para +#: component_mapping.xml:133 +#, no-c-format msgid "Even ternary (or quaternary, etc) associations are possible:" msgstr "3項関連（あるいは4項など）も可能です。" -#: index.docbook:135 +#. Tag: programlisting +#: component_mapping.xml:135 +#, no-c-format msgid "" - "<![CDATA[<class name=\"eg.Order\" .... >\n" - " ....\n" - " <set name=\"purchasedItems\" table=\"purchase_items\" lazy=\"true\">\n" - " <key column=\"order_id\">\n" - " <composite-element class=\"eg.OrderLine\">\n" - " <many-to-one name=\"purchaseDetails class=\"eg.Purchase\"/>\n" - " <many-to-one name=\"item\" class=\"eg.Item\"/>\n" - " </composite-element>\n" - " </set>\n" - "</class>]]>" +"<![CDATA[<class name=\"eg.Order\" .... >\n" +" ....\n" +" <set name=\"purchasedItems\" table=\"purchase_items\" lazy=\"true\">\n" +" <key column=\"order_id\">\n" +" <composite-element class=\"eg.OrderLine\">\n" +" <many-to-one name=\"purchaseDetails class=\"eg.Purchase\"/>\n" +" <many-to-one name=\"item\" class=\"eg.Item\"/>\n" +" </composite-element>\n" +" </set>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"eg.Order\" .... > -\n" - " .... -\n" - " <set name=\"purchasedItems\" table=\"purchase_items\" lazy=\"true\"> -\n" - " <key column=\"order_id\"> -\n" - " <composite-element class=\"eg.OrderLine\"> -\n" - " <many-to-one name=\"purchaseDetails\" class=\"eg.Purchase\"/> -\n" - " <many-to-one name=\"item\" class=\"eg.Item\"/> -\n" - " </composite-element> -\n" - " </set> -\n" - "</class>]]>" -#: index.docbook:137 -msgid "Composite elements may appear in queries using the same syntax as associations to other entities." -msgstr "コンポジットエレメントは他のエンティティへの関連として、同じシンタックスを使っているクエリ内で使用できます。" +#. Tag: para +#: component_mapping.xml:137 +#, no-c-format +msgid "" +"Composite elements may appear in queries using the same syntax as " +"associations to other entities." +msgstr "" +"コンポジットエレメントは他のエンティティへの関連として、同じシンタックスを" +"使っているクエリ内で使用できます。" -#: index.docbook:145 +#. Tag: title +#: component_mapping.xml:145 +#, no-c-format msgid "Components as Map indices" msgstr "Mapのインデックスとしてのコンポーネント" -#: index.docbook:147 -msgid "The <literal><composite-map-key></literal> element lets you map a component class as the key of a <literal>Map</literal>. Make sure you override <literal>hashCode()</literal> and <literal>equals()</literal> correctly on the component class." -msgstr "<literal><composite-map-key></literal> 要素は <literal>Map</literal> のキーとしてコンポーネントクラスをマッピングします。コンポーネントクラス上で <literal>hashCode()</literal> と <literal>equals()</literal> を正確にオーバーライドしてください。" +#. Tag: para +#: component_mapping.xml:147 +#, no-c-format +msgid "" +"The <literal><composite-map-key></literal> element lets you map a " +"component class as the key of a <literal>Map</literal>. Make sure you " +"override <literal>hashCode()</literal> and <literal>equals()</literal> " +"correctly on the component class." +msgstr "" +"<literal><composite-map-key></literal> 要素は <literal>Map</literal> の" +"キーとしてコンポーネントクラスをマッピングします。コンポーネントクラス上で " +"<literal>hashCode()</literal> と <literal>equals()</literal> を正確にオーバー" +"ライドしてください。" -#: index.docbook:156 +#. Tag: title +#: component_mapping.xml:156 +#, no-c-format msgid "Components as composite identifiers" msgstr "複合識別子としてのコンポーネント" -#: index.docbook:158 -msgid "You may use a component as an identifier of an entity class. Your component class must satisfy certain requirements:" -msgstr "コンポーネントをエンティティクラスの識別子として使うことができます。コンポーネントクラスは以下の条件を満たす必要があります。" +#. Tag: para +#: component_mapping.xml:158 +#, no-c-format +msgid "" +"You may use a component as an identifier of an entity class. Your component " +"class must satisfy certain requirements:" +msgstr "" +"コンポーネントをエンティティクラスの識別子として使うことができます。コンポー" +"ネントクラスは以下の条件を満たす必要があります。" -#: index.docbook:165 +#. Tag: para +#: component_mapping.xml:165 +#, no-c-format msgid "It must implement <literal>java.io.Serializable</literal>." msgstr "<literal>java.io.Serializable</literal> を実装しなければなりません。" -#: index.docbook:170 -msgid "It must re-implement <literal>equals()</literal> and <literal>hashCode()</literal>, consistently with the database's notion of composite key equality." -msgstr "データベース上の複合キーの等価性と矛盾のないように、<literal>equals()</literal> と <literal>hashCode()</literal> を再実装しなければなりません。" +#. Tag: para +#: component_mapping.xml:170 +#, no-c-format +msgid "" +"It must re-implement <literal>equals()</literal> and <literal>hashCode()</" +"literal>, consistently with the database's notion of composite key equality." +msgstr "" +"データベース上の複合キーの等価性と矛盾のないように、<literal>equals()</" +"literal> と <literal>hashCode()</literal> を再実装しなければなりません。" -#: index.docbook:179 -msgid "Note: in Hibernate3, the second requirement is not an absolutely hard requirement of Hibernate. But do it anyway." -msgstr "注意: Hibernate3において、2番目の条件は絶対的な条件ではありません。しかしとにかく条件を満たしてください。" +#. Tag: emphasis +#: component_mapping.xml:179 +#, no-c-format +msgid "" +"Note: in Hibernate3, the second requirement is not an absolutely hard " +"requirement of Hibernate. But do it anyway." +msgstr "" +"注意: Hibernate3において、2番目の条件は絶対的な条件ではありません。しかしと" +"にかく条件を満たしてください。" -#: index.docbook:183 -msgid "You can't use an <literal>IdentifierGenerator</literal> to generate composite keys. Instead the application must assign its own identifiers." -msgstr "複合キーを生成するために <literal>IdentifierGenerator</literal> を使用することはできません。代わりにアプリケーションが識別子を割り当てなくてはなりません。" +#. Tag: para +#: component_mapping.xml:183 +#, no-c-format +msgid "" +"You can't use an <literal>IdentifierGenerator</literal> to generate " +"composite keys. Instead the application must assign its own identifiers." +msgstr "" +"複合キーを生成するために <literal>IdentifierGenerator</literal> を使用するこ" +"とはできません。代わりにアプリケーションが識別子を割り当てなくてはなりませ" +"ん。" -#: index.docbook:188 -msgid "Use the <literal><composite-id></literal> tag (with nested <literal><key-property></literal> elements) in place of the usual <literal><id></literal> declaration. For example, the <literal>OrderLine</literal> class has a primary key that depends upon the (composite) primary key of <literal>Order</literal>." -msgstr "通常の <literal><id></literal> 宣言の代わりに <literal><composite-id></literal> タグを（ネストされた <literal><key-property></literal> 属性と共に）使います。以下の例では、<literal>OrderLine</literal> クラスは <literal>Order</literal> の（複合）主キーに依存した主キーを持っています。" +#. Tag: para +#: component_mapping.xml:188 +#, no-c-format +msgid "" +"Use the <literal><composite-id></literal> tag (with nested " +"<literal><key-property></literal> elements) in place of the usual " +"<literal><id></literal> declaration. For example, the " +"<literal>OrderLine</literal> class has a primary key that depends upon the " +"(composite) primary key of <literal>Order</literal>." +msgstr "" +"通常の <literal><id></literal> 宣言の代わりに <literal><composite-" +"id></literal> タグを（ネストされた <literal><key-property></" +"literal> 属性と共に）使います。以下の例では、<literal>OrderLine</literal> ク" +"ラスは <literal>Order</literal> の（複合）主キーに依存した主キーを持っていま" +"す。" -#: index.docbook:196 +#. Tag: programlisting +#: component_mapping.xml:196 +#, no-c-format msgid "" - "<![CDATA[<class name=\"OrderLine\">\n" - " \n" - " <composite-id name=\"id\" class=\"OrderLineId\">\n" - " <key-property name=\"lineId\"/>\n" - " <key-property name=\"orderId\"/>\n" - " <key-property name=\"customerId\"/>\n" - " </composite-id>\n" - " \n" - " <property name=\"name\"/>\n" - " \n" - " <many-to-one name=\"order\" class=\"Order\"\n" - " insert=\"false\" update=\"false\">\n" - " <column name=\"orderId\"/>\n" - " <column name=\"customerId\"/>\n" - " </many-to-one>\n" - " ....\n" - " \n" - "</class>]]>" +"<![CDATA[<class name=\"OrderLine\">\n" +" \n" +" <composite-id name=\"id\" class=\"OrderLineId\">\n" +" <key-property name=\"lineId\"/>\n" +" <key-property name=\"orderId\"/>\n" +" <key-property name=\"customerId\"/>\n" +" </composite-id>\n" +" \n" +" <property name=\"name\"/>\n" +" \n" +" <many-to-one name=\"order\" class=\"Order\"\n" +" insert=\"false\" update=\"false\">\n" +" <column name=\"orderId\"/>\n" +" <column name=\"customerId\"/>\n" +" </many-to-one>\n" +" ....\n" +" \n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"OrderLine\"> -\n" - " -\n" - " <composite-id name=\"id\" class=\"OrderLineId\"> -\n" - " <key-property name=\"lineId\"/> -\n" - " <key-property name=\"orderId\"/> -\n" - " <key-property name=\"customerId\"/> -\n" - " </composite-id> -\n" - " -\n" - " <property name=\"name\"/> -\n" - " -\n" - " <many-to-one name=\"order\" class=\"Order\" -\n" - " insert=\"false\" update=\"false\"> -\n" - " <column name=\"orderId\"/> -\n" - " <column name=\"customerId\"/> -\n" - " </many-to-one> -\n" - " .... -\n" - " -\n" - "</class>]]>" -#: index.docbook:198 -msgid "Now, any foreign keys referencing the <literal>OrderLine</literal> table are also composite. You must declare this in your mappings for other classes. An association to <literal>OrderLine</literal> would be mapped like this:" -msgstr "このとき、<literal>OrderLine</literal> テーブルへ関連する外部キーもまた複合です。他のクラスのマッピングでこれを宣言しなければなりません。 <literal>OrderLine</literal> への関連は次のようにマッピングされます。" +#. Tag: para +#: component_mapping.xml:198 +#, no-c-format +msgid "" +"Now, any foreign keys referencing the <literal>OrderLine</literal> table are " +"also composite. You must declare this in your mappings for other classes. An " +"association to <literal>OrderLine</literal> would be mapped like this:" +msgstr "" +"このとき、<literal>OrderLine</literal> テーブルへ関連する外部キーもまた複合で" +"す。他のクラスのマッピングでこれを宣言しなければなりません。 " +"<literal>OrderLine</literal> への関連は次のようにマッピングされます。" -#: index.docbook:204 +#. Tag: programlisting +#: component_mapping.xml:204 +#, no-c-format msgid "" - "<![CDATA[<many-to-one name=\"orderLine\" class=\"OrderLine\">\n" - "\n" - " <column name=\"lineId\"/>\n" - " <column name=\"orderId\"/>\n" - " <column name=\"customerId\"/>\n" - "</many-to-one>]]>" +"<![CDATA[<many-to-one name=\"orderLine\" class=\"OrderLine\">\n" +"\n" +" <column name=\"lineId\"/>\n" +" <column name=\"orderId\"/>\n" +" <column name=\"customerId\"/>\n" +"</many-to-one>]]>" msgstr "" - "<![CDATA[<many-to-one name=\"orderLine\" class=\"OrderLine\"> -\n" - " -\n" - " <column name=\"lineId\"/> -\n" - " <column name=\"orderId\"/> -\n" - " <column name=\"customerId\"/> -\n" - "</many-to-one>]]>" -#: index.docbook:206 -msgid "(Note that the <literal><column></literal> tag is an alternative to the <literal>column</literal> attribute everywhere.)" -msgstr "（<literal><column></literal> タグはどこであっても <literal>column</literal> 属性の代わりになります。）" +#. Tag: para +#: component_mapping.xml:206 +#, no-c-format +msgid "" +"(Note that the <literal><column></literal> tag is an alternative to " +"the <literal>column</literal> attribute everywhere.)" +msgstr "" +"（<literal><column></literal> タグはどこであっても <literal>column</" +"literal> 属性の代わりになります。）" -#: index.docbook:211 -msgid "A <literal>many-to-many</literal> association to <literal>OrderLine</literal> also uses the composite foreign key:" -msgstr "<literal>OrderLine</literal> への <literal>many-to-many</literal> 関連も複合外部キーを使います。" +#. Tag: para +#: component_mapping.xml:211 +#, no-c-format +msgid "" +"A <literal>many-to-many</literal> association to <literal>OrderLine</" +"literal> also uses the composite foreign key:" +msgstr "" +"<literal>OrderLine</literal> への <literal>many-to-many</literal> 関連も複合" +"外部キーを使います。" -#: index.docbook:216 +#. Tag: programlisting +#: component_mapping.xml:216 +#, no-c-format msgid "" - "<![CDATA[<set name=\"undeliveredOrderLines\">\n" - " <key column name=\"warehouseId\"/>\n" - " <many-to-many class=\"OrderLine\">\n" - " <column name=\"lineId\"/>\n" - " <column name=\"orderId\"/>\n" - " <column name=\"customerId\"/>\n" - " </many-to-many>\n" - "</set>]]>" +"<![CDATA[<set name=\"undeliveredOrderLines\">\n" +" <key column name=\"warehouseId\"/>\n" +" <many-to-many class=\"OrderLine\">\n" +" <column name=\"lineId\"/>\n" +" <column name=\"orderId\"/>\n" +" <column name=\"customerId\"/>\n" +" </many-to-many>\n" +"</set>]]>" msgstr "" - "<![CDATA[<set name=\"undeliveredOrderLines\"> -\n" - " <key column name=\"warehouseId\"/> -\n" - " <many-to-many class=\"OrderLine\"> -\n" - " <column name=\"lineId\"/> -\n" - " <column name=\"orderId\"/> -\n" - " <column name=\"customerId\"/> -\n" - " </many-to-many> -\n" - "</set>]]>" -#: index.docbook:218 -msgid "The collection of <literal>OrderLine</literal>s in <literal>Order</literal> would use:" -msgstr "<literal>Order</literal> にある <literal>OrderLine</literal> のコレクションは次のものを使用します。" +#. Tag: para +#: component_mapping.xml:218 +#, no-c-format +msgid "" +"The collection of <literal>OrderLine</literal>s in <literal>Order</literal> " +"would use:" +msgstr "" +"<literal>Order</literal> にある <literal>OrderLine</literal> のコレクション" +"は次のものを使用します。" -#: index.docbook:223 +#. Tag: programlisting +#: component_mapping.xml:223 +#, no-c-format msgid "" - "<![CDATA[<set name=\"orderLines\" inverse=\"true\">\n" - " <key>\n" - " <column name=\"orderId\"/>\n" - " <column name=\"customerId\"/>\n" - " </key>\n" - " <one-to-many class=\"OrderLine\"/>\n" - "</set>]]>" +"<![CDATA[<set name=\"orderLines\" inverse=\"true\">\n" +" <key>\n" +" <column name=\"orderId\"/>\n" +" <column name=\"customerId\"/>\n" +" </key>\n" +" <one-to-many class=\"OrderLine\"/>\n" +"</set>]]>" msgstr "" - "<![CDATA[<set name=\"orderLines\" inverse=\"true\"> -\n" - " <key> -\n" - " <column name=\"orderId\"/> -\n" - " <column name=\"customerId\"/> -\n" - " </key> -\n" - " <one-to-many class=\"OrderLine\"/> -\n" - "</set>]]>" -#: index.docbook:225 -msgid "(The <literal><one-to-many></literal> element, as usual, declares no columns.)" -msgstr "（<literal><one-to-many></literal> 属性は、例によってカラムを宣言しません）" +#. Tag: para +#: component_mapping.xml:225 +#, no-c-format +msgid "" +"(The <literal><one-to-many></literal> element, as usual, declares no " +"columns.)" +msgstr "" +"（<literal><one-to-many></literal> 属性は、例によってカラムを宣言しませ" +"ん）" -#: index.docbook:229 -msgid "If <literal>OrderLine</literal> itself owns a collection, it also has a composite foreign key." -msgstr "<literal>OrderLine</literal> 自身がコレクションを持っている場合、同時に複合外部キーも持っています。" +#. Tag: para +#: component_mapping.xml:229 +#, no-c-format +msgid "" +"If <literal>OrderLine</literal> itself owns a collection, it also has a " +"composite foreign key." +msgstr "" +"<literal>OrderLine</literal> 自身がコレクションを持っている場合、同時に複合" +"外部キーも持っています。" -#: index.docbook:234 +#. Tag: programlisting +#: component_mapping.xml:234 +#, no-c-format msgid "" - "<![CDATA[<class name=\"OrderLine\">\n" - " ....\n" - " ....\n" - " <list name=\"deliveryAttempts\">\n" - " <key> \n" - " <column name=\"lineId\"/>\n" - " <column name=\"orderId\"/>\n" - " <column name=\"customerId\"/>\n" - " </key>\n" - " <list-index column=\"attemptId\" base=\"1\"/>\n" - " <composite-element class=\"DeliveryAttempt\">\n" - " ...\n" - " </composite-element>\n" - " </set>\n" - "</class>]]>" +"<![CDATA[<class name=\"OrderLine\">\n" +" ....\n" +" ....\n" +" <list name=\"deliveryAttempts\">\n" +" <key> \n" +" <column name=\"lineId\"/>\n" +" <column name=\"orderId\"/>\n" +" <column name=\"customerId\"/>\n" +" </key>\n" +" <list-index column=\"attemptId\" base=\"1\"/>\n" +" <composite-element class=\"DeliveryAttempt\">\n" +" ...\n" +" </composite-element>\n" +" </set>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"OrderLine\"> -\n" - " .... -\n" - " .... -\n" - " <list name=\"deliveryAttempts\"> -\n" - " <key>  -\n" - " <column name=\"lineId\"/> -\n" - " <column name=\"orderId\"/> -\n" - " <column name=\"customerId\"/> -\n" - " </key> -\n" - " <list-index column=\"attemptId\" base=\"1\"/> -\n" - " <composite-element class=\"DeliveryAttempt\"> -\n" - " ... -\n" - " </composite-element> -\n" - " </set> -\n" - "</class>]]>" -#: index.docbook:239 +#. Tag: title +#: component_mapping.xml:239 +#, no-c-format msgid "Dynamic components" msgstr "動的コンポーネント" -#: index.docbook:241 +#. Tag: para +#: component_mapping.xml:241 +#, no-c-format msgid "You may even map a property of type <literal>Map</literal>:" msgstr "<literal>Map</literal> 型のプロパティのマッピングも可能です。" -#: index.docbook:245 +#. Tag: programlisting +#: component_mapping.xml:245 +#, no-c-format msgid "" - "<![CDATA[<dynamic-component name=\"userAttributes\">\n" - " <property name=\"foo\" column=\"FOO\" type=\"string\"/>\n" - " <property name=\"bar\" column=\"BAR\" type=\"integer\"/>\n" - " <many-to-one name=\"baz\" class=\"Baz\" column=\"BAZ_ID\"/>\n" - "</dynamic-component>]]>" +"<![CDATA[<dynamic-component name=\"userAttributes\">\n" +" <property name=\"foo\" column=\"FOO\" type=\"string\"/>\n" +" <property name=\"bar\" column=\"BAR\" type=\"integer\"/>\n" +" <many-to-one name=\"baz\" class=\"Baz\" column=\"BAZ_ID\"/>\n" +"</dynamic-component>]]>" msgstr "" - "<![CDATA[<dynamic-component name=\"userAttributes\"> -\n" - " <property name=\"foo\" column=\"FOO\" type=\"string\"/> -\n" - " <property name=\"bar\" column=\"BAR\" type=\"integer\"/> -\n" - " <many-to-one name=\"baz\" class=\"Baz\" column=\"BAZ_ID\"/> -\n" - "</dynamic-component>]]>" -#: index.docbook:247 -msgid "The semantics of a <literal><dynamic-component></literal> mapping are identical to <literal><component></literal>. The advantage of this kind of mapping is the ability to determine the actual properties of the bean at deployment time, just by editing the mapping document. Runtime manipulation of the mapping document is also possible, using a DOM parser. Even better, you can access (and change) Hibernate's configuration-time metamodel via the <literal>Configuration</literal> object." -msgstr "<literal><dynamic-component></literal> マッピングのセマンティクスは <literal><component></literal> と同一のものです。この種のマッピングの利点は、マッピングドキュメントの編集により、配置時にbeanの属性を決定できる点です。また、DOMパーサを利用して、マッピングドキュメントのランタイム操作が可能です。さらに、<literal>Configuration</literal> オブジェクト経由でHibernateのコンフィグレーション時のメタモデルにアクセス（または変更）が可能です。" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "" - +#. Tag: para +#: component_mapping.xml:247 +#, no-c-format +msgid "" +"The semantics of a <literal><dynamic-component></literal> mapping are " +"identical to <literal><component></literal>. The advantage of this " +"kind of mapping is the ability to determine the actual properties of the " +"bean at deployment time, just by editing the mapping document. Runtime " +"manipulation of the mapping document is also possible, using a DOM parser. " +"Even better, you can access (and change) Hibernate's configuration-time " +"metamodel via the <literal>Configuration</literal> object." +msgstr "" +"<literal><dynamic-component></literal> マッピングのセマンティクスは " +"<literal><component></literal> と同一のものです。この種のマッピングの利" +"点は、マッピングドキュメントの編集により、配置時にbeanの属性を決定できる点で" +"す。また、DOMパーサを利用して、マッピングドキュメントのランタイム操作が可能で" +"す。さらに、<literal>Configuration</literal> オブジェクト経由でHibernateのコ" +"ンフィグレーション時のメタモデルにアクセス（または変更）が可能です。" Modified: core/trunk/documentation/manual/translations/ja-JP/content/configuration.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/configuration.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/configuration.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,1599 +1,3233 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: configuration.xml:5 +#, no-c-format msgid "Configuration" -msgstr "<title>設定</title>" +msgstr "設定" -#: index.docbook:7 -msgid "Because Hibernate is designed to operate in many different environments, there are a large number of configuration parameters. Fortunately, most have sensible default values and Hibernate is distributed with an example <literal>hibernate.properties</literal> file in <literal>etc/</literal> that shows the various options. Just put the example file in your classpath and customize it." -msgstr "Hibernateはさまざまな環境で動作するようにデザインされているため、非常に多くの設定要素があります。幸いなことに、Hibernateは、公開されているパッケージの <literal>etc/</literal> フォルダの <literal>hibernate.properties</literal> に、ほとんどの設定要素の適切なデフォルト値が記述されています。この <literal>hibernate.properties</literal> をクラスパスに設定し、設定要素をカスタマイズするだけです。" +#. Tag: para +#: configuration.xml:7 +#, no-c-format +msgid "" +"Because Hibernate is designed to operate in many different environments, " +"there are a large number of configuration parameters. Fortunately, most have " +"sensible default values and Hibernate is distributed with an example " +"<literal>hibernate.properties</literal> file in <literal>etc/</literal> that " +"shows the various options. Just put the example file in your classpath and " +"customize it." +msgstr "" +"Hibernateはさまざまな環境で動作するようにデザインされているため、非常に多くの" +"設定要素があります。幸いなことに、Hibernateは、公開されているパッケージの " +"<literal>etc/</literal> フォルダの <literal>hibernate.properties</literal> " +"に、ほとんどの設定要素の適切なデフォルト値が記述されています。この " +"<literal>hibernate.properties</literal> をクラスパスに設定し、設定要素をカス" +"タマイズするだけです。" -#: index.docbook:16 +#. Tag: title +#: configuration.xml:16 +#, no-c-format msgid "Programmatic configuration" msgstr "プログラム上の設定" -#: index.docbook:18 -msgid "An instance of <literal>org.hibernate.cfg.Configuration</literal> represents an entire set of mappings of an application's Java types to an SQL database. The <literal>Configuration</literal> is used to build an (immutable) <literal>SessionFactory</literal>. The mappings are compiled from various XML mapping files." -msgstr "<literal>org.hibernate.cfg.Configuration</literal> のインスタンスは、 Javaの型とSQLデータベースのマッピング情報をすべて持っています。 The <literal>Configuration</literal> は、（不変の） <literal>SessionFactory</literal> を生成するときに使用します。複数のXMLマッピングファイルを変換し、マッピング情報にします。" +#. Tag: para +#: configuration.xml:18 +#, no-c-format +msgid "" +"An instance of <literal>org.hibernate.cfg.Configuration</literal> represents " +"an entire set of mappings of an application's Java types to an SQL database. " +"The <literal>Configuration</literal> is used to build an (immutable) " +"<literal>SessionFactory</literal>. The mappings are compiled from various " +"XML mapping files." +msgstr "" +"<literal>org.hibernate.cfg.Configuration</literal> のインスタンスは、 Javaの" +"型とSQLデータベースのマッピング情報をすべて持っています。 The " +"<literal>Configuration</literal> は、（不変の） <literal>SessionFactory</" +"literal> を生成するときに使用します。複数のXMLマッピングファイルを変換し、" +"マッピング情報にします。" -#: index.docbook:26 -msgid "You may obtain a <literal>Configuration</literal> instance by instantiating it directly and specifying XML mapping documents. If the mapping files are in the classpath, use <literal>addResource()</literal>:" -msgstr "通常、<literal>Configuration</literal> インスタンスは、特定のXMLマッピングファイルによって直接初期化されます。もし、マッピングファイルがクラスパスに設定されている場合、次のメソッドを使ってください。 <literal>addResource()</literal> :" +#. Tag: para +#: configuration.xml:26 +#, no-c-format +msgid "" +"You may obtain a <literal>Configuration</literal> instance by instantiating " +"it directly and specifying XML mapping documents. If the mapping files are " +"in the classpath, use <literal>addResource()</literal>:" +msgstr "" +"通常、<literal>Configuration</literal> インスタンスは、特定のXMLマッピング" +"ファイルによって直接初期化されます。もし、マッピングファイルがクラスパスに設" +"定されている場合、次のメソッドを使ってください。 <literal>addResource()</" +"literal> :" -#: index.docbook:32 +#. Tag: programlisting +#: configuration.xml:32 +#, no-c-format msgid "" - "<![CDATA[Configuration cfg = new Configuration()\n" - " .addResource(\"Item.hbm.xml\")\n" - " .addResource(\"Bid.hbm.xml\");]]>" +"<![CDATA[Configuration cfg = new Configuration()\n" +" .addResource(\"Item.hbm.xml\")\n" +" .addResource(\"Bid.hbm.xml\");]]>" msgstr "" - "<![CDATA[Configuration cfg = new Configuration()\n" - " .addResource(\"Item.hbm.xml\")\n" - " .addResource(\"Bid.hbm.xml\");]]>" -#: index.docbook:34 -msgid "An alternative (sometimes better) way is to specify the mapped class, and let Hibernate find the mapping document for you:" -msgstr "代替案(こちらのほうが良いときもあります)としてマッピングクラスを指定する方法もあります。Hibernateに、マッピングファイルを見つけさせてください：" +#. Tag: para +#: configuration.xml:34 +#, no-c-format +msgid "" +"An alternative (sometimes better) way is to specify the mapped class, and " +"let Hibernate find the mapping document for you:" +msgstr "" +"代替案(こちらのほうが良いときもあります)としてマッピングクラスを指定する方法" +"もあります。Hibernateに、マッピングファイルを見つけさせてください：" -#: index.docbook:39 +#. Tag: programlisting +#: configuration.xml:39 +#, no-c-format msgid "" - "<![CDATA[Configuration cfg = new Configuration()\n" - " .addClass(org.hibernate.auction.Item.class)\n" - " .addClass(org.hibernate.auction.Bid.class);]]>" +"<![CDATA[Configuration cfg = new Configuration()\n" +" .addClass(org.hibernate.auction.Item.class)\n" +" .addClass(org.hibernate.auction.Bid.class);]]>" msgstr "" - "<![CDATA[Configuration cfg = new Configuration()\n" - " .addClass(org.hibernate.auction.Item.class)\n" - " .addClass(org.hibernate.auction.Bid.class);]]>" -#: index.docbook:41 -msgid "Then Hibernate will look for mapping files named <literal>/org/hibernate/auction/Item.hbm.xml</literal> and <literal>/org/hibernate/auction/Bid.hbm.xml</literal> in the classpath. This approach eliminates any hardcoded filenames." -msgstr "Hibernateは、クラスパスにある以下のような名前のマッピングファイルを見つけます。 <literal>/org/hibernate/auction/Item.hbm.xml</literal> 、 <literal>/org/hibernate/auction/Bid.hbm.xml</literal> 。この方法だと、ハードコーディングされたファイル名を排除できます。" +#. Tag: para +#: configuration.xml:41 +#, no-c-format +msgid "" +"Then Hibernate will look for mapping files named <literal>/org/hibernate/" +"auction/Item.hbm.xml</literal> and <literal>/org/hibernate/auction/Bid.hbm." +"xml</literal> in the classpath. This approach eliminates any hardcoded " +"filenames." +msgstr "" +"Hibernateは、クラスパスにある以下のような名前のマッピングファイルを見つけま" +"す。 <literal>/org/hibernate/auction/Item.hbm.xml</literal> 、 <literal>/org/" +"hibernate/auction/Bid.hbm.xml</literal> 。この方法だと、ハードコーディングさ" +"れたファイル名を排除できます。" -#: index.docbook:48 -msgid "A <literal>Configuration</literal> also allows you to specify configuration properties:" -msgstr "<literal>Configuration</literal> は、設定プロパティを指定することもできます：" +#. Tag: para +#: configuration.xml:48 +#, no-c-format +msgid "" +"A <literal>Configuration</literal> also allows you to specify configuration " +"properties:" +msgstr "" +"<literal>Configuration</literal> は、設定プロパティを指定することもできます：" -#: index.docbook:53 +#. Tag: programlisting +#: configuration.xml:53 +#, no-c-format msgid "" - "<![CDATA[Configuration cfg = new Configuration()\n" - " .addClass(org.hibernate.auction.Item.class)\n" - " .addClass(org.hibernate.auction.Bid.class)\n" - " .setProperty(\"hibernate.dialect\", \"org.hibernate.dialect.MySQLInnoDBDialect\")\n" - " .setProperty(\"hibernate.connection.datasource\", \"java:comp/env/jdbc/test\")\n" - " .setProperty(\"hibernate.order_updates\", \"true\");]]>" +"<![CDATA[Configuration cfg = new Configuration()\n" +" .addClass(org.hibernate.auction.Item.class)\n" +" .addClass(org.hibernate.auction.Bid.class)\n" +" .setProperty(\"hibernate.dialect\", \"org.hibernate.dialect." +"MySQLInnoDBDialect\")\n" +" .setProperty(\"hibernate.connection.datasource\", \"java:comp/env/jdbc/" +"test\")\n" +" .setProperty(\"hibernate.order_updates\", \"true\");]]>" msgstr "" - "<![CDATA[Configuration cfg = new Configuration()\n" - " .addClass(org.hibernate.auction.Item.class)\n" - " .addClass(org.hibernate.auction.Bid.class)\n" - " .setProperty(\"hibernate.dialect\", \"org.hibernate.dialect.MySQLInnoDBDialect\")\n" - " .setProperty(\"hibernate.connection.datasource\", \"java:comp/env/jdbc/test\")\n" - " .setProperty(\"hibernate.order_updates\", \"true\");]]>" -#: index.docbook:55 -msgid "This is not the only way to pass configuration properties to Hibernate. The various options include:" -msgstr "Hibernateに設定プロパティを通す方法は1つではありません。さまざまなオプションを用意しています：" +#. Tag: para +#: configuration.xml:55 +#, no-c-format +msgid "" +"This is not the only way to pass configuration properties to Hibernate. The " +"various options include:" +msgstr "" +"Hibernateに設定プロパティを通す方法は1つではありません。さまざまなオプション" +"を用意しています：" -#: index.docbook:62 -msgid "Pass an instance of <literal>java.util.Properties</literal> to <literal>Configuration.setProperties()</literal>." -msgstr "<literal>java.util.Properties</literal> インスタンスを <literal>Configuration.setProperties()</literal> に渡します。" +#. Tag: para +#: configuration.xml:62 +#, no-c-format +msgid "" +"Pass an instance of <literal>java.util.Properties</literal> to " +"<literal>Configuration.setProperties()</literal>." +msgstr "" +"<literal>java.util.Properties</literal> インスタンスを " +"<literal>Configuration.setProperties()</literal> に渡します。" -#: index.docbook:68 -msgid "Place <literal>hibernate.properties</literal> in a root directory of the classpath." -msgstr "<literal>hibernate.properties</literal> をクラスパスのルートディレクトリに置きます。" +#. Tag: para +#: configuration.xml:68 +#, no-c-format +msgid "" +"Place <literal>hibernate.properties</literal> in a root directory of the " +"classpath." +msgstr "" +"<literal>hibernate.properties</literal> をクラスパスのルートディレクトリに置" +"きます。" -#: index.docbook:74 -msgid "Set <literal>System</literal> properties using <literal>java -Dproperty=value</literal>." -msgstr "<literal>System</literal> プロパティが <literal>java -Dproperty=value</literal> を使うように設定します。" +#. Tag: para +#: configuration.xml:74 +#, no-c-format +msgid "" +"Set <literal>System</literal> properties using <literal>java -" +"Dproperty=value</literal>." +msgstr "" +"<literal>System</literal> プロパティが <literal>java -Dproperty=value</" +"literal> を使うように設定します。" -#: index.docbook:80 -msgid "Include <literal><property></literal> elements in <literal>hibernate.cfg.xml</literal> (discussed later)." -msgstr "<literal><property></literal> 要素を <literal>hibernate.cfg.xml</literal> （後述）に設定します。" +#. Tag: para +#: configuration.xml:80 +#, no-c-format +msgid "" +"Include <literal><property></literal> elements in <literal>hibernate." +"cfg.xml</literal> (discussed later)." +msgstr "" +"<literal><property></literal> 要素を <literal>hibernate.cfg.xml</" +"literal> （後述）に設定します。" -#: index.docbook:87 -msgid "<literal>hibernate.properties</literal> is the easiest approach if you want to get started quickly." -msgstr "今すぐ始めたいのなら、<literal>hibernate.properties</literal> を使うのが一番の近道です。" +#. Tag: para +#: configuration.xml:87 +#, no-c-format +msgid "" +"<literal>hibernate.properties</literal> is the easiest approach if you want " +"to get started quickly." +msgstr "" +"今すぐ始めたいのなら、<literal>hibernate.properties</literal> を使うのが一番" +"の近道です。" -#: index.docbook:92 -msgid "The <literal>Configuration</literal> is intended as a startup-time object, to be discarded once a <literal>SessionFactory</literal> is created." -msgstr "<literal>Configuration</literal> は、起動時にだけあるオブジェクトであり、一度 <literal>SessionFactory</literal> を生成した後は、破棄されることを意図しています。" +#. Tag: para +#: configuration.xml:92 +#, no-c-format +msgid "" +"The <literal>Configuration</literal> is intended as a startup-time object, " +"to be discarded once a <literal>SessionFactory</literal> is created." +msgstr "" +"<literal>Configuration</literal> は、起動時にだけあるオブジェクトであり、一" +"度 <literal>SessionFactory</literal> を生成した後は、破棄されることを意図して" +"います。" -#: index.docbook:100 +#. Tag: title +#: configuration.xml:100 +#, no-c-format msgid "Obtaining a SessionFactory" msgstr "SessionFactoryを取得する" -#: index.docbook:102 -msgid "When all mappings have been parsed by the <literal>Configuration</literal>, the application must obtain a factory for <literal>Session</literal> instances. This factory is intended to be shared by all application threads:" -msgstr "<literal>Configuration</literal> がすべてのマッピング情報を解析したら、アプリケーションは、 <literal>Session</literal> ファクトリインスタンスを取得します。このSessionFactoryは、Hibernateを使用するすべてのスレッドで共有されるべきです。" +#. Tag: para +#: configuration.xml:102 +#, no-c-format +msgid "" +"When all mappings have been parsed by the <literal>Configuration</literal>, " +"the application must obtain a factory for <literal>Session</literal> " +"instances. This factory is intended to be shared by all application threads:" +msgstr "" +"<literal>Configuration</literal> がすべてのマッピング情報を解析したら、アプ" +"リケーションは、 <literal>Session</literal> ファクトリインスタンスを取得しま" +"す。このSessionFactoryは、Hibernateを使用するすべてのスレッドで共有されるべ" +"きです。" -#: index.docbook:108 +#. Tag: programlisting +#: configuration.xml:108 +#, no-c-format msgid "<![CDATA[SessionFactory sessions = cfg.buildSessionFactory();]]>" -msgstr "<![CDATA[SessionFactory sessions = cfg.buildSessionFactory();]]>" +msgstr "" -#: index.docbook:110 -msgid "Hibernate does allow your application to instantiate more than one <literal>SessionFactory</literal>. This is useful if you are using more than one database." -msgstr "Hibernateは、 <literal>SessionFactory</literal> を複数生成することができます。これは、複数のデータベースを使用する場合に便利です。" +#. Tag: para +#: configuration.xml:110 +#, no-c-format +msgid "" +"Hibernate does allow your application to instantiate more than one " +"<literal>SessionFactory</literal>. This is useful if you are using more than " +"one database." +msgstr "" +"Hibernateは、 <literal>SessionFactory</literal> を複数生成することができま" +"す。これは、複数のデータベースを使用する場合に便利です。" -#: index.docbook:119 +#. Tag: title +#: configuration.xml:119 +#, no-c-format msgid "JDBC connections" msgstr "JDBCコネクション" -#: index.docbook:121 -msgid "Usually, you want to have the <literal>SessionFactory</literal> create and pool JDBC connections for you. If you take this approach, opening a <literal>Session</literal> is as simple as:" -msgstr "通常、開発者は <literal>SessionFactory</literal> を生成し、SessionFactoryでJDBCコネクションをプーリングしたいと考えます。そのアプローチを採用する場合、単純に <literal>Session</literal> をオープンしてください：" +#. Tag: para +#: configuration.xml:121 +#, no-c-format +msgid "" +"Usually, you want to have the <literal>SessionFactory</literal> create and " +"pool JDBC connections for you. If you take this approach, opening a " +"<literal>Session</literal> is as simple as:" +msgstr "" +"通常、開発者は <literal>SessionFactory</literal> を生成し、SessionFactoryで" +"JDBCコネクションをプーリングしたいと考えます。そのアプローチを採用する場合、" +"単純に <literal>Session</literal> をオープンしてください：" -#: index.docbook:127 -msgid "<![CDATA[Session session = sessions.openSession(); // open a new Session]]>" -msgstr "<![CDATA[Session session = sessions.openSession(); // open a new Session]]>" +#. Tag: programlisting +#: configuration.xml:127 +#, no-c-format +msgid "" +"<![CDATA[Session session = sessions.openSession(); // open a new Session]]>" +msgstr "" -#: index.docbook:129 -msgid "As soon as you do something that requires access to the database, a JDBC connection will be obtained from the pool." -msgstr "これだけで、プーリングしたJDBCコネクションを使って目的のデータベースにアクセスすることができます。" +#. Tag: para +#: configuration.xml:129 +#, no-c-format +msgid "" +"As soon as you do something that requires access to the database, a JDBC " +"connection will be obtained from the pool." +msgstr "" +"これだけで、プーリングしたJDBCコネクションを使って目的のデータベースにアクセ" +"スすることができます。" -#: index.docbook:134 -msgid "For this to work, we need to pass some JDBC connection properties to Hibernate. All Hibernate property names and semantics are defined on the class <literal>org.hibernate.cfg.Environment</literal>. We will now describe the most important settings for JDBC connection configuration." -msgstr "そのためには、JDBCコネクションのプロパティをHibernateに設定する必要があります。すべてのHibernateプロパティ名とセマンティクスは <literal>org.hibernate.cfg.Environment</literal> クラスに定義されています。この設定はJDBCコネクション設定の中で一番重要なものです。" +#. Tag: para +#: configuration.xml:134 +#, no-c-format +msgid "" +"For this to work, we need to pass some JDBC connection properties to " +"Hibernate. All Hibernate property names and semantics are defined on the " +"class <literal>org.hibernate.cfg.Environment</literal>. We will now describe " +"the most important settings for JDBC connection configuration." +msgstr "" +"そのためには、JDBCコネクションのプロパティをHibernateに設定する必要がありま" +"す。すべてのHibernateプロパティ名とセマンティクスは <literal>org.hibernate." +"cfg.Environment</literal> クラスに定義されています。この設定はJDBCコネクショ" +"ン設定の中で一番重要なものです。" -#: index.docbook:141 -msgid "Hibernate will obtain (and pool) connections using <literal>java.sql.DriverManager</literal> if you set the following properties:" -msgstr "もし、以下のプロパティを設定すると、Hibernateはコネクションを取得する（プールも）ために <literal>java.sql.DriverManager</literal> を使います。" +#. Tag: para +#: configuration.xml:141 +#, no-c-format +msgid "" +"Hibernate will obtain (and pool) connections using <literal>java.sql." +"DriverManager</literal> if you set the following properties:" +msgstr "" +"もし、以下のプロパティを設定すると、Hibernateはコネクションを取得する（プール" +"も）ために <literal>java.sql.DriverManager</literal> を使います。" -#: index.docbook:147 +#. Tag: title +#: configuration.xml:147 +#, no-c-format msgid "Hibernate JDBC Properties" msgstr "Hibernate JDBCプロパティ" -#: index.docbook:153, index.docbook:241, index.docbook:338, index.docbook:529, index.docbook:725, index.docbook:832, index.docbook:920 +#. Tag: entry +#: configuration.xml:153 configuration.xml:241 configuration.xml:338 +#: configuration.xml:529 configuration.xml:725 configuration.xml:832 +#: configuration.xml:920 +#, no-c-format msgid "Property name" msgstr "プロパティ名" -#: index.docbook:154, index.docbook:242, index.docbook:339, index.docbook:530, index.docbook:726, index.docbook:833, index.docbook:921 +#. Tag: entry +#: configuration.xml:154 configuration.xml:242 configuration.xml:339 +#: configuration.xml:530 configuration.xml:726 configuration.xml:833 +#: configuration.xml:921 +#, no-c-format msgid "Purpose" -msgstr "<entry>意味</entry>" +msgstr "意味" -#: index.docbook:160 +#. Tag: literal +#: configuration.xml:160 +#, no-c-format msgid "hibernate.connection.driver_class" msgstr "hibernate.connection.driver_class" -#: index.docbook:163 +#. Tag: emphasis +#: configuration.xml:163 +#, no-c-format msgid "JDBC driver class" msgstr "JDBCドライバクラス" -#: index.docbook:168 +#. Tag: literal +#: configuration.xml:168 +#, no-c-format msgid "hibernate.connection.url" msgstr "hibernate.connection.url" -#: index.docbook:171 +#. Tag: emphasis +#: configuration.xml:171 +#, no-c-format msgid "JDBC URL" msgstr "jdbc URL" -#: index.docbook:176, index.docbook:272 +#. Tag: literal +#: configuration.xml:176 configuration.xml:272 +#, no-c-format msgid "hibernate.connection.username" msgstr "hibernate.connection.username" -#: index.docbook:179 +#. Tag: emphasis +#: configuration.xml:179 +#, no-c-format msgid "database user" msgstr "database user" -#: index.docbook:184, index.docbook:280 +#. Tag: literal +#: configuration.xml:184 configuration.xml:280 +#, no-c-format msgid "hibernate.connection.password" msgstr "hibernate.connection.password" -#: index.docbook:187 +#. Tag: emphasis +#: configuration.xml:187 +#, no-c-format msgid "database user password" msgstr "database user password" -#: index.docbook:192 +#. Tag: literal +#: configuration.xml:192 +#, no-c-format msgid "hibernate.connection.pool_size" msgstr "hibernate.connection.pool_size" -#: index.docbook:195 +#. Tag: emphasis +#: configuration.xml:195 +#, no-c-format msgid "maximum number of pooled connections" msgstr "プールするコネクションの最大数" -#: index.docbook:202 -msgid "Hibernate's own connection pooling algorithm is however quite rudimentary. It is intended to help you get started and is <emphasis>not intended for use in a production system</emphasis> or even for performance testing. You should use a third party pool for best performance and stability. Just replace the <literal>hibernate.connection.pool_size</literal> property with connection pool specific settings. This will turn off Hibernate's internal pool. For example, you might like to use C3P0." -msgstr "Hibernateのコネクションプールアルゴリズムは非常に初歩的なものです。これはすぐに始められるようにと用意されたもので、<emphasis>製品として使用することを意図していません</emphasis> 。また、パフォーマンスのテストのためのものでもありません。最高のパフォーマンスと安定性を持ったプールを実現したければ、サードパーティのツールをお勧めします。 <literal>hibernate.connection.pool_size</literal> プロパティに適切なコネクションプールサイズを記述してください。このままだとHibernateのコネクションプールを使います。例えば次のようにC3P0を使います。" +#. Tag: para +#: configuration.xml:202 +#, no-c-format +msgid "" +"Hibernate's own connection pooling algorithm is however quite rudimentary. " +"It is intended to help you get started and is <emphasis>not intended for use " +"in a production system</emphasis> or even for performance testing. You " +"should use a third party pool for best performance and stability. Just " +"replace the <literal>hibernate.connection.pool_size</literal> property with " +"connection pool specific settings. This will turn off Hibernate's internal " +"pool. For example, you might like to use C3P0." +msgstr "" +"Hibernateのコネクションプールアルゴリズムは非常に初歩的なものです。これはす" +"ぐに始められるようにと用意されたもので、<emphasis>製品として使用することを意" +"図していません</emphasis> 。また、パフォーマンスのテストのためのものでもあり" +"ません。最高のパフォーマンスと安定性を持ったプールを実現したければ、サード" +"パーティのツールをお勧めします。 <literal>hibernate.connection.pool_size</" +"literal> プロパティに適切なコネクションプールサイズを記述してください。この" +"ままだとHibernateのコネクションプールを使います。例えば次のようにC3P0を使い" +"ます。" -#: index.docbook:212 -msgid "C3P0 is an open source JDBC connection pool distributed along with Hibernate in the <literal>lib</literal> directory. Hibernate will use its <literal>C3P0ConnectionProvider</literal> for connection pooling if you set <literal>hibernate.c3p0.*</literal> properties. If you'd like to use Proxool refer to the packaged <literal>hibernate.properties</literal> and the Hibernate web site for more information." -msgstr "C3P0はオープンソースJDBCコネクションプールで、Hibernateの <literal>lib</literal> ディレクトリにあります。もし、<literal>hibernate.c3p0.*</literal> プロパティをセットすれば、Hibernateは、 <literal>C3P0ConnectionProvider</literal> を使います。もしProxoolを使いたい場合は、 <literal>hibernate.properties</literal> パッケージを参照したり、HibernateのWebサイトでより多くの情報を取得してください。" +#. Tag: para +#: configuration.xml:212 +#, no-c-format +msgid "" +"C3P0 is an open source JDBC connection pool distributed along with Hibernate " +"in the <literal>lib</literal> directory. Hibernate will use its " +"<literal>C3P0ConnectionProvider</literal> for connection pooling if you set " +"<literal>hibernate.c3p0.*</literal> properties. If you'd like to use Proxool " +"refer to the packaged <literal>hibernate.properties</literal> and the " +"Hibernate web site for more information." +msgstr "" +"C3P0はオープンソースJDBCコネクションプールで、Hibernateの <literal>lib</" +"literal> ディレクトリにあります。もし、<literal>hibernate.c3p0.*</literal> プ" +"ロパティをセットすれば、Hibernateは、 <literal>C3P0ConnectionProvider</" +"literal> を使います。もしProxoolを使いたい場合は、 <literal>hibernate." +"properties</literal> パッケージを参照したり、HibernateのWebサイトでより多く" +"の情報を取得してください。" -#: index.docbook:221 -msgid "Here is an example <literal>hibernate.properties</literal> file for C3P0:" -msgstr "C3P0用の <literal>hibernate.properties</literal> ファイルを例として示します：" +#. Tag: para +#: configuration.xml:221 +#, no-c-format +msgid "" +"Here is an example <literal>hibernate.properties</literal> file for C3P0:" +msgstr "" +"C3P0用の <literal>hibernate.properties</literal> ファイルを例として示します：" -#: index.docbook:225 +#. Tag: programlisting +#: configuration.xml:225 +#, no-c-format msgid "" - "<![CDATA[hibernate.connection.driver_class = org.postgresql.Driver\n" - "hibernate.connection.url = jdbc:postgresql://localhost/mydatabase\n" - "hibernate.connection.username = myuser\n" - "hibernate.connection.password = secret\n" - "hibernate.c3p0.min_size=5\n" - "hibernate.c3p0.max_size=20\n" - "hibernate.c3p0.timeout=1800\n" - "hibernate.c3p0.max_statements=50\n" - "hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect]]>" +"<![CDATA[hibernate.connection.driver_class = org.postgresql.Driver\n" +"hibernate.connection.url = jdbc:postgresql://localhost/mydatabase\n" +"hibernate.connection.username = myuser\n" +"hibernate.connection.password = secret\n" +"hibernate.c3p0.min_size=5\n" +"hibernate.c3p0.max_size=20\n" +"hibernate.c3p0.timeout=1800\n" +"hibernate.c3p0.max_statements=50\n" +"hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect]]>" msgstr "" - "<![CDATA[hibernate.connection.driver_class = org.postgresql.Driver\n" - "hibernate.connection.url = jdbc:postgresql://localhost/mydatabase\n" - "hibernate.connection.username = myuser\n" - "hibernate.connection.password = secret\n" - "hibernate.c3p0.min_size=5\n" - "hibernate.c3p0.max_size=20\n" - "hibernate.c3p0.timeout=1800\n" - "hibernate.c3p0.max_statements=50\n" - "hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect]]>" -#: index.docbook:227 -msgid "For use inside an application server, you should almost always configure Hibernate to obtain connections from an application server <literal>Datasource</literal> registered in JNDI. You'll need to set at least one of the following properties:" -msgstr "アプリケーションサーバ上で使う場合は、Hibernateを設定し、アプリケーションサーバからコネクションを取得するようにしてください。 <literal>Datasource</literal> をJNDIに登録します。そしてプロパティを以下のように設定してください。" +#. Tag: para +#: configuration.xml:227 +#, no-c-format +msgid "" +"For use inside an application server, you should almost always configure " +"Hibernate to obtain connections from an application server " +"<literal>Datasource</literal> registered in JNDI. You'll need to set at " +"least one of the following properties:" +msgstr "" +"アプリケーションサーバ上で使う場合は、Hibernateを設定し、アプリケーション" +"サーバからコネクションを取得するようにしてください。 <literal>Datasource</" +"literal> をJNDIに登録します。そしてプロパティを以下のように設定してくださ" +"い。" -#: index.docbook:235 +#. Tag: title +#: configuration.xml:235 +#, no-c-format msgid "Hibernate Datasource Properties" msgstr "Hibernate データソースプロパティ" -#: index.docbook:248 +#. Tag: literal +#: configuration.xml:248 +#, no-c-format msgid "hibernate.connection.datasource" msgstr "hibernate.connection.datasource" -#: index.docbook:251 +#. Tag: emphasis +#: configuration.xml:251 +#, no-c-format msgid "datasource JNDI name" msgstr "データソースのJNDI名" -#: index.docbook:256 +#. Tag: literal +#: configuration.xml:256 +#, no-c-format msgid "hibernate.jndi.url" msgstr "hibernate.jndi.url" -#: index.docbook:258 +#. Tag: entry +#: configuration.xml:258 +#, fuzzy, no-c-format msgid "<emphasis>URL of the JNDI provider</emphasis> (optional)" -msgstr "<emphasis>JNDIプロバイダのURL</emphasis> (オプション)" +msgstr "JNDIプロバイダのURL" -#: index.docbook:264 +#. Tag: literal +#: configuration.xml:264 +#, no-c-format msgid "hibernate.jndi.class" msgstr "hibernate.jndi.class" -#: index.docbook:266 -msgid "<emphasis>class of the JNDI <literal>InitialContextFactory</literal></emphasis> (optional)" -msgstr "<emphasis>JNDIクラス <literal>InitialContextFactory</literal> </emphasis> (オプション)" +#. Tag: entry +#: configuration.xml:266 +#, no-c-format +msgid "" +"<emphasis>class of the JNDI <literal>InitialContextFactory</literal></" +"emphasis> (optional)" +msgstr "" -#: index.docbook:274 +#. Tag: entry +#: configuration.xml:274 +#, no-c-format msgid "<emphasis>database user</emphasis> (optional)" -msgstr "<emphasis>database user</emphasis> (オプション)" +msgstr "" -#: index.docbook:282 +#. Tag: entry +#: configuration.xml:282 +#, no-c-format msgid "<emphasis>database user password</emphasis> (optional)" -msgstr "<emphasis>database user password</emphasis> (オプション)" +msgstr "" -#: index.docbook:290 -msgid "Here's an example <literal>hibernate.properties</literal> file for an application server provided JNDI datasource:" -msgstr "アプリケーションサーバから提供されたJNDIデータソースを使う <literal>hibernate.properties</literal> ファイルの例を示します：" +#. Tag: para +#: configuration.xml:290 +#, no-c-format +msgid "" +"Here's an example <literal>hibernate.properties</literal> file for an " +"application server provided JNDI datasource:" +msgstr "" +"アプリケーションサーバから提供されたJNDIデータソースを使う " +"<literal>hibernate.properties</literal> ファイルの例を示します：" -#: index.docbook:295 +#. Tag: programlisting +#: configuration.xml:295 +#, no-c-format msgid "" - "<![CDATA[hibernate.connection.datasource = java:/comp/env/jdbc/test\n" - "hibernate.transaction.factory_class = \\\n" - " org.hibernate.transaction.JTATransactionFactory\n" - "hibernate.transaction.manager_lookup_class = \\\n" - " org.hibernate.transaction.JBossTransactionManagerLookup\n" - "hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect]]>" +"<![CDATA[hibernate.connection.datasource = java:/comp/env/jdbc/test\n" +"hibernate.transaction.factory_class = \\\n" +" org.hibernate.transaction.JTATransactionFactory\n" +"hibernate.transaction.manager_lookup_class = \\\n" +" org.hibernate.transaction.JBossTransactionManagerLookup\n" +"hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect]]>" msgstr "" - "<![CDATA[hibernate.connection.datasource = java:/comp/env/jdbc/test\n" - "hibernate.transaction.factory_class = ¥\n" - " org.hibernate.transaction.JTATransactionFactory\n" - "hibernate.transaction.manager_lookup_class = ¥\n" - " org.hibernate.transaction.JBossTransactionManagerLookup\n" - "hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect]]>" -#: index.docbook:297 -msgid "JDBC connections obtained from a JNDI datasource will automatically participate in the container-managed transactions of the application server." -msgstr "JNDIデータソースから取得したJDBCコネクションは、アプリケーションサーバのコンテナ管理トランザクションに自動的に参加します。" +#. Tag: para +#: configuration.xml:297 +#, no-c-format +msgid "" +"JDBC connections obtained from a JNDI datasource will automatically " +"participate in the container-managed transactions of the application server." +msgstr "" +"JNDIデータソースから取得したJDBCコネクションは、アプリケーションサーバのコン" +"テナ管理トランザクションに自動的に参加します。" -#: index.docbook:302 -msgid "Arbitrary connection properties may be given by prepending \"<literal>hibernate.connection</literal>\" to the property name. For example, you may specify a <literal>charSet</literal> using <literal>hibernate.connection.charSet</literal>." -msgstr "任意のコネクションプロパティは、与えられた” <literal>hibernate.connnection</literal> ” プロパティ名によって与えられます。例えば、 <literal>charSet</literal> を設定したい場合は、 <literal>hibernate.connection.charSet</literal> を使います。" +#. Tag: para +#: configuration.xml:302 +#, no-c-format +msgid "" +"Arbitrary connection properties may be given by prepending " +"\"<literal>hibernate.connection</literal>\" to the property name. For " +"example, you may specify a <literal>charSet</literal> using " +"<literal>hibernate.connection.charSet</literal>." +msgstr "" +"任意のコネクションプロパティは、与えられた” <literal>hibernate.connnection</" +"literal> ” プロパティ名によって与えられます。例えば、 <literal>charSet</" +"literal> を設定したい場合は、 <literal>hibernate.connection.charSet</" +"literal> を使います。" -#: index.docbook:308 -msgid "You may define your own plugin strategy for obtaining JDBC connections by implementing the interface <literal>org.hibernate.connection.ConnectionProvider</literal>. You may select a custom implementation by setting <literal>hibernate.connection.provider_class</literal>." -msgstr "JDBCコネクションを取得する戦略を持つ独自のプラグインを定義する場合は、 <literal>org.hibernate.connection.ConnectionProvider</literal> インターフェイスを実装してください。そして、実装クラスを <literal>hibernate.connection.provider_class</literal> に設定してください。" +#. Tag: para +#: configuration.xml:308 +#, no-c-format +msgid "" +"You may define your own plugin strategy for obtaining JDBC connections by " +"implementing the interface <literal>org.hibernate.connection." +"ConnectionProvider</literal>. You may select a custom implementation by " +"setting <literal>hibernate.connection.provider_class</literal>." +msgstr "" +"JDBCコネクションを取得する戦略を持つ独自のプラグインを定義する場合は、 " +"<literal>org.hibernate.connection.ConnectionProvider</literal> インターフェイ" +"スを実装してください。そして、実装クラスを <literal>hibernate.connection." +"provider_class</literal> に設定してください。" -#: index.docbook:317 +#. Tag: title +#: configuration.xml:317 +#, no-c-format msgid "Optional configuration properties" msgstr "オプション設定プロパティ" -#: index.docbook:319 -msgid "There are a number of other properties that control the behaviour of Hibernate at runtime. All are optional and have reasonable default values." -msgstr "これらのプロパティはHibernateの挙動を制御するものです。これらのプロパティはすべて妥当なデフォルト値があり、任意で設定します。" +#. Tag: para +#: configuration.xml:319 +#, no-c-format +msgid "" +"There are a number of other properties that control the behaviour of " +"Hibernate at runtime. All are optional and have reasonable default values." +msgstr "" +"これらのプロパティはHibernateの挙動を制御するものです。これらのプロパティは" +"すべて妥当なデフォルト値があり、任意で設定します。" -#: index.docbook:324 -msgid "<emphasis>Warning: some of these properties are \"system-level\" only.</emphasis> System-level properties can be set only via <literal>java -Dproperty=value</literal> or <literal>hibernate.properties</literal>. They may <emphasis>not</emphasis> be set by the other techniques described above." -msgstr "<emphasis>注意：これらのプロパティは\"システムレベル\"のみです。</emphasis> システムレベルプロパティは <literal>java -Dproperty=value</literal> 、もしくは <literal>hibernate.properties</literal> でのみ設定可能です。それ以外の設定方法は <emphasis>ありません</emphasis> 。" +#. Tag: para +#: configuration.xml:324 +#, no-c-format +msgid "" +"<emphasis>Warning: some of these properties are \"system-level\" only.</" +"emphasis> System-level properties can be set only via <literal>java -" +"Dproperty=value</literal> or <literal>hibernate.properties</literal>. They " +"may <emphasis>not</emphasis> be set by the other techniques described above." +msgstr "" +"<emphasis>注意：これらのプロパティは\"システムレベル\"のみです。</emphasis> " +"システムレベルプロパティは <literal>java -Dproperty=value</literal> 、もしく" +"は <literal>hibernate.properties</literal> でのみ設定可能です。それ以外の設" +"定方法は <emphasis>ありません</emphasis> 。" -#: index.docbook:332 +#. Tag: title +#: configuration.xml:332 +#, no-c-format msgid "Hibernate Configuration Properties" msgstr "Hibernate設定プロパティ" -#: index.docbook:345 +#. Tag: literal +#: configuration.xml:345 +#, no-c-format msgid "hibernate.dialect" msgstr "hibernate.dialect" -#: index.docbook:347 -msgid "The classname of a Hibernate <literal>Dialect</literal> which allows Hibernate to generate SQL optimized for a particular relational database." -msgstr "Hibernate <literal>Dialect</literal> クラス名が入ります。これはリレーショナルデータベースごとに最適化されたSQLを生成します。" +#. Tag: entry +#: configuration.xml:347 +#, fuzzy, no-c-format +msgid "" +"The classname of a Hibernate <literal>Dialect</literal> which allows " +"Hibernate to generate SQL optimized for a particular relational database." +msgstr "" +"Hibernate <placeholder-1/> クラス名が入ります。これはリレーショナルデータ" +"ベースごとに最適化されたSQLを生成します。 <placeholder-2/>" -#: index.docbook:351 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>full.classname.of.Dialect</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> <literal>full.classname.of.Dialect</literal>" +#. Tag: para +#: configuration.xml:351 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>full.classname.of.Dialect</" +"literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:359 +#. Tag: literal +#: configuration.xml:359 +#, no-c-format msgid "hibernate.show_sql" msgstr "hibernate.show_sql" -#: index.docbook:361 -msgid "Write all SQL statements to console. This is an alternative to setting the log category <literal>org.hibernate.SQL</literal> to <literal>debug</literal>." -msgstr "発行されたすべてのSQLをコンソールに出力します。これはログカテゴリの <literal>org.hibernate.SQL</literal> に <literal>debug</literal> を設定する方法の代替手段です。" +#. Tag: entry +#: configuration.xml:361 +#, fuzzy, no-c-format +msgid "" +"Write all SQL statements to console. This is an alternative to setting the " +"log category <literal>org.hibernate.SQL</literal> to <literal>debug</" +"literal>." +msgstr "" +"発行されたすべてのSQLをコンソールに出力します。これはログカテゴリの " +"<placeholder-1/> に <placeholder-2/> を設定する方法の代替手段です。 " +"<placeholder-3/>" -#: index.docbook:365, index.docbook:377, index.docbook:471, index.docbook:484, index.docbook:497, index.docbook:510, index.docbook:564, index.docbook:591, index.docbook:605, index.docbook:660, index.docbook:888, index.docbook:903, index.docbook:993 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>true</literal> | <literal>false</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> <literal>true</literal> | <literal>false</literal>" +#. Tag: para +#: configuration.xml:365 configuration.xml:377 configuration.xml:471 +#: configuration.xml:484 configuration.xml:497 configuration.xml:510 +#: configuration.xml:564 configuration.xml:591 configuration.xml:605 +#: configuration.xml:660 configuration.xml:888 configuration.xml:903 +#: configuration.xml:993 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>true</literal> | " +"<literal>false</literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:373 +#. Tag: literal +#: configuration.xml:373 +#, no-c-format msgid "hibernate.format_sql" msgstr "hibernate.format_sql" -#: index.docbook:375 +#. Tag: entry +#: configuration.xml:375 +#, fuzzy, no-c-format msgid "Pretty print the SQL in the log and console." -msgstr "ログとコンソールのSQLを美しく表示します。" +msgstr "ログとコンソールのSQLを美しく表示します。 <placeholder-1/>" -#: index.docbook:385 +#. Tag: literal +#: configuration.xml:385 +#, no-c-format msgid "hibernate.default_schema" msgstr "hibernate.default_schema" -#: index.docbook:387 -msgid "Qualify unqualified table names with the given schema/tablespace in generated SQL." -msgstr "生成されるSQL文のテーブルに設定するスキーマ/テーブルスペースです。" +#. Tag: entry +#: configuration.xml:387 +#, fuzzy, no-c-format +msgid "" +"Qualify unqualified table names with the given schema/tablespace in " +"generated SQL." +msgstr "" +"生成されるSQL文のテーブルに設定するスキーマ/テーブルスペースです。 " +"<placeholder-1/>" -#: index.docbook:390 +#. Tag: para +#: configuration.xml:390 +#, fuzzy, no-c-format msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>SCHEMA_NAME</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> <literal>SCHEMA_NAME</literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:398 +#. Tag: literal +#: configuration.xml:398 +#, no-c-format msgid "hibernate.default_catalog" msgstr "hibernate.default_catalog" -#: index.docbook:400 -msgid "Qualify unqualified table names with the given catalog in generated SQL." -msgstr "生成されるSQL文のテーブルに設定するカタログです。" +#. Tag: entry +#: configuration.xml:400 +#, fuzzy, no-c-format +msgid "" +"Qualify unqualified table names with the given catalog in generated SQL." +msgstr "生成されるSQL文のテーブルに設定するカタログです。 <placeholder-1/>" -#: index.docbook:403 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>CATALOG_NAME</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> <literal>CATALOG_NAME</literal>" +#. Tag: para +#: configuration.xml:403 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>CATALOG_NAME</literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:411 +#. Tag: literal +#: configuration.xml:411 +#, no-c-format msgid "hibernate.session_factory_name" msgstr "hibernate.session_factory_name" -#: index.docbook:413 -msgid "The <literal>SessionFactory</literal> will be automatically bound to this name in JNDI after it has been created." -msgstr "<literal>SessionFactory</literal> は生成後、この名前でJNDIに登録されます。" +#. Tag: entry +#: configuration.xml:413 +#, fuzzy, no-c-format +msgid "" +"The <literal>SessionFactory</literal> will be automatically bound to this " +"name in JNDI after it has been created." +msgstr "" +"<placeholder-1/> は生成後、この名前でJNDIに登録されます。 <placeholder-2/>" -#: index.docbook:416, index.docbook:859 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>jndi/composite/name</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> <literal>jndi/composite/name</literal>" +#. Tag: para +#: configuration.xml:416 configuration.xml:859 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>jndi/composite/name</" +"literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:424 +#. Tag: literal +#: configuration.xml:424 +#, no-c-format msgid "hibernate.max_fetch_depth" msgstr "hibernate.max_fetch_depth" -#: index.docbook:426 -msgid "Set a maximum \"depth\" for the outer join fetch tree for single-ended associations (one-to-one, many-to-one). A <literal>0</literal> disables default outer join fetching." -msgstr "外部結合フェッチの最大深度を設定します。結合する関連は対一関連のみ（一対一、多対一）です。 <literal>0</literal> を指定すると外部結合フェッチは無効になります。" +#. Tag: entry +#: configuration.xml:426 +#, fuzzy, no-c-format +msgid "" +"Set a maximum \"depth\" for the outer join fetch tree for single-ended " +"associations (one-to-one, many-to-one). A <literal>0</literal> disables " +"default outer join fetching." +msgstr "" +"外部結合フェッチの最大深度を設定します。結合する関連は対一関連のみ（一対一、" +"多対一）です。 <placeholder-1/> を指定すると外部結合フェッチは無効になりま" +"す。 <placeholder-2/>" -#: index.docbook:430 -msgid "<emphasis role=\"strong\">eg.</emphasis> recommended values between <literal>0</literal> and <literal>3</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> 推奨する値は <literal>0</literal> から <literal>3</literal> です。" +#. Tag: para +#: configuration.xml:430 +#, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> recommended values between " +"<literal>0</literal> and <literal>3</literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis> 推奨する値は <literal>0</literal> " +"から <literal>3</literal> です。" -#: index.docbook:439 +#. Tag: literal +#: configuration.xml:439 +#, no-c-format msgid "hibernate.default_batch_fetch_size" msgstr "hibernate.default_batch_fetch_size" -#: index.docbook:441 +#. Tag: entry +#: configuration.xml:441 +#, fuzzy, no-c-format msgid "Set a default size for Hibernate batch fetching of associations." -msgstr "関連フェッチのデフォルトバッチサイズを指定します。" +msgstr "関連フェッチのデフォルトバッチサイズを指定します。 <placeholder-1/>" -#: index.docbook:443 -msgid "<emphasis role=\"strong\">eg.</emphasis> recommended values <literal>4</literal>, <literal>8</literal>, <literal>16</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> 推奨する値は <literal>4</literal> , <literal>8</literal> , <literal>16</literal> です。" +#. Tag: para +#: configuration.xml:443 +#, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> recommended values <literal>4</" +"literal>, <literal>8</literal>, <literal>16</literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis> 推奨する値は <literal>4</" +"literal> , <literal>8</literal> , <literal>16</literal> です。" -#: index.docbook:452 +#. Tag: literal +#: configuration.xml:452 +#, no-c-format msgid "hibernate.default_entity_mode" msgstr "hibernate.default_entity_mode" -#: index.docbook:454 -msgid "Set a default mode for entity representation for all sessions opened from this <literal>SessionFactory</literal>" -msgstr "<literal>SessionFactory</literal> からセッションをオープンしたときに使用するエンティティのデフォルトモードを設定します。" +#. Tag: entry +#: configuration.xml:454 +#, fuzzy, no-c-format +msgid "" +"Set a default mode for entity representation for all sessions opened from " +"this <literal>SessionFactory</literal>" +msgstr "" +"<placeholder-1/> からセッションをオープンしたときに使用するエンティティのデ" +"フォルトモードを設定します。 <placeholder-2/>" -#: index.docbook:457 -msgid "<literal>dynamic-map</literal>, <literal>dom4j</literal>, <literal>pojo</literal>" -msgstr "<literal>dynamic-map</literal>, <literal>dom4j</literal>, <literal>pojo</literal>" +#. Tag: para +#: configuration.xml:457 +#, no-c-format +msgid "" +"<literal>dynamic-map</literal>, <literal>dom4j</literal>, <literal>pojo</" +"literal>" +msgstr "" +"<literal>dynamic-map</literal>, <literal>dom4j</literal>, <literal>pojo</" +"literal>" -#: index.docbook:465 +#. Tag: literal +#: configuration.xml:465 +#, no-c-format msgid "hibernate.order_updates" msgstr "hibernate.order_updates" -#: index.docbook:467 -msgid "Force Hibernate to order SQL updates by the primary key value of the items being updated. This will result in fewer transaction deadlocks in highly concurrent systems." -msgstr "項目が更新されたときに、別のSQLで主キーを更新することを強制します。この場合、同時実行可能なシステムでは、まれにデッドロックが発生する可能性があります。" +#. Tag: entry +#: configuration.xml:467 +#, fuzzy, no-c-format +msgid "" +"Force Hibernate to order SQL updates by the primary key value of the items " +"being updated. This will result in fewer transaction deadlocks in highly " +"concurrent systems." +msgstr "" +"項目が更新されたときに、別のSQLで主キーを更新することを強制します。この場" +"合、同時実行可能なシステムでは、まれにデッドロックが発生する可能性がありま" +"す。 <placeholder-1/>" -#: index.docbook:479 +#. Tag: literal +#: configuration.xml:479 +#, no-c-format msgid "hibernate.generate_statistics" msgstr "hibernate.generate_statistics" -#: index.docbook:481 -msgid "If enabled, Hibernate will collect statistics useful for performance tuning." -msgstr "有効の場合、Hibernateはパフォーマンスチューニングに有効な統計情報を収集します。" +#. Tag: entry +#: configuration.xml:481 +#, fuzzy, no-c-format +msgid "" +"If enabled, Hibernate will collect statistics useful for performance tuning." +msgstr "" +"有効の場合、Hibernateはパフォーマンスチューニングに有効な統計情報を収集しま" +"す。 <placeholder-1/>" -#: index.docbook:492 +#. Tag: literal +#: configuration.xml:492 +#, no-c-format msgid "hibernate.use_identifier_rollback" msgstr "hibernate.use_identifer_rollback" -#: index.docbook:494 -msgid "If enabled, generated identifier properties will be reset to default values when objects are deleted." -msgstr "有効の場合、オブジェクトが削除されたときに識別子プロパティをリセットし、デフォルト値にしたものを生成します。" +#. Tag: entry +#: configuration.xml:494 +#, fuzzy, no-c-format +msgid "" +"If enabled, generated identifier properties will be reset to default values " +"when objects are deleted." +msgstr "" +"有効の場合、オブジェクトが削除されたときに識別子プロパティをリセットし、デ" +"フォルト値にしたものを生成します。 <placeholder-1/>" -#: index.docbook:505 +#. Tag: literal +#: configuration.xml:505 +#, no-c-format msgid "hibernate.use_sql_comments" msgstr "hibernate.use_sql_comments" -#: index.docbook:507 -msgid "If turned on, Hibernate will generate comments inside the SQL, for easier debugging, defaults to <literal>false</literal>." -msgstr "有効の場合、SQL内にコメントを生成します。これはデバックを容易にします。デフォルトの値は <literal>false</literal> です。" +#. Tag: entry +#: configuration.xml:507 +#, fuzzy, no-c-format +msgid "" +"If turned on, Hibernate will generate comments inside the SQL, for easier " +"debugging, defaults to <literal>false</literal>." +msgstr "" +"有効の場合、SQL内にコメントを生成します。これはデバックを容易にします。デ" +"フォルトの値は <placeholder-1/> です。 <placeholder-2/>" -#: index.docbook:521 +#. Tag: title +#: configuration.xml:521 +#, no-c-format msgid "Hibernate JDBC and Connection Properties" msgstr "Hibernate JDBC とコネクションプロパティ" -#: index.docbook:536 +#. Tag: literal +#: configuration.xml:536 +#, no-c-format msgid "hibernate.jdbc.fetch_size" msgstr "hibernate.jdbc.fetch_size" -#: index.docbook:538 -msgid "A non-zero value determines the JDBC fetch size (calls <literal>Statement.setFetchSize()</literal>)." -msgstr "値が0でない場合、JDBCフェッチサイズを決定します ( <literal>Statement.setFetchSize()</literal> を呼びます)。" +#. Tag: entry +#: configuration.xml:538 +#, fuzzy, no-c-format +msgid "" +"A non-zero value determines the JDBC fetch size (calls <literal>Statement." +"setFetchSize()</literal>)." +msgstr "" +"値が0でない場合、JDBCフェッチサイズを決定します ( <placeholder-1/> を呼びま" +"す)。" -#: index.docbook:545 +#. Tag: literal +#: configuration.xml:545 +#, no-c-format msgid "hibernate.jdbc.batch_size" msgstr "hibernate.jdbc.batch_size" -#: index.docbook:547 +#. Tag: entry +#: configuration.xml:547 +#, fuzzy, no-c-format msgid "A non-zero value enables use of JDBC2 batch updates by Hibernate." -msgstr "値が0でない場合、HibernateがJDBC2バッチ更新を使用します。" +msgstr "" +"値が0でない場合、HibernateがJDBC2バッチ更新を使用します。 <placeholder-1/>" -#: index.docbook:549 -msgid "<emphasis role=\"strong\">eg.</emphasis> recommended values between <literal>5</literal> and <literal>30</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> 推奨する値は <literal>5</literal> から <literal>30</literal> です。" +#. Tag: para +#: configuration.xml:549 +#, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> recommended values between " +"<literal>5</literal> and <literal>30</literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis> 推奨する値は <literal>5</literal> " +"から <literal>30</literal> です。" -#: index.docbook:557 +#. Tag: literal +#: configuration.xml:557 +#, no-c-format msgid "hibernate.jdbc.batch_versioned_data" msgstr "hibernate.jdbc.batch_versioned_data" -#: index.docbook:559 -msgid "Set this property to <literal>true</literal> if your JDBC driver returns correct row counts from <literal>executeBatch()</literal> (it is usually safe to turn this option on). Hibernate will then use batched DML for automatically versioned data. Defaults to <literal>false</literal>." -msgstr "もしJDBCドライバが <literal>executeBatch()</literal> によって正確な行数を返す場合、このプロパティを <literal>true</literal> にしてください（通常はこのオプションをONにします）。 Hibernateは、自動バージョンデータのためバッチDMLを使います。デフォルトの値は <literal>false</literal> です。" +#. Tag: entry +#: configuration.xml:559 +#, fuzzy, no-c-format +msgid "" +"Set this property to <literal>true</literal> if your JDBC driver returns " +"correct row counts from <literal>executeBatch()</literal> (it is usually " +"safe to turn this option on). Hibernate will then use batched DML for " +"automatically versioned data. Defaults to <literal>false</literal>." +msgstr "" +"もしJDBCドライバが <placeholder-1/> によって正確な行数を返す場合、このプロパ" +"ティを <placeholder-2/> にしてください（通常はこのオプションをONにしま" +"す）。 Hibernateは、自動バージョンデータのためバッチDMLを使います。デフォル" +"トの値は <placeholder-3/> です。 <placeholder-4/>" -#: index.docbook:572 +#. Tag: literal +#: configuration.xml:572 +#, no-c-format msgid "hibernate.jdbc.factory_class" msgstr "hibernate.jdbc.factory_class" -#: index.docbook:574 -msgid "Select a custom <literal>Batcher</literal>. Most applications will not need this configuration property." -msgstr "カスタム <literal>Batcher</literal> を選びます。ほとんどのアプリケーションに、この設定は必要ありません。" +#. Tag: entry +#: configuration.xml:574 +#, fuzzy, no-c-format +msgid "" +"Select a custom <literal>Batcher</literal>. Most applications will not need " +"this configuration property." +msgstr "" +"カスタム <placeholder-1/> を選びます。ほとんどのアプリケーションに、この設定" +"は必要ありません。 <placeholder-2/>" -#: index.docbook:577 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>classname.of.BatcherFactory</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> <literal>classname.of.BatcherFactory</literal>" +#. Tag: para +#: configuration.xml:577 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>classname.of." +"BatcherFactory</literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:585 +#. Tag: literal +#: configuration.xml:585 +#, no-c-format msgid "hibernate.jdbc.use_scrollable_resultset" msgstr "hibernate.jdbc.use_scrollable_resultset" -#: index.docbook:587 -msgid "Enables use of JDBC2 scrollable resultsets by Hibernate. This property is only necessary when using user supplied JDBC connections, Hibernate uses connection metadata otherwise." -msgstr "スクロール可能なリザルトセットを、Hibernateが使用します。このプロパティは、JDBCコネクションがコネクションメタデータをサポートしていることが必須条件になります。" +#. Tag: entry +#: configuration.xml:587 +#, fuzzy, no-c-format +msgid "" +"Enables use of JDBC2 scrollable resultsets by Hibernate. This property is " +"only necessary when using user supplied JDBC connections, Hibernate uses " +"connection metadata otherwise." +msgstr "" +"スクロール可能なリザルトセットを、Hibernateが使用します。このプロパティは、" +"JDBCコネクションがコネクションメタデータをサポートしていることが必須条件にな" +"ります。 <placeholder-1/>" -#: index.docbook:599 +#. Tag: literal +#: configuration.xml:599 +#, no-c-format msgid "hibernate.jdbc.use_streams_for_binary" msgstr "hibernate.jdbc.use_streams_for_binary" -#: index.docbook:601 -msgid "Use streams when writing/reading <literal>binary</literal> or <literal>serializable</literal> types to/from JDBC (system-level property)." -msgstr "JDBCへ/から <literal>binary</literal> や <literal>serializable</literal> の書き込み/読み込みストリームを使います(システムレベルのプロパティ)。" +#. Tag: entry +#: configuration.xml:601 +#, fuzzy, no-c-format +msgid "" +"Use streams when writing/reading <literal>binary</literal> or " +"<literal>serializable</literal> types to/from JDBC (system-level property)." +msgstr "" +"JDBCへ/から <placeholder-1/> や <placeholder-2/> の書き込み/読み込みストリー" +"ムを使います(システムレベルのプロパティ)。 <placeholder-3/>" -#: index.docbook:613 +#. Tag: literal +#: configuration.xml:613 +#, no-c-format msgid "hibernate.jdbc.use_get_generated_keys" msgstr "hibernate.jdbc.use_get_generated_keys" -#: index.docbook:615 -msgid "Enable use of JDBC3 <literal>PreparedStatement.getGeneratedKeys()</literal> to retrieve natively generated keys after insert. Requires JDBC3+ driver and JRE1.4+, set to false if your driver has problems with the Hibernate identifier generators. By default, tries to determine the driver capabilities using connection metadata." -msgstr "挿入の後に自動生成された主キーを取得するための JDBC3 <literal>PreparedStatement.getGeneratedKeys()</literal> の使用を有効にします。これはJDBC3+ドライバとJRE1.4+を必要とし、もしHibernateの識別子ジェネレータに問題が発生するようならfalseに設定してください。デフォルトではコネクションメタデータを使いドライバの能力を決定します。" +#. Tag: entry +#: configuration.xml:615 +#, fuzzy, no-c-format +msgid "" +"Enable use of JDBC3 <literal>PreparedStatement.getGeneratedKeys()</literal> " +"to retrieve natively generated keys after insert. Requires JDBC3+ driver and " +"JRE1.4+, set to false if your driver has problems with the Hibernate " +"identifier generators. By default, tries to determine the driver " +"capabilities using connection metadata." +msgstr "" +"挿入の後に自動生成された主キーを取得するための JDBC3 <placeholder-1/> の使用" +"を有効にします。これはJDBC3+ドライバとJRE1.4+を必要とし、もしHibernateの識" +"別子ジェネレータに問題が発生するようならfalseに設定してください。デフォルト" +"ではコネクションメタデータを使いドライバの能力を決定します。 <placeholder-2/>" -#: index.docbook:621, index.docbook:751, index.docbook:763, index.docbook:777, index.docbook:815 +#. Tag: para +#: configuration.xml:621 configuration.xml:751 configuration.xml:763 +#: configuration.xml:777 configuration.xml:815 +#, fuzzy, no-c-format msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>true|false</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> <literal>true|false</literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:629 +#. Tag: literal +#: configuration.xml:629 +#, no-c-format msgid "hibernate.connection.provider_class" msgstr "hibernate.connection.provider_class" -#: index.docbook:631 -msgid "The classname of a custom <literal>ConnectionProvider</literal> which provides JDBC connections to Hibernate." -msgstr "JDBCコネクションをHibernateに提供する独自の <literal>ConnectionProvider</literal> の名前を指定します。" +#. Tag: entry +#: configuration.xml:631 +#, fuzzy, no-c-format +msgid "" +"The classname of a custom <literal>ConnectionProvider</literal> which " +"provides JDBC connections to Hibernate." +msgstr "" +"JDBCコネクションをHibernateに提供する独自の <placeholder-1/> の名前を指定し" +"ます。 <placeholder-2/>" -#: index.docbook:634 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>classname.of.ConnectionProvider</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> <literal>classname.of.ConnectionProvider</literal>" +#. Tag: para +#: configuration.xml:634 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>classname.of." +"ConnectionProvider</literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:642 +#. Tag: literal +#: configuration.xml:642 +#, no-c-format msgid "hibernate.connection.isolation" msgstr "hibernate.connection.isolation" -#: index.docbook:644 -msgid "Set the JDBC transaction isolation level. Check <literal>java.sql.Connection</literal> for meaningful values but note that most databases do not support all isolation levels." -msgstr "JDBCトランザクション分離レベルを設定します。妥当な値を調べるためには <literal>java.sql.Connection</literal> をチェックしてください。しかし使用するデータベースが、すべての分離レベルをサポートしているとは限りません。" +#. Tag: entry +#: configuration.xml:644 +#, fuzzy, no-c-format +msgid "" +"Set the JDBC transaction isolation level. Check <literal>java.sql." +"Connection</literal> for meaningful values but note that most databases do " +"not support all isolation levels." +msgstr "" +"JDBCトランザクション分離レベルを設定します。妥当な値を調べるためには " +"<placeholder-1/> をチェックしてください。しかし使用するデータベースが、すべ" +"ての分離レベルをサポートしているとは限りません。 <placeholder-2/>" -#: index.docbook:648 +#. Tag: para +#: configuration.xml:648 +#, fuzzy, no-c-format msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>1, 2, 4, 8</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> <literal>1, 2, 4, 8</literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:656 +#. Tag: literal +#: configuration.xml:656 +#, no-c-format msgid "hibernate.connection.autocommit" msgstr "hibernate.connection.autocommit" -#: index.docbook:658 +#. Tag: entry +#: configuration.xml:658 +#, fuzzy, no-c-format msgid "Enables autocommit for JDBC pooled connections (not recommended)." -msgstr "プールされているJDBCコネクションの自動コミットを有効にする（非推奨）。" +msgstr "" +"プールされているJDBCコネクションの自動コミットを有効にする（非推奨）。 " +"<placeholder-1/>" -#: index.docbook:668 +#. Tag: literal +#: configuration.xml:668 +#, no-c-format msgid "hibernate.connection.release_mode" msgstr "hibernate.connection.release_mode" -#: index.docbook:670 -msgid "Specify when Hibernate should release JDBC connections. By default, a JDBC connection is held until the session is explicitly closed or disconnected. For an application server JTA datasource, you should use <literal>after_statement</literal> to aggressively release connections after every JDBC call. For a non-JTA connection, it often makes sense to release the connection at the end of each transaction, by using <literal>after_transaction</literal>. <literal>auto</literal> will choose <literal>after_statement</literal> for the JTA and CMT transaction strategies and <literal>after_transaction</literal> for the JDBC transaction strategy." -msgstr "HibernateがJDBCコネクションをリリースするかを指定します。デフォルトではセッションが明示的にクローズまたは切断されてもコネクションは保持します。アプリケーションサーバのJTAデータソースの場合、すべてのJDBCコールの後、強制的にコネクションをリリースするために <literal>after_statement</literal> を使ってください。非JTAコネクションの場合、各トランザクションが終了したときに <literal>after_transaction</literal> を使い、コネクションをリリースしてください。 <literal>auto</literal> にすると、 JTAやCMTトランザクションの場合、 <literal>after_statement</literal> でクローズし、 JDBCトランザクションの場合、 <literal>after_transaction</literal> でクローズします。" +#. Tag: entry +#: configuration.xml:670 +#, fuzzy, no-c-format +msgid "" +"Specify when Hibernate should release JDBC connections. By default, a JDBC " +"connection is held until the session is explicitly closed or disconnected. " +"For an application server JTA datasource, you should use " +"<literal>after_statement</literal> to aggressively release connections after " +"every JDBC call. For a non-JTA connection, it often makes sense to release " +"the connection at the end of each transaction, by using " +"<literal>after_transaction</literal>. <literal>auto</literal> will choose " +"<literal>after_statement</literal> for the JTA and CMT transaction " +"strategies and <literal>after_transaction</literal> for the JDBC transaction " +"strategy." +msgstr "" +"HibernateがJDBCコネクションをリリースするかを指定します。デフォルトではセッ" +"ションが明示的にクローズまたは切断されてもコネクションは保持します。アプリ" +"ケーショ

2026

2025

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

2006

hibernate-commits October 2007