[jboss-cvs] JBossAS SVN: r82591 - in projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide: en-US and 1 other directories.
jboss-cvs-commits at lists.jboss.org
jboss-cvs-commits at lists.jboss.org
Sun Jan 4 17:25:48 EST 2009
Author: irooskov at redhat.com
Date: 2009-01-04 17:25:48 -0500 (Sun, 04 Jan 2009)
New Revision: 82591
Added:
projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/
projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Additional_modules.pot
projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Author_Group.pot
projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Book_Info.pot
projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Chapter.pot
projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Entity_Beans.pot
projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Feedback.pot
projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Hibernate_Annotations_Reference_Guide_CP03_FP01.pot
projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Introduction.pot
projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Overriding_metadata_through_XML.pot
projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Preface.pot
projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Revision_History.pot
projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Setting_up_an_annotations_project.pot
projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/extras/
Modified:
projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/en-US/Book_Info.xml
Log:
Updating POT files
Modified: projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/en-US/Book_Info.xml
===================================================================
--- projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/en-US/Book_Info.xml 2009-01-04 22:24:25 UTC (rev 82590)
+++ projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/en-US/Book_Info.xml 2009-01-04 22:25:48 UTC (rev 82591)
@@ -8,7 +8,7 @@
<productname>JBoss Enterprise Application Platform</productname>
<productnumber>4.3</productnumber>
<edition>1.0</edition>
- <pubsnumber>1</pubsnumber>
+ <pubsnumber>2</pubsnumber>
<pubdate>December, 2008</pubdate>
<abstract>
<para>This book is a Reference Guide to Hibernate Annotations
Added: projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Additional_modules.pot
===================================================================
--- projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Additional_modules.pot (rev 0)
+++ projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Additional_modules.pot 2009-01-04 22:25:48 UTC (rev 82591)
@@ -0,0 +1,194 @@
+# SOME DESCRIPTIVE TITLE.
+# FIRST AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2009-01-04 22:24+0000\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
+"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-xml2pot; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#: Additional_modules.xml:6
+#, no-c-format
+msgid "Additional modules"
+msgstr ""
+
+#. Tag: para
+#: Additional_modules.xml:7
+#, no-c-format
+msgid ""
+"Hibernate Annotations mainly focuses on persistence metadata. The project "
+"also has a nice integration with two Hibernate modules."
+msgstr ""
+
+#. Tag: title
+#: Additional_modules.xml:11
+#, no-c-format
+msgid "Hibernate Validator"
+msgstr ""
+
+#. Tag: title
+#: Additional_modules.xml:13 Additional_modules.xml:64
+#, no-c-format
+msgid "Description"
+msgstr ""
+
+#. Tag: para
+#: Additional_modules.xml:14
+#, no-c-format
+msgid ""
+"Annotations are a very convenient and elegant way to specify invariant "
+"constraints for a domain model. You can, for example, express that a "
+"property should never be null, that the account balance should be strictly "
+"positive, etc. These domain-model constraints are declared in the bean "
+"itself by annotating its properties. A validator can then read them and "
+"check for constraint violations. The validation mechanism can be executed in "
+"different layers in your application without having to duplicate any of "
+"these rules (presentation layer, data access layer). Following the DRY "
+"principle, Hibernate Validator has been designed for that purpose."
+msgstr ""
+
+#. Tag: para
+#: Additional_modules.xml:17
+#, no-c-format
+msgid ""
+"Hibernate Validator works at two levels. First, it is able to check in-"
+"memory instances of a class for constraint violations. Second, it can apply "
+"the constraints to the Hibernate meta-model and incorporate them into the "
+"generated database schema."
+msgstr ""
+
+#. Tag: para
+#: Additional_modules.xml:20
+#, no-c-format
+msgid ""
+"Each constraint annotation is associated to a validator implementation "
+"responsible for checking the constraint on the entity instance. A validator "
+"can also (optionally) apply the constraint to the Hibernate meta-model, "
+"allowing Hibernate to generate DDL that expresses the constraint. With the "
+"appropriate event listener, you can execute the checking operation on "
+"inserts and updates done by Hibernate. Hibernate Validator is not limited to "
+"use with Hibernate. You can easily use it anywhere in your application."
+msgstr ""
+
+#. Tag: para
+#: Additional_modules.xml:23
+#, no-c-format
+msgid ""
+"When checking instances at runtime, Hibernate Validator returns information "
+"about constraint violations in an array of <classname>InvalidValue</"
+"classname> s. Among other information, the <classname>InvalidValue</"
+"classname> contains an error description message that can embed the "
+"parameter values bundle with the annotation (eg. length limit), and message "
+"strings that may be externalized to a <classname>ResourceBundle</classname> ."
+msgstr ""
+
+#. Tag: title
+#: Additional_modules.xml:29 Additional_modules.xml:72
+#, no-c-format
+msgid "Integration with Hibernate Annotations"
+msgstr ""
+
+#. Tag: para
+#: Additional_modules.xml:30
+#, no-c-format
+msgid ""
+"If Hibernate Validator (<filename>hibernate-validator.jar</filename>) is "
+"available in the classpath, Hibernate Annotations will integrate it in two "
+"ways:"
+msgstr ""
+
+#. Tag: para
+#: Additional_modules.xml:35
+#, no-c-format
+msgid ""
+"Constraints will be applied to the Data Definition Language. In other words, "
+"the database schema will reflect the constraints (provided that you use the "
+"<filename>hbm2ddl</filename> tool)."
+msgstr ""
+
+#. Tag: para
+#: Additional_modules.xml:40
+#, no-c-format
+msgid ""
+"Before an entity change is applied to the database (insert or update), the "
+"entity is validated. Validation errors, if any, will be carried over through "
+"an <classname>InvalidStateException</classname>."
+msgstr ""
+
+#. Tag: para
+#: Additional_modules.xml:45
+#, no-c-format
+msgid ""
+"For entities free of validation rules, the runtime performance cost is null."
+msgstr ""
+
+#. Tag: para
+#: Additional_modules.xml:48
+#, no-c-format
+msgid ""
+"To disable constraint propagation to DDL, set up <literal>hibernate."
+"validator.apply_to_ddl</literal> to false in the configuration file. Such a "
+"need is very uncommon and not recommended."
+msgstr ""
+
+#. Tag: para
+#: Additional_modules.xml:51
+#, no-c-format
+msgid ""
+"To disable pre-entity change validation, set up <literal>hibernate.validator."
+"autoregister_listeners</literal> to false in the configuration file. Such a "
+"need is very uncommon and not recommended."
+msgstr ""
+
+#. Tag: para
+#: Additional_modules.xml:54
+#, no-c-format
+msgid ""
+"Check the Hibernate Validator reference documentation for more information."
+msgstr ""
+
+#. Tag: title
+#: Additional_modules.xml:62
+#, no-c-format
+msgid "Hibernate Search"
+msgstr ""
+
+#. Tag: para
+#: Additional_modules.xml:65
+#, no-c-format
+msgid ""
+"Full-text search engines like Apache Lucene are a very powerful technology "
+"to bring free text/efficient queries to applications. Ift suffers several "
+"mismatches when dealing with a object domain model (keeping the index up-to-"
+"date, mismatch between the index structure and the domain model, querying "
+"mismatch...) Hibernate Search indexes your domain model thanks to a few "
+"annotations, takes care of the database / index synchronization and brings "
+"you back regular managed objects from free text queries. <ulink url=\"http://"
+"lucene.apache.org\">Apache Lucene</ulink> underlies Hibernate Search."
+msgstr ""
+
+#. Tag: para
+#: Additional_modules.xml:73
+#, no-c-format
+msgid ""
+"Hibernate Search integrates with Hibernate Annotations transparently "
+"provided that hibernate-search.jar is present in the classpath. If you do "
+"not wish to automatically register Hibernate Search event listeners, you can "
+"set <literal>hibernate.search.autoregister_listeners</literal> to false. "
+"Such a need is very uncommon and not recommended."
+msgstr ""
+
+#. Tag: para
+#: Additional_modules.xml:76
+#, no-c-format
+msgid ""
+"Check the Hibernate Search reference documentation for more information."
+msgstr ""
Added: projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Author_Group.pot
===================================================================
--- projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Author_Group.pot (rev 0)
+++ projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Author_Group.pot 2009-01-04 22:25:48 UTC (rev 82591)
@@ -0,0 +1,29 @@
+# SOME DESCRIPTIVE TITLE.
+# FIRST AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2009-01-04 22:24+0000\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
+"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-xml2pot; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: author
+#: Author_Group.xml:6
+#, no-c-format
+msgid "<firstname>Hibernate Development Team</firstname> <surname></surname>"
+msgstr ""
+
+#. Tag: editor
+#: Author_Group.xml:10
+#, no-c-format
+msgid ""
+"<firstname>Red Hat Inc. Engineering Content Services</firstname> <surname></"
+"surname>"
+msgstr ""
Added: projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Book_Info.pot
===================================================================
--- projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Book_Info.pot (rev 0)
+++ projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Book_Info.pot 2009-01-04 22:25:48 UTC (rev 82591)
@@ -0,0 +1,49 @@
+# SOME DESCRIPTIVE TITLE.
+# FIRST AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2009-01-04 22:24+0000\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
+"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-xml2pot; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#: Book_Info.xml:6
+#, no-c-format
+msgid "Hibernate Annotations Reference Guide CP03 FP01"
+msgstr ""
+
+#. Tag: subtitle
+#: Book_Info.xml:7
+#, no-c-format
+msgid ""
+"for Use with JBoss Enterprise Application Platform 4.3.0 Cumulative Patch 3 "
+"Feature Pack 1"
+msgstr ""
+
+#. Tag: para
+#: Book_Info.xml:14
+#, no-c-format
+msgid ""
+"This book is a Reference Guide to Hibernate Annotations for JBoss Enterprise "
+"Application Platform 4.3.0 CP03 FP01."
+msgstr ""
+
+#. Tag: phrase
+#: Book_Info.xml:22
+#, no-c-format
+msgid "Logo"
+msgstr ""
+
+#. Tag: holder
+#: Book_Info.xml:28
+#, no-c-format
+msgid "&HOLDER;"
+msgstr ""
Added: projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Chapter.pot
===================================================================
--- projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Chapter.pot (rev 0)
+++ projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Chapter.pot 2009-01-04 22:25:48 UTC (rev 82591)
@@ -0,0 +1,45 @@
+# SOME DESCRIPTIVE TITLE.
+# FIRST AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2009-01-04 22:24+0000\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
+"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-xml2pot; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#: Chapter.xml:6
+#, no-c-format
+msgid "Test"
+msgstr ""
+
+#. Tag: para
+#: Chapter.xml:7
+#, no-c-format
+msgid "This is a test paragraph"
+msgstr ""
+
+#. Tag: title
+#: Chapter.xml:11
+#, no-c-format
+msgid "Section 1 Test"
+msgstr ""
+
+#. Tag: para
+#: Chapter.xml:12 Chapter.xml:19
+#, no-c-format
+msgid "Test of a section"
+msgstr ""
+
+#. Tag: title
+#: Chapter.xml:18
+#, no-c-format
+msgid "Section 2 Test"
+msgstr ""
Added: projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Entity_Beans.pot
===================================================================
--- projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Entity_Beans.pot (rev 0)
+++ projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Entity_Beans.pot 2009-01-04 22:25:48 UTC (rev 82591)
@@ -0,0 +1,4659 @@
+# SOME DESCRIPTIVE TITLE.
+# FIRST AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2009-01-04 22:24+0000\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
+"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-xml2pot; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#: Entity_Beans.xml:6
+#, no-c-format
+msgid "Entity Beans"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:8
+#, no-c-format
+msgid "Intro"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:9
+#, no-c-format
+msgid ""
+"This section covers EJB 3.0 (aka Java Persistence) entity annotations and "
+"Hibernate-specific extensions."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:15
+#, no-c-format
+msgid "Mapping with EJB3/JPA Annotations"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:16
+#, no-c-format
+msgid ""
+"EJB3 entities are plain POJOs. Actually they represent the exact same "
+"concept as the Hibernate persistent entities. Their mappings are defined "
+"through JDK 5.0 annotations (an XML descriptor syntax for overriding is "
+"defined in the EJB3 specification). Annotations can be split in two "
+"categories, the logical mapping annotations (allowing you to describe the "
+"object model, the class associations, etc.) and the physical mapping "
+"annotations (describing the physical schema, tables, columns, indexes, etc). "
+"We will mix annotations from both categories in the following code examples."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:19
+#, no-c-format
+msgid ""
+"EJB3 annotations are in the <literal>javax.persistence.*</literal> package. "
+"Most JDK 5 compliant IDE (like Eclipse, IntelliJ IDEA and Netbeans) can "
+"autocomplete annotation interfaces and attributes for you (even without a "
+"specific \"EJB3\" module, since EJB3 annotations are plain JDK 5 "
+"annotations)."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:22
+#, no-c-format
+msgid ""
+"For more and runnable concrete examples read the JBoss EJB 3.0 tutorial or "
+"review the Hibernate Annotations test suite. Most of the unit tests have "
+"been designed to represent a concrete example and be a source of inspiration."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:26
+#, no-c-format
+msgid "Declaring an entity bean"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:27
+#, no-c-format
+msgid ""
+"Every bound persistent POJO class is an entity bean and is declared using "
+"the <literal>@Entity</literal> annotation (at the class level):"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:31
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_4.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:32
+#, no-c-format
+msgid ""
+"<literal>@Entity</literal> declares the class as an entity bean (i.e. a "
+"persistent POJO class), <literal>@Id</literal> declares the identifier "
+"property of this entity bean. The other mapping declarations are implicit. "
+"This \"configuration by exception\" concept is central to the new EJB3 "
+"specification and a major improvement. The class Flight is mapped to the "
+"Flight table, using the column id as its primary key column."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:35
+#, no-c-format
+msgid ""
+"Depending on whether you annotate fields or methods, the access type used by "
+"Hibernate will be <literal>field</literal> or <literal>property</literal>. "
+"The EJB3 spec requires that you declare annotations on the element type that "
+"will be accessed, that is, the getter method if you use <literal>property</"
+"literal> access, the field if you use <literal>field</literal> access. "
+"Mixing EJB3 annotations in both fields and methods should be avoided. "
+"Hibernate will guess the access type from the position of <literal>@Id</"
+"literal> or <literal>@EmbeddedId</literal>."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:39
+#, no-c-format
+msgid "Defining the table"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:40
+#, no-c-format
+msgid ""
+"<literal>@Table</literal> is set at the class level. It allows you to define "
+"the table, catalog, and schema names for your entity bean mapping. If no "
+"<literal>@Table</literal> is defined the default values are used: the "
+"unqualified class name of the entity."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:44
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_5.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:45
+#, no-c-format
+msgid ""
+"The <literal>@Table</literal> element also contains <literal>schema</"
+"literal> and a <literal>catalog</literal> attributes, if they need to be "
+"defined. You can also define unique constraints to the table using the "
+"<literal>@UniqueConstraint</literal> annotation in conjunction with "
+"<literal>@Table</literal> (for a unique constraint bound to a single column, "
+"refer to <literal>@Column</literal>)."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:49
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_6.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:50
+#, no-c-format
+msgid ""
+"A unique constraint is applied to the tuple month, day. Note that the "
+"<literal>columnNames</literal> array refers to the logical column names."
+msgstr ""
+
+#. Tag: remark
+#: Entity_Beans.xml:53
+#, no-c-format
+msgid ""
+"The logical column name is defined by the Hibernate NamingStrategy "
+"implementation. The default EJB3 naming strategy use the physical column "
+"name as the logical column name. Note that this may be different than the "
+"property name (if the column name is explicit). Unless you override the "
+"NamingStrategy, you shouldn't worry about that."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:57
+#, no-c-format
+msgid "Versioning for optimistic locking"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:58
+#, no-c-format
+msgid ""
+"You can add optimistic locking capability to an entity bean using the "
+"<literal>@Version</literal> annotation:"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:62
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_7.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:63
+#, no-c-format
+msgid ""
+"The version property will be mapped to the <literal>OPTLOCK</literal> "
+"column, and the entity manager will use it to detect conflicting updates "
+"(preventing lost updates you might otherwise see with the last-commit-wins "
+"strategy)."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:66
+#, no-c-format
+msgid ""
+"The version column may be a numeric (the recommended solution) or a "
+"timestamp as per the EJB3 spec. Hibernate supports any kind of type provided "
+"that you define and implement the appropriate <classname>UserVersionType</"
+"classname>."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:69
+#, no-c-format
+msgid ""
+"The application must not alter the version number set up by Hibernate in any "
+"way. To artificially increase the version number, check in Hibernate "
+"EntityManager's reference documentation <literal>LockMode.WRITE</literal>"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:77
+#, no-c-format
+msgid "Mapping simple properties"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:79
+#, no-c-format
+msgid "Declaring basic property mappings"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:80
+#, no-c-format
+msgid ""
+"Every non-static non-transient property (field or method) of an entity bean "
+"is considered persistent, unless you annotate it as <literal>@Transient</"
+"literal>. Not having an annotation for your property is equivalent to the "
+"appropriate <literal>@Basic</literal> annotation. The <literal>@Basic</"
+"literal> annotation allows you to declare the fetching strategy for a "
+"property:"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:84
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_8.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:85
+#, no-c-format
+msgid ""
+"<literal>counter</literal>, a transient field, and <literal>lengthInMeter</"
+"literal>, a method annotated as <literal>@Transient</literal>, and will be "
+"ignored by the entity manager. <literal>name</literal>, <literal>length</"
+"literal>, and <literal>firstname</literal> properties are mapped persistent "
+"and eagerly fetched (the default for simple properties). The "
+"<literal>detailedComment</literal> property value will be lazily fetched "
+"from the database once a lazy property of the entity is accessed for the "
+"first time. Usually you don't need to lazy simple properties (not to be "
+"confused with lazy association fetching)."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:89
+#, no-c-format
+msgid ""
+"To enable property-level lazy fetching, your classes have to be "
+"instrumented: bytecode is added to the original one to enable such feature – "
+"please refer to the Hibernate reference documentation. If your classes are "
+"not instrumented, property level lazy loading is silently ignored."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:93
+#, no-c-format
+msgid ""
+"The recommended alternative is to use the projection capability of EJB-QL or "
+"Criteria queries."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:96
+#, no-c-format
+msgid ""
+"EJB3 supports property mapping of all basic types supported by Hibernate "
+"(all basic Java types, their respective wrappers and serializable classes). "
+"Hibernate Annotations supports out-of-the-box Enum type mapping either into "
+"a ordinal column (saving the enum ordinal) or a string-based column (saving "
+"the enum string representation): the persistence representation, defaulted "
+"to ordinal, can be overridden through the <literal>@Enumerated</literal> "
+"annotation as shown in the <literal>note</literal> property example."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:99
+#, no-c-format
+msgid ""
+"In core Java APIs, the temporal precision is not defined. When dealing with "
+"temporal data you might want to describe the expected precision in database. "
+"Temporal data can have <literal>DATE</literal>, <literal>TIME</literal>, or "
+"<literal>TIMESTAMP</literal> precision (ie the actual date, only the time, "
+"or both). Use the <literal>@Temporal</literal> annotation to fine tune that."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:102
+#, no-c-format
+msgid ""
+"<literal>@Lob</literal> indicates that the property should be persisted in a "
+"Blob or a Clob depending on the property type: <classname>java.sql.Clob</"
+"classname>, <classname>Character[]</classname>, <classname>char[]</"
+"classname> and java.lang.<classname>String</classname> will be persisted in "
+"a Clob. <classname>java.sql.Blob</classname>, <classname>Byte[]</classname>, "
+"<classname>byte[] </classname>and serializable type will be persisted in a "
+"Blob."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:106
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_9.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:107
+#, no-c-format
+msgid ""
+"If the property type implements <classname>java.io.Serializable</classname> "
+"and is not a basic type, and if the property is not annotated with "
+"<literal>@Lob</literal>, then the Hibernate <literal>serializable</literal> "
+"type is used."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:113
+#, no-c-format
+msgid "Declaring column attributes"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:114
+#, no-c-format
+msgid ""
+"The column(s) used for a property mapping can be defined using the "
+"<literal>@Column</literal> annotation. Use it to override default values "
+"(see the EJB3 specification for more information on the defaults). You can "
+"use this annotation at the property level for properties that are:"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:119
+#, no-c-format
+msgid "not annotated at all"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:124
+#, no-c-format
+msgid "annotated with <literal>@Basic</literal>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:129
+#, no-c-format
+msgid "annotated with <literal>@Version</literal>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:134
+#, no-c-format
+msgid "annotated with <literal>@Lob</literal>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:139
+#, no-c-format
+msgid "annotated with <literal>@Temporal</literal>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:144
+#, no-c-format
+msgid ""
+"annotated with <literal>@org.hibernate.annotations.CollectionOfElements</"
+"literal> (for Hibernate only)"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:150
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_10.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:151
+#, no-c-format
+msgid ""
+"The <literal>name</literal> property is mapped to the <literal>flight_name</"
+"literal> column, which is not nullable, has a length of 50 and is not "
+"updatable (making the property immutable)."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:154
+#, no-c-format
+msgid ""
+"This annotation can be applied to regular properties as well as "
+"<literal>@Id</literal> or <literal>@Version</literal> properties."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:159
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_11.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:160
+#, no-c-format
+msgid "Notes"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:162
+#, no-c-format
+msgid ""
+"<literal>name</literal> (optional): the column name (default to the property "
+"name)"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:167
+#, no-c-format
+msgid ""
+"<literal>unique</literal> (optional): set a unique constraint on this column "
+"or not (default false)"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:172
+#, no-c-format
+msgid ""
+"<literal>nullable</literal> (optional): set the column as nullable (default "
+"true)."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:177
+#, no-c-format
+msgid ""
+"<literal>insertable</literal> (optional): whether or not the column will be "
+"part of the insert statement (default true)"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:182
+#, no-c-format
+msgid ""
+"<literal>updatable</literal> (optional): whether or not the column will be "
+"part of the update statement (default true)"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:187
+#, no-c-format
+msgid ""
+"<literal>columnDefinition</literal> (optional): override the sql DDL "
+"fragment for this particular column (non portable)"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:192
+#, no-c-format
+msgid ""
+"<literal>table</literal> (optional): define the targeted table (default "
+"primary table)"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:197
+#, no-c-format
+msgid ""
+"<literal><literal>length</literal></literal> (optional): column length "
+"(default 255)"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:202
+#, no-c-format
+msgid ""
+"<literal><literal>precision</literal></literal> (optional): column decimal "
+"precision (default 0)"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:207
+#, no-c-format
+msgid ""
+"<literal><literal>scale</literal></literal> (optional): column decimal scale "
+"if useful (default 0)"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:217
+#, no-c-format
+msgid "Embedded objects (aka components)"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:218
+#, no-c-format
+msgid ""
+"It is possible to declare an embedded component inside an entity and even "
+"override its column mapping. Component classes have to be annotated at the "
+"class level with the <literal>@Embeddable</literal> annotation. It is "
+"possible to override the column mapping of an embedded object for a "
+"particular entity using the <literal>@Embedded</literal> and "
+"<literal>@AttributeOverride</literal> annotation in the associated property:"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:222
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_12.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:224
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_13.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:226
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_14.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:227
+#, no-c-format
+msgid ""
+"A embeddable object inherits the access type of its owning entity (note that "
+"you can override that using the Hibernate-specific <literal>@AccessType</"
+"literal> annotations (see <xref linkend=\"sect-"
+"Hibernate_Annotations_Reference_Guide-Entity_Beans-"
+"Hibernate_Annotation_Extensions\"/>)."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:230
+#, no-c-format
+msgid ""
+"The <literal>Person</literal> entity bean has two component properties, "
+"<literal>homeAddress</literal> and <literal>bornIn</literal>. "
+"<literal>homeAddress</literal> property has not been annotated, but "
+"Hibernate will guess that it is a persistent component by looking for the "
+"<literal>@Embeddable</literal> annotation in the Address class. We also "
+"override the mapping of a column name (to <literal>bornCountryName</"
+"literal>) with the <literal>@Embedded</literal> and "
+"<literal>@AttributeOverride </literal>annotations for each mapped attribute "
+"of <literal>Country</literal>. As you can see, <literal>Country </literal>is "
+"also a nested component of <literal>Address</literal>, again using auto-"
+"detection by Hibernate and EJB3 defaults. Overriding columns of embedded "
+"objects of embedded objects is currently not supported in the EJB3 spec, "
+"however, Hibernate Annotations supports it through dotted expressions."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:235
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_15.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:235
+#, no-c-format
+msgid ""
+"Hibernate Annotations supports one more feature that is not explicitly "
+"supported by the EJB3 specification: you can annotate a embedded object with "
+"the <literal>@MappedSuperclass</literal> annotation to make the superclass "
+"properties persistent (see <literal>@MappedSuperclass</literal> for more "
+"information)."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:238
+#, no-c-format
+msgid ""
+"While not supported by the EJB3 specification, Hibernate Annotations allows "
+"you to use association annotations in an embeddable object (ie "
+"<literal>@*ToOne</literal> nor <literal>@*ToMany</literal>). To override the "
+"association columns you can use <literal>@AssociationOverride</literal>."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:241
+#, no-c-format
+msgid ""
+"If you want to have the same embeddable object type twice in the same "
+"entity, the column name defaulting will not work: at least one of the "
+"columns will have to be explicit. Hibernate goes beyond the EJB3 spec and "
+"allows you to enhance the defaulting mechanism through the "
+"<classname>NamingStrategy</classname>. "
+"<classname>DefaultComponentSafeNamingStrategy</classname> is a small "
+"improvement over the default EJB3NamingStrategy that allows embedded objects "
+"to be defaulted even if used twice in the same entity."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:247
+#, no-c-format
+msgid "Non-annotated property defaults"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:248
+#, no-c-format
+msgid "If a property is not annotated, the following rules apply:"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:253
+#, no-c-format
+msgid ""
+"If the property is of a single type, it is mapped as <literal>@Basic</"
+"literal>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:256
+#, no-c-format
+msgid ""
+"Otherwise, if the type of the property is annotated as <literal>@Embeddable</"
+"literal>, it is mapped as <literal>@Embedded</literal>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:259
+#, no-c-format
+msgid ""
+"Otherwise, if the type of the property is Serializable, it is mapped as "
+"<literal>@Basic</literal> in a column holding the object in its serialized "
+"version"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:262
+#, no-c-format
+msgid ""
+"Otherwise, if the type of the property is <literal>java.sql.Clob</literal> "
+"or <literal>java.sql.Blob</literal>, it is mapped as <literal>@Lob</literal> "
+"with the appropriate LobType"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:270
+#, no-c-format
+msgid "Mapping identifier properties"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:271
+#, no-c-format
+msgid ""
+"The <literal>@Id</literal> annotation lets you define which property is the "
+"identifier of your entity bean. This property can be set by the application "
+"itself or be generated by Hibernate (preferred). You can define the "
+"identifier generation strategy thanks to the <literal>@GeneratedValue</"
+"literal> annotation:"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:276
+#, no-c-format
+msgid "AUTO>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:277
+#, no-c-format
+msgid "identity column, sequence or table depending on the underlying DB"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:280
+#, no-c-format
+msgid "TABLE>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:281
+#, no-c-format
+msgid "table holding the id"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:284
+#, no-c-format
+msgid "IDENTITY>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:285
+#, no-c-format
+msgid "identity column"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:288
+#, no-c-format
+msgid "SEQUENCE>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:289
+#, no-c-format
+msgid "sequence"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:292
+#, no-c-format
+msgid ""
+"Hibernate provides more id generators than the basic EJB3 ones. Check <xref "
+"linkend=\"sect-Hibernate_Annotations_Reference_Guide-Entity_Beans-"
+"Hibernate_Annotation_Extensions\"/> for more information."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:295
+#, no-c-format
+msgid ""
+"The following example shows a sequence generator using the "
+"<literal>SEQ_STORE</literal> configuration (see below)"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:299
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_16.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:300
+#, no-c-format
+msgid "The next example uses the identity generator:"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:304
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_17.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:305
+#, no-c-format
+msgid ""
+"The <literal>AUTO</literal> generator is the preferred type for portable "
+"applications (across several DB vendors). The identifier generation "
+"configuration can be shared for several <literal>@Id</literal> mappings with "
+"the generator attribute. There are several configurations available through "
+"<literal>@SequenceGenerator</literal> and <literal>@TableGenerator</"
+"literal>. The scope of a generator can be the application or the class. "
+"Class-defined generators are not visible outside the class and can override "
+"application level generators. Application-level generators are defined at "
+"XML level (see <xref linkend=\"chap-Hibernate_Annotations_Reference_Guide-"
+"Overriding_metadata_through_XML\"/>):"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:309
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_18.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:310
+#, no-c-format
+msgid ""
+"If JPA XML (like <filename>META-INF/orm.xml</filename>) is used to define "
+"the generators, <literal>EMP_GEN</literal> and <literal>SEQ_GEN</literal> "
+"are application level generators. <literal>EMP_GEN</literal> defines a table "
+"based id generator using the hilo algorithm with a <literal>max_lo</literal> "
+"of 20. The hi value is kept in a <literal>table</literal> "
+"\"<literal>GENERATOR_TABLE</literal>\". The information is kept in a row "
+"where <literal>pkColumnName</literal> \"key\" is equals to "
+"<literal>pkColumnValue</literal> \"<literal>EMP</literal>\" and column "
+"<literal>valueColumnName</literal> \"<literal>hi</literal>\" contains the "
+"the next high value used."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:313
+#, no-c-format
+msgid ""
+"<literal>SEQ_GEN</literal> defines a sequence generator using a sequence "
+"named <literal>my_sequence</literal>. The allocation size used for this "
+"sequence based hilo algorithm is 20. Note that this version of Hibernate "
+"Annotations does not handle <literal>initialValue</literal> in the sequence "
+"generator. The default allocation size is 50, so if you want to use a "
+"sequence and pickup the value each time, you must set the allocation size to "
+"1."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:317
+#, no-c-format
+msgid ""
+"Package level definition is no longer supported by the EJB 3.0 "
+"specification. However, you can use the <literal>@GenericGenerator</literal> "
+"at the package level (see <xref linkend=\"sect-"
+"Hibernate_Annotations_Reference_Guide-Hibernate_Annotation_Extensions-"
+"Identifier\"/>)."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:321
+#, no-c-format
+msgid ""
+"The next example shows the definition of a sequence generator in a class "
+"scope:"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:325
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_19.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:326
+#, no-c-format
+msgid ""
+"This class will use a sequence named my_sequence and the SEQ_STORE generator "
+"is not visible in other classes. Note that you can check the Hibernate "
+"Annotations tests in the <package>org.hibernate.test.annotations.id</"
+"package> package for more examples."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:329
+#, no-c-format
+msgid "You can define a composite primary key through several syntaxes:"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:334
+#, no-c-format
+msgid ""
+"annotate the component property as <literal>@Id</literal> and make the "
+"component class <literal>@Embeddable</literal>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:337
+#, no-c-format
+msgid "annotate the component property as <literal>@EmbeddedId</literal>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:340
+#, no-c-format
+msgid ""
+"annotate the class as <literal>@IdClass</literal> and annotate each property "
+"of the entity involved in the primary key with <literal>@Id</literal>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:343
+#, no-c-format
+msgid ""
+"While quite common to the EJB2 developer, <literal>@IdClass</literal> is "
+"likely new for Hibernate users. The composite primary key class corresponds "
+"to multiple fields or properties of the entity class, and the names of "
+"primary key fields or properties in the primary key class and those of the "
+"entity class must match and their types must be the same. Let's look at an "
+"example:"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:347
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_20.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:348
+#, no-c-format
+msgid ""
+"As you may have seen, <literal>@IdClass</literal> points to the "
+"corresponding primary key class."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:351
+#, no-c-format
+msgid ""
+"While not supported by the EJB3 specification, Hibernate allows you to "
+"define associations inside a composite identifier. Simply use the regular "
+"annotations for that."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:355
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_21.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:359
+#, no-c-format
+msgid "Mapping inheritance"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:360
+#, no-c-format
+msgid "EJB3 supports the three types of inheritance:"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:365
+#, no-c-format
+msgid ""
+"Table per Class Strategy: the <literal><union-class></literal> element "
+"in Hibernate"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:368
+#, no-c-format
+msgid ""
+"Single Table per Class Hierarchy Strategy: the <literal><subclass></"
+"literal> element in Hibernate"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:371
+#, no-c-format
+msgid ""
+"Joined Subclass Strategy: the <literal><joined-subclass></literal> "
+"element in Hibernate"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:374
+#, no-c-format
+msgid ""
+"The chosen strategy is declared at the class level of the top level entity "
+"in the hierarchy using the <literal>@Inheritance</literal> annotation."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:378
+#, no-c-format
+msgid "Annotating interfaces is currently not supported."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:383
+#, no-c-format
+msgid "Table per class"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:384
+#, no-c-format
+msgid ""
+"This strategy has many drawbacks (esp. with polymorphic queries and "
+"associations) explained in the EJB3 spec, the Hibernate reference "
+"documentation, <citetitle>Hibernate in Action</citetitle>, and many other "
+"places. Hibernate works around most of them implementing this strategy using "
+"<literal>SQL UNION</literal> queries. It is commonly used for the top level "
+"of an inheritance hierarchy:"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:388
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_21a.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:389
+#, no-c-format
+msgid ""
+"This strategy supports one-to-many associations provided that they are "
+"bidirectional. This strategy does not support the <literal>IDENTITY</"
+"literal> generator strategy: the id has to be shared across several tables. "
+"Consequently, when using this strategy, you should not use <literal>AUTO </"
+"literal>nor <literal>IDENTITY</literal>."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:395
+#, no-c-format
+msgid "Single table per class hierarchy"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:396
+#, no-c-format
+msgid ""
+"All properties of all super- and subclasses are mapped into the same table, "
+"instances are distinguished by a special discriminator column:"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:400
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_22.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:401
+#, no-c-format
+msgid ""
+"<classname>Plane</classname> is the superclass, it defines the inheritance "
+"strategy <literal>InheritanceType.SINGLE_TABLE</literal>. It also defines "
+"the discriminator column through the <literal>@DiscriminatorColumn</literal> "
+"annotation. A discriminator column can also define the discriminator type. "
+"Finally, the <literal>@DiscriminatorValue</literal> annotation defines the "
+"value used to differentiate a class in the hierarchy. All of these "
+"attributes have sensible default values. The default name of the "
+"discriminator column is <literal>DTYPE</literal>. The default discriminator "
+"value is the entity name (as defined in <literal>@Entity.name</literal>) for "
+"DiscriminatorType.STRING. <classname>A320</classname> is a subclass; you "
+"only have to define discriminator value if you don't want to use the default "
+"value. The strategy and the discriminator type are implicit."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:404
+#, no-c-format
+msgid ""
+"<literal>@Inheritance</literal> and <literal>@DiscriminatorColumn</literal> "
+"should only be defined at the top of the entity hierarchy."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:410
+#, no-c-format
+msgid "Joined subclasses"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:411
+#, no-c-format
+msgid ""
+"The<literal> @PrimaryKeyJoinColumn</literal> and "
+"<literal>@PrimaryKeyJoinColumns</literal> annotations define the primary key"
+"(s) of the joined subclass table:"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:415
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_23.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:416
+#, no-c-format
+msgid ""
+"All of the above entities use the <literal>JOINED</literal> strategy, the "
+"<literal>Ferry</literal> table is joined with the <literal>Boat</literal> "
+"table using the same primary key names. The <literal>AmericaCupClass</"
+"literal> table is joined with <literal>Boat</literal> using the join "
+"condition <code>Boat.id = AmericaCupClass.BOAT_ID</code>."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:422
+#, no-c-format
+msgid "Inherit properties from superclasses"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:423
+#, no-c-format
+msgid ""
+"This is sometimes useful to share common properties through a technical or a "
+"business superclass without including it as a regular mapped entity (ie no "
+"specific table for this entity). For that purpose you can map them as "
+"<literal>@MappedSuperclass</literal>."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:427
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_24.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:428
+#, no-c-format
+msgid ""
+"In database, this hierarchy will be represented as an <literal>Order</"
+"literal> table having the <literal>id</literal>, <literal>lastUpdate</"
+"literal> and <literal>lastUpdater</literal> columns. The embedded superclass "
+"property mappings are copied into their entity subclasses. Remember that the "
+"embeddable superclass is not the root of the hierarchy though."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:432
+#, no-c-format
+msgid ""
+"Properties from superclasses not mapped as <literal>@MappedSuperclass</"
+"literal> are ignored."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:437
+#, no-c-format
+msgid ""
+"The access type (field or methods), is inherited from the root entity, "
+"unless you use the Hibernate annotation <literal>@AccessType</literal>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:442
+#, no-c-format
+msgid ""
+"The same notion can be applied to <literal>@Embeddable</literal> objects to "
+"persist properties from their superclasses. You also need to use "
+"<literal>@MappedSuperclass</literal> to do that (this should not be "
+"considered as a standard EJB3 feature though)"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:447
+#, no-c-format
+msgid ""
+"It is allowed to mark a class as <literal>@MappedSuperclass</literal> in the "
+"middle of the mapped inheritance hierarchy."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:452
+#, no-c-format
+msgid ""
+"Any class in the hierarchy non annotated with <literal>@MappedSuperclass</"
+"literal> nor <literal>@Entity</literal> will be ignored."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:456
+#, no-c-format
+msgid ""
+"You can override columns defined in entity superclasses at the root entity "
+"level using the <literal>@AttributeOverride</literal> annotation."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:460
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_25.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:461
+#, no-c-format
+msgid ""
+"The <literal>altitude</literal> property will be persisted in an "
+"<literal>fld_altitude</literal> column of table <literal>Plane</literal> and "
+"the propulsion association will be materialized in a "
+"<literal>fld_propulsion_fk</literal> foreign key column."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:464
+#, no-c-format
+msgid ""
+"You can define <literal>@AttributeOverride</literal>(s) and "
+"<literal>@AssociationOverride</literal>(s) on <literal>@Entity</literal> "
+"classes, <literal>@MappedSuperclass</literal> classes and properties "
+"pointing to an <literal>@Embeddable</literal> object."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:472
+#, no-c-format
+msgid "Mapping entity bean associations/relationships"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:474
+#, no-c-format
+msgid "One-to-one"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:475
+#, no-c-format
+msgid ""
+"You can associate entity beans through a one-to-one relationship using "
+"<literal>@OneToOne</literal>. There are three cases for one-to-one "
+"associations: either the associated entities share the same primary key "
+"values, a foreign key is held by one of the entities (note that this FK "
+"column in the database should be constrained unique to simulate one-to-one "
+"multiplicity), or an association table is used to store the link between the "
+"2 entities (a unique constraint has to be defined on each fk to ensure the "
+"one-to-one multiplicity)"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:478
+#, no-c-format
+msgid "First, we map a real one-to-one association using shared primary keys:"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:482
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_26.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:484
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_27.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:485
+#, no-c-format
+msgid ""
+"The one-to-one is marked as true by using the "
+"<literal>@PrimaryKeyJoinColumn</literal> annotation."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:488
+#, no-c-format
+msgid ""
+"In the following example, the associated entities are linked through a "
+"foreign key column:"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:492
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_28.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:493
+#, no-c-format
+msgid ""
+"A <classname>Customer</classname> is linked to a <classname>Passport</"
+"classname>, with a foreign key column named <literal>passport_fk</literal> "
+"in the <literal>Customer</literal> table. The join column is declared with "
+"the <literal>@JoinColumn</literal> annotation which looks like the "
+"<literal>@Column</literal> annotation. It has one more parameters named "
+"<literal>referencedColumnName</literal>. This parameter declares the column "
+"in the targeted entity that will be used to the join. Note that when using "
+"<literal><literal>referencedColumnName</literal></literal> to a non primary "
+"key column, the associated class has to be <classname>Serializable</"
+"classname>. Also note that the <literal><literal>referencedColumnName</"
+"literal></literal> to a non primary key column has to be mapped to a "
+"property having a single column (other cases might not work)."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:496
+#, no-c-format
+msgid ""
+"The association may be bidirectional. In a bidirectional relationship, one "
+"of the sides (and only one) has to be the owner: the owner is responsible "
+"for the association column(s) update. To declare a side as <emphasis>not</"
+"emphasis> responsible for the relationship, the attribute <literal>mappedBy</"
+"literal> is used. <literal>mappedBy</literal> refers to the property name of "
+"the association on the owner side. In our case, this is <literal>passport</"
+"literal>. As you can see, you don't have to (must not) declare the join "
+"column since it has already been declared on the owners side."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:499
+#, no-c-format
+msgid ""
+"If no <literal>@JoinColumn</literal> is declared on the owner side, the "
+"defaults apply. A join column(s) will be created in the owner table and its "
+"name will be the concatenation of the name of the relationship in the owner "
+"side, <keycap>_</keycap> (underscore), and the name of the primary key column"
+"(s) in the owned side. In this example <literal>passport_id</literal> "
+"because the property name is <literal>passport</literal> and the column id "
+"of <literal>Passport </literal>is <literal>id</literal>."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:502
+#, no-c-format
+msgid "The third possibility (using an association table) is very exotic."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:506
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_29.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:507
+#, no-c-format
+msgid ""
+"A <classname>Customer</classname> is linked to a <classname>Passport</"
+"classname> through a association table named <literal>CustomerPassports</"
+"literal> ; this association table has a foreign key column named "
+"<literal>passport_fk</literal> pointing to the <literal>Passport</literal> "
+"table (materialized by the <literal>inverseJoinColumn</literal> and a "
+"foreign key column named <literal>customer_fk</literal> pointing to the "
+"<literal>Customer</literal> table materialized by the <literal>joinColumns</"
+"literal> attribute."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:510
+#, no-c-format
+msgid ""
+"You must declare the join table name and the join columns explicitly in such "
+"a mapping."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:516
+#, no-c-format
+msgid "Many-to-one"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:517
+#, no-c-format
+msgid ""
+"Many-to-one associations are declared at the property level with the "
+"annotation <literal>@ManyToOne</literal>:"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:521
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_30.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:522
+#, no-c-format
+msgid ""
+"The <literal>@JoinColumn</literal> attribute is optional, the default value"
+"(s) is like in one-to-one, the concatenation of the name of the relationship "
+"in the owner side, <keycap>_</keycap> (underscore), and the name of the "
+"primary key column in the owned side. In this example <literal>company_id</"
+"literal> because the property name is <literal>company</literal> and the "
+"column id of Company is <literal>id</literal>."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:525
+#, no-c-format
+msgid ""
+"<literal>@ManyToOne</literal> has a parameter named <literal>targetEntity</"
+"literal> which describes the target entity name. You usually don't need this "
+"parameter since the default value (the type of the property that stores the "
+"association) is good in almost all cases. However this is useful when you "
+"want to use interfaces as the return type instead of the regular entity."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:529
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_31.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:530
+#, no-c-format
+msgid ""
+"You can also map a many-to-one association through an association table. "
+"This association table described by the <literal>@JoinTable</literal> "
+"annotation will contains a foreign key referencing back the entity table "
+"(through <literal>@JoinTable.joinColumns</literal>) and a a foreign key "
+"referencing the target entity table (through <literal>@JoinTable."
+"inverseJoinColumns</literal>)."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:534
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_32.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:538
+#, no-c-format
+msgid "Collections"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:540
+#, no-c-format
+msgid "Overview"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:541
+#, no-c-format
+msgid ""
+"You can map <classname>Collection</classname>, <literal>List</literal> (ie "
+"ordered lists, not indexed lists), <literal>Map</literal> and "
+"<classname>Set</classname>. The EJB3 specification describes how to map an "
+"ordered list (that is, a list ordered at load time) using <literal>@javax."
+"persistence.OrderBy</literal> annotation: this annotation takes into "
+"parameter a list of comma separated (target entity) properties to order the "
+"collection by (for example, <code>firstname asc, age desc</code>), if the "
+"string is empty, the collection will be ordered by id. For true indexed "
+"collections, please refer to the <xref linkend=\"sect-"
+"Hibernate_Annotations_Reference_Guide-Entity_Beans-"
+"Hibernate_Annotation_Extensions\"/>. EJB3 allows you to map Maps using as a "
+"key one of the target entity property using <literal>@MapKey(name="
+"\"myProperty\")</literal> (myProperty is a property name in the target "
+"entity). When using <literal>@MapKey</literal> (without property name), the "
+"target entity primary key is used. The map key uses the same column as the "
+"property pointed out: there is no additional column defined to hold the map "
+"key, and it does make sense since the map key actually represents a target "
+"property. Be aware that once loaded, the key is no longer kept in sync with "
+"the property, in other words, if you change the property value, the key will "
+"not change automatically in your Java model (for true map support please "
+"refers to <xref linkend=\"sect-Hibernate_Annotations_Reference_Guide-"
+"Entity_Beans-Hibernate_Annotation_Extensions\"/>). Many people confuse "
+"<literal><map></literal> capabilities and <literal>@MapKey</literal> "
+"ones. These are two different features. <literal>@MapKey</literal> still has "
+"some limitations, please check the forum or the JIRA tracking system for "
+"more information."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:544
+#, no-c-format
+msgid "Hibernate has several notions of collections."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:548
+#, no-c-format
+msgid "Collections semantics"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:555
+#, no-c-format
+msgid "Semantic"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:558
+#, no-c-format
+msgid "java representation"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:561
+#, no-c-format
+msgid "annotations"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:568
+#, no-c-format
+msgid "Bag semantic"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:571 Entity_Beans.xml:582
+#, no-c-format
+msgid "java.util.List, java.util.Collection"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:574 Entity_Beans.xml:607
+#, no-c-format
+msgid ""
+"@org.hibernate.annotations.CollectionOfElements or @OneToMany or @ManyToMany"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:579
+#, no-c-format
+msgid "Bag semantic with primary key (without the limitations of Bag semantic)"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:585
+#, no-c-format
+msgid ""
+"(@org.hibernate.annotations.CollectionOfElements or @OneToMany or "
+"@ManyToMany) and @CollectionId"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:590
+#, no-c-format
+msgid "List semantic"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:593
+#, no-c-format
+msgid "java.util.List"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:596
+#, no-c-format
+msgid ""
+"(@org.hibernate.annotations.CollectionOfElements or @OneToMany or "
+"@ManyToMany) and @org.hibernate.annotations.IndexColumn"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:601
+#, no-c-format
+msgid "Set semantic"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:604
+#, no-c-format
+msgid "java.util.Set"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:612
+#, no-c-format
+msgid "Map semantic"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:615
+#, no-c-format
+msgid "java.util.Map"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:618
+#, no-c-format
+msgid ""
+"(@org.hibernate.annotations.CollectionOfElements or @OneToMany or "
+"@ManyToMany) and (nothing or @org.hibernate.annotations.MapKey/"
+"MapKeyManyToMany for true map support, OR @javax.persistence.MapKey"
+msgstr ""
+
+#. Tag: remark
+#: Entity_Beans.xml:625
+#, no-c-format
+msgid ""
+"So specifically, java.util.List collections without @org.hibernate."
+"annotations.IndexColumn are going to be considered as bags."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:626
+#, no-c-format
+msgid ""
+"Collection of primitive, core type or embedded objects is not supported by "
+"the EJB3 specification. Hibernate Annotations allows them however (see <xref "
+"linkend=\"sect-Hibernate_Annotations_Reference_Guide-Entity_Beans-"
+"Hibernate_Annotation_Extensions\"/>)."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:630
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_33.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:631
+#, no-c-format
+msgid ""
+"So <literal>City</literal> has a collection of <literal>Street</literal>s "
+"that are ordered by <literal>streetName</literal> (of <literal>Street</"
+"literal>) when the collection is loaded. <literal>Software</literal> has a "
+"map of <literal>Version</literal>s which key is the <literal>Version</"
+"literal> <literal>codeName</literal>."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:634
+#, no-c-format
+msgid ""
+"Unless the collection is a generic, you will have to define "
+"<literal>targetEntity</literal>. This is an annotation attribute that take "
+"the target entity class as a value."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:640
+#, no-c-format
+msgid "One-to-many"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:641
+#, no-c-format
+msgid ""
+"One-to-many associations are declared at the property level with the "
+"annotation <literal>@OneToMany</literal>. One to many associations may be "
+"bidirectional."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:645
+#, no-c-format
+msgid "Bidirectional"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:646
+#, no-c-format
+msgid ""
+"Since many-to-one are (almost) always the owner side of a bidirectional "
+"relationship in the EJB3 spec, the one-to-many association is annotated by "
+"<literal>@OneToMany( mappedBy=... )</literal>"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:650
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_34.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:651
+#, no-c-format
+msgid ""
+"<classname>Troop</classname> has a bidirectional one-to-many relationship "
+"with <literal>Soldier</literal> through the <literal>troop</literal> "
+"property. You don't have to (must not) define any physical mapping in the "
+"<literal>mappedBy</literal> side."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:654
+#, no-c-format
+msgid ""
+"To map a bidirectional one-to-many, with the one-to-many side as the owning "
+"side, you have to remove the <literal>mappedBy</literal> element and set the "
+"many-to-one <literal>@JoinColumn</literal> as insertable and updatable to "
+"false. This solution is obviously not optimized and will produce some "
+"additional UPDATE statements."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:658
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_35.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:662
+#, no-c-format
+msgid "Unidirectional"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:663
+#, no-c-format
+msgid ""
+"A unidirectional one-to-many using a foreign key column in the owned entity "
+"is not that common and not really recommended. We strongly advise you to use "
+"a join table for this kind of association (as explained in the next "
+"section). This kind of association is described through a "
+"<literal>@JoinColumn</literal>"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:667
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_36.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:668
+#, no-c-format
+msgid ""
+"<literal>Customer</literal> describes a unidirectional relationship with "
+"<literal>Ticket</literal> using the join column <literal>CUST_ID</literal>."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:674
+#, no-c-format
+msgid "Unidirectional with join table"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:675
+#, no-c-format
+msgid ""
+"A unidirectional one-to-many with join table is much preferred. This "
+"association is described through an <literal>@JoinTable</literal>."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:679
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_37.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:680
+#, no-c-format
+msgid ""
+"<literal>Trainer</literal> describes a unidirectional relationship with "
+"<classname>Monkey</classname> using the join table "
+"<classname>TrainedMonkeys</classname>, with a foreign key "
+"<literal>trainer_id</literal> to <literal>Trainer</literal> "
+"(<literal>joinColumns</literal>) and a foreign key <literal>monkey_id</"
+"literal> to <literal>Monkey</literal> (<literal>inversejoinColumns</"
+"literal>)."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:686
+#, no-c-format
+msgid "Defaults"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:687
+#, no-c-format
+msgid ""
+"Without describing any physical mapping, a unidirectional one-to-many with "
+"join table is used. The table name is the concatenation of the owner table "
+"name, <keycap>_</keycap>, and the other side table name. The foreign key name"
+"(s) referencing the owner table is the concatenation of the owner table, "
+"<keycap>_</keycap>, and the owner primary key column(s) name. The foreign "
+"key name(s) referencing the other side is the concatenation of the owner "
+"property name, <keycap>_</keycap>, and the other side primary key column(s) "
+"name. A unique constraint is added to the foreign key referencing the other "
+"side table to reflect the one-to-many."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:691
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_38.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:692
+#, no-c-format
+msgid ""
+"<classname>Trainer</classname> describes a unidirectional relationship with "
+"<classname>Tiger</classname> using the join table <literal>Trainer_Tiger</"
+"literal>, with a foreign key <literal>trainer_id</literal> to "
+"<literal>Trainer</literal> (table name, <keycap>_</keycap>, trainer id) and "
+"a foreign key <literal>trainedTigers_id</literal> to <literal>Monkey</"
+"literal> (property name, <keycap>_</keycap>, Tiger primary column)."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:700
+#, no-c-format
+msgid "Many-to-many"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:702
+#, no-c-format
+msgid "Definition"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:703
+#, no-c-format
+msgid ""
+"A many-to-many association is defined logically using the "
+"<literal>@ManyToMany</literal> annotation. You also have to describe the "
+"association table and the join conditions using the <literal>@JoinTable</"
+"literal> annotation. If the association is bidirectional, one side has to be "
+"the owner and one side has to be the inverse end (ie. it will be ignored "
+"when updating the relationship values in the association table):"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:707
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_39.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:709
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_40.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:710
+#, no-c-format
+msgid ""
+"We've already shown the many declarations and the detailed attributes for "
+"associations. We'll go deeper in the <literal>@JoinTable</literal> "
+"description, it defines a <literal>name</literal>, an array of join columns "
+"(an array in annotation is defined using { A, B, C }), and an array of "
+"inverse join columns. The latter ones are the columns of the association "
+"table which refer to the <classname>Employee</classname> primary key (the "
+"\"other side\")."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:713
+#, no-c-format
+msgid ""
+"As seen previously, the other side don't have to (must not) describe the "
+"physical mapping: a simple <literal>mappedBy</literal> argument containing "
+"the owner side property name bind the two."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:719
+#, no-c-format
+msgid "Default values"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:720
+#, no-c-format
+msgid ""
+"As any other annotations, most values are guessed in a many-to-many "
+"relationship. Without describing any physical mapping in a unidirectional "
+"many-to-many the following rules applied. The table name is the "
+"concatenation of the owner table name, <keycap>_</keycap> and the other side "
+"table name. The foreign key name(s) referencing the owner table is the "
+"concatenation of the owner table name, <keycap>_</keycap> and the owner "
+"primary key column(s). The foreign key name(s) referencing the other side is "
+"the concatenation of the owner property name, <keycap>_</keycap>, and the "
+"other side primary key column(s). These are the same rules used for a "
+"unidirectional one-to-many relationship."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:724
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_41.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:725
+#, no-c-format
+msgid ""
+"A <literal>Store_City</literal> is used as the join table. The "
+"<literal>Store_id</literal> column is a foreign key to the <literal>Store</"
+"literal> table. The <literal>implantedIn_id</literal> column is a foreign "
+"key to the <literal>City</literal> table."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:728
+#, no-c-format
+msgid ""
+"Without describing any physical mapping in a bidirectional many-to-many the "
+"following rules applied. The table name is the concatenation of the owner "
+"table name, <keycap>_</keycap> and the other side table name. The foreign "
+"key name(s) referencing the owner table is the concatenation of the other "
+"side property name, <keycap>_</keycap>, and the owner primary key column(s). "
+"The foreign key name(s) referencing the other side is the concatenation of "
+"the owner property name, <keycap>_</keycap>, and the other side primary key "
+"column(s). These are the same rules used for a unidirectional one-to-many "
+"relationship."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:732
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_42.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:733
+#, no-c-format
+msgid ""
+"A <literal>Store_Customer</literal> is used as the join table. The "
+"<literal>stores_id</literal> column is a foreign key to the <literal>Store</"
+"literal> table. The <literal>customers_id</literal> column is a foreign key "
+"to the <literal>Customer</literal> table."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:743
+#, no-c-format
+msgid "Transitive persistence with cascading"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:744
+#, no-c-format
+msgid ""
+"You probably have noticed the <literal>cascade</literal> attribute taking an "
+"array of <classname>CascadeType</classname> as a value. The cascade concept "
+"in EJB3 is very is similar to the transitive persistence and cascading of "
+"operations in Hibernate, but with slightly different semantics and cascading "
+"types:"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:749
+#, no-c-format
+msgid ""
+"<literal>CascadeType.PERSIST</literal>: cascades the persist (create) "
+"operation to associated entities persist() is called or if the entity is "
+"managed"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:752
+#, no-c-format
+msgid ""
+"<literal>CascadeType.MERGE</literal>: cascades the merge operation to "
+"associated entities if merge() is called or if the entity is managed"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:755
+#, no-c-format
+msgid ""
+"<literal>CascadeType.REMOVE</literal>: cascades the remove operation to "
+"associated entities if delete() is called"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:758
+#, no-c-format
+msgid ""
+"<literal>CascadeType.REFRESH</literal>: cascades the refresh operation to "
+"associated entities if refresh() is called"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:761
+#, no-c-format
+msgid "<literal>CascadeType.ALL</literal>: all of the above"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:765
+#, no-c-format
+msgid ""
+"CascadeType.ALL also covers Hibernate-specific operations like save-update, "
+"lock etc... Check <xref linkend=\"sect-Hibernate_Annotations_Reference_Guide-"
+"Hibernate_Annotation_Extensions-Cascade\"/> for more information."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:769
+#, no-c-format
+msgid ""
+"Please refer to the chapter 6.3 of the EJB3 specification for more "
+"information on cascading and create/merge semantics."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:775
+#, no-c-format
+msgid "Association fetching"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:776
+#, no-c-format
+msgid ""
+"You have the ability to either eagerly or lazily fetch associated entities. "
+"The <literal>fetch</literal> parameter can be set to <literal>FetchType."
+"LAZY</literal> or <literal>FetchType.EAGER</literal>. <literal>EAGER</"
+"literal> will try to use an outer join select to retrieve the associated "
+"object, while <literal>LAZY</literal> will only trigger a select when the "
+"associated object is accessed for the first time. <literal>@OneToMany</"
+"literal> and <literal>@ManyToMany</literal> associations are defaulted to "
+"<literal>LAZY</literal> and <literal>@OneToOne</literal> and "
+"<literal>@ManyToOne</literal> are defaulted to <literal>EAGER</literal>. For "
+"more information about static fetching, check <xref linkend=\"sect-"
+"Hibernate_Annotations_Reference_Guide-Single_Association_related_annotations-"
+"Lazy_options_and_fetching_modes\"/>."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:779
+#, no-c-format
+msgid ""
+"The recommended approach is to use <literal>LAZY</literal> on all static "
+"fetching definitions and override this choice dynamically through JPA-QL. "
+"JPA-QL has a <literal>fetch</literal> keyword that allows you to override "
+"laziness when doing a particular query. This is very useful to improve "
+"performance and is decided on a use-case-to-use-case basis."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:787
+#, no-c-format
+msgid "Mapping composite primary and foreign keys"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:788
+#, no-c-format
+msgid ""
+"Composite primary keys use a embedded class as the primary key "
+"representation, so you'd use the <literal>@Id</literal> and "
+"<literal>@Embeddable</literal> annotations. Alternatively, you can use the "
+"<literal>@EmbeddedId</literal> annotation. Note that the dependent class has "
+"to be serializable and implements <methodname>equals()</methodname>/"
+"<methodname>hashCode()</methodname>. You can also use <literal>@IdClass</"
+"literal> as described in <xref linkend=\"sect-"
+"Hibernate_Annotations_Reference_Guide-Mapping_with_EJB3JPA_Annotations-"
+"Mapping_identifier_properties\"/>."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:792
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_43.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:793
+#, no-c-format
+msgid "or alternatively"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:797
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_44.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:798
+#, no-c-format
+msgid ""
+"<literal>@Embeddable</literal> inherits the access type of its owning entity "
+"unless the Hibernate-specific annotation <literal>@AccessType</literal> is "
+"used. Composite foreign keys (if not using the default sensitive values) are "
+"defined on associations using the <literal>@JoinColumns</literal> element, "
+"which is basically an array of <literal>@JoinColumn</literal>. It is "
+"considered a good practice to express <literal>referencedColumnNames</"
+"literal> explicitly. Otherwise, Hibernate will suppose that you use the same "
+"order of columns as in the primary key declaration."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:802
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_45.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:804
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_46.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:806
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_47.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:807
+#, no-c-format
+msgid "Note the explicit usage of the <literal>referencedColumnName</literal>."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:813
+#, no-c-format
+msgid "Mapping secondary tables"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:814
+#, no-c-format
+msgid ""
+"You can map a single entity bean to several tables using the "
+"<literal>@SecondaryTable</literal> or <literal>@SecondaryTables</literal> "
+"class level annotations. To express that a column is in a particular table, "
+"use the <literal>table</literal> parameter of <literal>@Column</literal> or "
+"<literal>@JoinColumn</literal>."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:818
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_48.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:819
+#, no-c-format
+msgid ""
+"In this example, <literal>name</literal> will be in <literal>MainCat</"
+"literal>. <literal>storyPart1</literal> will be in <literal>Cat1</literal> "
+"and <literal>storyPart2</literal> will be in <literal>Cat2</literal>. "
+"<literal>Cat1</literal> will be joined to <literal>MainCat</literal> using "
+"the <literal>cat_id</literal> as a foreign key, and <literal>Cat2</literal> "
+"using <literal>id</literal> (ie the same column name, the <literal>MainCat</"
+"literal> id column has). Plus a unique constraint on <literal>storyPart2</"
+"literal> has been set."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:822
+#, no-c-format
+msgid ""
+"Check out the <citetitle>JBoss EJB 3 tutorial</citetitle> or the Hibernate "
+"Annotations unit test suite for more examples."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:830
+#, no-c-format
+msgid "Mapping Queries"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:832
+#, no-c-format
+msgid "Mapping JPAQL/HQL queries"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:833
+#, no-c-format
+msgid ""
+"You can map EJBQL/HQL queries using annotations. <literal>@NamedQuery</"
+"literal> and <literal>@NamedQueries</literal> can be defined at the class "
+"level or in a JPA XML file. However their definitions are global to the "
+"session factory/entity manager factory scope. A named query is defined by "
+"its name and the actual query string."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:837
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_49.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:838
+#, no-c-format
+msgid ""
+"You can also provide some hints to a query through an array of "
+"<literal>QueryHint</literal> through a <literal>hints</literal> attribute."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:841
+#, no-c-format
+msgid "The available Hibernate hints are"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:845
+#, no-c-format
+msgid "Query hints"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:851
+#, no-c-format
+msgid "hint"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:854
+#, no-c-format
+msgid "description"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:861
+#, no-c-format
+msgid "org.hibernate.cacheable"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:864
+#, no-c-format
+msgid ""
+"Whether the query should interact with the second level cache (default to "
+"false)"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:869
+#, no-c-format
+msgid "org.hibernate.cacheRegion"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:872
+#, no-c-format
+msgid "Cache region name (default used otherwise)"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:877
+#, no-c-format
+msgid "org.hibernate.timeout"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:880
+#, no-c-format
+msgid "Query timeout"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:885
+#, no-c-format
+msgid "org.hibernate.fetchSize"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:888
+#, no-c-format
+msgid "resultset fetch size"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:893
+#, no-c-format
+msgid "org.hibernate.flushMode"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:896
+#, no-c-format
+msgid "Flush mode used for this query"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:901
+#, no-c-format
+msgid "org.hibernate.cacheMode"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:904
+#, no-c-format
+msgid "Cache mode used for this query"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:909
+#, no-c-format
+msgid "org.hibernate.readOnly"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:912
+#, no-c-format
+msgid ""
+"Entities loaded by this query should be in read only mode or not (default to "
+"false)"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:917
+#, no-c-format
+msgid "org.hibernate.comment"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:920
+#, no-c-format
+msgid "Query comment added to the generated SQL"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:930
+#, no-c-format
+msgid "Mapping native queries"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:931
+#, no-c-format
+msgid ""
+"You can also map a native query (ie a plain SQL query). To achieve that, you "
+"need to describe the SQL resultset structure using "
+"<literal>@SqlResultSetMapping</literal> (or <literal>@SqlResultSetMappings</"
+"literal> if you plan to define several resultset mappings). Like "
+"<literal>@NamedQuery</literal>, a <literal>@SqlResultSetMapping</literal> "
+"can be defined at class level or in a JPA XML file. However, its scope is "
+"global to the application."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:934
+#, no-c-format
+msgid ""
+"As we will see, a <literal>resultSetMapping</literal> parameter is defined "
+"in <literal>@NamedNativeQuery</literal>, it represents the name of a defined "
+"<literal>@SqlResultSetMapping</literal>. The resultset mapping declares the "
+"entities retrieved by this native query. Each field of the entity is bound "
+"to an SQL alias (or column name). All fields of the entity including the "
+"ones of subclasses and the foreign key columns of related entities have to "
+"be present in the SQL query. Field definitions are optional provided that "
+"they map to the same column name as the one declared on the class property."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:939
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_50.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:941
+#, no-c-format
+msgid ""
+"In the above example, the <literal>night&area</literal> named query use "
+"the <literal>joinMapping</literal> result set mapping. This mapping returns "
+"2 entities, <literal>Night</literal> and <literal>Area</literal>, each "
+"property is declared and associated to a column name, actually the column "
+"name retrieved by the query. Let's now see an implicit declaration of the "
+"property / column:"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:945
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_51.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:946
+#, no-c-format
+msgid ""
+"In this example, we only describe the entity member of the result set "
+"mapping. The property / column mapping is done using the entity mapping "
+"values. In this case the <literal>model</literal> property is bound to the "
+"<literal>model_txt </literal>column. If the association to a related entity "
+"involves a composite primary key, a <literal>@FieldResult</literal> element "
+"should be used for each foreign key column. The <literal>@FieldResult</"
+"literal> name is composed of the property name for the relationship, "
+"followed by a dot (\".\"), followed by the name or the field or property of "
+"the primary key."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:950
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_52.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:952
+#, no-c-format
+msgid ""
+"If you look at the dimension property, you'll see that although EJB3 "
+"implementations do not have to support the dotted notation for embedded "
+"objects, Hobernate does. You can even have nested embedded objects."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:956
+#, no-c-format
+msgid ""
+"If you retrieve a single entity and if you use the default mapping, you can "
+"use the <literal>resultClass</literal> attribute instead of "
+"<literal>resultSetMapping</literal>:"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:960
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_53.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:961
+#, no-c-format
+msgid ""
+"In some of your native queries, you'll have to return scalar values, for "
+"example when building report queries. You can map them in the "
+"<literal>@SqlResultsetMapping</literal> through <literal>@ColumnResult</"
+"literal>. You actually can even mix entities and scalar returns in the same "
+"native query (this is probably not common though)."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:965
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_54.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:966
+#, no-c-format
+msgid ""
+"Another query hint specific to native queries has been introduced: "
+"<literal>org.hibernate.callable</literal> which can be true or false "
+"depending on whether the query is a stored procedure or not."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:974
+#, no-c-format
+msgid "Hibernate Annotation Extensions"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:975
+#, no-c-format
+msgid ""
+"Hibernate 3.1 offers a variety of additional annotations that you can mix/"
+"match with your EJB 3 entities. They have been designed as a natural "
+"extension of EJB3 annotations."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:978
+#, no-c-format
+msgid ""
+"To empower the EJB3 capabilities, Hibernate provides specific annotations "
+"that match Hibernate features. The <classname>org.hibernate.annotations</"
+"classname> package contains all these annotations extensions."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:982
+#, no-c-format
+msgid "Entity"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:983
+#, no-c-format
+msgid ""
+"You can fine tune some of the actions done by Hibernate on entities beyond "
+"what the EJB3 spec offers."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:986
+#, no-c-format
+msgid ""
+"<classname>@org.hibernate.annotations.Entity</classname> adds additional "
+"metadata that may be needed beyond what is defined in the standard "
+"<literal>@Entity</literal>:"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:988
+#, no-c-format
+msgid "mutable"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:989
+#, no-c-format
+msgid "whether this entity is mutable or not"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:990
+#, no-c-format
+msgid "dynamicInsert"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:991
+#, no-c-format
+msgid "allow dynamic SQL for inserts"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:992
+#, no-c-format
+msgid "dynamicUpdate"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:993
+#, no-c-format
+msgid "allow dynamic SQL for updates"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:994
+#, no-c-format
+msgid "selectBeforeUpdate"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:995
+#, no-c-format
+msgid ""
+"Specifies that Hibernate should never perform an <literal>SQL UPDATE</"
+"literal> unless it is certain that an object is actually modified."
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:996
+#, no-c-format
+msgid "polymorphism"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:997
+#, no-c-format
+msgid ""
+"whether the entity polymorphism is of <literal>PolymorphismType.IMPLICIT</"
+"literal> (default) or <literal>PolymorphismType.EXPLICIT</literal>"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:998
+#, no-c-format
+msgid "optimisticLock"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:999
+#, no-c-format
+msgid ""
+"optimistic locking strategy (<literal>OptimisticLockType.VERSION</literal>, "
+"<literal>OptimisticLockType.NONE</literal>, <literal>OptimisticLockType."
+"DIRTY</literal> or <literal>OptimisticLockType.ALL</literal>)"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1004
+#, no-c-format
+msgid ""
+"<literal>@javax.persistence.Entity</literal> is still mandatory – "
+"<literal>@org.hibernate.annotations.Entity</literal> is not a replacement."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1009
+#, no-c-format
+msgid "Here are some additional Hibernate annotation extensions:"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1013
+#, no-c-format
+msgid "@org.hibernate.annotations.BatchSize"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1014
+#, no-c-format
+msgid ""
+"allows you to define the batch size when fetching instances of this entity "
+"( eg. <literal>@BatchSize(size=4)</literal> ). When loading a given entity, "
+"Hibernate will then load all the uninitialized entities of the same type in "
+"the persistence context up to the batch size."
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1014
+#, no-c-format
+msgid "@org.hibernate.annotations.Proxy"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1015
+#, no-c-format
+msgid ""
+"defines the laziness attributes of the entity. lazy (default to true) define "
+"whether the class is lazy or not. proxyClassName is the interface used to "
+"generate the proxy (default is the class itself)."
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1016
+#, no-c-format
+msgid "@org.hibernate.annotations.Where"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1017
+#, no-c-format
+msgid ""
+"defines an optional <literal>SQL WHERE</literal> clause used when instances "
+"of this class is retrieved."
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1018
+#, no-c-format
+msgid "@org.hibernate.annotations.Check"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1019
+#, no-c-format
+msgid "defines an optional check constraints defined in the DDL statement."
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1020
+#, no-c-format
+msgid "@OnDelete(action=OnDeleteAction.CASCADE)"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1021
+#, no-c-format
+msgid ""
+"on joined subclasses: use a SQL cascade delete on deletion instead of the "
+"regular Hibernate mechanism."
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1022
+#, no-c-format
+msgid ""
+"@Table(appliesTo=\"tableName\", indexes = { @Index(name=\"index1\", "
+"columnNames={\"column1\", \"column2\"} ) } )"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1023
+#, no-c-format
+msgid ""
+"creates the defined indexes on the columns of table <literal>tableName</"
+"literal>. This can be applied on the primary table or any secondary table. "
+"The <literal>@Tables</literal> annotation allows your to apply indexes on "
+"different tables. This annotation is expected where <literal>@javax."
+"persistence.Table</literal> or <literal>@javax.persistence.SecondaryTable</"
+"literal>(s) occurs."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1026
+#, no-c-format
+msgid ""
+"<literal>@org.hibernate.annotations.Table</literal> is a complement to, not "
+"a replacement for <literal>@javax.persistence.Table</literal>. In "
+"particular, if you want to change the default name of a table, you must use "
+"<literal>@javax.persistence.Table</literal>, not <literal>@org.hibernate."
+"annotations.Table</literal>."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1030
+#, no-c-format
+msgid ""
+"<literal>@org.hibernate.annotations.Table</literal> can also be used to "
+"define the following elements of secondary tables:"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1034
+#, no-c-format
+msgid "fetch"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1035
+#, no-c-format
+msgid ""
+"If set to <literal>JOIN</literal>, the default, Hibernate will use an inner "
+"join to retrieve a secondary table defined by a class or its superclasses "
+"and an outer join for a secondary table defined by a subclass. If set to "
+"select then Hibernate will use a sequential select for a secondary table "
+"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 secondary defined by the class and its superclasses."
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1036
+#, no-c-format
+msgid "inverse"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1037
+#, no-c-format
+msgid ""
+"If true, Hibernate will not try to insert or update the properties defined "
+"by this join. Default to false."
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1038
+#, no-c-format
+msgid "optional"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1039
+#, no-c-format
+msgid ""
+"If enabled (the default), 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 ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1040
+#, no-c-format
+msgid "foreignKey"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1041
+#, no-c-format
+msgid ""
+"defines the Foreign Key name of a secondary table pointing back to the "
+"primary table."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1044
+#, no-c-format
+msgid ""
+"<literal>@Immutable</literal> marks an entity as immutable. The entity may "
+"not be updated or deleted by the application. This allows Hibernate to make "
+"some minor performance optimizations. <literal>@Immutable</literal> must be "
+"use on root entities only."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1047
+#, no-c-format
+msgid ""
+"<literal>@Persister</literal> lets you define your own custom persistence "
+"strategy. You may, for example, specify your own subclass of <classname>org."
+"hibernate.persister.EntityPersister</classname> 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."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1052
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_55.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1054
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_56.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1059
+#, no-c-format
+msgid "Identifier"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1060
+#, no-c-format
+msgid ""
+"Hibernate Annotations goes beyond the Java Persistence specification when "
+"defining identifiers."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1064
+#, no-c-format
+msgid "Generators"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1065
+#, no-c-format
+msgid ""
+"<literal>@org.hibernate.annotations.GenericGenerator</literal> and "
+"<literal>@org.hibernate.annotations.GenericGenerators</literal> allows you "
+"to define a Hibernate-specific id generator."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1070
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_57.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1072
+#, no-c-format
+msgid ""
+"<literal>strategy</literal> is the short name of a Hibernate3 generator "
+"strategy or the fully qualified class name of an "
+"<classname>IdentifierGenerator</classname> implementation. You can add some "
+"parameters through the <literal>parameters</literal> attribute."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1075
+#, no-c-format
+msgid ""
+"Contrary to their standard counterpart, <literal>@GenericGenerator</literal> "
+"and <literal>@GenericGenerators</literal> can be used in package-level "
+"annotations, making them application-level generators (just like if they "
+"were in a JPA XML file)."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1079
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_58.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1083
+#, no-c-format
+msgid "@NaturalId"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1084
+#, no-c-format
+msgid ""
+"While not used as identifier property, some (groups of) properties represent "
+"the natural identifier of an entity. This is especially true when the schema "
+"uses the recommended approach of using surrogate primary key even if a "
+"natural business key exists. Hibernate allows to map such natural properties "
+"and reuse them in a <classname>Criteria</classname> query. The natural "
+"identifier is composed of all the properties marked <classname>@NaturalId</"
+"classname>."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1088
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_60.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1089
+#, no-c-format
+msgid ""
+"Note that the group of properties representing the natural identifier have "
+"to be unique (Hibernate will generate a unique constraint if the database "
+"schema is generated)."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1097
+#, no-c-format
+msgid "Property"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1099
+#, no-c-format
+msgid "Access type"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1100
+#, no-c-format
+msgid ""
+"The access type is guessed from the position of <literal>@Id</literal> or "
+"<literal>@EmbeddedId</literal> in the entity hierarchy. Sub-entities, "
+"embedded objects and mapped superclass inherit the access type from the root "
+"entity."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1103
+#, no-c-format
+msgid "In Hibernate, you can override the access type to:"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1108
+#, no-c-format
+msgid "use a custom access type strategy"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1113
+#, no-c-format
+msgid "fine tune the access type at the class level or at the property level"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1118
+#, no-c-format
+msgid ""
+"An <literal>@AccessType</literal> annotation has been introduced to support "
+"this behavior. You can define the access type on"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1123
+#, no-c-format
+msgid "an entity"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1128
+#, no-c-format
+msgid "a superclass"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1133
+#, no-c-format
+msgid "an embeddable object"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1138
+#, no-c-format
+msgid "a property"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1143
+#, no-c-format
+msgid ""
+"The access type is overridden for the annotated element, if overridden on a "
+"class, all the properties of the given class inherit the access type. For "
+"root entities, the access type is considered to be the default one for the "
+"whole hierarchy (overridable at class or property level)."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1146
+#, no-c-format
+msgid ""
+"If the access type is marked as \"property\", the getters are scanned for "
+"annotations, if the access type is marked as \"field\", the fields are "
+"scanned for annotations. Otherwise the elements marked with <literal>@Id</"
+"literal> or <literal>@embeddedId</literal> are scanned."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1149
+#, no-c-format
+msgid ""
+"You can override an access type for a property, but the element to annotate "
+"will not be influenced: for example an entity having access type "
+"<literal>field</literal>, can annotate a field with <literal>@AccessType"
+"(\"property\")</literal>, the access type will then be property for this "
+"attribute, the the annotations still have to be carried on the field."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1152
+#, no-c-format
+msgid ""
+"If a superclass or an embeddable object is not annotated, the root entity "
+"access type is used (even if an access type has been define on an "
+"intermediate superclass or embeddable object). The \"Matryoshka doll "
+"principle\" does not apply."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1156
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_61.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1160
+#, no-c-format
+msgid "Formula"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1161
+#, no-c-format
+msgid ""
+"Sometimes, you want the Database to do some computation for you rather than "
+"in the JVM, you might also create some kind of virtual column. You can use a "
+"SQL fragment (aka formula) instead of mapping a property into a column. This "
+"kind of property is read only (its value is calculated by your formula "
+"fragment)."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1165
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_62.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1166
+#, no-c-format
+msgid ""
+"The SQL fragment can be as complex as you want and even include subselects."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1172
+#, no-c-format
+msgid "Type"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1173
+#, no-c-format
+msgid ""
+"<literal>@org.hibernate.annotations.Type</literal> overrides the default "
+"Hibernate type used: this is generally not necessary since the type is "
+"correctly inferred by Hibernate. Please refer to the <citetitle>Hibernate "
+"Reference Guide</citetitle> for more information on the Hibernate types."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1176
+#, no-c-format
+msgid ""
+"<literal>@org.hibernate.annotations.TypeDef</literal> and <literal>@org."
+"hibernate.annotations.TypeDefs</literal> allows you to declare type "
+"definitions. These annotations are placed at the class or package level. "
+"Note that these definitions will be global for the session factory (even at "
+"the class level) and that type definition has to be defined before any usage."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1180
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_63.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1181
+#, no-c-format
+msgid ""
+"When using composite user type, you will have to express column definitions. "
+"The <literal>@Columns</literal> has been introduced for that purpose."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1185
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_64.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1189
+#, no-c-format
+msgid "Index"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1190
+#, no-c-format
+msgid ""
+"You can define an index on a particular column using the <literal>@Index</"
+"literal> annotation on a one column property, the columnNames attribute will "
+"then be ignored"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1194
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_65.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1198
+#, no-c-format
+msgid "@Parent"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1199
+#, no-c-format
+msgid ""
+"When inside an embeddable object, you can define one of the properties as a "
+"pointer back to the owner element."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1203
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_66.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1207
+#, no-c-format
+msgid "Generated properties"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1208
+#, no-c-format
+msgid ""
+"Some properties are generated at insert or update time by your database. "
+"Hibernate can deal with such properties and triggers a subsequent select to "
+"read these properties."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1212
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_67.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1213
+#, no-c-format
+msgid ""
+"Annotate your property as <literal>@Generated</literal>. You have to make "
+"sure your insertability or updatability does not conflict with the "
+"generation strategy you have chosen. When <literal>GenerationTime.INSERT</"
+"literal> is chosen, the property must not contains insertable columns, when "
+"<literal>GenerationTime.ALWAYS</literal> is chosen, the property must not "
+"contains insertable nor updatable columns."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1216
+#, no-c-format
+msgid ""
+"<literal>@Version</literal> properties cannot be <literal>@Generated(INSERT)"
+"</literal> by design, it has to be either <literal>NEVER</literal> or "
+"<literal>ALWAYS</literal>."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1222
+#, no-c-format
+msgid "@Target"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1223
+#, no-c-format
+msgid ""
+"Sometimes, the type guessed by reflection is not the one you want Hibernate "
+"to use. This is especially true of components when an interface is used. You "
+"can use <literal>@Target</literal> to bypass the reflection guessing "
+"mechanism (very much like the <literal>targetEntity</literal> attribute "
+"available on associations."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1227
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_68.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1231
+#, no-c-format
+msgid "Optimistic lock"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1232
+#, no-c-format
+msgid ""
+"It is sometimes useful to avoid increasing the version number even if a "
+"given property is dirty (particularly collections). You can do that by "
+"annotating the property (or collection) with <literal>@OptimisticLock"
+"(excluded=true)</literal>."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1235
+#, no-c-format
+msgid ""
+"More formally, it specifies that updates to this property do not require "
+"acquisition of the optimistic lock."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1243
+#, no-c-format
+msgid "Inheritance"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1244
+#, no-c-format
+msgid ""
+"<literal>SINGLE_TABLE</literal> is a very powerful strategy but sometimes, "
+"and especially for legacy systems, you cannot add an additional "
+"discriminator column. For that purpose, Hibernate has introduced the notion "
+"of discriminator formula: <literal>@DiscriminatorFormula</literal> is a "
+"replacement of <literal>@DiscriminatorColumn</literal> and use a SQL "
+"fragment as a formula for discriminator resolution (no need to have a "
+"dedicated column)."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1248
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_69.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1249
+#, no-c-format
+msgid ""
+"By default, when querying the top entities, Hibernate does not put a "
+"restriction clause on the discriminator column. This can be inconvenient if "
+"this column contains values not mapped in your hierarchy (through "
+"<literal>@DiscriminatorValue</literal>). To work around that you can use "
+"<literal>@ForceDiscriminator</literal> (at the class level, next to "
+"<literal>@DiscriminatorColumn</literal>). Hibernate will then list the "
+"available values when loading the entities."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1252
+#, no-c-format
+msgid ""
+"You can define the foreign key name generated by Hibernate for subclass "
+"tables in the JOINED inheritance strategy."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1256
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_70.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1257
+#, no-c-format
+msgid ""
+"The foreign key from the <literal>Document</literal> table to the "
+"<literal>File</literal> table will be named <literal>FK_DOCU_FILE</literal>."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1263
+#, no-c-format
+msgid "Single Association related annotations"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1264
+#, no-c-format
+msgid ""
+"By default, when Hibernate cannot resolve the association because the "
+"expected associated element is not in database (wrong id on the association "
+"column), an exception is raised by Hibernate. This might be inconvenient for "
+"legacy and badly maintained schemas. You can ask Hibernate to ignore such "
+"elements instead of raising an exception using the <literal>@NotFound</"
+"literal> annotation. This annotation can be used on a <literal>@OneToOne</"
+"literal> (with FK), <literal>@ManyToOne</literal>, <literal>@OneToMany</"
+"literal> or <literal>@ManyToMany</literal> association."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1268
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_71.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1269
+#, no-c-format
+msgid ""
+"Sometimes you want to delegate to your database the deletion of cascade when "
+"a given entity is deleted."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1273
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_72.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1274
+#, no-c-format
+msgid ""
+"In this case Hibernate generates a cascade delete constraint at the database "
+"level."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1277
+#, no-c-format
+msgid ""
+"Foreign key constraints, when generated by Hibernate, have a fairly "
+"unreadable name. You can override the constraint name by using "
+"<literal>@ForeignKey</literal>."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1281
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_73.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1283
+#, no-c-format
+msgid "Lazy options and fetching modes"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1284
+#, no-c-format
+msgid ""
+"EJB3 comes with the <literal>fetch</literal> option to define lazy loading "
+"and fetching modes, however Hibernate has a much greater option set in this "
+"area. To fine tune the lazy loading and fetching strategies, some additional "
+"annotations have been introduced:"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1288
+#, no-c-format
+msgid "@LazyToOne"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1289
+#, no-c-format
+msgid ""
+"defines the lazyness option on <literal>@ManyToOne</literal> and "
+"<literal>@OneToOne</literal> associations. <literal>LazyToOneOption</"
+"literal> can be <literal>PROXY</literal> (ie use a proxy based lazy "
+"loading), <literal>NO_PROXY</literal> (use a bytecode enhancement based lazy "
+"loading - note that build time bytecode processing is necessary) and "
+"<literal>FALSE</literal> (association not lazy)"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1290
+#, no-c-format
+msgid "@LazyCollection>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1291
+#, no-c-format
+msgid ""
+"defines the lazyness option on <literal>@ManyTo</literal>Many and "
+"<literal>@OneToMany</literal> associations. LazyCollectionOption can be "
+"<literal>TRUE</literal> (the collection is lazy and will be loaded when its "
+"state is accessed), <literal>EXTRA</literal> (the collection is lazy and all "
+"operations will try to avoid the collection loading, this is especially "
+"useful for huge collections when loading all the elements is not necessary) "
+"and FALSE (association not lazy)"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1292
+#, no-c-format
+msgid "@Fetch>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1293
+#, no-c-format
+msgid ""
+"defines the fetching strategy used to load the association. "
+"<literal>FetchMode</literal> can be <literal>SELECT</literal> (a select is "
+"triggered when the association needs to be loaded), <literal>SUBSELECT</"
+"literal> (only available for collections, use a subselect strategy - please "
+"refer to the <citetitle>Hibernate Reference Documentation</citetitle> for "
+"more information) or <literal>JOIN</literal> (use a SQL JOIN to load the "
+"association while loading the owner entity). <literal>JOIN</literal> "
+"overrides any lazy attribute (an association loaded through a <literal>JOIN</"
+"literal> strategy cannot be lazy)."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1295
+#, no-c-format
+msgid "The Hibernate annotations override the EJB3 fetching options."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1299
+#, no-c-format
+msgid "Lazy and fetch options equivalent"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:1303
+#, no-c-format
+msgid "Annotations"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:1306
+#, no-c-format
+msgid "Lazy"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:1309
+#, no-c-format
+msgid "Fetch"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:1316
+#, no-c-format
+msgid "@[One|Many]ToOne](fetch=FetchType.LAZY)"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:1319
+#, no-c-format
+msgid "@LazyToOne(PROXY)"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:1322 Entity_Beans.xml:1344
+#, no-c-format
+msgid "@Fetch(SELECT)"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:1327
+#, no-c-format
+msgid "@[One|Many]ToOne](fetch=FetchType.EAGER)"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:1330
+#, no-c-format
+msgid "@LazyToOne(FALSE)"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:1333 Entity_Beans.xml:1355
+#, no-c-format
+msgid "@Fetch(JOIN)"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:1338
+#, no-c-format
+msgid "@ManyTo[One|Many](fetch=FetchType.LAZY)"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:1341
+#, no-c-format
+msgid "@LazyCollection(TRUE)"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:1349
+#, no-c-format
+msgid "@ManyTo[One|Many](fetch=FetchType.EAGER)"
+msgstr ""
+
+#. Tag: entry
+#: Entity_Beans.xml:1352
+#, no-c-format
+msgid "@LazyCollection(FALSE)"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1365
+#, no-c-format
+msgid "@Any"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1366
+#, no-c-format
+msgid ""
+"The <classname>@Any</classname> annotation 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 ""
+
+#. Tag: para
+#: Entity_Beans.xml:1369
+#, no-c-format
+msgid ""
+"The @Any annotation describes the column holding the metadata information. "
+"To link the value of the metadata information and an actual entity type, The "
+"<classname>@AnyDef</classname> and <classname>@AnyDefs</classname> "
+"annotations are used."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1373
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_74.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1374
+#, no-c-format
+msgid ""
+"<methodname>idType</methodname> represents the target entities identifier "
+"property type and <methodname>metaType</methodname> the metadata type "
+"(usually String)."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1377
+#, no-c-format
+msgid ""
+"Note that <classname>@AnyDef</classname> can be mutualized and reused. It is "
+"recommended to place it as a package metadata in this case."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1381
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_75.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1387
+#, no-c-format
+msgid "Collection related annotations"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1389
+#, no-c-format
+msgid "Enhance collection settings"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1390
+#, no-c-format
+msgid "It is possible to set"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1394
+#, no-c-format
+msgid "the batch size for collections using @BatchSize"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1397
+#, no-c-format
+msgid ""
+"the where clause, using @Where (applied on the target entity) or "
+"@WhereJoinTable (applied on the association table)"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1400
+#, no-c-format
+msgid "the check clause, using @Check"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1403
+#, no-c-format
+msgid "the SQL order by clause, using @OrderBy"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1406
+#, no-c-format
+msgid ""
+"the delete cascade strategy through @OnDelete(action=OnDeleteAction.CASCADE)"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1409
+#, no-c-format
+msgid ""
+"the collection immutability using @Immutable: if set specifies that the "
+"elements of the collection never change (a minor performance optimization in "
+"some cases)"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1412
+#, no-c-format
+msgid ""
+"a custom collection persister (ie the persistence strategy used) using "
+"<literal>@Persister</literal>: the class must implement <classname>org."
+"hibernate.persister.collectionCollectionPersister</classname>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1418
+#, no-c-format
+msgid ""
+"You can also declare a sort comparator. Use the <literal>@Sort</literal> "
+"annotation. Expressing the comparator type you want between unsorted, "
+"natural or custom comparator. If you want to use your own comparator "
+"implementation, you'll also have to express the implementation class using "
+"the <literal>comparator</literal> attribute. Note that you need to use "
+"either a <classname>SortedSet</classname> or a <classname>SortedMap</"
+"classname> interface."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1422
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_76.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1423
+#, no-c-format
+msgid ""
+"Please refer to the previous descriptions of these annotations for more "
+"information."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1426
+#, no-c-format
+msgid ""
+"Foreign key constraints, while generated by Hibernate, have a fairly "
+"unreadable name. You can override the constraint name by use "
+"<literal>@ForeignKey</literal>. Note that this annotation has to be placed "
+"on the owning side of the relationship, <literal>inverseName</literal> "
+"referencing to the other side constraint."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1430
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_77.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1434
+#, no-c-format
+msgid "Extra collection types"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1436
+#, no-c-format
+msgid "List"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1437
+#, no-c-format
+msgid ""
+"Beyond EJB3, Hibernate Annotations supports true <classname>List</classname> "
+"and <classname>Array</classname>. Map your collection the same way as usual "
+"and add the @<literal>IndexColumn</literal>. This annotation allows you to "
+"describe the column that will hold the index. You can also declare the index "
+"value in DB that represent the first element (aka as base index). The usual "
+"value is <literal>0</literal> or <literal>1</literal>."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1441
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_78.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1443
+#, no-c-format
+msgid ""
+"If you forgot to set <literal>@IndexColumn</literal>, the bag semantic is "
+"applied. If you want the bag semantic without the limitations of it, "
+"consider using <literal>@CollectionId</literal>."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1450
+#, no-c-format
+msgid "<title>Map</title>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1451
+#, no-c-format
+msgid ""
+"Hibernate Annotations also supports true Map mappings. If <literal>@javax."
+"persistence.MapKey</literal> is not set, Hibernate will map the key element "
+"or embeddable object in its/their own columns. To overrides the default "
+"columns, you can use <literal>@org.hibernate.annotations.MapKey</literal> if "
+"your key is a basic type (defaulted to <literal>mapkey</literal>) or an "
+"embeddable object, or you can use <literal>@org.hibernate.annotations."
+"MapKeyManyToMany</literal> if your key is an entity."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1454
+#, no-c-format
+msgid ""
+"Both <literal>@org.hibernate.annotations.MapKey</literal> and <literal>@org."
+"hibernate.annotations.MapKeyManyToMany</literal> allow you to override the "
+"target element to be used. This is especially useful if your collection does "
+"not use generics (or if you use interfaces)."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1458
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_79.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1462
+#, no-c-format
+msgid "Bidirectional association with indexed collections"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1463
+#, no-c-format
+msgid ""
+"A bidirectional association where one end is an indexed collection (that is, "
+"represented as a <literal>@IndexColumn</literal>, <literal>@org.hibernate."
+"annotations.MapKey</literal> or <classname>@org.hibernate.annotations."
+"MapKeyManyToMany</classname>) requires special consideration. If a property "
+"on the associated class explicitly maps the indexed value, the use of "
+"<methodname>mappedBy</methodname> is permitted:"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1467
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_80.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1468
+#, 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: the index). "
+"In this case, we can't map the collection as <literal>mappedBy</literal>. "
+"Instead, we could use the following mapping:"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1472
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_81.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1473
+#, no-c-format
+msgid ""
+"Note that in this mapping, the collection-valued end of the association is "
+"responsible for updating the foreign key."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1479
+#, no-c-format
+msgid "Bag with primary key"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1480
+#, no-c-format
+msgid ""
+"Another interesting feature is the ability to define a surrogate primary key "
+"to a bag collection. This removes pretty much all of the drawbacks of bags: "
+"update and removal are efficient, more than one <literal>EAGER</literal> bag "
+"per query or per entity. This primary key will be contained in an additional "
+"column of your collection table but will not be visible to the Java "
+"application. @CollectionId is used to mark a collection as id bag, it also "
+"allow to override the primary key column(s), the primary key type and the "
+"generator strategy. The strategy can be <literal>identity</literal>, or any "
+"defined generator name of your application."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1484
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_82.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1488
+#, no-c-format
+msgid "Collection of element or composite elements"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1489
+#, no-c-format
+msgid ""
+"Hibernate Annotations also supports collections of core types (Integer, "
+"String, Enums, ...), collections of embeddable objects and even arrays of "
+"primitive types. This is known as collection of elements."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1492
+#, no-c-format
+msgid ""
+"A collection of elements has to be annotated as "
+"<literal>@CollectionOfElements</literal> (as a replacement of "
+"<literal>@OneToMany</literal>) To define the collection table, the "
+"<literal>@JoinTable</literal> annotation is used on the association "
+"property, <literal>joinColumns</literal> defines the join columns between "
+"the entity primary table and the collection table (inverseJoincolumn is "
+"useless and should be left empty). For collection of core types or array of "
+"primitive types, you can override the element column definition using a "
+"<literal>@Column</literal> on the association property. You can also "
+"override the columns of a collection of embeddable object using "
+"<literal>@AttributeOverride</literal>. To reach the collection element, you "
+"need to append \"element\" to the attribute override name (eg \"element\" "
+"for core types, or \"element.serial\" for the serial property of an "
+"embeddable element). To reach the index/key of a collection, append \"key\" "
+"instead."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1496
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_83.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1497
+#, no-c-format
+msgid ""
+"On a collection of embeddable objects, the embeddable object can have a "
+"property annotated with <literal>@Parent</literal>. This property will then "
+"point back to the entity containing the collection."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1501
+#, no-c-format
+msgid ""
+"Previous versions of Hibernate Annotations used the <literal>@OneToMany</"
+"literal> to mark a collection of elements. Due to semantic inconsistencies, "
+"we've introduced the annotation <literal>@CollectionOfElements</literal>. "
+"Marking collections of elements the old way still work but is considered "
+"deprecated and is going to be unsupported in future releases"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1508
+#, no-c-format
+msgid "@ManyToAny"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1509
+#, no-c-format
+msgid ""
+"<classname>@ManyToAny</classname> allows polymorphic associations 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 ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1513
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_84.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1514
+#, no-c-format
+msgid ""
+"Like <classname>@Any</classname>, <classname>@ManyToAny</classname> can use "
+"named <classname>@AnyDef</classname>s, see <xref linkend=\"sect-"
+"Hibernate_Annotations_Reference_Guide-Single_Association_related_annotations-"
+"Any\"/> for more information."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1524
+#, no-c-format
+msgid "Cascade"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1525
+#, no-c-format
+msgid ""
+"Hibernate offers more operations than the Java Persistence specification. "
+"You can use the <literal>@Cascade</literal> annotation to cascade the "
+"following operations:"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1531
+#, no-c-format
+msgid "PERSIST"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1536
+#, no-c-format
+msgid "MERGE"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1541
+#, no-c-format
+msgid "REMOVE"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1546
+#, no-c-format
+msgid "REFRESH"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1551
+#, no-c-format
+msgid "DELETE"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1556
+#, no-c-format
+msgid "SAVE_UPDATE"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1561
+#, no-c-format
+msgid "REPLICATE"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1566
+#, no-c-format
+msgid "DELETE_ORPHAN"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1571
+#, no-c-format
+msgid "LOCK"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1576
+#, no-c-format
+msgid "EVICT"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1580
+#, no-c-format
+msgid ""
+"This is especially useful for <literal>SAVE_UPDATE</literal> (which is the "
+"operation cascaded at flush time if you use plain Hibernate Annotations - "
+"Hibernate EntityManager cascade <literal>PERSIST</literal> at flush time as "
+"per the specification). <literal>DELETE_ORPHAN</literal> applies only to "
+"<literal>@OneToMany</literal> associations, and indicates that the "
+"<methodname>delete()/remove()</methodname> operation should be applied to "
+"any child object that is removed from the association. In other words, if a "
+"child is dereferenced by a persistent parent and if <literal>DELETE_ORPHAN</"
+"literal> is used, the \"orphaned\" child is deleted."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1584
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_85.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1585
+#, no-c-format
+msgid ""
+"It is recommended to use @Cascade to compliment @*To*(cascade=...) as shown "
+"in the previous example."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1591
+#, no-c-format
+msgid "Cache"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1592
+#, no-c-format
+msgid ""
+"In order to optimize your database accesses, you can activate the so-called "
+"second level cache of Hibernate. This cache is configurable on a per-entity "
+"and per-collection basis."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1595
+#, no-c-format
+msgid ""
+"<literal>@org.hibernate.annotations.Cache</literal> defines the caching "
+"strategy and region of a given second level cache. This annotation can be "
+"applied on the root entity (not the sub entities), and on the collections."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1599
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_86.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1601
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_87.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1603
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_88.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1604
+#, no-c-format
+msgid "Notes:"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1606
+#, no-c-format
+msgid ""
+"usage: the given cache concurrency strategy (NONE, READ_ONLY, "
+"NONSTRICT_READ_WRITE, READ_WRITE, TRANSACTIONAL)"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1611
+#, no-c-format
+msgid ""
+"region (optional): the cache region (default to the fqcn of the class or the "
+"fq role name of the collection)"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1616
+#, no-c-format
+msgid ""
+"<literal>include</literal> (optional): all to include all properties, non-"
+"lazy to only include non lazy properties (default all)."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1626
+#, no-c-format
+msgid "Filters"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1627
+#, no-c-format
+msgid ""
+"Hibernate has the ability to apply arbitrary filters on top of your data. "
+"Those filters are applied at runtime on a given session. First, you need to "
+"define them."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1630
+#, no-c-format
+msgid ""
+"<literal>@org.hibernate.annotations.FilterDef</literal> or "
+"<literal>@FilterDefs</literal> define filter definition(s) used by filter(s) "
+"using the same name. A filter definition has a name() and an array of "
+"parameters(). A parameter will allow you to adjust the behavior of the "
+"filter at runtime. Each parameter is defined by a <literal>@ParamDef</"
+"literal> which has a name and a type. You can also define a defaultCondition"
+"() parameter for a given <literal>@FilterDef</literal> to set the default "
+"condition to use when none are defined in each individual <literal>@Filter</"
+"literal>. A <literal>@FilterDef</literal>(s) can be defined at the class or "
+"package level."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1633
+#, no-c-format
+msgid ""
+"We now need to define the SQL filter clause applied to either the entity "
+"load or the collection load. <literal>@Filter</literal> is used and placed "
+"either on the entity or the collection element"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1638
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_89.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1640
+#, no-c-format
+msgid ""
+"When the collection uses an association table as a relational "
+"representation, you might want to apply the filter condition to the "
+"association table itself or to the target entity table. To apply the "
+"constraint on the target entity, use the regular <literal>@Filter</literal> "
+"annotation. However, if you want to target the association table, use the "
+"<literal>@FilterJoinTable</literal> annotation."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1644
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_90.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1648
+#, no-c-format
+msgid "Queries"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1649
+#, no-c-format
+msgid ""
+"Since Hibernate has more features on named queries than the one defined in "
+"the EJB3 specification, <literal>@org.hibernate.annotations.NamedQuery</"
+"literal>, <literal>@org.hibernate.annotations.NamedQueries</literal>, "
+"<literal>@org.hibernate.annotations.NamedNativeQuery</literal> and "
+"<literal>@org.hibernate.annotations.NamedNativeQueries</literal> have been "
+"introduced. They add attributes to the standard version and can be used as a "
+"replacement:"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1653
+#, no-c-format
+msgid "flushMode"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1654
+#, no-c-format
+msgid ""
+"defines the query flush mode (<literal>Always</literal>, <literal>Auto</"
+"literal>, <literal>Commit</literal> or <literal>Manual</literal>)"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1655
+#, no-c-format
+msgid "cacheable"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1656
+#, no-c-format
+msgid "whether the query should be cached or not"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1657
+#, no-c-format
+msgid "cacheRegion"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1658
+#, no-c-format
+msgid "cache region used if the query is cached"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1659
+#, no-c-format
+msgid "fetchSize"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1660
+#, no-c-format
+msgid "JDBC statement fetch size for this query"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1661
+#, no-c-format
+msgid "timeout"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1662
+#, no-c-format
+msgid "query time out"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1663
+#, no-c-format
+msgid "callable"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1664
+#, no-c-format
+msgid "for native queries only, to be set to true for stored procedures"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1665
+#, no-c-format
+msgid "comment"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1666
+#, no-c-format
+msgid ""
+"if comments are activated, the comment seen when the query is sent to the "
+"database."
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1667
+#, no-c-format
+msgid "cacheMode"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1668
+#, no-c-format
+msgid ""
+"Cache interaction mode (<literal>get</literal>, <literal>ignore</literal>, "
+"<literal>normal</literal>, <literal>put</literal> or <literal>refresh</"
+"literal>)"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1669
+#, no-c-format
+msgid "readOnly"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1670
+#, no-c-format
+msgid ""
+"whether or not the elements retrievent from the query are in read-only mode."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1672
+#, no-c-format
+msgid ""
+"Those hints can be set in a standard <literal>@javax.persistence.NamedQuery</"
+"literal> annotations through the detyped <literal>@QueryHint</literal>. "
+"Another key advantage is the ability to set those annotations at a package "
+"level."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1678
+#, no-c-format
+msgid "Custom SQL for CRUD operations"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1679
+#, no-c-format
+msgid ""
+"Hibernate gives you the ability to override every single SQL statement "
+"generated. We have seen native SQL query usage already, but you can also "
+"override the SQL statement used to load or change the state of entities."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1683
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_91.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1684
+#, no-c-format
+msgid ""
+"<literal>@SQLInsert</literal>, <literal>@SQLUpdate</literal>, "
+"<literal>@SQLDelete</literal>, <literal>@SQLDeleteAll</literal> respectively "
+"override the <literal>INSERT</literal> statement, <literal>UPDATE</literal> "
+"statement, <literal>DELETE</literal> statement, <literal>DELETE</literal> "
+"statement to remove all entities."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1687
+#, no-c-format
+msgid ""
+"If you expect to call a store procedure, be sure to set the "
+"<literal>callable</literal> attribute to true (<literal>@SQLInsert"
+"(callable=true, ...)</literal>)."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1690
+#, no-c-format
+msgid ""
+"To check that the execution happens correctly, Hibernate allows you to "
+"define one of those three strategies:"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1694
+#, no-c-format
+msgid "NONE"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1695
+#, no-c-format
+msgid ""
+"no check is performed: the store procedure is expected to fail upon issues"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1696
+#, no-c-format
+msgid "COUNT"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1697
+#, no-c-format
+msgid "use of rowcount to check that the update is successful"
+msgstr ""
+
+#. Tag: literal
+#: Entity_Beans.xml:1698
+#, no-c-format
+msgid "PARAM"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1699
+#, no-c-format
+msgid ""
+"like <literal>COUNT</literal> but using an output parameter rather that the "
+"standard mechanism"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1701
+#, no-c-format
+msgid ""
+"To define the result check style, use the <literal>check</literal> parameter "
+"(<literal>@SQLUpdate(check=ResultCheckStyle.COUNT, ...)</literal>)."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1704
+#, no-c-format
+msgid ""
+"You can also override the SQL load statement by a native SQL query or a HQL "
+"query. You just have to refer to a named query with the "
+"<literal><literal>@Loader</literal></literal> annotation."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1707
+#, no-c-format
+msgid ""
+"You can use the exact same set of annotations to override the collection "
+"related statements."
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1711
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_92.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1712
+#, no-c-format
+msgid ""
+"The order of the parameters is important and is defined by the order "
+"Hibernate handles properties. 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 not to include your custom SQL through annotations as "
+"that will override the Hibernate-generated static sql.)"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1715
+#, no-c-format
+msgid ""
+"Overriding SQL statements for secondary tables is also possible using "
+"<literal>@org.hibernate.annotations.Table</literal> and either (or all) "
+"attributes <literal>sqlInsert</literal>, <literal>sqlUpdate</literal>, "
+"<literal>sqlDelete</literal>:"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1719
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_93.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1720
+#, no-c-format
+msgid ""
+"The previous example also show that you can give a comment to a given table "
+"(primary or secondary): This comment will be used for DDL generation."
+msgstr ""
+
+#. Tag: title
+#: Entity_Beans.xml:1726
+#, no-c-format
+msgid "Tuplizer"
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1727
+#, no-c-format
+msgid ""
+"<classname>org.hibernate.tuple.Tuplizer</classname>, 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 corresponding 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 <classname>org.hibernate.tuple.EntityTuplizer</classname> "
+"and <classname>org.hibernate.tuple.ComponentTuplizer</classname> interfaces. "
+"EntityTuplizers are responsible for managing the above mentioned contracts "
+"in regards to entities, while <classname>ComponentTuplizers</classname> do "
+"the same for components. Check the <citetitle>Hibernate Reference "
+"Documentation</citetitle> for more information."
+msgstr ""
+
+#. Tag: para
+#: Entity_Beans.xml:1730
+#, no-c-format
+msgid ""
+"To define tuplixer in annotations, simply use the <literal>@Tuplizer</"
+"literal> annotation on the according element"
+msgstr ""
+
+#. Tag: programlisting
+#: Entity_Beans.xml:1734
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_94.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
Added: projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Feedback.pot
===================================================================
--- projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Feedback.pot (rev 0)
+++ projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Feedback.pot 2009-01-04 22:25:48 UTC (rev 82591)
@@ -0,0 +1,35 @@
+# SOME DESCRIPTIVE TITLE.
+# FIRST AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2009-01-04 22:24+0000\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
+"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-xml2pot; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#: Feedback.xml:7
+#, no-c-format
+msgid "Feedback"
+msgstr ""
+
+#. Tag: para
+#: Feedback.xml:8
+#, no-c-format
+msgid ""
+"If you spot a typo in this guide, or if you have thought of a way to make "
+"this manual better, we would love to hear from you! Submit a report in "
+"<ulink url=\"http://jira.jboss.com/jira/browse/JBPAPP\">JIRA</ulink> against "
+"the Product: JBoss Enterprise Application Platform, Version: "
+"<replaceable><version></replaceable>, Component: <emphasis>Doc</"
+"emphasis>. If you have a suggestion for improving the documentation, try to "
+"be as specific as possible. If you have found an error, include the section "
+"number and some of the surrounding text so we can find it easily."
+msgstr ""
Added: projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Hibernate_Annotations_Reference_Guide_CP03_FP01.pot
===================================================================
Added: projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Introduction.pot
===================================================================
--- projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Introduction.pot (rev 0)
+++ projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Introduction.pot 2009-01-04 22:25:48 UTC (rev 82591)
@@ -0,0 +1,78 @@
+# SOME DESCRIPTIVE TITLE.
+# FIRST AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2009-01-04 22:24+0000\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
+"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-xml2pot; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#: Introduction.xml:6
+#, no-c-format
+msgid "Introduction"
+msgstr ""
+
+#. Tag: para
+#: Introduction.xml:8
+#, no-c-format
+msgid ""
+"Hibernate, like all other object/relational mapping tools, requires metadata "
+"that governs the transformation of data from one representation to the other "
+"(and vice versa). In Hibernate 2.x, mapping metadata is most of the time "
+"declared in XML text files. Another option is XDoclet, utilizing Javadoc "
+"source code annotations and a preprocessor at compile time. The same kind of "
+"annotation support is now available in the standard JDK, although more "
+"powerful and better supported by tools. IntelliJ IDEA, and Eclipse for "
+"example, support auto-completion and syntax highlighting of JDK 5.0 "
+"annotations. Annotations are compiled into the bytecode and read at runtime "
+"(in Hibernate's case on startup) using reflection, so no external XML files "
+"are needed."
+msgstr ""
+
+#. Tag: para
+#: Introduction.xml:11
+#, no-c-format
+msgid ""
+"The EJB3 specification recognizes the interest in and the success of the "
+"transparent object/relational mapping paradigm. The EJB3 specification "
+"standardizes the basic APIs and the metadata needed for any object/"
+"relational persistence mechanism. Hibernate EntityManager implements the "
+"programming interfaces and lifecycle rules as defined by the EJB3 "
+"persistence specification. Together with Hibernate Annotations, this wrapper "
+"implements a complete (and standalone) EJB3 persistence solution on top of "
+"the mature Hibernate core. You may use a combination of all three together, "
+"annotations without EJB3 programming interfaces and lifecycle, or even pure "
+"native Hibernate, depending on the business and technical needs of your "
+"project. You can at all times fall back to Hibernate native APIs, or if "
+"required, even to native JDBC and SQL."
+msgstr ""
+
+#. Tag: para
+#: Introduction.xml:14
+#, no-c-format
+msgid ""
+"This release is based on the final release of the EJB 3.0 / JPA "
+"specification (aka JSP-220) and support all the specification features "
+"(including the optional ones). Most of the Hibernate features and extensions "
+"are also available through Hibernate-specific annotations compared to the "
+"specification are also available. While the Hibernate feature coverage is "
+"now very high, some are still missing. The eventual goal is to cover all of "
+"them. See the JIRA road map section for more information."
+msgstr ""
+
+#. Tag: para
+#: Introduction.xml:17
+#, no-c-format
+msgid ""
+"If you are moving from previous Hibernate Annotations versions, please have "
+"a look at <ulink url=\"http://www.hibernate.org/398.html\">Java Persistence "
+"migration guide</ulink>."
+msgstr ""
Added: projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Overriding_metadata_through_XML.pot
===================================================================
--- projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Overriding_metadata_through_XML.pot (rev 0)
+++ projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Overriding_metadata_through_XML.pot 2009-01-04 22:25:48 UTC (rev 82591)
@@ -0,0 +1,403 @@
+# SOME DESCRIPTIVE TITLE.
+# FIRST AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2009-01-04 22:24+0000\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
+"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-xml2pot; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#: Overriding_metadata_through_XML.xml:6
+#, no-c-format
+msgid "Overriding metadata through XML"
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:7
+#, no-c-format
+msgid ""
+"The primary target for metadata in EJB3 is annotations, but the EJB3 "
+"specification provides a way to override or replace the annotation-defined "
+"metadata through an XML deployment descriptor. In the current release only "
+"pure EJB3 annotations overriding are supported. If you wish to use Hibernate-"
+"specific features in some entities, you'll have to either use annotations or "
+"fallback to hbm files. You can of course mix and match annotated entities "
+"and entities described in hbm files."
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:10
+#, no-c-format
+msgid "The unit test suite shows some additional XML file samples."
+msgstr ""
+
+#. Tag: title
+#: Overriding_metadata_through_XML.xml:14
+#, no-c-format
+msgid "Principles"
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:15
+#, no-c-format
+msgid ""
+"The XML deployment descriptor structure has been designed to reflect the "
+"annotations one. So if you know the annotations structure, using the XML "
+"schema will be straightforward for you."
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:18
+#, no-c-format
+msgid ""
+"You can define one or more XML files describing your metadata, these files "
+"will be merged by the overriding engine."
+msgstr ""
+
+#. Tag: title
+#: Overriding_metadata_through_XML.xml:22
+#, no-c-format
+msgid "Global level metadata"
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:23
+#, no-c-format
+msgid ""
+"You can define global level metadata available for all XML files. You must "
+"not define these metadata more than once per deployment."
+msgstr ""
+
+#. Tag: programlisting
+#: Overriding_metadata_through_XML.xml:27
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_95.xmlt\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:28
+#, no-c-format
+msgid ""
+"<literal>xml-mapping-metadata-complete</literal> means that all entity, "
+"mapped-superclasses and embeddable metadata should be picked up from XML "
+"(that is, ignore annotations)."
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:31
+#, no-c-format
+msgid ""
+"<literal>schema / catalog</literal> will override all default definitions of "
+"schema and catalog in the metadata (both XML and annotations)."
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:34
+#, no-c-format
+msgid ""
+"<literal>cascade-persist</literal> means that all associations have PERSIST "
+"as a cascade type. We recommend you to not use this feature."
+msgstr ""
+
+#. Tag: title
+#: Overriding_metadata_through_XML.xml:40
+#, no-c-format
+msgid "Entity level metadata"
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:41
+#, no-c-format
+msgid ""
+"You can either define or override metadata information on a given entity."
+msgstr ""
+
+#. Tag: programlisting
+#: Overriding_metadata_through_XML.xml:45
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_96.xmlt\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: title
+#: Overriding_metadata_through_XML.xml:46
+#: Overriding_metadata_through_XML.xml:116
+#, no-c-format
+msgid "Notes"
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:48
+#, no-c-format
+msgid ""
+"<literal>entity-mappings</literal>: entity-mappings is the root element for "
+"all XML files. You must declare the xml schema, the schema file is included "
+"in the <filename>hibernate-annotations.jar</filename> file, no Internet "
+"access will be processed by Hibernate Annotations."
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:53
+#, no-c-format
+msgid ""
+"<literal>package</literal> (optional): default package used for all non "
+"qualified class names in the given deployment descriptor file."
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:58
+#, no-c-format
+msgid "<literal>entity</literal>: describes an entity."
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:61
+#, no-c-format
+msgid ""
+"<literal>metadata-complete</literal> defines whether the metadata "
+"description for this element is complete or not (in other words, if "
+"annotations present at the class level should be considered or not)."
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:64
+#, no-c-format
+msgid ""
+"An entity has to have a <literal>class</literal> attribute referring to the "
+"java class the metadata applies on."
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:67
+#, no-c-format
+msgid ""
+"You can overrides entity name through the <literal>name</literal> attribute, "
+"if none is defined and if an <literal>@Entity.name</literal> is present, "
+"then it is used (provided that metadata complete is not set)."
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:70
+#, no-c-format
+msgid ""
+"For metadata complete (see below) element, you can define an "
+"<literal>access</literal> (either <literal>FIELD</literal> or "
+"<literal>PROPERTY</literal> (default)). For non metadata complete element, "
+"if <literal>access</literal> is not defined, the @Id position will lead "
+"position, if <literal>access</literal> is defined, the value is used."
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:75
+#, no-c-format
+msgid ""
+"<literal>table</literal>: you can declare table properties (name, schema, "
+"catalog), if none is defined, the java annotation is used."
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:78
+#, no-c-format
+msgid "You can define one or several unique constraints as seen in the example"
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:83
+#, no-c-format
+msgid ""
+"<literal>secondary-table</literal>: defines a secondary table very much like "
+"a regular table except that you can define the primary key / foreign key "
+"column(s) through the <literal>primary-key-join-column</literal> element. On "
+"non metadata complete, annotation secondary tables are used only if there is "
+"no <literal>secondary-table</literal> definition, annotations are ignored "
+"otherwise."
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:88
+#, no-c-format
+msgid ""
+"<literal>id-class</literal>: defines the id class in a similar way "
+"<literal>@IdClass</literal> does"
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:93
+#, no-c-format
+msgid ""
+"<literal>inheritance</literal>: defines the inheritance strategy "
+"(<literal>JOINED</literal>, <literal>TABLE_PER_CLASS</literal>, "
+"<literal>SINGLE_TABLE</literal>), Available only at the root entity level"
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:98
+#, no-c-format
+msgid "<literal>sequence-generator</literal>: defines a sequence generator"
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:103
+#, no-c-format
+msgid "<literal>table-generator</literal>: defines a table generator"
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:108
+#, no-c-format
+msgid ""
+"<literal><literal>primary-key-join-column</literal></literal>: defines the "
+"primary key join column for sub entities when JOINED inheritance strategy is "
+"used"
+msgstr ""
+
+#. Tag: programlisting
+#: Overriding_metadata_through_XML.xml:115
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_97.xmlt\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:118
+#, no-c-format
+msgid ""
+"<literal>discriminator-value / discriminator-column</literal>: defines the "
+"discriminator value and the column holding it when the SINGLE_TABLE "
+"inheritance strategy is chosen"
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:123
+#, no-c-format
+msgid ""
+"<literal>named-query</literal>: defines named queries and possibly the hints "
+"associated to them. Those definitions are additive to the one defined in "
+"annotations, if two definitions have the same name, the XML one has priority."
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:128
+#, no-c-format
+msgid ""
+"<literal>named-native-query</literal>: defines an named native query and its "
+"sql result set mapping. Alternatively, you can define the <literal>result-"
+"class</literal>. Those definitions are additive to the one defined in "
+"annotations, if two definitions have the same name, the XML one has priority."
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:133
+#, no-c-format
+msgid ""
+"<literal>sql-result-set-mapping</literal>: describes the result set mapping "
+"structure. You can define both entity and column mappings. Those definitions "
+"are additive to the one defined in annotations, if two definitions have the "
+"same name, the XML one has priority"
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:138
+#, no-c-format
+msgid ""
+"<literal>attribute-override / association-override</literal>: defines a "
+"column or join column overriding. This overriding is additive to the one "
+"defined in annotations"
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:145
+#, no-c-format
+msgid ""
+"Same applies for <literal><embeddable></literal> and <literal><"
+"mapped-superclass></literal>."
+msgstr ""
+
+#. Tag: title
+#: Overriding_metadata_through_XML.xml:151
+#, no-c-format
+msgid "Property level metadata"
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:152
+#, no-c-format
+msgid ""
+"You can of course define XML overriding for properties. If metadata complete "
+"is defined, then additional properties (ie at the Java level) will be "
+"ignored. Otherwise, once you start overriding a property, all annotations on "
+"the given property are ignored. All property level metadata behave in "
+"<literal>entity/attributes</literal>, <literal>mapped-superclass/attributes</"
+"literal> or <literal>embeddable/attributes</literal>."
+msgstr ""
+
+#. Tag: programlisting
+#: Overriding_metadata_through_XML.xml:156
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_98.xmlt\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:157
+#, no-c-format
+msgid ""
+"You can override a property through <literal>id</literal>, <literal>embedded-"
+"id</literal>, <literal>version</literal>, <literal>embedded</literal> and "
+"<literal>basic</literal>. Each of these elements can have sub-elements "
+"accordingly: <literal>lob</literal>, <literal>temporal</literal>, "
+"<literal>enumerated</literal>, <literal>column</literal>."
+msgstr ""
+
+#. Tag: title
+#: Overriding_metadata_through_XML.xml:163
+#, no-c-format
+msgid "Association level metadata"
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:164
+#, no-c-format
+msgid ""
+"You can define XML overriding for associations. All association level "
+"metadata behave in <literal>entity/attributes</literal>, <literal>mapped-"
+"superclass/attributes</literal> or <literal>embeddable/attributes</literal>."
+msgstr ""
+
+#. Tag: programlisting
+#: Overriding_metadata_through_XML.xml:168
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_99.xmlt\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Overriding_metadata_through_XML.xml:169
+#, no-c-format
+msgid ""
+"You can override an association through <literal>one-to-many</literal>, "
+"<literal>one-to-one</literal>, <literal>many-to-one</literal>, and "
+"<literal>many-to-many</literal>. Each of these elements can have sub-"
+"elements accordingly: <literal>join-table</literal> (which can have "
+"<literal>join-column</literal>s and <literal>inverse-join-column</"
+"literal>s), <literal><literal>join-column</literal>s</literal>, <literal>map-"
+"key</literal>, and <literal>order-by</literal>. <literal>mapped-by</literal> "
+"and <literal>target-entity</literal> can be defined as attributes when it "
+"makes sense. Once again the structure is reflects the annotations structure. "
+"You can find all semantic information in <xref linkend=\"chap-"
+"Hibernate_Annotations_Reference_Guide-Entity_Beans\"/>."
+msgstr ""
Added: projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Preface.pot
===================================================================
--- projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Preface.pot (rev 0)
+++ projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Preface.pot 2009-01-04 22:25:48 UTC (rev 82591)
@@ -0,0 +1,21 @@
+# SOME DESCRIPTIVE TITLE.
+# FIRST AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2009-01-04 22:24+0000\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
+"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-xml2pot; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#: Preface.xml:6
+#, no-c-format
+msgid "Preface"
+msgstr ""
Added: projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Revision_History.pot
===================================================================
--- projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Revision_History.pot (rev 0)
+++ projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Revision_History.pot 2009-01-04 22:25:48 UTC (rev 82591)
@@ -0,0 +1,34 @@
+# SOME DESCRIPTIVE TITLE.
+# FIRST AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2009-01-04 22:24+0000\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
+"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-xml2pot; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#: Revision_History.xml:6
+#, no-c-format
+msgid "Revision History"
+msgstr ""
+
+#. Tag: author
+#: Revision_History.xml:12
+#, no-c-format
+msgid ""
+"<firstname>Rüdiger</firstname> <surname>Landmann</surname> <email></email>"
+msgstr ""
+
+#. Tag: member
+#: Revision_History.xml:19
+#, no-c-format
+msgid "Initial release"
+msgstr ""
Added: projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Setting_up_an_annotations_project.pot
===================================================================
--- projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Setting_up_an_annotations_project.pot (rev 0)
+++ projects/docs/enterprise/4.3.3.1/Hibernate/Hibernate_Annotations_Reference_Guide/pot/Setting_up_an_annotations_project.pot 2009-01-04 22:25:48 UTC (rev 82591)
@@ -0,0 +1,235 @@
+# SOME DESCRIPTIVE TITLE.
+# FIRST AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
+"POT-Creation-Date: 2009-01-04 22:24+0000\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
+"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-xml2pot; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#: Setting_up_an_annotations_project.xml:6
+#, no-c-format
+msgid "Setting up an annotations project"
+msgstr ""
+
+#. Tag: title
+#: Setting_up_an_annotations_project.xml:8
+#, no-c-format
+msgid "Requirements"
+msgstr ""
+
+#. Tag: para
+#: Setting_up_an_annotations_project.xml:11
+#, no-c-format
+msgid ""
+"Download and unpack the Hibernate Annotations distribution from the "
+"Hibernate website."
+msgstr ""
+
+#. Tag: emphasis
+#: Setting_up_an_annotations_project.xml:17
+#, no-c-format
+msgid "This release requires Hibernate Core 3.2.0.GA and above."
+msgstr ""
+
+#. Tag: para
+#: Setting_up_an_annotations_project.xml:21
+#, no-c-format
+msgid "This release is known to work on Hibernate Core 3.2.0 up to 3.2.2.GA"
+msgstr ""
+
+#. Tag: para
+#: Setting_up_an_annotations_project.xml:26
+#, no-c-format
+msgid ""
+"Make sure you have JDK 5.0 installed or above. You can of course continue "
+"using XDoclet and get some of the benefits of annotation-based metadata with "
+"older JDK versions. Note that this document only describes JDK 5.0 "
+"annotations and you have to refer to the XDoclet documentation for more "
+"information."
+msgstr ""
+
+#. Tag: title
+#: Setting_up_an_annotations_project.xml:34
+#, no-c-format
+msgid "Configuration"
+msgstr ""
+
+#. Tag: para
+#: Setting_up_an_annotations_project.xml:35
+#, no-c-format
+msgid ""
+"First, set up your classpath (after you have created a new project in your "
+"favorite IDE):"
+msgstr ""
+
+#. Tag: para
+#: Setting_up_an_annotations_project.xml:39
+#, no-c-format
+msgid ""
+"Copy all Hibernate3 core and required 3rd party library files (see lib/"
+"README.txt in Hibernate)."
+msgstr ""
+
+#. Tag: para
+#: Setting_up_an_annotations_project.xml:44
+#, no-c-format
+msgid ""
+"Copy <filename>hibernate-annotations.jar</filename>, <filename>lib/hibernate-"
+"comons-annotations.jar</filename> and <filename>lib/ejb3-persistence.jar</"
+"filename> from the Hibernate Annotations distribution to your classpath as "
+"well."
+msgstr ""
+
+#. Tag: para
+#: Setting_up_an_annotations_project.xml:50
+#, no-c-format
+msgid ""
+"If you wish to use Hibernate Validator, download it from the Hibernate "
+"website and add <filename>hibernate-validator.jar</filename> in your "
+"classpath."
+msgstr ""
+
+#. Tag: para
+#: Setting_up_an_annotations_project.xml:53
+#, no-c-format
+msgid ""
+"If you wish to use Hibernate Search, download it from the Hibernate website "
+"and add <filename>hibernate-search.jar</filename> and <filename>lucene-core-"
+"x.y.z.jar</filename> in your classpath."
+msgstr ""
+
+#. Tag: para
+#: Setting_up_an_annotations_project.xml:56
+#, no-c-format
+msgid ""
+"We also recommend a small wrapper class to startup Hibernate in a static "
+"initializer block, known as <classname>HibernateUtil</classname>. You might "
+"have seen this class in various forms in other areas of the Hibernate "
+"documentation. For Annotation support you have to enhance this helper class "
+"as follows:"
+msgstr ""
+
+#. Tag: programlisting
+#: Setting_up_an_annotations_project.xml:58
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_1.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Setting_up_an_annotations_project.xml:60
+#, no-c-format
+msgid ""
+"Interesting here is the use of <classname>AnnotationConfiguration</"
+"classname>. The packages and annotated classes are declared in your regular "
+"XML configuration file (usually <filename>hibernate.cfg.xml</filename>). "
+"Here is the equivalent of the above declaration:"
+msgstr ""
+
+#. Tag: programlisting
+#: Setting_up_an_annotations_project.xml:64
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_2.xmlt\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Setting_up_an_annotations_project.xml:65
+#, no-c-format
+msgid ""
+"Note that you can mix the hbm.xml use and the new annotation one. The "
+"resource element can be either an hbm file or an EJB3 XML deployment "
+"descriptor. The distinction is transparent for your configuration process."
+msgstr ""
+
+#. Tag: para
+#: Setting_up_an_annotations_project.xml:68
+#, no-c-format
+msgid ""
+"Alternatively, you can define the annotated classes and packages using the "
+"programmatic API"
+msgstr ""
+
+#. Tag: programlisting
+#: Setting_up_an_annotations_project.xml:72
+#, no-c-format
+msgid ""
+"<xi:include href=\"extras/Code_Example_3.java\" parse=\"text\" xmlns:xi="
+"\"http://www.w3.org/2001/XInclude\"></xi:include>"
+msgstr ""
+
+#. Tag: para
+#: Setting_up_an_annotations_project.xml:73
+#, no-c-format
+msgid ""
+"You can also use the Hibernate EntityManager which has its own configuration "
+"mechanism. Please refer to this project documentation for more details."
+msgstr ""
+
+#. Tag: para
+#: Setting_up_an_annotations_project.xml:76
+#, no-c-format
+msgid ""
+"There is no other difference in the way you use Hibernate APIs with "
+"annotations, except for this startup routine change or in the configuration "
+"file. You can use your favorite configuration method for other properties "
+"( <filename>hibernate.properties</filename>, <filename>hibernate.cfg.xml</"
+"filename>, programmatic APIs, etc). You can even mix annotated persistent "
+"classes and classic <filename>hbm.cfg.xml</filename> declarations with the "
+"same <classname>SessionFactory</classname>. You can however not declare a "
+"class several times (whether annotated or through hbm.xml). You cannot mix "
+"configuration strategies (hbm vs annotations) in a mapped entity hierarchy "
+"either."
+msgstr ""
+
+#. Tag: para
+#: Setting_up_an_annotations_project.xml:79
+#, no-c-format
+msgid ""
+"To ease the migration process from hbm files to annotations, the "
+"configuration mechanism detects the mapping duplication between annotations "
+"and hbm files. HBM files are then prioritized over annotated metadata on a "
+"class to class basis. You can change the priority using <literal>hibernate."
+"mapping.precedence</literal> property. The default is <literal>hbm, class</"
+"literal>, changing it to <literal>class, hbm</literal> will prioritize the "
+"annotated classes over hbm files when a conflict occurs."
+msgstr ""
+
+#. Tag: title
+#: Setting_up_an_annotations_project.xml:85
+#, no-c-format
+msgid "Properties"
+msgstr ""
+
+#. Tag: para
+#: Setting_up_an_annotations_project.xml:86
+#, no-c-format
+msgid ""
+"Aside from the Hibernate core properties, Hibernate Annotations reacts to "
+"the following one:"
+msgstr ""
+
+#. Tag: filename
+#: Setting_up_an_annotations_project.xml:91
+#, no-c-format
+msgid "hibernate.validator.apply_to_ddl"
+msgstr ""
+
+#. Tag: para
+#: Setting_up_an_annotations_project.xml:93
+#, no-c-format
+msgid ""
+"Use Hibernate Validator annotations to refine the database schema "
+"generation. Default to true."
+msgstr ""
More information about the jboss-cvs-commits
mailing list