hibernate-commits February 2010

hibernate-commits@lists.jboss.org

1 participants
236 discussions

Hibernate SVN: r18719 - in core/branches/Branch_3_3/documentation/manual/src/main/docbook: de-DE and 2 other directories.

by hibernate-commits＠lists.jboss.org

Author: stliu Date: 2010-02-08 00:11:36 -0500 (Mon, 08 Feb 2010) New Revision: 18719 Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/Author_Group.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/Book_Info.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/Feedback.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/Hibernate_Core_Reference_Guide.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/Revision_History.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/Preface.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/architecture.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/association_mapping.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/basic_mapping.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/batch.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/best_practices.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/collection_mapping.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/component_mapping.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/configuration.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/events.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/example_mappings.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/example_parentchild.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/example_weblog.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/filters.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/inheritance_mapping.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/performance.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/persistent_classes.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/portability.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/query_criteria.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/query_hql.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/query_sql.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/session_api.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/toolset_guide.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/transactions.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/tutorial.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/xml.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/fallback_content/ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/fallback_content/Conventions.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/fallback_content/Feedback.po core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/fallback_content/Legal_Notice.po Log: HHH-4729 Import work done by Red Hat translation team Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/Author_Group.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/Author_Group.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/Author_Group.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,285 @@ +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# Language /mnt/hgfs/base/Hibernate/Reference translations for PACKAGE package. +# Copyright (C) 2006, 2007 Free Software Foundation, Inc. +# Automatically generated, 2006. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# +msgid "" +msgstr "" +"Project-Id-Version: Collection_Mapping\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2009-12-03T00:15:25\n" +"PO-Revision-Date: 2007-02-26 10:27+1000\n" +"Last-Translator: \n" +"Language-Team: <de(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.9.1\n" Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/Book_Info.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/Book_Info.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/Book_Info.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,308 @@ +# translation of Book_Info.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# Language /mnt/hgfs/base/Hibernate/Reference translations for PACKAGE package. +# Copyright (C) 2006, 2007, 2010 Free Software Foundation, Inc. +# Automatically generated, 2006. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# +msgid "" +msgstr "" +"Project-Id-Version: Book_Info\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2009-12-11T05:07:38\n" +"PO-Revision-Date: 2010-01-10 09:33+1100\n" +"Last-Translator: \n" +"Language-Team: <en(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.11.4\n" + +#. Tag: title +#, no-c-format +msgid "Hibernate Core Reference Guide" +msgstr "Hibernate Core Referenz-Handbuch" + +#. Tag: subtitle +#, no-c-format +msgid "" +"by Gavin King, Christian Bauer, Max Rydahl Andersen, Emmanuel Bernard, and " +"Steve Ebersole and thanks to James Cobb (Graphic Design) and Cheyenne Weaver " +"(Graphic Design)" +msgstr "" +"von Gavin King, Christian Bauer, Max Rydahl Andersen, Emmanuel Bernard und " +"Steve Ebersole. Wir danken auch James Cobb (Grafisches Design) und " +"Cheyenne Weaver (Grafisches Design)" + +#. Tag: para +#, no-c-format +msgid "The JBoss Hibernate Core 3.3.2.GA Reference Guide" +msgstr "Das JBoss Hibernate Core 3.3.2.GA Referenz-Handbuch" + Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/Feedback.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/Feedback.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/Feedback.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,315 @@ +# translation of Feedback.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# Language /mnt/hgfs/base/Hibernate/Reference translations for PACKAGE package. +# Copyright (C) 2006, 2007, 2010 Free Software Foundation, Inc. +# Automatically generated, 2006. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# +msgid "" +msgstr "" +"Project-Id-Version: Feedback\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2009-12-03T00:15:25\n" +"PO-Revision-Date: 2010-01-11 10:23+1100\n" +"Last-Translator: \n" +"Language-Team: <en(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.11.4\n" + +#. Tag: title +#, no-c-format +msgid "Feedback" +msgstr "Feedback" + +#. Tag: para +#, 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 "" +"Falls SIe einen Tippfehler in diesem Handbuch finden oder eine Idee dazu haben " +"wie wir es verbessern können, so würden wir uns freuen, von Ihnen zu hören! " +"Machen Sie eine Meldung in " +"<ulink url=\"http://jira.jboss.com/jira/browse/JBPAPP\">JIRA</ulink> zum " +"Produkt: JBoss Enterprise Application Platform, Version: " +"<replaceable><version></replaceable>, Komponente: <emphasis>Doc</" +"emphasis>. Falls Sie einen Vorschlag zur Verbesserung der Dokumentation haben, " +"versuchen Sie bitte so genau wie möglich zu sein. Falls Sie einen Fehler finden, " +"informieren Sie uns bitte zur Nummer des Abschnitts und geben Sie einen Teil " +"des umgebenden Texts an, damit wir diesen leichter finden." + Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/Hibernate_Core_Reference_Guide.po =================================================================== Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/Revision_History.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/Revision_History.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/Revision_History.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,297 @@ +# translation of Revision_History.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# Language /mnt/hgfs/base/Hibernate/Reference translations for PACKAGE package. +# Copyright (C) 2006, 2007, 2010 Free Software Foundation, Inc. +# Automatically generated, 2006. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# +msgid "" +msgstr "" +"Project-Id-Version: Revision_History\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2009-12-11T05:07:38\n" +"PO-Revision-Date: 2010-01-11 10:44+1100\n" +"Last-Translator: \n" +"Language-Team: <en(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.11.4\n" + +#. Tag: title +#, no-c-format +msgid "Revision History" +msgstr "Änderungsverzeichnis" + +#. Tag: member +#, no-c-format +msgid "Merged with EAP5 and translations added" +msgstr "Mit EAP5 verbunden und Übersetzungen hinzugefügt" + Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/Preface.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/Preface.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/Preface.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,480 @@ +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# Language /mnt/hgfs/base/Hibernate/Reference translations for PACKAGE package. +# Copyright (C) 2006, 2007 Free Software Foundation, Inc. +# Automatically generated, 2006. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# +msgid "" +msgstr "" +"Project-Id-Version: Collection_Mapping\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2010-01-08T04:07:17\n" +"PO-Revision-Date: 2007-02-26 10:27+1000\n" +"Last-Translator: \n" +"Language-Team: <de(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.9.1\n" + +#. Tag: title +#, no-c-format +msgid "Preface" +msgstr "Vorwort" + +#. Tag: para +#, no-c-format +msgid "" +"Working with object-oriented software and a relational database can be " +"cumbersome and time consuming in today's enterprise environments. Hibernate " +"is an object/relational mapping tool for Java environments. The term object/" +"relational mapping (ORM) refers to the technique of mapping a data " +"representation from an object model to a relational data model with a SQL-" +"based schema." +msgstr "" +"Die Arbeit mit objektorientierter Software und einer relationalen Datenbank " +"kann sich in Unternehmensumgebungen heutzutage als mühsam und zeitaufwendig " +"erweisen. Bei Hibernate handelt es sich um ein objekt/relationales Mapping-" +"Tool für Java Umgebungen. Der Begriff objekt/relationales Mapping (ORM) " +"bezieht sich auf die Technik des Mappens einer Datenrepräsentation von einem " +"Objektmodell zu einem relationalen Datenmodell mit SQL-basiertem Schema." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate not only takes care of the mapping from Java classes to database " +"tables (and from Java data types to SQL data types), but also provides data " +"query and retrieval facilities. It can also significantly reduce development " +"time otherwise spent with manual data handling in SQL and JDBC." +msgstr "" +"Hibernate besorgt nicht nur das Mapping von Java-Klassen zu " +"Datenbanktabellen (und von Java-Datentypen zu SQL-Datentypen ), sondern " +"bietet auch Datenanfragen sowie Datenbeschaffungshilfen, mittels derer sich " +"die Entwicklungszeit maßgeblich senken lässt, da die manuelle " +"Datenbearbeitung in SQL und JDBC entfällt." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate's goal is to relieve the developer from 95 percent of common data " +"persistence related programming tasks. Hibernate may not be the best " +"solution for data-centric applications that only use stored-procedures to " +"implement the business logic in the database, it is most useful with object-" +"oriented domain models and business logic in the Java-based middle-tier. " +"However, Hibernate can certainly help you to remove or encapsulate vendor-" +"specific SQL code and will help with the common task of result set " +"translation from a tabular representation to a graph of objects." +msgstr "" +"Hibernate will dem Entwickler 95 Prozent der mit gängiger Datenpersistenz " +"verbundenen Programmierarbeit abnehmen. Hibernate ist möglicherweise nicht " +"die beste Lösung für datenzentrische Anwendungen, die nur gespeicherte " +"Prozeduren zur Implementierung der Business Logik in die Datenbank " +"verwenden, ist jedoch was objektorientierte Domain-Modelle und Business " +"Logik im Java-basierten Mittel-Tier angeht am leistungsfähigsten. Hibernate " +"kann Ihnen mit Sicherheit dabei helfen, den anbieterspezifischen SQL-Code zu " +"entfernen oder einzukapseln und unterstützt Sie auch bei der gängigen " +"Aufgabe der Übersetzung des Ergebnissatzes einer tabellarischen " +"Repräsentation in ein Objektdiagramm." + +#. Tag: para +#, no-c-format +msgid "" +"If you are new to Hibernate and Object/Relational Mapping or even Java, " +"please follow these steps:" +msgstr "" +"Falls Ihnen Hibernate und Objekt/Relationales Mapping oder sogar Java neu " +"sind, orientieren Sie sich bitte an folgenden Schritten:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Read <xref linkend=\"tutorial\" /> for a tutorial with step-by-step " +"instructions. The source code for the tutorial is included in the " +"distribution in the <literal>doc/reference/tutorial/</literal> directory." +msgstr "" +"Lesen Sie <xref linkend=\"tutorial\"/> für eine schrittweise Anleitung. Der " +"Quellcode der Anleitung ist Teil der Distrubution im <literal>doc/reference/" +"tutorial/</literal>-Verzeichnis." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Read <xref linkend=\"architecture\" /> to understand the environments where " +"Hibernate can be used." +msgstr "" +"Lesen Sie <xref linkend=\"architecture\"/>, um mehr über die Umgebungen zu " +"erfahren, in denen Hibernate eingesetzt werden kann." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"View the <literal>eg/</literal> directory in the Hibernate distribution. It " +"contains a simple standalone application. Copy your JDBC driver to the " +"<literal>lib/</literal> directory and edit <literal>etc/hibernate." +"properties</literal>, specifying correct values for your database. From a " +"command prompt in the distribution directory, type <literal>ant eg</literal> " +"(using Ant), or under Windows, type <literal>build eg</literal>." +msgstr "" +"Schauen Sie sich das <literal>eg/</literal>-Verzeichnis in der Hibernate " +"Distribution an, es enthält eine einfache, selbständige Anwendung. Kopieren " +"Sie Ihren JDBC-Treiber in das <literal>lib/</literal>-Verzeichnis und " +"editieren Sie <literal>etc/hibernate.properties</literal>, indem Sie " +"korrekte Werte für Ihre Datenbank spezifizieren. Von einer Kommandozeile im " +"Distributionsverzeichnis tippen Sie <literal>ant eg</literal> (unter " +"Verwendung von Ant) oder in Windows tippen Sie <literal>build eg</literal>." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Use this reference documentation as your primary source of information. " +"Consider reading <emphasis>Java Persistence with Hibernate</emphasis> " +"(http://www.manning.com/bauer2) if you need more help with application " +"design, or if you prefer a step-by-step tutorial. Also visit http://" +"caveatemptor.hibernate.org and download the example application for Java " +"Persistence with Hibernate." +msgstr "" +"Verwenden Sie diese Referenzdokumentation als Ihre primäre " +"Informationsquelle. Weitere Informationen finden Sie außerdem unter " +"<emphasis>Hibernate in Action</emphasis> (http://www.manning.com/bauer), " +"falls Sie Hilfe bei Ihrem Anwendungsdesign benötigen oder eine Schritt-für-" +"Schritt-Anleitung vorziehen. Eine herunterladbare Beispielanwendung von " +"\"Hibernate in Action\" finden Sie auch unter http://caveatemptor.hibernate." +"org." + +#. Tag: para +#, no-c-format +msgid "FAQs are answered on the Hibernate website." +msgstr "" +"Antworten auf häufig gestellte Fragen (FAQs) finden Sie auf der Website von " +"Hibernate." + +#. Tag: para +#, no-c-format +msgid "" +"Third party demos, examples, and tutorials are linked on the Hibernate " +"website." +msgstr "" +"Auf der Hibernate Website befinden sich auch Demos, Beispiele und " +"Anleitungen Dritter." + +#. Tag: para +#, no-c-format +msgid "" +"The Community Area on the Hibernate website is a good resource for design " +"patterns and various integration solutions (Tomcat, JBoss AS, Struts, EJB, " +"etc.)." +msgstr "" +"Im Community-Bereich der Hibernate Website finden sich auch gute Tipps zu " +"Designmustern und verschiedenen Integrationslösungen (Tomcat, JBoss AS, " +"Struts, EJB, usw.)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If you have questions, use the user forum linked on the Hibernate website. " +"We also provide a JIRA issue tracking system for bug reports and feature " +"requests. If you are interested in the development of Hibernate, join the " +"developer mailing list. If you are interested in translating this " +"documentation into your language, contact us on the developer mailing list." +msgstr "" +"Bei Fragen wenden Sie sich an das Benutzerforum, das mit der Hibernate " +"Website verlinkt ist. Wir bieten auch ein JIRA-Problemverfolgungssystem für " +"Fehlerberichte und Feature-Anfragen. Falls Sie an der Entwicklung von " +"Hibernate interessiert sind, registrieren Sie sich bei der Mailing-Liste für " +"Entwickler. Falls Sie diese Dokumentation in Ihre Sprache übersetzen " +"möchten, setzen Sie sich mittels der Mailing-Liste für Entwickler mit uns in " +"Verbindung." + +#. Tag: para +#, no-c-format +msgid "" +"Commercial development support, production support, and training for " +"Hibernate is available through JBoss Inc. (see http://www.hibernate.org/" +"SupportTraining/). Hibernate is a Professional Open Source project and a " +"critical component of the JBoss Enterprise Middleware System (JEMS) suite of " +"products." +msgstr "" +"Gewerblicher Entwicklungssupport, Produktionssupport und Training sind über " +"JBoss Inc. (siehe http://www.hibernate.org/SupportTraining/) verfügbar. " +"Hibernate ist ein professionelles Open Source Projekt und ein entscheidender " +"Bestandteil der JBoss Enterprise Middleware System (JEMS) Produktreihe." + +#. Tag: title +#, no-c-format +msgid "Feedback" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"Use <ulink url=\"http://opensource.atlassian.com/projects/hibernate" +"\">Hibernate JIRA</ulink> to report errors or request enhacements to this " +"documentation." +msgstr "" Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/architecture.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/architecture.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/architecture.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,899 @@ +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# Language /mnt/hgfs/base/Hibernate/Reference translations for PACKAGE package. +# Copyright (C) 2006, 2007 Free Software Foundation, Inc. +# Automatically generated, 2006. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# +msgid "" +msgstr "" +"Project-Id-Version: Collection_Mapping\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2009-12-03T00:15:25\n" +"PO-Revision-Date: 2007-02-26 10:27+1000\n" +"Last-Translator: \n" +"Language-Team: <de(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.9.1\n" + +#. Tag: title +#, no-c-format +msgid "Architecture" +msgstr "Architektur" + +#. Tag: title +#, no-c-format +msgid "Overview" +msgstr "Übersicht" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The diagram below provides a high-level view of the Hibernate architecture:" +msgstr "Eine (sehr) hohe Ansicht der Hibernate-Architektur:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"We do not have the scope in this document to provide a more detailed view of " +"all the runtime architectures available; Hibernate is flexible and supports " +"several different approaches. We will, however, show the two extremes: " +"\"minimal\" architecture and \"comprehensive\" architecture." +msgstr "" +"Wir würden gerne eine detaillierte Ansicht der Runtime-Architektur zeigen, " +"jedoch ist Hibernate leider flexibel und unterstützt mehrere " +"Vorgehensweisen. Daher erläutern wir hier die beiden Extreme. Bei der " +"\"abgespeckten\" Architektur liefert die Anwendung ihre eigenen JDBC-" +"Verbindungen und verwaltet ihre eigenen Transaktionen. Diese Vorgehensweise " +"verwendet einen minimalen Teilsatz der APIs von Hibernate:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This next diagram illustrates how Hibernate utilizes database and " +"configuration data to provide persistence services, and persistent objects, " +"to the application." +msgstr "" +"Dieses Diagram zeigt, wie Hibernate die Datenbank und die " +"Konfigurationsdaten verwendet, um Persistenzdienste (und persistente " +"Objekte) für die Anwendung zu liefern." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The \"minimal\" architecture has the application provide its own JDBC " +"connections and manage its own transactions. This approach uses a minimal " +"subset of Hibernate's APIs:" +msgstr "" +"Wir würden gerne eine detaillierte Ansicht der Runtime-Architektur zeigen, " +"jedoch ist Hibernate leider flexibel und unterstützt mehrere " +"Vorgehensweisen. Daher erläutern wir hier die beiden Extreme. Bei der " +"\"abgespeckten\" Architektur liefert die Anwendung ihre eigenen JDBC-" +"Verbindungen und verwaltet ihre eigenen Transaktionen. Diese Vorgehensweise " +"verwendet einen minimalen Teilsatz der APIs von Hibernate:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The \"comprehensive\" architecture abstracts the application away from the " +"underlying JDBC/JTA APIs and allows Hibernate to manage the details." +msgstr "" +"Die \"vollständige\" Architektur zieht die Anwendung von den zu Grunde " +"liegenden JDBC/JTA APIs ab, so dass Hibernate sich um Details kümmern kann." + +#. Tag: para +#, fuzzy, no-c-format +msgid "Here are some definitions of the objects depicted in the diagrams:" +msgstr "" +"Nachfolgend sehen Sie einige Definitionen von Objekten innerhalb der " +"Diagramme:" + +#. Tag: term +#, no-c-format +msgid "SessionFactory (<literal>org.hibernate.SessionFactory</literal>)" +msgstr "SessionFactory (<literal>org.hibernate.SessionFactory</literal>)" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A threadsafe, immutable cache of compiled mappings for a single database. A " +"factory for <literal>Session</literal> and a client of " +"<literal>ConnectionProvider</literal>, <literal>SessionFactory</literal> can " +"hold an optional (second-level) cache of data that is reusable between " +"transactions at a process, or cluster, level." +msgstr "" +"Ein thread-sicheres (unveränderliches) Cache kompilierter Mappings für eine " +"einzelne Datenbank. Eine Factory für <literal>Session</literal> und ein " +"Client von <literal>ConnectionProvider</literal>. Kann über ein optionales " +"Datencache (zweite Ebene) verfügen, das zwischen Transaktionen " +"wiederverwendet werden kann, sei es auf Prozess- oder auch auf Cluster-Ebene." + +#. Tag: term +#, no-c-format +msgid "Session (<literal>org.hibernate.Session</literal>)" +msgstr "Session (<literal>org.hibernate.Session</literal>)" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A single-threaded, short-lived object representing a conversation between " +"the application and the persistent store. It wraps a JDBC connection and is " +"a factory for <literal>Transaction</literal>. <literal>Session</literal> " +"holds a mandatory first-level cache of persistent objects that are used when " +"navigating the object graph or looking up objects by identifier." +msgstr "" +"Ein aus einem Thread bestehendes, kurzlebiges Objekt, dass einen Dialog " +"zwischen der Anwendung und dem persistenten Speicher repräsentiert. Wrappt " +"eine JDBC-Verbindung. Factory für <literal>Transaction</literal>. Enthält " +"einen obligatorischen Cachespeicher persistenter Objekte (auf erster Ebene), " +"die bei der Navigation des Objektgraphs oder bei der Suche nach Objekten " +"durch den Bezeichner verwendet werden." + +#. Tag: term +#, no-c-format +msgid "Persistent objects and collections" +msgstr "Persistente Objekte und Collections" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Short-lived, single threaded objects containing persistent state and " +"business function. These can be ordinary JavaBeans/POJOs. They are " +"associated with exactly one <literal>Session</literal>. Once the " +"<literal>Session</literal> is closed, they will be detached and free to use " +"in any application layer (for example, directly as data transfer objects to " +"and from presentation)." +msgstr "" +"Kurzlebige, aus einem Thread bestehende Objekte, die persistenten Status und " +"Unternehmensfunktionen beinhalten. Dabei kann es sich um gewöhnliche " +"JavaBeans/POJOs handeln. Ihre Besonderheit besteht darin, dass sie zum " +"aktuellen Zeitpunkt mit (genau einer) <literal>Session</literal> verbunden " +"sind. Sobald die <literal>Session</literal> geschlossen wird, lösen sie sich " +"und können innerhalb jeder Anwendungsschicht (etwa als direkte " +"Datentransferobjekte einer Präsentation) verwendet werden." + +#. Tag: term +#, no-c-format +msgid "Transient and detached objects and collections" +msgstr "Temporäre und abgesetzte Objekte und Collections" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Instances of persistent classes that are not currently associated with a " +"<literal>Session</literal>. They may have been instantiated by the " +"application and not yet persisted, or they may have been instantiated by a " +"closed <literal>Session</literal>." +msgstr "" +"Instanzen persistenter Klassen, die zum aktuellen Zeitpunkt mit keiner " +"<literal>Session</literal> verbunden sind. Sie können von der Anwendung " +"instanziiert worden und (noch) nicht persistiert oder von einer " +"geschlossenen <literal>Session</literal> instanziiert worden sein." + +#. Tag: term +#, no-c-format +msgid "Transaction (<literal>org.hibernate.Transaction</literal>)" +msgstr "Transaktion (<literal>org.hibernate.Transaction</literal>)" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"(Optional) A single-threaded, short-lived object used by the application to " +"specify atomic units of work. It abstracts the application from the " +"underlying JDBC, JTA or CORBA transaction. A <literal>Session</literal> " +"might span several <literal>Transaction</literal>s in some cases. However, " +"transaction demarcation, either using the underlying API or " +"<literal>Transaction</literal>, is never optional." +msgstr "" +"(Optional) Ein aus einem Thread bestehendes, kurzlebiges Objekt, das von der " +"Anwendung zur Bestimmung elementarer Arbeitseinheiten verwendet wird. " +"Abstrahiert die Anwendung von der zu Grunde liegenden JDBC-, JTA- oder CORBA-" +"Transaktion. Eine <literal>Session</literal> kann manchmal mehrere " +"<literal>Transaction</literal>s umfassen. Transaktionsabgrenzung, ob unter " +"Verwendung der zu Grunde liegenden API oder <literal>Transaction</literal>, " +"ist jedoch nie optional!" + +#. Tag: term +#, no-c-format +msgid "" +"ConnectionProvider (<literal>org.hibernate.connection.ConnectionProvider</" +"literal>)" +msgstr "" +"ConnectionProvider (<literal>org.hibernate.connection.ConnectionProvider</" +"literal>)" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"(Optional) A factory for, and pool of, JDBC connections. It abstracts the " +"application from underlying <literal>Datasource</literal> or " +"<literal>DriverManager</literal>. It is not exposed to application, but it " +"can be extended and/or implemented by the developer." +msgstr "" +"(Optional) Eine Factory für (und ein Pool von) JDBC-Verbindungen. " +"Abstrahiert die Anwendung von der zu Grunde liegenden <literal>Datasource</" +"literal> oder <literal>DriverManager</literal>. Nicht der Anwendung " +"ausgesetzt, kann jedoch vom Entwickler erweitert/implementiert werden." + +#. Tag: term +#, no-c-format +msgid "" +"TransactionFactory (<literal>org.hibernate.TransactionFactory</literal>)" +msgstr "" +"TransactionFactory (<literal>org.hibernate.TransactionFactory</literal>)" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"(Optional) A factory for <literal>Transaction</literal> instances. It is not " +"exposed to the application, but it can be extended and/or implemented by the " +"developer." +msgstr "" +"(Optional) Eine Factory für <literal>Transaction</literal>-Instanzen. Nicht " +"der Anwendung ausgesetzt, kann jedoch durch den Entwickler erweitert/" +"implementiert werden." + +#. Tag: term +#, fuzzy, no-c-format +msgid "<emphasis>Extension Interfaces</emphasis>" +msgstr "Erweiterungsschnittstellen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate offers a range of optional extension interfaces you can implement " +"to customize the behavior of your persistence layer. See the API " +"documentation for details." +msgstr "" +"Hibernate bietet zahlreiche optionale Erweiterungsschnittstellen zur " +"Implemetierung an, mit denen Sie das Verhalten Ihrer Persistenzschicht Ihren " +"individuellen Wünschen anpassen können. Weitere Informationen finden Sie in " +"der API-Dokumentation." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Given a \"minimal\" architecture, the application bypasses the " +"<literal>Transaction</literal>/<literal>TransactionFactory</literal> and/or " +"<literal>ConnectionProvider</literal> APIs to communicate with JTA or JDBC " +"directly." +msgstr "" +"Bei einer \"abgespeckten\" Architektur umgeht die Anwendung " +"<literal>Transaction</literal>/<literal>TransactionFactory</literal> und/" +"oder <literal>ConnectionProvider</literal> APIs kommunizieren direkt mit JTA " +"oder JDBC." + +#. Tag: title +#, no-c-format +msgid "Instance states" +msgstr "Instanzstatus" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"An instance of a persistent class can be in one of three different states. " +"These states are defined in relation to a <emphasis>persistence context</" +"emphasis>. The Hibernate <literal>Session</literal> object is the " +"persistence context. The three different states are as follows:" +msgstr "" +"Der Status der Instanz einer persistenten Klasse kann drei Formen haben, die " +"unter Berücksichtigung eines <emphasis>Persistenzkontexts</emphasis> (sog. " +"\"Persistence Context\") definiert sind. Das Hibernate <literal>Session</" +"literal>-Objekt ist der Persistenzkontext:" + +#. Tag: term +#, no-c-format +msgid "transient" +msgstr "transient" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The instance is not associated with any persistence context. It has no " +"persistent identity or primary key value." +msgstr "" +"Die Instanz ist nicht (und war auch nie) mit einem Persistenzkontext " +"assoziiert. Sie besitzt keine persistente Identität (Wert des primären " +"Kernbegriffs)." + +#. Tag: term +#, no-c-format +msgid "persistent" +msgstr "persistent" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The instance is currently associated with a persistence context. It has a " +"persistent identity (primary key value) and can have a corresponding row in " +"the database. For a particular persistence context, Hibernate " +"<emphasis>guarantees</emphasis> that persistent identity is equivalent to " +"Java identity in relation to the in-memory location of the object." +msgstr "" +"Die Instanz wird zum aktuellen Zeitpunkt mit einem Persistenzkontext " +"assoziiert. Sie besitzt eine persistente Identität (Wert des primären " +"Kernbegriffs) und möglicherweise eine korrespondierende Reihe in der " +"Datenbank. Für einen bestimmten Persistenzkontext <emphasis>garantiert</" +"emphasis> Hibernate, dass die persistente Identität äquivalent zur Java " +"Identität (Speicherstelle des Objekts) ist." + +#. Tag: term +#, no-c-format +msgid "detached" +msgstr "detached (\"abgesetzt\")" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The instance was once associated with a persistence context, but that " +"context was closed, or the instance was serialized to another process. It " +"has a persistent identity and can have a corresponding row in the database. " +"For detached instances, Hibernate does not guarantee the relationship " +"between persistent identity and Java identity." +msgstr "" +"Die Instanz war vormals mit einem Persistenzkontext assoziiert, aber der " +"Kontext wurde geschlossen oder die Instanz in einem anderen Vorgang " +"serialisiert. Sie besitzt eine persistente Identität und möglicherweise eine " +"korrespondierende Reihe in der Datenbank. Für Instanzen im abgesetzten " +"Status (\"detached\") garantiert Hibernate keine Verbindung zwischen " +"persistenter Identität und Java-Identität." + +#. Tag: title +#, no-c-format +msgid "JMX Integration" +msgstr "JMX-Integration" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"JMX is the J2EE standard for the management of Java components. Hibernate " +"can be managed via a JMX standard service. AN MBean implementation is " +"provided in the distribution: <literal>org.hibernate.jmx.HibernateService</" +"literal>." +msgstr "" +"JMX ist der J2EE-Standard für das Management von Java-Komponenten. Hibernate " +"kann mittels eines JMX-Standardservice verwaltet werden. In der Distribution " +"wird ein MBean in <literal>org.hibernate.jmx.HibernateService</literal> " +"bereitgestellt." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"For an example of how to deploy Hibernate as a JMX service on the JBoss " +"Application Server, please see the JBoss User Guide. JBoss AS also provides " +"these benefits if you deploy using JMX:" +msgstr "" +"Ein Beispiel wie Hibernate als ein JMX-Dienst auf dem JBoss " +"Applikationsserver ausgeführt wird, finden Sie im JBoss Benutzerhandbuch. " +"Auf dem JBoss AS genießen Sie die gleichen Vorteile, wenn Sie JMX verwenden:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis>Session Management</emphasis>: the Hibernate <literal>Session</" +"literal>'s life cycle can be automatically bound to the scope of a JTA " +"transaction. This means that you no longer have to manually open and close " +"the <literal>Session</literal>; this becomes the job of a JBoss EJB " +"interceptor. You also do not have to worry about transaction demarcation in " +"your code (if you would like to write a portable persistence layer use the " +"optional Hibernate <literal>Transaction</literal> API for this). You call " +"the <literal>HibernateContext</literal> to access a <literal>Session</" +"literal>." +msgstr "" +"<emphasis>Session Management:</emphasis> Der Lebenszyklus der Hibernate " +"<literal>Session</literal> kann automatisch an den Gültigkeitsbereich einer " +"JTA-Transaktion gebunden werden. Das bedeutet, dass Sie die " +"<literal>Session</literal> nicht mehr manuell öffnen und schließen müssen, " +"da diese Aufgabe von einem JBoss EJB-Interzeptor übernommen wird. Sie müssen " +"sich auch nicht um die Transaktionsabgrenzung in Ihrem Code kümmern (außer " +"natürlich Sie möchten eine übertragbare Persistenzschicht schreiben, in " +"welchem Fall Sie die optionale Hibernate <literal>Transaction</literal>-API " +"verwenden). Sie rufen den <literal>HibernateContext</literal> auf, um auf " +"eine <literal>Session</literal> zuzugreifen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis>HAR deployment</emphasis>: the Hibernate JMX service is deployed " +"using a JBoss service deployment descriptor in an EAR and/or SAR file, as it " +"supports all the usual configuration options of a Hibernate " +"<literal>SessionFactory</literal>. However, you still need to name all your " +"mapping files in the deployment descriptor. If you use the optional HAR " +"deployment, JBoss will automatically detect all mapping files in your HAR " +"file." +msgstr "" +"<emphasis>HAR-Deployment:</emphasis> In der Regel führen Sie den Hibernate " +"JMX-Dienst unter Verwendung eines JBoss Service Deployment-Deskriptors (in " +"einer EAR- und/oder SAR-Datei) aus. Dabei werden die üblichen " +"Konfigurationsoptionen einer Hibernate <literal>SessionFactory</literal> " +"unterstützt. Sie müssen jedoch noch alle Ihre Mapping-Dateien im Deployment-" +"Deskriptor benennen. Falls Sie sich für die Benutzung des optionalen HAR-" +"Deployments entscheiden, wird JBoss automatisch sämtliche Mapping-Dateien in " +"Ihrer HAR-Datei auffinden." + +#. Tag: para +#, no-c-format +msgid "" +"Consult the JBoss AS user guide for more information about these options." +msgstr "" +"Weitere Informationen zu diesen Optionen finden Sie im JBoss AS " +"Benutzerhandbuch." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Another feature available as a JMX service is runtime Hibernate statistics. " +"See <xref linkend=\"configuration-optional-statistics\" /> for more " +"information." +msgstr "" +"Ein weiteres, als JMX-Dienst verfügbares Feature sind Runtime Hibernate " +"Statistiken, siehe <xref linkend=\"configuration-optional-statistics\"/>." + +#. Tag: title +#, no-c-format +msgid "JCA Support" +msgstr "JCA-Support" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate can also be configured as a JCA connector. Please see the website " +"for more information. Please note, however, that at this stage Hibernate JCA " +"support is under development." +msgstr "" +"Hibernate kann auch als ein JCA-Konnektor konfiguriert werden. Weitere " +"Informationen dazu finden Sie auf der Website. Bitte beachten Sie, dass der " +"Hibernate JCA-Support noch als experimentell gilt." + +#. Tag: title +#, fuzzy, no-c-format +msgid "Contextual sessions" +msgstr "Kontextbezogene Sessions" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Most applications using Hibernate need some form of \"contextual\" session, " +"where a given session is in effect throughout the scope of a given context. " +"However, across applications the definition of what constitutes a context is " +"typically different; different contexts define different scopes to the " +"notion of current. Applications using Hibernate prior to version 3.0 tended " +"to utilize either home-grown <literal>ThreadLocal</literal>-based contextual " +"sessions, helper classes such as <literal>HibernateUtil</literal>, or " +"utilized third-party frameworks, such as Spring or Pico, which provided " +"proxy/interception-based contextual sessions." +msgstr "" +"Die meisten Hibernate verwendenen Anwendungen benötigen irgendeine Form von " +"\"kontextbezogenen\" Sessions (sog. \"contextual sessions\"), bei denen eine " +"bestimmte Session innerhalb des gesamten Gültigkeitsbereichs eines " +"bestimmten Kontextes gültig ist. Allerdings ist die Definition darüber, was " +"einen Kontext ausmacht in der Regel unterschiedlich, und unterschiedliche " +"Kontexte definieren unterschiedliche Gültigkeitsbereiche von aktuell. " +"Anwendungen, die eine frühere Version als Hibernate 3.0 verwenden, neigen " +"dazu Ihre eigenen <literal>ThreadLocal</literal>-basierten kontextbezogenen " +"Sessions zu benutzen, Helferklassen wie <literal>HibernateUtil</literal> " +"oder Rahmensysteme Dritter (wie Spring oder Pico), die Proxy/Interception-" +"basierte kontextbezogene Sessions bereitstellen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Starting with version 3.0.1, Hibernate added the <literal>SessionFactory." +"getCurrentSession()</literal> method. Initially, this assumed usage of " +"<literal>JTA</literal> transactions, where the <literal>JTA</literal> " +"transaction defined both the scope and context of a current session. Given " +"the maturity of the numerous stand-alone <literal>JTA TransactionManager</" +"literal> implementations, most, if not all, applications should be using " +"<literal>JTA</literal> transaction management, whether or not they are " +"deployed into a <literal>J2EE</literal> container. Based on that, the " +"<literal>JTA</literal>-based contextual sessions are all you need to use." +msgstr "" +"Ab Version 3.0.1 verfügt Hibernate über eine <literal>SessionFactory." +"getCurrentSession()</literal>-Methode. Ursprünglich wurde dabei vom Gebrauch " +"der <literal>JTA</literal>-Transaktionen ausgegangen, bei denen die " +"<literal>JTA</literal>-Transaktion sowohl den Gültigkeitsbereich als auch " +"den Kontext einer aktuellen Session bestimmt. Das Hibernate-Team ist der " +"Ansicht, dass in Anbetracht der zahlreichen selbständigen <literal>JTA " +"TransactionManager</literal>-Implementierungen, die meisten (wenn nicht " +"alle) Anwendungen das <literal>JTA</literal>-Transaktionsmanagement " +"verwenden sollten - unabhängig davon, ob sie in einen <literal>J2EE</" +"literal>-Container deployt werden oder nicht. Davon ausgehend sind die " +"<literal>JTA</literal>-basierten, kontextbezogenen Sessions alles was Sie " +"benötigen dürften." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"However, as of version 3.1, the processing behind <literal>SessionFactory." +"getCurrentSession()</literal> is now pluggable. To that end, a new extension " +"interface, <literal>org.hibernate.context.CurrentSessionContext</literal>, " +"and a new configuration parameter, <literal>hibernate." +"current_session_context_class</literal>, have been added to allow " +"pluggability of the scope and context of defining current sessions." +msgstr "" +"Seit Version 3.1 ist die Bearbeitung hinter <literal>SessionFactory." +"getCurrentSession()</literal> nun einbindbar. Eine neue " +"Erweiterungsschnittstelle (<literal>org.hibernate.context." +"CurrentSessionContext</literal>) sowie ein neuer Konfigurationsparameter " +"(<literal>hibernate.current_session_context_class</literal>) kamen hinzu, um " +"die Einbindbarkeit von dem die aktuelle Session definierenden " +"Gültigkeitsbereich und Kontext zu ermöglichen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"See the Javadocs for the <literal>org.hibernate.context." +"CurrentSessionContext</literal> interface for a detailed discussion of its " +"contract. It defines a single method, <literal>currentSession()</literal>, " +"by which the implementation is responsible for tracking the current " +"contextual session. Out-of-the-box, Hibernate comes with three " +"implementations of this interface:" +msgstr "" +"Weitere Informationen zu diesem Vertrag finden Sie in den Javadocs für das " +"<literal>org.hibernate.context.CurrentSessionContext</literal>-Interface. Es " +"wird eine einzelne Methode definiert <literal>currentSession()</literal>, " +"mit der die Implementierung für die Verfolgung der aktuellen " +"kontextbezogenen Session verantwortlich ist. Hibernate wird mit drei " +"Implementierungen dieses Interface geliefert." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>org.hibernate.context.JTASessionContext</literal>: current sessions " +"are tracked and scoped by a <literal>JTA</literal> transaction. The " +"processing here is exactly the same as in the older JTA-only approach. See " +"the Javadocs for details." +msgstr "" +"<literal>org.hibernate.context.JTASessionContext</literal> - aktuelle " +"Sessions werden verfolgt und durch eine <literal>JTA</literal>-Transaktion " +"begrenzt. Die Bearbeitung läuft hier genauso wie bei der älteren, " +"ausschließlich mit JTA arbeitenden Vorgehensweise. Weitere Informationen " +"finden Sie in Javadocs." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>org.hibernate.context.ThreadLocalSessionContext</literal>:current " +"sessions are tracked by thread of execution. See the Javadocs for details." +msgstr "" +"<literal>org.hibernate.context.ThreadLocalSessionContext</literal> - " +"aktuelle Sessions werden mittels Ausführungs-Thread verfolgt. Auch hierzu " +"finden Sie weitere Informationen in Javadocs." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>org.hibernate.context.ManagedSessionContext</literal>: current " +"sessions are tracked by thread of execution. However, you are responsible to " +"bind and unbind a <literal>Session</literal> instance with static methods on " +"this class: it does not open, flush, or close a <literal>Session</literal>." +msgstr "" +"<literal>org.hibernate.context.ManagedSessionContext</literal> - aktuelle " +"Sessions werden mittels Ausführungs-Thread verfolgt. Allerdings müssen Sie " +"hier selbst eine <literal>Session</literal>-Instanz mit statischen Methoden " +"an diese Klasse binden, eine <literal>Session</literal> wird nie geöffnet, " +"geräumt oder geschlossen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The first two implementations provide a \"one session - one database " +"transaction\" programming model. This is also also known and used as " +"<emphasis>session-per-request</emphasis>. The beginning and end of a " +"Hibernate session is defined by the duration of a database transaction. If " +"you use programmatic transaction demarcation in plain JSE without JTA, you " +"are advised to use the Hibernate <literal>Transaction</literal> API to hide " +"the underlying transaction system from your code. If you use JTA, you can " +"utilize the JTA interfaces to demarcate transactions. If you execute in an " +"EJB container that supports CMT, transaction boundaries are defined " +"declaratively and you do not need any transaction or session demarcation " +"operations in your code. Refer to <xref linkend=\"transactions\" /> for more " +"information and code examples." +msgstr "" +"Die ersten beiden Implementierungen bieten ein \"eine Session - eine " +"Datenbanktransaktion\"-Programmiermodell, das auch als <emphasis>Session-per-" +"Request</emphasis> (\"Session pro Anfrage\") bekannt ist und verwendet wird. " +"Anfang und Ende einer Hibernate-Session werden durch die Dauer der " +"Datenbanktransaktion bestimmt. Falls Sie eine progammatische " +"Transaktionsabgrenzung in einfachem JSE ohne JTA verwenden, so empfehlen wir " +"die Verwendung der Hibernate <literal>Transaction</literal>-API, um das zu " +"Grunde liegende Transaktionssystem vor Ihrem Code zu verbergen. Falls Sie " +"JTA verwenden, so benutzen Sie die JTA-Schnittstellen um Transaktionen " +"abzugrenzen. Falls Sie einen EJB-Container ausführen, der CMT unterstützt, " +"sind die Transaktionsrahmen deklarativ definiert, und Sie benötigen in Ihrem " +"Code keine Transaktions- oder Sessionabgrenzungen. Weitere Informationen und " +"Code-Beispiele finden Sie unter <xref linkend=\"transactions\"/>." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>hibernate.current_session_context_class</literal> configuration " +"parameter defines which <literal>org.hibernate.context." +"CurrentSessionContext</literal> implementation should be used. For backwards " +"compatibility, if this configuration parameter is not set but a <literal>org." +"hibernate.transaction.TransactionManagerLookup</literal> is configured, " +"Hibernate will use the <literal>org.hibernate.context.JTASessionContext</" +"literal>. Typically, the value of this parameter would just name the " +"implementation class to use. For the three out-of-the-box implementations, " +"however, there are three corresponding short names: \"jta\", \"thread\", and " +"\"managed\"." +msgstr "" +"Der <literal>hibernate.current_session_context_class</literal> " +"Konfigurationsparameter definiert, welche <literal>org.hibernate.context." +"CurrentSessionContext</literal>-Implementierung verwendet wird. Bitte " +"beachten Sie, dass für Abwärtskompatibilität - falls dieser " +"Konfigurationsparameter nicht eingestellt, sondern <literal>org.hibernate." +"transaction.TransactionManagerLookup</literal> konfiguriert ist - Hibernate " +"<literal>org.hibernate.context.JTASessionContext</literal> verwendet. " +"Normalerweise benennt der Wert dieses Parameters lediglich die zu " +"verwendende Implementierungsklasse für die drei gelieferten " +"Implementierungen, jedoch existieren drei entsprechende Kurznamen \"jta\", " +"\"thread\" sowie \"managed\"." Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/association_mapping.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/association_mapping.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/association_mapping.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,1425 @@ +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# Language /mnt/hgfs/base/Hibernate/Reference translations for PACKAGE package. +# Copyright (C) 2006, 2007 Free Software Foundation, Inc. +# Automatically generated, 2006. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# +msgid "" +msgstr "" +"Project-Id-Version: Collection_Mapping\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2009-12-03T00:15:25\n" +"PO-Revision-Date: 2007-02-26 10:27+1000\n" +"Last-Translator: \n" +"Language-Team: <de(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.9.1\n" + +#. Tag: title +#, no-c-format +msgid "Association Mappings" +msgstr "Assoziations-Mappings" + +#. Tag: title +#, no-c-format +msgid "Introduction" +msgstr "Einführung" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Association mappings are often the most difficult thing to implement " +"correctly. In this section we examine some canonical cases one by one, " +"starting with unidirectional mappings and then bidirectional cases. We will " +"use <literal>Person</literal> and <literal>Address</literal> in all the " +"examples." +msgstr "" +"Assoziations-Mappings sind häufig die am schwierigsten einzustellenden " +"Aspekte. In diesem Abschnitt gehen wir Schritt für Schritt die einzelnen " +"Fälle durch, wobei wir zunächst auf unidirektionale Mappings eingehen, ehe " +"wir mit bidirektionalen Fällen weitermachen. In sämtlichen Beispielen werden " +"<literal>Person</literal> und <literal>Address</literal> verwendet." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Associations will be classified by multiplicity and whether or not they map " +"to an intervening join table." +msgstr "" +"Wir klassifizieren Assoziationen danach, ob sie zu einer intervenierenden " +"Verbundtabelle mappen sowie nach Multiplizität." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Nullable foreign keys are not considered to be good practice in traditional " +"data modelling, so our examples do not use nullable foreign keys. This is " +"not a requirement of Hibernate, and the mappings will work if you drop the " +"nullability constraints." +msgstr "" +"Nullbare Fremdschlüssel werden nicht als optimales Verfahren bei der " +"herkömmlichen Datenmodellierung angesehen, daher verwenden wir in allen " +"unseren Beispielen Fremdschlüssel die nicht Null sind. Das ist keine " +"Anforderung von Hibernate und sämtliche Mappings funktionieren, wenn Sie die " +"\"Nullability\"-Bedingungen aufheben." + +#. Tag: title +#, no-c-format +msgid "Unidirectional associations" +msgstr "Unidirektionale Assoziationen" + +#. Tag: title +#, fuzzy, no-c-format +msgid "Many-to-one" +msgstr "many-to-one" + +#. Tag: para +#, no-c-format +msgid "" +"A <emphasis>unidirectional many-to-one association</emphasis> is the most " +"common kind of unidirectional association." +msgstr "" +"Eine <emphasis>unidirektionale \"Many-to-One\"-Assoziation</emphasis> ist " +"der gängigste Typ unidirektionaler Assoziationen." + +#. Tag: title +#, fuzzy, no-c-format +msgid "One-to-one" +msgstr "one-to-one" + +#. Tag: para +#, no-c-format +msgid "" +"A <emphasis>unidirectional one-to-one association on a foreign key</" +"emphasis> is almost identical. The only difference is the column unique " +"constraint." +msgstr "" +"Eine <emphasis>unidirektionale \"One-to-One\"-Assoziation an einem " +"Fremdschlüssel</emphasis> ist fast identisch. Der einzige Unterschied " +"besteht in der Spalte der eindeutigen Bedingung." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A <emphasis>unidirectional one-to-one association on a primary key</" +"emphasis> usually uses a special id generator In this example, however, we " +"have reversed the direction of the association:" +msgstr "" +"Eine <emphasis>unidirektionale \"One-to-One\"-Assoziation an einem " +"Primärschlüssel</emphasis> verwendet in der Regel einen speziellen id-" +"Generator. (Bitte beachten Sie, dass wir in diesem Beispiel die Richtung der " +"Assoziation umgedreht haben)." + +#. Tag: title +#, fuzzy, no-c-format +msgid "One-to-many" +msgstr "\"One-to-Many\"" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A <emphasis>unidirectional one-to-many association on a foreign key</" +"emphasis> is an unusual case, and is not recommended." +msgstr "" +"Eine <emphasis>unidirektionale \"One-to-Many\"-Assoziation an einem " +"Fremdschlüssel</emphasis> ist sehr ungewöhnlich und wird nicht empfohlen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "You should instead use a join table for this kind of association." +msgstr "" +"Wir halten die Verwendung einer Verbundtabelle (sog. \"Join-Table\") bei " +"dieser Art von Assoziation für besser." + +#. Tag: title +#, no-c-format +msgid "Unidirectional associations with join tables" +msgstr "Unidirektionale Assoziationen mit Verbundtabellen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A <emphasis>unidirectional one-to-many association on a join table</" +"emphasis> is the preferred option. Specifying <literal>unique=\"true\"</" +"literal>, changes the multiplicity from many-to-many to one-to-many." +msgstr "" +"Eine <emphasis>unidirektionale \"One-to-Many\"-Assoziation an einer " +"Verbundtabelle</emphasis> ist vorzuziehen. Bitte beachten Sie, dass durch " +"die Spezifizierung von <literal>unique=\"true\"</literal>, die Multiplizität " +"von \"Many-to-Many\" zu \"One-to-Many\" geändert wurde." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A <emphasis>unidirectional many-to-one association on a join table</" +"emphasis> is common when the association is optional. For example:" +msgstr "" +"Eine <emphasis>unidirektionale \"Many-to-One\"-Assoziation an einer " +"Verbundtabelle</emphasis> ist recht gängig, wenn es sich um eine optionale " +"Assoziation handelt." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A <emphasis>unidirectional one-to-one association on a join table</emphasis> " +"is possible, but extremely unusual." +msgstr "" +"Eine <emphasis>unidirektionale \"One-to-One\"-Assoziation an einer " +"Verbundtabelle</emphasis> ist zwar sehr ungewöhnlich, aber möglich." + +#. Tag: title +#, fuzzy, no-c-format +msgid "Many-to-many" +msgstr "\"Many-to-Many\"" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Finally, here is an example of a <emphasis>unidirectional many-to-many " +"association</emphasis>." +msgstr "" +"Es gibt jedoch auch eine <emphasis>unidirektionale \"Many-to-Many\"-" +"Assoziation</emphasis>." + +#. Tag: title +#, no-c-format +msgid "Bidirectional associations" +msgstr "Bidirektionale Assoziationen" + +#. Tag: title +#, fuzzy, no-c-format +msgid "one-to-many / many-to-one" +msgstr "\"One-to-Many\" / \"Many-to-One\"" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A <emphasis>bidirectional many-to-one association</emphasis> is the most " +"common kind of association. The following example illustrates the standard " +"parent/child relationship." +msgstr "" +"Eine <emphasis>bidirektionale \"Many-to-One\"-Assoziation</emphasis> ist der " +"gängigste Assoziationstyp. (Die standardmäßige \"Parent/Child\"-Beziehung)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If you use a <literal>List</literal>, or other indexed collection, set the " +"<literal>key</literal> column of the foreign key to <literal>not null</" +"literal>. Hibernate will manage the association from the collections side to " +"maintain the index of each element, making the other side virtually inverse " +"by setting <literal>update=\"false\"</literal> and <literal>insert=\"false" +"\"</literal>:" +msgstr "" +"Falls Sie eine <literal>List</literal> (oder eine andere indizierte " +"Collection) verwenden, müssen Sie die <literal>key</literal>-Spalte des " +"Fremdschlüssels auf <literal>not null</literal> setzen und Hibernate die " +"Assoziation von Collection-Seite aus verwalten lassen, um den Index jeden " +"Elements aufrechtzuerhalten (die andere Seite durch Einstellung von " +"<literal>update=\"false\"</literal> und <literal>insert=\"false\"</literal> " +"somit invertierend):" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If the underlying foreign key column is <literal>NOT NULL</literal>, it is " +"important that you define <literal>not-null=\"true\"</literal> on the " +"<literal><key></literal> element of the collection mapping. Do not " +"only declare <literal>not-null=\"true\"</literal> on a possible nested " +"<literal><column></literal> element, but on the <literal><key></" +"literal> element." +msgstr "" +"Es ist wichtig, <literal>not-null=\"true\"</literal> im <literal><key>" +"</literal>-Element des Collection-Mappings zu definieren, falls die zu " +"Grunde liegende Spalte des Fremdschlüssels <literal>NOT NULL</literal> ist. " +"Deklarieren Sie nicht nur <literal>not-null=\"true\"</literal> für ein " +"mögliches verschachteltes <literal><column></literal>-Element, sondern " +"für das <literal><key></literal>-Element." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A <emphasis>bidirectional one-to-one association on a foreign key</emphasis> " +"is common:" +msgstr "" +"Eine <emphasis>bidirektionale \"One-to-One\"-Assoziation an einem " +"Fremdschlüssel</emphasis> ist recht gängig." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A <emphasis>bidirectional one-to-one association on a primary key</emphasis> " +"uses the special id generator:" +msgstr "" +"Eine <emphasis>bidirektionale \"One-to-One\"-Assoziation an einem " +"Primärschlüssel</emphasis> verwendet einen speziellen id-Generator." + +#. Tag: title +#, no-c-format +msgid "Bidirectional associations with join tables" +msgstr "Bidirektionale Assoziationen mit Verbundtabellen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The following is an example of a <emphasis>bidirectional one-to-many " +"association on a join table</emphasis>. The <literal>inverse=\"true\"</" +"literal> can go on either end of the association, on the collection, or on " +"the join." +msgstr "" +"Eine <emphasis>bidirektionale \"One-to-Many\"-Assoziation an einer " +"Verbundtabelle</emphasis>. Bitte beachten Sie, dass <literal>inverse=\"true" +"\"</literal> sich an beiden Enden der Assoziation, der Datenerfassung oder " +"des \"Join\" befinden kann." + +#. Tag: title +#, no-c-format +msgid "one to one" +msgstr "\"One-to-One\"" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A <emphasis>bidirectional one-to-one association on a join table</emphasis> " +"is possible, but extremely unusual." +msgstr "" +"Eine <emphasis>bidirektionale \"One-to-One\"-Assoziation an einer " +"Verbundtabelle</emphasis> ist zwar ungewöhnlich, aber möglich." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Here is an example of a <emphasis>bidirectional many-to-many association</" +"emphasis>." +msgstr "" +"Desweiteren gibt es eine <emphasis>bidirektionale \"Many-to-Many\"-" +"Assoziation</emphasis>." + +#. Tag: title +#, no-c-format +msgid "More complex association mappings" +msgstr "Komplexere Assoziations-Mappings" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"More complex association joins are <emphasis>extremely</emphasis> rare. " +"Hibernate handles more complex situations by using SQL fragments embedded in " +"the mapping document. For example, if a table with historical account " +"information data defines <literal>accountNumber</literal>, " +"<literal>effectiveEndDate</literal> and <literal>effectiveStartDate</" +"literal>columns, it would be mapped as follows:" +msgstr "" +"Komplexere Assoziationsverbünde sind <emphasis>sehr</emphasis> selten. " +"Hibernate macht es möglich, auch komplexe Situationen durch Verwendung von " +"im Mapping-Dokument eingebetteten SQL-Fragmenten zu berarbeiten. Wenn etwa " +"eine Tabelle mit historischen Daten zu Kontoinformationen " +"<literal>accountNumber</literal>, <literal>effectiveEndDate</literal> und " +"<literal>effectiveStartDate</literal>-Spalten definiert, so lautet das " +"Mapping wie folgt:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can then map an association to the <emphasis>current</emphasis> " +"instance, the one with null <literal>effectiveEndDate</literal>, by using:" +msgstr "" +"Anschließend kann eine Assoziation zur <emphasis>aktuellen</emphasis> " +"Instanz gemappt werden (diejenige mit \"Null\" <literal>effectiveEndDate</" +"literal>). Dies geschieht unter Verwendung von:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"In a more complex example, imagine that the association between " +"<literal>Employee</literal> and <literal>Organization</literal> is " +"maintained in an <literal>Employment</literal> table full of historical " +"employment data. An association to the employee's <emphasis>most recent</" +"emphasis> employer, the one with the most recent <literal>startDate</" +"literal>, could be mapped in the following way:" +msgstr "" +"Bei einem komplexeren Beispiel könnte etwa die Assoziation zwischen " +"<literal>Employee</literal> und <literal>Organization</literal> in einer " +"<literal>Employment</literal>-Tabelle voll historischer Beschäftigungsdaten " +"geführt werden. Eine Assoziation zum <emphasis>aktuellsten</emphasis> " +"Arbeitgeber eines Beschäftigten (derjenige mit dem aktuellsten " +"<literal>startDate</literal>) könnte folgendermaßen gemappt werden:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This functionality allows a degree of creativity and flexibility, but it is " +"more practical to handle these kinds of cases using HQL or a criteria query." +msgstr "" +"Diese Funktionalität erlaubt es Ihnen zwar kreativ zu sein, aber es ist in " +"der Regel praktischer diese Fälle mittels HQL oder einer Kriterienanfrage zu " +"behandeln." + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Person\">\n" +#~ " <id name=\"id\" column=\"personId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <many-to-one name=\"address\" \n" +#~ " column=\"addressId\"\n" +#~ " not-null=\"true\"/>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\">\n" +#~ " <id name=\"id\" column=\"addressId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Person\">\n" +#~ " <id name=\"id\" column=\"personId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <many-to-one name=\"address\" \n" +#~ " column=\"addressId\"\n" +#~ " not-null=\"true\"/>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\">\n" +#~ " <id name=\"id\" column=\"addressId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[\n" +#~ "create table Person ( personId bigint not null primary key, addressId " +#~ "bigint not null )\n" +#~ "create table Address ( addressId bigint not null primary key )\n" +#~ " ]]>" +#~ msgstr "" +#~ "create table Person ( personId bigint not null primary key, addressId " +#~ "bigint not null )\n" +#~ "create table Address ( addressId bigint not null primary key )" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Person\">\n" +#~ " <id name=\"id\" column=\"personId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <many-to-one name=\"address\" \n" +#~ " column=\"addressId\" \n" +#~ " unique=\"true\"\n" +#~ " not-null=\"true\"/>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\">\n" +#~ " <id name=\"id\" column=\"addressId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Person\">\n" +#~ " <id name=\"id\" column=\"personId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <many-to-one name=\"address\" \n" +#~ " column=\"addressId\" \n" +#~ " unique=\"true\"\n" +#~ " not-null=\"true\"/>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\">\n" +#~ " <id name=\"id\" column=\"addressId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[\n" +#~ "create table Person ( personId bigint not null primary key, addressId " +#~ "bigint not null unique )\n" +#~ "create table Address ( addressId bigint not null primary key )\n" +#~ " ]]>" +#~ msgstr "" +#~ "create table Person ( personId bigint not null primary key, addressId " +#~ "bigint not null unique )\n" +#~ "create table Address ( addressId bigint not null primary key )" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Person\">\n" +#~ " <id name=\"id\" column=\"personId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\">\n" +#~ " <id name=\"id\" column=\"personId\">\n" +#~ " <generator class=\"foreign\">\n" +#~ " <param name=\"property\">person</param>\n" +#~ " </generator>\n" +#~ " </id>\n" +#~ " <one-to-one name=\"person\" constrained=\"true\"/>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Person\">\n" +#~ " <id name=\"id\" column=\"personId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\">\n" +#~ " <id name=\"id\" column=\"personId\">\n" +#~ " <generator class=\"foreign\">\n" +#~ " <param name=\"property\">person</param>\n" +#~ " </generator>\n" +#~ " </id>\n" +#~ " <one-to-one name=\"person\" constrained=\"true\"/>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[\n" +#~ "create table Person ( personId bigint not null primary key )\n" +#~ "create table Address ( personId bigint not null primary key )\n" +#~ " ]]>" +#~ msgstr "" +#~ "create table Person ( personId bigint not null primary key )\n" +#~ "create table Address ( personId bigint not null primary key )" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Person\">\n" +#~ " <id name=\"id\" column=\"personId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <set name=\"addresses\">\n" +#~ " <key column=\"personId\" \n" +#~ " not-null=\"true\"/>\n" +#~ " <one-to-many class=\"Address\"/>\n" +#~ " </set>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\">\n" +#~ " <id name=\"id\" column=\"addressId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Person\">\n" +#~ " <id name=\"id\" column=\"personId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <set name=\"addresses\">\n" +#~ " <key column=\"personId\" \n" +#~ " not-null=\"true\"/>\n" +#~ " <one-to-many class=\"Address\"/>\n" +#~ " </set>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\">\n" +#~ " <id name=\"id\" column=\"addressId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[\n" +#~ "create table Person ( personId bigint not null primary key )\n" +#~ "create table Address ( addressId bigint not null primary key, personId " +#~ "bigint not null )\n" +#~ " ]]>" +#~ msgstr "" +#~ "create table Person ( personId bigint not null primary key )\n" +#~ "create table Address ( addressId bigint not null primary key, personId " +#~ "bigint not null )" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Person\">\n" +#~ " <id name=\"id\" column=\"personId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <set name=\"addresses\" table=\"PersonAddress\">\n" +#~ " <key column=\"personId\"/>\n" +#~ " <many-to-many column=\"addressId\"\n" +#~ " unique=\"true\"\n" +#~ " class=\"Address\"/>\n" +#~ " </set>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\">\n" +#~ " <id name=\"id\" column=\"addressId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Person\">\n" +#~ " <id name=\"id\" column=\"personId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <set name=\"addresses\" table=\"PersonAddress\">\n" +#~ " <key column=\"personId\"/>\n" +#~ " <many-to-many column=\"addressId\"\n" +#~ " unique=\"true\"\n" +#~ " class=\"Address\"/>\n" +#~ " </set>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\">\n" +#~ " <id name=\"id\" column=\"addressId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[\n" +#~ "create table Person ( personId bigint not null primary key )\n" +#~ "create table PersonAddress ( personId not null, addressId bigint not null " +#~ "primary key )\n" +#~ "create table Address ( addressId bigint not null primary key )\n" +#~ " ]]>" +#~ msgstr "" +#~ "create table Person ( personId bigint not null primary key )\n" +#~ "create table PersonAddress ( personId not null, addressId bigint \n" +#~ " not null primary key )\n" +#~ "create table Address ( addressId bigint not null primary key )" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Person\">\n" +#~ " <id name=\"id\" column=\"personId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <join table=\"PersonAddress\" \n" +#~ " optional=\"true\">\n" +#~ " <key column=\"personId\" unique=\"true\"/>\n" +#~ " <many-to-one name=\"address\"\n" +#~ " column=\"addressId\" \n" +#~ " not-null=\"true\"/>\n" +#~ " </join>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\">\n" +#~ " <id name=\"id\" column=\"addressId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Person\">\n" +#~ " <id name=\"id\" column=\"personId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <join table=\"PersonAddress\" \n" +#~ " optional=\"true\">\n" +#~ " <key column=\"personId\" unique=\"true\"/>\n" +#~ " <many-to-one name=\"address\"\n" +#~ " column=\"addressId\" \n" +#~ " not-null=\"true\"/>\n" +#~ " </join>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\">\n" +#~ " <id name=\"id\" column=\"addressId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[\n" +#~ "create table Person ( personId bigint not null primary key )\n" +#~ "create table PersonAddress ( personId bigint not null primary key, " +#~ "addressId bigint not null )\n" +#~ "create table Address ( addressId bigint not null primary key )\n" +#~ " ]]>" +#~ msgstr "" +#~ "create table Person ( personId bigint not null primary key )\n" +#~ "create table PersonAddress ( personId bigint not null primary key, " +#~ "addressId bigint not null )\n" +#~ "create table Address ( addressId bigint not null primary key )" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Person\">\n" +#~ " <id name=\"id\" column=\"personId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <join table=\"PersonAddress\" \n" +#~ " optional=\"true\">\n" +#~ " <key column=\"personId\" \n" +#~ " unique=\"true\"/>\n" +#~ " <many-to-one name=\"address\"\n" +#~ " column=\"addressId\" \n" +#~ " not-null=\"true\"\n" +#~ " unique=\"true\"/>\n" +#~ " </join>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\">\n" +#~ " <id name=\"id\" column=\"addressId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Person\">\n" +#~ " <id name=\"id\" column=\"personId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <join table=\"PersonAddress\" \n" +#~ " optional=\"true\">\n" +#~ " <key column=\"personId\" \n" +#~ " unique=\"true\"/>\n" +#~ " <many-to-one name=\"address\"\n" +#~ " column=\"addressId\" \n" +#~ " not-null=\"true\"\n" +#~ " unique=\"true\"/>\n" +#~ " </join>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\">\n" +#~ " <id name=\"id\" column=\"addressId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[\n" +#~ "create table Person ( personId bigint not null primary key )\n" +#~ "create table PersonAddress ( personId bigint not null primary key, " +#~ "addressId bigint not null unique )\n" +#~ "create table Address ( addressId bigint not null primary key )\n" +#~ " ]]>" +#~ msgstr "" +#~ "create table Person ( personId bigint not null primary key )\n" +#~ "create table PersonAddress ( personId bigint not null primary key, " +#~ "addressId bigint\n" +#~ " not null unique )\n" +#~ "create table Address ( addressId bigint not null primary key )" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Person\">\n" +#~ " <id name=\"id\" column=\"personId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <set name=\"addresses\" table=\"PersonAddress\">\n" +#~ " <key column=\"personId\"/>\n" +#~ " <many-to-many column=\"addressId\"\n" +#~ " class=\"Address\"/>\n" +#~ " </set>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\">\n" +#~ " <id name=\"id\" column=\"addressId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Person\">\n" +#~ " <id name=\"id\" column=\"personId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <set name=\"addresses\" table=\"PersonAddress\">\n" +#~ " <key column=\"personId\"/>\n" +#~ " <many-to-many column=\"addressId\"\n" +#~ " class=\"Address\"/>\n" +#~ " </set>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\">\n" +#~ " <id name=\"id\" column=\"addressId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[\n" +#~ "create table Person ( personId bigint not null primary key )\n" +#~ "create table PersonAddress ( personId bigint not null, addressId bigint " +#~ "not null, primary key (personId, addressId) )\n" +#~ "create table Address ( addressId bigint not null primary key )\n" +#~ " ]]>" +#~ msgstr "" +#~ "create table Person ( personId bigint not null primary key )\n" +#~ "create table PersonAddress ( personId bigint not null, addressId bigint " +#~ "not null, \n" +#~ " primary key (personId, addressId) )\n" +#~ "create table Address ( addressId bigint not null primary key )" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Person\">\n" +#~ " <id name=\"id\" column=\"personId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <many-to-one name=\"address\" \n" +#~ " column=\"addressId\"\n" +#~ " not-null=\"true\"/>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\">\n" +#~ " <id name=\"id\" column=\"addressId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <set name=\"people\" inverse=\"true\">\n" +#~ " <key column=\"addressId\"/>\n" +#~ " <one-to-many class=\"Person\"/>\n" +#~ " </set>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Person\">\n" +#~ " <id name=\"id\" column=\"personId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <many-to-one name=\"address\" \n" +#~ " column=\"addressId\"\n" +#~ " not-null=\"true\"/>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\">\n" +#~ " <id name=\"id\" column=\"addressId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <set name=\"people\" inverse=\"true\">\n" +#~ " <key column=\"addressId\"/>\n" +#~ " <one-to-many class=\"Person\"/>\n" +#~ " </set>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Person\">\n" +#~ " <id name=\"id\"/>\n" +#~ " ...\n" +#~ " <many-to-one name=\"address\"\n" +#~ " column=\"addressId\"\n" +#~ " not-null=\"true\"\n" +#~ " insert=\"false\"\n" +#~ " update=\"false\"/>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\">\n" +#~ " <id name=\"id\"/>\n" +#~ " ...\n" +#~ " <list name=\"people\">\n" +#~ " <key column=\"addressId\" not-null=\"true\"/>\n" +#~ " <list-index column=\"peopleIdx\"/>\n" +#~ " <one-to-many class=\"Person\"/>\n" +#~ " </list>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Person\">\n" +#~ " <id name=\"id\"/>\n" +#~ " ...\n" +#~ " <many-to-one name=\"address\"\n" +#~ " column=\"addressId\"\n" +#~ " not-null=\"true\"\n" +#~ " insert=\"false\"\n" +#~ " update=\"false\"/>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\">\n" +#~ " <id name=\"id\"/>\n" +#~ " ...\n" +#~ " <list name=\"people\">\n" +#~ " <key column=\"addressId\" not-null=\"true\"/>\n" +#~ " <list-index column=\"peopleIdx\"/>\n" +#~ " <one-to-many class=\"Person\"/>\n" +#~ " </list>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Person\">\n" +#~ " <id name=\"id\" column=\"personId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <many-to-one name=\"address\" \n" +#~ " column=\"addressId\" \n" +#~ " unique=\"true\"\n" +#~ " not-null=\"true\"/>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\">\n" +#~ " <id name=\"id\" column=\"addressId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <one-to-one name=\"person\" \n" +#~ " property-ref=\"address\"/>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Person\">\n" +#~ " <id name=\"id\" column=\"personId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <many-to-one name=\"address\" \n" +#~ " column=\"addressId\" \n" +#~ " unique=\"true\"\n" +#~ " not-null=\"true\"/>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\">\n" +#~ " <id name=\"id\" column=\"addressId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <one-to-one name=\"person\" \n" +#~ " property-ref=\"address\"/>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Person\">\n" +#~ " <id name=\"id\" column=\"personId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <one-to-one name=\"address\"/>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\">\n" +#~ " <id name=\"id\" column=\"personId\">\n" +#~ " <generator class=\"foreign\">\n" +#~ " <param name=\"property\">person</param>\n" +#~ " </generator>\n" +#~ " </id>\n" +#~ " <one-to-one name=\"person\" \n" +#~ " constrained=\"true\"/>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Person\">\n" +#~ " <id name=\"id\" column=\"personId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <one-to-one name=\"address\"/>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\">\n" +#~ " <id name=\"id\" column=\"personId\">\n" +#~ " <generator class=\"foreign\">\n" +#~ " <param name=\"property\">person</param>\n" +#~ " </generator>\n" +#~ " </id>\n" +#~ " <one-to-one name=\"person\" \n" +#~ " constrained=\"true\"/>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Person\">\n" +#~ " <id name=\"id\" column=\"personId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <set name=\"addresses\" \n" +#~ " table=\"PersonAddress\">\n" +#~ " <key column=\"personId\"/>\n" +#~ " <many-to-many column=\"addressId\"\n" +#~ " unique=\"true\"\n" +#~ " class=\"Address\"/>\n" +#~ " </set>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\">\n" +#~ " <id name=\"id\" column=\"addressId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <join table=\"PersonAddress\" \n" +#~ " inverse=\"true\" \n" +#~ " optional=\"true\">\n" +#~ " <key column=\"addressId\"/>\n" +#~ " <many-to-one name=\"person\"\n" +#~ " column=\"personId\"\n" +#~ " not-null=\"true\"/>\n" +#~ " </join>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Person\">\n" +#~ " <id name=\"id\" column=\"personId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <set name=\"addresses\" \n" +#~ " table=\"PersonAddress\">\n" +#~ " <key column=\"personId\"/>\n" +#~ " <many-to-many column=\"addressId\"\n" +#~ " unique=\"true\"\n" +#~ " class=\"Address\"/>\n" +#~ " </set>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\">\n" +#~ " <id name=\"id\" column=\"addressId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <join table=\"PersonAddress\" \n" +#~ " inverse=\"true\" \n" +#~ " optional=\"true\">\n" +#~ " <key column=\"addressId\"/>\n" +#~ " <many-to-one name=\"person\"\n" +#~ " column=\"personId\"\n" +#~ " not-null=\"true\"/>\n" +#~ " </join>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[\n" +#~ "create table Person ( personId bigint not null primary key )\n" +#~ "create table PersonAddress ( personId bigint not null, addressId bigint " +#~ "not null primary key )\n" +#~ "create table Address ( addressId bigint not null primary key )\n" +#~ " ]]>" +#~ msgstr "" +#~ "create table Person ( personId bigint not null primary key )\n" +#~ "create table PersonAddress ( personId bigint not null, addressId bigint " +#~ "not null primary key )\n" +#~ "create table Address ( addressId bigint not null primary key )" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Person\">\n" +#~ " <id name=\"id\" column=\"personId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <join table=\"PersonAddress\" \n" +#~ " optional=\"true\">\n" +#~ " <key column=\"personId\" \n" +#~ " unique=\"true\"/>\n" +#~ " <many-to-one name=\"address\"\n" +#~ " column=\"addressId\" \n" +#~ " not-null=\"true\"\n" +#~ " unique=\"true\"/>\n" +#~ " </join>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\">\n" +#~ " <id name=\"id\" column=\"addressId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <join table=\"PersonAddress\" \n" +#~ " optional=\"true\"\n" +#~ " inverse=\"true\">\n" +#~ " <key column=\"addressId\" \n" +#~ " unique=\"true\"/>\n" +#~ " <many-to-one name=\"person\"\n" +#~ " column=\"personId\" \n" +#~ " not-null=\"true\"\n" +#~ " unique=\"true\"/>\n" +#~ " </join>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Person\">\n" +#~ " <id name=\"id\" column=\"personId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <join table=\"PersonAddress\" \n" +#~ " optional=\"true\">\n" +#~ " <key column=\"personId\" \n" +#~ " unique=\"true\"/>\n" +#~ " <many-to-one name=\"address\"\n" +#~ " column=\"addressId\" \n" +#~ " not-null=\"true\"\n" +#~ " unique=\"true\"/>\n" +#~ " </join>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\">\n" +#~ " <id name=\"id\" column=\"addressId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <join table=\"PersonAddress\" \n" +#~ " optional=\"true\"\n" +#~ " inverse=\"true\">\n" +#~ " <key column=\"addressId\" \n" +#~ " unique=\"true\"/>\n" +#~ " <many-to-one name=\"person\"\n" +#~ " column=\"personId\" \n" +#~ " not-null=\"true\"\n" +#~ " unique=\"true\"/>\n" +#~ " </join>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Person\">\n" +#~ " <id name=\"id\" column=\"personId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <set name=\"addresses\" table=\"PersonAddress\">\n" +#~ " <key column=\"personId\"/>\n" +#~ " <many-to-many column=\"addressId\"\n" +#~ " class=\"Address\"/>\n" +#~ " </set>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\">\n" +#~ " <id name=\"id\" column=\"addressId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <set name=\"people\" inverse=\"true\" table=\"PersonAddress\">\n" +#~ " <key column=\"addressId\"/>\n" +#~ " <many-to-many column=\"personId\"\n" +#~ " class=\"Person\"/>\n" +#~ " </set>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Person\">\n" +#~ " <id name=\"id\" column=\"personId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <set name=\"addresses\" table=\"PersonAddress\">\n" +#~ " <key column=\"personId\"/>\n" +#~ " <many-to-many column=\"addressId\"\n" +#~ " class=\"Address\"/>\n" +#~ " </set>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\">\n" +#~ " <id name=\"id\" column=\"addressId\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <set name=\"people\" inverse=\"true\" table=\"PersonAddress\">\n" +#~ " <key column=\"addressId\"/>\n" +#~ " <many-to-many column=\"personId\"\n" +#~ " class=\"Person\"/>\n" +#~ " </set>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<properties name=\"currentAccountKey\">\n" +#~ " <property name=\"accountNumber\" type=\"string\" not-null=\"true\"/>\n" +#~ " <property name=\"currentAccount\" type=\"boolean\">\n" +#~ " <formula>case when effectiveEndDate is null then 1 else 0 end</" +#~ "formula>\n" +#~ " </property>\n" +#~ "</properties>\n" +#~ "<property name=\"effectiveEndDate\" type=\"date\"/>\n" +#~ "<property name=\"effectiveStateDate\" type=\"date\" not-null=\"true\"/>]]>" +#~ msgstr "" +#~ "<properties name=\"currentAccountKey\">\n" +#~ " <property name=\"accountNumber\" type=\"string\" not-null=\"true\"/" +#~ ">\n" +#~ " <property name=\"currentAccount\" type=\"boolean\">\n" +#~ " <formula>case when effectiveEndDate is null then 1 else 0 " +#~ "end</formula>\n" +#~ " </property>\n" +#~ "</properties>\n" +#~ "<property name=\"effectiveEndDate\" type=\"date\"/>\n" +#~ "<property name=\"effectiveStateDate\" type=\"date\" not-null=\"true\"/" +#~ ">" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<many-to-one name=\"currentAccountInfo\" \n" +#~ " property-ref=\"currentAccountKey\"\n" +#~ " class=\"AccountInfo\">\n" +#~ " <column name=\"accountNumber\"/>\n" +#~ " <formula>'1'</formula>\n" +#~ "</many-to-one>]]>" +#~ msgstr "" +#~ "<many-to-one name=\"currentAccountInfo\" \n" +#~ " property-ref=\"currentAccountKey\"\n" +#~ " class=\"AccountInfo\">\n" +#~ " <column name=\"accountNumber\"/>\n" +#~ " <formula>'1'</formula>\n" +#~ "</many-to-one>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<join>\n" +#~ " <key column=\"employeeId\"/>\n" +#~ " <subselect>\n" +#~ " select employeeId, orgId \n" +#~ " from Employments \n" +#~ " group by orgId \n" +#~ " having startDate = max(startDate)\n" +#~ " </subselect>\n" +#~ " <many-to-one name=\"mostRecentEmployer\" \n" +#~ " class=\"Organization\" \n" +#~ " column=\"orgId\"/>\n" +#~ "</join>]]>" +#~ msgstr "" +#~ "<join>\n" +#~ " <key column=\"employeeId\"/>\n" +#~ " <subselect>\n" +#~ " select employeeId, orgId \n" +#~ " from Employments \n" +#~ " group by orgId \n" +#~ " having startDate = max(startDate)\n" +#~ " </subselect>\n" +#~ " <many-to-one name=\"mostRecentEmployer\" \n" +#~ " class=\"Organization\" \n" +#~ " column=\"orgId\"/>\n" +#~ "</join>" Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/basic_mapping.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/basic_mapping.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/basic_mapping.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,6225 @@ +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# Language /mnt/hgfs/base/Hibernate/Reference translations for PACKAGE package. +# Copyright (C) 2006, 2007 Free Software Foundation, Inc. +# Automatically generated, 2006. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# +msgid "" +msgstr "" +"Project-Id-Version: Collection_Mapping\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2010-01-08T04:07:18\n" +"PO-Revision-Date: 2007-02-26 10:27+1000\n" +"Last-Translator: \n" +"Language-Team: <de(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.9.1\n" + +#. Tag: title +#, no-c-format +msgid "Basic O/R Mapping" +msgstr "Grundlagen des O/R Mappings" + +#. Tag: title +#, no-c-format +msgid "Mapping declaration" +msgstr "Mapping-Deklaration" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Object/relational mappings are usually defined in an XML document. The " +"mapping document is designed to be readable and hand-editable. The mapping " +"language is Java-centric, meaning that mappings are constructed around " +"persistent class declarations and not table declarations." +msgstr "" +"Objekt/relationale Mappings sind in der Regel in einem XML-Dokument " +"definiert. Das Mapping-Dokument ist so angelegt, dass es lesbar und manuell " +"veränderbar ist. Die Mapping-Sprache ist Java-zentrisch, d.h. Mappings sind " +"um die Deklarationen persistenter Klassen und nicht um Tabellen-" +"Deklarationen konstruiert." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Please note that even though many Hibernate users choose to write the XML by " +"hand, a number of tools exist to generate the mapping document. These " +"include XDoclet, Middlegen and AndroMDA." +msgstr "" +"Bitte beachten Sie, dass - obwohl viele Benutzer von Hibernate XML manuell " +"schreiben - es eine Reihe von Tools zur Generierung des Mapping-Dokuments " +"gibt, darunter XDoclet, Middlegen und AndroMDA." + +#. Tag: para +#, fuzzy, no-c-format +msgid "Here is an example mapping:" +msgstr "Beginnen wir mit einem Beispiel-Mapping:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"We will now discuss the content of the mapping document. We will only " +"describe, however, the document elements and attributes that are used by " +"Hibernate at runtime. The mapping document also contains some extra optional " +"attributes and elements that affect the database schemas exported by the " +"schema export tool (for example, the <literal> not-null</literal> attribute)." +msgstr "" +"Wir gehen nun auf den Inhalt des Mapping-Dokuments ein. Es werden nur die " +"von Hibernate zur Runtime verwendeten Elemente und Attribute des Dokuments " +"erläutert. Das Mapping-Dokument enthält außerdem einige optionale Attribute " +"und Elemente, die Einfluss auf die vom Schema-Export-Tool exportierten " +"Datenbankschemas haben. (Zum Beispiel das <literal> not-null</literal>-" +"Attribut)." + +#. Tag: title +#, no-c-format +msgid "Doctype" +msgstr "Doctype" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"All XML mappings should declare the doctype shown. The actual DTD can be " +"found at the URL above, in the directory <literal>hibernate-x.x.x/src/org/" +"hibernate </literal>, or in <literal>hibernate3.jar</literal>. Hibernate " +"will always look for the DTD in its classpath first. If you experience " +"lookups of the DTD using an Internet connection, check the DTD declaration " +"against the contents of your classpath." +msgstr "" +"Alle XML-Mappings sollten den gezeigten doctype deklarieren. Die " +"tatsächliche Dokumenttyp-Definition (\"DTD\") kann in der URL oben, im " +"Verzeichnis <literal>hibernate-x.x.x/src/org/hibernate </literal> oder in " +"<literal>hibernate3.jar</literal> gefunden werden. Hibernate wird stets " +"zuerst in seinem Klassenpfad nach der DTD suchen. Falls es bei Ihnen zu " +"Suchläufen der DTD mittels einer Internetverbindung kommt, überprüfen Sie " +"Ihre DTD-Deklaration hinsichtlich der Inhalte Ihres Klassenpfads." + +#. Tag: title +#, no-c-format +msgid "EntityResolver" +msgstr "EntityResolver" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate will first attempt to resolve DTDs in its classpath. It does this " +"is by registering a custom <literal>org.xml.sax.EntityResolver</literal> " +"implementation with the SAXReader it uses to read in the xml files. This " +"custom <literal>EntityResolver</literal> recognizes two different systemId " +"namespaces:" +msgstr "" +"Wie bereits erwähnt, wird Hibernate zuerst versuchen, DTDs in seinem " +"Klassenpfad aufzulösen. Dies geschieht, indem eine anwenderdefinierte " +"<literal>org.xml.sax.EntityResolver</literal>-Implementierung mit dem " +"SAXReader, der zum Lesen der xml-Dateien verwendet wird, registriert wird. " +"Dieser anwenderorientierte <literal>EntityResolver</literal> erkennt zwei " +"verschiedene \"systemId\"-Namensräume." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"a <literal>hibernate namespace</literal> is recognized whenever the resolver " +"encounters a systemId starting with <literal>http://hibernate.sourceforge." +"net/</literal>. The resolver attempts to resolve these entities via the " +"classloader which loaded the Hibernate classes." +msgstr "" +"ein <literal>hibernate namespace</literal> wird erkannt, sobald der " +"\"Resolver\" (Auflöser) einer mit <literal>http://hibernate.sourceforge.net/" +"</literal> beginnenden systemId begegnet. Der Resolver versucht diese " +"Entities über den Klassenlader (sog. \"Classloader\"), der die Hibernate-" +"Klassen geladen hat, aufzulösen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"a <literal>user namespace</literal> is recognized whenever the resolver " +"encounters a systemId using a <literal>classpath://</literal> URL protocol. " +"The resolver will attempt to resolve these entities via (1) the current " +"thread context classloader and (2) the classloader which loaded the " +"Hibernate classes." +msgstr "" +"ein <literal>user namespace</literal> wird erkannt, sobald der Resolver " +"einem <literal>classpath://</literal> URL-Protokoll verwendenden systemId " +"begegnet. Der Resolver wird versuchen, diese Entities über (1) den aktuellen " +"Thread-Kontext-Klassenlader und (2) den Klassenlader, der die Hibernate-" +"Klassen geladen hat, aufzulösen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "The following is an example of utilizing user namespacing:" +msgstr "Ein Beispiel der Verwendung des Benutzer-Namespacing:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Where <literal>types.xml</literal> is a resource in the <literal>your." +"domain</literal> package and contains a custom typedef (see <xref linkend=" +"\"mapping-types-custom\" />)." +msgstr "" +"Wo <literal>types.xml</literal> eine Ressource in im <literal>your.domain</" +"literal> Paket ist und eine anwenderdefinierte <xref linkend=\"mapping-types-" +"custom\"/>-Typedef enthält." + +#. Tag: title +#, fuzzy, no-c-format +msgid "Hibernate-mapping" +msgstr "hibernate-mapping" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This element has several optional attributes. The <literal>schema</literal> " +"and <literal>catalog</literal> attributes specify that tables referred to in " +"this mapping belong to the named schema and/or catalog. If they are " +"specified, tablenames will be qualified by the given schema and catalog " +"names. If they are missing, tablenames will be unqualified. The " +"<literal>default-cascade</literal> attribute specifies what cascade style " +"should be assumed for properties and collections that do not specify a " +"<literal>cascade</literal> attribute. By default, the <literal>auto-import</" +"literal> attribute allows you to use unqualified class names in the query " +"language." +msgstr "" +"Dieses Element besitzt mehrere optionale Attribute. Die <literal>schema</" +"literal> und <literal>catalog</literal>-Attribute spezifizieren, dass die in " +"diesem Mapping aufgeführten Tabellen zum genannten Schema und/oder Katalog " +"gehören. Falls bestimmt, werden Tabellennamen durch die gegebenen Schema- " +"und Katalognamen definiert. Falls nicht vorhanden, so bleiben die " +"Tabellennamen undefiniert. Das <literal>default-cascade</literal>-Attribut " +"bestimmt, welcher Weitergabestil (sog. \"Cascade-Style\" für Properties und " +"Collections angenommen werden sollte, die kein <literal>cascade</literal>-" +"Attribut spezifizieren. Das <literal>auto-import</literal>-Attribut erlaubt " +"die Verwendung undefinierter Klassennamen in der Abfragensprache in der " +"Standardeinstellung." + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>schema</literal> (optional): the name of a database schema." +msgstr "<literal>schema</literal> (optional): Der Name eines Datenbankschemas." + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>catalog</literal> (optional): the name of a database catalog." +msgstr "" +"<literal>catalog</literal> (optional): Der Name eines Datenbankkatalogs." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>default-cascade</literal> (optional - defaults to <literal>none</" +"literal>): a default cascade style." +msgstr "" +"<literal>default-cascade</literal> (optional - die Standardeinstellung " +"lautet <literal>none</literal>): Ein standardmäßiger Weitergabestil " +"(\"Cascade-Style\")." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>default-access</literal> (optional - defaults to <literal>property</" +"literal>): the strategy Hibernate should use for accessing all properties. " +"It can be a custom implementation of <literal>PropertyAccessor</literal>." +msgstr "" +"<literal>default-access</literal> (optional - der Standard ist " +"<literal>property</literal>): Die Strategie, die Hibernate für den Zugriff " +"auf alle Properties benutzen sollte. Kann eine anwenderdefinierte " +"Implementierung von <literal>PropertyAccessor</literal> sein." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>default-lazy</literal> (optional - defaults to <literal>true</" +"literal>): the default value for unspecified <literal>lazy</literal> " +"attributes of class and collection mappings." +msgstr "" +"<literal>default-lazy</literal> (optional - die Standardeinstellung lautet " +"<literal>true</literal>): Der Standardwert für nicht spezifizierte " +"<literal>lazy</literal> Attribute von Klassen- und Collection-Mappings." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>auto-import</literal> (optional - defaults to <literal>true</" +"literal>): specifies whether we can use unqualified class names of classes " +"in this mapping in the query language." +msgstr "" +"<literal>auto-import</literal> (optional - die Standardeinstellung lautet " +"<literal>true</literal>): Legt fest, ob in der Abfragensprache ein " +"undefinierter Klassenname verwendet werden kann (von Klassen in diesem " +"Mapping)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>package</literal> (optional): specifies a package prefix to use for " +"unqualified class names in the mapping document." +msgstr "" +"<literal>package</literal> (optional): Spezifiziert einen Paket-Präfix, der " +"für undefinierte Klassennamen im Mapping-Dokument angenommen werden soll." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If you have two persistent classes with the same unqualified name, you " +"should set <literal>auto-import=\"false\"</literal>. An exception will " +"result if you attempt to assign two classes to the same \"imported\" name." +msgstr "" +"Falls Sie zwei persistente Klassen mit demselben (undefinierten) Namen " +"besitzen, sollten Sie die Einstellung <literal>auto-import=\"false\"</" +"literal> vornehmen. Hibernate wird eine Ausnahme melden, wenn Sie versuchen, " +"zwei Klassen demselben \"importierten\" Namen zuzuordnen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>hibernate-mapping</literal> element allows you to nest several " +"persistent <literal><class></literal> mappings, as shown above. It is, " +"however, good practice (and expected by some tools) to map only a single " +"persistent class, or a single class hierarchy, in one mapping file and name " +"it after the persistent superclass. For example, <literal>Cat.hbm.xml</" +"literal>, <literal>Dog.hbm.xml</literal>, or if using inheritance, " +"<literal>Animal.hbm.xml</literal>." +msgstr "" +"Bitte beachten Sie, dass das <literal>hibernate-mapping</literal>-Element es " +"Ihnen ermöglicht, mehrere persistente <literal><class></literal>-" +"Mappings (wie oben dargestellt) zu verschachteln. Es ist jedoch eine gute " +"Angewohnheit (und wird von einigen Tools vorausgesetzt) nur eine einzelne " +"persistente Klasse (oder eine Einzelklassenhierarchie) in einer Mapping-" +"Datei zu mappen und diese nach der persistenten Superklasse zu benennen, z." +"B. <literal>Cat.hbm.xml</literal>, <literal>Dog.hbm.xml</literal> oder - " +"falls Sie \"Inheritance\" (d.h. Vererbung) verwenden - <literal>Animal.hbm." +"xml</literal>." + +#. Tag: title +#, fuzzy, no-c-format +msgid "Class" +msgstr "subclass" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can declare a persistent class using the <literal>class</literal> " +"element. For example:" +msgstr "" +"Sie können unter Verwendung des <literal>class</literal>-Elements eine " +"persistente Klasse deklarieren:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>name</literal> (optional): the fully qualified Java class name of " +"the persistent class or interface. If this attribute is missing, it is " +"assumed that the mapping is for a non-POJO entity." +msgstr "" +"<literal>name</literal> (optional): Der vollständige Java-Klassenname der " +"persistenten Klasse (oder des Interface). Falls dieses Attribut fehlt, wird " +"angenommen, dass es sich um das Mapping für eine nicht-POJO Entity handelt." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>table</literal> (optional - defaults to the unqualified class " +"name): the name of its database table." +msgstr "" +"<literal>table</literal> (optional - Standardeinstellung ist der " +"undefinierte Klassenname): Der Name der Datenbanktabelle." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>discriminator-value</literal> (optional - defaults to the class " +"name): a value that distinguishes individual subclasses that is used for " +"polymorphic behavior. Acceptable values include <literal>null</literal> and " +"<literal>not null</literal>." +msgstr "" +"<literal>discriminator-value</literal> (optional - Standard ist der " +"Klassenname): Ein Wert, der zwischen individuellen Subklassen unterscheidet " +"und für polymorphes Verhalten verwendet wird. Akzeptierte Werte sind " +"<literal>null</literal> und <literal>not null</literal>." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>mutable</literal> (optional - defaults to <literal>true</literal>): " +"specifies that instances of the class are (not) mutable." +msgstr "" +"<literal>mutable</literal> (optional, Standardeinstellung <literal>true</" +"literal>): Legt fest, dass die Instanzen der Klasse (nicht) variabel sind." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>schema</literal> (optional): overrides the schema name specified by " +"the root <literal><hibernate-mapping></literal> element." +msgstr "" +"<literal>schema</literal> (optional): Setzt den vom Hauptverzeichnis " +"<literal><hibernate-mapping></literal>-Element spezifizierten " +"Schemanamen außer Kraft." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>catalog</literal> (optional): overrides the catalog name specified " +"by the root <literal><hibernate-mapping></literal> element." +msgstr "" +"<literal>catalog</literal> (optional): Setzt den vom Hauptverzeichnis (\"Root" +"\") <literal><hibernate-mapping></literal>-Element spezifizierten " +"Katalognamen außer Kraft." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>proxy</literal> (optional): specifies an interface to use for lazy " +"initializing proxies. You can specify the name of the class itself." +msgstr "" +"<literal>proxy</literal> (optional): Bestimmt ein zu verwendendes Interface " +"für die Initialisierung von Proxies nur bei Bedarf (sog. \"Lazy Initializing " +"Proxies\"). Sie können den Namen der Klasse selbst festlegen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>dynamic-update</literal> (optional - defaults to <literal>false</" +"literal>): specifies that <literal>UPDATE</literal> SQL should be generated " +"at runtime and can contain only those columns whose values have changed." +msgstr "" +"<literal>dynamic-update</literal> (optional, Standardeinstellung " +"<literal>false</literal>): Bestimmt, dass <literal>UPDATE</literal> SQL zur " +"Runtime generiert wird und nur diejenigen Spalten enthalten soll, deren " +"Werte sich geändert haben." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>dynamic-insert</literal> (optional - defaults to <literal>false</" +"literal>): specifies that <literal>INSERT</literal> SQL should be generated " +"at runtime and contain only the columns whose values are not null." +msgstr "" +"<literal>dynamic-insert</literal> (optional, Standardeinstellung " +"<literal>false</literal>): Bestimmt, dass <literal>INSERT</literal> SQL zur " +"Runtime generiert wird und nur diejenigen Spalten enthalten soll, deren " +"Werte nicht \"Null\" sind." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>select-before-update</literal> (optional - defaults to " +"<literal>false</literal>): specifies that Hibernate should <emphasis>never</" +"emphasis> perform an SQL <literal>UPDATE</literal> unless it is certain that " +"an object is actually modified. Only when a transient object has been " +"associated with a new session using <literal>update()</literal>, will " +"Hibernate perform an extra SQL <literal>SELECT</literal> to determine if an " +"<literal>UPDATE</literal> is actually required." +msgstr "" +"<literal>select-before-update</literal> (optional, Standardeinstellung " +"<literal>false</literal>): Bestimmt, dass Hibernate <emphasis>nie</emphasis> " +"ein SQL <literal>UPDATE</literal> durchführt, außer es ist ganz sicher, dass " +"ein Objekt tatsächlich verändert wurde. In bestimmten Fällen (nur wenn ein " +"transientes Objekt unter Verwendung von <literal>update()</literal> mit " +"einer neuen Session in Verbindung gebracht wird), bedeutet dies, dass " +"Hibernate ein extra SQL <literal>SELECT</literal> durchführen wird, um zu " +"bestimmen, ob ein <literal>UPDATE</literal> tatsächlich erforderlich ist." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>polymorphism</literal> (optional - defaults to <literal>implicit</" +"literal>): determines whether implicit or explicit query polymorphism is " +"used." +msgstr "" +"<literal>polymorphism</literal> (optional, Standardeinstellung " +"<literal>implicit</literal>): Bestimmt, ob implizite oder explizite " +"Polymorphie für Anfragen verwendet wird." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>where</literal> (optional): specifies an arbitrary SQL " +"<literal>WHERE</literal> condition to be used when retrieving objects of " +"this class." +msgstr "" +"<literal>where</literal> (optional) legt eine beliebige SQL <literal>WHERE</" +"literal>-Bedingung zur Verwendung beim Aufruf von Objekten dieser Klasse fest" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>persister</literal> (optional): specifies a custom " +"<literal>ClassPersister</literal>." +msgstr "" +"<literal>persister</literal> (optional): Spezifiziert einen " +"anwenderdefinierten <literal>ClassPersister</literal>." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>batch-size</literal> (optional - defaults to <literal>1</literal>): " +"specifies a \"batch size\" for fetching instances of this class by " +"identifier." +msgstr "" +"<literal>batch-size</literal> (optional, Standardeinstellung <literal>1</" +"literal>) bestimmt eine Stapelgröße (sog. \"Batch Size\") für den Abruf von " +"Instanzen dieser Klasse durch den Bezeichner." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>optimistic-lock</literal> (optional - defaults to <literal>version</" +"literal>): determines the optimistic locking strategy." +msgstr "" +"<literal>optimistic-lock</literal> (optional, die Standardeinstellung lautet " +"<literal>version</literal>): Bestimmt die Strategie für das optimistische " +"Sperren (sog. \"Optimistic Locking\")." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>lazy</literal> (optional): lazy fetching can be disabled by setting " +"<literal>lazy=\"false\"</literal>." +msgstr "" +"<literal>lazy</literal> (optional): Mit der Einstellung <literal>lazy=\"false" +"\"</literal> deaktivieren Sie \"Lazy Fetching\" (d.h. das Nachladen " +"assoziierter Objekte bei Bedarf) vollständig." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>entity-name</literal> (optional - defaults to the class name): " +"Hibernate3 allows a class to be mapped multiple times, potentially to " +"different tables. It also allows entity mappings that are represented by " +"Maps or XML at the Java level. In these cases, you should provide an " +"explicit arbitrary name for the entity. See <xref linkend=\"persistent-" +"classes-dynamicmodels\" /> and <xref linkend=\"xml\" /> for more information." +msgstr "" +"<literal>entity-name</literal> (optional, Standardeinstellung ist der " +"Klassenname): Hibernate3 ermöglicht das mehrfache Mappen einer Klasse " +"(eventuell zu verschiedenen Tabellen) sowie durch Maps oder XML " +"repräsentierte Entity-Mappings auf Java-Ebene. In diesen Fällen sollte Sie " +"einen expliziten arbiträren Namen für die Entity bereitstellen. Unter <xref " +"linkend=\"persistent-classes-dynamicmodels\"/> und <xref linkend=\"xml\"/> " +"finden Sie weitere Information hierzu." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>check</literal> (optional): an SQL expression used to generate a " +"multi-row <emphasis>check</emphasis> constraint for automatic schema " +"generation." +msgstr "" +"<literal>check</literal> (optional): Ein SQL-Ausdruck wird verwendet, um " +"eine <emphasis>Datenüberprüfungs</emphasis>bedingung mehrerer Reihen für die " +"automatische Schemagenerierung zu erstellen. " + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>rowid</literal> (optional): Hibernate can use ROWIDs on databases. " +"On Oracle, for example, Hibernate can use the <literal>rowid</literal> extra " +"column for fast updates once this option has been set to <literal>rowid</" +"literal>. A ROWID is an implementation detail and represents the physical " +"location of a stored tuple." +msgstr "" +"<literal>rowid</literal> (optional): Hibernate kann so genannte ROWIDs bei " +"Datenbanken verwenden, die z.B. Oracle unterstützen. Hibernate kann die " +"Extraspalte von<literal>rowid</literal> für schnelle Aktualisierungen " +"verwenden, wenn Sie diese Option mit der Einstellung <literal>rowid</" +"literal> wählen. Eine ROWID ist ein Implementierungsdetail und repräsentiert " +"den realen Standort eines gespeicherten Tupel." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>subselect</literal> (optional): maps an immutable and read-only " +"entity to a database subselect. This is useful if you want to have a view " +"instead of a base table. See below for more information." +msgstr "" +"<literal>subselect</literal> (optional): Mappt eine unveränderbare und " +"schreibgeschützte Entity zu einer Datenbankunterauswahl (sog. \"Database " +"Subselect\"). Das ist von Nutzen, wenn Sie statt der Basistabelle eine " +"Ansicht wünschen, aber nicht haben. Weitere Informationen finden Sie unten." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>abstract</literal> (optional): is used to mark abstract " +"superclasses in <literal><union-subclass></literal> hierarchies." +msgstr "" +"<literal>abstract</literal> (optional): Wird verwendet, um abstrakte " +"Superklassen in <literal><union-subclass></literal>-Hierarchien zu " +"kennzeichnen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"It is acceptable for the named persistent class to be an interface. You can " +"declare implementing classes of that interface using the <literal><" +"subclass></literal> element. You can persist any <emphasis>static</" +"emphasis> inner class. Specify the class name using the standard form i.e. " +"<literal>e.g.Foo$Bar</literal>." +msgstr "" +"Es ist völlig in Ordnung, wenn es sich bei der benannten persistenten Klasse " +"um ein Interface handelt. Sie würden in diesem Fall implemetierende Klassen " +"dieses Interface unter Verwendung des <literal><subclass></literal>-" +"Elements deklarieren. Sie können jegliche <emphasis>static</emphasis> innere " +"Klassen (sog. \"inner class\") persistieren. Der Klassenname sollte unter " +"Verwendung des Standardformulars d.h. <literal>eg.Foo$Bar</literal> " +"spezifiziert werden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Immutable classes, <literal>mutable=\"false\"</literal>, cannot be updated " +"or deleted by the application. This allows Hibernate to make some minor " +"performance optimizations." +msgstr "" +"Unveränderliche Klassen, <literal>mutable=\"false\"</literal>, können durch " +"die Anwendung nicht aktualisiert oder gelöscht werden. Dies ermöglicht " +"Hibernate kleinere Optimierungen hinsichtlich der Performance." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The optional <literal>proxy</literal> attribute enables lazy initialization " +"of persistent instances of the class. Hibernate will initially return CGLIB " +"proxies that implement the named interface. The persistent object will load " +"when a method of the proxy is invoked. See \"Initializing collections and " +"proxies\" below." +msgstr "" +"Das optionale <literal>proxy</literal>-Attribut aktiviert die \"lazy " +"Initialization\" persistenter Instanzen der Klasse. Hibernate wird anfangs " +"mit CGLIB-Proxies reagieren, die das benannte Interface implementieren. Das " +"eigentliche persistente Objekt wird geladen, wenn eine Methode des Proxy " +"aufgerufen wird. Sehen Sie dazu \"Proxies für die Lazy Initialization\" " +"unten." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis>Implicit</emphasis> polymorphism means that instances of the class " +"will be returned by a query that names any superclass or implemented " +"interface or class, and that instances of any subclass of the class will be " +"returned by a query that names the class itself. <emphasis>Explicit</" +"emphasis> polymorphism means that class instances will be returned only by " +"queries that explicitly name that class. Queries that name the class will " +"return only instances of subclasses mapped inside this <literal><class>" +"</literal> declaration as a <literal><subclass></literal> or " +"<literal><joined-subclass></literal>. For most purposes, the default " +"<literal>polymorphism=\"implicit\"</literal> is appropriate. Explicit " +"polymorphism is useful when two different classes are mapped to the same " +"table This allows a \"lightweight\" class that contains a subset of the " +"table columns." +msgstr "" +"<emphasis>Implicit</emphasis>-Polymorphie bedeutet, dass die Instanzen der " +"Klasse von einer Anfrage beantwortet werden, die eine Superklasse, ein " +"implementiertes Interface oder die Klasse zurücksendet und die Instanzen " +"einer beliebigen Subklasse der betreffenden Klasse von einer die Klasse " +"selbst nennenden Anfrage zurückgeschickt werden. <emphasis>Explizite</" +"emphasis> Polymorphie bedeutet, dass die Instanzen der Klasse nur von " +"Anfragen zurückgeschickt werden, die die Klasse explizit nennen und nur auf " +"Instanzen, die innerhalb dieser <literal><class></literal> Deklaration " +"als <literal><subclass></literal> oder <literal><joined-subclass>" +"</literal> gemappt sind, reagiert wird. In den meisten Fällen ist die " +"Standardeinstellung <literal>polymorphism=\"implicit\"</literal> angemessen. " +"Explizite Polymorphie ist insbesondere dann von Nutzen, wenn zwei " +"verschiedene Klassen ein Mapping zu derselben Tabelle besitzen (es bietet " +"sich dadurch die Möglichkeit der Erstellung einer \"abgespeckten\" und alle " +"Tabellenspalten als Teilsatz enthaltenden Klasse)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>persister</literal> attribute lets you customize the " +"persistence strategy used for the class. You can, for example, specify your " +"own subclass of <literal>org.hibernate.persister.EntityPersister</literal>, " +"or you can even provide a completely new implementation of the interface " +"<literal>org.hibernate.persister.ClassPersister</literal> that implements, " +"for example, persistence via stored procedure calls, serialization to flat " +"files or LDAP. See <literal>org.hibernate.test.CustomPersister</literal> for " +"a simple example of \"persistence\" to a <literal>Hashtable</literal>." +msgstr "" +"Das <literal>persister</literal>-Attribut erlaubt die Anpassung der für die " +"Klasse zu verwendenden Persistenzstrategie. Sie können zum Beispiel Ihre " +"eigene Subklasse von <literal>org.hibernate.persister.EntityPersister</" +"literal> bestimmen oder sogar eine vollständig neue Implementierung des " +"Interface <literal>org.hibernate.persister.ClassPersister</literal> " +"bereitsstellen, das z.B. mittels gespeicherter Prozeduraufrufe, " +"Serialisierung verknüpfungsloser (zweidimensionaler Dateien (sog. \"flat " +"Files\") oder LDAP Persistenz implementiert. Siehe <literal>org.hibernate." +"test.CustomPersister</literal> für ein einfaches Beispiel (von \"Persistenz" +"\" zu einer <literal>Hashtable</literal>)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>dynamic-update</literal> and <literal>dynamic-insert</literal> " +"settings are not inherited by subclasses, so they can also be specified on " +"the <literal><subclass></literal> or <literal><joined-subclass></" +"literal> elements. Although these settings can increase performance in some " +"cases, they can actually decrease performance in others." +msgstr "" +"Bitte beachten Sie, dass die <literal>dynamic-update</literal> und " +"<literal>dynamic-insert</literal> Einstellungen nicht an die Subklassen " +"vererbt werden und daher auch in den <literal><subclass></literal> " +"oder <literal><joined-subclass></literal>-Elementen spezifiziert " +"werden können. Diese Einstellungen können die Performance in einigen Fällen " +"verbessern, in anderen Fällen jedoch auch verschlechtern. Verwenden Sie sie " +"daher umsichtig." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Use of <literal>select-before-update</literal> will usually decrease " +"performance. It is useful to prevent a database update trigger being called " +"unnecessarily if you reattach a graph of detached instances to a " +"<literal>Session</literal>." +msgstr "" +"Die Verwendung von <literal>select-before-update</literal> wird die " +"Performance in der Regel verschlechtern. Es ist sehr hilfreich, um den " +"Aufruf eines Datenbankaktualisierungs-Triggers abzufangen, wenn Sie einen " +"Graph abgesetzter Instanzen wieder an eine <literal>Session</literal> binden " +"möchten." + +#. Tag: para +#, no-c-format +msgid "" +"If you enable <literal>dynamic-update</literal>, you will have a choice of " +"optimistic locking strategies:" +msgstr "" +"Wenn Sie <literal>dynamic-update</literal> aktivieren, haben Sie die Wahl " +"zwischen verschiedenen Strategien für das optimistische Sperren:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>version</literal>: check the version/timestamp columns" +msgstr "<literal>version</literal> Prüfung der Version-/Zeitstempel-Spalten" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>all</literal>: check all columns" +msgstr "<literal>all</literal> Prüfung aller Spalten" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>dirty</literal>: check the changed columns, allowing some " +"concurrent updates" +msgstr "" +"<literal>dirty</literal> Prüfung der veränderten Spalten, Möglichkeit " +"einiger simultaner Aktualisierungen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>none</literal>: do not use optimistic locking" +msgstr "<literal>none</literal> verwendet kein optimistisches Sperren" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"It is <emphasis>strongly</emphasis> recommended that you use version/" +"timestamp columns for optimistic locking with Hibernate. This strategy " +"optimizes performance and correctly handles modifications made to detached " +"instances (i.e. when <literal>Session.merge()</literal> is used)." +msgstr "" +"Wir empfehlen <emphasis>sehr</emphasis> dringend die Verwendung von Version-/" +"Zeitstempel-Spalten für das optimistische Sperren mit Hibernate. Im Hinblick " +"auf die Performance handelt es sich dabei um die beste Strategie, und es ist " +"auch die einzige Strategie, die Veränderungen an abgesetzten Instanzen " +"korrekt bearbeitet (d.h. wenn <literal>Session.merge()</literal> verwendet " +"wird)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"There is no difference between a view and a base table for a Hibernate " +"mapping. This is transparent at the database level, although some DBMS do " +"not support views properly, especially with updates. Sometimes you want to " +"use a view, but you cannot create one in the database (i.e. with a legacy " +"schema). In this case, you can map an immutable and read-only entity to a " +"given SQL subselect expression:" +msgstr "" +"Es gibt keinen Unterschied zwischen einer Ansicht und einer Basistabelle für " +"ein Hibernate Mapping, und wie erwartet ist dies auf Datenbankebene " +"transparent (bitte beachten Sie, dass einige DBMS Ansichten nicht korrekt " +"unterstützen, insbesondere im Hinblick auf Aktualisierungen). Manchmal " +"möchten Sie zwar eine Ansicht verwenden, jedoch wird diese in der Datenbank " +"nicht erstellt (d.h. mit einem \"Legacy Schema\"). In diesem Fall können Sie " +"eine unveränderbare und schreibgeschützte Entity zu einem gegebenen SQL " +"Subselect-Ausdruck mappen:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Declare the tables to synchronize this entity with, ensuring that auto-flush " +"happens correctly and that queries against the derived entity do not return " +"stale data. The <literal><subselect></literal> is available both as an " +"attribute and a nested mapping element." +msgstr "" +"Deklarieren Sie die Tabellen mit denen diese Entity synchronisiert werden " +"soll und stellen Sie sicher, dass \"Auto-Flush\" ordnungsgemäß abläuft und " +"Anfragen an die abgeleitete Entity keine alten Daten wiedergeben. " +"<literal><subselect></literal> ist sowohl als Attribut als auch als " +"verschachteltes Mapping-Element verfügbar." + +#. Tag: title +#, fuzzy, no-c-format +msgid "id" +msgstr "uuid" + +#. Tag: para +#, no-c-format +msgid "" +"Mapped classes <emphasis>must</emphasis> declare the primary key column of " +"the database table. Most classes will also have a JavaBeans-style property " +"holding the unique identifier of an instance. The <literal><id></" +"literal> element defines the mapping from that property to the primary key " +"column." +msgstr "" +"Gemappte Klassen <emphasis>müssen</emphasis> die Spalte des Primärschlüssels " +"der Datenbanktabelle deklarieren. Die meisten Klassen werden außerdem eine " +"Property nach Art von JavaBeans besitzen, die den eindeutigen Bezeichner " +"einer Instanz enthält. Das <literal><id></literal>-Element definiert " +"das Mapping von der Property zur Spalte des Primärschlüssels." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>name</literal> (optional): the name of the identifier property." +msgstr "<literal>name</literal> (optional): Name der Bezeichner-Property." + +#. Tag: para +#, no-c-format +msgid "" +"<literal>type</literal> (optional): a name that indicates the Hibernate type." +msgstr "" +"<literal>type</literal> (optional): Ein Name, der den Hibernate-Typ anzeigt." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>column</literal> (optional - defaults to the property name): the " +"name of the primary key column." +msgstr "" +"<literal>column</literal> (optional - Standardeinstellung ist der Property-" +"Name): Der Name der Primärschlüsselspalte." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>unsaved-value</literal> (optional - defaults to a \"sensible\" " +"value): an identifier property value that indicates an instance is newly " +"instantiated (unsaved), distinguishing it from detached instances that were " +"saved or loaded in a previous session." +msgstr "" +"<literal>unsaved-value</literal> (optional - Standardeinstellung ist ein " +"\"sinnvoller\" Wert): Ein Wert der Bezeichner-Property, der anzeigt, dass " +"eine Instanz neu instanziiert (ungespeichert) ist und der sie von " +"abgesetzten Instanzen einer vorangegangenen Session unterscheidet, die " +"gespeichert oder geladen wurden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>access</literal> (optional - defaults to <literal>property</" +"literal>): the strategy Hibernate should use for accessing the property " +"value." +msgstr "" +"<literal>access</literal> (optional - Standardeinstellung ist " +"<literal>property</literal>): Die Strategie, die Hibernate für den Zugriff " +"auf den Property-Wert verwenden soll." + +#. Tag: para +#, no-c-format +msgid "" +"If the <literal>name</literal> attribute is missing, it is assumed that the " +"class has no identifier property." +msgstr "" +"Falls das <literal>name</literal>-Attribut fehlt, wird davon ausgegangen, " +"dass die Klasse keine Bezeichner-Property besitzt." + +#. Tag: para +#, no-c-format +msgid "" +"The <literal>unsaved-value</literal> attribute is almost never needed in " +"Hibernate3." +msgstr "" +"Das <literal>unsaved-value</literal>-Attribut wird in Hibernate3 fast nie " +"benötigt." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"There is an alternative <literal><composite-id></literal> declaration " +"that allows access to legacy data with composite keys. Its use is strongly " +"discouraged for anything else." +msgstr "" +"Es existiert eine alternative <literal><composite-id></literal>-" +"Deklaration, die Zugriff auf Stammdaten mit zusammengesetzten Schlüsseln " +"(sog. \"composite keys\") erlaubt. Wir empfehlen dringend, diese " +"ausschließlich hierfür zur verwenden." + +#. Tag: title +#, no-c-format +msgid "Generator" +msgstr "Programmgenerator" + +#. Tag: para +#, no-c-format +msgid "" +"The optional <literal><generator></literal> child element names a Java " +"class used to generate unique identifiers for instances of the persistent " +"class. If any parameters are required to configure or initialize the " +"generator instance, they are passed using the <literal><param></" +"literal> element." +msgstr "" +"Das optionale <literal><generator></literal>-Unterelement benennt eine " +"Java-Klasse, die zur Generierung eindeutiger Bezeichner für Instanzen der " +"persistenten Klasse verwendet werden. Falls Parameter zur Konfiguration oder " +"Initialisierung der Generatorinstanz benötigt werden, werden Sie unter " +"Verwendung des <literal><param></literal>-Elements weitergeleitet." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"All generators implement the interface <literal>org.hibernate.id." +"IdentifierGenerator</literal>. This is a very simple interface. Some " +"applications can choose to provide their own specialized implementations, " +"however, Hibernate provides a range of built-in implementations. The " +"shortcut names for the built-in generators are as follows:" +msgstr "" +"Alle Generatoren implementieren das Interface <literal>org.hibernate.id." +"IdentifierGenerator</literal>. Es handelt sich dabei um ein sehr einfaches " +"Interface; manche Anwendungen stellen ein eigenes, spezialisiertes Interface " +"bereit. Hiberante bietet jedoch eine Reihe eingebauter Implementierungen. " +"Für die eingebauten Generatoren existieren abgekürzte Namen:" + +#. Tag: term +#, fuzzy, no-c-format +msgid "<literal>increment</literal>" +msgstr "<literal>name</literal>: Der Property-Name." + +#. Tag: para +#, no-c-format +msgid "" +"generates identifiers of type <literal>long</literal>, <literal>short</" +"literal> or <literal>int</literal> that are unique only when no other " +"process is inserting data into the same table. <emphasis>Do not use in a " +"cluster.</emphasis>" +msgstr "" +"generiert Bezeichner des Typs <literal>long</literal>, <literal>short</" +"literal> oder <literal>int</literal>, die nur eindeutig sind, wenn kein " +"anderer Vorgang Daten derselben Tabelle hinzufügt. <emphasis>Nicht in einem " +"Cluster zu verwenden.</emphasis>" + +#. Tag: term +#, fuzzy, no-c-format +msgid "<literal>identity</literal>" +msgstr "<literal>id-type</literal>: Der Bezeichnertyp." + +#. Tag: para +#, no-c-format +msgid "" +"supports identity columns in DB2, MySQL, MS SQL Server, Sybase and " +"HypersonicSQL. The returned identifier is of type <literal>long</literal>, " +"<literal>short</literal> or <literal>int</literal>." +msgstr "" +"unterstützt die Identitätsspalten in DB2, MySQL, MS SQL Server, Sybase und " +"HypersonicSQL. Der zurückgesendete Bezeichner ist vom Typ <literal>long</" +"literal>, <literal>short</literal> oder <literal>int</literal>." + +#. Tag: term +#, fuzzy, no-c-format +msgid "<literal>sequence</literal>" +msgstr "<literal>name</literal>: Der Property-Name." + +#. Tag: para +#, no-c-format +msgid "" +"uses a sequence in DB2, PostgreSQL, Oracle, SAP DB, McKoi or a generator in " +"Interbase. The returned identifier is of type <literal>long</literal>, " +"<literal>short</literal> or <literal>int</literal>" +msgstr "" +"verwendet eine Sequenz in DB2, PostgreSQL, Oracle, SAP DB, McKoi oder einen " +"Generator in Interbase. Der zurückgeschickte Bezeichner ist vom Typ " +"<literal>long</literal>, <literal>short</literal> oder <literal>int</literal>" + +#. Tag: term +#, fuzzy, no-c-format +msgid "<literal>hilo</literal>" +msgstr "<literal>all</literal> Prüfung aller Spalten" + +#. Tag: para +#, no-c-format +msgid "" +"uses a hi/lo algorithm to efficiently generate identifiers of type " +"<literal>long</literal>, <literal>short</literal> or <literal>int</literal>, " +"given a table and column (by default <literal>hibernate_unique_key</literal> " +"and <literal>next_hi</literal> respectively) as a source of hi values. The " +"hi/lo algorithm generates identifiers that are unique only for a particular " +"database." +msgstr "" +"verwendet einen hi/lo Algorithmus um effizient Bezeichner des Typs " +"<literal>long</literal>, <literal>short</literal> oder <literal>int</" +"literal> zu generieren, bei gegebener Tabelle und Spalte " +"(Standardeinstellung lautet <literal>hibernate_unique_key</literal> bzw. " +"<literal>next_hi</literal>) als Quelle der hi-Werte. Der hi/lo-Algorithmus " +"generiert Bezeichner, die für eine bestimmte Datenbank eindeutig sind." + +#. Tag: term +#, no-c-format +msgid "<literal>seqhilo</literal>" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"uses a hi/lo algorithm to efficiently generate identifiers of type " +"<literal>long</literal>, <literal>short</literal> or <literal>int</literal>, " +"given a named database sequence." +msgstr "" +"verwendet einen hi/lo-Algorithmus um effizient Bezeichner des Typs " +"<literal>long</literal>, <literal>short</literal> oder <literal>int</" +"literal> zu generieren, bei einer vorgegebenen und benannten " +"Datenbanksequenz." + +#. Tag: term +#, fuzzy, no-c-format +msgid "<literal>uuid</literal>" +msgstr "<literal>id</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"uses a 128-bit UUID algorithm to generate identifiers of type string that " +"are unique within a network (the IP address is used). The UUID is encoded as " +"a string of 32 hexadecimal digits in length." +msgstr "" +"verwendet einen 128-bit UUID-Algorithmus, um Bezeichner des String-Typs " +"(Zeichenkettentyp) zu generieren, die innerhalb eines Netzwerks eindeutig " +"sind (die IP-Adresse wird verwendet). Der UUID (Universally Unique " +"Identifier) ist als Zeichenkette hexadezimaler Ziffern von 32 Zeichen Länge " +"verschlüsselt." + +#. Tag: term +#, fuzzy, no-c-format +msgid "<literal>guid</literal>" +msgstr "<literal>id</literal>" + +#. Tag: para +#, no-c-format +msgid "uses a database-generated GUID string on MS SQL Server and MySQL." +msgstr "" +"verwendet einen von der Datenbank generierten GUID-String auf dem MS SQL " +"Server und MySQL." + +#. Tag: term +#, fuzzy, no-c-format +msgid "<literal>native</literal>" +msgstr "<literal>name</literal>: Der Property-Name." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"selects <literal>identity</literal>, <literal>sequence</literal> or " +"<literal>hilo</literal> depending upon the capabilities of the underlying " +"database." +msgstr "" +"wählt <literal>identity</literal>, <literal>sequence</literal> oder " +"<literal>hilo</literal> je nach Leistungsfähigkeit der zu Grunde liegenden " +"Datenbank." + +#. Tag: term +#, fuzzy, no-c-format +msgid "<literal>assigned</literal>" +msgstr "<literal>name</literal>: Der Property-Name." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"lets the application assign an identifier to the object before <literal>save" +"()</literal> is called. This is the default strategy if no <literal><" +"generator></literal> element is specified." +msgstr "" +"lässt die Anwendung dem Objekt einen Bezeichner zuordnen ehe <literal>save()" +"</literal> aufgerufen wird. Falls kein <literal><generator></literal>-" +"Element festgelegt ist, so ist dies die Standardstrategie." + +#. Tag: term +#, fuzzy, no-c-format +msgid "<literal>select</literal>" +msgstr "<literal>all</literal> Prüfung aller Spalten" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"retrieves a primary key, assigned by a database trigger, by selecting the " +"row by some unique key and retrieving the primary key value." +msgstr "" +"ruft von einem Datenbank-Trigger zugeordnete Primärschlüssel auf, indem die " +"Reihe durch einen eindeutigen Schlüssel ausgewählt und der Wert des " +"Primärschlüssels abgefragt wird." + +#. Tag: term +#, no-c-format +msgid "<literal>foreign</literal>" +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"uses the identifier of another associated object. It is usually used in " +"conjunction with a <literal><one-to-one></literal> primary key " +"association." +msgstr "" +"verwendet den Bezeichner eines anderen zugehörigen Objekts. In der Regel in " +"Verbindung mit einer <literal><one-to-one></literal>-Assoziation des " +"Primärschlüssels verwendet." + +#. Tag: term +#, fuzzy, no-c-format +msgid "<literal>sequence-identity</literal>" +msgstr "sequence-identity" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"a specialized sequence generation strategy that utilizes a database sequence " +"for the actual value generation, but combines this with JDBC3 " +"getGeneratedKeys to return the generated identifier value as part of the " +"insert statement execution. This strategy is only supported on Oracle 10g " +"drivers targeted for JDK 1.4. Comments on these insert statements are " +"disabled due to a bug in the Oracle drivers." +msgstr "" +"eine spezialisierte Sequenzgenerierungsstrategie, die eine Datenbanksequenz " +"zu Generierung der tatsächlichen Werte verwendet. Dabei kombiniert sie diese " +"mit JDBC3 getGeneratedKeys, um den generierten Bezeichnerwert als Teil der " +"Ausführung der Einfügungsanweisung zurückzusenden. Diese Strategie wird bis " +"jetzt nur von auf JDK 1.4 ausgerichteten Oracle 10g Treibern unterstützt. " +"Bitte beachten Sie, dass Kommentare in diesen Einfügungsanweisungen aufgrund " +"eines Bugs innerhalb der Oracle Treiber deaktiviert sind." + +#. Tag: title +#, no-c-format +msgid "Hi/lo algorithm" +msgstr "Hi/lo-Algorithmus" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>hilo</literal> and <literal>seqhilo</literal> generators " +"provide two alternate implementations of the hi/lo algorithm. The first " +"implementation requires a \"special\" database table to hold the next " +"available \"hi\" value. Where supported, the second uses an Oracle-style " +"sequence." +msgstr "" +"Die <literal>hilo</literal> und <literal>seqhilo</literal>-Generatoren " +"stellen zwei alternierende Implementierungen des hi/lo-Algorithmus bereit, " +"einer bevorzugten Vorgehensweise bei der Bezeichnergenerierung. Die erste " +"Implementierung erfordert eine \"spezielle\" Datenbanktabelle, die den " +"nächstverfügbaren \"hi\"-Wert enthält. Die zweite verwendet eine Sequenz " +"nach Oracle-Art (falls unterstützt)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Unfortunately, you cannot use <literal>hilo</literal> when supplying your " +"own <literal>Connection</literal> to Hibernate. When Hibernate uses an " +"application server datasource to obtain connections enlisted with JTA, you " +"must configure the <literal>hibernate.transaction.manager_lookup_class</" +"literal>." +msgstr "" +"Leider können Sie <literal>hilo</literal> nicht verwenden, wenn Sie Ihre " +"eigene <literal>Connection</literal> für Hibernate bereitstellen. Wenn " +"Hibernate eine Datenquelle des Applikationsservers verwendet, um mit JTA " +"gelistete Verbindungen zu erhalten, müssen Sie die <literal>hibernate." +"transaction.manager_lookup_class</literal> korrekt konfigurieren." + +#. Tag: title +#, no-c-format +msgid "UUID algorithm" +msgstr "UUID-Algorithmus" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The UUID contains: IP address, startup time of the JVM that is accurate to a " +"quarter second, system time and a counter value that is unique within the " +"JVM. It is not possible to obtain a MAC address or memory address from Java " +"code, so this is the best option without using JNI." +msgstr "" +"Der UUID enthält: IP-Adresse, Startup-Zeit der JVM (bis auf eine " +"Viertelsekunde genau), Systemzeit und Zählerwert (innerhalb der JVM " +"eindeutig). Es ist nicht möglich, aus Java-Code eine MAC-Adresse oder " +"Speicheradresse zu erhalten, so dass es sich dabei um die bestmögliche " +"Option ohne Verwendung von JNI handelt." + +#. Tag: title +#, no-c-format +msgid "Identity columns and sequences" +msgstr "Identitätsspalten und Sequenzen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"For databases that support identity columns (DB2, MySQL, Sybase, MS SQL), " +"you can use <literal>identity</literal> key generation. For databases that " +"support sequences (DB2, Oracle, PostgreSQL, Interbase, McKoi, SAP DB) you " +"can use <literal>sequence</literal> style key generation. Both of these " +"strategies require two SQL queries to insert a new object. For example:" +msgstr "" +"Für Datenbanken, die Identitätsspalten unterstützen (DB2, MySQL, Sybase, MS " +"SQL), können Sie <literal>identity</literal>-Schlüsselgenerierung verwenden. " +"Für Datenbanken, die Sequenzen unterstützen (DB2, Oracle, PostgreSQL, " +"Interbase, McKoi, SAP DB) können Sie Schlüsselgenerierung nach " +"<literal>sequence</literal>-Art verwenden. Bei beiden Strategien muss ein " +"neues Objekt durch zwei SQL-Anfragen eingefügt werden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"For cross-platform development, the <literal>native</literal> strategy will, " +"depending on the capabilities of the underlying database, choose from the " +"<literal>identity</literal>, <literal>sequence</literal> and <literal>hilo</" +"literal> strategies." +msgstr "" +"Für die plattformübergreifende Entwicklung wählt die <literal>native</" +"literal> Strategie unter den <literal>identity</literal>, <literal>sequence</" +"literal> und <literal>hilo</literal>-Strategien je nach Leistungsfähigkeit " +"der zu Grunde liegenden Datenbank die entsprechende aus." + +#. Tag: title +#, no-c-format +msgid "Assigned identifiers" +msgstr "Zugeordnete Bezeichner" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If you want the application to assign identifiers, as opposed to having " +"Hibernate generate them, you can use the <literal>assigned</literal> " +"generator. This special generator uses the identifier value already assigned " +"to the object's identifier property. The generator is used when the primary " +"key is a natural key instead of a surrogate key. This is the default " +"behavior if you do not specify a <literal><generator></literal> " +"element." +msgstr "" +"Falls die Anwendung Bezeichner zuordnen soll (statt deren Generierung durch " +"Hibernate), so können Sie den <literal>assigned</literal>-Generator " +"verwenden. Dieser spezielle Generator wird den der Bezeichner-Property des " +"Objekts bereits zugeordneten Bezeichnerwert verwenden. Dieser Generator " +"kommt zum Einsatz, wenn es sich beim Primärschlüssel um einen natürlichen " +"statt einen Surrogatschlüssel handelt. Dieses ist das Standardverhalten, " +"wenn Sie kein <literal><generator></literal>-Element festlegen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>assigned</literal> generator makes Hibernate use " +"<literal>unsaved-value=\"undefined\"</literal>. This forces Hibernate to go " +"to the database to determine if an instance is transient or detached, unless " +"there is a version or timestamp property, or you define <literal>Interceptor." +"isUnsaved()</literal>." +msgstr "" +"Bei Auswahl des <literal>assigned</literal>-Generators verwendet Hibernate " +"<literal>unsaved-value=\"undefined\"</literal>, wodurch Hibernate in der " +"Datenbank prüfen muss, ob eine Instanz transient oder abgesetzt ist, falls " +"keine Version oder eine Zeitstempel-Property vorhanden sind oder Sie " +"<literal>Interceptor.isUnsaved()</literal> definieren." + +#. Tag: title +#, no-c-format +msgid "Primary keys assigned by triggers" +msgstr "Durch Trigger zugeordnete Primärschlüssel" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate does not generate DDL with triggers. It is for legacy schemas only." +msgstr "Nur für Legacy-Schemas (Hibernate generiert DDL nicht mit Triggern)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"In the above example, there is a unique valued property named " +"<literal>socialSecurityNumber</literal>. It is defined by the class, as a " +"natural key and a surrogate key named <literal>person_id</literal>, whose " +"value is generated by a trigger." +msgstr "" +"Im Beispiel oben ist eine eindeutige Property mit dem Namen " +"<literal>socialSecurityNumber</literal> definiert durch die Klasse als ein " +"natürlicher Schlüssel sowie einen Surrogatschlüssel mit Namen " +"<literal>person_id</literal>, dessen Wert durch einen Trigger generiert wird." + +#. Tag: title +#, fuzzy, no-c-format +msgid "Enhanced identifier generators" +msgstr "Die \"Getter\"-Methode des Bezeichners" + +#. Tag: para +#, no-c-format +msgid "" +"Starting with release 3.2.3, there are 2 new generators which represent a re-" +"thinking of 2 different aspects of identifier generation. The first aspect " +"is database portability; the second is optimization Optimization means that " +"you do not have to query the database for every request for a new identifier " +"value. These two new generators are intended to take the place of some of " +"the named generators described above, starting in 3.3.x. However, they are " +"included in the current releases and can be referenced by FQN." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"The first of these new generators is <literal>org.hibernate.id.enhanced." +"SequenceStyleGenerator</literal> which is intended, firstly, as a " +"replacement for the <literal>sequence</literal> generator and, secondly, as " +"a better portability generator than <literal>native</literal>. This is " +"because <literal>native</literal> generally chooses between " +"<literal>identity</literal> and <literal>sequence</literal> which have " +"largely different semantics that can cause subtle issues in applications " +"eyeing portability. <literal>org.hibernate.id.enhanced." +"SequenceStyleGenerator</literal>, however, achieves portability in a " +"different manner. It chooses between a table or a sequence in the database " +"to store its incrementing values, depending on the capabilities of the " +"dialect being used. The difference between this and <literal>native</" +"literal> is that table-based and sequence-based storage have the same exact " +"semantic. In fact, sequences are exactly what Hibernate tries to emulate " +"with its table-based generators. This generator has a number of " +"configuration parameters:" +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>sequence_name</literal> (optional, defaults to " +"<literal>hibernate_sequence</literal>): the name of the sequence or table to " +"be used." +msgstr "" +"<literal>column</literal> (optional - Standardeinstellung lautet " +"<literal>class</literal>) der Name der Diskriminatorspalte." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>initial_value</literal> (optional, defaults to <literal>1</" +"literal>): the initial value to be retrieved from the sequence/table. In " +"sequence creation terms, this is analogous to the clause typically named " +"\"STARTS WITH\"." +msgstr "" +"<literal>base</literal> (optional, standardmäßig <literal>0</literal>): Der " +"Wert der Indexspalte, die mit dem ersten Element der Liste oder Array " +"korrespondiert." + +#. Tag: para +#, no-c-format +msgid "" +"<literal>increment_size</literal> (optional - defaults to <literal>1</" +"literal>): the value by which subsequent calls to the sequence/table should " +"differ. In sequence creation terms, this is analogous to the clause " +"typically named \"INCREMENT BY\"." +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>force_table_use</literal> (optional - defaults to <literal>false</" +"literal>): should we force the use of a table as the backing structure even " +"though the dialect might support sequence?" +msgstr "" +"<literal>inverse</literal> (optional - standardmäßig <literal>false</" +"literal>) kennzeichnen Sie diese Collection als das \"invertierte\" Ende " +"einer biderektionalen Assoziation" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>value_column</literal> (optional - defaults to <literal>next_val</" +"literal>): only relevant for table structures, it is the name of the column " +"on the table which is used to hold the value." +msgstr "" +"<literal>column</literal> (optional - Standardeinstellung lautet " +"<literal>class</literal>) der Name der Diskriminatorspalte." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>optimizer</literal> (optional - defaults to <literal>none</" +"literal>): See <xref linkend=\"mapping-declaration-id-enhanced-optimizers\" /" +">" +msgstr "" +"<literal>cascade</literal> (optional- die Standardeinstellung lautet " +"<literal>none</literal>): der \"Cascade-Style\" (Weitergabestil)." + +#. Tag: para +#, no-c-format +msgid "" +"The second of these new generators is <literal>org.hibernate.id.enhanced." +"TableGenerator</literal>, which is intended, firstly, as a replacement for " +"the <literal>table</literal> generator, even though it actually functions " +"much more like <literal>org.hibernate.id.MultipleHiLoPerTableGenerator</" +"literal>, and secondly, as a re-implementation of <literal>org.hibernate.id." +"MultipleHiLoPerTableGenerator</literal> that utilizes the notion of " +"pluggable optimizers. Essentially this generator defines a table capable of " +"holding a number of different increment values simultaneously by using " +"multiple distinctly keyed rows. This generator has a number of configuration " +"parameters:" +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>table_name</literal> (optional - defaults to " +"<literal>hibernate_sequences</literal>): the name of the table to be used." +msgstr "" +"<literal>type</literal> (optional - die Standardeinstellung lautet " +"<literal>integer</literal>): Der Versionsnummerntyp." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>value_column_name</literal> (optional - defaults to " +"<literal>next_val</literal>): the name of the column on the table that is " +"used to hold the value." +msgstr "" +"<literal>column</literal> (optional - Standardeinstellung lautet " +"<literal>class</literal>) der Name der Diskriminatorspalte." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>segment_column_name</literal> (optional - defaults to " +"<literal>sequence_name</literal>): the name of the column on the table that " +"is used to hold the \"segment key\". This is the value which identifies " +"which increment value to use." +msgstr "" +"<literal>base</literal> (optional, standardmäßig <literal>0</literal>): Der " +"Wert der Indexspalte, die mit dem ersten Element der Liste oder Array " +"korrespondiert." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>segment_value</literal> (optional - defaults to <literal>default</" +"literal>): The \"segment key\" value for the segment from which we want to " +"pull increment values for this generator." +msgstr "" +"<literal>base</literal> (optional, standardmäßig <literal>0</literal>): Der " +"Wert der Indexspalte, die mit dem ersten Element der Liste oder Array " +"korrespondiert." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>segment_value_length</literal> (optional - defaults to " +"<literal>255</literal>): Used for schema generation; the column size to " +"create this segment key column." +msgstr "" +"<literal>column</literal> (optional - Standardeinstellung lautet " +"<literal>class</literal>) der Name der Diskriminatorspalte." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>initial_value</literal> (optional - defaults to <literal>1</" +"literal>): The initial value to be retrieved from the table." +msgstr "" +"<literal>type</literal> (optional - die Standardeinstellung lautet " +"<literal>integer</literal>): Der Versionsnummerntyp." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>increment_size</literal> (optional - defaults to <literal>1</" +"literal>): The value by which subsequent calls to the table should differ." +msgstr "" +"<literal>type</literal> (optional - die Standardeinstellung lautet " +"<literal>integer</literal>): Der Versionsnummerntyp." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>optimizer</literal> (optional - defaults to <literal></literal>): " +"See <xref linkend=\"mapping-declaration-id-enhanced-optimizers\" />" +msgstr "" +"<literal>cascade</literal> (optional- die Standardeinstellung lautet " +"<literal>none</literal>): der \"Cascade-Style\" (Weitergabestil)." + +#. Tag: title +#, no-c-format +msgid "Identifier generator optimization" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"For identifier generators that store values in the database, it is " +"inefficient for them to hit the database on each and every call to generate " +"a new identifier value. Instead, you can group a bunch of them in memory and " +"only hit the database when you have exhausted your in-memory value group. " +"This is the role of the pluggable optimizers. Currently only the two " +"enhanced generators (<xref linkend=\"mapping-declaration-id-enhanced\" /> " +"support this operation." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"<literal>none</literal> (generally this is the default if no optimizer was " +"specified): this will not perform any optimizations and hit the database for " +"each and every request." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"<literal>hilo</literal>: applies a hi/lo algorithm around the database " +"retrieved values. The values from the database for this optimizer are " +"expected to be sequential. The values retrieved from the database structure " +"for this optimizer indicates the \"group number\". The " +"<literal>increment_size</literal> is multiplied by that value in memory to " +"define a group \"hi value\"." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"<literal>pooled</literal>: as with the case of <literal>hilo</literal>, this " +"optimizer attempts to minimize the number of hits to the database. Here, " +"however, we simply store the starting value for the \"next group\" into the " +"database structure rather than a sequential value in combination with an in-" +"memory grouping algorithm. Here, <literal>increment_size</literal> refers to " +"the values coming from the database." +msgstr "" + +#. Tag: title +#, no-c-format +msgid "composite-id" +msgstr "composite-id" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A table with a composite key can be mapped with multiple properties of the " +"class as identifier properties. The <literal><composite-id></literal> " +"element accepts <literal><key-property></literal> property mappings " +"and <literal><key-many-to-one></literal> mappings as child elements." +msgstr "" +"Für eine Tabelle mit einem zusammengesetzten Schlüssel, können Sie mehrere " +"Properties der Klasse als Bezeichner-Properties mappen. Das <literal><" +"composite-id></literal>-Element akzeptiert <literal><key-property></" +"literal>-Property-Mappings und <literal><key-many-to-one></literal>-" +"Mappings als untergeordnete Elemente." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The persistent class <emphasis>must</emphasis> override <literal>equals()</" +"literal> and <literal>hashCode()</literal> to implement composite identifier " +"equality. It must also implement <literal>Serializable</literal>." +msgstr "" +"Ihre persistente Klasse <emphasis>muss</emphasis> sowohl <literal>equals()</" +"literal> als auch <literal>hashCode()</literal> außer Kraft setzen, um die " +"Gleichwertigkeit zusammengesetzter Bezeichner zu implementieren. Sie muss " +"außerdem <literal>Serializable</literal> implementieren." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Unfortunately, this approach means that a persistent object is its own " +"identifier. There is no convenient \"handle\" other than the object itself. " +"You must instantiate an instance of the persistent class itself and populate " +"its identifier properties before you can <literal>load()</literal> the " +"persistent state associated with a composite key. We call this approach an " +"<emphasis>embedded</emphasis> composite identifier, and discourage it for " +"serious applications." +msgstr "" +"Leider bedeutet diese Vorgehensweise bei zusammengesetzten Bezeichnern, dass " +"ein persistentes Objekt sein eigener Bezeichner ist. Es existiert keine " +"praktische \"Handhabung\" außer dem Objekt selbst. Sie müssen eine Instanz " +"der persistenten Klasse selbst instanziieren und deren Bezeichner-Properties " +"auffüllen, ehe Sie mit <literal>load()</literal> den persistenten Status " +"eines zugehörigen zusammengesetzten Schlüssels laden können. Diese " +"Vorgehensweise gilt als <emphasis>eingebetteter</emphasis> (\"embedded\") " +"zusammengesetzter Bezeichner und wird nicht für ernsthafte Anwendungen " +"empfohlen." + +#. Tag: para +#, no-c-format +msgid "" +"A second approach is what we call a <emphasis>mapped</emphasis> composite " +"identifier, where the identifier properties named inside the <literal><" +"composite-id></literal> element are duplicated on both the persistent " +"class and a separate identifier class." +msgstr "" +"Eine zweite Vorgehensweise trägt den Namen <emphasis>gemappter</emphasis> " +"zusammengesetzter Bezeichner (sog. \"mapped composite identifier\"), wobei " +"die innerhalb des <literal><composite-id></literal>-Elements genannten " +"Bezeichner-Properties sowohl an der persistenten Klasse als auch einer " +"separaten Bezeichnerklasse dupliziert werden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"In this example, both the composite identifier class, <literal>MedicareId</" +"literal>, and the entity class itself have properties named " +"<literal>medicareNumber</literal> and <literal>dependent</literal>. The " +"identifier class must override <literal>equals()</literal> and " +"<literal>hashCode()</literal> and implement <literal>Serializable</literal>. " +"The main disadvantage of this approach is code duplication." +msgstr "" +"In diesem Beispiel besitzen sowohl die Klasse des zusammengesetzten " +"Bezeichners <literal>MedicareId</literal> als auch die Entity-Klasse selbst " +"Properties mit dem Namen <literal>medicareNumber</literal> und " +"<literal>dependent</literal>. Die Bezeichnerklasse muss <literal>equals()</" +"literal> und <literal>hashCode()</literal> außer Kraft setzen und " +"<literal>Serializable</literal> implementieren. Der Nachteil dieser " +"Vorgehensweise ist offensichtlich— Code-Duplizierung." + +#. Tag: para +#, no-c-format +msgid "" +"The following attributes are used to specify a mapped composite identifier:" +msgstr "" +"Die folgenden Attribute werden verwendet, um einen gemappten " +"zusammengesetzten Bezeichner zu bestimmen:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>mapped</literal> (optional - defaults to <literal>false</literal>): " +"indicates that a mapped composite identifier is used, and that the contained " +"property mappings refer to both the entity class and the composite " +"identifier class." +msgstr "" +"<literal>mapped</literal> (optional, Standardeinstellung <literal>false</" +"literal>): zeigt an, dass ein gemappter zusammengesetzter Bezeichner " +"verwendet wird und die enthaltenen Property-Mappings auf die Entity-Klasse " +"und die zusammengesetzte Bezeichnerklasse verweisen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>class</literal> (optional - but required for a mapped composite " +"identifier): the class used as a composite identifier." +msgstr "" +"<literal>class</literal> (optional, für einen gemappten Bezeichner jedoch " +"erforderlich): Die als zusammengesetzter Bezeichner verwendete Klasse." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"We will describe a third, even more convenient approach, where the composite " +"identifier is implemented as a component class in <xref linkend=\"components-" +"compositeid\" />. The attributes described below apply only to this " +"alternative approach:" +msgstr "" +"Abschließend erläutern wir einen dritte, noch praktischere Vorgehensweise, " +"bei der der zusammengesetzte Bezeichner als Komponentenklasse in <xref " +"linkend=\"components-compositeid\"/> implementiert wird. Die unten " +"beschriebenen Attribute gelten nur für diese Vorgehensweise:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>name</literal> (optional - required for this approach): a property " +"of component type that holds the composite identifier. Please see chapter 9 " +"for more information." +msgstr "" +"<literal>name</literal> (optional, bei dieser Vorgehensweise erforderlich): " +"Eine Property nach Komponententyp, die den zusammengesetzten Bezeichner " +"enthält (siehe Kapitel 9)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>access</literal> (optional - defaults to <literal>property</" +"literal>): the strategy Hibernate uses for accessing the property value." +msgstr "" +"<literal>access</literal> (optional - Standardeinstellung ist " +"<literal>property</literal>): Die Strategie, die Hibernate für den Zugriff " +"auf den Property-Wert verwenden soll." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>class</literal> (optional - defaults to the property type " +"determined by reflection): the component class used as a composite " +"identifier. Please see the next section for more information." +msgstr "" +"<literal>class</literal> (optional - Standardeinstellung ist der durch die " +"Reflexion bestimmte Property-Typ): Die als ein zusammengesetzter " +"Bezeichnerverwendete Komponentenklasse (siehe nächster Abschnitt)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The third approach, an <emphasis>identifier component</emphasis>, is " +"recommended for almost all applications." +msgstr "" +"Bei dieser dritten Vorhegensweise empfehlen wir eine " +"<emphasis>Bezeichnerkomponente</emphasis> für fast alle Anwendungen." + +#. Tag: title +#, fuzzy, no-c-format +msgid "Discriminator" +msgstr "discriminator" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal><discriminator></literal> element is required for " +"polymorphic persistence using the table-per-class-hierarchy mapping " +"strategy. It declares a discriminator column of the table. The discriminator " +"column contains marker values that tell the persistence layer what subclass " +"to instantiate for a particular row. A restricted set of types can be used: " +"<literal>string</literal>, <literal>character</literal>, <literal>integer</" +"literal>, <literal>byte</literal>, <literal>short</literal>, " +"<literal>boolean</literal>, <literal>yes_no</literal>, <literal>true_false</" +"literal>." +msgstr "" +"Das <literal><discriminator></literal>-Element wird für die polymorphe " +"Persistenz unter Verwendung der Tabelle-pro-Klasse-Hierarchie (sog. \"table-" +"per-class-hierarchy\") Mapping-Strategie benötigt und deklariert eine " +"Diskriminatorspalte der Tabelle. Diese Diskriminatorspalte enthält " +"Markierungswerte, die der Persistenzschicht mitteilen, welche Subklasse für " +"eine bestimmte Reihe instanziiert werden soll. Ein beschränkter Typensatz " +"kann hierfür verwendet werden: <literal>string</literal>, " +"<literal>character</literal>, <literal>integer</literal>, <literal>byte</" +"literal>, <literal>short</literal>, <literal>boolean</literal>, " +"<literal>yes_no</literal>, <literal>true_false</literal>." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>column</literal> (optional - defaults to <literal>class</literal>): " +"the name of the discriminator column." +msgstr "" +"<literal>column</literal> (optional - Standardeinstellung lautet " +"<literal>class</literal>) der Name der Diskriminatorspalte." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>type</literal> (optional - defaults to <literal>string</literal>): " +"a name that indicates the Hibernate type" +msgstr "" +"<literal>type</literal> (optional - die Standardeinstellung lautet " +"<literal>string</literal>) ein Name, der den Hibernate-Typ angibt." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>force</literal> (optional - defaults to <literal>false</literal>): " +"\"forces\" Hibernate to specify the allowed discriminator values, even when " +"retrieving all instances of the root class." +msgstr "" +"<literal>force</literal> (optional - die Standardeinstellung lautet " +"<literal>false</literal>) \"zwingt\" Hibernate dazu, die erlaubten " +"Diskriminatorwerte beim Abruf aller Instanzen der Stammklasse zu " +"spezifizieren." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>insert</literal> (optional - defaults to <literal>true</literal>): " +"set this to <literal>false</literal> if your discriminator column is also " +"part of a mapped composite identifier. It tells Hibernate not to include the " +"column in SQL <literal>INSERTs</literal>." +msgstr "" +"<literal>insert</literal> (optional - die Standardeinstellung lautet " +"<literal>true</literal>) wählen Sie hier die Einstellung <literal>false</" +"literal>, falls Ihre Diskriminatortspalte auch Teil des zusammengesetzten " +"Bezeichners ist. (Hibernate wird mitgeteilt, die Spalte nicht in SQL " +"<literal>INSERT</literal>s mit einzuschließen)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>formula</literal> (optional): an arbitrary SQL expression that is " +"executed when a type has to be evaluated. It allows content-based " +"discrimination." +msgstr "" +"<literal>formula</literal> (optional) ein beliebiger SQL-Ausdruck, der " +"ausgeführt wird, wenn ein Typ evaluiert werden muss. Erlaubt inhaltsbasierte " +"Unterscheidung (sog. \"discrimination\")." + +#. Tag: para +#, no-c-format +msgid "" +"Actual values of the discriminator column are specified by the " +"<literal>discriminator-value</literal> attribute of the <literal><" +"class></literal> and <literal><subclass></literal> elements." +msgstr "" +"Die tatsächlichen Werte der Diskriminatorspalte werden durch das " +"<literal>discriminator-value</literal>-Attribut der <literal><class></" +"literal> und <literal><subclass></literal>-Elemente spezifiziert." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>force</literal> attribute is only useful if the table contains " +"rows with \"extra\" discriminator values that are not mapped to a persistent " +"class. This will not usually be the case." +msgstr "" +"Das <literal>force</literal>-Attribut ist (nur) von Nutzen, wenn die Tabelle " +"eine Reihe mit \"zusätzlichen\" Diskriminatorwerten enthält, die nicht zu " +"einer persistenten Klasse gemappt sind. Dies ist in der Regel jedoch nicht " +"der Fall." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>formula</literal> attribute allows you to declare an arbitrary " +"SQL expression that will be used to evaluate the type of a row. For example:" +msgstr "" +"Mit dem <literal>formula</literal>-Attribut können Sie einen beliebigen SQL-" +"Ausdruck deklarieren, der dann zur Evaluierung des Reihentyps verwendet wird:" + +#. Tag: title +#, fuzzy, no-c-format +msgid "Version (optional)" +msgstr "version (optional)" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal><version></literal> element is optional and indicates " +"that the table contains versioned data. This is particularly useful if you " +"plan to use <emphasis>long transactions</emphasis>. See below for more " +"information:" +msgstr "" +"Das <literal><version></literal>-Element ist optional und zeigt an, " +"dass die Tabelle versionierte Daten enthält. Das ist insbesondere dann " +"nützlich, wenn Sie vorhaben, <emphasis>lange Transaktionen</emphasis> zu " +"verwenden (siehe unten)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>column</literal> (optional - defaults to the property name): the " +"name of the column holding the version number." +msgstr "" +"<literal>column</literal> (optional - Standardeinstellung ist der Property-" +"Name): Der Name der Spalte, die die Versionsnummer enthält." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>name</literal>: the name of a property of the persistent class." +msgstr "" +"<literal>name</literal>: Der Name einer Property der persistenten Klasse." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>type</literal> (optional - defaults to <literal>integer</literal>): " +"the type of the version number." +msgstr "" +"<literal>type</literal> (optional - die Standardeinstellung lautet " +"<literal>integer</literal>): Der Versionsnummerntyp." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>access</literal> (optional - defaults to <literal>property</" +"literal>): the strategy Hibernate uses to access the property value." +msgstr "" +"<literal>access</literal> (optional - Standardeinstellung ist " +"<literal>property</literal>): Die Strategie, die Hibernate für den Zugriff " +"auf den Property-Wert verwenden soll." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>unsaved-value</literal> (optional - defaults to <literal>undefined</" +"literal>): a version property value that indicates that an instance is newly " +"instantiated (unsaved), distinguishing it from detached instances that were " +"saved or loaded in a previous session. <literal>Undefined</literal> " +"specifies that the identifier property value should be used." +msgstr "" +"<literal>unsaved-value</literal> (optional - die Standardeinstellung lautet " +"<literal>undefined</literal>): Ein Property-Wert der Version, der anzeigt, " +"dass eine Instanz neu instanziiert wurde (ungespeichert) und diese von " +"abgesetzten Instanzen, die in einer vorhergehenden Session bereits " +"gespeichert oder geladen wurden, unterscheidet. (<literal>undefined</" +"literal> legt fest, dass der Property-Wert des Bezeichners verwendet werden " +"sollte)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>generated</literal> (optional - defaults to <literal>never</" +"literal>): specifies that this version property value is generated by the " +"database. See the discussion of generated properties for more information " +"(<xref linkend=\"mapping-generated\" />)." +msgstr "" +"<literal>generated</literal> (optional - die Standardeinstellung lautet " +"<literal>never</literal>): Legt fest, dass der Property-Wert dieser Version " +"von der Datenbank generiert wird. Siehe dazu auch die Erläuterungen in <xref " +"linkend=\"mapping-generated\"/>." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>insert</literal> (optional - defaults to <literal>true</literal>): " +"specifies whether the version column should be included in SQL insert " +"statements. It can be set to <literal>false</literal> if the database column " +"is defined with a default value of <literal>0</literal>." +msgstr "" +"<literal>insert</literal> (optional - die Standardeinstellung lautet " +"<literal>true</literal>): Legt fest, ob die Versionsspalte in die SQL " +"Einfügungsanweisungen eingeschlossen werden soll. Die Einstellung kann " +"<literal>false</literal> lauten, wenn (und nur in diesem Fall) die " +"Datenbankspalte mit dem Standardwert <literal>0</literal> definiert ist." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Version numbers can be of Hibernate type <literal>long</literal>, " +"<literal>integer</literal>, <literal>short</literal>, <literal>timestamp</" +"literal> or <literal>calendar</literal>." +msgstr "" +"Die Versionsnummern können vom Hibernate-Typ <literal>long</literal>, " +"<literal>integer</literal>, <literal>short</literal>, <literal>timestamp</" +"literal> oder <literal>calendar</literal> sein." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A version or timestamp property should never be null for a detached " +"instance. Hibernate will detect any instance with a null version or " +"timestamp as transient, irrespective of what other <literal>unsaved-value</" +"literal> strategies are specified. <emphasis>Declaring a nullable version or " +"timestamp property is an easy way to avoid problems with transitive " +"reattachment in Hibernate. It is especially useful for people using assigned " +"identifiers or composite keys</emphasis>." +msgstr "" +"Eine Versions- oder Zeitstempel-Property sollte für abgesetzte Instanzen " +"niemals Null sein, damit Hibernate Instanzen mit Null-Version oder -" +"Zeitstempel als transient entdeckt, ganz unabhängig davon, welche anderen " +"<literal>unsaved-value</literal>-Strategien festgelegt sind. <emphasis>Die " +"Deklaration einer nullbaren Version oder Zeitstempel-Property ist eine " +"einfache Art, Probleme mit transitiver Wiederanbindung in Hibernate zu " +"vermeiden; besonders nützlich ist dies für Personen, die zugeteilte " +"Bezeichner oder zusammengesetzte Schlüssel verwenden!</emphasis>" + +#. Tag: title +#, fuzzy, no-c-format +msgid "Timestamp (optional)" +msgstr "Zeitstempel (optional)" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The optional <literal><timestamp></literal> element indicates that the " +"table contains timestamped data. This provides an alternative to versioning. " +"Timestamps are a less safe implementation of optimistic locking. However, " +"sometimes the application might use the timestamps in other ways." +msgstr "" +"Das optionale <literal><timestamp></literal>-Element zeigt an, dass " +"die Tabelle Daten mit Zeitstempel enthält. Dies ist als Alternative zur " +"Versionierung gedacht. Zeitstempel sind generell eine weniger sichere " +"Implementierung des optimistischen Sperrens. Jedoch wird die Anwendung die " +"Zeitstempel manchmal auf andere Weise benutzen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>column</literal> (optional - defaults to the property name): the " +"name of a column holding the timestamp." +msgstr "" +"<literal>column</literal> (optional - die Standardeinstellung ist der " +"Property-Name): Der Name einer Spalte, die den Zeitstempel enthält." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>name</literal>: the name of a JavaBeans style property of Java type " +"<literal>Date</literal> or <literal>Timestamp</literal> of the persistent " +"class." +msgstr "" +"<literal>name</literal>: Der Name einer Property im JavaBeans-Stil von Java-" +"Typ <literal>Date</literal> oder <literal>Timestamp</literal> der " +"persistenten Klasse." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>unsaved-value</literal> (optional - defaults to <literal>null</" +"literal>): a version property value that indicates that an instance is newly " +"instantiated (unsaved), distinguishing it from detached instances that were " +"saved or loaded in a previous session. <literal>Undefined</literal> " +"specifies that the identifier property value should be used." +msgstr "" +"<literal>unsaved-value</literal> (optional - die Standardeinstellung lautet " +"<literal>null</literal>): Ein Property-Wert der Version, der anzeigt, dass " +"eine Instanz neu instanziiert ungespeichert) wurde und sie von abgesetzten " +"Instanzen unterscheidet, die bereits in einer vorangegangenen Session " +"gespeichert oder geladen wurden. (<literal>undefined</literal> bestimmt, " +"dass der Property-Wert des Identifiers verwendet werden soll.)" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>source</literal> (optional - defaults to <literal>vm</literal>): " +"Where should Hibernate retrieve the timestamp value from? From the database, " +"or from the current JVM? Database-based timestamps incur an overhead because " +"Hibernate must hit the database in order to determine the \"next value\". It " +"is safer to use in clustered environments. Not all <literal>Dialects</" +"literal> are known to support the retrieval of the database's current " +"timestamp. Others may also be unsafe for usage in locking due to lack of " +"precision (Oracle 8, for example)." +msgstr "" +"<literal>source</literal> (optional - die Standardeinstellung lautet " +"<literal>vm</literal>): Wo soll Hibernate den Wert des Zeitstempels abrufen? " +"Von der Datenbank oder von der aktuellen JVM? Auf der Datenbank basierende " +"Zeitstempel können zu einem Overhead führen, da Hibernate auf die Datenbank " +"zugreifen muss, um den \"nächsten Wert\" zu bestimmen. In geclusterten " +"Umgebungen ist dies sicherer. Bitte beachten Sie, dass nicht alle " +"<literal>Dialect</literal>s den Abruf des aktuellen Zeitstempels von der " +"Datenbank unterstützen, während andere möglicherweise aufgrund mangelnder " +"Genauigkeit nicht beim Sperren verwendet werden sollten (zum Beispiel Oracle " +"8)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>generated</literal> (optional - defaults to <literal>never</" +"literal>): specifies that this timestamp property value is actually " +"generated by the database. See the discussion of generated properties for " +"more information (<xref linkend=\"mapping-generated\" />)." +msgstr "" +"<literal>generated</literal> (optional - die Standardeinstellung lautet " +"<literal>never</literal>): Bestimmt, dass der Property-Wert dieses " +"Zeitstempels tatsächlich durch die Datenbank generiert wird. Siehe dazu auch " +"die Erläuterungen unter <xref linkend=\"mapping-generated\"/>." + +#. Tag: title +#, no-c-format +msgid "Note" +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal><Timestamp></literal> is equivalent to <literal><version " +"type=\"timestamp\"></literal>. And <literal><timestamp source=\"db" +"\"></literal> is equivalent to <literal><version type=\"dbtimestamp" +"\"></literal>" +msgstr "" +"Bitte beachten Sie, dass <literal><timestamp></literal> äquivalent zu " +"<literal><version type=\"timestamp\"></literal> und <literal><" +"timestamp source=\"db\"></literal> äquivalent zu <literal><version " +"type=\"dbtimestamp\"></literal> ist" + +#. Tag: title +#, fuzzy, no-c-format +msgid "Property" +msgstr "property" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal><property></literal> element declares a persistent " +"JavaBean style property of the class." +msgstr "" +"Das <literal><property></literal>-Element deklariert eine persistente " +"Property der Klasse nach Art von JavaBean." + +#. Tag: para +#, no-c-format +msgid "" +"<literal>name</literal>: the name of the property, with an initial lowercase " +"letter." +msgstr "" +"<literal>name</literal>: Der Name der Property mit klein geschriebenem " +"Anfangsbuchstaben." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>column</literal> (optional - defaults to the property name): the " +"name of the mapped database table column. This can also be specified by " +"nested <literal><column></literal> element(s)." +msgstr "" +"<literal>column</literal> (optional - Standardeinstellung ist der Property-" +"Name): Der Name der gemappten Tabellenspalte der Datenbank. Dies kann auch " +"durch verschachtelte <literal><column></literal>-Element(e) " +"spezifiziert werden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>update, insert</literal> (optional - defaults to <literal>true</" +"literal>): specifies that the mapped columns should be included in SQL " +"<literal>UPDATE</literal> and/or <literal>INSERT</literal> statements. " +"Setting both to <literal>false</literal> allows a pure \"derived\" property " +"whose value is initialized from some other property that maps to the same " +"column(s), or by a trigger or other application." +msgstr "" +"<literal>update, insert</literal> (optional - die Standardeinstellung lautet " +"<literal>true</literal>): Legt fest, dass die gemappten Spalten in SQL " +"<literal>UPDATE</literal> und/oder <literal>INSERT</literal>-Anweisungen " +"eingeschlossen sein sollten. Die Einstellung beider auf <literal>false</" +"literal> gestattet eine reine \"abgeleitete\" Property, deren Wert von einer " +"anderen Property, die zu derselben/denselben Spalte(n) mappt oder durch " +"einen Trigger in einer anderen Anwendung, initialisiert wird." + +#. Tag: para +#, no-c-format +msgid "" +"<literal>formula</literal> (optional): an SQL expression that defines the " +"value for a <emphasis>computed</emphasis> property. Computed properties do " +"not have a column mapping of their own." +msgstr "" +"<literal>formula</literal> (optional): ein SQL-Ausdruck, der den Wert für " +"eine <emphasis>errechnete</emphasis> Property definiert. Errechnete " +"Properties besitzen kein eigenes Spalten-Mapping." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>lazy</literal> (optional - defaults to <literal>false</literal>): " +"specifies that this property should be fetched lazily when the instance " +"variable is first accessed. It requires build-time bytecode instrumentation." +msgstr "" +"<literal>lazy</literal> (optional - die Standardeinstellung lautet " +"<literal>false</literal>): Legt fest, dass diese Property mittels \"Lazy " +"Fetching\" (d.h. Nachladen assoziierter Objekte bei Bedarf) abgerufen werden " +"soll, wenn erstmals auf die Instanzvariable zugegriffen wird (erfordert " +"Build-time Bytecode Instrumentierung)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>unique</literal> (optional): enables the DDL generation of a unique " +"constraint for the columns. Also, allow this to be the target of a " +"<literal>property-ref</literal>." +msgstr "" +"<literal>unique</literal> (optional): Aktiviert die DDL-Generierung einer " +"eindeutigen Bedingung für die Spalten. Dies kann auch das Ziel (sog. \"target" +"\") einer <literal>property-ref</literal> sein." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>not-null</literal> (optional): enables the DDL generation of a " +"nullability constraint for the columns." +msgstr "" +"<literal>not-null</literal> (optional): Aktiviert die DDL-Generierung einer " +"\"Nullability\"-Bedingung für die Spalten." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>optimistic-lock</literal> (optional - defaults to <literal>true</" +"literal>): specifies that updates to this property do or do not require " +"acquisition of the optimistic lock. In other words, it determines if a " +"version increment should occur when this property is dirty." +msgstr "" +"<literal>optimistic-lock</literal> (optional - die Standardeinstellung " +"lautet <literal>true</literal>): Legt fest, ob Aktualisierungen (\"Updates" +"\") dieser Property die Erfassung einer optimistischen Sperre benötigen oder " +"nicht. Mit anderen Worten, es wird bestimmt, ob eine Erhöhung der Version " +"stattfinden soll, wenn die Inhalte dieser Property sich verändert haben (man " +"sagt sie sein dann \"dirty\")." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>generated</literal> (optional - defaults to <literal>never</" +"literal>): specifies that this property value is actually generated by the " +"database. See the discussion of generated properties for more information " +"(<xref linkend=\"mapping-generated\" />)." +msgstr "" +"<literal>generated</literal> (optional - die Standardeinstellung lautet " +"<literal>never</literal>): Legt fest, dass dieser Property-Wert tatsächlich " +"durch die Datenbank generiert ist. Siehe dazu auch die Erläuterungen unter " +"<xref linkend=\"mapping-generated\"/>." + +#. Tag: para +#, no-c-format +msgid "<emphasis>typename</emphasis> could be:" +msgstr "<emphasis>typename</emphasis> könnte sein:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The name of a Hibernate basic type: <literal>integer, string, character, " +"date, timestamp, float, binary, serializable, object, blob</literal> etc." +msgstr "" +"Der Name eines Hibernate Grundtyps (z.B. <literal>integer, string, " +"character, date, timestamp, float, binary, serializable, object, blob</" +"literal>)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The name of a Java class with a default basic type: <literal>int, float, " +"char, java.lang.String, java.util.Date, java.lang.Integer, java.sql.Clob</" +"literal> etc." +msgstr "" +"Der Name einer Java-Klasse mit einem Grundtyp als Standard (z.B. " +"<literal>int, float, char, java.lang.String, java.util.Date, java.lang." +"Integer, java.sql.Clob</literal>)." + +#. Tag: para +#, no-c-format +msgid "The name of a serializable Java class." +msgstr "Der Name einer serialisierbaren Java-Klasse." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The class name of a custom type: <literal>com.illflow.type.MyCustomType</" +"literal> etc." +msgstr "" +"Der Klassenname eines anwenderdefinierten Typs (z.B. <literal>com.illflow." +"type.MyCustomType</literal>)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If you do not specify a type, Hibernate will use reflection upon the named " +"property and guess the correct Hibernate type. Hibernate will attempt to " +"interpret the name of the return class of the property getter using, in " +"order, rules 2, 3, and 4. In certain cases you will need the <literal>type</" +"literal> attribute. For example, to distinguish between <literal>Hibernate." +"DATE</literal> and <literal>Hibernate.TIMESTAMP</literal>, or to specify a " +"custom type." +msgstr "" +"Falls Sie keinen Typ festlegen, so wird Hibernate mittels Reflexion an der " +"genannten Property versuchen, den korrekten Typ zu ermitteln. Hibernate wird " +"dabei versuchen, den Namen der Rückgabeklasse des Property-\"Getters\" unter " +"Verwendung der Regeln 2, 3, 4 (in dieser Reihenfolge) zu ermitteln. Das " +"reicht jedoch nicht immer. In bestimmten Fällen wird nach wie vor das " +"<literal>type</literal>-Attribut benötigt. (Um zum Beispiel zwischen " +"<literal>Hibernate.DATE</literal> und <literal>Hibernate.TIMESTAMP</literal> " +"zu unterscheiden oder einen anwenderdefinierten Typ zu bestimmen)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>access</literal> attribute allows you to control how Hibernate " +"accesses the property at runtime. By default, Hibernate will call the " +"property get/set pair. If you specify <literal>access=\"field\"</literal>, " +"Hibernate will bypass the get/set pair and access the field directly using " +"reflection. You can specify your own strategy for property access by naming " +"a class that implements the interface <literal>org.hibernate.property." +"PropertyAccessor</literal>." +msgstr "" +"Das <literal>access</literal>-Attribut ermöglicht Ihnen die Kontrolle " +"darüber, wie Hibernate zur Runtime auf die Property zugreift. In der " +"Standardeinstellung wird Hibernate das Get/Set-Paar der Property aufrufen. " +"Wenn Sie aber <literal>access=\"field\"</literal> festlegen, so wird " +"Hibernate das Get/Set-Paar umgehen und mittels Reflexion direkt auf das Feld " +"zugreifen. Sie können Ihre eigene Strategie für den Zugriff auf Properties " +"festlegen, indem Sie eine Klasse festlegen, die das Interface <literal>org." +"hibernate.property.PropertyAccessor</literal> implementiert." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A powerful feature is derived properties. These properties are by definition " +"read-only. The property value is computed at load time. You declare the " +"computation as an SQL expression. This then translates to a <literal>SELECT</" +"literal> clause subquery in the SQL query that loads an instance:" +msgstr "" +"Ein besonders leistungsstarkes Feature sind abgeleitete Properties. Diese " +"Properties sind definitionsgemäß schreibgeschützt, und ihr Wert wird zum " +"Zeitpunkt des Ladens errechnet. Sie deklarieren die Berechnung als einen SQL-" +"Ausdruck, was in eine <literal>SELECT</literal>-Klausel Unteranfrage in der " +"eine Instanz ladenden SQL-Anfrage übersetzt wird:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can reference the entity table by not declaring an alias on a particular " +"column. This would be <literal>customerId</literal> in the given example. " +"You can also use the nested <literal><formula></literal> mapping " +"element if you do not want to use the attribute." +msgstr "" +"Bitte beachten Sie, dass Sie auf die eigene Tabelle der Entities verweisen " +"können, indem Sie keinen Alias einer bestimmten Spalte deklarieren " +"(<literal>customerId</literal> in dem gegebenen Beispiel). Bitte beachten " +"Sie außerdem, dass Sie das verschachtelte <literal><formula></literal> " +"Mapping-Element statt des Attributs verwenden können." + +#. Tag: title +#, fuzzy, no-c-format +msgid "Many-to-one" +msgstr "many-to-one" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"An ordinary association to another persistent class is declared using a " +"<literal>many-to-one</literal> element. The relational model is a many-to-" +"one association; a foreign key in one table is referencing the primary key " +"column(s) of the target table." +msgstr "" +"Eine reguläre Assoziation zu einer anderen persistenten Klasse wird unter " +"Verwendung eines <literal>many-to-one</literal>-Elements deklariert. Das " +"relationale Modell ist eine \"Many-to-One\"-Assoziation: Der Fremdschlüssel " +"in einer Tabelle verweist auf die Spalte(n) des Primärschlüssels der " +"Zieltabelle." + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>name</literal>: the name of the property." +msgstr "<literal>name</literal>: Der Name der Property." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>column</literal> (optional): the name of the foreign key column. " +"This can also be specified by nested <literal><column></literal> " +"element(s)." +msgstr "" +"<literal>column</literal> (optional): Der Spaltenname des Fremdschlüssels. " +"Kann auch durch verschachtelte <literal><column></literal>-Element(e) " +"spezifiziert werden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>class</literal> (optional - defaults to the property type " +"determined by reflection): the name of the associated class." +msgstr "" +"<literal>class</literal> (optional - Standard ist der durch die Reflexion " +"bestimmte Property-Typ): Der Name der assoziierten Klasse." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>cascade</literal> (optional): specifies which operations should be " +"cascaded from the parent object to the associated object." +msgstr "" +"<literal>cascade</literal> (optional) legt fest, welche Vorgänge vom " +"übergeordneten Objekt an das assoziierte Objekt weitergegeben werden sollen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>fetch</literal> (optional - defaults to <literal>select</literal>): " +"chooses between outer-join fetching or sequential select fetching." +msgstr "" +"<literal>fetch</literal> (optional - die Standardeinstellung lautet " +"<literal>select</literal>): Wählt zwischen \"Outer-Join-Fetching\" oder " +"sequentiellem \"Select-Fetching\"." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>update, insert</literal> (optional - defaults to <literal>true</" +"literal>): specifies that the mapped columns should be included in SQL " +"<literal>UPDATE</literal> and/or <literal>INSERT</literal> statements. " +"Setting both to <literal>false</literal> allows a pure \"derived\" " +"association whose value is initialized from another property that maps to " +"the same column(s), or by a trigger or other application." +msgstr "" +"<literal>update, insert</literal> (optional - die Standardeinstellung lautet " +"<literal>true</literal>) legt fest, dass die gemappten Spalten in SQL " +"<literal>UPDATE</literal> und/oder <literal>INSERT</literal>-Anweisungen " +"eingeschlossen werden sollten. Wählt man bei beiden die Einstellung " +"<literal>false</literal>, so ist eine reine, \"abgeleitete\" Assoziation " +"möglich, deren Wert aus einer anderen Property, die zu derselben/denselben " +"Spalte(n) mappt oder durch einen Trigger oder eine andere Anwendung " +"initialisiert wird, möglich." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>property-ref</literal> (optional): the name of a property of the " +"associated class that is joined to this foreign key. If not specified, the " +"primary key of the associated class is used." +msgstr "" +"<literal>property-ref</literal>: (optional) Der Name einer Property der " +"assoziierten Klasse die mit diesem Fremdschlüssel verbunden ist. Falls nicht " +"festgelegt, so wird der Primärschlüssel der assoziierten Klasse verwendet." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>unique</literal> (optional): enables the DDL generation of a unique " +"constraint for the foreign-key column. By allowing this to be the target of " +"a <literal>property-ref</literal>, you can make the association multiplicity " +"one-to-one." +msgstr "" +"<literal>unique</literal> (optional): Aktiviert die DDL-Generierung einer " +"eindeutigen Bedingung für die Spalte des Fremdschlüssels. Kann auch das Ziel " +"einer <literal>property-ref</literal> sein. Dadurch ist die " +"Assoziationsmultiplizität \"one-to-one\" effektiv." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>not-null</literal> (optional): enables the DDL generation of a " +"nullability constraint for the foreign key columns." +msgstr "" +"<literal>not-null</literal> (optional): Aktiviert die DDL-Generierung einer " +"\"Nullability\"-Bedingung für die Fremdschlüsselspalten." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>lazy</literal> (optional - defaults to <literal>proxy</literal>): " +"by default, single point associations are proxied. <literal>lazy=\"no-proxy" +"\"</literal> specifies that the property should be fetched lazily when the " +"instance variable is first accessed. This requires build-time bytecode " +"instrumentation. <literal>lazy=\"false\"</literal> specifies that the " +"association will always be eagerly fetched." +msgstr "" +"<literal>lazy</literal> (optional - die Standardeinstellung lautet " +"<literal>proxy</literal>): In der Standardeinstellung werden \"Single-Point" +"\"-Assoziationen geproxied. <literal>lazy=\"no-proxy\"</literal> bestimmt, " +"dass für die Property \"lazy Fetching\" gilt (d.h. assoziierte Objekte " +"werden bei Bedarf nachgeladen), wenn erstmals auf die Instanzvariable " +"zugegriffen wird (erfordert Build-time Bytecode Instrumentierung). " +"<literal>lazy=\"false\"</literal> bestimmt, dass für die Assoziation stets " +"\"eager Fetching\" gilt (d.h. zusammengefasstes Laden von Objekt und " +"assoziierten Objekten mit Verbundoperationen)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>not-found</literal> (optional - defaults to <literal>exception</" +"literal>): specifies how foreign keys that reference missing rows will be " +"handled. <literal>ignore</literal> will treat a missing row as a null " +"association." +msgstr "" +"<literal>not-found</literal> (optional - standardmäßig <literal>exception</" +"literal>): Bestimmt, wie Fremdschlüssel, die auf fehlende Reihen verweisen, " +"behandelt werden. Mit <literal>ignore</literal> wird eine fehlende Reihe als " +"Null-Assoziation angesehen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>entity-name</literal> (optional): the entity name of the associated " +"class." +msgstr "" +"<literal>entity-name</literal> (optional): Der Entity-Name der assoziierten " +"Klasse." + +#. Tag: para +#, no-c-format +msgid "" +"<literal>formula</literal> (optional): an SQL expression that defines the " +"value for a <emphasis>computed</emphasis> foreign key." +msgstr "" +"<literal>formula</literal> (optional): Ein SQL-Ausdruck, der den Wert für " +"einen <emphasis>errechneten</emphasis> Fremdschlüssel definiert." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Setting a value of the <literal>cascade</literal> attribute to any " +"meaningful value other than <literal>none</literal> will propagate certain " +"operations to the associated object. The meaningful values are divided into " +"three categories. First, basic operations, which include: <literal>persist, " +"merge, delete, save-update, evict, replicate, lock and refresh</literal>; " +"second, special values: <literal>delete-orphan</literal>; and third," +"<literal>all</literal> comma-separated combinations of operation names: " +"<literal>cascade=\"persist,merge,evict\"</literal> or <literal>cascade=\"all," +"delete-orphan\"</literal>. See <xref linkend=\"objectstate-transitive\" /> " +"for a full explanation. Note that single valued, many-to-one and one-to-one, " +"associations do not support orphan delete." +msgstr "" +"Wird der Wert des <literal>cascade</literal>-Attributs auf einen anderen " +"sinnvollen Wert als <literal>none</literal> gesetzt, so pflanzen sich " +"bestimmte Vorgänge zum zugehörigen Objekt fort. Zu den sinnvollen Werten " +"gehören Hibernates Grundvorgänge <literal>persist, merge, delete, save-" +"update, evict, replicate, lock, refresh</literal>, die Sonderwerte " +"<literal>delete-orphan</literal> und <literal>all</literal> sowie durch " +"Komma getrennte Kombinationen von Vorgangsnamen, zum Beispiel " +"<literal>cascade=\"persist,merge,evict\"</literal> oder <literal>cascade=" +"\"all,delete-orphan\"</literal>. Eine vollständige Erläuterung hierzu finden " +"Sie unter <xref linkend=\"objectstate-transitive\"/>. Bitte beachten Sie, " +"dass einwertige Assoziationen (Many-to-One und One-to-One Assoziationen) " +"\"Orphan Delete\" nicht unterstützen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Here is an example of a typical <literal>many-to-one</literal> declaration:" +msgstr "" +"Eine typische <literal>many-to-one</literal>-Deklaration sieht so " +"unkompliziert wie die Folgende aus:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>property-ref</literal> attribute should only be used for " +"mapping legacy data where a foreign key refers to a unique key of the " +"associated table other than the primary key. This is a complicated and " +"confusing relational model. For example, if the <literal>Product</literal> " +"class had a unique serial number that is not the primary key. The " +"<literal>unique</literal> attribute controls Hibernate's DDL generation with " +"the SchemaExport tool." +msgstr "" +"Das <literal>property-ref</literal>-Attribut sollte nur für das Mapping von " +"Stammdaten verwendet werden, in denen ein Fremdschlüssel auf einen " +"eindeutigen Schlüssel der assoziierten Tabelle verweist, der nicht der " +"Primärschlüssel ist. Es handelt sich dabei um ein nicht besonders " +"ansehnliches relationales Modell. Nehmen wir zum Beispiel an, dass die " +"<literal>Product</literal>-Klasse eine eindeutige Seriennummer besitzt, die " +"nicht der Primärschlüssel ist. (Das <literal>unique</literal>-Attribut " +"steuert Hibernates DDL-Generierung mittels dem SchemaExport-Tool)." + +#. Tag: para +#, no-c-format +msgid "Then the mapping for <literal>OrderItem</literal> might use:" +msgstr "" +"Dann könnte das Mapping für <literal>OrderItem</literal> folgendes verwenden:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "This is not encouraged, however." +msgstr "Allerdings wird dies nicht empfohlen." + +#. Tag: para +#, no-c-format +msgid "" +"If the referenced unique key comprises multiple properties of the associated " +"entity, you should map the referenced properties inside a named <literal><" +"properties></literal> element." +msgstr "" +"Wenn der eindeutige Schlüssel, auf den verwiesen wird, mehrere Properties " +"der zugehörigen Entity enthält, so sollten die Properties, auf die verwiesen " +"wird, in einem benannten <literal><properties></literal>-Element " +"gemappt werden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If the referenced unique key is the property of a component, you can specify " +"a property path:" +msgstr "" +"Falls der eindeutige Schlüssel, auf den verwiesen wird, die Property einer " +"Komponente ist, so können Sie einen Property-Pfad festlegen:" + +#. Tag: title +#, fuzzy, no-c-format +msgid "One-to-one" +msgstr "one-to-one" + +#. Tag: para +#, no-c-format +msgid "" +"A one-to-one association to another persistent class is declared using a " +"<literal>one-to-one</literal> element." +msgstr "" +"Eine \"One-to-One\"-Assoziation mit einer anderen persistenten Klasse wird " +"unter Verwendung eines <literal>one-to-one</literal>-Elements deklariert." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>constrained</literal> (optional): specifies that a foreign key " +"constraint on the primary key of the mapped table and references the table " +"of the associated class. This option affects the order in which <literal>save" +"()</literal> and <literal>delete()</literal> are cascaded, and determines " +"whether the association can be proxied. It is also used by the schema export " +"tool." +msgstr "" +"<literal>constrained</literal> (optional) legt fest, dass eine " +"Fremdschlüsselbedingung auf dem Primärschlüssel der gemappten Tabelle auf " +"die Tabelle der assoziierten Klasse verweist. Diese Option hat Einfluss auf " +"die Reihenfolge in der <literal>save()</literal> und <literal>delete()</" +"literal> aufeinander folgen und bestimmt, ob die Assoziation geproxied " +"werden kann (wird auch vom Schema-Export-Tool verwendet)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>property-ref</literal> (optional): the name of a property of the " +"associated class that is joined to the primary key of this class. If not " +"specified, the primary key of the associated class is used." +msgstr "" +"<literal>property-ref</literal>: (optional) Der Name einer Property der " +"assoziierten Klasse, die mit dem Primärschlüssel dieser Klasse verbunden " +"ist. Falls nicht anders festgelegt, so wird der Primärschlüssel der " +"assoziierten Klasse verwendet." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>formula</literal> (optional): almost all one-to-one associations " +"map to the primary key of the owning entity. If this is not the case, you " +"can specify another column, columns or expression to join on using an SQL " +"formula. See <literal>org.hibernate.test.onetooneformula</literal> for an " +"example." +msgstr "" +"<literal>formula</literal> (optional): Fast alle \"One-to-One\" -" +"Assoziationen mappen zum Primärschlüssel der Entity, die sie besitzt. Im " +"seltenen Falle, dass dem nicht so ist, können Sie festlegen, dass sich eine " +"andere Spalte, Spalten oder Ausdruck unter Verwendung einer SQL-Formel " +"verbinden. (Siehe zum Beispiel <literal>org.hibernate.test.onetooneformula</" +"literal>)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>lazy</literal> (optional - defaults to <literal>proxy</literal>): " +"by default, single point associations are proxied. <literal>lazy=\"no-proxy" +"\"</literal> specifies that the property should be fetched lazily when the " +"instance variable is first accessed. It requires build-time bytecode " +"instrumentation. <literal>lazy=\"false\"</literal> specifies that the " +"association will always be eagerly fetched. <emphasis>Note that if " +"<literal>constrained=\"false\"</literal>, proxying is impossible and " +"Hibernate will eagerly fetch the association</emphasis>." +msgstr "" +"<literal>lazy</literal> (optional - die Standardeinstellung lautet " +"<literal>proxy</literal>): In der Standardeinstellung werden \"Single-Point" +"\"-Assoziationen geproxied. <literal>lazy=\"no-proxy\"</literal> legt fest, " +"dass für die Property \"lazy Fetching\" gilt (d.h. assoziierte Objekte " +"werden bei Bedarf nachgeladen), wenn erstmals auf die Instanzvariable " +"zugegriffen wird (erfordert Build-time Bytecode Instrumentierung). " +"<literal>lazy=\"false\"</literal> legt fest, dass für die Assoziation stets " +"\"eager Fetching\" gilt (d.h. zusammengefasstes Laden von Objekt und " +"assoziierten Objekten mit Verbundoperationen).<emphasis>Bitte beachten Sie, " +"dass bei <literal>constrained=\"false\"</literal> das Erstellen von Proxies " +"nicht möglich ist und Hibernate bei der Assoziation \"eager Fetching\" " +"anwendet!</emphasis>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "There are two varieties of one-to-one associations:" +msgstr "Es existieren zwei Arten von \"One-to-One\"-Assoziation:" + +#. Tag: para +#, no-c-format +msgid "primary key associations" +msgstr "Assoziationen des Primärschlüssels" + +#. Tag: para +#, no-c-format +msgid "unique foreign key associations" +msgstr "Assoziationen eines eindeutigen Fremdschlüssels" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Primary key associations do not need an extra table column. If two rows are " +"related by the association, then the two table rows share the same primary " +"key value. To relate two objects by a primary key association, ensure that " +"they are assigned the same identifier value." +msgstr "" +"Assoziationen von Primärschlüsseln benötigen keine Extra-Tabellenspalte. " +"Wenn zwei Reihen durch die Assoziation verbunden sind, dann teilen die " +"beiden Tabellenspalten denselben Primärschlüsselwert. Falls Sie also " +"wünschen, dass zwei Objekte mittels Assoziation des Primärschlüssels " +"verbunden werden, müssen Sie sicherstellen, dass ihnen derselbe " +"Bezeichnerwert zugeschrieben wird!" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"For a primary key association, add the following mappings to " +"<literal>Employee</literal> and <literal>Person</literal> respectively:" +msgstr "" +"Für eine Assoziation des Primärschlüssels fügen Sie die folgenden Mappings " +"zu <literal>Employee</literal> beziehungsweise <literal>Person</literal> " +"hinzu." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Ensure that the primary keys of the related rows in the PERSON and EMPLOYEE " +"tables are equal. You use a special Hibernate identifier generation strategy " +"called <literal>foreign</literal>:" +msgstr "" +"Nun muss sicher gestellt werden, dass die Primärschlüssel verbundener Reihen " +"in den PERSON- und EMPLOYEE-Tabellen gleich sind. Dabei kommt eine besondere " +"Strategie namens <literal>foreign</literal> für die Generierung des " +"Bezeichners durch Hibernate zum Einsatz:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A newly saved instance of <literal>Person</literal> is assigned the same " +"primary key value as the <literal>Employee</literal> instance referred with " +"the <literal>employee</literal> property of that <literal>Person</literal>." +msgstr "" +"Einer neu gespeicherten Instanz von <literal>Person</literal> wird dann " +"derselbe Wert des Primärschlüssels zugeschrieben wie der <literal>Employee</" +"literal>-Instanz, die mit der <literal>employee</literal>-Property dieser " +"<literal>Person</literal> referenziert ist." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Alternatively, a foreign key with a unique constraint, from " +"<literal>Employee</literal> to <literal>Person</literal>, can be expressed " +"as:" +msgstr "" +"Alternativ kann ein Fremdschlüssel mit eindeutiger Bedingung von " +"<literal>Employee</literal> zu <literal>Person</literal> wie folgt " +"ausgedrückt werden:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This association can be made bidirectional by adding the following to the " +"<literal>Person</literal> mapping:" +msgstr "" +"Und diese Assoziation kann durch Hinzufügen des Folgenden zum " +"<literal>Person</literal>-Mapping bidirektional gemacht werden:" + +#. Tag: title +#, fuzzy, no-c-format +msgid "Natural-id" +msgstr "natural-id" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Although we recommend the use of surrogate keys as primary keys, you should " +"try to identify natural keys for all entities. A natural key is a property " +"or combination of properties that is unique and non-null. It is also " +"immutable. Map the properties of the natural key inside the <literal><" +"natural-id></literal> element. Hibernate will generate the necessary " +"unique key and nullability constraints and, as a result, your mapping will " +"be more self-documenting." +msgstr "" +"Obwohl wir die Verwendung von Surrogatschlüsseln als Primärschlüssel " +"empfehlen, sollten Sie nach wie vor versuchen natürliche Schlüssel für alle " +"Entities zu identifizieren. Ein natürlicher Schlüssel ist eine Property oder " +"Kombination von Properties die eindeutig und ungleich Null ist. Falls sie " +"außerdem unveränderbar ist, umso besser. Mappen Sie die Properties des " +"natürlichen Schlüssels innerhalb des <literal><natural-id></literal>-" +"Elements. Hibernate generiert den nötigen eindeutigen Schlüssel sowie " +"\"Nullability\"-Bedingungen, und Ihr Mapping wird selbst-dokumentierender." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"It is recommended that you implement <literal>equals()</literal> and " +"<literal>hashCode()</literal> to compare the natural key properties of the " +"entity." +msgstr "" +"Wir empfehlen dringend die Implementierung von <literal>equals()</literal> " +"und <literal>hashCode()</literal>, um die Properties des natürlischen " +"Schlüssels der Entity zu vergleichen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This mapping is not intended for use with entities that have natural primary " +"keys." +msgstr "" +"Dieses Mapping ist nicht für die Verwendung mit Entities mit natürlichen " +"Primärschlüsseln vorgesehen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>mutable</literal> (optional - defaults to <literal>false</" +"literal>): by default, natural identifier properties are assumed to be " +"immutable (constant)." +msgstr "" +"<literal>mutable</literal> (optional, die Standardeinstellung lautet " +"<literal>false</literal>): In der Standardeinstellung wird davon " +"ausgegangen, dass die natürlichen Bezeichner-Properties unveränderbar " +"(konstant) sind." + +#. Tag: title +#, fuzzy, no-c-format +msgid "Component and dynamic-component" +msgstr "component, dynamic-component" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal><component></literal> element maps properties of a child " +"object to columns of the table of a parent class. Components can, in turn, " +"declare their own properties, components or collections. See the \"Component" +"\" examples below:" +msgstr "" +"Das <literal><component></literal>-Element mappt die Properties eines " +"untergeordneten Objekts zu den Spalten der Tabelle der übergeordneten " +"Klasse. Komponenten wiederum können ihre eigenen Properties, Komponenten " +"oder \"Collections\" deklarieren. Siehe \"Komponenten\" unten." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>class</literal> (optional - defaults to the property type " +"determined by reflection): the name of the component (child) class." +msgstr "" +"<literal>class</literal> (optional - Standardeinstellung ist der durch " +"Reflexion bestimmte Property-Typ): Der Name der (untergeordneten) " +"Komponentenklasse." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>insert</literal>: do the mapped columns appear in SQL " +"<literal>INSERTs</literal>?" +msgstr "" +"<literal>insert</literal>: Erscheinen die gemappten Spalten in SQL " +"<literal>INSERT</literal>s?" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>update</literal>: do the mapped columns appear in SQL " +"<literal>UPDATEs</literal>?" +msgstr "" +"<literal>update</literal>: Erscheinen die gemappten Spalten in SQL " +"<literal>UPDATE</literal>s?" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>lazy</literal> (optional - defaults to <literal>false</literal>): " +"specifies that this component should be fetched lazily when the instance " +"variable is first accessed. It requires build-time bytecode instrumentation." +msgstr "" +"<literal>lazy</literal> (optional - die Standardeinstellung lautet " +"<literal>false</literal>): Legt fest, dass für diese Komponente \"lazy " +"Fetching\" gilt, wenn erstmals auf die Instanzvariable zugegriffen wird " +"(erfordert Build-time Bytecode Instrumentierung)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>optimistic-lock</literal> (optional - defaults to <literal>true</" +"literal>): specifies that updates to this component either do or do not " +"require acquisition of the optimistic lock. It determines if a version " +"increment should occur when this property is dirty." +msgstr "" +"<literal>optimistic-lock</literal> (optional - die Standardeinstellung " +"lautet <literal>true</literal>): Legt fest, ob Aktualisierungen dieser " +"Komponente die Erfassung einer optimistischen Sperre benötigen oder nicht. " +"Mit anderen Worten, es wird bestimmt, ob eine Erhöhung der Version " +"stattfinden soll, wenn die Inhalte dieser Property sich verändert haben (man " +"sagt sie sein dann \"dirty\")." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>unique</literal> (optional - defaults to <literal>false</literal>): " +"specifies that a unique constraint exists upon all mapped columns of the " +"component." +msgstr "" +"<literal>unique</literal> (optional - die Standardeinstellung lautet " +"<literal>false</literal>): Bestimmt, dass eine eindeutige Bedingung an allen " +"gemappten Spalten der Komponente existiert." + +#. Tag: para +#, no-c-format +msgid "" +"The child <literal><property></literal> tags map properties of the " +"child class to table columns." +msgstr "" +"Die untergeordneten <literal><property></literal>-Tags mappen " +"Properties der untergeordneten Klasse zu den Spalten der Tabelle." + +#. Tag: para +#, no-c-format +msgid "" +"The <literal><component></literal> element allows a <literal><" +"parent></literal> subelement that maps a property of the component class " +"as a reference back to the containing entity." +msgstr "" +"Das <literal><component></literal>-Element ermöglicht ein <literal><" +"parent></literal>-Subelement, das eine Property der Komponentenklasse als " +"Rückreferenz zur enthaltenden Entity mappt." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal><dynamic-component></literal> element allows a " +"<literal>Map</literal> to be mapped as a component, where the property names " +"refer to keys of the map. See <xref linkend=\"components-dynamic\" /> for " +"more information." +msgstr "" +"Das <literal><dynamic-component></literal>-Element erlaubt es einer " +"<literal>Map</literal> als Komponente gemappt zu werden, wenn die Namen der " +"Properties auf Schlüssel der Map verweisen, siehe <xref linkend=\"components-" +"dynamic\"/>." + +#. Tag: title +#, no-c-format +msgid "Properties" +msgstr "Properties" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal><properties></literal> element allows the definition of a " +"named, logical grouping of the properties of a class. The most important use " +"of the construct is that it allows a combination of properties to be the " +"target of a <literal>property-ref</literal>. It is also a convenient way to " +"define a multi-column unique constraint. For example:" +msgstr "" +"Das <literal><properties></literal>-Element erlaubt die Definition " +"einer benannten, logischen Gruppierung der Properties einer Klasse. Der " +"wichtigste Aspekt des Konstrukts ist, dass es die Verwendung einer Gruppe " +"von Properties als Ziel einer <literal>property-ref</literal> ermöglicht. Es " +"bietet außerdem eine gute Möglichkeit, eine eindeutige Mehrspalten-Bedingung " +"zu definieren." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>name</literal>: the logical name of the grouping. It is " +"<emphasis>not</emphasis> an actual property name." +msgstr "" +"<literal>name</literal>: Der logische Name der Gruppierung - <emphasis>kein</" +"emphasis> tatsächlicher Property-Name." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>optimistic-lock</literal> (optional - defaults to <literal>true</" +"literal>): specifies that updates to these properties either do or do not " +"require acquisition of the optimistic lock. It determines if a version " +"increment should occur when these properties are dirty." +msgstr "" +"<literal>optimistic-lock</literal> (optional - die Standardeinstellung " +"lautet <literal>true</literal>): Legt fest, ob Aktualisierungen dieser " +"Properties die Erfassung einer optimistischen Sperre benötigen oder nicht. " +"Mit anderen Worten, es wird bestimmt, ob eine Erhöhung der Version " +"stattfinden soll, wenn die Inhalte dieser Properties sich verändert haben " +"(man sagt sie seien dann \"dirty\")." + +#. Tag: para +#, no-c-format +msgid "" +"For example, if we have the following <literal><properties></literal> " +"mapping:" +msgstr "" +"Nehmen wir etwa das folgende <literal><properties></literal>-Mapping:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You might have some legacy data association that refers to this unique key " +"of the <literal>Person</literal> table, instead of to the primary key:" +msgstr "" +"Und wir könnten eine Stammdatenassoziation haben, die auf diesen eindeutigen " +"Schlüssel der <literal>Person</literal>-Tabelle verweist, statt auf den " +"Primärschlüssel:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The use of this outside the context of mapping legacy data is not " +"recommended." +msgstr "" +"Außerhalb vom Kontext des Mappens von Stammdaten wird diese Vorgehensweise " +"jedoch nicht empfohlen." + +#. Tag: title +#, fuzzy, no-c-format +msgid "Subclass" +msgstr "subclass" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Polymorphic persistence requires the declaration of each subclass of the " +"root persistent class. For the table-per-class-hierarchy mapping strategy, " +"the <literal><subclass></literal> declaration is used. For example:" +msgstr "" +"Schließlich erfordert die polymorphe Persistenz die Deklaration jeder " +"Subklasse der persistenten Stammklasse. Für die Tabelle-pro-Klasse-" +"Hierarchie (sog. \"table-per-class-hierarchy\") Mapping-Strategie wird die " +"<literal><subclass></literal>-Deklaration verwendet." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>name</literal>: the fully qualified class name of the subclass." +msgstr "<literal>name</literal>: Der vollständige Klassenname der Subklasse." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>discriminator-value</literal> (optional - defaults to the class " +"name): a value that distinguishes individual subclasses." +msgstr "" +"<literal>discriminator-value</literal> (optional - die Standardeinstellung " +"ist der Klassenname): Ein Wert, der einzelne Subklassen unterscheidet." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>proxy</literal> (optional): specifies a class or interface used for " +"lazy initializing proxies." +msgstr "" +"<literal>proxy</literal> (optional): Bestimmt eine Klasse oder ein " +"Interface, die/das für die Initialisierung von Proxies bei Bedarf (sog. " +"\"lazy initializing proxies\") verwendet werden soll." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>lazy</literal> (optional - defaults to <literal>true</literal>): " +"setting <literal>lazy=\"false\"</literal> disables the use of lazy fetching." +msgstr "" +"<literal>lazy</literal> (optional, die Standardeinstellung lautet " +"<literal>true</literal>): Die Einstellung <literal>lazy=\"false\"</literal> " +"deaktiviert die Verwendung von \"Lazy Fetching\"." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Each subclass declares its own persistent properties and subclasses. " +"<literal><version></literal> and <literal><id></literal> " +"properties are assumed to be inherited from the root class. Each subclass in " +"a hierarchy must define a unique <literal>discriminator-value</literal>. If " +"this is not specified, the fully qualified Java class name is used." +msgstr "" +"Jede Subklasse sollte ihre eigenen persistenten Properties und Subklassen " +"deklarieren. Die <literal><version></literal> und <literal><id></" +"literal>-Properties werden als von der Stammklasse vererbt vorausgesetzt. " +"Jede Subklasse einer Hierarchie muss einen eindeutigen " +"<literal>discriminator-value</literal> definieren. Ist keiner festgelegt, so " +"wird der vollständige Java Klassenname verwendet." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"For information about inheritance mappings see <xref linkend=\"inheritance" +"\" />." +msgstr "" +"Informationen zu Vererbungsmappings (\"sog. \"inheritance mappings\") finden " +"Sie unter <xref linkend=\"inheritance\"/>." + +#. Tag: title +#, fuzzy, no-c-format +msgid "Joined-subclass" +msgstr "joined-subclass" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Each subclass can also be mapped to its own table. This is called the table-" +"per-subclass mapping strategy. An inherited state is retrieved by joining " +"with the table of the superclass. To do this you use the <literal><joined-" +"subclass></literal> element. For example:" +msgstr "" +"Alternativ kann jede Subklasse zu ihrer eigenen Tabelle gemappt werden (sog. " +"\"Table-per-Subclass\" Mapping-Strategie). Der vererbte Status wird durch " +"Verbindung mit der Tabelle der Superklasse abgerufen. Es wird das " +"<literal><joined-subclass></literal>-Element verwendet." + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>table</literal>: the name of the subclass table." +msgstr "<literal>table</literal>: Der Name der Subklassentabelle." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>proxy</literal> (optional): specifies a class or interface to use " +"for lazy initializing proxies." +msgstr "" +"<literal>proxy</literal> (optional): Bestimmt eine Klasse oder ein " +"Interface, die/das für die Initialisierung von Proxies bei Bedarf (sog. " +"\"lazy initializing proxies\") verwendet werden soll." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>lazy</literal> (optional, defaults to <literal>true</literal>): " +"setting <literal>lazy=\"false\"</literal> disables the use of lazy fetching." +msgstr "" +"<literal>lazy</literal> (optional, die Standardeinstellung lautet " +"<literal>true</literal>): Die Einstellung <literal>lazy=\"false\"</literal> " +"deaktiviert die Verwendung von \"Lazy Fetching\"." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A discriminator column is not required for this mapping strategy. Each " +"subclass must, however, declare a table column holding the object identifier " +"using the <literal><key></literal> element. The mapping at the start " +"of the chapter would then be re-written as:" +msgstr "" +"Bei dieser Mapping-Strategie ist keine Diskriminatortabelle erforderlich. " +"Jede Subklasse muss jedoch unter Verwendung des <literal><key></" +"literal>-Elements eine Tabellenspalte deklarieren, die den Objektbezeichner " +"enthält. Das Mapping vom Kapitelbeginn würde dann wie folgt umgeschrieben:" + +#. Tag: title +#, fuzzy, no-c-format +msgid "Union-subclass" +msgstr "union-subclass" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A third option is to map only the concrete classes of an inheritance " +"hierarchy to tables. This is called the table-per-concrete-class strategy. " +"Each table defines all persistent states of the class, including the " +"inherited state. In Hibernate, it is not necessary to explicitly map such " +"inheritance hierarchies. You can map each class with a separate <literal><" +"class></literal> declaration. However, if you wish use polymorphic " +"associations (e.g. an association to the superclass of your hierarchy), you " +"need to use the <literal><union-subclass></literal> mapping. For " +"example:" +msgstr "" +"Eine dritte Möglichkeit besteht darin, nur die konkreten Klassen einer " +"Vererbungshierarchie zu Tabellen zu mappen (sog. \"table-per-concrete-class" +"\"-Strategie), bei der jede Tabelle jeden persistenten Status " +"(einschließlich vererbter) definiert. In Hibernate ist es absolut nicht " +"notwendig solche Vererbungshierarchien explizit zu mappen. Sie können " +"einfach jede Klasse mit einer separaten <literal><class></literal>-" +"Deklaration mappen. Falls Sie jedoch polymorphe Assoziationen verwenden " +"wollen (z.B. eine Assoziation zur Superklasse Ihrer Hierarchie), so müssen " +"Sie das <literal><union-subclass></literal>-Mapping verwenden." + +#. Tag: para +#, no-c-format +msgid "" +"No discriminator column or key column is required for this mapping strategy." +msgstr "" +"Für diese Mapping-Strategie ist keine Diskriminatorspalte oder " +"Schlüsselspalte erforderlich." + +#. Tag: title +#, fuzzy, no-c-format +msgid "Join" +msgstr "join" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Using the <literal><join></literal> element, it is possible to map " +"properties of one class to several tables that have a one-to-one " +"relationship. For example:" +msgstr "" +"Mittels des <literal><join></literal>-Elements können Properties einer " +"Klasse zu mehreren Tabellen gemappt werden, wenn eine 1-zu-1 Beziehung " +"zwischen den Tabellen besteht." + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>table</literal>: the name of the joined table." +msgstr "<literal>table</literal>: Der Name der verbundenen Tabelle." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>fetch</literal> (optional - defaults to <literal>join</literal>): " +"if set to <literal>join</literal>, the default, Hibernate will use an inner " +"join to retrieve a <literal><join></literal> defined by a class or its " +"superclasses. It will use an outer join for a <literal><join></" +"literal> defined by a subclass. If set to <literal>select</literal> then " +"Hibernate will use a sequential select for a <literal><join></literal> " +"defined on a subclass. This will be issued only if a row represents an " +"instance of the subclass. Inner joins will still be used to retrieve a " +"<literal><join></literal> defined by the class and its superclasses." +msgstr "" +"<literal>fetch</literal> (optional - die Standardeinstellung lautet " +"<literal>join</literal>): Falls im Standard auf <literal>join</literal> " +"eingestellt, so verwendet Hibernate einen inneren Verbund (sog. \"inner join" +"\"), um einen durch eine Klasse oder deren Superklasse definierten " +"<literal><join></literal> und einen äußeren Verbund (sog. \"outer join" +"\") für einen durch eine Subklasse definierten <literal><join></" +"literal> abzurufen. Bei der Einstellung <literal>select</literal> verwendet " +"Hibernate eine sequentielle Auswahl für einen an einer Subklasse definierten " +"<literal><join></literal>, welcher nur herausgegeben wird, wenn " +"festgestellt wird, dass eine Reihe eine Instanz der Subklasse repräsentiert. " +"Innere Verbünde werden nach wie vor verwendet, um einen durch eine Klasse " +"oder deren Superklasse definierten <literal><join></literal> abzurufen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>inverse</literal> (optional - defaults to <literal>false</" +"literal>): if enabled, Hibernate will not insert or update the properties " +"defined by this join." +msgstr "" +"<literal>inverse</literal> (optional - die Standardeinstellung lautet " +"<literal>false</literal>): Falls aktiviert, wird Hibernate nicht versuchen, " +"die durch diese Verknüpfung definierten Properties einzufügen oder zu " +"aktualisieren." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>optional</literal> (optional - defaults to <literal>false</" +"literal>): if enabled, Hibernate will insert a row only if the properties " +"defined by this join are non-null. It will always use an outer join to " +"retrieve the properties." +msgstr "" +"<literal>optional</literal> (optional - die Standardeinstellung lautet " +"<literal>false</literal>): Falls aktiviert, wird Hibernate nur dann eine " +"Reihe einfügen, wenn die durch diese Verknüpfung definierten Properties " +"ungleich Null sind. Es wird außerdem stets einen äußeren Verbund beim Abruf " +"der Properties verwenden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"For example, address information for a person can be mapped to a separate " +"table while preserving value type semantics for all properties:" +msgstr "" +"Die Adressinformationen einer Person können zum Beispiel zu einer separaten " +"Tabelle gemappt werden (unter Berücksichtigung der Semantik der Wertetypen " +"aller Properties):" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This feature is often only useful for legacy data models. We recommend fewer " +"tables than classes and a fine-grained domain model. However, it is useful " +"for switching between inheritance mapping strategies in a single hierarchy, " +"as explained later." +msgstr "" +"Dieses Feature ist bei Stammdatenmodellen oft sehr nützlich, wir empfehlen " +"weniger Tabellen als Klassen sowie ein feinstufiges Domainmodell. Es ist " +"jedoch von Nutzen, wenn zwischen Mapping-Strategien der Vererbung in einer " +"einzelnen Hierarchie gewechselt wird. Wir gehen später noch näher darauf ein." + +#. Tag: title +#, no-c-format +msgid "Key" +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal><key></literal> element has featured a few times within " +"this guide. It appears anywhere the parent mapping element defines a join to " +"a new table that references the primary key of the original table. It also " +"defines the foreign key in the joined table:" +msgstr "" +"Das <literal><key></literal>-Element ist nun bereits öfter " +"aufgetreten. Es erscheint überall dort, wo das übergeordnete Mapping-Element " +"die Verknüpfung zu einer neuen Tabelle definiert. Es definiert den " +"Fremdschlüssel in der verknüpften Tabelle, der auf den Primärschlüssel der " +"Originaltabelle verweist." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>on-delete</literal> (optional - defaults to <literal>noaction</" +"literal>): specifies whether the foreign key constraint has database-level " +"cascade delete enabled." +msgstr "" +"<literal>on-delete</literal> (optional, die Standardeinstellung lautet " +"<literal>noaction</literal>): Legt fest, ob die Bedingung für den " +"Fremdschlüssel auf Datenbankebene \"cascade delete\" aktiviert." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>property-ref</literal> (optional): specifies that the foreign key " +"refers to columns that are not the primary key of the original table. It is " +"provided for legacy data." +msgstr "" +"<literal>property-ref</literal> (optional): Legt fest, dass der " +"Fremdschlüssel auf Spalten verweist, die nicht der Primärschlüssel der " +"Originaltabelle sind (für existierende Daten, sog. \"Legacy Data\")." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>not-null</literal> (optional): specifies that the foreign key " +"columns are not nullable. This is implied whenever the foreign key is also " +"part of the primary key." +msgstr "" +"<literal>not-null</literal> (optional): Legt fest, dass die Spalten des " +"Fremdschlüssels nicht nullbar (\"nullable\") sind (wird immer dann " +"vorausgesetzt, wenn der Fremdschlüssel auch Teil des Primärschlüssels ist)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>update</literal> (optional): specifies that the foreign key should " +"never be updated. This is implied whenever the foreign key is also part of " +"the primary key." +msgstr "" +"<literal>update</literal> (optional): Legt fest, dass der Fremdschlüssel " +"niemals aktualisiert werden soll (wird immer dann vorausgesetzt, wenn der " +"Fremdschlüssel auch Teil des Primärschlüssels ist)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>unique</literal> (optional): specifies that the foreign key should " +"have a unique constraint. This is implied whenever the foreign key is also " +"the primary key." +msgstr "" +"<literal>unique</literal> (optional): Legt fest, dass der Fremdschlüssel " +"eine eindeutige Bedingung haben soll (wird immer dann vorausgesetzt, wenn " +"der Fremdschlüssel auch der Primärschlüssel ist)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"For systems where delete performance is important, we recommend that all " +"keys should be defined <literal>on-delete=\"cascade\"</literal>. Hibernate " +"uses a database-level <literal>ON CASCADE DELETE</literal> constraint, " +"instead of many individual <literal>DELETE</literal> statements. Be aware " +"that this feature bypasses Hibernate's usual optimistic locking strategy for " +"versioned data." +msgstr "" +"Wir empfehlen, dass für Systeme bei denen \"Delete Performance\" wichtig " +"ist, alle Schlüssel als <literal>on-delete=\"cascade\"</literal> definiert " +"werden und Hibernate eine Bedingung der Datenbankebene <literal>ON CASCADE " +"DELETE</literal> statt einzelner <literal>DELETE</literal>-Anweisungen " +"verwendet. Bitte beachten Sie, dass dieses Feature Hibernates reguläre " +"Strategie für optimistisches Sperren für versionierte Daten umgeht." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>not-null</literal> and <literal>update</literal> attributes are " +"useful when mapping a unidirectional one-to-many association. If you map a " +"unidirectional one-to-many association to a non-nullable foreign key, you " +"<emphasis>must</emphasis> declare the key column using <literal><key not-" +"null=\"true\"></literal>." +msgstr "" +"Die <literal>not-null</literal> und <literal>update</literal>-Attribute sind " +"insbesondere beim Mappen einer unidirektionalen \"One-to-Many\"-Assoziation " +"hilfreich. Falls Sie eine unidirektionale \"One-to-Many\" zu einem nicht-" +"nullbaren Fremdschlüssel mappen, so<emphasis>müssen</emphasis> Sie die " +"Spalte des Schlüssels unter Verwendung von <literal><key not-null=\"true" +"\"></literal> deklarieren." + +#. Tag: title +#, fuzzy, no-c-format +msgid "Column and formula elements" +msgstr "Spalten- und Formel-Elemente" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Mapping elements which accept a <literal>column</literal> attribute will " +"alternatively accept a <literal><column></literal> subelement. " +"Likewise, <literal><formula></literal> is an alternative to the " +"<literal>formula</literal> attribute. For example:" +msgstr "" +"Jedes Mapping-Element das ein <literal>column</literal>-Attribut akzeptiert, " +"akzeptiert alternativ auch ein <literal><column></literal>-Subelement. " +"Ebenso ist <literal><formula></literal> eine Alternative zum " +"<literal>formula</literal>-Attribut." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>column</literal> and <literal>formula</literal> attributes can even " +"be combined within the same property or association mapping to express, for " +"example, exotic join conditions." +msgstr "" +"Die <literal>column</literal> und <literal>formula</literal>-Attribute " +"können sogar innerhalb desselben auszudrückenden Property- oder " +"Assoziationsmappings kombiniert werden, zum Beispiel ausgefallene " +"Verbundbedingungen." + +#. Tag: title +#, fuzzy, no-c-format +msgid "Import" +msgstr "import" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If your application has two persistent classes with the same name, and you " +"do not want to specify the fully qualified package name in Hibernate " +"queries, classes can be \"imported\" explicitly, rather than relying upon " +"<literal>auto-import=\"true\"</literal>. You can also import classes and " +"interfaces that are not explicitly mapped:" +msgstr "" +"Nehmen wir an, Ihre Anwendung besitzt zwei persistente Klassen mit demselben " +"Namen, und Sie wollen nicht den vollständigen (Paket-) Namen in Hibernate " +"Anfragen spezifizieren. Klassen können explizit \"importiert\" werden, statt " +"auf <literal>auto-import=\"true\"</literal> angewiesen zu sein. Sie können " +"sogar Klassen und Interfaces importieren, die nicht explizit gemappt sind." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>class</literal>: the fully qualified class name of any Java class." +msgstr "" +"<literal>class</literal>: Der vollständige Klassenname einer Java-Klasse." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>rename</literal> (optional - defaults to the unqualified class " +"name): a name that can be used in the query language." +msgstr "" +"<literal>rename</literal> (optional - die Standardeinstellung ist der nicht " +"definierte Klassenname): Ein Name, der in der Anfragensprache verwendet " +"werden kann." + +#. Tag: title +#, no-c-format +msgid "Any" +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"There is one more type of property mapping. The <literal><any></" +"literal> mapping element defines a polymorphic association to classes from " +"multiple tables. This type of mapping requires more than one column. The " +"first column contains the type of the associated entity. The remaining " +"columns contain the identifier. It is impossible to specify a foreign key " +"constraint for this kind of association. This is not the usual way of " +"mapping polymorphic associations and you should use this only in special " +"cases. For example, for audit logs, user session data, etc." +msgstr "" +"Es gibt noch einen weiteren Typ von Property-Mapping. Das <literal><" +"any></literal> Mapping-Element definiert eine polymorphe Assoziation zu " +"Klassen mehrerer Tabellen. Diese Art von Mapping erfordert immer mehr als " +"eine Spalte. Die erste Spalte enthält den Typ der zugehörigen Entity. Die " +"übrigen Spalten enthalten den Bezeichner. Es ist unmöglich, eine Bedingung " +"für den Fremdschlüssel für diese Art von Assoziation festzulegen, daher ist " +"dies nicht als reguläre Art des Mappings (polymorpher) Assoziationen " +"gedacht. Sie sollten diesen Typ von Mapping nur in ganz besonderen Fällen " +"anwenden (z.B. für Überprüfungsprotokolle, Daten der Benutzersession usw.)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>meta-type</literal> attribute allows the application to specify " +"a custom type that maps database column values to persistent classes that " +"have identifier properties of the type specified by <literal>id-type</" +"literal>. You must specify the mapping from values of the meta-type to class " +"names." +msgstr "" +"Das <literal>meta-type</literal>-Attribut ermöglicht es der Anwendung einen " +"anwenderdefinierten Typ festzulegen, der die Werte der Datenbankspalte zu " +"persistenten Klassen mit durch <literal>id-type</literal> bestimmte " +"Bezeichner-Properties mappt. Das Mapping muss aus Werten des Meta-Typs zu " +"Klassennamen bestimmt werden." + +#. Tag: para +#, no-c-format +msgid "<literal>name</literal>: the property name." +msgstr "<literal>name</literal>: Der Property-Name." + +#. Tag: para +#, no-c-format +msgid "<literal>id-type</literal>: the identifier type." +msgstr "<literal>id-type</literal>: Der Bezeichnertyp." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>meta-type</literal> (optional - defaults to <literal>string</" +"literal>): any type that is allowed for a discriminator mapping." +msgstr "" +"<literal>meta-type</literal> (optional - die Standardeinstellung lautet " +"<literal>string</literal>): Jeder Typ, der für ein Diskriminator-Mapping " +"gestattet ist." + +#. Tag: para +#, no-c-format +msgid "" +"<literal>cascade</literal> (optional- defaults to <literal>none</literal>): " +"the cascade style." +msgstr "" +"<literal>cascade</literal> (optional- die Standardeinstellung lautet " +"<literal>none</literal>): der \"Cascade-Style\" (Weitergabestil)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>optimistic-lock</literal> (optional - defaults to <literal>true</" +"literal>): specifies that updates to this property either do or do not " +"require acquisition of the optimistic lock. It defines whether a version " +"increment should occur if this property is dirty." +msgstr "" +"<literal>optimistic-lock</literal> (optional - die Standardeinstellung " +"lautet <literal>true</literal>): Legt fest, ob Aktualisierungen dieser " +"Property die Erfassung einer optimistischen Sperre benötigen oder nicht. Mit " +"anderen Worten, es wird bestimmt ob eine Erhöhung der Version stattfinden " +"soll, wenn die Inhalte dieser Property sich verändert haben." + +#. Tag: title +#, fuzzy, no-c-format +msgid "Hibernate types" +msgstr "Hibernate-Typen" + +#. Tag: title +#, no-c-format +msgid "Entities and values" +msgstr "Entities und Werte" + +#. Tag: para +#, no-c-format +msgid "" +"In relation to the persistence service, Java language-level objects are " +"classified into two groups:" +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"An <emphasis>entity</emphasis> exists independently of any other objects " +"holding references to the entity. Contrast this with the usual Java model, " +"where an unreferenced object is garbage collected. Entities must be " +"explicitly saved and deleted. Saves and deletions, however, can be " +"<emphasis>cascaded</emphasis> from a parent entity to its children. This is " +"different from the ODMG model of object persistence by reachability and " +"corresponds more closely to how application objects are usually used in " +"large systems. Entities support circular and shared references. They can " +"also be versioned." +msgstr "" +"Eine <emphasis>Entity</emphasis> existiert unabhängig von anderen Objekten, " +"die Verweise zu der Entity enthalten. Das steht im Gegensatz zu dem üblichen " +"Java-Modell bei dem ein unreferenziertes Objekt aus dem Speicher bereinigt " +"wird. Entities müssen explizit gespeichert und gelöscht werden (ausgenommen, " +"dass Speicherungen und Löschungen von einer übergeordneten Entity an die ihr " +"untergeordneten Entities <emphasis>weitergegeben</emphasis> werden können). " +"Das unterscheidet sich vom ODMG-Modell der Objektpersistenz durch " +"Erreichbarkeit - und entspricht eher der Weise, in der Anwendungsobjekte in " +"der Regel in großen Systemen verwendet werden. Entities unterstützen " +"zirkulare und geteilte Verweise. Sie können auch versioniert werden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"An entity's persistent state consists of references to other entities and " +"instances of <emphasis>value</emphasis> types. Values are primitives: " +"collections (not what is inside a collection), components and certain " +"immutable objects. Unlike entities, values in particular collections and " +"components, <emphasis>are</emphasis> persisted and deleted by reachability. " +"Since value objects and primitives are persisted and deleted along with " +"their containing entity, they cannot be independently versioned. Values have " +"no independent identity, so they cannot be shared by two entities or " +"collections." +msgstr "" +"Der persistente Zustand einer Entity besteht aus Verweisen auf andere " +"Entities sowie Instanzen des <emphasis>Werte</emphasis>typs. Werte sind " +"\"Primitives\", Collections (nicht, was innerhalb einer Collection ist), " +"Komponenten und bestimmte unveränderliche Objekte. Ungleich Entities " +"<emphasis>werden </emphasis> Werte (insbesondere Collections und " +"Komponenten) persistiert und nach Erreichbarkeit gelöscht. Da Wertobjekte " +"(und \"Primitives\") mit der sie enthaltenden Entity persistiert und " +"gelöscht werden, können sie nicht unabhängig versioniert werden. Werte " +"besitzen keine unabhängige Identität und können daher nicht von zwei " +"Entities oder Collections geteilt werden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Until now, we have been using the term \"persistent class\" to refer to " +"entities. We will continue to do that. Not all user-defined classes with a " +"persistent state, however, are entities. A <emphasis>component</emphasis> is " +"a user-defined class with value semantics. A Java property of type " +"<literal>java.lang.String</literal> also has value semantics. Given this " +"definition, all types (classes) provided by the JDK have value type " +"semantics in Java, while user-defined types can be mapped with entity or " +"value type semantics. This decision is up to the application developer. An " +"entity class in a domain model will normally have shared references to a " +"single instance of that class, while composition or aggregation usually " +"translates to a value type." +msgstr "" +"Bis jetzt wurde der Begriff \"persistente Klasse\" im Zusammenhang mit " +"Entities verwendet, was auch weiterhin der Fall sein wird. Streng genommen " +"sind jedoch nicht alle benutzerdefinierten Klassen mit persistentem Status " +"Entities. Eine <emphasis>Komponente</emphasis> ist eine benutzerdefinierte " +"Klasse mit Wertsemantik. Eine Java-Property des Typs <literal>java.lang." +"String</literal> besitzt ebenfalls Wertsemantik. Angesichts dieser " +"Definition kann man sagen, dass alle von der JDK bereitgestellten Typen " +"(Klassen) in Java über Wertetyp-Semantik verfügen, während " +"benutzerdefinierte Typen mit Entity- oder Wertetyp-Semantik gemappt werden " +"können. Die Entscheidung bleibt hierbei dem Entwickler der Anwendung " +"überlassen. Eine gute Idee für eine Entity-Klasse in einem Domain-Modell " +"sind geteilte Verweise auf eine einzelne Instanz der Klasse, während " +"Komposition oder Aggregation in der Regel für einen Wertetyp geeignet sind. " + +#. Tag: para +#, fuzzy, no-c-format +msgid "We will revisit both concepts throughout this reference guide." +msgstr "" +"Beide Konzepte werden innerhalb der Dokumentation noch wiederholt " +"aufgegriffen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The challenge is to map the Java type system, and the developers' definition " +"of entities and value types, to the SQL/database type system. The bridge " +"between both systems is provided by Hibernate. For entities, <literal><" +"class></literal>, <literal><subclass></literal> and so on are used. " +"For value types we use <literal><property></literal>, <literal><" +"component></literal>etc., that usually have a <literal>type</literal> " +"attribute. The value of this attribute is the name of a Hibernate " +"<emphasis>mapping type</emphasis>. Hibernate provides a range of mappings " +"for standard JDK value types out of the box. You can write your own mapping " +"types and implement your own custom conversion strategies." +msgstr "" +"Die Herausforderung besteht darin, das System des Java-Typs (und die " +"Definitionen von Entities und Wertetypen der Entwickler) zu einem System des " +"SQL/Datenbanktyps zu mappen. Die Brücke zwischen beiden Systemen wird von " +"Hibernate bereitgestellt: Für Entities werden <literal><class></" +"literal>, <literal><subclass></literal> usw. verwendet. Für Wertetypen " +"werden <literal><property></literal>, <literal><component></" +"literal>, usw. - in der Regel mit einem <literal>type</literal>-Attribut - " +"verwendet. Der Wert dieses Attributs ist der Name eines Hibernate " +"<emphasis>Mapping-Typs</emphasis>. Hibernate bietet viele Mappings (für " +"Standard JDK Wertetypen). Sie können auch eigene Mapping-Typen erstellen und " +"auch Ihre eigenen angepassten Datenkonvertierungsstrategien implementieren. " +"Darauf gehen wir später noch ein." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"With the exception of collections, all built-in Hibernate types support null " +"semantics." +msgstr "" +"Alle eingebauten Hibernate-Typen außer \"Collections\" unterstützen Null-" +"Semantik (sog. \"null semantics\"." + +#. Tag: title +#, no-c-format +msgid "Basic value types" +msgstr "Grundlegende Wertetypen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The built-in <emphasis>basic mapping types</emphasis> can be roughly " +"categorized into the following:" +msgstr "" +"Die eingebauten, <emphasis>grundlegenden Mapping-Typen</emphasis> können im " +"Wesentlichen wie folgt kategorisiert werden" + +#. Tag: term +#, fuzzy, no-c-format +msgid "" +"<literal>integer, long, short, float, double, character, byte, boolean, " +"yes_no, true_false</literal>" +msgstr "" +"integer, long, short, float, double, character, byte, boolean, yes_no, " +"true_false" + +#. Tag: para +#, no-c-format +msgid "" +"Type mappings from Java primitives or wrapper classes to appropriate (vendor-" +"specific) SQL column types. <literal>boolean, yes_no</literal> and " +"<literal>true_false</literal> are all alternative encodings for a Java " +"<literal>boolean</literal> or <literal>java.lang.Boolean</literal>." +msgstr "" +"Typen-Mappings von Java-\"Primitives\" oder \"Wrapper-Klassen\" zu passenden " +"(Anbieter-spezifischen) SQL-Spaltentypen. <literal>boolean, yes_no</literal> " +"und <literal>true_false</literal> sind alternative Verschlüsselungen für " +"einen Java <literal>boolean</literal> oder <literal>java.lang.Boolean</" +"literal>." + +#. Tag: term +#, no-c-format +msgid "<literal>string</literal>" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"A type mapping from <literal>java.lang.String</literal> to <literal>VARCHAR</" +"literal> (or Oracle <literal>VARCHAR2</literal>)." +msgstr "" +"Ein \"Type-Mapping\" von <literal>java.lang.String</literal> zu " +"<literal>VARCHAR</literal> (oder Oracle <literal>VARCHAR2</literal>)." + +#. Tag: term +#, fuzzy, no-c-format +msgid "<literal>date, time, timestamp</literal>" +msgstr "date, time, timestamp" + +#. Tag: para +#, no-c-format +msgid "" +"Type mappings from <literal>java.util.Date</literal> and its subclasses to " +"SQL types <literal>DATE</literal>, <literal>TIME</literal> and " +"<literal>TIMESTAMP</literal> (or equivalent)." +msgstr "" +"Type-Mappings von <literal>java.util.Date</literal> und dessen Subklassen zu " +"SQL-Typen <literal>DATE</literal>, <literal>TIME</literal> und " +"<literal>TIMESTAMP</literal> (oder äquivalent)." + +#. Tag: term +#, fuzzy, no-c-format +msgid "<literal>calendar, calendar_date</literal>" +msgstr "calendar, calendar_date" + +#. Tag: para +#, no-c-format +msgid "" +"Type mappings from <literal>java.util.Calendar</literal> to SQL types " +"<literal>TIMESTAMP</literal> and <literal>DATE</literal> (or equivalent)." +msgstr "" +"Type-Mappings von <literal>java.util.Calendar</literal> zu SQL-Typen " +"<literal>TIMESTAMP</literal> und <literal>DATE</literal> (oder äquivalent)." + +#. Tag: term +#, fuzzy, no-c-format +msgid "<literal>big_decimal, big_integer</literal>" +msgstr "big_decimal, big_integer" + +#. Tag: para +#, no-c-format +msgid "" +"Type mappings from <literal>java.math.BigDecimal</literal> and <literal>java." +"math.BigInteger</literal> to <literal>NUMERIC</literal> (or Oracle " +"<literal>NUMBER</literal>)." +msgstr "" +"Type-Mappings von <literal>java.math.BigDecimal</literal> und <literal>java." +"math.BigInteger</literal> zu <literal>NUMERIC</literal> (oder Oracle " +"<literal>NUMBER</literal>)." + +#. Tag: term +#, fuzzy, no-c-format +msgid "<literal>locale, timezone, currency</literal>" +msgstr "locale, timezone, currency" + +#. Tag: para +#, no-c-format +msgid "" +"Type mappings from <literal>java.util.Locale</literal>, <literal>java.util." +"TimeZone</literal> and <literal>java.util.Currency</literal> to " +"<literal>VARCHAR</literal> (or Oracle <literal>VARCHAR2</literal>). " +"Instances of <literal>Locale</literal> and <literal>Currency</literal> are " +"mapped to their ISO codes. Instances of <literal>TimeZone</literal> are " +"mapped to their <literal>ID</literal>." +msgstr "" +"Type-Mappings von <literal>java.util.Locale</literal>, <literal>java.util." +"TimeZone</literal> und <literal>java.util.Currency</literal> " +"zu<literal>VARCHAR</literal> (oder Oracle <literal>VARCHAR2</literal>). " +"Instanzen von <literal>Locale</literal> und <literal>Currency</literal> " +"werden zu ihren ISO-Codes gemappt. Instanzen von <literal>TimeZone</literal> " +"werden zu ihrer <literal>ID</literal> gemappt." + +#. Tag: term +#, fuzzy, no-c-format +msgid "<literal>class</literal>" +msgstr "<literal>all</literal> Prüfung aller Spalten" + +#. Tag: para +#, no-c-format +msgid "" +"A type mapping from <literal>java.lang.Class</literal> to <literal>VARCHAR</" +"literal> (or Oracle <literal>VARCHAR2</literal>). A <literal>Class</literal> " +"is mapped to its fully qualified name." +msgstr "" +"Ein Type-Mapping von <literal>java.lang.Class</literal> zu <literal>VARCHAR</" +"literal> (oder Oracle <literal>VARCHAR2</literal>). Eine <literal>Class</" +"literal> wird zu ihrem vollständigen Namen gemappt." + +#. Tag: term +#, fuzzy, no-c-format +msgid "<literal>binary</literal>" +msgstr "<literal>name</literal>: Der Property-Name." + +#. Tag: para +#, no-c-format +msgid "Maps byte arrays to an appropriate SQL binary type." +msgstr "Mappt Byte-Arrays zum zugehörigen SQL-Binärtyp." + +#. Tag: term +#, fuzzy, no-c-format +msgid "<literal>text</literal>" +msgstr "<literal>name</literal>: Der Property-Name." + +#. Tag: para +#, no-c-format +msgid "" +"Maps long Java strings to a SQL <literal>CLOB</literal> or <literal>TEXT</" +"literal> type." +msgstr "" +"Mappt lange Java-Strings zum SQL <literal>CLOB</literal> oder <literal>TEXT</" +"literal>-Typ." + +#. Tag: term +#, fuzzy, no-c-format +msgid "<literal>serializable</literal>" +msgstr "<literal>all</literal> Prüfung aller Spalten" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Maps serializable Java types to an appropriate SQL binary type. You can also " +"indicate the Hibernate type <literal>serializable</literal> with the name of " +"a serializable Java class or interface that does not default to a basic type." +msgstr "" +"Mappt serialisierbare Java-Typen zu einem zugehörigen SQL-Binärtyp. Sie " +"können auch den Hibernate-Typ <literal>serializable</literal> mit dem Namen " +"einer serialisierbaren Java-Klasse oder einem Interface (das in der " +"Standardeinstellung kein Grundtyp ist) anzeigen." + +#. Tag: term +#, fuzzy, no-c-format +msgid "<literal>clob, blob</literal>" +msgstr "<literal>all</literal> Prüfung aller Spalten" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Type mappings for the JDBC classes <literal>java.sql.Clob</literal> and " +"<literal>java.sql.Blob</literal>. These types can be inconvenient for some " +"applications, since the blob or clob object cannot be reused outside of a " +"transaction. Driver support is patchy and inconsistent." +msgstr "" +"Typen-Mappings für dieJDBC-Klassen <literal>java.sql.Clob</literal> und " +"<literal>java.sql.Blob</literal>. Diese Typen können sich für manche " +"Anwendungen als unpraktisch erweisen, da das \"blob\" oder \"clob\"-Objekt " +"nicht außerhalb einer Transaktion wiederverwendet werden darf. (Auch der " +"Treiber-Support ist lückenhaft und uneinheitlich)." + +#. Tag: term +#, fuzzy, no-c-format +msgid "" +"<literal>imm_date, imm_time, imm_timestamp, imm_calendar, imm_calendar_date, " +"imm_serializable, imm_binary</literal>" +msgstr "" +"imm_date, imm_time, imm_timestamp, imm_calendar, imm_calendar_date, " +"imm_serializable, imm_binary" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Type mappings for what are considered mutable Java types. This is where " +"Hibernate makes certain optimizations appropriate only for immutable Java " +"types, and the application treats the object as immutable. For example, you " +"should not call <literal>Date.setTime()</literal> for an instance mapped as " +"<literal>imm_timestamp</literal>. To change the value of the property, and " +"have that change made persistent, the application must assign a new, " +"nonidentical, object to the property." +msgstr "" +"Typen-Mappings für in der Regel als veränderlich angesehene Java-Typen, " +"wobei Hibernate bestimmte und nur für unveränderliche Java-Typen passende " +"Optimierungen vornimmt und die Anwendung das Objekt als unveränderlich " +"behandelt. Sie sollten zum Beispiel nicht <literal>Date.setTime()</literal> " +"für eine als <literal>imm_timestamp</literal> gemappte Instanz aufrufen. Um " +"den Wert der Property zu verändern und diese Änderung persistent zu machen, " +"muss die Anwendung der Property ein neues (nicht identisches) Objekt " +"zuordnen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Unique identifiers of entities and collections can be of any basic type " +"except <literal>binary</literal>, <literal>blob</literal> and <literal>clob</" +"literal>. Composite identifiers are also allowed. See below for more " +"information." +msgstr "" +"Eindeutige Bezeichner von Entities und Collections können jeden Grundtyp " +"außer <literal>binary</literal>, <literal>blob</literal> und <literal>clob</" +"literal> besitzen. (Zusammengesetzte Bezeichner sind ebenfalls möglich, " +"siehe unten)." + +#. Tag: para +#, no-c-format +msgid "" +"The basic value types have corresponding <literal>Type</literal> constants " +"defined on <literal>org.hibernate.Hibernate</literal>. For example, " +"<literal>Hibernate.STRING</literal> represents the <literal>string</literal> " +"type." +msgstr "" +"Die grundlegenden Wertetypen haben entsprechende <literal>Type</literal>-" +"Konstanten, die auf <literal>org.hibernate.Hibernate</literal> definiert " +"sind. So repräsentiert <literal>Hibernate.STRING</literal> zum Beispiel den " +"<literal>string</literal>-Typ." + +#. Tag: title +#, no-c-format +msgid "Custom value types" +msgstr "Angepasste Wertetypen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"It is relatively easy for developers to create their own value types. For " +"example, you might want to persist properties of type <literal>java.lang." +"BigInteger</literal> to <literal>VARCHAR</literal> columns. Hibernate does " +"not provide a built-in type for this. Custom types are not limited to " +"mapping a property, or collection element, to a single table column. So, for " +"example, you might have a Java property <literal>getName()</literal>/" +"<literal>setName()</literal> of type <literal>java.lang.String</literal> " +"that is persisted to the columns <literal>FIRST_NAME</literal>, " +"<literal>INITIAL</literal>, <literal>SURNAME</literal>." +msgstr "" +"Es ist relativ einfach für Entwickler, ihre eigenen Wertetypen zu erstellen. " +"Sie könnten zum Beispiel die Properties vom Typ <literal>java.lang." +"BigInteger</literal> zu <literal>VARCHAR</literal>-Spalten persistieren. " +"Hibernate bietet hierfür keinen eingebauten Typ. Aber angepasste " +"(anwenderdefinierte) Typen beschränken sich nicht auf das Mappen einer " +"Property (oder eines Collection-Elements) zu einer einzelnen Tabellenspalte. " +"So könnten Sie zum Beispiel eine Java-Property <literal>getName()</literal>/" +"<literal>setName()</literal> des Typs <literal>java.lang.String</literal> " +"haben, die zu den Spalten <literal>FIRST_NAME</literal>, <literal>INITIAL</" +"literal>, <literal>SURNAME</literal> persistiert ist." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"To implement a custom type, implement either <literal>org.hibernate." +"UserType</literal> or <literal>org.hibernate.CompositeUserType</literal> and " +"declare properties using the fully qualified classname of the type. View " +"<literal>org.hibernate.test.DoubleStringType</literal> to see the kind of " +"things that are possible." +msgstr "" +"Um einen angepassten Typ zu implementieren, implementieren Sie entweder " +"<literal>org.hibernate.UserType</literal> oder <literal>org.hibernate." +"CompositeUserType</literal> und deklarieren Sie Properties unter Verwendung " +"des vollständigen Klassennamens des Typs. Unter <literal>org.hibernate.test." +"DoubleStringType</literal> finden Sie die unterschiedlichen Möglichkeiten, " +"die es dabei gibt." + +#. Tag: para +#, no-c-format +msgid "" +"Notice the use of <literal><column></literal> tags to map a property " +"to multiple columns." +msgstr "" +"Beachten Sie die Verwendung von <literal><column></literal>-Tags beim " +"Mappen einer Property zu mehreren Spalten." + +#. Tag: para +#, no-c-format +msgid "" +"The <literal>CompositeUserType</literal>, <literal>EnhancedUserType</" +"literal>, <literal>UserCollectionType</literal>, and " +"<literal>UserVersionType</literal> interfaces provide support for more " +"specialized uses." +msgstr "" +"Die <literal>CompositeUserType</literal>, <literal>EnhancedUserType</" +"literal>, <literal>UserCollectionType</literal> und " +"<literal>UserVersionType</literal> Interfaces unterstützen auch speziellere " +"Einsatzmöglichkeiten." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can even supply parameters to a <literal>UserType</literal> in the " +"mapping file. To do this, your <literal>UserType</literal> must implement " +"the <literal>org.hibernate.usertype.ParameterizedType</literal> interface. " +"To supply parameters to your custom type, you can use the <literal><" +"type></literal> element in your mapping files." +msgstr "" +"Sie können sogar Parameter für einen <literal>UserType</literal> in der " +"Mappingdatei bereitstellen. Dazu muss Ihr <literal>UserType</literal> das " +"<literal>org.hibernate.usertype.ParameterizedType</literal>-Interface " +"implementieren. Um Parameter für Ihren angepassten Typ bereitzustellen " +"können Sie das <literal><type></literal>-Element in Ihren " +"Mappingdateien verwenden." + +#. Tag: para +#, no-c-format +msgid "" +"The <literal>UserType</literal> can now retrieve the value for the parameter " +"named <literal>default</literal> from the <literal>Properties</literal> " +"object passed to it." +msgstr "" +"Der <literal>UserType</literal> kann jetzt den Wert für den Parameter mit " +"Namen <literal>default</literal> von dem an ihn geleiteten " +"<literal>Properties</literal>-Objekt abrufen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If you regularly use a certain <literal>UserType</literal>, it is useful to " +"define a shorter name for it. You can do this using the <literal><" +"typedef></literal> element. Typedefs assign a name to a custom type, and " +"can also contain a list of default parameter values if the type is " +"parameterized." +msgstr "" +"Wenn Sie einen bestimmten <literal>UserType</literal> sehr oft verwenden, so " +"kann es nützlich sein, wenn Sie einen kürzeren Namen für ihn definieren. Um " +"das zu tun verwenden Sie das <literal><typedef></literal>-Element. " +"\"Typedefs\" ordnen einem angepassten Typ einen Namen zu und können außerdem " +"eine Liste standardmäßiger Parameterwerte enthalten, wenn der Typ " +"parametriert wird." + +#. Tag: para +#, no-c-format +msgid "" +"It is also possible to override the parameters supplied in a typedef on a " +"case-by-case basis by using type parameters on the property mapping." +msgstr "" +"Es ist auch möglich, die in einer \"typedef\" bereitgestellten Parameter von " +"Fall zu Fall unter Verwendung der Typ-Parameter des Property-Mappings außer " +"Kraft zu setzen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Even though Hibernate's rich range of built-in types and support for " +"components means you will rarely need to use a custom type, it is considered " +"good practice to use custom types for non-entity classes that occur " +"frequently in your application. For example, a <literal>MonetaryAmount</" +"literal> class is a good candidate for a <literal>CompositeUserType</" +"literal>, even though it could be mapped as a component. One reason for this " +"is abstraction. With a custom type, your mapping documents would be " +"protected against changes to the way monetary values are represented." +msgstr "" +"Obwohl die breit gefächerte Palette eingebauter Typen und Support bedeutet, " +"dass Sie einen angepassten Typ nur sehr selten werden benutzen " +"<emphasis>müssen</emphasis>, so ist es dennoch eine gute Angewohnheit " +"angepasste Typen für in Ihrer Anwendung häufig vorkommende (nicht-Entity) " +"Klassen zu verwenden. So ist zum Beispiel eine <literal>MonetaryAmount</" +"literal>-Klasse ein guter Kandidat für einen <literal>CompositeUserType</" +"literal>, obwohl sie leicht als eine Komponente gemappt werden könnte. Ein " +"Grund hierfür ist Abstraktion. Mit einem angepassten Typ wären Ihre Mapping-" +"Dokumente in Zukunft gegen mögliche Veränderungen in der Art, in der Ihre " +"Geldwerte repräsentiert werden, gesichert." + +#. Tag: title +#, no-c-format +msgid "Mapping a class more than once" +msgstr "Das mehrfache Mappen einer Klasse" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"It is possible to provide more than one mapping for a particular persistent " +"class. In this case, you must specify an <emphasis>entity name</emphasis> to " +"disambiguate between instances of the two mapped entities. By default, the " +"entity name is the same as the class name. Hibernate lets you specify the " +"entity name when working with persistent objects, when writing queries, or " +"when mapping associations to the named entity." +msgstr "" +"Es ist möglich, mehr als ein Mapping für eine bestimmte persistente Klasse " +"bereitzustellen. In diesem Fall müssen Sie einen <emphasis>Entity-Namen</" +"emphasis> bereitstellen, um die Instanzen der beiden gemappten Entities " +"eindeutig zu machen. (In der Standardeinstellung ist der Entity-Name " +"derselbe wie der Klassenname). Hibernate lässt Sie den Entity-Namen " +"festlegen, wenn Sie mit persistenten Objekten arbeiten, wenn Sie Anfragen " +"schreiben oder Assoziationen zu der genannten Entity mappen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Associations are now specified using <literal>entity-name</literal> instead " +"of <literal>class</literal>." +msgstr "" +"Beachten Sie, wie Assoziationen nun unter Verwendung von <literal>entity-" +"name</literal> statt <literal>class</literal> spezifiziert werden." + +#. Tag: title +#, no-c-format +msgid "SQL quoted identifiers" +msgstr "SQL angeführte Bezeichner" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can force Hibernate to quote an identifier in the generated SQL by " +"enclosing the table or column name in backticks in the mapping document. " +"Hibernate will use the correct quotation style for the SQL <literal>Dialect</" +"literal>. This is usually double quotes, but the SQL Server uses brackets " +"and MySQL uses backticks." +msgstr "" +"Sie können Hibernate dazu zwingen, einen Bezeichner in der generierten SQL " +"anzugeben, indem Sie den Tabellen- oder Spaltennamen innerhalb des Mapping-" +"Dokuments in Backtick-Zeichen einschließen. Hibernate wird den korrekten " +"\"Quotation-Style\" für den SQL <literal>Dialect</literal> verwenden (in der " +"Regel doppelte Anführungszeichen, aber Klammern für SQL-Server und Backticks " +"für MySQL)." + +#. Tag: title +#, no-c-format +msgid "Metadata alternatives" +msgstr "Metadata-Alternativen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"XML does not suit all users so there are some alternative ways to define O/R " +"mapping metadata in Hibernate." +msgstr "" +"XML ist nicht jedermanns Sache, daher gibt es auch alternative Möglichkeiten " +"O/R Mapping Metadaten in Hibernate zu definieren." + +#. Tag: title +#, no-c-format +msgid "Using XDoclet markup" +msgstr "Die Verwendung von XDoclet-Markup" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Many Hibernate users prefer to embed mapping information directly in " +"sourcecode using XDoclet <literal>@hibernate.tags</literal>. We do not cover " +"this approach in this reference guide since it is considered part of " +"XDoclet. However, we include the following example of the <literal>Cat</" +"literal> class with XDoclet mappings:" +msgstr "" +"Viele Benutzer von Hibernate ziehen es vor, Mapping-Informationen unter " +"Verwendung von XDoclet <literal>@hibernate.tags</literal> direkt im " +"Quellcode einzubetten. Diese Vorgehensweise wird hier nicht behandelt, da es " +"sich ausschließlich um einen Teil von XDoclet handelt. Allerdings zeigen wir " +"das nachfolgende Beispiel der <literal>Cat</literal>-Klasse mit XDoclet-" +"Mappings." + +#. Tag: para +#, fuzzy, no-c-format +msgid "See the Hibernate website for more examples of XDoclet and Hibernate." +msgstr "" +"Weitere Beispiele zu XDoclet und Hibernate finden Sie auf der Hibernate " +"Website." + +#. Tag: title +#, no-c-format +msgid "Using JDK 5.0 Annotations" +msgstr "Die Verwendung von JDK 5.0 Annotationen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"JDK 5.0 introduced XDoclet-style annotations at the language level that are " +"type-safe and checked at compile time. This mechanism is more powerful than " +"XDoclet annotations and better supported by tools and IDEs. IntelliJ IDEA, " +"for example, supports auto-completion and syntax highlighting of JDK 5.0 " +"annotations. The new revision of the EJB specification (JSR-220) uses JDK " +"5.0 annotations as the primary metadata mechanism for entity beans. " +"Hibernate3 implements the <literal>EntityManager</literal> of JSR-220 (the " +"persistence API). Support for mapping metadata is available via the " +"<emphasis>Hibernate Annotations</emphasis> package as a separate download. " +"Both EJB3 (JSR-220) and Hibernate3 metadata is supported." +msgstr "" +"JDK 5.0 hat Annotationen im XDoclet-Stil auf der Sprachebene vorgestellt, " +"die typensicher und zum Zeitpunkt der Kompilierung geprüft sind. Dieser " +"Mechanismus ist leistungsstärker als XDoclet-Annotationen und bietet " +"besseren Support durch Tools und IDEs . IntelliJ IDEA zum Beispiel " +"unterstützt Auto-Vervollständigung und Syntax-Hervorhebungen von JDK 5.0 " +"Annotationen. Die neue Revision der EJB-Spezifikation (JSR-220) verwendet " +"JDK 5.0 Annotationen als primären Metadata-Mechanismus für Entity-Beans. " +"Hibernate3 implementiert den <literal>EntityManager</literal> von JSR-220 " +"(das Persistenz-API), Support für Mapping-Metadata ist mittels des " +"<emphasis>Hibernate Annotations</emphasis>-Pakets als separater Download " +"verfügbar. Sowohl EJB3 (JSR-220) und Hibernate3 Metadata werden unterstützt." + +#. Tag: para +#, no-c-format +msgid "This is an example of a POJO class annotated as an EJB entity bean:" +msgstr "" +"Nachfolgend sehen Sie ein Beispiel für eine als EJB Entity-Bean annotierte " +"POJO-Klasse:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Support for JDK 5.0 Annotations (and JSR-220) is currently under " +"development. Please refer to the Hibernate Annotations module for more " +"details." +msgstr "" +"Bitte beachten Sie, dass am Support für JDK 5.0 Annotationen (und JSR-220) " +"noch gearbeitet wird und dieser noch nicht vollständig verfügbar ist. " +"Weitere Einzelheiten entnehmen Sie bitte dem Hibernate Annotationsmodul." + +#. Tag: title +#, fuzzy, no-c-format +msgid "Generated properties" +msgstr "Generierte Properties" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Generated properties are properties that have their values generated by the " +"database. Typically, Hibernate applications needed to <literal>refresh</" +"literal> objects that contain any properties for which the database was " +"generating values. Marking properties as generated, however, lets the " +"application delegate this responsibility to Hibernate. When Hibernate issues " +"an SQL INSERT or UPDATE for an entity that has defined generated properties, " +"it immediately issues a select afterwards to retrieve the generated values." +msgstr "" +"Bei generierten Properties handelt es sich um Properties, deren Wert durch " +"die Datenbank generiert wird. In der Regel mussten Hibernate-Anwendungen " +"Objekte <literal>refresh</literal> (auffrischen), die Properties enthalten, " +"für die die Datenbank Werte generierte. Werden die Properties jedoch als " +"generiert gekennzeichnet, so delegiert die Anwendung diese Zuständigkeit an " +"Hibernate. Jedes Mal wenn Hibernate ein SQL INSERT oder UPDATE für eine " +"Entity mit als generiert definierten Properties herausgibt, gibt es ein " +"\"select afterwards\" (Hinterher-Auswahl) heraus, um die generierten Werte " +"abzufragen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Properties marked as generated must additionally be non-insertable and non-" +"updateable. Only versions (<xref linkend=\"mapping-declaration-version\" /" +">), timestamps (<xref linkend=\"mapping-declaration-timestamp\" />), and " +"simple properties (<xref linkend=\"mapping-declaration-property\" />), can " +"be marked as generated." +msgstr "" +"Als generiert gekennzeichnete Properties müssen zusätzlich auch nicht " +"einfügbar und nicht aktualisierbar sein (d.h. \"non-insertable\" bzw. \"non-" +"updateable\"). Nur <xref linkend=\"mapping-declaration-version\"/>-" +"Versionen, <xref linkend=\"mapping-declaration-timestamp\"/>-Zeitstempel und " +"einfache <xref linkend=\"mapping-declaration-property\"/>-Properties können " +"als generiert gekennzeichnet sein." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>never</literal> (the default): the given property value is not " +"generated within the database." +msgstr "" +"<literal>never</literal> (the default) - bedeutet, dass der gegebene " +"Property-Wert nicht innerhalb der Datenbank generiert wird." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>insert</literal>: the given property value is generated on insert, " +"but is not regenerated on subsequent updates. Properties like created-date " +"fall into this category. Even though version (<xref linkend=\"mapping-" +"declaration-version\" />) and timestamp (<xref linkend=\"mapping-declaration-" +"timestamp\" />) properties can be marked as generated, this option is not " +"available." +msgstr "" +"<literal>insert</literal> - besagt, dass der gegebene Property-Wert bei der " +"Einfügung generiert wird, jedoch bei nachfolgenden Aktualisierungen nicht " +"aufgefrischt wird. Dinge wie Erstelldatum fallen zum Beispiel in diese " +"Kategorie. Bitte beachten Sie, dass <xref linkend=\"mapping-declaration-" +"version\"/>-Version und <xref linkend=\"mapping-declaration-timestamp\"/>-" +"Zeitstempel-Properties zwar als generiert gekennzeichnet werden können, " +"diese Option dort jedoch nicht existiert." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>always</literal>: the property value is generated both on insert " +"and on update." +msgstr "" +"<literal>always</literal> - besagt, dass der Property-Wert sowohl bei der " +"Einfügung als auch bei der Aktualisierung generiert wird." + +#. Tag: title +#, fuzzy, no-c-format +msgid "Auxiliary database objects" +msgstr "Datenbankhilfsobjekte" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Auxiliary database objects allow for the CREATE and DROP of arbitrary " +"database objects. In conjunction with Hibernate's schema evolution tools, " +"they have the ability to fully define a user schema within the Hibernate " +"mapping files. Although designed specifically for creating and dropping " +"things like triggers or stored procedures, any SQL command that can be run " +"via a <literal>java.sql.Statement.execute()</literal> method is valid (for " +"example, ALTERs, INSERTS, etc.). There are essentially two modes for " +"defining auxiliary database objects:" +msgstr "" +"Erlaubt CREATE und DROP beliebiger Datenbankobjekte in Verbindung mit " +"Hibernates Schema-Evolution-Tools, um die Möglichkeit der vollständigen " +"Definition des Benutzerschemas innerhalb der Hibernate Mapping-Dateien zu " +"bieten. Obwohl speziell für die Erstellung und das \"Dropping\" von Triggern " +"oder gespeicherten Vorgängen entwickelt, kann eigentlich so ziemlich jeder " +"SQL-Befehl mittels der <literal>java.sql.Statement.execute()</literal>-" +"Methode ausgeführt werden und ist hier gültig (ALTERs, INSERTS, usw). Es " +"gibt im Wesentlichen zwei Modi der Definition von Datenbankhilfsobjekten..." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The first mode is to explicitly list the CREATE and DROP commands in the " +"mapping file:" +msgstr "" +"Die erste Methode ist die explizite Auflistung der CREATE- und DROP-Befehle " +"in der Mapping-Datei:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The second mode is to supply a custom class that constructs the CREATE and " +"DROP commands. This custom class must implement the <literal>org.hibernate." +"mapping.AuxiliaryDatabaseObject</literal> interface." +msgstr "" +"Die zweite Methode ist die Bereitstellung einer angepassten Klasse, die " +"weiß, wie CREATE- und DROP-Befehle erstellt werden. Diese angepasste Klasse " +"muss das <literal>org.hibernate.mapping.AuxiliaryDatabaseObject</literal>-" +"Interface implementieren." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Additionally, these database objects can be optionally scoped so that they " +"only apply when certain dialects are used." +msgstr "" +"Zusätzlich können diese Datenbankobjekte wahlweise so abgegrenzt werden, " +"dass Sie nur in Kraft treten, wenn bestimmte Dialekte verwendet werden." + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<?xml version=\"1.0\"?>\n" +#~ "<!DOCTYPE hibernate-mapping PUBLIC\n" +#~ " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" +#~ " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd" +#~ "\">\n" +#~ "\n" +#~ "<hibernate-mapping package=\"eg\">\n" +#~ "\n" +#~ " <class name=\"Cat\"\n" +#~ " table=\"cats\"\n" +#~ " discriminator-value=\"C\">\n" +#~ "\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ "\n" +#~ " <discriminator column=\"subclass\"\n" +#~ " type=\"character\"/>\n" +#~ "\n" +#~ " <property name=\"weight\"/>\n" +#~ "\n" +#~ " <property name=\"birthdate\"\n" +#~ " type=\"date\"\n" +#~ " not-null=\"true\"\n" +#~ " update=\"false\"/>\n" +#~ "\n" +#~ " <property name=\"color\"\n" +#~ " type=\"eg.types.ColorUserType\"\n" +#~ " not-null=\"true\"\n" +#~ " update=\"false\"/>\n" +#~ "\n" +#~ " <property name=\"sex\"\n" +#~ " not-null=\"true\"\n" +#~ " update=\"false\"/>\n" +#~ "\n" +#~ " <property name=\"litterId\"\n" +#~ " column=\"litterId\"\n" +#~ " update=\"false\"/>\n" +#~ "\n" +#~ " <many-to-one name=\"mother\"\n" +#~ " column=\"mother_id\"\n" +#~ " update=\"false\"/>\n" +#~ "\n" +#~ " <set name=\"kittens\"\n" +#~ " inverse=\"true\"\n" +#~ " order-by=\"litter_id\">\n" +#~ " <key column=\"mother_id\"/>\n" +#~ " <one-to-many class=\"Cat\"/>\n" +#~ " </set>\n" +#~ "\n" +#~ " <subclass name=\"DomesticCat\"\n" +#~ " discriminator-value=\"D\">\n" +#~ "\n" +#~ " <property name=\"name\"\n" +#~ " type=\"string\"/>\n" +#~ "\n" +#~ " </subclass>\n" +#~ "\n" +#~ " </class>\n" +#~ "\n" +#~ " <class name=\"Dog\">\n" +#~ " \n" +#~ " </class>\n" +#~ "\n" +#~ "</hibernate-mapping>]]>" +#~ msgstr "" +#~ "<?xml version=\"1.0\"?>\n" +#~ "<!DOCTYPE hibernate-mapping PUBLIC\n" +#~ " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" +#~ " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd" +#~ "\">\n" +#~ "\n" +#~ "<hibernate-mapping package=\"eg\">\n" +#~ "\n" +#~ " <class name=\"Cat\" \n" +#~ " table=\"cats\"\n" +#~ " discriminator-value=\"C\">\n" +#~ " \n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ "\n" +#~ " <discriminator column=\"subclass\" \n" +#~ " type=\"character\"/>\n" +#~ "\n" +#~ " <property name=\"weight\"/>\n" +#~ "\n" +#~ " <property name=\"birthdate\"\n" +#~ " type=\"date\" \n" +#~ " not-null=\"true\" \n" +#~ " update=\"false\"/>\n" +#~ "\n" +#~ " <property name=\"color\"\n" +#~ " type=\"eg.types.ColorUserType\"\n" +#~ " not-null=\"true\"\n" +#~ " update=\"false\"/>\n" +#~ "\n" +#~ " <property name=\"sex\"\n" +#~ " not-null=\"true\" \n" +#~ " update=\"false\"/>\n" +#~ "\n" +#~ " <property name=\"litterId\"\n" +#~ " column=\"litterId\"\n" +#~ " update=\"false\"/>\n" +#~ "\n" +#~ " <many-to-one name=\"mother\"\n" +#~ " column=\"mother_id\"\n" +#~ " update=\"false\"/>\n" +#~ "\n" +#~ " <set name=\"kittens\"\n" +#~ " inverse=\"true\"\n" +#~ " order-by=\"litter_id\">\n" +#~ " <key column=\"mother_id\"/>\n" +#~ " <one-to-many class=\"Cat\"/>\n" +#~ " </set>\n" +#~ "\n" +#~ " <subclass name=\"DomesticCat\"\n" +#~ " discriminator-value=\"D\">\n" +#~ "\n" +#~ " <property name=\"name\" \n" +#~ " type=\"string\"/>\n" +#~ "\n" +#~ " </subclass>\n" +#~ "\n" +#~ " </class>\n" +#~ "\n" +#~ " <class name=\"Dog\">\n" +#~ " \n" +#~ " </class>\n" +#~ "\n" +#~ "</hibernate-mapping>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<?xml version=\"1.0\"?>\n" +#~ "<!DOCTYPE hibernate-mapping PUBLIC\n" +#~ " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" +#~ " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\" [\n" +#~ " <!ENTITY types SYSTEM \"classpath://your/domain/types.xml\">\n" +#~ "]>\n" +#~ "\n" +#~ "<hibernate-mapping package=\"your.domain\">\n" +#~ " <class name=\"MyEntity\">\n" +#~ " <id name=\"id\" type=\"my-custom-id-type\">\n" +#~ " ...\n" +#~ " </id>\n" +#~ " <class>\n" +#~ " &types;\n" +#~ "</hibernate-mapping>]]>" +#~ msgstr "" +#~ "<?xml version=\"1.0\"?>\n" +#~ "<!DOCTYPE hibernate-mapping PUBLIC\n" +#~ " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" +#~ " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd" +#~ "\">\n" +#~ "\n" +#~ "<hibernate-mapping>\n" +#~ "[...]\n" +#~ "</hibernate-mapping>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<hibernate-mapping\n" +#~ " schema=\"schemaName\"\n" +#~ " catalog=\"catalogName\"\n" +#~ " default-cascade=\"cascade_style\"\n" +#~ " default-access=\"field|property|ClassName\"\n" +#~ " default-lazy=\"true|false\"\n" +#~ " auto-import=\"true|false\"\n" +#~ " package=\"package.name\"\n" +#~ " />]]>" +#~ msgstr "" +#~ "<hibernate-mapping\n" +#~ " schema=\"schemaName\"\n" +#~ " catalog=\"catalogName\"\n" +#~ " default-cascade=\"cascade_style\"\n" +#~ " default-access=\"field|property|ClassName\"\n" +#~ " default-lazy=\"true|false\"\n" +#~ " auto-import=\"true|false\"\n" +#~ " package=\"package.name\"\n" +#~ " />" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class\n" +#~ " name=\"ClassName\"\n" +#~ " table=\"tableName\"\n" +#~ " discriminator-value=\"discriminator_value\"\n" +#~ " mutable=\"true|false\"\n" +#~ " schema=\"owner\"\n" +#~ " catalog=\"catalog\"\n" +#~ " proxy=\"ProxyInterface\"\n" +#~ " dynamic-update=\"true|false\"\n" +#~ " dynamic-insert=\"true|false\"\n" +#~ " select-before-update=\"true|false\"\n" +#~ " polymorphism=\"implicit|explicit\"\n" +#~ " where=\"arbitrary sql where condition\"\n" +#~ " persister=\"PersisterClass\"\n" +#~ " batch-size=\"N\"\n" +#~ " optimistic-lock=\"none|version|dirty|all\"\n" +#~ " lazy=\"true|false\"\n" +#~ " entity-name=\"EntityName\"\n" +#~ " check=\"arbitrary sql check condition\"\n" +#~ " rowid=\"rowid\"\n" +#~ " subselect=\"SQL expression\"\n" +#~ " abstract=\"true|false\"\n" +#~ " node=\"element-name\"\n" +#~ "/>]]>" +#~ msgstr "" +#~ "<class\n" +#~ " name=\"ClassName\"\n" +#~ " table=\"tableName\"\n" +#~ " discriminator-value=\"discriminator_value\"\n" +#~ " mutable=\"true|false\"\n" +#~ " schema=\"owner\"\n" +#~ " catalog=\"catalog\"\n" +#~ " proxy=\"ProxyInterface\"\n" +#~ " dynamic-update=\"true|false\"\n" +#~ " dynamic-insert=\"true|false\"\n" +#~ " select-before-update=\"true|false\"\n" +#~ " polymorphism=\"implicit|explicit\"\n" +#~ " where=\"arbitrary sql where condition\"\n" +#~ " persister=\"PersisterClass\"\n" +#~ " batch-size=\"N\"\n" +#~ " optimistic-lock=\"none|version|dirty|all\"\n" +#~ " lazy=\"true|false\"\n" +#~ " entity-name=\"EntityName\"\n" +#~ " check=\"arbitrary sql check condition\"\n" +#~ " rowid=\"rowid\"\n" +#~ " subselect=\"SQL expression\"\n" +#~ " abstract=\"true|false\"\n" +#~ " node=\"element-name\"\n" +#~ "/>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Summary\">\n" +#~ " <subselect>\n" +#~ " select item.name, max(bid.amount), count(*)\n" +#~ " from item\n" +#~ " join bid on bid.item_id = item.id\n" +#~ " group by item.name\n" +#~ " </subselect>\n" +#~ " <synchronize table=\"item\"/>\n" +#~ " <synchronize table=\"bid\"/>\n" +#~ " <id name=\"name\"/>\n" +#~ " ...\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Summary\">\n" +#~ " <subselect>\n" +#~ " select item.name, max(bid.amount), count(*)\n" +#~ " from item\n" +#~ " join bid on bid.item_id = item.id\n" +#~ " group by item.name\n" +#~ " </subselect>\n" +#~ " <synchronize table=\"item\"/>\n" +#~ " <synchronize table=\"bid\"/>\n" +#~ " <id name=\"name\"/>\n" +#~ " ...\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<id\n" +#~ " name=\"propertyName\"\n" +#~ " type=\"typename\"\n" +#~ " column=\"column_name\"\n" +#~ " unsaved-value=\"null|any|none|undefined|id_value\"\n" +#~ " access=\"field|property|ClassName\">\n" +#~ " node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" +#~ "\n" +#~ " <generator class=\"generatorClass\"/>\n" +#~ "</id>]]>" +#~ msgstr "" +#~ "<id\n" +#~ " name=\"propertyName\"\n" +#~ " type=\"typename\"\n" +#~ " column=\"column_name\"\n" +#~ " unsaved-value=\"null|any|none|undefined|id_value\"\n" +#~ " access=\"field|property|ClassName\">\n" +#~ " node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" +#~ "\n" +#~ " <generator class=\"generatorClass\"/>\n" +#~ "</id>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<id name=\"id\" type=\"long\" column=\"cat_id\">\n" +#~ " <generator class=\"org.hibernate.id.TableHiLoGenerator\">\n" +#~ " <param name=\"table\">uid_table</param>\n" +#~ " <param name=\"column\">next_hi_value_column</param>\n" +#~ " </generator>\n" +#~ "</id>]]>" +#~ msgstr "" +#~ "<id name=\"id\" type=\"long\" column=\"cat_id\">\n" +#~ " <generator class=\"org.hibernate.id.TableHiLoGenerator\">\n" +#~ " <param name=\"table\">uid_table</param>\n" +#~ " <param name=\"column\">next_hi_value_column</" +#~ "param>\n" +#~ " </generator>\n" +#~ "</id>" + +#~ msgid "increment" +#~ msgstr "increment" + +#~ msgid "identity" +#~ msgstr "identity" + +#~ msgid "sequence" +#~ msgstr "sequence" + +#~ msgid "hilo" +#~ msgstr "hilo" + +#~ msgid "seqhilo" +#~ msgstr "seqhilo" + +#~ msgid "guid" +#~ msgstr "guid" + +#~ msgid "native" +#~ msgstr "native" + +#~ msgid "assigned" +#~ msgstr "assigned" + +#~ msgid "select" +#~ msgstr "select" + +#~ msgid "foreign" +#~ msgstr "foreign" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<id name=\"id\" type=\"long\" column=\"cat_id\">\n" +#~ " <generator class=\"hilo\">\n" +#~ " <param name=\"table\">hi_value</param>\n" +#~ " <param name=\"column\">next_value</param>\n" +#~ " <param name=\"max_lo\">100</param>\n" +#~ " </generator>\n" +#~ "</id>]]>" +#~ msgstr "" +#~ "<id name=\"id\" type=\"long\" column=\"cat_id\">\n" +#~ " <generator class=\"hilo\">\n" +#~ " <param name=\"table\">hi_value</param>\n" +#~ " <param name=\"column\">next_value</param>\n" +#~ " <param name=\"max_lo\">100</param>\n" +#~ " </generator>\n" +#~ "</id>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<id name=\"id\" type=\"long\" column=\"cat_id\">\n" +#~ " <generator class=\"seqhilo\">\n" +#~ " <param name=\"sequence\">hi_value</param>\n" +#~ " <param name=\"max_lo\">100</param>\n" +#~ " </generator>\n" +#~ "</id>]]>" +#~ msgstr "" +#~ "<id name=\"id\" type=\"long\" column=\"cat_id\">\n" +#~ " <generator class=\"seqhilo\">\n" +#~ " <param name=\"sequence\">hi_value</param>\n" +#~ " <param name=\"max_lo\">100</param>\n" +#~ " </generator>\n" +#~ "</id>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<id name=\"id\" type=\"long\" column=\"person_id\">\n" +#~ " <generator class=\"sequence\">\n" +#~ " <param name=\"sequence\">person_id_sequence</param>\n" +#~ " </generator>\n" +#~ "</id>]]>" +#~ msgstr "" +#~ "<id name=\"id\" type=\"long\" column=\"person_id\">\n" +#~ " <generator class=\"sequence\">\n" +#~ " <param name=\"sequence\">person_id_sequence</" +#~ "param>\n" +#~ " </generator>\n" +#~ "</id>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<id name=\"id\" type=\"long\" column=\"person_id\" unsaved-value=" +#~ "\"0\">\n" +#~ " <generator class=\"identity\"/>\n" +#~ "</id>]]>" +#~ msgstr "" +#~ "<id name=\"id\" type=\"long\" column=\"person_id\" unsaved-value=\"0" +#~ "\">\n" +#~ " <generator class=\"identity\"/>\n" +#~ "</id>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<id name=\"id\" type=\"long\" column=\"person_id\">\n" +#~ " <generator class=\"select\">\n" +#~ " <param name=\"key\">socialSecurityNumber</param>\n" +#~ " </generator>\n" +#~ "</id>]]>" +#~ msgstr "" +#~ "<id name=\"id\" type=\"long\" column=\"person_id\">\n" +#~ " <generator class=\"select\">\n" +#~ " <param name=\"key\">socialSecurityNumber</" +#~ "param>\n" +#~ " </generator>\n" +#~ "</id>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<composite-id\n" +#~ " name=\"propertyName\"\n" +#~ " class=\"ClassName\"\n" +#~ " mapped=\"true|false\"\n" +#~ " access=\"field|property|ClassName\">\n" +#~ " node=\"element-name|.\"\n" +#~ "\n" +#~ " <key-property name=\"propertyName\" type=\"typename\" column=" +#~ "\"column_name\"/>\n" +#~ " <key-many-to-one name=\"propertyName class=\"ClassName\" column=" +#~ "\"column_name\"/>\n" +#~ " ......\n" +#~ "</composite-id>]]>" +#~ msgstr "" +#~ "<composite-id\n" +#~ " name=\"propertyName\"\n" +#~ " class=\"ClassName\"\n" +#~ " mapped=\"true|false\"\n" +#~ " access=\"field|property|ClassName\">\n" +#~ " node=\"element-name|.\"\n" +#~ "\n" +#~ " <key-property name=\"propertyName\" type=\"typename\" column=" +#~ "\"column_name\"/>\n" +#~ " <key-many-to-one name=\"propertyName class=\"ClassName\" " +#~ "column=\"column_name\"/>\n" +#~ " ......\n" +#~ "</composite-id>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<composite-id>\n" +#~ " <key-property name=\"medicareNumber\"/>\n" +#~ " <key-property name=\"dependent\"/>\n" +#~ "</composite-id>]]>" +#~ msgstr "" +#~ "<composite-id>\n" +#~ " <key-property name=\"medicareNumber\"/>\n" +#~ " <key-property name=\"dependent\"/>\n" +#~ "</composite-id>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<composite-id class=\"MedicareId\" mapped=\"true\">\n" +#~ " <key-property name=\"medicareNumber\"/>\n" +#~ " <key-property name=\"dependent\"/>\n" +#~ "</composite-id>]]>" +#~ msgstr "" +#~ "<composite-id class=\"MedicareId\" mapped=\"true\">\n" +#~ " <key-property name=\"medicareNumber\"/>\n" +#~ " <key-property name=\"dependent\"/>\n" +#~ "</composite-id>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<discriminator\n" +#~ " column=\"discriminator_column\"\n" +#~ " type=\"discriminator_type\"\n" +#~ " force=\"true|false\"\n" +#~ " insert=\"true|false\"\n" +#~ " formula=\"arbitrary sql expression\"\n" +#~ "/>]]>" +#~ msgstr "" +#~ "<discriminator\n" +#~ " column=\"discriminator_column\"\n" +#~ " type=\"discriminator_type\"\n" +#~ " force=\"true|false\"\n" +#~ " insert=\"true|false\"\n" +#~ " formula=\"arbitrary sql expression\"\n" +#~ "/>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<discriminator\n" +#~ " formula=\"case when CLASS_TYPE in ('a', 'b', 'c') then 0 else 1 end" +#~ "\"\n" +#~ " type=\"integer\"/>]]>" +#~ msgstr "" +#~ "<discriminator\n" +#~ " formula=\"case when CLASS_TYPE in ('a', 'b', 'c') then 0 else 1 end" +#~ "\"\n" +#~ " type=\"integer\"/>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<version\n" +#~ " column=\"version_column\"\n" +#~ " name=\"propertyName\"\n" +#~ " type=\"typename\"\n" +#~ " access=\"field|property|ClassName\"\n" +#~ " unsaved-value=\"null|negative|undefined\"\n" +#~ " generated=\"never|always\"\n" +#~ " insert=\"true|false\"\n" +#~ " node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" +#~ "/>]]>" +#~ msgstr "" +#~ "<version\n" +#~ " column=\"version_column\"\n" +#~ " name=\"propertyName\"\n" +#~ " type=\"typename\"\n" +#~ " access=\"field|property|ClassName\"\n" +#~ " unsaved-value=\"null|negative|undefined\"\n" +#~ " generated=\"never|always\"\n" +#~ " insert=\"true|false\"\n" +#~ " node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" +#~ "/>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<timestamp\n" +#~ " column=\"timestamp_column\"\n" +#~ " name=\"propertyName\"\n" +#~ " access=\"field|property|ClassName\"\n" +#~ " unsaved-value=\"null|undefined\"\n" +#~ " source=\"vm|db\"\n" +#~ " generated=\"never|always\"\n" +#~ " node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" +#~ "/>]]>" +#~ msgstr "" +#~ "<timestamp\n" +#~ " column=\"timestamp_column\"\n" +#~ " name=\"propertyName\"\n" +#~ " access=\"field|property|ClassName\"\n" +#~ " unsaved-value=\"null|undefined\"\n" +#~ " source=\"vm|db\"\n" +#~ " generated=\"never|always\"\n" +#~ " node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" +#~ "/>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<property\n" +#~ " name=\"propertyName\"\n" +#~ " column=\"column_name\"\n" +#~ " type=\"typename\"\n" +#~ " update=\"true|false\"\n" +#~ " insert=\"true|false\"\n" +#~ " formula=\"arbitrary SQL expression\"\n" +#~ " access=\"field|property|ClassName\"\n" +#~ " lazy=\"true|false\"\n" +#~ " unique=\"true|false\"\n" +#~ " not-null=\"true|false\"\n" +#~ " optimistic-lock=\"true|false\"\n" +#~ " generated=\"never|insert|always\"\n" +#~ " node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" +#~ " index=\"index_name\"\n" +#~ " unique_key=\"unique_key_id\"\n" +#~ " length=\"L\"\n" +#~ " precision=\"P\"\n" +#~ " scale=\"S\"\n" +#~ "/>]]>" +#~ msgstr "" +#~ "<property\n" +#~ " name=\"propertyName\"\n" +#~ " column=\"column_name\"\n" +#~ " type=\"typename\"\n" +#~ " update=\"true|false\"\n" +#~ " insert=\"true|false\"\n" +#~ " formula=\"arbitrary SQL expression\"\n" +#~ " access=\"field|property|ClassName\"\n" +#~ " lazy=\"true|false\"\n" +#~ " unique=\"true|false\"\n" +#~ " not-null=\"true|false\"\n" +#~ " optimistic-lock=\"true|false\"\n" +#~ " generated=\"never|insert|always\"\n" +#~ " node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" +#~ " index=\"index_name\"\n" +#~ " unique_key=\"unique_key_id\"\n" +#~ " length=\"L\"\n" +#~ " precision=\"P\"\n" +#~ " scale=\"S\"\n" +#~ "/>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[\n" +#~ "<property name=\"totalPrice\"\n" +#~ " formula=\"( SELECT SUM (li.quantity*p.price) FROM LineItem li, " +#~ "Product p\n" +#~ " WHERE li.productId = p.productId\n" +#~ " AND li.customerId = customerId\n" +#~ " AND li.orderNumber = orderNumber )\"/>]]>" +#~ msgstr "" +#~ "<property name=\"totalPrice\"\n" +#~ " formula=\"( SELECT SUM (li.quantity*p.price) FROM LineItem li, " +#~ "Product p\n" +#~ " WHERE li.productId = p.productId\n" +#~ " AND li.customerId = customerId\n" +#~ " AND li.orderNumber = orderNumber )\"/>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<many-to-one\n" +#~ " name=\"propertyName\"\n" +#~ " column=\"column_name\"\n" +#~ " class=\"ClassName\"\n" +#~ " cascade=\"cascade_style\"\n" +#~ " fetch=\"join|select\"\n" +#~ " update=\"true|false\"\n" +#~ " insert=\"true|false\"\n" +#~ " property-ref=\"propertyNameFromAssociatedClass\"\n" +#~ " access=\"field|property|ClassName\"\n" +#~ " unique=\"true|false\"\n" +#~ " not-null=\"true|false\"\n" +#~ " optimistic-lock=\"true|false\"\n" +#~ " lazy=\"proxy|no-proxy|false\"\n" +#~ " not-found=\"ignore|exception\"\n" +#~ " entity-name=\"EntityName\"\n" +#~ " formula=\"arbitrary SQL expression\"\n" +#~ " node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" +#~ " embed-xml=\"true|false\"\n" +#~ " index=\"index_name\"\n" +#~ " unique_key=\"unique_key_id\"\n" +#~ " foreign-key=\"foreign_key_name\"\n" +#~ "/>]]>" +#~ msgstr "" +#~ "<many-to-one\n" +#~ " name=\"propertyName\"\n" +#~ " column=\"column_name\"\n" +#~ " class=\"ClassName\"\n" +#~ " cascade=\"cascade_style\"\n" +#~ " fetch=\"join|select\"\n" +#~ " update=\"true|false\"\n" +#~ " insert=\"true|false\"\n" +#~ " property-ref=\"propertyNameFromAssociatedClass\"\n" +#~ " access=\"field|property|ClassName\"\n" +#~ " unique=\"true|false\"\n" +#~ " not-null=\"true|false\"\n" +#~ " optimistic-lock=\"true|false\"\n" +#~ " lazy=\"proxy|no-proxy|false\"\n" +#~ " not-found=\"ignore|exception\"\n" +#~ " entity-name=\"EntityName\"\n" +#~ " formula=\"arbitrary SQL expression\"\n" +#~ " node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" +#~ " embed-xml=\"true|false\"\n" +#~ " index=\"index_name\"\n" +#~ " unique_key=\"unique_key_id\"\n" +#~ " foreign-key=\"foreign_key_name\"\n" +#~ "/>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<many-to-one name=\"product\" class=\"Product\" column=" +#~ "\"PRODUCT_ID\"/>]]>" +#~ msgstr "" +#~ "<many-to-one name=\"product\" class=\"Product\" column=\"PRODUCT_ID\"/" +#~ ">" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<property name=\"serialNumber\" unique=\"true\" type=\"string\" " +#~ "column=\"SERIAL_NUMBER\"/>]]>" +#~ msgstr "" +#~ "<property name=\"serialNumber\" unique=\"true\" type=\"string\" column=" +#~ "\"SERIAL_NUMBER\"/>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<many-to-one name=\"product\" property-ref=\"serialNumber\" " +#~ "column=\"PRODUCT_SERIAL_NUMBER\"/>]]>" +#~ msgstr "" +#~ "<many-to-one name=\"product\" property-ref=\"serialNumber\" column=" +#~ "\"PRODUCT_SERIAL_NUMBER\"/>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<many-to-one name=\"owner\" property-ref=\"identity.ssn\" column=" +#~ "\"OWNER_SSN\"/>]]>" +#~ msgstr "" +#~ "<many-to-one name=\"owner\" property-ref=\"identity.ssn\" column=" +#~ "\"OWNER_SSN\"/>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<one-to-one\n" +#~ " name=\"propertyName\"\n" +#~ " class=\"ClassName\"\n" +#~ " cascade=\"cascade_style\"\n" +#~ " constrained=\"true|false\"\n" +#~ " fetch=\"join|select\"\n" +#~ " property-ref=\"propertyNameFromAssociatedClass\"\n" +#~ " access=\"field|property|ClassName\"\n" +#~ " formula=\"any SQL expression\"\n" +#~ " lazy=\"proxy|no-proxy|false\"\n" +#~ " entity-name=\"EntityName\"\n" +#~ " node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" +#~ " embed-xml=\"true|false\"\n" +#~ " foreign-key=\"foreign_key_name\"\n" +#~ "/>]]>" +#~ msgstr "" +#~ "<one-to-one\n" +#~ " name=\"propertyName\"\n" +#~ " class=\"ClassName\"\n" +#~ " cascade=\"cascade_style\"\n" +#~ " constrained=\"true|false\"\n" +#~ " fetch=\"join|select\"\n" +#~ " property-ref=\"propertyNameFromAssociatedClass\"\n" +#~ " access=\"field|property|ClassName\"\n" +#~ " formula=\"any SQL expression\"\n" +#~ " lazy=\"proxy|no-proxy|false\"\n" +#~ " entity-name=\"EntityName\"\n" +#~ " node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" +#~ " embed-xml=\"true|false\"\n" +#~ " foreign-key=\"foreign_key_name\"\n" +#~ "/>" + +#, fuzzy +#~ msgid "<![CDATA[<one-to-one name=\"person\" class=\"Person\"/>]]>" +#~ msgstr "<one-to-one name=\"person\" class=\"Person\"/>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<one-to-one name=\"employee\" class=\"Employee\" constrained=" +#~ "\"true\"/>]]>" +#~ msgstr "" +#~ "<one-to-one name=\"employee\" class=\"Employee\" constrained=\"true\"/" +#~ ">" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"person\" table=\"PERSON\">\n" +#~ " <id name=\"id\" column=\"PERSON_ID\">\n" +#~ " <generator class=\"foreign\">\n" +#~ " <param name=\"property\">employee</param>\n" +#~ " </generator>\n" +#~ " </id>\n" +#~ " ...\n" +#~ " <one-to-one name=\"employee\"\n" +#~ " class=\"Employee\"\n" +#~ " constrained=\"true\"/>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"person\" table=\"PERSON\">\n" +#~ " <id name=\"id\" column=\"PERSON_ID\">\n" +#~ " <generator class=\"foreign\">\n" +#~ " <param name=\"property\">employee</param>\n" +#~ " </generator>\n" +#~ " </id>\n" +#~ " ...\n" +#~ " <one-to-one name=\"employee\"\n" +#~ " class=\"Employee\"\n" +#~ " constrained=\"true\"/>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<many-to-one name=\"person\" class=\"Person\" column=\"PERSON_ID" +#~ "\" unique=\"true\"/>]]>" +#~ msgstr "" +#~ "<many-to-one name=\"person\" class=\"Person\" column=\"PERSON_ID\" " +#~ "unique=\"true\"/>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<one-to-one name=\"employee\" class=\"Employee\" property-ref=" +#~ "\"person\"/>]]>" +#~ msgstr "" +#~ "<one-to-one name\"employee\" class=\"Employee\" property-ref=\"person" +#~ "\"/>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<natural-id mutable=\"true|false\"/>\n" +#~ " <property ... />\n" +#~ " <many-to-one ... />\n" +#~ " ......\n" +#~ "</natural-id>]]>" +#~ msgstr "" +#~ "<natural-id mutable=\"true|false\"/>\n" +#~ " <property ... />\n" +#~ " <many-to-one ... />\n" +#~ " ......\n" +#~ "</natural-id>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<component\n" +#~ " name=\"propertyName\"\n" +#~ " class=\"className\"\n" +#~ " insert=\"true|false\"\n" +#~ " update=\"true|false\"\n" +#~ " access=\"field|property|ClassName\"\n" +#~ " lazy=\"true|false\"\n" +#~ " optimistic-lock=\"true|false\"\n" +#~ " unique=\"true|false\"\n" +#~ " node=\"element-name|.\"\n" +#~ ">\n" +#~ "\n" +#~ " <property ...../>\n" +#~ " <many-to-one .... />\n" +#~ " ........\n" +#~ "</component>]]>" +#~ msgstr "" +#~ "<component \n" +#~ " name=\"propertyName\" \n" +#~ " class=\"className\"\n" +#~ " insert=\"true|false\"\n" +#~ " update=\"true|false\"\n" +#~ " access=\"field|property|ClassName\"\n" +#~ " lazy=\"true|false\"\n" +#~ " optimistic-lock=\"true|false\"\n" +#~ " unique=\"true|false\"\n" +#~ " node=\"element-name|.\"\n" +#~ ">\n" +#~ " \n" +#~ " <property ...../>\n" +#~ " <many-to-one .... />\n" +#~ " ........\n" +#~ "</component>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<properties\n" +#~ " name=\"logicalName\"\n" +#~ " insert=\"true|false\"\n" +#~ " update=\"true|false\"\n" +#~ " optimistic-lock=\"true|false\"\n" +#~ " unique=\"true|false\"\n" +#~ ">\n" +#~ "\n" +#~ " <property ...../>\n" +#~ " <many-to-one .... />\n" +#~ " ........\n" +#~ "</properties>]]>" +#~ msgstr "" +#~ "<properties \n" +#~ " name=\"logicalName\" \n" +#~ " insert=\"true|false\"\n" +#~ " update=\"true|false\"\n" +#~ " optimistic-lock=\"true|false\"\n" +#~ " unique=\"true|false\"\n" +#~ ">\n" +#~ " \n" +#~ " <property ...../>\n" +#~ " <many-to-one .... />\n" +#~ " ........\n" +#~ "</properties>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Person\">\n" +#~ " <id name=\"personNumber\"/>\n" +#~ "\n" +#~ " ...\n" +#~ " <properties name=\"name\"\n" +#~ " unique=\"true\" update=\"false\">\n" +#~ " <property name=\"firstName\"/>\n" +#~ " <property name=\"initial\"/>\n" +#~ " <property name=\"lastName\"/>\n" +#~ " </properties>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Person\">\n" +#~ " <id name=\"personNumber\"/>\n" +#~ " ...\n" +#~ " <properties name=\"name\" \n" +#~ " unique=\"true\" update=\"false\">\n" +#~ " <property name=\"firstName\"/>\n" +#~ " <property name=\"initial\"/>\n" +#~ " <property name=\"lastName\"/>\n" +#~ " </properties>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<many-to-one name=\"person\"\n" +#~ " class=\"Person\" property-ref=\"name\">\n" +#~ " <column name=\"firstName\"/>\n" +#~ " <column name=\"initial\"/>\n" +#~ " <column name=\"lastName\"/>\n" +#~ "</many-to-one>]]>" +#~ msgstr "" +#~ "<many-to-one name=\"person\" \n" +#~ " class=\"Person\" property-ref=\"name\">\n" +#~ " <column name=\"firstName\"/>\n" +#~ " <column name=\"initial\"/>\n" +#~ " <column name=\"lastName\"/>\n" +#~ "</many-to-one>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<subclass\n" +#~ " name=\"ClassName\"\n" +#~ " discriminator-value=\"discriminator_value\"\n" +#~ " proxy=\"ProxyInterface\"\n" +#~ " lazy=\"true|false\"\n" +#~ " dynamic-update=\"true|false\"\n" +#~ " dynamic-insert=\"true|false\"\n" +#~ " entity-name=\"EntityName\"\n" +#~ " node=\"element-name\"\n" +#~ " extends=\"SuperclassName\">\n" +#~ "\n" +#~ " <property .... />\n" +#~ " .....\n" +#~ "</subclass>]]>" +#~ msgstr "" +#~ "<subclass\n" +#~ " name=\"ClassName\"\n" +#~ " discriminator-value=\"discriminator_value\"\n" +#~ " proxy=\"ProxyInterface\"\n" +#~ " lazy=\"true|false\"\n" +#~ " dynamic-update=\"true|false\"\n" +#~ " dynamic-insert=\"true|false\"\n" +#~ " entity-name=\"EntityName\"\n" +#~ " node=\"element-name\"\n" +#~ " extends=\"SuperclassName\">\n" +#~ "\n" +#~ " <property .... />\n" +#~ " .....\n" +#~ "</subclass>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<joined-subclass\n" +#~ " name=\"ClassName\"\n" +#~ " table=\"tablename\"\n" +#~ " proxy=\"ProxyInterface\"\n" +#~ " lazy=\"true|false\"\n" +#~ " dynamic-update=\"true|false\"\n" +#~ " dynamic-insert=\"true|false\"\n" +#~ " schema=\"schema\"\n" +#~ " catalog=\"catalog\"\n" +#~ " extends=\"SuperclassName\"\n" +#~ " persister=\"ClassName\"\n" +#~ " subselect=\"SQL expression\"\n" +#~ " entity-name=\"EntityName\"\n" +#~ " node=\"element-name\">\n" +#~ "\n" +#~ " <key .... >\n" +#~ "\n" +#~ " <property .... />\n" +#~ " .....\n" +#~ "</joined-subclass>]]>" +#~ msgstr "" +#~ "<joined-subclass\n" +#~ " name=\"ClassName\"\n" +#~ " table=\"tablename\"\n" +#~ " proxy=\"ProxyInterface\"\n" +#~ " lazy=\"true|false\"\n" +#~ " dynamic-update=\"true|false\"\n" +#~ " dynamic-insert=\"true|false\"\n" +#~ " schema=\"schema\"\n" +#~ " catalog=\"catalog\"\n" +#~ " extends=\"SuperclassName\"\n" +#~ " persister=\"ClassName\"\n" +#~ " subselect=\"SQL expression\"\n" +#~ " entity-name=\"EntityName\"\n" +#~ " node=\"element-name\">\n" +#~ "\n" +#~ " <key .... >\n" +#~ "\n" +#~ " <property .... />\n" +#~ " .....\n" +#~ "</joined-subclass>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<?xml version=\"1.0\"?>\n" +#~ "<!DOCTYPE hibernate-mapping PUBLIC\n" +#~ " \"-//Hibernate/Hibernate Mapping DTD//EN\"\n" +#~ " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" +#~ "\n" +#~ "<hibernate-mapping package=\"eg\">\n" +#~ "\n" +#~ " <class name=\"Cat\" table=\"CATS\">\n" +#~ " <id name=\"id\" column=\"uid\" type=\"long\">\n" +#~ " <generator class=\"hilo\"/>\n" +#~ " </id>\n" +#~ " <property name=\"birthdate\" type=\"date\"/>\n" +#~ " <property name=\"color\" not-null=\"true\"/>\n" +#~ " <property name=\"sex\" not-null=\"true\"/>\n" +#~ " <property name=\"weight\"/>\n" +#~ " <many-to-one name=\"mate\"/>\n" +#~ " <set name=\"kittens\">\n" +#~ " <key column=\"MOTHER\"/>\n" +#~ " <one-to-many class=\"Cat\"/>\n" +#~ " </set>\n" +#~ " <joined-subclass name=\"DomesticCat\" table=" +#~ "\"DOMESTIC_CATS\">\n" +#~ " <key column=\"CAT\"/>\n" +#~ " <property name=\"name\" type=\"string\"/>\n" +#~ " </joined-subclass>\n" +#~ " </class>\n" +#~ "\n" +#~ " <class name=\"eg.Dog\">\n" +#~ " \n" +#~ " </class>\n" +#~ "\n" +#~ "</hibernate-mapping>]]>" +#~ msgstr "" +#~ "<?xml version=\"1.0\"?>\n" +#~ "<!DOCTYPE hibernate-mapping PUBLIC\n" +#~ " \"-//Hibernate/Hibernate Mapping DTD//EN\"\n" +#~ " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd" +#~ "\">\n" +#~ "\n" +#~ "<hibernate-mapping package=\"eg\">\n" +#~ "\n" +#~ " <class name=\"Cat\" table=\"CATS\">\n" +#~ " <id name=\"id\" column=\"uid\" type=\"long\">\n" +#~ " <generator class=\"hilo\"/>\n" +#~ " </id>\n" +#~ " <property name=\"birthdate\" type=\"date\"/>\n" +#~ " <property name=\"color\" not-null=\"true\"/>\n" +#~ " <property name=\"sex\" not-null=\"true\"/>\n" +#~ " <property name=\"weight\"/>\n" +#~ " <many-to-one name=\"mate\"/>\n" +#~ " <set name=\"kittens\">\n" +#~ " <key column=\"MOTHER\"/>\n" +#~ " <one-to-many class=\"Cat\"/>\n" +#~ " </set>\n" +#~ " <joined-subclass name=\"DomesticCat\" table=" +#~ "\"DOMESTIC_CATS\">\n" +#~ " <key column=\"CAT\"/>\n" +#~ " <property name=\"name\" type=\"string\"/>\n" +#~ " </joined-subclass>\n" +#~ " </class>\n" +#~ "\n" +#~ " <class name=\"eg.Dog\">\n" +#~ " \n" +#~ " </class>\n" +#~ "\n" +#~ "</hibernate-mapping>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<union-subclass\n" +#~ " name=\"ClassName\"\n" +#~ " table=\"tablename\"\n" +#~ " proxy=\"ProxyInterface\"\n" +#~ " lazy=\"true|false\"\n" +#~ " dynamic-update=\"true|false\"\n" +#~ " dynamic-insert=\"true|false\"\n" +#~ " schema=\"schema\"\n" +#~ " catalog=\"catalog\"\n" +#~ " extends=\"SuperclassName\"\n" +#~ " abstract=\"true|false\"\n" +#~ " persister=\"ClassName\"\n" +#~ " subselect=\"SQL expression\"\n" +#~ " entity-name=\"EntityName\"\n" +#~ " node=\"element-name\">\n" +#~ "\n" +#~ " <property .... />\n" +#~ " .....\n" +#~ "</union-subclass>]]>" +#~ msgstr "" +#~ "<union-subclass\n" +#~ " name=\"ClassName\"\n" +#~ " table=\"tablename\"\n" +#~ " proxy=\"ProxyInterface\"\n" +#~ " lazy=\"true|false\"\n" +#~ " dynamic-update=\"true|false\"\n" +#~ " dynamic-insert=\"true|false\"\n" +#~ " schema=\"schema\"\n" +#~ " catalog=\"catalog\"\n" +#~ " extends=\"SuperclassName\"\n" +#~ " abstract=\"true|false\"\n" +#~ " persister=\"ClassName\"\n" +#~ " subselect=\"SQL expression\"\n" +#~ " entity-name=\"EntityName\"\n" +#~ " node=\"element-name\">\n" +#~ "\n" +#~ " <property .... />\n" +#~ " .....\n" +#~ "</union-subclass>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<join\n" +#~ " table=\"tablename\"\n" +#~ " schema=\"owner\"\n" +#~ " catalog=\"catalog\"\n" +#~ " fetch=\"join|select\"\n" +#~ " inverse=\"true|false\"\n" +#~ " optional=\"true|false\">\n" +#~ "\n" +#~ " <key ... />\n" +#~ "\n" +#~ " <property ... />\n" +#~ " ...\n" +#~ "</join>]]>" +#~ msgstr "" +#~ "<join\n" +#~ " table=\"tablename\"\n" +#~ " schema=\"owner\"\n" +#~ " catalog=\"catalog\"\n" +#~ " fetch=\"join|select\"\n" +#~ " inverse=\"true|false\"\n" +#~ " optional=\"true|false\">\n" +#~ " \n" +#~ " <key ... />\n" +#~ " \n" +#~ " <property ... />\n" +#~ " ...\n" +#~ "</join>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Person\"\n" +#~ " table=\"PERSON\">\n" +#~ "\n" +#~ " <id name=\"id\" column=\"PERSON_ID\">...</id>\n" +#~ "\n" +#~ " <join table=\"ADDRESS\">\n" +#~ " <key column=\"ADDRESS_ID\"/>\n" +#~ " <property name=\"address\"/>\n" +#~ " <property name=\"zip\"/>\n" +#~ " <property name=\"country\"/>\n" +#~ " </join>\n" +#~ " ...]]>" +#~ msgstr "" +#~ "<class name=\"Person\"\n" +#~ " table=\"PERSON\">\n" +#~ "\n" +#~ " <id name=\"id\" column=\"PERSON_ID\">...</id>\n" +#~ "\n" +#~ " <join table=\"ADDRESS\">\n" +#~ " <key column=\"ADDRESS_ID\"/>\n" +#~ " <property name=\"address\"/>\n" +#~ " <property name=\"zip\"/>\n" +#~ " <property name=\"country\"/>\n" +#~ " </join>\n" +#~ " ..." + +#, fuzzy +#~ msgid "<title>Key</title>" +#~ msgstr "<title>key</title>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<key\n" +#~ " column=\"columnname\"\n" +#~ " on-delete=\"noaction|cascade\"\n" +#~ " property-ref=\"propertyName\"\n" +#~ " not-null=\"true|false\"\n" +#~ " update=\"true|false\"\n" +#~ " unique=\"true|false\"\n" +#~ "/>]]>" +#~ msgstr "" +#~ "<key\n" +#~ " column=\"columnname\"\n" +#~ " on-delete=\"noaction|cascade\"\n" +#~ " property-ref=\"propertyName\"\n" +#~ " not-null=\"true|false\"\n" +#~ " update=\"true|false\"\n" +#~ " unique=\"true|false\"\n" +#~ "/>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<column\n" +#~ " name=\"column_name\"\n" +#~ " length=\"N\"\n" +#~ " precision=\"N\"\n" +#~ " scale=\"N\"\n" +#~ " not-null=\"true|false\"\n" +#~ " unique=\"true|false\"\n" +#~ " unique-key=\"multicolumn_unique_key_name\"\n" +#~ " index=\"index_name\"\n" +#~ " sql-type=\"sql_type_name\"\n" +#~ " check=\"SQL expression\"\n" +#~ " default=\"SQL expression\"/>]]>" +#~ msgstr "" +#~ "<column\n" +#~ " name=\"column_name\"\n" +#~ " length=\"N\"\n" +#~ " precision=\"N\"\n" +#~ " scale=\"N\"\n" +#~ " not-null=\"true|false\"\n" +#~ " unique=\"true|false\"\n" +#~ " unique-key=\"multicolumn_unique_key_name\"\n" +#~ " index=\"index_name\"\n" +#~ " sql-type=\"sql_type_name\"\n" +#~ " check=\"SQL expression\"\n" +#~ " default=\"SQL expression\"/>" + +#, fuzzy +#~ msgid "<![CDATA[<formula>SQL expression</formula>]]>" +#~ msgstr "<formula>SQL expression</formula>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<many-to-one name=\"homeAddress\" class=\"Address\"\n" +#~ " insert=\"false\" update=\"false\">\n" +#~ " <column name=\"person_id\" not-null=\"true\" length=\"10\"/>\n" +#~ " <formula>'MAILING'</formula>\n" +#~ "</many-to-one>]]>" +#~ msgstr "" +#~ "<many-to-one name=\"homeAddress\" class=\"Address\"\n" +#~ " insert=\"false\" update=\"false\">\n" +#~ " <column name=\"person_id\" not-null=\"true\" length=\"10\"/>\n" +#~ " <formula>'MAILING'</formula>\n" +#~ "</many-to-one>" + +#, fuzzy +#~ msgid "<![CDATA[<import class=\"java.lang.Object\" rename=\"Universe\"/>]]>" +#~ msgstr "<import class=\"java.lang.Object\" rename=\"Universe\"/>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<import\n" +#~ " class=\"ClassName\"\n" +#~ " rename=\"ShortName\"\n" +#~ "/>]]>" +#~ msgstr "" +#~ "<import\n" +#~ " class=\"ClassName\"\n" +#~ " rename=\"ShortName\"\n" +#~ "/>" + +#, fuzzy +#~ msgid "<title>Any</title>" +#~ msgstr "<title>any</title>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<any name=\"being\" id-type=\"long\" meta-type=\"string\">\n" +#~ " <meta-value value=\"TBL_ANIMAL\" class=\"Animal\"/>\n" +#~ " <meta-value value=\"TBL_HUMAN\" class=\"Human\"/>\n" +#~ " <meta-value value=\"TBL_ALIEN\" class=\"Alien\"/>\n" +#~ " <column name=\"table_name\"/>\n" +#~ " <column name=\"id\"/>\n" +#~ "</any>]]>" +#~ msgstr "" +#~ "<any name=\"being\" id-type=\"long\" meta-type=\"string\">\n" +#~ " <meta-value value=\"TBL_ANIMAL\" class=\"Animal\"/>\n" +#~ " <meta-value value=\"TBL_HUMAN\" class=\"Human\"/>\n" +#~ " <meta-value value=\"TBL_ALIEN\" class=\"Alien\"/>\n" +#~ " <column name=\"table_name\"/>\n" +#~ " <column name=\"id\"/>\n" +#~ "</any>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<any\n" +#~ " name=\"propertyName\"\n" +#~ " id-type=\"idtypename\"\n" +#~ " meta-type=\"metatypename\"\n" +#~ " cascade=\"cascade_style\"\n" +#~ " access=\"field|property|ClassName\"\n" +#~ " optimistic-lock=\"true|false\"\n" +#~ ">\n" +#~ " <meta-value ... />\n" +#~ " <meta-value ... />\n" +#~ " .....\n" +#~ " <column .... />\n" +#~ " <column .... />\n" +#~ " .....\n" +#~ "</any>]]>" +#~ msgstr "" +#~ "<any\n" +#~ " name=\"propertyName\"\n" +#~ " id-type=\"idtypename\"\n" +#~ " meta-type=\"metatypename\"\n" +#~ " cascade=\"cascade_style\"\n" +#~ " access=\"field|property|ClassName\"\n" +#~ " optimistic-lock=\"true|false\"\n" +#~ ">\n" +#~ " <meta-value ... />\n" +#~ " <meta-value ... />\n" +#~ " .....\n" +#~ " <column .... />\n" +#~ " <column .... />\n" +#~ " .....\n" +#~ "</any>" + +#~ msgid "string" +#~ msgstr "string" + +#, fuzzy +#~ msgid "class" +#~ msgstr "subclass" + +#~ msgid "binary" +#~ msgstr "binary" + +#~ msgid "text" +#~ msgstr "text" + +#~ msgid "serializable" +#~ msgstr "serializable" + +#~ msgid "clob, blob" +#~ msgstr "clob, blob" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<property name=\"twoStrings\" type=\"org.hibernate.test." +#~ "DoubleStringType\">\n" +#~ " <column name=\"first_string\"/>\n" +#~ " <column name=\"second_string\"/>\n" +#~ "</property>]]>" +#~ msgstr "" +#~ "<property name=\"twoStrings\" type=\"org.hibernate.test." +#~ "DoubleStringType\">\n" +#~ " <column name=\"first_string\"/>\n" +#~ " <column name=\"second_string\"/>\n" +#~ "</property>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<property name=\"priority\">\n" +#~ " <type name=\"com.mycompany.usertypes.DefaultValueIntegerType\">\n" +#~ " <param name=\"default\">0</param>\n" +#~ " </type>\n" +#~ "</property>]]>" +#~ msgstr "" +#~ "<property name=\"priority\">\n" +#~ " <type name=\"com.mycompany.usertypes.DefaultValueIntegerType" +#~ "\">\n" +#~ " <param name=\"default\">0</param>\n" +#~ " </type>\n" +#~ "</property>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<typedef class=\"com.mycompany.usertypes.DefaultValueIntegerType" +#~ "\" name=\"default_zero\">\n" +#~ " <param name=\"default\">0</param>\n" +#~ "</typedef>]]>" +#~ msgstr "" +#~ "<typedef class=\"com.mycompany.usertypes.DefaultValueIntegerType\" " +#~ "name=\"default_zero\">\n" +#~ " <param name=\"default\">0</param>\n" +#~ "</typedef>" + +#, fuzzy +#~ msgid "<![CDATA[<property name=\"priority\" type=\"default_zero\"/>]]>" +#~ msgstr "<property name=\"priority\" type=\"default_zero\"/>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Contract\" table=\"Contracts\"\n" +#~ " entity-name=\"CurrentContract\">\n" +#~ " ...\n" +#~ " <set name=\"history\" inverse=\"true\"\n" +#~ " order-by=\"effectiveEndDate desc\">\n" +#~ " <key column=\"currentContractId\"/>\n" +#~ " <one-to-many entity-name=\"HistoricalContract\"/>\n" +#~ " </set>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Contract\" table=\"ContractHistory\"\n" +#~ " entity-name=\"HistoricalContract\">\n" +#~ " ...\n" +#~ " <many-to-one name=\"currentContract\"\n" +#~ " column=\"currentContractId\"\n" +#~ " entity-name=\"CurrentContract\"/>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Contract\" table=\"Contracts\" \n" +#~ " entity-name=\"CurrentContract\">\n" +#~ " ...\n" +#~ " <set name=\"history\" inverse=\"true\" \n" +#~ " order-by=\"effectiveEndDate desc\">\n" +#~ " <key column=\"currentContractId\"/>\n" +#~ " <one-to-many entity-name=\"HistoricalContract\"/>\n" +#~ " </set>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Contract\" table=\"ContractHistory\" \n" +#~ " entity-name=\"HistoricalContract\">\n" +#~ " ...\n" +#~ " <many-to-one name=\"currentContract\" \n" +#~ " column=\"currentContractId\" \n" +#~ " entity-name=\"CurrentContract\"/>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"LineItem\" table=\"`Line Item`\">\n" +#~ " <id name=\"id\" column=\"`Item Id`\"/><generator class=\"assigned\"/" +#~ "></id>\n" +#~ " <property name=\"itemNumber\" column=\"`Item #`\"/>\n" +#~ " ...\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"LineItem\" table=\"`Line Item`\">\n" +#~ " <id name=\"id\" column=\"`Item Id`\"/><generator class=" +#~ "\"assigned\"/></id>\n" +#~ " <property name=\"itemNumber\" column=\"`Item #`\"/>\n" +#~ " ...\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[package eg;\n" +#~ "import java.util.Set;\n" +#~ "import java.util.Date;\n" +#~ "\n" +#~ "/**\n" +#~ " * @hibernate.class\n" +#~ " * table=\"CATS\"\n" +#~ " */\n" +#~ "public class Cat {\n" +#~ " private Long id; // identifier\n" +#~ " private Date birthdate;\n" +#~ " private Cat mother;\n" +#~ " private Set kittens\n" +#~ " private Color color;\n" +#~ " private char sex;\n" +#~ " private float weight;\n" +#~ "\n" +#~ " /*\n" +#~ " * @hibernate.id\n" +#~ " * generator-class=\"native\"\n" +#~ " * column=\"CAT_ID\"\n" +#~ " */\n" +#~ " public Long getId() {\n" +#~ " return id;\n" +#~ " }\n" +#~ " private void setId(Long id) {\n" +#~ " this.id=id;\n" +#~ " }\n" +#~ "\n" +#~ " /**\n" +#~ " * @hibernate.many-to-one\n" +#~ " * column=\"PARENT_ID\"\n" +#~ " */\n" +#~ " public Cat getMother() {\n" +#~ " return mother;\n" +#~ " }\n" +#~ " void setMother(Cat mother) {\n" +#~ " this.mother = mother;\n" +#~ " }\n" +#~ "\n" +#~ " /**\n" +#~ " * @hibernate.property\n" +#~ " * column=\"BIRTH_DATE\"\n" +#~ " */\n" +#~ " public Date getBirthdate() {\n" +#~ " return birthdate;\n" +#~ " }\n" +#~ " void setBirthdate(Date date) {\n" +#~ " birthdate = date;\n" +#~ " }\n" +#~ " /**\n" +#~ " * @hibernate.property\n" +#~ " * column=\"WEIGHT\"\n" +#~ " */\n" +#~ " public float getWeight() {\n" +#~ " return weight;\n" +#~ " }\n" +#~ " void setWeight(float weight) {\n" +#~ " this.weight = weight;\n" +#~ " }\n" +#~ "\n" +#~ " /**\n" +#~ " * @hibernate.property\n" +#~ " * column=\"COLOR\"\n" +#~ " * not-null=\"true\"\n" +#~ " */\n" +#~ " public Color getColor() {\n" +#~ " return color;\n" +#~ " }\n" +#~ " void setColor(Color color) {\n" +#~ " this.color = color;\n" +#~ " }\n" +#~ " /**\n" +#~ " * @hibernate.set\n" +#~ " * inverse=\"true\"\n" +#~ " * order-by=\"BIRTH_DATE\"\n" +#~ " * @hibernate.collection-key\n" +#~ " * column=\"PARENT_ID\"\n" +#~ " * @hibernate.collection-one-to-many\n" +#~ " */\n" +#~ " public Set getKittens() {\n" +#~ " return kittens;\n" +#~ " }\n" +#~ " void setKittens(Set kittens) {\n" +#~ " this.kittens = kittens;\n" +#~ " }\n" +#~ " // addKitten not needed by Hibernate\n" +#~ " public void addKitten(Cat kitten) {\n" +#~ " kittens.add(kitten);\n" +#~ " }\n" +#~ "\n" +#~ " /**\n" +#~ " * @hibernate.property\n" +#~ " * column=\"SEX\"\n" +#~ " * not-null=\"true\"\n" +#~ " * update=\"false\"\n" +#~ " */\n" +#~ " public char getSex() {\n" +#~ " return sex;\n" +#~ " }\n" +#~ " void setSex(char sex) {\n" +#~ " this.sex=sex;\n" +#~ " }\n" +#~ "}]]>" +#~ msgstr "" +#~ "package eg;\n" +#~ "import java.util.Set;\n" +#~ "import java.util.Date;\n" +#~ "\n" +#~ "/**\n" +#~ " * @hibernate.class\n" +#~ " * table=\"CATS\"\n" +#~ " */\n" +#~ "public class Cat {\n" +#~ " private Long id; // identifier\n" +#~ " private Date birthdate;\n" +#~ " private Cat mother;\n" +#~ " private Set kittens\n" +#~ " private Color color;\n" +#~ " private char sex;\n" +#~ " private float weight;\n" +#~ "\n" +#~ " /*\n" +#~ " * @hibernate.id\n" +#~ " * generator-class=\"native\"\n" +#~ " * column=\"CAT_ID\"\n" +#~ " */\n" +#~ " public Long getId() {\n" +#~ " return id;\n" +#~ " }\n" +#~ " private void setId(Long id) {\n" +#~ " this.id=id;\n" +#~ " }\n" +#~ "\n" +#~ " /**\n" +#~ " * @hibernate.many-to-one\n" +#~ " * column=\"PARENT_ID\"\n" +#~ " */\n" +#~ " public Cat getMother() {\n" +#~ " return mother;\n" +#~ " }\n" +#~ " void setMother(Cat mother) {\n" +#~ " this.mother = mother;\n" +#~ " }\n" +#~ "\n" +#~ " /**\n" +#~ " * @hibernate.property\n" +#~ " * column=\"BIRTH_DATE\"\n" +#~ " */\n" +#~ " public Date getBirthdate() {\n" +#~ " return birthdate;\n" +#~ " }\n" +#~ " void setBirthdate(Date date) {\n" +#~ " birthdate = date;\n" +#~ " }\n" +#~ " /**\n" +#~ " * @hibernate.property\n" +#~ " * column=\"WEIGHT\"\n" +#~ " */\n" +#~ " public float getWeight() {\n" +#~ " return weight;\n" +#~ " }\n" +#~ " void setWeight(float weight) {\n" +#~ " this.weight = weight;\n" +#~ " }\n" +#~ "\n" +#~ " /**\n" +#~ " * @hibernate.property\n" +#~ " * column=\"COLOR\"\n" +#~ " * not-null=\"true\"\n" +#~ " */\n" +#~ " public Color getColor() {\n" +#~ " return color;\n" +#~ " }\n" +#~ " void setColor(Color color) {\n" +#~ " this.color = color;\n" +#~ " }\n" +#~ " /**\n" +#~ " * @hibernate.set\n" +#~ " * inverse=\"true\"\n" +#~ " * order-by=\"BIRTH_DATE\"\n" +#~ " * @hibernate.collection-key\n" +#~ " * column=\"PARENT_ID\"\n" +#~ " * @hibernate.collection-one-to-many\n" +#~ " */\n" +#~ " public Set getKittens() {\n" +#~ " return kittens;\n" +#~ " }\n" +#~ " void setKittens(Set kittens) {\n" +#~ " this.kittens = kittens;\n" +#~ " }\n" +#~ " // addKitten not needed by Hibernate\n" +#~ " public void addKitten(Cat kitten) {\n" +#~ " kittens.add(kitten);\n" +#~ " }\n" +#~ "\n" +#~ " /**\n" +#~ " * @hibernate.property\n" +#~ " * column=\"SEX\"\n" +#~ " * not-null=\"true\"\n" +#~ " * update=\"false\"\n" +#~ " */\n" +#~ " public char getSex() {\n" +#~ " return sex;\n" +#~ " }\n" +#~ " void setSex(char sex) {\n" +#~ " this.sex=sex;\n" +#~ " }\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[@Entity(access = AccessType.FIELD)\n" +#~ "public class Customer implements Serializable {\n" +#~ "\n" +#~ " @Id;\n" +#~ " Long id;\n" +#~ "\n" +#~ " String firstName;\n" +#~ " String lastName;\n" +#~ " Date birthday;\n" +#~ "\n" +#~ " @Transient\n" +#~ " Integer age;\n" +#~ "\n" +#~ " @Embedded\n" +#~ " private Address homeAddress;\n" +#~ "\n" +#~ " @OneToMany(cascade=CascadeType.ALL)\n" +#~ " @JoinColumn(name=\"CUSTOMER_ID\")\n" +#~ " Set<Order> orders;\n" +#~ "\n" +#~ " // Getter/setter and business methods\n" +#~ "}]]>" +#~ msgstr "" +#~ "@Entity(access = AccessType.FIELD)\n" +#~ "public class Customer implements Serializable {\n" +#~ "\n" +#~ " @Id;\n" +#~ " Long id;\n" +#~ "\n" +#~ " String firstName;\n" +#~ " String lastName;\n" +#~ " Date birthday;\n" +#~ "\n" +#~ " @Transient\n" +#~ " Integer age;\n" +#~ "\n" +#~ " @Embedded\n" +#~ " private Address homeAddress;\n" +#~ "\n" +#~ " @OneToMany(cascade=CascadeType.ALL)\n" +#~ " @JoinColumn(name=\"CUSTOMER_ID\")\n" +#~ " Set<Order> orders;\n" +#~ "\n" +#~ " // Getter/setter and business methods\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<hibernate-mapping>\n" +#~ " ...\n" +#~ " <database-object>\n" +#~ " <create>CREATE TRIGGER my_trigger ...</create>\n" +#~ " <drop>DROP TRIGGER my_trigger</drop>\n" +#~ " </database-object>\n" +#~ "</hibernate-mapping>]]>" +#~ msgstr "" +#~ "<hibernate-mapping>\n" +#~ " ...\n" +#~ " <database-object>\n" +#~ " <create>CREATE TRIGGER my_trigger ...</create>\n" +#~ " <drop>DROP TRIGGER my_trigger</drop>\n" +#~ " </database-object>\n" +#~ "</hibernate-mapping>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<hibernate-mapping>\n" +#~ " ...\n" +#~ " <database-object>\n" +#~ " <definition class=\"MyTriggerDefinition\"/>\n" +#~ " </database-object>\n" +#~ "</hibernate-mapping>]]>" +#~ msgstr "" +#~ "<hibernate-mapping>\n" +#~ " ...\n" +#~ " <database-object>\n" +#~ " <definition class=\"MyTriggerDefinition\"/>\n" +#~ " </database-object>\n" +#~ "</hibernate-mapping>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<hibernate-mapping>\n" +#~ " ...\n" +#~ " <database-object>\n" +#~ " <definition class=\"MyTriggerDefinition\"/>\n" +#~ " <dialect-scope name=\"org.hibernate.dialect.Oracle9iDialect\"/>\n" +#~ " <dialect-scope name=\"org.hibernate.dialect.Oracle10gDialect\"/>\n" +#~ " </database-object>\n" +#~ "</hibernate-mapping>]]>" +#~ msgstr "" +#~ "<hibernate-mapping>\n" +#~ " ...\n" +#~ " <database-object>\n" +#~ " <definition class=\"MyTriggerDefinition\"/>\n" +#~ " <dialect-scope name=\"org.hibernate.dialect.Oracle9Dialect\"/" +#~ ">\n" +#~ " <dialect-scope name=\"org.hibernate.dialect.OracleDialect\"/" +#~ ">\n" +#~ " </database-object>\n" +#~ "</hibernate-mapping>" Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/batch.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/batch.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/batch.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,984 @@ +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# Language /mnt/hgfs/base/Hibernate/Reference translations for PACKAGE package. +# Copyright (C) 2006, 2007 Free Software Foundation, Inc. +# Automatically generated, 2006. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# +msgid "" +msgstr "" +"Project-Id-Version: Collection_Mapping\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2010-01-08T04:07:18\n" +"PO-Revision-Date: 2007-02-26 10:27+1000\n" +"Last-Translator: \n" +"Language-Team: <de(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.9.1\n" + +#. Tag: title +#, no-c-format +msgid "Batch processing" +msgstr "Batch-Verarbeitung" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A naive approach to inserting 100,000 rows in the database using Hibernate " +"might look like this:" +msgstr "" +"Eine unkomplizierte Einfügung von 100.000 Reihen in die Datenbank mittels " +"Hibernate könnte wie folgt aussehen:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This would fall over with an <literal>OutOfMemoryException</literal> " +"somewhere around the 50,000th row. That is because Hibernate caches all the " +"newly inserted <literal>Customer</literal> instances in the session-level " +"cache. In this chapter we will show you how to avoid this problem." +msgstr "" +"Dies würde mit der Ausnahme <literal>OutOfMemoryException</literal> irgendwo " +"um die 50.000ste Reihe herum kippen, da Hibernate alle neu eingefügten " +"<literal>Customer</literal>-Instanzen im Cache der Session-Ebene speichert." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If you are undertaking batch processing you will need to enable the use of " +"JDBC batching. This is absolutely essential if you want to achieve optimal " +"performance. Set the JDBC batch size to a reasonable number (10-50, for " +"example):" +msgstr "" +"In diesem Kapitel wollen wir Ihnen zeigen, wie dieses Problem vermieden " +"werden kann. Zunächst jedoch muss bei der Verwendung von Batch-Verarbeitung " +"(auch: Stapelverarbeitung) die Einstellung \"JDBC-Batching\" aktiviert sein, " +"falls eine zufriedenstellende Leistung erzielt werden soll. Die Größe des " +"JDBC-Batch (m.a.W. die Stapelgröße) sollte dabei sinnvoll gewählt sein (z.B. " +"10-50):" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate disables insert batching at the JDBC level transparently if you " +"use an <literal>identity</literal> identifier generator." +msgstr "" +"Bitte beachten Sie, dass Hibernate das Einfügungs-Batching auf JDBC-Ebene " +"transparent deaktiviert, falls Sie einen <literal>identiy</literal> " +"Bezeichner-Generator verwenden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can also do this kind of work in a process where interaction with the " +"second-level cache is completely disabled:" +msgstr "" +"Sie können diesen Vorgang auch durchführen, wenn das Cache der zweiten Ebene " +"vollständig deaktiviert ist:" + +#. Tag: para +#, no-c-format +msgid "" +"However, this is not absolutely necessary, since we can explicitly set the " +"<literal>CacheMode</literal> to disable interaction with the second-level " +"cache." +msgstr "" +"Dies ist jedoch nicht unbedingt erforderlich, da der <literal>CacheMode</" +"literal> so eingestellt werden kann, dass die Interaktion mit dem Cache der " +"zweiten Ebene deaktiviert ist." + +#. Tag: title +#, no-c-format +msgid "Batch inserts" +msgstr "Batch-Einfügungen (\"Batch-Inserts\")" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"When making new objects persistent <literal>flush()</literal> and then " +"<literal>clear()</literal> the session regularly in order to control the " +"size of the first-level cache." +msgstr "" +"Werden neue Objekte persistent gemacht, so muss in der Session regelmäßig " +"<literal>flush()</literal> und anschließend <literal>clear()</literal> " +"erfolgen, um die Größe des Caches der ersten Ebene zu kontrollieren." + +#. Tag: title +#, no-c-format +msgid "Batch updates" +msgstr "Batch-Aktualisierungen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"For retrieving and updating data, the same ideas apply. In addition, you " +"need to use <literal>scroll()</literal> to take advantage of server-side " +"cursors for queries that return many rows of data." +msgstr "" +"Beim Abruf und der Aktualisierung von Daten gilt dasselbe. Desweiteren " +"müssen Sie hier <literal>scroll()</literal> verwenden, um für Anfragen, die " +"mit zahlreichen Datenreihen reagieren, die Vorteile des Cursors auf " +"Serverseite auszunutzen." + +#. Tag: title +#, no-c-format +msgid "The StatelessSession interface" +msgstr "Das Interface der StatelessSession" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Alternatively, Hibernate provides a command-oriented API that can be used " +"for streaming data to and from the database in the form of detached objects. " +"A <literal>StatelessSession</literal> has no persistence context associated " +"with it and does not provide many of the higher-level life cycle semantics. " +"In particular, a stateless session does not implement a first-level cache " +"nor interact with any second-level or query cache. It does not implement " +"transactional write-behind or automatic dirty checking. Operations performed " +"using a stateless session never cascade to associated instances. Collections " +"are ignored by a stateless session. Operations performed via a stateless " +"session bypass Hibernate's event model and interceptors. Due to the lack of " +"a first-level cache, Stateless sessions are vulnerable to data aliasing " +"effects. A stateless session is a lower-level abstraction that is much " +"closer to the underlying JDBC." +msgstr "" +"Alternativ bietet Hibernate ein befehlsorientiertes API, das in Form von " +"abgesetzten Objekten für das Streaming von Daten von und zur Datenbank " +"verwendet werden kann. Eine <literal>StatelessSession</literal> verfügt " +"nicht über einen mit ihr assozierten Persistenzkontext und bietet nicht viel " +"von der Lebenszyklus-Semantik der höheren Ebene. Insbesondere implementiert " +"eine \"stateless Session\" weder ein Cache auf erster Ebene noch interagiert " +"sie mit irgendeinem Anfragen-Cache oder Cache der zweiten Ebene. Es werden " +"weder transaktionales Hinterher-Speichern noch automatisches \"Dirty-Checking" +"\" (auf vorherigen Zugriff) implementiert. Vorgänge, die unter Verwendung " +"einer stateless Session erfolgen, werden nie an zugehörige Instanzen " +"weitergeleitet. Collections werden von einer stateless Session ebenfalls " +"übergangen. Vorgänge, die unter Verwendung einer stateless Session erfolgen, " +"umgehen außerdem Hibernates Ereignismodell und Interzeptoren. Es kann in " +"stateless Sessions außerdem zu Datenverfälschungen (sog. \"Data Aliasing\") " +"kommen, da ein Cache auf erster Ebene fehlt. Eine stateless Session ist eine " +"Abstraktion auf niedrigerer Ebene, wesentlich näher an der zu Grunde " +"liegenden JDBC." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"In this code example, the <literal>Customer</literal> instances returned by " +"the query are immediately detached. They are never associated with any " +"persistence context." +msgstr "" +"Bitte beachten Sie, dass in diesem Code-Beispiel die durch die Anfrage " +"erstellten <literal>Customer</literal>-Instanzen sofort abgesetzt werden. " +"Sie werden zu keinem Zeitpunkt mit einem Persistenzkontext assoziiert." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>insert(), update()</literal> and <literal>delete()</literal> " +"operations defined by the <literal>StatelessSession</literal> interface are " +"considered to be direct database row-level operations. They result in the " +"immediate execution of a SQL <literal>INSERT, UPDATE</literal> or " +"<literal>DELETE</literal> respectively. They have different semantics to the " +"<literal>save(), saveOrUpdate()</literal> and <literal>delete()</literal> " +"operations defined by the <literal>Session</literal> interface." +msgstr "" +"Die vom <literal>StatelessSession</literal>-Interface definierten " +"<literal>insert(), update()</literal> und <literal>delete()</literal> " +"Vorgänge werden als direkte Datenbankvorgänge auf Reihenebene angesehen, die " +"eine sofortige Ausführung einer SQL <literal>INSERT, UPDATE</literal> bzw. " +"<literal>DELETE</literal> mit sich bringen. Sie besitzen daher eine andere " +"Semantik als <literal>save(), saveOrUpdate()</literal> und <literal>delete()" +"</literal>-Vorgänge, die durch das <literal>Session</literal>-Interface " +"definiert werden." + +#. Tag: title +#, no-c-format +msgid "DML-style operations" +msgstr "Vorgänge im DML-Stil" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"As already discussed, automatic and transparent object/relational mapping is " +"concerned with the management of the object state. The object state is " +"available in memory. This means that manipulating data directly in the " +"database (using the SQL <literal>Data Manipulation Language</literal> (DML) " +"the statements: <literal>INSERT</literal>, <literal>UPDATE</literal>, " +"<literal>DELETE</literal>) will not affect in-memory state. However, " +"Hibernate provides methods for bulk SQL-style DML statement execution that " +"is performed through the Hibernate Query Language (<xref linkend=\"queryhql" +"\" />)." +msgstr "" +"Wie bereits erläutert, hängt das automatische und transparente " +"objektrelationale Mapping mit dem Management des Objektstatus zusammen. Das " +"bedeutet, dass der Objektstatus im Speicher verfügbar ist, weswegen (unter " +"Verwendung der SQL <literal>Data Manipulation Language</literal> (DML) " +"Anweisungen: <literal>INSERT</literal>, <literal>UPDATE</literal>, " +"<literal>DELETE</literal>) Daten direkt in der Datenbank den gespeicherten " +"Status nicht manipulieren.Hibernate bietet jedoch Methoden für die " +"Massenausführung von DML-Anweisungen im SQL-Stil, was durch die Hibernate " +"Query Language (<xref linkend=\"queryhql\"/>) erfolgt." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The pseudo-syntax for <literal>UPDATE</literal> and <literal>DELETE</" +"literal> statements is: <literal>( UPDATE | DELETE ) FROM? EntityName (WHERE " +"where_conditions)?</literal>." +msgstr "" +"Die Pseudo-Syntax für <literal>UPDATE</literal> und <literal>DELETE</" +"literal>-Anweisungen lautet: <literal>( UPDATE | DELETE ) FROM? EntityName " +"(WHERE where_conditions)?</literal>. Hierzu einige wichtige Punkte:" + +#. Tag: para +#, no-c-format +msgid "Some points to note:" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "In the from-clause, the FROM keyword is optional" +msgstr "In der \"from\"-Klausel, ist der \"FROM\"-Schlüsselbegriff optional" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"There can only be a single entity named in the from-clause. It can, however, " +"be aliased. If the entity name is aliased, then any property references must " +"be qualified using that alias. If the entity name is not aliased, then it is " +"illegal for any property references to be qualified." +msgstr "" +"In der \"from\"-Klausel kann nur eine einzelne Entity genannt werden; sie " +"kann optional auch einen Alias-Namen tragen. Falls der Name der Entity ein " +"Alias ist, müssen sämtliche Property-Verweise unter Verwendung dieses Alias " +"qualifiziert sein. Ist dies nicht der Fall, so ist es unzulässig Property-" +"Verweise zu qualifizieren." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"No <xref linkend=\"queryhql-joins-forms\" />, either implicit or explicit, " +"can be specified in a bulk HQL query. Sub-queries can be used in the where-" +"clause, where the subqueries themselves may contain joins." +msgstr "" +"Kein <xref linkend=\"queryhql-joins-forms\"/> (weder implizit noch explizit) " +"kann in einer Massen-HQL-Anfrage spezifiziert werden. Unteranfragen (sog. " +"\"Subqueries\") können in der \"where\"-Klausel verwendet werden; die " +"Unteranfragen selbst können Verbünde (sog. \"Joins\") enthalten." + +#. Tag: para +#, no-c-format +msgid "The where-clause is also optional." +msgstr "Die \"where\"-Klausel ist ebenfalls optional." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"As an example, to execute an HQL <literal>UPDATE</literal>, use the " +"<literal>Query.executeUpdate()</literal> method. The method is named for " +"those familiar with JDBC's <literal>PreparedStatement.executeUpdate()</" +"literal>:" +msgstr "" +"Um zum Beispiel HQL <literal>UPDATE</literal> auszuführen, verwenden Sie die " +"<literal>Query.executeUpdate()</literal>-Methode (die Methode wird für " +"diejenigen genannt, die mit JDBCs <literal>PreparedStatement.executeUpdate()" +"</literal>) vertraut sind:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"In keeping with the EJB3 specification, HQL <literal>UPDATE</literal> " +"statements, by default, do not effect the version (<xref linkend=\"mapping-" +"declaration-version\" />) or the timestamp (<xref linkend=\"mapping-" +"declaration-timestamp\" />) property values for the affected entities. " +"However, you can force Hibernate to reset the <literal>version</literal> or " +"<literal>timestamp</literal> property values through the use of a " +"<literal>versioned update</literal>. This is achieved by adding the " +"<literal>VERSIONED</literal> keyword after the <literal>UPDATE</literal> " +"keyword." +msgstr "" +"HQL <literal>UPDATE</literal>-Anweisungen haben standardmäßig keinen " +"Einfluss auf die <xref linkend=\"mapping-declaration-version\"/>-Version " +"oder die <xref linkend=\"mapping-declaration-timestamp\"/>-Zeitstempel-" +"Property-Werte der betreffenden Entities; dies erfolgt in Übereinstimmung " +"mit der EJB3-Spezifikation. Sie können Hibernate jedoch zwingen, die " +"<literal>version</literal> oder <literal>timestamp</literal> Property-Werte " +"ordnungsgemäß zurückzusetzen, indem Sie ein <literal>versioned update</" +"literal> verwenden. Dies geschieht durch Hinzufügen des <literal>VERSIONED</" +"literal>-Schlüsselbegriffs hinter dem <literal>UPDATE</literal>-" +"Schlüsselbegriff." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Custom version types, <literal>org.hibernate.usertype.UserVersionType</" +"literal>, are not allowed in conjunction with a <literal>update versioned</" +"literal> statement." +msgstr "" +"Bitte beachten Sie, dass angepasste Versionstypen (<literal>org.hibernate." +"usertype.UserVersionType</literal>) nicht in Verbindung mit einer " +"<literal>update versioned</literal>-Anweisung erlaubt sind." + +#. Tag: para +#, no-c-format +msgid "" +"To execute an HQL <literal>DELETE</literal>, use the same <literal>Query." +"executeUpdate()</literal> method:" +msgstr "" +"Um HQL <literal>DELETE</literal>auszuführen, verwenden Sie dieselbe " +"<literal>Query.executeUpdate()</literal>-Methode:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>int</literal> value returned by the <literal>Query.executeUpdate" +"()</literal> method indicates the number of entities effected by the " +"operation. This may or may not correlate to the number of rows effected in " +"the database. An HQL bulk operation might result in multiple actual SQL " +"statements being executed (for joined-subclass, for example). The returned " +"number indicates the number of actual entities affected by the statement. " +"Going back to the example of joined-subclass, a delete against one of the " +"subclasses may actually result in deletes against not just the table to " +"which that subclass is mapped, but also the \"root\" table and potentially " +"joined-subclass tables further down the inheritance hierarchy." +msgstr "" +"Der durch die <literal>Query.executeUpdate()</literal>-Methode erhaltene " +"<literal>int</literal>-Wert gibt die Anzahl der durch den Vorgang " +"betroffenen Entities an. Beachten Sie, dass dies mit der Anzahl der " +"betroffenen Datenbankreihen korrelieren kann oder auch nicht. Ein HQL-" +"Massenvorgang kann in der Ausführung mehrerer tatsächlicher SQL-Anweisungen " +"resultieren, etwa für verbundene Subklassen. Die erhaltene Zahl gibt die " +"Anzahl tatsächlicher Entities an, die von der Anweisung betroffen sind. Um " +"auf das Beispiel der verbundenen Subklassen zurückzukommen - eine der " +"Subklassen betreffende Löschung kann zu Löschungen nicht nur der Tabelle, zu " +"der diese Subklasse gemappt ist, sondern auch zur \"Root\"-Tabelle und " +"möglicherweise verbundenen Subklassentabellen führen, die in der " +"Vererbungshierarchie weiter unten angesiedelt sind." + +#. Tag: para +#, no-c-format +msgid "" +"The pseudo-syntax for <literal>INSERT</literal> statements is: " +"<literal>INSERT INTO EntityName properties_list select_statement</literal>. " +"Some points to note:" +msgstr "" +"Die Pseudo-Syntax für <literal>INSERT</literal>-Anweisungen lautet: " +"<literal>INSERT INTO EntityName properties_list select_statement</literal>. " +"Hierzu einige wichtige Punkte:" + +#. Tag: para +#, no-c-format +msgid "" +"Only the INSERT INTO ... SELECT ... form is supported; not the INSERT " +"INTO ... VALUES ... form." +msgstr "" +"Nur INSERT INTO ... SELECT ... wird unterstützt, nicht jedoch INSERT " +"INTO ... VALUES ...." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The properties_list is analogous to the <literal>column specification</" +"literal> in the SQL <literal>INSERT</literal> statement. For entities " +"involved in mapped inheritance, only properties directly defined on that " +"given class-level can be used in the properties_list. Superclass properties " +"are not allowed and subclass properties do not make sense. In other words, " +"<literal>INSERT</literal> statements are inherently non-polymorphic." +msgstr "" +"Die properties_list ist analog zur <literal>column speficiation</literal> in " +"der SQL <literal>INSERT</literal>-Anweisung. Für in gemappte Vererbung " +"involvierte Entities können nur Properties verwendet werden, die direkt auf " +"dieser bestimmten Klassenebene in der properties_list definiert sind. " +"Superklassen-Properties sind nicht gestattet und Subklassen-Properties " +"machen keinen Sinn. Mit anderen Worten <literal>INSERT</literal>-Anweisungen " +"sind inhärent nicht-polymorph." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"select_statement can be any valid HQL select query, with the caveat that the " +"return types must match the types expected by the insert. Currently, this is " +"checked during query compilation rather than allowing the check to relegate " +"to the database. This might, however, cause problems between Hibernate " +"<literal>Type</literal>s which are <emphasis>equivalent</emphasis> as " +"opposed to <emphasis>equal</emphasis>. This might cause issues with " +"mismatches between a property defined as a <literal>org.hibernate.type." +"DateType</literal> and a property defined as a <literal>org.hibernate.type." +"TimestampType</literal>, even though the database might not make a " +"distinction or might be able to handle the conversion." +msgstr "" +"Ein select_statement kann jede gültige HQL-Auswahlanfrage sein, mit dem " +"Vorbehalt, dass Rückmeldungstypen mit den durch die Einfügung erwarteten " +"Typen übereinstimmen müssen. Derzeit wird dies während der " +"Anfragenkompilierung statt beim Rückverweis auf die Datenbank geprüft. Bitte " +"beachten Sie, dass dies zu Problemen zwischen Hibernate <literal>Type</" +"literal>en, die <emphasis>äquivalent</emphasis> und nicht <emphasis>gleich</" +"emphasis> sind, führen kann. Es kann dadurch zu Fehlzuordnungen zwischen " +"einer als <literal>org.hibernate.type.DateType</literal> definierten " +"Property und einer als <literal>org.hibernate.type.TimestampType</literal> " +"definierten Property kommen, selbst wenn die Datenbank keine Unterscheidung " +"macht oder die Konversion durchführen könnte." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"For the id property, the insert statement gives you two options. You can " +"either explicitly specify the id property in the properties_list, in which " +"case its value is taken from the corresponding select expression, or omit it " +"from the properties_list, in which case a generated value is used. This " +"latter option is only available when using id generators that operate in the " +"database; attempting to use this option with any \"in memory\" type " +"generators will cause an exception during parsing. For the purposes of this " +"discussion, in-database generators are considered to be <literal>org." +"hibernate.id.SequenceGenerator</literal> (and its subclasses) and any " +"implementers of <literal>org.hibernate.id.PostInsertIdentifierGenerator</" +"literal>. The most notable exception here is <literal>org.hibernate.id." +"TableHiLoGenerator</literal>, which cannot be used because it does not " +"expose a selectable way to get its values." +msgstr "" +"Bei der id-Property bietet die Einfügungsanweisung zwei Möglichkeiten. Sie " +"können die Property entweder explizit in der properties_list festlegen (in " +"diesem Fall wird deren Wert vom zugehörigen Auswahlausdruck genommen) oder " +"sie aus von der properties_list löschen (in diesem Fall wird ein generierter " +"Wert verwendet). Diese letztere Option ist nur verfügbar, wenn innerhalb der " +"Datenbank operierende id-Generatoren verwendet werden. Der Versuch diese " +"Option mit jeglichen \"in memory\"-Typen zu verwenden führt während des " +"Parsens zu einer Ausnahmemeldung. Bitte beachten Sie, dass in diesem " +"Zusammenhang Generatoren innerhalb der Datenbank als <literal>org.hibernate." +"id.SequenceGenerator</literal> (und dessen Subklassen) sowie jegliche " +"Implementierungen von <literal>org.hibernate.id." +"PostInsertIdentifierGenerator</literal> angesehen werden. Die wohl " +"wichtigste Ausnahme ist hier <literal>org.hibernate.id.TableHiLoGenerator</" +"literal>, der nicht gewählt werden kann, da er keine wählbare Weise bietet, " +"um an seine Werte zu gelangen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"For properties mapped as either <literal>version</literal> or " +"<literal>timestamp</literal>, the insert statement gives you two options. " +"You can either specify the property in the properties_list, in which case " +"its value is taken from the corresponding select expressions, or omit it " +"from the properties_list, in which case the <literal>seed value</literal> " +"defined by the <literal>org.hibernate.type.VersionType</literal> is used." +msgstr "" +"Für entweder als <literal>version</literal> oder <literal>timestamp</" +"literal> gemappte Properties bietet die Einfügungsanweisung zwei Optionen. " +"Sie können die Property entweder explizit in der properties_list festlegen " +"(in diesem Fall wird deren Wert vom zugehörigen Auswahlausdruck genommen) " +"oder sie aus von der properties_list löschen (in diesem Fall wird der durch " +"<literal>org.hibernate.type.VersionType</literal> definierte <literal>seed " +"value</literal> verwendet)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The following is an example of an HQL <literal>INSERT</literal> statement " +"execution:" +msgstr "" +"Ein Beispiel für die Ausführung einer HQL <literal>INSERT</literal>-" +"Anweisung:" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Session session = sessionFactory.openSession();\n" +#~ "Transaction tx = session.beginTransaction();\n" +#~ "for ( int i=0; i<100000; i++ ) {\n" +#~ " Customer customer = new Customer(.....);\n" +#~ " session.save(customer);\n" +#~ "}\n" +#~ "tx.commit();\n" +#~ "session.close();]]>" +#~ msgstr "" +#~ "Session session = sessionFactory.openSession();\n" +#~ "Transaction tx = session.beginTransaction();\n" +#~ "for ( int i=0; i<100000; i++ ) {\n" +#~ " Customer customer = new Customer(.....);\n" +#~ " session.save(customer);\n" +#~ "}\n" +#~ "tx.commit();\n" +#~ "session.close();" + +#, fuzzy +#~ msgid "<![CDATA[hibernate.jdbc.batch_size 20]]>" +#~ msgstr "hibernate.jdbc.batch_size 20" + +#, fuzzy +#~ msgid "<![CDATA[hibernate.cache.use_second_level_cache false]]>" +#~ msgstr "hibernate.cache.use_second_level_cache false" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Session session = sessionFactory.openSession();\n" +#~ "Transaction tx = session.beginTransaction();\n" +#~ " \n" +#~ "for ( int i=0; i<100000; i++ ) {\n" +#~ " Customer customer = new Customer(.....);\n" +#~ " session.save(customer);\n" +#~ " if ( i % 20 == 0 ) { //20, same as the JDBC batch size\n" +#~ " //flush a batch of inserts and release memory:\n" +#~ " session.flush();\n" +#~ " session.clear();\n" +#~ " }\n" +#~ "}\n" +#~ " \n" +#~ "tx.commit();\n" +#~ "session.close();]]>" +#~ msgstr "" +#~ "Session session = sessionFactory.openSession();\n" +#~ "Transaction tx = session.beginTransaction();\n" +#~ " \n" +#~ "for ( int i=0; i<100000; i++ ) {\n" +#~ " Customer customer = new Customer(.....);\n" +#~ " session.save(customer);\n" +#~ " if ( i % 20 == 0 ) { //20, same as the JDBC batch size\n" +#~ " //flush a batch of inserts and release memory:\n" +#~ " session.flush();\n" +#~ " session.clear();\n" +#~ " }\n" +#~ "}\n" +#~ " \n" +#~ "tx.commit();\n" +#~ "session.close();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Session session = sessionFactory.openSession();\n" +#~ "Transaction tx = session.beginTransaction();\n" +#~ " \n" +#~ "ScrollableResults customers = session.getNamedQuery(\"GetCustomers\")\n" +#~ " .setCacheMode(CacheMode.IGNORE)\n" +#~ " .scroll(ScrollMode.FORWARD_ONLY);\n" +#~ "int count=0;\n" +#~ "while ( customers.next() ) {\n" +#~ " Customer customer = (Customer) customers.get(0);\n" +#~ " customer.updateStuff(...);\n" +#~ " if ( ++count % 20 == 0 ) {\n" +#~ " //flush a batch of updates and release memory:\n" +#~ " session.flush();\n" +#~ " session.clear();\n" +#~ " }\n" +#~ "}\n" +#~ " \n" +#~ "tx.commit();\n" +#~ "session.close();]]>" +#~ msgstr "" +#~ "Session session = sessionFactory.openSession();\n" +#~ "Transaction tx = session.beginTransaction();\n" +#~ " \n" +#~ "ScrollableResults customers = session.getNamedQuery(\"GetCustomers\")\n" +#~ " .setCacheMode(CacheMode.IGNORE)\n" +#~ " .scroll(ScrollMode.FORWARD_ONLY);\n" +#~ "int count=0;\n" +#~ "while ( customers.next() ) {\n" +#~ " Customer customer = (Customer) customers.get(0);\n" +#~ " customer.updateStuff(...);\n" +#~ " if ( ++count % 20 == 0 ) {\n" +#~ " //flush a batch of updates and release memory:\n" +#~ " session.flush();\n" +#~ " session.clear();\n" +#~ " }\n" +#~ "}\n" +#~ " \n" +#~ "tx.commit();\n" +#~ "session.close();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[StatelessSession session = sessionFactory.openStatelessSession" +#~ "();\n" +#~ "Transaction tx = session.beginTransaction();\n" +#~ " \n" +#~ "ScrollableResults customers = session.getNamedQuery(\"GetCustomers\")\n" +#~ " .scroll(ScrollMode.FORWARD_ONLY);\n" +#~ "while ( customers.next() ) {\n" +#~ " Customer customer = (Customer) customers.get(0);\n" +#~ " customer.updateStuff(...);\n" +#~ " session.update(customer);\n" +#~ "}\n" +#~ " \n" +#~ "tx.commit();\n" +#~ "session.close();]]>" +#~ msgstr "" +#~ "StatelessSession session = sessionFactory.openStatelessSession();\n" +#~ "Transaction tx = session.beginTransaction();\n" +#~ " \n" +#~ "ScrollableResults customers = session.getNamedQuery(\"GetCustomers\")\n" +#~ " .scroll(ScrollMode.FORWARD_ONLY);\n" +#~ "while ( customers.next() ) {\n" +#~ " Customer customer = (Customer) customers.get(0);\n" +#~ " customer.updateStuff(...);\n" +#~ " session.update(customer);\n" +#~ "}\n" +#~ " \n" +#~ "tx.commit();\n" +#~ "session.close();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Session session = sessionFactory.openSession();\n" +#~ "Transaction tx = session.beginTransaction();\n" +#~ "\n" +#~ "String hqlUpdate = \"update Customer c set c.name = :newName where c.name " +#~ "= :oldName\";\n" +#~ "// or String hqlUpdate = \"update Customer set name = :newName where name " +#~ "= :oldName\";\n" +#~ "int updatedEntities = s.createQuery( hqlUpdate )\n" +#~ " .setString( \"newName\", newName )\n" +#~ " .setString( \"oldName\", oldName )\n" +#~ " .executeUpdate();\n" +#~ "tx.commit();\n" +#~ "session.close();]]>" +#~ msgstr "" +#~ "Session session = sessionFactory.openSession();\n" +#~ "Transaction tx = session.beginTransaction();\n" +#~ "\n" +#~ "String hqlUpdate = \"update Customer c set c.name = :newName where c.name " +#~ "= :oldName\";\n" +#~ "// or String hqlUpdate = \"update Customer set name = :newName where name " +#~ "= :oldName\";\n" +#~ "int updatedEntities = s.createQuery( hqlUpdate )\n" +#~ " .setString( \"newName\", newName )\n" +#~ " .setString( \"oldName\", oldName )\n" +#~ " .executeUpdate();\n" +#~ "tx.commit();\n" +#~ "session.close();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Session session = sessionFactory.openSession();\n" +#~ "Transaction tx = session.beginTransaction();\n" +#~ "String hqlVersionedUpdate = \"update versioned Customer set name = :" +#~ "newName where name = :oldName\";\n" +#~ "int updatedEntities = s.createQuery( hqlUpdate )\n" +#~ " .setString( \"newName\", newName )\n" +#~ " .setString( \"oldName\", oldName )\n" +#~ " .executeUpdate();\n" +#~ "tx.commit();\n" +#~ "session.close();]]>" +#~ msgstr "" +#~ "Session session = sessionFactory.openSession();\n" +#~ "Transaction tx = session.beginTransaction();\n" +#~ "String hqlVersionedUpdate = \"update versioned Customer set name = :" +#~ "newName where name = :oldName\";\n" +#~ "int updatedEntities = s.createQuery( hqlUpdate )\n" +#~ " .setString( \"newName\", newName )\n" +#~ " .setString( \"oldName\", oldName )\n" +#~ " .executeUpdate();\n" +#~ "tx.commit();\n" +#~ "session.close();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Session session = sessionFactory.openSession();\n" +#~ "Transaction tx = session.beginTransaction();\n" +#~ "\n" +#~ "String hqlDelete = \"delete Customer c where c.name = :oldName\";\n" +#~ "// or String hqlDelete = \"delete Customer where name = :oldName\";\n" +#~ "int deletedEntities = s.createQuery( hqlDelete )\n" +#~ " .setString( \"oldName\", oldName )\n" +#~ " .executeUpdate();\n" +#~ "tx.commit();\n" +#~ "session.close();]]>" +#~ msgstr "" +#~ "Session session = sessionFactory.openSession();\n" +#~ "Transaction tx = session.beginTransaction();\n" +#~ "\n" +#~ "String hqlDelete = \"delete Customer c where c.name = :oldName\";\n" +#~ "// or String hqlDelete = \"delete Customer where name = :oldName\";\n" +#~ "int deletedEntities = s.createQuery( hqlDelete )\n" +#~ " .setString( \"oldName\", oldName )\n" +#~ " .executeUpdate();\n" +#~ "tx.commit();\n" +#~ "session.close();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Session session = sessionFactory.openSession();\n" +#~ "Transaction tx = session.beginTransaction();\n" +#~ "\n" +#~ "String hqlInsert = \"insert into DelinquentAccount (id, name) select c." +#~ "id, c.name from Customer c where ...\";\n" +#~ "int createdEntities = s.createQuery( hqlInsert )\n" +#~ " .executeUpdate();\n" +#~ "tx.commit();\n" +#~ "session.close();]]>" +#~ msgstr "" +#~ "Session session = sessionFactory.openSession();\n" +#~ "Transaction tx = session.beginTransaction();\n" +#~ "\n" +#~ "String hqlInsert = \"insert into DelinquentAccount (id, name) select c." +#~ "id, c.name from Customer \n" +#~ " c where ...\";\n" +#~ "int createdEntities = s.createQuery( hqlInsert )\n" +#~ " .executeUpdate();\n" +#~ "tx.commit();\n" +#~ "session.close();" Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/best_practices.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/best_practices.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/best_practices.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,707 @@ +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# Language /mnt/hgfs/base/Hibernate/Reference translations for PACKAGE package. +# Copyright (C) 2006, 2007 Free Software Foundation, Inc. +# Automatically generated, 2006. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# +msgid "" +msgstr "" +"Project-Id-Version: Collection_Mapping\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2009-12-03T00:15:26\n" +"PO-Revision-Date: 2007-02-26 10:27+1000\n" +"Last-Translator: \n" +"Language-Team: <de(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.9.1\n" + +#. Tag: title +#, no-c-format +msgid "Best Practices" +msgstr "Optimale Verfahren" + +#. Tag: term +#, fuzzy, no-c-format +msgid "" +"Write fine-grained classes and map them using <literal><component></" +"literal>:" +msgstr "" +"Schreiben Sie feinstufige Klassen, und Mappen Sie diese mittels <literal><" +"component></literal>." + +#. Tag: para +#, no-c-format +msgid "" +"Use an <literal>Address</literal> class to encapsulate <literal>street</" +"literal>, <literal>suburb</literal>, <literal>state</literal>, " +"<literal>postcode</literal>. This encourages code reuse and simplifies " +"refactoring." +msgstr "" +"Verwenden Sie eine <literal>Address</literal>-Klasse, um <literal>street</" +"literal>, <literal>suburb</literal>, <literal>state</literal>, " +"<literal>postcode</literal> einzukapseln. Das unterstützt die " +"Wiederverwendung des Code und vereinfacht die Erhöhung der " +"Bedienerfreundlichkeit." + +#. Tag: term +#, fuzzy, no-c-format +msgid "Declare identifier properties on persistent classes:" +msgstr "Deklarieren Sie Bezeichner-Properties an persistenten Klassen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate makes identifier properties optional. There are a range of reasons " +"why you should use them. We recommend that identifiers be 'synthetic', that " +"is, generated with no business meaning." +msgstr "" +"Hibernate macht Bezeichner-Properties optional. Es gibt eine Reihe von " +"Gründen, warum Sie diese verwenden sollten. Wir empfehlen \"synthetische\" " +"Bezeichner (generiert, mit keiner Unternehmensbedeutung)." + +#. Tag: term +#, fuzzy, no-c-format +msgid "Identify natural keys:" +msgstr "Identifizierung natürlicher Schlüssel." + +#. Tag: para +#, no-c-format +msgid "" +"Identify natural keys for all entities, and map them using <literal><" +"natural-id></literal>. Implement <literal>equals()</literal> and " +"<literal>hashCode()</literal> to compare the properties that make up the " +"natural key." +msgstr "" +"Bestimmen Sie natürliche Schlüssel für alle Entities, und mappen Sie diese " +"mittels <literal><natural-id></literal>. Implementieren Sie " +"<literal>equals()</literal> und <literal>hashCode()</literal>, um die " +"Properties, aus denen der natürliche Schlüssel besteht, zu vergleichen." + +#. Tag: term +#, fuzzy, no-c-format +msgid "Place each class mapping in its own file:" +msgstr "Platzieren Sie jedes Klassen-Mapping in dessen eigener Datei." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Do not use a single monolithic mapping document. Map <literal>com.eg.Foo</" +"literal> in the file <literal>com/eg/Foo.hbm.xml</literal>. This makes " +"sense, particularly in a team environment." +msgstr "" +"Verwenden Sie kein einzelnes, monolithisches Mapping-Dokument. Mappen Sie " +"<literal>com.eg.Foo</literal> in der Datei <literal>com/eg/Foo.hbm.xml</" +"literal>. Das ist insbesondere in einer Team-Umgebung sinnvoll." + +#. Tag: term +#, fuzzy, no-c-format +msgid "Load mappings as resources:" +msgstr "Laden Sie die Mappings als Ressourcen." + +#. Tag: para +#, no-c-format +msgid "Deploy the mappings along with the classes they map." +msgstr "Deployen Sie die Mappings gemeinsam mit den Klassen, die sie mappen." + +#. Tag: term +#, fuzzy, no-c-format +msgid "Consider externalizing query strings:" +msgstr "Ziehen Sie die Externalisierung von Anfragenstrings in Erwägung." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This is recommended if your queries call non-ANSI-standard SQL functions. " +"Externalizing the query strings to mapping files will make the application " +"more portable." +msgstr "" +"Das ist eine gute Vorgehensweise, wenn Ihre Anfragen nicht-ANSI-Standard SQL " +"Funktionen aufrufen. Die Externalisierung der Anfragenstrings zu Mapping-" +"Dateien macht die Anwendung übertragbarer." + +#. Tag: term +#, no-c-format +msgid "Use bind variables." +msgstr "Verwenden Sie \"bind\"-Variablen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"As in JDBC, always replace non-constant values by \"?\". Do not use string " +"manipulation to bind a non-constant value in a query. You should also " +"consider using named parameters in queries." +msgstr "" +"Wie in JDBC ersetzen Sie nicht konstante Werte immer durch \"?\". Verwenden " +"Sie nie String-Manipulation, um einen nicht konstanten Wert in einer Anfrage " +"zu binden! Viel besser ist es, benannte Parameter in Anfragen zu benutzen." + +#. Tag: term +#, fuzzy, no-c-format +msgid "Do not manage your own JDBC connections:" +msgstr "Managen Sie nicht Ihre eigenen JDBC-Verbindungen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate allows the application to manage JDBC connections, but his " +"approach should be considered a last-resort. If you cannot use the built-in " +"connection providers, consider providing your own implementation of " +"<literal>org.hibernate.connection.ConnectionProvider</literal>." +msgstr "" +"Hibernate lässt die Anwendung die JDBC-Verbindungen verwalten. Diese " +"Vorgehensweise sollte als letzter Ausweg angesehen werden. Falls Sie die " +"eingebauten Verbindungs-Provider nicht benutzen können, sollten Sie Ihre " +"eigene Implementierung von <literal>org.hibernate.connection." +"ConnectionProvider</literal> in Erwägung ziehen." + +#. Tag: term +#, fuzzy, no-c-format +msgid "Consider using a custom type:" +msgstr "Verwenden Sie einen angepassten Typ." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Suppose you have a Java type from a library that needs to be persisted but " +"does not provide the accessors needed to map it as a component. You should " +"consider implementing <literal>org.hibernate.UserType</literal>. This " +"approach frees the application code from implementing transformations to/" +"from a Hibernate type." +msgstr "" +"Nehmen wir an Sie haben einen Java-Typ, etwa aus irgendeiner Bibliothek, der " +"persistiert werden muss aber keine Zugänge bietet, die notwendig sind, um " +"ihn als Komponente zu mappen. Sie sollten die Implementierung von " +"<literal>org.hibernate.UserType</literal> in Betracht ziehen. Diese " +"Vorgehensweise befreit den Anwendungscode von der Implementierung von " +"Transformationen zu / von einem Hibernate-Typ." + +#. Tag: term +#, fuzzy, no-c-format +msgid "Use hand-coded JDBC in bottlenecks:" +msgstr "Verwenden Sie handkodiertes JDBC in Engpässen (\"Bottlenecks\")." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"In performance-critical areas of the system, some kinds of operations might " +"benefit from direct JDBC. Do not assume, however, that JDBC is necessarily " +"faster. Please wait until you <emphasis>know</emphasis> something is a " +"bottleneck. If you need to use direct JDBC, you can open a Hibernate " +"<literal>Session</literal> and usingfile:///usr/share/doc/HTML/en-US/index." +"html that JDBC connection. This way you can still use the same transaction " +"strategy and underlying connection provider." +msgstr "" +"In Teilen des Systems, bei denen die Performance besonders wichtig ist, " +"profitieren einige Vorgänge von der direkten JDBC. Aber bitte, warten Sie " +"bis Sie <emphasis>wissen</emphasis>, dass es sich um einen Engpass handelt. " +"Und gehen Sie nicht davon aus, dass direkte JDBC unbedingt schneller ist. " +"Falls Sie direkte JDBC verwenden müssen, kann es sinnvoll sein, eine " +"Hibernate <literal>Session</literal> zu öffnen und diese JDBC-Verbindung zu " +"benutzen. Auf diese Weise können Sie nach wie vor diesselbe " +"Transaktionsstrategie und den zu Grunde liegenden Verbindungsprovider " +"verwenden." + +#. Tag: term +#, fuzzy, no-c-format +msgid "Understand <literal>Session</literal> flushing:" +msgstr "Die <literal>Session</literal>-Räumung verstehen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Sometimes the Session synchronizes its persistent state with the database. " +"Performance will be affected if this process occurs too often. You can " +"sometimes minimize unnecessary flushing by disabling automatic flushing, or " +"even by changing the order of queries and other operations within a " +"particular transaction." +msgstr "" +"Von Zeit zu Zeit synchronisiert die Session ihren persistenten Status mit " +"der Datenbank. Findet dies zu oft statt, so wird die Performance " +"beeinträchtigt. Manchmal können durch Deaktivierung der automatischen " +"Räumung (sog. \"Flushing\") oder sogar durch Änderung der " +"Anfragenreihenfolge und anderer Vorgänge innerhalb einer bestimmten " +"Transaktion unnötige Räumungen minimiert werden." + +#. Tag: term +#, fuzzy, no-c-format +msgid "In a three tiered architecture, consider using detached objects:" +msgstr "" +"Bei einer Drei-Schichten-Architektur (sog. \"three-tiered-architecture\") " +"empfiehlt sich die Verwendung abgesetzter Objekte." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"When using a servlet/session bean architecture, you can pass persistent " +"objects loaded in the session bean to and from the servlet/JSP layer. Use a " +"new session to service each request. Use <literal>Session.merge()</literal> " +"or <literal>Session.saveOrUpdate()</literal> to synchronize objects with the " +"database." +msgstr "" +"Bei Verwendung einer Servlet-/Session-Bean-Architektur können Sie im Session-" +"Bean geladene persistente Objekte in die und aus der Servlet-/JSP-Schicht " +"weitergeben. Verwenden Sie eine neue Session, um jede Anfrage zu warten. " +"Verwenden Sie <literal>Session.merge()</literal> oder <literal>Session." +"saveOrUpdate()</literal> zur Synchronisation von Objekten mit der Datenbank." + +#. Tag: term +#, fuzzy, no-c-format +msgid "In a two tiered architecture, consider using long persistence contexts:" +msgstr "" +"In einer Zwei-Schichten-Architektur (sog. \"two tiered architecture\") " +"empfiehlt sich die Verwendung von langen Persistenz-Kontexten." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Database Transactions have to be as short as possible for best scalability. " +"However, it is often necessary to implement long running " +"<emphasis>application transactions</emphasis>, a single unit-of-work from " +"the point of view of a user. An application transaction might span several " +"client request/response cycles. It is common to use detached objects to " +"implement application transactions. An appropriate alternative in a two " +"tiered architecture, is to maintain a single open persistence contact " +"session for the whole life cycle of the application transaction. Then simply " +"disconnect from the JDBC connection at the end of each request and reconnect " +"at the beginning of the subsequent request. Never share a single session " +"across more than one application transaction or you will be working with " +"stale data." +msgstr "" +"Für die beste Skalierbarkeit sollten Datenbanktransaktionen so kurz wie " +"möglich sein. Allerdings ist es oft notwendig, lang laufende " +"<emphasis>Anwendungstransaktionen</emphasis> zu implementieren, aus " +"Benutzersicht eine einzelne Arbeitseinheit. Eine Anwendungstransaktion kann " +"mehrere Client Anfragen-/Antwortenzyklen umfassen. Es ist üblich, abgesetzte " +"Objekte zur Implemetierung von Anwendungstransaktionen zu verwenden. Eine " +"insbesondere für die Zwei-Schichten-Architektur passende Alternative ist die " +"Instandhaltung eines einzelnen offenen Persistenzkontakts (Session) während " +"des gesamten Lebenszyklus der Anwendungstransaktion. Am Ende jeder Anfrage " +"wird die JDBC-Verbindung dann unterbrochen und zu Beginn der darauf " +"folgenden Anfrage erneut aufgestellt. Eine einzelne Session sollte nie über " +"mehr als eine Anwendungstransaktion hinweg geteilt werden, da Sie sonst mit " +"veralteten Daten arbeiten." + +#. Tag: term +#, fuzzy, no-c-format +msgid "Do not treat exceptions as recoverable:" +msgstr "Behandeln Sie Ausnahmen nicht als wiederherstellbar." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This is more of a necessary practice than a \"best\" practice. When an " +"exception occurs, roll back the <literal>Transaction</literal> and close the " +"<literal>Session</literal>. If you do not do this, Hibernate cannot " +"guarantee that in-memory state accurately represents the persistent state. " +"For example, do not use <literal>Session.load()</literal> to determine if an " +"instance with the given identifier exists on the database; use " +"<literal>Session.get()</literal> or a query instead." +msgstr "" +"Dies ist eher eine notwendige Vorgehensweise als das \"beste\" Verfahren. " +"Wird eine Ausnahme gemeldet, führen Sie einen Rollback der " +"<literal>Transaction</literal> durch und schließen Sie die <literal>Session</" +"literal>. Falls Sie dies nicht tun, kann Hibernate nicht garantieren, dass " +"der gespeicherte Status tatsächlich den persistenten Status repräsentiert. " +"Als Sonderfall hierbei verwenden Sie nicht <literal>Session.load()</literal> " +"um zu bestimmen, ob eine Instanz des gegebenen Bezeichners in der Datenbank " +"existiert, verwenden Sie statt dessen <literal>Session.get()</literal> oder " +"eine Anfrage." + +#. Tag: term +#, fuzzy, no-c-format +msgid "Prefer lazy fetching for associations:" +msgstr "\"Lazy Fetching\" für Assoziationen ist vorzuziehen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Use eager fetching sparingly. Use proxies and lazy collections for most " +"associations to classes that are not likely to be completely held in the " +"second-level cache. For associations to cached classes, where there is an a " +"extremely high probability of a cache hit, explicitly disable eager fetching " +"using <literal>lazy=\"false\"</literal>. When join fetching is appropriate " +"to a particular use case, use a query with a <literal>left join fetch</" +"literal>." +msgstr "" +"Verwenden Sie \"eager Fetching\" sparsam. Verwenden Sie Proxies und \"lazy " +"Collections\" für die meisten Assoziationen zu Klassen, die aller " +"Wahrscheinlichkeit nach eher nicht vollständig im Cache der zweiten Ebene " +"aufbewahrt werden. Für Assoziationen zu gecachten Klassen, bei denen eine " +"sehr hohe Wahrscheinlichkeit eines Cache-Treffers besteht, deaktivieren Sie " +"\"eager Fetching\" explizit mittels <literal>lazy=\"false\"</literal>. Wenn " +"ein \"Join-Fetching\" (Verbundabruf) in einem bestimmten Fall passend ist, " +"verwenden Sie eine Anfrage mit einem <literal>left join fetch</literal>." + +#. Tag: term +#, fuzzy, no-c-format +msgid "" +"Use the <emphasis>open session in view</emphasis> pattern, or a disciplined " +"<emphasis>assembly phase</emphasis> to avoid problems with unfetched data:" +msgstr "" +"Verwenden Sie das <emphasis>offene Session in Ansicht</emphasis>-Muster oder " +"eine <emphasis>Assembly Phase</emphasis>, um Probleme mit nicht abgerufenen " +"Daten zu vermeiden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate frees the developer from writing tedious <emphasis>Data Transfer " +"Objects</emphasis> (DTO). In a traditional EJB architecture, DTOs serve dual " +"purposes: first, they work around the problem that entity beans are not " +"serializable; second, they implicitly define an assembly phase where all " +"data to be used by the view is fetched and marshalled into the DTOs before " +"returning control to the presentation tier. Hibernate eliminates the first " +"purpose. Unless you are prepared to hold the persistence context (the " +"session) open across the view rendering process, you will still need an " +"assembly phase. Think of your business methods as having a strict contract " +"with the presentation tier about what data is available in the detached " +"objects. This is not a limitation of Hibernate. It is a fundamental " +"requirement of safe transactional data access." +msgstr "" +"Hibernate nimmt dem Entwickler das Schreiben langwieriger " +"<emphasis>Datentransferobjekte </emphasis> (DTO) ab. In einer herkömmlichen " +"EJB-Architektur dienen DTOs zwei Zwecken: Zunächst einmal umgehen sie das " +"Problem, dass Entity-Beans nicht serialisierbar sind, und zweitens " +"definieren sie implizit eine Programmumwandlungsphase wenn alle von der " +"Ansicht zu verwendenden Daten abgerufen und in die DTOs geleitet werden, ehe " +"die Steuerung zur Präsentationsschicht zurückkehrt. Hibernate eleminiert den " +"ersten Zweck. Sie benötigen jedoch nach wie vor eine " +"Programmumwandlungsphase (stellen Sie sich vor, dass Ihre " +"Unternehmensmethoden einen strengen Vertrag mit der Präsentationsschicht " +"bezüglich der in den abgesetzten Daten verfügbaren Daten besitzen), außer " +"Sie sind bereit den Persistenzkontext (die Session) während des gesamten " +"Renderingvorgangs der Ansicht geöffnet zu lassen. Es handelt sich hierbei " +"nicht um eine Einschränkung von Hibernate! Es handelt sich um eine " +"grundlegende Voraussetzung für den sicheren Zugriff auf transaktionale Daten." + +#. Tag: term +#, fuzzy, no-c-format +msgid "Consider abstracting your business logic from Hibernate:" +msgstr "" +"Ziehen Sie die Abstraktion Ihrer Business-Logik von Hibernate in Erwägung." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hide Hibernate data-access code behind an interface. Combine the " +"<emphasis>DAO</emphasis> and <emphasis>Thread Local Session</emphasis> " +"patterns. You can even have some classes persisted by handcoded JDBC " +"associated to Hibernate via a <literal>UserType</literal>. This advice is, " +"however, intended for \"sufficiently large\" applications. It is not " +"appropriate for an application with five tables." +msgstr "" +"Verbergen Sie den (Hibernate) Datenzugriffscode hinter einem Interface. " +"Verbinden Sie <emphasis>DAO</emphasis> und <emphasis>Thread Local Session</" +"emphasis>-Modell. Sie können sogar über einige mit handkodiertem JDBC " +"verfügen, die mittels eines <literal>UserType</literal> mit Hibernate " +"assoziiert sind. (Dieser Ratschlag gilt für \"ausreichend große\" " +"Anwendungen; er ist unpassend für eine Anwendung mit fünf Tabellen!)" + +#. Tag: term +#, fuzzy, no-c-format +msgid "Do not use exotic association mappings:" +msgstr "Verwenden Sie keine exotischen Assoziationsmappings." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Practical test cases for real many-to-many associations are rare. Most of " +"the time you need additional information stored in the \"link table\". In " +"this case, it is much better to use two one-to-many associations to an " +"intermediate link class. In fact, most associations are one-to-many and many-" +"to-one. For this reason, you should proceed cautiously when using any other " +"association style." +msgstr "" +"Gute Anwendungsfälle für echte \"Many-to-Many\"-Assoziationen sind selten. " +"In den meisten Fällen benötigen Sie zusätzliche Informationen, die in der " +"Verbindungstabelle (\"Link Table) gespeichert sind. In diesem Fall ist es " +"besser zwei \"One-to-Many\"-Assoziationen zu einer dazwischen liegenden Link-" +"Klasse zu verwenden. Genau genommen sind wir der Ansicht, dass die meisten " +"Assoziationen \"One-to-Many\" und \"Many-to-One\" sind, und Sie sollten " +"andere Assoziationsstile mit Vorsicht einsetzen und sich stets fragen, ob " +"diese tatsächlich unvermeidbar sind." + +#. Tag: term +#, fuzzy, no-c-format +msgid "Prefer bidirectional associations:" +msgstr "Geben Sie bidirektionalen Assoziationen den Vorzug." + +#. Tag: para +#, no-c-format +msgid "" +"Unidirectional associations are more difficult to query. In a large " +"application, almost all associations must be navigable in both directions in " +"queries." +msgstr "" +"Unidirektionale Assoziationen sind schwieriger abzufragen. In einer großen " +"Anwendung müssen fast alle Assoziationen bei Anfragen nach beiden Richtungen " +"navigierbar sein." Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/collection_mapping.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/collection_mapping.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/collection_mapping.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,2328 @@ +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# Language /mnt/hgfs/base/Hibernate/Reference translations for PACKAGE package. +# Copyright (C) 2006, 2007 Free Software Foundation, Inc. +# Automatically generated, 2006. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# +msgid "" +msgstr "" +"Project-Id-Version: Collection_Mapping\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2009-12-03T00:15:26\n" +"PO-Revision-Date: 2007-02-26 10:27+1000\n" +"Last-Translator: \n" +"Language-Team: <de(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.9.1\n" + +#. Tag: title +#, fuzzy, no-c-format +msgid "Collection mapping" +msgstr "Collection-Mappings" + +#. Tag: title +#, no-c-format +msgid "Persistent collections" +msgstr "Persistente Collections" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate requires that persistent collection-valued fields be declared as " +"an interface type. For example:" +msgstr "" +"In Hibernate müssen persistente Collection-wertige Felder als Interface-Typ " +"deklariert werden, zum Beispiel:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The actual interface might be <literal>java.util.Set</literal>, " +"<literal>java.util.Collection</literal>, <literal>java.util.List</literal>, " +"<literal>java.util.Map</literal>, <literal>java.util.SortedSet</literal>, " +"<literal>java.util.SortedMap</literal> or anything you like (\"anything you " +"like\" means you will have to write an implementation of <literal>org." +"hibernate.usertype.UserCollectionType</literal>.)" +msgstr "" +"Das tatsächliche Interface könnte <literal>java.util.Set</literal>, " +"<literal>java.util.Collection</literal>, <literal>java.util.List</literal>, " +"<literal>java.util.Map</literal>, <literal>java.util.SortedSet</literal>, " +"<literal>java.util.SortedMap</literal> oder ... was immer Sie möchten sein! " +"(Wobei \"was immer Sie möchten\" bedeutet, dass Sie eine Implementierung von " +"<literal>org.hibernate.usertype.UserCollectionType</literal> werden " +"schreiben müssen)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Notice how the instance variable was initialized with an instance of " +"<literal>HashSet</literal>. This is the best way to initialize collection " +"valued properties of newly instantiated (non-persistent) instances. When you " +"make the instance persistent, by calling <literal>persist()</literal> for " +"example, Hibernate will actually replace the <literal>HashSet</literal> with " +"an instance of Hibernate's own implementation of <literal>Set</literal>. Be " +"aware of the following errors:" +msgstr "" +"Beachten Sie, wie wir die Instanzvariable mit einer Instanz von " +"<literal>HashSet</literal> initialisiert haben. Dieses ist die beste Art, " +"neu initialisierte (nicht-persistente) Collection-wertige Properties zu " +"instanziieren. Wenn Sie - etwa durch Aufruf von <literal>persist()</literal> " +"- die Instanz persistent machen, so wird Hibernate das <literal>HashSet</" +"literal> durch eine Instanz seiner eigenen Implementierung von <literal>Set</" +"literal> ersetzen. Achten Sie auf mögliche Fehler wie den folgenden:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The persistent collections injected by Hibernate behave like " +"<literal>HashMap</literal>, <literal>HashSet</literal>, <literal>TreeMap</" +"literal>, <literal>TreeSet</literal> or <literal>ArrayList</literal>, " +"depending on the interface type." +msgstr "" +"Je nach Interface-Typ verhalten sich die von Hibernate eingespeisten " +"Collections wie <literal>HashMap</literal>, <literal>HashSet</literal>, " +"<literal>TreeMap</literal>, <literal>TreeSet</literal> oder " +"<literal>ArrayList</literal>." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Collections instances have the usual behavior of value types. They are " +"automatically persisted when referenced by a persistent object and are " +"automatically deleted when unreferenced. If a collection is passed from one " +"persistent object to another, its elements might be moved from one table to " +"another. Two entities cannot share a reference to the same collection " +"instance. Due to the underlying relational model, collection-valued " +"properties do not support null value semantics. Hibernate does not " +"distinguish between a null collection reference and an empty collection." +msgstr "" +"Instanzen von Collections folgen dem Verhalten von Wertetypen. Sie werden " +"automatisch persistent gemacht, wenn durch ein persistentes Objekt auf sie " +"verwiesen wird und gelöscht, wenn kein Verweis auf sie existiert. Falls eine " +"Collection von einem persistenten Objekt an ein anderes weitergegeben wird, " +"so ist es möglich, dass deren Elemente von einer Tabelle zu einer anderen " +"Tabelle verschoben werden. Zwei Entities können sich keinen Verweis zu " +"derselben Instanz einer Collection teilen. Wegen des zu Grunde liegenden " +"relationalen Modells unterstützen Collection-wertige Properties keine " +"Nullwert-Semantik. Hibernate unterscheidet nicht zwischen einem Null-" +"Collection-Verweis und einer leeren Collection." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Use persistent collections the same way you use ordinary Java collections. " +"However, please ensure you understand the semantics of bidirectional " +"associations (these are discussed later)." +msgstr "" +"Sie werden mit all dem jedoch meist wenig zu tun haben. Verwenden Sie " +"persistente Collections genau so, wie sie reguläre Java-Collections " +"verwenden würden. Stellen Sie aber sicher, dass Sie die Semantik " +"bidirektionaler Assoziationen verstehen (wir gehen später noch näher darauf " +"ein)." + +#. Tag: title +#, no-c-format +msgid "Collection mappings" +msgstr "Collection-Mappings" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"There are quite a range of mappings that can be generated for collections " +"that cover many common relational models. We suggest you experiment with the " +"schema generation tool so that you understand how various mapping " +"declarations translate to database tables." +msgstr "" +"Es gibt eine ganze Reihe von Mappings, die für Collections generiert werden " +"können und die zahlreiche gängige relationale Modelle abdecken. Es ist " +"wahrscheinlich sinnvoll, wenn Sie mit dem Tool zur Schemagenerierung " +"experimentieren, um zu sehen, wie die verschiedenen Mapping-Deklarationen " +"bei Datenbanktabellen umgesetzt werden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The Hibernate mapping element used for mapping a collection depends upon the " +"type of interface. For example, a <literal><set></literal> element is " +"used for mapping properties of type <literal>Set</literal>." +msgstr "" +"Das Hibernate Mapping-Element, das für das Mapping einer Collection " +"verwendet wird, hängt vom Typ des Interface ab. Zum Beispiel wird ein " +"<literal><set></literal>-Element für Mapping-Properties des Typs " +"<literal>Set</literal> verwendet." + +#. Tag: para +#, no-c-format +msgid "" +"Apart from <literal><set></literal>, there is also <literal><" +"list></literal>, <literal><map></literal>, <literal><bag></" +"literal>, <literal><array></literal> and <literal><primitive-" +"array></literal> mapping elements. The <literal><map></literal> " +"element is representative:" +msgstr "" +"Neben <literal><set></literal> gibt es auch <literal><list></" +"literal>, <literal><map></literal>, <literal><bag></literal>, " +"<literal><array></literal> und <literal><primitive-array></" +"literal> Mapping-Elemente. Das <literal><map></literal>-Element ist " +"charakteristisch:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>name</literal>: the collection property name" +msgstr "<literal>name</literal> der Property-Name der Collection" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>table</literal> (optional - defaults to property name): the name of " +"the collection table. It is not used for one-to-many associations." +msgstr "" +"<literal>table</literal> (optional - standardmäßig der Property-Name) der " +"Name der Collection-Tabelle (wird nicht für \"One-to-Many\"-Assoziationen " +"verwendet)" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>schema</literal> (optional): the name of a table schema to override " +"the schema declared on the root element" +msgstr "" +"<literal>schema</literal> (optional) der Name eines Tabellenschemas, der das " +"im Stammelement deklarierte Schema außer Kraft setzt" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>lazy</literal> (optional - defaults to <literal>true</literal>): " +"disables lazy fetching and specifies that the association is always eagerly " +"fetched. It can also be used to enable \"extra-lazy\" fetching where most " +"operations do not initialize the collection. This is suitable for large " +"collections." +msgstr "" +"<literal>lazy</literal> (optional - standardmäßig <literal>true</literal>) " +"kann verwendet werden, um das \"lazy Fetching\" (d.h. das Nachladen " +"assoziierter Objekte bei Bedarf) zu deaktivieren und zu bestimmen, dass auf " +"die Assoziation stets mittels \"eager Fetching\" (d.h. zusammengefasstem " +"Laden von Objekt und assoziierten Objekten mit Verbundoperationen) " +"zugegriffen wird. Ebenfalls zur Aktivierung von \"extra-lazy\" Fetching " +"verwendet, bei dem die meisten Vorgänge die Collection nicht initialisieren " +"(passend für sehr große Collections)" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>inverse</literal> (optional - defaults to <literal>false</" +"literal>): marks this collection as the \"inverse\" end of a bidirectional " +"association." +msgstr "" +"<literal>inverse</literal> (optional - standardmäßig <literal>false</" +"literal>) kennzeichnen Sie diese Collection als das \"invertierte\" Ende " +"einer biderektionalen Assoziation" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>cascade</literal> (optional - defaults to <literal>none</literal>): " +"enables operations to cascade to child entities." +msgstr "" +"<literal>cascade</literal> (optional - standardmäßig <literal>none</" +"literal>) aktiviert Vorgänge zur Weitergabe an untergeordnete Entities (sog. " +"\"child entities\")" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>sort</literal> (optional): specifies a sorted collection with " +"<literal>natural</literal> sort order or a given comparator class." +msgstr "" +"<literal>sort</literal> (optional) bestimmt eine sortierte Collection mit " +"<literal>natural</literal> Sortierordnung oder eine bestimmte Klasse von " +"Vergleichsprogramm" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>order-by</literal> (optional, JDK1.4 only): specifies a table " +"column or columns that define the iteration order of the <literal>Map</" +"literal>, <literal>Set</literal> or bag, together with an optional " +"<literal>asc</literal> or <literal>desc</literal>." +msgstr "" +"<literal>order-by</literal> (optional, nur JDK1.4) bestimmt eine (oder " +"mehrere) Tabellenspalte(n), die die Iterationsreihenfolge von <literal>Map</" +"literal>, <literal>Set</literal> oder \"Bag\" (d.h. Duplikate, Multimenge) " +"mit einem optionalen <literal>asc</literal> oder <literal>desc</literal> " +"definieren" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>where</literal> (optional): specifies an arbitrary SQL " +"<literal>WHERE</literal> condition that is used when retrieving or removing " +"the collection. This is useful if the collection needs to contain only a " +"subset of the available data." +msgstr "" +"<literal>where</literal> (optional) bestimmt eine arbiträre SQL " +"<literal>WHERE</literal>-Bedingung, die bei der Abfrage oder Entfernung der " +"Collection verwendet werden soll (besonders dann nützlich, wenn die " +"Collection nur einen Untersatz der verfügbaren Daten enthalten soll)" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>fetch</literal> (optional, defaults to <literal>select</literal>): " +"chooses between outer-join fetching, fetching by sequential select, and " +"fetching by sequential subselect." +msgstr "" +"<literal>fetch</literal> (optional, standardmäßig <literal>select</literal>) " +"Wählen Sie zwischen \"Outer-Join\"-Abruf (d.h. äußerem Verbund), Abruf nach " +"sequentieller Auswahl und Fetching nach sequentieller Unterauswahl." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>batch-size</literal> (optional, defaults to <literal>1</literal>): " +"specifies a \"batch size\" for lazily fetching instances of this collection." +msgstr "" +"<literal>batch-size</literal> (optional, standardmäßig <literal>1</literal>) " +"bestimmt eine \"Batch-Größe\" für das \"lazy Fetching\" von Instanzen dieser " +"Collection." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>access</literal> (optional - defaults to <literal>property</" +"literal>): the strategy Hibernate uses for accessing the collection property " +"value." +msgstr "" +"<literal>access</literal> (optional - standardmäßig <literal>property</" +"literal>): Die von Hibernate zu verwendende Strategie für den Zugriff auf " +"den Property-Wert der Collection." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>optimistic-lock</literal> (optional - defaults to <literal>true</" +"literal>): specifies that changes to the state of the collection results in " +"increments of the owning entity's version. For one-to-many associations you " +"may want to disable this setting." +msgstr "" +"<literal>optimistic-lock</literal> (optional - standardmäßig <literal>true</" +"literal>): Bestimmt die Statusänderungen der Collection-Ergebnisse in " +"Versionserhöhung der besitzenden Entity. (Bei \"One-to-Many\"-Assoziationen " +"ist es oftmals sinnvoll, diese Einstellung zu deaktivieren)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>mutable</literal> (optional - defaults to <literal>true</literal>): " +"a value of <literal>false</literal> specifies that the elements of the " +"collection never change. This allows for minor performance optimization in " +"some cases." +msgstr "" +"<literal>mutable</literal> (optional - standardmäßig <literal>true</" +"literal>): Ein Wert von <literal>false</literal> bestimmt, dass die Elemente " +"der Collection sich niemals ändern (in manchen Fällen eine leichte " +"Optimierung der Performance)." + +#. Tag: title +#, no-c-format +msgid "Collection foreign keys" +msgstr "Collection-Fremdschlüssel" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Collection instances are distinguished in the database by the foreign key of " +"the entity that owns the collection. This foreign key is referred to as the " +"<emphasis>collection key column</emphasis>, or columns, of the collection " +"table. The collection key column is mapped by the <literal><key></" +"literal> element." +msgstr "" +"Die Instanzen der Collection werden in der Datenbank durch den " +"Fremdschlüssel der Entity, zu der die Collection gehört, unterschieden. " +"Dieser Fremdschlüssel wird als <emphasis>Schlüsselspalte der Collection</" +"emphasis> (oder Spalten) der Collection-Tabelle bezeichnet. Die " +"Schlüsselspalte der Collection wird durch das <literal><key></literal>-" +"Element gemappt." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"There can be a nullability constraint on the foreign key column. For most " +"collections, this is implied. For unidirectional one-to-many associations, " +"the foreign key column is nullable by default, so you may need to specify " +"<literal>not-null=\"true\"</literal>." +msgstr "" +"Es ist möglich, dass eine \"Nullability\"-Bedingung an der Spalte des " +"Fremdschlüssels existiert. Für die meisten Collections wird dies " +"vorausgesetzt. Bei unidirektionalen \"One-to-Many\"-Assoziationen ist die " +"Spalte des Fremdschlüssels standardmäßig \"nullbar\", weswegen es möglich " +"ist, dass Sie <literal>not-null=\"true\"</literal> festlegen müssen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The foreign key constraint can use <literal>ON DELETE CASCADE</literal>." +msgstr "" +"Die Bedingung für den Fremdschlüssel kann <literal>ON DELETE CASCADE</" +"literal> verwenden." + +#. Tag: para +#, no-c-format +msgid "" +"See the previous chapter for a full definition of the <literal><key></" +"literal> element." +msgstr "" +"Die vollständige Definition des <literal><key></literal>-Elements " +"finden Sie im vorangegangenen Kapitel." + +#. Tag: title +#, no-c-format +msgid "Collection elements" +msgstr "Collection-Elemente" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Collections can contain almost any other Hibernate type, including: basic " +"types, custom types, components and references to other entities. This is an " +"important distinction. An object in a collection might be handled with " +"\"value\" semantics (its life cycle fully depends on the collection owner), " +"or it might be a reference to another entity with its own life cycle. In the " +"latter case, only the \"link\" between the two objects is considered to be a " +"state held by the collection." +msgstr "" +"Collections können fast jeden beliebigen anderen Hibernate-Typ enthalten, " +"einschließlich sämtlicher Grundtypen, angepasster Typen, Komponenten und " +"natürlich Referenzen zu anderen Entities. Das ist ein wichtiger Unterschied: " +"Ein Objekt einer Collection könnte mit \"Wert\"semantik bearbeitet werden " +"(sein Lebenszyklus hängt vollständig vom Besitzer der Collection ab) oder es " +"könnte ein Verweis auf eine andere Entity mit ihrem eigenen Lebenszyklus " +"sein. Im letzteren Fall wird nur die \"Verbindung\" zwischen den beiden " +"Objekten als von der Collection gehaltener Status angesehen." + +#. Tag: para +#, no-c-format +msgid "" +"The contained type is referred to as the <emphasis>collection element type</" +"emphasis>. Collection elements are mapped by <literal><element></" +"literal> or <literal><composite-element></literal>, or in the case of " +"entity references, with <literal><one-to-many></literal> or " +"<literal><many-to-many></literal>. The first two map elements with " +"value semantics, the next two are used to map entity associations." +msgstr "" +"Der enthaltene Typ wird als <emphasis>Typ von Collection-Element</emphasis> " +"bezeichnet. Collection-Elemente werden durch <literal><element></" +"literal> oder <literal><composite-element></literal> - oder im Fall " +"von Entity-Verweisen - durch <literal><one-to-many></literal> oder " +"<literal><many-to-many></literal> gemappt. Die ersten beiden Elemente " +"mappen mit Wertsemantik, die beiden folgenden werden für das Mappen von " +"Entity-Assoziationen verwendet." + +#. Tag: title +#, no-c-format +msgid "Indexed collections" +msgstr "Indizierte Collections" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"All collection mappings, except those with set and bag semantics, need an " +"<emphasis>index column</emphasis> in the collection table. An index column " +"is a column that maps to an array index, or <literal>List</literal> index, " +"or <literal>Map</literal> key. The index of a <literal>Map</literal> may be " +"of any basic type, mapped with <literal><map-key></literal>. It can be " +"an entity reference mapped with <literal><map-key-many-to-many></" +"literal>, or it can be a composite type mapped with <literal><composite-" +"map-key></literal>. The index of an array or list is always of type " +"<literal>integer</literal> and is mapped using the <literal><list-" +"index></literal> element. The mapped column contains sequential integers " +"that are numbered from zero by default." +msgstr "" +"Alle Collection-Mappings - außer denen mit \"Set\"- und \"Bag\"-Semantik - " +"benötigen eine <emphasis>Indexspalte</emphasis> in der Collection-Tabelle. " +"Es handelt sich dabei um eine Spalte, die zu einem Verzeichnis von " +"Datenelementen, <literal>List</literal>-Verzeichnis oder <literal>Map</" +"literal>-Schlüssel mappt. Der Index einer <literal>Map</literal> kann jeden " +"Grundtyp besitzen, der mit <literal><map-key></literal> gemappt ist. " +"Es kann ein mit <literal><map-key-many-to-many></literal> gemappter " +"Entity-Verweis oder ein mit <literal><composite-map-key></literal> " +"gemappter zusammengesetzter Typ sein. Der Index eines Datenelements oder " +"einer Liste ist immer vom Typ her <literal>integer</literal> und wird " +"mittels <literal><list-index></literal>-Element gemappt. Die gemappte " +"Spalte enthält sequenzielle ganze Zahlen (im Standard ab Null " +"durchnummeriert)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>column_name</literal> (required): the name of the column holding " +"the collection index values." +msgstr "" +"<literal>class</literal> (erforderlich): Der Name der zugehörigen Klasse." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>base</literal> (optional - defaults to <literal>0</literal>): the " +"value of the index column that corresponds to the first element of the list " +"or array." +msgstr "" +"<literal>cascade</literal> (optional - standardmäßig <literal>none</" +"literal>) aktiviert Vorgänge zur Weitergabe an untergeordnete Entities (sog. " +"\"child entities\")" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>column</literal> (optional): the name of the column holding the " +"collection index values." +msgstr "" +"<literal>schema</literal> (optional) der Name eines Tabellenschemas, der das " +"im Stammelement deklarierte Schema außer Kraft setzt" + +#. Tag: para +#, no-c-format +msgid "" +"<literal>formula</literal> (optional): a SQL formula used to evaluate the " +"key of the map." +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>type</literal> (required): the type of the map keys." +msgstr "" +"<literal>class</literal> (erforderlich): Der Name der zugehörigen Klasse." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>column</literal> (optional): the name of the foreign key column for " +"the collection index values." +msgstr "" +"<literal>schema</literal> (optional) der Name eines Tabellenschemas, der das " +"im Stammelement deklarierte Schema außer Kraft setzt" + +#. Tag: para +#, no-c-format +msgid "" +"<literal>formula</literal> (optional): a SQ formula used to evaluate the " +"foreign key of the map key." +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>class</literal> (required): the entity class used as the map key." +msgstr "" +"<literal>class</literal> (erforderlich): Der Name der zugehörigen Klasse." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If your table does not have an index column, and you still wish to use " +"<literal>List</literal> as the property type, you can map the property as a " +"Hibernate <emphasis><bag></emphasis>. A bag does not retain its order " +"when it is retrieved from the database, but it can be optionally sorted or " +"ordered." +msgstr "" +"Falls Ihre Tabelle keine Indexspalte besitzt und Sie nach wie vor " +"<literal>List</literal> als Property-Typ verwenden wollen, so sollten Sie " +"die Property als eine <emphasis><Bag></emphasis> mappen. Eine \"Bag\" " +"bewahrt ihre Reihenfolge beim Abruf aus der Datenbank nicht, kann aber " +"optional sortiert oder geordnet werden." + +#. Tag: title +#, no-c-format +msgid "Collections of values and many-to-many associations" +msgstr "Collections von Werten und \"Many-to-Many\"-Assoziationen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Any collection of values or many-to-many associations requires a dedicated " +"<emphasis>collection table</emphasis> with a foreign key column or columns, " +"<emphasis>collection element column</emphasis> or columns, and possibly an " +"index column or columns." +msgstr "" +"Jede Collection von Werten oder \"Many-to-Many\"-Assoziation erfordert eine " +"zugeordnete <emphasis>Collection-Tabelle</emphasis> mit einer oder mehreren " +"Fremdschlüsselspalten, <emphasis>Collection-Element-Spalte(n)</emphasis> " +"oder möglicherweise einer oder mehreren Indexspalte(n)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"For a collection of values use the <literal><element></literal> tag. " +"For example:" +msgstr "" +"Für eine Collection von Werten wird das <literal><element></literal>-" +"Tag verwendet." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>column</literal> (optional): the name of the column holding the " +"collection element values." +msgstr "" +"<literal>schema</literal> (optional) der Name eines Tabellenschemas, der das " +"im Stammelement deklarierte Schema außer Kraft setzt" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>formula</literal> (optional): an SQL formula used to evaluate the " +"element." +msgstr "" +"<literal>schema</literal> (optional) der Name eines Tabellenschemas, der das " +"im Stammelement deklarierte Schema außer Kraft setzt" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>type</literal> (required): the type of the collection element." +msgstr "" +"<literal>class</literal> (erforderlich): Der Name der zugehörigen Klasse." + +#. Tag: para +#, no-c-format +msgid "" +"A <emphasis>many-to-many association</emphasis> is specified using the " +"<literal><many-to-many></literal> element." +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>column</literal> (optional): the name of the element foreign key " +"column." +msgstr "" +"<literal>class</literal> (erforderlich): Der Name der zugehörigen Klasse." + +#. Tag: para +#, no-c-format +msgid "" +"<literal>formula</literal> (optional): an SQL formula used to evaluate the " +"element foreign key value." +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>class</literal> (required): the name of the associated class." +msgstr "" +"<literal>class</literal> (erforderlich): Der Name der zugehörigen Klasse." + +#. Tag: para +#, no-c-format +msgid "" +"<literal>fetch</literal> (optional - defaults to <literal>join</literal>): " +"enables outer-join or sequential select fetching for this association. This " +"is a special case; for full eager fetching in a single <literal>SELECT</" +"literal> of an entity and its many-to-many relationships to other entities, " +"you would enable <literal>join</literal> fetching,not only of the collection " +"itself, but also with this attribute on the <literal><many-to-many></" +"literal> nested element." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"<literal>unique</literal> (optional): enables the DDL generation of a unique " +"constraint for the foreign-key column. This makes the association " +"multiplicity effectively one-to-many." +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>not-found</literal> (optional - defaults to <literal>exception</" +"literal>): specifies how foreign keys that reference missing rows will be " +"handled: <literal>ignore</literal> will treat a missing row as a null " +"association." +msgstr "" +"<literal>not-found</literal> (optional - standardmäßig <literal>exception</" +"literal>): Bestimmt, wie gespeicherte Bezeichner (sog. \"Identifier\"), die " +"auf fehlende Reihen verweisen, behandelt werden. Mit <literal>ignore</" +"literal> wird eine fehlende Reihe als Null-Assoziation angesehen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>entity-name</literal> (optional): the entity name of the associated " +"class, as an alternative to <literal>class</literal>." +msgstr "" +"<literal>entity-name</literal> (optional): Der Entity-Name der zugehörigen " +"Klasse als Alternative zu <literal>class</literal>." + +#. Tag: para +#, no-c-format +msgid "" +"<literal>property-ref</literal> (optional): the name of a property of the " +"associated class that is joined to this foreign key. If not specified, the " +"primary key of the associated class is used." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "Here are some examples." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "A set of strings:" +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A bag containing integers with an iteration order determined by the " +"<literal>order-by</literal> attribute:" +msgstr "" +"Eine ganze Zahlen enthaltende \"Bag\" (mit einer durch das <literal>order-" +"by</literal>-Attribut bestimmten Reihenfolge):" + +#. Tag: para +#, fuzzy, no-c-format +msgid "An array of entities, in this case, a many-to-many association:" +msgstr "" +"Ein Datenelement von Entities - in diesem Fall eine \"Many-to-Many\"-" +"Assoziation:" + +#. Tag: para +#, no-c-format +msgid "A map from string indices to dates:" +msgstr "Eine Map von String-Indexen zu Daten:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "A list of components (this is discussed in the next chapter):" +msgstr "" +"Eine List von Komponenten (wird im nachfolgenden Kapitel näher erläutert):" + +#. Tag: title +#, no-c-format +msgid "One-to-many associations" +msgstr "\"One-to-Many\"-Assoziationen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A <emphasis>one-to-many association</emphasis> links the tables of two " +"classes via a foreign key with no intervening collection table. This mapping " +"loses certain semantics of normal Java collections:" +msgstr "" +"Eine <emphasis>\"One-to-Many\"-Assoziation</emphasis> verbindet die Tabellen " +"zweier Klassen mittels des Fremdschlüssels ohne eine intervenierende " +"Collection-Tabelle. Dieses Mapping verliert bestimmte Teile der Semantik " +"regulärer Java-Collections:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"An instance of the contained entity class cannot belong to more than one " +"instance of the collection." +msgstr "" +"Eine Instanz der enthaltenen Entity-Klasse kann nicht zu mehr als einer " +"Instanz der Collection gehören" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"An instance of the contained entity class cannot appear at more than one " +"value of the collection index." +msgstr "" +"Eine Instanz der enthaltenen Entity-Klasse kann nicht an mehr als einem Wert " +"des Collection-Index erscheinen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"An association from <literal>Product</literal> to <literal>Part</literal> " +"requires the existence of a foreign key column and possibly an index column " +"to the <literal>Part</literal> table. A <literal><one-to-many></" +"literal> tag indicates that this is a one-to-many association." +msgstr "" +"Eine Assoziation von <literal>Product</literal> zu <literal>Part</literal> " +"macht die Existenz einer Spalte mit Fremdschlüssel und möglicherweise einer " +"Indexspalte zur <literal>Part</literal>-Tabelle erforderlich. Ein " +"<literal><one-to-many></literal>-Tag zeigt an, dass dies eine \"One-to-" +"Many\"-Assoziation ist." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>not-found</literal> (optional - defaults to <literal>exception</" +"literal>): specifies how cached identifiers that reference missing rows will " +"be handled. <literal>ignore</literal> will treat a missing row as a null " +"association." +msgstr "" +"<literal>not-found</literal> (optional - standardmäßig <literal>exception</" +"literal>): Bestimmt, wie gespeicherte Bezeichner (sog. \"Identifier\"), die " +"auf fehlende Reihen verweisen, behandelt werden. Mit <literal>ignore</" +"literal> wird eine fehlende Reihe als Null-Assoziation angesehen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal><one-to-many></literal> element does not need to declare " +"any columns. Nor is it necessary to specify the <literal>table</literal> " +"name anywhere." +msgstr "" +"Beachten Sie, dass das <literal><one-to-many></literal>-Element keine " +"Spalten deklarieren muss. Es ist außerdem nicht nötig, den <literal>table</" +"literal>-Namen irgendwo zu bestimmen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If the foreign key column of a <literal><one-to-many></literal> " +"association is declared <literal>NOT NULL</literal>, you must declare the " +"<literal><key></literal> mapping <literal>not-null=\"true\"</literal> " +"or <emphasis>use a bidirectional association</emphasis> with the collection " +"mapping marked <literal>inverse=\"true\"</literal>. See the discussion of " +"bidirectional associations later in this chapter for more information." +msgstr "" +"<emphasis>Sehr wichtig:</emphasis> Falls die Fremdschlüsselspalte einer " +"<literal><one-to-many></literal>-Assoziation als <literal>NOT NULL</" +"literal> deklariert ist, müssen Sie beim <literal><key></literal>-" +"Mapping <literal>not-null=\"true\"</literal> deklarieren oder <emphasis>eine " +"bidirektionale Assoziation</emphasis> mit als <literal>inverse=\"true\"</" +"literal> gekennzeichnetem Collection-Mapping verwenden. Wir gehen später in " +"diesem Kapitel noch näher auf bidirektionale Assoziationen ein." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The following example shows a map of <literal>Part</literal> entities by " +"name, where <literal>partName</literal> is a persistent property of " +"<literal>Part</literal>. Notice the use of a formula-based index:" +msgstr "" +"Dieses Beispiel zeigt die Map von <literal>Part</literal>-Entities nach Name " +"(wobei <literal>partName</literal> eine persistente Property von " +"<literal>Part</literal>) ist. Beachten Sie die Verwendung eines " +"formelbasierten Index." + +#. Tag: title +#, no-c-format +msgid "Advanced collection mappings" +msgstr "Fortgeschrittene Collection-Mappings" + +#. Tag: title +#, no-c-format +msgid "Sorted collections" +msgstr "Sortierte Collections" + +#. Tag: para +#, no-c-format +msgid "" +"Hibernate supports collections implementing <literal>java.util.SortedMap</" +"literal> and <literal>java.util.SortedSet</literal>. You must specify a " +"comparator in the mapping file:" +msgstr "" +"Hibernate unterstützt <literal>java.util.SortedMap</literal> und " +"<literal>java.util.SortedSet</literal> implementierende Collections. Sie " +"müssen ein Vergleichsprogramm in der Mapping-Datei bestimmen:" + +#. Tag: para +#, no-c-format +msgid "" +"Allowed values of the <literal>sort</literal> attribute are " +"<literal>unsorted</literal>, <literal>natural</literal> and the name of a " +"class implementing <literal>java.util.Comparator</literal>." +msgstr "" +"Erlaubte Werte für das <literal>sort</literal>-Attribut sind " +"<literal>unsorted</literal>, <literal>natural</literal> und der Name einer " +"Klassenimplementierung <literal>java.util.Comparator</literal>." + +#. Tag: para +#, no-c-format +msgid "" +"Sorted collections actually behave like <literal>java.util.TreeSet</literal> " +"or <literal>java.util.TreeMap</literal>." +msgstr "" +"Sortierte Collections verhalten sich tatsächlich wie <literal>java.util." +"TreeSet</literal> oder <literal>java.util.TreeMap</literal>." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If you want the database itself to order the collection elements, use the " +"<literal>order-by</literal> attribute of <literal>set</literal>, " +"<literal>bag</literal> or <literal>map</literal> mappings. This solution is " +"only available under JDK 1.4 or higher and is implemented using " +"<literal>LinkedHashSet</literal> or <literal>LinkedHashMap</literal>. This " +"performs the ordering in the SQL query and not in the memory." +msgstr "" +"Falls Sie wollen, dass die Datenbank selbst die Elemente der Collection " +"ordnet, verwenden Sie das <literal>order-by</literal>-Attribut von " +"<literal>set</literal>, <literal>bag</literal> oder <literal>map</literal>-" +"Mappings. Diese Lösung ist nur bei JDK 1.4 oder späteren Versionen verfügbar " +"(sie wird unter <literal>LinkedHashSet</literal> oder " +"<literal>LinkedHashMap</literal> implementiert). Dadurch wird die Anordnung " +"in der SQL-Anfrage - nicht im Speicher - durchgeführt." + +#. Tag: title +#, no-c-format +msgid "Note" +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The value of the <literal>order-by</literal> attribute is an SQL ordering, " +"not an HQL ordering." +msgstr "" +"Beachten Sie, dass der Wert des <literal>order-by</literal>-Attributs eine " +"SQL-Anordnung, keine HQL-Anordnung ist!" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Associations can even be sorted by arbitrary criteria at runtime using a " +"collection <literal>filter()</literal>:" +msgstr "" +"Assoziationen können zur Runtime mittels Collection <literal>filter()</" +"literal> sogar nach beliebigen Kriterien sortiert werden." + +#. Tag: title +#, no-c-format +msgid "Bidirectional associations" +msgstr "Bidirektionale Assoziationen" + +#. Tag: para +#, no-c-format +msgid "" +"A <emphasis>bidirectional association</emphasis> allows navigation from both " +"\"ends\" of the association. Two kinds of bidirectional association are " +"supported:" +msgstr "" +"Eine <emphasis>bidirektionale Assoziation</emphasis> erlaubt die Navigation " +"von beiden \"Enden\" der Assoziation. Es werden zwei Arten bidirektionaler " +"Assoziationen unterstützt:" + +#. Tag: term +#, no-c-format +msgid "one-to-many" +msgstr "\"One-to-Many\"" + +#. Tag: para +#, fuzzy, no-c-format +msgid "set or bag valued at one end and single-valued at the other" +msgstr "" +"an einem Ende von \"Set\"- oder \"Bag\"-wertig, am anderen Ende einwertig" + +#. Tag: term +#, no-c-format +msgid "many-to-many" +msgstr "\"Many-to-Many\"" + +#. Tag: para +#, no-c-format +msgid "set or bag valued at both ends" +msgstr "an beiden Enden \"Set\"- oder \"Bag\"-wertig" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can specify a bidirectional many-to-many association by mapping two many-" +"to-many associations to the same database table and declaring one end as " +"<emphasis>inverse</emphasis>. You cannot select an indexed collection." +msgstr "" +"Sie können eine bidirektionale \"Many-to-Many\"-Assoziation ganz einfach " +"festlegen, indem Sie zwei \"Many-to-Many\"-Assoziationen zur selben " +"Datenbanktabelle mappen und ein Ende als <emphasis>invertiert</emphasis> " +"deklarieren (welches bleibt Ihnen überlassen, es kann jedoch keine " +"indizierte Collection sein)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Here is an example of a bidirectional many-to-many association that " +"illustrates how each category can have many items and each item can be in " +"many categories:" +msgstr "" +"Nachfolgend sehen Sie ein Beispiel für eine bidirektionale \"Many-to-Many\"-" +"Assoziation. Jede Kategorie kann viele Posten besitzen und jeder Posten kann " +"sich in vielen Kategorien befinden:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Changes made only to the inverse end of the association are <emphasis>not</" +"emphasis> persisted. This means that Hibernate has two representations in " +"memory for every bidirectional association: one link from A to B and another " +"link from B to A. This is easier to understand if you think about the Java " +"object model and how a many-to-many relationship in Javais created:" +msgstr "" +"Änderungen können nur am invertierten Ende der Assoziation gemacht werden " +"und sind <emphasis>nicht</emphasis> persistiert. Das bedeutet, dass " +"Hibernate zwei Darstellungen jeder bidirektionalen Assoziation im Speicher " +"besitzt - eine Verbindung von A zu B und eine weitere Verbindung von B zu A. " +"Dies ist leichter zu verstehen, wenn man an das Objektmodell von Java denkt " +"und daran, wie in Java eine \"Many-to-Many\"-Beziehung erstellt wird:" + +#. Tag: para +#, no-c-format +msgid "" +"The non-inverse side is used to save the in-memory representation to the " +"database." +msgstr "" +"Die nicht-invertierte Seite wird dazu benutzt, die gespeicherte Darstellung " +"in der Datenbank zu speichern." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can define a bidirectional one-to-many association by mapping a one-to-" +"many association to the same table column(s) as a many-to-one association " +"and declaring the many-valued end <literal>inverse=\"true\"</literal>." +msgstr "" +"Sie können eine bidirektionale \"One-to-Many\"-Assoziation definieren, indem " +"Sie eine \"One-to-Many\"-Assoziation zu derselben (oder denselben) " +"Tabellenspalte(n) wie eine \"Many-to-One\"-Assoziation mappen und für das " +"mehrwertige Ende <literal>inverse=\"true\"</literal> deklarieren." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Mapping one end of an association with <literal>inverse=\"true\"</literal> " +"does not affect the operation of cascades as these are orthogonal concepts." +msgstr "" +"Das Mappen eines der Enden einer Assoziation mit <literal>inverse=\"true\"</" +"literal> hat keinen Einfluss auf die Weitergabevorgänge (sog. \"Cascades\"), " +"es handelt sich um orthogonale Konzepte!" + +#. Tag: title +#, no-c-format +msgid "Bidirectional associations with indexed collections" +msgstr "Bidirektionale Assoziationen mit indizierten Collections" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A bidirectional association where one end is represented as a <literal><" +"list></literal> or <literal><map></literal>, requires special " +"consideration. If there is a property of the child class that maps to the " +"index column you can use <literal>inverse=\"true\"</literal> on the " +"collection mapping:" +msgstr "" +"Eine bidirektionale Assoziation, bei der ein Ende als <literal><list></" +"literal> oder <literal><map></literal> dargestellt ist, erfordert " +"besondere Beachtung. Falls eine Property der untergeordneten Klasse (sog. " +"\"child class\") existiert, die zur Indexspalte mappt, dann gibt es keine " +"Probleme und wir können mit der Verwendung von <literal>inverse=\"true\"</" +"literal> beim Collection-Mapping fortfahren:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If there is no such property on the child class, the association cannot be " +"considered truly bidirectional. That is, there is information available at " +"one end of the association that is not available at the other end. In this " +"case, you cannot map the collection <literal>inverse=\"true\"</literal>. " +"Instead, you could use the following mapping:" +msgstr "" +"Falls aber an der untergeordneten Klasse keine solche Property vorhanden " +"ist, so kann man sich die Assoziation nicht als wahrhaft bidirektional " +"vorstellen (es sind Informationen an einem Ende vorhanden, die am anderen " +"Ende nicht verfügbar sind). In diesem Fall können wir die Collection nicht " +"<literal>inverse=\"true\"</literal> mappen. Statt dessen empfehlen wir " +"folgendes Mapping:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Note that in this mapping, the collection-valued end of the association is " +"responsible for updates to the foreign key. " +msgstr "" +"Bitte beachten Sie, dass bei diesem Mapping das Collection-wertige Ende der " +"Assoziation für Aktualisierungen am Fremdschlüssel verantwortlich ist. TODO: " +"Führt dies zu unnötigen Aktualisierungsanweisungen? " + +#. Tag: title +#, no-c-format +msgid "Ternary associations" +msgstr "Dreifache Assoziationen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"There are three possible approaches to mapping a ternary association. One " +"approach is to use a <literal>Map</literal> with an association as its index:" +msgstr "" +"Es gibt drei mögliche Arten eine dreifache Assoziation zu mappen. Eine davon " +"ist die Verwendung von <literal>Map</literal> mit einer Assoziation als " +"deren Index:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A second approach is to remodel the association as an entity class. This is " +"the most common approach." +msgstr "" +"Ein zweiter Weg ist es, die Assoziation einfach als eine Entity-Klasse zu " +"gestalten. Das ist die am häufigsten gewählte Herangehensweise." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A final alternative is to use composite elements, which will be discussed " +"later." +msgstr "" +"Die dritte und letzte Variante besteht in der Verwendung zusammengesetzter " +"Elemente, auf die wir zu einem späteren Zeitpunkt näher eingehen werden." + +#. Tag: title +#, fuzzy, no-c-format +msgid "<literal>Using an <idbag></literal>" +msgstr "Die Verwendung einer <idbag>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The majority of the many-to-many associations and collections of values " +"shown previously all map to tables with composite keys, even though it has " +"been have suggested that entities should have synthetic identifiers " +"(surrogate keys). A pure association table does not seem to benefit much " +"from a surrogate key, although a collection of composite values " +"<emphasis>might</emphasis>. It is for this reason that Hibernate provides a " +"feature that allows you to map many-to-many associations and collections of " +"values to a table with a surrogate key." +msgstr "" +"Falls Sie unsere Ansicht teilen und ebenfalls der Meinung sind, dass " +"zusammengesetzte Schlüssel keine gute Sache sind und Entities synthetische " +"Bezeichner (Surrogatschlüssel) besitzen sollten, dann werden Sie es " +"wahrscheinlich seltsam finden, dass die bis jetzt von uns gezeigten \"Many-" +"to-Many\"-Assoziationen und Wert-Collections zu Tabellen mit " +"zusammengesetzten Schlüsseln mappen! Nun, über diesen Punkt lässt sich " +"streiten. Einer reinen Assoziationstabelle scheint ein Surrogatschlüssel " +"(obwohl eine Collection zusammengesetzter Werte das <emphasis>könnte</" +"emphasis>) nicht viel zu bringen. Trotzdem bietet Hibernate ein Feature, das " +"es Ihnen ermöglicht, \"Many-to-Many\"-Assoziationen und Wert-Collections zu " +"einer Tabelle mit einem Surrogatschlüssel zu mappen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal><idbag></literal> element lets you map a <literal>List</" +"literal> (or <literal>Collection</literal>) with bag semantics. For example:" +msgstr "" +"Das <literal><idbag></literal>-Element lässt Sie eine <literal>List</" +"literal> (oder <literal>Collection</literal>) mit \"Bag\"-Semantik mappen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"An <literal><idbag></literal> has a synthetic id generator, just like " +"an entity class. A different surrogate key is assigned to each collection " +"row. Hibernate does not, however, provide any mechanism for discovering the " +"surrogate key value of a particular row." +msgstr "" +"Wie Sie sehen hat <literal><idbag></literal> einen synthetischen id-" +"Generator, ganz wie eine Entity-Klasse! Ein anderer Surrogatschlüssel wird " +"jeder Reihe der Collection zugeordnet. Hibernate bietet jedoch keinen " +"Mechanismus, um den Wert eines Surrogatschlüssels für eine bestimmte Reihe " +"herauszufinden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The update performance of an <literal><idbag></literal> supersedes a " +"regular <literal><bag></literal>. Hibernate can locate individual rows " +"efficiently and update or delete them individually, similar to a list, map " +"or set." +msgstr "" +"Beachten Sie, dass die Aktualiserungsperformance einer <literal><idbag>" +"</literal> <emphasis>wesentlich</emphasis> besser als eine reguläre " +"<literal><bag></literal> ist! Hibernate kann auf effiziente Weise " +"einzelne Reihen lokalisieren und sie individuell aktualisieren oder löschen, " +"ganz wie bei einer Liste, einer Map oder einem Set." + +#. Tag: para +#, no-c-format +msgid "" +"In the current implementation, the <literal>native</literal> identifier " +"generation strategy is not supported for <literal><idbag></literal> " +"collection identifiers." +msgstr "" +"In der aktuellen Implementierung wird die <literal>native</literal> " +"Bezeichnergenerierungsstrategie nicht für <literal><idbag></literal> " +"Collection-Bezeichner unterstützt." + +#. Tag: title +#, no-c-format +msgid "Collection examples" +msgstr "Collection-Beispiele" + +#. Tag: para +#, fuzzy, no-c-format +msgid "This section covers collection examples." +msgstr "Collection-Beispiele" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The following class has a collection of <literal>Child</literal> instances:" +msgstr "" +"Der folgende Code würde verwendet, um ein neues <literal>Child</literal> " +"hinzuzufügen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If each child has, at most, one parent, the most natural mapping is a one-to-" +"many association:" +msgstr "" +"besitzt eine Collection von <literal>Child</literal>-Instanzen. Wenn jedes " +"\"child\" (untergeordnet) höchstens einen \"parent\" (übergeordnet) besitzt, " +"so ist das natürlichste Mapping eine \"One-to-Many\"-Assoziation:" + +#. Tag: para +#, no-c-format +msgid "This maps to the following table definitions:" +msgstr "Das mappt zu den folgenden Tabellendefinitionen:" + +#. Tag: para +#, no-c-format +msgid "" +"If the parent is <emphasis>required</emphasis>, use a bidirectional one-to-" +"many association:" +msgstr "" +"Falls der \"parent\" <emphasis>erforderlich</emphasis> ist, verwenden Sie " +"eine bidirektionale \"One-to-Many\"-Assoziation:" + +#. Tag: para +#, no-c-format +msgid "Notice the <literal>NOT NULL</literal> constraint:" +msgstr "Beachten Sie die <literal>NOT NULL</literal>-Bedingung:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Alternatively, if this association must be unidirectional you can declare " +"the <literal>NOT NULL</literal> constraint on the <literal><key></" +"literal> mapping:" +msgstr "" +"Andernfalls - falls Sie absolut darauf bestehen, dass diese Assoziation " +"unidirektional ist - können Sie die <literal>NOT NULL</literal>-Bedingung am " +"<literal><key></literal>-Mapping deklarieren:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"On the other hand, if a child has multiple parents, a many-to-many " +"association is appropriate:" +msgstr "" +"Wenn jedoch ein \"child\" mehrere \"parents\" besitzen kann, ist die \"Many-" +"to-Many\"-Assoziation passender:" + +#. Tag: para +#, no-c-format +msgid "Table definitions:" +msgstr "Tabellendefinitionen:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"For more examples and a complete explanation of a parent/child relationship " +"mapping, see <xref linkend=\"example-parentchild\" /> for more information." +msgstr "" +"Weitere Beispiele und eine vollständige Abhandlung des Mappings der \"parent/" +"child\"-Beziehung finden Sie unter <xref linkend=\"example-parentchild\"/>." + +#. Tag: para +#, fuzzy, no-c-format +msgid "Even more complex association mappings are covered in the next chapter." +msgstr "" +"Es sind sogar noch weitaus exotischere Assoziations-Mappings möglich, die " +"wir im nächsten Kapitel ausführen." + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[public class Product {\n" +#~ " private String serialNumber;\n" +#~ " private Set parts = new HashSet();\n" +#~ " \n" +#~ " public Set getParts() { return parts; }\n" +#~ " void setParts(Set parts) { this.parts = parts; }\n" +#~ " public String getSerialNumber() { return serialNumber; }\n" +#~ " void setSerialNumber(String sn) { serialNumber = sn; }\n" +#~ "}]]>" +#~ msgstr "" +#~ "public class Product {\n" +#~ " private String serialNumber;\n" +#~ " private Set parts = new HashSet();\n" +#~ " \n" +#~ " public Set getParts() { return parts; }\n" +#~ " void setParts(Set parts) { this.parts = parts; }\n" +#~ " public String getSerialNumber() { return serialNumber; }\n" +#~ " void setSerialNumber(String sn) { serialNumber = sn; }\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Cat cat = new DomesticCat();\n" +#~ "Cat kitten = new DomesticCat();\n" +#~ "....\n" +#~ "Set kittens = new HashSet();\n" +#~ "kittens.add(kitten);\n" +#~ "cat.setKittens(kittens);\n" +#~ "session.persist(cat);\n" +#~ "kittens = cat.getKittens(); // Okay, kittens collection is a Set\n" +#~ "(HashSet) cat.getKittens(); // Error!]]>" +#~ msgstr "" +#~ "Cat cat = new DomesticCat();\n" +#~ "Cat kitten = new DomesticCat();\n" +#~ "....\n" +#~ "Set kittens = new HashSet();\n" +#~ "kittens.add(kitten);\n" +#~ "cat.setKittens(kittens);\n" +#~ "session.persist(cat);\n" +#~ "kittens = cat.getKittens(); // Okay, kittens collection is a Set\n" +#~ "(HashSet) cat.getKittens(); // Error!" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Product\">\n" +#~ " <id name=\"serialNumber\" column=\"productSerialNumber\"/>\n" +#~ " <set name=\"parts\">\n" +#~ " <key column=\"productSerialNumber\" not-null=\"true\"/>\n" +#~ " <one-to-many class=\"Part\"/>\n" +#~ " </set>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Product\">\n" +#~ " <id name=\"serialNumber\" column=\"productSerialNumber\"/>\n" +#~ " <set name=\"parts\">\n" +#~ " <key column=\"productSerialNumber\" not-null=\"true\"/>\n" +#~ " <one-to-many class=\"Part\"/>\n" +#~ " </set>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<map\n" +#~ " name=\"propertyName\"\n" +#~ " table=\"table_name\"\n" +#~ " schema=\"schema_name\"\n" +#~ " lazy=\"true|extra|false\"\n" +#~ " inverse=\"true|false\"\n" +#~ " cascade=\"all|none|save-update|delete|all-delete-orphan|delete-orphan" +#~ "\"\n" +#~ " sort=\"unsorted|natural|comparatorClass\"\n" +#~ " order-by=\"column_name asc|desc\"\n" +#~ " where=\"arbitrary sql where condition\"\n" +#~ " fetch=\"join|select|subselect\"\n" +#~ " batch-size=\"N\"\n" +#~ " access=\"field|property|ClassName\"\n" +#~ " optimistic-lock=\"true|false\"\n" +#~ " mutable=\"true|false\"\n" +#~ " node=\"element-name|.\"\n" +#~ " embed-xml=\"true|false\"\n" +#~ ">\n" +#~ "\n" +#~ " <key .... />\n" +#~ " <map-key .... />\n" +#~ " <element .... />\n" +#~ "</map>]]>" +#~ msgstr "" +#~ "<map\n" +#~ " name=\"propertyName\"\n" +#~ " table=\"table_name\"\n" +#~ " schema=\"schema_name\"\n" +#~ " lazy=\"true|extra|false\"\n" +#~ " inverse=\"true|false\"\n" +#~ " cascade=\"all|none|save-update|delete|all-delete-orphan|delete-orphan" +#~ "\"\n" +#~ " sort=\"unsorted|natural|comparatorClass\"\n" +#~ " order-by=\"column_name asc|desc\"\n" +#~ " where=\"arbitrary sql where condition\"\n" +#~ " fetch=\"join|select|subselect\"\n" +#~ " batch-size=\"N\"\n" +#~ " access=\"field|property|ClassName\"\n" +#~ " optimistic-lock=\"true|false\"\n" +#~ " mutable=\"true|false\"\n" +#~ " node=\"element-name|.\"\n" +#~ " embed-xml=\"true|false\"\n" +#~ ">\n" +#~ "\n" +#~ " <key .... />\n" +#~ " <map-key .... />\n" +#~ " <element .... />\n" +#~ "</map>" + +#, fuzzy +#~ msgid "<![CDATA[<key column=\"productSerialNumber\" not-null=\"true\"/>]]>" +#~ msgstr "<key column=\"productSerialNumber\" not-null=\"true\"/>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<key column=\"productSerialNumber\" on-delete=\"cascade\"/>]]>" +#~ msgstr "<key column=\"productSerialNumber\" on-delete=\"cascade\"/>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<set name=\"names\" table=\"person_names\">\n" +#~ " <key column=\"person_id\"/>\n" +#~ " <element column=\"person_name\" type=\"string\"/>\n" +#~ "</set>]]>" +#~ msgstr "" +#~ "<set name=\"names\" table=\"person_names\">\n" +#~ " <key column=\"person_id\"/>\n" +#~ " <element column=\"person_name\" type=\"string\"/>\n" +#~ "</set>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<bag name=\"sizes\" \n" +#~ " table=\"item_sizes\" \n" +#~ " order-by=\"size asc\">\n" +#~ " <key column=\"item_id\"/>\n" +#~ " <element column=\"size\" type=\"integer\"/>\n" +#~ "</bag>]]>" +#~ msgstr "" +#~ "<bag name=\"sizes\" \n" +#~ " table=\"item_sizes\" \n" +#~ " order-by=\"size asc\">\n" +#~ " <key column=\"item_id\"/>\n" +#~ " <element column=\"size\" type=\"integer\"/>\n" +#~ "</bag>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<array name=\"addresses\" \n" +#~ " table=\"PersonAddress\" \n" +#~ " cascade=\"persist\">\n" +#~ " <key column=\"personId\"/>\n" +#~ " <list-index column=\"sortOrder\"/>\n" +#~ " <many-to-many column=\"addressId\" class=\"Address\"/>\n" +#~ "</array>]]>" +#~ msgstr "" +#~ "<array name=\"addresses\" \n" +#~ " table=\"PersonAddress\" \n" +#~ " cascade=\"persist\">\n" +#~ " <key column=\"personId\"/>\n" +#~ " <list-index column=\"sortOrder\"/>\n" +#~ " <many-to-many column=\"addressId\" class=\"Address\"/>\n" +#~ "</array>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<map name=\"holidays\" \n" +#~ " table=\"holidays\" \n" +#~ " schema=\"dbo\" \n" +#~ " order-by=\"hol_name asc\">\n" +#~ " <key column=\"id\"/>\n" +#~ " <map-key column=\"hol_name\" type=\"string\"/>\n" +#~ " <element column=\"hol_date\" type=\"date\"/>\n" +#~ "</map>]]>" +#~ msgstr "" +#~ "<map name=\"holidays\" \n" +#~ " table=\"holidays\" \n" +#~ " schema=\"dbo\" \n" +#~ " order-by=\"hol_name asc\">\n" +#~ " <key column=\"id\"/>\n" +#~ " <map-key column=\"hol_name\" type=\"string\"/>\n" +#~ " <element column=\"hol_date\" type=\"date\"/>\n" +#~ "</map>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<list name=\"carComponents\" \n" +#~ " table=\"CarComponents\">\n" +#~ " <key column=\"carId\"/>\n" +#~ " <list-index column=\"sortOrder\"/>\n" +#~ " <composite-element class=\"CarComponent\">\n" +#~ " <property name=\"price\"/>\n" +#~ " <property name=\"type\"/>\n" +#~ " <property name=\"serialNumber\" column=\"serialNum\"/>\n" +#~ " </composite-element>\n" +#~ "</list>]]>" +#~ msgstr "" +#~ "<list name=\"carComponents\" \n" +#~ " table=\"CarComponents\">\n" +#~ " <key column=\"carId\"/>\n" +#~ " <list-index column=\"sortOrder\"/>\n" +#~ " <composite-element class=\"CarComponent\">\n" +#~ " <property name=\"price\"/>\n" +#~ " <property name=\"type\"/>\n" +#~ " <property name=\"serialNumber\" column=\"serialNum\"/>\n" +#~ " </composite-element>\n" +#~ "</list>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<one-to-many \n" +#~ " class=\"ClassName\"\n" +#~ " not-found=\"ignore|exception\"\n" +#~ " entity-name=\"EntityName\"\n" +#~ " node=\"element-name\"\n" +#~ " embed-xml=\"true|false\"\n" +#~ " />]]>" +#~ msgstr "" +#~ "<one-to-many \n" +#~ " class=\"ClassName\"\n" +#~ " not-found=\"ignore|exception\"\n" +#~ " entity-name=\"EntityName\"\n" +#~ " node=\"element-name\"\n" +#~ " embed-xml=\"true|false\"\n" +#~ " />" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<map name=\"parts\"\n" +#~ " cascade=\"all\">\n" +#~ " <key column=\"productId\" not-null=\"true\"/>\n" +#~ " <map-key formula=\"partName\"/>\n" +#~ " <one-to-many class=\"Part\"/>\n" +#~ "</map>]]>" +#~ msgstr "" +#~ "<map name=\"parts\"\n" +#~ " cascade=\"all\">\n" +#~ " <key column=\"productId\" not-null=\"true\"/>\n" +#~ " <map-key formula=\"partName\"/>\n" +#~ " <one-to-many class=\"Part\"/>\n" +#~ "</map>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<set name=\"aliases\" \n" +#~ " table=\"person_aliases\" \n" +#~ " sort=\"natural\">\n" +#~ " <key column=\"person\"/>\n" +#~ " <element column=\"name\" type=\"string\"/>\n" +#~ "</set>\n" +#~ "\n" +#~ "<map name=\"holidays\" sort=\"my.custom.HolidayComparator\">\n" +#~ " <key column=\"year_id\"/>\n" +#~ " <map-key column=\"hol_name\" type=\"string\"/>\n" +#~ " <element column=\"hol_date\" type=\"date\"/>\n" +#~ "</map>]]>" +#~ msgstr "" +#~ "<set name=\"aliases\" \n" +#~ " table=\"person_aliases\" \n" +#~ " sort=\"natural\">\n" +#~ " <key column=\"person\"/>\n" +#~ " <element column=\"name\" type=\"string\"/>\n" +#~ "</set>\n" +#~ "\n" +#~ "<map name=\"holidays\" sort=\"my.custom.HolidayComparator\">\n" +#~ " <key column=\"year_id\"/>\n" +#~ " <map-key column=\"hol_name\" type=\"string\"/>\n" +#~ " <element column=\"hol_date\" type=\"date\"/>\n" +#~ "</map>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<set name=\"aliases\" table=\"person_aliases\" order-by=\"lower" +#~ "(name) asc\">\n" +#~ " <key column=\"person\"/>\n" +#~ " <element column=\"name\" type=\"string\"/>\n" +#~ "</set>\n" +#~ "\n" +#~ "<map name=\"holidays\" order-by=\"hol_date, hol_name\">\n" +#~ " <key column=\"year_id\"/>\n" +#~ " <map-key column=\"hol_name\" type=\"string\"/>\n" +#~ " <element column=\"hol_date type=\"date\"/>\n" +#~ "</map>]]>" +#~ msgstr "" +#~ "<set name=\"aliases\" table=\"person_aliases\" order-by=\"lower(name) " +#~ "asc\">\n" +#~ " <key column=\"person\"/>\n" +#~ " <element column=\"name\" type=\"string\"/>\n" +#~ "</set>\n" +#~ "\n" +#~ "<map name=\"holidays\" order-by=\"hol_date, hol_name\">\n" +#~ " <key column=\"year_id\"/>\n" +#~ " <map-key column=\"hol_name\" type=\"string\"/>\n" +#~ " <element column=\"hol_date type=\"date\"/>\n" +#~ "</map>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[sortedUsers = s.createFilter( group.getUsers(), \"order by this." +#~ "name\" ).list();]]>" +#~ msgstr "" +#~ "sortedUsers = s.createFilter( group.getUsers(), \"order by this.name\" )." +#~ "list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Category\">\n" +#~ " <id name=\"id\" column=\"CATEGORY_ID\"/>\n" +#~ " ...\n" +#~ " <bag name=\"items\" table=\"CATEGORY_ITEM\">\n" +#~ " <key column=\"CATEGORY_ID\"/>\n" +#~ " <many-to-many class=\"Item\" column=\"ITEM_ID\"/>\n" +#~ " </bag>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Item\">\n" +#~ " <id name=\"id\" column=\"ITEM_ID\"/>\n" +#~ " ...\n" +#~ "\n" +#~ " \n" +#~ " <bag name=\"categories\" table=\"CATEGORY_ITEM\" inverse=\"true\">\n" +#~ " <key column=\"ITEM_ID\"/>\n" +#~ " <many-to-many class=\"Category\" column=\"CATEGORY_ID\"/>\n" +#~ " </bag>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Category\">\n" +#~ " <id name=\"id\" column=\"CATEGORY_ID\"/>\n" +#~ " ...\n" +#~ " <bag name=\"items\" table=\"CATEGORY_ITEM\">\n" +#~ " <key column=\"CATEGORY_ID\"/>\n" +#~ " <many-to-many class=\"Item\" column=\"ITEM_ID\"/>\n" +#~ " </bag>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Item\">\n" +#~ " <id name=\"id\" column=\"CATEGORY_ID\"/>\n" +#~ " ...\n" +#~ "\n" +#~ " \n" +#~ " <bag name=\"categories\" table=\"CATEGORY_ITEM\" inverse=\"true" +#~ "\">\n" +#~ " <key column=\"ITEM_ID\"/>\n" +#~ " <many-to-many class=\"Category\" column=\"CATEGORY_ID\"/>\n" +#~ " </bag>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[\n" +#~ "category.getItems().add(item); // The category now \"knows\" " +#~ "about the relationship\n" +#~ "item.getCategories().add(category); // The item now \"knows\" about " +#~ "the relationship\n" +#~ "\n" +#~ "session.persist(item); // The relationship won't be " +#~ "saved!\n" +#~ "session.persist(category); // The relationship will be " +#~ "saved]]>" +#~ msgstr "" +#~ "category.getItems().add(item); // The category now \"knows\" " +#~ "about the relationship\n" +#~ "item.getCategories().add(category); // The item now \"knows\" about " +#~ "the relationship\n" +#~ "\n" +#~ "session.persist(item); // The relationship won't be " +#~ "saved!\n" +#~ "session.persist(category); // The relationship will be saved" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Parent\">\n" +#~ " <id name=\"id\" column=\"parent_id\"/>\n" +#~ " ....\n" +#~ " <set name=\"children\" inverse=\"true\">\n" +#~ " <key column=\"parent_id\"/>\n" +#~ " <one-to-many class=\"Child\"/>\n" +#~ " </set>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Child\">\n" +#~ " <id name=\"id\" column=\"child_id\"/>\n" +#~ " ....\n" +#~ " <many-to-one name=\"parent\" \n" +#~ " class=\"Parent\" \n" +#~ " column=\"parent_id\"\n" +#~ " not-null=\"true\"/>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Parent\">\n" +#~ " <id name=\"id\" column=\"parent_id\"/>\n" +#~ " ....\n" +#~ " <set name=\"children\" inverse=\"true\">\n" +#~ " <key column=\"parent_id\"/>\n" +#~ " <one-to-many class=\"Child\"/>\n" +#~ " </set>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Child\">\n" +#~ " <id name=\"id\" column=\"child_id\"/>\n" +#~ " ....\n" +#~ " <many-to-one name=\"parent\" \n" +#~ " class=\"Parent\" \n" +#~ " column=\"parent_id\"\n" +#~ " not-null=\"true\"/>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Parent\">\n" +#~ " <id name=\"id\" column=\"parent_id\"/>\n" +#~ " ....\n" +#~ " <map name=\"children\" inverse=\"true\">\n" +#~ " <key column=\"parent_id\"/>\n" +#~ " <map-key column=\"name\" \n" +#~ " type=\"string\"/>\n" +#~ " <one-to-many class=\"Child\"/>\n" +#~ " </map>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Child\">\n" +#~ " <id name=\"id\" column=\"child_id\"/>\n" +#~ " ....\n" +#~ " <property name=\"name\" \n" +#~ " not-null=\"true\"/>\n" +#~ " <many-to-one name=\"parent\" \n" +#~ " class=\"Parent\" \n" +#~ " column=\"parent_id\"\n" +#~ " not-null=\"true\"/>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Parent\">\n" +#~ " <id name=\"id\" column=\"parent_id\"/>\n" +#~ " ....\n" +#~ " <map name=\"children\" inverse=\"true\">\n" +#~ " <key column=\"parent_id\"/>\n" +#~ " <map-key column=\"name\" \n" +#~ " type=\"string\"/>\n" +#~ " <one-to-many class=\"Child\"/>\n" +#~ " </map>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Child\">\n" +#~ " <id name=\"id\" column=\"child_id\"/>\n" +#~ " ....\n" +#~ " <property name=\"name\" \n" +#~ " not-null=\"true\"/>\n" +#~ " <many-to-one name=\"parent\" \n" +#~ " class=\"Parent\" \n" +#~ " column=\"parent_id\"\n" +#~ " not-null=\"true\"/>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Parent\">\n" +#~ " <id name=\"id\" column=\"parent_id\"/>\n" +#~ " ....\n" +#~ " <map name=\"children\">\n" +#~ " <key column=\"parent_id\"\n" +#~ " not-null=\"true\"/>\n" +#~ " <map-key column=\"name\" \n" +#~ " type=\"string\"/>\n" +#~ " <one-to-many class=\"Child\"/>\n" +#~ " </map>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Child\">\n" +#~ " <id name=\"id\" column=\"child_id\"/>\n" +#~ " ....\n" +#~ " <many-to-one name=\"parent\" \n" +#~ " class=\"Parent\" \n" +#~ " column=\"parent_id\"\n" +#~ " insert=\"false\"\n" +#~ " update=\"false\"\n" +#~ " not-null=\"true\"/>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Parent\">\n" +#~ " <id name=\"id\" column=\"parent_id\"/>\n" +#~ " ....\n" +#~ " <map name=\"children\">\n" +#~ " <key column=\"parent_id\"\n" +#~ " not-null=\"true\"/>\n" +#~ " <map-key column=\"name\" \n" +#~ " type=\"string\"/>\n" +#~ " <one-to-many class=\"Child\"/>\n" +#~ " </map>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Child\">\n" +#~ " <id name=\"id\" column=\"child_id\"/>\n" +#~ " ....\n" +#~ " <many-to-one name=\"parent\" \n" +#~ " class=\"Parent\" \n" +#~ " column=\"parent_id\"\n" +#~ " insert=\"false\"\n" +#~ " update=\"false\"\n" +#~ " not-null=\"true\"/>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<map name=\"contracts\">\n" +#~ " <key column=\"employer_id\" not-null=\"true\"/>\n" +#~ " <map-key-many-to-many column=\"employee_id\" class=\"Employee\"/>\n" +#~ " <one-to-many class=\"Contract\"/>\n" +#~ "</map>]]>" +#~ msgstr "" +#~ "<map name=\"contracts\">\n" +#~ " <key column=\"employer_id\" not-null=\"true\"/>\n" +#~ " <map-key-many-to-many column=\"employee_id\" class=\"Employee\"/" +#~ ">\n" +#~ " <one-to-many class=\"Contract\"/>\n" +#~ "</map>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<map name=\"connections\">\n" +#~ " <key column=\"incoming_node_id\"/>\n" +#~ " <map-key-many-to-many column=\"outgoing_node_id\" class=\"Node\"/>\n" +#~ " <many-to-many column=\"connection_id\" class=\"Connection\"/>\n" +#~ "</map>]]>" +#~ msgstr "" +#~ "<map name=\"connections\">\n" +#~ " <key column=\"incoming_node_id\"/>\n" +#~ " <map-key-many-to-many column=\"outgoing_node_id\" class=\"Node\"/" +#~ ">\n" +#~ " <many-to-many column=\"connection_id\" class=\"Connection\"/>\n" +#~ "</map>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<idbag name=\"lovers\" table=\"LOVERS\">\n" +#~ " <collection-id column=\"ID\" type=\"long\">\n" +#~ " <generator class=\"sequence\"/>\n" +#~ " </collection-id>\n" +#~ " <key column=\"PERSON1\"/>\n" +#~ " <many-to-many column=\"PERSON2\" class=\"Person\" fetch=\"join\"/>\n" +#~ "</idbag>]]>" +#~ msgstr "" +#~ "<idbag name=\"lovers\" table=\"LOVERS\">\n" +#~ " <collection-id column=\"ID\" type=\"long\">\n" +#~ " <generator class=\"sequence\"/>\n" +#~ " </collection-id>\n" +#~ " <key column=\"PERSON1\"/>\n" +#~ " <many-to-many column=\"PERSON2\" class=\"Person\" fetch=\"join\"/" +#~ ">\n" +#~ "</idbag>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[package eg;\n" +#~ "import java.util.Set;\n" +#~ "\n" +#~ "public class Parent {\n" +#~ " private long id;\n" +#~ " private Set children;\n" +#~ "\n" +#~ " public long getId() { return id; }\n" +#~ " private void setId(long id) { this.id=id; }\n" +#~ "\n" +#~ " private Set getChildren() { return children; }\n" +#~ " private void setChildren(Set children) { this.children=children; }\n" +#~ "\n" +#~ " ....\n" +#~ " ....\n" +#~ "}]]>" +#~ msgstr "" +#~ "package eg;\n" +#~ "import java.util.Set;\n" +#~ "\n" +#~ "public class Parent {\n" +#~ " private long id;\n" +#~ " private Set children;\n" +#~ "\n" +#~ " public long getId() { return id; }\n" +#~ " private void setId(long id) { this.id=id; }\n" +#~ "\n" +#~ " private Set getChildren() { return children; }\n" +#~ " private void setChildren(Set children) { this.children=children; }\n" +#~ "\n" +#~ " ....\n" +#~ " ....\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<hibernate-mapping>\n" +#~ "\n" +#~ " <class name=\"Parent\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"sequence\"/>\n" +#~ " </id>\n" +#~ " <set name=\"children\">\n" +#~ " <key column=\"parent_id\"/>\n" +#~ " <one-to-many class=\"Child\"/>\n" +#~ " </set>\n" +#~ " </class>\n" +#~ "\n" +#~ " <class name=\"Child\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"sequence\"/>\n" +#~ " </id>\n" +#~ " <property name=\"name\"/>\n" +#~ " </class>\n" +#~ "\n" +#~ "</hibernate-mapping>]]>" +#~ msgstr "" +#~ "<hibernate-mapping>\n" +#~ "\n" +#~ " <class name=\"Parent\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"sequence\"/>\n" +#~ " </id>\n" +#~ " <set name=\"children\">\n" +#~ " <key column=\"parent_id\"/>\n" +#~ " <one-to-many class=\"Child\"/>\n" +#~ " </set>\n" +#~ " </class>\n" +#~ "\n" +#~ " <class name=\"Child\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"sequence\"/>\n" +#~ " </id>\n" +#~ " <property name=\"name\"/>\n" +#~ " </class>\n" +#~ "\n" +#~ "</hibernate-mapping>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[create table parent ( id bigint not null primary key )\n" +#~ "create table child ( id bigint not null primary key, name varchar(255), " +#~ "parent_id bigint )\n" +#~ "alter table child add constraint childfk0 (parent_id) references parent]]>" +#~ msgstr "" +#~ "create table parent ( id bigint not null primary key )\n" +#~ "create table child ( id bigint not null primary key, name varchar(255), " +#~ "parent_id bigint )\n" +#~ "alter table child add constraint childfk0 (parent_id) references parent" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<hibernate-mapping>\n" +#~ "\n" +#~ " <class name=\"Parent\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"sequence\"/>\n" +#~ " </id>\n" +#~ " <set name=\"children\" inverse=\"true\">\n" +#~ " <key column=\"parent_id\"/>\n" +#~ " <one-to-many class=\"Child\"/>\n" +#~ " </set>\n" +#~ " </class>\n" +#~ "\n" +#~ " <class name=\"Child\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"sequence\"/>\n" +#~ " </id>\n" +#~ " <property name=\"name\"/>\n" +#~ " <many-to-one name=\"parent\" class=\"Parent\" column=\"parent_id" +#~ "\" not-null=\"true\"/>\n" +#~ " </class>\n" +#~ "\n" +#~ "</hibernate-mapping>]]>" +#~ msgstr "" +#~ "<hibernate-mapping>\n" +#~ "\n" +#~ " <class name=\"Parent\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"sequence\"/>\n" +#~ " </id>\n" +#~ " <set name=\"children\" inverse=\"true\">\n" +#~ " <key column=\"parent_id\"/>\n" +#~ " <one-to-many class=\"Child\"/>\n" +#~ " </set>\n" +#~ " </class>\n" +#~ "\n" +#~ " <class name=\"Child\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"sequence\"/>\n" +#~ " </id>\n" +#~ " <property name=\"name\"/>\n" +#~ " <many-to-one name=\"parent\" class=\"Parent\" column=" +#~ "\"parent_id\" not-null=\"true\"/>\n" +#~ " </class>\n" +#~ "\n" +#~ "</hibernate-mapping>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[create table parent ( id bigint not null primary key )\n" +#~ "create table child ( id bigint not null\n" +#~ " primary key,\n" +#~ " name varchar(255),\n" +#~ " parent_id bigint not null )\n" +#~ "alter table child add constraint childfk0 (parent_id) references parent]]>" +#~ msgstr "" +#~ "create table parent ( id bigint not null primary key )\n" +#~ "create table child ( id bigint not null\n" +#~ " primary key,\n" +#~ " name varchar(255),\n" +#~ " parent_id bigint not null )\n" +#~ "alter table child add constraint childfk0 (parent_id) references parent" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<hibernate-mapping>\n" +#~ "\n" +#~ " <class name=\"Parent\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"sequence\"/>\n" +#~ " </id>\n" +#~ " <set name=\"children\">\n" +#~ " <key column=\"parent_id\" not-null=\"true\"/>\n" +#~ " <one-to-many class=\"Child\"/>\n" +#~ " </set>\n" +#~ " </class>\n" +#~ "\n" +#~ " <class name=\"Child\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"sequence\"/>\n" +#~ " </id>\n" +#~ " <property name=\"name\"/>\n" +#~ " </class>\n" +#~ "\n" +#~ "</hibernate-mapping>]]>" +#~ msgstr "" +#~ "<hibernate-mapping>\n" +#~ "\n" +#~ " <class name=\"Parent\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"sequence\"/>\n" +#~ " </id>\n" +#~ " <set name=\"children\">\n" +#~ " <key column=\"parent_id\" not-null=\"true\"/>\n" +#~ " <one-to-many class=\"Child\"/>\n" +#~ " </set>\n" +#~ " </class>\n" +#~ "\n" +#~ " <class name=\"Child\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"sequence\"/>\n" +#~ " </id>\n" +#~ " <property name=\"name\"/>\n" +#~ " </class>\n" +#~ "\n" +#~ "</hibernate-mapping>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<hibernate-mapping>\n" +#~ "\n" +#~ " <class name=\"Parent\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"sequence\"/>\n" +#~ " </id>\n" +#~ " <set name=\"children\" table=\"childset\">\n" +#~ " <key column=\"parent_id\"/>\n" +#~ " <many-to-many class=\"Child\" column=\"child_id\"/>\n" +#~ " </set>\n" +#~ " </class>\n" +#~ "\n" +#~ " <class name=\"Child\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"sequence\"/>\n" +#~ " </id>\n" +#~ " <property name=\"name\"/>\n" +#~ " </class>\n" +#~ "\n" +#~ "</hibernate-mapping>]]>" +#~ msgstr "" +#~ "<hibernate-mapping>\n" +#~ "\n" +#~ " <class name=\"Parent\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"sequence\"/>\n" +#~ " </id>\n" +#~ " <set name=\"children\" table=\"childset\">\n" +#~ " <key column=\"parent_id\"/>\n" +#~ " <many-to-many class=\"Child\" column=\"child_id\"/>\n" +#~ " </set>\n" +#~ " </class>\n" +#~ "\n" +#~ " <class name=\"Child\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"sequence\"/>\n" +#~ " </id>\n" +#~ " <property name=\"name\"/>\n" +#~ " </class>\n" +#~ "\n" +#~ "</hibernate-mapping>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[create table parent ( id bigint not null primary key )\n" +#~ "create table child ( id bigint not null primary key, name varchar(255) )\n" +#~ "create table childset ( parent_id bigint not null,\n" +#~ " child_id bigint not null,\n" +#~ " primary key ( parent_id, child_id ) )\n" +#~ "alter table childset add constraint childsetfk0 (parent_id) references " +#~ "parent\n" +#~ "alter table childset add constraint childsetfk1 (child_id) references " +#~ "child]]>" +#~ msgstr "" +#~ "create table parent ( id bigint not null primary key )\n" +#~ "create table child ( id bigint not null primary key, name varchar(255) )\n" +#~ "create table childset ( parent_id bigint not null,\n" +#~ " child_id bigint not null,\n" +#~ " primary key ( parent_id, child_id ) )\n" +#~ "alter table childset add constraint childsetfk0 (parent_id) references " +#~ "parent\n" +#~ "alter table childset add constraint childsetfk1 (child_id) references " +#~ "child" Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/component_mapping.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/component_mapping.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/component_mapping.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,1073 @@ +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# Language /mnt/hgfs/base/Hibernate/Reference translations for PACKAGE package. +# Copyright (C) 2006, 2007 Free Software Foundation, Inc. +# Automatically generated, 2006. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# +msgid "" +msgstr "" +"Project-Id-Version: Collection_Mapping\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2010-01-08T04:07:18\n" +"PO-Revision-Date: 2007-02-26 10:27+1000\n" +"Last-Translator: \n" +"Language-Team: <de(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.9.1\n" + +#. Tag: title +#, no-c-format +msgid "Component Mapping" +msgstr "Komponenten-Mapping" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The notion of a <emphasis>component</emphasis> is re-used in several " +"different contexts and purposes throughout Hibernate." +msgstr "" +"Der Begriff der <emphasis>Komponente</emphasis> wird in Hibernate in " +"verschiedenen Kontexten und zu unterschiedlichen Zwecken aufgegriffen." + +#. Tag: title +#, no-c-format +msgid "Dependent objects" +msgstr "Abhängige Objekte" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A component is a contained object that is persisted as a value type and not " +"an entity reference. The term \"component\" refers to the object-oriented " +"notion of composition and not to architecture-level components. For example, " +"you can model a person like this:" +msgstr "" +"Bei einer Komponente handelt es sich um ein enthaltenes Objekt, das als " +"Wertetyp, nicht als Entity-Referenz persistiert ist. Der Begriff \"Komponente" +"\" verweist auf den objektorientierten Aspekt der Zusammensetzung (nicht auf " +"Komponenten der Architektur-Ebene). Sie könnten zum Beispiel folgendes " +"Modell für eine Person erstellen:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Now <literal>Name</literal> can be persisted as a component of " +"<literal>Person</literal>. <literal>Name</literal> defines getter and setter " +"methods for its persistent properties, but it does not need to declare any " +"interfaces or identifier properties." +msgstr "" +"Jetzt kann <literal>Name</literal> als Komponente von <literal>Person</" +"literal> persistiert werden. Beachten Sie, dass <literal>Name</literal> \"Get" +"\"- und \"Set\"-Methoden für persistente Properties definiert, aber keine " +"Interfaces oder Bezeichner-Properties deklarieren muss." + +#. Tag: para +#, fuzzy, no-c-format +msgid "Our Hibernate mapping would look like this:" +msgstr "Unser Hibernate Mapping würde wie folgt aussehen:" + +#. Tag: para +#, no-c-format +msgid "" +"The person table would have the columns <literal>pid</literal>, " +"<literal>birthday</literal>, <literal>initial</literal>, <literal>first</" +"literal> and <literal>last</literal>." +msgstr "" +"Die Personentabelle würde die Spalten <literal>pid</literal>, " +"<literal>birthday</literal>, <literal>initial</literal>, <literal>first</" +"literal> und <literal>last</literal> besitzen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Like value types, components do not support shared references. In other " +"words, two persons could have the same name, but the two person objects " +"would contain two independent name objects that were only \"the same\" by " +"value. The null value semantics of a component are <emphasis>ad hoc</" +"emphasis>. When reloading the containing object, Hibernate will assume that " +"if all component columns are null, then the entire component is null. This " +"is suitable for most purposes." +msgstr "" +"Wie alle Wertetypen unterstützen Komponenten keine geteilten Verweise (sog. " +"\"shared references\"). Mit anderen Worten: Zwei Personen könnten denselben " +"Namen besitzen, aber die beiden Personen-Objekte würden zwei unabhängige " +"Namensobjekte besitzen, die nur hinsichtlich des Werts \"gleich\" sind. Die " +"Nullwert-Semantik einer Komponente ist <emphasis>ad hoc</emphasis>. Wenn das " +"enthaltene Objekt erneut geladen wird, geht Hibernate davon aus, dass die " +"gesamte Komponente Null ist, wenn alle Spalten Null sind . Für die meisten " +"Zwecke ist das in Ordnung." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The properties of a component can be of any Hibernate type (collections, " +"many-to-one associations, other components, etc). Nested components should " +"<emphasis>not</emphasis> be considered an exotic usage. Hibernate is " +"intended to support a fine-grained object model." +msgstr "" +"Die Properties einer Komponente können jeden Hibernate-Typ besitzen " +"(Collections, \"Many-to-One\"-Assoziationen, andere Komponenten, usw). " +"Verschachtelte Komponenten sollten <emphasis>nicht</emphasis> als exotisch " +"angesehen werden - Hibernate ist dafür vorgesehen, ein sehr feinstufiges " +"Objektmodell zu unterstützen." + +#. Tag: para +#, no-c-format +msgid "" +"The <literal><component></literal> element allows a <literal><" +"parent></literal> subelement that maps a property of the component class " +"as a reference back to the containing entity." +msgstr "" +"Das <literal><component></literal>-Element ermöglicht ein <literal><" +"parent></literal>-Subelement, das eine Property der Komponentenklasse als " +"Rückreferenz zur enthaltenden Entity mappt." + +#. Tag: title +#, no-c-format +msgid "Collections of dependent objects" +msgstr "Collections abhängiger Objekte" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Collections of components are supported (e.g. an array of type " +"<literal>Name</literal>). Declare your component collection by replacing the " +"<literal><element></literal> tag with a <literal><composite-" +"element></literal> tag:" +msgstr "" +"Collections von Komponenten werden unterstützt (z.B. ein Datenelement vom " +"Typ <literal>Name</literal>). Deklarieren Sie Ihre Collection von " +"Komponenten, indem Sie das <literal><element></literal>-Tag durch ein " +"<literal><composite-element></literal>-Tag ersetzen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If you define a <literal>Set</literal> of composite elements, it is " +"important to implement <literal>equals()</literal> and <literal>hashCode()</" +"literal> correctly." +msgstr "" +"Hinweis: Falls Sie ein <literal>Set</literal> zusammengesetzter Elemente " +"deklarieren, ist es sehr wichtig, dass Sie <literal>equals()</literal> und " +"<literal>hashCode()</literal> korrekt implementieren." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Composite elements can contain components but not collections. If your " +"composite element contains components, use the <literal><nested-composite-" +"element></literal> tag. This case is a collection of components which " +"themselves have components. You may want to consider if a one-to-many " +"association is more appropriate. Remodel the composite element as an entity, " +"but be aware that even though the Java model is the same, the relational " +"model and persistence semantics are still slightly different." +msgstr "" +"Zusammengesetzte Elemente können Komponenten, nicht jedoch Collections " +"enthalten. Falls Ihr zusammengesetztes Element selbst Komponenten enthält, " +"verwenden Sie das <literal><nested-composite-element></literal>-Tag. " +"Es handelt sich dabei aber um einen recht exotischen Fall - eine Collection " +"von Komponenten, die wiederum selbst über Komponenten verfügen. An dieser " +"Stelle sollten Sie sich fragen, ob eine \"One-to-Many\"-Assoziation nicht " +"sinnvoller ist. Versuchen Sie, das zusammengesetzte Element zu einer Entity " +"zu machen - aber beachten Sie: Obwohl das Java-Modell dasselbe ist, gibt es " +"doch gewisse Unterschiede hinsichtlich des relationalen Modells und der " +"Persistenz-Semantik." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A composite element mapping does not support null-able properties if you are " +"using a <literal><set></literal>. There is no separate primary key " +"column in the composite element table. Hibernate uses each column's value to " +"identify a record when deleting objects, which is not possible with null " +"values. You have to either use only not-null properties in a composite-" +"element or choose a <literal><list></literal>, <literal><map></" +"literal>, <literal><bag></literal> or <literal><idbag></literal>." +msgstr "" +"Bitte beachten Sie, dass zusammengesetztes Element-Mapping keine nullbaren " +"Properties unterstützt, wenn Sie ein <literal><set></literal> " +"verwenden. Hibernate muss den Wert jeder Spalte verwenden, um einen " +"Datensatz bei der Löschung von Objekten zu identifizieren (es existiert " +"keine separate Primärschlüsselspalte in der Tabelle mit zusammengesetzten " +"Elementen), was mit Nullwerten nicht möglich ist. Sie müssen entweder " +"ausschließlich Properties, die nicht Null sind, in einem zusammengesetzten " +"Element verwenden oder <literal><list></literal>, <literal><map>" +"</literal>, <literal><bag></literal> oder <literal><idbag></" +"literal> wählen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A special case of a composite element is a composite element with a nested " +"<literal><many-to-one></literal> element. This mapping allows you to " +"map extra columns of a many-to-many association table to the composite " +"element class. The following is a many-to-many association from " +"<literal>Order</literal> to <literal>Item</literal>, where " +"<literal>purchaseDate</literal>, <literal>price</literal> and " +"<literal>quantity</literal> are properties of the association:" +msgstr "" +"Um einen besonderen Fall von zusammengesetztem Element handelt es sich bei " +"einem zusammengesetzten Element mit verschachteltem <literal><many-to-" +"one></literal>-Element. Ein solches Mapping erlaubt es Ihnen, Extra-" +"Spalten einer \"Many-to-Many\"-Assoziationstabelle zu einer " +"zusammengesetzten Elementklasse zu mappen. Nachfolgend sehen Sie eine \"Many-" +"to-Many\"-Assoziation von <literal>Order</literal> zu <literal>Item</" +"literal> wo <literal>purchaseDate</literal>, <literal>price</literal> und " +"<literal>quantity</literal> Properties der Assoziation sind:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"There cannot be a reference to the purchase on the other side for " +"bidirectional association navigation. Components are value types and do not " +"allow shared references. A single <literal>Purchase</literal> can be in the " +"set of an <literal>Order</literal>, but it cannot be referenced by the " +"<literal>Item</literal> at the same time." +msgstr "" +"Natürlich kann kein Verweis zum Kauf (\"Purchase\") auf der anderen Seite " +"für eine bidirektionale Assoziationsnavigation existieren. Vergessen Sie " +"nicht, dass es sich bei Komponenten um Wertetypen handelt und diese keine " +"geteilten Verweise erlauben. Ein einzelner <literal>Purchase</literal> kann " +"sich im Satz einer <literal>Order</literal> befinden, aber kann nicht zur " +"gleichen Zeit durch den <literal>Item</literal> referenziert werden." + +#. Tag: para +#, no-c-format +msgid "Even ternary (or quaternary, etc) associations are possible:" +msgstr "Sogar dreifache (oder vierfache, usw.) Assoziationen sind möglich:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Composite elements can appear in queries using the same syntax as " +"associations to other entities." +msgstr "" +"Zusammengesetzte Elemente können in Anfragen vorkommen und verwenden " +"dieselbe Syntax wie Assoziationen zu anderen Entities." + +#. Tag: title +#, no-c-format +msgid "Components as Map indices" +msgstr "Komponenten als Map-Indizes" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal><composite-map-key></literal> element allows you to map a " +"component class as the key of a <literal>Map</literal>. Ensure that you " +"override <literal>hashCode()</literal> and <literal>equals()</literal> " +"correctly on the component class." +msgstr "" +"Das <literal><composite-map-key></literal>-Element lässt Sie eine " +"Komponentenklasse als Schlüssel einer <literal>Map</literal> mappen. " +"Vergewissern Sie sich, dass Sie <literal>hashCode()</literal> und " +"<literal>equals()</literal> in der Komponentenklasse ordnungsgemäß außer " +"Kraft setzen." + +#. Tag: title +#, no-c-format +msgid "Components as composite identifiers" +msgstr "Komponenten als zusammengesetzte Bezeichner" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can use a component as an identifier of an entity class. Your component " +"class must satisfy certain requirements:" +msgstr "" +"Sie können eine Komponente als Bezeichner einer Entity-Klasse verwenden. " +"Ihre Komponentenklasse muss folgende Anforderungen erfüllen:" + +#. Tag: para +#, no-c-format +msgid "It must implement <literal>java.io.Serializable</literal>." +msgstr "Es muss <literal>java.io.Serializable</literal> implementieren." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"It must re-implement <literal>equals()</literal> and <literal>hashCode()</" +"literal> consistently with the database's notion of composite key equality." +msgstr "" +"Es muss <literal>equals()</literal> und <literal>hashCode()</literal> re-" +"implementieren, konsistent mit dem Datenbankbegriff der Gleichheit der " +"zusammengesetzten Schlüssel (sog. \"composite key equality\")." + +#. Tag: title +#, no-c-format +msgid "Note" +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"In Hibernate3, although the second requirement is not an absolutely hard " +"requirement of Hibernate, it is recommended." +msgstr "" +"Hinweis: In Hibernate3 ist die zweite Anforderung nicht absolut zwingend. " +"Dennoch sollten Sie sich daran halten." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You cannot use an <literal>IdentifierGenerator</literal> to generate " +"composite keys. Instead the application must assign its own identifiers." +msgstr "" +"Sie können keinen <literal>IdentifierGenerator</literal> verwenden, um " +"zusammengesetzte Schlüssel zu generieren. Statt dessen muss die Anwendung " +"Ihre eigenen Bezeichner zuordnen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Use the <literal><composite-id></literal> tag, with nested " +"<literal><key-property></literal> elements, in place of the usual " +"<literal><id></literal> declaration. For example, the " +"<literal>OrderLine</literal> class has a primary key that depends upon the " +"(composite) primary key of <literal>Order</literal>." +msgstr "" +"Verwenden Sie das <literal><composite-id></literal>-Tag (mit " +"verschachtelten <literal><key-property></literal>-Elementen) anstelle " +"der üblichen <literal><id></literal>-Deklaration. Zum Beispiel besitzt " +"die <literal>OrderLine</literal>-Klasse einen Primärschlüssel, der vom " +"(zusammengesetzten) Primärschlüssel von <literal>Order</literal> abhängt." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Any foreign keys referencing the <literal>OrderLine</literal> table are now " +"composite. Declare this in your mappings for other classes. An association " +"to <literal>OrderLine</literal> is mapped like this:" +msgstr "" +"Nun sind alle Fremdschlüssel, die auf die <literal>OrderLine</literal>-" +"Tabelle verweisen, ebenfalls zusammengesetzt. Sie müssen dies in Ihren " +"Mappings für andere Klassen deklarieren. Eine Assoziation zu " +"<literal>OrderLine</literal> würde wie folgt gemappt:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal><column></literal> tag is an alternative to the " +"<literal>column</literal> attribute everywhere. Using the <literal><" +"column></literal> tag just gives more declaration options, which are " +"mostly useful when utilizing <literal>hbm2ddl</literal>." +msgstr "" +"(Beachten Sie, dass das <literal><column></literal>-Tag überall eine " +"Alternative zum <literal>column</literal>-Attribut darstellt)." + +#. Tag: para +#, no-c-format +msgid "" +"A <literal>many-to-many</literal> association to <literal>OrderLine</" +"literal> also uses the composite foreign key:" +msgstr "" +"Eine <literal>many-to-many</literal>-Assoziation zu <literal>OrderLine</" +"literal> verwendet ebenfalls den zusammengesetzten Fremdschlüssel:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The collection of <literal>OrderLine</literal>s in <literal>Order</literal> " +"would use:" +msgstr "" +"Die Collection von <literal>OrderLine</literal>s in <literal>Order</literal> " +"würde Folgendes verwenden:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "The <literal><one-to-many></literal> element declares no columns." +msgstr "" +"(Das <literal><one-to-many></literal>-Element deklariert wie üblich " +"keine Spalten)." + +#. Tag: para +#, no-c-format +msgid "" +"If <literal>OrderLine</literal> itself owns a collection, it also has a " +"composite foreign key." +msgstr "" +"Falls <literal>OrderLine</literal> selbst eine Collection besitzt, so " +"besitzt es auch einen zusammengesetzten Fremdschlüssel." + +#. Tag: title +#, no-c-format +msgid "Dynamic components" +msgstr "Dynamische Komponenten" + +#. Tag: para +#, fuzzy, no-c-format +msgid "You can also map a property of type <literal>Map</literal>:" +msgstr "Sie können sogar eine Property vom Typ <literal>Map</literal> mappen:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The semantics of a <literal><dynamic-component></literal> mapping are " +"identical to <literal><component></literal>. The advantage of this " +"kind of mapping is the ability to determine the actual properties of the " +"bean at deployment time just by editing the mapping document. Runtime " +"manipulation of the mapping document is also possible, using a DOM parser. " +"You can also access, and change, Hibernate's configuration-time metamodel " +"via the <literal>Configuration</literal> object." +msgstr "" +"Die Semantik eines <literal><dynamic-component></literal>-Mappings ist " +"identisch mit <literal><component></literal>. Der Vorteil dieser Art " +"des Mappings besteht in der Möglichkeit, die tatsächlichen Properties des " +"Beans zum Zeitpunkt des Deployments zu bestimmen, indem das Mapping-Dokument " +"editiert wird. Eine Runtime-Manipulation des Mapping-Dokuments ist mit einem " +"DOM-Parser ebenfalls möglich. Besser noch: Sie können mittels " +"<literal>Configuration</literal>-Objekt auf das Konfigurationszeit-" +"Metamodell von Hibernate zugreifen (und es verändern)." + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[public class Person {\n" +#~ " private java.util.Date birthday;\n" +#~ " private Name name;\n" +#~ " private String key;\n" +#~ " public String getKey() {\n" +#~ " return key;\n" +#~ " }\n" +#~ " private void setKey(String key) {\n" +#~ " this.key=key;\n" +#~ " }\n" +#~ " public java.util.Date getBirthday() {\n" +#~ " return birthday;\n" +#~ " }\n" +#~ " public void setBirthday(java.util.Date birthday) {\n" +#~ " this.birthday = birthday;\n" +#~ " }\n" +#~ " public Name getName() {\n" +#~ " return name;\n" +#~ " }\n" +#~ " public void setName(Name name) {\n" +#~ " this.name = name;\n" +#~ " }\n" +#~ " ......\n" +#~ " ......\n" +#~ "}]]>" +#~ msgstr "" +#~ "public class Person {\n" +#~ " private java.util.Date birthday;\n" +#~ " private Name name;\n" +#~ " private String key;\n" +#~ " public String getKey() {\n" +#~ " return key;\n" +#~ " }\n" +#~ " private void setKey(String key) {\n" +#~ " this.key=key;\n" +#~ " }\n" +#~ " public java.util.Date getBirthday() {\n" +#~ " return birthday;\n" +#~ " }\n" +#~ " public void setBirthday(java.util.Date birthday) {\n" +#~ " this.birthday = birthday;\n" +#~ " }\n" +#~ " public Name getName() {\n" +#~ " return name;\n" +#~ " }\n" +#~ " public void setName(Name name) {\n" +#~ " this.name = name;\n" +#~ " }\n" +#~ " ......\n" +#~ " ......\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[public class Name {\n" +#~ " char initial;\n" +#~ " String first;\n" +#~ " String last;\n" +#~ " public String getFirst() {\n" +#~ " return first;\n" +#~ " }\n" +#~ " void setFirst(String first) {\n" +#~ " this.first = first;\n" +#~ " }\n" +#~ " public String getLast() {\n" +#~ " return last;\n" +#~ " }\n" +#~ " void setLast(String last) {\n" +#~ " this.last = last;\n" +#~ " }\n" +#~ " public char getInitial() {\n" +#~ " return initial;\n" +#~ " }\n" +#~ " void setInitial(char initial) {\n" +#~ " this.initial = initial;\n" +#~ " }\n" +#~ "}]]>" +#~ msgstr "" +#~ "public class Name {\n" +#~ " char initial;\n" +#~ " String first;\n" +#~ " String last;\n" +#~ " public String getFirst() {\n" +#~ " return first;\n" +#~ " }\n" +#~ " void setFirst(String first) {\n" +#~ " this.first = first;\n" +#~ " }\n" +#~ " public String getLast() {\n" +#~ " return last;\n" +#~ " }\n" +#~ " void setLast(String last) {\n" +#~ " this.last = last;\n" +#~ " }\n" +#~ " public char getInitial() {\n" +#~ " return initial;\n" +#~ " }\n" +#~ " void setInitial(char initial) {\n" +#~ " this.initial = initial;\n" +#~ " }\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"eg.Person\" table=\"person\">\n" +#~ " <id name=\"Key\" column=\"pid\" type=\"string\">\n" +#~ " <generator class=\"uuid\"/>\n" +#~ " </id>\n" +#~ " <property name=\"birthday\" type=\"date\"/>\n" +#~ " <component name=\"Name\" class=\"eg.Name\"> \n" +#~ " <property name=\"initial\"/>\n" +#~ " <property name=\"first\"/>\n" +#~ " <property name=\"last\"/>\n" +#~ " </component>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"eg.Person\" table=\"person\">\n" +#~ " <id name=\"Key\" column=\"pid\" type=\"string\">\n" +#~ " <generator class=\"uuid\"/>\n" +#~ " </id>\n" +#~ " <property name=\"birthday\" type=\"date\"/>\n" +#~ " <component name=\"Name\" class=\"eg.Name\"> \n" +#~ " <property name=\"initial\"/>\n" +#~ " <property name=\"first\"/>\n" +#~ " <property name=\"last\"/>\n" +#~ " </component>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"eg.Person\" table=\"person\">\n" +#~ " <id name=\"Key\" column=\"pid\" type=\"string\">\n" +#~ " <generator class=\"uuid\"/>\n" +#~ " </id>\n" +#~ " <property name=\"birthday\" type=\"date\"/>\n" +#~ " <component name=\"Name\" class=\"eg.Name\" unique=\"true\">\n" +#~ " <parent name=\"namedPerson\"/> \n" +#~ " <property name=\"initial\"/>\n" +#~ " <property name=\"first\"/>\n" +#~ " <property name=\"last\"/>\n" +#~ " </component>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"eg.Person\" table=\"person\">\n" +#~ " <id name=\"Key\" column=\"pid\" type=\"string\">\n" +#~ " <generator class=\"uuid\"/>\n" +#~ " </id>\n" +#~ " <property name=\"birthday\" type=\"date\"/>\n" +#~ " <component name=\"Name\" class=\"eg.Name\" unique=\"true\">\n" +#~ " <parent name=\"namedPerson\"/> \n" +#~ " <property name=\"initial\"/>\n" +#~ " <property name=\"first\"/>\n" +#~ " <property name=\"last\"/>\n" +#~ " </component>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<set name=\"someNames\" table=\"some_names\" lazy=\"true\">\n" +#~ " <key column=\"id\"/>\n" +#~ " <composite-element class=\"eg.Name\"> \n" +#~ " <property name=\"initial\"/>\n" +#~ " <property name=\"first\"/>\n" +#~ " <property name=\"last\"/>\n" +#~ " </composite-element>\n" +#~ "</set>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"eg.Order\" .... >\n" +#~ " ....\n" +#~ " <set name=\"purchasedItems\" table=\"purchase_items\" lazy=\"true\">\n" +#~ " <key column=\"order_id\">\n" +#~ " <composite-element class=\"eg.Purchase\">\n" +#~ " <property name=\"purchaseDate\"/>\n" +#~ " <property name=\"price\"/>\n" +#~ " <property name=\"quantity\"/>\n" +#~ " <many-to-one name=\"item\" class=\"eg.Item\"/> \n" +#~ " </composite-element>\n" +#~ " </set>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"eg.Order\" .... >\n" +#~ " ....\n" +#~ " <set name=\"purchasedItems\" table=\"purchase_items\" lazy=\"true" +#~ "\">\n" +#~ " <key column=\"order_id\">\n" +#~ " <composite-element class=\"eg.Purchase\">\n" +#~ " <property name=\"purchaseDate\"/>\n" +#~ " <property name=\"price\"/>\n" +#~ " <property name=\"quantity\"/>\n" +#~ " <many-to-one name=\"item\" class=\"eg.Item\"/> \n" +#~ " </composite-element>\n" +#~ " </set>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"eg.Order\" .... >\n" +#~ " ....\n" +#~ " <set name=\"purchasedItems\" table=\"purchase_items\" lazy=\"true\">\n" +#~ " <key column=\"order_id\">\n" +#~ " <composite-element class=\"eg.OrderLine\">\n" +#~ " <many-to-one name=\"purchaseDetails class=\"eg.Purchase\"/>\n" +#~ " <many-to-one name=\"item\" class=\"eg.Item\"/>\n" +#~ " </composite-element>\n" +#~ " </set>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"eg.Order\" .... >\n" +#~ " ....\n" +#~ " <set name=\"purchasedItems\" table=\"purchase_items\" lazy=\"true" +#~ "\">\n" +#~ " <key column=\"order_id\">\n" +#~ " <composite-element class=\"eg.OrderLine\">\n" +#~ " <many-to-one name=\"purchaseDetails class=\"eg.Purchase\"/" +#~ ">\n" +#~ " <many-to-one name=\"item\" class=\"eg.Item\"/>\n" +#~ " </composite-element>\n" +#~ " </set>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"OrderLine\">\n" +#~ " \n" +#~ " <composite-id name=\"id\" class=\"OrderLineId\">\n" +#~ " <key-property name=\"lineId\"/>\n" +#~ " <key-property name=\"orderId\"/>\n" +#~ " <key-property name=\"customerId\"/>\n" +#~ " </composite-id>\n" +#~ " \n" +#~ " <property name=\"name\"/>\n" +#~ " \n" +#~ " <many-to-one name=\"order\" class=\"Order\"\n" +#~ " insert=\"false\" update=\"false\">\n" +#~ " <column name=\"orderId\"/>\n" +#~ " <column name=\"customerId\"/>\n" +#~ " </many-to-one>\n" +#~ " ....\n" +#~ " \n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"OrderLine\">\n" +#~ " \n" +#~ " <composite-id name=\"id\" class=\"OrderLineId\">\n" +#~ " <key-property name=\"lineId\"/>\n" +#~ " <key-property name=\"orderId\"/>\n" +#~ " <key-property name=\"customerId\"/>\n" +#~ " </composite-id>\n" +#~ " \n" +#~ " <property name=\"name\"/>\n" +#~ " \n" +#~ " <many-to-one name=\"order\" class=\"Order\"\n" +#~ " insert=\"false\" update=\"false\">\n" +#~ " <column name=\"orderId\"/>\n" +#~ " <column name=\"customerId\"/>\n" +#~ " </many-to-one>\n" +#~ " ....\n" +#~ " \n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<many-to-one name=\"orderLine\" class=\"OrderLine\">\n" +#~ "\n" +#~ " <column name=\"lineId\"/>\n" +#~ " <column name=\"orderId\"/>\n" +#~ " <column name=\"customerId\"/>\n" +#~ "</many-to-one>]]>" +#~ msgstr "" +#~ "<many-to-one name=\"orderLine\" class=\"OrderLine\">\n" +#~ "\n" +#~ " <column name=\"lineId\"/>\n" +#~ " <column name=\"orderId\"/>\n" +#~ " <column name=\"customerId\"/>\n" +#~ "</many-to-one>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<set name=\"undeliveredOrderLines\">\n" +#~ " <key column name=\"warehouseId\"/>\n" +#~ " <many-to-many class=\"OrderLine\">\n" +#~ " <column name=\"lineId\"/>\n" +#~ " <column name=\"orderId\"/>\n" +#~ " <column name=\"customerId\"/>\n" +#~ " </many-to-many>\n" +#~ "</set>]]>" +#~ msgstr "" +#~ "<set name=\"undeliveredOrderLines\">\n" +#~ " <key column name=\"warehouseId\"/>\n" +#~ " <many-to-many class=\"OrderLine\">\n" +#~ " <column name=\"lineId\"/>\n" +#~ " <column name=\"orderId\"/>\n" +#~ " <column name=\"customerId\"/>\n" +#~ " </many-to-many>\n" +#~ "</set>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<set name=\"orderLines\" inverse=\"true\">\n" +#~ " <key>\n" +#~ " <column name=\"orderId\"/>\n" +#~ " <column name=\"customerId\"/>\n" +#~ " </key>\n" +#~ " <one-to-many class=\"OrderLine\"/>\n" +#~ "</set>]]>" +#~ msgstr "" +#~ "<set name=\"orderLines\" inverse=\"true\">\n" +#~ " <key>\n" +#~ " <column name=\"orderId\"/>\n" +#~ " <column name=\"customerId\"/>\n" +#~ " </key>\n" +#~ " <one-to-many class=\"OrderLine\"/>\n" +#~ "</set>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"OrderLine\">\n" +#~ " ....\n" +#~ " ....\n" +#~ " <list name=\"deliveryAttempts\">\n" +#~ " <key> \n" +#~ " <column name=\"lineId\"/>\n" +#~ " <column name=\"orderId\"/>\n" +#~ " <column name=\"customerId\"/>\n" +#~ " </key>\n" +#~ " <list-index column=\"attemptId\" base=\"1\"/>\n" +#~ " <composite-element class=\"DeliveryAttempt\">\n" +#~ " ...\n" +#~ " </composite-element>\n" +#~ " </set>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"OrderLine\">\n" +#~ " ....\n" +#~ " ....\n" +#~ " <list name=\"deliveryAttempts\">\n" +#~ " <key> \n" +#~ " <column name=\"lineId\"/>\n" +#~ " <column name=\"orderId\"/>\n" +#~ " <column name=\"customerId\"/>\n" +#~ " </key>\n" +#~ " <list-index column=\"attemptId\" base=\"1\"/>\n" +#~ " <composite-element class=\"DeliveryAttempt\">\n" +#~ " ...\n" +#~ " </composite-element>\n" +#~ " </set>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<dynamic-component name=\"userAttributes\">\n" +#~ " <property name=\"foo\" column=\"FOO\" type=\"string\"/>\n" +#~ " <property name=\"bar\" column=\"BAR\" type=\"integer\"/>\n" +#~ " <many-to-one name=\"baz\" class=\"Baz\" column=\"BAZ_ID\"/>\n" +#~ "</dynamic-component>]]>" +#~ msgstr "" +#~ "<dynamic-component name=\"userAttributes\">\n" +#~ " <property name=\"foo\" column=\"FOO\" type=\"string\"/>\n" +#~ " <property name=\"bar\" column=\"BAR\" type=\"integer\"/>\n" +#~ " <many-to-one name=\"baz\" class=\"Baz\" column=\"BAZ_ID\"/>\n" +#~ "</dynamic-component>" Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/configuration.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/configuration.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/configuration.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,3227 @@ +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# Language /mnt/hgfs/base/Hibernate/Reference translations for PACKAGE package. +# Copyright (C) 2006, 2007 Free Software Foundation, Inc. +# Automatically generated, 2006. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# +msgid "" +msgstr "" +"Project-Id-Version: Collection_Mapping\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2010-01-08T04:07:18\n" +"PO-Revision-Date: 2007-02-26 10:27+1000\n" +"Last-Translator: \n" +"Language-Team: <de(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.9.1\n" + +#. Tag: title +#, no-c-format +msgid "Configuration" +msgstr "Konfiguration" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate is designed to operate in many different environments and, as " +"such, there is a broad range of configuration parameters. Fortunately, most " +"have sensible default values and Hibernate is distributed with an example " +"<literal>hibernate.properties</literal> file in <literal>etc/</literal> that " +"displays the various options. Simply put the example file in your classpath " +"and customize it to suit your needs." +msgstr "" +"Da Hibernate für die Benutzung in zahlreichen verschiedenen Umgebungen " +"entwickelt wurde, existiert eine hohe Anzahl von Konfigurationsparametern. " +"Glücklicherweise besitzen die meisten vernünftige Standardwerte, und " +"Hibernate wird mit der Beispieldatei<literal>hibernate.properties</literal> " +"in <literal>etc/</literal> geliefert, die die verschiedenen Möglichkeiten " +"darstellt. Legen Sie die Beispieldatei einfach in Ihrem Klassenpfad ab, und " +"passen Sie sie an." + +#. Tag: title +#, no-c-format +msgid "Programmatic configuration" +msgstr "Programmatische Konfiguration" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"An instance of <classname>org.hibernate.cfg.Configuration</classname> " +"represents an entire set of mappings of an application's Java types to an " +"SQL database. The <classname>org.hibernate.cfg.Configuration</classname> is " +"used to build an immutable <interfacename>org.hibernate.SessionFactory</" +"interfacename>. The mappings are compiled from various XML mapping files." +msgstr "" +"Eine Instanz von <literal>org.hibernate.cfg.Configuration</literal> " +"repräsentiert einen vollständigen Satz der Mappings von Java-Typen einer " +"Anwendung zu einer SQL-Datenbank. Die <literal>Configuration</literal> wird " +"benutzt, um eine (unveränderbare) <literal>SessionFactory</literal> zu " +"bauen. Die Mappings werden aus verschiedenen XML-Mapping-Dateien kompiliert." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can obtain a <classname>org.hibernate.cfg.Configuration</classname> " +"instance by instantiating it directly and specifying XML mapping documents. " +"If the mapping files are in the classpath, use <literal>addResource()</" +"literal>. For example:" +msgstr "" +"Sie erhalten eine <literal>Configuration</literal>-Instanz, indem Sie diese " +"direkt instanziieren und XML Mapping-Dokumente spezifizieren. Falls die " +"Mapping-Dateien sich im Klassenpfad befinden, verwenden Sie " +"<literal>addResource()</literal>:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"An alternative way is to specify the mapped class and allow Hibernate to " +"find the mapping document for you:" +msgstr "" +"Eine andere (und manchmal bessere) Weise, die gemappte Klasse zu " +"spezifizieren ist es, Hibernate das Mapping-Dokument finden zu lassen:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate will then search for mapping files named <filename>/org/hibernate/" +"auction/Item.hbm.xml</filename> and <filename>/org/hibernate/auction/Bid.hbm." +"xml</filename> in the classpath. This approach eliminates any hardcoded " +"filenames." +msgstr "" +"Hibernate sucht dann im Klassenpfad nach Mapping-Dateien mit dem Namen " +"<literal>/org/hibernate/auction/Item.hbm.xml</literal> und <literal>/org/" +"hibernate/auction/Bid.hbm.xml</literal>. Diese Vorgehensweise eleminiert " +"jegliche festcodierten Dateinamen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A <classname>org.hibernate.cfg.Configuration</classname> also allows you to " +"specify configuration properties. For example:" +msgstr "" +"Eine <literal>Configuration</literal> erlaubt es Ihnen auch, " +"Konfigurationseigenschaften zu bestimmen:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This is not the only way to pass configuration properties to Hibernate. Some " +"alternative options include:" +msgstr "" +"Das ist nicht die einzige Möglichkeit Konfigurationseigenschaften an " +"Hibernate weiterzugeben. Die verschiedenen Optionen beinhalten:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Pass an instance of <classname>java.util.Properties</classname> to " +"<literal>Configuration.setProperties()</literal>." +msgstr "" +"Geben Sie eine Instanz von <literal>java.util.Properties</literal> an " +"<literal>Configuration.setProperties()</literal>." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Place a file named <filename>hibernate.properties</filename> in a root " +"directory of the classpath." +msgstr "" +"Legen Sie <literal>hibernate.properties</literal> in ein Stammverzeichnis " +"des Klassenpfads." + +#. Tag: para +#, no-c-format +msgid "" +"Set <literal>System</literal> properties using <literal>java -" +"Dproperty=value</literal>." +msgstr "" +"Stellen Sie die <literal>System</literal>-Properties mittels <literal>java -" +"Dproperty=value</literal> ein." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Include <literal><property></literal> elements in <literal>hibernate." +"cfg.xml</literal> (this is discussed later)." +msgstr "" +"Nehmen Sie <literal><property></literal>-Elemente in " +"<literal>hibernate.cfg.xml</literal> auf (dies wird später noch näher " +"erläutert)." + +#. Tag: para +#, no-c-format +msgid "" +"If you want to get started quickly<filename>hibernate.properties</filename> " +"is the easiest approach." +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <classname>org.hibernate.cfg.Configuration</classname> is intended as a " +"startup-time object that will be discarded once a <literal>SessionFactory</" +"literal> is created." +msgstr "" +"Die <literal>Configuration</literal> ist als Objekt für den Zeitpunkt des " +"Startup gedacht und kann nach Erstellung einer <literal>SessionFactory</" +"literal> verworfen werden." + +#. Tag: title +#, no-c-format +msgid "Obtaining a SessionFactory" +msgstr "Erstellung einer SessionFactory" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"When all mappings have been parsed by the <classname>org.hibernate.cfg." +"Configuration</classname>, the application must obtain a factory for " +"<classname>org.hibernate.Session</classname> instances. This factory is " +"intended to be shared by all application threads:" +msgstr "" +"Wenn alle Mappings von der <literal>Configuration</literal> analysiert " +"(\"geparst\") wurden, muss die Anwendung eine Factory für die " +"<literal>Session</literal>-Instanzen erstellen. Diese Factory wird von allen " +"Anwendungsthreads geteilt:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate does allow your application to instantiate more than one " +"<classname>org.hibernate.SessionFactory</classname>. This is useful if you " +"are using more than one database." +msgstr "" +"Mit Hibernate kann Ihre Anwendung mehr als eine <literal>SessionFactory</" +"literal> instanziieren. Das ist insbesondere dann von Nutzen, wenn Sie mehr " +"als eine Datenbank verwenden." + +#. Tag: title +#, no-c-format +msgid "JDBC connections" +msgstr "JDBC-Verbindungen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"It is advisable to have the <interfacename>org.hibernate.SessionFactory</" +"interfacename> create and pool JDBC connections for you. If you take this " +"approach, opening a <interfacename>org.hibernate.Session</interfacename> is " +"as simple as:" +msgstr "" +"In der Regel soll die <literal>SessionFactory</literal> JDBC-Verbindungen " +"für Sie erstellen und zusammenfassen. Wenn Sie diese Vorgehensweise wählen, " +"so ist das Eröffnen einer <literal>Session</literal> ganz einfach:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Once you start a task that requires access to the database, a JDBC " +"connection will be obtained from the pool." +msgstr "" +"Sobald Sie etwas ausführen, dass den Zugriff auf die Datenbank erfordert, " +"wird eine JDBC-Verbindung aus dem Pool bereitgestellt." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Before you can do this, you first need to pass some JDBC connection " +"properties to Hibernate. All Hibernate property names and semantics are " +"defined on the class <classname>org.hibernate.cfg.Environment</classname>. " +"The most important settings for JDBC connection configuration are outlined " +"below." +msgstr "" +"Für diesen Teil der Arbeit müssen einige der Properties der JDBC-Verbindung " +"an Hibernate weitergegeben werden. Namen und Semantik der Hibernate " +"Properties sind in der Klasse <literal>org.hibernate.cfg.Environment</" +"literal> definiert. Nachfolgend werden die wichtigsten Einstellungen für die " +"Konfiguration der JDBC-Verbindungen erläutert." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate will obtain and pool connections using <classname>java.sql." +"DriverManager</classname> if you set the following properties:" +msgstr "" +"Hibernate bezieht (und poolt) Verbindungen unter Verwendung von " +"<literal>java.sql.DriverManager</literal>, wenn Sie die folgenden Properties " +"einstellen:" + +#. Tag: title +#, no-c-format +msgid "Hibernate JDBC Properties" +msgstr "Hibernate JDBC-Properties" + +#. Tag: para +#, no-c-format +msgid "Property name" +msgstr "Property-Name" + +#. Tag: para +#, no-c-format +msgid "Purpose" +msgstr "Zweck" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<property>hibernate.connection.driver_class</property>" +msgstr "hibernate.connection.driver_class" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<emphasis>JDBC driver class</emphasis>" +msgstr "jdbc-Treiberklasse" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<property>hibernate.connection.url</property>" +msgstr "hibernate.connection.url" + +#. Tag: para +#, no-c-format +msgid "<emphasis>JDBC URL</emphasis>" +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<property>hibernate.connection.username</property>" +msgstr "hibernate.connection.username" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<emphasis>database user</emphasis>" +msgstr "<emphasis>Datenbankbenutzer</emphasis> (optional)" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<property>hibernate.connection.password</property>" +msgstr "hibernate.connection.password" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<emphasis>database user password</emphasis>" +msgstr "<emphasis>Passwort des Datenbankbenutzers</emphasis> (optional)" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<property>hibernate.connection.pool_size</property>" +msgstr "hibernate.connection.pool_size" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<emphasis>maximum number of pooled connections</emphasis>" +msgstr "maximale Anzahl gepoolter Verbindungen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate's own connection pooling algorithm is, however, quite rudimentary. " +"It is intended to help you get started and is <emphasis>not intended for use " +"in a production system</emphasis>, or even for performance testing. You " +"should use a third party pool for best performance and stability. Just " +"replace the <property>hibernate.connection.pool_size</property> property " +"with connection pool specific settings. This will turn off Hibernate's " +"internal pool. For example, you might like to use c3p0." +msgstr "" +"Hibernates eigener Pooling-Algorithmus für Verbindungen ist recht " +"rudimentär. Er soll Ihnen beim Start helfen und ist <emphasis>nicht für den " +"Gebrauch in einem Produktionssystem</emphasis> oder gar für die " +"Funktionsprüfung vorgesehen. Für die beste Performance und Stabilität " +"sollten Sie den Pool einer dritten Partei verwenden. Ersetzen Sie einfach " +"die <literal>hibernate.connection.pool_size</literal>-Property mit den " +"spezifischen Einstellungen für den Verbindungspool. Dadurch wird Hibernates " +"interner Pool ausgeschaltet. Sie können zum Beispiel C3P0 verwenden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"C3P0 is an open source JDBC connection pool distributed along with Hibernate " +"in the <filename>lib</filename> directory. Hibernate will use its " +"<classname>org.hibernate.connection.C3P0ConnectionProvider</classname> for " +"connection pooling if you set <property>hibernate.c3p0.*</property> " +"properties. If you would like to use Proxool, refer to the packaged " +"<filename>hibernate.properties</filename> and the Hibernate web site for " +"more information." +msgstr "" +"Bei C3P0 handelt es sich um einen Open Source JDBC-Verbindungspool, der mit " +"Hibernate im <literal>lib</literal>-Verzeichnis vertrieben wird. Hibernate " +"verwendet seinen <literal>C3P0ConnectionProvider</literal> für das Poolen " +"von Verbindungen, wenn Sie die <literal>hibernate.c3p0.*</literal>-" +"Properties einstellen. Falls Sie Proxool verwenden möchten, dann finden Sie " +"weitere Informationen im <literal>hibernate.properties</literal>-Paket sowie " +"auf der Hibernate Website." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The following is an example <filename>hibernate.properties</filename> file " +"for c3p0:" +msgstr "" +"Hier sehen Sie das Beispiel einer <literal>hibernate.properties</literal>-" +"Datei für C3P0:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"For use inside an application server, you should almost always configure " +"Hibernate to obtain connections from an application server " +"<interfacename>javax.sql.Datasource</interfacename> registered in JNDI. You " +"will need to set at least one of the following properties:" +msgstr "" +"Für den Gebrauch innerhalb eines Applikationsservers sollten Sie Hibernate " +"fast immer so konfigurieren, dass es Verbindungen von einer " +"Applikationsserver <literal>Datasource</literal>, die in JNDI registriert " +"ist, erhält. Sie werden mindestens eine der folgenden Properties einstellen " +"müssen:" + +#. Tag: title +#, no-c-format +msgid "Hibernate Datasource Properties" +msgstr "Properties der Hibernate Datenquelle (\"Datasource\")" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<property>hibernate.connection.datasource</property>" +msgstr "hibernate.connection.datasource" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<emphasis>datasource JNDI name</emphasis>" +msgstr "<emphasis>Datenbankbenutzer</emphasis> (optional)" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<property>hibernate.jndi.url</property>" +msgstr "hibernate.jndi.url" + +#. Tag: para +#, no-c-format +msgid "<emphasis>URL of the JNDI provider</emphasis> (optional)" +msgstr "<emphasis>URL des JNDI-Providers</emphasis> (optional)" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<property>hibernate.jndi.class</property>" +msgstr "hibernate.jndi.class" + +#. Tag: para +#, no-c-format +msgid "" +"<emphasis>class of the JNDI <literal>InitialContextFactory</literal></" +"emphasis> (optional)" +msgstr "" +"<emphasis>Klasse der JNDI-<literal>InitialContextFactory</literal></" +"emphasis> (optional)" + +#. Tag: para +#, no-c-format +msgid "<emphasis>database user</emphasis> (optional)" +msgstr "<emphasis>Datenbankbenutzer</emphasis> (optional)" + +#. Tag: para +#, no-c-format +msgid "<emphasis>database user password</emphasis> (optional)" +msgstr "<emphasis>Passwort des Datenbankbenutzers</emphasis> (optional)" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Here is an example <filename>hibernate.properties</filename> file for an " +"application server provided JNDI datasource:" +msgstr "" +"Hier sehen Sie das Beispiel einer <literal>hibernate.properties</literal>-" +"Datei für eine vom Applikationsserver bereitgestellte JNDI-Datenquelle:" + +#. Tag: para +#, no-c-format +msgid "" +"JDBC connections obtained from a JNDI datasource will automatically " +"participate in the container-managed transactions of the application server." +msgstr "" +"Von einer JNDI-Datenquelle erhaltene JDBC-Verbindungen nehmen automatisch an " +"den vom Container verwalteten Transaktionen des Applikationsservers teil." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Arbitrary connection properties can be given by prepending " +"\"<literal>hibernate.connection</literal>\" to the connection property name. " +"For example, you can specify a <property>charSet</property> connection " +"property using <property>hibernate.connection.charSet</property>." +msgstr "" +"Beliebige Verbindungs-Properties können durch Voranstellen von " +"\"<literal>hibernate.connnection</literal>\" vor den Property-Namen gegeben " +"werden. Sie können zum Beispiel ein <literal>charSet</literal> durch " +"Verwendung von <literal>hibernate.connection.charSet</literal> bestimmen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can define your own plugin strategy for obtaining JDBC connections by " +"implementing the interface <interfacename>org.hibernate.connection." +"ConnectionProvider</interfacename>, and specifying your custom " +"implementation via the <property>hibernate.connection.provider_class</" +"property> property." +msgstr "" +"Sie können Ihre eigene Plugin-Strategie für den Erhalt von JDBC-Verbindungen " +"durch Implementierung des Interface <literal>org.hibernate.connection." +"ConnectionProvider</literal> definieren. Mit der Einstellung von " +"<literal>hibernate.connection.provider_class</literal> können Sie außerdem " +"Ihre eigene anwenderdefinierte Implementierung wählen." + +#. Tag: title +#, no-c-format +msgid "Optional configuration properties" +msgstr "Optionale Properties der Konfiguration" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"There are a number of other properties that control the behavior of " +"Hibernate at runtime. All are optional and have reasonable default values." +msgstr "" +"Es gibt noch eine Reihe anderer Properties, die das Verhalten von Hibernate " +"zur Runtime (Laufzeit) steuern. Alle sind optional und besitzen sinnvolle " +"Standardwerte." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Some of these properties are system-level only. System-level properties can " +"be set only via <code>java -Dproperty=value</code> or <filename>hibernate." +"properties</filename>. They <emphasis>cannot</emphasis> be set by the other " +"techniques described above." +msgstr "" +"<emphasis>Warnung: Einige dieser Properties betreffen ausschließlich die " +"\"Systemebene\".</emphasis> Properties der Systemebene können nur mittels " +"<literal>java -Dproperty=value</literal> oder <literal>hibernate.properties</" +"literal> eingestellt werden. Sie dürfen <emphasis>nicht</emphasis> mittels " +"der anderen, oben beschriebenen Techniken eingestellt werden." + +#. Tag: title +#, no-c-format +msgid "Hibernate Configuration Properties" +msgstr "Konfigurationseigenschaften von Hibernate" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<property>hibernate.dialect</property>" +msgstr "hibernate.dialect" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The classname of a Hibernate <classname>org.hibernate.dialect.Dialect</" +"classname> which allows Hibernate to generate SQL optimized for a particular " +"relational database." +msgstr "" +"Der Klassenname eines Hibernate <literal>Dialect</literal>, der es Hibernate " +"ermöglicht, für eine bestimmte relationale Datenbank optimiertes SQL zu " +"generieren." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">e.g.</emphasis> <literal>full.classname.of." +"Dialect</literal>" +msgstr "" +"<emphasis role=\"strong\">eg.</emphasis><literal>full.classname.of.Dialect</" +"literal>" + +#. Tag: para +#, no-c-format +msgid "" +"In most cases Hibernate will actually be able to choose the correct " +"<classname>org.hibernate.dialect.Dialect</classname> implementation based on " +"the <literal>JDBC metadata</literal> returned by the JDBC driver." +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<property>hibernate.show_sql</property>" +msgstr "hibernate.show_sql" + +#. Tag: para +#, no-c-format +msgid "" +"Write all SQL statements to console. This is an alternative to setting the " +"log category <literal>org.hibernate.SQL</literal> to <literal>debug</" +"literal>." +msgstr "" +"Schreiben Sie alle SQL-Anweisungen in die Konsole. Es handelt sich dabei um " +"eine Alternative für die Einstellung der Protokollkategorie <literal>org." +"hibernate.SQL</literal> auf <literal>debug</literal>." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">e.g.</emphasis> <literal>true</literal> | " +"<literal>false</literal>" +msgstr "" +"<emphasis role=\"strong\">eg.</emphasis><literal>true</literal> | " +"<literal>false</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<property>hibernate.format_sql</property>" +msgstr "hibernate.format_sql" + +#. Tag: para +#, no-c-format +msgid "Pretty print the SQL in the log and console." +msgstr "SQL in Protokoll und Konsole lesbar ausgeben." + +#. Tag: para +#, fuzzy, no-c-format +msgid "<property>hibernate.default_schema</property>" +msgstr "hibernate.default_schema" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Qualify unqualified table names with the given schema/tablespace in " +"generated SQL." +msgstr "" +"Definieren Sie unbenannte Tabellennamen mit dem gegebenen Schema/" +"Tabellenraum in generiertem SQL." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">e.g.</emphasis> <literal>SCHEMA_NAME</literal>" +msgstr "<emphasis role=\"strong\">eg.</emphasis><literal>SCHEMA_NAME</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<property>hibernate.default_catalog</property>" +msgstr "hibernate.default_catalog" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Qualifies unqualified table names with the given catalog in generated SQL." +msgstr "" +"Definieren Sie unbenannte Tabellennamen mit dem vorgegebenen Katalog in der " +"generierten SQL." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">e.g.</emphasis> <literal>CATALOG_NAME</literal>" +msgstr "" +"<emphasis role=\"strong\">eg.</emphasis><literal>CATALOG_NAME</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<property>hibernate.session_factory_name</property>" +msgstr "hibernate.session_factory_name" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <interfacename>org.hibernate.SessionFactory</interfacename> will be " +"automatically bound to this name in JNDI after it has been created." +msgstr "" +"Die <literal>SessionFactory</literal> wird automatisch an diesen Namen in " +"JNDI gebunden, nachdem sie erstellt wurde." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">e.g.</emphasis> <literal>jndi/composite/name</" +"literal>" +msgstr "" +"<emphasis role=\"strong\">eg.</emphasis><literal>jndi/composite/name</" +"literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<property>hibernate.max_fetch_depth</property>" +msgstr "hibernate.max_fetch_depth" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Sets a maximum \"depth\" for the outer join fetch tree for single-ended " +"associations (one-to-one, many-to-one). A <literal>0</literal> disables " +"default outer join fetching." +msgstr "" +"Stellen Sie eine maximale \"Tiefe\" für den Outer-Join-Fetching-Baum für " +"einendige (\"single-ended\") Assoziationen (\"One-to-One\", \"Many-to-One" +"\"). Eine <literal>0</literal> deaktiviert das standardmäßige Outer-Join-" +"Fetching." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">e.g.</emphasis> recommended values between " +"<literal>0</literal> and <literal>3</literal>" +msgstr "" +"<emphasis role=\"strong\">z.B.</emphasis> empfohlene Werte zwischen " +"<literal>0</literal> und <literal>3</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<property>hibernate.default_batch_fetch_size</property>" +msgstr "hibernate.default_batch_fetch_size" + +#. Tag: para +#, fuzzy, no-c-format +msgid "Sets a default size for Hibernate batch fetching of associations." +msgstr "" +"Stellen Sie eine Standardgröße für den Hibernate Stapelabruf (sog. \"Batch-" +"Fetching\") von Assoziationen ein." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">e.g.</emphasis> recommended values <literal>4</" +"literal>, <literal>8</literal>, <literal>16</literal>" +msgstr "" +"<emphasis role=\"strong\">z.B.</emphasis> empfohlene Werte <literal>4</" +"literal>, <literal>8</literal>, <literal>16</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<property>hibernate.default_entity_mode</property>" +msgstr "hibernate.default_entity_mode" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Sets a default mode for entity representation for all sessions opened from " +"this <literal>SessionFactory</literal>." +msgstr "" +"Wählen Sie einen Standardmodus für die Entity-Repräsentation für alle aus " +"dieser <literal>SessionFactory</literal> geöffneten Sessions." + +#. Tag: para +#, no-c-format +msgid "" +"<literal>dynamic-map</literal>, <literal>dom4j</literal>, <literal>pojo</" +"literal>" +msgstr "" +"<literal>dynamic-map</literal>, <literal>dom4j</literal>, <literal>pojo</" +"literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<property>hibernate.order_updates</property>" +msgstr "hibernate.order_updates" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Forces Hibernate to order SQL updates by the primary key value of the items " +"being updated. This will result in fewer transaction deadlocks in highly " +"concurrent systems." +msgstr "" +"Zwingt Hibernate dazu, SQL-Updates vom primären Kernbegriff der " +"aktualisierten Posten anzufordern. Dies hat eine Verringerung der Anzahl von " +"Transaktionssperren in simultan laufenden Systemen zur Folge." + +#. Tag: para +#, fuzzy, no-c-format +msgid "<property>hibernate.generate_statistics</property>" +msgstr "hibernate.generate_statistics" + +#. Tag: para +#, no-c-format +msgid "" +"If enabled, Hibernate will collect statistics useful for performance tuning." +msgstr "" +"Falls aktiviert, so sammelt Hibernate Statistiken, die bei der " +"Feinabstimmung der Performance von Nutzen sind. " + +#. Tag: para +#, fuzzy, no-c-format +msgid "<property>hibernate.use_identifier_rollback</property>" +msgstr "hibernate.use_identifer_rollback" + +#. Tag: para +#, no-c-format +msgid "" +"If enabled, generated identifier properties will be reset to default values " +"when objects are deleted." +msgstr "" +"Falls aktiviert, so werden die generierten Bezeichner-Properties auf die " +"Standardwerte zurückgesetzt, wenn Objekte gelöscht werden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "<property>hibernate.use_sql_comments</property>" +msgstr "hibernate.use_sql_comments" + +#. Tag: para +#, no-c-format +msgid "" +"If turned on, Hibernate will generate comments inside the SQL, for easier " +"debugging, defaults to <literal>false</literal>." +msgstr "" +"Falls eingeschaltet, generiert Hibernate Kommentare innerhalb der SQL, für " +"eine vereinfachte Fehlersuche. Die Standardeinstellung lautet " +"<literal>false</literal>." + +#. Tag: title +#, no-c-format +msgid "Hibernate JDBC and Connection Properties" +msgstr "Hibernate JDBC- und Connection-Properties" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<property>hibernate.jdbc.fetch_size</property>" +msgstr "hibernate.jdbc.fetch_size" + +#. Tag: para +#, no-c-format +msgid "" +"A non-zero value determines the JDBC fetch size (calls <literal>Statement." +"setFetchSize()</literal>)." +msgstr "" +"Ein Wert ungleich Null bestimmt die Anzahl der JDBC-Datensätze, den so " +"genannten \"Fetch Size\" (ruft <literal>Statement.setFetchSize()</literal> " +"auf)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "<property>hibernate.jdbc.batch_size</property>" +msgstr "hibernate.jdbc.batch_size" + +#. Tag: para +#, no-c-format +msgid "A non-zero value enables use of JDBC2 batch updates by Hibernate." +msgstr "" +"Ein Wert von ungleich Null aktiviert die Verwendung von JDBC2-" +"Stapelaktualisierungen (sog. \"Batch Updates\") durch Hibernate." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">e.g.</emphasis> recommended values between " +"<literal>5</literal> and <literal>30</literal>" +msgstr "" +"<emphasis role=\"strong\">z.B.</emphasis> empfohlene Werte zwischen " +"<literal>5</literal> und <literal>30</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<property>hibernate.jdbc.batch_versioned_data</property>" +msgstr "hibernate.jdbc.batch_versioned_data" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Set this property to <literal>true</literal> if your JDBC driver returns " +"correct row counts from <literal>executeBatch()</literal>. Iit is usually " +"safe to turn this option on. Hibernate will then use batched DML for " +"automatically versioned data. Defaults to <literal>false</literal>." +msgstr "" +"Setzen Sie diese Property auf <literal>true</literal>, falls Ihr JDBC-" +"Treiber korrekte Reihenzählungen von <literal>executeBatch()</literal> " +"zurückschickt (es ist in der Regel sicher, diese Option zu aktivieren). " +"Hibernate verwendet dann gestapelte DML für automatisch versionierte Daten. " +"Die Standardeinstellung lautet hier <literal>false</literal>." + +#. Tag: para +#, fuzzy, no-c-format +msgid "<property>hibernate.jdbc.factory_class</property>" +msgstr "hibernate.jdbc.factory_class" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Select a custom <interfacename>org.hibernate.jdbc.Batcher</interfacename>. " +"Most applications will not need this configuration property." +msgstr "" +"Wählen Sie einen anwenderdefinierten <literal>Batcher</literal>. Die meisten " +"Anwendungen benötigen diese Konfigurationseigenschaft nicht." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">e.g.</emphasis> <literal>classname.of." +"BatcherFactory</literal>" +msgstr "" +"<emphasis role=\"strong\">eg.</emphasis><literal>classname.of.Batcher</" +"literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<property>hibernate.jdbc.use_scrollable_resultset</property>" +msgstr "hibernate.jdbc.use_scrollable_resultset" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Enables use of JDBC2 scrollable resultsets by Hibernate. This property is " +"only necessary when using user-supplied JDBC connections. Hibernate uses " +"connection metadata otherwise." +msgstr "" +"Aktiviert den Gebrauch von JDBC2 scrollbaren Ergebnissätzen (sog. " +"\"scrollable resultsets\") durch Hibernate. Diese Property ist nur bei der " +"Verwendung von Benutzer-gelieferten JDBC-Verbindungen notwendig, Hibernate " +"verwendet Metadaten der Verbindung(en) anders." + +#. Tag: para +#, fuzzy, no-c-format +msgid "<property>hibernate.jdbc.use_streams_for_binary</property>" +msgstr "hibernate.jdbc.use_streams_for_binary" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Use streams when writing/reading <literal>binary</literal> or " +"<literal>serializable</literal> types to/from JDBC. <emphasis>*system-level " +"property*</emphasis>" +msgstr "" +"Verwendet Datenströme (\"Streams\") beim Schreiben/Lesen von " +"<literal>binary</literal> oder <literal>serializable</literal> Typen in/aus " +"JDBC (Property der Systemebene)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "<property>hibernate.jdbc.use_get_generated_keys</property>" +msgstr "hibernate.jdbc.use_get_generated_keys" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Enables use of JDBC3 <literal>PreparedStatement.getGeneratedKeys()</literal> " +"to retrieve natively generated keys after insert. Requires JDBC3+ driver and " +"JRE1.4+, set to false if your driver has problems with the Hibernate " +"identifier generators. By default, it tries to determine the driver " +"capabilities using connection metadata." +msgstr "" +"Aktiviert den Gebrauch von JDBC3 <literal>PreparedStatement.getGeneratedKeys" +"()</literal> um nach Einfügung nativ generierte Schlüssel abzurufen. " +"Erfordert einen JDBC3+ Treiber und JRE1.4+. Setzen Sie es auf \"false\", " +"falls Ihr Treiber Probleme mit den Hibernate Bezeichner-Generatoren hat. In " +"der Standardeinstellung wird versucht unter Verwendung der Verbindungs-" +"Metadaten die Treiberfähigkeiten zu bestimmen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "<emphasis role=\"strong\">e.g.</emphasis> <literal>true|false</literal>" +msgstr "<emphasis role=\"strong\">eg.</emphasis><literal>true|false</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<property>hibernate.connection.provider_class</property>" +msgstr "hibernate.connection.provider_class" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The classname of a custom <interfacename>org.hibernate.connection." +"ConnectionProvider</interfacename> which provides JDBC connections to " +"Hibernate." +msgstr "" +"Der Klassenname eines anwenderdefinierten <literal>ConnectionProvider</" +"literal> der Hibernate JDBC-Verbindungen bereitstellt." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">e.g.</emphasis> <literal>classname.of." +"ConnectionProvider</literal>" +msgstr "" +"<emphasis role=\"strong\">eg.</emphasis><literal>classname.of." +"ConnectionProvider</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<property>hibernate.connection.isolation</property>" +msgstr "hibernate.connection.isolation" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Sets the JDBC transaction isolation level. Check <interfacename>java.sql." +"Connection</interfacename> for meaningful values, but note that most " +"databases do not support all isolation levels and some define additional, " +"non-standard isolations." +msgstr "" +"Stellen Sie die Isolationsebene für JDBC-Transaktion ein. Überprüfen Sie " +"<literal>java.sql.Connection</literal> nach sinnvollen Werten, aber beachten " +"Sie, dass die meisten Datenbanken nicht alle Isolationsebenen unterstützen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "<emphasis role=\"strong\">e.g.</emphasis> <literal>1, 2, 4, 8</literal>" +msgstr "<emphasis role=\"strong\">eg.</emphasis><literal>1, 2, 4, 8</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<property>hibernate.connection.autocommit</property>" +msgstr "hibernate.connection.autocommit" + +#. Tag: para +#, fuzzy, no-c-format +msgid "Enables autocommit for JDBC pooled connections (it is not recommended)." +msgstr "" +"Aktiviert \"autocommit\" für JDBC gepoolte Verbindungen (nicht empfohlen)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "<property>hibernate.connection.release_mode</property>" +msgstr "hibernate.connection.release_mode" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Specifies when Hibernate should release JDBC connections. By default, a JDBC " +"connection is held until the session is explicitly closed or disconnected. " +"For an application server JTA datasource, use <literal>after_statement</" +"literal> to aggressively release connections after every JDBC call. For a " +"non-JTA connection, it often makes sense to release the connection at the " +"end of each transaction, by using <literal>after_transaction</literal>. " +"<literal>auto</literal> will choose <literal>after_statement</literal> for " +"the JTA and CMT transaction strategies and <literal>after_transaction</" +"literal> for the JDBC transaction strategy." +msgstr "" +"Legen Sie fest, wann Hibernate JDBC-Verbindungen freigibt. In der " +"Standardeinstellung wird eine JDBC-Verbindung gehalten bis die Session " +"ausdrücklich geschlossen oder die Verbindung getrennt wird. Für eine " +"Applikationsserver JTA-Datenquelle sollten Sie <literal>after_statement</" +"literal> verwenden, um Verbindungen nach jedem JDBC-Aufruf aktiv " +"freizugeben. Für eine nicht-JTA-Verbindung ist es oft sinnvoll, die " +"Verbindung am Ende jeder Transaktion mittels <literal>after_transaction</" +"literal> freizugeben. <literal>auto</literal> wählt " +"<literal>after_statement</literal> für die JTA- und CMT-" +"Transaktionsstrategien und <literal>after_transaction</literal> für die JDBC-" +"Transaktionsstrategie." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">e.g.</emphasis> <literal>auto</literal> (default) " +"| <literal>on_close</literal> | <literal>after_transaction</literal> | " +"<literal>after_statement</literal>" +msgstr "" +"<emphasis role=\"strong\">eg.</emphasis><literal>auto</literal> (default) | " +"<literal>on_close</literal> | <literal>after_transaction</literal> | " +"<literal>after_statement</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This setting only affects <literal>Session</literal>s returned from " +"<literal>SessionFactory.openSession</literal>. For <literal>Session</" +"literal>s obtained through <literal>SessionFactory.getCurrentSession</" +"literal>, the <literal>CurrentSessionContext</literal> implementation " +"configured for use controls the connection release mode for those " +"<literal>Session</literal>s. See <xref linkend=\"architecture-current-session" +"\" />" +msgstr "" +"Bitte beachten Sie, dass diese Einstellung nur <literal>Session</literal>s " +"betrifft, die von der <literal>SessionFactory.openSession</literal> " +"zurückgeführt werden. Für durch <literal>SessionFactory.getCurrentSession</" +"literal> erhaltene <literal>Session</literal>s steuert die für den Gebrauch " +"konfigurierte <literal>CurrentSessionContext</literal>-Implementierung den " +"Freigabemodus dieser <literal>Session</literal>s. Siehe <xref linkend=" +"\"architecture-current-session\"/>." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<property>hibernate.connection.</property><emphasis><propertyName></" +"emphasis>" +msgstr "hibernate.connection.<propertyName>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Pass the JDBC property <emphasis><propertyName></emphasis> to " +"<literal>DriverManager.getConnection()</literal>." +msgstr "" +"Geben Sie die JDBC-Property <literal>propertyName</literal> an den " +"<literal>DriverManager.getConnection()</literal>." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<property>hibernate.jndi.</property><emphasis><propertyName></emphasis>" +msgstr "" +"wie System-Properties mit <literal>-D</literal><emphasis><property></" +"emphasis>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Pass the property <emphasis><propertyName></emphasis> to the JNDI " +"<literal>InitialContextFactory</literal>." +msgstr "" +"Geben Sie die Property <literal>propertyName</literal> an die JNDI " +"<literal>InitialContextFactory</literal>." + +#. Tag: title +#, no-c-format +msgid "Hibernate Cache Properties" +msgstr "Hibernate Cache-Properties" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>hibernate.cache.provider_class</literal>" +msgstr "hibernate.cache.provider_class" + +#. Tag: para +#, no-c-format +msgid "The classname of a custom <literal>CacheProvider</literal>." +msgstr "" +"Der Klassenname eines anwenderdefinierten <literal>CacheProvider</literal>." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">e.g.</emphasis> <literal>classname.of." +"CacheProvider</literal>" +msgstr "" +"<emphasis role=\"strong\">eg.</emphasis><literal>classname.of.CacheProvider</" +"literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>hibernate.cache.use_minimal_puts</literal>" +msgstr "hibernate.cache.use_minimal_puts" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Optimizes second-level cache operation to minimize writes, at the cost of " +"more frequent reads. This setting is most useful for clustered caches and, " +"in Hibernate3, is enabled by default for clustered cache implementations." +msgstr "" +"Optimieren Sie den Betrieb des Cachespeichers auf der zweiten Ebene, um " +"\"Writes\" auf Kosten häufigerer \"Reads\" zu minimieren. Diese Einstellung " +"ist vor allem für geclusterte Caches sinnvoll und ist bei Hibernate3 " +"standardmäßig für geclusterte Cache-Implementierungen aktiviert." + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>hibernate.cache.use_query_cache</literal>" +msgstr "hibernate.cache.use_query_cache" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Enables the query cache. Individual queries still have to be set cachable." +msgstr "" +"Aktivieren Sie das Anfragen-Cache, Einzelanfragen müssen nach wie vor als " +"speicherbar eingestellt sein." + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>hibernate.cache.use_second_level_cache</literal>" +msgstr "hibernate.cache.use_second_level_cache" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Can be used to completely disable the second level cache, which is enabled " +"by default for classes which specify a <literal><cache></literal> " +"mapping." +msgstr "" +"Kann verwendet werden, um ein Cache der zweiten Ebene vollständig zu " +"deaktivieren, das für Klassen mit einem <literal><cache></literal>-" +"Mapping standardmäßig aktiviert ist." + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>hibernate.cache.query_cache_factory</literal>" +msgstr "hibernate.cache.query_cache_factory" + +#. Tag: para +#, no-c-format +msgid "" +"The classname of a custom <literal>QueryCache</literal> interface, defaults " +"to the built-in <literal>StandardQueryCache</literal>." +msgstr "" +"Der Klassenname eines anwenderdefinierten <literal>QueryCache</literal>-" +"Interface, Standard ist das eingebaute <literal>StandardQueryCache</literal>." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">e.g.</emphasis> <literal>classname.of.QueryCache</" +"literal>" +msgstr "" +"<emphasis role=\"strong\">eg.</emphasis><literal>classname.of.QueryCache</" +"literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>hibernate.cache.region_prefix</literal>" +msgstr "hibernate.cache.region_prefix" + +#. Tag: para +#, no-c-format +msgid "A prefix to use for second-level cache region names." +msgstr "Ein für Cache-Bereiche der zweiten Ebene zu verwendender Präfix." + +#. Tag: para +#, fuzzy, no-c-format +msgid "<emphasis role=\"strong\">e.g.</emphasis> <literal>prefix</literal>" +msgstr "<emphasis role=\"strong\">eg.</emphasis><literal>prefix</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>hibernate.cache.use_structured_entries</literal>" +msgstr "hibernate.cache.use_structured_entries" + +#. Tag: para +#, no-c-format +msgid "" +"Forces Hibernate to store data in the second-level cache in a more human-" +"friendly format." +msgstr "" +"Bringt Hibernate dazu, Daten im Cachespeicher der zweiten Ebene in einer für " +"den Benutzer freundlicheren Art zu speichern." + +#. Tag: title +#, no-c-format +msgid "Hibernate Transaction Properties" +msgstr "Hibernate Transaktions-Properties" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>hibernate.transaction.factory_class</literal>" +msgstr "hibernate.transaction.factory_class" + +#. Tag: para +#, no-c-format +msgid "" +"The classname of a <literal>TransactionFactory</literal> to use with " +"Hibernate <literal>Transaction</literal> API (defaults to " +"<literal>JDBCTransactionFactory</literal>)." +msgstr "" +"Der Klassenname einer <literal>TransactionFactory</literal>, der mit der " +"Hibernate <literal>Transaction</literal> API " +"(Anwenderprogrammierschnittstelle) zu verwenden ist (standardmäßig " +"<literal>JDBCTransactionFactory</literal>)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">e.g.</emphasis> <literal>classname.of." +"TransactionFactory</literal>" +msgstr "" +"<emphasis role=\"strong\">eg.</emphasis><literal>classname.of." +"TransactionFactory</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>jta.UserTransaction</literal>" +msgstr "jta.UserTransaction" + +#. Tag: para +#, no-c-format +msgid "" +"A JNDI name used by <literal>JTATransactionFactory</literal> to obtain the " +"JTA <literal>UserTransaction</literal> from the application server." +msgstr "" +"Ein von der <literal>JTATransactionFactory</literal> zum Erhalt der JTA " +"<literal>UserTransaction</literal> vom Applikationsserver verwendeter JNDI-" +"Name." + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>hibernate.transaction. manager_lookup_class</literal>" +msgstr "hibernate.transaction.manager_lookup_class" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The classname of a <literal>TransactionManagerLookup</literal>. It is " +"required when JVM-level caching is enabled or when using hilo generator in a " +"JTA environment." +msgstr "" +"Der Klassenname eines <literal>TransactionManagerLookup</literal> - " +"erforderlich, wenn das Caching auf JVM-Ebene aktiviert ist oder wenn in " +"einer JTA-Umgebung ein Hilo-Generator verwendet wird." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">e.g.</emphasis> <literal>classname.of." +"TransactionManagerLookup</literal>" +msgstr "" +"<emphasis role=\"strong\">eg.</emphasis><literal>classname.of." +"TransactionManagerLookup</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>hibernate.transaction. flush_before_completion</literal>" +msgstr "hibernate.transaction.flush_before_completion" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If enabled, the session will be automatically flushed during the before " +"completion phase of the transaction. Built-in and automatic session context " +"management is preferred, see <xref linkend=\"architecture-current-session\" /" +">." +msgstr "" +"Falls aktiviert, wird die Session automatisch während der Vorabschlussphase " +"der Transaktion geräumt. Eingebautes, automatisches Session-" +"Kontextmanagement wird bevorzugt, siehe <xref linkend=\"architecture-" +"current-session\"/>." + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>hibernate.transaction. auto_close_session</literal>" +msgstr "hibernate.transaction.auto_close_session" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If enabled, the session will be automatically closed during the after " +"completion phase of the transaction. Built-in and automatic session context " +"management is preferred, see <xref linkend=\"architecture-current-session\" /" +">." +msgstr "" +"Falls aktiviert, wird die Session während der Nachabschlussphase automatisch " +"geschlossen. Eingebautes, automatisches Session-Kontextmanagement wird " +"bevorzugt, siehe <xref linkend=\"architecture-current-session\"/>." + +#. Tag: title +#, no-c-format +msgid "Miscellaneous Properties" +msgstr "Verschiedene Properties" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>hibernate. current_session_context_class</literal>" +msgstr "hibernate.current_session_context_class" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Supply a custom strategy for the scoping of the \"current\" " +"<literal>Session</literal>. See <xref linkend=\"architecture-current-session" +"\" /> for more information about the built-in strategies." +msgstr "" +"Geben Sie eine (anwenderdefinierte) Strategie für den Gültigkeitsbereich der " +"\"aktuellen\" <literal>Session</literal> ein. Weitere Informationen zu " +"eingebauten Strategien finden Sie unter <xref linkend=\"architecture-" +"current-session\"/>." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">e.g.</emphasis> <literal>jta</literal> | " +"<literal>thread</literal> | <literal>managed</literal> | <literal>custom." +"Class</literal>" +msgstr "" +"<emphasis role=\"strong\">eg.</emphasis><literal>jta</literal> | " +"<literal>thread</literal> | <literal>managed</literal> | <literal>custom." +"Class</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>hibernate.query.factory_class</literal>" +msgstr "hibernate.query.factory_class" + +#. Tag: para +#, no-c-format +msgid "Chooses the HQL parser implementation." +msgstr "Wählt die Implemetierung des HQL-Parsers (Analysealgorithmus)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">e.g.</emphasis> <literal>org.hibernate.hql.ast." +"ASTQueryTranslatorFactory</literal> or <literal>org.hibernate.hql.classic." +"ClassicQueryTranslatorFactory</literal>" +msgstr "" +"<emphasis role=\"strong\">eg.</emphasis><literal>org.hibernate.hql.ast." +"ASTQueryTranslatorFactory</literal> or <literal>org.hibernate.hql.classic." +"ClassicQueryTranslatorFactory</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>hibernate.query.substitutions</literal>" +msgstr "hibernate.query.substitutions" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Is used to map from tokens in Hibernate queries to SQL tokens (tokens might " +"be function or literal names, for example)." +msgstr "" +"Mapping von \"Tokens\" in Hibernate-Anfragen zu SQL-Tokens (Tokens können z." +"B. Funktions- oder Literalnamen sein)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">e.g.</emphasis> <literal>hqlLiteral=SQL_LITERAL, " +"hqlFunction=SQLFUNC</literal>" +msgstr "" +"<emphasis role=\"strong\">eg.</emphasis><literal>hqlLiteral=SQL_LITERAL, " +"hqlFunction=SQLFUNC</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>hibernate.hbm2ddl.auto</literal>" +msgstr "hibernate.hbm2ddl.auto" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Automatically validates or exports schema DDL to the database when the " +"<literal>SessionFactory</literal> is created. With <literal>create-drop</" +"literal>, the database schema will be dropped when the " +"<literal>SessionFactory</literal> is closed explicitly." +msgstr "" +"Automatische Validierung oder Export der Schema-DDL zur Datenbank, wenn die " +"<literal>SessionFactory</literal> erstellt wird. Mit <literal>create-drop</" +"literal> wird das Datenbankschema eingestellt, wenn die " +"<literal>SessionFactory</literal> explizit geschlossen wird." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">e.g.</emphasis> <literal>validate</literal> | " +"<literal>update</literal> | <literal>create</literal> | <literal>create-" +"drop</literal>" +msgstr "" +"<emphasis role=\"strong\">eg.</emphasis><literal>validate</literal> | " +"<literal>update</literal> | <literal>create</literal> | <literal>create-" +"drop</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>hibernate.cglib. use_reflection_optimizer</literal>" +msgstr "hibernate.cglib.use_reflection_optimizer" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Enables the use of CGLIB instead of runtime reflection (System-level " +"property). Reflection can sometimes be useful when troubleshooting. " +"Hibernate always requires CGLIB even if you turn off the optimizer. You " +"cannot set this property in <literal>hibernate.cfg.xml</literal>." +msgstr "" +"Aktiviert die Benutzung von CGLIB anstelle von \"Runtime-Reflection" +"\" (Property der Systemebene). Reflection kann bei der Fehlersuche von " +"Nutzen sein. Bitte beachten Sie, dass Hibernate immer CGLIB benötigt, selbst " +"wenn der Optimierer ausgeschaltet ist. Diese Property kann nicht in " +"<literal>hibernate.cfg.xml</literal> eingestellt werden." + +#. Tag: title +#, no-c-format +msgid "SQL Dialects" +msgstr "SQL-Dialekte" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Always set the <literal>hibernate.dialect</literal> property to the correct " +"<literal>org.hibernate.dialect.Dialect</literal> subclass for your database. " +"If you specify a dialect, Hibernate will use sensible defaults for some of " +"the other properties listed above. This means that you will not have to " +"specify them manually." +msgstr "" +"Die <literal>hibernate.dialect</literal>-Property sollte stets auf die " +"richtige <literal>org.hibernate.dialect.Dialect</literal>-Subklasse für Ihre " +"Datenbank eingestellt sein. Falls Sie einen Dialekt festlegen, so verwendet " +"Hibernate vernünftige Standardeinstellungen für einige der anderen oben " +"aufgeführten Properties, so dass Ihnen deren manuelle Einstellung erspart " +"bleibt." + +#. Tag: title +#, no-c-format +msgid "Hibernate SQL Dialects (<literal>hibernate.dialect</literal>)" +msgstr "Hibernate SQL-Dialekte (<literal>hibernate.dialect</literal>)" + +#. Tag: para +#, no-c-format +msgid "RDBMS" +msgstr "RDBMS" + +#. Tag: para +#, no-c-format +msgid "Dialect" +msgstr "Dialekt" + +#. Tag: para +#, no-c-format +msgid "DB2" +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.dialect.DB2Dialect</literal>" +msgstr "org.hibernate.dialect.DB2Dialect" + +#. Tag: para +#, no-c-format +msgid "DB2 AS/400" +msgstr "DB2 AS/400" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.dialect.DB2400Dialect</literal>" +msgstr "org.hibernate.dialect.DB2400Dialect" + +#. Tag: para +#, no-c-format +msgid "DB2 OS390" +msgstr "DB2 OS390" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.dialect.DB2390Dialect</literal>" +msgstr "org.hibernate.dialect.DB2390Dialect" + +#. Tag: para +#, no-c-format +msgid "PostgreSQL" +msgstr "PostgreSQL" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.dialect.PostgreSQLDialect</literal>" +msgstr "org.hibernate.dialect.PostgreSQLDialect" + +#. Tag: para +#, no-c-format +msgid "MySQL" +msgstr "MySQL" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.dialect.MySQLDialect</literal>" +msgstr "org.hibernate.dialect.MySQLDialect" + +#. Tag: para +#, no-c-format +msgid "MySQL with InnoDB" +msgstr "MySQL mit InnoDB" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.dialect.MySQLInnoDBDialect</literal>" +msgstr "org.hibernate.dialect.MySQLInnoDBDialect" + +#. Tag: para +#, no-c-format +msgid "MySQL with MyISAM" +msgstr "MySQL mit MyISAM" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.dialect.MySQLMyISAMDialect</literal>" +msgstr "org.hibernate.dialect.MySQLMyISAMDialect" + +#. Tag: para +#, no-c-format +msgid "Oracle (any version)" +msgstr "Oracle (alle Versionen)" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.dialect.OracleDialect</literal>" +msgstr "org.hibernate.dialect.OracleDialect" + +#. Tag: para +#, no-c-format +msgid "Oracle 9i" +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.dialect.Oracle9iDialect</literal>" +msgstr "org.hibernate.dialect.OracleDialect" + +#. Tag: para +#, no-c-format +msgid "Oracle 10g" +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.dialect.Oracle10gDialect</literal>" +msgstr "org.hibernate.dialect.OracleDialect" + +#. Tag: para +#, no-c-format +msgid "Sybase" +msgstr "Sybase" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.dialect.SybaseDialect</literal>" +msgstr "org.hibernate.dialect.SybaseDialect" + +#. Tag: para +#, no-c-format +msgid "Sybase Anywhere" +msgstr "Sybase Anywhere" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.dialect.SybaseAnywhereDialect</literal>" +msgstr "org.hibernate.dialect.SybaseAnywhereDialect" + +#. Tag: para +#, no-c-format +msgid "Microsoft SQL Server" +msgstr "Microsoft SQL-Server" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.dialect.SQLServerDialect</literal>" +msgstr "org.hibernate.dialect.SQLServerDialect" + +#. Tag: para +#, no-c-format +msgid "SAP DB" +msgstr "SAP DB" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.dialect.SAPDBDialect</literal>" +msgstr "org.hibernate.dialect.SAPDBDialect" + +#. Tag: para +#, no-c-format +msgid "Informix" +msgstr "Informix" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.dialect.InformixDialect</literal>" +msgstr "org.hibernate.dialect.InformixDialect" + +#. Tag: para +#, no-c-format +msgid "HypersonicSQL" +msgstr "HypersonicSQL" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.dialect.HSQLDialect</literal>" +msgstr "org.hibernate.dialect.HSQLDialect" + +#. Tag: para +#, no-c-format +msgid "Ingres" +msgstr "Ingres" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.dialect.IngresDialect</literal>" +msgstr "org.hibernate.dialect.IngresDialect" + +#. Tag: para +#, no-c-format +msgid "Progress" +msgstr "Progress" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.dialect.ProgressDialect</literal>" +msgstr "org.hibernate.dialect.ProgressDialect" + +#. Tag: para +#, no-c-format +msgid "Mckoi SQL" +msgstr "Mckoi SQL" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.dialect.MckoiDialect</literal>" +msgstr "org.hibernate.dialect.MckoiDialect" + +#. Tag: para +#, no-c-format +msgid "Interbase" +msgstr "Interbase" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.dialect.InterbaseDialect</literal>" +msgstr "org.hibernate.dialect.InterbaseDialect" + +#. Tag: para +#, no-c-format +msgid "Pointbase" +msgstr "Pointbase" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.dialect.PointbaseDialect</literal>" +msgstr "org.hibernate.dialect.PointbaseDialect" + +#. Tag: para +#, no-c-format +msgid "FrontBase" +msgstr "FrontBase" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.dialect.FrontbaseDialect</literal>" +msgstr "org.hibernate.dialect.FrontbaseDialect" + +#. Tag: para +#, no-c-format +msgid "Firebird" +msgstr "Firebird" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.dialect.FirebirdDialect</literal>" +msgstr "org.hibernate.dialect.FirebirdDialect" + +#. Tag: title +#, no-c-format +msgid "Outer Join Fetching" +msgstr "\"Outer-Join-Fetching\"" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If your database supports ANSI, Oracle or Sybase style outer joins, " +"<emphasis>outer join fetching</emphasis> will often increase performance by " +"limiting the number of round trips to and from the database. This is, " +"however, at the cost of possibly more work performed by the database itself. " +"Outer join fetching allows a whole graph of objects connected by many-to-" +"one, one-to-many, many-to-many and one-to-one associations to be retrieved " +"in a single SQL <literal>SELECT</literal>." +msgstr "" +"Falls Ihre Datenbank \"Outer-Joins\" (äußere Verbünde) nach Art von ANSI, " +"Oracle oder Sybase unterstützt, so wird so genanntes <emphasis>Outer Join " +"Fetching</emphasis> oftmals die Performance verbessern, indem es die Anzahl " +"der Hin- und Rücksendungen zu und von der Datenbank reduziert (wobei dann " +"möglicherweise von der Datenbank selbst mehr Arbeit übernommen wird). " +"\"Outer-Join-Fetching\" erlaubt es, einen kompletten Graph von Objekten " +"mittels \"Many-to-One\"-, \"One-to-Many\"-, \"Many-to-Many\"- und \"One-to-" +"One\"-Assoziationen in einer einzelnen SQL <literal>SELECT</literal> " +"aufzurufen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Outer join fetching can be disabled <emphasis>globally</emphasis> by setting " +"the property <literal>hibernate.max_fetch_depth</literal> to <literal>0</" +"literal>. A setting of <literal>1</literal> or higher enables outer join " +"fetching for one-to-one and many-to-one associations that have been mapped " +"with <literal>fetch=\"join\"</literal>." +msgstr "" +"\"Outer-Join-Fetching\" kann <emphasis>allgemeingültig</emphasis> " +"deaktiviert werden, wenn man die Property <literal>hibernate." +"max_fetch_depth</literal> auf <literal>0</literal> setzt. Eine Einstellung " +"von <literal>1</literal> oder mehr aktiviert Outer-Join-Fetching für mit " +"<literal>fetch=\"join\"</literal> gemappte \"One-to-One\"- und \"Many-to-One" +"\"-Assoziationen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "See <xref linkend=\"performance-fetching\" /> for more information." +msgstr "" +"Weitere Informationen finden Sie unter <xref linkend=\"performance-fetching" +"\"/>." + +#. Tag: title +#, no-c-format +msgid "Binary Streams" +msgstr "Binäre Datenströme " + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Oracle limits the size of <literal>byte</literal> arrays that can be passed " +"to and/or from its JDBC driver. If you wish to use large instances of " +"<literal>binary</literal> or <literal>serializable</literal> type, you " +"should enable <literal>hibernate.jdbc.use_streams_for_binary</literal>. " +"<emphasis>This is a system-level setting only.</emphasis>" +msgstr "" +"Oracle begrenzt die Größe von <literal>byte</literal>-Arrays, die zu/von " +"seinem JDBC-Treiber geleitet werden können. Falls Sie große Instanzen des " +"<literal>binary</literal> oder <literal>serializable</literal>-Typs " +"verwenden wollen, sollten Sie <literal>hibernate.jdbc." +"use_streams_for_binary</literal> aktivieren. <emphasis>Diese Einstellung " +"gilt ausschließlich für die Systemebene.</emphasis>" + +#. Tag: title +#, no-c-format +msgid "Second-level and query cache" +msgstr "Zweite Ebene und Anfragen-Cache" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The properties prefixed by <literal>hibernate.cache</literal> allow you to " +"use a process or cluster scoped second-level cache system with Hibernate. " +"See the <xref linkend=\"performance-cache\" /> for more information." +msgstr "" +"Die Properties mit dem Präfix <literal>hibernate.cache</literal> erlauben " +"die Verwendung eines prozess- oder clusterbegrenzten Cache-Systems der " +"zweiten Ebene. Weitere Informationen dazu finden Sie unter <xref linkend=" +"\"performance-cache\"/>." + +#. Tag: title +#, no-c-format +msgid "Query Language Substitution" +msgstr "\"Query Language Substitution\"" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can define new Hibernate query tokens using <literal>hibernate.query." +"substitutions</literal>. For example:" +msgstr "" +"Sie können neue Hibernate Anfrage-\"Tokens\" mittels <literal>hibernate." +"query.substitutions</literal> definieren. Zum Beispiel:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This would cause the tokens <literal>true</literal> and <literal>false</" +"literal> to be translated to integer literals in the generated SQL." +msgstr "" +"würde eine Übersetzung der Tokens <literal>true</literal> und " +"<literal>false</literal> in ganzzahlige Literale in der generierten SQL mit " +"sich bringen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This would allow you to rename the SQL <literal>LOWER</literal> function." +msgstr "" +"ermöglicht Ihnen die Umbenennung der SQL <literal>LOWER</literal>-Funktion." + +#. Tag: title +#, no-c-format +msgid "Hibernate statistics" +msgstr "Die Hibernate Statistik" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If you enable <literal>hibernate.generate_statistics</literal>, Hibernate " +"exposes a number of metrics that are useful when tuning a running system via " +"<literal>SessionFactory.getStatistics()</literal>. Hibernate can even be " +"configured to expose these statistics via JMX. Read the Javadoc of the " +"interfaces in <literal>org.hibernate.stats</literal> for more information." +msgstr "" +"Ist <literal>hibernate.generate_statistics</literal> aktiviert, so stellt " +"Hibernate mittels <literal>SessionFactory.getStatistics()</literal> eine " +"Reihe von Metriken aus, die bei der Abstimmung eines laufenden Systems " +"hilfreich sind. Hibernate kann sogar so konfiguriert werden, dass es via JMX " +"diese Statistik darstellt. Weitere Informationen dazu finden Sie im Javadoc " +"der Interfaces <literal>org.hibernate.stats</literal>." + +#. Tag: title +#, no-c-format +msgid "Logging" +msgstr "Protokollierung" + +#. Tag: para +#, no-c-format +msgid "" +"Hibernate utilizes <ulink url=\"http://www.slf4j.org/\">Simple Logging " +"Facade for Java</ulink> (SLF4J) in order to log various system events. SLF4J " +"can direct your logging output to several logging frameworks (NOP, Simple, " +"log4j version 1.2, JDK 1.4 logging, JCL or logback) depending on your chosen " +"binding. In order to setup logging you will need <filename>slf4j-api.jar</" +"filename> in your classpath together with the jar file for your preferred " +"binding - <filename>slf4j-log4j12.jar</filename> in the case of Log4J. See " +"the SLF4J <ulink url=\"http://www.slf4j.org/manual.html\">documentation</" +"ulink> for more detail. To use Log4j you will also need to place a " +"<filename>log4j.properties</filename> file in your classpath. An example " +"properties file is distributed with Hibernate in the <literal>src/</literal> " +"directory." +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"It is recommended that you familiarize yourself with Hibernate's log " +"messages. A lot of work has been put into making the Hibernate log as " +"detailed as possible, without making it unreadable. It is an essential " +"troubleshooting device. The most interesting log categories are the " +"following:" +msgstr "" +"Wir empfehlen Ihnen dringend, sich mit den Protokollnachrichten von " +"Hibernate vertraut zu machen. Es wurde viel Arbeit investiert, um das " +"Protokoll von Hibernate möglichst detailliert zu gestalten und gleichzeitig " +"dessen Lesbarkeit zu erhalten. Es ist eine bedeutende Hilfe bei der " +"Fehlerbehebung. Die wichtigsten Protokollkategorien lauten:" + +#. Tag: title +#, no-c-format +msgid "Hibernate Log Categories" +msgstr "Die Protokollkategorien von Hibernate" + +#. Tag: para +#, no-c-format +msgid "Category" +msgstr "Kategorie" + +#. Tag: para +#, no-c-format +msgid "Function" +msgstr "Funktion" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.SQL</literal>" +msgstr "org.hibernate.SQL" + +#. Tag: para +#, no-c-format +msgid "Log all SQL DML statements as they are executed" +msgstr "Protokollierung aller SQL DML-Anweisungen bei deren Ausführung" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.type</literal>" +msgstr "org.hibernate.type" + +#. Tag: para +#, no-c-format +msgid "Log all JDBC parameters" +msgstr "Protokollierung aller JDBC-Parameter" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.tool. hbm2ddl</literal>" +msgstr "org.hibernate.tool.hbm2ddl" + +#. Tag: para +#, no-c-format +msgid "Log all SQL DDL statements as they are executed" +msgstr "Protokollierung aller SQL DDL-Anweisungen bei deren Ausführung" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.pretty</literal>" +msgstr "org.hibernate.pretty" + +#. Tag: para +#, no-c-format +msgid "" +"Log the state of all entities (max 20 entities) associated with the session " +"at flush time" +msgstr "" +"Protokollierung des Status aller Entities (max. 20 Entities) die zum " +"Räumungzeitpunkt mit der Session assoziiert werden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.cache</literal>" +msgstr "org.hibernate.cache" + +#. Tag: para +#, no-c-format +msgid "Log all second-level cache activity" +msgstr "Protokollierung aller Cache-Vorgänge der zweiten Ebene" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate. transaction</literal>" +msgstr "org.hibernate.transaction" + +#. Tag: para +#, no-c-format +msgid "Log transaction related activity" +msgstr "Protokollierung von transaktionsbezogenen Vorgänge" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.jdbc</literal>" +msgstr "org.hibernate.jdbc" + +#. Tag: para +#, no-c-format +msgid "Log all JDBC resource acquisition" +msgstr "Protokollierung sämtlicher JDBC-Ressourcen-Erfassungen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.hql. ast.AST</literal>" +msgstr "org.hibernate.hql.ast.AST" + +#. Tag: para +#, no-c-format +msgid "Log HQL and SQL ASTs during query parsing" +msgstr "Protokollierung von HQL und SQL ASTs während Abfragen-Parsing" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.secure</literal>" +msgstr "org.hibernate.secure" + +#. Tag: para +#, no-c-format +msgid "Log all JAAS authorization requests" +msgstr "Protokollierung aller JAAS-Authentifizierungsanfragen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>org.hibernate</literal>" +msgstr "JNDI-gebundene SessionFactory" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Log everything. This is a lot of information but it is useful for " +"troubleshooting" +msgstr "" +"Vollständige Protokollierung (sehr viele Informationen, aber sehr hilfreich " +"bei der Fehlerbehebung)" + +#. Tag: para +#, no-c-format +msgid "" +"When developing applications with Hibernate, you should almost always work " +"with <literal>debug</literal> enabled for the category <literal>org." +"hibernate.SQL</literal>, or, alternatively, the property <literal>hibernate." +"show_sql</literal> enabled." +msgstr "" +"Bei der Entwicklung von Anwendungen mit Hibernate sollten Sie fast " +"ausschließlich mit der aktivierten <literal>debug</literal>-Einstellung für " +"die Kategorie <literal>org.hibernate.SQL</literal> arbeiten oder alternativ " +"mit der aktivierten Property <literal>hibernate.show_sql</literal>." + +#. Tag: title +#, fuzzy, no-c-format +msgid "Implementing a <literal>NamingStrategy</literal>" +msgstr "wählen Sie eine <literal>NamingStrategy</literal>" + +#. Tag: para +#, no-c-format +msgid "" +"The interface <literal>org.hibernate.cfg.NamingStrategy</literal> allows you " +"to specify a \"naming standard\" for database objects and schema elements." +msgstr "" +"Das Interface <literal>org.hibernate.cfg.NamingStrategy</literal> ermöglicht " +"es Ihnen einen Namensgebungsstandard (sog. \"naming standard\") für " +"Datenbankobjekte und Schema-Elemente zu bestimmen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can provide rules for automatically generating database identifiers from " +"Java identifiers or for processing \"logical\" column and table names given " +"in the mapping file into \"physical\" table and column names. This feature " +"helps reduce the verbosity of the mapping document, eliminating repetitive " +"noise (<literal>TBL_</literal> prefixes, for example). The default strategy " +"used by Hibernate is quite minimal." +msgstr "" +"Sie können Regeln für die automatische Generierung von Datenbank-Bezeichnern " +"aus Java-Bezeichnern oder für die Bearbeitung von gegebenen \"logischen\" " +"Spalten- und Tabellennamen der Mapping-Datei in \"physische\" Tabellen- und " +"Spaltennamen entwerfen. Dieses Feature kann bei der Reduktion der Verbosität " +"des Mapping-Dokuments helfen, indem es die unnötige, sich wiederholende " +"Ausgabe von Daten eleminiert (zum Beispiel <literal>TBL_</literal> Präfixe). " +"Die von Hibernate verwendete Standardstrategie ist recht minimal." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can specify a different strategy by calling <literal>Configuration." +"setNamingStrategy()</literal> before adding mappings:" +msgstr "" +"Mit dem Aufruf <literal>Configuration.setNamingStrategy()</literal> können " +"Sie eine andere Strategie festlegen, ehe Sie Mappings hinzufügen:" + +#. Tag: para +#, no-c-format +msgid "" +"<literal>org.hibernate.cfg.ImprovedNamingStrategy</literal> is a built-in " +"strategy that might be a useful starting point for some applications." +msgstr "" +"Bei <literal>org.hibernate.cfg.ImprovedNamingStrategy</literal> handelt es " +"sich um eine eingebaute Strategie, die beim Startpunkt einiger Anwendungen " +"von Nutzen sein kann." + +#. Tag: title +#, no-c-format +msgid "XML configuration file" +msgstr "XML-Konfigurationsdatei" + +#. Tag: para +#, no-c-format +msgid "" +"An alternative approach to configuration is to specify a full configuration " +"in a file named <literal>hibernate.cfg.xml</literal>. This file can be used " +"as a replacement for the <literal>hibernate.properties</literal> file or, if " +"both are present, to override properties." +msgstr "" +"Eine andere Konfigurationsmöglichkeit ist die Spezifizierung einer " +"vollständigen Konfigurationsdatei mit dem Namen <literal>hibernate.cfg.xml</" +"literal>. Diese Datei kann als Ersatz für die <literal>hibernate.properties</" +"literal>-Datei dienen oder - falls beide vorhanden sind - Properties außer " +"Kraft setzen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The XML configuration file is by default expected to be in the root of your " +"<literal>CLASSPATH</literal>. Here is an example:" +msgstr "" +"Die XML-Konfigurationsdatei ist in der Standardeinstellung in der Regel im " +"Stammverzeichnis Ihres <literal>CLASSPATH</literal>. Nachfolgend sehen Sie " +"ein Beispiel:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The advantage of this approach is the externalization of the mapping file " +"names to configuration. The <literal>hibernate.cfg.xml</literal> is also " +"more convenient once you have to tune the Hibernate cache. It is your choice " +"to use either <literal>hibernate.properties</literal> or <literal>hibernate." +"cfg.xml</literal>. Both are equivalent, except for the above mentioned " +"benefits of using the XML syntax." +msgstr "" +"Wie Sie sehen, liegt der Vorteil dieser Herangehensweise in der " +"Externalisierung der Mapping-Dateinamen zu Konfiguration. Außerdem ist " +"<literal>hibernate.cfg.xml</literal> praktisch für die Abstimmung des " +"Hibernate Cachespeichers. Bitte beachten Sie, dass Sie die Auswahl zwischen " +"der Verwendung von <literal>hibernate.properties</literal> oder " +"<literal>hibernate.cfg.xml</literal> haben. Diese sind abgesehen vom " +"bereitserwähnten Vorteil durch die Benutzung der XML-Syntax gleichwertig." + +#. Tag: para +#, fuzzy, no-c-format +msgid "With the XML configuration, starting Hibernate is then as simple as:" +msgstr "" +"Mit der XML-Konfiguration wird der Start von Hibernate dann ganz einfach mit" + +#. Tag: para +#, fuzzy, no-c-format +msgid "You can select a different XML configuration file using:" +msgstr "Die Wahl einer anderen XML-Konfigurationsdatei erfolgt mittels" + +#. Tag: title +#, no-c-format +msgid "J2EE Application Server integration" +msgstr "Integration des J2EE-Applikationsservers" + +#. Tag: para +#, no-c-format +msgid "Hibernate has the following integration points for J2EE infrastructure:" +msgstr "" +"Hibernate besitzt die folgenden Intergrationspunkte für die J2EE " +"Infrastruktur:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis>Container-managed datasources</emphasis>: Hibernate can use JDBC " +"connections managed by the container and provided through JNDI. Usually, a " +"JTA compatible <literal>TransactionManager</literal> and a " +"<literal>ResourceManager</literal> take care of transaction management " +"(CMT), especially distributed transaction handling across several " +"datasources. You can also demarcate transaction boundaries programmatically " +"(BMT), or you might want to use the optional Hibernate <literal>Transaction</" +"literal> API for this to keep your code portable." +msgstr "" +"<emphasis>Containerverwaltete Datenquellen</emphasis>: Hibernate kann vom " +"Container verwaltete und von JNDI bereitgestellte JDBC-Verbindungen " +"verwenden. In der Regel besorgen ein JTA-kompatibler " +"<literal>TransactionManager</literal> und ein <literal>ResourceManager</" +"literal> das Transaktionsmanagement (CMT), insbesondere die verteilte " +"Transaktionsbearbeitung über mehrere Datenquellen hinweg. Natürlich können " +"Sie auch befehlsorientiert die Transaktionsbereiche abgrenzen (BMT) oder das " +"optionale Hibernate <literal>Transaction</literal>-API hierfür verwenden, um " +"Ihren Code übertragbar zu halten." + +#. Tag: para +#, no-c-format +msgid "" +"<emphasis>Automatic JNDI binding</emphasis>: Hibernate can bind its " +"<literal>SessionFactory</literal> to JNDI after startup." +msgstr "" +"<emphasis>Automatisches JNDI-Binding</emphasis>: Hibernate kann seine " +"<literal>SessionFactory</literal> nach dem Startup an JNDI binden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis>JTA Session binding:</emphasis> the Hibernate <literal>Session</" +"literal> can be automatically bound to the scope of JTA transactions. Simply " +"lookup the <literal>SessionFactory</literal> from JNDI and get the current " +"<literal>Session</literal>. Let Hibernate manage flushing and closing the " +"<literal>Session</literal> when your JTA transaction completes. Transaction " +"demarcation is either declarative (CMT) or programmatic (BMT/" +"UserTransaction)." +msgstr "" +"<emphasis>JTA-Session-Binding:</emphasis> Die Hibernate <literal>Session</" +"literal> kann automatisch an den Gültigkeitsbereich von JTA-Transaktionen " +"gebunden werden. Suchen Sie einfach die <literal>SessionFactory</literal> " +"aus JNDI heraus, und holen Sie die aktuelle <literal>Session</literal>. " +"Hibernate übernimmt die Räumung und Schließung der <literal>Session</" +"literal>, wenn Ihre JTA-Transaktion vollständig ist. Die " +"Transaktionsabgrenzung ist entweder deklarativ (CMT) oder befehlsorientiert " +"(BMT/UserTransaction)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis>JMX deployment:</emphasis> if you have a JMX capable application " +"server (e.g. JBoss AS), you can choose to deploy Hibernate as a managed " +"MBean. This saves you the one line startup code to build your " +"<literal>SessionFactory</literal> from a <literal>Configuration</literal>. " +"The container will startup your <literal>HibernateService</literal> and also " +"take care of service dependencies (datasource has to be available before " +"Hibernate starts, etc)." +msgstr "" +"<emphasis>JMX-Deployment:</emphasis> Falls Sie einen JMX-fähigen " +"Applikationsserver besitzen (z.B. JBoss AS), können Sie Hibernate als " +"gemanagtes MBean ausführen. Das erspart Ihnen den einzeiligen Startup-Code, " +"um Ihre <literal>SessionFactory</literal> aus einer <literal>Configuration</" +"literal> zu bauen. Der Container startet Ihren <literal>HibernateService</" +"literal> und kümmert sich im Idealfall auch um abhängige Dienste " +"(Datenquelle muss vor dem Hibernate Start verfügbar sein usw.). " + +#. Tag: para +#, no-c-format +msgid "" +"Depending on your environment, you might have to set the configuration " +"option <literal>hibernate.connection.aggressive_release</literal> to true if " +"your application server shows \"connection containment\" exceptions." +msgstr "" +"Je nach Ihrer Umgebung müssen Sie möglicherweise die Konfigurationsoption " +"<literal>hibernate.connection.aggressive_release</literal> auf \"true\" " +"setzen, falls Ihr Server \"Connection Containment\"-Ausnahmen (d.h. " +"Verbindungseinschränkungen) anzeigt." + +#. Tag: title +#, no-c-format +msgid "Transaction strategy configuration" +msgstr "Konfiguration der Transaktionsstrategie" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The Hibernate <literal>Session</literal> API is independent of any " +"transaction demarcation system in your architecture. If you let Hibernate " +"use JDBC directly through a connection pool, you can begin and end your " +"transactions by calling the JDBC API. If you run in a J2EE application " +"server, you might want to use bean-managed transactions and call the JTA API " +"and <literal>UserTransaction</literal> when needed." +msgstr "" +"Das Hibernate <literal>Session</literal> API ist unabhängig vom " +"Transaktionsabgrenzungssystem Ihrer Architektur. Wenn Hibernate durch den " +"Verbindungspool JDBC direkt verwendet, können Sie Transaktionen mit Aufruf " +"des JDBC-API starten und beenden. Falls Sie einen J2EE-Applikationsserver " +"verwenden, ist es möglicherweise sinnvoll, von Beans gemanagte Transaktionen " +"zu verwenden und das JTA-API und <literal>UserTransaction</literal> bei " +"Bedarf aufzurufen." + +#. Tag: para +#, no-c-format +msgid "" +"To keep your code portable between these two (and other) environments we " +"recommend the optional Hibernate <literal>Transaction</literal> API, which " +"wraps and hides the underlying system. You have to specify a factory class " +"for <literal>Transaction</literal> instances by setting the Hibernate " +"configuration property <literal>hibernate.transaction.factory_class</" +"literal>." +msgstr "" +"Um Ihren Code zwischen diesen beiden (und anderen) Umgebungen übertragbar zu " +"halten, empfehlen wir das optionale Hibernate <literal>Transaction</literal>-" +"API, welches das zu Grunde liegende System wrappt und verbirgt. Sie müssen " +"eine Factory-Klasse für <literal>Transaction</literal>-Instanzen bestimmen, " +"indem Sie die Hibernate Konfigurationseigenschaft <literal>hibernate." +"transaction.factory_class</literal> einstellen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "There are three standard, or built-in, choices:" +msgstr "Es existieren drei Standard-Auswahlmöglichkeiten (eingebaut):" + +#. Tag: term +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.transaction.JDBCTransactionFactory</literal>" +msgstr "org.hibernate.transaction.JDBCTransactionFactory" + +#. Tag: para +#, no-c-format +msgid "delegates to database (JDBC) transactions (default)" +msgstr "delegiert an die Datenbank (JDBC) Transaktionen (default)" + +#. Tag: term +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.transaction.JTATransactionFactory</literal>" +msgstr "org.hibernate.transaction.JTATransactionFactory" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"delegates to container-managed transactions if an existing transaction is " +"underway in this context (for example, EJB session bean method). Otherwise, " +"a new transaction is started and bean-managed transactions are used." +msgstr "" +"delegiert an die containerverwaltete Transaktion, falls eine bestehende " +"Transaktion in diesem Kontext läuft (z.B. EJB Session-Bean-Methode). " +"Andernfalls wird eine neue Transaktion gestartet und von einem Bean " +"gemanagte Transaktionen werden verwendet." + +#. Tag: term +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.transaction.CMTTransactionFactory</literal>" +msgstr "org.hibernate.transaction.CMTTransactionFactory" + +#. Tag: para +#, no-c-format +msgid "delegates to container-managed JTA transactions" +msgstr "delegiert an containerverwaltete JTA-Transaktionen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can also define your own transaction strategies (for a CORBA transaction " +"service, for example)." +msgstr "" +"Sie können auch Ihre eigenen Transaktionsstrategien definieren (z.B. für " +"einen CORBA-Transaktionsdienst)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Some features in Hibernate (i.e., the second level cache, Contextual " +"Sessions with JTA, etc.) require access to the JTA " +"<literal>TransactionManager</literal> in a managed environment. In an " +"application server, since J2EE does not standardize a single mechanism, you " +"have to specify how Hibernate should obtain a reference to the " +"<literal>TransactionManager</literal>:" +msgstr "" +"Einige Features in Hibernate (etwa das Cache der zweiten Ebene, " +"kontextbezogene Sessions mit JTA usw.) erfordern Zugriff auf den JTA " +"<literal>TransactionManager</literal> in einer gemanagten Umgebung. In einem " +"Applikationsserver müssen Sie festlegen, wie Hibernate einen Verweis an den " +"<literal>TransactionManager</literal> erhält, da J2EE keinen einzelnen " +"Mechanismus standardisiert:" + +#. Tag: title +#, no-c-format +msgid "JTA TransactionManagers" +msgstr "JTA-TransactionManagers" + +#. Tag: para +#, no-c-format +msgid "Transaction Factory" +msgstr "Transaction-Factory" + +#. Tag: para +#, no-c-format +msgid "Application Server" +msgstr "Applikationsserver" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>org.hibernate.transaction. JBossTransactionManagerLookup</literal>" +msgstr "org.hibernate.transaction.JBossTransactionManagerLookup" + +#. Tag: para +#, no-c-format +msgid "JBoss" +msgstr "JBoss" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>org.hibernate.transaction. WeblogicTransactionManagerLookup</" +"literal>" +msgstr "org.hibernate.transaction.WeblogicTransactionManagerLookup" + +#. Tag: para +#, no-c-format +msgid "Weblogic" +msgstr "Weblogic" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>org.hibernate.transaction. WebSphereTransactionManagerLookup</" +"literal>" +msgstr "org.hibernate.transaction.WebSphereTransactionManagerLookup" + +#. Tag: para +#, no-c-format +msgid "WebSphere" +msgstr "WebSphere" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>org.hibernate.transaction. WebSphereExtendedJTATransactionLookup</" +"literal>" +msgstr "org.hibernate.transaction.WebSphereExtendedJTATransactionLookup" + +#. Tag: para +#, no-c-format +msgid "WebSphere 6" +msgstr "WebSphere 6" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>org.hibernate.transaction. OrionTransactionManagerLookup</literal>" +msgstr "org.hibernate.transaction.OrionTransactionManagerLookup" + +#. Tag: para +#, no-c-format +msgid "Orion" +msgstr "Orion" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>org.hibernate.transaction. ResinTransactionManagerLookup</literal>" +msgstr "org.hibernate.transaction.ResinTransactionManagerLookup" + +#. Tag: para +#, no-c-format +msgid "Resin" +msgstr "Resin" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>org.hibernate.transaction. JOTMTransactionManagerLookup</literal>" +msgstr "org.hibernate.transaction.JOTMTransactionManagerLookup" + +#. Tag: para +#, no-c-format +msgid "JOTM" +msgstr "JOTM" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>org.hibernate.transaction. JOnASTransactionManagerLookup</literal>" +msgstr "org.hibernate.transaction.JOnASTransactionManagerLookup" + +#. Tag: para +#, no-c-format +msgid "JOnAS" +msgstr "JOnAS" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>org.hibernate.transaction. JRun4TransactionManagerLookup</literal>" +msgstr "org.hibernate.transaction.JRun4TransactionManagerLookup" + +#. Tag: para +#, no-c-format +msgid "JRun4" +msgstr "JRun4" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>org.hibernate.transaction. BESTransactionManagerLookup</literal>" +msgstr "org.hibernate.transaction.BESTransactionManagerLookup" + +#. Tag: para +#, no-c-format +msgid "Borland ES" +msgstr "Borland ES" + +#. Tag: title +#, fuzzy, no-c-format +msgid "JNDI-bound <literal>SessionFactory</literal>" +msgstr "JNDI-gebundene SessionFactory" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A JNDI-bound Hibernate <literal>SessionFactory</literal> can simplify the " +"lookup function of the factory and create new <literal>Session</literal>s. " +"This is not, however, related to a JNDI bound <literal>Datasource</literal>; " +"both simply use the same registry." +msgstr "" +"Eine JNDI-gebundene Hibernate <literal>SessionFactory</literal> kann die " +"Suche nach der Factory und die Erstellung neuer <literal>Session</literal>s " +"vereinfachen. Bitte beachten Sie, dass dies nichts mit einer JNDI-gebundenen " +"<literal>Datasource</literal> zu tun hat, die beiden verwenden lediglich " +"diesselbe Registry!" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If you wish to have the <literal>SessionFactory</literal> bound to a JNDI " +"namespace, specify a name (e.g. <literal>java:hibernate/SessionFactory</" +"literal>) using the property <literal>hibernate.session_factory_name</" +"literal>. If this property is omitted, the <literal>SessionFactory</literal> " +"will not be bound to JNDI. This is especially useful in environments with a " +"read-only JNDI default implementation (in Tomcat, for example)." +msgstr "" +"Falls Sie möchten, dass die <literal>SessionFactory</literal> an einen JNDI-" +"Namensraum gebunden wird, legen Sie unter Verwendung der Property " +"<literal>hibernate.session_factory_name</literal> einen Namen fest (z.B. " +"<literal>java:hibernate/SessionFactory</literal>). Falls diese Property " +"weggelassen wird, so wird die <literal>SessionFactory</literal> nicht an " +"JNDI gebunden. (Das ist insbesondere in Umgebungen mit einer " +"schreibgeschützten \"read-only\" JNDI-Standardimplementierung - wie etwa " +"Tomcat - hilfreich)." + +#. Tag: para +#, no-c-format +msgid "" +"When binding the <literal>SessionFactory</literal> to JNDI, Hibernate will " +"use the values of <literal>hibernate.jndi.url</literal>, <literal>hibernate." +"jndi.class</literal> to instantiate an initial context. If they are not " +"specified, the default <literal>InitialContext</literal> will be used." +msgstr "" +"Beim Binden der <literal>SessionFactory</literal> an JNDI, wird Hibernate " +"die Werte von <literal>hibernate.jndi.url</literal>, <literal>hibernate.jndi." +"class</literal> verwenden, um einen Anfangskontext zu initiieren. Werden " +"diese nicht festgelegt, so wird der Standard <literal>InitialContext</" +"literal> verwendet." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate will automatically place the <literal>SessionFactory</literal> in " +"JNDI after you call <literal>cfg.buildSessionFactory()</literal>. This means " +"you will have this call in some startup code, or utility class in your " +"application, unless you use JMX deployment with the " +"<literal>HibernateService</literal> (this is discussed later in greater " +"detail)." +msgstr "" +"Hibernate wird die <literal>SessionFactory</literal> in JNDI platzieren, " +"nachdem Sie <literal>cfg.buildSessionFactory()</literal> aufrufen. Das " +"bedeutet, dass Sie diesen Aufruf zumindest in einem Startup-Code (oder einer " +"Dienstprogrammklasse) Ihrer Anwendung haben, außer Sie verwenden JMX-" +"Deployment mit <literal>HibernateService</literal> (wird später erläutert)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If you use a JNDI <literal>SessionFactory</literal>, an EJB or any other " +"class, you can obtain the <literal>SessionFactory</literal> using a JNDI " +"lookup." +msgstr "" +"Falls Sie eine JNDI <literal>SessionFactory</literal> verwenden, kann ein " +"EJB oder eine andere Klasse mittels eines JNDI-Suchlaufs die " +"<literal>SessionFactory</literal> erhalten." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"It is recommended that you bind the <literal>SessionFactory</literal> to " +"JNDI in a managed environment and use a <literal>static</literal> singleton " +"otherwise. To shield your application code from these details, we also " +"recommend to hide the actual lookup code for a <literal>SessionFactory</" +"literal> in a helper class, such as <literal>HibernateUtil.getSessionFactory" +"()</literal>. Note that such a class is also a convenient way to startup " +"Hibernate—see chapter 1." +msgstr "" +"Wir empfehlen, dass Sie die <literal>SessionFactory</literal> in einer " +"gemanagten Umgebung an JNDI binden und andernfalls einen <literal>static</" +"literal> Singleton verwenden. Um Ihren Applikationscode vor diesen Details " +"abzuschirmen, empfehlen wir außerdem, dass Sie den tatsächlichen Code des " +"Suchlaufs (\"Lookup-Code\") für eine <literal>SessionFactory</literal> in " +"einer Helferklasse wie etwa <literal>HibernateUtil.getSessionFactory()</" +"literal> verbergen. Bitte beachten Sie auch, dass eine solche Klasse " +"außerdem eine praktische Weise ist, Hibernate - zu starten. Siehe dazu " +"Kapitel 1." + +#. Tag: title +#, no-c-format +msgid "Current Session context management with JTA" +msgstr "Aktuelles Management des Sessionkontexts mit JTA" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The easiest way to handle <literal>Sessions</literal> and transactions is " +"Hibernate's automatic \"current\" <literal>Session</literal> management. For " +"a discussion of contextual sessions see <xref linkend=\"architecture-current-" +"session\" />. Using the <literal>\"jta\"</literal> session context, if there " +"is no Hibernate <literal>Session</literal> associated with the current JTA " +"transaction, one will be started and associated with that JTA transaction " +"the first time you call <literal>sessionFactory.getCurrentSession()</" +"literal>. The <literal>Session</literal>s retrieved via " +"<literal>getCurrentSession()</literal> in the<literal>\"jta\"</literal> " +"context are set to automatically flush before the transaction completes, " +"close after the transaction completes, and aggressively release JDBC " +"connections after each statement. This allows the <literal>Session</" +"literal>s to be managed by the life cycle of the JTA transaction to which it " +"is associated, keeping user code clean of such management concerns. Your " +"code can either use JTA programmatically through <literal>UserTransaction</" +"literal>, or (recommended for portable code) use the Hibernate " +"<literal>Transaction</literal> API to set transaction boundaries. If you run " +"in an EJB container, declarative transaction demarcation with CMT is " +"preferred." +msgstr "" +"Die einfachste Art <literal>Session</literal>s und Transaktionen zu " +"bearbeiten ist mit Hibernates automatischem Management der \"aktuellen\" " +"<literal>Session</literal>. Siehe dazu auch die Erläuterungen unter <xref " +"linkend=\"architecture-current-session\"/>. Unter Verwendung des <literal>" +"\"jta\"</literal> Sessionkontexts wird, falls keine Hibernate " +"<literal>Session</literal> mit der aktuellen JTA-Transaktion assoziiert " +"wird, beim erstmaligen Aufruf von <literal>sessionFactory.getCurrentSession()" +"</literal>, eine gestartet. Die mittels <literal>getCurrentSession()</" +"literal> im <literal>\"jta\"</literal>-Kontext abgerufenen <literal>Session</" +"literal>s werden automatisch geräumt ehe die Transaktion beendet wird, " +"geschlossen nachdem die Transaktion beendet ist und aktive JDBC-Verbindungen " +"nach jeder Anweisung freigegeben. Das ermöglicht es den <literal>Session</" +"literal>s durch den Lebenszyklus der mit ihr assoziierten JTA-Transaktion " +"verwaltet zu werden, so dass der Benutzercode nicht mit Management-Inhalten " +"belastet wird. Ihr Code kann JTA entweder befehlsorientiert durch " +"<literal>UserTransaction</literal> oder (für übertragbaren Code empfohlen) " +"das Hibernate <literal>Transaction</literal>-API verwenden, um die " +"Transaktionsbereiche zu setzen. Falls Sie einen EJB-Container betreiben, so " +"ist die deklarative Transaktionsabgrenzung mit CMT zu bevorzugen." + +#. Tag: title +#, no-c-format +msgid "JMX deployment" +msgstr "JMX-Deployment" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The line <literal>cfg.buildSessionFactory()</literal> still has to be " +"executed somewhere to get a <literal>SessionFactory</literal> into JNDI. You " +"can do this either in a <literal>static</literal> initializer block, like " +"the one in <literal>HibernateUtil</literal>, or you can deploy Hibernate as " +"a <emphasis>managed service</emphasis>." +msgstr "" +"Die Zeile <literal>cfg.buildSessionFactory()</literal> muss nach wie vor " +"irgendwo ausgeführt werden, um die <literal>SessionFactory</literal> in JNDI " +"zu bringen. Dies kann entweder in einem <literal>static</literal> " +"Initialisierungsprogrammsblock (wie denjenigem in <literal>HibernateUtil</" +"literal>) oder durch Deployment von Hibernate als <emphasis>managed service</" +"emphasis> erfolgen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate is distributed with <literal>org.hibernate.jmx.HibernateService</" +"literal> for deployment on an application server with JMX capabilities, such " +"as JBoss AS. The actual deployment and configuration is vendor-specific. " +"Here is an example <literal>jboss-service.xml</literal> for JBoss 4.0.x:" +msgstr "" +"Hibernate wird mit einem <literal>org.hibernate.jmx.HibernateService</" +"literal> für das Deployment in einem JMX-fähigen Applikationsserver wie etwa " +"JBoss AS geliefert. Deployment und Konfiguration sind dabei " +"anbieterspezifisch. Nachfolgend sehen Sie ein Beispiel für <literal>jboss-" +"service.xml</literal> for JBoss 4.0.x:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This file is deployed in a directory called <literal>META-INF</literal> and " +"packaged in a JAR file with the extension <literal>.sar</literal> (service " +"archive). You also need to package Hibernate, its required third-party " +"libraries, your compiled persistent classes, as well as your mapping files " +"in the same archive. Your enterprise beans (usually session beans) can be " +"kept in their own JAR file, but you can include this EJB JAR file in the " +"main service archive to get a single (hot-)deployable unit. Consult the " +"JBoss AS documentation for more information about JMX service and EJB " +"deployment." +msgstr "" +"Diese Datei wird in einem Verzeichnis namens <literal>META-INF</literal> " +"ausgeführt und in einer JAR-Datei mit der Erweiterung <literal>.sar</" +"literal> (Dienstarchiv). Sie müssen außerdem Hibernate, dessen erforderliche " +"Bibliotheken Dritter Parteien, Ihre kompilierten persistenten Klassen sowie " +"Ihre Mapping-Dateien im selben Archiv verpacken. Ihre Enterprise-Beans (in " +"der Regel Session-Beans) können sich in deren eigener JAR-Datei befinden, " +"jedoch muss diese EJB JAR-Datei im Hauptdienstarchiv sein, um eine einzelne " +"\"(hot-)deploybare\" Einheit zu erhalten. Weitere Informationen zum JMX-" +"Dienst und EJB-Deployment finden Sie in der JBoss AS Dokumentation." + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Configuration cfg = new Configuration()\n" +#~ " .addResource(\"Item.hbm.xml\")\n" +#~ " .addResource(\"Bid.hbm.xml\");]]>" +#~ msgstr "" +#~ "Configuration cfg = new Configuration()\n" +#~ " .addResource(\"Item.hbm.xml\")\n" +#~ " .addResource(\"Bid.hbm.xml\");" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Configuration cfg = new Configuration()\n" +#~ " .addClass(org.hibernate.auction.Item.class)\n" +#~ " .addClass(org.hibernate.auction.Bid.class);]]>" +#~ msgstr "" +#~ "Configuration cfg = new Configuration()\n" +#~ " .addClass(org.hibernate.auction.Item.class)\n" +#~ " .addClass(org.hibernate.auction.Bid.class);" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Configuration cfg = new Configuration()\n" +#~ " .addClass(org.hibernate.auction.Item.class)\n" +#~ " .addClass(org.hibernate.auction.Bid.class)\n" +#~ " .setProperty(\"hibernate.dialect\", \"org.hibernate.dialect." +#~ "MySQLInnoDBDialect\")\n" +#~ " .setProperty(\"hibernate.connection.datasource\", \"java:comp/env/" +#~ "jdbc/test\")\n" +#~ " .setProperty(\"hibernate.order_updates\", \"true\");]]>" +#~ msgstr "" +#~ "Configuration cfg = new Configuration()\n" +#~ " .addClass(org.hibernate.auction.Item.class)\n" +#~ " .addClass(org.hibernate.auction.Bid.class)\n" +#~ " .setProperty(\"hibernate.dialect\", \"org.hibernate.dialect." +#~ "MySQLInnoDBDialect\")\n" +#~ " .setProperty(\"hibernate.connection.datasource\", \"java:comp/env/" +#~ "jdbc/test\")\n" +#~ " .setProperty(\"hibernate.order_updates\", \"true\");" + +#, fuzzy +#~ msgid "<![CDATA[SessionFactory sessions = cfg.buildSessionFactory();]]>" +#~ msgstr "SessionFactory sessions = cfg.buildSessionFactory();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Session session = sessions.openSession(); // open a new Session]]" +#~ ">" +#~ msgstr "Session session = sessions.openSession(); // open a new Session" + +#~ msgid "database user" +#~ msgstr "Datenbankbenutzer" + +#~ msgid "database user password" +#~ msgstr "Datenbankbenutzer-Passwort" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[hibernate.connection.driver_class = org.postgresql.Driver\n" +#~ "hibernate.connection.url = jdbc:postgresql://localhost/mydatabase\n" +#~ "hibernate.connection.username = myuser\n" +#~ "hibernate.connection.password = secret\n" +#~ "hibernate.c3p0.min_size=5\n" +#~ "hibernate.c3p0.max_size=20\n" +#~ "hibernate.c3p0.timeout=1800\n" +#~ "hibernate.c3p0.max_statements=50\n" +#~ "hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect]]>" +#~ msgstr "" +#~ "hibernate.connection.driver_class = org.postgresql.Driver\n" +#~ "hibernate.connection.url = jdbc:postgresql://localhost/mydatabase\n" +#~ "hibernate.connection.username = myuser\n" +#~ "hibernate.connection.password = secret\n" +#~ "hibernate.c3p0.min_size=5\n" +#~ "hibernate.c3p0.max_size=20\n" +#~ "hibernate.c3p0.timeout=1800\n" +#~ "hibernate.c3p0.max_statements=50\n" +#~ "hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect" + +#~ msgid "datasource JNDI name" +#~ msgstr "JNDI-Name der Datenquelle" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[hibernate.connection.datasource = java:/comp/env/jdbc/test\n" +#~ "hibernate.transaction.factory_class = \\\n" +#~ " org.hibernate.transaction.JTATransactionFactory\n" +#~ "hibernate.transaction.manager_lookup_class = \\\n" +#~ " org.hibernate.transaction.JBossTransactionManagerLookup\n" +#~ "hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect]]>" +#~ msgstr "" +#~ "hibernate.connection.datasource = java:/comp/env/jdbc/test\n" +#~ "hibernate.transaction.factory_class = \\n" +#~ " org.hibernate.transaction.JTATransactionFactory\n" +#~ "hibernate.transaction.manager_lookup_class = \\n" +#~ " org.hibernate.transaction.JBossTransactionManagerLookup\n" +#~ "hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect" + +#~ msgid "<entry>DB2</entry>" +#~ msgstr "<entry>DB2</entry>" + +#~ msgid "hibernate.query.substitutions true=1, false=0" +#~ msgstr "hibernate.query.substitutions true=1, false=0" + +#~ msgid "hibernate.query.substitutions toLowercase=LOWER" +#~ msgstr "hibernate.query.substitutions toLowercase=LOWER" + +#~ msgid "org.hibernate" +#~ msgstr "org.hibernate" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[SessionFactory sf = new Configuration()\n" +#~ " .setNamingStrategy(ImprovedNamingStrategy.INSTANCE)\n" +#~ " .addFile(\"Item.hbm.xml\")\n" +#~ " .addFile(\"Bid.hbm.xml\")\n" +#~ " .buildSessionFactory();]]>" +#~ msgstr "" +#~ "SessionFactory sf = new Configuration()\n" +#~ " .setNamingStrategy(ImprovedNamingStrategy.INSTANCE)\n" +#~ " .addFile(\"Item.hbm.xml\")\n" +#~ " .addFile(\"Bid.hbm.xml\")\n" +#~ " .buildSessionFactory();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<?xml version='1.0' encoding='utf-8'?>\n" +#~ "<!DOCTYPE hibernate-configuration PUBLIC\n" +#~ " \"-//Hibernate/Hibernate Configuration DTD//EN\"\n" +#~ " \"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd" +#~ "\">\n" +#~ "\n" +#~ "<hibernate-configuration>\n" +#~ "\n" +#~ " \n" +#~ " <session-factory\n" +#~ " name=\"java:hibernate/SessionFactory\">\n" +#~ "\n" +#~ " \n" +#~ " <property name=\"connection.datasource\">java:/comp/env/jdbc/" +#~ "MyDB</property>\n" +#~ " <property name=\"dialect\">org.hibernate.dialect.MySQLDialect</" +#~ "property>\n" +#~ " <property name=\"show_sql\">false</property>\n" +#~ " <property name=\"transaction.factory_class\">\n" +#~ " org.hibernate.transaction.JTATransactionFactory\n" +#~ " </property>\n" +#~ " <property name=\"jta.UserTransaction\">java:comp/UserTransaction</" +#~ "property>\n" +#~ "\n" +#~ " \n" +#~ " <mapping resource=\"org/hibernate/auction/Item.hbm.xml\"/>\n" +#~ " <mapping resource=\"org/hibernate/auction/Bid.hbm.xml\"/>\n" +#~ "\n" +#~ " \n" +#~ " <class-cache class=\"org.hibernate.auction.Item\" usage=\"read-" +#~ "write\"/>\n" +#~ " <class-cache class=\"org.hibernate.auction.Bid\" usage=\"read-only" +#~ "\"/>\n" +#~ " <collection-cache collection=\"org.hibernate.auction.Item.bids\" " +#~ "usage=\"read-write\"/>\n" +#~ "\n" +#~ " </session-factory>\n" +#~ "\n" +#~ "</hibernate-configuration>]]>" +#~ msgstr "" +#~ "<?xml version='1.0' encoding='utf-8'?>\n" +#~ "<!DOCTYPE hibernate-configuration PUBLIC\n" +#~ " \"-//Hibernate/Hibernate Configuration DTD//EN\"\n" +#~ " \"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd" +#~ "\">\n" +#~ "\n" +#~ "<hibernate-configuration>\n" +#~ "\n" +#~ " \n" +#~ " <session-factory\n" +#~ " name=\"java:hibernate/SessionFactory\">\n" +#~ "\n" +#~ " \n" +#~ " <property name=\"connection.datasource\">java:/comp/env/" +#~ "jdbc/MyDB</property>\n" +#~ " <property name=\"dialect\">org.hibernate.dialect." +#~ "MySQLDialect</property>\n" +#~ " <property name=\"show_sql\">false</property>\n" +#~ " <property name=\"transaction.factory_class\">\n" +#~ " org.hibernate.transaction.JTATransactionFactory\n" +#~ " </property>\n" +#~ " <property name=\"jta.UserTransaction\">java:comp/" +#~ "UserTransaction</property>\n" +#~ "\n" +#~ " \n" +#~ " <mapping resource=\"org/hibernate/auction/Item.hbm.xml\"/>\n" +#~ " <mapping resource=\"org/hibernate/auction/Bid.hbm.xml\"/>\n" +#~ "\n" +#~ " \n" +#~ " <class-cache class=\"org.hibernate.auction.Item\" usage=\"read-" +#~ "write\"/>\n" +#~ " <class-cache class=\"org.hibernate.auction.Bid\" usage=\"read-" +#~ "only\"/>\n" +#~ " <collection-cache collection=\"org.hibernate.auction.Item.bids" +#~ "\" usage=\"read-write\"/>\n" +#~ "\n" +#~ " </session-factory>\n" +#~ "\n" +#~ "</hibernate-configuration>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[SessionFactory sf = new Configuration().configure()." +#~ "buildSessionFactory();]]>" +#~ msgstr "" +#~ "SessionFactory sf = new Configuration().configure().buildSessionFactory();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[SessionFactory sf = new Configuration()\n" +#~ " .configure(\"catdb.cfg.xml\")\n" +#~ " .buildSessionFactory();]]>" +#~ msgstr "" +#~ "SessionFactory sf = new Configuration()\n" +#~ " .configure(\"catdb.cfg.xml\")\n" +#~ " .buildSessionFactory();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<?xml version=\"1.0\"?>\n" +#~ "<server>\n" +#~ "\n" +#~ "<mbean code=\"org.hibernate.jmx.HibernateService\"\n" +#~ " name=\"jboss.jca:service=HibernateFactory,name=HibernateFactory\">\n" +#~ "\n" +#~ " \n" +#~ " <depends>jboss.jca:service=RARDeployer</depends>\n" +#~ " <depends>jboss.jca:service=LocalTxCM,name=HsqlDS</depends>\n" +#~ "\n" +#~ " \n" +#~ " <attribute name=\"JndiName\">java:/hibernate/SessionFactory</" +#~ "attribute>\n" +#~ "\n" +#~ " \n" +#~ " <attribute name=\"Datasource\">java:HsqlDS</attribute>\n" +#~ " <attribute name=\"Dialect\">org.hibernate.dialect.HSQLDialect</" +#~ "attribute>\n" +#~ "\n" +#~ " \n" +#~ " <attribute name=\"TransactionStrategy\">\n" +#~ " org.hibernate.transaction.JTATransactionFactory</attribute>\n" +#~ " <attribute name=\"TransactionManagerLookupStrategy\">\n" +#~ " org.hibernate.transaction.JBossTransactionManagerLookup</" +#~ "attribute>\n" +#~ " <attribute name=\"FlushBeforeCompletionEnabled\">true</attribute>\n" +#~ " <attribute name=\"AutoCloseSessionEnabled\">true</attribute>\n" +#~ "\n" +#~ " \n" +#~ " <attribute name=\"MaximumFetchDepth\">5</attribute>\n" +#~ "\n" +#~ " \n" +#~ " <attribute name=\"SecondLevelCacheEnabled\">true</attribute>\n" +#~ " <attribute name=\"CacheProviderClass\">org.hibernate.cache." +#~ "EhCacheProvider</attribute>\n" +#~ " <attribute name=\"QueryCacheEnabled\">true</attribute>\n" +#~ "\n" +#~ " \n" +#~ " <attribute name=\"ShowSqlEnabled\">true</attribute>\n" +#~ "\n" +#~ " \n" +#~ " <attribute name=\"MapResources\">auction/Item.hbm.xml,auction/" +#~ "Category.hbm.xml</attribute>\n" +#~ "\n" +#~ "</mbean>\n" +#~ "\n" +#~ "</server>]]>" +#~ msgstr "" +#~ "<?xml version=\"1.0\"?>\n" +#~ "<server>\n" +#~ "\n" +#~ "<mbean code=\"org.hibernate.jmx.HibernateService\"\n" +#~ " name=\"jboss.jca:service=HibernateFactory,name=HibernateFactory" +#~ "\">\n" +#~ "\n" +#~ " \n" +#~ " <depends>jboss.jca:service=RARDeployer</depends>\n" +#~ " <depends>jboss.jca:service=LocalTxCM,name=HsqlDS</" +#~ "depends>\n" +#~ "\n" +#~ " \n" +#~ " <attribute name=\"JndiName\">java:/hibernate/SessionFactory</" +#~ "attribute>\n" +#~ "\n" +#~ " \n" +#~ " <attribute name=\"Datasource\">java:HsqlDS</attribute>\n" +#~ " <attribute name=\"Dialect\">org.hibernate.dialect." +#~ "HSQLDialect</attribute>\n" +#~ "\n" +#~ " \n" +#~ " <attribute name=\"TransactionStrategy\">\n" +#~ " org.hibernate.transaction.JTATransactionFactory</" +#~ "attribute>\n" +#~ " <attribute name=\"TransactionManagerLookupStrategy\">\n" +#~ " org.hibernate.transaction.JBossTransactionManagerLookup</" +#~ "attribute>\n" +#~ " <attribute name=\"FlushBeforeCompletionEnabled\">true</" +#~ "attribute>\n" +#~ " <attribute name=\"AutoCloseSessionEnabled\">true</" +#~ "attribute>\n" +#~ "\n" +#~ " \n" +#~ " <attribute name=\"MaximumFetchDepth\">5</attribute>\n" +#~ "\n" +#~ " \n" +#~ " <attribute name=\"SecondLevelCacheEnabled\">true</" +#~ "attribute>\n" +#~ " <attribute name=\"CacheProviderClass\">org.hibernate.cache." +#~ "EhCacheProvider</attribute>\n" +#~ " <attribute name=\"QueryCacheEnabled\">true</attribute>\n" +#~ "\n" +#~ " \n" +#~ " <attribute name=\"ShowSqlEnabled\">true</attribute>\n" +#~ "\n" +#~ " \n" +#~ " <attribute name=\"MapResources\">auction/Item.hbm.xml,auction/" +#~ "Category.hbm.xml</attribute>\n" +#~ "\n" +#~ "</mbean>\n" +#~ "\n" +#~ "</server>" Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/events.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/events.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/events.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,843 @@ +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# Language /mnt/hgfs/base/Hibernate/Reference translations for PACKAGE package. +# Copyright (C) 2006, 2007 Free Software Foundation, Inc. +# Automatically generated, 2006. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# +msgid "" +msgstr "" +"Project-Id-Version: Collection_Mapping\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2009-12-03T00:15:26\n" +"PO-Revision-Date: 2007-02-26 10:27+1000\n" +"Last-Translator: \n" +"Language-Team: <de(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.9.1\n" + +#. Tag: title +#, no-c-format +msgid "Interceptors and events" +msgstr "Interzeptoren und Ereignisse" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"It is useful for the application to react to certain events that occur " +"inside Hibernate. This allows for the implementation of generic " +"functionality and the extension of Hibernate functionality." +msgstr "" +"Es ist oftmals von Nutzen, wenn die Anwendung auf bestimmte, innerhalb " +"Hibernates ablaufende Ereignisse (\"Events\") reagiert. Es ermöglicht die " +"Implementierung bestimmter Arten auswählbarer Funktionalitäten sowie eine " +"Erweiterung der Funktionalität von Hibernate." + +#. Tag: title +#, no-c-format +msgid "Interceptors" +msgstr "Interzeptoren" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>Interceptor</literal> interface provides callbacks from the " +"session to the application, allowing the application to inspect and/or " +"manipulate properties of a persistent object before it is saved, updated, " +"deleted or loaded. One possible use for this is to track auditing " +"information. For example, the following <literal>Interceptor</literal> " +"automatically sets the <literal>createTimestamp</literal> when an " +"<literal>Auditable</literal> is created and updates the " +"<literal>lastUpdateTimestamp</literal> property when an <literal>Auditable</" +"literal> is updated." +msgstr "" +"Das <literal>Interceptor</literal>-Interface bietet die Möglichkeit von " +"Callbacks der Session an die Anwendung, wodurch letztere die Properties " +"eines persistenten Objekts vorweg prüfen und/oder verändern kann, ehe dieses " +"gespeichert, aktualisiert, gelöscht oder geladen wird. Eine mögliche " +"Anwendung hierfür ist etwa das Auditing von Informationen. Zum Beispiel " +"setzt der folgende <literal>Interceptor</literal> automatisch " +"<literal>createTimestamp</literal>, wenn ein <literal>Auditable</literal> " +"erstellt wird und aktualisiert die <literal>lastUpdateTimestamp</literal>-" +"Property, wenn ein <literal>Auditable</literal> aktualisiert wird." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can either implement <literal>Interceptor</literal> directly or extend " +"<literal>EmptyInterceptor</literal>." +msgstr "" +"Sie können <literal>Interceptor</literal> entweder direkt implementieren " +"oder (besser) <literal>EmptyInterceptor</literal> erweitern." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"There are two kinds of inteceptors: <literal>Session</literal>-scoped and " +"<literal>SessionFactory</literal>-scoped." +msgstr "" +"Es existieren zwei Arten von Interzeptoren: Für die <literal>Session</" +"literal> zuständige und für die <literal>SessionFactory</literal> zuständige." + +#. Tag: para +#, no-c-format +msgid "" +"A <literal>Session</literal>-scoped interceptor is specified when a session " +"is opened using one of the overloaded SessionFactory.openSession() methods " +"accepting an <literal>Interceptor</literal>." +msgstr "" +"Ein für die <literal>Session</literal> zuständiger Interzeptor wird beim " +"Öffnen einer Session unter Verwendung einer der überlasteten SessionFactory." +"openSession()-Methoden spezifiziert, die einen <literal>Interceptor</" +"literal> akzeptieren." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A <literal>SessionFactory</literal>-scoped interceptor is registered with " +"the <literal>Configuration</literal> object prior to building the " +"<literal>SessionFactory</literal>. Unless a session is opened explicitly " +"specifying the interceptor to use, the supplied interceptor will be applied " +"to all sessions opened from that <literal>SessionFactory</literal>. " +"<literal>SessionFactory</literal>-scoped interceptors must be thread safe. " +"Ensure that you do not store session-specific states, since multiple " +"sessions will use this interceptor potentially concurrently." +msgstr "" +"Ein für die <literal>SessionFactory</literal> zuständiger Interzeptor wird " +"mit dem <literal>Configuration</literal>-Objekt vor dem Bau der " +"<literal>SessionFactory</literal> erfasst. In diesem Fall wird der " +"gelieferte Interzeptor bei allen von dieser <literal>SessionFactory</" +"literal> geöffneten Sessions angewendet, außer bei einer Session wird " +"explizit der zu verwendende Interzeptor genannt. Für die " +"<literal>SessionFactory</literal> zuständige Interzeptoren müssen " +"threadsicher sein und dürfen keinen Session-spezifischen Status speichern, " +"da mehrere Sessions diesen Interzeptor (möglicherweise) gleichzeitig " +"verwenden." + +#. Tag: title +#, no-c-format +msgid "Event system" +msgstr "Ereignissystem" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If you have to react to particular events in your persistence layer, you can " +"also use the Hibernate3 <emphasis>event</emphasis> architecture. The event " +"system can be used in addition, or as a replacement, for interceptors." +msgstr "" +"Falls Sie auf bestimmte Ereignisse in Ihrer Persistenzschicht reagieren " +"müssen, können Sie die Hibernate3 <emphasis>Ereignis</emphasis>-Architektur " +"verwenden. Das Ereignissystem kann zusätzlich oder aber als Ersatz für " +"Interzeptoren verwendet werden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"All the methods of the <literal>Session</literal> interface correlate to an " +"event. You have a <literal>LoadEvent</literal>, a <literal>FlushEvent</" +"literal>, etc. Consult the XML configuration-file DTD or the <literal>org." +"hibernate.event</literal> package for the full list of defined event types. " +"When a request is made of one of these methods, the Hibernate " +"<literal>Session</literal> generates an appropriate event and passes it to " +"the configured event listeners for that type. Out-of-the-box, these " +"listeners implement the same processing in which those methods always " +"resulted. However, you are free to implement a customization of one of the " +"listener interfaces (i.e., the <literal>LoadEvent</literal> is processed by " +"the registered implementation of the <literal>LoadEventListener</literal> " +"interface), in which case their implementation would be responsible for " +"processing any <literal>load()</literal> requests made of the " +"<literal>Session</literal>." +msgstr "" +"Im Wesentlichen korrelieren alle Methoden des <literal>Session</literal>-" +"Interface mit einem Ereignis. Es gibt ein <literal>LoadEvent</literal>, ein " +"<literal>FlushEvent</literal>, usw. (in der XML-Konfigurationsdatei DTD oder " +"dem <literal>org.hibernate.event</literal>-Paket finden Sie die vollständige " +"Liste aller definierten Ereignistypen). Wenn eine Anfrage einer dieser " +"Methoden erfolgt, so generiert die Hibernate <literal>Session</literal> ein " +"zugehöriges Ereignis und gibt es an die für diesen Typ konfigurierten " +"\"Event-Listener\" weiter. Diese Listener implementieren dieselbe " +"Bearbeitung, die diese Methoden stets hervorbringen. Es steht Ihnen jedoch " +"frei, ein angepasstes Listener-Interface zu implementieren (d.h. " +"<literal>LoadEvent</literal> wird durch die erfasste Implementierung des " +"<literal>LoadEventListener</literal>-Interface bearbeitet), in welchem Fall " +"die Implementierung für die Bearbeitung sämtlicher durch die " +"<literal>Session</literal> erfolgender <literal>load()</literal>-Anfragen " +"verantwortlich wäre." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The listeners should be considered singletons. This means they are shared " +"between requests, and should not save any state as instance variables." +msgstr "" +"Die Listener sollten effektiv als Singletons angesehen werden, was bedeutet, " +"dass sie zwischen Anfragen geteilt werden und daher keinen Status als " +"Instanzvariable speichern sollten." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A custom listener implements the appropriate interface for the event it " +"wants to process and/or extend one of the convenience base classes (or even " +"the default event listeners used by Hibernate out-of-the-box as these are " +"declared non-final for this purpose). Custom listeners can either be " +"registered programmatically through the <literal>Configuration</literal> " +"object, or specified in the Hibernate configuration XML. Declarative " +"configuration through the properties file is not supported. Here is an " +"example of a custom load event listener:" +msgstr "" +"Ein angepasster Listener sollte das passende Interface für das Ereignis, das " +"bearbeitet werden und/oder einer der Bedienungsgrundklassen erweitern soll, " +"implementieren (oder sogar die ausgezeichneten standardmäßigen Ereignis-" +"Listener, die von Hibernate verwendet und für diesen Zweck als nicht-final " +"deklariert sind). Angepasste Listener können entweder programmatisch durch " +"das <literal>Configuration</literal>-Objekt oder in der Hibernate " +"Konfigurations-XML (deklarative Konfiguration durch die Properties-Datei " +"wird nicht unterstützt) erfasst werden. Nachfolgend sehen Sie ein Beispiel " +"für einen angepassten \"Load-Event-Listener\":" + +#. Tag: para +#, no-c-format +msgid "" +"You also need a configuration entry telling Hibernate to use the listener in " +"addition to the default listener:" +msgstr "" +"Sie benötigen außerdem einen Konfigurationseintrag, der Hibernate mitteilt, " +"dass der Listener zusätzlich zum Standard-Listener verwendet werden soll:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "Instead, you can register it programmatically:" +msgstr "Statt dessen können Sie dies programmatisch erfassen:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Listeners registered declaratively cannot share instances. If the same class " +"name is used in multiple <literal><listener/></literal> elements, each " +"reference will result in a separate instance of that class. If you need to " +"share listener instances between listener types you must use the " +"programmatic registration approach." +msgstr "" +"Deklarativ erfasste Listener können keine Instanzen teilen. Falls derselbe " +"Klassenname in mehreren <literal><listener/></literal>-Elementen " +"verwendet wird, so wird jeder Verweis in einer separaten Instanz dieser " +"Klasse resultieren. Falls Sie die Möglichkeit des Teilens von Listener-" +"Instanzen zwischen Listener-Typen benötigen, müssen Sie die programmatische " +"Erfassung nutzen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Why implement an interface and define the specific type during " +"configuration? A listener implementation could implement multiple event " +"listener interfaces. Having the type additionally defined during " +"registration makes it easier to turn custom listeners on or off during " +"configuration." +msgstr "" +"Warum jedoch ein Interface implementieren und während der Konfiguration den " +"spezifischen Typ definieren? Nun, eine Listener-Implementierung könnte " +"mehrere Event-Listener Interfaces implementieren. Definiert man den Typ " +"zusätzlich während der Erfassung, ist es einfacher angepasste Listener " +"während der Konfiguration an- und auszuschalten." + +#. Tag: title +#, no-c-format +msgid "Hibernate declarative security" +msgstr "Deklarative Sicherheit in Hibernate " + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Usually, declarative security in Hibernate applications is managed in a " +"session facade layer. Hibernate3 allows certain actions to be permissioned " +"via JACC, and authorized via JAAS. This is an optional functionality that is " +"built on top of the event architecture." +msgstr "" +"Für gewöhnlich wird die deklarative Sicherheit in Hibernate Anwendungen " +"durch eine Fassadenschicht geregelt. Jetzt ermöglicht Hibernate3 die " +"Genehmigung bestimmter Vorgänge via JACC sowie die Authorisierung via JAAS. " +"Es handelt sich dabei um eine optionale Funktionalität, die auf der Ereignis-" +"Architektur (sog. \"Event-Architecture\") aufgebaut ist." + +#. Tag: para +#, no-c-format +msgid "" +"First, you must configure the appropriate event listeners, to enable the use " +"of JAAS authorization." +msgstr "" +"Zunächst einmal müssen die betreffenden Event-Listener konfiguriert werden, " +"damit die Verwendung der JAAS Authorisierung aktiviert ist." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Note that <literal><listener type=\"...\" class=\"...\"/></literal> is " +"shorthand for <literal><event type=\"...\"><listener class=\"...\"/" +"></event></literal> when there is exactly one listener for a " +"particular event type." +msgstr "" +"Beachten Sie, dass <literal><listener type=\"...\" class=\"...\"/></" +"literal> lediglich ein Kürzel für <literal><event type=\"...\"><" +"listener class=\"...\"/></event></literal> ist, wenn genau ein " +"Listener für einen bestimmten Ereignistyp existiert." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Next, while still in <literal>hibernate.cfg.xml</literal>, bind the " +"permissions to roles:" +msgstr "" +"Anschließend, und immer noch in <literal>hibernate.cfg.xml</literal>, binden " +"Sie die Genehmigungen (sog. \"permissions\") an die Rollen:" + +#. Tag: para +#, no-c-format +msgid "The role names are the roles understood by your JACC provider." +msgstr "Die Rollennamen sind die von Ihrem JACC-Anbieter verstandenen Rollen." + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[package org.hibernate.test;\n" +#~ "\n" +#~ "import java.io.Serializable;\n" +#~ "import java.util.Date;\n" +#~ "import java.util.Iterator;\n" +#~ "\n" +#~ "import org.hibernate.EmptyInterceptor;\n" +#~ "import org.hibernate.Transaction;\n" +#~ "import org.hibernate.type.Type;\n" +#~ "\n" +#~ "public class AuditInterceptor extends EmptyInterceptor {\n" +#~ "\n" +#~ " private int updates;\n" +#~ " private int creates;\n" +#~ " private int loads;\n" +#~ "\n" +#~ " public void onDelete(Object entity,\n" +#~ " Serializable id,\n" +#~ " Object[] state,\n" +#~ " String[] propertyNames,\n" +#~ " Type[] types) {\n" +#~ " // do nothing\n" +#~ " }\n" +#~ "\n" +#~ " public boolean onFlushDirty(Object entity,\n" +#~ " Serializable id,\n" +#~ " Object[] currentState,\n" +#~ " Object[] previousState,\n" +#~ " String[] propertyNames,\n" +#~ " Type[] types) {\n" +#~ "\n" +#~ " if ( entity instanceof Auditable ) {\n" +#~ " updates++;\n" +#~ " for ( int i=0; i < propertyNames.length; i++ ) {\n" +#~ " if ( \"lastUpdateTimestamp\".equals( propertyNames[i] ) ) " +#~ "{\n" +#~ " currentState[i] = new Date();\n" +#~ " return true;\n" +#~ " }\n" +#~ " }\n" +#~ " }\n" +#~ " return false;\n" +#~ " }\n" +#~ "\n" +#~ " public boolean onLoad(Object entity,\n" +#~ " Serializable id,\n" +#~ " Object[] state,\n" +#~ " String[] propertyNames,\n" +#~ " Type[] types) {\n" +#~ " if ( entity instanceof Auditable ) {\n" +#~ " loads++;\n" +#~ " }\n" +#~ " return false;\n" +#~ " }\n" +#~ "\n" +#~ " public boolean onSave(Object entity,\n" +#~ " Serializable id,\n" +#~ " Object[] state,\n" +#~ " String[] propertyNames,\n" +#~ " Type[] types) {\n" +#~ "\n" +#~ " if ( entity instanceof Auditable ) {\n" +#~ " creates++;\n" +#~ " for ( int i=0; i<propertyNames.length; i++ ) {\n" +#~ " if ( \"createTimestamp\".equals( propertyNames[i] ) ) {\n" +#~ " state[i] = new Date();\n" +#~ " return true;\n" +#~ " }\n" +#~ " }\n" +#~ " }\n" +#~ " return false;\n" +#~ " }\n" +#~ "\n" +#~ " public void afterTransactionCompletion(Transaction tx) {\n" +#~ " if ( tx.wasCommitted() ) {\n" +#~ " System.out.println(\"Creations: \" + creates + \", Updates: " +#~ "\" + updates, \"Loads: \" + loads);\n" +#~ " }\n" +#~ " updates=0;\n" +#~ " creates=0;\n" +#~ " loads=0;\n" +#~ " }\n" +#~ "\n" +#~ "}]]>" +#~ msgstr "" +#~ "package org.hibernate.test;\n" +#~ "\n" +#~ "import java.io.Serializable;\n" +#~ "import java.util.Date;\n" +#~ "import java.util.Iterator;\n" +#~ "\n" +#~ "import org.hibernate.EmptyInterceptor;\n" +#~ "import org.hibernate.Transaction;\n" +#~ "import org.hibernate.type.Type;\n" +#~ "\n" +#~ "public class AuditInterceptor extends EmptyInterceptor {\n" +#~ "\n" +#~ " private int updates;\n" +#~ " private int creates;\n" +#~ " private int loads;\n" +#~ "\n" +#~ " public void onDelete(Object entity,\n" +#~ " Serializable id,\n" +#~ " Object[] state,\n" +#~ " String[] propertyNames,\n" +#~ " Type[] types) {\n" +#~ " // do nothing\n" +#~ " }\n" +#~ "\n" +#~ " public boolean onFlushDirty(Object entity,\n" +#~ " Serializable id,\n" +#~ " Object[] currentState,\n" +#~ " Object[] previousState,\n" +#~ " String[] propertyNames,\n" +#~ " Type[] types) {\n" +#~ "\n" +#~ " if ( entity instanceof Auditable ) {\n" +#~ " updates++;\n" +#~ " for ( int i=0; i < propertyNames.length; i++ ) {\n" +#~ " if ( \"lastUpdateTimestamp\".equals( propertyNames[i] ) ) " +#~ "{\n" +#~ " currentState[i] = new Date();\n" +#~ " return true;\n" +#~ " }\n" +#~ " }\n" +#~ " }\n" +#~ " return false;\n" +#~ " }\n" +#~ "\n" +#~ " public boolean onLoad(Object entity,\n" +#~ " Serializable id,\n" +#~ " Object[] state,\n" +#~ " String[] propertyNames,\n" +#~ " Type[] types) {\n" +#~ " if ( entity instanceof Auditable ) {\n" +#~ " loads++;\n" +#~ " }\n" +#~ " return false;\n" +#~ " }\n" +#~ "\n" +#~ " public boolean onSave(Object entity,\n" +#~ " Serializable id,\n" +#~ " Object[] state,\n" +#~ " String[] propertyNames,\n" +#~ " Type[] types) {\n" +#~ "\n" +#~ " if ( entity instanceof Auditable ) {\n" +#~ " creates++;\n" +#~ " for ( int i=0; i<propertyNames.length; i++ ) {\n" +#~ " if ( \"createTimestamp\".equals( propertyNames[i] ) ) {\n" +#~ " state[i] = new Date();\n" +#~ " return true;\n" +#~ " }\n" +#~ " }\n" +#~ " }\n" +#~ " return false;\n" +#~ " }\n" +#~ "\n" +#~ " public void afterTransactionCompletion(Transaction tx) {\n" +#~ " if ( tx.wasCommitted() ) {\n" +#~ " System.out.println(\"Creations: \" + creates + \", Updates: " +#~ "\" + updates,\n" +#~ " \"Loads: \" + loads);\n" +#~ " }\n" +#~ " updates=0;\n" +#~ " creates=0;\n" +#~ " loads=0;\n" +#~ " }\n" +#~ "\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Session session = sf.openSession( new AuditInterceptor() );]]>" +#~ msgstr "Session session = sf.openSession( new AuditInterceptor() );" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[new Configuration().setInterceptor( new AuditInterceptor() );]]>" +#~ msgstr "new Configuration().setInterceptor( new AuditInterceptor() );" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[public class MyLoadListener implements LoadEventListener {\n" +#~ " // this is the single method defined by the LoadEventListener " +#~ "interface\n" +#~ " public void onLoad(LoadEvent event, LoadEventListener.LoadType " +#~ "loadType)\n" +#~ " throws HibernateException {\n" +#~ " if ( !MySecurity.isAuthorized( event.getEntityClassName(), event." +#~ "getEntityId() ) ) {\n" +#~ " throw MySecurityException(\"Unauthorized access\");\n" +#~ " }\n" +#~ " }\n" +#~ "}]]>" +#~ msgstr "" +#~ "public class MyLoadListener implements LoadEventListener {\n" +#~ " // this is the single method defined by the LoadEventListener " +#~ "interface\n" +#~ " public void onLoad(LoadEvent event, LoadEventListener.LoadType " +#~ "loadType)\n" +#~ " throws HibernateException {\n" +#~ " if ( !MySecurity.isAuthorized( event.getEntityClassName(), event." +#~ "getEntityId() ) ) {\n" +#~ " throw MySecurityException(\"Unauthorized access\");\n" +#~ " }\n" +#~ " }\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<hibernate-configuration>\n" +#~ " <session-factory>\n" +#~ " ...\n" +#~ " <event type=\"load\">\n" +#~ " <listener class=\"com.eg.MyLoadListener\"/>\n" +#~ " <listener class=\"org.hibernate.event.def." +#~ "DefaultLoadEventListener\"/>\n" +#~ " </event>\n" +#~ " </session-factory>\n" +#~ "</hibernate-configuration>]]>" +#~ msgstr "" +#~ "<hibernate-configuration>\n" +#~ " <session-factory>\n" +#~ " ...\n" +#~ " <event type=\"load\">\n" +#~ " <listener class=\"com.eg.MyLoadListener\"/>\n" +#~ " <listener class=\"org.hibernate.event.def." +#~ "DefaultLoadEventListener\"/>\n" +#~ " </event>\n" +#~ " </session-factory>\n" +#~ "</hibernate-configuration>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Configuration cfg = new Configuration();\n" +#~ "LoadEventListener[] stack = { new MyLoadListener(), new " +#~ "DefaultLoadEventListener() };\n" +#~ "cfg.EventListeners().setLoadEventListeners(stack);]]>" +#~ msgstr "" +#~ "Configuration cfg = new Configuration();\n" +#~ "LoadEventListener[] stack = { new MyLoadListener(), new " +#~ "DefaultLoadEventListener() };\n" +#~ "cfg.EventListeners().setLoadEventListeners(stack);" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<listener type=\"pre-delete\" class=\"org.hibernate.secure." +#~ "JACCPreDeleteEventListener\"/>\n" +#~ "<listener type=\"pre-update\" class=\"org.hibernate.secure." +#~ "JACCPreUpdateEventListener\"/>\n" +#~ "<listener type=\"pre-insert\" class=\"org.hibernate.secure." +#~ "JACCPreInsertEventListener\"/>\n" +#~ "<listener type=\"pre-load\" class=\"org.hibernate.secure." +#~ "JACCPreLoadEventListener\"/>]]>" +#~ msgstr "" +#~ "<listener type=\"pre-delete\" class=\"org.hibernate.secure." +#~ "JACCPreDeleteEventListener\"/>\n" +#~ "<listener type=\"pre-update\" class=\"org.hibernate.secure." +#~ "JACCPreUpdateEventListener\"/>\n" +#~ "<listener type=\"pre-insert\" class=\"org.hibernate.secure." +#~ "JACCPreInsertEventListener\"/>\n" +#~ "<listener type=\"pre-load\" class=\"org.hibernate.secure." +#~ "JACCPreLoadEventListener\"/>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<grant role=\"admin\" entity-name=\"User\" actions=\"insert," +#~ "update,read\"/>\n" +#~ "<grant role=\"su\" entity-name=\"User\" actions=\"*\"/>]]>" +#~ msgstr "" +#~ "<grant role=\"admin\" entity-name=\"User\" actions=\"insert,update,read" +#~ "\"/>\n" +#~ "<grant role=\"su\" entity-name=\"User\" actions=\"*\"/>" Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/example_mappings.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/example_mappings.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/example_mappings.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,1556 @@ +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# Language /mnt/hgfs/base/Hibernate/Reference translations for PACKAGE package. +# Copyright (C) 2006, 2007 Free Software Foundation, Inc. +# Automatically generated, 2006. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# +msgid "" +msgstr "" +"Project-Id-Version: Collection_Mapping\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2009-12-03T00:15:26\n" +"PO-Revision-Date: 2007-02-26 10:27+1000\n" +"Last-Translator: \n" +"Language-Team: <de(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.9.1\n" + +#. Tag: title +#, no-c-format +msgid "Example: Various Mappings" +msgstr "Beispiel: Verschiedene Mappings" + +#. Tag: para +#, fuzzy, no-c-format +msgid "This chapters explores some more complex association mappings." +msgstr "Diese Kapitel erläutern komplexere Assoziations-Mappings." + +#. Tag: title +#, no-c-format +msgid "Employer/Employee" +msgstr "Arbeitgeber/Arbeitnehmer" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The following model of the relationship between <literal>Employer</literal> " +"and <literal>Employee</literal> uses an entity class (<literal>Employment</" +"literal>) to represent the association. You can do this when there might be " +"more than one period of employment for the same two parties. Components are " +"used to model monetary values and employee names." +msgstr "" +"Das folgende Modell der Beziehung zwischen <literal>Employer</literal> " +"(Arbeitgeber) und <literal>Employee</literal> (Arbeitnehmer) verwendet eine " +"tatsächliche Entity-Klasse (<literal>Employment</literal>) zur " +"Repräsentation der Assoziation. Das geschieht, weil für die beiden selben " +"beteiligten Parteien mehr als ein Beschäftigungszeitraum existieren kann. " +"Komponenten werden als Modell für Geldwerte und Arbeitnehmernamen benutzt." + +#. Tag: para +#, fuzzy, no-c-format +msgid "Here is a possible mapping document:" +msgstr "Nachfolgend sehen Sie ein mögliches Mapping-Dokument:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "Here is the table schema generated by <literal>SchemaExport</literal>." +msgstr "" +"Und hier sehen Sie das durch <literal>SchemaExport</literal> generierte " +"Tabellenschema." + +#. Tag: title +#, no-c-format +msgid "Author/Work" +msgstr "Autor/Werk" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Consider the following model of the relationships between <literal>Work</" +"literal>, <literal>Author</literal> and <literal>Person</literal>. In the " +"example, the relationship between <literal>Work</literal> and " +"<literal>Author</literal> is represented as a many-to-many association and " +"the relationship between <literal>Author</literal> and <literal>Person</" +"literal> is represented as one-to-one association. Another possibility would " +"be to have <literal>Author</literal> extend <literal>Person</literal>." +msgstr "" +"Betrachten Sie das folgende Modell der Beziehungen zwischen <literal>Work</" +"literal>, <literal>Author</literal> und <literal>Person</literal>. Wir " +"repräsentieren die Beziehung zwischen <literal>Work</literal> und " +"<literal>Author</literal> als eine \"Many-to-Many\"-Assoziation. Wir " +"entscheiden uns dafür, die Beziehung zwischen <literal>Author</literal> und " +"<literal>Person</literal> als \"One-to-One\"-Assoziation zu wählen. Eine " +"weitere Möglichkeit wäre die Erweiterung von <literal>Person</literal> durch " +"<literal>Author</literal>." + +#. Tag: para +#, no-c-format +msgid "" +"The following mapping document correctly represents these relationships:" +msgstr "" +"Das folgende Mapping-Dokument repräsentiert diese Beziehungen auf korrekte " +"Weise:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"There are four tables in this mapping: <literal>works</literal>, " +"<literal>authors</literal> and <literal>persons</literal> hold work, author " +"and person data respectively. <literal>author_work</literal> is an " +"association table linking authors to works. Here is the table schema, as " +"generated by <literal>SchemaExport</literal>:" +msgstr "" +"Dieses Mapping enthält vier Tabellen. <literal>works</literal>, " +"<literal>authors</literal> und <literal>persons</literal> enthalten Daten zu " +"Werk, Autor und Person. Bei <literal>author_work</literal> handelt es sich " +"um eine Assoziationstabelle, die Autoren mit Werken verbindet. Nachfolgend " +"sehen Sie das durch <literal>SchemaExport</literal> generierte " +"Tabellenschema." + +#. Tag: title +#, no-c-format +msgid "Customer/Order/Product" +msgstr "Kunde/Bestellung/Produkt" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"In this section we consider a model of the relationships between " +"<literal>Customer</literal>, <literal>Order</literal>, <literal>Line Item</" +"literal> and <literal>Product</literal>. There is a one-to-many association " +"between <literal>Customer</literal> and <literal>Order</literal>, but how " +"can you represent <literal>Order</literal> / <literal>LineItem</literal> / " +"<literal>Product</literal>? In the example, <literal>LineItem</literal> is " +"mapped as an association class representing the many-to-many association " +"between <literal>Order</literal> and <literal>Product</literal>. In " +"Hibernate this is called a composite element." +msgstr "" +"Betrachten wir nun ein Modell der Beziehungen zwischen <literal>Customer</" +"literal>, <literal>Order</literal> und <literal>LineItem</literal> sowie " +"<literal>Product</literal>. Zwischen <literal>Customer</literal> und " +"<literal>Order</literal> existiert eine \"One-to-Many\"-Assoziation, wie " +"aber sollen <literal>Order</literal> / <literal>LineItem</literal> / " +"<literal>Product</literal> repräsentiert werden? Wir entscheiden uns hier " +"für das Mappen von <literal>LineItem</literal> als eine Assoziationsklasse, " +"die die \"Many-to-Many\"-Assoziation zwischen <literal>Order</literal> und " +"<literal>Product</literal> repräsentiert. In Hibernate wird dies als " +"\"Composite Element\" (d.h. als \"zusammengesetztes Element\") bezeichnet." + +#. Tag: para +#, fuzzy, no-c-format +msgid "The mapping document will look like this:" +msgstr "Das Mapping-Dokument:" + +#. Tag: para +#, no-c-format +msgid "" +"<literal>customers</literal>, <literal>orders</literal>, " +"<literal>line_items</literal> and <literal>products</literal> hold customer, " +"order, order line item and product data respectively. <literal>line_items</" +"literal> also acts as an association table linking orders with products." +msgstr "" +"<literal>customers</literal>, <literal>orders</literal>, " +"<literal>line_items</literal> und <literal>products</literal> enthalten " +"Kunde, Bestellung, Bestellungsbelegzeile und Produktdaten. " +"<literal>line_items</literal> fungiert auch als Assoziationstabelle, die " +"Bestellungen mit Produkten verbindet." + +#. Tag: title +#, no-c-format +msgid "Miscellaneous example mappings" +msgstr "Verschiedene Beispiele von Mappings" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"These examples are available from the Hibernate test suite. You will find " +"many other useful example mappings there by searching in the <literal>test</" +"literal> folder of the Hibernate distribution." +msgstr "" +"Diese Beispiele wurden der Hibernate Testfolge entnommen. Sie finden dort " +"auch viele weitere nützliche Beispiele. Schauen Sie einfach in den " +"<literal>test</literal>-Ordner der Hibernate Distribution." + +#. Tag: title +#, no-c-format +msgid "\"Typed\" one-to-one association" +msgstr "Typisierte \"One-to-One\"-Assoziation" + +#. Tag: title +#, no-c-format +msgid "Composite key example" +msgstr "Beispiel für einen zusammengesetzten Schlüssel" + +#. Tag: title +#, no-c-format +msgid "Many-to-many with shared composite key attribute" +msgstr "" +"\"Many-to-Many\" mit geteiltem Attribut des zusammengesetzten Schlüssels" + +#. Tag: title +#, no-c-format +msgid "Content based discrimination" +msgstr "Inhaltsbasierte Diskriminierung" + +#. Tag: title +#, no-c-format +msgid "Associations on alternate keys" +msgstr "Assoziationen bei wechselnden Schlüsseln" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<hibernate-mapping>\n" +#~ " \n" +#~ " <class name=\"Employer\" table=\"employers\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"sequence\">\n" +#~ " <param name=\"sequence\">employer_id_seq</param>\n" +#~ " </generator>\n" +#~ " </id>\n" +#~ " <property name=\"name\"/>\n" +#~ " </class>\n" +#~ "\n" +#~ " <class name=\"Employment\" table=\"employment_periods\">\n" +#~ "\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"sequence\">\n" +#~ " <param name=\"sequence\">employment_id_seq</param>\n" +#~ " </generator>\n" +#~ " </id>\n" +#~ " <property name=\"startDate\" column=\"start_date\"/>\n" +#~ " <property name=\"endDate\" column=\"end_date\"/>\n" +#~ "\n" +#~ " <component name=\"hourlyRate\" class=\"MonetaryAmount\">\n" +#~ " <property name=\"amount\">\n" +#~ " <column name=\"hourly_rate\" sql-type=\"NUMERIC(12, 2)\"/" +#~ ">\n" +#~ " </property>\n" +#~ " <property name=\"currency\" length=\"12\"/>\n" +#~ " </component>\n" +#~ "\n" +#~ " <many-to-one name=\"employer\" column=\"employer_id\" not-null=" +#~ "\"true\"/>\n" +#~ " <many-to-one name=\"employee\" column=\"employee_id\" not-null=" +#~ "\"true\"/>\n" +#~ "\n" +#~ " </class>\n" +#~ "\n" +#~ " <class name=\"Employee\" table=\"employees\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"sequence\">\n" +#~ " <param name=\"sequence\">employee_id_seq</param>\n" +#~ " </generator>\n" +#~ " </id>\n" +#~ " <property name=\"taxfileNumber\"/>\n" +#~ " <component name=\"name\" class=\"Name\">\n" +#~ " <property name=\"firstName\"/>\n" +#~ " <property name=\"initial\"/>\n" +#~ " <property name=\"lastName\"/>\n" +#~ " </component>\n" +#~ " </class>\n" +#~ "\n" +#~ "</hibernate-mapping>]]>" +#~ msgstr "" +#~ "<hibernate-mapping>\n" +#~ " \n" +#~ " <class name=\"Employer\" table=\"employers\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"sequence\">\n" +#~ " <param name=\"sequence\">employer_id_seq</" +#~ "param>\n" +#~ " </generator>\n" +#~ " </id>\n" +#~ " <property name=\"name\"/>\n" +#~ " </class>\n" +#~ "\n" +#~ " <class name=\"Employment\" table=\"employment_periods\">\n" +#~ "\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"sequence\">\n" +#~ " <param name=\"sequence\">employment_id_seq</" +#~ "param>\n" +#~ " </generator>\n" +#~ " </id>\n" +#~ " <property name=\"startDate\" column=\"start_date\"/>\n" +#~ " <property name=\"endDate\" column=\"end_date\"/>\n" +#~ "\n" +#~ " <component name=\"hourlyRate\" class=\"MonetaryAmount\">\n" +#~ " <property name=\"amount\">\n" +#~ " <column name=\"hourly_rate\" sql-type=\"NUMERIC(12, 2)" +#~ "\"/>\n" +#~ " </property>\n" +#~ " <property name=\"currency\" length=\"12\"/>\n" +#~ " </component>\n" +#~ "\n" +#~ " <many-to-one name=\"employer\" column=\"employer_id\" not-null=" +#~ "\"true\"/>\n" +#~ " <many-to-one name=\"employee\" column=\"employee_id\" not-null=" +#~ "\"true\"/>\n" +#~ "\n" +#~ " </class>\n" +#~ "\n" +#~ " <class name=\"Employee\" table=\"employees\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"sequence\">\n" +#~ " <param name=\"sequence\">employee_id_seq</" +#~ "param>\n" +#~ " </generator>\n" +#~ " </id>\n" +#~ " <property name=\"taxfileNumber\"/>\n" +#~ " <component name=\"name\" class=\"Name\">\n" +#~ " <property name=\"firstName\"/>\n" +#~ " <property name=\"initial\"/>\n" +#~ " <property name=\"lastName\"/>\n" +#~ " </component>\n" +#~ " </class>\n" +#~ "\n" +#~ "</hibernate-mapping>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[create table employers (\n" +#~ " id BIGINT not null, \n" +#~ " name VARCHAR(255), \n" +#~ " primary key (id)\n" +#~ ")\n" +#~ "\n" +#~ "create table employment_periods (\n" +#~ " id BIGINT not null,\n" +#~ " hourly_rate NUMERIC(12, 2),\n" +#~ " currency VARCHAR(12), \n" +#~ " employee_id BIGINT not null, \n" +#~ " employer_id BIGINT not null, \n" +#~ " end_date TIMESTAMP, \n" +#~ " start_date TIMESTAMP, \n" +#~ " primary key (id)\n" +#~ ")\n" +#~ "\n" +#~ "create table employees (\n" +#~ " id BIGINT not null, \n" +#~ " firstName VARCHAR(255), \n" +#~ " initial CHAR(1), \n" +#~ " lastName VARCHAR(255), \n" +#~ " taxfileNumber VARCHAR(255), \n" +#~ " primary key (id)\n" +#~ ")\n" +#~ "\n" +#~ "alter table employment_periods \n" +#~ " add constraint employment_periodsFK0 foreign key (employer_id) " +#~ "references employers\n" +#~ "alter table employment_periods \n" +#~ " add constraint employment_periodsFK1 foreign key (employee_id) " +#~ "references employees\n" +#~ "create sequence employee_id_seq\n" +#~ "create sequence employment_id_seq\n" +#~ "create sequence employer_id_seq]]>" +#~ msgstr "" +#~ "create table employers (\n" +#~ " id BIGINT not null, \n" +#~ " name VARCHAR(255), \n" +#~ " primary key (id)\n" +#~ ")\n" +#~ "\n" +#~ "create table employment_periods (\n" +#~ " id BIGINT not null,\n" +#~ " hourly_rate NUMERIC(12, 2),\n" +#~ " currency VARCHAR(12), \n" +#~ " employee_id BIGINT not null, \n" +#~ " employer_id BIGINT not null, \n" +#~ " end_date TIMESTAMP, \n" +#~ " start_date TIMESTAMP, \n" +#~ " primary key (id)\n" +#~ ")\n" +#~ "\n" +#~ "create table employees (\n" +#~ " id BIGINT not null, \n" +#~ " firstName VARCHAR(255), \n" +#~ " initial CHAR(1), \n" +#~ " lastName VARCHAR(255), \n" +#~ " taxfileNumber VARCHAR(255), \n" +#~ " primary key (id)\n" +#~ ")\n" +#~ "\n" +#~ "alter table employment_periods \n" +#~ " add constraint employment_periodsFK0 foreign key (employer_id) " +#~ "references employers\n" +#~ "alter table employment_periods \n" +#~ " add constraint employment_periodsFK1 foreign key (employee_id) " +#~ "references employees\n" +#~ "create sequence employee_id_seq\n" +#~ "create sequence employment_id_seq\n" +#~ "create sequence employer_id_seq" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<hibernate-mapping>\n" +#~ "\n" +#~ " <class name=\"Work\" table=\"works\" discriminator-value=\"W\">\n" +#~ "\n" +#~ " <id name=\"id\" column=\"id\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <discriminator column=\"type\" type=\"character\"/>\n" +#~ "\n" +#~ " <property name=\"title\"/>\n" +#~ " <set name=\"authors\" table=\"author_work\">\n" +#~ " <key column name=\"work_id\"/>\n" +#~ " <many-to-many class=\"Author\" column name=\"author_id\"/>\n" +#~ " </set>\n" +#~ "\n" +#~ " <subclass name=\"Book\" discriminator-value=\"B\">\n" +#~ " <property name=\"text\"/>\n" +#~ " </subclass>\n" +#~ "\n" +#~ " <subclass name=\"Song\" discriminator-value=\"S\">\n" +#~ " <property name=\"tempo\"/>\n" +#~ " <property name=\"genre\"/>\n" +#~ " </subclass>\n" +#~ "\n" +#~ " </class>\n" +#~ "\n" +#~ " <class name=\"Author\" table=\"authors\">\n" +#~ "\n" +#~ " <id name=\"id\" column=\"id\">\n" +#~ " \n" +#~ " <generator class=\"assigned\"/> \n" +#~ " </id>\n" +#~ "\n" +#~ " <property name=\"alias\"/>\n" +#~ " <one-to-one name=\"person\" constrained=\"true\"/>\n" +#~ "\n" +#~ " <set name=\"works\" table=\"author_work\" inverse=\"true" +#~ "\">\n" +#~ " <key column=\"author_id\"/>\n" +#~ " <many-to-many class=\"Work\" column=\"work_id\"/>\n" +#~ " </set>\n" +#~ "\n" +#~ " </class>\n" +#~ "\n" +#~ " <class name=\"Person\" table=\"persons\">\n" +#~ " <id name=\"id\" column=\"id\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <property name=\"name\"/>\n" +#~ " </class>\n" +#~ "\n" +#~ "</hibernate-mapping>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[create table works (\n" +#~ " id BIGINT not null generated by default as identity, \n" +#~ " tempo FLOAT, \n" +#~ " genre VARCHAR(255), \n" +#~ " text INTEGER, \n" +#~ " title VARCHAR(255), \n" +#~ " type CHAR(1) not null, \n" +#~ " primary key (id)\n" +#~ ")\n" +#~ "\n" +#~ "create table author_work (\n" +#~ " author_id BIGINT not null, \n" +#~ " work_id BIGINT not null, \n" +#~ " primary key (work_id, author_id)\n" +#~ ")\n" +#~ "\n" +#~ "create table authors (\n" +#~ " id BIGINT not null generated by default as identity, \n" +#~ " alias VARCHAR(255), \n" +#~ " primary key (id)\n" +#~ ")\n" +#~ "\n" +#~ "create table persons (\n" +#~ " id BIGINT not null generated by default as identity, \n" +#~ " name VARCHAR(255), \n" +#~ " primary key (id)\n" +#~ ")\n" +#~ "\n" +#~ "alter table authors \n" +#~ " add constraint authorsFK0 foreign key (id) references persons\n" +#~ "alter table author_work \n" +#~ " add constraint author_workFK0 foreign key (author_id) references " +#~ "authors\n" +#~ "alter table author_work\n" +#~ " add constraint author_workFK1 foreign key (work_id) references works]]" +#~ ">" +#~ msgstr "" +#~ "create table works (\n" +#~ " id BIGINT not null generated by default as identity, \n" +#~ " tempo FLOAT, \n" +#~ " genre VARCHAR(255), \n" +#~ " text INTEGER, \n" +#~ " title VARCHAR(255), \n" +#~ " type CHAR(1) not null, \n" +#~ " primary key (id)\n" +#~ ")\n" +#~ "\n" +#~ "create table author_work (\n" +#~ " author_id BIGINT not null, \n" +#~ " work_id BIGINT not null, \n" +#~ " primary key (work_id, author_id)\n" +#~ ")\n" +#~ "\n" +#~ "create table authors (\n" +#~ " id BIGINT not null generated by default as identity, \n" +#~ " alias VARCHAR(255), \n" +#~ " primary key (id)\n" +#~ ")\n" +#~ "\n" +#~ "create table persons (\n" +#~ " id BIGINT not null generated by default as identity, \n" +#~ " name VARCHAR(255), \n" +#~ " primary key (id)\n" +#~ ")\n" +#~ "\n" +#~ "alter table authors \n" +#~ " add constraint authorsFK0 foreign key (id) references persons\n" +#~ "alter table author_work \n" +#~ " add constraint author_workFK0 foreign key (author_id) references " +#~ "authors\n" +#~ "alter table author_work\n" +#~ " add constraint author_workFK1 foreign key (work_id) references works" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<hibernate-mapping>\n" +#~ "\n" +#~ " <class name=\"Customer\" table=\"customers\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <property name=\"name\"/>\n" +#~ " <set name=\"orders\" inverse=\"true\">\n" +#~ " <key column=\"customer_id\"/>\n" +#~ " <one-to-many class=\"Order\"/>\n" +#~ " </set>\n" +#~ " </class>\n" +#~ "\n" +#~ " <class name=\"Order\" table=\"orders\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <property name=\"date\"/>\n" +#~ " <many-to-one name=\"customer\" column=\"customer_id\"/>\n" +#~ " <list name=\"lineItems\" table=\"line_items\">\n" +#~ " <key column=\"order_id\"/>\n" +#~ " <list-index column=\"line_number\"/>\n" +#~ " <composite-element class=\"LineItem\">\n" +#~ " <property name=\"quantity\"/>\n" +#~ " <many-to-one name=\"product\" column=\"product_id\"/>\n" +#~ " </composite-element>\n" +#~ " </list>\n" +#~ " </class>\n" +#~ "\n" +#~ " <class name=\"Product\" table=\"products\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <property name=\"serialNumber\"/>\n" +#~ " </class>\n" +#~ "\n" +#~ "</hibernate-mapping>]]>" +#~ msgstr "" +#~ "<hibernate-mapping>\n" +#~ "\n" +#~ " <class name=\"Customer\" table=\"customers\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <property name=\"name\"/>\n" +#~ " <set name=\"orders\" inverse=\"true\">\n" +#~ " <key column=\"customer_id\"/>\n" +#~ " <one-to-many class=\"Order\"/>\n" +#~ " </set>\n" +#~ " </class>\n" +#~ "\n" +#~ " <class name=\"Order\" table=\"orders\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <property name=\"date\"/>\n" +#~ " <many-to-one name=\"customer\" column=\"customer_id\"/>\n" +#~ " <list name=\"lineItems\" table=\"line_items\">\n" +#~ " <key column=\"order_id\"/>\n" +#~ " <list-index column=\"line_number\"/>\n" +#~ " <composite-element class=\"LineItem\">\n" +#~ " <property name=\"quantity\"/>\n" +#~ " <many-to-one name=\"product\" column=\"product_id\"/" +#~ ">\n" +#~ " </composite-element>\n" +#~ " </list>\n" +#~ " </class>\n" +#~ "\n" +#~ " <class name=\"Product\" table=\"products\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <property name=\"serialNumber\"/>\n" +#~ " </class>\n" +#~ "\n" +#~ "</hibernate-mapping>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[create table customers (\n" +#~ " id BIGINT not null generated by default as identity, \n" +#~ " name VARCHAR(255), \n" +#~ " primary key (id)\n" +#~ ")\n" +#~ "\n" +#~ "create table orders (\n" +#~ " id BIGINT not null generated by default as identity, \n" +#~ " customer_id BIGINT, \n" +#~ " date TIMESTAMP, \n" +#~ " primary key (id)\n" +#~ ")\n" +#~ "\n" +#~ "create table line_items (\n" +#~ " line_number INTEGER not null, \n" +#~ " order_id BIGINT not null, \n" +#~ " product_id BIGINT, \n" +#~ " quantity INTEGER, \n" +#~ " primary key (order_id, line_number)\n" +#~ ")\n" +#~ "\n" +#~ "create table products (\n" +#~ " id BIGINT not null generated by default as identity, \n" +#~ " serialNumber VARCHAR(255), \n" +#~ " primary key (id)\n" +#~ ")\n" +#~ "\n" +#~ "alter table orders \n" +#~ " add constraint ordersFK0 foreign key (customer_id) references " +#~ "customers\n" +#~ "alter table line_items\n" +#~ " add constraint line_itemsFK0 foreign key (product_id) references " +#~ "products\n" +#~ "alter table line_items\n" +#~ " add constraint line_itemsFK1 foreign key (order_id) references " +#~ "orders]]>" +#~ msgstr "" +#~ "create table customers (\n" +#~ " id BIGINT not null generated by default as identity, \n" +#~ " name VARCHAR(255), \n" +#~ " primary key (id)\n" +#~ ")\n" +#~ "\n" +#~ "create table orders (\n" +#~ " id BIGINT not null generated by default as identity, \n" +#~ " customer_id BIGINT, \n" +#~ " date TIMESTAMP, \n" +#~ " primary key (id)\n" +#~ ")\n" +#~ "\n" +#~ "create table line_items (\n" +#~ " line_number INTEGER not null, \n" +#~ " order_id BIGINT not null, \n" +#~ " product_id BIGINT, \n" +#~ " quantity INTEGER, \n" +#~ " primary key (order_id, line_number)\n" +#~ ")\n" +#~ "\n" +#~ "create table products (\n" +#~ " id BIGINT not null generated by default as identity, \n" +#~ " serialNumber VARCHAR(255), \n" +#~ " primary key (id)\n" +#~ ")\n" +#~ "\n" +#~ "alter table orders \n" +#~ " add constraint ordersFK0 foreign key (customer_id) references " +#~ "customers\n" +#~ "alter table line_items\n" +#~ " add constraint line_itemsFK0 foreign key (product_id) references " +#~ "products\n" +#~ "alter table line_items\n" +#~ " add constraint line_itemsFK1 foreign key (order_id) references orders" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Person\">\n" +#~ " <id name=\"name\"/>\n" +#~ " <one-to-one name=\"address\" \n" +#~ " cascade=\"all\">\n" +#~ " <formula>name</formula>\n" +#~ " <formula>'HOME'</formula>\n" +#~ " </one-to-one>\n" +#~ " <one-to-one name=\"mailingAddress\" \n" +#~ " cascade=\"all\">\n" +#~ " <formula>name</formula>\n" +#~ " <formula>'MAILING'</formula>\n" +#~ " </one-to-one>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\" batch-size=\"2\" \n" +#~ " check=\"addressType in ('MAILING', 'HOME', 'BUSINESS')\">\n" +#~ " <composite-id>\n" +#~ " <key-many-to-one name=\"person\" \n" +#~ " column=\"personName\"/>\n" +#~ " <key-property name=\"type\" \n" +#~ " column=\"addressType\"/>\n" +#~ " </composite-id>\n" +#~ " <property name=\"street\" type=\"text\"/>\n" +#~ " <property name=\"state\"/>\n" +#~ " <property name=\"zip\"/>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Person\">\n" +#~ " <id name=\"name\"/>\n" +#~ " <one-to-one name=\"address\" \n" +#~ " cascade=\"all\">\n" +#~ " <formula>name</formula>\n" +#~ " <formula>'HOME'</formula>\n" +#~ " </one-to-one>\n" +#~ " <one-to-one name=\"mailingAddress\" \n" +#~ " cascade=\"all\">\n" +#~ " <formula>name</formula>\n" +#~ " <formula>'MAILING'</formula>\n" +#~ " </one-to-one>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\" batch-size=\"2\" \n" +#~ " check=\"addressType in ('MAILING', 'HOME', 'BUSINESS')\">\n" +#~ " <composite-id>\n" +#~ " <key-many-to-one name=\"person\" \n" +#~ " column=\"personName\"/>\n" +#~ " <key-property name=\"type\" \n" +#~ " column=\"addressType\"/>\n" +#~ " </composite-id>\n" +#~ " <property name=\"street\" type=\"text\"/>\n" +#~ " <property name=\"state\"/>\n" +#~ " <property name=\"zip\"/>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Customer\">\n" +#~ "\n" +#~ " <id name=\"customerId\"\n" +#~ " length=\"10\">\n" +#~ " <generator class=\"assigned\"/>\n" +#~ " </id>\n" +#~ "\n" +#~ " <property name=\"name\" not-null=\"true\" length=\"100\"/>\n" +#~ " <property name=\"address\" not-null=\"true\" length=\"200\"/>\n" +#~ "\n" +#~ " <list name=\"orders\"\n" +#~ " inverse=\"true\"\n" +#~ " cascade=\"save-update\">\n" +#~ " <key column=\"customerId\"/>\n" +#~ " <index column=\"orderNumber\"/>\n" +#~ " <one-to-many class=\"Order\"/>\n" +#~ " </list>\n" +#~ "\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Order\" table=\"CustomerOrder\" lazy=\"true\">\n" +#~ " <synchronize table=\"LineItem\"/>\n" +#~ " <synchronize table=\"Product\"/>\n" +#~ " \n" +#~ " <composite-id name=\"id\" \n" +#~ " class=\"Order$Id\">\n" +#~ " <key-property name=\"customerId\" length=\"10\"/>\n" +#~ " <key-property name=\"orderNumber\"/>\n" +#~ " </composite-id>\n" +#~ " \n" +#~ " <property name=\"orderDate\" \n" +#~ " type=\"calendar_date\"\n" +#~ " not-null=\"true\"/>\n" +#~ " \n" +#~ " <property name=\"total\">\n" +#~ " <formula>\n" +#~ " ( select sum(li.quantity*p.price) \n" +#~ " from LineItem li, Product p \n" +#~ " where li.productId = p.productId \n" +#~ " and li.customerId = customerId \n" +#~ " and li.orderNumber = orderNumber )\n" +#~ " </formula>\n" +#~ " </property>\n" +#~ " \n" +#~ " <many-to-one name=\"customer\"\n" +#~ " column=\"customerId\"\n" +#~ " insert=\"false\"\n" +#~ " update=\"false\" \n" +#~ " not-null=\"true\"/>\n" +#~ " \n" +#~ " <bag name=\"lineItems\"\n" +#~ " fetch=\"join\" \n" +#~ " inverse=\"true\"\n" +#~ " cascade=\"save-update\">\n" +#~ " <key>\n" +#~ " <column name=\"customerId\"/>\n" +#~ " <column name=\"orderNumber\"/>\n" +#~ " </key>\n" +#~ " <one-to-many class=\"LineItem\"/>\n" +#~ " </bag>\n" +#~ " \n" +#~ "</class>\n" +#~ " \n" +#~ "<class name=\"LineItem\">\n" +#~ " \n" +#~ " <composite-id name=\"id\" \n" +#~ " class=\"LineItem$Id\">\n" +#~ " <key-property name=\"customerId\" length=\"10\"/>\n" +#~ " <key-property name=\"orderNumber\"/>\n" +#~ " <key-property name=\"productId\" length=\"10\"/>\n" +#~ " </composite-id>\n" +#~ " \n" +#~ " <property name=\"quantity\"/>\n" +#~ " \n" +#~ " <many-to-one name=\"order\"\n" +#~ " insert=\"false\"\n" +#~ " update=\"false\" \n" +#~ " not-null=\"true\">\n" +#~ " <column name=\"customerId\"/>\n" +#~ " <column name=\"orderNumber\"/>\n" +#~ " </many-to-one>\n" +#~ " \n" +#~ " <many-to-one name=\"product\"\n" +#~ " insert=\"false\"\n" +#~ " update=\"false\" \n" +#~ " not-null=\"true\"\n" +#~ " column=\"productId\"/>\n" +#~ " \n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Product\">\n" +#~ " <synchronize table=\"LineItem\"/>\n" +#~ "\n" +#~ " <id name=\"productId\"\n" +#~ " length=\"10\">\n" +#~ " <generator class=\"assigned\"/>\n" +#~ " </id>\n" +#~ " \n" +#~ " <property name=\"description\" \n" +#~ " not-null=\"true\" \n" +#~ " length=\"200\"/>\n" +#~ " <property name=\"price\" length=\"3\"/>\n" +#~ " <property name=\"numberAvailable\"/>\n" +#~ " \n" +#~ " <property name=\"numberOrdered\">\n" +#~ " <formula>\n" +#~ " ( select sum(li.quantity) \n" +#~ " from LineItem li \n" +#~ " where li.productId = productId )\n" +#~ " </formula>\n" +#~ " </property>\n" +#~ " \n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Customer\">\n" +#~ "\n" +#~ " <id name=\"customerId\"\n" +#~ " length=\"10\">\n" +#~ " <generator class=\"assigned\"/>\n" +#~ " </id>\n" +#~ "\n" +#~ " <property name=\"name\" not-null=\"true\" length=\"100\"/>\n" +#~ " <property name=\"address\" not-null=\"true\" length=\"200\"/>\n" +#~ "\n" +#~ " <list name=\"orders\"\n" +#~ " inverse=\"true\"\n" +#~ " cascade=\"save-update\">\n" +#~ " <key column=\"customerId\"/>\n" +#~ " <index column=\"orderNumber\"/>\n" +#~ " <one-to-many class=\"Order\"/>\n" +#~ " </list>\n" +#~ "\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Order\" table=\"CustomerOrder\" lazy=\"true\">\n" +#~ " <synchronize table=\"LineItem\"/>\n" +#~ " <synchronize table=\"Product\"/>\n" +#~ " \n" +#~ " <composite-id name=\"id\" \n" +#~ " class=\"Order$Id\">\n" +#~ " <key-property name=\"customerId\" length=\"10\"/>\n" +#~ " <key-property name=\"orderNumber\"/>\n" +#~ " </composite-id>\n" +#~ " \n" +#~ " <property name=\"orderDate\" \n" +#~ " type=\"calendar_date\"\n" +#~ " not-null=\"true\"/>\n" +#~ " \n" +#~ " <property name=\"total\">\n" +#~ " <formula>\n" +#~ " ( select sum(li.quantity*p.price) \n" +#~ " from LineItem li, Product p \n" +#~ " where li.productId = p.productId \n" +#~ " and li.customerId = customerId \n" +#~ " and li.orderNumber = orderNumber )\n" +#~ " </formula>\n" +#~ " </property>\n" +#~ " \n" +#~ " <many-to-one name=\"customer\"\n" +#~ " column=\"customerId\"\n" +#~ " insert=\"false\"\n" +#~ " update=\"false\" \n" +#~ " not-null=\"true\"/>\n" +#~ " \n" +#~ " <bag name=\"lineItems\"\n" +#~ " fetch=\"join\" \n" +#~ " inverse=\"true\"\n" +#~ " cascade=\"save-update\">\n" +#~ " <key>\n" +#~ " <column name=\"customerId\"/>\n" +#~ " <column name=\"orderNumber\"/>\n" +#~ " </key>\n" +#~ " <one-to-many class=\"LineItem\"/>\n" +#~ " </bag>\n" +#~ " \n" +#~ "</class>\n" +#~ " \n" +#~ "<class name=\"LineItem\">\n" +#~ " \n" +#~ " <composite-id name=\"id\" \n" +#~ " class=\"LineItem$Id\">\n" +#~ " <key-property name=\"customerId\" length=\"10\"/>\n" +#~ " <key-property name=\"orderNumber\"/>\n" +#~ " <key-property name=\"productId\" length=\"10\"/>\n" +#~ " </composite-id>\n" +#~ " \n" +#~ " <property name=\"quantity\"/>\n" +#~ " \n" +#~ " <many-to-one name=\"order\"\n" +#~ " insert=\"false\"\n" +#~ " update=\"false\" \n" +#~ " not-null=\"true\">\n" +#~ " <column name=\"customerId\"/>\n" +#~ " <column name=\"orderNumber\"/>\n" +#~ " </many-to-one>\n" +#~ " \n" +#~ " <many-to-one name=\"product\"\n" +#~ " insert=\"false\"\n" +#~ " update=\"false\" \n" +#~ " not-null=\"true\"\n" +#~ " column=\"productId\"/>\n" +#~ " \n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Product\">\n" +#~ " <synchronize table=\"LineItem\"/>\n" +#~ "\n" +#~ " <id name=\"productId\"\n" +#~ " length=\"10\">\n" +#~ " <generator class=\"assigned\"/>\n" +#~ " </id>\n" +#~ " \n" +#~ " <property name=\"description\" \n" +#~ " not-null=\"true\" \n" +#~ " length=\"200\"/>\n" +#~ " <property name=\"price\" length=\"3\"/>\n" +#~ " <property name=\"numberAvailable\"/>\n" +#~ " \n" +#~ " <property name=\"numberOrdered\">\n" +#~ " <formula>\n" +#~ " ( select sum(li.quantity) \n" +#~ " from LineItem li \n" +#~ " where li.productId = productId )\n" +#~ " </formula>\n" +#~ " </property>\n" +#~ " \n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"User\" table=\"`User`\">\n" +#~ " <composite-id>\n" +#~ " <key-property name=\"name\"/>\n" +#~ " <key-property name=\"org\"/>\n" +#~ " </composite-id>\n" +#~ " <set name=\"groups\" table=\"UserGroup\">\n" +#~ " <key>\n" +#~ " <column name=\"userName\"/>\n" +#~ " <column name=\"org\"/>\n" +#~ " </key>\n" +#~ " <many-to-many class=\"Group\">\n" +#~ " <column name=\"groupName\"/>\n" +#~ " <formula>org</formula>\n" +#~ " </many-to-many>\n" +#~ " </set>\n" +#~ "</class>\n" +#~ " \n" +#~ "<class name=\"Group\" table=\"`Group`\">\n" +#~ " <composite-id>\n" +#~ " <key-property name=\"name\"/>\n" +#~ " <key-property name=\"org\"/>\n" +#~ " </composite-id>\n" +#~ " <property name=\"description\"/>\n" +#~ " <set name=\"users\" table=\"UserGroup\" inverse=\"true\">\n" +#~ " <key>\n" +#~ " <column name=\"groupName\"/>\n" +#~ " <column name=\"org\"/>\n" +#~ " </key>\n" +#~ " <many-to-many class=\"User\">\n" +#~ " <column name=\"userName\"/>\n" +#~ " <formula>org</formula>\n" +#~ " </many-to-many>\n" +#~ " </set>\n" +#~ "</class>\n" +#~ "]]>" +#~ msgstr "" +#~ "<class name=\"User\" table=\"`User`\">\n" +#~ " <composite-id>\n" +#~ " <key-property name=\"name\"/>\n" +#~ " <key-property name=\"org\"/>\n" +#~ " </composite-id>\n" +#~ " <set name=\"groups\" table=\"UserGroup\">\n" +#~ " <key>\n" +#~ " <column name=\"userName\"/>\n" +#~ " <column name=\"org\"/>\n" +#~ " </key>\n" +#~ " <many-to-many class=\"Group\">\n" +#~ " <column name=\"groupName\"/>\n" +#~ " <formula>org</formula>\n" +#~ " </many-to-many>\n" +#~ " </set>\n" +#~ "</class>\n" +#~ " \n" +#~ "<class name=\"Group\" table=\"`Group`\">\n" +#~ " <composite-id>\n" +#~ " <key-property name=\"name\"/>\n" +#~ " <key-property name=\"org\"/>\n" +#~ " </composite-id>\n" +#~ " <property name=\"description\"/>\n" +#~ " <set name=\"users\" table=\"UserGroup\" inverse=\"true\">\n" +#~ " <key>\n" +#~ " <column name=\"groupName\"/>\n" +#~ " <column name=\"org\"/>\n" +#~ " </key>\n" +#~ " <many-to-many class=\"User\">\n" +#~ " <column name=\"userName\"/>\n" +#~ " <formula>org</formula>\n" +#~ " </many-to-many>\n" +#~ " </set>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Person\"\n" +#~ " discriminator-value=\"P\">\n" +#~ " \n" +#~ " <id name=\"id\" \n" +#~ " column=\"person_id\" \n" +#~ " unsaved-value=\"0\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " \n" +#~ " \n" +#~ " <discriminator \n" +#~ " type=\"character\">\n" +#~ " <formula>\n" +#~ " case \n" +#~ " when title is not null then 'E' \n" +#~ " when salesperson is not null then 'C' \n" +#~ " else 'P' \n" +#~ " end\n" +#~ " </formula>\n" +#~ " </discriminator>\n" +#~ "\n" +#~ " <property name=\"name\" \n" +#~ " not-null=\"true\"\n" +#~ " length=\"80\"/>\n" +#~ " \n" +#~ " <property name=\"sex\" \n" +#~ " not-null=\"true\"\n" +#~ " update=\"false\"/>\n" +#~ " \n" +#~ " <component name=\"address\">\n" +#~ " <property name=\"address\"/>\n" +#~ " <property name=\"zip\"/>\n" +#~ " <property name=\"country\"/>\n" +#~ " </component>\n" +#~ " \n" +#~ " <subclass name=\"Employee\" \n" +#~ " discriminator-value=\"E\">\n" +#~ " <property name=\"title\"\n" +#~ " length=\"20\"/>\n" +#~ " <property name=\"salary\"/>\n" +#~ " <many-to-one name=\"manager\"/>\n" +#~ " </subclass>\n" +#~ " \n" +#~ " <subclass name=\"Customer\" \n" +#~ " discriminator-value=\"C\">\n" +#~ " <property name=\"comments\"/>\n" +#~ " <many-to-one name=\"salesperson\"/>\n" +#~ " </subclass>\n" +#~ " \n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Person\"\n" +#~ " discriminator-value=\"P\">\n" +#~ " \n" +#~ " <id name=\"id\" \n" +#~ " column=\"person_id\" \n" +#~ " unsaved-value=\"0\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " \n" +#~ " \n" +#~ " <discriminator \n" +#~ " type=\"character\">\n" +#~ " <formula>\n" +#~ " case \n" +#~ " when title is not null then 'E' \n" +#~ " when salesperson is not null then 'C' \n" +#~ " else 'P' \n" +#~ " end\n" +#~ " </formula>\n" +#~ " </discriminator>\n" +#~ "\n" +#~ " <property name=\"name\" \n" +#~ " not-null=\"true\"\n" +#~ " length=\"80\"/>\n" +#~ " \n" +#~ " <property name=\"sex\" \n" +#~ " not-null=\"true\"\n" +#~ " update=\"false\"/>\n" +#~ " \n" +#~ " <component name=\"address\">\n" +#~ " <property name=\"address\"/>\n" +#~ " <property name=\"zip\"/>\n" +#~ " <property name=\"country\"/>\n" +#~ " </component>\n" +#~ " \n" +#~ " <subclass name=\"Employee\" \n" +#~ " discriminator-value=\"E\">\n" +#~ " <property name=\"title\"\n" +#~ " length=\"20\"/>\n" +#~ " <property name=\"salary\"/>\n" +#~ " <many-to-one name=\"manager\"/>\n" +#~ " </subclass>\n" +#~ " \n" +#~ " <subclass name=\"Customer\" \n" +#~ " discriminator-value=\"C\">\n" +#~ " <property name=\"comments\"/>\n" +#~ " <many-to-one name=\"salesperson\"/>\n" +#~ " </subclass>\n" +#~ " \n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Person\">\n" +#~ " \n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"hilo\"/>\n" +#~ " </id>\n" +#~ " \n" +#~ " <property name=\"name\" length=\"100\"/>\n" +#~ " \n" +#~ " <one-to-one name=\"address\" \n" +#~ " property-ref=\"person\"\n" +#~ " cascade=\"all\"\n" +#~ " fetch=\"join\"/>\n" +#~ " \n" +#~ " <set name=\"accounts\" \n" +#~ " inverse=\"true\">\n" +#~ " <key column=\"userId\"\n" +#~ " property-ref=\"userId\"/>\n" +#~ " <one-to-many class=\"Account\"/>\n" +#~ " </set>\n" +#~ " \n" +#~ " <property name=\"userId\" length=\"8\"/>\n" +#~ "\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\">\n" +#~ "\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"hilo\"/>\n" +#~ " </id>\n" +#~ "\n" +#~ " <property name=\"address\" length=\"300\"/>\n" +#~ " <property name=\"zip\" length=\"5\"/>\n" +#~ " <property name=\"country\" length=\"25\"/>\n" +#~ " <many-to-one name=\"person\" unique=\"true\" not-null=\"true\"/>\n" +#~ "\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Account\">\n" +#~ " <id name=\"accountId\" length=\"32\">\n" +#~ " <generator class=\"uuid\"/>\n" +#~ " </id>\n" +#~ " \n" +#~ " <many-to-one name=\"user\"\n" +#~ " column=\"userId\"\n" +#~ " property-ref=\"userId\"/>\n" +#~ " \n" +#~ " <property name=\"type\" not-null=\"true\"/>\n" +#~ " \n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Person\">\n" +#~ " \n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"hilo\"/>\n" +#~ " </id>\n" +#~ " \n" +#~ " <property name=\"name\" length=\"100\"/>\n" +#~ " \n" +#~ " <one-to-one name=\"address\" \n" +#~ " property-ref=\"person\"\n" +#~ " cascade=\"all\"\n" +#~ " fetch=\"join\"/>\n" +#~ " \n" +#~ " <set name=\"accounts\" \n" +#~ " inverse=\"true\">\n" +#~ " <key column=\"userId\"\n" +#~ " property-ref=\"userId\"/>\n" +#~ " <one-to-many class=\"Account\"/>\n" +#~ " </set>\n" +#~ " \n" +#~ " <property name=\"userId\" length=\"8\"/>\n" +#~ "\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Address\">\n" +#~ "\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"hilo\"/>\n" +#~ " </id>\n" +#~ "\n" +#~ " <property name=\"address\" length=\"300\"/>\n" +#~ " <property name=\"zip\" length=\"5\"/>\n" +#~ " <property name=\"country\" length=\"25\"/>\n" +#~ " <many-to-one name=\"person\" unique=\"true\" not-null=\"true\"/" +#~ ">\n" +#~ "\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Account\">\n" +#~ " <id name=\"accountId\" length=\"32\">\n" +#~ " <generator class=\"uuid\"/>\n" +#~ " </id>\n" +#~ " \n" +#~ " <many-to-one name=\"user\"\n" +#~ " column=\"userId\"\n" +#~ " property-ref=\"userId\"/>\n" +#~ " \n" +#~ " <property name=\"type\" not-null=\"true\"/>\n" +#~ " \n" +#~ "</class>" Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/example_parentchild.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/example_parentchild.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/example_parentchild.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,896 @@ +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# Language /mnt/hgfs/base/Hibernate/Reference translations for PACKAGE package. +# Copyright (C) 2006, 2007 Free Software Foundation, Inc. +# Automatically generated, 2006. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# +msgid "" +msgstr "" +"Project-Id-Version: Collection_Mapping\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2009-12-03T00:15:26\n" +"PO-Revision-Date: 2007-02-26 10:27+1000\n" +"Last-Translator: \n" +"Language-Team: <de(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.9.1\n" + +#. Tag: title +#, no-c-format +msgid "Example: Parent/Child" +msgstr "Beispiel: \"Parent/Child\"" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"One of the first things that new users want to do with Hibernate is to model " +"a parent/child type relationship. There are two different approaches to " +"this. The most convenient approach, especially for new users, is to model " +"both <literal>Parent</literal> and <literal>Child</literal> as entity " +"classes with a <literal><one-to-many></literal> association from " +"<literal>Parent</literal> to <literal>Child</literal>. The alternative " +"approach is to declare the <literal>Child</literal> as a <literal><" +"composite-element></literal>. The default semantics of a one-to-many " +"association in Hibernate are much less close to the usual semantics of a " +"parent/child relationship than those of a composite element mapping. We will " +"explain how to use a <emphasis>bidirectional one-to-many association with " +"cascades</emphasis> to model a parent/child relationship efficiently and " +"elegantly." +msgstr "" +"Eine der ersten Sachen, die neue Benutzer mit Hibernate versuchen, ist es " +"eine Beziehung nach \"Parent\"/\"Child\"-Typ zu bilden. Es gibt dabei zwei " +"verschiedene Herangehensweisen. Aus verschiedenen Gründen empfiehlt es sich " +"gerade für neue Benutzer sowohl <literal>Parent</literal> als auch " +"<literal>Child</literal> als Entity-Klassen mit einer <literal><one-to-" +"many></literal>-Assoziation von <literal>Parent</literal> zu " +"<literal>Child</literal> zu modellieren. (Alternativ kann das " +"<literal>Child</literal> als ein <literal><composite-element></" +"literal> deklariert werden). Nun zeigt sich, dass die Standard-Semantik " +"einer \"One-to-Many\"-Assoziation (in Hibernate) der üblichen Semantik einer " +"\"Parent\" / \"Child\"-Beziehung weniger ähnlich als die eines " +"zusammengesetzten Element-Mappings ist. Wir werden erläutern, wie eine " +"<emphasis>bidirektionale \"One-to-Many\"-Assoziation mit Weitergabe</" +"emphasis> zu einer \"Parent\" / \"Child\"-Beziehung effizient und elegant " +"modelliert wird. Es ist überhaupt nicht schwierig!" + +#. Tag: title +#, no-c-format +msgid "A note about collections" +msgstr "Eine Anmerkung zu Collections" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate collections are considered to be a logical part of their owning " +"entity and not of the contained entities. Be aware that this is a critical " +"distinction that has the following consequences:" +msgstr "" +"Hibernate Collections werden als logischer Teil der sie besitzenden Entity " +"angesehen - niemals der enthaltenen Entities. Dies ist eine kritische " +"Unterscheidung! Es hat die folgenden Konsequenzen:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"When you remove/add an object from/to a collection, the version number of " +"the collection owner is incremented." +msgstr "" +"Wird ein Objekt aus einer Collection entfernt oder zu einer Collection " +"hinzugefügt, so erhöht sich die Versionsnummer des Collection-Besitzers." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If an object that was removed from a collection is an instance of a value " +"type (e.g. a composite element), that object will cease to be persistent and " +"its state will be completely removed from the database. Likewise, adding a " +"value type instance to the collection will cause its state to be immediately " +"persistent." +msgstr "" +"Falls es sich bei einem aus einer Collection entfernten Objekt um eine " +"Instanz mit Wertetyp handelt (z.B. ein zusammengesetzes Element), so ist " +"dieses Objekt nicht länger persistent und der Status wird vollständig aus " +"der Datenbank entfernt. Ebenso wird eine Wertetyp-Instanz automatisch " +"persistiert." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Conversely, if an entity is removed from a collection (a one-to-many or many-" +"to-many association), it will not be deleted by default. This behavior is " +"completely consistent; a change to the internal state of another entity " +"should not cause the associated entity to vanish. Likewise, adding an entity " +"to a collection does not cause that entity to become persistent, by default." +msgstr "" +"Wird eine Entity hingegen aus einer Collection entfernt (eine \"One-to-Many" +"\" oder \"Many-to-Many\"-Assoziation), so wird es in der Standardeinstellung " +"nicht gelöscht. Dieses Verhalten ist völlig konsistent - eine Änderung am " +"internen Status einer anderen Entity sollte nicht dazu führen, dass die " +"zugehörige Entity verschwindet! Ebenso führt das Hinzufügen einer Entity " +"nicht standardmäßig zu deren Persistierung." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Adding an entity to a collection, by default, merely creates a link between " +"the two entities. Removing the entity will remove the link. This is " +"appropriate for all sorts of cases. However, it is not appropriate in the " +"case of a parent/child relationship. In this case, the life of the child is " +"bound to the life cycle of the parent." +msgstr "" +"Statt dessen wird in der Standardeinstellung durch das Hinzufügen einer " +"Entity zu einer Collection eine Verbindung zwischen den zwei Entities " +"hergestellt, bei deren Entfernung hingegen die Verbindung gelöst. Das passt " +"für alle Arten von Fällen sehr gut. Lediglich im Falle einer \"Parent\"/" +"\"Child\"- Beziehung ist es überhaupt nicht passend, da der Lebenszyklus des " +"\"Child\" an den des \"Parent\" gebunden ist." + +#. Tag: title +#, no-c-format +msgid "Bidirectional one-to-many" +msgstr "Bidirektionales \"One-to-Many\"" + +#. Tag: para +#, no-c-format +msgid "" +"Suppose we start with a simple <literal><one-to-many></literal> " +"association from <literal>Parent</literal> to <literal>Child</literal>." +msgstr "" +"Gehen wir einmal davon aus, wir wollten mit einer einfachen <literal><one-" +"to-many></literal>-Assoziation von <literal>Parent</literal> zu " +"<literal>Child</literal> beginnen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "If we were to execute the following code:" +msgstr "Würden wir den folgenden Code ausführen" + +#. Tag: para +#, no-c-format +msgid "Hibernate would issue two SQL statements:" +msgstr "so würde Hibernate zwei SQL-Anweisungen herausgeben:" + +#. Tag: para +#, no-c-format +msgid "" +"an <literal>INSERT</literal> to create the record for <literal>c</literal>" +msgstr "" +"ein <literal>INSERT</literal>, um den Datensatz für <literal>c</literal> zu " +"erstellen" + +#. Tag: para +#, no-c-format +msgid "" +"an <literal>UPDATE</literal> to create the link from <literal>p</literal> to " +"<literal>c</literal>" +msgstr "" +"ein <literal>UPDATE</literal>, um die Verbindung von <literal>p</literal> " +"zu<literal>c</literal> zu erstellen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This is not only inefficient, but also violates any <literal>NOT NULL</" +"literal> constraint on the <literal>parent_id</literal> column. You can fix " +"the nullability constraint violation by specifying <literal>not-null=\"true" +"\"</literal> in the collection mapping:" +msgstr "" +"Das ist nicht nur ineffizient, sondern verletzt auch jedwede <literal>NOT " +"NULL</literal>-Bedingung an der <literal>parent_id</literal>-Spalte. Die " +"Verletzung der \"Nullability\"-Bedingung lässt sich durch das Setzen von " +"<literal>not-null=\"true\"</literal> im Collection-Mapping lösen:" + +#. Tag: para +#, no-c-format +msgid "However, this is not the recommended solution." +msgstr "Dieses ist jedoch nicht die empfohlene Lösung:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The underlying cause of this behavior is that the link (the foreign key " +"<literal>parent_id</literal>) from <literal>p</literal> to <literal>c</" +"literal> is not considered part of the state of the <literal>Child</literal> " +"object and is therefore not created in the <literal>INSERT</literal>. The " +"solution is to make the link part of the <literal>Child</literal> mapping." +msgstr "" +"Die zu Grunde liegende Ursache für dieses Verhalten besteht darin, dass das " +"Link (der Fremdschlüssel <literal>parent_id</literal>) von <literal>p</" +"literal> zu <literal>c</literal> nicht als Teil des Status des " +"<literal>Child</literal>-Objekts angesehen wird und daher nicht im " +"<literal>INSERT</literal> erstellt werden kann. Die Lösung besteht also " +"darin, das Link zu einem Teil des <literal>Child</literal>-Mappings zu " +"machen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You also need to add the <literal>parent</literal> property to the " +"<literal>Child</literal> class." +msgstr "" +"(Wir werden außerdem die <literal>parent</literal>-Property zur " +"<literal>Child</literal>-Klasse hinzufügen müssen)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Now that the <literal>Child</literal> entity is managing the state of the " +"link, we tell the collection not to update the link. We use the " +"<literal>inverse</literal> attribute to do this:" +msgstr "" +"Da nun die <literal>Child</literal>-Entity den Status der Verbindung managt, " +"muss die Collection die Verbindung nicht mehr aktualisieren. Um der " +"Collection dies mitzuteilen verwenden wir das <literal>inverse</literal>-" +"Attribut." + +#. Tag: para +#, fuzzy, no-c-format +msgid "The following code would be used to add a new <literal>Child</literal>:" +msgstr "" +"Der folgende Code würde verwendet, um ein neues <literal>Child</literal> " +"hinzuzufügen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "Only one SQL <literal>INSERT</literal> would now be issued." +msgstr "Und jetzt würde nur ein SQL <literal>INSERT</literal> herausgegeben!" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You could also create an <literal>addChild()</literal> method of " +"<literal>Parent</literal>." +msgstr "" +"Um das Ganze etwas kompakter zu gestalten würden wir eine <literal>addChild()" +"</literal>-Method von <literal>Parent</literal> erstellen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "The code to add a <literal>Child</literal> looks like this:" +msgstr "" +"Nun sieht der Code für das Hinzufügen eines <literal>Child</literal> wie " +"folgt aus" + +#. Tag: title +#, fuzzy, no-c-format +msgid "Cascading life cycle" +msgstr "Lebenszyklus der Weitergabe (\"Cascading\")" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can address the frustrations of the explicit call to <literal>save()</" +"literal> by using cascades." +msgstr "" +"Der explizite Aufruf <literal>save()</literal> ist nach wie vor nicht ideal. " +"Wir gehen dieses Problem mittels Kaskade (sog. \"Cascades\") an." + +#. Tag: para +#, fuzzy, no-c-format +msgid "This simplifies the code above to:" +msgstr "Dies vereinfacht den vorherigen Code zu" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Similarly, we do not need to iterate over the children when saving or " +"deleting a <literal>Parent</literal>. The following removes <literal>p</" +"literal> and all its children from the database." +msgstr "" +"Auch müssen wir es bei den untergeordneten Objekten (\"children\") nicht " +"wiederholen, wenn wir einen <literal>Parent</literal> speichern oder " +"löschen. Nachfolgendes entfernt <literal>p</literal> und sämtliche von " +"dessen untergeordneten Objekten aus der Datenbank." + +#. Tag: para +#, fuzzy, no-c-format +msgid "However, the following code:" +msgstr "Dieser Code jedoch" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"will not remove <literal>c</literal> from the database. In this case, it " +"will only remove the link to <literal>p</literal> and cause a <literal>NOT " +"NULL</literal> constraint violation. You need to explicitly <literal>delete()" +"</literal> the <literal>Child</literal>." +msgstr "" +"entfernt <literal>c</literal> nicht aus der Datenbank; lediglich die " +"Verbindung zu <literal>p</literal> wird gelöst (und eine Verletzung der " +"<literal>NOT NULL</literal>-Bedingung erfolgt in diesem Fall). Sie müssen " +"für das <literal>Child</literal> explizit <literal>delete()</literal> " +"festlegen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"In our case, a <literal>Child</literal> cannot exist without its parent. So " +"if we remove a <literal>Child</literal> from the collection, we do want it " +"to be deleted. To do this, we must use <literal>cascade=\"all-delete-orphan" +"\"</literal>." +msgstr "" +"In unserem Fall kann jedoch ein <literal>Child</literal> ohne den " +"übergeordneten \"Parent\" eigentlich nicht existieren. Wenn wir also ein " +"<literal>Child</literal> aus der Collection entfernen, so wollen wir dieses " +"tatsächlich löschen. Dafür müssen wir <literal>cascade=\"all-delete-orphan" +"\"</literal> verwenden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Even though the collection mapping specifies <literal>inverse=\"true\"</" +"literal>, cascades are still processed by iterating the collection elements. " +"If you need an object be saved, deleted or updated by cascade, you must add " +"it to the collection. It is not enough to simply call <literal>setParent()</" +"literal>." +msgstr "" +"Hinweis: Selbst wenn das Collection-Mapping <literal>inverse=\"true\"</" +"literal> spezifiziert, werden Weitergaben nach wie vor durch Wiederholung " +"der Collection-Elemente bearbeitet. Falls Sie also ein Objekt durch " +"Weitergabe speichern, löschen oder aktualisieren möchten, müssen Sie es der " +"Collection hinzufügen. Ein einfacher Aufruf von <literal>setParent()</" +"literal> reicht in diesem Fall nicht aus." + +#. Tag: title +#, fuzzy, no-c-format +msgid "Cascades and <literal>unsaved-value</literal>" +msgstr "Kaskaden und ungespeicherter Wert" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Suppose we loaded up a <literal>Parent</literal> in one <literal>Session</" +"literal>, made some changes in a UI action and wanted to persist these " +"changes in a new session by calling <literal>update()</literal>. The " +"<literal>Parent</literal> will contain a collection of children and, since " +"the cascading update is enabled, Hibernate needs to know which children are " +"newly instantiated and which represent existing rows in the database. We " +"will also assume that both <literal>Parent</literal> and <literal>Child</" +"literal> have generated identifier properties of type <literal>Long</" +"literal>. Hibernate will use the identifier and version/timestamp property " +"value to determine which of the children are new. (See <xref linkend=" +"\"objectstate-saveorupdate\" />.) <emphasis>In Hibernate3, it is no longer " +"necessary to specify an <literal>unsaved-value</literal> explicitly.</" +"emphasis>" +msgstr "" +"Gehen wir einmal davon aus, wir hätten einen <literal>Parent</literal> in " +"einer <literal>Session</literal> hochgeladen, einige Änderungen in einer UI-" +"Aktion vorgenommen und wollten diese Änderungen in einer neuen Session durch " +"Aufruf von <literal>update()</literal> persistieren. Der <literal>Parent</" +"literal> wird eine Collection von untergeordneten Objekten (den \"children" +"\") enthalten, und da die Kaskade aktiviert ist, muss Hibernate wissen, " +"welche \"Children\" neu instanziiert sind und welche bestehende Reihen in " +"der Datenbank repräsentieren. Nehmen wir an, dass sowohl <literal>Parent</" +"literal> als auch <literal>Child</literal> generierte Bezeichner-Properties " +"des Typs <literal>Long</literal> besitzen. Hibernate wird den Bezeichner und " +"den Property-Wert von Version/Zeitstempel verwenden, um zu bestimmen, welche " +"der \"Children\" neu sind. (Siehe <xref linkend=\"objectstate-saveorupdate\"/>). " +"<emphasis>In Hibernate3 ist es nicht mehr " +"notwendig, explizit einen <literal>unsaved-value</literal> festzulegen.</" +"emphasis>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The following code will update <literal>parent</literal> and <literal>child</" +"literal> and insert <literal>newChild</literal>:" +msgstr "" +"Der folgende Code aktualisiert <literal>parent</literal> und <literal>child</" +"literal> und fügt <literal>newChild</literal> hinzu." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This may be suitable for the case of a generated identifier, but what about " +"assigned identifiers and composite identifiers? This is more difficult, " +"since Hibernate cannot use the identifier property to distinguish between a " +"newly instantiated object, with an identifier assigned by the user, and an " +"object loaded in a previous session. In this case, Hibernate will either use " +"the timestamp or version property, or will actually query the second-level " +"cache or, worst case, the database, to see if the row exists." +msgstr "" +"Nun, all das funktioniert hervorragend im Falle eines generierten " +"Bezeichners, aber was ist mit zugeordneten Bezeichnern und zusammengesetzten " +"Bezeichnern? Das ist schwieriger, da Hibernate hier nicht die Bezeichner-" +"Property zur Unterscheidung zwischen einem neu instantiierten Objekt (mit " +"einem durch den Benutzer zugeordneten Bezeichner) und einem in einer " +"früheren Session geladenen Objekt verwenden kann. In diesem Fall verwendet " +"Hibernate entweder den Zeitstempel oder die Versions-Property oder fragt " +"beim Speicher der zweiten Ebene an. Schlimmstenfalls prüft es in der " +"Datenbank, ob die Reihe existiert." + +#. Tag: title +#, no-c-format +msgid "Conclusion" +msgstr "Zusammenfassung" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The sections we have just covered can be a bit confusing. However, in " +"practice, it all works out nicely. Most Hibernate applications use the " +"parent/child pattern in many places." +msgstr "" +"Das sind eine Menge an Informationen, die zu Beginn vielleicht etwas " +"verwirrend erscheinen. In der Praxis jedoch funktioniert das alles sehr gut. " +"Die meisten Hibernate-Anwendungen verwenden die \"Parent/Child\"-Vorlage bei " +"vielen Gelegenheiten." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"We mentioned an alternative in the first paragraph. None of the above issues " +"exist in the case of <literal><composite-element></literal> mappings, " +"which have exactly the semantics of a parent/child relationship. " +"Unfortunately, there are two big limitations with composite element classes: " +"composite elements cannot own collections and they should not be the child " +"of any entity other than the unique parent." +msgstr "" +"Im ersten Abschnitt haben wir eine Alternative erwähnt. Keines der gennaten " +"Probleme existiert im Fall von <literal><composite-element></literal>-" +"Mappings, die dieselbe Semantik wie eine \"Parent/Child\"-Beziehung " +"besitzen. Leider bestehen zwei große Einschränkungen bei zusammengesetzten " +"Elementklassen: Zusammengesetzte Elemente können keine Collections besitzen " +"und sie sollten nicht das untergeordnete Objekt (\"Child\") irgendeiner " +"Entity außer dem eindeutigen, übergeordneten Objekt (\"Parent\") sein." + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<set name=\"children\">\n" +#~ " <key column=\"parent_id\"/>\n" +#~ " <one-to-many class=\"Child\"/>\n" +#~ "</set>]]>" +#~ msgstr "" +#~ "<set name=\"children\">\n" +#~ " <key column=\"parent_id\"/>\n" +#~ " <one-to-many class=\"Child\"/>\n" +#~ "</set>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Parent p = .....;\n" +#~ "Child c = new Child();\n" +#~ "p.getChildren().add(c);\n" +#~ "session.save(c);\n" +#~ "session.flush();]]>" +#~ msgstr "" +#~ "Parent p = .....;\n" +#~ "Child c = new Child();\n" +#~ "p.getChildren().add(c);\n" +#~ "session.save(c);\n" +#~ "session.flush();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<set name=\"children\">\n" +#~ " <key column=\"parent_id\" not-null=\"true\"/>\n" +#~ " <one-to-many class=\"Child\"/>\n" +#~ "</set>]]>" +#~ msgstr "" +#~ "<set name=\"children\">\n" +#~ " <key column=\"parent_id\" not-null=\"true\"/>\n" +#~ " <one-to-many class=\"Child\"/>\n" +#~ "</set>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<many-to-one name=\"parent\" column=\"parent_id\" not-null=\"true" +#~ "\"/>]]>" +#~ msgstr "" +#~ "<many-to-one name=\"parent\" column=\"parent_id\" not-null=\"true\"/" +#~ ">" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<set name=\"children\" inverse=\"true\">\n" +#~ " <key column=\"parent_id\"/>\n" +#~ " <one-to-many class=\"Child\"/>\n" +#~ "</set>]]>" +#~ msgstr "" +#~ "<set name=\"children\" inverse=\"true\">\n" +#~ " <key column=\"parent_id\"/>\n" +#~ " <one-to-many class=\"Child\"/>\n" +#~ "</set>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" +#~ "Child c = new Child();\n" +#~ "c.setParent(p);\n" +#~ "p.getChildren().add(c);\n" +#~ "session.save(c);\n" +#~ "session.flush();]]>" +#~ msgstr "" +#~ "Parent p = (Parent) session.load(Parent.class, pid);\n" +#~ "Child c = new Child();\n" +#~ "c.setParent(p);\n" +#~ "p.getChildren().add(c);\n" +#~ "session.save(c);\n" +#~ "session.flush();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[public void addChild(Child c) {\n" +#~ " c.setParent(this);\n" +#~ " children.add(c);\n" +#~ "}]]>" +#~ msgstr "" +#~ "public void addChild(Child c) {\n" +#~ " c.setParent(this);\n" +#~ " children.add(c);\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" +#~ "Child c = new Child();\n" +#~ "p.addChild(c);\n" +#~ "session.save(c);\n" +#~ "session.flush();]]>" +#~ msgstr "" +#~ "Parent p = (Parent) session.load(Parent.class, pid);\n" +#~ "Child c = new Child();\n" +#~ "p.addChild(c);\n" +#~ "session.save(c);\n" +#~ "session.flush();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<set name=\"children\" inverse=\"true\" cascade=\"all\">\n" +#~ " <key column=\"parent_id\"/>\n" +#~ " <one-to-many class=\"Child\"/>\n" +#~ "</set>]]>" +#~ msgstr "" +#~ "<set name=\"children\" inverse=\"true\" cascade=\"all\">\n" +#~ " <key column=\"parent_id\"/>\n" +#~ " <one-to-many class=\"Child\"/>\n" +#~ "</set>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" +#~ "Child c = new Child();\n" +#~ "p.addChild(c);\n" +#~ "session.flush();]]>" +#~ msgstr "" +#~ "Parent p = (Parent) session.load(Parent.class, pid);\n" +#~ "Child c = new Child();\n" +#~ "p.addChild(c);\n" +#~ "session.flush();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" +#~ "session.delete(p);\n" +#~ "session.flush();]]>" +#~ msgstr "" +#~ "Parent p = (Parent) session.load(Parent.class, pid);\n" +#~ "session.delete(p);\n" +#~ "session.flush();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" +#~ "Child c = (Child) p.getChildren().iterator().next();\n" +#~ "p.getChildren().remove(c);\n" +#~ "c.setParent(null);\n" +#~ "session.flush();]]>" +#~ msgstr "" +#~ "Parent p = (Parent) session.load(Parent.class, pid);\n" +#~ "Child c = (Child) p.getChildren().iterator().next();\n" +#~ "p.getChildren().remove(c);\n" +#~ "c.setParent(null);\n" +#~ "session.flush();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" +#~ "Child c = (Child) p.getChildren().iterator().next();\n" +#~ "p.getChildren().remove(c);\n" +#~ "session.delete(c);\n" +#~ "session.flush();]]>" +#~ msgstr "" +#~ "Parent p = (Parent) session.load(Parent.class, pid);\n" +#~ "Child c = (Child) p.getChildren().iterator().next();\n" +#~ "p.getChildren().remove(c);\n" +#~ "session.delete(c);\n" +#~ "session.flush();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<set name=\"children\" inverse=\"true\" cascade=\"all-delete-" +#~ "orphan\">\n" +#~ " <key column=\"parent_id\"/>\n" +#~ " <one-to-many class=\"Child\"/>\n" +#~ "</set>]]>" +#~ msgstr "" +#~ "<set name=\"children\" inverse=\"true\" cascade=\"all-delete-orphan" +#~ "\">\n" +#~ " <key column=\"parent_id\"/>\n" +#~ " <one-to-many class=\"Child\"/>\n" +#~ "</set>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[//parent and child were both loaded in a previous session\n" +#~ "parent.addChild(child);\n" +#~ "Child newChild = new Child();\n" +#~ "parent.addChild(newChild);\n" +#~ "session.update(parent);\n" +#~ "session.flush();]]>" +#~ msgstr "" +#~ "//parent and child were both loaded in a previous session\n" +#~ "parent.addChild(child);\n" +#~ "Child newChild = new Child();\n" +#~ "parent.addChild(newChild);\n" +#~ "session.update(parent);\n" +#~ "session.flush();" Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/example_weblog.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/example_weblog.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/example_weblog.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,1135 @@ +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# Language /mnt/hgfs/base/Hibernate/Reference translations for PACKAGE package. +# Copyright (C) 2006, 2007 Free Software Foundation, Inc. +# Automatically generated, 2006. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# +msgid "" +msgstr "" +"Project-Id-Version: Collection_Mapping\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2009-12-03T00:15:26\n" +"PO-Revision-Date: 2007-02-26 10:27+1000\n" +"Last-Translator: \n" +"Language-Team: <de(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.9.1\n" + +#. Tag: title +#, no-c-format +msgid "Example: Weblog Application" +msgstr "Beispiel: Web-Log Anwendung" + +#. Tag: title +#, no-c-format +msgid "Persistent Classes" +msgstr "Persistente Klassen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The persistent classes here represent a weblog and an item posted in a " +"weblog. They are to be modelled as a standard parent/child relationship, but " +"we will use an ordered bag, instead of a set:" +msgstr "" +"Die persistenten Klassen repräsentieren einen Web-Log und einen in einem Web-" +"Log untergebrachten Posten. Sie sollen als Standard \"Parent/Child\"-" +"Beziehung modelliert werden, jedoch verwenden wir eine geordnete \"Bag\" " +"anstelle eines \"Sets\"." + +#. Tag: title +#, no-c-format +msgid "Hibernate Mappings" +msgstr "Hibernate-Mappings" + +#. Tag: para +#, fuzzy, no-c-format +msgid "The XML mappings are now straightforward. For example:" +msgstr "Die XML-Mappings sollten nun ziemlich überschaubar sein." + +#. Tag: title +#, no-c-format +msgid "Hibernate Code" +msgstr "Hibernate-Code" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The following class demonstrates some of the kinds of things we can do with " +"these classes using Hibernate:" +msgstr "" +"Die folgende Klasse zeigt einige Dinge auf, die unter Verwendung von " +"Hibernate mit diesen Klassen durchgeführt werden können." + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[package eg;\n" +#~ "\n" +#~ "import java.util.List;\n" +#~ "\n" +#~ "public class Blog {\n" +#~ " private Long _id;\n" +#~ " private String _name;\n" +#~ " private List _items;\n" +#~ "\n" +#~ " public Long getId() {\n" +#~ " return _id;\n" +#~ " }\n" +#~ " public List getItems() {\n" +#~ " return _items;\n" +#~ " }\n" +#~ " public String getName() {\n" +#~ " return _name;\n" +#~ " }\n" +#~ " public void setId(Long long1) {\n" +#~ " _id = long1;\n" +#~ " }\n" +#~ " public void setItems(List list) {\n" +#~ " _items = list;\n" +#~ " }\n" +#~ " public void setName(String string) {\n" +#~ " _name = string;\n" +#~ " }\n" +#~ "}]]>" +#~ msgstr "" +#~ "package eg;\n" +#~ "\n" +#~ "import java.util.List;\n" +#~ "\n" +#~ "public class Blog {\n" +#~ " private Long _id;\n" +#~ " private String _name;\n" +#~ " private List _items;\n" +#~ "\n" +#~ " public Long getId() {\n" +#~ " return _id;\n" +#~ " }\n" +#~ " public List getItems() {\n" +#~ " return _items;\n" +#~ " }\n" +#~ " public String getName() {\n" +#~ " return _name;\n" +#~ " }\n" +#~ " public void setId(Long long1) {\n" +#~ " _id = long1;\n" +#~ " }\n" +#~ " public void setItems(List list) {\n" +#~ " _items = list;\n" +#~ " }\n" +#~ " public void setName(String string) {\n" +#~ " _name = string;\n" +#~ " }\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[package eg;\n" +#~ "\n" +#~ "import java.text.DateFormat;\n" +#~ "import java.util.Calendar;\n" +#~ "\n" +#~ "public class BlogItem {\n" +#~ " private Long _id;\n" +#~ " private Calendar _datetime;\n" +#~ " private String _text;\n" +#~ " private String _title;\n" +#~ " private Blog _blog;\n" +#~ "\n" +#~ " public Blog getBlog() {\n" +#~ " return _blog;\n" +#~ " }\n" +#~ " public Calendar getDatetime() {\n" +#~ " return _datetime;\n" +#~ " }\n" +#~ " public Long getId() {\n" +#~ " return _id;\n" +#~ " }\n" +#~ " public String getText() {\n" +#~ " return _text;\n" +#~ " }\n" +#~ " public String getTitle() {\n" +#~ " return _title;\n" +#~ " }\n" +#~ " public void setBlog(Blog blog) {\n" +#~ " _blog = blog;\n" +#~ " }\n" +#~ " public void setDatetime(Calendar calendar) {\n" +#~ " _datetime = calendar;\n" +#~ " }\n" +#~ " public void setId(Long long1) {\n" +#~ " _id = long1;\n" +#~ " }\n" +#~ " public void setText(String string) {\n" +#~ " _text = string;\n" +#~ " }\n" +#~ " public void setTitle(String string) {\n" +#~ " _title = string;\n" +#~ " }\n" +#~ "}]]>" +#~ msgstr "" +#~ "package eg;\n" +#~ "\n" +#~ "import java.text.DateFormat;\n" +#~ "import java.util.Calendar;\n" +#~ "\n" +#~ "public class BlogItem {\n" +#~ " private Long _id;\n" +#~ " private Calendar _datetime;\n" +#~ " private String _text;\n" +#~ " private String _title;\n" +#~ " private Blog _blog;\n" +#~ "\n" +#~ " public Blog getBlog() {\n" +#~ " return _blog;\n" +#~ " }\n" +#~ " public Calendar getDatetime() {\n" +#~ " return _datetime;\n" +#~ " }\n" +#~ " public Long getId() {\n" +#~ " return _id;\n" +#~ " }\n" +#~ " public String getText() {\n" +#~ " return _text;\n" +#~ " }\n" +#~ " public String getTitle() {\n" +#~ " return _title;\n" +#~ " }\n" +#~ " public void setBlog(Blog blog) {\n" +#~ " _blog = blog;\n" +#~ " }\n" +#~ " public void setDatetime(Calendar calendar) {\n" +#~ " _datetime = calendar;\n" +#~ " }\n" +#~ " public void setId(Long long1) {\n" +#~ " _id = long1;\n" +#~ " }\n" +#~ " public void setText(String string) {\n" +#~ " _text = string;\n" +#~ " }\n" +#~ " public void setTitle(String string) {\n" +#~ " _title = string;\n" +#~ " }\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<?xml version=\"1.0\"?>\n" +#~ "<!DOCTYPE hibernate-mapping PUBLIC\n" +#~ " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" +#~ " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" +#~ "\n" +#~ "<hibernate-mapping package=\"eg\">\n" +#~ "\n" +#~ " <class\n" +#~ " name=\"Blog\"\n" +#~ " table=\"BLOGS\">\n" +#~ "\n" +#~ " <id\n" +#~ " name=\"id\"\n" +#~ " column=\"BLOG_ID\">\n" +#~ "\n" +#~ " <generator class=\"native\"/>\n" +#~ "\n" +#~ " </id>\n" +#~ "\n" +#~ " <property\n" +#~ " name=\"name\"\n" +#~ " column=\"NAME\"\n" +#~ " not-null=\"true\"\n" +#~ " unique=\"true\"/>\n" +#~ "\n" +#~ " <bag\n" +#~ " name=\"items\"\n" +#~ " inverse=\"true\"\n" +#~ " order-by=\"DATE_TIME\"\n" +#~ " cascade=\"all\">\n" +#~ "\n" +#~ " <key column=\"BLOG_ID\"/>\n" +#~ " <one-to-many class=\"BlogItem\"/>\n" +#~ "\n" +#~ " </bag>\n" +#~ "\n" +#~ " </class>\n" +#~ "\n" +#~ "</hibernate-mapping>]]>" +#~ msgstr "" +#~ "<?xml version=\"1.0\"?>\n" +#~ "<!DOCTYPE hibernate-mapping PUBLIC\n" +#~ " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" +#~ " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" +#~ "\n" +#~ "<hibernate-mapping package=\"eg\">\n" +#~ "\n" +#~ " <class\n" +#~ " name=\"Blog\"\n" +#~ " table=\"BLOGS\">\n" +#~ "\n" +#~ " <id\n" +#~ " name=\"id\"\n" +#~ " column=\"BLOG_ID\">\n" +#~ "\n" +#~ " <generator class=\"native\"/>\n" +#~ "\n" +#~ " </id>\n" +#~ "\n" +#~ " <property\n" +#~ " name=\"name\"\n" +#~ " column=\"NAME\"\n" +#~ " not-null=\"true\"\n" +#~ " unique=\"true\"/>\n" +#~ "\n" +#~ " <bag\n" +#~ " name=\"items\"\n" +#~ " inverse=\"true\"\n" +#~ " order-by=\"DATE_TIME\"\n" +#~ " cascade=\"all\">\n" +#~ "\n" +#~ " <key column=\"BLOG_ID\"/>\n" +#~ " <one-to-many class=\"BlogItem\"/>\n" +#~ "\n" +#~ " </bag>\n" +#~ "\n" +#~ " </class>\n" +#~ "\n" +#~ "</hibernate-mapping>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<?xml version=\"1.0\"?>\n" +#~ "<!DOCTYPE hibernate-mapping PUBLIC\n" +#~ " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" +#~ " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" +#~ "\n" +#~ "<hibernate-mapping package=\"eg\">\n" +#~ "\n" +#~ " <class\n" +#~ " name=\"BlogItem\"\n" +#~ " table=\"BLOG_ITEMS\"\n" +#~ " dynamic-update=\"true\">\n" +#~ "\n" +#~ " <id\n" +#~ " name=\"id\"\n" +#~ " column=\"BLOG_ITEM_ID\">\n" +#~ "\n" +#~ " <generator class=\"native\"/>\n" +#~ "\n" +#~ " </id>\n" +#~ "\n" +#~ " <property\n" +#~ " name=\"title\"\n" +#~ " column=\"TITLE\"\n" +#~ " not-null=\"true\"/>\n" +#~ "\n" +#~ " <property\n" +#~ " name=\"text\"\n" +#~ " column=\"TEXT\"\n" +#~ " not-null=\"true\"/>\n" +#~ "\n" +#~ " <property\n" +#~ " name=\"datetime\"\n" +#~ " column=\"DATE_TIME\"\n" +#~ " not-null=\"true\"/>\n" +#~ "\n" +#~ " <many-to-one\n" +#~ " name=\"blog\"\n" +#~ " column=\"BLOG_ID\"\n" +#~ " not-null=\"true\"/>\n" +#~ "\n" +#~ " </class>\n" +#~ "\n" +#~ "</hibernate-mapping>]]>" +#~ msgstr "" +#~ "<?xml version=\"1.0\"?>\n" +#~ "<!DOCTYPE hibernate-mapping PUBLIC\n" +#~ " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" +#~ " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" +#~ "\n" +#~ "<hibernate-mapping package=\"eg\">\n" +#~ "\n" +#~ " <class\n" +#~ " name=\"BlogItem\"\n" +#~ " table=\"BLOG_ITEMS\"\n" +#~ " dynamic-update=\"true\">\n" +#~ "\n" +#~ " <id\n" +#~ " name=\"id\"\n" +#~ " column=\"BLOG_ITEM_ID\">\n" +#~ "\n" +#~ " <generator class=\"native\"/>\n" +#~ "\n" +#~ " </id>\n" +#~ "\n" +#~ " <property\n" +#~ " name=\"title\"\n" +#~ " column=\"TITLE\"\n" +#~ " not-null=\"true\"/>\n" +#~ "\n" +#~ " <property\n" +#~ " name=\"text\"\n" +#~ " column=\"TEXT\"\n" +#~ " not-null=\"true\"/>\n" +#~ "\n" +#~ " <property\n" +#~ " name=\"datetime\"\n" +#~ " column=\"DATE_TIME\"\n" +#~ " not-null=\"true\"/>\n" +#~ "\n" +#~ " <many-to-one\n" +#~ " name=\"blog\"\n" +#~ " column=\"BLOG_ID\"\n" +#~ " not-null=\"true\"/>\n" +#~ "\n" +#~ " </class>\n" +#~ "\n" +#~ "</hibernate-mapping>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[package eg;\n" +#~ "\n" +#~ "import java.util.ArrayList;\n" +#~ "import java.util.Calendar;\n" +#~ "import java.util.Iterator;\n" +#~ "import java.util.List;\n" +#~ "\n" +#~ "import org.hibernate.HibernateException;\n" +#~ "import org.hibernate.Query;\n" +#~ "import org.hibernate.Session;\n" +#~ "import org.hibernate.SessionFactory;\n" +#~ "import org.hibernate.Transaction;\n" +#~ "import org.hibernate.cfg.Configuration;\n" +#~ "import org.hibernate.tool.hbm2ddl.SchemaExport;\n" +#~ "\n" +#~ "public class BlogMain {\n" +#~ " \n" +#~ " private SessionFactory _sessions;\n" +#~ " \n" +#~ " public void configure() throws HibernateException {\n" +#~ " _sessions = new Configuration()\n" +#~ " .addClass(Blog.class)\n" +#~ " .addClass(BlogItem.class)\n" +#~ " .buildSessionFactory();\n" +#~ " }\n" +#~ " \n" +#~ " public void exportTables() throws HibernateException {\n" +#~ " Configuration cfg = new Configuration()\n" +#~ " .addClass(Blog.class)\n" +#~ " .addClass(BlogItem.class);\n" +#~ " new SchemaExport(cfg).create(true, true);\n" +#~ " }\n" +#~ " \n" +#~ " public Blog createBlog(String name) throws HibernateException {\n" +#~ " \n" +#~ " Blog blog = new Blog();\n" +#~ " blog.setName(name);\n" +#~ " blog.setItems( new ArrayList() );\n" +#~ " \n" +#~ " Session session = _sessions.openSession();\n" +#~ " Transaction tx = null;\n" +#~ " try {\n" +#~ " tx = session.beginTransaction();\n" +#~ " session.persist(blog);\n" +#~ " tx.commit();\n" +#~ " }\n" +#~ " catch (HibernateException he) {\n" +#~ " if (tx!=null) tx.rollback();\n" +#~ " throw he;\n" +#~ " }\n" +#~ " finally {\n" +#~ " session.close();\n" +#~ " }\n" +#~ " return blog;\n" +#~ " }\n" +#~ " \n" +#~ " public BlogItem createBlogItem(Blog blog, String title, String text)\n" +#~ " throws HibernateException {\n" +#~ " \n" +#~ " BlogItem item = new BlogItem();\n" +#~ " item.setTitle(title);\n" +#~ " item.setText(text);\n" +#~ " item.setBlog(blog);\n" +#~ " item.setDatetime( Calendar.getInstance() );\n" +#~ " blog.getItems().add(item);\n" +#~ " \n" +#~ " Session session = _sessions.openSession();\n" +#~ " Transaction tx = null;\n" +#~ " try {\n" +#~ " tx = session.beginTransaction();\n" +#~ " session.update(blog);\n" +#~ " tx.commit();\n" +#~ " }\n" +#~ " catch (HibernateException he) {\n" +#~ " if (tx!=null) tx.rollback();\n" +#~ " throw he;\n" +#~ " }\n" +#~ " finally {\n" +#~ " session.close();\n" +#~ " }\n" +#~ " return item;\n" +#~ " }\n" +#~ " \n" +#~ " public BlogItem createBlogItem(Long blogid, String title, String " +#~ "text)\n" +#~ " throws HibernateException {\n" +#~ " \n" +#~ " BlogItem item = new BlogItem();\n" +#~ " item.setTitle(title);\n" +#~ " item.setText(text);\n" +#~ " item.setDatetime( Calendar.getInstance() );\n" +#~ " \n" +#~ " Session session = _sessions.openSession();\n" +#~ " Transaction tx = null;\n" +#~ " try {\n" +#~ " tx = session.beginTransaction();\n" +#~ " Blog blog = (Blog) session.load(Blog.class, blogid);\n" +#~ " item.setBlog(blog);\n" +#~ " blog.getItems().add(item);\n" +#~ " tx.commit();\n" +#~ " }\n" +#~ " catch (HibernateException he) {\n" +#~ " if (tx!=null) tx.rollback();\n" +#~ " throw he;\n" +#~ " }\n" +#~ " finally {\n" +#~ " session.close();\n" +#~ " }\n" +#~ " return item;\n" +#~ " }\n" +#~ " \n" +#~ " public void updateBlogItem(BlogItem item, String text)\n" +#~ " throws HibernateException {\n" +#~ " \n" +#~ " item.setText(text);\n" +#~ " \n" +#~ " Session session = _sessions.openSession();\n" +#~ " Transaction tx = null;\n" +#~ " try {\n" +#~ " tx = session.beginTransaction();\n" +#~ " session.update(item);\n" +#~ " tx.commit();\n" +#~ " }\n" +#~ " catch (HibernateException he) {\n" +#~ " if (tx!=null) tx.rollback();\n" +#~ " throw he;\n" +#~ " }\n" +#~ " finally {\n" +#~ " session.close();\n" +#~ " }\n" +#~ " }\n" +#~ " \n" +#~ " public void updateBlogItem(Long itemid, String text)\n" +#~ " throws HibernateException {\n" +#~ " \n" +#~ " Session session = _sessions.openSession();\n" +#~ " Transaction tx = null;\n" +#~ " try {\n" +#~ " tx = session.beginTransaction();\n" +#~ " BlogItem item = (BlogItem) session.load(BlogItem.class, " +#~ "itemid);\n" +#~ " item.setText(text);\n" +#~ " tx.commit();\n" +#~ " }\n" +#~ " catch (HibernateException he) {\n" +#~ " if (tx!=null) tx.rollback();\n" +#~ " throw he;\n" +#~ " }\n" +#~ " finally {\n" +#~ " session.close();\n" +#~ " }\n" +#~ " }\n" +#~ " \n" +#~ " public List listAllBlogNamesAndItemCounts(int max)\n" +#~ " throws HibernateException {\n" +#~ " \n" +#~ " Session session = _sessions.openSession();\n" +#~ " Transaction tx = null;\n" +#~ " List result = null;\n" +#~ " try {\n" +#~ " tx = session.beginTransaction();\n" +#~ " Query q = session.createQuery(\n" +#~ " \"select blog.id, blog.name, count(blogItem) \" +\n" +#~ " \"from Blog as blog \" +\n" +#~ " \"left outer join blog.items as blogItem \" +\n" +#~ " \"group by blog.name, blog.id \" +\n" +#~ " \"order by max(blogItem.datetime)\"\n" +#~ " );\n" +#~ " q.setMaxResults(max);\n" +#~ " result = q.list();\n" +#~ " tx.commit();\n" +#~ " }\n" +#~ " catch (HibernateException he) {\n" +#~ " if (tx!=null) tx.rollback();\n" +#~ " throw he;\n" +#~ " }\n" +#~ " finally {\n" +#~ " session.close();\n" +#~ " }\n" +#~ " return result;\n" +#~ " }\n" +#~ " \n" +#~ " public Blog getBlogAndAllItems(Long blogid)\n" +#~ " throws HibernateException {\n" +#~ " \n" +#~ " Session session = _sessions.openSession();\n" +#~ " Transaction tx = null;\n" +#~ " Blog blog = null;\n" +#~ " try {\n" +#~ " tx = session.beginTransaction();\n" +#~ " Query q = session.createQuery(\n" +#~ " \"from Blog as blog \" +\n" +#~ " \"left outer join fetch blog.items \" +\n" +#~ " \"where blog.id = :blogid\"\n" +#~ " );\n" +#~ " q.setParameter(\"blogid\", blogid);\n" +#~ " blog = (Blog) q.uniqueResult();\n" +#~ " tx.commit();\n" +#~ " }\n" +#~ " catch (HibernateException he) {\n" +#~ " if (tx!=null) tx.rollback();\n" +#~ " throw he;\n" +#~ " }\n" +#~ " finally {\n" +#~ " session.close();\n" +#~ " }\n" +#~ " return blog;\n" +#~ " }\n" +#~ " \n" +#~ " public List listBlogsAndRecentItems() throws HibernateException {\n" +#~ " \n" +#~ " Session session = _sessions.openSession();\n" +#~ " Transaction tx = null;\n" +#~ " List result = null;\n" +#~ " try {\n" +#~ " tx = session.beginTransaction();\n" +#~ " Query q = session.createQuery(\n" +#~ " \"from Blog as blog \" +\n" +#~ " \"inner join blog.items as blogItem \" +\n" +#~ " \"where blogItem.datetime > :minDate\"\n" +#~ " );\n" +#~ "\n" +#~ " Calendar cal = Calendar.getInstance();\n" +#~ " cal.roll(Calendar.MONTH, false);\n" +#~ " q.setCalendar(\"minDate\", cal);\n" +#~ " \n" +#~ " result = q.list();\n" +#~ " tx.commit();\n" +#~ " }\n" +#~ " catch (HibernateException he) {\n" +#~ " if (tx!=null) tx.rollback();\n" +#~ " throw he;\n" +#~ " }\n" +#~ " finally {\n" +#~ " session.close();\n" +#~ " }\n" +#~ " return result;\n" +#~ " }\n" +#~ "}]]>" +#~ msgstr "" +#~ "package eg;\n" +#~ "\n" +#~ "import java.util.ArrayList;\n" +#~ "import java.util.Calendar;\n" +#~ "import java.util.Iterator;\n" +#~ "import java.util.List;\n" +#~ "\n" +#~ "import org.hibernate.HibernateException;\n" +#~ "import org.hibernate.Query;\n" +#~ "import org.hibernate.Session;\n" +#~ "import org.hibernate.SessionFactory;\n" +#~ "import org.hibernate.Transaction;\n" +#~ "import org.hibernate.cfg.Configuration;\n" +#~ "import org.hibernate.tool.hbm2ddl.SchemaExport;\n" +#~ "\n" +#~ "public class BlogMain {\n" +#~ " \n" +#~ " private SessionFactory _sessions;\n" +#~ " \n" +#~ " public void configure() throws HibernateException {\n" +#~ " _sessions = new Configuration()\n" +#~ " .addClass(Blog.class)\n" +#~ " .addClass(BlogItem.class)\n" +#~ " .buildSessionFactory();\n" +#~ " }\n" +#~ " \n" +#~ " public void exportTables() throws HibernateException {\n" +#~ " Configuration cfg = new Configuration()\n" +#~ " .addClass(Blog.class)\n" +#~ " .addClass(BlogItem.class);\n" +#~ " new SchemaExport(cfg).create(true, true);\n" +#~ " }\n" +#~ " \n" +#~ " public Blog createBlog(String name) throws HibernateException {\n" +#~ " \n" +#~ " Blog blog = new Blog();\n" +#~ " blog.setName(name);\n" +#~ " blog.setItems( new ArrayList() );\n" +#~ " \n" +#~ " Session session = _sessions.openSession();\n" +#~ " Transaction tx = null;\n" +#~ " try {\n" +#~ " tx = session.beginTransaction();\n" +#~ " session.persist(blog);\n" +#~ " tx.commit();\n" +#~ " }\n" +#~ " catch (HibernateException he) {\n" +#~ " if (tx!=null) tx.rollback();\n" +#~ " throw he;\n" +#~ " }\n" +#~ " finally {\n" +#~ " session.close();\n" +#~ " }\n" +#~ " return blog;\n" +#~ " }\n" +#~ " \n" +#~ " public BlogItem createBlogItem(Blog blog, String title, String text)\n" +#~ " throws HibernateException {\n" +#~ " \n" +#~ " BlogItem item = new BlogItem();\n" +#~ " item.setTitle(title);\n" +#~ " item.setText(text);\n" +#~ " item.setBlog(blog);\n" +#~ " item.setDatetime( Calendar.getInstance() );\n" +#~ " blog.getItems().add(item);\n" +#~ " \n" +#~ " Session session = _sessions.openSession();\n" +#~ " Transaction tx = null;\n" +#~ " try {\n" +#~ " tx = session.beginTransaction();\n" +#~ " session.update(blog);\n" +#~ " tx.commit();\n" +#~ " }\n" +#~ " catch (HibernateException he) {\n" +#~ " if (tx!=null) tx.rollback();\n" +#~ " throw he;\n" +#~ " }\n" +#~ " finally {\n" +#~ " session.close();\n" +#~ " }\n" +#~ " return item;\n" +#~ " }\n" +#~ " \n" +#~ " public BlogItem createBlogItem(Long blogid, String title, String " +#~ "text)\n" +#~ " throws HibernateException {\n" +#~ " \n" +#~ " BlogItem item = new BlogItem();\n" +#~ " item.setTitle(title);\n" +#~ " item.setText(text);\n" +#~ " item.setDatetime( Calendar.getInstance() );\n" +#~ " \n" +#~ " Session session = _sessions.openSession();\n" +#~ " Transaction tx = null;\n" +#~ " try {\n" +#~ " tx = session.beginTransaction();\n" +#~ " Blog blog = (Blog) session.load(Blog.class, blogid);\n" +#~ " item.setBlog(blog);\n" +#~ " blog.getItems().add(item);\n" +#~ " tx.commit();\n" +#~ " }\n" +#~ " catch (HibernateException he) {\n" +#~ " if (tx!=null) tx.rollback();\n" +#~ " throw he;\n" +#~ " }\n" +#~ " finally {\n" +#~ " session.close();\n" +#~ " }\n" +#~ " return item;\n" +#~ " }\n" +#~ " \n" +#~ " public void updateBlogItem(BlogItem item, String text)\n" +#~ " throws HibernateException {\n" +#~ " \n" +#~ " item.setText(text);\n" +#~ " \n" +#~ " Session session = _sessions.openSession();\n" +#~ " Transaction tx = null;\n" +#~ " try {\n" +#~ " tx = session.beginTransaction();\n" +#~ " session.update(item);\n" +#~ " tx.commit();\n" +#~ " }\n" +#~ " catch (HibernateException he) {\n" +#~ " if (tx!=null) tx.rollback();\n" +#~ " throw he;\n" +#~ " }\n" +#~ " finally {\n" +#~ " session.close();\n" +#~ " }\n" +#~ " }\n" +#~ " \n" +#~ " public void updateBlogItem(Long itemid, String text)\n" +#~ " throws HibernateException {\n" +#~ " \n" +#~ " Session session = _sessions.openSession();\n" +#~ " Transaction tx = null;\n" +#~ " try {\n" +#~ " tx = session.beginTransaction();\n" +#~ " BlogItem item = (BlogItem) session.load(BlogItem.class, " +#~ "itemid);\n" +#~ " item.setText(text);\n" +#~ " tx.commit();\n" +#~ " }\n" +#~ " catch (HibernateException he) {\n" +#~ " if (tx!=null) tx.rollback();\n" +#~ " throw he;\n" +#~ " }\n" +#~ " finally {\n" +#~ " session.close();\n" +#~ " }\n" +#~ " }\n" +#~ " \n" +#~ " public List listAllBlogNamesAndItemCounts(int max)\n" +#~ " throws HibernateException {\n" +#~ " \n" +#~ " Session session = _sessions.openSession();\n" +#~ " Transaction tx = null;\n" +#~ " List result = null;\n" +#~ " try {\n" +#~ " tx = session.beginTransaction();\n" +#~ " Query q = session.createQuery(\n" +#~ " \"select blog.id, blog.name, count(blogItem) \" +\n" +#~ " \"from Blog as blog \" +\n" +#~ " \"left outer join blog.items as blogItem \" +\n" +#~ " \"group by blog.name, blog.id \" +\n" +#~ " \"order by max(blogItem.datetime)\"\n" +#~ " );\n" +#~ " q.setMaxResults(max);\n" +#~ " result = q.list();\n" +#~ " tx.commit();\n" +#~ " }\n" +#~ " catch (HibernateException he) {\n" +#~ " if (tx!=null) tx.rollback();\n" +#~ " throw he;\n" +#~ " }\n" +#~ " finally {\n" +#~ " session.close();\n" +#~ " }\n" +#~ " return result;\n" +#~ " }\n" +#~ " \n" +#~ " public Blog getBlogAndAllItems(Long blogid)\n" +#~ " throws HibernateException {\n" +#~ " \n" +#~ " Session session = _sessions.openSession();\n" +#~ " Transaction tx = null;\n" +#~ " Blog blog = null;\n" +#~ " try {\n" +#~ " tx = session.beginTransaction();\n" +#~ " Query q = session.createQuery(\n" +#~ " \"from Blog as blog \" +\n" +#~ " \"left outer join fetch blog.items \" +\n" +#~ " \"where blog.id = :blogid\"\n" +#~ " );\n" +#~ " q.setParameter(\"blogid\", blogid);\n" +#~ " blog = (Blog) q.uniqueResult();\n" +#~ " tx.commit();\n" +#~ " }\n" +#~ " catch (HibernateException he) {\n" +#~ " if (tx!=null) tx.rollback();\n" +#~ " throw he;\n" +#~ " }\n" +#~ " finally {\n" +#~ " session.close();\n" +#~ " }\n" +#~ " return blog;\n" +#~ " }\n" +#~ " \n" +#~ " public List listBlogsAndRecentItems() throws HibernateException {\n" +#~ " \n" +#~ " Session session = _sessions.openSession();\n" +#~ " Transaction tx = null;\n" +#~ " List result = null;\n" +#~ " try {\n" +#~ " tx = session.beginTransaction();\n" +#~ " Query q = session.createQuery(\n" +#~ " \"from Blog as blog \" +\n" +#~ " \"inner join blog.items as blogItem \" +\n" +#~ " \"where blogItem.datetime > :minDate\"\n" +#~ " );\n" +#~ "\n" +#~ " Calendar cal = Calendar.getInstance();\n" +#~ " cal.roll(Calendar.MONTH, false);\n" +#~ " q.setCalendar(\"minDate\", cal);\n" +#~ " \n" +#~ " result = q.list();\n" +#~ " tx.commit();\n" +#~ " }\n" +#~ " catch (HibernateException he) {\n" +#~ " if (tx!=null) tx.rollback();\n" +#~ " throw he;\n" +#~ " }\n" +#~ " finally {\n" +#~ " session.close();\n" +#~ " }\n" +#~ " return result;\n" +#~ " }\n" +#~ "}" Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/filters.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/filters.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/filters.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,608 @@ +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# Language /mnt/hgfs/base/Hibernate/Reference translations for PACKAGE package. +# Copyright (C) 2006, 2007 Free Software Foundation, Inc. +# Automatically generated, 2006. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# +msgid "" +msgstr "" +"Project-Id-Version: Collection_Mapping\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2009-12-03T00:15:26\n" +"PO-Revision-Date: 2007-02-26 10:27+1000\n" +"Last-Translator: \n" +"Language-Team: <de(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.9.1\n" + +#. Tag: title +#, no-c-format +msgid "Filtering data" +msgstr "Das Filtern von Daten" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate3 provides an innovative new approach to handling data with " +"\"visibility\" rules. A <emphasis>Hibernate filter</emphasis> is a global, " +"named, parameterized filter that can be enabled or disabled for a particular " +"Hibernate session." +msgstr "" +"Hibernate3 bietet eine innovative, neue Möglichkeit des Umgangs mit Daten " +"mittels \"Sichtbarkeits\"regeln. Bei einem <emphasis>Hibernate Filter</" +"emphasis> handelt es sich um einen allgemeingültig benannten, " +"parametrisierten Filter, der für eine bestimmte Hibernate Session aktiviert " +"oder deaktiviert werden kann." + +#. Tag: title +#, no-c-format +msgid "Hibernate filters" +msgstr "Hibernate Filter" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate3 has the ability to pre-define filter criteria and attach those " +"filters at both a class level and a collection level. A filter criteria " +"allows you to define a restriction clause similar to the existing \"where\" " +"attribute available on the class and various collection elements. These " +"filter conditions, however, can be parameterized. The application can then " +"decide at runtime whether certain filters should be enabled and what their " +"parameter values should be. Filters can be used like database views, but " +"they are parameterized inside the application." +msgstr "" +"Hibernate3 bietet die zusätzliche Möglichkeit, Filterkriterien im Vorfeld zu " +"definieren und diese Filter sowohl einer Klasse als auch einer Collection-" +"Ebene zuzufügen. Ein Filterkriterium ist die Möglichkeit eine " +"Einschränkungsklausel zu definieren, die dem bestehenden \"where\"-Attribut " +"an der Klasse sowie an verschiedenen Collection-Elementen sehr ähnlich ist. " +"Der Unterschied besteht darin, dass diese Filterbedingungen parametrisiert " +"werden können. Die Anwendung kann zur Runtime die Entscheidung darüber " +"treffen, ob die vorgegebenen Filter aktiviert werden und wie deren Parameter " +"lauten sollen. Filter können wie Datenbankansichten verwendet , jedoch " +"innerhalb der Anwendung parametrisiert werden." + +#. Tag: para +#, no-c-format +msgid "" +"In order to use filters, they must first be defined and then attached to the " +"appropriate mapping elements. To define a filter, use the <literal><" +"filter-def/></literal> element within a <literal><hibernate-mapping/" +"></literal> element:" +msgstr "" +"Um Filter zu benutzen müssen diese zunächst definiert und anschließend den " +"betreffenden Mapping-Elementen zugefügt werden. Um einen Filter zu " +"definieren, verwenden Sie das <literal><filter-def/></literal>-Element " +"innerhalb eines <literal><hibernate-mapping/></literal>-Elements:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "This filter can then be attached to a class:" +msgstr "Anschließend kann dieser Filter einer Klasse zugefügt werden:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "Or, to a collection:" +msgstr "oder einer Collection:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "Or, to both or multiples of each at the same time." +msgstr "oder gar beiden (oder mehreren von beiden) gleichzeitig." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The methods on <literal>Session</literal> are: <literal>enableFilter(String " +"filterName)</literal>, <literal>getEnabledFilter(String filterName)</" +"literal>, and <literal>disableFilter(String filterName)</literal>. By " +"default, filters are <emphasis>not</emphasis> enabled for a given session. " +"Filters must be enabled through use of the <literal>Session.enableFilter()</" +"literal> method, which returns an instance of the <literal>Filter</literal> " +"interface. If you used the simple filter defined above, it would look like " +"this:" +msgstr "" +"Die Methoden an <literal>Session</literal> sind: <literal>enableFilter" +"(String filterName)</literal>, <literal>getEnabledFilter(String filterName)</" +"literal> und <literal>disableFilter(String filterName)</literal>. " +"Standardmäßig werden Filter <emphasis>nicht</emphasis> für eine vorgegebene " +"Session verwendet, sondern müssen mittels der <literal>Session.enabledFilter" +"()</literal>-Methode, die eine Instanz des <literal>Filter</literal>-" +"Interface wiedergibt, explizit aktiviert werden. Die Verwendung des oben " +"definierten, einfachen Filters würde wie folgt aussehen:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Methods on the org.hibernate.Filter interface do allow the method-chaining " +"common to much of Hibernate." +msgstr "" +"Bitte beachten Sie, dass Methoden am org.hibernate.Filter-Interface " +"Methodenverkettung - wie in den meisten Teilen von Hibernate üblich - " +"erlauben." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The following is a full example, using temporal data with an effective " +"record date pattern:" +msgstr "" +"Nachfolgend sehen Sie ein vollständiges Beispiel unter Verwendung temporaler " +"Daten mit effektivem Datumsformat für den Datensatz:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"In order to ensure that you are provided with currently effective records, " +"enable the filter on the session prior to retrieving employee data:" +msgstr "" +"Anschließend aktivieren Sie einfach den Filter an der Session vor dem Abruf " +"der Angestelltendaten um sicherzustellen, dass Sie stets die aktuell " +"wirksamen Datensätze erhalten:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Even though a salary constraint was mentioned explicitly on the results in " +"the above HQL, because of the enabled filter, the query will return only " +"currently active employees who have a salary greater than one million " +"dollars." +msgstr "" +"In der vorherigen HQL antwortet die Anfrage wegen des aktivierten Filters " +"nur mit aktuell aktiven Angestellten, deren Gehalt höher als eine Million " +"Dollar ist, obwohl lediglich eine Gehaltsbedingung formuliert wurde." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If you want to use filters with outer joining, either through HQL or load " +"fetching, be careful of the direction of the condition expression. It is " +"safest to set this up for left outer joining. Place the parameter first " +"followed by the column name(s) after the operator." +msgstr "" +"Hinweis: Falls Sie vorhaben, Filter mit \"outer-Joining\" zu verwenden " +"(entweder durch HQL oder Load-Abruf) achten Sie auf die Richtung des " +"Bedingungsausdrucks. Am sichersten ist es, das Ganze für \"left-outer-Joining" +"\" einzurichten. Generell sollte der Parameter zuerst gesetzt werden und " +"anschließend der (die) Spaltenname(n) nach dem Operator." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"After being defined, a filter might be attached to multiple entities and/or " +"collections each with its own condition. This can be problematic when the " +"conditions are the same each time. Using <literal><filter-def/></" +"literal> allows you to definine a default condition, either as an attribute " +"or CDATA:" +msgstr "" +"Nachdem ein Filter definiert wurde, kann er mehreren Entities und/oder " +"Collections mit jeweils eigener Bedingung hinzugefügt werden. Das kann eine " +"langweilige Aufgabe sein, wenn die Bedingungen stets dieselben sind. Daher " +"erlaubt <literal><filter-def/></literal> die Definition einer " +"Standardbedingung als Attribut oder als CDATA:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This default condition will be used whenever the filter is attached to " +"something without specifying a condition. This means you can give a specific " +"condition as part of the attachment of the filter that overrides the default " +"condition in that particular case." +msgstr "" +"Diese Standardbedingung wird dann verwendet, wenn der Filter zu etwas " +"hinzugefügt wird, ohne dass eine Bedingung spezifiziert wird. Bitte beachten " +"Sie, dass dies bedeutet, dass Sie eine spezielle Bedingung als Teil des " +"Filteranhangs festlegen können, die die Standardbedingung in diesem " +"bestimmten Fall außer Kraft setzt." + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<filter-def name=\"myFilter\">\n" +#~ " <filter-param name=\"myFilterParam\" type=\"string\"/>\n" +#~ "</filter-def>]]>" +#~ msgstr "" +#~ "<filter-def name=\"myFilter\">\n" +#~ " <filter-param name=\"myFilterParam\" type=\"string\"/>\n" +#~ "</filter-def>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"myClass\" ...>\n" +#~ " ...\n" +#~ " <filter name=\"myFilter\" condition=\":myFilterParam = " +#~ "MY_FILTERED_COLUMN\"/>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"myClass\" ...>\n" +#~ " ...\n" +#~ " <filter name=\"myFilter\" condition=\":myFilterParam = " +#~ "MY_FILTERED_COLUMN\"/>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<set ...>\n" +#~ " <filter name=\"myFilter\" condition=\":myFilterParam = " +#~ "MY_FILTERED_COLUMN\"/>\n" +#~ "</set>]]>" +#~ msgstr "" +#~ "<set ...>\n" +#~ " <filter name=\"myFilter\" condition=\":myFilterParam = " +#~ "MY_FILTERED_COLUMN\"/>\n" +#~ "</set>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[session.enableFilter(\"myFilter\").setParameter(\"myFilterParam" +#~ "\", \"some-value\");]]>" +#~ msgstr "" +#~ "session.enableFilter(\"myFilter\").setParameter(\"myFilterParam\", \"some-" +#~ "value\");" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<filter-def name=\"effectiveDate\">\n" +#~ " <filter-param name=\"asOfDate\" type=\"date\"/>\n" +#~ "</filter-def>\n" +#~ "\n" +#~ "<class name=\"Employee\" ...>\n" +#~ "...\n" +#~ " <many-to-one name=\"department\" column=\"dept_id\" class=\"Department" +#~ "\"/>\n" +#~ " <property name=\"effectiveStartDate\" type=\"date\" column=" +#~ "\"eff_start_dt\"/>\n" +#~ " <property name=\"effectiveEndDate\" type=\"date\" column=\"eff_end_dt" +#~ "\"/>\n" +#~ "...\n" +#~ " \n" +#~ " <filter name=\"effectiveDate\"\n" +#~ " condition=\":asOfDate BETWEEN eff_start_dt and eff_end_dt\"/" +#~ ">\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Department\" ...>\n" +#~ "...\n" +#~ " <set name=\"employees\" lazy=\"true\">\n" +#~ " <key column=\"dept_id\"/>\n" +#~ " <one-to-many class=\"Employee\"/>\n" +#~ " <filter name=\"effectiveDate\"\n" +#~ " condition=\":asOfDate BETWEEN eff_start_dt and eff_end_dt" +#~ "\"/>\n" +#~ " </set>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<filter-def name=\"effectiveDate\">\n" +#~ " <filter-param name=\"asOfDate\" type=\"date\"/>\n" +#~ "</filter-def>\n" +#~ "\n" +#~ "<class name=\"Employee\" ...>\n" +#~ "...\n" +#~ " <many-to-one name=\"department\" column=\"dept_id\" class=" +#~ "\"Department\"/>\n" +#~ " <property name=\"effectiveStartDate\" type=\"date\" column=" +#~ "\"eff_start_dt\"/>\n" +#~ " <property name=\"effectiveEndDate\" type=\"date\" column=" +#~ "\"eff_end_dt\"/>\n" +#~ "...\n" +#~ " \n" +#~ " <filter name=\"effectiveDate\"\n" +#~ " condition=\":asOfDate BETWEEN eff_start_dt and eff_end_dt\"/" +#~ ">\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"Department\" ...>\n" +#~ "...\n" +#~ " <set name=\"employees\" lazy=\"true\">\n" +#~ " <key column=\"dept_id\"/>\n" +#~ " <one-to-many class=\"Employee\"/>\n" +#~ " <filter name=\"effectiveDate\"\n" +#~ " condition=\":asOfDate BETWEEN eff_start_dt and eff_end_dt" +#~ "\"/>\n" +#~ " </set>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Session session = ...;\n" +#~ "session.enableFilter(\"effectiveDate\").setParameter(\"asOfDate\", new " +#~ "Date());\n" +#~ "List results = session.createQuery(\"from Employee as e where e.salary > :" +#~ "targetSalary\")\n" +#~ " .setLong(\"targetSalary\", new Long(1000000))\n" +#~ " .list();\n" +#~ "]]>" +#~ msgstr "" +#~ "Session session = ...;\n" +#~ "session.enabledFilter(\"effectiveDate\").setParameter(\"asOfDate\", new " +#~ "Date());\n" +#~ "List results = session.createQuery(\"from Employee as e where e.salary " +#~ "> :targetSalary\")\n" +#~ " .setLong(\"targetSalary\", new Long(1000000))\n" +#~ " .list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<filter-def name=\"myFilter\" condition=\"abc > xyz\">...</" +#~ "filter-def>\n" +#~ "<filter-def name=\"myOtherFilter\">abc=xyz</filter-def>]]>" +#~ msgstr "" +#~ "<filter-def name=\"myFilter\" condition=\"abc > xyz\">...</" +#~ "filter-def>\n" +#~ "<filter-def name=\"myOtherFilter\">abc=xyz</filter-def>" Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/inheritance_mapping.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/inheritance_mapping.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/inheritance_mapping.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,1198 @@ +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# Language /mnt/hgfs/base/Hibernate/Reference translations for PACKAGE package. +# Copyright (C) 2006, 2007 Free Software Foundation, Inc. +# Automatically generated, 2006. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# +msgid "" +msgstr "" +"Project-Id-Version: Collection_Mapping\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2010-01-08T04:07:19\n" +"PO-Revision-Date: 2007-02-26 10:27+1000\n" +"Last-Translator: \n" +"Language-Team: <de(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.9.1\n" + +#. Tag: title +#, fuzzy, no-c-format +msgid "Inheritance mapping" +msgstr "Vererbungsmapping" + +#. Tag: title +#, fuzzy, no-c-format +msgid "The three strategies" +msgstr "Die drei Strategien" + +#. Tag: para +#, no-c-format +msgid "Hibernate supports the three basic inheritance mapping strategies:" +msgstr "" +"Hibernate unterstützt drei grundlegende Mapping-Strategien der Vererbung:" + +#. Tag: para +#, no-c-format +msgid "table per class hierarchy" +msgstr "\"Tabelle-pro-Klasse\"-Hierarchie" + +#. Tag: para +#, fuzzy, no-c-format +msgid "table per subclass" +msgstr "\"Tabelle-pro-Subklasse\"" + +#. Tag: para +#, no-c-format +msgid "table per concrete class" +msgstr "\"Tabelle-pro-konkrete-Klasse\"" + +#. Tag: para +#, no-c-format +msgid "" +"In addition, Hibernate supports a fourth, slightly different kind of " +"polymorphism:" +msgstr "" +"Desweiteren unterstützt Hibernate eine vierte, etwas andere Art der " +"Polymorphie:" + +#. Tag: para +#, no-c-format +msgid "implicit polymorphism" +msgstr "implizite Polymorphie" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"It is possible to use different mapping strategies for different branches of " +"the same inheritance hierarchy. You can then make use of implicit " +"polymorphism to achieve polymorphism across the whole hierarchy. However, " +"Hibernate does not support mixing <literal><subclass></literal>, " +"<literal><joined-subclass></literal> and <literal><union-" +"subclass></literal> mappings under the same root <literal><class></" +"literal> element. It is possible to mix together the table per hierarchy and " +"table per subclass strategies under the the same <literal><class></" +"literal> element, by combining the <literal><subclass></literal> and " +"<literal><join></literal> elements (see below for an example)." +msgstr "" +"Es ist möglich, unterschiedliche Mapping-Strategien für verschiedene Zweige " +"derselben Vererbungshierarchie zu verwenden und diese anschließend implizite " +"Polymorphie verwenden zu lassen, um über die gesamte Hierarchie hinweg " +"Polymorphie zu erreichen. Es ist bei Hibernate jedoch nicht möglich " +"<literal><subclass></literal> und <literal><joined-subclass></" +"literal> und <literal><union-subclass></literal> Mappings unter " +"demselben Stamm <literal><class></literal>-Element zu mischen. Es ist " +"aber möglich die Tabelle-pro-Hierarchie (sog. \"table per hierarchy\") und " +"Tabelle-pro-Subklasse (sog. \"table per subclass\") Strategien unter " +"demselben <literal><class></literal>-Element durch Kombination der " +"<literal><subclass></literal> und <literal><join></literal>-" +"Elemente zu mischen (siehe unten)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"It is possible to define <literal>subclass</literal>, <literal>union-" +"subclass</literal>, and <literal>joined-subclass</literal> mappings in " +"separate mapping documents directly beneath <literal>hibernate-mapping</" +"literal>. This allows you to extend a class hierarchy by adding a new " +"mapping file. You must specify an <literal>extends</literal> attribute in " +"the subclass mapping, naming a previously mapped superclass. Previously this " +"feature made the ordering of the mapping documents important. Since " +"Hibernate3, the ordering of mapping files is irrelevant when using the " +"extends keyword. The ordering inside a single mapping file still needs to be " +"defined as superclasses before subclasses." +msgstr "" +"Es ist möglich, <literal>subclass</literal>, <literal>union-subclass</" +"literal> und <literal>joined-subclass</literal> Mappings in verschiedenen " +"Mapping-Dokumenten direkt unterhalb des <literal>hibernate-mapping</literal> " +"zu definieren. Dadurch kann eine Klassenhierarchie ganz einfach durch " +"Hinzufügen einer neuen Mapping-Datei erweitert werden. Sie müssen ein " +"<literal>extends</literal>-Attribut im Subklassen-Mapping bestimmen, das " +"eine zuvor gemappte Superklasse benennt. Hinweis: In der Vergangenheit " +"machte dieses Feature die Anordnung der Mapping-Dokumente wichtig. Seit " +"Hibernate3 ist die Anordnung der Mapping-Dateien nicht mehr relevant, wenn " +"der \"extends\"-Schlüsselbegriff verwendet wird. Die Anordnung innerhalb " +"einer einzelnen Mapping-Datei muss nach wie vor als Superklasse vor " +"Subklasse definiert werden." + +#. Tag: title +#, no-c-format +msgid "Table per class hierarchy" +msgstr "\"Tabelle-pro-Klasse\"-Hierarchie" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Suppose we have an interface <literal>Payment</literal> with the " +"implementors <literal>CreditCardPayment</literal>, <literal>CashPayment</" +"literal>, and <literal>ChequePayment</literal>. The table per hierarchy " +"mapping would display in the following way:" +msgstr "" +"Nehmen wir an, wir hätten ein Interface <literal>Payment</literal> mit den " +"\"Implementoren\" <literal>CreditCardPayment</literal>, " +"<literal>CashPayment</literal>, <literal>ChequePayment</literal>. Die " +"\"Tabelle-pro-Klasse\"-Hierarchie würde wie folgt aussehen:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Exactly one table is required. There is a limitation of this mapping " +"strategy: columns declared by the subclasses, such as <literal>CCTYPE</" +"literal>, cannot have <literal>NOT NULL</literal> constraints." +msgstr "" +"Es wird genau eine Tabelle benötigt. Es gilt jedoch eine große Einschränkung " +"bei dieser Mapping-Strategie: Durch Subklassen deklarierte Spalten wie " +"<literal>CCTYPE</literal>, dürfen keine <literal>NOT NULL</literal>-" +"Bedingungen besitzen." + +#. Tag: title +#, no-c-format +msgid "Table per subclass" +msgstr "\"Tabelle-pro-Subklasse\"" + +#. Tag: para +#, fuzzy, no-c-format +msgid "A table per subclass mapping looks like this:" +msgstr "Das Mapping einer \"Tabelle-pro-Subklasse\" würde wie folgt aussehen:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Four tables are required. The three subclass tables have primary key " +"associations to the superclass table so the relational model is actually a " +"one-to-one association." +msgstr "" +"Vier Tabellen werden benötigt. Die drei Subklassentabellen besitzen " +"Assoziationen des Primärschlüssels zur Superklassentabelle (das relationale " +"Modell ist also genau genommen eine \"One-to-One\"-Assoziation)." + +#. Tag: title +#, fuzzy, no-c-format +msgid "Table per subclass: using a discriminator" +msgstr "\"Tabelle-pro-Subklasse\", unter Verwendung eines Diskriminators" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate's implementation of table per subclass does not require a " +"discriminator column. Other object/relational mappers use a different " +"implementation of table per subclass that requires a type discriminator " +"column in the superclass table. The approach taken by Hibernate is much more " +"difficult to implement, but arguably more correct from a relational point of " +"view. If you want to use a discriminator column with the table per subclass " +"strategy, you can combine the use of <literal><subclass></literal> and " +"<literal><join></literal>, as follows:" +msgstr "" +"Bitte beachten Sie, dass Hibernates Implementierung von \"Tabelle-pro-" +"Subklasse\" keine Diskriminatorspalte erfordert. Andere objekt/relationale " +"Mapper verwenden eine andere Implementierung von \"Tabelle-pro-Subklasse\", " +"die eine Art Diskriminatorspalte in der Superklassentabelle benötigt. Die " +"von Hibernate benutzte Variante ist zwar hinsichtlich ihrer Implementierung " +"komplexer, aber von einem relationalen Gesichtspunkt aus betrachtet " +"korrekter. Falls Sie eine Diskriminatorspalte mit der \"Tabelle-pro-Subklasse" +"\"-Strategie verwenden möchten, können Sie den Gebrauch von <literal><" +"subclass></literal> und <literal><join></literal> wie folgt " +"kombinieren:" + +#. Tag: para +#, no-c-format +msgid "" +"The optional <literal>fetch=\"select\"</literal> declaration tells Hibernate " +"not to fetch the <literal>ChequePayment</literal> subclass data using an " +"outer join when querying the superclass." +msgstr "" +"Durch die optionale <literal>fetch=\"select\"</literal>-Deklaration ruft " +"Hibernate die <literal>ChequePayment</literal>-Subklassendaten unter " +"Verwendung eines äußeren Verbunds (sog. \"outer Join\") bei Anfragen an die " +"Superklasse nicht auf." + +#. Tag: title +#, no-c-format +msgid "Mixing table per class hierarchy with table per subclass" +msgstr "" +"Das Mischen der \"Tabelle-pro-Klasse\"-Hierarchie mit \"Tabelle-pro-Subklasse" +"\"" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can even mix the table per hierarchy and table per subclass strategies " +"using the following approach:" +msgstr "" +"Sie können sogar die \"Tabelle-pro-Klasse\"-Hierarchie mit \"Tabelle-pro-" +"Subklasse\" mischen, indem Sie wie folgt vorgehen:" + +#. Tag: para +#, no-c-format +msgid "" +"For any of these mapping strategies, a polymorphic association to the root " +"<literal>Payment</literal> class is mapped using <literal><many-to-one>" +"</literal>." +msgstr "" +"Bei allen diesen Mapping-Strategien wird eine polymorphe Assoziation zur " +"Stamm-<literal>Payment</literal>-Klasse mittels <literal><many-to-one>" +"</literal> gemappt." + +#. Tag: title +#, no-c-format +msgid "Table per concrete class" +msgstr "\"Tabelle-pro-konkrete-Klasse\"" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"There are two ways we can map the table per concrete class strategy. First, " +"you can use <literal><union-subclass></literal>." +msgstr "" +"Das Mappen der \"Tabelle-pro-konkrete-Klasse\"-Strategie kann auf zwei Arten " +"erfolgen. Bei der ersten wird <literal><union-subclass></literal> " +"verwendet." + +#. Tag: para +#, no-c-format +msgid "" +"Three tables are involved for the subclasses. Each table defines columns for " +"all properties of the class, including inherited properties." +msgstr "" +"Drei Tabellen sind für die Subklassen involviert. Jede Tabelle definiert " +"Spalten für alle Properties der Klasse, einschließlich vererbter Properties." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The limitation of this approach is that if a property is mapped on the " +"superclass, the column name must be the same on all subclass tables. The " +"identity generator strategy is not allowed in union subclass inheritance. " +"The primary key seed has to be shared across all unioned subclasses of a " +"hierarchy." +msgstr "" +"Die Einschränkung bei dieser Vorgehensweise liegt darin, dass bei einer an " +"die Superklasse gemappten Property der Spaltenname für alle " +"Subklassentabellen gleich sein muss. (In zukünftigen Versionen von Hibernate " +"wird dies möglicherweise anders sein). Die Identitätsgeneratorstrategie ist " +"bei der Vererbung von Union-Subklassen nicht erlaubt, der Startparameter des " +"Primärschlüssels (sog. \"primary key seed\") muss auf sämtlichen vereinten " +"Subklassen einer Hierarchie geteilt werden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If your superclass is abstract, map it with <literal>abstract=\"true\"</" +"literal>. If it is not abstract, an additional table (it defaults to " +"<literal>PAYMENT</literal> in the example above), is needed to hold " +"instances of the superclass." +msgstr "" +"Falls Ihre Superklasse abstrakt ist, mappen Sie sie mit <literal>abstract=" +"\"true\"</literal>. Falls sie nicht abstrakt ist, wird natürlich eine " +"zusätzliche Tabelle (Standard ist <literal>PAYMENT</literal> im vorherigen " +"Beispiel) benötigt, um Instanzen der Superklasse zu enthalten." + +#. Tag: title +#, fuzzy, no-c-format +msgid "Table per concrete class using implicit polymorphism" +msgstr "" +"\"Tabelle-pro-konkrete-Klasse\" unter Verwendung impliziter Polymorphie" + +#. Tag: para +#, no-c-format +msgid "An alternative approach is to make use of implicit polymorphism:" +msgstr "Alternativ kann implizite Polymorphie angewendet werden:" + +#. Tag: para +#, no-c-format +msgid "" +"Notice that the <literal>Payment</literal> interface is not mentioned " +"explicitly. Also notice that properties of <literal>Payment</literal> are " +"mapped in each of the subclasses. If you want to avoid duplication, consider " +"using XML entities (for example, <literal>[ <!ENTITY allproperties SYSTEM " +"\"allproperties.xml\"> ]</literal> in the <literal>DOCTYPE</literal> " +"declaration and <literal>&allproperties&semi;</literal> in the mapping)." +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The disadvantage of this approach is that Hibernate does not generate SQL " +"<literal>UNION</literal>s when performing polymorphic queries." +msgstr "" +"Der Nachteil bei dieser Vorgehensweise liegt darin, dass Hibernate keine SQL " +"<literal>UNION</literal>s bei der Ausführung polymorpher Anfragen generiert." + +#. Tag: para +#, no-c-format +msgid "" +"For this mapping strategy, a polymorphic association to <literal>Payment</" +"literal> is usually mapped using <literal><any></literal>." +msgstr "" +"Bei dieser Mapping-Strategie wird in der Regel eine polymorphe Assoziation " +"zu <literal>Payment</literal> mittels <literal><any></literal> gemappt." + +#. Tag: title +#, no-c-format +msgid "Mixing implicit polymorphism with other inheritance mappings" +msgstr "Das Mischen impliziter Polymorphie mit anderen Vererbungsmappings" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Since the subclasses are each mapped in their own <literal><class></" +"literal> element, and since <literal>Payment</literal> is just an " +"interface), each of the subclasses could easily be part of another " +"inheritance hierarchy. You can still use polymorphic queries against the " +"<literal>Payment</literal> interface." +msgstr "" +"Ein weiterer Aspekt ist bei diesem Mapping bemerkenswert. Da die Subklassen " +"jeweils in ihrem eigenen <literal><class></literal>-Element gemappt " +"sind (und da es sich bei <literal>Payment</literal> lediglich um ein " +"Interface handelt), könnte jede der Subklassen ganz einfach Teil einer " +"anderen Vererbungshierarchie sein! (Und es können nach wie vor polymorphe " +"Anfragen am <literal>Payment</literal>-Interface erfolgen)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Once again, <literal>Payment</literal> is not mentioned explicitly. If we " +"execute a query against the <literal>Payment</literal> interface, for " +"example <literal>from Payment</literal>, Hibernate automatically returns " +"instances of <literal>CreditCardPayment</literal> (and its subclasses, since " +"they also implement <literal>Payment</literal>), <literal>CashPayment</" +"literal> and <literal>ChequePayment</literal>, but not instances of " +"<literal>NonelectronicTransaction</literal>." +msgstr "" +"Erneut erwähnen wir <literal>Payment</literal> nicht explizit. Wird eine " +"Anfrage am <literal>Payment</literal>-Interface ausgeführt - z.B. " +"<literal>from Payment</literal> - so reagiert Hibernate automatisch mit " +"Instanzen von <literal>CreditCardPayment</literal> (und dessen Subklassen, " +"da diese ebenfalls <literal>Payment</literal> implementieren), " +"<literal>CashPayment</literal> und <literal>ChequePayment</literal>, nicht " +"aber mit Instanzen von <literal>NonelectronicTransaction</literal>." + +#. Tag: title +#, no-c-format +msgid "Limitations" +msgstr "Einschränkungen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"There are limitations to the \"implicit polymorphism\" approach to the table " +"per concrete-class mapping strategy. There are somewhat less restrictive " +"limitations to <literal><union-subclass></literal> mappings." +msgstr "" +"Es existieren bestimmte Einschränkungen bei der Vorgehensweise mittels " +"\"impliziter Polymorphie\" bei der \"Tabelle-pro-konkrete-Klasse\" Mapping-" +"Strategie. Die Einschränkungen bei <literal><union-subclass></literal>-" +"Mappings sind wesentlich weniger restriktiv." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The following list shows the limitations of table per concrete-class " +"mappings, and of implicit polymorphism, in Hibernate." +msgstr "" +"Die folgende Tabelle zeigt die Einschränkungen der \"Tabelle-pro-konkrete-" +"Klasse\"-Mappings und der impliziten Polymorphie in Hibernate." + +#. Tag: term +#, fuzzy, no-c-format +msgid "table per class-heirarchy" +msgstr "\"Tabelle-pro-Klasse\"-Hierarchie" + +#. Tag: para +#, no-c-format +msgid "Polymorphic many-to-one: <code><many-to-one></code>" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "Polymorphic one-to-one: <code><one-to-one></code>" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "Polymorphic one-to-many: <code><one-to-many></code>" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "Polymorphic many-to-many: <code><many-to-many></code>" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"Polymorphic <literal>load()</literal> or <literal>get()</literal>: <code>s." +"get(Payment.class, id)</code>" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "Polymorphic queries: <code>from Payment p</code>" +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "Polymorphic joins: <code>from Order o join o.payment p</code>" +msgstr "von Order o join o.payment p" + +#. Tag: para +#, fuzzy, no-c-format +msgid "Outer join fetching is supported." +msgstr "\"Outer-Join-Fetching\"" + +#. Tag: term +#, no-c-format +msgid "table per concrete-class (union-subclass)" +msgstr "Tabelle-pro-konkrete-Klasse (Union-Subklasse)" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Polymorphic one-to-many: <code><one-to-many></code> (for <code>inverse=" +"\"true\"</code> only)" +msgstr "" +"<literal><one-to-many></literal> (nur für <literal>inverse=\"true\"</" +"literal>)" + +#. Tag: term +#, fuzzy, no-c-format +msgid "table per concrete class (implicit polymorphism" +msgstr "Tabelle pro konkrete Klasse (implizite Polymorphie)" + +#. Tag: para +#, fuzzy, no-c-format +msgid "Polymorphic many-to-one: <code><any></code>" +msgstr "Polymorphes \"Many-to-One\"" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Polymorphic <literal>load()</literal> or <literal>get()</literal>: <code>s." +"createCriteria(Payment.class).add( Restrictions.idEq(id) ).uniqueResult()</" +"code>" +msgstr "" +"s.createCriteria(Payment.class).add( Restrictions.idEq(id) ).uniqueResult()" + +#. Tag: para +#, no-c-format +msgid "" +"Polymorphic one-to-one, polymorphic one-to-many, polymorphic joins, and " +"outer join fetching are not supported." +msgstr "" + +#~ msgid "<para>table per subclass</para>" +#~ msgstr "<para>\"Tabelle-pro-Subklasse\"</para>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[\n" +#~ " <hibernate-mapping>\n" +#~ " <subclass name=\"DomesticCat\" extends=\"Cat\" discriminator-value=" +#~ "\"D\">\n" +#~ " <property name=\"name\" type=\"string\"/>\n" +#~ " </subclass>\n" +#~ " </hibernate-mapping>]]>" +#~ msgstr "" +#~ "<hibernate-mapping>\n" +#~ " <subclass name=\"DomesticCat\" extends=\"Cat\" discriminator-" +#~ "value=\"D\">\n" +#~ " <property name=\"name\" type=\"string\"/>\n" +#~ " </subclass>\n" +#~ " </hibernate-mapping>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Payment\" table=\"PAYMENT\">\n" +#~ " <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <discriminator column=\"PAYMENT_TYPE\" type=\"string\"/>\n" +#~ " <property name=\"amount\" column=\"AMOUNT\"/>\n" +#~ " ...\n" +#~ " <subclass name=\"CreditCardPayment\" discriminator-value=\"CREDIT\">\n" +#~ " <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" +#~ " ...\n" +#~ " </subclass>\n" +#~ " <subclass name=\"CashPayment\" discriminator-value=\"CASH\">\n" +#~ " ...\n" +#~ " </subclass>\n" +#~ " <subclass name=\"ChequePayment\" discriminator-value=\"CHEQUE\">\n" +#~ " ...\n" +#~ " </subclass>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Payment\" table=\"PAYMENT\">\n" +#~ " <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <discriminator column=\"PAYMENT_TYPE\" type=\"string\"/>\n" +#~ " <property name=\"amount\" column=\"AMOUNT\"/>\n" +#~ " ...\n" +#~ " <subclass name=\"CreditCardPayment\" discriminator-value=\"CREDIT" +#~ "\">\n" +#~ " <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" +#~ " ...\n" +#~ " </subclass>\n" +#~ " <subclass name=\"CashPayment\" discriminator-value=\"CASH\">\n" +#~ " ...\n" +#~ " </subclass>\n" +#~ " <subclass name=\"ChequePayment\" discriminator-value=\"CHEQUE" +#~ "\">\n" +#~ " ...\n" +#~ " </subclass>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Payment\" table=\"PAYMENT\">\n" +#~ " <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <property name=\"amount\" column=\"AMOUNT\"/>\n" +#~ " ...\n" +#~ " <joined-subclass name=\"CreditCardPayment\" table=\"CREDIT_PAYMENT" +#~ "\">\n" +#~ " <key column=\"PAYMENT_ID\"/>\n" +#~ " <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" +#~ " ...\n" +#~ " </joined-subclass>\n" +#~ " <joined-subclass name=\"CashPayment\" table=\"CASH_PAYMENT\">\n" +#~ " <key column=\"PAYMENT_ID\"/>\n" +#~ " ...\n" +#~ " </joined-subclass>\n" +#~ " <joined-subclass name=\"ChequePayment\" table=\"CHEQUE_PAYMENT\">\n" +#~ " <key column=\"PAYMENT_ID\"/>\n" +#~ " ...\n" +#~ " </joined-subclass>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Payment\" table=\"PAYMENT\">\n" +#~ " <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <property name=\"amount\" column=\"AMOUNT\"/>\n" +#~ " ...\n" +#~ " <joined-subclass name=\"CreditCardPayment\" table=\"CREDIT_PAYMENT" +#~ "\">\n" +#~ " <key column=\"PAYMENT_ID\"/>\n" +#~ " <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" +#~ " ...\n" +#~ " </joined-subclass>\n" +#~ " <joined-subclass name=\"CashPayment\" table=\"CASH_PAYMENT\">\n" +#~ " <key column=\"PAYMENT_ID\"/>\n" +#~ " ...\n" +#~ " </joined-subclass>\n" +#~ " <joined-subclass name=\"ChequePayment\" table=\"CHEQUE_PAYMENT" +#~ "\">\n" +#~ " <key column=\"PAYMENT_ID\"/>\n" +#~ " ...\n" +#~ " </joined-subclass>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Payment\" table=\"PAYMENT\">\n" +#~ " <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <discriminator column=\"PAYMENT_TYPE\" type=\"string\"/>\n" +#~ " <property name=\"amount\" column=\"AMOUNT\"/>\n" +#~ " ...\n" +#~ " <subclass name=\"CreditCardPayment\" discriminator-value=\"CREDIT\">\n" +#~ " <join table=\"CREDIT_PAYMENT\">\n" +#~ " <key column=\"PAYMENT_ID\"/>\n" +#~ " <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" +#~ " ...\n" +#~ " </join>\n" +#~ " </subclass>\n" +#~ " <subclass name=\"CashPayment\" discriminator-value=\"CASH\">\n" +#~ " <join table=\"CASH_PAYMENT\">\n" +#~ " <key column=\"PAYMENT_ID\"/>\n" +#~ " ...\n" +#~ " </join>\n" +#~ " </subclass>\n" +#~ " <subclass name=\"ChequePayment\" discriminator-value=\"CHEQUE\">\n" +#~ " <join table=\"CHEQUE_PAYMENT\" fetch=\"select\">\n" +#~ " <key column=\"PAYMENT_ID\"/>\n" +#~ " ...\n" +#~ " </join>\n" +#~ " </subclass>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Payment\" table=\"PAYMENT\">\n" +#~ " <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <discriminator column=\"PAYMENT_TYPE\" type=\"string\"/>\n" +#~ " <property name=\"amount\" column=\"AMOUNT\"/>\n" +#~ " ...\n" +#~ " <subclass name=\"CreditCardPayment\" discriminator-value=\"CREDIT" +#~ "\">\n" +#~ " <join table=\"CREDIT_PAYMENT\">\n" +#~ " <key column=\"PAYMENT_ID\"/>\n" +#~ " <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" +#~ " ...\n" +#~ " </join>\n" +#~ " </subclass>\n" +#~ " <subclass name=\"CashPayment\" discriminator-value=\"CASH\">\n" +#~ " <join table=\"CASH_PAYMENT\">\n" +#~ " <key column=\"PAYMENT_ID\"/>\n" +#~ " ...\n" +#~ " </join>\n" +#~ " </subclass>\n" +#~ " <subclass name=\"ChequePayment\" discriminator-value=\"CHEQUE" +#~ "\">\n" +#~ " <join table=\"CHEQUE_PAYMENT\" fetch=\"select\">\n" +#~ " <key column=\"PAYMENT_ID\"/>\n" +#~ " ...\n" +#~ " </join>\n" +#~ " </subclass>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Payment\" table=\"PAYMENT\">\n" +#~ " <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <discriminator column=\"PAYMENT_TYPE\" type=\"string\"/>\n" +#~ " <property name=\"amount\" column=\"AMOUNT\"/>\n" +#~ " ...\n" +#~ " <subclass name=\"CreditCardPayment\" discriminator-value=\"CREDIT\">\n" +#~ " <join table=\"CREDIT_PAYMENT\">\n" +#~ " <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" +#~ " ...\n" +#~ " </join>\n" +#~ " </subclass>\n" +#~ " <subclass name=\"CashPayment\" discriminator-value=\"CASH\">\n" +#~ " ...\n" +#~ " </subclass>\n" +#~ " <subclass name=\"ChequePayment\" discriminator-value=\"CHEQUE\">\n" +#~ " ...\n" +#~ " </subclass>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Payment\" table=\"PAYMENT\">\n" +#~ " <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <discriminator column=\"PAYMENT_TYPE\" type=\"string\"/>\n" +#~ " <property name=\"amount\" column=\"AMOUNT\"/>\n" +#~ " ...\n" +#~ " <subclass name=\"CreditCardPayment\" discriminator-value=\"CREDIT" +#~ "\">\n" +#~ " <join table=\"CREDIT_PAYMENT\">\n" +#~ " <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" +#~ " ...\n" +#~ " </join>\n" +#~ " </subclass>\n" +#~ " <subclass name=\"CashPayment\" discriminator-value=\"CASH\">\n" +#~ " ...\n" +#~ " </subclass>\n" +#~ " <subclass name=\"ChequePayment\" discriminator-value=\"CHEQUE" +#~ "\">\n" +#~ " ...\n" +#~ " </subclass>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<many-to-one name=\"payment\" column=\"PAYMENT_ID\" class=" +#~ "\"Payment\"/>]]>" +#~ msgstr "" +#~ "<many-to-one name=\"payment\" column=\"PAYMENT_ID\" class=\"Payment\"/" +#~ ">" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Payment\">\n" +#~ " <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" +#~ " <generator class=\"sequence\"/>\n" +#~ " </id>\n" +#~ " <property name=\"amount\" column=\"AMOUNT\"/>\n" +#~ " ...\n" +#~ " <union-subclass name=\"CreditCardPayment\" table=\"CREDIT_PAYMENT\">\n" +#~ " <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" +#~ " ...\n" +#~ " </union-subclass>\n" +#~ " <union-subclass name=\"CashPayment\" table=\"CASH_PAYMENT\">\n" +#~ " ...\n" +#~ " </union-subclass>\n" +#~ " <union-subclass name=\"ChequePayment\" table=\"CHEQUE_PAYMENT\">\n" +#~ " ...\n" +#~ " </union-subclass>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Payment\">\n" +#~ " <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" +#~ " <generator class=\"sequence\"/>\n" +#~ " </id>\n" +#~ " <property name=\"amount\" column=\"AMOUNT\"/>\n" +#~ " ...\n" +#~ " <union-subclass name=\"CreditCardPayment\" table=\"CREDIT_PAYMENT" +#~ "\">\n" +#~ " <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" +#~ " ...\n" +#~ " </union-subclass>\n" +#~ " <union-subclass name=\"CashPayment\" table=\"CASH_PAYMENT\">\n" +#~ " ...\n" +#~ " </union-subclass>\n" +#~ " <union-subclass name=\"ChequePayment\" table=\"CHEQUE_PAYMENT" +#~ "\">\n" +#~ " ...\n" +#~ " </union-subclass>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"CreditCardPayment\" table=\"CREDIT_PAYMENT\">\n" +#~ " <id name=\"id\" type=\"long\" column=\"CREDIT_PAYMENT_ID\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <property name=\"amount\" column=\"CREDIT_AMOUNT\"/>\n" +#~ " ...\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"CashPayment\" table=\"CASH_PAYMENT\">\n" +#~ " <id name=\"id\" type=\"long\" column=\"CASH_PAYMENT_ID\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <property name=\"amount\" column=\"CASH_AMOUNT\"/>\n" +#~ " ...\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"ChequePayment\" table=\"CHEQUE_PAYMENT\">\n" +#~ " <id name=\"id\" type=\"long\" column=\"CHEQUE_PAYMENT_ID\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <property name=\"amount\" column=\"CHEQUE_AMOUNT\"/>\n" +#~ " ...\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"CreditCardPayment\" table=\"CREDIT_PAYMENT\">\n" +#~ " <id name=\"id\" type=\"long\" column=\"CREDIT_PAYMENT_ID\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <property name=\"amount\" column=\"CREDIT_AMOUNT\"/>\n" +#~ " ...\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"CashPayment\" table=\"CASH_PAYMENT\">\n" +#~ " <id name=\"id\" type=\"long\" column=\"CASH_PAYMENT_ID\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <property name=\"amount\" column=\"CASH_AMOUNT\"/>\n" +#~ " ...\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"ChequePayment\" table=\"CHEQUE_PAYMENT\">\n" +#~ " <id name=\"id\" type=\"long\" column=\"CHEQUE_PAYMENT_ID\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <property name=\"amount\" column=\"CHEQUE_AMOUNT\"/>\n" +#~ " ...\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<any name=\"payment\" meta-type=\"string\" id-type=\"long\">\n" +#~ " <meta-value value=\"CREDIT\" class=\"CreditCardPayment\"/>\n" +#~ " <meta-value value=\"CASH\" class=\"CashPayment\"/>\n" +#~ " <meta-value value=\"CHEQUE\" class=\"ChequePayment\"/>\n" +#~ " <column name=\"PAYMENT_CLASS\"/>\n" +#~ " <column name=\"PAYMENT_ID\"/>\n" +#~ "</any>]]>" +#~ msgstr "" +#~ "<any name=\"payment\" meta-type=\"string\" id-type=\"long\">\n" +#~ " <meta-value value=\"CREDIT\" class=\"CreditCardPayment\"/>\n" +#~ " <meta-value value=\"CASH\" class=\"CashPayment\"/>\n" +#~ " <meta-value value=\"CHEQUE\" class=\"ChequePayment\"/>\n" +#~ " <column name=\"PAYMENT_CLASS\"/>\n" +#~ " <column name=\"PAYMENT_ID\"/>\n" +#~ "</any>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"CreditCardPayment\" table=\"CREDIT_PAYMENT\">\n" +#~ " <id name=\"id\" type=\"long\" column=\"CREDIT_PAYMENT_ID\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <discriminator column=\"CREDIT_CARD\" type=\"string\"/>\n" +#~ " <property name=\"amount\" column=\"CREDIT_AMOUNT\"/>\n" +#~ " ...\n" +#~ " <subclass name=\"MasterCardPayment\" discriminator-value=\"MDC\"/>\n" +#~ " <subclass name=\"VisaPayment\" discriminator-value=\"VISA\"/>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"NonelectronicTransaction\" table=\"NONELECTRONIC_TXN\">\n" +#~ " <id name=\"id\" type=\"long\" column=\"TXN_ID\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " ...\n" +#~ " <joined-subclass name=\"CashPayment\" table=\"CASH_PAYMENT\">\n" +#~ " <key column=\"PAYMENT_ID\"/>\n" +#~ " <property name=\"amount\" column=\"CASH_AMOUNT\"/>\n" +#~ " ...\n" +#~ " </joined-subclass>\n" +#~ " <joined-subclass name=\"ChequePayment\" table=\"CHEQUE_PAYMENT\">\n" +#~ " <key column=\"PAYMENT_ID\"/>\n" +#~ " <property name=\"amount\" column=\"CHEQUE_AMOUNT\"/>\n" +#~ " ...\n" +#~ " </joined-subclass>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"CreditCardPayment\" table=\"CREDIT_PAYMENT\">\n" +#~ " <id name=\"id\" type=\"long\" column=\"CREDIT_PAYMENT_ID\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <discriminator column=\"CREDIT_CARD\" type=\"string\"/>\n" +#~ " <property name=\"amount\" column=\"CREDIT_AMOUNT\"/>\n" +#~ " ...\n" +#~ " <subclass name=\"MasterCardPayment\" discriminator-value=\"MDC\"/" +#~ ">\n" +#~ " <subclass name=\"VisaPayment\" discriminator-value=\"VISA\"/>\n" +#~ "</class>\n" +#~ "\n" +#~ "<class name=\"NonelectronicTransaction\" table=\"NONELECTRONIC_TXN" +#~ "\">\n" +#~ " <id name=\"id\" type=\"long\" column=\"TXN_ID\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " ...\n" +#~ " <joined-subclass name=\"CashPayment\" table=\"CASH_PAYMENT\">\n" +#~ " <key column=\"PAYMENT_ID\"/>\n" +#~ " <property name=\"amount\" column=\"CASH_AMOUNT\"/>\n" +#~ " ...\n" +#~ " </joined-subclass>\n" +#~ " <joined-subclass name=\"ChequePayment\" table=\"CHEQUE_PAYMENT" +#~ "\">\n" +#~ " <key column=\"PAYMENT_ID\"/>\n" +#~ " <property name=\"amount\" column=\"CHEQUE_AMOUNT\"/>\n" +#~ " ...\n" +#~ " </joined-subclass>\n" +#~ "</class>" + +#~ msgid "Features of inheritance mappings" +#~ msgstr "Features von Vererbungsmappings" + +#~ msgid "Inheritance strategy" +#~ msgstr "Vererbungsstrategie" + +#~ msgid "Polymorphic one-to-one" +#~ msgstr "Polymorphes \"One-to-One\"" + +#~ msgid "Polymorphic one-to-many" +#~ msgstr "Polymorphes \"One-to-Many\"" + +#~ msgid "Polymorphic many-to-many" +#~ msgstr "Polymorphes \"Many-to-Many\"" + +#~ msgid "Polymorphic <literal>load()/get()</literal>" +#~ msgstr "Polymorphes <literal>load()/get()</literal>" + +#~ msgid "Polymorphic queries" +#~ msgstr "Polymorphe Anfragen" + +#~ msgid "Polymorphic joins" +#~ msgstr "Polymorphe Verknüpfungen " + +#~ msgid "<many-to-one>" +#~ msgstr "<Many-to-One>" + +#~ msgid "<one-to-one>" +#~ msgstr "<One-to-One>" + +#~ msgid "<one-to-many>" +#~ msgstr "<One-to-Many>" + +#~ msgid "<many-to-many>" +#~ msgstr "<Many-to-Many>" + +#~ msgid "s.get(Payment.class, id)" +#~ msgstr "s.get(Payment.class, id)" + +#~ msgid "from Payment p" +#~ msgstr "von Payment p" + +#~ msgid "supported" +#~ msgstr "unterstützt" + +#~ msgid "<entry>table per subclass</entry>" +#~ msgstr "<entry>Tabelle-pro-Subklasse</entry>" + +#~ msgid "<any>" +#~ msgstr "<any>" + +#~ msgid "not supported" +#~ msgstr "nicht unterstützt" + +#~ msgid "<many-to-any>" +#~ msgstr "<many-to-any>" Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/performance.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/performance.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/performance.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,2851 @@ +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# Language /mnt/hgfs/base/Hibernate/Reference translations for PACKAGE package. +# Copyright (C) 2006, 2007 Free Software Foundation, Inc. +# Automatically generated, 2006. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# +msgid "" +msgstr "" +"Project-Id-Version: Collection_Mapping\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2009-12-03T00:15:26\n" +"PO-Revision-Date: 2007-02-26 10:27+1000\n" +"Last-Translator: \n" +"Language-Team: <de(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.9.1\n" + +#. Tag: title +#, no-c-format +msgid "Improving performance" +msgstr "Verbesserung der Performance" + +#. Tag: title +#, no-c-format +msgid "Fetching strategies" +msgstr "Abrufstrategien" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate uses a <emphasis>fetching strategy</emphasis> to retrieve " +"associated objects if the application needs to navigate the association. " +"Fetch strategies can be declared in the O/R mapping metadata, or over-ridden " +"by a particular HQL or <literal>Criteria</literal> query." +msgstr "" +"Eine <emphasis>Abrufstrategie</emphasis> (sog. \"Fetching Strategy\") ist " +"die Abrufstrategie, die Hibernate beim Abruf assoziierter Objekte verwendet, " +"wenn die Anwendung die Assoziation navigieren muss. Abrufstrategien können " +"in den O/R Mapping-Metadaten deklariert werden oder durch eine bestimmte HQL " +"oder <literal>Criteria</literal>-Anfrage außer Kraft gesetzt werden." + +#. Tag: para +#, no-c-format +msgid "Hibernate3 defines the following fetching strategies:" +msgstr "Hibernate3 definiert die folgenden Abrufstrategien:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis>Join fetching</emphasis>: Hibernate retrieves the associated " +"instance or collection in the same <literal>SELECT</literal>, using an " +"<literal>OUTER JOIN</literal>." +msgstr "" +"<emphasis>\"Join Fetching\"</emphasis> - Hibernate ruft unter Verwendung von " +"<literal>OUTER JOIN</literal> die zugehörige Instanz oder Collection im " +"selben <literal>SELECT</literal> auf." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis>Select fetching</emphasis>: a second <literal>SELECT</literal> is " +"used to retrieve the associated entity or collection. Unless you explicitly " +"disable lazy fetching by specifying <literal>lazy=\"false\"</literal>, this " +"second select will only be executed when you access the association." +msgstr "" +"<emphasis>\"Select Fetching\"</emphasis> - ein zweites <literal>SELECT</" +"literal> wird für den Abruf der assoziierten Entity oder Collection " +"verwendet. Falls Sie nicht explizit das \"lazy Fetching\" (d.h. das " +"Nachladen assoziierter Objekte bei Bedarf) durch Spezifizierung von " +"<literal>lazy=\"false\"</literal> deaktivieren, wird dieses zweite \"Select" +"\" nur ausgeführt, wenn Sie tatsächlich auf die Assoziation zugreifen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis>Subselect fetching</emphasis>: a second <literal>SELECT</literal> " +"is used to retrieve the associated collections for all entities retrieved in " +"a previous query or fetch. Unless you explicitly disable lazy fetching by " +"specifying <literal>lazy=\"false\"</literal>, this second select will only " +"be executed when you access the association." +msgstr "" +"<emphasis>\"Subselect Fetching\"</emphasis> - ein zweites <literal>SELECT</" +"literal> wird verwendet, um die assoziierten Collections für alle in einer " +"vorausgegangenen Anfrage oder Abruf erhaltenen Entities abzurufen. Falls Sie " +"\"lazy Fetching\" nicht durch <literal>lazy=\"false\"</literal> explizit " +"deaktivieren, wird dieses zweite \"Select\" nur ausgeführt, wenn Sie " +"tatsächlich auf die Assoziation zugreifen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis>Batch fetching</emphasis>: an optimization strategy for select " +"fetching. Hibernate retrieves a batch of entity instances or collections in " +"a single <literal>SELECT</literal> by specifying a list of primary or " +"foreign keys." +msgstr "" +"<emphasis>Stapelabruf</emphasis> (sog. \"Batch Fetching\") - eine " +"Optimierungsstrategie für die Abrufauswahl - Hibernate ruft einen Stapel von " +"Entity-Instanzen oder Collections in einem einzelnen <literal>SELECT</" +"literal> ab, indem es eine Liste von Primärschlüsseln oder Fremdschlüsseln " +"bestimmt." + +#. Tag: para +#, no-c-format +msgid "Hibernate also distinguishes between:" +msgstr "Hibernate unterscheidet außerdem zwischen:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis>Immediate fetching</emphasis>: an association, collection or " +"attribute is fetched immediately when the owner is loaded." +msgstr "" +"<emphasis>\"Immediate Fetching\"</emphasis> (d.h. sofortiger Abruf) - eine " +"Assoziation, Collection oder Attribut werden beim Laden des Eigentümers " +"sofort abgerufen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis>Lazy collection fetching</emphasis>: a collection is fetched when " +"the application invokes an operation upon that collection. This is the " +"default for collections." +msgstr "" +"<emphasis>\"Lazy Collection Fetching\"</emphasis> - eine Collection wird " +"abgerufen, wenn die Anwendung einen Vorgang an dieser Collection aufruft. " +"(Das ist die Standardeinstellung für Collections)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis>\"Extra-lazy\" collection fetching</emphasis>: individual elements " +"of the collection are accessed from the database as needed. Hibernate tries " +"not to fetch the whole collection into memory unless absolutely needed. It " +"is suitable for large collections." +msgstr "" +"<emphasis>\"Extra-lazy Collection Fetching\"</emphasis> - auf einzelne " +"Elemente der Collection wird je nach Bedarf in der Datenbank zugegriffen. " +"Hibernate versucht, nicht die gesamte Collection in den Speicher aufzurufen, " +"außer es ist unbedingt nötig (besonders geeignet für sehr große Collections)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis>Proxy fetching</emphasis>: a single-valued association is fetched " +"when a method other than the identifier getter is invoked upon the " +"associated object." +msgstr "" +"<emphasis>\"Proxy Fetching\"</emphasis> (d.h. Proxy-Abruf) - eine einwertige " +"Assoziation wird abgerufen, wenn eine andere Methode als Bezeichner-\"Getter" +"\" am zugehörigen Objekt aufgerufen wird." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis>\"No-proxy\" fetching</emphasis>: a single-valued association is " +"fetched when the instance variable is accessed. Compared to proxy fetching, " +"this approach is less lazy; the association is fetched even when only the " +"identifier is accessed. It is also more transparent, since no proxy is " +"visible to the application. This approach requires buildtime bytecode " +"instrumentation and is rarely necessary." +msgstr "" +"<emphasis>\"No-Proxy-Fetching\"</emphasis> - eine einwertige Assoziation " +"wird abgerufen, wenn auf die Instanzvariable zugegriffen wird. Im Vergleich " +"zu Proxy-Fetching, ist diese Herangehensweise weniger \"lazy\" (die " +"Assoziation wird sogar abgerufen wenn nur auf den Bezeichner zugegriffen " +"wird), jedoch transparenter, da für die Anwendung kein Proxy sichtbar ist. " +"Diese Vorgehensweise erfordert Buildtime Bytecode Instrumentierung und wird " +"selten benötigt." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis>Lazy attribute fetching</emphasis>: an attribute or single valued " +"association is fetched when the instance variable is accessed. This approach " +"requires buildtime bytecode instrumentation and is rarely necessary." +msgstr "" +"<emphasis>\"Lazy Attribute Fetching</emphasis> - ein Attribut oder eine " +"einwertige Assoziation werden abgerufen, wenn auf die Instanzvariable " +"zugegriffen wird. Diese Vorgehensweise erfordert Buildtime Bytecode " +"Instrumentierung und wird selten benötigt." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"We have two orthogonal notions here: <emphasis>when</emphasis> is the " +"association fetched and <emphasis>how</emphasis> is it fetched. It is " +"important that you do not confuse them. We use <literal>fetch</literal> to " +"tune performance. We can use <literal>lazy</literal> to define a contract " +"for what data is always available in any detached instance of a particular " +"class." +msgstr "" +"Es gibt hier zwei orthogonale Begriffe: <emphasis>Wann</emphasis> die " +"Assoziation abgerufen wird und <emphasis>wie</emphasis> sie abgerufen wird " +"(welche SQL verwendet wird). Verwechseln Sie diese nicht! Wir verwenden " +"<literal>fetch</literal>, um die Performance abzustimmen. Wir können " +"<literal>lazy</literal> verwenden, um ein Interface (sog. \"contract\") " +"darüber zu definieren, welche Daten in sämtlichen abgesetzten Instanzen " +"einer bestimmten Klasse stets verfügbar sind." + +#. Tag: title +#, no-c-format +msgid "Working with lazy associations" +msgstr "Der Umgang mit \"lazy\"-Assoziationen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"By default, Hibernate3 uses lazy select fetching for collections and lazy " +"proxy fetching for single-valued associations. These defaults make sense for " +"most associations in the majority of applications." +msgstr "" +"In der Standardeinstellung verwendet Hibernate3 \"lazy\" Auswahlabruf für " +"Collections und \"lazy\" Proxy-Abruf für einwertige Assoziationen. Diese " +"Standardeinstellung ist für nahezu alle Assoziationen in den meisten " +"Anwendungen sinnvoll." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If you set <literal>hibernate.default_batch_fetch_size</literal>, Hibernate " +"will use the batch fetch optimization for lazy fetching. This optimization " +"can also be enabled at a more granular level." +msgstr "" +"<emphasis>Hinweis:</emphasis> Wenn Sie <literal>hibernate." +"default_batch_fetch_size</literal> setzen, so verwendet Hibernate die " +"Stapelabrufoptimierung für \"lazy\" Fetching (diese Optimierung kann auch " +"auf feinkörnigerer Ebene aktiviert werden)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Please be aware that access to a lazy association outside of the context of " +"an open Hibernate session will result in an exception. For example:" +msgstr "" +"Jedoch stellt sich beim \"lazy\" Fetching ein Problem, dessen Sie sich " +"bewusst sein sollten: Der Zugriff auf eine \"lazy\" Assoziation außerhalb " +"des Kontexts einer geöffneten Hibernate Session führt zu einer " +"Ausnahmemeldung. Zum Beispiel:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Since the permissions collection was not initialized when the " +"<literal>Session</literal> was closed, the collection will not be able to " +"load its state. <emphasis>Hibernate does not support lazy initialization for " +"detached objects</emphasis>. This can be fixed by moving the code that reads " +"from the collection to just before the transaction is committed." +msgstr "" +"Da die \"Permissions\"-Collection nicht initialisiert war als die " +"<literal>Session</literal> geschlossen wurde, wird die Collection den Status " +"nicht laden können. <emphasis>Hibernate unterstützt keine \"lazy\" " +"Initialisierung für abgesetzte Objekte</emphasis>. Die Lösung besteht darin, " +"den Code, der die Collection liest, erst unmittelbar ehe die Transaktion " +"festgeschrieben wird, zu bewegen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Alternatively, you can use a non-lazy collection or association, by " +"specifying <literal>lazy=\"false\"</literal> for the association mapping. " +"However, it is intended that lazy initialization be used for almost all " +"collections and associations. If you define too many non-lazy associations " +"in your object model, Hibernate will fetch the entire database into memory " +"in every transaction." +msgstr "" +"Alternativ könnten Sie eine nicht-\"lazy\" Collection oder Assoziation " +"verwenden, indem Sie <literal>lazy=\"false\"</literal> für das " +"Assoziationsmapping festlegen. Es ist jedoch vorgesehen, dass \"lazy\" " +"Initialisierung für fast alle Collections und Assoziationen verwendet wird. " +"Wenn Sie in Ihrem Objektmodell zu viele nicht-\"lazy\" Assoziationen " +"definieren, wird Hibernate am Ende für jede Transaktion die gesamte " +"Datenbank in den Speicher abrufen müssen!" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"On the other hand, you can use join fetching, which is non-lazy by nature, " +"instead of select fetching in a particular transaction. We will now explain " +"how to customize the fetching strategy. In Hibernate3, the mechanisms for " +"choosing a fetch strategy are identical for single-valued associations and " +"collections." +msgstr "" +"Andererseits wollen wir oft \"Join\"-Fetching (das von Natur aus nicht \"lazy" +"\" ist) anstelle des Auswahlabrufs (sog. \"Select-Fetching\") in einer " +"bestimmten Transaktion verwenden. Wir wollen nun einen Blick darauf werfen, " +"wie eine Abrufstrategie individuell angepasst werden kann. In Hibernate3 ist " +"der Mechanismus zur Auswahl einer Abrufstrategie für einwertige " +"Assoziationen und Collections identisch." + +#. Tag: title +#, no-c-format +msgid "Tuning fetch strategies" +msgstr "Abstimmung von Abrufstrategien" + +#. Tag: para +#, no-c-format +msgid "" +"Select fetching (the default) is extremely vulnerable to N+1 selects " +"problems, so we might want to enable join fetching in the mapping document:" +msgstr "" +"Der Auswahlabruf - \"Select Fetching\" (Standard) ist extrem anfällig für N" +"+1 Auswahlprobleme, weswegen sich die Aktivierung von \"Join-Fetching\" im " +"Mapping-Dokument empfiehlt:" + +#. Tag: para +#, no-c-format +msgid "" +"The <literal>fetch</literal> strategy defined in the mapping document " +"affects:" +msgstr "" +"Die im Mapping-Dokument definierte <literal>fetch</literal>-Strategie hat " +"Auswirkungen auf:" + +#. Tag: para +#, no-c-format +msgid "retrieval via <literal>get()</literal> or <literal>load()</literal>" +msgstr "Abruf mittels <literal>get()</literal> oder <literal>load()</literal>" + +#. Tag: para +#, no-c-format +msgid "retrieval that happens implicitly when an association is navigated" +msgstr "einem impliziten Abruf, der beim Navigieren der Assoziation erfolgt" + +#. Tag: para +#, no-c-format +msgid "<literal>Criteria</literal> queries" +msgstr "<literal>Criteria</literal>-Anfragen" + +#. Tag: para +#, no-c-format +msgid "HQL queries if <literal>subselect</literal> fetching is used" +msgstr "HQL-Anfragen, wenn <literal>subselect</literal>-Abruf verwendet wird" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Irrespective of the fetching strategy you use, the defined non-lazy graph is " +"guaranteed to be loaded into memory. This might, however, result in several " +"immediate selects being used to execute a particular HQL query." +msgstr "" +"Unabhängig davon, welche Abrufstrategie Sie verwenden wird das definierte " +"nicht-\"lazy\" Diagramm garantiert im Speicher geladen. Bitte beachten Sie, " +"dass dies zur Verwendung von mehreren unmittelbaren \"Selects\" bei der " +"Ausführung einer bestimmten HQL-Anfrage führen kann." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Usually, the mapping document is not used to customize fetching. Instead, we " +"keep the default behavior, and override it for a particular transaction, " +"using <literal>left join fetch</literal> in HQL. This tells Hibernate to " +"fetch the association eagerly in the first select, using an outer join. In " +"the <literal>Criteria</literal> query API, you would use " +"<literal>setFetchMode(FetchMode.JOIN)</literal>." +msgstr "" +"Normalerweise wird das Mapping-Dokument nicht für die Anpassung des Abrufs " +"verwendet. Stattdessen behalten wir das Standardverhalten und setzen es " +"mittels <literal>left join fetch</literal> in HQL für eine bestimmte " +"Transaktion außer Kraft. Dadurch setzt Hibernate bei der Assoziation im " +"ersten \"Select\" unter Verwendung eines \"outer Join\" \"eager Fetching\" " +"ein. Im <literal>Criteria</literal>-Anfragen API, würden Sie " +"<literal>setFetchMode(FetchMode.JOIN)</literal> benutzen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If you want to change the fetching strategy used by <literal>get()</literal> " +"or <literal>load()</literal>, you can use a <literal>Criteria</literal> " +"query. For example:" +msgstr "" +"Falls Sie die verwendete Abrufstrategie irgendwann ändern möchten, so können " +"Sie dies durch <literal>get()</literal> oder <literal>load()</literal> tun, " +"verwenden Sie einfach eine <literal>Criteria</literal>-Anfrage, zum Beispiel:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This is Hibernate's equivalent of what some ORM solutions call a \"fetch plan" +"\"." +msgstr "" +"(Das ist Hibernates Äquivalent zu dem, was einige ORM-Lösungen als Abrufplan " +"oder \"Fetch Plan\" bezeichnen)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A completely different approach to problems with N+1 selects is to use the " +"second-level cache." +msgstr "" +"Eine ganz andere Art Probleme mit N+1 \"Selects\" zu vermeiden, ist die " +"Verwendung des Cachespeichers der zweiten Ebene." + +#. Tag: title +#, no-c-format +msgid "Single-ended association proxies" +msgstr "Einendige Assoziationsproxies" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Lazy fetching for collections is implemented using Hibernate's own " +"implementation of persistent collections. However, a different mechanism is " +"needed for lazy behavior in single-ended associations. The target entity of " +"the association must be proxied. Hibernate implements lazy initializing " +"proxies for persistent objects using runtime bytecode enhancement which is " +"accessed via the CGLIB library." +msgstr "" +"\"Lazy-Fetching\" für Collections wird unter Verwendung von Hibernates " +"eigener Implementierung von persistenten Klassen implementiert. Für \"lazy-" +"Fetching\" in einendigen Assoziationen wird jedoch ein anderer Mechanismus " +"benötigt. Die Ziel-Entity der Assoziation muss geproxied werden. Hibernate " +"implementiert \"lazy\" Initialisierungsproxies für persistente Objekte unter " +"Verwendung von Runtime Bytecode-Steigerung (durch die hervorragende CGLIB-" +"Bibliothek)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"At startup, Hibernate3 generates proxies by default for all persistent " +"classes and uses them to enable lazy fetching of <literal>many-to-one</" +"literal> and <literal>one-to-one</literal> associations." +msgstr "" +"Im Standard generiert Hibernate3 Proxies (beim Startup) für alle " +"persistenten Klassen und verwendet diese, um das \"lazy-Fetching\" von " +"<literal>many-to-one</literal> und <literal>one-to-one</literal>-" +"Assoziationen zu aktivieren." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The mapping file may declare an interface to use as the proxy interface for " +"that class, with the <literal>proxy</literal> attribute. By default, " +"Hibernate uses a subclass of the class. <emphasis>The proxied class must " +"implement a default constructor with at least package visibility. This " +"constructor is recommended for all persistent classes</emphasis>." +msgstr "" +"Die Mapping-Datei kann mit dem <literal>proxy</literal>-Attribut ein als " +"Proxy-Interface zu verwendendes Interface deklarieren. In der " +"Standardeinstellung verwendet Hibernate eine Subklasse der Klasse. " +"<emphasis>Beachten Sie, das die geproxiete Klasse einen Standard-Konstruktor " +"mit mindestens Paket-Sichtbarkeit implementieren muss. Wir empfehlen diesen " +"Konstruktor für alle persistenten Klassen!</emphasis>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"There are potential problems to note when extending this approach to " +"polymorphic classes.For example:" +msgstr "" +"Es gibt einige Fallstricke, derer man sich bewusst sein sollte, wenn man " +"diese Vorgehensweise zum Beispiel auf polymorphe Klassen ausweitet." + +#. Tag: para +#, no-c-format +msgid "" +"Firstly, instances of <literal>Cat</literal> will never be castable to " +"<literal>DomesticCat</literal>, even if the underlying instance is an " +"instance of <literal>DomesticCat</literal>:" +msgstr "" +"Zunächst einmal werden Instanzen von <literal>Cat</literal> hinsichtlich " +"ihres Datentyps niemals in <literal>DomesticCat</literal> konvertierbar " +"sein, selbst wenn die zu Grunde liegende Instanz eine Instanz von " +"<literal>DomesticCat</literal> ist:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "Secondly, it is possible to break proxy <literal>==</literal>:" +msgstr "Zweitens ist es möglich, Proxy <literal>==</literal> zu brechen." + +#. Tag: para +#, no-c-format +msgid "" +"However, the situation is not quite as bad as it looks. Even though we now " +"have two references to different proxy objects, the underlying instance will " +"still be the same object:" +msgstr "" +"Allerdings ist die Situation nicht so schlimm wie sie aussieht. Obwohl wir " +"jetzt zwei Verweise auf verschiedene Proxy-Objekte besitzen, so bleibt die " +"zu Grunde liegende Instanz nach wie vor dasselbe Objekt:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Third, you cannot use a CGLIB proxy for a <literal>final</literal> class or " +"a class with any <literal>final</literal> methods." +msgstr "" +"Drittens können Sie kein CGLIB-Proxy für eine <literal>final</literal>-" +"Klasse oder eine Klasse mit einer <literal>final</literal>-Methode verwenden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Finally, if your persistent object acquires any resources upon instantiation " +"(e.g. in initializers or default constructor), then those resources will " +"also be acquired by the proxy. The proxy class is an actual subclass of the " +"persistent class." +msgstr "" +"Wenn Ihr persistentes Objekt bei der Instantiierung Ressourcen erhält (z.B. " +"Initialisierungsprogramme oder den Standard-Konstruktor), so erhält auch das " +"Proxy diese Ressourcen. Die Proxy-Klasse ist eine Subklasse der persistenten " +"Klasse." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"These problems are all due to fundamental limitations in Java's single " +"inheritance model. To avoid these problems your persistent classes must each " +"implement an interface that declares its business methods. You should " +"specify these interfaces in the mapping file where <literal>CatImpl</" +"literal> implements the interface <literal>Cat</literal> and " +"<literal>DomesticCatImpl</literal> implements the interface " +"<literal>DomesticCat</literal>. For example:" +msgstr "" +"Diese Probleme wurzeln in fundamentalen Einschränkungen des " +"Einzelvererbungsmodells in Java. Falls Sie diese Probleme umgehen möchten, " +"muss jede Ihrer persistenten Klassen ein Interface implementieren, das seine " +"Business-Methoden deklariert. Diese Interfaces sollten Sie z.B. in der " +"Mapping-Datei spezifizieren." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Then proxies for instances of <literal>Cat</literal> and " +"<literal>DomesticCat</literal> can be returned by <literal>load()</literal> " +"or <literal>iterate()</literal>." +msgstr "" +"Zunächst einmal werden Instanzen von <literal>Cat</literal> hinsichtlich " +"ihres Datentyps niemals in <literal>DomesticCat</literal> konvertierbar " +"sein, selbst wenn die zu Grunde liegende Instanz eine Instanz von " +"<literal>DomesticCat</literal> ist:" + +#. Tag: title +#, no-c-format +msgid "Note" +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>list()</literal> does not usually return proxies." +msgstr "<literal>full join</literal> (in der Regel nicht sehr nützlich)" + +#. Tag: para +#, no-c-format +msgid "" +"Relationships are also lazily initialized. This means you must declare any " +"properties to be of type <literal>Cat</literal>, not <literal>CatImpl</" +"literal>." +msgstr "" +"Beziehungen werden ebenfalls \"lazy\" initialisiert. Das bedeutet, dass Sie " +"sämtliche Properties als Typ <literal>Cat</literal>, nicht <literal>CatImpl</" +"literal> deklarieren müssen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Certain operations do <emphasis>not</emphasis> require proxy initialization:" +msgstr "" +"Bestimmte Vorgänge benötigen <emphasis>keine</emphasis> Proxy-Initialisierung" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>equals()</literal>: if the persistent class does not override " +"<literal>equals()</literal>" +msgstr "" +"<literal>equals()</literal>, falls die persistente Klasse <literal>equals()</" +"literal> nicht außer Kraft setzt" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>hashCode()</literal>: if the persistent class does not override " +"<literal>hashCode()</literal>" +msgstr "" +"<literal>hashCode()</literal>, falls die persistente Klasse <literal>hashCode" +"()</literal> nicht außer Kraft setzt" + +#. Tag: para +#, no-c-format +msgid "The identifier getter method" +msgstr "Die \"Getter\"-Methode des Bezeichners" + +#. Tag: para +#, no-c-format +msgid "" +"Hibernate will detect persistent classes that override <literal>equals()</" +"literal> or <literal>hashCode()</literal>." +msgstr "" +"Hibernate erkennt persistente Klassen, die <literal>equals()</literal> oder " +"<literal>hashCode()</literal> außer Kraft setzen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"By choosing <literal>lazy=\"no-proxy\"</literal> instead of the default " +"<literal>lazy=\"proxy\"</literal>, you can avoid problems associated with " +"typecasting. However, buildtime bytecode instrumentation is required, and " +"all operations will result in immediate proxy initialization." +msgstr "" +"Durch Auswahl von <literal>lazy=\"no-proxy\"</literal> anstelle des " +"standardmäßigen <literal>lazy=\"proxy\"</literal>, lassen sich mit der Typ-" +"Umwandlung zusammenhängende Probleme vermeiden. Es wird jedoch \"Buildtime " +"Bytecode\"-Instrumentierung benötigt und sämtliche Vorgänge führen zu einer " +"unmittelbaren Proxy-Initialisierung." + +#. Tag: title +#, no-c-format +msgid "Initializing collections and proxies" +msgstr "Initialisierung von Collections und Proxies" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A <literal>LazyInitializationException</literal> will be thrown by Hibernate " +"if an uninitialized collection or proxy is accessed outside of the scope of " +"the <literal>Session</literal>, i.e., when the entity owning the collection " +"or having the reference to the proxy is in the detached state." +msgstr "" +"Eine <literal>LazyInitializationException</literal>-Ausnahme wird durch " +"Hibernate gemeldet, wenn auf eine nicht initialisierte Collection oder Proxy " +"außerhalb des Gültigkeitsbereichs der <literal>Session</literal> zugegriffen " +"wird, d.h. wenn die Entity, die die Collection besitzt oder einen Verweis " +"auf das Proxy hat, sich in abgesetztem Status befindet." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Sometimes a proxy or collection needs to be initialized before closing the " +"<literal>Session</literal>. You can force initialization by calling " +"<literal>cat.getSex()</literal> or <literal>cat.getKittens().size()</" +"literal>, for example. However, this can be confusing to readers of the code " +"and it is not convenient for generic code." +msgstr "" +"In manchen Fällen muss sichergestellt werden, dass ein Proxy oder eine " +"Collection initialisiert ist, ehe die <literal>Session</literal> geschlossen " +"wird. Natürlich kann die Initialisierung durch Aufruf von <literal>cat.getSex" +"()</literal> oder <literal>cat.getKittens().size()</literal> immer auch " +"erzwungen werden. Allerdings ist das recht verwirrend für Leser des Codes " +"und nicht praktisch für generischen Code." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The static methods <literal>Hibernate.initialize()</literal> and " +"<literal>Hibernate.isInitialized()</literal>, provide the application with a " +"convenient way of working with lazily initialized collections or proxies. " +"<literal>Hibernate.initialize(cat)</literal> will force the initialization " +"of a proxy, <literal>cat</literal>, as long as its <literal>Session</" +"literal> is still open. <literal>Hibernate.initialize( cat.getKittens() )</" +"literal> has a similar effect for the collection of kittens." +msgstr "" +"Die statischen Methoden <literal>Hibernate.initialize()</literal> und " +"<literal>Hibernate.isInitialized()</literal> liefern der Anwendung eine " +"praktische Art mit nach \"lazy\" Art initialisierten Collections oder " +"Proxies umzugehen. <literal>Hibernate.initialize(cat)</literal> erzwingt die " +"Initialisierung einesProxy, <literal>cat</literal> solange dessen " +"<literal>Session</literal> noch geöffnet ist. <literal>Hibernate.initialize" +"( cat.getKittens() )</literal> hat eine ähnliche Wirkung auf die Collection " +"von \"kittens\"." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Another option is to keep the <literal>Session</literal> open until all " +"required collections and proxies have been loaded. In some application " +"architectures, particularly where the code that accesses data using " +"Hibernate, and the code that uses it are in different application layers or " +"different physical processes, it can be a problem to ensure that the " +"<literal>Session</literal> is open when a collection is initialized. There " +"are two basic ways to deal with this issue:" +msgstr "" +"Eine weitere Möglichkeit ist es, die <literal>Session</literal> geöffnet zu " +"halten, bis alle benötigten Collections und Proxies geladen sind. In einigen " +"Anwendungsarchitekturen - insbesondere wenn der Code unter Verwendung von " +"Hibernate auf Daten zugreift und der diese benutzende Code sich in " +"unterschiedlichen Anwendungsschichten oder verschiedenen physikalischen " +"Prozessen befindet, kann es problematisch sein sicherzustellen, dass die " +"<literal>Session</literal> bei der Initialisierung der Collection geöffnet " +"ist. Es gibt zwei einfache Wege, damit umzugehen:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"In a web-based application, a servlet filter can be used to close the " +"<literal>Session</literal> only at the end of a user request, once the " +"rendering of the view is complete (the <emphasis>Open Session in View</" +"emphasis> pattern). Of course, this places heavy demands on the correctness " +"of the exception handling of your application infrastructure. It is vitally " +"important that the <literal>Session</literal> is closed and the transaction " +"ended before returning to the user, even when an exception occurs during " +"rendering of the view. See the Hibernate Wiki for examples of this \"Open " +"Session in View\" pattern." +msgstr "" +"In einer Web-basierten Anwendung kann die <literal>Session</literal> nur am " +"Ende der Benutzeranfrage und nachdem das Rendering der Ansicht (das " +"<emphasis>Offene Session in Ansicht</emphasis>-Modell) abgeschlossen ist, " +"mittels eines Servlet-Filters geschlossen werden. Natürlich stellt dies " +"große Anforderungen auf den ordnungsgemäßen Umgang mit Ausnahmen Ihrer " +"Anwendungsinfrastruktur. Es ist von maßgeblicher Bedeutung, dass die " +"<literal>Session</literal> geschlossen und die Transaktion beendet ist, ehe " +"zum Benutzer zurückgekehrt wird, selbst wenn während des Renderings der " +"Ansicht eine Ausnahme gemeldet wird. Beispiele für dieses \"Offene Session " +"in Ansicht\"-Modell finden Sie im Hibernate Wiki." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"In an application with a separate business tier, the business logic must " +"\"prepare\" all collections that the web tier needs before returning. This " +"means that the business tier should load all the data and return all the " +"data already initialized to the presentation/web tier that is required for a " +"particular use case. Usually, the application calls <literal>Hibernate." +"initialize()</literal> for each collection that will be needed in the web " +"tier (this call must occur before the session is closed) or retrieves the " +"collection eagerly using a Hibernate query with a <literal>FETCH</literal> " +"clause or a <literal>FetchMode.JOIN</literal> in <literal>Criteria</" +"literal>. This is usually easier if you adopt the <emphasis>Command</" +"emphasis> pattern instead of a <emphasis>Session Facade</emphasis>." +msgstr "" +"In einer Anwendung mit separatem Business-\"Tier\" muss die Business-Logik " +"alle Collections auf deren Verwendung durch den Web-\"Tier\" vor der " +"Rückkehr \"vorbereiten\". Das bedeutet, dass der Business-Tier sämtliche " +"Daten laden und alle bereits initialisierten Daten an den Präsentations-/Web-" +"Tier, der in einem bestimmten Fall benötigt wird, wiedergeben muss. In der " +"Regel erfolgt durch die Anwendung der Aufruf <literal>Hibernate.initialize()" +"</literal> für jede Collection, die im Web-Tier benötigt werden wird (dieser " +"Aufruf muss erfolgen, ehe die Session geschlossen wird) oder die Collection " +"wird nach \"eager\"-Art mittels einer Hibernate Anfrage mit einer " +"<literal>FETCH</literal>-Klausel oder <literal>FetchMode.JOIN</literal> in " +"<literal>Criteria</literal> abgerufen. Dies ist in der Regel einfacher, wenn " +"Sie das <emphasis>Command</emphasis>-Modell anstelle einer <emphasis>Session " +"Fassade</emphasis> einsetzen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can also attach a previously loaded object to a new <literal>Session</" +"literal> with <literal>merge()</literal> or <literal>lock()</literal> before " +"accessing uninitialized collections or other proxies. Hibernate does not, " +"and certainly <emphasis>should</emphasis> not, do this automatically since " +"it would introduce impromptu transaction semantics." +msgstr "" +"Sie können auch zuvor geladene Objekte mittels <literal>merge()</literal> or " +"<literal>lock()</literal> an eine neue <literal>Session</literal> anhängen, " +"ehe Sie auf nicht initialisierte Collections (oder andere Proxies) " +"zugreifen. Hibernate tut dies nicht von selbst und <emphasis>sollte</" +"emphasis> es auch nicht automatisch tun, da es dadurch zu Ad-hoc-" +"Transaktionssemantik käme!" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Sometimes you do not want to initialize a large collection, but still need " +"some information about it, like its size, for example, or a subset of the " +"data." +msgstr "" +"Manchmal möchten Sie eine große Collection nicht initialisieren, aber " +"benötigen dennoch Informationen (etwa deren Größe) oder einen Untersatz der " +"Daten." + +#. Tag: para +#, no-c-format +msgid "" +"You can use a collection filter to get the size of a collection without " +"initializing it:" +msgstr "" +"Sie können einen Collection-Filter verwenden, um die Größe der Collection zu " +"ermitteln ohne diese zu initialisieren:" + +#. Tag: para +#, no-c-format +msgid "" +"The <literal>createFilter()</literal> method is also used to efficiently " +"retrieve subsets of a collection without needing to initialize the whole " +"collection:" +msgstr "" +"Die <literal>createFilter()</literal>-Methode wird außerdem benutzt, um " +"effizient Untersätze einer Collection abzurufen, ohne die gesamte Collection " +"zu initialisieren:" + +#. Tag: title +#, no-c-format +msgid "Using batch fetching" +msgstr "Die Verwendung von Stapelabruf (\"Batch-Fetching\")" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Using batch fetching, Hibernate can load several uninitialized proxies if " +"one proxy is accessed. Batch fetching is an optimization of the lazy select " +"fetching strategy. There are two ways you can configure batch fetching: on " +"the class level and the collection level." +msgstr "" +"Hibernate kann den Stapelabruf effizient nutzen, d.h. Hibernate kann mehrere " +"nicht initialisierte Proxies laden, wenn auf einen Proxy zugegriffen wird " +"(oder Collections). Beim Stapelabruf handelt es sich um eine Optimierung der " +"\"lazy\" Auswahlabruf-Strategie (\"Select-Fetching\"). Es gibt zwei Arten, " +"auf die sich der Stapelabruf abstimmen lässt: Auf der Klassen- sowie auf der " +"Collection-Ebene." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Batch fetching for classes/entities is easier to understand. Consider the " +"following example: at runtime you have 25 <literal>Cat</literal> instances " +"loaded in a <literal>Session</literal>, and each <literal>Cat</literal> has " +"a reference to its <literal>owner</literal>, a <literal>Person</literal>. " +"The <literal>Person</literal> class is mapped with a proxy, <literal>lazy=" +"\"true\"</literal>. If you now iterate through all cats and call " +"<literal>getOwner()</literal> on each, Hibernate will, by default, execute " +"25 <literal>SELECT</literal> statements to retrieve the proxied owners. You " +"can tune this behavior by specifying a <literal>batch-size</literal> in the " +"mapping of <literal>Person</literal>:" +msgstr "" +"Der Stapelabruf für Klassen/Entities ist leichter zu verstehen. Stellen Sie " +"sich vor, Sie hätten zur Runtime folgende Situation: Sie haben 25 " +"<literal>Cat</literal>-Instanzen in einer <literal>Session</literal> " +"geladen, jede <literal>Cat</literal> besitzt eine Referenz zu ihrem " +"<literal>owner</literal>, einer <literal>Person</literal>. Die " +"<literal>Person</literal>-Klasse ist mit einem Proxy <literal>lazy=\"true\"</" +"literal> gemappt. Falls Sie nun über alle \"Cats\" hinweg iterieren und für " +"jede <literal>getOwner()</literal> aufrufen, so wird Hibernate in der " +"Standardeinstellung 25 <literal>SELECT</literal>-Anweisungen ausführen, um " +"die geproxieten Besitzer zu erhalten. Sie können dieses Verhalten durch " +"Bestimmung eines <literal>batch-size</literal> im Mapping von " +"<literal>Person</literal> festlegen:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate will now execute only three queries: the pattern is 10, 10, 5." +msgstr "" +"Hibernate führt nun nur drei Anfragen aus, das Muster lautet 10, 10, 5." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can also enable batch fetching of collections. For example, if each " +"<literal>Person</literal> has a lazy collection of <literal>Cat</literal>s, " +"and 10 persons are currently loaded in the <literal>Session</literal>, " +"iterating through all persons will generate 10 <literal>SELECT</literal>s, " +"one for every call to <literal>getCats()</literal>. If you enable batch " +"fetching for the <literal>cats</literal> collection in the mapping of " +"<literal>Person</literal>, Hibernate can pre-fetch collections:" +msgstr "" +"Sie können auch den Stapelabruf für Collections aktivieren. Wenn zum " +"Beispiel jede <literal>Person</literal> eine \"lazy\" Collection von " +"<literal>Cat</literal>s besitzt und zum aktuellen Zeitpunkt 10 Personen in " +"der <literal>Sesssion</literal> geladen sind, so wird die Iterierung über " +"alle Personen 10 <literal>SELECT</literal>s generieren, eines für jeden " +"Aufruf von <literal>getCats()</literal>. Falls Sie den Stapelabruf für die " +"<literal>cats</literal>-Collection im Mapping von <literal>Person</literal> " +"aktivieren, kann Hibernate Collections vorab abrufen:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"With a <literal>batch-size</literal> of 3, Hibernate will load 3, 3, 3, 1 " +"collections in four <literal>SELECT</literal>s. Again, the value of the " +"attribute depends on the expected number of uninitialized collections in a " +"particular <literal>Session</literal>." +msgstr "" +"Bei einem <literal>batch-size</literal> von 8, lädt Hibernate 3, 3, 3, 1 " +"Collections in vier <literal>SELECT</literal>s. Auch hier hängt der Wert des " +"Attributs von der zu erwartenden Anzahl nicht initialisierter Collections in " +"einer bestimmten <literal>Session</literal> ab." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Batch fetching of collections is particularly useful if you have a nested " +"tree of items, i.e. the typical bill-of-materials pattern. However, a " +"<emphasis>nested set</emphasis> or a <emphasis>materialized path</emphasis> " +"might be a better option for read-mostly trees." +msgstr "" +"Der Stapelabruf von Collections ist besonders hilfreich, wenn Sie einen " +"verschachtelten Baum von Posten besitzen, d.h. das typische \"Bill-of-" +"Materials\"-Modell. (Obwohl ein <emphasis>verschachtelter Satz</emphasis> " +"oder ein <emphasis>realisierter Pfad</emphasis> eine möglicherweise bessere " +"Option für \"read-mostly\"-Bäume ist)." + +#. Tag: title +#, no-c-format +msgid "Using subselect fetching" +msgstr "Die Verwendung von \"Subselect-Fetching\"" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If one lazy collection or single-valued proxy has to be fetched, Hibernate " +"will load all of them, re-running the original query in a subselect. This " +"works in the same way as batch-fetching but without the piecemeal loading." +msgstr "" +"Falls eine \"lazy\" Collection oder ein einwertiges Proxy abgerufen werden " +"muss, so lädt Hibernate alle und führt die ursprüngliche Anfrage in einer " +"Unterauswahl (\"Subselect\") erneut aus. Das funktioniert auf diesselbe " +"Weise wie Stapelabruf, ohne das stückweise Laden." + +#. Tag: title +#, no-c-format +msgid "Using lazy property fetching" +msgstr "Die Verwendung von \"Lazy-Property-Fetching\"" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate3 supports the lazy fetching of individual properties. This " +"optimization technique is also known as <emphasis>fetch groups</emphasis>. " +"Please note that this is mostly a marketing feature; optimizing row reads is " +"much more important than optimization of column reads. However, only loading " +"some properties of a class could be useful in extreme cases. For example, " +"when legacy tables have hundreds of columns and the data model cannot be " +"improved." +msgstr "" +"Hibernate3 unterstützt das \"lazy\" Fetching einzelner Properties. Diese " +"Optimierungstechnik ist auch unter dem Namen <emphasis>Abrufgruppen</" +"emphasis> (sog. Fetch Groups\") bekannt. Bitte beachten Sie, dass es sich " +"hierbei meist um ein Marketing-Feature handelt, da in der Praxis die " +"Optimierung des Lesens von Reihen wesentlich wichtiger ist als die " +"Optimierung des Lesens von Spalten. Jedoch kann es in manchen Fällen " +"nützlich sein, einige Properties einer Klasse zu laden, wenn Stammtabellen " +"hunderte von Spalten besitzen und das Datenmodell nicht verbessert werden " +"kann." + +#. Tag: para +#, no-c-format +msgid "" +"To enable lazy property loading, set the <literal>lazy</literal> attribute " +"on your particular property mappings:" +msgstr "" +"Um das \"lazy\" Laden von Properties zu aktivieren, setzen Sie das " +"<literal>lazy</literal>-Attribut auf Ihr bestimmtes Property-Mapping:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Lazy property loading requires buildtime bytecode instrumentation. If your " +"persistent classes are not enhanced, Hibernate will ignore lazy property " +"settings and return to immediate fetching." +msgstr "" +"Das \"lazy\" Property Laden erfordert Buildtime-Bytecode Instrumentierung! " +"Falls Ihre persistenten Klassen nicht erweitert sind, so übergeht Hibernate " +"stillschweigend die \"lazy\" Property-Einstellungen und verwendet erneut " +"unmittelbaren Abruf (sog. \"immediate Fetching\")." + +#. Tag: para +#, no-c-format +msgid "For bytecode instrumentation, use the following Ant task:" +msgstr "Für die Bytecode-Instrumentierung verwenden Sie folgende Ant-Funktion:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A different way of avoiding unnecessary column reads, at least for read-only " +"transactions, is to use the projection features of HQL or Criteria queries. " +"This avoids the need for buildtime bytecode processing and is certainly a " +"preferred solution." +msgstr "" +"Eine andere (möglicherweise bessere) Art der Vermeidung unnötigen Lesens von " +"Spalten besteht zumindest bei \"read-only\" (schreibgeschützten) " +"Transaktionen in der Verwendung der Projektionsfeatures von HQL- oder " +"Kriterienanfragen. Dadurch wird Buildtime Bytecode-Verarbeitung vermieden, " +"und dies ist daher die bevorzugte Lösung." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can force the usual eager fetching of properties using <literal>fetch " +"all properties</literal> in HQL." +msgstr "" +"Mittels <literal>fetch all properties</literal> in HQL können Sie das " +"übliche \"eager Fetching\" von Properties erzwingen." + +#. Tag: title +#, no-c-format +msgid "The Second Level Cache" +msgstr "Das Cache der zweiten Ebene" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A Hibernate <literal>Session</literal> is a transaction-level cache of " +"persistent data. It is possible to configure a cluster or JVM-level " +"(<literal>SessionFactory</literal>-level) cache on a class-by-class and " +"collection-by-collection basis. You can even plug in a clustered cache. Be " +"aware that caches are not aware of changes made to the persistent store by " +"another application. They can, however, be configured to regularly expire " +"cached data." +msgstr "" +"Bei einer Hibernate <literal>Session</literal> handelt es sich um ein Cache " +"persistenter Daten auf Transaktionsebene. Es ist möglich, auf Klasse-nach-" +"Klasse und Collection-nach-Collection-Basis ein Cache auf Cluster- oder JVM-" +"Ebene zu konfigurieren (<literal>SessionFactory</literal>-Ebene). Sie können " +"sogar in ein geclustertes Cache einbinden. Lassen Sie jedoch Vorsicht " +"walten. Caches sind nie über Änderungen durch eine andere Anwendung im " +"persistenten Speicher informiert (obwohl sie so konfiguriert werden können, " +"dass gecachte Daten in regelmäßigen Abständen gelöscht werden)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You have the option to tell Hibernate which caching implementation to use by " +"specifying the name of a class that implements <literal>org.hibernate.cache." +"CacheProvider</literal> using the property <literal>hibernate.cache." +"provider_class</literal>. Hibernate is bundled with a number of built-in " +"integrations with the open-source cache providers that are listed below. You " +"can also implement your own and plug it in as outlined above. Note that " +"versions prior to 3.2 use EhCache as the default cache provider." +msgstr "" +"Sie haben die Möglichkeit Hibernate mitzuteilen, welche Caching-" +"Implementierung es verwenden soll, indem Sie den Namen der Klasse bestimmen, " +"die <literal>org.hibernate.cache.CacheProvider</literal> unter Verwendung " +"der Property <literal>hibernate.cache.provider_class</literal> " +"implementiert. Hibernate kommt gebündelt mit einer Reihe eingebauter " +"Integrationen mit Open Source Cache-Providern (unten aufgeführt); Sie können " +"zusätzlich Ihren eigenen implementieren und diesen wie oben beschrieben " +"einbinden. Bitte beachten Sie, dass Versionen, die älter sind als 3.2 " +"standardmäßig EhCache als Standard-Cache-Provider verwenden, dies ist seit " +"3.2 jedoch nicht mehr der Fall." + +#. Tag: title +#, no-c-format +msgid "Cache Providers" +msgstr "Cache-Provider" + +#. Tag: entry +#, no-c-format +msgid "Cache" +msgstr "Cache" + +#. Tag: entry +#, no-c-format +msgid "Provider class" +msgstr "Provider-Klasse" + +#. Tag: entry +#, no-c-format +msgid "Type" +msgstr "Typ" + +#. Tag: entry +#, no-c-format +msgid "Cluster Safe" +msgstr "Cluster-sicher" + +#. Tag: entry +#, no-c-format +msgid "Query Cache Supported" +msgstr "Anfragen-Cache unterstützt" + +#. Tag: entry +#, no-c-format +msgid "Hashtable (not intended for production use)" +msgstr "Hash-Tabelle (nicht für den Produktionsgebrauch vorgesehen)" + +#. Tag: entry +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.cache.HashtableCacheProvider</literal>" +msgstr "org.hibernate.cache.HashtableCacheProvider" + +#. Tag: entry +#, no-c-format +msgid "memory" +msgstr "Speicher" + +#. Tag: entry +#, no-c-format +msgid "yes" +msgstr "" + +#. Tag: entry +#, no-c-format +msgid "EHCache" +msgstr "EHCache" + +#. Tag: entry +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.cache.EhCacheProvider</literal>" +msgstr "org.hibernate.cache.EhCacheProvider" + +#. Tag: entry +#, no-c-format +msgid "memory, disk" +msgstr "Speicher, Disk" + +#. Tag: entry +#, no-c-format +msgid "OSCache" +msgstr "OSCache" + +#. Tag: entry +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.cache.OSCacheProvider</literal>" +msgstr "org.hibernate.cache.OSCacheProvider" + +#. Tag: entry +#, no-c-format +msgid "SwarmCache" +msgstr "SwarmCache" + +#. Tag: entry +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.cache.SwarmCacheProvider</literal>" +msgstr "org.hibernate.cache.SwarmCacheProvider" + +#. Tag: entry +#, no-c-format +msgid "clustered (ip multicast)" +msgstr "geclustert (ip multicast)" + +#. Tag: entry +#, no-c-format +msgid "yes (clustered invalidation)" +msgstr "ja (geclusterte Außerkraftsetzung)" + +#. Tag: entry +#, fuzzy, no-c-format +msgid "JBoss Cache 1.x" +msgstr "JBoss TreeCache" + +#. Tag: entry +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.cache.TreeCacheProvider</literal>" +msgstr "org.hibernate.cache.TreeCacheProvider" + +#. Tag: entry +#, no-c-format +msgid "clustered (ip multicast), transactional" +msgstr "geclustert (ip multicast), transaktional" + +#. Tag: entry +#, no-c-format +msgid "yes (replication)" +msgstr "ja (Replikation)" + +#. Tag: entry +#, no-c-format +msgid "yes (clock sync req.)" +msgstr "ja (clock sync req.)" + +#. Tag: entry +#, fuzzy, no-c-format +msgid "JBoss Cache 2" +msgstr "JBoss TreeCache" + +#. Tag: entry +#, fuzzy, no-c-format +msgid "<literal>org.hibernate.cache.jbc2.JBossCacheRegionFactory</literal>" +msgstr "org.hibernate.transaction.JDBCTransactionFactory" + +#. Tag: entry +#, fuzzy, no-c-format +msgid "yes (replication or invalidation)" +msgstr "ja (geclusterte Außerkraftsetzung)" + +#. Tag: title +#, no-c-format +msgid "Cache mappings" +msgstr "Cache-Mappings" + +#. Tag: para +#, no-c-format +msgid "" +"The <literal><cache></literal> element of a class or collection " +"mapping has the following form:" +msgstr "" +"Das <literal><cache></literal>-Element des Mappings einer Klasse oder " +"Collection besitzt folgende Form:" + +#. Tag: para +#, no-c-format +msgid "" +"<literal>usage</literal> (required) specifies the caching strategy: " +"<literal>transactional</literal>, <literal>read-write</literal>, " +"<literal>nonstrict-read-write</literal> or <literal>read-only</literal>" +msgstr "" +"<literal>usage</literal> (erforderlich) bestimmt die Caching-Strategie: " +"<literal>transactional</literal>, <literal>read-write</literal>, " +"<literal>nonstrict-read-write</literal> oder <literal>read-only</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>region</literal> (optional: defaults to the class or collection " +"role name): specifies the name of the second level cache region" +msgstr "" +"<literal>region</literal> (optional, im Standard der Rollenname von Klasse " +"oder Collection) bestimmt den Namen des Cache-Bereichs der zweiten Ebene" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>include</literal> (optional: defaults to <literal>all</literal>) " +"<literal>non-lazy</literal>: specifies that properties of the entity mapped " +"with <literal>lazy=\"true\"</literal> cannot be cached when attribute-level " +"lazy fetching is enabled" +msgstr "" +"<literal>include</literal> (optional, standardmäßig <literal>all</literal>) " +"<literal>non-lazy</literal> bestimmt, dass Properties der mit <literal>lazy=" +"\"true\"</literal> gemappten Entity nicht gecacht werden können, wenn auf " +"Attributebene \"lazy Fetching\" aktiviert ist." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Alternatively, you can specify <literal><class-cache></literal> and " +"<literal><collection-cache></literal> elements in <literal>hibernate." +"cfg.xml</literal>." +msgstr "" +"Alternativ (vorzugsweise?) können Sie <literal><class-cache></literal> " +"und <literal><collection-cache></literal>-Elemente in " +"<literal>hibernate.cfg.xml</literal> bestimmen." + +#. Tag: para +#, no-c-format +msgid "" +"The <literal>usage</literal> attribute specifies a <emphasis>cache " +"concurrency strategy</emphasis>." +msgstr "" +"Das <literal>usage</literal>-Attribut bestimmt eine <emphasis>Cache-" +"Nebenläufigkeitsstrategie</emphasis>." + +#. Tag: title +#, no-c-format +msgid "Strategy: read only" +msgstr "Strategie: \"read only\"" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If your application needs to read, but not modify, instances of a persistent " +"class, a <literal>read-only</literal> cache can be used. This is the " +"simplest and optimal performing strategy. It is even safe for use in a " +"cluster." +msgstr "" +"Falls Ihre Anwendungen Instanzen einer persistenten Klasse lesen, aber nie " +"modifizieren muss, kann ein <literal>read-only</literal>-Cache verwendet " +"werden. Das ist die einfachste und leistungsfähigste Strategie. Sie ist " +"sogar bei der Anwendung in einem Cluster völlig sicher." + +#. Tag: title +#, no-c-format +msgid "Strategy: read/write" +msgstr "Strategie: \"read/write\"" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If the application needs to update data, a <literal>read-write</literal> " +"cache might be appropriate. This cache strategy should never be used if " +"serializable transaction isolation level is required. If the cache is used " +"in a JTA environment, you must specify the property <literal>hibernate." +"transaction.manager_lookup_class</literal> and naming a strategy for " +"obtaining the JTA <literal>TransactionManager</literal>. In other " +"environments, you should ensure that the transaction is completed when " +"<literal>Session.close()</literal> or <literal>Session.disconnect()</" +"literal> is called. If you want to use this strategy in a cluster, you " +"should ensure that the underlying cache implementation supports locking. The " +"built-in cache providers <emphasis>do not</emphasis> support locking." +msgstr "" +"Falls die Anwendung Daten aktualisieren muss, so ist ein <literal>read-" +"write</literal>-Cache eine geeignete Wahl. Diese Cache-Strategie sollte " +"jedoch nie dann benutzt werden, wenn eine serialisierbare " +"Transaktionsisolationsebene benötigt wird. Falls das Cache in einer JTA-" +"Umgebung verwendet wird, müssen Sie die Property <literal>hibernate." +"transaction.manager_lookup_class</literal> bestimmen und eine Strategie für " +"die Abfrage des JTA <literal>TransactionManager</literal> benennen. In " +"anderen Umgebungen sollten Sie sicherstellen, dass die Transaktion beendet " +"ist, wenn <literal>Session.close()</literal> oder <literal>Session.disconnect" +"()</literal> aufgerufen wird. Falls Sie diese Strategie in einem Cluster " +"benutzen möchten, sollten Sie sicherstellen, dass die zu Grunde liegende " +"Cache-Implementierung \"Locking\" (Sperren) unterstützt. Die eingebauten " +"Cache-Provider tun dies <emphasis>nicht</emphasis>." + +#. Tag: title +#, no-c-format +msgid "Strategy: nonstrict read/write" +msgstr "Strategie: \"nonstrict read/write\"" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If the application only occasionally needs to update data (i.e. if it is " +"extremely unlikely that two transactions would try to update the same item " +"simultaneously), and strict transaction isolation is not required, a " +"<literal>nonstrict-read-write</literal> cache might be appropriate. If the " +"cache is used in a JTA environment, you must specify <literal>hibernate." +"transaction.manager_lookup_class</literal>. In other environments, you " +"should ensure that the transaction is completed when <literal>Session.close()" +"</literal> or <literal>Session.disconnect()</literal> is called." +msgstr "" +"Falls die Anwendung nur von Zeit zu Zeit Daten aktualisieren muss (d.h. wenn " +"es sehr unwahrscheinlich ist, dass zwei Transaktionen denselben Posten " +"gleichzeitig zu aktualisieren versuchen würden) und keine strenge " +"Transaktionsisolation erforderlich ist, so kann ein <literal>nonstrict-read-" +"write</literal>-Cache eine passende Wahl sein. Wird das Cache in einer JTA-" +"Umgebung verwendet, so müssen Sie die <literal>hibernate.transaction." +"manager_lookup_class</literal> festlegen. In anderen Umgebungen sollten Sie " +"sicherstellen, dass die Transaktion abgeschlossen ist, wenn <literal>Session." +"close()</literal> oder <literal>Session.disconnect()</literal> aufgerufen " +"wird." + +#. Tag: title +#, no-c-format +msgid "Strategy: transactional" +msgstr "Strategie: transaktional" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>transactional</literal> cache strategy provides support for " +"fully transactional cache providers such as JBoss TreeCache. Such a cache " +"can only be used in a JTA environment and you must specify " +"<literal>hibernate.transaction.manager_lookup_class</literal>." +msgstr "" +"Die <literal>transactional</literal> Cache-Strategie liefert Support für " +"vollständig transaktionale Cache-Provider wie etwa JBoss TreeCache. Ein " +"solches Cache kann nur in einer JTA-Umgebung verwendet werden, und Sie " +"müssen <literal>hibernate.transaction.manager_lookup_class</literal> " +"bestimmen." + +#. Tag: title +#, fuzzy, no-c-format +msgid "Cache-provider/concurrency-strategy compatibility" +msgstr "Cache-Nebenläufigkeitsstrategie-Support" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"None of the cache providers support all of the cache concurrency strategies." +msgstr "" +"Keiner der Cache-Provider unterstützt alle Cache-Nebenläufigkeitsstrategien. " +"Die folgende Tabelle zeigt, welche Provider mit welchen " +"Nebenläufigkeitsstrategien kompatibel sind." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The following table shows which providers are compatible with which " +"concurrency strategies." +msgstr "" +"Keiner der Cache-Provider unterstützt alle Cache-Nebenläufigkeitsstrategien. " +"Die folgende Tabelle zeigt, welche Provider mit welchen " +"Nebenläufigkeitsstrategien kompatibel sind." + +#. Tag: title +#, no-c-format +msgid "Cache Concurrency Strategy Support" +msgstr "Cache-Nebenläufigkeitsstrategie-Support" + +#. Tag: entry +#, no-c-format +msgid "read-only" +msgstr "read-only" + +#. Tag: entry +#, no-c-format +msgid "nonstrict-read-write" +msgstr "nonstrict-read-write" + +#. Tag: entry +#, no-c-format +msgid "read-write" +msgstr "read-write" + +#. Tag: entry +#, no-c-format +msgid "transactional" +msgstr "transactional" + +#. Tag: title +#, no-c-format +msgid "Managing the caches" +msgstr "Management der Caches" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Whenever you pass an object to <literal>save()</literal>, <literal>update()</" +"literal> or <literal>saveOrUpdate()</literal>, and whenever you retrieve an " +"object using <literal>load()</literal>, <literal>get()</literal>, " +"<literal>list()</literal>, <literal>iterate()</literal> or <literal>scroll()" +"</literal>, that object is added to the internal cache of the " +"<literal>Session</literal>." +msgstr "" +"Jedesmal wenn ein Objekt an <literal>save()</literal>, <literal>update()</" +"literal> oder <literal>saveOrUpdate()</literal> weitergegeben wird und Sie " +"ein Objekt unter Verwendung von <literal>load()</literal>, <literal>get()</" +"literal>, <literal>list()</literal>, <literal>iterate()</literal> oder " +"<literal>scroll()</literal> abrufen, wird das Objekt dem internen Cache der " +"<literal>Session</literal> hinzugefügt." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"When <literal>flush()</literal> is subsequently called, the state of that " +"object will be synchronized with the database. If you do not want this " +"synchronization to occur, or if you are processing a huge number of objects " +"and need to manage memory efficiently, the <literal>evict()</literal> method " +"can be used to remove the object and its collections from the first-level " +"cache." +msgstr "" +"Wenn anschließend <literal>flush()</literal> aufgerufen wird, wird der " +"Status des Objekts mit der Datenbank synchronisiert. Falls Sie nicht " +"möchten, dass diese Synchronisierung stattfindet oder falls Sie eine riesige " +"Anzahl von Objekten bearbeiten und effizient mit dem Speicher haushalten " +"müssen, so können mittels der <literal>evict()</literal>-Methode das Objekt " +"und dessen Collections aus dem Cache der ersten Ebene entfernt werden." + +#. Tag: para +#, no-c-format +msgid "" +"The <literal>Session</literal> also provides a <literal>contains()</literal> " +"method to determine if an instance belongs to the session cache." +msgstr "" +"Die <literal>Session</literal> bietet außerdem eine <literal>contains()</" +"literal>-Methode um zu bestimmen, ob eine Instanz zu dem Session-Cache " +"gehört." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"To evict all objects from the session cache, call <literal>Session.clear()</" +"literal>" +msgstr "" +"Um sämtliche Objekte vollständig aus dem Session-Cache zu entfernen, " +"verwenden Sie <literal>Session.clear()</literal>" + +#. Tag: para +#, no-c-format +msgid "" +"For the second-level cache, there are methods defined on " +"<literal>SessionFactory</literal> for evicting the cached state of an " +"instance, entire class, collection instance or entire collection role." +msgstr "" +"Für das Cache der zweiten Ebene gibt es in der <literal>SessionFactory</" +"literal> definierte Methoden, um den gecachten Status einer Instanz, " +"gesamten Klasse, Collection-Instanz oder der gesamten Collection-Rolle zu " +"räumen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>CacheMode</literal> controls how a particular session interacts " +"with the second-level cache:" +msgstr "" +"Mit <literal>CacheMode</literal> wird gesteuert, wie eine bestimmte Session " +"mit dem Cache der zweiten Ebene interagiert." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>CacheMode.NORMAL</literal>: will read items from and write items to " +"the second-level cache" +msgstr "" +"<literal>CacheMode.NORMAL</literal> - liest Posten aus dem und schreibt " +"Posten in das Cache der zweiten Ebene" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>CacheMode.GET</literal>: will read items from the second-level " +"cache. Do not write to the second-level cache except when updating data" +msgstr "" +"<literal>CacheMode.GET</literal> - liest Posten aus dem Cache der zweiten " +"Ebene, schreibt jedoch nichts in das Cache der zweiten Ebene außer bei " +"Aktualisierung der Daten" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>CacheMode.PUT</literal>: will write items to the second-level " +"cache. Do not read from the second-level cache" +msgstr "" +"<literal>CacheMode.PUT</literal> - schreibt Posten in das Cache der zweiten " +"Ebene, aber liest nicht aus dem Cache der zweiten Ebene" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>CacheMode.REFRESH</literal>: will write items to the second-level " +"cache. Do not read from the second-level cache. Bypass the effect of " +"<literal>hibernate.cache.use_minimal_puts</literal> forcing a refresh of the " +"second-level cache for all items read from the database" +msgstr "" +"<literal>CacheMode.REFRESH</literal> - schreibt Posten in das Cache der " +"zweiten Ebene, aber liest nicht aus dem Cache der zweiten Ebene, umgeht die " +"Wirkung von <literal>hibernate.cache.use_minimal_puts</literal> und erzwingt " +"ein erneutes Laden des Cache der zweiten Ebene für alle aus der Datenbank " +"gelesenen Objekte." + +#. Tag: para +#, no-c-format +msgid "" +"To browse the contents of a second-level or query cache region, use the " +"<literal>Statistics</literal> API:" +msgstr "" +"Um die Inhalte eines Cache der zweiten Ebene oder eines Cache-Bereichs zu " +"durchsuchen, verwenden Sie die <literal>Statistics</literal>-API:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You will need to enable statistics and, optionally, force Hibernate to keep " +"the cache entries in a more readable format:" +msgstr "" +"Sie werden die Statistik aktivieren müssen und können optional Hibernate " +"zwingen, Cache-Eingaben in einem lesbaren Format zu halten:" + +#. Tag: title +#, no-c-format +msgid "The Query Cache" +msgstr "Das Anfragen-Cache" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Query result sets can also be cached. This is only useful for queries that " +"are run frequently with the same parameters. You will first need to enable " +"the query cache:" +msgstr "" +"Ergebnissätze von Anfragen können ebenfalls gecacht werden. Das ist jedoch " +"nur für Anfragen, die oft und mit denselben Parametern laufen, sinnvoll. Um " +"das Anfragen-Cache zu benutzen, müssen Sie es zuerst aktivieren:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This setting creates two new cache regions: one holding cached query result " +"sets (<literal>org.hibernate.cache.StandardQueryCache</literal>), the other " +"holding timestamps of the most recent updates to queryable tables " +"(<literal>org.hibernate.cache.UpdateTimestampsCache</literal>). Note that " +"the query cache does not cache the state of the actual entities in the " +"result set; it caches only identifier values and results of value type. The " +"query cache should always be used in conjunction with the second-level cache." +msgstr "" +"Durch diese Einstellung werden zwei neue Cache-Bereiche erstellt - einer, " +"der die gecachten Ergebnissätze der Anfrage enthält (<literal>org.hibernate." +"cache.StandardQueryCache</literal>), und ein zweiter, der die Zeitstempel " +"der letzten Aktualisierungen der anfragbaren Tabellen enthält (<literal>org." +"hibernate.cache.UpdateTimestampsCache</literal>). Bitte beachten Sie, dass " +"das Anfragen-Cache nicht den Status der tatsächlichen Entities im " +"Ergebnissatz cacht, sondern lediglich Bezeichnerwerte und Ergebnisse vom " +"Wertetyp. Das Anfragen-Cache sollte daher stets in Verbindung mit dem Cache " +"der zweiten Ebene verwendet werden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Most queries do not benefit from caching, so by default, queries are not " +"cached. To enable caching, call <literal>Query.setCacheable(true)</literal>. " +"This call allows the query to look for existing cache results or add its " +"results to the cache when it is executed." +msgstr "" +"Bei den meisten Anfragen ist Caching von keinem großen Nutzen, daher werden " +"Anfragen in der Standardeinstellung nicht gecacht. Um Caching zu aktivieren " +"rufen Sie <literal>Query.setCacheable(true)</literal> auf. Dieser Aufruf " +"ermöglicht es der Anfrage nach bestehenden Cache-Ergebnissen zu suchen oder " +"ihre Ergebnisse dem Cache hinzuzufügen, wenn sie ausgeführt wird." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If you require fine-grained control over query cache expiration policies, " +"you can specify a named cache region for a particular query by calling " +"<literal>Query.setCacheRegion()</literal>." +msgstr "" +"Falls Sie eine feinstufige Steuerung der Fälligkeitsrichtlinien benötigen, " +"können Sie einen benannten Cache-Bereich für eine bestimmte Anfrage " +"festlegen, indem Sie <literal>Query.setCacheRegion()</literal> aufrufen." + +#. Tag: para +#, no-c-format +msgid "" +"If the query should force a refresh of its query cache region, you should " +"call <literal>Query.setCacheMode(CacheMode.REFRESH)</literal>. This is " +"particularly useful in cases where underlying data may have been updated via " +"a separate process (i.e., not modified through Hibernate) and allows the " +"application to selectively refresh particular query result sets. This is a " +"more efficient alternative to eviction of a query cache region via " +"<literal>SessionFactory.evictQueries()</literal>." +msgstr "" +"Falls die Anfrage ein erneutes Laden des Cache-Bereichs der Anfrage " +"erzwingen soll, so rufen Sie <literal>Query.setCacheMode(CacheMode.REFRESH)</" +"literal> auf. Das ist besonders in Fällen von Nutzen, wenn die zu Grunde " +"liegenden Daten mittels eines separaten Vorgangs (d.h. nicht durch Hibernate " +"modifiziert) aktualisiert wurden. Dadurch ist es der Anwendung möglich, " +"selektiv bestimmte Ergenissätze der Anfrage neu zu laden. Das ist eine " +"effizientere Alternative als die Räumung eines Cache-Bereichs der Anfrage " +"durch <literal>SessionFactory.evictQueries()</literal>." + +#. Tag: title +#, no-c-format +msgid "Understanding Collection performance" +msgstr "Die Perfomance der Collection verstehen" + +#. Tag: para +#, no-c-format +msgid "" +"In the previous sections we have covered collections and their applications. " +"In this section we explore some more issues in relation to collections at " +"runtime." +msgstr "" + +#. Tag: title +#, no-c-format +msgid "Taxonomy" +msgstr "Taxonomie" + +#. Tag: para +#, no-c-format +msgid "Hibernate defines three basic kinds of collections:" +msgstr "Hibernate unterscheidet drei Grundtypen von Collections:" + +#. Tag: para +#, no-c-format +msgid "collections of values" +msgstr "Collections von Werten" + +#. Tag: para +#, fuzzy, no-c-format +msgid "one-to-many associations" +msgstr "\"One-to-Many\"-Assoziationen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "many-to-many associations" +msgstr "\"Many-to-Many\"-Assoziationen" + +#. Tag: para +#, no-c-format +msgid "" +"This classification distinguishes the various table and foreign key " +"relationships but does not tell us quite everything we need to know about " +"the relational model. To fully understand the relational structure and " +"performance characteristics, we must also consider the structure of the " +"primary key that is used by Hibernate to update or delete collection rows. " +"This suggests the following classification:" +msgstr "" +"Diese Klassifizierung unterscheidet die verschiedenen Tabellen- und " +"Fremdschlüsselbeziehungen, aber sagt so gut wie nichts über das relationale " +"Modell aus. Um die relationale Struktur und Performance-Eigenschaften " +"vollständig zu verstehen, müssen wir die Struktur des von Hibernate zur " +"Aktualisierung und Löschung von Reihen der Collection verwendeten " +"Primärschlüssels berücksichtigen. Das legt die folgende Klassifizierung nahe:" + +#. Tag: para +#, no-c-format +msgid "indexed collections" +msgstr "indizierte Collections" + +#. Tag: para +#, no-c-format +msgid "sets" +msgstr "Sets" + +#. Tag: para +#, no-c-format +msgid "bags" +msgstr "Bags" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"All indexed collections (maps, lists, and arrays) have a primary key " +"consisting of the <literal><key></literal> and <literal><index></" +"literal> columns. In this case, collection updates are extremely efficient. " +"The primary key can be efficiently indexed and a particular row can be " +"efficiently located when Hibernate tries to update or delete it." +msgstr "" +"Alle indizierten Collections (Maps, Listen, Arrays) besitzen einen " +"Primärschlüssel, der aus den <literal><key></literal> und <literal><" +"index></literal>-Spalten besteht. In diesem Fall sind Aktualisierungen " +"der Collection sehr effizient - der Primärschlüssel kann effizient indiziert " +"werden und eine bestimmte Reihe kann effizient lokalisiert werden, wenn " +"Hibernate diese zu aktualisieren oder löschen versucht." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Sets have a primary key consisting of <literal><key></literal> and " +"element columns. This can be less efficient for some types of collection " +"element, particularly composite elements or large text or binary fields, as " +"the database may not be able to index a complex primary key as efficiently. " +"However, for one-to-many or many-to-many associations, particularly in the " +"case of synthetic identifiers, it is likely to be just as efficient. If you " +"want <literal>SchemaExport</literal> to actually create the primary key of a " +"<literal><set></literal>, you must declare all columns as <literal>not-" +"null=\"true\"</literal>." +msgstr "" +"Sets besitzen einen Primärschlüssel, der aus <literal><key></literal> " +"und Elementspalten besteht. Das kann für einige Typen von Collection-Element " +"weniger effizient sein, insbesondere im Fall von zusammengesetzten Elementen " +"oder großem Text oder Binärfeldern ist es möglich, dass die Datenbank einen " +"komplexen Primärschlüssel nicht so effizient indizieren kann. Andererseits " +"kann für \"One-to-Many\" und \"Many-to-Many\"-Assoziationen - insbesondere " +"bei synthetischem Bezeichner - dieselbe Effizienz existieren." +"(Nebenbemerkung: Falls <literal>SchemaExport</literal> tatsächlich den " +"Primärschlüssel eines <literal><set></literal> für Sie erstellen soll, " +"so müssen Sie alle Spalten als <literal>not-null=\"true\"</literal> " +"deklarieren)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal><idbag></literal> mappings define a surrogate key, so they " +"are efficient to update. In fact, they are the best case." +msgstr "" +"<literal><idbag></literal>-Mappings definieren einen " +"Surrogatschlüssel, so dass sie sich immer sehr effizient aktualisieren " +"lassen. Genau genommen, ist das der beste Fall." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Bags are the worst case since they permit duplicate element values and, as " +"they have no index column, no primary key can be defined. Hibernate has no " +"way of distinguishing between duplicate rows. Hibernate resolves this " +"problem by completely removing in a single <literal>DELETE</literal> and " +"recreating the collection whenever it changes. This can be inefficient." +msgstr "" +"Mit den Bags verhält es sich am schwierigsten. Da eine Bag doppelte " +"Elementwerte gestattet und keine Indexspalte besitzt, kann kein " +"Primärschlüssel definiert werden. Hibernate hat keine Möglichkeit, doppelte " +"Reihen zu unterscheiden. Hibernate löst dieses Problem, indem es die " +"Collection bei jeder Änderung vollständig entfernt (in einem einzelnen " +"<literal>DELETE</literal>) und erneut herstellt. Das kann jedoch sehr " +"ineffizient sein." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"For a one-to-many association, the \"primary key\" may not be the physical " +"primary key of the database table. Even in this case, the above " +"classification is still useful. It reflects how Hibernate \"locates\" " +"individual rows of the collection." +msgstr "" +"Bitte beachten Sie, dass für eine \"One-to-Many\"-Assoziation der " +"\"Primärschlüssel\" möglicherweise nicht der physische Primärschlüssel der " +"Datenbanktabelle ist - aber selbst in diesem Fall ist die vorherige " +"Klassifizierung noch sinnvoll. (Sie spiegelt nach wie vor wider, wie " +"Hibernate einzelne Reihen der Collection \"lokalisiert\")." + +#. Tag: title +#, no-c-format +msgid "" +"Lists, maps, idbags and sets are the most efficient collections to update" +msgstr "" +"Listen, Maps, \"idbags\" und Sets sind die am effizientesten zu " +"aktualisierenden Collections" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"From the discussion above, it should be clear that indexed collections and " +"sets allow the most efficient operation in terms of adding, removing and " +"updating elements." +msgstr "" +"Die vorangegangene Erläuterung zeigt deutlich, dass indizierte Collections " +"und (in der Regel) Sets hinsichtlich des Hinzufügens, Entfernens und " +"Aktualisierens von Reihen die effizientesten Vorgänge erlauben." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"There is, arguably, one more advantage that indexed collections have over " +"sets for many-to-many associations or collections of values. Because of the " +"structure of a <literal>Set</literal>, Hibernate does not <literal>UPDATE</" +"literal> a row when an element is \"changed\". Changes to a <literal>Set</" +"literal> always work via <literal>INSERT</literal> and <literal>DELETE</" +"literal> of individual rows. Once again, this consideration does not apply " +"to one-to-many associations." +msgstr "" +"Es gibt wohl einen weiteren Vorteil, den indizierte Collections vor Sets für " +"\"Many-to-Many\"-Assoziationen oder Collections von Werten besitzen. " +"Aufgrund der Struktur eines <literal>Set</literal>, führt Hibernate nie ein " +"<literal>UPDATE</literal> einer Reihe durch, wenn ein Element \"verändert\" " +"ist. Änderungen an einem <literal>Set</literal> laufen immer mittels " +"<literal>INSERT</literal> und <literal>DELETE</literal> (einzelner Reihen) " +"ab. Auch hier gilt diese Überlegung nicht für \"One-to-Many\"-Assoziationen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"After observing that arrays cannot be lazy, you can conclude that lists, " +"maps and idbags are the most performant (non-inverse) collection types, with " +"sets not far behind. You can expect sets to be the most common kind of " +"collection in Hibernate applications. This is because the \"set\" semantics " +"are most natural in the relational model." +msgstr "" +"Nachdem wir gesehen haben, dass Arrays nicht \"lazy\" sein können würden wir " +"schließen, dass Listen, Maps und \"idbags\" die performantesten (nicht-" +"inversen) Collection-Typen gefolgt von Sets sind. Sets sind erwartungsgemäß " +"die gängigsten Arten von Collections in Hibernate Anwendungen. Der Grund " +"hierfür liegt in der Tatsache, dass die \"Set\"-Semantik im relationalen " +"Modell die natürlichste ist." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"However, in well-designed Hibernate domain models, most collections are in " +"fact one-to-many associations with <literal>inverse=\"true\"</literal>. For " +"these associations, the update is handled by the many-to-one end of the " +"association, and so considerations of collection update performance simply " +"do not apply." +msgstr "" +"In guten Hibernate Domain-Modellen sehen wir jedoch, dass es sich bei den " +"meisten Collections um \"One-to-Many\"-Assoziationen mit <literal>inverse=" +"\"true\"</literal> handelt. Für diese Assoziationen wird die Aktualisierung " +"vom \"Many-to-One\"-Ende der Assoziation bearbeitet, so dass Überlegungen " +"hinsichtlich der Performance der Collection-Aktualisierung nicht gelten." + +#. Tag: title +#, no-c-format +msgid "Bags and lists are the most efficient inverse collections" +msgstr "Bags und Listen sind die effizientesten invertierten Collections" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"There is a particular case, however, in which bags, and also lists, are much " +"more performant than sets. For a collection with <literal>inverse=\"true\"</" +"literal>, the standard bidirectional one-to-many relationship idiom, for " +"example, we can add elements to a bag or list without needing to initialize " +"(fetch) the bag elements. This is because, unlike a <literal>set</literal>, " +"<literal>Collection.add()</literal> or <literal>Collection.addAll()</" +"literal> must always return true for a bag or <literal>List</literal>. This " +"can make the following common code much faster:" +msgstr "" +"Ehe Sie jetzt \"Bags\" für immer verwerfen sollten wir erwähnen, dass ein " +"spezieller Fall existiert, in dem \"Bags\" (und ebenso Listen) wesentlich " +"performanter als Sets sind. Für eine Collection mit <literal>inverse=\"true" +"\"</literal> (z.B. das standardmäßige bidirektionale Idiom einer \"One-to-" +"Many\"-Beziehung) können wir einer \"Bag\" oder Liste Elemente hinzufügen, " +"ohne die Elemente der \"Bag\" initialisieren (abrufen) zu müssen! Das kommt " +"daher, dass <literal>Collection.add()</literal> oder <literal>Collection." +"addAll()</literal> stets mit \"true\" für eine \"Bag\" oder <literal>List</" +"literal> reagieren müssen (anders als bei einem <literal>Set</literal>). " +"Dadurch kann der folgende Code wesentlich schneller werden." + +#. Tag: title +#, no-c-format +msgid "One shot delete" +msgstr "\"One-Shot-Löschung\"" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Deleting collection elements one by one can sometimes be extremely " +"inefficient. Hibernate knows not to do that in the case of an newly-empty " +"collection (if you called <literal>list.clear()</literal>, for example). In " +"this case, Hibernate will issue a single <literal>DELETE</literal>." +msgstr "" +"In manchen Fällen kann das einzelne Löschen von Elementen einer Collection " +"sehr ineffizient sein. Hibernate weiß, was im Fall einer neu-geleerten " +"Collection zu tun ist (falls Sie etwa <literal>list.clear()</literal> " +"aufgerufen haben). Hibernate gibt dann ein einzelnes <literal>DELETE</" +"literal> heraus, und wir sind fertig!" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Suppose you added a single element to a collection of size twenty and then " +"remove two elements. Hibernate will issue one <literal>INSERT</literal> " +"statement and two <literal>DELETE</literal> statements, unless the " +"collection is a bag. This is certainly desirable." +msgstr "" +"Nehmen wir an, wir fügen ein einzelnes Element einer Collection von 20 hinzu " +"und wollten dann zwei Elemente entfernen. Hibernate gibt in diesem Fall eine " +"<literal>INSERT</literal>-Anweisung und zwei <literal>DELETE</literal>-" +"Anweisungen heraus (außer es handelt sich bei der Collection um eine \"Bag" +"\"). Das ist auf jeden Fall wünschenswert." + +#. Tag: para +#, no-c-format +msgid "" +"However, suppose that we remove eighteen elements, leaving two and then add " +"thee new elements. There are two possible ways to proceed" +msgstr "" +"Nehmen wir jedoch an wir entfernen 18 Elemente, ließen also zwei übrig und " +"fügten dann drei weitere hinzu. In diesem Fall gibt es zwei mögliche " +"Vorgehensweisen:" + +#. Tag: para +#, no-c-format +msgid "delete eighteen rows one by one and then insert three rows" +msgstr "" +"die 18 Reihen eine nach der anderen löschen und anschließend drei Reihen " +"einfügen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"remove the whole collection in one SQL <literal>DELETE</literal> and insert " +"all five current elements one by one" +msgstr "" +"die gesamte Collection entfernen (in einem SQL <literal>DELETE</literal>) " +"und die fünf aktuellen Elemente (einzeln) einfügen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate cannot know that the second option is probably quicker. It would " +"probably be undesirable for Hibernate to be that intuitive as such behavior " +"might confuse database triggers, etc." +msgstr "" +"Hibernate weiß nicht, dass die zweite Option in diesem Fall die " +"wahrscheinlich schnellere ist. (Und es ist auch zweifelhaft, ob es gut wäre " +"wenn Hibernate dies wüsste, da ein solches Verhalten Datenbank-Trigger " +"verwirren könnte usw.)" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Fortunately, you can force this behavior (i.e. the second strategy) at any " +"time by discarding (i.e. dereferencing) the original collection and " +"returning a newly instantiated collection with all the current elements." +msgstr "" +"Glücklicherweise können Sie dieses Verhalten jederzeit durchsetzen (d.h. die " +"zweite Option), indem Sie etwa die ursprüngliche Collection verwerfen und " +"dann eine neu instantiierte Collection mit allen aktuellen Elementen " +"wiedergeben. Das kann sich von Zeit zu Zeit als sehr hilfreich und " +"leistungsfähig erweisen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"One-shot-delete does not apply to collections mapped <literal>inverse=\"true" +"\"</literal>." +msgstr "" +"Natürlich gilt das \"One-Shot-Delete\" nicht für als <literal>inverse=\"true" +"\"</literal> gemappte Collections." + +#. Tag: title +#, no-c-format +msgid "Monitoring performance" +msgstr "Leistungsüberwachung" + +#. Tag: para +#, no-c-format +msgid "" +"Optimization is not much use without monitoring and access to performance " +"numbers. Hibernate provides a full range of figures about its internal " +"operations. Statistics in Hibernate are available per " +"<literal>SessionFactory</literal>." +msgstr "" +"Optimierungen machen ohne Überwachung und Zugriff auf Performanzzahlen wenig " +"Sinn. Hibernate liefert eine ganze Bandbreite von Zahlen zu seinen internen " +"Vorgängen. Statistiken sind in Hibernate über die <literal>SessionFactory</" +"literal> verfügbar." + +#. Tag: title +#, no-c-format +msgid "Monitoring a SessionFactory" +msgstr "Die Überwachung einer SessionFactory" + +#. Tag: para +#, no-c-format +msgid "" +"You can access <literal>SessionFactory</literal> metrics in two ways. Your " +"first option is to call <literal>sessionFactory.getStatistics()</literal> " +"and read or display the <literal>Statistics</literal> yourself." +msgstr "" +"Sie können auf zwei Arten auf <literal>SessionFactory</literal>-Metriken " +"zugreifen. Die erste Möglichkeit ist es, <literal>sessionFactory." +"getStatistics()</literal> aufzurufen und die <literal>Statistics</literal> " +"selbst zu lesen und anzuzeigen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate can also use JMX to publish metrics if you enable the " +"<literal>StatisticsService</literal> MBean. You can enable a single MBean " +"for all your <literal>SessionFactory</literal> or one per factory. See the " +"following code for minimalistic configuration examples:" +msgstr "" +"Hibernate kann außerdem JMX verwenden, um Metriken zu publizieren wenn Sie " +"das <literal>StatisticsService</literal>-MBean aktivieren. Sie können ein " +"einzelnes MBean für alle Ihre <literal>SessionFactory</literal>s oder aber " +"eines pro Factory aktivieren. Sehen Sie sich den folgenden Code für " +"minimalistische Konfigurationsbeispiele an:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can activate and deactivate the monitoring for a " +"<literal>SessionFactory</literal>:" +msgstr "" +"Sie können die Überwachung für eine <literal>SessionFactory</literal> (de)" +"aktivieren" + +#. Tag: para +#, no-c-format +msgid "" +"at configuration time, set <literal>hibernate.generate_statistics</literal> " +"to <literal>false</literal>" +msgstr "" +"zum Konfigurationszeitpunkt setzen Sie <literal>hibernate." +"generate_statistics</literal> auf <literal>false</literal>" + +#. Tag: para +#, no-c-format +msgid "" +"at runtime: <literal>sf.getStatistics().setStatisticsEnabled(true)</literal> " +"or <literal>hibernateStatsBean.setStatisticsEnabled(true)</literal>" +msgstr "" +"zur Runtime: <literal>sf.getStatistics().setStatisticsEnabled(true)</" +"literal> oder <literal>hibernateStatsBean.setStatisticsEnabled(true)</" +"literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Statistics can be reset programmatically using the <literal>clear()</" +"literal> method. A summary can be sent to a logger (info level) using the " +"<literal>logSummary()</literal> method." +msgstr "" +"Statistiken können programmatisch mit der <literal>clear()</literal>-Methode " +"zurückgesetzt werden. Eine Zusammenfassung kann unter Verwendung der " +"<literal>logSummary()</literal>-Methode auch an einen Logger (Info-Level) " +"geschickt werden." + +#. Tag: title +#, no-c-format +msgid "Metrics" +msgstr "Metriken" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate provides a number of metrics, from basic information to more " +"specialized information that is only relevant in certain scenarios. All " +"available counters are described in the <literal>Statistics</literal> " +"interface API, in three categories:" +msgstr "" +"Hibernate liefert eine Reihe von Metriken, die von ganz basalen bis sehr " +"speziellen und ganz bestimmte Szenarios betreffenden reichen. Alle " +"verfügbaren Zähler sind im <literal>Statistics</literal>-Interface API, in " +"drei Kategorien beschrieben:" + +#. Tag: para +#, no-c-format +msgid "" +"Metrics related to the general <literal>Session</literal> usage, such as " +"number of open sessions, retrieved JDBC connections, etc." +msgstr "" +"Mit dem allgemeinen <literal>Session</literal>-Gebrauch zusammenhängende " +"Metriken wie etwa die Anzahl geöffneter Sessions, abgerufener JDBC-" +"Verbindungen usw." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Metrics related to the entities, collections, queries, and caches as a whole " +"(aka global metrics)." +msgstr "" +"Mit Entities, Collections, Anfragen und Caches insgesamt zusammenhängende " +"Metriken (auch als allgemeingültige Metriken bekannt, sog. \"global metrics" +"\")" + +#. Tag: para +#, no-c-format +msgid "" +"Detailed metrics related to a particular entity, collection, query or cache " +"region." +msgstr "" +"Detaillierte Metriken, die sich auf eine bestimmte Entity, Collection, " +"Anfrage oder Cache-Region beziehen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"For example, you can check the cache hit, miss, and put ratio of entities, " +"collections and queries, and the average time a query needs. Be aware that " +"the number of milliseconds is subject to approximation in Java. Hibernate is " +"tied to the JVM precision and on some platforms this might only be accurate " +"to 10 seconds." +msgstr "" +"Sie können zum Beispiel Cache-Treffer und Nicht-Treffer, das Verhältnis von " +"Entities, Collections und Anfragen und die durchschnittliche Dauer bis zur " +"Rückmeldung prüfen. Bitte berücksichtigen Sie, dass es sich bei der Anzahl " +"von Millisekunden in Java um eine Näherungswert handelt. Hibernate ist an " +"die Genauigkeit der JVM gebunden und auf manchen Plattformen kann das nur " +"auf 10 Sekunden genau sein." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Simple getters are used to access the global metrics (i.e. not tied to a " +"particular entity, collection, cache region, etc.). You can access the " +"metrics of a particular entity, collection or cache region through its name, " +"and through its HQL or SQL representation for queries. Please refer to the " +"<literal>Statistics</literal>, <literal>EntityStatistics</literal>, " +"<literal>CollectionStatistics</literal>, " +"<literal>SecondLevelCacheStatistics</literal>, and <literal>QueryStatistics</" +"literal> API Javadoc for more information. The following code is a simple " +"example:" +msgstr "" +"Einfache \"Getters\" werden für den Zugriff auf allgemeine Metriken (d.h. " +"nicht an eine bestimmte Entity, Collection, Cache-Bereich usw.) verwendet. " +"Sie können auf die Metriken einer bestimmten Entity, Collection oder Cache-" +"Bereichs über dessen Namen und über dessen HQL- oder SQL-Repräsentation für " +"Anfragen zugreifen. Weitere Informationen finden Sie im <literal>Statistics</" +"literal>, <literal>EntityStatistics</literal>, " +"<literal>CollectionStatistics</literal>, " +"<literal>SecondLevelCacheStatistics</literal> und <literal>QueryStatistics</" +"literal> API-Javadoc. Der folgende Code zeigt ein einfaches Beispiel:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can work on all entities, collections, queries and region caches, by " +"retrieving the list of names of entities, collections, queries and region " +"caches using the following methods: <literal>getQueries()</literal>, " +"<literal>getEntityNames()</literal>, <literal>getCollectionRoleNames()</" +"literal>, and <literal>getSecondLevelCacheRegionNames()</literal>." +msgstr "" +"Um an sämtlichen Entities, Collections, Anfragen und Cache-Bereichen zu " +"arbeiten, können Sie die Namensliste der Entities, Collections, Anfragen und " +"Cache-Bereiche abrufen, indem Sie die folgenden Methoden verwenden: " +"<literal>getQueries()</literal>, <literal>getEntityNames()</literal>, " +"<literal>getCollectionRoleNames()</literal> und " +"<literal>getSecondLevelCacheRegionNames()</literal>." + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[s = sessions.openSession();\n" +#~ "Transaction tx = s.beginTransaction();\n" +#~ " \n" +#~ "User u = (User) s.createQuery(\"from User u where u.name=:userName\")\n" +#~ " .setString(\"userName\", userName).uniqueResult();\n" +#~ "Map permissions = u.getPermissions();\n" +#~ "\n" +#~ "tx.commit();\n" +#~ "s.close();\n" +#~ "\n" +#~ "Integer accessLevel = (Integer) permissions.get(\"accounts\"); // " +#~ "Error!]]>" +#~ msgstr "" +#~ "s = sessions.openSession();\n" +#~ "Transaction tx = s.beginTransaction();\n" +#~ " \n" +#~ "User u = (User) s.createQuery(\"from User u where u.name=:userName\")\n" +#~ " .setString(\"userName\", userName).uniqueResult();\n" +#~ "Map permissions = u.getPermissions();\n" +#~ "\n" +#~ "tx.commit();\n" +#~ "s.close();\n" +#~ "\n" +#~ "Integer accessLevel = (Integer) permissions.get(\"accounts\"); // Error!" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<set name=\"permissions\" \n" +#~ " fetch=\"join\">\n" +#~ " <key column=\"userId\"/>\n" +#~ " <one-to-many class=\"Permission\"/>\n" +#~ "</set]]>" +#~ msgstr "" +#~ "<set name=\"permissions\" \n" +#~ " fetch=\"join\">\n" +#~ " <key column=\"userId\"/>\n" +#~ " <one-to-many class=\"Permission\"/>\n" +#~ "</set" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<many-to-one name=\"mother\" class=\"Cat\" fetch=\"join\"/>]]>" +#~ msgstr "<many-to-one name=\"mother\" class=\"Cat\" fetch=\"join\"/>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[User user = (User) session.createCriteria(User.class)\n" +#~ " .setFetchMode(\"permissions\", FetchMode.JOIN)\n" +#~ " .add( Restrictions.idEq(userId) )\n" +#~ " .uniqueResult();]]>" +#~ msgstr "" +#~ "User user = (User) session.createCriteria(User.class)\n" +#~ " .setFetchMode(\"permissions\", FetchMode.JOIN)\n" +#~ " .add( Restrictions.idEq(userId) )\n" +#~ " .uniqueResult();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Cat\" proxy=\"Cat\">\n" +#~ " ......\n" +#~ " <subclass name=\"DomesticCat\">\n" +#~ " .....\n" +#~ " </subclass>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Cat\" proxy=\"Cat\">\n" +#~ " ......\n" +#~ " <subclass name=\"DomesticCat\">\n" +#~ " .....\n" +#~ " </subclass>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Cat cat = (Cat) session.load(Cat.class, id); // instantiate a " +#~ "proxy (does not hit the db)\n" +#~ "if ( cat.isDomesticCat() ) { // hit the db to initialize " +#~ "the proxy\n" +#~ " DomesticCat dc = (DomesticCat) cat; // Error!\n" +#~ " ....\n" +#~ "}]]>" +#~ msgstr "" +#~ "Cat cat = (Cat) session.load(Cat.class, id); // instantiate a proxy " +#~ "(does not hit the db)\n" +#~ "if ( cat.isDomesticCat() ) { // hit the db to initialize " +#~ "the proxy\n" +#~ " DomesticCat dc = (DomesticCat) cat; // Error!\n" +#~ " ....\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Cat cat = (Cat) session.load(Cat.class, id); // " +#~ "instantiate a Cat proxy\n" +#~ "DomesticCat dc = \n" +#~ " (DomesticCat) session.load(DomesticCat.class, id); // acquire " +#~ "new DomesticCat proxy!\n" +#~ "System.out.println(cat==dc); // false]]>" +#~ msgstr "" +#~ "Cat cat = (Cat) session.load(Cat.class, id); // instantiate a " +#~ "Cat proxy\n" +#~ "DomesticCat dc = \n" +#~ " (DomesticCat) session.load(DomesticCat.class, id); // acquire " +#~ "new DomesticCat proxy!\n" +#~ "System.out.println(cat==dc); // false" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[cat.setWeight(11.0); // hit the db to initialize the proxy\n" +#~ "System.out.println( dc.getWeight() ); // 11.0]]>" +#~ msgstr "" +#~ "cat.setWeight(11.0); // hit the db to initialize the proxy\n" +#~ "System.out.println( dc.getWeight() ); // 11.0" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"CatImpl\" proxy=\"Cat\">\n" +#~ " ......\n" +#~ " <subclass name=\"DomesticCatImpl\" proxy=\"DomesticCat\">\n" +#~ " .....\n" +#~ " </subclass>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"CatImpl\" proxy=\"Cat\">\n" +#~ " ......\n" +#~ " <subclass name=\"DomesticCatImpl\" proxy=\"DomesticCat\">\n" +#~ " .....\n" +#~ " </subclass>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Cat cat = (Cat) session.load(CatImpl.class, catid);\n" +#~ "Iterator iter = session.createQuery(\"from CatImpl as cat where cat." +#~ "name='fritz'\").iterate();\n" +#~ "Cat fritz = (Cat) iter.next();]]>" +#~ msgstr "" +#~ "Cat cat = (Cat) session.load(CatImpl.class, catid);\n" +#~ "Iterator iter = session.iterate(\"from CatImpl as cat where cat." +#~ "name='fritz'\");\n" +#~ "Cat fritz = (Cat) iter.next();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[( (Integer) s.createFilter( collection, \"select count(*)\" )." +#~ "list().get(0) ).intValue()]]>" +#~ msgstr "" +#~ "( (Integer) s.createFilter( collection, \"select count(*)\" ).list().get" +#~ "(0) ).intValue()" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[s.createFilter( lazyCollection, \"\").setFirstResult(0)." +#~ "setMaxResults(10).list();]]>" +#~ msgstr "" +#~ "s.createFilter( lazyCollection, \"\").setFirstResult(0).setMaxResults(10)." +#~ "list();" + +#, fuzzy +#~ msgid "<![CDATA[<class name=\"Person\" batch-size=\"10\">...</class>]]>" +#~ msgstr "<class name=\"Person\" batch-size=\"10\">...</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Person\">\n" +#~ " <set name=\"cats\" batch-size=\"3\">\n" +#~ " ...\n" +#~ " </set>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Person\">\n" +#~ " <set name=\"cats\" batch-size=\"3\">\n" +#~ " ...\n" +#~ " </set>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Document\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <property name=\"name\" not-null=\"true\" length=\"50\"/>\n" +#~ " <property name=\"summary\" not-null=\"true\" length=\"200\" lazy=" +#~ "\"true\"/>\n" +#~ " <property name=\"text\" not-null=\"true\" length=\"2000\" lazy=\"true" +#~ "\"/>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Document\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <property name=\"name\" not-null=\"true\" length=\"50\"/>\n" +#~ " <property name=\"summary\" not-null=\"true\" length=\"200\" lazy=" +#~ "\"true\"/>\n" +#~ " <property name=\"text\" not-null=\"true\" length=\"2000\" lazy=" +#~ "\"true\"/>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<target name=\"instrument\" depends=\"compile\">\n" +#~ " <taskdef name=\"instrument\" classname=\"org.hibernate.tool." +#~ "instrument.InstrumentTask\">\n" +#~ " <classpath path=\"${jar.path}\"/>\n" +#~ " <classpath path=\"${classes.dir}\"/>\n" +#~ " <classpath refid=\"lib.class.path\"/>\n" +#~ " </taskdef>\n" +#~ "\n" +#~ " <instrument verbose=\"true\">\n" +#~ " <fileset dir=\"${testclasses.dir}/org/hibernate/auction/model\">\n" +#~ " <include name=\"*.class\"/>\n" +#~ " </fileset>\n" +#~ " </instrument>\n" +#~ "</target>]]>" +#~ msgstr "" +#~ "<target name=\"instrument\" depends=\"compile\">\n" +#~ " <taskdef name=\"instrument\" classname=\"org.hibernate.tool." +#~ "instrument.InstrumentTask\">\n" +#~ " <classpath path=\"${jar.path}\"/>\n" +#~ " <classpath path=\"${classes.dir}\"/>\n" +#~ " <classpath refid=\"lib.class.path\"/>\n" +#~ " </taskdef>\n" +#~ "\n" +#~ " <instrument verbose=\"true\">\n" +#~ " <fileset dir=\"${testclasses.dir}/org/hibernate/auction/" +#~ "model\">\n" +#~ " <include name=\"*.class\"/>\n" +#~ " </fileset>\n" +#~ " </instrument>\n" +#~ "</target>" + +#~ msgid "<entry>yes</entry>" +#~ msgstr "<entry>Ja</entry>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<cache \n" +#~ " usage=\"transactional|read-write|nonstrict-read-write|read-only\"\n" +#~ " region=\"RegionName\"\n" +#~ " include=\"all|non-lazy\"\n" +#~ "/>]]>" +#~ msgstr "" +#~ "<cache \n" +#~ " usage=\"transactional|read-write|nonstrict-read-write|read-only\"\n" +#~ " region=\"RegionName\"\n" +#~ " include=\"all|non-lazy\"\n" +#~ "/>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"eg.Immutable\" mutable=\"false\">\n" +#~ " <cache usage=\"read-only\"/>\n" +#~ " ....\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"eg.Immutable\" mutable=\"false\">\n" +#~ " <cache usage=\"read-only\"/>\n" +#~ " ....\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"eg.Cat\" .... >\n" +#~ " <cache usage=\"read-write\"/>\n" +#~ " ....\n" +#~ " <set name=\"kittens\" ... >\n" +#~ " <cache usage=\"read-write\"/>\n" +#~ " ....\n" +#~ " </set>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"eg.Cat\" .... >\n" +#~ " <cache usage=\"read-write\"/>\n" +#~ " ....\n" +#~ " <set name=\"kittens\" ... >\n" +#~ " <cache usage=\"read-write\"/>\n" +#~ " ....\n" +#~ " </set>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[ScrollableResult cats = sess.createQuery(\"from Cat as cat\")." +#~ "scroll(); //a huge result set\n" +#~ "while ( cats.next() ) {\n" +#~ " Cat cat = (Cat) cats.get(0);\n" +#~ " doSomethingWithACat(cat);\n" +#~ " sess.evict(cat);\n" +#~ "}]]>" +#~ msgstr "" +#~ "ScrollableResult cats = sess.createQuery(\"from Cat as cat\").scroll(); //" +#~ "a huge result set\n" +#~ "while ( cats.next() ) {\n" +#~ " Cat cat = (Cat) cats.get(0);\n" +#~ " doSomethingWithACat(cat);\n" +#~ " sess.evict(cat);\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[sessionFactory.evict(Cat.class, catId); //evict a particular " +#~ "Cat\n" +#~ "sessionFactory.evict(Cat.class); //evict all Cats\n" +#~ "sessionFactory.evictCollection(\"Cat.kittens\", catId); //evict a " +#~ "particular collection of kittens\n" +#~ "sessionFactory.evictCollection(\"Cat.kittens\"); //evict all kitten " +#~ "collections]]>" +#~ msgstr "" +#~ "sessionFactory.evict(Cat.class, catId); //evict a particular Cat\n" +#~ "sessionFactory.evict(Cat.class); //evict all Cats\n" +#~ "sessionFactory.evictCollection(\"Cat.kittens\", catId); //evict a " +#~ "particular collection of kittens\n" +#~ "sessionFactory.evictCollection(\"Cat.kittens\"); //evict all kitten " +#~ "collections" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Map cacheEntries = sessionFactory.getStatistics()\n" +#~ " .getSecondLevelCacheStatistics(regionName)\n" +#~ " .getEntries();]]>" +#~ msgstr "" +#~ "Map cacheEntries = sessionFactory.getStatistics()\n" +#~ " .getSecondLevelCacheStatistics(regionName)\n" +#~ " .getEntries();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[hibernate.generate_statistics true\n" +#~ "hibernate.cache.use_structured_entries true]]>" +#~ msgstr "" +#~ "hibernate.generate_statistics true\n" +#~ "hibernate.cache.use_structured_entries true" + +#, fuzzy +#~ msgid "<![CDATA[hibernate.cache.use_query_cache true]]>" +#~ msgstr "hibernate.cache.use_query_cache true" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[List blogs = sess.createQuery(\"from Blog blog where blog." +#~ "blogger = :blogger\")\n" +#~ " .setEntity(\"blogger\", blogger)\n" +#~ " .setMaxResults(15)\n" +#~ " .setCacheable(true)\n" +#~ " .setCacheRegion(\"frontpages\")\n" +#~ " .list();]]>" +#~ msgstr "" +#~ "List blogs = sess.createQuery(\"from Blog blog where blog.blogger = :" +#~ "blogger\")\n" +#~ " .setEntity(\"blogger\", blogger)\n" +#~ " .setMaxResults(15)\n" +#~ " .setCacheable(true)\n" +#~ " .setCacheRegion(\"frontpages\")\n" +#~ " .list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Parent p = (Parent) sess.load(Parent.class, id);\n" +#~ "Child c = new Child();\n" +#~ "c.setParent(p);\n" +#~ "p.getChildren().add(c); //no need to fetch the collection!\n" +#~ "sess.flush();]]>" +#~ msgstr "" +#~ "Parent p = (Parent) sess.load(Parent.class, id);\n" +#~ "Child c = new Child();\n" +#~ "c.setParent(p);\n" +#~ "p.getChildren().add(c); //no need to fetch the collection!\n" +#~ "sess.flush();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[// MBean service registration for a specific SessionFactory\n" +#~ "Hashtable tb = new Hashtable();\n" +#~ "tb.put(\"type\", \"statistics\");\n" +#~ "tb.put(\"sessionFactory\", \"myFinancialApp\");\n" +#~ "ObjectName on = new ObjectName(\"hibernate\", tb); // MBean object name\n" +#~ "\n" +#~ "StatisticsService stats = new StatisticsService(); // MBean " +#~ "implementation\n" +#~ "stats.setSessionFactory(sessionFactory); // Bind the stats to a " +#~ "SessionFactory\n" +#~ "server.registerMBean(stats, on); // Register the Mbean on the server]]>" +#~ msgstr "" +#~ "// MBean service registration for a specific SessionFactory\n" +#~ "Hashtable tb = new Hashtable();\n" +#~ "tb.put(\"type\", \"statistics\");\n" +#~ "tb.put(\"sessionFactory\", \"myFinancialApp\");\n" +#~ "ObjectName on = new ObjectName(\"hibernate\", tb); // MBean object name\n" +#~ "\n" +#~ "StatisticsService stats = new StatisticsService(); // MBean " +#~ "implementation\n" +#~ "stats.setSessionFactory(sessionFactory); // Bind the stats to a " +#~ "SessionFactory\n" +#~ "server.registerMBean(stats, on); // Register the Mbean on the server" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[// MBean service registration for all SessionFactory's\n" +#~ "Hashtable tb = new Hashtable();\n" +#~ "tb.put(\"type\", \"statistics\");\n" +#~ "tb.put(\"sessionFactory\", \"all\");\n" +#~ "ObjectName on = new ObjectName(\"hibernate\", tb); // MBean object name\n" +#~ "\n" +#~ "StatisticsService stats = new StatisticsService(); // MBean " +#~ "implementation\n" +#~ "server.registerMBean(stats, on); // Register the MBean on the server]]>" +#~ msgstr "" +#~ "// MBean service registration for all SessionFactory's\n" +#~ "Hashtable tb = new Hashtable();\n" +#~ "tb.put(\"type\", \"statistics\");\n" +#~ "tb.put(\"sessionFactory\", \"all\");\n" +#~ "ObjectName on = new ObjectName(\"hibernate\", tb); // MBean object name\n" +#~ "\n" +#~ "StatisticsService stats = new StatisticsService(); // MBean " +#~ "implementation\n" +#~ "server.registerMBean(stats, on); // Register the MBean on the server" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Statistics stats = HibernateUtil.sessionFactory.getStatistics" +#~ "();\n" +#~ "\n" +#~ "double queryCacheHitCount = stats.getQueryCacheHitCount();\n" +#~ "double queryCacheMissCount = stats.getQueryCacheMissCount();\n" +#~ "double queryCacheHitRatio =\n" +#~ " queryCacheHitCount / (queryCacheHitCount + queryCacheMissCount);\n" +#~ "\n" +#~ "log.info(\"Query Hit ratio:\" + queryCacheHitRatio);\n" +#~ "\n" +#~ "EntityStatistics entityStats =\n" +#~ " stats.getEntityStatistics( Cat.class.getName() );\n" +#~ "long changes =\n" +#~ " entityStats.getInsertCount()\n" +#~ " + entityStats.getUpdateCount()\n" +#~ " + entityStats.getDeleteCount();\n" +#~ "log.info(Cat.class.getName() + \" changed \" + changes + \"times\" );]]>" +#~ msgstr "" +#~ "Statistics stats = HibernateUtil.sessionFactory.getStatistics();\n" +#~ "\n" +#~ "double queryCacheHitCount = stats.getQueryCacheHitCount();\n" +#~ "double queryCacheMissCount = stats.getQueryCacheMissCount();\n" +#~ "double queryCacheHitRatio =\n" +#~ " queryCacheHitCount / (queryCacheHitCount + queryCacheMissCount);\n" +#~ "\n" +#~ "log.info(\"Query Hit ratio:\" + queryCacheHitRatio);\n" +#~ "\n" +#~ "EntityStatistics entityStats =\n" +#~ " stats.getEntityStatistics( Cat.class.getName() );\n" +#~ "long changes =\n" +#~ " entityStats.getInsertCount()\n" +#~ " + entityStats.getUpdateCount()\n" +#~ " + entityStats.getDeleteCount();\n" +#~ "log.info(Cat.class.getName() + \" changed \" + changes + \"times\" );" Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/persistent_classes.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/persistent_classes.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/persistent_classes.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,1368 @@ +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# Language /mnt/hgfs/base/Hibernate/Reference translations for PACKAGE package. +# Copyright (C) 2006, 2007 Free Software Foundation, Inc. +# Automatically generated, 2006. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# +msgid "" +msgstr "" +"Project-Id-Version: Collection_Mapping\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2010-01-08T04:07:19\n" +"PO-Revision-Date: 2007-02-26 10:27+1000\n" +"Last-Translator: \n" +"Language-Team: <de(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.9.1\n" + +#. Tag: title +#, no-c-format +msgid "Persistent Classes" +msgstr "Persistente Klassen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Persistent classes are classes in an application that implement the entities " +"of the business problem (e.g. Customer and Order in an E-commerce " +"application). Not all instances of a persistent class are considered to be " +"in the persistent state. For example, an instance can instead be transient " +"or detached." +msgstr "" +"Unter persistenten Klassen versteht man diejenigen Klassen in einer " +"Anwendung, die die Entities des Unternehmensproblems (z.B. Kunde und " +"Bestellung in einer E-Commerce Applikation) implementieren. Nicht alle " +"Instanzen einer persistenten Klasse werden als im persistenten Status " +"befindlich angesehen - eine Instanz kann statt dessen auch kurzlebig " +"(\"transient\") oder abgesetzt (\"detached\") sein." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate works best if these classes follow some simple rules, also known " +"as the Plain Old Java Object (POJO) programming model. However, none of " +"these rules are hard requirements. Indeed, Hibernate3 assumes very little " +"about the nature of your persistent objects. You can express a domain model " +"in other ways (using trees of <literal>Map</literal> instances, for example)." +msgstr "" +"Hibernate funktioniert am besten, wenn diese Klassen einigen einfachen " +"Regeln folgen, die auch als \"Plain Old Java Object\" (POJO) " +"Programmiermodell bekannt sind. Keine dieser Regeln sind jedoch feste " +"Anforderungen. Tatsächlich setzt Hibernate3 sehr wenig hinsichtlich des " +"Charakters Ihrer persistenten Objekte voraus. Sie können ein Domain-Modell " +"auf andere Weise ausdrücken: Zum Beispiel unter Verwendung von <literal>Map</" +"literal>-Instanzen-Trees." + +#. Tag: title +#, no-c-format +msgid "A simple POJO example" +msgstr "Ein einfaches POJO-Beispiel" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Most Java applications require a persistent class representing felines. For " +"example:" +msgstr "" +"Die meisten Java-Anwendungen erfordern eine persistente Klasse, die Katzen " +"(\"felines\") repräsentiert." + +#. Tag: para +#, no-c-format +msgid "" +"The four main rules of persistent classes are explored in more detail in the " +"following sections." +msgstr "" + +#. Tag: title +#, no-c-format +msgid "Implement a no-argument constructor" +msgstr "Implementierung eines \"No-Argument\"-Konstruktors" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>Cat</literal> has a no-argument constructor. All persistent classes " +"must have a default constructor (which can be non-public) so that Hibernate " +"can instantiate them using <literal>Constructor.newInstance()</literal>. It " +"is recommended that you have a default constructor with at least " +"<emphasis>package</emphasis> visibility for runtime proxy generation in " +"Hibernate." +msgstr "" +"<literal>Cat</literal> besitzt einen \"No-Argument\"-Konstruktor. Alle " +"persistenten Klassen müssen über einen Standard-Konstruktor verfügen (der " +"nicht-öffentlich sein darf) damit Hibernate sie unter Verwendung von " +"<literal>Constructor.newInstance()</literal> instantiieren kann. Wir " +"empfehlen dringend den Einsatz eines Standard-Konstruktors, der zumindest " +"<emphasis>Paket</emphasis>-Sichtbarkeit für die Proxy-Generierung zur " +"Runtime in Hibernate besitzt." + +#. Tag: title +#, no-c-format +msgid "Provide an identifier property (optional)" +msgstr "Bereitstellung einer Bezeichner-Property (optional)" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>Cat</literal> has a property called <literal>id</literal>. This " +"property maps to the primary key column of a database table. The property " +"might have been called anything, and its type might have been any primitive " +"type, any primitive \"wrapper\" type, <literal>java.lang.String</literal> or " +"<literal>java.util.Date</literal>. If your legacy database table has " +"composite keys, you can use a user-defined class with properties of these " +"types (see the section on composite identifiers later in the chapter.)" +msgstr "" +"<literal>Cat</literal> besitzt eine Property mit Namen <literal>id</" +"literal>. Diese Property mappt zur Spalte des Primärschlüssels der " +"Datenbanktabelle. Die Property könnte auch einen beliebigen Namen tragen und " +"könnte irgendeinen primitiven Typ besitzen, etwa einen primitiven \"Wrapper" +"\"-Typ, <literal>java.lang.String</literal> oder <literal>java.util.Date</" +"literal>. (Falls Ihre Legacy-Datenbanktabelle zusammengesetzte Schlüssel " +"besitzt, können Sie sogar eine benutzerdefinierte Klasse mit Properties " +"dieser Typen verwenden - wir gehen in einem späteren Abschnitt auf " +"zusammengesetzte Bezeichner ein)." + +#. Tag: para +#, no-c-format +msgid "" +"The identifier property is strictly optional. You can leave them off and let " +"Hibernate keep track of object identifiers internally. We do not recommend " +"this, however." +msgstr "" +"Die Bezeichner-Property ist völlig optional. Sie können sie ausgeschaltet " +"lassen und Hibernate verfolgt die Objektbezeichner intern. Allerdings " +"empfehlen wir diese Einstellung nicht." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"In fact, some functionality is available only to classes that declare an " +"identifier property:" +msgstr "" +"Tatsächlich sind einige Funktionalitäten nur für Klassen mit deklarierter " +"Bezeichner-Property verfügbar:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Transitive reattachment for detached objects (cascade update or cascade " +"merge) - see <xref linkend=\"objectstate-transitive\" />" +msgstr "" +"Transitives Reattachment für abgesetzte Objekte (in Reihe erfolgende " +"Aktualisierung oder in Reihe erfolgendes Zusammenfügen (auch: \"Cascade " +"Update\" bzw. \"Cascade Merge\") - siehe" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>Session.saveOrUpdate()</literal>" +msgstr "Session.saveOrUpdate()" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>Session.merge()</literal>" +msgstr "Session.merge()" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"We recommend that you declare consistently-named identifier properties on " +"persistent classes and that you use a nullable (i.e., non-primitive) type." +msgstr "" +"Wir empfehlen die Deklarierung konsistent benannter Bezeichner-Properties " +"bei den persistenten Klassen. Ein nullbarer (\"nullable\" - d.h. nicht-" +"primitiver) Typ ist ebenfalls zu bevorzugen." + +#. Tag: title +#, no-c-format +msgid "Prefer non-final classes (optional)" +msgstr "Bevorzugung nicht-finaler Klassen (optional)" + +#. Tag: para +#, no-c-format +msgid "" +"A central feature of Hibernate, <emphasis>proxies</emphasis>, depends upon " +"the persistent class being either non-final, or the implementation of an " +"interface that declares all public methods." +msgstr "" +"Ein zentrales Feature von Hibernate, <emphasis>Proxies</emphasis>, hängt " +"davon ab, ob die persistente Klasse entweder nicht-final oder der alle " +"Methoden als öffentlich erklärenden Implemetierung eines Interface." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can persist <literal>final</literal> classes that do not implement an " +"interface with Hibernate. You will not, however, be able to use proxies for " +"lazy association fetching which will ultimately limit your options for " +"performance tuning." +msgstr "" +"Sie können <literal>final</literal>e Klassen, die kein Interface mit " +"Hibernate implementieren, persistieren, aber Sie werden keine Proxies für " +"das \"Lazy Fetching\" von Assoziationen (d.h. das Nachladen assoziierter " +"Objekte bei Bedarf) verwenden können - was Ihre Optionen bei der " +"Feinabstimmung der Performance einschränkt." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You should also avoid declaring <literal>public final</literal> methods on " +"the non-final classes. If you want to use a class with a <literal>public " +"final</literal> method, you must explicitly disable proxying by setting " +"<literal>lazy=\"false\"</literal>." +msgstr "" +"Sie sollten es vermeiden, <literal>public final</literal>-Methoden an den " +"nicht-finalen Klassen zu deklarieren. Wenn Sie eine Klasse mit einer " +"<literal>public final</literal>-Methode verwenden wollen, müssen Sie " +"Proxying durch Setzen von <literal>lazy=\"false\"</literal> explizit " +"deaktivieren." + +#. Tag: title +#, no-c-format +msgid "Declare accessors and mutators for persistent fields (optional)" +msgstr "" +"Zugriffsberechtigte und Mutatoren für persistente Felder deklarieren " +"(optional)" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>Cat</literal> declares accessor methods for all its persistent " +"fields. Many other ORM tools directly persist instance variables. It is " +"better to provide an indirection between the relational schema and internal " +"data structures of the class. By default, Hibernate persists JavaBeans style " +"properties and recognizes method names of the form <literal>getFoo</" +"literal>, <literal>isFoo</literal> and <literal>setFoo</literal>. If " +"required, you can switch to direct field access for particular properties." +msgstr "" +"<literal>Cat</literal> deklariert die Zugriffsberechtigungsmethoden für alle " +"seine persistenten Felder. Viele andere ORM-Tools persistieren " +"Instanzvariablen direkt. Unserer Ansicht nach ist es besser, eine " +"Indirektion zwischen dem relationalen Schema und internen Datenstrukturen " +"der Klasse bereitzustellen. In der Standardeinstellung persistiert Hibernate " +"Properties im JavaBeans-Stil und erkennt Methodennamen in der Form " +"<literal>getFoo</literal>, <literal>isFoo</literal> und <literal>setFoo</" +"literal>. Bei Bedarf können Sie für bestimmte Properties zu direktem " +"Feldzugriff wechseln." + +#. Tag: para +#, no-c-format +msgid "" +"Properties need <emphasis>not</emphasis> be declared public - Hibernate can " +"persist a property with a default, <literal>protected</literal> or " +"<literal>private</literal> get / set pair." +msgstr "" +"Properties müssen <emphasis>nicht</emphasis> als öffentlich deklariert " +"werden - Hibernate kann eine Property als <literal>protected</literal> oder " +"<literal>private</literal> \"Get\"-/ \"Set\"-Paar persistieren." + +#. Tag: title +#, no-c-format +msgid "Implementing inheritance" +msgstr "Implementierung der Vererbung" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A subclass must also observe the first and second rules. It inherits its " +"identifier property from the superclass, <literal>Cat</literal>. For example:" +msgstr "" +"Eine Subklasse muss ebenfalls die ersten und zweiten Regeln berücksichtigen. " +"Sie erbt ihre Bezeichner-Property von der Superklasse <literal>Cat</literal>." + +#. Tag: title +#, fuzzy, no-c-format +msgid "" +"Implementing <literal>equals()</literal> and <literal>hashCode()</literal>" +msgstr "" +"Sie müssen die <literal>equals()</literal> and <literal>hashCode()</literal>-" +"Methoden außer Kraft setzen, falls Sie" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You have to override the <literal>equals()</literal> and <literal>hashCode()" +"</literal> methods if you:" +msgstr "" +"Sie müssen die <literal>equals()</literal> and <literal>hashCode()</literal>-" +"Methoden außer Kraft setzen, falls Sie" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"intend to put instances of persistent classes in a <literal>Set</literal> " +"(the recommended way to represent many-valued associations); <emphasis>and</" +"emphasis>" +msgstr "" +"vorhaben, die Instanzen persistenter Klassen in einem <literal>Set</literal> " +"unterzubringen (die empfohlene Art mehrwertige Assoziationen zu " +"repräsentieren) <emphasis>und</emphasis>" + +#. Tag: para +#, no-c-format +msgid "intend to use reattachment of detached instances" +msgstr "planen, den Wiederanbindung abgesetzter Instanzen zu verwenden" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate guarantees equivalence of persistent identity (database row) and " +"Java identity only inside a particular session scope. When you mix instances " +"retrieved in different sessions, you must implement <literal>equals()</" +"literal> and <literal>hashCode()</literal> if you wish to have meaningful " +"semantics for <literal>Set</literal>s." +msgstr "" +"Hibernate garantiert nur die Äquivalenz der persistenten Identität " +"(Datenbankreihe) und der Java-Identität innerhalb eines bestimmten " +"Gültigkeitsbreichs einer Session. Sobald die Instanzen verschiedener " +"Sessions zusammenkommen, müssen <literal>equals()</literal> und " +"<literal>hashCode()</literal> implementiert werden, wenn wir uns eine " +"aussagekräftige Semantik für <literal>Set</literal>s wünschen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The most obvious way is to implement <literal>equals()</literal>/" +"<literal>hashCode()</literal> by comparing the identifier value of both " +"objects. If the value is the same, both must be the same database row, " +"because they are equal. If both are added to a <literal>Set</literal>, you " +"will only have one element in the <literal>Set</literal>). Unfortunately, " +"you cannot use that approach with generated identifiers. Hibernate will only " +"assign identifier values to objects that are persistent; a newly created " +"instance will not have any identifier value. Furthermore, if an instance is " +"unsaved and currently in a <literal>Set</literal>, saving it will assign an " +"identifier value to the object. If <literal>equals()</literal> and " +"<literal>hashCode()</literal> are based on the identifier value, the hash " +"code would change, breaking the contract of the <literal>Set</literal>. See " +"the Hibernate website for a full discussion of this problem. This is not a " +"Hibernate issue, but normal Java semantics of object identity and equality." +msgstr "" +"Die offensichtlichste Weise <literal>equals()</literal>/<literal>hashCode()</" +"literal> zu implementieren, ist mittels des Vergleichs des Bezeichnerwerts " +"beider Objekte. Ist der Wert identisch, so müssen die beiden sich in " +"derselben Datenbankreihe befinden und sind daher gleichwertig (werden beide " +"einem <literal>Set</literal> hinzugefügt, so existiert lediglich ein Element " +"im <literal>Set</literal>). Leider kann diese Vorgehensweise nicht bei " +"generierten Bezeichnern verwendet werden! Hibernate ordnet nur persistenten " +"Objekten Bezeichnerwerte zu, und eine neu erstellte Instanz wird keinen " +"Bezeichnerwert besitzen! Desweiteren wird einer noch ungespeicherten " +"Instanz, die Teil eines <literal>Set</literal> ist, bei Speicherung ein " +"Bezeichnerwert zum Objekt zugeordnet. Falls <literal>equals()</literal> und " +"<literal>hashCode()</literal> auf dem Bezeichnerwert basieren, so würde sich " +"der Hash-Code ändern und dadurch das Interface (sog. \"contract\") des " +"<literal>Set</literal> verletzen. Eine ausführliche Darstellung dieses " +"Problems finden Sie auf der Website von Hibernate. Bitte beachten Sie, dass " +"dies nicht auf Hibernate selbst zurückzuführen ist, sondern auf regulärer " +"Java-Semantik hinsichtlich Objektidentität und Gleichheit basiert." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"It is recommended that you implement <literal>equals()</literal> and " +"<literal>hashCode()</literal> using <emphasis>Business key equality</" +"emphasis>. Business key equality means that the <literal>equals()</literal> " +"method compares only the properties that form the business key. It is a key " +"that would identify our instance in the real world (a <emphasis>natural</" +"emphasis> candidate key):" +msgstr "" +"Wir empfehlen die Implementierung von <literal>equals()</literal> und " +"<literal>hashCode()</literal> unter Verwendung von <emphasis>\"Business Key " +"Equality\"</emphasis>. \"Business Key Equality\" bedeutet, dass die " +"<literal>equals()</literal>-Methode nur die Properties, aus denen sich der " +"\"Business Key\" zusammensetzt, miteinander vergleicht. Der Key (Schlüssel) " +"identifiziert Ihre Instanz in der Realität (ein <emphasis>natürlicher</" +"emphasis> Schlüsselkandidat bzw. \"Candidate Key\"):" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A business key does not have to be as solid as a database primary key " +"candidate (see <xref linkend=\"transactions-basics-identity\" />). Immutable " +"or unique properties are usually good candidates for a business key." +msgstr "" +"Bitte beachten Sie, dass ein \"Business Key\" nicht so beständig wie ein " +"Primärschlüsselkandidat der Datenbank sein muss (siehe <xref linkend=" +"\"transactions-basics-identity\"/>). Unveränderbare oder eindeutige " +"Properties sind in der Regel eine gute Wahl für einen Business Key." + +#. Tag: title +#, no-c-format +msgid "Dynamic models" +msgstr "Dynamische Modelle" + +#. Tag: title +#, no-c-format +msgid "Note" +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis>The following features are currently considered experimental and " +"may change in the near future.</emphasis>" +msgstr "" +"Bitte beachten Sie, dass die folgenden Features als experimentell gelten und " +"sich in naher Zukunft ändern können." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Persistent entities do not necessarily have to be represented as POJO " +"classes or as JavaBean objects at runtime. Hibernate also supports dynamic " +"models (using <literal>Map</literal>s of <literal>Map</literal>s at runtime) " +"and the representation of entities as DOM4J trees. With this approach, you " +"do not write persistent classes, only mapping files." +msgstr "" +"Persistente Entities müssen zur Runtime nicht unbedingt als POJO-Klassen " +"oder JavaBean-Objekte repräsentiert werden. Hibernate unterstützt auch " +"dynamische Modelle (unter Verwendung von <literal>Map</literal>s von " +"<literal>Map</literal>s zur Runtime) und die Repräsentation von Entities als " +"DOM4J-Trees. Bei dieser Vorgehensweise schreiben Sie keine persistenten " +"Klassen, sondern nur Mapping-Dateien." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"By default, Hibernate works in normal POJO mode. You can set a default " +"entity representation mode for a particular <literal>SessionFactory</" +"literal> using the <literal>default_entity_mode</literal> configuration " +"option (see <xref linkend=\"configuration-optional-properties\" />)." +msgstr "" +"In der Standardeinstellung arbeitet Hibernate im regulären POJO-Modus. Sie " +"können einen Standard-Entity-Repräsentationsmodus für eine bestimmte " +"<literal>SessionFactory</literal> unter Verwendung der " +"<literal>default_entity_mode</literal>-Konfigurationsoption einstellen " +"(siehe <xref linkend=\"configuration-optional-properties\"/>)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The following examples demonstrate the representation using <literal>Map</" +"literal>s. First, in the mapping file an <literal>entity-name</literal> has " +"to be declared instead of, or in addition to, a class name:" +msgstr "" +"Das folgende Beispiel stellt die Repräsentation unter Verwendung von " +"<literal>Map</literal>s dar. Zuerst muss in der Mapping-Datei ein " +"<literal>entity-name</literal> anstelle von (oder zusätzlich zu) einem " +"Klassennamen deklariert werden:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Even though associations are declared using target class names, the target " +"type of associations can also be a dynamic entity instead of a POJO." +msgstr "" +"Bitte bachten Sie, dass der Zieltyp einer Assoziation auch eine dynamische " +"Entity statt POJO sein kann, obwohl Assoziationen unter Verwendung von Ziel-" +"Klassennamen deklariert werden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"After setting the default entity mode to <literal>dynamic-map</literal> for " +"the <literal>SessionFactory</literal>, you can, at runtime, work with " +"<literal>Map</literal>s of <literal>Map</literal>s:" +msgstr "" +"Nachdem der Standard für den Entity-Modus auf <literal>dynamic-map</literal> " +"für die <literal>SessionFactory</literal> gesetzt ist, können wir zur " +"Runtime mit <literal>Map</literal>s von <literal>Map</literal>s arbeiten:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"One of the main advantages of dynamic mapping is quick turnaround time for " +"prototyping, without the need for entity class implementation. However, you " +"lose compile-time type checking and will likely deal with many exceptions at " +"runtime. As a result of the Hibernate mapping, the database schema can " +"easily be normalized and sound, allowing to add a proper domain model " +"implementation on top later on." +msgstr "" +"Die Vorteile des dynamischen Mappings liegen in der schnellen Durchlaufzeit " +"für Musteranwendungsverfahren (sog. \"Turnaround-Time\" für \"Prototyping\") " +"ohne die Notwendigkeit Entity-Klassen zu implementieren. Sie verlieren " +"jedoch durch die Typ-Prüfung Kompilierungszeit, und es ist wahrscheinlich, " +"dass es bei der Runtime zu zahlreichen Ausnahmemeldungen kommt. Dank des " +"Mappings von Hibernate kann das Datenbankschema bequem vereinheitlicht und " +"stabilisiert werden, so dass eine ordnungsgemäße Implementierung des Domain-" +"Modells später problemlos hinzugefügt werden kann." + +#. Tag: para +#, no-c-format +msgid "" +"Entity representation modes can also be set on a per <literal>Session</" +"literal> basis:" +msgstr "" +"Die Modi für die Entity Repräsentation können auch auf per <literal>Session</" +"literal>-Basis eingestellt werden:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Please note that the call to <literal>getSession()</literal> using an " +"<literal>EntityMode</literal> is on the <literal>Session</literal> API, not " +"the <literal>SessionFactory</literal>. That way, the new <literal>Session</" +"literal> shares the underlying JDBC connection, transaction, and other " +"context information. This means you do not have to call <literal>flush()</" +"literal> and <literal>close()</literal> on the secondary <literal>Session</" +"literal>, and also leave the transaction and connection handling to the " +"primary unit of work." +msgstr "" +"Bitte beachten Sie, dass der Aufruf <literal>getSession()</literal> unter " +"Verwendung von <literal>EntityMode</literal> am <literal>Session</literal>-" +"API und nicht an der <literal>SessionFactory</literal> erfolgt. Auf diese " +"Weise teilt sich die <literal>Session</literal> die zu Grunde liegende JDBC-" +"Verbindung, die Transaktion und andere Kontextinformationen. Das bedeutet, " +"dass Sie in der sekundären <literal>Session</literal> nicht <literal>flush()" +"</literal> und <literal>close()</literal> aufrufen müssen und auch die " +"Transaktion und Verbindung der primären Arbeitseinheit überlassen können." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"More information about the XML representation capabilities can be found in " +"<xref linkend=\"xml\" />." +msgstr "" +"Weitere Informationen zum Leistungsvermögen der XML-Repräsentation finden " +"Sie unter <xref linkend=\"xml\"/>." + +#. Tag: title +#, no-c-format +msgid "Tuplizers" +msgstr "Tuplizer" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>org.hibernate.tuple.Tuplizer</literal>, and its sub-interfaces, are " +"responsible for managing a particular representation of a piece of data " +"given that representation's <literal>org.hibernate.EntityMode</literal>. If " +"a given piece of data is thought of as a data structure, then a tuplizer is " +"the thing that 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. It also knows how to access the POJO properties " +"using the defined property accessors." +msgstr "" +"<literal>org.hibernate.tuple.Tuplizer</literal> und seine untergeordneten " +"Schnittstellen sind angesichts des <literal>org.hibernate.EntityMode</" +"literal> dieser Repräsentation für die Verwaltung eines bestimmten Teils der " +"Datenrepräsentation verantwortlich. Wenn man sich einen bestimmten Teil von " +"Daten als Datenstruktur vorstellt, so weiß der \"Tuplizer\" wie eine solche " +"Datenstruktur erstellt wird und wie Werte in eine solche extrahiert und " +"eingeführt werden. Beim POJO Entity-Modus zum Beispiel weiß der " +"entsprechende Tuplizer wie POJO durch den Konstruktor erstellt wird und wie " +"mittels definierter Property-Accessor-Methoden auf die POJO-Properties " +"zugegriffen wird. Es existieren auf hoher Ebene zwei Typen von Tuplizern, " +"die in den <literal>org.hibernate.tuple.entity.EntityTuplizer</literal> und " +"<literal>org.hibernate.tuple.component.ComponentTuplizer</literal> " +"Interfaces repräsentiert sind. <literal>EntityTuplizer</literal>s sind für " +"die Verwaltung der oben genannten Schnittstellen hinsichtlich der Entities " +"verantwortlich, während <literal>ComponentTuplizer</literal>s dasselbe für " +"Komponenten übernehmen." + +#. Tag: para +#, no-c-format +msgid "" +"There are two high-level types of Tuplizers, represented by the <literal>org." +"hibernate.tuple.entity.EntityTuplizer</literal> and <literal>org.hibernate." +"tuple.component.ComponentTuplizer</literal> interfaces. " +"<literal>EntityTuplizer</literal>s are responsible for managing the above " +"mentioned contracts in regards to entities, while " +"<literal>ComponentTuplizer</literal>s do the same for components." +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Users can also plug in their own tuplizers. Perhaps you require that a " +"<literal>java.util.Map</literal> implementation other than <literal>java." +"util.HashMap</literal> be used while in the dynamic-map entity-mode. Or " +"perhaps you need to define a different proxy generation strategy than the " +"one used by default. Both would be achieved by defining a custom tuplizer " +"implementation. Tuplizer definitions are attached to the entity or component " +"mapping they are meant to manage. Going back to the example of our customer " +"entity:" +msgstr "" +"Benutzer können auch ihre eigenen Tuplizer einbinden. Es ist möglich, dass " +"Sie während des \"dynamic-map\" Entity-Modus eine andere Implementierung von " +"<literal>java.util.Map</literal> als <literal>java.util.HashMap</literal> " +"benötigen oder eine andere Strategie für die Proxy-Generierung definieren " +"müssen als die im Standard vorgegebene. Beide würden durch die Definition " +"einer anwenderdefinierten Tuplizer-Implementierung erzielt. Tuplizer-" +"Definitionen sind der Entity oder dem Komponenten-Mapping hinzugefügt, die " +"sie verwalten sollen. Sehen wir uns noch einmal das Beispiel unserer Kunden-" +"Entity an:" + +#. Tag: title +#, fuzzy, no-c-format +msgid "EntityNameResolvers" +msgstr "EntityResolver" + +#. Tag: para +#, no-c-format +msgid "" +"The <interfacename>org.hibernate.EntityNameResolver</interfacename> " +"interface is a contract for resolving the entity name of a given entity " +"instance. The interface defines a single method " +"<methodname>resolveEntityName</methodname> which is passed the entity " +"instance and is expected to return the appropriate entity name (null is " +"allowed and would indicate that the resolver does not know how to resolve " +"the entity name of the given entity instance). Generally speaking, an " +"<interfacename>org.hibernate.EntityNameResolver</interfacename> is going to " +"be most useful in the case of dynamic models. One example might be using " +"proxied interfaces as your domain model. The hibernate test suite has an " +"example of this exact style of usage under the <package>org.hibernate.test." +"dynamicentity.tuplizer2</package>. Here is some of the code from that " +"package for illustration." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"In order to register an <interfacename>org.hibernate.EntityNameResolver</" +"interfacename> users must either:" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"Implement a custom Tupelizer implementing the " +"<methodname>getEntityNameResolvers</methodname> method (see <xref linkend=" +"\"persistent-classes-tuplizers\" />)." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"Register it with the <classname>org.hibernate.impl.SessionFactoryImpl</" +"classname> (which is the implementation class for <interfacename>org." +"hibernate.SessionFactory</interfacename>) using the " +"<methodname>registerEntityNameResolver</methodname> method." +msgstr "" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[package eg;\n" +#~ "import java.util.Set;\n" +#~ "import java.util.Date;\n" +#~ "\n" +#~ "public class Cat {\n" +#~ " private Long id; // identifier\n" +#~ "\n" +#~ " private Date birthdate;\n" +#~ " private Color color;\n" +#~ " private char sex;\n" +#~ " private float weight;\n" +#~ " private int litterId;\n" +#~ "\n" +#~ " private Cat mother;\n" +#~ " private Set kittens = new HashSet();\n" +#~ "\n" +#~ " private void setId(Long id) {\n" +#~ " this.id=id;\n" +#~ " }\n" +#~ " public Long getId() {\n" +#~ " return id;\n" +#~ " }\n" +#~ "\n" +#~ " void setBirthdate(Date date) {\n" +#~ " birthdate = date;\n" +#~ " }\n" +#~ " public Date getBirthdate() {\n" +#~ " return birthdate;\n" +#~ " }\n" +#~ "\n" +#~ " void setWeight(float weight) {\n" +#~ " this.weight = weight;\n" +#~ " }\n" +#~ " public float getWeight() {\n" +#~ " return weight;\n" +#~ " }\n" +#~ "\n" +#~ " public Color getColor() {\n" +#~ " return color;\n" +#~ " }\n" +#~ " void setColor(Color color) {\n" +#~ " this.color = color;\n" +#~ " }\n" +#~ "\n" +#~ " void setSex(char sex) {\n" +#~ " this.sex=sex;\n" +#~ " }\n" +#~ " public char getSex() {\n" +#~ " return sex;\n" +#~ " }\n" +#~ "\n" +#~ " void setLitterId(int id) {\n" +#~ " this.litterId = id;\n" +#~ " }\n" +#~ " public int getLitterId() {\n" +#~ " return litterId;\n" +#~ " }\n" +#~ "\n" +#~ " void setMother(Cat mother) {\n" +#~ " this.mother = mother;\n" +#~ " }\n" +#~ " public Cat getMother() {\n" +#~ " return mother;\n" +#~ " }\n" +#~ " void setKittens(Set kittens) {\n" +#~ " this.kittens = kittens;\n" +#~ " }\n" +#~ " public Set getKittens() {\n" +#~ " return kittens;\n" +#~ " }\n" +#~ " \n" +#~ " // addKitten not needed by Hibernate\n" +#~ " public void addKitten(Cat kitten) {\n" +#~ " kitten.setMother(this);\n" +#~ " kitten.setLitterId( kittens.size() ); \n" +#~ " kittens.add(kitten);\n" +#~ " }\n" +#~ "}]]>" +#~ msgstr "" +#~ "package eg;\n" +#~ "import java.util.Set;\n" +#~ "import java.util.Date;\n" +#~ "\n" +#~ "public class Cat {\n" +#~ " private Long id; // identifier\n" +#~ "\n" +#~ " private Date birthdate;\n" +#~ " private Color color;\n" +#~ " private char sex;\n" +#~ " private float weight;\n" +#~ " private int litterId;\n" +#~ "\n" +#~ " private Cat mother;\n" +#~ " private Set kittens = new HashSet();\n" +#~ "\n" +#~ " private void setId(Long id) {\n" +#~ " this.id=id;\n" +#~ " }\n" +#~ " public Long getId() {\n" +#~ " return id;\n" +#~ " }\n" +#~ "\n" +#~ " void setBirthdate(Date date) {\n" +#~ " birthdate = date;\n" +#~ " }\n" +#~ " public Date getBirthdate() {\n" +#~ " return birthdate;\n" +#~ " }\n" +#~ "\n" +#~ " void setWeight(float weight) {\n" +#~ " this.weight = weight;\n" +#~ " }\n" +#~ " public float getWeight() {\n" +#~ " return weight;\n" +#~ " }\n" +#~ "\n" +#~ " public Color getColor() {\n" +#~ " return color;\n" +#~ " }\n" +#~ " void setColor(Color color) {\n" +#~ " this.color = color;\n" +#~ " }\n" +#~ "\n" +#~ " void setSex(char sex) {\n" +#~ " this.sex=sex;\n" +#~ " }\n" +#~ " public char getSex() {\n" +#~ " return sex;\n" +#~ " }\n" +#~ "\n" +#~ " void setLitterId(int id) {\n" +#~ " this.litterId = id;\n" +#~ " }\n" +#~ " public int getLitterId() {\n" +#~ " return litterId;\n" +#~ " }\n" +#~ "\n" +#~ " void setMother(Cat mother) {\n" +#~ " this.mother = mother;\n" +#~ " }\n" +#~ " public Cat getMother() {\n" +#~ " return mother;\n" +#~ " }\n" +#~ " void setKittens(Set kittens) {\n" +#~ " this.kittens = kittens;\n" +#~ " }\n" +#~ " public Set getKittens() {\n" +#~ " return kittens;\n" +#~ " }\n" +#~ " \n" +#~ " // addKitten not needed by Hibernate\n" +#~ " public void addKitten(Cat kitten) {\n" +#~ " kitten.setMother(this);\n" +#~ "kitten.setLitterId( kittens.size() ); \n" +#~ " kittens.add(kitten);\n" +#~ " }\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[package eg;\n" +#~ "\n" +#~ "public class DomesticCat extends Cat {\n" +#~ " private String name;\n" +#~ "\n" +#~ " public String getName() {\n" +#~ " return name;\n" +#~ " }\n" +#~ " protected void setName(String name) {\n" +#~ " this.name=name;\n" +#~ " }\n" +#~ "}]]>" +#~ msgstr "" +#~ "package eg;\n" +#~ "\n" +#~ "public class DomesticCat extends Cat {\n" +#~ " private String name;\n" +#~ "\n" +#~ " public String getName() {\n" +#~ " return name;\n" +#~ " }\n" +#~ " protected void setName(String name) {\n" +#~ " this.name=name;\n" +#~ " }\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[public class Cat {\n" +#~ "\n" +#~ " ...\n" +#~ " public boolean equals(Object other) {\n" +#~ " if (this == other) return true;\n" +#~ " if ( !(other instanceof Cat) ) return false;\n" +#~ "\n" +#~ " final Cat cat = (Cat) other;\n" +#~ "\n" +#~ " if ( !cat.getLitterId().equals( getLitterId() ) ) return false;\n" +#~ " if ( !cat.getMother().equals( getMother() ) ) return false;\n" +#~ "\n" +#~ " return true;\n" +#~ " }\n" +#~ "\n" +#~ " public int hashCode() {\n" +#~ " int result;\n" +#~ " result = getMother().hashCode();\n" +#~ " result = 29 * result + getLitterId();\n" +#~ " return result;\n" +#~ " }\n" +#~ "\n" +#~ "}]]>" +#~ msgstr "" +#~ "public class Cat {\n" +#~ "\n" +#~ " ...\n" +#~ " public boolean equals(Object other) {\n" +#~ " if (this == other) return true;\n" +#~ " if ( !(other instanceof Cat) ) return false;\n" +#~ "\n" +#~ " final Cat cat = (Cat) other;\n" +#~ "\n" +#~ " if ( !cat.getLitterId().equals( getLitterId() ) ) return false;\n" +#~ " if ( !cat.getMother().equals( getMother() ) ) return false;\n" +#~ "\n" +#~ " return true;\n" +#~ " }\n" +#~ "\n" +#~ " public int hashCode() {\n" +#~ " int result;\n" +#~ " result = getMother().hashCode();\n" +#~ " result = 29 * result + getLitterId();\n" +#~ " return result;\n" +#~ " }\n" +#~ "\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<hibernate-mapping>\n" +#~ "\n" +#~ " <class entity-name=\"Customer\">\n" +#~ "\n" +#~ " <id name=\"id\"\n" +#~ " type=\"long\"\n" +#~ " column=\"ID\">\n" +#~ " <generator class=\"sequence\"/>\n" +#~ " </id>\n" +#~ "\n" +#~ " <property name=\"name\"\n" +#~ " column=\"NAME\"\n" +#~ " type=\"string\"/>\n" +#~ "\n" +#~ " <property name=\"address\"\n" +#~ " column=\"ADDRESS\"\n" +#~ " type=\"string\"/>\n" +#~ "\n" +#~ " <many-to-one name=\"organization\"\n" +#~ " column=\"ORGANIZATION_ID\"\n" +#~ " class=\"Organization\"/>\n" +#~ "\n" +#~ " <bag name=\"orders\"\n" +#~ " inverse=\"true\"\n" +#~ " lazy=\"false\"\n" +#~ " cascade=\"all\">\n" +#~ " <key column=\"CUSTOMER_ID\"/>\n" +#~ " <one-to-many class=\"Order\"/>\n" +#~ " </bag>\n" +#~ "\n" +#~ " </class>\n" +#~ " \n" +#~ "</hibernate-mapping>]]>" +#~ msgstr "" +#~ "<hibernate-mapping>\n" +#~ "\n" +#~ " <class entity-name=\"Customer\">\n" +#~ "\n" +#~ " <id name=\"id\"\n" +#~ " type=\"long\"\n" +#~ " column=\"ID\">\n" +#~ " <generator class=\"sequence\"/>\n" +#~ " </id>\n" +#~ "\n" +#~ " <property name=\"name\"\n" +#~ " column=\"NAME\"\n" +#~ " type=\"string\"/>\n" +#~ "\n" +#~ " <property name=\"address\"\n" +#~ " column=\"ADDRESS\"\n" +#~ " type=\"string\"/>\n" +#~ "\n" +#~ " <many-to-one name=\"organization\"\n" +#~ " column=\"ORGANIZATION_ID\"\n" +#~ " class=\"Organization\"/>\n" +#~ "\n" +#~ " <bag name=\"orders\"\n" +#~ " inverse=\"true\"\n" +#~ " lazy=\"false\"\n" +#~ " cascade=\"all\">\n" +#~ " <key column=\"CUSTOMER_ID\"/>\n" +#~ " <one-to-many class=\"Order\"/>\n" +#~ " </bag>\n" +#~ "\n" +#~ " </class>\n" +#~ " \n" +#~ "</hibernate-mapping>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Session s = openSession();\n" +#~ "Transaction tx = s.beginTransaction();\n" +#~ "Session s = openSession();\n" +#~ "\n" +#~ "// Create a customer\n" +#~ "Map david = new HashMap();\n" +#~ "david.put(\"name\", \"David\");\n" +#~ "\n" +#~ "// Create an organization\n" +#~ "Map foobar = new HashMap();\n" +#~ "foobar.put(\"name\", \"Foobar Inc.\");\n" +#~ "\n" +#~ "// Link both\n" +#~ "david.put(\"organization\", foobar);\n" +#~ "\n" +#~ "// Save both\n" +#~ "s.save(\"Customer\", david);\n" +#~ "s.save(\"Organization\", foobar);\n" +#~ "\n" +#~ "tx.commit();\n" +#~ "s.close();]]>" +#~ msgstr "" +#~ "Session s = openSession();\n" +#~ "Transaction tx = s.beginTransaction();\n" +#~ "Session s = openSession();\n" +#~ "\n" +#~ "// Create a customer\n" +#~ "Map david = new HashMap();\n" +#~ "david.put(\"name\", \"David\");\n" +#~ "\n" +#~ "// Create an organization\n" +#~ "Map foobar = new HashMap();\n" +#~ "foobar.put(\"name\", \"Foobar Inc.\");\n" +#~ "\n" +#~ "// Link both\n" +#~ "david.put(\"organization\", foobar);\n" +#~ "\n" +#~ "// Save both\n" +#~ "s.save(\"Customer\", david);\n" +#~ "s.save(\"Organization\", foobar);\n" +#~ "\n" +#~ "tx.commit();\n" +#~ "s.close();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Session dynamicSession = pojoSession.getSession(EntityMode." +#~ "MAP);\n" +#~ "\n" +#~ "// Create a customer\n" +#~ "Map david = new HashMap();\n" +#~ "david.put(\"name\", \"David\");\n" +#~ "dynamicSession.save(\"Customer\", david);\n" +#~ "...\n" +#~ "dynamicSession.flush();\n" +#~ "dynamicSession.close()\n" +#~ "...\n" +#~ "// Continue on pojoSession\n" +#~ "]]>" +#~ msgstr "" +#~ "Session dynamicSession = pojoSession.getSession(EntityMode.MAP);\n" +#~ "\n" +#~ "// Create a customer\n" +#~ "Map david = new HashMap();\n" +#~ "david.put(\"name\", \"David\");\n" +#~ "dynamicSession.save(\"Customer\", david);\n" +#~ "...\n" +#~ "dynamicSession.flush();\n" +#~ "dynamicSession.close()\n" +#~ "...\n" +#~ "// Continue on pojoSession" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<hibernate-mapping>\n" +#~ " <class entity-name=\"Customer\">\n" +#~ " \n" +#~ " <tuplizer entity-mode=\"dynamic-map\"\n" +#~ " class=\"CustomMapTuplizerImpl\"/>\n" +#~ "\n" +#~ " <id name=\"id\" type=\"long\" column=\"ID\">\n" +#~ " <generator class=\"sequence\"/>\n" +#~ " </id>\n" +#~ "\n" +#~ " \n" +#~ " ...\n" +#~ " </class>\n" +#~ "</hibernate-mapping>\n" +#~ "\n" +#~ "\n" +#~ "public class CustomMapTuplizerImpl\n" +#~ " extends org.hibernate.tuple.entity.DynamicMapEntityTuplizer {\n" +#~ " // override the buildInstantiator() method to plug in our custom " +#~ "map...\n" +#~ " protected final Instantiator buildInstantiator(\n" +#~ " org.hibernate.mapping.PersistentClass mappingInfo) {\n" +#~ " return new CustomMapInstantiator( mappingInfo );\n" +#~ " }\n" +#~ "\n" +#~ " private static final class CustomMapInstantiator\n" +#~ " extends org.hibernate.tuple.DynamicMapInstantitor {\n" +#~ " // override the generateMap() method to return our custom map...\n" +#~ " protected final Map generateMap() {\n" +#~ " return new CustomMap();\n" +#~ " }\n" +#~ " }\n" +#~ "}]]>" +#~ msgstr "" +#~ "<hibernate-mapping>\n" +#~ " <class entity-name=\"Customer\">\n" +#~ " \n" +#~ " <tuplizer entity-mode=\"dynamic-map\"\n" +#~ " class=\"CustomMapTuplizerImpl\"/>\n" +#~ "\n" +#~ " <id name=\"id\" type=\"long\" column=\"ID\">\n" +#~ " <generator class=\"sequence\"/>\n" +#~ " </id>\n" +#~ "\n" +#~ " \n" +#~ " ...\n" +#~ " </class>\n" +#~ "</hibernate-mapping>\n" +#~ "\n" +#~ "\n" +#~ "public class CustomMapTuplizerImpl\n" +#~ " extends org.hibernate.tuple.entity.DynamicMapEntityTuplizer {\n" +#~ " // override the buildInstantiator() method to plug in our custom " +#~ "map...\n" +#~ " protected final Instantiator buildInstantiator(\n" +#~ " org.hibernate.mapping.PersistentClass mappingInfo) {\n" +#~ " return new CustomMapInstantiator( mappingInfo );\n" +#~ " }\n" +#~ "\n" +#~ " private static final class CustomMapInstantiator\n" +#~ " extends org.hibernate.tuple.DynamicMapInstantitor {\n" +#~ " // override the generateMap() method to return our custom map...\n" +#~ " protected final Map generateMap() {\n" +#~ " return new CustomMap();\n" +#~ " }\n" +#~ " }\n" +#~ "}" Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/portability.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/portability.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/portability.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,506 @@ +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# Language /mnt/hgfs/base/Hibernate/Reference translations for PACKAGE package. +# Copyright (C) 2006, 2007 Free Software Foundation, Inc. +# Automatically generated, 2006. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# +msgid "" +msgstr "" +"Project-Id-Version: Collection_Mapping\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2010-01-08T04:07:19\n" +"PO-Revision-Date: 2007-02-26 10:27+1000\n" +"Last-Translator: \n" +"Language-Team: <de(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.9.1\n" + +#. Tag: title +#, fuzzy, no-c-format +msgid "Database Portability Considerations" +msgstr "Abgrenzung von Datenbanktransaktionen" + +#. Tag: title +#, no-c-format +msgid "Portability Basics" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"One of the selling points of Hibernate (and really Object/Relational Mapping " +"as a whole) is the notion of database portability. This could mean an " +"internal IT user migrating from one database vendor to another, or it could " +"mean a framework or deployable application consuming Hibernate to " +"simultaneously target multiple database products by their users. Regardless " +"of the exact scenario, the basic idea is that you want Hibernate to help you " +"run against any number of databases without changes to your code, and " +"ideally without any changes to the mapping metadata." +msgstr "" + +#. Tag: title +#, no-c-format +msgid "Dialect" +msgstr "Dialekt" + +#. Tag: para +#, no-c-format +msgid "" +"The first line of portability for Hibernate is the dialect, which is a " +"specialization of the <classname>org.hibernate.dialect.Dialect</classname> " +"contract. A dialect encapsulates all the differences in how Hibernate must " +"communicate with a particular database to accomplish some task like getting " +"a sequence value or structuring a SELECT query. Hibernate bundles a wide " +"range of dialects for many of the most popular databases. If you find that " +"your particular database is not among them, it is not terribly difficult to " +"write your own." +msgstr "" + +#. Tag: title +#, no-c-format +msgid "Dialect resolution" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"Originally, Hibernate would always require that users specify which dialect " +"to use. In the case of users looking to simultaneously target multiple " +"databases with their build that was problematic. Generally this required " +"their users to configure the Hibernate dialect or defining their own method " +"of setting that value." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"Starting with version 3.2, Hibernate introduced the notion of automatically " +"detecting the dialect to use based on the <interfacename>java.sql." +"DatabaseMetaData</interfacename> obtained from a <interfacename>java.sql." +"Connection</interfacename> to that database. This was much better, expect " +"that this resolution was limited to databases Hibernate know about ahead of " +"time and was in no way configurable or overrideable." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"Starting with version 3.3, Hibernate has a fare more powerful way to " +"automatically determine which dialect to should be used by relying on a " +"series of delegates which implement the <interfacename>org.hibernate.dialect." +"resolver.DialectResolver</interfacename> which defines only a single method:" +"<programlisting>public Dialect resolveDialect(DatabaseMetaData metaData) " +"throws JDBCConnectionException</programlisting>. The basic contract here is " +"that if the resolver 'understands' the given database metadata then it " +"returns the corresponding Dialect; if not it returns null and the process " +"continues to the next resolver. The signature also identifies " +"<exceptionname>org.hibernate.exception.JDBCConnectionException</" +"exceptionname> as possibly being thrown. A JDBCConnectionException here is " +"interpreted to imply a \"non transient\" (aka non-recoverable) connection " +"problem and is used to indicate an immediate stop to resolution attempts. " +"All other exceptions result in a warning and continuing on to the next " +"resolver." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"The cool part about these resolvers is that users can also register their " +"own custom resolvers which will be processed ahead of the built-in Hibernate " +"ones. This might be useful in a number of different situations: it allows " +"easy integration for auto-detection of dialects beyond those shipped with " +"HIbernate itself; it allows you to specify to use a custom dialect when a " +"particular database is recognized; etc. To register one or more resolvers, " +"simply specify them (seperated by commas, tabs or spaces) using the " +"'hibernate.dialect_resolvers' configuration setting (see the " +"<constant>DIALECT_RESOLVERS</constant> constant on <classname>org.hibernate." +"cfg.Environment</classname>)." +msgstr "" + +#. Tag: title +#, fuzzy, no-c-format +msgid "Identifier generation" +msgstr "Die \"Getter\"-Methode des Bezeichners" + +#. Tag: para +#, no-c-format +msgid "" +"When considering portability between databases, another important decision " +"is selecting the identifier generation stratagy you want to use. Originally " +"Hibernate provided the <emphasis>native</emphasis> generator for this " +"purpose, which was intended to select between a <emphasis>sequence</" +"emphasis>, <emphasis>identity</emphasis>, or <emphasis>table</emphasis> " +"strategy depending on the capability of the underlying database. However, an " +"insidious implication of this approach comes about when targtetting some " +"databases which support <emphasis>identity</emphasis> generation and some " +"which do not. <emphasis>identity</emphasis> generation relies on the SQL " +"definition of an IDENTITY (or auto-increment) column to manage the " +"identifier value; it is what is known as a post-insert generation strategy " +"becauase the insert must actually happen before we can know the identifier " +"value. Because Hibernate relies on this identifier value to uniquely " +"reference entities within a persistence context it must then issue the " +"insert immediately when the users requests the entitiy be associated with " +"the session (like via save() e.g.) regardless of current transactional " +"semantics. The underlying issue is that the semantics of the application " +"itself changes in these cases." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"Hibernate has been improved so that the insert is delayed in cases where " +"that is feasible." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"Starting with version 3.2.3, Hibernate comes with a set of <ulink url=" +"\"http://in.relation.to/2082.lace\">enhanced</ulink> identifier generators " +"targetting portability in a much different way." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"There are specifically 2 bundled <emphasis>enhanced</emphasis>generators:" +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<classname>org.hibernate.id.enhanced.SequenceStyleGenerator</classname>" +msgstr "org.hibernate.cache.TreeCacheProvider" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<classname>org.hibernate.id.enhanced.TableGenerator</classname>" +msgstr "org.hibernate.cache.TreeCacheProvider" + +#. Tag: para +#, no-c-format +msgid "" +"The idea behind these generators is to port the actual semantics of the " +"identifer value generation to the different databases. For example, the " +"<classname>org.hibernate.id.enhanced.SequenceStyleGenerator</classname> " +"mimics the behavior of a sequence on databases which do not support " +"sequences by using a table." +msgstr "" + +#. Tag: title +#, fuzzy, no-c-format +msgid "Database functions" +msgstr "Aggregierte Funktionen" + +#. Tag: para +#, no-c-format +msgid "" +"This is a new area in Hibernate and as such it is not as mature as the " +"overall Hibernate experience." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"SQL functions can be referenced in many ways by users. However, not all " +"databases support the same set of functions. Hibernate, provides a means of " +"mapping a <emphasis>logical</emphasis> function name to a a delegate which " +"knows how to render that particular function, perhaps even using a totally " +"different physical function call." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"Technically this function registration is handled through the <classname>org." +"hibernate.dialect.function.SQLFunctionRegistry</classname> class which is " +"intended to allow users to provide custom function definitions without " +"having to provide a custom dialect. This specific behavior is not fully " +"completed as of yet." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"It is sort of implemented such that users can programatically register " +"functions with the <classname>org.hibernate.cfg.Configuration</classname> " +"and those functions will be recognized for HQL." +msgstr "" + +#. Tag: title +#, no-c-format +msgid "Type mappings" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "This section scheduled for completion at a later date..." +msgstr "" Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/query_criteria.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/query_criteria.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/query_criteria.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,1151 @@ +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# Language /mnt/hgfs/base/Hibernate/Reference translations for PACKAGE package. +# Copyright (C) 2006, 2007 Free Software Foundation, Inc. +# Automatically generated, 2006. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# +msgid "" +msgstr "" +"Project-Id-Version: Collection_Mapping\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2009-12-03T00:15:27\n" +"PO-Revision-Date: 2007-02-26 10:27+1000\n" +"Last-Translator: \n" +"Language-Team: <de(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.9.1\n" + +#. Tag: title +#, no-c-format +msgid "Criteria Queries" +msgstr "\"Criteria Queries\"" + +#. Tag: para +#, no-c-format +msgid "Hibernate features an intuitive, extensible criteria query API." +msgstr "Hibernate besitzt eine intuitive, erweiterbare \"Criteria Query\"-API." + +#. Tag: title +#, fuzzy, no-c-format +msgid "Creating a <literal>Criteria</literal> instance" +msgstr "Das Erstellen einer Criteria-Instanz" + +#. Tag: para +#, no-c-format +msgid "" +"The interface <literal>org.hibernate.Criteria</literal> represents a query " +"against a particular persistent class. The <literal>Session</literal> is a " +"factory for <literal>Criteria</literal> instances." +msgstr "" +"Das Interface <literal>org.hibernate.Criteria</literal> repräsentiert eine " +"Anfrage an eine bestimmte persistente Klasse. Bei der <literal>Session</" +"literal> handelt es sich um eine Factory für <literal>Criteria</literal>-" +"Instanzen." + +#. Tag: title +#, no-c-format +msgid "Narrowing the result set" +msgstr "Den Ergebnissatz eingrenzen" + +#. Tag: para +#, no-c-format +msgid "" +"An individual query criterion is an instance of the interface <literal>org." +"hibernate.criterion.Criterion</literal>. The class <literal>org.hibernate." +"criterion.Restrictions</literal> defines factory methods for obtaining " +"certain built-in <literal>Criterion</literal> types." +msgstr "" +"Ein individuelles \"Query Criterion\" (Anfragenkriterium) ist eine Instanz " +"des Interface <literal>org.hibernate.criterion.Criterion</literal>. Die " +"Klasse <literal>org.hibernate.criterion.Restrictions</literal> definiert " +"Factory-Methoden, um bestimmte eingebaute <literal>Criterion</literal>-Typen " +"einzuholen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "Restrictions can be grouped logically." +msgstr "Einschränkungen können logisch gruppiert werden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"There are a range of built-in criterion types (<literal>Restrictions</" +"literal> subclasses). One of the most useful allows you to specify SQL " +"directly." +msgstr "" +"Es existiert eine ganze Reihe eingebauter \"Criterion\"-Typen " +"(<literal>Restrictions</literal>-Subklassen), aber einer ist besonders " +"hilfreich und ermöglicht es Ihnen, die SQL direkt zu spezifizieren." + +#. Tag: para +#, no-c-format +msgid "" +"The <literal>{alias}</literal> placeholder with be replaced by the row alias " +"of the queried entity." +msgstr "" +"Der <literal>{alias}</literal>-Platzhalter wird durch den Reihen-Alias der " +"angefragten Entity ersetzt." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can also obtain a criterion from a <literal>Property</literal> instance. " +"You can create a <literal>Property</literal> by calling <literal>Property." +"forName()</literal>:" +msgstr "" +"Eine andere Art an das Kriterium zu kommen ist über eine <literal>Property</" +"literal>-Instanz. Sie können eine <literal>Property</literal> erstellen, " +"indem Sie <literal>Property.forName()</literal> aufrufen." + +#. Tag: title +#, no-c-format +msgid "Ordering the results" +msgstr "Die Ergebnisse ordnen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can order the results using <literal>org.hibernate.criterion.Order</" +"literal>." +msgstr "" +"Sie können die Ergebnisse mit <literal>org.hibernate.criterion.Order</" +"literal> ordnen." + +#. Tag: title +#, no-c-format +msgid "Associations" +msgstr "Assoziationen" + +#. Tag: para +#, no-c-format +msgid "" +"By navigating associations using <literal>createCriteria()</literal> you can " +"specify constraints upon related entities:" +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The second <literal>createCriteria()</literal> returns a new instance of " +"<literal>Criteria</literal> that refers to the elements of the " +"<literal>kittens</literal> collection." +msgstr "" +"beachten Sie, dass das zweite <literal>createCriteria()</literal> mit einer " +"neuen Instanz von <literal>Criteria</literal> reagiert, die auf die Elemente " +"<literal>kittens</literal>-Collection verweist." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"There is also an alternate form that is useful in certain circumstances:" +msgstr "Die folgende Alternative ist unter bestimmten Umständen hilfreich." + +#. Tag: para +#, no-c-format +msgid "" +"(<literal>createAlias()</literal> does not create a new instance of " +"<literal>Criteria</literal>.)" +msgstr "" +"(<literal>createAlias()</literal> erstellt keine neue Instanz von " +"<literal>Criteria</literal>.)" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The kittens collections held by the <literal>Cat</literal> instances " +"returned by the previous two queries are <emphasis>not</emphasis> pre-" +"filtered by the criteria. If you want to retrieve just the kittens that " +"match the criteria, you must use a <literal>ResultTransformer</literal>." +msgstr "" +"Bitte beachten Sie, dass die in den <literal>Cat</literal>-Instanzen " +"enthaltenen \"kittens\"-Collections, die von den vorherigen zwei Anfragen " +"zurückgesendet wurden, <emphasis>nicht</emphasis> nicht durch die Kriterien " +"vorgefiltert werden! Falls Sie nur die \"Kittens\" erhalten wollen, auf die " +"die Kriterien zutreffen, so müssen Sie einen <literal>ResultTransformer</" +"literal> verwenden." + +#. Tag: title +#, no-c-format +msgid "Dynamic association fetching" +msgstr "Dynamischer Assoziationsabruf" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can specify association fetching semantics at runtime using " +"<literal>setFetchMode()</literal>." +msgstr "" +"Sie können die Semantik für den Assoziationsabruf während der Runtime mit " +"<literal>setFetchMode()</literal> spezifizieren." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This query will fetch both <literal>mate</literal> and <literal>kittens</" +"literal> by outer join. See <xref linkend=\"performance-fetching\" /> for " +"more information." +msgstr "" +"Diese Anfrage ruft sowohl <literal>mate</literal> als auch <literal>kittens</" +"literal> durch den äußeren Verbund (\"outer Join\") ab. Weitere " +"Informationen finden Sie unter <xref linkend=\"performance-fetching\"/>." + +#. Tag: title +#, no-c-format +msgid "Example queries" +msgstr "Beispielanfragen" + +#. Tag: para +#, no-c-format +msgid "" +"The class <literal>org.hibernate.criterion.Example</literal> allows you to " +"construct a query criterion from a given instance." +msgstr "" +"Mit der Klasse <literal>org.hibernate.criterion.Example</literal> können Sie " +"ein Anfragenkriterium aus einer gegebenen Instanz zu konstruieren." + +#. Tag: para +#, no-c-format +msgid "" +"Version properties, identifiers and associations are ignored. By default, " +"null valued properties are excluded." +msgstr "" +"Versions-Properties, Bezeichner und Assoziationen werden übergangen. In der " +"Standardeinstellung werden auch Properties mit dem Wert Null ausgeschlossen." + +#. Tag: para +#, no-c-format +msgid "You can adjust how the <literal>Example</literal> is applied." +msgstr "" +"Sie können anpassen, wie das <literal>Example</literal> angewendet wird." + +#. Tag: para +#, no-c-format +msgid "You can even use examples to place criteria upon associated objects." +msgstr "" +"Sie können sogar Beispiele verwenden, um Kriterien auf assoziierte Objekte " +"anzuwenden." + +#. Tag: title +#, no-c-format +msgid "Projections, aggregation and grouping" +msgstr "Projektionen, Aggregation und Gruppierung" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The class <literal>org.hibernate.criterion.Projections</literal> is a " +"factory for <literal>Projection</literal> instances. You can apply a " +"projection to a query by calling <literal>setProjection()</literal>." +msgstr "" +"Bei der Klasse <literal>org.hibernate.criterion.Projections</literal> " +"handelt es sich um eine Factory für <literal>Projection</literal>-Instanzen. " +"Eine Projektion wird auf eine Anfrage angewendet, indem man " +"<literal>setProjection()</literal> aufruft." + +#. Tag: para +#, no-c-format +msgid "" +"There is no explicit \"group by\" necessary in a criteria query. Certain " +"projection types are defined to be <emphasis>grouping projections</" +"emphasis>, which also appear in the SQL <literal>group by</literal> clause." +msgstr "" +"In einer \"Criteria Query\" ist kein explizites \"gruppieren nach\" " +"notwendig. Bestimmte Projektionstypen sind als " +"<emphasis>Gruppierungsprojektionen definiert</emphasis>, die auch in der SQL " +"<literal>group by</literal>-Klausel auftreten." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"An alias can be assigned to a projection so that the projected value can be " +"referred to in restrictions or orderings. Here are two different ways to do " +"this:" +msgstr "" +"Ein Alias kann auf Wunsch einer Projektion zugeordnet werden, so dass auf " +"den projezierten Wert in Einschränkungen oder Anordnungen verwiesen werden " +"kann. Es gibt zwei verschiedene Arten das zu tun:" + +#. Tag: para +#, no-c-format +msgid "" +"The <literal>alias()</literal> and <literal>as()</literal> methods simply " +"wrap a projection instance in another, aliased, instance of " +"<literal>Projection</literal>. As a shortcut, you can assign an alias when " +"you add the projection to a projection list:" +msgstr "" +"Die <literal>alias()</literal> und <literal>as()</literal>-Methoden wrappen " +"die Projektionsinstanzen in eine andere Alias-Instanz von " +"<literal>Projection</literal>. Als Tastenkürzel können Sie einen Alias " +"zuordnen, wenn Sie der Projektionsliste eine Projektion hinzufügen:" + +#. Tag: para +#, no-c-format +msgid "" +"You can also use <literal>Property.forName()</literal> to express " +"projections:" +msgstr "" +"Sie können auch <literal>Property.forName()</literal> verwenden, um " +"Projektionen auszudrücken:" + +#. Tag: title +#, no-c-format +msgid "Detached queries and subqueries" +msgstr "Abgesetzte Anfragen und Unteranfragen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>DetachedCriteria</literal> class allows you to create a query " +"outside the scope of a session and then execute it using an arbitrary " +"<literal>Session</literal>." +msgstr "" +"Die <literal>DetachedCriteria</literal>-Klasse ermöglicht es Ihnen, eine " +"Anfrage außerhalb des Gültigkeitsbereichs einer Session zu erstellen und sie " +"später unter Verwendung einer arbiträren <literal>Session</literal> " +"auszuführen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A <literal>DetachedCriteria</literal> can also be used to express a " +"subquery. Criterion instances involving subqueries can be obtained via " +"<literal>Subqueries</literal> or <literal>Property</literal>." +msgstr "" +"Ein <literal>DetachedCriteria</literal> kann auch dazu verwendet werden, " +"eine Anfrage auszudrücken. Instanzen eines Kriteriums können mittels " +"<literal>Subqueries</literal> oder <literal>Property</literal> erhalten " +"werden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "Correlated subqueries are also possible:" +msgstr "Sogar korrelierende Unteranfragen sind möglich:" + +#. Tag: title +#, no-c-format +msgid "Queries by natural identifier" +msgstr "Anfrage über natürlichen Bezeichner" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"For most queries, including criteria queries, the query cache is not " +"efficient because query cache invalidation occurs too frequently. However, " +"there is a special kind of query where you can optimize the cache " +"invalidation algorithm: lookups by a constant natural key. In some " +"applications, this kind of query occurs frequently. The criteria API " +"provides special provision for this use case." +msgstr "" +"Für die meisten Anfragen, einschließlich \"Criteria Queries\", ist das " +"Anfragen-Cache nicht sehr effizient, weil zu oft eine Aufhebung des Anfragen-" +"Caches stattfindet. Es gibt jedoch eine besondere Art der Anfrage, bei der " +"der Aufhebungsalgorithmus des Caches optimiert werden kann: Suchläufe nach " +"einem konstanten natürlichen Schlüssel. In einigen Anwendungen kommt diese " +"Art der Anfrage häufig vor. Die \"Criteria\"-API sorgt in diesem Fall " +"speziell vor." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"First, map the natural key of your entity using <literal><natural-id></" +"literal> and enable use of the second-level cache." +msgstr "" +"Als erstes sollten Sie den natürlichen Schlüssel Ihrer Entity unter " +"Verwendung von <literal><natural-id></literal> mappen und die " +"Verwendung des Caches der zweiten Ebene aktivieren." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This functionality is not intended for use with entities with " +"<emphasis>mutable</emphasis> natural keys." +msgstr "" +"Bitte beachten Sie, dass diese Funktionalität nicht für die Verwendung mit " +"Entities mit <emphasis>veränderlichen</emphasis> natürlichen Schlüsseln " +"vorgesehen ist." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Once you have enabled the Hibernate query cache, the <literal>Restrictions." +"naturalId()</literal> allows you to make use of the more efficient cache " +"algorithm." +msgstr "" +"Nun ermöglicht uns <literal>Restrictions.naturalId()</literal> die " +"Verwendung des effizienteren Cache-Algorithmus." + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Criteria crit = sess.createCriteria(Cat.class);\n" +#~ "crit.setMaxResults(50);\n" +#~ "List cats = crit.list();]]>" +#~ msgstr "" +#~ "Criteria crit = sess.createCriteria(Cat.class);\n" +#~ "crit.setMaxResults(50);\n" +#~ "List cats = crit.list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" +#~ " .add( Restrictions.like(\"name\", \"Fritz%\") )\n" +#~ " .add( Restrictions.between(\"weight\", minWeight, maxWeight) )\n" +#~ " .list();]]>" +#~ msgstr "" +#~ "List cats = sess.createCriteria(Cat.class)\n" +#~ " .add( Restrictions.like(\"name\", \"Fritz%\") )\n" +#~ " .add( Restrictions.between(\"weight\", minWeight, maxWeight) )\n" +#~ " .list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" +#~ " .add( Restrictions.like(\"name\", \"Fritz%\") )\n" +#~ " .add( Restrictions.or(\n" +#~ " Restrictions.eq( \"age\", new Integer(0) ),\n" +#~ " Restrictions.isNull(\"age\")\n" +#~ " ) )\n" +#~ " .list();]]>" +#~ msgstr "" +#~ "List cats = sess.createCriteria(Cat.class)\n" +#~ " .add( Restrictions.like(\"name\", \"Fritz%\") )\n" +#~ " .add( Restrictions.or(\n" +#~ " Restrictions.eq( \"age\", new Integer(0) ),\n" +#~ " Restrictions.isNull(\"age\")\n" +#~ " ) )\n" +#~ " .list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" +#~ " .add( Restrictions.in( \"name\", new String[] { \"Fritz\", \"Izi\", " +#~ "\"Pk\" } ) )\n" +#~ " .add( Restrictions.disjunction()\n" +#~ " .add( Restrictions.isNull(\"age\") )\n" +#~ " .add( Restrictions.eq(\"age\", new Integer(0) ) )\n" +#~ " .add( Restrictions.eq(\"age\", new Integer(1) ) )\n" +#~ " .add( Restrictions.eq(\"age\", new Integer(2) ) )\n" +#~ " ) )\n" +#~ " .list();]]>" +#~ msgstr "" +#~ "List cats = sess.createCriteria(Cat.class)\n" +#~ " .add( Restrictions.in( \"name\", new String[] { \"Fritz\", \"Izi\", " +#~ "\"Pk\" } ) )\n" +#~ " .add( Restrictions.disjunction()\n" +#~ " .add( Restrictions.isNull(\"age\") )\n" +#~ " .add( Restrictions.eq(\"age\", new Integer(0) ) )\n" +#~ " .add( Restrictions.eq(\"age\", new Integer(1) ) )\n" +#~ " .add( Restrictions.eq(\"age\", new Integer(2) ) )\n" +#~ " ) )\n" +#~ " .list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" +#~ " .add( Restrictions.sqlRestriction(\"lower({alias}.name) like lower(?)" +#~ "\", \"Fritz%\", Hibernate.STRING) )\n" +#~ " .list();]]>" +#~ msgstr "" +#~ "List cats = sess.createCriteria(Cat.class)\n" +#~ " .add( Restrictions.sqlRestriction(\"lower({alias}.name) like lower(?)" +#~ "\", \"Fritz%\", \n" +#~ " Hibernate.STRING) )\n" +#~ " .list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[\n" +#~ "Property age = Property.forName(\"age\");\n" +#~ "List cats = sess.createCriteria(Cat.class)\n" +#~ " .add( Restrictions.disjunction()\n" +#~ " .add( age.isNull() )\n" +#~ " .add( age.eq( new Integer(0) ) )\n" +#~ " .add( age.eq( new Integer(1) ) )\n" +#~ " .add( age.eq( new Integer(2) ) )\n" +#~ " ) )\n" +#~ " .add( Property.forName(\"name\").in( new String[] { \"Fritz\", \"Izi" +#~ "\", \"Pk\" } ) )\n" +#~ " .list();]]>" +#~ msgstr "" +#~ "Property age = Property.forName(\"age\");\n" +#~ "List cats = sess.createCriteria(Cat.class)\n" +#~ " .add( Restrictions.disjunction()\n" +#~ " .add( age.isNull() )\n" +#~ " .add( age.eq( new Integer(0) ) )\n" +#~ " .add( age.eq( new Integer(1) ) )\n" +#~ " .add( age.eq( new Integer(2) ) )\n" +#~ " ) )\n" +#~ " .add( Property.forName(\"name\").in( new String[] { \"Fritz\", \"Izi" +#~ "\", \"Pk\" } ) )\n" +#~ " .list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" +#~ " .add( Restrictions.like(\"name\", \"F%\")\n" +#~ " .addOrder( Order.asc(\"name\") )\n" +#~ " .addOrder( Order.desc(\"age\") )\n" +#~ " .setMaxResults(50)\n" +#~ " .list();]]>" +#~ msgstr "" +#~ "List cats = sess.createCriteria(Cat.class)\n" +#~ " .add( Restrictions.like(\"name\", \"F%\")\n" +#~ " .addOrder( Order.asc(\"name\") )\n" +#~ " .addOrder( Order.desc(\"age\") )\n" +#~ " .setMaxResults(50)\n" +#~ " .list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" +#~ " .add( Property.forName(\"name\").like(\"F%\") )\n" +#~ " .addOrder( Property.forName(\"name\").asc() )\n" +#~ " .addOrder( Property.forName(\"age\").desc() )\n" +#~ " .setMaxResults(50)\n" +#~ " .list();]]>" +#~ msgstr "" +#~ "List cats = sess.createCriteria(Cat.class)\n" +#~ " .add( Property.forName(\"name\").like(\"F%\") )\n" +#~ " .addOrder( Property.forName(\"name\").asc() )\n" +#~ " .addOrder( Property.forName(\"age\").desc() )\n" +#~ " .setMaxResults(50)\n" +#~ " .list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" +#~ " .add( Restrictions.like(\"name\", \"F%\") )\n" +#~ " .createCriteria(\"kittens\")\n" +#~ " .add( Restrictions.like(\"name\", \"F%\") )\n" +#~ " .list();]]>" +#~ msgstr "" +#~ "List cats = sess.createCriteria(Cat.class)\n" +#~ " .add( Restrictions.like(\"name\", \"F%\") )\n" +#~ " .createCriteria(\"kittens\")\n" +#~ " .add( Restrictions.like(\"name\", \"F%\") )\n" +#~ " .list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" +#~ " .createAlias(\"kittens\", \"kt\")\n" +#~ " .createAlias(\"mate\", \"mt\")\n" +#~ " .add( Restrictions.eqProperty(\"kt.name\", \"mt.name\") )\n" +#~ " .list();]]>" +#~ msgstr "" +#~ "List cats = sess.createCriteria(Cat.class)\n" +#~ " .createAlias(\"kittens\", \"kt\")\n" +#~ " .createAlias(\"mate\", \"mt\")\n" +#~ " .add( Restrictions.eqProperty(\"kt.name\", \"mt.name\") )\n" +#~ " .list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" +#~ " .createCriteria(\"kittens\", \"kt\")\n" +#~ " .add( Restrictions.eq(\"name\", \"F%\") )\n" +#~ " .setResultTransformer(Criteria.ALIAS_TO_ENTITY_MAP)\n" +#~ " .list();\n" +#~ "Iterator iter = cats.iterator();\n" +#~ "while ( iter.hasNext() ) {\n" +#~ " Map map = (Map) iter.next();\n" +#~ " Cat cat = (Cat) map.get(Criteria.ROOT_ALIAS);\n" +#~ " Cat kitten = (Cat) map.get(\"kt\");\n" +#~ "}]]>" +#~ msgstr "" +#~ "List cats = sess.createCriteria(Cat.class)\n" +#~ " .createCriteria(\"kittens\", \"kt\")\n" +#~ " .add( Restrictions.eq(\"name\", \"F%\") )\n" +#~ " .setResultTransformer(Criteria.ALIAS_TO_ENTITY_MAP)\n" +#~ " .list();\n" +#~ "Iterator iter = cats.iterator();\n" +#~ "while ( iter.hasNext() ) {\n" +#~ " Map map = (Map) iter.next();\n" +#~ " Cat cat = (Cat) map.get(Criteria.ROOT_ALIAS);\n" +#~ " Cat kitten = (Cat) map.get(\"kt\");\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" +#~ " .add( Restrictions.like(\"name\", \"Fritz%\") )\n" +#~ " .setFetchMode(\"mate\", FetchMode.EAGER)\n" +#~ " .setFetchMode(\"kittens\", FetchMode.EAGER)\n" +#~ " .list();]]>" +#~ msgstr "" +#~ "List cats = sess.createCriteria(Cat.class)\n" +#~ " .add( Restrictions.like(\"name\", \"Fritz%\") )\n" +#~ " .setFetchMode(\"mate\", FetchMode.EAGER)\n" +#~ " .setFetchMode(\"kittens\", FetchMode.EAGER)\n" +#~ " .list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Cat cat = new Cat();\n" +#~ "cat.setSex('F');\n" +#~ "cat.setColor(Color.BLACK);\n" +#~ "List results = session.createCriteria(Cat.class)\n" +#~ " .add( Example.create(cat) )\n" +#~ " .list();]]>" +#~ msgstr "" +#~ "Cat cat = new Cat();\n" +#~ "cat.setSex('F');\n" +#~ "cat.setColor(Color.BLACK);\n" +#~ "List results = session.createCriteria(Cat.class)\n" +#~ " .add( Example.create(cat) )\n" +#~ " .list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Example example = Example.create(cat)\n" +#~ " .excludeZeroes() //exclude zero valued properties\n" +#~ " .excludeProperty(\"color\") //exclude the property named \"color\"\n" +#~ " .ignoreCase() //perform case insensitive string " +#~ "comparisons\n" +#~ " .enableLike(); //use like for string comparisons\n" +#~ "List results = session.createCriteria(Cat.class)\n" +#~ " .add(example)\n" +#~ " .list();]]>" +#~ msgstr "" +#~ "Example example = Example.create(cat)\n" +#~ " .excludeZeroes() //exclude zero valued properties\n" +#~ " .excludeProperty(\"color\") //exclude the property named \"color\"\n" +#~ " .ignoreCase() //perform case insensitive string " +#~ "comparisons\n" +#~ " .enableLike(); //use like for string comparisons\n" +#~ "List results = session.createCriteria(Cat.class)\n" +#~ " .add(example)\n" +#~ " .list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[List results = session.createCriteria(Cat.class)\n" +#~ " .add( Example.create(cat) )\n" +#~ " .createCriteria(\"mate\")\n" +#~ " .add( Example.create( cat.getMate() ) )\n" +#~ " .list();]]>" +#~ msgstr "" +#~ "List results = session.createCriteria(Cat.class)\n" +#~ " .add( Example.create(cat) )\n" +#~ " .createCriteria(\"mate\")\n" +#~ " .add( Example.create( cat.getMate() ) )\n" +#~ " .list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[List results = session.createCriteria(Cat.class)\n" +#~ " .setProjection( Projections.rowCount() )\n" +#~ " .add( Restrictions.eq(\"color\", Color.BLACK) )\n" +#~ " .list();]]>" +#~ msgstr "" +#~ "List results = session.createCriteria(Cat.class)\n" +#~ " .setProjection( Projections.rowCount() )\n" +#~ " .add( Restrictions.eq(\"color\", Color.BLACK) )\n" +#~ " .list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[List results = session.createCriteria(Cat.class)\n" +#~ " .setProjection( Projections.projectionList()\n" +#~ " .add( Projections.rowCount() )\n" +#~ " .add( Projections.avg(\"weight\") )\n" +#~ " .add( Projections.max(\"weight\") )\n" +#~ " .add( Projections.groupProperty(\"color\") )\n" +#~ " )\n" +#~ " .list();]]>" +#~ msgstr "" +#~ "List results = session.createCriteria(Cat.class)\n" +#~ " .setProjection( Projections.projectionList()\n" +#~ " .add( Projections.rowCount() )\n" +#~ " .add( Projections.avg(\"weight\") )\n" +#~ " .add( Projections.max(\"weight\") )\n" +#~ " .add( Projections.groupProperty(\"color\") )\n" +#~ " )\n" +#~ " .list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[List results = session.createCriteria(Cat.class)\n" +#~ " .setProjection( Projections.alias( Projections.groupProperty(\"color" +#~ "\"), \"colr\" ) )\n" +#~ " .addOrder( Order.asc(\"colr\") )\n" +#~ " .list();]]>" +#~ msgstr "" +#~ "List results = session.createCriteria(Cat.class)\n" +#~ " .setProjection( Projections.alias( Projections.groupProperty(\"color" +#~ "\"), \"colr\" ) )\n" +#~ " .addOrder( Order.asc(\"colr\") )\n" +#~ " .list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[List results = session.createCriteria(Cat.class)\n" +#~ " .setProjection( Projections.groupProperty(\"color\").as(\"colr\") )\n" +#~ " .addOrder( Order.asc(\"colr\") )\n" +#~ " .list();]]>" +#~ msgstr "" +#~ "List results = session.createCriteria(Cat.class)\n" +#~ " .setProjection( Projections.groupProperty(\"color\").as(\"colr\") )\n" +#~ " .addOrder( Order.asc(\"colr\") )\n" +#~ " .list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[List results = session.createCriteria(Cat.class)\n" +#~ " .setProjection( Projections.projectionList()\n" +#~ " .add( Projections.rowCount(), \"catCountByColor\" )\n" +#~ " .add( Projections.avg(\"weight\"), \"avgWeight\" )\n" +#~ " .add( Projections.max(\"weight\"), \"maxWeight\" )\n" +#~ " .add( Projections.groupProperty(\"color\"), \"color\" )\n" +#~ " )\n" +#~ " .addOrder( Order.desc(\"catCountByColor\") )\n" +#~ " .addOrder( Order.desc(\"avgWeight\") )\n" +#~ " .list();]]>" +#~ msgstr "" +#~ "List results = session.createCriteria(Cat.class)\n" +#~ " .setProjection( Projections.projectionList()\n" +#~ " .add( Projections.rowCount(), \"catCountByColor\" )\n" +#~ " .add( Projections.avg(\"weight\"), \"avgWeight\" )\n" +#~ " .add( Projections.max(\"weight\"), \"maxWeight\" )\n" +#~ " .add( Projections.groupProperty(\"color\"), \"color\" )\n" +#~ " )\n" +#~ " .addOrder( Order.desc(\"catCountByColor\") )\n" +#~ " .addOrder( Order.desc(\"avgWeight\") )\n" +#~ " .list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[List results = session.createCriteria(Domestic.class, \"cat\")\n" +#~ " .createAlias(\"kittens\", \"kit\")\n" +#~ " .setProjection( Projections.projectionList()\n" +#~ " .add( Projections.property(\"cat.name\"), \"catName\" )\n" +#~ " .add( Projections.property(\"kit.name\"), \"kitName\" )\n" +#~ " )\n" +#~ " .addOrder( Order.asc(\"catName\") )\n" +#~ " .addOrder( Order.asc(\"kitName\") )\n" +#~ " .list();]]>" +#~ msgstr "" +#~ "List results = session.createCriteria(Domestic.class, \"cat\")\n" +#~ " .createAlias(\"kittens\", \"kit\")\n" +#~ " .setProjection( Projections.projectionList()\n" +#~ " .add( Projections.property(\"cat.name\"), \"catName\" )\n" +#~ " .add( Projections.property(\"kit.name\"), \"kitName\" )\n" +#~ " )\n" +#~ " .addOrder( Order.asc(\"catName\") )\n" +#~ " .addOrder( Order.asc(\"kitName\") )\n" +#~ " .list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[List results = session.createCriteria(Cat.class)\n" +#~ " .setProjection( Property.forName(\"name\") )\n" +#~ " .add( Property.forName(\"color\").eq(Color.BLACK) )\n" +#~ " .list();]]>" +#~ msgstr "" +#~ "List results = session.createCriteria(Cat.class)\n" +#~ " .setProjection( Property.forName(\"name\") )\n" +#~ " .add( Property.forName(\"color\").eq(Color.BLACK) )\n" +#~ " .list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[List results = session.createCriteria(Cat.class)\n" +#~ " .setProjection( Projections.projectionList()\n" +#~ " .add( Projections.rowCount().as(\"catCountByColor\") )\n" +#~ " .add( Property.forName(\"weight\").avg().as(\"avgWeight\") )\n" +#~ " .add( Property.forName(\"weight\").max().as(\"maxWeight\") )\n" +#~ " .add( Property.forName(\"color\").group().as(\"color\" )\n" +#~ " )\n" +#~ " .addOrder( Order.desc(\"catCountByColor\") )\n" +#~ " .addOrder( Order.desc(\"avgWeight\") )\n" +#~ " .list();]]>" +#~ msgstr "" +#~ "List results = session.createCriteria(Cat.class)\n" +#~ " .setProjection( Projections.projectionList()\n" +#~ " .add( Projections.rowCount().as(\"catCountByColor\") )\n" +#~ " .add( Property.forName(\"weight\").avg().as(\"avgWeight\") )\n" +#~ " .add( Property.forName(\"weight\").max().as(\"maxWeight\") )\n" +#~ " .add( Property.forName(\"color\").group().as(\"color\" )\n" +#~ " )\n" +#~ " .addOrder( Order.desc(\"catCountByColor\") )\n" +#~ " .addOrder( Order.desc(\"avgWeight\") )\n" +#~ " .list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[DetachedCriteria query = DetachedCriteria.forClass(Cat.class)\n" +#~ " .add( Property.forName(\"sex\").eq('F') );\n" +#~ " \n" +#~ "Session session = ....;\n" +#~ "Transaction txn = session.beginTransaction();\n" +#~ "List results = query.getExecutableCriteria(session).setMaxResults(100)." +#~ "list();\n" +#~ "txn.commit();\n" +#~ "session.close();]]>" +#~ msgstr "" +#~ "DetachedCriteria query = DetachedCriteria.forClass(Cat.class)\n" +#~ " .add( Property.forName(\"sex\").eq('F') );\n" +#~ " \n" +#~ "Session session = ....;\n" +#~ "Transaction txn = session.beginTransaction();\n" +#~ "List results = query.getExecutableCriteria(session).setMaxResults(100)." +#~ "list();\n" +#~ "txn.commit();\n" +#~ "session.close();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[DetachedCriteria avgWeight = DetachedCriteria.forClass(Cat." +#~ "class)\n" +#~ " .setProjection( Property.forName(\"weight\").avg() );\n" +#~ "session.createCriteria(Cat.class)\n" +#~ " .add( Property.forName(\"weight\").gt(avgWeight) )\n" +#~ " .list();]]>" +#~ msgstr "" +#~ "DetachedCriteria avgWeight = DetachedCriteria.forClass(Cat.class)\n" +#~ " .setProjection( Property.forName(\"weight\").avg() );\n" +#~ "session.createCriteria(Cat.class)\n" +#~ " .add( Property.forName(\"weight).gt(avgWeight) )\n" +#~ " .list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[DetachedCriteria weights = DetachedCriteria.forClass(Cat.class)\n" +#~ " .setProjection( Property.forName(\"weight\") );\n" +#~ "session.createCriteria(Cat.class)\n" +#~ " .add( Subqueries.geAll(\"weight\", weights) )\n" +#~ " .list();]]>" +#~ msgstr "" +#~ "DetachedCriteria weights = DetachedCriteria.forClass(Cat.class)\n" +#~ " .setProjection( Property.forName(\"weight\") );\n" +#~ "session.createCriteria(Cat.class)\n" +#~ " .add( Subqueries.geAll(\"weight\", weights) )\n" +#~ " .list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[DetachedCriteria avgWeightForSex = DetachedCriteria.forClass(Cat." +#~ "class, \"cat2\")\n" +#~ " .setProjection( Property.forName(\"weight\").avg() )\n" +#~ " .add( Property.forName(\"cat2.sex\").eqProperty(\"cat.sex\") );\n" +#~ "session.createCriteria(Cat.class, \"cat\")\n" +#~ " .add( Property.forName(\"weight\").gt(avgWeightForSex) )\n" +#~ " .list();]]>" +#~ msgstr "" +#~ "DetachedCriteria avgWeightForSex = DetachedCriteria.forClass(Cat.class, " +#~ "\"cat2\")\n" +#~ " .setProjection( Property.forName(\"weight\").avg() )\n" +#~ " .add( Property.forName(\"cat2.sex\").eqProperty(\"cat.sex\") );\n" +#~ "session.createCriteria(Cat.class, \"cat\")\n" +#~ " .add( Property.forName(\"weight).gt(avgWeightForSex) )\n" +#~ " .list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"User\">\n" +#~ " <cache usage=\"read-write\"/>\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"increment\"/>\n" +#~ " </id>\n" +#~ " <natural-id>\n" +#~ " <property name=\"name\"/>\n" +#~ " <property name=\"org\"/>\n" +#~ " </natural-id>\n" +#~ " <property name=\"password\"/>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"User\">\n" +#~ " <cache usage=\"read-write\"/>\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"increment\"/>\n" +#~ " </id>\n" +#~ " <natural-id>\n" +#~ " <property name=\"name\"/>\n" +#~ " <property name=\"org\"/>\n" +#~ " </natural-id>\n" +#~ " <property name=\"password\"/>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[session.createCriteria(User.class)\n" +#~ " .add( Restrictions.naturalId()\n" +#~ " .set(\"name\", \"gavin\")\n" +#~ " .set(\"org\", \"hb\") \n" +#~ " ).setCacheable(true)\n" +#~ " .uniqueResult();]]>" +#~ msgstr "" +#~ "session.createCriteria(User.class)\n" +#~ " .add( Restrictions.naturalId()\n" +#~ " .set(\"name\", \"gavin\")\n" +#~ " .set(\"org\", \"hb\") \n" +#~ " ).setCacheable(true)\n" +#~ " .uniqueResult();" Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/query_hql.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/query_hql.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/query_hql.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,2664 @@ +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# Language /mnt/hgfs/base/Hibernate/Reference translations for PACKAGE package. +# Copyright (C) 2006, 2007 Free Software Foundation, Inc. +# Automatically generated, 2006. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# +msgid "" +msgstr "" +"Project-Id-Version: Collection_Mapping\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2010-01-08T04:07:19\n" +"PO-Revision-Date: 2007-02-26 10:27+1000\n" +"Last-Translator: \n" +"Language-Team: <de(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.9.1\n" + +#. Tag: title +#, no-c-format +msgid "HQL: The Hibernate Query Language" +msgstr "HQL: Die \"Hibernate Query Language\"" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate uses a powerful query language (HQL) that is similar in appearance " +"to SQL. Compared with SQL, however, HQL is fully object-oriented and " +"understands notions like inheritance, polymorphism and association." +msgstr "" +"Hibernate ist mit einer sehr leistungsfähigen Anfragensprache ausgestattet, " +"die (mit Absicht) große Ähnlichkeit mit SQL besitzt. Aber lassen Sie sich " +"nicht durch die Syntax täuschen; HQL ist rein objektorientiert und versteht " +"Begriffe wie Vererbung, Polymorphismus und Assoziation." + +#. Tag: title +#, no-c-format +msgid "Case Sensitivity" +msgstr "Beachtung der Groß- und Kleinschreibung" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"With the exception of names of Java classes and properties, queries are case-" +"insensitive. So <literal>SeLeCT</literal> is the same as <literal>sELEct</" +"literal> is the same as <literal>SELECT</literal>, but <literal>org." +"hibernate.eg.FOO</literal> is not <literal>org.hibernate.eg.Foo</literal>, " +"and <literal>foo.barSet</literal> is not <literal>foo.BARSET</literal>." +msgstr "" +"Bei Anfragen ist die Groß- und Kleinschreibung irrelevant, außer es handelt " +"sich um Namen von Java-Klassen und Properties. Daher ist <literal>SeLeCT</" +"literal> dasselbe wie <literal>sELEct</literal> oder auch <literal>SELECT</" +"literal>, jedoch ist <literal>org.hibernate.eg.FOO</literal> nicht gleich " +"<literal>org.hibernate.eg.Foo</literal> und <literal>foo.barSet</literal> " +"ist nicht <literal>foo.BARSET</literal>." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This manual uses lowercase HQL keywords. Some users find queries with " +"uppercase keywords more readable, but this convention is unsuitable for " +"queries embedded in Java code." +msgstr "" +"Dieses Handbuch verwendet Kleinbuchstaben für HQL-Schlüsselbegriffe. Einige " +"Benutzer finden Anfragen, in denen die Schlüsselbegriffe in Großbuchstaben " +"geschrieben sind zwar lesbarer, jedoch finden wir das innerhalb von Java-" +"Code optisch nicht sehr ansprechend." + +#. Tag: title +#, no-c-format +msgid "The from clause" +msgstr "Die \"from\"-Klausel" + +#. Tag: para +#, no-c-format +msgid "The simplest possible Hibernate query is of the form:" +msgstr "Die einfachste Form der Hibernate-Anfrage lautet:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This returns all instances of the class <literal>eg.Cat</literal>. You do " +"not usually need to qualify the class name, since <literal>auto-import</" +"literal> is the default. For example:" +msgstr "" +"die einfach mit sämtlichen Instanzen der Klasse <literal>eg.Cat</literal> " +"reagiert. In der Regel muss der Klassenname nicht definiert werden, da die " +"Standardeinstellung <literal>auto-import</literal> lautet. Daher schreiben " +"wir in den meisten Fällen nur:" + +#. Tag: para +#, no-c-format +msgid "" +"In order to refer to the <literal>Cat</literal> in other parts of the query, " +"you will need to assign an <emphasis>alias</emphasis>. For example:" +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This query assigns the alias <literal>cat</literal> to <literal>Cat</" +"literal> instances, so you can use that alias later in the query. The " +"<literal>as</literal> keyword is optional. You could also write:" +msgstr "" +"Diese Anfrage ordnet den Alias <literal>cat</literal> den <literal>Cat</" +"literal>-Instanzen zu, so dass wir diesen Alias später in der Anfrage " +"verwendet können. Der <literal>as</literal>-Schlüsselbegriff ist optional; " +"wir könnten auch schreiben:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Multiple classes can appear, resulting in a cartesian product or \"cross\" " +"join." +msgstr "" +"Mehrere Klassen können erscheinen und zu einem kartesischen Produkt oder " +"Kreuzverbund (sog. \"Cross-Join\") führen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"It is good practice to name query aliases using an initial lowercase as this " +"is consistent with Java naming standards for local variables (e.g. " +"<literal>domesticCat</literal>)." +msgstr "" +"Es ist generell ratsam, Anfragen-Aliasse unter Verwendung eines kleinen " +"Anfangsbuchstabens zu beginnen, da dies den Namensgebungsstandards für " +"lokale Variablen bei Java entspricht (z.B. <literal>domesticCat</literal>)." + +#. Tag: title +#, no-c-format +msgid "Associations and joins" +msgstr "Assoziationen und Verbünde (\"Joins\")" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can also assign aliases to associated entities or to elements of a " +"collection of values using a <literal>join</literal>. For example:" +msgstr "" +"Man kann auch Aliasse assoziierten Entities oder sogar Elementen einer " +"Collection von Werten mittels <literal>join</literal> zuordnen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "The supported join types are borrowed from ANSI SQL:" +msgstr "Die unterstützten Verbundtypen wurden von ANSI SQL geborgt" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>inner join</literal>" +msgstr "oder als eine <literal>List</literal>," + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>left outer join</literal>" +msgstr "<literal>full join</literal> (in der Regel nicht sehr nützlich)" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>right outer join</literal>" +msgstr "right outer join" + +#. Tag: para +#, no-c-format +msgid "<literal>full join</literal> (not usually useful)" +msgstr "<literal>full join</literal> (in der Regel nicht sehr nützlich)" + +#. Tag: para +#, no-c-format +msgid "" +"The <literal>inner join</literal>, <literal>left outer join</literal> and " +"<literal>right outer join</literal> constructs may be abbreviated." +msgstr "" +"Die <literal>inner join</literal>, <literal>left outer join</literal> und " +"<literal>right outer join</literal>-Konstrukte können abgekürzt werden." + +#. Tag: para +#, no-c-format +msgid "" +"You may supply extra join conditions using the HQL <literal>with</literal> " +"keyword." +msgstr "" +"Sie können weitere Verbundbedingungen unter Verwendung des HQL-" +"Schlüsselbegriffs <literal>with</literal> eingeben." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A \"fetch\" join allows associations or collections of values to be " +"initialized along with their parent objects using a single select. This is " +"particularly useful in the case of a collection. It effectively overrides " +"the outer join and lazy declarations of the mapping file for associations " +"and collections. See <xref linkend=\"performance-fetching\" /> for more " +"information." +msgstr "" +"Desweiteren ermöglicht ein \"Abruf\"-Join die Initialisierung von " +"Assoziationen oder Collections von Werten samt deren übergeordneten Objekten " +"unter Verwendung einer einzelnen Auswahl (sog. \"single select\"). Dies ist " +"insbesondere im Zusammenhang mit Collections von Nutzen. Es setzt effektiv " +"den \"Outer-Join\" (Außenverbund) und \"lazy\" Deklarationen der Mapping-" +"Datei für Assoziationen und Collections außer Kraft. Weitere Informationen " +"finden Sie auch unter <xref linkend=\"performance-fetching\"/>." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A fetch join does not usually need to assign an alias, because the " +"associated objects should not be used in the <literal>where</literal> clause " +"(or any other clause). The associated objects are also not returned directly " +"in the query results. Instead, they may be accessed via the parent object. " +"The only reason you might need an alias is if you are recursively join " +"fetching a further collection:" +msgstr "" +"Ein Abruf-Join (sog. \"fetch join\") muss in der Regel keinen Alias " +"zuordnen, weil die zugehörigen Objekte nicht in der <literal>where</literal>-" +"Klausel (oder irgendeiner anderen Klausel) verwendet werden sollten. Die " +"assoziierten Objekte werden außerdem nicht direkt in den Anfragenergebnissen " +"wiedergegeben, sondern es wird via \"Parent\"-Objekt (d.h. dem " +"übergeordneten Objekt) auf diese zugegriffen. Der einzige Grund aus dem wir " +"einen Alias benötigen könnten ist, falls eine weitere Collection rekursiv " +"abgerufen werden soll:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>fetch</literal> construct cannot be used in queries called " +"using <literal>iterate()</literal> (though <literal>scroll()</literal> can " +"be used). <literal>Fetch</literal> should be used together with " +"<literal>setMaxResults()</literal> or <literal>setFirstResult()</literal>, " +"as these operations are based on the result rows which usually contain " +"duplicates for eager collection fetching, hence, the number of rows is not " +"what you would expect. <literal>Fetch</literal> should also not be used " +"together with impromptu <literal>with</literal> condition. It is possible to " +"create a cartesian product by join fetching more than one collection in a " +"query, so take care in this case. Join fetching multiple collection roles " +"can produce unexpected results for bag mappings, so user discretion is " +"advised when formulating queries in this case. Finally, note that " +"<literal>full join fetch</literal> and <literal>right join fetch</literal> " +"are not meaningful." +msgstr "" +"Beachten Sie, dass das <literal>fetch</literal>-Konstrukt nicht in Anfragen " +"verwendet werden kann, bei denen <literal>iterate()</literal> verwendet wird " +"(obwohl <literal>scroll()</literal> verwendet werden kann). Auch sollte " +"<literal>fetch</literal> nicht mit <literal>setMaxResults()</literal> oder " +"<literal>setFirstResult()</literal> benutzt werden, da diese Vorgänge auf " +"Ergebnisreihen basieren, die in der Regel Duplikate für den Collection-Abruf " +"nach \"eager\"-Art (d.h. dem zusammengefassten Laden von Objekt und " +"assoziierten Objekten mit Verbundoperationen) besitzen, und daher eine " +"unerwartete Anzahl von Reihen liefern. Die Verwendung von <literal>fetch</" +"literal> sollte auch in Verbindung mit einer ad hoc <literal>with</literal>-" +"Bedingung vermieden werden. Es ist möglich, ein kartesisches Produkt zu " +"erstellen, indem in einer Anfrage für mehr als eine Collection ein Join-" +"Abruf erfolgt, achten Sie also in diesem Fall darauf. Ein Join-Abruf " +"mehrerer Collection-Rollen führt manchmal zu unerwarteten Ergebnissen bei " +"\"Bag\"-Mappings, achten Sie also darauf, wie Sie Ihre Anfragen in diesem " +"Fall formulieren. <literal>full join fetch</literal> und <literal>right join " +"fetch</literal> sind nicht von Bedeutung." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If you are using property-level lazy fetching (with bytecode " +"instrumentation), it is possible to force Hibernate to fetch the lazy " +"properties in the first query immediately using <literal>fetch all " +"properties</literal>." +msgstr "" +"Falls Sie \"lazy\"-Fetching (d.h. das Nachladen assoziierter Objekte bei " +"Bedarf) auf Property-Ebene verwenden (mit Bytecode Instrumentierung), so " +"kann durchgesetzt werden, dass Hibernate die \"lazy\" Properties sofort (in " +"der ersten Anfrage) mittels <literal>fetch all properties</literal> abruft." + +#. Tag: title +#, no-c-format +msgid "Forms of join syntax" +msgstr "Formen der Verbundsyntax" + +#. Tag: para +#, no-c-format +msgid "" +"HQL supports two forms of association joining: <literal>implicit</literal> " +"and <literal>explicit</literal>." +msgstr "" +"HQL unterstützt zwei Arten von \"Association-Joining\": <literal>implicit</" +"literal> und <literal>explicit</literal>." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The queries shown in the previous section all use the <literal>explicit</" +"literal> form, that is, where the join keyword is explicitly used in the " +"from clause. This is the recommended form." +msgstr "" +"Die im vorherigen Abschnitt gezeigten Beispiele verwenden alle die " +"<literal>explicit</literal>-Form, bei der der \"Join\"-Schlüsselbegriff " +"explizit in der \"from\"-Klausel verwendet wird. Dieses ist die empfohlene " +"Form." + +#. Tag: para +#, no-c-format +msgid "" +"The <literal>implicit</literal> form does not use the join keyword. Instead, " +"the associations are \"dereferenced\" using dot-notation. <literal>implicit</" +"literal> joins can appear in any of the HQL clauses. <literal>implicit</" +"literal> join result in inner joins in the resulting SQL statement." +msgstr "" +"Die <literal>implicit</literal>-Form verwendet den \"Join\"-Schlüsselbegriff " +"nicht. Statt dessen sind die Assoziationen unter Verwendung von " +"Punktnotation \"dereferenziert\". <literal>implicit</literal>-Joins können " +"in jedem der HQL-Sätze erscheinen. <literal>implicit</literal>-Join-" +"Ergebnisse resultieren in \"inner Joins\" in der sich ergebenden SQL-" +"Anweisung." + +#. Tag: title +#, fuzzy, no-c-format +msgid "Referring to identifier property" +msgstr "Verweise auf die Bezeichner-Property" + +#. Tag: para +#, fuzzy, no-c-format +msgid "There are 2 ways to refer to an entity's identifier property:" +msgstr "" +"Es gibt im Wesentlichen 2 Arten, um auf die Bezeichner-Property einer Entity " +"zu verweisen:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The special property (lowercase) <literal>id</literal> may be used to " +"reference the identifier property of an entity <emphasis>provided that the " +"entity does not define a non-identifier property named id</emphasis>." +msgstr "" +"Die spezielle Property (Kleinbuchstaben) <literal>id</literal> kann " +"verwendet werden, um auf die Bezeichner-Property einer Entity zu verweisen " +"<emphasis> vorausgesetzt, dass diese Entity keine nicht-Bezeichner Property " +"mit Namen id definiert </emphasis>." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If the entity defines a named identifier property, you can use that property " +"name." +msgstr "" +"Falls die Entity eine benannte Bezeichner-Property definiert, können Sie " +"diesen Property-Namen verwenden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"References to composite identifier properties follow the same naming rules. " +"If the entity has a non-identifier property named id, the composite " +"identifier property can only be referenced by its defined named. Otherwise, " +"the special <literal>id</literal> property can be used to reference the " +"identifier property." +msgstr "" +"Verweise auf Properties von zusammengesetzten Bezeichnern folgen denselben " +"Namensgebungsregeln. Falls die Entity eine nicht-Bezeichner Property namens " +"id besitzt, so kann auf die Property des zusammengesetzten Bezeichners nur " +"mittels deren definiertem Namen verwiesen werden; andernfalls kann die " +"spezielle <literal>id</literal>-Property verwendet werden, um auf die " +"Bezeichner-Property zu verweisen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Please note that, starting in version 3.2.2, this has changed significantly. " +"In previous versions, <literal>id</literal> <emphasis>always</emphasis> " +"referred to the identifier property regardless of its actual name. A " +"ramification of that decision was that non-identifier properties named " +"<literal>id</literal> could never be referenced in Hibernate queries." +msgstr "" +"Hinweis: Dies hat sich seit Version 3.2.2 maßgeblich verändert. In früheren " +"Versionen verwies <literal>id</literal><emphasis>immer</emphasis> auf die " +"Bezeichner-Property, unabhängig vom tatsächlichen Namen. Eine Auswirkung " +"dieser Entscheidung war, dass in Hibernate Anfragen nie auf nicht-Bezeichner " +"Properties mit Namen <literal>id</literal> verwiesen werden konnte." + +#. Tag: title +#, no-c-format +msgid "The select clause" +msgstr "Die \"select\"-Klausel" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>select</literal> clause picks which objects and properties to " +"return in the query result set. Consider the following:" +msgstr "" +"Die <literal>select</literal>-Klausel entscheidet, welche Objekte und " +"Properties im Ergebnissatz der Anfrage erscheinen. Beachten Sie:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The query will select <literal>mate</literal>s of other <literal>Cat</" +"literal>s. You can express this query more compactly as:" +msgstr "" +"Die Anfrage wählt <literal>mate</literal>s anderer <literal>Cat</literal>s. " +"Sie können diese Anfrage sogar noch kompakter ausdrücken:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Queries can return properties of any value type including properties of " +"component type:" +msgstr "" +"Anfragen können Properties jeden Wertetyps, einschließlich Properties des " +"Komponententyps, wiedergeben:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Queries can return multiple objects and/or properties as an array of type " +"<literal>Object[]</literal>:" +msgstr "" +"Anfragen können mehrere Objekte und/oder Properties als Array vom Typ " +"<literal>Object[]</literal> wiedergeben," + +#. Tag: para +#, fuzzy, no-c-format +msgid "Or as a <literal>List</literal>:" +msgstr "oder als eine <literal>List</literal>," + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Or - assuming that the class <literal>Family</literal> has an appropriate " +"constructor - as an actual typesafe Java object:" +msgstr "" +"in der Annahme, dass die Klasse <literal>Family</literal> einen " +"entsprechenden Konstruktor besitzt." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can assign aliases to selected expressions using <literal>as</literal>:" +msgstr "" +"Unter Verwendung von <literal>as</literal> können Sie Aliasse gewählten " +"Ausdrücken zuordnen:" + +#. Tag: para +#, no-c-format +msgid "" +"This is most useful when used together with <literal>select new map</" +"literal>:" +msgstr "" +"Das ist besonders in Verbindung mit <literal>select new map</literal> " +"nützlich:" + +#. Tag: para +#, no-c-format +msgid "" +"This query returns a <literal>Map</literal> from aliases to selected values." +msgstr "" +"Diese Anfrage reagiert mit einer <literal>Map</literal> von Aliassen zu " +"gewählten Werten." + +#. Tag: title +#, no-c-format +msgid "Aggregate functions" +msgstr "Aggregierte Funktionen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"HQL queries can even return the results of aggregate functions on properties:" +msgstr "" +"HQL-Anfragen können sogar die Ergebnisse aggregierter Funktionen an " +"Properties zurücksenden:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "The supported aggregate functions are:" +msgstr "Die unterstützten aggregierten Funktionen sind " + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>avg(...), sum(...), min(...), max(...)</literal>" +msgstr "avg(...), sum(...), min(...), max(...)" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>count(*)</literal>" +msgstr "oder als eine <literal>List</literal>," + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>count(...), count(distinct ...), count(all...)</literal>" +msgstr "count(...), count(distinct ...), count(all...)" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can use arithmetic operators, concatenation, and recognized SQL " +"functions in the select clause:" +msgstr "" +"In der \"select\"-Klausel können Sie Rechenzeichen, Verkettung und " +"anerkannte SQL-Funktionen verwenden:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>distinct</literal> and <literal>all</literal> keywords can be " +"used and have the same semantics as in SQL." +msgstr "" +"Die <literal>distinct</literal> und <literal>all</literal>-Schlüsselbegriffe " +"können verwendet werden und besitzen dieselbe Semantik wie in SQL." + +#. Tag: title +#, no-c-format +msgid "Polymorphic queries" +msgstr "Polymorphe Anfragen" + +#. Tag: para +#, no-c-format +msgid "A query like:" +msgstr "Eine Anfrage wie:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"returns instances not only of <literal>Cat</literal>, but also of subclasses " +"like <literal>DomesticCat</literal>. Hibernate queries can name " +"<emphasis>any</emphasis> Java class or interface in the <literal>from</" +"literal> clause. The query will return instances of all persistent classes " +"that extend that class or implement the interface. The following query would " +"return all persistent objects:" +msgstr "" +"reagiert nicht nur mit Instanzen von <literal>Cat</literal>, sondern auch " +"Subklassen wie <literal>DomesticCat</literal>. Hibernate Anfragen können " +"eine <emphasis>beliebige</emphasis> Java-Klasse oder Interface in der " +"<literal>from</literal>-Klausel benennen. Die Anfrage reagiert mit Instanzen " +"aller persistenten Klassen, die diese Klasse erweitern oder das Interface " +"implementieren. Die folgende Anfrage würde mit allen persistenten Objekten " +"reagieren:" + +#. Tag: para +#, no-c-format +msgid "" +"The interface <literal>Named</literal> might be implemented by various " +"persistent classes:" +msgstr "" +"Das Interface <literal>Named</literal> könnte durch verschiedene persistente " +"Klassen implementiert werden:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"These last two queries will require more than one SQL <literal>SELECT</" +"literal>. This means that the <literal>order by</literal> clause does not " +"correctly order the whole result set. It also means you cannot call these " +"queries using <literal>Query.scroll()</literal>." +msgstr "" +"Bitte beachten Sie, dass für die letzten beiden Anfragen mehr als ein SQL " +"<literal>SELECT</literal> erforderlich ist. Das bedeutet, dass die " +"<literal>order by</literal>-Klausel den gesamten Ergebnissatz nicht korrekt " +"ordnet. (Es bedeutet auch, dass Sie diese Anfragen nicht mittels " +"<literal>Query.scroll()</literal> aufrufen können)." + +#. Tag: title +#, no-c-format +msgid "The where clause" +msgstr "Die \"where\"-Klausel" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>where</literal> clause allows you to refine the list of " +"instances returned. If no alias exists, you can refer to properties by name:" +msgstr "" +"Die <literal>where</literal>-Klausel erlaubt es Ihnen, die Liste der " +"erhaltenen Instanzen einzugrenzen. Falls kein Alias existiert, können Sie " +"namentlich auf die Properties verweisen:" + +#. Tag: para +#, no-c-format +msgid "If there is an alias, use a qualified property name:" +msgstr "" +"Falls ein Alias existiert, verwenden Sie einen vollständigen Property-Namen:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "This returns instances of <literal>Cat</literal> named 'Fritz'." +msgstr "reagiert mit Instanzen von 'Fritz' benannter <literal>Cat</literal>." + +#. Tag: para +#, no-c-format +msgid "The following query:" +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"returns all instances of <literal>Foo</literal> with an instance of " +"<literal>bar</literal> with a <literal>date</literal> property equal to the " +"<literal>startDate</literal> property of the <literal>Foo</literal>. " +"Compound path expressions make the <literal>where</literal> clause extremely " +"powerful. Consider the following:" +msgstr "" +"sendet sämtliche Instanzen von <literal>Foo</literal> zurück, für die eine " +"Instanz von <literal>bar</literal> mit einer <literal>date</literal>-" +"Property existiert, die gleich der <literal>startDate</literal>-Property von " +"<literal>Foo</literal> ist. Zusammengesetzte Pfadausdrücke machen die " +"<literal>where</literal>-Klausel sehr leistungsfähig. Ziehen Sie folgendes " +"in Betracht:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This query translates to an SQL query with a table (inner) join. For example:" +msgstr "" +"Diese Anfrage wird in eine SQL-Anfrage mit Tabellenverbund (inner join) " +"übersetzt. Falls Sie etwas wie das nachfolgende schreiben würden" + +#. Tag: para +#, fuzzy, no-c-format +msgid "would result in a query that would require four table joins in SQL." +msgstr "" +"so würden Sie eine Anfrage erhalten, die vier Tabellenverbünde (sog. \"table " +"joins\") in SQL benötigen würde." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>=</literal> operator can be used to compare not only " +"properties, but also instances:" +msgstr "" +"Mit dem <literal>=</literal>-Operator können nicht nur Properties, sondern " +"auch Instanzen verglichen werden:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The special property (lowercase) <literal>id</literal> can be used to " +"reference the unique identifier of an object. See <xref linkend=\"queryhql-" +"identifier-property\" /> for more information." +msgstr "" +"Die spezielle Property (Kleinbuchstaben) <literal>id</literal> kann " +"verwendet werden, um auf den eindeutigen Bezeichner eines Objekts zu " +"verweisen. Weitere Informationen finden Sie unter <xref linkend=\"queryhql-" +"identifier-property\"/>." + +#. Tag: para +#, fuzzy, no-c-format +msgid "The second query is efficient and does not require a table join." +msgstr "Die zweite Anfrage ist effizient. Kein Tabellenverbund wird benötigt!" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Properties of composite identifiers can also be used. Consider the following " +"example where <literal>Person</literal> has composite identifiers consisting " +"of <literal>country</literal> and <literal>medicareNumber</literal>:" +msgstr "" +"Properties zusammengesetzter Bezeichner können ebenfalls verwendet werden. " +"Nehmen wir an <literal>Person</literal> besitzt einen zusammengesetzten " +"Bezeichner, der aus <literal>country</literal> und <literal>medicareNumber</" +"literal> besteht. Auch in diesem Fall finden Sie weitere Informationen zu " +"Verweisen auf Bezeichner-Properties unter <xref linkend=\"queryhql-" +"identifier-property\"/>." + +#. Tag: para +#, fuzzy, no-c-format +msgid "Once again, the second query does not require a table join." +msgstr "Erneut benötigt die zweite Anfrage keinen Tabellenverbund." + +#. Tag: para +#, no-c-format +msgid "" +"See <xref linkend=\"queryhql-identifier-property\" /> for more information " +"regarding referencing identifier properties)" +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The special property <literal>class</literal> accesses the discriminator " +"value of an instance in the case of polymorphic persistence. A Java class " +"name embedded in the where clause will be translated to its discriminator " +"value." +msgstr "" +"Ebenso greift die spezielle Property <literal>class</literal> im Falle " +"polymorpher Persistenz auf den Diskriminatorwert einer Instanz zu. Ein in " +"der \"where\"-Klausel eingebetteter Java-Klassenname wird in seinen " +"Diskriminatorwert übersetzt." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can also use components or composite user types, or properties of said " +"component types. See <xref linkend=\"queryhql-components\" /> for more " +"information." +msgstr "" +"Sie können auch Komponenten oder zusammengesetzte Benutzertypen der besagten " +"Komponententypen verwenden. Weitere Informationen finden Sie unter <xref " +"linkend=\"queryhql-components\"/>." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"An \"any\" type has the special properties <literal>id</literal> and " +"<literal>class</literal> that allows you to express a join in the following " +"way (where <literal>AuditLog.item</literal> is a property mapped with " +"<literal><any></literal>):" +msgstr "" +"Ein \"any\"-Typ hat die speziellen Properties <literal>id</literal> und " +"<literal>class</literal>, wodurch ein Verbund auf folgende Weise ausgedrückt " +"werden kann (wo <literal>AuditLog.item</literal> eine mit <literal><" +"any></literal> gemappte Property ist)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>log.item.class</literal> and <literal>payment.class</literal> " +"would refer to the values of completely different database columns in the " +"above query." +msgstr "" +"Bitte beachten Sie, dass <literal>log.item.class</literal> und " +"<literal>payment.class</literal> auf Werte völlig unterschiedlicher " +"Datenbankspalten in der obigen Anfrage verweisen würden." + +#. Tag: title +#, no-c-format +msgid "Expressions" +msgstr "Ausdrücke" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Expressions used in the <literal>where</literal> clause include the " +"following:" +msgstr "" +"Die in der <literal>where</literal>-Klausel erlaubten Ausdrücke beinhalten " +"die meisten Dinge, die in SQL geschrieben werden können:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "mathematical operators: <literal>+, -, *, /</literal>" +msgstr "mathematische Operatoren <literal>+, -, *, /</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"binary comparison operators: <literal>=, >=, <=, <>, !=, like</" +"literal>" +msgstr "" +"binäre Vergleichsoperatoren <literal>=, >=, <=, <>, !=, like</" +"literal>" + +#. Tag: para +#, no-c-format +msgid "logical operations <literal>and, or, not</literal>" +msgstr "logische Vorgänge <literal>and, or, not</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "Parentheses <literal>( )</literal> that indicates grouping" +msgstr "Runde Klammern <literal>( )</literal>, Gruppierung anzeigend" + +#. Tag: para +#, no-c-format +msgid "" +"<literal>in</literal>, <literal>not in</literal>, <literal>between</" +"literal>, <literal>is null</literal>, <literal>is not null</literal>, " +"<literal>is empty</literal>, <literal>is not empty</literal>, " +"<literal>member of</literal> and <literal>not member of</literal>" +msgstr "" +"<literal>in</literal>, <literal>not in</literal>, <literal>between</" +"literal>, <literal>is null</literal>, <literal>is not null</literal>, " +"<literal>is empty</literal>, <literal>is not empty</literal>, " +"<literal>member of</literal> and <literal>not member of</literal>" + +#. Tag: para +#, no-c-format +msgid "" +"\"Simple\" case, <literal>case ... when ... then ... else ... end</literal>, " +"and \"searched\" case, <literal>case when ... then ... else ... end</literal>" +msgstr "" +"\"Einfacher\" Fall <literal>case ... when ... then ... else ... end</" +"literal>, und \"gesuchter\" Fall <literal>case when ... then ... else ... " +"end</literal>" + +#. Tag: para +#, no-c-format +msgid "" +"string concatenation <literal>...||...</literal> or <literal>concat(...,...)" +"</literal>" +msgstr "" +"String-Verkettung <literal>...||...</literal> oder <literal>concat(...,...)</" +"literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>current_date()</literal>, <literal>current_time()</literal>, and " +"<literal>current_timestamp()</literal>" +msgstr "" +"<literal>current_date()</literal>, <literal>current_time()</literal>, " +"<literal>current_timestamp()</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>second(...)</literal>, <literal>minute(...)</literal>, <literal>hour" +"(...)</literal>, <literal>day(...)</literal>, <literal>month(...)</literal>, " +"and <literal>year(...)</literal>" +msgstr "" +"<literal>second(...)</literal>, <literal>minute(...)</literal>, <literal>hour" +"(...)</literal>, <literal>day(...)</literal>, <literal>month(...)</literal>, " +"<literal>year(...)</literal>," + +#. Tag: para +#, no-c-format +msgid "" +"Any function or operator defined by EJB-QL 3.0: <literal>substring(), trim" +"(), lower(), upper(), length(), locate(), abs(), sqrt(), bit_length(), mod()" +"</literal>" +msgstr "" +"Jede Funktion oder Operator definiert durch EJB-QL 3.0: <literal>substring" +"(), trim(), lower(), upper(), length(), locate(), abs(), sqrt(), bit_length" +"(), mod()</literal>" + +#. Tag: para +#, no-c-format +msgid "<literal>coalesce()</literal> and <literal>nullif()</literal>" +msgstr "<literal>coalesce()</literal> und <literal>nullif()</literal>" + +#. Tag: para +#, no-c-format +msgid "" +"<literal>str()</literal> for converting numeric or temporal values to a " +"readable string" +msgstr "" +"<literal>str()</literal> zur Konvertierung numerischer oder temporärer Werte " +"in einen lesbaren String" + +#. Tag: para +#, no-c-format +msgid "" +"<literal>cast(... as ...)</literal>, where the second argument is the name " +"of a Hibernate type, and <literal>extract(... from ...)</literal> if ANSI " +"<literal>cast()</literal> and <literal>extract()</literal> is supported by " +"the underlying database" +msgstr "" +"<literal>cast(... as ...)</literal>, wo ein zweites Argument der Name eines " +"Hibernate-Typs ist und <literal>extract(... from ...)</literal>, wenn ANSI " +"<literal>cast()</literal> und <literal>extract()</literal> von der zu Grunde " +"liegenden Datenbank unterstützt werden" + +#. Tag: para +#, no-c-format +msgid "" +"the HQL <literal>index()</literal> function, that applies to aliases of a " +"joined indexed collection" +msgstr "" +"die HQL <literal>index()</literal>-Funktion, die für Aliasse eine " +"verbundenen indizierten Collection gilt " + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"HQL functions that take collection-valued path expressions: <literal>size(), " +"minelement(), maxelement(), minindex(), maxindex()</literal>, along with the " +"special <literal>elements()</literal> and <literal>indices</literal> " +"functions that can be quantified using <literal>some, all, exists, any, in</" +"literal>." +msgstr "" +"HQL-Funktionen, die Collection-wertige Pfadausdrücke annehmen: <literal>size" +"(), minelement(), maxelement(), minindex(), maxindex()</literal> sowie die " +"speziellen <literal>elements()</literal> und <literal>indices</literal>-" +"Funktionen, die mittels <literal>some, all, exists, any, in</literal> " +"gemessen werden können." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Any database-supported SQL scalar function like <literal>sign()</literal>, " +"<literal>trunc()</literal>, <literal>rtrim()</literal>, and <literal>sin()</" +"literal>" +msgstr "" +"Jede von der Datenbank unterstützte SQL-Skalarfunktion wie <literal>sign()</" +"literal>, <literal>trunc()</literal>, <literal>rtrim()</literal>, " +"<literal>sin()</literal>" + +#. Tag: para +#, no-c-format +msgid "JDBC-style positional parameters <literal>?</literal>" +msgstr "Positionelle Parameter im JDBC-Stil <literal>?</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"named parameters <literal>:name</literal>, <literal>:start_date</literal>, " +"and <literal>:x1</literal>" +msgstr "" +"benannte Parameter <literal>:name</literal>, <literal>:start_date</literal>, " +"<literal>:x1</literal>" + +#. Tag: para +#, no-c-format +msgid "" +"SQL literals <literal>'foo'</literal>, <literal>69</literal>, <literal>6.66E" +"+2</literal>, <literal>'1970-01-01 10:00:01.0'</literal>" +msgstr "" +"SQL-Literale <literal>'foo'</literal>, <literal>69</literal>, <literal>6.66E" +"+2</literal>, <literal>'1970-01-01 10:00:01.0'</literal>" + +#. Tag: para +#, no-c-format +msgid "" +"Java <literal>public static final</literal> constants <literal>eg.Color." +"TABBY</literal>" +msgstr "" +"Java <literal>public static final</literal>-Konstanten <literal>eg.Color." +"TABBY</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>in</literal> and <literal>between</literal> can be used as follows:" +msgstr "" +"<literal>in</literal> und <literal>between</literal> können wie folgt " +"verwendet werden:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "The negated forms can be written as follows:" +msgstr "und die negierten Formen können geschrieben werden" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Similarly, <literal>is null</literal> and <literal>is not null</literal> can " +"be used to test for null values." +msgstr "" +"Ebenso können <literal>is null</literal> und <literal>is not null</literal> " +"verwendet werden, um auf Nullwerte zu prüfen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Booleans can be easily used in expressions by declaring HQL query " +"substitutions in Hibernate configuration:" +msgstr "" +"Booleans können ganz einfach in Ausdrücken verwendet werden, indem man in " +"der Hibernate Konfiguration HQL-Anfragesubstitutionen deklariert:" + +#. Tag: para +#, no-c-format +msgid "" +"This will replace the keywords <literal>true</literal> and <literal>false</" +"literal> with the literals <literal>1</literal> and <literal>0</literal> in " +"the translated SQL from this HQL:" +msgstr "" +"Das ersetzt die Schlüsselbegriffe <literal>true</literal> und " +"<literal>false</literal> durch die Literale <literal>1</literal> und " +"<literal>0</literal> in der aus dieser HQL übersetzten SQL:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can test the size of a collection with the special property " +"<literal>size</literal> or the special <literal>size()</literal> function." +msgstr "" +"Sie können die Größe einer Collection mit der speziellen Property " +"<literal>size</literal> oder der speziellen <literal>size()</literal>-" +"Funktion überprüfen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"For indexed collections, you can refer to the minimum and maximum indices " +"using <literal>minindex</literal> and <literal>maxindex</literal> functions. " +"Similarly, you can refer to the minimum and maximum elements of a collection " +"of basic type using the <literal>minelement</literal> and " +"<literal>maxelement</literal> functions. For example:" +msgstr "" +"Für indizierte Collections können Sie auf den minimalen und den maximalen " +"Index verweisen, indem Sie die <literal>minindex</literal> und " +"<literal>maxindex</literal>-Funktionen verwenden. Ähnlich können Sie auch " +"auf die minimalen und maximalen Elemente einer Collection des Grundtyps " +"mittels <literal>minelement</literal> und <literal>maxelement</literal>-" +"Funktionen verweisen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The SQL functions <literal>any, some, all, exists, in</literal> are " +"supported when passed the element or index set of a collection " +"(<literal>elements</literal> and <literal>indices</literal> functions) or " +"the result of a subquery (see below):" +msgstr "" +"Die SQL-Funktionen <literal>any, some, all, exists, in</literal> werden " +"unterstützt, wenn an den Element- oder Indexsatz einer Collection " +"(<literal>elements</literal> und <literal>indices</literal>-Funktionen) oder " +"das Ergebnis einer Unteranfrage gegeben (siehe unten)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Note that these constructs - <literal>size</literal>, <literal>elements</" +"literal>, <literal>indices</literal>, <literal>minindex</literal>, " +"<literal>maxindex</literal>, <literal>minelement</literal>, " +"<literal>maxelement</literal> - can only be used in the where clause in " +"Hibernate3." +msgstr "" +"Bitte beachten Sie, dass folgende Konstrukte - <literal>size</literal>, " +"<literal>elements</literal>, <literal>indices</literal>, <literal>minindex</" +"literal>, <literal>maxindex</literal>, <literal>minelement</literal>, " +"<literal>maxelement</literal> - in Hibernate3 nur in der \"where\"-Klausel " +"verwendet werden können." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Elements of indexed collections (arrays, lists, and maps) can be referred to " +"by index in a where clause only:" +msgstr "" +"Auf Elemente indizierter Collections (Arrays, Listen, Maps) kann durch den " +"Index verwiesen werden (nur in der \"where\"-Klausel):" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The expression inside <literal>[]</literal> can even be an arithmetic " +"expression:" +msgstr "" +"Der Ausdruck innerhalb von <literal>[]</literal> kann sogar ein " +"arithmetischer Ausdruck sein." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"HQL also provides the built-in <literal>index()</literal> function for " +"elements of a one-to-many association or collection of values." +msgstr "" +"HQL bietet außerdem die eingebaute <literal>index()</literal>-Funktion für " +"Elemente einer \"One-to-Many\"-Assoziation oder einer Collection von Werten." + +#. Tag: para +#, fuzzy, no-c-format +msgid "Scalar SQL functions supported by the underlying database can be used:" +msgstr "" +"Skalare SQL-Funktionen, die durch die zu Grunde liegende Datenbank " +"unterstützt werden, können verwendet werden" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Consider how much longer and less readable the following query would be in " +"SQL:" +msgstr "" +"Falls Sie jetzt noch nicht vom Sinn des Ganzen überzeugt sind, überlegen Sie " +"einmal, um wie viel länger und um wie viel weniger lesbar die folgende " +"Anfrage in SQL wäre:" + +#. Tag: para +#, no-c-format +msgid "<emphasis>Hint:</emphasis> something like" +msgstr "<emphasis>Tipp:</emphasis> etwas wie" + +#. Tag: title +#, no-c-format +msgid "The order by clause" +msgstr "Die Reihenfolge nach Klausel" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The list returned by a query can be ordered by any property of a returned " +"class or components:" +msgstr "" +"Die Liste, mit der eine Anfrage reagiert, kann nach jeder Property der " +"Klasse oder Komponenten geordnet sein:" + +#. Tag: para +#, no-c-format +msgid "" +"The optional <literal>asc</literal> or <literal>desc</literal> indicate " +"ascending or descending order respectively." +msgstr "" +"Die optionalen <literal>asc</literal> oder <literal>desc</literal> zeigen " +"die aufsteigende bzw. absteigende Reihenfolge an." + +#. Tag: title +#, no-c-format +msgid "The group by clause" +msgstr "Die Gruppe nach Klausel" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A query that returns aggregate values can be grouped by any property of a " +"returned class or components:" +msgstr "" +"Eine Anfrage, die aggregierte Werte zurücksendet kann durch jede Property " +"einer zurückgesendeten Klasse oder Komponenten gruppiert werden:" + +#. Tag: para +#, no-c-format +msgid "A <literal>having</literal> clause is also allowed." +msgstr "Eine <literal>having</literal>-Klausel ist ebenfalls gestattet." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"SQL functions and aggregate functions are allowed in the <literal>having</" +"literal> and <literal>order by</literal> clauses if they are supported by " +"the underlying database (i.e., not in MySQL)." +msgstr "" +"SQL-Funktionen und aggregierte Funktionen sind in den <literal>having</" +"literal> und <literal>order by</literal>-Klauseln gestattet , wenn sie von " +"der zu Grunde liegenden Datenbank unterstützt werden (z.B. nicht in MySQL)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Neither the <literal>group by</literal> clause nor the <literal>order by</" +"literal> clause can contain arithmetic expressions. Hibernate also does not " +"currently expand a grouped entity, so you cannot write <literal>group by " +"cat</literal> if all properties of <literal>cat</literal> are non-" +"aggregated. You have to list all non-aggregated properties explicitly." +msgstr "" +"Beachten Sie, dass weder die <literal>group by</literal>-Klausel noch die " +"<literal>order by</literal>-Klausel arithmetische Ausdrücke enthalten " +"dürfen. Beachten Sie auch, dass Hibernate zur Zeit keine gruppierte Entity " +"ausklappt, das heißt, Sie können nicht <literal>group by cat</literal> " +"schreiben, wenn sämtliche Properties von <literal>cat</literal> nicht " +"aggregiert sind. Sie müssen alle nicht aggregierten Properties explizit " +"auflisten." + +#. Tag: title +#, no-c-format +msgid "Subqueries" +msgstr "Unteranfragen" + +#. Tag: para +#, no-c-format +msgid "" +"For databases that support subselects, Hibernate supports subqueries within " +"queries. A subquery must be surrounded by parentheses (often by an SQL " +"aggregate function call). Even correlated subqueries (subqueries that refer " +"to an alias in the outer query) are allowed." +msgstr "" +"Für Datenbanken, die Unterauswahlen unterstützen, unterstützt Hibernate " +"innerhalb von Anfragen Unteranfragen. Eine Unteranfrage muss eingeklammert " +"sein (oftmals durch einen SQL aggregierten Funktionsaufruf). Selbst " +"korrelierende Unteranfragen (Unteranfragen, die auf einen Alias in der " +"außerhalb liegenden Anfrage verweisen) sind gestattet." + +#. Tag: para +#, fuzzy, no-c-format +msgid "Note that HQL subqueries can occur only in the select or where clauses." +msgstr "" +"Beachten Sie, dass HQL-Unteranfragen nur in der Auswahl oder die \"where\"-" +"Klausel auftreten können." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Note that subqueries can also utilize <literal>row value constructor</" +"literal> syntax. See <xref linkend=\"queryhql-tuple\" /> for more " +"information." +msgstr "" +"Beachten Sie, dass Unteranfragen ebenfalls die <literal>row value " +"constructor</literal>-Syntax nutzen können. Weitere Informationen finden Sie " +"unter <xref linkend=\"queryhql-tuple\"/>." + +#. Tag: title +#, no-c-format +msgid "HQL examples" +msgstr "HQL-Beispiele" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate queries can be quite powerful and complex. In fact, the power of " +"the query language is one of Hibernate's main strengths. The following " +"example queries are similar to queries that have been used on recent " +"projects. Please note that most queries you will write will be much simpler " +"than the following examples." +msgstr "" +"Anfragen in Hibernate können sehr leistungsfähig und recht komplex sein. " +"Genau genommen ist die Leistungsfähigkeit eine von Hibernates größten " +"Stärken. Nachfolgend sehen Sie einige Beispielanfragen, ähnlich denen, die " +"ich bei einem aktuellen Projekt verwendet habe. Bitte beachten Sie, dass die " +"meisten Anfragen, die Sie werden schreiben müssen, wesentlich einfacher als " +"diese sind!" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The following query returns the order id, number of items, the given minimum " +"total value and the total value of the order for all unpaid orders for a " +"particular customer. The results are ordered by total value. In determining " +"the prices, it uses the current catalog. The resulting SQL query, against " +"the <literal>ORDER</literal>, <literal>ORDER_LINE</literal>, " +"<literal>PRODUCT</literal>, <literal>CATALOG</literal> and <literal>PRICE</" +"literal> tables has four inner joins and an (uncorrelated) subselect." +msgstr "" +"Die folgende Anfrage reagiert mit der ID der Bestellung (sog. \"order id\"), " +"der Anzahl von Posten und dem Gesamtwert der Bestellung für alle unbezahlten " +"Bestellungen für einen bestimmten Kunden und dem gegebenen Mindestwert, " +"wobei die Ergebnisse nach Gesamtwert geordnet wird. Bei der Bestimmung der " +"Preise wird der aktuelle Katalog verwendet. Die sich ergebende SQL-Anfrage " +"an <literal>ORDER</literal>, <literal>ORDER_LINE</literal>, " +"<literal>PRODUCT</literal>, <literal>CATALOG</literal> und <literal>PRICE</" +"literal>-Tabellen besitzt vier innere Verbünde (\"inner joins\") und eine " +"(unkorrelierte) Unterauswahl." + +#. Tag: para +#, no-c-format +msgid "" +"What a monster! Actually, in real life, I'm not very keen on subqueries, so " +"my query was really more like this:" +msgstr "" +"Monströs! Im wirklichen Leben bin ich kein großer Freund von Unteranfragen, " +"daher sieht meine Anfrage eher wie folgt aus:" + +#. Tag: para +#, no-c-format +msgid "" +"The next query counts the number of payments in each status, excluding all " +"payments in the <literal>AWAITING_APPROVAL</literal> status where the most " +"recent status change was made by the current user. It translates to an SQL " +"query with two inner joins and a correlated subselect against the " +"<literal>PAYMENT</literal>, <literal>PAYMENT_STATUS</literal> and " +"<literal>PAYMENT_STATUS_CHANGE</literal> tables." +msgstr "" +"Die nächste Anfrage zählt die Anzahl von Zahlungen in jedem Status, wobei " +"Zahlungen mit <literal>AWAITING_APPROVAL</literal>-Status, bei denen die " +"aktuellste Statusänderung durch den Benutzer vorgenommen wurde, ausgenommen " +"sind. Sie wird in eine SQL-Anfrage mit zwei inneren Verbünden und eine " +"korrelierte Unterauswahl an die <literal>PAYMENT</literal>, " +"<literal>PAYMENT_STATUS</literal> und <literal>PAYMENT_STATUS_CHANGE</" +"literal>-Tabellen übersetzt." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If the <literal>statusChanges</literal> collection was mapped as a list, " +"instead of a set, the query would have been much simpler to write." +msgstr "" +"Wäre die <literal>statusChanges</literal>-Collection als Liste statt als " +"Satz (sog. \"set\") gemappt, so hätte sich die Anfrage einfacher schreiben " +"lassen." + +#. Tag: para +#, no-c-format +msgid "" +"The next query uses the MS SQL Server <literal>isNull()</literal> function " +"to return all the accounts and unpaid payments for the organization to which " +"the current user belongs. It translates to an SQL query with three inner " +"joins, an outer join and a subselect against the <literal>ACCOUNT</literal>, " +"<literal>PAYMENT</literal>, <literal>PAYMENT_STATUS</literal>, " +"<literal>ACCOUNT_TYPE</literal>, <literal>ORGANIZATION</literal> and " +"<literal>ORG_USER</literal> tables." +msgstr "" +"Die nächste Anfrage verwendet die MS SQL Server <literal>isNull()</literal>-" +"Funktion, um alle Konten und unbezahlten Zahlungen für the Organisation, zu " +"der der aktuelle Benutzer gehört, wiederzugeben. Sie wird in eine SQL-" +"Anfrage mit drei inneren Verbünden (\"inner Joins\"), einen äußeren Verbund " +"(\"outer Join\") und eine Unterauswahl gegen die <literal>ACCOUNT</literal>, " +"<literal>PAYMENT</literal>, <literal>PAYMENT_STATUS</literal>, " +"<literal>ACCOUNT_TYPE</literal>, <literal>ORGANIZATION</literal> und " +"<literal>ORG_USER</literal>-Tabellen übersetzt." + +#. Tag: para +#, no-c-format +msgid "" +"For some databases, we would need to do away with the (correlated) subselect." +msgstr "" +"Bei einigen Datenbanken würden wir die (korrelierende) Unterauswahl " +"abschaffen müssen." + +#. Tag: title +#, no-c-format +msgid "Bulk update and delete" +msgstr "\"Bulk\"-Aktualisierung und Löschen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"HQL now supports <literal>update</literal>, <literal>delete</literal> and " +"<literal>insert ... select ...</literal> statements. See <xref linkend=" +"\"batch-direct\" /> for more information." +msgstr "" +"HQL unterstützt nun <literal>update</literal>, <literal>delete</literal> und " +"<literal>insert ... select ...</literal>-Anweisungen. Weitere Einzelheiten " +"hierzu finden Sie unter <xref linkend=\"batch-direct\"/>." + +#. Tag: title +#, no-c-format +msgid "Tips & Tricks" +msgstr "Tipps & Tricks" + +#. Tag: para +#, fuzzy, no-c-format +msgid "You can count the number of query results without returning them:" +msgstr "" +"Sie können die Anzahl der Anfragenergebnisse zählen, ohne diese tatsächlich " +"wiederzugeben:" + +#. Tag: para +#, no-c-format +msgid "To order a result by the size of a collection, use the following query:" +msgstr "" +"Um ein Ergebnis nach der Größe einer Collection zu ordnen, verwenden Sie die " +"folgende Anfrage:" + +#. Tag: para +#, no-c-format +msgid "" +"If your database supports subselects, you can place a condition upon " +"selection size in the where clause of your query:" +msgstr "" +"Falls Ihre Datenbank Unterauswahlen unterstützt, können Sie eine Bedingung " +"bezüglich der Auswahlgröße in der \"where\"-Klausel Ihrer Anfrage stellen:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "If your database does not support subselects, use the following query:" +msgstr "" +"Falls Ihre Datenbank keine Unterauswahl unterstützt, verwenden Sie folgende " +"Anfrage:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"As this solution cannot return a <literal>User</literal> with zero messages " +"because of the inner join, the following form is also useful:" +msgstr "" +"Da dabei wegen des inneren Verbunds nicht mit einem <literal>User</literal> " +"mit \"Null\" Nachrichten reagiert werden kann, ist die folgende Form " +"ebenfalls hilfreich:" + +#. Tag: para +#, no-c-format +msgid "Properties of a JavaBean can be bound to named query parameters:" +msgstr "" +"Properties eines JavaBean können an benannte Anfragenparameter gebunden " +"werden:" + +#. Tag: para +#, no-c-format +msgid "" +"Collections are pageable by using the <literal>Query</literal> interface " +"with a filter:" +msgstr "" +"Collections sind unter Verwendung des <literal>Query</literal>-Interface mit " +"einem Filter seitenwechselbar:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "Collection elements can be ordered or grouped using a query filter:" +msgstr "" +"Collection-Elemente können mittels eines Anfragenfilters geordnet oder " +"gruppiert werden:" + +#. Tag: para +#, no-c-format +msgid "You can find the size of a collection without initializing it:" +msgstr "" +"Sie können die Größe einer Collection finden, ohne diese zu initialisieren:" + +#. Tag: title +#, no-c-format +msgid "Components" +msgstr "Komponenten" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Components can be used similarly to the simple value types that are used in " +"HQL queries. They can appear in the <literal>select</literal> clause as " +"follows:" +msgstr "" +"Komponenten können auf nahezu alle Arten verwendet werden, wie Wertetypen in " +"HQL-Anfragen. Sie können in der <literal>select</literal>-Klausel auftreten:" + +#. Tag: para +#, no-c-format +msgid "" +"where the Person's name property is a component. Components can also be used " +"in the <literal>where</literal> clause:" +msgstr "" +"wo die Namen-Property der Person eine Komponente ist. Komponenten können " +"auch in der <literal>where</literal>-Klausel verwendet werden:" + +#. Tag: para +#, no-c-format +msgid "Components can also be used in the <literal>order by</literal> clause:" +msgstr "" +"Komponenten können auch in der <literal>order by</literal>-Klausel verwendet " +"werden:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Another common use of components is in row value constructors (<xref linkend=" +"\"queryhql-tuple\" />)." +msgstr "" +"Ein weiterer gängiger Anwendungsbereich von Komponenten ist in <xref linkend=" +"\"queryhql-tuple\"/> \"Row-Value-Constructors\"." + +#. Tag: title +#, no-c-format +msgid "Row value constructor syntax" +msgstr "Die Syntax des \"Row-Value-Constructors\"" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"HQL supports the use of ANSI SQL <literal>row value constructor</literal> " +"syntax, sometimes referred to AS <literal>tuple</literal> syntax, even " +"though the underlying database may not support that notion. Here, we are " +"generally referring to multi-valued comparisons, typically associated with " +"components. Consider an entity Person which defines a name component:" +msgstr "" +"HQL unterstützt die Verwendung der ANSI SQL <literal>row value constructor</" +"literal>-Syntax (auch als <literal>tuple</literal>-Syntax bekannt), obwohl " +"die zu Grunde liegende Datenbank diesen Begriff möglicherweise nicht " +"unterstützt. Wir beziehen uns hier im Wesentlichen auf mehrwertige " +"Vergleiche, in der Regel mit Komponenten assoziiert. Ziehen Sie eine Entity " +"Person in Betracht, die eine Namenskomponente definiert:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"That is valid syntax although it is a little verbose. You can make this more " +"concise by using <literal>row value constructor</literal> syntax:" +msgstr "" +"Das ist eine gültige Syntax, wenngleich etwas wortreich. Präziser lässt sich " +"dies mittels der <literal>row value constructor</literal>-Syntax ausdrücken:" + +#. Tag: para +#, no-c-format +msgid "" +"It can also be useful to specify this in the <literal>select</literal> " +"clause:" +msgstr "" +"Es kann sich als nützlich erweisen, dies in der <literal>select</literal>-" +"Klausel zu spezifizieren:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Using <literal>row value constructor</literal> syntax can also be beneficial " +"when using subqueries that need to compare against multiple values:" +msgstr "" +"Die Verwendung der <literal>row value constructor</literal>-Syntax kann " +"außerdem bei der Verwendung von Unteranfragen hilfreich sein, die mit " +"mehreren Werten verglichen werden müssen:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"One thing to consider when deciding if you want to use this syntax, is that " +"the query will be dependent upon the ordering of the component sub-" +"properties in the metadata." +msgstr "" +"Bei der Entscheidung, ob Sie diese Syntax verwenden möchten, sollten Sie " +"berücksichtigen, dass die Anfrage von der Anordnung der Komponenten Sub-" +"Properties in Metadata abhängig sein wird." + +#, fuzzy +#~ msgid "<![CDATA[from eg.Cat]]>" +#~ msgstr "from eg.Cat" + +#, fuzzy +#~ msgid "<![CDATA[from Cat as cat]]>" +#~ msgstr "from Cat as cat" + +#, fuzzy +#~ msgid "<![CDATA[from Cat cat]]>" +#~ msgstr "from Cat cat" + +#, fuzzy +#~ msgid "<![CDATA[from Formula, Parameter]]>" +#~ msgstr "from Formula, Parameter" + +#, fuzzy +#~ msgid "<![CDATA[from Formula as form, Parameter as param]]>" +#~ msgstr "from Formula as form, Parameter as param" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[from Cat as cat\n" +#~ " inner join cat.mate as mate\n" +#~ " left outer join cat.kittens as kitten]]>" +#~ msgstr "" +#~ "from Cat as cat\n" +#~ " inner join cat.mate as mate\n" +#~ " left outer join cat.kittens as kitten" + +#, fuzzy +#~ msgid "<![CDATA[from Cat as cat left join cat.mate.kittens as kittens]]>" +#~ msgstr "from Cat as cat left join cat.mate.kittens as kittens" + +#, fuzzy +#~ msgid "<![CDATA[from Formula form full join form.parameter param]]>" +#~ msgstr "from Formula form full join form.parameter param" + +#~ msgid "inner join" +#~ msgstr "inner join" + +#~ msgid "left outer join" +#~ msgstr "left outer join" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[from Cat as cat\n" +#~ " join cat.mate as mate\n" +#~ " left join cat.kittens as kitten]]>" +#~ msgstr "" +#~ "from Cat as cat\n" +#~ " join cat.mate as mate\n" +#~ " left join cat.kittens as kitten" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[from Cat as cat\n" +#~ " left join cat.kittens as kitten\n" +#~ " with kitten.bodyWeight > 10.0]]>" +#~ msgstr "" +#~ "from Cat as cat\n" +#~ " left join cat.kittens as kitten\n" +#~ " with kitten.bodyWeight > 10.0" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[from Cat as cat\n" +#~ " inner join fetch cat.mate\n" +#~ " left join fetch cat.kittens]]>" +#~ msgstr "" +#~ "from Cat as cat\n" +#~ " inner join fetch cat.mate\n" +#~ " left join fetch cat.kittens" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[from Cat as cat\n" +#~ " inner join fetch cat.mate\n" +#~ " left join fetch cat.kittens child\n" +#~ " left join fetch child.kittens]]>" +#~ msgstr "" +#~ "from Cat as cat\n" +#~ " inner join fetch cat.mate\n" +#~ " left join fetch cat.kittens child\n" +#~ " left join fetch child.kittens" + +#, fuzzy +#~ msgid "<![CDATA[from Document fetch all properties order by name]]>" +#~ msgstr "from Document fetch all properties order by name" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[from Document doc fetch all properties where lower(doc.name) " +#~ "like '%cats%']]>" +#~ msgstr "" +#~ "from Document doc fetch all properties where lower(doc.name) like '%" +#~ "cats%'" + +#, fuzzy +#~ msgid "<![CDATA[from Cat as cat where cat.mate.name like '%s%']]>" +#~ msgstr "from Cat as cat where cat.mate.name like '%s%'" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select mate\n" +#~ "from Cat as cat\n" +#~ " inner join cat.mate as mate]]>" +#~ msgstr "" +#~ "select mate\n" +#~ "from Cat as cat\n" +#~ " inner join cat.mate as mate" + +#, fuzzy +#~ msgid "<![CDATA[select cat.mate from Cat cat]]>" +#~ msgstr "select cat.mate from Cat cat" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select cat.name from DomesticCat cat\n" +#~ "where cat.name like 'fri%']]>" +#~ msgstr "" +#~ "select cat.name from DomesticCat cat\n" +#~ "where cat.name like 'fri%'" + +#, fuzzy +#~ msgid "<![CDATA[select cust.name.firstName from Customer as cust]]>" +#~ msgstr "select cust.name.firstName from Customer as cust" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select mother, offspr, mate.name\n" +#~ "from DomesticCat as mother\n" +#~ " inner join mother.mate as mate\n" +#~ " left outer join mother.kittens as offspr]]>" +#~ msgstr "" +#~ "select mother, offspr, mate.name\n" +#~ "from DomesticCat as mother\n" +#~ " inner join mother.mate as mate\n" +#~ " left outer join mother.kittens as offspr" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select new list(mother, offspr, mate.name)\n" +#~ "from DomesticCat as mother\n" +#~ " inner join mother.mate as mate\n" +#~ " left outer join mother.kittens as offspr]]>" +#~ msgstr "" +#~ "select new list(mother, offspr, mate.name)\n" +#~ "from DomesticCat as mother\n" +#~ " inner join mother.mate as mate\n" +#~ " left outer join mother.kittens as offspr" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select new Family(mother, mate, offspr)\n" +#~ "from DomesticCat as mother\n" +#~ " join mother.mate as mate\n" +#~ " left join mother.kittens as offspr]]>" +#~ msgstr "" +#~ "select new Family(mother, mate, offspr)\n" +#~ "from DomesticCat as mother\n" +#~ " join mother.mate as mate\n" +#~ " left join mother.kittens as offspr" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select max(bodyWeight) as max, min(bodyWeight) as min, count(*) " +#~ "as n\n" +#~ "from Cat cat]]>" +#~ msgstr "" +#~ "select max(bodyWeight) as max, min(bodyWeight) as min, count(*) as n\n" +#~ "from Cat cat" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select new map( max(bodyWeight) as max, min(bodyWeight) as min, " +#~ "count(*) as n )\n" +#~ "from Cat cat]]>" +#~ msgstr "" +#~ "select new map( max(bodyWeight) as max, min(bodyWeight) as min, count(*) " +#~ "as n )\n" +#~ "from Cat cat" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select avg(cat.weight), sum(cat.weight), max(cat.weight), count" +#~ "(cat)\n" +#~ "from Cat cat]]>" +#~ msgstr "" +#~ "select avg(cat.weight), sum(cat.weight), max(cat.weight), count(cat)\n" +#~ "from Cat cat" + +#~ msgid "count(*)" +#~ msgstr "count(*)" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select cat.weight + sum(kitten.weight)\n" +#~ "from Cat cat\n" +#~ " join cat.kittens kitten\n" +#~ "group by cat.id, cat.weight]]>" +#~ msgstr "" +#~ "select cat.weight + sum(kitten.weight)\n" +#~ "from Cat cat\n" +#~ " join cat.kittens kitten\n" +#~ "group by cat.id, cat.weight" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select firstName||' '||initial||' '||upper(lastName) from " +#~ "Person]]>" +#~ msgstr "select firstName||' '||initial||' '||upper(lastName) from Person" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select distinct cat.name from Cat cat\n" +#~ "\n" +#~ "select count(distinct cat.name), count(cat) from Cat cat]]>" +#~ msgstr "" +#~ "select distinct cat.name from Cat cat\n" +#~ "\n" +#~ "select count(distinct cat.name), count(cat) from Cat cat" + +#, fuzzy +#~ msgid "<![CDATA[from java.lang.Object o]]>" +#~ msgstr "from java.lang.Object o" + +#, fuzzy +#~ msgid "<![CDATA[from Named n, Named m where n.name = m.name]]>" +#~ msgstr "from Named n, Named m where n.name = m.name" + +#, fuzzy +#~ msgid "<![CDATA[from Cat where name='Fritz']]>" +#~ msgstr "from Cat where name='Fritz'" + +#, fuzzy +#~ msgid "<![CDATA[from Cat as cat where cat.name='Fritz']]>" +#~ msgstr "from Cat as cat where cat.name='Fritz'" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select foo\n" +#~ "from Foo foo, Bar bar\n" +#~ "where foo.startDate = bar.date]]>" +#~ msgstr "" +#~ "select foo\n" +#~ "from Foo foo, Bar bar\n" +#~ "where foo.startDate = bar.date" + +#, fuzzy +#~ msgid "<![CDATA[from Cat cat where cat.mate.name is not null]]>" +#~ msgstr "from Cat cat where cat.mate.name is not null" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[from Foo foo\n" +#~ "where foo.bar.baz.customer.address.city is not null]]>" +#~ msgstr "" +#~ "from Foo foo\n" +#~ "where foo.bar.baz.customer.address.city is not null" + +#, fuzzy +#~ msgid "<![CDATA[from Cat cat, Cat rival where cat.mate = rival.mate]]>" +#~ msgstr "from Cat cat, Cat rival where cat.mate = rival.mate" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select cat, mate\n" +#~ "from Cat cat, Cat mate\n" +#~ "where cat.mate = mate]]>" +#~ msgstr "" +#~ "select cat, mate\n" +#~ "from Cat cat, Cat mate\n" +#~ "where cat.mate = mate" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[from Cat as cat where cat.id = 123\n" +#~ "\n" +#~ "from Cat as cat where cat.mate.id = 69]]>" +#~ msgstr "" +#~ "from Cat as cat where cat.id = 123\n" +#~ "\n" +#~ "from Cat as cat where cat.mate.id = 69" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[from bank.Person person\n" +#~ "where person.id.country = 'AU'\n" +#~ " and person.id.medicareNumber = 123456]]>" +#~ msgstr "" +#~ "from bank.Person person\n" +#~ "where person.id.country = 'AU'\n" +#~ " and person.id.medicareNumber = 123456" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[from bank.Account account\n" +#~ "where account.owner.id.country = 'AU'\n" +#~ " and account.owner.id.medicareNumber = 123456]]>" +#~ msgstr "" +#~ "from bank.Account account\n" +#~ "where account.owner.id.country = 'AU'\n" +#~ " and account.owner.id.medicareNumber = 123456" + +#, fuzzy +#~ msgid "<![CDATA[from Cat cat where cat.class = DomesticCat]]>" +#~ msgstr "from Cat cat where cat.class = DomesticCat" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[from AuditLog log, Payment payment\n" +#~ "where log.item.class = 'Payment' and log.item.id = payment.id]]>" +#~ msgstr "" +#~ "from AuditLog log, Payment payment\n" +#~ "where log.item.class = 'Payment' and log.item.id = payment.id" + +#, fuzzy +#~ msgid "<![CDATA[from DomesticCat cat where cat.name between 'A' and 'B']]>" +#~ msgstr "from DomesticCat cat where cat.name between 'A' and 'B'" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[from DomesticCat cat where cat.name in ( 'Foo', 'Bar', 'Baz' )]]>" +#~ msgstr "from DomesticCat cat where cat.name in ( 'Foo', 'Bar', 'Baz' )" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[from DomesticCat cat where cat.name not between 'A' and 'B']]>" +#~ msgstr "from DomesticCat cat where cat.name not between 'A' and 'B'" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[from DomesticCat cat where cat.name not in ( 'Foo', 'Bar', " +#~ "'Baz' )]]>" +#~ msgstr "from DomesticCat cat where cat.name not in ( 'Foo', 'Bar', 'Baz' )" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<property name=\"hibernate.query.substitutions\">true 1, false " +#~ "0</property>]]>" +#~ msgstr "" +#~ "<property name=\"hibernate.query.substitutions\">true 1, false " +#~ "0</property>" + +#, fuzzy +#~ msgid "<![CDATA[from Cat cat where cat.alive = true]]>" +#~ msgstr "from Cat cat where cat.alive = true" + +#, fuzzy +#~ msgid "<![CDATA[from Cat cat where cat.kittens.size > 0]]>" +#~ msgstr "from Cat cat where cat.kittens.size > 0" + +#, fuzzy +#~ msgid "<![CDATA[from Cat cat where size(cat.kittens) > 0]]>" +#~ msgstr "from Cat cat where size(cat.kittens) > 0" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[from Calendar cal where maxelement(cal.holidays) > current_date]]" +#~ ">" +#~ msgstr "from Calendar cal where maxelement(cal.holidays) > current_date" + +#, fuzzy +#~ msgid "<![CDATA[from Order order where maxindex(order.items) > 100]]>" +#~ msgstr "from Order order where maxindex(order.items) > 100" + +#, fuzzy +#~ msgid "<![CDATA[from Order order where minelement(order.items) > 10000]]>" +#~ msgstr "from Order order where minelement(order.items) > 10000" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select mother from Cat as mother, Cat as kit\n" +#~ "where kit in elements(foo.kittens)]]>" +#~ msgstr "" +#~ "select mother from Cat as mother, Cat as kit\n" +#~ "where kit in elements(foo.kittens)" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select p from NameList list, Person p\n" +#~ "where p.name = some elements(list.names)]]>" +#~ msgstr "" +#~ "select p from NameList list, Person p\n" +#~ "where p.name = some elements(list.names)" + +#, fuzzy +#~ msgid "<![CDATA[from Cat cat where exists elements(cat.kittens)]]>" +#~ msgstr "from Cat cat where exists elements(cat.kittens)" + +#, fuzzy +#~ msgid "<![CDATA[from Player p where 3 > all elements(p.scores)]]>" +#~ msgstr "from Player p where 3 > all elements(p.scores)" + +#, fuzzy +#~ msgid "<![CDATA[from Show show where 'fizard' in indices(show.acts)]]>" +#~ msgstr "from Show show where 'fizard' in indices(show.acts)" + +#, fuzzy +#~ msgid "<![CDATA[from Order order where order.items[0].id = 1234]]>" +#~ msgstr "from Order order where order.items[0].id = 1234" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select person from Person person, Calendar calendar\n" +#~ "where calendar.holidays['national day'] = person.birthDay\n" +#~ " and person.nationality.calendar = calendar]]>" +#~ msgstr "" +#~ "select person from Person person, Calendar calendar\n" +#~ "where calendar.holidays['national day'] = person.birthDay\n" +#~ " and person.nationality.calendar = calendar" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select item from Item item, Order order\n" +#~ "where order.items[ order.deliveredItemIndices[0] ] = item and order.id = " +#~ "11]]>" +#~ msgstr "" +#~ "select item from Item item, Order order\n" +#~ "where order.items[ order.deliveredItemIndices[0] ] = item and order.id = " +#~ "11" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select item from Item item, Order order\n" +#~ "where order.items[ maxindex(order.items) ] = item and order.id = 11]]>" +#~ msgstr "" +#~ "select item from Item item, Order order\n" +#~ "where order.items[ maxindex(order.items) ] = item and order.id = 11" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select item from Item item, Order order\n" +#~ "where order.items[ size(order.items) - 1 ] = item]]>" +#~ msgstr "" +#~ "select item from Item item, Order order\n" +#~ "where order.items[ size(order.items) - 1 ] = item" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select item, index(item) from Order order\n" +#~ " join order.items item\n" +#~ "where index(item) < 5]]>" +#~ msgstr "" +#~ "select item, index(item) from Order order\n" +#~ " join order.items item\n" +#~ "where index(item) < 5" + +#, fuzzy +#~ msgid "<![CDATA[from DomesticCat cat where upper(cat.name) like 'FRI%']]>" +#~ msgstr "from DomesticCat cat where upper(cat.name) like 'FRI%'" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select cust\n" +#~ "from Product prod,\n" +#~ " Store store\n" +#~ " inner join store.customers cust\n" +#~ "where prod.name = 'widget'\n" +#~ " and store.location.name in ( 'Melbourne', 'Sydney' )\n" +#~ " and prod = all elements(cust.currentOrder.lineItems)]]>" +#~ msgstr "" +#~ "select cust\n" +#~ "from Product prod,\n" +#~ " Store store\n" +#~ " inner join store.customers cust\n" +#~ "where prod.name = 'widget'\n" +#~ " and store.location.name in ( 'Melbourne', 'Sydney' )\n" +#~ " and prod = all elements(cust.currentOrder.lineItems)" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[SELECT cust.name, cust.address, cust.phone, cust.id, cust." +#~ "current_order\n" +#~ "FROM customers cust,\n" +#~ " stores store,\n" +#~ " locations loc,\n" +#~ " store_customers sc,\n" +#~ " product prod\n" +#~ "WHERE prod.name = 'widget'\n" +#~ " AND store.loc_id = loc.id\n" +#~ " AND loc.name IN ( 'Melbourne', 'Sydney' )\n" +#~ " AND sc.store_id = store.id\n" +#~ " AND sc.cust_id = cust.id\n" +#~ " AND prod.id = ALL(\n" +#~ " SELECT item.prod_id\n" +#~ " FROM line_items item, orders o\n" +#~ " WHERE item.order_id = o.id\n" +#~ " AND cust.current_order = o.id\n" +#~ " )]]>" +#~ msgstr "" +#~ "SELECT cust.name, cust.address, cust.phone, cust.id, cust.current_order\n" +#~ "FROM customers cust,\n" +#~ " stores store,\n" +#~ " locations loc,\n" +#~ " store_customers sc,\n" +#~ " product prod\n" +#~ "WHERE prod.name = 'widget'\n" +#~ " AND store.loc_id = loc.id\n" +#~ " AND loc.name IN ( 'Melbourne', 'Sydney' )\n" +#~ " AND sc.store_id = store.id\n" +#~ " AND sc.cust_id = cust.id\n" +#~ " AND prod.id = ALL(\n" +#~ " SELECT item.prod_id\n" +#~ " FROM line_items item, orders o\n" +#~ " WHERE item.order_id = o.id\n" +#~ " AND cust.current_order = o.id\n" +#~ " )" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[from DomesticCat cat\n" +#~ "order by cat.name asc, cat.weight desc, cat.birthdate]]>" +#~ msgstr "" +#~ "from DomesticCat cat\n" +#~ "order by cat.name asc, cat.weight desc, cat.birthdate" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select cat.color, sum(cat.weight), count(cat)\n" +#~ "from Cat cat\n" +#~ "group by cat.color]]>" +#~ msgstr "" +#~ "select cat.color, sum(cat.weight), count(cat)\n" +#~ "from Cat cat\n" +#~ "group by cat.color" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select foo.id, avg(name), max(name)\n" +#~ "from Foo foo join foo.names name\n" +#~ "group by foo.id]]>" +#~ msgstr "" +#~ "select foo.id, avg(name), max(name)\n" +#~ "from Foo foo join foo.names name\n" +#~ "group by foo.id" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select cat.color, sum(cat.weight), count(cat)\n" +#~ "from Cat cat\n" +#~ "group by cat.color\n" +#~ "having cat.color in (eg.Color.TABBY, eg.Color.BLACK)]]>" +#~ msgstr "" +#~ "select cat.color, sum(cat.weight), count(cat)\n" +#~ "from Cat cat\n" +#~ "group by cat.color\n" +#~ "having cat.color in (eg.Color.TABBY, eg.Color.BLACK)" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select cat\n" +#~ "from Cat cat\n" +#~ " join cat.kittens kitten\n" +#~ "group by cat.id, cat.name, cat.other, cat.properties\n" +#~ "having avg(kitten.weight) > 100\n" +#~ "order by count(kitten) asc, sum(kitten.weight) desc]]>" +#~ msgstr "" +#~ "select cat\n" +#~ "from Cat cat\n" +#~ " join cat.kittens kitten\n" +#~ "group by cat.id, cat.name, cat.other, cat.properties\n" +#~ "having avg(kitten.weight) > 100\n" +#~ "order by count(kitten) asc, sum(kitten.weight) desc" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[from Cat as fatcat\n" +#~ "where fatcat.weight > (\n" +#~ " select avg(cat.weight) from DomesticCat cat\n" +#~ ")]]>" +#~ msgstr "" +#~ "from Cat as fatcat\n" +#~ "where fatcat.weight > (\n" +#~ " select avg(cat.weight) from DomesticCat cat\n" +#~ ")" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[from DomesticCat as cat\n" +#~ "where cat.name = some (\n" +#~ " select name.nickName from Name as name\n" +#~ ")]]>" +#~ msgstr "" +#~ "from DomesticCat as cat\n" +#~ "where cat.name = some (\n" +#~ " select name.nickName from Name as name\n" +#~ ")" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[from Cat as cat\n" +#~ "where not exists (\n" +#~ " from Cat as mate where mate.mate = cat\n" +#~ ")]]>" +#~ msgstr "" +#~ "from Cat as cat\n" +#~ "where not exists (\n" +#~ " from Cat as mate where mate.mate = cat\n" +#~ ")" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[from DomesticCat as cat\n" +#~ "where cat.name not in (\n" +#~ " select name.nickName from Name as name\n" +#~ ")]]>" +#~ msgstr "" +#~ "from DomesticCat as cat\n" +#~ "where cat.name not in (\n" +#~ " select name.nickName from Name as name\n" +#~ ")" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select cat.id, (select max(kit.weight) from cat.kitten kit)\n" +#~ "from Cat as cat]]>" +#~ msgstr "" +#~ "select cat.id, (select max(kit.weight) from cat.kitten kit)\n" +#~ "from Cat as cat" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select order.id, sum(price.amount), count(item)\n" +#~ "from Order as order\n" +#~ " join order.lineItems as item\n" +#~ " join item.product as product,\n" +#~ " Catalog as catalog\n" +#~ " join catalog.prices as price\n" +#~ "where order.paid = false\n" +#~ " and order.customer = :customer\n" +#~ " and price.product = product\n" +#~ " and catalog.effectiveDate < sysdate\n" +#~ " and catalog.effectiveDate >= all (\n" +#~ " select cat.effectiveDate\n" +#~ " from Catalog as cat\n" +#~ " where cat.effectiveDate < sysdate\n" +#~ " )\n" +#~ "group by order\n" +#~ "having sum(price.amount) > :minAmount\n" +#~ "order by sum(price.amount) desc]]>" +#~ msgstr "" +#~ "select order.id, sum(price.amount), count(item)\n" +#~ "from Order as order\n" +#~ " join order.lineItems as item\n" +#~ " join item.product as product,\n" +#~ " Catalog as catalog\n" +#~ " join catalog.prices as price\n" +#~ "where order.paid = false\n" +#~ " and order.customer = :customer\n" +#~ " and price.product = product\n" +#~ " and catalog.effectiveDate < sysdate\n" +#~ " and catalog.effectiveDate >= all (\n" +#~ " select cat.effectiveDate\n" +#~ " from Catalog as cat\n" +#~ " where cat.effectiveDate < sysdate\n" +#~ " )\n" +#~ "group by order\n" +#~ "having sum(price.amount) > :minAmount\n" +#~ "order by sum(price.amount) desc" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select order.id, sum(price.amount), count(item)\n" +#~ "from Order as order\n" +#~ " join order.lineItems as item\n" +#~ " join item.product as product,\n" +#~ " Catalog as catalog\n" +#~ " join catalog.prices as price\n" +#~ "where order.paid = false\n" +#~ " and order.customer = :customer\n" +#~ " and price.product = product\n" +#~ " and catalog = :currentCatalog\n" +#~ "group by order\n" +#~ "having sum(price.amount) > :minAmount\n" +#~ "order by sum(price.amount) desc]]>" +#~ msgstr "" +#~ "select order.id, sum(price.amount), count(item)\n" +#~ "from Order as order\n" +#~ " join order.lineItems as item\n" +#~ " join item.product as product,\n" +#~ " Catalog as catalog\n" +#~ " join catalog.prices as price\n" +#~ "where order.paid = false\n" +#~ " and order.customer = :customer\n" +#~ " and price.product = product\n" +#~ " and catalog = :currentCatalog\n" +#~ "group by order\n" +#~ "having sum(price.amount) > :minAmount\n" +#~ "order by sum(price.amount) desc" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select count(payment), status.name\n" +#~ "from Payment as payment\n" +#~ " join payment.currentStatus as status\n" +#~ " join payment.statusChanges as statusChange\n" +#~ "where payment.status.name <> PaymentStatus.AWAITING_APPROVAL\n" +#~ " or (\n" +#~ " statusChange.timeStamp = (\n" +#~ " select max(change.timeStamp)\n" +#~ " from PaymentStatusChange change\n" +#~ " where change.payment = payment\n" +#~ " )\n" +#~ " and statusChange.user <> :currentUser\n" +#~ " )\n" +#~ "group by status.name, status.sortOrder\n" +#~ "order by status.sortOrder]]>" +#~ msgstr "" +#~ "select count(payment), status.name\n" +#~ "from Payment as payment\n" +#~ " join payment.currentStatus as status\n" +#~ " join payment.statusChanges as statusChange\n" +#~ "where payment.status.name <> PaymentStatus.AWAITING_APPROVAL\n" +#~ " or (\n" +#~ " statusChange.timeStamp = (\n" +#~ " select max(change.timeStamp)\n" +#~ " from PaymentStatusChange change\n" +#~ " where change.payment = payment\n" +#~ " )\n" +#~ " and statusChange.user <> :currentUser\n" +#~ " )\n" +#~ "group by status.name, status.sortOrder\n" +#~ "order by status.sortOrder" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select count(payment), status.name\n" +#~ "from Payment as payment\n" +#~ " join payment.currentStatus as status\n" +#~ "where payment.status.name <> PaymentStatus.AWAITING_APPROVAL\n" +#~ " or payment.statusChanges[ maxIndex(payment.statusChanges) ].user <> :" +#~ "currentUser\n" +#~ "group by status.name, status.sortOrder\n" +#~ "order by status.sortOrder]]>" +#~ msgstr "" +#~ "select count(payment), status.name\n" +#~ "from Payment as payment\n" +#~ " join payment.currentStatus as status\n" +#~ "where payment.status.name <> PaymentStatus.AWAITING_APPROVAL\n" +#~ " or payment.statusChanges[ maxIndex(payment.statusChanges) ].user <" +#~ "> :currentUser\n" +#~ "group by status.name, status.sortOrder\n" +#~ "order by status.sortOrder" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select account, payment\n" +#~ "from Account as account\n" +#~ " left outer join account.payments as payment\n" +#~ "where :currentUser in elements(account.holder.users)\n" +#~ " and PaymentStatus.UNPAID = isNull(payment.currentStatus.name, " +#~ "PaymentStatus.UNPAID)\n" +#~ "order by account.type.sortOrder, account.accountNumber, payment.dueDate]]>" +#~ msgstr "" +#~ "select account, payment\n" +#~ "from Account as account\n" +#~ " left outer join account.payments as payment\n" +#~ "where :currentUser in elements(account.holder.users)\n" +#~ " and PaymentStatus.UNPAID = isNull(payment.currentStatus.name, " +#~ "PaymentStatus.UNPAID)\n" +#~ "order by account.type.sortOrder, account.accountNumber, payment.dueDate" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select account, payment\n" +#~ "from Account as account\n" +#~ " join account.holder.users as user\n" +#~ " left outer join account.payments as payment\n" +#~ "where :currentUser = user\n" +#~ " and PaymentStatus.UNPAID = isNull(payment.currentStatus.name, " +#~ "PaymentStatus.UNPAID)\n" +#~ "order by account.type.sortOrder, account.accountNumber, payment.dueDate]]>" +#~ msgstr "" +#~ "select account, payment\n" +#~ "from Account as account\n" +#~ " join account.holder.users as user\n" +#~ " left outer join account.payments as payment\n" +#~ "where :currentUser = user\n" +#~ " and PaymentStatus.UNPAID = isNull(payment.currentStatus.name, " +#~ "PaymentStatus.UNPAID)\n" +#~ "order by account.type.sortOrder, account.accountNumber, payment.dueDate" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[( (Integer) session.createQuery(\"select count(*) from ....\")." +#~ "iterate().next() ).intValue()]]>" +#~ msgstr "" +#~ "( (Integer) session.iterate(\"select count(*) from ....\").next() )." +#~ "intValue()" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select usr.id, usr.name\n" +#~ "from User as usr\n" +#~ " left join usr.messages as msg\n" +#~ "group by usr.id, usr.name\n" +#~ "order by count(msg)]]>" +#~ msgstr "" +#~ "select usr.id, usr.name\n" +#~ "from User as usr\n" +#~ " left join usr.messages as msg\n" +#~ "group by usr.id, usr.name\n" +#~ "order by count(msg)" + +#, fuzzy +#~ msgid "<![CDATA[from User usr where size(usr.messages) >= 1]]>" +#~ msgstr "from User usr where size(usr.messages) >= 1" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select usr.id, usr.name\n" +#~ "from User usr.name\n" +#~ " join usr.messages msg\n" +#~ "group by usr.id, usr.name\n" +#~ "having count(msg) >= 1]]>" +#~ msgstr "" +#~ "select usr.id, usr.name\n" +#~ "from User usr.name\n" +#~ " join usr.messages msg\n" +#~ "group by usr.id, usr.name\n" +#~ "having count(msg) >= 1" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[select usr.id, usr.name\n" +#~ "from User as usr\n" +#~ " left join usr.messages as msg\n" +#~ "group by usr.id, usr.name\n" +#~ "having count(msg) = 0]]>" +#~ msgstr "" +#~ "select usr.id, usr.name\n" +#~ "from User as usr\n" +#~ " left join usr.messages as msg\n" +#~ "group by usr.id, usr.name\n" +#~ "having count(msg) = 0" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Query q = s.createQuery(\"from foo Foo as foo where foo.name=:" +#~ "name and foo.size=:size\");\n" +#~ "q.setProperties(fooBean); // fooBean has getName() and getSize()\n" +#~ "List foos = q.list();]]>" +#~ msgstr "" +#~ "Query q = s.createQuery(\"from foo Foo as foo where foo.name=:name and " +#~ "foo.size=:size\");\n" +#~ "q.setProperties(fooBean); // fooBean has getName() and getSize()\n" +#~ "List foos = q.list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Query q = s.createFilter( collection, \"\" ); // the trivial " +#~ "filter\n" +#~ "q.setMaxResults(PAGE_SIZE);\n" +#~ "q.setFirstResult(PAGE_SIZE * pageNumber);\n" +#~ "List page = q.list();]]>" +#~ msgstr "" +#~ "Query q = s.createFilter( collection, \"\" ); // the trivial filter\n" +#~ "q.setMaxResults(PAGE_SIZE);\n" +#~ "q.setFirstResult(PAGE_SIZE * pageNumber);\n" +#~ "List page = q.list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Collection orderedCollection = s.filter( collection, \"order by " +#~ "this.amount\" );\n" +#~ "Collection counts = s.filter( collection, \"select this.type, count(this) " +#~ "group by this.type\" );]]>" +#~ msgstr "" +#~ "Collection orderedCollection = s.filter( collection, \"order by this." +#~ "amount\" );\n" +#~ "Collection counts = s.filter( collection, \"select this.type, count(this) " +#~ "group by this.type\" );" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[( (Integer) session.createQuery(\"select count(*) from ....\")." +#~ "iterate().next() ).intValue();]]>" +#~ msgstr "" +#~ "( (Integer) session.iterate(\"select count(*) from ....\").next() )." +#~ "intValue();" + +#, fuzzy +#~ msgid "<![CDATA[select p.name from Person p]]>" +#~ msgstr "select p.name from from Person p" + +#, fuzzy +#~ msgid "<![CDATA[select p.name.first from Person p]]>" +#~ msgstr "select p.name.first from from Person p" + +#, fuzzy +#~ msgid "<![CDATA[from Person p where p.name = :name]]>" +#~ msgstr "from from Person p where p.name = :name" + +#, fuzzy +#~ msgid "<![CDATA[from Person p where p.name.first = :firstName]]>" +#~ msgstr "from from Person p where p.name.first = :firstName" + +#, fuzzy +#~ msgid "<![CDATA[from Person p order by p.name]]>" +#~ msgstr "from from Person p order by p.name" + +#, fuzzy +#~ msgid "<![CDATA[from Person p order by p.name.first]]>" +#~ msgstr "from from Person p order by p.name.first" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[from Person p where p.name.first='John' and p.name." +#~ "last='Jingleheimer-Schmidt']]>" +#~ msgstr "" +#~ "from Person p where p.name.first='John' and p.name.last='Jingleheimer-" +#~ "Schmidt'" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[from Person p where p.name=('John', 'Jingleheimer-Schmidt')]]>" +#~ msgstr "from Person p where p.name=('John', 'Jingleheimer-Schmidt')" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[from Cat as cat\n" +#~ "where not ( cat.name, cat.color ) in (\n" +#~ " select cat.name, cat.color from DomesticCat cat\n" +#~ ")]]>" +#~ msgstr "" +#~ "from Cat as cat\n" +#~ "where not ( cat.name, cat.color ) in (\n" +#~ " select cat.name, cat.color from DomesticCat cat\n" +#~ ")" Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/query_sql.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/query_sql.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/query_sql.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,1863 @@ +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# Language /mnt/hgfs/base/Hibernate/Reference translations for PACKAGE package. +# Copyright (C) 2006, 2007 Free Software Foundation, Inc. +# Automatically generated, 2006. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# +msgid "" +msgstr "" +"Project-Id-Version: Collection_Mapping\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2009-12-03T00:15:27\n" +"PO-Revision-Date: 2007-02-26 10:27+1000\n" +"Last-Translator: \n" +"Language-Team: <de(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.9.1\n" + +#. Tag: title +#, no-c-format +msgid "Native SQL" +msgstr "Native SQL" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can also express queries in the native SQL dialect of your database. " +"This is useful if you want to utilize database-specific features such as " +"query hints or the <literal>CONNECT</literal> keyword in Oracle. It also " +"provides a clean migration path from a direct SQL/JDBC based application to " +"Hibernate." +msgstr "" +"Sie können Anfragen im nativen SQL-Dialekt Ihrer Datenbank ausdrücken. Das " +"ist insbesondere dann von Nutzen, wenn Sie Datenbank-spezifische Features " +"wie Anfragetipps oder den <literal>CONNECT</literal>-Schlüsselbegriff in " +"Oracle verwenden wollen. Außerdem steht dadurch ein Migrationspfad von einer " +"direkten, auf SQL/JDBC basierenden Anwendung zu Hibernate zur Verfügung." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate3 allows you to specify handwritten SQL, including stored " +"procedures, for all create, update, delete, and load operations." +msgstr "" +"Mit Hibernate3 können Sie per Hand geschriebene SQL (einschließlich " +"gespeicherter Prozeduren) für alle create, update, delete, und load Vorgänge " +"festlegen." + +#. Tag: title +#, fuzzy, no-c-format +msgid "Using a <literal>SQLQuery</literal>" +msgstr "oder als eine <literal>List</literal>," + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Execution of native SQL queries is controlled via the <literal>SQLQuery</" +"literal> interface, which is obtained by calling <literal>Session." +"createSQLQuery()</literal>. The following sections describe how to use this " +"API for querying." +msgstr "" +"Die Ausführung nativer SQL-Anfragen wird mittels <literal>SQLQuery</literal>-" +"Interface gesteuert, das man durch Aufruf von <literal>Session.createSQLQuery" +"()</literal> erhält. Nachfolgend erläutern wir die Verwendung dieser API für " +"Anfragen." + +#. Tag: title +#, no-c-format +msgid "Scalar queries" +msgstr "Skalare Anfragen" + +#. Tag: para +#, no-c-format +msgid "The most basic SQL query is to get a list of scalars (values)." +msgstr "" +"Die grundlegendste SQL-Anfrage erfolgt durch eine Liste von Skalaren " +"(Werten)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"These will return a List of Object arrays (Object[]) with scalar values for " +"each column in the CATS table. Hibernate will use ResultSetMetadata to " +"deduce the actual order and types of the returned scalar values." +msgstr "" +"Beides reagiert mit einer Liste von Objekt-Datenelementen (Object[]) mit " +"skalaren Werten für jede Spalte der CATS-Tabelle. Hibernate wird unter " +"Verwendung von ResultSetMetadata die tatsächliche Anordnung und Typen der " +"erhaltenen Skalarwerte ableiten." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"To avoid the overhead of using <literal>ResultSetMetadata</literal>, or " +"simply to be more explicit in what is returned, one can use " +"<literal>addScalar()</literal>:" +msgstr "" +"Um den Zusatz der Verwendung von <literal>ResultSetMetadata</literal> zu " +"vermeiden oder einfach expliziter zu sein, können Sie <literal>addScalar()</" +"literal> verwenden." + +#. Tag: para +#, no-c-format +msgid "This query specified:" +msgstr "Diese Anfrage spezifiziert:" + +#. Tag: para +#, no-c-format +msgid "the SQL query string" +msgstr "den SQL-Anfragen-String" + +#. Tag: para +#, no-c-format +msgid "the columns and types to return" +msgstr "die wiederzugebenden Spalten und Typen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This will return Object arrays, but now it will not use " +"<literal>ResultSetMetadata</literal> but will instead explicitly get the ID, " +"NAME and BIRTHDATE column as respectively a Long, String and a Short from " +"the underlying resultset. This also means that only these three columns will " +"be returned, even though the query is using <literal>*</literal> and could " +"return more than the three listed columns." +msgstr "" +"Dadurch werden Objektreihen wiedergegeben, jedoch werden keine " +"<literal>ResultSetMetdata</literal> verwendet, sondern es wird explizit die " +"ID, NAME und BIRTHDATE Spalte als ein Long, String und ein Short vom zu " +"Grunde liegenden Ergebnissatz (\"result set\") geholt. Das bedeutet auch, " +"dass nur diese drei Spalten wiedergegeben werden, selbst wenn die Anfrage " +"<literal>*</literal> verwendet und mehr als die drei gelisteten Spalten " +"wiedergeben könnte." + +#. Tag: para +#, no-c-format +msgid "" +"It is possible to leave out the type information for all or some of the " +"scalars." +msgstr "" +"Es ist möglich, die Typeninformationen für alle oder einige der Skalare " +"auszulassen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This is essentially the same query as before, but now " +"<literal>ResultSetMetaData</literal> is used to determine the type of NAME " +"and BIRTHDATE, where as the type of ID is explicitly specified." +msgstr "" +"Es handelt sich im Wesentlichen um diesselbe Anfrage wie zuvor, außer dass " +"jetzt <literal>ResultSetMetaData</literal> verwendet wurde, um den Typ von " +"NAME und BIRTHDATE zu bestimmen, während der ID-Typ explizit spezifiziert " +"wird." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"How the java.sql.Types returned from ResultSetMetaData is mapped to " +"Hibernate types is controlled by the Dialect. If a specific type is not " +"mapped, or does not result in the expected type, it is possible to customize " +"it via calls to <literal>registerHibernateType</literal> in the Dialect." +msgstr "" +"Der Dialekt steuert, wie die java.sql.Typen, die von ResultSetMetaData " +"erhalten werden, zu Hibernate Typen gemappt werden. Falls ein bestimmter Typ " +"nicht gemappt ist oder nicht den erwarteten Typ hervorbringt, so ist es " +"möglich, dies durch Anpassung an <literal>registerHibernateType</literal> im " +"Dialekt anzupassen." + +#. Tag: title +#, no-c-format +msgid "Entity queries" +msgstr "Entity-Anfragen" + +#. Tag: para +#, no-c-format +msgid "" +"The above queries were all about returning scalar values, basically " +"returning the \"raw\" values from the resultset. The following shows how to " +"get entity objects from a native sql query via <literal>addEntity()</" +"literal>." +msgstr "" +"Die Anfragen oben behandeln die erhaltenen Skalarwerte, wobei es sich dabei " +"um die \"unbearbeiteten\" Werte von resultset handelt. Nachfolgend sehen " +"Sie, wie Sie Entity-Objekte von einer nativen SQL-Anfrage mittels " +"<literal>addEntity()</literal> erhalten." + +#. Tag: para +#, no-c-format +msgid "the entity returned by the query" +msgstr "die von der Anfrage wiedergegebene Entity" + +#. Tag: para +#, no-c-format +msgid "" +"Assuming that Cat is mapped as a class with the columns ID, NAME and " +"BIRTHDATE the above queries will both return a List where each element is a " +"Cat entity." +msgstr "" +"Geht man davon aus, dass Cat als Klasse mit den Spalten ID, NAME und " +"BIRTHDATE gemappt ist, werden die Anfragen oben beide mit einer Liste " +"antworten, in der jedes Element eine Entity von Cat ist." + +#. Tag: para +#, no-c-format +msgid "" +"If the entity is mapped with a <literal>many-to-one</literal> to another " +"entity it is required to also return this when performing the native query, " +"otherwise a database specific \"column not found\" error will occur. The " +"additional columns will automatically be returned when using the * notation, " +"but we prefer to be explicit as in the following example for a <literal>many-" +"to-one</literal> to a <literal>Dog</literal>:" +msgstr "" +"Falls die Entity mit <literal>many-to-one</literal> zu einer anderen Entity " +"gemappt ist, so ist dies ebenfalls erforderlich wenn die native Anfrage " +"durchgeführt wird, da sonst eine Datenbank-spezifische \"Spalte nicht " +"gefunden\"-Fehlermeldung (\"column not found\") erscheint. Die zusätzlichen " +"Spalten werden bei Verwendung der * Notation automatisch wiedergegeben, aber " +"wie im folgenden Beispiel für eine <literal>many-to-one</literal> zu " +"<literal>Dog</literal> wollen wir lieber explizit sein:" + +#. Tag: para +#, no-c-format +msgid "This will allow cat.getDog() to function properly." +msgstr "Dies ermöglicht die ordnungsgemäße Funktion von cat.getDog()." + +#. Tag: title +#, no-c-format +msgid "Handling associations and collections" +msgstr "Umgang mit Assoziationen und Collections" + +#. Tag: para +#, no-c-format +msgid "" +"It is possible to eagerly join in the <literal>Dog</literal> to avoid the " +"possible extra roundtrip for initializing the proxy. This is done via the " +"<literal>addJoin()</literal> method, which allows you to join in an " +"association or collection." +msgstr "" +"Es ist möglich \"eager Join\" in <literal>Dog</literal> anzuwenden, um den " +"Extra-Weg zur Datenbank zur Initialisierung des Proxy zu vermeiden. Dies " +"geschieht mittels der <literal>addJoin()</literal>-Methode, die es Ihnen " +"ermöglicht, eine Assoziation oder Collection zu verbinden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"In this example, the returned <literal>Cat</literal>'s will have their " +"<literal>dog</literal> property fully initialized without any extra " +"roundtrip to the database. Notice that you added an alias name (\"cat\") to " +"be able to specify the target property path of the join. It is possible to " +"do the same eager joining for collections, e.g. if the <literal>Cat</" +"literal> had a one-to-many to <literal>Dog</literal> instead." +msgstr "" +"In diesem Beispiel ist die <literal>dog</literal>-Property der " +"wiedergegebenen <literal>Cat</literal>'s voll initialisiert, ohne dass ein " +"Extra-Weg zur Datenbank nötig ist. Beachten Sie, dass wir einen Alias-Namen " +"(\"cat\") hinzugefügt haben, um den Pfad der Ziel-Property der Verbindung " +"spezifizieren zu können. Es ist möglich, dasselbe für das \"eager Joining\" " +"von Collections zu tun, z.B. wenn <literal>Cat</literal> satt dessen eine " +"\"One-to-many\" zu <literal>Dog</literal> hätte." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"At this stage you are reaching the limits of what is possible with native " +"queries, without starting to enhance the sql queries to make them usable in " +"Hibernate. Problems can arise when returning multiple entities of the same " +"type or when the default alias/column names are not enough." +msgstr "" +"Wir erreichen nun den Punkt, an dem wir an die Grenzen dessen stoßen, was " +"mit nativen Anfragen möglich ist, ohne die sql-Anfragen weiterzuentwickeln, " +"um sie in Hibernate verwendbar zu machen. Das Problem zeigt sich erstmals, " +"wenn mehrere Entities desselben Typs auftauchen oder wenn die Standard " +"Alias-/Spaltennamen nicht ausreichen." + +#. Tag: title +#, no-c-format +msgid "Returning multiple entities" +msgstr "Wiedergabe mehrerer Entities" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Until now, the result set column names are assumed to be the same as the " +"column names specified in the mapping document. This can be problematic for " +"SQL queries that join multiple tables, since the same column names can " +"appear in more than one table." +msgstr "" +"Bis jetzt wird angenommen, dass die Spaltennamen des Ergebnissatzes " +"dieselben wie die im Mapping-Dokument spezifizierten Spaltennamen sind. Dies " +"kann problematisch für SQL-Anfragen sein, die mehrere Tabellen verbinden, da " +"dieselben Spaltennamen stets in mehr als einer Tabelle vorkommen." + +#. Tag: para +#, no-c-format +msgid "" +"Column alias injection is needed in the following query (which most likely " +"will fail):" +msgstr "" +"Spalten Alias-Einspeisung wird bei der folgenden Anfrage benötigt (die aller " +"Wahrscheinlichkeit nach fehlschlagen wird):" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The query was intended to return two Cat instances per row: a cat and its " +"mother. The query will, however, fail because there is a conflict of names; " +"the instances are mapped to the same column names. Also, on some databases " +"the returned column aliases will most likely be on the form \"c.ID\", \"c." +"NAME\", etc. which are not equal to the columns specified in the mappings " +"(\"ID\" and \"NAME\")." +msgstr "" +"Die Absicht dieser Anfrage ist es, das diese zwei Cat-Instanzen pro Reihe " +"wiedergibt, einer \"Cat\" und deren \"Mother\". Dies wird fehlschlagen, da " +"ein Namenskonflikt existiert, weil diese zu denselben Spaltennamen gemappt " +"sind; in manchen Datenbanken haben die wiedergegebenen Spalten-Aliasse aller " +"Wahrscheinlichkeit nach die Form \"c.ID\", \"c.NAME\", usw. die nicht " +"dieselbe wie die in den Mappings (\"ID\" und \"NAME\") spezifizierten " +"Spalten besitzt." + +#. Tag: para +#, no-c-format +msgid "The following form is not vulnerable to column name duplication:" +msgstr "" +"Die folgende Form ist nicht anfällig für die Duplizierung von Spaltennamen:" + +#. Tag: para +#, no-c-format +msgid "" +"the SQL query string, with placeholders for Hibernate to inject column " +"aliases" +msgstr "" +"der SQL Anfragen-String mit Platzhaltern für die durch Hibernate " +"eingespeisten Aliasse" + +#. Tag: para +#, no-c-format +msgid "the entities returned by the query" +msgstr "die von der Anfrage erhaltenen Entities" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The {cat.*} and {mother.*} notation used above is a shorthand for \"all " +"properties\". Alternatively, you can list the columns explicitly, but even " +"in this case Hibernate injects the SQL column aliases for each property. The " +"placeholder for a column alias is just the property name qualified by the " +"table alias. In the following example, you retrieve Cats and their mothers " +"from a different table (cat_log) to the one declared in the mapping " +"metadata. You can even use the property aliases in the where clause." +msgstr "" +"Die oben verwendete {cat.*} und {mother.*} Notation ist eine Kurzschrift für " +"\"alle Properties\". Alternativ können Sie die Spalten direkt auflisten, " +"wobei wir aber selbst in diesem Fall Hibernate die SQL Spalten-Aliasse für " +"jede Property einspeisen lassen. Der Platzhalter für einen Spalten-Alias ist " +"einfach der durch den Tabellen-Alias definierte Property-Name. Im folgenden " +"Beispiel erhalten wir \"Cats\" und deren \"Mothers\" von einer anderen " +"Tabelle (cat_log) als der in den Mapping-Metadata deklarierten. Beachten " +"Sie, dass wir sogar die Property-Aliasse in der \"where\"-Klausel verwenden " +"können, wenn wir das möchten." + +#. Tag: title +#, no-c-format +msgid "Alias and property references" +msgstr "Alias- und Property-Referenzen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"In most cases the above alias injection is needed. For queries relating to " +"more complex mappings, like composite properties, inheritance " +"discriminators, collections etc., you can use specific aliases that allow " +"Hibernate to inject the proper aliases." +msgstr "" +"In den meisten Fällen wird die obige Alias-Einspeisung benötigt, jedoch " +"müssen für komplexere Mappings betreffende Anfragen wie zusammengesetzte " +"Properties, Vererbungsdiskriminatoren, Collections usw. spezielle Aliasse " +"verwendet werden, die es Hibernate erlauben, die korrekten Aliasse " +"einzuspeisen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The following table shows the different ways you can use the alias " +"injection. Please note that the alias names in the result are simply " +"examples; each alias will have a unique and probably different name when " +"used." +msgstr "" +"Die folgende Tabelle zeigt die verschiedenen Möglichkeiten wie die Alias-" +"Einspeisung verwendet werden kann. Hinweis: Die Alias-Namen im Ergebnis sind " +"Beispiele, jeder Alias wird bei seiner Anwendung einen eindeutigen und " +"wahrscheinlich unterschiedlichen Namen besitzen." + +#. Tag: title +#, no-c-format +msgid "Alias injection names" +msgstr "Alias-Einspeisungsnamen" + +#. Tag: entry +#, no-c-format +msgid "Description" +msgstr "Beschreibung" + +#. Tag: entry +#, no-c-format +msgid "Syntax" +msgstr "Syntax" + +#. Tag: entry +#, no-c-format +msgid "Example" +msgstr "Beispiel" + +#. Tag: entry +#, no-c-format +msgid "A simple property" +msgstr "Eine einfache Property" + +#. Tag: entry +#, fuzzy, no-c-format +msgid "<literal>{[aliasname].[propertyname]</literal>" +msgstr "{[aliasname].[propertyname]" + +#. Tag: entry +#, fuzzy, no-c-format +msgid "<literal>A_NAME as {item.name}</literal>" +msgstr "A_NAME as {item.name}" + +#. Tag: entry +#, no-c-format +msgid "A composite property" +msgstr "Eine zusammengesetzte Property" + +#. Tag: entry +#, fuzzy, no-c-format +msgid "<literal>{[aliasname].[componentname].[propertyname]}</literal>" +msgstr "{[aliasname].[componentname].[propertyname]}" + +#. Tag: entry +#, fuzzy, no-c-format +msgid "" +"<literal>CURRENCY as {item.amount.currency}, VALUE as {item.amount.value}</" +"literal>" +msgstr "CURRENCY als {item.amount.currency}, VALUE als {item.amount.value}" + +#. Tag: entry +#, no-c-format +msgid "Discriminator of an entity" +msgstr "Diskriminator einer Entity" + +#. Tag: entry +#, fuzzy, no-c-format +msgid "<literal>{[aliasname].class}</literal>" +msgstr "{[aliasname].class}" + +#. Tag: entry +#, fuzzy, no-c-format +msgid "<literal>DISC as {item.class}</literal>" +msgstr "DISC as {item.class}" + +#. Tag: entry +#, no-c-format +msgid "All properties of an entity" +msgstr "Alle Properties einer Entity" + +#. Tag: entry +#, fuzzy, no-c-format +msgid "<literal>{[aliasname].*}</literal>" +msgstr "{[aliasname].*}" + +#. Tag: entry +#, fuzzy, no-c-format +msgid "<literal>{item.*}</literal>" +msgstr "oder als eine <literal>List</literal>," + +#. Tag: entry +#, no-c-format +msgid "A collection key" +msgstr "Ein Collection-Schlüssel" + +#. Tag: entry +#, fuzzy, no-c-format +msgid "<literal>{[aliasname].key}</literal>" +msgstr "{[aliasname].key}" + +#. Tag: entry +#, fuzzy, no-c-format +msgid "<literal>ORGID as {coll.key}</literal>" +msgstr "ORGID als {coll.key}" + +#. Tag: entry +#, no-c-format +msgid "The id of an collection" +msgstr "Die id einer Collection" + +#. Tag: entry +#, fuzzy, no-c-format +msgid "<literal>{[aliasname].id}</literal>" +msgstr "{[aliasname].id}" + +#. Tag: entry +#, fuzzy, no-c-format +msgid "<literal>EMPID as {coll.id}</literal>" +msgstr "EMPID als {coll.id}" + +#. Tag: entry +#, no-c-format +msgid "The element of an collection" +msgstr "Das Element einer Collection" + +#. Tag: entry +#, fuzzy, no-c-format +msgid "<literal>{[aliasname].element}</literal>" +msgstr "{[aliasname].element}" + +#. Tag: entry +#, fuzzy, no-c-format +msgid "<literal>XID as {coll.element}</literal>" +msgstr "XID als {coll.element}" + +#. Tag: entry +#, fuzzy, no-c-format +msgid "property of the element in the collection" +msgstr "Property des Elements in der Collection" + +#. Tag: entry +#, fuzzy, no-c-format +msgid "<literal>{[aliasname].element.[propertyname]}</literal>" +msgstr "{[aliasname].element.[propertyname]}" + +#. Tag: entry +#, fuzzy, no-c-format +msgid "<literal>NAME as {coll.element.name}</literal>" +msgstr "NAME als {coll.element.name}" + +#. Tag: entry +#, no-c-format +msgid "All properties of the element in the collection" +msgstr "Alle Properties des Elements in der Collection" + +#. Tag: entry +#, fuzzy, no-c-format +msgid "<literal>{[aliasname].element.*}</literal>" +msgstr "{[aliasname].element.*}" + +#. Tag: entry +#, fuzzy, no-c-format +msgid "<literal>{coll.element.*}</literal>" +msgstr "{coll.element.*}" + +#. Tag: entry +#, no-c-format +msgid "All properties of the the collection" +msgstr "Alle Properties der Collection" + +#. Tag: entry +#, fuzzy, no-c-format +msgid "<literal>{coll.*}</literal>" +msgstr "oder als eine <literal>List</literal>," + +#. Tag: title +#, no-c-format +msgid "Returning non-managed entities" +msgstr "Wiedergabe nicht gemanagter Entities" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"It is possible to apply a ResultTransformer to native SQL queries, allowing " +"it to return non-managed entities." +msgstr "" +"Es ist möglich, einen ResultTransformer (Ergebnistransformer) an nativen SQL-" +"Anfragen anzuwenden, der die Wiedergabe nicht gemanagter Entities ermöglicht." + +#. Tag: para +#, no-c-format +msgid "a result transformer" +msgstr "ein Ergebnistransformer" + +#. Tag: para +#, no-c-format +msgid "" +"The above query will return a list of <literal>CatDTO</literal> which has " +"been instantiated and injected the values of NAME and BIRTHNAME into its " +"corresponding properties or fields." +msgstr "" +"Die Anfrage oben wird eine Liste von <literal>CatDTO</literal> wiedergeben, " +"die instantiiert wurde und die Werte für NAME und BIRTHNAME in die " +"entsprechenden Properties oder Felder eingespeist hat." + +#. Tag: title +#, no-c-format +msgid "Handling inheritance" +msgstr "Umgang mit Vererbung" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Native SQL queries which query for entities that are mapped as part of an " +"inheritance must include all properties for the baseclass and all its " +"subclasses." +msgstr "" +"Native SQL-Anfragen für Entities, die als Teil einer Vererbung gemappt sind, " +"müssen sämtliche Properties für die Stammklasse und alle Subklassen " +"enthalten." + +#. Tag: title +#, no-c-format +msgid "Parameters" +msgstr "Parameter" + +#. Tag: para +#, fuzzy, no-c-format +msgid "Native SQL queries support positional as well as named parameters:" +msgstr "" +"Native SQL-Anfragen unterstützen sowohl positionelle als auch benannte " +"Parameter:" + +#. Tag: title +#, no-c-format +msgid "Named SQL queries" +msgstr "Benannte SQL-Anfragen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Named SQL queries can be defined in the mapping document and called in " +"exactly the same way as a named HQL query. In this case, you do " +"<emphasis>not</emphasis> need to call <literal>addEntity()</literal>." +msgstr "" +"Benannte SQL-Anfragen können im Mapping-Dokument definiert und auf dieselbe " +"Weise wie eine benannte HQL-Anfrage benannt werden. In diesem Fall muss " +"<emphasis>nicht</emphasis> der Aufruf <literal>addEntity()</literal> " +"erfolgen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal><return-join></literal> element is use to join " +"associations and the <literal><load-collection></literal> element is " +"used to define queries which initialize collections," +msgstr "" +"Die <literal><return-join></literal> und <literal><load-" +"collection></literal>-Elemente werden verwendet, um Assoziationen zu " +"verbinden bzw. Anfragen, die Collections definieren, zu initialisieren." + +#. Tag: para +#, no-c-format +msgid "" +"A named SQL query may return a scalar value. You must declare the column " +"alias and Hibernate type using the <literal><return-scalar></literal> " +"element:" +msgstr "" +"Eine benannte SQL-Anfrage kann einen Skalarwert wiedergeben. Sie müssen " +"unter Verwendung des <literal><return-scalar></literal>-Elements den " +"Spalten-Alias und den Hibernate-Typ deklarieren:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can externalize the resultset mapping information in a <literal><" +"resultset></literal> element which will allow you to either reuse them " +"across several named queries or through the <literal>setResultSetMapping()</" +"literal> API." +msgstr "" +"Sie können die Mapping-Informationen des Ergebnissatzes (\"resultset\") in " +"einem <literal><resultset></literal>-Element externalisieren, um diese " +"entweder über mehrere benannte Anfragen hinweg oder durch die " +"<literal>setResultSetMapping()</literal>-API wiederzuverwenden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can, alternatively, use the resultset mapping information in your hbm " +"files directly in java code." +msgstr "" +"Alternativ können Sie Mapping-Informationen des Ergebnissatzes in Ihren hbm-" +"Dateien direkt in Java Code verwenden." + +#. Tag: title +#, no-c-format +msgid "Using return-property to explicitly specify column/alias names" +msgstr "" +"Die Verwendung der Return-Property zur expliziten Spezifizierung von " +"Spalten-/Aliasnamen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can explicitly tell Hibernate what column aliases to use with " +"<literal><return-property></literal>, instead of using the <literal>{}" +"</literal>-syntax to let Hibernate inject its own aliases.For example:" +msgstr "" +"Mit <literal><return-property></literal> können Sie Hibernate explizit " +"anweisen, welche Aliasse es verwenden soll, statt die <literal>{}</literal>-" +"Syntax zu verwenden, bei der Hibernate seine eigenen Aliasse einspeist." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal><return-property></literal> also works with multiple columns. " +"This solves a limitation with the <literal>{}</literal>-syntax which cannot " +"allow fine grained control of multi-column properties." +msgstr "" +"<literal><return-property></literal> funktioniert auch mit mehreren " +"Spalten. Dies löst die Einschränkungen der <literal>{}</literal>-Syntax, die " +"keine feinstufige Steuerung mehrspaltiger Properties erlaubt." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"In this example <literal><return-property></literal> was used in " +"combination with the <literal>{}</literal>-syntax for injection. This allows " +"users to choose how they want to refer column and properties." +msgstr "" +"Bitte beachten Sie, dass wir in diesem Beispiel <literal><return-" +"property></literal> in Verbindung mit der <literal>{}</literal>-Syntax " +"für die Einspeisung verwendet haben. Dadurch ist es Benutzern möglich zu " +"entscheiden, wie auf Spalten und Properties verwiesen werden soll." + +#. Tag: para +#, no-c-format +msgid "" +"If your mapping has a discriminator you must use <literal><return-" +"discriminator></literal> to specify the discriminator column." +msgstr "" +"Falls Ihr Mapping über einen Diskriminator verfügt, so müssen Sie " +"<literal><return-discriminator></literal> verwenden, um die " +"Diskriminator-Spalte festzulegen." + +#. Tag: title +#, no-c-format +msgid "Using stored procedures for querying" +msgstr "Die Verwendung gespeicherter Prozeduren für Anfragen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate3 provides support for queries via stored procedures and functions. " +"Most of the following documentation is equivalent for both. The stored " +"procedure/function must return a resultset as the first out-parameter to be " +"able to work with Hibernate. An example of such a stored function in Oracle " +"9 and higher is as follows:" +msgstr "" +"Hibernate 3 bietet Support für Anfragen via gespeicherter Prozeduren und " +"Funktionen. Die meisten Teile der nachfolgenden Dokumentation sind für beide " +"gleich. Die gespeicherte Prozedur/Funktion muss einen Ergebnissatz als " +"ersten \"out-Parameter\" wiedergeben, um mit Hibernate arbeiten zu können. " +"Ein Beispiel für eine solche gespeicherte Funktion in Oracle 9 und späteren " +"Versionen lautet wie folgt:" + +#. Tag: para +#, no-c-format +msgid "To use this query in Hibernate you need to map it via a named query." +msgstr "" +"Um diese Anfrage in Hibernate zu verwenden, müssen Sie sie durch eine " +"benannte Anfrage mappen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Stored procedures currently only return scalars and entities. <literal><" +"return-join></literal> and <literal><load-collection></literal> are " +"not supported." +msgstr "" +"Bitte beachten Sie, dass gespeicherte Prozeduren gegenwärtig nur Skalare und " +"Entities wiedergeben. <literal><return-join></literal> und " +"<literal><load-collection></literal> werden nicht unterstützt." + +#. Tag: title +#, no-c-format +msgid "Rules/limitations for using stored procedures" +msgstr "Regeln/Einschränkungen bei der Verwendung gespeicherter Prozeduren" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You cannot use stored procedures with Hibernate unless you follow some " +"procedure/function rules. If they do not follow those rules they are not " +"usable with Hibernate. If you still want to use these procedures you have to " +"execute them via <literal>session.connection()</literal>. The rules are " +"different for each database, since database vendors have different stored " +"procedure semantics/syntax." +msgstr "" +"Um gespeicherte Prozeduren mit Hibernate zu verwenden, müssen die Prozeduren/" +"Funktionen einigen Regeln folgen. Falls sie diese nicht berücksichtigen, " +"können sie nicht mit Hibernate verwendet werden. Falls Sie diese Prozeduren " +"dennoch benutzen wollen, so müssen Sie sie mittels <literal>session." +"connection()</literal> ausführen. Die Regeln sind für jede Datenbank anders, " +"da Datenbankanbieter jeweils über verschiedene gespeicherte Semantik/Syntax " +"für Prozeduren verfügen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Stored procedure queries cannot be paged with <literal>setFirstResult()/" +"setMaxResults()</literal>." +msgstr "" +"Gespeicherte Prozeduren können nicht mit <literal>setFirstResult()/" +"setMaxResults()</literal> seitenweise umgespeichert werden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The recommended call form is standard SQL92: <literal>{ ? = call functionName" +"(<parameters>) }</literal> or <literal>{ ? = call procedureName(<" +"parameters>}</literal>. Native call syntax is not supported." +msgstr "" +"Die empfohlen Form für den Aufruf ist Standard SQL92: <literal>{ ? = call " +"functionName (<parameters>) }</literal> oder <literal>{ ? = call " +"procedureName(<parameters>}</literal>. Native Aufrufsyntax wird nicht " +"unterstützt." + +#. Tag: para +#, no-c-format +msgid "For Oracle the following rules apply:" +msgstr "Für Oracle gelten die folgenden Regeln:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A function must return a result set. The first parameter of a procedure must " +"be an <literal>OUT</literal> that returns a result set. This is done by " +"using a <literal>SYS_REFCURSOR</literal> type in Oracle 9 or 10. In Oracle " +"you need to define a <literal>REF CURSOR</literal> type. See Oracle " +"literature for further information." +msgstr "" +"Eine Funktion muss mit einem Ergebnissatz (\"result set\") reagieren. Der " +"erste Parameter einer Prozedur muss ein <literal>OUT</literal> sein, das " +"einen Satz von Ergenissen liefert. Dies geschieht unter Verwendung eines " +"<literal>SYS_REFCURSOR</literal>-Typs in Oracle 9 oder 10. In Oracle müssen " +"Sie einen <literal>REF CURSOR</literal>-Typ definieren, siehe auch in " +"Literatur zu Oracle." + +#. Tag: para +#, no-c-format +msgid "For Sybase or MS SQL server the following rules apply:" +msgstr "Für Sybase oder MS SQL Server gelten die folgenden Regeln:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The procedure must return a result set. Note that since these servers can " +"return multiple result sets and update counts, Hibernate will iterate the " +"results and take the first result that is a result set as its return value. " +"Everything else will be discarded." +msgstr "" +"Eine Prozedur muss mit einem Ergebnissatz (\"result set\") reagieren. Bitte " +"beachten Sie, dass - da diese Server mit mehreren Ergebnissätzen reagieren " +"können/werden und Zählungen aktualisieren - Hibernate die Ergebnisse " +"wiederholt und das erste Ergebnis als Wiedergabewert nimmt, das einen " +"Ergebnissatz darstellt. Alles andere wird verworfen." + +#. Tag: para +#, no-c-format +msgid "" +"If you can enable <literal>SET NOCOUNT ON</literal> in your procedure it " +"will probably be more efficient, but this is not a requirement." +msgstr "" +"Falls Sie <literal>SET NOCOUNT ON</literal> in Ihrer Prozedur aktivieren " +"können, so würde sie wahrscheinlich effizienter. Dies ist jedoch keine " +"Voraussetzung." + +#. Tag: title +#, no-c-format +msgid "Custom SQL for create, update and delete" +msgstr "" +"Anwenderspezifische SQL für \"create\" (erstellen), \"update" +"\" (aktualisieren) und \"delete\" (löschen)" + +#. Tag: para +#, no-c-format +msgid "" +"Hibernate3 can use custom SQL statements for create, update, and delete " +"operations. The class and collection persisters in Hibernate already contain " +"a set of configuration time generated strings (insertsql, deletesql, " +"updatesql etc.). The mapping tags <literal><sql-insert></literal>, " +"<literal><sql-delete></literal>, and <literal><sql-update></" +"literal> override these strings:" +msgstr "" +"Hibernate3 kann angepasste SQL-Anweisungen für \"create\", \"update\", und " +"\"delete\" Vorgänge verwenden. Die Klassen- und Collection-Persister in " +"Hibernate enthalten bereits einen Satz von zur Konfigurationszeit " +"generierten Strings (insertsql, deletesql, updatesql usw.). Die Mapping-Tags " +"<literal><sql-insert></literal>, <literal><sql-delete></literal> " +"und <literal><sql-update></literal> setzen diese Strings außer Kraft:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The SQL is directly executed in your database, so you can use any dialect " +"you like. This will reduce the portability of your mapping if you use " +"database specific SQL." +msgstr "" +"Die SQL wird direkt in Ihrer Datenbank ausgeführt, Sie können daher jeden " +"beliebigen Dialekt verwenden. Dies wird natürlich die Übertragbarkeit Ihres " +"Mappings reduzieren, wenn Sie Datenbank-spezifische SQL benutzen." + +#. Tag: para +#, no-c-format +msgid "" +"Stored procedures are supported if the <literal>callable</literal> attribute " +"is set:" +msgstr "" +"Gespeicherte Prozeduren werden unterstützt, wenn das <literal>callable</" +"literal>-Attribut wie folgt eingestellt ist:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The order of the positional parameters is vital, as they must be in the same " +"sequence as Hibernate expects them." +msgstr "" +"Die Reihenfolge der positionellen Parameter ist gegenwärtig entscheidend, da " +"sie dieselbe Sequenz besitzen müssen, wie Hibernate sie erwartet." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can view 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 view the expected sequence, do not include " +"your custom SQL in the mapping files, as this will override the Hibernate " +"generated static SQL." +msgstr "" +"Sie können die erwartete Reihenfolge sehen, indem Sie Debug-Protokollierung " +"für die<literal>org.hibernate.persister.entity</literal>-Ebene aktivieren. " +"Wenn diese Ebene aktiviert ist, druckt Hibernate die statische SQL aus, die " +"zur Erstellung, Aktualisierung, Löschung usw. von Entities verwendet wird. " +"(Um die erwartete Sequenz zu sehen, denken Sie daran, Ihre angepasste SQL " +"nicht in die Mapping-Dateien einzuschließen, da diese die durch Hibernate " +"generierte statische sql außer Kraft setzt)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The stored procedures are in most cases required to return the number of " +"rows inserted, updated and deleted, as Hibernate has some runtime checks for " +"the success of the statement. Hibernate always registers the first statement " +"parameter as a numeric output parameter for the CUD operations:" +msgstr "" +"Die gespeicherten Prozeduren sind in den meisten Fällen (bzw. fast immer) " +"für die Wiedergabe der Anzahl von eingefügten/aktualisierten/gelöschten " +"Reihen erforderlich, da Hibernate einige Runtime-Überprüfungen hinsichtlich " +"des Erfolgs der Anweisung durchführt. Hibernate registriert immer den ersten " +"Anweisungsparameter als numerischen Ausgabeparameter für die CUD-Vorgänge:" + +#. Tag: title +#, no-c-format +msgid "Custom SQL for loading" +msgstr "Angepasste SQL für das Laden" + +#. Tag: para +#, fuzzy, no-c-format +msgid "You can also declare your own SQL (or HQL) queries for entity loading:" +msgstr "" +"Sie können auch Ihre eigenen SQL (oder HQL)-Anfragen für das Laden von " +"Entities deklarieren:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This is just a named query declaration, as discussed earlier. You can " +"reference this named query in a class mapping:" +msgstr "" +"Hier handelt es sich lediglich um eine Anfragendeklaration, wie zuvor " +"erläutert. Sie können auf diese benannte Anfrage in einem Klassen-Mapping " +"verweisen:" + +#. Tag: para +#, no-c-format +msgid "This even works with stored procedures." +msgstr "Das funktioniert sogar mit gespeicherten Prozeduren." + +#. Tag: para +#, fuzzy, no-c-format +msgid "You can even define a query for collection loading:" +msgstr "" +"Sie können sogar eine Anfrage für das Laden von Collections definieren:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can also define an entity loader that loads a collection by join " +"fetching:" +msgstr "" +"Sie könnten sogar einen Entity-Loader definieren, der eine Collection " +"mittels \"Join-Fetching\" lädt:" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[sess.createSQLQuery(\"SELECT * FROM CATS\").list();\n" +#~ "sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE FROM CATS\").list();\n" +#~ "]]>" +#~ msgstr "" +#~ "sess.createSQLQuery(\"SELECT * FROM CATS\").list();\n" +#~ "sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE FROM CATS\").list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[sess.createSQLQuery(\"SELECT * FROM CATS\")\n" +#~ " .addScalar(\"ID\", Hibernate.LONG)\n" +#~ " .addScalar(\"NAME\", Hibernate.STRING)\n" +#~ " .addScalar(\"BIRTHDATE\", Hibernate.DATE)\n" +#~ "]]>" +#~ msgstr "" +#~ "sess.createSQLQuery(\"SELECT * FROM CATS\")\n" +#~ " .addScalar(\"ID\", Hibernate.LONG)\n" +#~ " .addScalar(\"NAME\", Hibernate.STRING)\n" +#~ " .addScalar(\"BIRTHDATE\", Hibernate.DATE)" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[sess.createSQLQuery(\"SELECT * FROM CATS\")\n" +#~ " .addScalar(\"ID\", Hibernate.LONG)\n" +#~ " .addScalar(\"NAME\")\n" +#~ " .addScalar(\"BIRTHDATE\")\n" +#~ "]]>" +#~ msgstr "" +#~ "sess.createSQLQuery(\"SELECT * FROM CATS\")\n" +#~ " .addScalar(\"ID\", Hibernate.LONG)\n" +#~ " .addScalar(\"NAME\")\n" +#~ " .addScalar(\"BIRTHDATE\")" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[sess.createSQLQuery(\"SELECT * FROM CATS\").addEntity(Cat." +#~ "class);\n" +#~ "sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE FROM CATS\").addEntity" +#~ "(Cat.class);\n" +#~ "]]>" +#~ msgstr "" +#~ "sess.createSQLQuery(\"SELECT * FROM CATS\").addEntity(Cat.class);\n" +#~ "sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE FROM CATS\").addEntity" +#~ "(Cat.class);" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE, DOG_ID FROM " +#~ "CATS\").addEntity(Cat.class);\n" +#~ "]]>" +#~ msgstr "" +#~ "sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE, DOG_ID FROM CATS\")." +#~ "addEntity(Cat.class);" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[sess.createSQLQuery(\"SELECT c.ID, NAME, BIRTHDATE, DOG_ID, " +#~ "D_ID, D_NAME FROM CATS c, DOGS d WHERE c.DOG_ID = d.D_ID\")\n" +#~ " .addEntity(\"cat\", Cat.class)\n" +#~ " .addJoin(\"cat.dog\");\n" +#~ "]]>" +#~ msgstr "" +#~ "sess.createSQLQuery(\"SELECT c.ID, NAME, BIRTHDATE, DOG_ID, D_ID, D_NAME " +#~ "FROM CATS c, DOGS d \n" +#~ " WHERE c.DOG_ID = d.D_ID\")\n" +#~ " .addEntity(\"cat\", Cat.class)\n" +#~ " .addJoin(\"cat.dog\");" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE, D_ID, D_NAME, " +#~ "CAT_ID FROM CATS c, DOGS d WHERE c.ID = d.CAT_ID\")\n" +#~ " .addEntity(\"cat\", Cat.class)\n" +#~ " .addJoin(\"cat.dogs\");\n" +#~ "]]>" +#~ msgstr "" +#~ "sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE, D_ID, D_NAME, CAT_ID " +#~ "FROM CATS c, DOGS d\n" +#~ " WHERE c.ID = d.CAT_ID\")\n" +#~ " .addEntity(\"cat\", Cat.class)\n" +#~ " .addJoin(\"cat.dogs\");" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[sess.createSQLQuery(\"SELECT c.*, m.* FROM CATS c, CATS m WHERE " +#~ "c.MOTHER_ID = c.ID\")\n" +#~ " .addEntity(\"cat\", Cat.class)\n" +#~ " .addEntity(\"mother\", Cat.class)\n" +#~ "]]>" +#~ msgstr "" +#~ "sess.createSQLQuery(\"SELECT c.*, m.* FROM CATS c, CATS m WHERE c." +#~ "MOTHER_ID = c.ID\")\n" +#~ " .addEntity(\"cat\", Cat.class)\n" +#~ " .addEntity(\"mother\", Cat.class)" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[sess.createSQLQuery(\"SELECT {cat.*}, {mother.*} FROM CATS c, " +#~ "CATS m WHERE c.MOTHER_ID = c.ID\")\n" +#~ " .addEntity(\"cat\", Cat.class)\n" +#~ " .addEntity(\"mother\", Cat.class)\n" +#~ "]]>" +#~ msgstr "" +#~ "sess.createSQLQuery(\"SELECT {cat.*}, {mother.*} FROM CATS c, CATS m " +#~ "WHERE c.MOTHER_ID = c.ID\")\n" +#~ " .addEntity(\"cat\", Cat.class)\n" +#~ " .addEntity(\"mother\", Cat.class)" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[String sql = \"SELECT ID as {c.id}, NAME as {c.name}, \" + \n" +#~ " \"BIRTHDATE as {c.birthDate}, MOTHER_ID as {c.mother}, {mother." +#~ "*} \" +\n" +#~ " \"FROM CAT_LOG c, CAT_LOG m WHERE {c.mother} = c.ID\";\n" +#~ "\n" +#~ "List loggedCats = sess.createSQLQuery(sql)\n" +#~ " .addEntity(\"cat\", Cat.class)\n" +#~ " .addEntity(\"mother\", Cat.class).list()\n" +#~ "]]>" +#~ msgstr "" +#~ "String sql = \"SELECT ID as {c.id}, NAME as {c.name}, \" + \n" +#~ " \"BIRTHDATE as {c.birthDate}, MOTHER_ID as {c.mother}, {mother." +#~ "*} \" +\n" +#~ " \"FROM CAT_LOG c, CAT_LOG m WHERE {c.mother} = c.ID\";\n" +#~ "\n" +#~ "List loggedCats = sess.createSQLQuery(sql)\n" +#~ " .addEntity(\"cat\", Cat.class)\n" +#~ " .addEntity(\"mother\", Cat.class).list()" + +#~ msgid "{item.*}" +#~ msgstr "{item.*}" + +#~ msgid "{coll.*}" +#~ msgstr "{coll.*}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[sess.createSQLQuery(\"SELECT NAME, BIRTHDATE FROM CATS\")\n" +#~ " .setResultTransformer(Transformers.aliasToBean(CatDTO.class))]]>" +#~ msgstr "" +#~ "sess.createSQLQuery(\"SELECT NAME, BIRTHDATE FROM CATS\")\n" +#~ " .setResultTransformer(Transformers.aliasToBean(CatDTO.class))" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Query query = sess.createSQLQuery(\"SELECT * FROM CATS WHERE " +#~ "NAME like ?\").addEntity(Cat.class);\n" +#~ "List pusList = query.setString(0, \"Pus%\").list();\n" +#~ " \n" +#~ "query = sess.createSQLQuery(\"SELECT * FROM CATS WHERE NAME like :name\")." +#~ "addEntity(Cat.class);\n" +#~ "List pusList = query.setString(\"name\", \"Pus%\").list(); ]]>" +#~ msgstr "" +#~ "Query query = sess.createSQLQuery(\"SELECT * FROM CATS WHERE NAME like ?" +#~ "\").addEntity(Cat.class);\n" +#~ "List pusList = query.setString(0, \"Pus%\").list();\n" +#~ " \n" +#~ "query = sess.createSQLQuery(\"SELECT * FROM CATS WHERE NAME like :name\")." +#~ "addEntity(Cat.class);\n" +#~ "List pusList = query.setString(\"name\", \"Pus%\").list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<sql-query name=\"persons\">\n" +#~ " <return alias=\"person\" class=\"eg.Person\"/>\n" +#~ " SELECT person.NAME AS {person.name},\n" +#~ " person.AGE AS {person.age},\n" +#~ " person.SEX AS {person.sex}\n" +#~ " FROM PERSON person\n" +#~ " WHERE person.NAME LIKE :namePattern\n" +#~ "</sql-query>]]>" +#~ msgstr "" +#~ "<sql-query name=\"persons\">\n" +#~ " <return alias=\"person\" class=\"eg.Person\"/>\n" +#~ " SELECT person.NAME AS {person.name},\n" +#~ " person.AGE AS {person.age},\n" +#~ " person.SEX AS {person.sex}\n" +#~ " FROM PERSON person\n" +#~ " WHERE person.NAME LIKE :namePattern\n" +#~ "</sql-query>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[List people = sess.getNamedQuery(\"persons\")\n" +#~ " .setString(\"namePattern\", namePattern)\n" +#~ " .setMaxResults(50)\n" +#~ " .list();]]>" +#~ msgstr "" +#~ "List people = sess.getNamedQuery(\"persons\")\n" +#~ " .setString(\"namePattern\", namePattern)\n" +#~ " .setMaxResults(50)\n" +#~ " .list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<sql-query name=\"personsWith\">\n" +#~ " <return alias=\"person\" class=\"eg.Person\"/>\n" +#~ " <return-join alias=\"address\" property=\"person.mailingAddress\"/>\n" +#~ " SELECT person.NAME AS {person.name},\n" +#~ " person.AGE AS {person.age},\n" +#~ " person.SEX AS {person.sex},\n" +#~ " address.STREET AS {address.street},\n" +#~ " address.CITY AS {address.city},\n" +#~ " address.STATE AS {address.state},\n" +#~ " address.ZIP AS {address.zip}\n" +#~ " FROM PERSON person\n" +#~ " JOIN ADDRESS address\n" +#~ " ON person.ID = address.PERSON_ID AND address.TYPE='MAILING'\n" +#~ " WHERE person.NAME LIKE :namePattern\n" +#~ "</sql-query>]]>" +#~ msgstr "" +#~ "<sql-query name=\"personsWith\">\n" +#~ " <return alias=\"person\" class=\"eg.Person\"/>\n" +#~ " <return-join alias=\"address\" property=\"person.mailingAddress\"/" +#~ ">\n" +#~ " SELECT person.NAME AS {person.name},\n" +#~ " person.AGE AS {person.age},\n" +#~ " person.SEX AS {person.sex},\n" +#~ " adddress.STREET AS {address.street},\n" +#~ " adddress.CITY AS {address.city},\n" +#~ " adddress.STATE AS {address.state},\n" +#~ " adddress.ZIP AS {address.zip}\n" +#~ " FROM PERSON person\n" +#~ " JOIN ADDRESS adddress\n" +#~ " ON person.ID = address.PERSON_ID AND address.TYPE='MAILING'\n" +#~ " WHERE person.NAME LIKE :namePattern\n" +#~ "</sql-query>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<sql-query name=\"mySqlQuery\">\n" +#~ " <return-scalar column=\"name\" type=\"string\"/>\n" +#~ " <return-scalar column=\"age\" type=\"long\"/>\n" +#~ " SELECT p.NAME AS name,\n" +#~ " p.AGE AS age,\n" +#~ " FROM PERSON p WHERE p.NAME LIKE 'Hiber%'\n" +#~ "</sql-query>]]>" +#~ msgstr "" +#~ "<sql-query name=\"mySqlQuery\">\n" +#~ " <return-scalar column=\"name\" type=\"string\"/>\n" +#~ " <return-scalar column=\"age\" type=\"long\"/>\n" +#~ " SELECT p.NAME AS name,\n" +#~ " p.AGE AS age,\n" +#~ " FROM PERSON p WHERE p.NAME LIKE 'Hiber%'\n" +#~ "</sql-query>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<resultset name=\"personAddress\">\n" +#~ " <return alias=\"person\" class=\"eg.Person\"/>\n" +#~ " <return-join alias=\"address\" property=\"person.mailingAddress\"/>\n" +#~ "</resultset>\n" +#~ "\n" +#~ "<sql-query name=\"personsWith\" resultset-ref=\"personAddress\">\n" +#~ " SELECT person.NAME AS {person.name},\n" +#~ " person.AGE AS {person.age},\n" +#~ " person.SEX AS {person.sex},\n" +#~ " address.STREET AS {address.street},\n" +#~ " address.CITY AS {address.city},\n" +#~ " address.STATE AS {address.state},\n" +#~ " address.ZIP AS {address.zip}\n" +#~ " FROM PERSON person\n" +#~ " JOIN ADDRESS address\n" +#~ " ON person.ID = address.PERSON_ID AND address.TYPE='MAILING'\n" +#~ " WHERE person.NAME LIKE :namePattern\n" +#~ "</sql-query>]]>" +#~ msgstr "" +#~ "<resultset name=\"personAddress\">\n" +#~ " <return alias=\"person\" class=\"eg.Person\"/>\n" +#~ " <return-join alias=\"address\" property=\"person.mailingAddress\"/" +#~ ">\n" +#~ "</resultset>\n" +#~ "\n" +#~ "<sql-query name=\"personsWith\" resultset-ref=\"personAddress\">\n" +#~ " SELECT person.NAME AS {person.name},\n" +#~ " person.AGE AS {person.age},\n" +#~ " person.SEX AS {person.sex},\n" +#~ " adddress.STREET AS {address.street},\n" +#~ " adddress.CITY AS {address.city},\n" +#~ " adddress.STATE AS {address.state},\n" +#~ " adddress.ZIP AS {address.zip}\n" +#~ " FROM PERSON person\n" +#~ " JOIN ADDRESS adddress\n" +#~ " ON person.ID = address.PERSON_ID AND address.TYPE='MAILING'\n" +#~ " WHERE person.NAME LIKE :namePattern\n" +#~ "</sql-query>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[List cats = sess.createSQLQuery(\n" +#~ " \"select {cat.*}, {kitten.*} from cats cat, cats kitten where " +#~ "kitten.mother = cat.id\"\n" +#~ " )\n" +#~ " .setResultSetMapping(\"catAndKitten\")\n" +#~ " .list();]]>" +#~ msgstr "" +#~ "List cats = sess.createSQLQuery(\n" +#~ " \"select {cat.*}, {kitten.*} from cats cat, cats kitten where " +#~ "kitten.mother = cat.id\"\n" +#~ " )\n" +#~ " .setResultSetMapping(\"catAndKitten\")\n" +#~ " .list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<sql-query name=\"mySqlQuery\">\n" +#~ " <return alias=\"person\" class=\"eg.Person\">\n" +#~ " <return-property name=\"name\" column=\"myName\"/>\n" +#~ " <return-property name=\"age\" column=\"myAge\"/>\n" +#~ " <return-property name=\"sex\" column=\"mySex\"/>\n" +#~ " </return>\n" +#~ " SELECT person.NAME AS myName,\n" +#~ " person.AGE AS myAge,\n" +#~ " person.SEX AS mySex,\n" +#~ " FROM PERSON person WHERE person.NAME LIKE :name\n" +#~ "</sql-query>\n" +#~ "]]>" +#~ msgstr "" +#~ "<sql-query name=\"mySqlQuery\">\n" +#~ " <return alias=\"person\" class=\"eg.Person\">\n" +#~ " <return-property name=\"name\" column=\"myName\"/>\n" +#~ " <return-property name=\"age\" column=\"myAge\"/>\n" +#~ " <return-property name=\"sex\" column=\"mySex\"/>\n" +#~ " </return>\n" +#~ " SELECT person.NAME AS myName,\n" +#~ " person.AGE AS myAge,\n" +#~ " person.SEX AS mySex,\n" +#~ " FROM PERSON person WHERE person.NAME LIKE :name\n" +#~ "</sql-query>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<sql-query name=\"organizationCurrentEmployments\">\n" +#~ " <return alias=\"emp\" class=\"Employment\">\n" +#~ " <return-property name=\"salary\">\n" +#~ " <return-column name=\"VALUE\"/>\n" +#~ " <return-column name=\"CURRENCY\"/>\n" +#~ " </return-property>\n" +#~ " <return-property name=\"endDate\" column=\"myEndDate\"/>\n" +#~ " </return>\n" +#~ " SELECT EMPLOYEE AS {emp.employee}, EMPLOYER AS {emp.employer},\n" +#~ " STARTDATE AS {emp.startDate}, ENDDATE AS {emp.endDate},\n" +#~ " REGIONCODE as {emp.regionCode}, EID AS {emp.id}, VALUE, CURRENCY\n" +#~ " FROM EMPLOYMENT\n" +#~ " WHERE EMPLOYER = :id AND ENDDATE IS NULL\n" +#~ " ORDER BY STARTDATE ASC\n" +#~ "</sql-query>]]>" +#~ msgstr "" +#~ "<sql-query name=\"organizationCurrentEmployments\">\n" +#~ " <return alias=\"emp\" class=\"Employment\">\n" +#~ " <return-property name=\"salary\">\n" +#~ " <return-column name=\"VALUE\"/>\n" +#~ " <return-column name=\"CURRENCY\"/>\n" +#~ " </return-property>\n" +#~ " <return-property name=\"endDate\" column=\"myEndDate\"/>\n" +#~ " </return>\n" +#~ " SELECT EMPLOYEE AS {emp.employee}, EMPLOYER AS {emp.employer},\n" +#~ " STARTDATE AS {emp.startDate}, ENDDATE AS {emp.endDate},\n" +#~ " REGIONCODE as {emp.regionCode}, EID AS {emp.id}, VALUE, CURRENCY\n" +#~ " FROM EMPLOYMENT\n" +#~ " WHERE EMPLOYER = :id AND ENDDATE IS NULL\n" +#~ " ORDER BY STARTDATE ASC\n" +#~ "</sql-query>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[CREATE OR REPLACE FUNCTION selectAllEmployments\n" +#~ " RETURN SYS_REFCURSOR\n" +#~ "AS\n" +#~ " st_cursor SYS_REFCURSOR;\n" +#~ "BEGIN\n" +#~ " OPEN st_cursor FOR\n" +#~ " SELECT EMPLOYEE, EMPLOYER,\n" +#~ " STARTDATE, ENDDATE,\n" +#~ " REGIONCODE, EID, VALUE, CURRENCY\n" +#~ " FROM EMPLOYMENT;\n" +#~ " RETURN st_cursor;\n" +#~ " END;]]>" +#~ msgstr "" +#~ "CREATE OR REPLACE FUNCTION selectAllEmployments\n" +#~ " RETURN SYS_REFCURSOR\n" +#~ "AS\n" +#~ " st_cursor SYS_REFCURSOR;\n" +#~ "BEGIN\n" +#~ " OPEN st_cursor FOR\n" +#~ " SELECT EMPLOYEE, EMPLOYER,\n" +#~ " STARTDATE, ENDDATE,\n" +#~ " REGIONCODE, EID, VALUE, CURRENCY\n" +#~ " FROM EMPLOYMENT;\n" +#~ " RETURN st_cursor;\n" +#~ " END;" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<sql-query name=\"selectAllEmployees_SP\" callable=\"true\">\n" +#~ " <return alias=\"emp\" class=\"Employment\">\n" +#~ " <return-property name=\"employee\" column=\"EMPLOYEE\"/>\n" +#~ " <return-property name=\"employer\" column=\"EMPLOYER\"/>\n" +#~ " <return-property name=\"startDate\" column=\"STARTDATE\"/>\n" +#~ " <return-property name=\"endDate\" column=\"ENDDATE\"/>\n" +#~ " <return-property name=\"regionCode\" column=\"REGIONCODE\"/>\n" +#~ " <return-property name=\"id\" column=\"EID\"/>\n" +#~ " <return-property name=\"salary\">\n" +#~ " <return-column name=\"VALUE\"/>\n" +#~ " <return-column name=\"CURRENCY\"/>\n" +#~ " </return-property>\n" +#~ " </return>\n" +#~ " { ? = call selectAllEmployments() }\n" +#~ "</sql-query>]]>" +#~ msgstr "" +#~ "<sql-query name=\"selectAllEmployees_SP\" callable=\"true\">\n" +#~ " <return alias=\"emp\" class=\"Employment\">\n" +#~ " <return-property name=\"employee\" column=\"EMPLOYEE\"/>\n" +#~ " <return-property name=\"employer\" column=\"EMPLOYER\"/>\n" +#~ " <return-property name=\"startDate\" column=\"STARTDATE\"/>\n" +#~ " <return-property name=\"endDate\" column=\"ENDDATE\"/>\n" +#~ " <return-property name=\"regionCode\" column=\"REGIONCODE\"/" +#~ ">\n" +#~ " <return-property name=\"id\" column=\"EID\"/>\n" +#~ " <return-property name=\"salary\">\n" +#~ " <return-column name=\"VALUE\"/>\n" +#~ " <return-column name=\"CURRENCY\"/>\n" +#~ " </return-property>\n" +#~ " </return>\n" +#~ " { ? = call selectAllEmployments() }\n" +#~ "</sql-query>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Person\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"increment\"/>\n" +#~ " </id>\n" +#~ " <property name=\"name\" not-null=\"true\"/>\n" +#~ " <sql-insert>INSERT INTO PERSON (NAME, ID) VALUES ( UPPER(?), ? )</sql-" +#~ "insert>\n" +#~ " <sql-update>UPDATE PERSON SET NAME=UPPER(?) WHERE ID=?</sql-update>\n" +#~ " <sql-delete>DELETE FROM PERSON WHERE ID=?</sql-delete>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Person\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"increment\"/>\n" +#~ " </id>\n" +#~ " <property name=\"name\" not-null=\"true\"/>\n" +#~ " <sql-insert>INSERT INTO PERSON (NAME, ID) VALUES ( UPPER(?), ? )" +#~ "</sql-insert>\n" +#~ " <sql-update>UPDATE PERSON SET NAME=UPPER(?) WHERE ID=?</sql-" +#~ "update>\n" +#~ " <sql-delete>DELETE FROM PERSON WHERE ID=?</sql-delete>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Person\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"increment\"/>\n" +#~ " </id>\n" +#~ " <property name=\"name\" not-null=\"true\"/>\n" +#~ " <sql-insert callable=\"true\">{call createPerson (?, ?)}</sql-" +#~ "insert>\n" +#~ " <sql-delete callable=\"true\">{? = call deletePerson (?)}</sql-" +#~ "delete>\n" +#~ " <sql-update callable=\"true\">{? = call updatePerson (?, ?)}</sql-" +#~ "update>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Person\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"increment\"/>\n" +#~ " </id>\n" +#~ " <property name=\"name\" not-null=\"true\"/>\n" +#~ " <sql-insert callable=\"true\">{call createPerson (?, ?)}</" +#~ "sql-insert>\n" +#~ " <sql-delete callable=\"true\">{? = call deletePerson (?)}</" +#~ "sql-delete>\n" +#~ " <sql-update callable=\"true\">{? = call updatePerson (?, ?)}" +#~ "</sql-update>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[CREATE OR REPLACE FUNCTION updatePerson (uid IN NUMBER, uname IN " +#~ "VARCHAR2)\n" +#~ " RETURN NUMBER IS\n" +#~ "BEGIN\n" +#~ "\n" +#~ " update PERSON\n" +#~ " set\n" +#~ " NAME = uname,\n" +#~ " where\n" +#~ " ID = uid;\n" +#~ "\n" +#~ " return SQL%ROWCOUNT;\n" +#~ "\n" +#~ "END updatePerson;]]>" +#~ msgstr "" +#~ "CREATE OR REPLACE FUNCTION updatePerson (uid IN NUMBER, uname IN " +#~ "VARCHAR2)\n" +#~ " RETURN NUMBER IS\n" +#~ "BEGIN\n" +#~ "\n" +#~ " update PERSON\n" +#~ " set\n" +#~ " NAME = uname,\n" +#~ " where\n" +#~ " ID = uid;\n" +#~ "\n" +#~ " return SQL%ROWCOUNT;\n" +#~ "\n" +#~ "END updatePerson;" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<sql-query name=\"person\">\n" +#~ " <return alias=\"pers\" class=\"Person\" lock-mode=\"upgrade\"/>\n" +#~ " SELECT NAME AS {pers.name}, ID AS {pers.id}\n" +#~ " FROM PERSON\n" +#~ " WHERE ID=?\n" +#~ " FOR UPDATE\n" +#~ "</sql-query>]]>" +#~ msgstr "" +#~ "<sql-query name=\"person\">\n" +#~ " <return alias=\"pers\" class=\"Person\" lock-mode=\"upgrade\"/" +#~ ">\n" +#~ " SELECT NAME AS {pers.name}, ID AS {pers.id}\n" +#~ " FROM PERSON\n" +#~ " WHERE ID=?\n" +#~ " FOR UPDATE\n" +#~ "</sql-query>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Person\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"increment\"/>\n" +#~ " </id>\n" +#~ " <property name=\"name\" not-null=\"true\"/>\n" +#~ " <loader query-ref=\"person\"/>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Person\">\n" +#~ " <id name=\"id\">\n" +#~ " <generator class=\"increment\"/>\n" +#~ " </id>\n" +#~ " <property name=\"name\" not-null=\"true\"/>\n" +#~ " <loader query-ref=\"person\"/>\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<set name=\"employments\" inverse=\"true\">\n" +#~ " <key/>\n" +#~ " <one-to-many class=\"Employment\"/>\n" +#~ " <loader query-ref=\"employments\"/>\n" +#~ "</set>]]>" +#~ msgstr "" +#~ "<set name=\"employments\" inverse=\"true\">\n" +#~ " <key/>\n" +#~ " <one-to-many class=\"Employment\"/>\n" +#~ " <loader query-ref=\"employments\"/>\n" +#~ "</set>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<sql-query name=\"employments\">\n" +#~ " <load-collection alias=\"emp\" role=\"Person.employments\"/>\n" +#~ " SELECT {emp.*}\n" +#~ " FROM EMPLOYMENT emp\n" +#~ " WHERE EMPLOYER = :id\n" +#~ " ORDER BY STARTDATE ASC, EMPLOYEE ASC\n" +#~ "</sql-query>]]>" +#~ msgstr "" +#~ "<sql-query name=\"employments\">\n" +#~ " <load-collection alias=\"emp\" role=\"Person.employments\"/>\n" +#~ " SELECT {emp.*}\n" +#~ " FROM EMPLOYMENT emp\n" +#~ " WHERE EMPLOYER = :id\n" +#~ " ORDER BY STARTDATE ASC, EMPLOYEE ASC\n" +#~ "</sql-query>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<sql-query name=\"person\">\n" +#~ " <return alias=\"pers\" class=\"Person\"/>\n" +#~ " <return-join alias=\"emp\" property=\"pers.employments\"/>\n" +#~ " SELECT NAME AS {pers.*}, {emp.*}\n" +#~ " FROM PERSON pers\n" +#~ " LEFT OUTER JOIN EMPLOYMENT emp\n" +#~ " ON pers.ID = emp.PERSON_ID\n" +#~ " WHERE ID=?\n" +#~ "</sql-query>]]>" +#~ msgstr "" +#~ "<sql-query name=\"person\">\n" +#~ " <return alias=\"pers\" class=\"Person\"/>\n" +#~ " <return-join alias=\"emp\" property=\"pers.employments\"/>\n" +#~ " SELECT NAME AS {pers.*}, {emp.*}\n" +#~ " FROM PERSON pers\n" +#~ " LEFT OUTER JOIN EMPLOYMENT emp\n" +#~ " ON pers.ID = emp.PERSON_ID\n" +#~ " WHERE ID=?\n" +#~ "</sql-query>" Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/session_api.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/session_api.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/session_api.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,2577 @@ +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# Language /mnt/hgfs/base/Hibernate/Reference translations for PACKAGE package. +# Copyright (C) 2006, 2007 Free Software Foundation, Inc. +# Automatically generated, 2006. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# +msgid "" +msgstr "" +"Project-Id-Version: Collection_Mapping\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2009-12-03T00:15:27\n" +"PO-Revision-Date: 2007-02-26 10:27+1000\n" +"Last-Translator: \n" +"Language-Team: <de(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.9.1\n" + +#. Tag: title +#, no-c-format +msgid "Working with objects" +msgstr "Das Arbeiten mit Objekten" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate is a full object/relational mapping solution that not only shields " +"the developer from the details of the underlying database management system, " +"but also offers <emphasis>state management</emphasis> of objects. This is, " +"contrary to the management of SQL <literal>statements</literal> in common " +"JDBC/SQL persistence layers, a natural object-oriented view of persistence " +"in Java applications." +msgstr "" +"Hibernate ist eine komplette objekt/relationale Mapping-Lösung, die dem " +"Entwickler nicht nur Details des zu Grunde liegenden Datenbank-Management-" +"Systems abnimmt, sondern auch die <emphasis>Statusverwaltung</emphasis> von " +"Objekten bereit stellt. Dies ist im Gegensatz zur Verwaltung von SQL " +"<literal>statements</literal> in gängigen JDBC/SQL-Persistenzschichten eine " +"sehr natürliche, objektorientierte Ansicht der Persistenz in Java-" +"Anwendungen." + +#. Tag: para +#, no-c-format +msgid "" +"In other words, Hibernate application developers should always think about " +"the <emphasis>state</emphasis> of their objects, and not necessarily about " +"the execution of SQL statements. This part is taken care of by Hibernate and " +"is only relevant for the application developer when tuning the performance " +"of the system." +msgstr "" +"Mit anderen Worten - Hibernate Anwendungsentwickler sollten sich stets über " +"den <emphasis>Status</emphasis> Ihrer Objekte Gedanken machen und nicht " +"unbedingt über die Ausführung von SQL-Anweisungen. Dieser Teil wird von " +"Hibernate übernommen und ist nur dann für den Anwendungsentwickler von " +"Bedeutung, wenn die Performance des Systems eingestellt wird." + +#. Tag: title +#, no-c-format +msgid "Hibernate object states" +msgstr "Statusarten von Hibernate Objekten" + +#. Tag: para +#, no-c-format +msgid "Hibernate defines and supports the following object states:" +msgstr "" +"Hibernate definiert und unterstützt die folgenden Arten des Objektstatus:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis>Transient</emphasis> - an object is transient if it has just been " +"instantiated using the <literal>new</literal> operator, and it is not " +"associated with a Hibernate <literal>Session</literal>. It has no persistent " +"representation in the database and no identifier value has been assigned. " +"Transient instances will be destroyed by the garbage collector if the " +"application does not hold a reference anymore. Use the Hibernate " +"<literal>Session</literal> to make an object persistent (and let Hibernate " +"take care of the SQL statements that need to be executed for this " +"transition)." +msgstr "" +"<emphasis>Transient</emphasis> - ein Objekt ist transient (vorübergehend), " +"wenn es mittels des <literal>new</literal> Operator gerade instantiiert " +"wurde und mit keiner Hibernate <literal>Session</literal> assoziiert wird. " +"Es besitzt keine persistene (dauerhafte) Repräsentation in der Datenbank, " +"und es wurde kein Identifier-Wert zugeordnet. Transiente Instanzen werden " +"durch die Speicherbereinigung (sog. \"Garbage Collector\") gelöscht, wenn " +"die Anwendung keine Referenz mehr hält. Verwenden Sie die Hibernate " +"<literal>Session</literal>, um ein Objekt persistent zu machen (und " +"überlassen Sie Hibernate die Ausführung der SQL-Anweisungen, die für diesen " +"Wechsel nötig sind)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis>Persistent</emphasis> - a persistent instance has a representation " +"in the database and an identifier value. It might just have been saved or " +"loaded, however, it is by definition in the scope of a <literal>Session</" +"literal>. Hibernate will detect any changes made to an object in persistent " +"state and synchronize the state with the database when the unit of work " +"completes. Developers do not execute manual <literal>UPDATE</literal> " +"statements, or <literal>DELETE</literal> statements when an object should be " +"made transient." +msgstr "" +"<emphasis>Persistent</emphasis> - eine persistente Instanz besitzt eine " +"Repräsentation in der Datenbank sowie einen Bezeichnerwert. Sie könnte " +"gerade gespeichert oder geladen worden sein, ist jedoch der Definition nach " +"im Gültigkeitsbereich einer <literal>Session</literal>. Hibernate findet " +"sämtliche Veränderungen, die sich an einem Objekt in persistentem Zustand " +"ergeben haben und synchronisiert den Status mit der Datenbank, wenn die " +"Arbeitseinheit abgeschlossen ist. Entwickler führen keine manuellen " +"<literal>UPDATE</literal> oder <literal>DELETE</literal>-Anweisungen durch, " +"wenn ein Objekt transient gemacht werden soll." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis>Detached</emphasis> - a detached instance is an object that has " +"been persistent, but its <literal>Session</literal> has been closed. The " +"reference to the object is still valid, of course, and the detached instance " +"might even be modified in this state. A detached instance can be reattached " +"to a new <literal>Session</literal> at a later point in time, making it (and " +"all the modifications) persistent again. This feature enables a programming " +"model for long running units of work that require user think-time. We call " +"them <emphasis>application transactions</emphasis>, i.e., a unit of work " +"from the point of view of the user." +msgstr "" +"<emphasis>Detached</emphasis> - eine abgesetzte Instanz ist ein Objekt, das " +"persistent war, dessen <literal>Session</literal> jedoch geschlossen wurde. " +"Der Verweis zum Objekt besitzt natürlich nach wie vor Gültigkeit, und die " +"abgesetzte Instanz kann sogar in diesem Status verändert werden. Eine " +"abgesetzte Instanz kann einer neuen <literal>Session</literal> zu einem " +"späteren Zeitpunkt wieder hinzugefügt werden, wodurch sie (mitsamt den " +"Modifikationen) wieder persistent wird. Dieses Feature ermöglicht ein " +"Programmiermodell für lange laufende Arbeitseinheiten, die Benutzer \"Think " +"Time\" erfordern. Wir nennen diese <emphasis>Anwendungstransaktionen</" +"emphasis> (sog. \"Application Transactions\"), d.h. eine Arbeitseinheit aus " +"Sicht des Benutzers." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"We will now discuss the states and state transitions (and the Hibernate " +"methods that trigger a transition) in more detail." +msgstr "" +"Wir gehen nun tiefer auf Status und Statuswechsel (sowie die Hibernate " +"Methoden, die einen Wechsel auslösen) ein." + +#. Tag: title +#, no-c-format +msgid "Making objects persistent" +msgstr "Objekte persistent machen" + +#. Tag: para +#, no-c-format +msgid "" +"Newly instantiated instances of a a persistent class are considered " +"<emphasis>transient</emphasis> by Hibernate. We can make a transient " +"instance <emphasis>persistent</emphasis> by associating it with a session:" +msgstr "" +"Neu instantiierte Instanzen einer persistenten Klasse werden von Hibernate " +"als <emphasis>transient</emphasis> angesehen. Wir können eine transiente " +"Instanz jedoch <emphasis>persistent</emphasis> machen, indem wir sie mit " +"einer Session assoziieren:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If <literal>Cat</literal> has a generated identifier, the identifier is " +"generated and assigned to the <literal>cat</literal> when <literal>save()</" +"literal> is called. If <literal>Cat</literal> has an <literal>assigned</" +"literal> identifier, or a composite key, the identifier should be assigned " +"to the <literal>cat</literal> instance before calling <literal>save()</" +"literal>. You can also use <literal>persist()</literal> instead of " +"<literal>save()</literal>, with the semantics defined in the EJB3 early " +"draft." +msgstr "" +"Wenn <literal>Cat</literal> einen generierten Bezeichner besitzt, so wird " +"dieser generiert und <literal>cat</literal> zugeordnet, wenn der Aufruf " +"<literal>save()</literal> erfolgt. Wenn <literal>Cat</literal> einen " +"<literal>assigned</literal> Bezeichner oder einen zusammengesetzten " +"Schlüssel besitzt, so sollte der Bezeichner der <literal>cat</literal> " +"Instanz zugeordnet werden, ehe <literal>save()</literal> aufgerufen wird. " +"Sie können auch <literal>persist()</literal> statt <literal>save()</literal> " +"verwenden, mit der Semantik der frühen EJB3-Fassung." + +#. Tag: para +#, no-c-format +msgid "" +"<literal>persist()</literal> makes a transient instance persistent. However, " +"it does not guarantee that the identifier value will be assigned to the " +"persistent instance immediately, the assignment might happen at flush time. " +"<literal>persist()</literal> also guarantees that it will not execute an " +"<literal>INSERT</literal> statement if it is called outside of transaction " +"boundaries. This is useful in long-running conversations with an extended " +"Session/persistence context." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"<literal>save()</literal> does guarantee to return an identifier. If an " +"INSERT has to be executed to get the identifier ( e.g. \"identity\" " +"generator, not \"sequence\"), this INSERT happens immediately, no matter if " +"you are inside or outside of a transaction. This is problematic in a long-" +"running conversation with an extended Session/persistence context." +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Alternatively, you can assign the identifier using an overloaded version of " +"<literal>save()</literal>." +msgstr "" +"Alternativ können Sie den Bezeichner unter Verwendung einer überladenen " +"Version von <literal>save()</literal> zuordnen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If the object you make persistent has associated objects (e.g. the " +"<literal>kittens</literal> collection in the previous example), these " +"objects can be made persistent in any order you like unless you have a " +"<literal>NOT NULL</literal> constraint upon a foreign key column. There is " +"never a risk of violating foreign key constraints. However, you might " +"violate a <literal>NOT NULL</literal> constraint if you <literal>save()</" +"literal> the objects in the wrong order." +msgstr "" +"Falls das von Ihnen persistent gemachte Objekt assoziierte Objekte besitzt " +"(z.B. die <literal>kittens</literal>-Collection im vorherigen Beispiel), so " +"können diese Objekte in beliebiger Reihenfolge persistent gemacht werden, so " +"lange keine <literal>NOT NULL</literal>-Bedingung für eine " +"Fremdschlüsselspalte existiert. Es besteht niemals das Risiko, dass " +"Bedingungen für Fremdschlüssel verletzt werden. Allerdings kann eine " +"<literal>NOT NULL</literal>-Bedingung verletzt werden, falls Sie mittels " +"<literal>save()</literal> die Objekte in der falschen Reihenfolge speichern." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Usually you do not bother with this detail, as you will normally use " +"Hibernate's <emphasis>transitive persistence</emphasis> feature to save the " +"associated objects automatically. Then, even <literal>NOT NULL</literal> " +"constraint violations do not occur - Hibernate will take care of everything. " +"Transitive persistence is discussed later in this chapter." +msgstr "" +"In der Regel kümmern Sie sich nicht um dieses Detail, da Sie sehr " +"wahrscheinlich Hibernates Feature für <emphasis>transitive Persistenz</" +"emphasis> verwenden, um zugehörige Objekte automatisch zu speichern. " +"Hibernate kümmert sich dann um alles, selbst wenn es nicht zu Verletzungen " +"von <literal>NOT NULL</literal> Bedingungen kommt. Wir gehen später in " +"diesem Kapitel noch näher auf transitive Persistenz ein." + +#. Tag: title +#, no-c-format +msgid "Loading an object" +msgstr "Das Laden eines Objekts" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>load()</literal> methods of <literal>Session</literal> provide " +"a way of retrieving a persistent instance if you know its identifier. " +"<literal>load()</literal> takes a class object and loads the state into a " +"newly instantiated instance of that class in a persistent state." +msgstr "" +"Die <literal>load()</literal>-Methode von <literal>Session</literal> gibt " +"Ihnen die Möglichkeit, eine persistente Instanz abzurufen, wenn Sie deren " +"Bezeichner bereits kennen. <literal>load()</literal> nimmt ein Klassenobjekt " +"und lädt den Status in eine neu instantiierte Instanz der Klasse, in " +"persistentem Zustand." + +#. Tag: para +#, no-c-format +msgid "Alternatively, you can load state into a given instance:" +msgstr "Alternativ können Sie den Status in eine beliebige Instanz laden:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Be aware that <literal>load()</literal> will throw an unrecoverable " +"exception if there is no matching database row. If the class is mapped with " +"a proxy, <literal>load()</literal> just returns an uninitialized proxy and " +"does not actually hit the database until you invoke a method of the proxy. " +"This is useful if you wish to create an association to an object without " +"actually loading it from the database. It also allows multiple instances to " +"be loaded as a batch if <literal>batch-size</literal> is defined for the " +"class mapping." +msgstr "" +"Bitte beachten Sie, dass <literal>load()</literal> zu einer nicht behebbaren " +"Ausnahmemeldung führt, falls keine passende Datenbankreihe existiert. Falls " +"die Klasse mit einem Proxy gemappt ist, so reagiert <literal>load()</" +"literal> nur mit einem nicht initialisierten Proxy und erreicht die " +"Datenbank nicht, ehe eine Methode des Proxy aufgerufen wurde. Dieses " +"Verhalten ist sehr hilfreich, wenn Sie eine Assoziation zu einem Objekt " +"herstellen möchten, ohne es aus der Datenbank zu laden. Auch das Laden " +"mehrerer Instanzen als \"Batch\" (Stapel) ist möglich, wenn <literal>batch-" +"size</literal> für das Klassen-Mapping definiert ist." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If you are not certain that a matching row exists, you should use the " +"<literal>get()</literal> method which hits the database immediately and " +"returns null if there is no matching row." +msgstr "" +"Falls Sie nicht sicher sind, ob eine passende Datenbankreihe existiert, so " +"sollten Sie die <literal>get()</literal>-Methode anwenden, die direkt auf " +"die Datenbank zugreift und mit einer Nullmeldung reagiert, falls keine " +"passende Reihe existiert." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can even load an object using an SQL <literal>SELECT ... FOR UPDATE</" +"literal>, using a <literal>LockMode</literal>. See the API documentation for " +"more information." +msgstr "" +"Sie können sogar ein Objekt mittels SQL <literal>SELECT ... FOR UPDATE</" +"literal> laden, indem Sie einen <literal>LockMode</literal> verwenden. Siehe " +"dazu auch die API-Dokumentation." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Any associated instances or contained collections will <emphasis>not</" +"emphasis> be selected <literal>FOR UPDATE</literal>, unless you decide to " +"specify <literal>lock</literal> or <literal>all</literal> as a cascade style " +"for the association." +msgstr "" +"Bitte beachten Sie, dass sämtliche assoziierten Instanzen oder enthaltenen " +"Collections <emphasis>nicht</emphasis> für <literal>FOR UPDATE</literal> " +"ausgewählt werden, außer Sie spezifizieren <literal>lock</literal> oder " +"<literal>all</literal> als Aufeinanderschaltung der Assoziation (\"sog. " +"Cascade Style\")." + +#. Tag: para +#, no-c-format +msgid "" +"It is possible to re-load an object and all its collections at any time, " +"using the <literal>refresh()</literal> method. This is useful when database " +"triggers are used to initialize some of the properties of the object." +msgstr "" +"Es ist mittels der <literal>refresh()</literal>-Methode jederzeit möglich, " +"ein Objekt und alle seine Collections erneut zu laden. Dies ist insbesondere " +"dann von Nutzen, wenn Datenbank-Trigger zur Initialisierung der Objekt-" +"Properties verwendet werden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"How much does Hibernate load from the database and how many SQL " +"<literal>SELECT</literal>s will it use? This depends on the " +"<emphasis>fetching strategy</emphasis>. This is explained in <xref linkend=" +"\"performance-fetching\" />." +msgstr "" +"An diesem Punkt stellt sich eine wichtige Frage: Wie viel lädt Hibernate aus " +"der Datenbank und wie viele SQL <literal>SELECT</literal>s werden verwendet? " +"Nun, das hängt von der <emphasis>Abrufstrategie</emphasis> (sog. \"fetching " +"strategy\") ab und wird in <xref linkend=\"performance-fetching\"/> näher erläutert." + +#. Tag: title +#, no-c-format +msgid "Querying" +msgstr "Anfragen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If you do not know the identifiers of the objects you are looking for, you " +"need a query. Hibernate supports an easy-to-use but powerful object oriented " +"query language (HQL). For programmatic query creation, Hibernate supports a " +"sophisticated Criteria and Example query feature (QBC and QBE). You can also " +"express your query in the native SQL of your database, with optional support " +"from Hibernate for result set conversion into objects." +msgstr "" +"Falls Sie die Bezeichner der Objekte, die Sie suchen nicht kennen, so " +"benötigen Sie eine Anfrage. Hibernate unterstützt eine einfach zu " +"verwendende doch leistungsfähige objektorientierte Anfragensprache (HQL). " +"Für die befehlsorientierte Erstellung einer Anfrage unterstützt Hibernate " +"ein technisch ausgefeiltes Feature für Kriterien- und Beispielanfragen (QBC " +"and QBE). Sie können die Anfrage auch in der nativen SQL Ihrer Datenbank mit " +"optionalem Support von Hibernate hinsichtlich der Konversion des " +"Ergebnissatzes in die Objekte ausdrücken." + +#. Tag: title +#, no-c-format +msgid "Executing queries" +msgstr "Ausführen von Anfragen" + +#. Tag: para +#, no-c-format +msgid "" +"HQL and native SQL queries are represented with an instance of <literal>org." +"hibernate.Query</literal>. This interface offers methods for parameter " +"binding, result set handling, and for the execution of the actual query. You " +"always obtain a <literal>Query</literal> using the current <literal>Session</" +"literal>:" +msgstr "" +"HQL und native SQL-Anfragen werden durch eine Instanz von <literal>org." +"hibernate.Query</literal> repräsentiert. Dieses Interface bietet Methoden " +"zur Parameter-Bindung, Handhabung von Ergebnissätzen (sog. \"result sets\") " +"und für das Ausführen der tatsächlichen Anfrage. Sie können mittels der " +"<literal>Session</literal> immer eine <literal>Query</literal> erhalten:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A query is usually executed by invoking <literal>list()</literal>. The " +"result of the query will be loaded completely into a collection in memory. " +"Entity instances retrieved by a query are in a persistent state. The " +"<literal>uniqueResult()</literal> method offers a shortcut if you know your " +"query will only return a single object. Queries that make use of eager " +"fetching of collections usually return duplicates of the root objects, but " +"with their collections initialized. You can filter these duplicates through " +"a <literal>Set</literal>." +msgstr "" +"Eine Anfrage wird in der Regel durch den Aufruf <literal>list()</literal> " +"ausgeführt, und das Ergebnis der Anfrage wird vollständig in eine Collection " +"des Speichers geladen. Die durch eine Anfrage erhaltenen Entity-Instanzen " +"befinden sich in persistentem Zustand. Die <literal>uniqueResult()</literal>-" +"Methode bietet ein Tastaturkürzel, wenn Sie wissen, dass Ihre Anfrage nur " +"mit einem einzelnen Objekt reagiert. Bitte beachten Sie, dass Anfragen, die " +"für Collections \"eager Fetching\" (d.h. zusammengefasstes Laden von Objekt " +"und assoziierten Objekten mit Verbundoperationen) verwenden, in der Regel " +"mit Doubletten der Stammobjekte (sog. \"Root Objects\") reagieren (deren " +"Collections sind jedoch initialisiert). Sie können diese Doubletten mittels " +"<literal>Set</literal> jedoch ganz einfach filtern." + +#. Tag: title +#, no-c-format +msgid "Iterating results" +msgstr "Iterationsergebnisse" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Occasionally, you might be able to achieve better performance by executing " +"the query using the <literal>iterate()</literal> method. This will usually " +"be the case if you expect that the actual entity instances returned by the " +"query will already be in the session or second-level cache. If they are not " +"already cached, <literal>iterate()</literal> will be slower than " +"<literal>list()</literal> and might require many database hits for a simple " +"query, usually <emphasis>1</emphasis> for the initial select which only " +"returns identifiers, and <emphasis>n</emphasis> additional selects to " +"initialize the actual instances." +msgstr "" +"Manchmal lässt sich die Performance verbessern, indem die Anfrage mittels " +"<literal>iterate()</literal>-Methode ausgeführt wird. Dies wird in der Regel " +"nur der Fall sein, wenn sich die zu erwartenden Instanzen der Entity, die " +"auf die Anfrage reagieren, bereits in der Session oder dem Cache-Speicher " +"der zweiten Ebene befinden. Wenn diese nicht bereits gecacht sind, so wird " +"<literal>iterate()</literal> langsamer als <literal>list()</literal> sein " +"und könnte zahlreiche Datenbanktreffer für eine einfache Anfrage benötigen - " +"für gewöhnlich <emphasis>1</emphasis> für die ursprüngliche Auswahl, die " +"lediglich mit den Bezeichnern reagiert und <emphasis>n</emphasis> " +"zusätzliche Auswahlen zur Initialisierung der tatsächlichen Instanzen." + +#. Tag: title +#, no-c-format +msgid "Queries that return tuples" +msgstr "Anfragen, die mit Tupeln reagieren" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate queries sometimes return tuples of objects. Each tuple is returned " +"as an array:" +msgstr "" +"Hibernate Anfragen reagieren manchmal mit Tupeln (d.h. einer Liste " +"korrelierter Datenwerte), wobei jeder Tupel als Array wiedergegeben wird:" + +#. Tag: title +#, no-c-format +msgid "Scalar results" +msgstr "Skalare Ergebnisse" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Queries can specify a property of a class in the <literal>select</literal> " +"clause. They can even call SQL aggregate functions. Properties or aggregates " +"are considered \"scalar\" results and not entities in persistent state." +msgstr "" +"Anfragen können im <literal>select</literal>-Satzteil die Property einer " +"Klasse spezifizieren. Sie können sogar SQL-Datengruppen-Funktionen aufrufen. " +"Properties oder Datengruppen werden als \"skalare\" Ergebnisse angesehen " +"(und nicht als Entities in persistentem Zustand)." + +#. Tag: title +#, no-c-format +msgid "Bind parameters" +msgstr "Bind-Parameter" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Methods on <literal>Query</literal> are provided for binding values to named " +"parameters or JDBC-style <literal>?</literal> parameters. <emphasis>Contrary " +"to JDBC, Hibernate numbers parameters from zero.</emphasis> Named parameters " +"are identifiers of the form <literal>:name</literal> in the query string. " +"The advantages of named parameters are as follows:" +msgstr "" +"Methoden an <literal>Query</literal> sind vorhanden, um Werte an benannte " +"Parameter oder <literal>?</literal>-Parameter nach JDBC-Art zu binden. " +"<emphasis>Im Gegensatz zu JDBC nummeriert Hibernate Parameter ab Null.</" +"emphasis> Bei benannten Parametern handelt es sich um Bezeichner in der Form " +"<literal>:name</literal> im Anfragenstring. Die Vorteile benannter Parameter " +"sind:" + +#. Tag: para +#, no-c-format +msgid "" +"named parameters are insensitive to the order they occur in the query string" +msgstr "" +"benannte Parameter sind unempfindlich im Bezug auf die Reihenfolge, in der " +"sie im Anfragenstring erscheinen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "they can occur multiple times in the same query" +msgstr "sie können innerhalb derselben Anfrage mehrere Male vorkommen" + +#. Tag: para +#, no-c-format +msgid "they are self-documenting" +msgstr "sie dokumentieren sich selbst" + +#. Tag: title +#, no-c-format +msgid "Pagination" +msgstr "Nummerierung" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If you need to specify bounds upon your result set, that is, the maximum " +"number of rows you want to retrieve and/or the first row you want to " +"retrieve, you can use methods of the <literal>Query</literal> interface:" +msgstr "" +"Falls Sie Grenzen an Ihrem Ergebnissatz spezifizieren müssen (die maximale " +"Anzahl von Reihen, die Sie erhalten und / oder die erste Reihe, die Sie " +"erhalten wollen), sollten Sie Methoden des <literal>Query</literal>-" +"Interface verwenden:" + +#. Tag: para +#, no-c-format +msgid "" +"Hibernate knows how to translate this limit query into the native SQL of " +"your DBMS." +msgstr "" +"Hibernate weiß, wie die Grenzanfrage in die native SQL Ihres DBMS zu " +"übersetzen ist." + +#. Tag: title +#, no-c-format +msgid "Scrollable iteration" +msgstr "Scrollbare Iteration" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If your JDBC driver supports scrollable <literal>ResultSet</literal>s, the " +"<literal>Query</literal> interface can be used to obtain a " +"<literal>ScrollableResults</literal> object that allows flexible navigation " +"of the query results." +msgstr "" +"Falls Ihr JDBC-Treiber scrollbare <literal>ResultSet</literal>s unterstützt, " +"kann das <literal>Query</literal>-Interface benutzt werden, um ein " +"<literal>ScrollableResults</literal>-Objekt zu erhalten, das die flexible " +"Navigation der Anfragenergebnisse ermöglicht." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Note that an open database connection and cursor is required for this " +"functionality. Use <literal>setMaxResult()</literal>/<literal>setFirstResult" +"()</literal> if you need offline pagination functionality." +msgstr "" +"Bitte beachten Sie, dass eine offene Datenbankverbindung (und Cursor) für " +"dies Funktionalität benötigt werden. Verwenden Sie <literal>setMaxResult()</" +"literal>/<literal>setFirstResult()</literal>, falls Sie die offline " +"Nummerierungsfunktionalität benötigen." + +#. Tag: title +#, no-c-format +msgid "Externalizing named queries" +msgstr "Externalisierung benannter Anfragen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can also define named queries in the mapping document. Remember to use a " +"<literal>CDATA</literal> section if your query contains characters that " +"could be interpreted as markup." +msgstr "" +"Sie können benannte Anfragen auch im Mapping-Dokument definieren. (Vergessen " +"Sie nicht einen <literal>CDATA</literal>-Abschnitt zu verwenden, falls Ihre " +"Anfrage Zeichen enthält, die als Markup interpretiert werden könnten)." + +#. Tag: para +#, no-c-format +msgid "Parameter binding and executing is done programatically:" +msgstr "Die Bindung und Ausführung der Parameter erfolgen befehlsorientiert:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The actual program code is independent of the query language that is used. " +"You can also define native SQL queries in metadata, or migrate existing " +"queries to Hibernate by placing them in mapping files." +msgstr "" +"Bitte beachten Sie, dass der tatsächliche Programmcode unabhängig von der " +"verwendeten Anfragensprache ist. Sie können auch native SQL-Anfragen in " +"Metadata definieren oder bestehende Anfragen zu Hibernate migrieren, indem " +"Sie sie in Mapping-Dateien platzieren." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Also note that a query declaration inside a <literal><hibernate-" +"mapping></literal> element requires a global unique name for the query, " +"while a query declaration inside a <literal><class></literal> element " +"is made unique automatically by prepending the fully qualified name of the " +"class. For example <literal>eg.Cat.ByNameAndMaximumWeight</literal>." +msgstr "" +"Beachten Sie außerdem, dass eine Anfragendeklaration innerhalb eines " +"<literal><hibernate-mapping></literal>-Elements einen " +"allgemeingültigen, eindeutigen Namen für die Anfrage erfordert, während eine " +"Anfragendeklaration innerhalb eines <literal><class></literal>-" +"Elements dadurch automatisch eindeutig gemacht wird, dass der vollständige " +"Name der Klasse, z.B. <literal>eg.Cat.ByNameAndMaximumWeight</literal> " +"vorangestellt wird." + +#. Tag: title +#, no-c-format +msgid "Filtering collections" +msgstr "Das Filtern von Collections" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A collection <emphasis>filter</emphasis> is a special type of query that can " +"be applied to a persistent collection or array. The query string can refer " +"to <literal>this</literal>, meaning the current collection element." +msgstr "" +"Ein Collection <emphasis>filter</emphasis> ist eine spezielle Art der " +"Anfrage, die an einer persistenten Collection oder einem Array angewendet " +"werden kann. Der Anfragenstring kann auf <literal>this</literal> verweisen, " +"womit das aktuelle Element der Collection gemeint ist." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The returned collection is considered a bag that is a copy of the given " +"collection. The original collection is not modified. This is contrary to the " +"implication of the name \"filter\", but consistent with expected behavior." +msgstr "" +"Die zurückgesendete Collection wird als \"Bag\" (Duplikat) angesehen, und es " +"handelt sich um eine Kopie der vorgegebenen Collection. Die ursprüngliche " +"Collection wird nicht verändert (dies steht im Gegensatz zur " +"Schlussfolgerung den der Name \"Filter\" vermuten lässt, aber in Konsistenz " +"mit dem erwarteten Verhalten)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Observe that filters do not require a <literal>from</literal> clause, " +"although they can have one if required. Filters are not limited to returning " +"the collection elements themselves." +msgstr "" +"Beachten Sie, dass Filter keinen <literal>from</literal>-Satzteil benötigen " +"(jedoch bei Bedarf einen besitzen können). Filter sind nicht darauf " +"beschränkt, die Elemente der Collection selbst wiederzugeben." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Even an empty filter query is useful, e.g. to load a subset of elements in a " +"large collection:" +msgstr "" +"Selbst eine Anfrage mit leerem Filter ist von Nutzen, wenn man etwa einen " +"Untersatz von Elementen in einer riesigen Collection lädt." + +#. Tag: title +#, no-c-format +msgid "Criteria queries" +msgstr "Kriterienanfragen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"HQL is extremely powerful, but some developers prefer to build queries " +"dynamically using an object-oriented API, rather than building query " +"strings. Hibernate provides an intuitive <literal>Criteria</literal> query " +"API for these cases:" +msgstr "" +"HQL ist sehr leistungsfähig, jedoch bevorzugen manche Entwickler den " +"dynamischen Bau von Anfragen unter Verwendung einer objektorientierten API, " +"statt des Erstellens von Anfragenstrings. Hibernate liefert für diese Fälle " +"eine API für intuitive <literal>Criteria</literal>-Anfragen:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>Criteria</literal> and the associated <literal>Example</" +"literal> API are discussed in more detail in <xref linkend=\"querycriteria" +"\" />." +msgstr "" +"Die <literal>Criteria</literal> und die zugehörige <literal>Example</" +"literal>-API werden unter <xref linkend=\"querycriteria\"/> näher " +"erläutert." + +#. Tag: title +#, no-c-format +msgid "Queries in native SQL" +msgstr "Anfragen in nativer SQL" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can express a query in SQL, using <literal>createSQLQuery()</literal> " +"and let Hibernate manage the mapping from result sets to objects. You can at " +"any time call <literal>session.connection()</literal> and use the JDBC " +"<literal>Connection</literal> directly. If you choose to use the Hibernate " +"API, you must enclose SQL aliases in braces:" +msgstr "" +"Sie können eine Anfrage in SQL mittels <literal>createSQLQuery()</literal> " +"ausdrücken und Hibernate das Mapping von den Ergebnissätzen zu den Objekten " +"übernehmen lassen. Beachten Sie, dass Sie zu jedem Zeitpunkt " +"<literal>session.connection()</literal> aufrufen und die JDBC " +"<literal>Connection</literal> direkt benutzen können. Falls Sie die " +"Hibernate API verwenden wollen, müssen Sie die SQL-Aliasse in Klammern mit " +"einschließen:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"SQL queries can contain named and positional parameters, just like Hibernate " +"queries. More information about native SQL queries in Hibernate can be found " +"in <xref linkend=\"querysql\" />." +msgstr "" +"SQL-Anfragen können - wie auch Hibernate Anfragen - benannte und " +"positionelle Parameter enthalten. Weitere Informationen zu nativen SQL-" +"Anfragen in Hibernate finden Sie in <xref linkend=\"querysql\"/>." + +#. Tag: title +#, no-c-format +msgid "Modifying persistent objects" +msgstr "Änderungen an persistenten Objekten vornehmen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis>Transactional persistent instances</emphasis> (i.e. objects " +"loaded, saved, created or queried by the <literal>Session</literal>) can be " +"manipulated by the application, and any changes to persistent state will be " +"persisted when the <literal>Session</literal> is <emphasis>flushed</" +"emphasis>. This is discussed later in this chapter. There is no need to call " +"a particular method (like <literal>update()</literal>, which has a different " +"purpose) to make your modifications persistent. The most straightforward way " +"to update the state of an object is to <literal>load()</literal> it and then " +"manipulate it directly while the <literal>Session</literal> is open:" +msgstr "" +"<emphasis>Transaktionale persistente Instanzen</emphasis> (d.h. durch die " +"<literal>Session</literal> geladene, gespeicherte, erstellte oder angefragte " +"Objekte) können durch die Anwendung verarbeitet werden und sämtliche " +"Veränderungen am persistenten Status bleiben bestehen, wenn die " +"<literal>Session</literal> <emphasis>geräumt</emphasis> wird (darauf gehen " +"wir später in diesem Kapitel noch ein). Es muss keine bestimmte Methode " +"aufgerufen werden (wie etwa <literal>update()</literal>, das einen anderen " +"Zweck hat), um Ihre Änderungen persistent zu machen. Die einfachste Art der " +"Statusaktualisierung eines Objektes ist daher das Laden mittels <literal>load" +"()</literal> und dessen direkte Modifizierung während die <literal>Session</" +"literal> geöffnet ist:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Sometimes this programming model is inefficient, as it requires in the same " +"session both an SQL <literal>SELECT</literal> to load an object and an SQL " +"<literal>UPDATE</literal> to persist its updated state. Hibernate offers an " +"alternate approach by using detached instances." +msgstr "" +"Manchmal ist dieses Programmiermodell jedoch ineffizient, da es sowohl ein " +"SQL <literal>SELECT</literal> (zum Laden eines Objekts) als auch ein SQL " +"<literal>UPDATE</literal> (um den aktualisierten Status zu persistieren) " +"innerhalb derselben Session erfordern würde. Daher bietet Hibernate mit der " +"Verwendung abgesetzter Instanzen eine alternative Vorgehensweise." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate does not offer its own API for direct execution of " +"<literal>UPDATE</literal> or <literal>DELETE</literal> statements. Hibernate " +"is a <emphasis>state management</emphasis> service, you do not have to think " +"in <emphasis>statements</emphasis> to use it. JDBC is a perfect API for " +"executing SQL statements, you can get a JDBC <literal>Connection</literal> " +"at any time by calling <literal>session.connection()</literal>. Furthermore, " +"the notion of mass operations conflicts with object/relational mapping for " +"online transaction processing-oriented applications. Future versions of " +"Hibernate can, however, provide special mass operation functions. See <xref " +"linkend=\"batch\" /> for some possible batch operation tricks." +msgstr "" +"Bitte beachten Sie, dass Hibernate keine eigene API für die direkte " +"Ausführung von <literal>UPDATE</literal> oder <literal>DELETE</literal>-" +"Anweisungen besitzt. Bei Hibernate handelt es sich um einen Dienst zur " +"<emphasis>Statusverwaltung</emphasis>, das heißt, Sie müssen bei seiner " +"Benutzung nicht in <emphasis>Anweisungen</emphasis> denken. JDBC ist eine " +"perfekte API für die Ausführung von SQL-Anweisungen, sie können jederzeit " +"eine JDBC <literal>Connection</literal> durch Aufruf von <literal>session." +"connection()</literal> erhalten. Desweiteren steht die Idee von " +"Massenvorgängen in Konflikt zu objekt/relationalem Mapping für Anwendungen, " +"die an der Bearbeitung von online Transaktionen orientiert sind. Zukünftige " +"Versionen von Hibernate werden möglicherweise spezielle Funktionen für " +"Massenvorgänge bieten. Unter <xref linkend=\"batch\"/> finden Sie " +"einige mögliche Tricks zur Batch-Bearbeitung." + +#. Tag: title +#, no-c-format +msgid "Modifying detached objects" +msgstr "Änderungen an abgesetzten Objekten" + +#. Tag: para +#, no-c-format +msgid "" +"Many applications need to retrieve an object in one transaction, send it to " +"the UI layer for manipulation, then save the changes in a new transaction. " +"Applications that use this kind of approach in a high-concurrency " +"environment usually use versioned data to ensure isolation for the \"long\" " +"unit of work." +msgstr "" +"Zahlreiche Anwendungen müssen ein Objekt in einer Transaktion abrufen, " +"dieses für Modifizierungen an die UI-Schicht schicken und die Änderungen " +"anschließend in einer neuen Transaktion speichern. Anwendungen, die diese " +"Herangehensweise in einer Umgebung mit hoher Nebenläufigkeit (d.h. häufigem " +"gleichzeitigen Zugriff) benutzen, verwenden in der Regel versionierte Daten, " +"um die Isolation der \"langen\" Arbeitseinheit zu gewährleisten." + +#. Tag: para +#, no-c-format +msgid "" +"Hibernate supports this model by providing for reattachment of detached " +"instances using the <literal>Session.update()</literal> or <literal>Session." +"merge()</literal> methods:" +msgstr "" +"Hibernate unterstützt dieses Modell, indem es mittels der <literal>Session." +"update()</literal> oder <literal>Session.merge()</literal>-Methoden die " +"Möglichkeit der Wiederanbindung abgesetzter Instanzen bietet:" + +#. Tag: para +#, no-c-format +msgid "" +"If the <literal>Cat</literal> with identifier <literal>catId</literal> had " +"already been loaded by <literal>secondSession</literal> when the application " +"tried to reattach it, an exception would have been thrown." +msgstr "" +"Wäre <literal>Cat</literal> mit Bezeichner <literal>catId</literal> bereits " +"durch <literal>secondSession</literal> geladen worden, wenn die Anwendung " +"die Wiederanbindung durchzuführen versucht hätte, so wäre eine Ausnahme " +"gemeldet worden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Use <literal>update()</literal> if you are certain that the session does not " +"contain an already persistent instance with the same identifier. Use " +"<literal>merge()</literal> if you want to merge your modifications at any " +"time without consideration of the state of the session. In other words, " +"<literal>update()</literal> is usually the first method you would call in a " +"fresh session, ensuring that the reattachment of your detached instances is " +"the first operation that is executed." +msgstr "" +"Verwenden Sie <literal>update()</literal> falls Sie sicher sind, dass die " +"Session nicht bereits eine persistente Instanz mit demselben Bezeichner " +"besitzt und <literal>merge()</literal>, falls Sie Ihre Modifikationen zu " +"einem beliebigen Zeitpunkt ohne Berücksichtigung des Sessionstatus mischen " +"möchten. Mit anderen Worten ist <literal>update()</literal> in der Regel die " +"erste Methode, die Sie in einer neuen Session aufrufen würden, um " +"sicherzustellen, dass die Wiederanbindung Ihrer abgesetzten Instanzen der " +"als erstes ausgeführte Vorgang ist." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The application should individually <literal>update()</literal> detached " +"instances that are reachable from the given detached instance " +"<emphasis>only</emphasis> if it wants their state to be updated. This can be " +"automated using <emphasis>transitive persistence</emphasis>. See <xref " +"linkend=\"objectstate-transitive\" /> for more information." +msgstr "" +"Die Anwendung sollte von der gegebenen abgesetzten Instanz aus erreichbare " +"abgesetzte Instanzen einzeln mittels <literal>update()</literal> " +"aktualisieren, jedoch <emphasis>nur</emphasis>, wenn auch deren Status " +"aktualisiert werden soll. Dieser Vorgang kann selbstverständlich mittels " +"<emphasis>transitiver Persistenz</emphasis> automatisiert werden, siehe " +"<xref linkend=\"objectstate-transitive\"/>." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>lock()</literal> method also allows an application to " +"reassociate an object with a new session. However, the detached instance has " +"to be unmodified." +msgstr "" +"Die <literal>lock()</literal>-Methode ermöglicht es einer Anwendung " +"ebenfalls, ein Objekt mit einer neuen Session zu re-assoziieren. Allerdings " +"darf die abgesetzte Instanz in diesem Fall nicht verändert worden sein!" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Note that <literal>lock()</literal> can be used with various " +"<literal>LockMode</literal>s. See the API documentation and the chapter on " +"transaction handling for more information. Reattachment is not the only " +"usecase for <literal>lock()</literal>." +msgstr "" +"Beachten Sie, dass <literal>lock()</literal> mit verschiedenen " +"<literal>LockMode</literal>s verwendet werden kann. Weitere Informationen " +"dazu finden Sie in der API-Dokumentation und dem Kapitel zum \"Transaction " +"Handling\". Die Wiederanbindung ist nicht der einzige Anwendungsfall für " +"<literal>lock()</literal>." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Other models for long units of work are discussed in <xref linkend=" +"\"transactions-optimistic\" />." +msgstr "" +"Andere Modelle für lange Arbeitseinheiten werden in <xref linkend=" +"\"transactions-optimistic\"/> erläutert." + +#. Tag: title +#, no-c-format +msgid "Automatic state detection" +msgstr "Automatische Statuserkennung" + +#. Tag: para +#, no-c-format +msgid "" +"Hibernate users have requested a general purpose method that either saves a " +"transient instance by generating a new identifier or updates/reattaches the " +"detached instances associated with its current identifier. The " +"<literal>saveOrUpdate()</literal> method implements this functionality." +msgstr "" +"Benutzer von Hibernate haben den Wunsch nach einer allgemeinen Methode " +"geäußert, die entweder eine transiente Instanz durch Generierung eines neuen " +"Bezeichners speichert oder die dem aktuellen Bezeichner zugehörigen " +"abgesetzten Instanzen aktualisiert/erneut hinzufügt. Die " +"<literal>saveOrUpdate()</literal>-Methode implementiert diese Funktionalität." + +#. Tag: para +#, no-c-format +msgid "" +"The usage and semantics of <literal>saveOrUpdate()</literal> seems to be " +"confusing for new users. Firstly, so long as you are not trying to use " +"instances from one session in another new session, you should not need to " +"use <literal>update()</literal>, <literal>saveOrUpdate()</literal>, or " +"<literal>merge()</literal>. Some whole applications will never use either of " +"these methods." +msgstr "" +"Gebrauch und Semantik von <literal>saveOrUpdate()</literal> scheinen neue " +"Benutzer manchmal zu überfordern. So lange Sie nicht versuchen, diese " +"Instanzen von einer Session in einer neuen Session zu verwenden, sollten Sie " +"<literal>update()</literal>, <literal>saveOrUpdate()</literal> oder " +"<literal>merge()</literal> ohnehin nicht benutzen müssen. Manchmal kommen " +"ganze Anwendungen ohne irgendeine dieser Methoden aus." + +#. Tag: para +#, no-c-format +msgid "" +"Usually <literal>update()</literal> or <literal>saveOrUpdate()</literal> are " +"used in the following scenario:" +msgstr "" +"In der Regel kommen <literal>update()</literal> oder <literal>saveOrUpdate()" +"</literal> in folgenden Situationen zum Einsatz:" + +#. Tag: para +#, no-c-format +msgid "the application loads an object in the first session" +msgstr "die Anwendung lädt ein Objekt in der ersten Session" + +#. Tag: para +#, no-c-format +msgid "the object is passed up to the UI tier" +msgstr "das Objekt wird an den UI-\"Tier\" weitergegeben" + +#. Tag: para +#, no-c-format +msgid "some modifications are made to the object" +msgstr "am Objekt werden einige Modifikationen vorgenommen" + +#. Tag: para +#, no-c-format +msgid "the object is passed back down to the business logic tier" +msgstr "das Objekt wird zurück an den \"Business-Logic-Tier\" geleitet" + +#. Tag: para +#, no-c-format +msgid "" +"the application persists these modifications by calling <literal>update()</" +"literal> in a second session" +msgstr "" +"die Anwendung persistiert diese Modifikationen durch Aufruf von " +"<literal>update()</literal> in einer zweiten Session" + +#. Tag: para +#, no-c-format +msgid "<literal>saveOrUpdate()</literal> does the following:" +msgstr "<literal>saveOrUpdate()</literal> tut folgendes:" + +#. Tag: para +#, no-c-format +msgid "if the object is already persistent in this session, do nothing" +msgstr "" +"falls das Objekt in dieser Session bereits persistent ist, geschieht nichts" + +#. Tag: para +#, no-c-format +msgid "" +"if another object associated with the session has the same identifier, throw " +"an exception" +msgstr "" +"falls ein anderes mit der Session assoziiertes Objekt denselben Bezeichner " +"besitzt, wird eine Ausnahme gemeldet" + +#. Tag: para +#, no-c-format +msgid "if the object has no identifier property, <literal>save()</literal> it" +msgstr "" +"falls das Objekt keine Bezeichner-Property besitzt, speichern Sie es mittels " +"<literal>save()</literal>" + +#. Tag: para +#, no-c-format +msgid "" +"if the object's identifier has the value assigned to a newly instantiated " +"object, <literal>save()</literal> it" +msgstr "" +"falls der Bezeichner des Objekts einen ihm zugeordneten Wert am neu " +"instantiierten Objekt besitzt, speichern Sie mittels <literal>save()</" +"literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"if the object is versioned by a <literal><version></literal> or " +"<literal><timestamp></literal>, and the version property value is the " +"same value assigned to a newly instantiated object, <literal>save()</" +"literal> it" +msgstr "" +"falls das Objekt versioniert ist (durch <literal><version></literal> " +"oder <literal><timestamp></literal>) und der Property-Wert der Version " +"derselbe Wert wie der dem neu instantiierten Objekt zugeordnete ist, " +"speichern Sie mittels <literal>save()</literal>" + +#. Tag: para +#, no-c-format +msgid "otherwise <literal>update()</literal> the object" +msgstr "" +"andernfalls aktualisieren Sie das Objekt mittels <literal>update()</literal>" + +#. Tag: para +#, no-c-format +msgid "and <literal>merge()</literal> is very different:" +msgstr "und <literal>merge()</literal> ist völlig anders:" + +#. Tag: para +#, no-c-format +msgid "" +"if there is a persistent instance with the same identifier currently " +"associated with the session, copy the state of the given object onto the " +"persistent instance" +msgstr "" +"falls eine persistente Instanz mit demselben Bezeichner zum gegenwärtigen " +"Zeitpunkt mit der Session assoziiert ist, so kopieren Sie den Status des " +"vorgegebenen Objekts in die persistente Instanz" + +#. Tag: para +#, no-c-format +msgid "" +"if there is no persistent instance currently associated with the session, " +"try to load it from the database, or create a new persistent instance" +msgstr "" +"falls keine persistente Instanz zum gegenwärtigen Zeitpunkt mit der Session " +"assoziiert wird, so versuchen Sie sie aus der Datenbank zu laden oder " +"erstellen Sie eine neue persistente Instanz" + +#. Tag: para +#, no-c-format +msgid "the persistent instance is returned" +msgstr "die persistente Instanz wird zurückgeschickt" + +#. Tag: para +#, no-c-format +msgid "" +"the given instance does not become associated with the session, it remains " +"detached" +msgstr "" +"die vorgegebene Instanz wird nicht mit der Session assoziiert, sie bleibt " +"abgesetzt" + +#. Tag: title +#, no-c-format +msgid "Deleting persistent objects" +msgstr "Das Löschen persistenter Objekte" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>Session.delete()</literal> will remove an object's state from the " +"database. Your application, however, can still hold a reference to a deleted " +"object. It is best to think of <literal>delete()</literal> as making a " +"persistent instance, transient." +msgstr "" +"Mit <literal>Session.delete()</literal> wird der Status eines Objekts aus " +"der Datenbank gelöscht. Natürlich kann Ihre Anwendung nach wie vor einen " +"Verweis auf ein gelöschtes Objekt beinhalten. Durch <literal>delete()</" +"literal> wird eine persistente Instanz gewissermaßen transient gemacht." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can delete objects in any order, without risk of foreign key constraint " +"violations. It is still possible to violate a <literal>NOT NULL</literal> " +"constraint on a foreign key column by deleting objects in the wrong order, e." +"g. if you delete the parent, but forget to delete the children." +msgstr "" +"Sie können Objekte in beliebiger Reihenfolge löschen, ohne sich Sorgen um " +"die Verletzung von Fremdschlüsselbedingungen machen zu müssen. Es ist nach " +"wie vor möglich, eine <literal>NOT NULL</literal>-Bedingung an der " +"Fremdschlüsselspalte zu verletzen, indem Objekte in der falschen Reihenfolge " +"gelöscht werden, z.B. wenn Sie das übergeordnete Objekt löschen, jedoch " +"vergessen, dies mit den untergeordneten Objekten ebenfalls zu tun." + +#. Tag: title +#, no-c-format +msgid "Replicating object between two different datastores" +msgstr "Objektreplikation zwischen zwei verschiedenen Datenspeichern" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"It is sometimes useful to be able to take a graph of persistent instances " +"and make them persistent in a different datastore, without regenerating " +"identifier values." +msgstr "" +"Es ist hin und wieder von Nutzen ein Diagramm persistenter Instanzen nehmen " +"zu können und diese in einem anderen Datenspeicher persistent machen zu " +"können, ohne Bezeichnerwerte erneut generieren zu müssen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>ReplicationMode</literal> determines how <literal>replicate()</" +"literal> will deal with conflicts with existing rows in the database:" +msgstr "" +"Der <literal>ReplicationMode</literal> bestimmt, wie <literal>replicate()</" +"literal> mit Konflikten mit bestehenden Reihen in der Datenbank umgeht." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>ReplicationMode.IGNORE</literal>: ignores the object when there is " +"an existing database row with the same identifier" +msgstr "" +"<literal>ReplicationMode.IGNORE</literal> - ignoriert das Objekt, wenn " +"bereits eine Datenbankreihe mit demselben Bezeichner existiert" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>ReplicationMode.OVERWRITE</literal>: overwrites any existing " +"database row with the same identifier" +msgstr "" +"<literal>ReplicationMode.OVERWRITE</literal> - überschreibt eine bestehende " +"Datenbankreihe mit demselben Bezeichner" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>ReplicationMode.EXCEPTION</literal>: throws an exception if there " +"is an existing database row with the same identifier" +msgstr "" +"<literal>ReplicationMode.EXCEPTION</literal> - meldet eine Ausnahme, falls " +"eine Datenbankreihe mit demselben Bezeichner existiert" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>ReplicationMode.LATEST_VERSION</literal>: overwrites the row if its " +"version number is earlier than the version number of the object, or ignore " +"the object otherwise" +msgstr "" +"<literal>ReplicationMode.LATEST_VERSION</literal> - überschreibt die Reihe, " +"falls deren Versionsnummer älter ist als die Versionsnummer des Objekts, " +"oder ignoriert andernfalls das Objekt" + +#. Tag: para +#, no-c-format +msgid "" +"Usecases for this feature include reconciling data entered into different " +"database instances, upgrading system configuration information during " +"product upgrades, rolling back changes made during non-ACID transactions and " +"more." +msgstr "" +"Anwendungsfälle dieses Features beinhalten die Abstimmung von in " +"verschiedenen Datenbankinstanzen eingegebenen Daten, das Upgrade von " +"Systemkonfigurationsinformationen während Produkt-Upgrades, die Wiederholung " +"von während nicht-ACID Transaktionen gemachten Änderungen und mehr." + +#. Tag: title +#, no-c-format +msgid "Flushing the Session" +msgstr "Das Räumen der Session" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Sometimes the <literal>Session</literal> will execute the SQL statements " +"needed to synchronize the JDBC connection's state with the state of objects " +"held in memory. This process, called <emphasis>flush</emphasis>, occurs by " +"default at the following points:" +msgstr "" +"Von Zeit zu Zeit wird die <literal>Session</literal> die SQL-Anweisungen " +"ausführen, die benötigt werden, um den Verbindungsstatus der JDBC mit dem " +"Status der gespeicherten Objekte zu synchronisieren. Während dieses Vorgangs " +"kommt es standardmäßig an den folgenden Punkten zur <emphasis>Räumung</" +"emphasis>" + +#. Tag: para +#, no-c-format +msgid "before some query executions" +msgstr "vor dem Ausführen einiger Anfragen" + +#. Tag: para +#, no-c-format +msgid "from <literal>org.hibernate.Transaction.commit()</literal>" +msgstr "von <literal>org.hibernate.Transaction.commit()</literal>" + +#. Tag: para +#, no-c-format +msgid "from <literal>Session.flush()</literal>" +msgstr "von <literal>Session.flush()</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "The SQL statements are issued in the following order:" +msgstr "Die SQL-Anweisungen werden in der folgenden Reihenfolge herausgegeben" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"all entity insertions in the same order the corresponding objects were saved " +"using <literal>Session.save()</literal>" +msgstr "" +"alle Entity-Einfügungen in derselben Reihenfolge der entsprechenden Objekte " +"wurden mittels <literal>Session.save()</literal> gespeichert" + +#. Tag: para +#, no-c-format +msgid "all entity updates" +msgstr "alle Entity-Aktualisierungen" + +#. Tag: para +#, no-c-format +msgid "all collection deletions" +msgstr "alle Collection-Löschungen" + +#. Tag: para +#, no-c-format +msgid "all collection element deletions, updates and insertions" +msgstr "" +"alle Löschungen, Aktualisierungen und Einfügungen von Elementen der " +"Collection" + +#. Tag: para +#, no-c-format +msgid "all collection insertions" +msgstr "alle Einfügungen in Collections" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"all entity deletions in the same order the corresponding objects were " +"deleted using <literal>Session.delete()</literal>" +msgstr "" +"alle Entity-Löschungen in derselben Reihenfolge, in der die entsprechenden " +"Objekte gelöscht wurden unter Verwendung von <literal>Session.delete()</" +"literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"An exception is that objects using <literal>native</literal> ID generation " +"are inserted when they are saved." +msgstr "" +"(Eine Ausnahme ist, dass Objekte, die <literal>native</literal> ID-" +"Generierung verwenden, beim Speichern eingefügt werden)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Except when you explicitly <literal>flush()</literal>, there are absolutely " +"no guarantees about <emphasis>when</emphasis> the <literal>Session</literal> " +"executes the JDBC calls, only the <emphasis>order</emphasis> in which they " +"are executed. However, Hibernate does guarantee that the <literal>Query.list" +"(..)</literal> will never return stale or incorrect data." +msgstr "" +"Außer wenn Sie explizit <literal>flush()</literal> einsetzen, gibt es " +"keinerlei Garantien dafür, <emphasis>wann</emphasis> die <literal>Session</" +"literal> die JDBC-Aufrufe ausführt, nur die <emphasis>Reihenfolge</emphasis> " +"der Ausführung steht fest. Hibernate gewährleistet jedoch, dass die " +"<literal>Query.list(..)</literal> niemals abgelaufene oder falsche Daten " +"liefert." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"It is possible to change the default behavior so that flush occurs less " +"frequently. The <literal>FlushMode</literal> class defines three different " +"modes: only flush at commit time when the Hibernate <literal>Transaction</" +"literal> API is used, flush automatically using the explained routine, or " +"never flush unless <literal>flush()</literal> is called explicitly. The last " +"mode is useful for long running units of work, where a <literal>Session</" +"literal> is kept open and disconnected for a long time (see <xref linkend=" +"\"transactions-optimistic-longsession\" />)." +msgstr "" +"Es ist möglich das Verhalten in der Standardeinstellung so zu verändern, " +"dass die Räumung seltener erfolgt.Die <literal>FlushMode</literal>-Klasse " +"definiert drei verschiedene Modi: Nur zum Zeitpunkt des Festschreibens (sog. " +"\"Commit-Time\") räumen (und nur wenn die Hibernate <literal>Transaction</" +"literal> API verwendet wird), mittels der beschriebenen Routine automatisch " +"räumen oder nie räumen, außer wenn der Aufruf <literal>flush()</literal> " +"explizit erfolgt. Der letzte Modus ist insbesondere bei langen " +"Arbeitseinheiten von Nutzen, wenn eine <literal>Session</literal> über " +"längere Zeit hinweg geöffnet und abgekuppelt bleibt (siehe <xref linkend=" +"\"transactions-optimistic-longsession\"/" +">)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"During flush, an exception might occur (e.g. if a DML operation violates a " +"constraint). Since handling exceptions involves some understanding of " +"Hibernate's transactional behavior, we discuss it in <xref linkend=" +"\"transactions\" />." +msgstr "" +"Während der Räumung kann es zu einer Ausnahmemeldung kommen (wenn z.B. ein " +"DML-Vorgang eine Bedingung verletzt). Da der Umgang mit Ausnahmen ein " +"gewisses Verständnis für das transaktionale Verhalten in Hibernate " +"voraussetzt, erläutern wir es in <xref linkend=\"transactions\"/>." + +#. Tag: title +#, no-c-format +msgid "Transitive persistence" +msgstr "Transitive Persistenz" + +#. Tag: para +#, no-c-format +msgid "" +"It is quite cumbersome to save, delete, or reattach individual objects, " +"especially if you deal with a graph of associated objects. A common case is " +"a parent/child relationship. Consider the following example:" +msgstr "" +"Es ist recht mühselig, einzelne Objekte zu speichern, zu löschen und erneut " +"hinzuzufügen, insbesondere dann, wenn man es mit einem Diagramm assoziierter " +"Objekte zu tun hat. Ein gängiger Fall ist die Beziehung zwischen " +"übergeordneten und untergeordneten Objekten (sog. \"parent/child\"-" +"Beziehung). Sehen Sie sich das folgende Beispiel an:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If the children in a parent/child relationship would be value typed (e.g. a " +"collection of addresses or strings), their life cycle would depend on the " +"parent and no further action would be required for convenient \"cascading\" " +"of state changes. When the parent is saved, the value-typed child objects " +"are saved and when the parent is deleted, the children will be deleted, etc. " +"This works for operations such as the removal of a child from the " +"collection. Since value-typed objects cannot have shared references, " +"Hibernate will detect this and delete the child from the database." +msgstr "" +"Falls die untergeordneten Objekte (\"children\") in einer \"Parent/Child\"-" +"Beziehung Wertetypen wären (z.B. eine Collection von Adressen oder Strings), " +"so wäre ihr Lebenszyklus abhängig vom übergeordneten Objekt (\"Parent\"), " +"und es wären keine weiteren Maßnahmen nötig, um die Statusänderungen bequem " +"weiterzugeben (sog. \"cascading\"). Wenn das übergeordnete Objekt " +"gespeichert wird, so werden auch die untergeordneten Objekte gespeichert, " +"wird ein übergeordnetes Objekt gelöscht, werden auch die untergeordneten " +"Objekte gelöscht usw. Das funktioniert sogar für Vorgänge bei denen etwa ein " +"untergeordnetes Objekt aus der Collection entfernt wird: Hibernate spürt " +"dieses auf und da solche Objekte keine geteilten Verweise besitzen können, " +"wird das untergeordnete Objekt aus der Datenbank gelöscht." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Now consider the same scenario with parent and child objects being entities, " +"not value-types (e.g. categories and items, or parent and child cats). " +"Entities have their own life cycle and support shared references. Removing " +"an entity from the collection does not mean it can be deleted), and there is " +"by default no cascading of state from one entity to any other associated " +"entities. Hibernate does not implement <emphasis>persistence by " +"reachability</emphasis> by default." +msgstr "" +"Stellen Sie sich nun dieselbe Situation vor, mit dem Unterschied, dass es " +"sich bei übergeordneten und untergeordneten Objekten um Entities, nicht " +"Wertetypen (z.B. Kategorien und Posten oder \"Parent\" und \"Child\"-Cats) " +"handelt. Entities besitzen ihren eigenen Lebenszyklus, unterstützen geteilte " +"Verweise (d.h. selbst wenn eine Entity aus der Collection entfernt wird, " +"kann sie deswegen nicht gelöscht werden) und standardmäßig existiert keine " +"Statusweitergabe von einer Entity an eine andere zugehörige Entity. " +"Hibernate implementiert standardmäßig keine <emphasis>Persistenz durch " +"Erreichbarkeit</emphasis>." + +#. Tag: para +#, no-c-format +msgid "" +"For each basic operation of the Hibernate session - including " +"<literal>persist(), merge(), saveOrUpdate(), delete(), lock(), refresh(), " +"evict(), replicate()</literal> - there is a corresponding cascade style. " +"Respectively, the cascade styles are named <literal>create, merge, save-" +"update, delete, lock, refresh, evict, replicate</literal>. If you want an " +"operation to be cascaded along an association, you must indicate that in the " +"mapping document. For example:" +msgstr "" +"Für jeden Grundvorgang der Hibernate Session - einschließlich " +"<literal>persist(), merge(), saveOrUpdate(), delete(), lock(), refresh(), " +"evict(), replicate()</literal> - gibt es eine entsprechende Art der " +"Weitergabe. Die Arten sind dem entsprechend <literal>create, merge, save-" +"update, delete, lock, refresh, evict, replicate</literal> benannt. Falls Sie " +"möchten, dass ein Vorgang entlang einer Assoziation weitergegeben wird, so " +"müssen Sie dass im Mapping-Dokument angeben. Zum Beispiel wie folgt aussehen:" + +#. Tag: para +#, no-c-format +msgid "Cascade styles my be combined:" +msgstr "" +"Die Arten der Weitergabe (sog. \"Cascade Styles\") können kombiniert werden:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can even use <literal>cascade=\"all\"</literal> to specify that " +"<emphasis>all</emphasis> operations should be cascaded along the " +"association. The default <literal>cascade=\"none\"</literal> specifies that " +"no operations are to be cascaded." +msgstr "" +"Sie können sogar mittels <literal>cascade=\"all\"</literal> bestimmen, " +"dass<emphasis>alle</emphasis> Vorgänge entlang der Assoziation weitergegeben " +"werden. In der Standardeinstellung <literal>cascade=\"none\"</literal> ist " +"festgelegt, dass keine Vorgänge weitergegeben werden." + +#. Tag: para +#, no-c-format +msgid "" +"A special cascade style, <literal>delete-orphan</literal>, applies only to " +"one-to-many associations, and indicates that the <literal>delete()</literal> " +"operation should be applied to any child object that is removed from the " +"association." +msgstr "" +"Eine besondere Art der Weitergabe namens <literal>delete-orphan</literal> " +"gilt nur bei \"One-to-Many\"-Assoziationen und zeigt an, dass der " +"<literal>delete()</literal>-Vorgang angewendet werden soll, wenn ein " +"untergeordnetes Objekt aus der Assoziation entfernt wird." + +#. Tag: para +#, no-c-format +msgid "Recommendations:" +msgstr "Empfehlungen:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"It does not usually make sense to enable cascade on a <literal><many-to-" +"one></literal> or <literal><many-to-many></literal> association. " +"Cascade is often useful for <literal><one-to-one></literal> and " +"<literal><one-to-many></literal> associations." +msgstr "" +"Es macht in der Regel keinen Sinn, die Weitergabe bei einer <literal><" +"many-to-one></literal> oder <literal><many-to-many></literal>-" +"Assoziation zu aktivieren. Die Weitergabe ist oftmals für <literal><one-" +"to-one></literal> und <literal><one-to-many></literal>-" +"Assoziationen von Nutzen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If the child object's lifespan is bounded by the lifespan of the parent " +"object, make it a <emphasis>life cycle object</emphasis> by specifying " +"<literal>cascade=\"all,delete-orphan\"</literal>." +msgstr "" +"Falls die Lebensdauer des untergeordneten Objekts an die Lebensdauer des " +"übergeordneten Objekts gebunden ist, erklären Sie es zum <emphasis>" +"\"Lifecycle Object\"</emphasis> indem Sie <literal>cascade=\"all,delete-" +"orphan\"</literal> festlegen." + +#. Tag: para +#, no-c-format +msgid "" +"Otherwise, you might not need cascade at all. But if you think that you will " +"often be working with the parent and children together in the same " +"transaction, and you want to save yourself some typing, consider using " +"<literal>cascade=\"persist,merge,save-update\"</literal>." +msgstr "" +"Andernfalls wird keine Weitergabe benötigt. Wenn Sie jedoch glauben, dass " +"Sie oft mit über- und untergeordneten Objekten in derselben Transaktion " +"arbeiten werden und Sie sich etwas Tipparbeit sparen möchten, so können Sie " +"<literal>cascade=\"persist,merge,save-update\"</literal> verwenden." + +#. Tag: para +#, no-c-format +msgid "" +"Mapping an association (either a single valued association, or a collection) " +"with <literal>cascade=\"all\"</literal> marks the association as a " +"<emphasis>parent/child</emphasis> style relationship where save/update/" +"delete of the parent results in save/update/delete of the child or children." +msgstr "" +"Das Mappen einer Assoziation (entweder einer einwertigen Assoziation oder " +"einer Collection) unter Verwendung von <literal>cascade=\"all\"</literal> " +"kennzeichnet die Assoziation als zum <emphasis>Parent/Child</emphasis>-" +"Beziehungstyp gehörig, bei dem Speichern/Aktualisieren/Löschen des " +"übergeordneten Objekts zum Speichern/Aktualisieren/Löschen des " +"untergeordneten Objekts (oder Objekte) führt." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Furthermore, a mere reference to a child from a persistent parent will " +"result in save/update of the child. This metaphor is incomplete, however. A " +"child which becomes unreferenced by its parent is <emphasis>not</emphasis> " +"automatically deleted, except in the case of a <literal><one-to-many></" +"literal> association mapped with <literal>cascade=\"delete-orphan\"</" +"literal>. The precise semantics of cascading operations for a parent/child " +"relationship are as follows:" +msgstr "" +"Desweiteren führt schon der Verweis eines übergeordneten Objektes auf ein " +"untergeordnetes Objekt zur Speicherung/Aktualisierung des letzteren. Diese " +"Metapher ist jedoch unvollständig. Ein untergeordnetes Objekt auf das nicht " +"mehr durch das übergeordnete Objekt verwiesen wird, wird <emphasis>nicht</" +"emphasis> automatisch gelöscht, außer im Fall einer <literal><one-to-" +"many></literal>-Assoziation, die mit <literal>cascade=\"delete-orphan\"</" +"literal> gemappt ist. Die exakte Sematik bei Weitergabevorgängen bei der " +"\"Parent\"/\"Child\"-Beziehung lautet wie folgt:" + +#. Tag: para +#, no-c-format +msgid "" +"If a parent is passed to <literal>persist()</literal>, all children are " +"passed to <literal>persist()</literal>" +msgstr "" +"Falls für einen \"Parent\" <literal>persist()</literal> gilt, so gilt für " +"sämtliche \"Children\" ebenfalls <literal>persist()</literal>" + +#. Tag: para +#, no-c-format +msgid "" +"If a parent is passed to <literal>merge()</literal>, all children are passed " +"to <literal>merge()</literal>" +msgstr "" +"Falls für einen \"Parent\" <literal>merge()</literal> gilt, so gilt für " +"sämtliche \"Children\" ebenfalls <literal>merge()</literal>" + +#. Tag: para +#, no-c-format +msgid "" +"If a parent is passed to <literal>save()</literal>, <literal>update()</" +"literal> or <literal>saveOrUpdate()</literal>, all children are passed to " +"<literal>saveOrUpdate()</literal>" +msgstr "" +"Falls für einen \"Parent\" <literal>save()</literal>, <literal>update()</" +"literal> oder <literal>saveOrUpdate()</literal> gilt, so gilt für sämtliche " +"\"Children\" ebenfalls <literal>saveOrUpdate()</literal>" + +#. Tag: para +#, no-c-format +msgid "" +"If a transient or detached child becomes referenced by a persistent parent, " +"it is passed to <literal>saveOrUpdate()</literal>" +msgstr "" +"Falls auf ein transientes oder abgesetztes \"Child\" durch einen " +"persistenten \"Parent\" verwiesen wird, so gilt dafür <literal>saveOrUpdate()" +"</literal>" + +#. Tag: para +#, no-c-format +msgid "" +"If a parent is deleted, all children are passed to <literal>delete()</" +"literal>" +msgstr "" +"Falls ein \"Parent\" gelöscht wird, so gilt für alle \"Children\" " +"<literal>delete()</literal>" + +#. Tag: para +#, no-c-format +msgid "" +"If a child is dereferenced by a persistent parent, <emphasis>nothing special " +"happens</emphasis> - the application should explicitly delete the child if " +"necessary - unless <literal>cascade=\"delete-orphan\"</literal>, in which " +"case the \"orphaned\" child is deleted." +msgstr "" +"Falls der Verweis auf ein \"Child\" von einem persistenten \"Parent\" " +"entfällt, <emphasis>passiert nicht besonderes</emphasis> - die Anwendung " +"sollte das \"Child\" explizit löschen falls nötig - außer es gilt " +"<literal>cascade=\"delete-orphan\"</literal>, in welchem Fall das \"verwaiste" +"\" Child gelöscht wird." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Finally, note that cascading of operations can be applied to an object graph " +"at <emphasis>call time</emphasis> or at <emphasis>flush time</emphasis>. All " +"operations, if enabled, are cascaded to associated entities reachable when " +"the operation is executed. However, <literal>save-update</literal> and " +"<literal>delete-orphan</literal> are transitive for all associated entities " +"reachable during flush of the <literal>Session</literal>." +msgstr "" +"Beachten Sie außerdem, dass die Weitergabe von Vorgängen bei einem " +"Objektdiagramm zum <emphasis>Zeitpunkt des Aufrufs</emphasis> oder " +"<emphasis>zum Zeitpunkt der Räumung</emphasis> angewendet werden kann. Falls " +"aktiviert werden alle Vorgänge an assoziierte Entities weitergegeben, die " +"bei der Ausführung des Vorgangs erreichbar sind. Jedoch sind <literal>save-" +"upate</literal> und <literal>delete-orphan</literal> für alle während der " +"Räumung der <literal>Session</literal> erreichbaren, zugehörigen Entities " +"transitiv." + +#. Tag: title +#, no-c-format +msgid "Using metadata" +msgstr "Die Verwendung von Metadata" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate requires a rich meta-level model of all entity and value types. " +"This model can be useful to the application itself. For example, the " +"application might use Hibernate's metadata to implement a \"smart\" deep-" +"copy algorithm that understands which objects should be copied (eg. mutable " +"value types) and which objects that should not (e.g. immutable value types " +"and, possibly, associated entities)." +msgstr "" +"Hibernate benötigt von allen Entity und Wertetypen ein sehr umfassendes " +"Modell auf Meta-Ebene. Von Zeit zu Zeit ist dieses Modell für die Anwendung " +"selbst sehr hilfreich. Die Anwendung könnte zum Beispiel Hibernates " +"Metadaten verwenden, um einen \"intelligenten\" Algorithmus der Detailkopie " +"zu implementieren, der weiß, welche Objekte kopiert werden müssen (z.B. " +"veränderliche Wertetypen) und welche nicht (z.B. unveränderliche Wertetypen " +"und möglicherweise zugehörige Entities)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate exposes metadata via the <literal>ClassMetadata</literal> and " +"<literal>CollectionMetadata</literal> interfaces and the <literal>Type</" +"literal> hierarchy. Instances of the metadata interfaces can be obtained " +"from the <literal>SessionFactory</literal>." +msgstr "" +"Hibernate legt Metadata mittels der <literal>ClassMetadata</literal> und " +"<literal>CollectionMetadata</literal>-Interfaces und der <literal>Type</" +"literal>-Hierarchie dar. Instanzen der Metadata-Interfaces sind durch die " +"<literal>SessionFactory</literal> verfügbar." + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[DomesticCat fritz = new DomesticCat();\n" +#~ "fritz.setColor(Color.GINGER);\n" +#~ "fritz.setSex('M');\n" +#~ "fritz.setName(\"Fritz\");\n" +#~ "Long generatedId = (Long) sess.save(fritz);]]>" +#~ msgstr "" +#~ "DomesticCat fritz = new DomesticCat();\n" +#~ "fritz.setColor(Color.GINGER);\n" +#~ "fritz.setSex('M');\n" +#~ "fritz.setName(\"Fritz\");\n" +#~ "Long generatedId = (Long) sess.save(fritz);" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[DomesticCat pk = new DomesticCat();\n" +#~ "pk.setColor(Color.TABBY);\n" +#~ "pk.setSex('F');\n" +#~ "pk.setName(\"PK\");\n" +#~ "pk.setKittens( new HashSet() );\n" +#~ "pk.addKitten(fritz);\n" +#~ "sess.save( pk, new Long(1234) );]]>" +#~ msgstr "" +#~ "DomesticCat pk = new DomesticCat();\n" +#~ "pk.setColor(Color.TABBY);\n" +#~ "pk.setSex('F');\n" +#~ "pk.setName(\"PK\");\n" +#~ "pk.setKittens( new HashSet() );\n" +#~ "pk.addKitten(fritz);\n" +#~ "sess.save( pk, new Long(1234) );" + +#, fuzzy +#~ msgid "<![CDATA[Cat fritz = (Cat) sess.load(Cat.class, generatedId);]]>" +#~ msgstr "Cat fritz = (Cat) sess.load(Cat.class, generatedId);" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[// you need to wrap primitive identifiers\n" +#~ "long id = 1234;\n" +#~ "DomesticCat pk = (DomesticCat) sess.load( DomesticCat.class, new Long" +#~ "(id) );]]>" +#~ msgstr "" +#~ "// you need to wrap primitive identifiers\n" +#~ "long id = 1234;\n" +#~ "DomesticCat pk = (DomesticCat) sess.load( DomesticCat.class, new Long" +#~ "(id) );" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Cat cat = new DomesticCat();\n" +#~ "// load pk's state into cat\n" +#~ "sess.load( cat, new Long(pkId) );\n" +#~ "Set kittens = cat.getKittens();]]>" +#~ msgstr "" +#~ "Cat cat = new DomesticCat();\n" +#~ "// load pk's state into cat\n" +#~ "sess.load( cat, new Long(pkId) );\n" +#~ "Set kittens = cat.getKittens();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Cat cat = (Cat) sess.get(Cat.class, id);\n" +#~ "if (cat==null) {\n" +#~ " cat = new Cat();\n" +#~ " sess.save(cat, id);\n" +#~ "}\n" +#~ "return cat;]]>" +#~ msgstr "" +#~ "Cat cat = (Cat) sess.get(Cat.class, id);\n" +#~ "if (cat==null) {\n" +#~ " cat = new Cat();\n" +#~ " sess.save(cat, id);\n" +#~ "}\n" +#~ "return cat;" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Cat cat = (Cat) sess.get(Cat.class, id, LockMode.UPGRADE);]]>" +#~ msgstr "Cat cat = (Cat) sess.get(Cat.class, id, LockMode.UPGRADE);" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[sess.save(cat);\n" +#~ "sess.flush(); //force the SQL INSERT\n" +#~ "sess.refresh(cat); //re-read the state (after the trigger executes)]]>" +#~ msgstr "" +#~ "sess.save(cat);\n" +#~ "sess.flush(); //force the SQL INSERT\n" +#~ "sess.refresh(cat); //re-read the state (after the trigger executes)" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[List cats = session.createQuery(\n" +#~ " \"from Cat as cat where cat.birthdate < ?\")\n" +#~ " .setDate(0, date)\n" +#~ " .list();\n" +#~ "\n" +#~ "List mothers = session.createQuery(\n" +#~ " \"select mother from Cat as cat join cat.mother as mother where cat." +#~ "name = ?\")\n" +#~ " .setString(0, name)\n" +#~ " .list();\n" +#~ "\n" +#~ "List kittens = session.createQuery(\n" +#~ " \"from Cat as cat where cat.mother = ?\")\n" +#~ " .setEntity(0, pk)\n" +#~ " .list();\n" +#~ "\n" +#~ "Cat mother = (Cat) session.createQuery(\n" +#~ " \"select cat.mother from Cat as cat where cat = ?\")\n" +#~ " .setEntity(0, izi)\n" +#~ " .uniqueResult();]]\n" +#~ "\n" +#~ "Query mothersWithKittens = (Cat) session.createQuery(\n" +#~ " \"select mother from Cat as mother left join fetch mother.kittens" +#~ "\");\n" +#~ "Set uniqueMothers = new HashSet(mothersWithKittens.list());]]>" +#~ msgstr "" +#~ "List cats = session.createQuery(\n" +#~ " \"from Cat as cat where cat.birthdate < ?\")\n" +#~ " .setDate(0, date)\n" +#~ " .list();\n" +#~ "\n" +#~ "List mothers = session.createQuery(\n" +#~ " \"select mother from Cat as cat join cat.mother as mother where cat." +#~ "name = ?\")\n" +#~ " .setString(0, name)\n" +#~ " .list();\n" +#~ "\n" +#~ "List kittens = session.createQuery(\n" +#~ " \"from Cat as cat where cat.mother = ?\")\n" +#~ " .setEntity(0, pk)\n" +#~ " .list();\n" +#~ "\n" +#~ "Cat mother = (Cat) session.createQuery(\n" +#~ " \"select cat.mother from Cat as cat where cat = ?\")\n" +#~ " .setEntity(0, izi)\n" +#~ " .uniqueResult();]]\n" +#~ "\n" +#~ "Query mothersWithKittens = (Cat) session.createQuery(\n" +#~ " \"select mother from Cat as mother left join fetch mother.kittens" +#~ "\");\n" +#~ "Set uniqueMothers = new HashSet(mothersWithKittens.list());" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[// fetch ids\n" +#~ "Iterator iter = sess.createQuery(\"from eg.Qux q order by q.likeliness\")." +#~ "iterate();\n" +#~ "while ( iter.hasNext() ) {\n" +#~ " Qux qux = (Qux) iter.next(); // fetch the object\n" +#~ " // something we couldnt express in the query\n" +#~ " if ( qux.calculateComplicatedAlgorithm() ) {\n" +#~ " // delete the current instance\n" +#~ " iter.remove();\n" +#~ " // dont need to process the rest\n" +#~ " break;\n" +#~ " }\n" +#~ "}]]>" +#~ msgstr "" +#~ "// fetch ids\n" +#~ "Iterator iter = sess.createQuery(\"from eg.Qux q order by q.likeliness\")." +#~ "iterate();\n" +#~ "while ( iter.hasNext() ) {\n" +#~ " Qux qux = (Qux) iter.next(); // fetch the object\n" +#~ " // something we couldnt express in the query\n" +#~ " if ( qux.calculateComplicatedAlgorithm() ) {\n" +#~ " // delete the current instance\n" +#~ " iter.remove();\n" +#~ " // dont need to process the rest\n" +#~ " break;\n" +#~ " }\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Iterator kittensAndMothers = sess.createQuery(\n" +#~ " \"select kitten, mother from Cat kitten join kitten.mother " +#~ "mother\")\n" +#~ " .list()\n" +#~ " .iterator();\n" +#~ "\n" +#~ "while ( kittensAndMothers.hasNext() ) {\n" +#~ " Object[] tuple = (Object[]) kittensAndMothers.next();\n" +#~ " Cat kitten = (Cat) tuple[0];\n" +#~ " Cat mother = (Cat) tuple[1];\n" +#~ " ....\n" +#~ "}]]>" +#~ msgstr "" +#~ "Iterator kittensAndMothers = sess.createQuery(\n" +#~ " \"select kitten, mother from Cat kitten join kitten.mother " +#~ "mother\")\n" +#~ " .list()\n" +#~ " .iterator();\n" +#~ "\n" +#~ "while ( kittensAndMothers.hasNext() ) {\n" +#~ " Object[] tuple = (Object[]) kittensAndMothers.next();\n" +#~ " Cat kitten = tuple[0];\n" +#~ " Cat mother = tuple[1];\n" +#~ " ....\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Iterator results = sess.createQuery(\n" +#~ " \"select cat.color, min(cat.birthdate), count(cat) from Cat cat " +#~ "\" +\n" +#~ " \"group by cat.color\")\n" +#~ " .list()\n" +#~ " .iterator();\n" +#~ "\n" +#~ "while ( results.hasNext() ) {\n" +#~ " Object[] row = (Object[]) results.next();\n" +#~ " Color type = (Color) row[0];\n" +#~ " Date oldest = (Date) row[1];\n" +#~ " Integer count = (Integer) row[2];\n" +#~ " .....\n" +#~ "}]]>" +#~ msgstr "" +#~ "Iterator results = sess.createQuery(\n" +#~ " \"select cat.color, min(cat.birthdate), count(cat) from Cat cat " +#~ "\" +\n" +#~ " \"group by cat.color\")\n" +#~ " .list()\n" +#~ " .iterator();\n" +#~ "\n" +#~ "while ( results.hasNext() ) {\n" +#~ " Object[] row = (Object[]) results.next();\n" +#~ " Color type = (Color) row[0];\n" +#~ " Date oldest = (Date) row[1];\n" +#~ " Integer count = (Integer) row[2];\n" +#~ " .....\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[//named parameter (preferred)\n" +#~ "Query q = sess.createQuery(\"from DomesticCat cat where cat.name = :name" +#~ "\");\n" +#~ "q.setString(\"name\", \"Fritz\");\n" +#~ "Iterator cats = q.iterate();]]>" +#~ msgstr "" +#~ "//named parameter (preferred)\n" +#~ "Query q = sess.createQuery(\"from DomesticCat cat where cat.name = :name" +#~ "\");\n" +#~ "q.setString(\"name\", \"Fritz\");\n" +#~ "Iterator cats = q.iterate();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[//positional parameter\n" +#~ "Query q = sess.createQuery(\"from DomesticCat cat where cat.name = ?\");\n" +#~ "q.setString(0, \"Izi\");\n" +#~ "Iterator cats = q.iterate();]]>" +#~ msgstr "" +#~ "//positional parameter\n" +#~ "Query q = sess.createQuery(\"from DomesticCat cat where cat.name = ?\");\n" +#~ "q.setString(0, \"Izi\");\n" +#~ "Iterator cats = q.iterate();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[//named parameter list\n" +#~ "List names = new ArrayList();\n" +#~ "names.add(\"Izi\");\n" +#~ "names.add(\"Fritz\");\n" +#~ "Query q = sess.createQuery(\"from DomesticCat cat where cat.name in (:" +#~ "namesList)\");\n" +#~ "q.setParameterList(\"namesList\", names);\n" +#~ "List cats = q.list();]]>" +#~ msgstr "" +#~ "//named parameter list\n" +#~ "List names = new ArrayList();\n" +#~ "names.add(\"Izi\");\n" +#~ "names.add(\"Fritz\");\n" +#~ "Query q = sess.createQuery(\"from DomesticCat cat where cat.name in (:" +#~ "namesList)\");\n" +#~ "q.setParameterList(\"namesList\", names);\n" +#~ "List cats = q.list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Query q = sess.createQuery(\"from DomesticCat cat\");\n" +#~ "q.setFirstResult(20);\n" +#~ "q.setMaxResults(10);\n" +#~ "List cats = q.list();]]>" +#~ msgstr "" +#~ "Query q = sess.createQuery(\"from DomesticCat cat\");\n" +#~ "q.setFirstResult(20);\n" +#~ "q.setMaxResults(10);\n" +#~ "List cats = q.list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Query q = sess.createQuery(\"select cat.name, cat from " +#~ "DomesticCat cat \" +\n" +#~ " \"order by cat.name\");\n" +#~ "ScrollableResults cats = q.scroll();\n" +#~ "if ( cats.first() ) {\n" +#~ "\n" +#~ " // find the first name on each page of an alphabetical list of cats " +#~ "by name\n" +#~ " firstNamesOfPages = new ArrayList();\n" +#~ " do {\n" +#~ " String name = cats.getString(0);\n" +#~ " firstNamesOfPages.add(name);\n" +#~ " }\n" +#~ " while ( cats.scroll(PAGE_SIZE) );\n" +#~ "\n" +#~ " // Now get the first page of cats\n" +#~ " pageOfCats = new ArrayList();\n" +#~ " cats.beforeFirst();\n" +#~ " int i=0;\n" +#~ " while( ( PAGE_SIZE > i++ ) && cats.next() ) pageOfCats.add( cats.get" +#~ "(1) );\n" +#~ "\n" +#~ "}\n" +#~ "cats.close()]]>" +#~ msgstr "" +#~ "Query q = sess.createQuery(\"select cat.name, cat from DomesticCat cat \" " +#~ "+\n" +#~ " \"order by cat.name\");\n" +#~ "ScrollableResults cats = q.scroll();\n" +#~ "if ( cats.first() ) {\n" +#~ "\n" +#~ " // find the first name on each page of an alphabetical list of cats " +#~ "by name\n" +#~ " firstNamesOfPages = new ArrayList();\n" +#~ " do {\n" +#~ " String name = cats.getString(0);\n" +#~ " firstNamesOfPages.add(name);\n" +#~ " }\n" +#~ " while ( cats.scroll(PAGE_SIZE) );\n" +#~ "\n" +#~ " // Now get the first page of cats\n" +#~ " pageOfCats = new ArrayList();\n" +#~ " cats.beforeFirst();\n" +#~ " int i=0;\n" +#~ " while( ( PAGE_SIZE > i++ ) && cats.next() ) pageOfCats.add" +#~ "( cats.get(1) );\n" +#~ "\n" +#~ "}\n" +#~ "cats.close()" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<query name=\"ByNameAndMaximumWeight\"><![CDATA[\n" +#~ " from eg.DomesticCat as cat\n" +#~ " where cat.name = ?\n" +#~ " and cat.weight > ?\n" +#~ "] ]></query>]]>" +#~ msgstr "" +#~ "<query name=\"ByNameAndMaximumWeight\"><![CDATA[\n" +#~ " from eg.DomesticCat as cat\n" +#~ " where cat.name = ?\n" +#~ " and cat.weight > ?\n" +#~ "] ]></query>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Query q = sess.getNamedQuery(\"ByNameAndMaximumWeight\");\n" +#~ "q.setString(0, name);\n" +#~ "q.setInt(1, minWeight);\n" +#~ "List cats = q.list();]]>" +#~ msgstr "" +#~ "Query q = sess.getNamedQuery(\"ByNameAndMaximumWeight\");\n" +#~ "q.setString(0, name);\n" +#~ "q.setInt(1, minWeight);\n" +#~ "List cats = q.list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Collection blackKittens = session.createFilter(\n" +#~ " pk.getKittens(), \n" +#~ " \"where this.color = ?\")\n" +#~ " .setParameter( Color.BLACK, Hibernate.custom(ColorUserType.class) )\n" +#~ " .list()\n" +#~ ");]]>" +#~ msgstr "" +#~ "Collection blackKittens = session.createFilter(\n" +#~ " pk.getKittens(), \n" +#~ " \"where this.color = ?\")\n" +#~ " .setParameter( Color.BLACK, Hibernate.custom(ColorUserType.class) )\n" +#~ " .list()\n" +#~ ");" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Collection blackKittenMates = session.createFilter(\n" +#~ " pk.getKittens(), \n" +#~ " \"select this.mate where this.color = eg.Color.BLACK.intValue\")\n" +#~ " .list();]]>" +#~ msgstr "" +#~ "Collection blackKittenMates = session.createFilter(\n" +#~ " pk.getKittens(), \n" +#~ " \"select this.mate where this.color = eg.Color.BLACK.intValue\")\n" +#~ " .list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Collection tenKittens = session.createFilter(\n" +#~ " mother.getKittens(), \"\")\n" +#~ " .setFirstResult(0).setMaxResults(10)\n" +#~ " .list();]]>" +#~ msgstr "" +#~ "Collection tenKittens = session.createFilter(\n" +#~ " mother.getKittens(), \"\")\n" +#~ " .setFirstResult(0).setMaxResults(10)\n" +#~ " .list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Criteria crit = session.createCriteria(Cat.class);\n" +#~ "crit.add( Restrictions.eq( \"color\", eg.Color.BLACK ) );\n" +#~ "crit.setMaxResults(10);\n" +#~ "List cats = crit.list();]]>" +#~ msgstr "" +#~ "Criteria crit = session.createCriteria(Cat.class);\n" +#~ "crit.add( Expression.eq( \"color\", eg.Color.BLACK ) );\n" +#~ "crit.setMaxResults(10);\n" +#~ "List cats = crit.list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[List cats = session.createSQLQuery(\"SELECT {cat.*} FROM CAT " +#~ "{cat} WHERE ROWNUM<10\")\n" +#~ " .addEntity(\"cat\", Cat.class)\n" +#~ ".list();]]>" +#~ msgstr "" +#~ "List cats = session.createSQLQuery(\n" +#~ " \"SELECT {cat.*} FROM CAT {cat} WHERE ROWNUM<10\",\n" +#~ " \"cat\",\n" +#~ " Cat.class\n" +#~ ").list();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[List cats = session.createSQLQuery(\n" +#~ " \"SELECT {cat}.ID AS {cat.id}, {cat}.SEX AS {cat.sex}, \" +\n" +#~ " \"{cat}.MATE AS {cat.mate}, {cat}.SUBCLASS AS {cat.class}, ... " +#~ "\" +\n" +#~ " \"FROM CAT {cat} WHERE ROWNUM<10\")\n" +#~ " .addEntity(\"cat\", Cat.class)\n" +#~ ".list()]]>" +#~ msgstr "" +#~ "List cats = session.createSQLQuery(\n" +#~ " \"SELECT {cat}.ID AS {cat.id}, {cat}.SEX AS {cat.sex}, \" +\n" +#~ " \"{cat}.MATE AS {cat.mate}, {cat}.SUBCLASS AS {cat.class}, ... " +#~ "\" +\n" +#~ " \"FROM CAT {cat} WHERE ROWNUM<10\",\n" +#~ " \"cat\",\n" +#~ " Cat.class\n" +#~ ").list()" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[DomesticCat cat = (DomesticCat) sess.load( Cat.class, new Long" +#~ "(69) );\n" +#~ "cat.setName(\"PK\");\n" +#~ "sess.flush(); // changes to cat are automatically detected and " +#~ "persisted]]>" +#~ msgstr "" +#~ "DomesticCat cat = (DomesticCat) sess.load( Cat.class, new Long(69) );\n" +#~ "cat.setName(\"PK\");\n" +#~ "sess.flush(); // changes to cat are automatically detected and persisted" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[// in the first session\n" +#~ "Cat cat = (Cat) firstSession.load(Cat.class, catId);\n" +#~ "Cat potentialMate = new Cat();\n" +#~ "firstSession.save(potentialMate);\n" +#~ "\n" +#~ "// in a higher layer of the application\n" +#~ "cat.setMate(potentialMate);\n" +#~ "\n" +#~ "// later, in a new session\n" +#~ "secondSession.update(cat); // update cat\n" +#~ "secondSession.update(mate); // update mate]]>" +#~ msgstr "" +#~ "// in the first session\n" +#~ "Cat cat = (Cat) firstSession.load(Cat.class, catId);\n" +#~ "Cat potentialMate = new Cat();\n" +#~ "firstSession.save(potentialMate);\n" +#~ "\n" +#~ "// in a higher layer of the application\n" +#~ "cat.setMate(potentialMate);\n" +#~ "\n" +#~ "// later, in a new session\n" +#~ "secondSession.update(cat); // update cat\n" +#~ "secondSession.update(mate); // update mate" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[//just reassociate:\n" +#~ "sess.lock(fritz, LockMode.NONE);\n" +#~ "//do a version check, then reassociate:\n" +#~ "sess.lock(izi, LockMode.READ);\n" +#~ "//do a version check, using SELECT ... FOR UPDATE, then reassociate:\n" +#~ "sess.lock(pk, LockMode.UPGRADE);]]>" +#~ msgstr "" +#~ "//just reassociate:\n" +#~ "sess.lock(fritz, LockMode.NONE);\n" +#~ "//do a version check, then reassociate:\n" +#~ "sess.lock(izi, LockMode.READ);\n" +#~ "//do a version check, using SELECT ... FOR UPDATE, then reassociate:\n" +#~ "sess.lock(pk, LockMode.UPGRADE);" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[// in the first session\n" +#~ "Cat cat = (Cat) firstSession.load(Cat.class, catID);\n" +#~ "\n" +#~ "// in a higher tier of the application\n" +#~ "Cat mate = new Cat();\n" +#~ "cat.setMate(mate);\n" +#~ "\n" +#~ "// later, in a new session\n" +#~ "secondSession.saveOrUpdate(cat); // update existing state (cat has a " +#~ "non-null id)\n" +#~ "secondSession.saveOrUpdate(mate); // save the new instance (mate has a " +#~ "null id)]]>" +#~ msgstr "" +#~ "// in the first session\n" +#~ "Cat cat = (Cat) firstSession.load(Cat.class, catID);\n" +#~ "\n" +#~ "// in a higher tier of the application\n" +#~ "Cat mate = new Cat();\n" +#~ "cat.setMate(mate);\n" +#~ "\n" +#~ "// later, in a new session\n" +#~ "secondSession.saveOrUpdate(cat); // update existing state (cat has a " +#~ "non-null id)\n" +#~ "secondSession.saveOrUpdate(mate); // save the new instance (mate has a " +#~ "null id)" + +#, fuzzy +#~ msgid "<![CDATA[sess.delete(cat);]]>" +#~ msgstr "sess.delete(cat);" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[//retrieve a cat from one database\n" +#~ "Session session1 = factory1.openSession();\n" +#~ "Transaction tx1 = session1.beginTransaction();\n" +#~ "Cat cat = session1.get(Cat.class, catId);\n" +#~ "tx1.commit();\n" +#~ "session1.close();\n" +#~ "\n" +#~ "//reconcile with a second database\n" +#~ "Session session2 = factory2.openSession();\n" +#~ "Transaction tx2 = session2.beginTransaction();\n" +#~ "session2.replicate(cat, ReplicationMode.LATEST_VERSION);\n" +#~ "tx2.commit();\n" +#~ "session2.close();]]>" +#~ msgstr "" +#~ "//retrieve a cat from one database\n" +#~ "Session session1 = factory1.openSession();\n" +#~ "Transaction tx1 = session1.beginTransaction();\n" +#~ "Cat cat = session1.get(Cat.class, catId);\n" +#~ "tx1.commit();\n" +#~ "session1.close();\n" +#~ "\n" +#~ "//reconcile with a second database\n" +#~ "Session session2 = factory2.openSession();\n" +#~ "Transaction tx2 = session2.beginTransaction();\n" +#~ "session2.replicate(cat, ReplicationMode.LATEST_VERSION);\n" +#~ "tx2.commit();\n" +#~ "session2.close();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[sess = sf.openSession();\n" +#~ "Transaction tx = sess.beginTransaction();\n" +#~ "sess.setFlushMode(FlushMode.COMMIT); // allow queries to return stale " +#~ "state\n" +#~ "\n" +#~ "Cat izi = (Cat) sess.load(Cat.class, id);\n" +#~ "izi.setName(iznizi);\n" +#~ "\n" +#~ "// might return stale data\n" +#~ "sess.find(\"from Cat as cat left outer join cat.kittens kitten\");\n" +#~ "\n" +#~ "// change to izi is not flushed!\n" +#~ "...\n" +#~ "tx.commit(); // flush occurs\n" +#~ "sess.close();]]>" +#~ msgstr "" +#~ "sess = sf.openSession();\n" +#~ "Transaction tx = sess.beginTransaction();\n" +#~ "sess.setFlushMode(FlushMode.COMMIT); // allow queries to return stale " +#~ "state\n" +#~ "\n" +#~ "Cat izi = (Cat) sess.load(Cat.class, id);\n" +#~ "izi.setName(iznizi);\n" +#~ "\n" +#~ "// might return stale data\n" +#~ "sess.find(\"from Cat as cat left outer join cat.kittens kitten\");\n" +#~ "\n" +#~ "// change to izi is not flushed!\n" +#~ "...\n" +#~ "tx.commit(); // flush occurs\n" +#~ "sess.close();" + +#, fuzzy +#~ msgid "<![CDATA[<one-to-one name=\"person\" cascade=\"persist\"/>]]>" +#~ msgstr "<one-to-one name=\"person\" cascade=\"persist\"/>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<one-to-one name=\"person\" cascade=\"persist,delete,lock\"/>]]>" +#~ msgstr "<one-to-one name=\"person\" cascade=\"persist,delete,lock\"/>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Cat fritz = ......;\n" +#~ "ClassMetadata catMeta = sessionfactory.getClassMetadata(Cat.class);\n" +#~ "\n" +#~ "Object[] propertyValues = catMeta.getPropertyValues(fritz);\n" +#~ "String[] propertyNames = catMeta.getPropertyNames();\n" +#~ "Type[] propertyTypes = catMeta.getPropertyTypes();\n" +#~ "\n" +#~ "// get a Map of all properties which are not collections or associations\n" +#~ "Map namedValues = new HashMap();\n" +#~ "for ( int i=0; i<propertyNames.length; i++ ) {\n" +#~ " if ( !propertyTypes[i].isEntityType() && !propertyTypes[i]." +#~ "isCollectionType() ) {\n" +#~ " namedValues.put( propertyNames[i], propertyValues[i] );\n" +#~ " }\n" +#~ "}]]>" +#~ msgstr "" +#~ "Cat fritz = ......;\n" +#~ "ClassMetadata catMeta = sessionfactory.getClassMetadata(Cat.class);\n" +#~ "\n" +#~ "Object[] propertyValues = catMeta.getPropertyValues(fritz);\n" +#~ "String[] propertyNames = catMeta.getPropertyNames();\n" +#~ "Type[] propertyTypes = catMeta.getPropertyTypes();\n" +#~ "\n" +#~ "// get a Map of all properties which are not collections or associations\n" +#~ "Map namedValues = new HashMap();\n" +#~ "for ( int i=0; i<propertyNames.length; i++ ) {\n" +#~ " if ( !propertyTypes[i].isEntityType() && !propertyTypes[i]." +#~ "isCollectionType() ) {\n" +#~ " namedValues.put( propertyNames[i], propertyValues[i] );\n" +#~ " }\n" +#~ "}" Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/toolset_guide.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/toolset_guide.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/toolset_guide.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,1454 @@ +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# Language /mnt/hgfs/base/Hibernate/Reference translations for PACKAGE package. +# Copyright (C) 2006, 2007 Free Software Foundation, Inc. +# Automatically generated, 2006. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# +msgid "" +msgstr "" +"Project-Id-Version: Collection_Mapping\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2010-01-08T04:07:20\n" +"PO-Revision-Date: 2007-02-26 10:27+1000\n" +"Last-Translator: \n" +"Language-Team: <de(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.9.1\n" + +#. Tag: title +#, no-c-format +msgid "Toolset Guide" +msgstr "Toolset-Handbuch" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Roundtrip engineering with Hibernate is possible using a set of Eclipse " +"plugins, commandline tools, and Ant tasks." +msgstr "" +"\"Roundtrip Engineering\" mit Hibernate ist mit einem Satz von Eclipse-" +"Plugins, Befehlszeilen-Tools sowie Ant-Aufgaben möglich." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis>Hibernate Tools</emphasis> currently include plugins for the " +"Eclipse IDE as well as Ant tasks for reverse engineering of existing " +"databases:" +msgstr "" +"Die <emphasis>Hibernate Tools</emphasis> beinhalten gegenwärtig Plug-ins für " +"die Eclipse-IDE sowie Ant-Aufgaben für invertiertes Engineering bestehender " +"Datenbanken:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis>Mapping Editor:</emphasis> an editor for Hibernate XML mapping " +"files that supports auto-completion and syntax highlighting. It also " +"supports semantic auto-completion for class names and property/field names, " +"making it more versatile than a normal XML editor." +msgstr "" +"<emphasis>Mapping-Editor:</emphasis> Ein Editor für Hibernate XML-Mapping-" +"Dateien, der Auto-Vervollständigung und Syntax-Markierung unterstützt. Er " +"unterstützt außerdem semantische Auto-Vervollständigung für Klassennamen und " +"Property-/Feldnamen, wodurch er vielseitiger als ein regulärer XML-Editor " +"ist." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis>Console:</emphasis> the console is a new view in Eclipse. In " +"addition to a tree overview of your console configurations, you are also " +"provided with an interactive view of your persistent classes and their " +"relationships. The console allows you to execute HQL queries against your " +"database and browse the result directly in Eclipse." +msgstr "" +"<emphasis>Console:</emphasis> Die Konsole ist eine neue Ansicht in Eclipse. " +"Außer einer Baumansicht Ihrer Konsolenkonfiguration können Sie auch eine " +"interaktive Ansicht Ihrer persistenten Klassen sowie deren Beziehungen " +"erhalten. Die Konsole ermöglicht es Ihnen, HQL-Anfragen an Ihrer Datenbank " +"zu stellen und die Ergebnisse direkt in Eclipse zu durchsuchen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis>Development Wizards:</emphasis> several wizards are provided with " +"the Hibernate Eclipse tools. You can use a wizard to quickly generate " +"Hibernate configuration (cfg.xml) files, or to reverse engineer an existing " +"database schema into POJO source files and Hibernate mapping files. The " +"reverse engineering wizard supports customizable templates." +msgstr "" +"<emphasis>Development Wizards:</emphasis> Unter den Hibernate Eclipse Tools " +"finden Sie auch mehrere Entwicklungs-Wizards. Sie können einen Wizard zur " +"schnellen Generierung von Hibernate Konfigurationsdateien (cfg.xml) oder " +"sogar zur vollständigen Invertierung eines bestehenden Datenbankschemas in " +"POJO Quelldateien und Hibernate Mapping-Dateien verwenden. Der \"Reverse " +"Engineering\"-Wizard unterstützt anwenderdefinierte Templates." + +#. Tag: para +#, no-c-format +msgid "" +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Please refer to the <emphasis>Hibernate Tools</emphasis> package " +"documentation for more information." +msgstr "" +"Bitte entnehmen Sie dem Paket <emphasis>Hibernate Tools</emphasis> und der " +"zugehörigen Dokumentation weitere Informationen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"However, the Hibernate main package comes bundled with an integrated tool : " +"<emphasis>SchemaExport</emphasis> aka <literal>hbm2ddl</literal>.It can even " +"be used from \"inside\" Hibernate." +msgstr "" +"Das Hibernate Hauptpaket kommt jedoch gebündelt mit einem integrierten Tool " +"(es kann sogar direkt von \"innerhalb\" Hibernate aus verwendet werden): " +"<emphasis>SchemaExport</emphasis> auch bekannt als <literal>hbm2ddl</" +"literal>." + +#. Tag: title +#, no-c-format +msgid "Automatic schema generation" +msgstr "Automatische Schema-Generierung" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"DDL can be generated from your mapping files by a Hibernate utility. The " +"generated schema includes referential integrity constraints, primary and " +"foreign keys, for entity and collection tables. Tables and sequences are " +"also created for mapped identifier generators." +msgstr "" +"DDL kann mittels eines Hibernate Dienstprogramms aus Ihren Mapping-Dateien " +"generiert werden. Das generierte Schema beinhaltet referentielle " +"Integritätsbedingungen (Primär- und Fremdschlüssel) für Entity- und " +"Collection-Tabellen. Tabellen und Reihungen (Sequenzen) werden auch für " +"gemappte Bezeichnergeneratoren erstellt." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You <emphasis>must</emphasis> specify a SQL <literal>Dialect</literal> via " +"the <literal>hibernate.dialect</literal> property when using this tool, as " +"DDL is highly vendor-specific." +msgstr "" +"Sie <emphasis>müssen</emphasis> einen SQL-<literal>Dialect</literal> mittels " +"der <literal>hibernate.dialect</literal>-Property bestimmen, wenn Sie dieses " +"Tool verwenden, da DDL sehr anbieterspezifisch ist." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"First, you must customize your mapping files to improve the generated " +"schema. The next section covers schema customization." +msgstr "" +"Zunächst passen Sie Ihre Mapping-Dateien an, um das generierte Schema zu " +"verbessern." + +#. Tag: title +#, no-c-format +msgid "Customizing the schema" +msgstr "Anpassung des Schemas" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Many Hibernate mapping elements define optional attributes named " +"<literal>length</literal>, <literal>precision</literal> and <literal>scale</" +"literal>. You can set the length, precision and scale of a column with this " +"attribute." +msgstr "" +"Zahlreiche Hibernate Mapping-Elemente definieren optionale Attribute mit " +"Namen <literal>length</literal>, <literal>precision</literal> und " +"<literal>scale</literal>. Mit diesem Atrribut können Sie Länge, Genauigkeit " +"und Skalierung einer Reihe einstellen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Some tags also accept a <literal>not-null</literal> attribute for generating " +"a <literal>NOT NULL</literal> constraint on table columns, and a " +"<literal>unique</literal> attribute for generating <literal>UNIQUE</literal> " +"constraint on table columns." +msgstr "" +"Einige Tags akzeptieren auch ein <literal>not-null</literal>-Attribut (für " +"die Generierung einer <literal>NOT NULL</literal>-Bedingung an " +"Tabellenspalten) sowie ein <literal>unique</literal>-Attribut (für die " +"Generierung einer <literal>UNIQUE</literal>-Bedingung an Tabellenspalten)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A <literal>unique-key</literal> attribute can be used to group columns in a " +"single, unique key constraint. Currently, the specified value of the " +"<literal>unique-key</literal> attribute is <emphasis>not</emphasis> used to " +"name the constraint in the generated DDL. It is only used to group the " +"columns in the mapping file." +msgstr "" +"Ein <literal>unique-key</literal>-Attribut kann ebenfalls benutzt werden, um " +"Spalten in einer Bedingung mit einem einzelnen eindeutigen Kennbegriff zu " +"gruppieren. Zur Zeit wird der spezifizierte Wert des <literal>unique-key</" +"literal>-Attributs nicht <emphasis>nicht</emphasis> benutzt, um die " +"Bedingung in der generierten DDL zu benutzen, sondern nur, um die Spalten in " +"der Mapping-Datei zu gruppieren." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"An <literal>index</literal> attribute specifies the name of an index that " +"will be created using the mapped column or columns. Multiple columns can be " +"grouped into the same index by simply specifying the same index name." +msgstr "" +"Ein <literal>index</literal>-Attribut legt den Namen eines Index fest, der " +"unter Verwendung der gemappten Spalte(n) erstellt wird. Mehrere Spalten " +"können in denselben Index gruppiert werden, indem einfach derselbe Indexname " +"festgelegt wird." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A <literal>foreign-key</literal> attribute can be used to override the name " +"of any generated foreign key constraint." +msgstr "" +"Ein <literal>foreign-key</literal>-Attribut kann verwendet werden, um den " +"Namen einer generierten Bedingung des Fremdschlüssels außer Kraft zu setzen." + +#. Tag: para +#, no-c-format +msgid "" +"Many mapping elements also accept a child <literal><column></literal> " +"element. This is particularly useful for mapping multi-column types:" +msgstr "" +"Zahlreiche Mapping-Elemente akzeptieren auch ein untergeordnetes " +"<literal><column></literal>-Element. Das ist insbesondere für das " +"Mappen von vielspaltigen Typen hilfreich:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>default</literal> attribute allows you to specify a default " +"value for a column.You should assign the same value to the mapped property " +"before saving a new instance of the mapped class." +msgstr "" +"Mit dem <literal>default</literal>-Attribut können Sie einen Standardwert " +"für eine Spalte festlegen (Sie sollten denselben Wert einer gemappten " +"Property zuordnen, ehe Sie eine neue Instanz der gemappten Klasse speichern)." + +#. Tag: para +#, no-c-format +msgid "" +"The <literal>sql-type</literal> attribute allows the user to override the " +"default mapping of a Hibernate type to SQL datatype." +msgstr "" +"Das <literal>sql-type</literal>-Attribut ermöglicht die Außerkraftsetzung " +"des Standard-Mappings eines Hibernate-Typs zum SQL-Datentyp." + +#. Tag: para +#, no-c-format +msgid "" +"The <literal>check</literal> attribute allows you to specify a check " +"constraint." +msgstr "" +"Das <literal>check</literal>-Attribut ermöglicht es Ihnen, eine " +"Prüfungsbedingung festzulegen." + +#. Tag: para +#, no-c-format +msgid "The following table summarizes these optional attributes." +msgstr "" + +#. Tag: title +#, no-c-format +msgid "Summary" +msgstr "Zusammenfassung" + +#. Tag: para +#, no-c-format +msgid "Attribute" +msgstr "Attribut" + +#. Tag: para +#, no-c-format +msgid "Values" +msgstr "Werte" + +#. Tag: para +#, no-c-format +msgid "Interpretation" +msgstr "Bedeutung" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>length</literal>" +msgstr "wählen Sie eine <literal>NamingStrategy</literal>" + +#. Tag: para +#, no-c-format +msgid "number" +msgstr "Zahl" + +#. Tag: para +#, no-c-format +msgid "column length" +msgstr "Spaltenlänge" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>precision</literal>" +msgstr "in <literal>hibernate.properties</literal>" + +#. Tag: para +#, no-c-format +msgid "column decimal precision" +msgstr "Dezimale Genauigkeit der Spalte" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>scale</literal>" +msgstr "wählen Sie eine <literal>NamingStrategy</literal>" + +#. Tag: para +#, no-c-format +msgid "column decimal scale" +msgstr "Dezimale Skalierung der Spalte" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>not-null</literal>" +msgstr "in <literal>hibernate.properties</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>true|false</literal>" +msgstr "wählen Sie eine <literal>NamingStrategy</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "specifies that the column should be non-nullable" +msgstr "legt fest, dass die Spalte nicht-nullbar sein soll" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>unique</literal>" +msgstr "in <literal>hibernate.properties</literal>" + +#. Tag: para +#, no-c-format +msgid "specifies that the column should have a unique constraint" +msgstr "bestimmt, dass die Spalte eine eindeutige Bedingung besitzt" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>index</literal>" +msgstr "wählen Sie eine <literal>NamingStrategy</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>index_name</literal>" +msgstr "in <literal>hibernate.properties</literal>" + +#. Tag: para +#, no-c-format +msgid "specifies the name of a (multi-column) index" +msgstr "bestimmt den Namen eines (mehrspaltigen) Index" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>unique-key</literal>" +msgstr "wählen Sie eine <literal>NamingStrategy</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>unique_key_name</literal>" +msgstr "in <literal>hibernate.properties</literal>" + +#. Tag: para +#, no-c-format +msgid "specifies the name of a multi-column unique constraint" +msgstr "bestimmt den Namen einer mehrspaltigen, eindeutigen Bedingung" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>foreign-key</literal>" +msgstr "wählen Sie eine <literal>NamingStrategy</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>foreign_key_name</literal>" +msgstr "foreign_key_name" + +#. Tag: para +#, no-c-format +msgid "" +"specifies the name of the foreign key constraint generated for an " +"association, for a <literal><one-to-one></literal>, <literal><many-" +"to-one></literal>, <literal><key></literal>, or <literal><many-" +"to-many></literal> mapping element. Note that <literal>inverse=\"true\"</" +"literal> sides will not be considered by <literal>SchemaExport</literal>." +msgstr "" +"legt den Namen einer Bedingung des Fremdschlüssels fest, der für eine " +"Assoziation generiert wurde für ein <literal><one-to-one></literal>, " +"<literal><many-to-one></literal>, <literal><key></literal> oder " +"<literal><many-to-many></literal>-Mapping-Element. Bitte beachten Sie, " +"dass <literal>inverse=\"true\"</literal>-Seiten beim <literal>SchemaExport</" +"literal> nicht berücksichtigt werden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>sql-type</literal>" +msgstr "in <literal>hibernate.properties</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>SQL column type</literal>" +msgstr "SQL-Spaltentyp" + +#. Tag: para +#, no-c-format +msgid "" +"overrides the default column type (attribute of <literal><column></" +"literal> element only)" +msgstr "" +"setzt den Standard-Spaltentyp außer Kraft (nur Attribut von <literal><" +"column></literal>-Element)" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>default</literal>" +msgstr "in <literal>hibernate.properties</literal>" + +#. Tag: para +#, no-c-format +msgid "SQL expression" +msgstr "SQL-Ausdruck" + +#. Tag: para +#, no-c-format +msgid "specify a default value for the column" +msgstr "bestimmt einen Standardwert für die Spalte" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>check</literal>" +msgstr "in <literal>hibernate.properties</literal>" + +#. Tag: para +#, no-c-format +msgid "create an SQL check constraint on either column or table" +msgstr "" +"erstellt eine SQL-Überprüfungsbedingung an entweder der Spalte oder der " +"Tabelle" + +#. Tag: para +#, no-c-format +msgid "" +"The <literal><comment></literal> element allows you to specify " +"comments for the generated schema." +msgstr "" +"Das <literal><comment></literal>-Element erlaubt die Bestimmung von " +"Kommentaren für das generierte Schema." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This results in a <literal>comment on table</literal> or <literal>comment on " +"column</literal> statement in the generated DDL where supported." +msgstr "" +"Dies führt zu einer <literal>comment on table</literal> oder " +"<literal>comment on column</literal>-Anweisung in der generierten DDL (wenn " +"unterstützt)." + +#. Tag: title +#, no-c-format +msgid "Running the tool" +msgstr "Start des Tools" + +#. Tag: para +#, no-c-format +msgid "" +"The <literal>SchemaExport</literal> tool writes a DDL script to standard out " +"and/or executes the DDL statements." +msgstr "" +"Das <literal>SchemaExport</literal>-Tool schreibt ein DDL-Skript um DDL-" +"Anweisungen zu standardisieren und/oder auszuführen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The following table displays the <literal>SchemaExport</literal> command " +"line options" +msgstr "<literal>SchemaExport</literal>-Befehlszeilenoptionen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>java -cp </literal><emphasis>hibernate_classpaths</emphasis> " +"<literal>org.hibernate.tool.hbm2ddl.SchemaExport</literal> <emphasis>options " +"mapping_files</emphasis>" +msgstr "" +"<literal>java -cp </literal><emphasis>hibernate_classpaths</" +"emphasis><literal>org.hibernate.tool.hbm2ddl.SchemaExport</" +"literal><emphasis>options mapping_files</emphasis>" + +#. Tag: title +#, no-c-format +msgid "<literal>SchemaExport</literal> Command Line Options" +msgstr "<literal>SchemaExport</literal>-Befehlszeilenoptionen" + +#. Tag: para +#, no-c-format +msgid "Option" +msgstr "Option" + +#. Tag: para +#, no-c-format +msgid "Description" +msgstr "Beschreibung" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>--quiet</literal>" +msgstr "in <literal>hibernate.properties</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "do not output the script to stdout" +msgstr "Skript nicht an stdout ausgeben" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>--drop</literal>" +msgstr "in <literal>hibernate.properties</literal>" + +#. Tag: para +#, no-c-format +msgid "only drop the tables" +msgstr "nur Tabellen droppen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>--create</literal>" +msgstr "wählen Sie eine <literal>NamingStrategy</literal>" + +#. Tag: para +#, no-c-format +msgid "only create the tables" +msgstr "nur Tabellen erstellen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>--text</literal>" +msgstr "in <literal>hibernate.properties</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "do not export to the database" +msgstr "nicht in die Datenbank exportieren" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>--output=my_schema.ddl</literal>" +msgstr "--output=my_schema.ddl" + +#. Tag: para +#, no-c-format +msgid "output the ddl script to a file" +msgstr "ddl-Skript an eine Datei ausgeben" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>--naming=eg.MyNamingStrategy</literal>" +msgstr "--naming=eg.MyNamingStrategy" + +#. Tag: para +#, no-c-format +msgid "select a <literal>NamingStrategy</literal>" +msgstr "wählen Sie eine <literal>NamingStrategy</literal>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>--config=hibernate.cfg.xml</literal>" +msgstr "--config=hibernate.cfg.xml" + +#. Tag: para +#, no-c-format +msgid "read Hibernate configuration from an XML file" +msgstr "Hibernate Konfiguration aus einer XML-Datei lesen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>--properties=hibernate.properties</literal>" +msgstr "in <literal>hibernate.properties</literal>" + +#. Tag: para +#, no-c-format +msgid "read database properties from a file" +msgstr "Datenbank-Properties aus einer Datei lesen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>--format</literal>" +msgstr "wählen Sie eine <literal>NamingStrategy</literal>" + +#. Tag: para +#, no-c-format +msgid "format the generated SQL nicely in the script" +msgstr "generierte SQL sauber im Skript formatieren" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>--delimiter=;</literal>" +msgstr "wählen Sie eine <literal>NamingStrategy</literal>" + +#. Tag: para +#, no-c-format +msgid "set an end of line delimiter for the script" +msgstr "einen Delimiter für das Zeilenende des Skripts setzen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "You can even embed <literal>SchemaExport</literal> in your application:" +msgstr "" +"Sie können sogar <literal>SchemaExport</literal> in Ihre Anwendung einbetten:" + +#. Tag: title +#, no-c-format +msgid "Properties" +msgstr "Properties" + +#. Tag: para +#, fuzzy, no-c-format +msgid "Database properties can be specified:" +msgstr "Datenbank-Properties können bestimmt werden" + +#. Tag: para +#, no-c-format +msgid "" +"as system properties with <literal>-D</literal><emphasis><property></" +"emphasis>" +msgstr "" +"wie System-Properties mit <literal>-D</literal><emphasis><property></" +"emphasis>" + +#. Tag: para +#, no-c-format +msgid "in <literal>hibernate.properties</literal>" +msgstr "in <literal>hibernate.properties</literal>" + +#. Tag: para +#, no-c-format +msgid "in a named properties file with <literal>--properties</literal>" +msgstr "" +"in einer benannten Properties-Datei mit <literal>--properties</literal>" + +#. Tag: para +#, no-c-format +msgid "The needed properties are:" +msgstr "Die benötigten Properties sind:" + +#. Tag: title +#, no-c-format +msgid "SchemaExport Connection Properties" +msgstr "SchemaExport-Connection-Properties" + +#. Tag: para +#, no-c-format +msgid "Property Name" +msgstr "Property-Name" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>hibernate.connection.driver_class</literal>" +msgstr "hibernate.connection.driver_class" + +#. Tag: para +#, no-c-format +msgid "jdbc driver class" +msgstr "jdbc-Treiberklasse" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>hibernate.connection.url</literal>" +msgstr "in <literal>hibernate.properties</literal>" + +#. Tag: para +#, no-c-format +msgid "jdbc url" +msgstr "jdbc url" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>hibernate.connection.username</literal>" +msgstr "in <literal>hibernate.properties</literal>" + +#. Tag: para +#, no-c-format +msgid "database user" +msgstr "Datenbankbenutzer" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>hibernate.connection.password</literal>" +msgstr "in <literal>hibernate.properties</literal>" + +#. Tag: para +#, no-c-format +msgid "user password" +msgstr "Benutzer-Passwort" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>hibernate.dialect</literal>" +msgstr "in <literal>hibernate.properties</literal>" + +#. Tag: para +#, no-c-format +msgid "dialect" +msgstr "Dialekt" + +#. Tag: title +#, no-c-format +msgid "Using Ant" +msgstr "Die Verwendung von Ant" + +#. Tag: para +#, no-c-format +msgid "" +"You can call <literal>SchemaExport</literal> from your Ant build script:" +msgstr "" +"Sie können <literal>SchemaExport</literal> vom Ihrem Ant-Build-Skript " +"aufrufen:" + +#. Tag: title +#, no-c-format +msgid "Incremental schema updates" +msgstr "Inkrementelle Schema-Aktualisierungen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>SchemaUpdate</literal> tool will update an existing schema with " +"\"incremental\" changes. The <literal>SchemaUpdate</literal> depends upon " +"the JDBC metadata API and, as such, will not work with all JDBC drivers." +msgstr "" +"Das <literal>SchemaUpdate</literal>-Tool aktualisiert ein bestehendes Schema " +"mit \"inkrementellen\" Änderungen. Bitte beachten Sie, das " +"<literal>SchemaUpdate</literal> sehr vom JDBC-Metadaten-API abhängt und " +"daher nicht mit allen JDBC-Treibern funktioniert." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>java -cp </literal><emphasis>hibernate_classpaths</emphasis> " +"<literal>org.hibernate.tool.hbm2ddl.SchemaUpdate</literal> <emphasis>options " +"mapping_files</emphasis>" +msgstr "" +"<literal>java -cp </literal><emphasis>hibernate_classpaths</" +"emphasis><literal>org.hibernate.tool.hbm2ddl.SchemaUpdate</" +"literal><emphasis>options mapping_files</emphasis>" + +#. Tag: title +#, no-c-format +msgid "<literal>SchemaUpdate</literal> Command Line Options" +msgstr "<literal>SchemaUpdate</literal>-Befehlszeilenoptionen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "do not export the script to the database" +msgstr "Skript nicht in die Datenbank exportieren" + +#. Tag: para +#, no-c-format +msgid "specify a <literal>.cfg.xml</literal> file" +msgstr "eine <literal>.cfg.xml</literal>-Datei bestimmen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "You can embed <literal>SchemaUpdate</literal> in your application:" +msgstr "" +"Sie können <literal>SchemaUpdate</literal> in Ihre Anwendung einbetten:" + +#. Tag: title +#, no-c-format +msgid "Using Ant for incremental schema updates" +msgstr "Die Verwendung von Ant bei inkrementellen Schema-Aktualisierungen" + +#. Tag: para +#, no-c-format +msgid "You can call <literal>SchemaUpdate</literal> from the Ant script:" +msgstr "Sie können <literal>SchemaUpdate</literal> vom Ant-Skript aufrufen:" + +#. Tag: title +#, no-c-format +msgid "Schema validation" +msgstr "Schema-Validierung" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>SchemaValidator</literal> tool will validate that the existing " +"database schema \"matches\" your mapping documents. The " +"<literal>SchemaValidator</literal> depends heavily upon the JDBC metadata " +"API and, as such, will not work with all JDBC drivers. This tool is " +"extremely useful for testing." +msgstr "" +"Das <literal>SchemaValidator</literal>-Tool validiert, ob das bestehende " +"Datenbankschema zu Ihren Mapping-Dokumenten \"passt\". Beachten Sie, dass " +"<literal>SchemaValidator</literal> sehr vom JDBC-Metadata-API abhängt und " +"daher nicht mit allen JDBC-Treibern funktioniert. Dieses Tool ist beim " +"Testen von großem Nutzen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>java -cp </literal><emphasis>hibernate_classpaths</emphasis> " +"<literal>org.hibernate.tool.hbm2ddl.SchemaValidator</literal> " +"<emphasis>options mapping_files</emphasis>" +msgstr "" +"<literal>java -cp </literal><emphasis>hibernate_classpaths</" +"emphasis><literal>org.hibernate.tool.hbm2ddl.SchemaValidator</" +"literal><emphasis>options mapping_files</emphasis>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The following table displays the <literal>SchemaValidator</literal> command " +"line options:" +msgstr "<literal>SchemaValidator</literal>-Befehlszeilenoptionen" + +#. Tag: title +#, no-c-format +msgid "<literal>SchemaValidator</literal> Command Line Options" +msgstr "<literal>SchemaValidator</literal>-Befehlszeilenoptionen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "You can embed <literal>SchemaValidator</literal> in your application:" +msgstr "" +"Sie können den <literal>SchemaValidator</literal> in Ihre Anwendung " +"einbetten:" + +#. Tag: title +#, no-c-format +msgid "Using Ant for schema validation" +msgstr "Die Verwendung von Ant zur Schema-Validierung" + +#. Tag: para +#, no-c-format +msgid "You can call <literal>SchemaValidator</literal> from the Ant script:" +msgstr "" +"Sie können <literal>SchemaValidator</literal> vom Ant-Skript aus aufrufen:" + +#, fuzzy +#~ msgid "<![CDATA[<property name=\"zip\" length=\"5\"/>]]>" +#~ msgstr "<property name=\"zip\" length=\"5\"/>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<property name=\"balance\" precision=\"12\" scale=\"2\"/>]]>" +#~ msgstr "<property name=\"balance\" precision=\"12\" scale=\"2\"/>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<many-to-one name=\"bar\" column=\"barId\" not-null=\"true\"/>]]>" +#~ msgstr "" +#~ "<many-to-one name=\"bar\" column=\"barId\" not-null=\"true\"/>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<element column=\"serialNumber\" type=\"long\" not-null=\"true\" " +#~ "unique=\"true\"/>]]>" +#~ msgstr "" +#~ "<element column=\"serialNumber\" type=\"long\" not-null=\"true\" " +#~ "unique=\"true\"/>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<many-to-one name=\"org\" column=\"orgId\" unique-key=" +#~ "\"OrgEmployeeId\"/>\n" +#~ "<property name=\"employeeId\" unique-key=\"OrgEmployee\"/>]]>" +#~ msgstr "" +#~ "<many-to-one name=\"org\" column=\"orgId\" unique-key=\"OrgEmployeeId" +#~ "\"/>\n" +#~ "<property name=\"employeeId\" unique-key=\"OrgEmployee\"/>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<property name=\"lastName\" index=\"CustName\"/>\n" +#~ "<property name=\"firstName\" index=\"CustName\"/>]]>" +#~ msgstr "" +#~ "<property name=\"lastName\" index=\"CustName\"/>\n" +#~ "<property name=\"firstName\" index=\"CustName\"/>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<many-to-one name=\"bar\" column=\"barId\" foreign-key=\"FKFooBar" +#~ "\"/>]]>" +#~ msgstr "" +#~ "<many-to-one name=\"bar\" column=\"barId\" foreign-key=\"FKFooBar\"/" +#~ ">" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<property name=\"name\" type=\"my.customtypes.Name\"/>\n" +#~ " <column name=\"last\" not-null=\"true\" index=\"bar_idx\" length=\"30" +#~ "\"/>\n" +#~ " <column name=\"first\" not-null=\"true\" index=\"bar_idx\" length=\"20" +#~ "\"/>\n" +#~ " <column name=\"initial\"/>\n" +#~ "</property>]]>" +#~ msgstr "" +#~ "<property name=\"name\" type=\"my.customtypes.Name\"/>\n" +#~ " <column name=\"last\" not-null=\"true\" index=\"bar_idx\" length=" +#~ "\"30\"/>\n" +#~ " <column name=\"first\" not-null=\"true\" index=\"bar_idx\" length=" +#~ "\"20\"/>\n" +#~ " <column name=\"initial\"/>\n" +#~ "</property>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<property name=\"credits\" type=\"integer\" insert=\"false\">\n" +#~ " <column name=\"credits\" default=\"10\"/>\n" +#~ "</property>]]>" +#~ msgstr "" +#~ "<property name=\"credits\" type=\"integer\" insert=\"false\">\n" +#~ " <column name=\"credits\" default=\"10\"/>\n" +#~ "</property>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<version name=\"version\" type=\"integer\" insert=\"false\">\n" +#~ " <column name=\"version\" default=\"0\"/>\n" +#~ "</property>]]>" +#~ msgstr "" +#~ "<version name=\"version\" type=\"integer\" insert=\"false\">\n" +#~ " <column name=\"version\" default=\"0\"/>\n" +#~ "</property>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<property name=\"balance\" type=\"float\">\n" +#~ " <column name=\"balance\" sql-type=\"decimal(13,3)\"/>\n" +#~ "</property>]]>" +#~ msgstr "" +#~ "<property name=\"balance\" type=\"float\">\n" +#~ " <column name=\"balance\" sql-type=\"decimal(13,3)\"/>\n" +#~ "</property>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<property name=\"foo\" type=\"integer\">\n" +#~ " <column name=\"foo\" check=\"foo > 10\"/>\n" +#~ "</property>]]>" +#~ msgstr "" +#~ "<property name=\"foo\" type=\"integer\">\n" +#~ " <column name=\"foo\" check=\"foo > 10\"/>\n" +#~ "</property>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Foo\" table=\"foos\" check=\"bar < 100.0\">\n" +#~ " ...\n" +#~ " <property name=\"bar\" type=\"float\"/>\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Foo\" table=\"foos\" check=\"bar < 100.0\">\n" +#~ " ...\n" +#~ " <property name=\"bar\" type=\"float\"/>\n" +#~ "</class>" + +#~ msgid "length" +#~ msgstr "length" + +#~ msgid "precision" +#~ msgstr "precision" + +#~ msgid "scale" +#~ msgstr "scale" + +#~ msgid "not-null" +#~ msgstr "not-null" + +#~ msgid "true|false" +#~ msgstr "true|false" + +#~ msgid "unique" +#~ msgstr "eindeutig" + +#~ msgid "index" +#~ msgstr "index" + +#~ msgid "index_name" +#~ msgstr "index_name" + +#~ msgid "unique-key" +#~ msgstr "unique-key" + +#~ msgid "unique_key_name" +#~ msgstr "unique_key_name" + +#~ msgid "foreign-key" +#~ msgstr "foreign-key" + +#~ msgid "sql-type" +#~ msgstr "sql-type" + +#~ msgid "default" +#~ msgstr "default" + +#~ msgid "check" +#~ msgstr "check" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Customer\" table=\"CurCust\">\n" +#~ " <comment>Current customers only</comment>\n" +#~ " ...\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Customer\" table=\"CurCust\">\n" +#~ " <comment>Current customers only</comment>\n" +#~ " ...\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<property name=\"balance\">\n" +#~ " <column name=\"bal\">\n" +#~ " <comment>Balance in USD</comment>\n" +#~ " </column>\n" +#~ "</property>]]>" +#~ msgstr "" +#~ "<property name=\"balance\">\n" +#~ " <column name=\"bal\">\n" +#~ " <comment>Balance in USD</comment>\n" +#~ " </column>\n" +#~ "</property>" + +#~ msgid "--quiet" +#~ msgstr "--quiet" + +#~ msgid "--drop" +#~ msgstr "--drop" + +#~ msgid "--create" +#~ msgstr "--create" + +#~ msgid "--text" +#~ msgstr "--text" + +#~ msgid "--properties=hibernate.properties" +#~ msgstr "--properties=hibernate.properties" + +#~ msgid "--format" +#~ msgstr "--format" + +#~ msgid "--delimiter=;" +#~ msgstr "--delimiter=;" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Configuration cfg = ....;\n" +#~ "new SchemaExport(cfg).create(false, true);]]>" +#~ msgstr "" +#~ "Configuration cfg = ....;\n" +#~ "new SchemaExport(cfg).create(false, true);" + +#~ msgid "hibernate.connection.url" +#~ msgstr "hibernate.connection.url" + +#~ msgid "hibernate.connection.username" +#~ msgstr "hibernate.connection.username" + +#~ msgid "hibernate.connection.password" +#~ msgstr "hibernate.connection.password" + +#~ msgid "hibernate.dialect" +#~ msgstr "hibernate.dialect" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<target name=\"schemaexport\">\n" +#~ " <taskdef name=\"schemaexport\"\n" +#~ " classname=\"org.hibernate.tool.hbm2ddl.SchemaExportTask\"\n" +#~ " classpathref=\"class.path\"/>\n" +#~ " \n" +#~ " <schemaexport\n" +#~ " properties=\"hibernate.properties\"\n" +#~ " quiet=\"no\"\n" +#~ " text=\"no\"\n" +#~ " drop=\"no\"\n" +#~ " delimiter=\";\"\n" +#~ " output=\"schema-export.sql\">\n" +#~ " <fileset dir=\"src\">\n" +#~ " <include name=\"**/*.hbm.xml\"/>\n" +#~ " </fileset>\n" +#~ " </schemaexport>\n" +#~ "</target>]]>" +#~ msgstr "" +#~ "<target name=\"schemaexport\">\n" +#~ " <taskdef name=\"schemaexport\"\n" +#~ " classname=\"org.hibernate.tool.hbm2ddl.SchemaExportTask\"\n" +#~ " classpathref=\"class.path\"/>\n" +#~ " \n" +#~ " <schemaexport\n" +#~ " properties=\"hibernate.properties\"\n" +#~ " quiet=\"no\"\n" +#~ " text=\"no\"\n" +#~ " drop=\"no\"\n" +#~ " delimiter=\";\"\n" +#~ " output=\"schema-export.sql\">\n" +#~ " <fileset dir=\"src\">\n" +#~ " <include name=\"**/*.hbm.xml\"/>\n" +#~ " </fileset>\n" +#~ " </schemaexport>\n" +#~ "</target>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Configuration cfg = ....;\n" +#~ "new SchemaUpdate(cfg).execute(false);]]>" +#~ msgstr "" +#~ "Configuration cfg = ....;\n" +#~ "new SchemaUpdate(cfg).execute(false);" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<target name=\"schemaupdate\">\n" +#~ " <taskdef name=\"schemaupdate\"\n" +#~ " classname=\"org.hibernate.tool.hbm2ddl.SchemaUpdateTask\"\n" +#~ " classpathref=\"class.path\"/>\n" +#~ " \n" +#~ " <schemaupdate\n" +#~ " properties=\"hibernate.properties\"\n" +#~ " quiet=\"no\">\n" +#~ " <fileset dir=\"src\">\n" +#~ " <include name=\"**/*.hbm.xml\"/>\n" +#~ " </fileset>\n" +#~ " </schemaupdate>\n" +#~ "</target>]]>" +#~ msgstr "" +#~ "<target name=\"schemaupdate\">\n" +#~ " <taskdef name=\"schemaupdate\"\n" +#~ " classname=\"org.hibernate.tool.hbm2ddl.SchemaUpdateTask\"\n" +#~ " classpathref=\"class.path\"/>\n" +#~ " \n" +#~ " <schemaupdate\n" +#~ " properties=\"hibernate.properties\"\n" +#~ " quiet=\"no\">\n" +#~ " <fileset dir=\"src\">\n" +#~ " <include name=\"**/*.hbm.xml\"/>\n" +#~ " </fileset>\n" +#~ " </schemaupdate>\n" +#~ "</target>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Configuration cfg = ....;\n" +#~ "new SchemaValidator(cfg).validate();]]>" +#~ msgstr "" +#~ "Configuration cfg = ....;\n" +#~ "new SchemaValidator(cfg).validate();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<target name=\"schemavalidate\">\n" +#~ " <taskdef name=\"schemavalidator\"\n" +#~ " classname=\"org.hibernate.tool.hbm2ddl.SchemaValidatorTask\"\n" +#~ " classpathref=\"class.path\"/>\n" +#~ " \n" +#~ " <schemavalidator\n" +#~ " properties=\"hibernate.properties\">\n" +#~ " <fileset dir=\"src\">\n" +#~ " <include name=\"**/*.hbm.xml\"/>\n" +#~ " </fileset>\n" +#~ " </schemavalidator>\n" +#~ "</target>]]>" +#~ msgstr "" +#~ "<target name=\"schemavalidate\">\n" +#~ " <taskdef name=\"schemavalidator\"\n" +#~ " classname=\"org.hibernate.tool.hbm2ddl.SchemaValidatorTask\"\n" +#~ " classpathref=\"class.path\"/>\n" +#~ " \n" +#~ " <schemavalidator\n" +#~ " properties=\"hibernate.properties\">\n" +#~ " <fileset dir=\"src\">\n" +#~ " <include name=\"**/*.hbm.xml\"/>\n" +#~ " </fileset>\n" +#~ " </schemaupdate>\n" +#~ "</target>" Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/transactions.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/transactions.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/transactions.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,2444 @@ +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# Language /mnt/hgfs/base/Hibernate/Reference translations for PACKAGE package. +# Copyright (C) 2006, 2007 Free Software Foundation, Inc. +# Automatically generated, 2006. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# +msgid "" +msgstr "" +"Project-Id-Version: Collection_Mapping\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2010-01-08T04:07:20\n" +"PO-Revision-Date: 2007-02-26 10:27+1000\n" +"Last-Translator: \n" +"Language-Team: <de(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.9.1\n" + +#. Tag: title +#, fuzzy, no-c-format +msgid "Transactions and Concurrency" +msgstr "Transaktionen und Nebenläufigkeit" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The most important point about Hibernate and concurrency control is that it " +"is easy to understand. Hibernate directly uses JDBC connections and JTA " +"resources without adding any additional locking behavior. It is recommended " +"that you spend some time with the JDBC, ANSI, and transaction isolation " +"specification of your database management system." +msgstr "" +"Der wichtigste Aspekt von Hibernate und der Nebenläufigkeitskontrolle ist " +"die Tatsache, dass es sehr leicht verständlich ist. Hibernate verwendet JDBC-" +"Verbindungen und JTA-Ressourcen direkt und ohne Hinzufügen zusätzlichen " +"Sperrverhaltens (sog. \"Locking\"). Wir empfehlen Ihnen, der JDBC-, ANSI- " +"und Transaktionsisolation-Spezifikation Ihres Datenbankmanagementsystems " +"etwas Zeit zu widmen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate does not lock objects in memory. Your application can expect the " +"behavior as defined by the isolation level of your database transactions. " +"Through <literal>Session</literal>, which is also a transaction-scoped " +"cache, Hibernate provides repeatable reads for lookup by identifier and " +"entity queries and not reporting queries that return scalar values." +msgstr "" +"Hibernate sichert keine Objekte im Speicher. Bei Ihrer Anwendung lässt sich " +"das durch das Isolationsniveau Ihrer Datenbanktransaktionen definierte " +"Verhalten erwarten. Bitte beachten Sie, dass dank der <literal>Session</" +"literal>, die ebenfalls über ein durch die Transkation begrenztes Cache " +"verfügt, Hibernate wiederholbares Lesen für Suchläufe nach Bezeichner- und " +"Entity-Anfragen liefert (ohne Anzeige von Anfragen, die mit skalaren Werten " +"reagieren)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"In addition to versioning for automatic optimistic concurrency control, " +"Hibernate also offers, using the <literal>SELECT FOR UPDATE</literal> " +"syntax, a (minor) API for pessimistic locking of rows. Optimistic " +"concurrency control and this API are discussed later in this chapter." +msgstr "" +"Neben der Versionierung für automatische optimistische " +"Nebenläufigkeitskontrolle bietet Hibernate auch eine (kleinere) API für das " +"pessimistische Sperren von Reihen unter Verwendung der <literal>SELECT FOR " +"UPDATE</literal>-Syntax. Die optimistische Nebenläufigkeitskontrolle sowie " +"die API werden später in diesem Kapitel noch erläutert." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The discussion of concurrency control in Hibernate begins with the " +"granularity of <literal>Configuration</literal>, <literal>SessionFactory</" +"literal>, and <literal>Session</literal>, as well as database transactions " +"and long conversations." +msgstr "" +"Wir beginnen das Thema der Nebenläufigkeitskontrolle in Hibernate mit der " +"Granularität von <literal>Configuration</literal>, <literal>SessionFactory</" +"literal> und <literal>Session</literal> sowie Datenbanktransaktionen und " +"langen Konversationen (sog. \"Conversations\")." + +#. Tag: title +#, no-c-format +msgid "Session and transaction scopes" +msgstr "Gültigkeitsbereiche von Session und Transaktion" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A <literal>SessionFactory</literal> is an expensive-to-create, threadsafe " +"object, intended to be shared by all application threads. It is created " +"once, usually on application startup, from a <literal>Configuration</" +"literal> instance." +msgstr "" +"Eine <literal>SessionFactory</literal> ist ein in der Erstellung teures, " +"threadsicheres Objekt, das von allen Anwendungsthreads geteilt werden soll. " +"Sie wird einmal - in der Regel beim Startup der Anwendung - aus einer " +"<literal>Configuration</literal>-Instanz erstellt." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A <literal>Session</literal> is an inexpensive, non-threadsafe object that " +"should be used once and then discarded for: a single request, a conversation " +"or a single unit of work. A <literal>Session</literal> will not obtain a " +"JDBC <literal>Connection</literal>, or a <literal>Datasource</literal>, " +"unless it is needed. It will not consume any resources until used." +msgstr "" +"Eine <literal>Session</literal> ist ein in der Erstellung nicht teures, " +"nicht threadsicheres Objekt, das für den einmaligen Gebrauch durch eine " +"Anfrage, eine Konversation oder eine Arbeitseinheit vorgesehen ist und " +"anschließend verworfen wird. Eine <literal>Session</literal> erhält keine " +"JDBC-<literal>Connection</literal> (oder eine <literal>Datasource</" +"literal>), außer diese werden benötigt, d.h. sie benötigen bis zum Gebrauch " +"keine Ressourcen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"In order to reduce lock contention in the database, a database transaction " +"has to be as short as possible. Long database transactions will prevent your " +"application from scaling to a highly concurrent load. It is not recommended " +"that you hold a database transaction open during user think time until the " +"unit of work is complete." +msgstr "" +"Der Vollständigkeit halber sollten Sie sich auch Gedanken zu " +"Datenbanktransaktionen machen. Eine Datenbanktransaktion sollte so kurz wie " +"möglich sein, um Sperrkonkurrenz (sog. \"Lock Contention\") in der Datenbank " +"zu reduzieren. Lange Datenbanktransaktionen behindern Ihre Anwendung bei der " +"Skalierung stark nebenläufiger Loads. Es ist daher fast nie gut, eine " +"Datenbank während der Benutzer \"Think Time\" offen zu halten, bis die " +"Arbeitseinheit beendet ist." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"What is the scope of a unit of work? Can a single Hibernate " +"<literal>Session</literal> span several database transactions, or is this a " +"one-to-one relationship of scopes? When should you open and close a " +"<literal>Session</literal> and how do you demarcate the database transaction " +"boundaries? These questions are addressed in the following sections." +msgstr "" +"Was ist der Gültigkeitsbereich einer Arbeitseinheit? Kann eine einzelne " +"Hibernate <literal>Session</literal> mehrere Datenbanktransaktionen umfassen " +"oder gilt eine \"one-to-one\"-Beziehung? Wann sollte eine <literal>Session</" +"literal> geöffnet und geschlossen werden, und wie werden die Grenzen der " +"Datenbanktransaktionen demarkiert?" + +#. Tag: title +#, no-c-format +msgid "Unit of work" +msgstr "Arbeitseinheit" + +#. Tag: para +#, no-c-format +msgid "" +"First, let's define a unit of work. A unit of work is a design pattern " +"described by Martin Fowler as <quote> [maintaining] a list of objects " +"affected by a business transaction and coordinates the writing out of " +"changes and the resolution of concurrency problems. </quote><citation>PoEAA</" +"citation> In other words, its a series of operations we wish to carry out " +"against the database together. Basically, it is a transaction, though " +"fulfilling a unit of work will often span multiple physical database " +"transactions (see <xref linkend=\"transactions-basics-apptx\" />). So really " +"we are talking about a more abstract notion of a transaction. The term " +"\"business transaction\" is also sometimes used in lieu of unit of work." +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Do not use the <emphasis>session-per-operation</emphasis> antipattern: do " +"not open and close a <literal>Session</literal> for every simple database " +"call in a single thread. The same is true for database transactions. " +"Database calls in an application are made using a planned sequence; they are " +"grouped into atomic units of work. This also means that auto-commit after " +"every single SQL statement is useless in an application as this mode is " +"intended for ad-hoc SQL console work. Hibernate disables, or expects the " +"application server to disable, auto-commit mode immediately. Database " +"transactions are never optional. All communication with a database has to " +"occur inside a transaction. Auto-commit behavior for reading data should be " +"avoided, as many small transactions are unlikely to perform better than one " +"clearly defined unit of work. The latter is also more maintainable and " +"extensible." +msgstr "" +"Zunächst einmal sollten Sie nicht das Negativ-Entwurfsmuster " +"<emphasis>Session-pro-Vorgang</emphasis> verwenden, d.h. öffnen und " +"schließen Sie eine <literal>Session</literal> nicht bei jedem einfachen " +"Datenbankaufruf in einem einzelnen Thread! Natürlich gilt dasselbe für " +"Datenbanktransaktionen. Datenbankaufrufe in einer Anwendung erfolgen durch " +"eine geplante Sequenz, sie werden in atomare Arbeitseinheiten gruppiert. " +"(Beachten Sie, dass dadurch auch Auto-Festschreibung (sog. \"Auto-Commit\") " +"nach jeder einzelnen SQL-Anweisung in einer Anwendung nutzlos ist, dieser " +"Modus ist für ad-hoc SQL-Konsolenarbeit vorgesehen. Hibernate deaktiviert - " +"oder erwartet, dass dies der Applikationsserver tut - den Auto-" +"Festschreibungsmodus sofort). Datenbanktransaktionen sind niemals optional, " +"jede Kommunikation mit einer Datenbank muss innerhalb einer Transaktion " +"erfolgen, unabhängig davon, ob Daten gelesen oder geschrieben werden. Wie " +"beschrieben sollte das Auto-Festschreibungsverhalten beim Lesen von Daten " +"vermieden werden, da viele kleinere Transaktionen aller Wahrscheinlichkeit " +"nach weniger leistungsfähig sind als eine klar definierte Arbeitseinheit. " +"Letztere lässt sich besser warten und ist erweiterbar." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The most common pattern in a multi-user client/server application is " +"<emphasis>session-per-request</emphasis>. In this model, a request from the " +"client is sent to the server, where the Hibernate persistence layer runs. A " +"new Hibernate <literal>Session</literal> is opened, and all database " +"operations are executed in this unit of work. On completion of the work, and " +"once the response for the client has been prepared, the session is flushed " +"and closed. Use a single database transaction to serve the clients request, " +"starting and committing it when you open and close the <literal>Session</" +"literal>. The relationship between the two is one-to-one and this model is a " +"perfect fit for many applications." +msgstr "" +"Das gängigste Muster der Mehrbenutzer-Client/Server-Applikation ist " +"<emphasis>Session-pro-Anfrage</emphasis>. Bei diesem Modell wird eine " +"Anfrage des Client an den Server geschickt (wo die Hibernate " +"Persistenzschicht läuft), eine neue Hibernate <literal>Session</literal> " +"wird geöffnet und sämtliche Datenbankvorgänge werden in dieser " +"Arbeitseinheit ausgeführt. Ist der Arbeitsvorgang abgeschlossen (und die " +"Antwort für den Client vorbereitet), wird die Session geräumt und " +"geschlossen. Sie würden auch eine einzelne Datenbanktransaktion für die " +"Client-Anfrage verwenden, wobei diese beim Öffnen und Schließen der " +"<literal>Session</literal> gestartet und festgeschrieben wird. Die Beziehung " +"zwischen den beiden ist \"one-to-one\" (injektiv) und dieses Modell eignet " +"sich perfekt für zahlreiche Anwendungen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The challenge lies in the implementation. Hibernate provides built-in " +"management of the \"current session\" to simplify this pattern. Start a " +"transaction when a server request has to be processed, and end the " +"transaction before the response is sent to the client. Common solutions are " +"<literal>ServletFilter</literal>, AOP interceptor with a pointcut on the " +"service methods, or a proxy/interception container. An EJB container is a " +"standardized way to implement cross-cutting aspects such as transaction " +"demarcation on EJB session beans, declaratively with CMT. If you use " +"programmatic transaction demarcation, for ease of use and code portability " +"use the Hibernate <literal>Transaction</literal> API shown later in this " +"chapter." +msgstr "" +"Die Herausforderung liegt in der Implementierung. Hibernate bietet ein " +"eingebautes Management der \"aktuellen Session\", um dieses Muster zu " +"vereinfachen. Sie müssen lediglich eine Transaktion starten, wenn eine " +"Serveranfrage bearbeitet werden muss und die Transaktion beenden ehe die " +"Antwort an den Client verschickt wird. Sie können dies auf beliebige Weise " +"ausführen, gängige Lösungen sind <literal>ServletFilter</literal>, AOP-" +"Interzeptor mit einem Pointcut an den Servicemethoden oder einem \"Proxy/" +"Interception Container\". Ein EJB-Container ist eine standardisierte Art der " +"Implementierung von Aspekten wie Transaktionsdemarkation an EJB Session-" +"Beans, deklarativ mit CMT. Falls Sie sich für die Verwendung " +"programmatischer Transaktionsdemarkation entscheiden, so ist die später in " +"diesem Kapitel erläuterte Hibernate <literal>Transaction</literal>-API " +"aufgrund von Benutzerfreundlichkeit und Codeübertragbarkeit zu bevorzugen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Your application code can access a \"current session\" to process the " +"request by calling <literal>sessionFactory.getCurrentSession()</literal>. " +"You will always get a <literal>Session</literal> scoped to the current " +"database transaction. This has to be configured for either resource-local or " +"JTA environments, see <xref linkend=\"architecture-current-session\" />." +msgstr "" +"Ihr Anwendungscode kann auf eine \"aktuelle Session\" zugreifen, um die " +"Anfrage zu bearbeiten, indem wann immer nötig einfach der Aufruf " +"<literal>sessionFactory.getCurrentSession()</literal> erfolgt. Sie werden " +"stets eine durch die aktuelle Datenbanktransaktion begrenzte " +"<literal>Session</literal> erhalten. Dies muss entweder für \"Resource-local" +"\" oder JTA-Umgebungen konfiguriert werden, siehe <xref linkend=" +"\"architecture-current-session\"/>." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can extend the scope of a <literal>Session</literal> and database " +"transaction until the \"view has been rendered\". This is especially useful " +"in servlet applications that utilize a separate rendering phase after the " +"request has been processed. Extending the database transaction until view " +"rendering, is achieved by implementing your own interceptor. However, this " +"will be difficult if you rely on EJBs with container-managed transactions. A " +"transaction will be completed when an EJB method returns, before rendering " +"of any view can start. See the Hibernate website and forum for tips and " +"examples relating to this <emphasis>Open Session in View</emphasis> pattern." +msgstr "" +"Manchmal empfiehlt es sich, den Gültigkeitsbereich einer <literal>Session</" +"literal> und Datenbanktransaktion zu erweitern bis die \"Ansicht gerendert " +"wurde\". Das ist insbesondere bei Servlet-Anwendungen von Nutzen, die eine " +"separate Rendering-Phase nach der Bearbeitung der Anfrage verwenden. Die " +"Verlängerung der Datenbanktransaktion bis das Rendering der Ansicht " +"abgeschlossen ist, ist ganz einfach, wenn Sie Ihren eigenen Interzeptor " +"implementieren. Es ist jedoch nicht ganz einfach umzusetzen, wenn Sie auf " +"EJBs mit Container-gemanagten Transaktionen angewiesen sind, da eine " +"Transaktion abgeschlossen wird, wenn eine EJB-Methode wiedergegeben wird, " +"ehe das Rendering einer Ansicht gestartet werden kann. Auf der Hibernate " +"Website und im Forum finden Sie Tipps und Beispiele rund um dieses " +"<emphasis>Offene Session in Ansicht</emphasis>-Muster." + +#. Tag: title +#, no-c-format +msgid "Long conversations" +msgstr "Lange Konversationen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The session-per-request pattern is not the only way of designing units of " +"work. Many business processes require a whole series of interactions with " +"the user that are interleaved with database accesses. In web and enterprise " +"applications, it is not acceptable for a database transaction to span a user " +"interaction. Consider the following example:" +msgstr "" +"Das \"Session-pro-Anfrage\"-Muster ist nicht das einzige hilfreiche Konzept, " +"das beim Design von Arbeitseinheiten verwendet werden kann. Zahlreiche " +"Geschäftsvorgänge erfordern ganze Serien von Interaktionen, bei denen der " +"Benutzer in Datenbankzugriffe involviert ist. In Web- und " +"Unternehmensanwendungen ist es nicht akzeptabel, dass eine " +"Datenbanktransaktion eine Benutzerinteraktion umfasst. Schauen Sie sich " +"folgendes Beispiel an:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The first screen of a dialog opens. The data seen by the user has been " +"loaded in a particular <literal>Session</literal> and database transaction. " +"The user is free to modify the objects." +msgstr "" +"Der erste Bildschirmdialog wird geöffnet und die für den Benutzer sichtbaren " +"Daten werden in einer bestimmten <literal>Session</literal> und " +"Datenbanktransaktion geladen. Der Benutzer kann Änderungen an den Objekten " +"vornehmen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The user clicks \"Save\" after 5 minutes and expects their modifications to " +"be made persistent. The user also expects that they were the only person " +"editing this information and that no conflicting modification has occurred." +msgstr "" +"Der Benutzer klickt nach 5 Minuten auf \"Speichern\" (\"save\") und " +"erwartet, dass die vorgenommenen Änderungen persistent gemacht wurden; er " +"erwartet außerdem, die einzige Person zu sein, die Änderungen vornimmt und " +"dass nicht die Möglichkeit widersprüchlicher Änderungen besteht." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"From the point of view of the user, we call this unit of work a long-running " +"<emphasis>conversation</emphasis> or <emphasis>application transaction</" +"emphasis>. There are many ways to implement this in your application." +msgstr "" +"Wir nennen diese Arbeitseinheit vom Standpunkt des Benutzers aus eine lange " +"laufende <emphasis>Konversation</emphasis> (oder " +"<emphasis>Anwendungstransaktion</emphasis>). Es gibt zahlreiche Arten, wie " +"Sie dies in Ihrer Anwendung implementieren können." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A first naive implementation might keep the <literal>Session</literal> and " +"database transaction open during user think time, with locks held in the " +"database to prevent concurrent modification and to guarantee isolation and " +"atomicity. This is an anti-pattern, since lock contention would not allow " +"the application to scale with the number of concurrent users." +msgstr "" +"Eine erste, harmlose Implementierung könnte die <literal>Session</literal> " +"und Datenbanktransaktion während der Benutzer \"Think Time\" offen halten, " +"wobei Sperren einen Schutz vor gleichzeitigen Modifikationen liefern und " +"eine Garantie für Isolation und Atomarität bieten. Dies ist natürlich ein " +"Negativ-Entwurf, da Sperrkonkurrenz (sog. \"Lock Contention\") es der " +"Anwendung nicht erlauben würde, die Anzahl gleichzeitiger Benutzer zu " +"erhöhen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You have to use several database transactions to implement the conversation. " +"In this case, maintaining isolation of business processes becomes the " +"partial responsibility of the application tier. A single conversation " +"usually spans several database transactions. It will be atomic if only one " +"of these database transactions (the last one) stores the updated data. All " +"others simply read data (for example, in a wizard-style dialog spanning " +"several request/response cycles). This is easier to implement than it might " +"sound, especially if you utilize some of Hibernate's features:" +msgstr "" +"Wir müssen ganz offensichtlich mehrere Datenbanktransaktionen verwenden, um " +"die Konversation zu implementieren. In diesem Fall unterliegt die " +"Aufrechterhaltung der Isolation von Business-Vorgängen zum Teil der " +"Verantwortung des Applikations-Tiers. Eine einzelne Konversation umfasst in " +"der Regel mehrere Datenbanktransaktionen. Sie wird atomar sein, falls eine " +"dieser Datenbanktransaktionen (die letzte) die aktualisierten Daten " +"speichert, alle anderen lesen einfach Daten (z.B. in einem \"Wizard-style " +"Dialog\" der sich über mehrere Anfrage/Antworten-Zyklen erstreckt). Das ist " +"einfacher zu implementieren als man meint, insbesondere dann, wenn Sie " +"Hibernates Features nutzen:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis>Automatic Versioning</emphasis>: Hibernate can perform automatic " +"optimistic concurrency control for you. It can automatically detect if a " +"concurrent modification occurred during user think time. Check for this at " +"the end of the conversation." +msgstr "" +"<emphasis>Automatische Versionierung</emphasis> - Hibernate kann eine " +"automatische, optimistische Nebenläufigkeitskontrolle für Sie übernehmen und " +"erkennt automatisch, ob während der Benutzer \"Think Time\" eine " +"gleichzeitige Modifikation stattgefunden hat. In der Regel prüfen wir nur am " +"Ende der Konversation." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis>Detached Objects</emphasis>: if you decide to use the " +"<emphasis>session-per-request</emphasis> pattern, all loaded instances will " +"be in the detached state during user think time. Hibernate allows you to " +"reattach the objects and persist the modifications. The pattern is called " +"<emphasis>session-per-request-with-detached-objects</emphasis>. Automatic " +"versioning is used to isolate concurrent modifications." +msgstr "" +"<emphasis>Abgesetzte Objekte</emphasis> - Falls Sie das bereits dargestellte " +"<emphasis>Session-pro-Anfrage </emphasis>-Muster verwenden, so befinden sich " +"alle geladenen Instanzen während der Benutzer \"Think Time\" in abgesetztem " +"Status. Hibernate ermöglicht die Wiederanbindung der Objekte sowie die " +"Persistierung der Modifikationen, das Muster heißt <emphasis>Session-pro-" +"Anfrage-mit-abgesetzten-Objekten</emphasis> (sog \"session-per-request-with-" +"detached-objects\"). Automatische Versionierung wird zur Isolation " +"gleichzeitiger Modifikationen verwendet." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis>Extended (or Long) Session</emphasis>: the Hibernate " +"<literal>Session</literal> can be disconnected from the underlying JDBC " +"connection after the database transaction has been committed and reconnected " +"when a new client request occurs. This pattern is known as <emphasis>session-" +"per-conversation</emphasis> and makes even reattachment unnecessary. " +"Automatic versioning is used to isolate concurrent modifications and the " +"<literal>Session</literal> will not be allowed to be flushed automatically, " +"but explicitly." +msgstr "" +"<emphasis>Erweiterte (oder lange) Session</emphasis> - Die Hibernate " +"<literal>Session</literal> kann von der zu Grunde liegenden JDBC-Verbindung " +"gelöst werden, nachdem die Datenbanktransaktion festgeschrieben wurde. Eine " +"erneute Verbindung kann dann bei einer neuen Client-Anfrage erfolgen. Dieses " +"Muster ist unter dem Namen <emphasis>Session-pro-Konversation</emphasis> " +"(sog. \"Session-per-Conversation\") bekannt und macht sogar die " +"Wiederanbindung unnötig. Automatische Versionierung wird verwendet, um " +"gleichzeitige Modifikationen zu isolieren, und die <literal>Session</" +"literal> kann in der Regel nicht automatisch, sondern nur explizit, geräumt " +"werden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Both <emphasis>session-per-request-with-detached-objects</emphasis> and " +"<emphasis>session-per-conversation</emphasis> have advantages and " +"disadvantages. These disadvantages are discussed later in this chapter in " +"the context of optimistic concurrency control." +msgstr "" +"Sowohl <emphasis>Session-pro-Anfrage-mit-abgesetzten-Objekten</emphasis> als " +"auch <emphasis>Session-pro-Konversation</emphasis> bieten Vor- und " +"Nachteile. Diese werden später in diesem Kapitel im Zusammenhang mit " +"optimistischer Nebenläufigkeitskontrolle erläutert." + +#. Tag: title +#, no-c-format +msgid "Considering object identity" +msgstr "Die Berücksichtigung der Objektidentität" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"An application can concurrently access the same persistent state in two " +"different <literal>Session</literal>s. However, an instance of a persistent " +"class is never shared between two <literal>Session</literal> instances. It " +"is for this reason that there are two different notions of identity:" +msgstr "" +"Eine Anwendung kann gleichzeitig auf denselben persistenten Status in zwei " +"verschiedenen <literal>Session</literal>s zugreifen. Jedoch kann die Instanz " +"einer persistenten Klasse nie von zwei <literal>Session</literal>-Instanzen " +"geteilt werden. Es gibt daher zwei unterschiedliche Begriffe von Identität " +"(sog. \"Identity\"):" + +#. Tag: term +#, no-c-format +msgid "Database Identity" +msgstr "Datenbank-Identität" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>foo.getId().equals( bar.getId() )</literal>" +msgstr "foo.getId().equals( bar.getId() )" + +#. Tag: term +#, no-c-format +msgid "JVM Identity" +msgstr "JVM-Identität" + +#. Tag: para +#, no-c-format +msgid "<literal>foo==bar</literal>" +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"For objects attached to a <emphasis>particular</emphasis> <literal>Session</" +"literal> (i.e., in the scope of a <literal>Session</literal>), the two " +"notions are equivalent and JVM identity for database identity is guaranteed " +"by Hibernate. While the application might concurrently access the \"same" +"\" (persistent identity) business object in two different sessions, the two " +"instances will actually be \"different\" (JVM identity). Conflicts are " +"resolved using an optimistic approach and automatic versioning at flush/" +"commit time." +msgstr "" +"Dann sind für an zu einer <emphasis>bestimmten</emphasis> <literal>Session</" +"literal> gehörenden Objekte (d.h. im Gültigkeitsbereich einer " +"<literal>Session</literal>) die beiden Begriffe äquivalent, und die JVM-" +"Identität für Datenbank-Identität wird von Hibernate garantiert. Während " +"jedoch die Anwendung zeitgleich auf \"dasselbe\" (persistente Identität) " +"Businessobjekt in zwei verschiedenen Sessions zugreifen kann, werden die " +"beiden Instanzen tatsächlich \"unterschiedlich\" sein (JVM-Identität). " +"Konflikte werden gelöst, indem zum Zeitpunkt des Räumens/Festschreibens " +"(automatische Versionierung) eine optimistische Vorgehensweise verwendet " +"wird." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This approach leaves Hibernate and the database to worry about concurrency. " +"It also provides the best scalability, since guaranteeing identity in single-" +"threaded units of work means that it does not need expensive locking or " +"other means of synchronization. The application does not need to synchronize " +"on any business object, as long as it maintains a single thread per " +"<literal>Session</literal>. Within a <literal>Session</literal> the " +"application can safely use <literal>==</literal> to compare objects." +msgstr "" +"Bei dieser Vorgehensweise kümmern sich Hibernate und die Datenbank um die " +"Nebenläufigkeit. Dadurch bietet sich auch die beste Skalierbarkeit, da die " +"Gewährleistung von Identität ein einthreadigen Arbeitseinheiten keine teuren " +"Sperren oder andere Synchronisationsmaßnahmen erfordert. Die Anwendung muss " +"nie Synchronisierungen an Businessobjekten durchführen, so lange nur ein " +"einzelner Thread pro <literal>Session</literal> existiert. Innerhalb einer " +"<literal>Session</literal> kann die Anwendung ohne Probleme <literal>==</" +"literal> verwenden, um Objekte zu vergleichen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"However, an application that uses <literal>==</literal> outside of a " +"<literal>Session</literal> might produce unexpected results. This might " +"occur even in some unexpected places. For example, if you put two detached " +"instances into the same <literal>Set</literal>, both might have the same " +"database identity (i.e., they represent the same row). JVM identity, " +"however, is by definition not guaranteed for instances in a detached state. " +"The developer has to override the <literal>equals()</literal> and " +"<literal>hashCode()</literal> methods in persistent classes and implement " +"their own notion of object equality. There is one caveat: never use the " +"database identifier to implement equality. Use a business key that is a " +"combination of unique, usually immutable, attributes. The database " +"identifier will change if a transient object is made persistent. If the " +"transient instance (usually together with detached instances) is held in a " +"<literal>Set</literal>, changing the hashcode breaks the contract of the " +"<literal>Set</literal>. Attributes for business keys do not have to be as " +"stable as database primary keys; you only have to guarantee stability as " +"long as the objects are in the same <literal>Set</literal>. See the " +"Hibernate website for a more thorough discussion of this issue. Please note " +"that this is not a Hibernate issue, but simply how Java object identity and " +"equality has to be implemented." +msgstr "" +"Jedoch kann eine Anwendung, die <literal>==</literal> außerhalb einer " +"<literal>Session</literal> verwendet, unerwartete Ergebnisse liefern. Dies " +"kann auch an einigen unerwarteten Orten geschehen, etwa wenn Sie zwei " +"abgesetzte Instanzen in demselben <literal>Set</literal> ablegen. Beide " +"besitzen möglicherweise diesselbe Datenbank-Identität (d.h. sie " +"repräsentieren diesselbe Reihe), aber die JVM-Identität wird der Definition " +"nach nicht für Instanzen mit abgesetztem Status garantiert. Der Entwickler " +"muss die <literal>equals()</literal> und <literal>hashCode()</literal>-" +"Methoden in persistenten Klassen außer Kraft setzen und seinen eigenen " +"Begriff von Objektgleichheit implementieren. Es existiert eine " +"Einschränkung: Verwenden Sie niemals den Datenbank-Bezeichner zur " +"Implementierung der Gleichheit, sondern verwenden Sie einen Business-" +"Schlüssel, eine Kombination eindeutiger, in der Regel unveränderlicher " +"Attribute. Der Datenbank-Bezeichner ändert sich, wenn ein transientes Objekt " +"persistent gemacht wird. Wenn die transiente Instanz (normalerweise zusammen " +"mit abgesetzten Instanzen) in einem <literal>Set</literal> gehalten wird, so " +"findet bei Veränderung des Hashcodes ein Vertragsbruch des <literal>Set</" +"literal> statt. Attribute für Business-Schlüssel müssen nicht so stabil wie " +"Primärschlüssel der Datenbank sein, und Sie müssen lediglich die Stabilität " +"garantieren während die Objekte sich im selben <literal>Set</literal> " +"befinden. Weitere Informationen zu diesem Thema finden Sie auf der Hibernate-" +"Website. Beachten Sie bitte auch, dass es sich hierbei nicht um eine " +"Hibernate-Thematik, sondern Java Objekt-Identität und Gleichheit handelt." + +#. Tag: title +#, no-c-format +msgid "Common issues" +msgstr "Gängige Probleme" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Do not use the anti-patterns <emphasis>session-per-user-session</emphasis> " +"or <emphasis>session-per-application</emphasis> (there are, however, rare " +"exceptions to this rule). Some of the following issues might also arise " +"within the recommended patterns, so ensure that you understand the " +"implications before making a design decision:" +msgstr "" +"Verwenden Sie nie die Negativ-Entwurfsmuster <emphasis>Session-pro-Benutzer-" +"Session</emphasis> (sog. \"Session-per-User-Session\") oder " +"<emphasis>Session-pro-Anwendung</emphasis> (sog. \"Session-per-Application" +"\"). Natürlich gibt es seltene Ausnahmen zu dieser Regel. Beachten Sie " +"bitte, dass einige der folgenden Fälle auch bei den empfohlenen Mustern " +"auftreten können, und vergewissern Sie sich, dass Sie mit den Implikationen " +"vertraut sind, ehe Sie Entscheidungen hinsichtlich des Designs treffen:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A <literal>Session</literal> is not thread-safe. Things that work " +"concurrently, like HTTP requests, session beans, or Swing workers, will " +"cause race conditions if a <literal>Session</literal> instance is shared. If " +"you keep your Hibernate <literal>Session</literal> in your " +"<literal>HttpSession</literal> (this is discussed later in the chapter), you " +"should consider synchronizing access to your Http session. Otherwise, a user " +"that clicks reload fast enough can use the same <literal>Session</literal> " +"in two concurrently running threads." +msgstr "" +"Eine <literal>Session</literal> ist nicht threadsicher. Dinge, die " +"gleichzeitig laufen sollen, wie etwa HTTP-Anfragen, Session-Beans oder Swing-" +"Worker werden Race-Conditions auslösen, wenn eine <literal>Session</literal>-" +"Instanz geteilt würde. Falls Sie Ihre Hibernate <literal>Session</literal> " +"in Ihrer <literal>HttpSession</literal> behalten (wird später noch " +"erläutert), sollten Sie in Erwägung ziehen, den Zugriff auf Ihre Http-" +"Session zu synchronisieren. Anderfalls kann ein Benutzer der schnell genug " +"auf \"erneut laden\" klickt diesselbe <literal>Session</literal> in in zwei " +"gleichzeitig laufenden Threads benutzen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"An exception thrown by Hibernate means you have to rollback your database " +"transaction and close the <literal>Session</literal> immediately (this is " +"discussed in more detail later in the chapter). If your <literal>Session</" +"literal> is bound to the application, you have to stop the application. " +"Rolling back the database transaction does not put your business objects " +"back into the state they were at the start of the transaction. This means " +"that the database state and the business objects will be out of sync. " +"Usually this is not a problem, because exceptions are not recoverable and " +"you will have to start over after rollback anyway." +msgstr "" +"Eine Ausnahmemeldung von Hibernate bedeutet, dass Sie Ihre " +"Datenbanktransaktion wiederholen und die <literal>Session</literal> sofort " +"schließen müssen (dazu später mehr). Falls Ihre <literal>Session</literal> " +"an die Anwendung gebunden ist, so müssen Sie die Anwendung stoppen. Das " +"Wiederholen (sog. \"Rollback\") der Datenbanktransaktion bringt Ihre " +"Business-Objekte nicht in deren Zustand zu Beginn der Transaktion zurück. " +"Das bedeutet, dass der Datenbankzustand und die Business-Objekte nicht mehr " +"synchron sind. In der Regel ist das kein Problem, da Ausnahmen nicht wieder " +"herstellbar sind und Sie nach einem Rollback ohnehin wieder neu anfangen " +"müssen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>Session</literal> caches every object that is in a persistent " +"state (watched and checked for dirty state by Hibernate). If you keep it " +"open for a long time or simply load too much data, it will grow endlessly " +"until you get an OutOfMemoryException. One solution is to call <literal>clear" +"()</literal> and <literal>evict()</literal> to manage the <literal>Session</" +"literal> cache, but you should consider a Stored Procedure if you need mass " +"data operations. Some solutions are shown in <xref linkend=\"batch\" />. " +"Keeping a <literal>Session</literal> open for the duration of a user session " +"also means a higher probability of stale data." +msgstr "" +"Die <literal>Session</literal> speichert jedes Objekt, das sich in " +"persistentem Status befindet (von Hibernate im Hinblick auf Zugriffe " +"überwacht). Das bedeutet, dass es so lange weiterwächst, bis Sie eine " +"\"OutOfMemoryException\"-Ausnahme erhalten, wenn Sie sie lange Zeit geöffnet " +"halten oder einfach zu viele Daten laden. Eine Lösung hierfür besteht im " +"Aufruf von <literal>clear()</literal> und <literal>evict()</literal>, um das " +"<literal>Session</literal>-Cache zu managen, aber wahrscheinlich sollten Sie " +"eine gespeicherte Prozedur (sog. \"stored procedure\") in Betracht ziehen, " +"falls Sie Massendatenvorgänge benötigen. Einige Lösungen sind in <xref " +"linkend=\"batch\"/> aufgeführt. Eine <literal>Session</literal> während der " +"Dauer einer Benutzer-Session geöffnet zu halten, kann auch eine hohe " +"Wahrscheinlichkeit veralteter Daten bedeuten." + +#. Tag: title +#, no-c-format +msgid "Database transaction demarcation" +msgstr "Abgrenzung von Datenbanktransaktionen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Database, or system, transaction boundaries are always necessary. No " +"communication with the database can occur outside of a database transaction " +"(this seems to confuse many developers who are used to the auto-commit " +"mode). Always use clear transaction boundaries, even for read-only " +"operations. Depending on your isolation level and database capabilities this " +"might not be required, but there is no downside if you always demarcate " +"transactions explicitly. Certainly, a single database transaction is going " +"to perform better than many small transactions, even for reading data." +msgstr "" +"Datenbank- (oder System-) Transaktionsgrenzen sind immer notwendig. Es kann " +"keine Kommunikation mit der Datenbank außerhalb einer Datenbanktransaktion " +"erfolgen (das sorgt insbesondere bei Entwicklern, die den Auto-" +"Festschreibungsmodus gewohnt sind, manchmal für Verwirrung). Verwenden Sie " +"stets klare Transaktionsgrenzen, selbst bei schreibgeschützten Vorgängen. Je " +"nach Isolationsebene und Leistungsfähigkeit der Datenbank ist dies " +"vielleicht nicht nötig, aber es schadet nicht, wenn Sie Transaktionen immer " +"explizit demarkieren. Eine einzelne Datenbanktransaktion wird in jedem Fall " +"besser arbeiten als viele kleine Transaktionen, selbt beim ausschließlichen " +"Lesen von Daten." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A Hibernate application can run in non-managed (i.e., standalone, simple " +"Web- or Swing applications) and managed J2EE environments. In a non-managed " +"environment, Hibernate is usually responsible for its own database " +"connection pool. The application developer has to manually set transaction " +"boundaries (begin, commit, or rollback database transactions) themselves. A " +"managed environment usually provides container-managed transactions (CMT), " +"with the transaction assembly defined declaratively (in deployment " +"descriptors of EJB session beans, for example). Programmatic transaction " +"demarcation is then no longer necessary." +msgstr "" +"Eine Hibernate Anwendung kann in nicht-gemanagten (d.h. selbstständigen, " +"einfachen Web- oder Swing-Anwendungen) sowie gemanagten J2EE-Umgebungen " +"laufen. Wenn in einer nicht-gemanagten Umgebung, so ist Hibernate " +"normalerweise für seinen eigenen Datenbank Verbindungspool verantwortlich. " +"Der Anwendungsentwickler muss manuell die Grenzen der Transaktion " +"einstellen, mit anderen Worten die Datenbanktransaktion selbst beginnen, " +"festschreiben oder wiederholen (d.h. einen Rollback vornehmen). Eine " +"gemanagte Umgebung bietet normalerweise Container-gemanagte Transaktionen " +"(CMT), wobei die Anordnung der Transaktion deklarativ zum Beispiel in den " +"Deployment-Deskriptoren der EJB Session-Beans definiert wird. Eine " +"programmatische Transaktionsdemarkation ist dann nicht länger notwendig." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"However, it is often desirable to keep your persistence layer portable " +"between non-managed resource-local environments, and systems that can rely " +"on JTA but use BMT instead of CMT. In both cases use programmatic " +"transaction demarcation. Hibernate offers a wrapper API called " +"<literal>Transaction</literal> that translates into the native transaction " +"system of your deployment environment. This API is actually optional, but we " +"strongly encourage its use unless you are in a CMT session bean." +msgstr "" +"Es ist jedoch oftmals wünschenswert die Persistenzschicht zwischen nicht " +"gemanagten Ressourcen-lokalen Umgebungen und Systemen, die sich auf JTA " +"stützen aber BMT statt CMT verwenden, übertragbar zu halten. In beiden " +"Fällen würden Sie programmatische Transaktionsdemarkation benutzen. " +"Hibernate bietet ein Wrapper-API mit Namen <literal>Transaction</literal> " +"das in das native Transaktionssystem Ihrer Deployment-Umgebung übersetzt " +"wird. Dieses API ist optional, jedoch empfehlen wir dringend dessen " +"Verwendung, außer Sie befinden sich in einem CMT Session-Bean. " + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Ending a <literal>Session</literal> usually involves four distinct phases:" +msgstr "" +"In der Regel umfasst das Beenden einer <literal>Session</literal> vier " +"eindeutige Phasen:" + +#. Tag: para +#, no-c-format +msgid "flush the session" +msgstr "Räumen der Session" + +#. Tag: para +#, no-c-format +msgid "commit the transaction" +msgstr "Festschreibung der Transaktion" + +#. Tag: para +#, no-c-format +msgid "close the session" +msgstr "Schließen der Session" + +#. Tag: para +#, no-c-format +msgid "handle exceptions" +msgstr "Bearbeitung von Ausnahmen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"We discussed Flushing the session earlier, so we will now have a closer look " +"at transaction demarcation and exception handling in both managed and non-" +"managed environments." +msgstr "" +"Die Räumung einer Session wurde zuvor bereits erläutert - werfen wir nun " +"einen genaueren Blick auf die Transaktionsdemarkation und den Umgang mit " +"Ausnahmen in gemanagten und nicht gemanagten Umgebungen." + +#. Tag: title +#, no-c-format +msgid "Non-managed environment" +msgstr "Die nicht-gemanagte Umgebung" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If a Hibernate persistence layer runs in a non-managed environment, database " +"connections are usually handled by simple (i.e., non-DataSource) connection " +"pools from which Hibernate obtains connections as needed. The session/" +"transaction handling idiom looks like this:" +msgstr "" +"Falls eine Hibernate Persistenzschicht in einer nicht-gemanagten Umgebung " +"läuft, werden Datenbankverbindungen in der Regel durch einfache " +"Verbindungspools (d.h. nicht-DataSource) bearbeitet, von denen Hibernate " +"nach Bedarf Verbindungen erhält. Das Session-/Transaktionsbearbeitungsidiom " +"sieht wie folgt aus:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You do not have to <literal>flush()</literal> the <literal>Session</literal> " +"explicitly: the call to <literal>commit()</literal> automatically triggers " +"the synchronization depending on the FlushMode for the session (see <xref " +"linkend=\"objectstate-flushing\" />). A call to <literal>close()</literal> " +"marks the end of a session. The main implication of <literal>close()</" +"literal> is that the JDBC connection will be relinquished by the session. " +"This Java code is portable and runs in both non-managed and JTA environments." +msgstr "" +"Sie müssen keinen expliziten <literal>flush()</literal> der " +"<literal>Session</literal> durchführen - der Aufruf <literal>commit()</" +"literal> löst die Synchronisierung für die Session automatisch aus (je nach " +"<xref linkend=\"objectstate-flushing\"/>). Der Aufruf <literal>close()</" +"literal> markiert das Ende einer Session. Die Hauptauswirkung von " +"<literal>close()</literal> ist, dass die JDBC-Verbindung von der Session " +"aufgegeben wird. Dieser Java-Code ist übertragbar und funktioniert sowohl in " +"nicht gemanagten als auch in JTA-Umgebungen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"As outlined earlier, a much more flexible solution is Hibernate's built-in " +"\"current session\" context management:" +msgstr "" +"Eine wesentlich flexiblere Lösung ist Hibernates integriertes " +"Kontextmanagement für die \"aktuelle Session\" wie zuvor beschrieben:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You will not see these code snippets in a regular application; fatal " +"(system) exceptions should always be caught at the \"top\". In other words, " +"the code that executes Hibernate calls in the persistence layer, and the " +"code that handles <literal>RuntimeException</literal> (and usually can only " +"clean up and exit), are in different layers. The current context management " +"by Hibernate can significantly simplify this design by accessing a " +"<literal>SessionFactory</literal>. Exception handling is discussed later in " +"this chapter." +msgstr "" +"Sie werden diese Codestücke aller Wahrscheinlichkeit in einer regulären " +"Anwendung niemals sehen; fatale (System)-Ausnahmen sollten stets \"ganz oben" +"\" aufgefangen werden. Mit anderen Worten: Der Code, der Hibernate Aufrufe " +"(in der Persistenzschicht) ausführt und der Code, der die " +"<literal>RuntimeException</literal> bearbeitet (und in der Regel nur " +"reinigen und beenden kann) befinden sich in unterschiedlichen Schichten. Das " +"aktuelle Kontextmanagement von Hibernate kann diesen Entwurf entscheidend " +"vereinfachen, da Sie lediglich auf eine <literal>SessionFactory</literal> " +"zugreifen müssen. Der Umgang mit Ausnahmen wird später in diesem Kapitel " +"noch näher erläutert." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You should select <literal>org.hibernate.transaction.JDBCTransactionFactory</" +"literal>, which is the default, and for the second example select <literal>" +"\"thread\"</literal> as your <literal>hibernate." +"current_session_context_class</literal>." +msgstr "" +"Bitte beachten Sie, dass Sie <literal>org.hibernate.transaction." +"JDBCTransactionFactory</literal> (Standard) und für das zweite Beispiel " +"<literal>\"thread\"</literal> als <literal>hibernate." +"current_session_context_class</literal> wählen sollten." + +#. Tag: title +#, no-c-format +msgid "Using JTA" +msgstr "Die Verwendung von JTA" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If your persistence layer runs in an application server (for example, behind " +"EJB session beans), every datasource connection obtained by Hibernate will " +"automatically be part of the global JTA transaction. You can also install a " +"standalone JTA implementation and use it without EJB. Hibernate offers two " +"strategies for JTA integration." +msgstr "" +"Falls Ihre Persistenzschicht in einem Applikationsserver läuft (z.B. hinter " +"EJB Session-Beans), so wird jede durch Hibernate erlangte " +"Datenquellenverbindung Teil der allgemeinen JTA-Transaktion. Sie können auch " +"eine selbstsändige JTA-Implementierung installieren und diese ohne EJB " +"verwenden. Hibernate bietet zwei Strategien für die JTA-Integration." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If you use bean-managed transactions (BMT), Hibernate will tell the " +"application server to start and end a BMT transaction if you use the " +"<literal>Transaction</literal> API. The transaction management code is " +"identical to the non-managed environment." +msgstr "" +"Falls Sie vom Bean gemanagte Transaktionen (BMT) benutzen, so teilt " +"Hibernate dem Applikationsserver mit, dass eine BMT-Transaktion gestartet " +"und beendet werden soll, wenn Sie eine <literal>Transaction</literal>-API " +"verwenden. Der Transaktionsmanagement-Code ist also identisch mit der nicht-" +"gemanagten Umgebung." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If you want to use a transaction-bound <literal>Session</literal>, that is, " +"the <literal>getCurrentSession()</literal> functionality for easy context " +"propagation, use the JTA <literal>UserTransaction</literal> API directly:" +msgstr "" +"Falls Sie eine transaktionsgebundene <literal>Session</literal>, d.h. die " +"<literal>getCurrentSession()</literal>-Funktionalität für einfache " +"Kontextübertragung benutzen wollen, müssen Sie die JTA " +"<literal>UserTransaction</literal>-API direkt verwenden:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"With CMT, transaction demarcation is completed in session bean deployment " +"descriptors, not programmatically. The code is reduced to:" +msgstr "" +"Mit CMT erfolgt die Transaktionsdemarkation in Session-Bean-Deployment-" +"Deskriptoren (und nicht programmatisch), weswegen der Code wie folgt " +"reduziert ist:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"In a CMT/EJB, even rollback happens automatically. An unhandled " +"<literal>RuntimeException</literal> thrown by a session bean method tells " +"the container to set the global transaction to rollback. <emphasis>You do " +"not need to use the Hibernate <literal>Transaction</literal> API at all with " +"BMT or CMT, and you get automatic propagation of the \"current\" Session " +"bound to the transaction.</emphasis>" +msgstr "" +"In einem CMT/EJB erfolgt sogar der Rollback automatisch, da eine " +"unbearbeitete<literal>RuntimeException</literal>, die durch eine Session-" +"Bean-Methode gemeldet wird, dem Container mitteilt, dass er die allgemeine " +"Transaktion auf Rollback setzen soll. <emphasis>Das bedeutet, dass Sie die " +"Hibernate <literal>Transaction</literal>-API gar nicht mit BMT oder CMT " +"verwenden müssen und Sie eine automatische Fortpflanzung der \"aktuellen\", " +"an die Transaktion gebundenen Session erhalten.</emphasis>" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"When configuring Hibernate's transaction factory, choose <literal>org." +"hibernate.transaction.JTATransactionFactory</literal> if you use JTA " +"directly (BMT), and <literal>org.hibernate.transaction." +"CMTTransactionFactory</literal> in a CMT session bean. Remember to also set " +"<literal>hibernate.transaction.manager_lookup_class</literal>. Ensure that " +"your <literal>hibernate.current_session_context_class</literal> is either " +"unset (backwards compatibility), or is set to <literal>\"jta\"</literal>." +msgstr "" +"Bitte beachten Sie, dass Sie <literal>org.hibernate.transaction." +"JTATransactionFactory</literal> wählen sollten, falls Sie JTA direkt (BMT) " +"verwenden und <literal>org.hibernate.transaction.CMTTransactionFactory</" +"literal> in einem CMT Session-Bean, wenn Sie Hibernates Transaction-Factory " +"konfigurieren. Sie sollten auch daran denken <literal>hibernate.transaction." +"manager_lookup_class</literal> einzustellen. Vergewissern Sie sich außerdem, " +"dass <literal>hibernate.current_session_context_class</literal> entweder " +"nicht gesetzt (rückwärtige Kompatibilität) oder auf <literal>\"jta\"</" +"literal> gesetzt ist." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>getCurrentSession()</literal> operation has one downside in a " +"JTA environment. There is one caveat to the use of <literal>after_statement</" +"literal> connection release mode, which is then used by default. Due to a " +"limitation of the JTA spec, it is not possible for Hibernate to " +"automatically clean up any unclosed <literal>ScrollableResults</literal> or " +"<literal>Iterator</literal> instances returned by <literal>scroll()</" +"literal> or <literal>iterate()</literal>. You <emphasis>must</emphasis> " +"release the underlying database cursor by calling <literal>ScrollableResults." +"close()</literal> or <literal>Hibernate.close(Iterator)</literal> explicitly " +"from a <literal>finally</literal> block. Most applications can easily avoid " +"using <literal>scroll()</literal> or <literal>iterate()</literal> from the " +"JTA or CMT code.)" +msgstr "" +"Der <literal>getCurrentSession()</literal>-Vorgang hat einen Nachteil in " +"einer JTA-Umgebung. Es gibt eine Einschränkung hinsichtlich der Verwendung " +"des <literal>after_statement</literal>-Verbindungsfreigabemodus, der dann im " +"Standard benutzt wird. Aufgrund einer Beschränkung der JTA-Spezifikation, " +"ist es Hibernate nicht möglich, ungeschlossene <literal>ScrollableResults</" +"literal> oder <literal>Iterator</literal>-Instanzen, die durch " +"<literal>scroll()</literal> oder <literal>iterate()</literal> erhalten " +"wurden, automatisch zu bereinigen. Sie <emphasis>müssen</emphasis> den zu " +"Grunde liegenden Datenbank-Cursor durch Aufruf von " +"<literal>ScrollableResults.close()</literal> oder <literal>Hibernate.close" +"(Iterator)</literal> explizit von einem <literal>finally</literal>-Block " +"freigeben. (Natürlich können die meisten Anwendungen leicht die Verwendung " +"von <literal>scroll()</literal> oder <literal>iterate()</literal> vom JTA- " +"oder CMT-Code vermeiden)." + +#. Tag: title +#, no-c-format +msgid "Exception handling" +msgstr "Der Umgang mit Ausnahmen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If the <literal>Session</literal> throws an exception, including any " +"<literal>SQLException</literal>, immediately rollback the database " +"transaction, call <literal>Session.close()</literal> and discard the " +"<literal>Session</literal> instance. Certain methods of <literal>Session</" +"literal> will <emphasis>not</emphasis> leave the session in a consistent " +"state. No exception thrown by Hibernate can be treated as recoverable. " +"Ensure that the <literal>Session</literal> will be closed by calling " +"<literal>close()</literal> in a <literal>finally</literal> block." +msgstr "" +"Falls die <literal>Session</literal> eine Ausnahme meldet (einschließlich " +"<literal>SQLException</literal>), sollten Sie sofort einen Rollback der " +"Datenbanktransaktion durchführen, <literal>Session.close()</literal> " +"aufrufen und die <literal>Session</literal> verwerfen. Bestimmte Methoden " +"von <literal>Session</literal> werden die Session <emphasis>nicht</emphasis> " +"in konsistentem Zustand lassen. Keine von Hibernate gemeldete Ausnahme kann " +"als wiederherstellbar betrachtet werden. Vergewissern Sie sich, dass die " +"<literal>Session</literal> durch Aufruf von <literal>close()</literal> in " +"einem <literal>finally</literal> Block geschlossen wird." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>HibernateException</literal>, which wraps most of the errors " +"that can occur in a Hibernate persistence layer, is an unchecked exception. " +"It was not in older versions of Hibernate. In our opinion, we should not " +"force the application developer to catch an unrecoverable exception at a low " +"layer. In most systems, unchecked and fatal exceptions are handled in one of " +"the first frames of the method call stack (i.e., in higher layers) and " +"either an error message is presented to the application user or some other " +"appropriate action is taken. Note that Hibernate might also throw other " +"unchecked exceptions that are not a <literal>HibernateException</literal>. " +"These are not recoverable and appropriate action should be taken." +msgstr "" +"Bei der <literal>HibernateException</literal>, die die meisten Fehler " +"abdeckt, die innerhalb einer Persistenzschicht Hibernates vorkommen können, " +"handelt es sich um eine ungeprüfte Ausnahme (in älteren Versionen von " +"Hibernate war sie das nicht). Unserer Ansicht nach sollte der " +"Anwendungsentwickler nicht gezwungen sein, eine nicht wiederherstellbare " +"Ausnahme in einer tiefen Schicht abzufangen. In den meisten Systemen werden " +"ungeprüfte und schwere Ausnahmefehler in einem der ersten Rahmen des " +"Methodenaufrufstapels bearbeitet (d.h. in höheren Schichten) und eine " +"Fehlernachricht wird dem Anwendungsbenutzer gemeldet (oder eine andere " +"passende Vorgehensweise wird unternommen). Bitte beachten Sie, dass " +"Hibernate auch andere ungeprüfte Ausnahmen melden kann, bei denen es sich " +"nicht um <literal>HibernateException</literal> handelt. Auch diese sind " +"nicht wiederherstellbar, und es sollten die entsprechenden Maßnahmen " +"ergriffen werden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate wraps <literal>SQLException</literal>s thrown while interacting " +"with the database in a <literal>JDBCException</literal>. In fact, Hibernate " +"will attempt to convert the exception into a more meaningful subclass of " +"<literal>JDBCException</literal>. The underlying <literal>SQLException</" +"literal> is always available via <literal>JDBCException.getCause()</" +"literal>. Hibernate converts the <literal>SQLException</literal> into an " +"appropriate <literal>JDBCException</literal> subclass using the " +"<literal>SQLExceptionConverter</literal> attached to the " +"<literal>SessionFactory</literal>. By default, the " +"<literal>SQLExceptionConverter</literal> is defined by the configured " +"dialect. However, it is also possible to plug in a custom implementation. " +"See the javadocs for the <literal>SQLExceptionConverterFactory</literal> " +"class for details. The standard <literal>JDBCException</literal> subtypes " +"are:" +msgstr "" +"Hibernate wrappt <literal>SQLException</literal>s, die während der " +"Interaktion mit der Datenbank gemeldet werden in eine " +"<literal>JDBCException</literal>. Hibernate wird auch versuchen, die " +"Ausnahme in eine sinnvollere Subklasse von <literal>JDBCException</literal> " +"zu konvertieren. Die zu Grunde liegende <literal>SQLException</literal> ist " +"mittels <literal>JDBCException.getCause()</literal> immer verfügbar. " +"Hibernate konvertiert die <literal>SQLException</literal> in eine " +"entsprechende <literal>JDBCException</literal>-Subklasse, indem es den der " +"<literal>SessionFactory</literal> zugehörigen " +"<literal>SQLExceptionConverter</literal> verwendet. In der " +"Standardeinstellung ist der <literal>SQLExceptionConverter</literal> durch " +"den konfigurierten Dialekt definiert, es ist jedoch auch möglich, eine " +"anwenderdefinierte Implementierung anzuschließen (siehe Javadocs zu " +"<literal>SQLExceptionConverterFactory</literal>-Klasse für Einzelheiten). " +"Die Standard <literal>JDBCException</literal>-Untertypen sind:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>JDBCConnectionException</literal>: indicates an error with the " +"underlying JDBC communication." +msgstr "" +"<literal>JDBCConnectionException</literal> - zeigt einen Fehler mit der zu " +"Grunde liegenden JDBC-Kommunikation an." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>SQLGrammarException</literal>: indicates a grammar or syntax " +"problem with the issued SQL." +msgstr "" +"<literal>SQLGrammarException</literal> - zeigt ein grammatisches oder " +"syntaktisches Problem mit der herausgegebenen SQL an." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>ConstraintViolationException</literal>: indicates some form of " +"integrity constraint violation." +msgstr "" +"<literal>ConstraintViolationException</literal> - zeigt eine Form von " +"Verletzung der Integritätsbedingung an." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>LockAcquisitionException</literal>: indicates an error acquiring a " +"lock level necessary to perform the requested operation." +msgstr "" +"<literal>LockAcquisitionException</literal> - zeigt einen Fehler bei der " +"Ermittlung der für den angefragten Vorgang erforderlichen Sperrebene (sog. " +"\"Lock Level\") an." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>GenericJDBCException</literal>: a generic exception which did not " +"fall into any of the other categories." +msgstr "" +"<literal>GenericJDBCException</literal> - eine generische Ausnahme, die " +"unter keine der anderen Kategorien fällt." + +#. Tag: title +#, no-c-format +msgid "Transaction timeout" +msgstr "Transaktions-Timeout" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"An important feature provided by a managed environment like EJB, that is " +"never provided for non-managed code, is transaction timeout. Transaction " +"timeouts ensure that no misbehaving transaction can indefinitely tie up " +"resources while returning no response to the user. Outside a managed (JTA) " +"environment, Hibernate cannot fully provide this functionality. However, " +"Hibernate can at least control data access operations, ensuring that " +"database level deadlocks and queries with huge result sets are limited by a " +"defined timeout. In a managed environment, Hibernate can delegate " +"transaction timeout to JTA. This functionality is abstracted by the " +"Hibernate <literal>Transaction</literal> object." +msgstr "" +"Ein sehr wichtiges Feature, das durch eine gemanagte Umgebung wie EJB " +"geliefert wird und das für nicht-gemanagten Code nicht verfügbar ist, ist " +"der Transaktions-Timeout. Transaktions-Timeouts stellen sicher, dass eine " +"nicht ordnungsgemäß laufende Transaktion nicht endlos Ressources vergeuden " +"kann, während der Benutzer auf Antwort wartet. Außerhalb einer gemanagten " +"(JTA) Umgebung, kann Hibernate diese Funktionalität nicht in vollem Umfang " +"gewährleisten. Jedoch kann Hibernate zumindest Datenzugriffsvorgänge steuern " +"und sicherstellen, dass Deadlocks auf Datenbankebene und Anfragen mit sehr " +"großen Ergebnissätzen durch einen definierten Timeout eingeschränkt werden. " +"In einer gemanagten Umgebung kann Hibernate den Transaktions-Timeout an JTA " +"übertragen. Diese Funktionalität wird durch das Hibernate " +"<literal>Transaction</literal>-Objekt abstrahiert." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>setTimeout()</literal> cannot be called in a CMT bean, where " +"transaction timeouts must be defined declaratively." +msgstr "" +"Beachten Sie, dass <literal>setTimeout()</literal> nicht in einem CMT-Bean " +"aufgerufen werden kann, in dem Transaktions-Timeouts deklarativ definiert " +"sein müssen." + +#. Tag: title +#, no-c-format +msgid "Optimistic concurrency control" +msgstr "Optimistische Nebenläufigkeitskontrolle" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The only approach that is consistent with high concurrency and high " +"scalability, is optimistic concurrency control with versioning. Version " +"checking uses version numbers, or timestamps, to detect conflicting updates " +"and to prevent lost updates. Hibernate provides three possible approaches to " +"writing application code that uses optimistic concurrency. The use cases we " +"discuss are in the context of long conversations, but version checking also " +"has the benefit of preventing lost updates in single database transactions." +msgstr "" +"Die einzige, mit hoher Nebenläufigkeit und hoher Skalierbarkeit konsistente " +"Vorgehensweise ist die optimistische Nebenläufigkeitskontrolle mit " +"Versionierung. Die Versionsprüfung verwendet Versionsnummern oder " +"Zeitstempel (sog. \"Timestamps\"), um widersprüchliche Aktualisierungen " +"aufzuspüren (und um verlorenen Aktualisierungen vorzubeugen). Hibernate " +"bietet drei mögliche Vorgehensweisen für das Schreiben eines " +"Anwendungscodes, der optimistische Nebenläufigkeit verwendet. Die von uns " +"dargestellten Anwendungsfälle sind für den Kontext langer Konversationen, " +"jedoch bietet die Versionsprüfung auch den Vorteil bei einzelnen " +"Datenbanktransaktionen verlorenen Aktualisierungen vorzubeugen." + +#. Tag: title +#, no-c-format +msgid "Application version checking" +msgstr "Kontrolle der Anwendungsversion" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"In an implementation without much help from Hibernate, each interaction with " +"the database occurs in a new <literal>Session</literal> and the developer is " +"responsible for reloading all persistent instances from the database before " +"manipulating them. The application is forced to carry out its own version " +"checking to ensure conversation transaction isolation. This approach is the " +"least efficient in terms of database access. It is the approach most similar " +"to entity EJBs." +msgstr "" +"Bei einer Implementierung ohne große Hilfe von Hibernate erfolgt jede " +"Interaktion mit der Datenbank in einer neuen <literal>Session</literal>, und " +"es ist die Verantwortung des Entwicklers alle persistenten Instanzen aus der " +"Datenbank erneut zu laden ehe diese verändert werden. Durch diese " +"Vorgehensweise wird die Anwendung dazu gezwungen, ihre eigene " +"Versionsprüfung durchzuführen, um die Transaktionsisolation der Konversation " +"sicherzustellen. Im Hinblick auf Datenbankzugriff ist diese Herangehensweise " +"die am wenigsten effiziente, ähnelt jedoch am meisten den Entity-EJBs." + +#. Tag: para +#, no-c-format +msgid "" +"The <literal>version</literal> property is mapped using <literal><" +"version></literal>, and Hibernate will automatically increment it during " +"flush if the entity is dirty." +msgstr "" +"Die <literal>version</literal>-Property wird unter Verwendung von " +"<literal><version></literal> gemappt, und Hibernate wird diese während " +"des Räumens automatisch inkrementieren, falls die Entity aufgrund eines " +"Zugriffs als \"dirty\" erkannt wird." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If you are operating in a low-data-concurrency environment, and do not " +"require version checking, you can use this approach and skip the version " +"check. In this case, <emphasis>last commit wins</emphasis> is the default " +"strategy for long conversations. Be aware that this might confuse the users " +"of the application, as they might experience lost updates without error " +"messages or a chance to merge conflicting changes." +msgstr "" +"Falls Sie jedoch in einer Umgebung mit geringer Daten-Nebenläufigkeit " +"arbeiten und keine Versionsprüfung benötigen, so können Sie diese " +"Vorgehensweise verwenden und die Versionsprüfung einfach überspringen. In " +"diesem Fall <emphasis>gilt die letzte Festschreibung</emphasis>, und dies " +"ist die Standadrd-Strategie für lange Konversationen. Seien Sie sich der " +"Tatsache bewusst, dass dies die Benutzer der Anwendung verwirren wird, da es " +"zu verlorenen Aktualisierungen ohne Fehlermeldungen oder der Möglichkeit des " +"Mischens widersprüchlicher Änderungen kommen kann." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Manual version checking is only feasible in trivial circumstances and not " +"practical for most applications. Often not only single instances, but " +"complete graphs of modified objects, have to be checked. Hibernate offers " +"automatic version checking with either an extended <literal>Session</" +"literal> or detached instances as the design paradigm." +msgstr "" +"Die manuelle Versionsprüfung ist nur unter sehr trivialen Umständen machbar " +"und bei den meisten Anwendungen nicht brauchbar. Oft müssen nicht nur " +"einzelne Instanzen, sondern vollständige Diagramme geänderter Objekte " +"überprüft werden. Hibernate bietet eine automatische Versionsprüfung mittels " +"entweder einer erweiterten <literal>Session</literal> oder abgesetzter " +"Instanzen als Entwurfsmuster." + +#. Tag: title +#, no-c-format +msgid "Extended session and automatic versioning" +msgstr "Erweiterte Session und automatische Versionierung" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A single <literal>Session</literal> instance and its persistent instances " +"that are used for the whole conversation are known as <emphasis>session-per-" +"conversation</emphasis>. Hibernate checks instance versions at flush time, " +"throwing an exception if concurrent modification is detected. It is up to " +"the developer to catch and handle this exception. Common options are the " +"opportunity for the user to merge changes or to restart the business " +"conversation with non-stale data." +msgstr "" +"Eine einzelne <literal>Session</literal>-Instanz und deren persistente " +"Instanzen werden für die gesamte Konversation verwendet, was als " +"<emphasis>Session-per-Konversation</emphasis> (sog. \"Session-per-" +"Conversation\") bekannt ist. Hibernate prüft zum Zeitpunkt der Räumung die " +"Versionen der Instanz und meldet eine Ausnahme wenn nebenläufige " +"Modifikationen aufgespürt werden. Dem Entwickler bleibt das Auffinden und " +"Bearbeiten dieser Ausnahme überlassen (gängige Optionen sind die Möglichkeit " +"des Benutzers, Veränderungen zu mischen oder die Business-Konversation mit " +"nicht veralteten Daten erneut zu starten)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>Session</literal> is disconnected from any underlying JDBC " +"connection when waiting for user interaction. This approach is the most " +"efficient in terms of database access. The application does not version " +"check or reattach detached instances, nor does it have to reload instances " +"in every database transaction." +msgstr "" +"Die <literal>Session</literal> wird von einer zu Grunde liegenden JDBC-" +"Verbindung gelöst, wenn Sie auf Benutzerinteraktion wartet. Hinsichtlich des " +"Datenbankzugriffs ist diese Vorgehensweise die effizienteste. Die Anwendung " +"muss sich weder um Versionsprüfung oder um die Wiederanbindung abgesetzter " +"Instanzen, noch um das erneute Laden von Instanzen in jeder " +"Datenbanktransaktion kümmern." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>foo</literal> object knows which <literal>Session</literal> it " +"was loaded in. Beginning a new database transaction on an old session " +"obtains a new connection and resumes the session. Committing a database " +"transaction disconnects a session from the JDBC connection and returns the " +"connection to the pool. After reconnection, to force a version check on data " +"you are not updating, you can call <literal>Session.lock()</literal> with " +"<literal>LockMode.READ</literal> on any objects that might have been updated " +"by another transaction. You do not need to lock any data that you " +"<emphasis>are</emphasis> updating. Usually you would set <literal>FlushMode." +"MANUAL</literal> on an extended <literal>Session</literal>, so that only the " +"last database transaction cycle is allowed to actually persist all " +"modifications made in this conversation. Only this last database transaction " +"will include the <literal>flush()</literal> operation, and then " +"<literal>close()</literal> the session to end the conversation." +msgstr "" +"Das <literal>foo</literal>-Objekt weiß nach wie vor in welcher " +"<literal>Session</literal> es geladen wurde. Beim Start einer neuen " +"Datenbanktransaktion an einer alten Session wird eine neue Verbindung " +"aufgebaut und die Session fortgesetzt. Das Festschreiben einer " +"Datenbanktransaktion löst die Verbindung einer Session von der JDBC-" +"Verbindung und sendet die Verbindung zurück an den Pool. Nach der erneuten " +"Verbindung können Sie eine Versionsprüfung an nicht zu aktualisierenden " +"Daten vornehmen, indem Sie <literal>Session.lock()</literal> mit " +"<literal>LockMode.READ</literal> an sämtlichen Objekten aufrufen, die durch " +"eine andere Transaktion hätten aktualisiert werden können. Sie müssen keine " +"Daten sperren, die aktualisiert <emphasis>werden</emphasis>. Normalerweise " +"würden Sie <literal>FlushMode.NEVER</literal> an einer erweiterten " +"<literal>Session</literal> einstellen, damit nur der letzte Zyklus der " +"Datenbanktransaktion sämtliche in der Konversation vorgenommene " +"Modifikationen persistieren kann. Daher würde nur die letzte " +"Datenbanktransaktion den <literal>flush()</literal>-Vorgang beinhalten und " +"würde auch durch Schließen der Session mittels <literal>close()</literal> " +"die Konversation beenden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This pattern is problematic if the <literal>Session</literal> is too big to " +"be stored during user think time (for example, an <literal>HttpSession</" +"literal> should be kept as small as possible). As the <literal>Session</" +"literal> is also the first-level cache and contains all loaded objects, we " +"can probably use this strategy only for a few request/response cycles. Use a " +"<literal>Session</literal> only for a single conversation as it will soon " +"have stale data." +msgstr "" +"Dieses Muster ist problematisch, wenn die <literal>Session</literal> zu groß " +"ist, um während der Benutzer \"Think Time\" gespeichert zu werden; eine " +"<literal>HttpSession</literal> etwa sollte so klein wie möglich gehalten " +"werden. Da die <literal>Session</literal> auch der (obligatorische) " +"Cachespeicher der ersten Ebene ist und sämtliche geladenen Objekte enthält, " +"kann diese Strategie wahrscheinlich nur für ein paar Anfragen/Antworten-" +"Zyklen verwendet werden. Sie sollten eine <literal>Session</literal> nur für " +"eine einzelne Konversation verwenden, da diese recht bald veraltete Daten " +"enthält." + +#. Tag: title +#, no-c-format +msgid "Note" +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Earlier versions of Hibernate required explicit disconnection and " +"reconnection of a <literal>Session</literal>. These methods are deprecated, " +"as beginning and ending a transaction has the same effect." +msgstr "" +"(Beachten Sie, dass frühere Versionen von Hibernate die explizite " +"Verbindungsunterbrechung und erneute Verbindung einer <literal>Session</" +"literal> erforderten. Diese Methoden wurden verworfen, da das Starten und " +"Beenden einer Transaktion diesselbe Wirkung hat)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Keep the disconnected <literal>Session</literal> close to the persistence " +"layer. Use an EJB stateful session bean to hold the <literal>Session</" +"literal> in a three-tier environment. Do not transfer it to the web layer, " +"or even serialize it to a separate tier, to store it in the " +"<literal>HttpSession</literal>." +msgstr "" +"Sie sollten außerdem darauf achten, dass die unterbrochene <literal>Session</" +"literal> nahe der Persistenschicht verbleibt. Mit anderen Worten, verwenden " +"Sie ein EJB-\"Stateful-Session-Bean\", um die <literal>Session</literal> in " +"einer Three-Tier-Umgebung zu halten und diese nicht in die Webschicht zu " +"transferieren (oder sogar zu einem separaten Tier zu serialisieren) und in " +"der <literal>HttpSession</literal> zu speichern." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The extended session pattern, or <emphasis>session-per-conversation</" +"emphasis>, is more difficult to implement with automatic current session " +"context management. You need to supply your own implementation of the " +"<literal>CurrentSessionContext</literal> for this. See the Hibernate Wiki " +"for examples." +msgstr "" +"Das erweiterte Session-Muster oder <emphasis>Session-per-Konversation</" +"emphasis> ist schwieriger mit automatischem Kontextmanagement der aktuellen " +"Session zu implementieren. Sie müssen Ihre eigene Implementierung des " +"<literal>CurrentSessionContext</literal> dafür bereitstellen, Beispiele " +"finden Sie im Hibernate Wiki." + +#. Tag: title +#, no-c-format +msgid "Detached objects and automatic versioning" +msgstr "Abgesetzte Objekte und automatische Versionierung" + +#. Tag: para +#, no-c-format +msgid "" +"Each interaction with the persistent store occurs in a new <literal>Session</" +"literal>. However, the same persistent instances are reused for each " +"interaction with the database. The application manipulates the state of " +"detached instances originally loaded in another <literal>Session</literal> " +"and then reattaches them using <literal>Session.update()</literal>, " +"<literal>Session.saveOrUpdate()</literal>, or <literal>Session.merge()</" +"literal>." +msgstr "" +"Jede Interaktion mit dem persistenten Speicher geschieht in einer neuen " +"<literal>Session</literal>. Allerdings werden dieselben persistenten " +"Instanzen für jede Interaktion mit der Datenbank wiederverwendet. Die " +"Anwendung manipuliert den Status der abgesetzten Instanzen, die ursprünglich " +"in einer anderen <literal>Session</literal> geladen wurden und fügt diese " +"mittels <literal>Session.update()</literal>, <literal>Session.saveOrUpdate()" +"</literal> oder <literal>Session.merge()</literal> erneut hinzu." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Again, Hibernate will check instance versions during flush, throwing an " +"exception if conflicting updates occurred." +msgstr "" +"Auch hier prüft Hibernate die Versionen der Instanz während der Räumung und " +"meldet eine Ausnahme, wenn widersprüchlich Aktualisierungen erfolgt sind." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can also call <literal>lock()</literal> instead of <literal>update()</" +"literal>, and use <literal>LockMode.READ</literal> (performing a version " +"check and bypassing all caches) if you are sure that the object has not been " +"modified." +msgstr "" +"Sie können auch <literal>lock()</literal> statt <literal>update()</literal> " +"aufrufen und <literal>LockMode.READ</literal> verwenden (unter Umgehung " +"aller Caches eine Versionsprüfung durchführend) falls Sie sicher sind, dass " +"keine Änderungen am Objekt vorgenommen wurden." + +#. Tag: title +#, no-c-format +msgid "Customizing automatic versioning" +msgstr "Anpassung der automatischen Versionierung " + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can disable Hibernate's automatic version increment for particular " +"properties and collections by setting the <literal>optimistic-lock</literal> " +"mapping attribute to <literal>false</literal>. Hibernate will then no longer " +"increment versions if the property is dirty." +msgstr "" +"Sie können Hibernates automatische Versionserhöhung für bestimmte Properties " +"und Collections deaktivieren, indem Sie das <literal>optimistic-lock</" +"literal>-Mapping-Attribut auf <literal>false</literal> setzen. Hibernate " +"wird dann selbst bei einem Zugriff auf die Property die Versionsnummer nicht " +"mehr erhöhen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Legacy database schemas are often static and cannot be modified. Or, other " +"applications might access the same database and will not know how to handle " +"version numbers or even timestamps. In both cases, versioning cannot rely on " +"a particular column in a table. To force a version check with a comparison " +"of the state of all fields in a row but without a version or timestamp " +"property mapping, turn on <literal>optimistic-lock=\"all\"</literal> in the " +"<literal><class></literal> mapping. This conceptually only works if " +"Hibernate can compare the old and the new state (i.e., if you use a single " +"long <literal>Session</literal> and not session-per-request-with-detached-" +"objects)." +msgstr "" +"Datenbankschemas von Stammdaten sind oftmals statisch und können nicht " +"verändert werden. Oder andere Anwendungen könnten auf dieselbe Datenbank " +"zugreifen und nicht wissen wie mit Versionsnummern und Zeitstempeln " +"umzugehen ist. In beiden Fällen kann sich die Versionierung nicht auf eine " +"bestimmte Tabellenspalte stützen. Um eine Versionsprüfung ohne Mapping der " +"Versions- oder Zeitstempel-Property zu erzwingen und einen Statusvergleich " +"sämtlicher Felder einer Reihe zu erhalten, stellen Sie <literal>optimistic-" +"lock=\"all\"</literal> im <literal><class></literal>-Mapping ein. " +"Bitte beachten Sie, dass dies nur funktioniert, wenn Hibernate den alten und " +"neuen Status vergleichen kann, d.h. wenn Sie eine einzelne, lange " +"<literal>Session</literal> und nicht Session-pro-Anfrage-mit-abgesetzten-" +"Objekten (\"session-per-request-with-detached-objects\") verwenden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Concurrent modification can be permitted in instances where the changes that " +"have been made do not overlap. If you set <literal>optimistic-lock=\"dirty" +"\"</literal> when mapping the <literal><class></literal>, Hibernate " +"will only compare dirty fields during flush." +msgstr "" +"Manchmal kann eine gleichzeitige Modifikation gestattet werden, so lange die " +"vorgenommenen Änderungen sich nicht überschneiden. Wenn Sie " +"<literal>optimistic-lock=\"dirty\"</literal> beim Mappen der <literal><" +"class></literal> einstellen, so wird Hibernate zum Zeitpunkt der Räumung " +"nur Felder vergleichen, auf die zugegriffen wurde." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"In both cases, with dedicated version/timestamp columns or with a full/dirty " +"field comparison, Hibernate uses a single <literal>UPDATE</literal> " +"statement, with an appropriate <literal>WHERE</literal> clause, per entity " +"to execute the version check and update the information. If you use " +"transitive persistence to cascade reattachment to associated entities, " +"Hibernate may execute unnecessary updates. This is usually not a problem, " +"but <emphasis>on update</emphasis> triggers in the database might be " +"executed even when no changes have been made to detached instances. You can " +"customize this behavior by setting <literal>select-before-update=\"true\"</" +"literal> in the <literal><class></literal> mapping, forcing Hibernate " +"to <literal>SELECT</literal> the instance to ensure that changes did occur " +"before updating the row." +msgstr "" +"In beiden Fällen, also mit erklärten Versions-/Zeitstempelspalten oder mit " +"\"full/dirty\"-Feldvergleich, verwendet Hibernate eine einzelne " +"<literal>UPDATE</literal>-Anweisung (mit entsprechender <literal>WHERE</" +"literal>-Klausel) pro Entity, die die Versionsprüfung ausführen und die " +"Informationen aktualisieren soll. Falls Sie transitive Persistenz anwenden, " +"um die Wiederanbindung an assoziierte Entities weiterzugeben, ist es " +"möglich, dass Hibernate unnötige Aktualisierungen durchführt. In der Regel " +"ist das kein Problem, aber <emphasis>\"On-Update\"</emphasis>-Trigger in der " +"Datenbank könnten ausgeführt werden, selbst wenn keine Änderungen an den " +"abgesetzten Instanzen vorgenommen wurden. Sie können dieses Verhalten " +"anpassen, indem Sie <literal>select-before-update=\"true\"</literal> im " +"<literal><class></literal>-Mapping einstellen, so dass Hibernate " +"<literal>SELECT</literal> für die Instanz einsetzen muss, damit " +"sichergestellt wird, dass tatsächlich Änderungen vorgenommen wurden ehe die " +"Reihe aktualisiert wird." + +#. Tag: title +#, fuzzy, no-c-format +msgid "Pessimistic locking" +msgstr "Pessimistisches Sperren" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"It is not intended that users spend much time worrying about locking " +"strategies. It is usually enough to specify an isolation level for the JDBC " +"connections and then simply let the database do all the work. However, " +"advanced users may wish to obtain exclusive pessimistic locks or re-obtain " +"locks at the start of a new transaction." +msgstr "" +"Der Benutzer sollte sich nicht viele Gedanken um Sperrstrategien machen " +"müssen. In der Regel reicht es aus, eine Isolationsebene für die JDBC-" +"Verbindungen zu bestimmen und dann der Datenbank die restliche Arbeit zu " +"überlassen. Erfahrene Benutzer möchten manchmal exklusive pessimistische " +"Sperren haben oder Sperren zu Beginn einer neuen Transaktion erneut erhalten." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate will always use the locking mechanism of the database; it never " +"lock objects in memory." +msgstr "" +"Hibernate wird stets den Sperrmechanismus der Datenbank verwenden und " +"niemals Objekte im Speicher sperren!" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>LockMode</literal> class defines the different lock levels that " +"can be acquired by Hibernate. A lock is obtained by the following mechanisms:" +msgstr "" +"Die <literal>LockMode</literal>-Klasse definiert die unterschiedlichen " +"Sperrebenen, die Hibernate erlangen kann. Eine Sperre wird durch die " +"folgenden Mechanismen erlangt:" + +#. Tag: para +#, no-c-format +msgid "" +"<literal>LockMode.WRITE</literal> is acquired automatically when Hibernate " +"updates or inserts a row." +msgstr "" +"<literal>LockMode.WRITE</literal> wird automatisch erlangt, wenn Hibernate " +"eine Reihe aktualisiert oder einfügt." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>LockMode.UPGRADE</literal> can be acquired upon explicit user " +"request using <literal>SELECT ... FOR UPDATE</literal> on databases which " +"support that syntax." +msgstr "" +"<literal>LockMode.UPGRADE</literal> wird durch explizite Benutzeranfrage " +"mittels Verwendung von <literal>SELECT ... FOR UPDATE</literal> bei diese " +"Syntax unterstützenden Datenbanken erhalten." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>LockMode.UPGRADE_NOWAIT</literal> can be acquired upon explicit " +"user request using a <literal>SELECT ... FOR UPDATE NOWAIT</literal> under " +"Oracle." +msgstr "" +"<literal>LockMode.UPGRADE_NOWAIT</literal> wird durch explizite " +"Benutzeranfrage mittels Verwendung von <literal>SELECT ... FOR UPDATE " +"NOWAIT</literal> in Oracle erhalten." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>LockMode.READ</literal> is acquired automatically when Hibernate " +"reads data under Repeatable Read or Serializable isolation level. It can be " +"re-acquired by explicit user request." +msgstr "" +"<literal>LockMode.READ</literal> erfolgt automatisch, wenn Hibernate Daten " +"unter \"Repeatable Read\" oder \"Serializable\" Isolationsebene liest. Kann " +"durch explizite Benutzeranfrage erneut erhalten werden." + +#. Tag: para +#, no-c-format +msgid "" +"<literal>LockMode.NONE</literal> represents the absence of a lock. All " +"objects switch to this lock mode at the end of a <literal>Transaction</" +"literal>. Objects associated with the session via a call to <literal>update()" +"</literal> or <literal>saveOrUpdate()</literal> also start out in this lock " +"mode." +msgstr "" +"<literal>LockMode.NONE</literal> repräsentiert das Fehlen einer Sperre. Alle " +"Objekte wechseln am Ende einer <literal>Transaction</literal> in diesen " +"Sperrmodus. Objekte, die durch Aufruf von <literal>update()</literal> oder " +"<literal>saveOrUpdate()</literal> der Session zugeordnet werden, starten " +"ebenfalls in diesem Sperrmodus." + +#. Tag: para +#, no-c-format +msgid "" +"The \"explicit user request\" is expressed in one of the following ways:" +msgstr "" +"Die \"explizite Benutzeranfrage\" wird auf eine der folgenden Arten " +"ausgedrückt:" + +#. Tag: para +#, no-c-format +msgid "" +"A call to <literal>Session.load()</literal>, specifying a <literal>LockMode</" +"literal>." +msgstr "" +"Ein Aufruf an <literal>Session.load()</literal>, der einen " +"<literal>LockMode</literal> bestimmt." + +#. Tag: para +#, no-c-format +msgid "A call to <literal>Session.lock()</literal>." +msgstr "Ein Aufruf an <literal>Session.lock()</literal>." + +#. Tag: para +#, no-c-format +msgid "A call to <literal>Query.setLockMode()</literal>." +msgstr "Ein Aufruf an <literal>Query.setLockMode()</literal>." + +#. Tag: para +#, no-c-format +msgid "" +"If <literal>Session.load()</literal> is called with <literal>UPGRADE</" +"literal> or <literal>UPGRADE_NOWAIT</literal>, and the requested object was " +"not yet loaded by the session, the object is loaded using " +"<literal>SELECT ... FOR UPDATE</literal>. If <literal>load()</literal> is " +"called for an object that is already loaded with a less restrictive lock " +"than the one requested, Hibernate calls <literal>lock()</literal> for that " +"object." +msgstr "" +"Falls <literal>Session.load()</literal> mit <literal>UPGRADE</literal> oder " +"<literal>UPGRADE_NOWAIT</literal> aufgerufen wird und das angefragte Objekt " +"bis jetzt noch nicht durch die Session geladen wurde, so wird das Objekt " +"unter Verwendung von <literal>SELECT ... FOR UPDATE</literal> geladen. Falls " +"<literal>load()</literal> für ein bereits mit weniger restriktiver Sperre " +"geladenes Objekt als das angefragte aufgerufen wird, so ruft Hibernate " +"<literal>lock()</literal> für das Objekt auf." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>Session.lock()</literal> performs a version number check if the " +"specified lock mode is <literal>READ</literal>, <literal>UPGRADE</literal> " +"or <literal>UPGRADE_NOWAIT</literal>. In the case of <literal>UPGRADE</" +"literal> or <literal>UPGRADE_NOWAIT</literal>, <literal>SELECT ... FOR " +"UPDATE</literal> is used." +msgstr "" +"<literal>Session.lock()</literal> führt eine Versionsnummernprüfung durch, " +"falls der spezifizierte Sperrmodus <literal>READ</literal>, " +"<literal>UPGRADE</literal> oder <literal>UPGRADE_NOWAIT</literal> lautet. " +"(Im Fall von <literal>UPGRADE</literal> oder <literal>UPGRADE_NOWAIT</" +"literal> wird <literal>SELECT ... FOR UPDATE</literal> verwendet)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If the requested lock mode is not supported by the database, Hibernate uses " +"an appropriate alternate mode instead of throwing an exception. This ensures " +"that applications are portable." +msgstr "" +"Falls die Datenbank den gewünschten Sperrmodus nicht unterstützt, verwendet " +"Hibernate einen entsprechenden Alternativmodus (statt eine Ausnahme zu " +"melden). Dadurch wird gewährleistet, dass Anwendungen übertragbar sind." + +#. Tag: title +#, fuzzy, no-c-format +msgid "Connection release modes" +msgstr "Die Modi der Verbindungsfreigabe" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"One of the legacies of Hibernate 2.x JDBC connection management meant that a " +"<literal>Session</literal> would obtain a connection when it was first " +"required and then maintain that connection until the session was closed. " +"Hibernate 3.x introduced the notion of connection release modes that would " +"instruct a session how to handle its JDBC connections. The following " +"discussion is pertinent only to connections provided through a configured " +"<literal>ConnectionProvider</literal>. User-supplied connections are outside " +"the breadth of this discussion. The different release modes are identified " +"by the enumerated values of <literal>org.hibernate.ConnectionReleaseMode</" +"literal>:" +msgstr "" +"Das Legacy (2.x) Verhalten von Hibernate hinsichtlich der Verwaltung von " +"JDBC-Verbindungen war, dass eine <literal>Session</literal> eine Verbindung " +"dann erhalten würde, wenn diese das erste Mal gebraucht wurde und diese " +"Verbindung dann bis zur Schließung der Session gehalten wurde. Mit Hibernate " +"3.x wurde der Begriff von Verbindungsfreigabe-Modi eingeführt, durch die " +"einer Session mitgeteilt wird, wie ihre JDBC-Verbindungen zu handhaben sind. " +"Bitte beachten Sie, dass die folgende Erörterung sich nur auf Verbindungen " +"bezieht, die mittels <literal>ConnectionProvider</literal> konfiguriert " +"sind; durch den Benutzer bereitgestellte Verbindungen liegen außerhalb der " +"hier erläuterten Thematik. Die unterschiedlichen Freigabe-Modi werden durch " +"die aufgezählten Werte von <literal>org.hibernate.ConnectionReleaseMode</" +"literal> identifiziert:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>ON_CLOSE</literal>: is the legacy behavior described above. The " +"Hibernate session obtains a connection when it first needs to perform some " +"JDBC access and maintains that connection until the session is closed." +msgstr "" +"<literal>ON_CLOSE</literal> - ist im Wesentlichen das oben beschriebene " +"Legacy-Verhalten. Die Hibernate Session erhält eine Verbindung, wenn sie " +"erstmals einen JDBC-Zugriff durchführen muss und hält diese Verbindung bis " +"zur Schließung der Session." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>AFTER_TRANSACTION</literal>: releases connections after a " +"<literal>org.hibernate.Transaction</literal> has been completed." +msgstr "" +"<literal>AFTER_TRANSACTION</literal> - teilt mit, dass Verbindungen nach " +"Beendigung einer <literal>org.hibernate.Transaction</literal> freigegeben " +"werden sollen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>AFTER_STATEMENT</literal> (also referred to as aggressive release): " +"releases connections after every statement execution. This aggressive " +"releasing is skipped if that statement leaves open resources associated with " +"the given session. Currently the only situation where this occurs is through " +"the use of <literal>org.hibernate.ScrollableResults</literal>." +msgstr "" +"<literal>AFTER_STATEMENT</literal> (auch als \"aggressive release\" oder " +"aggressive Freigabe bekannt) - teilt mit, dass Verbindungen nach Ausführung " +"jeder einzelnen Anweisung freigegeben werden sollen. Diese Art der " +"aggressiven Freigabe wird übersprungen, wenn die Anweisung offene Ressourcen " +"zurücklässt, die mit der gegebenen Session assoziiert werden; momentan ist " +"der einzige Fall, bei dem dies eintritt, mittels Verwendung von <literal>org." +"hibernate.ScrollableResults</literal>." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The configuration parameter <literal>hibernate.connection.release_mode</" +"literal> is used to specify which release mode to use. The possible values " +"are as follows:" +msgstr "" +"Der Konfigurationsparameter <literal>hibernate.connection.release_mode</" +"literal> bestimmt, welcher Freigabemodus verwendet werden soll. Folgende " +"Werte sind möglich:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>auto</literal> (the default): this choice delegates to the release " +"mode returned by the <literal>org.hibernate.transaction.TransactionFactory." +"getDefaultReleaseMode()</literal> method. For JTATransactionFactory, this " +"returns ConnectionReleaseMode.AFTER_STATEMENT; for JDBCTransactionFactory, " +"this returns ConnectionReleaseMode.AFTER_TRANSACTION. Do not change this " +"default behavior as failures due to the value of this setting tend to " +"indicate bugs and/or invalid assumptions in user code." +msgstr "" +"<literal>auto</literal> (Standard) - diese Auswahl delegiert zum " +"Freigabemodus der durch die <literal>org.hibernate.transaction." +"TransactionFactory.getDefaultReleaseMode()</literal>-Methode erhalten wird. " +"Für JTATransactionFactory erhält man ConnectionReleaseMode.AFTER_STATEMENT; " +"für JDBCTransactionFactory, erhält man ConnectionReleaseMode." +"AFTER_TRANSACTION. Es ist nur in seltenen Fällen sinnvoll, dieses " +"Standardverhalten zu ändern, da Fehler aufgrund des Wertes dieser " +"Einstellung in der Regel Bugs und/oder ungültige Annahmen im Benutzercode " +"anzeigen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>on_close</literal>: uses ConnectionReleaseMode.ON_CLOSE. This " +"setting is left for backwards compatibility, but its use is discouraged." +msgstr "" +"<literal>on_close</literal> - setzt ConnectionReleaseMode.ON_CLOSE. Diese " +"Einstellung wird zur rückwärtigen Kompatibilität verwendet, wird jedoch " +"nicht empfohlen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>after_transaction</literal>: uses ConnectionReleaseMode." +"AFTER_TRANSACTION. This setting should not be used in JTA environments. Also " +"note that with ConnectionReleaseMode.AFTER_TRANSACTION, if a session is " +"considered to be in auto-commit mode, connections will be released as if the " +"release mode were AFTER_STATEMENT." +msgstr "" +"<literal>after_transaction</literal> - setzt ConnectionReleaseMode." +"AFTER_TRANSACTION. Diese Einstellung sollte nicht in JTA-Umgebungen " +"verwendet werden. Beachten Sie auch, dass bei ConnectionReleaseMode." +"AFTER_TRANSACTION, für eine als im Auto-Festschreibungsmodus befindlich " +"angesehene Session Verbindungen freigegeben werden als ob der Freigabemodus " +"AFTER_STATEMENT lauten würde." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>after_statement</literal>: uses ConnectionReleaseMode." +"AFTER_STATEMENT. Additionally, the configured <literal>ConnectionProvider</" +"literal> is consulted to see if it supports this setting " +"(<literal>supportsAggressiveRelease()</literal>). If not, the release mode " +"is reset to ConnectionReleaseMode.AFTER_TRANSACTION. This setting is only " +"safe in environments where we can either re-acquire the same underlying JDBC " +"connection each time you make a call into <literal>ConnectionProvider." +"getConnection()</literal> or in auto-commit environments where it does not " +"matter if we re-establish the same connection." +msgstr "" +"<literal>after_statement</literal> - setzt die Verwendung von " +"ConnectionReleaseMode.AFTER_STATEMENT. Außerdem wird der konfigurierte " +"<literal>ConnectionProvider</literal> abgefragt, um zu sehen ob diese " +"Einstellung unterstützt wird (<literal>supportsAggressiveRelease()</" +"literal>). Falls nicht, wird der Freigabemodus auf ConnectionReleaseMode." +"AFTER_TRANSACTION zurückgesetzt. Diese Einstellung ist nur in Umgebungen " +"sicher, in denen bei jedem Aufruf an den <literal>ConnectionProvider." +"getConnection()</literal> auf dieselbe zu Grunde liegende JDBC-Verbindung " +"zurückgegriffen werden kann oder in Auto-Festschreibungsumgebungen, bei " +"denen es irrelevant ist, ob wir dieselbe Verbindung wieder erhalten." + +#~ msgid "foo==bar" +#~ msgstr "foo==bar" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[// Non-managed environment idiom\n" +#~ "Session sess = factory.openSession();\n" +#~ "Transaction tx = null;\n" +#~ "try {\n" +#~ " tx = sess.beginTransaction();\n" +#~ "\n" +#~ " // do some work\n" +#~ " ...\n" +#~ "\n" +#~ " tx.commit();\n" +#~ "}\n" +#~ "catch (RuntimeException e) {\n" +#~ " if (tx != null) tx.rollback();\n" +#~ " throw e; // or display error message\n" +#~ "}\n" +#~ "finally {\n" +#~ " sess.close();\n" +#~ "}]]>" +#~ msgstr "" +#~ "// Non-managed environment idiom\n" +#~ "Session sess = factory.openSession();\n" +#~ "Transaction tx = null;\n" +#~ "try {\n" +#~ " tx = sess.beginTransaction();\n" +#~ "\n" +#~ " // do some work\n" +#~ " ...\n" +#~ "\n" +#~ " tx.commit();\n" +#~ "}\n" +#~ "catch (RuntimeException e) {\n" +#~ " if (tx != null) tx.rollback();\n" +#~ " throw e; // or display error message\n" +#~ "}\n" +#~ "finally {\n" +#~ " sess.close();\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[// Non-managed environment idiom with getCurrentSession()\n" +#~ "try {\n" +#~ " factory.getCurrentSession().beginTransaction();\n" +#~ "\n" +#~ " // do some work\n" +#~ " ...\n" +#~ "\n" +#~ " factory.getCurrentSession().getTransaction().commit();\n" +#~ "}\n" +#~ "catch (RuntimeException e) {\n" +#~ " factory.getCurrentSession().getTransaction().rollback();\n" +#~ " throw e; // or display error message\n" +#~ "}]]>" +#~ msgstr "" +#~ "// Non-managed environment idiom with getCurrentSession()\n" +#~ "try {\n" +#~ " factory.getCurrentSession().beginTransaction();\n" +#~ "\n" +#~ " // do some work\n" +#~ " ...\n" +#~ "\n" +#~ " factory.getCurrentSession().getTransaction().commit();\n" +#~ "}\n" +#~ "catch (RuntimeException e) {\n" +#~ " factory.getCurrentSession().getTransaction().rollback();\n" +#~ " throw e; // or display error message\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[// BMT idiom\n" +#~ "Session sess = factory.openSession();\n" +#~ "Transaction tx = null;\n" +#~ "try {\n" +#~ " tx = sess.beginTransaction();\n" +#~ "\n" +#~ " // do some work\n" +#~ " ...\n" +#~ "\n" +#~ " tx.commit();\n" +#~ "}\n" +#~ "catch (RuntimeException e) {\n" +#~ " if (tx != null) tx.rollback();\n" +#~ " throw e; // or display error message\n" +#~ "}\n" +#~ "finally {\n" +#~ " sess.close();\n" +#~ "}]]>" +#~ msgstr "" +#~ "// BMT idiom\n" +#~ "Session sess = factory.openSession();\n" +#~ "Transaction tx = null;\n" +#~ "try {\n" +#~ " tx = sess.beginTransaction();\n" +#~ "\n" +#~ " // do some work\n" +#~ " ...\n" +#~ "\n" +#~ " tx.commit();\n" +#~ "}\n" +#~ "catch (RuntimeException e) {\n" +#~ " if (tx != null) tx.rollback();\n" +#~ " throw e; // or display error message\n" +#~ "}\n" +#~ "finally {\n" +#~ " sess.close();\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[// BMT idiom with getCurrentSession()\n" +#~ "try {\n" +#~ " UserTransaction tx = (UserTransaction)new InitialContext()\n" +#~ " .lookup(\"java:comp/UserTransaction\");\n" +#~ "\n" +#~ " tx.begin();\n" +#~ "\n" +#~ " // Do some work on Session bound to transaction\n" +#~ " factory.getCurrentSession().load(...);\n" +#~ " factory.getCurrentSession().persist(...);\n" +#~ "\n" +#~ " tx.commit();\n" +#~ "}\n" +#~ "catch (RuntimeException e) {\n" +#~ " tx.rollback();\n" +#~ " throw e; // or display error message\n" +#~ "}]]>" +#~ msgstr "" +#~ "// BMT idiom with getCurrentSession()\n" +#~ "try {\n" +#~ " UserTransaction tx = (UserTransaction)new InitialContext()\n" +#~ " .lookup(\"java:comp/UserTransaction\");\n" +#~ "\n" +#~ " tx.begin();\n" +#~ "\n" +#~ " // Do some work on Session bound to transaction\n" +#~ " factory.getCurrentSession().load(...);\n" +#~ " factory.getCurrentSession().persist(...);\n" +#~ "\n" +#~ " tx.commit();\n" +#~ "}\n" +#~ "catch (RuntimeException e) {\n" +#~ " tx.rollback();\n" +#~ " throw e; // or display error message\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[// CMT idiom\n" +#~ " Session sess = factory.getCurrentSession();\n" +#~ "\n" +#~ " // do some work\n" +#~ " ...\n" +#~ "]]>" +#~ msgstr "" +#~ "// CMT idiom\n" +#~ " Session sess = factory.getCurrentSession();\n" +#~ "\n" +#~ " // do some work\n" +#~ " ..." + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[\n" +#~ "Session sess = factory.openSession();\n" +#~ "try {\n" +#~ " //set transaction timeout to 3 seconds\n" +#~ " sess.getTransaction().setTimeout(3);\n" +#~ " sess.getTransaction().begin();\n" +#~ "\n" +#~ " // do some work\n" +#~ " ...\n" +#~ "\n" +#~ " sess.getTransaction().commit()\n" +#~ "}\n" +#~ "catch (RuntimeException e) {\n" +#~ " sess.getTransaction().rollback();\n" +#~ " throw e; // or display error message\n" +#~ "}\n" +#~ "finally {\n" +#~ " sess.close();\n" +#~ "}]]>" +#~ msgstr "" +#~ "Session sess = factory.openSession();\n" +#~ "try {\n" +#~ " //set transaction timeout to 3 seconds\n" +#~ " sess.getTransaction().setTimeout(3);\n" +#~ " sess.getTransaction().begin();\n" +#~ "\n" +#~ " // do some work\n" +#~ " ...\n" +#~ "\n" +#~ " sess.getTransaction().commit()\n" +#~ "}\n" +#~ "catch (RuntimeException e) {\n" +#~ " sess.getTransaction().rollback();\n" +#~ " throw e; // or display error message\n" +#~ "}\n" +#~ "finally {\n" +#~ " sess.close();\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[// foo is an instance loaded by a previous Session\n" +#~ "session = factory.openSession();\n" +#~ "Transaction t = session.beginTransaction();\n" +#~ "\n" +#~ "int oldVersion = foo.getVersion();\n" +#~ "session.load( foo, foo.getKey() ); // load the current state\n" +#~ "if ( oldVersion != foo.getVersion() ) throw new StaleObjectStateException" +#~ "();\n" +#~ "foo.setProperty(\"bar\");\n" +#~ "\n" +#~ "t.commit();\n" +#~ "session.close();]]>" +#~ msgstr "" +#~ "// foo is an instance loaded by a previous Session\n" +#~ "session = factory.openSession();\n" +#~ "Transaction t = session.beginTransaction();\n" +#~ "\n" +#~ "int oldVersion = foo.getVersion();\n" +#~ "session.load( foo, foo.getKey() ); // load the current state\n" +#~ "if ( oldVersion!=foo.getVersion ) throw new StaleObjectStateException();\n" +#~ "foo.setProperty(\"bar\");\n" +#~ "\n" +#~ "t.commit();\n" +#~ "session.close();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[// foo is an instance loaded earlier by the old session\n" +#~ "Transaction t = session.beginTransaction(); // Obtain a new JDBC " +#~ "connection, start transaction\n" +#~ "\n" +#~ "foo.setProperty(\"bar\");\n" +#~ "\n" +#~ "session.flush(); // Only for last transaction in conversation\n" +#~ "t.commit(); // Also return JDBC connection\n" +#~ "session.close(); // Only for last transaction in conversation]]>" +#~ msgstr "" +#~ "// foo is an instance loaded earlier by the old session\n" +#~ "Transaction t = session.beginTransaction(); // Obtain a new JDBC " +#~ "connection, start transaction\n" +#~ "\n" +#~ "foo.setProperty(\"bar\");\n" +#~ "\n" +#~ "session.flush(); // Only for last transaction in conversation\n" +#~ "t.commit(); // Also return JDBC connection\n" +#~ "session.close(); // Only for last transaction in conversation" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[// foo is an instance loaded by a previous Session\n" +#~ "foo.setProperty(\"bar\");\n" +#~ "session = factory.openSession();\n" +#~ "Transaction t = session.beginTransaction();\n" +#~ "session.saveOrUpdate(foo); // Use merge() if \"foo\" might have been " +#~ "loaded already\n" +#~ "t.commit();\n" +#~ "session.close();]]>" +#~ msgstr "" +#~ "// foo is an instance loaded by a previous Session\n" +#~ "foo.setProperty(\"bar\");\n" +#~ "session = factory.openSession();\n" +#~ "Transaction t = session.beginTransaction();\n" +#~ "session.saveOrUpdate(foo); // Use merge() if \"foo\" might have been " +#~ "loaded already\n" +#~ "t.commit();\n" +#~ "session.close();" Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/tutorial.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/tutorial.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/tutorial.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,3146 @@ +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# Language /mnt/hgfs/base/Hibernate/Reference translations for PACKAGE package. +# Copyright (C) 2006, 2007 Free Software Foundation, Inc. +# Automatically generated, 2006. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# +msgid "" +msgstr "" +"Project-Id-Version: Collection_Mapping\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2010-01-08T04:07:20\n" +"PO-Revision-Date: 2007-02-26 10:27+1000\n" +"Last-Translator: \n" +"Language-Team: <de(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.9.1\n" + +#. Tag: title +#, no-c-format +msgid "Tutorial" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"Intended for new users, this chapter provides an step-by-step introduction " +"to Hibernate, starting with a simple application using an in-memory " +"database. The tutorial is based on an earlier tutorial developed by Michael " +"Gloegl. All code is contained in the <filename>tutorials/web</filename> " +"directory of the project source." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"This tutorial expects the user have knowledge of both Java and SQL. If you " +"have a limited knowledge of JAVA or SQL, it is advised that you start with a " +"good introduction to that technology prior to attempting to learn Hibernate." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"The distribution contains another example application under the " +"<filename>tutorial/eg</filename> project source directory." +msgstr "" + +#. Tag: title +#, no-c-format +msgid "Part 1 - The first Hibernate Application" +msgstr "Teil 1 - Die erste Hibernate Anwendung" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"For this example, we will set up a small database application that can store " +"events we want to attend and information about the host(s) of these events." +msgstr "" +"Nehmen wir etwa an, wir bräuchten eine kleine Datenbank-Anwendung zur " +"Speicherung von Veranstaltungen, an denen wir teilnehmen wollen sowie " +"Informationen zu deren Organisatoren." + +#. Tag: para +#, no-c-format +msgid "" +"Although you can use whatever database you feel comfortable using, we will " +"use <ulink url=\"http://hsqldb.org/\">HSQLDB</ulink> (an in-memory, Java " +"database) to avoid describing installation/setup of any particular database " +"servers." +msgstr "" + +#. Tag: title +#, no-c-format +msgid "Setup" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"The first thing we need to do is to set up the development environment. We " +"will be using the \"standard layout\" advocated by alot of build tools such " +"as <ulink url=\"http://maven.org\">Maven</ulink>. Maven, in particular, has " +"a good resource describing this <ulink url=\"http://maven.apache.org/guides/" +"introduction/introduction-to-the-standard-directory-layout.html\">layout</" +"ulink>. As this tutorial is to be a web application, we will be creating and " +"making use of <filename>src/main/java</filename>, <filename>src/main/" +"resources</filename> and <filename>src/main/webapp</filename> directories." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"We will be using Maven in this tutorial, taking advantage of its transitive " +"dependency management capabilities as well as the ability of many IDEs to " +"automatically set up a project for us based on the maven descriptor." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"It is not a requirement to use Maven. If you wish to use another technology " +"to build this tutorial (such as Ant), the layout will remain the same. The " +"only change is that you will need to manually account for all the needed " +"dependencies. If you use <ulink url=\"http://ant.apache.org/ivy/\">Ivy</" +"ulink> to provide transitive dependency management you would still use the " +"dependencies mentioned below. Otherwise, you will need to find all the " +"dependencies, both explicit and transitive, and add them to the projects " +"classpath. If working from the Hibernate distribution bundle, this would " +"mean <filename>hibernate3.jar</filename>, all artifacts in the <filename>lib/" +"required</filename> directory and all files from either the <filename>lib/" +"bytecode/cglib</filename> or <filename>lib/bytecode/javassist</filename> " +"directory; additionally you will need both the servlet-api jar and one of " +"the slf4j logging backends." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"Save this file as <filename>pom.xml</filename> in the project root directory." +msgstr "" + +#. Tag: title +#, no-c-format +msgid "The first class" +msgstr "Die erste Klasse" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Next, we create a class that represents the event we want to store in the " +"database; it is a simple JavaBean class with some properties:" +msgstr "" +"Anschließend erstellen wir eine Klasse, die die Veranstaltung repräsentiert, " +"die in der Datenbank gespeichert werden soll." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This class uses standard JavaBean naming conventions for property getter and " +"setter methods, as well as private visibility for the fields. Although this " +"is the recommended design, it is not required. Hibernate can also access " +"fields directly, the benefit of accessor methods is robustness for " +"refactoring." +msgstr "" +"Sie sehen, dass diese Klasse standardmäßige JavaBean Namenskonventionen für " +"Getter- und Setter-Methoden der Property sowie eigene Sichtbarkeit für die " +"Felder verwendet. Dieses ist der empfohlene - nicht aber der vorgeschriebene " +"- Entwurf. Hibernate kann auch direkt auf Felder zugreifen, wobei der " +"Vorteil dieser Zugriffsmethoden in der Stabilität bei der Steigerung der " +"Bedienerfreundlichkeit liegt. Der \"No-Argument\"-Konstruktor (d.h. der " +"Konstruktor ohne Parameter) wird benötigt, um ein Objekt dieser Klasse durch " +"Reflexion zu instanziieren." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>id</literal> property holds a unique identifier value for a " +"particular event. All persistent entity classes (there are less important " +"dependent classes as well) will need such an identifier property if we want " +"to use the full feature set of Hibernate. In fact, most applications, " +"especially web applications, need to distinguish objects by identifier, so " +"you should consider this a feature rather than a limitation. However, we " +"usually do not manipulate the identity of an object, hence the setter method " +"should be private. Only Hibernate will assign identifiers when an object is " +"saved. Hibernate can access public, private, and protected accessor methods, " +"as well as public, private and protected fields directly. The choice is up " +"to you and you can match it to fit your application design." +msgstr "" +"Die <literal>id</literal>-Property enthält einen eindeutigen \"Identifier\"-" +"Wert (Bezeichnerwert) für eine bestimmte Veranstaltung. Alle persistenten " +"Entity-Klassen (es existieren außerdem weniger wichtige abhängige Klassen) " +"werden eine solche Bezeichner-Property benötigen, falls Sie sämtliche " +"Features von Hibernate verwenden möchten. Die meisten Applikationen (und " +"insbesondere Webanwendungen) müssen Objekte mittels Bezeichner " +"unterscheiden, daher sollten Sie dies eher als zusätzliches Feature und " +"nicht als Einschränkung ansehen. Allerdings wird die Identität eines Objekts " +"in der Regel nicht verändert, weswegen die \"Setter\"-Methode nicht " +"öffentlich sein sollte. Ausschließlich Hibernate wird bei der Speicherung " +"eines Objekts Bezeichner zuweisen. Sie sehen also, dass Hibernate " +"öffentliche, nicht-öffentliche und geschützte Zugriffsmethoden aufrufen " +"kann. Die Entscheidung liegt ganz bei Ihnen, und Sie können die Wahl Ihren " +"persönlichen Bedürfnissen anpassen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The no-argument constructor is a requirement for all persistent classes; " +"Hibernate has to create objects for you, using Java Reflection. The " +"constructor can be private, however package or public visibility is required " +"for runtime proxy generation and efficient data retrieval without bytecode " +"instrumentation." +msgstr "" +"Der \"No-Argument\"-Konstruktor (d.h. der Konstruktor ohne Parameter) ist " +"eine Voraussetzung für alle persistenten Klassen. Hibernate erstellt unter " +"Verwendung von Java Reflection diese Objekte für Sie. Der Konstruktor kann " +"nicht-öffentlich sein, jedoch werden bei der Proxy-Generierung zur Runtime " +"Sichtbarkeit der Pakete sowie effizienter Datenabruf ohne Bytecode-" +"Instrumentierung benötigt." + +#. Tag: para +#, no-c-format +msgid "" +"Save this file to the <filename>src/main/java/org/hibernate/tutorial/domain</" +"filename> directory." +msgstr "" + +#. Tag: title +#, no-c-format +msgid "The mapping file" +msgstr "Die Mapping-Datei" + +#. Tag: para +#, no-c-format +msgid "" +"Hibernate needs to know how to load and store objects of the persistent " +"class. This is where the Hibernate mapping file comes into play. The mapping " +"file tells Hibernate what table in the database it has to access, and what " +"columns in that table it should use." +msgstr "" +"Hibernate muss darüber informiert werden, wie Objekte der persistenten " +"Klasse geladen und gespeichert werden sollen. Hier wird die \"Mapping\"-" +"Datei von Hibernate benötigt. Diese Datei informiert Hibernate darüber, auf " +"welche Tabelle in der Datenbank zugegriffen werden soll und welche Spalten " +"dieser Tabelle verwendet werden sollen." + +#. Tag: para +#, no-c-format +msgid "The basic structure of a mapping file looks like this:" +msgstr "Die Grundstruktur einer Mapping-Datei sieht wie folgt aus:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate DTD is sophisticated. You can use it for auto-completion of XML " +"mapping elements and attributes in your editor or IDE. Opening up the DTD " +"file in your text editor is the easiest way to get an overview of all " +"elements and attributes, and to view the defaults, as well as some comments. " +"Hibernate will not load the DTD file from the web, but first look it up from " +"the classpath of the application. The DTD file is included in " +"<filename>hibernate-core.jar</filename> (it is also included in the " +"<filename>hibernate3.jar</filename>, if using the distribution bundle)." +msgstr "" +"Bitte beachten Sie, dass Hibernate DTD technisch sehr ausgefeilt ist. Sie " +"können es für Auto-Vervollständigung von XML-Mapping-Elementen und " +"Attributen in Ihrem Editor oder IDE verwenden. Sie sollte die DTD-Datei in " +"Ihrem Text-Editor öffnen - es ist die bequemste Art einen Überblick über " +"alle Elemente und Attribute zu bekommen und die Standardeinstellungen sowie " +"einige Kommentare zu sehen. Bitte beachten Sie, dass Hibernate die DTD-Datei " +"nicht aus dem Web lädt, sondern sie vom Klassenpfad der Anwendung aufsucht. " +"Die DTD-Datei ist im <literal>hibernate3.jar</literal> sowie im <literal>src/" +"</literal>-Verzeichnis der Hibernate-Distribution enthalten." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"We will omit the DTD declaration in future examples to shorten the code. It " +"is, of course, not optional." +msgstr "" +"In zukünftigen Beispielen werden wir die DTD-Deklaration weglassen, um den " +"Code zu verkürzen. Natürlich ist dies nicht optional." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Between the two <literal>hibernate-mapping</literal> tags, include a " +"<literal>class</literal> element. All persistent entity classes (again, " +"there might be dependent classes later on, which are not first-class " +"entities) need a mapping to a table in the SQL database:" +msgstr "" +"Zwischen den beiden <literal>hibernate-mapping</literal>-Tags fügen Sie ein " +"<literal>class</literal>-Element ein. Alle persistenten Entity-Klassen " +"(wieder kann es später zu abhängigen Klassen kommen, die keine Entities der " +"ersten Klasse sind) benötigen ein solches Mapping zu einer Tabelle in der " +"SQL-Datenbank:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"So far we have told Hibernate how to persist and load object of class " +"<literal>Event</literal> to the table <literal>EVENTS</literal>. Each " +"instance is now represented by a row in that table. Now we can continue by " +"mapping the unique identifier property to the tables primary key. As we do " +"not want to care about handling this identifier, we configure Hibernate's " +"identifier generation strategy for a surrogate primary key column:" +msgstr "" +"Mit den bisherigen Schritten haben wir Hibernate darüber informiert, wie ein " +"Objekt der Klasse <literal>Event</literal> in die Tabelle <literal>EVENTS</" +"literal> persistiert und geladen werden soll, wobei jede Instanz durch eine " +"Reihe in dieser Tabelle repräsentiert wird. Wir fahren nun mit einem Mapping " +"der eindeutigen Identifier-Property zum primären Kernbegriff (\"Primary Key" +"\") der Tabelle fort. Damit wir uns in Zukunft nicht weiter um diesen " +"Identifier kümmern müssen, konfigurieren wir außerdem die Identifier-" +"Generierungsstrategie von Hibernate für eine Ersatzspalte des primären " +"Kernbegriffs:" + +#. Tag: para +#, no-c-format +msgid "" +"The <literal>id</literal> element is the declaration of the identifier " +"property. The <literal>name=\"id\"</literal> mapping attribute declares the " +"name of the JavaBean property and tells Hibernate to use the <literal>getId()" +"</literal> and <literal>setId()</literal> methods to access the property. " +"The column attribute tells Hibernate which column of the <literal>EVENTS</" +"literal> table holds the primary key value." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"The nested <literal>generator</literal> element specifies the identifier " +"generation strategy (aka how are identifier values generated?). In this case " +"we choose <literal>native</literal>, which offers a level of portability " +"depending on the configured database dialect. Hibernate supports database " +"generated, globally unique, as well as application assigned, identifiers. " +"Identifier value generation is also one of Hibernate's many extension points " +"and you can plugin in your own strategy." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"<literal>native</literal> is no longer considered the best strategy in terms " +"of portability. for further discussion, see <xref linkend=\"portability-idgen" +"\" />" +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Lastly, we need to tell Hibernate about the remaining entity class " +"properties. By default, no properties of the class are considered persistent:" +msgstr "" +"Zuletzt nehmen wir Vereinbarungen für die persistenten Properties der Klasse " +"in die Mapping-Datei auf. In der Standardeinstellung werden keine Properties " +"der Klasse als persistent angesehen:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Similar to the <literal>id</literal> element, the <literal>name</literal> " +"attribute of the <literal>property</literal> element tells Hibernate which " +"getter and setter methods to use. In this case, Hibernate will search for " +"<literal>getDate()</literal>, <literal>setDate()</literal>, <literal>getTitle" +"()</literal> and <literal>setTitle()</literal> methods." +msgstr "" +"Genau wie das <literal>id</literal>-Element informiert auch das " +"<literal>name</literal>-Attribut des <literal>property</literal>-Elements " +"Hibernate darüber, welche Getter- und Setter-Methoden verwendet werden " +"sollen. In diesem Fall wird Hibernate also nach <literal>getDate()/setDate()" +"</literal> sowie <literal>getTitle()/setTitle()</literal> suchen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Why does the <literal>date</literal> property mapping include the " +"<literal>column</literal> attribute, but the <literal>title</literal> does " +"not? Without the <literal>column</literal> attribute, Hibernate by default " +"uses the property name as the column name. This works for <literal>title</" +"literal>, however, <literal>date</literal> is a reserved keyword in most " +"databases so you will need to map it to a different name." +msgstr "" +"Warum aber enthält das <literal>date</literal> Property-Mapping " +"das<literal>column</literal>-Attribut, <literal>title</literal> jedoch " +"nicht? Ohne das <literal>column</literal>-Attribut verwendet Hibernate " +"standardmäßig den Namen der Property als Spaltennamen. Dies funktioniert gut " +"für <literal>title</literal>. Allerdings ist <literal>date</literal> in den " +"meisten Datenbanken ein reservierter Schlüsselbegriff, so dass es besser zu " +"einem anderen Namen gemappt werden sollte." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The <literal>title</literal> mapping also lacks a <literal>type</literal> " +"attribute. The types declared and used in the mapping files are not Java " +"data types; they are not SQL database types either. These types are called " +"<emphasis>Hibernate mapping types</emphasis>, converters which can translate " +"from Java to SQL data types and vice versa. Again, Hibernate will try to " +"determine the correct conversion and mapping type itself if the " +"<literal>type</literal> attribute is not present in the mapping. In some " +"cases this automatic detection using Reflection on the Java class might not " +"have the default you expect or need. This is the case with the " +"<literal>date</literal> property. Hibernate cannot know if the property, " +"which is of <literal>java.util.Date</literal>, should map to a SQL " +"<literal>date</literal>, <literal>timestamp</literal>, or <literal>time</" +"literal> column. Full date and time information is preserved by mapping the " +"property with a <literal>timestamp</literal> converter." +msgstr "" +"Ebenfalls interessant ist die Tatsache, dass das <literal>title</literal>-" +"Mapping ebenfalls über kein <literal>type</literal>-Attribut verfügt. Die " +"von uns deklarierten und in den Mapping-Dateien verwendeten Typen sind " +"nicht, wie man vielleicht erwarten würde, Java-Datentypen. Es handelt sich " +"auch nicht um SQL-Datenbank-Typen. Diese Typen sind so genannte <emphasis>" +"\"Hibernate Mapping-Typen\"</emphasis>, Konverter, die von Java in SQL-" +"Datentypen und umgekehrt übersetzen können. Auch hier wird Hibernate selbst " +"versuchen die Datenkonvertierung zu bestimmen, falls das <literal>type</" +"literal>-Attribut im Mapping nicht vorhanden ist. In einigen Fällen hat " +"diese automatische Erkennung (unter Verwendung von Reflection auf der Java-" +"Klasse) möglicherweise nicht den \"Default\"-Wert, den Sie erwarten oder " +"benötigen. Dies ist bei der <literal>date</literal>-Property der Fall. " +"Hibernate weiß nicht, ob die Property (die von <literal>java.util.Date</" +"literal> ist) zu einer SQL <literal>date</literal>, einer " +"<literal>timestamp</literal> oder einer <literal>time</literal>-Spalte " +"mappen sollte. Vollständige Informationen zu Datum und Zeit werden durch das " +"Mapping der Property mit einem <literal>timestamp</literal>-Konverter " +"verwahrt." + +#. Tag: para +#, no-c-format +msgid "" +"Hibernate makes this mapping type determination using reflection when the " +"mapping files are processed. This can take time and resources, so if startup " +"performance is important you should consider explicitly defining the type to " +"use." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"Save this mapping file as <filename>src/main/resources/org/hibernate/" +"tutorial/domain/Event.hbm.xml</filename>." +msgstr "" + +#. Tag: title +#, no-c-format +msgid "Hibernate configuration" +msgstr "Die Konfiguration von Hibernate" + +#. Tag: para +#, no-c-format +msgid "" +"At this point, you should have the persistent class and its mapping file in " +"place. It is now time to configure Hibernate. First let's set up HSQLDB to " +"run in \"server mode\"" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "We do this so that the data remains between runs." +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"We will utilize the Maven exec plugin to launch the HSQLDB server by " +"running: <command> mvn exec:java -Dexec.mainClass=\"org.hsqldb.Server\" -" +"Dexec.args=\"-database.0 file:target/data/tutorial\"</command> You will see " +"it start up and bind to a TCP/IP socket; this is where our application will " +"connect later. If you want to start with a fresh database during this " +"tutorial, shutdown HSQLDB, delete all files in the <filename>target/data</" +"filename> directory, and start HSQLDB again." +msgstr "" +"Erstellen Sie ein Verzeichnis mit dem Namen <literal>data</literal> im " +"Stammverzeichnis des Entwicklungsverzeichnisses - hier wird HSQL DB seine " +"Datendateien speichern. Starten Sie die Datenbank, indem Sie <literal>java -" +"classpath ../lib/hsqldb.jar org.hsqldb.Server</literal> in diesem " +"Datenverzeichnis ausführen. Sie sehen, wie sie hochfährt und auf ein TCP/IP-" +"Socket anspricht, an dem sich die Anwendung später verbindet. Falls Sie " +"während dieser Anleitung mit einer frischen Datenbank starten wollen, " +"schließen Sie HSQL DB (drücken Sie <literal>CTRL + C</literal> im Fenster), " +"löschen Sie alle Dateien im <literal>data/</literal>-Verzeichnis und starten " +"Sie HSQL DB erneut." + +#. Tag: para +#, no-c-format +msgid "" +"Hibernate will be connecting to the database on behalf of your application, " +"so it needs to know how to obtain connections. For this tutorial we will be " +"using a standalone connection pool (as opposed to a <interfacename>javax.sql." +"DataSource</interfacename>). Hibernate comes with support for two third-" +"party open source JDBC connection pools: <ulink url=\"https://sourceforge." +"net/projects/c3p0\">c3p0</ulink> and <ulink url=\"http://proxool.sourceforge." +"net/\">proxool</ulink>. However, we will be using the Hibernate built-in " +"connection pool for this tutorial." +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The built-in Hibernate connection pool is not intended for production use." +msgstr "Hash-Tabelle (nicht für den Produktionsgebrauch vorgesehen)" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"For Hibernate's configuration, we can use a simple <literal>hibernate." +"properties</literal> file, a more sophisticated <literal>hibernate.cfg.xml</" +"literal> file, or even complete programmatic setup. Most users prefer the " +"XML configuration file:" +msgstr "" +"Für die Konfiguration von Hibernate können eine einfache <literal>hibernate." +"properties</literal>-Datei, eine etwas differenziertere <literal>hibernate." +"cfg.xml</literal>-Datei oder sogar ein kompletter programmorientierter " +"Aufbau verwendet werden. Die meisten Benutzer bevorzugen die XML-" +"Konfigurationsdatei:" + +#. Tag: para +#, no-c-format +msgid "Notice that this configuration file specifies a different DTD" +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You configure Hibernate's <literal>SessionFactory</literal>. SessionFactory " +"is a global factory responsible for a particular database. If you have " +"several databases, for easier startup you should use several <literal><" +"session-factory></literal> configurations in several configuration files." +msgstr "" +"Bitte beachten Sie, dass diese XML-Konfiguration eine andere DTD " +"(Dokumenttyp-Definition) verwendet. Wir konfigurieren Hibernates " +"<literal>SessionFactory</literal> - eine allgemeingültige und für eine " +"bestimmte Datenbank verantwortliche Factory. Falls Sie mehrere Datenbanken " +"besitzen, verwenden Sie mehrere <literal><session-factory></literal> " +"Konfigurationen, üblicherweise in mehreren Konfigurationsdateien (für die " +"einfachere Inbetriebnahme)." + +#. Tag: para +#, no-c-format +msgid "" +"The first four <literal>property</literal> elements contain the necessary " +"configuration for the JDBC connection. The dialect <literal>property</" +"literal> element specifies the particular SQL variant Hibernate generates." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"Hibernate is able to correctly determine which dialect to use in most cases. " +"See <xref linkend=\"portability-dialectresolver\" /> for more information." +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate's automatic session management for persistence contexts is " +"particularly useful in this context. The <literal>hbm2ddl.auto</literal> " +"option turns on automatic generation of database schemas directly into the " +"database. This can also be turned off by removing the configuration option, " +"or redirected to a file with the help of the <literal>SchemaExport</literal> " +"Ant task. Finally, add the mapping file(s) for persistent classes to the " +"configuration." +msgstr "" +"Die ersten vier <literal>property</literal>-Elemente enthalten die nötige " +"Konfiguration für die JDBC-Verbindung. Das Dialekt <literal>property</" +"literal>-Element legt die bestimmte SQL-Variante fest, die Hibernate " +"generiert. Hibernates automatisches Session-Management für Persistenz-" +"Kontexte wird sich hier als hilfreich erweisen. Die <literal>hbm2ddl.auto</" +"literal>-Option schaltet die automatische Generierung von Datenbankschemas " +"ein - direkt in die Datenbank. Dies lässt sich natürlich auch ausschalten " +"(durch Entfernen der config-Option) oder mit Hilfe der " +"<literal>SchemaExport</literal> Ant-Aufgabe an eine Datei umleiten. Zuletzt " +"werden die Mapping-Datei(en) für persistente Klassen der Konfiguration " +"hinzugefügt." + +#. Tag: para +#, no-c-format +msgid "" +"Save this file as <filename>hibernate.cfg.xml</filename> into the " +"<filename>src/main/resources</filename> directory." +msgstr "" + +#. Tag: title +#, fuzzy, no-c-format +msgid "Building with Maven" +msgstr "\"Builden\" mit Ant" + +#. Tag: para +#, no-c-format +msgid "" +"We will now build the tutorial with Maven. You will need to have Maven " +"installed; it is available from the <ulink url=\"http://maven.apache.org/" +"download.html\">Maven download page</ulink>. Maven will read the <filename>/" +"pom.xml</filename> file we created earlier and know how to perform some " +"basic project tasks. First, lets run the <literal>compile</literal> goal to " +"make sure we can compile everything so far:" +msgstr "" + +#. Tag: title +#, no-c-format +msgid "Startup and helpers" +msgstr "Inbetriebnahme und Helfer" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"It is time to load and store some <literal>Event</literal> objects, but " +"first you have to complete the setup with some infrastructure code. You have " +"to startup Hibernate by building a global <interfacename>org.hibernate." +"SessionFactory</interfacename> object and storing it somewhere for easy " +"access in application code. A <interfacename>org.hibernate.SessionFactory</" +"interfacename> is used to obtain <interfacename>org.hibernate.Session</" +"interfacename> instances. A <interfacename>org.hibernate.Session</" +"interfacename> represents a single-threaded unit of work. The " +"<interfacename>org.hibernate.SessionFactory</interfacename> is a thread-safe " +"global object that is instantiated once." +msgstr "" +"Als nächstes werden einige <literal>Event</literal>-Objekte geladen und " +"gespeichert, jedoch muss zuerst die Konfiguration mit einigen Infrastruktur-" +"Codes (sog. \"Infrastructure Codes\") vervollständigt werden. Wir müssen " +"Hibernate starten. Die Inbetriebnahme beinhaltet ein allgemeingültiges " +"<literal>SessionFactory</literal>-Objekt, das an einer Stelle gespeichert " +"wird, auf die im Applikationscode leicht zugegriffen werden kann. Eine " +"<literal>SessionFactory</literal> kann neue <literal>Session</literal>s " +"öffnen. Eine <literal>Session</literal> repräsentiert eine aus einem Thread " +"bestehende Arbeitseinheit, eine <literal>SessionFactory</literal> ist ein " +"threadsicheres, allgemeingültiges Objekt, das einmal instanziiert ist." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"We will create a <literal>HibernateUtil</literal> helper class that takes " +"care of startup and makes accessing the <interfacename>org.hibernate." +"SessionFactory</interfacename> more convenient." +msgstr "" +"Wir erstellen eine <literal>HibernateUtil</literal>-Helferklasse, die den " +"Startup erledigt und einen bequemen Zugriff auf eine " +"<literal>SessionFactory</literal> ermöglicht. Werfen wir einen Blick auf die " +"Implementierung:" + +#. Tag: para +#, no-c-format +msgid "" +"Save this code as <filename>src/main/java/org/hibernate/tutorial/util/" +"HibernateUtil.java</filename>" +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This class not only produces the global <interfacename>org.hibernate." +"SessionFactory</interfacename> reference in its static initializer; it also " +"hides the fact that it uses a static singleton. We might just as well have " +"looked up the <interfacename>org.hibernate.SessionFactory</interfacename> " +"reference from JNDI in an application server or any other location for that " +"matter." +msgstr "" +"Diese Klasse produziert nicht nur die allgemeingültige " +"<literal>SessionFactory</literal> in ihrem statischen Initialisierer (sog. " +"\"Initializer\" - wird beim Laden der Klasse von der JVM aufgerufen), " +"sondern verwendet außerdem ein statisches Singleton. Es kann außerdem die " +"<literal>SessionFactory</literal> von JNDI in einem Applikationsserver " +"aufsuchen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"If you give the <interfacename>org.hibernate.SessionFactory</interfacename> " +"a name in your configuration, Hibernate will try to bind it to JNDI under " +"that name after it has been built. Another, better option is to use a JMX " +"deployment and let the JMX-capable container instantiate and bind a " +"<literal>HibernateService</literal> to JNDI. Such advanced options are " +"discussed later." +msgstr "" +"Wenn Sie <literal>SessionFactory</literal> einen Namen in Ihrer " +"Konfigurationsdatei geben, so wird Hibernate versuchen, diese nach dem Build-" +"Prozess an JNDI zu binden. Um diesen Code komplett zu meiden, könnten Sie " +"JMX-Deployment verwenden und den JMX-fähigen Container instanziieren sowie " +"<literal>HibernateService</literal> an JNDI binden. Diese erweiterten " +"Optionen werden in der Referenz-Dokumentation von Hibernate näher erläutert." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You now need to configure a logging system. Hibernate uses commons logging " +"and provides two choices: Log4j and JDK 1.4 logging. Most developers prefer " +"Log4j: copy <literal>log4j.properties</literal> from the Hibernate " +"distribution in the <literal>etc/</literal> directory to your <literal>src</" +"literal> directory, next to <literal>hibernate.cfg.xml</literal>. If you " +"prefer to have more verbose output than that provided in the example " +"configuration, you can change the settings. By default, only the Hibernate " +"startup message is shown on stdout." +msgstr "" +"Dies sollte problemlos kompilieren. Nun muss noch ein Protokollierungssystem " +"(sog. \"Logging-System\") konfiguriert werden - Hibernate verwendet " +"\"Commons-Logging\" und überlässt Ihnen die Wahl zwischen Log4j- und JDK 1.4-" +"Logging. Die meisten Entwickler bevorzugen Log4j: Kopieren Sie " +"<literal>log4j.properties</literal> aus der Hibernate-Distribution (es " +"befindet sich im <literal>etc/</literal>-Verzeichnis) in Ihr <literal>src</" +"literal>-Verzeichnis neben <literal>hibernate.cfg.xml</literal>. Schauen Sie " +"sich die Beispielkonfiguration an, und ändern Sie die Einstellungen, wenn " +"Sie eine aussagekräftigere Ausgabe wünschen. In der Standardeinstellung " +"werden nur die Hibernate Startup-Nachrichten in stdout dargesellt." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The tutorial infrastructure is complete and you are now ready to do some " +"real work with Hibernate." +msgstr "" +"Die Infrastruktur der Anleitung ist nun vollständig - und wir können mit der " +"Benutzung von Hibernate beginnen." + +#. Tag: title +#, no-c-format +msgid "Loading and storing objects" +msgstr "Das Laden und Speichern von Objekten" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"We are now ready to start doing some real worjk with Hibernate. Let's start " +"by writing an <literal>EventManager</literal> class with a <literal>main()</" +"literal> method:" +msgstr "" +"Hibernate kann zum Laden und Speichern von Objekten verwendet werden. Eine " +"<literal>EventManager</literal>-Klasse wird mit einer <literal>main()</" +"literal>-Methode geschrieben:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"In <literal>createAndStoreEvent()</literal> we created a new <literal>Event</" +"literal> object and handed it over to Hibernate. At that point, Hibernate " +"takes care of the SQL and executes an <literal>INSERT</literal> on the " +"database." +msgstr "" +"Erstellen Sie ein neues <literal>Event</literal>-Objekt, und übergeben Sie " +"es Hibernate. Hibernate kümmert sich nun um SQL und führt <literal>INSERT</" +"literal>s in der Datenbank aus. Werfen wir einen Blick auf den " +"<literal>Session</literal>- und <literal>Transaction</literal>-Handling-Code " +"ehe wir dies starten." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A <interface>org.hibernate.Session</interface> is designed to represent a " +"single unit of work (a single atmoic piece of work to be performed). For now " +"we will keep things simple and assume a one-to-one granularity between a " +"Hibernate <interface>org.hibernate.Session</interface> and a database " +"transaction. To shield our code from the actual underlying transaction " +"system we use the Hibernate <interfacename>org.hibernate.Transaction</" +"interfacename> API. In this particular case we are using JDBC-based " +"transactional semantics, but it could also run with JTA." +msgstr "" +"Bei einer <literal>Session</literal> handelt es sich um eine einzelne " +"Arbeitseinheit. Im Augenblick wollen wir es einfach angehen und von einer " +"\"One-to-One\"-Granularität zwischen einer Hibernate <literal>Session</" +"literal> und einer Datenbanktransaktion ausgehen. Um den Code vom zu Grunde " +"liegenden Transaktionssystem abzuschirmen (in diesem Falle schlichtes JDBC, " +"allerdings könnte auch JTA eingesetzt werden) wird das <literal>Transaction</" +"literal>-API (die Anwenderprogrammschnittstelle) verwendet, das in der " +"Hibernate <literal>Session</literal> verfügbar ist." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"What does <literal>sessionFactory.getCurrentSession()</literal> do? First, " +"you can call it as many times and anywhere you like once you get hold of " +"your <interfacename>org.hibernate.SessionFactory</interfacename>. The " +"<literal>getCurrentSession()</literal> method always returns the \"current\" " +"unit of work. Remember that we switched the configuration option for this " +"mechanism to \"thread\" in our <filename>src/main/resources/hibernate.cfg." +"xml</filename>? Due to that setting, the context of a current unit of work " +"is bound to the current Java thread that executes the application." +msgstr "" +"Was genau macht <literal>sessionFactory.getCurrentSession()</literal>? " +"Zunächst einmal können Sie es so oft Sie möchten aufrufen, wenn Sie Ihre " +"<literal>SessionFactory</literal> haben (dank <literal>HibernateUtil</" +"literal>). Die <literal>getCurrentSession()</literal>-Methode antwortet " +"stets mit der \"aktuellen\" Arbeitseinheit. Wie Sie sich sicherlich " +"erinnern, haben wir die Konfigurationsoption für diesen Mechanismus in der " +"<literal>hibernate.cfg.xml</literal> auf \"Thread\" umgestellt. Daher wird " +"die aktuelle Arbeitseinheit an den aktuellen Java-Thread gebunden, der die " +"Anwendung ausführt. Es muss jedoch noch der Gültigkeitsbereich (sog. \"Scope" +"\") berücksichtigt werden, d.h. wann eine Arbeitseinheit beginnt und wann " +"sie endet." + +#. Tag: para +#, no-c-format +msgid "" +"Hibernate offers three methods of current session tracking. The \"thread\" " +"based method is not intended for production use; it is merely useful for " +"prototyping and tutorials such as this one. Current session tracking is " +"discussed in more detail later on." +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A <interface>org.hibernate.Session</interface> begins when the first call to " +"<literal>getCurrentSession()</literal> is made for the current thread. It is " +"then bound by Hibernate to the current thread. When the transaction ends, " +"either through commit or rollback, Hibernate automatically unbinds the " +"<interface>org.hibernate.Session</interface> from the thread and closes it " +"for you. If you call <literal>getCurrentSession()</literal> again, you get a " +"new <interface>org.hibernate.Session</interface> and can start a new unit of " +"work." +msgstr "" +"Eine <literal>Session</literal> beginnt, wenn sie erstmals gebraucht wird, " +"wenn der erste Aufruf an <literal>getCurrentSession()</literal> erfolgt. Sie " +"wird dann durch Hibernate an den aktuellen Thread gebunden. Wenn die " +"Transaktion endet - sei es durch festschreiben oder zurücksetzen - löst " +"Hibernate automatisch die <literal>Session</literal> vom Thread und schließt " +"diese für Sie. Wenn Sie <literal>getCurrentSession()</literal> erneut " +"aufrufen, so erhalten Sie eine neue <literal>Session</literal> und können " +"mit einer neuen Arbeitseinheit beginnen. Dieses <emphasis>Thread-gebundene</" +"emphasis> Programmiermodell ist die beliebteste Art der Benutzung von " +"Hibernate, da es eine flexible Schichtung Ihres Codes erlaubt (der " +"Transaktionsabgrenzungscode kann vom Datenzugriffscode getrennt werden; wir " +"gehen darauf später in dieser Anleitung ein)." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Related to the unit of work scope, should the Hibernate <interface>org." +"hibernate.Session</interface> be used to execute one or several database " +"operations? The above example uses one <interface>org.hibernate.Session</" +"interface> for one operation. However this is pure coincidence; the example " +"is just not complex enough to show any other approach. The scope of a " +"Hibernate <interface>org.hibernate.Session</interface> is flexible but you " +"should never design your application to use a new Hibernate <interface>org." +"hibernate.Session</interface> for <emphasis>every</emphasis> database " +"operation. Even though it is used in the following examples, consider " +"<emphasis>session-per-operation</emphasis> an anti-pattern. A real web " +"application is shown later in the tutorial which will help illustrate this." +msgstr "" +"Sollte die Hibernate <literal>Session</literal> hinsichtlich des " +"Gültigkeitsbereichs der Arbeitseinheit dazu verwendet werden, einen oder " +"mehrere Datenbankvorgänge auszuführen? Das vorherige Beispiel verwendet eine " +"<literal>Session</literal> für einen Vorgang. Das war Zufall, da das " +"Beispiel einfach nicht komplex genug war, um eine andere Vorgehensweise " +"darzustellen. Der Gültigkeitsbereich einer Hibernate <literal>Session</" +"literal> ist flexibel, jedoch sollten Sie Ihre Anwendung nie so auslegen, " +"dass eine neue Hibernate <literal>Session</literal> für <emphasis>jeden</" +"emphasis> Datenbankvorgang verwendet wird. Selbst wenn Sie es in den " +"nachfolgenden (einfachen) Beispielen einige Male sehen, so betrachten Sie " +"<emphasis>Session-per-Operation</emphasis> als Negativmuster (sog. \"Anti-" +"Pattern\"). Eine echte (Web)-Anwendung wird zu einem späteren Zeitpunkt noch " +"gezeigt." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"See <xref linkend=\"transactions\" /> for more information about transaction " +"handling and demarcation. The previous example also skipped any error " +"handling and rollback." +msgstr "" +"Auf <xref linkend=\"transactions\"/> finden Sie weitere Informationen zum " +"Umgang mit Transaktionen und Abgrenzung (Demarkation). Auch Fehlerbehandlung " +"und Zurücksetzen wurden im vorherigen Beispiel weggelassen." + +#. Tag: para +#, no-c-format +msgid "" +"To run this, we will make use of the Maven exec plugin to call our class " +"with the necessary classpath setup: <command>mvn exec:java -Dexec.mainClass=" +"\"org.hibernate.tutorial.EventManager\" -Dexec.args=\"store\"</command>" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "You may need to perform <command>mvn compile</command> first." +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You should see Hibernate starting up and, depending on your configuration, " +"lots of log output. Towards the end, the following line will be displayed:" +msgstr "" +"Nach der Kompilierung sollten Sie den Start von Hibernate sehen sowie - je " +"nach der von Ihnen verwendeten Konfiguration - eine Menge an " +"Protokollausgaben. Am Ende sehen Sie die folgende Zeile:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "This is the <literal>INSERT</literal> executed by Hibernate." +msgstr "" +"Ein Beispiel für die Ausführung einer HQL <literal>INSERT</literal>-" +"Anweisung:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "To list stored events an option is added to the main method:" +msgstr "" +"Als nächstes sollen auch die gespeicherten Veranstaltungen gelistet werden, " +"daher fügen wir eine Option zur Hauptmethode hinzu:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "A new <literal>listEvents() method is also added</literal>:" +msgstr "" +"Eine neue <literal>listEvents() method</literal> wird ebenfalls hinzugefügt:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Here, we are using a Hibernate Query Language (HQL) query to load all " +"existing <literal>Event</literal> objects from the database. Hibernate will " +"generate the appropriate SQL, send it to the database and populate " +"<literal>Event</literal> objects with the data. You can create more complex " +"queries with HQL. See <xref linkend=\"queryhql\" /> for more information." +msgstr "" +"Mittels HQL-Anfrage (\"Hibernate Query Language\") werden alle bestehenden " +"<literal>Event</literal>-Objekte aus der Datenbank geladen. Hibernate " +"generiert die entsprechende SQL (\"Structured Query Language\"), schickt sie " +"an die Datenbank und füllt die <literal>Event</literal>-Objekte mit den " +"Daten. Natürlich können mit HQL auch komplexere Anfragen erstellt werden." + +#. Tag: para +#, no-c-format +msgid "" +"Now we can call our new functionality, again using the Maven exec plugin: " +"<command>mvn exec:java -Dexec.mainClass=\"org.hibernate.tutorial.EventManager" +"\" -Dexec.args=\"list\"</command>" +msgstr "" + +#. Tag: title +#, no-c-format +msgid "Part 2 - Mapping associations" +msgstr "Teil 2 - Mapping-Assoziationen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"So far we have mapped a single persistent entity class to a table in " +"isolation. Let's expand on that a bit and add some class associations. We " +"will add people to the application and store a list of events in which they " +"participate." +msgstr "" +"Bis jetzt haben wir eine persistente Entity-Klasse zu einer Tabelle gemappt. " +"Nachfolgend werden wir - darauf aufbauend - einige Klassen-Assoziationen " +"hinzufügen. Zuerst fügen wir der Anwendung Personen sowie eine Liste von " +"Veranstaltungen, an denen diese teilnehmen, hinzu." + +#. Tag: title +#, no-c-format +msgid "Mapping the Person class" +msgstr "Das Mappen der Personenklasse" + +#. Tag: para +#, fuzzy, no-c-format +msgid "The first cut of the <literal>Person</literal> class looks like this:" +msgstr "Der erste Teil der <literal>Person</literal>-Klasse ist einfach:" + +#. Tag: para +#, no-c-format +msgid "" +"Save this to a file named <filename>src/main/java/org/hibernate/tutorial/" +"domain/Person.java</filename>" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"Next, create the new mapping file as <filename>src/main/resources/org/" +"hibernate/tutorial/domain/Person.hbm.xml</filename>" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "Finally, add the new mapping to Hibernate's configuration:" +msgstr "" +"Anschließend fügen Sie dann das neue Mapping der Konfiguration von Hibernate " +"hinzu:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Create an association between these two entities. Persons can participate in " +"events, and events have participants. The design questions you have to deal " +"with are: directionality, multiplicity, and collection behavior." +msgstr "" +"Als nächstes wird eine Assoziation zwischen diesen beiden Entities erstellt. " +"Personen können an Veranstaltungen teilnehmen, und Veranstaltungen haben " +"Teilnehmer. Die zu klärenden Frage des Aufbaus beinhaltet die der " +"Richtungsabhängigkeit, Multiplizität und des Collection-Verhaltens." + +#. Tag: title +#, no-c-format +msgid "A unidirectional Set-based association" +msgstr "Eine unidirektionale \"Set\"-basierte Assoziation" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"By adding a collection of events to the <literal>Person</literal> class, you " +"can easily navigate to the events for a particular person, without executing " +"an explicit query - by calling <literal>Person#getEvents</literal>. Multi-" +"valued associations are represented in Hibernate by one of the Java " +"Collection Framework contracts; here we choose a <interfacename>java.util." +"Set</interfacename> because the collection will not contain duplicate " +"elements and the ordering is not relevant to our examples:" +msgstr "" +"Wir fügen der <literal>Person</literal>-Klasse eine Auswahl an " +"Veranstaltungen hinzu. Auf diese Weise können Sie bequem zu den " +"Veranstaltungen für eine bestimmte Person navigieren, ohne eine " +"ausdrückliche Anfrage auszuführen - durch Aufruf von <literal>aPerson." +"getEvents()</literal>. Wir verwenden eine Java-Collection, ein <literal>Set</" +"literal>, weil die Collection keine doppelten Elemente enthält und die " +"Reihenfolge für uns nicht von Bedeutung ist." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Before mapping this association, let's consider the other side. We could " +"just keep this unidirectional or create another collection on the " +"<literal>Event</literal>, if we wanted to be able to navigate it from both " +"directions. This is not necessary, from a functional perspective. You can " +"always execute an explicit query to retrieve the participants for a " +"particular event. This is a design choice left to you, but what is clear " +"from this discussion is the multiplicity of the association: \"many\" valued " +"on both sides is called a <emphasis>many-to-many</emphasis> association. " +"Hence, we use Hibernate's many-to-many mapping:" +msgstr "" +"Ehe wir diese Assoziation mappen, müssen wir uns ein paar Gedanken machen. " +"Natürlich könnten wir das Ganze unidirektional halten. Oder wir könnten eine " +"andere Collection im <literal>Event</literal> erstellen, wenn wir " +"bidirektional navigieren wollen, d.h. <literal>anEvent.getParticipants()</" +"literal>. Von einer rein funktionalen Perspektive aus betrachtet ist das " +"nicht notwendig.Sie könnten jederzeit eine ausdrückliche Anfrage ausführen, " +"um die Teilnehmer an einer bestimmten Veranstaltung zu ermitteln. Die Wahl " +"liegt hier ganz bei Ihnen. Was bei dieser Frage jedoch deutlich wird, ist " +"die Multiplizität der Assoziation: Da auf beiden Seiten \"mehr\"wertig, " +"nennen wir dies eine <emphasis>\"Many-to-Many\"</emphasis>-Assoziation. Wir " +"verwenden daher Hibernates \"Many-to-Many\"-Mapping:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate supports a broad range of collection mappings, a <literal>set</" +"literal> being most common. For a many-to-many association, or <emphasis>n:" +"m</emphasis> entity relationship, an association table is required. Each row " +"in this table represents a link between a person and an event. The table " +"name is decalred using the <literal>table</literal> attribute of the " +"<literal>set</literal> element. The identifier column name in the " +"association, for the person side, is defined with the <literal>key</literal> " +"element, the column name for the event's side with the <literal>column</" +"literal> attribute of the <literal>many-to-many</literal>. You also have to " +"tell Hibernate the class of the objects in your collection (the class on the " +"other side of the collection of references)." +msgstr "" +"Hibernate unterstützt alle Arten von Collection Mappings, mit <literal><" +"set></literal> als dem gängisten. Für eine \"Many-to-Many\"-Assoziation " +"(oder <emphasis>n:m</emphasis>-Entity-Beziehung), wird eine " +"Assoziationstabelle benötigt. Jede Reihe dieser Tabelle repräsentiert eine " +"Verbindung zwischen einer Person und einer Veranstaltung. Der Tabellenname " +"ist mit dem <literal>table</literal>-Attribut des <literal>set</literal>-" +"Elements konfiguriert. Der Identifier-Spaltenname in der Assoziation für die " +"Personenseite ist mit dem <literal><key></literal>-Element definiert, " +"der Spaltenname für die Veranstaltungsseite mit dem <literal>column</" +"literal>-Attribut von <literal><many-to-many></literal>. Sie müssen " +"Hibernate außerdem die Klasse der Objekte Ihrer Collection mitteilen " +"(korrekt: die Klasse auf der anderen Seite der Verweis-Collection)." + +#. Tag: para +#, no-c-format +msgid "The database schema for this mapping is therefore:" +msgstr "Das Datenbankschema für dieses Mapping lautet daher:" + +#. Tag: title +#, no-c-format +msgid "Working the association" +msgstr "Das Bearbeiten der Assoziation" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Now we will bring some people and events together in a new method in " +"<literal>EventManager</literal>:" +msgstr "" +"Nun werden einige Personen und Veranstaltungen in einer neuen Methode im " +"<literal>EventManager</literal> vereint:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"After loading a <literal>Person</literal> and an <literal>Event</literal>, " +"simply modify the collection using the normal collection methods. There is " +"no explicit call to <literal>update()</literal> or <literal>save()</" +"literal>; Hibernate automatically detects that the collection has been " +"modified and needs to be updated. This is called <emphasis>automatic dirty " +"checking</emphasis>. You can also try it by modifying the name or the date " +"property of any of your objects. As long as they are in " +"<emphasis>persistent</emphasis> state, that is, bound to a particular " +"Hibernate <interfacename>org.hibernate.Session</interfacename>, Hibernate " +"monitors any changes and executes SQL in a write-behind fashion. The process " +"of synchronizing the memory state with the database, usually only at the end " +"of a unit of work, is called <emphasis>flushing</emphasis>. In our code, the " +"unit of work ends with a commit, or rollback, of the database transaction." +msgstr "" +"Nach dem Laden einer <literal>Person</literal> und eines <literal>Event</" +"literal> (Veranstaltung), modifizieren Sie einfach die Collection mittels " +"der regulären Collection-Methoden. Wie Sie sehen, existiert kein expliziter " +"Aufruf für <literal>update()</literal> oder <literal>save()</literal>, " +"Hibernate stellt automatisch fest, dass die Collection verändert wurde und " +"aktualisiert werden muss. Dieser Vorgang ist unter der Bezeichnung <emphasis>" +"\"Automatic Dirty Checking\"</emphasis> (d.h. eine automatische " +"Modifizierungsprüfung) bekannt, und Sie können ihn auch ausprobieren, indem " +"Sie die Property des Namens oder des Datums eines Ihrer Objekte ändern. So " +"lange deren Status <emphasis>persistent</emphasis> ist, d.h. an eine " +"bestimmte Hibernate <literal>Session</literal> gebunden ist (d.h. sie wurden " +"gerade geladen oder in einer Arbeitseinheit gespeichert), überwacht " +"Hibernate sämtliche Änderungen und führt SQL mittels Hinterher-Speichern " +"(sog. \"write-behind\") aus. Der Vorgang der Synchronisation des " +"Speicherstatus mit der Datenbank - in der Regel am Ende einer Arbeitseinheit " +"- heißt <emphasis>Flushing</emphasis>. In unserem Code endet die " +"Arbeitseinheit mit dem Festschreiben (oder Zurücksetzen) der " +"Datenbanktransaktion, wie in der <literal>thread</literal>-" +"Konfigurationsoption für die <literal>CurrentSessionContext</literal>-Klasse " +"definiert." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can load person and event in different units of work. Or you can modify " +"an object outside of a <interfacename>org.hibernate.Session</interfacename>, " +"when it is not in persistent state (if it was persistent before, this state " +"is called <emphasis>detached</emphasis>). You can even modify a collection " +"when it is detached:" +msgstr "" +"Natürlich können Sie Person und Veranstaltung in verschiedenen " +"Arbeitseinheiten laden oder ein Objekt außerhalb einer <literal>Session</" +"literal> modifizieren, wenn es sich nicht in einem persistenten Status " +"befindet (falls es zuvor persistent war, so nennen wir diesen Status " +"<emphasis>\"detached\"</emphasis> d.h. abgesetzt). Sie können eine " +"Collection sogar modifizieren, wenn diese abgesetzt ist:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The call to <literal>update</literal> makes a detached object persistent " +"again by binding it to a new unit of work, so any modifications you made to " +"it while detached can be saved to the database. This includes any " +"modifications (additions/deletions) you made to a collection of that entity " +"object." +msgstr "" +"Der Aufruf <literal>update</literal> macht ein abgesetztes Objekt wieder " +"persistent, man könnte auch sagen, dass es sich an eine neue Arbeitseinheit " +"bindet. Alle von Ihnen in abgesetztem Zustand vorgenommenen Änderungen " +"können in der Datenbank gespeichert werden. Dies beinhaltet auch jegliche " +"Modifikationen (Hinzufügungen/Löschungen), die an der Collection dieses " +"Entity-Objekts vorgenommen wurden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This is not much use in our example, but it is an important concept you can " +"incorporate into your own application. Complete this exercise by adding a " +"new action to the main method of the <literal>EventManager</literal> and " +"call it from the command line. If you need the identifiers of a person and " +"an event - the <literal>save()</literal> method returns it (you might have " +"to modify some of the previous methods to return that identifier):" +msgstr "" +"Zwar hat das nicht viel mit unserer aktuellen Situation zu tun, aber es " +"handelt sich dennoch um ein wichtiges Konzept, das Sie in Ihrer eigenen " +"Anwendung ausführen können. Für den Moment vervollständigen Sie bitte diese " +"Übung durch Hinzufügen einer neuen Aktion zur Hauptmethode des " +"<literal>EventManager</literal>, und rufen Sie sie über die Befehlszeile " +"auf. Falls Sie die Identifier einer Person oder einer Veranstaltung " +"benötigen - die <literal>save()</literal>-Methode gibt diese wieder (es kann " +"sein, dass Sie einige der vorherigen Methoden ändern müssen, damit der " +"Identifier wiedergegeben wird):" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This is an example of an association between two equally important classes : " +"two entities. As mentioned earlier, there are other classes and types in a " +"typical model, usually \"less important\". Some you have already seen, like " +"an <literal>int</literal> or a <classname>java.lang.String</classname>. We " +"call these classes <emphasis>value types</emphasis>, and their instances " +"<emphasis>depend</emphasis> on a particular entity. Instances of these types " +"do not have their own identity, nor are they shared between entities. Two " +"persons do not reference the same <literal>firstname</literal> object, even " +"if they have the same first name. Value types cannot only be found in the " +"JDK , but you can also write dependent classes yourself such as an " +"<literal>Address</literal> or <literal>MonetaryAmount</literal> class. In " +"fact, in a Hibernate application all JDK classes are considered value types." +msgstr "" +"Dies war ein Beispiel für die Assoziation zweier gleich wichtiger Klassen, " +"zweier Entities. Wie bereits erwähnt, existieren auch andere Klassen und " +"Typen in einem typischen Modell, normalerweise \"weniger wichtige\". Einige " +"sind Ihnen bereits bekannt, so etwa <literal>int</literal> oder ein " +"<literal>String</literal>. Diese Klassen sind unter der Bezeichnung " +"<emphasis>Werttypen</emphasis> (sog. \"value types\") bekannt und ihre " +"Instanzen sind von einer bestimmten Entity <emphasis>abhängig</emphasis>. " +"Instanzen dieser Typen haben keine eigene Identität und werden nicht von den " +"Entities geteilt (zwei Personen verweisen nicht auf dasselbe " +"<literal>firstname</literal>-Objekt, selbst wenn sie denselben Vornamen " +"besitzen). Natürlich gibt es Werttypen nicht nur im JDK (genau genommen " +"werden in einer Hibernate Anwendung alle JDK-Klassen als Werttypen " +"angesehen), sondern Sie können abhängige Klassen auch selbst schreiben, wie " +"z.B. <literal>Address</literal> oder <literal>MonetaryAmount</literal>." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can also design a collection of value types. This is conceptually " +"different from a collection of references to other entities, but looks " +"almost the same in Java." +msgstr "" +"Sie können auch eine Collection von Werttypen entwerfen. Dies unterscheidet " +"sich konzeptionell sehr von einer Collection von Referenzen zu anderen " +"Entities, sieht aber in Java fast genauso aus." + +#. Tag: title +#, no-c-format +msgid "Collection of values" +msgstr "Collection von Werten" + +#. Tag: para +#, no-c-format +msgid "" +"Let's add a collection of email addresses to the <literal>Person</literal> " +"entity. This will be represented as a <interfacename>java.util.Set</" +"interfacename> of <classname>java.lang.String</classname> instances:" +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "The mapping of this <literal>Set</literal> is as follows:" +msgstr "Das Mapping dieses <literal>Set</literal>:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The difference compared with the earlier mapping is the use of the " +"<literal>element</literal> part which tells Hibernate that the collection " +"does not contain references to another entity, but is rather a collection " +"whose elements are values types, here specifically of type <literal>string</" +"literal>. The lowercase name tells you it is a Hibernate mapping type/" +"converter. Again the <literal>table</literal> attribute of the <literal>set</" +"literal> element determines the table name for the collection. The " +"<literal>key</literal> element defines the foreign-key column name in the " +"collection table. The <literal>column</literal> attribute in the " +"<literal>element</literal> element defines the column name where the email " +"address values will actually be stored." +msgstr "" +"Der Unterschied im Vergleich zu unserem früheren Mapping ist der " +"<literal>element</literal>-Teil, der Hibernate mitteilt, dass die Collection " +"keine Verweise zu einer anderen Entity enthält, sondern eine Collection von " +"Elementen des <literal>String</literal>-Typs (die Schreibweise des Namens in " +"Kleinbuchstaben zeigt an, dass es sich um einen Mapping-Typ/Converter von " +"Hibernate handelt). Auch hier bestimmt das <literal>table</literal>-Attribut " +"des <literal>set</literal>-Elements den Tabellennamen für die Collection. " +"Das <literal>key</literal>-Element definiert den Spaltennamen des " +"Fremdschlüssels in der Collection-Tabelle. Das <literal>column</literal>-" +"Attribut im <literal>element</literal>-Element definiert den Spaltennamen in " +"dem die <literal>String</literal>-Werte gespeichert werden." + +#. Tag: para +#, fuzzy, no-c-format +msgid "Here is the updated schema:" +msgstr "Werfen wir einen Blick auf das aktualisierte Schema:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can see that the primary key of the collection table is in fact a " +"composite key that uses both columns. This also implies that there cannot be " +"duplicate email addresses per person, which is exactly the semantics we need " +"for a set in Java." +msgstr "" +"Sie sehen, dass der Primärschlüssel der Collection-Tabelle ein " +"zusammengesetzter Schlüssel (sog. \"composite key\") ist, der beide Spalten " +"verwendet. Dies beinhaltet außerdem, dass keine doppelten E-Mail-Addressen " +"pro Person existieren können, was genau die für ein Set benötigte Semantik " +"in Java ist." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can now try to add elements to this collection, just like we did before " +"by linking persons and events. It is the same code in Java:" +msgstr "" +"Sie können nun versuchen, Elemente zu dieser Collection hinzuzufügen oder " +"dieser zu entnehmen, genau wie wir es zuvor bei der Verbindung von Personen " +"und Veranstaltungen getan haben. In Java ist es derselbe Code:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This time we did not use a <emphasis>fetch</emphasis> query to initialize " +"the collection. Monitor the SQL log and try to optimize this with an eager " +"fetch." +msgstr "" +"Dieses Mal haben wir keine <emphasis>\"Fetch\"</emphasis>-Anfrage verwendet, " +"um die Collection zu initialisieren. Der Aufruf an die \"Getter\"-Methode " +"wird eine zusätzliche Auswahl auslösen, um sie zu initialisieren, damit ein " +"Element hinzugefügt werden kann. Beobachten Sie das SQL-Protokoll und " +"versuchen Sie es durch \"eager Fetching\" (d.h. durch zusammengefasstes " +"Laden von Objekt und assoziierten Objekten mit Verbundoperationen) zu " +"optimieren." + +#. Tag: title +#, no-c-format +msgid "Bi-directional associations" +msgstr "Bidirektionale Assoziationen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Next you will map a bi-directional association. You will make the " +"association between person and event work from both sides in Java. The " +"database schema does not change, so you will still have many-to-many " +"multiplicity." +msgstr "" +"Als nächstes mappen wir eine bidirektionale Assoziation, so dass die " +"Assoziation zwischen zwischen Person und Veranstaltung in Java von beiden " +"Seiten aus funktioniert.Das Datenbankschema verändert sich natürlich nicht, " +"die \"Many-to-Many\"-Multiziplität bleibt weiterhin bestehen. Eine " +"relationale Datenbank ist flexibler als eine Netzwerk-Programmiersprache und " +"benötigt keine Navigationsrichtung - Daten können auf alle möglichen Arten " +"eingesehen und aufgerufen werden." + +#. Tag: para +#, no-c-format +msgid "" +"A relational database is more flexible than a network programming language, " +"in that it does not need a navigation direction; data can be viewed and " +"retrieved in any possible way." +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"First, add a collection of participants to the <literal>Event</literal> " +"class:" +msgstr "" +"Zuerst wird eine Collection von Teilnehmern der <literal>Event</literal> " +"Veranstaltungsklasse hinzugefügt:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Now map this side of the association in <literal>Event.hbm.xml</literal>." +msgstr "" +"Nun mappen Sie auch diese Seite der Assoziation in <literal>Event.hbm.xml</" +"literal>." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"These are normal <literal>set</literal> mappings in both mapping documents. " +"Notice that the column names in <literal>key</literal> and <literal>many-to-" +"many</literal> swap in both mapping documents. The most important addition " +"here is the <literal>inverse=\"true\"</literal> attribute in the " +"<literal>set</literal> element of the <literal>Event</literal>'s collection " +"mapping." +msgstr "" +"Wie Sie sehen handelt es sich um normale <literal>set</literal> Mappings in " +"beiden Mapping-Dokumenten. Beachten Sie, dass die Spaltennamen in " +"<literal>key</literal> und <literal>many-to-many</literal> in den beiden " +"Mapping-Dokumenten vertauscht sind. Die wichtigste Hinzufügung hier ist das " +"<literal>inverse=\"true\"</literal>-Attribut im <literal>set</literal>-" +"Element des Collection-Mappings des<literal>Event</literal>s." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"What this means is that Hibernate should take the other side, the " +"<literal>Person</literal> class, when it needs to find out information about " +"the link between the two. This will be a lot easier to understand once you " +"see how the bi-directional link between our two entities is created." +msgstr "" +"Dies teilt Hibernate mit, dass es die andere Seite - die <literal>Person</" +"literal>-Klasse - bei der Suche nach der Verbindung der beiden verwenden " +"soll. Nachdem gezeigt wurde, wie die bidirektionale Verbindung zwischen den " +"beiden Entities erstellt wird, wird das noch verständlicher." + +#. Tag: title +#, no-c-format +msgid "Working bi-directional links" +msgstr "Die Bearbeitung bidirektionaler Verbindungen" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"First, keep in mind that Hibernate does not affect normal Java semantics. " +"How did we create a link between a <literal>Person</literal> and an " +"<literal>Event</literal> in the unidirectional example? You add an instance " +"of <literal>Event</literal> to the collection of event references, of an " +"instance of <literal>Person</literal>. If you want to make this link bi-" +"directional, you have to do the same on the other side by adding a " +"<literal>Person</literal> reference to the collection in an <literal>Event</" +"literal>. This process of \"setting the link on both sides\" is absolutely " +"necessary with bi-directional links." +msgstr "" +"Zunächst sollten wir uns vergegenwärtigen, dass Hibernate keinen Einfluss " +"auf die normale Java-Semantik hat. Erinnern wir uns, wie wir eine Verbindung " +"zwischen einer <literal>Person</literal> und einem <literal>Event</literal> " +"(Veranstaltung) in dem unidirektionalen Beispiel hergestellt haben: Wir " +"haben der Collection von Veranstaltungsreferenzen einer Instanz von " +"<literal>Person</literal> eine <literal>Event</literal>-Instanz zugefügt. " +"Wenn wir diese Verbindung bidirektional machen wollen, so müssen wir " +"dasselbe auf der anderen Seite tun - also eine <literal>Person</literal>-" +"Referenz zur Collection in einem <literal>Event</literal> hinzufügen. Dieses " +"\"Setzen der Verbindung auf beiden Seiten\" ist essentiell, und Sie sollten " +"nie vergessen es zu tun." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Many developers program defensively and create link management methods to " +"correctly set both sides (for example, in <literal>Person</literal>):" +msgstr "" +"Zahlreiche Entwickler programmieren defensiv und erstellen eine Management-" +"Methoden Verbindung, um beide Seiten korrekt einzustellen, z.B. in " +"<literal>Person</literal>:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The get and set methods for the collection are now protected. This allows " +"classes in the same package and subclasses to still access the methods, but " +"prevents everybody else from altering the collections directly. Repeat the " +"steps for the collection on the other side." +msgstr "" +"Beachten Sie, dass die \"Get\" und \"Set\"-Methoden für die Collection nun " +"geschützt sind - die Klassen desselben Pakets und Unterklassen können nach " +"wie vor auf die Methoden zugreifen, aber (fast) niemand sonst kann direkt " +"Eingriffe an der Collection vornehmen. Es empfiehlt sich, dasselbe mit der " +"Collection auf der anderen Seite zu tun." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"What about the <literal>inverse</literal> mapping attribute? For you, and " +"for Java, a bi-directional link is simply a matter of setting the references " +"on both sides correctly. Hibernate, however, does not have enough " +"information to correctly arrange SQL <literal>INSERT</literal> and " +"<literal>UPDATE</literal> statements (to avoid constraint violations). " +"Making one side of the association <literal>inverse</literal> tells " +"Hibernate to consider it a <emphasis>mirror</emphasis> of the other side. " +"That is all that is necessary for Hibernate to resolve any issues that arise " +"when transforming a directional navigation model to a SQL database schema. " +"The rules are straightforward: all bi-directional associations need one side " +"as <literal>inverse</literal>. In a one-to-many association it has to be the " +"many-side, and in many-to-many association you can select either side." +msgstr "" +"Wie steht es um das <literal>inverse</literal>-Mapping-Attribut? Für Sie wie " +"auch für Java ist eine bidirektionale Verbindung lediglich eine Sache des " +"korrekten Setzens der Referenzen auf beiden Seiten. Hibernate hingegen " +"verfügt nicht über genügend Informationen, um SQL <literal>INSERT</literal> " +"und <literal>UPDATE</literal>-Anweisungen (um Coderegelverletzungen bei den " +"Randbedingung - sog. \"Constraint Violations\" - zu vermeiden) ordnungsgemäß " +"aufzubauen, und benötigt etwas Hilfe bei der korrekten Bearbeitung von " +"bidirektionalen Assoziationen. Ist eine Seite der Assoziation " +"<literal>inverse</literal> so wird sie von Hibernate ignoriert, da es diese " +"als einen <emphasis>Spiegel</emphasis> (\"Mirror\") der anderen Seite " +"ansieht. Das ist alles, was nötig ist, damit Hibernate alle Eventualitäten " +"bei der Transformation eines direktionalen Navigationsmodells in ein SQL " +"Datenbankschema erfolgreich bearbeitet. Die zu beachtenden Regeln sind " +"unkompliziert: Alle bidirektionalen Assoziationen benötigen eine " +"<literal>inverse</literal> Seite. In einer \"One-to-Many\"-Assoziation muss " +"das die \"Many\"-Seite, in einer \"Many-to-Many\"-Assoziation eine der " +"beiden Seiten sein." + +#. Tag: title +#, no-c-format +msgid "Part 3 - The EventManager web application" +msgstr "Teil 3 - Die EventManager-Webanwendung" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A Hibernate web application uses <literal>Session</literal> and " +"<literal>Transaction</literal> almost like a standalone application. " +"However, some common patterns are useful. You can now write an " +"<literal>EventManagerServlet</literal>. This servlet can list all events " +"stored in the database, and it provides an HTML form to enter new events." +msgstr "" +"Eine Hibernate Webanwendung verwendet <literal>Session</literal> und " +"<literal>Transaction</literal> beinahe wie eine selbständige Applikation. " +"Einige Muster sind jedoch hilfreich. Wir erstellen nun ein " +"<literal>EventManagerServlet</literal>. Dieses Servlet kann alle in der " +"Datenbank gespeicherten Veranstaltungen auflisten und bietet ein HTML-" +"Formular, in das neue Veranstaltungen eingetragen werden können." + +#. Tag: title +#, no-c-format +msgid "Writing the basic servlet" +msgstr "Das Schreiben des Grundservlets" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"First we need create our basic processing servlet. Since our servlet only " +"handles HTTP <literal>GET</literal> requests, we will only implement the " +"<literal>doGet()</literal> method:" +msgstr "" +"Das Servlet bearbeitet nur HTTP <literal>GET</literal>-Anfragen, daher wird " +"die <literal>doGet()</literal>-Methode implementiert:" + +#. Tag: para +#, no-c-format +msgid "" +"Save this servlet as <filename>src/main/java/org/hibernate/tutorial/web/" +"EventManagerServlet.java</filename>" +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The pattern applied here is called <emphasis>session-per-request</emphasis>. " +"When a request hits the servlet, a new Hibernate <literal>Session</literal> " +"is opened through the first call to <literal>getCurrentSession()</literal> " +"on the <literal>SessionFactory</literal>. A database transaction is then " +"started. All data access occurs inside a transaction irrespective of whether " +"the data is read or written. Do not use the auto-commit mode in applications." +msgstr "" +"Das hier verwendete Muster heißt <emphasis>Session-per-Request</emphasis> " +"(\"Session pro Anfrage\"). Wenn eine Anfrage beim Servlet eingeht, so wird " +"eine neue Hibernate <literal>Session</literal> mit der ersten Aufruf an " +"<literal>getCurrentSession()</literal> an der <literal>SessionFactory</" +"literal> geöffnet. Anschließend wird eine Datenbanktransaktion gestartet " +"— jeglicher Zugriff auf Daten muss innerhalb einer Transaktion " +"stattfinden, unabhängig davon, ob Daten gelesen oder geschrieben werden (der " +"Auto-Commit-Modus wird in Anwendungen nicht verwendet)." + +#. Tag: para +#, no-c-format +msgid "" +"Do <emphasis>not</emphasis> use a new Hibernate <literal>Session</literal> " +"for every database operation. Use one Hibernate <literal>Session</literal> " +"that is scoped to the whole request. Use <literal>getCurrentSession()</" +"literal>, so that it is automatically bound to the current Java thread." +msgstr "" +"Verwenden Sie <emphasis>keine</emphasis> neue Hibernate <literal>Session</" +"literal> für jeden Datenbankvorgang. Verwenden Sie eine Hibernate " +"<literal>Session</literal>, die die gesamte Anfrage umfasst. Verwenden Sie " +"<literal>getCurrentSession()</literal>, damit diese automatisch an den " +"aktuellen Java-Thread gebunden wird." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Next, the possible actions of the request are processed and the response " +"HTML is rendered. We will get to that part soon." +msgstr "" +"Als nächstes werden die möglichen Aktionen der Anfrage bearbeitet und die " +"HTML-Antwort gerendert. Dieser Teil wird in Kürze behandelt." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Finally, the unit of work ends when processing and rendering are complete. " +"If any problems occurred during processing or rendering, an exception will " +"be thrown and the database transaction rolled back. This completes the " +"<literal>session-per-request</literal> pattern. Instead of the transaction " +"demarcation code in every servlet, you could also write a servlet filter. " +"See the Hibernate website and Wiki for more information about this pattern " +"called <emphasis>Open Session in View</emphasis>. You will need it as soon " +"as you consider rendering your view in JSP, not in a servlet." +msgstr "" +"Die Arbeitseinheit endet schließlich, wenn Bearbeitung und Rendering " +"abgeschlossen sind. Falls es während der Bearbeitung und des Rendering zu " +"Problemen kommt, so wird eine Ausnahme gemeldet, und die " +"Datenbanktransaktion wird wiederholt. Das<literal>session-per-request</" +"literal>-Muster wird so vervollständigt. Statt des Demarkationscodes in " +"jedem Servlet können Sie auch einen Servlet-Filter schreiben. Auf der " +"Hibernate Webseite und Wiki finden Sie weitere Informationen zu diesem " +"Muster mit dem Namen <emphasis>Open Session in View</emphasis>— " +"(Ansicht der geöffneten Session) - Sie brauchen es, sobald Sie das Rendern " +"Ihrer Ansicht in JSP in Erwägung ziehen, nicht in einem Servlet." + +#. Tag: title +#, no-c-format +msgid "Processing and rendering" +msgstr "Bearbeitung und Rendering" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Now you can implement the processing of the request and the rendering of the " +"page." +msgstr "" +"Implementieren wir nun die Anfragenbearbeitung und das Rendern der Seite." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This coding style, with a mix of Java and HTML, would not scale in a more " +"complex application—keep in mind that we are only illustrating basic " +"Hibernate concepts in this tutorial. The code prints an HTML header and a " +"footer. Inside this page, an HTML form for event entry and a list of all " +"events in the database are printed. The first method is trivial and only " +"outputs HTML:" +msgstr "" +"Vorausgesetzt dieser Codierungsstil mit einer Mischung aus Java und HTML " +"würde in einer komplexeren Anwendung nicht skalieren — vergessen Sie " +"nicht, dass wir nur die grundlegenden Konzepte von Hibernate in dieser " +"Anleitung erläutern. Der Code druckt eine HTML-Kopf- und Fußzeile. Innerhalb " +"dieser Seite sind ein HTML-Formular für die Veranstaltungseingabe sowie eine " +"Liste sämtlicher Veranstaltungen in der Datenbank gedruckt. Die erste " +"Methode ist trivial und gibt nur HTML aus." + +#. Tag: para +#, no-c-format +msgid "" +"The <literal>listEvents()</literal> method uses the Hibernate " +"<literal>Session</literal> bound to the current thread to execute a query:" +msgstr "" +"Die <literal>listEvents()</literal> Methode verwendet die an den aktuellen " +"Thread gebundene Hibernate <literal>Session</literal> bei der Ausführung " +"einer Abfrage:" + +#. Tag: para +#, no-c-format +msgid "" +"Finally, the <literal>store</literal> action is dispatched to the " +"<literal>createAndStoreEvent()</literal> method, which also uses the " +"<literal>Session</literal> of the current thread:" +msgstr "" +"Zuletzt wird die <literal>store</literal>-Vorgang zur " +"<literal>createAndStoreEvent()</literal>-Methode gesendet, die ebenfalls die " +"<literal>Session</literal> des aktuellen Threads verwendet:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"The servlet is now complete. A request to the servlet will be processed in a " +"single <literal>Session</literal> and <literal>Transaction</literal>. As " +"earlier in the standalone application, Hibernate can automatically bind " +"these objects to the current thread of execution. This gives you the freedom " +"to layer your code and access the <literal>SessionFactory</literal> in any " +"way you like. Usually you would use a more sophisticated design and move the " +"data access code into data access objects (the DAO pattern). See the " +"Hibernate Wiki for more examples." +msgstr "" +"Das Servlet ist jetzt komplett. Eine Anfrage beim Servlet wird in einer " +"einzelnen <literal>Session</literal> und <literal>Transaction</literal> " +"bearbeitet. Wie zuvor in der selbständigen Anwendung kann Hibernate diese " +"Objekte automatisch an den aktuellen Ausführungsthread binden. Das gibt " +"Ihnen die Freiheit, Ihren Code zu schichten und in beliebiger Weise auf die " +"<literal>SessionFactory</literal> zuzugreifen. In der Regel würden Sie ein " +"differenzierteres Design verwenden und den Datenzugriffscode in die " +"Datenzugriffsobjekte (das DAO-Muster) verlegen. Auf Hibernate Wiki finden " +"Sie weitere Beispiele." + +#. Tag: title +#, no-c-format +msgid "Deploying and testing" +msgstr "Deployment und Test" + +#. Tag: para +#, no-c-format +msgid "" +"To deploy this application for testing we must create a Web ARchive (WAR). " +"First we must define the WAR descriptor as <filename>src/main/webapp/WEB-INF/" +"web.xml</filename>" +msgstr "" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"To build and deploy call <literal>mvn package</literal> in your project " +"directory and copy the <filename>hibernate-tutorial.war</filename> file into " +"your Tomcat <filename>webapps</filename> directory." +msgstr "" +"Um den <literal>ant war</literal>-Aufruf (\"call\") in Ihrem " +"Projektverzeichnis zu bauen und auszuführen, kopieren Sie die " +"<literal>hibernate-tutorial.war</literal>-Datei in Ihr Tomcat " +"<literal>webapp</literal>-Verzeichnis. Falls Tomcat bei Ihnen nicht " +"installiert ist, laden Sie es herunter, und folgen Sie den " +"Installationsanweisungen. Sie müssen jedoch keine Konfigurationen von Tomcat " +"ändern, um diese Anwendung auszuführen." + +#. Tag: para +#, no-c-format +msgid "" +"If you do not have Tomcat installed, download it from <ulink url=\"http://" +"tomcat.apache.org/\" /> and follow the installation instructions. Our " +"application requires no changes to the standard Tomcat configuration." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "" +"Once deployed and Tomcat is running, access the application at " +"<literal>http://localhost:8080/hibernate-tutorial/eventmanager</literal>. " +"Make sure you watch the Tomcat log to see Hibernate initialize when the " +"first request hits your servlet (the static initializer in " +"<literal>HibernateUtil</literal> is called) and to get the detailed output " +"if any exceptions occurs." +msgstr "" +"Wenn das Deployment erfolgt ist und Tomcat ausgeführt wird, greifen Sie " +"mittels <literal>http://localhost:8080/hibernate-tutorial/eventmanager</" +"literal> auf die Anwendung zu. Sehen Sie im Protokoll von Tomcat nach, ob " +"Hibernate initialisiert wird, wenn die erste Anfrage bei Ihrem Servlet " +"eingeht (das statische Initialisierungsprogramm in <literal>HibernateUtil</" +"literal> wird aufgerufen), und prüfen Sie die detaillierte Ausgabe nach " +"Ausnahmen." + +#. Tag: title +#, no-c-format +msgid "Summary" +msgstr "Zusammenfassung" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This tutorial covered the basics of writing a simple standalone Hibernate " +"application and a small web application. More tutorials are available from " +"the Hibernate <ulink url=\"http://hibernate.org\">website</ulink>." +msgstr "" +"Diese Anleitung behandelt in Grundzügen die Erstellung einer einfachen " +"selbständigen Hibernate-Applikation und einer kleinen Webanwendung." + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[package org.hibernate.tutorial.domain;\n" +#~ "\n" +#~ "import java.util.Date;\n" +#~ "\n" +#~ "public class Event {\n" +#~ " private Long id;\n" +#~ "\n" +#~ " private String title;\n" +#~ " private Date date;\n" +#~ "\n" +#~ " public Event() {}\n" +#~ "\n" +#~ " public Long getId() {\n" +#~ " return id;\n" +#~ " }\n" +#~ "\n" +#~ " private void setId(Long id) {\n" +#~ " this.id = id;\n" +#~ " }\n" +#~ "\n" +#~ " public Date getDate() {\n" +#~ " return date;\n" +#~ " }\n" +#~ "\n" +#~ " public void setDate(Date date) {\n" +#~ " this.date = date;\n" +#~ " }\n" +#~ "\n" +#~ " public String getTitle() {\n" +#~ " return title;\n" +#~ " }\n" +#~ "\n" +#~ " public void setTitle(String title) {\n" +#~ " this.title = title;\n" +#~ " }\n" +#~ "}]]>" +#~ msgstr "" +#~ "package events;\n" +#~ "\n" +#~ "import java.util.Date;\n" +#~ "\n" +#~ "public class Event {\n" +#~ " private Long id;\n" +#~ "\n" +#~ " private String title;\n" +#~ " private Date date;\n" +#~ "\n" +#~ " public Event() {}\n" +#~ "\n" +#~ " public Long getId() {\n" +#~ " return id;\n" +#~ " }\n" +#~ "\n" +#~ " private void setId(Long id) {\n" +#~ " this.id = id;\n" +#~ " }\n" +#~ "\n" +#~ " public Date getDate() {\n" +#~ " return date;\n" +#~ " }\n" +#~ "\n" +#~ " public void setDate(Date date) {\n" +#~ " this.date = date;\n" +#~ " }\n" +#~ "\n" +#~ " public String getTitle() {\n" +#~ " return title;\n" +#~ " }\n" +#~ "\n" +#~ " public void setTitle(String title) {\n" +#~ " this.title = title;\n" +#~ " }\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<?xml version=\"1.0\"?>\n" +#~ "<!DOCTYPE hibernate-mapping PUBLIC\n" +#~ " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" +#~ " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" +#~ "\n" +#~ "<hibernate-mapping package=\"org.hibernate.tutorial.domain\">\n" +#~ "[...]\n" +#~ "</hibernate-mapping>]]>" +#~ msgstr "" +#~ "<?xml version=\"1.0\"?>\n" +#~ "<!DOCTYPE hibernate-mapping PUBLIC\n" +#~ " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" +#~ " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd" +#~ "\">\n" +#~ "\n" +#~ "<hibernate-mapping>\n" +#~ "[...]\n" +#~ "</hibernate-mapping>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<hibernate-mapping package=\"org.hibernate.tutorial.domain\">\n" +#~ "\n" +#~ " <class name=\"Event\" table=\"EVENTS\">\n" +#~ "\n" +#~ " </class>\n" +#~ "\n" +#~ "</hibernate-mapping>]]>" +#~ msgstr "" +#~ "<hibernate-mapping>\n" +#~ "\n" +#~ " <class name=\"events.Event\" table=\"EVENTS\">\n" +#~ "\n" +#~ " </class>\n" +#~ "\n" +#~ "</hibernate-mapping>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<hibernate-mapping package=\"org.hibernate.tutorial.domain\">\n" +#~ "\n" +#~ " <class name=\"Event\" table=\"EVENTS\">\n" +#~ " <id name=\"id\" column=\"EVENT_ID\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " </class>\n" +#~ "\n" +#~ "</hibernate-mapping>]]>" +#~ msgstr "" +#~ "<hibernate-mapping>\n" +#~ "\n" +#~ " <class name=\"events.Event\" table=\"EVENTS\">\n" +#~ " <id name=\"id\" column=\"EVENT_ID\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " </class>\n" +#~ "\n" +#~ "</hibernate-mapping>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[\n" +#~ "<hibernate-mapping package=\"org.hibernate.tutorial.domain\">\n" +#~ "\n" +#~ " <class name=\"Event\" table=\"EVENTS\">\n" +#~ " <id name=\"id\" column=\"EVENT_ID\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <property name=\"date\" type=\"timestamp\" column=\"EVENT_DATE\"/" +#~ ">\n" +#~ " <property name=\"title\"/>\n" +#~ " </class>\n" +#~ "\n" +#~ "</hibernate-mapping>]]>" +#~ msgstr "" +#~ "<hibernate-mapping>\n" +#~ "\n" +#~ " <class name=\"events.Event\" table=\"EVENTS\">\n" +#~ " <id name=\"id\" column=\"EVENT_ID\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <property name=\"date\" type=\"timestamp\" column=\"EVENT_DATE" +#~ "\"/>\n" +#~ " <property name=\"title\"/>\n" +#~ " </class>\n" +#~ "\n" +#~ "</hibernate-mapping>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<?xml version='1.0' encoding='utf-8'?>\n" +#~ "<!DOCTYPE hibernate-configuration PUBLIC\n" +#~ " \"-//Hibernate/Hibernate Configuration DTD 3.0//EN\"\n" +#~ " \"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd" +#~ "\">\n" +#~ "\n" +#~ "<hibernate-configuration>\n" +#~ "\n" +#~ " <session-factory>\n" +#~ "\n" +#~ " \n" +#~ " <property name=\"connection.driver_class\">org.hsqldb.jdbcDriver</" +#~ "property>\n" +#~ " <property name=\"connection.url\">jdbc:hsqldb:hsql://localhost</" +#~ "property>\n" +#~ " <property name=\"connection.username\">sa</property>\n" +#~ " <property name=\"connection.password\"></property>\n" +#~ "\n" +#~ " \n" +#~ " <property name=\"connection.pool_size\">1</property>\n" +#~ "\n" +#~ " \n" +#~ " <property name=\"dialect\">org.hibernate.dialect.HSQLDialect</" +#~ "property>\n" +#~ "\n" +#~ " \n" +#~ " <property name=\"current_session_context_class\">thread</" +#~ "property>\n" +#~ "\n" +#~ " \n" +#~ " <property name=\"cache.provider_class\">org.hibernate.cache." +#~ "NoCacheProvider</property>\n" +#~ "\n" +#~ " \n" +#~ " <property name=\"show_sql\">true</property>\n" +#~ "\n" +#~ " \n" +#~ " <property name=\"hbm2ddl.auto\">update</property>\n" +#~ "\n" +#~ " <mapping resource=\"org/hibernate/tutorial/domain/Event.hbm.xml\"/" +#~ ">\n" +#~ "\n" +#~ " </session-factory>\n" +#~ "\n" +#~ "</hibernate-configuration>]]>" +#~ msgstr "" +#~ "<?xml version='1.0' encoding='utf-8'?>\n" +#~ "<!DOCTYPE hibernate-configuration PUBLIC\n" +#~ " \"-//Hibernate/Hibernate Configuration DTD 3.0//EN\"\n" +#~ " \"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd" +#~ "\">\n" +#~ "\n" +#~ "<hibernate-configuration>\n" +#~ "\n" +#~ " <session-factory>\n" +#~ "\n" +#~ " \n" +#~ " <property name=\"connection.driver_class\">org.hsqldb." +#~ "jdbcDriver</property>\n" +#~ " <property name=\"connection.url\">jdbc:hsqldb:hsql://" +#~ "localhost</property>\n" +#~ " <property name=\"connection.username\">sa</property>\n" +#~ " <property name=\"connection.password\"></property>\n" +#~ "\n" +#~ " \n" +#~ " <property name=\"connection.pool_size\">1</property>\n" +#~ "\n" +#~ " \n" +#~ " <property name=\"dialect\">org.hibernate.dialect." +#~ "HSQLDialect</property>\n" +#~ "\n" +#~ " \n" +#~ " <property name=\"cache.provider_class\">org.hibernate.cache." +#~ "NoCacheProvider</property>\n" +#~ "\n" +#~ " \n" +#~ " <property name=\"show_sql\">true</property>\n" +#~ "\n" +#~ " \n" +#~ " <property name=\"hbm2ddl.auto\">create</property>\n" +#~ "\n" +#~ " <mapping resource=\"events/Event.hbm.xml\"/>\n" +#~ "\n" +#~ " </session-factory>\n" +#~ "\n" +#~ "</hibernate-configuration>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[package org.hibernate.tutorial.util;\n" +#~ "\n" +#~ "import org.hibernate.SessionFactory;\n" +#~ "import org.hibernate.cfg.Configuration;\n" +#~ "\n" +#~ "public class HibernateUtil {\n" +#~ "\n" +#~ " private static final SessionFactory sessionFactory = " +#~ "buildSessionFactory();\n" +#~ "\n" +#~ " private static SessionFactory buildSessionFactory() {\n" +#~ " try {\n" +#~ " // Create the SessionFactory from hibernate.cfg.xml\n" +#~ " return new Configuration().configure().buildSessionFactory" +#~ "();\n" +#~ " }\n" +#~ " catch (Throwable ex) {\n" +#~ " // Make sure you log the exception, as it might be swallowed\n" +#~ " System.err.println(\"Initial SessionFactory creation failed." +#~ "\" + ex);\n" +#~ " throw new ExceptionInInitializerError(ex);\n" +#~ " }\n" +#~ " }\n" +#~ "\n" +#~ " public static SessionFactory getSessionFactory() {\n" +#~ " return sessionFactory;\n" +#~ " }\n" +#~ "\n" +#~ "}]]>" +#~ msgstr "" +#~ "package util;\n" +#~ "\n" +#~ "import org.hibernate.*;\n" +#~ "import org.hibernate.cfg.*;\n" +#~ "\n" +#~ "public class HibernateUtil {\n" +#~ "\n" +#~ " private static final SessionFactory sessionFactory;\n" +#~ "\n" +#~ " static {\n" +#~ " try {\n" +#~ " // Create the SessionFactory from hibernate.cfg.xml\n" +#~ " sessionFactory = new Configuration().configure()." +#~ "buildSessionFactory();\n" +#~ " } catch (Throwable ex) {\n" +#~ " // Make sure you log the exception, as it might be swallowed\n" +#~ " System.err.println(\"Initial SessionFactory creation failed." +#~ "\" + ex);\n" +#~ " throw new ExceptionInInitializerError(ex);\n" +#~ " }\n" +#~ " }\n" +#~ "\n" +#~ " public static SessionFactory getSessionFactory() {\n" +#~ " return sessionFactory;\n" +#~ " }\n" +#~ "\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[package org.hibernate.tutorial;\n" +#~ "\n" +#~ "import org.hibernate.Session;\n" +#~ "\n" +#~ "import java.util.*;\n" +#~ "\n" +#~ "import org.hibernate.tutorial.domain.Event;\n" +#~ "import org.hibernate.tutorial.util.HibernateUtil;\n" +#~ "\n" +#~ "public class EventManager {\n" +#~ "\n" +#~ " public static void main(String[] args) {\n" +#~ " EventManager mgr = new EventManager();\n" +#~ "\n" +#~ " if (args[0].equals(\"store\")) {\n" +#~ " mgr.createAndStoreEvent(\"My Event\", new Date());\n" +#~ " }\n" +#~ "\n" +#~ " HibernateUtil.getSessionFactory().close();\n" +#~ " }\n" +#~ "\n" +#~ " private void createAndStoreEvent(String title, Date theDate) {\n" +#~ " Session session = HibernateUtil.getSessionFactory()." +#~ "getCurrentSession();\n" +#~ " session.beginTransaction();\n" +#~ "\n" +#~ " Event theEvent = new Event();\n" +#~ " theEvent.setTitle(title);\n" +#~ " theEvent.setDate(theDate);\n" +#~ " session.save(theEvent);\n" +#~ "\n" +#~ " session.getTransaction().commit();\n" +#~ " }\n" +#~ "\n" +#~ "}]]>" +#~ msgstr "" +#~ "package events;\n" +#~ "import org.hibernate.Session;\n" +#~ "\n" +#~ "import java.util.Date;\n" +#~ "\n" +#~ "import util.HibernateUtil;\n" +#~ "\n" +#~ "public class EventManager {\n" +#~ "\n" +#~ " public static void main(String[] args) {\n" +#~ " EventManager mgr = new EventManager();\n" +#~ "\n" +#~ " if (args[0].equals(\"store\")) {\n" +#~ " mgr.createAndStoreEvent(\"My Event\", new Date());\n" +#~ " }\n" +#~ "\n" +#~ " HibernateUtil.getSessionFactory().close();\n" +#~ " }\n" +#~ "\n" +#~ " private void createAndStoreEvent(String title, Date theDate) {\n" +#~ "\n" +#~ " Session session = HibernateUtil.getSessionFactory()." +#~ "getCurrentSession();\n" +#~ "\n" +#~ " session.beginTransaction();\n" +#~ "\n" +#~ " Event theEvent = new Event();\n" +#~ " theEvent.setTitle(title);\n" +#~ " theEvent.setDate(theDate);\n" +#~ "\n" +#~ " session.save(theEvent);\n" +#~ "\n" +#~ " session.getTransaction().commit();\n" +#~ " }\n" +#~ "\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[[java] Hibernate: insert into EVENTS (EVENT_DATE, title, " +#~ "EVENT_ID) values (?, ?, ?)]]>" +#~ msgstr "" +#~ "[java] Hibernate: insert into EVENTS (EVENT_DATE, title, EVENT_ID) values " +#~ "(?, ?, ?)" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[ if (args[0].equals(\"store\")) {\n" +#~ " mgr.createAndStoreEvent(\"My Event\", new Date());\n" +#~ " }\n" +#~ " else if (args[0].equals(\"list\")) {\n" +#~ " List events = mgr.listEvents();\n" +#~ " for (int i = 0; i < events.size(); i++) {\n" +#~ " Event theEvent = (Event) events.get(i);\n" +#~ " System.out.println(\n" +#~ " \"Event: \" + theEvent.getTitle() + \" Time: \" + " +#~ "theEvent.getDate()\n" +#~ " );\n" +#~ " }\n" +#~ " }]]>" +#~ msgstr "" +#~ "if (args[0].equals(\"store\")) {\n" +#~ " mgr.createAndStoreEvent(\"My Event\", new Date());\n" +#~ "}\n" +#~ "else if (args[0].equals(\"list\")) {\n" +#~ " List events = mgr.listEvents();\n" +#~ " for (int i = 0; i < events.size(); i++) {\n" +#~ " Event theEvent = (Event) events.get(i);\n" +#~ " System.out.println(\"Event: \" + theEvent.getTitle() +\n" +#~ " \" Time: \" + theEvent.getDate());\n" +#~ " }\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[ private List listEvents() {\n" +#~ " Session session = HibernateUtil.getSessionFactory()." +#~ "getCurrentSession();\n" +#~ " session.beginTransaction();\n" +#~ " List result = session.createQuery(\"from Event\").list();\n" +#~ " session.getTransaction().commit();\n" +#~ " return result;\n" +#~ " }]]>" +#~ msgstr "" +#~ "private List listEvents() {\n" +#~ "\n" +#~ " Session session = HibernateUtil.getSessionFactory().getCurrentSession" +#~ "();\n" +#~ "\n" +#~ " session.beginTransaction();\n" +#~ "\n" +#~ " List result = session.createQuery(\"from Event\").list();\n" +#~ "\n" +#~ " session.getTransaction().commit();\n" +#~ "\n" +#~ " return result;\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[package org.hibernate.tutorial.domain;\n" +#~ "\n" +#~ "public class Person {\n" +#~ "\n" +#~ " private Long id;\n" +#~ " private int age;\n" +#~ " private String firstname;\n" +#~ " private String lastname;\n" +#~ "\n" +#~ " public Person() {}\n" +#~ "\n" +#~ " // Accessor methods for all properties, private setter for 'id'\n" +#~ "\n" +#~ "}]]>" +#~ msgstr "" +#~ "package events;\n" +#~ "\n" +#~ "public class Person {\n" +#~ "\n" +#~ " private Long id;\n" +#~ " private int age;\n" +#~ " private String firstname;\n" +#~ " private String lastname;\n" +#~ "\n" +#~ " public Person() {}\n" +#~ "\n" +#~ " // Accessor methods for all properties, private setter for 'id'\n" +#~ "\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<hibernate-mapping package=\"org.hibernate.tutorial.domain\">\n" +#~ "\n" +#~ " <class name=\"Person\" table=\"PERSON\">\n" +#~ " <id name=\"id\" column=\"PERSON_ID\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <property name=\"age\"/>\n" +#~ " <property name=\"firstname\"/>\n" +#~ " <property name=\"lastname\"/>\n" +#~ " </class>\n" +#~ "\n" +#~ "</hibernate-mapping>]]>" +#~ msgstr "" +#~ "<hibernate-mapping>\n" +#~ "\n" +#~ " <class name=\"events.Person\" table=\"PERSON\">\n" +#~ " <id name=\"id\" column=\"PERSON_ID\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <property name=\"age\"/>\n" +#~ " <property name=\"firstname\"/>\n" +#~ " <property name=\"lastname\"/>\n" +#~ " </class>\n" +#~ "\n" +#~ "</hibernate-mapping>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<mapping resource=\"events/Event.hbm.xml\"/>\n" +#~ "<mapping resource=\"events/Person.hbm.xml\"/>]]>" +#~ msgstr "" +#~ "<mapping resource=\"events/Event.hbm.xml\"/>\n" +#~ "<mapping resource=\"events/Person.hbm.xml\"/>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[public class Person {\n" +#~ "\n" +#~ " private Set events = new HashSet();\n" +#~ "\n" +#~ " public Set getEvents() {\n" +#~ " return events;\n" +#~ " }\n" +#~ "\n" +#~ " public void setEvents(Set events) {\n" +#~ " this.events = events;\n" +#~ " }\n" +#~ "}]]>" +#~ msgstr "" +#~ "public class Person {\n" +#~ "\n" +#~ " private Set events = new HashSet();\n" +#~ "\n" +#~ " public Set getEvents() {\n" +#~ " return events;\n" +#~ " }\n" +#~ "\n" +#~ " public void setEvents(Set events) {\n" +#~ " this.events = events;\n" +#~ " }\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Person\" table=\"PERSON\">\n" +#~ " <id name=\"id\" column=\"PERSON_ID\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <property name=\"age\"/>\n" +#~ " <property name=\"firstname\"/>\n" +#~ " <property name=\"lastname\"/>\n" +#~ "\n" +#~ " <set name=\"events\" table=\"PERSON_EVENT\">\n" +#~ " <key column=\"PERSON_ID\"/>\n" +#~ " <many-to-many column=\"EVENT_ID\" class=\"Event\"/>\n" +#~ " </set>\n" +#~ "\n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"events.Person\" table=\"PERSON\">\n" +#~ " <id name=\"id\" column=\"PERSON_ID\">\n" +#~ " <generator class=\"native\"/>\n" +#~ " </id>\n" +#~ " <property name=\"age\"/>\n" +#~ " <property name=\"firstname\"/>\n" +#~ " <property name=\"lastname\"/>\n" +#~ "\n" +#~ " <set name=\"events\" table=\"PERSON_EVENT\">\n" +#~ " <key column=\"PERSON_ID\"/>\n" +#~ " <many-to-many column=\"EVENT_ID\" class=\"events.Event\"/>\n" +#~ " </set>\n" +#~ "\n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[\n" +#~ " _____________ __________________\n" +#~ " | | | | _____________\n" +#~ " | EVENTS | | PERSON_EVENT | | |\n" +#~ " |_____________| |__________________| | PERSON |\n" +#~ " | | | | |_____________|\n" +#~ " | *EVENT_ID | <--> | *EVENT_ID | | |\n" +#~ " | EVENT_DATE | | *PERSON_ID | <--> | *PERSON_ID |\n" +#~ " | TITLE | |__________________| | AGE |\n" +#~ " |_____________| | FIRSTNAME |\n" +#~ " | LASTNAME |\n" +#~ " |_____________|\n" +#~ " ]]>" +#~ msgstr "" +#~ "_____________ __________________\n" +#~ " | | | | _____________\n" +#~ " | EVENTS | | PERSON_EVENT | | |\n" +#~ " |_____________| |__________________| | PERSON |\n" +#~ " | | | | |_____________|\n" +#~ " | *EVENT_ID | <--> | *EVENT_ID | | |\n" +#~ " | EVENT_DATE | | *PERSON_ID | <--> | *PERSON_ID |\n" +#~ " | TITLE | |__________________| | AGE |\n" +#~ " |_____________| | FIRSTNAME |\n" +#~ " | LASTNAME |\n" +#~ " |_____________|" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[ private void addPersonToEvent(Long personId, Long eventId) " +#~ "{\n" +#~ " Session session = HibernateUtil.getSessionFactory()." +#~ "getCurrentSession();\n" +#~ " session.beginTransaction();\n" +#~ "\n" +#~ " Person aPerson = (Person) session.load(Person.class, personId);\n" +#~ " Event anEvent = (Event) session.load(Event.class, eventId);\n" +#~ " aPerson.getEvents().add(anEvent);\n" +#~ "\n" +#~ " session.getTransaction().commit();\n" +#~ " }]]>" +#~ msgstr "" +#~ "private void addPersonToEvent(Long personId, Long eventId) {\n" +#~ "\n" +#~ " Session session = HibernateUtil.getSessionFactory().getCurrentSession" +#~ "();\n" +#~ " session.beginTransaction();\n" +#~ "\n" +#~ " Person aPerson = (Person) session.load(Person.class, personId);\n" +#~ " Event anEvent = (Event) session.load(Event.class, eventId);\n" +#~ "\n" +#~ " aPerson.getEvents().add(anEvent);\n" +#~ "\n" +#~ " session.getTransaction().commit();\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[ private void addPersonToEvent(Long personId, Long eventId) " +#~ "{\n" +#~ " Session session = HibernateUtil.getSessionFactory()." +#~ "getCurrentSession();\n" +#~ " session.beginTransaction();\n" +#~ "\n" +#~ " Person aPerson = (Person) session\n" +#~ " .createQuery(\"select p from Person p left join fetch p." +#~ "events where p.id = :pid\")\n" +#~ " .setParameter(\"pid\", personId)\n" +#~ " .uniqueResult(); // Eager fetch the collection so we can " +#~ "use it detached\n" +#~ " Event anEvent = (Event) session.load(Event.class, eventId);\n" +#~ "\n" +#~ " session.getTransaction().commit();\n" +#~ "\n" +#~ " // End of first unit of work\n" +#~ "\n" +#~ " aPerson.getEvents().add(anEvent); // aPerson (and its collection) " +#~ "is detached\n" +#~ "\n" +#~ " // Begin second unit of work\n" +#~ "\n" +#~ " Session session2 = HibernateUtil.getSessionFactory()." +#~ "getCurrentSession();\n" +#~ " session2.beginTransaction();\n" +#~ " session2.update(aPerson); // Reattachment of aPerson\n" +#~ "\n" +#~ " session2.getTransaction().commit();\n" +#~ " }]]>" +#~ msgstr "" +#~ "private void addPersonToEvent(Long personId, Long eventId) {\n" +#~ "\n" +#~ " Session session = HibernateUtil.getSessionFactory().getCurrentSession" +#~ "();\n" +#~ " session.beginTransaction();\n" +#~ "\n" +#~ " Person aPerson = (Person) session\n" +#~ " .createQuery(\"select p from Person p left join fetch p." +#~ "events where p.id = :pid\")\n" +#~ " .setParameter(\"pid\", personId)\n" +#~ " .uniqueResult(); // Eager fetch the collection so we can use " +#~ "it detached\n" +#~ "\n" +#~ " Event anEvent = (Event) session.load(Event.class, eventId);\n" +#~ "\n" +#~ " session.getTransaction().commit();\n" +#~ "\n" +#~ " // End of first unit of work\n" +#~ "\n" +#~ " aPerson.getEvents().add(anEvent); // aPerson (and its collection) is " +#~ "detached\n" +#~ "\n" +#~ " // Begin second unit of work\n" +#~ "\n" +#~ " Session session2 = HibernateUtil.getSessionFactory().getCurrentSession" +#~ "();\n" +#~ " session2.beginTransaction();\n" +#~ "\n" +#~ " session2.update(aPerson); // Reattachment of aPerson\n" +#~ "\n" +#~ " session2.getTransaction().commit();\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[ else if (args[0].equals(\"addpersontoevent\")) {\n" +#~ " Long eventId = mgr.createAndStoreEvent(\"My Event\", new Date" +#~ "());\n" +#~ " Long personId = mgr.createAndStorePerson(\"Foo\", \"Bar\");\n" +#~ " mgr.addPersonToEvent(personId, eventId);\n" +#~ " System.out.println(\"Added person \" + personId + \" to event " +#~ "\" + eventId);\n" +#~ " }]]>" +#~ msgstr "" +#~ "else if (args[0].equals(\"addpersontoevent\")) {\n" +#~ " Long eventId = mgr.createAndStoreEvent(\"My Event\", new Date());\n" +#~ " Long personId = mgr.createAndStorePerson(\"Foo\", \"Bar\");\n" +#~ " mgr.addPersonToEvent(personId, eventId);\n" +#~ " System.out.println(\"Added person \" + personId + \" to event \" + " +#~ "eventId);\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[ private Set emailAddresses = new HashSet();\n" +#~ "\n" +#~ " public Set getEmailAddresses() {\n" +#~ " return emailAddresses;\n" +#~ " }\n" +#~ "\n" +#~ " public void setEmailAddresses(Set emailAddresses) {\n" +#~ " this.emailAddresses = emailAddresses;\n" +#~ " }]]>" +#~ msgstr "" +#~ "private Set emailAddresses = new HashSet();\n" +#~ "\n" +#~ "public Set getEmailAddresses() {\n" +#~ " return emailAddresses;\n" +#~ "}\n" +#~ "\n" +#~ "public void setEmailAddresses(Set emailAddresses) {\n" +#~ " this.emailAddresses = emailAddresses;\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[ <set name=\"emailAddresses\" table=\"PERSON_EMAIL_ADDR" +#~ "\">\n" +#~ " <key column=\"PERSON_ID\"/>\n" +#~ " <element type=\"string\" column=\"EMAIL_ADDR\"/>\n" +#~ " </set>]]>" +#~ msgstr "" +#~ "<set name=\"emailAddresses\" table=\"PERSON_EMAIL_ADDR\">\n" +#~ " <key column=\"PERSON_ID\"/>\n" +#~ " <element type=\"string\" column=\"EMAIL_ADDR\"/>\n" +#~ "</set>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[\n" +#~ " _____________ __________________\n" +#~ " | | | | _____________\n" +#~ " | EVENTS | | PERSON_EVENT | | | " +#~ "___________________\n" +#~ " |_____________| |__________________| | PERSON | " +#~ "| |\n" +#~ " | | | | |_____________| | " +#~ "PERSON_EMAIL_ADDR |\n" +#~ " | *EVENT_ID | <--> | *EVENT_ID | | | |" +#~ "___________________|\n" +#~ " | EVENT_DATE | | *PERSON_ID | <--> | *PERSON_ID | <--> | " +#~ "*PERSON_ID |\n" +#~ " | TITLE | |__________________| | AGE | | " +#~ "*EMAIL_ADDR |\n" +#~ " |_____________| | FIRSTNAME | |" +#~ "___________________|\n" +#~ " | LASTNAME |\n" +#~ " |_____________|\n" +#~ " ]]>" +#~ msgstr "" +#~ "_____________ __________________\n" +#~ " | | | | _____________\n" +#~ " | EVENTS | | PERSON_EVENT | | | " +#~ "___________________\n" +#~ " |_____________| |__________________| | PERSON | " +#~ "| |\n" +#~ " | | | | |_____________| | " +#~ "PERSON_EMAIL_ADDR |\n" +#~ " | *EVENT_ID | <--> | *EVENT_ID | | " +#~ "| |___________________|\n" +#~ " | EVENT_DATE | | *PERSON_ID | <--> | *PERSON_ID | " +#~ "<--> | *PERSON_ID |\n" +#~ " | TITLE | |__________________| | AGE | | " +#~ "*EMAIL_ADDR |\n" +#~ " |_____________| | FIRSTNAME | |" +#~ "___________________|\n" +#~ " | LASTNAME |\n" +#~ " |_____________|" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[ private void addEmailToPerson(Long personId, String " +#~ "emailAddress) {\n" +#~ " Session session = HibernateUtil.getSessionFactory()." +#~ "getCurrentSession();\n" +#~ " session.beginTransaction();\n" +#~ "\n" +#~ " Person aPerson = (Person) session.load(Person.class, personId);\n" +#~ " // adding to the emailAddress collection might trigger a lazy " +#~ "load of the collection\n" +#~ " aPerson.getEmailAddresses().add(emailAddress);\n" +#~ "\n" +#~ " session.getTransaction().commit();\n" +#~ " }]]>" +#~ msgstr "" +#~ "private void addEmailToPerson(Long personId, String emailAddress) {\n" +#~ "\n" +#~ " Session session = HibernateUtil.getSessionFactory().getCurrentSession" +#~ "();\n" +#~ " session.beginTransaction();\n" +#~ "\n" +#~ " Person aPerson = (Person) session.load(Person.class, personId);\n" +#~ "\n" +#~ " // The getEmailAddresses() might trigger a lazy load of the " +#~ "collection\n" +#~ " aPerson.getEmailAddresses().add(emailAddress);\n" +#~ "\n" +#~ " session.getTransaction().commit();\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[ private Set participants = new HashSet();\n" +#~ "\n" +#~ " public Set getParticipants() {\n" +#~ " return participants;\n" +#~ " }\n" +#~ "\n" +#~ " public void setParticipants(Set participants) {\n" +#~ " this.participants = participants;\n" +#~ " }]]>" +#~ msgstr "" +#~ "private Set participants = new HashSet();\n" +#~ "\n" +#~ "public Set getParticipants() {\n" +#~ " return participants;\n" +#~ "}\n" +#~ "\n" +#~ "public void setParticipants(Set participants) {\n" +#~ " this.participants = participants;\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[ <set name=\"participants\" table=\"PERSON_EVENT\" " +#~ "inverse=\"true\">\n" +#~ " <key column=\"EVENT_ID\"/>\n" +#~ " <many-to-many column=\"PERSON_ID\" class=\"events.Person\"/>\n" +#~ " </set>]]>" +#~ msgstr "" +#~ "<set name=\"participants\" table=\"PERSON_EVENT\" inverse=\"true" +#~ "\">\n" +#~ " <key column=\"EVENT_ID\"/>\n" +#~ " <many-to-many column=\"PERSON_ID\" class=\"events.Person\"/>\n" +#~ "</set>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[ protected Set getEvents() {\n" +#~ " return events;\n" +#~ " }\n" +#~ "\n" +#~ " protected void setEvents(Set events) {\n" +#~ " this.events = events;\n" +#~ " }\n" +#~ "\n" +#~ " public void addToEvent(Event event) {\n" +#~ " this.getEvents().add(event);\n" +#~ " event.getParticipants().add(this);\n" +#~ " }\n" +#~ "\n" +#~ " public void removeFromEvent(Event event) {\n" +#~ " this.getEvents().remove(event);\n" +#~ " event.getParticipants().remove(this);\n" +#~ " }]]>" +#~ msgstr "" +#~ "protected Set getEvents() {\n" +#~ " return events;\n" +#~ "}\n" +#~ "\n" +#~ "protected void setEvents(Set events) {\n" +#~ " this.events = events;\n" +#~ "}\n" +#~ "\n" +#~ "public void addToEvent(Event event) {\n" +#~ " this.getEvents().add(event);\n" +#~ " event.getParticipants().add(this);\n" +#~ "}\n" +#~ "\n" +#~ "public void removeFromEvent(Event event) {\n" +#~ " this.getEvents().remove(event);\n" +#~ " event.getParticipants().remove(this);\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[package org.hibernate.tutorial.web;\n" +#~ "\n" +#~ "// Imports\n" +#~ "\n" +#~ "public class EventManagerServlet extends HttpServlet {\n" +#~ "\n" +#~ " protected void doGet(\n" +#~ " HttpServletRequest request,\n" +#~ " HttpServletResponse response) throws ServletException, " +#~ "IOException {\n" +#~ "\n" +#~ " SimpleDateFormat dateFormatter = new SimpleDateFormat( \"dd.MM." +#~ "yyyy\" );\n" +#~ "\n" +#~ " try {\n" +#~ " // Begin unit of work\n" +#~ " HibernateUtil.getSessionFactory().getCurrentSession()." +#~ "beginTransaction();\n" +#~ "\n" +#~ " // Process request and render page...\n" +#~ "\n" +#~ " // End unit of work\n" +#~ " HibernateUtil.getSessionFactory().getCurrentSession()." +#~ "getTransaction().commit();\n" +#~ " }\n" +#~ " catch (Exception ex) {\n" +#~ " HibernateUtil.getSessionFactory().getCurrentSession()." +#~ "getTransaction().rollback();\n" +#~ " if ( ServletException.class.isInstance( ex ) ) {\n" +#~ " throw ( ServletException ) ex;\n" +#~ " }\n" +#~ " else {\n" +#~ " throw new ServletException( ex );\n" +#~ " }\n" +#~ " }\n" +#~ " }\n" +#~ "\n" +#~ "}]]>" +#~ msgstr "" +#~ "protected void doGet(HttpServletRequest request,\n" +#~ " HttpServletResponse response)\n" +#~ " throws ServletException, IOException {\n" +#~ "\n" +#~ " SimpleDateFormat dateFormatter = new SimpleDateFormat(\"dd.MM.yyyy" +#~ "\");\n" +#~ "\n" +#~ " try {\n" +#~ " // Begin unit of work\n" +#~ " HibernateUtil.getSessionFactory()\n" +#~ " .getCurrentSession().beginTransaction();\n" +#~ "\n" +#~ " // Process request and render page...\n" +#~ "\n" +#~ " // End unit of work\n" +#~ " HibernateUtil.getSessionFactory()\n" +#~ " .getCurrentSession().getTransaction().commit();\n" +#~ "\n" +#~ " } catch (Exception ex) {\n" +#~ " HibernateUtil.getSessionFactory()\n" +#~ " .getCurrentSession().getTransaction().rollback();\n" +#~ " throw new ServletException(ex);\n" +#~ " }\n" +#~ "\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[ // Write HTML header\n" +#~ " PrintWriter out = response.getWriter();\n" +#~ " out.println(\"<html><head><title>Event Manager</title></" +#~ "head><body>\");\n" +#~ "\n" +#~ " // Handle actions\n" +#~ " if ( \"store\".equals(request.getParameter(\"action\")) ) {\n" +#~ "\n" +#~ " String eventTitle = request.getParameter(\"eventTitle\");\n" +#~ " String eventDate = request.getParameter(\"eventDate\");\n" +#~ "\n" +#~ " if ( \"\".equals(eventTitle) || \"\".equals(eventDate) ) {\n" +#~ " out.println(\"<b><i>Please enter event title and date.</" +#~ "i></b>\");\n" +#~ " }\n" +#~ " else {\n" +#~ " createAndStoreEvent(eventTitle, dateFormatter.parse" +#~ "(eventDate));\n" +#~ " out.println(\"<b><i>Added event.</i></b>\");\n" +#~ " }\n" +#~ " }\n" +#~ "\n" +#~ " // Print page\n" +#~ " printEventForm(out);\n" +#~ " listEvents(out, dateFormatter);\n" +#~ "\n" +#~ " // Write HTML footer\n" +#~ " out.println(\"</body></html>\");\n" +#~ " out.flush();\n" +#~ " out.close();]]>" +#~ msgstr "" +#~ "// Write HTML header\n" +#~ "PrintWriter out = response.getWriter();\n" +#~ "out.println(\"<html><head><title>Event Manager</" +#~ "title></head><body>\");\n" +#~ "\n" +#~ "// Handle actions\n" +#~ "if ( \"store\".equals(request.getParameter(\"action\")) ) {\n" +#~ "\n" +#~ " String eventTitle = request.getParameter(\"eventTitle\");\n" +#~ " String eventDate = request.getParameter(\"eventDate\");\n" +#~ "\n" +#~ " if ( \"\".equals(eventTitle) || \"\".equals(eventDate) ) {\n" +#~ " out.println(\"<b><i>Please enter event title and date." +#~ "</i></b>\");\n" +#~ " } else {\n" +#~ " createAndStoreEvent(eventTitle, dateFormatter.parse(eventDate));\n" +#~ " out.println(\"<b><i>Added event.</i></b>" +#~ "\");\n" +#~ " }\n" +#~ "}\n" +#~ "\n" +#~ "// Print page\n" +#~ "printEventForm(out);\n" +#~ "listEvents(out, dateFormatter);\n" +#~ "\n" +#~ "// Write HTML footer\n" +#~ "out.println(\"</body></html>\");\n" +#~ "out.flush();\n" +#~ "out.close();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[ private void printEventForm(PrintWriter out) {\n" +#~ " out.println(\"<h2>Add new event:</h2>\");\n" +#~ " out.println(\"<form>\");\n" +#~ " out.println(\"Title: <input name='eventTitle' length='50'/><br/>" +#~ "\");\n" +#~ " out.println(\"Date (e.g. 24.12.2009): <input name='eventDate' " +#~ "length='10'/><br/>\");\n" +#~ " out.println(\"<input type='submit' name='action' value='store'/>" +#~ "\");\n" +#~ " out.println(\"</form>\");\n" +#~ " }]]>" +#~ msgstr "" +#~ "private void printEventForm(PrintWriter out) {\n" +#~ " out.println(\"<h2>Add new event:</h2>\");\n" +#~ " out.println(\"<form>\");\n" +#~ " out.println(\"Title: <input name='eventTitle' length='50'/><" +#~ "br/>\");\n" +#~ " out.println(\"Date (e.g. 24.12.2009): <input name='eventDate' " +#~ "length='10'/><br/>\");\n" +#~ " out.println(\"<input type='submit' name='action' value='store'/>" +#~ "\");\n" +#~ " out.println(\"</form>\");\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[ private void listEvents(PrintWriter out, SimpleDateFormat " +#~ "dateFormatter) {\n" +#~ "\n" +#~ " List result = HibernateUtil.getSessionFactory()\n" +#~ " .getCurrentSession().createCriteria(Event.class).list();\n" +#~ " if (result.size() > 0) {\n" +#~ " out.println(\"<h2>Events in database:</h2>\");\n" +#~ " out.println(\"<table border='1'>\");\n" +#~ " out.println(\"<tr>\");\n" +#~ " out.println(\"<th>Event title</th>\");\n" +#~ " out.println(\"<th>Event date</th>\");\n" +#~ " out.println(\"</tr>\");\n" +#~ " Iterator it = result.iterator();\n" +#~ " while (it.hasNext()) {\n" +#~ " Event event = (Event) it.next();\n" +#~ " out.println(\"<tr>\");\n" +#~ " out.println(\"<td>\" + event.getTitle() + \"</td>\");\n" +#~ " out.println(\"<td>\" + dateFormatter.format(event.getDate" +#~ "()) + \"</td>\");\n" +#~ " out.println(\"</tr>\");\n" +#~ " }\n" +#~ " out.println(\"</table>\");\n" +#~ " }\n" +#~ " }]]>" +#~ msgstr "" +#~ "private void listEvents(PrintWriter out, SimpleDateFormat dateFormatter) " +#~ "{\n" +#~ "\n" +#~ " List result = HibernateUtil.getSessionFactory()\n" +#~ " .getCurrentSession().createCriteria(Event.class).list" +#~ "();\n" +#~ " if (result.size() > 0) {\n" +#~ " out.println(\"<h2>Events in database:</h2>\");\n" +#~ " out.println(\"<table border='1'>\");\n" +#~ " out.println(\"<tr>\");\n" +#~ " out.println(\"<th>Event title</th>\");\n" +#~ " out.println(\"<th>Event date</th>\");\n" +#~ " out.println(\"</tr>\");\n" +#~ " for (Iterator it = result.iterator(); it.hasNext();) {\n" +#~ " Event event = (Event) it.next();\n" +#~ " out.println(\"<tr>\");\n" +#~ " out.println(\"<td>\" + event.getTitle() + \"</td>" +#~ "\");\n" +#~ " out.println(\"<td>\" + dateFormatter.format(event." +#~ "getDate()) + \"</td>\");\n" +#~ " out.println(\"</tr>\");\n" +#~ " }\n" +#~ " out.println(\"</table>\");\n" +#~ " }\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[ protected void createAndStoreEvent(String title, Date " +#~ "theDate) {\n" +#~ " Event theEvent = new Event();\n" +#~ " theEvent.setTitle(title);\n" +#~ " theEvent.setDate(theDate);\n" +#~ "\n" +#~ " HibernateUtil.getSessionFactory()\n" +#~ " .getCurrentSession().save(theEvent);\n" +#~ " }]]>" +#~ msgstr "" +#~ "protected void createAndStoreEvent(String title, Date theDate) {\n" +#~ " Event theEvent = new Event();\n" +#~ " theEvent.setTitle(title);\n" +#~ " theEvent.setDate(theDate);\n" +#~ "\n" +#~ " HibernateUtil.getSessionFactory()\n" +#~ " .getCurrentSession().save(theEvent);\n" +#~ "}" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +#~ "<web-app version=\"2.4\"\n" +#~ " xmlns=\"http://java.sun.com/xml/ns/j2ee\"\n" +#~ " xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +#~ " xsi:schemaLocation=\"http://java.sun.com/xml/ns/j2ee http://java.sun." +#~ "com/xml/ns/j2ee/web-app_2_4.xsd\">\n" +#~ "\n" +#~ " <servlet>\n" +#~ " <servlet-name>Event Manager</servlet-name>\n" +#~ " <servlet-class>org.hibernate.tutorial.web.EventManagerServlet</" +#~ "servlet-class>\n" +#~ " </servlet>\n" +#~ "\n" +#~ " <servlet-mapping>\n" +#~ " <servlet-name>Event Manager</servlet-name>\n" +#~ " <url-pattern>/eventmanager</url-pattern>\n" +#~ " </servlet-mapping>\n" +#~ "</web-app>]]>" +#~ msgstr "" +#~ "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +#~ "<web-app version=\"2.4\"\n" +#~ " xmlns=\"http://java.sun.com/xml/ns/j2ee\"\n" +#~ " xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +#~ " xsi:schemaLocation=\"http://java.sun.com/xml/ns/j2ee\n" +#~ " http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd\">\n" +#~ "\n" +#~ " <servlet>\n" +#~ " <servlet-name>Event Manager</servlet-name>\n" +#~ " <servlet-class>events.EventManagerServlet</servlet-" +#~ "class>\n" +#~ " </servlet>\n" +#~ "\n" +#~ " <servlet-mapping>\n" +#~ " <servlet-name>Event Manager</servlet-name>\n" +#~ " <url-pattern>/eventmanager</url-pattern>\n" +#~ " </servlet-mapping>\n" +#~ "</web-app>" Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/xml.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/xml.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/content/xml.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,822 @@ +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# translation of Collection_Mapping.po to +# Language /mnt/hgfs/base/Hibernate/Reference translations for PACKAGE package. +# Copyright (C) 2006, 2007 Free Software Foundation, Inc. +# Automatically generated, 2006. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# , 2007. +# +msgid "" +msgstr "" +"Project-Id-Version: Collection_Mapping\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2009-12-03T00:15:27\n" +"PO-Revision-Date: 2007-02-26 10:27+1000\n" +"Last-Translator: \n" +"Language-Team: <de(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.9.1\n" + +#. Tag: title +#, no-c-format +msgid "XML Mapping" +msgstr "XML-Mapping" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<emphasis> XML Mapping is an experimental feature in Hibernate 3.0 and is " +"currently under active development. </emphasis>" +msgstr "" +"Bitte beachten Sie, dass es sich hierbei um ein experimentelles Feature in " +"Hibernate 3.0 handelt, an dem aktuell noch eine rege Entwicklungstätigkeit " +"stattfindet." + +#. Tag: title +#, no-c-format +msgid "Working with XML data" +msgstr "Das Arbeiten mit XML-Daten" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Hibernate allows you to work with persistent XML data in much the same way " +"you work with persistent POJOs. A parsed XML tree can be thought of as " +"another way of representing the relational data at the object level, instead " +"of POJOs." +msgstr "" +"Hibernate ermöglicht Ihnen die Arbeit mit persistenten XML-Daten auf " +"ähnliche Weise wie dies bei persistenten POJOs der Fall ist. Man kann sich " +"einen auf seine Syntax geprüften XML-Baum einfach als andere Weise der " +"Repräsentation relationaler Daten auf Objektebene anstelle von POJOs " +"vorstellen." + +#. Tag: para +#, no-c-format +msgid "" +"Hibernate supports dom4j as API for manipulating XML trees. You can write " +"queries that retrieve dom4j trees from the database and have any " +"modification you make to the tree automatically synchronized to the " +"database. You can even take an XML document, parse it using dom4j, and write " +"it to the database with any of Hibernate's basic operations: <literal>persist" +"(), saveOrUpdate(), merge(), delete(), replicate()</literal> (merging is not " +"yet supported)." +msgstr "" +"Hibernate unterstützt dom4j als API zur Verarbeitung von XML-Bäumen. Sie " +"können Anfragen, die dom4j-Bäume von der Datenbank abrufen, schreiben, wobei " +"alle Modifikationen am Baum automatisch mit der Datenbank synchronisiert " +"werden. Sie können sogar ein XML-Dokument unter Verwendung von dom4j auf die " +"Syntax prüfen und mittels Hibernates Grundvorgängen: <literal>persist(), " +"saveOrUpdate(), merge(), delete(), replicate()</literal> (\"Merging\" wird " +"noch nicht unterstützt) in die Datenbank schreiben." + +#. Tag: para +#, no-c-format +msgid "" +"This feature has many applications including data import/export, " +"externalization of entity data via JMS or SOAP and XSLT-based reporting." +msgstr "" +"Dieses Feature bietet zahlreiche Anwendungen einschließlich des Imports/" +"Exports von Daten, Externalisierung von Entity-Daten via JMS oder SOAP und " +"XSLT-basiertem Reporting." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A single mapping can be used to simultaneously map properties of a class and " +"nodes of an XML document to the database, or, if there is no class to map, " +"it can be used to map just the XML." +msgstr "" +"Ein einzelnes Mapping kann für das gleichzeitige Mappen von Properties einer " +"Klasse und Knoten (\"Nodes\") eines XML-Dokuments zu einer Datenbank " +"verwendet werden. Falls keine zu mappende Klasse existiert, kann auch nur " +"das XML gemappt werden." + +#. Tag: title +#, no-c-format +msgid "Specifying XML and class mapping together" +msgstr "Spezifizierung des gemeinsamen Mappens von XML und Klasse" + +#. Tag: para +#, no-c-format +msgid "Here is an example of mapping a POJO and XML simultaneously:" +msgstr "Hier ist ein Beispiel für das gleichzeitige Mappen eines POJO und XML:" + +#. Tag: title +#, no-c-format +msgid "Specifying only an XML mapping" +msgstr "Spezifizierung des Mappens von nur XML" + +#. Tag: para +#, no-c-format +msgid "Here is an example where there is no POJO class:" +msgstr "Dieses ist ein Beispiel ohne POJO-Klasse:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"This mapping allows you to access the data as a dom4j tree, or as a graph of " +"property name/value pairs or java <literal>Map</literal>s. The property " +"names are purely logical constructs that can be referred to in HQL queries." +msgstr "" +"Dieses Mapping erlaubt es Ihnen, auf Daten als dom4j-Baum oder als Graph von " +"Property-Name/Wertepaaren zuzugreifen (Java <literal>Map</literal>s). Die " +"Property-Namen sind rein logische Konstrukte, auf die in HQL-Anfragen " +"verwiesen werden kann." + +#. Tag: title +#, no-c-format +msgid "XML mapping metadata" +msgstr "XML-Mapping Metadaten" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"A range of Hibernate mapping elements accept the <literal>node</literal> " +"attribute. This lets you specify the name of an XML attribute or element " +"that holds the property or entity data. The format of the <literal>node</" +"literal> attribute must be one of the following:" +msgstr "" +"Zahlreiche Hibernate Mapping-Elemente akzeptieren das <literal>node</" +"literal>-Attribut. Mit diesem können Sie den Namen eines XML-Attributs oder " +"Elements festlegen, das die Property oder Entity-Daten enthält. Das Format " +"des <literal>node</literal>-Attributs muss wie folgt aussehen:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>\"element-name\"</literal>: map to the named XML element" +msgstr "<literal>\"element-name\"</literal> - mappt zum benannten XML-Element" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>\"@attribute-name\"</literal>: map to the named XML attribute" +msgstr "" +"<literal>\"@attribute-name\"</literal> - mappt zum benannten XML-Attribut" + +#. Tag: para +#, fuzzy, no-c-format +msgid "<literal>\".\"</literal>: map to the parent element" +msgstr "<literal>\".\"</literal> - mappt zum übergeordneten Element" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"<literal>\"element-name/@attribute-name\"</literal>: map to the named " +"attribute of the named element" +msgstr "" +"<literal>\"element-name/@attribute-name\"</literal> - mappt zum benannten " +"Attribut des benannten Elements" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"For collections and single valued associations, there is an additional " +"<literal>embed-xml</literal> attribute. If <literal>embed-xml=\"true\"</" +"literal>, the default, the XML tree for the associated entity (or collection " +"of value type) will be embedded directly in the XML tree for the entity that " +"owns the association. Otherwise, if <literal>embed-xml=\"false\"</literal>, " +"then only the referenced identifier value will appear in the XML for single " +"point associations and collections will not appear at all." +msgstr "" +"Für Datenerfassung und einwertige Assoziationen gibt es ein zusätzliches " +"<literal>embed-xml</literal>-Attribut. Falls <literal>embed-xml=\"true\"</" +"literal> der Standard, so wird der XML-Baum für die zugehörige Entity (oder " +"Collection vom Wertetyp) direkt im XML-Baum der Entity, zu der die " +"Assoziation gehört, eingebettet. Im anderen Fall, falls <literal>embed-xml=" +"\"false\"</literal>, erscheint nur der referenzierte Bezeichnerwert in der " +"XML für \"Single-Point\"-Assoziationen während Collections gar nicht " +"erscheinen." + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"Do not leave <literal>embed-xml=\"true\"</literal> for too many " +"associations, since XML does not deal well with circularity." +msgstr "" +"Sie sollten die Einstellung <literal>embed-xml=\"true\"</literal> nicht für " +"zu viele Assoziationen anwenden, da XML Schwierigkeiten mit Zirkularität " +"haben kann!" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"In this case, the collection of account ids is embedded, but not the actual " +"account data. The following HQL query:" +msgstr "" +"in diesem Fall haben wir die Collection von Konten-IDs einzubetten, nicht " +"jedoch die eigentlichen Kontodaten. Die folgende HQL-Anfrage:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "would return datasets such as this:" +msgstr "Würde Datensätze wie die Folgenden wiedergeben:" + +#. Tag: para +#, no-c-format +msgid "" +"If you set <literal>embed-xml=\"true\"</literal> on the <literal><one-to-" +"many></literal> mapping, the data might look more like this:" +msgstr "" +"Wenn Sie die Einstellung <literal>embed-xml=\"true\"</literal> im " +"<literal><one-to-many></literal>-Mapping vornehmen, so sehen die Daten " +"eher wie folgt aus:" + +#. Tag: title +#, no-c-format +msgid "Manipulating XML data" +msgstr "Manipulation von XML-Daten" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"You can also re-read and update XML documents in the application. You can do " +"this by obtaining a dom4j session:" +msgstr "" +"Wir wollen nun XML-Dokumente in der Anwendung nochmals lesen und " +"aktualisieren. Dies erfolgt durch Erhalt einer dom4j-Session:" + +#. Tag: para +#, fuzzy, no-c-format +msgid "" +"When implementing XML-based data import/export, it is useful to combine this " +"feature with Hibernate's <literal>replicate()</literal> operation." +msgstr "" +"Es ist sehr hilfreich, dieses Feature mit Hibernates <literal>replicate()</" +"literal>-Vorgang zu kombinieren, um XML-basierten Datenimport/-export zu " +"implementieren." + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Account\" \n" +#~ " table=\"ACCOUNTS\" \n" +#~ " node=\"account\">\n" +#~ " \n" +#~ " <id name=\"accountId\" \n" +#~ " column=\"ACCOUNT_ID\" \n" +#~ " node=\"@id\"/>\n" +#~ " \n" +#~ " <many-to-one name=\"customer\" \n" +#~ " column=\"CUSTOMER_ID\" \n" +#~ " node=\"customer/@id\" \n" +#~ " embed-xml=\"false\"/>\n" +#~ " \n" +#~ " <property name=\"balance\" \n" +#~ " column=\"BALANCE\" \n" +#~ " node=\"balance\"/>\n" +#~ " \n" +#~ " ...\n" +#~ " \n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Account\" \n" +#~ " table=\"ACCOUNTS\" \n" +#~ " node=\"account\">\n" +#~ " \n" +#~ " <id name=\"accountId\" \n" +#~ " column=\"ACCOUNT_ID\" \n" +#~ " node=\"@id\"/>\n" +#~ " \n" +#~ " <many-to-one name=\"customer\" \n" +#~ " column=\"CUSTOMER_ID\" \n" +#~ " node=\"customer/@id\" \n" +#~ " embed-xml=\"false\"/>\n" +#~ " \n" +#~ " <property name=\"balance\" \n" +#~ " column=\"BALANCE\" \n" +#~ " node=\"balance\"/>\n" +#~ " \n" +#~ " ...\n" +#~ " \n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class entity-name=\"Account\" \n" +#~ " table=\"ACCOUNTS\" \n" +#~ " node=\"account\">\n" +#~ " \n" +#~ " <id name=\"id\" \n" +#~ " column=\"ACCOUNT_ID\" \n" +#~ " node=\"@id\" \n" +#~ " type=\"string\"/>\n" +#~ " \n" +#~ " <many-to-one name=\"customerId\" \n" +#~ " column=\"CUSTOMER_ID\" \n" +#~ " node=\"customer/@id\" \n" +#~ " embed-xml=\"false\" \n" +#~ " entity-name=\"Customer\"/>\n" +#~ " \n" +#~ " <property name=\"balance\" \n" +#~ " column=\"BALANCE\" \n" +#~ " node=\"balance\" \n" +#~ " type=\"big_decimal\"/>\n" +#~ " \n" +#~ " ...\n" +#~ " \n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class entity-name=\"Account\" \n" +#~ " table=\"ACCOUNTS\" \n" +#~ " node=\"account\">\n" +#~ " \n" +#~ " <id name=\"id\" \n" +#~ " column=\"ACCOUNT_ID\" \n" +#~ " node=\"@id\" \n" +#~ " type=\"string\"/>\n" +#~ " \n" +#~ " <many-to-one name=\"customerId\" \n" +#~ " column=\"CUSTOMER_ID\" \n" +#~ " node=\"customer/@id\" \n" +#~ " embed-xml=\"false\" \n" +#~ " entity-name=\"Customer\"/>\n" +#~ " \n" +#~ " <property name=\"balance\" \n" +#~ " column=\"BALANCE\" \n" +#~ " node=\"balance\" \n" +#~ " type=\"big_decimal\"/>\n" +#~ " \n" +#~ " ...\n" +#~ " \n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<class name=\"Customer\" \n" +#~ " table=\"CUSTOMER\" \n" +#~ " node=\"customer\">\n" +#~ " \n" +#~ " <id name=\"id\" \n" +#~ " column=\"CUST_ID\" \n" +#~ " node=\"@id\"/>\n" +#~ " \n" +#~ " <map name=\"accounts\" \n" +#~ " node=\".\" \n" +#~ " embed-xml=\"true\">\n" +#~ " <key column=\"CUSTOMER_ID\" \n" +#~ " not-null=\"true\"/>\n" +#~ " <map-key column=\"SHORT_DESC\" \n" +#~ " node=\"@short-desc\" \n" +#~ " type=\"string\"/>\n" +#~ " <one-to-many entity-name=\"Account\"\n" +#~ " embed-xml=\"false\" \n" +#~ " node=\"account\"/>\n" +#~ " </map>\n" +#~ " \n" +#~ " <component name=\"name\" \n" +#~ " node=\"name\">\n" +#~ " <property name=\"firstName\" \n" +#~ " node=\"first-name\"/>\n" +#~ " <property name=\"initial\" \n" +#~ " node=\"initial\"/>\n" +#~ " <property name=\"lastName\" \n" +#~ " node=\"last-name\"/>\n" +#~ " </component>\n" +#~ " \n" +#~ " ...\n" +#~ " \n" +#~ "</class>]]>" +#~ msgstr "" +#~ "<class name=\"Customer\" \n" +#~ " table=\"CUSTOMER\" \n" +#~ " node=\"customer\">\n" +#~ " \n" +#~ " <id name=\"id\" \n" +#~ " column=\"CUST_ID\" \n" +#~ " node=\"@id\"/>\n" +#~ " \n" +#~ " <map name=\"accounts\" \n" +#~ " node=\".\" \n" +#~ " embed-xml=\"true\">\n" +#~ " <key column=\"CUSTOMER_ID\" \n" +#~ " not-null=\"true\"/>\n" +#~ " <map-key column=\"SHORT_DESC\" \n" +#~ " node=\"@short-desc\" \n" +#~ " type=\"string\"/>\n" +#~ " <one-to-many entity-name=\"Account\"\n" +#~ " embed-xml=\"false\" \n" +#~ " node=\"account\"/>\n" +#~ " </map>\n" +#~ " \n" +#~ " <component name=\"name\" \n" +#~ " node=\"name\">\n" +#~ " <property name=\"firstName\" \n" +#~ " node=\"first-name\"/>\n" +#~ " <property name=\"initial\" \n" +#~ " node=\"initial\"/>\n" +#~ " <property name=\"lastName\" \n" +#~ " node=\"last-name\"/>\n" +#~ " </component>\n" +#~ " \n" +#~ " ...\n" +#~ " \n" +#~ "</class>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[from Customer c left join fetch c.accounts where c.lastName " +#~ "like :lastName]]>" +#~ msgstr "" +#~ "from Customer c left join fetch c.accounts where c.lastName like :lastName" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<customer id=\"123456789\">\n" +#~ " <account short-desc=\"Savings\">987632567</account>\n" +#~ " <account short-desc=\"Credit Card\">985612323</account>\n" +#~ " <name>\n" +#~ " <first-name>Gavin</first-name>\n" +#~ " <initial>A</initial>\n" +#~ " <last-name>King</last-name>\n" +#~ " </name>\n" +#~ " ...\n" +#~ "</customer>]]>" +#~ msgstr "" +#~ "<customer id=\"123456789\">\n" +#~ " <account short-desc=\"Savings\">987632567</account>\n" +#~ " <account short-desc=\"Credit Card\">985612323</account>\n" +#~ " <name>\n" +#~ " <first-name>Gavin</first-name>\n" +#~ " <initial>A</initial>\n" +#~ " <last-name>King</last-name>\n" +#~ " </name>\n" +#~ " ...\n" +#~ "</customer>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[<customer id=\"123456789\">\n" +#~ " <account id=\"987632567\" short-desc=\"Savings\">\n" +#~ " <customer id=\"123456789\"/>\n" +#~ " <balance>100.29</balance>\n" +#~ " </account>\n" +#~ " <account id=\"985612323\" short-desc=\"Credit Card\">\n" +#~ " <customer id=\"123456789\"/>\n" +#~ " <balance>-2370.34</balance>\n" +#~ " </account>\n" +#~ " <name>\n" +#~ " <first-name>Gavin</first-name>\n" +#~ " <initial>A</initial>\n" +#~ " <last-name>King</last-name>\n" +#~ " </name>\n" +#~ " ...\n" +#~ "</customer>]]>" +#~ msgstr "" +#~ "<customer id=\"123456789\">\n" +#~ " <account id=\"987632567\" short-desc=\"Savings\">\n" +#~ " <customer id=\"123456789\"/>\n" +#~ " <balance>100.29</balance>\n" +#~ " </account>\n" +#~ " <account id=\"985612323\" short-desc=\"Credit Card\">\n" +#~ " <customer id=\"123456789\"/>\n" +#~ " <balance>-2370.34</balance>\n" +#~ " </account>\n" +#~ " <name>\n" +#~ " <first-name>Gavin</first-name>\n" +#~ " <initial>A</initial>\n" +#~ " <last-name>King</last-name>\n" +#~ " </name>\n" +#~ " ...\n" +#~ "</customer>" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Document doc = ....;\n" +#~ " \n" +#~ "Session session = factory.openSession();\n" +#~ "Session dom4jSession = session.getSession(EntityMode.DOM4J);\n" +#~ "Transaction tx = session.beginTransaction();\n" +#~ "\n" +#~ "List results = dom4jSession\n" +#~ " .createQuery(\"from Customer c left join fetch c.accounts where c." +#~ "lastName like :lastName\")\n" +#~ " .list();\n" +#~ "for ( int i=0; i<results.size(); i++ ) {\n" +#~ " //add the customer data to the XML document\n" +#~ " Element customer = (Element) results.get(i);\n" +#~ " doc.add(customer);\n" +#~ "}\n" +#~ "\n" +#~ "tx.commit();\n" +#~ "session.close();]]>" +#~ msgstr "" +#~ "Document doc = ....;\n" +#~ " \n" +#~ "Session session = factory.openSession();\n" +#~ "Session dom4jSession = session.getSession(EntityMode.DOM4J);\n" +#~ "Transaction tx = session.beginTransaction();\n" +#~ "\n" +#~ "List results = dom4jSession\n" +#~ " .createQuery(\"from Customer c left join fetch c.accounts where c." +#~ "lastName like :lastName\")\n" +#~ " .list();\n" +#~ "for ( int i=0; i<results.size(); i++ ) {\n" +#~ " //add the customer data to the XML document\n" +#~ " Element customer = (Element) results.get(i);\n" +#~ " doc.add(customer);\n" +#~ "}\n" +#~ "\n" +#~ "tx.commit();\n" +#~ "session.close();" + +#, fuzzy +#~ msgid "" +#~ "<![CDATA[Session session = factory.openSession();\n" +#~ "Session dom4jSession = session.getSession(EntityMode.DOM4J);\n" +#~ "Transaction tx = session.beginTransaction();\n" +#~ "\n" +#~ "Element cust = (Element) dom4jSession.get(\"Customer\", customerId);\n" +#~ "for ( int i=0; i<results.size(); i++ ) {\n" +#~ " Element customer = (Element) results.get(i);\n" +#~ " //change the customer name in the XML and database\n" +#~ " Element name = customer.element(\"name\");\n" +#~ " name.element(\"first-name\").setText(firstName);\n" +#~ " name.element(\"initial\").setText(initial);\n" +#~ " name.element(\"last-name\").setText(lastName);\n" +#~ "}\n" +#~ "\n" +#~ "tx.commit();\n" +#~ "session.close();]]>" +#~ msgstr "" +#~ "Session session = factory.openSession();\n" +#~ "Session dom4jSession = session.getSession(EntityMode.DOM4J);\n" +#~ "Transaction tx = session.beginTransaction();\n" +#~ "\n" +#~ "Element cust = (Element) dom4jSession.get(\"Customer\", customerId);\n" +#~ "for ( int i=0; i<results.size(); i++ ) {\n" +#~ " Element customer = (Element) results.get(i);\n" +#~ " //change the customer name in the XML and database\n" +#~ " Element name = customer.element(\"name\");\n" +#~ " name.element(\"first-name\").setText(firstName);\n" +#~ " name.element(\"initial\").setText(initial);\n" +#~ " name.element(\"last-name\").setText(lastName);\n" +#~ "}\n" +#~ "\n" +#~ "tx.commit();\n" +#~ "session.close();" Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/fallback_content/Conventions.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/fallback_content/Conventions.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/fallback_content/Conventions.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,301 @@ +# translation of Conventions.po to +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. +# +msgid "" +msgstr "" +"Project-Id-Version: Conventions\n" +"POT-Creation-Date: 2009-12-11T05:07:40\n" +"PO-Revision-Date: 2010-01-13 22:31+1100\n" +"Last-Translator: \n" +"Language-Team: <en(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.11.4\n" + +#. Tag: title +#, no-c-format +msgid "Document Conventions" +msgstr "Dokumentkonventionen" + +#. Tag: para +#, no-c-format +msgid "This manual uses several conventions to highlight certain words and phrases and draw attention to specific pieces of information." +msgstr "" +"Dieses Handbuch verwendet mehrere Konventionen, um bestimmte Wörter und Ausdrücke " +"zu betonen und bestimmte Teile von Informationen hervorzuheben." + +#. Tag: para +#, no-c-format +msgid "In PDF and paper editions, this manual uses typefaces drawn from the <ulink url=\"https://fedorahosted.org/liberation-fonts/\">Liberation Fonts</ulink> set. The Liberation Fonts set is also used in HTML editions if the set is installed on your system. If not, alternative but equivalent typefaces are displayed. Note: Red Hat Enterprise Linux 5 and later includes the Liberation Fonts set by default." +msgstr "" +"In PDF- und Papierausgaben verwendet dieses Handbuch Schriftarten aus dem <ulink url=\"https://fedorahosted.org/liberation-fonts/\">Liberation Fonts</ulink>-Satz. " +"Der \"Liberation Fonts\"-Satz wird auch in HTML-Editionen verwendet, wenn er auf Ihrem " +"System installiert ist. Falls nicht, so werden alternative aber gleichwertige Schriftarten " +"angezeigt. Hinweis: Red Hat Enterprise Linux 5 und spätere Versionen enthalten den " +"\"Liberation Fonts\"-Satz an Schrifttypen standardmäßig." + +#. Tag: title +#, no-c-format +msgid "Typographic Conventions" +msgstr "Typografische Konventionen" + +#. Tag: para +#, no-c-format +msgid "Four typographic conventions are used to call attention to specific words and phrases. These conventions, and the circumstances they apply to, are as follows." +msgstr "" +"Vier typografische Konventionen werden verwendet, um bestimmte Wörter und " +"Ausdrücke hervorzuheben. Diese Konventionen und die Umstände, in denen sie " +"angewendet werden, sind wie folgt." + +#. Tag: para +#, no-c-format +msgid "<literal>Mono-spaced Bold</literal>" +msgstr "<literal>Mono-spaced Bold</literal>" + +#. Tag: para +#, no-c-format +msgid "Used to highlight system input, including shell commands, file names and paths. Also used to highlight keycaps and key combinations. For example:" +msgstr "" +"Zur Betonung der Systemeingabe einschließlich Shell-Befehle, Dateinamen " +"und Pfaden verwendet. Auch zur Betonung von Tastenkappen und Tastenkombinationen " +"verwendet. Zum Beispiel:" + +#. Tag: para +#, no-c-format +msgid "To see the contents of the file <filename>my_next_bestselling_novel</filename> in your current working directory, enter the <command>cat my_next_bestselling_novel</command> command at the shell prompt and press <keycap>Enter</keycap> to execute the command." +msgstr "" +"Um die Inhalte der Datei <filename>my_next_bestselling_novel</filename> in Ihrem " +"aktuellen Arbeitsverzeichnis zu sehen, geben Sie den " +"<command>cat my_next_bestselling_novel</command>-Befehl im Shell-Prompt ein, " +"und drücken Sie <keycap>Enter</keycap>, um den Befehl auszuführen." + +#. Tag: para +#, no-c-format +msgid "The above includes a file name, a shell command and a keycap, all presented in mono-spaced bold and all distinguishable thanks to context." +msgstr "" +"Obiges enthält einen Dateinamen, einen Shell-Befehl und eine Tastenkappe, alle " +"in einzeiligem Fettdruck und aufgrund des Kontexts leicht zu unterscheiden." + +#. Tag: para +#, no-c-format +msgid "Key combinations can be distinguished from keycaps by the hyphen connecting each part of a key combination. For example:" +msgstr "" +"Tastenkombinationen können von Tastenkappen durch den jeden Teil der Tastenkombination " +"mit anderen Teilen verbindenden Bindestrich unterschieden werden. Zum Beispiel:" + +#. Tag: para +#, no-c-format +msgid "Press <keycap>Enter</keycap> to execute the command." +msgstr "Drücken Sie <keycap>Enter</keycap>, um den Befehl auszuführen." + +#. Tag: para +#, no-c-format +msgid "Press <keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>F1</keycap></keycombo> to switch to the first virtual terminal. Press <keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>F7</keycap></keycombo> to return to your X-Windows session." +msgstr "" +"Drücken Sie <keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>F1</keycap></keycombo>, " +"um ins erste virtuelle Terminal zu wechseln. Drücken Sie <keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>F7</keycap></keycombo>, " +"um zu Ihrer X-Windows Session zurückzukehren." + +#. Tag: para +#, no-c-format +msgid "The first paragraph highlights the particular keycap to press. The second highlights two key combinations (each a set of three keycaps with each set pressed simultaneously)." +msgstr "" +"Der erste Abschnitt markiert die zu drückende Tastenkappe. Der zweite markiert zwei " +"Tastenkombinationen (jede ein Satz von drei Tastenkappen, wobei jeder Satz simultan " +"gedrückt wird)." + +#. Tag: para +#, no-c-format +msgid "If source code is discussed, class names, methods, functions, variable names and returned values mentioned within a paragraph will be presented as above, in <literal>mono-spaced bold</literal>. For example:" +msgstr "" +"Wird Quellcode erläutert, so erscheinen Klassenname, Methoden, Funktionen, " +"Variablennamen und wiedergegebene Werte, die in einem Abschnitt wie oben " +"erwähnt werden in <literal>mono-spaced bold</literal> (einzeiligem Fettdruck). " +"Zum Beispiel:" + +#. Tag: para +#, no-c-format +msgid "File-related classes include <classname>filesystem</classname> for file systems, <classname>file</classname> for files, and <classname>dir</classname> for directories. Each class has its own associated set of permissions." +msgstr "" +"Datei-bezogene Klassen beinhalten <classname>filesystem</classname> für Dateisysteme, <classname>file</classname> für Dateien und <classname>dir</classname> " +"für Verzeichnisse. Jede Klasse besitzt ihren eigenen assoziierten Satz an Genehmigungen. " + +#. Tag: para +#, no-c-format +msgid "<application>Proportional Bold</application>" +msgstr "<application>Proportional Bold</application>" + +#. Tag: para +#, no-c-format +msgid "This denotes words or phrases encountered on a system, including application names; dialog box text; labeled buttons; check-box and radio button labels; menu titles and sub-menu titles. For example:" +msgstr "" +"Dies kennzeichnet Wörter oder Ausdrücke, auf die man in einem System trifft, darunter " +"Namen von Anwendungen; Dialog-Box Text; benannte Optionsschaltflächen; " +"Menütitel und Untermenü-Titel. Zum Beispiel:" + +#. Tag: para +#, no-c-format +msgid "Choose <menuchoice><guimenu>System</guimenu><guisubmenu>Preferences</guisubmenu><guimenuitem>Mouse</guimenuitem></menuchoice> from the main menu bar to launch <application>Mouse Preferences</application>. In the <guilabel>Buttons</guilabel> tab, click the <guilabel>Left-handed mouse</guilabel> check box and click <guibutton>Close</guibutton> to switch the primary mouse button from the left to the right (making the mouse suitable for use in the left hand)." +msgstr "Wählen Sie <menuchoice><guimenu>System</guimenu><guisubmenu>Preferences</guisubmenu><guimenuitem>Mouse</guimenuitem></menuchoice> aus dem Hauptmenü-Balken, um <application>Mouse Preferences</application> zu starten. Im <guilabel>Buttons</guilabel>-Reiter, klicken Sie das <guilabel>Left-handed mouse</guilabel>-Kontrollkästchen, und klicken Sie <guibutton>Close</guibutton>, um die Schaltfläche der Primärmaus von links nach rechts umzustellen (wodurch die Maus für Linkshänder nutzbar wird)." + +#. Tag: para +#, no-c-format +msgid "To insert a special character into a <application>gedit</application> file, choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Accessories</guisubmenu><guimenuitem>Character Map</guimenuitem></menuchoice> from the main menu bar. Next, choose <menuchoice><guimenu>Search</guimenu><guimenuitem>Find…</guimenuitem></menuchoice> from the <application>Character Map</application> menu bar, type the name of the character in the <guilabel>Search</guilabel> field and click <guibutton>Next</guibutton>. The character you sought will be highlighted in the <guilabel>Character Table</guilabel>. Double-click this highlighted character to place it in the <guilabel>Text to copy</guilabel> field and then click the <guibutton>Copy</guibutton> button. Now switch back to your document and choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Paste</guimenuitem></menuchoice> from the <application>gedit</application> menu bar." +msgstr "" +"Um ein Sonderzeichen in eine <application>gedit</application>-Datei einzufügen, " +"wählen Sie <menuchoice><guimenu>Applications</guimenu><guisubmenu>Accessories</guisubmenu><guimenuitem>Character Map</guimenuitem></menuchoice> aus dem Hauptmenübalken. Anschließend wählen Sie <menuchoice><guimenu>Search</guimenu><guimenuitem>Find…</guimenuitem></menuchoice> aus dem <application>Character Map</application>-Menübalken, geben SIe den Namen des Sonderzeichens im <guilabel>Search</guilabel>-Feld ein und klicken Sie auf <guibutton>Next</guibutton>. Das von Ihnen gesuchte Zeichen wird in der <guilabel>Character Table</guilabel> hervorgehoben. " +"Doppelklicken Sie auf dieses hervorgehobene Zeichen, um es im <guilabel>Text to copy</guilabel>-Feld zu platzieren und klicken Sie auf die <guibutton>Copy</guibutton>-Schaltfläche. Wechseln Sie zurück in Ihr Dokument, und wählen Sie <menuchoice><guimenu>Edit</guimenu><guimenuitem>Paste</guimenuitem></menuchoice> aus dem <application>gedit</application>-Menübalken." + +#. Tag: para +#, no-c-format +msgid "The above text includes application names; system-wide menu names and items; application-specific menu names; and buttons and text found within a GUI interface, all presented in proportional bold and all distinguishable by context." +msgstr "" +"Der obige Text enthält Anwendungsnamen; System-weite Menünamen und Posten; " +"Anwendungsspezifische Menünamen sowie innerhalb eines GUI-Interface vorkommende " +"Schaltflächen und Text, allesamt in proportinalem Fettdruck und leicht vom " +"Kontext zu unterscheiden." + +#. Tag: para +#, no-c-format +msgid "<command><replaceable>Mono-spaced Bold Italic</replaceable></command> or <application><replaceable>Proportional Bold Italic</replaceable></application>" +msgstr "" +"<command><replaceable>Mono-spaced Bold Italic</replaceable></command> " +"oder <application><replaceable>Proportional Bold Italic</replaceable></application>" + +#. Tag: para +#, no-c-format +msgid "Whether mono-spaced bold or proportional bold, the addition of italics indicates replaceable or variable text. Italics denotes text you do not input literally or displayed text that changes depending on circumstance. For example:" +msgstr "" +"Ob \"mono-spaced bold\" oder \"proportional bold\", Kursivschrift steht für ersetzbaren " +"oder variablen Text. Kursivschrift denotiert Text, den Sie nicht wörtlich eingeben oder " +"angezeigten Text, der sich je nach Umständen ändert. Zum Beispiel:" + +#. Tag: para +#, no-c-format +msgid "To connect to a remote machine using ssh, type <command>ssh <replaceable>username</replaceable>@<replaceable>domain.name</replaceable></command> at a shell prompt. If the remote machine is <filename>example.com</filename> and your username on that machine is john, type <command>ssh john(a)example.com</command>." +msgstr "" +"Um eine Verbindung mit einer Remote-Maschine mittels ssh herzustellen, " +"geben Sie <command>ssh <replaceable>username</replaceable>@<replaceable>domain.name</replaceable></command> " +"in einem Shell-Prompt ein. Ist die Remote-Maschine <filename>example.com</filename> " +"und Ihr Benutzername an dieser Maschine ist \"john\", so geben Sie " +"<command>ssh john(a)example.com</command> ein." + +#. Tag: para +#, no-c-format +msgid "The <command>mount -o remount <replaceable>file-system</replaceable></command> command remounts the named file system. For example, to remount the <filename>/home</filename> file system, the command is <command>mount -o remount /home</command>." +msgstr "" +"Der <command>mount -o remount <replaceable>file-system</replaceable></command>-Befehl " +"hängt das benannte Dateisystem wieder ein. Um zum Beispiel das " +"<filename>/home</filename>-Dateisystem wieder einzuhängen, lautet der Befehl " +"<command>mount -o remount /home</command>." + +#. Tag: para +#, no-c-format +msgid "To see the version of a currently installed package, use the <command>rpm -q <replaceable>package</replaceable></command> command. It will return a result as follows: <command><replaceable>package-version-release</replaceable></command>." +msgstr "" +"Um die Version eines aktuell installierten Pakets einzusehen, verwenden Sie den " +"<command>rpm -q <replaceable>package</replaceable></command>-Befehl. " +"Er gibt das Ergebnis wie folgt wieder: <command><replaceable>package-version-release</replaceable></command>." + +#. Tag: para +#, no-c-format +msgid "Note the words in bold italics above — username, domain.name, file-system, package, version and release. Each word is a placeholder, either for text you enter when issuing a command or for text displayed by the system." +msgstr "" +"Beachten Sie die Wörter in kursivem Fettdruck oben — username, domain.name, file-system, package, version und release. Bei jedem Wort handelt es sich um einen Platzhalter für entweder " +"durch Sie bei Eingabe eines Befehls geschriebenen Text oder für vom System angezeigten " +"Text." + +#. Tag: para +#, no-c-format +msgid "Aside from standard usage for presenting the title of a work, italics denotes the first use of a new and important term. For example:" +msgstr "" +"Außer dem Standardgebrauch zur Darestellung des Titels einer Arbeit, wird " +"Kursivschrift bei der erstmaligen Erwähnung eines neuen und wichtigen Begriffs " +"verwendet. Zum Beispiel: " + +#. Tag: para +#, no-c-format +msgid "Publican is a <firstterm>DocBook</firstterm> publishing system." +msgstr "Publican ist <firstterm>DocBook</firstterm> Publishing-System." + +#. Tag: title +#, no-c-format +msgid "Pull-quote Conventions" +msgstr "Pull-Quote Konventionen" + +#. Tag: para +#, no-c-format +msgid "Terminal output and source code listings are set off visually from the surrounding text." +msgstr "" +"Terminal-Ausgabe und Quellcode-Auflistungen sind visuell vom umgebenden Text " +"abgesetzt." + +#. Tag: para +#, no-c-format +msgid "Output sent to a terminal is set in <computeroutput>mono-spaced roman</computeroutput> and presented thus:" +msgstr "" +"An ein Terminal gesendete Ausgaben sind <computeroutput>mono-spaced roman</computeroutput> " +"und werden wie folgt dargestellt:" + +#. Tag: para +#, no-c-format +msgid "Source-code listings are also set in <computeroutput>mono-spaced roman</computeroutput> but add syntax highlighting as follows:" +msgstr "" +"Quellcode-Auflistungen sind auch <computeroutput>mono-spaced roman</computeroutput> " +"fügen aber Syntax-Hervorhebungen hinzu wie folgt:" + +#. Tag: title +#, no-c-format +msgid "Notes and Warnings" +msgstr "Hinweise und Warnungen" + +#. Tag: para +#, no-c-format +msgid "Finally, we use three visual styles to draw attention to information that might otherwise be overlooked." +msgstr "" +"Es werden drei visuelle Stile zur Hervorhebung von andernfalls möglicherweise " +"übersehener Informationen verwendet. " + +#. Tag: title +#, no-c-format +msgid "Note" +msgstr "Hinweis" + +#. Tag: para +#, no-c-format +msgid "Notes are tips, shortcuts or alternative approaches to the task at hand. Ignoring a note should have no negative consequences, but you might miss out on a trick that makes your life easier." +msgstr "" +"Anmerkungen sind Tipps, Tastaturbefehle oder alternative Herangehensweisen an die aktuelle " +"Aufgabe. Das Ignorieren einer Anmerkung hat in der Regel keine negativen Auswirkungen, aber " +"Sie verpassen vielleicht einen nützlichen Hinweis, der Ihnen das Leben leichter machen kann." + +#. Tag: title +#, no-c-format +msgid "Important" +msgstr "Wichtig" + +#. Tag: para +#, no-c-format +msgid "Important boxes detail things that are easily missed: configuration changes that only apply to the current session, or services that need restarting before an update will apply. Ignoring a box labeled 'Important' won't cause data loss but may cause irritation and frustration." +msgstr "" +"Wichtige Kästchen heben Informationen hervor, die andernfalls möglicherweise " +"übersehen werden: Konfigurationsänderungen, die nur die aktuelle Session betreffen " +"oder Dienste, die erneut gestartet werden müssen, ehe eine Aktualisierung stattfindet. " +"Das Nichtbeachten eines als 'Important' ('Wichtig') gekennzeichneten Kästchens " +"führt zwar nicht zu Datenverlust, kann aber zu unerwünschten " +"Ergebnissen führen." + +#. Tag: title +#, no-c-format +msgid "Warning" +msgstr "Warnung" + +#. Tag: para +#, no-c-format +msgid "Warnings should not be ignored. Ignoring warnings will most likely cause data loss." +msgstr "" +"Warnungen sollten nicht ignoriert werden. Das Ignorieren von Nachrichten führt mit " +"großer Wahrscheinlichkeit zu Datenverlust." + Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/fallback_content/Feedback.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/fallback_content/Feedback.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/fallback_content/Feedback.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,38 @@ +# translation of Feedback.po to +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. +# +msgid "" +msgstr "" +"Project-Id-Version: Feedback\n" +"POT-Creation-Date: 2009-12-11T05:07:40\n" +"PO-Revision-Date: 2010-01-11 17:47+1100\n" +"Last-Translator: \n" +"Language-Team: <en(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.11.4\n" + +#. Tag: title +#, no-c-format +msgid "We Need Feedback!" +msgstr "Wir brauchen Feedback!" + +#. Tag: primary +#, no-c-format +msgid "feedback" +msgstr "Feedback" + +#. Tag: secondary +#, no-c-format +msgid "contact information for this manual" +msgstr "Kontaktinformationen für dieses Handbuch" + +#. Tag: para +#, no-c-format +msgid "You should over ride this by creating your own local Feedback.xml file." +msgstr "" +"Sie sollte dies außer Kraft setzen, indem Sie Ihre eigene lokale " +"Feedback.xml-Datei erstellen." + Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/fallback_content/Legal_Notice.po =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/fallback_content/Legal_Notice.po (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/de-DE/fallback_content/Legal_Notice.po 2010-02-08 05:11:36 UTC (rev 18719) @@ -0,0 +1,26 @@ +# translation of Legal_Notice.po to +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. +# +msgid "" +msgstr "" +"Project-Id-Version: Legal_Notice\n" +"POT-Creation-Date: 2009-12-11T05:07:40\n" +"PO-Revision-Date: 2010-01-11 18:12+1100\n" +"Last-Translator: \n" +"Language-Team: <en(a)li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: KBabel 1.11.4\n" + +#. Tag: para +#, no-c-format +msgid "Copyright <trademark class=\"copyright\"></trademark> &YEAR; &HOLDER; This material may only be distributed subject to the terms and conditions set forth in the GNU Free Documentation License (GFDL), V1.2 or later (the latest version is presently available at <ulink url=\"http://www.gnu.org/licenses/fdl.txt\">http://www.gnu.org/licenses/fdl.txt</ulink>)." +msgstr "" +"Copyright <trademark class=\"copyright\"></trademark> &YEAR; &HOLDER; " +"Dieses Material kann nur gemäß den in den Allgemeinen Geschäftsbedingungen der " +"GNU Free Documentation License (GFDL), V1.2 oder später distribuiert werden " +"(die aktuellste Version ist derzeit unter <ulink url=\"http://www.gnu.org/licenses/fdl.txt\">http://www.gnu.org/licenses/fdl.txt</ulink>) " +"verfügbar." +

15 years, 8 months

1
0
0 / 0

Hibernate SVN: r18718 - in core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot: content and 1 other directories.

by hibernate-commits＠lists.jboss.org

Author: stliu Date: 2010-02-08 00:08:18 -0500 (Mon, 08 Feb 2010) New Revision: 18718 Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/Preface.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/fallback_content/ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/fallback_content/Conventions.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/fallback_content/Feedback.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/fallback_content/Legal_Notice.pot Log: HHH-4729 Import work done by Red Hat translation team Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/Preface.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/Preface.pot (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/Preface.pot 2010-02-08 05:08:18 UTC (rev 18718) @@ -0,0 +1,94 @@ +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. +# +msgid "" +msgstr "" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:17\n" +"PO-Revision-Date: 2010-01-08T04:07:17\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" +"MIME-Version: 1.0\n" +"Content-Type: application/x-publican; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#, no-c-format +msgid "Preface" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "Working with object-oriented software and a relational database can be cumbersome and time consuming in today's enterprise environments. Hibernate is an object/relational mapping tool for Java environments. The term object/relational mapping (ORM) refers to the technique of mapping a data representation from an object model to a relational data model with a SQL-based schema." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "Hibernate not only takes care of the mapping from Java classes to database tables (and from Java data types to SQL data types), but also provides data query and retrieval facilities. It can also significantly reduce development time otherwise spent with manual data handling in SQL and JDBC." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "Hibernate's goal is to relieve the developer from 95 percent of common data persistence related programming tasks. Hibernate may not be the best solution for data-centric applications that only use stored-procedures to implement the business logic in the database, it is most useful with object-oriented domain models and business logic in the Java-based middle-tier. However, Hibernate can certainly help you to remove or encapsulate vendor-specific SQL code and will help with the common task of result set translation from a tabular representation to a graph of objects." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "If you are new to Hibernate and Object/Relational Mapping or even Java, please follow these steps:" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "Read <xref linkend=\"tutorial\" /> for a tutorial with step-by-step instructions. The source code for the tutorial is included in the distribution in the <literal>doc/reference/tutorial/</literal> directory." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "Read <xref linkend=\"architecture\" /> to understand the environments where Hibernate can be used." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "View the <literal>eg/</literal> directory in the Hibernate distribution. It contains a simple standalone application. Copy your JDBC driver to the <literal>lib/</literal> directory and edit <literal>etc/hibernate.properties</literal>, specifying correct values for your database. From a command prompt in the distribution directory, type <literal>ant eg</literal> (using Ant), or under Windows, type <literal>build eg</literal>." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "Use this reference documentation as your primary source of information. Consider reading <emphasis>Java Persistence with Hibernate</emphasis> (http://www.manning.com/bauer2) if you need more help with application design, or if you prefer a step-by-step tutorial. Also visit http://caveatemptor.hibernate.org and download the example application for Java Persistence with Hibernate." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "FAQs are answered on the Hibernate website." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "Third party demos, examples, and tutorials are linked on the Hibernate website." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "The Community Area on the Hibernate website is a good resource for design patterns and various integration solutions (Tomcat, JBoss AS, Struts, EJB, etc.)." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "If you have questions, use the user forum linked on the Hibernate website. We also provide a JIRA issue tracking system for bug reports and feature requests. If you are interested in the development of Hibernate, join the developer mailing list. If you are interested in translating this documentation into your language, contact us on the developer mailing list." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "Commercial development support, production support, and training for Hibernate is available through JBoss Inc. (see http://www.hibernate.org/SupportTraining/). Hibernate is a Professional Open Source project and a critical component of the JBoss Enterprise Middleware System (JEMS) suite of products." +msgstr "" + +#. Tag: title +#, no-c-format +msgid "Feedback" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "Use <ulink url=\"http://opensource.atlassian.com/projects/hibernate\">Hibernate JIRA</ulink> to report errors or request enhacements to this documentation." +msgstr "" + Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/fallback_content/Conventions.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/fallback_content/Conventions.pot (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/fallback_content/Conventions.pot 2010-02-08 05:08:18 UTC (rev 18718) @@ -0,0 +1,214 @@ +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. +# +msgid "" +msgstr "" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:20\n" +"PO-Revision-Date: 2010-01-08T04:07:20\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" +"MIME-Version: 1.0\n" +"Content-Type: application/x-publican; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#, no-c-format +msgid "Document Conventions" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "This manual uses several conventions to highlight certain words and phrases and draw attention to specific pieces of information." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "In PDF and paper editions, this manual uses typefaces drawn from the <ulink url=\"https://fedorahosted.org/liberation-fonts/\">Liberation Fonts</ulink> set. The Liberation Fonts set is also used in HTML editions if the set is installed on your system. If not, alternative but equivalent typefaces are displayed. Note: Red Hat Enterprise Linux 5 and later includes the Liberation Fonts set by default." +msgstr "" + +#. Tag: title +#, no-c-format +msgid "Typographic Conventions" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "Four typographic conventions are used to call attention to specific words and phrases. These conventions, and the circumstances they apply to, are as follows." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "<literal>Mono-spaced Bold</literal>" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "Used to highlight system input, including shell commands, file names and paths. Also used to highlight keycaps and key combinations. For example:" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "To see the contents of the file <filename>my_next_bestselling_novel</filename> in your current working directory, enter the <command>cat my_next_bestselling_novel</command> command at the shell prompt and press <keycap>Enter</keycap> to execute the command." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "The above includes a file name, a shell command and a keycap, all presented in mono-spaced bold and all distinguishable thanks to context." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "Key combinations can be distinguished from keycaps by the hyphen connecting each part of a key combination. For example:" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "Press <keycap>Enter</keycap> to execute the command." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "Press <keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>F1</keycap></keycombo> to switch to the first virtual terminal. Press <keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>F7</keycap></keycombo> to return to your X-Windows session." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "The first paragraph highlights the particular keycap to press. The second highlights two key combinations (each a set of three keycaps with each set pressed simultaneously)." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "If source code is discussed, class names, methods, functions, variable names and returned values mentioned within a paragraph will be presented as above, in <literal>mono-spaced bold</literal>. For example:" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "File-related classes include <classname>filesystem</classname> for file systems, <classname>file</classname> for files, and <classname>dir</classname> for directories. Each class has its own associated set of permissions." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "<application>Proportional Bold</application>" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "This denotes words or phrases encountered on a system, including application names; dialog box text; labeled buttons; check-box and radio button labels; menu titles and sub-menu titles. For example:" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "Choose <menuchoice><guimenu>System</guimenu><guisubmenu>Preferences</guisubmenu><guimenuitem>Mouse</guimenuitem></menuchoice> from the main menu bar to launch <application>Mouse Preferences</application>. In the <guilabel>Buttons</guilabel> tab, click the <guilabel>Left-handed mouse</guilabel> check box and click <guibutton>Close</guibutton> to switch the primary mouse button from the left to the right (making the mouse suitable for use in the left hand)." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "To insert a special character into a <application>gedit</application> file, choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Accessories</guisubmenu><guimenuitem>Character Map</guimenuitem></menuchoice> from the main menu bar. Next, choose <menuchoice><guimenu>Search</guimenu><guimenuitem>Find…</guimenuitem></menuchoice> from the <application>Character Map</application> menu bar, type the name of the character in the <guilabel>Search</guilabel> field and click <guibutton>Next</guibutton>. The character you sought will be highlighted in the <guilabel>Character Table</guilabel>. Double-click this highlighted character to place it in the <guilabel>Text to copy</guilabel> field and then click the <guibutton>Copy</guibutton> button. Now switch back to your document and choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Paste</guimenuitem></menuchoice> from the <application>gedit</application> menu bar." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "The above text includes application names; system-wide menu names and items; application-specific menu names; and buttons and text found within a GUI interface, all presented in proportional bold and all distinguishable by context." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "<command><replaceable>Mono-spaced Bold Italic</replaceable></command> or <application><replaceable>Proportional Bold Italic</replaceable></application>" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "Whether mono-spaced bold or proportional bold, the addition of italics indicates replaceable or variable text. Italics denotes text you do not input literally or displayed text that changes depending on circumstance. For example:" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "To connect to a remote machine using ssh, type <command>ssh <replaceable>username</replaceable>@<replaceable>domain.name</replaceable></command> at a shell prompt. If the remote machine is <filename>example.com</filename> and your username on that machine is john, type <command>ssh john(a)example.com</command>." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "The <command>mount -o remount <replaceable>file-system</replaceable></command> command remounts the named file system. For example, to remount the <filename>/home</filename> file system, the command is <command>mount -o remount /home</command>." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "To see the version of a currently installed package, use the <command>rpm -q <replaceable>package</replaceable></command> command. It will return a result as follows: <command><replaceable>package-version-release</replaceable></command>." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "Note the words in bold italics above — username, domain.name, file-system, package, version and release. Each word is a placeholder, either for text you enter when issuing a command or for text displayed by the system." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "Aside from standard usage for presenting the title of a work, italics denotes the first use of a new and important term. For example:" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "Publican is a <firstterm>DocBook</firstterm> publishing system." +msgstr "" + +#. Tag: title +#, no-c-format +msgid "Pull-quote Conventions" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "Terminal output and source code listings are set off visually from the surrounding text." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "Output sent to a terminal is set in <computeroutput>mono-spaced roman</computeroutput> and presented thus:" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "Source-code listings are also set in <computeroutput>mono-spaced roman</computeroutput> but add syntax highlighting as follows:" +msgstr "" + +#. Tag: title +#, no-c-format +msgid "Notes and Warnings" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "Finally, we use three visual styles to draw attention to information that might otherwise be overlooked." +msgstr "" + +#. Tag: title +#, no-c-format +msgid "Note" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "Notes are tips, shortcuts or alternative approaches to the task at hand. Ignoring a note should have no negative consequences, but you might miss out on a trick that makes your life easier." +msgstr "" + +#. Tag: title +#, no-c-format +msgid "Important" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "Important boxes detail things that are easily missed: configuration changes that only apply to the current session, or services that need restarting before an update will apply. Ignoring a box labeled 'Important' won't cause data loss but may cause irritation and frustration." +msgstr "" + +#. Tag: title +#, no-c-format +msgid "Warning" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "Warnings should not be ignored. Ignoring warnings will most likely cause data loss." +msgstr "" + Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/fallback_content/Feedback.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/fallback_content/Feedback.pot (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/fallback_content/Feedback.pot 2010-02-08 05:08:18 UTC (rev 18718) @@ -0,0 +1,34 @@ +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. +# +msgid "" +msgstr "" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:20\n" +"PO-Revision-Date: 2010-01-08T04:07:20\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" +"MIME-Version: 1.0\n" +"Content-Type: application/x-publican; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#, no-c-format +msgid "We Need Feedback!" +msgstr "" + +#. Tag: primary +#, no-c-format +msgid "feedback" +msgstr "" + +#. Tag: secondary +#, no-c-format +msgid "contact information for this manual" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "You should over ride this by creating your own local Feedback.xml file." +msgstr "" + Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/fallback_content/Legal_Notice.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/fallback_content/Legal_Notice.pot (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/fallback_content/Legal_Notice.pot 2010-02-08 05:08:18 UTC (rev 18718) @@ -0,0 +1,19 @@ +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. +# +msgid "" +msgstr "" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:20\n" +"PO-Revision-Date: 2010-01-08T04:07:20\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" +"MIME-Version: 1.0\n" +"Content-Type: application/x-publican; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: para +#, no-c-format +msgid "Copyright <trademark class=\"copyright\"></trademark> &YEAR; &HOLDER; This material may only be distributed subject to the terms and conditions set forth in the GNU Free Documentation License (GFDL), V1.2 or later (the latest version is presently available at <ulink url=\"http://www.gnu.org/licenses/fdl.txt\">http://www.gnu.org/licenses/fdl.txt</ulink>)." +msgstr "" +

15 years, 8 months

1
0
0 / 0

Hibernate SVN: r18717 - in core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot: content and 1 other directory.

by hibernate-commits＠lists.jboss.org

Author: stliu Date: 2010-02-07 23:56:55 -0500 (Sun, 07 Feb 2010) New Revision: 18717 Removed: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/bibliography.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/preface.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/legal_notice.pot Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Author_Group.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Hibernate_Core_Reference_Guide.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/architecture.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/association_mapping.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/basic_mapping.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/batch.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/best_practices.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/collection_mapping.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/component_mapping.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/configuration.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/events.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/example_mappings.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/example_parentchild.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/example_weblog.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/filters.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/inheritance_mapping.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/performance.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/persistent_classes.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/portability.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/query_criteria.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/query_hql.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/query_sql.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/session_api.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/toolset_guide.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/transactions.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/tutorial.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/xml.pot Log: HHH-4728 Import work done by Red Hat translation team Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Author_Group.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Author_Group.pot 2010-02-08 04:50:03 UTC (rev 18716) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Author_Group.pot 2010-02-08 04:56:55 UTC (rev 18717) @@ -1,190 +1,14 @@ -# SOME DESCRIPTIVE TITLE. -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. # -#, fuzzy msgid "" msgstr "" -"Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-16 18:47+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:17\n" +"PO-Revision-Date: 2010-01-08T04:07:17\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" "MIME-Version: 1.0\n" -"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Type: application/x-publican; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -#. Tag: author -#: author_group.xml:27 -#, no-c-format -msgid "<firstname>Gavin</firstname> <surname>King</surname>" -msgstr "" - -#. Tag: author -#: author_group.xml:31 -#, no-c-format -msgid "<firstname>Christian</firstname> <surname>Bauer</surname>" -msgstr "" - -#. Tag: author -#: author_group.xml:35 -#, no-c-format -msgid "<firstname>Max</firstname> <othername>Rydahl</othername> <surname>Andersen</surname>" -msgstr "" - -#. Tag: author -#: author_group.xml:40 -#, no-c-format -msgid "<author><firstname>Emmanuel</firstname> <surname>Bernard</surname></author>" -msgstr "" - -#. Tag: author -#: author_group.xml:44 -#, no-c-format -msgid "<firstname>Steve</firstname> <surname>Ebersole</surname>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:49 -#, no-c-format -msgid "<firstname>James</firstname> <surname>Cobb</surname>" -msgstr "" - -#. Tag: shortaffil -#: author_group.xml:53 author_group.xml:60 -#, no-c-format -msgid "Graphic Design" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:56 -#, no-c-format -msgid "<firstname>Cheyenne</firstname> <surname>Weaver</surname>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:69 -#, no-c-format -msgid "<othername><![CDATA[Bernardo Antonio Buffa Colom&#x00e9]]></othername> <email>kreimer(a)bbs.frc.utn.edu.ar</email>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:79 -#, no-c-format -msgid "<firstname>Vincent</firstname> <surname>Ricard</surname>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:83 -#, no-c-format -msgid "<firstname>Sebastien</firstname> <surname>Cesbron</surname>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:87 -#, no-c-format -msgid "<firstname>Michael</firstname> <surname>Courcy</surname>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:91 -#, no-c-format -msgid "<firstname>Vincent</firstname> <surname>Giguère</surname>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:95 -#, no-c-format -msgid "<firstname>Baptiste</firstname> <surname>Mathus</surname>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:99 -#, no-c-format -msgid "<othercredit><firstname>Emmanuel</firstname> <surname>Bernard</surname></othercredit>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:103 -#, no-c-format -msgid "<firstname>Anthony</firstname> <surname>Patricio</surname>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:113 -#, no-c-format -msgid "<firstname>Alvaro</firstname> <surname>Netto</surname> <email>alvaronetto(a)cetip.com.br</email>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:118 -#, no-c-format -msgid "<firstname>Anderson</firstname> <surname>Braulio</surname> <email>andersonbraulio(a)gmail.com</email>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:123 -#, no-c-format -msgid "<firstname>Daniel Vieira</firstname> <surname>Costa</surname> <email>danielvc(a)gmail.com</email>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:128 -#, no-c-format -msgid "<firstname>Francisco</firstname> <surname>gamarra</surname> <email>francisco.gamarra(a)gmail.com</email>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:133 -#, no-c-format -msgid "<firstname>Gamarra</firstname> <email>mauricio.gamarra(a)gmail.com</email>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:137 -#, no-c-format -msgid "<firstname>Luiz Carlos</firstname> <surname>Rodrigues</surname> <email>luizcarlos_rodrigues(a)yahoo.com.br</email>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:142 -#, no-c-format -msgid "<firstname>Marcel</firstname> <surname>Castelo</surname> <email>marcel.castelo(a)gmail.com</email>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:147 -#, no-c-format -msgid "<firstname>Paulo</firstname> <surname>César</surname> <email>paulocol(a)gmail.com</email>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:152 -#, no-c-format -msgid "<firstname>Pablo L.</firstname> <surname>de Miranda</surname> <email>pablolmiranda(a)gmail.com</email>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:157 -#, no-c-format -msgid "<firstname>Renato</firstname> <surname>Deggau</surname> <email>rdeggau(a)gmail.com</email>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:162 -#, no-c-format -msgid "<firstname>Rogério</firstname> <surname>Araújo</surname> <email>rgildoaraujo(a)yahoo.com.br</email>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:167 -#, no-c-format -msgid "<firstname>Wanderson</firstname> <surname>Siqueira</surname> <email>wandersonxs(a)gmail.com</email>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:178 -#, no-c-format -msgid "<firstname>Cao</firstname> <surname>Xiaogang</surname> <affiliation> <orgname>RedSaga</orgname> </affiliation> <contrib>Translation Lead</contrib> <email>caoxg(a)yahoo.com</email>" -msgstr "" - Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Hibernate_Core_Reference_Guide.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Hibernate_Core_Reference_Guide.pot 2010-02-08 04:50:03 UTC (rev 18716) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Hibernate_Core_Reference_Guide.pot 2010-02-08 04:56:55 UTC (rev 18717) @@ -1,34 +1,14 @@ -# SOME DESCRIPTIVE TITLE. -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. # -#, fuzzy msgid "" msgstr "" -"Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-24 02:10+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:17\n" +"PO-Revision-Date: 2010-01-08T04:07:17\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" "MIME-Version: 1.0\n" -"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Type: application/x-publican; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -#. Tag: title -#: Hibernate_Reference.xml:35 -#, no-c-format -msgid "HIBERNATE - Relational Persistence for Idiomatic Java" -msgstr "" - -#. Tag: subtitle -#: Hibernate_Reference.xml:36 -#, no-c-format -msgid "Hibernate Reference Documentation" -msgstr "" - -#. Tag: holder -#: Hibernate_Reference.xml:51 -#, no-c-format -msgid "&copyrightHolder;" -msgstr "" - Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/architecture.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/architecture.pot 2010-02-08 04:50:03 UTC (rev 18716) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/architecture.pot 2010-02-08 04:56:55 UTC (rev 18717) @@ -1,327 +1,273 @@ -# SOME DESCRIPTIVE TITLE. -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. # -#, fuzzy msgid "" msgstr "" -"Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-10 21:02+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:17\n" +"PO-Revision-Date: 2010-01-08T04:07:17\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" "MIME-Version: 1.0\n" -"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Type: application/x-publican; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. Tag: title -#: architecture.xml:30 #, no-c-format msgid "Architecture" msgstr "" #. Tag: title -#: architecture.xml:33 #, no-c-format msgid "Overview" msgstr "" #. Tag: para -#: architecture.xml:35 #, no-c-format msgid "The diagram below provides a high-level view of the Hibernate architecture:" msgstr "" #. Tag: para -#: architecture.xml:50 #, no-c-format msgid "We do not have the scope in this document to provide a more detailed view of all the runtime architectures available; Hibernate is flexible and supports several different approaches. We will, however, show the two extremes: \"minimal\" architecture and \"comprehensive\" architecture." msgstr "" #. Tag: para -#: architecture.xml:56 #, no-c-format msgid "This next diagram illustrates how Hibernate utilizes database and configuration data to provide persistence services, and persistent objects, to the application." msgstr "" #. Tag: para -#: architecture.xml:61 #, no-c-format msgid "The \"minimal\" architecture has the application provide its own JDBC connections and manage its own transactions. This approach uses a minimal subset of Hibernate's APIs:" msgstr "" #. Tag: para -#: architecture.xml:78 #, no-c-format msgid "The \"comprehensive\" architecture abstracts the application away from the underlying JDBC/JTA APIs and allows Hibernate to manage the details." msgstr "" #. Tag: para -#: architecture.xml:92 #, no-c-format msgid "Here are some definitions of the objects depicted in the diagrams:" msgstr "" #. Tag: term -#: architecture.xml:97 #, no-c-format msgid "SessionFactory (<literal>org.hibernate.SessionFactory</literal>)" msgstr "" #. Tag: para -#: architecture.xml:99 #, no-c-format msgid "A threadsafe, immutable cache of compiled mappings for a single database. A factory for <literal>Session</literal> and a client of <literal>ConnectionProvider</literal>, <literal>SessionFactory</literal> can hold an optional (second-level) cache of data that is reusable between transactions at a process, or cluster, level." msgstr "" #. Tag: term -#: architecture.xml:109 #, no-c-format msgid "Session (<literal>org.hibernate.Session</literal>)" msgstr "" #. Tag: para -#: architecture.xml:111 #, no-c-format msgid "A single-threaded, short-lived object representing a conversation between the application and the persistent store. It wraps a JDBC connection and is a factory for <literal>Transaction</literal>. <literal>Session</literal> holds a mandatory first-level cache of persistent objects that are used when navigating the object graph or looking up objects by identifier." msgstr "" #. Tag: term -#: architecture.xml:121 #, no-c-format msgid "Persistent objects and collections" msgstr "" #. Tag: para -#: architecture.xml:123 #, no-c-format msgid "Short-lived, single threaded objects containing persistent state and business function. These can be ordinary JavaBeans/POJOs. They are associated with exactly one <literal>Session</literal>. Once the <literal>Session</literal> is closed, they will be detached and free to use in any application layer (for example, directly as data transfer objects to and from presentation)." msgstr "" #. Tag: term -#: architecture.xml:133 #, no-c-format msgid "Transient and detached objects and collections" msgstr "" #. Tag: para -#: architecture.xml:135 #, no-c-format msgid "Instances of persistent classes that are not currently associated with a <literal>Session</literal>. They may have been instantiated by the application and not yet persisted, or they may have been instantiated by a closed <literal>Session</literal>." msgstr "" #. Tag: term -#: architecture.xml:144 #, no-c-format msgid "Transaction (<literal>org.hibernate.Transaction</literal>)" msgstr "" #. Tag: para -#: architecture.xml:146 #, no-c-format msgid "(Optional) A single-threaded, short-lived object used by the application to specify atomic units of work. It abstracts the application from the underlying JDBC, JTA or CORBA transaction. A <literal>Session</literal> might span several <literal>Transaction</literal>s in some cases. However, transaction demarcation, either using the underlying API or <literal>Transaction</literal>, is never optional." msgstr "" #. Tag: term -#: architecture.xml:157 #, no-c-format msgid "ConnectionProvider (<literal>org.hibernate.connection.ConnectionProvider</literal>)" msgstr "" #. Tag: para -#: architecture.xml:159 #, no-c-format msgid "(Optional) A factory for, and pool of, JDBC connections. It abstracts the application from underlying <literal>Datasource</literal> or <literal>DriverManager</literal>. It is not exposed to application, but it can be extended and/or implemented by the developer." msgstr "" #. Tag: term -#: architecture.xml:167 #, no-c-format msgid "TransactionFactory (<literal>org.hibernate.TransactionFactory</literal>)" msgstr "" #. Tag: para -#: architecture.xml:169 #, no-c-format msgid "(Optional) A factory for <literal>Transaction</literal> instances. It is not exposed to the application, but it can be extended and/or implemented by the developer." msgstr "" -#. Tag: emphasis -#: architecture.xml:176 +#. Tag: term #, no-c-format -msgid "Extension Interfaces" +msgid "<emphasis>Extension Interfaces</emphasis>" msgstr "" #. Tag: para -#: architecture.xml:178 #, no-c-format msgid "Hibernate offers a range of optional extension interfaces you can implement to customize the behavior of your persistence layer. See the API documentation for details." msgstr "" #. Tag: para -#: architecture.xml:187 #, no-c-format msgid "Given a \"minimal\" architecture, the application bypasses the <literal>Transaction</literal>/<literal>TransactionFactory</literal> and/or <literal>ConnectionProvider</literal> APIs to communicate with JTA or JDBC directly." msgstr "" #. Tag: title -#: architecture.xml:195 #, no-c-format msgid "Instance states" msgstr "" #. Tag: para -#: architecture.xml:196 #, no-c-format msgid "An instance of a persistent class can be in one of three different states. These states are defined in relation to a <emphasis>persistence context</emphasis>. The Hibernate <literal>Session</literal> object is the persistence context. The three different states are as follows:" msgstr "" #. Tag: term -#: architecture.xml:204 #, no-c-format msgid "transient" msgstr "" #. Tag: para -#: architecture.xml:206 #, no-c-format msgid "The instance is not associated with any persistence context. It has no persistent identity or primary key value." msgstr "" #. Tag: term -#: architecture.xml:214 #, no-c-format msgid "persistent" msgstr "" #. Tag: para -#: architecture.xml:216 #, no-c-format msgid "The instance is currently associated with a persistence context. It has a persistent identity (primary key value) and can have a corresponding row in the database. For a particular persistence context, Hibernate <emphasis>guarantees</emphasis> that persistent identity is equivalent to Java identity in relation to the in-memory location of the object." msgstr "" #. Tag: term -#: architecture.xml:228 #, no-c-format msgid "detached" msgstr "" #. Tag: para -#: architecture.xml:230 #, no-c-format msgid "The instance was once associated with a persistence context, but that context was closed, or the instance was serialized to another process. It has a persistent identity and can have a corresponding row in the database. For detached instances, Hibernate does not guarantee the relationship between persistent identity and Java identity." msgstr "" #. Tag: title -#: architecture.xml:245 #, no-c-format msgid "JMX Integration" msgstr "" #. Tag: para -#: architecture.xml:247 #, no-c-format msgid "JMX is the J2EE standard for the management of Java components. Hibernate can be managed via a JMX standard service. AN MBean implementation is provided in the distribution: <literal>org.hibernate.jmx.HibernateService</literal>." msgstr "" #. Tag: para -#: architecture.xml:253 #, no-c-format msgid "For an example of how to deploy Hibernate as a JMX service on the JBoss Application Server, please see the JBoss User Guide. JBoss AS also provides these benefits if you deploy using JMX:" msgstr "" #. Tag: para -#: architecture.xml:261 #, no-c-format msgid "<emphasis>Session Management</emphasis>: the Hibernate <literal>Session</literal>'s life cycle can be automatically bound to the scope of a JTA transaction. This means that you no longer have to manually open and close the <literal>Session</literal>; this becomes the job of a JBoss EJB interceptor. You also do not have to worry about transaction demarcation in your code (if you would like to write a portable persistence layer use the optional Hibernate <literal>Transaction</literal> API for this). You call the <literal>HibernateContext</literal> to access a <literal>Session</literal>." msgstr "" #. Tag: para -#: architecture.xml:273 #, no-c-format msgid "<emphasis>HAR deployment</emphasis>: the Hibernate JMX service is deployed using a JBoss service deployment descriptor in an EAR and/or SAR file, as it supports all the usual configuration options of a Hibernate <literal>SessionFactory</literal>. However, you still need to name all your mapping files in the deployment descriptor. If you use the optional HAR deployment, JBoss will automatically detect all mapping files in your HAR file." msgstr "" #. Tag: para -#: architecture.xml:284 #, no-c-format msgid "Consult the JBoss AS user guide for more information about these options." msgstr "" #. Tag: para -#: architecture.xml:288 #, no-c-format -msgid "Another feature available as a JMX service is runtime Hibernate statistics. See <xref linkend=\"configuration-optional-statistics\"/> for more information." +msgid "Another feature available as a JMX service is runtime Hibernate statistics. See <xref linkend=\"configuration-optional-statistics\" /> for more information." msgstr "" #. Tag: title -#: architecture.xml:295 #, no-c-format msgid "JCA Support" msgstr "" #. Tag: para -#: architecture.xml:296 #, no-c-format msgid "Hibernate can also be configured as a JCA connector. Please see the website for more information. Please note, however, that at this stage Hibernate JCA support is under development." msgstr "" #. Tag: title -#: architecture.xml:303 #, no-c-format msgid "Contextual sessions" msgstr "" #. Tag: para -#: architecture.xml:304 #, no-c-format msgid "Most applications using Hibernate need some form of \"contextual\" session, where a given session is in effect throughout the scope of a given context. However, across applications the definition of what constitutes a context is typically different; different contexts define different scopes to the notion of current. Applications using Hibernate prior to version 3.0 tended to utilize either home-grown <literal>ThreadLocal</literal>-based contextual sessions, helper classes such as <literal>HibernateUtil</literal>, or utilized third-party frameworks, such as Spring or Pico, which provided proxy/interception-based contextual sessions." msgstr "" #. Tag: para -#: architecture.xml:313 #, no-c-format msgid "Starting with version 3.0.1, Hibernate added the <literal>SessionFactory.getCurrentSession()</literal> method. Initially, this assumed usage of <literal>JTA</literal> transactions, where the <literal>JTA</literal> transaction defined both the scope and context of a current session. Given the maturity of the numerous stand-alone <literal>JTA TransactionManager</literal> implementations, most, if not all, applications should be using <literal>JTA</literal> transaction management, whether or not they are deployed into a <literal>J2EE</literal> container. Based on that, the <literal>JTA</literal>-based contextual sessions are all you need to use." msgstr "" #. Tag: para -#: architecture.xml:323 #, no-c-format msgid "However, as of version 3.1, the processing behind <literal>SessionFactory.getCurrentSession()</literal> is now pluggable. To that end, a new extension interface, <literal>org.hibernate.context.CurrentSessionContext</literal>, and a new configuration parameter, <literal>hibernate.current_session_context_class</literal>, have been added to allow pluggability of the scope and context of defining current sessions." msgstr "" #. Tag: para -#: architecture.xml:330 #, no-c-format msgid "See the Javadocs for the <literal>org.hibernate.context.CurrentSessionContext</literal> interface for a detailed discussion of its contract. It defines a single method, <literal>currentSession()</literal>, by which the implementation is responsible for tracking the current contextual session. Out-of-the-box, Hibernate comes with three implementations of this interface:" msgstr "" #. Tag: para -#: architecture.xml:340 #, no-c-format msgid "<literal>org.hibernate.context.JTASessionContext</literal>: current sessions are tracked and scoped by a <literal>JTA</literal> transaction. The processing here is exactly the same as in the older JTA-only approach. See the Javadocs for details." msgstr "" #. Tag: para -#: architecture.xml:348 #, no-c-format msgid "<literal>org.hibernate.context.ThreadLocalSessionContext</literal>:current sessions are tracked by thread of execution. See the Javadocs for details." msgstr "" #. Tag: para -#: architecture.xml:354 #, no-c-format msgid "<literal>org.hibernate.context.ManagedSessionContext</literal>: current sessions are tracked by thread of execution. However, you are responsible to bind and unbind a <literal>Session</literal> instance with static methods on this class: it does not open, flush, or close a <literal>Session</literal>." msgstr "" #. Tag: para -#: architecture.xml:363 #, no-c-format -msgid "The first two implementations provide a \"one session - one database transaction\" programming model. This is also also known and used as <emphasis>session-per-request</emphasis>. The beginning and end of a Hibernate session is defined by the duration of a database transaction. If you use programmatic transaction demarcation in plain JSE without JTA, you are advised to use the Hibernate <literal>Transaction</literal> API to hide the underlying transaction system from your code. If you use JTA, you can utilize the JTA interfaces to demarcate transactions. If you execute in an EJB container that supports CMT, transaction boundaries are defined declaratively and you do not need any transaction or session demarcation operations in your code. Refer to <xref linkend=\"transactions\"/> for more information and code examples." +msgid "The first two implementations provide a \"one session - one database transaction\" programming model. This is also also known and used as <emphasis>session-per-request</emphasis>. The beginning and end of a Hibernate session is defined by the duration of a database transaction. If you use programmatic transaction demarcation in plain JSE without JTA, you are advised to use the Hibernate <literal>Transaction</literal> API to hide the underlying transaction system from your code. If you use JTA, you can utilize the JTA interfaces to demarcate transactions. If you execute in an EJB container that supports CMT, transaction boundaries are defined declaratively and you do not need any transaction or session demarcation operations in your code. Refer to <xref linkend=\"transactions\" /> for more information and code examples." msgstr "" #. Tag: para -#: architecture.xml:375 #, no-c-format msgid "The <literal>hibernate.current_session_context_class</literal> configuration parameter defines which <literal>org.hibernate.context.CurrentSessionContext</literal> implementation should be used. For backwards compatibility, if this configuration parameter is not set but a <literal>org.hibernate.transaction.TransactionManagerLookup</literal> is configured, Hibernate will use the <literal>org.hibernate.context.JTASessionContext</literal>. Typically, the value of this parameter would just name the implementation class to use. For the three out-of-the-box implementations, however, there are three corresponding short names: \"jta\", \"thread\", and \"managed\"." msgstr "" Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/association_mapping.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/association_mapping.pot 2010-02-08 04:50:03 UTC (rev 18716) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/association_mapping.pot 2010-02-08 04:56:55 UTC (rev 18717) @@ -1,743 +1,198 @@ -# SOME DESCRIPTIVE TITLE. -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. # -#, fuzzy msgid "" msgstr "" -"Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-10 21:02+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:17\n" +"PO-Revision-Date: 2010-01-08T04:07:17\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" "MIME-Version: 1.0\n" -"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Type: application/x-publican; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. Tag: title -#: association_mapping.xml:30 #, no-c-format msgid "Association Mappings" msgstr "" #. Tag: title -#: association_mapping.xml:33 #, no-c-format msgid "Introduction" msgstr "" #. Tag: para -#: association_mapping.xml:35 #, no-c-format msgid "Association mappings are often the most difficult thing to implement correctly. In this section we examine some canonical cases one by one, starting with unidirectional mappings and then bidirectional cases. We will use <literal>Person</literal> and <literal>Address</literal> in all the examples." msgstr "" #. Tag: para -#: association_mapping.xml:43 #, no-c-format msgid "Associations will be classified by multiplicity and whether or not they map to an intervening join table." msgstr "" #. Tag: para -#: association_mapping.xml:48 #, no-c-format msgid "Nullable foreign keys are not considered to be good practice in traditional data modelling, so our examples do not use nullable foreign keys. This is not a requirement of Hibernate, and the mappings will work if you drop the nullability constraints." msgstr "" #. Tag: title -#: association_mapping.xml:58 #, no-c-format msgid "Unidirectional associations" msgstr "" #. Tag: title -#: association_mapping.xml:61 association_mapping.xml:132 #, no-c-format msgid "Many-to-one" msgstr "" #. Tag: para -#: association_mapping.xml:63 #, no-c-format msgid "A <emphasis>unidirectional many-to-one association</emphasis> is the most common kind of unidirectional association." msgstr "" -#. Tag: programlisting -#: association_mapping.xml:68 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <many-to-one name=\"address\" \n" - " column=\"addressId\"\n" - " not-null=\"true\"/>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "</class>]]>" -msgstr "" - -#. Tag: programlisting -#: association_mapping.xml:69 association_mapping.xml:185 -#, no-c-format -msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key, addressId bigint not null )\n" - "create table Address ( addressId bigint not null primary key )\n" - " ]]>" -msgstr "" - #. Tag: title -#: association_mapping.xml:74 association_mapping.xml:145 association_mapping.xml:210 #, no-c-format msgid "One-to-one" msgstr "" #. Tag: para -#: association_mapping.xml:76 #, no-c-format msgid "A <emphasis>unidirectional one-to-one association on a foreign key</emphasis> is almost identical. The only difference is the column unique constraint." msgstr "" -#. Tag: programlisting -#: association_mapping.xml:81 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <many-to-one name=\"address\" \n" - " column=\"addressId\" \n" - " unique=\"true\"\n" - " not-null=\"true\"/>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "</class>]]>" -msgstr "" - -#. Tag: programlisting -#: association_mapping.xml:82 association_mapping.xml:218 -#, no-c-format -msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key, addressId bigint not null unique )\n" - "create table Address ( addressId bigint not null primary key )\n" - " ]]>" -msgstr "" - #. Tag: para -#: association_mapping.xml:84 #, no-c-format msgid "A <emphasis>unidirectional one-to-one association on a primary key</emphasis> usually uses a special id generator In this example, however, we have reversed the direction of the association:" msgstr "" -#. Tag: programlisting -#: association_mapping.xml:90 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"foreign\">\n" - " <param name=\"property\">person</param>\n" - " </generator>\n" - " </id>\n" - " <one-to-one name=\"person\" constrained=\"true\"/>\n" - "</class>]]>" -msgstr "" - -#. Tag: programlisting -#: association_mapping.xml:91 association_mapping.xml:226 -#, no-c-format -msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key )\n" - "create table Address ( personId bigint not null primary key )\n" - " ]]>" -msgstr "" - #. Tag: title -#: association_mapping.xml:96 association_mapping.xml:118 #, no-c-format msgid "One-to-many" msgstr "" #. Tag: para -#: association_mapping.xml:98 #, no-c-format msgid "A <emphasis>unidirectional one-to-many association on a foreign key</emphasis> is an unusual case, and is not recommended." msgstr "" -#. Tag: programlisting -#: association_mapping.xml:103 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <set name=\"addresses\">\n" - " <key column=\"personId\" \n" - " not-null=\"true\"/>\n" - " <one-to-many class=\"Address\"/>\n" - " </set>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "</class>]]>" -msgstr "" - -#. Tag: programlisting -#: association_mapping.xml:104 -#, no-c-format -msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key )\n" - "create table Address ( addressId bigint not null primary key, personId bigint not null )\n" - " ]]>" -msgstr "" - #. Tag: para -#: association_mapping.xml:106 #, no-c-format msgid "You should instead use a join table for this kind of association." msgstr "" #. Tag: title -#: association_mapping.xml:115 #, no-c-format msgid "Unidirectional associations with join tables" msgstr "" #. Tag: para -#: association_mapping.xml:120 #, no-c-format msgid "A <emphasis>unidirectional one-to-many association on a join table</emphasis> is the preferred option. Specifying <literal>unique=\"true\"</literal>, changes the multiplicity from many-to-many to one-to-many." msgstr "" -#. Tag: programlisting -#: association_mapping.xml:126 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <set name=\"addresses\" table=\"PersonAddress\">\n" - " <key column=\"personId\"/>\n" - " <many-to-many column=\"addressId\"\n" - " unique=\"true\"\n" - " class=\"Address\"/>\n" - " </set>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "</class>]]>" -msgstr "" - -#. Tag: programlisting -#: association_mapping.xml:127 -#, no-c-format -msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key )\n" - "create table PersonAddress ( personId not null, addressId bigint not null primary key )\n" - "create table Address ( addressId bigint not null primary key )\n" - " ]]>" -msgstr "" - #. Tag: para -#: association_mapping.xml:134 #, no-c-format msgid "A <emphasis>unidirectional many-to-one association on a join table</emphasis> is common when the association is optional. For example:" msgstr "" -#. Tag: programlisting -#: association_mapping.xml:139 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <join table=\"PersonAddress\" \n" - " optional=\"true\">\n" - " <key column=\"personId\" unique=\"true\"/>\n" - " <many-to-one name=\"address\"\n" - " column=\"addressId\" \n" - " not-null=\"true\"/>\n" - " </join>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "</class>]]>" -msgstr "" - -#. Tag: programlisting -#: association_mapping.xml:140 -#, no-c-format -msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key )\n" - "create table PersonAddress ( personId bigint not null primary key, addressId bigint not null )\n" - "create table Address ( addressId bigint not null primary key )\n" - " ]]>" -msgstr "" - #. Tag: para -#: association_mapping.xml:147 #, no-c-format msgid "A <emphasis>unidirectional one-to-one association on a join table</emphasis> is possible, but extremely unusual." msgstr "" -#. Tag: programlisting -#: association_mapping.xml:152 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <join table=\"PersonAddress\" \n" - " optional=\"true\">\n" - " <key column=\"personId\" \n" - " unique=\"true\"/>\n" - " <many-to-one name=\"address\"\n" - " column=\"addressId\" \n" - " not-null=\"true\"\n" - " unique=\"true\"/>\n" - " </join>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "</class>]]>" -msgstr "" - -#. Tag: programlisting -#: association_mapping.xml:153 association_mapping.xml:258 -#, no-c-format -msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key )\n" - "create table PersonAddress ( personId bigint not null primary key, addressId bigint not null unique )\n" - "create table Address ( addressId bigint not null primary key )\n" - " ]]>" -msgstr "" - #. Tag: title -#: association_mapping.xml:158 association_mapping.xml:263 #, no-c-format msgid "Many-to-many" msgstr "" #. Tag: para -#: association_mapping.xml:160 #, no-c-format msgid "Finally, here is an example of a <emphasis>unidirectional many-to-many association</emphasis>." msgstr "" -#. Tag: programlisting -#: association_mapping.xml:164 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <set name=\"addresses\" table=\"PersonAddress\">\n" - " <key column=\"personId\"/>\n" - " <many-to-many column=\"addressId\"\n" - " class=\"Address\"/>\n" - " </set>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "</class>]]>" -msgstr "" - -#. Tag: programlisting -#: association_mapping.xml:165 association_mapping.xml:271 -#, no-c-format -msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key )\n" - "create table PersonAddress ( personId bigint not null, addressId bigint not null, primary key (personId, addressId) )\n" - "create table Address ( addressId bigint not null primary key )\n" - " ]]>" -msgstr "" - #. Tag: title -#: association_mapping.xml:172 #, no-c-format msgid "Bidirectional associations" msgstr "" #. Tag: title -#: association_mapping.xml:175 association_mapping.xml:236 #, no-c-format msgid "one-to-many / many-to-one" msgstr "" #. Tag: para -#: association_mapping.xml:177 #, no-c-format msgid "A <emphasis>bidirectional many-to-one association</emphasis> is the most common kind of association. The following example illustrates the standard parent/child relationship." msgstr "" -#. Tag: programlisting -#: association_mapping.xml:183 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <many-to-one name=\"address\" \n" - " column=\"addressId\"\n" - " not-null=\"true\"/>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <set name=\"people\" inverse=\"true\">\n" - " <key column=\"addressId\"/>\n" - " <one-to-many class=\"Person\"/>\n" - " </set>\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: association_mapping.xml:187 #, no-c-format msgid "If you use a <literal>List</literal>, or other indexed collection, set the <literal>key</literal> column of the foreign key to <literal>not null</literal>. Hibernate will manage the association from the collections side to maintain the index of each element, making the other side virtually inverse by setting <literal>update=\"false\"</literal> and <literal>insert=\"false\"</literal>:" msgstr "" -#. Tag: programlisting -#: association_mapping.xml:195 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\"/>\n" - " ...\n" - " <many-to-one name=\"address\"\n" - " column=\"addressId\"\n" - " not-null=\"true\"\n" - " insert=\"false\"\n" - " update=\"false\"/>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\"/>\n" - " ...\n" - " <list name=\"people\">\n" - " <key column=\"addressId\" not-null=\"true\"/>\n" - " <list-index column=\"peopleIdx\"/>\n" - " <one-to-many class=\"Person\"/>\n" - " </list>\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: association_mapping.xml:197 #, no-c-format msgid "If the underlying foreign key column is <literal>NOT NULL</literal>, it is important that you define <literal>not-null=\"true\"</literal> on the <literal><key></literal> element of the collection mapping. Do not only declare <literal>not-null=\"true\"</literal> on a possible nested <literal><column></literal> element, but on the <literal><key></literal> element." msgstr "" #. Tag: para -#: association_mapping.xml:212 #, no-c-format msgid "A <emphasis>bidirectional one-to-one association on a foreign key</emphasis> is common:" msgstr "" -#. Tag: programlisting -#: association_mapping.xml:217 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <many-to-one name=\"address\" \n" - " column=\"addressId\" \n" - " unique=\"true\"\n" - " not-null=\"true\"/>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <one-to-one name=\"person\" \n" - " property-ref=\"address\"/>\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: association_mapping.xml:220 #, no-c-format msgid "A <emphasis>bidirectional one-to-one association on a primary key</emphasis> uses the special id generator:" msgstr "" -#. Tag: programlisting -#: association_mapping.xml:225 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <one-to-one name=\"address\"/>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"foreign\">\n" - " <param name=\"property\">person</param>\n" - " </generator>\n" - " </id>\n" - " <one-to-one name=\"person\" \n" - " constrained=\"true\"/>\n" - "</class>]]>" -msgstr "" - #. Tag: title -#: association_mapping.xml:233 #, no-c-format msgid "Bidirectional associations with join tables" msgstr "" #. Tag: para -#: association_mapping.xml:238 #, no-c-format msgid "The following is an example of a <emphasis>bidirectional one-to-many association on a join table</emphasis>. The <literal>inverse=\"true\"</literal> can go on either end of the association, on the collection, or on the join." msgstr "" -#. Tag: programlisting -#: association_mapping.xml:244 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <set name=\"addresses\" \n" - " table=\"PersonAddress\">\n" - " <key column=\"personId\"/>\n" - " <many-to-many column=\"addressId\"\n" - " unique=\"true\"\n" - " class=\"Address\"/>\n" - " </set>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <join table=\"PersonAddress\" \n" - " inverse=\"true\" \n" - " optional=\"true\">\n" - " <key column=\"addressId\"/>\n" - " <many-to-one name=\"person\"\n" - " column=\"personId\"\n" - " not-null=\"true\"/>\n" - " </join>\n" - "</class>]]>" -msgstr "" - -#. Tag: programlisting -#: association_mapping.xml:245 -#, no-c-format -msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key )\n" - "create table PersonAddress ( personId bigint not null, addressId bigint not null primary key )\n" - "create table Address ( addressId bigint not null primary key )\n" - " ]]>" -msgstr "" - #. Tag: title -#: association_mapping.xml:250 #, no-c-format msgid "one to one" msgstr "" #. Tag: para -#: association_mapping.xml:252 #, no-c-format msgid "A <emphasis>bidirectional one-to-one association on a join table</emphasis> is possible, but extremely unusual." msgstr "" -#. Tag: programlisting -#: association_mapping.xml:257 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <join table=\"PersonAddress\" \n" - " optional=\"true\">\n" - " <key column=\"personId\" \n" - " unique=\"true\"/>\n" - " <many-to-one name=\"address\"\n" - " column=\"addressId\" \n" - " not-null=\"true\"\n" - " unique=\"true\"/>\n" - " </join>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <join table=\"PersonAddress\" \n" - " optional=\"true\"\n" - " inverse=\"true\">\n" - " <key column=\"addressId\" \n" - " unique=\"true\"/>\n" - " <many-to-one name=\"person\"\n" - " column=\"personId\" \n" - " not-null=\"true\"\n" - " unique=\"true\"/>\n" - " </join>\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: association_mapping.xml:265 #, no-c-format msgid "Here is an example of a <emphasis>bidirectional many-to-many association</emphasis>." msgstr "" -#. Tag: programlisting -#: association_mapping.xml:269 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <set name=\"addresses\" table=\"PersonAddress\">\n" - " <key column=\"personId\"/>\n" - " <many-to-many column=\"addressId\"\n" - " class=\"Address\"/>\n" - " </set>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <set name=\"people\" inverse=\"true\" table=\"PersonAddress\">\n" - " <key column=\"addressId\"/>\n" - " <many-to-many column=\"personId\"\n" - " class=\"Person\"/>\n" - " </set>\n" - "</class>]]>" -msgstr "" - #. Tag: title -#: association_mapping.xml:278 #, no-c-format msgid "More complex association mappings" msgstr "" #. Tag: para -#: association_mapping.xml:280 #, no-c-format msgid "More complex association joins are <emphasis>extremely</emphasis> rare. Hibernate handles more complex situations by using SQL fragments embedded in the mapping document. For example, if a table with historical account information data defines <literal>accountNumber</literal>, <literal>effectiveEndDate</literal> and <literal>effectiveStartDate</literal>columns, it would be mapped as follows:" msgstr "" -#. Tag: programlisting -#: association_mapping.xml:289 -#, no-c-format -msgid "" - "<![CDATA[<properties name=\"currentAccountKey\">\n" - " <property name=\"accountNumber\" type=\"string\" not-null=\"true\"/>\n" - " <property name=\"currentAccount\" type=\"boolean\">\n" - " <formula>case when effectiveEndDate is null then 1 else 0 end</formula>\n" - " </property>\n" - "</properties>\n" - "<property name=\"effectiveEndDate\" type=\"date\"/>\n" - "<property name=\"effectiveStateDate\" type=\"date\" not-null=\"true\"/>]]>" -msgstr "" - #. Tag: para -#: association_mapping.xml:291 #, no-c-format msgid "You can then map an association to the <emphasis>current</emphasis> instance, the one with null <literal>effectiveEndDate</literal>, by using:" msgstr "" -#. Tag: programlisting -#: association_mapping.xml:296 -#, no-c-format -msgid "" - "<![CDATA[<many-to-one name=\"currentAccountInfo\" \n" - " property-ref=\"currentAccountKey\"\n" - " class=\"AccountInfo\">\n" - " <column name=\"accountNumber\"/>\n" - " <formula>'1'</formula>\n" - "</many-to-one>]]>" -msgstr "" - #. Tag: para -#: association_mapping.xml:298 #, no-c-format msgid "In a more complex example, imagine that the association between <literal>Employee</literal> and <literal>Organization</literal> is maintained in an <literal>Employment</literal> table full of historical employment data. An association to the employee's <emphasis>most recent</emphasis> employer, the one with the most recent <literal>startDate</literal>, could be mapped in the following way:" msgstr "" -#. Tag: programlisting -#: association_mapping.xml:306 -#, no-c-format -msgid "" - "<![CDATA[<join>\n" - " <key column=\"employeeId\"/>\n" - " <subselect>\n" - " select employeeId, orgId \n" - " from Employments \n" - " group by orgId \n" - " having startDate = max(startDate)\n" - " </subselect>\n" - " <many-to-one name=\"mostRecentEmployer\" \n" - " class=\"Organization\" \n" - " column=\"orgId\"/>\n" - "</join>]]>" -msgstr "" - #. Tag: para -#: association_mapping.xml:308 #, no-c-format msgid "This functionality allows a degree of creativity and flexibility, but it is more practical to handle these kinds of cases using HQL or a criteria query." msgstr "" Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/basic_mapping.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/basic_mapping.pot 2010-02-08 04:50:03 UTC (rev 18716) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/basic_mapping.pot 2010-02-08 04:56:55 UTC (rev 18717) @@ -1,3360 +1,1924 @@ -# SOME DESCRIPTIVE TITLE. -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. # -#, fuzzy msgid "" msgstr "" -"Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-10 21:02+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:18\n" +"PO-Revision-Date: 2010-01-08T04:07:18\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" "MIME-Version: 1.0\n" -"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Type: application/x-publican; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. Tag: title -#: basic_mapping.xml:29 #, no-c-format msgid "Basic O/R Mapping" msgstr "" #. Tag: title -#: basic_mapping.xml:32 #, no-c-format msgid "Mapping declaration" msgstr "" #. Tag: para -#: basic_mapping.xml:34 #, no-c-format msgid "Object/relational mappings are usually defined in an XML document. The mapping document is designed to be readable and hand-editable. The mapping language is Java-centric, meaning that mappings are constructed around persistent class declarations and not table declarations." msgstr "" #. Tag: para -#: basic_mapping.xml:41 #, no-c-format msgid "Please note that even though many Hibernate users choose to write the XML by hand, a number of tools exist to generate the mapping document. These include XDoclet, Middlegen and AndroMDA." msgstr "" #. Tag: para -#: basic_mapping.xml:47 #, no-c-format msgid "Here is an example mapping:" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:51 -#, no-c-format -msgid "" - "<![CDATA[<?xml version=\"1.0\"?>\n" - "<!DOCTYPE hibernate-mapping PUBLIC\n" - " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" - " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" - "\n" - "<hibernate-mapping package=\"eg\">\n" - "\n" - " <class name=\"Cat\"\n" - " table=\"cats\"\n" - " discriminator-value=\"C\">\n" - "\n" - " <id name=\"id\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "\n" - " <discriminator column=\"subclass\"\n" - " type=\"character\"/>\n" - "\n" - " <property name=\"weight\"/>\n" - "\n" - " <property name=\"birthdate\"\n" - " type=\"date\"\n" - " not-null=\"true\"\n" - " update=\"false\"/>\n" - "\n" - " <property name=\"color\"\n" - " type=\"eg.types.ColorUserType\"\n" - " not-null=\"true\"\n" - " update=\"false\"/>\n" - "\n" - " <property name=\"sex\"\n" - " not-null=\"true\"\n" - " update=\"false\"/>\n" - "\n" - " <property name=\"litterId\"\n" - " column=\"litterId\"\n" - " update=\"false\"/>\n" - "\n" - " <many-to-one name=\"mother\"\n" - " column=\"mother_id\"\n" - " update=\"false\"/>\n" - "\n" - " <set name=\"kittens\"\n" - " inverse=\"true\"\n" - " order-by=\"litter_id\">\n" - " <key column=\"mother_id\"/>\n" - " <one-to-many class=\"Cat\"/>\n" - " </set>\n" - "\n" - " <subclass name=\"DomesticCat\"\n" - " discriminator-value=\"D\">\n" - "\n" - " <property name=\"name\"\n" - " type=\"string\"/>\n" - "\n" - " </subclass>\n" - "\n" - " </class>\n" - "\n" - " <class name=\"Dog\">\n" - " \n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:53 #, no-c-format msgid "We will now discuss the content of the mapping document. We will only describe, however, the document elements and attributes that are used by Hibernate at runtime. The mapping document also contains some extra optional attributes and elements that affect the database schemas exported by the schema export tool (for example, the <literal> not-null</literal> attribute)." msgstr "" #. Tag: title -#: basic_mapping.xml:64 #, no-c-format msgid "Doctype" msgstr "" #. Tag: para -#: basic_mapping.xml:66 #, no-c-format msgid "All XML mappings should declare the doctype shown. The actual DTD can be found at the URL above, in the directory <literal>hibernate-x.x.x/src/org/hibernate </literal>, or in <literal>hibernate3.jar</literal>. Hibernate will always look for the DTD in its classpath first. If you experience lookups of the DTD using an Internet connection, check the DTD declaration against the contents of your classpath." msgstr "" #. Tag: title -#: basic_mapping.xml:76 #, no-c-format msgid "EntityResolver" msgstr "" #. Tag: para -#: basic_mapping.xml:77 #, no-c-format msgid "Hibernate will first attempt to resolve DTDs in its classpath. It does this is by registering a custom <literal>org.xml.sax.EntityResolver</literal> implementation with the SAXReader it uses to read in the xml files. This custom <literal>EntityResolver</literal> recognizes two different systemId namespaces:" msgstr "" #. Tag: para -#: basic_mapping.xml:85 #, no-c-format msgid "a <literal>hibernate namespace</literal> is recognized whenever the resolver encounters a systemId starting with <literal>http://hibernate.sourceforge.net/</literal>. The resolver attempts to resolve these entities via the classloader which loaded the Hibernate classes." msgstr "" #. Tag: para -#: basic_mapping.xml:94 #, no-c-format msgid "a <literal>user namespace</literal> is recognized whenever the resolver encounters a systemId using a <literal>classpath://</literal> URL protocol. The resolver will attempt to resolve these entities via (1) the current thread context classloader and (2) the classloader which loaded the Hibernate classes." msgstr "" #. Tag: para -#: basic_mapping.xml:103 #, no-c-format msgid "The following is an example of utilizing user namespacing:" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:106 -#, no-c-format -msgid "" - "<![CDATA[<?xml version=\"1.0\"?>\n" - "<!DOCTYPE hibernate-mapping PUBLIC\n" - " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" - " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\" [\n" - " <!ENTITY types SYSTEM \"classpath://your/domain/types.xml\">\n" - "]>\n" - "\n" - "<hibernate-mapping package=\"your.domain\">\n" - " <class name=\"MyEntity\">\n" - " <id name=\"id\" type=\"my-custom-id-type\">\n" - " ...\n" - " </id>\n" - " <class>\n" - " &types;\n" - "</hibernate-mapping>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:107 #, no-c-format -msgid "Where <literal>types.xml</literal> is a resource in the <literal>your.domain</literal> package and contains a custom <link linkend=\"mapping-types-custom\">typedef</link>." +msgid "Where <literal>types.xml</literal> is a resource in the <literal>your.domain</literal> package and contains a custom typedef (see <xref linkend=\"mapping-types-custom\" />)." msgstr "" #. Tag: title -#: basic_mapping.xml:115 #, no-c-format msgid "Hibernate-mapping" msgstr "" #. Tag: para -#: basic_mapping.xml:117 #, no-c-format msgid "This element has several optional attributes. The <literal>schema</literal> and <literal>catalog</literal> attributes specify that tables referred to in this mapping belong to the named schema and/or catalog. If they are specified, tablenames will be qualified by the given schema and catalog names. If they are missing, tablenames will be unqualified. The <literal>default-cascade</literal> attribute specifies what cascade style should be assumed for properties and collections that do not specify a <literal>cascade</literal> attribute. By default, the <literal>auto-import</literal> attribute allows you to use unqualified class names in the query language." msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:138 -#, no-c-format -msgid "" - "<![CDATA[<hibernate-mapping\n" - " schema=\"schemaName\"\n" - " catalog=\"catalogName\"\n" - " default-cascade=\"cascade_style\"\n" - " default-access=\"field|property|ClassName\"\n" - " default-lazy=\"true|false\"\n" - " auto-import=\"true|false\"\n" - " package=\"package.name\"\n" - " />]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:141 #, no-c-format msgid "<literal>schema</literal> (optional): the name of a database schema." msgstr "" #. Tag: para -#: basic_mapping.xml:146 #, no-c-format msgid "<literal>catalog</literal> (optional): the name of a database catalog." msgstr "" #. Tag: para -#: basic_mapping.xml:151 #, no-c-format msgid "<literal>default-cascade</literal> (optional - defaults to <literal>none</literal>): a default cascade style." msgstr "" #. Tag: para -#: basic_mapping.xml:157 #, no-c-format msgid "<literal>default-access</literal> (optional - defaults to <literal>property</literal>): the strategy Hibernate should use for accessing all properties. It can be a custom implementation of <literal>PropertyAccessor</literal>." msgstr "" #. Tag: para -#: basic_mapping.xml:164 #, no-c-format msgid "<literal>default-lazy</literal> (optional - defaults to <literal>true</literal>): the default value for unspecified <literal>lazy</literal> attributes of class and collection mappings." msgstr "" #. Tag: para -#: basic_mapping.xml:171 #, no-c-format msgid "<literal>auto-import</literal> (optional - defaults to <literal>true</literal>): specifies whether we can use unqualified class names of classes in this mapping in the query language." msgstr "" #. Tag: para -#: basic_mapping.xml:178 #, no-c-format msgid "<literal>package</literal> (optional): specifies a package prefix to use for unqualified class names in the mapping document." msgstr "" #. Tag: para -#: basic_mapping.xml:186 #, no-c-format msgid "If you have two persistent classes with the same unqualified name, you should set <literal>auto-import=\"false\"</literal>. An exception will result if you attempt to assign two classes to the same \"imported\" name." msgstr "" #. Tag: para -#: basic_mapping.xml:192 #, no-c-format msgid "The <literal>hibernate-mapping</literal> element allows you to nest several persistent <literal><class></literal> mappings, as shown above. It is, however, good practice (and expected by some tools) to map only a single persistent class, or a single class hierarchy, in one mapping file and name it after the persistent superclass. For example, <literal>Cat.hbm.xml</literal>, <literal>Dog.hbm.xml</literal>, or if using inheritance, <literal>Animal.hbm.xml</literal>." msgstr "" #. Tag: title -#: basic_mapping.xml:205 #, no-c-format msgid "Class" msgstr "" #. Tag: para -#: basic_mapping.xml:207 #, no-c-format msgid "You can declare a persistent class using the <literal>class</literal> element. For example:" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:235 -#, no-c-format -msgid "" - "<![CDATA[<class\n" - " name=\"ClassName\"\n" - " table=\"tableName\"\n" - " discriminator-value=\"discriminator_value\"\n" - " mutable=\"true|false\"\n" - " schema=\"owner\"\n" - " catalog=\"catalog\"\n" - " proxy=\"ProxyInterface\"\n" - " dynamic-update=\"true|false\"\n" - " dynamic-insert=\"true|false\"\n" - " select-before-update=\"true|false\"\n" - " polymorphism=\"implicit|explicit\"\n" - " where=\"arbitrary sql where condition\"\n" - " persister=\"PersisterClass\"\n" - " batch-size=\"N\"\n" - " optimistic-lock=\"none|version|dirty|all\"\n" - " lazy=\"true|false\"\n" - " entity-name=\"EntityName\"\n" - " check=\"arbitrary sql check condition\"\n" - " rowid=\"rowid\"\n" - " subselect=\"SQL expression\"\n" - " abstract=\"true|false\"\n" - " node=\"element-name\"\n" - "/>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:238 #, no-c-format msgid "<literal>name</literal> (optional): the fully qualified Java class name of the persistent class or interface. If this attribute is missing, it is assumed that the mapping is for a non-POJO entity." msgstr "" #. Tag: para -#: basic_mapping.xml:245 #, no-c-format msgid "<literal>table</literal> (optional - defaults to the unqualified class name): the name of its database table." msgstr "" #. Tag: para -#: basic_mapping.xml:251 #, no-c-format msgid "<literal>discriminator-value</literal> (optional - defaults to the class name): a value that distinguishes individual subclasses that is used for polymorphic behavior. Acceptable values include <literal>null</literal> and <literal>not null</literal>." msgstr "" #. Tag: para -#: basic_mapping.xml:258 #, no-c-format msgid "<literal>mutable</literal> (optional - defaults to <literal>true</literal>): specifies that instances of the class are (not) mutable." msgstr "" #. Tag: para -#: basic_mapping.xml:264 basic_mapping.xml:2231 #, no-c-format msgid "<literal>schema</literal> (optional): overrides the schema name specified by the root <literal><hibernate-mapping></literal> element." msgstr "" #. Tag: para -#: basic_mapping.xml:270 basic_mapping.xml:2237 #, no-c-format msgid "<literal>catalog</literal> (optional): overrides the catalog name specified by the root <literal><hibernate-mapping></literal> element." msgstr "" #. Tag: para -#: basic_mapping.xml:276 #, no-c-format msgid "<literal>proxy</literal> (optional): specifies an interface to use for lazy initializing proxies. You can specify the name of the class itself." msgstr "" #. Tag: para -#: basic_mapping.xml:282 #, no-c-format msgid "<literal>dynamic-update</literal> (optional - defaults to <literal>false</literal>): specifies that <literal>UPDATE</literal> SQL should be generated at runtime and can contain only those columns whose values have changed." msgstr "" #. Tag: para -#: basic_mapping.xml:289 #, no-c-format msgid "<literal>dynamic-insert</literal> (optional - defaults to <literal>false</literal>): specifies that <literal>INSERT</literal> SQL should be generated at runtime and contain only the columns whose values are not null." msgstr "" #. Tag: para -#: basic_mapping.xml:296 #, no-c-format msgid "<literal>select-before-update</literal> (optional - defaults to <literal>false</literal>): specifies that Hibernate should <emphasis>never</emphasis> perform an SQL <literal>UPDATE</literal> unless it is certain that an object is actually modified. Only when a transient object has been associated with a new session using <literal>update()</literal>, will Hibernate perform an extra SQL <literal>SELECT</literal> to determine if an <literal>UPDATE</literal> is actually required." msgstr "" #. Tag: para -#: basic_mapping.xml:306 #, no-c-format msgid "<literal>polymorphism</literal> (optional - defaults to <literal>implicit</literal>): determines whether implicit or explicit query polymorphism is used." msgstr "" #. Tag: para -#: basic_mapping.xml:312 #, no-c-format msgid "<literal>where</literal> (optional): specifies an arbitrary SQL <literal>WHERE</literal> condition to be used when retrieving objects of this class." msgstr "" #. Tag: para -#: basic_mapping.xml:318 #, no-c-format msgid "<literal>persister</literal> (optional): specifies a custom <literal>ClassPersister</literal>." msgstr "" #. Tag: para -#: basic_mapping.xml:323 #, no-c-format msgid "<literal>batch-size</literal> (optional - defaults to <literal>1</literal>): specifies a \"batch size\" for fetching instances of this class by identifier." msgstr "" #. Tag: para -#: basic_mapping.xml:329 #, no-c-format msgid "<literal>optimistic-lock</literal> (optional - defaults to <literal>version</literal>): determines the optimistic locking strategy." msgstr "" #. Tag: para -#: basic_mapping.xml:335 #, no-c-format msgid "<literal>lazy</literal> (optional): lazy fetching can be disabled by setting <literal>lazy=\"false\"</literal>." msgstr "" #. Tag: para -#: basic_mapping.xml:341 #, no-c-format -msgid "<literal>entity-name</literal> (optional - defaults to the class name): Hibernate3 allows a class to be mapped multiple times, potentially to different tables. It also allows entity mappings that are represented by Maps or XML at the Java level. In these cases, you should provide an explicit arbitrary name for the entity. See <xref linkend=\"persistent-classes-dynamicmodels\"/> and <xref linkend=\"xml\"/> for more information." +msgid "<literal>entity-name</literal> (optional - defaults to the class name): Hibernate3 allows a class to be mapped multiple times, potentially to different tables. It also allows entity mappings that are represented by Maps or XML at the Java level. In these cases, you should provide an explicit arbitrary name for the entity. See <xref linkend=\"persistent-classes-dynamicmodels\" /> and <xref linkend=\"xml\" /> for more information." msgstr "" #. Tag: para -#: basic_mapping.xml:351 #, no-c-format msgid "<literal>check</literal> (optional): an SQL expression used to generate a multi-row <emphasis>check</emphasis> constraint for automatic schema generation." msgstr "" #. Tag: para -#: basic_mapping.xml:357 #, no-c-format msgid "<literal>rowid</literal> (optional): Hibernate can use ROWIDs on databases. On Oracle, for example, Hibernate can use the <literal>rowid</literal> extra column for fast updates once this option has been set to <literal>rowid</literal>. A ROWID is an implementation detail and represents the physical location of a stored tuple." msgstr "" #. Tag: para -#: basic_mapping.xml:364 #, no-c-format msgid "<literal>subselect</literal> (optional): maps an immutable and read-only entity to a database subselect. This is useful if you want to have a view instead of a base table. See below for more information." msgstr "" #. Tag: para -#: basic_mapping.xml:371 #, no-c-format msgid "<literal>abstract</literal> (optional): is used to mark abstract superclasses in <literal><union-subclass></literal> hierarchies." msgstr "" #. Tag: para -#: basic_mapping.xml:379 #, no-c-format msgid "It is acceptable for the named persistent class to be an interface. You can declare implementing classes of that interface using the <literal><subclass></literal> element. You can persist any <emphasis>static</emphasis> inner class. Specify the class name using the standard form i.e. <literal>e.g.Foo$Bar</literal>." msgstr "" #. Tag: para -#: basic_mapping.xml:386 #, no-c-format msgid "Immutable classes, <literal>mutable=\"false\"</literal>, cannot be updated or deleted by the application. This allows Hibernate to make some minor performance optimizations." msgstr "" #. Tag: para -#: basic_mapping.xml:391 #, no-c-format msgid "The optional <literal>proxy</literal> attribute enables lazy initialization of persistent instances of the class. Hibernate will initially return CGLIB proxies that implement the named interface. The persistent object will load when a method of the proxy is invoked. See \"Initializing collections and proxies\" below." msgstr "" #. Tag: para -#: basic_mapping.xml:398 #, no-c-format msgid "<emphasis>Implicit</emphasis> polymorphism means that instances of the class will be returned by a query that names any superclass or implemented interface or class, and that instances of any subclass of the class will be returned by a query that names the class itself. <emphasis>Explicit</emphasis> polymorphism means that class instances will be returned only by queries that explicitly name that class. Queries that name the class will return only instances of subclasses mapped inside this <literal><class></literal> declaration as a <literal><subclass></literal> or <literal><joined-subclass></literal>. For most purposes, the default <literal>polymorphism=\"implicit\"</literal> is appropriate. Explicit polymorphism is useful when two different classes are mapped to the same table This allows a \"lightweight\" class that contains a subset of the table columns." msgstr "" #. Tag: para -#: basic_mapping.xml:410 #, no-c-format msgid "The <literal>persister</literal> attribute lets you customize the persistence strategy used for the class. You can, for example, specify your own subclass of <literal>org.hibernate.persister.EntityPersister</literal>, or you can even provide a completely new implementation of the interface <literal>org.hibernate.persister.ClassPersister</literal> that implements, for example, persistence via stored procedure calls, serialization to flat files or LDAP. See <literal>org.hibernate.test.CustomPersister</literal> for a simple example of \"persistence\" to a <literal>Hashtable</literal>." msgstr "" #. Tag: para -#: basic_mapping.xml:421 #, no-c-format msgid "The <literal>dynamic-update</literal> and <literal>dynamic-insert</literal> settings are not inherited by subclasses, so they can also be specified on the <literal><subclass></literal> or <literal><joined-subclass></literal> elements. Although these settings can increase performance in some cases, they can actually decrease performance in others." msgstr "" #. Tag: para -#: basic_mapping.xml:429 #, no-c-format msgid "Use of <literal>select-before-update</literal> will usually decrease performance. It is useful to prevent a database update trigger being called unnecessarily if you reattach a graph of detached instances to a <literal>Session</literal>." msgstr "" #. Tag: para -#: basic_mapping.xml:435 #, no-c-format msgid "If you enable <literal>dynamic-update</literal>, you will have a choice of optimistic locking strategies:" msgstr "" #. Tag: para -#: basic_mapping.xml:441 #, no-c-format msgid "<literal>version</literal>: check the version/timestamp columns" msgstr "" #. Tag: para -#: basic_mapping.xml:446 #, no-c-format msgid "<literal>all</literal>: check all columns" msgstr "" #. Tag: para -#: basic_mapping.xml:451 #, no-c-format msgid "<literal>dirty</literal>: check the changed columns, allowing some concurrent updates" msgstr "" #. Tag: para -#: basic_mapping.xml:456 #, no-c-format msgid "<literal>none</literal>: do not use optimistic locking" msgstr "" #. Tag: para -#: basic_mapping.xml:461 #, no-c-format msgid "It is <emphasis>strongly</emphasis> recommended that you use version/timestamp columns for optimistic locking with Hibernate. This strategy optimizes performance and correctly handles modifications made to detached instances (i.e. when <literal>Session.merge()</literal> is used)." msgstr "" #. Tag: para -#: basic_mapping.xml:468 #, no-c-format msgid "There is no difference between a view and a base table for a Hibernate mapping. This is transparent at the database level, although some DBMS do not support views properly, especially with updates. Sometimes you want to use a view, but you cannot create one in the database (i.e. with a legacy schema). In this case, you can map an immutable and read-only entity to a given SQL subselect expression:" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:476 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Summary\">\n" - " <subselect>\n" - " select item.name, max(bid.amount), count(*)\n" - " from item\n" - " join bid on bid.item_id = item.id\n" - " group by item.name\n" - " </subselect>\n" - " <synchronize table=\"item\"/>\n" - " <synchronize table=\"bid\"/>\n" - " <id name=\"name\"/>\n" - " ...\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:478 #, no-c-format msgid "Declare the tables to synchronize this entity with, ensuring that auto-flush happens correctly and that queries against the derived entity do not return stale data. The <literal><subselect></literal> is available both as an attribute and a nested mapping element." msgstr "" #. Tag: title -#: basic_mapping.xml:488 #, no-c-format -msgid "<title>id</title>" +msgid "id" msgstr "" #. Tag: para -#: basic_mapping.xml:490 #, no-c-format msgid "Mapped classes <emphasis>must</emphasis> declare the primary key column of the database table. Most classes will also have a JavaBeans-style property holding the unique identifier of an instance. The <literal><id></literal> element defines the mapping from that property to the primary key column." msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:505 -#, no-c-format -msgid "" - "<![CDATA[<id\n" - " name=\"propertyName\"\n" - " type=\"typename\"\n" - " column=\"column_name\"\n" - " unsaved-value=\"null|any|none|undefined|id_value\"\n" - " access=\"field|property|ClassName\">\n" - " node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" - "\n" - " <generator class=\"generatorClass\"/>\n" - "</id>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:508 #, no-c-format msgid "<literal>name</literal> (optional): the name of the identifier property." msgstr "" #. Tag: para -#: basic_mapping.xml:513 basic_mapping.xml:1351 #, no-c-format msgid "<literal>type</literal> (optional): a name that indicates the Hibernate type." msgstr "" #. Tag: para -#: basic_mapping.xml:518 #, no-c-format msgid "<literal>column</literal> (optional - defaults to the property name): the name of the primary key column." msgstr "" #. Tag: para -#: basic_mapping.xml:524 #, no-c-format msgid "<literal>unsaved-value</literal> (optional - defaults to a \"sensible\" value): an identifier property value that indicates an instance is newly instantiated (unsaved), distinguishing it from detached instances that were saved or loaded in a previous session." msgstr "" #. Tag: para -#: basic_mapping.xml:532 #, no-c-format msgid "<literal>access</literal> (optional - defaults to <literal>property</literal>): the strategy Hibernate should use for accessing the property value." msgstr "" #. Tag: para -#: basic_mapping.xml:540 #, no-c-format msgid "If the <literal>name</literal> attribute is missing, it is assumed that the class has no identifier property." msgstr "" #. Tag: para -#: basic_mapping.xml:545 #, no-c-format msgid "The <literal>unsaved-value</literal> attribute is almost never needed in Hibernate3." msgstr "" #. Tag: para -#: basic_mapping.xml:549 #, no-c-format msgid "There is an alternative <literal><composite-id></literal> declaration that allows access to legacy data with composite keys. Its use is strongly discouraged for anything else." msgstr "" #. Tag: title -#: basic_mapping.xml:555 #, no-c-format msgid "Generator" msgstr "" #. Tag: para -#: basic_mapping.xml:557 #, no-c-format msgid "The optional <literal><generator></literal> child element names a Java class used to generate unique identifiers for instances of the persistent class. If any parameters are required to configure or initialize the generator instance, they are passed using the <literal><param></literal> element." msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:564 -#, no-c-format -msgid "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"cat_id\">\n" - " <generator class=\"org.hibernate.id.TableHiLoGenerator\">\n" - " <param name=\"table\">uid_table</param>\n" - " <param name=\"column\">next_hi_value_column</param>\n" - " </generator>\n" - "</id>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:566 #, no-c-format msgid "All generators implement the interface <literal>org.hibernate.id.IdentifierGenerator</literal>. This is a very simple interface. Some applications can choose to provide their own specialized implementations, however, Hibernate provides a range of built-in implementations. The shortcut names for the built-in generators are as follows:" msgstr "" -#. Tag: literal -#: basic_mapping.xml:574 +#. Tag: term #, no-c-format -msgid "increment" +msgid "<literal>increment</literal>" msgstr "" #. Tag: para -#: basic_mapping.xml:576 #, no-c-format msgid "generates identifiers of type <literal>long</literal>, <literal>short</literal> or <literal>int</literal> that are unique only when no other process is inserting data into the same table. <emphasis>Do not use in a cluster.</emphasis>" msgstr "" -#. Tag: literal -#: basic_mapping.xml:585 +#. Tag: term #, no-c-format -msgid "identity" +msgid "<literal>identity</literal>" msgstr "" #. Tag: para -#: basic_mapping.xml:587 #, no-c-format msgid "supports identity columns in DB2, MySQL, MS SQL Server, Sybase and HypersonicSQL. The returned identifier is of type <literal>long</literal>, <literal>short</literal> or <literal>int</literal>." msgstr "" -#. Tag: literal -#: basic_mapping.xml:595 +#. Tag: term #, no-c-format -msgid "sequence" +msgid "<literal>sequence</literal>" msgstr "" #. Tag: para -#: basic_mapping.xml:597 #, no-c-format msgid "uses a sequence in DB2, PostgreSQL, Oracle, SAP DB, McKoi or a generator in Interbase. The returned identifier is of type <literal>long</literal>, <literal>short</literal> or <literal>int</literal>" msgstr "" -#. Tag: literal -#: basic_mapping.xml:605 +#. Tag: term #, no-c-format -msgid "hilo" +msgid "<literal>hilo</literal>" msgstr "" #. Tag: para -#: basic_mapping.xml:607 #, no-c-format msgid "uses a hi/lo algorithm to efficiently generate identifiers of type <literal>long</literal>, <literal>short</literal> or <literal>int</literal>, given a table and column (by default <literal>hibernate_unique_key</literal> and <literal>next_hi</literal> respectively) as a source of hi values. The hi/lo algorithm generates identifiers that are unique only for a particular database." msgstr "" -#. Tag: literal -#: basic_mapping.xml:617 +#. Tag: term #, no-c-format -msgid "seqhilo" +msgid "<literal>seqhilo</literal>" msgstr "" #. Tag: para -#: basic_mapping.xml:619 #, no-c-format msgid "uses a hi/lo algorithm to efficiently generate identifiers of type <literal>long</literal>, <literal>short</literal> or <literal>int</literal>, given a named database sequence." msgstr "" -#. Tag: literal -#: basic_mapping.xml:627 +#. Tag: term #, no-c-format -msgid "uuid" +msgid "<literal>uuid</literal>" msgstr "" #. Tag: para -#: basic_mapping.xml:629 #, no-c-format msgid "uses a 128-bit UUID algorithm to generate identifiers of type string that are unique within a network (the IP address is used). The UUID is encoded as a string of 32 hexadecimal digits in length." msgstr "" -#. Tag: literal -#: basic_mapping.xml:637 +#. Tag: term #, no-c-format -msgid "guid" +msgid "<literal>guid</literal>" msgstr "" #. Tag: para -#: basic_mapping.xml:639 #, no-c-format msgid "uses a database-generated GUID string on MS SQL Server and MySQL." msgstr "" -#. Tag: literal -#: basic_mapping.xml:645 +#. Tag: term #, no-c-format -msgid "native" +msgid "<literal>native</literal>" msgstr "" #. Tag: para -#: basic_mapping.xml:647 #, no-c-format msgid "selects <literal>identity</literal>, <literal>sequence</literal> or <literal>hilo</literal> depending upon the capabilities of the underlying database." msgstr "" -#. Tag: literal -#: basic_mapping.xml:655 +#. Tag: term #, no-c-format -msgid "assigned" +msgid "<literal>assigned</literal>" msgstr "" #. Tag: para -#: basic_mapping.xml:657 #, no-c-format msgid "lets the application assign an identifier to the object before <literal>save()</literal> is called. This is the default strategy if no <literal><generator></literal> element is specified." msgstr "" -#. Tag: literal -#: basic_mapping.xml:665 +#. Tag: term #, no-c-format -msgid "select" +msgid "<literal>select</literal>" msgstr "" #. Tag: para -#: basic_mapping.xml:667 #, no-c-format msgid "retrieves a primary key, assigned by a database trigger, by selecting the row by some unique key and retrieving the primary key value." msgstr "" -#. Tag: literal -#: basic_mapping.xml:674 +#. Tag: term #, no-c-format -msgid "foreign" +msgid "<literal>foreign</literal>" msgstr "" #. Tag: para -#: basic_mapping.xml:676 #, no-c-format msgid "uses the identifier of another associated object. It is usually used in conjunction with a <literal><one-to-one></literal> primary key association." msgstr "" -#. Tag: literal -#: basic_mapping.xml:683 +#. Tag: term #, no-c-format -msgid "sequence-identity" +msgid "<literal>sequence-identity</literal>" msgstr "" #. Tag: para -#: basic_mapping.xml:685 #, no-c-format msgid "a specialized sequence generation strategy that utilizes a database sequence for the actual value generation, but combines this with JDBC3 getGeneratedKeys to return the generated identifier value as part of the insert statement execution. This strategy is only supported on Oracle 10g drivers targeted for JDK 1.4. Comments on these insert statements are disabled due to a bug in the Oracle drivers." msgstr "" #. Tag: title -#: basic_mapping.xml:702 #, no-c-format msgid "Hi/lo algorithm" msgstr "" #. Tag: para -#: basic_mapping.xml:703 #, no-c-format msgid "The <literal>hilo</literal> and <literal>seqhilo</literal> generators provide two alternate implementations of the hi/lo algorithm. The first implementation requires a \"special\" database table to hold the next available \"hi\" value. Where supported, the second uses an Oracle-style sequence." msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:710 -#, no-c-format -msgid "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"cat_id\">\n" - " <generator class=\"hilo\">\n" - " <param name=\"table\">hi_value</param>\n" - " <param name=\"column\">next_value</param>\n" - " <param name=\"max_lo\">100</param>\n" - " </generator>\n" - "</id>]]>" -msgstr "" - -#. Tag: programlisting -#: basic_mapping.xml:712 -#, no-c-format -msgid "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"cat_id\">\n" - " <generator class=\"seqhilo\">\n" - " <param name=\"sequence\">hi_value</param>\n" - " <param name=\"max_lo\">100</param>\n" - " </generator>\n" - "</id>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:714 #, no-c-format msgid "Unfortunately, you cannot use <literal>hilo</literal> when supplying your own <literal>Connection</literal> to Hibernate. When Hibernate uses an application server datasource to obtain connections enlisted with JTA, you must configure the <literal>hibernate.transaction.manager_lookup_class</literal>." msgstr "" #. Tag: title -#: basic_mapping.xml:723 #, no-c-format msgid "UUID algorithm" msgstr "" #. Tag: para -#: basic_mapping.xml:724 #, no-c-format msgid "The UUID contains: IP address, startup time of the JVM that is accurate to a quarter second, system time and a counter value that is unique within the JVM. It is not possible to obtain a MAC address or memory address from Java code, so this is the best option without using JNI." msgstr "" #. Tag: title -#: basic_mapping.xml:733 #, no-c-format msgid "Identity columns and sequences" msgstr "" #. Tag: para -#: basic_mapping.xml:734 #, no-c-format msgid "For databases that support identity columns (DB2, MySQL, Sybase, MS SQL), you can use <literal>identity</literal> key generation. For databases that support sequences (DB2, Oracle, PostgreSQL, Interbase, McKoi, SAP DB) you can use <literal>sequence</literal> style key generation. Both of these strategies require two SQL queries to insert a new object. For example:" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:742 -#, no-c-format -msgid "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"person_id\">\n" - " <generator class=\"sequence\">\n" - " <param name=\"sequence\">person_id_sequence</param>\n" - " </generator>\n" - "</id>]]>" -msgstr "" - -#. Tag: programlisting -#: basic_mapping.xml:744 -#, no-c-format -msgid "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"person_id\" unsaved-value=\"0\">\n" - " <generator class=\"identity\"/>\n" - "</id>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:746 #, no-c-format msgid "For cross-platform development, the <literal>native</literal> strategy will, depending on the capabilities of the underlying database, choose from the <literal>identity</literal>, <literal>sequence</literal> and <literal>hilo</literal> strategies." msgstr "" #. Tag: title -#: basic_mapping.xml:754 #, no-c-format msgid "Assigned identifiers" msgstr "" #. Tag: para -#: basic_mapping.xml:755 #, no-c-format msgid "If you want the application to assign identifiers, as opposed to having Hibernate generate them, you can use the <literal>assigned</literal> generator. This special generator uses the identifier value already assigned to the object's identifier property. The generator is used when the primary key is a natural key instead of a surrogate key. This is the default behavior if you do not specify a <literal><generator></literal> element." msgstr "" #. Tag: para -#: basic_mapping.xml:764 #, no-c-format msgid "The <literal>assigned</literal> generator makes Hibernate use <literal>unsaved-value=\"undefined\"</literal>. This forces Hibernate to go to the database to determine if an instance is transient or detached, unless there is a version or timestamp property, or you define <literal>Interceptor.isUnsaved()</literal>." msgstr "" #. Tag: title -#: basic_mapping.xml:774 #, no-c-format msgid "Primary keys assigned by triggers" msgstr "" #. Tag: para -#: basic_mapping.xml:775 #, no-c-format msgid "Hibernate does not generate DDL with triggers. It is for legacy schemas only." msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:779 -#, no-c-format -msgid "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"person_id\">\n" - " <generator class=\"select\">\n" - " <param name=\"key\">socialSecurityNumber</param>\n" - " </generator>\n" - "</id>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:781 #, no-c-format msgid "In the above example, there is a unique valued property named <literal>socialSecurityNumber</literal>. It is defined by the class, as a natural key and a surrogate key named <literal>person_id</literal>, whose value is generated by a trigger." msgstr "" #. Tag: title -#: basic_mapping.xml:793 #, no-c-format msgid "Enhanced identifier generators" msgstr "" #. Tag: para -#: basic_mapping.xml:795 #, no-c-format msgid "Starting with release 3.2.3, there are 2 new generators which represent a re-thinking of 2 different aspects of identifier generation. The first aspect is database portability; the second is optimization Optimization means that you do not have to query the database for every request for a new identifier value. These two new generators are intended to take the place of some of the named generators described above, starting in 3.3.x. However, they are included in the current releases and can be referenced by FQN." msgstr "" #. Tag: para -#: basic_mapping.xml:803 #, no-c-format msgid "The first of these new generators is <literal>org.hibernate.id.enhanced.SequenceStyleGenerator</literal> which is intended, firstly, as a replacement for the <literal>sequence</literal> generator and, secondly, as a better portability generator than <literal>native</literal>. This is because <literal>native</literal> generally chooses between <literal>identity</literal> and <literal>sequence</literal> which have largely different semantics that can cause subtle issues in applications eyeing portability. <literal>org.hibernate.id.enhanced.SequenceStyleGenerator</literal>, however, achieves portability in a different manner. It chooses between a table or a sequence in the database to store its incrementing values, depending on the capabilities of the dialect being used. The difference between this and <literal>native</literal> is that table-based and sequence-based storage have the same exact semantic. In fact, sequences are exactly what Hibernate tries to emulate with! its table-based generators. This generator has a number of configuration parameters:" msgstr "" #. Tag: para -#: basic_mapping.xml:817 #, no-c-format msgid "<literal>sequence_name</literal> (optional, defaults to <literal>hibernate_sequence</literal>): the name of the sequence or table to be used." msgstr "" #. Tag: para -#: basic_mapping.xml:823 #, no-c-format msgid "<literal>initial_value</literal> (optional, defaults to <literal>1</literal>): the initial value to be retrieved from the sequence/table. In sequence creation terms, this is analogous to the clause typically named \"STARTS WITH\"." msgstr "" #. Tag: para -#: basic_mapping.xml:830 #, no-c-format msgid "<literal>increment_size</literal> (optional - defaults to <literal>1</literal>): the value by which subsequent calls to the sequence/table should differ. In sequence creation terms, this is analogous to the clause typically named \"INCREMENT BY\"." msgstr "" #. Tag: para -#: basic_mapping.xml:837 #, no-c-format msgid "<literal>force_table_use</literal> (optional - defaults to <literal>false</literal>): should we force the use of a table as the backing structure even though the dialect might support sequence?" msgstr "" #. Tag: para -#: basic_mapping.xml:844 #, no-c-format msgid "<literal>value_column</literal> (optional - defaults to <literal>next_val</literal>): only relevant for table structures, it is the name of the column on the table which is used to hold the value." msgstr "" #. Tag: para -#: basic_mapping.xml:851 #, no-c-format -msgid "<literal>optimizer</literal> (optional - defaults to <literal>none</literal>): See" +msgid "<literal>optimizer</literal> (optional - defaults to <literal>none</literal>): See <xref linkend=\"mapping-declaration-id-enhanced-optimizers\" />" msgstr "" #. Tag: para -#: basic_mapping.xml:858 #, no-c-format msgid "The second of these new generators is <literal>org.hibernate.id.enhanced.TableGenerator</literal>, which is intended, firstly, as a replacement for the <literal>table</literal> generator, even though it actually functions much more like <literal>org.hibernate.id.MultipleHiLoPerTableGenerator</literal>, and secondly, as a re-implementation of <literal>org.hibernate.id.MultipleHiLoPerTableGenerator</literal> that utilizes the notion of pluggable optimizers. Essentially this generator defines a table capable of holding a number of different increment values simultaneously by using multiple distinctly keyed rows. This generator has a number of configuration parameters:" msgstr "" #. Tag: para -#: basic_mapping.xml:868 #, no-c-format msgid "<literal>table_name</literal> (optional - defaults to <literal>hibernate_sequences</literal>): the name of the table to be used." msgstr "" #. Tag: para -#: basic_mapping.xml:874 #, no-c-format msgid "<literal>value_column_name</literal> (optional - defaults to <literal>next_val</literal>): the name of the column on the table that is used to hold the value." msgstr "" #. Tag: para -#: basic_mapping.xml:880 #, no-c-format msgid "<literal>segment_column_name</literal> (optional - defaults to <literal>sequence_name</literal>): the name of the column on the table that is used to hold the \"segment key\". This is the value which identifies which increment value to use." msgstr "" #. Tag: para -#: basic_mapping.xml:887 #, no-c-format msgid "<literal>segment_value</literal> (optional - defaults to <literal>default</literal>): The \"segment key\" value for the segment from which we want to pull increment values for this generator." msgstr "" #. Tag: para -#: basic_mapping.xml:894 #, no-c-format msgid "<literal>segment_value_length</literal> (optional - defaults to <literal>255</literal>): Used for schema generation; the column size to create this segment key column." msgstr "" #. Tag: para -#: basic_mapping.xml:900 #, no-c-format msgid "<literal>initial_value</literal> (optional - defaults to <literal>1</literal>): The initial value to be retrieved from the table." msgstr "" #. Tag: para -#: basic_mapping.xml:906 #, no-c-format msgid "<literal>increment_size</literal> (optional - defaults to <literal>1</literal>): The value by which subsequent calls to the table should differ." msgstr "" #. Tag: para -#: basic_mapping.xml:912 #, no-c-format -msgid "<literal>optimizer</literal> (optional - defaults to <literal></literal>): See" +msgid "<literal>optimizer</literal> (optional - defaults to <literal></literal>): See <xref linkend=\"mapping-declaration-id-enhanced-optimizers\" />" msgstr "" #. Tag: title -#: basic_mapping.xml:922 #, no-c-format msgid "Identifier generator optimization" msgstr "" #. Tag: para -#: basic_mapping.xml:923 #, no-c-format -msgid "For identifier generators that store values in the database, it is inefficient for them to hit the database on each and every call to generate a new identifier value. Instead, you can group a bunch of them in memory and only hit the database when you have exhausted your in-memory value group. This is the role of the pluggable optimizers. Currently only the two enhanced generators (<xref linkend=\"mapping-declaration-id-enhanced\"/> support this operation." +msgid "For identifier generators that store values in the database, it is inefficient for them to hit the database on each and every call to generate a new identifier value. Instead, you can group a bunch of them in memory and only hit the database when you have exhausted your in-memory value group. This is the role of the pluggable optimizers. Currently only the two enhanced generators (<xref linkend=\"mapping-declaration-id-enhanced\" /> support this operation." msgstr "" #. Tag: para -#: basic_mapping.xml:931 #, no-c-format msgid "<literal>none</literal> (generally this is the default if no optimizer was specified): this will not perform any optimizations and hit the database for each and every request." msgstr "" #. Tag: para -#: basic_mapping.xml:937 #, no-c-format msgid "<literal>hilo</literal>: applies a hi/lo algorithm around the database retrieved values. The values from the database for this optimizer are expected to be sequential. The values retrieved from the database structure for this optimizer indicates the \"group number\". The <literal>increment_size</literal> is multiplied by that value in memory to define a group \"hi value\"." msgstr "" #. Tag: para -#: basic_mapping.xml:946 #, no-c-format msgid "<literal>pooled</literal>: as with the case of <literal>hilo</literal>, this optimizer attempts to minimize the number of hits to the database. Here, however, we simply store the starting value for the \"next group\" into the database structure rather than a sequential value in combination with an in-memory grouping algorithm. Here, <literal>increment_size</literal> refers to the values coming from the database." msgstr "" #. Tag: title -#: basic_mapping.xml:959 #, no-c-format msgid "composite-id" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:961 -#, no-c-format -msgid "" - "<![CDATA[<composite-id\n" - " name=\"propertyName\"\n" - " class=\"ClassName\"\n" - " mapped=\"true|false\"\n" - " access=\"field|property|ClassName\">\n" - " node=\"element-name|.\"\n" - "\n" - " <key-property name=\"propertyName\" type=\"typename\" column=\"column_name\"/>\n" - " <key-many-to-one name=\"propertyName class=\"ClassName\" column=\"column_name\"/>\n" - " ......\n" - "</composite-id>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:963 #, no-c-format msgid "A table with a composite key can be mapped with multiple properties of the class as identifier properties. The <literal><composite-id></literal> element accepts <literal><key-property></literal> property mappings and <literal><key-many-to-one></literal> mappings as child elements." msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:970 -#, no-c-format -msgid "" - "<![CDATA[<composite-id>\n" - " <key-property name=\"medicareNumber\"/>\n" - " <key-property name=\"dependent\"/>\n" - "</composite-id>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:972 #, no-c-format msgid "The persistent class <emphasis>must</emphasis> override <literal>equals()</literal> and <literal>hashCode()</literal> to implement composite identifier equality. It must also implement <literal>Serializable</literal>." msgstr "" #. Tag: para -#: basic_mapping.xml:978 #, no-c-format msgid "Unfortunately, this approach means that a persistent object is its own identifier. There is no convenient \"handle\" other than the object itself. You must instantiate an instance of the persistent class itself and populate its identifier properties before you can <literal>load()</literal> the persistent state associated with a composite key. We call this approach an <emphasis>embedded</emphasis> composite identifier, and discourage it for serious applications." msgstr "" #. Tag: para -#: basic_mapping.xml:987 #, no-c-format msgid "A second approach is what we call a <emphasis>mapped</emphasis> composite identifier, where the identifier properties named inside the <literal><composite-id></literal> element are duplicated on both the persistent class and a separate identifier class." msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:993 -#, no-c-format -msgid "" - "<![CDATA[<composite-id class=\"MedicareId\" mapped=\"true\">\n" - " <key-property name=\"medicareNumber\"/>\n" - " <key-property name=\"dependent\"/>\n" - "</composite-id>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:995 #, no-c-format msgid "In this example, both the composite identifier class, <literal>MedicareId</literal>, and the entity class itself have properties named <literal>medicareNumber</literal> and <literal>dependent</literal>. The identifier class must override <literal>equals()</literal> and <literal>hashCode()</literal> and implement <literal>Serializable</literal>. The main disadvantage of this approach is code duplication." msgstr "" #. Tag: para -#: basic_mapping.xml:1004 #, no-c-format msgid "The following attributes are used to specify a mapped composite identifier:" msgstr "" #. Tag: para -#: basic_mapping.xml:1010 #, no-c-format msgid "<literal>mapped</literal> (optional - defaults to <literal>false</literal>): indicates that a mapped composite identifier is used, and that the contained property mappings refer to both the entity class and the composite identifier class." msgstr "" #. Tag: para -#: basic_mapping.xml:1018 #, no-c-format msgid "<literal>class</literal> (optional - but required for a mapped composite identifier): the class used as a composite identifier." msgstr "" #. Tag: para -#: basic_mapping.xml:1025 #, no-c-format -msgid "We will describe a third, even more convenient approach, where the composite identifier is implemented as a component class in <xref linkend=\"components-compositeid\"/>. The attributes described below apply only to this alternative approach:" +msgid "We will describe a third, even more convenient approach, where the composite identifier is implemented as a component class in <xref linkend=\"components-compositeid\" />. The attributes described below apply only to this alternative approach:" msgstr "" #. Tag: para -#: basic_mapping.xml:1033 #, no-c-format msgid "<literal>name</literal> (optional - required for this approach): a property of component type that holds the composite identifier. Please see chapter 9 for more information." msgstr "" #. Tag: para -#: basic_mapping.xml:1039 basic_mapping.xml:1260 basic_mapping.xml:1372 basic_mapping.xml:1561 basic_mapping.xml:1735 basic_mapping.xml:1905 basic_mapping.xml:2484 #, no-c-format msgid "<literal>access</literal> (optional - defaults to <literal>property</literal>): the strategy Hibernate uses for accessing the property value." msgstr "" #. Tag: para -#: basic_mapping.xml:1045 #, no-c-format msgid "<literal>class</literal> (optional - defaults to the property type determined by reflection): the component class used as a composite identifier. Please see the next section for more information." msgstr "" #. Tag: para -#: basic_mapping.xml:1052 #, no-c-format msgid "The third approach, an <emphasis>identifier component</emphasis>, is recommended for almost all applications." msgstr "" #. Tag: title -#: basic_mapping.xml:1060 #, no-c-format msgid "Discriminator" msgstr "" #. Tag: para -#: basic_mapping.xml:1062 #, no-c-format msgid "The <literal><discriminator></literal> element is required for polymorphic persistence using the table-per-class-hierarchy mapping strategy. It declares a discriminator column of the table. The discriminator column contains marker values that tell the persistence layer what subclass to instantiate for a particular row. A restricted set of types can be used: <literal>string</literal>, <literal>character</literal>, <literal>integer</literal>, <literal>byte</literal>, <literal>short</literal>, <literal>boolean</literal>, <literal>yes_no</literal>, <literal>true_false</literal>." msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:1080 -#, no-c-format -msgid "" - "<![CDATA[<discriminator\n" - " column=\"discriminator_column\"\n" - " type=\"discriminator_type\"\n" - " force=\"true|false\"\n" - " insert=\"true|false\"\n" - " formula=\"arbitrary sql expression\"\n" - "/>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:1083 #, no-c-format msgid "<literal>column</literal> (optional - defaults to <literal>class</literal>): the name of the discriminator column." msgstr "" #. Tag: para -#: basic_mapping.xml:1089 #, no-c-format msgid "<literal>type</literal> (optional - defaults to <literal>string</literal>): a name that indicates the Hibernate type" msgstr "" #. Tag: para -#: basic_mapping.xml:1095 #, no-c-format msgid "<literal>force</literal> (optional - defaults to <literal>false</literal>): \"forces\" Hibernate to specify the allowed discriminator values, even when retrieving all instances of the root class." msgstr "" #. Tag: para -#: basic_mapping.xml:1102 #, no-c-format msgid "<literal>insert</literal> (optional - defaults to <literal>true</literal>): set this to <literal>false</literal> if your discriminator column is also part of a mapped composite identifier. It tells Hibernate not to include the column in SQL <literal>INSERTs</literal>." msgstr "" #. Tag: para -#: basic_mapping.xml:1110 #, no-c-format msgid "<literal>formula</literal> (optional): an arbitrary SQL expression that is executed when a type has to be evaluated. It allows content-based discrimination." msgstr "" #. Tag: para -#: basic_mapping.xml:1118 #, no-c-format msgid "Actual values of the discriminator column are specified by the <literal>discriminator-value</literal> attribute of the <literal><class></literal> and <literal><subclass></literal> elements." msgstr "" #. Tag: para -#: basic_mapping.xml:1124 #, no-c-format msgid "The <literal>force</literal> attribute is only useful if the table contains rows with \"extra\" discriminator values that are not mapped to a persistent class. This will not usually be the case." msgstr "" #. Tag: para -#: basic_mapping.xml:1130 #, no-c-format msgid "The <literal>formula</literal> attribute allows you to declare an arbitrary SQL expression that will be used to evaluate the type of a row. For example:" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:1135 -#, no-c-format -msgid "" - "<![CDATA[<discriminator\n" - " formula=\"case when CLASS_TYPE in ('a', 'b', 'c') then 0 else 1 end\"\n" - " type=\"integer\"/>]]>" -msgstr "" - #. Tag: title -#: basic_mapping.xml:1140 #, no-c-format msgid "Version (optional)" msgstr "" #. Tag: para -#: basic_mapping.xml:1142 #, no-c-format msgid "The <literal><version></literal> element is optional and indicates that the table contains versioned data. This is particularly useful if you plan to use <emphasis>long transactions</emphasis>. See below for more information:" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:1158 -#, no-c-format -msgid "" - "<![CDATA[<version\n" - " column=\"version_column\"\n" - " name=\"propertyName\"\n" - " type=\"typename\"\n" - " access=\"field|property|ClassName\"\n" - " unsaved-value=\"null|negative|undefined\"\n" - " generated=\"never|always\"\n" - " insert=\"true|false\"\n" - " node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" - "/>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:1161 #, no-c-format msgid "<literal>column</literal> (optional - defaults to the property name): the name of the column holding the version number." msgstr "" #. Tag: para -#: basic_mapping.xml:1167 #, no-c-format msgid "<literal>name</literal>: the name of a property of the persistent class." msgstr "" #. Tag: para -#: basic_mapping.xml:1172 #, no-c-format msgid "<literal>type</literal> (optional - defaults to <literal>integer</literal>): the type of the version number." msgstr "" #. Tag: para -#: basic_mapping.xml:1178 #, no-c-format msgid "<literal>access</literal> (optional - defaults to <literal>property</literal>): the strategy Hibernate uses to access the property value." msgstr "" #. Tag: para -#: basic_mapping.xml:1184 #, no-c-format msgid "<literal>unsaved-value</literal> (optional - defaults to <literal>undefined</literal>): a version property value that indicates that an instance is newly instantiated (unsaved), distinguishing it from detached instances that were saved or loaded in a previous session. <literal>Undefined</literal> specifies that the identifier property value should be used." msgstr "" #. Tag: para -#: basic_mapping.xml:1193 #, no-c-format -msgid "<literal>generated</literal> (optional - defaults to <literal>never</literal>): specifies that this version property value is generated by the database. See the discussion of <link linkend=\"mapping-generated\">generated properties</link> for more information." +msgid "<literal>generated</literal> (optional - defaults to <literal>never</literal>): specifies that this version property value is generated by the database. See the discussion of generated properties for more information (<xref linkend=\"mapping-generated\" />)." msgstr "" #. Tag: para -#: basic_mapping.xml:1200 #, no-c-format msgid "<literal>insert</literal> (optional - defaults to <literal>true</literal>): specifies whether the version column should be included in SQL insert statements. It can be set to <literal>false</literal> if the database column is defined with a default value of <literal>0</literal>." msgstr "" #. Tag: para -#: basic_mapping.xml:1210 #, no-c-format msgid "Version numbers can be of Hibernate type <literal>long</literal>, <literal>integer</literal>, <literal>short</literal>, <literal>timestamp</literal> or <literal>calendar</literal>." msgstr "" #. Tag: para -#: basic_mapping.xml:1215 #, no-c-format msgid "A version or timestamp property should never be null for a detached instance. Hibernate will detect any instance with a null version or timestamp as transient, irrespective of what other <literal>unsaved-value</literal> strategies are specified. <emphasis>Declaring a nullable version or timestamp property is an easy way to avoid problems with transitive reattachment in Hibernate. It is especially useful for people using assigned identifiers or composite keys</emphasis>." msgstr "" #. Tag: title -#: basic_mapping.xml:1226 #, no-c-format msgid "Timestamp (optional)" msgstr "" #. Tag: para -#: basic_mapping.xml:1228 #, no-c-format msgid "The optional <literal><timestamp></literal> element indicates that the table contains timestamped data. This provides an alternative to versioning. Timestamps are a less safe implementation of optimistic locking. However, sometimes the application might use the timestamps in other ways." msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:1244 -#, no-c-format -msgid "" - "<![CDATA[<timestamp\n" - " column=\"timestamp_column\"\n" - " name=\"propertyName\"\n" - " access=\"field|property|ClassName\"\n" - " unsaved-value=\"null|undefined\"\n" - " source=\"vm|db\"\n" - " generated=\"never|always\"\n" - " node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" - "/>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:1247 #, no-c-format msgid "<literal>column</literal> (optional - defaults to the property name): the name of a column holding the timestamp." msgstr "" #. Tag: para -#: basic_mapping.xml:1253 #, no-c-format msgid "<literal>name</literal>: the name of a JavaBeans style property of Java type <literal>Date</literal> or <literal>Timestamp</literal> of the persistent class." msgstr "" #. Tag: para -#: basic_mapping.xml:1266 #, no-c-format msgid "<literal>unsaved-value</literal> (optional - defaults to <literal>null</literal>): a version property value that indicates that an instance is newly instantiated (unsaved), distinguishing it from detached instances that were saved or loaded in a previous session. <literal>Undefined</literal> specifies that the identifier property value should be used." msgstr "" #. Tag: para -#: basic_mapping.xml:1275 #, no-c-format msgid "<literal>source</literal> (optional - defaults to <literal>vm</literal>): Where should Hibernate retrieve the timestamp value from? From the database, or from the current JVM? Database-based timestamps incur an overhead because Hibernate must hit the database in order to determine the \"next value\". It is safer to use in clustered environments. Not all <literal>Dialects</literal> are known to support the retrieval of the database's current timestamp. Others may also be unsafe for usage in locking due to lack of precision (Oracle 8, for example)." msgstr "" #. Tag: para -#: basic_mapping.xml:1287 #, no-c-format -msgid "<literal>generated</literal> (optional - defaults to <literal>never</literal>): specifies that this timestamp property value is actually generated by the database. See the discussion of <link linkend=\"mapping-generated\">generated properties</link> for more information." +msgid "<literal>generated</literal> (optional - defaults to <literal>never</literal>): specifies that this timestamp property value is actually generated by the database. See the discussion of generated properties for more information (<xref linkend=\"mapping-generated\" />)." msgstr "" #. Tag: title -#: basic_mapping.xml:1298 basic_mapping.xml:2890 #, no-c-format msgid "Note" msgstr "" #. Tag: para -#: basic_mapping.xml:1299 #, no-c-format msgid "<literal><Timestamp></literal> is equivalent to <literal><version type=\"timestamp\"></literal>. And <literal><timestamp source=\"db\"></literal> is equivalent to <literal><version type=\"dbtimestamp\"></literal>" msgstr "" #. Tag: title -#: basic_mapping.xml:1311 #, no-c-format msgid "Property" msgstr "" #. Tag: para -#: basic_mapping.xml:1313 #, no-c-format msgid "The <literal><property></literal> element declares a persistent JavaBean style property of the class." msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:1335 -#, no-c-format -msgid "" - "<![CDATA[<property\n" - " name=\"propertyName\"\n" - " column=\"column_name\"\n" - " type=\"typename\"\n" - " update=\"true|false\"\n" - " insert=\"true|false\"\n" - " formula=\"arbitrary SQL expression\"\n" - " access=\"field|property|ClassName\"\n" - " lazy=\"true|false\"\n" - " unique=\"true|false\"\n" - " not-null=\"true|false\"\n" - " optimistic-lock=\"true|false\"\n" - " generated=\"never|insert|always\"\n" - " node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" - " index=\"index_name\"\n" - " unique_key=\"unique_key_id\"\n" - " length=\"L\"\n" - " precision=\"P\"\n" - " scale=\"S\"\n" - "/>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:1338 #, no-c-format msgid "<literal>name</literal>: the name of the property, with an initial lowercase letter." msgstr "" #. Tag: para -#: basic_mapping.xml:1344 #, no-c-format msgid "<literal>column</literal> (optional - defaults to the property name): the name of the mapped database table column. This can also be specified by nested <literal><column></literal> element(s)." msgstr "" #. Tag: para -#: basic_mapping.xml:1356 #, no-c-format msgid "<literal>update, insert</literal> (optional - defaults to <literal>true</literal>): specifies that the mapped columns should be included in SQL <literal>UPDATE</literal> and/or <literal>INSERT</literal> statements. Setting both to <literal>false</literal> allows a pure \"derived\" property whose value is initialized from some other property that maps to the same column(s), or by a trigger or other application." msgstr "" #. Tag: para -#: basic_mapping.xml:1365 #, no-c-format msgid "<literal>formula</literal> (optional): an SQL expression that defines the value for a <emphasis>computed</emphasis> property. Computed properties do not have a column mapping of their own." msgstr "" #. Tag: para -#: basic_mapping.xml:1378 #, no-c-format msgid "<literal>lazy</literal> (optional - defaults to <literal>false</literal>): specifies that this property should be fetched lazily when the instance variable is first accessed. It requires build-time bytecode instrumentation." msgstr "" #. Tag: para -#: basic_mapping.xml:1385 #, no-c-format msgid "<literal>unique</literal> (optional): enables the DDL generation of a unique constraint for the columns. Also, allow this to be the target of a <literal>property-ref</literal>." msgstr "" #. Tag: para -#: basic_mapping.xml:1392 #, no-c-format msgid "<literal>not-null</literal> (optional): enables the DDL generation of a nullability constraint for the columns." msgstr "" #. Tag: para -#: basic_mapping.xml:1398 basic_mapping.xml:1581 #, no-c-format msgid "<literal>optimistic-lock</literal> (optional - defaults to <literal>true</literal>): specifies that updates to this property do or do not require acquisition of the optimistic lock. In other words, it determines if a version increment should occur when this property is dirty." msgstr "" #. Tag: para -#: basic_mapping.xml:1406 #, no-c-format -msgid "<literal>generated</literal> (optional - defaults to <literal>never</literal>): specifies that this property value is actually generated by the database. See the discussion of <link linkend=\"mapping-generated\">generated properties</link> for more information." +msgid "<literal>generated</literal> (optional - defaults to <literal>never</literal>): specifies that this property value is actually generated by the database. See the discussion of generated properties for more information (<xref linkend=\"mapping-generated\" />)." msgstr "" #. Tag: para -#: basic_mapping.xml:1415 #, no-c-format msgid "<emphasis>typename</emphasis> could be:" msgstr "" #. Tag: para -#: basic_mapping.xml:1421 #, no-c-format msgid "The name of a Hibernate basic type: <literal>integer, string, character, date, timestamp, float, binary, serializable, object, blob</literal> etc." msgstr "" #. Tag: para -#: basic_mapping.xml:1427 #, no-c-format msgid "The name of a Java class with a default basic type: <literal>int, float, char, java.lang.String, java.util.Date, java.lang.Integer, java.sql.Clob</literal> etc." msgstr "" #. Tag: para -#: basic_mapping.xml:1433 #, no-c-format msgid "The name of a serializable Java class." msgstr "" #. Tag: para -#: basic_mapping.xml:1438 #, no-c-format msgid "The class name of a custom type: <literal>com.illflow.type.MyCustomType</literal> etc." msgstr "" #. Tag: para -#: basic_mapping.xml:1444 #, no-c-format msgid "If you do not specify a type, Hibernate will use reflection upon the named property and guess the correct Hibernate type. Hibernate will attempt to interpret the name of the return class of the property getter using, in order, rules 2, 3, and 4. In certain cases you will need the <literal>type</literal> attribute. For example, to distinguish between <literal>Hibernate.DATE</literal> and <literal>Hibernate.TIMESTAMP</literal>, or to specify a custom type." msgstr "" #. Tag: para -#: basic_mapping.xml:1454 #, no-c-format msgid "The <literal>access</literal> attribute allows you to control how Hibernate accesses the property at runtime. By default, Hibernate will call the property get/set pair. If you specify <literal>access=\"field\"</literal>, Hibernate will bypass the get/set pair and access the field directly using reflection. You can specify your own strategy for property access by naming a class that implements the interface <literal>org.hibernate.property.PropertyAccessor</literal>." msgstr "" #. Tag: para -#: basic_mapping.xml:1463 #, no-c-format msgid "A powerful feature is derived properties. These properties are by definition read-only. The property value is computed at load time. You declare the computation as an SQL expression. This then translates to a <literal>SELECT</literal> clause subquery in the SQL query that loads an instance:" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:1470 -#, no-c-format -msgid "" - "<![CDATA[\n" - "<property name=\"totalPrice\"\n" - " formula=\"( SELECT SUM (li.quantity*p.price) FROM LineItem li, Product p\n" - " WHERE li.productId = p.productId\n" - " AND li.customerId = customerId\n" - " AND li.orderNumber = orderNumber )\"/>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:1472 #, no-c-format msgid "You can reference the entity table by not declaring an alias on a particular column. This would be <literal>customerId</literal> in the given example. You can also use the nested <literal><formula></literal> mapping element if you do not want to use the attribute." msgstr "" #. Tag: title -#: basic_mapping.xml:1482 #, no-c-format msgid "Many-to-one" msgstr "" #. Tag: para -#: basic_mapping.xml:1484 #, no-c-format msgid "An ordinary association to another persistent class is declared using a <literal>many-to-one</literal> element. The relational model is a many-to-one association; a foreign key in one table is referencing the primary key column(s) of the target table." msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:1512 -#, no-c-format -msgid "" - "<![CDATA[<many-to-one\n" - " name=\"propertyName\"\n" - " column=\"column_name\"\n" - " class=\"ClassName\"\n" - " cascade=\"cascade_style\"\n" - " fetch=\"join|select\"\n" - " update=\"true|false\"\n" - " insert=\"true|false\"\n" - " property-ref=\"propertyNameFromAssociatedClass\"\n" - " access=\"field|property|ClassName\"\n" - " unique=\"true|false\"\n" - " not-null=\"true|false\"\n" - " optimistic-lock=\"true|false\"\n" - " lazy=\"proxy|no-proxy|false\"\n" - " not-found=\"ignore|exception\"\n" - " entity-name=\"EntityName\"\n" - " formula=\"arbitrary SQL expression\"\n" - " node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" - " embed-xml=\"true|false\"\n" - " index=\"index_name\"\n" - " unique_key=\"unique_key_id\"\n" - " foreign-key=\"foreign_key_name\"\n" - "/>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:1515 basic_mapping.xml:1696 basic_mapping.xml:1882 #, no-c-format msgid "<literal>name</literal>: the name of the property." msgstr "" #. Tag: para -#: basic_mapping.xml:1520 basic_mapping.xml:2311 #, no-c-format msgid "<literal>column</literal> (optional): the name of the foreign key column. This can also be specified by nested <literal><column></literal> element(s)." msgstr "" #. Tag: para -#: basic_mapping.xml:1527 basic_mapping.xml:1701 #, no-c-format msgid "<literal>class</literal> (optional - defaults to the property type determined by reflection): the name of the associated class." msgstr "" #. Tag: para -#: basic_mapping.xml:1533 basic_mapping.xml:1707 #, no-c-format msgid "<literal>cascade</literal> (optional): specifies which operations should be cascaded from the parent object to the associated object." msgstr "" #. Tag: para -#: basic_mapping.xml:1539 basic_mapping.xml:1722 #, no-c-format msgid "<literal>fetch</literal> (optional - defaults to <literal>select</literal>): chooses between outer-join fetching or sequential select fetching." msgstr "" #. Tag: para -#: basic_mapping.xml:1545 #, no-c-format msgid "<literal>update, insert</literal> (optional - defaults to <literal>true</literal>): specifies that the mapped columns should be included in SQL <literal>UPDATE</literal> and/or <literal>INSERT</literal> statements. Setting both to <literal>false</literal> allows a pure \"derived\" association whose value is initialized from another property that maps to the same column(s), or by a trigger or other application." msgstr "" #. Tag: para -#: basic_mapping.xml:1554 #, no-c-format msgid "<literal>property-ref</literal> (optional): the name of a property of the associated class that is joined to this foreign key. If not specified, the primary key of the associated class is used." msgstr "" #. Tag: para -#: basic_mapping.xml:1567 #, no-c-format msgid "<literal>unique</literal> (optional): enables the DDL generation of a unique constraint for the foreign-key column. By allowing this to be the target of a <literal>property-ref</literal>, you can make the association multiplicity one-to-one." msgstr "" #. Tag: para -#: basic_mapping.xml:1575 #, no-c-format msgid "<literal>not-null</literal> (optional): enables the DDL generation of a nullability constraint for the foreign key columns." msgstr "" #. Tag: para -#: basic_mapping.xml:1589 #, no-c-format msgid "<literal>lazy</literal> (optional - defaults to <literal>proxy</literal>): by default, single point associations are proxied. <literal>lazy=\"no-proxy\"</literal> specifies that the property should be fetched lazily when the instance variable is first accessed. This requires build-time bytecode instrumentation. <literal>lazy=\"false\"</literal> specifies that the association will always be eagerly fetched." msgstr "" #. Tag: para -#: basic_mapping.xml:1599 #, no-c-format msgid "<literal>not-found</literal> (optional - defaults to <literal>exception</literal>): specifies how foreign keys that reference missing rows will be handled. <literal>ignore</literal> will treat a missing row as a null association." msgstr "" #. Tag: para -#: basic_mapping.xml:1606 basic_mapping.xml:1760 #, no-c-format msgid "<literal>entity-name</literal> (optional): the entity name of the associated class." msgstr "" #. Tag: para -#: basic_mapping.xml:1611 #, no-c-format msgid "<literal>formula</literal> (optional): an SQL expression that defines the value for a <emphasis>computed</emphasis> foreign key." msgstr "" #. Tag: para -#: basic_mapping.xml:1619 #, no-c-format -msgid "Setting a value of the <literal>cascade</literal> attribute to any meaningful value other than <literal>none</literal> will propagate certain operations to the associated object. The meaningful values are divided into three categories. First, basic operations, which include: <literal>persist, merge, delete, save-update, evict, replicate, lock and refresh</literal>; second, special values: <literal>delete-orphan</literal>; and third,<literal>all</literal> comma-separated combinations of operation names: <literal>cascade=\"persist,merge,evict\"</literal> or <literal>cascade=\"all,delete-orphan\"</literal>. See <xref linkend=\"objectstate-transitive\"/> for a full explanation. Note that single valued, many-to-one and one-to-one, associations do not support orphan delete." +msgid "Setting a value of the <literal>cascade</literal> attribute to any meaningful value other than <literal>none</literal> will propagate certain operations to the associated object. The meaningful values are divided into three categories. First, basic operations, which include: <literal>persist, merge, delete, save-update, evict, replicate, lock and refresh</literal>; second, special values: <literal>delete-orphan</literal>; and third,<literal>all</literal> comma-separated combinations of operation names: <literal>cascade=\"persist,merge,evict\"</literal> or <literal>cascade=\"all,delete-orphan\"</literal>. See <xref linkend=\"objectstate-transitive\" /> for a full explanation. Note that single valued, many-to-one and one-to-one, associations do not support orphan delete." msgstr "" #. Tag: para -#: basic_mapping.xml:1632 #, no-c-format msgid "Here is an example of a typical <literal>many-to-one</literal> declaration:" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:1636 -#, no-c-format -msgid "<![CDATA[<many-to-one name=\"product\" class=\"Product\" column=\"PRODUCT_ID\"/>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:1638 #, no-c-format msgid "The <literal>property-ref</literal> attribute should only be used for mapping legacy data where a foreign key refers to a unique key of the associated table other than the primary key. This is a complicated and confusing relational model. For example, if the <literal>Product</literal> class had a unique serial number that is not the primary key. The <literal>unique</literal> attribute controls Hibernate's DDL generation with the SchemaExport tool." msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:1647 -#, no-c-format -msgid "<![CDATA[<property name=\"serialNumber\" unique=\"true\" type=\"string\" column=\"SERIAL_NUMBER\"/>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:1649 #, no-c-format msgid "Then the mapping for <literal>OrderItem</literal> might use:" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:1653 -#, no-c-format -msgid "<![CDATA[<many-to-one name=\"product\" property-ref=\"serialNumber\" column=\"PRODUCT_SERIAL_NUMBER\"/>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:1655 #, no-c-format msgid "This is not encouraged, however." msgstr "" #. Tag: para -#: basic_mapping.xml:1659 #, no-c-format msgid "If the referenced unique key comprises multiple properties of the associated entity, you should map the referenced properties inside a named <literal><properties></literal> element." msgstr "" #. Tag: para -#: basic_mapping.xml:1664 #, no-c-format msgid "If the referenced unique key is the property of a component, you can specify a property path:" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:1668 -#, no-c-format -msgid "<![CDATA[<many-to-one name=\"owner\" property-ref=\"identity.ssn\" column=\"OWNER_SSN\"/>]]>" -msgstr "" - #. Tag: title -#: basic_mapping.xml:1673 #, no-c-format msgid "One-to-one" msgstr "" #. Tag: para -#: basic_mapping.xml:1675 #, no-c-format msgid "A one-to-one association to another persistent class is declared using a <literal>one-to-one</literal> element." msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:1693 -#, no-c-format -msgid "" - "<![CDATA[<one-to-one\n" - " name=\"propertyName\"\n" - " class=\"ClassName\"\n" - " cascade=\"cascade_style\"\n" - " constrained=\"true|false\"\n" - " fetch=\"join|select\"\n" - " property-ref=\"propertyNameFromAssociatedClass\"\n" - " access=\"field|property|ClassName\"\n" - " formula=\"any SQL expression\"\n" - " lazy=\"proxy|no-proxy|false\"\n" - " entity-name=\"EntityName\"\n" - " node=\"element-name|@attribute-name|element/(a)attribute|.\"\n" - " embed-xml=\"true|false\"\n" - " foreign-key=\"foreign_key_name\"\n" - "/>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:1713 #, no-c-format msgid "<literal>constrained</literal> (optional): specifies that a foreign key constraint on the primary key of the mapped table and references the table of the associated class. This option affects the order in which <literal>save()</literal> and <literal>delete()</literal> are cascaded, and determines whether the association can be proxied. It is also used by the schema export tool." msgstr "" #. Tag: para -#: basic_mapping.xml:1728 #, no-c-format msgid "<literal>property-ref</literal> (optional): the name of a property of the associated class that is joined to the primary key of this class. If not specified, the primary key of the associated class is used." msgstr "" #. Tag: para -#: basic_mapping.xml:1741 #, no-c-format msgid "<literal>formula</literal> (optional): almost all one-to-one associations map to the primary key of the owning entity. If this is not the case, you can specify another column, columns or expression to join on using an SQL formula. See <literal>org.hibernate.test.onetooneformula</literal> for an example." msgstr "" #. Tag: para -#: basic_mapping.xml:1749 #, no-c-format msgid "<literal>lazy</literal> (optional - defaults to <literal>proxy</literal>): by default, single point associations are proxied. <literal>lazy=\"no-proxy\"</literal> specifies that the property should be fetched lazily when the instance variable is first accessed. It requires build-time bytecode instrumentation. <literal>lazy=\"false\"</literal> specifies that the association will always be eagerly fetched. <emphasis>Note that if <literal>constrained=\"false\"</literal>, proxying is impossible and Hibernate will eagerly fetch the association</emphasis>." msgstr "" #. Tag: para -#: basic_mapping.xml:1767 #, no-c-format msgid "There are two varieties of one-to-one associations:" msgstr "" #. Tag: para -#: basic_mapping.xml:1771 #, no-c-format msgid "primary key associations" msgstr "" #. Tag: para -#: basic_mapping.xml:1774 #, no-c-format msgid "unique foreign key associations" msgstr "" #. Tag: para -#: basic_mapping.xml:1779 #, no-c-format msgid "Primary key associations do not need an extra table column. If two rows are related by the association, then the two table rows share the same primary key value. To relate two objects by a primary key association, ensure that they are assigned the same identifier value." msgstr "" #. Tag: para -#: basic_mapping.xml:1786 #, no-c-format msgid "For a primary key association, add the following mappings to <literal>Employee</literal> and <literal>Person</literal> respectively:" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:1791 -#, no-c-format -msgid "<![CDATA[<one-to-one name=\"person\" class=\"Person\"/>]]>" -msgstr "" - -#. Tag: programlisting -#: basic_mapping.xml:1792 -#, no-c-format -msgid "<![CDATA[<one-to-one name=\"employee\" class=\"Employee\" constrained=\"true\"/>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:1794 #, no-c-format msgid "Ensure that the primary keys of the related rows in the PERSON and EMPLOYEE tables are equal. You use a special Hibernate identifier generation strategy called <literal>foreign</literal>:" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:1800 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"person\" table=\"PERSON\">\n" - " <id name=\"id\" column=\"PERSON_ID\">\n" - " <generator class=\"foreign\">\n" - " <param name=\"property\">employee</param>\n" - " </generator>\n" - " </id>\n" - " ...\n" - " <one-to-one name=\"employee\"\n" - " class=\"Employee\"\n" - " constrained=\"true\"/>\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:1802 #, no-c-format msgid "A newly saved instance of <literal>Person</literal> is assigned the same primary key value as the <literal>Employee</literal> instance referred with the <literal>employee</literal> property of that <literal>Person</literal>." msgstr "" #. Tag: para -#: basic_mapping.xml:1808 #, no-c-format msgid "Alternatively, a foreign key with a unique constraint, from <literal>Employee</literal> to <literal>Person</literal>, can be expressed as:" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:1813 -#, no-c-format -msgid "<![CDATA[<many-to-one name=\"person\" class=\"Person\" column=\"PERSON_ID\" unique=\"true\"/>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:1815 #, no-c-format msgid "This association can be made bidirectional by adding the following to the <literal>Person</literal> mapping:" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:1820 -#, no-c-format -msgid "<![CDATA[<one-to-one name=\"employee\" class=\"Employee\" property-ref=\"person\"/>]]>" -msgstr "" - #. Tag: title -#: basic_mapping.xml:1825 #, no-c-format msgid "Natural-id" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:1827 -#, no-c-format -msgid "" - "<![CDATA[<natural-id mutable=\"true|false\"/>\n" - " <property ... />\n" - " <many-to-one ... />\n" - " ......\n" - "</natural-id>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:1829 #, no-c-format msgid "Although we recommend the use of surrogate keys as primary keys, you should try to identify natural keys for all entities. A natural key is a property or combination of properties that is unique and non-null. It is also immutable. Map the properties of the natural key inside the <literal><natural-id></literal> element. Hibernate will generate the necessary unique key and nullability constraints and, as a result, your mapping will be more self-documenting." msgstr "" #. Tag: para -#: basic_mapping.xml:1838 #, no-c-format msgid "It is recommended that you implement <literal>equals()</literal> and <literal>hashCode()</literal> to compare the natural key properties of the entity." msgstr "" #. Tag: para -#: basic_mapping.xml:1843 #, no-c-format msgid "This mapping is not intended for use with entities that have natural primary keys." msgstr "" #. Tag: para -#: basic_mapping.xml:1849 #, no-c-format msgid "<literal>mutable</literal> (optional - defaults to <literal>false</literal>): by default, natural identifier properties are assumed to be immutable (constant)." msgstr "" #. Tag: title -#: basic_mapping.xml:1859 #, no-c-format msgid "Component and dynamic-component" msgstr "" #. Tag: para -#: basic_mapping.xml:1861 #, no-c-format msgid "The <literal><component></literal> element maps properties of a child object to columns of the table of a parent class. Components can, in turn, declare their own properties, components or collections. See the \"Component\" examples below:" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:1879 -#, no-c-format -msgid "" - "<![CDATA[<component\n" - " name=\"propertyName\"\n" - " class=\"className\"\n" - " insert=\"true|false\"\n" - " update=\"true|false\"\n" - " access=\"field|property|ClassName\"\n" - " lazy=\"true|false\"\n" - " optimistic-lock=\"true|false\"\n" - " unique=\"true|false\"\n" - " node=\"element-name|.\"\n" - ">\n" - "\n" - " <property ...../>\n" - " <many-to-one .... />\n" - " ........\n" - "</component>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:1887 #, no-c-format msgid "<literal>class</literal> (optional - defaults to the property type determined by reflection): the name of the component (child) class." msgstr "" #. Tag: para -#: basic_mapping.xml:1893 basic_mapping.xml:1982 #, no-c-format msgid "<literal>insert</literal>: do the mapped columns appear in SQL <literal>INSERTs</literal>?" msgstr "" #. Tag: para -#: basic_mapping.xml:1899 basic_mapping.xml:1988 #, no-c-format msgid "<literal>update</literal>: do the mapped columns appear in SQL <literal>UPDATEs</literal>?" msgstr "" #. Tag: para -#: basic_mapping.xml:1911 #, no-c-format msgid "<literal>lazy</literal> (optional - defaults to <literal>false</literal>): specifies that this component should be fetched lazily when the instance variable is first accessed. It requires build-time bytecode instrumentation." msgstr "" #. Tag: para -#: basic_mapping.xml:1918 #, no-c-format msgid "<literal>optimistic-lock</literal> (optional - defaults to <literal>true</literal>): specifies that updates to this component either do or do not require acquisition of the optimistic lock. It determines if a version increment should occur when this property is dirty." msgstr "" #. Tag: para -#: basic_mapping.xml:1926 basic_mapping.xml:2002 #, no-c-format msgid "<literal>unique</literal> (optional - defaults to <literal>false</literal>): specifies that a unique constraint exists upon all mapped columns of the component." msgstr "" #. Tag: para -#: basic_mapping.xml:1935 #, no-c-format msgid "The child <literal><property></literal> tags map properties of the child class to table columns." msgstr "" #. Tag: para -#: basic_mapping.xml:1940 #, no-c-format msgid "The <literal><component></literal> element allows a <literal><parent></literal> subelement that maps a property of the component class as a reference back to the containing entity." msgstr "" #. Tag: para -#: basic_mapping.xml:1946 #, no-c-format -msgid "The <literal><dynamic-component></literal> element allows a <literal>Map</literal> to be mapped as a component, where the property names refer to keys of the map. See <xref linkend=\"components-dynamic\"/> for more information." +msgid "The <literal><dynamic-component></literal> element allows a <literal>Map</literal> to be mapped as a component, where the property names refer to keys of the map. See <xref linkend=\"components-dynamic\" /> for more information." msgstr "" #. Tag: title -#: basic_mapping.xml:1955 #, no-c-format msgid "Properties" msgstr "" #. Tag: para -#: basic_mapping.xml:1957 #, no-c-format msgid "The <literal><properties></literal> element allows the definition of a named, logical grouping of the properties of a class. The most important use of the construct is that it allows a combination of properties to be the target of a <literal>property-ref</literal>. It is also a convenient way to define a multi-column unique constraint. For example:" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:1973 -#, no-c-format -msgid "" - "<![CDATA[<properties\n" - " name=\"logicalName\"\n" - " insert=\"true|false\"\n" - " update=\"true|false\"\n" - " optimistic-lock=\"true|false\"\n" - " unique=\"true|false\"\n" - ">\n" - "\n" - " <property ...../>\n" - " <many-to-one .... />\n" - " ........\n" - "</properties>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:1976 #, no-c-format msgid "<literal>name</literal>: the logical name of the grouping. It is <emphasis>not</emphasis> an actual property name." msgstr "" #. Tag: para -#: basic_mapping.xml:1994 #, no-c-format msgid "<literal>optimistic-lock</literal> (optional - defaults to <literal>true</literal>): specifies that updates to these properties either do or do not require acquisition of the optimistic lock. It determines if a version increment should occur when these properties are dirty." msgstr "" #. Tag: para -#: basic_mapping.xml:2011 #, no-c-format msgid "For example, if we have the following <literal><properties></literal> mapping:" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:2015 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"personNumber\"/>\n" - "\n" - " ...\n" - " <properties name=\"name\"\n" - " unique=\"true\" update=\"false\">\n" - " <property name=\"firstName\"/>\n" - " <property name=\"initial\"/>\n" - " <property name=\"lastName\"/>\n" - " </properties>\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:2017 #, no-c-format msgid "You might have some legacy data association that refers to this unique key of the <literal>Person</literal> table, instead of to the primary key:" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:2022 -#, no-c-format -msgid "" - "<![CDATA[<many-to-one name=\"person\"\n" - " class=\"Person\" property-ref=\"name\">\n" - " <column name=\"firstName\"/>\n" - " <column name=\"initial\"/>\n" - " <column name=\"lastName\"/>\n" - "</many-to-one>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:2024 #, no-c-format msgid "The use of this outside the context of mapping legacy data is not recommended." msgstr "" #. Tag: title -#: basic_mapping.xml:2032 #, no-c-format msgid "Subclass" msgstr "" #. Tag: para -#: basic_mapping.xml:2034 #, no-c-format msgid "Polymorphic persistence requires the declaration of each subclass of the root persistent class. For the table-per-class-hierarchy mapping strategy, the <literal><subclass></literal> declaration is used. For example:" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:2047 -#, no-c-format -msgid "" - "<![CDATA[<subclass\n" - " name=\"ClassName\"\n" - " discriminator-value=\"discriminator_value\"\n" - " proxy=\"ProxyInterface\"\n" - " lazy=\"true|false\"\n" - " dynamic-update=\"true|false\"\n" - " dynamic-insert=\"true|false\"\n" - " entity-name=\"EntityName\"\n" - " node=\"element-name\"\n" - " extends=\"SuperclassName\">\n" - "\n" - " <property .... />\n" - " .....\n" - "</subclass>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:2050 basic_mapping.xml:2108 basic_mapping.xml:2171 #, no-c-format msgid "<literal>name</literal>: the fully qualified class name of the subclass." msgstr "" #. Tag: para -#: basic_mapping.xml:2055 #, no-c-format msgid "<literal>discriminator-value</literal> (optional - defaults to the class name): a value that distinguishes individual subclasses." msgstr "" #. Tag: para -#: basic_mapping.xml:2061 #, no-c-format msgid "<literal>proxy</literal> (optional): specifies a class or interface used for lazy initializing proxies." msgstr "" #. Tag: para -#: basic_mapping.xml:2067 #, no-c-format msgid "<literal>lazy</literal> (optional - defaults to <literal>true</literal>): setting <literal>lazy=\"false\"</literal> disables the use of lazy fetching." msgstr "" #. Tag: para -#: basic_mapping.xml:2075 #, no-c-format msgid "Each subclass declares its own persistent properties and subclasses. <literal><version></literal> and <literal><id></literal> properties are assumed to be inherited from the root class. Each subclass in a hierarchy must define a unique <literal>discriminator-value</literal>. If this is not specified, the fully qualified Java class name is used." msgstr "" #. Tag: para -#: basic_mapping.xml:2083 basic_mapping.xml:2141 basic_mapping.xml:2199 #, no-c-format -msgid "For information about inheritance mappings see <xref linkend=\"inheritance\"/>." +msgid "For information about inheritance mappings see <xref linkend=\"inheritance\" />." msgstr "" #. Tag: title -#: basic_mapping.xml:2090 #, no-c-format msgid "Joined-subclass" msgstr "" #. Tag: para -#: basic_mapping.xml:2092 #, no-c-format msgid "Each subclass can also be mapped to its own table. This is called the table-per-subclass mapping strategy. An inherited state is retrieved by joining with the table of the superclass. To do this you use the <literal><joined-subclass></literal> element. For example:" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:2105 -#, no-c-format -msgid "" - "<![CDATA[<joined-subclass\n" - " name=\"ClassName\"\n" - " table=\"tablename\"\n" - " proxy=\"ProxyInterface\"\n" - " lazy=\"true|false\"\n" - " dynamic-update=\"true|false\"\n" - " dynamic-insert=\"true|false\"\n" - " schema=\"schema\"\n" - " catalog=\"catalog\"\n" - " extends=\"SuperclassName\"\n" - " persister=\"ClassName\"\n" - " subselect=\"SQL expression\"\n" - " entity-name=\"EntityName\"\n" - " node=\"element-name\">\n" - "\n" - " <key .... >\n" - "\n" - " <property .... />\n" - " .....\n" - "</joined-subclass>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:2113 basic_mapping.xml:2176 #, no-c-format msgid "<literal>table</literal>: the name of the subclass table." msgstr "" #. Tag: para -#: basic_mapping.xml:2118 basic_mapping.xml:2181 #, no-c-format msgid "<literal>proxy</literal> (optional): specifies a class or interface to use for lazy initializing proxies." msgstr "" #. Tag: para -#: basic_mapping.xml:2124 basic_mapping.xml:2187 #, no-c-format msgid "<literal>lazy</literal> (optional, defaults to <literal>true</literal>): setting <literal>lazy=\"false\"</literal> disables the use of lazy fetching." msgstr "" #. Tag: para -#: basic_mapping.xml:2132 #, no-c-format msgid "A discriminator column is not required for this mapping strategy. Each subclass must, however, declare a table column holding the object identifier using the <literal><key></literal> element. The mapping at the start of the chapter would then be re-written as:" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:2139 -#, no-c-format -msgid "" - "<![CDATA[<?xml version=\"1.0\"?>\n" - "<!DOCTYPE hibernate-mapping PUBLIC\n" - " \"-//Hibernate/Hibernate Mapping DTD//EN\"\n" - " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" - "\n" - "<hibernate-mapping package=\"eg\">\n" - "\n" - " <class name=\"Cat\" table=\"CATS\">\n" - " <id name=\"id\" column=\"uid\" type=\"long\">\n" - " <generator class=\"hilo\"/>\n" - " </id>\n" - " <property name=\"birthdate\" type=\"date\"/>\n" - " <property name=\"color\" not-null=\"true\"/>\n" - " <property name=\"sex\" not-null=\"true\"/>\n" - " <property name=\"weight\"/>\n" - " <many-to-one name=\"mate\"/>\n" - " <set name=\"kittens\">\n" - " <key column=\"MOTHER\"/>\n" - " <one-to-many class=\"Cat\"/>\n" - " </set>\n" - " <joined-subclass name=\"DomesticCat\" table=\"DOMESTIC_CATS\">\n" - " <key column=\"CAT\"/>\n" - " <property name=\"name\" type=\"string\"/>\n" - " </joined-subclass>\n" - " </class>\n" - "\n" - " <class name=\"eg.Dog\">\n" - " \n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" -msgstr "" - #. Tag: title -#: basic_mapping.xml:2148 #, no-c-format msgid "Union-subclass" msgstr "" #. Tag: para -#: basic_mapping.xml:2150 #, no-c-format msgid "A third option is to map only the concrete classes of an inheritance hierarchy to tables. This is called the table-per-concrete-class strategy. Each table defines all persistent states of the class, including the inherited state. In Hibernate, it is not necessary to explicitly map such inheritance hierarchies. You can map each class with a separate <literal><class></literal> declaration. However, if you wish use polymorphic associations (e.g. an association to the superclass of your hierarchy), you need to use the <literal><union-subclass></literal> mapping. For example:" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:2168 -#, no-c-format -msgid "" - "<![CDATA[<union-subclass\n" - " name=\"ClassName\"\n" - " table=\"tablename\"\n" - " proxy=\"ProxyInterface\"\n" - " lazy=\"true|false\"\n" - " dynamic-update=\"true|false\"\n" - " dynamic-insert=\"true|false\"\n" - " schema=\"schema\"\n" - " catalog=\"catalog\"\n" - " extends=\"SuperclassName\"\n" - " abstract=\"true|false\"\n" - " persister=\"ClassName\"\n" - " subselect=\"SQL expression\"\n" - " entity-name=\"EntityName\"\n" - " node=\"element-name\">\n" - "\n" - " <property .... />\n" - " .....\n" - "</union-subclass>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:2195 #, no-c-format msgid "No discriminator column or key column is required for this mapping strategy." msgstr "" #. Tag: title -#: basic_mapping.xml:2206 #, no-c-format msgid "Join" msgstr "" #. Tag: para -#: basic_mapping.xml:2208 #, no-c-format msgid "Using the <literal><join></literal> element, it is possible to map properties of one class to several tables that have a one-to-one relationship. For example:" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:2222 -#, no-c-format -msgid "" - "<![CDATA[<join\n" - " table=\"tablename\"\n" - " schema=\"owner\"\n" - " catalog=\"catalog\"\n" - " fetch=\"join|select\"\n" - " inverse=\"true|false\"\n" - " optional=\"true|false\">\n" - "\n" - " <key ... />\n" - "\n" - " <property ... />\n" - " ...\n" - "</join>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:2226 #, no-c-format msgid "<literal>table</literal>: the name of the joined table." msgstr "" #. Tag: para -#: basic_mapping.xml:2243 #, no-c-format msgid "<literal>fetch</literal> (optional - defaults to <literal>join</literal>): if set to <literal>join</literal>, the default, Hibernate will use an inner join to retrieve a <literal><join></literal> defined by a class or its superclasses. It will use an outer join for a <literal><join></literal> defined by a subclass. If set to <literal>select</literal> then Hibernate will use a sequential select for a <literal><join></literal> defined on a subclass. This will be issued only if a row represents an instance of the subclass. Inner joins will still be used to retrieve a <literal><join></literal> defined by the class and its superclasses." msgstr "" #. Tag: para -#: basic_mapping.xml:2256 #, no-c-format msgid "<literal>inverse</literal> (optional - defaults to <literal>false</literal>): if enabled, Hibernate will not insert or update the properties defined by this join." msgstr "" #. Tag: para -#: basic_mapping.xml:2263 #, no-c-format msgid "<literal>optional</literal> (optional - defaults to <literal>false</literal>): if enabled, Hibernate will insert a row only if the properties defined by this join are non-null. It will always use an outer join to retrieve the properties." msgstr "" #. Tag: para -#: basic_mapping.xml:2272 #, no-c-format msgid "For example, address information for a person can be mapped to a separate table while preserving value type semantics for all properties:" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:2277 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Person\"\n" - " table=\"PERSON\">\n" - "\n" - " <id name=\"id\" column=\"PERSON_ID\">...</id>\n" - "\n" - " <join table=\"ADDRESS\">\n" - " <key column=\"ADDRESS_ID\"/>\n" - " <property name=\"address\"/>\n" - " <property name=\"zip\"/>\n" - " <property name=\"country\"/>\n" - " </join>\n" - " ...]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:2279 #, no-c-format msgid "This feature is often only useful for legacy data models. We recommend fewer tables than classes and a fine-grained domain model. However, it is useful for switching between inheritance mapping strategies in a single hierarchy, as explained later." msgstr "" #. Tag: title -#: basic_mapping.xml:2289 #, no-c-format -msgid "<title>Key</title>" +msgid "Key" msgstr "" #. Tag: para -#: basic_mapping.xml:2291 #, no-c-format msgid "The <literal><key></literal> element has featured a few times within this guide. It appears anywhere the parent mapping element defines a join to a new table that references the primary key of the original table. It also defines the foreign key in the joined table:" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:2307 -#, no-c-format -msgid "" - "<![CDATA[<key\n" - " column=\"columnname\"\n" - " on-delete=\"noaction|cascade\"\n" - " property-ref=\"propertyName\"\n" - " not-null=\"true|false\"\n" - " update=\"true|false\"\n" - " unique=\"true|false\"\n" - "/>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:2318 #, no-c-format msgid "<literal>on-delete</literal> (optional - defaults to <literal>noaction</literal>): specifies whether the foreign key constraint has database-level cascade delete enabled." msgstr "" #. Tag: para -#: basic_mapping.xml:2325 #, no-c-format msgid "<literal>property-ref</literal> (optional): specifies that the foreign key refers to columns that are not the primary key of the original table. It is provided for legacy data." msgstr "" #. Tag: para -#: basic_mapping.xml:2332 #, no-c-format msgid "<literal>not-null</literal> (optional): specifies that the foreign key columns are not nullable. This is implied whenever the foreign key is also part of the primary key." msgstr "" #. Tag: para -#: basic_mapping.xml:2339 #, no-c-format msgid "<literal>update</literal> (optional): specifies that the foreign key should never be updated. This is implied whenever the foreign key is also part of the primary key." msgstr "" #. Tag: para -#: basic_mapping.xml:2346 #, no-c-format msgid "<literal>unique</literal> (optional): specifies that the foreign key should have a unique constraint. This is implied whenever the foreign key is also the primary key." msgstr "" #. Tag: para -#: basic_mapping.xml:2354 #, no-c-format msgid "For systems where delete performance is important, we recommend that all keys should be defined <literal>on-delete=\"cascade\"</literal>. Hibernate uses a database-level <literal>ON CASCADE DELETE</literal> constraint, instead of many individual <literal>DELETE</literal> statements. Be aware that this feature bypasses Hibernate's usual optimistic locking strategy for versioned data." msgstr "" #. Tag: para -#: basic_mapping.xml:2362 #, no-c-format msgid "The <literal>not-null</literal> and <literal>update</literal> attributes are useful when mapping a unidirectional one-to-many association. If you map a unidirectional one-to-many association to a non-nullable foreign key, you <emphasis>must</emphasis> declare the key column using <literal><key not-null=\"true\"></literal>." msgstr "" #. Tag: title -#: basic_mapping.xml:2372 #, no-c-format msgid "Column and formula elements" msgstr "" #. Tag: para -#: basic_mapping.xml:2373 #, no-c-format msgid "Mapping elements which accept a <literal>column</literal> attribute will alternatively accept a <literal><column></literal> subelement. Likewise, <literal><formula></literal> is an alternative to the <literal>formula</literal> attribute. For example:" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:2379 -#, no-c-format -msgid "" - "<![CDATA[<column\n" - " name=\"column_name\"\n" - " length=\"N\"\n" - " precision=\"N\"\n" - " scale=\"N\"\n" - " not-null=\"true|false\"\n" - " unique=\"true|false\"\n" - " unique-key=\"multicolumn_unique_key_name\"\n" - " index=\"index_name\"\n" - " sql-type=\"sql_type_name\"\n" - " check=\"SQL expression\"\n" - " default=\"SQL expression\"/>]]>" -msgstr "" - -#. Tag: programlisting -#: basic_mapping.xml:2381 -#, no-c-format -msgid "<![CDATA[<formula>SQL expression</formula>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:2383 #, no-c-format msgid "<literal>column</literal> and <literal>formula</literal> attributes can even be combined within the same property or association mapping to express, for example, exotic join conditions." msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:2389 -#, no-c-format -msgid "" - "<![CDATA[<many-to-one name=\"homeAddress\" class=\"Address\"\n" - " insert=\"false\" update=\"false\">\n" - " <column name=\"person_id\" not-null=\"true\" length=\"10\"/>\n" - " <formula>'MAILING'</formula>\n" - "</many-to-one>]]>" -msgstr "" - #. Tag: title -#: basic_mapping.xml:2394 #, no-c-format msgid "Import" msgstr "" #. Tag: para -#: basic_mapping.xml:2396 #, no-c-format msgid "If your application has two persistent classes with the same name, and you do not want to specify the fully qualified package name in Hibernate queries, classes can be \"imported\" explicitly, rather than relying upon <literal>auto-import=\"true\"</literal>. You can also import classes and interfaces that are not explicitly mapped:" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:2403 -#, no-c-format -msgid "<![CDATA[<import class=\"java.lang.Object\" rename=\"Universe\"/>]]>" -msgstr "" - -#. Tag: programlisting -#: basic_mapping.xml:2410 -#, no-c-format -msgid "" - "<![CDATA[<import\n" - " class=\"ClassName\"\n" - " rename=\"ShortName\"\n" - "/>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:2413 #, no-c-format msgid "<literal>class</literal>: the fully qualified class name of any Java class." msgstr "" #. Tag: para -#: basic_mapping.xml:2418 #, no-c-format msgid "<literal>rename</literal> (optional - defaults to the unqualified class name): a name that can be used in the query language." msgstr "" #. Tag: title -#: basic_mapping.xml:2429 #, no-c-format -msgid "<title>Any</title>" +msgid "Any" msgstr "" #. Tag: para -#: basic_mapping.xml:2431 #, no-c-format msgid "There is one more type of property mapping. The <literal><any></literal> mapping element defines a polymorphic association to classes from multiple tables. This type of mapping requires more than one column. The first column contains the type of the associated entity. The remaining columns contain the identifier. It is impossible to specify a foreign key constraint for this kind of association. This is not the usual way of mapping polymorphic associations and you should use this only in special cases. For example, for audit logs, user session data, etc." msgstr "" #. Tag: para -#: basic_mapping.xml:2441 #, no-c-format msgid "The <literal>meta-type</literal> attribute allows the application to specify a custom type that maps database column values to persistent classes that have identifier properties of the type specified by <literal>id-type</literal>. You must specify the mapping from values of the meta-type to class names." msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:2448 -#, no-c-format -msgid "" - "<![CDATA[<any name=\"being\" id-type=\"long\" meta-type=\"string\">\n" - " <meta-value value=\"TBL_ANIMAL\" class=\"Animal\"/>\n" - " <meta-value value=\"TBL_HUMAN\" class=\"Human\"/>\n" - " <meta-value value=\"TBL_ALIEN\" class=\"Alien\"/>\n" - " <column name=\"table_name\"/>\n" - " <column name=\"id\"/>\n" - "</any>]]>" -msgstr "" - -#. Tag: programlisting -#: basic_mapping.xml:2459 -#, no-c-format -msgid "" - "<![CDATA[<any\n" - " name=\"propertyName\"\n" - " id-type=\"idtypename\"\n" - " meta-type=\"metatypename\"\n" - " cascade=\"cascade_style\"\n" - " access=\"field|property|ClassName\"\n" - " optimistic-lock=\"true|false\"\n" - ">\n" - " <meta-value ... />\n" - " <meta-value ... />\n" - " .....\n" - " <column .... />\n" - " <column .... />\n" - " .....\n" - "</any>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:2462 #, no-c-format msgid "<literal>name</literal>: the property name." msgstr "" #. Tag: para -#: basic_mapping.xml:2467 #, no-c-format msgid "<literal>id-type</literal>: the identifier type." msgstr "" #. Tag: para -#: basic_mapping.xml:2472 #, no-c-format msgid "<literal>meta-type</literal> (optional - defaults to <literal>string</literal>): any type that is allowed for a discriminator mapping." msgstr "" #. Tag: para -#: basic_mapping.xml:2478 #, no-c-format msgid "<literal>cascade</literal> (optional- defaults to <literal>none</literal>): the cascade style." msgstr "" #. Tag: para -#: basic_mapping.xml:2490 #, no-c-format msgid "<literal>optimistic-lock</literal> (optional - defaults to <literal>true</literal>): specifies that updates to this property either do or do not require acquisition of the optimistic lock. It defines whether a version increment should occur if this property is dirty." msgstr "" #. Tag: title -#: basic_mapping.xml:2505 #, no-c-format msgid "Hibernate types" msgstr "" #. Tag: title -#: basic_mapping.xml:2508 #, no-c-format msgid "Entities and values" msgstr "" #. Tag: para -#: basic_mapping.xml:2510 #, no-c-format msgid "In relation to the persistence service, Java language-level objects are classified into two groups:" msgstr "" #. Tag: para -#: basic_mapping.xml:2515 #, no-c-format msgid "An <emphasis>entity</emphasis> exists independently of any other objects holding references to the entity. Contrast this with the usual Java model, where an unreferenced object is garbage collected. Entities must be explicitly saved and deleted. Saves and deletions, however, can be <emphasis>cascaded</emphasis> from a parent entity to its children. This is different from the ODMG model of object persistence by reachability and corresponds more closely to how application objects are usually used in large systems. Entities support circular and shared references. They can also be versioned." msgstr "" #. Tag: para -#: basic_mapping.xml:2526 #, no-c-format msgid "An entity's persistent state consists of references to other entities and instances of <emphasis>value</emphasis> types. Values are primitives: collections (not what is inside a collection), components and certain immutable objects. Unlike entities, values in particular collections and components, <emphasis>are</emphasis> persisted and deleted by reachability. Since value objects and primitives are persisted and deleted along with their containing entity, they cannot be independently versioned. Values have no independent identity, so they cannot be shared by two entities or collections." msgstr "" #. Tag: para -#: basic_mapping.xml:2537 #, no-c-format msgid "Until now, we have been using the term \"persistent class\" to refer to entities. We will continue to do that. Not all user-defined classes with a persistent state, however, are entities. A <emphasis>component</emphasis> is a user-defined class with value semantics. A Java property of type <literal>java.lang.String</literal> also has value semantics. Given this definition, all types (classes) provided by the JDK have value type semantics in Java, while user-defined types can be mapped with entity or value type semantics. This decision is up to the application developer. An entity class in a domain model will normally have shared references to a single instance of that class, while composition or aggregation usually translates to a value type." msgstr "" #. Tag: para -#: basic_mapping.xml:2551 #, no-c-format msgid "We will revisit both concepts throughout this reference guide." msgstr "" #. Tag: para -#: basic_mapping.xml:2555 #, no-c-format msgid "The challenge is to map the Java type system, and the developers' definition of entities and value types, to the SQL/database type system. The bridge between both systems is provided by Hibernate. For entities, <literal><class></literal>, <literal><subclass></literal> and so on are used. For value types we use <literal><property></literal>, <literal><component></literal>etc., that usually have a <literal>type</literal> attribute. The value of this attribute is the name of a Hibernate <emphasis>mapping type</emphasis>. Hibernate provides a range of mappings for standard JDK value types out of the box. You can write your own mapping types and implement your own custom conversion strategies." msgstr "" #. Tag: para -#: basic_mapping.xml:2568 #, no-c-format msgid "With the exception of collections, all built-in Hibernate types support null semantics." msgstr "" #. Tag: title -#: basic_mapping.xml:2575 #, no-c-format msgid "Basic value types" msgstr "" #. Tag: para -#: basic_mapping.xml:2577 #, no-c-format msgid "The built-in <emphasis>basic mapping types</emphasis> can be roughly categorized into the following:" msgstr "" -#. Tag: literal -#: basic_mapping.xml:2582 +#. Tag: term #, no-c-format -msgid "integer, long, short, float, double, character, byte, boolean, yes_no, true_false" +msgid "<literal>integer, long, short, float, double, character, byte, boolean, yes_no, true_false</literal>" msgstr "" #. Tag: para -#: basic_mapping.xml:2585 #, no-c-format msgid "Type mappings from Java primitives or wrapper classes to appropriate (vendor-specific) SQL column types. <literal>boolean, yes_no</literal> and <literal>true_false</literal> are all alternative encodings for a Java <literal>boolean</literal> or <literal>java.lang.Boolean</literal>." msgstr "" -#. Tag: literal -#: basic_mapping.xml:2594 +#. Tag: term #, no-c-format -msgid "string" +msgid "<literal>string</literal>" msgstr "" #. Tag: para -#: basic_mapping.xml:2596 #, no-c-format msgid "A type mapping from <literal>java.lang.String</literal> to <literal>VARCHAR</literal> (or Oracle <literal>VARCHAR2</literal>)." msgstr "" -#. Tag: literal -#: basic_mapping.xml:2603 +#. Tag: term #, no-c-format -msgid "date, time, timestamp" +msgid "<literal>date, time, timestamp</literal>" msgstr "" #. Tag: para -#: basic_mapping.xml:2605 #, no-c-format msgid "Type mappings from <literal>java.util.Date</literal> and its subclasses to SQL types <literal>DATE</literal>, <literal>TIME</literal> and <literal>TIMESTAMP</literal> (or equivalent)." msgstr "" -#. Tag: literal -#: basic_mapping.xml:2613 +#. Tag: term #, no-c-format -msgid "calendar, calendar_date" +msgid "<literal>calendar, calendar_date</literal>" msgstr "" #. Tag: para -#: basic_mapping.xml:2615 #, no-c-format msgid "Type mappings from <literal>java.util.Calendar</literal> to SQL types <literal>TIMESTAMP</literal> and <literal>DATE</literal> (or equivalent)." msgstr "" -#. Tag: literal -#: basic_mapping.xml:2623 +#. Tag: term #, no-c-format -msgid "big_decimal, big_integer" +msgid "<literal>big_decimal, big_integer</literal>" msgstr "" #. Tag: para -#: basic_mapping.xml:2625 #, no-c-format msgid "Type mappings from <literal>java.math.BigDecimal</literal> and <literal>java.math.BigInteger</literal> to <literal>NUMERIC</literal> (or Oracle <literal>NUMBER</literal>)." msgstr "" -#. Tag: literal -#: basic_mapping.xml:2633 +#. Tag: term #, no-c-format -msgid "locale, timezone, currency" +msgid "<literal>locale, timezone, currency</literal>" msgstr "" #. Tag: para -#: basic_mapping.xml:2635 #, no-c-format msgid "Type mappings from <literal>java.util.Locale</literal>, <literal>java.util.TimeZone</literal> and <literal>java.util.Currency</literal> to <literal>VARCHAR</literal> (or Oracle <literal>VARCHAR2</literal>). Instances of <literal>Locale</literal> and <literal>Currency</literal> are mapped to their ISO codes. Instances of <literal>TimeZone</literal> are mapped to their <literal>ID</literal>." msgstr "" -#. Tag: literal -#: basic_mapping.xml:2647 +#. Tag: term #, no-c-format -msgid "class" +msgid "<literal>class</literal>" msgstr "" #. Tag: para -#: basic_mapping.xml:2649 #, no-c-format msgid "A type mapping from <literal>java.lang.Class</literal> to <literal>VARCHAR</literal> (or Oracle <literal>VARCHAR2</literal>). A <literal>Class</literal> is mapped to its fully qualified name." msgstr "" -#. Tag: literal -#: basic_mapping.xml:2657 +#. Tag: term #, no-c-format -msgid "binary" +msgid "<literal>binary</literal>" msgstr "" #. Tag: para -#: basic_mapping.xml:2659 #, no-c-format msgid "Maps byte arrays to an appropriate SQL binary type." msgstr "" -#. Tag: literal -#: basic_mapping.xml:2665 +#. Tag: term #, no-c-format -msgid "text" +msgid "<literal>text</literal>" msgstr "" #. Tag: para -#: basic_mapping.xml:2667 #, no-c-format msgid "Maps long Java strings to a SQL <literal>CLOB</literal> or <literal>TEXT</literal> type." msgstr "" -#. Tag: literal -#: basic_mapping.xml:2674 +#. Tag: term #, no-c-format -msgid "serializable" +msgid "<literal>serializable</literal>" msgstr "" #. Tag: para -#: basic_mapping.xml:2676 #, no-c-format msgid "Maps serializable Java types to an appropriate SQL binary type. You can also indicate the Hibernate type <literal>serializable</literal> with the name of a serializable Java class or interface that does not default to a basic type." msgstr "" -#. Tag: literal -#: basic_mapping.xml:2685 +#. Tag: term #, no-c-format -msgid "clob, blob" +msgid "<literal>clob, blob</literal>" msgstr "" #. Tag: para -#: basic_mapping.xml:2687 #, no-c-format msgid "Type mappings for the JDBC classes <literal>java.sql.Clob</literal> and <literal>java.sql.Blob</literal>. These types can be inconvenient for some applications, since the blob or clob object cannot be reused outside of a transaction. Driver support is patchy and inconsistent." msgstr "" -#. Tag: literal -#: basic_mapping.xml:2697 +#. Tag: term #, no-c-format -msgid "imm_date, imm_time, imm_timestamp, imm_calendar, imm_calendar_date, imm_serializable, imm_binary" +msgid "<literal>imm_date, imm_time, imm_timestamp, imm_calendar, imm_calendar_date, imm_serializable, imm_binary</literal>" msgstr "" #. Tag: para -#: basic_mapping.xml:2701 #, no-c-format msgid "Type mappings for what are considered mutable Java types. This is where Hibernate makes certain optimizations appropriate only for immutable Java types, and the application treats the object as immutable. For example, you should not call <literal>Date.setTime()</literal> for an instance mapped as <literal>imm_timestamp</literal>. To change the value of the property, and have that change made persistent, the application must assign a new, nonidentical, object to the property." msgstr "" #. Tag: para -#: basic_mapping.xml:2716 #, no-c-format msgid "Unique identifiers of entities and collections can be of any basic type except <literal>binary</literal>, <literal>blob</literal> and <literal>clob</literal>. Composite identifiers are also allowed. See below for more information." msgstr "" #. Tag: para -#: basic_mapping.xml:2722 #, no-c-format msgid "The basic value types have corresponding <literal>Type</literal> constants defined on <literal>org.hibernate.Hibernate</literal>. For example, <literal>Hibernate.STRING</literal> represents the <literal>string</literal> type." msgstr "" #. Tag: title -#: basic_mapping.xml:2731 #, no-c-format msgid "Custom value types" msgstr "" #. Tag: para -#: basic_mapping.xml:2733 #, no-c-format msgid "It is relatively easy for developers to create their own value types. For example, you might want to persist properties of type <literal>java.lang.BigInteger</literal> to <literal>VARCHAR</literal> columns. Hibernate does not provide a built-in type for this. Custom types are not limited to mapping a property, or collection element, to a single table column. So, for example, you might have a Java property <literal>getName()</literal>/<literal>setName()</literal> of type <literal>java.lang.String</literal> that is persisted to the columns <literal>FIRST_NAME</literal>, <literal>INITIAL</literal>, <literal>SURNAME</literal>." msgstr "" #. Tag: para -#: basic_mapping.xml:2744 #, no-c-format msgid "To implement a custom type, implement either <literal>org.hibernate.UserType</literal> or <literal>org.hibernate.CompositeUserType</literal> and declare properties using the fully qualified classname of the type. View <literal>org.hibernate.test.DoubleStringType</literal> to see the kind of things that are possible." msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:2752 -#, no-c-format -msgid "" - "<![CDATA[<property name=\"twoStrings\" type=\"org.hibernate.test.DoubleStringType\">\n" - " <column name=\"first_string\"/>\n" - " <column name=\"second_string\"/>\n" - "</property>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:2754 #, no-c-format msgid "Notice the use of <literal><column></literal> tags to map a property to multiple columns." msgstr "" #. Tag: para -#: basic_mapping.xml:2759 #, no-c-format msgid "The <literal>CompositeUserType</literal>, <literal>EnhancedUserType</literal>, <literal>UserCollectionType</literal>, and <literal>UserVersionType</literal> interfaces provide support for more specialized uses." msgstr "" #. Tag: para -#: basic_mapping.xml:2765 #, no-c-format msgid "You can even supply parameters to a <literal>UserType</literal> in the mapping file. To do this, your <literal>UserType</literal> must implement the <literal>org.hibernate.usertype.ParameterizedType</literal> interface. To supply parameters to your custom type, you can use the <literal><type></literal> element in your mapping files." msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:2773 -#, no-c-format -msgid "" - "<![CDATA[<property name=\"priority\">\n" - " <type name=\"com.mycompany.usertypes.DefaultValueIntegerType\">\n" - " <param name=\"default\">0</param>\n" - " </type>\n" - "</property>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:2775 #, no-c-format msgid "The <literal>UserType</literal> can now retrieve the value for the parameter named <literal>default</literal> from the <literal>Properties</literal> object passed to it." msgstr "" #. Tag: para -#: basic_mapping.xml:2780 #, no-c-format msgid "If you regularly use a certain <literal>UserType</literal>, it is useful to define a shorter name for it. You can do this using the <literal><typedef></literal> element. Typedefs assign a name to a custom type, and can also contain a list of default parameter values if the type is parameterized." msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:2787 -#, no-c-format -msgid "" - "<![CDATA[<typedef class=\"com.mycompany.usertypes.DefaultValueIntegerType\" name=\"default_zero\">\n" - " <param name=\"default\">0</param>\n" - "</typedef>]]>" -msgstr "" - -#. Tag: programlisting -#: basic_mapping.xml:2789 -#, no-c-format -msgid "<![CDATA[<property name=\"priority\" type=\"default_zero\"/>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:2791 #, no-c-format msgid "It is also possible to override the parameters supplied in a typedef on a case-by-case basis by using type parameters on the property mapping." msgstr "" #. Tag: para -#: basic_mapping.xml:2796 #, no-c-format msgid "Even though Hibernate's rich range of built-in types and support for components means you will rarely need to use a custom type, it is considered good practice to use custom types for non-entity classes that occur frequently in your application. For example, a <literal>MonetaryAmount</literal> class is a good candidate for a <literal>CompositeUserType</literal>, even though it could be mapped as a component. One reason for this is abstraction. With a custom type, your mapping documents would be protected against changes to the way monetary values are represented." msgstr "" #. Tag: title -#: basic_mapping.xml:2812 #, no-c-format msgid "Mapping a class more than once" msgstr "" #. Tag: para -#: basic_mapping.xml:2813 #, no-c-format msgid "It is possible to provide more than one mapping for a particular persistent class. In this case, you must specify an <emphasis>entity name</emphasis> to disambiguate between instances of the two mapped entities. By default, the entity name is the same as the class name. Hibernate lets you specify the entity name when working with persistent objects, when writing queries, or when mapping associations to the named entity." msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:2821 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Contract\" table=\"Contracts\"\n" - " entity-name=\"CurrentContract\">\n" - " ...\n" - " <set name=\"history\" inverse=\"true\"\n" - " order-by=\"effectiveEndDate desc\">\n" - " <key column=\"currentContractId\"/>\n" - " <one-to-many entity-name=\"HistoricalContract\"/>\n" - " </set>\n" - "</class>\n" - "\n" - "<class name=\"Contract\" table=\"ContractHistory\"\n" - " entity-name=\"HistoricalContract\">\n" - " ...\n" - " <many-to-one name=\"currentContract\"\n" - " column=\"currentContractId\"\n" - " entity-name=\"CurrentContract\"/>\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:2823 #, no-c-format msgid "Associations are now specified using <literal>entity-name</literal> instead of <literal>class</literal>." msgstr "" #. Tag: title -#: basic_mapping.xml:2831 #, no-c-format msgid "SQL quoted identifiers" msgstr "" #. Tag: para -#: basic_mapping.xml:2832 #, no-c-format msgid "You can force Hibernate to quote an identifier in the generated SQL by enclosing the table or column name in backticks in the mapping document. Hibernate will use the correct quotation style for the SQL <literal>Dialect</literal>. This is usually double quotes, but the SQL Server uses brackets and MySQL uses backticks." msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:2839 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"LineItem\" table=\"`Line Item`\">\n" - " <id name=\"id\" column=\"`Item Id`\"/><generator class=\"assigned\"/></id>\n" - " <property name=\"itemNumber\" column=\"`Item #`\"/>\n" - " ...\n" - "</class>]]>" -msgstr "" - #. Tag: title -#: basic_mapping.xml:2845 #, no-c-format msgid "Metadata alternatives" msgstr "" #. Tag: para -#: basic_mapping.xml:2847 #, no-c-format msgid "XML does not suit all users so there are some alternative ways to define O/R mapping metadata in Hibernate." msgstr "" #. Tag: title -#: basic_mapping.xml:2852 #, no-c-format msgid "Using XDoclet markup" msgstr "" #. Tag: para -#: basic_mapping.xml:2854 #, no-c-format msgid "Many Hibernate users prefer to embed mapping information directly in sourcecode using XDoclet <literal>@hibernate.tags</literal>. We do not cover this approach in this reference guide since it is considered part of XDoclet. However, we include the following example of the <literal>Cat</literal> class with XDoclet mappings:" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:2861 -#, no-c-format -msgid "" - "<![CDATA[package eg;\n" - "import java.util.Set;\n" - "import java.util.Date;\n" - "\n" - "/**\n" - " * @hibernate.class\n" - " * table=\"CATS\"\n" - " */\n" - "public class Cat {\n" - " private Long id; // identifier\n" - " private Date birthdate;\n" - " private Cat mother;\n" - " private Set kittens\n" - " private Color color;\n" - " private char sex;\n" - " private float weight;\n" - "\n" - " /*\n" - " * @hibernate.id\n" - " * generator-class=\"native\"\n" - " * column=\"CAT_ID\"\n" - " */\n" - " public Long getId() {\n" - " return id;\n" - " }\n" - " private void setId(Long id) {\n" - " this.id=id;\n" - " }\n" - "\n" - " /**\n" - " * @hibernate.many-to-one\n" - " * column=\"PARENT_ID\"\n" - " */\n" - " public Cat getMother() {\n" - " return mother;\n" - " }\n" - " void setMother(Cat mother) {\n" - " this.mother = mother;\n" - " }\n" - "\n" - " /**\n" - " * @hibernate.property\n" - " * column=\"BIRTH_DATE\"\n" - " */\n" - " public Date getBirthdate() {\n" - " return birthdate;\n" - " }\n" - " void setBirthdate(Date date) {\n" - " birthdate = date;\n" - " }\n" - " /**\n" - " * @hibernate.property\n" - " * column=\"WEIGHT\"\n" - " */\n" - " public float getWeight() {\n" - " return weight;\n" - " }\n" - " void setWeight(float weight) {\n" - " this.weight = weight;\n" - " }\n" - "\n" - " /**\n" - " * @hibernate.property\n" - " * column=\"COLOR\"\n" - " * not-null=\"true\"\n" - " */\n" - " public Color getColor() {\n" - " return color;\n" - " }\n" - " void setColor(Color color) {\n" - " this.color = color;\n" - " }\n" - " /**\n" - " * @hibernate.set\n" - " * inverse=\"true\"\n" - " * order-by=\"BIRTH_DATE\"\n" - " * @hibernate.collection-key\n" - " * column=\"PARENT_ID\"\n" - " * @hibernate.collection-one-to-many\n" - " */\n" - " public Set getKittens() {\n" - " return kittens;\n" - " }\n" - " void setKittens(Set kittens) {\n" - " this.kittens = kittens;\n" - " }\n" - " // addKitten not needed by Hibernate\n" - " public void addKitten(Cat kitten) {\n" - " kittens.add(kitten);\n" - " }\n" - "\n" - " /**\n" - " * @hibernate.property\n" - " * column=\"SEX\"\n" - " * not-null=\"true\"\n" - " * update=\"false\"\n" - " */\n" - " public char getSex() {\n" - " return sex;\n" - " }\n" - " void setSex(char sex) {\n" - " this.sex=sex;\n" - " }\n" - "}]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:2863 #, no-c-format msgid "See the Hibernate website for more examples of XDoclet and Hibernate." msgstr "" #. Tag: title -#: basic_mapping.xml:2870 #, no-c-format msgid "Using JDK 5.0 Annotations" msgstr "" #. Tag: para -#: basic_mapping.xml:2872 #, no-c-format msgid "JDK 5.0 introduced XDoclet-style annotations at the language level that are type-safe and checked at compile time. This mechanism is more powerful than XDoclet annotations and better supported by tools and IDEs. IntelliJ IDEA, for example, supports auto-completion and syntax highlighting of JDK 5.0 annotations. The new revision of the EJB specification (JSR-220) uses JDK 5.0 annotations as the primary metadata mechanism for entity beans. Hibernate3 implements the <literal>EntityManager</literal> of JSR-220 (the persistence API). Support for mapping metadata is available via the <emphasis>Hibernate Annotations</emphasis> package as a separate download. Both EJB3 (JSR-220) and Hibernate3 metadata is supported." msgstr "" #. Tag: para -#: basic_mapping.xml:2883 #, no-c-format msgid "This is an example of a POJO class annotated as an EJB entity bean:" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:2887 -#, no-c-format -msgid "" - "<![CDATA[@Entity(access = AccessType.FIELD)\n" - "public class Customer implements Serializable {\n" - "\n" - " @Id;\n" - " Long id;\n" - "\n" - " String firstName;\n" - " String lastName;\n" - " Date birthday;\n" - "\n" - " @Transient\n" - " Integer age;\n" - "\n" - " @Embedded\n" - " private Address homeAddress;\n" - "\n" - " @OneToMany(cascade=CascadeType.ALL)\n" - " @JoinColumn(name=\"CUSTOMER_ID\")\n" - " Set<Order> orders;\n" - "\n" - " // Getter/setter and business methods\n" - "}]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:2891 #, no-c-format msgid "Support for JDK 5.0 Annotations (and JSR-220) is currently under development. Please refer to the Hibernate Annotations module for more details." msgstr "" #. Tag: title -#: basic_mapping.xml:2901 #, no-c-format msgid "Generated properties" msgstr "" #. Tag: para -#: basic_mapping.xml:2902 #, no-c-format msgid "Generated properties are properties that have their values generated by the database. Typically, Hibernate applications needed to <literal>refresh</literal> objects that contain any properties for which the database was generating values. Marking properties as generated, however, lets the application delegate this responsibility to Hibernate. When Hibernate issues an SQL INSERT or UPDATE for an entity that has defined generated properties, it immediately issues a select afterwards to retrieve the generated values." msgstr "" #. Tag: para -#: basic_mapping.xml:2911 #, no-c-format -msgid "Properties marked as generated must additionally be non-insertable and non-updateable. Only <link linkend=\"mapping-declaration-version\">versions</link>, <link linkend=\"mapping-declaration-timestamp\">timestamps</link>, and <link linkend=\"mapping-declaration-property\">simple properties</link>, can be marked as generated." +msgid "Properties marked as generated must additionally be non-insertable and non-updateable. Only versions (<xref linkend=\"mapping-declaration-version\" />), timestamps (<xref linkend=\"mapping-declaration-timestamp\" />), and simple properties (<xref linkend=\"mapping-declaration-property\" />), can be marked as generated." msgstr "" #. Tag: para -#: basic_mapping.xml:2918 #, no-c-format msgid "<literal>never</literal> (the default): the given property value is not generated within the database." msgstr "" #. Tag: para -#: basic_mapping.xml:2922 #, no-c-format -msgid "<literal>insert</literal>: the given property value is generated on insert, but is not regenerated on subsequent updates. Properties like created-date fall into this category. Even though <link linkend=\"mapping-declaration-version\">version</link> and <link linkend=\"mapping-declaration-timestamp\">timestamp</link> properties can be marked as generated, this option is not available." +msgid "<literal>insert</literal>: the given property value is generated on insert, but is not regenerated on subsequent updates. Properties like created-date fall into this category. Even though version (<xref linkend=\"mapping-declaration-version\" />) and timestamp (<xref linkend=\"mapping-declaration-timestamp\" />) properties can be marked as generated, this option is not available." msgstr "" #. Tag: para -#: basic_mapping.xml:2930 #, no-c-format msgid "<literal>always</literal>: the property value is generated both on insert and on update." msgstr "" #. Tag: title -#: basic_mapping.xml:2937 #, no-c-format msgid "Auxiliary database objects" msgstr "" #. Tag: para -#: basic_mapping.xml:2938 #, no-c-format msgid "Auxiliary database objects allow for the CREATE and DROP of arbitrary database objects. In conjunction with Hibernate's schema evolution tools, they have the ability to fully define a user schema within the Hibernate mapping files. Although designed specifically for creating and dropping things like triggers or stored procedures, any SQL command that can be run via a <literal>java.sql.Statement.execute()</literal> method is valid (for example, ALTERs, INSERTS, etc.). There are essentially two modes for defining auxiliary database objects:" msgstr "" #. Tag: para -#: basic_mapping.xml:2947 #, no-c-format msgid "The first mode is to explicitly list the CREATE and DROP commands in the mapping file:" msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:2951 -#, no-c-format -msgid "" - "<![CDATA[<hibernate-mapping>\n" - " ...\n" - " <database-object>\n" - " <create>CREATE TRIGGER my_trigger ...</create>\n" - " <drop>DROP TRIGGER my_trigger</drop>\n" - " </database-object>\n" - "</hibernate-mapping>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:2952 #, no-c-format msgid "The second mode is to supply a custom class that constructs the CREATE and DROP commands. This custom class must implement the <literal>org.hibernate.mapping.AuxiliaryDatabaseObject</literal> interface." msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:2957 -#, no-c-format -msgid "" - "<![CDATA[<hibernate-mapping>\n" - " ...\n" - " <database-object>\n" - " <definition class=\"MyTriggerDefinition\"/>\n" - " </database-object>\n" - "</hibernate-mapping>]]>" -msgstr "" - #. Tag: para -#: basic_mapping.xml:2958 #, no-c-format msgid "Additionally, these database objects can be optionally scoped so that they only apply when certain dialects are used." msgstr "" -#. Tag: programlisting -#: basic_mapping.xml:2962 -#, no-c-format -msgid "" - "<![CDATA[<hibernate-mapping>\n" - " ...\n" - " <database-object>\n" - " <definition class=\"MyTriggerDefinition\"/>\n" - " <dialect-scope name=\"org.hibernate.dialect.Oracle9iDialect\"/>\n" - " <dialect-scope name=\"org.hibernate.dialect.Oracle10gDialect\"/>\n" - " </database-object>\n" - "</hibernate-mapping>]]>" -msgstr "" - Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/batch.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/batch.pot 2010-02-08 04:50:03 UTC (rev 18716) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/batch.pot 2010-02-08 04:56:55 UTC (rev 18717) @@ -1,379 +1,189 @@ -# SOME DESCRIPTIVE TITLE. -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. # -#, fuzzy msgid "" msgstr "" -"Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-10 21:02+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:18\n" +"PO-Revision-Date: 2010-01-08T04:07:18\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" "MIME-Version: 1.0\n" -"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Type: application/x-publican; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. Tag: title -#: batch.xml:29 #, no-c-format msgid "Batch processing" msgstr "" #. Tag: para -#: batch.xml:31 #, no-c-format msgid "A naive approach to inserting 100,000 rows in the database using Hibernate might look like this:" msgstr "" -#. Tag: programlisting -#: batch.xml:36 -#, no-c-format -msgid "" - "<![CDATA[Session session = sessionFactory.openSession();\n" - "Transaction tx = session.beginTransaction();\n" - "for ( int i=0; i<100000; i++ ) {\n" - " Customer customer = new Customer(.....);\n" - " session.save(customer);\n" - "}\n" - "tx.commit();\n" - "session.close();]]>" -msgstr "" - #. Tag: para -#: batch.xml:38 #, no-c-format msgid "This would fall over with an <literal>OutOfMemoryException</literal> somewhere around the 50,000th row. That is because Hibernate caches all the newly inserted <literal>Customer</literal> instances in the session-level cache. In this chapter we will show you how to avoid this problem." msgstr "" #. Tag: para -#: batch.xml:45 #, no-c-format msgid "If you are undertaking batch processing you will need to enable the use of JDBC batching. This is absolutely essential if you want to achieve optimal performance. Set the JDBC batch size to a reasonable number (10-50, for example):" msgstr "" -#. Tag: programlisting -#: batch.xml:52 -#, no-c-format -msgid "<![CDATA[hibernate.jdbc.batch_size 20]]>" -msgstr "" - #. Tag: para -#: batch.xml:54 #, no-c-format msgid "Hibernate disables insert batching at the JDBC level transparently if you use an <literal>identity</literal> identifier generator." msgstr "" #. Tag: para -#: batch.xml:59 #, no-c-format msgid "You can also do this kind of work in a process where interaction with the second-level cache is completely disabled:" msgstr "" -#. Tag: programlisting -#: batch.xml:64 -#, no-c-format -msgid "<![CDATA[hibernate.cache.use_second_level_cache false]]>" -msgstr "" - #. Tag: para -#: batch.xml:66 #, no-c-format msgid "However, this is not absolutely necessary, since we can explicitly set the <literal>CacheMode</literal> to disable interaction with the second-level cache." msgstr "" #. Tag: title -#: batch.xml:72 #, no-c-format msgid "Batch inserts" msgstr "" #. Tag: para -#: batch.xml:74 #, no-c-format msgid "When making new objects persistent <literal>flush()</literal> and then <literal>clear()</literal> the session regularly in order to control the size of the first-level cache." msgstr "" -#. Tag: programlisting -#: batch.xml:80 -#, no-c-format -msgid "" - "<![CDATA[Session session = sessionFactory.openSession();\n" - "Transaction tx = session.beginTransaction();\n" - " \n" - "for ( int i=0; i<100000; i++ ) {\n" - " Customer customer = new Customer(.....);\n" - " session.save(customer);\n" - " if ( i % 20 == 0 ) { //20, same as the JDBC batch size\n" - " //flush a batch of inserts and release memory:\n" - " session.flush();\n" - " session.clear();\n" - " }\n" - "}\n" - " \n" - "tx.commit();\n" - "session.close();]]>" -msgstr "" - #. Tag: title -#: batch.xml:85 #, no-c-format msgid "Batch updates" msgstr "" #. Tag: para -#: batch.xml:87 #, no-c-format msgid "For retrieving and updating data, the same ideas apply. In addition, you need to use <literal>scroll()</literal> to take advantage of server-side cursors for queries that return many rows of data." msgstr "" -#. Tag: programlisting -#: batch.xml:93 -#, no-c-format -msgid "" - "<![CDATA[Session session = sessionFactory.openSession();\n" - "Transaction tx = session.beginTransaction();\n" - " \n" - "ScrollableResults customers = session.getNamedQuery(\"GetCustomers\")\n" - " .setCacheMode(CacheMode.IGNORE)\n" - " .scroll(ScrollMode.FORWARD_ONLY);\n" - "int count=0;\n" - "while ( customers.next() ) {\n" - " Customer customer = (Customer) customers.get(0);\n" - " customer.updateStuff(...);\n" - " if ( ++count % 20 == 0 ) {\n" - " //flush a batch of updates and release memory:\n" - " session.flush();\n" - " session.clear();\n" - " }\n" - "}\n" - " \n" - "tx.commit();\n" - "session.close();]]>" -msgstr "" - #. Tag: title -#: batch.xml:98 #, no-c-format msgid "The StatelessSession interface" msgstr "" #. Tag: para -#: batch.xml:99 #, no-c-format msgid "Alternatively, Hibernate provides a command-oriented API that can be used for streaming data to and from the database in the form of detached objects. A <literal>StatelessSession</literal> has no persistence context associated with it and does not provide many of the higher-level life cycle semantics. In particular, a stateless session does not implement a first-level cache nor interact with any second-level or query cache. It does not implement transactional write-behind or automatic dirty checking. Operations performed using a stateless session never cascade to associated instances. Collections are ignored by a stateless session. Operations performed via a stateless session bypass Hibernate's event model and interceptors. Due to the lack of a first-level cache, Stateless sessions are vulnerable to data aliasing effects. A stateless session is a lower-level abstraction that is much closer to the underlying JDBC." msgstr "" -#. Tag: programlisting -#: batch.xml:114 -#, no-c-format -msgid "" - "<![CDATA[StatelessSession session = sessionFactory.openStatelessSession();\n" - "Transaction tx = session.beginTransaction();\n" - " \n" - "ScrollableResults customers = session.getNamedQuery(\"GetCustomers\")\n" - " .scroll(ScrollMode.FORWARD_ONLY);\n" - "while ( customers.next() ) {\n" - " Customer customer = (Customer) customers.get(0);\n" - " customer.updateStuff(...);\n" - " session.update(customer);\n" - "}\n" - " \n" - "tx.commit();\n" - "session.close();]]>" -msgstr "" - #. Tag: para -#: batch.xml:116 #, no-c-format msgid "In this code example, the <literal>Customer</literal> instances returned by the query are immediately detached. They are never associated with any persistence context." msgstr "" #. Tag: para -#: batch.xml:122 #, no-c-format msgid "The <literal>insert(), update()</literal> and <literal>delete()</literal> operations defined by the <literal>StatelessSession</literal> interface are considered to be direct database row-level operations. They result in the immediate execution of a SQL <literal>INSERT, UPDATE</literal> or <literal>DELETE</literal> respectively. They have different semantics to the <literal>save(), saveOrUpdate()</literal> and <literal>delete()</literal> operations defined by the <literal>Session</literal> interface." msgstr "" #. Tag: title -#: batch.xml:135 #, no-c-format msgid "DML-style operations" msgstr "" #. Tag: para -#: batch.xml:137 #, no-c-format -msgid "As already discussed, automatic and transparent object/relational mapping is concerned with the management of the object state. The object state is available in memory. This means that manipulating data directly in the database (using the SQL <literal>Data Manipulation Language</literal> (DML) the statements: <literal>INSERT</literal>, <literal>UPDATE</literal>, <literal>DELETE</literal>) will not affect in-memory state. However, Hibernate provides methods for bulk SQL-style DML statement execution that is performed through the Hibernate Query Language (<link linkend=\"queryhql\">HQL</link>)." +msgid "As already discussed, automatic and transparent object/relational mapping is concerned with the management of the object state. The object state is available in memory. This means that manipulating data directly in the database (using the SQL <literal>Data Manipulation Language</literal> (DML) the statements: <literal>INSERT</literal>, <literal>UPDATE</literal>, <literal>DELETE</literal>) will not affect in-memory state. However, Hibernate provides methods for bulk SQL-style DML statement execution that is performed through the Hibernate Query Language (<xref linkend=\"queryhql\" />)." msgstr "" #. Tag: para -#: batch.xml:146 #, no-c-format msgid "The pseudo-syntax for <literal>UPDATE</literal> and <literal>DELETE</literal> statements is: <literal>( UPDATE | DELETE ) FROM? EntityName (WHERE where_conditions)?</literal>." msgstr "" #. Tag: para -#: batch.xml:151 #, no-c-format msgid "Some points to note:" msgstr "" #. Tag: para -#: batch.xml:157 #, no-c-format msgid "In the from-clause, the FROM keyword is optional" msgstr "" #. Tag: para -#: batch.xml:162 #, no-c-format msgid "There can only be a single entity named in the from-clause. It can, however, be aliased. If the entity name is aliased, then any property references must be qualified using that alias. If the entity name is not aliased, then it is illegal for any property references to be qualified." msgstr "" #. Tag: para -#: batch.xml:170 #, no-c-format -msgid "No <link linkend=\"queryhql-joins-forms\">joins</link>, either implicit or explicit, can be specified in a bulk HQL query. Sub-queries can be used in the where-clause, where the subqueries themselves may contain joins." +msgid "No <xref linkend=\"queryhql-joins-forms\" />, either implicit or explicit, can be specified in a bulk HQL query. Sub-queries can be used in the where-clause, where the subqueries themselves may contain joins." msgstr "" #. Tag: para -#: batch.xml:177 #, no-c-format msgid "The where-clause is also optional." msgstr "" #. Tag: para -#: batch.xml:183 #, no-c-format msgid "As an example, to execute an HQL <literal>UPDATE</literal>, use the <literal>Query.executeUpdate()</literal> method. The method is named for those familiar with JDBC's <literal>PreparedStatement.executeUpdate()</literal>:" msgstr "" -#. Tag: programlisting -#: batch.xml:189 -#, no-c-format -msgid "" - "<![CDATA[Session session = sessionFactory.openSession();\n" - "Transaction tx = session.beginTransaction();\n" - "\n" - "String hqlUpdate = \"update Customer c set c.name = :newName where c.name = :oldName\";\n" - "// or String hqlUpdate = \"update Customer set name = :newName where name = :oldName\";\n" - "int updatedEntities = s.createQuery( hqlUpdate )\n" - " .setString( \"newName\", newName )\n" - " .setString( \"oldName\", oldName )\n" - " .executeUpdate();\n" - "tx.commit();\n" - "session.close();]]>" -msgstr "" - #. Tag: para -#: batch.xml:191 #, no-c-format -msgid "In keeping with the EJB3 specification, HQL <literal>UPDATE</literal> statements, by default, do not effect the <link linkend=\"mapping-declaration-version\">version</link> or the <link linkend=\"mapping-declaration-timestamp\">timestamp</link> property values for the affected entities. However, you can force Hibernate to reset the <literal>version</literal> or <literal>timestamp</literal> property values through the use of a <literal>versioned update</literal>. This is achieved by adding the <literal>VERSIONED</literal> keyword after the <literal>UPDATE</literal> keyword." +msgid "In keeping with the EJB3 specification, HQL <literal>UPDATE</literal> statements, by default, do not effect the version (<xref linkend=\"mapping-declaration-version\" />) or the timestamp (<xref linkend=\"mapping-declaration-timestamp\" />) property values for the affected entities. However, you can force Hibernate to reset the <literal>version</literal> or <literal>timestamp</literal> property values through the use of a <literal>versioned update</literal>. This is achieved by adding the <literal>VERSIONED</literal> keyword after the <literal>UPDATE</literal> keyword." msgstr "" -#. Tag: programlisting -#: batch.xml:201 -#, no-c-format -msgid "" - "<![CDATA[Session session = sessionFactory.openSession();\n" - "Transaction tx = session.beginTransaction();\n" - "String hqlVersionedUpdate = \"update versioned Customer set name = :newName where name = :oldName\";\n" - "int updatedEntities = s.createQuery( hqlUpdate )\n" - " .setString( \"newName\", newName )\n" - " .setString( \"oldName\", oldName )\n" - " .executeUpdate();\n" - "tx.commit();\n" - "session.close();]]>" -msgstr "" - #. Tag: para -#: batch.xml:203 #, no-c-format msgid "Custom version types, <literal>org.hibernate.usertype.UserVersionType</literal>, are not allowed in conjunction with a <literal>update versioned</literal> statement." msgstr "" #. Tag: para -#: batch.xml:208 #, no-c-format msgid "To execute an HQL <literal>DELETE</literal>, use the same <literal>Query.executeUpdate()</literal> method:" msgstr "" -#. Tag: programlisting -#: batch.xml:213 -#, no-c-format -msgid "" - "<![CDATA[Session session = sessionFactory.openSession();\n" - "Transaction tx = session.beginTransaction();\n" - "\n" - "String hqlDelete = \"delete Customer c where c.name = :oldName\";\n" - "// or String hqlDelete = \"delete Customer where name = :oldName\";\n" - "int deletedEntities = s.createQuery( hqlDelete )\n" - " .setString( \"oldName\", oldName )\n" - " .executeUpdate();\n" - "tx.commit();\n" - "session.close();]]>" -msgstr "" - #. Tag: para -#: batch.xml:215 #, no-c-format msgid "The <literal>int</literal> value returned by the <literal>Query.executeUpdate()</literal> method indicates the number of entities effected by the operation. This may or may not correlate to the number of rows effected in the database. An HQL bulk operation might result in multiple actual SQL statements being executed (for joined-subclass, for example). The returned number indicates the number of actual entities affected by the statement. Going back to the example of joined-subclass, a delete against one of the subclasses may actually result in deletes against not just the table to which that subclass is mapped, but also the \"root\" table and potentially joined-subclass tables further down the inheritance hierarchy." msgstr "" #. Tag: para -#: batch.xml:226 #, no-c-format msgid "The pseudo-syntax for <literal>INSERT</literal> statements is: <literal>INSERT INTO EntityName properties_list select_statement</literal>. Some points to note:" msgstr "" #. Tag: para -#: batch.xml:234 #, no-c-format msgid "Only the INSERT INTO ... SELECT ... form is supported; not the INSERT INTO ... VALUES ... form." msgstr "" #. Tag: para -#: batch.xml:237 #, no-c-format msgid "The properties_list is analogous to the <literal>column specification</literal> in the SQL <literal>INSERT</literal> statement. For entities involved in mapped inheritance, only properties directly defined on that given class-level can be used in the properties_list. Superclass properties are not allowed and subclass properties do not make sense. In other words, <literal>INSERT</literal> statements are inherently non-polymorphic." msgstr "" #. Tag: para -#: batch.xml:247 #, no-c-format msgid "select_statement can be any valid HQL select query, with the caveat that the return types must match the types expected by the insert. Currently, this is checked during query compilation rather than allowing the check to relegate to the database. This might, however, cause problems between Hibernate <literal>Type</literal>s which are <emphasis>equivalent</emphasis> as opposed to <emphasis>equal</emphasis>. This might cause issues with mismatches between a property defined as a <literal>org.hibernate.type.DateType</literal> and a property defined as a <literal>org.hibernate.type.TimestampType</literal>, even though the database might not make a distinction or might be able to handle the conversion." msgstr "" #. Tag: para -#: batch.xml:259 #, no-c-format msgid "For the id property, the insert statement gives you two options. You can either explicitly specify the id property in the properties_list, in which case its value is taken from the corresponding select expression, or omit it from the properties_list, in which case a generated value is used. This latter option is only available when using id generators that operate in the database; attempting to use this option with any \"in memory\" type generators will cause an exception during parsing. For the purposes of this discussion, in-database generators are considered to be <literal>org.hibernate.id.SequenceGenerator</literal> (and its subclasses) and any implementers of <literal>org.hibernate.id.PostInsertIdentifierGenerator</literal>. The most notable exception here is <literal>org.hibernate.id.TableHiLoGenerator</literal>, which cannot be used because it does not expose a selectable way to get its values." msgstr "" #. Tag: para -#: batch.xml:274 #, no-c-format msgid "For properties mapped as either <literal>version</literal> or <literal>timestamp</literal>, the insert statement gives you two options. You can either specify the property in the properties_list, in which case its value is taken from the corresponding select expressions, or omit it from the properties_list, in which case the <literal>seed value</literal> defined by the <literal>org.hibernate.type.VersionType</literal> is used." msgstr "" #. Tag: para -#: batch.xml:284 #, no-c-format msgid "The following is an example of an HQL <literal>INSERT</literal> statement execution:" msgstr "" -#. Tag: programlisting -#: batch.xml:288 -#, no-c-format -msgid "" - "<![CDATA[Session session = sessionFactory.openSession();\n" - "Transaction tx = session.beginTransaction();\n" - "\n" - "String hqlInsert = \"insert into DelinquentAccount (id, name) select c.id, c.name from Customer c where ...\";\n" - "int createdEntities = s.createQuery( hqlInsert )\n" - " .executeUpdate();\n" - "tx.commit();\n" - "session.close();]]>" -msgstr "" - Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/best_practices.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/best_practices.pot 2010-02-08 04:50:03 UTC (rev 18716) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/best_practices.pot 2010-02-08 04:56:55 UTC (rev 18717) @@ -1,249 +1,208 @@ -# SOME DESCRIPTIVE TITLE. -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. # -#, fuzzy msgid "" msgstr "" -"Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-10 21:02+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:18\n" +"PO-Revision-Date: 2010-01-08T04:07:18\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" "MIME-Version: 1.0\n" -"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Type: application/x-publican; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. Tag: title -#: best_practices.xml:29 #, no-c-format msgid "Best Practices" msgstr "" #. Tag: term -#: best_practices.xml:33 #, no-c-format msgid "Write fine-grained classes and map them using <literal><component></literal>:" msgstr "" #. Tag: para -#: best_practices.xml:35 #, no-c-format msgid "Use an <literal>Address</literal> class to encapsulate <literal>street</literal>, <literal>suburb</literal>, <literal>state</literal>, <literal>postcode</literal>. This encourages code reuse and simplifies refactoring." msgstr "" #. Tag: term -#: best_practices.xml:43 #, no-c-format msgid "Declare identifier properties on persistent classes:" msgstr "" #. Tag: para -#: best_practices.xml:45 #, no-c-format msgid "Hibernate makes identifier properties optional. There are a range of reasons why you should use them. We recommend that identifiers be 'synthetic', that is, generated with no business meaning." msgstr "" #. Tag: term -#: best_practices.xml:53 #, no-c-format msgid "Identify natural keys:" msgstr "" #. Tag: para -#: best_practices.xml:55 #, no-c-format msgid "Identify natural keys for all entities, and map them using <literal><natural-id></literal>. Implement <literal>equals()</literal> and <literal>hashCode()</literal> to compare the properties that make up the natural key." msgstr "" #. Tag: term -#: best_practices.xml:63 #, no-c-format msgid "Place each class mapping in its own file:" msgstr "" #. Tag: para -#: best_practices.xml:65 #, no-c-format msgid "Do not use a single monolithic mapping document. Map <literal>com.eg.Foo</literal> in the file <literal>com/eg/Foo.hbm.xml</literal>. This makes sense, particularly in a team environment." msgstr "" #. Tag: term -#: best_practices.xml:73 #, no-c-format msgid "Load mappings as resources:" msgstr "" #. Tag: para -#: best_practices.xml:75 #, no-c-format msgid "Deploy the mappings along with the classes they map." msgstr "" #. Tag: term -#: best_practices.xml:81 #, no-c-format msgid "Consider externalizing query strings:" msgstr "" #. Tag: para -#: best_practices.xml:83 #, no-c-format msgid "This is recommended if your queries call non-ANSI-standard SQL functions. Externalizing the query strings to mapping files will make the application more portable." msgstr "" #. Tag: term -#: best_practices.xml:91 #, no-c-format msgid "Use bind variables." msgstr "" #. Tag: para -#: best_practices.xml:93 #, no-c-format msgid "As in JDBC, always replace non-constant values by \"?\". Do not use string manipulation to bind a non-constant value in a query. You should also consider using named parameters in queries." msgstr "" #. Tag: term -#: best_practices.xml:101 #, no-c-format msgid "Do not manage your own JDBC connections:" msgstr "" #. Tag: para -#: best_practices.xml:103 #, no-c-format msgid "Hibernate allows the application to manage JDBC connections, but his approach should be considered a last-resort. If you cannot use the built-in connection providers, consider providing your own implementation of <literal>org.hibernate.connection.ConnectionProvider</literal>." msgstr "" #. Tag: term -#: best_practices.xml:111 #, no-c-format msgid "Consider using a custom type:" msgstr "" #. Tag: para -#: best_practices.xml:113 #, no-c-format msgid "Suppose you have a Java type from a library that needs to be persisted but does not provide the accessors needed to map it as a component. You should consider implementing <literal>org.hibernate.UserType</literal>. This approach frees the application code from implementing transformations to/from a Hibernate type." msgstr "" #. Tag: term -#: best_practices.xml:122 #, no-c-format msgid "Use hand-coded JDBC in bottlenecks:" msgstr "" #. Tag: para -#: best_practices.xml:124 #, no-c-format msgid "In performance-critical areas of the system, some kinds of operations might benefit from direct JDBC. Do not assume, however, that JDBC is necessarily faster. Please wait until you <emphasis>know</emphasis> something is a bottleneck. If you need to use direct JDBC, you can open a Hibernate <literal>Session</literal> and usingfile:///usr/share/doc/HTML/en-US/index.html that JDBC connection. This way you can still use the same transaction strategy and underlying connection provider." msgstr "" #. Tag: term -#: best_practices.xml:134 #, no-c-format msgid "Understand <literal>Session</literal> flushing:" msgstr "" #. Tag: para -#: best_practices.xml:136 #, no-c-format msgid "Sometimes the Session synchronizes its persistent state with the database. Performance will be affected if this process occurs too often. You can sometimes minimize unnecessary flushing by disabling automatic flushing, or even by changing the order of queries and other operations within a particular transaction." msgstr "" #. Tag: term -#: best_practices.xml:145 #, no-c-format msgid "In a three tiered architecture, consider using detached objects:" msgstr "" #. Tag: para -#: best_practices.xml:147 #, no-c-format msgid "When using a servlet/session bean architecture, you can pass persistent objects loaded in the session bean to and from the servlet/JSP layer. Use a new session to service each request. Use <literal>Session.merge()</literal> or <literal>Session.saveOrUpdate()</literal> to synchronize objects with the database." msgstr "" #. Tag: term -#: best_practices.xml:156 #, no-c-format msgid "In a two tiered architecture, consider using long persistence contexts:" msgstr "" #. Tag: para -#: best_practices.xml:158 #, no-c-format msgid "Database Transactions have to be as short as possible for best scalability. However, it is often necessary to implement long running <emphasis>application transactions</emphasis>, a single unit-of-work from the point of view of a user. An application transaction might span several client request/response cycles. It is common to use detached objects to implement application transactions. An appropriate alternative in a two tiered architecture, is to maintain a single open persistence contact session for the whole life cycle of the application transaction. Then simply disconnect from the JDBC connection at the end of each request and reconnect at the beginning of the subsequent request. Never share a single session across more than one application transaction or you will be working with stale data." msgstr "" #. Tag: term -#: best_practices.xml:172 #, no-c-format msgid "Do not treat exceptions as recoverable:" msgstr "" #. Tag: para -#: best_practices.xml:174 #, no-c-format msgid "This is more of a necessary practice than a \"best\" practice. When an exception occurs, roll back the <literal>Transaction</literal> and close the <literal>Session</literal>. If you do not do this, Hibernate cannot guarantee that in-memory state accurately represents the persistent state. For example, do not use <literal>Session.load()</literal> to determine if an instance with the given identifier exists on the database; use <literal>Session.get()</literal> or a query instead." msgstr "" #. Tag: term -#: best_practices.xml:184 #, no-c-format msgid "Prefer lazy fetching for associations:" msgstr "" #. Tag: para -#: best_practices.xml:186 #, no-c-format msgid "Use eager fetching sparingly. Use proxies and lazy collections for most associations to classes that are not likely to be completely held in the second-level cache. For associations to cached classes, where there is an a extremely high probability of a cache hit, explicitly disable eager fetching using <literal>lazy=\"false\"</literal>. When join fetching is appropriate to a particular use case, use a query with a <literal>left join fetch</literal>." msgstr "" #. Tag: term -#: best_practices.xml:196 #, no-c-format msgid "Use the <emphasis>open session in view</emphasis> pattern, or a disciplined <emphasis>assembly phase</emphasis> to avoid problems with unfetched data:" msgstr "" #. Tag: para -#: best_practices.xml:201 #, no-c-format msgid "Hibernate frees the developer from writing tedious <emphasis>Data Transfer Objects</emphasis> (DTO). In a traditional EJB architecture, DTOs serve dual purposes: first, they work around the problem that entity beans are not serializable; second, they implicitly define an assembly phase where all data to be used by the view is fetched and marshalled into the DTOs before returning control to the presentation tier. Hibernate eliminates the first purpose. Unless you are prepared to hold the persistence context (the session) open across the view rendering process, you will still need an assembly phase. Think of your business methods as having a strict contract with the presentation tier about what data is available in the detached objects. This is not a limitation of Hibernate. It is a fundamental requirement of safe transactional data access." msgstr "" #. Tag: term -#: best_practices.xml:215 #, no-c-format msgid "Consider abstracting your business logic from Hibernate:" msgstr "" #. Tag: para -#: best_practices.xml:217 #, no-c-format msgid "Hide Hibernate data-access code behind an interface. Combine the <emphasis>DAO</emphasis> and <emphasis>Thread Local Session</emphasis> patterns. You can even have some classes persisted by handcoded JDBC associated to Hibernate via a <literal>UserType</literal>. This advice is, however, intended for \"sufficiently large\" applications. It is not appropriate for an application with five tables." msgstr "" #. Tag: term -#: best_practices.xml:227 #, no-c-format msgid "Do not use exotic association mappings:" msgstr "" #. Tag: para -#: best_practices.xml:229 #, no-c-format msgid "Practical test cases for real many-to-many associations are rare. Most of the time you need additional information stored in the \"link table\". In this case, it is much better to use two one-to-many associations to an intermediate link class. In fact, most associations are one-to-many and many-to-one. For this reason, you should proceed cautiously when using any other association style." msgstr "" #. Tag: term -#: best_practices.xml:239 #, no-c-format msgid "Prefer bidirectional associations:" msgstr "" #. Tag: para -#: best_practices.xml:241 #, no-c-format msgid "Unidirectional associations are more difficult to query. In a large application, almost all associations must be navigable in both directions in queries." msgstr "" Deleted: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/bibliography.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/bibliography.pot 2010-02-08 04:50:03 UTC (rev 18716) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/bibliography.pot 2010-02-08 04:56:55 UTC (rev 18717) @@ -1,70 +0,0 @@ -# SOME DESCRIPTIVE TITLE. -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. -# -#, fuzzy -msgid "" -msgstr "" -"Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-10 21:02+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" -"MIME-Version: 1.0\n" -"Content-Type: application/x-xml2pot; charset=UTF-8\n" -"Content-Transfer-Encoding: 8bit\n" - -#. Tag: title -#: bibliography.xml:27 -#, no-c-format -msgid "References" -msgstr "" - -#. Tag: title -#: bibliography.xml:31 -#, no-c-format -msgid "Patterns of Enterprise Application Architecture" -msgstr "" - -#. Tag: author -#: bibliography.xml:34 -#, no-c-format -msgid "<firstname>Martin</firstname> <surname>Fowler</surname>" -msgstr "" - -#. Tag: holder -#: bibliography.xml:41 -#, no-c-format -msgid "Pearson Education, Inc." -msgstr "" - -#. Tag: title -#: bibliography.xml:50 -#, no-c-format -msgid "Java Persistence with Hibernate" -msgstr "" - -#. Tag: subtitle -#: bibliography.xml:51 -#, no-c-format -msgid "Second Edition of Hibernate in Action" -msgstr "" - -#. Tag: author -#: bibliography.xml:57 -#, no-c-format -msgid "<firstname>Christian</firstname> <surname>Bauer</surname>" -msgstr "" - -#. Tag: author -#: bibliography.xml:61 -#, no-c-format -msgid "<firstname>Gavin</firstname> <surname>King</surname>" -msgstr "" - -#. Tag: holder -#: bibliography.xml:68 -#, no-c-format -msgid "Manning Publications Co." -msgstr "" - Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/collection_mapping.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/collection_mapping.pot 2010-02-08 04:50:03 UTC (rev 18716) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/collection_mapping.pot 2010-02-08 04:56:55 UTC (rev 18717) @@ -1,1210 +1,623 @@ -# SOME DESCRIPTIVE TITLE. -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. # -#, fuzzy msgid "" msgstr "" -"Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-10 21:02+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:18\n" +"PO-Revision-Date: 2010-01-08T04:07:18\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" "MIME-Version: 1.0\n" -"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Type: application/x-publican; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. Tag: title -#: collection_mapping.xml:29 #, no-c-format msgid "Collection mapping" msgstr "" #. Tag: title -#: collection_mapping.xml:32 #, no-c-format msgid "Persistent collections" msgstr "" #. Tag: para -#: collection_mapping.xml:34 #, no-c-format msgid "Hibernate requires that persistent collection-valued fields be declared as an interface type. For example:" msgstr "" -#. Tag: programlisting -#: collection_mapping.xml:39 -#, no-c-format -msgid "" - "<![CDATA[public class Product {\n" - " private String serialNumber;\n" - " private Set parts = new HashSet();\n" - " \n" - " public Set getParts() { return parts; }\n" - " void setParts(Set parts) { this.parts = parts; }\n" - " public String getSerialNumber() { return serialNumber; }\n" - " void setSerialNumber(String sn) { serialNumber = sn; }\n" - "}]]>" -msgstr "" - #. Tag: para -#: collection_mapping.xml:41 #, no-c-format msgid "The actual interface might be <literal>java.util.Set</literal>, <literal>java.util.Collection</literal>, <literal>java.util.List</literal>, <literal>java.util.Map</literal>, <literal>java.util.SortedSet</literal>, <literal>java.util.SortedMap</literal> or anything you like (\"anything you like\" means you will have to write an implementation of <literal>org.hibernate.usertype.UserCollectionType</literal>.)" msgstr "" #. Tag: para -#: collection_mapping.xml:50 #, no-c-format msgid "Notice how the instance variable was initialized with an instance of <literal>HashSet</literal>. This is the best way to initialize collection valued properties of newly instantiated (non-persistent) instances. When you make the instance persistent, by calling <literal>persist()</literal> for example, Hibernate will actually replace the <literal>HashSet</literal> with an instance of Hibernate's own implementation of <literal>Set</literal>. Be aware of the following errors:" msgstr "" -#. Tag: programlisting -#: collection_mapping.xml:60 -#, no-c-format -msgid "" - "<![CDATA[Cat cat = new DomesticCat();\n" - "Cat kitten = new DomesticCat();\n" - "....\n" - "Set kittens = new HashSet();\n" - "kittens.add(kitten);\n" - "cat.setKittens(kittens);\n" - "session.persist(cat);\n" - "kittens = cat.getKittens(); // Okay, kittens collection is a Set\n" - "(HashSet) cat.getKittens(); // Error!]]>" -msgstr "" - #. Tag: para -#: collection_mapping.xml:62 #, no-c-format msgid "The persistent collections injected by Hibernate behave like <literal>HashMap</literal>, <literal>HashSet</literal>, <literal>TreeMap</literal>, <literal>TreeSet</literal> or <literal>ArrayList</literal>, depending on the interface type." msgstr "" #. Tag: para -#: collection_mapping.xml:69 #, no-c-format msgid "Collections instances have the usual behavior of value types. They are automatically persisted when referenced by a persistent object and are automatically deleted when unreferenced. If a collection is passed from one persistent object to another, its elements might be moved from one table to another. Two entities cannot share a reference to the same collection instance. Due to the underlying relational model, collection-valued properties do not support null value semantics. Hibernate does not distinguish between a null collection reference and an empty collection." msgstr "" #. Tag: para -#: collection_mapping.xml:80 #, no-c-format msgid "Use persistent collections the same way you use ordinary Java collections. However, please ensure you understand the semantics of bidirectional associations (these are discussed later)." msgstr "" #. Tag: title -#: collection_mapping.xml:89 #, no-c-format msgid "Collection mappings" msgstr "" #. Tag: para -#: collection_mapping.xml:92 #, no-c-format msgid "There are quite a range of mappings that can be generated for collections that cover many common relational models. We suggest you experiment with the schema generation tool so that you understand how various mapping declarations translate to database tables." msgstr "" #. Tag: para -#: collection_mapping.xml:99 #, no-c-format msgid "The Hibernate mapping element used for mapping a collection depends upon the type of interface. For example, a <literal><set></literal> element is used for mapping properties of type <literal>Set</literal>." msgstr "" -#. Tag: programlisting -#: collection_mapping.xml:105 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Product\">\n" - " <id name=\"serialNumber\" column=\"productSerialNumber\"/>\n" - " <set name=\"parts\">\n" - " <key column=\"productSerialNumber\" not-null=\"true\"/>\n" - " <one-to-many class=\"Part\"/>\n" - " </set>\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: collection_mapping.xml:107 #, no-c-format msgid "Apart from <literal><set></literal>, there is also <literal><list></literal>, <literal><map></literal>, <literal><bag></literal>, <literal><array></literal> and <literal><primitive-array></literal> mapping elements. The <literal><map></literal> element is representative:" msgstr "" -#. Tag: programlisting -#: collection_mapping.xml:132 -#, no-c-format -msgid "" - "<![CDATA[<map\n" - " name=\"propertyName\"\n" - " table=\"table_name\"\n" - " schema=\"schema_name\"\n" - " lazy=\"true|extra|false\"\n" - " inverse=\"true|false\"\n" - " cascade=\"all|none|save-update|delete|all-delete-orphan|delete-orphan\"\n" - " sort=\"unsorted|natural|comparatorClass\"\n" - " order-by=\"column_name asc|desc\"\n" - " where=\"arbitrary sql where condition\"\n" - " fetch=\"join|select|subselect\"\n" - " batch-size=\"N\"\n" - " access=\"field|property|ClassName\"\n" - " optimistic-lock=\"true|false\"\n" - " mutable=\"true|false\"\n" - " node=\"element-name|.\"\n" - " embed-xml=\"true|false\"\n" - ">\n" - "\n" - " <key .... />\n" - " <map-key .... />\n" - " <element .... />\n" - "</map>]]>" -msgstr "" - #. Tag: para -#: collection_mapping.xml:135 #, no-c-format msgid "<literal>name</literal>: the collection property name" msgstr "" #. Tag: para -#: collection_mapping.xml:140 #, no-c-format msgid "<literal>table</literal> (optional - defaults to property name): the name of the collection table. It is not used for one-to-many associations." msgstr "" #. Tag: para -#: collection_mapping.xml:146 #, no-c-format msgid "<literal>schema</literal> (optional): the name of a table schema to override the schema declared on the root element" msgstr "" #. Tag: para -#: collection_mapping.xml:152 #, no-c-format msgid "<literal>lazy</literal> (optional - defaults to <literal>true</literal>): disables lazy fetching and specifies that the association is always eagerly fetched. It can also be used to enable \"extra-lazy\" fetching where most operations do not initialize the collection. This is suitable for large collections." msgstr "" #. Tag: para -#: collection_mapping.xml:161 #, no-c-format msgid "<literal>inverse</literal> (optional - defaults to <literal>false</literal>): marks this collection as the \"inverse\" end of a bidirectional association." msgstr "" #. Tag: para -#: collection_mapping.xml:167 #, no-c-format msgid "<literal>cascade</literal> (optional - defaults to <literal>none</literal>): enables operations to cascade to child entities." msgstr "" #. Tag: para -#: collection_mapping.xml:173 #, no-c-format msgid "<literal>sort</literal> (optional): specifies a sorted collection with <literal>natural</literal> sort order or a given comparator class." msgstr "" #. Tag: para -#: collection_mapping.xml:179 #, no-c-format msgid "<literal>order-by</literal> (optional, JDK1.4 only): specifies a table column or columns that define the iteration order of the <literal>Map</literal>, <literal>Set</literal> or bag, together with an optional <literal>asc</literal> or <literal>desc</literal>." msgstr "" #. Tag: para -#: collection_mapping.xml:186 #, no-c-format msgid "<literal>where</literal> (optional): specifies an arbitrary SQL <literal>WHERE</literal> condition that is used when retrieving or removing the collection. This is useful if the collection needs to contain only a subset of the available data." msgstr "" #. Tag: para -#: collection_mapping.xml:193 #, no-c-format msgid "<literal>fetch</literal> (optional, defaults to <literal>select</literal>): chooses between outer-join fetching, fetching by sequential select, and fetching by sequential subselect." msgstr "" #. Tag: para -#: collection_mapping.xml:200 #, no-c-format msgid "<literal>batch-size</literal> (optional, defaults to <literal>1</literal>): specifies a \"batch size\" for lazily fetching instances of this collection." msgstr "" #. Tag: para -#: collection_mapping.xml:206 #, no-c-format msgid "<literal>access</literal> (optional - defaults to <literal>property</literal>): the strategy Hibernate uses for accessing the collection property value." msgstr "" #. Tag: para -#: collection_mapping.xml:212 #, no-c-format msgid "<literal>optimistic-lock</literal> (optional - defaults to <literal>true</literal>): specifies that changes to the state of the collection results in increments of the owning entity's version. For one-to-many associations you may want to disable this setting." msgstr "" #. Tag: para -#: collection_mapping.xml:220 #, no-c-format msgid "<literal>mutable</literal> (optional - defaults to <literal>true</literal>): a value of <literal>false</literal> specifies that the elements of the collection never change. This allows for minor performance optimization in some cases." msgstr "" #. Tag: title -#: collection_mapping.xml:230 #, no-c-format msgid "Collection foreign keys" msgstr "" #. Tag: para -#: collection_mapping.xml:232 #, no-c-format msgid "Collection instances are distinguished in the database by the foreign key of the entity that owns the collection. This foreign key is referred to as the <emphasis>collection key column</emphasis>, or columns, of the collection table. The collection key column is mapped by the <literal><key></literal> element." msgstr "" #. Tag: para -#: collection_mapping.xml:240 #, no-c-format msgid "There can be a nullability constraint on the foreign key column. For most collections, this is implied. For unidirectional one-to-many associations, the foreign key column is nullable by default, so you may need to specify <literal>not-null=\"true\"</literal>." msgstr "" -#. Tag: programlisting -#: collection_mapping.xml:247 -#, no-c-format -msgid "<![CDATA[<key column=\"productSerialNumber\" not-null=\"true\"/>]]>" -msgstr "" - #. Tag: para -#: collection_mapping.xml:249 #, no-c-format msgid "The foreign key constraint can use <literal>ON DELETE CASCADE</literal>." msgstr "" -#. Tag: programlisting -#: collection_mapping.xml:253 -#, no-c-format -msgid "<![CDATA[<key column=\"productSerialNumber\" on-delete=\"cascade\"/>]]>" -msgstr "" - #. Tag: para -#: collection_mapping.xml:255 #, no-c-format msgid "See the previous chapter for a full definition of the <literal><key></literal> element." msgstr "" #. Tag: title -#: collection_mapping.xml:263 #, no-c-format msgid "Collection elements" msgstr "" #. Tag: para -#: collection_mapping.xml:265 #, no-c-format msgid "Collections can contain almost any other Hibernate type, including: basic types, custom types, components and references to other entities. This is an important distinction. An object in a collection might be handled with \"value\" semantics (its life cycle fully depends on the collection owner), or it might be a reference to another entity with its own life cycle. In the latter case, only the \"link\" between the two objects is considered to be a state held by the collection." msgstr "" #. Tag: para -#: collection_mapping.xml:274 #, no-c-format msgid "The contained type is referred to as the <emphasis>collection element type</emphasis>. Collection elements are mapped by <literal><element></literal> or <literal><composite-element></literal>, or in the case of entity references, with <literal><one-to-many></literal> or <literal><many-to-many></literal>. The first two map elements with value semantics, the next two are used to map entity associations." msgstr "" #. Tag: title -#: collection_mapping.xml:286 #, no-c-format msgid "Indexed collections" msgstr "" #. Tag: para -#: collection_mapping.xml:288 #, no-c-format msgid "All collection mappings, except those with set and bag semantics, need an <emphasis>index column</emphasis> in the collection table. An index column is a column that maps to an array index, or <literal>List</literal> index, or <literal>Map</literal> key. The index of a <literal>Map</literal> may be of any basic type, mapped with <literal><map-key></literal>. It can be an entity reference mapped with <literal><map-key-many-to-many></literal>, or it can be a composite type mapped with <literal><composite-map-key></literal>. The index of an array or list is always of type <literal>integer</literal> and is mapped using the <literal><list-index></literal> element. The mapped column contains sequential integers that are numbered from zero by default." msgstr "" -#. Tag: sect2 -#: collection_mapping.xml:299 +#. Tag: para #, no-c-format -msgid "" - "<programlistingco> <areaspec> <area id=\"index1\" coords=\"2 45\"/> <area id=\"index2\" coords=\"3 45\"/> </areaspec> <programlisting><![CDATA[<list-index \n" - " column=\"column_name\"\n" - " base=\"0|1|...\"/>]]></programlisting> <calloutlist> <callout arearefs=\"index1\"> <para> <literal>column_name</literal> (required): the name of the column holding the collection index values. </para> </callout> <callout arearefs=\"index1\"> <para> <literal>base</literal> (optional - defaults to <literal>0</literal>): the value of the index column that corresponds to the first element of the list or array. </para> </callout> </calloutlist> </programlistingco> <programlistingco> <areaspec> <area id=\"mapkey1\" coords=\"2 45\"/> <area id=\"mapkey2\" coords=\"3 45\"/> <area id=\"mapkey3\" coords=\"4 45\"/> </areaspec> <programlisting><![CDATA[<map-key \n" - " column=\"column_name\"\n" - " formula=\"any SQL expression\"\n" - " type=\"type_name\"\n" - " node=\"@attribute-name\"\n" - " length=\"N\"/>]]></programlisting> <calloutlist> <callout arearefs=\"mapkey1\"> <para> <literal>column</literal> (optional): the name of the column holding the collection index values. </para> </callout> <callout arearefs=\"mapkey2\"> <para> <literal>formula</literal> (optional): a SQL formula used to evaluate the key of the map. </para> </callout> <callout arearefs=\"mapkey3\"> <para> <literal>type</literal> (required): the type of the map keys. </para> </callout> </calloutlist> </programlistingco> <programlistingco> <areaspec> <area id=\"indexmanytomany1\" coords=\"2 45\"/> <area id=\"indexmanytomany2\" coords=\"3 45\"/> <area id=\"indexmanytomany3\" coords=\"3 45\"/> </areaspec> <programlisting><![CDATA[<map-key-many-to-many\n" - " column=\"column_name\"\n" - " formula=\"any SQL expression\"\n" - " class=\"ClassName\"\n" - "/>]]></programlisting> <calloutlist> <callout arearefs=\"indexmanytomany1\"> <para> <literal>column</literal> (optional): the name of the foreign key column for the collection index values. </para> </callout> <callout arearefs=\"indexmanytomany2\"> <para> <literal>formula</literal> (optional): a SQ formula used to evaluate the foreign key of the map key. </para> </callout> <callout arearefs=\"indexmanytomany3\"> <para> <literal>class</literal> (required): the entity class used as the map key. </para> </callout> </calloutlist> </programlistingco>" +msgid "<literal>column_name</literal> (required): the name of the column holding the collection index values." msgstr "" #. Tag: para -#: collection_mapping.xml:380 #, no-c-format +msgid "<literal>base</literal> (optional - defaults to <literal>0</literal>): the value of the index column that corresponds to the first element of the list or array." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "<literal>column</literal> (optional): the name of the column holding the collection index values." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "<literal>formula</literal> (optional): a SQL formula used to evaluate the key of the map." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "<literal>type</literal> (required): the type of the map keys." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "<literal>column</literal> (optional): the name of the foreign key column for the collection index values." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "<literal>formula</literal> (optional): a SQ formula used to evaluate the foreign key of the map key." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "<literal>class</literal> (required): the entity class used as the map key." +msgstr "" + +#. Tag: para +#, no-c-format msgid "If your table does not have an index column, and you still wish to use <literal>List</literal> as the property type, you can map the property as a Hibernate <emphasis><bag></emphasis>. A bag does not retain its order when it is retrieved from the database, but it can be optionally sorted or ordered." msgstr "" #. Tag: title -#: collection_mapping.xml:390 #, no-c-format msgid "Collections of values and many-to-many associations" msgstr "" #. Tag: para -#: collection_mapping.xml:392 #, no-c-format msgid "Any collection of values or many-to-many associations requires a dedicated <emphasis>collection table</emphasis> with a foreign key column or columns, <emphasis>collection element column</emphasis> or columns, and possibly an index column or columns." msgstr "" #. Tag: para -#: collection_mapping.xml:399 #, no-c-format msgid "For a collection of values use the <literal><element></literal> tag. For example:" msgstr "" -#. Tag: sect2 -#: collection_mapping.xml:401 +#. Tag: para #, no-c-format -msgid "" - "<programlistingco> <areaspec> <area id=\"element1b\" coords=\"2 50\"/> <area id=\"element2b\" coords=\"3 50\"/> <area id=\"element3b\" coords=\"4 50\"/> </areaspec> <programlisting><![CDATA[<element\n" - " column=\"column_name\"\n" - " formula=\"any SQL expression\"\n" - " type=\"typename\"\n" - " length=\"L\"\n" - " precision=\"P\"\n" - " scale=\"S\"\n" - " not-null=\"true|false\"\n" - " unique=\"true|false\"\n" - " node=\"element-name\"\n" - "/>]]></programlisting> <calloutlist> <callout arearefs=\"element1b\"> <para> <literal>column</literal> (optional): the name of the column holding the collection element values. </para> </callout> <callout arearefs=\"element2b\"> <para> <literal>formula</literal> (optional): an SQL formula used to evaluate the element. </para> </callout> <callout arearefs=\"element3b\"> <para> <literal>type</literal> (required): the type of the collection element. </para> </callout> </calloutlist> </programlistingco> <para> A <emphasis>many-to-many association</emphasis> is specified using the <literal><many-to-many></literal> element. </para> <programlistingco> <areaspec> <area id=\"manytomany1\" coords=\"2 60\"/> <area id=\"manytomany2\" coords=\"3 60\"/> <area id=\"manytomany3\" coords=\"4 60\"/> <area id=\"manytomany4\" coords=\"5 60\"/> <area id=\"manytomany5\" coords=\"6 60\"/> <area id=\"manytomany6\" coords=\"7 60\"/> <area id=\"manytomany7\" coords=\"8 60\"/> <area id=\! "manytomany8\" coords=\"9 60\"/> </areaspec> <programlisting><![CDATA[<many-to-many\n" - " column=\"column_name\"\n" - " formula=\"any SQL expression\"\n" - " class=\"ClassName\"\n" - " fetch=\"select|join\"\n" - " unique=\"true|false\"\n" - " not-found=\"ignore|exception\"\n" - " entity-name=\"EntityName\"\n" - " property-ref=\"propertyNameFromAssociatedClass\"\n" - " node=\"element-name\"\n" - " embed-xml=\"true|false\"\n" - " />]]></programlisting> <calloutlist> <callout arearefs=\"manytomany1\"> <para> <literal>column</literal> (optional): the name of the element foreign key column. </para> </callout> <callout arearefs=\"manytomany2\"> <para> <literal>formula</literal> (optional): an SQL formula used to evaluate the element foreign key value. </para> </callout> <callout arearefs=\"manytomany3\"> <para> <literal>class</literal> (required): the name of the associated class. </para> </callout> <callout arearefs=\"manytomany4\"> <para> <literal>fetch</literal> (optional - defaults to <literal>join</literal>): enables outer-join or sequential select fetching for this association. This is a special case; for full eager fetching in a single <literal>SELECT</literal> of an entity and its many-to-many relationships to other entities, you would enable <literal>join</literal> fetching,not only of the collection itself, but also with this attribute on the <literal><many-to-many></literal> ! nested element. </para> </callout> <callout arearefs=\"manytomany5\"> <para> <literal>unique</literal> (optional): enables the DDL generation of a unique constraint for the foreign-key column. This makes the association multiplicity effectively one-to-many. </para> </callout> <callout arearefs=\"manytomany6\"> <para> <literal>not-found</literal> (optional - defaults to <literal>exception</literal>): specifies how foreign keys that reference missing rows will be handled: <literal>ignore</literal> will treat a missing row as a null association. </para> </callout> <callout arearefs=\"manytomany7\"> <para> <literal>entity-name</literal> (optional): the entity name of the associated class, as an alternative to <literal>class</literal>. </para> </callout> <callout arearefs=\"manytomany8\"> <para> <literal>property-ref</literal> (optional): the name of a property of the associated class that is joined to this foreign key. If not specified, the primary key of the associated class i! s used. </para> </callout> </calloutlist> </programlistingco>" +msgid "<literal>column</literal> (optional): the name of the column holding the collection element values." msgstr "" #. Tag: para -#: collection_mapping.xml:506 #, no-c-format -msgid "Here are some examples." +msgid "<literal>formula</literal> (optional): an SQL formula used to evaluate the element." msgstr "" #. Tag: para -#: collection_mapping.xml:509 #, no-c-format -msgid "A set of strings:" +msgid "<literal>type</literal> (required): the type of the collection element." msgstr "" -#. Tag: programlisting -#: collection_mapping.xml:513 +#. Tag: para #, no-c-format -msgid "" - "<![CDATA[<set name=\"names\" table=\"person_names\">\n" - " <key column=\"person_id\"/>\n" - " <element column=\"person_name\" type=\"string\"/>\n" - "</set>]]>" +msgid "A <emphasis>many-to-many association</emphasis> is specified using the <literal><many-to-many></literal> element." msgstr "" #. Tag: para -#: collection_mapping.xml:515 #, no-c-format -msgid "A bag containing integers with an iteration order determined by the <literal>order-by</literal> attribute:" +msgid "<literal>column</literal> (optional): the name of the element foreign key column." msgstr "" -#. Tag: programlisting -#: collection_mapping.xml:520 +#. Tag: para #, no-c-format -msgid "" - "<![CDATA[<bag name=\"sizes\" \n" - " table=\"item_sizes\" \n" - " order-by=\"size asc\">\n" - " <key column=\"item_id\"/>\n" - " <element column=\"size\" type=\"integer\"/>\n" - "</bag>]]>" +msgid "<literal>formula</literal> (optional): an SQL formula used to evaluate the element foreign key value." msgstr "" #. Tag: para -#: collection_mapping.xml:522 #, no-c-format -msgid "An array of entities, in this case, a many-to-many association:" +msgid "<literal>class</literal> (required): the name of the associated class." msgstr "" -#. Tag: programlisting -#: collection_mapping.xml:526 +#. Tag: para #, no-c-format -msgid "" - "<![CDATA[<array name=\"addresses\" \n" - " table=\"PersonAddress\" \n" - " cascade=\"persist\">\n" - " <key column=\"personId\"/>\n" - " <list-index column=\"sortOrder\"/>\n" - " <many-to-many column=\"addressId\" class=\"Address\"/>\n" - "</array>]]>" +msgid "<literal>fetch</literal> (optional - defaults to <literal>join</literal>): enables outer-join or sequential select fetching for this association. This is a special case; for full eager fetching in a single <literal>SELECT</literal> of an entity and its many-to-many relationships to other entities, you would enable <literal>join</literal> fetching,not only of the collection itself, but also with this attribute on the <literal><many-to-many></literal> nested element." msgstr "" #. Tag: para -#: collection_mapping.xml:528 #, no-c-format -msgid "A map from string indices to dates:" +msgid "<literal>unique</literal> (optional): enables the DDL generation of a unique constraint for the foreign-key column. This makes the association multiplicity effectively one-to-many." msgstr "" -#. Tag: programlisting -#: collection_mapping.xml:532 +#. Tag: para #, no-c-format -msgid "" - "<![CDATA[<map name=\"holidays\" \n" - " table=\"holidays\" \n" - " schema=\"dbo\" \n" - " order-by=\"hol_name asc\">\n" - " <key column=\"id\"/>\n" - " <map-key column=\"hol_name\" type=\"string\"/>\n" - " <element column=\"hol_date\" type=\"date\"/>\n" - "</map>]]>" +msgid "<literal>not-found</literal> (optional - defaults to <literal>exception</literal>): specifies how foreign keys that reference missing rows will be handled: <literal>ignore</literal> will treat a missing row as a null association." msgstr "" #. Tag: para -#: collection_mapping.xml:534 #, no-c-format -msgid "A list of components (this is discussed in the next chapter):" +msgid "<literal>entity-name</literal> (optional): the entity name of the associated class, as an alternative to <literal>class</literal>." msgstr "" -#. Tag: programlisting -#: collection_mapping.xml:538 +#. Tag: para #, no-c-format -msgid "" - "<![CDATA[<list name=\"carComponents\" \n" - " table=\"CarComponents\">\n" - " <key column=\"carId\"/>\n" - " <list-index column=\"sortOrder\"/>\n" - " <composite-element class=\"CarComponent\">\n" - " <property name=\"price\"/>\n" - " <property name=\"type\"/>\n" - " <property name=\"serialNumber\" column=\"serialNum\"/>\n" - " </composite-element>\n" - "</list>]]>" +msgid "<literal>property-ref</literal> (optional): the name of a property of the associated class that is joined to this foreign key. If not specified, the primary key of the associated class is used." msgstr "" -#. Tag: title -#: collection_mapping.xml:543 +#. Tag: para #, no-c-format -msgid "One-to-many associations" +msgid "Here are some examples." msgstr "" #. Tag: para -#: collection_mapping.xml:545 #, no-c-format -msgid "A <emphasis>one-to-many association</emphasis> links the tables of two classes via a foreign key with no intervening collection table. This mapping loses certain semantics of normal Java collections:" +msgid "A set of strings:" msgstr "" #. Tag: para -#: collection_mapping.xml:553 #, no-c-format -msgid "An instance of the contained entity class cannot belong to more than one instance of the collection." +msgid "A bag containing integers with an iteration order determined by the <literal>order-by</literal> attribute:" msgstr "" #. Tag: para -#: collection_mapping.xml:559 #, no-c-format -msgid "An instance of the contained entity class cannot appear at more than one value of the collection index." +msgid "An array of entities, in this case, a many-to-many association:" msgstr "" #. Tag: para -#: collection_mapping.xml:566 #, no-c-format -msgid "An association from <literal>Product</literal> to <literal>Part</literal> requires the existence of a foreign key column and possibly an index column to the <literal>Part</literal> table. A <literal><one-to-many></literal> tag indicates that this is a one-to-many association." +msgid "A map from string indices to dates:" msgstr "" -#. Tag: programlisting -#: collection_mapping.xml:579 +#. Tag: para #, no-c-format -msgid "" - "<![CDATA[<one-to-many \n" - " class=\"ClassName\"\n" - " not-found=\"ignore|exception\"\n" - " entity-name=\"EntityName\"\n" - " node=\"element-name\"\n" - " embed-xml=\"true|false\"\n" - " />]]>" +msgid "A list of components (this is discussed in the next chapter):" msgstr "" +#. Tag: title +#, no-c-format +msgid "One-to-many associations" +msgstr "" + #. Tag: para -#: collection_mapping.xml:582 #, no-c-format -msgid "<literal>class</literal> (required): the name of the associated class." +msgid "A <emphasis>one-to-many association</emphasis> links the tables of two classes via a foreign key with no intervening collection table. This mapping loses certain semantics of normal Java collections:" msgstr "" #. Tag: para -#: collection_mapping.xml:587 #, no-c-format -msgid "<literal>not-found</literal> (optional - defaults to <literal>exception</literal>): specifies how cached identifiers that reference missing rows will be handled. <literal>ignore</literal> will treat a missing row as a null association." +msgid "An instance of the contained entity class cannot belong to more than one instance of the collection." msgstr "" #. Tag: para -#: collection_mapping.xml:594 #, no-c-format -msgid "<literal>entity-name</literal> (optional): the entity name of the associated class, as an alternative to <literal>class</literal>." +msgid "An instance of the contained entity class cannot appear at more than one value of the collection index." msgstr "" #. Tag: para -#: collection_mapping.xml:602 #, no-c-format -msgid "The <literal><one-to-many></literal> element does not need to declare any columns. Nor is it necessary to specify the <literal>table</literal> name anywhere." +msgid "An association from <literal>Product</literal> to <literal>Part</literal> requires the existence of a foreign key column and possibly an index column to the <literal>Part</literal> table. A <literal><one-to-many></literal> tag indicates that this is a one-to-many association." msgstr "" #. Tag: para -#: collection_mapping.xml:609 #, no-c-format -msgid "If the foreign key column of a <literal><one-to-many></literal> association is declared <literal>NOT NULL</literal>, you must declare the <literal><key></literal> mapping <literal>not-null=\"true\"</literal> or <emphasis>use a bidirectional association</emphasis> with the collection mapping marked <literal>inverse=\"true\"</literal>. See the discussion of bidirectional associations later in this chapter for more information." +msgid "<literal>not-found</literal> (optional - defaults to <literal>exception</literal>): specifies how cached identifiers that reference missing rows will be handled. <literal>ignore</literal> will treat a missing row as a null association." msgstr "" #. Tag: para -#: collection_mapping.xml:619 #, no-c-format -msgid "The following example shows a map of <literal>Part</literal> entities by name, where <literal>partName</literal> is a persistent property of <literal>Part</literal>. Notice the use of a formula-based index:" +msgid "The <literal><one-to-many></literal> element does not need to declare any columns. Nor is it necessary to specify the <literal>table</literal> name anywhere." msgstr "" -#. Tag: programlisting -#: collection_mapping.xml:625 +#. Tag: para #, no-c-format -msgid "" - "<![CDATA[<map name=\"parts\"\n" - " cascade=\"all\">\n" - " <key column=\"productId\" not-null=\"true\"/>\n" - " <map-key formula=\"partName\"/>\n" - " <one-to-many class=\"Part\"/>\n" - "</map>]]>" +msgid "If the foreign key column of a <literal><one-to-many></literal> association is declared <literal>NOT NULL</literal>, you must declare the <literal><key></literal> mapping <literal>not-null=\"true\"</literal> or <emphasis>use a bidirectional association</emphasis> with the collection mapping marked <literal>inverse=\"true\"</literal>. See the discussion of bidirectional associations later in this chapter for more information." msgstr "" +#. Tag: para +#, no-c-format +msgid "The following example shows a map of <literal>Part</literal> entities by name, where <literal>partName</literal> is a persistent property of <literal>Part</literal>. Notice the use of a formula-based index:" +msgstr "" + #. Tag: title -#: collection_mapping.xml:631 #, no-c-format msgid "Advanced collection mappings" msgstr "" #. Tag: title -#: collection_mapping.xml:634 #, no-c-format msgid "Sorted collections" msgstr "" #. Tag: para -#: collection_mapping.xml:636 #, no-c-format msgid "Hibernate supports collections implementing <literal>java.util.SortedMap</literal> and <literal>java.util.SortedSet</literal>. You must specify a comparator in the mapping file:" msgstr "" -#. Tag: programlisting -#: collection_mapping.xml:641 -#, no-c-format -msgid "" - "<![CDATA[<set name=\"aliases\" \n" - " table=\"person_aliases\" \n" - " sort=\"natural\">\n" - " <key column=\"person\"/>\n" - " <element column=\"name\" type=\"string\"/>\n" - "</set>\n" - "\n" - "<map name=\"holidays\" sort=\"my.custom.HolidayComparator\">\n" - " <key column=\"year_id\"/>\n" - " <map-key column=\"hol_name\" type=\"string\"/>\n" - " <element column=\"hol_date\" type=\"date\"/>\n" - "</map>]]>" -msgstr "" - #. Tag: para -#: collection_mapping.xml:643 #, no-c-format msgid "Allowed values of the <literal>sort</literal> attribute are <literal>unsorted</literal>, <literal>natural</literal> and the name of a class implementing <literal>java.util.Comparator</literal>." msgstr "" #. Tag: para -#: collection_mapping.xml:649 #, no-c-format msgid "Sorted collections actually behave like <literal>java.util.TreeSet</literal> or <literal>java.util.TreeMap</literal>." msgstr "" #. Tag: para -#: collection_mapping.xml:654 #, no-c-format msgid "If you want the database itself to order the collection elements, use the <literal>order-by</literal> attribute of <literal>set</literal>, <literal>bag</literal> or <literal>map</literal> mappings. This solution is only available under JDK 1.4 or higher and is implemented using <literal>LinkedHashSet</literal> or <literal>LinkedHashMap</literal>. This performs the ordering in the SQL query and not in the memory." msgstr "" -#. Tag: programlisting -#: collection_mapping.xml:663 -#, no-c-format -msgid "" - "<![CDATA[<set name=\"aliases\" table=\"person_aliases\" order-by=\"lower(name) asc\">\n" - " <key column=\"person\"/>\n" - " <element column=\"name\" type=\"string\"/>\n" - "</set>\n" - "\n" - "<map name=\"holidays\" order-by=\"hol_date, hol_name\">\n" - " <key column=\"year_id\"/>\n" - " <map-key column=\"hol_name\" type=\"string\"/>\n" - " <element column=\"hol_date type=\"date\"/>\n" - "</map>]]>" -msgstr "" - #. Tag: title -#: collection_mapping.xml:666 #, no-c-format msgid "Note" msgstr "" #. Tag: para -#: collection_mapping.xml:667 #, no-c-format msgid "The value of the <literal>order-by</literal> attribute is an SQL ordering, not an HQL ordering." msgstr "" #. Tag: para -#: collection_mapping.xml:673 #, no-c-format msgid "Associations can even be sorted by arbitrary criteria at runtime using a collection <literal>filter()</literal>:" msgstr "" -#. Tag: programlisting -#: collection_mapping.xml:678 -#, no-c-format -msgid "<![CDATA[sortedUsers = s.createFilter( group.getUsers(), \"order by this.name\" ).list();]]>" -msgstr "" - #. Tag: title -#: collection_mapping.xml:683 #, no-c-format msgid "Bidirectional associations" msgstr "" #. Tag: para -#: collection_mapping.xml:685 #, no-c-format msgid "A <emphasis>bidirectional association</emphasis> allows navigation from both \"ends\" of the association. Two kinds of bidirectional association are supported:" msgstr "" #. Tag: term -#: collection_mapping.xml:692 #, no-c-format msgid "one-to-many" msgstr "" #. Tag: para -#: collection_mapping.xml:694 #, no-c-format msgid "set or bag valued at one end and single-valued at the other" msgstr "" #. Tag: term -#: collection_mapping.xml:700 #, no-c-format msgid "many-to-many" msgstr "" #. Tag: para -#: collection_mapping.xml:702 #, no-c-format msgid "set or bag valued at both ends" msgstr "" #. Tag: para -#: collection_mapping.xml:711 #, no-c-format msgid "You can specify a bidirectional many-to-many association by mapping two many-to-many associations to the same database table and declaring one end as <emphasis>inverse</emphasis>. You cannot select an indexed collection." msgstr "" #. Tag: para -#: collection_mapping.xml:718 #, no-c-format msgid "Here is an example of a bidirectional many-to-many association that illustrates how each category can have many items and each item can be in many categories:" msgstr "" -#. Tag: programlisting -#: collection_mapping.xml:723 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Category\">\n" - " <id name=\"id\" column=\"CATEGORY_ID\"/>\n" - " ...\n" - " <bag name=\"items\" table=\"CATEGORY_ITEM\">\n" - " <key column=\"CATEGORY_ID\"/>\n" - " <many-to-many class=\"Item\" column=\"ITEM_ID\"/>\n" - " </bag>\n" - "</class>\n" - "\n" - "<class name=\"Item\">\n" - " <id name=\"id\" column=\"ITEM_ID\"/>\n" - " ...\n" - "\n" - " \n" - " <bag name=\"categories\" table=\"CATEGORY_ITEM\" inverse=\"true\">\n" - " <key column=\"ITEM_ID\"/>\n" - " <many-to-many class=\"Category\" column=\"CATEGORY_ID\"/>\n" - " </bag>\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: collection_mapping.xml:725 #, no-c-format msgid "Changes made only to the inverse end of the association are <emphasis>not</emphasis> persisted. This means that Hibernate has two representations in memory for every bidirectional association: one link from A to B and another link from B to A. This is easier to understand if you think about the Java object model and how a many-to-many relationship in Javais created:" msgstr "" -#. Tag: programlisting -#: collection_mapping.xml:733 -#, no-c-format -msgid "" - "<![CDATA[\n" - "category.getItems().add(item); // The category now \"knows\" about the relationship\n" - "item.getCategories().add(category); // The item now \"knows\" about the relationship\n" - "\n" - "session.persist(item); // The relationship won't be saved!\n" - "session.persist(category); // The relationship will be saved]]>" -msgstr "" - #. Tag: para -#: collection_mapping.xml:735 #, no-c-format msgid "The non-inverse side is used to save the in-memory representation to the database." msgstr "" #. Tag: para -#: collection_mapping.xml:739 #, no-c-format msgid "You can define a bidirectional one-to-many association by mapping a one-to-many association to the same table column(s) as a many-to-one association and declaring the many-valued end <literal>inverse=\"true\"</literal>." msgstr "" -#. Tag: programlisting -#: collection_mapping.xml:745 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Parent\">\n" - " <id name=\"id\" column=\"parent_id\"/>\n" - " ....\n" - " <set name=\"children\" inverse=\"true\">\n" - " <key column=\"parent_id\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </set>\n" - "</class>\n" - "\n" - "<class name=\"Child\">\n" - " <id name=\"id\" column=\"child_id\"/>\n" - " ....\n" - " <many-to-one name=\"parent\" \n" - " class=\"Parent\" \n" - " column=\"parent_id\"\n" - " not-null=\"true\"/>\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: collection_mapping.xml:747 #, no-c-format msgid "Mapping one end of an association with <literal>inverse=\"true\"</literal> does not affect the operation of cascades as these are orthogonal concepts." msgstr "" #. Tag: title -#: collection_mapping.xml:755 #, no-c-format msgid "Bidirectional associations with indexed collections" msgstr "" #. Tag: para -#: collection_mapping.xml:756 #, no-c-format msgid "A bidirectional association where one end is represented as a <literal><list></literal> or <literal><map></literal>, requires special consideration. If there is a property of the child class that maps to the index column you can use <literal>inverse=\"true\"</literal> on the collection mapping:" msgstr "" -#. Tag: programlisting -#: collection_mapping.xml:763 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Parent\">\n" - " <id name=\"id\" column=\"parent_id\"/>\n" - " ....\n" - " <map name=\"children\" inverse=\"true\">\n" - " <key column=\"parent_id\"/>\n" - " <map-key column=\"name\" \n" - " type=\"string\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </map>\n" - "</class>\n" - "\n" - "<class name=\"Child\">\n" - " <id name=\"id\" column=\"child_id\"/>\n" - " ....\n" - " <property name=\"name\" \n" - " not-null=\"true\"/>\n" - " <many-to-one name=\"parent\" \n" - " class=\"Parent\" \n" - " column=\"parent_id\"\n" - " not-null=\"true\"/>\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: collection_mapping.xml:765 #, no-c-format msgid "If there is no such property on the child class, the association cannot be considered truly bidirectional. That is, there is information available at one end of the association that is not available at the other end. In this case, you cannot map the collection <literal>inverse=\"true\"</literal>. Instead, you could use the following mapping:" msgstr "" -#. Tag: programlisting -#: collection_mapping.xml:772 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Parent\">\n" - " <id name=\"id\" column=\"parent_id\"/>\n" - " ....\n" - " <map name=\"children\">\n" - " <key column=\"parent_id\"\n" - " not-null=\"true\"/>\n" - " <map-key column=\"name\" \n" - " type=\"string\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </map>\n" - "</class>\n" - "\n" - "<class name=\"Child\">\n" - " <id name=\"id\" column=\"child_id\"/>\n" - " ....\n" - " <many-to-one name=\"parent\" \n" - " class=\"Parent\" \n" - " column=\"parent_id\"\n" - " insert=\"false\"\n" - " update=\"false\"\n" - " not-null=\"true\"/>\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: collection_mapping.xml:774 #, no-c-format -msgid "Note that in this mapping, the collection-valued end of the association is responsible for updates to the foreign key." +msgid "Note that in this mapping, the collection-valued end of the association is responsible for updates to the foreign key. " msgstr "" #. Tag: title -#: collection_mapping.xml:782 #, no-c-format msgid "Ternary associations" msgstr "" #. Tag: para -#: collection_mapping.xml:784 #, no-c-format msgid "There are three possible approaches to mapping a ternary association. One approach is to use a <literal>Map</literal> with an association as its index:" msgstr "" -#. Tag: programlisting -#: collection_mapping.xml:789 -#, no-c-format -msgid "" - "<![CDATA[<map name=\"contracts\">\n" - " <key column=\"employer_id\" not-null=\"true\"/>\n" - " <map-key-many-to-many column=\"employee_id\" class=\"Employee\"/>\n" - " <one-to-many class=\"Contract\"/>\n" - "</map>]]>" -msgstr "" - -#. Tag: programlisting -#: collection_mapping.xml:791 -#, no-c-format -msgid "" - "<![CDATA[<map name=\"connections\">\n" - " <key column=\"incoming_node_id\"/>\n" - " <map-key-many-to-many column=\"outgoing_node_id\" class=\"Node\"/>\n" - " <many-to-many column=\"connection_id\" class=\"Connection\"/>\n" - "</map>]]>" -msgstr "" - #. Tag: para -#: collection_mapping.xml:793 #, no-c-format msgid "A second approach is to remodel the association as an entity class. This is the most common approach." msgstr "" #. Tag: para -#: collection_mapping.xml:798 #, no-c-format msgid "A final alternative is to use composite elements, which will be discussed later." msgstr "" -#. Tag: literal -#: collection_mapping.xml:805 +#. Tag: title #, no-c-format -msgid "Using an <idbag>" +msgid "<literal>Using an <idbag></literal>" msgstr "" #. Tag: para -#: collection_mapping.xml:807 #, no-c-format msgid "The majority of the many-to-many associations and collections of values shown previously all map to tables with composite keys, even though it has been have suggested that entities should have synthetic identifiers (surrogate keys). A pure association table does not seem to benefit much from a surrogate key, although a collection of composite values <emphasis>might</emphasis>. It is for this reason that Hibernate provides a feature that allows you to map many-to-many associations and collections of values to a table with a surrogate key." msgstr "" #. Tag: para -#: collection_mapping.xml:817 #, no-c-format msgid "The <literal><idbag></literal> element lets you map a <literal>List</literal> (or <literal>Collection</literal>) with bag semantics. For example:" msgstr "" -#. Tag: programlisting -#: collection_mapping.xml:822 -#, no-c-format -msgid "" - "<![CDATA[<idbag name=\"lovers\" table=\"LOVERS\">\n" - " <collection-id column=\"ID\" type=\"long\">\n" - " <generator class=\"sequence\"/>\n" - " </collection-id>\n" - " <key column=\"PERSON1\"/>\n" - " <many-to-many column=\"PERSON2\" class=\"Person\" fetch=\"join\"/>\n" - "</idbag>]]>" -msgstr "" - #. Tag: para -#: collection_mapping.xml:824 #, no-c-format msgid "An <literal><idbag></literal> has a synthetic id generator, just like an entity class. A different surrogate key is assigned to each collection row. Hibernate does not, however, provide any mechanism for discovering the surrogate key value of a particular row." msgstr "" #. Tag: para -#: collection_mapping.xml:831 #, no-c-format msgid "The update performance of an <literal><idbag></literal> supersedes a regular <literal><bag></literal>. Hibernate can locate individual rows efficiently and update or delete them individually, similar to a list, map or set." msgstr "" #. Tag: para -#: collection_mapping.xml:837 #, no-c-format msgid "In the current implementation, the <literal>native</literal> identifier generation strategy is not supported for <literal><idbag></literal> collection identifiers." msgstr "" #. Tag: title -#: collection_mapping.xml:861 #, no-c-format msgid "Collection examples" msgstr "" #. Tag: para -#: collection_mapping.xml:863 #, no-c-format msgid "This section covers collection examples." msgstr "" #. Tag: para -#: collection_mapping.xml:867 #, no-c-format msgid "The following class has a collection of <literal>Child</literal> instances:" msgstr "" -#. Tag: programlisting -#: collection_mapping.xml:871 -#, no-c-format -msgid "" - "<![CDATA[package eg;\n" - "import java.util.Set;\n" - "\n" - "public class Parent {\n" - " private long id;\n" - " private Set children;\n" - "\n" - " public long getId() { return id; }\n" - " private void setId(long id) { this.id=id; }\n" - "\n" - " private Set getChildren() { return children; }\n" - " private void setChildren(Set children) { this.children=children; }\n" - "\n" - " ....\n" - " ....\n" - "}]]>" -msgstr "" - #. Tag: para -#: collection_mapping.xml:873 #, no-c-format msgid "If each child has, at most, one parent, the most natural mapping is a one-to-many association:" msgstr "" -#. Tag: programlisting -#: collection_mapping.xml:879 -#, no-c-format -msgid "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"Parent\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <set name=\"children\">\n" - " <key column=\"parent_id\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </set>\n" - " </class>\n" - "\n" - " <class name=\"Child\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" -msgstr "" - #. Tag: para -#: collection_mapping.xml:881 #, no-c-format msgid "This maps to the following table definitions:" msgstr "" -#. Tag: programlisting -#: collection_mapping.xml:885 -#, no-c-format -msgid "" - "<![CDATA[create table parent ( id bigint not null primary key )\n" - "create table child ( id bigint not null primary key, name varchar(255), parent_id bigint )\n" - "alter table child add constraint childfk0 (parent_id) references parent]]>" -msgstr "" - #. Tag: para -#: collection_mapping.xml:887 #, no-c-format msgid "If the parent is <emphasis>required</emphasis>, use a bidirectional one-to-many association:" msgstr "" -#. Tag: programlisting -#: collection_mapping.xml:892 -#, no-c-format -msgid "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"Parent\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <set name=\"children\" inverse=\"true\">\n" - " <key column=\"parent_id\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </set>\n" - " </class>\n" - "\n" - " <class name=\"Child\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " <many-to-one name=\"parent\" class=\"Parent\" column=\"parent_id\" not-null=\"true\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" -msgstr "" - #. Tag: para -#: collection_mapping.xml:894 #, no-c-format msgid "Notice the <literal>NOT NULL</literal> constraint:" msgstr "" -#. Tag: programlisting -#: collection_mapping.xml:898 -#, no-c-format -msgid "" - "<![CDATA[create table parent ( id bigint not null primary key )\n" - "create table child ( id bigint not null\n" - " primary key,\n" - " name varchar(255),\n" - " parent_id bigint not null )\n" - "alter table child add constraint childfk0 (parent_id) references parent]]>" -msgstr "" - #. Tag: para -#: collection_mapping.xml:900 #, no-c-format msgid "Alternatively, if this association must be unidirectional you can declare the <literal>NOT NULL</literal> constraint on the <literal><key></literal> mapping:" msgstr "" -#. Tag: programlisting -#: collection_mapping.xml:906 -#, no-c-format -msgid "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"Parent\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <set name=\"children\">\n" - " <key column=\"parent_id\" not-null=\"true\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </set>\n" - " </class>\n" - "\n" - " <class name=\"Child\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" -msgstr "" - #. Tag: para -#: collection_mapping.xml:908 #, no-c-format msgid "On the other hand, if a child has multiple parents, a many-to-many association is appropriate:" msgstr "" -#. Tag: programlisting -#: collection_mapping.xml:913 -#, no-c-format -msgid "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"Parent\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <set name=\"children\" table=\"childset\">\n" - " <key column=\"parent_id\"/>\n" - " <many-to-many class=\"Child\" column=\"child_id\"/>\n" - " </set>\n" - " </class>\n" - "\n" - " <class name=\"Child\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" -msgstr "" - #. Tag: para -#: collection_mapping.xml:915 #, no-c-format msgid "Table definitions:" msgstr "" -#. Tag: programlisting -#: collection_mapping.xml:919 -#, no-c-format -msgid "" - "<![CDATA[create table parent ( id bigint not null primary key )\n" - "create table child ( id bigint not null primary key, name varchar(255) )\n" - "create table childset ( parent_id bigint not null,\n" - " child_id bigint not null,\n" - " primary key ( parent_id, child_id ) )\n" - "alter table childset add constraint childsetfk0 (parent_id) references parent\n" - "alter table childset add constraint childsetfk1 (child_id) references child]]>" -msgstr "" - #. Tag: para -#: collection_mapping.xml:921 #, no-c-format -msgid "For more examples and a complete explanation of a parent/child relationship mapping, see <xref linkend=\"example-parentchild\"/> for more information." +msgid "For more examples and a complete explanation of a parent/child relationship mapping, see <xref linkend=\"example-parentchild\" /> for more information." msgstr "" #. Tag: para -#: collection_mapping.xml:926 #, no-c-format msgid "Even more complex association mappings are covered in the next chapter." msgstr "" Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/component_mapping.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/component_mapping.pot 2010-02-08 04:50:03 UTC (rev 18716) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/component_mapping.pot 2010-02-08 04:56:55 UTC (rev 18717) @@ -1,481 +1,203 @@ -# SOME DESCRIPTIVE TITLE. -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. # -#, fuzzy msgid "" msgstr "" -"Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-10 21:02+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:18\n" +"PO-Revision-Date: 2010-01-08T04:07:18\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" "MIME-Version: 1.0\n" -"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Type: application/x-publican; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. Tag: title -#: component_mapping.xml:29 #, no-c-format msgid "Component Mapping" msgstr "" #. Tag: para -#: component_mapping.xml:31 #, no-c-format msgid "The notion of a <emphasis>component</emphasis> is re-used in several different contexts and purposes throughout Hibernate." msgstr "" #. Tag: title -#: component_mapping.xml:37 #, no-c-format msgid "Dependent objects" msgstr "" #. Tag: para -#: component_mapping.xml:39 #, no-c-format msgid "A component is a contained object that is persisted as a value type and not an entity reference. The term \"component\" refers to the object-oriented notion of composition and not to architecture-level components. For example, you can model a person like this:" msgstr "" -#. Tag: programlisting -#: component_mapping.xml:45 -#, no-c-format -msgid "" - "<![CDATA[public class Person {\n" - " private java.util.Date birthday;\n" - " private Name name;\n" - " private String key;\n" - " public String getKey() {\n" - " return key;\n" - " }\n" - " private void setKey(String key) {\n" - " this.key=key;\n" - " }\n" - " public java.util.Date getBirthday() {\n" - " return birthday;\n" - " }\n" - " public void setBirthday(java.util.Date birthday) {\n" - " this.birthday = birthday;\n" - " }\n" - " public Name getName() {\n" - " return name;\n" - " }\n" - " public void setName(Name name) {\n" - " this.name = name;\n" - " }\n" - " ......\n" - " ......\n" - "}]]>" -msgstr "" - -#. Tag: programlisting -#: component_mapping.xml:47 -#, no-c-format -msgid "" - "<![CDATA[public class Name {\n" - " char initial;\n" - " String first;\n" - " String last;\n" - " public String getFirst() {\n" - " return first;\n" - " }\n" - " void setFirst(String first) {\n" - " this.first = first;\n" - " }\n" - " public String getLast() {\n" - " return last;\n" - " }\n" - " void setLast(String last) {\n" - " this.last = last;\n" - " }\n" - " public char getInitial() {\n" - " return initial;\n" - " }\n" - " void setInitial(char initial) {\n" - " this.initial = initial;\n" - " }\n" - "}]]>" -msgstr "" - #. Tag: para -#: component_mapping.xml:49 #, no-c-format msgid "Now <literal>Name</literal> can be persisted as a component of <literal>Person</literal>. <literal>Name</literal> defines getter and setter methods for its persistent properties, but it does not need to declare any interfaces or identifier properties." msgstr "" #. Tag: para -#: component_mapping.xml:56 #, no-c-format msgid "Our Hibernate mapping would look like this:" msgstr "" -#. Tag: programlisting -#: component_mapping.xml:60 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"eg.Person\" table=\"person\">\n" - " <id name=\"Key\" column=\"pid\" type=\"string\">\n" - " <generator class=\"uuid\"/>\n" - " </id>\n" - " <property name=\"birthday\" type=\"date\"/>\n" - " <component name=\"Name\" class=\"eg.Name\"> \n" - " <property name=\"initial\"/>\n" - " <property name=\"first\"/>\n" - " <property name=\"last\"/>\n" - " </component>\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: component_mapping.xml:62 #, no-c-format msgid "The person table would have the columns <literal>pid</literal>, <literal>birthday</literal>, <literal>initial</literal>, <literal>first</literal> and <literal>last</literal>." msgstr "" #. Tag: para -#: component_mapping.xml:70 #, no-c-format msgid "Like value types, components do not support shared references. In other words, two persons could have the same name, but the two person objects would contain two independent name objects that were only \"the same\" by value. The null value semantics of a component are <emphasis>ad hoc</emphasis>. When reloading the containing object, Hibernate will assume that if all component columns are null, then the entire component is null. This is suitable for most purposes." msgstr "" #. Tag: para -#: component_mapping.xml:78 #, no-c-format msgid "The properties of a component can be of any Hibernate type (collections, many-to-one associations, other components, etc). Nested components should <emphasis>not</emphasis> be considered an exotic usage. Hibernate is intended to support a fine-grained object model." msgstr "" #. Tag: para -#: component_mapping.xml:85 #, no-c-format msgid "The <literal><component></literal> element allows a <literal><parent></literal> subelement that maps a property of the component class as a reference back to the containing entity." msgstr "" -#. Tag: programlisting -#: component_mapping.xml:91 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"eg.Person\" table=\"person\">\n" - " <id name=\"Key\" column=\"pid\" type=\"string\">\n" - " <generator class=\"uuid\"/>\n" - " </id>\n" - " <property name=\"birthday\" type=\"date\"/>\n" - " <component name=\"Name\" class=\"eg.Name\" unique=\"true\">\n" - " <parent name=\"namedPerson\"/> \n" - " <property name=\"initial\"/>\n" - " <property name=\"first\"/>\n" - " <property name=\"last\"/>\n" - " </component>\n" - "</class>]]>" -msgstr "" - #. Tag: title -#: component_mapping.xml:96 #, no-c-format msgid "Collections of dependent objects" msgstr "" #. Tag: para -#: component_mapping.xml:98 #, no-c-format msgid "Collections of components are supported (e.g. an array of type <literal>Name</literal>). Declare your component collection by replacing the <literal><element></literal> tag with a <literal><composite-element></literal> tag:" msgstr "" -#. Tag: programlisting -#: component_mapping.xml:105 -#, no-c-format -msgid "" - "<![CDATA[<set name=\"someNames\" table=\"some_names\" lazy=\"true\">\n" - " <key column=\"id\"/>\n" - " <composite-element class=\"eg.Name\"> \n" - " <property name=\"initial\"/>\n" - " <property name=\"first\"/>\n" - " <property name=\"last\"/>\n" - " </composite-element>\n" - "</set>]]>" -msgstr "" - #. Tag: para -#: component_mapping.xml:108 #, no-c-format msgid "If you define a <literal>Set</literal> of composite elements, it is important to implement <literal>equals()</literal> and <literal>hashCode()</literal> correctly." msgstr "" #. Tag: para -#: component_mapping.xml:115 #, no-c-format msgid "Composite elements can contain components but not collections. If your composite element contains components, use the <literal><nested-composite-element></literal> tag. This case is a collection of components which themselves have components. You may want to consider if a one-to-many association is more appropriate. Remodel the composite element as an entity, but be aware that even though the Java model is the same, the relational model and persistence semantics are still slightly different." msgstr "" #. Tag: para -#: component_mapping.xml:127 #, no-c-format msgid "A composite element mapping does not support null-able properties if you are using a <literal><set></literal>. There is no separate primary key column in the composite element table. Hibernate uses each column's value to identify a record when deleting objects, which is not possible with null values. You have to either use only not-null properties in a composite-element or choose a <literal><list></literal>, <literal><map></literal>, <literal><bag></literal> or <literal><idbag></literal>." msgstr "" #. Tag: para -#: component_mapping.xml:138 #, no-c-format msgid "A special case of a composite element is a composite element with a nested <literal><many-to-one></literal> element. This mapping allows you to map extra columns of a many-to-many association table to the composite element class. The following is a many-to-many association from <literal>Order</literal> to <literal>Item</literal>, where <literal>purchaseDate</literal>, <literal>price</literal> and <literal>quantity</literal> are properties of the association:" msgstr "" -#. Tag: programlisting -#: component_mapping.xml:148 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"eg.Order\" .... >\n" - " ....\n" - " <set name=\"purchasedItems\" table=\"purchase_items\" lazy=\"true\">\n" - " <key column=\"order_id\">\n" - " <composite-element class=\"eg.Purchase\">\n" - " <property name=\"purchaseDate\"/>\n" - " <property name=\"price\"/>\n" - " <property name=\"quantity\"/>\n" - " <many-to-one name=\"item\" class=\"eg.Item\"/> \n" - " </composite-element>\n" - " </set>\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: component_mapping.xml:150 #, no-c-format msgid "There cannot be a reference to the purchase on the other side for bidirectional association navigation. Components are value types and do not allow shared references. A single <literal>Purchase</literal> can be in the set of an <literal>Order</literal>, but it cannot be referenced by the <literal>Item</literal> at the same time." msgstr "" #. Tag: para -#: component_mapping.xml:158 #, no-c-format msgid "Even ternary (or quaternary, etc) associations are possible:" msgstr "" -#. Tag: programlisting -#: component_mapping.xml:160 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"eg.Order\" .... >\n" - " ....\n" - " <set name=\"purchasedItems\" table=\"purchase_items\" lazy=\"true\">\n" - " <key column=\"order_id\">\n" - " <composite-element class=\"eg.OrderLine\">\n" - " <many-to-one name=\"purchaseDetails class=\"eg.Purchase\"/>\n" - " <many-to-one name=\"item\" class=\"eg.Item\"/>\n" - " </composite-element>\n" - " </set>\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: component_mapping.xml:162 #, no-c-format msgid "Composite elements can appear in queries using the same syntax as associations to other entities." msgstr "" #. Tag: title -#: component_mapping.xml:170 #, no-c-format msgid "Components as Map indices" msgstr "" #. Tag: para -#: component_mapping.xml:172 #, no-c-format msgid "The <literal><composite-map-key></literal> element allows you to map a component class as the key of a <literal>Map</literal>. Ensure that you override <literal>hashCode()</literal> and <literal>equals()</literal> correctly on the component class." msgstr "" #. Tag: title -#: component_mapping.xml:181 #, no-c-format msgid "Components as composite identifiers" msgstr "" #. Tag: para -#: component_mapping.xml:183 #, no-c-format msgid "You can use a component as an identifier of an entity class. Your component class must satisfy certain requirements:" msgstr "" #. Tag: para -#: component_mapping.xml:190 #, no-c-format msgid "It must implement <literal>java.io.Serializable</literal>." msgstr "" #. Tag: para -#: component_mapping.xml:195 #, no-c-format msgid "It must re-implement <literal>equals()</literal> and <literal>hashCode()</literal> consistently with the database's notion of composite key equality." msgstr "" #. Tag: title -#: component_mapping.xml:204 #, no-c-format msgid "Note" msgstr "" #. Tag: para -#: component_mapping.xml:205 #, no-c-format msgid "In Hibernate3, although the second requirement is not an absolutely hard requirement of Hibernate, it is recommended." msgstr "" #. Tag: para -#: component_mapping.xml:211 #, no-c-format msgid "You cannot use an <literal>IdentifierGenerator</literal> to generate composite keys. Instead the application must assign its own identifiers." msgstr "" #. Tag: para -#: component_mapping.xml:216 #, no-c-format msgid "Use the <literal><composite-id></literal> tag, with nested <literal><key-property></literal> elements, in place of the usual <literal><id></literal> declaration. For example, the <literal>OrderLine</literal> class has a primary key that depends upon the (composite) primary key of <literal>Order</literal>." msgstr "" -#. Tag: programlisting -#: component_mapping.xml:224 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"OrderLine\">\n" - " \n" - " <composite-id name=\"id\" class=\"OrderLineId\">\n" - " <key-property name=\"lineId\"/>\n" - " <key-property name=\"orderId\"/>\n" - " <key-property name=\"customerId\"/>\n" - " </composite-id>\n" - " \n" - " <property name=\"name\"/>\n" - " \n" - " <many-to-one name=\"order\" class=\"Order\"\n" - " insert=\"false\" update=\"false\">\n" - " <column name=\"orderId\"/>\n" - " <column name=\"customerId\"/>\n" - " </many-to-one>\n" - " ....\n" - " \n" - "</class>]]>" -msgstr "" - #. Tag: para -#: component_mapping.xml:226 #, no-c-format msgid "Any foreign keys referencing the <literal>OrderLine</literal> table are now composite. Declare this in your mappings for other classes. An association to <literal>OrderLine</literal> is mapped like this:" msgstr "" -#. Tag: programlisting -#: component_mapping.xml:232 -#, no-c-format -msgid "" - "<![CDATA[<many-to-one name=\"orderLine\" class=\"OrderLine\">\n" - "\n" - " <column name=\"lineId\"/>\n" - " <column name=\"orderId\"/>\n" - " <column name=\"customerId\"/>\n" - "</many-to-one>]]>" -msgstr "" - #. Tag: para -#: component_mapping.xml:235 #, no-c-format -msgid "The <literal>column</literal> element is an alternative to the <literal>column</literal> attribute everywhere. Using the <literal>column</literal> element just gives more declaration options, which are mostly useful when utilizing <literal>hbm2ddl</literal>" +msgid "The <literal><column></literal> tag is an alternative to the <literal>column</literal> attribute everywhere. Using the <literal><column></literal> tag just gives more declaration options, which are mostly useful when utilizing <literal>hbm2ddl</literal>." msgstr "" #. Tag: para -#: component_mapping.xml:244 #, no-c-format msgid "A <literal>many-to-many</literal> association to <literal>OrderLine</literal> also uses the composite foreign key:" msgstr "" -#. Tag: programlisting -#: component_mapping.xml:249 -#, no-c-format -msgid "" - "<![CDATA[<set name=\"undeliveredOrderLines\">\n" - " <key column name=\"warehouseId\"/>\n" - " <many-to-many class=\"OrderLine\">\n" - " <column name=\"lineId\"/>\n" - " <column name=\"orderId\"/>\n" - " <column name=\"customerId\"/>\n" - " </many-to-many>\n" - "</set>]]>" -msgstr "" - #. Tag: para -#: component_mapping.xml:251 #, no-c-format msgid "The collection of <literal>OrderLine</literal>s in <literal>Order</literal> would use:" msgstr "" -#. Tag: programlisting -#: component_mapping.xml:256 -#, no-c-format -msgid "" - "<![CDATA[<set name=\"orderLines\" inverse=\"true\">\n" - " <key>\n" - " <column name=\"orderId\"/>\n" - " <column name=\"customerId\"/>\n" - " </key>\n" - " <one-to-many class=\"OrderLine\"/>\n" - "</set>]]>" -msgstr "" - #. Tag: para -#: component_mapping.xml:258 #, no-c-format msgid "The <literal><one-to-many></literal> element declares no columns." msgstr "" #. Tag: para -#: component_mapping.xml:262 #, no-c-format msgid "If <literal>OrderLine</literal> itself owns a collection, it also has a composite foreign key." msgstr "" -#. Tag: programlisting -#: component_mapping.xml:267 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"OrderLine\">\n" - " ....\n" - " ....\n" - " <list name=\"deliveryAttempts\">\n" - " <key> \n" - " <column name=\"lineId\"/>\n" - " <column name=\"orderId\"/>\n" - " <column name=\"customerId\"/>\n" - " </key>\n" - " <list-index column=\"attemptId\" base=\"1\"/>\n" - " <composite-element class=\"DeliveryAttempt\">\n" - " ...\n" - " </composite-element>\n" - " </set>\n" - "</class>]]>" -msgstr "" - #. Tag: title -#: component_mapping.xml:272 #, no-c-format msgid "Dynamic components" msgstr "" #. Tag: para -#: component_mapping.xml:274 #, no-c-format msgid "You can also map a property of type <literal>Map</literal>:" msgstr "" -#. Tag: programlisting -#: component_mapping.xml:278 -#, no-c-format -msgid "" - "<![CDATA[<dynamic-component name=\"userAttributes\">\n" - " <property name=\"foo\" column=\"FOO\" type=\"string\"/>\n" - " <property name=\"bar\" column=\"BAR\" type=\"integer\"/>\n" - " <many-to-one name=\"baz\" class=\"Baz\" column=\"BAZ_ID\"/>\n" - "</dynamic-component>]]>" -msgstr "" - #. Tag: para -#: component_mapping.xml:280 #, no-c-format msgid "The semantics of a <literal><dynamic-component></literal> mapping are identical to <literal><component></literal>. The advantage of this kind of mapping is the ability to determine the actual properties of the bean at deployment time just by editing the mapping document. Runtime manipulation of the mapping document is also possible, using a DOM parser. You can also access, and change, Hibernate's configuration-time metamodel via the <literal>Configuration</literal> object." msgstr "" Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/configuration.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/configuration.pot 2010-02-08 04:50:03 UTC (rev 18716) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/configuration.pot 2010-02-08 04:56:55 UTC (rev 18717) @@ -1,2188 +1,1663 @@ -# SOME DESCRIPTIVE TITLE. -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. # -#, fuzzy msgid "" msgstr "" -"Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-23 18:41+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:18\n" +"PO-Revision-Date: 2010-01-08T04:07:18\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" "MIME-Version: 1.0\n" -"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Type: application/x-publican; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. Tag: title -#: configuration.xml:29 #, no-c-format msgid "Configuration" msgstr "" #. Tag: para -#: configuration.xml:31 #, no-c-format msgid "Hibernate is designed to operate in many different environments and, as such, there is a broad range of configuration parameters. Fortunately, most have sensible default values and Hibernate is distributed with an example <literal>hibernate.properties</literal> file in <literal>etc/</literal> that displays the various options. Simply put the example file in your classpath and customize it to suit your needs." msgstr "" #. Tag: title -#: configuration.xml:40 #, no-c-format msgid "Programmatic configuration" msgstr "" #. Tag: para -#: configuration.xml:42 #, no-c-format msgid "An instance of <classname>org.hibernate.cfg.Configuration</classname> represents an entire set of mappings of an application's Java types to an SQL database. The <classname>org.hibernate.cfg.Configuration</classname> is used to build an immutable <interfacename>org.hibernate.SessionFactory</interfacename>. The mappings are compiled from various XML mapping files." msgstr "" #. Tag: para -#: configuration.xml:49 #, no-c-format msgid "You can obtain a <classname>org.hibernate.cfg.Configuration</classname> instance by instantiating it directly and specifying XML mapping documents. If the mapping files are in the classpath, use <literal>addResource()</literal>. For example:" msgstr "" -#. Tag: programlisting -#: configuration.xml:55 -#, no-c-format -msgid "" - "<![CDATA[Configuration cfg = new Configuration()\n" - " .addResource(\"Item.hbm.xml\")\n" - " .addResource(\"Bid.hbm.xml\");]]>" -msgstr "" - #. Tag: para -#: configuration.xml:57 #, no-c-format msgid "An alternative way is to specify the mapped class and allow Hibernate to find the mapping document for you:" msgstr "" -#. Tag: programlisting -#: configuration.xml:62 -#, no-c-format -msgid "" - "<![CDATA[Configuration cfg = new Configuration()\n" - " .addClass(org.hibernate.auction.Item.class)\n" - " .addClass(org.hibernate.auction.Bid.class);]]>" -msgstr "" - #. Tag: para -#: configuration.xml:64 #, no-c-format msgid "Hibernate will then search for mapping files named <filename>/org/hibernate/auction/Item.hbm.xml</filename> and <filename>/org/hibernate/auction/Bid.hbm.xml</filename> in the classpath. This approach eliminates any hardcoded filenames." msgstr "" #. Tag: para -#: configuration.xml:70 #, no-c-format msgid "A <classname>org.hibernate.cfg.Configuration</classname> also allows you to specify configuration properties. For example:" msgstr "" -#. Tag: programlisting -#: configuration.xml:75 -#, no-c-format -msgid "" - "<![CDATA[Configuration cfg = new Configuration()\n" - " .addClass(org.hibernate.auction.Item.class)\n" - " .addClass(org.hibernate.auction.Bid.class)\n" - " .setProperty(\"hibernate.dialect\", \"org.hibernate.dialect.MySQLInnoDBDialect\")\n" - " .setProperty(\"hibernate.connection.datasource\", \"java:comp/env/jdbc/test\")\n" - " .setProperty(\"hibernate.order_updates\", \"true\");]]>" -msgstr "" - #. Tag: para -#: configuration.xml:77 #, no-c-format msgid "This is not the only way to pass configuration properties to Hibernate. Some alternative options include:" msgstr "" #. Tag: para -#: configuration.xml:84 #, no-c-format msgid "Pass an instance of <classname>java.util.Properties</classname> to <literal>Configuration.setProperties()</literal>." msgstr "" #. Tag: para -#: configuration.xml:90 #, no-c-format msgid "Place a file named <filename>hibernate.properties</filename> in a root directory of the classpath." msgstr "" #. Tag: para -#: configuration.xml:95 #, no-c-format msgid "Set <literal>System</literal> properties using <literal>java -Dproperty=value</literal>." msgstr "" #. Tag: para -#: configuration.xml:100 #, no-c-format msgid "Include <literal><property></literal> elements in <literal>hibernate.cfg.xml</literal> (this is discussed later)." msgstr "" #. Tag: para -#: configuration.xml:107 #, no-c-format msgid "If you want to get started quickly<filename>hibernate.properties</filename> is the easiest approach." msgstr "" #. Tag: para -#: configuration.xml:111 #, no-c-format msgid "The <classname>org.hibernate.cfg.Configuration</classname> is intended as a startup-time object that will be discarded once a <literal>SessionFactory</literal> is created." msgstr "" #. Tag: title -#: configuration.xml:119 #, no-c-format msgid "Obtaining a SessionFactory" msgstr "" #. Tag: para -#: configuration.xml:121 #, no-c-format -msgid "When all mappings have been parsed by the <classname>org.hibernate.cfg.Configuration</classname>, the application must obtain a factory for <interfacename>org.hibernate.Session</interfacename> instances. This factory is intended to be shared by all application threads:" +msgid "When all mappings have been parsed by the <classname>org.hibernate.cfg.Configuration</classname>, the application must obtain a factory for <classname>org.hibernate.Session</classname> instances. This factory is intended to be shared by all application threads:" msgstr "" -#. Tag: programlisting -#: configuration.xml:127 -#, no-c-format -msgid "<![CDATA[SessionFactory sessions = cfg.buildSessionFactory();]]>" -msgstr "" - #. Tag: para -#: configuration.xml:129 #, no-c-format -msgid "Hibernate does allow your application to instantiate more than one <interfacename>org.hibernate.SessionFactory</interfacename>. This is useful if you are using more than one database." +msgid "Hibernate does allow your application to instantiate more than one <classname>org.hibernate.SessionFactory</classname>. This is useful if you are using more than one database." msgstr "" #. Tag: title -#: configuration.xml:138 #, no-c-format msgid "JDBC connections" msgstr "" #. Tag: para -#: configuration.xml:140 #, no-c-format msgid "It is advisable to have the <interfacename>org.hibernate.SessionFactory</interfacename> create and pool JDBC connections for you. If you take this approach, opening a <interfacename>org.hibernate.Session</interfacename> is as simple as:" msgstr "" -#. Tag: programlisting -#: configuration.xml:146 -#, no-c-format -msgid "<![CDATA[Session session = sessions.openSession(); // open a new Session]]>" -msgstr "" - #. Tag: para -#: configuration.xml:148 #, no-c-format msgid "Once you start a task that requires access to the database, a JDBC connection will be obtained from the pool." msgstr "" #. Tag: para -#: configuration.xml:153 #, no-c-format msgid "Before you can do this, you first need to pass some JDBC connection properties to Hibernate. All Hibernate property names and semantics are defined on the class <classname>org.hibernate.cfg.Environment</classname>. The most important settings for JDBC connection configuration are outlined below." msgstr "" #. Tag: para -#: configuration.xml:159 #, no-c-format msgid "Hibernate will obtain and pool connections using <classname>java.sql.DriverManager</classname> if you set the following properties:" msgstr "" #. Tag: title -#: configuration.xml:165 #, no-c-format msgid "Hibernate JDBC Properties" msgstr "" -#. Tag: entry -#: configuration.xml:171 configuration.xml:257 configuration.xml:353 configuration.xml:546 configuration.xml:741 configuration.xml:848 configuration.xml:936 +#. Tag: para #, no-c-format msgid "Property name" msgstr "" -#. Tag: entry -#: configuration.xml:172 configuration.xml:258 configuration.xml:354 configuration.xml:547 configuration.xml:742 configuration.xml:849 configuration.xml:937 +#. Tag: para #, no-c-format msgid "Purpose" msgstr "" -#. Tag: property -#: configuration.xml:178 +#. Tag: para #, no-c-format -msgid "hibernate.connection.driver_class" +msgid "<property>hibernate.connection.driver_class</property>" msgstr "" -#. Tag: emphasis -#: configuration.xml:181 +#. Tag: para #, no-c-format -msgid "JDBC driver class" +msgid "<emphasis>JDBC driver class</emphasis>" msgstr "" -#. Tag: property -#: configuration.xml:186 +#. Tag: para #, no-c-format -msgid "hibernate.connection.url" +msgid "<property>hibernate.connection.url</property>" msgstr "" -#. Tag: emphasis -#: configuration.xml:189 +#. Tag: para #, no-c-format -msgid "JDBC URL" +msgid "<emphasis>JDBC URL</emphasis>" msgstr "" -#. Tag: property -#: configuration.xml:194 configuration.xml:288 +#. Tag: para #, no-c-format -msgid "hibernate.connection.username" +msgid "<property>hibernate.connection.username</property>" msgstr "" -#. Tag: emphasis -#: configuration.xml:197 +#. Tag: para #, no-c-format -msgid "database user" +msgid "<emphasis>database user</emphasis>" msgstr "" -#. Tag: property -#: configuration.xml:202 configuration.xml:296 +#. Tag: para #, no-c-format -msgid "hibernate.connection.password" +msgid "<property>hibernate.connection.password</property>" msgstr "" -#. Tag: emphasis -#: configuration.xml:205 +#. Tag: para #, no-c-format -msgid "database user password" +msgid "<emphasis>database user password</emphasis>" msgstr "" -#. Tag: property -#: configuration.xml:210 +#. Tag: para #, no-c-format -msgid "hibernate.connection.pool_size" +msgid "<property>hibernate.connection.pool_size</property>" msgstr "" -#. Tag: emphasis -#: configuration.xml:213 +#. Tag: para #, no-c-format -msgid "maximum number of pooled connections" +msgid "<emphasis>maximum number of pooled connections</emphasis>" msgstr "" #. Tag: para -#: configuration.xml:220 #, no-c-format msgid "Hibernate's own connection pooling algorithm is, however, quite rudimentary. It is intended to help you get started and is <emphasis>not intended for use in a production system</emphasis>, or even for performance testing. You should use a third party pool for best performance and stability. Just replace the <property>hibernate.connection.pool_size</property> property with connection pool specific settings. This will turn off Hibernate's internal pool. For example, you might like to use c3p0." msgstr "" #. Tag: para -#: configuration.xml:230 #, no-c-format msgid "C3P0 is an open source JDBC connection pool distributed along with Hibernate in the <filename>lib</filename> directory. Hibernate will use its <classname>org.hibernate.connection.C3P0ConnectionProvider</classname> for connection pooling if you set <property>hibernate.c3p0.*</property> properties. If you would like to use Proxool, refer to the packaged <filename>hibernate.properties</filename> and the Hibernate web site for more information." msgstr "" #. Tag: para -#: configuration.xml:238 #, no-c-format msgid "The following is an example <filename>hibernate.properties</filename> file for c3p0:" msgstr "" -#. Tag: programlisting -#: configuration.xml:242 -#, no-c-format -msgid "" - "<![CDATA[hibernate.connection.driver_class = org.postgresql.Driver\n" - "hibernate.connection.url = jdbc:postgresql://localhost/mydatabase\n" - "hibernate.connection.username = myuser\n" - "hibernate.connection.password = secret\n" - "hibernate.c3p0.min_size=5\n" - "hibernate.c3p0.max_size=20\n" - "hibernate.c3p0.timeout=1800\n" - "hibernate.c3p0.max_statements=50\n" - "hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect]]>" -msgstr "" - #. Tag: para -#: configuration.xml:244 #, no-c-format msgid "For use inside an application server, you should almost always configure Hibernate to obtain connections from an application server <interfacename>javax.sql.Datasource</interfacename> registered in JNDI. You will need to set at least one of the following properties:" msgstr "" #. Tag: title -#: configuration.xml:251 #, no-c-format msgid "Hibernate Datasource Properties" msgstr "" -#. Tag: property -#: configuration.xml:264 +#. Tag: para #, no-c-format -msgid "hibernate.connection.datasource" +msgid "<property>hibernate.connection.datasource</property>" msgstr "" -#. Tag: emphasis -#: configuration.xml:267 +#. Tag: para #, no-c-format -msgid "datasource JNDI name" +msgid "<emphasis>datasource JNDI name</emphasis>" msgstr "" -#. Tag: property -#: configuration.xml:272 +#. Tag: para #, no-c-format -msgid "hibernate.jndi.url" +msgid "<property>hibernate.jndi.url</property>" msgstr "" -#. Tag: entry -#: configuration.xml:274 +#. Tag: para #, no-c-format msgid "<emphasis>URL of the JNDI provider</emphasis> (optional)" msgstr "" -#. Tag: property -#: configuration.xml:280 +#. Tag: para #, no-c-format -msgid "hibernate.jndi.class" +msgid "<property>hibernate.jndi.class</property>" msgstr "" -#. Tag: entry -#: configuration.xml:282 +#. Tag: para #, no-c-format msgid "<emphasis>class of the JNDI <literal>InitialContextFactory</literal></emphasis> (optional)" msgstr "" -#. Tag: entry -#: configuration.xml:290 +#. Tag: para #, no-c-format msgid "<emphasis>database user</emphasis> (optional)" msgstr "" -#. Tag: entry -#: configuration.xml:298 +#. Tag: para #, no-c-format msgid "<emphasis>database user password</emphasis> (optional)" msgstr "" #. Tag: para -#: configuration.xml:306 #, no-c-format msgid "Here is an example <filename>hibernate.properties</filename> file for an application server provided JNDI datasource:" msgstr "" -#. Tag: programlisting -#: configuration.xml:311 -#, no-c-format -msgid "" - "<![CDATA[hibernate.connection.datasource = java:/comp/env/jdbc/test\n" - "hibernate.transaction.factory_class = \\\n" - " org.hibernate.transaction.JTATransactionFactory\n" - "hibernate.transaction.manager_lookup_class = \\\n" - " org.hibernate.transaction.JBossTransactionManagerLookup\n" - "hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect]]>" -msgstr "" - #. Tag: para -#: configuration.xml:313 #, no-c-format msgid "JDBC connections obtained from a JNDI datasource will automatically participate in the container-managed transactions of the application server." msgstr "" #. Tag: para -#: configuration.xml:318 #, no-c-format msgid "Arbitrary connection properties can be given by prepending \"<literal>hibernate.connection</literal>\" to the connection property name. For example, you can specify a <property>charSet</property> connection property using <property>hibernate.connection.charSet</property>." msgstr "" #. Tag: para -#: configuration.xml:324 #, no-c-format msgid "You can define your own plugin strategy for obtaining JDBC connections by implementing the interface <interfacename>org.hibernate.connection.ConnectionProvider</interfacename>, and specifying your custom implementation via the <property>hibernate.connection.provider_class</property> property." msgstr "" #. Tag: title -#: configuration.xml:333 #, no-c-format msgid "Optional configuration properties" msgstr "" #. Tag: para -#: configuration.xml:335 #, no-c-format msgid "There are a number of other properties that control the behavior of Hibernate at runtime. All are optional and have reasonable default values." msgstr "" -#. Tag: warning -#: configuration.xml:341 +#. Tag: para #, no-c-format -msgid "<emphasis>Some of these properties are \"system-level\" only.</emphasis> System-level properties can be set only via <literal>java -Dproperty=value</literal> or <filename>hibernate.properties</filename>. They <emphasis>cannot</emphasis> be set by the other techniques described above." +msgid "Some of these properties are system-level only. System-level properties can be set only via <code>java -Dproperty=value</code> or <filename>hibernate.properties</filename>. They <emphasis>cannot</emphasis> be set by the other techniques described above." msgstr "" #. Tag: title -#: configuration.xml:347 #, no-c-format msgid "Hibernate Configuration Properties" msgstr "" -#. Tag: property -#: configuration.xml:360 +#. Tag: para #, no-c-format -msgid "hibernate.dialect" +msgid "<property>hibernate.dialect</property>" msgstr "" -#. Tag: entry -#: configuration.xml:362 +#. Tag: para #, no-c-format msgid "The classname of a Hibernate <classname>org.hibernate.dialect.Dialect</classname> which allows Hibernate to generate SQL optimized for a particular relational database." msgstr "" #. Tag: para -#: configuration.xml:365 #, no-c-format msgid "<emphasis role=\"strong\">e.g.</emphasis> <literal>full.classname.of.Dialect</literal>" msgstr "" #. Tag: para -#: configuration.xml:369 #, no-c-format msgid "In most cases Hibernate will actually be able to choose the correct <classname>org.hibernate.dialect.Dialect</classname> implementation based on the <literal>JDBC metadata</literal> returned by the JDBC driver." msgstr "" -#. Tag: property -#: configuration.xml:378 +#. Tag: para #, no-c-format -msgid "hibernate.show_sql" +msgid "<property>hibernate.show_sql</property>" msgstr "" -#. Tag: entry -#: configuration.xml:380 +#. Tag: para #, no-c-format msgid "Write all SQL statements to console. This is an alternative to setting the log category <literal>org.hibernate.SQL</literal> to <literal>debug</literal>." msgstr "" #. Tag: para -#: configuration.xml:384 configuration.xml:396 configuration.xml:490 configuration.xml:503 configuration.xml:516 configuration.xml:529 configuration.xml:581 configuration.xml:608 configuration.xml:621 configuration.xml:676 configuration.xml:904 configuration.xml:919 configuration.xml:1009 #, no-c-format msgid "<emphasis role=\"strong\">e.g.</emphasis> <literal>true</literal> | <literal>false</literal>" msgstr "" -#. Tag: property -#: configuration.xml:392 +#. Tag: para #, no-c-format -msgid "hibernate.format_sql" +msgid "<property>hibernate.format_sql</property>" msgstr "" -#. Tag: entry -#: configuration.xml:394 +#. Tag: para #, no-c-format msgid "Pretty print the SQL in the log and console." msgstr "" -#. Tag: property -#: configuration.xml:404 +#. Tag: para #, no-c-format -msgid "hibernate.default_schema" +msgid "<property>hibernate.default_schema</property>" msgstr "" -#. Tag: entry -#: configuration.xml:406 +#. Tag: para #, no-c-format msgid "Qualify unqualified table names with the given schema/tablespace in generated SQL." msgstr "" #. Tag: para -#: configuration.xml:409 #, no-c-format msgid "<emphasis role=\"strong\">e.g.</emphasis> <literal>SCHEMA_NAME</literal>" msgstr "" -#. Tag: property -#: configuration.xml:417 +#. Tag: para #, no-c-format -msgid "hibernate.default_catalog" +msgid "<property>hibernate.default_catalog</property>" msgstr "" -#. Tag: entry -#: configuration.xml:419 +#. Tag: para #, no-c-format msgid "Qualifies unqualified table names with the given catalog in generated SQL." msgstr "" #. Tag: para -#: configuration.xml:422 #, no-c-format msgid "<emphasis role=\"strong\">e.g.</emphasis> <literal>CATALOG_NAME</literal>" msgstr "" -#. Tag: property -#: configuration.xml:430 +#. Tag: para #, no-c-format -msgid "hibernate.session_factory_name" +msgid "<property>hibernate.session_factory_name</property>" msgstr "" -#. Tag: entry -#: configuration.xml:432 +#. Tag: para #, no-c-format msgid "The <interfacename>org.hibernate.SessionFactory</interfacename> will be automatically bound to this name in JNDI after it has been created." msgstr "" #. Tag: para -#: configuration.xml:435 configuration.xml:875 #, no-c-format msgid "<emphasis role=\"strong\">e.g.</emphasis> <literal>jndi/composite/name</literal>" msgstr "" -#. Tag: property -#: configuration.xml:443 +#. Tag: para #, no-c-format -msgid "hibernate.max_fetch_depth" +msgid "<property>hibernate.max_fetch_depth</property>" msgstr "" -#. Tag: entry -#: configuration.xml:445 +#. Tag: para #, no-c-format msgid "Sets a maximum \"depth\" for the outer join fetch tree for single-ended associations (one-to-one, many-to-one). A <literal>0</literal> disables default outer join fetching." msgstr "" #. Tag: para -#: configuration.xml:449 #, no-c-format msgid "<emphasis role=\"strong\">e.g.</emphasis> recommended values between <literal>0</literal> and <literal>3</literal>" msgstr "" -#. Tag: property -#: configuration.xml:458 +#. Tag: para #, no-c-format -msgid "hibernate.default_batch_fetch_size" +msgid "<property>hibernate.default_batch_fetch_size</property>" msgstr "" -#. Tag: entry -#: configuration.xml:460 +#. Tag: para #, no-c-format msgid "Sets a default size for Hibernate batch fetching of associations." msgstr "" #. Tag: para -#: configuration.xml:462 #, no-c-format msgid "<emphasis role=\"strong\">e.g.</emphasis> recommended values <literal>4</literal>, <literal>8</literal>, <literal>16</literal>" msgstr "" -#. Tag: property -#: configuration.xml:471 +#. Tag: para #, no-c-format -msgid "hibernate.default_entity_mode" +msgid "<property>hibernate.default_entity_mode</property>" msgstr "" -#. Tag: entry -#: configuration.xml:473 +#. Tag: para #, no-c-format -msgid "Sets a default mode for entity representation for all sessions opened from this <literal>SessionFactory</literal>" +msgid "Sets a default mode for entity representation for all sessions opened from this <literal>SessionFactory</literal>." msgstr "" #. Tag: para -#: configuration.xml:476 #, no-c-format msgid "<literal>dynamic-map</literal>, <literal>dom4j</literal>, <literal>pojo</literal>" msgstr "" -#. Tag: property -#: configuration.xml:484 +#. Tag: para #, no-c-format -msgid "hibernate.order_updates" +msgid "<property>hibernate.order_updates</property>" msgstr "" -#. Tag: entry -#: configuration.xml:486 +#. Tag: para #, no-c-format msgid "Forces Hibernate to order SQL updates by the primary key value of the items being updated. This will result in fewer transaction deadlocks in highly concurrent systems." msgstr "" -#. Tag: property -#: configuration.xml:498 +#. Tag: para #, no-c-format -msgid "hibernate.generate_statistics" +msgid "<property>hibernate.generate_statistics</property>" msgstr "" -#. Tag: entry -#: configuration.xml:500 +#. Tag: para #, no-c-format msgid "If enabled, Hibernate will collect statistics useful for performance tuning." msgstr "" -#. Tag: property -#: configuration.xml:511 +#. Tag: para #, no-c-format -msgid "hibernate.use_identifier_rollback" +msgid "<property>hibernate.use_identifier_rollback</property>" msgstr "" -#. Tag: entry -#: configuration.xml:513 +#. Tag: para #, no-c-format msgid "If enabled, generated identifier properties will be reset to default values when objects are deleted." msgstr "" -#. Tag: property -#: configuration.xml:524 +#. Tag: para #, no-c-format -msgid "hibernate.use_sql_comments" +msgid "<property>hibernate.use_sql_comments</property>" msgstr "" -#. Tag: entry -#: configuration.xml:526 +#. Tag: para #, no-c-format msgid "If turned on, Hibernate will generate comments inside the SQL, for easier debugging, defaults to <literal>false</literal>." msgstr "" #. Tag: title -#: configuration.xml:540 #, no-c-format msgid "Hibernate JDBC and Connection Properties" msgstr "" -#. Tag: property -#: configuration.xml:553 +#. Tag: para #, no-c-format -msgid "hibernate.jdbc.fetch_size" +msgid "<property>hibernate.jdbc.fetch_size</property>" msgstr "" -#. Tag: entry -#: configuration.xml:555 +#. Tag: para #, no-c-format msgid "A non-zero value determines the JDBC fetch size (calls <literal>Statement.setFetchSize()</literal>)." msgstr "" -#. Tag: property -#: configuration.xml:562 +#. Tag: para #, no-c-format -msgid "hibernate.jdbc.batch_size" +msgid "<property>hibernate.jdbc.batch_size</property>" msgstr "" -#. Tag: entry -#: configuration.xml:564 +#. Tag: para #, no-c-format msgid "A non-zero value enables use of JDBC2 batch updates by Hibernate." msgstr "" #. Tag: para -#: configuration.xml:566 #, no-c-format msgid "<emphasis role=\"strong\">e.g.</emphasis> recommended values between <literal>5</literal> and <literal>30</literal>" msgstr "" -#. Tag: property -#: configuration.xml:574 +#. Tag: para #, no-c-format -msgid "hibernate.jdbc.batch_versioned_data" +msgid "<property>hibernate.jdbc.batch_versioned_data</property>" msgstr "" -#. Tag: entry -#: configuration.xml:576 +#. Tag: para #, no-c-format msgid "Set this property to <literal>true</literal> if your JDBC driver returns correct row counts from <literal>executeBatch()</literal>. Iit is usually safe to turn this option on. Hibernate will then use batched DML for automatically versioned data. Defaults to <literal>false</literal>." msgstr "" -#. Tag: property -#: configuration.xml:589 +#. Tag: para #, no-c-format -msgid "hibernate.jdbc.factory_class" +msgid "<property>hibernate.jdbc.factory_class</property>" msgstr "" -#. Tag: entry -#: configuration.xml:591 +#. Tag: para #, no-c-format msgid "Select a custom <interfacename>org.hibernate.jdbc.Batcher</interfacename>. Most applications will not need this configuration property." msgstr "" #. Tag: para -#: configuration.xml:594 #, no-c-format msgid "<emphasis role=\"strong\">e.g.</emphasis> <literal>classname.of.BatcherFactory</literal>" msgstr "" -#. Tag: property -#: configuration.xml:602 +#. Tag: para #, no-c-format -msgid "hibernate.jdbc.use_scrollable_resultset" +msgid "<property>hibernate.jdbc.use_scrollable_resultset</property>" msgstr "" -#. Tag: entry -#: configuration.xml:604 +#. Tag: para #, no-c-format msgid "Enables use of JDBC2 scrollable resultsets by Hibernate. This property is only necessary when using user-supplied JDBC connections. Hibernate uses connection metadata otherwise." msgstr "" -#. Tag: property -#: configuration.xml:616 +#. Tag: para #, no-c-format -msgid "hibernate.jdbc.use_streams_for_binary" +msgid "<property>hibernate.jdbc.use_streams_for_binary</property>" msgstr "" -#. Tag: entry -#: configuration.xml:618 +#. Tag: para #, no-c-format msgid "Use streams when writing/reading <literal>binary</literal> or <literal>serializable</literal> types to/from JDBC. <emphasis>*system-level property*</emphasis>" msgstr "" -#. Tag: property -#: configuration.xml:629 +#. Tag: para #, no-c-format -msgid "hibernate.jdbc.use_get_generated_keys" +msgid "<property>hibernate.jdbc.use_get_generated_keys</property>" msgstr "" -#. Tag: entry -#: configuration.xml:631 +#. Tag: para #, no-c-format msgid "Enables use of JDBC3 <literal>PreparedStatement.getGeneratedKeys()</literal> to retrieve natively generated keys after insert. Requires JDBC3+ driver and JRE1.4+, set to false if your driver has problems with the Hibernate identifier generators. By default, it tries to determine the driver capabilities using connection metadata." msgstr "" #. Tag: para -#: configuration.xml:637 configuration.xml:767 configuration.xml:779 configuration.xml:793 configuration.xml:831 #, no-c-format msgid "<emphasis role=\"strong\">e.g.</emphasis> <literal>true|false</literal>" msgstr "" -#. Tag: property -#: configuration.xml:645 +#. Tag: para #, no-c-format -msgid "hibernate.connection.provider_class" +msgid "<property>hibernate.connection.provider_class</property>" msgstr "" -#. Tag: entry -#: configuration.xml:647 +#. Tag: para #, no-c-format msgid "The classname of a custom <interfacename>org.hibernate.connection.ConnectionProvider</interfacename> which provides JDBC connections to Hibernate." msgstr "" #. Tag: para -#: configuration.xml:650 #, no-c-format msgid "<emphasis role=\"strong\">e.g.</emphasis> <literal>classname.of.ConnectionProvider</literal>" msgstr "" -#. Tag: property -#: configuration.xml:658 +#. Tag: para #, no-c-format -msgid "hibernate.connection.isolation" +msgid "<property>hibernate.connection.isolation</property>" msgstr "" -#. Tag: entry -#: configuration.xml:660 +#. Tag: para #, no-c-format msgid "Sets the JDBC transaction isolation level. Check <interfacename>java.sql.Connection</interfacename> for meaningful values, but note that most databases do not support all isolation levels and some define additional, non-standard isolations." msgstr "" #. Tag: para -#: configuration.xml:664 #, no-c-format msgid "<emphasis role=\"strong\">e.g.</emphasis> <literal>1, 2, 4, 8</literal>" msgstr "" -#. Tag: property -#: configuration.xml:672 +#. Tag: para #, no-c-format -msgid "hibernate.connection.autocommit" +msgid "<property>hibernate.connection.autocommit</property>" msgstr "" -#. Tag: entry -#: configuration.xml:674 +#. Tag: para #, no-c-format msgid "Enables autocommit for JDBC pooled connections (it is not recommended)." msgstr "" -#. Tag: property -#: configuration.xml:684 +#. Tag: para #, no-c-format -msgid "hibernate.connection.release_mode" +msgid "<property>hibernate.connection.release_mode</property>" msgstr "" -#. Tag: entry -#: configuration.xml:686 +#. Tag: para #, no-c-format msgid "Specifies when Hibernate should release JDBC connections. By default, a JDBC connection is held until the session is explicitly closed or disconnected. For an application server JTA datasource, use <literal>after_statement</literal> to aggressively release connections after every JDBC call. For a non-JTA connection, it often makes sense to release the connection at the end of each transaction, by using <literal>after_transaction</literal>. <literal>auto</literal> will choose <literal>after_statement</literal> for the JTA and CMT transaction strategies and <literal>after_transaction</literal> for the JDBC transaction strategy." msgstr "" #. Tag: para -#: configuration.xml:697 #, no-c-format msgid "<emphasis role=\"strong\">e.g.</emphasis> <literal>auto</literal> (default) | <literal>on_close</literal> | <literal>after_transaction</literal> | <literal>after_statement</literal>" msgstr "" #. Tag: para -#: configuration.xml:702 #, no-c-format -msgid "This setting only affects <literal>Session</literal>s returned from <literal>SessionFactory.openSession</literal>. For <literal>Session</literal>s obtained through <literal>SessionFactory.getCurrentSession</literal>, the <literal>CurrentSessionContext</literal> implementation configured for use controls the connection release mode for those <literal>Session</literal>s. See" +msgid "This setting only affects <literal>Session</literal>s returned from <literal>SessionFactory.openSession</literal>. For <literal>Session</literal>s obtained through <literal>SessionFactory.getCurrentSession</literal>, the <literal>CurrentSessionContext</literal> implementation configured for use controls the connection release mode for those <literal>Session</literal>s. See <xref linkend=\"architecture-current-session\" />" msgstr "" -#. Tag: entry -#: configuration.xml:713 +#. Tag: para #, no-c-format msgid "<property>hibernate.connection.</property><emphasis><propertyName></emphasis>" msgstr "" -#. Tag: entry -#: configuration.xml:716 +#. Tag: para #, no-c-format msgid "Pass the JDBC property <emphasis><propertyName></emphasis> to <literal>DriverManager.getConnection()</literal>." msgstr "" -#. Tag: entry -#: configuration.xml:722 +#. Tag: para #, no-c-format msgid "<property>hibernate.jndi.</property><emphasis><propertyName></emphasis>" msgstr "" -#. Tag: entry -#: configuration.xml:725 +#. Tag: para #, no-c-format msgid "Pass the property <emphasis><propertyName></emphasis> to the JNDI <literal>InitialContextFactory</literal>." msgstr "" #. Tag: title -#: configuration.xml:735 #, no-c-format msgid "Hibernate Cache Properties" msgstr "" -#. Tag: literal -#: configuration.xml:748 +#. Tag: para #, no-c-format -msgid "hibernate.cache.provider_class" +msgid "<literal>hibernate.cache.provider_class</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:750 +#. Tag: para #, no-c-format msgid "The classname of a custom <literal>CacheProvider</literal>." msgstr "" #. Tag: para -#: configuration.xml:752 #, no-c-format msgid "<emphasis role=\"strong\">e.g.</emphasis> <literal>classname.of.CacheProvider</literal>" msgstr "" -#. Tag: literal -#: configuration.xml:760 +#. Tag: para #, no-c-format -msgid "hibernate.cache.use_minimal_puts" +msgid "<literal>hibernate.cache.use_minimal_puts</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:762 +#. Tag: para #, no-c-format msgid "Optimizes second-level cache operation to minimize writes, at the cost of more frequent reads. This setting is most useful for clustered caches and, in Hibernate3, is enabled by default for clustered cache implementations." msgstr "" -#. Tag: literal -#: configuration.xml:775 +#. Tag: para #, no-c-format -msgid "hibernate.cache.use_query_cache" +msgid "<literal>hibernate.cache.use_query_cache</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:777 +#. Tag: para #, no-c-format msgid "Enables the query cache. Individual queries still have to be set cachable." msgstr "" -#. Tag: literal -#: configuration.xml:787 +#. Tag: para #, no-c-format -msgid "hibernate.cache.use_second_level_cache" +msgid "<literal>hibernate.cache.use_second_level_cache</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:789 +#. Tag: para #, no-c-format msgid "Can be used to completely disable the second level cache, which is enabled by default for classes which specify a <literal><cache></literal> mapping." msgstr "" -#. Tag: literal -#: configuration.xml:801 +#. Tag: para #, no-c-format -msgid "hibernate.cache.query_cache_factory" +msgid "<literal>hibernate.cache.query_cache_factory</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:803 +#. Tag: para #, no-c-format msgid "The classname of a custom <literal>QueryCache</literal> interface, defaults to the built-in <literal>StandardQueryCache</literal>." msgstr "" #. Tag: para -#: configuration.xml:806 #, no-c-format msgid "<emphasis role=\"strong\">e.g.</emphasis> <literal>classname.of.QueryCache</literal>" msgstr "" -#. Tag: literal -#: configuration.xml:814 +#. Tag: para #, no-c-format -msgid "hibernate.cache.region_prefix" +msgid "<literal>hibernate.cache.region_prefix</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:816 +#. Tag: para #, no-c-format msgid "A prefix to use for second-level cache region names." msgstr "" #. Tag: para -#: configuration.xml:818 #, no-c-format msgid "<emphasis role=\"strong\">e.g.</emphasis> <literal>prefix</literal>" msgstr "" -#. Tag: literal -#: configuration.xml:826 +#. Tag: para #, no-c-format -msgid "hibernate.cache.use_structured_entries" +msgid "<literal>hibernate.cache.use_structured_entries</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:828 +#. Tag: para #, no-c-format msgid "Forces Hibernate to store data in the second-level cache in a more human-friendly format." msgstr "" #. Tag: title -#: configuration.xml:842 #, no-c-format msgid "Hibernate Transaction Properties" msgstr "" -#. Tag: literal -#: configuration.xml:855 +#. Tag: para #, no-c-format -msgid "hibernate.transaction.factory_class" +msgid "<literal>hibernate.transaction.factory_class</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:857 +#. Tag: para #, no-c-format msgid "The classname of a <literal>TransactionFactory</literal> to use with Hibernate <literal>Transaction</literal> API (defaults to <literal>JDBCTransactionFactory</literal>)." msgstr "" #. Tag: para -#: configuration.xml:861 #, no-c-format msgid "<emphasis role=\"strong\">e.g.</emphasis> <literal>classname.of.TransactionFactory</literal>" msgstr "" -#. Tag: literal -#: configuration.xml:869 +#. Tag: para #, no-c-format -msgid "jta.UserTransaction" +msgid "<literal>jta.UserTransaction</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:871 +#. Tag: para #, no-c-format msgid "A JNDI name used by <literal>JTATransactionFactory</literal> to obtain the JTA <literal>UserTransaction</literal> from the application server." msgstr "" -#. Tag: literal -#: configuration.xml:883 +#. Tag: para #, no-c-format -msgid "hibernate.transaction.manager_lookup_class" +msgid "<literal>hibernate.transaction. manager_lookup_class</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:885 +#. Tag: para #, no-c-format msgid "The classname of a <literal>TransactionManagerLookup</literal>. It is required when JVM-level caching is enabled or when using hilo generator in a JTA environment." msgstr "" #. Tag: para -#: configuration.xml:889 #, no-c-format msgid "<emphasis role=\"strong\">e.g.</emphasis> <literal>classname.of.TransactionManagerLookup</literal>" msgstr "" -#. Tag: literal -#: configuration.xml:897 +#. Tag: para #, no-c-format -msgid "hibernate.transaction.flush_before_completion" +msgid "<literal>hibernate.transaction. flush_before_completion</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:899 +#. Tag: para #, no-c-format -msgid "If enabled, the session will be automatically flushed during the before completion phase of the transaction. Built-in and automatic session context management is preferred, see <xref linkend=\"architecture-current-session\"/>." +msgid "If enabled, the session will be automatically flushed during the before completion phase of the transaction. Built-in and automatic session context management is preferred, see <xref linkend=\"architecture-current-session\" />." msgstr "" -#. Tag: literal -#: configuration.xml:912 +#. Tag: para #, no-c-format -msgid "hibernate.transaction.auto_close_session" +msgid "<literal>hibernate.transaction. auto_close_session</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:914 +#. Tag: para #, no-c-format -msgid "If enabled, the session will be automatically closed during the after completion phase of the transaction. Built-in and automatic session context management is preferred, see <xref linkend=\"architecture-current-session\"/>." +msgid "If enabled, the session will be automatically closed during the after completion phase of the transaction. Built-in and automatic session context management is preferred, see <xref linkend=\"architecture-current-session\" />." msgstr "" #. Tag: title -#: configuration.xml:930 #, no-c-format msgid "Miscellaneous Properties" msgstr "" -#. Tag: literal -#: configuration.xml:943 +#. Tag: para #, no-c-format -msgid "hibernate.current_session_context_class" +msgid "<literal>hibernate. current_session_context_class</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:945 +#. Tag: para #, no-c-format -msgid "Supply a custom strategy for the scoping of the \"current\" <literal>Session</literal>. See <xref linkend=\"architecture-current-session\"/> for more information about the built-in strategies." +msgid "Supply a custom strategy for the scoping of the \"current\" <literal>Session</literal>. See <xref linkend=\"architecture-current-session\" /> for more information about the built-in strategies." msgstr "" #. Tag: para -#: configuration.xml:950 #, no-c-format msgid "<emphasis role=\"strong\">e.g.</emphasis> <literal>jta</literal> | <literal>thread</literal> | <literal>managed</literal> | <literal>custom.Class</literal>" msgstr "" -#. Tag: literal -#: configuration.xml:959 +#. Tag: para #, no-c-format -msgid "hibernate.query.factory_class" +msgid "<literal>hibernate.query.factory_class</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:961 +#. Tag: para #, no-c-format msgid "Chooses the HQL parser implementation." msgstr "" #. Tag: para -#: configuration.xml:963 #, no-c-format msgid "<emphasis role=\"strong\">e.g.</emphasis> <literal>org.hibernate.hql.ast.ASTQueryTranslatorFactory</literal> or <literal>org.hibernate.hql.classic.ClassicQueryTranslatorFactory</literal>" msgstr "" -#. Tag: literal -#: configuration.xml:972 +#. Tag: para #, no-c-format -msgid "hibernate.query.substitutions" +msgid "<literal>hibernate.query.substitutions</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:974 +#. Tag: para #, no-c-format msgid "Is used to map from tokens in Hibernate queries to SQL tokens (tokens might be function or literal names, for example)." msgstr "" #. Tag: para -#: configuration.xml:977 #, no-c-format msgid "<emphasis role=\"strong\">e.g.</emphasis> <literal>hqlLiteral=SQL_LITERAL, hqlFunction=SQLFUNC</literal>" msgstr "" -#. Tag: literal -#: configuration.xml:985 +#. Tag: para #, no-c-format -msgid "hibernate.hbm2ddl.auto" +msgid "<literal>hibernate.hbm2ddl.auto</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:987 +#. Tag: para #, no-c-format msgid "Automatically validates or exports schema DDL to the database when the <literal>SessionFactory</literal> is created. With <literal>create-drop</literal>, the database schema will be dropped when the <literal>SessionFactory</literal> is closed explicitly." msgstr "" #. Tag: para -#: configuration.xml:993 #, no-c-format msgid "<emphasis role=\"strong\">e.g.</emphasis> <literal>validate</literal> | <literal>update</literal> | <literal>create</literal> | <literal>create-drop</literal>" msgstr "" -#. Tag: literal -#: configuration.xml:1002 +#. Tag: para #, no-c-format -msgid "hibernate.cglib.use_reflection_optimizer" +msgid "<literal>hibernate.cglib. use_reflection_optimizer</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1004 +#. Tag: para #, no-c-format msgid "Enables the use of CGLIB instead of runtime reflection (System-level property). Reflection can sometimes be useful when troubleshooting. Hibernate always requires CGLIB even if you turn off the optimizer. You cannot set this property in <literal>hibernate.cfg.xml</literal>." msgstr "" #. Tag: title -#: configuration.xml:1020 #, no-c-format msgid "SQL Dialects" msgstr "" #. Tag: para -#: configuration.xml:1022 #, no-c-format msgid "Always set the <literal>hibernate.dialect</literal> property to the correct <literal>org.hibernate.dialect.Dialect</literal> subclass for your database. If you specify a dialect, Hibernate will use sensible defaults for some of the other properties listed above. This means that you will not have to specify them manually." msgstr "" #. Tag: title -#: configuration.xml:1030 #, no-c-format msgid "Hibernate SQL Dialects (<literal>hibernate.dialect</literal>)" msgstr "" -#. Tag: entry -#: configuration.xml:1036 +#. Tag: para #, no-c-format msgid "RDBMS" msgstr "" -#. Tag: entry -#: configuration.xml:1037 +#. Tag: para #, no-c-format msgid "Dialect" msgstr "" -#. Tag: entry -#: configuration.xml:1042 +#. Tag: para #, no-c-format -msgid "<entry>DB2</entry>" +msgid "DB2" msgstr "" -#. Tag: literal -#: configuration.xml:1042 +#. Tag: para #, no-c-format -msgid "org.hibernate.dialect.DB2Dialect" +msgid "<literal>org.hibernate.dialect.DB2Dialect</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1045 +#. Tag: para #, no-c-format msgid "DB2 AS/400" msgstr "" -#. Tag: literal -#: configuration.xml:1045 +#. Tag: para #, no-c-format -msgid "org.hibernate.dialect.DB2400Dialect" +msgid "<literal>org.hibernate.dialect.DB2400Dialect</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1048 +#. Tag: para #, no-c-format msgid "DB2 OS390" msgstr "" -#. Tag: literal -#: configuration.xml:1048 +#. Tag: para #, no-c-format -msgid "org.hibernate.dialect.DB2390Dialect" +msgid "<literal>org.hibernate.dialect.DB2390Dialect</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1051 +#. Tag: para #, no-c-format msgid "PostgreSQL" msgstr "" -#. Tag: literal -#: configuration.xml:1051 +#. Tag: para #, no-c-format -msgid "org.hibernate.dialect.PostgreSQLDialect" +msgid "<literal>org.hibernate.dialect.PostgreSQLDialect</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1054 +#. Tag: para #, no-c-format msgid "MySQL" msgstr "" -#. Tag: literal -#: configuration.xml:1054 +#. Tag: para #, no-c-format -msgid "org.hibernate.dialect.MySQLDialect" +msgid "<literal>org.hibernate.dialect.MySQLDialect</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1057 +#. Tag: para #, no-c-format msgid "MySQL with InnoDB" msgstr "" -#. Tag: literal -#: configuration.xml:1057 +#. Tag: para #, no-c-format -msgid "org.hibernate.dialect.MySQLInnoDBDialect" +msgid "<literal>org.hibernate.dialect.MySQLInnoDBDialect</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1060 +#. Tag: para #, no-c-format msgid "MySQL with MyISAM" msgstr "" -#. Tag: literal -#: configuration.xml:1060 +#. Tag: para #, no-c-format -msgid "org.hibernate.dialect.MySQLMyISAMDialect" +msgid "<literal>org.hibernate.dialect.MySQLMyISAMDialect</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1063 +#. Tag: para #, no-c-format msgid "Oracle (any version)" msgstr "" -#. Tag: literal -#: configuration.xml:1063 +#. Tag: para #, no-c-format -msgid "org.hibernate.dialect.OracleDialect" +msgid "<literal>org.hibernate.dialect.OracleDialect</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1066 +#. Tag: para #, no-c-format msgid "Oracle 9i" msgstr "" -#. Tag: literal -#: configuration.xml:1066 +#. Tag: para #, no-c-format -msgid "org.hibernate.dialect.Oracle9iDialect" +msgid "<literal>org.hibernate.dialect.Oracle9iDialect</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1069 +#. Tag: para #, no-c-format msgid "Oracle 10g" msgstr "" -#. Tag: literal -#: configuration.xml:1069 +#. Tag: para #, no-c-format -msgid "org.hibernate.dialect.Oracle10gDialect" +msgid "<literal>org.hibernate.dialect.Oracle10gDialect</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1072 +#. Tag: para #, no-c-format msgid "Sybase" msgstr "" -#. Tag: literal -#: configuration.xml:1072 +#. Tag: para #, no-c-format -msgid "org.hibernate.dialect.SybaseDialect" +msgid "<literal>org.hibernate.dialect.SybaseDialect</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1075 +#. Tag: para #, no-c-format msgid "Sybase Anywhere" msgstr "" -#. Tag: literal -#: configuration.xml:1075 +#. Tag: para #, no-c-format -msgid "org.hibernate.dialect.SybaseAnywhereDialect" +msgid "<literal>org.hibernate.dialect.SybaseAnywhereDialect</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1078 +#. Tag: para #, no-c-format msgid "Microsoft SQL Server" msgstr "" -#. Tag: literal -#: configuration.xml:1078 +#. Tag: para #, no-c-format -msgid "org.hibernate.dialect.SQLServerDialect" +msgid "<literal>org.hibernate.dialect.SQLServerDialect</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1081 +#. Tag: para #, no-c-format msgid "SAP DB" msgstr "" -#. Tag: literal -#: configuration.xml:1081 +#. Tag: para #, no-c-format -msgid "org.hibernate.dialect.SAPDBDialect" +msgid "<literal>org.hibernate.dialect.SAPDBDialect</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1084 +#. Tag: para #, no-c-format msgid "Informix" msgstr "" -#. Tag: literal -#: configuration.xml:1084 +#. Tag: para #, no-c-format -msgid "org.hibernate.dialect.InformixDialect" +msgid "<literal>org.hibernate.dialect.InformixDialect</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1087 +#. Tag: para #, no-c-format msgid "HypersonicSQL" msgstr "" -#. Tag: literal -#: configuration.xml:1087 +#. Tag: para #, no-c-format -msgid "org.hibernate.dialect.HSQLDialect" +msgid "<literal>org.hibernate.dialect.HSQLDialect</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1090 +#. Tag: para #, no-c-format msgid "Ingres" msgstr "" -#. Tag: literal -#: configuration.xml:1090 +#. Tag: para #, no-c-format -msgid "org.hibernate.dialect.IngresDialect" +msgid "<literal>org.hibernate.dialect.IngresDialect</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1093 +#. Tag: para #, no-c-format msgid "Progress" msgstr "" -#. Tag: literal -#: configuration.xml:1093 +#. Tag: para #, no-c-format -msgid "org.hibernate.dialect.ProgressDialect" +msgid "<literal>org.hibernate.dialect.ProgressDialect</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1096 +#. Tag: para #, no-c-format msgid "Mckoi SQL" msgstr "" -#. Tag: literal -#: configuration.xml:1096 +#. Tag: para #, no-c-format -msgid "org.hibernate.dialect.MckoiDialect" +msgid "<literal>org.hibernate.dialect.MckoiDialect</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1099 +#. Tag: para #, no-c-format msgid "Interbase" msgstr "" -#. Tag: literal -#: configuration.xml:1099 +#. Tag: para #, no-c-format -msgid "org.hibernate.dialect.InterbaseDialect" +msgid "<literal>org.hibernate.dialect.InterbaseDialect</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1102 +#. Tag: para #, no-c-format msgid "Pointbase" msgstr "" -#. Tag: literal -#: configuration.xml:1102 +#. Tag: para #, no-c-format -msgid "org.hibernate.dialect.PointbaseDialect" +msgid "<literal>org.hibernate.dialect.PointbaseDialect</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1105 +#. Tag: para #, no-c-format msgid "FrontBase" msgstr "" -#. Tag: literal -#: configuration.xml:1105 +#. Tag: para #, no-c-format -msgid "org.hibernate.dialect.FrontbaseDialect" +msgid "<literal>org.hibernate.dialect.FrontbaseDialect</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1108 +#. Tag: para #, no-c-format msgid "Firebird" msgstr "" -#. Tag: literal -#: configuration.xml:1108 +#. Tag: para #, no-c-format -msgid "org.hibernate.dialect.FirebirdDialect" +msgid "<literal>org.hibernate.dialect.FirebirdDialect</literal>" msgstr "" #. Tag: title -#: configuration.xml:1117 #, no-c-format msgid "Outer Join Fetching" msgstr "" #. Tag: para -#: configuration.xml:1119 #, no-c-format msgid "If your database supports ANSI, Oracle or Sybase style outer joins, <emphasis>outer join fetching</emphasis> will often increase performance by limiting the number of round trips to and from the database. This is, however, at the cost of possibly more work performed by the database itself. Outer join fetching allows a whole graph of objects connected by many-to-one, one-to-many, many-to-many and one-to-one associations to be retrieved in a single SQL <literal>SELECT</literal>." msgstr "" #. Tag: para -#: configuration.xml:1128 #, no-c-format msgid "Outer join fetching can be disabled <emphasis>globally</emphasis> by setting the property <literal>hibernate.max_fetch_depth</literal> to <literal>0</literal>. A setting of <literal>1</literal> or higher enables outer join fetching for one-to-one and many-to-one associations that have been mapped with <literal>fetch=\"join\"</literal>." msgstr "" #. Tag: para -#: configuration.xml:1136 #, no-c-format -msgid "See <xref linkend=\"performance-fetching\"/> for more information." +msgid "See <xref linkend=\"performance-fetching\" /> for more information." msgstr "" #. Tag: title -#: configuration.xml:1143 #, no-c-format msgid "Binary Streams" msgstr "" #. Tag: para -#: configuration.xml:1145 #, no-c-format msgid "Oracle limits the size of <literal>byte</literal> arrays that can be passed to and/or from its JDBC driver. If you wish to use large instances of <literal>binary</literal> or <literal>serializable</literal> type, you should enable <literal>hibernate.jdbc.use_streams_for_binary</literal>. <emphasis>This is a system-level setting only.</emphasis>" msgstr "" #. Tag: title -#: configuration.xml:1156 #, no-c-format msgid "Second-level and query cache" msgstr "" #. Tag: para -#: configuration.xml:1158 #, no-c-format -msgid "The properties prefixed by <literal>hibernate.cache</literal> allow you to use a process or cluster scoped second-level cache system with Hibernate. See the <xref linkend=\"performance-cache\"/> for more information." +msgid "The properties prefixed by <literal>hibernate.cache</literal> allow you to use a process or cluster scoped second-level cache system with Hibernate. See the <xref linkend=\"performance-cache\" /> for more information." msgstr "" #. Tag: title -#: configuration.xml:1168 #, no-c-format msgid "Query Language Substitution" msgstr "" #. Tag: para -#: configuration.xml:1170 #, no-c-format msgid "You can define new Hibernate query tokens using <literal>hibernate.query.substitutions</literal>. For example:" msgstr "" -#. Tag: programlisting -#: configuration.xml:1175 -#, no-c-format -msgid "hibernate.query.substitutions true=1, false=0" -msgstr "" - #. Tag: para -#: configuration.xml:1177 #, no-c-format msgid "This would cause the tokens <literal>true</literal> and <literal>false</literal> to be translated to integer literals in the generated SQL." msgstr "" -#. Tag: programlisting -#: configuration.xml:1182 -#, no-c-format -msgid "hibernate.query.substitutions toLowercase=LOWER" -msgstr "" - #. Tag: para -#: configuration.xml:1184 #, no-c-format msgid "This would allow you to rename the SQL <literal>LOWER</literal> function." msgstr "" #. Tag: title -#: configuration.xml:1191 #, no-c-format msgid "Hibernate statistics" msgstr "" #. Tag: para -#: configuration.xml:1193 #, no-c-format msgid "If you enable <literal>hibernate.generate_statistics</literal>, Hibernate exposes a number of metrics that are useful when tuning a running system via <literal>SessionFactory.getStatistics()</literal>. Hibernate can even be configured to expose these statistics via JMX. Read the Javadoc of the interfaces in <literal>org.hibernate.stats</literal> for more information." msgstr "" #. Tag: title -#: configuration.xml:1205 #, no-c-format msgid "Logging" msgstr "" #. Tag: para -#: configuration.xml:1207 #, no-c-format msgid "Hibernate utilizes <ulink url=\"http://www.slf4j.org/\">Simple Logging Facade for Java</ulink> (SLF4J) in order to log various system events. SLF4J can direct your logging output to several logging frameworks (NOP, Simple, log4j version 1.2, JDK 1.4 logging, JCL or logback) depending on your chosen binding. In order to setup logging you will need <filename>slf4j-api.jar</filename> in your classpath together with the jar file for your preferred binding - <filename>slf4j-log4j12.jar</filename> in the case of Log4J. See the SLF4J <ulink url=\"http://www.slf4j.org/manual.html\">documentation</ulink> for more detail. To use Log4j you will also need to place a <filename>log4j.properties</filename> file in your classpath. An example properties file is distributed with Hibernate in the <literal>src/</literal> directory." msgstr "" #. Tag: para -#: configuration.xml:1218 #, no-c-format msgid "It is recommended that you familiarize yourself with Hibernate's log messages. A lot of work has been put into making the Hibernate log as detailed as possible, without making it unreadable. It is an essential troubleshooting device. The most interesting log categories are the following:" msgstr "" #. Tag: title -#: configuration.xml:1227 #, no-c-format msgid "Hibernate Log Categories" msgstr "" -#. Tag: entry -#: configuration.xml:1233 +#. Tag: para #, no-c-format msgid "Category" msgstr "" -#. Tag: entry -#: configuration.xml:1234 +#. Tag: para #, no-c-format msgid "Function" msgstr "" -#. Tag: literal -#: configuration.xml:1239 +#. Tag: para #, no-c-format -msgid "org.hibernate.SQL" +msgid "<literal>org.hibernate.SQL</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1240 +#. Tag: para #, no-c-format msgid "Log all SQL DML statements as they are executed" msgstr "" -#. Tag: literal -#: configuration.xml:1243 +#. Tag: para #, no-c-format -msgid "org.hibernate.type" +msgid "<literal>org.hibernate.type</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1244 +#. Tag: para #, no-c-format msgid "Log all JDBC parameters" msgstr "" -#. Tag: literal -#: configuration.xml:1247 +#. Tag: para #, no-c-format -msgid "org.hibernate.tool.hbm2ddl" +msgid "<literal>org.hibernate.tool. hbm2ddl</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1248 +#. Tag: para #, no-c-format msgid "Log all SQL DDL statements as they are executed" msgstr "" -#. Tag: literal -#: configuration.xml:1251 +#. Tag: para #, no-c-format -msgid "org.hibernate.pretty" +msgid "<literal>org.hibernate.pretty</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1252 +#. Tag: para #, no-c-format msgid "Log the state of all entities (max 20 entities) associated with the session at flush time" msgstr "" -#. Tag: literal -#: configuration.xml:1258 +#. Tag: para #, no-c-format -msgid "org.hibernate.cache" +msgid "<literal>org.hibernate.cache</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1259 +#. Tag: para #, no-c-format msgid "Log all second-level cache activity" msgstr "" -#. Tag: literal -#: configuration.xml:1262 +#. Tag: para #, no-c-format -msgid "org.hibernate.transaction" +msgid "<literal>org.hibernate. transaction</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1263 +#. Tag: para #, no-c-format msgid "Log transaction related activity" msgstr "" -#. Tag: literal -#: configuration.xml:1266 +#. Tag: para #, no-c-format -msgid "org.hibernate.jdbc" +msgid "<literal>org.hibernate.jdbc</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1267 +#. Tag: para #, no-c-format msgid "Log all JDBC resource acquisition" msgstr "" -#. Tag: literal -#: configuration.xml:1270 +#. Tag: para #, no-c-format -msgid "org.hibernate.hql.ast.AST" +msgid "<literal>org.hibernate.hql. ast.AST</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1271 +#. Tag: para #, no-c-format msgid "Log HQL and SQL ASTs during query parsing" msgstr "" -#. Tag: literal -#: configuration.xml:1276 +#. Tag: para #, no-c-format -msgid "org.hibernate.secure" +msgid "<literal>org.hibernate.secure</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1277 +#. Tag: para #, no-c-format msgid "Log all JAAS authorization requests" msgstr "" -#. Tag: literal -#: configuration.xml:1280 +#. Tag: para #, no-c-format -msgid "org.hibernate" +msgid "<literal>org.hibernate</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1281 +#. Tag: para #, no-c-format msgid "Log everything. This is a lot of information but it is useful for troubleshooting" msgstr "" #. Tag: para -#: configuration.xml:1290 #, no-c-format msgid "When developing applications with Hibernate, you should almost always work with <literal>debug</literal> enabled for the category <literal>org.hibernate.SQL</literal>, or, alternatively, the property <literal>hibernate.show_sql</literal> enabled." msgstr "" #. Tag: title -#: configuration.xml:1300 #, no-c-format msgid "Implementing a <literal>NamingStrategy</literal>" msgstr "" #. Tag: para -#: configuration.xml:1302 #, no-c-format msgid "The interface <literal>org.hibernate.cfg.NamingStrategy</literal> allows you to specify a \"naming standard\" for database objects and schema elements." msgstr "" #. Tag: para -#: configuration.xml:1307 #, no-c-format msgid "You can provide rules for automatically generating database identifiers from Java identifiers or for processing \"logical\" column and table names given in the mapping file into \"physical\" table and column names. This feature helps reduce the verbosity of the mapping document, eliminating repetitive noise (<literal>TBL_</literal> prefixes, for example). The default strategy used by Hibernate is quite minimal." msgstr "" #. Tag: para -#: configuration.xml:1316 #, no-c-format msgid "You can specify a different strategy by calling <literal>Configuration.setNamingStrategy()</literal> before adding mappings:" msgstr "" -#. Tag: programlisting -#: configuration.xml:1321 -#, no-c-format -msgid "" - "<![CDATA[SessionFactory sf = new Configuration()\n" - " .setNamingStrategy(ImprovedNamingStrategy.INSTANCE)\n" - " .addFile(\"Item.hbm.xml\")\n" - " .addFile(\"Bid.hbm.xml\")\n" - " .buildSessionFactory();]]>" -msgstr "" - #. Tag: para -#: configuration.xml:1323 #, no-c-format msgid "<literal>org.hibernate.cfg.ImprovedNamingStrategy</literal> is a built-in strategy that might be a useful starting point for some applications." msgstr "" #. Tag: title -#: configuration.xml:1331 #, no-c-format msgid "XML configuration file" msgstr "" #. Tag: para -#: configuration.xml:1333 #, no-c-format msgid "An alternative approach to configuration is to specify a full configuration in a file named <literal>hibernate.cfg.xml</literal>. This file can be used as a replacement for the <literal>hibernate.properties</literal> file or, if both are present, to override properties." msgstr "" #. Tag: para -#: configuration.xml:1340 #, no-c-format msgid "The XML configuration file is by default expected to be in the root of your <literal>CLASSPATH</literal>. Here is an example:" msgstr "" -#. Tag: programlisting -#: configuration.xml:1345 -#, no-c-format -msgid "" - "<![CDATA[<?xml version='1.0' encoding='utf-8'?>\n" - "<!DOCTYPE hibernate-configuration PUBLIC\n" - " \"-//Hibernate/Hibernate Configuration DTD//EN\"\n" - " \"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd\">\n" - "\n" - "<hibernate-configuration>\n" - "\n" - " \n" - " <session-factory\n" - " name=\"java:hibernate/SessionFactory\">\n" - "\n" - " \n" - " <property name=\"connection.datasource\">java:/comp/env/jdbc/MyDB</property>\n" - " <property name=\"dialect\">org.hibernate.dialect.MySQLDialect</property>\n" - " <property name=\"show_sql\">false</property>\n" - " <property name=\"transaction.factory_class\">\n" - " org.hibernate.transaction.JTATransactionFactory\n" - " </property>\n" - " <property name=\"jta.UserTransaction\">java:comp/UserTransaction</property>\n" - "\n" - " \n" - " <mapping resource=\"org/hibernate/auction/Item.hbm.xml\"/>\n" - " <mapping resource=\"org/hibernate/auction/Bid.hbm.xml\"/>\n" - "\n" - " \n" - " <class-cache class=\"org.hibernate.auction.Item\" usage=\"read-write\"/>\n" - " <class-cache class=\"org.hibernate.auction.Bid\" usage=\"read-only\"/>\n" - " <collection-cache collection=\"org.hibernate.auction.Item.bids\" usage=\"read-write\"/>\n" - "\n" - " </session-factory>\n" - "\n" - "</hibernate-configuration>]]>" -msgstr "" - #. Tag: para -#: configuration.xml:1347 #, no-c-format msgid "The advantage of this approach is the externalization of the mapping file names to configuration. The <literal>hibernate.cfg.xml</literal> is also more convenient once you have to tune the Hibernate cache. It is your choice to use either <literal>hibernate.properties</literal> or <literal>hibernate.cfg.xml</literal>. Both are equivalent, except for the above mentioned benefits of using the XML syntax." msgstr "" #. Tag: para -#: configuration.xml:1356 #, no-c-format msgid "With the XML configuration, starting Hibernate is then as simple as:" msgstr "" -#. Tag: programlisting -#: configuration.xml:1360 -#, no-c-format -msgid "<![CDATA[SessionFactory sf = new Configuration().configure().buildSessionFactory();]]>" -msgstr "" - #. Tag: para -#: configuration.xml:1362 #, no-c-format msgid "You can select a different XML configuration file using:" msgstr "" -#. Tag: programlisting -#: configuration.xml:1366 -#, no-c-format -msgid "" - "<![CDATA[SessionFactory sf = new Configuration()\n" - " .configure(\"catdb.cfg.xml\")\n" - " .buildSessionFactory();]]>" -msgstr "" - #. Tag: title -#: configuration.xml:1371 #, no-c-format msgid "J2EE Application Server integration" msgstr "" #. Tag: para -#: configuration.xml:1373 #, no-c-format msgid "Hibernate has the following integration points for J2EE infrastructure:" msgstr "" #. Tag: para -#: configuration.xml:1379 #, no-c-format msgid "<emphasis>Container-managed datasources</emphasis>: Hibernate can use JDBC connections managed by the container and provided through JNDI. Usually, a JTA compatible <literal>TransactionManager</literal> and a <literal>ResourceManager</literal> take care of transaction management (CMT), especially distributed transaction handling across several datasources. You can also demarcate transaction boundaries programmatically (BMT), or you might want to use the optional Hibernate <literal>Transaction</literal> API for this to keep your code portable." msgstr "" #. Tag: para -#: configuration.xml:1394 #, no-c-format msgid "<emphasis>Automatic JNDI binding</emphasis>: Hibernate can bind its <literal>SessionFactory</literal> to JNDI after startup." msgstr "" #. Tag: para -#: configuration.xml:1403 #, no-c-format msgid "<emphasis>JTA Session binding:</emphasis> the Hibernate <literal>Session</literal> can be automatically bound to the scope of JTA transactions. Simply lookup the <literal>SessionFactory</literal> from JNDI and get the current <literal>Session</literal>. Let Hibernate manage flushing and closing the <literal>Session</literal> when your JTA transaction completes. Transaction demarcation is either declarative (CMT) or programmatic (BMT/UserTransaction)." msgstr "" #. Tag: para -#: configuration.xml:1416 #, no-c-format msgid "<emphasis>JMX deployment:</emphasis> if you have a JMX capable application server (e.g. JBoss AS), you can choose to deploy Hibernate as a managed MBean. This saves you the one line startup code to build your <literal>SessionFactory</literal> from a <literal>Configuration</literal>. The container will startup your <literal>HibernateService</literal> and also take care of service dependencies (datasource has to be available before Hibernate starts, etc)." msgstr "" #. Tag: para -#: configuration.xml:1427 #, no-c-format msgid "Depending on your environment, you might have to set the configuration option <literal>hibernate.connection.aggressive_release</literal> to true if your application server shows \"connection containment\" exceptions." msgstr "" #. Tag: title -#: configuration.xml:1434 #, no-c-format msgid "Transaction strategy configuration" msgstr "" #. Tag: para -#: configuration.xml:1436 #, no-c-format msgid "The Hibernate <literal>Session</literal> API is independent of any transaction demarcation system in your architecture. If you let Hibernate use JDBC directly through a connection pool, you can begin and end your transactions by calling the JDBC API. If you run in a J2EE application server, you might want to use bean-managed transactions and call the JTA API and <literal>UserTransaction</literal> when needed." msgstr "" #. Tag: para -#: configuration.xml:1444 #, no-c-format msgid "To keep your code portable between these two (and other) environments we recommend the optional Hibernate <literal>Transaction</literal> API, which wraps and hides the underlying system. You have to specify a factory class for <literal>Transaction</literal> instances by setting the Hibernate configuration property <literal>hibernate.transaction.factory_class</literal>." msgstr "" #. Tag: para -#: configuration.xml:1451 #, no-c-format msgid "There are three standard, or built-in, choices:" msgstr "" -#. Tag: literal -#: configuration.xml:1457 +#. Tag: term #, no-c-format -msgid "org.hibernate.transaction.JDBCTransactionFactory" +msgid "<literal>org.hibernate.transaction.JDBCTransactionFactory</literal>" msgstr "" #. Tag: para -#: configuration.xml:1459 #, no-c-format msgid "delegates to database (JDBC) transactions (default)" msgstr "" -#. Tag: literal -#: configuration.xml:1463 +#. Tag: term #, no-c-format -msgid "org.hibernate.transaction.JTATransactionFactory" +msgid "<literal>org.hibernate.transaction.JTATransactionFactory</literal>" msgstr "" #. Tag: para -#: configuration.xml:1465 #, no-c-format msgid "delegates to container-managed transactions if an existing transaction is underway in this context (for example, EJB session bean method). Otherwise, a new transaction is started and bean-managed transactions are used." msgstr "" -#. Tag: literal -#: configuration.xml:1473 +#. Tag: term #, no-c-format -msgid "org.hibernate.transaction.CMTTransactionFactory" +msgid "<literal>org.hibernate.transaction.CMTTransactionFactory</literal>" msgstr "" #. Tag: para -#: configuration.xml:1475 #, no-c-format msgid "delegates to container-managed JTA transactions" msgstr "" #. Tag: para -#: configuration.xml:1480 #, no-c-format msgid "You can also define your own transaction strategies (for a CORBA transaction service, for example)." msgstr "" #. Tag: para -#: configuration.xml:1485 #, no-c-format msgid "Some features in Hibernate (i.e., the second level cache, Contextual Sessions with JTA, etc.) require access to the JTA <literal>TransactionManager</literal> in a managed environment. In an application server, since J2EE does not standardize a single mechanism, you have to specify how Hibernate should obtain a reference to the <literal>TransactionManager</literal>:" msgstr "" #. Tag: title -#: configuration.xml:1493 #, no-c-format msgid "JTA TransactionManagers" msgstr "" -#. Tag: entry -#: configuration.xml:1499 +#. Tag: para #, no-c-format msgid "Transaction Factory" msgstr "" -#. Tag: entry -#: configuration.xml:1500 +#. Tag: para #, no-c-format msgid "Application Server" msgstr "" -#. Tag: literal -#: configuration.xml:1505 +#. Tag: para #, no-c-format -msgid "org.hibernate.transaction.JBossTransactionManagerLookup" +msgid "<literal>org.hibernate.transaction. JBossTransactionManagerLookup</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1506 +#. Tag: para #, no-c-format msgid "JBoss" msgstr "" -#. Tag: literal -#: configuration.xml:1509 +#. Tag: para #, no-c-format -msgid "org.hibernate.transaction.WeblogicTransactionManagerLookup" +msgid "<literal>org.hibernate.transaction. WeblogicTransactionManagerLookup</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1510 +#. Tag: para #, no-c-format msgid "Weblogic" msgstr "" -#. Tag: literal -#: configuration.xml:1513 +#. Tag: para #, no-c-format -msgid "org.hibernate.transaction.WebSphereTransactionManagerLookup" +msgid "<literal>org.hibernate.transaction. WebSphereTransactionManagerLookup</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1514 +#. Tag: para #, no-c-format msgid "WebSphere" msgstr "" -#. Tag: literal -#: configuration.xml:1517 +#. Tag: para #, no-c-format -msgid "org.hibernate.transaction.WebSphereExtendedJTATransactionLookup" +msgid "<literal>org.hibernate.transaction. WebSphereExtendedJTATransactionLookup</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1518 +#. Tag: para #, no-c-format msgid "WebSphere 6" msgstr "" -#. Tag: literal -#: configuration.xml:1521 +#. Tag: para #, no-c-format -msgid "org.hibernate.transaction.OrionTransactionManagerLookup" +msgid "<literal>org.hibernate.transaction. OrionTransactionManagerLookup</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1522 +#. Tag: para #, no-c-format msgid "Orion" msgstr "" -#. Tag: literal -#: configuration.xml:1525 +#. Tag: para #, no-c-format -msgid "org.hibernate.transaction.ResinTransactionManagerLookup" +msgid "<literal>org.hibernate.transaction. ResinTransactionManagerLookup</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1526 +#. Tag: para #, no-c-format msgid "Resin" msgstr "" -#. Tag: literal -#: configuration.xml:1529 +#. Tag: para #, no-c-format -msgid "org.hibernate.transaction.JOTMTransactionManagerLookup" +msgid "<literal>org.hibernate.transaction. JOTMTransactionManagerLookup</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1530 +#. Tag: para #, no-c-format msgid "JOTM" msgstr "" -#. Tag: literal -#: configuration.xml:1533 +#. Tag: para #, no-c-format -msgid "org.hibernate.transaction.JOnASTransactionManagerLookup" +msgid "<literal>org.hibernate.transaction. JOnASTransactionManagerLookup</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1534 +#. Tag: para #, no-c-format msgid "JOnAS" msgstr "" -#. Tag: literal -#: configuration.xml:1537 +#. Tag: para #, no-c-format -msgid "org.hibernate.transaction.JRun4TransactionManagerLookup" +msgid "<literal>org.hibernate.transaction. JRun4TransactionManagerLookup</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1538 +#. Tag: para #, no-c-format msgid "JRun4" msgstr "" -#. Tag: literal -#: configuration.xml:1541 +#. Tag: para #, no-c-format -msgid "org.hibernate.transaction.BESTransactionManagerLookup" +msgid "<literal>org.hibernate.transaction. BESTransactionManagerLookup</literal>" msgstr "" -#. Tag: entry -#: configuration.xml:1542 +#. Tag: para #, no-c-format msgid "Borland ES" msgstr "" #. Tag: title -#: configuration.xml:1551 #, no-c-format msgid "JNDI-bound <literal>SessionFactory</literal>" msgstr "" #. Tag: para -#: configuration.xml:1553 #, no-c-format msgid "A JNDI-bound Hibernate <literal>SessionFactory</literal> can simplify the lookup function of the factory and create new <literal>Session</literal>s. This is not, however, related to a JNDI bound <literal>Datasource</literal>; both simply use the same registry." msgstr "" #. Tag: para -#: configuration.xml:1560 #, no-c-format msgid "If you wish to have the <literal>SessionFactory</literal> bound to a JNDI namespace, specify a name (e.g. <literal>java:hibernate/SessionFactory</literal>) using the property <literal>hibernate.session_factory_name</literal>. If this property is omitted, the <literal>SessionFactory</literal> will not be bound to JNDI. This is especially useful in environments with a read-only JNDI default implementation (in Tomcat, for example)." msgstr "" #. Tag: para -#: configuration.xml:1568 #, no-c-format msgid "When binding the <literal>SessionFactory</literal> to JNDI, Hibernate will use the values of <literal>hibernate.jndi.url</literal>, <literal>hibernate.jndi.class</literal> to instantiate an initial context. If they are not specified, the default <literal>InitialContext</literal> will be used." msgstr "" #. Tag: para -#: configuration.xml:1575 #, no-c-format msgid "Hibernate will automatically place the <literal>SessionFactory</literal> in JNDI after you call <literal>cfg.buildSessionFactory()</literal>. This means you will have this call in some startup code, or utility class in your application, unless you use JMX deployment with the <literal>HibernateService</literal> (this is discussed later in greater detail)." msgstr "" #. Tag: para -#: configuration.xml:1582 #, no-c-format msgid "If you use a JNDI <literal>SessionFactory</literal>, an EJB or any other class, you can obtain the <literal>SessionFactory</literal> using a JNDI lookup." msgstr "" #. Tag: para -#: configuration.xml:1587 #, no-c-format msgid "It is recommended that you bind the <literal>SessionFactory</literal> to JNDI in a managed environment and use a <literal>static</literal> singleton otherwise. To shield your application code from these details, we also recommend to hide the actual lookup code for a <literal>SessionFactory</literal> in a helper class, such as <literal>HibernateUtil.getSessionFactory()</literal>. Note that such a class is also a convenient way to startup Hibernate—see chapter 1." msgstr "" #. Tag: title -#: configuration.xml:1599 #, no-c-format msgid "Current Session context management with JTA" msgstr "" #. Tag: para -#: configuration.xml:1601 #, no-c-format -msgid "The easiest way to handle <literal>Sessions</literal> and transactions is Hibernate's automatic \"current\" <literal>Session</literal> management. For a discussion of contextual sessions see <xref linkend=\"architecture-current-session\"/>. Using the <literal>\"jta\"</literal> session context, if there is no Hibernate <literal>Session</literal> associated with the current JTA transaction, one will be started and associated with that JTA transaction the first time you call <literal>sessionFactory.getCurrentSession()</literal>. The <literal>Session</literal>s retrieved via <literal>getCurrentSession()</literal> in the<literal>\"jta\"</literal> context are set to automatically flush before the transaction completes, close after the transaction completes, and aggressively release JDBC connections after each statement. This allows the <literal>Session</literal>s to be managed by the life cycle of the JTA transaction to which it is associated, keeping user code clean of su! ch management concerns. Your code can either use JTA programmatically through <literal>UserTransaction</literal>, or (recommended for portable code) use the Hibernate <literal>Transaction</literal> API to set transaction boundaries. If you run in an EJB container, declarative transaction demarcation with CMT is preferred." +msgid "The easiest way to handle <literal>Sessions</literal> and transactions is Hibernate's automatic \"current\" <literal>Session</literal> management. For a discussion of contextual sessions see <xref linkend=\"architecture-current-session\" />. Using the <literal>\"jta\"</literal> session context, if there is no Hibernate <literal>Session</literal> associated with the current JTA transaction, one will be started and associated with that JTA transaction the first time you call <literal>sessionFactory.getCurrentSession()</literal>. The <literal>Session</literal>s retrieved via <literal>getCurrentSession()</literal> in the<literal>\"jta\"</literal> context are set to automatically flush before the transaction completes, close after the transaction completes, and aggressively release JDBC connections after each statement. This allows the <literal>Session</literal>s to be managed by the life cycle of the JTA transaction to which it is associated, keeping user code clean of s! uch management concerns. Your code can either use JTA programmatically through <literal>UserTransaction</literal>, or (recommended for portable code) use the Hibernate <literal>Transaction</literal> API to set transaction boundaries. If you run in an EJB container, declarative transaction demarcation with CMT is preferred." msgstr "" #. Tag: title -#: configuration.xml:1624 #, no-c-format msgid "JMX deployment" msgstr "" #. Tag: para -#: configuration.xml:1626 #, no-c-format msgid "The line <literal>cfg.buildSessionFactory()</literal> still has to be executed somewhere to get a <literal>SessionFactory</literal> into JNDI. You can do this either in a <literal>static</literal> initializer block, like the one in <literal>HibernateUtil</literal>, or you can deploy Hibernate as a <emphasis>managed service</emphasis>." msgstr "" #. Tag: para -#: configuration.xml:1634 #, no-c-format msgid "Hibernate is distributed with <literal>org.hibernate.jmx.HibernateService</literal> for deployment on an application server with JMX capabilities, such as JBoss AS. The actual deployment and configuration is vendor-specific. Here is an example <literal>jboss-service.xml</literal> for JBoss 4.0.x:" msgstr "" -#. Tag: programlisting -#: configuration.xml:1641 -#, no-c-format -msgid "" - "<![CDATA[<?xml version=\"1.0\"?>\n" - "<server>\n" - "\n" - "<mbean code=\"org.hibernate.jmx.HibernateService\"\n" - " name=\"jboss.jca:service=HibernateFactory,name=HibernateFactory\">\n" - "\n" - " \n" - " <depends>jboss.jca:service=RARDeployer</depends>\n" - " <depends>jboss.jca:service=LocalTxCM,name=HsqlDS</depends>\n" - "\n" - " \n" - " <attribute name=\"JndiName\">java:/hibernate/SessionFactory</attribute>\n" - "\n" - " \n" - " <attribute name=\"Datasource\">java:HsqlDS</attribute>\n" - " <attribute name=\"Dialect\">org.hibernate.dialect.HSQLDialect</attribute>\n" - "\n" - " \n" - " <attribute name=\"TransactionStrategy\">\n" - " org.hibernate.transaction.JTATransactionFactory</attribute>\n" - " <attribute name=\"TransactionManagerLookupStrategy\">\n" - " org.hibernate.transaction.JBossTransactionManagerLookup</attribute>\n" - " <attribute name=\"FlushBeforeCompletionEnabled\">true</attribute>\n" - " <attribute name=\"AutoCloseSessionEnabled\">true</attribute>\n" - "\n" - " \n" - " <attribute name=\"MaximumFetchDepth\">5</attribute>\n" - "\n" - " \n" - " <attribute name=\"SecondLevelCacheEnabled\">true</attribute>\n" - " <attribute name=\"CacheProviderClass\">org.hibernate.cache.EhCacheProvider</attribute>\n" - " <attribute name=\"QueryCacheEnabled\">true</attribute>\n" - "\n" - " \n" - " <attribute name=\"ShowSqlEnabled\">true</attribute>\n" - "\n" - " \n" - " <attribute name=\"MapResources\">auction/Item.hbm.xml,auction/Category.hbm.xml</attribute>\n" - "\n" - "</mbean>\n" - "\n" - "</server>]]>" -msgstr "" - #. Tag: para -#: configuration.xml:1643 #, no-c-format msgid "This file is deployed in a directory called <literal>META-INF</literal> and packaged in a JAR file with the extension <literal>.sar</literal> (service archive). You also need to package Hibernate, its required third-party libraries, your compiled persistent classes, as well as your mapping files in the same archive. Your enterprise beans (usually session beans) can be kept in their own JAR file, but you can include this EJB JAR file in the main service archive to get a single (hot-)deployable unit. Consult the JBoss AS documentation for more information about JMX service and EJB deployment." msgstr "" Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/events.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/events.pot 2010-02-08 04:50:03 UTC (rev 18716) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/events.pot 2010-02-08 04:56:55 UTC (rev 18717) @@ -1,310 +1,128 @@ -# SOME DESCRIPTIVE TITLE. -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. # -#, fuzzy msgid "" msgstr "" -"Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-10 21:02+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:19\n" +"PO-Revision-Date: 2010-01-08T04:07:19\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" "MIME-Version: 1.0\n" -"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Type: application/x-publican; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. Tag: title -#: events.xml:29 #, no-c-format msgid "Interceptors and events" msgstr "" #. Tag: para -#: events.xml:31 #, no-c-format msgid "It is useful for the application to react to certain events that occur inside Hibernate. This allows for the implementation of generic functionality and the extension of Hibernate functionality." msgstr "" #. Tag: title -#: events.xml:38 #, no-c-format msgid "Interceptors" msgstr "" #. Tag: para -#: events.xml:40 #, no-c-format msgid "The <literal>Interceptor</literal> interface provides callbacks from the session to the application, allowing the application to inspect and/or manipulate properties of a persistent object before it is saved, updated, deleted or loaded. One possible use for this is to track auditing information. For example, the following <literal>Interceptor</literal> automatically sets the <literal>createTimestamp</literal> when an <literal>Auditable</literal> is created and updates the <literal>lastUpdateTimestamp</literal> property when an <literal>Auditable</literal> is updated." msgstr "" #. Tag: para -#: events.xml:51 #, no-c-format msgid "You can either implement <literal>Interceptor</literal> directly or extend <literal>EmptyInterceptor</literal>." msgstr "" -#. Tag: programlisting -#: events.xml:56 -#, no-c-format -msgid "" - "<![CDATA[package org.hibernate.test;\n" - "\n" - "import java.io.Serializable;\n" - "import java.util.Date;\n" - "import java.util.Iterator;\n" - "\n" - "import org.hibernate.EmptyInterceptor;\n" - "import org.hibernate.Transaction;\n" - "import org.hibernate.type.Type;\n" - "\n" - "public class AuditInterceptor extends EmptyInterceptor {\n" - "\n" - " private int updates;\n" - " private int creates;\n" - " private int loads;\n" - "\n" - " public void onDelete(Object entity,\n" - " Serializable id,\n" - " Object[] state,\n" - " String[] propertyNames,\n" - " Type[] types) {\n" - " // do nothing\n" - " }\n" - "\n" - " public boolean onFlushDirty(Object entity,\n" - " Serializable id,\n" - " Object[] currentState,\n" - " Object[] previousState,\n" - " String[] propertyNames,\n" - " Type[] types) {\n" - "\n" - " if ( entity instanceof Auditable ) {\n" - " updates++;\n" - " for ( int i=0; i < propertyNames.length; i++ ) {\n" - " if ( \"lastUpdateTimestamp\".equals( propertyNames[i] ) ) {\n" - " currentState[i] = new Date();\n" - " return true;\n" - " }\n" - " }\n" - " }\n" - " return false;\n" - " }\n" - "\n" - " public boolean onLoad(Object entity,\n" - " Serializable id,\n" - " Object[] state,\n" - " String[] propertyNames,\n" - " Type[] types) {\n" - " if ( entity instanceof Auditable ) {\n" - " loads++;\n" - " }\n" - " return false;\n" - " }\n" - "\n" - " public boolean onSave(Object entity,\n" - " Serializable id,\n" - " Object[] state,\n" - " String[] propertyNames,\n" - " Type[] types) {\n" - "\n" - " if ( entity instanceof Auditable ) {\n" - " creates++;\n" - " for ( int i=0; i<propertyNames.length; i++ ) {\n" - " if ( \"createTimestamp\".equals( propertyNames[i] ) ) {\n" - " state[i] = new Date();\n" - " return true;\n" - " }\n" - " }\n" - " }\n" - " return false;\n" - " }\n" - "\n" - " public void afterTransactionCompletion(Transaction tx) {\n" - " if ( tx.wasCommitted() ) {\n" - " System.out.println(\"Creations: \" + creates + \", Updates: \" + updates, \"Loads: \" + loads);\n" - " }\n" - " updates=0;\n" - " creates=0;\n" - " loads=0;\n" - " }\n" - "\n" - "}]]>" -msgstr "" - #. Tag: para -#: events.xml:58 #, no-c-format msgid "There are two kinds of inteceptors: <literal>Session</literal>-scoped and <literal>SessionFactory</literal>-scoped." msgstr "" #. Tag: para -#: events.xml:63 #, no-c-format msgid "A <literal>Session</literal>-scoped interceptor is specified when a session is opened using one of the overloaded SessionFactory.openSession() methods accepting an <literal>Interceptor</literal>." msgstr "" -#. Tag: programlisting -#: events.xml:69 -#, no-c-format -msgid "<![CDATA[Session session = sf.openSession( new AuditInterceptor() );]]>" -msgstr "" - #. Tag: para -#: events.xml:71 #, no-c-format msgid "A <literal>SessionFactory</literal>-scoped interceptor is registered with the <literal>Configuration</literal> object prior to building the <literal>SessionFactory</literal>. Unless a session is opened explicitly specifying the interceptor to use, the supplied interceptor will be applied to all sessions opened from that <literal>SessionFactory</literal>. <literal>SessionFactory</literal>-scoped interceptors must be thread safe. Ensure that you do not store session-specific states, since multiple sessions will use this interceptor potentially concurrently." msgstr "" -#. Tag: programlisting -#: events.xml:80 -#, no-c-format -msgid "<![CDATA[new Configuration().setInterceptor( new AuditInterceptor() );]]>" -msgstr "" - #. Tag: title -#: events.xml:85 #, no-c-format msgid "Event system" msgstr "" #. Tag: para -#: events.xml:87 #, no-c-format msgid "If you have to react to particular events in your persistence layer, you can also use the Hibernate3 <emphasis>event</emphasis> architecture. The event system can be used in addition, or as a replacement, for interceptors." msgstr "" #. Tag: para -#: events.xml:93 #, no-c-format msgid "All the methods of the <literal>Session</literal> interface correlate to an event. You have a <literal>LoadEvent</literal>, a <literal>FlushEvent</literal>, etc. Consult the XML configuration-file DTD or the <literal>org.hibernate.event</literal> package for the full list of defined event types. When a request is made of one of these methods, the Hibernate <literal>Session</literal> generates an appropriate event and passes it to the configured event listeners for that type. Out-of-the-box, these listeners implement the same processing in which those methods always resulted. However, you are free to implement a customization of one of the listener interfaces (i.e., the <literal>LoadEvent</literal> is processed by the registered implementation of the <literal>LoadEventListener</literal> interface), in which case their implementation would be responsible for processing any <literal>load()</literal> requests made of the <literal>Session</literal>." msgstr "" #. Tag: para -#: events.xml:108 #, no-c-format msgid "The listeners should be considered singletons. This means they are shared between requests, and should not save any state as instance variables." msgstr "" #. Tag: para -#: events.xml:113 #, no-c-format msgid "A custom listener implements the appropriate interface for the event it wants to process and/or extend one of the convenience base classes (or even the default event listeners used by Hibernate out-of-the-box as these are declared non-final for this purpose). Custom listeners can either be registered programmatically through the <literal>Configuration</literal> object, or specified in the Hibernate configuration XML. Declarative configuration through the properties file is not supported. Here is an example of a custom load event listener:" msgstr "" -#. Tag: programlisting -#: events.xml:123 -#, no-c-format -msgid "" - "<![CDATA[public class MyLoadListener implements LoadEventListener {\n" - " // this is the single method defined by the LoadEventListener interface\n" - " public void onLoad(LoadEvent event, LoadEventListener.LoadType loadType)\n" - " throws HibernateException {\n" - " if ( !MySecurity.isAuthorized( event.getEntityClassName(), event.getEntityId() ) ) {\n" - " throw MySecurityException(\"Unauthorized access\");\n" - " }\n" - " }\n" - "}]]>" -msgstr "" - #. Tag: para -#: events.xml:125 #, no-c-format msgid "You also need a configuration entry telling Hibernate to use the listener in addition to the default listener:" msgstr "" -#. Tag: programlisting -#: events.xml:130 -#, no-c-format -msgid "" - "<![CDATA[<hibernate-configuration>\n" - " <session-factory>\n" - " ...\n" - " <event type=\"load\">\n" - " <listener class=\"com.eg.MyLoadListener\"/>\n" - " <listener class=\"org.hibernate.event.def.DefaultLoadEventListener\"/>\n" - " </event>\n" - " </session-factory>\n" - "</hibernate-configuration>]]>" -msgstr "" - #. Tag: para -#: events.xml:132 #, no-c-format msgid "Instead, you can register it programmatically:" msgstr "" -#. Tag: programlisting -#: events.xml:136 -#, no-c-format -msgid "" - "<![CDATA[Configuration cfg = new Configuration();\n" - "LoadEventListener[] stack = { new MyLoadListener(), new DefaultLoadEventListener() };\n" - "cfg.EventListeners().setLoadEventListeners(stack);]]>" -msgstr "" - #. Tag: para -#: events.xml:138 #, no-c-format msgid "Listeners registered declaratively cannot share instances. If the same class name is used in multiple <literal><listener/></literal> elements, each reference will result in a separate instance of that class. If you need to share listener instances between listener types you must use the programmatic registration approach." msgstr "" #. Tag: para -#: events.xml:146 #, no-c-format msgid "Why implement an interface and define the specific type during configuration? A listener implementation could implement multiple event listener interfaces. Having the type additionally defined during registration makes it easier to turn custom listeners on or off during configuration." msgstr "" #. Tag: title -#: events.xml:156 #, no-c-format msgid "Hibernate declarative security" msgstr "" #. Tag: para -#: events.xml:157 #, no-c-format msgid "Usually, declarative security in Hibernate applications is managed in a session facade layer. Hibernate3 allows certain actions to be permissioned via JACC, and authorized via JAAS. This is an optional functionality that is built on top of the event architecture." msgstr "" #. Tag: para -#: events.xml:163 #, no-c-format msgid "First, you must configure the appropriate event listeners, to enable the use of JAAS authorization." msgstr "" -#. Tag: programlisting -#: events.xml:168 -#, no-c-format -msgid "" - "<![CDATA[<listener type=\"pre-delete\" class=\"org.hibernate.secure.JACCPreDeleteEventListener\"/>\n" - "<listener type=\"pre-update\" class=\"org.hibernate.secure.JACCPreUpdateEventListener\"/>\n" - "<listener type=\"pre-insert\" class=\"org.hibernate.secure.JACCPreInsertEventListener\"/>\n" - "<listener type=\"pre-load\" class=\"org.hibernate.secure.JACCPreLoadEventListener\"/>]]>" -msgstr "" - #. Tag: para -#: events.xml:170 #, no-c-format msgid "Note that <literal><listener type=\"...\" class=\"...\"/></literal> is shorthand for <literal><event type=\"...\"><listener class=\"...\"/></event></literal> when there is exactly one listener for a particular event type." msgstr "" #. Tag: para -#: events.xml:176 #, no-c-format msgid "Next, while still in <literal>hibernate.cfg.xml</literal>, bind the permissions to roles:" msgstr "" -#. Tag: programlisting -#: events.xml:180 -#, no-c-format -msgid "" - "<![CDATA[<grant role=\"admin\" entity-name=\"User\" actions=\"insert,update,read\"/>\n" - "<grant role=\"su\" entity-name=\"User\" actions=\"*\"/>]]>" -msgstr "" - #. Tag: para -#: events.xml:182 #, no-c-format msgid "The role names are the roles understood by your JACC provider." msgstr "" Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/example_mappings.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/example_mappings.pot 2010-02-08 04:50:03 UTC (rev 18716) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/example_mappings.pot 2010-02-08 04:56:55 UTC (rev 18717) @@ -1,717 +1,119 @@ -# SOME DESCRIPTIVE TITLE. -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. # -#, fuzzy msgid "" msgstr "" -"Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-10 21:02+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:19\n" +"PO-Revision-Date: 2010-01-08T04:07:19\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" "MIME-Version: 1.0\n" -"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Type: application/x-publican; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. Tag: title -#: example_mappings.xml:29 #, no-c-format msgid "Example: Various Mappings" msgstr "" #. Tag: para -#: example_mappings.xml:32 #, no-c-format msgid "This chapters explores some more complex association mappings." msgstr "" #. Tag: title -#: example_mappings.xml:37 #, no-c-format msgid "Employer/Employee" msgstr "" #. Tag: para -#: example_mappings.xml:39 #, no-c-format msgid "The following model of the relationship between <literal>Employer</literal> and <literal>Employee</literal> uses an entity class (<literal>Employment</literal>) to represent the association. You can do this when there might be more than one period of employment for the same two parties. Components are used to model monetary values and employee names." msgstr "" #. Tag: para -#: example_mappings.xml:56 #, no-c-format msgid "Here is a possible mapping document:" msgstr "" -#. Tag: programlisting -#: example_mappings.xml:60 -#, no-c-format -msgid "" - "<![CDATA[<hibernate-mapping>\n" - " \n" - " <class name=\"Employer\" table=\"employers\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\">\n" - " <param name=\"sequence\">employer_id_seq</param>\n" - " </generator>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " </class>\n" - "\n" - " <class name=\"Employment\" table=\"employment_periods\">\n" - "\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\">\n" - " <param name=\"sequence\">employment_id_seq</param>\n" - " </generator>\n" - " </id>\n" - " <property name=\"startDate\" column=\"start_date\"/>\n" - " <property name=\"endDate\" column=\"end_date\"/>\n" - "\n" - " <component name=\"hourlyRate\" class=\"MonetaryAmount\">\n" - " <property name=\"amount\">\n" - " <column name=\"hourly_rate\" sql-type=\"NUMERIC(12, 2)\"/>\n" - " </property>\n" - " <property name=\"currency\" length=\"12\"/>\n" - " </component>\n" - "\n" - " <many-to-one name=\"employer\" column=\"employer_id\" not-null=\"true\"/>\n" - " <many-to-one name=\"employee\" column=\"employee_id\" not-null=\"true\"/>\n" - "\n" - " </class>\n" - "\n" - " <class name=\"Employee\" table=\"employees\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\">\n" - " <param name=\"sequence\">employee_id_seq</param>\n" - " </generator>\n" - " </id>\n" - " <property name=\"taxfileNumber\"/>\n" - " <component name=\"name\" class=\"Name\">\n" - " <property name=\"firstName\"/>\n" - " <property name=\"initial\"/>\n" - " <property name=\"lastName\"/>\n" - " </component>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" -msgstr "" - #. Tag: para -#: example_mappings.xml:62 #, no-c-format msgid "Here is the table schema generated by <literal>SchemaExport</literal>." msgstr "" -#. Tag: programlisting -#: example_mappings.xml:66 -#, no-c-format -msgid "" - "<![CDATA[create table employers (\n" - " id BIGINT not null, \n" - " name VARCHAR(255), \n" - " primary key (id)\n" - ")\n" - "\n" - "create table employment_periods (\n" - " id BIGINT not null,\n" - " hourly_rate NUMERIC(12, 2),\n" - " currency VARCHAR(12), \n" - " employee_id BIGINT not null, \n" - " employer_id BIGINT not null, \n" - " end_date TIMESTAMP, \n" - " start_date TIMESTAMP, \n" - " primary key (id)\n" - ")\n" - "\n" - "create table employees (\n" - " id BIGINT not null, \n" - " firstName VARCHAR(255), \n" - " initial CHAR(1), \n" - " lastName VARCHAR(255), \n" - " taxfileNumber VARCHAR(255), \n" - " primary key (id)\n" - ")\n" - "\n" - "alter table employment_periods \n" - " add constraint employment_periodsFK0 foreign key (employer_id) references employers\n" - "alter table employment_periods \n" - " add constraint employment_periodsFK1 foreign key (employee_id) references employees\n" - "create sequence employee_id_seq\n" - "create sequence employment_id_seq\n" - "create sequence employer_id_seq]]>" -msgstr "" - #. Tag: title -#: example_mappings.xml:71 #, no-c-format msgid "Author/Work" msgstr "" #. Tag: para -#: example_mappings.xml:73 #, no-c-format msgid "Consider the following model of the relationships between <literal>Work</literal>, <literal>Author</literal> and <literal>Person</literal>. In the example, the relationship between <literal>Work</literal> and <literal>Author</literal> is represented as a many-to-many association and the relationship between <literal>Author</literal> and <literal>Person</literal> is represented as one-to-one association. Another possibility would be to have <literal>Author</literal> extend <literal>Person</literal>." msgstr "" #. Tag: para -#: example_mappings.xml:91 #, no-c-format msgid "The following mapping document correctly represents these relationships:" msgstr "" -#. Tag: programlisting -#: example_mappings.xml:95 -#, no-c-format -msgid "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"Work\" table=\"works\" discriminator-value=\"W\">\n" - "\n" - " <id name=\"id\" column=\"id\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <discriminator column=\"type\" type=\"character\"/>\n" - "\n" - " <property name=\"title\"/>\n" - " <set name=\"authors\" table=\"author_work\">\n" - " <key column name=\"work_id\"/>\n" - " <many-to-many class=\"Author\" column name=\"author_id\"/>\n" - " </set>\n" - "\n" - " <subclass name=\"Book\" discriminator-value=\"B\">\n" - " <property name=\"text\"/>\n" - " </subclass>\n" - "\n" - " <subclass name=\"Song\" discriminator-value=\"S\">\n" - " <property name=\"tempo\"/>\n" - " <property name=\"genre\"/>\n" - " </subclass>\n" - "\n" - " </class>\n" - "\n" - " <class name=\"Author\" table=\"authors\">\n" - "\n" - " <id name=\"id\" column=\"id\">\n" - " \n" - " <generator class=\"assigned\"/> \n" - " </id>\n" - "\n" - " <property name=\"alias\"/>\n" - " <one-to-one name=\"person\" constrained=\"true\"/>\n" - "\n" - " <set name=\"works\" table=\"author_work\" inverse=\"true\">\n" - " <key column=\"author_id\"/>\n" - " <many-to-many class=\"Work\" column=\"work_id\"/>\n" - " </set>\n" - "\n" - " </class>\n" - "\n" - " <class name=\"Person\" table=\"persons\">\n" - " <id name=\"id\" column=\"id\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" -msgstr "" - #. Tag: para -#: example_mappings.xml:97 #, no-c-format msgid "There are four tables in this mapping: <literal>works</literal>, <literal>authors</literal> and <literal>persons</literal> hold work, author and person data respectively. <literal>author_work</literal> is an association table linking authors to works. Here is the table schema, as generated by <literal>SchemaExport</literal>:" msgstr "" -#. Tag: programlisting -#: example_mappings.xml:105 -#, no-c-format -msgid "" - "<![CDATA[create table works (\n" - " id BIGINT not null generated by default as identity, \n" - " tempo FLOAT, \n" - " genre VARCHAR(255), \n" - " text INTEGER, \n" - " title VARCHAR(255), \n" - " type CHAR(1) not null, \n" - " primary key (id)\n" - ")\n" - "\n" - "create table author_work (\n" - " author_id BIGINT not null, \n" - " work_id BIGINT not null, \n" - " primary key (work_id, author_id)\n" - ")\n" - "\n" - "create table authors (\n" - " id BIGINT not null generated by default as identity, \n" - " alias VARCHAR(255), \n" - " primary key (id)\n" - ")\n" - "\n" - "create table persons (\n" - " id BIGINT not null generated by default as identity, \n" - " name VARCHAR(255), \n" - " primary key (id)\n" - ")\n" - "\n" - "alter table authors \n" - " add constraint authorsFK0 foreign key (id) references persons\n" - "alter table author_work \n" - " add constraint author_workFK0 foreign key (author_id) references authors\n" - "alter table author_work\n" - " add constraint author_workFK1 foreign key (work_id) references works]]>" -msgstr "" - #. Tag: title -#: example_mappings.xml:110 #, no-c-format msgid "Customer/Order/Product" msgstr "" #. Tag: para -#: example_mappings.xml:112 #, no-c-format msgid "In this section we consider a model of the relationships between <literal>Customer</literal>, <literal>Order</literal>, <literal>Line Item</literal> and <literal>Product</literal>. There is a one-to-many association between <literal>Customer</literal> and <literal>Order</literal>, but how can you represent <literal>Order</literal> / <literal>LineItem</literal> / <literal>Product</literal>? In the example, <literal>LineItem</literal> is mapped as an association class representing the many-to-many association between <literal>Order</literal> and <literal>Product</literal>. In Hibernate this is called a composite element." msgstr "" #. Tag: para -#: example_mappings.xml:132 #, no-c-format msgid "The mapping document will look like this:" msgstr "" -#. Tag: programlisting -#: example_mappings.xml:136 -#, no-c-format -msgid "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"Customer\" table=\"customers\">\n" - " <id name=\"id\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " <set name=\"orders\" inverse=\"true\">\n" - " <key column=\"customer_id\"/>\n" - " <one-to-many class=\"Order\"/>\n" - " </set>\n" - " </class>\n" - "\n" - " <class name=\"Order\" table=\"orders\">\n" - " <id name=\"id\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"date\"/>\n" - " <many-to-one name=\"customer\" column=\"customer_id\"/>\n" - " <list name=\"lineItems\" table=\"line_items\">\n" - " <key column=\"order_id\"/>\n" - " <list-index column=\"line_number\"/>\n" - " <composite-element class=\"LineItem\">\n" - " <property name=\"quantity\"/>\n" - " <many-to-one name=\"product\" column=\"product_id\"/>\n" - " </composite-element>\n" - " </list>\n" - " </class>\n" - "\n" - " <class name=\"Product\" table=\"products\">\n" - " <id name=\"id\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"serialNumber\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" -msgstr "" - #. Tag: para -#: example_mappings.xml:138 #, no-c-format msgid "<literal>customers</literal>, <literal>orders</literal>, <literal>line_items</literal> and <literal>products</literal> hold customer, order, order line item and product data respectively. <literal>line_items</literal> also acts as an association table linking orders with products." msgstr "" -#. Tag: programlisting -#: example_mappings.xml:145 -#, no-c-format -msgid "" - "<![CDATA[create table customers (\n" - " id BIGINT not null generated by default as identity, \n" - " name VARCHAR(255), \n" - " primary key (id)\n" - ")\n" - "\n" - "create table orders (\n" - " id BIGINT not null generated by default as identity, \n" - " customer_id BIGINT, \n" - " date TIMESTAMP, \n" - " primary key (id)\n" - ")\n" - "\n" - "create table line_items (\n" - " line_number INTEGER not null, \n" - " order_id BIGINT not null, \n" - " product_id BIGINT, \n" - " quantity INTEGER, \n" - " primary key (order_id, line_number)\n" - ")\n" - "\n" - "create table products (\n" - " id BIGINT not null generated by default as identity, \n" - " serialNumber VARCHAR(255), \n" - " primary key (id)\n" - ")\n" - "\n" - "alter table orders \n" - " add constraint ordersFK0 foreign key (customer_id) references customers\n" - "alter table line_items\n" - " add constraint line_itemsFK0 foreign key (product_id) references products\n" - "alter table line_items\n" - " add constraint line_itemsFK1 foreign key (order_id) references orders]]>" -msgstr "" - #. Tag: title -#: example_mappings.xml:150 #, no-c-format msgid "Miscellaneous example mappings" msgstr "" #. Tag: para -#: example_mappings.xml:152 #, no-c-format msgid "These examples are available from the Hibernate test suite. You will find many other useful example mappings there by searching in the <literal>test</literal> folder of the Hibernate distribution." msgstr "" #. Tag: title -#: example_mappings.xml:161 #, no-c-format msgid "\"Typed\" one-to-one association" msgstr "" -#. Tag: programlisting -#: example_mappings.xml:162 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"name\"/>\n" - " <one-to-one name=\"address\" \n" - " cascade=\"all\">\n" - " <formula>name</formula>\n" - " <formula>'HOME'</formula>\n" - " </one-to-one>\n" - " <one-to-one name=\"mailingAddress\" \n" - " cascade=\"all\">\n" - " <formula>name</formula>\n" - " <formula>'MAILING'</formula>\n" - " </one-to-one>\n" - "</class>\n" - "\n" - "<class name=\"Address\" batch-size=\"2\" \n" - " check=\"addressType in ('MAILING', 'HOME', 'BUSINESS')\">\n" - " <composite-id>\n" - " <key-many-to-one name=\"person\" \n" - " column=\"personName\"/>\n" - " <key-property name=\"type\" \n" - " column=\"addressType\"/>\n" - " </composite-id>\n" - " <property name=\"street\" type=\"text\"/>\n" - " <property name=\"state\"/>\n" - " <property name=\"zip\"/>\n" - "</class>]]>" -msgstr "" - #. Tag: title -#: example_mappings.xml:166 #, no-c-format msgid "Composite key example" msgstr "" -#. Tag: programlisting -#: example_mappings.xml:167 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Customer\">\n" - "\n" - " <id name=\"customerId\"\n" - " length=\"10\">\n" - " <generator class=\"assigned\"/>\n" - " </id>\n" - "\n" - " <property name=\"name\" not-null=\"true\" length=\"100\"/>\n" - " <property name=\"address\" not-null=\"true\" length=\"200\"/>\n" - "\n" - " <list name=\"orders\"\n" - " inverse=\"true\"\n" - " cascade=\"save-update\">\n" - " <key column=\"customerId\"/>\n" - " <index column=\"orderNumber\"/>\n" - " <one-to-many class=\"Order\"/>\n" - " </list>\n" - "\n" - "</class>\n" - "\n" - "<class name=\"Order\" table=\"CustomerOrder\" lazy=\"true\">\n" - " <synchronize table=\"LineItem\"/>\n" - " <synchronize table=\"Product\"/>\n" - " \n" - " <composite-id name=\"id\" \n" - " class=\"Order$Id\">\n" - " <key-property name=\"customerId\" length=\"10\"/>\n" - " <key-property name=\"orderNumber\"/>\n" - " </composite-id>\n" - " \n" - " <property name=\"orderDate\" \n" - " type=\"calendar_date\"\n" - " not-null=\"true\"/>\n" - " \n" - " <property name=\"total\">\n" - " <formula>\n" - " ( select sum(li.quantity*p.price) \n" - " from LineItem li, Product p \n" - " where li.productId = p.productId \n" - " and li.customerId = customerId \n" - " and li.orderNumber = orderNumber )\n" - " </formula>\n" - " </property>\n" - " \n" - " <many-to-one name=\"customer\"\n" - " column=\"customerId\"\n" - " insert=\"false\"\n" - " update=\"false\" \n" - " not-null=\"true\"/>\n" - " \n" - " <bag name=\"lineItems\"\n" - " fetch=\"join\" \n" - " inverse=\"true\"\n" - " cascade=\"save-update\">\n" - " <key>\n" - " <column name=\"customerId\"/>\n" - " <column name=\"orderNumber\"/>\n" - " </key>\n" - " <one-to-many class=\"LineItem\"/>\n" - " </bag>\n" - " \n" - "</class>\n" - " \n" - "<class name=\"LineItem\">\n" - " \n" - " <composite-id name=\"id\" \n" - " class=\"LineItem$Id\">\n" - " <key-property name=\"customerId\" length=\"10\"/>\n" - " <key-property name=\"orderNumber\"/>\n" - " <key-property name=\"productId\" length=\"10\"/>\n" - " </composite-id>\n" - " \n" - " <property name=\"quantity\"/>\n" - " \n" - " <many-to-one name=\"order\"\n" - " insert=\"false\"\n" - " update=\"false\" \n" - " not-null=\"true\">\n" - " <column name=\"customerId\"/>\n" - " <column name=\"orderNumber\"/>\n" - " </many-to-one>\n" - " \n" - " <many-to-one name=\"product\"\n" - " insert=\"false\"\n" - " update=\"false\" \n" - " not-null=\"true\"\n" - " column=\"productId\"/>\n" - " \n" - "</class>\n" - "\n" - "<class name=\"Product\">\n" - " <synchronize table=\"LineItem\"/>\n" - "\n" - " <id name=\"productId\"\n" - " length=\"10\">\n" - " <generator class=\"assigned\"/>\n" - " </id>\n" - " \n" - " <property name=\"description\" \n" - " not-null=\"true\" \n" - " length=\"200\"/>\n" - " <property name=\"price\" length=\"3\"/>\n" - " <property name=\"numberAvailable\"/>\n" - " \n" - " <property name=\"numberOrdered\">\n" - " <formula>\n" - " ( select sum(li.quantity) \n" - " from LineItem li \n" - " where li.productId = productId )\n" - " </formula>\n" - " </property>\n" - " \n" - "</class>]]>" -msgstr "" - #. Tag: title -#: example_mappings.xml:171 #, no-c-format msgid "Many-to-many with shared composite key attribute" msgstr "" -#. Tag: programlisting -#: example_mappings.xml:172 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"User\" table=\"`User`\">\n" - " <composite-id>\n" - " <key-property name=\"name\"/>\n" - " <key-property name=\"org\"/>\n" - " </composite-id>\n" - " <set name=\"groups\" table=\"UserGroup\">\n" - " <key>\n" - " <column name=\"userName\"/>\n" - " <column name=\"org\"/>\n" - " </key>\n" - " <many-to-many class=\"Group\">\n" - " <column name=\"groupName\"/>\n" - " <formula>org</formula>\n" - " </many-to-many>\n" - " </set>\n" - "</class>\n" - " \n" - "<class name=\"Group\" table=\"`Group`\">\n" - " <composite-id>\n" - " <key-property name=\"name\"/>\n" - " <key-property name=\"org\"/>\n" - " </composite-id>\n" - " <property name=\"description\"/>\n" - " <set name=\"users\" table=\"UserGroup\" inverse=\"true\">\n" - " <key>\n" - " <column name=\"groupName\"/>\n" - " <column name=\"org\"/>\n" - " </key>\n" - " <many-to-many class=\"User\">\n" - " <column name=\"userName\"/>\n" - " <formula>org</formula>\n" - " </many-to-many>\n" - " </set>\n" - "</class>\n" - "]]>" -msgstr "" - #. Tag: title -#: example_mappings.xml:176 #, no-c-format msgid "Content based discrimination" msgstr "" -#. Tag: programlisting -#: example_mappings.xml:177 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Person\"\n" - " discriminator-value=\"P\">\n" - " \n" - " <id name=\"id\" \n" - " column=\"person_id\" \n" - " unsaved-value=\"0\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " \n" - " \n" - " <discriminator \n" - " type=\"character\">\n" - " <formula>\n" - " case \n" - " when title is not null then 'E' \n" - " when salesperson is not null then 'C' \n" - " else 'P' \n" - " end\n" - " </formula>\n" - " </discriminator>\n" - "\n" - " <property name=\"name\" \n" - " not-null=\"true\"\n" - " length=\"80\"/>\n" - " \n" - " <property name=\"sex\" \n" - " not-null=\"true\"\n" - " update=\"false\"/>\n" - " \n" - " <component name=\"address\">\n" - " <property name=\"address\"/>\n" - " <property name=\"zip\"/>\n" - " <property name=\"country\"/>\n" - " </component>\n" - " \n" - " <subclass name=\"Employee\" \n" - " discriminator-value=\"E\">\n" - " <property name=\"title\"\n" - " length=\"20\"/>\n" - " <property name=\"salary\"/>\n" - " <many-to-one name=\"manager\"/>\n" - " </subclass>\n" - " \n" - " <subclass name=\"Customer\" \n" - " discriminator-value=\"C\">\n" - " <property name=\"comments\"/>\n" - " <many-to-one name=\"salesperson\"/>\n" - " </subclass>\n" - " \n" - "</class>]]>" -msgstr "" - #. Tag: title -#: example_mappings.xml:181 #, no-c-format msgid "Associations on alternate keys" msgstr "" -#. Tag: programlisting -#: example_mappings.xml:182 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Person\">\n" - " \n" - " <id name=\"id\">\n" - " <generator class=\"hilo\"/>\n" - " </id>\n" - " \n" - " <property name=\"name\" length=\"100\"/>\n" - " \n" - " <one-to-one name=\"address\" \n" - " property-ref=\"person\"\n" - " cascade=\"all\"\n" - " fetch=\"join\"/>\n" - " \n" - " <set name=\"accounts\" \n" - " inverse=\"true\">\n" - " <key column=\"userId\"\n" - " property-ref=\"userId\"/>\n" - " <one-to-many class=\"Account\"/>\n" - " </set>\n" - " \n" - " <property name=\"userId\" length=\"8\"/>\n" - "\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - "\n" - " <id name=\"id\">\n" - " <generator class=\"hilo\"/>\n" - " </id>\n" - "\n" - " <property name=\"address\" length=\"300\"/>\n" - " <property name=\"zip\" length=\"5\"/>\n" - " <property name=\"country\" length=\"25\"/>\n" - " <many-to-one name=\"person\" unique=\"true\" not-null=\"true\"/>\n" - "\n" - "</class>\n" - "\n" - "<class name=\"Account\">\n" - " <id name=\"accountId\" length=\"32\">\n" - " <generator class=\"uuid\"/>\n" - " </id>\n" - " \n" - " <many-to-one name=\"user\"\n" - " column=\"userId\"\n" - " property-ref=\"userId\"/>\n" - " \n" - " <property name=\"type\" not-null=\"true\"/>\n" - " \n" - "</class>]]>" -msgstr "" - Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/example_parentchild.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/example_parentchild.pot 2010-02-08 04:50:03 UTC (rev 18716) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/example_parentchild.pot 2010-02-08 04:56:55 UTC (rev 18717) @@ -1,396 +1,203 @@ -# SOME DESCRIPTIVE TITLE. -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. # -#, fuzzy msgid "" msgstr "" -"Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-10 21:02+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:19\n" +"PO-Revision-Date: 2010-01-08T04:07:19\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" "MIME-Version: 1.0\n" -"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Type: application/x-publican; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. Tag: title -#: example_parentchild.xml:29 #, no-c-format msgid "Example: Parent/Child" msgstr "" #. Tag: para -#: example_parentchild.xml:31 #, no-c-format msgid "One of the first things that new users want to do with Hibernate is to model a parent/child type relationship. There are two different approaches to this. The most convenient approach, especially for new users, is to model both <literal>Parent</literal> and <literal>Child</literal> as entity classes with a <literal><one-to-many></literal> association from <literal>Parent</literal> to <literal>Child</literal>. The alternative approach is to declare the <literal>Child</literal> as a <literal><composite-element></literal>. The default semantics of a one-to-many association in Hibernate are much less close to the usual semantics of a parent/child relationship than those of a composite element mapping. We will explain how to use a <emphasis>bidirectional one-to-many association with cascades</emphasis> to model a parent/child relationship efficiently and elegantly." msgstr "" #. Tag: title -#: example_parentchild.xml:45 #, no-c-format msgid "A note about collections" msgstr "" #. Tag: para -#: example_parentchild.xml:47 #, no-c-format msgid "Hibernate collections are considered to be a logical part of their owning entity and not of the contained entities. Be aware that this is a critical distinction that has the following consequences:" msgstr "" #. Tag: para -#: example_parentchild.xml:54 #, no-c-format msgid "When you remove/add an object from/to a collection, the version number of the collection owner is incremented." msgstr "" #. Tag: para -#: example_parentchild.xml:60 #, no-c-format msgid "If an object that was removed from a collection is an instance of a value type (e.g. a composite element), that object will cease to be persistent and its state will be completely removed from the database. Likewise, adding a value type instance to the collection will cause its state to be immediately persistent." msgstr "" #. Tag: para -#: example_parentchild.xml:68 #, no-c-format msgid "Conversely, if an entity is removed from a collection (a one-to-many or many-to-many association), it will not be deleted by default. This behavior is completely consistent; a change to the internal state of another entity should not cause the associated entity to vanish. Likewise, adding an entity to a collection does not cause that entity to become persistent, by default." msgstr "" #. Tag: para -#: example_parentchild.xml:78 #, no-c-format msgid "Adding an entity to a collection, by default, merely creates a link between the two entities. Removing the entity will remove the link. This is appropriate for all sorts of cases. However, it is not appropriate in the case of a parent/child relationship. In this case, the life of the child is bound to the life cycle of the parent." msgstr "" #. Tag: title -#: example_parentchild.xml:88 #, no-c-format msgid "Bidirectional one-to-many" msgstr "" #. Tag: para -#: example_parentchild.xml:90 #, no-c-format msgid "Suppose we start with a simple <literal><one-to-many></literal> association from <literal>Parent</literal> to <literal>Child</literal>." msgstr "" -#. Tag: programlisting -#: example_parentchild.xml:95 -#, no-c-format -msgid "" - "<![CDATA[<set name=\"children\">\n" - " <key column=\"parent_id\"/>\n" - " <one-to-many class=\"Child\"/>\n" - "</set>]]>" -msgstr "" - #. Tag: para -#: example_parentchild.xml:97 #, no-c-format msgid "If we were to execute the following code:" msgstr "" -#. Tag: programlisting -#: example_parentchild.xml:101 -#, no-c-format -msgid "" - "<![CDATA[Parent p = .....;\n" - "Child c = new Child();\n" - "p.getChildren().add(c);\n" - "session.save(c);\n" - "session.flush();]]>" -msgstr "" - #. Tag: para -#: example_parentchild.xml:103 #, no-c-format msgid "Hibernate would issue two SQL statements:" msgstr "" #. Tag: para -#: example_parentchild.xml:109 #, no-c-format msgid "an <literal>INSERT</literal> to create the record for <literal>c</literal>" msgstr "" #. Tag: para -#: example_parentchild.xml:112 #, no-c-format msgid "an <literal>UPDATE</literal> to create the link from <literal>p</literal> to <literal>c</literal>" msgstr "" #. Tag: para -#: example_parentchild.xml:119 #, no-c-format msgid "This is not only inefficient, but also violates any <literal>NOT NULL</literal> constraint on the <literal>parent_id</literal> column. You can fix the nullability constraint violation by specifying <literal>not-null=\"true\"</literal> in the collection mapping:" msgstr "" -#. Tag: programlisting -#: example_parentchild.xml:125 -#, no-c-format -msgid "" - "<![CDATA[<set name=\"children\">\n" - " <key column=\"parent_id\" not-null=\"true\"/>\n" - " <one-to-many class=\"Child\"/>\n" - "</set>]]>" -msgstr "" - #. Tag: para -#: example_parentchild.xml:127 #, no-c-format msgid "However, this is not the recommended solution." msgstr "" #. Tag: para -#: example_parentchild.xml:130 #, no-c-format msgid "The underlying cause of this behavior is that the link (the foreign key <literal>parent_id</literal>) from <literal>p</literal> to <literal>c</literal> is not considered part of the state of the <literal>Child</literal> object and is therefore not created in the <literal>INSERT</literal>. The solution is to make the link part of the <literal>Child</literal> mapping." msgstr "" -#. Tag: programlisting -#: example_parentchild.xml:137 -#, no-c-format -msgid "<![CDATA[<many-to-one name=\"parent\" column=\"parent_id\" not-null=\"true\"/>]]>" -msgstr "" - #. Tag: para -#: example_parentchild.xml:139 #, no-c-format msgid "You also need to add the <literal>parent</literal> property to the <literal>Child</literal> class." msgstr "" #. Tag: para -#: example_parentchild.xml:143 #, no-c-format msgid "Now that the <literal>Child</literal> entity is managing the state of the link, we tell the collection not to update the link. We use the <literal>inverse</literal> attribute to do this:" msgstr "" -#. Tag: programlisting -#: example_parentchild.xml:148 -#, no-c-format -msgid "" - "<![CDATA[<set name=\"children\" inverse=\"true\">\n" - " <key column=\"parent_id\"/>\n" - " <one-to-many class=\"Child\"/>\n" - "</set>]]>" -msgstr "" - #. Tag: para -#: example_parentchild.xml:150 #, no-c-format msgid "The following code would be used to add a new <literal>Child</literal>:" msgstr "" -#. Tag: programlisting -#: example_parentchild.xml:154 -#, no-c-format -msgid "" - "<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" - "Child c = new Child();\n" - "c.setParent(p);\n" - "p.getChildren().add(c);\n" - "session.save(c);\n" - "session.flush();]]>" -msgstr "" - #. Tag: para -#: example_parentchild.xml:156 #, no-c-format msgid "Only one SQL <literal>INSERT</literal> would now be issued." msgstr "" #. Tag: para -#: example_parentchild.xml:160 #, no-c-format msgid "You could also create an <literal>addChild()</literal> method of <literal>Parent</literal>." msgstr "" -#. Tag: programlisting -#: example_parentchild.xml:165 -#, no-c-format -msgid "" - "<![CDATA[public void addChild(Child c) {\n" - " c.setParent(this);\n" - " children.add(c);\n" - "}]]>" -msgstr "" - #. Tag: para -#: example_parentchild.xml:167 #, no-c-format msgid "The code to add a <literal>Child</literal> looks like this:" msgstr "" -#. Tag: programlisting -#: example_parentchild.xml:171 -#, no-c-format -msgid "" - "<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" - "Child c = new Child();\n" - "p.addChild(c);\n" - "session.save(c);\n" - "session.flush();]]>" -msgstr "" - #. Tag: title -#: example_parentchild.xml:176 #, no-c-format msgid "Cascading life cycle" msgstr "" #. Tag: para -#: example_parentchild.xml:178 #, no-c-format msgid "You can address the frustrations of the explicit call to <literal>save()</literal> by using cascades." msgstr "" -#. Tag: programlisting -#: example_parentchild.xml:183 -#, no-c-format -msgid "" - "<![CDATA[<set name=\"children\" inverse=\"true\" cascade=\"all\">\n" - " <key column=\"parent_id\"/>\n" - " <one-to-many class=\"Child\"/>\n" - "</set>]]>" -msgstr "" - #. Tag: para -#: example_parentchild.xml:185 #, no-c-format msgid "This simplifies the code above to:" msgstr "" -#. Tag: programlisting -#: example_parentchild.xml:189 -#, no-c-format -msgid "" - "<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" - "Child c = new Child();\n" - "p.addChild(c);\n" - "session.flush();]]>" -msgstr "" - #. Tag: para -#: example_parentchild.xml:191 #, no-c-format msgid "Similarly, we do not need to iterate over the children when saving or deleting a <literal>Parent</literal>. The following removes <literal>p</literal> and all its children from the database." msgstr "" -#. Tag: programlisting -#: example_parentchild.xml:196 -#, no-c-format -msgid "" - "<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" - "session.delete(p);\n" - "session.flush();]]>" -msgstr "" - #. Tag: para -#: example_parentchild.xml:198 #, no-c-format msgid "However, the following code:" msgstr "" -#. Tag: programlisting -#: example_parentchild.xml:202 -#, no-c-format -msgid "" - "<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" - "Child c = (Child) p.getChildren().iterator().next();\n" - "p.getChildren().remove(c);\n" - "c.setParent(null);\n" - "session.flush();]]>" -msgstr "" - #. Tag: para -#: example_parentchild.xml:204 #, no-c-format msgid "will not remove <literal>c</literal> from the database. In this case, it will only remove the link to <literal>p</literal> and cause a <literal>NOT NULL</literal> constraint violation. You need to explicitly <literal>delete()</literal> the <literal>Child</literal>." msgstr "" -#. Tag: programlisting -#: example_parentchild.xml:210 -#, no-c-format -msgid "" - "<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" - "Child c = (Child) p.getChildren().iterator().next();\n" - "p.getChildren().remove(c);\n" - "session.delete(c);\n" - "session.flush();]]>" -msgstr "" - #. Tag: para -#: example_parentchild.xml:212 #, no-c-format msgid "In our case, a <literal>Child</literal> cannot exist without its parent. So if we remove a <literal>Child</literal> from the collection, we do want it to be deleted. To do this, we must use <literal>cascade=\"all-delete-orphan\"</literal>." msgstr "" -#. Tag: programlisting -#: example_parentchild.xml:218 -#, no-c-format -msgid "" - "<![CDATA[<set name=\"children\" inverse=\"true\" cascade=\"all-delete-orphan\">\n" - " <key column=\"parent_id\"/>\n" - " <one-to-many class=\"Child\"/>\n" - "</set>]]>" -msgstr "" - #. Tag: para -#: example_parentchild.xml:220 #, no-c-format msgid "Even though the collection mapping specifies <literal>inverse=\"true\"</literal>, cascades are still processed by iterating the collection elements. If you need an object be saved, deleted or updated by cascade, you must add it to the collection. It is not enough to simply call <literal>setParent()</literal>." msgstr "" #. Tag: title -#: example_parentchild.xml:230 #, no-c-format msgid "Cascades and <literal>unsaved-value</literal>" msgstr "" #. Tag: para -#: example_parentchild.xml:232 #, no-c-format -msgid "Suppose we loaded up a <literal>Parent</literal> in one <literal>Session</literal>, made some changes in a UI action and wanted to persist these changes in a new session by calling <literal>update()</literal>. The <literal>Parent</literal> will contain a collection of children and, since the cascading update is enabled, Hibernate needs to know which children are newly instantiated and which represent existing rows in the database. We will also assume that both <literal>Parent</literal> and <literal>Child</literal> have generated identifier properties of type <literal>Long</literal>. Hibernate will use the identifier and version/timestamp property value to determine which of the children are new. (See <xref linkend=\"objectstate-saveorupdate\"/>.) <emphasis>In Hibernate3, it is no longer necessary to specify an <literal>unsaved-value</literal> explicitly.</emphasis>" +msgid "Suppose we loaded up a <literal>Parent</literal> in one <literal>Session</literal>, made some changes in a UI action and wanted to persist these changes in a new session by calling <literal>update()</literal>. The <literal>Parent</literal> will contain a collection of children and, since the cascading update is enabled, Hibernate needs to know which children are newly instantiated and which represent existing rows in the database. We will also assume that both <literal>Parent</literal> and <literal>Child</literal> have generated identifier properties of type <literal>Long</literal>. Hibernate will use the identifier and version/timestamp property value to determine which of the children are new. (See <xref linkend=\"objectstate-saveorupdate\" />.) <emphasis>In Hibernate3, it is no longer necessary to specify an <literal>unsaved-value</literal> explicitly.</emphasis>" msgstr "" #. Tag: para -#: example_parentchild.xml:244 #, no-c-format msgid "The following code will update <literal>parent</literal> and <literal>child</literal> and insert <literal>newChild</literal>:" msgstr "" -#. Tag: programlisting -#: example_parentchild.xml:249 -#, no-c-format -msgid "" - "<![CDATA[//parent and child were both loaded in a previous session\n" - "parent.addChild(child);\n" - "Child newChild = new Child();\n" - "parent.addChild(newChild);\n" - "session.update(parent);\n" - "session.flush();]]>" -msgstr "" - #. Tag: para -#: example_parentchild.xml:251 #, no-c-format msgid "This may be suitable for the case of a generated identifier, but what about assigned identifiers and composite identifiers? This is more difficult, since Hibernate cannot use the identifier property to distinguish between a newly instantiated object, with an identifier assigned by the user, and an object loaded in a previous session. In this case, Hibernate will either use the timestamp or version property, or will actually query the second-level cache or, worst case, the database, to see if the row exists." msgstr "" #. Tag: title -#: example_parentchild.xml:284 #, no-c-format msgid "Conclusion" msgstr "" #. Tag: para -#: example_parentchild.xml:286 #, no-c-format msgid "The sections we have just covered can be a bit confusing. However, in practice, it all works out nicely. Most Hibernate applications use the parent/child pattern in many places." msgstr "" #. Tag: para -#: example_parentchild.xml:291 #, no-c-format msgid "We mentioned an alternative in the first paragraph. None of the above issues exist in the case of <literal><composite-element></literal> mappings, which have exactly the semantics of a parent/child relationship. Unfortunately, there are two big limitations with composite element classes: composite elements cannot own collections and they should not be the child of any entity other than the unique parent." msgstr "" Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/example_weblog.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/example_weblog.pot 2010-02-08 04:50:03 UTC (rev 18716) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/example_weblog.pot 2010-02-08 04:56:55 UTC (rev 18717) @@ -1,478 +1,49 @@ -# SOME DESCRIPTIVE TITLE. -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. # -#, fuzzy msgid "" msgstr "" -"Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-10 21:02+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:19\n" +"PO-Revision-Date: 2010-01-08T04:07:19\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" "MIME-Version: 1.0\n" -"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Type: application/x-publican; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. Tag: title -#: example_weblog.xml:29 #, no-c-format msgid "Example: Weblog Application" msgstr "" #. Tag: title -#: example_weblog.xml:32 #, no-c-format msgid "Persistent Classes" msgstr "" #. Tag: para -#: example_weblog.xml:34 #, no-c-format msgid "The persistent classes here represent a weblog and an item posted in a weblog. They are to be modelled as a standard parent/child relationship, but we will use an ordered bag, instead of a set:" msgstr "" -#. Tag: programlisting -#: example_weblog.xml:40 -#, no-c-format -msgid "" - "<![CDATA[package eg;\n" - "\n" - "import java.util.List;\n" - "\n" - "public class Blog {\n" - " private Long _id;\n" - " private String _name;\n" - " private List _items;\n" - "\n" - " public Long getId() {\n" - " return _id;\n" - " }\n" - " public List getItems() {\n" - " return _items;\n" - " }\n" - " public String getName() {\n" - " return _name;\n" - " }\n" - " public void setId(Long long1) {\n" - " _id = long1;\n" - " }\n" - " public void setItems(List list) {\n" - " _items = list;\n" - " }\n" - " public void setName(String string) {\n" - " _name = string;\n" - " }\n" - "}]]>" -msgstr "" - -#. Tag: programlisting -#: example_weblog.xml:42 -#, no-c-format -msgid "" - "<![CDATA[package eg;\n" - "\n" - "import java.text.DateFormat;\n" - "import java.util.Calendar;\n" - "\n" - "public class BlogItem {\n" - " private Long _id;\n" - " private Calendar _datetime;\n" - " private String _text;\n" - " private String _title;\n" - " private Blog _blog;\n" - "\n" - " public Blog getBlog() {\n" - " return _blog;\n" - " }\n" - " public Calendar getDatetime() {\n" - " return _datetime;\n" - " }\n" - " public Long getId() {\n" - " return _id;\n" - " }\n" - " public String getText() {\n" - " return _text;\n" - " }\n" - " public String getTitle() {\n" - " return _title;\n" - " }\n" - " public void setBlog(Blog blog) {\n" - " _blog = blog;\n" - " }\n" - " public void setDatetime(Calendar calendar) {\n" - " _datetime = calendar;\n" - " }\n" - " public void setId(Long long1) {\n" - " _id = long1;\n" - " }\n" - " public void setText(String string) {\n" - " _text = string;\n" - " }\n" - " public void setTitle(String string) {\n" - " _title = string;\n" - " }\n" - "}]]>" -msgstr "" - #. Tag: title -#: example_weblog.xml:47 #, no-c-format msgid "Hibernate Mappings" msgstr "" #. Tag: para -#: example_weblog.xml:49 #, no-c-format msgid "The XML mappings are now straightforward. For example:" msgstr "" -#. Tag: programlisting -#: example_weblog.xml:53 -#, no-c-format -msgid "" - "<![CDATA[<?xml version=\"1.0\"?>\n" - "<!DOCTYPE hibernate-mapping PUBLIC\n" - " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" - " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" - "\n" - "<hibernate-mapping package=\"eg\">\n" - "\n" - " <class\n" - " name=\"Blog\"\n" - " table=\"BLOGS\">\n" - "\n" - " <id\n" - " name=\"id\"\n" - " column=\"BLOG_ID\">\n" - "\n" - " <generator class=\"native\"/>\n" - "\n" - " </id>\n" - "\n" - " <property\n" - " name=\"name\"\n" - " column=\"NAME\"\n" - " not-null=\"true\"\n" - " unique=\"true\"/>\n" - "\n" - " <bag\n" - " name=\"items\"\n" - " inverse=\"true\"\n" - " order-by=\"DATE_TIME\"\n" - " cascade=\"all\">\n" - "\n" - " <key column=\"BLOG_ID\"/>\n" - " <one-to-many class=\"BlogItem\"/>\n" - "\n" - " </bag>\n" - "\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" -msgstr "" - -#. Tag: programlisting -#: example_weblog.xml:55 -#, no-c-format -msgid "" - "<![CDATA[<?xml version=\"1.0\"?>\n" - "<!DOCTYPE hibernate-mapping PUBLIC\n" - " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" - " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" - "\n" - "<hibernate-mapping package=\"eg\">\n" - "\n" - " <class\n" - " name=\"BlogItem\"\n" - " table=\"BLOG_ITEMS\"\n" - " dynamic-update=\"true\">\n" - "\n" - " <id\n" - " name=\"id\"\n" - " column=\"BLOG_ITEM_ID\">\n" - "\n" - " <generator class=\"native\"/>\n" - "\n" - " </id>\n" - "\n" - " <property\n" - " name=\"title\"\n" - " column=\"TITLE\"\n" - " not-null=\"true\"/>\n" - "\n" - " <property\n" - " name=\"text\"\n" - " column=\"TEXT\"\n" - " not-null=\"true\"/>\n" - "\n" - " <property\n" - " name=\"datetime\"\n" - " column=\"DATE_TIME\"\n" - " not-null=\"true\"/>\n" - "\n" - " <many-to-one\n" - " name=\"blog\"\n" - " column=\"BLOG_ID\"\n" - " not-null=\"true\"/>\n" - "\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" -msgstr "" - #. Tag: title -#: example_weblog.xml:60 #, no-c-format msgid "Hibernate Code" msgstr "" #. Tag: para -#: example_weblog.xml:62 #, no-c-format msgid "The following class demonstrates some of the kinds of things we can do with these classes using Hibernate:" msgstr "" -#. Tag: programlisting -#: example_weblog.xml:67 -#, no-c-format -msgid "" - "<![CDATA[package eg;\n" - "\n" - "import java.util.ArrayList;\n" - "import java.util.Calendar;\n" - "import java.util.Iterator;\n" - "import java.util.List;\n" - "\n" - "import org.hibernate.HibernateException;\n" - "import org.hibernate.Query;\n" - "import org.hibernate.Session;\n" - "import org.hibernate.SessionFactory;\n" - "import org.hibernate.Transaction;\n" - "import org.hibernate.cfg.Configuration;\n" - "import org.hibernate.tool.hbm2ddl.SchemaExport;\n" - "\n" - "public class BlogMain {\n" - " \n" - " private SessionFactory _sessions;\n" - " \n" - " public void configure() throws HibernateException {\n" - " _sessions = new Configuration()\n" - " .addClass(Blog.class)\n" - " .addClass(BlogItem.class)\n" - " .buildSessionFactory();\n" - " }\n" - " \n" - " public void exportTables() throws HibernateException {\n" - " Configuration cfg = new Configuration()\n" - " .addClass(Blog.class)\n" - " .addClass(BlogItem.class);\n" - " new SchemaExport(cfg).create(true, true);\n" - " }\n" - " \n" - " public Blog createBlog(String name) throws HibernateException {\n" - " \n" - " Blog blog = new Blog();\n" - " blog.setName(name);\n" - " blog.setItems( new ArrayList() );\n" - " \n" - " Session session = _sessions.openSession();\n" - " Transaction tx = null;\n" - " try {\n" - " tx = session.beginTransaction();\n" - " session.persist(blog);\n" - " tx.commit();\n" - " }\n" - " catch (HibernateException he) {\n" - " if (tx!=null) tx.rollback();\n" - " throw he;\n" - " }\n" - " finally {\n" - " session.close();\n" - " }\n" - " return blog;\n" - " }\n" - " \n" - " public BlogItem createBlogItem(Blog blog, String title, String text)\n" - " throws HibernateException {\n" - " \n" - " BlogItem item = new BlogItem();\n" - " item.setTitle(title);\n" - " item.setText(text);\n" - " item.setBlog(blog);\n" - " item.setDatetime( Calendar.getInstance() );\n" - " blog.getItems().add(item);\n" - " \n" - " Session session = _sessions.openSession();\n" - " Transaction tx = null;\n" - " try {\n" - " tx = session.beginTransaction();\n" - " session.update(blog);\n" - " tx.commit();\n" - " }\n" - " catch (HibernateException he) {\n" - " if (tx!=null) tx.rollback();\n" - " throw he;\n" - " }\n" - " finally {\n" - " session.close();\n" - " }\n" - " return item;\n" - " }\n" - " \n" - " public BlogItem createBlogItem(Long blogid, String title, String text)\n" - " throws HibernateException {\n" - " \n" - " BlogItem item = new BlogItem();\n" - " item.setTitle(title);\n" - " item.setText(text);\n" - " item.setDatetime( Calendar.getInstance() );\n" - " \n" - " Session session = _sessions.openSession();\n" - " Transaction tx = null;\n" - " try {\n" - " tx = session.beginTransaction();\n" - " Blog blog = (Blog) session.load(Blog.class, blogid);\n" - " item.setBlog(blog);\n" - " blog.getItems().add(item);\n" - " tx.commit();\n" - " }\n" - " catch (HibernateException he) {\n" - " if (tx!=null) tx.rollback();\n" - " throw he;\n" - " }\n" - " finally {\n" - " session.close();\n" - " }\n" - " return item;\n" - " }\n" - " \n" - " public void updateBlogItem(BlogItem item, String text)\n" - " throws HibernateException {\n" - " \n" - " item.setText(text);\n" - " \n" - " Session session = _sessions.openSession();\n" - " Transaction tx = null;\n" - " try {\n" - " tx = session.beginTransaction();\n" - " session.update(item);\n" - " tx.commit();\n" - " }\n" - " catch (HibernateException he) {\n" - " if (tx!=null) tx.rollback();\n" - " throw he;\n" - " }\n" - " finally {\n" - " session.close();\n" - " }\n" - " }\n" - " \n" - " public void updateBlogItem(Long itemid, String text)\n" - " throws HibernateException {\n" - " \n" - " Session session = _sessions.openSession();\n" - " Transaction tx = null;\n" - " try {\n" - " tx = session.beginTransaction();\n" - " BlogItem item = (BlogItem) session.load(BlogItem.class, itemid);\n" - " item.setText(text);\n" - " tx.commit();\n" - " }\n" - " catch (HibernateException he) {\n" - " if (tx!=null) tx.rollback();\n" - " throw he;\n" - " }\n" - " finally {\n" - " session.close();\n" - " }\n" - " }\n" - " \n" - " public List listAllBlogNamesAndItemCounts(int max)\n" - " throws HibernateException {\n" - " \n" - " Session session = _sessions.openSession();\n" - " Transaction tx = null;\n" - " List result = null;\n" - " try {\n" - " tx = session.beginTransaction();\n" - " Query q = session.createQuery(\n" - " \"select blog.id, blog.name, count(blogItem) \" +\n" - " \"from Blog as blog \" +\n" - " \"left outer join blog.items as blogItem \" +\n" - " \"group by blog.name, blog.id \" +\n" - " \"order by max(blogItem.datetime)\"\n" - " );\n" - " q.setMaxResults(max);\n" - " result = q.list();\n" - " tx.commit();\n" - " }\n" - " catch (HibernateException he) {\n" - " if (tx!=null) tx.rollback();\n" - " throw he;\n" - " }\n" - " finally {\n" - " session.close();\n" - " }\n" - " return result;\n" - " }\n" - " \n" - " public Blog getBlogAndAllItems(Long blogid)\n" - " throws HibernateException {\n" - " \n" - " Session session = _sessions.openSession();\n" - " Transaction tx = null;\n" - " Blog blog = null;\n" - " try {\n" - " tx = session.beginTransaction();\n" - " Query q = session.createQuery(\n" - " \"from Blog as blog \" +\n" - " \"left outer join fetch blog.items \" +\n" - " \"where blog.id = :blogid\"\n" - " );\n" - " q.setParameter(\"blogid\", blogid);\n" - " blog = (Blog) q.uniqueResult();\n" - " tx.commit();\n" - " }\n" - " catch (HibernateException he) {\n" - " if (tx!=null) tx.rollback();\n" - " throw he;\n" - " }\n" - " finally {\n" - " session.close();\n" - " }\n" - " return blog;\n" - " }\n" - " \n" - " public List listBlogsAndRecentItems() throws HibernateException {\n" - " \n" - " Session session = _sessions.openSession();\n" - " Transaction tx = null;\n" - " List result = null;\n" - " try {\n" - " tx = session.beginTransaction();\n" - " Query q = session.createQuery(\n" - " \"from Blog as blog \" +\n" - " \"inner join blog.items as blogItem \" +\n" - " \"where blogItem.datetime > :minDate\"\n" - " );\n" - "\n" - " Calendar cal = Calendar.getInstance();\n" - " cal.roll(Calendar.MONTH, false);\n" - " q.setCalendar(\"minDate\", cal);\n" - " \n" - " result = q.list();\n" - " tx.commit();\n" - " }\n" - " catch (HibernateException he) {\n" - " if (tx!=null) tx.rollback();\n" - " throw he;\n" - " }\n" - " finally {\n" - " session.close();\n" - " }\n" - " return result;\n" - " }\n" - "}]]>" -msgstr "" - Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/filters.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/filters.pot 2010-02-08 04:50:03 UTC (rev 18716) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/filters.pot 2010-02-08 04:56:55 UTC (rev 18717) @@ -1,198 +1,93 @@ -# SOME DESCRIPTIVE TITLE. -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. # -#, fuzzy msgid "" msgstr "" -"Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-10 21:02+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:19\n" +"PO-Revision-Date: 2010-01-08T04:07:19\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" "MIME-Version: 1.0\n" -"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Type: application/x-publican; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. Tag: title -#: filters.xml:29 #, no-c-format msgid "Filtering data" msgstr "" #. Tag: para -#: filters.xml:31 #, no-c-format msgid "Hibernate3 provides an innovative new approach to handling data with \"visibility\" rules. A <emphasis>Hibernate filter</emphasis> is a global, named, parameterized filter that can be enabled or disabled for a particular Hibernate session." msgstr "" #. Tag: title -#: filters.xml:38 #, no-c-format msgid "Hibernate filters" msgstr "" #. Tag: para -#: filters.xml:40 #, no-c-format msgid "Hibernate3 has the ability to pre-define filter criteria and attach those filters at both a class level and a collection level. A filter criteria allows you to define a restriction clause similar to the existing \"where\" attribute available on the class and various collection elements. These filter conditions, however, can be parameterized. The application can then decide at runtime whether certain filters should be enabled and what their parameter values should be. Filters can be used like database views, but they are parameterized inside the application." msgstr "" #. Tag: para -#: filters.xml:50 #, no-c-format msgid "In order to use filters, they must first be defined and then attached to the appropriate mapping elements. To define a filter, use the <literal><filter-def/></literal> element within a <literal><hibernate-mapping/></literal> element:" msgstr "" -#. Tag: programlisting -#: filters.xml:56 -#, no-c-format -msgid "" - "<![CDATA[<filter-def name=\"myFilter\">\n" - " <filter-param name=\"myFilterParam\" type=\"string\"/>\n" - "</filter-def>]]>" -msgstr "" - #. Tag: para -#: filters.xml:58 #, no-c-format msgid "This filter can then be attached to a class:" msgstr "" -#. Tag: programlisting -#: filters.xml:62 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"myClass\" ...>\n" - " ...\n" - " <filter name=\"myFilter\" condition=\":myFilterParam = MY_FILTERED_COLUMN\"/>\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: filters.xml:64 #, no-c-format msgid "Or, to a collection:" msgstr "" -#. Tag: programlisting -#: filters.xml:68 -#, no-c-format -msgid "" - "<![CDATA[<set ...>\n" - " <filter name=\"myFilter\" condition=\":myFilterParam = MY_FILTERED_COLUMN\"/>\n" - "</set>]]>" -msgstr "" - #. Tag: para -#: filters.xml:70 #, no-c-format msgid "Or, to both or multiples of each at the same time." msgstr "" #. Tag: para -#: filters.xml:74 #, no-c-format msgid "The methods on <literal>Session</literal> are: <literal>enableFilter(String filterName)</literal>, <literal>getEnabledFilter(String filterName)</literal>, and <literal>disableFilter(String filterName)</literal>. By default, filters are <emphasis>not</emphasis> enabled for a given session. Filters must be enabled through use of the <literal>Session.enableFilter()</literal> method, which returns an instance of the <literal>Filter</literal> interface. If you used the simple filter defined above, it would look like this:" msgstr "" -#. Tag: programlisting -#: filters.xml:83 -#, no-c-format -msgid "<![CDATA[session.enableFilter(\"myFilter\").setParameter(\"myFilterParam\", \"some-value\");]]>" -msgstr "" - #. Tag: para -#: filters.xml:85 #, no-c-format msgid "Methods on the org.hibernate.Filter interface do allow the method-chaining common to much of Hibernate." msgstr "" #. Tag: para -#: filters.xml:89 #, no-c-format msgid "The following is a full example, using temporal data with an effective record date pattern:" msgstr "" -#. Tag: programlisting -#: filters.xml:93 -#, no-c-format -msgid "" - "<![CDATA[<filter-def name=\"effectiveDate\">\n" - " <filter-param name=\"asOfDate\" type=\"date\"/>\n" - "</filter-def>\n" - "\n" - "<class name=\"Employee\" ...>\n" - "...\n" - " <many-to-one name=\"department\" column=\"dept_id\" class=\"Department\"/>\n" - " <property name=\"effectiveStartDate\" type=\"date\" column=\"eff_start_dt\"/>\n" - " <property name=\"effectiveEndDate\" type=\"date\" column=\"eff_end_dt\"/>\n" - "...\n" - " \n" - " <filter name=\"effectiveDate\"\n" - " condition=\":asOfDate BETWEEN eff_start_dt and eff_end_dt\"/>\n" - "</class>\n" - "\n" - "<class name=\"Department\" ...>\n" - "...\n" - " <set name=\"employees\" lazy=\"true\">\n" - " <key column=\"dept_id\"/>\n" - " <one-to-many class=\"Employee\"/>\n" - " <filter name=\"effectiveDate\"\n" - " condition=\":asOfDate BETWEEN eff_start_dt and eff_end_dt\"/>\n" - " </set>\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: filters.xml:95 #, no-c-format msgid "In order to ensure that you are provided with currently effective records, enable the filter on the session prior to retrieving employee data:" msgstr "" -#. Tag: programlisting -#: filters.xml:100 -#, no-c-format -msgid "" - "<![CDATA[Session session = ...;\n" - "session.enableFilter(\"effectiveDate\").setParameter(\"asOfDate\", new Date());\n" - "List results = session.createQuery(\"from Employee as e where e.salary > :targetSalary\")\n" - " .setLong(\"targetSalary\", new Long(1000000))\n" - " .list();\n" - "]]>" -msgstr "" - #. Tag: para -#: filters.xml:102 #, no-c-format msgid "Even though a salary constraint was mentioned explicitly on the results in the above HQL, because of the enabled filter, the query will return only currently active employees who have a salary greater than one million dollars." msgstr "" #. Tag: para -#: filters.xml:108 #, no-c-format msgid "If you want to use filters with outer joining, either through HQL or load fetching, be careful of the direction of the condition expression. It is safest to set this up for left outer joining. Place the parameter first followed by the column name(s) after the operator." msgstr "" #. Tag: para -#: filters.xml:115 #, no-c-format msgid "After being defined, a filter might be attached to multiple entities and/or collections each with its own condition. This can be problematic when the conditions are the same each time. Using <literal><filter-def/></literal> allows you to definine a default condition, either as an attribute or CDATA:" msgstr "" -#. Tag: programlisting -#: filters.xml:122 -#, no-c-format -msgid "" - "<![CDATA[<filter-def name=\"myFilter\" condition=\"abc > xyz\">...</filter-def>\n" - "<filter-def name=\"myOtherFilter\">abc=xyz</filter-def>]]>" -msgstr "" - #. Tag: para -#: filters.xml:124 #, no-c-format msgid "This default condition will be used whenever the filter is attached to something without specifying a condition. This means you can give a specific condition as part of the attachment of the filter that overrides the default condition in that particular case." msgstr "" Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/inheritance_mapping.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/inheritance_mapping.pot 2010-02-08 04:50:03 UTC (rev 18716) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/inheritance_mapping.pot 2010-02-08 04:56:55 UTC (rev 18717) @@ -1,631 +1,279 @@ -# SOME DESCRIPTIVE TITLE. -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. # -#, fuzzy msgid "" msgstr "" -"Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-16 18:47+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:19\n" +"PO-Revision-Date: 2010-01-08T04:07:19\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" "MIME-Version: 1.0\n" -"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Type: application/x-publican; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. Tag: title -#: inheritance_mapping.xml:29 #, no-c-format msgid "Inheritance mapping" msgstr "" #. Tag: title -#: inheritance_mapping.xml:32 #, no-c-format msgid "The three strategies" msgstr "" #. Tag: para -#: inheritance_mapping.xml:34 #, no-c-format msgid "Hibernate supports the three basic inheritance mapping strategies:" msgstr "" #. Tag: para -#: inheritance_mapping.xml:40 #, no-c-format msgid "table per class hierarchy" msgstr "" #. Tag: para -#: inheritance_mapping.xml:45 #, no-c-format -msgid "<para>table per subclass</para>" +msgid "table per subclass" msgstr "" #. Tag: para -#: inheritance_mapping.xml:50 #, no-c-format msgid "table per concrete class" msgstr "" #. Tag: para -#: inheritance_mapping.xml:56 #, no-c-format msgid "In addition, Hibernate supports a fourth, slightly different kind of polymorphism:" msgstr "" #. Tag: para -#: inheritance_mapping.xml:63 #, no-c-format msgid "implicit polymorphism" msgstr "" #. Tag: para -#: inheritance_mapping.xml:69 #, no-c-format msgid "It is possible to use different mapping strategies for different branches of the same inheritance hierarchy. You can then make use of implicit polymorphism to achieve polymorphism across the whole hierarchy. However, Hibernate does not support mixing <literal><subclass></literal>, <literal><joined-subclass></literal> and <literal><union-subclass></literal> mappings under the same root <literal><class></literal> element. It is possible to mix together the table per hierarchy and table per subclass strategies under the the same <literal><class></literal> element, by combining the <literal><subclass></literal> and <literal><join></literal> elements (see below for an example)." msgstr "" #. Tag: para -#: inheritance_mapping.xml:83 #, no-c-format msgid "It is possible to define <literal>subclass</literal>, <literal>union-subclass</literal>, and <literal>joined-subclass</literal> mappings in separate mapping documents directly beneath <literal>hibernate-mapping</literal>. This allows you to extend a class hierarchy by adding a new mapping file. You must specify an <literal>extends</literal> attribute in the subclass mapping, naming a previously mapped superclass. Previously this feature made the ordering of the mapping documents important. Since Hibernate3, the ordering of mapping files is irrelevant when using the extends keyword. The ordering inside a single mapping file still needs to be defined as superclasses before subclasses." msgstr "" -#. Tag: programlisting -#: inheritance_mapping.xml:94 -#, no-c-format -msgid "" - "<![CDATA[\n" - " <hibernate-mapping>\n" - " <subclass name=\"DomesticCat\" extends=\"Cat\" discriminator-value=\"D\">\n" - " <property name=\"name\" type=\"string\"/>\n" - " </subclass>\n" - " </hibernate-mapping>]]>" -msgstr "" - #. Tag: title -#: inheritance_mapping.xml:98 #, no-c-format msgid "Table per class hierarchy" msgstr "" #. Tag: para -#: inheritance_mapping.xml:100 #, no-c-format msgid "Suppose we have an interface <literal>Payment</literal> with the implementors <literal>CreditCardPayment</literal>, <literal>CashPayment</literal>, and <literal>ChequePayment</literal>. The table per hierarchy mapping would display in the following way:" msgstr "" -#. Tag: programlisting -#: inheritance_mapping.xml:107 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Payment\" table=\"PAYMENT\">\n" - " <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <discriminator column=\"PAYMENT_TYPE\" type=\"string\"/>\n" - " <property name=\"amount\" column=\"AMOUNT\"/>\n" - " ...\n" - " <subclass name=\"CreditCardPayment\" discriminator-value=\"CREDIT\">\n" - " <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" - " ...\n" - " </subclass>\n" - " <subclass name=\"CashPayment\" discriminator-value=\"CASH\">\n" - " ...\n" - " </subclass>\n" - " <subclass name=\"ChequePayment\" discriminator-value=\"CHEQUE\">\n" - " ...\n" - " </subclass>\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: inheritance_mapping.xml:109 #, no-c-format msgid "Exactly one table is required. There is a limitation of this mapping strategy: columns declared by the subclasses, such as <literal>CCTYPE</literal>, cannot have <literal>NOT NULL</literal> constraints." msgstr "" #. Tag: title -#: inheritance_mapping.xml:118 #, no-c-format msgid "Table per subclass" msgstr "" #. Tag: para -#: inheritance_mapping.xml:120 #, no-c-format msgid "A table per subclass mapping looks like this:" msgstr "" -#. Tag: programlisting -#: inheritance_mapping.xml:124 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Payment\" table=\"PAYMENT\">\n" - " <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"amount\" column=\"AMOUNT\"/>\n" - " ...\n" - " <joined-subclass name=\"CreditCardPayment\" table=\"CREDIT_PAYMENT\">\n" - " <key column=\"PAYMENT_ID\"/>\n" - " <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" - " ...\n" - " </joined-subclass>\n" - " <joined-subclass name=\"CashPayment\" table=\"CASH_PAYMENT\">\n" - " <key column=\"PAYMENT_ID\"/>\n" - " ...\n" - " </joined-subclass>\n" - " <joined-subclass name=\"ChequePayment\" table=\"CHEQUE_PAYMENT\">\n" - " <key column=\"PAYMENT_ID\"/>\n" - " ...\n" - " </joined-subclass>\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: inheritance_mapping.xml:126 #, no-c-format msgid "Four tables are required. The three subclass tables have primary key associations to the superclass table so the relational model is actually a one-to-one association." msgstr "" #. Tag: title -#: inheritance_mapping.xml:135 #, no-c-format msgid "Table per subclass: using a discriminator" msgstr "" #. Tag: para -#: inheritance_mapping.xml:137 #, no-c-format msgid "Hibernate's implementation of table per subclass does not require a discriminator column. Other object/relational mappers use a different implementation of table per subclass that requires a type discriminator column in the superclass table. The approach taken by Hibernate is much more difficult to implement, but arguably more correct from a relational point of view. If you want to use a discriminator column with the table per subclass strategy, you can combine the use of <literal><subclass></literal> and <literal><join></literal>, as follows:" msgstr "" -#. Tag: programlisting -#: inheritance_mapping.xml:149 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Payment\" table=\"PAYMENT\">\n" - " <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <discriminator column=\"PAYMENT_TYPE\" type=\"string\"/>\n" - " <property name=\"amount\" column=\"AMOUNT\"/>\n" - " ...\n" - " <subclass name=\"CreditCardPayment\" discriminator-value=\"CREDIT\">\n" - " <join table=\"CREDIT_PAYMENT\">\n" - " <key column=\"PAYMENT_ID\"/>\n" - " <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" - " ...\n" - " </join>\n" - " </subclass>\n" - " <subclass name=\"CashPayment\" discriminator-value=\"CASH\">\n" - " <join table=\"CASH_PAYMENT\">\n" - " <key column=\"PAYMENT_ID\"/>\n" - " ...\n" - " </join>\n" - " </subclass>\n" - " <subclass name=\"ChequePayment\" discriminator-value=\"CHEQUE\">\n" - " <join table=\"CHEQUE_PAYMENT\" fetch=\"select\">\n" - " <key column=\"PAYMENT_ID\"/>\n" - " ...\n" - " </join>\n" - " </subclass>\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: inheritance_mapping.xml:151 #, no-c-format msgid "The optional <literal>fetch=\"select\"</literal> declaration tells Hibernate not to fetch the <literal>ChequePayment</literal> subclass data using an outer join when querying the superclass." msgstr "" #. Tag: title -#: inheritance_mapping.xml:160 #, no-c-format msgid "Mixing table per class hierarchy with table per subclass" msgstr "" #. Tag: para -#: inheritance_mapping.xml:162 #, no-c-format msgid "You can even mix the table per hierarchy and table per subclass strategies using the following approach:" msgstr "" -#. Tag: programlisting -#: inheritance_mapping.xml:167 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Payment\" table=\"PAYMENT\">\n" - " <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <discriminator column=\"PAYMENT_TYPE\" type=\"string\"/>\n" - " <property name=\"amount\" column=\"AMOUNT\"/>\n" - " ...\n" - " <subclass name=\"CreditCardPayment\" discriminator-value=\"CREDIT\">\n" - " <join table=\"CREDIT_PAYMENT\">\n" - " <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" - " ...\n" - " </join>\n" - " </subclass>\n" - " <subclass name=\"CashPayment\" discriminator-value=\"CASH\">\n" - " ...\n" - " </subclass>\n" - " <subclass name=\"ChequePayment\" discriminator-value=\"CHEQUE\">\n" - " ...\n" - " </subclass>\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: inheritance_mapping.xml:169 #, no-c-format msgid "For any of these mapping strategies, a polymorphic association to the root <literal>Payment</literal> class is mapped using <literal><many-to-one></literal>." msgstr "" -#. Tag: programlisting -#: inheritance_mapping.xml:175 -#, no-c-format -msgid "<![CDATA[<many-to-one name=\"payment\" column=\"PAYMENT_ID\" class=\"Payment\"/>]]>" -msgstr "" - #. Tag: title -#: inheritance_mapping.xml:180 #, no-c-format msgid "Table per concrete class" msgstr "" #. Tag: para -#: inheritance_mapping.xml:182 #, no-c-format msgid "There are two ways we can map the table per concrete class strategy. First, you can use <literal><union-subclass></literal>." msgstr "" -#. Tag: programlisting -#: inheritance_mapping.xml:187 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Payment\">\n" - " <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <property name=\"amount\" column=\"AMOUNT\"/>\n" - " ...\n" - " <union-subclass name=\"CreditCardPayment\" table=\"CREDIT_PAYMENT\">\n" - " <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" - " ...\n" - " </union-subclass>\n" - " <union-subclass name=\"CashPayment\" table=\"CASH_PAYMENT\">\n" - " ...\n" - " </union-subclass>\n" - " <union-subclass name=\"ChequePayment\" table=\"CHEQUE_PAYMENT\">\n" - " ...\n" - " </union-subclass>\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: inheritance_mapping.xml:189 #, no-c-format msgid "Three tables are involved for the subclasses. Each table defines columns for all properties of the class, including inherited properties." msgstr "" #. Tag: para -#: inheritance_mapping.xml:194 #, no-c-format msgid "The limitation of this approach is that if a property is mapped on the superclass, the column name must be the same on all subclass tables. The identity generator strategy is not allowed in union subclass inheritance. The primary key seed has to be shared across all unioned subclasses of a hierarchy." msgstr "" #. Tag: para -#: inheritance_mapping.xml:203 #, no-c-format msgid "If your superclass is abstract, map it with <literal>abstract=\"true\"</literal>. If it is not abstract, an additional table (it defaults to <literal>PAYMENT</literal> in the example above), is needed to hold instances of the superclass." msgstr "" #. Tag: title -#: inheritance_mapping.xml:213 #, no-c-format msgid "Table per concrete class using implicit polymorphism" msgstr "" #. Tag: para -#: inheritance_mapping.xml:215 #, no-c-format msgid "An alternative approach is to make use of implicit polymorphism:" msgstr "" -#. Tag: programlisting -#: inheritance_mapping.xml:219 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"CreditCardPayment\" table=\"CREDIT_PAYMENT\">\n" - " <id name=\"id\" type=\"long\" column=\"CREDIT_PAYMENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"amount\" column=\"CREDIT_AMOUNT\"/>\n" - " ...\n" - "</class>\n" - "\n" - "<class name=\"CashPayment\" table=\"CASH_PAYMENT\">\n" - " <id name=\"id\" type=\"long\" column=\"CASH_PAYMENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"amount\" column=\"CASH_AMOUNT\"/>\n" - " ...\n" - "</class>\n" - "\n" - "<class name=\"ChequePayment\" table=\"CHEQUE_PAYMENT\">\n" - " <id name=\"id\" type=\"long\" column=\"CHEQUE_PAYMENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"amount\" column=\"CHEQUE_AMOUNT\"/>\n" - " ...\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: inheritance_mapping.xml:221 #, no-c-format -msgid "Notice that the <literal>Payment</literal> interface is not mentioned explicitly. Also notice that properties of <literal>Payment</literal> are mapped in each of the subclasses. If you want to avoid duplication, consider using XML entities (for example, <literal>[ <!ENTITY allproperties SYSTEM \"allproperties.xml\"> ]</literal> in the <literal>DOCTYPE</literal> declaration and <literal>&allproperties;</literal> in the mapping)." +msgid "Notice that the <literal>Payment</literal> interface is not mentioned explicitly. Also notice that properties of <literal>Payment</literal> are mapped in each of the subclasses. If you want to avoid duplication, consider using XML entities (for example, <literal>[ <!ENTITY allproperties SYSTEM \"allproperties.xml\"> ]</literal> in the <literal>DOCTYPE</literal> declaration and <literal>&allproperties&semi;</literal> in the mapping)." msgstr "" #. Tag: para -#: inheritance_mapping.xml:231 #, no-c-format msgid "The disadvantage of this approach is that Hibernate does not generate SQL <literal>UNION</literal>s when performing polymorphic queries." msgstr "" #. Tag: para -#: inheritance_mapping.xml:236 #, no-c-format msgid "For this mapping strategy, a polymorphic association to <literal>Payment</literal> is usually mapped using <literal><any></literal>." msgstr "" -#. Tag: programlisting -#: inheritance_mapping.xml:241 -#, no-c-format -msgid "" - "<![CDATA[<any name=\"payment\" meta-type=\"string\" id-type=\"long\">\n" - " <meta-value value=\"CREDIT\" class=\"CreditCardPayment\"/>\n" - " <meta-value value=\"CASH\" class=\"CashPayment\"/>\n" - " <meta-value value=\"CHEQUE\" class=\"ChequePayment\"/>\n" - " <column name=\"PAYMENT_CLASS\"/>\n" - " <column name=\"PAYMENT_ID\"/>\n" - "</any>]]>" -msgstr "" - #. Tag: title -#: inheritance_mapping.xml:246 #, no-c-format msgid "Mixing implicit polymorphism with other inheritance mappings" msgstr "" #. Tag: para -#: inheritance_mapping.xml:248 #, no-c-format msgid "Since the subclasses are each mapped in their own <literal><class></literal> element, and since <literal>Payment</literal> is just an interface), each of the subclasses could easily be part of another inheritance hierarchy. You can still use polymorphic queries against the <literal>Payment</literal> interface." msgstr "" -#. Tag: programlisting -#: inheritance_mapping.xml:256 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"CreditCardPayment\" table=\"CREDIT_PAYMENT\">\n" - " <id name=\"id\" type=\"long\" column=\"CREDIT_PAYMENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <discriminator column=\"CREDIT_CARD\" type=\"string\"/>\n" - " <property name=\"amount\" column=\"CREDIT_AMOUNT\"/>\n" - " ...\n" - " <subclass name=\"MasterCardPayment\" discriminator-value=\"MDC\"/>\n" - " <subclass name=\"VisaPayment\" discriminator-value=\"VISA\"/>\n" - "</class>\n" - "\n" - "<class name=\"NonelectronicTransaction\" table=\"NONELECTRONIC_TXN\">\n" - " <id name=\"id\" type=\"long\" column=\"TXN_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " ...\n" - " <joined-subclass name=\"CashPayment\" table=\"CASH_PAYMENT\">\n" - " <key column=\"PAYMENT_ID\"/>\n" - " <property name=\"amount\" column=\"CASH_AMOUNT\"/>\n" - " ...\n" - " </joined-subclass>\n" - " <joined-subclass name=\"ChequePayment\" table=\"CHEQUE_PAYMENT\">\n" - " <key column=\"PAYMENT_ID\"/>\n" - " <property name=\"amount\" column=\"CHEQUE_AMOUNT\"/>\n" - " ...\n" - " </joined-subclass>\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: inheritance_mapping.xml:258 #, no-c-format msgid "Once again, <literal>Payment</literal> is not mentioned explicitly. If we execute a query against the <literal>Payment</literal> interface, for example <literal>from Payment</literal>, Hibernate automatically returns instances of <literal>CreditCardPayment</literal> (and its subclasses, since they also implement <literal>Payment</literal>), <literal>CashPayment</literal> and <literal>ChequePayment</literal>, but not instances of <literal>NonelectronicTransaction</literal>." msgstr "" #. Tag: title -#: inheritance_mapping.xml:273 #, no-c-format msgid "Limitations" msgstr "" #. Tag: para -#: inheritance_mapping.xml:275 #, no-c-format msgid "There are limitations to the \"implicit polymorphism\" approach to the table per concrete-class mapping strategy. There are somewhat less restrictive limitations to <literal><union-subclass></literal> mappings." msgstr "" #. Tag: para -#: inheritance_mapping.xml:282 #, no-c-format -msgid "The following table shows the limitations of table per concrete-class mappings, and of implicit polymorphism, in Hibernate." +msgid "The following list shows the limitations of table per concrete-class mappings, and of implicit polymorphism, in Hibernate." msgstr "" -#. Tag: title -#: inheritance_mapping.xml:288 +#. Tag: term #, no-c-format -msgid "Features of inheritance mappings" +msgid "table per class-heirarchy" msgstr "" -#. Tag: entry -#: inheritance_mapping.xml:301 +#. Tag: para #, no-c-format -msgid "Inheritance strategy" +msgid "Polymorphic many-to-one: <code><many-to-one></code>" msgstr "" -#. Tag: entry -#: inheritance_mapping.xml:302 +#. Tag: para #, no-c-format -msgid "Polymorphic many-to-one" +msgid "Polymorphic one-to-one: <code><one-to-one></code>" msgstr "" -#. Tag: entry -#: inheritance_mapping.xml:303 +#. Tag: para #, no-c-format -msgid "Polymorphic one-to-one" +msgid "Polymorphic one-to-many: <code><one-to-many></code>" msgstr "" -#. Tag: entry -#: inheritance_mapping.xml:304 +#. Tag: para #, no-c-format -msgid "Polymorphic one-to-many" +msgid "Polymorphic many-to-many: <code><many-to-many></code>" msgstr "" -#. Tag: entry -#: inheritance_mapping.xml:305 +#. Tag: para #, no-c-format -msgid "Polymorphic many-to-many" +msgid "Polymorphic <literal>load()</literal> or <literal>get()</literal>: <code>s.get(Payment.class, id)</code>" msgstr "" -#. Tag: entry -#: inheritance_mapping.xml:306 +#. Tag: para #, no-c-format -msgid "Polymorphic <literal>load()/get()</literal>" +msgid "Polymorphic queries: <code>from Payment p</code>" msgstr "" -#. Tag: entry -#: inheritance_mapping.xml:307 +#. Tag: para #, no-c-format -msgid "Polymorphic queries" +msgid "Polymorphic joins: <code>from Order o join o.payment p</code>" msgstr "" -#. Tag: entry -#: inheritance_mapping.xml:308 +#. Tag: para #, no-c-format -msgid "Polymorphic joins" +msgid "Outer join fetching is supported." msgstr "" -#. Tag: entry -#: inheritance_mapping.xml:309 +#. Tag: term #, no-c-format -msgid "Outer join fetching" -msgstr "" - -#. Tag: entry -#: inheritance_mapping.xml:314 -#, no-c-format -msgid "table per class-hierarchy" -msgstr "" - -#. Tag: literal -#: inheritance_mapping.xml:315 inheritance_mapping.xml:326 inheritance_mapping.xml:337 -#, no-c-format -msgid "<many-to-one>" -msgstr "" - -#. Tag: literal -#: inheritance_mapping.xml:316 inheritance_mapping.xml:327 inheritance_mapping.xml:338 -#, no-c-format -msgid "<one-to-one>" -msgstr "" - -#. Tag: literal -#: inheritance_mapping.xml:317 inheritance_mapping.xml:328 -#, no-c-format -msgid "<one-to-many>" -msgstr "" - -#. Tag: literal -#: inheritance_mapping.xml:318 inheritance_mapping.xml:329 inheritance_mapping.xml:340 -#, no-c-format -msgid "<many-to-many>" -msgstr "" - -#. Tag: literal -#: inheritance_mapping.xml:319 inheritance_mapping.xml:330 inheritance_mapping.xml:341 -#, no-c-format -msgid "s.get(Payment.class, id)" -msgstr "" - -#. Tag: literal -#: inheritance_mapping.xml:320 inheritance_mapping.xml:331 inheritance_mapping.xml:342 inheritance_mapping.xml:353 -#, no-c-format -msgid "from Payment p" -msgstr "" - -#. Tag: literal -#: inheritance_mapping.xml:321 inheritance_mapping.xml:332 inheritance_mapping.xml:343 -#, no-c-format -msgid "from Order o join o.payment p" -msgstr "" - -#. Tag: emphasis -#: inheritance_mapping.xml:322 inheritance_mapping.xml:333 inheritance_mapping.xml:344 -#, no-c-format -msgid "supported" -msgstr "" - -#. Tag: entry -#: inheritance_mapping.xml:325 -#, no-c-format -msgid "<entry>table per subclass</entry>" -msgstr "" - -#. Tag: entry -#: inheritance_mapping.xml:336 -#, no-c-format msgid "table per concrete-class (union-subclass)" msgstr "" -#. Tag: entry -#: inheritance_mapping.xml:339 +#. Tag: para #, no-c-format -msgid "<literal><one-to-many></literal> (for <literal>inverse=\"true\"</literal> only)" +msgid "Polymorphic one-to-many: <code><one-to-many></code> (for <code>inverse=\"true\"</code> only)" msgstr "" -#. Tag: entry -#: inheritance_mapping.xml:347 +#. Tag: term #, no-c-format -msgid "table per concrete class (implicit polymorphism)" +msgid "table per concrete class (implicit polymorphism" msgstr "" -#. Tag: literal -#: inheritance_mapping.xml:348 +#. Tag: para #, no-c-format -msgid "<any>" +msgid "Polymorphic many-to-one: <code><any></code>" msgstr "" -#. Tag: emphasis -#: inheritance_mapping.xml:349 inheritance_mapping.xml:350 inheritance_mapping.xml:354 inheritance_mapping.xml:355 +#. Tag: para #, no-c-format -msgid "not supported" +msgid "Polymorphic <literal>load()</literal> or <literal>get()</literal>: <code>s.createCriteria(Payment.class).add( Restrictions.idEq(id) ).uniqueResult()</code>" msgstr "" -#. Tag: literal -#: inheritance_mapping.xml:351 +#. Tag: para #, no-c-format -msgid "<many-to-any>" +msgid "Polymorphic one-to-one, polymorphic one-to-many, polymorphic joins, and outer join fetching are not supported." msgstr "" -#. Tag: literal -#: inheritance_mapping.xml:352 -#, no-c-format -msgid "s.createCriteria(Payment.class).add( Restrictions.idEq(id) ).uniqueResult()" -msgstr "" - Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/performance.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/performance.pot 2010-02-08 04:50:03 UTC (rev 18716) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/performance.pot 2010-02-08 04:56:55 UTC (rev 18717) @@ -1,1561 +1,1033 @@ -# SOME DESCRIPTIVE TITLE. -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. # -#, fuzzy msgid "" msgstr "" -"Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-10 21:02+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:19\n" +"PO-Revision-Date: 2010-01-08T04:07:19\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" "MIME-Version: 1.0\n" -"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Type: application/x-publican; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. Tag: title -#: performance.xml:29 #, no-c-format msgid "Improving performance" msgstr "" #. Tag: title -#: performance.xml:32 #, no-c-format msgid "Fetching strategies" msgstr "" #. Tag: para -#: performance.xml:34 #, no-c-format msgid "Hibernate uses a <emphasis>fetching strategy</emphasis> to retrieve associated objects if the application needs to navigate the association. Fetch strategies can be declared in the O/R mapping metadata, or over-ridden by a particular HQL or <literal>Criteria</literal> query." msgstr "" #. Tag: para -#: performance.xml:41 #, no-c-format msgid "Hibernate3 defines the following fetching strategies:" msgstr "" #. Tag: para -#: performance.xml:47 #, no-c-format msgid "<emphasis>Join fetching</emphasis>: Hibernate retrieves the associated instance or collection in the same <literal>SELECT</literal>, using an <literal>OUTER JOIN</literal>." msgstr "" #. Tag: para -#: performance.xml:54 #, no-c-format msgid "<emphasis>Select fetching</emphasis>: a second <literal>SELECT</literal> is used to retrieve the associated entity or collection. Unless you explicitly disable lazy fetching by specifying <literal>lazy=\"false\"</literal>, this second select will only be executed when you access the association." msgstr "" #. Tag: para -#: performance.xml:63 #, no-c-format msgid "<emphasis>Subselect fetching</emphasis>: a second <literal>SELECT</literal> is used to retrieve the associated collections for all entities retrieved in a previous query or fetch. Unless you explicitly disable lazy fetching by specifying <literal>lazy=\"false\"</literal>, this second select will only be executed when you access the association." msgstr "" #. Tag: para -#: performance.xml:72 #, no-c-format msgid "<emphasis>Batch fetching</emphasis>: an optimization strategy for select fetching. Hibernate retrieves a batch of entity instances or collections in a single <literal>SELECT</literal> by specifying a list of primary or foreign keys." msgstr "" #. Tag: para -#: performance.xml:81 #, no-c-format msgid "Hibernate also distinguishes between:" msgstr "" #. Tag: para -#: performance.xml:87 #, no-c-format msgid "<emphasis>Immediate fetching</emphasis>: an association, collection or attribute is fetched immediately when the owner is loaded." msgstr "" #. Tag: para -#: performance.xml:93 #, no-c-format msgid "<emphasis>Lazy collection fetching</emphasis>: a collection is fetched when the application invokes an operation upon that collection. This is the default for collections." msgstr "" #. Tag: para -#: performance.xml:100 #, no-c-format msgid "<emphasis>\"Extra-lazy\" collection fetching</emphasis>: individual elements of the collection are accessed from the database as needed. Hibernate tries not to fetch the whole collection into memory unless absolutely needed. It is suitable for large collections." msgstr "" #. Tag: para -#: performance.xml:108 #, no-c-format msgid "<emphasis>Proxy fetching</emphasis>: a single-valued association is fetched when a method other than the identifier getter is invoked upon the associated object." msgstr "" #. Tag: para -#: performance.xml:115 #, no-c-format msgid "<emphasis>\"No-proxy\" fetching</emphasis>: a single-valued association is fetched when the instance variable is accessed. Compared to proxy fetching, this approach is less lazy; the association is fetched even when only the identifier is accessed. It is also more transparent, since no proxy is visible to the application. This approach requires buildtime bytecode instrumentation and is rarely necessary." msgstr "" #. Tag: para -#: performance.xml:125 #, no-c-format msgid "<emphasis>Lazy attribute fetching</emphasis>: an attribute or single valued association is fetched when the instance variable is accessed. This approach requires buildtime bytecode instrumentation and is rarely necessary." msgstr "" #. Tag: para -#: performance.xml:134 #, no-c-format msgid "We have two orthogonal notions here: <emphasis>when</emphasis> is the association fetched and <emphasis>how</emphasis> is it fetched. It is important that you do not confuse them. We use <literal>fetch</literal> to tune performance. We can use <literal>lazy</literal> to define a contract for what data is always available in any detached instance of a particular class." msgstr "" #. Tag: title -#: performance.xml:143 #, no-c-format msgid "Working with lazy associations" msgstr "" #. Tag: para -#: performance.xml:145 #, no-c-format msgid "By default, Hibernate3 uses lazy select fetching for collections and lazy proxy fetching for single-valued associations. These defaults make sense for most associations in the majority of applications." msgstr "" #. Tag: para -#: performance.xml:151 #, no-c-format msgid "If you set <literal>hibernate.default_batch_fetch_size</literal>, Hibernate will use the batch fetch optimization for lazy fetching. This optimization can also be enabled at a more granular level." msgstr "" #. Tag: para -#: performance.xml:158 #, no-c-format msgid "Please be aware that access to a lazy association outside of the context of an open Hibernate session will result in an exception. For example:" msgstr "" -#. Tag: programlisting -#: performance.xml:164 -#, no-c-format -msgid "" - "<![CDATA[s = sessions.openSession();\n" - "Transaction tx = s.beginTransaction();\n" - " \n" - "User u = (User) s.createQuery(\"from User u where u.name=:userName\")\n" - " .setString(\"userName\", userName).uniqueResult();\n" - "Map permissions = u.getPermissions();\n" - "\n" - "tx.commit();\n" - "s.close();\n" - "\n" - "Integer accessLevel = (Integer) permissions.get(\"accounts\"); // Error!]]>" -msgstr "" - #. Tag: para -#: performance.xml:166 #, no-c-format msgid "Since the permissions collection was not initialized when the <literal>Session</literal> was closed, the collection will not be able to load its state. <emphasis>Hibernate does not support lazy initialization for detached objects</emphasis>. This can be fixed by moving the code that reads from the collection to just before the transaction is committed." msgstr "" #. Tag: para -#: performance.xml:174 #, no-c-format msgid "Alternatively, you can use a non-lazy collection or association, by specifying <literal>lazy=\"false\"</literal> for the association mapping. However, it is intended that lazy initialization be used for almost all collections and associations. If you define too many non-lazy associations in your object model, Hibernate will fetch the entire database into memory in every transaction." msgstr "" #. Tag: para -#: performance.xml:183 #, no-c-format msgid "On the other hand, you can use join fetching, which is non-lazy by nature, instead of select fetching in a particular transaction. We will now explain how to customize the fetching strategy. In Hibernate3, the mechanisms for choosing a fetch strategy are identical for single-valued associations and collections." msgstr "" #. Tag: title -#: performance.xml:194 #, no-c-format msgid "Tuning fetch strategies" msgstr "" #. Tag: para -#: performance.xml:196 #, no-c-format msgid "Select fetching (the default) is extremely vulnerable to N+1 selects problems, so we might want to enable join fetching in the mapping document:" msgstr "" -#. Tag: programlisting -#: performance.xml:201 -#, no-c-format -msgid "" - "<![CDATA[<set name=\"permissions\" \n" - " fetch=\"join\">\n" - " <key column=\"userId\"/>\n" - " <one-to-many class=\"Permission\"/>\n" - "</set]]>" -msgstr "" - -#. Tag: programlisting -#: performance.xml:203 -#, no-c-format -msgid "<![CDATA[<many-to-one name=\"mother\" class=\"Cat\" fetch=\"join\"/>]]>" -msgstr "" - #. Tag: para -#: performance.xml:205 #, no-c-format msgid "The <literal>fetch</literal> strategy defined in the mapping document affects:" msgstr "" #. Tag: para -#: performance.xml:211 #, no-c-format msgid "retrieval via <literal>get()</literal> or <literal>load()</literal>" msgstr "" #. Tag: para -#: performance.xml:216 #, no-c-format msgid "retrieval that happens implicitly when an association is navigated" msgstr "" #. Tag: para -#: performance.xml:221 #, no-c-format msgid "<literal>Criteria</literal> queries" msgstr "" #. Tag: para -#: performance.xml:226 #, no-c-format msgid "HQL queries if <literal>subselect</literal> fetching is used" msgstr "" #. Tag: para -#: performance.xml:232 #, no-c-format msgid "Irrespective of the fetching strategy you use, the defined non-lazy graph is guaranteed to be loaded into memory. This might, however, result in several immediate selects being used to execute a particular HQL query." msgstr "" #. Tag: para -#: performance.xml:238 #, no-c-format msgid "Usually, the mapping document is not used to customize fetching. Instead, we keep the default behavior, and override it for a particular transaction, using <literal>left join fetch</literal> in HQL. This tells Hibernate to fetch the association eagerly in the first select, using an outer join. In the <literal>Criteria</literal> query API, you would use <literal>setFetchMode(FetchMode.JOIN)</literal>." msgstr "" #. Tag: para -#: performance.xml:247 #, no-c-format msgid "If you want to change the fetching strategy used by <literal>get()</literal> or <literal>load()</literal>, you can use a <literal>Criteria</literal> query. For example:" msgstr "" -#. Tag: programlisting -#: performance.xml:253 -#, no-c-format -msgid "" - "<![CDATA[User user = (User) session.createCriteria(User.class)\n" - " .setFetchMode(\"permissions\", FetchMode.JOIN)\n" - " .add( Restrictions.idEq(userId) )\n" - " .uniqueResult();]]>" -msgstr "" - #. Tag: para -#: performance.xml:255 #, no-c-format msgid "This is Hibernate's equivalent of what some ORM solutions call a \"fetch plan\"." msgstr "" #. Tag: para -#: performance.xml:259 #, no-c-format msgid "A completely different approach to problems with N+1 selects is to use the second-level cache." msgstr "" #. Tag: title -#: performance.xml:267 #, no-c-format msgid "Single-ended association proxies" msgstr "" #. Tag: para -#: performance.xml:269 #, no-c-format msgid "Lazy fetching for collections is implemented using Hibernate's own implementation of persistent collections. However, a different mechanism is needed for lazy behavior in single-ended associations. The target entity of the association must be proxied. Hibernate implements lazy initializing proxies for persistent objects using runtime bytecode enhancement which is accessed via the CGLIB library." msgstr "" #. Tag: para -#: performance.xml:277 #, no-c-format msgid "At startup, Hibernate3 generates proxies by default for all persistent classes and uses them to enable lazy fetching of <literal>many-to-one</literal> and <literal>one-to-one</literal> associations." msgstr "" #. Tag: para -#: performance.xml:283 #, no-c-format msgid "The mapping file may declare an interface to use as the proxy interface for that class, with the <literal>proxy</literal> attribute. By default, Hibernate uses a subclass of the class. <emphasis>The proxied class must implement a default constructor with at least package visibility. This constructor is recommended for all persistent classes</emphasis>." msgstr "" #. Tag: para -#: performance.xml:290 #, no-c-format msgid "There are potential problems to note when extending this approach to polymorphic classes.For example:" msgstr "" -#. Tag: programlisting -#: performance.xml:294 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Cat\" proxy=\"Cat\">\n" - " ......\n" - " <subclass name=\"DomesticCat\">\n" - " .....\n" - " </subclass>\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: performance.xml:296 #, no-c-format msgid "Firstly, instances of <literal>Cat</literal> will never be castable to <literal>DomesticCat</literal>, even if the underlying instance is an instance of <literal>DomesticCat</literal>:" msgstr "" -#. Tag: programlisting -#: performance.xml:302 -#, no-c-format -msgid "" - "<![CDATA[Cat cat = (Cat) session.load(Cat.class, id); // instantiate a proxy (does not hit the db)\n" - "if ( cat.isDomesticCat() ) { // hit the db to initialize the proxy\n" - " DomesticCat dc = (DomesticCat) cat; // Error!\n" - " ....\n" - "}]]>" -msgstr "" - #. Tag: para -#: performance.xml:304 #, no-c-format msgid "Secondly, it is possible to break proxy <literal>==</literal>:" msgstr "" -#. Tag: programlisting -#: performance.xml:308 -#, no-c-format -msgid "" - "<![CDATA[Cat cat = (Cat) session.load(Cat.class, id); // instantiate a Cat proxy\n" - "DomesticCat dc = \n" - " (DomesticCat) session.load(DomesticCat.class, id); // acquire new DomesticCat proxy!\n" - "System.out.println(cat==dc); // false]]>" -msgstr "" - #. Tag: para -#: performance.xml:310 #, no-c-format msgid "However, the situation is not quite as bad as it looks. Even though we now have two references to different proxy objects, the underlying instance will still be the same object:" msgstr "" -#. Tag: programlisting -#: performance.xml:315 -#, no-c-format -msgid "" - "<![CDATA[cat.setWeight(11.0); // hit the db to initialize the proxy\n" - "System.out.println( dc.getWeight() ); // 11.0]]>" -msgstr "" - #. Tag: para -#: performance.xml:317 #, no-c-format msgid "Third, you cannot use a CGLIB proxy for a <literal>final</literal> class or a class with any <literal>final</literal> methods." msgstr "" #. Tag: para -#: performance.xml:322 #, no-c-format msgid "Finally, if your persistent object acquires any resources upon instantiation (e.g. in initializers or default constructor), then those resources will also be acquired by the proxy. The proxy class is an actual subclass of the persistent class." msgstr "" #. Tag: para -#: performance.xml:328 #, no-c-format msgid "These problems are all due to fundamental limitations in Java's single inheritance model. To avoid these problems your persistent classes must each implement an interface that declares its business methods. You should specify these interfaces in the mapping file where <literal>CatImpl</literal> implements the interface <literal>Cat</literal> and <literal>DomesticCatImpl</literal> implements the interface <literal>DomesticCat</literal>. For example:" msgstr "" -#. Tag: programlisting -#: performance.xml:336 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"CatImpl\" proxy=\"Cat\">\n" - " ......\n" - " <subclass name=\"DomesticCatImpl\" proxy=\"DomesticCat\">\n" - " .....\n" - " </subclass>\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: performance.xml:338 #, no-c-format msgid "Then proxies for instances of <literal>Cat</literal> and <literal>DomesticCat</literal> can be returned by <literal>load()</literal> or <literal>iterate()</literal>." msgstr "" -#. Tag: programlisting -#: performance.xml:343 -#, no-c-format -msgid "" - "<![CDATA[Cat cat = (Cat) session.load(CatImpl.class, catid);\n" - "Iterator iter = session.createQuery(\"from CatImpl as cat where cat.name='fritz'\").iterate();\n" - "Cat fritz = (Cat) iter.next();]]>" -msgstr "" - #. Tag: title -#: performance.xml:346 #, no-c-format msgid "Note" msgstr "" #. Tag: para -#: performance.xml:347 #, no-c-format msgid "<literal>list()</literal> does not usually return proxies." msgstr "" #. Tag: para -#: performance.xml:352 #, no-c-format msgid "Relationships are also lazily initialized. This means you must declare any properties to be of type <literal>Cat</literal>, not <literal>CatImpl</literal>." msgstr "" #. Tag: para -#: performance.xml:357 #, no-c-format msgid "Certain operations do <emphasis>not</emphasis> require proxy initialization:" msgstr "" #. Tag: para -#: performance.xml:363 #, no-c-format msgid "<literal>equals()</literal>: if the persistent class does not override <literal>equals()</literal>" msgstr "" #. Tag: para -#: performance.xml:369 #, no-c-format msgid "<literal>hashCode()</literal>: if the persistent class does not override <literal>hashCode()</literal>" msgstr "" #. Tag: para -#: performance.xml:375 #, no-c-format msgid "The identifier getter method" msgstr "" #. Tag: para -#: performance.xml:381 #, no-c-format msgid "Hibernate will detect persistent classes that override <literal>equals()</literal> or <literal>hashCode()</literal>." msgstr "" #. Tag: para -#: performance.xml:386 #, no-c-format msgid "By choosing <literal>lazy=\"no-proxy\"</literal> instead of the default <literal>lazy=\"proxy\"</literal>, you can avoid problems associated with typecasting. However, buildtime bytecode instrumentation is required, and all operations will result in immediate proxy initialization." msgstr "" #. Tag: title -#: performance.xml:396 #, no-c-format msgid "Initializing collections and proxies" msgstr "" #. Tag: para -#: performance.xml:398 #, no-c-format msgid "A <literal>LazyInitializationException</literal> will be thrown by Hibernate if an uninitialized collection or proxy is accessed outside of the scope of the <literal>Session</literal>, i.e., when the entity owning the collection or having the reference to the proxy is in the detached state." msgstr "" #. Tag: para -#: performance.xml:404 #, no-c-format msgid "Sometimes a proxy or collection needs to be initialized before closing the <literal>Session</literal>. You can force initialization by calling <literal>cat.getSex()</literal> or <literal>cat.getKittens().size()</literal>, for example. However, this can be confusing to readers of the code and it is not convenient for generic code." msgstr "" #. Tag: para -#: performance.xml:411 #, no-c-format msgid "The static methods <literal>Hibernate.initialize()</literal> and <literal>Hibernate.isInitialized()</literal>, provide the application with a convenient way of working with lazily initialized collections or proxies. <literal>Hibernate.initialize(cat)</literal> will force the initialization of a proxy, <literal>cat</literal>, as long as its <literal>Session</literal> is still open. <literal>Hibernate.initialize( cat.getKittens() )</literal> has a similar effect for the collection of kittens." msgstr "" #. Tag: para -#: performance.xml:420 #, no-c-format msgid "Another option is to keep the <literal>Session</literal> open until all required collections and proxies have been loaded. In some application architectures, particularly where the code that accesses data using Hibernate, and the code that uses it are in different application layers or different physical processes, it can be a problem to ensure that the <literal>Session</literal> is open when a collection is initialized. There are two basic ways to deal with this issue:" msgstr "" #. Tag: para -#: performance.xml:431 #, no-c-format msgid "In a web-based application, a servlet filter can be used to close the <literal>Session</literal> only at the end of a user request, once the rendering of the view is complete (the <emphasis>Open Session in View</emphasis> pattern). Of course, this places heavy demands on the correctness of the exception handling of your application infrastructure. It is vitally important that the <literal>Session</literal> is closed and the transaction ended before returning to the user, even when an exception occurs during rendering of the view. See the Hibernate Wiki for examples of this \"Open Session in View\" pattern." msgstr "" #. Tag: para -#: performance.xml:444 #, no-c-format msgid "In an application with a separate business tier, the business logic must \"prepare\" all collections that the web tier needs before returning. This means that the business tier should load all the data and return all the data already initialized to the presentation/web tier that is required for a particular use case. Usually, the application calls <literal>Hibernate.initialize()</literal> for each collection that will be needed in the web tier (this call must occur before the session is closed) or retrieves the collection eagerly using a Hibernate query with a <literal>FETCH</literal> clause or a <literal>FetchMode.JOIN</literal> in <literal>Criteria</literal>. This is usually easier if you adopt the <emphasis>Command</emphasis> pattern instead of a <emphasis>Session Facade</emphasis>." msgstr "" #. Tag: para -#: performance.xml:459 #, no-c-format msgid "You can also attach a previously loaded object to a new <literal>Session</literal> with <literal>merge()</literal> or <literal>lock()</literal> before accessing uninitialized collections or other proxies. Hibernate does not, and certainly <emphasis>should</emphasis> not, do this automatically since it would introduce impromptu transaction semantics." msgstr "" #. Tag: para -#: performance.xml:469 #, no-c-format msgid "Sometimes you do not want to initialize a large collection, but still need some information about it, like its size, for example, or a subset of the data." msgstr "" #. Tag: para -#: performance.xml:474 #, no-c-format msgid "You can use a collection filter to get the size of a collection without initializing it:" msgstr "" -#. Tag: programlisting -#: performance.xml:478 -#, no-c-format -msgid "<![CDATA[( (Integer) s.createFilter( collection, \"select count(*)\" ).list().get(0) ).intValue()]]>" -msgstr "" - #. Tag: para -#: performance.xml:480 #, no-c-format msgid "The <literal>createFilter()</literal> method is also used to efficiently retrieve subsets of a collection without needing to initialize the whole collection:" msgstr "" -#. Tag: programlisting -#: performance.xml:485 -#, no-c-format -msgid "<![CDATA[s.createFilter( lazyCollection, \"\").setFirstResult(0).setMaxResults(10).list();]]>" -msgstr "" - #. Tag: title -#: performance.xml:490 #, no-c-format msgid "Using batch fetching" msgstr "" #. Tag: para -#: performance.xml:492 #, no-c-format msgid "Using batch fetching, Hibernate can load several uninitialized proxies if one proxy is accessed. Batch fetching is an optimization of the lazy select fetching strategy. There are two ways you can configure batch fetching: on the class level and the collection level." msgstr "" #. Tag: para -#: performance.xml:498 #, no-c-format msgid "Batch fetching for classes/entities is easier to understand. Consider the following example: at runtime you have 25 <literal>Cat</literal> instances loaded in a <literal>Session</literal>, and each <literal>Cat</literal> has a reference to its <literal>owner</literal>, a <literal>Person</literal>. The <literal>Person</literal> class is mapped with a proxy, <literal>lazy=\"true\"</literal>. If you now iterate through all cats and call <literal>getOwner()</literal> on each, Hibernate will, by default, execute 25 <literal>SELECT</literal> statements to retrieve the proxied owners. You can tune this behavior by specifying a <literal>batch-size</literal> in the mapping of <literal>Person</literal>:" msgstr "" -#. Tag: programlisting -#: performance.xml:508 -#, no-c-format -msgid "<![CDATA[<class name=\"Person\" batch-size=\"10\">...</class>]]>" -msgstr "" - #. Tag: para -#: performance.xml:510 #, no-c-format msgid "Hibernate will now execute only three queries: the pattern is 10, 10, 5." msgstr "" #. Tag: para -#: performance.xml:514 #, no-c-format msgid "You can also enable batch fetching of collections. For example, if each <literal>Person</literal> has a lazy collection of <literal>Cat</literal>s, and 10 persons are currently loaded in the <literal>Session</literal>, iterating through all persons will generate 10 <literal>SELECT</literal>s, one for every call to <literal>getCats()</literal>. If you enable batch fetching for the <literal>cats</literal> collection in the mapping of <literal>Person</literal>, Hibernate can pre-fetch collections:" msgstr "" -#. Tag: programlisting -#: performance.xml:523 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <set name=\"cats\" batch-size=\"3\">\n" - " ...\n" - " </set>\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: performance.xml:525 #, no-c-format msgid "With a <literal>batch-size</literal> of 3, Hibernate will load 3, 3, 3, 1 collections in four <literal>SELECT</literal>s. Again, the value of the attribute depends on the expected number of uninitialized collections in a particular <literal>Session</literal>." msgstr "" #. Tag: para -#: performance.xml:531 #, no-c-format msgid "Batch fetching of collections is particularly useful if you have a nested tree of items, i.e. the typical bill-of-materials pattern. However, a <emphasis>nested set</emphasis> or a <emphasis>materialized path</emphasis> might be a better option for read-mostly trees." msgstr "" #. Tag: title -#: performance.xml:540 #, no-c-format msgid "Using subselect fetching" msgstr "" #. Tag: para -#: performance.xml:542 #, no-c-format msgid "If one lazy collection or single-valued proxy has to be fetched, Hibernate will load all of them, re-running the original query in a subselect. This works in the same way as batch-fetching but without the piecemeal loading." msgstr "" #. Tag: title -#: performance.xml:553 #, no-c-format msgid "Using lazy property fetching" msgstr "" #. Tag: para -#: performance.xml:555 #, no-c-format msgid "Hibernate3 supports the lazy fetching of individual properties. This optimization technique is also known as <emphasis>fetch groups</emphasis>. Please note that this is mostly a marketing feature; optimizing row reads is much more important than optimization of column reads. However, only loading some properties of a class could be useful in extreme cases. For example, when legacy tables have hundreds of columns and the data model cannot be improved." msgstr "" #. Tag: para -#: performance.xml:564 #, no-c-format msgid "To enable lazy property loading, set the <literal>lazy</literal> attribute on your particular property mappings:" msgstr "" -#. Tag: programlisting -#: performance.xml:569 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Document\">\n" - " <id name=\"id\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"name\" not-null=\"true\" length=\"50\"/>\n" - " <property name=\"summary\" not-null=\"true\" length=\"200\" lazy=\"true\"/>\n" - " <property name=\"text\" not-null=\"true\" length=\"2000\" lazy=\"true\"/>\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: performance.xml:571 #, no-c-format msgid "Lazy property loading requires buildtime bytecode instrumentation. If your persistent classes are not enhanced, Hibernate will ignore lazy property settings and return to immediate fetching." msgstr "" #. Tag: para -#: performance.xml:577 #, no-c-format msgid "For bytecode instrumentation, use the following Ant task:" msgstr "" -#. Tag: programlisting -#: performance.xml:581 -#, no-c-format -msgid "" - "<![CDATA[<target name=\"instrument\" depends=\"compile\">\n" - " <taskdef name=\"instrument\" classname=\"org.hibernate.tool.instrument.InstrumentTask\">\n" - " <classpath path=\"${jar.path}\"/>\n" - " <classpath path=\"${classes.dir}\"/>\n" - " <classpath refid=\"lib.class.path\"/>\n" - " </taskdef>\n" - "\n" - " <instrument verbose=\"true\">\n" - " <fileset dir=\"${testclasses.dir}/org/hibernate/auction/model\">\n" - " <include name=\"*.class\"/>\n" - " </fileset>\n" - " </instrument>\n" - "</target>]]>" -msgstr "" - #. Tag: para -#: performance.xml:583 #, no-c-format msgid "A different way of avoiding unnecessary column reads, at least for read-only transactions, is to use the projection features of HQL or Criteria queries. This avoids the need for buildtime bytecode processing and is certainly a preferred solution." msgstr "" #. Tag: para -#: performance.xml:590 #, no-c-format msgid "You can force the usual eager fetching of properties using <literal>fetch all properties</literal> in HQL." msgstr "" #. Tag: title -#: performance.xml:600 #, no-c-format msgid "The Second Level Cache" msgstr "" #. Tag: para -#: performance.xml:602 #, no-c-format msgid "A Hibernate <literal>Session</literal> is a transaction-level cache of persistent data. It is possible to configure a cluster or JVM-level (<literal>SessionFactory</literal>-level) cache on a class-by-class and collection-by-collection basis. You can even plug in a clustered cache. Be aware that caches are not aware of changes made to the persistent store by another application. They can, however, be configured to regularly expire cached data." msgstr "" #. Tag: para -#: performance.xml:610 #, no-c-format msgid "You have the option to tell Hibernate which caching implementation to use by specifying the name of a class that implements <literal>org.hibernate.cache.CacheProvider</literal> using the property <literal>hibernate.cache.provider_class</literal>. Hibernate is bundled with a number of built-in integrations with the open-source cache providers that are listed below. You can also implement your own and plug it in as outlined above. Note that versions prior to 3.2 use EhCache as the default cache provider." msgstr "" #. Tag: title -#: performance.xml:621 #, no-c-format msgid "Cache Providers" msgstr "" #. Tag: entry -#: performance.xml:630 performance.xml:818 #, no-c-format msgid "Cache" msgstr "" #. Tag: entry -#: performance.xml:631 #, no-c-format msgid "Provider class" msgstr "" #. Tag: entry -#: performance.xml:632 #, no-c-format msgid "Type" msgstr "" #. Tag: entry -#: performance.xml:633 #, no-c-format msgid "Cluster Safe" msgstr "" #. Tag: entry -#: performance.xml:634 #, no-c-format msgid "Query Cache Supported" msgstr "" #. Tag: entry -#: performance.xml:639 performance.xml:827 #, no-c-format msgid "Hashtable (not intended for production use)" msgstr "" -#. Tag: literal -#: performance.xml:640 +#. Tag: entry #, no-c-format -msgid "org.hibernate.cache.HashtableCacheProvider" +msgid "<literal>org.hibernate.cache.HashtableCacheProvider</literal>" msgstr "" #. Tag: entry -#: performance.xml:641 #, no-c-format msgid "memory" msgstr "" #. Tag: entry -#: performance.xml:643 performance.xml:650 performance.xml:657 performance.xml:828 performance.xml:829 performance.xml:830 performance.xml:835 performance.xml:836 performance.xml:837 performance.xml:842 performance.xml:843 performance.xml:844 performance.xml:849 performance.xml:850 performance.xml:856 performance.xml:859 performance.xml:863 performance.xml:866 #, no-c-format -msgid "<entry>yes</entry>" +msgid "yes" msgstr "" #. Tag: entry -#: performance.xml:646 performance.xml:834 #, no-c-format msgid "EHCache" msgstr "" -#. Tag: literal -#: performance.xml:647 +#. Tag: entry #, no-c-format -msgid "org.hibernate.cache.EhCacheProvider" +msgid "<literal>org.hibernate.cache.EhCacheProvider</literal>" msgstr "" #. Tag: entry -#: performance.xml:648 performance.xml:655 #, no-c-format msgid "memory, disk" msgstr "" #. Tag: entry -#: performance.xml:653 performance.xml:841 #, no-c-format msgid "OSCache" msgstr "" -#. Tag: literal -#: performance.xml:654 +#. Tag: entry #, no-c-format -msgid "org.hibernate.cache.OSCacheProvider" +msgid "<literal>org.hibernate.cache.OSCacheProvider</literal>" msgstr "" #. Tag: entry -#: performance.xml:660 performance.xml:848 #, no-c-format msgid "SwarmCache" msgstr "" -#. Tag: literal -#: performance.xml:661 +#. Tag: entry #, no-c-format -msgid "org.hibernate.cache.SwarmCacheProvider" +msgid "<literal>org.hibernate.cache.SwarmCacheProvider</literal>" msgstr "" #. Tag: entry -#: performance.xml:662 #, no-c-format msgid "clustered (ip multicast)" msgstr "" #. Tag: entry -#: performance.xml:663 #, no-c-format msgid "yes (clustered invalidation)" msgstr "" #. Tag: entry -#: performance.xml:667 performance.xml:855 #, no-c-format msgid "JBoss Cache 1.x" msgstr "" -#. Tag: literal -#: performance.xml:668 +#. Tag: entry #, no-c-format -msgid "org.hibernate.cache.TreeCacheProvider" +msgid "<literal>org.hibernate.cache.TreeCacheProvider</literal>" msgstr "" #. Tag: entry -#: performance.xml:669 performance.xml:676 #, no-c-format msgid "clustered (ip multicast), transactional" msgstr "" #. Tag: entry -#: performance.xml:670 #, no-c-format msgid "yes (replication)" msgstr "" #. Tag: entry -#: performance.xml:671 performance.xml:678 #, no-c-format msgid "yes (clock sync req.)" msgstr "" #. Tag: entry -#: performance.xml:674 performance.xml:862 #, no-c-format msgid "JBoss Cache 2" msgstr "" -#. Tag: literal -#: performance.xml:675 +#. Tag: entry #, no-c-format -msgid "org.hibernate.cache.jbc2.JBossCacheRegionFactory" +msgid "<literal>org.hibernate.cache.jbc2.JBossCacheRegionFactory</literal>" msgstr "" #. Tag: entry -#: performance.xml:677 #, no-c-format msgid "yes (replication or invalidation)" msgstr "" #. Tag: title -#: performance.xml:685 #, no-c-format msgid "Cache mappings" msgstr "" #. Tag: para -#: performance.xml:687 #, no-c-format msgid "The <literal><cache></literal> element of a class or collection mapping has the following form:" msgstr "" -#. Tag: programlisting -#: performance.xml:698 -#, no-c-format -msgid "" - "<![CDATA[<cache \n" - " usage=\"transactional|read-write|nonstrict-read-write|read-only\"\n" - " region=\"RegionName\"\n" - " include=\"all|non-lazy\"\n" - "/>]]>" -msgstr "" - #. Tag: para -#: performance.xml:701 #, no-c-format msgid "<literal>usage</literal> (required) specifies the caching strategy: <literal>transactional</literal>, <literal>read-write</literal>, <literal>nonstrict-read-write</literal> or <literal>read-only</literal>" msgstr "" #. Tag: para -#: performance.xml:710 #, no-c-format msgid "<literal>region</literal> (optional: defaults to the class or collection role name): specifies the name of the second level cache region" msgstr "" #. Tag: para -#: performance.xml:717 #, no-c-format msgid "<literal>include</literal> (optional: defaults to <literal>all</literal>) <literal>non-lazy</literal>: specifies that properties of the entity mapped with <literal>lazy=\"true\"</literal> cannot be cached when attribute-level lazy fetching is enabled" msgstr "" #. Tag: para -#: performance.xml:727 #, no-c-format msgid "Alternatively, you can specify <literal><class-cache></literal> and <literal><collection-cache></literal> elements in <literal>hibernate.cfg.xml</literal>." msgstr "" #. Tag: para -#: performance.xml:732 #, no-c-format msgid "The <literal>usage</literal> attribute specifies a <emphasis>cache concurrency strategy</emphasis>." msgstr "" #. Tag: title -#: performance.xml:739 #, no-c-format msgid "Strategy: read only" msgstr "" #. Tag: para -#: performance.xml:741 #, no-c-format msgid "If your application needs to read, but not modify, instances of a persistent class, a <literal>read-only</literal> cache can be used. This is the simplest and optimal performing strategy. It is even safe for use in a cluster." msgstr "" -#. Tag: programlisting -#: performance.xml:747 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"eg.Immutable\" mutable=\"false\">\n" - " <cache usage=\"read-only\"/>\n" - " ....\n" - "</class>]]>" -msgstr "" - #. Tag: title -#: performance.xml:753 #, no-c-format msgid "Strategy: read/write" msgstr "" #. Tag: para -#: performance.xml:755 #, no-c-format msgid "If the application needs to update data, a <literal>read-write</literal> cache might be appropriate. This cache strategy should never be used if serializable transaction isolation level is required. If the cache is used in a JTA environment, you must specify the property <literal>hibernate.transaction.manager_lookup_class</literal> and naming a strategy for obtaining the JTA <literal>TransactionManager</literal>. In other environments, you should ensure that the transaction is completed when <literal>Session.close()</literal> or <literal>Session.disconnect()</literal> is called. If you want to use this strategy in a cluster, you should ensure that the underlying cache implementation supports locking. The built-in cache providers <emphasis>do not</emphasis> support locking." msgstr "" -#. Tag: programlisting -#: performance.xml:766 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"eg.Cat\" .... >\n" - " <cache usage=\"read-write\"/>\n" - " ....\n" - " <set name=\"kittens\" ... >\n" - " <cache usage=\"read-write\"/>\n" - " ....\n" - " </set>\n" - "</class>]]>" -msgstr "" - #. Tag: title -#: performance.xml:771 #, no-c-format msgid "Strategy: nonstrict read/write" msgstr "" #. Tag: para -#: performance.xml:773 #, no-c-format msgid "If the application only occasionally needs to update data (i.e. if it is extremely unlikely that two transactions would try to update the same item simultaneously), and strict transaction isolation is not required, a <literal>nonstrict-read-write</literal> cache might be appropriate. If the cache is used in a JTA environment, you must specify <literal>hibernate.transaction.manager_lookup_class</literal>. In other environments, you should ensure that the transaction is completed when <literal>Session.close()</literal> or <literal>Session.disconnect()</literal> is called." msgstr "" #. Tag: title -#: performance.xml:785 #, no-c-format msgid "Strategy: transactional" msgstr "" #. Tag: para -#: performance.xml:787 #, no-c-format msgid "The <literal>transactional</literal> cache strategy provides support for fully transactional cache providers such as JBoss TreeCache. Such a cache can only be used in a JTA environment and you must specify <literal>hibernate.transaction.manager_lookup_class</literal>." msgstr "" #. Tag: title -#: performance.xml:796 #, no-c-format msgid "Cache-provider/concurrency-strategy compatibility" msgstr "" #. Tag: para -#: performance.xml:799 #, no-c-format msgid "None of the cache providers support all of the cache concurrency strategies." msgstr "" #. Tag: para -#: performance.xml:804 #, no-c-format msgid "The following table shows which providers are compatible with which concurrency strategies." msgstr "" #. Tag: title -#: performance.xml:809 #, no-c-format msgid "Cache Concurrency Strategy Support" msgstr "" #. Tag: entry -#: performance.xml:819 #, no-c-format msgid "read-only" msgstr "" #. Tag: entry -#: performance.xml:820 #, no-c-format msgid "nonstrict-read-write" msgstr "" #. Tag: entry -#: performance.xml:821 #, no-c-format msgid "read-write" msgstr "" #. Tag: entry -#: performance.xml:822 #, no-c-format msgid "transactional" msgstr "" #. Tag: title -#: performance.xml:877 #, no-c-format msgid "Managing the caches" msgstr "" #. Tag: para -#: performance.xml:879 #, no-c-format msgid "Whenever you pass an object to <literal>save()</literal>, <literal>update()</literal> or <literal>saveOrUpdate()</literal>, and whenever you retrieve an object using <literal>load()</literal>, <literal>get()</literal>, <literal>list()</literal>, <literal>iterate()</literal> or <literal>scroll()</literal>, that object is added to the internal cache of the <literal>Session</literal>." msgstr "" #. Tag: para -#: performance.xml:886 #, no-c-format msgid "When <literal>flush()</literal> is subsequently called, the state of that object will be synchronized with the database. If you do not want this synchronization to occur, or if you are processing a huge number of objects and need to manage memory efficiently, the <literal>evict()</literal> method can be used to remove the object and its collections from the first-level cache." msgstr "" -#. Tag: programlisting -#: performance.xml:894 -#, no-c-format -msgid "" - "<![CDATA[ScrollableResult cats = sess.createQuery(\"from Cat as cat\").scroll(); //a huge result set\n" - "while ( cats.next() ) {\n" - " Cat cat = (Cat) cats.get(0);\n" - " doSomethingWithACat(cat);\n" - " sess.evict(cat);\n" - "}]]>" -msgstr "" - #. Tag: para -#: performance.xml:896 #, no-c-format msgid "The <literal>Session</literal> also provides a <literal>contains()</literal> method to determine if an instance belongs to the session cache." msgstr "" #. Tag: para -#: performance.xml:901 #, no-c-format msgid "To evict all objects from the session cache, call <literal>Session.clear()</literal>" msgstr "" #. Tag: para -#: performance.xml:905 #, no-c-format msgid "For the second-level cache, there are methods defined on <literal>SessionFactory</literal> for evicting the cached state of an instance, entire class, collection instance or entire collection role." msgstr "" -#. Tag: programlisting -#: performance.xml:911 -#, no-c-format -msgid "" - "<![CDATA[sessionFactory.evict(Cat.class, catId); //evict a particular Cat\n" - "sessionFactory.evict(Cat.class); //evict all Cats\n" - "sessionFactory.evictCollection(\"Cat.kittens\", catId); //evict a particular collection of kittens\n" - "sessionFactory.evictCollection(\"Cat.kittens\"); //evict all kitten collections]]>" -msgstr "" - #. Tag: para -#: performance.xml:913 #, no-c-format msgid "The <literal>CacheMode</literal> controls how a particular session interacts with the second-level cache:" msgstr "" #. Tag: para -#: performance.xml:920 #, no-c-format msgid "<literal>CacheMode.NORMAL</literal>: will read items from and write items to the second-level cache" msgstr "" #. Tag: para -#: performance.xml:925 #, no-c-format msgid "<literal>CacheMode.GET</literal>: will read items from the second-level cache. Do not write to the second-level cache except when updating data" msgstr "" #. Tag: para -#: performance.xml:931 #, no-c-format msgid "<literal>CacheMode.PUT</literal>: will write items to the second-level cache. Do not read from the second-level cache" msgstr "" #. Tag: para -#: performance.xml:937 #, no-c-format msgid "<literal>CacheMode.REFRESH</literal>: will write items to the second-level cache. Do not read from the second-level cache. Bypass the effect of <literal>hibernate.cache.use_minimal_puts</literal> forcing a refresh of the second-level cache for all items read from the database" msgstr "" #. Tag: para -#: performance.xml:945 #, no-c-format msgid "To browse the contents of a second-level or query cache region, use the <literal>Statistics</literal> API:" msgstr "" -#. Tag: programlisting -#: performance.xml:950 -#, no-c-format -msgid "" - "<![CDATA[Map cacheEntries = sessionFactory.getStatistics()\n" - " .getSecondLevelCacheStatistics(regionName)\n" - " .getEntries();]]>" -msgstr "" - #. Tag: para -#: performance.xml:952 #, no-c-format msgid "You will need to enable statistics and, optionally, force Hibernate to keep the cache entries in a more readable format:" msgstr "" -#. Tag: programlisting -#: performance.xml:957 -#, no-c-format -msgid "" - "<![CDATA[hibernate.generate_statistics true\n" - "hibernate.cache.use_structured_entries true]]>" -msgstr "" - #. Tag: title -#: performance.xml:962 #, no-c-format msgid "The Query Cache" msgstr "" #. Tag: para -#: performance.xml:964 #, no-c-format msgid "Query result sets can also be cached. This is only useful for queries that are run frequently with the same parameters. You will first need to enable the query cache:" msgstr "" -#. Tag: programlisting -#: performance.xml:969 -#, no-c-format -msgid "<![CDATA[hibernate.cache.use_query_cache true]]>" -msgstr "" - #. Tag: para -#: performance.xml:971 #, no-c-format msgid "This setting creates two new cache regions: one holding cached query result sets (<literal>org.hibernate.cache.StandardQueryCache</literal>), the other holding timestamps of the most recent updates to queryable tables (<literal>org.hibernate.cache.UpdateTimestampsCache</literal>). Note that the query cache does not cache the state of the actual entities in the result set; it caches only identifier values and results of value type. The query cache should always be used in conjunction with the second-level cache." msgstr "" #. Tag: para -#: performance.xml:981 #, no-c-format msgid "Most queries do not benefit from caching, so by default, queries are not cached. To enable caching, call <literal>Query.setCacheable(true)</literal>. This call allows the query to look for existing cache results or add its results to the cache when it is executed." msgstr "" #. Tag: para -#: performance.xml:988 #, no-c-format msgid "If you require fine-grained control over query cache expiration policies, you can specify a named cache region for a particular query by calling <literal>Query.setCacheRegion()</literal>." msgstr "" -#. Tag: programlisting -#: performance.xml:994 -#, no-c-format -msgid "" - "<![CDATA[List blogs = sess.createQuery(\"from Blog blog where blog.blogger = :blogger\")\n" - " .setEntity(\"blogger\", blogger)\n" - " .setMaxResults(15)\n" - " .setCacheable(true)\n" - " .setCacheRegion(\"frontpages\")\n" - " .list();]]>" -msgstr "" - #. Tag: para -#: performance.xml:996 #, no-c-format msgid "If the query should force a refresh of its query cache region, you should call <literal>Query.setCacheMode(CacheMode.REFRESH)</literal>. This is particularly useful in cases where underlying data may have been updated via a separate process (i.e., not modified through Hibernate) and allows the application to selectively refresh particular query result sets. This is a more efficient alternative to eviction of a query cache region via <literal>SessionFactory.evictQueries()</literal>." msgstr "" #. Tag: title -#: performance.xml:1008 #, no-c-format msgid "Understanding Collection performance" msgstr "" #. Tag: para -#: performance.xml:1010 #, no-c-format msgid "In the previous sections we have covered collections and their applications. In this section we explore some more issues in relation to collections at runtime." msgstr "" #. Tag: title -#: performance.xml:1017 #, no-c-format msgid "Taxonomy" msgstr "" #. Tag: para -#: performance.xml:1019 #, no-c-format msgid "Hibernate defines three basic kinds of collections:" msgstr "" #. Tag: para -#: performance.xml:1023 #, no-c-format msgid "collections of values" msgstr "" #. Tag: para -#: performance.xml:1026 #, no-c-format msgid "one-to-many associations" msgstr "" #. Tag: para -#: performance.xml:1029 #, no-c-format msgid "many-to-many associations" msgstr "" #. Tag: para -#: performance.xml:1033 #, no-c-format msgid "This classification distinguishes the various table and foreign key relationships but does not tell us quite everything we need to know about the relational model. To fully understand the relational structure and performance characteristics, we must also consider the structure of the primary key that is used by Hibernate to update or delete collection rows. This suggests the following classification:" msgstr "" #. Tag: para -#: performance.xml:1044 #, no-c-format msgid "indexed collections" msgstr "" #. Tag: para -#: performance.xml:1047 #, no-c-format msgid "sets" msgstr "" #. Tag: para -#: performance.xml:1050 #, no-c-format msgid "bags" msgstr "" #. Tag: para -#: performance.xml:1054 #, no-c-format msgid "All indexed collections (maps, lists, and arrays) have a primary key consisting of the <literal><key></literal> and <literal><index></literal> columns. In this case, collection updates are extremely efficient. The primary key can be efficiently indexed and a particular row can be efficiently located when Hibernate tries to update or delete it." msgstr "" #. Tag: para -#: performance.xml:1062 #, no-c-format msgid "Sets have a primary key consisting of <literal><key></literal> and element columns. This can be less efficient for some types of collection element, particularly composite elements or large text or binary fields, as the database may not be able to index a complex primary key as efficiently. However, for one-to-many or many-to-many associations, particularly in the case of synthetic identifiers, it is likely to be just as efficient. If you want <literal>SchemaExport</literal> to actually create the primary key of a <literal><set></literal>, you must declare all columns as <literal>not-null=\"true\"</literal>." msgstr "" #. Tag: para -#: performance.xml:1073 #, no-c-format msgid "<literal><idbag></literal> mappings define a surrogate key, so they are efficient to update. In fact, they are the best case." msgstr "" #. Tag: para -#: performance.xml:1078 #, no-c-format msgid "Bags are the worst case since they permit duplicate element values and, as they have no index column, no primary key can be defined. Hibernate has no way of distinguishing between duplicate rows. Hibernate resolves this problem by completely removing in a single <literal>DELETE</literal> and recreating the collection whenever it changes. This can be inefficient." msgstr "" #. Tag: para -#: performance.xml:1086 #, no-c-format msgid "For a one-to-many association, the \"primary key\" may not be the physical primary key of the database table. Even in this case, the above classification is still useful. It reflects how Hibernate \"locates\" individual rows of the collection." msgstr "" #. Tag: title -#: performance.xml:1096 #, no-c-format msgid "Lists, maps, idbags and sets are the most efficient collections to update" msgstr "" #. Tag: para -#: performance.xml:1098 #, no-c-format msgid "From the discussion above, it should be clear that indexed collections and sets allow the most efficient operation in terms of adding, removing and updating elements." msgstr "" #. Tag: para -#: performance.xml:1104 #, no-c-format msgid "There is, arguably, one more advantage that indexed collections have over sets for many-to-many associations or collections of values. Because of the structure of a <literal>Set</literal>, Hibernate does not <literal>UPDATE</literal> a row when an element is \"changed\". Changes to a <literal>Set</literal> always work via <literal>INSERT</literal> and <literal>DELETE</literal> of individual rows. Once again, this consideration does not apply to one-to-many associations." msgstr "" #. Tag: para -#: performance.xml:1113 #, no-c-format msgid "After observing that arrays cannot be lazy, you can conclude that lists, maps and idbags are the most performant (non-inverse) collection types, with sets not far behind. You can expect sets to be the most common kind of collection in Hibernate applications. This is because the \"set\" semantics are most natural in the relational model." msgstr "" #. Tag: para -#: performance.xml:1121 #, no-c-format msgid "However, in well-designed Hibernate domain models, most collections are in fact one-to-many associations with <literal>inverse=\"true\"</literal>. For these associations, the update is handled by the many-to-one end of the association, and so considerations of collection update performance simply do not apply." msgstr "" #. Tag: title -#: performance.xml:1131 #, no-c-format msgid "Bags and lists are the most efficient inverse collections" msgstr "" #. Tag: para -#: performance.xml:1133 #, no-c-format msgid "There is a particular case, however, in which bags, and also lists, are much more performant than sets. For a collection with <literal>inverse=\"true\"</literal>, the standard bidirectional one-to-many relationship idiom, for example, we can add elements to a bag or list without needing to initialize (fetch) the bag elements. This is because, unlike a <literal>set</literal>, <literal>Collection.add()</literal> or <literal>Collection.addAll()</literal> must always return true for a bag or <literal>List</literal>. This can make the following common code much faster:" msgstr "" -#. Tag: programlisting -#: performance.xml:1143 -#, no-c-format -msgid "" - "<![CDATA[Parent p = (Parent) sess.load(Parent.class, id);\n" - "Child c = new Child();\n" - "c.setParent(p);\n" - "p.getChildren().add(c); //no need to fetch the collection!\n" - "sess.flush();]]>" -msgstr "" - #. Tag: title -#: performance.xml:1148 #, no-c-format msgid "One shot delete" msgstr "" #. Tag: para -#: performance.xml:1150 #, no-c-format msgid "Deleting collection elements one by one can sometimes be extremely inefficient. Hibernate knows not to do that in the case of an newly-empty collection (if you called <literal>list.clear()</literal>, for example). In this case, Hibernate will issue a single <literal>DELETE</literal>." msgstr "" #. Tag: para -#: performance.xml:1157 #, no-c-format msgid "Suppose you added a single element to a collection of size twenty and then remove two elements. Hibernate will issue one <literal>INSERT</literal> statement and two <literal>DELETE</literal> statements, unless the collection is a bag. This is certainly desirable." msgstr "" #. Tag: para -#: performance.xml:1163 #, no-c-format msgid "However, suppose that we remove eighteen elements, leaving two and then add thee new elements. There are two possible ways to proceed" msgstr "" #. Tag: para -#: performance.xml:1170 #, no-c-format msgid "delete eighteen rows one by one and then insert three rows" msgstr "" #. Tag: para -#: performance.xml:1173 #, no-c-format msgid "remove the whole collection in one SQL <literal>DELETE</literal> and insert all five current elements one by one" msgstr "" #. Tag: para -#: performance.xml:1178 #, no-c-format msgid "Hibernate cannot know that the second option is probably quicker. It would probably be undesirable for Hibernate to be that intuitive as such behavior might confuse database triggers, etc." msgstr "" #. Tag: para -#: performance.xml:1184 #, no-c-format msgid "Fortunately, you can force this behavior (i.e. the second strategy) at any time by discarding (i.e. dereferencing) the original collection and returning a newly instantiated collection with all the current elements." msgstr "" #. Tag: para -#: performance.xml:1190 #, no-c-format msgid "One-shot-delete does not apply to collections mapped <literal>inverse=\"true\"</literal>." msgstr "" #. Tag: title -#: performance.xml:1199 #, no-c-format msgid "Monitoring performance" msgstr "" #. Tag: para -#: performance.xml:1201 #, no-c-format msgid "Optimization is not much use without monitoring and access to performance numbers. Hibernate provides a full range of figures about its internal operations. Statistics in Hibernate are available per <literal>SessionFactory</literal>." msgstr "" #. Tag: title -#: performance.xml:1208 #, no-c-format msgid "Monitoring a SessionFactory" msgstr "" #. Tag: para -#: performance.xml:1210 #, no-c-format msgid "You can access <literal>SessionFactory</literal> metrics in two ways. Your first option is to call <literal>sessionFactory.getStatistics()</literal> and read or display the <literal>Statistics</literal> yourself." msgstr "" #. Tag: para -#: performance.xml:1216 #, no-c-format msgid "Hibernate can also use JMX to publish metrics if you enable the <literal>StatisticsService</literal> MBean. You can enable a single MBean for all your <literal>SessionFactory</literal> or one per factory. See the following code for minimalistic configuration examples:" msgstr "" -#. Tag: programlisting -#: performance.xml:1223 -#, no-c-format -msgid "" - "<![CDATA[// MBean service registration for a specific SessionFactory\n" - "Hashtable tb = new Hashtable();\n" - "tb.put(\"type\", \"statistics\");\n" - "tb.put(\"sessionFactory\", \"myFinancialApp\");\n" - "ObjectName on = new ObjectName(\"hibernate\", tb); // MBean object name\n" - "\n" - "StatisticsService stats = new StatisticsService(); // MBean implementation\n" - "stats.setSessionFactory(sessionFactory); // Bind the stats to a SessionFactory\n" - "server.registerMBean(stats, on); // Register the Mbean on the server]]>" -msgstr "" - -#. Tag: programlisting -#: performance.xml:1226 -#, no-c-format -msgid "" - "<![CDATA[// MBean service registration for all SessionFactory's\n" - "Hashtable tb = new Hashtable();\n" - "tb.put(\"type\", \"statistics\");\n" - "tb.put(\"sessionFactory\", \"all\");\n" - "ObjectName on = new ObjectName(\"hibernate\", tb); // MBean object name\n" - "\n" - "StatisticsService stats = new StatisticsService(); // MBean implementation\n" - "server.registerMBean(stats, on); // Register the MBean on the server]]>" -msgstr "" - #. Tag: para -#: performance.xml:1233 #, no-c-format msgid "You can activate and deactivate the monitoring for a <literal>SessionFactory</literal>:" msgstr "" #. Tag: para -#: performance.xml:1238 #, no-c-format msgid "at configuration time, set <literal>hibernate.generate_statistics</literal> to <literal>false</literal>" msgstr "" #. Tag: para -#: performance.xml:1245 #, no-c-format msgid "at runtime: <literal>sf.getStatistics().setStatisticsEnabled(true)</literal> or <literal>hibernateStatsBean.setStatisticsEnabled(true)</literal>" msgstr "" #. Tag: para -#: performance.xml:1252 #, no-c-format msgid "Statistics can be reset programmatically using the <literal>clear()</literal> method. A summary can be sent to a logger (info level) using the <literal>logSummary()</literal> method." msgstr "" #. Tag: title -#: performance.xml:1261 #, no-c-format msgid "Metrics" msgstr "" #. Tag: para -#: performance.xml:1263 #, no-c-format msgid "Hibernate provides a number of metrics, from basic information to more specialized information that is only relevant in certain scenarios. All available counters are described in the <literal>Statistics</literal> interface API, in three categories:" msgstr "" #. Tag: para -#: performance.xml:1270 #, no-c-format msgid "Metrics related to the general <literal>Session</literal> usage, such as number of open sessions, retrieved JDBC connections, etc." msgstr "" #. Tag: para -#: performance.xml:1276 #, no-c-format msgid "Metrics related to the entities, collections, queries, and caches as a whole (aka global metrics)." msgstr "" #. Tag: para -#: performance.xml:1282 #, no-c-format msgid "Detailed metrics related to a particular entity, collection, query or cache region." msgstr "" #. Tag: para -#: performance.xml:1289 #, no-c-format msgid "For example, you can check the cache hit, miss, and put ratio of entities, collections and queries, and the average time a query needs. Be aware that the number of milliseconds is subject to approximation in Java. Hibernate is tied to the JVM precision and on some platforms this might only be accurate to 10 seconds." msgstr "" #. Tag: para -#: performance.xml:1296 #, no-c-format msgid "Simple getters are used to access the global metrics (i.e. not tied to a particular entity, collection, cache region, etc.). You can access the metrics of a particular entity, collection or cache region through its name, and through its HQL or SQL representation for queries. Please refer to the <literal>Statistics</literal>, <literal>EntityStatistics</literal>, <literal>CollectionStatistics</literal>, <literal>SecondLevelCacheStatistics</literal>, and <literal>QueryStatistics</literal> API Javadoc for more information. The following code is a simple example:" msgstr "" -#. Tag: programlisting -#: performance.xml:1306 -#, no-c-format -msgid "" - "<![CDATA[Statistics stats = HibernateUtil.sessionFactory.getStatistics();\n" - "\n" - "double queryCacheHitCount = stats.getQueryCacheHitCount();\n" - "double queryCacheMissCount = stats.getQueryCacheMissCount();\n" - "double queryCacheHitRatio =\n" - " queryCacheHitCount / (queryCacheHitCount + queryCacheMissCount);\n" - "\n" - "log.info(\"Query Hit ratio:\" + queryCacheHitRatio);\n" - "\n" - "EntityStatistics entityStats =\n" - " stats.getEntityStatistics( Cat.class.getName() );\n" - "long changes =\n" - " entityStats.getInsertCount()\n" - " + entityStats.getUpdateCount()\n" - " + entityStats.getDeleteCount();\n" - "log.info(Cat.class.getName() + \" changed \" + changes + \"times\" );]]>" -msgstr "" - #. Tag: para -#: performance.xml:1308 #, no-c-format msgid "You can work on all entities, collections, queries and region caches, by retrieving the list of names of entities, collections, queries and region caches using the following methods: <literal>getQueries()</literal>, <literal>getEntityNames()</literal>, <literal>getCollectionRoleNames()</literal>, and <literal>getSecondLevelCacheRegionNames()</literal>." msgstr "" Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/persistent_classes.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/persistent_classes.pot 2010-02-08 04:50:03 UTC (rev 18716) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/persistent_classes.pot 2010-02-08 04:56:55 UTC (rev 18717) @@ -1,709 +1,283 @@ -# SOME DESCRIPTIVE TITLE. -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. # -#, fuzzy msgid "" msgstr "" -"Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-10 21:02+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:19\n" +"PO-Revision-Date: 2010-01-08T04:07:19\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" "MIME-Version: 1.0\n" -"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Type: application/x-publican; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. Tag: title -#: persistent_classes.xml:29 #, no-c-format msgid "Persistent Classes" msgstr "" #. Tag: para -#: persistent_classes.xml:31 #, no-c-format msgid "Persistent classes are classes in an application that implement the entities of the business problem (e.g. Customer and Order in an E-commerce application). Not all instances of a persistent class are considered to be in the persistent state. For example, an instance can instead be transient or detached." msgstr "" #. Tag: para -#: persistent_classes.xml:38 #, no-c-format msgid "Hibernate works best if these classes follow some simple rules, also known as the Plain Old Java Object (POJO) programming model. However, none of these rules are hard requirements. Indeed, Hibernate3 assumes very little about the nature of your persistent objects. You can express a domain model in other ways (using trees of <literal>Map</literal> instances, for example)." msgstr "" #. Tag: title -#: persistent_classes.xml:47 #, no-c-format msgid "A simple POJO example" msgstr "" #. Tag: para -#: persistent_classes.xml:49 #, no-c-format msgid "Most Java applications require a persistent class representing felines. For example:" msgstr "" -#. Tag: programlisting -#: persistent_classes.xml:53 -#, no-c-format -msgid "" - "<![CDATA[package eg;\n" - "import java.util.Set;\n" - "import java.util.Date;\n" - "\n" - "public class Cat {\n" - " private Long id; // identifier\n" - "\n" - " private Date birthdate;\n" - " private Color color;\n" - " private char sex;\n" - " private float weight;\n" - " private int litterId;\n" - "\n" - " private Cat mother;\n" - " private Set kittens = new HashSet();\n" - "\n" - " private void setId(Long id) {\n" - " this.id=id;\n" - " }\n" - " public Long getId() {\n" - " return id;\n" - " }\n" - "\n" - " void setBirthdate(Date date) {\n" - " birthdate = date;\n" - " }\n" - " public Date getBirthdate() {\n" - " return birthdate;\n" - " }\n" - "\n" - " void setWeight(float weight) {\n" - " this.weight = weight;\n" - " }\n" - " public float getWeight() {\n" - " return weight;\n" - " }\n" - "\n" - " public Color getColor() {\n" - " return color;\n" - " }\n" - " void setColor(Color color) {\n" - " this.color = color;\n" - " }\n" - "\n" - " void setSex(char sex) {\n" - " this.sex=sex;\n" - " }\n" - " public char getSex() {\n" - " return sex;\n" - " }\n" - "\n" - " void setLitterId(int id) {\n" - " this.litterId = id;\n" - " }\n" - " public int getLitterId() {\n" - " return litterId;\n" - " }\n" - "\n" - " void setMother(Cat mother) {\n" - " this.mother = mother;\n" - " }\n" - " public Cat getMother() {\n" - " return mother;\n" - " }\n" - " void setKittens(Set kittens) {\n" - " this.kittens = kittens;\n" - " }\n" - " public Set getKittens() {\n" - " return kittens;\n" - " }\n" - " \n" - " // addKitten not needed by Hibernate\n" - " public void addKitten(Cat kitten) {\n" - " kitten.setMother(this);\n" - " kitten.setLitterId( kittens.size() ); \n" - " kittens.add(kitten);\n" - " }\n" - "}]]>" -msgstr "" - #. Tag: para -#: persistent_classes.xml:55 #, no-c-format msgid "The four main rules of persistent classes are explored in more detail in the following sections." msgstr "" #. Tag: title -#: persistent_classes.xml:61 #, no-c-format msgid "Implement a no-argument constructor" msgstr "" #. Tag: para -#: persistent_classes.xml:63 #, no-c-format msgid "<literal>Cat</literal> has a no-argument constructor. All persistent classes must have a default constructor (which can be non-public) so that Hibernate can instantiate them using <literal>Constructor.newInstance()</literal>. It is recommended that you have a default constructor with at least <emphasis>package</emphasis> visibility for runtime proxy generation in Hibernate." msgstr "" #. Tag: title -#: persistent_classes.xml:73 #, no-c-format msgid "Provide an identifier property (optional)" msgstr "" #. Tag: para -#: persistent_classes.xml:75 #, no-c-format msgid "<literal>Cat</literal> has a property called <literal>id</literal>. This property maps to the primary key column of a database table. The property might have been called anything, and its type might have been any primitive type, any primitive \"wrapper\" type, <literal>java.lang.String</literal> or <literal>java.util.Date</literal>. If your legacy database table has composite keys, you can use a user-defined class with properties of these types (see the section on composite identifiers later in the chapter.)" msgstr "" #. Tag: para -#: persistent_classes.xml:84 #, no-c-format msgid "The identifier property is strictly optional. You can leave them off and let Hibernate keep track of object identifiers internally. We do not recommend this, however." msgstr "" #. Tag: para -#: persistent_classes.xml:89 #, no-c-format msgid "In fact, some functionality is available only to classes that declare an identifier property:" msgstr "" #. Tag: para -#: persistent_classes.xml:96 #, no-c-format -msgid "Transitive reattachment for detached objects (cascade update or cascade merge) - see" +msgid "Transitive reattachment for detached objects (cascade update or cascade merge) - see <xref linkend=\"objectstate-transitive\" />" msgstr "" -#. Tag: literal -#: persistent_classes.xml:103 +#. Tag: para #, no-c-format -msgid "Session.saveOrUpdate()" +msgid "<literal>Session.saveOrUpdate()</literal>" msgstr "" -#. Tag: literal -#: persistent_classes.xml:108 +#. Tag: para #, no-c-format -msgid "Session.merge()" +msgid "<literal>Session.merge()</literal>" msgstr "" #. Tag: para -#: persistent_classes.xml:113 #, no-c-format msgid "We recommend that you declare consistently-named identifier properties on persistent classes and that you use a nullable (i.e., non-primitive) type." msgstr "" #. Tag: title -#: persistent_classes.xml:120 #, no-c-format msgid "Prefer non-final classes (optional)" msgstr "" #. Tag: para -#: persistent_classes.xml:121 #, no-c-format msgid "A central feature of Hibernate, <emphasis>proxies</emphasis>, depends upon the persistent class being either non-final, or the implementation of an interface that declares all public methods." msgstr "" #. Tag: para -#: persistent_classes.xml:126 #, no-c-format msgid "You can persist <literal>final</literal> classes that do not implement an interface with Hibernate. You will not, however, be able to use proxies for lazy association fetching which will ultimately limit your options for performance tuning." msgstr "" #. Tag: para -#: persistent_classes.xml:131 #, no-c-format msgid "You should also avoid declaring <literal>public final</literal> methods on the non-final classes. If you want to use a class with a <literal>public final</literal> method, you must explicitly disable proxying by setting <literal>lazy=\"false\"</literal>." msgstr "" #. Tag: title -#: persistent_classes.xml:139 #, no-c-format msgid "Declare accessors and mutators for persistent fields (optional)" msgstr "" #. Tag: para -#: persistent_classes.xml:141 #, no-c-format msgid "<literal>Cat</literal> declares accessor methods for all its persistent fields. Many other ORM tools directly persist instance variables. It is better to provide an indirection between the relational schema and internal data structures of the class. By default, Hibernate persists JavaBeans style properties and recognizes method names of the form <literal>getFoo</literal>, <literal>isFoo</literal> and <literal>setFoo</literal>. If required, you can switch to direct field access for particular properties." msgstr "" #. Tag: para -#: persistent_classes.xml:151 #, no-c-format msgid "Properties need <emphasis>not</emphasis> be declared public - Hibernate can persist a property with a default, <literal>protected</literal> or <literal>private</literal> get / set pair." msgstr "" #. Tag: title -#: persistent_classes.xml:162 #, no-c-format msgid "Implementing inheritance" msgstr "" #. Tag: para -#: persistent_classes.xml:164 #, no-c-format msgid "A subclass must also observe the first and second rules. It inherits its identifier property from the superclass, <literal>Cat</literal>. For example:" msgstr "" -#. Tag: programlisting -#: persistent_classes.xml:169 -#, no-c-format -msgid "" - "<![CDATA[package eg;\n" - "\n" - "public class DomesticCat extends Cat {\n" - " private String name;\n" - "\n" - " public String getName() {\n" - " return name;\n" - " }\n" - " protected void setName(String name) {\n" - " this.name=name;\n" - " }\n" - "}]]>" -msgstr "" - #. Tag: title -#: persistent_classes.xml:173 #, no-c-format msgid "Implementing <literal>equals()</literal> and <literal>hashCode()</literal>" msgstr "" #. Tag: para -#: persistent_classes.xml:175 #, no-c-format msgid "You have to override the <literal>equals()</literal> and <literal>hashCode()</literal> methods if you:" msgstr "" #. Tag: para -#: persistent_classes.xml:181 #, no-c-format msgid "intend to put instances of persistent classes in a <literal>Set</literal> (the recommended way to represent many-valued associations); <emphasis>and</emphasis>" msgstr "" #. Tag: para -#: persistent_classes.xml:188 #, no-c-format msgid "intend to use reattachment of detached instances" msgstr "" #. Tag: para -#: persistent_classes.xml:194 #, no-c-format msgid "Hibernate guarantees equivalence of persistent identity (database row) and Java identity only inside a particular session scope. When you mix instances retrieved in different sessions, you must implement <literal>equals()</literal> and <literal>hashCode()</literal> if you wish to have meaningful semantics for <literal>Set</literal>s." msgstr "" #. Tag: para -#: persistent_classes.xml:202 #, no-c-format msgid "The most obvious way is to implement <literal>equals()</literal>/<literal>hashCode()</literal> by comparing the identifier value of both objects. If the value is the same, both must be the same database row, because they are equal. If both are added to a <literal>Set</literal>, you will only have one element in the <literal>Set</literal>). Unfortunately, you cannot use that approach with generated identifiers. Hibernate will only assign identifier values to objects that are persistent; a newly created instance will not have any identifier value. Furthermore, if an instance is unsaved and currently in a <literal>Set</literal>, saving it will assign an identifier value to the object. If <literal>equals()</literal> and <literal>hashCode()</literal> are based on the identifier value, the hash code would change, breaking the contract of the <literal>Set</literal>. See the Hibernate website for a full discussion of this problem. This is not a Hibernate issue, but normal Ja! va semantics of object identity and equality." msgstr "" #. Tag: para -#: persistent_classes.xml:216 #, no-c-format msgid "It is recommended that you implement <literal>equals()</literal> and <literal>hashCode()</literal> using <emphasis>Business key equality</emphasis>. Business key equality means that the <literal>equals()</literal> method compares only the properties that form the business key. It is a key that would identify our instance in the real world (a <emphasis>natural</emphasis> candidate key):" msgstr "" -#. Tag: programlisting -#: persistent_classes.xml:224 -#, no-c-format -msgid "" - "<![CDATA[public class Cat {\n" - "\n" - " ...\n" - " public boolean equals(Object other) {\n" - " if (this == other) return true;\n" - " if ( !(other instanceof Cat) ) return false;\n" - "\n" - " final Cat cat = (Cat) other;\n" - "\n" - " if ( !cat.getLitterId().equals( getLitterId() ) ) return false;\n" - " if ( !cat.getMother().equals( getMother() ) ) return false;\n" - "\n" - " return true;\n" - " }\n" - "\n" - " public int hashCode() {\n" - " int result;\n" - " result = getMother().hashCode();\n" - " result = 29 * result + getLitterId();\n" - " return result;\n" - " }\n" - "\n" - "}]]>" -msgstr "" - #. Tag: para -#: persistent_classes.xml:226 #, no-c-format -msgid "A business key does not have to be as solid as a database primary key candidate (see <xref linkend=\"transactions-basics-identity\"/>). Immutable or unique properties are usually good candidates for a business key." +msgid "A business key does not have to be as solid as a database primary key candidate (see <xref linkend=\"transactions-basics-identity\" />). Immutable or unique properties are usually good candidates for a business key." msgstr "" #. Tag: title -#: persistent_classes.xml:236 #, no-c-format msgid "Dynamic models" msgstr "" #. Tag: title -#: persistent_classes.xml:239 #, no-c-format msgid "Note" msgstr "" -#. Tag: emphasis -#: persistent_classes.xml:241 +#. Tag: para #, no-c-format -msgid "The following features are currently considered experimental and may change in the near future." +msgid "<emphasis>The following features are currently considered experimental and may change in the near future.</emphasis>" msgstr "" #. Tag: para -#: persistent_classes.xml:246 #, no-c-format msgid "Persistent entities do not necessarily have to be represented as POJO classes or as JavaBean objects at runtime. Hibernate also supports dynamic models (using <literal>Map</literal>s of <literal>Map</literal>s at runtime) and the representation of entities as DOM4J trees. With this approach, you do not write persistent classes, only mapping files." msgstr "" #. Tag: para -#: persistent_classes.xml:254 #, no-c-format -msgid "By default, Hibernate works in normal POJO mode. You can set a default entity representation mode for a particular <literal>SessionFactory</literal> using the <literal>default_entity_mode</literal> configuration option (see <xref linkend=\"configuration-optional-properties\"/>)." +msgid "By default, Hibernate works in normal POJO mode. You can set a default entity representation mode for a particular <literal>SessionFactory</literal> using the <literal>default_entity_mode</literal> configuration option (see <xref linkend=\"configuration-optional-properties\" />)." msgstr "" #. Tag: para -#: persistent_classes.xml:261 #, no-c-format msgid "The following examples demonstrate the representation using <literal>Map</literal>s. First, in the mapping file an <literal>entity-name</literal> has to be declared instead of, or in addition to, a class name:" msgstr "" -#. Tag: programlisting -#: persistent_classes.xml:267 -#, no-c-format -msgid "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class entity-name=\"Customer\">\n" - "\n" - " <id name=\"id\"\n" - " type=\"long\"\n" - " column=\"ID\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - "\n" - " <property name=\"name\"\n" - " column=\"NAME\"\n" - " type=\"string\"/>\n" - "\n" - " <property name=\"address\"\n" - " column=\"ADDRESS\"\n" - " type=\"string\"/>\n" - "\n" - " <many-to-one name=\"organization\"\n" - " column=\"ORGANIZATION_ID\"\n" - " class=\"Organization\"/>\n" - "\n" - " <bag name=\"orders\"\n" - " inverse=\"true\"\n" - " lazy=\"false\"\n" - " cascade=\"all\">\n" - " <key column=\"CUSTOMER_ID\"/>\n" - " <one-to-many class=\"Order\"/>\n" - " </bag>\n" - "\n" - " </class>\n" - " \n" - "</hibernate-mapping>]]>" -msgstr "" - #. Tag: para -#: persistent_classes.xml:269 #, no-c-format msgid "Even though associations are declared using target class names, the target type of associations can also be a dynamic entity instead of a POJO." msgstr "" #. Tag: para -#: persistent_classes.xml:276 #, no-c-format msgid "After setting the default entity mode to <literal>dynamic-map</literal> for the <literal>SessionFactory</literal>, you can, at runtime, work with <literal>Map</literal>s of <literal>Map</literal>s:" msgstr "" -#. Tag: programlisting -#: persistent_classes.xml:282 -#, no-c-format -msgid "" - "<![CDATA[Session s = openSession();\n" - "Transaction tx = s.beginTransaction();\n" - "Session s = openSession();\n" - "\n" - "// Create a customer\n" - "Map david = new HashMap();\n" - "david.put(\"name\", \"David\");\n" - "\n" - "// Create an organization\n" - "Map foobar = new HashMap();\n" - "foobar.put(\"name\", \"Foobar Inc.\");\n" - "\n" - "// Link both\n" - "david.put(\"organization\", foobar);\n" - "\n" - "// Save both\n" - "s.save(\"Customer\", david);\n" - "s.save(\"Organization\", foobar);\n" - "\n" - "tx.commit();\n" - "s.close();]]>" -msgstr "" - #. Tag: para -#: persistent_classes.xml:284 #, no-c-format msgid "One of the main advantages of dynamic mapping is quick turnaround time for prototyping, without the need for entity class implementation. However, you lose compile-time type checking and will likely deal with many exceptions at runtime. As a result of the Hibernate mapping, the database schema can easily be normalized and sound, allowing to add a proper domain model implementation on top later on." msgstr "" #. Tag: para -#: persistent_classes.xml:292 #, no-c-format msgid "Entity representation modes can also be set on a per <literal>Session</literal> basis:" msgstr "" -#. Tag: programlisting -#: persistent_classes.xml:297 -#, no-c-format -msgid "" - "<![CDATA[Session dynamicSession = pojoSession.getSession(EntityMode.MAP);\n" - "\n" - "// Create a customer\n" - "Map david = new HashMap();\n" - "david.put(\"name\", \"David\");\n" - "dynamicSession.save(\"Customer\", david);\n" - "...\n" - "dynamicSession.flush();\n" - "dynamicSession.close()\n" - "...\n" - "// Continue on pojoSession\n" - "]]>" -msgstr "" - #. Tag: para -#: persistent_classes.xml:300 #, no-c-format msgid "Please note that the call to <literal>getSession()</literal> using an <literal>EntityMode</literal> is on the <literal>Session</literal> API, not the <literal>SessionFactory</literal>. That way, the new <literal>Session</literal> shares the underlying JDBC connection, transaction, and other context information. This means you do not have to call <literal>flush()</literal> and <literal>close()</literal> on the secondary <literal>Session</literal>, and also leave the transaction and connection handling to the primary unit of work." msgstr "" #. Tag: para -#: persistent_classes.xml:310 #, no-c-format -msgid "More information about the XML representation capabilities can be found in <xref linkend=\"xml\"/>." +msgid "More information about the XML representation capabilities can be found in <xref linkend=\"xml\" />." msgstr "" #. Tag: title -#: persistent_classes.xml:318 #, no-c-format msgid "Tuplizers" msgstr "" #. Tag: para -#: persistent_classes.xml:320 #, no-c-format msgid "<literal>org.hibernate.tuple.Tuplizer</literal>, and its sub-interfaces, are responsible for managing a particular representation of a piece of data given that representation's <literal>org.hibernate.EntityMode</literal>. If a given piece of data is thought of as a data structure, then a tuplizer is the thing that 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. It also knows how to access the POJO properties using the defined property accessors." msgstr "" #. Tag: para -#: persistent_classes.xml:330 #, no-c-format msgid "There are two high-level types of Tuplizers, represented by the <literal>org.hibernate.tuple.entity.EntityTuplizer</literal> and <literal>org.hibernate.tuple.component.ComponentTuplizer</literal> interfaces. <literal>EntityTuplizer</literal>s are responsible for managing the above mentioned contracts in regards to entities, while <literal>ComponentTuplizer</literal>s do the same for components." msgstr "" #. Tag: para -#: persistent_classes.xml:338 #, no-c-format msgid "Users can also plug in their own tuplizers. Perhaps you require that a <literal>java.util.Map</literal> implementation other than <literal>java.util.HashMap</literal> be used while in the dynamic-map entity-mode. Or perhaps you need to define a different proxy generation strategy than the one used by default. Both would be achieved by defining a custom tuplizer implementation. Tuplizer definitions are attached to the entity or component mapping they are meant to manage. Going back to the example of our customer entity:" msgstr "" -#. Tag: programlisting -#: persistent_classes.xml:347 -#, no-c-format -msgid "" - "<![CDATA[<hibernate-mapping>\n" - " <class entity-name=\"Customer\">\n" - " \n" - " <tuplizer entity-mode=\"dynamic-map\"\n" - " class=\"CustomMapTuplizerImpl\"/>\n" - "\n" - " <id name=\"id\" type=\"long\" column=\"ID\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - "\n" - " \n" - " ...\n" - " </class>\n" - "</hibernate-mapping>\n" - "\n" - "\n" - "public class CustomMapTuplizerImpl\n" - " extends org.hibernate.tuple.entity.DynamicMapEntityTuplizer {\n" - " // override the buildInstantiator() method to plug in our custom map...\n" - " protected final Instantiator buildInstantiator(\n" - " org.hibernate.mapping.PersistentClass mappingInfo) {\n" - " return new CustomMapInstantiator( mappingInfo );\n" - " }\n" - "\n" - " private static final class CustomMapInstantiator\n" - " extends org.hibernate.tuple.DynamicMapInstantitor {\n" - " // override the generateMap() method to return our custom map...\n" - " protected final Map generateMap() {\n" - " return new CustomMap();\n" - " }\n" - " }\n" - "}]]>" -msgstr "" - #. Tag: title -#: persistent_classes.xml:353 #, no-c-format msgid "EntityNameResolvers" msgstr "" #. Tag: para -#: persistent_classes.xml:355 #, no-c-format msgid "The <interfacename>org.hibernate.EntityNameResolver</interfacename> interface is a contract for resolving the entity name of a given entity instance. The interface defines a single method <methodname>resolveEntityName</methodname> which is passed the entity instance and is expected to return the appropriate entity name (null is allowed and would indicate that the resolver does not know how to resolve the entity name of the given entity instance). Generally speaking, an <interfacename>org.hibernate.EntityNameResolver</interfacename> is going to be most useful in the case of dynamic models. One example might be using proxied interfaces as your domain model. The hibernate test suite has an example of this exact style of usage under the <package>org.hibernate.test.dynamicentity.tuplizer2</package>. Here is some of the code from that package for illustration." msgstr "" -#. Tag: programlisting -#: persistent_classes.xml:367 -#, no-c-format -msgid "" - "/**\n" - " * A very trivial JDK Proxy InvocationHandler implementation where we proxy an interface as\n" - " * the domain model and simply store persistent state in an internal Map. This is an extremely\n" - " * trivial example meant only for illustration.\n" - " */\n" - "public final class DataProxyHandler implements InvocationHandler {\n" - " private String entityName;\n" - " private HashMap data = new HashMap();\n" - "\n" - " public DataProxyHandler(String entityName, Serializable id) {\n" - " this.entityName = entityName;\n" - " data.put( \"Id\", id );\n" - " }\n" - "\n" - " public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {\n" - " String methodName = method.getName();\n" - " if ( methodName.startsWith( \"set\" ) ) {\n" - " String propertyName = methodName.substring( 3 );\n" - " data.put( propertyName, args[0] );\n" - " }\n" - " else if ( methodName.startsWith( \"get\" ) ) {\n" - " String propertyName = methodName.substring( 3 );\n" - " return data.get( propertyName );\n" - " }\n" - " else if ( \"toString\".equals( methodName ) ) {\n" - " return entityName + \"#\" + data.get( \"Id\" );\n" - " }\n" - " else if ( \"hashCode\".equals( methodName ) ) {\n" - " return new Integer( this.hashCode() );\n" - " }\n" - " return null;\n" - " }\n" - "\n" - " public String getEntityName() {\n" - " return entityName;\n" - " }\n" - "\n" - " public HashMap getData() {\n" - " return data;\n" - " }\n" - "}\n" - "\n" - "/**\n" - " *\n" - " */\n" - "public class ProxyHelper {\n" - " public static String extractEntityName(Object object) {\n" - " // Our custom java.lang.reflect.Proxy instances actually bundle\n" - " // their appropriate entity name, so we simply extract it from there\n" - " // if this represents one of our proxies; otherwise, we return null\n" - " if ( Proxy.isProxyClass( object.getClass() ) ) {\n" - " InvocationHandler handler = Proxy.getInvocationHandler( object );\n" - " if ( DataProxyHandler.class.isAssignableFrom( handler.getClass() ) ) {\n" - " DataProxyHandler myHandler = ( DataProxyHandler ) handler;\n" - " return myHandler.getEntityName();\n" - " }\n" - " }\n" - " return null;\n" - " }\n" - "\n" - " // various other utility methods ....\n" - "\n" - "}\n" - "\n" - "/**\n" - " * The EntityNameResolver implementation.\n" - " * IMPL NOTE : An EntityNameResolver really defines a strategy for how entity names should be\n" - " * resolved. Since this particular impl can handle resolution for all of our entities we want to\n" - " * take advantage of the fact that SessionFactoryImpl keeps these in a Set so that we only ever\n" - " * have one instance registered. Why? Well, when it comes time to resolve an entity name,\n" - " * Hibernate must iterate over all the registered resolvers. So keeping that number down\n" - " * helps that process be as speedy as possible. Hence the equals and hashCode impls\n" - " */\n" - "public class MyEntityNameResolver implements EntityNameResolver {\n" - " public static final MyEntityNameResolver INSTANCE = new MyEntityNameResolver();\n" - "\n" - " public String resolveEntityName(Object entity) {\n" - " return ProxyHelper.extractEntityName( entity );\n" - " }\n" - "\n" - " public boolean equals(Object obj) {\n" - " return getClass().equals( obj.getClass() );\n" - " }\n" - "\n" - " public int hashCode() {\n" - " return getClass().hashCode();\n" - " }\n" - "}\n" - "\n" - "public class MyEntityTuplizer extends PojoEntityTuplizer {\n" - " public MyEntityTuplizer(EntityMetamodel entityMetamodel, PersistentClass mappedEntity) {\n" - " super( entityMetamodel, mappedEntity );\n" - " }\n" - "\n" - " public EntityNameResolver[] getEntityNameResolvers() {\n" - " return new EntityNameResolver[] { MyEntityNameResolver.INSTANCE };\n" - " }\n" - "\n" - " public String determineConcreteSubclassEntityName(Object entityInstance, SessionFactoryImplementor factory) {\n" - " String entityName = ProxyHelper.extractEntityName( entityInstance );\n" - " if ( entityName == null ) {\n" - " entityName = super.determineConcreteSubclassEntityName( entityInstance, factory );\n" - " }\n" - " return entityName;\n" - " }\n" - "\n" - " ...\n" - "}" -msgstr "" - #. Tag: para -#: persistent_classes.xml:369 #, no-c-format msgid "In order to register an <interfacename>org.hibernate.EntityNameResolver</interfacename> users must either:" msgstr "" #. Tag: para -#: persistent_classes.xml:373 #, no-c-format -msgid "Implement a custom <link linkend=\"persistent-classes-tuplizers\">Tuplizer</link>, implementing the <methodname>getEntityNameResolvers</methodname> method." +msgid "Implement a custom Tupelizer implementing the <methodname>getEntityNameResolvers</methodname> method (see <xref linkend=\"persistent-classes-tuplizers\" />)." msgstr "" #. Tag: para -#: persistent_classes.xml:379 #, no-c-format msgid "Register it with the <classname>org.hibernate.impl.SessionFactoryImpl</classname> (which is the implementation class for <interfacename>org.hibernate.SessionFactory</interfacename>) using the <methodname>registerEntityNameResolver</methodname> method." msgstr "" Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/portability.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/portability.pot 2010-02-08 04:50:03 UTC (rev 18716) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/portability.pot 2010-02-08 04:56:55 UTC (rev 18717) @@ -1,135 +1,138 @@ -# SOME DESCRIPTIVE TITLE. -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. # -#, fuzzy msgid "" msgstr "" -"Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-23 18:41+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:19\n" +"PO-Revision-Date: 2010-01-08T04:07:19\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" "MIME-Version: 1.0\n" -"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Type: application/x-publican; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. Tag: title -#: portability.xml:26 #, no-c-format msgid "Database Portability Considerations" msgstr "" #. Tag: title -#: portability.xml:29 #, no-c-format msgid "Portability Basics" msgstr "" #. Tag: para -#: portability.xml:31 #, no-c-format msgid "One of the selling points of Hibernate (and really Object/Relational Mapping as a whole) is the notion of database portability. This could mean an internal IT user migrating from one database vendor to another, or it could mean a framework or deployable application consuming Hibernate to simultaneously target multiple database products by their users. Regardless of the exact scenario, the basic idea is that you want Hibernate to help you run against any number of databases without changes to your code, and ideally without any changes to the mapping metadata." msgstr "" #. Tag: title -#: portability.xml:42 #, no-c-format msgid "Dialect" msgstr "" #. Tag: para -#: portability.xml:44 #, no-c-format msgid "The first line of portability for Hibernate is the dialect, which is a specialization of the <classname>org.hibernate.dialect.Dialect</classname> contract. A dialect encapsulates all the differences in how Hibernate must communicate with a particular database to accomplish some task like getting a sequence value or structuring a SELECT query. Hibernate bundles a wide range of dialects for many of the most popular databases. If you find that your particular database is not among them, it is not terribly difficult to write your own." msgstr "" #. Tag: title -#: portability.xml:55 #, no-c-format msgid "Dialect resolution" msgstr "" #. Tag: para -#: portability.xml:57 #, no-c-format msgid "Originally, Hibernate would always require that users specify which dialect to use. In the case of users looking to simultaneously target multiple databases with their build that was problematic. Generally this required their users to configure the Hibernate dialect or defining their own method of setting that value." msgstr "" #. Tag: para -#: portability.xml:64 #, no-c-format msgid "Starting with version 3.2, Hibernate introduced the notion of automatically detecting the dialect to use based on the <interfacename>java.sql.DatabaseMetaData</interfacename> obtained from a <interfacename>java.sql.Connection</interfacename> to that database. This was much better, expect that this resolution was limited to databases Hibernate know about ahead of time and was in no way configurable or overrideable." msgstr "" #. Tag: para -#: portability.xml:72 #, no-c-format -msgid "Starting with version 3.3, Hibernate has a fare more powerful way to automatically determine which dialect to should be used by relying on a series of delegates which implement the <interfacename>org.hibernate.dialect.resolver.DialectResolver</interfacename> which defines only a single method:<programlisting><![CDATA[public Dialect resolveDialect(DatabaseMetaData metaData) throws JDBCConnectionException]]></programlisting>. The basic contract here is that if the resolver 'understands' the given database metadata then it returns the corresponding Dialect; if not it returns null and the process continues to the next resolver. The signature also identifies <exceptionname>org.hibernate.exception.JDBCConnectionException</exceptionname> as possibly being thrown. A JDBCConnectionException here is interpreted to imply a \"non transient\" (aka non-recoverable) connection problem and is used to indicate an immediate stop to resolution attempts. All other exceptions result in a! warning and continuing on to the next resolver." +msgid "Starting with version 3.3, Hibernate has a fare more powerful way to automatically determine which dialect to should be used by relying on a series of delegates which implement the <interfacename>org.hibernate.dialect.resolver.DialectResolver</interfacename> which defines only a single method:<programlisting>public Dialect resolveDialect(DatabaseMetaData metaData) throws JDBCConnectionException</programlisting>. The basic contract here is that if the resolver 'understands' the given database metadata then it returns the corresponding Dialect; if not it returns null and the process continues to the next resolver. The signature also identifies <exceptionname>org.hibernate.exception.JDBCConnectionException</exceptionname> as possibly being thrown. A JDBCConnectionException here is interpreted to imply a \"non transient\" (aka non-recoverable) connection problem and is used to indicate an immediate stop to resolution attempts. All other exceptions result in a warning and! continuing on to the next resolver." msgstr "" #. Tag: para -#: portability.xml:85 #, no-c-format msgid "The cool part about these resolvers is that users can also register their own custom resolvers which will be processed ahead of the built-in Hibernate ones. This might be useful in a number of different situations: it allows easy integration for auto-detection of dialects beyond those shipped with HIbernate itself; it allows you to specify to use a custom dialect when a particular database is recognized; etc. To register one or more resolvers, simply specify them (seperated by commas, tabs or spaces) using the 'hibernate.dialect_resolvers' configuration setting (see the <constant>DIALECT_RESOLVERS</constant> constant on <classname>org.hibernate.cfg.Environment</classname>)." msgstr "" #. Tag: title -#: portability.xml:98 #, no-c-format msgid "Identifier generation" msgstr "" #. Tag: para -#: portability.xml:100 #, no-c-format -msgid "When considering portability between databases, another important decision is selecting the identifier generation stratagy you want to use. Originally Hibernate provided the <emphasis>native</emphasis> generator for this purpose, which was intended to select between a <emphasis>sequence</emphasis>, <emphasis>identity</emphasis>, or <emphasis>table</emphasis> strategy depending on the capability of the underlying database. However, an insidious implication of this approach comes about when targtetting some databases which support <emphasis>identity</emphasis> generation and some which do not. <emphasis>identity</emphasis> generation relies on the SQL definition of an IDENTITY (or auto-increment) column to manage the identifier value; it is what is known as a post-insert generation strategy becauase the insert must actually happen before we can know the identifier value. Because Hibernate relies on this identifier value to uniquely reference entities within a persisten! ce context it must then issue the insert immediately when the users requests the entitiy be associated with the session (like via save() e.g.) regardless of current transactional semantics. <note> <para> Hibernate was changed slightly once the implication of this was better understood so that the insert is delayed in cases where that is feasible. </para> </note> The underlying issue is that the actual semanctics of the application itself changes in these cases." +msgid "When considering portability between databases, another important decision is selecting the identifier generation stratagy you want to use. Originally Hibernate provided the <emphasis>native</emphasis> generator for this purpose, which was intended to select between a <emphasis>sequence</emphasis>, <emphasis>identity</emphasis>, or <emphasis>table</emphasis> strategy depending on the capability of the underlying database. However, an insidious implication of this approach comes about when targtetting some databases which support <emphasis>identity</emphasis> generation and some which do not. <emphasis>identity</emphasis> generation relies on the SQL definition of an IDENTITY (or auto-increment) column to manage the identifier value; it is what is known as a post-insert generation strategy becauase the insert must actually happen before we can know the identifier value. Because Hibernate relies on this identifier value to uniquely reference entities within a persisten! ce context it must then issue the insert immediately when the users requests the entitiy be associated with the session (like via save() e.g.) regardless of current transactional semantics. The underlying issue is that the semantics of the application itself changes in these cases." msgstr "" #. Tag: para -#: portability.xml:125 #, no-c-format -msgid "Starting with version 3.2.3, Hibernate comes with a set of <ulink url=\"http://in.relation.to/2082.lace\">enhanced</ulink> identifier generators targetting portability in a much different way. <note> <para> There are specifically 2 bundled <emphasis>enhanced</emphasis>generators: <itemizedlist> <listitem> <para> <classname>org.hibernate.id.enhanced.SequenceStyleGenerator</classname> </para> </listitem> <listitem> <para> <classname>org.hibernate.id.enhanced.TableGenerator</classname> </para> </listitem> </itemizedlist> </para> </note> The idea behind these generators is to port the actual semantics of the identifer value generation to the different databases. For example, the <classname>org.hibernate.id.enhanced.SequenceStyleGenerator</classname> mimics the behavior of a sequence on databases which do not support sequences by using a table." +msgid "Hibernate has been improved so that the insert is delayed in cases where that is feasible." msgstr "" +#. Tag: para +#, no-c-format +msgid "Starting with version 3.2.3, Hibernate comes with a set of <ulink url=\"http://in.relation.to/2082.lace\">enhanced</ulink> identifier generators targetting portability in a much different way." +msgstr "" + +#. Tag: para +#, no-c-format +msgid "There are specifically 2 bundled <emphasis>enhanced</emphasis>generators:" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "<classname>org.hibernate.id.enhanced.SequenceStyleGenerator</classname>" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "<classname>org.hibernate.id.enhanced.TableGenerator</classname>" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "The idea behind these generators is to port the actual semantics of the identifer value generation to the different databases. For example, the <classname>org.hibernate.id.enhanced.SequenceStyleGenerator</classname> mimics the behavior of a sequence on databases which do not support sequences by using a table." +msgstr "" + #. Tag: title -#: portability.xml:154 #, no-c-format msgid "Database functions" msgstr "" #. Tag: para -#: portability.xml:157 #, no-c-format -msgid "This is an area in Hibernate in need of improvement. In terms of portability concerns, this function handling currently works pretty well from HQL; however, it is quite lacking in all other aspects." +msgid "This is a new area in Hibernate and as such it is not as mature as the overall Hibernate experience." msgstr "" #. Tag: para -#: portability.xml:164 #, no-c-format msgid "SQL functions can be referenced in many ways by users. However, not all databases support the same set of functions. Hibernate, provides a means of mapping a <emphasis>logical</emphasis> function name to a a delegate which knows how to render that particular function, perhaps even using a totally different physical function call." msgstr "" #. Tag: para -#: portability.xml:170 #, no-c-format msgid "Technically this function registration is handled through the <classname>org.hibernate.dialect.function.SQLFunctionRegistry</classname> class which is intended to allow users to provide custom function definitions without having to provide a custom dialect. This specific behavior is not fully completed as of yet." msgstr "" #. Tag: para -#: portability.xml:177 #, no-c-format msgid "It is sort of implemented such that users can programatically register functions with the <classname>org.hibernate.cfg.Configuration</classname> and those functions will be recognized for HQL." msgstr "" #. Tag: title -#: portability.xml:187 #, no-c-format msgid "Type mappings" msgstr "" #. Tag: para -#: portability.xml:189 #, no-c-format msgid "This section scheduled for completion at a later date..." msgstr "" Deleted: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/preface.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/preface.pot 2010-02-08 04:50:03 UTC (rev 18716) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/preface.pot 2010-02-08 04:56:55 UTC (rev 18717) @@ -1,112 +0,0 @@ -# SOME DESCRIPTIVE TITLE. -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. -# -#, fuzzy -msgid "" -msgstr "" -"Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-23 18:41+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Language-Team: LANGUAGE <kde-i18n-doc(a)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:29 -#, no-c-format -msgid "Preface" -msgstr "" - -#. Tag: para -#: preface.xml:31 -#, no-c-format -msgid "Working with object-oriented software and a relational database can be cumbersome and time consuming in today's enterprise environments. Hibernate is an Object/Relational Mapping tool for Java environments. The term Object/Relational Mapping (ORM) refers to the technique of mapping a data representation from an object model to a relational data model with a SQL-based schema." -msgstr "" - -#. Tag: para -#: preface.xml:39 -#, no-c-format -msgid "Hibernate not only takes care of the mapping from Java classes to database tables (and from Java data types to SQL data types), but also provides data query and retrieval facilities. It can also significantly reduce development time otherwise spent with manual data handling in SQL and JDBC." -msgstr "" - -#. Tag: para -#: preface.xml:46 -#, no-c-format -msgid "Hibernate's goal is to relieve the developer from 95 percent of common data persistence related programming tasks. Hibernate may not be the best solution for data-centric applications that only use stored-procedures to implement the business logic in the database, it is most useful with object-oriented domain models and business logic in the Java-based middle-tier. However, Hibernate can certainly help you to remove or encapsulate vendor-specific SQL code and will help with the common task of result set translation from a tabular representation to a graph of objects." -msgstr "" - -#. Tag: para -#: preface.xml:56 -#, no-c-format -msgid "If you are new to Hibernate and Object/Relational Mapping or even Java, please follow these steps:" -msgstr "" - -#. Tag: para -#: preface.xml:63 -#, no-c-format -msgid "Read <xref linkend=\"tutorial\"/> for a tutorial with step-by-step instructions. The source code for the tutorial is included in the distribution in the <literal>doc/reference/tutorial/</literal> directory." -msgstr "" - -#. Tag: para -#: preface.xml:71 -#, no-c-format -msgid "Read <xref linkend=\"architecture\"/> to understand the environments where Hibernate can be used." -msgstr "" - -#. Tag: para -#: preface.xml:77 -#, no-c-format -msgid "View the <literal>eg/</literal> directory in the Hibernate distribution. It contains a simple standalone application. Copy your JDBC driver to the <literal>lib/</literal> directory and edit <literal>etc/hibernate.properties</literal>, specifying correct values for your database. From a command prompt in the distribution directory, type <literal>ant eg</literal> (using Ant), or under Windows, type <literal>build eg</literal>." -msgstr "" - -#. Tag: para -#: preface.xml:88 -#, no-c-format -msgid "Use this reference documentation as your primary source of information. Consider reading <biblioref linkend=\"biblio-JPwH\"></biblioref> if you need more help with application design, or if you prefer a step-by-step tutorial. Also visit <ulink url=\"http://caveatemptor.hibernate.org\"></ulink> and download the example application from <biblioref linkend=\"biblio-JPwH\"></biblioref>." -msgstr "" - -#. Tag: para -#: preface.xml:98 -#, no-c-format -msgid "FAQs are answered on the Hibernate website." -msgstr "" - -#. Tag: para -#: preface.xml:103 -#, no-c-format -msgid "Links to third party demos, examples, and tutorials are maintained on the Hibernate website." -msgstr "" - -#. Tag: para -#: preface.xml:109 -#, no-c-format -msgid "The Community Area on the Hibernate website is a good resource for design patterns and various integration solutions (Tomcat, JBoss AS, Struts, EJB, etc.)." -msgstr "" - -#. Tag: para -#: preface.xml:117 -#, no-c-format -msgid "If you have questions, use the user forum linked on the Hibernate website. We also provide a JIRA issue tracking system for bug reports and feature requests. If you are interested in the development of Hibernate, join the developer mailing list. If you are interested in translating this documentation into your language, contact us on the developer mailing list." -msgstr "" - -#. Tag: para -#: preface.xml:125 -#, no-c-format -msgid "Commercial development support, production support, and training for Hibernate is available through JBoss Inc. (see http://www.hibernate.org/SupportTraining/). Hibernate is a Professional Open Source project and a critical component of the JBoss Enterprise Middleware System (JEMS) suite of products." -msgstr "" - -#. Tag: title -#: preface.xml:133 -#, no-c-format -msgid "Feedback" -msgstr "" - -#. Tag: para -#: preface.xml:134 -#, no-c-format -msgid "Use <ulink url=\"http://opensource.atlassian.com/projects/hibernate\">Hibernate JIRA</ulink> to report errors or request enhacements to this documentation." -msgstr "" - Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/query_criteria.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/query_criteria.pot 2010-02-08 04:50:03 UTC (rev 18716) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/query_criteria.pot 2010-02-08 04:56:55 UTC (rev 18717) @@ -1,624 +1,219 @@ -# SOME DESCRIPTIVE TITLE. -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. # -#, fuzzy msgid "" msgstr "" -"Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-10 21:02+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:19\n" +"PO-Revision-Date: 2010-01-08T04:07:19\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" "MIME-Version: 1.0\n" -"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Type: application/x-publican; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. Tag: title -#: query_criteria.xml:29 #, no-c-format msgid "Criteria Queries" msgstr "" #. Tag: para -#: query_criteria.xml:31 #, no-c-format msgid "Hibernate features an intuitive, extensible criteria query API." msgstr "" #. Tag: title -#: query_criteria.xml:36 #, no-c-format msgid "Creating a <literal>Criteria</literal> instance" msgstr "" #. Tag: para -#: query_criteria.xml:38 #, no-c-format msgid "The interface <literal>org.hibernate.Criteria</literal> represents a query against a particular persistent class. The <literal>Session</literal> is a factory for <literal>Criteria</literal> instances." msgstr "" -#. Tag: programlisting -#: query_criteria.xml:44 -#, no-c-format -msgid "" - "<![CDATA[Criteria crit = sess.createCriteria(Cat.class);\n" - "crit.setMaxResults(50);\n" - "List cats = crit.list();]]>" -msgstr "" - #. Tag: title -#: query_criteria.xml:49 #, no-c-format msgid "Narrowing the result set" msgstr "" #. Tag: para -#: query_criteria.xml:51 #, no-c-format msgid "An individual query criterion is an instance of the interface <literal>org.hibernate.criterion.Criterion</literal>. The class <literal>org.hibernate.criterion.Restrictions</literal> defines factory methods for obtaining certain built-in <literal>Criterion</literal> types." msgstr "" -#. Tag: programlisting -#: query_criteria.xml:59 -#, no-c-format -msgid "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .add( Restrictions.like(\"name\", \"Fritz%\") )\n" - " .add( Restrictions.between(\"weight\", minWeight, maxWeight) )\n" - " .list();]]>" -msgstr "" - #. Tag: para -#: query_criteria.xml:61 #, no-c-format msgid "Restrictions can be grouped logically." msgstr "" -#. Tag: programlisting -#: query_criteria.xml:65 -#, no-c-format -msgid "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .add( Restrictions.like(\"name\", \"Fritz%\") )\n" - " .add( Restrictions.or(\n" - " Restrictions.eq( \"age\", new Integer(0) ),\n" - " Restrictions.isNull(\"age\")\n" - " ) )\n" - " .list();]]>" -msgstr "" - -#. Tag: programlisting -#: query_criteria.xml:67 -#, no-c-format -msgid "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .add( Restrictions.in( \"name\", new String[] { \"Fritz\", \"Izi\", \"Pk\" } ) )\n" - " .add( Restrictions.disjunction()\n" - " .add( Restrictions.isNull(\"age\") )\n" - " .add( Restrictions.eq(\"age\", new Integer(0) ) )\n" - " .add( Restrictions.eq(\"age\", new Integer(1) ) )\n" - " .add( Restrictions.eq(\"age\", new Integer(2) ) )\n" - " ) )\n" - " .list();]]>" -msgstr "" - #. Tag: para -#: query_criteria.xml:69 #, no-c-format msgid "There are a range of built-in criterion types (<literal>Restrictions</literal> subclasses). One of the most useful allows you to specify SQL directly." msgstr "" -#. Tag: programlisting -#: query_criteria.xml:74 -#, no-c-format -msgid "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .add( Restrictions.sqlRestriction(\"lower({alias}.name) like lower(?)\", \"Fritz%\", Hibernate.STRING) )\n" - " .list();]]>" -msgstr "" - #. Tag: para -#: query_criteria.xml:76 #, no-c-format msgid "The <literal>{alias}</literal> placeholder with be replaced by the row alias of the queried entity." msgstr "" #. Tag: para -#: query_criteria.xml:81 #, no-c-format msgid "You can also obtain a criterion from a <literal>Property</literal> instance. You can create a <literal>Property</literal> by calling <literal>Property.forName()</literal>:" msgstr "" -#. Tag: programlisting -#: query_criteria.xml:87 -#, no-c-format -msgid "" - "<![CDATA[\n" - "Property age = Property.forName(\"age\");\n" - "List cats = sess.createCriteria(Cat.class)\n" - " .add( Restrictions.disjunction()\n" - " .add( age.isNull() )\n" - " .add( age.eq( new Integer(0) ) )\n" - " .add( age.eq( new Integer(1) ) )\n" - " .add( age.eq( new Integer(2) ) )\n" - " ) )\n" - " .add( Property.forName(\"name\").in( new String[] { \"Fritz\", \"Izi\", \"Pk\" } ) )\n" - " .list();]]>" -msgstr "" - #. Tag: title -#: query_criteria.xml:92 #, no-c-format msgid "Ordering the results" msgstr "" #. Tag: para -#: query_criteria.xml:94 #, no-c-format msgid "You can order the results using <literal>org.hibernate.criterion.Order</literal>." msgstr "" -#. Tag: programlisting -#: query_criteria.xml:98 -#, no-c-format -msgid "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .add( Restrictions.like(\"name\", \"F%\")\n" - " .addOrder( Order.asc(\"name\") )\n" - " .addOrder( Order.desc(\"age\") )\n" - " .setMaxResults(50)\n" - " .list();]]>" -msgstr "" - -#. Tag: programlisting -#: query_criteria.xml:100 -#, no-c-format -msgid "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .add( Property.forName(\"name\").like(\"F%\") )\n" - " .addOrder( Property.forName(\"name\").asc() )\n" - " .addOrder( Property.forName(\"age\").desc() )\n" - " .setMaxResults(50)\n" - " .list();]]>" -msgstr "" - #. Tag: title -#: query_criteria.xml:105 #, no-c-format msgid "Associations" msgstr "" #. Tag: para -#: query_criteria.xml:107 #, no-c-format msgid "By navigating associations using <literal>createCriteria()</literal> you can specify constraints upon related entities:" msgstr "" -#. Tag: programlisting -#: query_criteria.xml:112 -#, no-c-format -msgid "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .add( Restrictions.like(\"name\", \"F%\") )\n" - " .createCriteria(\"kittens\")\n" - " .add( Restrictions.like(\"name\", \"F%\") )\n" - " .list();]]>" -msgstr "" - #. Tag: para -#: query_criteria.xml:114 #, no-c-format msgid "The second <literal>createCriteria()</literal> returns a new instance of <literal>Criteria</literal> that refers to the elements of the <literal>kittens</literal> collection." msgstr "" #. Tag: para -#: query_criteria.xml:120 #, no-c-format msgid "There is also an alternate form that is useful in certain circumstances:" msgstr "" -#. Tag: programlisting -#: query_criteria.xml:124 -#, no-c-format -msgid "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .createAlias(\"kittens\", \"kt\")\n" - " .createAlias(\"mate\", \"mt\")\n" - " .add( Restrictions.eqProperty(\"kt.name\", \"mt.name\") )\n" - " .list();]]>" -msgstr "" - #. Tag: para -#: query_criteria.xml:126 #, no-c-format msgid "(<literal>createAlias()</literal> does not create a new instance of <literal>Criteria</literal>.)" msgstr "" #. Tag: para -#: query_criteria.xml:131 #, no-c-format msgid "The kittens collections held by the <literal>Cat</literal> instances returned by the previous two queries are <emphasis>not</emphasis> pre-filtered by the criteria. If you want to retrieve just the kittens that match the criteria, you must use a <literal>ResultTransformer</literal>." msgstr "" -#. Tag: programlisting -#: query_criteria.xml:138 -#, no-c-format -msgid "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .createCriteria(\"kittens\", \"kt\")\n" - " .add( Restrictions.eq(\"name\", \"F%\") )\n" - " .setResultTransformer(Criteria.ALIAS_TO_ENTITY_MAP)\n" - " .list();\n" - "Iterator iter = cats.iterator();\n" - "while ( iter.hasNext() ) {\n" - " Map map = (Map) iter.next();\n" - " Cat cat = (Cat) map.get(Criteria.ROOT_ALIAS);\n" - " Cat kitten = (Cat) map.get(\"kt\");\n" - "}]]>" -msgstr "" - #. Tag: title -#: query_criteria.xml:143 #, no-c-format msgid "Dynamic association fetching" msgstr "" #. Tag: para -#: query_criteria.xml:145 #, no-c-format msgid "You can specify association fetching semantics at runtime using <literal>setFetchMode()</literal>." msgstr "" -#. Tag: programlisting -#: query_criteria.xml:150 -#, no-c-format -msgid "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .add( Restrictions.like(\"name\", \"Fritz%\") )\n" - " .setFetchMode(\"mate\", FetchMode.EAGER)\n" - " .setFetchMode(\"kittens\", FetchMode.EAGER)\n" - " .list();]]>" -msgstr "" - #. Tag: para -#: query_criteria.xml:152 #, no-c-format -msgid "This query will fetch both <literal>mate</literal> and <literal>kittens</literal> by outer join. See <xref linkend=\"performance-fetching\"/> for more information." +msgid "This query will fetch both <literal>mate</literal> and <literal>kittens</literal> by outer join. See <xref linkend=\"performance-fetching\" /> for more information." msgstr "" #. Tag: title -#: query_criteria.xml:160 #, no-c-format msgid "Example queries" msgstr "" #. Tag: para -#: query_criteria.xml:162 #, no-c-format msgid "The class <literal>org.hibernate.criterion.Example</literal> allows you to construct a query criterion from a given instance." msgstr "" -#. Tag: programlisting -#: query_criteria.xml:167 -#, no-c-format -msgid "" - "<![CDATA[Cat cat = new Cat();\n" - "cat.setSex('F');\n" - "cat.setColor(Color.BLACK);\n" - "List results = session.createCriteria(Cat.class)\n" - " .add( Example.create(cat) )\n" - " .list();]]>" -msgstr "" - #. Tag: para -#: query_criteria.xml:169 #, no-c-format msgid "Version properties, identifiers and associations are ignored. By default, null valued properties are excluded." msgstr "" #. Tag: para -#: query_criteria.xml:174 #, no-c-format msgid "You can adjust how the <literal>Example</literal> is applied." msgstr "" -#. Tag: programlisting -#: query_criteria.xml:178 -#, no-c-format -msgid "" - "<![CDATA[Example example = Example.create(cat)\n" - " .excludeZeroes() //exclude zero valued properties\n" - " .excludeProperty(\"color\") //exclude the property named \"color\"\n" - " .ignoreCase() //perform case insensitive string comparisons\n" - " .enableLike(); //use like for string comparisons\n" - "List results = session.createCriteria(Cat.class)\n" - " .add(example)\n" - " .list();]]>" -msgstr "" - #. Tag: para -#: query_criteria.xml:180 #, no-c-format msgid "You can even use examples to place criteria upon associated objects." msgstr "" -#. Tag: programlisting -#: query_criteria.xml:184 -#, no-c-format -msgid "" - "<![CDATA[List results = session.createCriteria(Cat.class)\n" - " .add( Example.create(cat) )\n" - " .createCriteria(\"mate\")\n" - " .add( Example.create( cat.getMate() ) )\n" - " .list();]]>" -msgstr "" - #. Tag: title -#: query_criteria.xml:189 #, no-c-format msgid "Projections, aggregation and grouping" msgstr "" #. Tag: para -#: query_criteria.xml:190 #, no-c-format msgid "The class <literal>org.hibernate.criterion.Projections</literal> is a factory for <literal>Projection</literal> instances. You can apply a projection to a query by calling <literal>setProjection()</literal>." msgstr "" -#. Tag: programlisting -#: query_criteria.xml:196 -#, no-c-format -msgid "" - "<![CDATA[List results = session.createCriteria(Cat.class)\n" - " .setProjection( Projections.rowCount() )\n" - " .add( Restrictions.eq(\"color\", Color.BLACK) )\n" - " .list();]]>" -msgstr "" - -#. Tag: programlisting -#: query_criteria.xml:198 -#, no-c-format -msgid "" - "<![CDATA[List results = session.createCriteria(Cat.class)\n" - " .setProjection( Projections.projectionList()\n" - " .add( Projections.rowCount() )\n" - " .add( Projections.avg(\"weight\") )\n" - " .add( Projections.max(\"weight\") )\n" - " .add( Projections.groupProperty(\"color\") )\n" - " )\n" - " .list();]]>" -msgstr "" - #. Tag: para -#: query_criteria.xml:200 #, no-c-format msgid "There is no explicit \"group by\" necessary in a criteria query. Certain projection types are defined to be <emphasis>grouping projections</emphasis>, which also appear in the SQL <literal>group by</literal> clause." msgstr "" #. Tag: para -#: query_criteria.xml:206 #, no-c-format msgid "An alias can be assigned to a projection so that the projected value can be referred to in restrictions or orderings. Here are two different ways to do this:" msgstr "" -#. Tag: programlisting -#: query_criteria.xml:212 -#, no-c-format -msgid "" - "<![CDATA[List results = session.createCriteria(Cat.class)\n" - " .setProjection( Projections.alias( Projections.groupProperty(\"color\"), \"colr\" ) )\n" - " .addOrder( Order.asc(\"colr\") )\n" - " .list();]]>" -msgstr "" - -#. Tag: programlisting -#: query_criteria.xml:214 -#, no-c-format -msgid "" - "<![CDATA[List results = session.createCriteria(Cat.class)\n" - " .setProjection( Projections.groupProperty(\"color\").as(\"colr\") )\n" - " .addOrder( Order.asc(\"colr\") )\n" - " .list();]]>" -msgstr "" - #. Tag: para -#: query_criteria.xml:216 #, no-c-format msgid "The <literal>alias()</literal> and <literal>as()</literal> methods simply wrap a projection instance in another, aliased, instance of <literal>Projection</literal>. As a shortcut, you can assign an alias when you add the projection to a projection list:" msgstr "" -#. Tag: programlisting -#: query_criteria.xml:223 -#, no-c-format -msgid "" - "<![CDATA[List results = session.createCriteria(Cat.class)\n" - " .setProjection( Projections.projectionList()\n" - " .add( Projections.rowCount(), \"catCountByColor\" )\n" - " .add( Projections.avg(\"weight\"), \"avgWeight\" )\n" - " .add( Projections.max(\"weight\"), \"maxWeight\" )\n" - " .add( Projections.groupProperty(\"color\"), \"color\" )\n" - " )\n" - " .addOrder( Order.desc(\"catCountByColor\") )\n" - " .addOrder( Order.desc(\"avgWeight\") )\n" - " .list();]]>" -msgstr "" - -#. Tag: programlisting -#: query_criteria.xml:225 -#, no-c-format -msgid "" - "<![CDATA[List results = session.createCriteria(Domestic.class, \"cat\")\n" - " .createAlias(\"kittens\", \"kit\")\n" - " .setProjection( Projections.projectionList()\n" - " .add( Projections.property(\"cat.name\"), \"catName\" )\n" - " .add( Projections.property(\"kit.name\"), \"kitName\" )\n" - " )\n" - " .addOrder( Order.asc(\"catName\") )\n" - " .addOrder( Order.asc(\"kitName\") )\n" - " .list();]]>" -msgstr "" - #. Tag: para -#: query_criteria.xml:227 #, no-c-format msgid "You can also use <literal>Property.forName()</literal> to express projections:" msgstr "" -#. Tag: programlisting -#: query_criteria.xml:231 -#, no-c-format -msgid "" - "<![CDATA[List results = session.createCriteria(Cat.class)\n" - " .setProjection( Property.forName(\"name\") )\n" - " .add( Property.forName(\"color\").eq(Color.BLACK) )\n" - " .list();]]>" -msgstr "" - -#. Tag: programlisting -#: query_criteria.xml:233 -#, no-c-format -msgid "" - "<![CDATA[List results = session.createCriteria(Cat.class)\n" - " .setProjection( Projections.projectionList()\n" - " .add( Projections.rowCount().as(\"catCountByColor\") )\n" - " .add( Property.forName(\"weight\").avg().as(\"avgWeight\") )\n" - " .add( Property.forName(\"weight\").max().as(\"maxWeight\") )\n" - " .add( Property.forName(\"color\").group().as(\"color\" )\n" - " )\n" - " .addOrder( Order.desc(\"catCountByColor\") )\n" - " .addOrder( Order.desc(\"avgWeight\") )\n" - " .list();]]>" -msgstr "" - #. Tag: title -#: query_criteria.xml:238 #, no-c-format msgid "Detached queries and subqueries" msgstr "" #. Tag: para -#: query_criteria.xml:239 #, no-c-format msgid "The <literal>DetachedCriteria</literal> class allows you to create a query outside the scope of a session and then execute it using an arbitrary <literal>Session</literal>." msgstr "" -#. Tag: programlisting -#: query_criteria.xml:244 -#, no-c-format -msgid "" - "<![CDATA[DetachedCriteria query = DetachedCriteria.forClass(Cat.class)\n" - " .add( Property.forName(\"sex\").eq('F') );\n" - " \n" - "Session session = ....;\n" - "Transaction txn = session.beginTransaction();\n" - "List results = query.getExecutableCriteria(session).setMaxResults(100).list();\n" - "txn.commit();\n" - "session.close();]]>" -msgstr "" - #. Tag: para -#: query_criteria.xml:246 #, no-c-format msgid "A <literal>DetachedCriteria</literal> can also be used to express a subquery. Criterion instances involving subqueries can be obtained via <literal>Subqueries</literal> or <literal>Property</literal>." msgstr "" -#. Tag: programlisting -#: query_criteria.xml:252 -#, no-c-format -msgid "" - "<![CDATA[DetachedCriteria avgWeight = DetachedCriteria.forClass(Cat.class)\n" - " .setProjection( Property.forName(\"weight\").avg() );\n" - "session.createCriteria(Cat.class)\n" - " .add( Property.forName(\"weight\").gt(avgWeight) )\n" - " .list();]]>" -msgstr "" - -#. Tag: programlisting -#: query_criteria.xml:254 -#, no-c-format -msgid "" - "<![CDATA[DetachedCriteria weights = DetachedCriteria.forClass(Cat.class)\n" - " .setProjection( Property.forName(\"weight\") );\n" - "session.createCriteria(Cat.class)\n" - " .add( Subqueries.geAll(\"weight\", weights) )\n" - " .list();]]>" -msgstr "" - #. Tag: para -#: query_criteria.xml:256 #, no-c-format msgid "Correlated subqueries are also possible:" msgstr "" -#. Tag: programlisting -#: query_criteria.xml:260 -#, no-c-format -msgid "" - "<![CDATA[DetachedCriteria avgWeightForSex = DetachedCriteria.forClass(Cat.class, \"cat2\")\n" - " .setProjection( Property.forName(\"weight\").avg() )\n" - " .add( Property.forName(\"cat2.sex\").eqProperty(\"cat.sex\") );\n" - "session.createCriteria(Cat.class, \"cat\")\n" - " .add( Property.forName(\"weight\").gt(avgWeightForSex) )\n" - " .list();]]>" -msgstr "" - #. Tag: title -#: query_criteria.xml:269 #, no-c-format msgid "Queries by natural identifier" msgstr "" #. Tag: para -#: query_criteria.xml:271 #, no-c-format msgid "For most queries, including criteria queries, the query cache is not efficient because query cache invalidation occurs too frequently. However, there is a special kind of query where you can optimize the cache invalidation algorithm: lookups by a constant natural key. In some applications, this kind of query occurs frequently. The criteria API provides special provision for this use case." msgstr "" #. Tag: para -#: query_criteria.xml:279 #, no-c-format msgid "First, map the natural key of your entity using <literal><natural-id></literal> and enable use of the second-level cache." msgstr "" -#. Tag: programlisting -#: query_criteria.xml:284 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"User\">\n" - " <cache usage=\"read-write\"/>\n" - " <id name=\"id\">\n" - " <generator class=\"increment\"/>\n" - " </id>\n" - " <natural-id>\n" - " <property name=\"name\"/>\n" - " <property name=\"org\"/>\n" - " </natural-id>\n" - " <property name=\"password\"/>\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: query_criteria.xml:286 #, no-c-format msgid "This functionality is not intended for use with entities with <emphasis>mutable</emphasis> natural keys." msgstr "" #. Tag: para -#: query_criteria.xml:291 #, no-c-format msgid "Once you have enabled the Hibernate query cache, the <literal>Restrictions.naturalId()</literal> allows you to make use of the more efficient cache algorithm." msgstr "" -#. Tag: programlisting -#: query_criteria.xml:297 -#, no-c-format -msgid "" - "<![CDATA[session.createCriteria(User.class)\n" - " .add( Restrictions.naturalId()\n" - " .set(\"name\", \"gavin\")\n" - " .set(\"org\", \"hb\") \n" - " ).setCacheable(true)\n" - " .uniqueResult();]]>" -msgstr "" - Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/query_hql.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/query_hql.pot 2010-02-08 04:50:03 UTC (rev 18716) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/query_hql.pot 2010-02-08 04:56:55 UTC (rev 18717) @@ -1,1786 +1,793 @@ -# SOME DESCRIPTIVE TITLE. -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. # -#, fuzzy msgid "" msgstr "" -"Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-10 21:02+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:19\n" +"PO-Revision-Date: 2010-01-08T04:07:19\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" "MIME-Version: 1.0\n" -"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Type: application/x-publican; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. Tag: title -#: query_hql.xml:29 #, no-c-format msgid "HQL: The Hibernate Query Language" msgstr "" #. Tag: para -#: query_hql.xml:31 #, no-c-format msgid "Hibernate uses a powerful query language (HQL) that is similar in appearance to SQL. Compared with SQL, however, HQL is fully object-oriented and understands notions like inheritance, polymorphism and association." msgstr "" #. Tag: title -#: query_hql.xml:38 #, no-c-format msgid "Case Sensitivity" msgstr "" #. Tag: para -#: query_hql.xml:40 #, no-c-format msgid "With the exception of names of Java classes and properties, queries are case-insensitive. So <literal>SeLeCT</literal> is the same as <literal>sELEct</literal> is the same as <literal>SELECT</literal>, but <literal>org.hibernate.eg.FOO</literal> is not <literal>org.hibernate.eg.Foo</literal>, and <literal>foo.barSet</literal> is not <literal>foo.BARSET</literal>." msgstr "" #. Tag: para -#: query_hql.xml:51 #, no-c-format msgid "This manual uses lowercase HQL keywords. Some users find queries with uppercase keywords more readable, but this convention is unsuitable for queries embedded in Java code." msgstr "" #. Tag: title -#: query_hql.xml:59 #, no-c-format msgid "The from clause" msgstr "" #. Tag: para -#: query_hql.xml:61 #, no-c-format msgid "The simplest possible Hibernate query is of the form:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:65 -#, no-c-format -msgid "<![CDATA[from eg.Cat]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:67 #, no-c-format msgid "This returns all instances of the class <literal>eg.Cat</literal>. You do not usually need to qualify the class name, since <literal>auto-import</literal> is the default. For example:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:73 -#, no-c-format -msgid "<![CDATA[from Cat]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:75 #, no-c-format msgid "In order to refer to the <literal>Cat</literal> in other parts of the query, you will need to assign an <emphasis>alias</emphasis>. For example:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:81 query_hql.xml:396 -#, no-c-format -msgid "<![CDATA[from Cat as cat]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:83 #, no-c-format msgid "This query assigns the alias <literal>cat</literal> to <literal>Cat</literal> instances, so you can use that alias later in the query. The <literal>as</literal> keyword is optional. You could also write:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:89 -#, no-c-format -msgid "<![CDATA[from Cat cat]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:91 #, no-c-format msgid "Multiple classes can appear, resulting in a cartesian product or \"cross\" join." msgstr "" -#. Tag: programlisting -#: query_hql.xml:95 -#, no-c-format -msgid "<![CDATA[from Formula, Parameter]]>" -msgstr "" - -#. Tag: programlisting -#: query_hql.xml:96 -#, no-c-format -msgid "<![CDATA[from Formula as form, Parameter as param]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:98 #, no-c-format msgid "It is good practice to name query aliases using an initial lowercase as this is consistent with Java naming standards for local variables (e.g. <literal>domesticCat</literal>)." msgstr "" #. Tag: title -#: query_hql.xml:107 #, no-c-format msgid "Associations and joins" msgstr "" #. Tag: para -#: query_hql.xml:109 #, no-c-format msgid "You can also assign aliases to associated entities or to elements of a collection of values using a <literal>join</literal>. For example:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:114 -#, no-c-format -msgid "" - "<![CDATA[from Cat as cat\n" - " inner join cat.mate as mate\n" - " left outer join cat.kittens as kitten]]>" -msgstr "" - -#. Tag: programlisting -#: query_hql.xml:116 -#, no-c-format -msgid "<![CDATA[from Cat as cat left join cat.mate.kittens as kittens]]>" -msgstr "" - -#. Tag: programlisting -#: query_hql.xml:118 -#, no-c-format -msgid "<![CDATA[from Formula form full join form.parameter param]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:120 #, no-c-format msgid "The supported join types are borrowed from ANSI SQL:" msgstr "" -#. Tag: literal -#: query_hql.xml:127 +#. Tag: para #, no-c-format -msgid "inner join" +msgid "<literal>inner join</literal>" msgstr "" -#. Tag: literal -#: query_hql.xml:132 +#. Tag: para #, no-c-format -msgid "left outer join" +msgid "<literal>left outer join</literal>" msgstr "" -#. Tag: literal -#: query_hql.xml:137 +#. Tag: para #, no-c-format -msgid "right outer join" +msgid "<literal>right outer join</literal>" msgstr "" #. Tag: para -#: query_hql.xml:141 #, no-c-format msgid "<literal>full join</literal> (not usually useful)" msgstr "" #. Tag: para -#: query_hql.xml:147 #, no-c-format msgid "The <literal>inner join</literal>, <literal>left outer join</literal> and <literal>right outer join</literal> constructs may be abbreviated." msgstr "" -#. Tag: programlisting -#: query_hql.xml:152 -#, no-c-format -msgid "" - "<![CDATA[from Cat as cat\n" - " join cat.mate as mate\n" - " left join cat.kittens as kitten]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:154 #, no-c-format msgid "You may supply extra join conditions using the HQL <literal>with</literal> keyword." msgstr "" -#. Tag: programlisting -#: query_hql.xml:159 -#, no-c-format -msgid "" - "<![CDATA[from Cat as cat\n" - " left join cat.kittens as kitten\n" - " with kitten.bodyWeight > 10.0]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:161 #, no-c-format -msgid "A \"fetch\" join allows associations or collections of values to be initialized along with their parent objects using a single select. This is particularly useful in the case of a collection. It effectively overrides the outer join and lazy declarations of the mapping file for associations and collections. See <xref linkend=\"performance-fetching\"/> for more information." +msgid "A \"fetch\" join allows associations or collections of values to be initialized along with their parent objects using a single select. This is particularly useful in the case of a collection. It effectively overrides the outer join and lazy declarations of the mapping file for associations and collections. See <xref linkend=\"performance-fetching\" /> for more information." msgstr "" -#. Tag: programlisting -#: query_hql.xml:169 -#, no-c-format -msgid "" - "<![CDATA[from Cat as cat\n" - " inner join fetch cat.mate\n" - " left join fetch cat.kittens]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:171 #, no-c-format msgid "A fetch join does not usually need to assign an alias, because the associated objects should not be used in the <literal>where</literal> clause (or any other clause). The associated objects are also not returned directly in the query results. Instead, they may be accessed via the parent object. The only reason you might need an alias is if you are recursively join fetching a further collection:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:179 -#, no-c-format -msgid "" - "<![CDATA[from Cat as cat\n" - " inner join fetch cat.mate\n" - " left join fetch cat.kittens child\n" - " left join fetch child.kittens]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:181 #, no-c-format msgid "The <literal>fetch</literal> construct cannot be used in queries called using <literal>iterate()</literal> (though <literal>scroll()</literal> can be used). <literal>Fetch</literal> should be used together with <literal>setMaxResults()</literal> or <literal>setFirstResult()</literal>, as these operations are based on the result rows which usually contain duplicates for eager collection fetching, hence, the number of rows is not what you would expect. <literal>Fetch</literal> should also not be used together with impromptu <literal>with</literal> condition. It is possible to create a cartesian product by join fetching more than one collection in a query, so take care in this case. Join fetching multiple collection roles can produce unexpected results for bag mappings, so user discretion is advised when formulating queries in this case. Finally, note that <literal>full join fetch</literal> and <literal>right join fetch</literal> are not meaningful." msgstr "" #. Tag: para -#: query_hql.xml:196 #, no-c-format msgid "If you are using property-level lazy fetching (with bytecode instrumentation), it is possible to force Hibernate to fetch the lazy properties in the first query immediately using <literal>fetch all properties</literal>." msgstr "" -#. Tag: programlisting -#: query_hql.xml:202 -#, no-c-format -msgid "<![CDATA[from Document fetch all properties order by name]]>" -msgstr "" - -#. Tag: programlisting -#: query_hql.xml:203 -#, no-c-format -msgid "<![CDATA[from Document doc fetch all properties where lower(doc.name) like '%cats%']]>" -msgstr "" - #. Tag: title -#: query_hql.xml:208 #, no-c-format msgid "Forms of join syntax" msgstr "" #. Tag: para -#: query_hql.xml:210 #, no-c-format msgid "HQL supports two forms of association joining: <literal>implicit</literal> and <literal>explicit</literal>." msgstr "" #. Tag: para -#: query_hql.xml:214 #, no-c-format msgid "The queries shown in the previous section all use the <literal>explicit</literal> form, that is, where the join keyword is explicitly used in the from clause. This is the recommended form." msgstr "" #. Tag: para -#: query_hql.xml:219 #, no-c-format msgid "The <literal>implicit</literal> form does not use the join keyword. Instead, the associations are \"dereferenced\" using dot-notation. <literal>implicit</literal> joins can appear in any of the HQL clauses. <literal>implicit</literal> join result in inner joins in the resulting SQL statement." msgstr "" -#. Tag: programlisting -#: query_hql.xml:226 -#, no-c-format -msgid "<![CDATA[from Cat as cat where cat.mate.name like '%s%']]>" -msgstr "" - #. Tag: title -#: query_hql.xml:230 #, no-c-format msgid "Referring to identifier property" msgstr "" #. Tag: para -#: query_hql.xml:232 #, no-c-format msgid "There are 2 ways to refer to an entity's identifier property:" msgstr "" #. Tag: para -#: query_hql.xml:237 #, no-c-format msgid "The special property (lowercase) <literal>id</literal> may be used to reference the identifier property of an entity <emphasis>provided that the entity does not define a non-identifier property named id</emphasis>." msgstr "" #. Tag: para -#: query_hql.xml:244 #, no-c-format msgid "If the entity defines a named identifier property, you can use that property name." msgstr "" #. Tag: para -#: query_hql.xml:250 #, no-c-format msgid "References to composite identifier properties follow the same naming rules. If the entity has a non-identifier property named id, the composite identifier property can only be referenced by its defined named. Otherwise, the special <literal>id</literal> property can be used to reference the identifier property." msgstr "" #. Tag: para -#: query_hql.xml:258 #, no-c-format msgid "Please note that, starting in version 3.2.2, this has changed significantly. In previous versions, <literal>id</literal> <emphasis>always</emphasis> referred to the identifier property regardless of its actual name. A ramification of that decision was that non-identifier properties named <literal>id</literal> could never be referenced in Hibernate queries." msgstr "" #. Tag: title -#: query_hql.xml:269 #, no-c-format msgid "The select clause" msgstr "" #. Tag: para -#: query_hql.xml:271 #, no-c-format msgid "The <literal>select</literal> clause picks which objects and properties to return in the query result set. Consider the following:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:276 -#, no-c-format -msgid "" - "<![CDATA[select mate\n" - "from Cat as cat\n" - " inner join cat.mate as mate]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:278 #, no-c-format msgid "The query will select <literal>mate</literal>s of other <literal>Cat</literal>s. You can express this query more compactly as:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:283 -#, no-c-format -msgid "<![CDATA[select cat.mate from Cat cat]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:285 #, no-c-format msgid "Queries can return properties of any value type including properties of component type:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:289 -#, no-c-format -msgid "" - "<![CDATA[select cat.name from DomesticCat cat\n" - "where cat.name like 'fri%']]>" -msgstr "" - -#. Tag: programlisting -#: query_hql.xml:291 -#, no-c-format -msgid "<![CDATA[select cust.name.firstName from Customer as cust]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:293 #, no-c-format msgid "Queries can return multiple objects and/or properties as an array of type <literal>Object[]</literal>:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:298 -#, no-c-format -msgid "" - "<![CDATA[select mother, offspr, mate.name\n" - "from DomesticCat as mother\n" - " inner join mother.mate as mate\n" - " left outer join mother.kittens as offspr]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:300 #, no-c-format msgid "Or as a <literal>List</literal>:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:304 -#, no-c-format -msgid "" - "<![CDATA[select new list(mother, offspr, mate.name)\n" - "from DomesticCat as mother\n" - " inner join mother.mate as mate\n" - " left outer join mother.kittens as offspr]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:306 #, no-c-format msgid "Or - assuming that the class <literal>Family</literal> has an appropriate constructor - as an actual typesafe Java object:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:310 -#, no-c-format -msgid "" - "<![CDATA[select new Family(mother, mate, offspr)\n" - "from DomesticCat as mother\n" - " join mother.mate as mate\n" - " left join mother.kittens as offspr]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:313 #, no-c-format msgid "You can assign aliases to selected expressions using <literal>as</literal>:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:317 -#, no-c-format -msgid "" - "<![CDATA[select max(bodyWeight) as max, min(bodyWeight) as min, count(*) as n\n" - "from Cat cat]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:319 #, no-c-format msgid "This is most useful when used together with <literal>select new map</literal>:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:323 -#, no-c-format -msgid "" - "<![CDATA[select new map( max(bodyWeight) as max, min(bodyWeight) as min, count(*) as n )\n" - "from Cat cat]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:325 #, no-c-format msgid "This query returns a <literal>Map</literal> from aliases to selected values." msgstr "" #. Tag: title -#: query_hql.xml:332 #, no-c-format msgid "Aggregate functions" msgstr "" #. Tag: para -#: query_hql.xml:334 #, no-c-format msgid "HQL queries can even return the results of aggregate functions on properties:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:338 -#, no-c-format -msgid "" - "<![CDATA[select avg(cat.weight), sum(cat.weight), max(cat.weight), count(cat)\n" - "from Cat cat]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:349 #, no-c-format msgid "The supported aggregate functions are:" msgstr "" -#. Tag: literal -#: query_hql.xml:356 +#. Tag: para #, no-c-format -msgid "avg(...), sum(...), min(...), max(...)" +msgid "<literal>avg(...), sum(...), min(...), max(...)</literal>" msgstr "" -#. Tag: literal -#: query_hql.xml:361 +#. Tag: para #, no-c-format -msgid "count(*)" +msgid "<literal>count(*)</literal>" msgstr "" -#. Tag: literal -#: query_hql.xml:366 +#. Tag: para #, no-c-format -msgid "count(...), count(distinct ...), count(all...)" +msgid "<literal>count(...), count(distinct ...), count(all...)</literal>" msgstr "" #. Tag: para -#: query_hql.xml:371 #, no-c-format msgid "You can use arithmetic operators, concatenation, and recognized SQL functions in the select clause:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:376 -#, no-c-format -msgid "" - "<![CDATA[select cat.weight + sum(kitten.weight)\n" - "from Cat cat\n" - " join cat.kittens kitten\n" - "group by cat.id, cat.weight]]>" -msgstr "" - -#. Tag: programlisting -#: query_hql.xml:378 -#, no-c-format -msgid "<![CDATA[select firstName||' '||initial||' '||upper(lastName) from Person]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:380 #, no-c-format msgid "The <literal>distinct</literal> and <literal>all</literal> keywords can be used and have the same semantics as in SQL." msgstr "" -#. Tag: programlisting -#: query_hql.xml:385 -#, no-c-format -msgid "" - "<![CDATA[select distinct cat.name from Cat cat\n" - "\n" - "select count(distinct cat.name), count(cat) from Cat cat]]>" -msgstr "" - #. Tag: title -#: query_hql.xml:390 #, no-c-format msgid "Polymorphic queries" msgstr "" #. Tag: para -#: query_hql.xml:392 #, no-c-format msgid "A query like:" msgstr "" #. Tag: para -#: query_hql.xml:398 #, no-c-format msgid "returns instances not only of <literal>Cat</literal>, but also of subclasses like <literal>DomesticCat</literal>. Hibernate queries can name <emphasis>any</emphasis> Java class or interface in the <literal>from</literal> clause. The query will return instances of all persistent classes that extend that class or implement the interface. The following query would return all persistent objects:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:406 -#, no-c-format -msgid "<![CDATA[from java.lang.Object o]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:408 #, no-c-format msgid "The interface <literal>Named</literal> might be implemented by various persistent classes:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:413 -#, no-c-format -msgid "<![CDATA[from Named n, Named m where n.name = m.name]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:415 #, no-c-format msgid "These last two queries will require more than one SQL <literal>SELECT</literal>. This means that the <literal>order by</literal> clause does not correctly order the whole result set. It also means you cannot call these queries using <literal>Query.scroll()</literal>." msgstr "" #. Tag: title -#: query_hql.xml:424 #, no-c-format msgid "The where clause" msgstr "" #. Tag: para -#: query_hql.xml:426 #, no-c-format msgid "The <literal>where</literal> clause allows you to refine the list of instances returned. If no alias exists, you can refer to properties by name:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:431 -#, no-c-format -msgid "<![CDATA[from Cat where name='Fritz']]>" -msgstr "" - #. Tag: para -#: query_hql.xml:433 #, no-c-format msgid "If there is an alias, use a qualified property name:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:437 -#, no-c-format -msgid "<![CDATA[from Cat as cat where cat.name='Fritz']]>" -msgstr "" - #. Tag: para -#: query_hql.xml:439 #, no-c-format msgid "This returns instances of <literal>Cat</literal> named 'Fritz'." msgstr "" #. Tag: para -#: query_hql.xml:443 #, no-c-format -msgid "" - "The following query: <programlisting><![CDATA[select foo\n" - "from Foo foo, Bar bar\n" - "where foo.startDate = bar.date]]></programlisting> returns all instances of <literal>Foo</literal> with an instance of <literal>bar</literal> with a <literal>date</literal> property equal to the <literal>startDate</literal> property of the <literal>Foo</literal>. Compound path expressions make the <literal>where</literal> clause extremely powerful. Consider the following:" +msgid "The following query:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:454 +#. Tag: para #, no-c-format -msgid "<![CDATA[from Cat cat where cat.mate.name is not null]]>" +msgid "returns all instances of <literal>Foo</literal> with an instance of <literal>bar</literal> with a <literal>date</literal> property equal to the <literal>startDate</literal> property of the <literal>Foo</literal>. Compound path expressions make the <literal>where</literal> clause extremely powerful. Consider the following:" msgstr "" #. Tag: para -#: query_hql.xml:456 #, no-c-format msgid "This query translates to an SQL query with a table (inner) join. For example:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:461 -#, no-c-format -msgid "" - "<![CDATA[from Foo foo\n" - "where foo.bar.baz.customer.address.city is not null]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:463 #, no-c-format msgid "would result in a query that would require four table joins in SQL." msgstr "" #. Tag: para -#: query_hql.xml:467 #, no-c-format msgid "The <literal>=</literal> operator can be used to compare not only properties, but also instances:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:472 -#, no-c-format -msgid "<![CDATA[from Cat cat, Cat rival where cat.mate = rival.mate]]>" -msgstr "" - -#. Tag: programlisting -#: query_hql.xml:474 -#, no-c-format -msgid "" - "<![CDATA[select cat, mate\n" - "from Cat cat, Cat mate\n" - "where cat.mate = mate]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:476 #, no-c-format -msgid "The special property (lowercase) <literal>id</literal> can be used to reference the unique identifier of an object. See <xref linkend=\"queryhql-identifier-property\"/> for more information." +msgid "The special property (lowercase) <literal>id</literal> can be used to reference the unique identifier of an object. See <xref linkend=\"queryhql-identifier-property\" /> for more information." msgstr "" -#. Tag: programlisting -#: query_hql.xml:482 -#, no-c-format -msgid "" - "<![CDATA[from Cat as cat where cat.id = 123\n" - "\n" - "from Cat as cat where cat.mate.id = 69]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:484 #, no-c-format msgid "The second query is efficient and does not require a table join." msgstr "" #. Tag: para -#: query_hql.xml:488 #, no-c-format msgid "Properties of composite identifiers can also be used. Consider the following example where <literal>Person</literal> has composite identifiers consisting of <literal>country</literal> and <literal>medicareNumber</literal>:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:494 -#, no-c-format -msgid "" - "<![CDATA[from bank.Person person\n" - "where person.id.country = 'AU'\n" - " and person.id.medicareNumber = 123456]]>" -msgstr "" - -#. Tag: programlisting -#: query_hql.xml:496 -#, no-c-format -msgid "" - "<![CDATA[from bank.Account account\n" - "where account.owner.id.country = 'AU'\n" - " and account.owner.id.medicareNumber = 123456]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:498 #, no-c-format msgid "Once again, the second query does not require a table join." msgstr "" #. Tag: para -#: query_hql.xml:502 #, no-c-format -msgid "See <xref linkend=\"queryhql-identifier-property\"/> for more information regarding referencing identifier properties)" +msgid "See <xref linkend=\"queryhql-identifier-property\" /> for more information regarding referencing identifier properties)" msgstr "" #. Tag: para -#: query_hql.xml:507 #, no-c-format msgid "The special property <literal>class</literal> accesses the discriminator value of an instance in the case of polymorphic persistence. A Java class name embedded in the where clause will be translated to its discriminator value." msgstr "" -#. Tag: programlisting -#: query_hql.xml:513 -#, no-c-format -msgid "<![CDATA[from Cat cat where cat.class = DomesticCat]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:515 #, no-c-format -msgid "You can also use components or composite user types, or properties of said component types. See <xref linkend=\"queryhql-components\"/> for more information." +msgid "You can also use components or composite user types, or properties of said component types. See <xref linkend=\"queryhql-components\" /> for more information." msgstr "" #. Tag: para -#: query_hql.xml:520 #, no-c-format msgid "An \"any\" type has the special properties <literal>id</literal> and <literal>class</literal> that allows you to express a join in the following way (where <literal>AuditLog.item</literal> is a property mapped with <literal><any></literal>):" msgstr "" -#. Tag: programlisting -#: query_hql.xml:526 -#, no-c-format -msgid "" - "<![CDATA[from AuditLog log, Payment payment\n" - "where log.item.class = 'Payment' and log.item.id = payment.id]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:528 #, no-c-format msgid "The <literal>log.item.class</literal> and <literal>payment.class</literal> would refer to the values of completely different database columns in the above query." msgstr "" #. Tag: title -#: query_hql.xml:536 #, no-c-format msgid "Expressions" msgstr "" #. Tag: para -#: query_hql.xml:538 #, no-c-format msgid "Expressions used in the <literal>where</literal> clause include the following:" msgstr "" #. Tag: para -#: query_hql.xml:545 #, no-c-format msgid "mathematical operators: <literal>+, -, *, /</literal>" msgstr "" #. Tag: para -#: query_hql.xml:550 #, no-c-format msgid "binary comparison operators: <literal>=, >=, <=, <>, !=, like</literal>" msgstr "" #. Tag: para -#: query_hql.xml:555 #, no-c-format msgid "logical operations <literal>and, or, not</literal>" msgstr "" #. Tag: para -#: query_hql.xml:560 #, no-c-format msgid "Parentheses <literal>( )</literal> that indicates grouping" msgstr "" #. Tag: para -#: query_hql.xml:565 #, no-c-format msgid "<literal>in</literal>, <literal>not in</literal>, <literal>between</literal>, <literal>is null</literal>, <literal>is not null</literal>, <literal>is empty</literal>, <literal>is not empty</literal>, <literal>member of</literal> and <literal>not member of</literal>" msgstr "" #. Tag: para -#: query_hql.xml:578 #, no-c-format msgid "\"Simple\" case, <literal>case ... when ... then ... else ... end</literal>, and \"searched\" case, <literal>case when ... then ... else ... end</literal>" msgstr "" #. Tag: para -#: query_hql.xml:584 #, no-c-format msgid "string concatenation <literal>...||...</literal> or <literal>concat(...,...)</literal>" msgstr "" #. Tag: para -#: query_hql.xml:589 #, no-c-format msgid "<literal>current_date()</literal>, <literal>current_time()</literal>, and <literal>current_timestamp()</literal>" msgstr "" #. Tag: para -#: query_hql.xml:595 #, no-c-format msgid "<literal>second(...)</literal>, <literal>minute(...)</literal>, <literal>hour(...)</literal>, <literal>day(...)</literal>, <literal>month(...)</literal>, and <literal>year(...)</literal>" msgstr "" #. Tag: para -#: query_hql.xml:602 #, no-c-format msgid "Any function or operator defined by EJB-QL 3.0: <literal>substring(), trim(), lower(), upper(), length(), locate(), abs(), sqrt(), bit_length(), mod()</literal>" msgstr "" #. Tag: para -#: query_hql.xml:608 #, no-c-format msgid "<literal>coalesce()</literal> and <literal>nullif()</literal>" msgstr "" #. Tag: para -#: query_hql.xml:613 #, no-c-format msgid "<literal>str()</literal> for converting numeric or temporal values to a readable string" msgstr "" #. Tag: para -#: query_hql.xml:619 #, no-c-format msgid "<literal>cast(... as ...)</literal>, where the second argument is the name of a Hibernate type, and <literal>extract(... from ...)</literal> if ANSI <literal>cast()</literal> and <literal>extract()</literal> is supported by the underlying database" msgstr "" #. Tag: para -#: query_hql.xml:627 #, no-c-format msgid "the HQL <literal>index()</literal> function, that applies to aliases of a joined indexed collection" msgstr "" #. Tag: para -#: query_hql.xml:633 #, no-c-format msgid "HQL functions that take collection-valued path expressions: <literal>size(), minelement(), maxelement(), minindex(), maxindex()</literal>, along with the special <literal>elements()</literal> and <literal>indices</literal> functions that can be quantified using <literal>some, all, exists, any, in</literal>." msgstr "" #. Tag: para -#: query_hql.xml:641 #, no-c-format msgid "Any database-supported SQL scalar function like <literal>sign()</literal>, <literal>trunc()</literal>, <literal>rtrim()</literal>, and <literal>sin()</literal>" msgstr "" #. Tag: para -#: query_hql.xml:647 #, no-c-format msgid "JDBC-style positional parameters <literal>?</literal>" msgstr "" #. Tag: para -#: query_hql.xml:652 #, no-c-format msgid "named parameters <literal>:name</literal>, <literal>:start_date</literal>, and <literal>:x1</literal>" msgstr "" #. Tag: para -#: query_hql.xml:657 #, no-c-format msgid "SQL literals <literal>'foo'</literal>, <literal>69</literal>, <literal>6.66E+2</literal>, <literal>'1970-01-01 10:00:01.0'</literal>" msgstr "" #. Tag: para -#: query_hql.xml:663 #, no-c-format msgid "Java <literal>public static final</literal> constants <literal>eg.Color.TABBY</literal>" msgstr "" #. Tag: para -#: query_hql.xml:669 #, no-c-format msgid "<literal>in</literal> and <literal>between</literal> can be used as follows:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:673 -#, no-c-format -msgid "<![CDATA[from DomesticCat cat where cat.name between 'A' and 'B']]>" -msgstr "" - -#. Tag: programlisting -#: query_hql.xml:675 -#, no-c-format -msgid "<![CDATA[from DomesticCat cat where cat.name in ( 'Foo', 'Bar', 'Baz' )]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:677 #, no-c-format msgid "The negated forms can be written as follows:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:681 -#, no-c-format -msgid "<![CDATA[from DomesticCat cat where cat.name not between 'A' and 'B']]>" -msgstr "" - -#. Tag: programlisting -#: query_hql.xml:683 -#, no-c-format -msgid "<![CDATA[from DomesticCat cat where cat.name not in ( 'Foo', 'Bar', 'Baz' )]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:685 #, no-c-format msgid "Similarly, <literal>is null</literal> and <literal>is not null</literal> can be used to test for null values." msgstr "" #. Tag: para -#: query_hql.xml:690 #, no-c-format msgid "Booleans can be easily used in expressions by declaring HQL query substitutions in Hibernate configuration:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:695 -#, no-c-format -msgid "<![CDATA[<property name=\"hibernate.query.substitutions\">true 1, false 0</property>]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:697 #, no-c-format msgid "This will replace the keywords <literal>true</literal> and <literal>false</literal> with the literals <literal>1</literal> and <literal>0</literal> in the translated SQL from this HQL:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:702 -#, no-c-format -msgid "<![CDATA[from Cat cat where cat.alive = true]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:704 #, no-c-format msgid "You can test the size of a collection with the special property <literal>size</literal> or the special <literal>size()</literal> function." msgstr "" -#. Tag: programlisting -#: query_hql.xml:709 -#, no-c-format -msgid "<![CDATA[from Cat cat where cat.kittens.size > 0]]>" -msgstr "" - -#. Tag: programlisting -#: query_hql.xml:711 -#, no-c-format -msgid "<![CDATA[from Cat cat where size(cat.kittens) > 0]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:713 #, no-c-format msgid "For indexed collections, you can refer to the minimum and maximum indices using <literal>minindex</literal> and <literal>maxindex</literal> functions. Similarly, you can refer to the minimum and maximum elements of a collection of basic type using the <literal>minelement</literal> and <literal>maxelement</literal> functions. For example:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:721 -#, no-c-format -msgid "<![CDATA[from Calendar cal where maxelement(cal.holidays) > current_date]]>" -msgstr "" - -#. Tag: programlisting -#: query_hql.xml:723 -#, no-c-format -msgid "<![CDATA[from Order order where maxindex(order.items) > 100]]>" -msgstr "" - -#. Tag: programlisting -#: query_hql.xml:725 -#, no-c-format -msgid "<![CDATA[from Order order where minelement(order.items) > 10000]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:727 #, no-c-format msgid "The SQL functions <literal>any, some, all, exists, in</literal> are supported when passed the element or index set of a collection (<literal>elements</literal> and <literal>indices</literal> functions) or the result of a subquery (see below):" msgstr "" -#. Tag: programlisting -#: query_hql.xml:733 -#, no-c-format -msgid "" - "<![CDATA[select mother from Cat as mother, Cat as kit\n" - "where kit in elements(foo.kittens)]]>" -msgstr "" - -#. Tag: programlisting -#: query_hql.xml:735 -#, no-c-format -msgid "" - "<![CDATA[select p from NameList list, Person p\n" - "where p.name = some elements(list.names)]]>" -msgstr "" - -#. Tag: programlisting -#: query_hql.xml:737 -#, no-c-format -msgid "<![CDATA[from Cat cat where exists elements(cat.kittens)]]>" -msgstr "" - -#. Tag: programlisting -#: query_hql.xml:739 -#, no-c-format -msgid "<![CDATA[from Player p where 3 > all elements(p.scores)]]>" -msgstr "" - -#. Tag: programlisting -#: query_hql.xml:741 -#, no-c-format -msgid "<![CDATA[from Show show where 'fizard' in indices(show.acts)]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:743 #, no-c-format msgid "Note that these constructs - <literal>size</literal>, <literal>elements</literal>, <literal>indices</literal>, <literal>minindex</literal>, <literal>maxindex</literal>, <literal>minelement</literal>, <literal>maxelement</literal> - can only be used in the where clause in Hibernate3." msgstr "" #. Tag: para -#: query_hql.xml:750 #, no-c-format msgid "Elements of indexed collections (arrays, lists, and maps) can be referred to by index in a where clause only:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:755 -#, no-c-format -msgid "<![CDATA[from Order order where order.items[0].id = 1234]]>" -msgstr "" - -#. Tag: programlisting -#: query_hql.xml:757 -#, no-c-format -msgid "" - "<![CDATA[select person from Person person, Calendar calendar\n" - "where calendar.holidays['national day'] = person.birthDay\n" - " and person.nationality.calendar = calendar]]>" -msgstr "" - -#. Tag: programlisting -#: query_hql.xml:759 -#, no-c-format -msgid "" - "<![CDATA[select item from Item item, Order order\n" - "where order.items[ order.deliveredItemIndices[0] ] = item and order.id = 11]]>" -msgstr "" - -#. Tag: programlisting -#: query_hql.xml:761 -#, no-c-format -msgid "" - "<![CDATA[select item from Item item, Order order\n" - "where order.items[ maxindex(order.items) ] = item and order.id = 11]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:763 #, no-c-format msgid "The expression inside <literal>[]</literal> can even be an arithmetic expression:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:767 -#, no-c-format -msgid "" - "<![CDATA[select item from Item item, Order order\n" - "where order.items[ size(order.items) - 1 ] = item]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:769 #, no-c-format msgid "HQL also provides the built-in <literal>index()</literal> function for elements of a one-to-many association or collection of values." msgstr "" -#. Tag: programlisting -#: query_hql.xml:774 -#, no-c-format -msgid "" - "<![CDATA[select item, index(item) from Order order\n" - " join order.items item\n" - "where index(item) < 5]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:776 #, no-c-format msgid "Scalar SQL functions supported by the underlying database can be used:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:780 -#, no-c-format -msgid "<![CDATA[from DomesticCat cat where upper(cat.name) like 'FRI%']]>" -msgstr "" - #. Tag: para -#: query_hql.xml:782 #, no-c-format msgid "Consider how much longer and less readable the following query would be in SQL:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:787 -#, no-c-format -msgid "" - "<![CDATA[select cust\n" - "from Product prod,\n" - " Store store\n" - " inner join store.customers cust\n" - "where prod.name = 'widget'\n" - " and store.location.name in ( 'Melbourne', 'Sydney' )\n" - " and prod = all elements(cust.currentOrder.lineItems)]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:789 #, no-c-format msgid "<emphasis>Hint:</emphasis> something like" msgstr "" -#. Tag: programlisting -#: query_hql.xml:793 -#, no-c-format -msgid "" - "<![CDATA[SELECT cust.name, cust.address, cust.phone, cust.id, cust.current_order\n" - "FROM customers cust,\n" - " stores store,\n" - " locations loc,\n" - " store_customers sc,\n" - " product prod\n" - "WHERE prod.name = 'widget'\n" - " AND store.loc_id = loc.id\n" - " AND loc.name IN ( 'Melbourne', 'Sydney' )\n" - " AND sc.store_id = store.id\n" - " AND sc.cust_id = cust.id\n" - " AND prod.id = ALL(\n" - " SELECT item.prod_id\n" - " FROM line_items item, orders o\n" - " WHERE item.order_id = o.id\n" - " AND cust.current_order = o.id\n" - " )]]>" -msgstr "" - #. Tag: title -#: query_hql.xml:798 #, no-c-format msgid "The order by clause" msgstr "" #. Tag: para -#: query_hql.xml:800 #, no-c-format msgid "The list returned by a query can be ordered by any property of a returned class or components:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:804 -#, no-c-format -msgid "" - "<![CDATA[from DomesticCat cat\n" - "order by cat.name asc, cat.weight desc, cat.birthdate]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:806 #, no-c-format msgid "The optional <literal>asc</literal> or <literal>desc</literal> indicate ascending or descending order respectively." msgstr "" #. Tag: title -#: query_hql.xml:813 #, no-c-format msgid "The group by clause" msgstr "" #. Tag: para -#: query_hql.xml:815 #, no-c-format msgid "A query that returns aggregate values can be grouped by any property of a returned class or components:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:819 -#, no-c-format -msgid "" - "<![CDATA[select cat.color, sum(cat.weight), count(cat)\n" - "from Cat cat\n" - "group by cat.color]]>" -msgstr "" - -#. Tag: programlisting -#: query_hql.xml:821 -#, no-c-format -msgid "" - "<![CDATA[select foo.id, avg(name), max(name)\n" - "from Foo foo join foo.names name\n" - "group by foo.id]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:823 #, no-c-format msgid "A <literal>having</literal> clause is also allowed." msgstr "" -#. Tag: programlisting -#: query_hql.xml:827 -#, no-c-format -msgid "" - "<![CDATA[select cat.color, sum(cat.weight), count(cat)\n" - "from Cat cat\n" - "group by cat.color\n" - "having cat.color in (eg.Color.TABBY, eg.Color.BLACK)]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:829 #, no-c-format msgid "SQL functions and aggregate functions are allowed in the <literal>having</literal> and <literal>order by</literal> clauses if they are supported by the underlying database (i.e., not in MySQL)." msgstr "" -#. Tag: programlisting -#: query_hql.xml:835 -#, no-c-format -msgid "" - "<![CDATA[select cat\n" - "from Cat cat\n" - " join cat.kittens kitten\n" - "group by cat.id, cat.name, cat.other, cat.properties\n" - "having avg(kitten.weight) > 100\n" - "order by count(kitten) asc, sum(kitten.weight) desc]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:837 #, no-c-format msgid "Neither the <literal>group by</literal> clause nor the <literal>order by</literal> clause can contain arithmetic expressions. Hibernate also does not currently expand a grouped entity, so you cannot write <literal>group by cat</literal> if all properties of <literal>cat</literal> are non-aggregated. You have to list all non-aggregated properties explicitly." msgstr "" #. Tag: title -#: query_hql.xml:849 #, no-c-format msgid "Subqueries" msgstr "" #. Tag: para -#: query_hql.xml:851 #, no-c-format msgid "For databases that support subselects, Hibernate supports subqueries within queries. A subquery must be surrounded by parentheses (often by an SQL aggregate function call). Even correlated subqueries (subqueries that refer to an alias in the outer query) are allowed." msgstr "" -#. Tag: programlisting -#: query_hql.xml:857 -#, no-c-format -msgid "" - "<![CDATA[from Cat as fatcat\n" - "where fatcat.weight > (\n" - " select avg(cat.weight) from DomesticCat cat\n" - ")]]>" -msgstr "" - -#. Tag: programlisting -#: query_hql.xml:859 -#, no-c-format -msgid "" - "<![CDATA[from DomesticCat as cat\n" - "where cat.name = some (\n" - " select name.nickName from Name as name\n" - ")]]>" -msgstr "" - -#. Tag: programlisting -#: query_hql.xml:861 -#, no-c-format -msgid "" - "<![CDATA[from Cat as cat\n" - "where not exists (\n" - " from Cat as mate where mate.mate = cat\n" - ")]]>" -msgstr "" - -#. Tag: programlisting -#: query_hql.xml:863 -#, no-c-format -msgid "" - "<![CDATA[from DomesticCat as cat\n" - "where cat.name not in (\n" - " select name.nickName from Name as name\n" - ")]]>" -msgstr "" - -#. Tag: programlisting -#: query_hql.xml:865 -#, no-c-format -msgid "" - "<![CDATA[select cat.id, (select max(kit.weight) from cat.kitten kit)\n" - "from Cat as cat]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:867 #, no-c-format msgid "Note that HQL subqueries can occur only in the select or where clauses." msgstr "" #. Tag: para -#: query_hql.xml:871 #, no-c-format -msgid "Note that subqueries can also utilize <literal>row value constructor</literal> syntax. See <xref linkend=\"queryhql-tuple\"/> for more information." +msgid "Note that subqueries can also utilize <literal>row value constructor</literal> syntax. See <xref linkend=\"queryhql-tuple\" /> for more information." msgstr "" #. Tag: title -#: query_hql.xml:879 #, no-c-format msgid "HQL examples" msgstr "" #. Tag: para -#: query_hql.xml:881 #, no-c-format msgid "Hibernate queries can be quite powerful and complex. In fact, the power of the query language is one of Hibernate's main strengths. The following example queries are similar to queries that have been used on recent projects. Please note that most queries you will write will be much simpler than the following examples." msgstr "" #. Tag: para -#: query_hql.xml:887 #, no-c-format msgid "The following query returns the order id, number of items, the given minimum total value and the total value of the order for all unpaid orders for a particular customer. The results are ordered by total value. In determining the prices, it uses the current catalog. The resulting SQL query, against the <literal>ORDER</literal>, <literal>ORDER_LINE</literal>, <literal>PRODUCT</literal>, <literal>CATALOG</literal> and <literal>PRICE</literal> tables has four inner joins and an (uncorrelated) subselect." msgstr "" -#. Tag: programlisting -#: query_hql.xml:896 -#, no-c-format -msgid "" - "<![CDATA[select order.id, sum(price.amount), count(item)\n" - "from Order as order\n" - " join order.lineItems as item\n" - " join item.product as product,\n" - " Catalog as catalog\n" - " join catalog.prices as price\n" - "where order.paid = false\n" - " and order.customer = :customer\n" - " and price.product = product\n" - " and catalog.effectiveDate < sysdate\n" - " and catalog.effectiveDate >= all (\n" - " select cat.effectiveDate\n" - " from Catalog as cat\n" - " where cat.effectiveDate < sysdate\n" - " )\n" - "group by order\n" - "having sum(price.amount) > :minAmount\n" - "order by sum(price.amount) desc]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:898 #, no-c-format msgid "What a monster! Actually, in real life, I'm not very keen on subqueries, so my query was really more like this:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:903 -#, no-c-format -msgid "" - "<![CDATA[select order.id, sum(price.amount), count(item)\n" - "from Order as order\n" - " join order.lineItems as item\n" - " join item.product as product,\n" - " Catalog as catalog\n" - " join catalog.prices as price\n" - "where order.paid = false\n" - " and order.customer = :customer\n" - " and price.product = product\n" - " and catalog = :currentCatalog\n" - "group by order\n" - "having sum(price.amount) > :minAmount\n" - "order by sum(price.amount) desc]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:905 #, no-c-format msgid "The next query counts the number of payments in each status, excluding all payments in the <literal>AWAITING_APPROVAL</literal> status where the most recent status change was made by the current user. It translates to an SQL query with two inner joins and a correlated subselect against the <literal>PAYMENT</literal>, <literal>PAYMENT_STATUS</literal> and <literal>PAYMENT_STATUS_CHANGE</literal> tables." msgstr "" -#. Tag: programlisting -#: query_hql.xml:913 -#, no-c-format -msgid "" - "<![CDATA[select count(payment), status.name\n" - "from Payment as payment\n" - " join payment.currentStatus as status\n" - " join payment.statusChanges as statusChange\n" - "where payment.status.name <> PaymentStatus.AWAITING_APPROVAL\n" - " or (\n" - " statusChange.timeStamp = (\n" - " select max(change.timeStamp)\n" - " from PaymentStatusChange change\n" - " where change.payment = payment\n" - " )\n" - " and statusChange.user <> :currentUser\n" - " )\n" - "group by status.name, status.sortOrder\n" - "order by status.sortOrder]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:915 #, no-c-format msgid "If the <literal>statusChanges</literal> collection was mapped as a list, instead of a set, the query would have been much simpler to write." msgstr "" -#. Tag: programlisting -#: query_hql.xml:920 -#, no-c-format -msgid "" - "<![CDATA[select count(payment), status.name\n" - "from Payment as payment\n" - " join payment.currentStatus as status\n" - "where payment.status.name <> PaymentStatus.AWAITING_APPROVAL\n" - " or payment.statusChanges[ maxIndex(payment.statusChanges) ].user <> :currentUser\n" - "group by status.name, status.sortOrder\n" - "order by status.sortOrder]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:922 #, no-c-format msgid "The next query uses the MS SQL Server <literal>isNull()</literal> function to return all the accounts and unpaid payments for the organization to which the current user belongs. It translates to an SQL query with three inner joins, an outer join and a subselect against the <literal>ACCOUNT</literal>, <literal>PAYMENT</literal>, <literal>PAYMENT_STATUS</literal>, <literal>ACCOUNT_TYPE</literal>, <literal>ORGANIZATION</literal> and <literal>ORG_USER</literal> tables." msgstr "" -#. Tag: programlisting -#: query_hql.xml:931 -#, no-c-format -msgid "" - "<![CDATA[select account, payment\n" - "from Account as account\n" - " left outer join account.payments as payment\n" - "where :currentUser in elements(account.holder.users)\n" - " and PaymentStatus.UNPAID = isNull(payment.currentStatus.name, PaymentStatus.UNPAID)\n" - "order by account.type.sortOrder, account.accountNumber, payment.dueDate]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:933 #, no-c-format msgid "For some databases, we would need to do away with the (correlated) subselect." msgstr "" -#. Tag: programlisting -#: query_hql.xml:937 -#, no-c-format -msgid "" - "<![CDATA[select account, payment\n" - "from Account as account\n" - " join account.holder.users as user\n" - " left outer join account.payments as payment\n" - "where :currentUser = user\n" - " and PaymentStatus.UNPAID = isNull(payment.currentStatus.name, PaymentStatus.UNPAID)\n" - "order by account.type.sortOrder, account.accountNumber, payment.dueDate]]>" -msgstr "" - #. Tag: title -#: query_hql.xml:942 #, no-c-format msgid "Bulk update and delete" msgstr "" #. Tag: para -#: query_hql.xml:944 #, no-c-format -msgid "HQL now supports <literal>update</literal>, <literal>delete</literal> and <literal>insert ... select ...</literal> statements. See <xref linkend=\"batch-direct\"/> for more information." +msgid "HQL now supports <literal>update</literal>, <literal>delete</literal> and <literal>insert ... select ...</literal> statements. See <xref linkend=\"batch-direct\" /> for more information." msgstr "" #. Tag: title -#: query_hql.xml:952 #, no-c-format msgid "Tips & Tricks" msgstr "" #. Tag: para -#: query_hql.xml:954 #, no-c-format msgid "You can count the number of query results without returning them:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:958 -#, no-c-format -msgid "<![CDATA[( (Integer) session.createQuery(\"select count(*) from ....\").iterate().next() ).intValue()]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:960 #, no-c-format msgid "To order a result by the size of a collection, use the following query:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:964 -#, no-c-format -msgid "" - "<![CDATA[select usr.id, usr.name\n" - "from User as usr\n" - " left join usr.messages as msg\n" - "group by usr.id, usr.name\n" - "order by count(msg)]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:966 #, no-c-format msgid "If your database supports subselects, you can place a condition upon selection size in the where clause of your query:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:971 -#, no-c-format -msgid "<![CDATA[from User usr where size(usr.messages) >= 1]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:973 #, no-c-format msgid "If your database does not support subselects, use the following query:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:977 -#, no-c-format -msgid "" - "<![CDATA[select usr.id, usr.name\n" - "from User usr.name\n" - " join usr.messages msg\n" - "group by usr.id, usr.name\n" - "having count(msg) >= 1]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:980 #, no-c-format msgid "As this solution cannot return a <literal>User</literal> with zero messages because of the inner join, the following form is also useful:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:985 -#, no-c-format -msgid "" - "<![CDATA[select usr.id, usr.name\n" - "from User as usr\n" - " left join usr.messages as msg\n" - "group by usr.id, usr.name\n" - "having count(msg) = 0]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:987 #, no-c-format msgid "Properties of a JavaBean can be bound to named query parameters:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:991 -#, no-c-format -msgid "" - "<![CDATA[Query q = s.createQuery(\"from foo Foo as foo where foo.name=:name and foo.size=:size\");\n" - "q.setProperties(fooBean); // fooBean has getName() and getSize()\n" - "List foos = q.list();]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:993 #, no-c-format msgid "Collections are pageable by using the <literal>Query</literal> interface with a filter:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:997 -#, no-c-format -msgid "" - "<![CDATA[Query q = s.createFilter( collection, \"\" ); // the trivial filter\n" - "q.setMaxResults(PAGE_SIZE);\n" - "q.setFirstResult(PAGE_SIZE * pageNumber);\n" - "List page = q.list();]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:999 #, no-c-format msgid "Collection elements can be ordered or grouped using a query filter:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:1003 -#, no-c-format -msgid "" - "<![CDATA[Collection orderedCollection = s.filter( collection, \"order by this.amount\" );\n" - "Collection counts = s.filter( collection, \"select this.type, count(this) group by this.type\" );]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:1005 #, no-c-format msgid "You can find the size of a collection without initializing it:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:1009 -#, no-c-format -msgid "<![CDATA[( (Integer) session.createQuery(\"select count(*) from ....\").iterate().next() ).intValue();]]>" -msgstr "" - #. Tag: title -#: query_hql.xml:1014 #, no-c-format msgid "Components" msgstr "" #. Tag: para -#: query_hql.xml:1016 #, no-c-format msgid "Components can be used similarly to the simple value types that are used in HQL queries. They can appear in the <literal>select</literal> clause as follows:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:1021 query_hql.xml:1067 -#, no-c-format -msgid "<![CDATA[select p.name from Person p]]>" -msgstr "" - -#. Tag: programlisting -#: query_hql.xml:1022 -#, no-c-format -msgid "<![CDATA[select p.name.first from Person p]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:1024 #, no-c-format msgid "where the Person's name property is a component. Components can also be used in the <literal>where</literal> clause:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:1029 -#, no-c-format -msgid "<![CDATA[from Person p where p.name = :name]]>" -msgstr "" - -#. Tag: programlisting -#: query_hql.xml:1030 -#, no-c-format -msgid "<![CDATA[from Person p where p.name.first = :firstName]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:1032 #, no-c-format msgid "Components can also be used in the <literal>order by</literal> clause:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:1036 -#, no-c-format -msgid "<![CDATA[from Person p order by p.name]]>" -msgstr "" - -#. Tag: programlisting -#: query_hql.xml:1037 -#, no-c-format -msgid "<![CDATA[from Person p order by p.name.first]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:1039 #, no-c-format -msgid "Another common use of components is in <link linkend=\"queryhql-tuple\">row value constructors</link>." +msgid "Another common use of components is in row value constructors (<xref linkend=\"queryhql-tuple\" />)." msgstr "" #. Tag: title -#: query_hql.xml:1045 #, no-c-format msgid "Row value constructor syntax" msgstr "" #. Tag: para -#: query_hql.xml:1047 #, no-c-format msgid "HQL supports the use of ANSI SQL <literal>row value constructor</literal> syntax, sometimes referred to AS <literal>tuple</literal> syntax, even though the underlying database may not support that notion. Here, we are generally referring to multi-valued comparisons, typically associated with components. Consider an entity Person which defines a name component:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:1054 -#, no-c-format -msgid "<![CDATA[from Person p where p.name.first='John' and p.name.last='Jingleheimer-Schmidt']]>" -msgstr "" - #. Tag: para -#: query_hql.xml:1056 #, no-c-format msgid "That is valid syntax although it is a little verbose. You can make this more concise by using <literal>row value constructor</literal> syntax:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:1061 -#, no-c-format -msgid "<![CDATA[from Person p where p.name=('John', 'Jingleheimer-Schmidt')]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:1063 #, no-c-format msgid "It can also be useful to specify this in the <literal>select</literal> clause:" msgstr "" #. Tag: para -#: query_hql.xml:1069 #, no-c-format msgid "Using <literal>row value constructor</literal> syntax can also be beneficial when using subqueries that need to compare against multiple values:" msgstr "" -#. Tag: programlisting -#: query_hql.xml:1074 -#, no-c-format -msgid "" - "<![CDATA[from Cat as cat\n" - "where not ( cat.name, cat.color ) in (\n" - " select cat.name, cat.color from DomesticCat cat\n" - ")]]>" -msgstr "" - #. Tag: para -#: query_hql.xml:1076 #, no-c-format msgid "One thing to consider when deciding if you want to use this syntax, is that the query will be dependent upon the ordering of the component sub-properties in the metadata." msgstr "" Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/query_sql.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/query_sql.pot 2010-02-08 04:50:03 UTC (rev 18716) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/query_sql.pot 2010-02-08 04:56:55 UTC (rev 18717) @@ -1,1112 +1,589 @@ -# SOME DESCRIPTIVE TITLE. -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. # -#, fuzzy msgid "" msgstr "" -"Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-10 21:02+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:19\n" +"PO-Revision-Date: 2010-01-08T04:07:19\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" "MIME-Version: 1.0\n" -"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Type: application/x-publican; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. Tag: title -#: query_sql.xml:29 #, no-c-format msgid "Native SQL" msgstr "" #. Tag: para -#: query_sql.xml:31 #, no-c-format msgid "You can also express queries in the native SQL dialect of your database. This is useful if you want to utilize database-specific features such as query hints or the <literal>CONNECT</literal> keyword in Oracle. It also provides a clean migration path from a direct SQL/JDBC based application to Hibernate." msgstr "" #. Tag: para -#: query_sql.xml:37 #, no-c-format msgid "Hibernate3 allows you to specify handwritten SQL, including stored procedures, for all create, update, delete, and load operations." msgstr "" #. Tag: title -#: query_sql.xml:41 #, no-c-format msgid "Using a <literal>SQLQuery</literal>" msgstr "" #. Tag: para -#: query_sql.xml:43 #, no-c-format msgid "Execution of native SQL queries is controlled via the <literal>SQLQuery</literal> interface, which is obtained by calling <literal>Session.createSQLQuery()</literal>. The following sections describe how to use this API for querying." msgstr "" #. Tag: title -#: query_sql.xml:49 #, no-c-format msgid "Scalar queries" msgstr "" #. Tag: para -#: query_sql.xml:51 #, no-c-format msgid "The most basic SQL query is to get a list of scalars (values)." msgstr "" -#. Tag: programlisting -#: query_sql.xml:54 -#, no-c-format -msgid "" - "<![CDATA[sess.createSQLQuery(\"SELECT * FROM CATS\").list();\n" - "sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE FROM CATS\").list();\n" - "]]>" -msgstr "" - #. Tag: para -#: query_sql.xml:56 #, no-c-format msgid "These will return a List of Object arrays (Object[]) with scalar values for each column in the CATS table. Hibernate will use ResultSetMetadata to deduce the actual order and types of the returned scalar values." msgstr "" #. Tag: para -#: query_sql.xml:61 #, no-c-format msgid "To avoid the overhead of using <literal>ResultSetMetadata</literal>, or simply to be more explicit in what is returned, one can use <literal>addScalar()</literal>:" msgstr "" -#. Tag: programlisting -#: query_sql.xml:65 -#, no-c-format -msgid "" - "<![CDATA[sess.createSQLQuery(\"SELECT * FROM CATS\")\n" - " .addScalar(\"ID\", Hibernate.LONG)\n" - " .addScalar(\"NAME\", Hibernate.STRING)\n" - " .addScalar(\"BIRTHDATE\", Hibernate.DATE)\n" - "]]>" -msgstr "" - #. Tag: para -#: query_sql.xml:67 query_sql.xml:113 query_sql.xml:198 query_sql.xml:349 #, no-c-format msgid "This query specified:" msgstr "" #. Tag: para -#: query_sql.xml:71 query_sql.xml:117 query_sql.xml:353 #, no-c-format msgid "the SQL query string" msgstr "" #. Tag: para -#: query_sql.xml:75 #, no-c-format msgid "the columns and types to return" msgstr "" #. Tag: para -#: query_sql.xml:79 #, no-c-format msgid "This will return Object arrays, but now it will not use <literal>ResultSetMetadata</literal> but will instead explicitly get the ID, NAME and BIRTHDATE column as respectively a Long, String and a Short from the underlying resultset. This also means that only these three columns will be returned, even though the query is using <literal>*</literal> and could return more than the three listed columns." msgstr "" #. Tag: para -#: query_sql.xml:87 #, no-c-format msgid "It is possible to leave out the type information for all or some of the scalars." msgstr "" -#. Tag: programlisting -#: query_sql.xml:90 -#, no-c-format -msgid "" - "<![CDATA[sess.createSQLQuery(\"SELECT * FROM CATS\")\n" - " .addScalar(\"ID\", Hibernate.LONG)\n" - " .addScalar(\"NAME\")\n" - " .addScalar(\"BIRTHDATE\")\n" - "]]>" -msgstr "" - #. Tag: para -#: query_sql.xml:92 #, no-c-format msgid "This is essentially the same query as before, but now <literal>ResultSetMetaData</literal> is used to determine the type of NAME and BIRTHDATE, where as the type of ID is explicitly specified." msgstr "" #. Tag: para -#: query_sql.xml:96 #, no-c-format msgid "How the java.sql.Types returned from ResultSetMetaData is mapped to Hibernate types is controlled by the Dialect. If a specific type is not mapped, or does not result in the expected type, it is possible to customize it via calls to <literal>registerHibernateType</literal> in the Dialect." msgstr "" #. Tag: title -#: query_sql.xml:104 #, no-c-format msgid "Entity queries" msgstr "" #. Tag: para -#: query_sql.xml:106 #, no-c-format msgid "The above queries were all about returning scalar values, basically returning the \"raw\" values from the resultset. The following shows how to get entity objects from a native sql query via <literal>addEntity()</literal>." msgstr "" -#. Tag: programlisting -#: query_sql.xml:111 -#, no-c-format -msgid "" - "<![CDATA[sess.createSQLQuery(\"SELECT * FROM CATS\").addEntity(Cat.class);\n" - "sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE FROM CATS\").addEntity(Cat.class);\n" - "]]>" -msgstr "" - #. Tag: para -#: query_sql.xml:121 #, no-c-format msgid "the entity returned by the query" msgstr "" #. Tag: para -#: query_sql.xml:125 #, no-c-format msgid "Assuming that Cat is mapped as a class with the columns ID, NAME and BIRTHDATE the above queries will both return a List where each element is a Cat entity." msgstr "" #. Tag: para -#: query_sql.xml:129 #, no-c-format msgid "If the entity is mapped with a <literal>many-to-one</literal> to another entity it is required to also return this when performing the native query, otherwise a database specific \"column not found\" error will occur. The additional columns will automatically be returned when using the * notation, but we prefer to be explicit as in the following example for a <literal>many-to-one</literal> to a <literal>Dog</literal>:" msgstr "" -#. Tag: programlisting -#: query_sql.xml:137 -#, no-c-format -msgid "" - "<![CDATA[sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE, DOG_ID FROM CATS\").addEntity(Cat.class);\n" - "]]>" -msgstr "" - #. Tag: para -#: query_sql.xml:139 #, no-c-format msgid "This will allow cat.getDog() to function properly." msgstr "" #. Tag: title -#: query_sql.xml:143 #, no-c-format msgid "Handling associations and collections" msgstr "" #. Tag: para -#: query_sql.xml:145 #, no-c-format msgid "It is possible to eagerly join in the <literal>Dog</literal> to avoid the possible extra roundtrip for initializing the proxy. This is done via the <literal>addJoin()</literal> method, which allows you to join in an association or collection." msgstr "" -#. Tag: programlisting -#: query_sql.xml:150 -#, no-c-format -msgid "" - "<![CDATA[sess.createSQLQuery(\"SELECT c.ID, NAME, BIRTHDATE, DOG_ID, D_ID, D_NAME FROM CATS c, DOGS d WHERE c.DOG_ID = d.D_ID\")\n" - " .addEntity(\"cat\", Cat.class)\n" - " .addJoin(\"cat.dog\");\n" - "]]>" -msgstr "" - #. Tag: para -#: query_sql.xml:152 #, no-c-format msgid "In this example, the returned <literal>Cat</literal>'s will have their <literal>dog</literal> property fully initialized without any extra roundtrip to the database. Notice that you added an alias name (\"cat\") to be able to specify the target property path of the join. It is possible to do the same eager joining for collections, e.g. if the <literal>Cat</literal> had a one-to-many to <literal>Dog</literal> instead." msgstr "" -#. Tag: programlisting -#: query_sql.xml:160 -#, no-c-format -msgid "" - "<![CDATA[sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE, D_ID, D_NAME, CAT_ID FROM CATS c, DOGS d WHERE c.ID = d.CAT_ID\")\n" - " .addEntity(\"cat\", Cat.class)\n" - " .addJoin(\"cat.dogs\");\n" - "]]>" -msgstr "" - #. Tag: para -#: query_sql.xml:162 #, no-c-format msgid "At this stage you are reaching the limits of what is possible with native queries, without starting to enhance the sql queries to make them usable in Hibernate. Problems can arise when returning multiple entities of the same type or when the default alias/column names are not enough." msgstr "" #. Tag: title -#: query_sql.xml:170 #, no-c-format msgid "Returning multiple entities" msgstr "" #. Tag: para -#: query_sql.xml:172 #, no-c-format msgid "Until now, the result set column names are assumed to be the same as the column names specified in the mapping document. This can be problematic for SQL queries that join multiple tables, since the same column names can appear in more than one table." msgstr "" #. Tag: para -#: query_sql.xml:177 #, no-c-format msgid "Column alias injection is needed in the following query (which most likely will fail):" msgstr "" -#. Tag: programlisting -#: query_sql.xml:180 -#, no-c-format -msgid "" - "<![CDATA[sess.createSQLQuery(\"SELECT c.*, m.* FROM CATS c, CATS m WHERE c.MOTHER_ID = c.ID\")\n" - " .addEntity(\"cat\", Cat.class)\n" - " .addEntity(\"mother\", Cat.class)\n" - "]]>" -msgstr "" - #. Tag: para -#: query_sql.xml:184 #, no-c-format msgid "The query was intended to return two Cat instances per row: a cat and its mother. The query will, however, fail because there is a conflict of names; the instances are mapped to the same column names. Also, on some databases the returned column aliases will most likely be on the form \"c.ID\", \"c.NAME\", etc. which are not equal to the columns specified in the mappings (\"ID\" and \"NAME\")." msgstr "" #. Tag: para -#: query_sql.xml:193 #, no-c-format msgid "The following form is not vulnerable to column name duplication:" msgstr "" -#. Tag: programlisting -#: query_sql.xml:196 -#, no-c-format -msgid "" - "<![CDATA[sess.createSQLQuery(\"SELECT {cat.*}, {mother.*} FROM CATS c, CATS m WHERE c.MOTHER_ID = c.ID\")\n" - " .addEntity(\"cat\", Cat.class)\n" - " .addEntity(\"mother\", Cat.class)\n" - "]]>" -msgstr "" - #. Tag: para -#: query_sql.xml:202 #, no-c-format msgid "the SQL query string, with placeholders for Hibernate to inject column aliases" msgstr "" #. Tag: para -#: query_sql.xml:207 #, no-c-format msgid "the entities returned by the query" msgstr "" #. Tag: para -#: query_sql.xml:211 #, no-c-format msgid "The {cat.*} and {mother.*} notation used above is a shorthand for \"all properties\". Alternatively, you can list the columns explicitly, but even in this case Hibernate injects the SQL column aliases for each property. The placeholder for a column alias is just the property name qualified by the table alias. In the following example, you retrieve Cats and their mothers from a different table (cat_log) to the one declared in the mapping metadata. You can even use the property aliases in the where clause." msgstr "" -#. Tag: programlisting -#: query_sql.xml:220 -#, no-c-format -msgid "" - "<![CDATA[String sql = \"SELECT ID as {c.id}, NAME as {c.name}, \" + \n" - " \"BIRTHDATE as {c.birthDate}, MOTHER_ID as {c.mother}, {mother.*} \" +\n" - " \"FROM CAT_LOG c, CAT_LOG m WHERE {c.mother} = c.ID\";\n" - "\n" - "List loggedCats = sess.createSQLQuery(sql)\n" - " .addEntity(\"cat\", Cat.class)\n" - " .addEntity(\"mother\", Cat.class).list()\n" - "]]>" -msgstr "" - #. Tag: title -#: query_sql.xml:223 #, no-c-format msgid "Alias and property references" msgstr "" #. Tag: para -#: query_sql.xml:225 #, no-c-format msgid "In most cases the above alias injection is needed. For queries relating to more complex mappings, like composite properties, inheritance discriminators, collections etc., you can use specific aliases that allow Hibernate to inject the proper aliases." msgstr "" #. Tag: para -#: query_sql.xml:230 #, no-c-format msgid "The following table shows the different ways you can use the alias injection. Please note that the alias names in the result are simply examples; each alias will have a unique and probably different name when used." msgstr "" #. Tag: title -#: query_sql.xml:236 #, no-c-format msgid "Alias injection names" msgstr "" #. Tag: entry -#: query_sql.xml:247 #, no-c-format msgid "Description" msgstr "" #. Tag: entry -#: query_sql.xml:249 #, no-c-format msgid "Syntax" msgstr "" #. Tag: entry -#: query_sql.xml:251 #, no-c-format msgid "Example" msgstr "" #. Tag: entry -#: query_sql.xml:257 #, no-c-format msgid "A simple property" msgstr "" -#. Tag: literal -#: query_sql.xml:259 +#. Tag: entry #, no-c-format -msgid "{[aliasname].[propertyname]" +msgid "<literal>{[aliasname].[propertyname]</literal>" msgstr "" -#. Tag: literal -#: query_sql.xml:261 +#. Tag: entry #, no-c-format -msgid "A_NAME as {item.name}" +msgid "<literal>A_NAME as {item.name}</literal>" msgstr "" #. Tag: entry -#: query_sql.xml:265 #, no-c-format msgid "A composite property" msgstr "" -#. Tag: literal -#: query_sql.xml:267 +#. Tag: entry #, no-c-format -msgid "{[aliasname].[componentname].[propertyname]}" +msgid "<literal>{[aliasname].[componentname].[propertyname]}</literal>" msgstr "" -#. Tag: literal -#: query_sql.xml:269 +#. Tag: entry #, no-c-format -msgid "CURRENCY as {item.amount.currency}, VALUE as {item.amount.value}" +msgid "<literal>CURRENCY as {item.amount.currency}, VALUE as {item.amount.value}</literal>" msgstr "" #. Tag: entry -#: query_sql.xml:274 #, no-c-format msgid "Discriminator of an entity" msgstr "" -#. Tag: literal -#: query_sql.xml:276 +#. Tag: entry #, no-c-format -msgid "{[aliasname].class}" +msgid "<literal>{[aliasname].class}</literal>" msgstr "" -#. Tag: literal -#: query_sql.xml:278 +#. Tag: entry #, no-c-format -msgid "DISC as {item.class}" +msgid "<literal>DISC as {item.class}</literal>" msgstr "" #. Tag: entry -#: query_sql.xml:282 #, no-c-format msgid "All properties of an entity" msgstr "" -#. Tag: literal -#: query_sql.xml:284 query_sql.xml:332 +#. Tag: entry #, no-c-format -msgid "{[aliasname].*}" +msgid "<literal>{[aliasname].*}</literal>" msgstr "" -#. Tag: literal -#: query_sql.xml:286 +#. Tag: entry #, no-c-format -msgid "{item.*}" +msgid "<literal>{item.*}</literal>" msgstr "" #. Tag: entry -#: query_sql.xml:290 #, no-c-format msgid "A collection key" msgstr "" -#. Tag: literal -#: query_sql.xml:292 +#. Tag: entry #, no-c-format -msgid "{[aliasname].key}" +msgid "<literal>{[aliasname].key}</literal>" msgstr "" -#. Tag: literal -#: query_sql.xml:294 +#. Tag: entry #, no-c-format -msgid "ORGID as {coll.key}" +msgid "<literal>ORGID as {coll.key}</literal>" msgstr "" #. Tag: entry -#: query_sql.xml:298 #, no-c-format msgid "The id of an collection" msgstr "" -#. Tag: literal -#: query_sql.xml:300 +#. Tag: entry #, no-c-format -msgid "{[aliasname].id}" +msgid "<literal>{[aliasname].id}</literal>" msgstr "" -#. Tag: literal -#: query_sql.xml:302 +#. Tag: entry #, no-c-format -msgid "EMPID as {coll.id}" +msgid "<literal>EMPID as {coll.id}</literal>" msgstr "" #. Tag: entry -#: query_sql.xml:306 #, no-c-format msgid "The element of an collection" msgstr "" -#. Tag: literal -#: query_sql.xml:308 +#. Tag: entry #, no-c-format -msgid "{[aliasname].element}" +msgid "<literal>{[aliasname].element}</literal>" msgstr "" -#. Tag: literal -#: query_sql.xml:310 +#. Tag: entry #, no-c-format -msgid "XID as {coll.element}" +msgid "<literal>XID as {coll.element}</literal>" msgstr "" #. Tag: entry -#: query_sql.xml:314 #, no-c-format msgid "property of the element in the collection" msgstr "" -#. Tag: literal -#: query_sql.xml:316 +#. Tag: entry #, no-c-format -msgid "{[aliasname].element.[propertyname]}" +msgid "<literal>{[aliasname].element.[propertyname]}</literal>" msgstr "" -#. Tag: literal -#: query_sql.xml:318 +#. Tag: entry #, no-c-format -msgid "NAME as {coll.element.name}" +msgid "<literal>NAME as {coll.element.name}</literal>" msgstr "" #. Tag: entry -#: query_sql.xml:322 #, no-c-format msgid "All properties of the element in the collection" msgstr "" -#. Tag: literal -#: query_sql.xml:324 +#. Tag: entry #, no-c-format -msgid "{[aliasname].element.*}" +msgid "<literal>{[aliasname].element.*}</literal>" msgstr "" -#. Tag: literal -#: query_sql.xml:326 +#. Tag: entry #, no-c-format -msgid "{coll.element.*}" +msgid "<literal>{coll.element.*}</literal>" msgstr "" #. Tag: entry -#: query_sql.xml:330 #, no-c-format msgid "All properties of the the collection" msgstr "" -#. Tag: literal -#: query_sql.xml:334 +#. Tag: entry #, no-c-format -msgid "{coll.*}" +msgid "<literal>{coll.*}</literal>" msgstr "" #. Tag: title -#: query_sql.xml:343 #, no-c-format msgid "Returning non-managed entities" msgstr "" #. Tag: para -#: query_sql.xml:345 #, no-c-format msgid "It is possible to apply a ResultTransformer to native SQL queries, allowing it to return non-managed entities." msgstr "" -#. Tag: programlisting -#: query_sql.xml:347 -#, no-c-format -msgid "" - "<![CDATA[sess.createSQLQuery(\"SELECT NAME, BIRTHDATE FROM CATS\")\n" - " .setResultTransformer(Transformers.aliasToBean(CatDTO.class))]]>" -msgstr "" - #. Tag: para -#: query_sql.xml:357 #, no-c-format msgid "a result transformer" msgstr "" #. Tag: para -#: query_sql.xml:361 #, no-c-format msgid "The above query will return a list of <literal>CatDTO</literal> which has been instantiated and injected the values of NAME and BIRTHNAME into its corresponding properties or fields." msgstr "" #. Tag: title -#: query_sql.xml:368 #, no-c-format msgid "Handling inheritance" msgstr "" #. Tag: para -#: query_sql.xml:370 #, no-c-format msgid "Native SQL queries which query for entities that are mapped as part of an inheritance must include all properties for the baseclass and all its subclasses." msgstr "" #. Tag: title -#: query_sql.xml:376 #, no-c-format msgid "Parameters" msgstr "" #. Tag: para -#: query_sql.xml:378 #, no-c-format msgid "Native SQL queries support positional as well as named parameters:" msgstr "" -#. Tag: programlisting -#: query_sql.xml:381 -#, no-c-format -msgid "" - "<![CDATA[Query query = sess.createSQLQuery(\"SELECT * FROM CATS WHERE NAME like ?\").addEntity(Cat.class);\n" - "List pusList = query.setString(0, \"Pus%\").list();\n" - " \n" - "query = sess.createSQLQuery(\"SELECT * FROM CATS WHERE NAME like :name\").addEntity(Cat.class);\n" - "List pusList = query.setString(\"name\", \"Pus%\").list(); ]]>" -msgstr "" - #. Tag: title -#: query_sql.xml:389 #, no-c-format msgid "Named SQL queries" msgstr "" #. Tag: para -#: query_sql.xml:391 #, no-c-format msgid "Named SQL queries can be defined in the mapping document and called in exactly the same way as a named HQL query. In this case, you do <emphasis>not</emphasis> need to call <literal>addEntity()</literal>." msgstr "" -#. Tag: programlisting -#: query_sql.xml:396 -#, no-c-format -msgid "" - "<![CDATA[<sql-query name=\"persons\">\n" - " <return alias=\"person\" class=\"eg.Person\"/>\n" - " SELECT person.NAME AS {person.name},\n" - " person.AGE AS {person.age},\n" - " person.SEX AS {person.sex}\n" - " FROM PERSON person\n" - " WHERE person.NAME LIKE :namePattern\n" - "</sql-query>]]>" -msgstr "" - -#. Tag: programlisting -#: query_sql.xml:398 -#, no-c-format -msgid "" - "<![CDATA[List people = sess.getNamedQuery(\"persons\")\n" - " .setString(\"namePattern\", namePattern)\n" - " .setMaxResults(50)\n" - " .list();]]>" -msgstr "" - #. Tag: para -#: query_sql.xml:400 #, no-c-format msgid "The <literal><return-join></literal> element is use to join associations and the <literal><load-collection></literal> element is used to define queries which initialize collections," msgstr "" -#. Tag: programlisting -#: query_sql.xml:404 -#, no-c-format -msgid "" - "<![CDATA[<sql-query name=\"personsWith\">\n" - " <return alias=\"person\" class=\"eg.Person\"/>\n" - " <return-join alias=\"address\" property=\"person.mailingAddress\"/>\n" - " SELECT person.NAME AS {person.name},\n" - " person.AGE AS {person.age},\n" - " person.SEX AS {person.sex},\n" - " address.STREET AS {address.street},\n" - " address.CITY AS {address.city},\n" - " address.STATE AS {address.state},\n" - " address.ZIP AS {address.zip}\n" - " FROM PERSON person\n" - " JOIN ADDRESS address\n" - " ON person.ID = address.PERSON_ID AND address.TYPE='MAILING'\n" - " WHERE person.NAME LIKE :namePattern\n" - "</sql-query>]]>" -msgstr "" - #. Tag: para -#: query_sql.xml:406 #, no-c-format msgid "A named SQL query may return a scalar value. You must declare the column alias and Hibernate type using the <literal><return-scalar></literal> element:" msgstr "" -#. Tag: programlisting -#: query_sql.xml:410 -#, no-c-format -msgid "" - "<![CDATA[<sql-query name=\"mySqlQuery\">\n" - " <return-scalar column=\"name\" type=\"string\"/>\n" - " <return-scalar column=\"age\" type=\"long\"/>\n" - " SELECT p.NAME AS name,\n" - " p.AGE AS age,\n" - " FROM PERSON p WHERE p.NAME LIKE 'Hiber%'\n" - "</sql-query>]]>" -msgstr "" - #. Tag: para -#: query_sql.xml:412 #, no-c-format msgid "You can externalize the resultset mapping information in a <literal><resultset></literal> element which will allow you to either reuse them across several named queries or through the <literal>setResultSetMapping()</literal> API." msgstr "" -#. Tag: programlisting -#: query_sql.xml:417 -#, no-c-format -msgid "" - "<![CDATA[<resultset name=\"personAddress\">\n" - " <return alias=\"person\" class=\"eg.Person\"/>\n" - " <return-join alias=\"address\" property=\"person.mailingAddress\"/>\n" - "</resultset>\n" - "\n" - "<sql-query name=\"personsWith\" resultset-ref=\"personAddress\">\n" - " SELECT person.NAME AS {person.name},\n" - " person.AGE AS {person.age},\n" - " person.SEX AS {person.sex},\n" - " address.STREET AS {address.street},\n" - " address.CITY AS {address.city},\n" - " address.STATE AS {address.state},\n" - " address.ZIP AS {address.zip}\n" - " FROM PERSON person\n" - " JOIN ADDRESS address\n" - " ON person.ID = address.PERSON_ID AND address.TYPE='MAILING'\n" - " WHERE person.NAME LIKE :namePattern\n" - "</sql-query>]]>" -msgstr "" - #. Tag: para -#: query_sql.xml:419 #, no-c-format msgid "You can, alternatively, use the resultset mapping information in your hbm files directly in java code." msgstr "" -#. Tag: programlisting -#: query_sql.xml:422 -#, no-c-format -msgid "" - "<![CDATA[List cats = sess.createSQLQuery(\n" - " \"select {cat.*}, {kitten.*} from cats cat, cats kitten where kitten.mother = cat.id\"\n" - " )\n" - " .setResultSetMapping(\"catAndKitten\")\n" - " .list();]]>" -msgstr "" - #. Tag: title -#: query_sql.xml:425 #, no-c-format msgid "Using return-property to explicitly specify column/alias names" msgstr "" #. Tag: para -#: query_sql.xml:428 #, no-c-format msgid "You can explicitly tell Hibernate what column aliases to use with <literal><return-property></literal>, instead of using the <literal>{}</literal>-syntax to let Hibernate inject its own aliases.For example:" msgstr "" -#. Tag: programlisting -#: query_sql.xml:433 -#, no-c-format -msgid "" - "<![CDATA[<sql-query name=\"mySqlQuery\">\n" - " <return alias=\"person\" class=\"eg.Person\">\n" - " <return-property name=\"name\" column=\"myName\"/>\n" - " <return-property name=\"age\" column=\"myAge\"/>\n" - " <return-property name=\"sex\" column=\"mySex\"/>\n" - " </return>\n" - " SELECT person.NAME AS myName,\n" - " person.AGE AS myAge,\n" - " person.SEX AS mySex,\n" - " FROM PERSON person WHERE person.NAME LIKE :name\n" - "</sql-query>\n" - "]]>" -msgstr "" - #. Tag: para -#: query_sql.xml:435 #, no-c-format msgid "<literal><return-property></literal> also works with multiple columns. This solves a limitation with the <literal>{}</literal>-syntax which cannot allow fine grained control of multi-column properties." msgstr "" -#. Tag: programlisting -#: query_sql.xml:440 -#, no-c-format -msgid "" - "<![CDATA[<sql-query name=\"organizationCurrentEmployments\">\n" - " <return alias=\"emp\" class=\"Employment\">\n" - " <return-property name=\"salary\">\n" - " <return-column name=\"VALUE\"/>\n" - " <return-column name=\"CURRENCY\"/>\n" - " </return-property>\n" - " <return-property name=\"endDate\" column=\"myEndDate\"/>\n" - " </return>\n" - " SELECT EMPLOYEE AS {emp.employee}, EMPLOYER AS {emp.employer},\n" - " STARTDATE AS {emp.startDate}, ENDDATE AS {emp.endDate},\n" - " REGIONCODE as {emp.regionCode}, EID AS {emp.id}, VALUE, CURRENCY\n" - " FROM EMPLOYMENT\n" - " WHERE EMPLOYER = :id AND ENDDATE IS NULL\n" - " ORDER BY STARTDATE ASC\n" - "</sql-query>]]>" -msgstr "" - #. Tag: para -#: query_sql.xml:442 #, no-c-format msgid "In this example <literal><return-property></literal> was used in combination with the <literal>{}</literal>-syntax for injection. This allows users to choose how they want to refer column and properties." msgstr "" #. Tag: para -#: query_sql.xml:447 #, no-c-format msgid "If your mapping has a discriminator you must use <literal><return-discriminator></literal> to specify the discriminator column." msgstr "" #. Tag: title -#: query_sql.xml:453 #, no-c-format msgid "Using stored procedures for querying" msgstr "" #. Tag: para -#: query_sql.xml:455 #, no-c-format msgid "Hibernate3 provides support for queries via stored procedures and functions. Most of the following documentation is equivalent for both. The stored procedure/function must return a resultset as the first out-parameter to be able to work with Hibernate. An example of such a stored function in Oracle 9 and higher is as follows:" msgstr "" -#. Tag: programlisting -#: query_sql.xml:461 -#, no-c-format -msgid "" - "<![CDATA[CREATE OR REPLACE FUNCTION selectAllEmployments\n" - " RETURN SYS_REFCURSOR\n" - "AS\n" - " st_cursor SYS_REFCURSOR;\n" - "BEGIN\n" - " OPEN st_cursor FOR\n" - " SELECT EMPLOYEE, EMPLOYER,\n" - " STARTDATE, ENDDATE,\n" - " REGIONCODE, EID, VALUE, CURRENCY\n" - " FROM EMPLOYMENT;\n" - " RETURN st_cursor;\n" - " END;]]>" -msgstr "" - #. Tag: para -#: query_sql.xml:463 #, no-c-format msgid "To use this query in Hibernate you need to map it via a named query." msgstr "" -#. Tag: programlisting -#: query_sql.xml:466 -#, no-c-format -msgid "" - "<![CDATA[<sql-query name=\"selectAllEmployees_SP\" callable=\"true\">\n" - " <return alias=\"emp\" class=\"Employment\">\n" - " <return-property name=\"employee\" column=\"EMPLOYEE\"/>\n" - " <return-property name=\"employer\" column=\"EMPLOYER\"/>\n" - " <return-property name=\"startDate\" column=\"STARTDATE\"/>\n" - " <return-property name=\"endDate\" column=\"ENDDATE\"/>\n" - " <return-property name=\"regionCode\" column=\"REGIONCODE\"/>\n" - " <return-property name=\"id\" column=\"EID\"/>\n" - " <return-property name=\"salary\">\n" - " <return-column name=\"VALUE\"/>\n" - " <return-column name=\"CURRENCY\"/>\n" - " </return-property>\n" - " </return>\n" - " { ? = call selectAllEmployments() }\n" - "</sql-query>]]>" -msgstr "" - #. Tag: para -#: query_sql.xml:468 #, no-c-format msgid "Stored procedures currently only return scalars and entities. <literal><return-join></literal> and <literal><load-collection></literal> are not supported." msgstr "" #. Tag: title -#: query_sql.xml:473 #, no-c-format msgid "Rules/limitations for using stored procedures" msgstr "" #. Tag: para -#: query_sql.xml:475 #, no-c-format msgid "You cannot use stored procedures with Hibernate unless you follow some procedure/function rules. If they do not follow those rules they are not usable with Hibernate. If you still want to use these procedures you have to execute them via <literal>session.connection()</literal>. The rules are different for each database, since database vendors have different stored procedure semantics/syntax." msgstr "" #. Tag: para -#: query_sql.xml:482 #, no-c-format msgid "Stored procedure queries cannot be paged with <literal>setFirstResult()/setMaxResults()</literal>." msgstr "" #. Tag: para -#: query_sql.xml:485 #, no-c-format msgid "The recommended call form is standard SQL92: <literal>{ ? = call functionName(<parameters>) }</literal> or <literal>{ ? = call procedureName(<parameters>}</literal>. Native call syntax is not supported." msgstr "" #. Tag: para -#: query_sql.xml:490 #, no-c-format msgid "For Oracle the following rules apply:" msgstr "" #. Tag: para -#: query_sql.xml:494 #, no-c-format msgid "A function must return a result set. The first parameter of a procedure must be an <literal>OUT</literal> that returns a result set. This is done by using a <literal>SYS_REFCURSOR</literal> type in Oracle 9 or 10. In Oracle you need to define a <literal>REF CURSOR</literal> type. See Oracle literature for further information." msgstr "" #. Tag: para -#: query_sql.xml:503 #, no-c-format msgid "For Sybase or MS SQL server the following rules apply:" msgstr "" #. Tag: para -#: query_sql.xml:507 #, no-c-format msgid "The procedure must return a result set. Note that since these servers can return multiple result sets and update counts, Hibernate will iterate the results and take the first result that is a result set as its return value. Everything else will be discarded." msgstr "" #. Tag: para -#: query_sql.xml:515 #, no-c-format msgid "If you can enable <literal>SET NOCOUNT ON</literal> in your procedure it will probably be more efficient, but this is not a requirement." msgstr "" #. Tag: title -#: query_sql.xml:525 #, no-c-format msgid "Custom SQL for create, update and delete" msgstr "" #. Tag: para -#: query_sql.xml:527 #, no-c-format msgid "Hibernate3 can use custom SQL statements for create, update, and delete operations. The class and collection persisters in Hibernate already contain a set of configuration time generated strings (insertsql, deletesql, updatesql etc.). The mapping tags <literal><sql-insert></literal>, <literal><sql-delete></literal>, and <literal><sql-update></literal> override these strings:" msgstr "" -#. Tag: programlisting -#: query_sql.xml:535 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\">\n" - " <generator class=\"increment\"/>\n" - " </id>\n" - " <property name=\"name\" not-null=\"true\"/>\n" - " <sql-insert>INSERT INTO PERSON (NAME, ID) VALUES ( UPPER(?), ? )</sql-insert>\n" - " <sql-update>UPDATE PERSON SET NAME=UPPER(?) WHERE ID=?</sql-update>\n" - " <sql-delete>DELETE FROM PERSON WHERE ID=?</sql-delete>\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: query_sql.xml:537 #, no-c-format msgid "The SQL is directly executed in your database, so you can use any dialect you like. This will reduce the portability of your mapping if you use database specific SQL." msgstr "" #. Tag: para -#: query_sql.xml:541 #, no-c-format msgid "Stored procedures are supported if the <literal>callable</literal> attribute is set:" msgstr "" -#. Tag: programlisting -#: query_sql.xml:544 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\">\n" - " <generator class=\"increment\"/>\n" - " </id>\n" - " <property name=\"name\" not-null=\"true\"/>\n" - " <sql-insert callable=\"true\">{call createPerson (?, ?)}</sql-insert>\n" - " <sql-delete callable=\"true\">{? = call deletePerson (?)}</sql-delete>\n" - " <sql-update callable=\"true\">{? = call updatePerson (?, ?)}</sql-update>\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: query_sql.xml:546 #, no-c-format msgid "The order of the positional parameters is vital, as they must be in the same sequence as Hibernate expects them." msgstr "" #. Tag: para -#: query_sql.xml:549 #, no-c-format msgid "You can view 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 view the expected sequence, do not include your custom SQL in the mapping files, as this will override the Hibernate generated static SQL." msgstr "" #. Tag: para -#: query_sql.xml:556 #, no-c-format msgid "The stored procedures are in most cases required to return the number of rows inserted, updated and deleted, as Hibernate has some runtime checks for the success of the statement. Hibernate always registers the first statement parameter as a numeric output parameter for the CUD operations:" msgstr "" -#. Tag: programlisting -#: query_sql.xml:562 -#, no-c-format -msgid "" - "<![CDATA[CREATE OR REPLACE FUNCTION updatePerson (uid IN NUMBER, uname IN VARCHAR2)\n" - " RETURN NUMBER IS\n" - "BEGIN\n" - "\n" - " update PERSON\n" - " set\n" - " NAME = uname,\n" - " where\n" - " ID = uid;\n" - "\n" - " return SQL%ROWCOUNT;\n" - "\n" - "END updatePerson;]]>" -msgstr "" - #. Tag: title -#: query_sql.xml:566 #, no-c-format msgid "Custom SQL for loading" msgstr "" #. Tag: para -#: query_sql.xml:568 #, no-c-format msgid "You can also declare your own SQL (or HQL) queries for entity loading:" msgstr "" -#. Tag: programlisting -#: query_sql.xml:571 -#, no-c-format -msgid "" - "<![CDATA[<sql-query name=\"person\">\n" - " <return alias=\"pers\" class=\"Person\" lock-mode=\"upgrade\"/>\n" - " SELECT NAME AS {pers.name}, ID AS {pers.id}\n" - " FROM PERSON\n" - " WHERE ID=?\n" - " FOR UPDATE\n" - "</sql-query>]]>" -msgstr "" - #. Tag: para -#: query_sql.xml:573 #, no-c-format msgid "This is just a named query declaration, as discussed earlier. You can reference this named query in a class mapping:" msgstr "" -#. Tag: programlisting -#: query_sql.xml:576 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\">\n" - " <generator class=\"increment\"/>\n" - " </id>\n" - " <property name=\"name\" not-null=\"true\"/>\n" - " <loader query-ref=\"person\"/>\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: query_sql.xml:578 #, no-c-format msgid "This even works with stored procedures." msgstr "" #. Tag: para -#: query_sql.xml:580 #, no-c-format msgid "You can even define a query for collection loading:" msgstr "" -#. Tag: programlisting -#: query_sql.xml:582 -#, no-c-format -msgid "" - "<![CDATA[<set name=\"employments\" inverse=\"true\">\n" - " <key/>\n" - " <one-to-many class=\"Employment\"/>\n" - " <loader query-ref=\"employments\"/>\n" - "</set>]]>" -msgstr "" - -#. Tag: programlisting -#: query_sql.xml:584 -#, no-c-format -msgid "" - "<![CDATA[<sql-query name=\"employments\">\n" - " <load-collection alias=\"emp\" role=\"Person.employments\"/>\n" - " SELECT {emp.*}\n" - " FROM EMPLOYMENT emp\n" - " WHERE EMPLOYER = :id\n" - " ORDER BY STARTDATE ASC, EMPLOYEE ASC\n" - "</sql-query>]]>" -msgstr "" - #. Tag: para -#: query_sql.xml:586 #, no-c-format msgid "You can also define an entity loader that loads a collection by join fetching:" msgstr "" -#. Tag: programlisting -#: query_sql.xml:589 -#, no-c-format -msgid "" - "<![CDATA[<sql-query name=\"person\">\n" - " <return alias=\"pers\" class=\"Person\"/>\n" - " <return-join alias=\"emp\" property=\"pers.employments\"/>\n" - " SELECT NAME AS {pers.*}, {emp.*}\n" - " FROM PERSON pers\n" - " LEFT OUTER JOIN EMPLOYMENT emp\n" - " ON pers.ID = emp.PERSON_ID\n" - " WHERE ID=?\n" - "</sql-query>]]>" -msgstr "" - Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/session_api.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/session_api.pot 2010-02-08 04:50:03 UTC (rev 18716) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/session_api.pot 2010-02-08 04:56:55 UTC (rev 18717) @@ -1,1354 +1,759 @@ -# SOME DESCRIPTIVE TITLE. -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. # -#, fuzzy msgid "" msgstr "" -"Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-10 21:02+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:19\n" +"PO-Revision-Date: 2010-01-08T04:07:19\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" "MIME-Version: 1.0\n" -"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Type: application/x-publican; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. Tag: title -#: session_api.xml:29 #, no-c-format msgid "Working with objects" msgstr "" #. Tag: para -#: session_api.xml:31 #, no-c-format msgid "Hibernate is a full object/relational mapping solution that not only shields the developer from the details of the underlying database management system, but also offers <emphasis>state management</emphasis> of objects. This is, contrary to the management of SQL <literal>statements</literal> in common JDBC/SQL persistence layers, a natural object-oriented view of persistence in Java applications." msgstr "" #. Tag: para -#: session_api.xml:40 #, no-c-format msgid "In other words, Hibernate application developers should always think about the <emphasis>state</emphasis> of their objects, and not necessarily about the execution of SQL statements. This part is taken care of by Hibernate and is only relevant for the application developer when tuning the performance of the system." msgstr "" #. Tag: title -#: session_api.xml:48 #, no-c-format msgid "Hibernate object states" msgstr "" #. Tag: para -#: session_api.xml:50 #, no-c-format msgid "Hibernate defines and supports the following object states:" msgstr "" #. Tag: para -#: session_api.xml:56 #, no-c-format msgid "<emphasis>Transient</emphasis> - an object is transient if it has just been instantiated using the <literal>new</literal> operator, and it is not associated with a Hibernate <literal>Session</literal>. It has no persistent representation in the database and no identifier value has been assigned. Transient instances will be destroyed by the garbage collector if the application does not hold a reference anymore. Use the Hibernate <literal>Session</literal> to make an object persistent (and let Hibernate take care of the SQL statements that need to be executed for this transition)." msgstr "" #. Tag: para -#: session_api.xml:68 #, no-c-format msgid "<emphasis>Persistent</emphasis> - a persistent instance has a representation in the database and an identifier value. It might just have been saved or loaded, however, it is by definition in the scope of a <literal>Session</literal>. Hibernate will detect any changes made to an object in persistent state and synchronize the state with the database when the unit of work completes. Developers do not execute manual <literal>UPDATE</literal> statements, or <literal>DELETE</literal> statements when an object should be made transient." msgstr "" #. Tag: para -#: session_api.xml:79 #, no-c-format msgid "<emphasis>Detached</emphasis> - a detached instance is an object that has been persistent, but its <literal>Session</literal> has been closed. The reference to the object is still valid, of course, and the detached instance might even be modified in this state. A detached instance can be reattached to a new <literal>Session</literal> at a later point in time, making it (and all the modifications) persistent again. This feature enables a programming model for long running units of work that require user think-time. We call them <emphasis>application transactions</emphasis>, i.e., a unit of work from the point of view of the user." msgstr "" #. Tag: para -#: session_api.xml:93 #, no-c-format msgid "We will now discuss the states and state transitions (and the Hibernate methods that trigger a transition) in more detail." msgstr "" #. Tag: title -#: session_api.xml:101 #, no-c-format msgid "Making objects persistent" msgstr "" #. Tag: para -#: session_api.xml:103 #, no-c-format msgid "Newly instantiated instances of a a persistent class are considered <emphasis>transient</emphasis> by Hibernate. We can make a transient instance <emphasis>persistent</emphasis> by associating it with a session:" msgstr "" -#. Tag: programlisting -#: session_api.xml:110 -#, no-c-format -msgid "" - "<![CDATA[DomesticCat fritz = new DomesticCat();\n" - "fritz.setColor(Color.GINGER);\n" - "fritz.setSex('M');\n" - "fritz.setName(\"Fritz\");\n" - "Long generatedId = (Long) sess.save(fritz);]]>" -msgstr "" - #. Tag: para -#: session_api.xml:112 #, no-c-format msgid "If <literal>Cat</literal> has a generated identifier, the identifier is generated and assigned to the <literal>cat</literal> when <literal>save()</literal> is called. If <literal>Cat</literal> has an <literal>assigned</literal> identifier, or a composite key, the identifier should be assigned to the <literal>cat</literal> instance before calling <literal>save()</literal>. You can also use <literal>persist()</literal> instead of <literal>save()</literal>, with the semantics defined in the EJB3 early draft." msgstr "" #. Tag: para -#: session_api.xml:124 #, no-c-format msgid "<literal>persist()</literal> makes a transient instance persistent. However, it does not guarantee that the identifier value will be assigned to the persistent instance immediately, the assignment might happen at flush time. <literal>persist()</literal> also guarantees that it will not execute an <literal>INSERT</literal> statement if it is called outside of transaction boundaries. This is useful in long-running conversations with an extended Session/persistence context." msgstr "" #. Tag: para -#: session_api.xml:135 #, no-c-format msgid "<literal>save()</literal> does guarantee to return an identifier. If an INSERT has to be executed to get the identifier ( e.g. \"identity\" generator, not \"sequence\"), this INSERT happens immediately, no matter if you are inside or outside of a transaction. This is problematic in a long-running conversation with an extended Session/persistence context." msgstr "" #. Tag: para -#: session_api.xml:145 #, no-c-format msgid "Alternatively, you can assign the identifier using an overloaded version of <literal>save()</literal>." msgstr "" -#. Tag: programlisting -#: session_api.xml:150 -#, no-c-format -msgid "" - "<![CDATA[DomesticCat pk = new DomesticCat();\n" - "pk.setColor(Color.TABBY);\n" - "pk.setSex('F');\n" - "pk.setName(\"PK\");\n" - "pk.setKittens( new HashSet() );\n" - "pk.addKitten(fritz);\n" - "sess.save( pk, new Long(1234) );]]>" -msgstr "" - #. Tag: para -#: session_api.xml:152 #, no-c-format msgid "If the object you make persistent has associated objects (e.g. the <literal>kittens</literal> collection in the previous example), these objects can be made persistent in any order you like unless you have a <literal>NOT NULL</literal> constraint upon a foreign key column. There is never a risk of violating foreign key constraints. However, you might violate a <literal>NOT NULL</literal> constraint if you <literal>save()</literal> the objects in the wrong order." msgstr "" #. Tag: para -#: session_api.xml:162 #, no-c-format msgid "Usually you do not bother with this detail, as you will normally use Hibernate's <emphasis>transitive persistence</emphasis> feature to save the associated objects automatically. Then, even <literal>NOT NULL</literal> constraint violations do not occur - Hibernate will take care of everything. Transitive persistence is discussed later in this chapter." msgstr "" #. Tag: title -#: session_api.xml:173 #, no-c-format msgid "Loading an object" msgstr "" #. Tag: para -#: session_api.xml:175 #, no-c-format msgid "The <literal>load()</literal> methods of <literal>Session</literal> provide a way of retrieving a persistent instance if you know its identifier. <literal>load()</literal> takes a class object and loads the state into a newly instantiated instance of that class in a persistent state." msgstr "" -#. Tag: programlisting -#: session_api.xml:182 -#, no-c-format -msgid "<![CDATA[Cat fritz = (Cat) sess.load(Cat.class, generatedId);]]>" -msgstr "" - -#. Tag: programlisting -#: session_api.xml:184 -#, no-c-format -msgid "" - "<![CDATA[// you need to wrap primitive identifiers\n" - "long id = 1234;\n" - "DomesticCat pk = (DomesticCat) sess.load( DomesticCat.class, new Long(id) );]]>" -msgstr "" - #. Tag: para -#: session_api.xml:186 #, no-c-format msgid "Alternatively, you can load state into a given instance:" msgstr "" -#. Tag: programlisting -#: session_api.xml:190 -#, no-c-format -msgid "" - "<![CDATA[Cat cat = new DomesticCat();\n" - "// load pk's state into cat\n" - "sess.load( cat, new Long(pkId) );\n" - "Set kittens = cat.getKittens();]]>" -msgstr "" - #. Tag: para -#: session_api.xml:192 #, no-c-format msgid "Be aware that <literal>load()</literal> will throw an unrecoverable exception if there is no matching database row. If the class is mapped with a proxy, <literal>load()</literal> just returns an uninitialized proxy and does not actually hit the database until you invoke a method of the proxy. This is useful if you wish to create an association to an object without actually loading it from the database. It also allows multiple instances to be loaded as a batch if <literal>batch-size</literal> is defined for the class mapping." msgstr "" #. Tag: para -#: session_api.xml:203 #, no-c-format msgid "If you are not certain that a matching row exists, you should use the <literal>get()</literal> method which hits the database immediately and returns null if there is no matching row." msgstr "" -#. Tag: programlisting -#: session_api.xml:209 -#, no-c-format -msgid "" - "<![CDATA[Cat cat = (Cat) sess.get(Cat.class, id);\n" - "if (cat==null) {\n" - " cat = new Cat();\n" - " sess.save(cat, id);\n" - "}\n" - "return cat;]]>" -msgstr "" - #. Tag: para -#: session_api.xml:211 #, no-c-format msgid "You can even load an object using an SQL <literal>SELECT ... FOR UPDATE</literal>, using a <literal>LockMode</literal>. See the API documentation for more information." msgstr "" -#. Tag: programlisting -#: session_api.xml:216 -#, no-c-format -msgid "<![CDATA[Cat cat = (Cat) sess.get(Cat.class, id, LockMode.UPGRADE);]]>" -msgstr "" - #. Tag: para -#: session_api.xml:218 #, no-c-format msgid "Any associated instances or contained collections will <emphasis>not</emphasis> be selected <literal>FOR UPDATE</literal>, unless you decide to specify <literal>lock</literal> or <literal>all</literal> as a cascade style for the association." msgstr "" #. Tag: para -#: session_api.xml:225 #, no-c-format msgid "It is possible to re-load an object and all its collections at any time, using the <literal>refresh()</literal> method. This is useful when database triggers are used to initialize some of the properties of the object." msgstr "" -#. Tag: programlisting -#: session_api.xml:231 -#, no-c-format -msgid "" - "<![CDATA[sess.save(cat);\n" - "sess.flush(); //force the SQL INSERT\n" - "sess.refresh(cat); //re-read the state (after the trigger executes)]]>" -msgstr "" - #. Tag: para -#: session_api.xml:233 #, no-c-format -msgid "How much does Hibernate load from the database and how many SQL <literal>SELECT</literal>s will it use? This depends on the <emphasis>fetching strategy</emphasis>. This is explained in <xref linkend=\"performance-fetching\"/>." +msgid "How much does Hibernate load from the database and how many SQL <literal>SELECT</literal>s will it use? This depends on the <emphasis>fetching strategy</emphasis>. This is explained in <xref linkend=\"performance-fetching\" />." msgstr "" #. Tag: title -#: session_api.xml:243 #, no-c-format msgid "Querying" msgstr "" #. Tag: para -#: session_api.xml:245 #, no-c-format msgid "If you do not know the identifiers of the objects you are looking for, you need a query. Hibernate supports an easy-to-use but powerful object oriented query language (HQL). For programmatic query creation, Hibernate supports a sophisticated Criteria and Example query feature (QBC and QBE). You can also express your query in the native SQL of your database, with optional support from Hibernate for result set conversion into objects." msgstr "" #. Tag: title -#: session_api.xml:255 #, no-c-format msgid "Executing queries" msgstr "" #. Tag: para -#: session_api.xml:257 #, no-c-format msgid "HQL and native SQL queries are represented with an instance of <literal>org.hibernate.Query</literal>. This interface offers methods for parameter binding, result set handling, and for the execution of the actual query. You always obtain a <literal>Query</literal> using the current <literal>Session</literal>:" msgstr "" -#. Tag: programlisting -#: session_api.xml:264 -#, no-c-format -msgid "" - "<![CDATA[List cats = session.createQuery(\n" - " \"from Cat as cat where cat.birthdate < ?\")\n" - " .setDate(0, date)\n" - " .list();\n" - "\n" - "List mothers = session.createQuery(\n" - " \"select mother from Cat as cat join cat.mother as mother where cat.name = ?\")\n" - " .setString(0, name)\n" - " .list();\n" - "\n" - "List kittens = session.createQuery(\n" - " \"from Cat as cat where cat.mother = ?\")\n" - " .setEntity(0, pk)\n" - " .list();\n" - "\n" - "Cat mother = (Cat) session.createQuery(\n" - " \"select cat.mother from Cat as cat where cat = ?\")\n" - " .setEntity(0, izi)\n" - " .uniqueResult();]]\n" - "\n" - "Query mothersWithKittens = (Cat) session.createQuery(\n" - " \"select mother from Cat as mother left join fetch mother.kittens\");\n" - "Set uniqueMothers = new HashSet(mothersWithKittens.list());]]>" -msgstr "" - #. Tag: para -#: session_api.xml:266 #, no-c-format msgid "A query is usually executed by invoking <literal>list()</literal>. The result of the query will be loaded completely into a collection in memory. Entity instances retrieved by a query are in a persistent state. The <literal>uniqueResult()</literal> method offers a shortcut if you know your query will only return a single object. Queries that make use of eager fetching of collections usually return duplicates of the root objects, but with their collections initialized. You can filter these duplicates through a <literal>Set</literal>." msgstr "" #. Tag: title -#: session_api.xml:278 #, no-c-format msgid "Iterating results" msgstr "" #. Tag: para -#: session_api.xml:280 #, no-c-format msgid "Occasionally, you might be able to achieve better performance by executing the query using the <literal>iterate()</literal> method. This will usually be the case if you expect that the actual entity instances returned by the query will already be in the session or second-level cache. If they are not already cached, <literal>iterate()</literal> will be slower than <literal>list()</literal> and might require many database hits for a simple query, usually <emphasis>1</emphasis> for the initial select which only returns identifiers, and <emphasis>n</emphasis> additional selects to initialize the actual instances." msgstr "" -#. Tag: programlisting -#: session_api.xml:292 -#, no-c-format -msgid "" - "<![CDATA[// fetch ids\n" - "Iterator iter = sess.createQuery(\"from eg.Qux q order by q.likeliness\").iterate();\n" - "while ( iter.hasNext() ) {\n" - " Qux qux = (Qux) iter.next(); // fetch the object\n" - " // something we couldnt express in the query\n" - " if ( qux.calculateComplicatedAlgorithm() ) {\n" - " // delete the current instance\n" - " iter.remove();\n" - " // dont need to process the rest\n" - " break;\n" - " }\n" - "}]]>" -msgstr "" - #. Tag: title -#: session_api.xml:296 #, no-c-format msgid "Queries that return tuples" msgstr "" #. Tag: para -#: session_api.xml:298 #, no-c-format msgid "Hibernate queries sometimes return tuples of objects. Each tuple is returned as an array:" msgstr "" -#. Tag: programlisting -#: session_api.xml:303 -#, no-c-format -msgid "" - "<![CDATA[Iterator kittensAndMothers = sess.createQuery(\n" - " \"select kitten, mother from Cat kitten join kitten.mother mother\")\n" - " .list()\n" - " .iterator();\n" - "\n" - "while ( kittensAndMothers.hasNext() ) {\n" - " Object[] tuple = (Object[]) kittensAndMothers.next();\n" - " Cat kitten = (Cat) tuple[0];\n" - " Cat mother = (Cat) tuple[1];\n" - " ....\n" - "}]]>" -msgstr "" - #. Tag: title -#: session_api.xml:308 #, no-c-format msgid "Scalar results" msgstr "" #. Tag: para -#: session_api.xml:310 #, no-c-format msgid "Queries can specify a property of a class in the <literal>select</literal> clause. They can even call SQL aggregate functions. Properties or aggregates are considered \"scalar\" results and not entities in persistent state." msgstr "" -#. Tag: programlisting -#: session_api.xml:316 -#, no-c-format -msgid "" - "<![CDATA[Iterator results = sess.createQuery(\n" - " \"select cat.color, min(cat.birthdate), count(cat) from Cat cat \" +\n" - " \"group by cat.color\")\n" - " .list()\n" - " .iterator();\n" - "\n" - "while ( results.hasNext() ) {\n" - " Object[] row = (Object[]) results.next();\n" - " Color type = (Color) row[0];\n" - " Date oldest = (Date) row[1];\n" - " Integer count = (Integer) row[2];\n" - " .....\n" - "}]]>" -msgstr "" - #. Tag: title -#: session_api.xml:321 #, no-c-format msgid "Bind parameters" msgstr "" #. Tag: para -#: session_api.xml:323 #, no-c-format msgid "Methods on <literal>Query</literal> are provided for binding values to named parameters or JDBC-style <literal>?</literal> parameters. <emphasis>Contrary to JDBC, Hibernate numbers parameters from zero.</emphasis> Named parameters are identifiers of the form <literal>:name</literal> in the query string. The advantages of named parameters are as follows:" msgstr "" #. Tag: para -#: session_api.xml:333 #, no-c-format msgid "named parameters are insensitive to the order they occur in the query string" msgstr "" #. Tag: para -#: session_api.xml:339 #, no-c-format msgid "they can occur multiple times in the same query" msgstr "" #. Tag: para -#: session_api.xml:344 #, no-c-format msgid "they are self-documenting" msgstr "" -#. Tag: programlisting -#: session_api.xml:350 -#, no-c-format -msgid "" - "<![CDATA[//named parameter (preferred)\n" - "Query q = sess.createQuery(\"from DomesticCat cat where cat.name = :name\");\n" - "q.setString(\"name\", \"Fritz\");\n" - "Iterator cats = q.iterate();]]>" -msgstr "" - -#. Tag: programlisting -#: session_api.xml:352 -#, no-c-format -msgid "" - "<![CDATA[//positional parameter\n" - "Query q = sess.createQuery(\"from DomesticCat cat where cat.name = ?\");\n" - "q.setString(0, \"Izi\");\n" - "Iterator cats = q.iterate();]]>" -msgstr "" - -#. Tag: programlisting -#: session_api.xml:354 -#, no-c-format -msgid "" - "<![CDATA[//named parameter list\n" - "List names = new ArrayList();\n" - "names.add(\"Izi\");\n" - "names.add(\"Fritz\");\n" - "Query q = sess.createQuery(\"from DomesticCat cat where cat.name in (:namesList)\");\n" - "q.setParameterList(\"namesList\", names);\n" - "List cats = q.list();]]>" -msgstr "" - #. Tag: title -#: session_api.xml:359 #, no-c-format msgid "Pagination" msgstr "" #. Tag: para -#: session_api.xml:361 #, no-c-format msgid "If you need to specify bounds upon your result set, that is, the maximum number of rows you want to retrieve and/or the first row you want to retrieve, you can use methods of the <literal>Query</literal> interface:" msgstr "" -#. Tag: programlisting -#: session_api.xml:367 -#, no-c-format -msgid "" - "<![CDATA[Query q = sess.createQuery(\"from DomesticCat cat\");\n" - "q.setFirstResult(20);\n" - "q.setMaxResults(10);\n" - "List cats = q.list();]]>" -msgstr "" - #. Tag: para -#: session_api.xml:369 #, no-c-format msgid "Hibernate knows how to translate this limit query into the native SQL of your DBMS." msgstr "" #. Tag: title -#: session_api.xml:377 #, no-c-format msgid "Scrollable iteration" msgstr "" #. Tag: para -#: session_api.xml:379 #, no-c-format msgid "If your JDBC driver supports scrollable <literal>ResultSet</literal>s, the <literal>Query</literal> interface can be used to obtain a <literal>ScrollableResults</literal> object that allows flexible navigation of the query results." msgstr "" -#. Tag: programlisting -#: session_api.xml:386 -#, no-c-format -msgid "" - "<![CDATA[Query q = sess.createQuery(\"select cat.name, cat from DomesticCat cat \" +\n" - " \"order by cat.name\");\n" - "ScrollableResults cats = q.scroll();\n" - "if ( cats.first() ) {\n" - "\n" - " // find the first name on each page of an alphabetical list of cats by name\n" - " firstNamesOfPages = new ArrayList();\n" - " do {\n" - " String name = cats.getString(0);\n" - " firstNamesOfPages.add(name);\n" - " }\n" - " while ( cats.scroll(PAGE_SIZE) );\n" - "\n" - " // Now get the first page of cats\n" - " pageOfCats = new ArrayList();\n" - " cats.beforeFirst();\n" - " int i=0;\n" - " while( ( PAGE_SIZE > i++ ) && cats.next() ) pageOfCats.add( cats.get(1) );\n" - "\n" - "}\n" - "cats.close()]]>" -msgstr "" - #. Tag: para -#: session_api.xml:388 #, no-c-format msgid "Note that an open database connection and cursor is required for this functionality. Use <literal>setMaxResult()</literal>/<literal>setFirstResult()</literal> if you need offline pagination functionality." msgstr "" #. Tag: title -#: session_api.xml:397 #, no-c-format msgid "Externalizing named queries" msgstr "" #. Tag: para -#: session_api.xml:399 #, no-c-format msgid "You can also define named queries in the mapping document. Remember to use a <literal>CDATA</literal> section if your query contains characters that could be interpreted as markup." msgstr "" -#. Tag: programlisting -#: session_api.xml:405 -#, no-c-format -msgid "" - "<![CDATA[<query name=\"ByNameAndMaximumWeight\"><![CDATA[\n" - " from eg.DomesticCat as cat\n" - " where cat.name = ?\n" - " and cat.weight > ?\n" - "] ]></query>]]>" -msgstr "" - #. Tag: para -#: session_api.xml:407 #, no-c-format msgid "Parameter binding and executing is done programatically:" msgstr "" -#. Tag: programlisting -#: session_api.xml:411 -#, no-c-format -msgid "" - "<![CDATA[Query q = sess.getNamedQuery(\"ByNameAndMaximumWeight\");\n" - "q.setString(0, name);\n" - "q.setInt(1, minWeight);\n" - "List cats = q.list();]]>" -msgstr "" - #. Tag: para -#: session_api.xml:413 #, no-c-format msgid "The actual program code is independent of the query language that is used. You can also define native SQL queries in metadata, or migrate existing queries to Hibernate by placing them in mapping files." msgstr "" #. Tag: para -#: session_api.xml:419 #, no-c-format msgid "Also note that a query declaration inside a <literal><hibernate-mapping></literal> element requires a global unique name for the query, while a query declaration inside a <literal><class></literal> element is made unique automatically by prepending the fully qualified name of the class. For example <literal>eg.Cat.ByNameAndMaximumWeight</literal>." msgstr "" #. Tag: title -#: session_api.xml:432 #, no-c-format msgid "Filtering collections" msgstr "" #. Tag: para -#: session_api.xml:433 #, no-c-format msgid "A collection <emphasis>filter</emphasis> is a special type of query that can be applied to a persistent collection or array. The query string can refer to <literal>this</literal>, meaning the current collection element." msgstr "" -#. Tag: programlisting -#: session_api.xml:439 -#, no-c-format -msgid "" - "<![CDATA[Collection blackKittens = session.createFilter(\n" - " pk.getKittens(), \n" - " \"where this.color = ?\")\n" - " .setParameter( Color.BLACK, Hibernate.custom(ColorUserType.class) )\n" - " .list()\n" - ");]]>" -msgstr "" - #. Tag: para -#: session_api.xml:441 #, no-c-format msgid "The returned collection is considered a bag that is a copy of the given collection. The original collection is not modified. This is contrary to the implication of the name \"filter\", but consistent with expected behavior." msgstr "" #. Tag: para -#: session_api.xml:447 #, no-c-format msgid "Observe that filters do not require a <literal>from</literal> clause, although they can have one if required. Filters are not limited to returning the collection elements themselves." msgstr "" -#. Tag: programlisting -#: session_api.xml:452 -#, no-c-format -msgid "" - "<![CDATA[Collection blackKittenMates = session.createFilter(\n" - " pk.getKittens(), \n" - " \"select this.mate where this.color = eg.Color.BLACK.intValue\")\n" - " .list();]]>" -msgstr "" - #. Tag: para -#: session_api.xml:454 #, no-c-format msgid "Even an empty filter query is useful, e.g. to load a subset of elements in a large collection:" msgstr "" -#. Tag: programlisting -#: session_api.xml:459 -#, no-c-format -msgid "" - "<![CDATA[Collection tenKittens = session.createFilter(\n" - " mother.getKittens(), \"\")\n" - " .setFirstResult(0).setMaxResults(10)\n" - " .list();]]>" -msgstr "" - #. Tag: title -#: session_api.xml:464 #, no-c-format msgid "Criteria queries" msgstr "" #. Tag: para -#: session_api.xml:466 #, no-c-format msgid "HQL is extremely powerful, but some developers prefer to build queries dynamically using an object-oriented API, rather than building query strings. Hibernate provides an intuitive <literal>Criteria</literal> query API for these cases:" msgstr "" -#. Tag: programlisting -#: session_api.xml:472 -#, no-c-format -msgid "" - "<![CDATA[Criteria crit = session.createCriteria(Cat.class);\n" - "crit.add( Restrictions.eq( \"color\", eg.Color.BLACK ) );\n" - "crit.setMaxResults(10);\n" - "List cats = crit.list();]]>" -msgstr "" - #. Tag: para -#: session_api.xml:474 #, no-c-format -msgid "The <literal>Criteria</literal> and the associated <literal>Example</literal> API are discussed in more detail in <xref linkend=\"querycriteria\"/>." +msgid "The <literal>Criteria</literal> and the associated <literal>Example</literal> API are discussed in more detail in <xref linkend=\"querycriteria\" />." msgstr "" #. Tag: title -#: session_api.xml:482 #, no-c-format msgid "Queries in native SQL" msgstr "" #. Tag: para -#: session_api.xml:484 #, no-c-format msgid "You can express a query in SQL, using <literal>createSQLQuery()</literal> and let Hibernate manage the mapping from result sets to objects. You can at any time call <literal>session.connection()</literal> and use the JDBC <literal>Connection</literal> directly. If you choose to use the Hibernate API, you must enclose SQL aliases in braces:" msgstr "" -#. Tag: programlisting -#: session_api.xml:492 -#, no-c-format -msgid "" - "<![CDATA[List cats = session.createSQLQuery(\"SELECT {cat.*} FROM CAT {cat} WHERE ROWNUM<10\")\n" - " .addEntity(\"cat\", Cat.class)\n" - ".list();]]>" -msgstr "" - -#. Tag: programlisting -#: session_api.xml:494 -#, no-c-format -msgid "" - "<![CDATA[List cats = session.createSQLQuery(\n" - " \"SELECT {cat}.ID AS {cat.id}, {cat}.SEX AS {cat.sex}, \" +\n" - " \"{cat}.MATE AS {cat.mate}, {cat}.SUBCLASS AS {cat.class}, ... \" +\n" - " \"FROM CAT {cat} WHERE ROWNUM<10\")\n" - " .addEntity(\"cat\", Cat.class)\n" - ".list()]]>" -msgstr "" - #. Tag: para -#: session_api.xml:496 #, no-c-format -msgid "SQL queries can contain named and positional parameters, just like Hibernate queries. More information about native SQL queries in Hibernate can be found in <xref linkend=\"querysql\"/>." +msgid "SQL queries can contain named and positional parameters, just like Hibernate queries. More information about native SQL queries in Hibernate can be found in <xref linkend=\"querysql\" />." msgstr "" #. Tag: title -#: session_api.xml:507 #, no-c-format msgid "Modifying persistent objects" msgstr "" #. Tag: para -#: session_api.xml:509 #, no-c-format msgid "<emphasis>Transactional persistent instances</emphasis> (i.e. objects loaded, saved, created or queried by the <literal>Session</literal>) can be manipulated by the application, and any changes to persistent state will be persisted when the <literal>Session</literal> is <emphasis>flushed</emphasis>. This is discussed later in this chapter. There is no need to call a particular method (like <literal>update()</literal>, which has a different purpose) to make your modifications persistent. The most straightforward way to update the state of an object is to <literal>load()</literal> it and then manipulate it directly while the <literal>Session</literal> is open:" msgstr "" -#. Tag: programlisting -#: session_api.xml:520 -#, no-c-format -msgid "" - "<![CDATA[DomesticCat cat = (DomesticCat) sess.load( Cat.class, new Long(69) );\n" - "cat.setName(\"PK\");\n" - "sess.flush(); // changes to cat are automatically detected and persisted]]>" -msgstr "" - #. Tag: para -#: session_api.xml:522 #, no-c-format msgid "Sometimes this programming model is inefficient, as it requires in the same session both an SQL <literal>SELECT</literal> to load an object and an SQL <literal>UPDATE</literal> to persist its updated state. Hibernate offers an alternate approach by using detached instances." msgstr "" #. Tag: para -#: session_api.xml:529 #, no-c-format -msgid "Hibernate does not offer its own API for direct execution of <literal>UPDATE</literal> or <literal>DELETE</literal> statements. Hibernate is a <emphasis>state management</emphasis> service, you do not have to think in <emphasis>statements</emphasis> to use it. JDBC is a perfect API for executing SQL statements, you can get a JDBC <literal>Connection</literal> at any time by calling <literal>session.connection()</literal>. Furthermore, the notion of mass operations conflicts with object/relational mapping for online transaction processing-oriented applications. Future versions of Hibernate can, however, provide special mass operation functions. See <xref linkend=\"batch\"/> for some possible batch operation tricks." +msgid "Hibernate does not offer its own API for direct execution of <literal>UPDATE</literal> or <literal>DELETE</literal> statements. Hibernate is a <emphasis>state management</emphasis> service, you do not have to think in <emphasis>statements</emphasis> to use it. JDBC is a perfect API for executing SQL statements, you can get a JDBC <literal>Connection</literal> at any time by calling <literal>session.connection()</literal>. Furthermore, the notion of mass operations conflicts with object/relational mapping for online transaction processing-oriented applications. Future versions of Hibernate can, however, provide special mass operation functions. See <xref linkend=\"batch\" /> for some possible batch operation tricks." msgstr "" #. Tag: title -#: session_api.xml:546 #, no-c-format msgid "Modifying detached objects" msgstr "" #. Tag: para -#: session_api.xml:548 #, no-c-format msgid "Many applications need to retrieve an object in one transaction, send it to the UI layer for manipulation, then save the changes in a new transaction. Applications that use this kind of approach in a high-concurrency environment usually use versioned data to ensure isolation for the \"long\" unit of work." msgstr "" #. Tag: para -#: session_api.xml:555 #, no-c-format msgid "Hibernate supports this model by providing for reattachment of detached instances using the <literal>Session.update()</literal> or <literal>Session.merge()</literal> methods:" msgstr "" -#. Tag: programlisting -#: session_api.xml:561 -#, no-c-format -msgid "" - "<![CDATA[// in the first session\n" - "Cat cat = (Cat) firstSession.load(Cat.class, catId);\n" - "Cat potentialMate = new Cat();\n" - "firstSession.save(potentialMate);\n" - "\n" - "// in a higher layer of the application\n" - "cat.setMate(potentialMate);\n" - "\n" - "// later, in a new session\n" - "secondSession.update(cat); // update cat\n" - "secondSession.update(mate); // update mate]]>" -msgstr "" - #. Tag: para -#: session_api.xml:563 #, no-c-format msgid "If the <literal>Cat</literal> with identifier <literal>catId</literal> had already been loaded by <literal>secondSession</literal> when the application tried to reattach it, an exception would have been thrown." msgstr "" #. Tag: para -#: session_api.xml:569 #, no-c-format msgid "Use <literal>update()</literal> if you are certain that the session does not contain an already persistent instance with the same identifier. Use <literal>merge()</literal> if you want to merge your modifications at any time without consideration of the state of the session. In other words, <literal>update()</literal> is usually the first method you would call in a fresh session, ensuring that the reattachment of your detached instances is the first operation that is executed." msgstr "" #. Tag: para -#: session_api.xml:578 #, no-c-format -msgid "The application should individually <literal>update()</literal> detached instances that are reachable from the given detached instance <emphasis>only</emphasis> if it wants their state to be updated. This can be automated using <emphasis>transitive persistence</emphasis>. See <xref linkend=\"objectstate-transitive\"/> for more information." +msgid "The application should individually <literal>update()</literal> detached instances that are reachable from the given detached instance <emphasis>only</emphasis> if it wants their state to be updated. This can be automated using <emphasis>transitive persistence</emphasis>. See <xref linkend=\"objectstate-transitive\" /> for more information." msgstr "" #. Tag: para -#: session_api.xml:585 #, no-c-format msgid "The <literal>lock()</literal> method also allows an application to reassociate an object with a new session. However, the detached instance has to be unmodified." msgstr "" -#. Tag: programlisting -#: session_api.xml:590 -#, no-c-format -msgid "" - "<![CDATA[//just reassociate:\n" - "sess.lock(fritz, LockMode.NONE);\n" - "//do a version check, then reassociate:\n" - "sess.lock(izi, LockMode.READ);\n" - "//do a version check, using SELECT ... FOR UPDATE, then reassociate:\n" - "sess.lock(pk, LockMode.UPGRADE);]]>" -msgstr "" - #. Tag: para -#: session_api.xml:592 #, no-c-format msgid "Note that <literal>lock()</literal> can be used with various <literal>LockMode</literal>s. See the API documentation and the chapter on transaction handling for more information. Reattachment is not the only usecase for <literal>lock()</literal>." msgstr "" #. Tag: para -#: session_api.xml:599 #, no-c-format -msgid "Other models for long units of work are discussed in <xref linkend=\"transactions-optimistic\"/>." +msgid "Other models for long units of work are discussed in <xref linkend=\"transactions-optimistic\" />." msgstr "" #. Tag: title -#: session_api.xml:606 #, no-c-format msgid "Automatic state detection" msgstr "" #. Tag: para -#: session_api.xml:608 #, no-c-format msgid "Hibernate users have requested a general purpose method that either saves a transient instance by generating a new identifier or updates/reattaches the detached instances associated with its current identifier. The <literal>saveOrUpdate()</literal> method implements this functionality." msgstr "" -#. Tag: programlisting -#: session_api.xml:615 -#, no-c-format -msgid "" - "<![CDATA[// in the first session\n" - "Cat cat = (Cat) firstSession.load(Cat.class, catID);\n" - "\n" - "// in a higher tier of the application\n" - "Cat mate = new Cat();\n" - "cat.setMate(mate);\n" - "\n" - "// later, in a new session\n" - "secondSession.saveOrUpdate(cat); // update existing state (cat has a non-null id)\n" - "secondSession.saveOrUpdate(mate); // save the new instance (mate has a null id)]]>" -msgstr "" - #. Tag: para -#: session_api.xml:617 #, no-c-format msgid "The usage and semantics of <literal>saveOrUpdate()</literal> seems to be confusing for new users. Firstly, so long as you are not trying to use instances from one session in another new session, you should not need to use <literal>update()</literal>, <literal>saveOrUpdate()</literal>, or <literal>merge()</literal>. Some whole applications will never use either of these methods." msgstr "" #. Tag: para -#: session_api.xml:625 #, no-c-format msgid "Usually <literal>update()</literal> or <literal>saveOrUpdate()</literal> are used in the following scenario:" msgstr "" #. Tag: para -#: session_api.xml:632 #, no-c-format msgid "the application loads an object in the first session" msgstr "" #. Tag: para -#: session_api.xml:637 #, no-c-format msgid "the object is passed up to the UI tier" msgstr "" #. Tag: para -#: session_api.xml:642 #, no-c-format msgid "some modifications are made to the object" msgstr "" #. Tag: para -#: session_api.xml:647 #, no-c-format msgid "the object is passed back down to the business logic tier" msgstr "" #. Tag: para -#: session_api.xml:652 #, no-c-format msgid "the application persists these modifications by calling <literal>update()</literal> in a second session" msgstr "" #. Tag: para -#: session_api.xml:659 #, no-c-format msgid "<literal>saveOrUpdate()</literal> does the following:" msgstr "" #. Tag: para -#: session_api.xml:665 #, no-c-format msgid "if the object is already persistent in this session, do nothing" msgstr "" #. Tag: para -#: session_api.xml:670 #, no-c-format msgid "if another object associated with the session has the same identifier, throw an exception" msgstr "" #. Tag: para -#: session_api.xml:676 #, no-c-format msgid "if the object has no identifier property, <literal>save()</literal> it" msgstr "" #. Tag: para -#: session_api.xml:681 #, no-c-format msgid "if the object's identifier has the value assigned to a newly instantiated object, <literal>save()</literal> it" msgstr "" #. Tag: para -#: session_api.xml:687 #, no-c-format msgid "if the object is versioned by a <literal><version></literal> or <literal><timestamp></literal>, and the version property value is the same value assigned to a newly instantiated object, <literal>save()</literal> it" msgstr "" #. Tag: para -#: session_api.xml:695 #, no-c-format msgid "otherwise <literal>update()</literal> the object" msgstr "" #. Tag: para -#: session_api.xml:701 #, no-c-format msgid "and <literal>merge()</literal> is very different:" msgstr "" #. Tag: para -#: session_api.xml:707 #, no-c-format msgid "if there is a persistent instance with the same identifier currently associated with the session, copy the state of the given object onto the persistent instance" msgstr "" #. Tag: para -#: session_api.xml:714 #, no-c-format msgid "if there is no persistent instance currently associated with the session, try to load it from the database, or create a new persistent instance" msgstr "" #. Tag: para -#: session_api.xml:720 #, no-c-format msgid "the persistent instance is returned" msgstr "" #. Tag: para -#: session_api.xml:725 #, no-c-format msgid "the given instance does not become associated with the session, it remains detached" msgstr "" #. Tag: title -#: session_api.xml:735 #, no-c-format msgid "Deleting persistent objects" msgstr "" #. Tag: para -#: session_api.xml:737 #, no-c-format msgid "<literal>Session.delete()</literal> will remove an object's state from the database. Your application, however, can still hold a reference to a deleted object. It is best to think of <literal>delete()</literal> as making a persistent instance, transient." msgstr "" -#. Tag: programlisting -#: session_api.xml:744 -#, no-c-format -msgid "<![CDATA[sess.delete(cat);]]>" -msgstr "" - #. Tag: para -#: session_api.xml:746 #, no-c-format msgid "You can delete objects in any order, without risk of foreign key constraint violations. It is still possible to violate a <literal>NOT NULL</literal> constraint on a foreign key column by deleting objects in the wrong order, e.g. if you delete the parent, but forget to delete the children." msgstr "" #. Tag: title -#: session_api.xml:757 #, no-c-format msgid "Replicating object between two different datastores" msgstr "" #. Tag: para -#: session_api.xml:759 #, no-c-format msgid "It is sometimes useful to be able to take a graph of persistent instances and make them persistent in a different datastore, without regenerating identifier values." msgstr "" -#. Tag: programlisting -#: session_api.xml:765 -#, no-c-format -msgid "" - "<![CDATA[//retrieve a cat from one database\n" - "Session session1 = factory1.openSession();\n" - "Transaction tx1 = session1.beginTransaction();\n" - "Cat cat = session1.get(Cat.class, catId);\n" - "tx1.commit();\n" - "session1.close();\n" - "\n" - "//reconcile with a second database\n" - "Session session2 = factory2.openSession();\n" - "Transaction tx2 = session2.beginTransaction();\n" - "session2.replicate(cat, ReplicationMode.LATEST_VERSION);\n" - "tx2.commit();\n" - "session2.close();]]>" -msgstr "" - #. Tag: para -#: session_api.xml:767 #, no-c-format msgid "The <literal>ReplicationMode</literal> determines how <literal>replicate()</literal> will deal with conflicts with existing rows in the database:" msgstr "" #. Tag: para -#: session_api.xml:774 #, no-c-format msgid "<literal>ReplicationMode.IGNORE</literal>: ignores the object when there is an existing database row with the same identifier" msgstr "" #. Tag: para -#: session_api.xml:780 #, no-c-format msgid "<literal>ReplicationMode.OVERWRITE</literal>: overwrites any existing database row with the same identifier" msgstr "" #. Tag: para -#: session_api.xml:786 #, no-c-format msgid "<literal>ReplicationMode.EXCEPTION</literal>: throws an exception if there is an existing database row with the same identifier" msgstr "" #. Tag: para -#: session_api.xml:792 #, no-c-format msgid "<literal>ReplicationMode.LATEST_VERSION</literal>: overwrites the row if its version number is earlier than the version number of the object, or ignore the object otherwise" msgstr "" #. Tag: para -#: session_api.xml:800 #, no-c-format msgid "Usecases for this feature include reconciling data entered into different database instances, upgrading system configuration information during product upgrades, rolling back changes made during non-ACID transactions and more." msgstr "" #. Tag: title -#: session_api.xml:809 #, no-c-format msgid "Flushing the Session" msgstr "" #. Tag: para -#: session_api.xml:811 #, no-c-format msgid "Sometimes the <literal>Session</literal> will execute the SQL statements needed to synchronize the JDBC connection's state with the state of objects held in memory. This process, called <emphasis>flush</emphasis>, occurs by default at the following points:" msgstr "" #. Tag: para -#: session_api.xml:820 #, no-c-format msgid "before some query executions" msgstr "" #. Tag: para -#: session_api.xml:825 #, no-c-format msgid "from <literal>org.hibernate.Transaction.commit()</literal>" msgstr "" #. Tag: para -#: session_api.xml:830 #, no-c-format msgid "from <literal>Session.flush()</literal>" msgstr "" #. Tag: para -#: session_api.xml:836 #, no-c-format msgid "The SQL statements are issued in the following order:" msgstr "" #. Tag: para -#: session_api.xml:842 #, no-c-format msgid "all entity insertions in the same order the corresponding objects were saved using <literal>Session.save()</literal>" msgstr "" #. Tag: para -#: session_api.xml:848 #, no-c-format msgid "all entity updates" msgstr "" #. Tag: para -#: session_api.xml:853 #, no-c-format msgid "all collection deletions" msgstr "" #. Tag: para -#: session_api.xml:858 #, no-c-format msgid "all collection element deletions, updates and insertions" msgstr "" #. Tag: para -#: session_api.xml:863 #, no-c-format msgid "all collection insertions" msgstr "" #. Tag: para -#: session_api.xml:868 #, no-c-format msgid "all entity deletions in the same order the corresponding objects were deleted using <literal>Session.delete()</literal>" msgstr "" #. Tag: para -#: session_api.xml:875 #, no-c-format msgid "An exception is that objects using <literal>native</literal> ID generation are inserted when they are saved." msgstr "" #. Tag: para -#: session_api.xml:880 #, no-c-format msgid "Except when you explicitly <literal>flush()</literal>, there are absolutely no guarantees about <emphasis>when</emphasis> the <literal>Session</literal> executes the JDBC calls, only the <emphasis>order</emphasis> in which they are executed. However, Hibernate does guarantee that the <literal>Query.list(..)</literal> will never return stale or incorrect data." msgstr "" #. Tag: para -#: session_api.xml:888 #, no-c-format -msgid "It is possible to change the default behavior so that flush occurs less frequently. The <literal>FlushMode</literal> class defines three different modes: only flush at commit time when the Hibernate <literal>Transaction</literal> API is used, flush automatically using the explained routine, or never flush unless <literal>flush()</literal> is called explicitly. The last mode is useful for long running units of work, where a <literal>Session</literal> is kept open and disconnected for a long time (see <xref linkend=\"transactions-optimistic-longsession\"/>)." +msgid "It is possible to change the default behavior so that flush occurs less frequently. The <literal>FlushMode</literal> class defines three different modes: only flush at commit time when the Hibernate <literal>Transaction</literal> API is used, flush automatically using the explained routine, or never flush unless <literal>flush()</literal> is called explicitly. The last mode is useful for long running units of work, where a <literal>Session</literal> is kept open and disconnected for a long time (see <xref linkend=\"transactions-optimistic-longsession\" />)." msgstr "" -#. Tag: programlisting -#: session_api.xml:898 -#, no-c-format -msgid "" - "<![CDATA[sess = sf.openSession();\n" - "Transaction tx = sess.beginTransaction();\n" - "sess.setFlushMode(FlushMode.COMMIT); // allow queries to return stale state\n" - "\n" - "Cat izi = (Cat) sess.load(Cat.class, id);\n" - "izi.setName(iznizi);\n" - "\n" - "// might return stale data\n" - "sess.find(\"from Cat as cat left outer join cat.kittens kitten\");\n" - "\n" - "// change to izi is not flushed!\n" - "...\n" - "tx.commit(); // flush occurs\n" - "sess.close();]]>" -msgstr "" - #. Tag: para -#: session_api.xml:900 #, no-c-format -msgid "During flush, an exception might occur (e.g. if a DML operation violates a constraint). Since handling exceptions involves some understanding of Hibernate's transactional behavior, we discuss it in <xref linkend=\"transactions\"/>." +msgid "During flush, an exception might occur (e.g. if a DML operation violates a constraint). Since handling exceptions involves some understanding of Hibernate's transactional behavior, we discuss it in <xref linkend=\"transactions\" />." msgstr "" #. Tag: title -#: session_api.xml:909 #, no-c-format msgid "Transitive persistence" msgstr "" #. Tag: para -#: session_api.xml:911 #, no-c-format msgid "It is quite cumbersome to save, delete, or reattach individual objects, especially if you deal with a graph of associated objects. A common case is a parent/child relationship. Consider the following example:" msgstr "" #. Tag: para -#: session_api.xml:917 #, no-c-format msgid "If the children in a parent/child relationship would be value typed (e.g. a collection of addresses or strings), their life cycle would depend on the parent and no further action would be required for convenient \"cascading\" of state changes. When the parent is saved, the value-typed child objects are saved and when the parent is deleted, the children will be deleted, etc. This works for operations such as the removal of a child from the collection. Since value-typed objects cannot have shared references, Hibernate will detect this and delete the child from the database." msgstr "" #. Tag: para -#: session_api.xml:928 #, no-c-format msgid "Now consider the same scenario with parent and child objects being entities, not value-types (e.g. categories and items, or parent and child cats). Entities have their own life cycle and support shared references. Removing an entity from the collection does not mean it can be deleted), and there is by default no cascading of state from one entity to any other associated entities. Hibernate does not implement <emphasis>persistence by reachability</emphasis> by default." msgstr "" #. Tag: para -#: session_api.xml:937 #, no-c-format msgid "For each basic operation of the Hibernate session - including <literal>persist(), merge(), saveOrUpdate(), delete(), lock(), refresh(), evict(), replicate()</literal> - there is a corresponding cascade style. Respectively, the cascade styles are named <literal>create, merge, save-update, delete, lock, refresh, evict, replicate</literal>. If you want an operation to be cascaded along an association, you must indicate that in the mapping document. For example:" msgstr "" -#. Tag: programlisting -#: session_api.xml:946 -#, no-c-format -msgid "<![CDATA[<one-to-one name=\"person\" cascade=\"persist\"/>]]>" -msgstr "" - #. Tag: para -#: session_api.xml:948 #, no-c-format msgid "Cascade styles my be combined:" msgstr "" -#. Tag: programlisting -#: session_api.xml:952 -#, no-c-format -msgid "<![CDATA[<one-to-one name=\"person\" cascade=\"persist,delete,lock\"/>]]>" -msgstr "" - #. Tag: para -#: session_api.xml:954 #, no-c-format msgid "You can even use <literal>cascade=\"all\"</literal> to specify that <emphasis>all</emphasis> operations should be cascaded along the association. The default <literal>cascade=\"none\"</literal> specifies that no operations are to be cascaded." msgstr "" #. Tag: para -#: session_api.xml:960 #, no-c-format msgid "A special cascade style, <literal>delete-orphan</literal>, applies only to one-to-many associations, and indicates that the <literal>delete()</literal> operation should be applied to any child object that is removed from the association." msgstr "" #. Tag: para -#: session_api.xml:967 #, no-c-format msgid "Recommendations:" msgstr "" #. Tag: para -#: session_api.xml:973 #, no-c-format msgid "It does not usually make sense to enable cascade on a <literal><many-to-one></literal> or <literal><many-to-many></literal> association. Cascade is often useful for <literal><one-to-one></literal> and <literal><one-to-many></literal> associations." msgstr "" #. Tag: para -#: session_api.xml:981 #, no-c-format msgid "If the child object's lifespan is bounded by the lifespan of the parent object, make it a <emphasis>life cycle object</emphasis> by specifying <literal>cascade=\"all,delete-orphan\"</literal>." msgstr "" #. Tag: para -#: session_api.xml:988 #, no-c-format msgid "Otherwise, you might not need cascade at all. But if you think that you will often be working with the parent and children together in the same transaction, and you want to save yourself some typing, consider using <literal>cascade=\"persist,merge,save-update\"</literal>." msgstr "" #. Tag: para -#: session_api.xml:996 #, no-c-format msgid "Mapping an association (either a single valued association, or a collection) with <literal>cascade=\"all\"</literal> marks the association as a <emphasis>parent/child</emphasis> style relationship where save/update/delete of the parent results in save/update/delete of the child or children." msgstr "" #. Tag: para -#: session_api.xml:1002 #, no-c-format msgid "Furthermore, a mere reference to a child from a persistent parent will result in save/update of the child. This metaphor is incomplete, however. A child which becomes unreferenced by its parent is <emphasis>not</emphasis> automatically deleted, except in the case of a <literal><one-to-many></literal> association mapped with <literal>cascade=\"delete-orphan\"</literal>. The precise semantics of cascading operations for a parent/child relationship are as follows:" msgstr "" #. Tag: para -#: session_api.xml:1013 #, no-c-format msgid "If a parent is passed to <literal>persist()</literal>, all children are passed to <literal>persist()</literal>" msgstr "" #. Tag: para -#: session_api.xml:1019 #, no-c-format msgid "If a parent is passed to <literal>merge()</literal>, all children are passed to <literal>merge()</literal>" msgstr "" #. Tag: para -#: session_api.xml:1025 #, no-c-format msgid "If a parent is passed to <literal>save()</literal>, <literal>update()</literal> or <literal>saveOrUpdate()</literal>, all children are passed to <literal>saveOrUpdate()</literal>" msgstr "" #. Tag: para -#: session_api.xml:1031 #, no-c-format msgid "If a transient or detached child becomes referenced by a persistent parent, it is passed to <literal>saveOrUpdate()</literal>" msgstr "" #. Tag: para -#: session_api.xml:1037 #, no-c-format msgid "If a parent is deleted, all children are passed to <literal>delete()</literal>" msgstr "" #. Tag: para -#: session_api.xml:1042 #, no-c-format msgid "If a child is dereferenced by a persistent parent, <emphasis>nothing special happens</emphasis> - the application should explicitly delete the child if necessary - unless <literal>cascade=\"delete-orphan\"</literal>, in which case the \"orphaned\" child is deleted." msgstr "" #. Tag: para -#: session_api.xml:1051 #, no-c-format msgid "Finally, note that cascading of operations can be applied to an object graph at <emphasis>call time</emphasis> or at <emphasis>flush time</emphasis>. All operations, if enabled, are cascaded to associated entities reachable when the operation is executed. However, <literal>save-update</literal> and <literal>delete-orphan</literal> are transitive for all associated entities reachable during flush of the <literal>Session</literal>." msgstr "" #. Tag: title -#: session_api.xml:1063 #, no-c-format msgid "Using metadata" msgstr "" #. Tag: para -#: session_api.xml:1065 #, no-c-format msgid "Hibernate requires a rich meta-level model of all entity and value types. This model can be useful to the application itself. For example, the application might use Hibernate's metadata to implement a \"smart\" deep-copy algorithm that understands which objects should be copied (eg. mutable value types) and which objects that should not (e.g. immutable value types and, possibly, associated entities)." msgstr "" #. Tag: para -#: session_api.xml:1072 #, no-c-format msgid "Hibernate exposes metadata via the <literal>ClassMetadata</literal> and <literal>CollectionMetadata</literal> interfaces and the <literal>Type</literal> hierarchy. Instances of the metadata interfaces can be obtained from the <literal>SessionFactory</literal>." msgstr "" -#. Tag: programlisting -#: session_api.xml:1079 -#, no-c-format -msgid "" - "<![CDATA[Cat fritz = ......;\n" - "ClassMetadata catMeta = sessionfactory.getClassMetadata(Cat.class);\n" - "\n" - "Object[] propertyValues = catMeta.getPropertyValues(fritz);\n" - "String[] propertyNames = catMeta.getPropertyNames();\n" - "Type[] propertyTypes = catMeta.getPropertyTypes();\n" - "\n" - "// get a Map of all properties which are not collections or associations\n" - "Map namedValues = new HashMap();\n" - "for ( int i=0; i<propertyNames.length; i++ ) {\n" - " if ( !propertyTypes[i].isEntityType() && !propertyTypes[i].isCollectionType() ) {\n" - " namedValues.put( propertyNames[i], propertyValues[i] );\n" - " }\n" - "}]]>" -msgstr "" - Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/toolset_guide.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/toolset_guide.pot 2010-02-08 04:50:03 UTC (rev 18716) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/toolset_guide.pot 2010-02-08 04:56:55 UTC (rev 18717) @@ -1,956 +1,634 @@ -# SOME DESCRIPTIVE TITLE. -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. # -#, fuzzy msgid "" msgstr "" -"Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-10 21:02+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:20\n" +"PO-Revision-Date: 2010-01-08T04:07:20\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" "MIME-Version: 1.0\n" -"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Type: application/x-publican; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. Tag: title -#: toolset_guide.xml:29 #, no-c-format msgid "Toolset Guide" msgstr "" #. Tag: para -#: toolset_guide.xml:31 #, no-c-format msgid "Roundtrip engineering with Hibernate is possible using a set of Eclipse plugins, commandline tools, and Ant tasks." msgstr "" #. Tag: para -#: toolset_guide.xml:36 #, no-c-format msgid "<emphasis>Hibernate Tools</emphasis> currently include plugins for the Eclipse IDE as well as Ant tasks for reverse engineering of existing databases:" msgstr "" #. Tag: para -#: toolset_guide.xml:42 #, no-c-format msgid "<emphasis>Mapping Editor:</emphasis> an editor for Hibernate XML mapping files that supports auto-completion and syntax highlighting. It also supports semantic auto-completion for class names and property/field names, making it more versatile than a normal XML editor." msgstr "" #. Tag: para -#: toolset_guide.xml:47 #, no-c-format msgid "<emphasis>Console:</emphasis> the console is a new view in Eclipse. In addition to a tree overview of your console configurations, you are also provided with an interactive view of your persistent classes and their relationships. The console allows you to execute HQL queries against your database and browse the result directly in Eclipse." msgstr "" #. Tag: para -#: toolset_guide.xml:54 #, no-c-format msgid "<emphasis>Development Wizards:</emphasis> several wizards are provided with the Hibernate Eclipse tools. You can use a wizard to quickly generate Hibernate configuration (cfg.xml) files, or to reverse engineer an existing database schema into POJO source files and Hibernate mapping files. The reverse engineering wizard supports customizable templates." msgstr "" #. Tag: para -#: toolset_guide.xml:67 #, no-c-format +msgid "" +msgstr "" + +#. Tag: para +#, no-c-format msgid "Please refer to the <emphasis>Hibernate Tools</emphasis> package documentation for more information." msgstr "" #. Tag: para -#: toolset_guide.xml:72 #, no-c-format msgid "However, the Hibernate main package comes bundled with an integrated tool : <emphasis>SchemaExport</emphasis> aka <literal>hbm2ddl</literal>.It can even be used from \"inside\" Hibernate." msgstr "" #. Tag: title -#: toolset_guide.xml:79 #, no-c-format msgid "Automatic schema generation" msgstr "" #. Tag: para -#: toolset_guide.xml:81 #, no-c-format msgid "DDL can be generated from your mapping files by a Hibernate utility. The generated schema includes referential integrity constraints, primary and foreign keys, for entity and collection tables. Tables and sequences are also created for mapped identifier generators." msgstr "" #. Tag: para -#: toolset_guide.xml:88 #, no-c-format msgid "You <emphasis>must</emphasis> specify a SQL <literal>Dialect</literal> via the <literal>hibernate.dialect</literal> property when using this tool, as DDL is highly vendor-specific." msgstr "" #. Tag: para -#: toolset_guide.xml:94 #, no-c-format msgid "First, you must customize your mapping files to improve the generated schema. The next section covers schema customization." msgstr "" #. Tag: title -#: toolset_guide.xml:99 #, no-c-format msgid "Customizing the schema" msgstr "" #. Tag: para -#: toolset_guide.xml:101 #, no-c-format msgid "Many Hibernate mapping elements define optional attributes named <literal>length</literal>, <literal>precision</literal> and <literal>scale</literal>. You can set the length, precision and scale of a column with this attribute." msgstr "" -#. Tag: programlisting -#: toolset_guide.xml:108 -#, no-c-format -msgid "<![CDATA[<property name=\"zip\" length=\"5\"/>]]>" -msgstr "" - -#. Tag: programlisting -#: toolset_guide.xml:109 -#, no-c-format -msgid "<![CDATA[<property name=\"balance\" precision=\"12\" scale=\"2\"/>]]>" -msgstr "" - #. Tag: para -#: toolset_guide.xml:111 #, no-c-format msgid "Some tags also accept a <literal>not-null</literal> attribute for generating a <literal>NOT NULL</literal> constraint on table columns, and a <literal>unique</literal> attribute for generating <literal>UNIQUE</literal> constraint on table columns." msgstr "" -#. Tag: programlisting -#: toolset_guide.xml:117 -#, no-c-format -msgid "<![CDATA[<many-to-one name=\"bar\" column=\"barId\" not-null=\"true\"/>]]>" -msgstr "" - -#. Tag: programlisting -#: toolset_guide.xml:119 -#, no-c-format -msgid "<![CDATA[<element column=\"serialNumber\" type=\"long\" not-null=\"true\" unique=\"true\"/>]]>" -msgstr "" - #. Tag: para -#: toolset_guide.xml:121 #, no-c-format msgid "A <literal>unique-key</literal> attribute can be used to group columns in a single, unique key constraint. Currently, the specified value of the <literal>unique-key</literal> attribute is <emphasis>not</emphasis> used to name the constraint in the generated DDL. It is only used to group the columns in the mapping file." msgstr "" -#. Tag: programlisting -#: toolset_guide.xml:129 -#, no-c-format -msgid "" - "<![CDATA[<many-to-one name=\"org\" column=\"orgId\" unique-key=\"OrgEmployeeId\"/>\n" - "<property name=\"employeeId\" unique-key=\"OrgEmployee\"/>]]>" -msgstr "" - #. Tag: para -#: toolset_guide.xml:131 #, no-c-format msgid "An <literal>index</literal> attribute specifies the name of an index that will be created using the mapped column or columns. Multiple columns can be grouped into the same index by simply specifying the same index name." msgstr "" -#. Tag: programlisting -#: toolset_guide.xml:137 -#, no-c-format -msgid "" - "<![CDATA[<property name=\"lastName\" index=\"CustName\"/>\n" - "<property name=\"firstName\" index=\"CustName\"/>]]>" -msgstr "" - #. Tag: para -#: toolset_guide.xml:139 #, no-c-format msgid "A <literal>foreign-key</literal> attribute can be used to override the name of any generated foreign key constraint." msgstr "" -#. Tag: programlisting -#: toolset_guide.xml:144 -#, no-c-format -msgid "<![CDATA[<many-to-one name=\"bar\" column=\"barId\" foreign-key=\"FKFooBar\"/>]]>" -msgstr "" - #. Tag: para -#: toolset_guide.xml:146 #, no-c-format msgid "Many mapping elements also accept a child <literal><column></literal> element. This is particularly useful for mapping multi-column types:" msgstr "" -#. Tag: programlisting -#: toolset_guide.xml:151 -#, no-c-format -msgid "" - "<![CDATA[<property name=\"name\" type=\"my.customtypes.Name\"/>\n" - " <column name=\"last\" not-null=\"true\" index=\"bar_idx\" length=\"30\"/>\n" - " <column name=\"first\" not-null=\"true\" index=\"bar_idx\" length=\"20\"/>\n" - " <column name=\"initial\"/>\n" - "</property>]]>" -msgstr "" - #. Tag: para -#: toolset_guide.xml:153 #, no-c-format msgid "The <literal>default</literal> attribute allows you to specify a default value for a column.You should assign the same value to the mapped property before saving a new instance of the mapped class." msgstr "" -#. Tag: programlisting -#: toolset_guide.xml:159 -#, no-c-format -msgid "" - "<![CDATA[<property name=\"credits\" type=\"integer\" insert=\"false\">\n" - " <column name=\"credits\" default=\"10\"/>\n" - "</property>]]>" -msgstr "" - -#. Tag: programlisting -#: toolset_guide.xml:161 -#, no-c-format -msgid "" - "<![CDATA[<version name=\"version\" type=\"integer\" insert=\"false\">\n" - " <column name=\"version\" default=\"0\"/>\n" - "</property>]]>" -msgstr "" - #. Tag: para -#: toolset_guide.xml:163 #, no-c-format msgid "The <literal>sql-type</literal> attribute allows the user to override the default mapping of a Hibernate type to SQL datatype." msgstr "" -#. Tag: programlisting -#: toolset_guide.xml:168 -#, no-c-format -msgid "" - "<![CDATA[<property name=\"balance\" type=\"float\">\n" - " <column name=\"balance\" sql-type=\"decimal(13,3)\"/>\n" - "</property>]]>" -msgstr "" - #. Tag: para -#: toolset_guide.xml:170 #, no-c-format msgid "The <literal>check</literal> attribute allows you to specify a check constraint." msgstr "" -#. Tag: programlisting -#: toolset_guide.xml:174 -#, no-c-format -msgid "" - "<![CDATA[<property name=\"foo\" type=\"integer\">\n" - " <column name=\"foo\" check=\"foo > 10\"/>\n" - "</property>]]>" -msgstr "" - -#. Tag: programlisting -#: toolset_guide.xml:176 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Foo\" table=\"foos\" check=\"bar < 100.0\">\n" - " ...\n" - " <property name=\"bar\" type=\"float\"/>\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: toolset_guide.xml:179 #, no-c-format msgid "The following table summarizes these optional attributes." msgstr "" #. Tag: title -#: toolset_guide.xml:182 #, no-c-format msgid "Summary" msgstr "" -#. Tag: entry -#: toolset_guide.xml:189 +#. Tag: para #, no-c-format msgid "Attribute" msgstr "" -#. Tag: entry -#: toolset_guide.xml:190 +#. Tag: para #, no-c-format msgid "Values" msgstr "" -#. Tag: entry -#: toolset_guide.xml:191 +#. Tag: para #, no-c-format msgid "Interpretation" msgstr "" -#. Tag: literal -#: toolset_guide.xml:196 +#. Tag: para #, no-c-format -msgid "length" +msgid "<literal>length</literal>" msgstr "" -#. Tag: entry -#: toolset_guide.xml:197 toolset_guide.xml:202 toolset_guide.xml:207 +#. Tag: para #, no-c-format msgid "number" msgstr "" -#. Tag: entry -#: toolset_guide.xml:198 +#. Tag: para #, no-c-format msgid "column length" msgstr "" -#. Tag: literal -#: toolset_guide.xml:201 +#. Tag: para #, no-c-format -msgid "precision" +msgid "<literal>precision</literal>" msgstr "" -#. Tag: entry -#: toolset_guide.xml:203 +#. Tag: para #, no-c-format msgid "column decimal precision" msgstr "" -#. Tag: literal -#: toolset_guide.xml:206 +#. Tag: para #, no-c-format -msgid "scale" +msgid "<literal>scale</literal>" msgstr "" -#. Tag: entry -#: toolset_guide.xml:208 +#. Tag: para #, no-c-format msgid "column decimal scale" msgstr "" -#. Tag: literal -#: toolset_guide.xml:211 +#. Tag: para #, no-c-format -msgid "not-null" +msgid "<literal>not-null</literal>" msgstr "" -#. Tag: literal -#: toolset_guide.xml:212 toolset_guide.xml:217 +#. Tag: para #, no-c-format -msgid "true|false" +msgid "<literal>true|false</literal>" msgstr "" -#. Tag: entry -#: toolset_guide.xml:213 +#. Tag: para #, no-c-format msgid "specifies that the column should be non-nullable" msgstr "" -#. Tag: literal -#: toolset_guide.xml:216 +#. Tag: para #, no-c-format -msgid "unique" +msgid "<literal>unique</literal>" msgstr "" -#. Tag: entry -#: toolset_guide.xml:218 +#. Tag: para #, no-c-format msgid "specifies that the column should have a unique constraint" msgstr "" -#. Tag: literal -#: toolset_guide.xml:221 +#. Tag: para #, no-c-format -msgid "index" +msgid "<literal>index</literal>" msgstr "" -#. Tag: literal -#: toolset_guide.xml:222 +#. Tag: para #, no-c-format -msgid "index_name" +msgid "<literal>index_name</literal>" msgstr "" -#. Tag: entry -#: toolset_guide.xml:223 +#. Tag: para #, no-c-format msgid "specifies the name of a (multi-column) index" msgstr "" -#. Tag: literal -#: toolset_guide.xml:226 +#. Tag: para #, no-c-format -msgid "unique-key" +msgid "<literal>unique-key</literal>" msgstr "" -#. Tag: literal -#: toolset_guide.xml:227 +#. Tag: para #, no-c-format -msgid "unique_key_name" +msgid "<literal>unique_key_name</literal>" msgstr "" -#. Tag: entry -#: toolset_guide.xml:228 +#. Tag: para #, no-c-format msgid "specifies the name of a multi-column unique constraint" msgstr "" -#. Tag: literal -#: toolset_guide.xml:231 +#. Tag: para #, no-c-format -msgid "foreign-key" +msgid "<literal>foreign-key</literal>" msgstr "" -#. Tag: literal -#: toolset_guide.xml:232 +#. Tag: para #, no-c-format -msgid "foreign_key_name" +msgid "<literal>foreign_key_name</literal>" msgstr "" -#. Tag: entry -#: toolset_guide.xml:233 +#. Tag: para #, no-c-format msgid "specifies the name of the foreign key constraint generated for an association, for a <literal><one-to-one></literal>, <literal><many-to-one></literal>, <literal><key></literal>, or <literal><many-to-many></literal> mapping element. Note that <literal>inverse=\"true\"</literal> sides will not be considered by <literal>SchemaExport</literal>." msgstr "" -#. Tag: literal -#: toolset_guide.xml:243 +#. Tag: para #, no-c-format -msgid "sql-type" +msgid "<literal>sql-type</literal>" msgstr "" -#. Tag: literal -#: toolset_guide.xml:244 +#. Tag: para #, no-c-format -msgid "SQL column type" +msgid "<literal>SQL column type</literal>" msgstr "" -#. Tag: entry -#: toolset_guide.xml:245 +#. Tag: para #, no-c-format msgid "overrides the default column type (attribute of <literal><column></literal> element only)" msgstr "" -#. Tag: literal -#: toolset_guide.xml:251 +#. Tag: para #, no-c-format -msgid "default" +msgid "<literal>default</literal>" msgstr "" -#. Tag: entry -#: toolset_guide.xml:252 toolset_guide.xml:259 +#. Tag: para #, no-c-format msgid "SQL expression" msgstr "" -#. Tag: entry -#: toolset_guide.xml:253 +#. Tag: para #, no-c-format msgid "specify a default value for the column" msgstr "" -#. Tag: literal -#: toolset_guide.xml:258 +#. Tag: para #, no-c-format -msgid "check" +msgid "<literal>check</literal>" msgstr "" -#. Tag: entry -#: toolset_guide.xml:260 +#. Tag: para #, no-c-format msgid "create an SQL check constraint on either column or table" msgstr "" #. Tag: para -#: toolset_guide.xml:268 #, no-c-format msgid "The <literal><comment></literal> element allows you to specify comments for the generated schema." msgstr "" -#. Tag: programlisting -#: toolset_guide.xml:273 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Customer\" table=\"CurCust\">\n" - " <comment>Current customers only</comment>\n" - " ...\n" - "</class>]]>" -msgstr "" - -#. Tag: programlisting -#: toolset_guide.xml:275 -#, no-c-format -msgid "" - "<![CDATA[<property name=\"balance\">\n" - " <column name=\"bal\">\n" - " <comment>Balance in USD</comment>\n" - " </column>\n" - "</property>]]>" -msgstr "" - #. Tag: para -#: toolset_guide.xml:277 #, no-c-format msgid "This results in a <literal>comment on table</literal> or <literal>comment on column</literal> statement in the generated DDL where supported." msgstr "" #. Tag: title -#: toolset_guide.xml:286 #, no-c-format msgid "Running the tool" msgstr "" #. Tag: para -#: toolset_guide.xml:288 #, no-c-format msgid "The <literal>SchemaExport</literal> tool writes a DDL script to standard out and/or executes the DDL statements." msgstr "" #. Tag: para -#: toolset_guide.xml:293 #, no-c-format msgid "The following table displays the <literal>SchemaExport</literal> command line options" msgstr "" #. Tag: para -#: toolset_guide.xml:295 #, no-c-format msgid "<literal>java -cp </literal><emphasis>hibernate_classpaths</emphasis> <literal>org.hibernate.tool.hbm2ddl.SchemaExport</literal> <emphasis>options mapping_files</emphasis>" msgstr "" #. Tag: title -#: toolset_guide.xml:301 #, no-c-format msgid "<literal>SchemaExport</literal> Command Line Options" msgstr "" -#. Tag: entry -#: toolset_guide.xml:307 toolset_guide.xml:457 toolset_guide.xml:526 +#. Tag: para #, no-c-format msgid "Option" msgstr "" -#. Tag: entry -#: toolset_guide.xml:308 toolset_guide.xml:395 toolset_guide.xml:458 toolset_guide.xml:527 +#. Tag: para #, no-c-format msgid "Description" msgstr "" -#. Tag: literal -#: toolset_guide.xml:313 toolset_guide.xml:463 +#. Tag: para #, no-c-format -msgid "--quiet" +msgid "<literal>--quiet</literal>" msgstr "" -#. Tag: entry -#: toolset_guide.xml:314 toolset_guide.xml:464 +#. Tag: para #, no-c-format msgid "do not output the script to stdout" msgstr "" -#. Tag: literal -#: toolset_guide.xml:317 +#. Tag: para #, no-c-format -msgid "--drop" +msgid "<literal>--drop</literal>" msgstr "" -#. Tag: entry -#: toolset_guide.xml:318 +#. Tag: para #, no-c-format msgid "only drop the tables" msgstr "" -#. Tag: literal -#: toolset_guide.xml:321 +#. Tag: para #, no-c-format -msgid "--create" +msgid "<literal>--create</literal>" msgstr "" -#. Tag: entry -#: toolset_guide.xml:322 +#. Tag: para #, no-c-format msgid "only create the tables" msgstr "" -#. Tag: literal -#: toolset_guide.xml:325 toolset_guide.xml:467 +#. Tag: para #, no-c-format -msgid "--text" +msgid "<literal>--text</literal>" msgstr "" -#. Tag: entry -#: toolset_guide.xml:326 +#. Tag: para #, no-c-format msgid "do not export to the database" msgstr "" -#. Tag: literal -#: toolset_guide.xml:329 +#. Tag: para #, no-c-format -msgid "--output=my_schema.ddl" +msgid "<literal>--output=my_schema.ddl</literal>" msgstr "" -#. Tag: entry -#: toolset_guide.xml:330 +#. Tag: para #, no-c-format msgid "output the ddl script to a file" msgstr "" -#. Tag: literal -#: toolset_guide.xml:333 toolset_guide.xml:471 toolset_guide.xml:532 +#. Tag: para #, no-c-format -msgid "--naming=eg.MyNamingStrategy" +msgid "<literal>--naming=eg.MyNamingStrategy</literal>" msgstr "" -#. Tag: entry -#: toolset_guide.xml:334 toolset_guide.xml:472 toolset_guide.xml:533 +#. Tag: para #, no-c-format msgid "select a <literal>NamingStrategy</literal>" msgstr "" -#. Tag: literal -#: toolset_guide.xml:337 toolset_guide.xml:479 toolset_guide.xml:540 +#. Tag: para #, no-c-format -msgid "--config=hibernate.cfg.xml" +msgid "<literal>--config=hibernate.cfg.xml</literal>" msgstr "" -#. Tag: entry -#: toolset_guide.xml:338 +#. Tag: para #, no-c-format msgid "read Hibernate configuration from an XML file" msgstr "" -#. Tag: literal -#: toolset_guide.xml:341 toolset_guide.xml:475 toolset_guide.xml:536 +#. Tag: para #, no-c-format -msgid "--properties=hibernate.properties" +msgid "<literal>--properties=hibernate.properties</literal>" msgstr "" -#. Tag: entry -#: toolset_guide.xml:342 toolset_guide.xml:476 toolset_guide.xml:537 +#. Tag: para #, no-c-format msgid "read database properties from a file" msgstr "" -#. Tag: literal -#: toolset_guide.xml:345 +#. Tag: para #, no-c-format -msgid "--format" +msgid "<literal>--format</literal>" msgstr "" -#. Tag: entry -#: toolset_guide.xml:346 +#. Tag: para #, no-c-format msgid "format the generated SQL nicely in the script" msgstr "" -#. Tag: literal -#: toolset_guide.xml:349 +#. Tag: para #, no-c-format -msgid "--delimiter=;" +msgid "<literal>--delimiter=;</literal>" msgstr "" -#. Tag: entry -#: toolset_guide.xml:350 +#. Tag: para #, no-c-format msgid "set an end of line delimiter for the script" msgstr "" #. Tag: para -#: toolset_guide.xml:356 #, no-c-format msgid "You can even embed <literal>SchemaExport</literal> in your application:" msgstr "" -#. Tag: programlisting -#: toolset_guide.xml:360 -#, no-c-format -msgid "" - "<![CDATA[Configuration cfg = ....;\n" - "new SchemaExport(cfg).create(false, true);]]>" -msgstr "" - #. Tag: title -#: toolset_guide.xml:365 #, no-c-format msgid "Properties" msgstr "" #. Tag: para -#: toolset_guide.xml:367 #, no-c-format msgid "Database properties can be specified:" msgstr "" #. Tag: para -#: toolset_guide.xml:373 #, no-c-format msgid "as system properties with <literal>-D</literal><emphasis><property></emphasis>" msgstr "" #. Tag: para -#: toolset_guide.xml:376 #, no-c-format msgid "in <literal>hibernate.properties</literal>" msgstr "" #. Tag: para -#: toolset_guide.xml:379 #, no-c-format msgid "in a named properties file with <literal>--properties</literal>" msgstr "" #. Tag: para -#: toolset_guide.xml:383 #, no-c-format msgid "The needed properties are:" msgstr "" #. Tag: title -#: toolset_guide.xml:388 #, no-c-format msgid "SchemaExport Connection Properties" msgstr "" -#. Tag: entry -#: toolset_guide.xml:394 +#. Tag: para #, no-c-format msgid "Property Name" msgstr "" -#. Tag: literal -#: toolset_guide.xml:400 +#. Tag: para #, no-c-format -msgid "hibernate.connection.driver_class" +msgid "<literal>hibernate.connection.driver_class</literal>" msgstr "" -#. Tag: entry -#: toolset_guide.xml:401 +#. Tag: para #, no-c-format msgid "jdbc driver class" msgstr "" -#. Tag: literal -#: toolset_guide.xml:404 +#. Tag: para #, no-c-format -msgid "hibernate.connection.url" +msgid "<literal>hibernate.connection.url</literal>" msgstr "" -#. Tag: entry -#: toolset_guide.xml:405 +#. Tag: para #, no-c-format msgid "jdbc url" msgstr "" -#. Tag: literal -#: toolset_guide.xml:408 +#. Tag: para #, no-c-format -msgid "hibernate.connection.username" +msgid "<literal>hibernate.connection.username</literal>" msgstr "" -#. Tag: entry -#: toolset_guide.xml:409 +#. Tag: para #, no-c-format msgid "database user" msgstr "" -#. Tag: literal -#: toolset_guide.xml:412 +#. Tag: para #, no-c-format -msgid "hibernate.connection.password" +msgid "<literal>hibernate.connection.password</literal>" msgstr "" -#. Tag: entry -#: toolset_guide.xml:413 +#. Tag: para #, no-c-format msgid "user password" msgstr "" -#. Tag: literal -#: toolset_guide.xml:416 +#. Tag: para #, no-c-format -msgid "hibernate.dialect" +msgid "<literal>hibernate.dialect</literal>" msgstr "" -#. Tag: entry -#: toolset_guide.xml:417 +#. Tag: para #, no-c-format msgid "dialect" msgstr "" #. Tag: title -#: toolset_guide.xml:426 #, no-c-format msgid "Using Ant" msgstr "" #. Tag: para -#: toolset_guide.xml:428 #, no-c-format msgid "You can call <literal>SchemaExport</literal> from your Ant build script:" msgstr "" -#. Tag: programlisting -#: toolset_guide.xml:432 -#, no-c-format -msgid "" - "<![CDATA[<target name=\"schemaexport\">\n" - " <taskdef name=\"schemaexport\"\n" - " classname=\"org.hibernate.tool.hbm2ddl.SchemaExportTask\"\n" - " classpathref=\"class.path\"/>\n" - " \n" - " <schemaexport\n" - " properties=\"hibernate.properties\"\n" - " quiet=\"no\"\n" - " text=\"no\"\n" - " drop=\"no\"\n" - " delimiter=\";\"\n" - " output=\"schema-export.sql\">\n" - " <fileset dir=\"src\">\n" - " <include name=\"**/*.hbm.xml\"/>\n" - " </fileset>\n" - " </schemaexport>\n" - "</target>]]>" -msgstr "" - #. Tag: title -#: toolset_guide.xml:437 #, no-c-format msgid "Incremental schema updates" msgstr "" #. Tag: para -#: toolset_guide.xml:439 #, no-c-format msgid "The <literal>SchemaUpdate</literal> tool will update an existing schema with \"incremental\" changes. The <literal>SchemaUpdate</literal> depends upon the JDBC metadata API and, as such, will not work with all JDBC drivers." msgstr "" #. Tag: para -#: toolset_guide.xml:445 #, no-c-format msgid "<literal>java -cp </literal><emphasis>hibernate_classpaths</emphasis> <literal>org.hibernate.tool.hbm2ddl.SchemaUpdate</literal> <emphasis>options mapping_files</emphasis>" msgstr "" #. Tag: title -#: toolset_guide.xml:451 #, no-c-format msgid "<literal>SchemaUpdate</literal> Command Line Options" msgstr "" -#. Tag: entry -#: toolset_guide.xml:468 +#. Tag: para #, no-c-format msgid "do not export the script to the database" msgstr "" -#. Tag: entry -#: toolset_guide.xml:480 toolset_guide.xml:541 +#. Tag: para #, no-c-format msgid "specify a <literal>.cfg.xml</literal> file" msgstr "" #. Tag: para -#: toolset_guide.xml:486 #, no-c-format msgid "You can embed <literal>SchemaUpdate</literal> in your application:" msgstr "" -#. Tag: programlisting -#: toolset_guide.xml:490 -#, no-c-format -msgid "" - "<![CDATA[Configuration cfg = ....;\n" - "new SchemaUpdate(cfg).execute(false);]]>" -msgstr "" - #. Tag: title -#: toolset_guide.xml:495 #, no-c-format msgid "Using Ant for incremental schema updates" msgstr "" #. Tag: para -#: toolset_guide.xml:497 #, no-c-format msgid "You can call <literal>SchemaUpdate</literal> from the Ant script:" msgstr "" -#. Tag: programlisting -#: toolset_guide.xml:501 -#, no-c-format -msgid "" - "<![CDATA[<target name=\"schemaupdate\">\n" - " <taskdef name=\"schemaupdate\"\n" - " classname=\"org.hibernate.tool.hbm2ddl.SchemaUpdateTask\"\n" - " classpathref=\"class.path\"/>\n" - " \n" - " <schemaupdate\n" - " properties=\"hibernate.properties\"\n" - " quiet=\"no\">\n" - " <fileset dir=\"src\">\n" - " <include name=\"**/*.hbm.xml\"/>\n" - " </fileset>\n" - " </schemaupdate>\n" - "</target>]]>" -msgstr "" - #. Tag: title -#: toolset_guide.xml:506 #, no-c-format msgid "Schema validation" msgstr "" #. Tag: para -#: toolset_guide.xml:508 #, no-c-format msgid "The <literal>SchemaValidator</literal> tool will validate that the existing database schema \"matches\" your mapping documents. The <literal>SchemaValidator</literal> depends heavily upon the JDBC metadata API and, as such, will not work with all JDBC drivers. This tool is extremely useful for testing." msgstr "" #. Tag: para -#: toolset_guide.xml:514 #, no-c-format msgid "<literal>java -cp </literal><emphasis>hibernate_classpaths</emphasis> <literal>org.hibernate.tool.hbm2ddl.SchemaValidator</literal> <emphasis>options mapping_files</emphasis>" msgstr "" +#. Tag: para +#, no-c-format +msgid "The following table displays the <literal>SchemaValidator</literal> command line options:" +msgstr "" + #. Tag: title -#: toolset_guide.xml:520 #, no-c-format msgid "<literal>SchemaValidator</literal> Command Line Options" msgstr "" #. Tag: para -#: toolset_guide.xml:547 #, no-c-format msgid "You can embed <literal>SchemaValidator</literal> in your application:" msgstr "" -#. Tag: programlisting -#: toolset_guide.xml:551 -#, no-c-format -msgid "" - "<![CDATA[Configuration cfg = ....;\n" - "new SchemaValidator(cfg).validate();]]>" -msgstr "" - #. Tag: title -#: toolset_guide.xml:556 #, no-c-format msgid "Using Ant for schema validation" msgstr "" #. Tag: para -#: toolset_guide.xml:558 #, no-c-format msgid "You can call <literal>SchemaValidator</literal> from the Ant script:" msgstr "" -#. Tag: programlisting -#: toolset_guide.xml:562 -#, no-c-format -msgid "" - "<![CDATA[<target name=\"schemavalidate\">\n" - " <taskdef name=\"schemavalidator\"\n" - " classname=\"org.hibernate.tool.hbm2ddl.SchemaValidatorTask\"\n" - " classpathref=\"class.path\"/>\n" - " \n" - " <schemavalidator\n" - " properties=\"hibernate.properties\">\n" - " <fileset dir=\"src\">\n" - " <include name=\"**/*.hbm.xml\"/>\n" - " </fileset>\n" - " </schemavalidator>\n" - "</target>]]>" -msgstr "" - Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/transactions.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/transactions.pot 2010-02-08 04:50:03 UTC (rev 18716) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/transactions.pot 2010-02-08 04:56:55 UTC (rev 18717) @@ -1,960 +1,658 @@ -# SOME DESCRIPTIVE TITLE. -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. # -#, fuzzy msgid "" msgstr "" -"Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-10 21:02+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:20\n" +"PO-Revision-Date: 2010-01-08T04:07:20\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" "MIME-Version: 1.0\n" -"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Type: application/x-publican; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. Tag: title -#: transactions.xml:29 #, no-c-format msgid "Transactions and Concurrency" msgstr "" #. Tag: para -#: transactions.xml:31 #, no-c-format msgid "The most important point about Hibernate and concurrency control is that it is easy to understand. Hibernate directly uses JDBC connections and JTA resources without adding any additional locking behavior. It is recommended that you spend some time with the JDBC, ANSI, and transaction isolation specification of your database management system." msgstr "" #. Tag: para -#: transactions.xml:38 #, no-c-format msgid "Hibernate does not lock objects in memory. Your application can expect the behavior as defined by the isolation level of your database transactions. Through <literal>Session</literal>, which is also a transaction-scoped cache, Hibernate provides repeatable reads for lookup by identifier and entity queries and not reporting queries that return scalar values." msgstr "" #. Tag: para -#: transactions.xml:46 #, no-c-format msgid "In addition to versioning for automatic optimistic concurrency control, Hibernate also offers, using the <literal>SELECT FOR UPDATE</literal> syntax, a (minor) API for pessimistic locking of rows. Optimistic concurrency control and this API are discussed later in this chapter." msgstr "" #. Tag: para -#: transactions.xml:53 #, no-c-format msgid "The discussion of concurrency control in Hibernate begins with the granularity of <literal>Configuration</literal>, <literal>SessionFactory</literal>, and <literal>Session</literal>, as well as database transactions and long conversations." msgstr "" #. Tag: title -#: transactions.xml:60 #, no-c-format msgid "Session and transaction scopes" msgstr "" #. Tag: para -#: transactions.xml:62 #, no-c-format msgid "A <literal>SessionFactory</literal> is an expensive-to-create, threadsafe object, intended to be shared by all application threads. It is created once, usually on application startup, from a <literal>Configuration</literal> instance." msgstr "" #. Tag: para -#: transactions.xml:68 #, no-c-format msgid "A <literal>Session</literal> is an inexpensive, non-threadsafe object that should be used once and then discarded for: a single request, a conversation or a single unit of work. A <literal>Session</literal> will not obtain a JDBC <literal>Connection</literal>, or a <literal>Datasource</literal>, unless it is needed. It will not consume any resources until used." msgstr "" #. Tag: para -#: transactions.xml:76 #, no-c-format msgid "In order to reduce lock contention in the database, a database transaction has to be as short as possible. Long database transactions will prevent your application from scaling to a highly concurrent load. It is not recommended that you hold a database transaction open during user think time until the unit of work is complete." msgstr "" #. Tag: para -#: transactions.xml:84 #, no-c-format msgid "What is the scope of a unit of work? Can a single Hibernate <literal>Session</literal> span several database transactions, or is this a one-to-one relationship of scopes? When should you open and close a <literal>Session</literal> and how do you demarcate the database transaction boundaries? These questions are addressed in the following sections." msgstr "" #. Tag: title -#: transactions.xml:92 #, no-c-format msgid "Unit of work" msgstr "" #. Tag: para -#: transactions.xml:94 #, no-c-format -msgid "First, let's define a unit of work. A unit of work is a design pattern described by Martin Fowler as <quote> [maintaining] a list of objects affected by a business transaction and coordinates the writing out of changes and the resolution of concurrency problems. </quote><citation>PoEAA</citation> In other words, its a series of operations we wish to carry out against the database together. Basically, it is a transaction, though fulfilling a unit of work will often span multiple physical database transactions (see <xref linkend=\"transactions-basics-apptx\"/>). So really we are talking about a more abstract notion of a transaction. The term \"business transaction\" is also sometimes used in lieu of unit of work." +msgid "First, let's define a unit of work. A unit of work is a design pattern described by Martin Fowler as <quote> [maintaining] a list of objects affected by a business transaction and coordinates the writing out of changes and the resolution of concurrency problems. </quote><citation>PoEAA</citation> In other words, its a series of operations we wish to carry out against the database together. Basically, it is a transaction, though fulfilling a unit of work will often span multiple physical database transactions (see <xref linkend=\"transactions-basics-apptx\" />). So really we are talking about a more abstract notion of a transaction. The term \"business transaction\" is also sometimes used in lieu of unit of work." msgstr "" #. Tag: para -#: transactions.xml:111 #, no-c-format msgid "Do not use the <emphasis>session-per-operation</emphasis> antipattern: do not open and close a <literal>Session</literal> for every simple database call in a single thread. The same is true for database transactions. Database calls in an application are made using a planned sequence; they are grouped into atomic units of work. This also means that auto-commit after every single SQL statement is useless in an application as this mode is intended for ad-hoc SQL console work. Hibernate disables, or expects the application server to disable, auto-commit mode immediately. Database transactions are never optional. All communication with a database has to occur inside a transaction. Auto-commit behavior for reading data should be avoided, as many small transactions are unlikely to perform better than one clearly defined unit of work. The latter is also more maintainable and extensible." msgstr "" #. Tag: para -#: transactions.xml:126 #, no-c-format msgid "The most common pattern in a multi-user client/server application is <emphasis>session-per-request</emphasis>. In this model, a request from the client is sent to the server, where the Hibernate persistence layer runs. A new Hibernate <literal>Session</literal> is opened, and all database operations are executed in this unit of work. On completion of the work, and once the response for the client has been prepared, the session is flushed and closed. Use a single database transaction to serve the clients request, starting and committing it when you open and close the <literal>Session</literal>. The relationship between the two is one-to-one and this model is a perfect fit for many applications." msgstr "" #. Tag: para -#: transactions.xml:138 #, no-c-format msgid "The challenge lies in the implementation. Hibernate provides built-in management of the \"current session\" to simplify this pattern. Start a transaction when a server request has to be processed, and end the transaction before the response is sent to the client. Common solutions are <literal>ServletFilter</literal>, AOP interceptor with a pointcut on the service methods, or a proxy/interception container. An EJB container is a standardized way to implement cross-cutting aspects such as transaction demarcation on EJB session beans, declaratively with CMT. If you use programmatic transaction demarcation, for ease of use and code portability use the Hibernate <literal>Transaction</literal> API shown later in this chapter." msgstr "" #. Tag: para -#: transactions.xml:150 #, no-c-format -msgid "Your application code can access a \"current session\" to process the request by calling <literal>sessionFactory.getCurrentSession()</literal>. You will always get a <literal>Session</literal> scoped to the current database transaction. This has to be configured for either resource-local or JTA environments, see <xref linkend=\"architecture-current-session\"/>." +msgid "Your application code can access a \"current session\" to process the request by calling <literal>sessionFactory.getCurrentSession()</literal>. You will always get a <literal>Session</literal> scoped to the current database transaction. This has to be configured for either resource-local or JTA environments, see <xref linkend=\"architecture-current-session\" />." msgstr "" #. Tag: para -#: transactions.xml:158 #, no-c-format msgid "You can extend the scope of a <literal>Session</literal> and database transaction until the \"view has been rendered\". This is especially useful in servlet applications that utilize a separate rendering phase after the request has been processed. Extending the database transaction until view rendering, is achieved by implementing your own interceptor. However, this will be difficult if you rely on EJBs with container-managed transactions. A transaction will be completed when an EJB method returns, before rendering of any view can start. See the Hibernate website and forum for tips and examples relating to this <emphasis>Open Session in View</emphasis> pattern." msgstr "" #. Tag: title -#: transactions.xml:173 #, no-c-format msgid "Long conversations" msgstr "" #. Tag: para -#: transactions.xml:175 #, no-c-format msgid "The session-per-request pattern is not the only way of designing units of work. Many business processes require a whole series of interactions with the user that are interleaved with database accesses. In web and enterprise applications, it is not acceptable for a database transaction to span a user interaction. Consider the following example:" msgstr "" #. Tag: para -#: transactions.xml:185 #, no-c-format msgid "The first screen of a dialog opens. The data seen by the user has been loaded in a particular <literal>Session</literal> and database transaction. The user is free to modify the objects." msgstr "" #. Tag: para -#: transactions.xml:192 #, no-c-format msgid "The user clicks \"Save\" after 5 minutes and expects their modifications to be made persistent. The user also expects that they were the only person editing this information and that no conflicting modification has occurred." msgstr "" #. Tag: para -#: transactions.xml:200 #, no-c-format msgid "From the point of view of the user, we call this unit of work a long-running <emphasis>conversation</emphasis> or <emphasis>application transaction</emphasis>. There are many ways to implement this in your application." msgstr "" #. Tag: para -#: transactions.xml:206 #, no-c-format msgid "A first naive implementation might keep the <literal>Session</literal> and database transaction open during user think time, with locks held in the database to prevent concurrent modification and to guarantee isolation and atomicity. This is an anti-pattern, since lock contention would not allow the application to scale with the number of concurrent users." msgstr "" #. Tag: para -#: transactions.xml:214 #, no-c-format msgid "You have to use several database transactions to implement the conversation. In this case, maintaining isolation of business processes becomes the partial responsibility of the application tier. A single conversation usually spans several database transactions. It will be atomic if only one of these database transactions (the last one) stores the updated data. All others simply read data (for example, in a wizard-style dialog spanning several request/response cycles). This is easier to implement than it might sound, especially if you utilize some of Hibernate's features:" msgstr "" #. Tag: para -#: transactions.xml:227 #, no-c-format msgid "<emphasis>Automatic Versioning</emphasis>: Hibernate can perform automatic optimistic concurrency control for you. It can automatically detect if a concurrent modification occurred during user think time. Check for this at the end of the conversation." msgstr "" #. Tag: para -#: transactions.xml:235 #, no-c-format msgid "<emphasis>Detached Objects</emphasis>: if you decide to use the <emphasis>session-per-request</emphasis> pattern, all loaded instances will be in the detached state during user think time. Hibernate allows you to reattach the objects and persist the modifications. The pattern is called <emphasis>session-per-request-with-detached-objects</emphasis>. Automatic versioning is used to isolate concurrent modifications." msgstr "" #. Tag: para -#: transactions.xml:245 #, no-c-format msgid "<emphasis>Extended (or Long) Session</emphasis>: the Hibernate <literal>Session</literal> can be disconnected from the underlying JDBC connection after the database transaction has been committed and reconnected when a new client request occurs. This pattern is known as <emphasis>session-per-conversation</emphasis> and makes even reattachment unnecessary. Automatic versioning is used to isolate concurrent modifications and the <literal>Session</literal> will not be allowed to be flushed automatically, but explicitly." msgstr "" #. Tag: para -#: transactions.xml:258 #, no-c-format msgid "Both <emphasis>session-per-request-with-detached-objects</emphasis> and <emphasis>session-per-conversation</emphasis> have advantages and disadvantages. These disadvantages are discussed later in this chapter in the context of optimistic concurrency control." msgstr "" #. Tag: title -#: transactions.xml:267 #, no-c-format msgid "Considering object identity" msgstr "" #. Tag: para -#: transactions.xml:269 #, no-c-format msgid "An application can concurrently access the same persistent state in two different <literal>Session</literal>s. However, an instance of a persistent class is never shared between two <literal>Session</literal> instances. It is for this reason that there are two different notions of identity:" msgstr "" #. Tag: term -#: transactions.xml:278 #, no-c-format msgid "Database Identity" msgstr "" -#. Tag: literal -#: transactions.xml:281 +#. Tag: para #, no-c-format -msgid "foo.getId().equals( bar.getId() )" +msgid "<literal>foo.getId().equals( bar.getId() )</literal>" msgstr "" #. Tag: term -#: transactions.xml:286 #, no-c-format msgid "JVM Identity" msgstr "" -#. Tag: literal -#: transactions.xml:289 +#. Tag: para #, no-c-format -msgid "foo==bar" +msgid "<literal>foo==bar</literal>" msgstr "" #. Tag: para -#: transactions.xml:295 #, no-c-format msgid "For objects attached to a <emphasis>particular</emphasis> <literal>Session</literal> (i.e., in the scope of a <literal>Session</literal>), the two notions are equivalent and JVM identity for database identity is guaranteed by Hibernate. While the application might concurrently access the \"same\" (persistent identity) business object in two different sessions, the two instances will actually be \"different\" (JVM identity). Conflicts are resolved using an optimistic approach and automatic versioning at flush/commit time." msgstr "" #. Tag: para -#: transactions.xml:304 #, no-c-format msgid "This approach leaves Hibernate and the database to worry about concurrency. It also provides the best scalability, since guaranteeing identity in single-threaded units of work means that it does not need expensive locking or other means of synchronization. The application does not need to synchronize on any business object, as long as it maintains a single thread per <literal>Session</literal>. Within a <literal>Session</literal> the application can safely use <literal>==</literal> to compare objects." msgstr "" #. Tag: para -#: transactions.xml:313 #, no-c-format msgid "However, an application that uses <literal>==</literal> outside of a <literal>Session</literal> might produce unexpected results. This might occur even in some unexpected places. For example, if you put two detached instances into the same <literal>Set</literal>, both might have the same database identity (i.e., they represent the same row). JVM identity, however, is by definition not guaranteed for instances in a detached state. The developer has to override the <literal>equals()</literal> and <literal>hashCode()</literal> methods in persistent classes and implement their own notion of object equality. There is one caveat: never use the database identifier to implement equality. Use a business key that is a combination of unique, usually immutable, attributes. The database identifier will change if a transient object is made persistent. If the transient instance (usually together with detached instances) is held in a <literal>Set</literal>, changing the hashcode bre! aks the contract of the <literal>Set</literal>. Attributes for business keys do not have to be as stable as database primary keys; you only have to guarantee stability as long as the objects are in the same <literal>Set</literal>. See the Hibernate website for a more thorough discussion of this issue. Please note that this is not a Hibernate issue, but simply how Java object identity and equality has to be implemented." msgstr "" #. Tag: title -#: transactions.xml:334 #, no-c-format msgid "Common issues" msgstr "" #. Tag: para -#: transactions.xml:336 #, no-c-format msgid "Do not use the anti-patterns <emphasis>session-per-user-session</emphasis> or <emphasis>session-per-application</emphasis> (there are, however, rare exceptions to this rule). Some of the following issues might also arise within the recommended patterns, so ensure that you understand the implications before making a design decision:" msgstr "" #. Tag: para -#: transactions.xml:345 #, no-c-format msgid "A <literal>Session</literal> is not thread-safe. Things that work concurrently, like HTTP requests, session beans, or Swing workers, will cause race conditions if a <literal>Session</literal> instance is shared. If you keep your Hibernate <literal>Session</literal> in your <literal>HttpSession</literal> (this is discussed later in the chapter), you should consider synchronizing access to your Http session. Otherwise, a user that clicks reload fast enough can use the same <literal>Session</literal> in two concurrently running threads." msgstr "" #. Tag: para -#: transactions.xml:356 #, no-c-format msgid "An exception thrown by Hibernate means you have to rollback your database transaction and close the <literal>Session</literal> immediately (this is discussed in more detail later in the chapter). If your <literal>Session</literal> is bound to the application, you have to stop the application. Rolling back the database transaction does not put your business objects back into the state they were at the start of the transaction. This means that the database state and the business objects will be out of sync. Usually this is not a problem, because exceptions are not recoverable and you will have to start over after rollback anyway." msgstr "" #. Tag: para -#: transactions.xml:368 #, no-c-format -msgid "The <literal>Session</literal> caches every object that is in a persistent state (watched and checked for dirty state by Hibernate). If you keep it open for a long time or simply load too much data, it will grow endlessly until you get an OutOfMemoryException. One solution is to call <literal>clear()</literal> and <literal>evict()</literal> to manage the <literal>Session</literal> cache, but you should consider a Stored Procedure if you need mass data operations. Some solutions are shown in <xref linkend=\"batch\"/>. Keeping a <literal>Session</literal> open for the duration of a user session also means a higher probability of stale data." +msgid "The <literal>Session</literal> caches every object that is in a persistent state (watched and checked for dirty state by Hibernate). If you keep it open for a long time or simply load too much data, it will grow endlessly until you get an OutOfMemoryException. One solution is to call <literal>clear()</literal> and <literal>evict()</literal> to manage the <literal>Session</literal> cache, but you should consider a Stored Procedure if you need mass data operations. Some solutions are shown in <xref linkend=\"batch\" />. Keeping a <literal>Session</literal> open for the duration of a user session also means a higher probability of stale data." msgstr "" #. Tag: title -#: transactions.xml:386 #, no-c-format msgid "Database transaction demarcation" msgstr "" #. Tag: para -#: transactions.xml:388 #, no-c-format msgid "Database, or system, transaction boundaries are always necessary. No communication with the database can occur outside of a database transaction (this seems to confuse many developers who are used to the auto-commit mode). Always use clear transaction boundaries, even for read-only operations. Depending on your isolation level and database capabilities this might not be required, but there is no downside if you always demarcate transactions explicitly. Certainly, a single database transaction is going to perform better than many small transactions, even for reading data." msgstr "" #. Tag: para -#: transactions.xml:398 #, no-c-format msgid "A Hibernate application can run in non-managed (i.e., standalone, simple Web- or Swing applications) and managed J2EE environments. In a non-managed environment, Hibernate is usually responsible for its own database connection pool. The application developer has to manually set transaction boundaries (begin, commit, or rollback database transactions) themselves. A managed environment usually provides container-managed transactions (CMT), with the transaction assembly defined declaratively (in deployment descriptors of EJB session beans, for example). Programmatic transaction demarcation is then no longer necessary." msgstr "" #. Tag: para -#: transactions.xml:408 #, no-c-format msgid "However, it is often desirable to keep your persistence layer portable between non-managed resource-local environments, and systems that can rely on JTA but use BMT instead of CMT. In both cases use programmatic transaction demarcation. Hibernate offers a wrapper API called <literal>Transaction</literal> that translates into the native transaction system of your deployment environment. This API is actually optional, but we strongly encourage its use unless you are in a CMT session bean." msgstr "" #. Tag: para -#: transactions.xml:417 #, no-c-format msgid "Ending a <literal>Session</literal> usually involves four distinct phases:" msgstr "" #. Tag: para -#: transactions.xml:423 #, no-c-format msgid "flush the session" msgstr "" #. Tag: para -#: transactions.xml:428 #, no-c-format msgid "commit the transaction" msgstr "" #. Tag: para -#: transactions.xml:433 #, no-c-format msgid "close the session" msgstr "" #. Tag: para -#: transactions.xml:438 #, no-c-format msgid "handle exceptions" msgstr "" #. Tag: para -#: transactions.xml:444 #, no-c-format msgid "We discussed Flushing the session earlier, so we will now have a closer look at transaction demarcation and exception handling in both managed and non-managed environments." msgstr "" #. Tag: title -#: transactions.xml:451 #, no-c-format msgid "Non-managed environment" msgstr "" #. Tag: para -#: transactions.xml:453 #, no-c-format msgid "If a Hibernate persistence layer runs in a non-managed environment, database connections are usually handled by simple (i.e., non-DataSource) connection pools from which Hibernate obtains connections as needed. The session/transaction handling idiom looks like this:" msgstr "" -#. Tag: programlisting -#: transactions.xml:460 -#, no-c-format -msgid "" - "<![CDATA[// Non-managed environment idiom\n" - "Session sess = factory.openSession();\n" - "Transaction tx = null;\n" - "try {\n" - " tx = sess.beginTransaction();\n" - "\n" - " // do some work\n" - " ...\n" - "\n" - " tx.commit();\n" - "}\n" - "catch (RuntimeException e) {\n" - " if (tx != null) tx.rollback();\n" - " throw e; // or display error message\n" - "}\n" - "finally {\n" - " sess.close();\n" - "}]]>" -msgstr "" - #. Tag: para -#: transactions.xml:462 #, no-c-format -msgid "You do not have to <literal>flush()</literal> the <literal>Session</literal> explicitly: the call to <literal>commit()</literal> automatically triggers the synchronization depending on the <link linkend=\"objectstate-flushing\">FlushMode</link> for the session. A call to <literal>close()</literal> marks the end of a session. The main implication of <literal>close()</literal> is that the JDBC connection will be relinquished by the session. This Java code is portable and runs in both non-managed and JTA environments." +msgid "You do not have to <literal>flush()</literal> the <literal>Session</literal> explicitly: the call to <literal>commit()</literal> automatically triggers the synchronization depending on the FlushMode for the session (see <xref linkend=\"objectstate-flushing\" />). A call to <literal>close()</literal> marks the end of a session. The main implication of <literal>close()</literal> is that the JDBC connection will be relinquished by the session. This Java code is portable and runs in both non-managed and JTA environments." msgstr "" #. Tag: para -#: transactions.xml:471 #, no-c-format msgid "As outlined earlier, a much more flexible solution is Hibernate's built-in \"current session\" context management:" msgstr "" -#. Tag: programlisting -#: transactions.xml:476 -#, no-c-format -msgid "" - "<![CDATA[// Non-managed environment idiom with getCurrentSession()\n" - "try {\n" - " factory.getCurrentSession().beginTransaction();\n" - "\n" - " // do some work\n" - " ...\n" - "\n" - " factory.getCurrentSession().getTransaction().commit();\n" - "}\n" - "catch (RuntimeException e) {\n" - " factory.getCurrentSession().getTransaction().rollback();\n" - " throw e; // or display error message\n" - "}]]>" -msgstr "" - #. Tag: para -#: transactions.xml:478 #, no-c-format msgid "You will not see these code snippets in a regular application; fatal (system) exceptions should always be caught at the \"top\". In other words, the code that executes Hibernate calls in the persistence layer, and the code that handles <literal>RuntimeException</literal> (and usually can only clean up and exit), are in different layers. The current context management by Hibernate can significantly simplify this design by accessing a <literal>SessionFactory</literal>. Exception handling is discussed later in this chapter." msgstr "" #. Tag: para -#: transactions.xml:488 #, no-c-format msgid "You should select <literal>org.hibernate.transaction.JDBCTransactionFactory</literal>, which is the default, and for the second example select <literal>\"thread\"</literal> as your <literal>hibernate.current_session_context_class</literal>." msgstr "" #. Tag: title -#: transactions.xml:497 #, no-c-format msgid "Using JTA" msgstr "" #. Tag: para -#: transactions.xml:499 #, no-c-format msgid "If your persistence layer runs in an application server (for example, behind EJB session beans), every datasource connection obtained by Hibernate will automatically be part of the global JTA transaction. You can also install a standalone JTA implementation and use it without EJB. Hibernate offers two strategies for JTA integration." msgstr "" #. Tag: para -#: transactions.xml:506 #, no-c-format msgid "If you use bean-managed transactions (BMT), Hibernate will tell the application server to start and end a BMT transaction if you use the <literal>Transaction</literal> API. The transaction management code is identical to the non-managed environment." msgstr "" -#. Tag: programlisting -#: transactions.xml:512 -#, no-c-format -msgid "" - "<![CDATA[// BMT idiom\n" - "Session sess = factory.openSession();\n" - "Transaction tx = null;\n" - "try {\n" - " tx = sess.beginTransaction();\n" - "\n" - " // do some work\n" - " ...\n" - "\n" - " tx.commit();\n" - "}\n" - "catch (RuntimeException e) {\n" - " if (tx != null) tx.rollback();\n" - " throw e; // or display error message\n" - "}\n" - "finally {\n" - " sess.close();\n" - "}]]>" -msgstr "" - #. Tag: para -#: transactions.xml:514 #, no-c-format msgid "If you want to use a transaction-bound <literal>Session</literal>, that is, the <literal>getCurrentSession()</literal> functionality for easy context propagation, use the JTA <literal>UserTransaction</literal> API directly:" msgstr "" -#. Tag: programlisting -#: transactions.xml:520 -#, no-c-format -msgid "" - "<![CDATA[// BMT idiom with getCurrentSession()\n" - "try {\n" - " UserTransaction tx = (UserTransaction)new InitialContext()\n" - " .lookup(\"java:comp/UserTransaction\");\n" - "\n" - " tx.begin();\n" - "\n" - " // Do some work on Session bound to transaction\n" - " factory.getCurrentSession().load(...);\n" - " factory.getCurrentSession().persist(...);\n" - "\n" - " tx.commit();\n" - "}\n" - "catch (RuntimeException e) {\n" - " tx.rollback();\n" - " throw e; // or display error message\n" - "}]]>" -msgstr "" - #. Tag: para -#: transactions.xml:522 #, no-c-format msgid "With CMT, transaction demarcation is completed in session bean deployment descriptors, not programmatically. The code is reduced to:" msgstr "" -#. Tag: programlisting -#: transactions.xml:527 -#, no-c-format -msgid "" - "<![CDATA[// CMT idiom\n" - " Session sess = factory.getCurrentSession();\n" - "\n" - " // do some work\n" - " ...\n" - "]]>" -msgstr "" - #. Tag: para -#: transactions.xml:529 #, no-c-format msgid "In a CMT/EJB, even rollback happens automatically. An unhandled <literal>RuntimeException</literal> thrown by a session bean method tells the container to set the global transaction to rollback. <emphasis>You do not need to use the Hibernate <literal>Transaction</literal> API at all with BMT or CMT, and you get automatic propagation of the \"current\" Session bound to the transaction.</emphasis>" msgstr "" #. Tag: para -#: transactions.xml:537 #, no-c-format msgid "When configuring Hibernate's transaction factory, choose <literal>org.hibernate.transaction.JTATransactionFactory</literal> if you use JTA directly (BMT), and <literal>org.hibernate.transaction.CMTTransactionFactory</literal> in a CMT session bean. Remember to also set <literal>hibernate.transaction.manager_lookup_class</literal>. Ensure that your <literal>hibernate.current_session_context_class</literal> is either unset (backwards compatibility), or is set to <literal>\"jta\"</literal>." msgstr "" #. Tag: para -#: transactions.xml:546 #, no-c-format msgid "The <literal>getCurrentSession()</literal> operation has one downside in a JTA environment. There is one caveat to the use of <literal>after_statement</literal> connection release mode, which is then used by default. Due to a limitation of the JTA spec, it is not possible for Hibernate to automatically clean up any unclosed <literal>ScrollableResults</literal> or <literal>Iterator</literal> instances returned by <literal>scroll()</literal> or <literal>iterate()</literal>. You <emphasis>must</emphasis> release the underlying database cursor by calling <literal>ScrollableResults.close()</literal> or <literal>Hibernate.close(Iterator)</literal> explicitly from a <literal>finally</literal> block. Most applications can easily avoid using <literal>scroll()</literal> or <literal>iterate()</literal> from the JTA or CMT code.)" msgstr "" #. Tag: title -#: transactions.xml:562 #, no-c-format msgid "Exception handling" msgstr "" #. Tag: para -#: transactions.xml:564 #, no-c-format msgid "If the <literal>Session</literal> throws an exception, including any <literal>SQLException</literal>, immediately rollback the database transaction, call <literal>Session.close()</literal> and discard the <literal>Session</literal> instance. Certain methods of <literal>Session</literal> will <emphasis>not</emphasis> leave the session in a consistent state. No exception thrown by Hibernate can be treated as recoverable. Ensure that the <literal>Session</literal> will be closed by calling <literal>close()</literal> in a <literal>finally</literal> block." msgstr "" #. Tag: para -#: transactions.xml:575 #, no-c-format msgid "The <literal>HibernateException</literal>, which wraps most of the errors that can occur in a Hibernate persistence layer, is an unchecked exception. It was not in older versions of Hibernate. In our opinion, we should not force the application developer to catch an unrecoverable exception at a low layer. In most systems, unchecked and fatal exceptions are handled in one of the first frames of the method call stack (i.e., in higher layers) and either an error message is presented to the application user or some other appropriate action is taken. Note that Hibernate might also throw other unchecked exceptions that are not a <literal>HibernateException</literal>. These are not recoverable and appropriate action should be taken." msgstr "" #. Tag: para -#: transactions.xml:587 #, no-c-format msgid "Hibernate wraps <literal>SQLException</literal>s thrown while interacting with the database in a <literal>JDBCException</literal>. In fact, Hibernate will attempt to convert the exception into a more meaningful subclass of <literal>JDBCException</literal>. The underlying <literal>SQLException</literal> is always available via <literal>JDBCException.getCause()</literal>. Hibernate converts the <literal>SQLException</literal> into an appropriate <literal>JDBCException</literal> subclass using the <literal>SQLExceptionConverter</literal> attached to the <literal>SessionFactory</literal>. By default, the <literal>SQLExceptionConverter</literal> is defined by the configured dialect. However, it is also possible to plug in a custom implementation. See the javadocs for the <literal>SQLExceptionConverterFactory</literal> class for details. The standard <literal>JDBCException</literal> subtypes are:" msgstr "" #. Tag: para -#: transactions.xml:603 #, no-c-format msgid "<literal>JDBCConnectionException</literal>: indicates an error with the underlying JDBC communication." msgstr "" #. Tag: para -#: transactions.xml:609 #, no-c-format msgid "<literal>SQLGrammarException</literal>: indicates a grammar or syntax problem with the issued SQL." msgstr "" #. Tag: para -#: transactions.xml:615 #, no-c-format msgid "<literal>ConstraintViolationException</literal>: indicates some form of integrity constraint violation." msgstr "" #. Tag: para -#: transactions.xml:621 #, no-c-format msgid "<literal>LockAcquisitionException</literal>: indicates an error acquiring a lock level necessary to perform the requested operation." msgstr "" #. Tag: para -#: transactions.xml:627 #, no-c-format msgid "<literal>GenericJDBCException</literal>: a generic exception which did not fall into any of the other categories." msgstr "" #. Tag: title -#: transactions.xml:637 #, no-c-format msgid "Transaction timeout" msgstr "" #. Tag: para -#: transactions.xml:639 #, no-c-format msgid "An important feature provided by a managed environment like EJB, that is never provided for non-managed code, is transaction timeout. Transaction timeouts ensure that no misbehaving transaction can indefinitely tie up resources while returning no response to the user. Outside a managed (JTA) environment, Hibernate cannot fully provide this functionality. However, Hibernate can at least control data access operations, ensuring that database level deadlocks and queries with huge result sets are limited by a defined timeout. In a managed environment, Hibernate can delegate transaction timeout to JTA. This functionality is abstracted by the Hibernate <literal>Transaction</literal> object." msgstr "" -#. Tag: programlisting -#: transactions.xml:652 -#, no-c-format -msgid "" - "<![CDATA[\n" - "Session sess = factory.openSession();\n" - "try {\n" - " //set transaction timeout to 3 seconds\n" - " sess.getTransaction().setTimeout(3);\n" - " sess.getTransaction().begin();\n" - "\n" - " // do some work\n" - " ...\n" - "\n" - " sess.getTransaction().commit()\n" - "}\n" - "catch (RuntimeException e) {\n" - " sess.getTransaction().rollback();\n" - " throw e; // or display error message\n" - "}\n" - "finally {\n" - " sess.close();\n" - "}]]>" -msgstr "" - #. Tag: para -#: transactions.xml:654 #, no-c-format msgid "<literal>setTimeout()</literal> cannot be called in a CMT bean, where transaction timeouts must be defined declaratively." msgstr "" #. Tag: title -#: transactions.xml:664 #, no-c-format msgid "Optimistic concurrency control" msgstr "" #. Tag: para -#: transactions.xml:666 #, no-c-format msgid "The only approach that is consistent with high concurrency and high scalability, is optimistic concurrency control with versioning. Version checking uses version numbers, or timestamps, to detect conflicting updates and to prevent lost updates. Hibernate provides three possible approaches to writing application code that uses optimistic concurrency. The use cases we discuss are in the context of long conversations, but version checking also has the benefit of preventing lost updates in single database transactions." msgstr "" #. Tag: title -#: transactions.xml:677 #, no-c-format msgid "Application version checking" msgstr "" #. Tag: para -#: transactions.xml:679 #, no-c-format msgid "In an implementation without much help from Hibernate, each interaction with the database occurs in a new <literal>Session</literal> and the developer is responsible for reloading all persistent instances from the database before manipulating them. The application is forced to carry out its own version checking to ensure conversation transaction isolation. This approach is the least efficient in terms of database access. It is the approach most similar to entity EJBs." msgstr "" -#. Tag: programlisting -#: transactions.xml:688 -#, no-c-format -msgid "" - "<![CDATA[// foo is an instance loaded by a previous Session\n" - "session = factory.openSession();\n" - "Transaction t = session.beginTransaction();\n" - "\n" - "int oldVersion = foo.getVersion();\n" - "session.load( foo, foo.getKey() ); // load the current state\n" - "if ( oldVersion != foo.getVersion() ) throw new StaleObjectStateException();\n" - "foo.setProperty(\"bar\");\n" - "\n" - "t.commit();\n" - "session.close();]]>" -msgstr "" - #. Tag: para -#: transactions.xml:690 #, no-c-format msgid "The <literal>version</literal> property is mapped using <literal><version></literal>, and Hibernate will automatically increment it during flush if the entity is dirty." msgstr "" #. Tag: para -#: transactions.xml:696 #, no-c-format msgid "If you are operating in a low-data-concurrency environment, and do not require version checking, you can use this approach and skip the version check. In this case, <emphasis>last commit wins</emphasis> is the default strategy for long conversations. Be aware that this might confuse the users of the application, as they might experience lost updates without error messages or a chance to merge conflicting changes." msgstr "" #. Tag: para -#: transactions.xml:705 #, no-c-format msgid "Manual version checking is only feasible in trivial circumstances and not practical for most applications. Often not only single instances, but complete graphs of modified objects, have to be checked. Hibernate offers automatic version checking with either an extended <literal>Session</literal> or detached instances as the design paradigm." msgstr "" #. Tag: title -#: transactions.xml:716 #, no-c-format msgid "Extended session and automatic versioning" msgstr "" #. Tag: para -#: transactions.xml:718 #, no-c-format msgid "A single <literal>Session</literal> instance and its persistent instances that are used for the whole conversation are known as <emphasis>session-per-conversation</emphasis>. Hibernate checks instance versions at flush time, throwing an exception if concurrent modification is detected. It is up to the developer to catch and handle this exception. Common options are the opportunity for the user to merge changes or to restart the business conversation with non-stale data." msgstr "" #. Tag: para -#: transactions.xml:727 #, no-c-format msgid "The <literal>Session</literal> is disconnected from any underlying JDBC connection when waiting for user interaction. This approach is the most efficient in terms of database access. The application does not version check or reattach detached instances, nor does it have to reload instances in every database transaction." msgstr "" -#. Tag: programlisting -#: transactions.xml:735 -#, no-c-format -msgid "" - "<![CDATA[// foo is an instance loaded earlier by the old session\n" - "Transaction t = session.beginTransaction(); // Obtain a new JDBC connection, start transaction\n" - "\n" - "foo.setProperty(\"bar\");\n" - "\n" - "session.flush(); // Only for last transaction in conversation\n" - "t.commit(); // Also return JDBC connection\n" - "session.close(); // Only for last transaction in conversation]]>" -msgstr "" - #. Tag: para -#: transactions.xml:736 #, no-c-format msgid "The <literal>foo</literal> object knows which <literal>Session</literal> it was loaded in. Beginning a new database transaction on an old session obtains a new connection and resumes the session. Committing a database transaction disconnects a session from the JDBC connection and returns the connection to the pool. After reconnection, to force a version check on data you are not updating, you can call <literal>Session.lock()</literal> with <literal>LockMode.READ</literal> on any objects that might have been updated by another transaction. You do not need to lock any data that you <emphasis>are</emphasis> updating. Usually you would set <literal>FlushMode.MANUAL</literal> on an extended <literal>Session</literal>, so that only the last database transaction cycle is allowed to actually persist all modifications made in this conversation. Only this last database transaction will include the <literal>flush()</literal> operation, and then <literal>close()</literal> the se! ssion to end the conversation." msgstr "" #. Tag: para -#: transactions.xml:751 #, no-c-format msgid "This pattern is problematic if the <literal>Session</literal> is too big to be stored during user think time (for example, an <literal>HttpSession</literal> should be kept as small as possible). As the <literal>Session</literal> is also the first-level cache and contains all loaded objects, we can probably use this strategy only for a few request/response cycles. Use a <literal>Session</literal> only for a single conversation as it will soon have stale data." msgstr "" #. Tag: title -#: transactions.xml:762 #, no-c-format msgid "Note" msgstr "" #. Tag: para -#: transactions.xml:763 #, no-c-format msgid "Earlier versions of Hibernate required explicit disconnection and reconnection of a <literal>Session</literal>. These methods are deprecated, as beginning and ending a transaction has the same effect." msgstr "" #. Tag: para -#: transactions.xml:769 #, no-c-format msgid "Keep the disconnected <literal>Session</literal> close to the persistence layer. Use an EJB stateful session bean to hold the <literal>Session</literal> in a three-tier environment. Do not transfer it to the web layer, or even serialize it to a separate tier, to store it in the <literal>HttpSession</literal>." msgstr "" #. Tag: para -#: transactions.xml:777 #, no-c-format msgid "The extended session pattern, or <emphasis>session-per-conversation</emphasis>, is more difficult to implement with automatic current session context management. You need to supply your own implementation of the <literal>CurrentSessionContext</literal> for this. See the Hibernate Wiki for examples." msgstr "" #. Tag: title -#: transactions.xml:787 #, no-c-format msgid "Detached objects and automatic versioning" msgstr "" #. Tag: para -#: transactions.xml:789 #, no-c-format msgid "Each interaction with the persistent store occurs in a new <literal>Session</literal>. However, the same persistent instances are reused for each interaction with the database. The application manipulates the state of detached instances originally loaded in another <literal>Session</literal> and then reattaches them using <literal>Session.update()</literal>, <literal>Session.saveOrUpdate()</literal>, or <literal>Session.merge()</literal>." msgstr "" -#. Tag: programlisting -#: transactions.xml:797 -#, no-c-format -msgid "" - "<![CDATA[// foo is an instance loaded by a previous Session\n" - "foo.setProperty(\"bar\");\n" - "session = factory.openSession();\n" - "Transaction t = session.beginTransaction();\n" - "session.saveOrUpdate(foo); // Use merge() if \"foo\" might have been loaded already\n" - "t.commit();\n" - "session.close();]]>" -msgstr "" - #. Tag: para -#: transactions.xml:799 #, no-c-format msgid "Again, Hibernate will check instance versions during flush, throwing an exception if conflicting updates occurred." msgstr "" #. Tag: para -#: transactions.xml:804 #, no-c-format msgid "You can also call <literal>lock()</literal> instead of <literal>update()</literal>, and use <literal>LockMode.READ</literal> (performing a version check and bypassing all caches) if you are sure that the object has not been modified." msgstr "" #. Tag: title -#: transactions.xml:813 #, no-c-format msgid "Customizing automatic versioning" msgstr "" #. Tag: para -#: transactions.xml:815 #, no-c-format msgid "You can disable Hibernate's automatic version increment for particular properties and collections by setting the <literal>optimistic-lock</literal> mapping attribute to <literal>false</literal>. Hibernate will then no longer increment versions if the property is dirty." msgstr "" #. Tag: para -#: transactions.xml:822 #, no-c-format msgid "Legacy database schemas are often static and cannot be modified. Or, other applications might access the same database and will not know how to handle version numbers or even timestamps. In both cases, versioning cannot rely on a particular column in a table. To force a version check with a comparison of the state of all fields in a row but without a version or timestamp property mapping, turn on <literal>optimistic-lock=\"all\"</literal> in the <literal><class></literal> mapping. This conceptually only works if Hibernate can compare the old and the new state (i.e., if you use a single long <literal>Session</literal> and not session-per-request-with-detached-objects)." msgstr "" #. Tag: para -#: transactions.xml:834 #, no-c-format msgid "Concurrent modification can be permitted in instances where the changes that have been made do not overlap. If you set <literal>optimistic-lock=\"dirty\"</literal> when mapping the <literal><class></literal>, Hibernate will only compare dirty fields during flush." msgstr "" #. Tag: para -#: transactions.xml:840 #, no-c-format msgid "In both cases, with dedicated version/timestamp columns or with a full/dirty field comparison, Hibernate uses a single <literal>UPDATE</literal> statement, with an appropriate <literal>WHERE</literal> clause, per entity to execute the version check and update the information. If you use transitive persistence to cascade reattachment to associated entities, Hibernate may execute unnecessary updates. This is usually not a problem, but <emphasis>on update</emphasis> triggers in the database might be executed even when no changes have been made to detached instances. You can customize this behavior by setting <literal>select-before-update=\"true\"</literal> in the <literal><class></literal> mapping, forcing Hibernate to <literal>SELECT</literal> the instance to ensure that changes did occur before updating the row." msgstr "" #. Tag: title -#: transactions.xml:858 #, no-c-format msgid "Pessimistic locking" msgstr "" #. Tag: para -#: transactions.xml:860 #, no-c-format msgid "It is not intended that users spend much time worrying about locking strategies. It is usually enough to specify an isolation level for the JDBC connections and then simply let the database do all the work. However, advanced users may wish to obtain exclusive pessimistic locks or re-obtain locks at the start of a new transaction." msgstr "" #. Tag: para -#: transactions.xml:867 #, no-c-format msgid "Hibernate will always use the locking mechanism of the database; it never lock objects in memory." msgstr "" #. Tag: para -#: transactions.xml:872 #, no-c-format msgid "The <literal>LockMode</literal> class defines the different lock levels that can be acquired by Hibernate. A lock is obtained by the following mechanisms:" msgstr "" #. Tag: para -#: transactions.xml:879 #, no-c-format msgid "<literal>LockMode.WRITE</literal> is acquired automatically when Hibernate updates or inserts a row." msgstr "" #. Tag: para -#: transactions.xml:885 #, no-c-format msgid "<literal>LockMode.UPGRADE</literal> can be acquired upon explicit user request using <literal>SELECT ... FOR UPDATE</literal> on databases which support that syntax." msgstr "" #. Tag: para -#: transactions.xml:891 #, no-c-format msgid "<literal>LockMode.UPGRADE_NOWAIT</literal> can be acquired upon explicit user request using a <literal>SELECT ... FOR UPDATE NOWAIT</literal> under Oracle." msgstr "" #. Tag: para -#: transactions.xml:897 #, no-c-format msgid "<literal>LockMode.READ</literal> is acquired automatically when Hibernate reads data under Repeatable Read or Serializable isolation level. It can be re-acquired by explicit user request." msgstr "" #. Tag: para -#: transactions.xml:904 #, no-c-format msgid "<literal>LockMode.NONE</literal> represents the absence of a lock. All objects switch to this lock mode at the end of a <literal>Transaction</literal>. Objects associated with the session via a call to <literal>update()</literal> or <literal>saveOrUpdate()</literal> also start out in this lock mode." msgstr "" #. Tag: para -#: transactions.xml:913 #, no-c-format msgid "The \"explicit user request\" is expressed in one of the following ways:" msgstr "" #. Tag: para -#: transactions.xml:919 #, no-c-format msgid "A call to <literal>Session.load()</literal>, specifying a <literal>LockMode</literal>." msgstr "" #. Tag: para -#: transactions.xml:924 #, no-c-format msgid "A call to <literal>Session.lock()</literal>." msgstr "" #. Tag: para -#: transactions.xml:929 #, no-c-format msgid "A call to <literal>Query.setLockMode()</literal>." msgstr "" #. Tag: para -#: transactions.xml:935 #, no-c-format msgid "If <literal>Session.load()</literal> is called with <literal>UPGRADE</literal> or <literal>UPGRADE_NOWAIT</literal>, and the requested object was not yet loaded by the session, the object is loaded using <literal>SELECT ... FOR UPDATE</literal>. If <literal>load()</literal> is called for an object that is already loaded with a less restrictive lock than the one requested, Hibernate calls <literal>lock()</literal> for that object." msgstr "" #. Tag: para -#: transactions.xml:944 #, no-c-format msgid "<literal>Session.lock()</literal> performs a version number check if the specified lock mode is <literal>READ</literal>, <literal>UPGRADE</literal> or <literal>UPGRADE_NOWAIT</literal>. In the case of <literal>UPGRADE</literal> or <literal>UPGRADE_NOWAIT</literal>, <literal>SELECT ... FOR UPDATE</literal> is used." msgstr "" #. Tag: para -#: transactions.xml:951 #, no-c-format msgid "If the requested lock mode is not supported by the database, Hibernate uses an appropriate alternate mode instead of throwing an exception. This ensures that applications are portable." msgstr "" #. Tag: title -#: transactions.xml:960 #, no-c-format msgid "Connection release modes" msgstr "" #. Tag: para -#: transactions.xml:962 #, no-c-format msgid "One of the legacies of Hibernate 2.x JDBC connection management meant that a <literal>Session</literal> would obtain a connection when it was first required and then maintain that connection until the session was closed. Hibernate 3.x introduced the notion of connection release modes that would instruct a session how to handle its JDBC connections. The following discussion is pertinent only to connections provided through a configured <literal>ConnectionProvider</literal>. User-supplied connections are outside the breadth of this discussion. The different release modes are identified by the enumerated values of <literal>org.hibernate.ConnectionReleaseMode</literal>:" msgstr "" #. Tag: para -#: transactions.xml:976 #, no-c-format msgid "<literal>ON_CLOSE</literal>: is the legacy behavior described above. The Hibernate session obtains a connection when it first needs to perform some JDBC access and maintains that connection until the session is closed." msgstr "" #. Tag: para -#: transactions.xml:983 #, no-c-format msgid "<literal>AFTER_TRANSACTION</literal>: releases connections after a <literal>org.hibernate.Transaction</literal> has been completed." msgstr "" #. Tag: para -#: transactions.xml:989 #, no-c-format msgid "<literal>AFTER_STATEMENT</literal> (also referred to as aggressive release): releases connections after every statement execution. This aggressive releasing is skipped if that statement leaves open resources associated with the given session. Currently the only situation where this occurs is through the use of <literal>org.hibernate.ScrollableResults</literal>." msgstr "" #. Tag: para -#: transactions.xml:999 #, no-c-format msgid "The configuration parameter <literal>hibernate.connection.release_mode</literal> is used to specify which release mode to use. The possible values are as follows:" msgstr "" #. Tag: para -#: transactions.xml:1006 #, no-c-format msgid "<literal>auto</literal> (the default): this choice delegates to the release mode returned by the <literal>org.hibernate.transaction.TransactionFactory.getDefaultReleaseMode()</literal> method. For JTATransactionFactory, this returns ConnectionReleaseMode.AFTER_STATEMENT; for JDBCTransactionFactory, this returns ConnectionReleaseMode.AFTER_TRANSACTION. Do not change this default behavior as failures due to the value of this setting tend to indicate bugs and/or invalid assumptions in user code." msgstr "" #. Tag: para -#: transactions.xml:1016 #, no-c-format msgid "<literal>on_close</literal>: uses ConnectionReleaseMode.ON_CLOSE. This setting is left for backwards compatibility, but its use is discouraged." msgstr "" #. Tag: para -#: transactions.xml:1022 #, no-c-format msgid "<literal>after_transaction</literal>: uses ConnectionReleaseMode.AFTER_TRANSACTION. This setting should not be used in JTA environments. Also note that with ConnectionReleaseMode.AFTER_TRANSACTION, if a session is considered to be in auto-commit mode, connections will be released as if the release mode were AFTER_STATEMENT." msgstr "" #. Tag: para -#: transactions.xml:1030 #, no-c-format msgid "<literal>after_statement</literal>: uses ConnectionReleaseMode.AFTER_STATEMENT. Additionally, the configured <literal>ConnectionProvider</literal> is consulted to see if it supports this setting (<literal>supportsAggressiveRelease()</literal>). If not, the release mode is reset to ConnectionReleaseMode.AFTER_TRANSACTION. This setting is only safe in environments where we can either re-acquire the same underlying JDBC connection each time you make a call into <literal>ConnectionProvider.getConnection()</literal> or in auto-commit environments where it does not matter if we re-establish the same connection." msgstr "" Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/tutorial.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/tutorial.pot 2010-02-08 04:50:03 UTC (rev 18716) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/tutorial.pot 2010-02-08 04:56:55 UTC (rev 18717) @@ -1,1582 +1,698 @@ -# SOME DESCRIPTIVE TITLE. -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. # -#, fuzzy msgid "" msgstr "" -"Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-23 18:41+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:20\n" +"PO-Revision-Date: 2010-01-08T04:07:20\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" "MIME-Version: 1.0\n" -"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Type: application/x-publican; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. Tag: title -#: tutorial.xml:31 #, no-c-format msgid "Tutorial" msgstr "" #. Tag: para -#: tutorial.xml:33 #, no-c-format msgid "Intended for new users, this chapter provides an step-by-step introduction to Hibernate, starting with a simple application using an in-memory database. The tutorial is based on an earlier tutorial developed by Michael Gloegl. All code is contained in the <filename>tutorials/web</filename> directory of the project source." msgstr "" #. Tag: para -#: tutorial.xml:42 #, no-c-format msgid "This tutorial expects the user have knowledge of both Java and SQL. If you have a limited knowledge of JAVA or SQL, it is advised that you start with a good introduction to that technology prior to attempting to learn Hibernate." msgstr "" #. Tag: para -#: tutorial.xml:51 #, no-c-format msgid "The distribution contains another example application under the <filename>tutorial/eg</filename> project source directory." msgstr "" #. Tag: title -#: tutorial.xml:59 #, no-c-format msgid "Part 1 - The first Hibernate Application" msgstr "" #. Tag: para -#: tutorial.xml:61 #, no-c-format msgid "For this example, we will set up a small database application that can store events we want to attend and information about the host(s) of these events." msgstr "" #. Tag: para -#: tutorial.xml:67 #, no-c-format msgid "Although you can use whatever database you feel comfortable using, we will use <ulink url=\"http://hsqldb.org/\">HSQLDB</ulink> (an in-memory, Java database) to avoid describing installation/setup of any particular database servers." msgstr "" #. Tag: title -#: tutorial.xml:76 #, no-c-format msgid "Setup" msgstr "" #. Tag: para -#: tutorial.xml:78 #, no-c-format msgid "The first thing we need to do is to set up the development environment. We will be using the \"standard layout\" advocated by alot of build tools such as <ulink url=\"http://maven.org\">Maven</ulink>. Maven, in particular, has a good resource describing this <ulink url=\"http://maven.apache.org/guides/introduction/introduction-to-the-standard-...">layout</ulink>. As this tutorial is to be a web application, we will be creating and making use of <filename>src/main/java</filename>, <filename>src/main/resources</filename> and <filename>src/main/webapp</filename> directories." msgstr "" #. Tag: para -#: tutorial.xml:88 #, no-c-format msgid "We will be using Maven in this tutorial, taking advantage of its transitive dependency management capabilities as well as the ability of many IDEs to automatically set up a project for us based on the maven descriptor." msgstr "" -#. Tag: programlisting -#: tutorial.xml:94 -#, no-c-format -msgid "" - "<![CDATA[<project xmlns=\"http://maven.apache.org/POM/4.0.0\"\n" - " xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" - " xsi:schemaLocation=\"http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd\">\n" - "\n" - " <modelVersion>4.0.0</modelVersion>\n" - "\n" - " <groupId>org.hibernate.tutorials</groupId>\n" - " <artifactId>hibernate-tutorial</artifactId>\n" - " <version>1.0.0-SNAPSHOT</version>\n" - " <name>First Hibernate Tutorial</name>\n" - "\n" - " <build>\n" - " \n" - " <finalName>${artifactId}</finalName>\n" - " </build>\n" - "\n" - " <dependencies>\n" - " <dependency>\n" - " <groupId>org.hibernate</groupId>\n" - " <artifactId>hibernate-core</artifactId>\n" - " </dependency>\n" - "\n" - " \n" - " <dependency>\n" - " <groupId>javax.servlet</groupId>\n" - " <artifactId>servlet-api</artifactId>\n" - " </dependency>\n" - "\n" - " \n" - " <dependency>\n" - " <groupId>org.slf4j</groupId>\n" - " <artifactId>slf4j-simple</artifactId>\n" - " </dependency>\n" - "\n" - " \n" - " <dependency>\n" - " <groupId>javassist</groupId>\n" - " <artifactId>javassist</artifactId>\n" - " </dependency>\n" - " </dependencies>\n" - "\n" - "</project>]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:97 #, no-c-format -msgid "It is not a requirement to use Maven. If you wish to use something else to build this tutoial (such as Ant), the layout will remain the same. The only change is that you will need to manually account for all the needed dependencies. If you use something like <ulink url=\"http://ant.apache.org/ivy/\">Ivy</ulink> providing transitive dependency management you would still use the dependencies mentioned below. Otherwise, you'd need to grab <emphasis>all</emphasis> dependencies, both explicit and transitive, and add them to the project's classpath. If working from the Hibernate distribution bundle, this would mean <filename>hibernate3.jar</filename>, all artifacts in the <filename>lib/required</filename> directory and all files from either the <filename>lib/bytecode/cglib</filename> or <filename>lib/bytecode/javassist</filename> directory; additionally you will need both the servlet-api jar and one of the slf4j logging backends." +msgid "It is not a requirement to use Maven. If you wish to use another technology to build this tutorial (such as Ant), the layout will remain the same. The only change is that you will need to manually account for all the needed dependencies. If you use <ulink url=\"http://ant.apache.org/ivy/\">Ivy</ulink> to provide transitive dependency management you would still use the dependencies mentioned below. Otherwise, you will need to find all the dependencies, both explicit and transitive, and add them to the projects classpath. If working from the Hibernate distribution bundle, this would mean <filename>hibernate3.jar</filename>, all artifacts in the <filename>lib/required</filename> directory and all files from either the <filename>lib/bytecode/cglib</filename> or <filename>lib/bytecode/javassist</filename> directory; additionally you will need both the servlet-api jar and one of the slf4j logging backends." msgstr "" #. Tag: para -#: tutorial.xml:114 #, no-c-format msgid "Save this file as <filename>pom.xml</filename> in the project root directory." msgstr "" #. Tag: title -#: tutorial.xml:121 #, no-c-format msgid "The first class" msgstr "" #. Tag: para -#: tutorial.xml:123 #, no-c-format msgid "Next, we create a class that represents the event we want to store in the database; it is a simple JavaBean class with some properties:" msgstr "" -#. Tag: programlisting -#: tutorial.xml:128 -#, no-c-format -msgid "" - "<![CDATA[package org.hibernate.tutorial.domain;\n" - "\n" - "import java.util.Date;\n" - "\n" - "public class Event {\n" - " private Long id;\n" - "\n" - " private String title;\n" - " private Date date;\n" - "\n" - " public Event() {}\n" - "\n" - " public Long getId() {\n" - " return id;\n" - " }\n" - "\n" - " private void setId(Long id) {\n" - " this.id = id;\n" - " }\n" - "\n" - " public Date getDate() {\n" - " return date;\n" - " }\n" - "\n" - " public void setDate(Date date) {\n" - " this.date = date;\n" - " }\n" - "\n" - " public String getTitle() {\n" - " return title;\n" - " }\n" - "\n" - " public void setTitle(String title) {\n" - " this.title = title;\n" - " }\n" - "}]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:130 #, no-c-format msgid "This class uses standard JavaBean naming conventions for property getter and setter methods, as well as private visibility for the fields. Although this is the recommended design, it is not required. Hibernate can also access fields directly, the benefit of accessor methods is robustness for refactoring." msgstr "" #. Tag: para -#: tutorial.xml:138 #, no-c-format msgid "The <literal>id</literal> property holds a unique identifier value for a particular event. All persistent entity classes (there are less important dependent classes as well) will need such an identifier property if we want to use the full feature set of Hibernate. In fact, most applications, especially web applications, need to distinguish objects by identifier, so you should consider this a feature rather than a limitation. However, we usually do not manipulate the identity of an object, hence the setter method should be private. Only Hibernate will assign identifiers when an object is saved. Hibernate can access public, private, and protected accessor methods, as well as public, private and protected fields directly. The choice is up to you and you can match it to fit your application design." msgstr "" #. Tag: para -#: tutorial.xml:153 #, no-c-format msgid "The no-argument constructor is a requirement for all persistent classes; Hibernate has to create objects for you, using Java Reflection. The constructor can be private, however package or public visibility is required for runtime proxy generation and efficient data retrieval without bytecode instrumentation." msgstr "" #. Tag: para -#: tutorial.xml:161 #, no-c-format msgid "Save this file to the <filename>src/main/java/org/hibernate/tutorial/domain</filename> directory." msgstr "" #. Tag: title -#: tutorial.xml:168 #, no-c-format msgid "The mapping file" msgstr "" #. Tag: para -#: tutorial.xml:170 #, no-c-format msgid "Hibernate needs to know how to load and store objects of the persistent class. This is where the Hibernate mapping file comes into play. The mapping file tells Hibernate what table in the database it has to access, and what columns in that table it should use." msgstr "" #. Tag: para -#: tutorial.xml:178 #, no-c-format msgid "The basic structure of a mapping file looks like this:" msgstr "" -#. Tag: programlisting -#: tutorial.xml:182 -#, no-c-format -msgid "" - "<![CDATA[<?xml version=\"1.0\"?>\n" - "<!DOCTYPE hibernate-mapping PUBLIC\n" - " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" - " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" - "\n" - "<hibernate-mapping package=\"org.hibernate.tutorial.domain\">\n" - "[...]\n" - "</hibernate-mapping>]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:184 #, no-c-format msgid "Hibernate DTD is sophisticated. You can use it for auto-completion of XML mapping elements and attributes in your editor or IDE. Opening up the DTD file in your text editor is the easiest way to get an overview of all elements and attributes, and to view the defaults, as well as some comments. Hibernate will not load the DTD file from the web, but first look it up from the classpath of the application. The DTD file is included in <filename>hibernate-core.jar</filename> (it is also included in the <filename>hibernate3.jar</filename>, if using the distribution bundle)." msgstr "" #. Tag: para -#: tutorial.xml:197 #, no-c-format msgid "We will omit the DTD declaration in future examples to shorten the code. It is, of course, not optional." msgstr "" #. Tag: para -#: tutorial.xml:203 #, no-c-format msgid "Between the two <literal>hibernate-mapping</literal> tags, include a <literal>class</literal> element. All persistent entity classes (again, there might be dependent classes later on, which are not first-class entities) need a mapping to a table in the SQL database:" msgstr "" -#. Tag: programlisting -#: tutorial.xml:210 -#, no-c-format -msgid "" - "<![CDATA[<hibernate-mapping package=\"org.hibernate.tutorial.domain\">\n" - "\n" - " <class name=\"Event\" table=\"EVENTS\">\n" - "\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:212 #, no-c-format msgid "So far we have told Hibernate how to persist and load object of class <literal>Event</literal> to the table <literal>EVENTS</literal>. Each instance is now represented by a row in that table. Now we can continue by mapping the unique identifier property to the tables primary key. As we do not want to care about handling this identifier, we configure Hibernate's identifier generation strategy for a surrogate primary key column:" msgstr "" -#. Tag: programlisting -#: tutorial.xml:222 -#, no-c-format -msgid "" - "<![CDATA[<hibernate-mapping package=\"org.hibernate.tutorial.domain\">\n" - "\n" - " <class name=\"Event\" table=\"EVENTS\">\n" - " <id name=\"id\" column=\"EVENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:224 #, no-c-format msgid "The <literal>id</literal> element is the declaration of the identifier property. The <literal>name=\"id\"</literal> mapping attribute declares the name of the JavaBean property and tells Hibernate to use the <literal>getId()</literal> and <literal>setId()</literal> methods to access the property. The column attribute tells Hibernate which column of the <literal>EVENTS</literal> table holds the primary key value." msgstr "" #. Tag: para -#: tutorial.xml:234 #, no-c-format msgid "The nested <literal>generator</literal> element specifies the identifier generation strategy (aka how are identifier values generated?). In this case we choose <literal>native</literal>, which offers a level of portability depending on the configured database dialect. Hibernate supports database generated, globally unique, as well as application assigned, identifiers. Identifier value generation is also one of Hibernate's many extension points and you can plugin in your own strategy." msgstr "" #. Tag: para -#: tutorial.xml:246 #, no-c-format -msgid "<literal>native</literal> is no longer consider the best strategy in terms of portability. for further discussion, see" +msgid "<literal>native</literal> is no longer considered the best strategy in terms of portability. for further discussion, see <xref linkend=\"portability-idgen\" />" msgstr "" #. Tag: para -#: tutorial.xml:252 #, no-c-format msgid "Lastly, we need to tell Hibernate about the remaining entity class properties. By default, no properties of the class are considered persistent:" msgstr "" -#. Tag: programlisting -#: tutorial.xml:258 -#, no-c-format -msgid "" - "<![CDATA[\n" - "<hibernate-mapping package=\"org.hibernate.tutorial.domain\">\n" - "\n" - " <class name=\"Event\" table=\"EVENTS\">\n" - " <id name=\"id\" column=\"EVENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"date\" type=\"timestamp\" column=\"EVENT_DATE\"/>\n" - " <property name=\"title\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:260 #, no-c-format msgid "Similar to the <literal>id</literal> element, the <literal>name</literal> attribute of the <literal>property</literal> element tells Hibernate which getter and setter methods to use. In this case, Hibernate will search for <literal>getDate()</literal>, <literal>setDate()</literal>, <literal>getTitle()</literal> and <literal>setTitle()</literal> methods." msgstr "" #. Tag: para -#: tutorial.xml:271 #, no-c-format msgid "Why does the <literal>date</literal> property mapping include the <literal>column</literal> attribute, but the <literal>title</literal> does not? Without the <literal>column</literal> attribute, Hibernate by default uses the property name as the column name. This works for <literal>title</literal>, however, <literal>date</literal> is a reserved keyword in most databases so you will need to map it to a different name." msgstr "" #. Tag: para -#: tutorial.xml:281 #, no-c-format msgid "The <literal>title</literal> mapping also lacks a <literal>type</literal> attribute. The types declared and used in the mapping files are not Java data types; they are not SQL database types either. These types are called <emphasis>Hibernate mapping types</emphasis>, converters which can translate from Java to SQL data types and vice versa. Again, Hibernate will try to determine the correct conversion and mapping type itself if the <literal>type</literal> attribute is not present in the mapping. In some cases this automatic detection using Reflection on the Java class might not have the default you expect or need. This is the case with the <literal>date</literal> property. Hibernate cannot know if the property, which is of <literal>java.util.Date</literal>, should map to a SQL <literal>date</literal>, <literal>timestamp</literal>, or <literal>time</literal> column. Full date and time information is preserved by mapping the property with a <literal>timestamp</literal>! converter." msgstr "" #. Tag: para -#: tutorial.xml:297 #, no-c-format msgid "Hibernate makes this mapping type determination using reflection when the mapping files are processed. This can take time and resources, so if startup performance is important you should consider explicitly defining the type to use." msgstr "" #. Tag: para -#: tutorial.xml:304 #, no-c-format msgid "Save this mapping file as <filename>src/main/resources/org/hibernate/tutorial/domain/Event.hbm.xml</filename>." msgstr "" #. Tag: title -#: tutorial.xml:312 #, no-c-format msgid "Hibernate configuration" msgstr "" #. Tag: para -#: tutorial.xml:314 #, no-c-format msgid "At this point, you should have the persistent class and its mapping file in place. It is now time to configure Hibernate. First let's set up HSQLDB to run in \"server mode\"" msgstr "" #. Tag: para -#: tutorial.xml:321 #, no-c-format -msgid "We do this do that the data remains between runs." +msgid "We do this so that the data remains between runs." msgstr "" #. Tag: para -#: tutorial.xml:326 #, no-c-format msgid "We will utilize the Maven exec plugin to launch the HSQLDB server by running: <command> mvn exec:java -Dexec.mainClass=\"org.hsqldb.Server\" -Dexec.args=\"-database.0 file:target/data/tutorial\"</command> You will see it start up and bind to a TCP/IP socket; this is where our application will connect later. If you want to start with a fresh database during this tutorial, shutdown HSQLDB, delete all files in the <filename>target/data</filename> directory, and start HSQLDB again." msgstr "" #. Tag: para -#: tutorial.xml:337 #, no-c-format msgid "Hibernate will be connecting to the database on behalf of your application, so it needs to know how to obtain connections. For this tutorial we will be using a standalone connection pool (as opposed to a <interfacename>javax.sql.DataSource</interfacename>). Hibernate comes with support for two third-party open source JDBC connection pools: <ulink url=\"https://sourceforge.net/projects/c3p0\">c3p0</ulink> and <ulink url=\"http://proxool.sourceforge.net/\">proxool</ulink>. However, we will be using the Hibernate built-in connection pool for this tutorial." msgstr "" #. Tag: para -#: tutorial.xml:348 #, no-c-format -msgid "The built-in Hibernate connection pool is in no way intended for production use. It lacks several features found on any decent connection pool." +msgid "The built-in Hibernate connection pool is not intended for production use." msgstr "" #. Tag: para -#: tutorial.xml:354 #, no-c-format msgid "For Hibernate's configuration, we can use a simple <literal>hibernate.properties</literal> file, a more sophisticated <literal>hibernate.cfg.xml</literal> file, or even complete programmatic setup. Most users prefer the XML configuration file:" msgstr "" -#. Tag: programlisting -#: tutorial.xml:360 -#, no-c-format -msgid "" - "<![CDATA[<?xml version='1.0' encoding='utf-8'?>\n" - "<!DOCTYPE hibernate-configuration PUBLIC\n" - " \"-//Hibernate/Hibernate Configuration DTD 3.0//EN\"\n" - " \"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd\">\n" - "\n" - "<hibernate-configuration>\n" - "\n" - " <session-factory>\n" - "\n" - " \n" - " <property name=\"connection.driver_class\">org.hsqldb.jdbcDriver</property>\n" - " <property name=\"connection.url\">jdbc:hsqldb:hsql://localhost</property>\n" - " <property name=\"connection.username\">sa</property>\n" - " <property name=\"connection.password\"></property>\n" - "\n" - " \n" - " <property name=\"connection.pool_size\">1</property>\n" - "\n" - " \n" - " <property name=\"dialect\">org.hibernate.dialect.HSQLDialect</property>\n" - "\n" - " \n" - " <property name=\"current_session_context_class\">thread</property>\n" - "\n" - " \n" - " <property name=\"cache.provider_class\">org.hibernate.cache.NoCacheProvider</property>\n" - "\n" - " \n" - " <property name=\"show_sql\">true</property>\n" - "\n" - " \n" - " <property name=\"hbm2ddl.auto\">update</property>\n" - "\n" - " <mapping resource=\"org/hibernate/tutorial/domain/Event.hbm.xml\"/>\n" - "\n" - " </session-factory>\n" - "\n" - "</hibernate-configuration>]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:363 #, no-c-format msgid "Notice that this configuration file specifies a different DTD" msgstr "" #. Tag: para -#: tutorial.xml:366 #, no-c-format msgid "You configure Hibernate's <literal>SessionFactory</literal>. SessionFactory is a global factory responsible for a particular database. If you have several databases, for easier startup you should use several <literal><session-factory></literal> configurations in several configuration files." msgstr "" #. Tag: para -#: tutorial.xml:373 #, no-c-format msgid "The first four <literal>property</literal> elements contain the necessary configuration for the JDBC connection. The dialect <literal>property</literal> element specifies the particular SQL variant Hibernate generates." msgstr "" #. Tag: para -#: tutorial.xml:380 #, no-c-format -msgid "In most cases, Hibernate is able to properly determine which dialect to use. See <xref linkend=\"portability-dialectresolver\"/> for more information." +msgid "Hibernate is able to correctly determine which dialect to use in most cases. See <xref linkend=\"portability-dialectresolver\" /> for more information." msgstr "" #. Tag: para -#: tutorial.xml:386 #, no-c-format msgid "Hibernate's automatic session management for persistence contexts is particularly useful in this context. The <literal>hbm2ddl.auto</literal> option turns on automatic generation of database schemas directly into the database. This can also be turned off by removing the configuration option, or redirected to a file with the help of the <literal>SchemaExport</literal> Ant task. Finally, add the mapping file(s) for persistent classes to the configuration." msgstr "" #. Tag: para -#: tutorial.xml:395 #, no-c-format msgid "Save this file as <filename>hibernate.cfg.xml</filename> into the <filename>src/main/resources</filename> directory." msgstr "" #. Tag: title -#: tutorial.xml:403 #, no-c-format msgid "Building with Maven" msgstr "" #. Tag: para -#: tutorial.xml:405 #, no-c-format msgid "We will now build the tutorial with Maven. You will need to have Maven installed; it is available from the <ulink url=\"http://maven.apache.org/download.html\">Maven download page</ulink>. Maven will read the <filename>/pom.xml</filename> file we created earlier and know how to perform some basic project tasks. First, lets run the <literal>compile</literal> goal to make sure we can compile everything so far:" msgstr "" -#. Tag: programlisting -#: tutorial.xml:415 -#, no-c-format -msgid "" - "<![CDATA[[hibernateTutorial]$ mvn compile\n" - "[INFO] Scanning for projects...\n" - "[INFO] ------------------------------------------------------------------------\n" - "[INFO] Building First Hibernate Tutorial\n" - "[INFO] task-segment: [compile]\n" - "[INFO] ------------------------------------------------------------------------\n" - "[INFO] [resources:resources]\n" - "[INFO] Using default encoding to copy filtered resources.\n" - "[INFO] [compiler:compile]\n" - "[INFO] Compiling 1 source file to /home/steve/projects/sandbox/hibernateTutorial/target/classes\n" - "[INFO] ------------------------------------------------------------------------\n" - "[INFO] BUILD SUCCESSFUL\n" - "[INFO] ------------------------------------------------------------------------\n" - "[INFO] Total time: 2 seconds\n" - "[INFO] Finished at: Tue Jun 09 12:25:25 CDT 2009\n" - "[INFO] Final Memory: 5M/547M\n" - "[INFO] ------------------------------------------------------------------------]]>" -msgstr "" - #. Tag: title -#: tutorial.xml:420 #, no-c-format msgid "Startup and helpers" msgstr "" #. Tag: para -#: tutorial.xml:422 #, no-c-format msgid "It is time to load and store some <literal>Event</literal> objects, but first you have to complete the setup with some infrastructure code. You have to startup Hibernate by building a global <interfacename>org.hibernate.SessionFactory</interfacename> object and storing it somewhere for easy access in application code. A <interfacename>org.hibernate.SessionFactory</interfacename> is used to obtain <interfacename>org.hibernate.Session</interfacename> instances. A <interfacename>org.hibernate.Session</interfacename> represents a single-threaded unit of work. The <interfacename>org.hibernate.SessionFactory</interfacename> is a thread-safe global object that is instantiated once." msgstr "" #. Tag: para -#: tutorial.xml:436 #, no-c-format msgid "We will create a <literal>HibernateUtil</literal> helper class that takes care of startup and makes accessing the <interfacename>org.hibernate.SessionFactory</interfacename> more convenient." msgstr "" -#. Tag: programlisting -#: tutorial.xml:442 -#, no-c-format -msgid "" - "<![CDATA[package org.hibernate.tutorial.util;\n" - "\n" - "import org.hibernate.SessionFactory;\n" - "import org.hibernate.cfg.Configuration;\n" - "\n" - "public class HibernateUtil {\n" - "\n" - " private static final SessionFactory sessionFactory = buildSessionFactory();\n" - "\n" - " private static SessionFactory buildSessionFactory() {\n" - " try {\n" - " // Create the SessionFactory from hibernate.cfg.xml\n" - " return new Configuration().configure().buildSessionFactory();\n" - " }\n" - " catch (Throwable ex) {\n" - " // Make sure you log the exception, as it might be swallowed\n" - " System.err.println(\"Initial SessionFactory creation failed.\" + ex);\n" - " throw new ExceptionInInitializerError(ex);\n" - " }\n" - " }\n" - "\n" - " public static SessionFactory getSessionFactory() {\n" - " return sessionFactory;\n" - " }\n" - "\n" - "}]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:444 #, no-c-format msgid "Save this code as <filename>src/main/java/org/hibernate/tutorial/util/HibernateUtil.java</filename>" msgstr "" #. Tag: para -#: tutorial.xml:449 #, no-c-format msgid "This class not only produces the global <interfacename>org.hibernate.SessionFactory</interfacename> reference in its static initializer; it also hides the fact that it uses a static singleton. We might just as well have looked up the <interfacename>org.hibernate.SessionFactory</interfacename> reference from JNDI in an application server or any other location for that matter." msgstr "" #. Tag: para -#: tutorial.xml:458 #, no-c-format msgid "If you give the <interfacename>org.hibernate.SessionFactory</interfacename> a name in your configuration, Hibernate will try to bind it to JNDI under that name after it has been built. Another, better option is to use a JMX deployment and let the JMX-capable container instantiate and bind a <literal>HibernateService</literal> to JNDI. Such advanced options are discussed later." msgstr "" #. Tag: para -#: tutorial.xml:467 #, no-c-format msgid "You now need to configure a logging system. Hibernate uses commons logging and provides two choices: Log4j and JDK 1.4 logging. Most developers prefer Log4j: copy <literal>log4j.properties</literal> from the Hibernate distribution in the <literal>etc/</literal> directory to your <literal>src</literal> directory, next to <literal>hibernate.cfg.xml</literal>. If you prefer to have more verbose output than that provided in the example configuration, you can change the settings. By default, only the Hibernate startup message is shown on stdout." msgstr "" #. Tag: para -#: tutorial.xml:477 #, no-c-format msgid "The tutorial infrastructure is complete and you are now ready to do some real work with Hibernate." msgstr "" #. Tag: title -#: tutorial.xml:485 #, no-c-format msgid "Loading and storing objects" msgstr "" #. Tag: para -#: tutorial.xml:487 #, no-c-format msgid "We are now ready to start doing some real worjk with Hibernate. Let's start by writing an <literal>EventManager</literal> class with a <literal>main()</literal> method:" msgstr "" -#. Tag: programlisting -#: tutorial.xml:493 -#, no-c-format -msgid "" - "<![CDATA[package org.hibernate.tutorial;\n" - "\n" - "import org.hibernate.Session;\n" - "\n" - "import java.util.*;\n" - "\n" - "import org.hibernate.tutorial.domain.Event;\n" - "import org.hibernate.tutorial.util.HibernateUtil;\n" - "\n" - "public class EventManager {\n" - "\n" - " public static void main(String[] args) {\n" - " EventManager mgr = new EventManager();\n" - "\n" - " if (args[0].equals(\"store\")) {\n" - " mgr.createAndStoreEvent(\"My Event\", new Date());\n" - " }\n" - "\n" - " HibernateUtil.getSessionFactory().close();\n" - " }\n" - "\n" - " private void createAndStoreEvent(String title, Date theDate) {\n" - " Session session = HibernateUtil.getSessionFactory().getCurrentSession();\n" - " session.beginTransaction();\n" - "\n" - " Event theEvent = new Event();\n" - " theEvent.setTitle(title);\n" - " theEvent.setDate(theDate);\n" - " session.save(theEvent);\n" - "\n" - " session.getTransaction().commit();\n" - " }\n" - "\n" - "}]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:495 #, no-c-format msgid "In <literal>createAndStoreEvent()</literal> we created a new <literal>Event</literal> object and handed it over to Hibernate. At that point, Hibernate takes care of the SQL and executes an <literal>INSERT</literal> on the database." msgstr "" #. Tag: para -#: tutorial.xml:502 #, no-c-format msgid "A <interface>org.hibernate.Session</interface> is designed to represent a single unit of work (a single atmoic piece of work to be performed). For now we will keep things simple and assume a one-to-one granularity between a Hibernate <interface>org.hibernate.Session</interface> and a database transaction. To shield our code from the actual underlying transaction system we use the Hibernate <interfacename>org.hibernate.Transaction</interfacename> API. In this particular case we are using JDBC-based transactional semantics, but it could also run with JTA." msgstr "" #. Tag: para -#: tutorial.xml:515 #, no-c-format msgid "What does <literal>sessionFactory.getCurrentSession()</literal> do? First, you can call it as many times and anywhere you like once you get hold of your <interfacename>org.hibernate.SessionFactory</interfacename>. The <literal>getCurrentSession()</literal> method always returns the \"current\" unit of work. Remember that we switched the configuration option for this mechanism to \"thread\" in our <filename>src/main/resources/hibernate.cfg.xml</filename>? Due to that setting, the context of a current unit of work is bound to the current Java thread that executes the application." msgstr "" #. Tag: para -#: tutorial.xml:529 #, no-c-format msgid "Hibernate offers three methods of current session tracking. The \"thread\" based method is not intended for production use; it is merely useful for prototyping and tutorials such as this one. Current session tracking is discussed in more detail later on." msgstr "" #. Tag: para -#: tutorial.xml:538 #, no-c-format msgid "A <interface>org.hibernate.Session</interface> begins when the first call to <literal>getCurrentSession()</literal> is made for the current thread. It is then bound by Hibernate to the current thread. When the transaction ends, either through commit or rollback, Hibernate automatically unbinds the <interface>org.hibernate.Session</interface> from the thread and closes it for you. If you call <literal>getCurrentSession()</literal> again, you get a new <interface>org.hibernate.Session</interface> and can start a new unit of work." msgstr "" #. Tag: para -#: tutorial.xml:551 #, no-c-format msgid "Related to the unit of work scope, should the Hibernate <interface>org.hibernate.Session</interface> be used to execute one or several database operations? The above example uses one <interface>org.hibernate.Session</interface> for one operation. However this is pure coincidence; the example is just not complex enough to show any other approach. The scope of a Hibernate <interface>org.hibernate.Session</interface> is flexible but you should never design your application to use a new Hibernate <interface>org.hibernate.Session</interface> for <emphasis>every</emphasis> database operation. Even though it is used in the following examples, consider <emphasis>session-per-operation</emphasis> an anti-pattern. A real web application is shown later in the tutorial which will help illustrate this." msgstr "" #. Tag: para -#: tutorial.xml:568 #, no-c-format -msgid "See <xref linkend=\"transactions\"/> for more information about transaction handling and demarcation. The previous example also skipped any error handling and rollback." +msgid "See <xref linkend=\"transactions\" /> for more information about transaction handling and demarcation. The previous example also skipped any error handling and rollback." msgstr "" #. Tag: para -#: tutorial.xml:574 #, no-c-format msgid "To run this, we will make use of the Maven exec plugin to call our class with the necessary classpath setup: <command>mvn exec:java -Dexec.mainClass=\"org.hibernate.tutorial.EventManager\" -Dexec.args=\"store\"</command>" msgstr "" #. Tag: para -#: tutorial.xml:581 #, no-c-format msgid "You may need to perform <command>mvn compile</command> first." msgstr "" #. Tag: para -#: tutorial.xml:586 #, no-c-format msgid "You should see Hibernate starting up and, depending on your configuration, lots of log output. Towards the end, the following line will be displayed:" msgstr "" -#. Tag: programlisting -#: tutorial.xml:591 -#, no-c-format -msgid "<![CDATA[[java] Hibernate: insert into EVENTS (EVENT_DATE, title, EVENT_ID) values (?, ?, ?)]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:593 #, no-c-format msgid "This is the <literal>INSERT</literal> executed by Hibernate." msgstr "" #. Tag: para -#: tutorial.xml:597 #, no-c-format msgid "To list stored events an option is added to the main method:" msgstr "" -#. Tag: programlisting -#: tutorial.xml:601 -#, no-c-format -msgid "" - "<![CDATA[ if (args[0].equals(\"store\")) {\n" - " mgr.createAndStoreEvent(\"My Event\", new Date());\n" - " }\n" - " else if (args[0].equals(\"list\")) {\n" - " List events = mgr.listEvents();\n" - " for (int i = 0; i < events.size(); i++) {\n" - " Event theEvent = (Event) events.get(i);\n" - " System.out.println(\n" - " \"Event: \" + theEvent.getTitle() + \" Time: \" + theEvent.getDate()\n" - " );\n" - " }\n" - " }]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:603 #, no-c-format msgid "A new <literal>listEvents() method is also added</literal>:" msgstr "" -#. Tag: programlisting -#: tutorial.xml:607 -#, no-c-format -msgid "" - "<![CDATA[ private List listEvents() {\n" - " Session session = HibernateUtil.getSessionFactory().getCurrentSession();\n" - " session.beginTransaction();\n" - " List result = session.createQuery(\"from Event\").list();\n" - " session.getTransaction().commit();\n" - " return result;\n" - " }]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:609 #, no-c-format -msgid "Here, we are using a Hibernate Query Language (HQL) query to load all existing <literal>Event</literal> objects from the database. Hibernate will generate the appropriate SQL, send it to the database and populate <literal>Event</literal> objects with the data. You can create more complex queries with HQL. See <xref linkend=\"queryhql\"/> for more information." +msgid "Here, we are using a Hibernate Query Language (HQL) query to load all existing <literal>Event</literal> objects from the database. Hibernate will generate the appropriate SQL, send it to the database and populate <literal>Event</literal> objects with the data. You can create more complex queries with HQL. See <xref linkend=\"queryhql\" /> for more information." msgstr "" #. Tag: para -#: tutorial.xml:617 #, no-c-format msgid "Now we can call our new functionality, again using the Maven exec plugin: <command>mvn exec:java -Dexec.mainClass=\"org.hibernate.tutorial.EventManager\" -Dexec.args=\"list\"</command>" msgstr "" #. Tag: title -#: tutorial.xml:627 #, no-c-format msgid "Part 2 - Mapping associations" msgstr "" #. Tag: para -#: tutorial.xml:629 #, no-c-format msgid "So far we have mapped a single persistent entity class to a table in isolation. Let's expand on that a bit and add some class associations. We will add people to the application and store a list of events in which they participate." msgstr "" #. Tag: title -#: tutorial.xml:637 #, no-c-format msgid "Mapping the Person class" msgstr "" #. Tag: para -#: tutorial.xml:639 #, no-c-format msgid "The first cut of the <literal>Person</literal> class looks like this:" msgstr "" -#. Tag: programlisting -#: tutorial.xml:643 -#, no-c-format -msgid "" - "<![CDATA[package org.hibernate.tutorial.domain;\n" - "\n" - "public class Person {\n" - "\n" - " private Long id;\n" - " private int age;\n" - " private String firstname;\n" - " private String lastname;\n" - "\n" - " public Person() {}\n" - "\n" - " // Accessor methods for all properties, private setter for 'id'\n" - "\n" - "}]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:645 #, no-c-format msgid "Save this to a file named <filename>src/main/java/org/hibernate/tutorial/domain/Person.java</filename>" msgstr "" #. Tag: para -#: tutorial.xml:650 #, no-c-format msgid "Next, create the new mapping file as <filename>src/main/resources/org/hibernate/tutorial/domain/Person.hbm.xml</filename>" msgstr "" -#. Tag: programlisting -#: tutorial.xml:655 -#, no-c-format -msgid "" - "<![CDATA[<hibernate-mapping package=\"org.hibernate.tutorial.domain\">\n" - "\n" - " <class name=\"Person\" table=\"PERSON\">\n" - " <id name=\"id\" column=\"PERSON_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"age\"/>\n" - " <property name=\"firstname\"/>\n" - " <property name=\"lastname\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:657 #, no-c-format msgid "Finally, add the new mapping to Hibernate's configuration:" msgstr "" -#. Tag: programlisting -#: tutorial.xml:661 -#, no-c-format -msgid "" - "<![CDATA[<mapping resource=\"events/Event.hbm.xml\"/>\n" - "<mapping resource=\"events/Person.hbm.xml\"/>]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:663 #, no-c-format msgid "Create an association between these two entities. Persons can participate in events, and events have participants. The design questions you have to deal with are: directionality, multiplicity, and collection behavior." msgstr "" #. Tag: title -#: tutorial.xml:673 #, no-c-format msgid "A unidirectional Set-based association" msgstr "" #. Tag: para -#: tutorial.xml:675 #, no-c-format msgid "By adding a collection of events to the <literal>Person</literal> class, you can easily navigate to the events for a particular person, without executing an explicit query - by calling <literal>Person#getEvents</literal>. Multi-valued associations are represented in Hibernate by one of the Java Collection Framework contracts; here we choose a <interfacename>java.util.Set</interfacename> because the collection will not contain duplicate elements and the ordering is not relevant to our examples:" msgstr "" -#. Tag: programlisting -#: tutorial.xml:686 -#, no-c-format -msgid "" - "<![CDATA[public class Person {\n" - "\n" - " private Set events = new HashSet();\n" - "\n" - " public Set getEvents() {\n" - " return events;\n" - " }\n" - "\n" - " public void setEvents(Set events) {\n" - " this.events = events;\n" - " }\n" - "}]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:688 #, no-c-format msgid "Before mapping this association, let's consider the other side. We could just keep this unidirectional or create another collection on the <literal>Event</literal>, if we wanted to be able to navigate it from both directions. This is not necessary, from a functional perspective. You can always execute an explicit query to retrieve the participants for a particular event. This is a design choice left to you, but what is clear from this discussion is the multiplicity of the association: \"many\" valued on both sides is called a <emphasis>many-to-many</emphasis> association. Hence, we use Hibernate's many-to-many mapping:" msgstr "" -#. Tag: programlisting -#: tutorial.xml:701 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Person\" table=\"PERSON\">\n" - " <id name=\"id\" column=\"PERSON_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"age\"/>\n" - " <property name=\"firstname\"/>\n" - " <property name=\"lastname\"/>\n" - "\n" - " <set name=\"events\" table=\"PERSON_EVENT\">\n" - " <key column=\"PERSON_ID\"/>\n" - " <many-to-many column=\"EVENT_ID\" class=\"Event\"/>\n" - " </set>\n" - "\n" - "</class>]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:703 #, no-c-format msgid "Hibernate supports a broad range of collection mappings, a <literal>set</literal> being most common. For a many-to-many association, or <emphasis>n:m</emphasis> entity relationship, an association table is required. Each row in this table represents a link between a person and an event. The table name is decalred using the <literal>table</literal> attribute of the <literal>set</literal> element. The identifier column name in the association, for the person side, is defined with the <literal>key</literal> element, the column name for the event's side with the <literal>column</literal> attribute of the <literal>many-to-many</literal>. You also have to tell Hibernate the class of the objects in your collection (the class on the other side of the collection of references)." msgstr "" #. Tag: para -#: tutorial.xml:719 #, no-c-format msgid "The database schema for this mapping is therefore:" msgstr "" -#. Tag: programlisting -#: tutorial.xml:723 -#, no-c-format -msgid "" - "<![CDATA[\n" - " _____________ __________________\n" - " | | | | _____________\n" - " | EVENTS | | PERSON_EVENT | | |\n" - " |_____________| |__________________| | PERSON |\n" - " | | | | |_____________|\n" - " | *EVENT_ID | <--> | *EVENT_ID | | |\n" - " | EVENT_DATE | | *PERSON_ID | <--> | *PERSON_ID |\n" - " | TITLE | |__________________| | AGE |\n" - " |_____________| | FIRSTNAME |\n" - " | LASTNAME |\n" - " |_____________|\n" - " ]]>" -msgstr "" - #. Tag: title -#: tutorial.xml:728 #, no-c-format msgid "Working the association" msgstr "" #. Tag: para -#: tutorial.xml:730 #, no-c-format msgid "Now we will bring some people and events together in a new method in <literal>EventManager</literal>:" msgstr "" -#. Tag: programlisting -#: tutorial.xml:734 -#, no-c-format -msgid "" - "<![CDATA[ private void addPersonToEvent(Long personId, Long eventId) {\n" - " Session session = HibernateUtil.getSessionFactory().getCurrentSession();\n" - " session.beginTransaction();\n" - "\n" - " Person aPerson = (Person) session.load(Person.class, personId);\n" - " Event anEvent = (Event) session.load(Event.class, eventId);\n" - " aPerson.getEvents().add(anEvent);\n" - "\n" - " session.getTransaction().commit();\n" - " }]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:736 #, no-c-format msgid "After loading a <literal>Person</literal> and an <literal>Event</literal>, simply modify the collection using the normal collection methods. There is no explicit call to <literal>update()</literal> or <literal>save()</literal>; Hibernate automatically detects that the collection has been modified and needs to be updated. This is called <emphasis>automatic dirty checking</emphasis>. You can also try it by modifying the name or the date property of any of your objects. As long as they are in <emphasis>persistent</emphasis> state, that is, bound to a particular Hibernate <interfacename>org.hibernate.Session</interfacename>, Hibernate monitors any changes and executes SQL in a write-behind fashion. The process of synchronizing the memory state with the database, usually only at the end of a unit of work, is called <emphasis>flushing</emphasis>. In our code, the unit of work ends with a commit, or rollback, of the database transaction." msgstr "" #. Tag: para -#: tutorial.xml:755 #, no-c-format msgid "You can load person and event in different units of work. Or you can modify an object outside of a <interfacename>org.hibernate.Session</interfacename>, when it is not in persistent state (if it was persistent before, this state is called <emphasis>detached</emphasis>). You can even modify a collection when it is detached:" msgstr "" -#. Tag: programlisting -#: tutorial.xml:764 -#, no-c-format -msgid "" - "<![CDATA[ private void addPersonToEvent(Long personId, Long eventId) {\n" - " Session session = HibernateUtil.getSessionFactory().getCurrentSession();\n" - " session.beginTransaction();\n" - "\n" - " Person aPerson = (Person) session\n" - " .createQuery(\"select p from Person p left join fetch p.events where p.id = :pid\")\n" - " .setParameter(\"pid\", personId)\n" - " .uniqueResult(); // Eager fetch the collection so we can use it detached\n" - " Event anEvent = (Event) session.load(Event.class, eventId);\n" - "\n" - " session.getTransaction().commit();\n" - "\n" - " // End of first unit of work\n" - "\n" - " aPerson.getEvents().add(anEvent); // aPerson (and its collection) is detached\n" - "\n" - " // Begin second unit of work\n" - "\n" - " Session session2 = HibernateUtil.getSessionFactory().getCurrentSession();\n" - " session2.beginTransaction();\n" - " session2.update(aPerson); // Reattachment of aPerson\n" - "\n" - " session2.getTransaction().commit();\n" - " }]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:766 #, no-c-format msgid "The call to <literal>update</literal> makes a detached object persistent again by binding it to a new unit of work, so any modifications you made to it while detached can be saved to the database. This includes any modifications (additions/deletions) you made to a collection of that entity object." msgstr "" #. Tag: para -#: tutorial.xml:775 #, no-c-format msgid "This is not much use in our example, but it is an important concept you can incorporate into your own application. Complete this exercise by adding a new action to the main method of the <literal>EventManager</literal> and call it from the command line. If you need the identifiers of a person and an event - the <literal>save()</literal> method returns it (you might have to modify some of the previous methods to return that identifier):" msgstr "" -#. Tag: programlisting -#: tutorial.xml:783 -#, no-c-format -msgid "" - "<![CDATA[ else if (args[0].equals(\"addpersontoevent\")) {\n" - " Long eventId = mgr.createAndStoreEvent(\"My Event\", new Date());\n" - " Long personId = mgr.createAndStorePerson(\"Foo\", \"Bar\");\n" - " mgr.addPersonToEvent(personId, eventId);\n" - " System.out.println(\"Added person \" + personId + \" to event \" + eventId);\n" - " }]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:785 #, no-c-format msgid "This is an example of an association between two equally important classes : two entities. As mentioned earlier, there are other classes and types in a typical model, usually \"less important\". Some you have already seen, like an <literal>int</literal> or a <classname>java.lang.String</classname>. We call these classes <emphasis>value types</emphasis>, and their instances <emphasis>depend</emphasis> on a particular entity. Instances of these types do not have their own identity, nor are they shared between entities. Two persons do not reference the same <literal>firstname</literal> object, even if they have the same first name. Value types cannot only be found in the JDK , but you can also write dependent classes yourself such as an <literal>Address</literal> or <literal>MonetaryAmount</literal> class. In fact, in a Hibernate application all JDK classes are considered value types." msgstr "" #. Tag: para -#: tutorial.xml:803 #, no-c-format msgid "You can also design a collection of value types. This is conceptually different from a collection of references to other entities, but looks almost the same in Java." msgstr "" #. Tag: title -#: tutorial.xml:812 #, no-c-format msgid "Collection of values" msgstr "" #. Tag: para -#: tutorial.xml:814 #, no-c-format msgid "Let's add a collection of email addresses to the <literal>Person</literal> entity. This will be represented as a <interfacename>java.util.Set</interfacename> of <classname>java.lang.String</classname> instances:" msgstr "" -#. Tag: programlisting -#: tutorial.xml:820 -#, no-c-format -msgid "" - "<![CDATA[ private Set emailAddresses = new HashSet();\n" - "\n" - " public Set getEmailAddresses() {\n" - " return emailAddresses;\n" - " }\n" - "\n" - " public void setEmailAddresses(Set emailAddresses) {\n" - " this.emailAddresses = emailAddresses;\n" - " }]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:822 #, no-c-format msgid "The mapping of this <literal>Set</literal> is as follows:" msgstr "" -#. Tag: programlisting -#: tutorial.xml:826 -#, no-c-format -msgid "" - "<![CDATA[ <set name=\"emailAddresses\" table=\"PERSON_EMAIL_ADDR\">\n" - " <key column=\"PERSON_ID\"/>\n" - " <element type=\"string\" column=\"EMAIL_ADDR\"/>\n" - " </set>]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:828 #, no-c-format msgid "The difference compared with the earlier mapping is the use of the <literal>element</literal> part which tells Hibernate that the collection does not contain references to another entity, but is rather a collection whose elements are values types, here specifically of type <literal>string</literal>. The lowercase name tells you it is a Hibernate mapping type/converter. Again the <literal>table</literal> attribute of the <literal>set</literal> element determines the table name for the collection. The <literal>key</literal> element defines the foreign-key column name in the collection table. The <literal>column</literal> attribute in the <literal>element</literal> element defines the column name where the email address values will actually be stored." msgstr "" #. Tag: para -#: tutorial.xml:844 #, no-c-format msgid "Here is the updated schema:" msgstr "" -#. Tag: programlisting -#: tutorial.xml:848 -#, no-c-format -msgid "" - "<![CDATA[\n" - " _____________ __________________\n" - " | | | | _____________\n" - " | EVENTS | | PERSON_EVENT | | | ___________________\n" - " |_____________| |__________________| | PERSON | | |\n" - " | | | | |_____________| | PERSON_EMAIL_ADDR |\n" - " | *EVENT_ID | <--> | *EVENT_ID | | | |___________________|\n" - " | EVENT_DATE | | *PERSON_ID | <--> | *PERSON_ID | <--> | *PERSON_ID |\n" - " | TITLE | |__________________| | AGE | | *EMAIL_ADDR |\n" - " |_____________| | FIRSTNAME | |___________________|\n" - " | LASTNAME |\n" - " |_____________|\n" - " ]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:850 #, no-c-format msgid "You can see that the primary key of the collection table is in fact a composite key that uses both columns. This also implies that there cannot be duplicate email addresses per person, which is exactly the semantics we need for a set in Java." msgstr "" #. Tag: para -#: tutorial.xml:856 #, no-c-format msgid "You can now try to add elements to this collection, just like we did before by linking persons and events. It is the same code in Java:" msgstr "" -#. Tag: programlisting -#: tutorial.xml:861 -#, no-c-format -msgid "" - "<![CDATA[ private void addEmailToPerson(Long personId, String emailAddress) {\n" - " Session session = HibernateUtil.getSessionFactory().getCurrentSession();\n" - " session.beginTransaction();\n" - "\n" - " Person aPerson = (Person) session.load(Person.class, personId);\n" - " // adding to the emailAddress collection might trigger a lazy load of the collection\n" - " aPerson.getEmailAddresses().add(emailAddress);\n" - "\n" - " session.getTransaction().commit();\n" - " }]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:863 #, no-c-format msgid "This time we did not use a <emphasis>fetch</emphasis> query to initialize the collection. Monitor the SQL log and try to optimize this with an eager fetch." msgstr "" #. Tag: title -#: tutorial.xml:872 #, no-c-format msgid "Bi-directional associations" msgstr "" #. Tag: para -#: tutorial.xml:874 #, no-c-format msgid "Next you will map a bi-directional association. You will make the association between person and event work from both sides in Java. The database schema does not change, so you will still have many-to-many multiplicity." msgstr "" #. Tag: para -#: tutorial.xml:882 #, no-c-format msgid "A relational database is more flexible than a network programming language, in that it does not need a navigation direction; data can be viewed and retrieved in any possible way." msgstr "" #. Tag: para -#: tutorial.xml:890 #, no-c-format msgid "First, add a collection of participants to the <literal>Event</literal> class:" msgstr "" -#. Tag: programlisting -#: tutorial.xml:895 -#, no-c-format -msgid "" - "<![CDATA[ private Set participants = new HashSet();\n" - "\n" - " public Set getParticipants() {\n" - " return participants;\n" - " }\n" - "\n" - " public void setParticipants(Set participants) {\n" - " this.participants = participants;\n" - " }]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:897 #, no-c-format msgid "Now map this side of the association in <literal>Event.hbm.xml</literal>." msgstr "" -#. Tag: programlisting -#: tutorial.xml:901 -#, no-c-format -msgid "" - "<![CDATA[ <set name=\"participants\" table=\"PERSON_EVENT\" inverse=\"true\">\n" - " <key column=\"EVENT_ID\"/>\n" - " <many-to-many column=\"PERSON_ID\" class=\"events.Person\"/>\n" - " </set>]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:903 #, no-c-format msgid "These are normal <literal>set</literal> mappings in both mapping documents. Notice that the column names in <literal>key</literal> and <literal>many-to-many</literal> swap in both mapping documents. The most important addition here is the <literal>inverse=\"true\"</literal> attribute in the <literal>set</literal> element of the <literal>Event</literal>'s collection mapping." msgstr "" #. Tag: para -#: tutorial.xml:911 #, no-c-format msgid "What this means is that Hibernate should take the other side, the <literal>Person</literal> class, when it needs to find out information about the link between the two. This will be a lot easier to understand once you see how the bi-directional link between our two entities is created." msgstr "" #. Tag: title -#: tutorial.xml:920 #, no-c-format msgid "Working bi-directional links" msgstr "" #. Tag: para -#: tutorial.xml:922 #, no-c-format msgid "First, keep in mind that Hibernate does not affect normal Java semantics. How did we create a link between a <literal>Person</literal> and an <literal>Event</literal> in the unidirectional example? You add an instance of <literal>Event</literal> to the collection of event references, of an instance of <literal>Person</literal>. If you want to make this link bi-directional, you have to do the same on the other side by adding a <literal>Person</literal> reference to the collection in an <literal>Event</literal>. This process of \"setting the link on both sides\" is absolutely necessary with bi-directional links." msgstr "" #. Tag: para -#: tutorial.xml:932 #, no-c-format msgid "Many developers program defensively and create link management methods to correctly set both sides (for example, in <literal>Person</literal>):" msgstr "" -#. Tag: programlisting -#: tutorial.xml:937 -#, no-c-format -msgid "" - "<![CDATA[ protected Set getEvents() {\n" - " return events;\n" - " }\n" - "\n" - " protected void setEvents(Set events) {\n" - " this.events = events;\n" - " }\n" - "\n" - " public void addToEvent(Event event) {\n" - " this.getEvents().add(event);\n" - " event.getParticipants().add(this);\n" - " }\n" - "\n" - " public void removeFromEvent(Event event) {\n" - " this.getEvents().remove(event);\n" - " event.getParticipants().remove(this);\n" - " }]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:939 #, no-c-format msgid "The get and set methods for the collection are now protected. This allows classes in the same package and subclasses to still access the methods, but prevents everybody else from altering the collections directly. Repeat the steps for the collection on the other side." msgstr "" #. Tag: para -#: tutorial.xml:946 #, no-c-format msgid "What about the <literal>inverse</literal> mapping attribute? For you, and for Java, a bi-directional link is simply a matter of setting the references on both sides correctly. Hibernate, however, does not have enough information to correctly arrange SQL <literal>INSERT</literal> and <literal>UPDATE</literal> statements (to avoid constraint violations). Making one side of the association <literal>inverse</literal> tells Hibernate to consider it a <emphasis>mirror</emphasis> of the other side. That is all that is necessary for Hibernate to resolve any issues that arise when transforming a directional navigation model to a SQL database schema. The rules are straightforward: all bi-directional associations need one side as <literal>inverse</literal>. In a one-to-many association it has to be the many-side, and in many-to-many association you can select either side." msgstr "" #. Tag: title -#: tutorial.xml:962 #, no-c-format msgid "Part 3 - The EventManager web application" msgstr "" #. Tag: para -#: tutorial.xml:964 #, no-c-format msgid "A Hibernate web application uses <literal>Session</literal> and <literal>Transaction</literal> almost like a standalone application. However, some common patterns are useful. You can now write an <literal>EventManagerServlet</literal>. This servlet can list all events stored in the database, and it provides an HTML form to enter new events." msgstr "" #. Tag: title -#: tutorial.xml:972 #, no-c-format msgid "Writing the basic servlet" msgstr "" #. Tag: para -#: tutorial.xml:974 #, no-c-format msgid "First we need create our basic processing servlet. Since our servlet only handles HTTP <literal>GET</literal> requests, we will only implement the <literal>doGet()</literal> method:" msgstr "" -#. Tag: programlisting -#: tutorial.xml:980 -#, no-c-format -msgid "" - "<![CDATA[package org.hibernate.tutorial.web;\n" - "\n" - "// Imports\n" - "\n" - "public class EventManagerServlet extends HttpServlet {\n" - "\n" - " protected void doGet(\n" - " HttpServletRequest request,\n" - " HttpServletResponse response) throws ServletException, IOException {\n" - "\n" - " SimpleDateFormat dateFormatter = new SimpleDateFormat( \"dd.MM.yyyy\" );\n" - "\n" - " try {\n" - " // Begin unit of work\n" - " HibernateUtil.getSessionFactory().getCurrentSession().beginTransaction();\n" - "\n" - " // Process request and render page...\n" - "\n" - " // End unit of work\n" - " HibernateUtil.getSessionFactory().getCurrentSession().getTransaction().commit();\n" - " }\n" - " catch (Exception ex) {\n" - " HibernateUtil.getSessionFactory().getCurrentSession().getTransaction().rollback();\n" - " if ( ServletException.class.isInstance( ex ) ) {\n" - " throw ( ServletException ) ex;\n" - " }\n" - " else {\n" - " throw new ServletException( ex );\n" - " }\n" - " }\n" - " }\n" - "\n" - "}]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:982 #, no-c-format msgid "Save this servlet as <filename>src/main/java/org/hibernate/tutorial/web/EventManagerServlet.java</filename>" msgstr "" #. Tag: para -#: tutorial.xml:987 #, no-c-format msgid "The pattern applied here is called <emphasis>session-per-request</emphasis>. When a request hits the servlet, a new Hibernate <literal>Session</literal> is opened through the first call to <literal>getCurrentSession()</literal> on the <literal>SessionFactory</literal>. A database transaction is then started. All data access occurs inside a transaction irrespective of whether the data is read or written. Do not use the auto-commit mode in applications." msgstr "" #. Tag: para -#: tutorial.xml:996 #, no-c-format msgid "Do <emphasis>not</emphasis> use a new Hibernate <literal>Session</literal> for every database operation. Use one Hibernate <literal>Session</literal> that is scoped to the whole request. Use <literal>getCurrentSession()</literal>, so that it is automatically bound to the current Java thread." msgstr "" #. Tag: para -#: tutorial.xml:1003 #, no-c-format msgid "Next, the possible actions of the request are processed and the response HTML is rendered. We will get to that part soon." msgstr "" #. Tag: para -#: tutorial.xml:1008 #, no-c-format msgid "Finally, the unit of work ends when processing and rendering are complete. If any problems occurred during processing or rendering, an exception will be thrown and the database transaction rolled back. This completes the <literal>session-per-request</literal> pattern. Instead of the transaction demarcation code in every servlet, you could also write a servlet filter. See the Hibernate website and Wiki for more information about this pattern called <emphasis>Open Session in View</emphasis>. You will need it as soon as you consider rendering your view in JSP, not in a servlet." msgstr "" #. Tag: title -#: tutorial.xml:1022 #, no-c-format msgid "Processing and rendering" msgstr "" #. Tag: para -#: tutorial.xml:1024 #, no-c-format msgid "Now you can implement the processing of the request and the rendering of the page." msgstr "" -#. Tag: programlisting -#: tutorial.xml:1028 -#, no-c-format -msgid "" - "<![CDATA[ // Write HTML header\n" - " PrintWriter out = response.getWriter();\n" - " out.println(\"<html><head><title>Event Manager</title></head><body>\");\n" - "\n" - " // Handle actions\n" - " if ( \"store\".equals(request.getParameter(\"action\")) ) {\n" - "\n" - " String eventTitle = request.getParameter(\"eventTitle\");\n" - " String eventDate = request.getParameter(\"eventDate\");\n" - "\n" - " if ( \"\".equals(eventTitle) || \"\".equals(eventDate) ) {\n" - " out.println(\"<b><i>Please enter event title and date.</i></b>\");\n" - " }\n" - " else {\n" - " createAndStoreEvent(eventTitle, dateFormatter.parse(eventDate));\n" - " out.println(\"<b><i>Added event.</i></b>\");\n" - " }\n" - " }\n" - "\n" - " // Print page\n" - " printEventForm(out);\n" - " listEvents(out, dateFormatter);\n" - "\n" - " // Write HTML footer\n" - " out.println(\"</body></html>\");\n" - " out.flush();\n" - " out.close();]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:1030 #, no-c-format msgid "This coding style, with a mix of Java and HTML, would not scale in a more complex application—keep in mind that we are only illustrating basic Hibernate concepts in this tutorial. The code prints an HTML header and a footer. Inside this page, an HTML form for event entry and a list of all events in the database are printed. The first method is trivial and only outputs HTML:" msgstr "" -#. Tag: programlisting -#: tutorial.xml:1039 -#, no-c-format -msgid "" - "<![CDATA[ private void printEventForm(PrintWriter out) {\n" - " out.println(\"<h2>Add new event:</h2>\");\n" - " out.println(\"<form>\");\n" - " out.println(\"Title: <input name='eventTitle' length='50'/><br/>\");\n" - " out.println(\"Date (e.g. 24.12.2009): <input name='eventDate' length='10'/><br/>\");\n" - " out.println(\"<input type='submit' name='action' value='store'/>\");\n" - " out.println(\"</form>\");\n" - " }]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:1041 #, no-c-format msgid "The <literal>listEvents()</literal> method uses the Hibernate <literal>Session</literal> bound to the current thread to execute a query:" msgstr "" -#. Tag: programlisting -#: tutorial.xml:1047 -#, no-c-format -msgid "" - "<![CDATA[ private void listEvents(PrintWriter out, SimpleDateFormat dateFormatter) {\n" - "\n" - " List result = HibernateUtil.getSessionFactory()\n" - " .getCurrentSession().createCriteria(Event.class).list();\n" - " if (result.size() > 0) {\n" - " out.println(\"<h2>Events in database:</h2>\");\n" - " out.println(\"<table border='1'>\");\n" - " out.println(\"<tr>\");\n" - " out.println(\"<th>Event title</th>\");\n" - " out.println(\"<th>Event date</th>\");\n" - " out.println(\"</tr>\");\n" - " Iterator it = result.iterator();\n" - " while (it.hasNext()) {\n" - " Event event = (Event) it.next();\n" - " out.println(\"<tr>\");\n" - " out.println(\"<td>\" + event.getTitle() + \"</td>\");\n" - " out.println(\"<td>\" + dateFormatter.format(event.getDate()) + \"</td>\");\n" - " out.println(\"</tr>\");\n" - " }\n" - " out.println(\"</table>\");\n" - " }\n" - " }]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:1049 #, no-c-format msgid "Finally, the <literal>store</literal> action is dispatched to the <literal>createAndStoreEvent()</literal> method, which also uses the <literal>Session</literal> of the current thread:" msgstr "" -#. Tag: programlisting -#: tutorial.xml:1055 -#, no-c-format -msgid "" - "<![CDATA[ protected void createAndStoreEvent(String title, Date theDate) {\n" - " Event theEvent = new Event();\n" - " theEvent.setTitle(title);\n" - " theEvent.setDate(theDate);\n" - "\n" - " HibernateUtil.getSessionFactory()\n" - " .getCurrentSession().save(theEvent);\n" - " }]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:1057 #, no-c-format msgid "The servlet is now complete. A request to the servlet will be processed in a single <literal>Session</literal> and <literal>Transaction</literal>. As earlier in the standalone application, Hibernate can automatically bind these objects to the current thread of execution. This gives you the freedom to layer your code and access the <literal>SessionFactory</literal> in any way you like. Usually you would use a more sophisticated design and move the data access code into data access objects (the DAO pattern). See the Hibernate Wiki for more examples." msgstr "" #. Tag: title -#: tutorial.xml:1071 #, no-c-format msgid "Deploying and testing" msgstr "" #. Tag: para -#: tutorial.xml:1073 #, no-c-format msgid "To deploy this application for testing we must create a Web ARchive (WAR). First we must define the WAR descriptor as <filename>src/main/webapp/WEB-INF/web.xml</filename>" msgstr "" -#. Tag: programlisting -#: tutorial.xml:1079 -#, no-c-format -msgid "" - "<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" - "<web-app version=\"2.4\"\n" - " xmlns=\"http://java.sun.com/xml/ns/j2ee\"\n" - " xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" - " xsi:schemaLocation=\"http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd\">\n" - "\n" - " <servlet>\n" - " <servlet-name>Event Manager</servlet-name>\n" - " <servlet-class>org.hibernate.tutorial.web.EventManagerServlet</servlet-class>\n" - " </servlet>\n" - "\n" - " <servlet-mapping>\n" - " <servlet-name>Event Manager</servlet-name>\n" - " <url-pattern>/eventmanager</url-pattern>\n" - " </servlet-mapping>\n" - "</web-app>]]>" -msgstr "" - #. Tag: para -#: tutorial.xml:1081 #, no-c-format msgid "To build and deploy call <literal>mvn package</literal> in your project directory and copy the <filename>hibernate-tutorial.war</filename> file into your Tomcat <filename>webapps</filename> directory." msgstr "" #. Tag: para -#: tutorial.xml:1088 #, no-c-format -msgid "If you do not have Tomcat installed, download it from <ulink url=\"http://tomcat.apache.org/\"></ulink> and follow the installation instructions. Our application requires no changes to the standard Tomcat configuration." +msgid "If you do not have Tomcat installed, download it from <ulink url=\"http://tomcat.apache.org/\" /> and follow the installation instructions. Our application requires no changes to the standard Tomcat configuration." msgstr "" #. Tag: para -#: tutorial.xml:1096 #, no-c-format msgid "Once deployed and Tomcat is running, access the application at <literal>http://localhost:8080/hibernate-tutorial/eventmanager</literal>. Make sure you watch the Tomcat log to see Hibernate initialize when the first request hits your servlet (the static initializer in <literal>HibernateUtil</literal> is called) and to get the detailed output if any exceptions occurs." msgstr "" #. Tag: title -#: tutorial.xml:1109 #, no-c-format msgid "Summary" msgstr "" #. Tag: para -#: tutorial.xml:1111 #, no-c-format msgid "This tutorial covered the basics of writing a simple standalone Hibernate application and a small web application. More tutorials are available from the Hibernate <ulink url=\"http://hibernate.org\">website</ulink>." msgstr "" Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/xml.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/xml.pot 2010-02-08 04:50:03 UTC (rev 18716) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/content/xml.pot 2010-02-08 04:56:55 UTC (rev 18717) @@ -1,355 +1,143 @@ -# SOME DESCRIPTIVE TITLE. -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. # -#, fuzzy msgid "" msgstr "" -"Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-10 21:02+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:20\n" +"PO-Revision-Date: 2010-01-08T04:07:20\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" "MIME-Version: 1.0\n" -"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Type: application/x-publican; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. Tag: title -#: xml.xml:29 #, no-c-format msgid "XML Mapping" msgstr "" -#. Tag: emphasis -#: xml.xml:31 +#. Tag: para #, no-c-format -msgid "XML Mapping is an experimental feature in Hibernate 3.0 and is currently under active development." +msgid "<emphasis> XML Mapping is an experimental feature in Hibernate 3.0 and is currently under active development. </emphasis>" msgstr "" #. Tag: title -#: xml.xml:37 #, no-c-format msgid "Working with XML data" msgstr "" #. Tag: para -#: xml.xml:39 #, no-c-format msgid "Hibernate allows you to work with persistent XML data in much the same way you work with persistent POJOs. A parsed XML tree can be thought of as another way of representing the relational data at the object level, instead of POJOs." msgstr "" #. Tag: para -#: xml.xml:46 #, no-c-format msgid "Hibernate supports dom4j as API for manipulating XML trees. You can write queries that retrieve dom4j trees from the database and have any modification you make to the tree automatically synchronized to the database. You can even take an XML document, parse it using dom4j, and write it to the database with any of Hibernate's basic operations: <literal>persist(), saveOrUpdate(), merge(), delete(), replicate()</literal> (merging is not yet supported)." msgstr "" #. Tag: para -#: xml.xml:56 #, no-c-format msgid "This feature has many applications including data import/export, externalization of entity data via JMS or SOAP and XSLT-based reporting." msgstr "" #. Tag: para -#: xml.xml:61 #, no-c-format msgid "A single mapping can be used to simultaneously map properties of a class and nodes of an XML document to the database, or, if there is no class to map, it can be used to map just the XML." msgstr "" #. Tag: title -#: xml.xml:68 #, no-c-format msgid "Specifying XML and class mapping together" msgstr "" #. Tag: para -#: xml.xml:70 #, no-c-format msgid "Here is an example of mapping a POJO and XML simultaneously:" msgstr "" -#. Tag: programlisting -#: xml.xml:74 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Account\" \n" - " table=\"ACCOUNTS\" \n" - " node=\"account\">\n" - " \n" - " <id name=\"accountId\" \n" - " column=\"ACCOUNT_ID\" \n" - " node=\"@id\"/>\n" - " \n" - " <many-to-one name=\"customer\" \n" - " column=\"CUSTOMER_ID\" \n" - " node=\"customer/@id\" \n" - " embed-xml=\"false\"/>\n" - " \n" - " <property name=\"balance\" \n" - " column=\"BALANCE\" \n" - " node=\"balance\"/>\n" - " \n" - " ...\n" - " \n" - "</class>]]>" -msgstr "" - #. Tag: title -#: xml.xml:78 #, no-c-format msgid "Specifying only an XML mapping" msgstr "" #. Tag: para -#: xml.xml:80 #, no-c-format msgid "Here is an example where there is no POJO class:" msgstr "" -#. Tag: programlisting -#: xml.xml:84 -#, no-c-format -msgid "" - "<![CDATA[<class entity-name=\"Account\" \n" - " table=\"ACCOUNTS\" \n" - " node=\"account\">\n" - " \n" - " <id name=\"id\" \n" - " column=\"ACCOUNT_ID\" \n" - " node=\"@id\" \n" - " type=\"string\"/>\n" - " \n" - " <many-to-one name=\"customerId\" \n" - " column=\"CUSTOMER_ID\" \n" - " node=\"customer/@id\" \n" - " embed-xml=\"false\" \n" - " entity-name=\"Customer\"/>\n" - " \n" - " <property name=\"balance\" \n" - " column=\"BALANCE\" \n" - " node=\"balance\" \n" - " type=\"big_decimal\"/>\n" - " \n" - " ...\n" - " \n" - "</class>]]>" -msgstr "" - #. Tag: para -#: xml.xml:86 #, no-c-format msgid "This mapping allows you to access the data as a dom4j tree, or as a graph of property name/value pairs or java <literal>Map</literal>s. The property names are purely logical constructs that can be referred to in HQL queries." msgstr "" #. Tag: title -#: xml.xml:97 #, no-c-format msgid "XML mapping metadata" msgstr "" #. Tag: para -#: xml.xml:99 #, no-c-format msgid "A range of Hibernate mapping elements accept the <literal>node</literal> attribute. This lets you specify the name of an XML attribute or element that holds the property or entity data. The format of the <literal>node</literal> attribute must be one of the following:" msgstr "" #. Tag: para -#: xml.xml:108 #, no-c-format msgid "<literal>\"element-name\"</literal>: map to the named XML element" msgstr "" #. Tag: para -#: xml.xml:111 #, no-c-format msgid "<literal>\"@attribute-name\"</literal>: map to the named XML attribute" msgstr "" #. Tag: para -#: xml.xml:114 #, no-c-format msgid "<literal>\".\"</literal>: map to the parent element" msgstr "" #. Tag: para -#: xml.xml:117 #, no-c-format msgid "<literal>\"element-name/@attribute-name\"</literal>: map to the named attribute of the named element" msgstr "" #. Tag: para -#: xml.xml:124 #, no-c-format msgid "For collections and single valued associations, there is an additional <literal>embed-xml</literal> attribute. If <literal>embed-xml=\"true\"</literal>, the default, the XML tree for the associated entity (or collection of value type) will be embedded directly in the XML tree for the entity that owns the association. Otherwise, if <literal>embed-xml=\"false\"</literal>, then only the referenced identifier value will appear in the XML for single point associations and collections will not appear at all." msgstr "" #. Tag: para -#: xml.xml:134 #, no-c-format msgid "Do not leave <literal>embed-xml=\"true\"</literal> for too many associations, since XML does not deal well with circularity." msgstr "" -#. Tag: programlisting -#: xml.xml:139 -#, no-c-format -msgid "" - "<![CDATA[<class name=\"Customer\" \n" - " table=\"CUSTOMER\" \n" - " node=\"customer\">\n" - " \n" - " <id name=\"id\" \n" - " column=\"CUST_ID\" \n" - " node=\"@id\"/>\n" - " \n" - " <map name=\"accounts\" \n" - " node=\".\" \n" - " embed-xml=\"true\">\n" - " <key column=\"CUSTOMER_ID\" \n" - " not-null=\"true\"/>\n" - " <map-key column=\"SHORT_DESC\" \n" - " node=\"@short-desc\" \n" - " type=\"string\"/>\n" - " <one-to-many entity-name=\"Account\"\n" - " embed-xml=\"false\" \n" - " node=\"account\"/>\n" - " </map>\n" - " \n" - " <component name=\"name\" \n" - " node=\"name\">\n" - " <property name=\"firstName\" \n" - " node=\"first-name\"/>\n" - " <property name=\"initial\" \n" - " node=\"initial\"/>\n" - " <property name=\"lastName\" \n" - " node=\"last-name\"/>\n" - " </component>\n" - " \n" - " ...\n" - " \n" - "</class>]]>" -msgstr "" - #. Tag: para -#: xml.xml:141 #, no-c-format msgid "In this case, the collection of account ids is embedded, but not the actual account data. The following HQL query:" msgstr "" -#. Tag: programlisting -#: xml.xml:146 -#, no-c-format -msgid "<![CDATA[from Customer c left join fetch c.accounts where c.lastName like :lastName]]>" -msgstr "" - #. Tag: para -#: xml.xml:148 #, no-c-format msgid "would return datasets such as this:" msgstr "" -#. Tag: programlisting -#: xml.xml:152 -#, no-c-format -msgid "" - "<![CDATA[<customer id=\"123456789\">\n" - " <account short-desc=\"Savings\">987632567</account>\n" - " <account short-desc=\"Credit Card\">985612323</account>\n" - " <name>\n" - " <first-name>Gavin</first-name>\n" - " <initial>A</initial>\n" - " <last-name>King</last-name>\n" - " </name>\n" - " ...\n" - "</customer>]]>" -msgstr "" - #. Tag: para -#: xml.xml:154 #, no-c-format msgid "If you set <literal>embed-xml=\"true\"</literal> on the <literal><one-to-many></literal> mapping, the data might look more like this:" msgstr "" -#. Tag: programlisting -#: xml.xml:159 -#, no-c-format -msgid "" - "<![CDATA[<customer id=\"123456789\">\n" - " <account id=\"987632567\" short-desc=\"Savings\">\n" - " <customer id=\"123456789\"/>\n" - " <balance>100.29</balance>\n" - " </account>\n" - " <account id=\"985612323\" short-desc=\"Credit Card\">\n" - " <customer id=\"123456789\"/>\n" - " <balance>-2370.34</balance>\n" - " </account>\n" - " <name>\n" - " <first-name>Gavin</first-name>\n" - " <initial>A</initial>\n" - " <last-name>King</last-name>\n" - " </name>\n" - " ...\n" - "</customer>]]>" -msgstr "" - #. Tag: title -#: xml.xml:165 #, no-c-format msgid "Manipulating XML data" msgstr "" #. Tag: para -#: xml.xml:167 #, no-c-format msgid "You can also re-read and update XML documents in the application. You can do this by obtaining a dom4j session:" msgstr "" -#. Tag: programlisting -#: xml.xml:172 -#, no-c-format -msgid "" - "<![CDATA[Document doc = ....;\n" - " \n" - "Session session = factory.openSession();\n" - "Session dom4jSession = session.getSession(EntityMode.DOM4J);\n" - "Transaction tx = session.beginTransaction();\n" - "\n" - "List results = dom4jSession\n" - " .createQuery(\"from Customer c left join fetch c.accounts where c.lastName like :lastName\")\n" - " .list();\n" - "for ( int i=0; i<results.size(); i++ ) {\n" - " //add the customer data to the XML document\n" - " Element customer = (Element) results.get(i);\n" - " doc.add(customer);\n" - "}\n" - "\n" - "tx.commit();\n" - "session.close();]]>" -msgstr "" - -#. Tag: programlisting -#: xml.xml:174 -#, no-c-format -msgid "" - "<![CDATA[Session session = factory.openSession();\n" - "Session dom4jSession = session.getSession(EntityMode.DOM4J);\n" - "Transaction tx = session.beginTransaction();\n" - "\n" - "Element cust = (Element) dom4jSession.get(\"Customer\", customerId);\n" - "for ( int i=0; i<results.size(); i++ ) {\n" - " Element customer = (Element) results.get(i);\n" - " //change the customer name in the XML and database\n" - " Element name = customer.element(\"name\");\n" - " name.element(\"first-name\").setText(firstName);\n" - " name.element(\"initial\").setText(initial);\n" - " name.element(\"last-name\").setText(lastName);\n" - "}\n" - "\n" - "tx.commit();\n" - "session.close();]]>" -msgstr "" - #. Tag: para -#: xml.xml:176 #, no-c-format msgid "When implementing XML-based data import/export, it is useful to combine this feature with Hibernate's <literal>replicate()</literal> operation." msgstr "" Deleted: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/legal_notice.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/legal_notice.pot 2010-02-08 04:50:03 UTC (rev 18716) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/legal_notice.pot 2010-02-08 04:56:55 UTC (rev 18717) @@ -1,58 +0,0 @@ -# SOME DESCRIPTIVE TITLE. -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. -# -#, fuzzy -msgid "" -msgstr "" -"Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-16 18:47+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" -"MIME-Version: 1.0\n" -"Content-Type: application/x-xml2pot; charset=UTF-8\n" -"Content-Transfer-Encoding: 8bit\n" - -#. Tag: title -#: legal_notice.xml:28 -#, no-c-format -msgid "Legal Notice" -msgstr "" - -#. Tag: address -#: legal_notice.xml:30 -#, no-c-format -msgid "<street>1801 Varsity Drive</street> <city>Raleigh</city>, <state>NC</state><postcode>27606-2072</postcode><country>USA</country> <phone>Phone: +1 919 754 3700</phone> <phone>Phone: 888 733 4281</phone> <fax>Fax: +1 919 754 3701</fax> <pob>PO Box 13588</pob><city>Research Triangle Park</city>, <state>NC</state><postcode>27709</postcode><country>USA</country>" -msgstr "" - -#. Tag: para -#: legal_notice.xml:39 -#, no-c-format -msgid "Copyright <trademark class=\"copyright\"></trademark> 2007 by Red Hat, Inc. This copyrighted material is made available to anyone wishing to use, modify, copy, or redistribute it subject to the terms and conditions of the GNU <ulink url=\"http://www.gnu.org/licenses/lgpl-2.1.html\">Lesser General Public License</ulink>, as published by the Free Software Foundation." -msgstr "" - -#. Tag: para -#: legal_notice.xml:45 -#, no-c-format -msgid "Red Hat and the Red Hat \"Shadow Man\" logo are registered trademarks of Red Hat, Inc. in the United States and other countries." -msgstr "" - -#. Tag: para -#: legal_notice.xml:48 -#, no-c-format -msgid "All other trademarks referenced herein are the property of their respective owners." -msgstr "" - -#. Tag: para -#: legal_notice.xml:51 -#, no-c-format -msgid "The GPG fingerprint of the security(a)redhat.com key is:" -msgstr "" - -#. Tag: para -#: legal_notice.xml:54 -#, no-c-format -msgid "CA 20 86 86 2B D6 9D FC 65 F6 EC C4 21 91 80 CD DB 42 A6 0E" -msgstr "" -

15 years, 8 months

1
0
0 / 0

Hibernate SVN: r18716 - core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot.

by hibernate-commits＠lists.jboss.org

Author: stliu Date: 2010-02-07 23:50:03 -0500 (Sun, 07 Feb 2010) New Revision: 18716 Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Author_Group.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Book_Info.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Feedback.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Hibernate_Core_Reference_Guide.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Revision_History.pot Removed: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Hibernate_Reference.pot core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/author_group.pot Log: HHH-4729 Import work done by Red Hat translation team Copied: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Author_Group.pot (from rev 18713, core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/author_group.pot) =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Author_Group.pot (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Author_Group.pot 2010-02-08 04:50:03 UTC (rev 18716) @@ -0,0 +1,190 @@ +# SOME DESCRIPTIVE TITLE. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2009-06-16 18:47+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <kde-i18n-doc(a)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:27 +#, no-c-format +msgid "<firstname>Gavin</firstname> <surname>King</surname>" +msgstr "" + +#. Tag: author +#: author_group.xml:31 +#, no-c-format +msgid "<firstname>Christian</firstname> <surname>Bauer</surname>" +msgstr "" + +#. Tag: author +#: author_group.xml:35 +#, no-c-format +msgid "<firstname>Max</firstname> <othername>Rydahl</othername> <surname>Andersen</surname>" +msgstr "" + +#. Tag: author +#: author_group.xml:40 +#, no-c-format +msgid "<author><firstname>Emmanuel</firstname> <surname>Bernard</surname></author>" +msgstr "" + +#. Tag: author +#: author_group.xml:44 +#, no-c-format +msgid "<firstname>Steve</firstname> <surname>Ebersole</surname>" +msgstr "" + +#. Tag: othercredit +#: author_group.xml:49 +#, no-c-format +msgid "<firstname>James</firstname> <surname>Cobb</surname>" +msgstr "" + +#. Tag: shortaffil +#: author_group.xml:53 author_group.xml:60 +#, no-c-format +msgid "Graphic Design" +msgstr "" + +#. Tag: othercredit +#: author_group.xml:56 +#, no-c-format +msgid "<firstname>Cheyenne</firstname> <surname>Weaver</surname>" +msgstr "" + +#. Tag: othercredit +#: author_group.xml:69 +#, no-c-format +msgid "<othername><![CDATA[Bernardo Antonio Buffa Colom&#x00e9]]></othername> <email>kreimer(a)bbs.frc.utn.edu.ar</email>" +msgstr "" + +#. Tag: othercredit +#: author_group.xml:79 +#, no-c-format +msgid "<firstname>Vincent</firstname> <surname>Ricard</surname>" +msgstr "" + +#. Tag: othercredit +#: author_group.xml:83 +#, no-c-format +msgid "<firstname>Sebastien</firstname> <surname>Cesbron</surname>" +msgstr "" + +#. Tag: othercredit +#: author_group.xml:87 +#, no-c-format +msgid "<firstname>Michael</firstname> <surname>Courcy</surname>" +msgstr "" + +#. Tag: othercredit +#: author_group.xml:91 +#, no-c-format +msgid "<firstname>Vincent</firstname> <surname>Giguère</surname>" +msgstr "" + +#. Tag: othercredit +#: author_group.xml:95 +#, no-c-format +msgid "<firstname>Baptiste</firstname> <surname>Mathus</surname>" +msgstr "" + +#. Tag: othercredit +#: author_group.xml:99 +#, no-c-format +msgid "<othercredit><firstname>Emmanuel</firstname> <surname>Bernard</surname></othercredit>" +msgstr "" + +#. Tag: othercredit +#: author_group.xml:103 +#, no-c-format +msgid "<firstname>Anthony</firstname> <surname>Patricio</surname>" +msgstr "" + +#. Tag: othercredit +#: author_group.xml:113 +#, no-c-format +msgid "<firstname>Alvaro</firstname> <surname>Netto</surname> <email>alvaronetto(a)cetip.com.br</email>" +msgstr "" + +#. Tag: othercredit +#: author_group.xml:118 +#, no-c-format +msgid "<firstname>Anderson</firstname> <surname>Braulio</surname> <email>andersonbraulio(a)gmail.com</email>" +msgstr "" + +#. Tag: othercredit +#: author_group.xml:123 +#, no-c-format +msgid "<firstname>Daniel Vieira</firstname> <surname>Costa</surname> <email>danielvc(a)gmail.com</email>" +msgstr "" + +#. Tag: othercredit +#: author_group.xml:128 +#, no-c-format +msgid "<firstname>Francisco</firstname> <surname>gamarra</surname> <email>francisco.gamarra(a)gmail.com</email>" +msgstr "" + +#. Tag: othercredit +#: author_group.xml:133 +#, no-c-format +msgid "<firstname>Gamarra</firstname> <email>mauricio.gamarra(a)gmail.com</email>" +msgstr "" + +#. Tag: othercredit +#: author_group.xml:137 +#, no-c-format +msgid "<firstname>Luiz Carlos</firstname> <surname>Rodrigues</surname> <email>luizcarlos_rodrigues(a)yahoo.com.br</email>" +msgstr "" + +#. Tag: othercredit +#: author_group.xml:142 +#, no-c-format +msgid "<firstname>Marcel</firstname> <surname>Castelo</surname> <email>marcel.castelo(a)gmail.com</email>" +msgstr "" + +#. Tag: othercredit +#: author_group.xml:147 +#, no-c-format +msgid "<firstname>Paulo</firstname> <surname>César</surname> <email>paulocol(a)gmail.com</email>" +msgstr "" + +#. Tag: othercredit +#: author_group.xml:152 +#, no-c-format +msgid "<firstname>Pablo L.</firstname> <surname>de Miranda</surname> <email>pablolmiranda(a)gmail.com</email>" +msgstr "" + +#. Tag: othercredit +#: author_group.xml:157 +#, no-c-format +msgid "<firstname>Renato</firstname> <surname>Deggau</surname> <email>rdeggau(a)gmail.com</email>" +msgstr "" + +#. Tag: othercredit +#: author_group.xml:162 +#, no-c-format +msgid "<firstname>Rogério</firstname> <surname>Araújo</surname> <email>rgildoaraujo(a)yahoo.com.br</email>" +msgstr "" + +#. Tag: othercredit +#: author_group.xml:167 +#, no-c-format +msgid "<firstname>Wanderson</firstname> <surname>Siqueira</surname> <email>wandersonxs(a)gmail.com</email>" +msgstr "" + +#. Tag: othercredit +#: author_group.xml:178 +#, no-c-format +msgid "<firstname>Cao</firstname> <surname>Xiaogang</surname> <affiliation> <orgname>RedSaga</orgname> </affiliation> <contrib>Translation Lead</contrib> <email>caoxg(a)yahoo.com</email>" +msgstr "" + Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Book_Info.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Book_Info.pot (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Book_Info.pot 2010-02-08 04:50:03 UTC (rev 18716) @@ -0,0 +1,29 @@ +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. +# +msgid "" +msgstr "" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:17\n" +"PO-Revision-Date: 2010-01-08T04:07:17\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" +"MIME-Version: 1.0\n" +"Content-Type: application/x-publican; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#, no-c-format +msgid "Hibernate Core Reference Guide" +msgstr "" + +#. Tag: subtitle +#, no-c-format +msgid "by Gavin King, Christian Bauer, Max Rydahl Andersen, Emmanuel Bernard, and Steve Ebersole and thanks to James Cobb (Graphic Design) and Cheyenne Weaver (Graphic Design)" +msgstr "" + +#. Tag: para +#, no-c-format +msgid "The JBoss Hibernate Core 3.3.2.GA Reference Guide" +msgstr "" + Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Feedback.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Feedback.pot (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Feedback.pot 2010-02-08 04:50:03 UTC (rev 18716) @@ -0,0 +1,24 @@ +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. +# +msgid "" +msgstr "" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:17\n" +"PO-Revision-Date: 2010-01-08T04:07:17\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" +"MIME-Version: 1.0\n" +"Content-Type: application/x-publican; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#, no-c-format +msgid "Feedback" +msgstr "" + +#. Tag: para +#, 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 "" + Copied: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Hibernate_Core_Reference_Guide.pot (from rev 18713, core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Hibernate_Reference.pot) =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Hibernate_Core_Reference_Guide.pot (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Hibernate_Core_Reference_Guide.pot 2010-02-08 04:50:03 UTC (rev 18716) @@ -0,0 +1,34 @@ +# SOME DESCRIPTIVE TITLE. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2009-06-24 02:10+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: application/x-xml2pot; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: Hibernate_Reference.xml:35 +#, no-c-format +msgid "HIBERNATE - Relational Persistence for Idiomatic Java" +msgstr "" + +#. Tag: subtitle +#: Hibernate_Reference.xml:36 +#, no-c-format +msgid "Hibernate Reference Documentation" +msgstr "" + +#. Tag: holder +#: Hibernate_Reference.xml:51 +#, no-c-format +msgid "&copyrightHolder;" +msgstr "" + Deleted: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Hibernate_Reference.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Hibernate_Reference.pot 2010-02-08 04:24:37 UTC (rev 18715) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Hibernate_Reference.pot 2010-02-08 04:50:03 UTC (rev 18716) @@ -1,34 +0,0 @@ -# SOME DESCRIPTIVE TITLE. -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. -# -#, fuzzy -msgid "" -msgstr "" -"Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-24 02:10+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org>\n" -"MIME-Version: 1.0\n" -"Content-Type: application/x-xml2pot; charset=UTF-8\n" -"Content-Transfer-Encoding: 8bit\n" - -#. Tag: title -#: Hibernate_Reference.xml:35 -#, no-c-format -msgid "HIBERNATE - Relational Persistence for Idiomatic Java" -msgstr "" - -#. Tag: subtitle -#: Hibernate_Reference.xml:36 -#, no-c-format -msgid "Hibernate Reference Documentation" -msgstr "" - -#. Tag: holder -#: Hibernate_Reference.xml:51 -#, no-c-format -msgid "&copyrightHolder;" -msgstr "" - Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Revision_History.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Revision_History.pot (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/Revision_History.pot 2010-02-08 04:50:03 UTC (rev 18716) @@ -0,0 +1,24 @@ +# +# AUTHOR <EMAIL@ADDRESS>, YEAR. +# +msgid "" +msgstr "" +"Project-Id-Version: 0\n" +"POT-Creation-Date: 2010-01-08T04:07:17\n" +"PO-Revision-Date: 2010-01-08T04:07:17\n" +"Last-Translator: Automatically generated\n" +"Language-Team: None\n" +"MIME-Version: 1.0\n" +"Content-Type: application/x-publican; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#, no-c-format +msgid "Revision History" +msgstr "" + +#. Tag: member +#, no-c-format +msgid "Merged with EAP5 and translations added" +msgstr "" + Deleted: core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/author_group.pot =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/author_group.pot 2010-02-08 04:24:37 UTC (rev 18715) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/pot/author_group.pot 2010-02-08 04:50:03 UTC (rev 18716) @@ -1,190 +0,0 @@ -# SOME DESCRIPTIVE TITLE. -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. -# -#, fuzzy -msgid "" -msgstr "" -"Project-Id-Version: PACKAGE VERSION\n" -"Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2009-06-16 18:47+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Language-Team: LANGUAGE <kde-i18n-doc(a)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:27 -#, no-c-format -msgid "<firstname>Gavin</firstname> <surname>King</surname>" -msgstr "" - -#. Tag: author -#: author_group.xml:31 -#, no-c-format -msgid "<firstname>Christian</firstname> <surname>Bauer</surname>" -msgstr "" - -#. Tag: author -#: author_group.xml:35 -#, no-c-format -msgid "<firstname>Max</firstname> <othername>Rydahl</othername> <surname>Andersen</surname>" -msgstr "" - -#. Tag: author -#: author_group.xml:40 -#, no-c-format -msgid "<author><firstname>Emmanuel</firstname> <surname>Bernard</surname></author>" -msgstr "" - -#. Tag: author -#: author_group.xml:44 -#, no-c-format -msgid "<firstname>Steve</firstname> <surname>Ebersole</surname>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:49 -#, no-c-format -msgid "<firstname>James</firstname> <surname>Cobb</surname>" -msgstr "" - -#. Tag: shortaffil -#: author_group.xml:53 author_group.xml:60 -#, no-c-format -msgid "Graphic Design" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:56 -#, no-c-format -msgid "<firstname>Cheyenne</firstname> <surname>Weaver</surname>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:69 -#, no-c-format -msgid "<othername><![CDATA[Bernardo Antonio Buffa Colom&#x00e9]]></othername> <email>kreimer(a)bbs.frc.utn.edu.ar</email>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:79 -#, no-c-format -msgid "<firstname>Vincent</firstname> <surname>Ricard</surname>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:83 -#, no-c-format -msgid "<firstname>Sebastien</firstname> <surname>Cesbron</surname>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:87 -#, no-c-format -msgid "<firstname>Michael</firstname> <surname>Courcy</surname>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:91 -#, no-c-format -msgid "<firstname>Vincent</firstname> <surname>Giguère</surname>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:95 -#, no-c-format -msgid "<firstname>Baptiste</firstname> <surname>Mathus</surname>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:99 -#, no-c-format -msgid "<othercredit><firstname>Emmanuel</firstname> <surname>Bernard</surname></othercredit>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:103 -#, no-c-format -msgid "<firstname>Anthony</firstname> <surname>Patricio</surname>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:113 -#, no-c-format -msgid "<firstname>Alvaro</firstname> <surname>Netto</surname> <email>alvaronetto(a)cetip.com.br</email>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:118 -#, no-c-format -msgid "<firstname>Anderson</firstname> <surname>Braulio</surname> <email>andersonbraulio(a)gmail.com</email>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:123 -#, no-c-format -msgid "<firstname>Daniel Vieira</firstname> <surname>Costa</surname> <email>danielvc(a)gmail.com</email>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:128 -#, no-c-format -msgid "<firstname>Francisco</firstname> <surname>gamarra</surname> <email>francisco.gamarra(a)gmail.com</email>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:133 -#, no-c-format -msgid "<firstname>Gamarra</firstname> <email>mauricio.gamarra(a)gmail.com</email>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:137 -#, no-c-format -msgid "<firstname>Luiz Carlos</firstname> <surname>Rodrigues</surname> <email>luizcarlos_rodrigues(a)yahoo.com.br</email>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:142 -#, no-c-format -msgid "<firstname>Marcel</firstname> <surname>Castelo</surname> <email>marcel.castelo(a)gmail.com</email>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:147 -#, no-c-format -msgid "<firstname>Paulo</firstname> <surname>César</surname> <email>paulocol(a)gmail.com</email>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:152 -#, no-c-format -msgid "<firstname>Pablo L.</firstname> <surname>de Miranda</surname> <email>pablolmiranda(a)gmail.com</email>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:157 -#, no-c-format -msgid "<firstname>Renato</firstname> <surname>Deggau</surname> <email>rdeggau(a)gmail.com</email>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:162 -#, no-c-format -msgid "<firstname>Rogério</firstname> <surname>Araújo</surname> <email>rgildoaraujo(a)yahoo.com.br</email>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:167 -#, no-c-format -msgid "<firstname>Wanderson</firstname> <surname>Siqueira</surname> <email>wandersonxs(a)gmail.com</email>" -msgstr "" - -#. Tag: othercredit -#: author_group.xml:178 -#, no-c-format -msgid "<firstname>Cao</firstname> <surname>Xiaogang</surname> <affiliation> <orgname>RedSaga</orgname> </affiliation> <contrib>Translation Lead</contrib> <email>caoxg(a)yahoo.com</email>" -msgstr "" -

15 years, 8 months

1
0
0 / 0

Hibernate SVN: r18715 - core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content.

by hibernate-commits＠lists.jboss.org

Author: stliu Date: 2010-02-07 23:24:37 -0500 (Sun, 07 Feb 2010) New Revision: 18715 Removed: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/bibliography.xml Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/Preface.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/architecture.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/association_mapping.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/basic_mapping.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/batch.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/best_practices.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/collection_mapping.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/component_mapping.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/configuration.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/events.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/example_mappings.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/example_parentchild.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/example_weblog.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/filters.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/inheritance_mapping.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/performance.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/persistent_classes.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/portability.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/query_criteria.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/query_hql.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/query_sql.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/session_api.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/toolset_guide.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/transactions.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/tutorial.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/xml.xml Log: HHH-4729 Import work done by Red Hat translation team Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/Preface.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/Preface.xml 2010-02-08 04:15:14 UTC (rev 18714) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/Preface.xml 2010-02-08 04:24:37 UTC (rev 18715) @@ -1,4 +1,8 @@ -<?xml version='1.0' encoding="UTF-8"?> +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Hibernate_Core_Reference_Guide.ent"> +%BOOK_ENTITIES; +]>  -<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> - -<preface id="preface"> +<preface> <title>Preface</title> <para> Working with object-oriented software and a relational database can be cumbersome - and time consuming in today's enterprise environments. Hibernate is an Object/Relational - Mapping tool for Java environments. The term Object/Relational Mapping (ORM) refers to + and time consuming in today's enterprise environments. Hibernate is an object/relational + mapping tool for Java environments. The term object/relational mapping (ORM) refers to the technique of mapping a data representation from an object model to a relational data model with a SQL-based schema. </para> @@ -86,12 +88,12 @@ </listitem> <listitem> <para> - Use this reference documentation as your primary source of - information. Consider reading <biblioref linkend="biblio-JPwH"/> - if you need more help with application design, or if you prefer - a step-by-step tutorial. Also visit - <ulink url="http://caveatemptor.hibernate.org"/> and download - the example application from <biblioref linkend="biblio-JPwH"/>. + Use this reference documentation as your primary source of information. + Consider reading <emphasis>Java Persistence with Hibernate</emphasis> + (http://www.manning.com/bauer2) if you need more help with application + design, or if you prefer a step-by-step tutorial. Also visit + http://caveatemptor.hibernate.org and download the example application + for Java Persistence with Hibernate. </para> </listitem> <listitem> @@ -101,8 +103,8 @@ </listitem> <listitem> <para> - Links to third party demos, examples, and tutorials are maintained - on the Hibernate website. + Third party demos, examples, and tutorials are linked on the Hibernate + website. </para> </listitem> <listitem> @@ -128,13 +130,22 @@ Hibernate is a Professional Open Source project and a critical component of the JBoss Enterprise Middleware System (JEMS) suite of products. </para> - - <section> + +  +  + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" + href="Common_Content/Conventions.xml"> +  + <xi:fallback xmlns:xi="http://www.w3.org/2001/XInclude"/> + </xi:include> + + <section> <title>Feedback</title> <para> Use <ulink url="http://opensource.atlassian.com/projects/hibernate">Hibernate JIRA</ulink> to report errors or request enhacements to this documentation. </para> - </section> + </section> + </preface> Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/architecture.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/architecture.xml 2010-02-08 04:15:14 UTC (rev 18714) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/architecture.xml 2010-02-08 04:24:37 UTC (rev 18715) @@ -1,4 +1,9 @@ -<?xml version='1.0' encoding="UTF-8"?> +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Hibernate_Core_Reference_Guide.ent"> +%BOOK_ENTITIES; +]> +  - -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> - <chapter id="architecture"> <title>Architecture</title> - <sect1 id="architecture-overview" revision="1"> + <section id="architecture-overview" revision="1"> <title>Overview</title> <para> @@ -38,15 +40,13 @@ <mediaobject> <imageobject role="fo"> - <imagedata fileref="../images/overview.svg" format="SVG" align="center"/> + <imagedata fileref="images/overview.svg" format="SVG" align="center"/> </imageobject> <imageobject role="html"> - <imagedata fileref="../images/overview.png" format="PNG" align="center"/> + <imagedata fileref="images/overview.png" format="PNG" align="center"/> </imageobject> </mediaobject> - - <para> We do not have the scope in this document to provide a more detailed view of all the runtime architectures available; Hibernate is flexible and supports several different approaches. We will, however, @@ -58,34 +58,32 @@ provide persistence services, and persistent objects, to the application. </para> - <para> - The "minimal" architecture has the application + <para> + The "minimal" architecture has the application provide its own JDBC connections and manage its own transactions. This approach uses a minimal subset of Hibernate's APIs: </para> <mediaobject> <imageobject role="fo"> - <imagedata fileref="../images/lite.svg" format="SVG" align="center"/> + <imagedata fileref="images/lite.svg" format="SVG" align="center"/> </imageobject> <imageobject role="html"> - <imagedata fileref="../images/lite.png" format="PNG" align="center"/> + <imagedata fileref="images/lite.png" format="PNG" align="center"/> </imageobject> </mediaobject> - - - <para> + <para> The "comprehensive" architecture abstracts the application away from the underlying JDBC/JTA APIs and allows Hibernate to manage the details. </para> <mediaobject> <imageobject role="fo"> - <imagedata fileref="../images/full_cream.svg" format="SVG" align="center"/> + <imagedata fileref="images/full_cream.svg" format="SVG" align="center"/> </imageobject> <imageobject role="html"> - <imagedata fileref="../images/full_cream.png" format="PNG" align="center"/> + <imagedata fileref="images/full_cream.png" format="PNG" align="center"/> </imageobject> </mediaobject> @@ -189,9 +187,9 @@ <literal>Transaction</literal>/<literal>TransactionFactory</literal> and/or <literal>ConnectionProvider</literal> APIs to communicate with JTA or JDBC directly. </para> - </sect1> + </section> - <sect1 id="architecture-states" revision="1"> + <section id="architecture-states" revision="1"> <title>Instance states</title> <para> An instance of a persistent class can be in one of three different states. These states are @@ -239,9 +237,9 @@ </listitem> </varlistentry> </variablelist> - </sect1> + </section> - <sect1 id="architecture-jmx" revision="1"> + <section id="architecture-jmx" revision="1"> <title>JMX Integration</title> <para> @@ -289,17 +287,17 @@ Another feature available as a JMX service is runtime Hibernate statistics. See <xref linkend="configuration-optional-statistics"/> for more information. </para> - </sect1> + </section> - <sect1 id="architecture-jca" revision="1"> + <section id="architecture-jca" revision="1"> <title>JCA Support</title> <para> Hibernate can also be configured as a JCA connector. Please see the website for more information. Please note, however, that at this stage Hibernate JCA support is under development. </para> - </sect1> + </section> - <sect1 id="architecture-current-session" revision="2"> + <section id="architecture-current-session" revision="2"> <title>Contextual sessions</title> <para> Most applications using Hibernate need some form of "contextual" session, where a given @@ -383,7 +381,7 @@ short names: "jta", "thread", and "managed". </para> - </sect1> + </section> </chapter> Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/association_mapping.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/association_mapping.xml 2010-02-08 04:15:14 UTC (rev 18714) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/association_mapping.xml 2010-02-08 04:24:37 UTC (rev 18715) @@ -1,4 +1,9 @@ -<?xml version='1.0' encoding="UTF-8"?> +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Hibernate_Core_Reference_Guide.ent"> +%BOOK_ENTITIES; +]> +  - -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> - <chapter id="associations"> <title>Association Mappings</title> - <sect1 id="assoc-intro" revision="1"> + <section id="assoc-intro" revision="1"> <title>Introduction</title> <para> @@ -52,12 +54,12 @@ nullability constraints. </para> - </sect1> + </section> - <sect1 id="assoc-unidirectional" revision="1"> + <section id="assoc-unidirectional" revision="1"> <title>Unidirectional associations</title> - <sect2 id="assoc-unidirectional-m21"> + <section id="assoc-unidirectional-m21"> <title>Many-to-one</title> <para> @@ -84,9 +86,9 @@ create table Address ( addressId bigint not null primary key ) ]]></programlisting> - </sect2> + </section> - <sect2 id="assoc-unidirectional-121"> + <section id="assoc-unidirectional-121"> <title>One-to-one</title> <para> @@ -139,9 +141,9 @@ create table Address ( personId bigint not null primary key ) ]]></programlisting> - </sect2> + </section> - <sect2 id="assoc-unidirectional-12m"> + <section id="assoc-unidirectional-12m"> <title>One-to-many</title> <para> @@ -174,14 +176,14 @@ You should instead use a join table for this kind of association. </para> - </sect2> + </section> - </sect1> + </section> - <sect1 id="assoc-unidirectional-join" revision="1"> + <section id="assoc-unidirectional-join" revision="1"> <title>Unidirectional associations with join tables</title> - <sect2 id="assoc-unidirectional-join-12m"> + <section id="assoc-unidirectional-join-12m"> <title>One-to-many</title> <para> @@ -213,9 +215,9 @@ create table Address ( addressId bigint not null primary key ) ]]></programlisting> - </sect2> + </section> - <sect2 id="assoc-unidirectional-join-m21"> + <section id="assoc-unidirectional-join-m21"> <title>Many-to-one</title> <para> @@ -247,9 +249,9 @@ create table Address ( addressId bigint not null primary key ) ]]></programlisting> - </sect2> + </section> - <sect2 id="assoc-unidirectional-join-121"> + <section id="assoc-unidirectional-join-121"> <title>One-to-one</title> <para> @@ -283,9 +285,9 @@ create table Address ( addressId bigint not null primary key ) ]]></programlisting> - </sect2> + </section> - <sect2 id="assoc-unidirectional-join-m2m"> + <section id="assoc-unidirectional-join-m2m"> <title>Many-to-many</title> <para> @@ -314,14 +316,14 @@ create table Address ( addressId bigint not null primary key ) ]]></programlisting> - </sect2> + </section> - </sect1> + </section> - <sect1 id="assoc-bidirectional" revision="1"> + <section id="assoc-bidirectional" revision="1"> <title>Bidirectional associations</title> - <sect2 id="assoc-bidirectional-m21" revision="2"> + <section id="assoc-bidirectional-m21" revision="2"> <title>one-to-many / many-to-one</title> <para> @@ -392,9 +394,9 @@ element. </para> - </sect2> + </section> - <sect2 id="assoc-bidirectional-121"> + <section id="assoc-bidirectional-121"> <title>One-to-one</title> <para> @@ -450,14 +452,14 @@ create table Address ( personId bigint not null primary key ) ]]></programlisting> - </sect2> + </section> - </sect1> + </section> - <sect1 id="assoc-bidirectional-join" revision="1"> + <section id="assoc-bidirectional-join" revision="1"> <title>Bidirectional associations with join tables</title> - <sect2 id="assoc-bidirectional-join-12m"> + <section id="assoc-bidirectional-join-12m"> <title>one-to-many / many-to-one</title> <para> @@ -498,9 +500,9 @@ create table Address ( addressId bigint not null primary key ) ]]></programlisting> - </sect2> + </section> - <sect2 id="assoc-bidirectional-join-121"> + <section id="assoc-bidirectional-join-121"> <title>one to one</title> <para> @@ -544,9 +546,9 @@ create table Address ( addressId bigint not null primary key ) ]]></programlisting> - </sect2> + </section> - <sect2 id="assoc-bidirectional-join-m2m" revision="1"> + <section id="assoc-bidirectional-join-m2m" revision="1"> <title>Many-to-many</title> <para> @@ -581,11 +583,11 @@ create table Address ( addressId bigint not null primary key ) ]]></programlisting> - </sect2> + </section> - </sect1> + </section> - <sect1 id="assoc-complex"> + <section id="assoc-complex"> <title>More complex association mappings</title> <para> @@ -644,7 +646,7 @@ to handle these kinds of cases using HQL or a criteria query. </para> - </sect1> + </section> </chapter> Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/basic_mapping.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/basic_mapping.xml 2010-02-08 04:15:14 UTC (rev 18714) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/basic_mapping.xml 2010-02-08 04:24:37 UTC (rev 18715) @@ -1,4 +1,8 @@ -<?xml version='1.0' encoding="UTF-8"?> +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Hibernate_Core_Reference_Guide.ent"> +%BOOK_ENTITIES; +]>  -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> - <chapter id="mapping"> <title>Basic O/R Mapping</title> - <sect1 id="mapping-declaration" revision="2"> + <section id="mapping-declaration" revision="2"> <title>Mapping declaration</title> <para> @@ -48,7 +50,8 @@ Here is an example mapping: </para> - <programlisting id="mapping-declaration-ex1" revision="1"><![CDATA[<?xml version="1.0"?> +  + <programlisting><![CDATA[<?xml version="1.0"?> <!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 3.0//EN" "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd"> @@ -123,7 +126,7 @@ - <sect2 id="mapping-declaration-doctype" revision="3"> + <section id="mapping-declaration-doctype" revision="3"> <title>Doctype</title> <para> @@ -135,7 +138,7 @@ classpath. </para> - <sect3 id="mapping-declaration-entity-resolution"> + <section id="mapping-declaration-entity-resolution"> <title>EntityResolver</title> <para> Hibernate will first attempt to resolve DTDs in its classpath. @@ -166,29 +169,18 @@ <para> The following is an example of utilizing user namespacing: </para> - <programlisting><![CDATA[<?xml version="1.0"?> -<!DOCTYPE hibernate-mapping PUBLIC - "-//Hibernate/Hibernate Mapping DTD 3.0//EN" - "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd" [ - <!ENTITY types SYSTEM "classpath://your/domain/types.xml"> -]> - -<hibernate-mapping package="your.domain"> - <class name="MyEntity"> - <id name="id" type="my-custom-id-type"> - ... - </id> - <class> - &types; -</hibernate-mapping>]]></programlisting> + <programlisting language="XML" role="XML"> +<xi:include parse="text" href="../extras/namespacing.xml_sample" xmlns:xi="http://www.w3.org/2001/XInclude" /> +</programlisting> + <para> Where <literal>types.xml</literal> is a resource in the <literal>your.domain</literal> - package and contains a custom <link linkend="mapping-types-custom">typedef</link>. + package and contains a custom typedef (see <xref linkend="mapping-types-custom" />). </para> - </sect3> - </sect2> + </section> + </section> - <sect2 id="mapping-declaration-mapping" revision="3"> + <section id="mapping-declaration-mapping" revision="3"> <title>Hibernate-mapping</title> <para> @@ -284,9 +276,9 @@ <literal>Animal.hbm.xml</literal>. </para> - </sect2> + </section> - <sect2 id="mapping-declaration-class" revision="3"> + <section id="mapping-declaration-class" revision="3"> <title>Class</title> <para> @@ -601,9 +593,9 @@ a nested mapping element. </para> - </sect2> + </section> - <sect2 id="mapping-declaration-id" revision="4"> + <section id="mapping-declaration-id" revision="4"> <title>id</title> <para> @@ -679,7 +671,7 @@ legacy data with composite keys. Its use is strongly discouraged for anything else. </para> - <sect3 id="mapping-declaration-id-generator" revision="2"> + <section id="mapping-declaration-id-generator" revision="2"> <title>Generator</title> <para> @@ -700,7 +692,7 @@ All generators implement the interface <literal>org.hibernate.id.IdentifierGenerator</literal>. This is a very simple interface. Some applications can choose to provide their own specialized implementations, however, Hibernate provides a range of built-in implementations. The shortcut - names for the built-in generators are as follows: + names for the built-in generators are as follows: </para> <variablelist> <varlistentry> @@ -827,11 +819,9 @@ </listitem> </varlistentry> </variablelist> + </section> - </para> - </sect3> - - <sect3 id="mapping-declaration-id-hilo" revision="1"> + <section id="mapping-declaration-id-hilo" revision="1"> <title>Hi/lo algorithm</title> <para> The <literal>hilo</literal> and <literal>seqhilo</literal> generators provide two alternate @@ -861,9 +851,9 @@ server datasource to obtain connections enlisted with JTA, you must configure the <literal>hibernate.transaction.manager_lookup_class</literal>. </para> - </sect3> + </section> - <sect3 id="mapping-declaration-id-uuid"> + <section id="mapping-declaration-id-uuid"> <title>UUID algorithm</title> <para> The UUID contains: IP address, startup time of the JVM that is accurate to a quarter @@ -871,9 +861,9 @@ possible to obtain a MAC address or memory address from Java code, so this is the best option without using JNI. </para> - </sect3> + </section> - <sect3 id="mapping-declaration-id-sequences"> + <section id="mapping-declaration-id-sequences"> <title>Identity columns and sequences</title> <para> For databases that support identity columns (DB2, MySQL, Sybase, MS SQL), you @@ -898,9 +888,9 @@ choose from the <literal>identity</literal>, <literal>sequence</literal> and <literal>hilo</literal> strategies. </para> - </sect3> + </section> - <sect3 id="mapping-declaration-id-assigned"> + <section id="mapping-declaration-id-assigned"> <title>Assigned identifiers</title> <para> If you want the application to assign identifiers, as opposed to having @@ -918,9 +908,9 @@ there is a version or timestamp property, or you define <literal>Interceptor.isUnsaved()</literal>. </para> - </sect3> + </section> - <sect3 id="mapping-declaration-id-select"> + <section id="mapping-declaration-id-select"> <title>Primary keys assigned by triggers</title> <para> Hibernate does not generate DDL with triggers. It is for legacy schemas only. @@ -939,11 +929,11 @@ whose value is generated by a trigger. </para> - </sect3> + </section> - </sect2> + </section> - <sect2 id="mapping-declaration-id-enhanced"> + <section id="mapping-declaration-id-enhanced"> <title>Enhanced identifier generators</title> <para> @@ -965,7 +955,7 @@ incrementing values, depending on the capabilities of the dialect being used. The difference between this and <literal>native</literal> is that table-based and sequence-based storage have the same exact semantic. In fact, sequences are exactly what Hibernate tries to emulate with its table-based - generators. This generator has a number of configuration parameters: + generators. This generator has a number of configuration parameters:</para> <itemizedlist spacing="compact"> <listitem> <para> @@ -1008,7 +998,6 @@ </para> </listitem> </itemizedlist> - </para> <para> The second of these new generators is <literal>org.hibernate.id.enhanced.TableGenerator</literal>, which is intended, firstly, as a replacement for the <literal>table</literal> generator, even though it actually @@ -1016,7 +1005,7 @@ as a re-implementation of <literal>org.hibernate.id.MultipleHiLoPerTableGenerator</literal> that utilizes the notion of pluggable optimizers. Essentially this generator defines a table capable of holding a number of different increment values simultaneously by using multiple distinctly keyed rows. This - generator has a number of configuration parameters: + generator has a number of configuration parameters:</para> <itemizedlist spacing="compact"> <listitem> <para> @@ -1065,14 +1054,13 @@ <listitem> <para> <literal>optimizer</literal> (optional - defaults to <literal></literal>): - See <xref linkend="mapping-declaration-id-enhanced-optimizers"/> + See <xref linkend="mapping-declaration-id-enhanced-optimizers" /> </para> </listitem> </itemizedlist> - </para> - </sect2> + </section> - <sect2 id="mapping-declaration-id-enhanced-optimizers"> + <section id="mapping-declaration-id-enhanced-optimizers"> <title>Identifier generator optimization</title> <para> For identifier generators that store values in the database, it is inefficient for them to hit the @@ -1107,9 +1095,9 @@ </listitem> </itemizedlist> </para> - </sect2> + </section> - <sect2 id="mapping-declaration-compositeid" revision="3"> + <section id="mapping-declaration-compositeid" revision="3"> <title>composite-id</title> <programlisting><![CDATA[<composite-id @@ -1224,9 +1212,9 @@ for almost all applications. </para> - </sect2> + </section> - <sect2 id="mapping-declaration-discriminator" revision="3"> + <section id="mapping-declaration-discriminator" revision="3"> <title>Discriminator</title> <para> @@ -1312,9 +1300,9 @@ formula="case when CLASS_TYPE in ('a', 'b', 'c') then 0 else 1 end" type="integer"/>]]></programlisting> - </sect2> + </section> - <sect2 id="mapping-declaration-version" revision="4"> + <section id="mapping-declaration-version" revision="4"> <title>Version (optional)</title> <para> @@ -1380,7 +1368,7 @@ <para> <literal>generated</literal> (optional - defaults to <literal>never</literal>): specifies that this version property value is generated by the database. - See the discussion of <link linkend="mapping-generated">generated properties</link> for more information. + See the discussion of generated properties for more information (<xref linkend="mapping-generated" />). </para> </callout> <callout arearefs="version7"> @@ -1407,9 +1395,9 @@ problems with transitive reattachment in Hibernate. It is especially useful for people using assigned identifiers or composite keys</emphasis>. </para> - </sect2> + </section> - <sect2 id="mapping-declaration-timestamp" revision="4" > + <section id="mapping-declaration-timestamp" revision="4" > <title>Timestamp (optional)</title> <para> @@ -1482,7 +1470,7 @@ <para> <literal>generated</literal> (optional - defaults to <literal>never</literal>): specifies that this timestamp property value is actually generated by the database. - See the discussion of <link linkend="mapping-generated">generated properties</link> for more information. + See the discussion of generated properties for more information (<xref linkend="mapping-generated" />). </para> </callout> </calloutlist> @@ -1499,10 +1487,10 @@ </para> </note> - </sect2> + </section> - <sect2 id="mapping-declaration-property" revision="4"> + <section id="mapping-declaration-property" revision="4"> <title>Property</title> <para> @@ -1620,7 +1608,7 @@ <para> <literal>generated</literal> (optional - defaults to <literal>never</literal>): specifies that this property value is actually generated by the database. - See the discussion of <link linkend="mapping-generated">generated properties</link> for more information. + See the discussion of generated properties for more information (<xref linkend="mapping-generated"/>). </para> </callout> </calloutlist> @@ -1695,9 +1683,9 @@ if you do not want to use the attribute. </para> - </sect2> + </section> - <sect2 id="mapping-declaration-manytoone" revision="5"> + <section id="mapping-declaration-manytoone" revision="5"> <title>Many-to-one</title> <para> @@ -1908,9 +1896,9 @@ <programlisting><![CDATA[<many-to-one name="owner" property-ref="identity.ssn" column="OWNER_SSN"/>]]></programlisting> - </sect2> + </section> - <sect2 id="mapping-declaration-onetoone" revision="3"> + <section id="mapping-declaration-onetoone" revision="3"> <title>One-to-one</title> <para> @@ -2084,9 +2072,9 @@ <programlisting><![CDATA[<one-to-one name="employee" class="Employee" property-ref="person"/>]]></programlisting> - </sect2> + </section> - <sect2 id="mapping-declaration-naturalid"> + <section id="mapping-declaration-naturalid"> <title>Natural-id</title> <programlisting><![CDATA[<natural-id mutable="true|false"/> @@ -2122,9 +2110,9 @@ </listitem> </itemizedlist> - </sect2> + </section> - <sect2 id="mapping-declaration-component" revision="2"> + <section id="mapping-declaration-component" revision="2"> <title>Component and dynamic-component</title> <para> @@ -2233,9 +2221,9 @@ <xref linkend="components-dynamic"/> for more information. </para> - </sect2> + </section> - <sect2 id="mapping-declaration-properties" revision="2"> + <section id="mapping-declaration-properties" revision="2"> <title>Properties</title> <para> @@ -2336,9 +2324,9 @@ legacy data is not recommended. </para> - </sect2> + </section> - <sect2 id="mapping-declaration-subclass" revision="4"> + <section id="mapping-declaration-subclass" revision="4"> <title>Subclass</title> <para> @@ -2407,9 +2395,9 @@ For information about inheritance mappings see <xref linkend="inheritance"/>. </para> - </sect2> + </section> - <sect2 id="mapping-declaration-joinedsubclass" revision="3"> + <section id="mapping-declaration-joinedsubclass" revision="3"> <title>Joined-subclass</title> <para> @@ -2514,9 +2502,9 @@ For information about inheritance mappings see <xref linkend="inheritance"/>. </para> - </sect2> + </section> - <sect2 id="mapping-declaration-unionsubclass" revision="2"> + <section id="mapping-declaration-unionsubclass" revision="2"> <title>Union-subclass</title> <para> @@ -2590,9 +2578,9 @@ For information about inheritance mappings see <xref linkend="inheritance"/>. </para> - </sect2> + </section> - <sect2 id="mapping-declaration-join" revision="3"> + <section id="mapping-declaration-join" revision="3"> <title>Join</title> <para> @@ -2696,9 +2684,9 @@ explained later. </para> - </sect2> + </section> - <sect2 id="mapping-declaration-key"> + <section id="mapping-declaration-key"> <title>Key</title> <para> @@ -2786,9 +2774,9 @@ <literal><key not-null="true"></literal>. </para> - </sect2> + </section> - <sect2 id="mapping-column" revision="4"> + <section id="mapping-column" revision="4"> <title>Column and formula elements</title> <para> Mapping elements which accept a <literal>column</literal> attribute will alternatively @@ -2823,9 +2811,9 @@ <formula>'MAILING'</formula> </many-to-one>]]></programlisting> - </sect2> + </section> - <sect2 id="mapping-declaration-import"> + <section id="mapping-declaration-import"> <title>Import</title> <para> @@ -2861,9 +2849,9 @@ </calloutlist> </programlistingco> - </sect2> + </section> - <sect2 id="mapping-types-anymapping" revision="2"> + <section id="mapping-types-anymapping" revision="2"> <title>Any</title> <para> @@ -2955,14 +2943,14 @@ </calloutlist> </programlistingco> - </sect2> + </section> - </sect1> + </section> - <sect1 id="mapping-types"> + <section id="mapping-types"> <title>Hibernate types</title> - <sect2 id="mapping-types-entitiesvalues" revision="1"> + <section id="mapping-types-entitiesvalues" revision="1"> <title>Entities and values</title> <para> @@ -3027,9 +3015,9 @@ With the exception of collections, all built-in Hibernate types support null semantics. </para> - </sect2> + </section> - <sect2 id="mapping-types-basictypes" revision="3"> + <section id="mapping-types-basictypes" revision="3"> <title>Basic value types</title> <para> @@ -3183,9 +3171,9 @@ represents the <literal>string</literal> type. </para> - </sect2> + </section> - <sect2 id="mapping-types-custom" revision="2"> + <section id="mapping-types-custom" revision="2"> <title>Custom value types</title> <para> @@ -3271,11 +3259,11 @@ monetary values are represented. </para> - </sect2> + </section> - </sect1> + </section> - <sect1 id="mapping-entityname"> + <section id="mapping-entityname"> <title>Mapping a class more than once</title> <para> It is possible to provide more than one mapping for a particular persistent class. In this @@ -3308,9 +3296,9 @@ <literal>class</literal>. </para> - </sect1> + </section> - <sect1 id="mapping-quotedidentifiers"> + <section id="mapping-quotedidentifiers"> <title>SQL quoted identifiers</title> <para> You can force Hibernate to quote an identifier in the generated SQL by enclosing the table or @@ -3325,17 +3313,17 @@ ... </class>]]></programlisting> - </sect1> + </section> - <sect1 id="mapping-alternatives"> + <section id="mapping-alternatives"> <title>Metadata alternatives</title> <para> XML does not suit all users so there are some alternative ways to define O/R mapping metadata in Hibernate. </para> - <sect2 id="mapping-xdoclet"> + <section id="mapping-xdoclet"> <title>Using XDoclet markup</title> <para> @@ -3454,9 +3442,9 @@ See the Hibernate website for more examples of XDoclet and Hibernate. </para> - </sect2> + </section> - <sect2 id="mapping-annotations" revision="2"> + <section id="mapping-annotations" revision="2"> <title>Using JDK 5.0 Annotations</title> <para> @@ -3505,10 +3493,10 @@ </para> </note> - </sect2> - </sect1> + </section> + </section> - <sect1 id="mapping-generated" revision="1"> + <section id="mapping-generated" revision="1"> <title>Generated properties</title> <para> Generated properties are properties that have their values generated by the @@ -3521,9 +3509,9 @@ </para> <para> Properties marked as generated must additionally be non-insertable and non-updateable. - Only <link linkend="mapping-declaration-version">versions</link>, - <link linkend="mapping-declaration-timestamp">timestamps</link>, and - <link linkend="mapping-declaration-property">simple properties</link>, can be marked as + Only versions (<xref linkend="mapping-declaration-version" />), timestamps + (<xref linkend="mapping-declaration-timestamp" />), and simple properties + (<xref linkend="mapping-declaration-property" />), can be marked as generated. </para> <para> @@ -3533,18 +3521,18 @@ <para> <literal>insert</literal>: the given property value is generated on insert, but is not regenerated on subsequent updates. Properties like created-date - fall into this category. Even though - <link linkend="mapping-declaration-version">version</link> and - <link linkend="mapping-declaration-timestamp">timestamp</link> properties can + fall into this category. Even though version + (<xref linkend="mapping-declaration-version" />) and timestamp + (<xref linkend="mapping-declaration-timestamp" />) properties can be marked as generated, this option is not available. </para> <para> <literal>always</literal>: the property value is generated both on insert and on update. </para> - </sect1> + </section> - <sect1 id="mapping-database-object"> + <section id="mapping-database-object"> <title>Auxiliary database objects</title> <para> Auxiliary database objects allow for the CREATE and DROP of arbitrary database objects. In conjunction with @@ -3589,6 +3577,6 @@ <dialect-scope name="org.hibernate.dialect.Oracle10gDialect"/> </database-object> </hibernate-mapping>]]></programlisting> - </sect1> + </section> </chapter> Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/batch.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/batch.xml 2010-02-08 04:15:14 UTC (rev 18714) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/batch.xml 2010-02-08 04:24:37 UTC (rev 18715) @@ -1,4 +1,8 @@ -<?xml version='1.0' encoding="iso-8859-1"?> +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Hibernate_Core_Reference_Guide.ent"> +%BOOK_ENTITIES; +]>  -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> - <chapter id="batch"> <title>Batch processing</title> @@ -75,7 +77,7 @@ <literal>CacheMode</literal> to disable interaction with the second-level cache. </para> - <sect1 id="batch-inserts"> + <section id="batch-inserts"> <title>Batch inserts</title> <para> @@ -100,9 +102,9 @@ tx.commit(); session.close();]]></programlisting> - </sect1> + </section> - <sect1 id="batch-update" > + <section id="batch-update" > <title>Batch updates</title> <para> @@ -131,9 +133,9 @@ tx.commit(); session.close();]]></programlisting> - </sect1> + </section> - <sect1 id="batch-statelesssession"> + <section id="batch-statelesssession"> <title>The StatelessSession interface</title> <para> Alternatively, Hibernate provides a command-oriented API that can be used for @@ -180,9 +182,9 @@ interface. </para> - </sect1> + </section> - <sect1 id="batch-direct" revision="3"> + <section id="batch-direct" revision="3"> <title>DML-style operations</title> <para> @@ -191,7 +193,7 @@ (DML) the statements: <literal>INSERT</literal>, <literal>UPDATE</literal>, <literal>DELETE</literal>) will not affect in-memory state. However, Hibernate provides methods for bulk SQL-style DML statement execution that is performed through the - Hibernate Query Language (<link linkend="queryhql">HQL</link>). + Hibernate Query Language (<xref linkend="queryhql" />). </para> <para> @@ -219,7 +221,7 @@ </listitem> <listitem> <para> - No <link linkend="queryhql-joins-forms">joins</link>, either implicit or explicit, + No <xref linkend="queryhql-joins-forms" />, either implicit or explicit, can be specified in a bulk HQL query. Sub-queries can be used in the where-clause, where the subqueries themselves may contain joins. </para> @@ -251,8 +253,8 @@ <para> In keeping with the EJB3 specification, HQL <literal>UPDATE</literal> statements, by default, do not effect the - <link linkend="mapping-declaration-version">version</link> - or the <link linkend="mapping-declaration-timestamp">timestamp</link> property values + version (<xref linkend="mapping-declaration-version" />) + or the timestamp (<xref linkend="mapping-declaration-timestamp" />) property values for the affected entities. However, you can force Hibernate to reset the <literal>version</literal> or <literal>timestamp</literal> property values through the use of a <literal>versioned update</literal>. @@ -372,6 +374,6 @@ tx.commit(); session.close();]]></programlisting> - </sect1> + </section> </chapter> Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/best_practices.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/best_practices.xml 2010-02-08 04:15:14 UTC (rev 18714) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/best_practices.xml 2010-02-08 04:24:37 UTC (rev 18715) @@ -1,4 +1,8 @@ -<?xml version='1.0' encoding="UTF-8"?> +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Hibernate_Core_Reference_Guide.ent"> +%BOOK_ENTITIES; +]>  - -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> - <chapter id="best-practices" revision="3"> <title>Best Practices</title> Deleted: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/bibliography.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/bibliography.xml 2010-02-08 04:15:14 UTC (rev 18714) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/bibliography.xml 2010-02-08 04:24:37 UTC (rev 18715) @@ -1,75 +0,0 @@ - -<!DOCTYPE bibliography PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> - -<bibliography> - <title>References</title> - - <biblioentry id="biblio-PoEAA"> - <abbrev>PoEAA</abbrev> - <title>Patterns of Enterprise Application Architecture</title> - <isbn>0-321-12742-0</isbn> - <authorgroup> - <author> - <firstname>Martin</firstname> - <surname>Fowler</surname> - </author> - </authorgroup> - <copyright> - <year>2003</year> - <holder>Pearson Education, Inc.</holder> - </copyright> - <publisher> - <publishername>Addison-Wesley Publishing Company</publishername> - </publisher> - </biblioentry> - - <biblioentry id="biblio-JPwH"> - <abbrev>JPwH</abbrev> - <title>Java Persistence with Hibernate</title> - <subtitle>Second Edition of Hibernate in Action</subtitle> - <isbn>1-932394-88-5</isbn> - <bibliomisc> - <ulink url="http://www.manning.com/bauer2"/> - </bibliomisc> - <authorgroup> - <author> - <firstname>Christian</firstname> - <surname>Bauer</surname> - </author> - <author> - <firstname>Gavin</firstname> - <surname>King</surname> - </author> - </authorgroup> - <copyright> - <year>2007</year> - <holder>Manning Publications Co.</holder> - </copyright> - <publisher> - <publishername>Manning Publications Co.</publishername> - </publisher> - </biblioentry> - -</bibliography> \ No newline at end of file Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/collection_mapping.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/collection_mapping.xml 2010-02-08 04:15:14 UTC (rev 18714) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/collection_mapping.xml 2010-02-08 04:24:37 UTC (rev 18715) @@ -1,4 +1,8 @@ -<?xml version='1.0' encoding="UTF-8"?> +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Hibernate_Core_Reference_Guide.ent"> +%BOOK_ENTITIES; +]>  -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> - <chapter id="collections"> <title>Collection mapping</title> - <sect1 id="collections-persistent" revision="3"> + <section id="collections-persistent" revision="3"> <title>Persistent collections</title> <para> @@ -99,18 +101,18 @@ the semantics of bidirectional associations (these are discussed later). </para> - </sect1> + </section> - <sect1 id="collections-mapping" revision="4"> + <section id="collections-mapping" revision="4"> <title>Collection mappings</title> - <tip> + <note> <para> There are quite a range of mappings that can be generated for collections that cover many common relational models. We suggest you experiment with the schema generation tool so that you understand how various mapping declarations translate to database tables. </para> - </tip> + </note> <para> The Hibernate mapping element used for mapping a collection depends upon @@ -270,7 +272,7 @@ </calloutlist> </programlistingco> - <sect2 id="collections-foreignkeys" > + <section id="collections-foreignkeys" > <title>Collection foreign keys</title> <para> @@ -301,9 +303,9 @@ element. </para> - </sect2> + </section> - <sect2 id="collections-elements" > + <section id="collections-elements" > <title>Collection elements</title> <para> @@ -324,9 +326,9 @@ associations. </para> - </sect2> + </section> - <sect2 id="collections-indexed"> + <section id="collections-indexed"> <title>Indexed collections</title> <para> @@ -439,9 +441,9 @@ optionally sorted or ordered. </para> - </sect2> + </section> - <sect2 id="collections-ofvalues" revision="2"> + <section id="collections-ofvalues" revision="2"> <title>Collections of values and many-to-many associations</title> <para> @@ -643,9 +645,9 @@ </composite-element> </list>]]></programlisting> - </sect2> + </section> - <sect2 id="collections-onetomany"> + <section id="collections-onetomany"> <title>One-to-many associations</title> <para> @@ -740,14 +742,14 @@ <map-key formula="partName"/> <one-to-many class="Part"/> </map>]]></programlisting> - </sect2> + </section> - </sect1> + </section> - <sect1 id="collections-advancedmappings"> + <section id="collections-advancedmappings"> <title>Advanced collection mappings</title> - <sect2 id="collections-sorted" revision="2"> + <section id="collections-sorted" revision="2"> <title>Sorted collections</title> <para> @@ -814,9 +816,9 @@ <programlisting><![CDATA[sortedUsers = s.createFilter( group.getUsers(), "order by this.name" ).list();]]></programlisting> - </sect2> + </section> - <sect2 id="collections-bidirectional" revision="1"> + <section id="collections-bidirectional" revision="1"> <title>Bidirectional associations</title> <para> @@ -925,9 +927,9 @@ affect the operation of cascades as these are orthogonal concepts. </para> - </sect2> + </section> - <sect2 id="collections-indexedbidirectional"> + <section id="collections-indexedbidirectional"> <title>Bidirectional associations with indexed collections</title> <para> A bidirectional association where one end is represented as a <literal><list></literal> @@ -993,9 +995,9 @@ updates to the foreign key.  </para> - </sect2> + </section> - <sect2 id="collections-ternary"> + <section id="collections-ternary"> <title>Ternary associations</title> <para> @@ -1024,9 +1026,9 @@ A final alternative is to use composite elements, which will be discussed later. </para> - </sect2> + </section> - <sect2 id="collections-idbag" revision="1"> + <section id="collections-idbag" revision="1"> <title><literal>Using an <idbag></literal></title> <para> @@ -1070,9 +1072,9 @@ strategy is not supported for <literal><idbag></literal> collection identifiers. </para> - </sect2> + </section> - </sect1> + </section>  @@ -1086,9 +1088,9 @@ rarely, if ever. </para> - </sect1--> + </section--> - <sect1 id="collections-example" revision="1"> + <section id="collections-example" revision="1"> <title>Collection examples</title> <para> @@ -1264,6 +1266,6 @@ in the next chapter. </para> - </sect1> + </section> </chapter> Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/component_mapping.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/component_mapping.xml 2010-02-08 04:15:14 UTC (rev 18714) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/component_mapping.xml 2010-02-08 04:24:37 UTC (rev 18715) @@ -1,4 +1,8 @@ -<?xml version='1.0' encoding="UTF-8"?> +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Hibernate_Core_Reference_Guide.ent"> +%BOOK_ENTITIES; +]>  -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> - <chapter id="components"> <title>Component Mapping</title> @@ -33,7 +35,7 @@ throughout Hibernate. </para> - <sect1 id="components-dependentobjects" revision="2" > + <section id="components-dependentobjects" revision="2" > <title>Dependent objects</title> <para> @@ -157,9 +159,9 @@ </component> </class>]]></programlisting> - </sect1> + </section> - <sect1 id="components-incollections" revision="1"> + <section id="components-incollections" revision="1"> <title>Collections of dependent objects</title> <para> @@ -179,12 +181,12 @@ </set>]]></programlisting> <important> - <para> + <para> If you define a <literal>Set</literal> of composite elements, it is important to implement <literal>equals()</literal> and - <literal>hashCode()</literal> correctly. - </para> - </important> + <literal>hashCode()</literal> correctly.</para> + </important> + <para> Composite elements can contain components but not collections. If your @@ -258,9 +260,9 @@ associations to other entities. </para> - </sect1> + </section> - <sect1 id="components-asmapindex"> + <section id="components-asmapindex"> <title>Components as Map indices</title> <para> @@ -269,9 +271,9 @@ <literal>hashCode()</literal> and <literal>equals()</literal> correctly on the component class. </para> - </sect1> + </section> - <sect1 id="components-compositeid" revision="1"> + <section id="components-compositeid" revision="1"> <title>Components as composite identifiers</title> <para> @@ -347,17 +349,15 @@ <column name="customerId"/> </many-to-one>]]></programlisting> - <tip> - <para> - The <literal>column</literal> element is an alternative to the - <literal>column</literal> attribute everywhere. Using the - <literal>column</literal> element just gives more declaration - options, which are mostly useful when utilizing - <literal>hbm2ddl</literal> - </para> - </tip> - - <para> + <note> + <para> + The <literal><column></literal> tag is an alternative to the + <literal>column</literal> attribute everywhere. Using the <literal><column></literal> + tag just gives more declaration options, which are mostly useful when utilizing <literal>hbm2ddl</literal>. + </para> + </note> + +<para> A <literal>many-to-many</literal> association to <literal>OrderLine</literal> also uses the composite foreign key: </para> @@ -409,9 +409,9 @@ </set> </class>]]></programlisting> - </sect1> + </section> - <sect1 id="components-dynamic" revision="1"> + <section id="components-dynamic" revision="1"> <title>Dynamic components</title> <para> @@ -433,6 +433,6 @@ configuration-time metamodel via the <literal>Configuration</literal> object. </para> - </sect1> + </section> </chapter> Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/configuration.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/configuration.xml 2010-02-08 04:15:14 UTC (rev 18714) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/configuration.xml 2010-02-08 04:24:37 UTC (rev 18715) @@ -1,4 +1,9 @@ -<?xml version='1.0' encoding="UTF-8"?> +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Hibernate_Core_Reference_Guide.ent"> +%BOOK_ENTITIES; +]> +  -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> - <chapter id="session-configuration" revision="1"> <title>Configuration</title> @@ -36,7 +39,7 @@ the various options. Simply put the example file in your classpath and customize it to suit your needs. </para> - <sect1 id="configuration-programmatic" revision="1"> + <section id="configuration-programmatic" revision="1"> <title>Programmatic configuration</title> <para> @@ -122,14 +125,14 @@ be discarded once a <literal>SessionFactory</literal> is created. </para> - </sect1> + </section> - <sect1 id="configuration-sessionfactory"> + <section id="configuration-sessionfactory"> <title>Obtaining a SessionFactory</title> <para> When all mappings have been parsed by the <classname>org.hibernate.cfg.Configuration</classname>, - the application must obtain a factory for <interfacename>org.hibernate.Session</interfacename> instances. + the application must obtain a factory for <classname>org.hibernate.Session</classname> instances. This factory is intended to be shared by all application threads: </para> @@ -137,13 +140,13 @@ <para> Hibernate does allow your application to instantiate more than one - <interfacename>org.hibernate.SessionFactory</interfacename>. This is useful if you are using more than + <classname>org.hibernate.SessionFactory</classname>. This is useful if you are using more than one database. </para> - </sect1> + </section> - <sect1 id="configuration-hibernatejdbc" revision="1"> + <section id="configuration-hibernatejdbc"> <title>JDBC connections</title> <para> @@ -177,49 +180,49 @@ <colspec colname="c2" colwidth="1*"/> <thead> <row> - <entry>Property name</entry> - <entry>Purpose</entry> + <entry><para>Property name</para></entry> + <entry><para>Purpose</para></entry> </row> </thead> <tbody> <row> <entry> - <property>hibernate.connection.driver_class</property> - </entry> + <para><property>hibernate.connection.driver_class</property> + </para></entry> <entry> - <emphasis>JDBC driver class</emphasis> + <para><emphasis>JDBC driver class</emphasis></para> </entry> </row> <row> <entry> - <property>hibernate.connection.url</property> + <para><property>hibernate.connection.url</property></para> </entry> <entry> - <emphasis>JDBC URL</emphasis> + <para><emphasis>JDBC URL</emphasis></para> </entry> </row> <row> <entry> - <property>hibernate.connection.username</property> + <para><property>hibernate.connection.username</property></para> </entry> <entry> - <emphasis>database user</emphasis> + <para><emphasis>database user</emphasis></para> </entry> </row> <row> <entry> - <property>hibernate.connection.password</property> + <para><property>hibernate.connection.password</property></para> </entry> <entry> - <emphasis>database user password</emphasis> + <para><emphasis>database user password</emphasis></para> </entry> </row> <row> <entry> - <property>hibernate.connection.pool_size</property> + <para><property>hibernate.connection.pool_size</property></para> </entry> <entry> - <emphasis>maximum number of pooled connections</emphasis> + <para><emphasis>maximum number of pooled connections</emphasis></para> </entry> </row> </tbody> @@ -248,7 +251,8 @@ The following is an example <filename>hibernate.properties</filename> file for c3p0: </para> - <programlisting id="c3p0-configuration" revision="1"><![CDATA[hibernate.connection.driver_class = org.postgresql.Driver +  + <programlisting><![CDATA[hibernate.connection.driver_class = org.postgresql.Driver hibernate.connection.url = jdbc:postgresql://localhost/mydatabase hibernate.connection.username = myuser hibernate.connection.password = secret @@ -271,50 +275,50 @@ <colspec colname="c2" colwidth="1*"/> <thead> <row> - <entry>Property name</entry> - <entry>Purpose</entry> + <entry><para>Property name</para></entry> + <entry><para>Purpose</para></entry> </row> </thead> <tbody> <row> <entry> - <property>hibernate.connection.datasource</property> + <para><property>hibernate.connection.datasource</property></para> </entry> - <entry> + <entry><para> <emphasis>datasource JNDI name</emphasis> - </entry> + </para></entry> </row> <row> - <entry> + <entry><para> <property>hibernate.jndi.url</property> - </entry> - <entry> + </para></entry> + <entry><para> <emphasis>URL of the JNDI provider</emphasis> (optional) - </entry> + </para></entry> </row> <row> - <entry> + <entry><para> <property>hibernate.jndi.class</property> - </entry> - <entry> + </para></entry> + <entry><para> <emphasis>class of the JNDI <literal>InitialContextFactory</literal></emphasis> (optional) - </entry> + </para></entry> </row> <row> - <entry> + <entry><para> <property>hibernate.connection.username</property> - </entry> - <entry> + </para></entry> + <entry><para> <emphasis>database user</emphasis> (optional) - </entry> + </para></entry> </row> <row> - <entry> + <entry><para> <property>hibernate.connection.password</property> - </entry> - <entry> + </para></entry> + <entry><para> <emphasis>database user password</emphasis> (optional) - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -349,22 +353,22 @@ custom implementation via the <property>hibernate.connection.provider_class</property> property. </para> - </sect1> + </section> - <sect1 id="configuration-optional" revision="1"> + <section id="configuration-optional" revision="1"> <title>Optional configuration properties</title> <para> There are a number of other properties that control the behavior of Hibernate at runtime. All are optional and have reasonable default values. </para> - + <warning> <para> - <warning><emphasis>Some of these properties are "system-level" only.</emphasis> System-level properties can - be set only via <literal>java -Dproperty=value</literal> or <filename>hibernate.properties</filename>. They - <emphasis>cannot</emphasis> be set by the other techniques described above.</warning> + Some of these properties are system-level only. System-level properties can + be set only via <code>java -Dproperty=value</code> or <filename>hibernate.properties</filename>. They + <emphasis>cannot</emphasis> be set by the other techniques described above. </para> - +</warning> <table frame="topbot" id="configuration-optional-properties" revision="8"> <title>Hibernate Configuration Properties</title> <tgroup cols="2"> @@ -372,18 +376,19 @@ <colspec colname="c2" colwidth="1*"/> <thead> <row> - <entry>Property name</entry> - <entry>Purpose</entry> + <entry><para>Property name</para></entry> + <entry><para>Purpose</para></entry> </row> </thead> <tbody> <row> - <entry> + <entry><para> <property>hibernate.dialect</property> - </entry> - <entry> + </para></entry> + <entry><para> The classname of a Hibernate <classname>org.hibernate.dialect.Dialect</classname> which allows Hibernate to generate SQL optimized for a particular relational database. + </para> <para> <emphasis role="strong">e.g.</emphasis> <literal>full.classname.of.Dialect</literal> @@ -396,13 +401,13 @@ </entry> </row> <row> - <entry> + <entry><para> <property>hibernate.show_sql</property> - </entry> - <entry> + </para></entry> + <entry><para> Write all SQL statements to console. This is an alternative to setting the log category <literal>org.hibernate.SQL</literal> - to <literal>debug</literal>. + to <literal>debug</literal>.</para> <para> <emphasis role="strong">e.g.</emphasis> <literal>true</literal> | <literal>false</literal> @@ -410,11 +415,11 @@ </entry> </row> <row> - <entry> + <entry><para> <property>hibernate.format_sql</property> - </entry> - <entry> - Pretty print the SQL in the log and console. + </para></entry> + <entry><para> + Pretty print the SQL in the log and console.</para> <para> <emphasis role="strong">e.g.</emphasis> <literal>true</literal> | <literal>false</literal> @@ -422,12 +427,12 @@ </entry> </row> <row> - <entry> + <entry><para> <property>hibernate.default_schema</property> - </entry> - <entry> + </para></entry> + <entry><para> Qualify unqualified table names with the given schema/tablespace - in generated SQL. + in generated SQL.</para> <para> <emphasis role="strong">e.g.</emphasis> <literal>SCHEMA_NAME</literal> @@ -435,12 +440,12 @@ </entry> </row> <row> - <entry> - <property>hibernate.default_catalog</property> + <entry><para> + <property>hibernate.default_catalog</property></para> </entry> - <entry> + <entry><para> Qualifies unqualified table names with the given catalog - in generated SQL. + in generated SQL.</para> <para> <emphasis role="strong">e.g.</emphasis> <literal>CATALOG_NAME</literal> @@ -448,12 +453,12 @@ </entry> </row> <row> - <entry> + <entry><para> <property>hibernate.session_factory_name</property> - </entry> - <entry> + </para></entry> + <entry><para> The <interfacename>org.hibernate.SessionFactory</interfacename> will be automatically - bound to this name in JNDI after it has been created. + bound to this name in JNDI after it has been created.</para> <para> <emphasis role="strong">e.g.</emphasis> <literal>jndi/composite/name</literal> @@ -461,13 +466,13 @@ </entry> </row> <row> - <entry> + <entry><para> <property>hibernate.max_fetch_depth</property> - </entry> - <entry> + </para></entry> + <entry><para> Sets a maximum "depth" for the outer join fetch tree for single-ended associations (one-to-one, many-to-one). - A <literal>0</literal> disables default outer join fetching. + A <literal>0</literal> disables default outer join fetching.</para> <para> <emphasis role="strong">e.g.</emphasis> recommended values between <literal>0</literal> and @@ -476,11 +481,11 @@ </entry> </row> <row> - <entry> + <entry><para> <property>hibernate.default_batch_fetch_size</property> - </entry> - <entry> - Sets a default size for Hibernate batch fetching of associations. + </para></entry> + <entry><para> + Sets a default size for Hibernate batch fetching of associations.</para> <para> <emphasis role="strong">e.g.</emphasis> recommended values <literal>4</literal>, <literal>8</literal>, @@ -489,12 +494,12 @@ </entry> </row> <row> - <entry> + <entry><para> <property>hibernate.default_entity_mode</property> - </entry> - <entry> + </para></entry> + <entry><para> Sets a default mode for entity representation for all sessions - opened from this <literal>SessionFactory</literal> + opened from this <literal>SessionFactory</literal>.</para> <para> <literal>dynamic-map</literal>, <literal>dom4j</literal>, <literal>pojo</literal> @@ -502,13 +507,13 @@ </entry> </row> <row> - <entry> + <entry><para> <property>hibernate.order_updates</property> - </entry> - <entry> + </para></entry> + <entry><para> Forces Hibernate to order SQL updates by the primary key value of the items being updated. This will result in fewer transaction - deadlocks in highly concurrent systems. + deadlocks in highly concurrent systems.</para> <para> <emphasis role="strong">e.g.</emphasis> <literal>true</literal> | <literal>false</literal> @@ -516,12 +521,12 @@ </entry> </row> <row> - <entry> + <entry><para> <property>hibernate.generate_statistics</property> - </entry> - <entry> + </para></entry> + <entry><para> If enabled, Hibernate will collect statistics useful for - performance tuning. + performance tuning.</para> <para> <emphasis role="strong">e.g.</emphasis> <literal>true</literal> | <literal>false</literal> @@ -529,12 +534,12 @@ </entry> </row> <row> - <entry> + <entry><para> <property>hibernate.use_identifier_rollback</property> - </entry> - <entry> + </para></entry> + <entry><para> If enabled, generated identifier properties will be - reset to default values when objects are deleted. + reset to default values when objects are deleted.</para> <para> <emphasis role="strong">e.g.</emphasis> <literal>true</literal> | <literal>false</literal> @@ -542,12 +547,12 @@ </entry> </row> <row> - <entry> + <entry><para> <property>hibernate.use_sql_comments</property> - </entry> - <entry> + </para></entry> + <entry><para> If turned on, Hibernate will generate comments inside the SQL, for - easier debugging, defaults to <literal>false</literal>. + easier debugging, defaults to <literal>false</literal>.</para> <para> <emphasis role="strong">e.g.</emphasis> <literal>true</literal> | <literal>false</literal> @@ -561,30 +566,32 @@ <table frame="topbot" id="configuration-jdbc-properties" revision="8"> <title>Hibernate JDBC and Connection Properties</title> <tgroup cols="2"> + <thead> <row> - <entry>Property name</entry> - <entry>Purpose</entry> + <entry><para>Property name</para></entry> + <entry><para>Purpose</para></entry> </row> </thead> <tbody> <row> - <entry> + <entry><para> <property>hibernate.jdbc.fetch_size</property> - </entry> - <entry> + </para></entry> + <entry><para> A non-zero value determines the JDBC fetch size (calls <literal>Statement.setFetchSize()</literal>). - </entry> + </para></entry> </row> <row> - <entry> + <entry><para> <property>hibernate.jdbc.batch_size</property> - </entry> - <entry> - A non-zero value enables use of JDBC2 batch updates by Hibernate. + </para></entry> + <entry><para> + A non-zero value enables use of JDBC2 batch updates by Hibernate.</para> <para> <emphasis role="strong">e.g.</emphasis> recommended values between <literal>5</literal> and <literal>30</literal> @@ -592,14 +599,14 @@ </entry> </row> <row> - <entry> + <entry><para> <property>hibernate.jdbc.batch_versioned_data</property> - </entry> - <entry> + </para></entry> + <entry><para> Set this property to <literal>true</literal> if your JDBC driver returns correct row counts from <literal>executeBatch()</literal>. Iit is usually safe to turn this option on. Hibernate will then use batched DML for - automatically versioned data. Defaults to <literal>false</literal>. + automatically versioned data. Defaults to <literal>false</literal>.</para> <para> <emphasis role="strong">e.g.</emphasis> <literal>true</literal> | <literal>false</literal> @@ -607,12 +614,12 @@ </entry> </row> <row> - <entry> + <entry><para> <property>hibernate.jdbc.factory_class</property> - </entry> - <entry> + </para></entry> + <entry><para> Select a custom <interfacename>org.hibernate.jdbc.Batcher</interfacename>. Most applications - will not need this configuration property. + will not need this configuration property.</para> <para> <emphasis role="strong">e.g.</emphasis> <literal>classname.of.BatcherFactory</literal> @@ -620,13 +627,13 @@ </entry> </row> <row> - <entry> + <entry><para> <property>hibernate.jdbc.use_scrollable_resultset</property> - </entry> - <entry> + </para></entry> + <entry><para> Enables use of JDBC2 scrollable resultsets by Hibernate. This property is only necessary when using user-supplied - JDBC connections. Hibernate uses connection metadata otherwise. + JDBC connections. Hibernate uses connection metadata otherwise.</para> <para> <emphasis role="strong">e.g.</emphasis> <literal>true</literal> | <literal>false</literal> @@ -634,12 +641,12 @@ </entry> </row> <row> - <entry> + <entry><para> <property>hibernate.jdbc.use_streams_for_binary</property> - </entry> - <entry> + </para></entry> + <entry><para> Use streams when writing/reading <literal>binary</literal> or <literal>serializable</literal> - types to/from JDBC. <emphasis>*system-level property*</emphasis> + types to/from JDBC. <emphasis>*system-level property*</emphasis></para> <para> <emphasis role="strong">e.g.</emphasis> <literal>true</literal> | <literal>false</literal> @@ -647,15 +654,15 @@ </entry> </row> <row> - <entry> + <entry><para> <property>hibernate.jdbc.use_get_generated_keys</property> - </entry> - <entry> + </para></entry> + <entry><para> Enables use of JDBC3 <literal>PreparedStatement.getGeneratedKeys()</literal> to retrieve natively generated keys after insert. Requires JDBC3+ driver and JRE1.4+, set to false if your driver has problems with the Hibernate identifier generators. By default, it tries to determine the driver capabilities - using connection metadata. + using connection metadata.</para> <para> <emphasis role="strong">e.g.</emphasis> <literal>true|false</literal> @@ -663,12 +670,12 @@ </entry> </row> <row> - <entry> + <entry><para> <property>hibernate.connection.provider_class</property> - </entry> - <entry> + </para></entry> + <entry><para> The classname of a custom <interfacename>org.hibernate.connection.ConnectionProvider</interfacename> - which provides JDBC connections to Hibernate. + which provides JDBC connections to Hibernate.</para> <para> <emphasis role="strong">e.g.</emphasis> <literal>classname.of.ConnectionProvider</literal> @@ -676,25 +683,25 @@ </entry> </row> <row> - <entry> - <property>hibernate.connection.isolation</property> - </entry> - <entry> - Sets the JDBC transaction isolation level. Check <interfacename>java.sql.Connection</interfacename> - for meaningful values, but note that most databases do not support all isolation levels and some - define additional, non-standard isolations. - <para> - <emphasis role="strong">e.g.</emphasis> - <literal>1, 2, 4, 8</literal> - </para> - </entry> + <entry><para> + <property>hibernate.connection.isolation</property> + </para></entry> + <entry><para> + Sets the JDBC transaction isolation level. Check <interfacename>java.sql.Connection</interfacename> + for meaningful values, but note that most databases do not support all isolation levels and some + define additional, non-standard isolations.</para> + <para> + <emphasis role="strong">e.g.</emphasis> + <literal>1, 2, 4, 8</literal> + </para> + </entry> </row> <row> - <entry> + <entry><para> <property>hibernate.connection.autocommit</property> - </entry> - <entry> - Enables autocommit for JDBC pooled connections (it is not recommended). + </para></entry> + <entry><para> + Enables autocommit for JDBC pooled connections (it is not recommended).</para> <para> <emphasis role="strong">e.g.</emphasis> <literal>true</literal> | <literal>false</literal> @@ -702,10 +709,10 @@ </entry> </row> <row> - <entry> + <entry><para> <property>hibernate.connection.release_mode</property> - </entry> - <entry> + </para></entry> + <entry><para> Specifies when Hibernate should release JDBC connections. By default, a JDBC connection is held until the session is explicitly closed or disconnected. For an application server JTA datasource, use @@ -715,7 +722,7 @@ <literal>after_transaction</literal>. <literal>auto</literal> will choose <literal>after_statement</literal> for the JTA and CMT transaction strategies and <literal>after_transaction</literal> for the JDBC - transaction strategy. + transaction strategy.</para> <para> <emphasis role="strong">e.g.</emphasis> <literal>auto</literal> (default) | <literal>on_close</literal> | @@ -732,22 +739,22 @@ </entry> </row> <row> - <entry> + <entry><para> <property>hibernate.connection.</property><emphasis><propertyName></emphasis> - </entry> - <entry> + </para></entry> + <entry><para> Pass the JDBC property <emphasis><propertyName></emphasis> to <literal>DriverManager.getConnection()</literal>. - </entry> + </para></entry> </row> <row> - <entry> + <entry><para> <property>hibernate.jndi.</property><emphasis><propertyName></emphasis> - </entry> - <entry> + </para></entry> + <entry><para> Pass the property <emphasis><propertyName></emphasis> to the JNDI <literal>InitialContextFactory</literal>. - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -760,17 +767,17 @@ <colspec colname="c2" colwidth="1*"/> <thead> <row> - <entry>Property name</entry> - <entry>Purpose</entry> + <entry><para>Property name</para></entry> + <entry><para>Purpose</para></entry> </row> </thead> <tbody> <row> - <entry> + <entry><para> <literal>hibernate.cache.provider_class</literal> - </entry> - <entry> - The classname of a custom <literal>CacheProvider</literal>. + </para></entry> + <entry><para> + The classname of a custom <literal>CacheProvider</literal>.</para> <para> <emphasis role="strong">e.g.</emphasis> <literal>classname.of.CacheProvider</literal> @@ -778,14 +785,14 @@ </entry> </row> <row> - <entry> + <entry><para> <literal>hibernate.cache.use_minimal_puts</literal> - </entry> - <entry> + </para></entry> + <entry><para> Optimizes second-level cache operation to minimize writes, at the cost of more frequent reads. This setting is most useful for clustered caches and, in Hibernate3, is enabled by default for - clustered cache implementations. + clustered cache implementations.</para> <para> <emphasis role="strong">e.g.</emphasis> <literal>true|false</literal> @@ -793,11 +800,11 @@ </entry> </row> <row> - <entry> + <entry><para> <literal>hibernate.cache.use_query_cache</literal> - </entry> - <entry> - Enables the query cache. Individual queries still have to be set cachable. + </para></entry> + <entry><para> + Enables the query cache. Individual queries still have to be set cachable.</para> <para> <emphasis role="strong">e.g.</emphasis> <literal>true|false</literal> @@ -805,13 +812,13 @@ </entry> </row> <row> - <entry> + <entry><para> <literal>hibernate.cache.use_second_level_cache</literal> - </entry> - <entry> + </para></entry> + <entry><para> Can be used to completely disable the second level cache, which is enabled by default for classes which specify a <literal><cache></literal> - mapping. + mapping.</para> <para> <emphasis role="strong">e.g.</emphasis> <literal>true|false</literal> @@ -819,12 +826,12 @@ </entry> </row> <row> - <entry> + <entry><para> <literal>hibernate.cache.query_cache_factory</literal> - </entry> - <entry> + </para></entry> + <entry><para> The classname of a custom <literal>QueryCache</literal> interface, - defaults to the built-in <literal>StandardQueryCache</literal>. + defaults to the built-in <literal>StandardQueryCache</literal>.</para> <para> <emphasis role="strong">e.g.</emphasis> <literal>classname.of.QueryCache</literal> @@ -832,11 +839,11 @@ </entry> </row> <row> - <entry> + <entry><para> <literal>hibernate.cache.region_prefix</literal> - </entry> - <entry> - A prefix to use for second-level cache region names. + </para></entry> + <entry><para> + A prefix to use for second-level cache region names.</para> <para> <emphasis role="strong">e.g.</emphasis> <literal>prefix</literal> @@ -844,12 +851,12 @@ </entry> </row> <row> - <entry> + <entry><para> <literal>hibernate.cache.use_structured_entries</literal> - </entry> - <entry> + </para></entry> + <entry><para> Forces Hibernate to store data in the second-level cache - in a more human-friendly format. + in a more human-friendly format.</para> <para> <emphasis role="strong">e.g.</emphasis> <literal>true|false</literal> @@ -867,19 +874,19 @@ <colspec colname="c2" colwidth="1*"/> <thead> <row> - <entry>Property name</entry> - <entry>Purpose</entry> + <entry><para>Property name</para></entry> + <entry><para>Purpose</para></entry> </row> </thead> <tbody> <row> - <entry> + <entry><para> <literal>hibernate.transaction.factory_class</literal> - </entry> - <entry> + </para></entry> + <entry><para> The classname of a <literal>TransactionFactory</literal> to use with Hibernate <literal>Transaction</literal> API - (defaults to <literal>JDBCTransactionFactory</literal>). + (defaults to <literal>JDBCTransactionFactory</literal>).</para> <para> <emphasis role="strong">e.g.</emphasis> <literal>classname.of.TransactionFactory</literal> @@ -887,13 +894,13 @@ </entry> </row> <row> - <entry> + <entry><para> <literal>jta.UserTransaction</literal> - </entry> - <entry> + </para></entry> + <entry><para> A JNDI name used by <literal>JTATransactionFactory</literal> to obtain the JTA <literal>UserTransaction</literal> from the - application server. + application server.</para> <para> <emphasis role="strong">e.g.</emphasis> <literal>jndi/composite/name</literal> @@ -901,13 +908,14 @@ </entry> </row> <row> - <entry> - <literal>hibernate.transaction.manager_lookup_class</literal> + <entry><para> + <literal>hibernate.transaction. + manager_lookup_class</literal></para> </entry> - <entry> + <entry><para> The classname of a <literal>TransactionManagerLookup</literal>. It is required when JVM-level caching is enabled or when using hilo - generator in a JTA environment. + generator in a JTA environment.</para> <para> <emphasis role="strong">e.g.</emphasis> <literal>classname.of.TransactionManagerLookup</literal> @@ -915,14 +923,15 @@ </entry> </row> <row> - <entry> - <literal>hibernate.transaction.flush_before_completion</literal> - </entry> - <entry> + <entry><para> + <literal>hibernate.transaction. + flush_before_completion</literal> + </para></entry> + <entry><para> If enabled, the session will be automatically flushed during the before completion phase of the transaction. Built-in and automatic session context management is preferred, see - <xref linkend="architecture-current-session"/>. + <xref linkend="architecture-current-session"/>.</para> <para> <emphasis role="strong">e.g.</emphasis> <literal>true</literal> | <literal>false</literal> @@ -930,14 +939,15 @@ </entry> </row> <row> - <entry> - <literal>hibernate.transaction.auto_close_session</literal> - </entry> - <entry> + <entry><para> + <literal>hibernate.transaction. + auto_close_session</literal> + </para></entry> + <entry><para> If enabled, the session will be automatically closed during the after completion phase of the transaction. Built-in and automatic session context management is preferred, see - <xref linkend="architecture-current-session"/>. + <xref linkend="architecture-current-session"/>.</para> <para> <emphasis role="strong">e.g.</emphasis> <literal>true</literal> | <literal>false</literal> @@ -955,20 +965,21 @@ <colspec colname="c2" colwidth="1*"/> <thead> <row> - <entry>Property name</entry> - <entry>Purpose</entry> + <entry><para>Property name</para></entry> + <entry><para>Purpose</para></entry> </row> </thead> <tbody> <row> - <entry> - <literal>hibernate.current_session_context_class</literal> - </entry> - <entry> + <entry><para> + <literal>hibernate. + current_session_context_class</literal> + </para></entry> + <entry><para> Supply a custom strategy for the scoping of the "current" <literal>Session</literal>. See <xref linkend="architecture-current-session"/> for more - information about the built-in strategies. + information about the built-in strategies.</para> <para> <emphasis role="strong">e.g.</emphasis> <literal>jta</literal> | <literal>thread</literal> | @@ -977,11 +988,11 @@ </entry> </row> <row> - <entry> + <entry><para> <literal>hibernate.query.factory_class</literal> - </entry> - <entry> - Chooses the HQL parser implementation. + </para></entry> + <entry><para> + Chooses the HQL parser implementation.</para> <para> <emphasis role="strong">e.g.</emphasis> <literal>org.hibernate.hql.ast.ASTQueryTranslatorFactory</literal> or @@ -990,12 +1001,12 @@ </entry> </row> <row> - <entry> + <entry><para> <literal>hibernate.query.substitutions</literal> - </entry> - <entry> + </para></entry> + <entry><para> Is used to map from tokens in Hibernate queries to SQL tokens - (tokens might be function or literal names, for example). + (tokens might be function or literal names, for example).</para> <para> <emphasis role="strong">e.g.</emphasis> <literal>hqlLiteral=SQL_LITERAL, hqlFunction=SQLFUNC</literal> @@ -1003,15 +1014,15 @@ </entry> </row> <row> - <entry> + <entry><para> <literal>hibernate.hbm2ddl.auto</literal> - </entry> - <entry> + </para></entry> + <entry><para> Automatically validates or exports schema DDL to the database when the <literal>SessionFactory</literal> is created. With <literal>create-drop</literal>, the database schema will be dropped when the <literal>SessionFactory</literal> is closed - explicitly. + explicitly.</para> <para> <emphasis role="strong">e.g.</emphasis> <literal>validate</literal> | <literal>update</literal> | @@ -1020,14 +1031,16 @@ </entry> </row> <row> - <entry> - <literal>hibernate.cglib.use_reflection_optimizer</literal> - </entry> - <entry> + <entry><para> + <literal>hibernate.cglib. + use_reflection_optimizer</literal> + </para></entry> + <entry><para> Enables the use of CGLIB instead of runtime reflection (System-level property). Reflection can sometimes be useful when troubleshooting. Hibernate always requires CGLIB even if you turn off the optimizer. You cannot set this property in <literal>hibernate.cfg.xml</literal>. + </para> <para> <emphasis role="strong">e.g.</emphasis> <literal>true</literal> | <literal>false</literal> @@ -1038,7 +1051,7 @@ </tgroup> </table> - <sect2 id="configuration-optional-dialects" revision="1"> + <section id="configuration-optional-dialects" revision="1"> <title>SQL Dialects</title> <para> @@ -1051,91 +1064,93 @@ <table frame="topbot" id="sql-dialects" revision="3"> <title>Hibernate SQL Dialects (<literal>hibernate.dialect</literal>)</title> <tgroup cols="2"> + <thead> <row> - <entry>RDBMS</entry> - <entry>Dialect</entry> + <entry><para>RDBMS</para></entry> + <entry><para>Dialect</para></entry> </row> </thead> <tbody> <row> - <entry>DB2</entry> <entry><literal>org.hibernate.dialect.DB2Dialect</literal></entry> + <entry><para>DB2</para></entry> <entry><para><literal>org.hibernate.dialect.DB2Dialect</literal></para></entry> </row> <row> - <entry>DB2 AS/400</entry> <entry><literal>org.hibernate.dialect.DB2400Dialect</literal></entry> + <entry><para>DB2 AS/400</para></entry> <entry><para><literal>org.hibernate.dialect.DB2400Dialect</literal></para></entry> </row> <row> - <entry>DB2 OS390</entry> <entry><literal>org.hibernate.dialect.DB2390Dialect</literal></entry> + <entry><para>DB2 OS390</para></entry> <entry><para><literal>org.hibernate.dialect.DB2390Dialect</literal></para></entry> </row> <row> - <entry>PostgreSQL</entry> <entry><literal>org.hibernate.dialect.PostgreSQLDialect</literal></entry> + <entry><para>PostgreSQL</para></entry> <entry><para><literal>org.hibernate.dialect.PostgreSQLDialect</literal></para></entry> </row> <row> - <entry>MySQL</entry> <entry><literal>org.hibernate.dialect.MySQLDialect</literal></entry> + <entry><para>MySQL</para></entry> <entry><para><literal>org.hibernate.dialect.MySQLDialect</literal></para></entry> </row> <row> - <entry>MySQL with InnoDB</entry> <entry><literal>org.hibernate.dialect.MySQLInnoDBDialect</literal></entry> + <entry><para>MySQL with InnoDB</para></entry> <entry><para><literal>org.hibernate.dialect.MySQLInnoDBDialect</literal></para></entry> </row> <row> - <entry>MySQL with MyISAM</entry> <entry><literal>org.hibernate.dialect.MySQLMyISAMDialect</literal></entry> + <entry><para>MySQL with MyISAM</para></entry> <entry><para><literal>org.hibernate.dialect.MySQLMyISAMDialect</literal></para></entry> </row> <row> - <entry>Oracle (any version)</entry> <entry><literal>org.hibernate.dialect.OracleDialect</literal></entry> + <entry><para>Oracle (any version)</para></entry> <entry><para><literal>org.hibernate.dialect.OracleDialect</literal></para></entry> </row> <row> - <entry>Oracle 9i</entry> <entry><literal>org.hibernate.dialect.Oracle9iDialect</literal></entry> + <entry><para>Oracle 9i</para></entry> <entry><para><literal>org.hibernate.dialect.Oracle9iDialect</literal></para></entry> </row> <row> - <entry>Oracle 10g</entry> <entry><literal>org.hibernate.dialect.Oracle10gDialect</literal></entry> + <entry><para>Oracle 10g</para></entry> <entry><para><literal>org.hibernate.dialect.Oracle10gDialect</literal></para></entry> </row> <row> - <entry>Sybase</entry> <entry><literal>org.hibernate.dialect.SybaseDialect</literal></entry> + <entry><para>Sybase</para></entry> <entry><para><literal>org.hibernate.dialect.SybaseDialect</literal></para></entry> </row> <row> - <entry>Sybase Anywhere</entry> <entry><literal>org.hibernate.dialect.SybaseAnywhereDialect</literal></entry> + <entry><para>Sybase Anywhere</para></entry> <entry><para><literal>org.hibernate.dialect.SybaseAnywhereDialect</literal></para></entry> </row> <row> - <entry>Microsoft SQL Server</entry> <entry><literal>org.hibernate.dialect.SQLServerDialect</literal></entry> + <entry><para>Microsoft SQL Server</para></entry> <entry><para><literal>org.hibernate.dialect.SQLServerDialect</literal></para></entry> </row> <row> - <entry>SAP DB</entry> <entry><literal>org.hibernate.dialect.SAPDBDialect</literal></entry> + <entry><para>SAP DB</para></entry> <entry><para><literal>org.hibernate.dialect.SAPDBDialect</literal></para></entry> </row> <row> - <entry>Informix</entry> <entry><literal>org.hibernate.dialect.InformixDialect</literal></entry> + <entry><para>Informix</para></entry> <entry><para><literal>org.hibernate.dialect.InformixDialect</literal></para></entry> </row> <row> - <entry>HypersonicSQL</entry> <entry><literal>org.hibernate.dialect.HSQLDialect</literal></entry> + <entry><para>HypersonicSQL</para></entry> <entry><para><literal>org.hibernate.dialect.HSQLDialect</literal></para></entry> </row> <row> - <entry>Ingres</entry> <entry><literal>org.hibernate.dialect.IngresDialect</literal></entry> + <entry><para>Ingres</para></entry> <entry><para><literal>org.hibernate.dialect.IngresDialect</literal></para></entry> </row> <row> - <entry>Progress</entry> <entry><literal>org.hibernate.dialect.ProgressDialect</literal></entry> + <entry><para>Progress</para></entry> <entry><para><literal>org.hibernate.dialect.ProgressDialect</literal></para></entry> </row> <row> - <entry>Mckoi SQL</entry> <entry><literal>org.hibernate.dialect.MckoiDialect</literal></entry> + <entry><para>Mckoi SQL</para></entry> <entry><para><literal>org.hibernate.dialect.MckoiDialect</literal></para></entry> </row> <row> - <entry>Interbase</entry> <entry><literal>org.hibernate.dialect.InterbaseDialect</literal></entry> + <entry><para>Interbase</para></entry> <entry><para><literal>org.hibernate.dialect.InterbaseDialect</literal></para></entry> </row> <row> - <entry>Pointbase</entry> <entry><literal>org.hibernate.dialect.PointbaseDialect</literal></entry> + <entry><para>Pointbase</para></entry> <entry><para><literal>org.hibernate.dialect.PointbaseDialect</literal></para></entry> </row> <row> - <entry>FrontBase</entry> <entry><literal>org.hibernate.dialect.FrontbaseDialect</literal></entry> + <entry><para>FrontBase</para></entry> <entry><para><literal>org.hibernate.dialect.FrontbaseDialect</literal></para></entry> </row> <row> - <entry>Firebird</entry> <entry><literal>org.hibernate.dialect.FirebirdDialect</literal></entry> + <entry><para>Firebird</para></entry> <entry><para><literal>org.hibernate.dialect.FirebirdDialect</literal></para></entry> </row> </tbody> </tgroup> </table> - </sect2> + </section> - <sect2 id="configuration-optional-outerjoin" revision="4"> + <section id="configuration-optional-outerjoin" revision="4"> <title>Outer Join Fetching</title> <para> @@ -1159,9 +1174,9 @@ See <xref linkend="performance-fetching"/> for more information. </para> - </sect2> + </section> - <sect2 id="configuration-optional-binarystreams" revision="1"> + <section id="configuration-optional-binarystreams" revision="1"> <title>Binary Streams</title> <para> @@ -1172,9 +1187,9 @@ <emphasis>This is a system-level setting only.</emphasis> </para> - </sect2> + </section> - <sect2 id="configuration-optional-cacheprovider" revision="2"> + <section id="configuration-optional-cacheprovider" revision="2"> <title>Second-level and query cache</title> <para> @@ -1184,9 +1199,9 @@ more information. </para> - </sect2> + </section> - <sect2 id="configuration-optional-querysubstitution"> + <section id="configuration-optional-querysubstitution"> <title>Query Language Substitution</title> <para> @@ -1207,9 +1222,9 @@ This would allow you to rename the SQL <literal>LOWER</literal> function. </para> - </sect2> + </section> - <sect2 id="configuration-optional-statistics" revision="2"> + <section id="configuration-optional-statistics" revision="2"> <title>Hibernate statistics</title> <para> @@ -1220,10 +1235,10 @@ <literal>org.hibernate.stats</literal> for more information. </para> - </sect2> - </sect1> + </section> + </section> - <sect1 id="configuration-logging"> + <section id="configuration-logging"> <title>Logging</title> <para> @@ -1252,58 +1267,61 @@ <colspec colwidth="2.5*"/> <thead> <row> - <entry>Category</entry> - <entry>Function</entry> + <entry><para>Category</para></entry> + <entry><para>Function</para></entry> </row> </thead> <tbody> <row> - <entry><literal>org.hibernate.SQL</literal></entry> - <entry>Log all SQL DML statements as they are executed</entry> + <entry><para><literal>org.hibernate.SQL</literal></para></entry> + <entry><para>Log all SQL DML statements as they are executed</para></entry> </row> <row> - <entry><literal>org.hibernate.type</literal></entry> - <entry>Log all JDBC parameters</entry> + <entry><para><literal>org.hibernate.type</literal></para></entry> + <entry><para>Log all JDBC parameters</para></entry> </row> <row> - <entry><literal>org.hibernate.tool.hbm2ddl</literal></entry> - <entry>Log all SQL DDL statements as they are executed</entry> + <entry><para><literal>org.hibernate.tool. + hbm2ddl</literal></para></entry> + <entry><para>Log all SQL DDL statements as they are executed</para></entry> </row> <row> - <entry><literal>org.hibernate.pretty</literal></entry> - <entry> + <entry><para><literal>org.hibernate.pretty</literal></para></entry> + <entry><para> Log the state of all entities (max 20 entities) associated with the session at flush time - </entry> + </para></entry> </row> <row> - <entry><literal>org.hibernate.cache</literal></entry> - <entry>Log all second-level cache activity</entry> + <entry><para><literal>org.hibernate.cache</literal></para></entry> + <entry><para>Log all second-level cache activity</para></entry> </row> <row> - <entry><literal>org.hibernate.transaction</literal></entry> - <entry>Log transaction related activity</entry> + <entry><para><literal>org.hibernate. + transaction</literal></para></entry> + <entry><para>Log transaction related activity</para></entry> </row> <row> - <entry><literal>org.hibernate.jdbc</literal></entry> - <entry>Log all JDBC resource acquisition</entry> + <entry><para><literal>org.hibernate.jdbc</literal></para></entry> + <entry><para>Log all JDBC resource acquisition</para></entry> </row> <row> - <entry><literal>org.hibernate.hql.ast.AST</literal></entry> - <entry> + <entry><para><literal>org.hibernate.hql. + ast.AST</literal></para></entry> + <entry><para> Log HQL and SQL ASTs during query parsing - </entry> + </para></entry> </row> <row> - <entry><literal>org.hibernate.secure</literal></entry> - <entry>Log all JAAS authorization requests</entry> + <entry><para><literal>org.hibernate.secure</literal></para></entry> + <entry><para>Log all JAAS authorization requests</para></entry> </row> <row> - <entry><literal>org.hibernate</literal></entry> - <entry> + <entry><para><literal>org.hibernate</literal></para></entry> + <entry><para> Log everything. This is a lot of information but it is useful for troubleshooting - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -1316,9 +1334,9 @@ </para> - </sect1> + </section> - <sect1 id="configuration-namingstrategy"> + <section id="configuration-namingstrategy"> <title>Implementing a <literal>NamingStrategy</literal></title> <para> @@ -1351,9 +1369,9 @@ strategy that might be a useful starting point for some applications. </para> - </sect1> + </section> - <sect1 id="configuration-xmlconfig" revision="2"> + <section id="configuration-xmlconfig" revision="2"> <title>XML configuration file</title> <para> @@ -1424,9 +1442,9 @@ .configure("catdb.cfg.xml") .buildSessionFactory();]]></programlisting> - </sect1> + </section> - <sect1 id="configuration-j2ee" revision="1"> + <section id="configuration-j2ee" revision="1"> <title>J2EE Application Server integration</title> <para> @@ -1489,7 +1507,7 @@ application server shows "connection containment" exceptions. </para> - <sect2 id="configuration-optional-transactionstrategy" revision="3"> + <section id="configuration-optional-transactionstrategy" revision="3"> <title>Transaction strategy configuration</title> <para> @@ -1555,58 +1573,68 @@ <colspec colwidth="1*"/> <thead> <row> - <entry>Transaction Factory</entry> - <entry align="center">Application Server</entry> + <entry><para>Transaction Factory</para></entry> + <entry align="center"><para>Application Server</para></entry> </row> </thead> <tbody> <row> - <entry><literal>org.hibernate.transaction.JBossTransactionManagerLookup</literal></entry> - <entry align="center">JBoss</entry> + <entry><para><literal>org.hibernate.transaction. + JBossTransactionManagerLookup</literal></para></entry> + <entry align="center"><para>JBoss</para></entry> </row> <row> - <entry><literal>org.hibernate.transaction.WeblogicTransactionManagerLookup</literal></entry> - <entry align="center">Weblogic</entry> + <entry><para><literal>org.hibernate.transaction. + WeblogicTransactionManagerLookup</literal></para></entry> + <entry align="center"><para>Weblogic</para></entry> </row> <row> - <entry><literal>org.hibernate.transaction.WebSphereTransactionManagerLookup</literal></entry> - <entry align="center">WebSphere</entry> + <entry><para><literal>org.hibernate.transaction. + WebSphereTransactionManagerLookup</literal></para></entry> + <entry align="center"><para>WebSphere</para></entry> </row> <row> - <entry><literal>org.hibernate.transaction.WebSphereExtendedJTATransactionLookup</literal></entry> - <entry align="center">WebSphere 6</entry> + <entry><para><literal>org.hibernate.transaction. + WebSphereExtendedJTATransactionLookup</literal></para></entry> + <entry align="center"><para>WebSphere 6</para></entry> </row> <row> - <entry><literal>org.hibernate.transaction.OrionTransactionManagerLookup</literal></entry> - <entry align="center">Orion</entry> + <entry><para><literal>org.hibernate.transaction. + OrionTransactionManagerLookup</literal></para></entry> + <entry align="center"><para>Orion</para></entry> </row> <row> - <entry><literal>org.hibernate.transaction.ResinTransactionManagerLookup</literal></entry> - <entry align="center">Resin</entry> + <entry><para><literal>org.hibernate.transaction. + ResinTransactionManagerLookup</literal></para></entry> + <entry align="center"><para>Resin</para></entry> </row> <row> - <entry><literal>org.hibernate.transaction.JOTMTransactionManagerLookup</literal></entry> - <entry align="center">JOTM</entry> + <entry><para><literal>org.hibernate.transaction. + JOTMTransactionManagerLookup</literal></para></entry> + <entry align="center"><para>JOTM</para></entry> </row> <row> - <entry><literal>org.hibernate.transaction.JOnASTransactionManagerLookup</literal></entry> - <entry align="center">JOnAS</entry> + <entry><para><literal>org.hibernate.transaction. + JOnASTransactionManagerLookup</literal></para></entry> + <entry align="center"><para>JOnAS</para></entry> </row> <row> - <entry><literal>org.hibernate.transaction.JRun4TransactionManagerLookup</literal></entry> - <entry align="center">JRun4</entry> + <entry><para><literal>org.hibernate.transaction. + JRun4TransactionManagerLookup</literal></para></entry> + <entry align="center"><para>JRun4</para></entry> </row> <row> - <entry><literal>org.hibernate.transaction.BESTransactionManagerLookup</literal></entry> - <entry align="center">Borland ES</entry> + <entry><para><literal>org.hibernate.transaction. + BESTransactionManagerLookup</literal></para></entry> + <entry align="center"><para>Borland ES</para></entry> </row> </tbody> </tgroup> </table> - </sect2> + </section> - <sect2 id="configuration-optional-jndi" revision="3"> + <section id="configuration-optional-jndi" revision="3"> <title>JNDI-bound <literal>SessionFactory</literal></title> <para> @@ -1652,15 +1680,15 @@ class is also a convenient way to startup Hibernate—see chapter 1. </para> - </sect2> + </section> - <sect2 id="configuration-j2ee-currentsession" revision="4"> + <section id="configuration-j2ee-currentsession" revision="4"> <title>Current Session context management with JTA</title> <para> The easiest way to handle <literal>Sessions</literal> and transactions is Hibernate's automatic "current" <literal>Session</literal> management. - For a discussion of contextual sessions see <xref linkend="architecture-current-session"/>. + For a discussion of contextual sessions see <xref linkend="architecture-current-session" />. Using the <literal>"jta"</literal> session context, if there is no Hibernate <literal>Session</literal> associated with the current JTA transaction, one will be started and associated with that JTA transaction the first time you call @@ -1677,9 +1705,9 @@ demarcation with CMT is preferred. </para> - </sect2> + </section> - <sect2 id="configuration-j2ee-jmx" revision="1"> + <section id="configuration-j2ee-jmx" revision="1"> <title>JMX deployment</title> <para> @@ -1750,9 +1778,9 @@ documentation for more information about JMX service and EJB deployment. </para> - </sect2> + </section> - </sect1> + </section> </chapter> Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/events.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/events.xml 2010-02-08 04:15:14 UTC (rev 18714) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/events.xml 2010-02-08 04:24:37 UTC (rev 18715) @@ -1,4 +1,8 @@ -<?xml version='1.0' encoding="UTF-8"?> +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Hibernate_Core_Reference_Guide.ent"> +%BOOK_ENTITIES; +]>  -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> - <chapter id="events"> <title>Interceptors and events</title> @@ -34,7 +36,7 @@ functionality and the extension of Hibernate functionality. </para> - <sect1 id="objectstate-interceptors" revision="3"> + <section id="objectstate-interceptors" revision="3"> <title>Interceptors</title> <para> @@ -160,9 +162,9 @@ <programlisting><![CDATA[new Configuration().setInterceptor( new AuditInterceptor() );]]></programlisting> - </sect1> + </section> - <sect1 id="objectstate-events" revision="4"> + <section id="objectstate-events" revision="4"> <title>Event system</title> <para> @@ -249,9 +251,9 @@ or off during configuration. </para> - </sect1> + </section> - <sect1 id="objectstate-decl-security" revision="2"> + <section id="objectstate-decl-security" revision="2"> <title>Hibernate declarative security</title> <para> Usually, declarative security in Hibernate applications is managed in a session facade @@ -286,7 +288,7 @@ The role names are the roles understood by your JACC provider. </para> - </sect1> + </section> </chapter> Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/example_mappings.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/example_mappings.xml 2010-02-08 04:15:14 UTC (rev 18714) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/example_mappings.xml 2010-02-08 04:24:37 UTC (rev 18715) @@ -1,4 +1,8 @@ -<?xml version='1.0' encoding="UTF-8"?> +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Hibernate_Core_Reference_Guide.ent"> +%BOOK_ENTITIES; +]>  -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> - <chapter id="example-mappings"> <title>Example: Various Mappings</title> @@ -33,7 +35,7 @@ This chapters explores some more complex association mappings. </para> - <sect1 id="example-mappings-emp"> + <section id="example-mappings-emp"> <title>Employer/Employee</title> <para> @@ -46,10 +48,10 @@ <mediaobject> <imageobject role="html"> - <imagedata fileref="../images/EmployerEmployee.png" format="PNG" align="center" /> + <imagedata fileref="images/EmployerEmployee.png" format="PNG" align="center" /> </imageobject> <imageobject role="fo"> - <imagedata fileref="../images/EmployerEmployee.png" format="PNG" align="center" width="17cm" /> + <imagedata fileref="images/EmployerEmployee.png" format="PNG" align="center" width="17cm" /> </imageobject> </mediaobject> @@ -144,9 +146,9 @@ create sequence employment_id_seq create sequence employer_id_seq]]></programlisting> - </sect1> + </section> - <sect1 id="example-mappings-authorwork"> + <section id="example-mappings-authorwork"> <title>Author/Work</title> <para> @@ -160,10 +162,10 @@ <mediaobject> <imageobject role="html"> - <imagedata fileref="../images/AuthorWork.png" format="PNG" align="center" /> + <imagedata fileref="images/AuthorWork.png" format="PNG" align="center" /> </imageobject> <imageobject role="fo"> - <imagedata fileref="../images/AuthorWork.png" format="PNG" align="center" width="17cm" /> + <imagedata fileref="images/AuthorWork.png" format="PNG" align="center" width="17cm" /> </imageobject> </mediaobject> @@ -266,9 +268,9 @@ alter table author_work add constraint author_workFK1 foreign key (work_id) references works]]></programlisting> - </sect1> + </section> - <sect1 id="example-mappings-customerorderproduct"> + <section id="example-mappings-customerorderproduct"> <title>Customer/Order/Product</title> <para> @@ -284,10 +286,10 @@ <mediaobject> <imageobject role="html"> - <imagedata fileref="../images/CustomerOrderProduct.png" format="PNG" align="center" /> + <imagedata fileref="images/CustomerOrderProduct.png" format="PNG" align="center" /> </imageobject> <imageobject role="fo"> - <imagedata fileref="../images/CustomerOrderProduct.png" format="PNG" align="center" width="17cm" /> + <imagedata fileref="images/CustomerOrderProduct.png" format="PNG" align="center" width="17cm" /> </imageobject> </mediaobject> @@ -374,9 +376,9 @@ alter table line_items add constraint line_itemsFK1 foreign key (order_id) references orders]]></programlisting> - </sect1> + </section> - <sect1 id="misc"> + <section id="misc"> <title>Miscellaneous example mappings</title> <para> @@ -387,7 +389,7 @@  - <sect2 id="example-mappings-typed-onetone"> + <section id="example-mappings-typed-onetone"> <title>"Typed" one-to-one association</title> <programlisting><![CDATA[<class name="Person"> <id name="name"/> @@ -415,9 +417,9 @@ <property name="state"/> <property name="zip"/> </class>]]></programlisting> - </sect2> + </section> - <sect2 id="example-mappings-composite-key"> + <section id="example-mappings-composite-key"> <title>Composite key example</title> <programlisting><![CDATA[<class name="Customer"> @@ -532,9 +534,9 @@ </property> </class>]]></programlisting> - </sect2> + </section> - <sect2 id="example-mappings-composite-key-manytomany"> + <section id="example-mappings-composite-key-manytomany"> <title>Many-to-many with shared composite key attribute</title> <programlisting><![CDATA[<class name="User" table="`User`"> <composite-id> @@ -571,9 +573,9 @@ </set> </class> ]]></programlisting> - </sect2> + </section> - <sect2 id="example-mappings-content-discrimination"> + <section id="example-mappings-content-discrimination"> <title>Content based discrimination</title> <programlisting><![CDATA[<class name="Person" discriminator-value="P"> @@ -625,9 +627,9 @@ </subclass> </class>]]></programlisting> - </sect2> + </section> - <sect2 id="example-mappings-association-alternatekeys" revision="2"> + <section id="example-mappings-association-alternatekeys" revision="2"> <title>Associations on alternate keys</title> <programlisting><![CDATA[<class name="Person"> @@ -678,9 +680,9 @@ <property name="type" not-null="true"/> </class>]]></programlisting> - </sect2> + </section> - </sect1> + </section> </chapter> Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/example_parentchild.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/example_parentchild.xml 2010-02-08 04:15:14 UTC (rev 18714) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/example_parentchild.xml 2010-02-08 04:24:37 UTC (rev 18715) @@ -1,4 +1,8 @@ -<?xml version='1.0' encoding="UTF-8"?> +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Hibernate_Core_Reference_Guide.ent"> +%BOOK_ENTITIES; +]>  - -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> - <chapter id="example-parentchild"> <title>Example: Parent/Child</title> @@ -41,7 +42,7 @@ </para> - <sect1 id="example-parentchild-collections"> + <section id="example-parentchild-collections"> <title>A note about collections</title> <para> @@ -82,9 +83,9 @@ child is bound to the life cycle of the parent. </para> - </sect1> + </section> - <sect1 id="example-parentchild-bidir"> + <section id="example-parentchild-bidir"> <title>Bidirectional one-to-many</title> <para> @@ -195,9 +196,9 @@ session.save(c); session.flush();]]></programlisting> - </sect1> + </section> - <sect1 id="example-parentchild-cascades"> + <section id="example-parentchild-cascades"> <title>Cascading life cycle</title> <para> @@ -268,9 +269,9 @@ <literal>setParent()</literal>. </para> - </sect1> + </section> - <sect1 id="example-parentchild-update"> + <section id="example-parentchild-update"> <title>Cascades and <literal>unsaved-value</literal></title> <para> @@ -366,9 +367,9 @@ Do not worry; in Hibernate3 you do not need to write any of this kind of code if you do not want to. </para> --> - </sect1> + </section> - <sect1 id="example-parentchild-conclusion"> + <section id="example-parentchild-conclusion"> <title>Conclusion</title> <para> @@ -383,6 +384,6 @@ cannot own collections and they should not be the child of any entity other than the unique parent. </para> - </sect1> + </section> </chapter> Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/example_weblog.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/example_weblog.xml 2010-02-08 04:15:14 UTC (rev 18714) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/example_weblog.xml 2010-02-08 04:24:37 UTC (rev 18715) @@ -1,4 +1,8 @@ -<?xml version='1.0' encoding="UTF-8"?> +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Hibernate_Core_Reference_Guide.ent"> +%BOOK_ENTITIES; +]>  -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> - <chapter id="example-weblog"> <title>Example: Weblog Application</title> - <sect1 id="example-weblog-classes"> + <section id="example-weblog-classes"> <title>Persistent Classes</title> <para> @@ -110,9 +112,9 @@ } }]]></programlisting> - </sect1> + </section> - <sect1 id="example-weblog-mappings"> + <section id="example-weblog-mappings"> <title>Hibernate Mappings</title> <para> @@ -203,9 +205,9 @@ </hibernate-mapping>]]></programlisting> - </sect1> + </section> - <sect1 id="example-weblog-code"> + <section id="example-weblog-code"> <title>Hibernate Code</title> <para> @@ -451,7 +453,7 @@ } }]]></programlisting> - </sect1> + </section> </chapter> Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/filters.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/filters.xml 2010-02-08 04:15:14 UTC (rev 18714) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/filters.xml 2010-02-08 04:24:37 UTC (rev 18715) @@ -1,4 +1,8 @@ -<?xml version='1.0' encoding="UTF-8"?> +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Hibernate_Core_Reference_Guide.ent"> +%BOOK_ENTITIES; +]>  -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> - <chapter id="filters"> <title>Filtering data</title> @@ -34,7 +36,7 @@ enabled or disabled for a particular Hibernate session. </para> - <sect1 id="objectstate-filters" revision="1"> + <section id="objectstate-filters" revision="1"> <title>Hibernate filters</title> <para> @@ -167,7 +169,7 @@ particular case. </para> - </sect1> + </section> </chapter> Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/inheritance_mapping.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/inheritance_mapping.xml 2010-02-08 04:15:14 UTC (rev 18714) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/inheritance_mapping.xml 2010-02-08 04:24:37 UTC (rev 18715) @@ -1,4 +1,8 @@ -<?xml version='1.0' encoding="UTF-8"?> +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Hibernate_Core_Reference_Guide.ent"> +%BOOK_ENTITIES; +]>  -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> - <chapter id="inheritance"> <title>Inheritance mapping</title> - <sect1 id="inheritance-strategies" revision="3"> + <section id="inheritance-strategies" revision="3"> <title>The three strategies</title> <para> @@ -99,7 +101,7 @@ </hibernate-mapping>]]></programlisting> - <sect2 id="inheritance-tableperclass" > + <section id="inheritance-tableperclass" > <title>Table per class hierarchy</title> <para> @@ -134,9 +136,9 @@ cannot have <literal>NOT NULL</literal> constraints. </para> - </sect2> + </section> - <sect2 id="inheritance-tablepersubclass"> + <section id="inheritance-tablepersubclass"> <title>Table per subclass</title> <para> @@ -170,9 +172,9 @@ is actually a one-to-one association. </para> - </sect2> + </section> - <sect2 id="inheritance-tablepersubclass-discriminator" revision="2"> + <section id="inheritance-tablepersubclass-discriminator" revision="2"> <title>Table per subclass: using a discriminator</title> <para> @@ -221,9 +223,9 @@ outer join when querying the superclass. </para> - </sect2> + </section> - <sect2 id="inheritance-mixing-tableperclass-tablepersubclass"> + <section id="inheritance-mixing-tableperclass-tablepersubclass"> <title>Mixing table per class hierarchy with table per subclass</title> <para> @@ -260,9 +262,9 @@ <programlisting><![CDATA[<many-to-one name="payment" column="PAYMENT_ID" class="Payment"/>]]></programlisting> - </sect2> + </section> - <sect2 id="inheritance-tableperconcrete" revision="2"> + <section id="inheritance-tableperconcrete" revision="2"> <title>Table per concrete class</title> <para> @@ -309,9 +311,9 @@ of the superclass. </para> - </sect2> + </section> - <sect2 id="inheritance-tableperconcreate-polymorphism"> + <section id="inheritance-tableperconcreate-polymorphism"> <title>Table per concrete class using implicit polymorphism</title> <para> @@ -346,10 +348,10 @@ Notice that the <literal>Payment</literal> interface is not mentioned explicitly. Also notice that properties of <literal>Payment</literal> are mapped in each of the subclasses. If you want to avoid duplication, consider - using XML entities - (for example, <literal>[ <!ENTITY allproperties SYSTEM "allproperties.xml"> ]</literal> + using XML entities (for example, + <literal>[ <!ENTITY allproperties SYSTEM "allproperties.xml"> ]</literal> in the <literal>DOCTYPE</literal> declaration and - <literal>&allproperties;</literal> in the mapping). + <literal>&allproperties&semi;</literal> in the mapping). </para> <para> @@ -370,9 +372,9 @@ <column name="PAYMENT_ID"/> </any>]]></programlisting> - </sect2> + </section> - <sect2 id="inheritance-mixingpolymorphism"> + <section id="inheritance-mixingpolymorphism"> <title>Mixing implicit polymorphism with other inheritance mappings</title> <para> @@ -421,11 +423,11 @@ not instances of <literal>NonelectronicTransaction</literal>. </para> - </sect2> + </section> - </sect1> + </section> - <sect1 id="inheritance-limitations"> + <section id="inheritance-limitations"> <title>Limitations</title> <para> @@ -436,13 +438,65 @@ </para> <para> - The following table shows the limitations of table per concrete-class + The following list shows the limitations of table per concrete-class mappings, and of implicit polymorphism, in Hibernate. </para> + + <variablelist> + <varlistentry> + <term>table per class-heirarchy</term> + <term>table per subclass</term> + <listitem> + <itemizedlist> + <listitem><para>Polymorphic many-to-one: <code><many-to-one></code></para></listitem> + <listitem><para>Polymorphic one-to-one: <code><one-to-one></code></para></listitem> + <listitem><para>Polymorphic one-to-many: <code><one-to-many></code></para></listitem> + <listitem><para>Polymorphic many-to-many: <code><many-to-many></code></para></listitem> + <listitem><para>Polymorphic <literal>load()</literal> or <literal>get()</literal>: <code>s.get(Payment.class, id)</code></para></listitem> + <listitem><para>Polymorphic queries: <code>from Payment p</code></para></listitem> + <listitem><para>Polymorphic joins: <code>from Order o join o.payment p</code></para></listitem> + </itemizedlist> + <para> + Outer join fetching is supported. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>table per concrete-class (union-subclass)</term> + <listitem> + <itemizedlist> + <listitem><para>Polymorphic many-to-one: <code><many-to-one></code></para></listitem> + <listitem><para>Polymorphic one-to-one: <code><one-to-one></code></para></listitem> + <listitem><para>Polymorphic one-to-many: <code><one-to-many></code> (for <code>inverse="true"</code> only)</para></listitem> + <listitem><para>Polymorphic many-to-many: <code><many-to-many></code></para></listitem> + <listitem><para>Polymorphic <literal>load()</literal> or <literal>get()</literal>: <code>s.get(Payment.class, id)</code></para></listitem> + <listitem><para>Polymorphic queries: <code>from Payment p</code></para></listitem> + <listitem><para>Polymorphic joins: <code>from Order o join o.payment p</code></para></listitem> + </itemizedlist> + <para> + Outer join fetching is supported. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>table per concrete class (implicit polymorphism</term> + <listitem> + <itemizedlist> + <listitem><para>Polymorphic many-to-one: <code><any></code></para></listitem> + <listitem><para>Polymorphic many-to-many: <code><many-to-many></code></para></listitem> + <listitem><para>Polymorphic <literal>load()</literal> or <literal>get()</literal>: <code>s.createCriteria(Payment.class).add( Restrictions.idEq(id) ).uniqueResult()</code></para></listitem> + <listitem><para>Polymorphic queries: <code>from Payment p</code></para></listitem> + </itemizedlist> + <para> + Polymorphic one-to-one, polymorphic one-to-many, polymorphic joins, and outer join fetching are not supported. + </para> + </listitem> + </varlistentry> + </variablelist> - <table frame="topbot"> +  - </sect1> + </section> </chapter> Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/performance.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/performance.xml 2010-02-08 04:15:14 UTC (rev 18714) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/performance.xml 2010-02-08 04:24:37 UTC (rev 18715) @@ -1,4 +1,8 @@ -<?xml version='1.0' encoding="UTF-8"?> +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Hibernate_Core_Reference_Guide.ent"> +%BOOK_ENTITIES; +]>  -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> - <chapter id="performance"> <title>Improving performance</title> - <sect1 id="performance-fetching" revision="2"> + <section id="performance-fetching" revision="2"> <title>Fetching strategies</title> <para> @@ -139,7 +141,7 @@ in any detached instance of a particular class. </para> - <sect2 id="performance-fetching-lazy"> + <section id="performance-fetching-lazy"> <title>Working with lazy associations</title> <para> @@ -198,9 +200,9 @@ collections. </para> - </sect2> + </section> - <sect2 id="performance-fetching-custom" revision="4"> + <section id="performance-fetching-custom" revision="4"> <title>Tuning fetch strategies</title> <para> @@ -278,9 +280,9 @@ second-level cache. </para> - </sect2> + </section> - <sect2 id="performance-fetching-proxies" revision="2"> + <section id="performance-fetching-proxies" revision="2"> <title>Single-ended association proxies</title> <para> @@ -427,9 +429,9 @@ will result in immediate proxy initialization. </para> - </sect2> + </section> - <sect2 id="performance-fetching-initialization" revision="1"> + <section id="performance-fetching-initialization" revision="1"> <title>Initializing collections and proxies</title> <para> @@ -521,9 +523,9 @@ <programlisting><![CDATA[s.createFilter( lazyCollection, "").setFirstResult(0).setMaxResults(10).list();]]></programlisting> - </sect2> + </section> - <sect2 id="performance-fetching-batch"> + <section id="performance-fetching-batch"> <title>Using batch fetching</title> <para> @@ -575,9 +577,9 @@ <emphasis>materialized path</emphasis> might be a better option for read-mostly trees. </para> - </sect2> + </section> - <sect2 id="performance-fetching-subselect"> + <section id="performance-fetching-subselect"> <title>Using subselect fetching</title> <para> @@ -588,9 +590,9 @@  - </sect2> + </section> - <sect2 id="performance-fetching-lazyproperties"> + <section id="performance-fetching-lazyproperties"> <title>Using lazy property fetching</title> <para> @@ -652,11 +654,11 @@ properties</literal> in HQL. </para> - </sect2> + </section> - </sect1> + </section> - <sect1 id="performance-cache" revision="1"> + <section id="performance-cache" revision="1"> <title>The Second Level Cache</title> <para> @@ -699,21 +701,21 @@ <entry>Hashtable (not intended for production use)</entry> <entry><literal>org.hibernate.cache.HashtableCacheProvider</literal></entry> <entry>memory</entry> - <entry> </entry> + <entry></entry> <entry>yes</entry> </row> <row> <entry>EHCache</entry> <entry><literal>org.hibernate.cache.EhCacheProvider</literal></entry> <entry>memory, disk</entry> - <entry> </entry> + <entry></entry> <entry>yes</entry> </row> <row> <entry>OSCache</entry> <entry><literal>org.hibernate.cache.OSCacheProvider</literal></entry> <entry>memory, disk</entry> - <entry> </entry> + <entry></entry> <entry>yes</entry> </row> <row> @@ -721,7 +723,7 @@ <entry><literal>org.hibernate.cache.SwarmCacheProvider</literal></entry> <entry>clustered (ip multicast)</entry> <entry>yes (clustered invalidation)</entry> - <entry> </entry> + <entry></entry> </row> <row> <entry>JBoss Cache 1.x</entry> @@ -741,7 +743,7 @@ </tgroup> </table> - <sect2 id="performance-cache-mapping" revision="2"> + <section id="performance-cache-mapping" revision="2"> <title>Cache mappings</title> <para> @@ -797,9 +799,9 @@ The <literal>usage</literal> attribute specifies a <emphasis>cache concurrency strategy</emphasis>. </para> - </sect2> + </section> - <sect2 id="performance-cache-readonly"> + <section id="performance-cache-readonly"> <title>Strategy: read only</title> <para> @@ -813,10 +815,10 @@ .... </class>]]></programlisting> - </sect2> + </section> - <sect2 id="performance-cache-readwrite"> + <section id="performance-cache-readwrite"> <title>Strategy: read/write</title> <para> @@ -839,9 +841,9 @@ </set> </class>]]></programlisting> - </sect2> + </section> - <sect2 id="performance-cache-nonstrict"> + <section id="performance-cache-nonstrict"> <title>Strategy: nonstrict read/write</title> <para> @@ -853,9 +855,9 @@ <literal>Session.close()</literal> or <literal>Session.disconnect()</literal> is called. </para> - </sect2> + </section> - <sect2 id="performance-cache-transactional"> + <section id="performance-cache-transactional"> <title>Strategy: transactional</title> <para> @@ -864,9 +866,9 @@ specify <literal>hibernate.transaction.manager_lookup_class</literal>. </para> - </sect2> + </section> - <sect2 id="performance-cache-compat-matrix"> + <section id="performance-cache-compat-matrix"> <title>Cache-provider/concurrency-strategy compatibility</title> <important> @@ -902,52 +904,52 @@ <entry>yes</entry> <entry>yes</entry> <entry>yes</entry> - <entry> </entry> + <entry></entry> </row> <row> <entry>EHCache</entry> <entry>yes</entry> <entry>yes</entry> <entry>yes</entry> - <entry> </entry> + <entry></entry> </row> <row> <entry>OSCache</entry> <entry>yes</entry> <entry>yes</entry> <entry>yes</entry> - <entry> </entry> + <entry></entry> </row> <row> <entry>SwarmCache</entry> <entry>yes</entry> <entry>yes</entry> - <entry> </entry> - <entry> </entry> + <entry></entry> + <entry></entry> </row> <row> <entry>JBoss Cache 1.x</entry> <entry>yes</entry> - <entry> </entry> - <entry> </entry> + <entry></entry> + <entry></entry> <entry>yes</entry> </row> <row> <entry>JBoss Cache 2</entry> <entry>yes</entry> - <entry> </entry> - <entry> </entry> + <entry></entry> + <entry></entry> <entry>yes</entry> </row> </tbody> </tgroup> </table> - </sect2> + </section> - </sect1> + </section> - <sect1 id="performance-sessioncache" revision="2"> + <section id="performance-sessioncache" revision="2"> <title>Managing the caches</title> <para> @@ -1041,102 +1043,60 @@ <programlisting><![CDATA[hibernate.generate_statistics true hibernate.cache.use_structured_entries true]]></programlisting> - </sect1> - - <sect1 id="performance-querycache" revision="1"> + </section> + + <section id="performance-querycache" revision="1"> <title>The Query Cache</title> <para> Query result sets can also be cached. This is only useful for queries that are run - frequently with the same parameters. + frequently with the same parameters. You will first need to enable the query cache: </para> - <sect2 id="performance-querycache-enable"> - <title>Enabling query caching</title> - <para> - Caching of query results introduces some overhead in terms of your applications normal - transactional processing. For example, if you cache results of a query against Person - Hibernate will need to keep track of when those results should be invalidated because - changes have been committed against Person. That, coupled with the fact that most - applications simply gain no benefit from caching query results, leads Hibernate to - disable caching of query results by default. To use query caching, you will first - need to enable the query cache: - </para> - <programlisting><![CDATA[hibernate.cache.use_query_cache true]]></programlisting> - <para> - This setting creates two new cache regions: - <itemizedlist> - <listitem> - <para> - <classname>org.hibernate.cache.StandardQueryCache</classname>, holding - the cached query results - </para> - </listitem> - <listitem> - <para> - <classname>org.hibernate.cache.UpdateTimestampsCache</classname>, holding - timestamps of the most recent updates to queryable tables. These are used - to validate the results as they are served from the query cache. - </para> - </listitem> - </itemizedlist> - </para> - <important> - <para> - If you configure your underlying cache implementation to use expiry or - timeouts is is very important that the cache timeout of the underlying - cache region for the UpdateTimestampsCache be set to a higher value than - the timeouts of any of the query caches. In fact, we recommend that the - the UpdateTimestampsCache region not be configured for expiry at all. Note, - in particular, that an LRU cache expiry policy is never appropriate. - </para> - </important> - <para> - As mentioned above, most queries do not benefit from caching or their results. So by - default, individual queries are not cached even after enabling query caching. To enable - results caching for a particular query, call - <literal>org.hibernate.Query.setCacheable(true)</literal>. This call allows the query - to look for existing cache results or add its results to the cache when it is executed. - </para> - <note> - <para> - The query cache does not cache the state of the actual entities in the cache; it - caches only identifier values and results of value type. For this reaso, the query - cache should always be used in conjunction with the second-level cache for those - entities expected to be cached as part of a query result cache (just as with - collection caching). - </para> - </note> - </sect2> + <programlisting><![CDATA[hibernate.cache.use_query_cache true]]></programlisting> + + <para> + This setting creates two new cache regions: one holding cached query + result sets (<literal>org.hibernate.cache.StandardQueryCache</literal>), the other + holding timestamps of the most recent updates to queryable tables + (<literal>org.hibernate.cache.UpdateTimestampsCache</literal>). Note that the query + cache does not cache the state of the actual entities in the result set; it caches + only identifier values and results of value type. The query cache should always be + used in conjunction with the second-level cache. + </para> + + <para> + Most queries do not benefit from caching, so by default, queries are not cached. To + enable caching, call <literal>Query.setCacheable(true)</literal>. This call allows + the query to look for existing cache results or add its results to the cache when + it is executed. + </para> + + <para> + If you require fine-grained control over query cache expiration policies, you can + specify a named cache region for a particular query by calling + <literal>Query.setCacheRegion()</literal>. + </para> + + <programlisting><![CDATA[List blogs = sess.createQuery("from Blog blog where blog.blogger = :blogger") + .setEntity("blogger", blogger) + .setMaxResults(15) + .setCacheable(true) + .setCacheRegion("frontpages") + .list();]]></programlisting> - <sect2 id="performance-querycache-regions"> - <title>Query cache regions</title> - <para> - If you require fine-grained control over query cache expiration policies, you can - specify a named cache region for a particular query by calling - <literal>Query.setCacheRegion()</literal>. - </para> - <programlisting role="JAVA"><![CDATA[List blogs = sess.createQuery("from Blog blog where blog.blogger = :blogger") - .setEntity("blogger", blogger) - .setMaxResults(15) - .setCacheable(true) - .setCacheRegion("frontpages") - .list();]]></programlisting> + <para> + If the query should force a refresh of its query cache region, you should call + <literal>Query.setCacheMode(CacheMode.REFRESH)</literal>. This is particularly useful + in cases where underlying data may have been updated via a separate process (i.e., + not modified through Hibernate) and allows the application to selectively refresh + particular query result sets. This is a more efficient alternative to eviction of + a query cache region via <literal>SessionFactory.evictQueries()</literal>. + </para> - <para> - If you want to force the query cache to refresh one of its regions (disregard any - cached results it finds there) you can use - <literal>org.hibernate.Query.setCacheMode(CacheMode.REFRESH)</literal>. In conjunction - with the region you have defined for the given query, Hibernate will selectively force - the results cached in that particular region to be refreshed. This is particularly useful - in cases where underlying data may have been updated via a separate process and is a far more - efficient alternative to bulk eviction of the region via - <literal>org.hibernate.SessionFactory.evictQueries()</literal>. - </para> - </sect2> - </sect1> + </section> - <sect1 id="performance-collections"> + <section id="performance-collections"> <title>Understanding Collection performance</title> <para> @@ -1145,7 +1105,7 @@ collections at runtime. </para> - <sect2 id="performance-collections-taxonomy"> + <section id="performance-collections-taxonomy"> <title>Taxonomy</title> <para>Hibernate defines three basic kinds of collections:</para> @@ -1222,9 +1182,9 @@ collection. </para> - </sect2> + </section> - <sect2 id="performance-collections-mostefficientupdate"> + <section id="performance-collections-mostefficientupdate"> <title>Lists, maps, idbags and sets are the most efficient collections to update</title> <para> @@ -1257,9 +1217,9 @@ considerations of collection update performance simply do not apply. </para> - </sect2> + </section> - <sect2 id="performance-collections-mostefficentinverse"> + <section id="performance-collections-mostefficentinverse"> <title>Bags and lists are the most efficient inverse collections</title> <para> @@ -1278,9 +1238,9 @@ p.getChildren().add(c); //no need to fetch the collection! sess.flush();]]></programlisting> - </sect2> + </section> - <sect2 id="performance-collections-oneshotdelete"> + <section id="performance-collections-oneshotdelete"> <title>One shot delete</title> <para> @@ -1327,11 +1287,11 @@ One-shot-delete does not apply to collections mapped <literal>inverse="true"</literal>. </para> - </sect2> + </section> - </sect1> + </section> - <sect1 id="performance-monitoring" revision="1"> + <section id="performance-monitoring" revision="1"> <title>Monitoring performance</title> <para> @@ -1340,7 +1300,7 @@ Statistics in Hibernate are available per <literal>SessionFactory</literal>. </para> - <sect2 id="performance-monitoring-sf" revision="2"> + <section id="performance-monitoring-sf" revision="2"> <title>Monitoring a SessionFactory</title> <para> @@ -1406,9 +1366,9 @@ method. </para> - </sect2> + </section> - <sect2 id="performance-monitoring-metrics" revision="1"> + <section id="performance-monitoring-metrics" revision="1"> <title>Metrics</title> <para> @@ -1479,8 +1439,8 @@ <literal>getSecondLevelCacheRegionNames()</literal>. </para> - </sect2> + </section> - </sect1> + </section> </chapter> Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/persistent_classes.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/persistent_classes.xml 2010-02-08 04:15:14 UTC (rev 18714) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/persistent_classes.xml 2010-02-08 04:24:37 UTC (rev 18715) @@ -1,4 +1,8 @@ -<?xml version='1.0' encoding="UTF-8"?> +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Hibernate_Core_Reference_Guide.ent"> +%BOOK_ENTITIES; +]>  -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> - <chapter id="persistent-classes" revision="2"> <title>Persistent Classes</title> @@ -43,7 +45,7 @@ ways (using trees of <literal>Map</literal> instances, for example). </para> - <sect1 id="persistent-classes-pojo"> + <section id="persistent-classes-pojo"> <title>A simple POJO example</title> <para> @@ -134,7 +136,7 @@ </para> - <sect2 id="persistent-classes-pojo-constructor" revision="1"> + <section id="persistent-classes-pojo-constructor" revision="1"> <title>Implement a no-argument constructor</title> <para> @@ -144,9 +146,9 @@ default constructor with at least <emphasis>package</emphasis> visibility for runtime proxy generation in Hibernate. </para> - </sect2> + </section> - <sect2 id="persistent-classes-pojo-identifier" revision="2"> + <section id="persistent-classes-pojo-identifier" revision="2"> <title>Provide an identifier property (optional)</title> <para> @@ -191,9 +193,9 @@ We recommend that you declare consistently-named identifier properties on persistent classes and that you use a nullable (i.e., non-primitive) type. </para> - </sect2> + </section> - <sect2 id="persistent-classes-pojo-final"> + <section id="persistent-classes-pojo-final"> <title>Prefer non-final classes (optional)</title> <para> A central feature of Hibernate, <emphasis>proxies</emphasis>, depends upon the @@ -210,9 +212,9 @@ non-final classes. If you want to use a class with a <literal>public final</literal> method, you must explicitly disable proxying by setting <literal>lazy="false"</literal>. </para> - </sect2> + </section> - <sect2 id="persistent-classes-pojo-accessors" revision="2"> + <section id="persistent-classes-pojo-accessors" revision="2"> <title>Declare accessors and mutators for persistent fields (optional)</title> <para> @@ -231,11 +233,11 @@ <literal>private</literal> get / set pair. </para> - </sect2> + </section> - </sect1> + </section> - <sect1 id="persistent-classes-inheritance"> + <section id="persistent-classes-inheritance"> <title>Implementing inheritance</title> <para> @@ -255,9 +257,9 @@ this.name=name; } }]]></programlisting> - </sect1> + </section> - <sect1 id="persistent-classes-equalshashcode" revision="1"> + <section id="persistent-classes-equalshashcode" revision="1"> <title>Implementing <literal>equals()</literal> and <literal>hashCode()</literal></title> <para> @@ -340,9 +342,9 @@ candidates for a business key. </para> - </sect1> + </section> - <sect1 id="persistent-classes-dynamicmodels"> + <section id="persistent-classes-dynamicmodels"> <title>Dynamic models</title> @@ -485,9 +487,9 @@ in <xref linkend="xml"/>. </para> - </sect1> + </section> - <sect1 id="persistent-classes-tuplizers" revision="1"> + <section id="persistent-classes-tuplizers" revision="1"> <title>Tuplizers</title> <para> @@ -554,9 +556,10 @@ }]]></programlisting> - </sect1> + </section> - <sect1 id="persistent-classes-entity-name-resolver" revision="0"> + + <section id="persistent-classes-entity-name-resolver" revision="0"> <title>EntityNameResolvers</title> <para> @@ -687,8 +690,8 @@ <orderedlist> <listitem> <para> - Implement a custom <link linkend="persistent-classes-tuplizers">Tuplizer</link>, implementing - the <methodname>getEntityNameResolvers</methodname> method. + Implement a custom Tupelizer implementing the <methodname>getEntityNameResolvers</methodname> + method (see <xref linkend="persistent-classes-tuplizers" />). </para> </listitem> <listitem> @@ -700,14 +703,14 @@ </listitem> </orderedlist> </para> - </sect1> + </section> -  + </section>--> </chapter> Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/portability.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/portability.xml 2010-02-08 04:15:14 UTC (rev 18714) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/portability.xml 2010-02-08 04:24:37 UTC (rev 18715) @@ -1,4 +1,8 @@ -<?xml version='1.0' encoding="UTF-8"?> +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Hibernate_Core_Reference_Guide.ent"> +%BOOK_ENTITIES; +]>  -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> <chapter id="portability"> <title>Database Portability Considerations</title> - <sect1 id="portability-basics"> + <section id="portability-basics"> <title>Portability Basics</title> <para> @@ -36,9 +39,9 @@ the exact scenario, the basic idea is that you want Hibernate to help you run against any number of databases without changes to your code, and ideally without any changes to the mapping metadata. </para> - </sect1> + </section> - <sect1 id="portability-dialect"> + <section id="portability-dialect"> <title>Dialect</title> <para> @@ -49,9 +52,9 @@ of dialects for many of the most popular databases. If you find that your particular database is not among them, it is not terribly difficult to write your own. </para> - </sect1> + </section> - <sect1 id="portability-dialectresolver"> + <section id="portability-dialectresolver"> <title>Dialect resolution</title> <para> @@ -92,9 +95,9 @@ <constant>DIALECT_RESOLVERS</constant> constant on <classname>org.hibernate.cfg.Environment</classname>). </para> - </sect1> + </section> - <sect1 id="portability-idgen"> + <section id="portability-idgen"> <title>Identifier generation</title> <para> @@ -110,22 +113,19 @@ know the identifier value. Because Hibernate relies on this identifier value to uniquely reference entities within a persistence context it must then issue the insert immediately when the users requests the entitiy be associated with the session (like via - save() e.g.) regardless of current transactional semantics. - - <note> - <para> - Hibernate was changed slightly once the implication of this was better understood so that - the insert is delayed in cases where that is feasible. - </para> - </note> - - The underlying issue is that the actual semanctics of the application itself changes in these cases. + save() e.g.) regardless of current transactional semantics. The underlying issue is that the semantics of the application itself changes in these cases. </para> + <note> + <para> + Hibernate has been improved so that + the insert is delayed in cases where that is feasible. + </para> + </note> <para> Starting with version 3.2.3, Hibernate comes with a set of <ulink url="http://in.relation.to/2082.lace">enhanced</ulink> identifier generators targetting - portability in a much different way. + portability in a much different way.</para> <note> <para> There are specifically 2 bundled <emphasis>enhanced</emphasis>generators: @@ -143,21 +143,20 @@ </itemizedlist> </para> </note> + <para> The idea behind these generators is to port the actual semantics of the identifer value generation to the different databases. For example, the <classname>org.hibernate.id.enhanced.SequenceStyleGenerator</classname> mimics the behavior of a sequence on databases which do not support sequences by using a table. </para> - </sect1> + </section> - <sect1 id="portability-functions"> + <section id="portability-functions"> <title>Database functions</title> <warning> <para> - This is an area in Hibernate in need of improvement. In terms of portability concerns, - this function handling currently works pretty well from HQL; however, it is quite lacking - in all other aspects. + This is a new area in Hibernate and as such it is not as mature as the overall Hibernate experience. </para> </warning> @@ -181,24 +180,24 @@ </para> </important> </para> - </sect1> + </section> - <sect1 id="portability-types"> + <section id="portability-types"> <title>Type mappings</title> <para> This section scheduled for completion at a later date... </para> -  - </sect1> -</chapter> \ No newline at end of file + </section> --> + + </section> +</chapter> Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/query_criteria.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/query_criteria.xml 2010-02-08 04:15:14 UTC (rev 18714) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/query_criteria.xml 2010-02-08 04:24:37 UTC (rev 18715) @@ -1,4 +1,7 @@ -<?xml version='1.0' encoding="UTF-8"?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Hibernate_Core_Reference_Guide.ent"> +%BOOK_ENTITIES; +]>  -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> - <chapter id="querycriteria"> <title>Criteria Queries</title> @@ -32,7 +33,7 @@ Hibernate features an intuitive, extensible criteria query API. </para> - <sect1 id="querycriteria-creating"> + <section id="querycriteria-creating"> <title>Creating a <literal>Criteria</literal> instance</title> <para> @@ -45,9 +46,9 @@ crit.setMaxResults(50); List cats = crit.list();]]></programlisting> - </sect1> + </section> - <sect1 id="querycriteria-narrowing"> + <section id="querycriteria-narrowing"> <title>Narrowing the result set</title> <para> @@ -117,9 +118,9 @@ .add( Property.forName("name").in( new String[] { "Fritz", "Izi", "Pk" } ) ) .list();]]></programlisting> - </sect1> + </section> - <sect1 id="querycriteria-ordering"> + <section id="querycriteria-ordering"> <title>Ordering the results</title> <para> @@ -140,9 +141,9 @@ .setMaxResults(50) .list();]]></programlisting> - </sect1> + </section> - <sect1 id="querycriteria-associations" revision="2"> + <section id="querycriteria-associations" revision="2"> <title>Associations</title> <para> @@ -196,9 +197,9 @@ Cat kitten = (Cat) map.get("kt"); }]]></programlisting> - </sect1> + </section> - <sect1 id="querycriteria-dynamicfetching" revision="1"> + <section id="querycriteria-dynamicfetching" revision="1"> <title>Dynamic association fetching</title> <para> @@ -217,9 +218,9 @@ by outer join. See <xref linkend="performance-fetching"/> for more information. </para> - </sect1> + </section> - <sect1 id="querycriteria-examples"> + <section id="querycriteria-examples"> <title>Example queries</title> <para> @@ -262,9 +263,9 @@ .add( Example.create( cat.getMate() ) ) .list();]]></programlisting> - </sect1> + </section> - <sect1 id="querycriteria-projection"> + <section id="querycriteria-projection"> <title>Projections, aggregation and grouping</title> <para> The class <literal>org.hibernate.criterion.Projections</literal> is a @@ -356,9 +357,9 @@ .addOrder( Order.desc("avgWeight") ) .list();]]></programlisting> - </sect1> + </section> - <sect1 id="querycriteria-detachedqueries"> + <section id="querycriteria-detachedqueries"> <title>Detached queries and subqueries</title> <para> The <literal>DetachedCriteria</literal> class allows you to create a query outside the scope @@ -403,13 +404,13 @@ .add( Property.forName("weight").gt(avgWeightForSex) ) .list();]]></programlisting> - </sect1> + </section>  - <sect1 id="query-criteria-naturalid"> + <section id="query-criteria-naturalid"> <title>Queries by natural identifier</title> <para> @@ -455,6 +456,6 @@ ).setCacheable(true) .uniqueResult();]]></programlisting> - </sect1> + </section> </chapter> Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/query_hql.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/query_hql.xml 2010-02-08 04:15:14 UTC (rev 18714) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/query_hql.xml 2010-02-08 04:24:37 UTC (rev 18715) @@ -1,4 +1,8 @@ -<?xml version='1.0' encoding="UTF-8"?> +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Hibernate_Core_Reference_Guide.ent"> +%BOOK_ENTITIES; +]>  -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> - <chapter id="queryhql" revision="1"> <title>HQL: The Hibernate Query Language</title> @@ -34,7 +36,7 @@ and understands notions like inheritance, polymorphism and association. </para> - <sect1 id="queryhql-casesensitivity"> + <section id="queryhql-casesensitivity"> <title>Case Sensitivity</title> <para> @@ -53,9 +55,9 @@ more readable, but this convention is unsuitable for queries embedded in Java code. </para> - </sect1> + </section> - <sect1 id="queryhql-from"> + <section id="queryhql-from"> <title>The from clause</title> <para> @@ -101,9 +103,9 @@ (e.g. <literal>domesticCat</literal>). </para> - </sect1> + </section> - <sect1 id="queryhql-joins" revision="2"> + <section id="queryhql-joins" revision="2"> <title>Associations and joins</title> <para> @@ -213,9 +215,9 @@ <programlisting><![CDATA[from Document fetch all properties order by name]]></programlisting> <programlisting><![CDATA[from Document doc fetch all properties where lower(doc.name) like '%cats%']]></programlisting> - </sect1> + </section> - <sect1 id="queryhql-joins-forms"> + <section id="queryhql-joins-forms"> <title>Forms of join syntax</title> <para> @@ -235,9 +237,9 @@ </para> <programlisting><![CDATA[from Cat as cat where cat.mate.name like '%s%']]></programlisting> - </sect1> + </section> - <sect1 id="queryhql-identifier-property"> + <section id="queryhql-identifier-property"> <title>Referring to identifier property</title> <para> @@ -274,9 +276,9 @@ </para> </important> - </sect1> + </section> - <sect1 id="queryhql-select"> + <section id="queryhql-select"> <title>The select clause</title> <para> @@ -351,9 +353,9 @@ This query returns a <literal>Map</literal> from aliases to selected values. </para> - </sect1> + </section> - <sect1 id="queryhql-aggregation"> + <section id="queryhql-aggregation"> <title>Aggregate functions</title> <para> @@ -416,9 +418,9 @@ select count(distinct cat.name), count(cat) from Cat cat]]></programlisting> - </sect1> + </section> - <sect1 id="queryhql-polymorphism"> + <section id="queryhql-polymorphism"> <title>Polymorphic queries</title> <para> @@ -450,9 +452,9 @@ It also means you cannot call these queries using <literal>Query.scroll()</literal>. </para> - </sect1> + </section> - <sect1 id="queryhql-where" revision="1"> + <section id="queryhql-where" revision="1"> <title>The where clause</title> <para> @@ -472,11 +474,13 @@ This returns instances of <literal>Cat</literal> named 'Fritz'. </para> - <para> - The following query: + <para> + The following query: </para> <programlisting><![CDATA[select foo from Foo foo, Bar bar where foo.startDate = bar.date]]></programlisting> + + <para> returns all instances of <literal>Foo</literal> with an instance of <literal>bar</literal> with a <literal>date</literal> property equal to the @@ -570,18 +574,16 @@ where log.item.class = 'Payment' and log.item.id = payment.id]]></programlisting> <para> - The <literal>log.item.class</literal> and <literal>payment.class</literal> - would refer to the values of completely different database columns in the above query. + The <literal>log.item.class</literal> and <literal>payment.class</literal> would refer to the values of completely different database columns in the above query. </para> - </sect1> + </section> - <sect1 id="queryhql-expressions"> + <section id="queryhql-expressions"> <title>Expressions</title> <para> Expressions used in the <literal>where</literal> clause include the following: - </para> <itemizedlist spacing="compact"> @@ -867,9 +869,9 @@ AND cust.current_order = o.id )]]></programlisting> - </sect1> + </section> - <sect1 id="queryhql-ordering"> + <section id="queryhql-ordering"> <title>The order by clause</title> <para> @@ -883,9 +885,9 @@ The optional <literal>asc</literal> or <literal>desc</literal> indicate ascending or descending order respectively. </para> - </sect1> + </section> - <sect1 id="queryhql-grouping" revision="1"> + <section id="queryhql-grouping" revision="1"> <title>The group by clause</title> <para> @@ -931,9 +933,9 @@ non-aggregated properties explicitly. </para> - </sect1> + </section> - <sect1 id="queryhql-subqueries" revision="3"> + <section id="queryhql-subqueries" revision="3"> <title>Subqueries</title> <para> @@ -974,9 +976,9 @@ <xref linkend="queryhql-tuple"/> for more information. </para> - </sect1> + </section> - <sect1 id="queryhql-examples"> + <section id="queryhql-examples"> <title>HQL examples</title> <para> @@ -1097,9 +1099,9 @@ and PaymentStatus.UNPAID = isNull(payment.currentStatus.name, PaymentStatus.UNPAID) order by account.type.sortOrder, account.accountNumber, payment.dueDate]]></programlisting> - </sect1> + </section> - <sect1 id="queryhql-bulk" revision="2"> + <section id="queryhql-bulk" revision="2"> <title>Bulk update and delete</title> <para> @@ -1107,9 +1109,9 @@ <literal>insert ... select ...</literal> statements. See <xref linkend="batch-direct"/> for more information. </para> - </sect1> + </section> - <sect1 id="queryhql-tipstricks"> + <section id="queryhql-tipstricks"> <title>Tips & Tricks</title> <para> @@ -1187,9 +1189,9 @@ <programlisting><![CDATA[( (Integer) session.createQuery("select count(*) from ....").iterate().next() ).intValue();]]></programlisting> - </sect1> + </section> - <sect1 id="queryhql-components"> + <section id="queryhql-components"> <title>Components</title> <para> @@ -1216,11 +1218,11 @@ <programlisting><![CDATA[from Person p order by p.name.first]]></programlisting> <para> - Another common use of components is in <link linkend="queryhql-tuple">row value constructors</link>. + Another common use of components is in row value constructors (<xref linkend="queryhql-tuple" />). </para> - </sect1> + </section> - <sect1 id="queryhql-tuple"> + <section id="queryhql-tuple"> <title>Row value constructor syntax</title> <para> @@ -1260,7 +1262,7 @@ be dependent upon the ordering of the component sub-properties in the metadata. </para> - </sect1> + </section> </chapter> Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/query_sql.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/query_sql.xml 2010-02-08 04:15:14 UTC (rev 18714) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/query_sql.xml 2010-02-08 04:24:37 UTC (rev 18715) @@ -1,4 +1,8 @@ -<?xml version='1.0' encoding="UTF-8"?> +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Hibernate_Core_Reference_Guide.ent"> +%BOOK_ENTITIES; +]>  -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> - <chapter id="querysql" revision="2"> <title>Native SQL</title> @@ -37,7 +39,7 @@ <para>Hibernate3 allows you to specify handwritten SQL, including stored procedures, for all create, update, delete, and load operations.</para> - <sect1 id="querysql-creating" revision="4"> + <section id="querysql-creating" revision="4"> <title>Using a <literal>SQLQuery</literal></title> <para>Execution of native SQL queries is controlled via the @@ -45,7 +47,7 @@ <literal>Session.createSQLQuery()</literal>. The following sections describe how to use this API for querying.</para> - <sect2> + <section> <title>Scalar queries</title> <para>The most basic SQL query is to get a list of scalars @@ -108,9 +110,9 @@ not mapped, or does not result in the expected type, it is possible to customize it via calls to <literal>registerHibernateType</literal> in the Dialect.</para> - </sect2> + </section> - <sect2> + <section> <title>Entity queries</title> <para>The above queries were all about returning scalar values, @@ -150,9 +152,9 @@ ]]></programlisting> <para>This will allow cat.getDog() to function properly.</para> - </sect2> + </section> - <sect2> + <section> <title>Handling associations and collections</title> <para>It is possible to eagerly join in the <literal>Dog</literal> to @@ -183,9 +185,9 @@ enhance the sql queries to make them usable in Hibernate. Problems can arise when returning multiple entities of the same type or when the default alias/column names are not enough. </para> - </sect2> + </section> - <sect2> + <section> <title>Returning multiple entities</title> <para>Until now, the result set column names are assumed to be the same @@ -251,7 +253,7 @@ .addEntity("mother", Cat.class).list() ]]></programlisting> - <sect3 id="querysql-aliasreferences" revision="2"> + <section id="querysql-aliasreferences" revision="2"> <title>Alias and property references</title> <para>In most cases the above alias injection is needed. For @@ -368,10 +370,10 @@ </tbody> </tgroup> </table> - </sect3> - </sect2> + </section> + </section> - <sect2> + <section> <title>Returning non-managed entities</title> <para>It is possible to apply a ResultTransformer to native SQL queries, allowing it to return non-managed entities.</para> @@ -395,17 +397,17 @@ The above query will return a list of <literal>CatDTO</literal> which has been instantiated and injected the values of NAME and BIRTHNAME into its corresponding properties or fields. </para> - </sect2> + </section> - <sect2> + <section> <title>Handling inheritance</title> <para>Native SQL queries which query for entities that are mapped as part of an inheritance must include all properties for the baseclass and all its subclasses.</para> - </sect2> + </section> - <sect2> + <section> <title>Parameters</title> <para>Native SQL queries support positional as well as named @@ -416,13 +418,13 @@ query = sess.createSQLQuery("SELECT * FROM CATS WHERE NAME like :name").addEntity(Cat.class); List pusList = query.setString("name", "Pus%").list(); ]]></programlisting> - </sect2> + </section> - </sect1> + </section> - <sect1 id="querysql-namedqueries" revision="3"> + <section id="querysql-namedqueries" revision="3"> <title>Named SQL queries</title> <para>Named SQL queries can be defined in the mapping document and called @@ -509,7 +511,7 @@ .setResultSetMapping("catAndKitten") .list();]]></programlisting> - <sect2 id="propertyresults"> + <section id="propertyresults"> <title>Using return-property to explicitly specify column/alias names</title> @@ -560,9 +562,9 @@ <para>If your mapping has a discriminator you must use <literal><return-discriminator></literal> to specify the discriminator column.</para> - </sect2> + </section> - <sect2 id="sp_query" revision="1"> + <section id="sp_query" revision="1"> <title>Using stored procedures for querying</title> <para>Hibernate3 provides support for queries via stored procedures @@ -607,7 +609,7 @@ entities. <literal><return-join></literal> and <literal><load-collection></literal> are not supported.</para> - <sect3 id="querysql-limits-storedprocedures" revision="1"> + <section id="querysql-limits-storedprocedures" revision="1"> <title>Rules/limitations for using stored procedures</title> <para>You cannot use stored procedures with Hibernate unless you follow some procedure/function @@ -655,11 +657,11 @@ requirement.</para> </listitem> </itemizedlist> - </sect3> - </sect2> - </sect1> + </section> + </section> + </section> - <sect1 id="querysql-cud"> + <section id="querysql-cud"> <title>Custom SQL for create, update and delete</title> <para>Hibernate3 can use custom SQL statements for create, update, and @@ -726,9 +728,9 @@ return SQL%ROWCOUNT; END updatePerson;]]></programlisting> - </sect1> + </section> - <sect1 id="querysql-load"> + <section id="querysql-load"> <title>Custom SQL for loading</title> <para>You can also declare your own SQL (or HQL) queries for entity @@ -783,5 +785,5 @@ ON pers.ID = emp.PERSON_ID WHERE ID=? </sql-query>]]></programlisting> - </sect1> + </section> </chapter> Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/session_api.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/session_api.xml 2010-02-08 04:15:14 UTC (rev 18714) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/session_api.xml 2010-02-08 04:24:37 UTC (rev 18715) @@ -1,4 +1,8 @@ -<?xml version='1.0' encoding="UTF-8"?> +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Hibernate_Core_Reference_Guide.ent"> +%BOOK_ENTITIES; +]>  -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> - <chapter id="objectstate"> <title>Working with objects</title> @@ -44,7 +46,7 @@ relevant for the application developer when tuning the performance of the system. </para> - <sect1 id="objectstate-overview"> + <section id="objectstate-overview"> <title>Hibernate object states</title> <para> @@ -95,9 +97,9 @@ trigger a transition) in more detail. </para> - </sect1> + </section> - <sect1 id="objectstate-makingpersistent" revision="1"> + <section id="objectstate-makingpersistent" revision="1"> <title>Making objects persistent</title> <para> @@ -177,9 +179,9 @@ Transitive persistence is discussed later in this chapter. </para> - </sect1> + </section> - <sect1 id="objectstate-loading"> + <section id="objectstate-loading"> <title>Loading an object</title> <para> @@ -259,9 +261,9 @@ <xref linkend="performance-fetching"/>. </para> - </sect1> + </section> - <sect1 id="objectstate-querying" revision="1"> + <section id="objectstate-querying" revision="1"> <title>Querying</title> <para> @@ -273,7 +275,7 @@ optional support from Hibernate for result set conversion into objects. </para> - <sect2 id="objectstate-querying-executing" revision="1"> + <section id="objectstate-querying-executing" revision="1"> <title>Executing queries</title> <para> @@ -318,7 +320,7 @@ these duplicates through a <literal>Set</literal>. </para> - <sect3 id="objectstate-querying-executing-iterate"> + <section id="objectstate-querying-executing-iterate"> <title>Iterating results</title> <para> @@ -345,9 +347,9 @@ break; } }]]></programlisting> - </sect3> + </section> - <sect3 id="objectstate-querying-executing-tuples"> + <section id="objectstate-querying-executing-tuples"> <title>Queries that return tuples</title> <para> @@ -367,9 +369,9 @@ .... }]]></programlisting> - </sect3> + </section> - <sect3 id="objectstate-querying-executing-scalar" revision="1"> + <section id="objectstate-querying-executing-scalar" revision="1"> <title>Scalar results</title> <para> @@ -392,9 +394,9 @@ ..... }]]></programlisting> - </sect3> + </section> - <sect3 id="objectstate-querying-executing-parameters"> + <section id="objectstate-querying-executing-parameters"> <title>Bind parameters</title> <para> @@ -442,9 +444,9 @@ q.setParameterList("namesList", names); List cats = q.list();]]></programlisting> - </sect3> + </section> - <sect3 id="objectstate-querying-executing-pagination"> + <section id="objectstate-querying-executing-pagination"> <title>Pagination</title> <para> @@ -463,9 +465,9 @@ SQL of your DBMS. </para> - </sect3> + </section> - <sect3 id="objectstate-querying-executing-scrolling"> + <section id="objectstate-querying-executing-scrolling"> <title>Scrollable iteration</title> <para> @@ -503,9 +505,9 @@ if you need offline pagination functionality. </para> - </sect3> + </section> - <sect3 id="objectstate-querying-executing-named" revision="1"> + <section id="objectstate-querying-executing-named" revision="1"> <title>Externalizing named queries</title> <para> @@ -543,11 +545,11 @@ <literal>eg.Cat.ByNameAndMaximumWeight</literal>. </para> - </sect3> + </section> - </sect2> + </section> - <sect2 id="objectstate-filtering" revision="1"> + <section id="objectstate-filtering" revision="1"> <title>Filtering collections</title> <para> A collection <emphasis>filter</emphasis> is a special type of query that can be applied to @@ -588,9 +590,9 @@ .setFirstResult(0).setMaxResults(10) .list();]]></programlisting> - </sect2> + </section> - <sect2 id="objecstate-querying-criteria" revision="1"> + <section id="objecstate-querying-criteria" revision="1"> <title>Criteria queries</title> <para> @@ -609,9 +611,9 @@ API are discussed in more detail in <xref linkend="querycriteria"/>. </para> - </sect2> + </section> - <sect2 id="objectstate-querying-nativesql" revision="2"> + <section id="objectstate-querying-nativesql" revision="2"> <title>Queries in native SQL</title> <para> @@ -639,11 +641,11 @@ <xref linkend="querysql"/>. </para> - </sect2> + </section> - </sect1> + </section> - <sect1 id="objectstate-modifying" revision="1"> + <section id="objectstate-modifying" revision="1"> <title>Modifying persistent objects</title> <para> @@ -682,9 +684,9 @@ </para> </important> - </sect1> + </section> - <sect1 id="objectstate-detached" revision="2"> + <section id="objectstate-detached" revision="2"> <title>Modifying detached objects</title> <para> @@ -757,9 +759,9 @@ Other models for long units of work are discussed in <xref linkend="transactions-optimistic"/>. </para> - </sect1> + </section> - <sect1 id="objectstate-saveorupdate"> + <section id="objectstate-saveorupdate"> <title>Automatic state detection</title> <para> @@ -895,9 +897,9 @@ </listitem> </itemizedlist> - </sect1> + </section> - <sect1 id="objectstate-deleting" revision="1"> + <section id="objectstate-deleting" revision="1"> <title>Deleting persistent objects</title> <para> @@ -917,9 +919,9 @@ children. </para> - </sect1> + </section> - <sect1 id="objectstate-replicating" revision="1"> + <section id="objectstate-replicating" revision="1"> <title>Replicating object between two different datastores</title> <para> @@ -981,9 +983,9 @@ rolling back changes made during non-ACID transactions and more. </para> - </sect1> + </section> - <sect1 id="objectstate-flushing"> + <section id="objectstate-flushing"> <title>Flushing the Session</title> <para> @@ -1094,9 +1096,9 @@ behavior, we discuss it in <xref linkend="transactions"/>. </para> - </sect1> + </section> - <sect1 id="objectstate-transitive" revision="1"> + <section id="objectstate-transitive" revision="1"> <title>Transitive persistence</title> <para> @@ -1248,9 +1250,9 @@ <literal>Session</literal>. </para> - </sect1> + </section> - <sect1 id="objectstate-metadata"> + <section id="objectstate-metadata"> <title>Using metadata</title> <para> @@ -1282,7 +1284,7 @@ } }]]></programlisting> - </sect1> + </section> </chapter> Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/toolset_guide.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/toolset_guide.xml 2010-02-08 04:15:14 UTC (rev 18714) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/toolset_guide.xml 2010-02-08 04:24:37 UTC (rev 18715) @@ -1,4 +1,8 @@ -<?xml version='1.0' encoding="UTF-8"?> +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Hibernate_Core_Reference_Guide.ent"> +%BOOK_ENTITIES; +]>  -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> - <chapter id="toolsetguide" revision="2"> <title>Toolset Guide</title> @@ -75,7 +77,7 @@ be used from "inside" Hibernate. </para> - <sect1 id="toolsetguide-s1" revision="2"> + <section id="toolsetguide-s1" revision="2"> <title>Automatic schema generation</title> <para> @@ -95,7 +97,7 @@ First, you must customize your mapping files to improve the generated schema. The next section covers schema customization. </para> - <sect2 id="toolsetguide-s1-2" revision="3"> + <section id="toolsetguide-s1-2" revision="3"> <title>Customizing the schema</title> <para> @@ -203,80 +205,80 @@ <colspec colwidth="2.5*"/> <thead> <row> - <entry>Attribute</entry> - <entry>Values</entry> - <entry>Interpretation</entry> + <entry><para>Attribute</para></entry> + <entry><para>Values</para></entry> + <entry><para>Interpretation</para></entry> </row> </thead> <tbody> <row> - <entry><literal>length</literal></entry> - <entry>number</entry> - <entry>column length</entry> + <entry><para><literal>length</literal></para></entry> + <entry><para>number</para></entry> + <entry><para>column length</para></entry> </row> <row> - <entry><literal>precision</literal></entry> - <entry>number</entry> - <entry>column decimal precision</entry> + <entry><para><literal>precision</literal></para></entry> + <entry><para>number</para></entry> + <entry><para>column decimal precision</para></entry> </row> <row> - <entry><literal>scale</literal></entry> - <entry>number</entry> - <entry>column decimal scale</entry> + <entry><para><literal>scale</literal></para></entry> + <entry><para>number</para></entry> + <entry><para>column decimal scale</para></entry> </row> <row> - <entry><literal>not-null</literal></entry> - <entry><literal>true|false</literal></entry> - <entry>specifies that the column should be non-nullable</entry> + <entry><para><literal>not-null</literal></para></entry> + <entry><para><literal>true|false</literal></para></entry> + <entry><para>specifies that the column should be non-nullable</para></entry> </row> <row> - <entry><literal>unique</literal></entry> - <entry><literal>true|false</literal></entry> - <entry>specifies that the column should have a unique constraint</entry> + <entry><para><literal>unique</literal></para></entry> + <entry><para><literal>true|false</literal></para></entry> + <entry><para>specifies that the column should have a unique constraint</para></entry> </row> <row> - <entry><literal>index</literal></entry> - <entry><literal>index_name</literal></entry> - <entry>specifies the name of a (multi-column) index</entry> + <entry><para><literal>index</literal></para></entry> + <entry><para><literal>index_name</literal></para></entry> + <entry><para>specifies the name of a (multi-column) index</para></entry> </row> <row> - <entry><literal>unique-key</literal></entry> - <entry><literal>unique_key_name</literal></entry> - <entry>specifies the name of a multi-column unique constraint</entry> + <entry><para><literal>unique-key</literal></para></entry> + <entry><para><literal>unique_key_name</literal></para></entry> + <entry><para>specifies the name of a multi-column unique constraint</para></entry> </row> <row> - <entry><literal>foreign-key</literal></entry> - <entry><literal>foreign_key_name</literal></entry> - <entry> + <entry><para><literal>foreign-key</literal></para></entry> + <entry><para><literal>foreign_key_name</literal></para></entry> + <entry><para> specifies the name of the foreign key constraint generated for an association, for a <literal><one-to-one></literal>, <literal><many-to-one></literal>, <literal><key></literal>, or <literal><many-to-many></literal> mapping element. Note that <literal>inverse="true"</literal> sides will not be considered by <literal>SchemaExport</literal>. - </entry> + </para></entry> </row> <row> - <entry><literal>sql-type</literal></entry> - <entry><literal>SQL column type</literal></entry> - <entry> + <entry><para><literal>sql-type</literal></para></entry> + <entry><para><literal>SQL column type</literal></para></entry> + <entry><para> overrides the default column type (attribute of <literal><column></literal> element only) - </entry> + </para></entry> </row> <row> - <entry><literal>default</literal></entry> - <entry>SQL expression</entry> - <entry> + <entry><para><literal>default</literal></para></entry> + <entry><para>SQL expression</para></entry> + <entry><para> specify a default value for the column - </entry> + </para></entry> </row> <row> - <entry><literal>check</literal></entry> - <entry>SQL expression</entry> - <entry> + <entry><para><literal>check</literal></para></entry> + <entry><para>SQL expression</para></entry> + <entry><para> create an SQL check constraint on either column or table - </entry> + </para></entry> </row> </tbody> </tgroup> @@ -304,9 +306,9 @@ DDL where supported. </para> - </sect2> + </section> - <sect2 id="toolsetguide-s1-3" revision="2"> + <section id="toolsetguide-s1-3" revision="2"> <title>Running the tool</title> <para> @@ -328,50 +330,50 @@ <colspec colwidth="2*"/> <thead> <row> - <entry>Option</entry> - <entry>Description</entry> + <entry><para>Option</para></entry> + <entry><para>Description</para></entry> </row> </thead> <tbody> <row> - <entry><literal>--quiet</literal></entry> - <entry>do not output the script to stdout</entry> + <entry><para><literal>--quiet</literal></para></entry> + <entry><para>do not output the script to stdout</para></entry> </row> <row> - <entry><literal>--drop</literal></entry> - <entry>only drop the tables</entry> + <entry><para><literal>--drop</literal></para></entry> + <entry><para>only drop the tables</para></entry> </row> <row> - <entry><literal>--create</literal></entry> - <entry>only create the tables</entry> + <entry><para><literal>--create</literal></para></entry> + <entry><para>only create the tables</para></entry> </row> <row> - <entry><literal>--text</literal></entry> - <entry>do not export to the database</entry> + <entry><para><literal>--text</literal></para></entry> + <entry><para>do not export to the database</para></entry> </row> <row> - <entry><literal>--output=my_schema.ddl</literal></entry> - <entry>output the ddl script to a file</entry> + <entry><para><literal>--output=my_schema.ddl</literal></para></entry> + <entry><para>output the ddl script to a file</para></entry> </row> <row> - <entry><literal>--naming=eg.MyNamingStrategy</literal></entry> - <entry>select a <literal>NamingStrategy</literal></entry> + <entry><para><literal>--naming=eg.MyNamingStrategy</literal></para></entry> + <entry><para>select a <literal>NamingStrategy</literal></para></entry> </row> <row> - <entry><literal>--config=hibernate.cfg.xml</literal></entry> - <entry>read Hibernate configuration from an XML file</entry> + <entry><para><literal>--config=hibernate.cfg.xml</literal></para></entry> + <entry><para>read Hibernate configuration from an XML file</para></entry> </row> <row> - <entry><literal>--properties=hibernate.properties</literal></entry> - <entry>read database properties from a file</entry> + <entry><para><literal>--properties=hibernate.properties</literal></para></entry> + <entry><para>read database properties from a file</para></entry> </row> <row> - <entry><literal>--format</literal></entry> - <entry>format the generated SQL nicely in the script</entry> + <entry><para><literal>--format</literal></para></entry> + <entry><para>format the generated SQL nicely in the script</para></entry> </row> <row> - <entry><literal>--delimiter=;</literal></entry> - <entry>set an end of line delimiter for the script</entry> + <entry><para><literal>--delimiter=;</literal></para></entry> + <entry><para>set an end of line delimiter for the script</para></entry> </row> </tbody> </tgroup> @@ -384,9 +386,9 @@ <programlisting><![CDATA[Configuration cfg = ....; new SchemaExport(cfg).create(false, true);]]></programlisting> - </sect2> + </section> - <sect2 id="toolsetguide-s1-4"> + <section id="toolsetguide-s1-4"> <title>Properties</title> <para> @@ -416,38 +418,38 @@ <colspec colwidth="2*"/> <thead> <row> - <entry>Property Name</entry> - <entry>Description</entry> + <entry><para>Property Name</para></entry> + <entry><para>Description</para></entry> </row> </thead> <tbody> <row> - <entry><literal>hibernate.connection.driver_class</literal></entry> - <entry>jdbc driver class</entry> + <entry><para><literal>hibernate.connection.driver_class</literal></para></entry> + <entry><para>jdbc driver class</para></entry> </row> <row> - <entry><literal>hibernate.connection.url</literal></entry> - <entry>jdbc url</entry> + <entry><para><literal>hibernate.connection.url</literal></para></entry> + <entry><para>jdbc url</para></entry> </row> <row> - <entry><literal>hibernate.connection.username</literal></entry> - <entry>database user</entry> + <entry><para><literal>hibernate.connection.username</literal></para></entry> + <entry><para>database user</para></entry> </row> <row> - <entry><literal>hibernate.connection.password</literal></entry> - <entry>user password</entry> + <entry><para><literal>hibernate.connection.password</literal></para></entry> + <entry><para>user password</para></entry> </row> <row> - <entry><literal>hibernate.dialect</literal></entry> - <entry>dialect</entry> + <entry><para><literal>hibernate.dialect</literal></para></entry> + <entry><para>dialect</para></entry> </row> </tbody> </tgroup> </table> - </sect2> + </section> - <sect2 id="toolsetguide-s1-5"> + <section id="toolsetguide-s1-5"> <title>Using Ant</title> <para> @@ -472,9 +474,9 @@ </schemaexport> </target>]]></programlisting> - </sect2> + </section> - <sect2 id="toolsetguide-s1-6" revision="2"> + <section id="toolsetguide-s1-6" revision="2"> <title>Incremental schema updates</title> <para> @@ -495,30 +497,30 @@ <colspec colwidth="2*"/> <thead> <row> - <entry>Option</entry> - <entry>Description</entry> + <entry><para>Option</para></entry> + <entry><para>Description</para></entry> </row> </thead> <tbody> <row> - <entry><literal>--quiet</literal></entry> - <entry>do not output the script to stdout</entry> + <entry><para><literal>--quiet</literal></para></entry> + <entry><para>do not output the script to stdout</para></entry> </row> <row> - <entry><literal>--text</literal></entry> - <entry>do not export the script to the database</entry> + <entry><para><literal>--text</literal></para></entry> + <entry><para>do not export the script to the database</para></entry> </row> <row> - <entry><literal>--naming=eg.MyNamingStrategy</literal></entry> - <entry>select a <literal>NamingStrategy</literal></entry> + <entry><para><literal>--naming=eg.MyNamingStrategy</literal></para></entry> + <entry><para>select a <literal>NamingStrategy</literal></para></entry> </row> <row> - <entry><literal>--properties=hibernate.properties</literal></entry> - <entry>read database properties from a file</entry> + <entry><para><literal>--properties=hibernate.properties</literal></para></entry> + <entry><para>read database properties from a file</para></entry> </row> <row> - <entry><literal>--config=hibernate.cfg.xml</literal></entry> - <entry>specify a <literal>.cfg.xml</literal> file</entry> + <entry><para><literal>--config=hibernate.cfg.xml</literal></para></entry> + <entry><para>specify a <literal>.cfg.xml</literal> file</para></entry> </row> </tbody> </tgroup> @@ -531,9 +533,9 @@ <programlisting><![CDATA[Configuration cfg = ....; new SchemaUpdate(cfg).execute(false);]]></programlisting> - </sect2> + </section> - <sect2 id="toolsetguide-s1-7"> + <section id="toolsetguide-s1-7"> <title>Using Ant for incremental schema updates</title> <para> @@ -554,9 +556,9 @@ </schemaupdate> </target>]]></programlisting> - </sect2> + </section> - <sect2 id="toolsetguide-s1-8" revision="1"> + <section id="toolsetguide-s1-8" revision="1"> <title>Schema validation</title> <para> @@ -569,7 +571,7 @@ <literal>java -cp </literal><emphasis>hibernate_classpaths</emphasis> <literal>org.hibernate.tool.hbm2ddl.SchemaValidator</literal> <emphasis>options mapping_files</emphasis> </para> - +<para>The following table displays the <literal>SchemaValidator</literal> command line options: </para> <table frame="topbot"> <title><literal>SchemaValidator</literal> Command Line Options</title> <tgroup cols="2"> @@ -577,22 +579,22 @@ <colspec colwidth="2*"/> <thead> <row> - <entry>Option</entry> - <entry>Description</entry> + <entry><para>Option</para></entry> + <entry><para>Description</para></entry> </row> </thead> <tbody> <row> - <entry><literal>--naming=eg.MyNamingStrategy</literal></entry> - <entry>select a <literal>NamingStrategy</literal></entry> + <entry><para><literal>--naming=eg.MyNamingStrategy</literal></para></entry> + <entry><para>select a <literal>NamingStrategy</literal></para></entry> </row> <row> - <entry><literal>--properties=hibernate.properties</literal></entry> - <entry>read database properties from a file</entry> + <entry><para><literal>--properties=hibernate.properties</literal></para></entry> + <entry><para>read database properties from a file</para></entry> </row> <row> - <entry><literal>--config=hibernate.cfg.xml</literal></entry> - <entry>specify a <literal>.cfg.xml</literal> file</entry> + <entry><para><literal>--config=hibernate.cfg.xml</literal></para></entry> + <entry><para>specify a <literal>.cfg.xml</literal> file</para></entry> </row> </tbody> </tgroup> @@ -605,9 +607,9 @@ <programlisting><![CDATA[Configuration cfg = ....; new SchemaValidator(cfg).validate();]]></programlisting> - </sect2> + </section> - <sect2 id="toolsetguide-s1-9"> + <section id="toolsetguide-s1-9"> <title>Using Ant for schema validation</title> <para> @@ -627,9 +629,9 @@ </schemavalidator> </target>]]></programlisting> - </sect2> + </section> - </sect1> + </section> </chapter> Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/transactions.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/transactions.xml 2010-02-08 04:15:14 UTC (rev 18714) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/transactions.xml 2010-02-08 04:24:37 UTC (rev 18715) @@ -1,4 +1,8 @@ -<?xml version='1.0' encoding="UTF-8"?> +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Hibernate_Core_Reference_Guide.ent"> +%BOOK_ENTITIES; +]>  -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> - <chapter id="transactions" revision="2"> <title>Transactions and Concurrency</title> @@ -56,7 +58,7 @@ <literal>Session</literal>, as well as database transactions and long conversations. </para> - <sect1 id="transactions-basics" revision="1"> + <section id="transactions-basics" revision="1"> <title>Session and transaction scopes</title> <para> @@ -88,7 +90,7 @@ database transaction boundaries? These questions are addressed in the following sections. </para> - <sect2 id="transactions-basics-uow" revision="1"> + <section id="transactions-basics-uow" revision="1"> <title>Unit of work</title> <para> @@ -167,9 +169,9 @@ this <emphasis>Open Session in View</emphasis> pattern. </para> - </sect2> + </section> - <sect2 id="transactions-basics-apptx" revision="1"> + <section id="transactions-basics-apptx" revision="1"> <title>Long conversations</title> <para> @@ -261,9 +263,9 @@ These disadvantages are discussed later in this chapter in the context of optimistic concurrency control. </para> - </sect2> + </section> - <sect2 id="transactions-basics-identity"> + <section id="transactions-basics-identity"> <title>Considering object identity</title> <para> @@ -328,9 +330,9 @@ a Hibernate issue, but simply how Java object identity and equality has to be implemented. </para> - </sect2> + </section> - <sect2 id="transactions-basics-issues"> + <section id="transactions-basics-issues"> <title>Common issues</title> <para> @@ -378,11 +380,11 @@ </listitem> </itemizedlist> - </sect2> + </section> - </sect1> + </section> - <sect1 id="transactions-demarcation"> + <section id="transactions-demarcation"> <title>Database transaction demarcation</title> <para> @@ -447,7 +449,7 @@ </para> - <sect2 id="transactions-demarcation-nonmanaged" revision="2"> + <section id="transactions-demarcation-nonmanaged" revision="2"> <title>Non-managed environment</title> <para> @@ -479,7 +481,7 @@ <para> You do not have to <literal>flush()</literal> the <literal>Session</literal> explicitly: the call to <literal>commit()</literal> automatically triggers the synchronization depending - on the <link linkend="objectstate-flushing">FlushMode</link> for the session. + on the FlushMode for the session (see <xref linkend="objectstate-flushing" />). A call to <literal>close()</literal> marks the end of a session. The main implication of <literal>close()</literal> is that the JDBC connection will be relinquished by the session. This Java code is portable and runs in both non-managed and JTA environments. @@ -520,9 +522,9 @@ <literal>hibernate.current_session_context_class</literal>. </para> - </sect2> + </section> - <sect2 id="transactions-demarcation-jta" revision="3"> + <section id="transactions-demarcation-jta" revision="3"> <title>Using JTA</title> <para> @@ -623,9 +625,9 @@ <literal>iterate()</literal> from the JTA or CMT code.) </para> - </sect2> + </section> - <sect2 id="transactions-demarcation-exceptions"> + <section id="transactions-demarcation-exceptions"> <title>Exception handling</title> <para> @@ -698,9 +700,9 @@ </listitem> </itemizedlist> - </sect2> + </section> - <sect2 id="transactions-demarcation-timeout"> + <section id="transactions-demarcation-timeout"> <title>Transaction timeout</title> <para> @@ -741,11 +743,11 @@ where transaction timeouts must be defined declaratively. </para> - </sect2> + </section> - </sect1> + </section> - <sect1 id="transactions-optimistic"> + <section id="transactions-optimistic"> <title>Optimistic concurrency control</title> <para> @@ -758,7 +760,7 @@ also has the benefit of preventing lost updates in single database transactions. </para> - <sect2 id="transactions-optimistic-manual"> + <section id="transactions-optimistic-manual"> <title>Application version checking</title> <para> @@ -805,9 +807,9 @@ as the design paradigm. </para> - </sect2> + </section> - <sect2 id="transactions-optimistic-longsession"> + <section id="transactions-optimistic-longsession"> <title>Extended session and automatic versioning</title> <para> @@ -883,9 +885,9 @@ for this. See the Hibernate Wiki for examples. </para> - </sect2> + </section> - <sect2 id="transactions-optimistic-detached"> + <section id="transactions-optimistic-detached"> <title>Detached objects and automatic versioning</title> <para> @@ -915,9 +917,9 @@ caches) if you are sure that the object has not been modified. </para> - </sect2> + </section> - <sect2 id="transactions-optimistic-customizing"> + <section id="transactions-optimistic-customizing"> <title>Customizing automatic versioning</title> <para> @@ -958,11 +960,11 @@ the instance to ensure that changes did occur before updating the row. </para> - </sect2> + </section> - </sect1> + </section> - <sect1 id="transactions-locking"> + <section id="transactions-locking"> <title>Pessimistic locking</title> <para> @@ -1062,9 +1064,9 @@ portable. </para> - </sect1> + </section> - <sect1 id="transactions-connection-release"> + <section id="transactions-connection-release"> <title>Connection release modes</title> <para> @@ -1147,7 +1149,7 @@ </listitem> </itemizedlist> - </sect1> + </section> </chapter> Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/tutorial.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/tutorial.xml 2010-02-08 04:15:14 UTC (rev 18714) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/tutorial.xml 2010-02-08 04:24:37 UTC (rev 18715) @@ -1,4 +1,8 @@ -<?xml version='1.0' encoding="UTF-8"?> +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Hibernate_Core_Reference_Guide.ent"> +%BOOK_ENTITIES; +]>  -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ + <chapter id="tutorial"> <title>Tutorial</title> @@ -55,7 +64,7 @@ </para> </note> - <sect1 id="tutorial-firstapp"> + <section id="tutorial-firstapp"> <title>Part 1 - The first Hibernate Application</title> <para> @@ -72,7 +81,7 @@ </para> </note> - <sect2 id="tutorial-firstapp-setup"> + <section id="tutorial-firstapp-setup"> <title>Setup</title> <para> @@ -134,15 +143,15 @@ </project>]]></programlisting> - <tip> + <note> <para> - It is not a requirement to use Maven. If you wish to use something else to - build this tutoial (such as Ant), the layout will remain the same. The only + It is not a requirement to use Maven. If you wish to use another technology to + build this tutorial (such as Ant), the layout will remain the same. The only change is that you will need to manually account for all the needed - dependencies. If you use something like <ulink url="http://ant.apache.org/ivy/">Ivy</ulink> - providing transitive dependency management you would still use the dependencies - mentioned below. Otherwise, you'd need to grab <emphasis>all</emphasis> - dependencies, both explicit and transitive, and add them to the project's + dependencies. If you use <ulink url="http://ant.apache.org/ivy/">Ivy</ulink> + to provide transitive dependency management you would still use the dependencies + mentioned below. Otherwise, you will need to find all the + dependencies, both explicit and transitive, and add them to the projects classpath. If working from the Hibernate distribution bundle, this would mean <filename>hibernate3.jar</filename>, all artifacts in the <filename>lib/required</filename> directory and all files from either the @@ -150,15 +159,15 @@ directory; additionally you will need both the servlet-api jar and one of the slf4j logging backends. </para> - </tip> + </note> <para> Save this file as <filename>pom.xml</filename> in the project root directory. </para> - </sect2> + </section> - <sect2 id="tutorial-firstapp-firstclass"> + <section id="tutorial-firstapp-firstclass"> <title>The first class</title> <para> @@ -238,9 +247,9 @@ Save this file to the <filename>src/main/java/org/hibernate/tutorial/domain</filename> directory. </para> - </sect2> + </section> - <sect2 id="tutorial-firstapp-mapping"> + <section id="tutorial-firstapp-mapping"> <title>The mapping file</title> <para> @@ -339,12 +348,12 @@ and you can plugin in your own strategy. </para> - <tip> + <note> <para> - <literal>native</literal> is no longer consider the best strategy in terms of portability. for further + <literal>native</literal> is no longer considered the best strategy in terms of portability. for further discussion, see <xref linkend="portability-idgen"/> </para> - </tip> + </note> <para> Lastly, we need to tell Hibernate about the remaining entity class @@ -401,22 +410,22 @@ <literal>timestamp</literal> converter. </para> - <tip> + <note> <para> Hibernate makes this mapping type determination using reflection when the mapping files are processed. This can take time and resources, so if startup performance is important you should consider explicitly defining the type to use. </para> - </tip> + </note> <para> Save this mapping file as <filename>src/main/resources/org/hibernate/tutorial/domain/Event.hbm.xml</filename>. </para> - </sect2> + </section> - <sect2 id="tutorial-firstapp-configuration" revision="2"> + <section id="tutorial-firstapp-configuration" revision="2"> <title>Hibernate configuration</title> <para> @@ -427,7 +436,7 @@ <note> <para> - We do this do that the data remains between runs. + We do this so that the data remains between runs. </para> </note> @@ -452,12 +461,11 @@ Hibernate built-in connection pool for this tutorial. </para> - <caution> + <warning> <para> - The built-in Hibernate connection pool is in no way intended for production use. It - lacks several features found on any decent connection pool. + The built-in Hibernate connection pool is not intended for production use. </para> - </caution> + </warning> <para> For Hibernate's configuration, we can use a simple <literal>hibernate.properties</literal> file, a @@ -521,12 +529,12 @@ element specifies the particular SQL variant Hibernate generates. </para> - <tip> + <note> <para> - In most cases, Hibernate is able to properly determine which dialect to use. See + Hibernate is able to correctly determine which dialect to use in most cases. See <xref linkend="portability-dialectresolver"/> for more information. </para> - </tip> + </note> <para> Hibernate's automatic session management for persistence contexts is particularly useful @@ -542,9 +550,9 @@ <filename>src/main/resources</filename> directory. </para> - </sect2> + </section> - <sect2 id="tutorial-firstapp-mvn" revision="1"> + <section id="tutorial-firstapp-mvn" revision="1"> <title>Building with Maven</title> <para> @@ -575,9 +583,9 @@ [INFO] Final Memory: 5M/547M [INFO] ------------------------------------------------------------------------]]></programlisting> - </sect2> + </section> - <sect2 id="tutorial-firstapp-helpers" revision="3"> + <section id="tutorial-firstapp-helpers" revision="3"> <title>Startup and helpers</title> <para> @@ -665,9 +673,9 @@ Hibernate. </para> - </sect2> + </section> - <sect2 id="tutorial-firstapp-workingpersistence" revision="5"> + <section id="tutorial-firstapp-workingpersistence" revision="5"> <title>Loading and storing objects</title> <para> @@ -855,11 +863,11 @@ <command>mvn exec:java -Dexec.mainClass="org.hibernate.tutorial.EventManager" -Dexec.args="list"</command> </para> - </sect2> + </section> - </sect1> + </section> - <sect1 id="tutorial-associations"> + <section id="tutorial-associations"> <title>Part 2 - Mapping associations</title> <para> @@ -869,7 +877,7 @@ which they participate. </para> - <sect2 id="tutorial-associations-mappinguser" revision="1"> + <section id="tutorial-associations-mappinguser" revision="1"> <title>Mapping the Person class</title> <para> @@ -928,9 +936,9 @@ behavior. </para> - </sect2> + </section> - <sect2 id="tutorial-associations-unidirset" revision="3"> + <section id="tutorial-associations-unidirset" revision="3"> <title>A unidirectional Set-based association</title> <para> @@ -1019,9 +1027,9 @@ |_____________| ]]></programlisting> - </sect2> + </section> - <sect2 id="tutorial-associations-working" revision="2"> + <section id="tutorial-associations-working" revision="2"> <title>Working the association</title> <para> @@ -1140,9 +1148,9 @@ entities, but looks almost the same in Java. </para> - </sect2> + </section> - <sect2 id="tutorial-associations-valuecollections"> + <section id="tutorial-associations-valuecollections"> <title>Collection of values</title> <para> @@ -1232,9 +1240,9 @@ optimize this with an eager fetch. </para> - </sect2> + </section> - <sect2 id="tutorial-associations-bidirectional" revision="1"> + <section id="tutorial-associations-bidirectional" revision="1"> <title>Bi-directional associations</title> <para> @@ -1291,9 +1299,9 @@ understand once you see how the bi-directional link between our two entities is created. </para> - </sect2> + </section> - <sect2 id="tutorial-associations-usingbidir"> + <section id="tutorial-associations-usingbidir"> <title>Working bi-directional links</title> <para> @@ -1347,11 +1355,11 @@ and in many-to-many association you can select either side. </para> - </sect2> + </section> - </sect1> + </section> - <sect1 id="tutorial-webapp"> + <section id="tutorial-webapp"> <title>Part 3 - The EventManager web application</title> <para> @@ -1361,7 +1369,7 @@ database, and it provides an HTML form to enter new events. </para> - <sect2 id="tutorial-webapp-servlet" revision="2"> + <section id="tutorial-webapp-servlet" revision="2"> <title>Writing the basic servlet</title> <para> @@ -1441,9 +1449,9 @@ as you consider rendering your view in JSP, not in a servlet. </para> - </sect2> + </section> - <sect2 id="tutorial-webapp-processing" revision="1"> + <section id="tutorial-webapp-processing" revision="1"> <title>Processing and rendering</title> <para> @@ -1551,9 +1559,9 @@ examples. </para> - </sect2> + </section> - <sect2 id="tutorial-webapp-deploy"> + <section id="tutorial-webapp-deploy"> <title>Deploying and testing</title> <para> @@ -1602,11 +1610,11 @@ is called) and to get the detailed output if any exceptions occurs. </para> - </sect2> + </section> - </sect1> + </section> - <sect1 id="tutorial-summary" revision="1"> + <section id="tutorial-summary" revision="1"> <title>Summary</title> <para> @@ -1615,6 +1623,6 @@ <ulink url="http://hibernate.org">website</ulink>. </para> - </sect1> + </section> </chapter> Modified: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/xml.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/xml.xml 2010-02-08 04:15:14 UTC (rev 18714) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/xml.xml 2010-02-08 04:24:37 UTC (rev 18715) @@ -1,4 +1,8 @@ -<?xml version='1.0' encoding="UTF-8"?> +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "../Hibernate_Core_Reference_Guide.ent"> +%BOOK_ENTITIES; +]>  -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> - <chapter id="xml"> <title>XML Mapping</title> @@ -33,7 +35,7 @@ active development. </emphasis></para> - <sect1 id="xml-intro" revision="1"> + <section id="xml-intro" revision="1"> <title>Working with XML data</title> <para> @@ -64,7 +66,7 @@ it can be used to map just the XML. </para> - <sect2 id="xml-intro-mapping"> + <section id="xml-intro-mapping"> <title>Specifying XML and class mapping together</title> <para> @@ -91,9 +93,9 @@ ... </class>]]></programlisting> - </sect2> + </section> - <sect2 id="xml-onlyxml"> + <section id="xml-onlyxml"> <title>Specifying only an XML mapping</title> <para> @@ -130,11 +132,11 @@ are purely logical constructs that can be referred to in HQL queries. </para> - </sect2> + </section> - </sect1> + </section> - <sect1 id="xml-mapping" revision="1"> + <section id="xml-mapping" revision="1"> <title>XML mapping metadata</title> <para> @@ -256,10 +258,10 @@ ... </customer>]]></programlisting> - </sect1> + </section> - <sect1 id="xml-manipulation" revision="1"> + <section id="xml-manipulation" revision="1"> <title>Manipulating XML data</title> <para> @@ -307,7 +309,7 @@ operation. </para> - </sect1> + </section> </chapter>

15 years, 8 months

1
0
0 / 0

Hibernate SVN: r18714 - core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content.

by hibernate-commits＠lists.jboss.org

Author: stliu Date: 2010-02-07 23:15:14 -0500 (Sun, 07 Feb 2010) New Revision: 18714 Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/Preface.xml Removed: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/preface.xml Log: HHH-4792 Import work done by Red Hat translation team Copied: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/Preface.xml (from rev 18713, core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/preface.xml) =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/Preface.xml (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/Preface.xml 2010-02-08 04:15:14 UTC (rev 18714) @@ -0,0 +1,140 @@ +<?xml version='1.0' encoding="UTF-8"?> + + +<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> + +<preface id="preface"> + <title>Preface</title> + + <para> + Working with object-oriented software and a relational database can be cumbersome + and time consuming in today's enterprise environments. Hibernate is an Object/Relational + Mapping tool for Java environments. The term Object/Relational Mapping (ORM) refers to + the technique of mapping a data representation from an object model to a relational + data model with a SQL-based schema. + </para> + + <para> + Hibernate not only takes care of the mapping from Java classes to + database tables (and from Java data types to SQL data types), but also provides data + query and retrieval facilities. It can also significantly reduce development time otherwise + spent with manual data handling in SQL and JDBC. + </para> + + <para> + Hibernate's goal is to relieve the developer from 95 percent of common data persistence + related programming tasks. Hibernate may not be the best solution for data-centric + applications that only use stored-procedures to implement the business logic in the + database, it is most useful with object-oriented domain models and business logic in + the Java-based middle-tier. However, Hibernate can certainly help you to remove or + encapsulate vendor-specific SQL code and will help with the common task of result set + translation from a tabular representation to a graph of objects. + </para> + + <para> + If you are new to Hibernate and Object/Relational Mapping or even Java, + please follow these steps: + </para> + + <orderedlist> + <listitem> + <para> + Read <xref linkend="tutorial"/> for a tutorial with step-by-step + instructions. The source code for the tutorial is included in the + distribution in the <literal>doc/reference/tutorial/</literal> + directory. + </para> + </listitem> + <listitem> + <para> + Read <xref linkend="architecture"/> to understand the environments where + Hibernate can be used. + </para> + </listitem> + <listitem> + <para> + View the <literal>eg/</literal> directory in the Hibernate + distribution. It contains a simple standalone application. Copy your + JDBC driver to the <literal>lib/</literal> directory and edit + <literal>etc/hibernate.properties</literal>, specifying correct values for + your database. From a command prompt in the distribution directory, + type <literal>ant eg</literal> (using Ant), or under Windows, type + <literal>build eg</literal>. + </para> + </listitem> + <listitem> + <para> + Use this reference documentation as your primary source of + information. Consider reading <biblioref linkend="biblio-JPwH"/> + if you need more help with application design, or if you prefer + a step-by-step tutorial. Also visit + <ulink url="http://caveatemptor.hibernate.org"/> and download + the example application from <biblioref linkend="biblio-JPwH"/>. + </para> + </listitem> + <listitem> + <para> + FAQs are answered on the Hibernate website. + </para> + </listitem> + <listitem> + <para> + Links to third party demos, examples, and tutorials are maintained + on the Hibernate website. + </para> + </listitem> + <listitem> + <para> + The Community Area on the Hibernate website is a good resource for + design patterns and various integration solutions (Tomcat, JBoss AS, + Struts, EJB, etc.). + </para> + </listitem> + </orderedlist> + + <para> + If you have questions, use the user forum linked on the Hibernate website. We also + provide a JIRA issue tracking system for bug reports and feature requests. If you + are interested in the development of Hibernate, join the developer mailing list. If + you are interested in translating this documentation into your language, contact us + on the developer mailing list. + </para> + + <para> + Commercial development support, production support, and training for Hibernate is + available through JBoss Inc. (see http://www.hibernate.org/SupportTraining/). + Hibernate is a Professional Open Source project and a critical component of the + JBoss Enterprise Middleware System (JEMS) suite of products. + </para> + + <section> + <title>Feedback</title> + <para> + Use <ulink url="http://opensource.atlassian.com/projects/hibernate">Hibernate JIRA</ulink> + to report errors or request enhacements to this documentation. + </para> + </section> + +</preface> Deleted: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/preface.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/preface.xml 2010-02-08 04:10:11 UTC (rev 18713) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/content/preface.xml 2010-02-08 04:15:14 UTC (rev 18714) @@ -1,140 +0,0 @@ -<?xml version='1.0' encoding="UTF-8"?> - - -<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> - -<preface id="preface"> - <title>Preface</title> - - <para> - Working with object-oriented software and a relational database can be cumbersome - and time consuming in today's enterprise environments. Hibernate is an Object/Relational - Mapping tool for Java environments. The term Object/Relational Mapping (ORM) refers to - the technique of mapping a data representation from an object model to a relational - data model with a SQL-based schema. - </para> - - <para> - Hibernate not only takes care of the mapping from Java classes to - database tables (and from Java data types to SQL data types), but also provides data - query and retrieval facilities. It can also significantly reduce development time otherwise - spent with manual data handling in SQL and JDBC. - </para> - - <para> - Hibernate's goal is to relieve the developer from 95 percent of common data persistence - related programming tasks. Hibernate may not be the best solution for data-centric - applications that only use stored-procedures to implement the business logic in the - database, it is most useful with object-oriented domain models and business logic in - the Java-based middle-tier. However, Hibernate can certainly help you to remove or - encapsulate vendor-specific SQL code and will help with the common task of result set - translation from a tabular representation to a graph of objects. - </para> - - <para> - If you are new to Hibernate and Object/Relational Mapping or even Java, - please follow these steps: - </para> - - <orderedlist> - <listitem> - <para> - Read <xref linkend="tutorial"/> for a tutorial with step-by-step - instructions. The source code for the tutorial is included in the - distribution in the <literal>doc/reference/tutorial/</literal> - directory. - </para> - </listitem> - <listitem> - <para> - Read <xref linkend="architecture"/> to understand the environments where - Hibernate can be used. - </para> - </listitem> - <listitem> - <para> - View the <literal>eg/</literal> directory in the Hibernate - distribution. It contains a simple standalone application. Copy your - JDBC driver to the <literal>lib/</literal> directory and edit - <literal>etc/hibernate.properties</literal>, specifying correct values for - your database. From a command prompt in the distribution directory, - type <literal>ant eg</literal> (using Ant), or under Windows, type - <literal>build eg</literal>. - </para> - </listitem> - <listitem> - <para> - Use this reference documentation as your primary source of - information. Consider reading <biblioref linkend="biblio-JPwH"/> - if you need more help with application design, or if you prefer - a step-by-step tutorial. Also visit - <ulink url="http://caveatemptor.hibernate.org"/> and download - the example application from <biblioref linkend="biblio-JPwH"/>. - </para> - </listitem> - <listitem> - <para> - FAQs are answered on the Hibernate website. - </para> - </listitem> - <listitem> - <para> - Links to third party demos, examples, and tutorials are maintained - on the Hibernate website. - </para> - </listitem> - <listitem> - <para> - The Community Area on the Hibernate website is a good resource for - design patterns and various integration solutions (Tomcat, JBoss AS, - Struts, EJB, etc.). - </para> - </listitem> - </orderedlist> - - <para> - If you have questions, use the user forum linked on the Hibernate website. We also - provide a JIRA issue tracking system for bug reports and feature requests. If you - are interested in the development of Hibernate, join the developer mailing list. If - you are interested in translating this documentation into your language, contact us - on the developer mailing list. - </para> - - <para> - Commercial development support, production support, and training for Hibernate is - available through JBoss Inc. (see http://www.hibernate.org/SupportTraining/). - Hibernate is a Professional Open Source project and a critical component of the - JBoss Enterprise Middleware System (JEMS) suite of products. - </para> - - <section> - <title>Feedback</title> - <para> - Use <ulink url="http://opensource.atlassian.com/projects/hibernate">Hibernate JIRA</ulink> - to report errors or request enhacements to this documentation. - </para> - </section> - -</preface>

15 years, 8 months

1
0
0 / 0

Hibernate SVN: r18713 - in core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US: extras and 2 other directories.

by hibernate-commits＠lists.jboss.org

Author: stliu Date: 2010-02-07 23:10:11 -0500 (Sun, 07 Feb 2010) New Revision: 18713 Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/Author_Group.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/Book_Info.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/Feedback.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/Hibernate_Core_Reference_Guide.ent core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/Hibernate_Core_Reference_Guide.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/Revision_History.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/extras/ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/extras/namespacing.xml_sample core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/fallback_content/ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/fallback_content/Conventions.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/fallback_content/Feedback.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/fallback_content/Legal_Notice.xml Removed: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/Hibernate_Reference.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/author_group.xml core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/images/AuthorWork.zargo core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/images/CustomerOrderProduct.zargo core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/images/EmployerEmployee.zargo core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/images/hibernate_logo_a.png core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/legal_notice.xml Log: HHH-4729 Import work done by Red Hat translation team Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/Author_Group.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/Author_Group.xml (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/Author_Group.xml 2010-02-08 04:10:11 UTC (rev 18713) @@ -0,0 +1,12 @@ +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Hibernate_Annotations_Reference_Guide.ent"> +%BOOK_ENTITIES; +]> + +<authorgroup> +<author> + <firstname>The JBoss Community Group</firstname> + <surname></surname> + </author> +</authorgroup> Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/Book_Info.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/Book_Info.xml (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/Book_Info.xml 2010-02-08 04:10:11 UTC (rev 18713) @@ -0,0 +1,53 @@ +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Hibernate_Core_Reference_Guide.ent"> +%BOOK_ENTITIES; +]> + +<bookinfo id="Hibernate_Core_Reference_Guide"> + <title>Hibernate Core Reference Guide</title> + <subtitle>by Gavin King, Christian Bauer, Max Rydahl Andersen, Emmanuel Bernard, +and Steve Ebersole +and thanks to James Cobb (Graphic Design) and Cheyenne Weaver (Graphic +Design)</subtitle> + <edition>1.0</edition> + <pubsnumber>1</pubsnumber> + <productname>JBoss Hibernate Core</productname> + <productnumber></productnumber> + <pubdate>, 2009</pubdate> + <isbn>N/A</isbn> + <abstract><para>The JBoss Hibernate Core 3.3.2.GA Reference Guide</para> + </abstract> + <corpauthor> + <inlinemediaobject> + <imageobject> + <imagedata fileref="Common_Content/images/title_logo.svg" /> + </imageobject> + </inlinemediaobject> + </corpauthor> + <copyright> + <year>&YEAR;</year> + <holder>&HOLDER;</holder> + </copyright> + +  + +  +  + +  + +</bookinfo> Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/Feedback.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/Feedback.xml (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/Feedback.xml 2010-02-08 04:10:11 UTC (rev 18713) @@ -0,0 +1,13 @@ +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Hibernate_Core_Reference_Guide.ent"> +%BOOK_ENTITIES; +]> + +<section id="Feedback"> + <title>Feedback</title> + <para> + 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. + </para> +</section> + Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/Hibernate_Core_Reference_Guide.ent =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/Hibernate_Core_Reference_Guide.ent (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/Hibernate_Core_Reference_Guide.ent 2010-02-08 04:10:11 UTC (rev 18713) @@ -0,0 +1,6 @@ +<!ENTITY HOLDER "Red Hat, Inc"> +<!ENTITY YEAR "2009"> +<!ENTITY JBPAPP "JBoss Enterprise Application Platform"> +<!ENTITY VER "5.0"> +<!ENTITY semi ";"> + Copied: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/Hibernate_Core_Reference_Guide.xml (from rev 18712, core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/Hibernate_Reference.xml) =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/Hibernate_Core_Reference_Guide.xml (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/Hibernate_Core_Reference_Guide.xml 2010-02-08 04:10:11 UTC (rev 18713) @@ -0,0 +1,74 @@ +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE Book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Hibernate_Core_Reference_Guide.ent"> +%BOOK_ENTITIES; +]> + + +<book> + <xi:include href="Book_Info.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="content/Preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + + <xi:include href="content/tutorial.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + + <xi:include href="content/architecture.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + + <xi:include href="content/configuration.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + + <xi:include href="content/persistent_classes.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + + <xi:include href="content/basic_mapping.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="content/collection_mapping.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="content/association_mapping.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="content/component_mapping.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="content/inheritance_mapping.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + + <xi:include href="content/session_api.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="content/transactions.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="content/events.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="content/batch.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + + <xi:include href="content/query_hql.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="content/query_criteria.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="content/query_sql.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="content/filters.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="content/xml.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + + <xi:include href="content/performance.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + + <xi:include href="content/toolset_guide.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + + <xi:include href="content/example_parentchild.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="content/example_weblog.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="content/example_mappings.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + + <xi:include href="content/best_practices.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + + <xi:include href="content/portability.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + + <xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + +</book> + Deleted: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/Hibernate_Reference.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/Hibernate_Reference.xml 2010-02-07 19:27:19 UTC (rev 18712) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/Hibernate_Reference.xml 2010-02-08 04:10:11 UTC (rev 18713) @@ -1,100 +0,0 @@ -<?xml version='1.0' encoding="UTF-8"?> - -<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ - <!ENTITY version "WORKING"> - <!ENTITY today "TODAY"> - <!ENTITY copyrightYear "2004"> - <!ENTITY copyrightHolder "Red Hat Middleware, LLC."> -]> - -<book> - - <bookinfo> - <title>HIBERNATE - Relational Persistence for Idiomatic Java</title> - <subtitle>Hibernate Reference Documentation</subtitle> - <releaseinfo>&version;</releaseinfo> - <productnumber>&version;</productnumber> - <pubdate>&today;</pubdate> - <issuenum>1</issuenum> - <mediaobject> - <imageobject role="fo"> - <imagedata fileref="images/hibernate_logo_a.png" align="center" /> - </imageobject> - <imageobject role="html"> - <imagedata fileref="images/hibernate_logo_a.png" depth="3cm" /> - </imageobject> - </mediaobject> - <copyright> - <year>&copyrightYear;</year> - <holder>&copyrightHolder;</holder> - </copyright> - <xi:include href="legal_notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="author_group.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - </bookinfo> - - <toc/> - - <xi:include href="content/preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - - <xi:include href="content/tutorial.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - - <xi:include href="content/architecture.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - - <xi:include href="content/configuration.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - - <xi:include href="content/persistent_classes.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - - <xi:include href="content/basic_mapping.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="content/collection_mapping.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="content/association_mapping.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="content/component_mapping.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="content/inheritance_mapping.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - - <xi:include href="content/session_api.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="content/transactions.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="content/events.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="content/batch.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - - <xi:include href="content/query_hql.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="content/query_criteria.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="content/query_sql.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="content/filters.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="content/xml.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - - <xi:include href="content/performance.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - - <xi:include href="content/toolset_guide.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - - <xi:include href="content/example_parentchild.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="content/example_weblog.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="content/example_mappings.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - - <xi:include href="content/best_practices.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - - <xi:include href="content/portability.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - - <xi:include href="content/bibliography.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> -</book> - Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/Revision_History.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/Revision_History.xml (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/Revision_History.xml 2010-02-08 04:10:11 UTC (rev 18713) @@ -0,0 +1,38 @@ +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Hibernate_Core_Reference_Guide.ent"> +%BOOK_ENTITIES; +]> + +<appendix id="appe-Publican-Revision_History"> + <title>Revision History</title> + <simpara> + <revhistory> + <revision> + <revnumber>1.1</revnumber> + <date>Fri Dec 11 2009</date> + <author> + <firstname>Ben</firstname> + <surname>Clare</surname> + <email>bclare(a)redhat.com</email> + </author> + <author> + <firstname>Jared</firstname> + <surname>Morgan</surname> + <email>jmorgan(a)redhat.com</email> + </author> + <author> + <firstname>Richard</firstname> + <surname>Wilding</surname> + <email>rwilding(a)redhat.com</email> + </author> + <revdescription> + <simplelist> + <member>Merged with EAP5 and translations added</member> + </simplelist> + </revdescription> + </revision> + </revhistory> + </simpara> +</appendix> + Deleted: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/author_group.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/author_group.xml 2010-02-07 19:27:19 UTC (rev 18712) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/author_group.xml 2010-02-08 04:10:11 UTC (rev 18713) @@ -1,188 +0,0 @@ - -<!DOCTYPE authorgroup PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> - -<authorgroup> - <author> - <firstname>Gavin</firstname> - <surname>King</surname> - </author> - <author> - <firstname>Christian</firstname> - <surname>Bauer</surname> - </author> - <author> - <firstname>Max</firstname> - <othername>Rydahl</othername> - <surname>Andersen</surname> - </author> - <author> - <firstname>Emmanuel</firstname> - <surname>Bernard</surname> - </author> - <author> - <firstname>Steve</firstname> - <surname>Ebersole</surname> - </author> - - <othercredit> - <firstname>James</firstname> - <surname>Cobb</surname> - <affiliation> - <shortaffil>Graphic Design</shortaffil> - </affiliation> - </othercredit> - <othercredit> - <firstname>Cheyenne</firstname> - <surname>Weaver</surname> - <affiliation> - <shortaffil>Graphic Design</shortaffil> - </affiliation> - </othercredit> - -  - <othercredit class="translator" lang="es-ES"> - <othername><![CDATA[Bernardo Antonio Buffa Colom&#x00e9]]></othername> - <email>kreimer(a)bbs.frc.utn.edu.ar</email> - </othercredit> - -  - <othercredit class="translator" lang="fr-FR"> - <firstname>Vincent</firstname> - <surname>Ricard</surname> - </othercredit> - <othercredit class="translator" lang="fr-FR"> - <firstname>Sebastien</firstname> - <surname>Cesbron</surname> - </othercredit> - <othercredit class="translator" lang="fr-FR"> - <firstname>Michael</firstname> - <surname>Courcy</surname> - </othercredit> - <othercredit class="translator" lang="fr-FR"> - <firstname>Vincent</firstname> - <surname>Giguère</surname> - </othercredit> - <othercredit class="translator" lang="fr-FR"> - <firstname>Baptiste</firstname> - <surname>Mathus</surname> - </othercredit> - <othercredit class="translator" lang="fr-FR"> - <firstname>Emmanuel</firstname> - <surname>Bernard</surname> - </othercredit> - <othercredit class="translator" lang="fr-FR"> - <firstname>Anthony</firstname> - <surname>Patricio</surname> - </othercredit> - -  - <othercredit class="translator" lang="pt-BR"> - <firstname>Alvaro</firstname> - <surname>Netto</surname> - <email>alvaronetto(a)cetip.com.br</email> - </othercredit> - <othercredit class="translator" lang="pt-BR"> - <firstname>Anderson</firstname> - <surname>Braulio</surname> - <email>andersonbraulio(a)gmail.com</email> - </othercredit> - <othercredit class="translator" lang="pt-BR"> - <firstname>Daniel Vieira</firstname> - <surname>Costa</surname> - <email>danielvc(a)gmail.com</email> - </othercredit> - <othercredit class="translator" lang="pt-BR"> - <firstname>Francisco</firstname> - <surname>gamarra</surname> - <email>francisco.gamarra(a)gmail.com</email> - </othercredit> - <othercredit class="translator" lang="pt-BR"> - <firstname>Gamarra</firstname> - <email>mauricio.gamarra(a)gmail.com</email> - </othercredit> - <othercredit class="translator" lang="pt-BR"> - <firstname>Luiz Carlos</firstname> - <surname>Rodrigues</surname> - <email>luizcarlos_rodrigues(a)yahoo.com.br</email> - </othercredit> - <othercredit class="translator" lang="pt-BR"> - <firstname>Marcel</firstname> - <surname>Castelo</surname> - <email>marcel.castelo(a)gmail.com</email> - </othercredit> - <othercredit class="translator" lang="pt-BR"> - <firstname>Paulo</firstname> - <surname>César</surname> - <email>paulocol(a)gmail.com</email> - </othercredit> - <othercredit class="translator" lang="pt-BR"> - <firstname>Pablo L.</firstname> - <surname>de Miranda</surname> - <email>pablolmiranda(a)gmail.com</email> - </othercredit> - <othercredit class="translator" lang="pt-BR"> - <firstname>Renato</firstname> - <surname>Deggau</surname> - <email>rdeggau(a)gmail.com</email> - </othercredit> - <othercredit class="translator" lang="pt-BR"> - <firstname>Rogério</firstname> - <surname>Araújo</surname> - <email>rgildoaraujo(a)yahoo.com.br</email> - </othercredit> - <othercredit class="translator" lang="pt-BR"> - <firstname>Wanderson</firstname> - <surname>Siqueira</surname> - <email>wandersonxs(a)gmail.com</email> - </othercredit> - -  - <othercredit class="translator" lang="zh-CN"> - <firstname>Cao</firstname> - <surname>Xiaogang</surname> - <affiliation> - <orgname>RedSaga</orgname> - </affiliation> - <contrib>Translation Lead</contrib> - <email>caoxg(a)yahoo.com</email> - </othercredit> - -</authorgroup> Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/extras/namespacing.xml_sample =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/extras/namespacing.xml_sample (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/extras/namespacing.xml_sample 2010-02-08 04:10:11 UTC (rev 18713) @@ -0,0 +1,15 @@ +<?xml version="1.0"?> +<!DOCTYPE hibernate-mapping PUBLIC + "-//Hibernate/Hibernate Mapping DTD 3.0//EN" + "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd" [ + <!ENTITY types SYSTEM "classpath://your/domain/types.xml"> +]> + +<hibernate-mapping package="your.domain"> + <class name="MyEntity"> + <id name="id" type="my-custom-id-type"> + ... + </id> + <class> + &types; +</hibernate-mapping> Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/fallback_content/Conventions.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/fallback_content/Conventions.xml (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/fallback_content/Conventions.xml 2010-02-08 04:10:11 UTC (rev 18713) @@ -0,0 +1,165 @@ +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +]> +<section> + <title>Document Conventions</title> + <para> + This manual uses several conventions to highlight certain words and phrases and draw attention to specific pieces of information. + </para> + <para> + In PDF and paper editions, this manual uses typefaces drawn from the <ulink url="https://fedorahosted.org/liberation-fonts/">Liberation Fonts</ulink> set. The Liberation Fonts set is also used in HTML editions if the set is installed on your system. If not, alternative but equivalent typefaces are displayed. Note: Red Hat Enterprise Linux 5 and later includes the Liberation Fonts set by default. + </para> + <section> + <title>Typographic Conventions</title> + <para> + Four typographic conventions are used to call attention to specific words and phrases. These conventions, and the circumstances they apply to, are as follows. + </para> + <para> + <literal>Mono-spaced Bold</literal> + </para> + <para> + Used to highlight system input, including shell commands, file names and paths. Also used to highlight keycaps and key combinations. For example: + </para> + <blockquote> + <para> + To see the contents of the file <filename>my_next_bestselling_novel</filename> in your current working directory, enter the <command>cat my_next_bestselling_novel</command> command at the shell prompt and press <keycap>Enter</keycap> to execute the command. + </para> + </blockquote> + <para> + The above includes a file name, a shell command and a keycap, all presented in mono-spaced bold and all distinguishable thanks to context. + </para> + <para> + Key combinations can be distinguished from keycaps by the hyphen connecting each part of a key combination. For example: + </para> + <blockquote> + <para> + Press <keycap>Enter</keycap> to execute the command. + </para> + <para> + Press <keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>F1</keycap></keycombo> to switch to the first virtual terminal. Press <keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>F7</keycap></keycombo> to return to your X-Windows session. + </para> + </blockquote> + <para> + The first paragraph highlights the particular keycap to press. The second highlights two key combinations (each a set of three keycaps with each set pressed simultaneously). + </para> + <para> + If source code is discussed, class names, methods, functions, variable names and returned values mentioned within a paragraph will be presented as above, in <literal>mono-spaced bold</literal>. For example: + </para> + <blockquote> + <para> + File-related classes include <classname>filesystem</classname> for file systems, <classname>file</classname> for files, and <classname>dir</classname> for directories. Each class has its own associated set of permissions. + </para> + </blockquote> + <para> + <application>Proportional Bold</application> + </para> + <para> + This denotes words or phrases encountered on a system, including application names; dialog box text; labeled buttons; check-box and radio button labels; menu titles and sub-menu titles. For example: + </para> + <blockquote> + <para> + Choose <menuchoice><guimenu>System</guimenu><guisubmenu>Preferences</guisubmenu><guimenuitem>Mouse</guimenuitem></menuchoice> from the main menu bar to launch <application>Mouse Preferences</application>. In the <guilabel>Buttons</guilabel> tab, click the <guilabel>Left-handed mouse</guilabel> check box and click <guibutton>Close</guibutton> to switch the primary mouse button from the left to the right (making the mouse suitable for use in the left hand). + </para> + <para> + To insert a special character into a <application>gedit</application> file, choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Accessories</guisubmenu><guimenuitem>Character Map</guimenuitem></menuchoice> from the main menu bar. Next, choose <menuchoice><guimenu>Search</guimenu><guimenuitem>Find…</guimenuitem></menuchoice> from the <application>Character Map</application> menu bar, type the name of the character in the <guilabel>Search</guilabel> field and click <guibutton>Next</guibutton>. The character you sought will be highlighted in the <guilabel>Character Table</guilabel>. Double-click this highlighted character to place it in the <guilabel>Text to copy</guilabel> field and then click the <guibutton>Copy</guibutton> button. Now switch back to your document and choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Paste</guimenuitem></menuchoice> from the <application>gedit</application> menu bar. + </para> + </blockquote> + <para> + The above text includes application names; system-wide menu names and items; application-specific menu names; and buttons and text found within a GUI interface, all presented in proportional bold and all distinguishable by context. + </para> + <para> + <command><replaceable>Mono-spaced Bold Italic</replaceable></command> or <application><replaceable>Proportional Bold Italic</replaceable></application> + </para> + <para> + Whether mono-spaced bold or proportional bold, the addition of italics indicates replaceable or variable text. Italics denotes text you do not input literally or displayed text that changes depending on circumstance. For example: + </para> + <blockquote> + <para> + To connect to a remote machine using ssh, type <command>ssh <replaceable>username</replaceable>@<replaceable>domain.name</replaceable></command> at a shell prompt. If the remote machine is <filename>example.com</filename> and your username on that machine is john, type <command>ssh john(a)example.com</command>. + </para> + <para> + The <command>mount -o remount <replaceable>file-system</replaceable></command> command remounts the named file system. For example, to remount the <filename>/home</filename> file system, the command is <command>mount -o remount /home</command>. + </para> + <para> + To see the version of a currently installed package, use the <command>rpm -q <replaceable>package</replaceable></command> command. It will return a result as follows: <command><replaceable>package-version-release</replaceable></command>. + </para> + </blockquote> + <para> + Note the words in bold italics above — username, domain.name, file-system, package, version and release. Each word is a placeholder, either for text you enter when issuing a command or for text displayed by the system. + </para> + <para> + Aside from standard usage for presenting the title of a work, italics denotes the first use of a new and important term. For example: + </para> + <blockquote> + <para> + Publican is a <firstterm>DocBook</firstterm> publishing system. + </para> + </blockquote> + </section> + + <section> + <title>Pull-quote Conventions</title> + <para> + Terminal output and source code listings are set off visually from the surrounding text. + </para> + <para> + Output sent to a terminal is set in <computeroutput>mono-spaced roman</computeroutput> and presented thus: + </para> + +<screen>books Desktop documentation drafts mss photos stuff svn +books_tests Desktop1 downloads images notes scripts svgs +</screen> + <para> + Source-code listings are also set in <computeroutput>mono-spaced roman</computeroutput> but add syntax highlighting as follows: + </para> + +<programlisting language="Java">package org.jboss.book.jca.ex1; + +import javax.naming.InitialContext; + +public class ExClient +{ + public static void main(String args[]) + throws Exception + { + InitialContext iniCtx = new InitialContext(); + Object ref = iniCtx.lookup("EchoBean"); + EchoHome home = (EchoHome) ref; + Echo echo = home.create(); + + System.out.println("Created Echo"); + + System.out.println("Echo.echo('Hello') = " + echo.echo("Hello")); + } +} +</programlisting> + </section> + + <section> + <title>Notes and Warnings</title> + <para> + Finally, we use three visual styles to draw attention to information that might otherwise be overlooked. + </para> + <note> + <title>Note</title> + <para> + Notes are tips, shortcuts or alternative approaches to the task at hand. Ignoring a note should have no negative consequences, but you might miss out on a trick that makes your life easier. + </para> + </note> + <important> + <title>Important</title> + <para> + Important boxes detail things that are easily missed: configuration changes that only apply to the current session, or services that need restarting before an update will apply. Ignoring a box labeled 'Important' won't cause data loss but may cause irritation and frustration. + </para> + </important> + <warning> + <title>Warning</title> + <para> + Warnings should not be ignored. Ignoring warnings will most likely cause data loss. + </para> + </warning> + </section> + +</section> + + Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/fallback_content/Feedback.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/fallback_content/Feedback.xml (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/fallback_content/Feedback.xml 2010-02-08 04:10:11 UTC (rev 18713) @@ -0,0 +1,15 @@ +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +]> +<section> + <title>We Need Feedback!</title> + <indexterm> + <primary>feedback</primary> + <secondary>contact information for this manual</secondary> + </indexterm> + <para> + You should over ride this by creating your own local Feedback.xml file. + </para> +</section> + + Added: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/fallback_content/Legal_Notice.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/fallback_content/Legal_Notice.xml (rev 0) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/fallback_content/Legal_Notice.xml 2010-02-08 04:10:11 UTC (rev 18713) @@ -0,0 +1,9 @@ +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE legalnotice PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +]> +<legalnotice> + <para> + Copyright <trademark class="copyright"></trademark> &YEAR; &HOLDER; This material may only be distributed subject to the terms and conditions set forth in the GNU Free Documentation License (GFDL), V1.2 or later (the latest version is presently available at <ulink url="http://www.gnu.org/licenses/fdl.txt">http://www.gnu.org/licenses/fdl.txt</ulink>). + </para> +</legalnotice> + Deleted: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/images/AuthorWork.zargo =================================================================== (Binary files differ) Deleted: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/images/CustomerOrderProduct.zargo =================================================================== (Binary files differ) Deleted: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/images/EmployerEmployee.zargo =================================================================== (Binary files differ) Deleted: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/images/hibernate_logo_a.png =================================================================== (Binary files differ) Deleted: core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/legal_notice.xml =================================================================== --- core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/legal_notice.xml 2010-02-07 19:27:19 UTC (rev 18712) +++ core/branches/Branch_3_3/documentation/manual/src/main/docbook/en-US/legal_notice.xml 2010-02-08 04:10:11 UTC (rev 18713) @@ -1,57 +0,0 @@ -<?xml version='1.0' encoding="UTF-8"?> - -<!DOCTYPE legalnotice PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> - -<legalnotice id="Legal_Notice"> - <title>Legal Notice</title> - <para> - <address> - <street>1801 Varsity Drive</street> - <city>Raleigh</city>, <state>NC</state><postcode>27606-2072</postcode><country>USA</country> - <phone>Phone: +1 919 754 3700</phone> - <phone>Phone: 888 733 4281</phone> - <fax>Fax: +1 919 754 3701</fax> - <pob>PO Box 13588</pob><city>Research Triangle Park</city>, <state>NC</state><postcode>27709</postcode><country>USA</country> - </address> - </para> - <para> - Copyright <trademark class="copyright"/> 2007 by Red Hat, Inc. This copyrighted material is made available to - anyone wishing to use, modify, copy, or redistribute it subject to the terms and conditions of the - GNU <ulink url="http://www.gnu.org/licenses/lgpl-2.1.html">Lesser General Public License</ulink>, as published - by the Free Software Foundation. - </para> - <para> - Red Hat and the Red Hat "Shadow Man" logo are registered trademarks of Red Hat, Inc. in the United States and other countries. - </para> - <para> - All other trademarks referenced herein are the property of their respective owners. - </para> - <para> - The GPG fingerprint of the security(a)redhat.com key is: - </para> - <para> - CA 20 86 86 2B D6 9D FC 65 F6 EC C4 21 91 80 CD DB 42 A6 0E - </para> -</legalnotice>

15 years, 8 months

1
0
0 / 0

Hibernate SVN: r18712 - in core/trunk: core/src/main/java/org/hibernate/impl and 1 other directories.

by hibernate-commits＠lists.jboss.org

Author: steve.ebersole(a)jboss.com Date: 2010-02-07 14:27:19 -0500 (Sun, 07 Feb 2010) New Revision: 18712 Modified: core/trunk/core/src/main/java/org/hibernate/engine/SessionFactoryImplementor.java core/trunk/core/src/main/java/org/hibernate/impl/SessionFactoryImpl.java core/trunk/entitymanager/src/main/java/org/hibernate/ejb/EntityManagerFactoryImpl.java Log: HHH-4664 - Implement EntityManagerFactory#getProperties() Modified: core/trunk/core/src/main/java/org/hibernate/engine/SessionFactoryImplementor.java =================================================================== --- core/trunk/core/src/main/java/org/hibernate/engine/SessionFactoryImplementor.java 2010-02-06 13:59:15 UTC (rev 18711) +++ core/trunk/core/src/main/java/org/hibernate/engine/SessionFactoryImplementor.java 2010-02-07 19:27:19 UTC (rev 18712) @@ -25,6 +25,7 @@ package org.hibernate.engine; import java.util.Map; +import java.util.Properties; import java.util.Set; import java.sql.Connection; @@ -63,6 +64,13 @@ public interface SessionFactoryImplementor extends Mapping, SessionFactory { /** + * Get a copy of the Properties used to configure this session factory. + * + * @return The properties. + */ + public Properties getProperties(); + + /** * Get the persister for the named entity * * @param entityName The name of the entity for which to retrieve the persister. Modified: core/trunk/core/src/main/java/org/hibernate/impl/SessionFactoryImpl.java =================================================================== --- core/trunk/core/src/main/java/org/hibernate/impl/SessionFactoryImpl.java 2010-02-06 13:59:15 UTC (rev 18711) +++ core/trunk/core/src/main/java/org/hibernate/impl/SessionFactoryImpl.java 2010-02-07 19:27:19 UTC (rev 18712) @@ -467,6 +467,10 @@ this.observer.sessionFactoryCreated( this ); } + public Properties getProperties() { + return properties; + } + public IdentifierGeneratorFactory getIdentifierGeneratorFactory() { return null; } Modified: core/trunk/entitymanager/src/main/java/org/hibernate/ejb/EntityManagerFactoryImpl.java =================================================================== --- core/trunk/entitymanager/src/main/java/org/hibernate/ejb/EntityManagerFactoryImpl.java 2010-02-06 13:59:15 UTC (rev 18711) +++ core/trunk/entitymanager/src/main/java/org/hibernate/ejb/EntityManagerFactoryImpl.java 2010-02-07 19:27:19 UTC (rev 18712) @@ -21,7 +21,10 @@ */ package org.hibernate.ejb; +import java.util.Collections; +import java.util.HashMap; import java.util.Map; +import java.util.Properties; import java.util.Set; import java.util.Iterator; import java.io.Serializable; @@ -61,7 +64,9 @@ private final CriteriaBuilderImpl criteriaBuilder; private final Metamodel metamodel; private final HibernatePersistenceUnitUtil util; + private final Map<String,Object> properties; + @SuppressWarnings( "unchecked" ) public EntityManagerFactoryImpl( SessionFactory sessionFactory, PersistenceUnitTransactionType transactionType, @@ -72,7 +77,6 @@ this.transactionType = transactionType; this.discardOnClose = discardOnClose; this.sessionInterceptorClass = sessionInterceptorClass; - @SuppressWarnings( "unchecked" ) final Iterator<PersistentClass> classes = cfg.getClassMappings(); //a safe guard till we are confident that metamodel is wll tested if ( !"disabled".equalsIgnoreCase( cfg.getProperty( "hibernate.ejb.metamodel.generation" ) ) ) { @@ -83,8 +87,21 @@ } this.criteriaBuilder = new CriteriaBuilderImpl( this ); this.util = new HibernatePersistenceUnitUtil( this ); + + HashMap<String,Object> props = new HashMap<String, Object>(); + addAll( props, ( (SessionFactoryImplementor) sessionFactory ).getProperties() ); + addAll( props, cfg.getProperties() ); + this.properties = Collections.unmodifiableMap( props ); } + private static void addAll(HashMap<String, Object> propertyMap, Properties properties) { + for ( Map.Entry entry : properties.entrySet() ) { + if ( String.class.isInstance( entry.getKey() ) ) { + propertyMap.put( (String)entry.getKey(), entry.getValue() ); + } + } + } + public EntityManager createEntityManager() { return createEntityManager( null ); } @@ -102,7 +119,7 @@ } public Metamodel getMetamodel() { - return metamodel; //To change body of implemented methods use File | Settings | File Templates. + return metamodel; } public void close() { @@ -110,8 +127,7 @@ } public Map<String, Object> getProperties() { - //FIXME - return null; //To change body of implemented methods use File | Settings | File Templates. + return properties; } public Cache getCache() {

15 years, 8 months

1
0
0 / 0

Hibernate SVN: r18711 - in search/trunk/src: test/java/org/hibernate/search/test/bridge and 1 other directory.

by hibernate-commits＠lists.jboss.org

Author: sannegrinovero Date: 2010-02-06 08:59:15 -0500 (Sat, 06 Feb 2010) New Revision: 18711 Modified: search/trunk/src/main/java/org/hibernate/search/bridge/builtin/CalendarBridge.java search/trunk/src/test/java/org/hibernate/search/test/bridge/BridgeTest.java Log: (HSEARCH-456) CalendarBridge ignoring setParameterValues Modified: search/trunk/src/main/java/org/hibernate/search/bridge/builtin/CalendarBridge.java =================================================================== --- search/trunk/src/main/java/org/hibernate/search/bridge/builtin/CalendarBridge.java 2010-02-06 12:54:40 UTC (rev 18710) +++ search/trunk/src/main/java/org/hibernate/search/bridge/builtin/CalendarBridge.java 2010-02-06 13:59:15 UTC (rev 18711) @@ -39,6 +39,8 @@ public class CalendarBridge implements TwoWayStringBridge, ParameterizedBridge { + public static final String RESOLUTION_PARAMETER = "resolution"; + private DateTools.Resolution resolution; public static final TwoWayStringBridge CALENDAR_YEAR = new CalendarBridge( Resolution.YEAR ); public static final TwoWayStringBridge CALENDAR_MONTH = new CalendarBridge( Resolution.MONTH ); @@ -56,7 +58,7 @@ } public void setParameterValues(Map parameters) { - Object resolution = parameters.get( "resolution" ); + Object resolution = parameters.get( RESOLUTION_PARAMETER ); Resolution hibResolution; if ( resolution instanceof String ) { hibResolution = Resolution.valueOf( ( (String) resolution ).toUpperCase( Locale.ENGLISH ) ); @@ -64,7 +66,7 @@ else { hibResolution = (Resolution) resolution; } - resolution = DateResolutionUtil.getLuceneResolution( hibResolution ); + this.resolution = DateResolutionUtil.getLuceneResolution( hibResolution ); } public Object stringToObject(String stringValue) { Modified: search/trunk/src/test/java/org/hibernate/search/test/bridge/BridgeTest.java =================================================================== --- search/trunk/src/test/java/org/hibernate/search/test/bridge/BridgeTest.java 2010-02-06 12:54:40 UTC (rev 18710) +++ search/trunk/src/test/java/org/hibernate/search/test/bridge/BridgeTest.java 2010-02-06 13:59:15 UTC (rev 18711) @@ -29,6 +29,7 @@ import java.util.Calendar; import java.util.Date; import java.util.GregorianCalendar; +import java.util.HashMap; import java.util.List; import java.util.TimeZone; @@ -46,6 +47,8 @@ import org.hibernate.search.Environment; import org.hibernate.search.FullTextSession; import org.hibernate.search.Search; +import org.hibernate.search.annotations.Resolution; +import org.hibernate.search.bridge.builtin.CalendarBridge; import org.hibernate.search.test.SearchTestCase; /** @@ -252,6 +255,17 @@ s.delete( s.get( Cloud.class, cloud.getId() ) ); tx.commit(); s.close(); + + //now unit-test the bridge directly: + + CalendarBridge bridge = new CalendarBridge(); + HashMap<String, String> bridgeParams = new HashMap<String, String>(); + bridgeParams.put( CalendarBridge.RESOLUTION_PARAMETER, Resolution.YEAR.toString() ); + bridge.setParameterValues( bridgeParams ); + assertEquals( "2000", bridge.objectToString( c ) ); + bridgeParams.put( CalendarBridge.RESOLUTION_PARAMETER, Resolution.DAY.toString() ); + bridge.setParameterValues( bridgeParams ); + assertEquals( "20001215", bridge.objectToString( c ) ); }

15 years, 8 months

1
0
0 / 0

Hibernate SVN: r18710 - in search/trunk/src/main/java/org/hibernate/search: backend/impl/lucene and 7 other directories.

by hibernate-commits＠lists.jboss.org

Author: sannegrinovero Date: 2010-02-06 07:54:40 -0500 (Sat, 06 Feb 2010) New Revision: 18710 Modified: search/trunk/src/main/java/org/hibernate/search/backend/configuration/MaskedProperty.java search/trunk/src/main/java/org/hibernate/search/backend/impl/lucene/LuceneBackendQueueProcessorFactory.java search/trunk/src/main/java/org/hibernate/search/batchindexing/IdentifierProducer.java search/trunk/src/main/java/org/hibernate/search/cfg/FieldBridgeMapping.java search/trunk/src/main/java/org/hibernate/search/cfg/FieldMapping.java search/trunk/src/main/java/org/hibernate/search/cfg/FullTextFilterDefMapping.java search/trunk/src/main/java/org/hibernate/search/cfg/SearchMapping.java search/trunk/src/main/java/org/hibernate/search/impl/SimpleIndexingProgressMonitor.java search/trunk/src/main/java/org/hibernate/search/jpa/impl/FullTextEntityManagerImpl.java search/trunk/src/main/java/org/hibernate/search/query/FullTextQueryImpl.java search/trunk/src/main/java/org/hibernate/search/store/DirectoryProviderHelper.java search/trunk/src/main/java/org/hibernate/search/store/RAMDirectoryProvider.java search/trunk/src/main/java/org/hibernate/search/util/ContextHelper.java Log: in preparation for warnings cleanup to solve Lucene 2.9 deprecations: fixing typos, unused imports, unimportant glitches found by findbugs Modified: search/trunk/src/main/java/org/hibernate/search/backend/configuration/MaskedProperty.java =================================================================== --- search/trunk/src/main/java/org/hibernate/search/backend/configuration/MaskedProperty.java 2010-02-06 06:33:14 UTC (rev 18709) +++ search/trunk/src/main/java/org/hibernate/search/backend/configuration/MaskedProperty.java 2010-02-06 12:54:40 UTC (rev 18710) @@ -114,7 +114,7 @@ * @throws IllegalArgumentException if the key is not a String instance */ @Override - public boolean containsKey(Object key) { + public synchronized boolean containsKey(Object key) { if ( ! ( key instanceof String ) ) { throw new IllegalArgumentException( "key must be a String" ); } @@ -252,7 +252,7 @@ } @Override - public boolean contains(Object value) { + public synchronized boolean contains(Object value) { initPropertyNames(); return propertyNames.contains( value ); } @@ -291,7 +291,7 @@ } @Override - public boolean isEmpty() { + public synchronized boolean isEmpty() { initPropertyNames(); return propertyNames.isEmpty(); } @@ -300,7 +300,7 @@ * @throws UnsupportedOperationException */ @Override - public Enumeration<Object> keys() { + public synchronized Enumeration<Object> keys() { initPropertyNames(); return Collections.enumeration( propertyNames ); } @@ -347,13 +347,13 @@ * @throws UnsupportedOperationException */ @Override - public int size() { + public synchronized int size() { initPropertyNames(); return propertyNames.size(); } @Override - public String toString() { + public synchronized String toString() { return masked.toString(); } @@ -366,7 +366,7 @@ } @Override - public int hashCode() { + public synchronized int hashCode() { final int prime = 31; int result = ( ( fallBack == null ) ? 0 : fallBack.hashCode() ); result = prime * result + masked.hashCode(); @@ -375,7 +375,7 @@ } @Override - public boolean equals(Object obj) { + public synchronized boolean equals(Object obj) { if ( this == obj ) return true; if ( obj == null ) @@ -394,4 +394,5 @@ return false; return true; } + } Modified: search/trunk/src/main/java/org/hibernate/search/backend/impl/lucene/LuceneBackendQueueProcessorFactory.java =================================================================== --- search/trunk/src/main/java/org/hibernate/search/backend/impl/lucene/LuceneBackendQueueProcessorFactory.java 2010-02-06 06:33:14 UTC (rev 18709) +++ search/trunk/src/main/java/org/hibernate/search/backend/impl/lucene/LuceneBackendQueueProcessorFactory.java 2010-02-06 12:54:40 UTC (rev 18710) @@ -28,7 +28,6 @@ import java.util.Map; import java.util.Properties; import java.util.List; -import java.util.concurrent.ExecutorService; import org.hibernate.search.backend.BackendQueueProcessorFactory; import org.hibernate.search.backend.LuceneWork; Modified: search/trunk/src/main/java/org/hibernate/search/batchindexing/IdentifierProducer.java =================================================================== --- search/trunk/src/main/java/org/hibernate/search/batchindexing/IdentifierProducer.java 2010-02-06 06:33:14 UTC (rev 18709) +++ search/trunk/src/main/java/org/hibernate/search/batchindexing/IdentifierProducer.java 2010-02-06 12:54:40 UTC (rev 18710) @@ -118,7 +118,7 @@ .uniqueResult(); if ( objectsLimit != 0 && objectsLimit < totalCount.intValue() ) { - totalCount = new Long(objectsLimit); + totalCount = Long.valueOf( objectsLimit ); } log.debug( "going to fetch {} primary keys", totalCount); monitor.addToTotalCount( totalCount ); Modified: search/trunk/src/main/java/org/hibernate/search/cfg/FieldBridgeMapping.java =================================================================== --- search/trunk/src/main/java/org/hibernate/search/cfg/FieldBridgeMapping.java 2010-02-06 06:33:14 UTC (rev 18709) +++ search/trunk/src/main/java/org/hibernate/search/cfg/FieldBridgeMapping.java 2010-02-06 12:54:40 UTC (rev 18710) @@ -42,7 +42,7 @@ private final EntityDescriptor entity; private final PropertyDescriptor property; private final FieldMapping fieldMapping; - private final Map<String, Object> bridge = new HashMap<String, Object>();; + private final Map<String, Object> bridge = new HashMap<String, Object>(); public FieldBridgeMapping(Class<?> impl, Map<String, Object> field, FieldMapping fieldMapping, Modified: search/trunk/src/main/java/org/hibernate/search/cfg/FieldMapping.java =================================================================== --- search/trunk/src/main/java/org/hibernate/search/cfg/FieldMapping.java 2010-02-06 06:33:14 UTC (rev 18709) +++ search/trunk/src/main/java/org/hibernate/search/cfg/FieldMapping.java 2010-02-06 12:54:40 UTC (rev 18710) @@ -33,7 +33,6 @@ import org.hibernate.search.annotations.Resolution; import org.hibernate.search.annotations.Store; import org.hibernate.search.annotations.TermVector; -import org.hibernate.search.engine.BoostStrategy; /** * @author Emmanuel Bernard @@ -78,7 +77,6 @@ return this; } - public FieldBridgeMapping bridge(Class<?> impl) { return new FieldBridgeMapping( impl, field, this, property, entity, mapping ); } Modified: search/trunk/src/main/java/org/hibernate/search/cfg/FullTextFilterDefMapping.java =================================================================== --- search/trunk/src/main/java/org/hibernate/search/cfg/FullTextFilterDefMapping.java 2010-02-06 06:33:14 UTC (rev 18709) +++ search/trunk/src/main/java/org/hibernate/search/cfg/FullTextFilterDefMapping.java 2010-02-06 12:54:40 UTC (rev 18710) @@ -24,7 +24,6 @@ */ package org.hibernate.search.cfg; -import java.lang.annotation.ElementType; import java.util.HashMap; import java.util.Map; Modified: search/trunk/src/main/java/org/hibernate/search/cfg/SearchMapping.java =================================================================== --- search/trunk/src/main/java/org/hibernate/search/cfg/SearchMapping.java 2010-02-06 06:33:14 UTC (rev 18709) +++ search/trunk/src/main/java/org/hibernate/search/cfg/SearchMapping.java 2010-02-06 12:54:40 UTC (rev 18710) @@ -31,7 +31,6 @@ import java.util.Map; import java.util.Set; -import org.apache.lucene.analysis.Tokenizer; import org.apache.solr.analysis.TokenizerFactory; /** Modified: search/trunk/src/main/java/org/hibernate/search/impl/SimpleIndexingProgressMonitor.java =================================================================== --- search/trunk/src/main/java/org/hibernate/search/impl/SimpleIndexingProgressMonitor.java 2010-02-06 06:33:14 UTC (rev 18709) +++ search/trunk/src/main/java/org/hibernate/search/impl/SimpleIndexingProgressMonitor.java 2010-02-06 12:54:40 UTC (rev 18710) @@ -72,8 +72,8 @@ protected void printStatusMessage(long starttimems, long totalTodoCount, long doneCount) { long elapsedMs = System.currentTimeMillis() - starttimems; log.info( "{} documents indexed in {} ms", doneCount, elapsedMs ); - float estimateSpeed = (float) doneCount * 1000f / elapsedMs ; - float estimatePercentileComplete = (float) doneCount * 100f / (float) totalTodoCount ; + float estimateSpeed = doneCount * 1000f / elapsedMs ; + float estimatePercentileComplete = doneCount * 100f / totalTodoCount ; log.info( "Indexing speed: {} documents/second; progress: {}%", estimateSpeed, estimatePercentileComplete ); } Modified: search/trunk/src/main/java/org/hibernate/search/jpa/impl/FullTextEntityManagerImpl.java =================================================================== --- search/trunk/src/main/java/org/hibernate/search/jpa/impl/FullTextEntityManagerImpl.java 2010-02-06 06:33:14 UTC (rev 18709) +++ search/trunk/src/main/java/org/hibernate/search/jpa/impl/FullTextEntityManagerImpl.java 2010-02-06 12:54:40 UTC (rev 18710) @@ -26,7 +26,6 @@ import java.io.Serializable; import java.util.Map; -import java.util.Set; import javax.persistence.EntityManager; import javax.persistence.FlushModeType; import javax.persistence.LockModeType; Modified: search/trunk/src/main/java/org/hibernate/search/query/FullTextQueryImpl.java =================================================================== --- search/trunk/src/main/java/org/hibernate/search/query/FullTextQueryImpl.java 2010-02-06 06:33:14 UTC (rev 18709) +++ search/trunk/src/main/java/org/hibernate/search/query/FullTextQueryImpl.java 2010-02-06 12:54:40 UTC (rev 18710) @@ -162,13 +162,13 @@ } /** - * Return an interator on the results. + * Return an iterator on the results. * Retrieve the object one by one (initialize it during the next() operation) */ public Iterator iterate() throws HibernateException { - //implement an interator which keep the id/class for each hit and get the object on demand - //cause I can't keep the searcher and hence the hit opened. I dont have any hook to know when the - //user stop using it + //implement an iterator which keep the id/class for each hit and get the object on demand + //cause I can't keep the searcher and hence the hit opened. I don't have any hook to know when the + //user stops using it //scrollable is better in this area //find the directories Modified: search/trunk/src/main/java/org/hibernate/search/store/DirectoryProviderHelper.java =================================================================== --- search/trunk/src/main/java/org/hibernate/search/store/DirectoryProviderHelper.java 2010-02-06 06:33:14 UTC (rev 18709) +++ search/trunk/src/main/java/org/hibernate/search/store/DirectoryProviderHelper.java 2010-02-06 12:54:40 UTC (rev 18710) @@ -28,7 +28,7 @@ import java.io.IOException; import java.util.Properties; -import org.apache.lucene.analysis.standard.StandardAnalyzer; +import org.apache.lucene.analysis.SimpleAnalyzer; import org.apache.lucene.index.IndexReader; import org.apache.lucene.index.IndexWriter; import org.apache.lucene.store.FSDirectory; @@ -105,14 +105,14 @@ */ public static FSDirectory createFSIndex(File indexDir, Properties dirConfiguration) throws IOException { LockFactory lockFactory = createLockFactory(indexDir, dirConfiguration); - FSDirectory fsDirectory = FSDirectory.getDirectory( indexDir, null ); + FSDirectory fsDirectory = FSDirectory.open( indexDir, null ); // must use the setter (instead of using the constructor) to set the lockFactory, or Lucene will // throw an exception if it's different than a previous setting. fsDirectory.setLockFactory( lockFactory ); if ( ! IndexReader.indexExists( fsDirectory ) ) { log.debug( "Initialize index: '{}'", indexDir.getAbsolutePath() ); IndexWriter.MaxFieldLength fieldLength = new IndexWriter.MaxFieldLength( IndexWriter.DEFAULT_MAX_FIELD_LENGTH ); - IndexWriter iw = new IndexWriter( fsDirectory, new StandardAnalyzer(), true, fieldLength ); + IndexWriter iw = new IndexWriter( fsDirectory, new SimpleAnalyzer(), true, fieldLength ); iw.close(); } return fsDirectory; Modified: search/trunk/src/main/java/org/hibernate/search/store/RAMDirectoryProvider.java =================================================================== --- search/trunk/src/main/java/org/hibernate/search/store/RAMDirectoryProvider.java 2010-02-06 06:33:14 UTC (rev 18709) +++ search/trunk/src/main/java/org/hibernate/search/store/RAMDirectoryProvider.java 2010-02-06 12:54:40 UTC (rev 18710) @@ -27,7 +27,7 @@ import java.io.IOException; import java.util.Properties; -import org.apache.lucene.analysis.standard.StandardAnalyzer; +import org.apache.lucene.analysis.SimpleAnalyzer; import org.apache.lucene.index.IndexWriter; import org.apache.lucene.store.RAMDirectory; import org.hibernate.HibernateException; @@ -52,7 +52,7 @@ public void start() { try { IndexWriter.MaxFieldLength fieldLength = new IndexWriter.MaxFieldLength( IndexWriter.DEFAULT_MAX_FIELD_LENGTH ); - IndexWriter iw = new IndexWriter( directory, new StandardAnalyzer(), true, fieldLength ); + IndexWriter iw = new IndexWriter( directory, new SimpleAnalyzer(), true, fieldLength ); iw.close(); } catch (IOException e) { Modified: search/trunk/src/main/java/org/hibernate/search/util/ContextHelper.java =================================================================== --- search/trunk/src/main/java/org/hibernate/search/util/ContextHelper.java 2010-02-06 06:33:14 UTC (rev 18709) +++ search/trunk/src/main/java/org/hibernate/search/util/ContextHelper.java 2010-02-06 12:54:40 UTC (rev 18710) @@ -45,7 +45,7 @@ public static SearchFactoryImplementor getSearchFactoryBySFI(SessionImplementor session) { PostInsertEventListener[] listeners = session.getListeners().getPostInsertEventListeners(); FullTextIndexEventListener listener = null; - //FIXME this sucks since we mandante the event listener use + //FIXME this sucks since we mandate the event listener use for ( PostInsertEventListener candidate : listeners ) { if ( candidate instanceof FullTextIndexEventListener ) { listener = (FullTextIndexEventListener) candidate;

15 years, 8 months

1
0
0 / 0

← Newer
1
...
17
18
19
20
21
22
23
24
Older →

Jump to page:

2025

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

2006

hibernate-commits February 2010